@alexlit/lint-kit 183.4.0 → 183.6.0

package/packages/config-stylelint/node_modules/stylelint/lib/rules/media-feature-range-notation/index.mjs

@@ -0,0 +1,187 @@
+import {
+	MediaFeatureName,
+	MediaFeatureRangeNameValue,
+	isMediaFeature,
+	isMediaFeaturePlain,
+	isMediaFeatureRange,
+	isMediaFeatureRangeNameValue,
+	isMediaFeatureRangeValueName,
+	isMediaQueryInvalid,
+} from '@csstools/media-query-list-parser';
+import { TokenNode, sourceIndices } from '@csstools/css-parser-algorithms';
+import { TokenType } from '@csstools/css-tokenizer';
+
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import optionsMatches from '../../utils/optionsMatches.mjs';
+import parseMediaQuery from '../../utils/parseMediaQuery.mjs';
+import { rangeTypeMediaFeatureNames } from '../../reference/mediaFeatures.mjs';
+import report from '../../utils/report.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+const ruleName = 'media-feature-range-notation';
+
+const messages = ruleMessages(ruleName, {
+	expected: (primary) => `Expected "${primary}" media feature range notation`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/media-feature-range-notation',
+	fixable: true,
+};
+
+/** @import {TokenDelim} from '@csstools/css-tokenizer' */
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: primary,
+				possible: ['prefix', 'context'],
+			},
+			{
+				actual: secondaryOptions,
+				possible: {
+					except: ['exact-value'],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		const exceptExactValue = optionsMatches(secondaryOptions, 'except', 'exact-value');
+
+		/** @type {RegExp | undefined} */
+		let atRuleParamsRegex;
+
+		if (!exceptExactValue) {
+			if (primary === 'prefix') {
+				atRuleParamsRegex = /[<>]/;
+			} else if (primary === 'context') {
+				atRuleParamsRegex = /(?:min|max)-/i;
+			}
+		}
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			if (atRuleParamsRegex && !atRuleParamsRegex.test(atRule.params)) return;
+
+			const mediaQueryList = parseMediaQuery(atRule);
+
+			mediaQueryList.forEach((mediaQuery) => {
+				if (isMediaQueryInvalid(mediaQuery)) return;
+
+				mediaQuery.walk(({ node, parent }) => {
+					// Only look at plain and range notation media features
+					if (!isMediaFeatureRange(node) && !isMediaFeaturePlain(node)) return;
+
+					const featureName = node.getName();
+					const unprefixedMediaFeature = featureName.replace(/^(?:min|max)-/i, '');
+
+					if (!rangeTypeMediaFeatureNames.has(unprefixedMediaFeature)) return;
+
+					let expected = primary;
+
+					if (exceptExactValue) {
+						const isMediaFeatureRangeWithExactOperator =
+							(isMediaFeatureRangeNameValue(node) || isMediaFeatureRangeValueName(node)) &&
+							node.operator.length === 1 &&
+							node.operator[0][1] === '=';
+
+						const isMediaFeaturePlainUnprefixed =
+							isMediaFeaturePlain(node) && featureName.length === unprefixedMediaFeature.length;
+
+						if (isMediaFeatureRangeWithExactOperator || isMediaFeaturePlainUnprefixed) {
+							expected = primary === 'prefix' ? 'context' : 'prefix';
+						}
+					}
+
+					// Expected plain notation and received plain notation
+					if (expected === 'prefix' && isMediaFeaturePlain(node)) return;
+
+					// Expected range notation and received range notation
+					if (expected === 'context' && isMediaFeatureRange(node)) return;
+
+					/**
+					 * @param {object} entry
+					 * @param {import('@csstools/media-query-list-parser').MediaFeaturePlain} entry.node
+					 * @param {import('@csstools/media-query-list-parser').MediaFeature} entry.parent
+					 */
+					const contextFixer = (entry) => () => {
+						/** @type {[TokenDelim]|[TokenDelim, TokenDelim]} */
+						let operator;
+
+						if (/^min-/i.test(featureName)) {
+							operator = [
+								[TokenType.Delim, '>', -1, -1, { value: '>' }],
+								[TokenType.Delim, '=', -1, -1, { value: '=' }],
+							];
+						} else if (/^max-/i.test(featureName)) {
+							operator = [
+								[TokenType.Delim, '<', -1, -1, { value: '<' }],
+								[TokenType.Delim, '=', -1, -1, { value: '=' }],
+							];
+						} else {
+							operator = [[TokenType.Delim, '=', -1, -1, { value: '=' }]];
+						}
+
+						entry.parent.feature = new MediaFeatureRangeNameValue(
+							new MediaFeatureName(
+								new TokenNode([
+									TokenType.Ident,
+									unprefixedMediaFeature,
+									-1,
+									-1,
+									{ value: unprefixedMediaFeature },
+								]),
+								entry.node.name.before,
+								entry.node.name.after.length > 0
+									? entry.node.name.after
+									: [[TokenType.Whitespace, ' ', -1, -1, undefined]],
+							),
+							operator,
+							entry.node.value,
+						);
+
+						const expectedMediaQueryList = mediaQueryList.map((mq) => mq.toString()).join(',');
+
+						if (expectedMediaQueryList === atRule.params) return;
+
+						atRule.params = expectedMediaQueryList;
+					};
+
+					const hasFix =
+						expected === 'context' && isMediaFeaturePlain(node) && isMediaFeature(parent);
+					const fix = hasFix ? contextFixer({ node, parent }) : undefined;
+					const [startIndex, endIndex] = sourceIndices(node);
+					const atRuleIndex = atRuleParamIndex(atRule);
+
+					report({
+						message: messages.expected,
+						messageArgs: [expected],
+						node: atRule,
+						index: atRuleIndex + startIndex - 1,
+						endIndex: atRuleIndex + endIndex + 1 + 1,
+						result,
+						ruleName,
+						fix: {
+							apply: fix,
+							node: atRule,
+						},
+					});
+				});
+			});
+		});
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/media-query-no-invalid/index.mjs

