first commit

node_modules/stylelint/lib/rules/media-query-no-invalid/index.cjs

@@ -0,0 +1,190 @@
+// 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 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(/^media$/i, (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<import('@csstools/css-tokenizer').CSSToken>}} 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<Rule>[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;