html-minifier-next 4.16.3 → 4.16.4

package/README.md

@@ -359,21 +359,20 @@ How does HTML Minifier Next compare to other minifiers? (All minification with t
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | [A List Apart](https://alistapart.com/) | 59 | **50** | 51 | 52 | 51 | 54 | 52 |
 | [Apple](https://www.apple.com/) | 211 | **176** | 187 | 189 | 190 | 191 | 192 |
-| [BBC](https://www.bbc.co.uk/) | 686 | **624** | 643 | 644 | 645 | 680 | n/a |
+| [BBC](https://www.bbc.co.uk/) | 712 | **649** | 669 | 669 | 671 | 707 | n/a |
 | [CERN](https://home.cern/) | 152 | **83** | 91 | 91 | 91 | 93 | 96 |
 | [CSS-Tricks](https://css-tricks.com/) | 162 | **119** | 127 | 143 | 143 | 148 | 144 |
 | [ECMAScript](https://tc39.es/ecma262/) | 7250 | **6401** | 6573 | 6455 | 6578 | 6626 | n/a |
 | [EDRi](https://edri.org/) | 80 | **59** | 70 | 70 | 71 | 75 | 73 |
 | [EFF](https://www.eff.org/) | 54 | **45** | 49 | 47 | 48 | 49 | 49 |
 | [European Alternatives](https://european-alternatives.eu/) | 48 | **30** | 32 | 32 | 32 | 32 | 32 |
-| [FAZ](https://www.faz.net/aktuell/) | 1587 | 1476 | **1421** | 1511 | 1522 | 1533 | n/a |
+| [FAZ](https://www.faz.net/aktuell/) | 1576 | 1466 | **1412** | 1500 | 1511 | 1522 | n/a |
 | [French Tech](https://lafrenchtech.gouv.fr/) | 153 | **122** | 126 | 126 | 126 | 132 | 127 |
 | [Frontend Dogma](https://frontenddogma.com/) | 225 | **217** | 238 | 223 | 225 | 244 | 225 |
 | [Google](https://www.google.com/) | 18 | **16** | 17 | 17 | 17 | 18 | 18 |
-| [Ground News](https://ground.news/) | 2291 | **2005** | 2106 | 2136 | 2139 | 2278 | n/a |
+| [Ground News](https://ground.news/) | 2374 | **2094** | 2186 | 2211 | 2213 | 2361 | n/a |
 | [HTML Living Standard](https://html.spec.whatwg.org/multipage/) | 149 | 148 | 153 | **147** | 149 | 155 | 149 |
 | [Igalia](https://www.igalia.com/) | 50 | **33** | 36 | 36 | 36 | 37 | 37 |
-| [Leanpub](https://leanpub.com/) | 235 | **205** | 220 | 219 | 220 | 230 | 232 |
 | [Mastodon](https://mastodon.social/explore) | 37 | **28** | 32 | 35 | 35 | 36 | 36 |
 | [MDN](https://developer.mozilla.org/en-US/) | 109 | **62** | 64 | 65 | 65 | 68 | 68 |
 | [Middle East Eye](https://www.middleeasteye.net/) | 223 | **197** | 203 | 201 | 201 | 202 | 203 |
@@ -387,7 +386,7 @@ How does HTML Minifier Next compare to other minifiers? (All minification with t
 | [United Nations](https://www.un.org/en/) | 152 | **112** | 121 | 125 | 125 | 130 | 123 |
 | [Vivaldi](https://vivaldi.com/) | 92 | **74** | n/a | 79 | 81 | 83 | 81 |
 | [W3C](https://www.w3.org/) | 51 | **36** | 39 | 38 | 38 | 41 | 39 |
-| **Average processing time** |  | 100 ms (30/30) | 157 ms (29/30) | 52 ms (30/30) | **14 ms (30/30)** | 278 ms (30/30) | 1385 ms (24/30) |
+| **Average processing time** |  | 96 ms (29/29) | 160 ms (28/29) | 52 ms (29/29) | **14 ms (29/29)** | 282 ms (29/29) | 1766 ms (23/29) |
 
 (Last updated: Dec 27, 2025)
 <!-- End auto-generated -->
@@ -552,6 +551,44 @@ ignoreCustomFragments: [/\{\{[\s\S]{0,500}?\}\}/]
 
 **Important:** When using custom `ignoreCustomFragments`, the minifier automatically applies bounded quantifiers to prevent ReDoS attacks, but you can also write safer patterns yourself using explicit bounds.
 
+#### Escaping patterns in different contexts
+
+The escaping requirements for `ignoreCustomFragments` patterns differ depending on how you’re using HMN:
+
+**Config file (JSON):**
+
+```json
+{
+  "ignoreCustomFragments": ["\\{%[\\s\\S]{0,1000}?%\\}", "\\{\\{[\\s\\S]{0,500}?\\}\\}"]
+}
+```
+
+**Programmatic (JavaScript/Node.js):**
+
+```javascript
+ignoreCustomFragments: [/\{%[\s\S]{0,1000}?%\}/, /\{\{[\s\S]{0,500}?\}\}/]
+```
+
+**CLI (via config file—recommended):**
+
+```shell
+html-minifier-next --config-file=config.json input.html
+```
+
+**CLI (inline—not recommended due to complex escaping):**
+
+```shell
+html-minifier-next --ignore-custom-fragments '[\\\"\\\\{%[\\\\s\\\\S]{0,1000}?%\\\\}\\\"]' input.html
+```
+
+For CLI usage, using a config file is strongly recommended to avoid complex shell and JSON escaping.
+
+**[Web demo:](https://j9t.github.io/html-minifier-next/)**
+
+```
+\{%[\s\S]{0,1000}?%\} \{\{[\s\S]{0,500}?\}\}
+```
+
 ## Running HTML Minifier Next locally
 
 ### Local server
@@ -572,6 +609,22 @@ npm run benchmarks
 
 (In case of dependency conflicts, run `npm i` with the `--legacy-peer-deps` flag.)
 
+### Regression tests
+
+```shell
+cd benchmarks;
+npm i;
+npm run backtest
+```
+
+The backtest tool tracks minification performance across Git history. Results are saved in `benchmarks/backtest/` as CSV and JSON files.
+
+Parameters:
+
+* No argument: Tests last 50 commits (default)
+* `COUNT`: Tests last `COUNT` commits (e.g., `npm run backtest 100`)
+* `COUNT/STEP`: Tests last `COUNT` commits, sampling every `STEP`th commit (e.g., `npm run backtest 500/10` tests 50 commits)
+
 ## Acknowledgements
 
 With many thanks to all the previous authors of HTML Minifier, especially [Juriy “kangax” Zaytsev](https://github.com/kangax), and to everyone who helped make this new edition better, particularly [Daniel Ruf](https://github.com/DanielRuf) and [Jonas Geiler](https://github.com/jonasgeiler).

package/package.json

@@ -23,7 +23,7 @@
     "@rollup/plugin-terser": "^0.4.4",
     "@swc/core": "^1.15.7",
     "eslint": "^9.39.2",
-    "rollup": "^4.53.3",
+    "rollup": "^4.54.0",
     "rollup-plugin-polyfill-node": "^0.13.0",
     "typescript": "^5.9.3",
     "vite": "^7.2.7"
@@ -42,6 +42,7 @@
     "dist/",
     "src/"
   ],
+  "funding": "https://buymeacoffee.com/meiert",
   "homepage": "https://j9t.github.io/html-minifier-next/",
   "keywords": [
     "cli",
@@ -78,7 +79,10 @@
       "optional": true
     }
   },
-  "repository": "https://github.com/j9t/html-minifier-next.git",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/j9t/html-minifier-next.git"
+  },
   "scripts": {
     "prebuild": "node --eval='require(`fs`).rmSync(`dist`,{recursive:true,force:true})'",
     "build": "tsc && rollup -c",
@@ -93,5 +97,5 @@
     "test:watch": "node --test --watch tests/*.spec.js"
   },
   "type": "module",
-  "version": "4.16.3"
+  "version": "4.16.4"
 }

package/src/utils.js

@@ -1,11 +0,0 @@
-export async function replaceAsync(str, regex, asyncFn) {
-  const promises = [];
-
-  str.replace(regex, (match, ...args) => {
-    const promise = asyncFn(match, ...args);
-    promises.push(promise);
-  });
-
-  const data = await Promise.all(promises);
-  return str.replace(regex, () => data.shift());
-}