@@ -0,0 +1,193 @@
+import { isFunctionNode, sourceIndices } from '@csstools/css-parser-algorithms';
+import {
+	isGeneralEnclosed,
+	isMediaFeatureBoolean,
+	isMediaFeaturePlain,
+	isMediaFeatureRange,
+	isMediaQueryInvalid,
+} from '@csstools/media-query-list-parser';
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import isCustomMediaQuery from '../../utils/isCustomMediaQuery.mjs';
+import optionsMatches from '../../utils/optionsMatches.mjs';
+import parseMediaQuery from '../../utils/parseMediaQuery.mjs';
+import { rangeTypeMediaFeatureNames } from '../../reference/mediaFeatures.mjs';
+import report from '../../utils/report.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+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: [isString, isRegExp],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			const atRuleParamIndexValue = atRuleParamIndex(atRule);
+
+			parseMediaQuery(atRule).forEach((mediaQuery) => {
+				if (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 (isGeneralEnclosed(node)) {
+						if (shouldIgnoreNode(mediaQuery, secondaryOptions)) return;
+
+						complain(atRule, atRuleParamIndexValue, node);
+
+						return;
+					}
+
+					// Invalid plain media features.
+					if (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 (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 (!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 (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] = 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 (!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;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/media-type-no-deprecated/index.mjs

@@ -0,0 +1,82 @@
+import { atRuleRegexes, mayIncludeRegexes } from '../../utils/regexes.mjs';
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import { deprecatedMediaTypesNames } from '../../reference/mediaTypes.mjs';
+import { isMediaQueryWithType } from '@csstools/media-query-list-parser';
+import isStandardSyntaxAtRule from '../../utils/isStandardSyntaxAtRule.mjs';
+import { isTokenIdent } from '@csstools/css-tokenizer';
+import optionsMatches from '../../utils/optionsMatches.mjs';
+import parseMediaQuery from '../../utils/parseMediaQuery.mjs';
+import report from '../../utils/report.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import { sourceIndices } from '@csstools/css-parser-algorithms';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+const ruleName = 'media-type-no-deprecated';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (mediaType) => `Unexpected deprecated media type "${mediaType}"`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/media-type-no-deprecated',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual: primary },
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignoreMediaTypes: [isString, isRegExp],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) return;
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			if (!isStandardSyntaxAtRule(atRule)) return;
+
+			if (!mayIncludeRegexes.deprecatedMediaType.test(atRule.params)) return;
+
+			const mediaQueryList = parseMediaQuery(atRule);
+
+			mediaQueryList.forEach((mediaQuery) => {
+				if (!isMediaQueryWithType(mediaQuery)) return;
+
+				const mediaType = mediaQuery.getMediaType();
+
+				if (!deprecatedMediaTypesNames.has(mediaType.toLowerCase())) return;
+
+				if (optionsMatches(secondaryOptions, 'ignoreMediaTypes', mediaType)) return;
+
+				const atRuleIndex = atRuleParamIndex(atRule);
+				const [index, endIndex] = sourceIndices({
+					tokens: () => mediaQuery.mediaType.filter(isTokenIdent),
+				});
+
+				report({
+					message: messages.rejected,
+					messageArgs: [mediaType],
+					node: atRule,
+					index: atRuleIndex + index,
+					endIndex: atRuleIndex + endIndex + 1,
+					ruleName,
+					result,
+				});
+			});
+		});
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/named-grid-areas-no-invalid/index.mjs

@@ -0,0 +1,117 @@
+import valueParser from 'postcss-value-parser';
+
+import { assert } from '../../utils/validateTypes.mjs';
+import { declarationValueIndex } from '../../utils/nodeFieldIndices.mjs';
+import findNotContiguousOrRectangular from './utils/findNotContiguousOrRectangular.mjs';
+import isStandardSyntaxValue from '../../utils/isStandardSyntaxValue.mjs';
+import { propertyRegexes } from '../../utils/regexes.mjs';
+import report from '../../utils/report.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+const ruleName = 'named-grid-areas-no-invalid';
+
+const messages = ruleMessages(ruleName, {
+	expectedToken: () => 'Expected cell token within string',
+	expectedSameNumber: () => 'Expected same number of cell tokens in each string',
+	expectedRectangle: (name) => `Expected single filled-in rectangle for "${name}"`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/named-grid-areas-no-invalid',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary) => {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, { actual: primary });
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkDecls(propertyRegexes.gridAreaNames, (decl) => {
+			const { value } = decl;
+
+			if (!isStandardSyntaxValue(value)) return;
+
+			if (value.toLowerCase().trim() === 'none') return;
+
+			/** @type {Array<{ values: string[], index: number, endIndex: number }>} */
+			const areas = [];
+			let reportSent = false;
+
+			valueParser(value).walk(({ sourceIndex, sourceEndIndex, type, value: tokenValue }) => {
+				if (type !== 'string') return;
+
+				if (tokenValue === '') {
+					complain(messages.expectedToken, [], sourceIndex, sourceEndIndex);
+					reportSent = true;
+
+					return;
+				}
+
+				areas.push({
+					values: tokenValue.trim().split(/\s+/).filter(Boolean),
+					index: sourceIndex,
+					endIndex: sourceEndIndex,
+				});
+			});
+
+			if (reportSent) return;
+
+			const [firstArea] = areas;
+
+			if (firstArea === undefined) return;
+
+			const notSameNumberArea = areas.find(
+				(area) => area.values.length !== firstArea.values.length,
+			);
+
+			if (notSameNumberArea !== undefined) {
+				complain(
+					messages.expectedSameNumber,
+					[],
+					notSameNumberArea.index,
+					notSameNumberArea.endIndex,
+				);
+
+				return;
+			}
+
+			const notContiguousOrRectangular = findNotContiguousOrRectangular(areas.map((a) => a.values));
+
+			for (const name of notContiguousOrRectangular.sort()) {
+				const area = areas.find((a) => a.values.includes(name));
+
+				assert(area);
+				complain(messages.expectedRectangle, [name], area.index, area.endIndex);
+			}
+
+			/**
+			 * @param {typeof messages[keyof messages]} message
+			 * @param {Array<string>} messageArgs
+			 * @param {number} index
+			 * @param {number} endIndex
+			 */
+			function complain(message, messageArgs, index, endIndex) {
+				const start = declarationValueIndex(decl);
+
+				report({
+					message,
+					messageArgs,
+					node: decl,
+					index: start + index,
+					endIndex: start + endIndex,
+					result,
+					ruleName,
+				});
+			}
+		});
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/named-grid-areas-no-invalid/utils/findNotContiguousOrRectangular.mjs

@@ -0,0 +1,57 @@
+import arrayEqual from '../../../utils/arrayEqual.mjs';
+
+/**
+ * @param {string[][]} areas
+ * @param {string} name
+ * @returns {boolean}
+ */
+function isContiguousAndRectangular(areas, name) {
+	const indicesByRow = areas.map((row) => {
+		const indices = [];
+		let idx = row.indexOf(name);
+
+		while (idx !== -1) {
+			indices.push(idx);
+			idx = row.indexOf(name, idx + 1);
+		}
+
+		return indices;
+	});
+
+	for (let i = 0; i < indicesByRow.length; i++) {
+		for (let j = i + 1; j < indicesByRow.length; j++) {
+			const x = indicesByRow[i];
+			const y = indicesByRow[j];
+
+			if ((x && x.length === 0) || (y && y.length === 0)) {
+				continue;
+			}
+
+			if (!arrayEqual(x, y)) {
+				return false;
+			}
+		}
+	}
+
+	return true;
+}
+
+/**
+ * @param {string[][]} areas
+ * @returns {string[]}
+ */
+function namedAreas(areas) {
+	const names = new Set(areas.flat());
+
+	names.delete('.');
+
+	return [...names];
+}
+
+/**
+ * @param {string[][]} areas
+ * @returns {string[]}
+ */
+export default function findNotContiguousOrRectangular(areas) {
+	return namedAreas(areas).filter((name) => !isContiguousAndRectangular(areas, name));
+}