html-minifier-next 7.0.0 → 7.2.0

package/README.md

@@ -40,7 +40,7 @@ Use `npx html-minifier-next --help` to check all available options:
 | `--output <file>`, `-o <file>` | Specify output file (reads from `--input` file argument or STDIN; outputs to STDOUT if not specified) | File to file: `npx html-minifier-next input.html -o output.html`<br>File to file (explicit): `npx html-minifier-next -i input.html -o output.html`<br>Pipe to file: `cat input.html \| npx html-minifier-next -o output.html`<br>File to STDOUT: `npx html-minifier-next input.html` |
 | `--file-ext <extensions>`, `-f <extensions>` | Specify file extension(s) to process (comma-separated, overrides config file setting); defaults to `html,htm,shtml,shtm`; use `*` for all files | `--file-ext=html,php`, `--file-ext='*'` |
 | `--preset <name>`, `-p <name>` | Use a preset configuration (conservative or comprehensive) | `--preset=conservative` |
-| `--config-file <file>`, `-c <file>` | Use a configuration file | `--config-file=html-minifier.json` |
+| `--config-file <file>`, `-c <file>` | Use a configuration file | `--config-file=html-minifier-next.json` |
 | `--verbose`, `-v` | Show detailed processing information (active options, file statistics) | `npx html-minifier-next --input-dir=src --output-dir=dist --verbose --collapse-whitespace` |
 | `--dry`, `-d` | Dry run: Process and report statistics without writing output | `npx html-minifier-next input.html --dry --collapse-whitespace` |
 
