@alexlit/lint-kit 183.4.0 → 183.6.0

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

@@ -0,0 +1,79 @@
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import findMediaFeatureNames from '../../utils/findMediaFeatureNames.mjs';
+import getAtRuleParams from '../../utils/getAtRuleParams.mjs';
+import isCustomMediaQuery from '../../utils/isCustomMediaQuery.mjs';
+import { mediaFeatureNames } from '../../reference/mediaFeatures.mjs';
+import optionsMatches from '../../utils/optionsMatches.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-no-unknown';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (mediaFeatureName) => `Unexpected unknown media feature name "${mediaFeatureName}"`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/media-feature-name-no-unknown',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual: primary },
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignoreMediaFeatureNames: [isString, isRegExp],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			findMediaFeatureNames(getAtRuleParams(atRule), (mediaFeatureNameToken) => {
+				const [, , startIndex, endIndex, { value: featureName }] = mediaFeatureNameToken;
+
+				if (isCustomMediaQuery(featureName)) {
+					return;
+				}
+
+				if (optionsMatches(secondaryOptions, 'ignoreMediaFeatureNames', featureName)) {
+					return;
+				}
+
+				if (vendor.prefix(featureName) || mediaFeatureNames.has(featureName.toLowerCase())) {
+					return;
+				}
+
+				const atRuleIndex = atRuleParamIndex(atRule);
+
+				report({
+					message: messages.rejected,
+					messageArgs: [featureName],
+					node: atRule,
+					index: atRuleIndex + startIndex,
+					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/media-feature-name-no-vendor-prefix/index.mjs

@@ -0,0 +1,94 @@
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import isAutoprefixable from '../../utils/isAutoprefixable.mjs';
+import optionsMatches from '../../utils/optionsMatches.mjs';
+import report from '../../utils/report.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+const ruleName = 'media-feature-name-no-vendor-prefix';
+
+const messages = ruleMessages(ruleName, {
+	rejected: 'Unexpected vendor-prefix',
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/media-feature-name-no-vendor-prefix',
+	fixable: true,
+};
+
+const FEATURES = [
+	'-webkit-device-pixel-ratio',
+	'-webkit-min-device-pixel-ratio',
+	'-webkit-max-device-pixel-ratio',
+	'-o-device-pixel-ratio',
+	'-o-min-device-pixel-ratio',
+	'-o-max-device-pixel-ratio',
+	'-moz-device-pixel-ratio',
+	'min--moz-device-pixel-ratio',
+	'max--moz-device-pixel-ratio',
+];
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual: primary },
+			{
+				optional: true,
+				actual: secondaryOptions,
+				possible: {
+					ignoreMediaFeatureNames: [isString, isRegExp],
+				},
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			const params = atRule.params;
+
+			if (!isAutoprefixable.mediaFeatureName(params)) {
+				return;
+			}
+
+			const matches = atRule.toString().match(new RegExp(`${FEATURES.join('|')}`, 'gi'));
+
+			if (!matches) {
+				return;
+			}
+
+			for (const match of matches) {
+				if (optionsMatches(secondaryOptions, 'ignoreMediaFeatureNames', match)) continue;
+
+				const fix = () => {
+					const fixedMatch = match.replace(/-moz-|-o-|-webkit-/i, '');
+
+					atRule.params = atRule.params.replace(match, fixedMatch);
+				};
+
+				report({
+					message: messages.rejected,
+					messageArgs: [],
+					node: atRule,
+					word: match,
+					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-feature-name-unit-allowed-list/index.mjs

@@ -0,0 +1,110 @@
+import {
+	isMediaFeaturePlain,
+	isMediaFeatureRange,
+	isMediaQueryInvalid,
+} from '@csstools/media-query-list-parser';
+import { TokenType } from '@csstools/css-tokenizer';
+import { isTokenNode } from '@csstools/css-parser-algorithms';
+
+import { atRuleRegexes, mayIncludeRegexes } from '../../utils/regexes.mjs';
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.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) => {
+			if (!mayIncludeRegexes.dimension.test(atRule.params)) return;
+
+			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,296 @@
+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 { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import optionsMatchesEntry from '../../utils/optionsMatchesEntry.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';
+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, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual: primary },
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignoreMediaFeatureNameValues: [validateObjectWithArrayProps(isString, isRegExp)],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		/** @type {(name: string, value: string) => boolean} */
+		const isNameOfValueIgnored = (name, value) =>
+			optionsMatchesEntry(secondaryOptions, 'ignoreMediaFeatureNameValues', name, value);
+
+		/**
+		 * 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;
+			const { mediaFeatureName } = state;
+
+			if (type === TokenType.Ident) {
+				const keyword = vendor.unprefixed(parsed.value.toLowerCase());
+
+				if (isNameOfValueIgnored(mediaFeatureName, keyword)) return;
+
+				const supportedKeywords = mediaFeatureNameAllowedValueKeywords.get(mediaFeatureName);
+
+				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(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;