@alexlit/lint-kit 182.1.0 → 182.2.0

package/packages/config-stylelint/node_modules/stylelint/lib/rules/time-min-milliseconds/index.mjs

@@ -0,0 +1,167 @@
+import valueParser from 'postcss-value-parser';
+
+import { longhandTimeProperties, shorthandTimeProperties } from '../../reference/properties.mjs';
+import { declarationValueIndex } from '../../utils/nodeFieldIndices.mjs';
+import getDeclarationValue from '../../utils/getDeclarationValue.mjs';
+import getDimension from '../../utils/getDimension.mjs';
+import { isNumber } from '../../utils/validateTypes.mjs';
+import { mayIncludeRegexes } from '../../utils/regexes.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 = 'time-min-milliseconds';
+
+const messages = ruleMessages(ruleName, {
+	expected: (time) => `Expected a minimum of ${time} milliseconds`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/time-min-milliseconds',
+};
+
+const DELAY_PROPERTIES = new Set(['animation-delay', 'transition-delay']);
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: primary,
+				possible: isNumber,
+			},
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignore: ['delay'],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		const minimum = primary;
+		const ignoreDelay = optionsMatches(secondaryOptions, 'ignore', 'delay');
+
+		root.walkDecls((decl) => {
+			const propertyValue = decl.value;
+
+			if (!mayIncludeRegexes.time.test(propertyValue)) return;
+
+			const propertyName = vendor.unprefixed(decl.prop.toLowerCase());
+
+			const parsedValue = valueParser(getDeclarationValue(decl));
+			let timeValueCount = 0;
+
+			parsedValue.walk((node) => {
+				const { value, sourceIndex } = node;
+				const dimension = getDimension(node);
+
+				if (
+					longhandTimeProperties.has(propertyName) &&
+					!isIgnoredProperty(propertyName) &&
+					!isAcceptableTime(dimension)
+				) {
+					complain(decl, 0, propertyValue.length);
+				}
+
+				if (!shorthandTimeProperties.has(propertyName)) return;
+
+				timeValueCount = calcTimeValueCount(dimension, value, timeValueCount);
+
+				if (isAcceptableTime(dimension) || (ignoreDelay && timeValueCount !== 1)) return;
+
+				complain(decl, sourceIndex, value.length);
+			});
+		});
+
+		/**
+		 * @param {{unit: string | null, number: string | null}} dimension
+		 * @param {string} value
+		 * @param {number} valueTimeCount
+		 * @returns {number}
+		 */
+		function calcTimeValueCount(dimension, value, valueTimeCount) {
+			const { unit } = dimension;
+
+			if (unit !== null) valueTimeCount++;
+
+			if (value === ',') valueTimeCount = 0;
+
+			return valueTimeCount;
+		}
+
+		/**
+		 * @param {string} propertyName
+		 * @returns {boolean}
+		 */
+		function isIgnoredProperty(propertyName) {
+			if (ignoreDelay && DELAY_PROPERTIES.has(propertyName)) {
+				return true;
+			}
+
+			return false;
+		}
+
+		/**
+		 * @param {import('postcss-value-parser').Dimension | {unit: null, number: null}} dimension
+		 * @returns {boolean}
+		 */
+		function isAcceptableTime(dimension) {
+			const { unit, number } = dimension;
+
+			if (unit === null || number === null) return true;
+
+			const numTime = Number(number);
+
+			if (numTime <= 0) {
+				return true;
+			}
+
+			const timeUnit = unit.toLowerCase();
+
+			if (timeUnit === 'ms' && numTime < minimum) {
+				return false;
+			}
+
+			if (timeUnit === 's' && numTime * 1000 < minimum) {
+				return false;
+			}
+
+			return true;
+		}
+
+		/**
+		 * @param {import('postcss').Declaration} decl
+		 * @param {number} offset
+		 * @param {number} length
+		 * @returns {void}
+		 */
+		function complain(decl, offset, length) {
+			const index = declarationValueIndex(decl) + offset;
+			const endIndex = index + length;
+
+			report({
+				result,
+				ruleName,
+				message: messages.expected,
+				messageArgs: [minimum],
+				index,
+				endIndex,
+				node: decl,
+			});
+		}
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

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

