index.js 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. 'use strict';
  2. const valueParser = require('postcss-value-parser');
  3. const declarationValueIndex = require('../../utils/declarationValueIndex');
  4. const report = require('../../utils/report');
  5. const ruleMessages = require('../../utils/ruleMessages');
  6. const { isValueFunction } = require('../../utils/typeGuards');
  7. const validateOptions = require('../../utils/validateOptions');
  8. const ruleName = 'no-unknown-custom-properties';
  9. const messages = ruleMessages(ruleName, {
  10. rejected: (propName) => `Unexpected unknown custom property "${propName}"`,
  11. });
  12. const meta = {
  13. url: 'https://stylelint.io/user-guide/rules/no-unknown-custom-properties',
  14. };
  15. /** @type {import('stylelint').Rule} */
  16. const rule = (primary) => {
  17. return (root, result) => {
  18. const validOptions = validateOptions(result, ruleName, { actual: primary });
  19. if (!validOptions) return;
  20. /** @type {Set<string>} */
  21. const declaredCustomProps = new Set();
  22. root.walkAtRules(/^property$/i, ({ params }) => {
  23. declaredCustomProps.add(params);
  24. });
  25. root.walkDecls(/^--/, ({ prop }) => {
  26. declaredCustomProps.add(prop);
  27. });
  28. root.walkDecls((decl) => {
  29. const { value } = decl;
  30. const parsedValue = valueParser(value);
  31. parsedValue.walk((node) => {
  32. if (!isValueFunction(node) || node.value !== 'var') return;
  33. const [firstNode, secondNode] = node.nodes;
  34. if (!firstNode || declaredCustomProps.has(firstNode.value)) return;
  35. // Second node (div) indicates fallback exists in all cases
  36. if (secondNode && secondNode.type === 'div') return;
  37. const startIndex = declarationValueIndex(decl);
  38. report({
  39. result,
  40. ruleName,
  41. message: messages.rejected,
  42. messageArgs: [firstNode.value],
  43. node: decl,
  44. index: startIndex + firstNode.sourceIndex,
  45. endIndex: startIndex + firstNode.sourceEndIndex,
  46. });
  47. });
  48. });
  49. };
  50. };
  51. rule.ruleName = ruleName;
  52. rule.messages = messages;
  53. rule.meta = meta;
  54. module.exports = rule;