@alexlit/lint-kit 173.0.0 → 173.2.0

package/packages/config-stylelint/node_modules/stylelint/lib/rules/media-feature-name-unit-allowed-list/index.mjs

@@ -0,0 +1,108 @@
+import {
+	isMediaFeaturePlain,
+	isMediaFeatureRange,
+	isMediaQueryInvalid,
+} from '@csstools/media-query-list-parser';
+import { TokenType } from '@csstools/css-tokenizer';
+import { isTokenNode } from '@csstools/css-parser-algorithms';
+
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import { isString } from '../../utils/validateTypes.mjs';
+import matchesStringOrRegExp from '../../utils/matchesStringOrRegExp.mjs';
+import parseMediaQuery from '../../utils/parseMediaQuery.mjs';
+import report from '../../utils/report.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import validateObjectWithArrayProps from '../../utils/validateObjectWithArrayProps.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+const ruleName = 'media-feature-name-unit-allowed-list';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (unit, name) => `Unexpected unit "${unit}" for name "${name}"`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/media-feature-name-unit-allowed-list',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary) => {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: primary,
+			possible: [validateObjectWithArrayProps(isString)],
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		const primaryPairs = Object.entries(primary);
+		const primaryUnitList = (/** @type {string} */ featureName) => {
+			for (const [name, unit] of primaryPairs) {
+				if (matchesStringOrRegExp(featureName, name)) return [unit].flat();
+			}
+
+			return undefined;
+		};
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			const mediaQueryList = parseMediaQuery(atRule);
+
+			mediaQueryList.forEach((mediaQuery) => {
+				if (isMediaQueryInvalid(mediaQuery)) return;
+
+				const initialState = {
+					mediaFeatureName: '',
+					/** @type {string[] | undefined} */
+					unitList: undefined,
+				};
+
+				mediaQuery.walk(({ node, state }) => {
+					if (!state) return;
+
+					if (isMediaFeaturePlain(node) || isMediaFeatureRange(node)) {
+						state.mediaFeatureName = node.getName();
+						state.unitList = primaryUnitList(state.mediaFeatureName);
+
+						return;
+					}
+
+					if (!isTokenNode(node)) return;
+
+					const { mediaFeatureName, unitList } = state;
+
+					if (!mediaFeatureName || !unitList) return;
+
+					const [tokenType, , startIndex, endIndex, parsedValue] = node.value;
+
+					if (tokenType !== TokenType.Dimension) {
+						return;
+					}
+
+					if (unitList.includes(parsedValue.unit.toLowerCase())) {
+						return;
+					}
+
+					const atRuleIndex = atRuleParamIndex(atRule);
+
+					report({
+						message: messages.rejected,
+						messageArgs: [parsedValue.unit, mediaFeatureName],
+						node: atRule,
+						index: atRuleIndex + startIndex,
+						endIndex: atRuleIndex + endIndex + 1,
+						result,
+						ruleName,
+					});
+				}, initialState);
+			});
+		});
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/media-feature-name-value-allowed-list/index.mjs

@@ -0,0 +1,100 @@
+import {
+	isMediaFeature,
+	isMediaFeatureValue,
+	isMediaQueryInvalid,
+} from '@csstools/media-query-list-parser';
+import { sourceIndices } from '@csstools/css-parser-algorithms';
+
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import matchesStringOrRegExp from '../../utils/matchesStringOrRegExp.mjs';
+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 validateObjectWithArrayProps from '../../utils/validateObjectWithArrayProps.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+const ruleName = 'media-feature-name-value-allowed-list';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (name, value) => `Unexpected value "${value}" for name "${name}"`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/media-feature-name-value-allowed-list',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary) => {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: primary,
+			possible: [validateObjectWithArrayProps(isString, isRegExp)],
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			parseMediaQuery(atRule).forEach((mediaQuery) => {
+				if (isMediaQueryInvalid(mediaQuery)) return;
+
+				const initialState = {
+					mediaFeatureName: '',
+				};
+
+				mediaQuery.walk(({ node, state }) => {
+					if (!state) return;
+
+					if (isMediaFeature(node)) {
+						state.mediaFeatureName = node.getName();
+
+						return;
+					}
+
+					if (!isMediaFeatureValue(node)) return;
+
+					const { mediaFeatureName } = state;
+
+					if (!mediaFeatureName) return;
+
+					const componentValues = [node.value].flat();
+					const value = componentValues.map((x) => x.toString()).join('');
+
+					const allowedValuesKey = Object.keys(primary).find((featureName) =>
+						matchesStringOrRegExp(mediaFeatureName, featureName),
+					);
+
+					if (allowedValuesKey == null) {
+						return;
+					}
+
+					if (optionsMatches(primary, allowedValuesKey, value)) {
+						return;
+					}
+
+					const atRuleIndex = atRuleParamIndex(atRule);
+					const [startIndex, endIndex] = sourceIndices(componentValues);
+
+					report({
+						index: atRuleIndex + startIndex,
+						endIndex: atRuleIndex + endIndex + 1,
+						message: messages.rejected,
+						messageArgs: [mediaFeatureName, value],
+						node: atRule,
+						ruleName,
+						result,
+					});
+				}, initialState);
+			});
+		});
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/media-feature-name-value-no-unknown/index.mjs

