documentation/node_modules/postcss-zindex/src/index.js

'use strict';
const LayerCache = require('./lib/layerCache');

/** @typedef {{startIndex?: number}} Options */
/**
 * @type {import('postcss').PluginCreator<Options>}
 * @param {Options} opts
 * @return {import('postcss').Plugin}
 */
function pluginCreator(opts = {}) {
  return {
    postcssPlugin: 'postcss-zindex',
    prepare() {
      const cache = new LayerCache();
      return {
        OnceExit(css) {
          /** @type {import('postcss').Declaration[]} */
          const nodes = [];
          let abort = false;

          // First pass; cache all z indexes
          css.walkDecls(/z-index/i, (decl) => {
            // Check that no negative values exist. Rebasing is only
            // safe if all indices are positive numbers.
            if (decl.value[0] === '-') {
              abort = true;
              // Stop PostCSS iterating through the rest of the decls
              return false;
            }
            nodes.push(decl);
            cache.addValue(decl.value);
          });

          // Abort if we found any negative values
          // or there are no z-index declarations
          if (abort || !nodes.length) {
            return;
          }

          cache.optimizeValues(opts.startIndex || 1);

          // Second pass; optimize
          nodes.forEach((decl) => {
            // Need to coerce to string so that the
            // AST is updated correctly
            decl.value = cache.getValue(decl.value).toString();
          });
        },
      };
    },
  };
}

pluginCreator.postcss = true;
module.exports = pluginCreator;