// 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 valueParser = require('postcss-value-parser'); const keywords = require('../../reference/keywords.cjs'); const validateTypes = require('../../utils/validateTypes.cjs'); const nodeFieldIndices = require('../../utils/nodeFieldIndices.cjs'); const getDeclarationValue = require('../../utils/getDeclarationValue.cjs'); const getDimension = require('../../utils/getDimension.cjs'); const isCounterIncrementCustomIdentValue = require('../../utils/isCounterIncrementCustomIdentValue.cjs'); const isCounterResetCustomIdentValue = require('../../utils/isCounterResetCustomIdentValue.cjs'); const isStandardSyntaxValue = require('../../utils/isStandardSyntaxValue.cjs'); const optionsMatches = require('../../utils/optionsMatches.cjs'); const report = require('../../utils/report.cjs'); const ruleMessages = require('../../utils/ruleMessages.cjs'); const validateOptions = require('../../utils/validateOptions.cjs'); const ruleName = 'value-keyword-case'; const messages = ruleMessages(ruleName, { expected: (actual, expected) => `Expected "${actual}" to be "${expected}"`, }); const meta = { url: 'https://stylelint.io/user-guide/rules/value-keyword-case', fixable: true, }; // Operators are interpreted as "words" by the value parser, so we want to make sure to ignore them. const ignoredCharacters = new Set(['+', '-', '/', '*', '%']); const gridRowProps = new Set(['grid-row', 'grid-row-start', 'grid-row-end']); const gridColumnProps = new Set(['grid-column', 'grid-column-start', 'grid-column-end']); const mapLowercaseKeywordsToCamelCase = new Map(); for (const func of keywords.camelCaseKeywords) { mapLowercaseKeywordsToCamelCase.set(func.toLowerCase(), func); } /** @type {import('stylelint').CoreRules[ruleName]} */ const rule = (primary, secondaryOptions) => { return (root, result) => { const validOptions = validateOptions( result, ruleName, { actual: primary, possible: ['lower', 'upper'], }, { actual: secondaryOptions, possible: { ignoreProperties: [validateTypes.isString, validateTypes.isRegExp], ignoreKeywords: [validateTypes.isString, validateTypes.isRegExp], ignoreFunctions: [validateTypes.isString, validateTypes.isRegExp], camelCaseSvgKeywords: [validateTypes.isBoolean], }, optional: true, }, ); if (!validOptions) { return; } root.walkDecls((decl) => { const prop = decl.prop; const propLowerCase = decl.prop.toLowerCase(); const value = decl.value; if (!isStandardSyntaxValue(value)) return; const parsed = valueParser(getDeclarationValue(decl)); parsed.walk((node) => { const keyword = node.value; const valueLowerCase = keyword.toLowerCase(); // Ignore system colors if (keywords.systemColorsKeywords.has(valueLowerCase)) { return; } // Ignore keywords within `url` and `var` function if ( node.type === 'function' && (valueLowerCase === 'url' || valueLowerCase === 'var' || valueLowerCase === 'counter' || valueLowerCase === 'counters' || valueLowerCase === 'attr') ) { return false; } // ignore keywords within ignoreFunctions functions if ( node.type === 'function' && optionsMatches(secondaryOptions, 'ignoreFunctions', keyword) ) { return false; } const { unit } = getDimension(node); // Ignore css variables, and hex values, and math operators, and sass interpolation if ( node.type !== 'word' || !isStandardSyntaxValue(keyword) || value.includes('#') || ignoredCharacters.has(keyword) || unit ) { return; } if ( propLowerCase === 'animation' && !keywords.animationShorthandKeywords.has(valueLowerCase) && !keywords.animationNameKeywords.has(valueLowerCase) ) { return; } if (propLowerCase === 'animation-name' && !keywords.animationNameKeywords.has(valueLowerCase)) { return; } if ( propLowerCase === 'font' && !keywords.fontShorthandKeywords.has(valueLowerCase) && !keywords.fontFamilyKeywords.has(valueLowerCase) ) { return; } if (propLowerCase === 'font-family' && !keywords.fontFamilyKeywords.has(valueLowerCase)) { return; } if ( propLowerCase === 'counter-increment' && isCounterIncrementCustomIdentValue(valueLowerCase) ) { return; } if (propLowerCase === 'counter-reset' && isCounterResetCustomIdentValue(valueLowerCase)) { return; } if (gridRowProps.has(propLowerCase) && !keywords.gridRowKeywords.has(valueLowerCase)) { return; } if (gridColumnProps.has(propLowerCase) && !keywords.gridColumnKeywords.has(valueLowerCase)) { return; } if (propLowerCase === 'grid-area' && !keywords.gridAreaKeywords.has(valueLowerCase)) { return; } if ( propLowerCase === 'list-style' && !keywords.listStyleShorthandKeywords.has(valueLowerCase) && !keywords.listStyleTypeKeywords.has(valueLowerCase) ) { return; } if (propLowerCase === 'list-style-type' && !keywords.listStyleTypeKeywords.has(valueLowerCase)) { return; } if (optionsMatches(secondaryOptions, 'ignoreKeywords', keyword)) { return; } if (optionsMatches(secondaryOptions, 'ignoreProperties', prop)) { return; } const keywordLowerCase = keyword.toLocaleLowerCase(); /** @type {string} */ let expectedKeyword; /** @type {boolean} */ const camelCaseSvgKeywords = (secondaryOptions && secondaryOptions.camelCaseSvgKeywords) || false; if ( primary === 'lower' && mapLowercaseKeywordsToCamelCase.has(keywordLowerCase) && camelCaseSvgKeywords ) { expectedKeyword = mapLowercaseKeywordsToCamelCase.get(keywordLowerCase); } else if (primary === 'lower') { expectedKeyword = keyword.toLowerCase(); } else { expectedKeyword = keyword.toUpperCase(); } if (keyword === expectedKeyword) { return; } const index = nodeFieldIndices.declarationValueIndex(decl) + node.sourceIndex; const endIndex = index + keyword.length; const fix = () => { node.value = expectedKeyword; decl.value = parsed.toString(); }; report({ message: messages.expected, messageArgs: [keyword, expectedKeyword], node: decl, index, endIndex, result, ruleName, fix: { apply: fix, node: decl, }, }); }); }); }; }; rule.ruleName = ruleName; rule.messages = messages; rule.meta = meta; module.exports = rule;