minify-css-idents 1.1.0

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,206 @@
+# Minify CSS Identifiers
+
+![CI Tests status](https://github.com/adrien-febvay/minify-css-idents/actions/workflows/ci-tests.yml/badge.svg)
+
+Webpack plug-in using [css-loader](https://www.npmjs.com/package/css-loader) to shorten identifiers and make CSS files lighter.
+
+For maximum efficiency, also use a CSS minifier like [css-minimizer-webpack-plugin/](https://webpack.js.org/plugins/css-minimizer-webpack-plugin/).
+
+## Setup
+
+### Installation
+
+```sh
+npm install --save-dev minify-css-idents
+```
+
+### Webpack configuration
+
+This is the typical configuration that should be compatible all use cases.
+
+Just replace the `css-loader` with `minify-css-idents/css-loader`, ie:
+
+```js
+module.exports = {
+  module: {
+    rules: [
+      {
+        test: /\.css$/,
+        use: [
+          "style-loader",
+          {
+            loader: "minify-css-idents/css-loader",
+            options: {
+              // Your usual css-loader configuration here,
+              // to setup how to build unminified CSS identifiers
+              // consistently accross all build steps
+              modules:  {
+                localIdentContext: 'common-path-for-all-build-steps',
+                localIdentName: '[path]___[name]__[local]',
+              }
+            }
+          },
+          "postcss-loader"
+        ]
+      }
+    ]
+  }
+};
+```
+
+Then add the minifier to the plugins:
+
+```js
+const MinifyCssIdentsPlugin = require("minify-css-idents");
+module.exports = {
+  plugins: [
+    new MinifyCssIdentsPlugin({
+      exclude: ["global-identifiers-here"],
+      inputMap: "path-to-prior/idents-map.json",
+      outputMap: "path-to-new/idents-map.json",
+    })
+  ]
+};
+```
+
+## Options
+
+Available options to specify in the instanciation of `MinifyCssIdentsPlugin`:
+
+```js
+new MinifyCssIdentsPlugin({
+  enabled: true,
+  exclude: ["some-ident", "some-ident-prefix-*"],
+  inputMap: "path-to-prior/idents.map.json",
+  mapIndent: 2,
+  outputMap: "path-to-new/idents.map.json",
+  startIdent: "some-minified-ident-to-start-with",
+});
+```
+
+### options.enabled
+
+Default value: Webpack's [optimization.minimize](https://webpack.js.org/configuration/optimization/#optimizationminimize) option value when set, otherwise `true` when [mode](https://webpack.js.org/configuration/mode/) is set to "production" or omitted and `false` in any other mode.
+
+Enables/disables the minification of CSS identifiers.
+
+### options.exclude
+
+Default value: `["ad*", "app", "root"]`
+
+Identifiers of identifier prefixes the minifier should not generate. You should put there all global identifiers your project uses that could match a minified one.
+
+A global identifier is one that wouldn't get changed by `css-loaded`, either because it is wrapped by `:global()`, or because the CSS is not processed by [css-loader](https://www.npmjs.com/package/css-loader) to begin with (typically the stylesheet of an external module in which classnames are hard-coded).
+
+You may also add there identifiers that may be problematics, like any identifier beginning with "ad".
+
+Also, note that a global identifier/prefix longer than 10 characters, not beginning with a letter or having characters others than letters and digits cannot match a minified identifier. It is then not necessary to specify it in this option and it would be ignored anyway.
+
+### options.inputMap
+
+Default value: `null`
+
+Pathname to the identifier map file of the previous build step, relative to Webpack's context path.
+
+If your project has several build steps, loading the previously emitted map is needed in order to keep the identifiers consistent.
+
+### options.mapIndent
+
+Default value: `2`
+
+The indentation size to use in the identifier map file. Set it to `0` if you want a minimal file without spaces and line returns.
+
+### options.outputMap
+
+Default value: `null`
+
+Pathname to the identifier map file to emit, relative to Webpack's output path.
+
+If your project has several build steps, emitting a map for the next build step is needed in order to keep the identifiers consistent.
+
+### options.startIdent
+
+Default value: `null`
+
+Identifier to start the generation with.
+
+Please note that this identifier will be skipped if it matches a value in the "exclude" option, and ignored if it is not valid.
+
+## Alternative syntax
+
+Should `minify-css-idents/css-loader` not work properly or should your configuration not allow to use it, you may rely on the `MinifyCssIdentsPlugin.getLocalIdent` function, ie:
+
+```js
+const MinifyCssIdentsPlugin = require("minify-css-idents");
+module.exports = {
+  module: {
+    rules: [
+      {
+        test: /\.css$/,
+        use: [
+          "style-loader",
+          {
+            loader: "css-loader",
+            options: {
+              modules: {
+                getLocalIdent: MinifyCssIdentsPlugin.getLocalIdent
+              }
+            }
+          },
+          "postcss-loader"
+        ]
+      }
+    ]
+  }
+};
+```
+
+If you already rely on a custom [getLocalIdent](https://webpack.js.org/loaders/css-loader/#getlocalident) function to generate unminified CSS identifiers, you may specify it:
+
+```js
+  modules: {
+    getLocalIdent: MinifyCssIdentsPlugin.getLocalIdent(your_former_getLocalIdent_here)
+  }
+```
+
+## How the package works and additional notes
+
+### About the loader
+
+The `minify-css-idents/css-loader` wraps [css-loader](https://www.npmjs.com/package/css-loader) in order to override its [getLocalIdent](https://webpack.js.org/loaders/css-loader/#getlocalident) option, which allows to specify a function to generate CSS identifiers.
+
+### About CSS identifiers generation
+
+A minified identifier is a positive integer number representation in base 36 not beginning with a digit. Because of JavaScript's integer limitations (see [Number.MAX_SAFE_INTEGER](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)), they are limited to 10 characters. It matches the regular expression `/^[a-z][0-9a-z]{0,9}$/i`.
+
+In simpler terms, a minified identifier is a letter eventually followed by up to 9 letters and digits.
+
+Before generating a minified identifier, the `MinifyCssIdentsPlugin.getLocalIdent` function generates an unminified one just as [css-loader](https://www.npmjs.com/package/css-loader) would, using the [getLocalIdent](https://webpack.js.org/loaders/css-loader/#getlocalident) function specified in the loader options, or the default one provided with [css-loader](https://www.npmjs.com/package/css-loader).
+
+### About the plugin
+
+When `MinifyCssIdentsPlugin` is registered in Webpack's plug-ins, it has the opportunity to emit and/or load an identifier map file.
+This feature is critical to keep the identifiers consistent across build steps.
+
+It uses the `beforeCompile` hook of Webpack's compiler to load the prior map, then the `compilation` and `afterProcessAssets` hooks to emit the new map.
+
+When `MinifyCssIdentsPlugin` is omitted, it will instanciate automatically with its default options. However, it might not be able to detect the value of Webpack's [optimization.minimize](https://webpack.js.org/configuration/optimization/#optimizationminimize) option in the future, as the way of accessing the compiler's options from a loader is deprecated.
+
+### About the "exclude" option
+
+It does not accept regular expressions for two reasons:
+1. Lack of efficiency: Every generated identifier would be matched with every provided RegExp. By only accepting string identifiers and prefixes, the identifier generator can instead plan in advance for which identifiers it must avoid and do so very efficiently.
+2. Probably useless: Because of the format of minified identifiers, there shouldn't be a lot of exclusions to specify to begin with. Handling regular expressions therefore seems like an overkill.
+
+Such a feature could be developed on request, but at the moment it just seems unecessary.
+
+## Credits
+
+### Author
+
+Adrien Febvay https://github.com/adrien-febvay
+
+### Special thanks
+
+Gajus Kuizinas https://github.com/gajus <br>
+For writing an article about [Reducing CSS bundle size 70% by cutting the class names and using scope isolation](https://medium.com/free-code-camp/reducing-css-bundle-size-70-by-cutting-the-class-names-and-using-scope-isolation-625440de600b).

package/dist/IdentGenerator.d.ts

@@ -0,0 +1,66 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+import { MinifyCssIdentsError } from './MinifyCssIdentsError';
+import { Falsy } from './utils';
+declare class IdentGenerator {
+    readonly options: IdentGenerator.Options.Sanitized;
+    protected readonly excludeRanges: [Range, ...Range[]];
+    protected currExcludeRange: Range;
+    protected currIdentIndex: number;
+    identMap: IdentGenerator.Map;
+    constructor(options?: IdentGenerator.Options | null);
+    get lastIdent(): string;
+    protected addExcludeRange(newRange: Range): void;
+    generateIdent(key: string): string;
+    importMap(map: IdentGenerator.Map): void;
+    loadMap(filename: string, ignoreNoEnt?: boolean): void;
+    protected nextExcludeRange(): Range;
+    stringifyMap(indent?: number): string;
+    static readonly Error: typeof MinifyCssIdentsError;
+    static readonly identRx: RegExp;
+    protected static implicitInstance?: IdentGenerator;
+    static generateIdent(key: string): string;
+    static parseIdent(ident: string): number;
+    static sanitizeExclusions(excludeOption: Falsy<readonly Falsy<string>[]>): string[] | null;
+}
+declare namespace IdentGenerator {
+    type Error = MinifyCssIdentsError;
+    type Map = {
+        [Key in string]?: string;
+    };
+    interface Options {
+        readonly exclude?: Falsy<readonly Falsy<string>[]>;
+        readonly mapIndent?: Falsy<number>;
+        readonly startIdent?: Falsy<string>;
+    }
+    namespace Options {
+        interface Sanitized {
+            readonly exclude: readonly string[];
+            readonly mapIndent: number;
+            readonly startIdent: string | null;
+        }
+    }
+}
+type Range = readonly [startIndex: number, endIndex: number, repeat?: boolean];
+export = IdentGenerator;

package/dist/IdentGenerator.js

@@ -0,0 +1,201 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+"use strict";
+const fs_1 = require("fs");
+const MinifyCssIdentsError_1 = require("./MinifyCssIdentsError");
+const utils_1 = require("./utils");
+const MAX_IDENT_INDEX = 3656158440062975;
+const MAX_REPEATABLE_RANGE_INDEX = 101559956668415;
+const noRange = [Infinity, Infinity];
+class IdentGenerator {
+    constructor(options) {
+        var _a;
+        this.excludeRanges = [[1, 10, true], noRange];
+        this.currExcludeRange = noRange;
+        this.identMap = {};
+        if ((options === null || options === void 0 ? void 0 : options.exclude) && options.exclude.filter((ident) => /^\*|\*./.test(ident || '')).length) {
+            const details = 'The * wildchar can only be used at the end of an identifier';
+            throw new MinifyCssIdentsError_1.MinifyCssIdentsError('Invalid "exclude" option', details);
+        }
+        this.options = Object.freeze({
+            exclude: (_a = IdentGenerator.sanitizeExclusions(options === null || options === void 0 ? void 0 : options.exclude)) !== null && _a !== void 0 ? _a : ['ad*', 'app', 'root'],
+            mapIndent: (options === null || options === void 0 ? void 0 : options.mapIndent) || 2,
+            startIdent: (options === null || options === void 0 ? void 0 : options.startIdent) || null,
+        });
+        this.currIdentIndex = IdentGenerator.parseIdent((options === null || options === void 0 ? void 0 : options.startIdent) || '') - 1 || 0;
+        for (const item of this.options.exclude) {
+            const isPrefix = item.slice(-1) === '*';
+            const ident = isPrefix ? item.slice(0, -1) : item;
+            const startIndex = parseInt(ident, 36);
+            this.addExcludeRange([startIndex, startIndex + 1, isPrefix]);
+        }
+        this.nextExcludeRange();
+        IdentGenerator.implicitInstance = this;
+    }
+    get lastIdent() {
+        return this.currIdentIndex.toString(36);
+    }
+    addExcludeRange(newRange) {
+        const { excludeRanges } = this;
+        const [newStartIndex] = newRange;
+        let rangeIndex = 0;
+        for (const [startIndex] of excludeRanges) {
+            if (newStartIndex < startIndex) {
+                break;
+            }
+            else {
+                rangeIndex += 1;
+            }
+        }
+        excludeRanges.splice(rangeIndex, 0, newRange);
+    }
+    generateIdent(key) {
+        let identIndex = this.currIdentIndex;
+        if (this.identMap[key]) {
+            return this.identMap[key];
+        }
+        else if (identIndex >= MAX_IDENT_INDEX) {
+            return key;
+        }
+        else {
+            identIndex += 1;
+            for (let [start, end] = this.currExcludeRange; identIndex >= start; [start, end] = this.nextExcludeRange()) {
+                identIndex = end > identIndex ? end : identIndex;
+            }
+            this.currIdentIndex = identIndex;
+            return (this.identMap[key] = this.lastIdent);
+        }
+    }
+    importMap(map) {
+        let maxIdent = this.lastIdent;
+        for (const key in map) {
+            const ident = map[key];
+            if (typeof ident === 'string') {
+                if ((ident.length > maxIdent.length || ident > maxIdent) && IdentGenerator.identRx.test(ident)) {
+                    maxIdent = ident;
+                }
+                this.identMap[key] = ident;
+            }
+        }
+        this.currIdentIndex = parseInt(maxIdent, 36);
+    }
+    loadMap(filename, ignoreNoEnt) {
+        const mapBytes = readMap(filename, ignoreNoEnt);
+        if (mapBytes !== null) {
+            this.importMap(parseMap(mapBytes, filename));
+        }
+    }
+    nextExcludeRange() {
+        this.currExcludeRange = this.excludeRanges[0];
+        this.excludeRanges.shift();
+        const [startIndex, endIndex, repeat] = this.currExcludeRange;
+        if (repeat && startIndex < MAX_REPEATABLE_RANGE_INDEX) {
+            this.addExcludeRange([startIndex * 36, endIndex * 36, true]);
+        }
+        return this.currExcludeRange;
+    }
+    stringifyMap(indent = this.options.mapIndent) {
+        return `${JSON.stringify(this.identMap, null, indent)}\n`;
+    }
+    static generateIdent(key) {
+        var _a;
+        (_a = IdentGenerator.implicitInstance) !== null && _a !== void 0 ? _a : (IdentGenerator.implicitInstance = new IdentGenerator());
+        return IdentGenerator.implicitInstance.generateIdent(key);
+    }
+    static parseIdent(ident) {
+        return this.identRx.test(ident) ? parseInt(ident, 36) : NaN;
+    }
+    static sanitizeExclusions(excludeOption) {
+        if (excludeOption) {
+            return excludeOption
+                .filter(utils_1.isTruthy)
+                .filter((ident) => this.identRx.test(ident))
+                .map((ident) => ident.toLowerCase())
+                .sort((a, b) => {
+                const aPrfx = a.slice(-1) === '*';
+                const bPrfx = b.slice(-1) === '*';
+                const aId = aPrfx ? a.slice(0, -1) : a;
+                const bId = bPrfx ? b.slice(0, -1) : b;
+                return aId.length - bId.length || (aId > bId ? 1 : aId < bId ? -1 : Number(bPrfx) - Number(aPrfx));
+            })
+                .filter((ident, index, idents) => {
+                for (const otherIdent of idents.slice(0, index)) {
+                    if (otherIdent.slice(-1) === '*' ? ident.startsWith(otherIdent.slice(0, -1)) : ident === otherIdent) {
+                        return false;
+                    }
+                }
+                return true;
+            });
+        }
+        else {
+            return null;
+        }
+    }
+}
+IdentGenerator.Error = MinifyCssIdentsError_1.MinifyCssIdentsError;
+IdentGenerator.identRx = /^[a-z][^\W_]{0,9}\*?$/i;
+// eslint-disable-next-line @typescript-eslint/unbound-method
+const loadMap = IdentGenerator.prototype.loadMap;
+function parseMap(bytes, filename) {
+    var _a;
+    let data;
+    try {
+        data = JSON.parse(bytes);
+    }
+    catch (cause) {
+        throw new MinifyCssIdentsError_1.MinifyCssIdentsError(`Failure to parse ${filename}`, cause, loadMap);
+    }
+    const causes = [];
+    if (!(0, utils_1.isDictLike)(data)) {
+        causes.push(`Expected string dictionary, got ${(0, utils_1.type)(data)}`);
+    }
+    else {
+        for (const key in data) {
+            if (typeof data[key] !== 'string') {
+                (_a = causes[0]) !== null && _a !== void 0 ? _a : (causes[0] = `Expected string dictionary, but:`);
+                causes.push(`  - Item ${JSON.stringify(key)} is ${(0, utils_1.type)(data[key])}`);
+            }
+        }
+    }
+    if (causes.length) {
+        throw new MinifyCssIdentsError_1.MinifyCssIdentsError(`Invalid CSS identifier map in ${filename}`, causes.join('\n'), loadMap);
+    }
+    else {
+        return data;
+    }
+}
+function readMap(filename, ignoreNoEnt) {
+    try {
+        return (0, fs_1.readFileSync)(filename, 'utf-8');
+    }
+    catch (cause) {
+        if (ignoreNoEnt && (0, utils_1.isError)(cause) && cause.code === 'ENOENT') {
+            return null;
+        }
+        else {
+            throw new MinifyCssIdentsError_1.MinifyCssIdentsError(`Failure to read ${filename}`, cause, loadMap);
+        }
+    }
+}
+module.exports = IdentGenerator;

package/dist/MinifyCssIdentsError.d.ts

@@ -0,0 +1,27 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+export declare class MinifyCssIdentsError extends Error {
+    constructor(message: string, cause?: unknown, capture?: (this: unknown, ...args: any[]) => void);
+    static message(message: string, cause?: unknown): string;
+}

package/dist/MinifyCssIdentsError.js

@@ -0,0 +1,38 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MinifyCssIdentsError = void 0;
+class MinifyCssIdentsError extends Error {
+    constructor(message, cause, capture) {
+        super(MinifyCssIdentsError.message(message, cause));
+        if (capture) {
+            Error.captureStackTrace(this, capture);
+        }
+    }
+    static message(message, cause) {
+        return `${message}\n  ${String(cause).replace(/\n/g, '\n  ')}`;
+    }
+}
+exports.MinifyCssIdentsError = MinifyCssIdentsError;

package/dist/MinifyCssIdentsPlugin.d.ts

@@ -0,0 +1,94 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+import type { Compiler, LoaderContext as LegacyContext, LoaderDefinition } from 'webpack';
+import { Module } from 'webpack';
+import { MinifyCssIdentsError } from './MinifyCssIdentsError';
+import { Falsy } from './utils';
+import IdentGeneratorImport from './IdentGenerator';
+declare class MinifyCssIdentsPlugin extends Module {
+    readonly options: MinifyCssIdentsPlugin.Options.Sanitized;
+    protected readonly identGenerator: IdentGeneratorImport;
+    protected applied: boolean;
+    protected enabled: boolean | null;
+    constructor(options?: MinifyCssIdentsPlugin.Options | null);
+    get cssLoader(): LoaderDefinition;
+    get getLocalIdent(): {
+        (this: unknown, priorGetLocalIdent?: MinifyCssIdentsPlugin.GetLocalIdentFn | undefined): GetLocalIdentFn;
+        (this: unknown, context: MinifyCssIdentsPlugin.LoaderContext, localIdentName: string, localName: string, options: object): string;
+    };
+    apply(compiler: Compiler): void;
+    static readonly Error: typeof MinifyCssIdentsError;
+    static readonly IdentGenerator: typeof IdentGeneratorImport;
+    protected static implicitInstance?: MinifyCssIdentsPlugin;
+    static readonly symbol: unique symbol;
+    static readonly defaultGetLocalIdent: typeof defaultGetLocalIdent;
+    protected static createCssLoader(plugin?: MinifyCssIdentsPlugin): LoaderDefinition;
+    static get cssLoader(): LoaderDefinition;
+    protected static getInstance(context: MinifyCssIdentsPlugin.LoaderContext): MinifyCssIdentsPlugin;
+    static get getLocalIdent(): {
+        (this: unknown, priorGetLocalIdent?: MinifyCssIdentsPlugin.GetLocalIdentFn | undefined): GetLocalIdentFn;
+        (this: unknown, context: MinifyCssIdentsPlugin.LoaderContext, localIdentName: string, localName: string, options: object): string;
+    };
+}
+declare function defaultGetLocalIdent(this: unknown, ...args: Parameters<GetLocalIdentFn>): string;
+declare namespace MinifyCssIdentsPlugin {
+    type Error = MinifyCssIdentsError;
+    interface GetLocalIdentFn {
+        (this: unknown, context: LoaderContext, localIdentName: string, localName: string, options: object): string;
+    }
+    namespace GetLocalIdentFn {
+        interface Extended extends GetLocalIdentFn {
+            (priorGetLocalIdent?: GetLocalIdentFn): GetLocalIdentFn;
+        }
+    }
+    type IdentGenerator = IdentGeneratorImport;
+    namespace IdentGenerator {
+        type Error = IdentGeneratorImport.Error;
+        type Map = IdentGeneratorImport.Map;
+        type Options = IdentGeneratorImport.Options;
+        namespace Options {
+            type Sanitized = IdentGeneratorImport.Options.Sanitized;
+        }
+    }
+    interface LoaderContext extends LegacyContext<NodeJS.Dict<unknown>> {
+        [MinifyCssIdentsPlugin.symbol]?: MinifyCssIdentsPlugin;
+    }
+    interface Options extends IdentGenerator.Options {
+        enabled?: Falsy<boolean>;
+        inputMap?: Falsy<string>;
+        outputMap?: Falsy<string>;
+    }
+    namespace Options {
+        interface Sanitized extends IdentGenerator.Options.Sanitized {
+            enabled: boolean | null;
+            inputMap: string | null;
+            outputMap: string | null;
+        }
+    }
+}
+type GetLocalIdentFn = MinifyCssIdentsPlugin.GetLocalIdentFn;
+declare namespace GetLocalIdentFn {
+    type Extended = MinifyCssIdentsPlugin.GetLocalIdentFn.Extended;
+}
+export = MinifyCssIdentsPlugin;

package/dist/MinifyCssIdentsPlugin.js

@@ -0,0 +1,172 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const css_loader_1 = __importStar(require("css-loader"));
+const path_1 = require("path");
+const webpack_1 = require("webpack");
+const MinifyCssIdentsError_1 = require("./MinifyCssIdentsError");
+const utils_1 = require("./utils");
+const IdentGenerator_1 = __importDefault(require("./IdentGenerator"));
+class MinifyCssIdentsPlugin extends webpack_1.Module {
+    constructor(options) {
+        super('css/minify-ident');
+        this.applied = false;
+        this.identGenerator = new IdentGenerator_1.default(options);
+        this.options = Object.freeze(Object.assign({ enabled: (options === null || options === void 0 ? void 0 : options.enabled) == null ? null : Boolean(options.enabled), inputMap: (options === null || options === void 0 ? void 0 : options.inputMap) || null, outputMap: (options === null || options === void 0 ? void 0 : options.outputMap) || null }, this.identGenerator.options));
+        this.enabled = this.options.enabled;
+        MinifyCssIdentsPlugin.implicitInstance = this;
+    }
+    get cssLoader() {
+        return MinifyCssIdentsPlugin.createCssLoader(this);
+    }
+    get getLocalIdent() {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const plugin = this;
+        let priorGetLocalIdent = defaultGetLocalIdent;
+        function getLocalIdent(...args) {
+            var _a, _b, _c, _d;
+            if (args[0] === void 0 || typeof args[0] === 'function') {
+                priorGetLocalIdent = (_a = args[0]) !== null && _a !== void 0 ? _a : priorGetLocalIdent;
+                return getLocalIdent;
+            }
+            else {
+                const [context, ...otherArgs] = args;
+                (_b = plugin.enabled) !== null && _b !== void 0 ? _b : (plugin.enabled = (_d = (_c = context._compiler) === null || _c === void 0 ? void 0 : _c.options.optimization.minimize) !== null && _d !== void 0 ? _d : context.mode === 'production');
+                const priorLocalIdent = priorGetLocalIdent.call(this, context, ...otherArgs);
+                return plugin.enabled ? plugin.identGenerator.generateIdent(priorLocalIdent) : priorLocalIdent;
+            }
+        }
+        return getLocalIdent;
+    }
+    apply(compiler) {
+        var _a;
+        if (!this.applied) {
+            const { name } = MinifyCssIdentsPlugin;
+            const { outputMap, enabled, inputMap } = this.options;
+            this.enabled = (_a = enabled !== null && enabled !== void 0 ? enabled : compiler.options.optimization.minimize) !== null && _a !== void 0 ? _a : compiler.options.mode === 'production';
+            if (this.enabled && inputMap) {
+                const resolvedSourceMap = (0, path_1.isAbsolute)(inputMap) ? inputMap : (0, path_1.join)(compiler.context, inputMap);
+                compiler.hooks.beforeCompile.tap(name, () => this.identGenerator.loadMap(resolvedSourceMap));
+            }
+            compiler.hooks.compilation.tap(name, (compilation) => {
+                compiler.webpack.NormalModule.getCompilationHooks(compilation).loader.tap(name, (context) => {
+                    context[MinifyCssIdentsPlugin.symbol] = this;
+                });
+                if (this.enabled && outputMap) {
+                    const stage = webpack_1.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE;
+                    compilation.hooks.afterProcessAssets.tap({ stage, name }, () => {
+                        const relativeEmitMap = (0, path_1.isAbsolute)(outputMap) ? (0, path_1.relative)(compiler.outputPath, outputMap) : outputMap;
+                        compilation.emitAsset(relativeEmitMap, new webpack_1.sources.RawSource(this.identGenerator.stringifyMap()));
+                    });
+                }
+            });
+            this.applied = true;
+        }
+    }
+    static createCssLoader(plugin) {
+        let minifyCssIdentsPlugin = plugin;
+        let options;
+        function cssLoader(...args) {
+            const legacyGetOptions = this.getOptions.bind(this);
+            function getOptions(schema = {}) {
+                var _a;
+                if (!options) {
+                    options = legacyGetOptions(schema);
+                    (_a = options.modules) !== null && _a !== void 0 ? _a : (options.modules = {});
+                    if ((0, utils_1.isDictLike)(options.modules)) {
+                        const { getLocalIdent } = options.modules;
+                        minifyCssIdentsPlugin !== null && minifyCssIdentsPlugin !== void 0 ? minifyCssIdentsPlugin : (minifyCssIdentsPlugin = MinifyCssIdentsPlugin.getInstance(this));
+                        options.modules.getLocalIdent = MinifyCssIdentsPlugin.getLocalIdent(getLocalIdent instanceof Function ? getLocalIdent : void 0);
+                    }
+                }
+                return options;
+            }
+            return css_loader_1.default.apply(Object.assign(Object.assign({}, this), { getOptions }), args);
+        }
+        return Object.assign(cssLoader, Object.assign({}, css_loader_1.default));
+    }
+    static get cssLoader() {
+        return MinifyCssIdentsPlugin.createCssLoader();
+    }
+    static getInstance(context) {
+        var _a, _b;
+        return (_b = (_a = context[this.symbol]) !== null && _a !== void 0 ? _a : this.implicitInstance) !== null && _b !== void 0 ? _b : new this();
+    }
+    static get getLocalIdent() {
+        let minifyCssIdentsPlugin;
+        let priorGetLocalIdent = defaultGetLocalIdent;
+        function getLocalIdent(...args) {
+            var _a;
+            if (args[0] === void 0 || typeof args[0] === 'function') {
+                priorGetLocalIdent = (_a = args[0]) !== null && _a !== void 0 ? _a : priorGetLocalIdent;
+                return getLocalIdent;
+            }
+            else {
+                const [context, ...otherArgs] = args;
+                minifyCssIdentsPlugin !== null && minifyCssIdentsPlugin !== void 0 ? minifyCssIdentsPlugin : (minifyCssIdentsPlugin = MinifyCssIdentsPlugin.getInstance(context));
+                return minifyCssIdentsPlugin.getLocalIdent(priorGetLocalIdent).call(this, context, ...otherArgs);
+            }
+        }
+        return getLocalIdent;
+    }
+}
+MinifyCssIdentsPlugin.Error = MinifyCssIdentsError_1.MinifyCssIdentsError;
+MinifyCssIdentsPlugin.IdentGenerator = IdentGenerator_1.default;
+MinifyCssIdentsPlugin.symbol = Symbol(MinifyCssIdentsPlugin.name);
+MinifyCssIdentsPlugin.defaultGetLocalIdent = defaultGetLocalIdent;
+function defaultGetLocalIdent(...args) {
+    const [, , localName] = args;
+    const defaultLocalIdent = css_loader_1.defaultGetLocalIdent.apply(this, args);
+    // For some reason, defaultGetLocalIdent does not get all the job done
+    // and does not replace [local] in the ident template nor escape the resulting ident.
+    const resolvedLocalIdent = defaultLocalIdent.replace(/\[local]/gi, (0, utils_1.escape)(localName));
+    return (0, utils_1.escapeLocalIdent)(resolvedLocalIdent);
+}
+module.exports = MinifyCssIdentsPlugin;

package/dist/css-loader.d.ts

@@ -0,0 +1,25 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+declare const _default: import("webpack").LoaderDefinition;
+export = _default;

package/dist/css-loader.js

@@ -0,0 +1,29 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const MinifyCssIdentsPlugin_1 = __importDefault(require("./MinifyCssIdentsPlugin"));
+module.exports = MinifyCssIdentsPlugin_1.default.cssLoader;

package/dist/utils.d.ts

@@ -0,0 +1,32 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+export declare function escape(str: string): string;
+export declare function escapeLocalIdent(localident: string): string;
+export declare function isDictLike(value: unknown): value is NodeJS.Dict<unknown>;
+export type Falsy<Type = never> = Type | undefined | null | false | 0 | '';
+export declare function isTruthy<Type>(value: Falsy<Type>): value is Type;
+export declare function isError(value: unknown): value is Error & {
+    code: unknown;
+};
+export declare function type(value: unknown): string;

package/dist/utils.js

@@ -0,0 +1,102 @@
+/*! *****************************************************************************
+MIT License
+
+Copyright (c) 2024 Adrien Febvay. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+***************************************************************************** */
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escape = escape;
+exports.escapeLocalIdent = escapeLocalIdent;
+exports.isDictLike = isDictLike;
+exports.isTruthy = isTruthy;
+exports.isError = isError;
+exports.type = type;
+// This function has been extracted from css-loader/dist/utils.js
+const regexSingleEscape = /[ -,./:-@[\]^`{-~]/;
+const regexExcessiveSpaces = /(^|\\+)?(\\[A-F0-9]{1,6})\x20(?![a-fA-F0-9\x20])/g;
+/* istanbul ignore next @preserve */
+function escape(str) {
+    let output = '';
+    for (let counter = 0; counter < str.length; counter += 1) {
+        const character = str.charAt(counter);
+        // eslint-disable-next-line no-control-regex
+        if (/[\t\n\f\r\x0B]/.test(character)) {
+            output += `\\${character.charCodeAt(0).toString(16).toUpperCase()} `;
+        }
+        else if (character === '\\' || regexSingleEscape.test(character)) {
+            output += `\\${character}`;
+        }
+        else {
+            output += character;
+        }
+    }
+    const firstChar = str.charAt(0);
+    if (/^-[-\d]/.test(output)) {
+        output = `\\${output}`;
+    }
+    else if (/\d/.test(firstChar)) {
+        output = `\\3${firstChar} ${output.slice(1)}`;
+    }
+    // Remove spaces after `\HEX` escapes that are not followed by a hex digit,
+    // since they’re redundant. Note that this is only possible if the escape
+    // sequence isn’t preceded by an odd number of backslashes.
+    return output.replace(regexExcessiveSpaces, ($0, $1 = '', $2) => {
+        if ($1.length % 2) {
+            // It’s not safe to remove the space, so don’t.
+            return $0;
+        }
+        else {
+            // Strip the space.
+            return $1 + $2;
+        }
+    });
+}
+// This function has been extracted from css-loader/dist/utils.js
+// eslint-disable-next-line no-control-regex
+const reControlChars = /[\u0000-\u001f\u0080-\u009f]/g;
+const filenameReservedRegex = /[<>:"/\\|?*]/g;
+/* istanbul ignore next @preserve */
+function escapeLocalIdent(localident) {
+    return escape(localident
+        .replace(/^((-?[0-9])|--)/, '_$1')
+        .replace(filenameReservedRegex, '-')
+        .replace(reControlChars, '-')
+        .replace(/\./g, '-'));
+}
+function isDictLike(value) {
+    return value ? typeof value === 'object' : false;
+}
+function isTruthy(value) {
+    return Boolean(value);
+}
+function isError(value) {
+    return value instanceof Error;
+}
+function type(value) {
+    if (value == null) {
+        return String(value);
+    }
+    else {
+        const type = value instanceof Array ? 'array' : typeof value;
+        const article = /[aeiou]/.test(type.slice(0, 1)) ? 'an' : 'a';
+        return `${article} ${type}`;
+    }
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "minify-css-idents",
+  "version": "1.1.0",
+  "description": "Minify CSS identifiers in order to emit smaller CSS files",
+  "author": "Adrien Febvay <adrien.febvay@gmail.com> (https://github.com/adrien-febvay)",
+  "license": "MIT",
+  "scripts": {
+    "eslint": "eslint src/**/*.ts",
+    "eslint-fix": "eslint **/*/*.ts --fix",
+    "test": "jest --coverage --runInBand --verbose",
+    "build": "node bin/build tsconfig.build.json",
+    "preversion": "changelog check && npm test && npm run build",
+    "version": "changelog update && git add CHANGELOG.md"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adrien-febvay/minify-css-idents.git"
+  },
+  "bugs": {
+    "url": "https://github.com/adrien-febvay/minify-css-idents/issues",
+    "email": "adrien.febvay@gmail.com"
+  },
+  "homepage": "https://github.com/adrien-febvay/minify-css-idents#readme",
+  "keywords": [
+    "webpack",
+    "minify",
+    "minimize",
+    "css",
+    "ident",
+    "identifier",
+    "classname",
+    "optimization",
+    "web"
+  ],
+  "files": [
+    "dist/*"
+  ],
+  "exports": {
+    ".": "./dist/MinifyCssIdentsPlugin.js",
+    "./IdentGenerator": "./dist/IdentGenerator.js",
+    "./css-loader": "./dist/css-loader.js"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.8",
+    "@babel/preset-env": "^7.25.8",
+    "@types/jest": "^29.5.13",
+    "@types/node": "^22.5.5",
+    "@typescript-eslint/eslint-plugin": "^8.8.0",
+    "@typescript-eslint/parser": "^8.8.0",
+    "babel-loader": "^9.2.1",
+    "changelog-safeguard": "^1.0.1",
+    "css-loader": "^7.1.2",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.30.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-promise": "^7.1.0",
+    "jest": "^29.7.0",
+    "jest-runner-eslint": "^2.2.0",
+    "mini-css-extract-plugin": "^2.9.1",
+    "postcss-loader": "^8.1.1",
+    "prettier": "^3.3.3",
+    "rimraf": "^6.0.1",
+    "sass": "^1.81.0",
+    "sass-loader": "^16.0.3",
+    "style-loader": "^4.0.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.5.4",
+    "webpack": "^5.95.0",
+    "webpack-cli": "^5.1.4"
+  },
+  "peerDependencies": {
+    "css-loader": ">= 7.0.0",
+    "webpack": ">= 5.0.0"
+  }
+}