@@ -0,0 +1,116 @@
+import valueParser from 'postcss-value-parser';
+
+import { atRuleParamIndex, declarationValueIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes, mayIncludeRegexes } from '../../utils/regexes.mjs';
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import getDimension from '../../utils/getDimension.mjs';
+import optionsMatches from '../../utils/optionsMatches.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 = 'unit-allowed-list';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (unit) => `Unexpected unit "${unit}"`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/unit-allowed-list',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: primary,
+				possible: [isString],
+			},
+			{
+				optional: true,
+				actual: secondaryOptions,
+				possible: {
+					ignoreFunctions: [isString, isRegExp],
+					ignoreProperties: [validateObjectWithArrayProps(isString, isRegExp)],
+				},
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		const primaryValues = [primary].flat();
+
+		/**
+		 * @template {import('postcss').AtRule | import('postcss').Declaration} T
+		 * @param {T} node
+		 * @param {string} value
+		 * @param {(node: T) => number} getIndex
+		 * @returns {void}
+		 */
+		function check(node, value, getIndex) {
+			if (!mayIncludeRegexes.dimension.test(value)) return;
+
+			// make sure multiplication operations (*) are divided - not handled
+			// by postcss-value-parser
+			value = value.replaceAll('*', ',');
+			valueParser(value).walk((valueNode) => {
+				if (valueNode.type === 'function') {
+					const valueLowerCase = valueNode.value.toLowerCase();
+
+					// Ignore wrong units within `url` function
+					if (valueLowerCase === 'url') {
+						return false;
+					}
+
+					if (optionsMatches(secondaryOptions, 'ignoreFunctions', valueLowerCase)) {
+						return false;
+					}
+				}
+
+				const { number, unit } = getDimension(valueNode);
+
+				if (!number || !unit || primaryValues.includes(unit.toLowerCase())) {
+					return;
+				}
+
+				if (
+					'prop' in node &&
+					secondaryOptions &&
+					optionsMatches(secondaryOptions.ignoreProperties, unit.toLowerCase(), node.prop)
+				) {
+					return;
+				}
+
+				const index = getIndex(node);
+
+				report({
+					index: index + valueNode.sourceIndex + number.length,
+					endIndex: index + valueNode.sourceEndIndex,
+					message: messages.rejected,
+					messageArgs: [unit],
+					node,
+					result,
+					ruleName,
+				});
+			});
+		}
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) =>
+			check(atRule, atRule.params, atRuleParamIndex),
+		);
+		root.walkDecls((decl) => check(decl, decl.value, declarationValueIndex));
+	};
+};
+
+rule.primaryOptionArray = true;
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/unit-disallowed-list/index.mjs

