'use strict'; const atRuleParamIndex = require('../../utils/atRuleParamIndex'); const isCustomSelector = require('../../utils/isCustomSelector'); const isStandardSyntaxAtRule = require('../../utils/isStandardSyntaxAtRule'); const isStandardSyntaxRule = require('../../utils/isStandardSyntaxRule'); const isStandardSyntaxSelector = require('../../utils/isStandardSyntaxSelector'); const keywordSets = require('../../reference/keywordSets'); const optionsMatches = require('../../utils/optionsMatches'); const parseSelector = require('../../utils/parseSelector'); const report = require('../../utils/report'); const ruleMessages = require('../../utils/ruleMessages'); const validateOptions = require('../../utils/validateOptions'); const vendor = require('../../utils/vendor'); const { isString } = require('../../utils/validateTypes'); const ruleName = 'selector-pseudo-class-no-unknown'; const messages = ruleMessages(ruleName, { rejected: (selector) => `Unexpected unknown pseudo-class selector "${selector}"`, }); const meta = { url: 'https://stylelint.io/user-guide/rules/list/selector-pseudo-class-no-unknown', }; /** @type {import('stylelint').Rule} */ const rule = (primary, secondaryOptions) => { return (root, result) => { const validOptions = validateOptions( result, ruleName, { actual: primary }, { actual: secondaryOptions, possible: { ignorePseudoClasses: [isString], }, optional: true, }, ); if (!validOptions) { return; } /** * @param {string} selector * @param {import('postcss').ChildNode} node */ function check(selector, node) { parseSelector(selector, result, node, (selectorTree) => { selectorTree.walkPseudos((pseudoNode) => { const value = pseudoNode.value; if (!isStandardSyntaxSelector(value)) { return; } if (isCustomSelector(value)) { return; } // Ignore pseudo-elements if (value.slice(0, 2) === '::') { return; } if (optionsMatches(secondaryOptions, 'ignorePseudoClasses', pseudoNode.value.slice(1))) { return; } let index = null; const name = value.slice(1).toLowerCase(); if (node.type === 'atrule' && node.name === 'page') { if (keywordSets.atRulePagePseudoClasses.has(name)) { return; } index = atRuleParamIndex(node) + pseudoNode.sourceIndex; } else { if ( vendor.prefix(name) || keywordSets.pseudoClasses.has(name) || keywordSets.pseudoElements.has(name) ) { return; } /** @type {import('postcss-selector-parser').Base} */ let prevPseudoElement = pseudoNode; do { prevPseudoElement = /** @type {import('postcss-selector-parser').Base} */ ( prevPseudoElement.prev() ); if (prevPseudoElement && prevPseudoElement.value.slice(0, 2) === '::') { break; } } while (prevPseudoElement); if (prevPseudoElement) { const prevPseudoElementValue = prevPseudoElement.value.toLowerCase().slice(2); if ( keywordSets.webkitScrollbarPseudoElements.has(prevPseudoElementValue) && keywordSets.webkitScrollbarPseudoClasses.has(name) ) { return; } } index = pseudoNode.sourceIndex; } report({ message: messages.rejected(value), node, index, ruleName, result, }); }); }); } root.walk((node) => { let selector = null; if (node.type === 'rule') { if (!isStandardSyntaxRule(node)) { return; } selector = node.selector; } else if (node.type === 'atrule' && node.name === 'page' && node.params) { if (!isStandardSyntaxAtRule(node)) { return; } selector = node.params; } // Return if selector empty, it is meaning node type is not a rule or a at-rule if (!selector) { return; } // Return early before parse if no pseudos for performance if (!selector.includes(':')) { return; } check(selector, node); }); }; }; rule.ruleName = ruleName; rule.messages = messages; rule.meta = meta; module.exports = rule;