postcss-unique-selectors/src/index.js

Ensure CSS selectors are unique.

import selectorParser from 'postcss-selector-parser';

/**
 * @param {string} selectors
 * @return {string}
 */
function generateUniqueSelector(selectors) {
  // No comma means a single selector; nothing to dedupe or sort.
  if (!selectors.includes(',')) {
    return selectors;
  }
  /** @type {Map<string, string>} */
  const uniqueSelectors = new Map();
  // Without comments the node's own toString is already a usable key.
  const hasComments = selectors.includes('/*');

  /** @type {selectorParser.SyncProcessor<void>} */
  const collectUniqueSelectors = (selNode) => {
    for (const node of selNode.nodes) {
      if (!hasComments) {
        const text = node.toString();
        const key = text.trim();
        if (!uniqueSelectors.has(key)) {
          uniqueSelectors.set(key, text);
        }
        continue;
      }

      /** @type {string[]} */
      const comments = [];
      // Duplicates are removed by stripping the comments and using the results as the Map key.
      const keyNode = node.clone();
      keyNode.walk((sel) => {
        if (sel.type === 'comment') {
          comments.push(sel.value);
          sel.remove();
        }
      });
      const key = keyNode.toString().trim();

      const dupeSelector = uniqueSelectors.get(key);
      if (!dupeSelector) {
        uniqueSelectors.set(key, node.toString());
      } else if (comments.length) {
        // If the duplicate selector has a comment, it is concatenated to the end of the selector.
        uniqueSelectors.set(key, `${dupeSelector}${comments.join('')}`);
      }
    }
  };

  selectorParser(collectUniqueSelectors).processSync(selectors);

  return [...uniqueSelectors.entries()]
    .toSorted(([a], [b]) => {
      if (a > b) {
        return 1;
      } else {
        return a < b ? -1 : 0;
      }
    })
    .map(([, selector]) => selector)
    .join();
}
/**
 * @return {import('postcss').Plugin}
 */
function pluginCreator() {
  return {
    postcssPlugin: 'postcss-unique-selectors',
    /**
     * @param {import('postcss').Root} css
     */
    OnceExit(css) {
      css.walkRules((nodes) => {
        if (nodes.raws.selector && nodes.raws.selector.raw) {
          nodes.raws.selector.raw = generateUniqueSelector(
            nodes.raws.selector.raw
          );
        } else {
          nodes.selector = generateUniqueSelector(nodes.selector);
        }
      });
    },
  };
}
/** @type {true} */
pluginCreator.postcss = true;
const moduleExports = pluginCreator;

export { moduleExports as default, moduleExports as 'module.exports' };