import selectorParser from 'postcss-selector-parser'; const { isSelector } = selectorParser; import flattenNestedSelectorsForRule from '../../utils/flattenNestedSelectorsForRule.mjs'; import getStrippedSelectorSource from '../../utils/getStrippedSelectorSource.mjs'; import isNonNegativeInteger from '../../utils/isNonNegativeInteger.mjs'; import isStandardSyntaxRule from '../../utils/isStandardSyntaxRule.mjs'; import { isString } from '../../utils/validateTypes.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 = 'selector-max-universal'; const messages = ruleMessages(ruleName, { expected: (selector, max) => `Expected "${selector}" to have no more than ${max} universal ${ max === 1 ? 'selector' : 'selectors' }`, }); const meta = { url: 'https://stylelint.io/user-guide/rules/selector-max-universal', }; /** @type {import('stylelint').CoreRules[ruleName]} */ const rule = (primary, secondaryOptions) => { return (root, result) => { const validOptions = validateOptions( result, ruleName, { actual: primary, possible: isNonNegativeInteger, }, { actual: secondaryOptions, possible: { ignoreAfterCombinators: [isString], }, optional: true, }, ); if (!validOptions) { return; } /** * @param {import('postcss-selector-parser').Selector} resolvedSelectorNode * @param {import('postcss-selector-parser').Selector} selectorNode * @param {import('postcss').Rule} ruleNode */ function checkSelector(resolvedSelectorNode, selectorNode, ruleNode) { const count = resolvedSelectorNode.reduce((total, childNode) => { const prevChildNode = childNode.prev(); const prevChildNodeValue = prevChildNode && prevChildNode.value; if (childNode.type === 'universal') { if (!optionsMatches(secondaryOptions, 'ignoreAfterCombinators', prevChildNodeValue)) { total += 1; } } return total; }, 0); if (count > primary) { const { index, endIndex, selector: selectorStr } = getStrippedSelectorSource(selectorNode); report({ ruleName, result, node: ruleNode, message: messages.expected, messageArgs: [selectorStr, primary], index, endIndex, }); } } root.walkRules((ruleNode) => { if (!isStandardSyntaxRule(ruleNode)) return; flattenNestedSelectorsForRule(ruleNode, result).forEach(({ selector, resolvedSelectors }) => { resolvedSelectors.walk((childSelector) => { if (!isSelector(childSelector)) return; checkSelector(childSelector, selector, ruleNode); }); }); }); }; }; rule.ruleName = ruleName; rule.messages = messages; rule.meta = meta; export default rule;