'use strict'; const hasBlock = require('../../utils/hasBlock'); const optionsMatches = require('../../utils/optionsMatches'); const report = require('../../utils/report'); const ruleMessages = require('../../utils/ruleMessages'); const { isAtRule } = require('../../utils/typeGuards'); const validateOptions = require('../../utils/validateOptions'); const ruleName = 'declaration-block-trailing-semicolon'; const messages = ruleMessages(ruleName, { expected: 'Expected a trailing semicolon', rejected: 'Unexpected trailing semicolon', }); const meta = { url: 'https://stylelint.io/user-guide/rules/declaration-block-trailing-semicolon', fixable: true, deprecated: true, }; /** @type {import('stylelint').Rule} */ const rule = (primary, secondaryOptions, context) => { return (root, result) => { const validOptions = validateOptions( result, ruleName, { actual: primary, possible: ['always', 'never'], }, { actual: secondaryOptions, possible: { ignore: ['single-declaration'], }, optional: true, }, ); if (!validOptions) { return; } root.walkAtRules((atRule) => { if (!atRule.parent) throw new Error('A parent node must be present'); if (atRule.parent === root) { return; } if (atRule !== atRule.parent.last) { return; } if (hasBlock(atRule)) { return; } checkLastNode(atRule); }); root.walkDecls((decl) => { if (!decl.parent) throw new Error('A parent node must be present'); if (decl.parent.type === 'object') { return; } if (decl !== decl.parent.last) { return; } checkLastNode(decl); }); /** * @param {import('postcss').Node} node */ function checkLastNode(node) { if (!node.parent) throw new Error('A parent node must be present'); const hasSemicolon = node.parent.raws.semicolon; const ignoreSingleDeclaration = optionsMatches( secondaryOptions, 'ignore', 'single-declaration', ); if (ignoreSingleDeclaration && node.parent.first === node) { return; } let message; if (primary === 'always') { if (hasSemicolon) { return; } // auto-fix if (context.fix) { node.parent.raws.semicolon = true; if (isAtRule(node)) { node.raws.between = ''; node.parent.raws.after = ' '; } return; } message = messages.expected; } else if (primary === 'never') { if (!hasSemicolon) { return; } // auto-fix if (context.fix) { node.parent.raws.semicolon = false; return; } message = messages.rejected; } else { throw new Error(`Unexpected primary option: "${primary}"`); } report({ message, node, index: node.toString().trim().length - 1, result, ruleName, }); } }; }; rule.ruleName = ruleName; rule.messages = messages; rule.meta = meta; module.exports = rule;