html-minifier-next 7.2.0 → 7.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qCAHW,OAAO,GACL,MAAM,CAYlB;AAID;IACE,4BAIC;IAHC,cAAkB;IAClB,mCAAmC;IACnC,KADW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CACX;IAEtB,0BAA0B;IAC1B,SADY,MAAM,WASjB;IACD;;;OAGG;IACH,SAHW,MAAM,SACN,OAAO,QASjB;IACD,0BAA0B;IAC1B,YADY,MAAM,QACmB;CACtC;AAID,0BAA0B;AAC1B,iCADY,MAAM,UAQjB;AAID,4BAA4B;AAC5B,gCADY,MAAM,UAOjB;AAID,4BAA4B;AAC5B,gCADY,MAAM,UAGjB;AAED;;;GAGG;AACH,kCAHW,OAAO,GACL,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,CAIrC;AAED,4BAA4B;AAC5B,iCADY,MAAM,UAGjB;AAID;;;;;;GAMG;AACH,kCALW,MAAM,SACN,MAAM,sBAEJ,OAAO,CAAC,MAAM,CAAC,CAc3B;AAID,qCAAqC;AACrC,mCADY,MAAM,GAAG,MAAM,sBAW1B"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,iBAAS,eAAe,CAAC,GAAG,EAHjB,OAGiB,GAFf,MAAM,CAYlB;AAID,cAAM,GAAG;IAEA,KAAK;IACL,IAAI;IACJ,IAAI;IACT,mCAAmC;IAC9B,GAAG,EADG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAJjC,YAAY,KAAK,SAAM,EAMtB;IACD,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EADK,MACL,WAUN;IACD;;;OAGG;IACH,GAAG,CAAC,GAAG,EAHI,MAGJ,EAAE,KAAK,EAFH,OAEG,QAOb;IACD,0BAA0B;IAC1B,MAAM,CAAC,GAAG,EADE,MACF,QAA2B;IACrC,6EAA6E;IAC7E,KAAK,IADS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAGxE;CACF;AAKD,QAAA,MAAM,oBAAoB,QAAc,CAAC;AAIzC,0BAA0B;AAC1B,iBAAS,WAAW,CAAC,GAAG,EADZ,MACY,UAOvB;AAID,4BAA4B;AAC5B,iBAAS,QAAQ,CAAC,KAAK,EADX,MACW,UAMtB;AAID,4BAA4B;AAC5B,iBAAS,QAAQ,CAAC,KAAK,EADX,MACW,UAEtB;AAED;;;GAGG;AACH,iBAAS,UAAU,CAAC,KAAK,EAHd,OAGc,GAFZ,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,CAIrC;AAED,4BAA4B;AAC5B,iBAAS,SAAS,CAAC,KAAK,EADZ,MACY,UAEvB;AAID;;;;;;GAMG;AACH,iBAAe,YAAY,CAAC,GAAG,EALpB,MAKoB,EAAE,KAAK,EAJ3B,MAI2B,EAAE,OAAO,UAAA,GAFlC,OAAO,CAAC,MAAM,CAAC,CAc3B;AAID,qCAAqC;AACrC,iBAAS,WAAW,CAAC,KAAK,EADd,MAAM,GAAG,MACK,sBAUzB;AAID,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAE,GAAG,EAAE,CAAC;AACf,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,CAAC"}

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/package.json

@@ -9,21 +9,21 @@
     "commander": "^15.0.0",
     "entities": "^8.0.0",
     "lightningcss": "^1.32.0",
-    "svgo": "^4.0.1",
-    "terser": "^5.47.1"
+    "svgo": "^4.0.2",
+    "terser": "^5.49.0"
   },
   "description": "Super-configurable and well-tested web page minifier (enhanced successor to HTML Minifier)",
   "devDependencies": {
-    "@commitlint/cli": "^21.2.0",
+    "@commitlint/cli": "^21.2.1",
     "@eslint/js": "^10.0.1",
-    "@swc/core": "^1.15.41",
-    "@types/node": "^26.1.0",
-    "eslint": "^10.6.0",
-    "typescript": "^6.0.3",
-    "vite": "^8.0.16"
+    "@swc/core": "^1.15.43",
+    "@types/node": "^26.1.1",
+    "eslint": "^10.7.0",
+    "typescript": "^7.0.2",
+    "vite": "^8.1.5"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=22.13"
   },
   "exports": {
     ".": {
@@ -34,9 +34,9 @@
   },
   "files": [
     "cli.js",
+    "dist/types",
     "html-minifier-next.schema.json",
-    "dist/types/",
-    "src/"
+    "src"
   ],
   "funding": "https://github.com/j9t/html-minifier-next?sponsor=1",
   "homepage": "https://j9t.github.io/html-minifier-next/",
@@ -93,5 +93,5 @@
     "test:watch": "node --test --watch tests/*.spec.js"
   },
   "type": "module",