@@ -59,6 +59,18 @@ You can use a configuration file to specify options. The file can be either in J
 }
 ```
 
+For editor support (validation, autocomplete, and inline documentation) in JSON configuration files, reference the [JSON Schema](https://raw.githubusercontent.com/j9t/html-minifier-next/main/html-minifier-next.schema.json) that ships with the package:
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/j9t/html-minifier-next/main/html-minifier-next.schema.json",
+  "collapseWhitespace": true,
+  "removeComments": true
+}
+```
+
+(If HMN is installed locally, you can also use the path `./node_modules/html-minifier-next/html-minifier-next.schema.json` instead of the URL.)
+
 **JavaScript module configuration example** (requires `"type": "module"` in the project’s package.json, or use a .mjs extension):
 
 ```javascript
@@ -100,8 +112,8 @@ To review the specific options set, [presets.js](https://github.com/j9t/html-min
 npx html-minifier-next --preset conservative input.html
 
 # Via config file
-npx html-minifier-next --config-file=html-minifier.json input.html
-# where html-minifier.json contains: { "preset": "conservative" }
+npx html-minifier-next --config-file=html-minifier-next.json input.html
+# where html-minifier-next.json contains: { "preset": "conservative" }
 
 # Override preset options
 npx html-minifier-next --preset conservative --remove-empty-attributes input.html
@@ -360,13 +372,13 @@ npx html-minifier-next --minify-css --minify-js --minify-svg input.html
 
 * Single file processing: Default `500` is sufficient
 * Batch processing: Increase to `1000` or higher for better cache hit rates
-* Memory-constrained environments: Reduce to `200`–`300` to save memory
+* Memory-constrained environments: Cache sizes can be lowered, though the savings are usually negligible—entries are typically kilobyte-scale, so even full caches only hold a few megabytes
 * Hundreds/thousands of files: Increase to `1000`–`2000` for optimal performance
 
 **Important:**
 
 * Cache locking: Caches are created on the first `minify()` call and persist for the process lifetime. Cache sizes are locked after first initialization—subsequent calls reuse the same caches even if different `cacheCSS`, `cacheJS`, or `cacheSVG` options are provided. The first call’s options determine the cache sizes.
-* Zero values: Explicit `0` values are coerced to `1` (minimum functional cache size) to avoid immediate eviction. If you want to minimize memory usage, use a small number like `10` or `50` instead of `0`.
+* Zero values: Explicit `0` values are coerced to `1` (minimum functional cache size) to avoid immediate eviction. To keep the cache footprint as small as possible, use a small number like `10` or `50` instead of `0`.
 
 The caches persist across multiple `minify()` calls, making them particularly effective when processing many files in a batch operation.
 
@@ -396,7 +408,7 @@ npx html-minifier-next --collapse-whitespace --input-dir=src --output-dir=dist
 npx html-minifier-next --collapse-whitespace --input-dir=src --output-dir=dist --file-ext=html,php
 
 # Using configuration file that sets `fileExt` (e.g., `"fileExt": "html,php"`)
-npx html-minifier-next --config-file=html-minifier.json --input-dir=src --output-dir=dist
+npx html-minifier-next --config-file=html-minifier-next.json --input-dir=src --output-dir=dist
 
 # Process all files (explicit wildcard)
 npx html-minifier-next --collapse-whitespace --input-dir=src --output-dir=dist --file-ext='*'
@@ -608,7 +620,7 @@ Parameters:
 * `--save`: Saves the run as the baseline (e.g., on `main` before switching to a branch)
 * `--core`: Disables the external minifiers (CSS, JS, SVG, URLs) to isolate HMN’s own processing time
 * `--iterations=N`: Sets the number of timed iterations (default 5; the median is reported)
-* `--config=PATH`: Uses an alternative options file (default `html-minifier.json`)
+* `--config=PATH`: Uses an alternative options file (default `html-minifier-next.json`)
 
 To compare branches (A/B run), execute `npm run benchmark -- --save` on `main`, then `npm run benchmark` on the branch to see the deltas. Add `--core` on both ends when measuring changes to HMN’s own code rather than the bundled minifiers.
 

package/cli.js

@@ -227,7 +227,7 @@ async function loadConfigFromPath(configPath) {
 }
 
 // Config keys the CLI handles itself, beyond the options in `optionDefinitions`
-const CONFIG_KEYS_EXTRA = new Set(['preset', 'fileExt', 'ignoreDir']);
+const CONFIG_KEYS_EXTRA = new Set(['$schema', 'preset', 'fileExt', 'ignoreDir']);
 
 /**
  * Normalize and validate config object by applying parsers and transforming values.
@@ -283,9 +283,6 @@ program.option('-O --output-dir <dir>', 'Specify an output directory');
 program.option('-f --file-ext <extensions>', 'Specify file extension(s) to process (comma-separated); defaults to “html,htm,shtml,shtm”; use “*” for all files');
 program.option('-p --preset <name>', `Use a preset configuration (${getPresetNames().join(', ')})`);
 program.option('-c --config-file <file>', 'Use config file');
-program.option('--cache-css <size>', 'Set CSS minification cache size (number of entries, default: 500)', parseValidInt('cacheCSS'));
-program.option('--cache-js <size>', 'Set JavaScript minification cache size (number of entries, default: 500)', parseValidInt('cacheJS'));
-program.option('--cache-svg <size>', 'Set SVG minification cache size (number of entries, default: 500)', parseValidInt('cacheSVG'));
 program.version(pkg.version, '-V, --version', 'Output the version number');
 program.helpOption('-h, --help', 'Display help for command');
 

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

@@ -1 +1 @@
-{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/lib/attributes.js"],"names":[],"mappings":";;;4BA0Ba;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AAiB3I;;;GAGG;AACH,uCAHW,MAAM,WACN,gBAAgB,WAS1B;AAED;;;GAGG;AACH,2CAHW,MAAM,WACN;IAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC,WAa5C;AAED,4BAA4B;AAC5B,gDADY,MAAM,WAIjB;AAED;;;GAGG;AACH,8CAHW,aAAa,EAAE,aACf,MAAM,WAShB;AA+BD;;;;;GAKG;AACH,0CALW,MAAM,YACN,MAAM,aACN,MAAM,SACN,aAAa,EAAE,WAyCzB;AAED,mEAGC;AAED,qEAGC;AAED;;;GAGG;AACH,wCAHW,MAAM,SACN,aAAa,EAAE,WAYzB;AAED,sEAGC;AAED;;;GAGG;AACH,oCAHW,MAAM,SACN,aAAa,EAAE,WAYzB;AAED;;;GAGG;AACH,6CAHW,MAAM,aACN,MAAM,uBAMhB;AAmBD;;;GAGG;AACH,6CAHW,MAAM,OACN,MAAM,WAKhB;AAgBD;;;GAGG;AACH,gDAHW,MAAM,OACN,MAAM,WAKhB;AAED;;;;GAIG;AACH,gCAJW,MAAM,SACN,aAAa,EAAE,SACf,MAAM,WAYhB;AAED;;;;GAIG;AACH,kCAJW,MAAM,SACN,aAAa,EAAE,YACf,MAAM,WAIhB;AAED;;;GAGG;AACH,mCAHW,MAAM,OACN,MAAM,WAIhB;AAED;;;GAGG;AACH,oCAHW,MAAM,SACN,aAAa,EAAE,WAYzB;AAED;;;GAGG;AACH,6CAHW,MAAM,SACN,aAAa,EAAE,WAYzB;AAED;;;;;GAKG;AACH,6CALW,MAAM,YACN,MAAM,aACN,MAAM,GAAG,SAAS,WAClB;IAAC,qBAAqB,CAAC,EAAE,OAAO,WAAW,CAAA;CAAC,OAWtD;AAED;;;GAGG;AACH,kCAHW,MAAM,SACN,aAAa,EAAE,WASzB;AAUD;;;;;;;GAOG;AACH,yCAPW,MAAM,YACN,MAAM,aACN,MAAM,WACN,gBAAgB,SAChB,aAAa,EAAE,iCAkMzB;AAwBD;;;;;;GAMG;AACH,oCANW,aAAa,SACb,aAAa,EAAE,OACf,MAAM,WACN,gBAAgB;;;;;;;;2BAe1B;AA0DD;;;;;;GAMG;AACH,sCANW;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAC,iBAC9D,MAAM,GAAG,OAAO,GAAG,SAAS,WAC5B,gBAAgB,UAChB,OAAO,WACP,MAAM,GAAG,SAAS,UA0H5B;AAzsBD;;;;;;;GAOG;AACH,6CAJW,aAAa,EAAE,iBACf,OAAO,GACL,aAAa,EAAE,CAqB3B;sCAlGqC,cAAc"}
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/lib/attributes.js"],"names":[],"mappings":";;;4BA0Ba;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AAiB3I;;;GAGG;AACH,uCAHW,MAAM,WACN,gBAAgB,WAS1B;AAED;;;GAGG;AACH,2CAHW,MAAM,WACN;IAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC,WAa5C;AAED,4BAA4B;AAC5B,gDADY,MAAM,WAIjB;AAED;;;GAGG;AACH,8CAHW,aAAa,EAAE,aACf,MAAM,WAShB;AA+BD;;;;;GAKG;AACH,0CALW,MAAM,YACN,MAAM,aACN,MAAM,SACN,aAAa,EAAE,WAyCzB;AAED,mEAGC;AAED,qEAGC;AAED;;;GAGG;AACH,wCAHW,MAAM,SACN,aAAa,EAAE,WAYzB;AAED,sEAGC;AAED;;;GAGG;AACH,oCAHW,MAAM,SACN,aAAa,EAAE,WAYzB;AAED;;;GAGG;AACH,6CAHW,MAAM,aACN,MAAM,uBAMhB;AAmBD;;;GAGG;AACH,6CAHW,MAAM,OACN,MAAM,WAKhB;AAgBD;;;GAGG;AACH,gDAHW,MAAM,OACN,MAAM,WAKhB;AAED;;;;GAIG;AACH,gCAJW,MAAM,SACN,aAAa,EAAE,SACf,MAAM,WAYhB;AAED;;;;GAIG;AACH,kCAJW,MAAM,SACN,aAAa,EAAE,YACf,MAAM,WAIhB;AAED;;;GAGG;AACH,mCAHW,MAAM,OACN,MAAM,WAKhB;AAED;;;GAGG;AACH,oCAHW,MAAM,SACN,aAAa,EAAE,WAYzB;AAED;;;GAGG;AACH,6CAHW,MAAM,SACN,aAAa,EAAE,WAYzB;AAED;;;;;GAKG;AACH,6CALW,MAAM,YACN,MAAM,aACN,MAAM,GAAG,SAAS,WAClB;IAAC,qBAAqB,CAAC,EAAE,OAAO,WAAW,CAAA;CAAC,OAWtD;AAED;;;GAGG;AACH,kCAHW,MAAM,SACN,aAAa,EAAE,WASzB;AAUD;;;;;;;GAOG;AACH,yCAPW,MAAM,YACN,MAAM,aACN,MAAM,WACN,gBAAgB,SAChB,aAAa,EAAE,iCA4NzB;AAwBD;;;;;;GAMG;AACH,oCANW,aAAa,SACb,aAAa,EAAE,OACf,MAAM,WACN,gBAAgB;;;;;;;;2BAe1B;AA0DD;;;;;;GAMG;AACH,sCANW;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAC,iBAC9D,MAAM,GAAG,OAAO,GAAG,SAAS,WAC5B,gBAAgB,UAChB,OAAO,WACP,MAAM,GAAG,SAAS,UA0H5B;AApuBD;;;;;;;GAOG;AACH,6CAJW,aAAa,EAAE,iBACf,OAAO,GACL,aAAa,EAAE,CAqB3B;sCAlGqC,cAAc"}

package/dist/types/lib/option-definitions.d.ts

@@ -1,273 +1,291 @@
 export namespace optionDefinitions {
-    namespace caseSensitive {
+    namespace cacheCSS {
         let description: string;
         let type: string;
     }
-    namespace collapseAttributeWhitespace {
+    namespace cacheJS {
         let description_1: string;
         export { description_1 as description };
         let type_1: string;
         export { type_1 as type };
     }
-    namespace collapseBooleanAttributes {
+    namespace cacheSVG {
         let description_2: string;
         export { description_2 as description };
         let type_2: string;
         export { type_2 as type };
     }
-    namespace collapseInlineTagWhitespace {
+    namespace caseSensitive {
         let description_3: string;
         export { description_3 as description };
         let type_3: string;
         export { type_3 as type };
     }
-    namespace collapseWhitespace {
+    namespace collapseAttributeWhitespace {
         let description_4: string;
         export { description_4 as description };
         let type_4: string;
         export { type_4 as type };
     }
-    namespace conservativeCollapse {
+    namespace collapseBooleanAttributes {
         let description_5: string;
         export { description_5 as description };
         let type_5: string;
         export { type_5 as type };
     }
-    namespace continueOnMinifyError {
+    namespace collapseInlineTagWhitespace {
         let description_6: string;
         export { description_6 as description };
-        export let descriptionAffirmative: string;
         let type_6: string;
         export { type_6 as type };
     }
-    namespace continueOnParseError {
+    namespace collapseWhitespace {
         let description_7: string;
         export { description_7 as description };
         let type_7: string;
         export { type_7 as type };
     }
-    namespace customAttrAssign {
+    namespace conservativeCollapse {
         let description_8: string;
         export { description_8 as description };
         let type_8: string;
         export { type_8 as type };
     }
-    namespace customAttrCollapse {
+    namespace continueOnMinifyError {
         let description_9: string;
         export { description_9 as description };
+        export let descriptionAffirmative: string;
         let type_9: string;
         export { type_9 as type };
     }
-    namespace customAttrSurround {
+    namespace continueOnParseError {
         let description_10: string;
         export { description_10 as description };
         let type_10: string;
         export { type_10 as type };
     }
-    namespace customEventAttributes {
+    namespace customAttrAssign {
         let description_11: string;
         export { description_11 as description };
         let type_11: string;
         export { type_11 as type };
     }
-    namespace customFragmentQuantifierLimit {
+    namespace customAttrCollapse {
         let description_12: string;
         export { description_12 as description };
         let type_12: string;
         export { type_12 as type };
     }
-    namespace decodeEntities {
+    namespace customAttrSurround {
         let description_13: string;
         export { description_13 as description };
         let type_13: string;
         export { type_13 as type };
     }
-    namespace ignoreCustomComments {
+    namespace customEventAttributes {
         let description_14: string;
         export { description_14 as description };
         let type_14: string;
         export { type_14 as type };
     }
-    namespace ignoreCustomFragments {
+    namespace customFragmentQuantifierLimit {
         let description_15: string;
         export { description_15 as description };
         let type_15: string;
         export { type_15 as type };
     }
-    namespace includeAutoGeneratedTags {
+    namespace decodeEntities {
         let description_16: string;
         export { description_16 as description };
         let type_16: string;
         export { type_16 as type };
     }
-    namespace inlineCustomElements {
+    namespace ignoreCustomComments {
         let description_17: string;
         export { description_17 as description };
         let type_17: string;
         export { type_17 as type };
     }
-    namespace keepClosingSlash {
+    namespace ignoreCustomFragments {
         let description_18: string;
         export { description_18 as description };
         let type_18: string;
         export { type_18 as type };
     }
-    namespace maxInputLength {
+    namespace includeAutoGeneratedTags {
         let description_19: string;
         export { description_19 as description };
         let type_19: string;
         export { type_19 as type };
     }
-    namespace maxLineLength {
+    namespace inlineCustomElements {
         let description_20: string;
         export { description_20 as description };
         let type_20: string;
         export { type_20 as type };
     }
-    namespace mergeScripts {
+    namespace keepClosingSlash {
         let description_21: string;
         export { description_21 as description };
         let type_21: string;
         export { type_21 as type };
     }
-    namespace minifyCSS {
+    namespace maxInputLength {
         let description_22: string;
         export { description_22 as description };
         let type_22: string;
         export { type_22 as type };
     }
-    namespace minifyJS {
+    namespace maxLineLength {
         let description_23: string;
         export { description_23 as description };
         let type_23: string;
         export { type_23 as type };
     }
-    namespace minifySVG {
+    namespace mergeScripts {
         let description_24: string;
         export { description_24 as description };
         let type_24: string;
         export { type_24 as type };
     }
-    namespace minifyURLs {
+    namespace minifyCSS {
         let description_25: string;
         export { description_25 as description };
         let type_25: string;
         export { type_25 as type };
     }
-    namespace noNewlinesBeforeTagClose {
+    namespace minifyJS {
         let description_26: string;
         export { description_26 as description };
         let type_26: string;
         export { type_26 as type };
     }
-    namespace partialMarkup {
+    namespace minifySVG {
         let description_27: string;
         export { description_27 as description };
         let type_27: string;
         export { type_27 as type };
     }
-    namespace preserveLineBreaks {
+    namespace minifyURLs {
         let description_28: string;
         export { description_28 as description };
         let type_28: string;
         export { type_28 as type };
     }
-    namespace preventAttributesEscaping {
+    namespace noNewlinesBeforeTagClose {
         let description_29: string;
         export { description_29 as description };
         let type_29: string;
         export { type_29 as type };
     }
-    namespace processScripts {
+    namespace partialMarkup {
         let description_30: string;
         export { description_30 as description };
         let type_30: string;
         export { type_30 as type };
     }
-    namespace quoteCharacter {
+    namespace preserveLineBreaks {
         let description_31: string;
         export { description_31 as description };
         let type_31: string;
         export { type_31 as type };
     }
-    namespace removeAttributeQuotes {
+    namespace preventAttributesEscaping {
         let description_32: string;
         export { description_32 as description };
         let type_32: string;
         export { type_32 as type };
     }
-    namespace removeComments {
+    namespace processScripts {
         let description_33: string;
         export { description_33 as description };
         let type_33: string;
         export { type_33 as type };
     }
-    namespace removeDefaultTypeAttributes {
+    namespace quoteCharacter {
         let description_34: string;
         export { description_34 as description };
         let type_34: string;
         export { type_34 as type };
     }
-    namespace removeEmptyAttributes {
+    namespace removeAttributeQuotes {
         let description_35: string;
         export { description_35 as description };
         let type_35: string;
         export { type_35 as type };
     }
-    namespace removeEmptyElements {
+    namespace removeComments {
         let description_36: string;
         export { description_36 as description };
         let type_36: string;
         export { type_36 as type };
     }
-    namespace removeEmptyElementsExcept {
+    namespace removeDefaultTypeAttributes {
         let description_37: string;
         export { description_37 as description };
         let type_37: string;
         export { type_37 as type };
     }
-    namespace removeOptionalTags {
+    namespace removeEmptyAttributes {
         let description_38: string;
         export { description_38 as description };
         let type_38: string;
         export { type_38 as type };
     }
-    namespace removeRedundantAttributes {
+    namespace removeEmptyElements {
         let description_39: string;
         export { description_39 as description };
         let type_39: string;
         export { type_39 as type };
     }
-    namespace removeTagWhitespace {
+    namespace removeEmptyElementsExcept {
         let description_40: string;
         export { description_40 as description };
         let type_40: string;
         export { type_40 as type };
     }
-    namespace sortAttributes {
+    namespace removeOptionalTags {
         let description_41: string;
         export { description_41 as description };
         let type_41: string;
         export { type_41 as type };
     }
-    namespace sortClassNames {
+    namespace removeRedundantAttributes {
         let description_42: string;
         export { description_42 as description };
         let type_42: string;
         export { type_42 as type };
     }
-    namespace trimCustomFragments {
+    namespace removeTagWhitespace {
         let description_43: string;
         export { description_43 as description };
         let type_43: string;
         export { type_43 as type };
     }
-    namespace useShortDoctype {
+    namespace sortAttributes {
         let description_44: string;
         export { description_44 as description };
         let type_44: string;
         export { type_44 as type };
     }
+    namespace sortClassNames {
+        let description_45: string;
+        export { description_45 as description };
+        let type_45: string;
+        export { type_45 as type };
+    }
+    namespace trimCustomFragments {
+        let description_46: string;
+        export { description_46 as description };
+        let type_46: string;
+        export { type_46 as type };
+    }
+    namespace useShortDoctype {
+        let description_47: string;
+        export { description_47 as description };
+        let type_47: string;
+        export { type_47 as type };
+    }
 }
 export namespace optionDefaults {
     let continueOnMinifyError_1: boolean;

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

@@ -14,13 +14,13 @@
   },
   "description": "Super-configurable and well-tested web page minifier (enhanced successor to HTML Minifier)",
   "devDependencies": {
-    "@commitlint/cli": "^21.0.1",
+    "@commitlint/cli": "^21.2.0",
     "@eslint/js": "^10.0.1",
-    "@swc/core": "^1.15.40",
-    "@types/node": "^25.9.1",
-    "eslint": "^10.4.0",
+    "@swc/core": "^1.15.41",
+    "@types/node": "^26.1.0",
+    "eslint": "^10.6.0",
     "typescript": "^6.0.3",
-    "vite": "^8.0.14"
+    "vite": "^8.0.16"
   },
   "engines": {
     "node": ">=22"
@@ -34,6 +34,7 @@
   },
   "files": [
     "cli.js",
+    "html-minifier-next.schema.json",
     "dist/types/",
     "src/"
   ],
@@ -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.0.0"
+  "version": "7.2.0"
 }

package/src/lib/attributes.js

@@ -303,7 +303,8 @@ function isMediaQuery(tag, attrs, attrName) {
  * @param {string} tag
  */
 function isSrcset(attrName, tag) {
-  return attrName === 'srcset' && srcsetElements.has(tag);
+  return (attrName === 'srcset' && srcsetElements.has(tag)) ||
+    (attrName === 'imagesrcset' && tag === 'link');
 }
 
 /**
@@ -492,8 +493,34 @@ function cleanAttributeValue(tag, attrName, attrValue, options, attrs, minifyHTM
   }
 
   if (isSrcset(attrName, tag)) {
-    // https://html.spec.whatwg.org/multipage/embedded-content.html#attr-img-srcset
-    const candidates = trimWhitespace(attrValue).split(/\s*,\s*/);
+    // Split into image candidate strings following the spec parsing algorithm
+    // (https://html.spec.whatwg.org/multipage/images.html#parsing-a-srcset-attribute);
+    // a naive split on commas would corrupt URLs that contain commas
+    const value = trimWhitespace(attrValue);
+    /** @type {string[]} */
+    const candidates = [];
+    let pos = 0;
+    while (pos < value.length) {
+      // Skip whitespace and separator commas
+      while (pos < value.length && /[\s,]/.test(value.charAt(pos))) pos++;
+      if (pos >= value.length) break;
+      const start = pos;
+      // URL: a run of non-whitespace characters (which may contain commas)
+      while (pos < value.length && !/\s/.test(value.charAt(pos))) pos++;
+      if (value.charAt(pos - 1) === ',') {
+        // Trailing comma(s) end the candidate—a URL without descriptor
+        candidates.push(value.slice(start, pos).replace(/,+$/, ''));
+        continue;
+      }
+      // Descriptor: everything up to the next comma outside parentheses
+      let inParens = false;
+      while (pos < value.length && (inParens || value.charAt(pos) !== ',')) {
+        if (value.charAt(pos) === '(') inParens = true;
+        else if (value.charAt(pos) === ')') inParens = false;
+        pos++;
+      }
+      candidates.push(trimWhitespace(value.slice(start, pos)));
+    }
     const processed = candidates.map(candidate => {
       let url = candidate;
       let descriptor = '';

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'

package/src/lib/options.js

@@ -50,7 +50,7 @@ function shouldMinifyInnerHTML(options) {
 }
 
 // User-facing option keys that are valid but not listed in `optionDefinitions`
-const optionKeysExtra = new Set(['preset', 'log', 'canCollapseWhitespace', 'canTrimWhitespace', 'cacheCSS', 'cacheJS', 'cacheSVG']);
+const optionKeysExtra = new Set(['preset', 'log', 'canCollapseWhitespace', 'canTrimWhitespace']);
 
 // Unknown option keys and preset names already warned about—warn once per
 // key per process, so repeated `minify` calls (e.g., batch runs) don’t flood STDERR