html-minifier-next 8.5.0 → 8.5.2

package/README.md

@@ -151,18 +151,18 @@ Options can be used in config files (camelCase) or via CLI flags (kebab-case wit
 | `customEventAttributes`<br>`--custom-event-attributes` | Array of regexes that allow to support custom event attributes (e.g., `ng-click`)—use with `minifyJS` | `[ /^on[a-z]{3,}$/ ]` |
 | `decodeEntities`<br>`--decode-entities` | Use direct Unicode characters whenever possible | `false` |
 | `ignoreCustomComments`<br>`--ignore-custom-comments` | Array of regexes that allow to ignore matching comments | `[ /^!/, /^\s*#/ ]` |
-| `ignoreCustomFragments`<br>`--ignore-custom-fragments` | Array of regexes that allow to ignore certain fragments, when matched (e.g., `<?php … ?>`, `{{ … }}`, etc.) | `[ /<%[\s\S]*?%>/, /<\?[\s\S]*?\?>/ ]` |
+| `ignoreCustomFragments`<br>`--ignore-custom-fragments` | Array of regexes that allow to ignore certain fragments, when matched (e.g., `<?php … ?>`, `{{ … }}`, etc.; see [“Minifying server-side templates”](#minifying-server-side-templates)) | `[ /<%[\s\S]*?%>/, /<\?[\s\S]*?\?>/ ]` |
 | `includeAutoGeneratedTags`<br>`--include-auto-generated-tags` | Insert elements generated by HTML parser | `false` |
 | `inlineCustomElements`<br>`--inline-custom-elements` | Array of names of custom elements which are inline, for whitespace handling—use with `collapseWhitespace` | `[]` |
 | `keepClosingSlash`<br>`--keep-closing-slash` | Keep the trailing slash on void elements and other start tags that carry one, and read it as closing the element | `false` |
 | `maxInputLength`<br>`--max-input-length` | Maximum input length to prevent ReDoS attacks (disabled by default) | `undefined` |
-| `maxLineLength`<br>`--max-line-length` | Specify a maximum line length; compressed output will be split by newlines at valid HTML split-points | `undefined` |
+| `maxLineLength`<br>`--max-line-length` | Specify a maximum line length; output will be split by newlines in tags only (between attributes or before a tag’s `>`), where they can’t change the page, so lines may run longer | `undefined` |
 | `mergeScripts`<br>`--merge-scripts` | Merge consecutive inline `script` elements into one (only merges compatible scripts with same `type`, matching `async`/`defer`/`nomodule`/`nonce`) | `false` |
 | `minifyCSS`<br>`--minify-css` | Minify CSS in `style` elements and attributes (uses [Lightning CSS](https://lightningcss.dev/)) | `false` (could be `true`, `Object`, `Function(text, type)`) |
 | `minifyJS`<br>`--minify-js` | Minify JavaScript in `script` elements and event attributes (uses [Terser](https://terser.org/) or [SWC](https://swc.rs/)) | `false` (could be `true`, `Object`, `Function(text, inline)`) |
 | `minifySVG`<br>`--minify-svg` | Minify SVG elements (uses [SVGO](https://svgo.dev/)) | `false` (could be `true`, `Object`) |
 | `minifyURLs`<br>`--minify-urls` | Minify URLs in various attributes | `false` (could be `true`, `String`, `Object`, `Function(text)`) |
-| `noNewlinesBeforeTagClose`<br>`--no-newlines-before-tag-close` | Never add a newline before a tag that closes an element—use with `maxLineLength` | `false` |
+| `noNewlinesBeforeTagClose`<br>`--no-newlines-before-tag-close` | Never split a line in a tag that closes an element—use with `maxLineLength` | `false` |
 | `partialMarkup`<br>`--partial-markup` | Treat input as a partial HTML fragment, preserving stray end tags (closing tags without opening tags) and preventing auto-closing of unclosed tags at end of input | `false` |
 | `preserveLineBreaks`<br>`--preserve-line-breaks` | Always collapse to one line break (never remove it entirely) when whitespace between tags includes a line break—use with [`collapseWhitespace`](#combining-whitespace-options) | `false` |
 | `preventAttributesEscaping`<br>`--prevent-attributes-escaping` | Prevents the escaping of the values of attributes | `false` |
@@ -181,7 +181,7 @@ Options can be used in config files (camelCase) or via CLI flags (kebab-case wit
 | `sortAttributes`<br>`--sort-attributes` | [Sort attributes by frequency](#sorting-attributes-and-style-classes) | `false` |
 | `sortClassNames`<br>`--sort-class-names` | [Sort style classes by frequency](#sorting-attributes-and-style-classes) | `false` |
 | `strictCustomFragments`<br>`--strict-custom-fragments` | [Reject `ignoreCustomFragments` patterns that risk catastrophic backtracking](#redos-protection) (rather than warning about them) | `false` |
-| `trimCustomFragments`<br>`--trim-custom-fragments` | Trim whitespace around custom fragments (`ignoreCustomFragments`)—use with `collapseWhitespace` | `false` |
+| `trimCustomFragments`<br>`--trim-custom-fragments` | Trim whitespace around custom fragments (`ignoreCustomFragments`) where it does not affect the output (see [“Minifying server-side templates”](#minifying-server-side-templates))—use with `collapseWhitespace` | `false` |
 | `useShortDoctype`<br>`--use-short-doctype` | [Replaces the doctype with the short HTML doctype](https://perfectionkills.com/experimenting-with-html-minifier/#use_short_doctype) | `false` |
 
 ### API-only options
@@ -680,6 +680,14 @@ For partial HTML fragments (such as template includes, SSI fragments, or closing
 
 To validate complete HTML markup, use [the W3C validator](https://validator.w3.org/) or one of [several validator packages](https://meiert.com/blog/html-validator-packages/).
 
+### Minifying server-side templates
+
+By default, `ignoreCustomFragments` preserves `<? … ?>` and `<% … %>` blocks, so PHP, ERB, JSP, and ASP templates can be minified as part of a build, with the markup, CSS, and JavaScript around those blocks being minified as usual. For includes and other partials, add `partialMarkup`.
+
+Whitespace next to template blocks is collapsed but kept, as it may matter once the template renders. `trimCustomFragments` removes it where HTML Minifier Next would remove whitespace anyway, as between block-level elements: `<ul> <?php foreach ($items as $item): ?> <li>` loses it, `Hello <?= $name ?>!` keeps it. Tags keep the spacing of their source, and whitespace next to template blocks in attribute values, CSS, and JavaScript is always kept.
+
+Where pages are rendered ahead of serving, as with static exports or full-page caches, you can also minify the rendered HTML instead, which makes this a non-issue.
+
 ### Regex options and flags
 
 `customAttrAssign` and `customAttrSurround` patterns are merged into one attribute pattern which carries no flags of its own. `i` and `s` are written into each pattern’s source instead, so they survive the merge. `u`, `v`, and `m` cannot be, and none of them fails loudly when dropped: `u` and `v` only narrow what syntax is legal, so a source valid under either stays valid without it and quietly matches something else—a dropped `u` leaves `\p{L}` matching the literal text `p{L}`—while a dropped `m` leaves `^` and `$` matching at the ends of the input rather than of each line.

package/dist/types/htmlminifier.d.ts

@@ -244,7 +244,8 @@ export type MinifierOptions = {
     maxInputLength?: number;
     /**
      * Maximum line length for the output. When set the minifier will wrap
-     * output to the given number of characters where possible.
+     * output to the given number of characters where possible, splitting
+     * lines only in tags—between attributes or before a tag’s `>`.
      *
      * Default: No limit
      */
@@ -308,8 +309,8 @@ export type MinifierOptions = {
      */
     minifySVG?: boolean | Object;
     /**
-     * When wrapping lines, prevent inserting a newline directly before a
-     * closing tag (useful to keep tags like `</a>` on the same line).
+     * When wrapping lines, never split a line in an end tag (e.g., keeps
+     * `</a>` from becoming `</a` and `>` on two lines).
      *
      * Default: `false`
      */
@@ -492,9 +493,10 @@ export type MinifierOptions = {
      */
     sortClassNames?: boolean | ((value: string) => string);
     /**
-     * When true, whitespace around ignored custom fragments may be trimmed
-     * more aggressively. This affects how preserved fragments interact with
-     * surrounding whitespace collapse.
+     * When true, whitespace around ignored custom fragments is removed rather
+     * than collapsed where the minifier removes whitespace anyway (e.g., between
+     * block-level elements). Whitespace in tags, attribute values, CSS, and
+     * JavaScript is kept.
      *
      * Default: `false`
      */

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

@@ -1 +1 @@
-{"version":3,"file":"htmlminifier.d.ts","sourceRoot":"","sources":["../../src/htmlminifier.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"htmlminifier.d.ts","sourceRoot":"","sources":["../../src/htmlminifier.js"],"names":[],"mappings":"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"}

package/dist/types/htmlparser.d.ts

@@ -11,7 +11,6 @@ export type HTMLParserHandler = {
     customAttrSurround?: RegExp[][] | undefined;
     customAttrAssign?: RegExp[] | undefined;
 };
-export declare const endTag: RegExp;
 export declare class HTMLParser {
     html: string;
     handler: HTMLParserHandler;

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

@@ -1 +1 @@
-{"version":3,"file":"htmlparser.d.ts","sourceRoot":"","sources":["../../src/htmlparser.js"],"names":[],"mappings":"AAeG,YAYG,iBAAiB,GAZV;IACR,KAAK,CAAC,WAAW;IACjB,GAAG,CAAC,WAAW;IACf,KAAK,CAAC,WAAW;IACjB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IACnB,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CACxC,CAAmB;AA0CvB,eAAO,MAAM,MAAM,QAA8C,CAAC;AAoLlE,qBAAa,UAAU;IAMd,IAAI;IACJ,OAAO;IANd;;;OAGG;IACH,YAAY,IAAI,EAHL,MAGK,EAAE,OAAO,EAFd,iBAEc,EAGxB;IAEK,KAAK,kBAwyBV;CACF"}
+{"version":3,"file":"htmlparser.d.ts","sourceRoot":"","sources":["../../src/htmlparser.js"],"names":[],"mappings":"AAeG,YAYG,iBAAiB,GAZV;IACR,KAAK,CAAC,WAAW;IACjB,GAAG,CAAC,WAAW;IACf,KAAK,CAAC,WAAW;IACjB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IACnB,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CACxC,CAAmB;AA6NvB,qBAAa,UAAU;IAMd,IAAI;IACJ,OAAO;IANd;;;OAGG;IACH,YAAY,IAAI,EAHL,MAGK,EAAE,OAAO,EAFd,iBAEc,EAGxB;IAEK,KAAK,kBA2yBV;CACF"}

package/html-minifier-next.schema.json

@@ -132,7 +132,7 @@
       }
     },
     "ignoreCustomFragments": {
-      "description": "Array of regexes that allow to ignore certain fragments, when matched (e.g., `<?php … ?>`, `{{ … }}`)",
+      "description": "Array of regexes that allow to ignore certain fragments, when matched (e.g., `<?php … ?>`, `{{ … }}`, etc.)",
       "type": [
         "string",
         "array"
@@ -165,7 +165,7 @@
       "minimum": 0
     },
     "maxLineLength": {
-      "description": "Specify a maximum line length; compressed output will be split by newlines at valid HTML split-points",
+      "description": "Specify a maximum line length; output will be split by newlines in tags only (between attributes or before a tag’s `>`), where they can’t change the page, so lines may run longer",
       "type": "integer",
       "minimum": 0
     },
@@ -203,7 +203,7 @@
       ]
     },
     "noNewlinesBeforeTagClose": {
-      "description": "Never add a newline before a tag that closes an element—use with `--max-line-length`",
+      "description": "Never split a line in a tag that closes an element—use with `--max-line-length`",
       "type": "boolean"
     },
     "partialMarkup": {
@@ -253,7 +253,7 @@
       "type": "boolean"
     },
     "removeEmptyElementsExcept": {
-      "description": "Array of elements to preserve (e.g., `td`, `<span aria-hidden=\"true\">`)—use with `--remove-empty-elements`",
+      "description": "Array of elements to preserve (e.g., `td`, `<span aria-hidden=\"true\">`, etc.)—use with `--remove-empty-elements`",
       "type": [
         "string",
         "array"
@@ -290,7 +290,7 @@
       "type": "boolean"
     },
     "trimCustomFragments": {
-      "description": "Trim whitespace around custom fragments (`--ignore-custom-fragments`)—use with `--collapse-whitespace`",
+      "description": "Trim whitespace around custom fragments (`--ignore-custom-fragments`) where it does not affect the output—use with `--collapse-whitespace`",
       "type": "boolean"
     },
     "strictCustomFragments": {

package/package.json

@@ -17,7 +17,7 @@
     "@commitlint/cli": "^21.2.2",
     "@eslint/js": "^10.0.1",
     "@swc/core": "^1.16.2",
-    "@types/node": "^26.5.1",
+    "@types/node": "^26.6.1",
     "eslint": "^10.10.0",
     "globals": "^17.12.0",
     "typescript": "^7.0.2",
@@ -95,5 +95,5 @@
   },
   "type": "module",
   "types": "dist/types/htmlminifier.d.ts",
-  "version": "8.5.0"
+  "version": "8.5.2"
 }

package/src/htmlminifier.js

@@ -1,4 +1,4 @@
-import { HTMLParser, endTag } from './htmlparser.js';
+import { HTMLParser } from './htmlparser.js';
 import TokenChain from './tokenchain.js';
 import { presets, getPreset, getPresetNames } from './presets.js';
 
@@ -297,7 +297,8 @@ import { toFragment, replaceCustomFragments } from './lib/fragments.js';
  *
  * @prop {number} [maxLineLength]
  *  Maximum line length for the output. When set the minifier will wrap
- *  output to the given number of characters where possible.
+ *  output to the given number of characters where possible, splitting
+ *  lines only in tags—between attributes or before a tag’s `>`.
  *
  *  Default: No limit
  *
@@ -350,8 +351,8 @@ import { toFragment, replaceCustomFragments } from './lib/fragments.js';
  *  Default: `false`
  *
  * @prop {boolean} [noNewlinesBeforeTagClose]
- *  When wrapping lines, prevent inserting a newline directly before a
- *  closing tag (useful to keep tags like `</a>` on the same line).
+ *  When wrapping lines, never split a line in an end tag (e.g., keeps
+ *  `</a>` from becoming `</a` and `>` on two lines).
  *
  *  Default: `false`
  *
@@ -512,9 +513,10 @@ import { toFragment, replaceCustomFragments } from './lib/fragments.js';
  *  Default: `false`
  *
  * @prop {boolean} [trimCustomFragments]
- *  When true, whitespace around ignored custom fragments may be trimmed
- *  more aggressively. This affects how preserved fragments interact with
- *  surrounding whitespace collapse.
+ *  When true, whitespace around ignored custom fragments is removed rather
+ *  than collapsed where the minifier removes whitespace anyway (e.g., between
+ *  block-level elements). Whitespace in tags, attribute values, CSS, and
+ *  JavaScript is kept.
  *
  *  Default: `false`
  *
@@ -623,6 +625,7 @@ const DEFAULT_JS_TYPES = new Set(['', 'text/javascript', 'application/javascript
 const RE_START_TAG = /^<[^/!]/;
 const RE_END_TAG = /^<\//;
 const RE_WHITESPACE_ONLY = /^\s+$/;
+const RE_TABS = /\t/g;
 const RE_TRAILING_WHITESPACE = /\s$/;
 
 // Pre-compiled patterns for `htmlmin:ignore` block content analysis
@@ -1045,6 +1048,8 @@ async function minifyHTML(value, options, partialMarkup) {
 
   /** @type {string[]} */
   const buffer = [];
+  // Parallel to `buffer`: whether an entry belongs to a start or end tag, the only place lines may break
+  const bufferTags = options.maxLineLength ? /** @type {boolean[]} */ ([]) : null;
   /** @type {string} */
   let charsPrevTag = '';
   let currentChars = '';
@@ -1065,6 +1070,15 @@ async function minifyHTML(value, options, partialMarkup) {
   const ignoredMarkupChunks = [];
   /** @type {Array<RegExpExecArray | null>} */
   const ignoredCustomMarkupChunks = [];
+  // Custom fragments whose surrounding whitespace is never trimmed: in tags, where it
+  // separates attributes, and in CSS and JavaScript, where minifiers can’t judge it
+  /** @type {Set<number>} */
+  const customMarkupInTags = new Set();
+  /** @type {Set<number>} */
+  const customMarkupInCode = new Set();
+  // Attributes joined with the custom fragments they run into, to be written as they are
+  /** @type {WeakSet<HTMLAttribute>} */
+  const opaqueAttrs = new WeakSet();
   /** @type {string | undefined} */
   let uidIgnore;
   /** @type {RegExp | undefined} */
@@ -1075,6 +1089,8 @@ async function minifyHTML(value, options, partialMarkup) {
   let uidPattern;
   /** @type {RegExp | undefined} */
   let uidAttrLeadingPattern;
+  /** @type {RegExp | undefined} */
+  let uidAttrExactPattern;
   // Create inline tags/text sets with custom elements
   const customElementsInput = options.inlineCustomElements ?? [];
   const customElementsArr = Array.isArray(customElementsInput) ? customElementsInput : Array.from(customElementsInput);
@@ -1149,12 +1165,14 @@ async function minifyHTML(value, options, partialMarkup) {
         uidAttr = uniqueId(value);
         uidPattern = new RegExp('(\\s*)' + uidAttr + '([0-9]+)' + uidAttr + '(\\s*)', 'g');
         uidAttrLeadingPattern = new RegExp('^\\s*' + uidAttr + '(\\d+)' + uidAttr);
+        uidAttrExactPattern = new RegExp('^' + uidAttr + '(\\d+)' + uidAttr + '$');
 
         if (options.minifyCSS !== identity) {
           options.minifyCSS = (function (/** @type {ProcessedOptions['minifyCSS']} */ fn) {
             return function (/** @type {string} */ text, /** @type {string | undefined} */ type, /** @type {ProcessedOptions['cssContext']} */ context) {
               text = text.replace(/** @type {RegExp} */ (uidPattern), function (/** @type {string} */ _match, /** @type {string} */ _prefix, /** @type {string} */ index) {
                 const chunks = ignoredCustomMarkupChunks[+index];
+                customMarkupInCode.add(+index);
                 return (chunks?.[1] ?? '') + uidAttr + index + uidAttr + (chunks?.[2] ?? '');
               });
 
@@ -1168,6 +1186,7 @@ async function minifyHTML(value, options, partialMarkup) {
             return function (/** @type {string} */ text, /** @type {boolean | undefined} */ inline, /** @type {boolean | undefined} */ isModule) {
               return fn(text.replace(/** @type {RegExp} */ (uidPattern), function (/** @type {string} */ _match, /** @type {string} */ _prefix, /** @type {string} */ index) {
                 const chunks = ignoredCustomMarkupChunks[+index];
+                customMarkupInCode.add(+index);
                 return (chunks?.[1] ?? '') + uidAttr + index + uidAttr + (chunks?.[2] ?? '');
               }), inline, isModule);
             };
@@ -1183,6 +1202,77 @@ async function minifyHTML(value, options, partialMarkup) {
     value = replaceCustomFragments(value, customFragments, replaceFragment);
   }
 
+  // Record the custom fragments in (part of) a tag
+  function markTagFragments(/** @type {string} */ str) {
+    for (const uidMatch of str.matchAll(/** @type {RegExp} */ (uidPattern))) {
+      customMarkupInTags.add(+(uidMatch[2] ?? 0));
+    }
+  }
+
+  // Source text of an attribute, as far as it matters
+  function rawAttr(/** @type {HTMLAttribute} */ attr) {
+    if (opaqueAttrs.has(attr)) {
+      return attr.name;
+    }
+    let raw = attr.name;
+    // Skip values the parser filled in for bare boolean attributes
+    if (attr.value !== undefined && !(attr.quote === '' && attr.value === attr.name)) {
+      raw += (attr.customAssign ?? '=') + (attr.quote ?? '') + attr.value + (attr.quote ?? '');
+    }
+    return (attr.customOpen ?? '') + raw + (attr.customClose ?? '');
+  }
+
+  /**
+   * Join each attribute a custom fragment runs into without whitespace with that fragment,
+   * so that no later step separates, drops, changes, or reorders them
+   * @param {HTMLAttribute[]} attrs - Joined in place
+   * @returns {boolean} Whether the first attribute runs into the tag name
+   */
+  function joinFragmentAttrs(attrs) {
+    const pattern = /** @type {RegExp} */ (uidAttrExactPattern);
+    let joinsTag = false;
+    let writeIndex = 0;
+    // Padding of the previous attribute if that is a fragment without value
+    /** @type {RegExpExecArray | null | undefined} */
+    let prevChunks = null;
+    for (const attr of attrs) {
+      const uidMatch = pattern.exec(attr.name);
+      const chunks = uidMatch ? ignoredCustomMarkupChunks[+(uidMatch[1] ?? 0)] : null;
+      const joins = prevChunks ? prevChunks[2] === '' : chunks?.[1] === '';
+      prevChunks = attr.value === undefined ? chunks : null;
+      if (!joins) {
+        attrs[writeIndex++] = attr;
+        continue;
+      }
+      const prev = writeIndex ? attrs[writeIndex - 1] : undefined;
+      if (!prev) {
+        joinsTag = true;
+      }
+      /** @type {HTMLAttribute} */
+      const joined = { name: (prev ? rawAttr(prev) : '') + rawAttr(attr), customAssign: '=', customOpen: '', customClose: '', quote: '' };
+      opaqueAttrs.add(joined);
+      attrs[prev ? writeIndex - 1 : writeIndex++] = joined;
+    }
+    attrs.length = writeIndex;
+    return joinsTag;
+  }
+
+  /**
+   * Restore the whitespace on one side of a custom fragment
+   * @param {string} str - Whitespace the minifier left there and the fragment’s own padding
+   * @param {boolean} trim
+   * @param {boolean} leading
+   */
+  function restoreFragmentSide(str, trim, leading) {
+    if (!str) {
+      return str;
+    }
+    return collapseWhitespace(str, {
+      preserveLineBreaks: options.preserveLineBreaks,
+      conservativeCollapse: !trim
+    }, leading, !leading);
+  }
+
   function canCollapseWhitespace(/** @type {string} */ tag, /** @type {HTMLAttribute[]} */ attrs) {
     return options.canCollapseWhitespace(tag, attrs, defaultCanCollapseWhitespace);
   }
@@ -1191,12 +1281,22 @@ async function minifyHTML(value, options, partialMarkup) {
     return options.canTrimWhitespace(tag, attrs, defaultCanTrimWhitespace);
   }
 
+  function bufferPush(/** @type {string} */ entry, /** @type {boolean} */ isTag) {
+    buffer.push(entry);
+    bufferTags?.push(isTag);
+  }
+
+  function bufferTruncate(/** @type {number} */ length) {
+    buffer.length = Math.max(0, length);
+    if (bufferTags) bufferTags.length = buffer.length;
+  }
+
   function removeStartTag() {
     let index = buffer.length - 1;
     while (index > 0 && !RE_START_TAG.test(buffer[index] ?? '')) {
       index--;
     }
-    buffer.length = Math.max(0, index);
+    bufferTruncate(index);
   }
 
   // Whether the element being parsed holds text rather than markup. The namespace decides
@@ -1252,13 +1352,14 @@ async function minifyHTML(value, options, partialMarkup) {
     const noTrim = stackNoTrimWhitespace.length > 0;
     if (index < buffer.length - 1 && (keepsWhitespace() || noTrim) && RE_END_TAG.test(buffer[index] ?? '')) {
       buffer.splice(index, 1);
+      bufferTags?.splice(index, 1);
       // Only collapsed whitespace can merge
       if (options.collapseWhitespace && !noTrim) {
         mergeWhitespaceRuns(index);
       }
       return;
     }
-    buffer.length = Math.max(0, index);
+    bufferTruncate(index);
   }
 
   // Look for trailing whitespaces, bypass any inline tags
@@ -1458,7 +1559,7 @@ async function minifyHTML(value, options, partialMarkup) {
     if (text) {
       hasChars = true;
     }
-    buffer.push(text);
+    bufferPush(text, false);
   }
 
   // Comment finalization (sync): Optional tag handling, `htmlmin:ignore` whitespace collapsing, buffer push
@@ -1569,7 +1670,7 @@ async function minifyHTML(value, options, partialMarkup) {
       }
     }
 
-    buffer.push(comment);
+    bufferPush(comment, false);
   }
 
   // Inline scripts are minified one at a time as the parse reaches them, which serializes
@@ -1752,7 +1853,11 @@ async function minifyHTML(value, options, partialMarkup) {
       const needsXMLSlash = unary && Boolean(options.insideSVG) && Boolean(options.minifySVG);
       const hasUnarySlash = needsXMLSlash || (unarySlash && (useNameParentForTag ? optionsParent : options).keepClosingSlash);
 
-      buffer.push(openTag);
+      bufferPush(openTag, true);
+
+      const fragmentJoinsTag = uidAttrExactPattern ? joinFragmentAttrs(attrs) : false;
+      // Whatever runs into the tag name has to stay first
+      const tagFragment = fragmentJoinsTag ? attrs.shift() : undefined;
 
       // Remove duplicate attributes (per HTML spec, first occurrence wins)
       // Duplicate attributes result in invalid HTML
@@ -1763,11 +1868,17 @@ async function minifyHTML(value, options, partialMarkup) {
         // By the time tags are processed, `createSortFns` has replaced any truthy non-function value
         /** @type {(tag: string, attrs: HTMLAttribute[]) => void} */ (options.sortAttributes)(tag, attrs);
       }
+      if (tagFragment) {
+        attrs.unshift(tagFragment);
+      }
 
       const attrResults = new Array(attrs.length);
       let anyThenable = false;
       for (let i = 0; i < attrs.length; i++) {
-        const result = normalizeAttr(/** @type {HTMLAttribute} */ (attrs[i]), attrs, tag, options, minifyHTML);
+        const attr = /** @type {HTMLAttribute} */ (attrs[i]);
+        const result = opaqueAttrs.has(attr)
+          ? { name: attr.name, value: undefined, attr }
+          : normalizeAttr(attr, attrs, tag, options, minifyHTML);
         if (!anyThenable && isThenable(result)) {
           anyThenable = true;
         }
@@ -1785,11 +1896,22 @@ async function minifyHTML(value, options, partialMarkup) {
         }
       }
       if (lastKeptIndex !== -1) {
-        buffer.push(' ');
+        if (!fragmentJoinsTag) {
+          bufferPush(' ', true);
+        }
         for (let i = 0; i <= lastKeptIndex; i++) {
           const normalizedAttr = normalizedAttrs[i];
           if (normalizedAttr) {
-            buffer.push(buildAttr(normalizedAttr, hasUnarySlash, options, i === lastKeptIndex, uidAttr));
+            if (uidAttr && normalizedAttr.name.includes(uidAttr)) {
+              markTagFragments(normalizedAttr.name);
+            }
+            const builtAttr = buildAttr(normalizedAttr, hasUnarySlash, options, i === lastKeptIndex, uidAttr);
+            // One entry with the tag name, so that no line break can come between them
+            if (i === 0 && fragmentJoinsTag) {
+              buffer[buffer.length - 1] += builtAttr;
+            } else {
+              bufferPush(builtAttr, true);
+            }
           }
         }
       } else if (optional && optionalStartTags.has(tag)) {
@@ -1797,7 +1919,7 @@ async function minifyHTML(value, options, partialMarkup) {
         optionalStartTag = tag;
       }
 
-      buffer.push(buffer.pop() + (hasUnarySlash ? '/' : '') + '>');
+      buffer[buffer.length - 1] += (hasUnarySlash ? '/' : '') + '>';
 
       if (autoGenerated && !options.includeAutoGeneratedTags) {
         removeStartTag();
@@ -1815,7 +1937,7 @@ async function minifyHTML(value, options, partialMarkup) {
         currentTag = '';
       }
     },
-    end: function (/** @type {string} */ tag, /** @type {HTMLAttribute[]} */ attrs, /** @type {boolean} */ autoGenerated) {
+    end: function (/** @type {string} */ tag, /** @type {HTMLAttribute[]} */ attrs, /** @type {boolean} */ autoGenerated, /** @type {string | undefined} */ rest) {
       // As in `start`: `lowerTag` stays '' when no foreign content is around
       let lowerTag = '';
       // Named as the start tag was: an `svg` or `math` element in its own context,
@@ -1833,6 +1955,18 @@ async function minifyHTML(value, options, partialMarkup) {
         }
       }
       tag = name(tag);
+      let endTagText = '</' + tag + '>';
+      // Custom fragments after the name are kept, next to it if they were in the source
+      if (rest && uidAttr && rest.includes(uidAttr)) {
+        markTagFragments(rest);
+        const uidMatch = /** @type {RegExp} */ (uidAttrLeadingPattern).exec(rest);
+        const joinsTag = uidMatch !== null && rest.startsWith('\t' + uidAttr) &&
+          ignoredCustomMarkupChunks[+(uidMatch[1] ?? 0)]?.[1] === '';
+        // Anything else an end tag holds is dropped, as without fragments
+        const marker = uidAttr;
+        const fragments = Array.from(rest.matchAll(/** @type {RegExp} */ (uidPattern)), uid => marker + (uid[2] ?? '') + marker);
+        endTagText = '</' + tag + (joinsTag ? '' : ' ') + fragments.join(' ') + '>';
+      }
 
       // Check if current tag is in a whitespace stack
       if (options.collapseWhitespace) {
@@ -1894,7 +2028,7 @@ async function minifyHTML(value, options, partialMarkup) {
           if (autoGenerated && !options.includeAutoGeneratedTags) {
             optionalEndTagEmitted = false;
           } else {
-            buffer.push('</' + tag + '>');
+            bufferPush(endTagText, true);
           }
           charsPrevTag = '/' + tag;
           if (!inlineElements.has(tag)) {
@@ -1907,7 +2041,7 @@ async function minifyHTML(value, options, partialMarkup) {
         if (autoGenerated && !options.includeAutoGeneratedTags) {
           optionalEndTagEmitted = false;
         } else {
-          buffer.push('</' + tag + '>');
+          bufferPush(endTagText, true);
         }
         charsPrevTag = '/' + tag;
         if (!inlineElements.has(tag)) {
@@ -1983,10 +2117,10 @@ async function minifyHTML(value, options, partialMarkup) {
       commentFinalize(text);
     },
     doctype: function (/** @type {string} */ doctype) {
-      buffer.push(options.useShortDoctype
+      bufferPush(options.useShortDoctype
         ? '<!doctype' +
         (options.removeTagWhitespace ? '' : ' ') + 'html>'
-        : collapseWhitespaceAll(doctype));
+        : collapseWhitespaceAll(doctype), false);
     }
   });
 
@@ -2003,7 +2137,10 @@ async function minifyHTML(value, options, partialMarkup) {
     );
     for (let i = svgBlocks.length - 1; i >= 0; i--) {
       const block = svgBlocks[i];
-      if (block) buffer.splice(block.start, block.end - block.start, optimized[i] ?? '');
+      if (block) {
+        buffer.splice(block.start, block.end - block.start, optimized[i] ?? '');
+        bufferTags?.splice(block.start, block.end - block.start, false);
+      }
     }
   }
 
@@ -2022,23 +2159,28 @@ async function minifyHTML(value, options, partialMarkup) {
     squashTrailingWhitespace('br');
   }
 
-  return joinResultSegments(buffer, options, uidPattern
+  return joinResultSegments(buffer, bufferTags ?? [], [uidAttr, uidIgnore].filter(marker => marker !== undefined), options, uidPattern
     ? function (/** @type {string} */ str) {
-      return str.replace(/** @type {RegExp} */ (uidPattern), function (/** @type {string} */ match, /** @type {string} */ prefix, /** @type {string} */ index, /** @type {string} */ suffix) {
-        let chunk = ignoredCustomMarkupChunks[+index]?.[0] ?? match;
-        if (options.collapseWhitespace) {
-          if (prefix !== '\t') {
-            chunk = prefix + chunk;
-          }
-          if (suffix !== '\t') {
-            chunk += suffix;
-          }
-          return collapseWhitespace(chunk, {
-            preserveLineBreaks: options.preserveLineBreaks,
-            conservativeCollapse: !options.trimCustomFragments
-          }, /^[ \n\r\t\f]/.test(chunk), /[ \n\r\t\f]$/.test(chunk));
+      return str.replace(/** @type {RegExp} */ (uidPattern), function (/** @type {string} */ match, /** @type {string} */ prefix, /** @type {string} */ index, /** @type {string} */ suffix, /** @type {number} */ offset, /** @type {string} */ string) {
+        const chunks = ignoredCustomMarkupChunks[+index];
+        if (!chunks) {
+          return match;
+        }
+        if (!options.collapseWhitespace) {
+          return chunks[0];
         }
-        return chunk;
+        const leading = chunks[1] ?? '';
+        const trailing = chunks[2] ?? '';
+        const fragment = chunks[0].slice(leading.length, chunks[0].length - trailing.length);
+        const inTag = customMarkupInTags.has(+index);
+        const keep = inTag || customMarkupInCode.has(+index) || !options.trimCustomFragments;
+        // The padding tabs are whitespace to the minifier, so where one is gone, the
+        // minifier removed the whitespace, which makes it safe to trim
+        const trimLeading = !keep && prefix === '';
+        const trimTrailing = inTag ? string.charCodeAt(offset + match.length) === 62 /* > */ : !keep && suffix === '';
+        return restoreFragmentSide(prefix.replace(RE_TABS, '') + leading, trimLeading, true) +
+          fragment +
+          restoreFragmentSide(suffix.replace(RE_TABS, '') + trailing, trimTrailing, false);
       });
     }
     : identity, uidIgnore
@@ -2052,46 +2194,74 @@ async function minifyHTML(value, options, partialMarkup) {
 
 /**
  * @param {string[]} results
+ * @param {boolean[]} resultTags Whether each result belongs to a start or end tag
+ * @param {string[]} markers Custom fragment and `htmlmin:ignore` placeholder markers
  * @param {ProcessedOptions} options
  * @param {Function} restoreCustom
  * @param {Function} restoreIgnore
  */
-function joinResultSegments(results, options, restoreCustom, restoreIgnore) {
+function joinResultSegments(results, resultTags, markers, options, restoreCustom, restoreIgnore) {
   let str;
   const maxLineLength = options.maxLineLength;
-  const noNewlinesBeforeTagClose = options.noNewlinesBeforeTagClose;
 
   if (maxLineLength) {
-    let line = ''; const lines = [];
-    // Index-based scan—`Array.shift()` is O(n) per call, which would make this
-    // loop quadratic on documents with many segments
-    let index = 0;
-    while (index < results.length) {
-      const len = line.length;
-      const cur = results[index] ?? '';
-      const end = cur.indexOf('\n');
-      const isClosingTag = Boolean(cur.match(endTag));
-      const shouldKeepSameLine = noNewlinesBeforeTagClose && isClosingTag;
-
-      if (end < 0) {
-        line += restoreIgnore(restoreCustom(cur));
-        index++;
-      } else {
-        line += restoreIgnore(restoreCustom(cur.slice(0, end)));
-        results[index] = cur.slice(end + 1);
+    // Whitespace in tags is the only whitespace that can’t change the output, so lines break
+    // there alone—in place of the space between attributes, or right before a tag’s `>`
+    const noNewlinesBeforeTagClose = options.noNewlinesBeforeTagClose;
+    /** @type {string[]} */
+    const lines = [];
+    let lineLength = 0;
+    // Output since the last break opportunity, and what that opportunity is when not taken;
+    // fragments are restored by chunk, as whitespace around them decides how they come back
+    let chunk = '';
+    /** @type {string | null} */
+    let separator = null;
+    const flush = (/** @type {string | null} */ nextSeparator) => {
+      chunk = restoreIgnore(restoreCustom(chunk));
+      const newline = chunk.indexOf('\n');
+      const head = newline < 0 ? chunk.length : newline;
+      // A line already too long gains nothing from moving a `>` that ends a line of its own
+      const isUseless = separator === '' && head === 1 && lineLength > maxLineLength;
+      if (separator !== null) {
+        if (lineLength > 0 && lineLength + separator.length + head > maxLineLength && !isUseless) {
+          lines.push('\n');
+          lineLength = 0;
+        } else if (separator) {
+          lines.push(separator);
+          lineLength += separator.length;
+        }
       }
-      if (len > 0 && line.length > maxLineLength && !shouldKeepSameLine) {
-        lines.push(line.slice(0, len));
-        line = line.slice(len);
-      } else if (end >= 0) {
-        lines.push(line);
-        line = '';
+      lines.push(chunk);
+      lineLength = newline < 0 ? lineLength + chunk.length : chunk.length - chunk.lastIndexOf('\n') - 1;
+      chunk = '';
+      separator = nextSeparator;
+    };
+    for (let index = 0; index < results.length; index++) {
+      const result = results[index] ?? '';
+      if (!resultTags[index]) {
+        chunk += result;
+      } else if (markers.length && markers.some(marker => result.includes(marker))) {
+        // Whitespace next to a fragment stays as is, as it may belong to it
+        if (!chunk && separator !== null) {
+          chunk = separator;
+          separator = null;
+        }
+        chunk += result;
+      } else if (result.charCodeAt(result.length - 1) === 32 /* space */) {
+        chunk += result.slice(0, -1);
+        flush(' ');
+      } else if (result.charCodeAt(result.length - 1) === 62 /* > */ &&
+          result.charCodeAt(result.length - 2) !== 47 /* / */ &&
+          !(noNewlinesBeforeTagClose && result.startsWith('</'))) {
+        chunk += result.slice(0, -1);
+        flush('');
+        chunk = '>';
+      } else {
+        chunk += result;
       }
     }
-    if (line) {
-      lines.push(line);
-    }
-    str = lines.join('\n');
+    flush(null);
+    str = lines.join('');
   } else {
     str = restoreIgnore(restoreCustom(results.join('')));
   }

package/src/htmlparser.js

@@ -67,7 +67,6 @@ const qnameCapture = (function () {
 })();
 const startTagOpen = new RegExp('^<' + qnameCapture);
 const endTagOpen = new RegExp('^</' + qnameCapture);
-export const endTag = new RegExp('^</' + qnameCapture + '[^>]*>');
 
 let IS_REGEX_CAPTURING_BROKEN = false;
 'x'.replace(/x(.)?/g, function (/** @type {string} */ m, /** @type {string | undefined} */ g) {
@@ -1033,11 +1032,14 @@ export class HTMLParser {
         stackIndex = 0;
       }
 
+      // Whatever follows the name, which browsers drop but a custom fragment may stand in for
+      const rest = tag.length > tagName.length + 3 ? tag.slice(tagName.length + 2, -1) : '';
+
       if (stackIndex >= 0) {
         // Close all the open elements, up the stack
         for (let i = stack.length - 1; i >= stackIndex; i--) {
           if (handler.end) {
-            handler.end(stack[i]?.tag, stack[i]?.attrs, i > stackIndex || !tag);
+            handler.end(stack[i]?.tag, stack[i]?.attrs, i > stackIndex || !tag, i === stackIndex ? rest : '');
           }
         }
 
@@ -1048,7 +1050,7 @@ export class HTMLParser {
       } else if (handler.partialMarkup && tagName) {
         // In partial markup mode, preserve stray end tags
         if (handler.end) {
-          handler.end(tagName, [], false);
+          handler.end(tagName, [], false, rest);
         }
       } else if (lowerTagName === 'br') {
         if (handler.start) {

package/src/lib/option-definitions.js

@@ -81,7 +81,7 @@ const optionDefinitions = {
     type: 'regexpArray'
   },
   ignoreCustomFragments: {
-    description: 'Array of regexes that allow to ignore certain fragments, when matched (e.g., `<?php \u2026 ?>`, `{{ \u2026 }}`)',
+    description: 'Array of regexes that allow to ignore certain fragments, when matched (e.g., `<?php \u2026 ?>`, `{{ \u2026 }}`, etc.)',
     type: 'regexpArray'
   },
   includeAutoGeneratedTags: {
@@ -101,7 +101,7 @@ const optionDefinitions = {
     type: 'int'
   },
   maxLineLength: {
-    description: 'Specify a maximum line length; compressed output will be split by newlines at valid HTML split-points',
+    description: 'Specify a maximum line length; output will be split by newlines in tags only (between attributes or before a tag’s `>`), where they can’t change the page, so lines may run longer',
     type: 'int'
   },
   mergeScripts: {
@@ -125,7 +125,7 @@ const optionDefinitions = {
     type: 'json'
   },
   noNewlinesBeforeTagClose: {
-    description: 'Never add a newline before a tag that closes an element—use with `--max-line-length`',
+    description: 'Never split a line in a tag that closes an element—use with `--max-line-length`',
     type: 'boolean'
   },
   partialMarkup: {
@@ -169,7 +169,7 @@ const optionDefinitions = {
     type: 'boolean'
   },
   removeEmptyElementsExcept: {
-    description: 'Array of elements to preserve (e.g., `td`, `<span aria-hidden="true">`)—use with `--remove-empty-elements`',
+    description: 'Array of elements to preserve (e.g., `td`, `<span aria-hidden="true">`, etc.)—use with `--remove-empty-elements`',
     type: 'jsonArray'
   },
   removeOptionalTags: {
@@ -197,7 +197,7 @@ const optionDefinitions = {
     type: 'boolean'
   },
   trimCustomFragments: {
-    description: 'Trim whitespace around custom fragments (`--ignore-custom-fragments`)—use with `--collapse-whitespace`',
+    description: 'Trim whitespace around custom fragments (`--ignore-custom-fragments`) where it does not affect the output—use with `--collapse-whitespace`',
     type: 'boolean'
   },
   strictCustomFragments: {