// NOTICE: This file is generated by Rollup. To modify it, // please instead edit the ESM counterpart and rebuild with Rollup (npm run build). 'use strict'; const selectorSpecificity = require('@csstools/selector-specificity'); const typeGuards = require('../../utils/typeGuards.cjs'); const findAtRuleContext = require('../../utils/findAtRuleContext.cjs'); const flattenNestedSelectorsForRule = require('../../utils/flattenNestedSelectorsForRule.cjs'); const getStrippedSelectorSource = require('../../utils/getStrippedSelectorSource.cjs'); const isStandardSyntaxRule = require('../../utils/isStandardSyntaxRule.cjs'); const nodeContextLookup = require('../../utils/nodeContextLookup.cjs'); const normalizeSelector = require('../../utils/normalizeSelector.cjs'); const optionsMatches = require('../../utils/optionsMatches.cjs'); const selectors = require('../../reference/selectors.cjs'); const report = require('../../utils/report.cjs'); const ruleMessages = require('../../utils/ruleMessages.cjs'); const validateOptions = require('../../utils/validateOptions.cjs'); const ruleName = 'no-descending-specificity'; const messages = ruleMessages(ruleName, { expected: (b, a) => { return `Expected selector "${b}" to come before selector "${a}"`; }, }); const meta = { url: 'https://stylelint.io/user-guide/rules/no-descending-specificity', }; /** @typedef {{ selector: string, specificity: import('@csstools/selector-specificity').Specificity }} 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} */ const comparisonContext = selectorContextLookup.getContext( ruleNode, findAtRuleContext(ruleNode), ); // Resolve any nested selectors before checking flattenNestedSelectorsForRule(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} comparisonContext */ function checkSelector(resolvedSelectorNode, selectorNode, ruleNode, comparisonContext) { const referenceSelector = lastCompoundSelectorWithoutPseudoClasses(resolvedSelectorNode); if (!referenceSelector) return; const specificity = selectorSpecificity.selectorSpecificity(resolvedSelectorNode); const entry = { selector: resolvedSelectorNode.toString().trim(), specificity, }; const priorComparableSelectors = comparisonContext.get(referenceSelector); if (!priorComparableSelectors) { comparisonContext.set(referenceSelector, [entry]); return; } for (const priorEntry of priorComparableSelectors) { if (selectorSpecificity.compare(specificity, priorEntry.specificity) < 0) { const { index, endIndex, selector: selectorStr, } = getStrippedSelectorSource(selectorNode); report({ ruleName, result, node: ruleNode, message: messages.expected, messageArgs: [selectorStr, priorEntry.selector], index, endIndex, }); break; } } priorComparableSelectors.push(entry); } }; }; /** * @param {import('postcss-selector-parser').Selector} selectorNode * @returns {string | undefined} */ function lastCompoundSelectorWithoutPseudoClasses(selectorNode) { if (selectorNode.nodes.length === 0) return undefined; selectorNode = normalizeSelector(selectorNode.clone()); 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('::') || selectors.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 typeGuards.isDeclaration(child) || (typeGuards.isAtRule(child) && hasDeclaration(child)); }); } rule.ruleName = ruleName; rule.messages = messages; rule.meta = meta; module.exports = rule;