html-minifier-next 7.1.0 → 7.3.0

package/dist/types/lib/whitespace.d.ts

@@ -1,7 +1,7 @@
 /** @param {string} str */
-export function trimWhitespace(str: string): string;
+declare const trimWhitespace: (str: string) => string;
 /** @param {string} str */
-export function collapseWhitespaceAll(str: string): string;
+declare function collapseWhitespaceAll(str: string): string;
 /**
  * @param {string} str
  * @param {{preserveLineBreaks?: boolean | undefined, conservativeCollapse?: boolean | undefined}} options
@@ -9,7 +9,7 @@ export function collapseWhitespaceAll(str: string): string;
  * @param {boolean} trimRight
  * @param {boolean} [collapseAll]
  */
-export function collapseWhitespace(str: string, options: {
+declare function collapseWhitespace(str: string, options: {
     preserveLineBreaks?: boolean | undefined;
     conservativeCollapse?: boolean | undefined;
 }, trimLeft: boolean, trimRight: boolean, collapseAll?: boolean): string;
@@ -23,7 +23,7 @@ export function collapseWhitespace(str: string, options: {
  * @param {Set<string>} inlineElements
  * @param {Set<string>} inlineTextSet
  */
-export function collapseWhitespaceSmart(str: string, prevTag: string, nextTag: string, prevAttrs: Array<{
+declare function collapseWhitespaceSmart(str: string, prevTag: string, nextTag: string, prevAttrs: Array<{
     name: string;
     value?: string;
 }>, nextAttrs: Array<{
@@ -35,7 +35,8 @@ export function collapseWhitespaceSmart(str: string, prevTag: string, nextTag: s
     collapseInlineTagWhitespace?: boolean;
 }, inlineElements: Set<string>, inlineTextSet: Set<string>): string;
 /** @param {string} tag */
-export function canCollapseWhitespace(tag: string): boolean;
+declare function canCollapseWhitespace(tag: string): boolean;
 /** @param {string} tag */
-export function canTrimWhitespace(tag: string): boolean;
+declare function canTrimWhitespace(tag: string): boolean;
+export { trimWhitespace, collapseWhitespaceAll, collapseWhitespace, collapseWhitespaceSmart, canCollapseWhitespace, canTrimWhitespace };
 //# sourceMappingURL=whitespace.d.ts.map

package/dist/types/lib/whitespace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whitespace.d.ts","sourceRoot":"","sources":["../../../src/lib/whitespace.js"],"names":[],"mappings":"AAeA,0BAA0B;AAC1B,oCADY,MAAM,UAQjB;AAID,0BAA0B;AAC1B,2CADY,MAAM,UAiBjB;AAID;;;;;;GAMG;AACH,wCANW,MAAM,WACN;IAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAC,YACtF,OAAO,aACP,OAAO,gBACP,OAAO,UAuFjB;AAID;;;;;;;;;GASG;AACH,6CATW,MAAM,WACN,MAAM,WACN,MAAM,aACN,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,CAAC,aACrC,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,CAAC,WACrC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAAC,2BAA2B,CAAC,EAAE,OAAO,CAAA;CAAC,kBACrG,GAAG,CAAC,MAAM,CAAC,iBACX,GAAG,CAAC,MAAM,CAAC,UA0ErB;AAOD,0BAA0B;AAC1B,2CADY,MAAM,WAGjB;AAED,0BAA0B;AAC1B,uCADY,MAAM,WAGjB"}
+{"version":3,"file":"whitespace.d.ts","sourceRoot":"","sources":["../../../src/lib/whitespace.js"],"names":[],"mappings":"AAeA,0BAA0B;AAC1B,QAAA,MAAM,cAAc,QADR,MAAM,WAQjB,CAAC;AAIF,0BAA0B;AAC1B,iBAAS,qBAAqB,CAAC,GAAG,EADtB,MACsB,UAgBjC;AAID;;;;;;GAMG;AACH,iBAAS,kBAAkB,CAAC,GAAG,EANpB,MAMoB,EAAE,OAAO,EAL7B;IAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAKxD,EAAE,QAAQ,EAJvC,OAIuC,EAAE,SAAS,EAHlD,OAGkD,EAAE,WAAW,AAFvE,CAA8B,EAAtB,OAEuE,UAqFjF;AAID;;;;;;;;;GASG;AACH,iBAAS,uBAAuB,CAAC,GAAG,EATzB,MASyB,EAAE,OAAO,EARlC,MAQkC,EAAE,OAAO,EAP3C,MAO2C,EAAE,SAAS,EANtD,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,CAMkB,EAAE,SAAS,EALjE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,CAK6B,EAAE,OAAO,EAJ1E;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAAC,2BAA2B,CAAC,EAAE,OAAO,CAAA;CAI1B,EAAE,cAAc,EAH1F,GAAG,CAAC,MAAM,CAGgF,EAAE,aAAa,EAFzG,GAAG,CAAC,MAAM,CAE+F,UAwEnH;AAOD,0BAA0B;AAC1B,iBAAS,qBAAqB,CAAC,GAAG,EADtB,MACsB,WAEjC;AAED,0BAA0B;AAC1B,iBAAS,iBAAiB,CAAC,GAAG,EADlB,MACkB,WAE7B;AAID,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EAClB,CAAC"}

package/dist/types/presets.d.ts

@@ -1,47 +1,49 @@
+/**
+ * Preset configurations
+ *
+ * Presets provide curated option sets for common use cases:
+ * - `conservative`: Safe minification suitable for most projects
+ * - `comprehensive`: Aggressive minification for maximum file size reduction
+ */
+export declare const presets: {
+    conservative: {
+        caseSensitive: boolean;
+        collapseBooleanAttributes: boolean;
+        collapseWhitespace: boolean;
+        conservativeCollapse: boolean;
+        preserveLineBreaks: boolean;
+        removeComments: boolean;
+        removeDefaultTypeAttributes: boolean;
+        useShortDoctype: boolean;
+    };
+    comprehensive: {
+        collapseAttributeWhitespace: boolean;
+        collapseBooleanAttributes: boolean;
+        collapseWhitespace: boolean;
+        decodeEntities: boolean;
+        mergeScripts: boolean;
+        minifyCSS: boolean;
+        minifyJS: boolean;
+        minifySVG: boolean;
+        minifyURLs: boolean;
+        removeAttributeQuotes: boolean;
+        removeComments: boolean;
+        removeDefaultTypeAttributes: boolean;
+        removeEmptyAttributes: boolean;
+        removeOptionalTags: boolean;
+        removeRedundantAttributes: boolean;
+        useShortDoctype: boolean;
+    };
+};
 /**
  * Get preset configuration by name
  * @param {string} name - Preset name (“conservative” or “comprehensive”)
  * @returns {object|null} Preset options object or null if not found
  */
-export function getPreset(name: string): object | null;
+export declare function getPreset(name: string): object | null;
 /**
  * Get list of available preset names
  * @returns {string[]} Array of preset names
  */
-export function getPresetNames(): string[];
-export namespace presets {
-    namespace conservative {
-        let caseSensitive: boolean;
-        let collapseBooleanAttributes: boolean;
-        let collapseWhitespace: boolean;
-        let conservativeCollapse: boolean;
-        let preserveLineBreaks: boolean;
-        let removeComments: boolean;
-        let removeDefaultTypeAttributes: boolean;
-        let useShortDoctype: boolean;
-    }
-    namespace comprehensive {
-        export let collapseAttributeWhitespace: boolean;
-        let collapseBooleanAttributes_1: boolean;
-        export { collapseBooleanAttributes_1 as collapseBooleanAttributes };
-        let collapseWhitespace_1: boolean;
-        export { collapseWhitespace_1 as collapseWhitespace };
-        export let decodeEntities: boolean;
-        export let mergeScripts: boolean;
-        export let minifyCSS: boolean;
-        export let minifyJS: boolean;
-        export let minifySVG: boolean;
-        export let minifyURLs: boolean;
-        export let removeAttributeQuotes: boolean;
-        let removeComments_1: boolean;
-        export { removeComments_1 as removeComments };
-        let removeDefaultTypeAttributes_1: boolean;
-        export { removeDefaultTypeAttributes_1 as removeDefaultTypeAttributes };
-        export let removeEmptyAttributes: boolean;
-        export let removeOptionalTags: boolean;
-        export let removeRedundantAttributes: boolean;
-        let useShortDoctype_1: boolean;
-        export { useShortDoctype_1 as useShortDoctype };
-    }
-}
+export declare function getPresetNames(): string[];
 //# sourceMappingURL=presets.d.ts.map

package/dist/types/presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/presets.js"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,gCAHW,MAAM,GACJ,MAAM,GAAC,IAAI,CAMvB;AAED;;;GAGG;AACH,kCAFa,MAAM,EAAE,CAIpB"}
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/presets.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,OAAO;IAClB,YAAY;QACV,aAAa;QACb,yBAAyB;QACzB,kBAAkB;QAClB,oBAAoB;QACpB,kBAAkB;QAClB,cAAc;QACd,2BAA2B;QAC3B,eAAe;;IAEjB,aAAa;QACX,2BAA2B;QAC3B,yBAAyB;QACzB,kBAAkB;QAClB,cAAc;QACd,YAAY;QACZ,SAAS;QACT,QAAQ;QACR,SAAS;QACT,UAAU;QACV,qBAAqB;QACrB,cAAc;QACd,2BAA2B;QAC3B,qBAAqB;QACrB,kBAAkB;QAClB,yBAAyB;QACzB,eAAe;;CAElB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAHnB,MAGmB,GAFjB,MAAM,GAAC,IAAI,CAMvB;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAFjB,MAAM,EAAE,CAIpB"}

package/dist/types/tokenchain.d.ts

@@ -1,19 +1,9 @@
-export default TokenChain;
-declare class TokenChain {
-    /** @type {Map<string, {arrays: string[][], processed: number}>} */
-    map: Map<string, {
-        arrays: string[][];
-        processed: number;
-    }>;
-    /** @param {string[]} tokens */
-    add(tokens: string[]): void;
-    createSorter(): Sorter;
-}
 declare class Sorter {
     /** @type {string[]} */
     keys: string[];
     /** @type {Map<string, Sorter>} */
     sorterMap: Map<string, Sorter>;
+    constructor();
     /**
      * @param {string[]} tokens
      * @param {number} fromIndex
@@ -21,4 +11,16 @@ declare class Sorter {
      */
     sort(tokens: string[], fromIndex?: number): string[];
 }
+declare class TokenChain {
+    /** @type {Map<string, {arrays: string[][], processed: number}>} */
+    map: Map<string, {
+        arrays: string[][];
+        processed: number;
+    }>;
+    constructor();
+    /** @param {string[]} tokens */
+    add(tokens: string[]): void;
+    createSorter(): Sorter;
+}
+export default TokenChain;
 //# sourceMappingURL=tokenchain.d.ts.map

package/dist/types/tokenchain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenchain.d.ts","sourceRoot":"","sources":["../../src/tokenchain.js"],"names":[],"mappings":";AA+CA;IAEI,mEAAmE;IACnE,KADW,GAAG,CAAC,MAAM,EAAE;QAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC,CAC3C;IAGtB,+BAA+B;IAC/B,YADY,MAAM,EAAE,QAUnB;IAED,uBA+CC;CACF;AAjHD;IAEI,uBAAuB;IACvB,MADW,MAAM,EAAE,CACL;IACd,kCAAkC;IAClC,WADW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CACJ;IAG5B;;;;OAIG;IACH,aAJW,MAAM,EAAE,cACR,MAAM,GACJ,MAAM,EAAE,CAiCpB;CACF"}
+{"version":3,"file":"tokenchain.d.ts","sourceRoot":"","sources":["../../src/tokenchain.js"],"names":[],"mappings":"AAAA,cAAM,MAAM;IAER,uBAAuB;IAClB,IAAI,EADE,MAAM,EAAE;IAEnB,kCAAkC;IAC7B,SAAS,EADH,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAHhC,cAKC;IAED;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAJA,MAAM,EAIN,EAAE,SAAS,GAHX,MAGe,GAFb,MAAM,EAAE,CAiCpB;CACF;AAED,cAAM,UAAU;IAEZ,mEAAmE;IAC9D,GAAG,EADG,GAAG,CAAC,MAAM,EAAE;QAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;IADjE,cAGC;IAED,+BAA+B;IAC/B,GAAG,CAAC,MAAM,EADE,MAAM,EACR,QAST;IAED,YAAY,WA+CX;CACF;eAEc,UAAU"}

package/html-minifier-next.schema.json

@@ -0,0 +1,303 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/j9t/html-minifier-next/main/html-minifier-next.schema.json",
+  "title": "HTML Minifier Next configuration",
+  "description": "Configuration file for HTML Minifier Next (HMN), used via `--config-file`",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "description": "JSON Schema reference for this configuration file (enables editor validation and autocomplete)",
+      "type": "string"
+    },
+    "preset": {
+      "description": "Preset configuration to start from—config file options override preset options",
+      "enum": [
+        "conservative",
+        "comprehensive"
+      ]
+    },
+    "fileExt": {
+      "description": "File extension(s) to process, as comma-separated string or array (default: `html,htm,shtml,shtm`; use `*` for all files)",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "ignoreDir": {
+      "description": "Directories—relative to the input directory—to exclude from processing, as comma-separated string or array",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "cacheCSS": {
+      "description": "Set CSS minification cache size (number of entries, default: 500)",
+      "type": "integer",
+      "minimum": 0
+    },
+    "cacheJS": {
+      "description": "Set JavaScript minification cache size (number of entries, default: 500)",
+      "type": "integer",
+      "minimum": 0
+    },
+    "cacheSVG": {
+      "description": "Set SVG minification cache size (number of entries, default: 500)",
+      "type": "integer",
+      "minimum": 0
+    },
+    "caseSensitive": {
+      "description": "Treat attributes in case-sensitive manner (useful for custom HTML elements)",
+      "type": "boolean"
+    },
+    "collapseAttributeWhitespace": {
+      "description": "Trim and collapse whitespace characters within attribute values",
+      "type": "boolean"
+    },
+    "collapseBooleanAttributes": {
+      "description": "Omit attribute values from boolean attributes",
+      "type": "boolean"
+    },
+    "collapseInlineTagWhitespace": {
+      "description": "Collapse whitespace more aggressively between inline elements—use with `--collapse-whitespace`",
+      "type": "boolean"
+    },
+    "collapseWhitespace": {
+      "description": "Collapse whitespace that contributes to text nodes in a document tree",
+      "type": "boolean"
+    },
+    "conservativeCollapse": {
+      "description": "Always collapse to one space (never remove it entirely)—use with `--collapse-whitespace`",
+      "type": "boolean"
+    },
+    "continueOnMinifyError": {
+      "description": "Continue on minification errors",
+      "type": "boolean"
+    },
+    "continueOnParseError": {
+      "description": "Handle parse errors instead of aborting",
+      "type": "boolean"
+    },
+    "customAttrAssign": {
+      "description": "Array of regexes that allow to support custom attribute assign expressions (e.g., `<div flex?=\"{{mode != cover}}\"></div>`)",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "customAttrCollapse": {
+      "description": "Regex that specifies custom attribute to strip newlines from (e.g., `/ng-class/`)",
+      "type": "string"
+    },
+    "customAttrSurround": {
+      "description": "Array of regexes that allow to support custom attribute surround expressions (e.g., `<input {{#if value}}checked=\"checked\"{{/if}}>`)",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "customEventAttributes": {
+      "description": "Array of regexes that allow to support custom event attributes for minifyJS (e.g., `ng-click`)",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "customFragmentQuantifierLimit": {
+      "description": "Set maximum quantifier limit for custom fragments to prevent ReDoS attacks (default: 200)",
+      "type": "integer",
+      "minimum": 0
+    },
+    "decodeEntities": {
+      "description": "Use direct Unicode characters whenever possible",
+      "type": "boolean"
+    },
+    "ignoreCustomComments": {
+      "description": "Array of regexes that allow to ignore matching comments",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "ignoreCustomFragments": {
+      "description": "Array of regexes that allow to ignore certain fragments, when matched (e.g., `<?php … ?>`, `{{ … }}`)",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "includeAutoGeneratedTags": {
+      "description": "Insert elements generated by HTML parser",
+      "type": "boolean"
+    },
+    "inlineCustomElements": {
+      "description": "Array of names of custom elements which are inline, for whitespace handling",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "keepClosingSlash": {
+      "description": "Keep the trailing slash on void elements",
+      "type": "boolean"
+    },
+    "maxInputLength": {
+      "description": "Maximum input length to prevent ReDoS attacks",
+      "type": "integer",
+      "minimum": 0
+    },
+    "maxLineLength": {
+      "description": "Specify a maximum line length; compressed output will be split by newlines at valid HTML split-points",
+      "type": "integer",
+      "minimum": 0
+    },
+    "mergeScripts": {
+      "description": "Merge consecutive inline `script` elements into one",
+      "type": "boolean"
+    },
+    "minifyCSS": {
+      "description": "Minify CSS in `style` elements and attributes (uses Lightning CSS)",
+      "type": [
+        "boolean",
+        "string",
+        "object"
+      ]
+    },
+    "minifyJS": {
+      "description": "Minify JavaScript in `script` elements and event attributes (uses Terser or SWC; pass `{\"engine\": \"swc\"}` for SWC)",
+      "type": [
+        "boolean",
+        "string",
+        "object"
+      ]
+    },
+    "minifySVG": {
+      "description": "Minify SVG elements (uses SVGO)",
+      "type": [
+        "boolean",
+        "string",
+        "object"
+      ]
+    },
+    "minifyURLs": {
+      "description": "Minify URLs in various attributes",
+      "type": [
+        "boolean",
+        "string",
+        "object"
+      ]
+    },
+    "noNewlinesBeforeTagClose": {
+      "description": "Never add a newline before a tag that closes an element",
+      "type": "boolean"
+    },
+    "partialMarkup": {
+      "description": "Treat input as a partial HTML fragment, preserving stray end tags and unclosed tags",
+      "type": "boolean"
+    },
+    "preserveLineBreaks": {
+      "description": "Always collapse to one line break (never remove it entirely) when whitespace between tags includes a line break—use with `--collapse-whitespace`",
+      "type": "boolean"
+    },
+    "preventAttributesEscaping": {
+      "description": "Prevents the escaping of the values of attributes",
+      "type": "boolean"
+    },
+    "processScripts": {
+      "description": "Array of strings corresponding to types of `script` elements to process through minifier (e.g., `text/ng-template`, `text/x-handlebars-template`, etc.)",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "quoteCharacter": {
+      "description": "Type of quote to use for attribute values (`'` or `\"`)",
+      "type": "string"
+    },
+    "removeAttributeQuotes": {
+      "description": "Remove quotes around attributes when possible",
+      "type": "boolean"
+    },
+    "removeComments": {
+      "description": "Strip HTML comments",
+      "type": "boolean"
+    },
+    "removeDefaultTypeAttributes": {
+      "description": "Remove default `type` attributes from `style`/`link` (e.g., `type=\"text/css\"`) and `script` (e.g., `type=\"text/javascript\"`) elements; other `type` attribute values are left intact",
+      "type": "boolean"
+    },
+    "removeEmptyAttributes": {
+      "description": "Remove all attributes with whitespace-only values",
+      "type": "boolean"
+    },
+    "removeEmptyElements": {
+      "description": "Remove all elements with empty contents",
+      "type": "boolean"
+    },
+    "removeEmptyElementsExcept": {
+      "description": "Array of elements to preserve when `--remove-empty-elements` is enabled (e.g., `td`, `<span aria-hidden=\"true\">`)",
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string"
+      }
+    },
+    "removeOptionalTags": {
+      "description": "Remove optional tags",
+      "type": "boolean"
+    },
+    "removeRedundantAttributes": {
+      "description": "Remove attributes when value matches default",
+      "type": "boolean"
+    },
+    "removeTagWhitespace": {
+      "description": "Remove space between attributes whenever possible; note that this will result in invalid HTML",
+      "type": "boolean"
+    },
+    "sortAttributes": {
+      "description": "Sort attributes by frequency",
+      "type": "boolean"
+    },
+    "sortClassNames": {
+      "description": "Sort style classes by frequency",
+      "type": "boolean"
+    },
+    "trimCustomFragments": {
+      "description": "Trim whitespace around custom fragments (`--ignore-custom-fragments`)",
+      "type": "boolean"
+    },
+    "useShortDoctype": {
+      "description": "Replaces the doctype with the short HTML doctype",
+      "type": "boolean"
+    }
+  },
+  "additionalProperties": false
+}

package/package.json

@@ -17,9 +17,9 @@
     "@commitlint/cli": "^21.2.0",
     "@eslint/js": "^10.0.1",
     "@swc/core": "^1.15.41",
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.1.1",
     "eslint": "^10.6.0",
-    "typescript": "^6.0.3",
+    "typescript": "^7.0.2",
     "vite": "^8.0.16"
   },
   "engines": {
@@ -34,8 +34,9 @@
   },
   "files": [
     "cli.js",
-    "dist/types/",
-    "src/"
+    "dist/types",
+    "html-minifier-next.schema.json",
+    "src"
   ],
   "funding": "https://github.com/j9t/html-minifier-next?sponsor=1",
   "homepage": "https://j9t.github.io/html-minifier-next/",
@@ -78,8 +79,9 @@
     "url": "git+https://github.com/j9t/html-minifier-next.git"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && npm run build:schema",
     "build:docs": "vite build --base /html-minifier-next/",
+    "build:schema": "node scripts/build-schema.js",
     "deploy": "npm run build && npm run build:docs",
     "lint": "eslint .",
     "prebuild": "node --input-type=module --eval \"import {rmSync} from 'fs';rmSync('dist',{recursive:true,force:true})\"",
@@ -91,5 +93,5 @@
     "test:watch": "node --test --watch tests/*.spec.js"
   },
   "type": "module",
-  "version": "7.1.0"
+  "version": "7.3.0"
 }

package/src/htmlminifier.js

@@ -529,6 +529,22 @@ let jsMinifyCache = null;
 /** @type {LRU | null} */
 let svgMinifyCache = null;
 
+/**
+ * @typedef {Object} CacheStats
+ *  Hit/miss statistics and current occupancy for a single minification cache.
+ *
+ * @prop {number} gets Number of lookups attempted against the cache.
+ * @prop {number} hits Number of lookups that found a cached entry.
+ * @prop {number} size Number of entries currently held in the cache.
+ * @prop {number} limit Maximum number of entries the cache can hold.
+ */
+
+/**
+ * @param {LRU | null} cache
+ * @returns {CacheStats}
+ */
+const cacheStatsOrEmpty = (cache) => cache ? cache.stats() : { gets: 0, hits: 0, size: 0, limit: 0 };
+
 // Pre-compiled patterns for script merging (avoid repeated allocation in hot path)
 const RE_SCRIPT_ATTRS = /([^\s=]+)(?:=(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g;
 const RE_SCRIPT_OPEN = /<script(?=[\s>])/gi; // Finds tag start; use `findTagEnd()` for the actual closing `>`
@@ -1893,6 +1909,23 @@ function initCaches(options) {
   return { cssMinifyCache, jsMinifyCache, svgMinifyCache };
 }
 
+/**
+ * Get hit/miss statistics for the CSS, JavaScript, and SVG minification caches.
+ *
+ * Each cache is created lazily on the first `minify()` call (see `initCaches`); before
+ * that first call, or for a cache never exercised (e.g., `minifyCSS` disabled), its
+ * entry reports all-zero stats.
+ *
+ * @returns {{ css: CacheStats, js: CacheStats, svg: CacheStats }}
+ */
+export function getCacheStats() {
+  return {
+    css: cacheStatsOrEmpty(cssMinifyCache),
+    js: cacheStatsOrEmpty(jsMinifyCache),
+    svg: cacheStatsOrEmpty(svgMinifyCache)
+  };
+}
+
 /**
  * @param {string} value
  * @param {MinifierOptions} [options]
@@ -1926,4 +1959,4 @@ export const minify = async function (value, options) {
 
 export { presets, getPreset, getPresetNames };
 
-export default { minify, presets, getPreset, getPresetNames };
+export default { minify, presets, getPreset, getPresetNames, getCacheStats };

package/src/lib/option-definitions.js

@@ -1,6 +1,18 @@
 // Single source of truth for minifier option names, descriptions, types, and shared defaults
 
 const optionDefinitions = {
+  cacheCSS: {
+    description: 'Set CSS minification cache size (number of entries, default: 500)',
+    type: 'int'
+  },
+  cacheJS: {
+    description: 'Set JavaScript minification cache size (number of entries, default: 500)',
+    type: 'int'
+  },
+  cacheSVG: {
+    description: 'Set SVG minification cache size (number of entries, default: 500)',
+    type: 'int'
+  },
   caseSensitive: {
     description: 'Treat attributes in case-sensitive manner (useful for custom HTML elements)',
     type: 'boolean'