first commit

node_modules/stylelint/lib/utils/flattenNestedSelectorsForRule.mjs

@@ -0,0 +1,67 @@
+import resolveNestedSelector from 'postcss-resolve-nested-selector';
+import selectorParser from 'postcss-selector-parser';
+
+import getRuleSelector from './getRuleSelector.mjs';
+import isStandardSyntaxSelector from './isStandardSyntaxSelector.mjs';
+import parseSelector from './parseSelector.mjs';
+
+/** @import { Selector, Root } from 'postcss-selector-parser' */
+/** @import { Rule } from 'postcss' */
+/** @import { PostcssResult } from 'stylelint' */
+
+/**
+ * Flatten the selectors of the current rule against it's parent rules and at-rules.
+ *
+ * The selectors for the current rule are assumed to be standard CSS selectors.
+ *
+ * @typedef {{selector: Selector, resolvedSelectors: Root, nested: boolean}} FlattenedSelector
+ *
+ * @param {Rule} rule
+ * @param {PostcssResult} result
+ * @returns {Array<FlattenedSelector>}
+ */
+export default function flattenNestedSelectorsForRule(rule, result) {
+	const ownAST = parseSelector(getRuleSelector(rule), result, rule);
+
+	if (!ownAST) return [];
+
+	/** @type {Array<FlattenedSelector>} */
+	const flattenedSelectors = [];
+
+	for (const selectorAST of ownAST.nodes) {
+		const selector = selectorAST.toString();
+
+		const resolvedSelectors = resolveNestedSelector(selector, rule);
+
+		if (resolvedSelectors.length === 1 && resolvedSelectors[0] === selector) {
+			flattenedSelectors.push({
+				selector: selectorAST,
+				resolvedSelectors: selectorParser.root({
+					value: '',
+					nodes: [selectorAST],
+				}),
+				nested: false,
+			});
+
+			continue;
+		}
+
+		for (const resolvedSelector of resolvedSelectors) {
+			if (!isStandardSyntaxSelector(resolvedSelector)) return [];
+
+			const resolvedRoot = parseSelector(resolvedSelector, result, rule);
+
+			if (!resolvedRoot) {
+				continue;
+			}
+
+			flattenedSelectors.push({
+				selector: selectorAST,
+				resolvedSelectors: resolvedRoot,
+				nested: true,
+			});
+		}
+	}
+
+	return flattenedSelectors;
+}