index.mjs 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. import selectorParser from 'postcss-selector-parser';
  2. const { isSelector } = selectorParser;
  3. import flattenNestedSelectorsForRule from '../../utils/flattenNestedSelectorsForRule.mjs';
  4. import getStrippedSelectorSource from '../../utils/getStrippedSelectorSource.mjs';
  5. import isNonNegativeInteger from '../../utils/isNonNegativeInteger.mjs';
  6. import isStandardSyntaxRule from '../../utils/isStandardSyntaxRule.mjs';
  7. import report from '../../utils/report.mjs';
  8. import ruleMessages from '../../utils/ruleMessages.mjs';
  9. import validateOptions from '../../utils/validateOptions.mjs';
  10. const ruleName = 'selector-max-combinators';
  11. const messages = ruleMessages(ruleName, {
  12. expected: (selector, max) =>
  13. `Expected "${selector}" to have no more than ${max} ${
  14. max === 1 ? 'combinator' : 'combinators'
  15. }`,
  16. });
  17. const meta = {
  18. url: 'https://stylelint.io/user-guide/rules/selector-max-combinators',
  19. };
  20. /** @type {import('stylelint').CoreRules[ruleName]} */
  21. const rule = (primary) => {
  22. return (root, result) => {
  23. const validOptions = validateOptions(result, ruleName, {
  24. actual: primary,
  25. possible: isNonNegativeInteger,
  26. });
  27. if (!validOptions) {
  28. return;
  29. }
  30. /**
  31. * @param {import('postcss-selector-parser').Selector} resolvedSelectorNode
  32. * @param {import('postcss-selector-parser').Selector} selectorNode
  33. * @param {import('postcss').Rule} ruleNode
  34. */
  35. function checkSelector(resolvedSelectorNode, selectorNode, ruleNode) {
  36. const count = resolvedSelectorNode.reduce((total, childNode) => {
  37. if (childNode.type === 'combinator') total += 1;
  38. return total;
  39. }, 0);
  40. if (count > primary) {
  41. const { index, endIndex, selector: selectorStr } = getStrippedSelectorSource(selectorNode);
  42. report({
  43. ruleName,
  44. result,
  45. node: ruleNode,
  46. message: messages.expected,
  47. messageArgs: [selectorStr, primary],
  48. index,
  49. endIndex,
  50. });
  51. }
  52. }
  53. root.walkRules((ruleNode) => {
  54. if (!isStandardSyntaxRule(ruleNode)) return;
  55. flattenNestedSelectorsForRule(ruleNode, result).forEach(({ selector, resolvedSelectors }) => {
  56. resolvedSelectors.walk((childSelector) => {
  57. if (!isSelector(childSelector)) return;
  58. checkSelector(childSelector, selector, ruleNode);
  59. });
  60. });
  61. });
  62. };
  63. };
  64. rule.ruleName = ruleName;
  65. rule.messages = messages;
  66. rule.meta = meta;
  67. export default rule;