@alexlit/lint-kit 182.1.0 → 182.2.0

package/packages/config-stylelint/node_modules/stylelint/lib/rules/nesting-selector-no-missing-scoping-root/index.mjs

@@ -0,0 +1,165 @@
+import { parse, walk } from 'css-tree';
+
+import { atRuleRegexes, mayIncludeRegexes } from '../../utils/regexes.mjs';
+import { isRegExp, isString } from '../../utils/validateTypes.mjs';
+import { atRuleParamIndex } from '../../utils/nodeFieldIndices.mjs';
+import getAtRuleParams from '../../utils/getAtRuleParams.mjs';
+import getRuleSelector from '../../utils/getRuleSelector.mjs';
+import isInDocument from '../../utils/isInDocument.mjs';
+import isStandardSyntaxAtRule from '../../utils/isStandardSyntaxAtRule.mjs';
+import isStandardSyntaxRule from '../../utils/isStandardSyntaxRule.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 = 'nesting-selector-no-missing-scoping-root';
+
+const messages = ruleMessages(ruleName, {
+	rejected: 'Unexpected missing scoping root',
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/nesting-selector-no-missing-scoping-root',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual: primary, possible: [true] },
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignoreAtRules: [isString, isRegExp],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) return;
+
+		root.walkRules(mayIncludeRegexes.nestingSelector, (ruleNode) => {
+			if (isInDocument(ruleNode)) return;
+
+			if (!isStandardSyntaxRule(ruleNode)) return;
+
+			// Check if the rule is nested within a scoping root
+			if (hasValidScopingRoot(ruleNode, secondaryOptions)) return;
+
+			let ast;
+
+			try {
+				ast = parse(getRuleSelector(ruleNode), { context: 'selectorList', positions: true });
+			} catch {
+				// Cannot parse selector list, skip checking
+				return;
+			}
+
+			check(ruleNode, ast);
+		});
+
+		// Check @scope at-rules for nesting selectors in parameters
+		root.walkAtRules(atRuleRegexes.scopeName, (atRule) => {
+			if (isInDocument(atRule)) return;
+
+			if (!isStandardSyntaxAtRule(atRule)) return;
+
+			if (!mayIncludeRegexes.nestingSelector.test(atRule.params)) return;
+
+			// Only check @scope at-rules that don't have a parent scoping context
+			if (hasValidScopingRoot(atRule, secondaryOptions)) return;
+
+			let ast;
+
+			try {
+				ast = parse(getAtRuleParams(atRule), {
+					atrule: 'scope',
+					context: 'atrulePrelude',
+					positions: true,
+				});
+			} catch {
+				// Cannot parse @scope at-rule, skip checking
+				return;
+			}
+
+			check(atRule, ast, atRuleParamIndex(atRule));
+		});
+
+		/**
+		 * @param {import('postcss').Rule | import('postcss').AtRule} node
+		 * @param {import('css-tree').CssNode} ast
+		 * @param {number} [offset=0]
+		 */
+		function check(node, ast, offset = 0) {
+			walk(ast, {
+				/**
+				 * @param {import('css-tree').CssNode} cssNode
+				 */
+				enter(cssNode) {
+					if (cssNode.type !== 'NestingSelector') return;
+
+					if (!cssNode.loc) return;
+
+					const index = offset + cssNode.loc.start.offset;
+					const endIndex = index + 1;
+
+					report({
+						message: messages.rejected,
+						node,
+						result,
+						ruleName,
+						index,
+						endIndex,
+					});
+				},
+			});
+		}
+	};
+};
+
+/**
+ * Check if a node has a valid scoping root
+ * @param {import('postcss').Rule | import('postcss').AtRule} node
+ * @param {object} secondaryOptions
+ * @returns {boolean}
+ */
+function hasValidScopingRoot(node, secondaryOptions) {
+	let current = node.parent;
+
+	while (current) {
+		// If we find a rule in the parent chain, it provides a scoping root
+		if (current.type === 'rule') {
+			return true;
+		}
+
+		// If we find an @scope at-rule, it provides a scoping root
+		if (current.type === 'atrule' && current.name === 'scope') {
+			return true;
+		}
+
+		// If we find an ignored at-rule, it provides a scoping root
+		if (
+			current.type === 'atrule' &&
+			optionsMatches(secondaryOptions, 'ignoreAtRules', current.name)
+		) {
+			return true;
+		}
+
+		// If we reach the root without finding a scoping root
+		if (current.type === 'root') {
+			return false;
+		}
+
+		current = current.parent;
+	}
+
+	return false;
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/no-descending-specificity/index.mjs

@@ -0,0 +1,200 @@
+import { compare, selectorSpecificity } from '@csstools/selector-specificity';
+
+import { isAtRule, isDeclaration } from '../../utils/typeGuards.mjs';
+import findAtRuleContext from '../../utils/findAtRuleContext.mjs';
+import getStrippedSelectorSource from '../../utils/getStrippedSelectorSource.mjs';
+import isStandardSyntaxRule from '../../utils/isStandardSyntaxRule.mjs';
+import nodeContextLookup from '../../utils/nodeContextLookup.mjs';
+import normalizeSelector from '../../utils/normalizeSelector.mjs';
+import optionsMatches from '../../utils/optionsMatches.mjs';
+import { pseudoElements } from '../../reference/selectors.mjs';
+import report from '../../utils/report.mjs';
+import resolveNestedSelectorsForRule from '../../utils/resolveNestedSelectorsForRule.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+const ruleName = 'no-descending-specificity';
+
+const messages = ruleMessages(ruleName, {
+	expected: (subsequent, prior, priorLine, subsequentResolved, priorResolved) => {
+		subsequent = `"${subsequent}"${subsequentResolved ? ` ("${subsequentResolved}")` : ''}`;
+		prior = `"${prior}"${priorResolved ? ` ("${priorResolved}")` : ''}`;
+
+		return `Expected selector ${subsequent} to come before selector ${prior}, at line ${priorLine}`;
+	},
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/no-descending-specificity',
+};
+
+/** @typedef {{ selector: string, resolvedSelector: string, specificity: import('@csstools/selector-specificity').Specificity, line: number }} Entry */
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary, secondaryOptions) => {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: primary,
+			},
+			{
+				optional: true,
+				actual: secondaryOptions,
+				possible: {
+					ignore: ['selectors-within-list'],
+				},
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		const ignoreSelectorsWithinList = optionsMatches(
+			secondaryOptions,
+			'ignore',
+			'selectors-within-list',
+		);
+
+		const selectorContextLookup = nodeContextLookup();
+
+		root.walkRules((ruleNode) => {
+			// Ignore nested property `foo: {};`
+			if (!isStandardSyntaxRule(ruleNode)) {
+				return;
+			}
+
+			// Ignores selectors within list of selectors
+			if (ignoreSelectorsWithinList && ruleNode.selectors.length > 1) {
+				return;
+			}
+
+			// Ignore rules that do not directly contain declarations
+			if (!hasDeclaration(ruleNode)) {
+				return;
+			}
+
+			/** @type {Map<string, Entry[]>} */
+			const comparisonContext = selectorContextLookup.getContext(
+				ruleNode,
+				findAtRuleContext(ruleNode),
+			);
+
+			// Resolve any nested selectors before checking
+			resolveNestedSelectorsForRule(ruleNode, result).forEach(({ selector, resolvedSelectors }) => {
+				resolvedSelectors.each((resolvedSelector) => {
+					checkSelector(resolvedSelector, selector, ruleNode, comparisonContext);
+				});
+			});
+		});
+
+		/**
+		 * @param {import('postcss-selector-parser').Selector} resolvedSelectorNode
+		 * @param {import('postcss-selector-parser').Selector} selectorNode
+		 * @param {import('postcss').Rule} ruleNode
+		 * @param {Map<string, Entry[]>} comparisonContext
+		 */
+		function checkSelector(resolvedSelectorNode, selectorNode, ruleNode, comparisonContext) {
+			const referenceSelector = lastCompoundSelectorWithoutPseudoClasses(
+				resolvedSelectorNode,
+				result,
+			);
+
+			if (!referenceSelector) return;
+
+			const specificity = selectorSpecificity(resolvedSelectorNode);
+			const { selector, index, endIndex } = getStrippedSelectorSource(selectorNode);
+			let { selector: resolvedSelector } = getStrippedSelectorSource(resolvedSelectorNode);
+
+			resolvedSelector = resolvedSelector === selector ? '' : resolvedSelector;
+
+			const entry = {
+				selector,
+				resolvedSelector,
+				specificity,
+				line: ruleNode.source?.start?.line ?? 1,
+			};
+			const priorComparableSelectors = comparisonContext.get(referenceSelector);
+
+			if (!priorComparableSelectors) {
+				comparisonContext.set(referenceSelector, [entry]);
+
+				return;
+			}
+
+			for (const priorEntry of priorComparableSelectors) {
+				if (compare(specificity, priorEntry.specificity) < 0) {
+					report({
+						ruleName,
+						result,
+						node: ruleNode,
+						message: messages.expected,
+						messageArgs: [
+							selector,
+							priorEntry.selector,
+							priorEntry.line,
+							resolvedSelector,
+							priorEntry.resolvedSelector,
+						],
+						index,
+						endIndex,
+					});
+
+					break;
+				}
+			}
+
+			priorComparableSelectors.push(entry);
+		}
+	};
+};
+
+/**
+ * @param {import('postcss-selector-parser').Selector} selectorNode
+ * @param {import('stylelint').PostcssResult} result
+ * @returns {string | undefined}
+ */
+function lastCompoundSelectorWithoutPseudoClasses(selectorNode, result) {
+	if (selectorNode.nodes.length === 0) return undefined;
+
+	selectorNode = normalizeSelector(selectorNode, result).node;
+
+	const nodesByCombinator = selectorNode.split((node) => node.type === 'combinator');
+	const nodesAfterLastCombinator = nodesByCombinator[nodesByCombinator.length - 1];
+
+	if (!nodesAfterLastCombinator) return undefined;
+
+	const nodesWithoutPseudoClasses = nodesAfterLastCombinator.filter((node) => {
+		return (
+			node.type !== 'pseudo' ||
+			node.value.startsWith('::') ||
+			pseudoElements.has(node.value.replaceAll(':', ''))
+		);
+	});
+
+	if (nodesWithoutPseudoClasses.length === 0) return undefined;
+
+	return nodesWithoutPseudoClasses.join('');
+}
+
+/**
+ * Specificity only has an effect on declarations.
+ * We only want to check rules that contain declarations either directly or in nested at-rules.
+ *
+ * @param {import('postcss').Container} node
+ * @returns {boolean}
+ */
+function hasDeclaration(node) {
+	if (!node.nodes) return false;
+
+	return node.some((child) => {
+		return isDeclaration(child) || (isAtRule(child) && hasDeclaration(child));
+	});
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;

package/packages/config-stylelint/node_modules/stylelint/lib/rules/no-duplicate-at-import-rules/index.mjs

@@ -0,0 +1,156 @@
+import valueParser from 'postcss-value-parser';
+
+import { atRuleRegexes } from '../../utils/regexes.mjs';
+import getAtRuleParams from '../../utils/getAtRuleParams.mjs';
+import isUrlFunction from '../../utils/isUrlFunction.mjs';
+import report from '../../utils/report.mjs';
+import ruleMessages from '../../utils/ruleMessages.mjs';
+import validateOptions from '../../utils/validateOptions.mjs';
+
+const ruleName = 'no-duplicate-at-import-rules';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (atImport) => `Unexpected duplicate @import rule ${atImport}`,
+});
+
+const meta = {
+	url: 'https://stylelint.io/user-guide/rules/no-duplicate-at-import-rules',
+};
+
+/** @type {import('stylelint').CoreRules[ruleName]} */
+const rule = (primary) => {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, { actual: primary });
+
+		if (!validOptions) {
+			return;
+		}
+
+		/** @type {Record<string, string[]>} */
+		const imports = {};
+
+		root.walkAtRules(atRuleRegexes.importName, (atRule) => {
+			const [firstParam, ...restParams] = valueParser(getAtRuleParams(atRule)).nodes;
+
+			if (!firstParam) {
+				return;
+			}
+
+			// extract uri from url() if exists
+			const uri =
+				isUrlFunction(firstParam) && firstParam.nodes[0]
+					? firstParam.nodes[0].value
+					: firstParam.value;
+
+			const media = listImportConditions(restParams);
+
+			let importedUris = imports[uri];
+			const isDuplicate = media.length
+				? media.some((q) => importedUris && importedUris.includes(q))
+				: importedUris;
+
+			if (isDuplicate) {
+				report({
+					message: messages.rejected,
+					messageArgs: [uri],
+					node: atRule,
+					result,
+					ruleName,
+					word: atRule.toString(),
+				});
+
+				return;
+			}
+
+			if (!importedUris) {
+				importedUris = imports[uri] = [];
+			}
+
+			importedUris.push(...media);
+		});
+	};
+};
+
+/** @typedef { import('postcss-value-parser').Node } Node */
+
+/**
+ * @param {Node | Array<Node>} node
+ * @returns {string}
+ */
+function stringifyCondition(node) {
+	// remove whitespace to get a more consistent key
+	return valueParser.stringify(node).replace(/\s/g, '');
+}
+
+/**
+ * List the import conditions found in the prelude of an `@import` rule
+ *
+ * @param {Node[]} params
+ * @returns {Array<string>}
+ */
+function listImportConditions(params) {
+	if (!params.length) return [];
+
+	const separator = ' ';
+	/** @type {Array<string>} */
+	const sharedConditions = [];
+	/** @type {Array<string>} */
+	const media = [];
+	/** @type {Array<Node>} */
+	let lastMediaQuery = [];
+
+	for (const param of params) {
+		// remove top level whitespace and comments to get a more consistent key
+		if (param.type === 'space' || param.type === 'comment') {
+			continue;
+		}
+
+		// layer and supports conditions must precede media query conditions
+		if (!media.length) {
+			// @import url(...) layer(base) supports(display: flex)
+			if (param.type === 'function' && (param.value === 'supports' || param.value === 'layer')) {
+				sharedConditions.push(stringifyCondition(param));
+				continue;
+			}
+
+			// @import url(...) layer
+			if (param.type === 'word' && param.value === 'layer') {
+				sharedConditions.push(stringifyCondition(param));
+				continue;
+			}
+		}
+
+		if (param.type === 'div' && param.value === ',') {
+			media.push(stringifyCondition(lastMediaQuery));
+			lastMediaQuery = [];
+			continue;
+		}
+
+		lastMediaQuery.push(param);
+	}
+
+	if (lastMediaQuery.length) {
+		media.push(stringifyCondition(lastMediaQuery));
+	}
+
+	// Only media query conditions
+	if (media.length && !sharedConditions.length) {
+		return media;
+	}
+
+	// Only layer and supports conditions
+	if (!media.length && sharedConditions.length) {
+		return [sharedConditions.join(separator)];
+	}
+
+	const sharedConditionsString = sharedConditions.join(separator);
+
+	return media.map((m) => {
+		return sharedConditionsString + separator + m;
+	});
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+export default rule;