// NOTICE: This file is generated by Rollup. To modify it, // please instead edit the ESM counterpart and rebuild with Rollup (npm run build). 'use strict'; const cssParserAlgorithms = require('@csstools/css-parser-algorithms'); const mediaQueryListParser = require('@csstools/media-query-list-parser'); const validateTypes = require('../../utils/validateTypes.cjs'); const nodeFieldIndices = require('../../utils/nodeFieldIndices.cjs'); const regexes = require('../../utils/regexes.cjs'); const isCustomMediaQuery = require('../../utils/isCustomMediaQuery.cjs'); const optionsMatches = require('../../utils/optionsMatches.cjs'); const parseMediaQuery = require('../../utils/parseMediaQuery.cjs'); const mediaFeatures = require('../../reference/mediaFeatures.cjs'); const report = require('../../utils/report.cjs'); const ruleMessages = require('../../utils/ruleMessages.cjs'); const validateOptions = require('../../utils/validateOptions.cjs'); const ruleName = 'media-query-no-invalid'; const messages = ruleMessages(ruleName, { rejected: (query, reason) => { if (!reason) return `Unexpected invalid media query "${query}"`; return `Unexpected invalid media query "${query}", ${reason}`; }, }); const reasons = { custom: 'custom media queries can only be used in boolean queries', min_max_in_range: '"min-" and "max-" prefixes are not needed when using range queries', min_max_in_boolean: '"min-" and "max-" prefixes are not needed in boolean queries', discrete: 'discrete features can only be used in plain and boolean queries', }; const HAS_MIN_MAX_PREFIX = /^(?:min|max)-/i; const meta = { url: 'https://stylelint.io/user-guide/rules/media-query-no-invalid', }; /** @typedef {import('stylelint').CoreRules[ruleName]} Rule */ /** @type {Rule} */ const rule = (primary, secondaryOptions) => { return (root, result) => { const validOptions = validateOptions( result, ruleName, { actual: primary }, { actual: secondaryOptions, possible: { ignoreFunctions: [validateTypes.isString, validateTypes.isRegExp], }, optional: true, }, ); if (!validOptions) { return; } root.walkAtRules(regexes.atRuleRegexes.mediaName, (atRule) => { const atRuleParamIndexValue = nodeFieldIndices.atRuleParamIndex(atRule); parseMediaQuery(atRule).forEach((mediaQuery) => { if (mediaQueryListParser.isMediaQueryInvalid(mediaQuery)) { if (shouldIgnoreNode(mediaQuery, secondaryOptions)) return; // Queries that fail to parse are invalid. complain(atRule, atRuleParamIndexValue, mediaQuery); return; } mediaQuery.walk(({ node, parent }) => { // All general enclosed nodes are invalid. if (mediaQueryListParser.isGeneralEnclosed(node)) { if (shouldIgnoreNode(mediaQuery, secondaryOptions)) return; complain(atRule, atRuleParamIndexValue, node); return; } // Invalid plain media features. if (mediaQueryListParser.isMediaFeaturePlain(node)) { const name = node.getName(); if (isCustomMediaQuery(name)) { // In a plain context, custom media queries are invalid. complain(atRule, atRuleParamIndexValue, parent, 'custom'); return; } return; } // Invalid range media features. if (mediaQueryListParser.isMediaFeatureRange(node)) { const name = node.getName().toLowerCase(); if (isCustomMediaQuery(name)) { // In a range context, custom media queries are invalid. complain(atRule, atRuleParamIndexValue, parent, 'custom'); return; } if (HAS_MIN_MAX_PREFIX.test(name)) { // In a range context, min- and max- prefixed feature names are invalid. complain(atRule, atRuleParamIndexValue, parent, 'min_max_in_range'); return; } if (!mediaFeatures.rangeTypeMediaFeatureNames.has(name)) { // In a range context, non-range typed features are invalid. complain(atRule, atRuleParamIndexValue, parent, 'discrete'); return; } return; } // Invalid boolean media features. if (mediaQueryListParser.isMediaFeatureBoolean(node)) { const name = node.getName(); if (HAS_MIN_MAX_PREFIX.test(name)) { // In a boolean feature, min- and max- prefixed feature names are invalid complain(atRule, atRuleParamIndexValue, parent, 'min_max_in_boolean'); } } }); }); }); /** * @param {import('postcss').AtRule} atRule * @param {number} index * @param {{tokens(): Array}} node * @param {keyof reasons} [reason] */ function complain(atRule, index, node, reason) { const [start, end] = cssParserAlgorithms.sourceIndices(node); report({ message: messages.rejected, messageArgs: [node.toString(), reason ? reasons[reason] : ''], index: index + start, endIndex: index + end + 1, node: atRule, ruleName, result, }); } }; }; /** * @param {import('@csstools/media-query-list-parser').MediaQuery|import('@csstools/media-query-list-parser').GeneralEnclosed} node * @param {Parameters[1]} secondaryOptions * @returns {boolean} */ function shouldIgnoreNode(node, secondaryOptions) { if (!secondaryOptions?.ignoreFunctions) return false; let ignored = false; node.walk(({ node: childNode }) => { if (!cssParserAlgorithms.isFunctionNode(childNode)) { return; } ignored = optionsMatches(secondaryOptions, 'ignoreFunctions', childNode.getName()); if (ignored) { return false; // Stop iteration if an ignored function is found } }); return ignored; } rule.ruleName = ruleName; rule.messages = messages; rule.meta = meta; module.exports = rule;