html-minifier-next 2.1.3 → 2.1.5

package/README.md

@@ -1,11 +1,11 @@
 # HTML Minifier Next
 
 [![npm version](https://img.shields.io/npm/v/html-minifier-next.svg)](https://www.npmjs.com/package/html-minifier-next)
-[![Build status](https://github.com/j9t/html-minifier-next/workflows/CI/badge.svg)](https://github.com/j9t/html-minifier-next/actions?workflow=CI)
+[![Build status](https://github.com/j9t/html-minifier-next/workflows/Tests/badge.svg)](https://github.com/j9t/html-minifier-next/actions)
 
-HTML Minifier Next is a highly **configurable, well-tested, JavaScript-based HTML minifier**.
+HTML Minifier Next (HMN) is a highly **configurable, well-tested, JavaScript-based HTML minifier**.
 
-The project has been based on [Terser’s html-minifier-terser](https://github.com/terser/html-minifier-terser), which in turn had been based on [Juriy Zaytsev’s html-minifier](https://github.com/kangax/html-minifier). It was set up because as of 2025, both html-minifier-terser and html-minifier have been unmaintained for some time. As the project seems maintainable [to me, [Jens](https://meiert.com/)]—even more so with community support—, it will be updated and documented further in this place.
+The project has been based on [Terser’s html-minifier-terser](https://github.com/terser/html-minifier-terser), which in turn had been based on [Juriy Zaytsev’s html-minifier](https://github.com/kangax/html-minifier) (HMN offers additional features, but is compatible with both). It was set up because as of 2025, both html-minifier-terser and html-minifier have been unmaintained for some time. As the project seems maintainable [to me, [Jens](https://meiert.com/)]—even more so with community support—, it’s being updated and documented further in this place.
 
 ## Installation
 
@@ -127,27 +127,29 @@ For lint-like capabilities take a look at [HTMLLint](https://github.com/kangax/h
 
 ## Minification comparison
 
-How does HTML Minifier Next compare to other solutions, like [minimize](https://github.com/Swaagie/minimize), [htmlcompressor.com](http://htmlcompressor.com/), [htmlnano](https://github.com/posthtml/htmlnano), and [minify-html](https://github.com/wilsonzlin/minify-html)?
+How does HTML Minifier Next compare to other solutions, like [minimize](https://github.com/Swaagie/minimize), [htmlcompressor.com](http://htmlcompressor.com/), [htmlnano](https://github.com/posthtml/htmlnano), and [minify-html](https://github.com/wilsonzlin/minify-html)? (All with the most aggressive settings, but without [hyper-optimization](https://meiert.com/blog/the-ways-of-writing-html/#toc-hyper-optimized).)
 
-| Site | Original size (KB) | HTML Minifier Next | minimize | htmlcompressor.com | htmlnano | minify-html |
+| Site | Original size (KB) | HTML Minifier Next | minimize | html­compressor.com | htmlnano | minify-html |
 | --- | --- | --- | --- | --- | --- | --- |
-| [A List Apart](https://alistapart.com/) | 64 | **54** | 59 | 57 | 59 | 56 |
-| [Amazon](https://www.amazon.com/) | 718 | **645** | 704 | n/a | 667 | 683 |
-| [BBC](https://www.bbc.co.uk/) | 739 | **678** | 733 | n/a | 709 | 718 |
-| [CSS-Tricks](https://css-tricks.com/) | 165 | **123** | 151 | 148 | 136 | 148 |
-| [ECMAScript](https://tc39.es/ecma262/) | 7205 | **6365** | 6585 | n/a | 6871 | 6538 |
-| [EFF](https://www.eff.org/) | 58 | **49** | 53 | 53 | 55 | 52 |
-| [Eloquent JavaScript](https://eloquentjavascript.net/) | 6 | **5** | 6 | 5 | 6 | 5 |
-| [FAZ](https://www.faz.net/aktuell/) | 1814 | **1696** | 1730 | n/a | 1623 | 1735 |
-| [Frontend Dogma](https://frontenddogma.com/) | 118 | **113** | 127 | 117 | 131 | 117 |
-| [Google](https://www.google.com/) | 50 | **46** | 50 | 50 | 48 | 49 |
-| [HTML Minifier Next](https://github.com/j9t/html-minifier-next) | 393 | **274** | 371 | n/a | 339 | 359 |
-| [Mastodon](https://mastodon.social/explore) | 35 | **26** | 34 | 34 | 31 | 33 |
-| [meiert.com](https://meiert.com/) | 25 | **24** | 26 | 25 | 26 | 25 |
-| [NBC](https://www.nbc.com/) | 584 | **533** | 576 | n/a | 559 | 571 |
-| [New York Times](https://www.nytimes.com/) | 864 | **738** | 852 | n/a | 801 | 848 |
-| [United Nations](https://www.un.org/) | 9 | **7** | 8 | 8 | 8 | 7 |
-| [W3C](https://www.w3.org/) | 50 | **36** | 41 | 39 | 40 | 41 |
+| [A List Apart](https://alistapart.com/) | 63 | **54** | 58 | 57 | 55 | 56 |
+| [Amazon](https://www.amazon.com/) | 5 | **3** | **3** | **3** | **3** | n/a |
+| [Apple](https://www.apple.com/) | 212 | **171** | 198 | 195 | 189 | 194 |
+| [BBC](https://www.bbc.co.uk/) | 742 | **683** | 736 | n/a | 698 | 699 |
+| [CSS-Tricks](https://css-tricks.com/) | 11 | **6** | 11 | 10 | 7 | n/a |
+| [ECMAScript](https://tc39.es/ecma262/) | 7205 | **6315** | 6585 | n/a | 6532 | 6538 |
+| [EFF](https://www.eff.org/) | 60 | **51** | 55 | 55 | 54 | 53 |
+| [FAZ](https://www.faz.net/aktuell/) | 1847 | 1728 | 1764 | n/a | **1630** | n/a |
+| [Frontend Dogma](https://frontenddogma.com/) | 117 | **112** | 126 | 117 | 124 | 117 |
+| [Google](https://www.google.com/) | 18 | **16** | 17 | 17 | **16** | n/a |
+| [Ground News](https://ground.news/) | 1509 | **1287** | 1495 | n/a | 1386 | n/a |
+| [HTML](https://html.spec.whatwg.org/multipage/) | 149 | **146** | 155 | 148 | 153 | 148 |
+| [Leanpub](https://leanpub.com/) | 1361 | **1143** | 1355 | n/a | 1150 | n/a |
+| [Mastodon](https://mastodon.social/explore) | 35 | **25** | 33 | 33 | 30 | 33 |
+| [MDN](https://developer.mozilla.org/en-US/) | 104 | **62** | 67 | 68 | 64 | n/a |
+| [Middle East Eye](https://www.middleeasteye.net/) | 221 | **194** | 201 | 202 | 201 | 199 |
+| [SitePoint](https://www.sitepoint.com/) | 469 | **338** | 466 | n/a | 408 | 449 |
+| [United Nations](https://www.un.org/en/) | 153 | **116** | 132 | 125 | 123 | 127 |
+| [W3C](https://www.w3.org/) | 49 | **35** | 40 | 38 | 37 | 38 |
 
 ## Options quick reference
 
@@ -220,9 +222,9 @@ SVG elements are automatically recognized, and when they are minified, both case
 
 HTML Minifier Next **can’t work with invalid or partial chunks of markup**. This is because it parses markup into a tree structure, then modifies it (removing anything that was specified for removal, ignoring anything that was specified to be ignored, etc.), then it creates a markup out of that tree and returns it.
 
-Input markup (e.g., `<p id="">foo`) → Internal representation of markup in a form of tree (e.g., `{ tag: "p", attr: "id", children: ["foo"] }`) → Transformation of internal representation (e.g., removal of `id` attribute) → Output of resulting markup (e.g., `<p>foo</p>`)
+_Input markup (e.g., `<p id="">foo`) → Internal representation of markup in a form of tree (e.g., `{ tag: "p", attr: "id", children: ["foo"] }`) → Transformation of internal representation (e.g., removal of `id` attribute) → Output of resulting markup (e.g., `<p>foo</p>`)_
 
-HTML Minifier Next can’t know that the original markup represented only part of the tree. It parses a complete tree and, in doing so, loses information about the input being malformed or partial. As a result, it can’t emit a partial or malformed tree.
+HMN can’t know that the original markup represented only part of the tree. It parses a complete tree and, in doing so, loses information about the input being malformed or partial. As a result, it can’t emit a partial or malformed tree.
 
 To validate HTML markup, use [the W3C validator](https://validator.w3.org/) or one of [several validator packages](https://meiert.com/blog/html-validator-packages/).
 

package/cli.js

@@ -33,7 +33,6 @@ import { Command } from 'commander';
 import { minify } from './src/htmlminifier.js';
 
 const require = createRequire(import.meta.url);
-
 const pkg = require('./package.json');
 
 const program = new Command();

package/dist/htmlminifier.cjs

@@ -21,7 +21,7 @@ async function replaceAsync(str, regex, asyncFn) {
 
 /*!
  * HTML Parser By John Resig (ejohn.org)
- * Modified by Juriy "kangax" Zaytsev
+ * Modified by Juriy “kangax” Zaytsev
  * Original code by Erik Arvidsson, Mozilla Public License
  * http://erik.eae.net/simplehtmlparser/simplehtmlparser.js
  */
@@ -132,7 +132,7 @@ class HTMLParser {
       if (!lastTag || !special.has(lastTag)) {
         let textEnd = html.indexOf('<');
         if (textEnd === 0) {
-          // Comment:
+          // Comment
           if (/^<!--/.test(html)) {
             const commentEnd = html.indexOf('-->');
 
@@ -160,7 +160,7 @@ class HTMLParser {
             }
           }
 
-          // Doctype:
+          // Doctype
           const doctypeMatch = html.match(doctype);
           if (doctypeMatch) {
             if (handler.doctype) {
@@ -171,7 +171,7 @@ class HTMLParser {
             continue;
           }
 
-          // End tag:
+          // End tag
           const endTagMatch = html.match(endTag);
           if (endTagMatch) {
             html = html.substring(endTagMatch[0].length);
@@ -180,7 +180,7 @@ class HTMLParser {
             continue;
           }
 
-          // Start tag:
+          // Start tag
           const startTagMatch = parseStartTag(html);
           if (startTagMatch) {
             html = startTagMatch.rest;
@@ -273,11 +273,41 @@ class HTMLParser {
       }
     }
 
-    async function closeIfFound(tagName) {
-      if (findTag(tagName) >= 0) {
-        await parseEndTag('', tagName);
+    function findTagInCurrentTable(tagName) {
+      let pos;
+      const needle = tagName.toLowerCase();
+      for (pos = stack.length - 1; pos >= 0; pos--) {
+        const currentTag = stack[pos].tag.toLowerCase();
+        if (currentTag === needle) {
+          return pos;
+        }
+        // Stop searching if we hit a table boundary
+        if (currentTag === 'table') {
+          break;
+        }
+      }
+      return -1;
+    }
+
+    async function parseEndTagAt(pos) {
+      // Close all open elements up to pos (mirrors parseEndTag’s core branch)
+      for (let i = stack.length - 1; i >= pos; i--) {
+        if (handler.end) {
+          await handler.end(stack[i].tag, stack[i].attrs, true);
+        }
+      }
+      stack.length = pos;
+      lastTag = pos && stack[pos - 1].tag;
+    }
+
+    async function closeIfFoundInCurrentTable(tagName) {
+      const pos = findTagInCurrentTable(tagName);
+      if (pos >= 0) {
+        // Close at the specific index to avoid re-searching
+        await parseEndTagAt(pos);
         return true;
       }
+      return false;
     }
 
     async function handleStartTag(match) {
@@ -288,10 +318,15 @@ class HTMLParser {
         if (lastTag === 'p' && nonPhrasing.has(tagName)) {
           await parseEndTag('', lastTag);
         } else if (tagName === 'tbody') {
-          await closeIfFound('thead');
+          await closeIfFoundInCurrentTable('thead');
         } else if (tagName === 'tfoot') {
-          if (!await closeIfFound('tbody')) {
-            await closeIfFound('thead');
+          if (!await closeIfFoundInCurrentTable('tbody')) {
+            await closeIfFoundInCurrentTable('thead');
+          }
+        } else if (tagName === 'thead') {
+          // If a `tbody` or `tfoot` is open in the current table, close it
+          if (!await closeIfFoundInCurrentTable('tbody')) {
+            await closeIfFoundInCurrentTable('tfoot');
           }
         }
         if (tagName === 'col' && findTag('colgroup') < 0) {

package/dist/htmlminifier.esm.bundle.js

@@ -60211,7 +60211,7 @@ async function replaceAsync(str, regex, asyncFn) {
 
 /*!
  * HTML Parser By John Resig (ejohn.org)
- * Modified by Juriy "kangax" Zaytsev
+ * Modified by Juriy “kangax” Zaytsev
  * Original code by Erik Arvidsson, Mozilla Public License
  * http://erik.eae.net/simplehtmlparser/simplehtmlparser.js
  */
@@ -60322,7 +60322,7 @@ class HTMLParser {
       if (!lastTag || !special.has(lastTag)) {
         let textEnd = html.indexOf('<');
         if (textEnd === 0) {
-          // Comment:
+          // Comment
           if (/^<!--/.test(html)) {
             const commentEnd = html.indexOf('-->');
 
@@ -60350,7 +60350,7 @@ class HTMLParser {
             }
           }
 
-          // Doctype:
+          // Doctype
           const doctypeMatch = html.match(doctype);
           if (doctypeMatch) {
             if (handler.doctype) {
@@ -60361,7 +60361,7 @@ class HTMLParser {
             continue;
           }
 
-          // End tag:
+          // End tag
           const endTagMatch = html.match(endTag);
           if (endTagMatch) {
             html = html.substring(endTagMatch[0].length);
@@ -60370,7 +60370,7 @@ class HTMLParser {
             continue;
           }
 
-          // Start tag:
+          // Start tag
           const startTagMatch = parseStartTag(html);
           if (startTagMatch) {
             html = startTagMatch.rest;
@@ -60463,11 +60463,41 @@ class HTMLParser {
       }
     }
 
-    async function closeIfFound(tagName) {
-      if (findTag(tagName) >= 0) {
-        await parseEndTag('', tagName);
+    function findTagInCurrentTable(tagName) {
+      let pos;
+      const needle = tagName.toLowerCase();
+      for (pos = stack.length - 1; pos >= 0; pos--) {
+        const currentTag = stack[pos].tag.toLowerCase();
+        if (currentTag === needle) {
+          return pos;
+        }
+        // Stop searching if we hit a table boundary
+        if (currentTag === 'table') {
+          break;
+        }
+      }
+      return -1;
+    }
+
+    async function parseEndTagAt(pos) {
+      // Close all open elements up to pos (mirrors parseEndTag’s core branch)
+      for (let i = stack.length - 1; i >= pos; i--) {
+        if (handler.end) {
+          await handler.end(stack[i].tag, stack[i].attrs, true);
+        }
+      }
+      stack.length = pos;
+      lastTag = pos && stack[pos - 1].tag;
+    }
+
+    async function closeIfFoundInCurrentTable(tagName) {
+      const pos = findTagInCurrentTable(tagName);
+      if (pos >= 0) {
+        // Close at the specific index to avoid re-searching
+        await parseEndTagAt(pos);
         return true;
       }
+      return false;
     }
 
     async function handleStartTag(match) {
@@ -60478,10 +60508,15 @@ class HTMLParser {
         if (lastTag === 'p' && nonPhrasing.has(tagName)) {
           await parseEndTag('', lastTag);
         } else if (tagName === 'tbody') {
-          await closeIfFound('thead');
+          await closeIfFoundInCurrentTable('thead');
         } else if (tagName === 'tfoot') {
-          if (!await closeIfFound('tbody')) {
-            await closeIfFound('thead');
+          if (!await closeIfFoundInCurrentTable('tbody')) {
+            await closeIfFoundInCurrentTable('thead');
+          }
+        } else if (tagName === 'thead') {
+          // If a `tbody` or `tfoot` is open in the current table, close it
+          if (!await closeIfFoundInCurrentTable('tbody')) {
+            await closeIfFoundInCurrentTable('tfoot');
           }
         }
         if (tagName === 'col' && findTag('colgroup') < 0) {

package/dist/htmlminifier.umd.bundle.js

@@ -60217,7 +60217,7 @@
 
 	/*!
 	 * HTML Parser By John Resig (ejohn.org)
-	 * Modified by Juriy "kangax" Zaytsev
+	 * Modified by Juriy “kangax” Zaytsev
 	 * Original code by Erik Arvidsson, Mozilla Public License
 	 * http://erik.eae.net/simplehtmlparser/simplehtmlparser.js
 	 */
@@ -60328,7 +60328,7 @@
 	      if (!lastTag || !special.has(lastTag)) {
 	        let textEnd = html.indexOf('<');
 	        if (textEnd === 0) {
-	          // Comment:
+	          // Comment
 	          if (/^<!--/.test(html)) {
 	            const commentEnd = html.indexOf('-->');
 
@@ -60356,7 +60356,7 @@
 	            }
 	          }
 
-	          // Doctype:
+	          // Doctype
 	          const doctypeMatch = html.match(doctype);
 	          if (doctypeMatch) {
 	            if (handler.doctype) {
@@ -60367,7 +60367,7 @@
 	            continue;
 	          }
 
-	          // End tag:
+	          // End tag
 	          const endTagMatch = html.match(endTag);
 	          if (endTagMatch) {
 	            html = html.substring(endTagMatch[0].length);
@@ -60376,7 +60376,7 @@
 	            continue;
 	          }
 
-	          // Start tag:
+	          // Start tag
 	          const startTagMatch = parseStartTag(html);
 	          if (startTagMatch) {
 	            html = startTagMatch.rest;
@@ -60469,11 +60469,41 @@
 	      }
 	    }
 
-	    async function closeIfFound(tagName) {
-	      if (findTag(tagName) >= 0) {
-	        await parseEndTag('', tagName);
+	    function findTagInCurrentTable(tagName) {
+	      let pos;
+	      const needle = tagName.toLowerCase();
+	      for (pos = stack.length - 1; pos >= 0; pos--) {
+	        const currentTag = stack[pos].tag.toLowerCase();
+	        if (currentTag === needle) {
+	          return pos;
+	        }
+	        // Stop searching if we hit a table boundary
+	        if (currentTag === 'table') {
+	          break;
+	        }
+	      }
+	      return -1;
+	    }
+
+	    async function parseEndTagAt(pos) {
+	      // Close all open elements up to pos (mirrors parseEndTag’s core branch)
+	      for (let i = stack.length - 1; i >= pos; i--) {
+	        if (handler.end) {
+	          await handler.end(stack[i].tag, stack[i].attrs, true);
+	        }
+	      }
+	      stack.length = pos;
+	      lastTag = pos && stack[pos - 1].tag;
+	    }
+
+	    async function closeIfFoundInCurrentTable(tagName) {
+	      const pos = findTagInCurrentTable(tagName);
+	      if (pos >= 0) {
+	        // Close at the specific index to avoid re-searching
+	        await parseEndTagAt(pos);
 	        return true;
 	      }
+	      return false;
 	    }
 
 	    async function handleStartTag(match) {
@@ -60484,10 +60514,15 @@
 	        if (lastTag === 'p' && nonPhrasing.has(tagName)) {
 	          await parseEndTag('', lastTag);
 	        } else if (tagName === 'tbody') {
-	          await closeIfFound('thead');
+	          await closeIfFoundInCurrentTable('thead');
 	        } else if (tagName === 'tfoot') {
-	          if (!await closeIfFound('tbody')) {
-	            await closeIfFound('thead');
+	          if (!await closeIfFoundInCurrentTable('tbody')) {
+	            await closeIfFoundInCurrentTable('thead');
+	          }
+	        } else if (tagName === 'thead') {
+	          // If a `tbody` or `tfoot` is open in the current table, close it
+	          if (!await closeIfFoundInCurrentTable('tbody')) {
+	            await closeIfFoundInCurrentTable('tfoot');
 	          }
 	        }
 	        if (tagName === 'col' && findTag('colgroup') < 0) {