@@ -0,0 +1,211 @@
+import { NumberType, TokenType, tokenize } from '@csstools/css-tokenizer';
+import {
+	isFunctionNode,
+	isTokenNode,
+	parseListOfComponentValues,
+	walk,
+} from '@csstools/css-parser-algorithms';
+import { isMediaFeature, parseFromTokens } from '@csstools/media-query-list-parser';
+
+import { atRuleParamIndex, declarationValueIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes, mayIncludeRegexes } from '../../utils/regexes.mjs';
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import getAtRuleParams from '../../utils/getAtRuleParams.mjs';
+import getDeclarationValue from '../../utils/getDeclarationValue.mjs';
+import isUnicodeRangeDescriptor from '../../utils/isUnicodeRangeDescriptor.mjs';
+import optionsMatches from '../../utils/optionsMatches.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 = 'unit-disallowed-list';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (unit) => `Unexpected unit "${unit}"`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/unit-disallowed-list',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: primary,
+				possible: [isString],
+			},
+			{
+				optional: true,
+				actual: secondaryOptions,
+				possible: {
+					ignoreFunctions: [isString, isRegExp],
+					ignoreProperties: [validateObjectWithArrayProps(isString, isRegExp)],
+					ignoreMediaFeatureNames: [validateObjectWithArrayProps(isString, isRegExp)],
+				},
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		const primaryValues = [primary].flat();
+
+		/**
+		 * Ignore wrong units within `url` function
+		 * Ignore units within function that match `ignoreFunctions` option
+		 *
+		 * @param {import('@csstools/css-parser-algorithms').ComponentValue} componentValue
+		 * @returns {boolean}
+		 */
+		function componentValueIsIgnored(componentValue) {
+			if (!isFunctionNode(componentValue)) {
+				return false;
+			}
+
+			const name = componentValue.getName().toLowerCase();
+
+			return name === 'url' || optionsMatches(secondaryOptions, 'ignoreFunctions', name);
+		}
+
+		/**
+		 * @template {import('postcss').AtRule | import('postcss').Declaration} T
+		 * @param {T} node
+		 * @param {(node: T) => number} getIndex
+		 * @param {import('@csstools/css-parser-algorithms').ComponentValue} componentValue
+		 * @param {string} input
+		 * @param {Record<string, unknown> | undefined} options
+		 * @returns {void}
+		 */
+		function check(node, getIndex, componentValue, input, options) {
+			if (!isTokenNode(componentValue)) return;
+
+			if (componentValue.value[0] !== TokenType.Dimension) return;
+
+			const [, , , endIndex, { unit }] = componentValue.value;
+
+			const lowerCaseUnit = unit.toLowerCase();
+
+			if (!primaryValues.includes(lowerCaseUnit)) {
+				return;
+			}
+
+			// The unit has an ignore option for the specific input
+			if (options && optionsMatches(options, lowerCaseUnit, input)) return;
+
+			const startIndex = getIndex(node) + (endIndex + 1) - unit.length;
+
+			report({
+				index: startIndex,
+				endIndex: startIndex + unit.length,
+				message: messages.rejected,
+				messageArgs: [unit],
+				node,
+				result,
+				ruleName,
+			});
+		}
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			const params = getAtRuleParams(atRule);
+
+			if (!mayIncludeRegexes.dimension.test(params)) return;
+
+			parseFromTokens(tokenizeWithoutPercentages(params)).forEach((mediaQuery) => {
+				/** @type {{ mediaFeatureName: string | undefined }} */
+				const initialState = {
+					mediaFeatureName: undefined,
+				};
+
+				mediaQuery.walk(({ node, state }) => {
+					if (!state) return;
+
+					if (isMediaFeature(node)) {
+						state.mediaFeatureName = node.getName().toLowerCase();
+					}
+
+					if (!state.mediaFeatureName) return;
+
+					if (!isTokenNode(node)) return;
+
+					check(
+						atRule,
+						atRuleParamIndex,
+						node,
+						state.mediaFeatureName,
+						secondaryOptions?.ignoreMediaFeatureNames,
+					);
+				}, initialState);
+			});
+		});
+
+		root.walkDecls((decl) => {
+			if (isUnicodeRangeDescriptor(decl)) return;
+
+			const value = getDeclarationValue(decl);
+
+			if (!mayIncludeRegexes.dimension.test(value)) return;
+
+			const initialState = {
+				ignored: false,
+			};
+
+			walk(
+				parseListOfComponentValues(tokenizeWithoutPercentages(value)),
+				({ node, state }) => {
+					if (!state) return;
+
+					if (state.ignored) return;
+
+					if (isTokenNode(node)) {
+						check(decl, declarationValueIndex, node, decl.prop, secondaryOptions?.ignoreProperties);
+
+						return;
+					}
+
+					if (componentValueIsIgnored(node)) {
+						state.ignored = true;
+					}
+				},
+				initialState,
+			);
+		});
+	};
+};
+
+/**
+ * In the CSS syntax percentages are a different token type than dimensions.
+ * For CSS authors however this distinction doesn't make sense, so we convert
+ * percentage tokens to dimension tokens with a unit of "%".
+ *
+ * Percentage tokens also aren't valid in media queries.
+ * Converting percentage tokens to dimension tokens simplifies any code checking for units.
+ *
+ * @param {string} css
+ * @returns {Array<import('@csstools/css-tokenizer').CSSToken>}
+ */
+function tokenizeWithoutPercentages(css) {
+	return tokenize({ css }).map((x) => {
+		if (x[0] !== TokenType.Percentage) return x;
+
+		return [
+			TokenType.Dimension,
+			x[1],
+			x[2],
+			x[3],
+			{ value: x[4].value, unit: '%', type: NumberType.Number },
+		];
+	});
+}
+
+rule.primaryOptionArray = true;
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/unit-no-unknown/index.mjs