-  "version": "7.2.0"
+  "version": "7.4.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/options.js

@@ -1,5 +1,5 @@
 import { createUrlMinifier } from './urls.js';
-import { LRU, stableStringify, hashContent, identity, lowercase, replaceAsync, parseRegExp } from './utils.js';
+import { LRU, MAX_CACHE_ENTRY_SIZE, stableStringify, hashContent, identity, lowercase, replaceAsync, parseRegExp } from './utils.js';
 import { RE_TRAILING_SEMICOLON } from './constants.js';
 import { canCollapseWhitespace, canTrimWhitespace } from './whitespace.js';
 import { wrapCSS, unwrapCSS } from './content.js';
@@ -183,15 +183,20 @@ const processOptions = (inputOptions, { getLightningCSS, getTerser, getSwc, getS
         // Cache key: Content + type + options signature; large inputs are hashed to avoid huge Map keys
         const inputCSS = wrapCSS(text, type);
         const cssSig = stableStringify({ type, opts: lightningCssOptions, cont: !!options.continueOnMinifyError });
-        const cssKey = inputCSS.length > 2048
-          ? (hashContent(inputCSS) + '|' + type + '|' + cssSig)
-          : (inputCSS + '|' + type + '|' + cssSig);
+        const isCacheable = inputCSS.length <= MAX_CACHE_ENTRY_SIZE;
+        const cssKey = isCacheable
+          ? (inputCSS.length > 2048
+            ? (hashContent(inputCSS) + '|' + type + '|' + cssSig)
+            : (inputCSS + '|' + type + '|' + cssSig))
+          : undefined;
 
         try {
-          const cached = /** @type {string | Promise<string> | undefined} */ (cssCache.get(cssKey));
-          if (cached !== undefined) {
-            // Support both resolved values and in-flight promises
-            return await cached;
+          if (cssKey !== undefined) {
+            const cached = /** @type {string | Promise<string> | undefined} */ (cssCache.get(cssKey));
+            if (cached !== undefined) {
+              // Support both resolved values and in-flight promises
+              return await cached;
+            }
           }
 
           // In-flight promise caching: Prevent duplicate concurrent minifications
@@ -224,12 +229,12 @@ const processOptions = (inputOptions, { getLightningCSS, getTerser, getSwc, getS
             return (text.trim() && !outputCSS.trim() && (looksLikeTemplate || hasUID)) ? text : outputCSS;
           })();
 
-          cssCache.set(cssKey, inFlight);
+          if (cssKey !== undefined) cssCache.set(cssKey, inFlight);
           const resolved = await inFlight;
-          cssCache.set(cssKey, resolved);
+          if (cssKey !== undefined) cssCache.set(cssKey, resolved);
           return resolved;
         } catch (err) {
-          cssCache.delete(cssKey);
+          if (cssKey !== undefined) cssCache.delete(cssKey);
           if (!options.continueOnMinifyError) {
             throw err;
           }
@@ -293,19 +298,22 @@ const processOptions = (inputOptions, { getLightningCSS, getTerser, getSwc, getS
         // Hybrid strategy: Always use Terser for inline JS (needs bare returns support)
         // Use user’s chosen engine for script blocks
         const useEngine = inline ? 'terser' : engine;
-
         let jsKey;
+        const isCacheable = code.length <= MAX_CACHE_ENTRY_SIZE;
+
         try {
           // Select pre-computed signature based on engine
           const optsSig = useEngine === 'terser' ? terserSig : swcSig;
 
-          // For large inputs, hash the full content to avoid storing huge strings as Map keys
-          jsKey = (code.length > 2048 ? (hashContent(code) + '|') : (code + '|'))
-            + (inline ? '1' : '0') + '|' + (isModule ? 'm' : '') + '|' + useEngine + '|' + optsSig;
+          if (isCacheable) {
+            // For large inputs, hash the full content to avoid storing huge strings as Map keys
+            jsKey = (code.length > 2048 ? (hashContent(code) + '|') : (code + '|'))
+              + (inline ? '1' : '0') + '|' + (isModule ? 'm' : '') + '|' + useEngine + '|' + optsSig;
 
-          const cached = /** @type {string | Promise<string> | undefined} */ (jsCache.get(jsKey));
-          if (cached !== undefined) {
-            return await cached;
+            const cached = /** @type {string | Promise<string> | undefined} */ (jsCache.get(jsKey));
+            if (cached !== undefined) {
+              return await cached;
+            }
           }
 
           const inFlight = (async () => {
@@ -337,12 +345,12 @@ const processOptions = (inputOptions, { getLightningCSS, getTerser, getSwc, getS
             throw new Error(`Unknown JS minifier engine: ${useEngine}`);
           })();
 
-          jsCache.set(jsKey, inFlight);
+          if (jsKey !== undefined) jsCache.set(jsKey, inFlight);
           const resolved = await inFlight;
-          jsCache.set(jsKey, resolved);
+          if (jsKey !== undefined) jsCache.set(jsKey, resolved);
           return resolved;
         } catch (err) {
-          if (jsKey) jsCache.delete(jsKey);
+          if (jsKey !== undefined) jsCache.delete(jsKey);
           if (!options.continueOnMinifyError) {
             throw err;
           }
@@ -416,15 +424,19 @@ const processOptions = (inputOptions, { getLightningCSS, getTerser, getSwc, getS
           return svgContent;
         }
 
-        // Cache key: Large inputs are hashed to avoid huge Map keys
-        const svgKey = svgContent.length > 2048
-          ? (hashContent(svgContent) + '|' + svgSig)
-          : (svgContent + '|' + svgSig);
+        const isCacheable = svgContent.length <= MAX_CACHE_ENTRY_SIZE;
+        const svgKey = isCacheable
+          ? (svgContent.length > 2048
+            ? (hashContent(svgContent) + '|' + svgSig)
+            : (svgContent + '|' + svgSig))
+          : undefined;
 
         try {
-          const cached = /** @type {string | Promise<string> | undefined} */ (svgCache.get(svgKey));
-          if (cached !== undefined) {
-            return await cached;
+          if (svgKey !== undefined) {
+            const cached = /** @type {string | Promise<string> | undefined} */ (svgCache.get(svgKey));
+            if (cached !== undefined) {
+              return await cached;
+            }
           }
 
           const inFlight = (async () => {
@@ -433,12 +445,12 @@ const processOptions = (inputOptions, { getLightningCSS, getTerser, getSwc, getS
             return result.data;
           })();
 
-          svgCache.set(svgKey, inFlight);
+          if (svgKey !== undefined) svgCache.set(svgKey, inFlight);
           const resolved = await inFlight;
-          svgCache.set(svgKey, resolved);
+          if (svgKey !== undefined) svgCache.set(svgKey, resolved);
           return resolved;
         } catch (err) {
-          svgCache.delete(svgKey);
+          if (svgKey !== undefined) svgCache.delete(svgKey);
           if (!options.continueOnMinifyError) {
             throw err;
           }

package/src/lib/urls.js

@@ -79,7 +79,7 @@ function removeDirectoryIndex(pathname) {
 /**
  * Create a URL minifier function for the given site context
  * @param {string} site - The site base URL (used to compute relative URLs)
- * @returns {function(string): string} Minifier function that returns the shortest URL
+ * @returns {(url: string) => string} Minifier function that returns the shortest URL
  */
 export function createUrlMinifier(site) {
   let baseUrl;

package/src/lib/utils.js

@@ -21,12 +21,16 @@ function stableStringify(obj) {
 class LRU {
   constructor(limit = 200) {
     this.limit = limit;
+    this.gets = 0;
+    this.hits = 0;
     /** @type {Map<string, unknown>} */
     this.map = new Map();
   }
   /** @param {string} key */
   get(key) {
+    this.gets++;
     if (this.map.has(key)) {
+      this.hits++;
       const v = this.map.get(key);
       this.map.delete(key);
       this.map.set(key, v);
@@ -48,8 +52,17 @@ class LRU {
   }
   /** @param {string} key */
   delete(key) { this.map.delete(key); }
+  /** @returns {{ gets: number, hits: number, size: number, limit: number }} */
+  stats() {
+    return { gets: this.gets, hits: this.hits, size: this.map.size, limit: this.limit };
+  }
 }
 
+// Content longer than this (in UTF-16 code units, roughly bytes for typical CSS/JS/SVG) is
+// minified normally but never stored in a minification cache—caps worst-case cache memory
+// (entry count × this size) without affecting realistically sized inline content
+const MAX_CACHE_ENTRY_SIZE = 1024 * 1024; // 1 MB
+
 // FNV-1a 32-bit hash for large-input cache keys
 
 /** @param {string} str */
@@ -135,6 +148,7 @@ function parseRegExp(value) {
 
 export { stableStringify };
 export { LRU };
+export { MAX_CACHE_ENTRY_SIZE };
 export { hashContent };
 export { uniqueId };
 export { identity };