@@ -0,0 +1,277 @@
+import { NumberType, TokenType } from '@csstools/css-tokenizer';
+import { isFunctionNode, isTokenNode, sourceIndices } from '@csstools/css-parser-algorithms';
+import {
+	isMediaFeature,
+	isMediaFeatureValue,
+	isMediaQueryInvalid,
+	matchesRatioExactly,
+} from '@csstools/media-query-list-parser';
+
+import { lengthUnits, resolutionUnits } from '../../reference/units.mjs';
+import {
+	mediaFeatureNameAllowedValueKeywords,
+	mediaFeatureNameAllowedValueTypes,
+	mediaFeatureNames,
+} from '../../reference/mediaFeatures.mjs';
+import { mathFunctions } from '../../reference/functions.mjs';
+
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import parseMediaQuery from '../../utils/parseMediaQuery.mjs';
+import report from '../../utils/report.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+import vendor from '../../utils/vendor.mjs';
+
+const ruleName = 'media-feature-name-value-no-unknown';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (name, value) => `Unexpected unknown media feature value "${value}" for name "${name}"`,
+});
+
+const HAS_MIN_MAX_PREFIX = /^(?:min|max)-/i;
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/media-feature-name-value-no-unknown',
+};
+
+/** @typedef {{ mediaFeatureName: string, mediaFeatureNameRaw: string }} State */
+/** @typedef { (state: State, valuePart: string, start: number, end: number) => void } Reporter */
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary) => {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, { actual: primary });
+
+		if (!validOptions) {
+			return;
+		}
+
+		/**
+		 * Check that a single token value is valid for a given media feature name.
+		 *
+		 * @param {State} state
+		 * @param {import('@csstools/css-tokenizer').CSSToken} token
+		 * @param {Reporter} reporter
+		 * @returns {void}
+		 */
+		function checkSingleToken(state, token, reporter) {
+			const [type, raw, start, end, parsed] = token;
+
+			if (type === TokenType.Ident) {
+				const supportedKeywords = mediaFeatureNameAllowedValueKeywords.get(state.mediaFeatureName);
+
+				if (supportedKeywords) {
+					const keyword = vendor.unprefixed(parsed.value.toLowerCase());
+
+					if (supportedKeywords.has(keyword)) return;
+				}
+
+				// An ident that isn't expected for the given media feature name
+				reporter(state, raw, start, end);
+
+				return;
+			}
+
+			const supportedValueTypes = mediaFeatureNameAllowedValueTypes.get(state.mediaFeatureName);
+
+			if (!supportedValueTypes) {
+				// The given media feature name doesn't support any single token values.
+				reporter(state, raw, start, end);
+
+				return;
+			}
+
+			if (type === TokenType.Number) {
+				if (parsed.type === NumberType.Integer) {
+					if (
+						// Integer values are valid for types "integer" and "ratio".
+						supportedValueTypes.has('integer') ||
+						supportedValueTypes.has('ratio') ||
+						// Integer values of "0" are also valid for "length", "resolution" and "mq-boolean".
+						(parsed.value === 0 &&
+							(supportedValueTypes.has('length') ||
+								supportedValueTypes.has('resolution') ||
+								supportedValueTypes.has('mq-boolean'))) ||
+						// Integer values of "1" are also valid for "mq-boolean".
+						(parsed.value === 1 && supportedValueTypes.has('mq-boolean'))
+					) {
+						return;
+					}
+
+					// An integer when the media feature doesn't support integers.
+					reporter(state, raw, start, end);
+
+					return;
+				}
+
+				if (
+					// Numbers are valid for "ratio".
+					supportedValueTypes.has('ratio') ||
+					// Numbers with value "0" are also valid for "length".
+					(parsed.value === 0 &&
+						(supportedValueTypes.has('length') || supportedValueTypes.has('resolution')))
+				) {
+					return;
+				}
+
+				// A number when the media feature doesn't support numbers.
+				reporter(state, raw, start, end);
+
+				return;
+			}
+
+			if (type === TokenType.Dimension) {
+				const unit = parsed.unit.toLowerCase();
+
+				if (supportedValueTypes.has('resolution') && resolutionUnits.has(unit)) return;
+
+				if (supportedValueTypes.has('length') && lengthUnits.has(unit)) return;
+
+				// An unexpected dimension or a media feature that doesn't support dimensions.
+				reporter(state, raw, start, end);
+			}
+		}
+
+		/**
+		 * Check that a function node is valid for a given media feature name.
+		 *
+		 * @param {State} state
+		 * @param {import('@csstools/css-parser-algorithms').FunctionNode} functionNode
+		 * @param {Reporter} reporter
+		 * @returns {void}
+		 */
+		function checkFunction(state, functionNode, reporter) {
+			const functionName = functionNode.getName().toLowerCase();
+
+			// "env()" can represent any value, it is treated as valid for static analysis.
+			if (functionName === 'env') return;
+
+			const supportedValueTypes = mediaFeatureNameAllowedValueTypes.get(state.mediaFeatureName);
+
+			if (
+				supportedValueTypes &&
+				mathFunctions.has(functionName) &&
+				(supportedValueTypes.has('integer') ||
+					supportedValueTypes.has('length') ||
+					supportedValueTypes.has('ratio') ||
+					supportedValueTypes.has('resolution'))
+			) {
+				return;
+			}
+
+			// An unexpected function or a media feature that doesn't support types that can be the result of a function.
+			reporter(state, functionNode.toString(), ...sourceIndices(functionNode));
+		}
+
+		/**
+		 * Check that an array of component values is valid for a given media feature name.
+		 *
+		 * @param {State} state
+		 * @param {Array<import('@csstools/css-parser-algorithms').ComponentValue>} componentValues
+		 * @param {Reporter} reporter
+		 * @returns {void}
+		 */
+		function checkListOfComponentValues(state, componentValues, reporter) {
+			const supportedValueTypes = mediaFeatureNameAllowedValueTypes.get(state.mediaFeatureName);
+
+			if (
+				supportedValueTypes &&
+				supportedValueTypes.has('ratio') &&
+				matchesRatioExactly(componentValues) !== -1
+			) {
+				return;
+			}
+
+			// An invalid aspect ratio or a media feature that doesn't support aspect ratios.
+			reporter(
+				state,
+				componentValues.map((x) => x.toString()).join(''),
+				...sourceIndices(componentValues),
+			);
+		}
+
+		/**
+		 * @param {State} state
+		 * @param {import('@csstools/media-query-list-parser').MediaFeatureValue} valueNode
+		 * @param {Reporter} reporter
+		 * @returns {void}
+		 */
+		function checkMediaFeatureValue(state, valueNode, reporter) {
+			if (isTokenNode(valueNode.value)) {
+				checkSingleToken(state, valueNode.value.value, reporter);
+
+				return;
+			}
+
+			if (isFunctionNode(valueNode.value)) {
+				checkFunction(state, valueNode.value, reporter);
+
+				return;
+			}
+
+			if (Array.isArray(valueNode.value)) {
+				checkListOfComponentValues(state, valueNode.value, reporter);
+			}
+		}
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			/**
+			 * @type {Reporter}
+			 */
+			const reporter = (state, valuePart, start, end) => {
+				const atRuleParamIndexValue = atRuleParamIndex(atRule);
+
+				report({
+					message: messages.rejected,
+					messageArgs: [state.mediaFeatureNameRaw, valuePart],
+					index: atRuleParamIndexValue + start,
+					endIndex: atRuleParamIndexValue + end + 1,
+					node: atRule,
+					ruleName,
+					result,
+				});
+			};
+
+			/** @type {State} */
+			const initialState = {
+				mediaFeatureName: '',
+				mediaFeatureNameRaw: '',
+			};
+
+			parseMediaQuery(atRule).forEach((mediaQuery) => {
+				if (isMediaQueryInvalid(mediaQuery)) return;
+
+				mediaQuery.walk(({ node, state }) => {
+					if (!state) return;
+
+					if (isMediaFeature(node)) {
+						const mediaFeatureNameRaw = node.getName();
+						let mediaFeatureName = vendor.unprefixed(mediaFeatureNameRaw.toLowerCase());
+
+						// Unknown media feature names are handled by "media-feature-name-no-unknown".
+						if (!mediaFeatureNames.has(mediaFeatureName)) return;
+
+						mediaFeatureName = mediaFeatureName.replace(HAS_MIN_MAX_PREFIX, '');
+
+						state.mediaFeatureName = mediaFeatureName;
+						state.mediaFeatureNameRaw = mediaFeatureNameRaw;
+
+						return;
+					}
+
+					if (!state.mediaFeatureName || !state.mediaFeatureNameRaw) return;
+
+					if (isMediaFeatureValue(node)) {
+						checkMediaFeatureValue(state, node, reporter);
+					}
+				}, initialState);
+			});
+		});
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

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

@@ -0,0 +1,174 @@
+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');
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			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;