@@ -0,0 +1,207 @@
+import { TokenType, tokenize } from '@csstools/css-tokenizer';
+import {
+	isFunctionNode,
+	isTokenNode,
+	parseListOfComponentValues,
+	walk,
+} from '@csstools/css-parser-algorithms';
+import { isMediaFeature, parseFromTokens } from '@csstools/media-query-list-parser';
+
+import { atRuleParamIndex, declarationValueIndex } from '../../utils/nodeFieldIndices.mjs';
+import { atRuleRegexes, mayIncludeRegexes } from '../../utils/regexes.mjs';
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import getAtRuleParams from '../../utils/getAtRuleParams.mjs';
+import getDeclarationValue from '../../utils/getDeclarationValue.mjs';
+import isStandardSyntaxAtRule from '../../utils/isStandardSyntaxAtRule.mjs';
+import isStandardSyntaxDeclaration from '../../utils/isStandardSyntaxDeclaration.mjs';
+import isStandardSyntaxValue from '../../utils/isStandardSyntaxValue.mjs';
+import isUnicodeRangeDescriptor from '../../utils/isUnicodeRangeDescriptor.mjs';
+import optionsMatches from '../../utils/optionsMatches.mjs';
+import { units as refUnits } from '../../reference/units.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 units = new Set(refUnits); // a copy that is safe to mutate
+
+// `x` as a resolution unit is very often a typo for `px`.
+// By removing it from the set of known units, we can catch those typos.
+// Intentional `x` units are supported by manually checking these in specific functions or properties.
+units.delete('x');
+
+const ruleName = 'unit-no-unknown';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (unit) => `Unexpected unknown unit "${unit}"`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/unit-no-unknown',
+};
+
+const RESOLUTION_MEDIA_FEATURE_NAME = /^(?:min-|max-)?resolution$/i;
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual: primary },
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignoreUnits: [isString, isRegExp],
+					ignoreFunctions: [isString, isRegExp],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		/**
+		 * @param {string} value
+		 */
+		const tokenizeIfValueMightContainUnknownUnits = (value) => {
+			if (!mayIncludeRegexes.dimension.test(value)) return;
+
+			const tokens = tokenize({ css: value });
+			const hasUnknownUnits = tokens.some((token) => {
+				return token[0] === TokenType.Dimension && !units.has(token[4].unit.toLowerCase());
+			});
+
+			if (!hasUnknownUnits) return;
+
+			return tokens;
+		};
+
+		/**
+		 * @template {import('postcss').AtRule | import('postcss').Declaration} T
+		 * @param {T} node
+		 * @param {(node: T) => number} getIndex
+		 * @param {import('@csstools/css-parser-algorithms').FunctionNode | import('@csstools/css-parser-algorithms').TokenNode} componentValue
+		 * @param {{ ignored: boolean, allowX: boolean }} state
+		 */
+		const check = (node, getIndex, componentValue, state) => {
+			if (isFunctionNode(componentValue)) {
+				const name = componentValue.getName();
+				const nameLowerCase = name.toLowerCase();
+
+				if (nameLowerCase === 'url' || optionsMatches(secondaryOptions, 'ignoreFunctions', name)) {
+					state.ignored = true;
+
+					return;
+				}
+
+				if (vendor.unprefixed(nameLowerCase) === 'image-set') {
+					state.allowX = true;
+
+					return;
+				}
+
+				return;
+			}
+
+			const [tokenType, , , endIndex, tokenValue] = componentValue.value;
+
+			if (tokenType !== TokenType.Dimension) return;
+
+			if (optionsMatches(secondaryOptions, 'ignoreUnits', tokenValue.unit)) return;
+
+			const unit = tokenValue.unit.toLowerCase();
+
+			if (unit === 'x' && state.allowX) return;
+
+			if (units.has(unit) && unit !== 'x') return;
+
+			const startIndex = getIndex(node) + (endIndex + 1) - unit.length;
+
+			report({
+				message: messages.rejected,
+				messageArgs: [tokenValue.unit],
+				node,
+				index: startIndex,
+				endIndex: startIndex + unit.length,
+				result,
+				ruleName,
+			});
+		};
+
+		root.walkAtRules(atRuleRegexes.mediaName, (atRule) => {
+			if (!isStandardSyntaxAtRule(atRule)) return;
+
+			const params = getAtRuleParams(atRule);
+
+			const tokens = tokenizeIfValueMightContainUnknownUnits(params);
+
+			if (!tokens) return;
+
+			parseFromTokens(tokens).forEach((mediaQuery) => {
+				const initialState = {
+					ignored: false,
+					allowX: false,
+				};
+
+				mediaQuery.walk(({ node, state }) => {
+					if (!state) return;
+
+					if (state.ignored) return;
+
+					if (isMediaFeature(node)) {
+						const name = node.getName();
+
+						if (RESOLUTION_MEDIA_FEATURE_NAME.test(name)) {
+							state.allowX = true;
+						}
+					} else if (isFunctionNode(node) || isTokenNode(node)) {
+						check(atRule, atRuleParamIndex, node, state);
+					}
+				}, initialState);
+			});
+		});
+
+		root.walkDecls((decl) => {
+			if (!isStandardSyntaxDeclaration(decl)) return;
+
+			if (isUnicodeRangeDescriptor(decl)) return;
+
+			const value = getDeclarationValue(decl);
+
+			if (!isStandardSyntaxValue(value)) return;
+
+			const tokens = tokenizeIfValueMightContainUnknownUnits(value);
+
+			if (!tokens) return;
+
+			const isImageResolutionProp = decl.prop.toLowerCase() === 'image-resolution';
+
+			const initialState = {
+				ignored: false,
+				allowX: isImageResolutionProp,
+			};
+
+			walk(
+				parseListOfComponentValues(tokens),
+				({ node, state }) => {
+					if (!state) return;
+
+					if (state.ignored) return;
+
+					if (isFunctionNode(node) || isTokenNode(node)) {
+						check(decl, declarationValueIndex, node, state);
+					}
+				},
+				initialState,
+			);
+		});
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;