From ab9a8c8c0984482ad9fcde73909e834660adfd0a Mon Sep 17 00:00:00 2001
From: alexander-akait <4567934+alexander-akait@users.noreply.github.com>
Date: Sun, 18 Oct 2026 00:47:40 +0000
Subject: [PATCH] docs: update

---
 OPTIONS.md | 99 ++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 78 insertions(+), 21 deletions(-)

diff --git a/OPTIONS.md b/OPTIONS.md
index 09cd345f41e..bdeed49170e 100644
--- a/OPTIONS.md
+++ b/OPTIONS.md
@@ -108,6 +108,8 @@ Options
   --experiments-lazy-compilation-imports                                             Enable/disable lazy compilation for import() modules.
   --no-experiments-lazy-compilation-imports                                          Negative 'experiments-lazy-compilation-imports' option.
   --experiments-lazy-compilation-test <value>                                        Specify which entrypoints or import()ed modules should be lazily compiled. This is matched with the imported module and not the entrypoint name.
+  --experiments-lazy-compilation-test-glob <value...>                                A glob pattern matched against a path, using `/` as path separator on every OS; a `!` prefix excludes what it matches.
+  --experiments-lazy-compilation-test-glob-reset                                     Clear all items provided in 'experiments.lazyCompilation.test.glob' configuration. A list of glob patterns.
   --experiments-source-import                                                        Enable experimental tc39 proposal https://github.com/tc39/proposal-source-phase-imports. This allows importing modules at source phase.
   --no-experiments-source-import                                                     Negative 'experiments-source-import' option.
   --experiments-sync-web-assembly                                                    Support WebAssembly as synchronous EcmaScript Module (outdated).
@@ -144,7 +146,7 @@ Options
   --no-externals-presets-web-async                                                   Negative 'externals-presets-web-async' option.
   --externals-type <value>                                                           Specifies the default type of externals ('amd*', 'umd*', 'system' and 'jsonp' depend on output.libraryTarget set to the same value).
   --ignore-warnings <value...>                                                       A RegExp to select the warning message.
-  --ignore-warnings-file <value...>                                                  A RegExp to select the origin file for the warning.
+  --ignore-warnings-file <value...>                                                  A RegExp or a glob to select the origin file for the warning. A glob matching the origin file for the warning at any depth.
   --ignore-warnings-message <value...>                                               A RegExp to select the warning message.
   --ignore-warnings-module <value...>                                                A RegExp to select the origin module for the warning.
   --ignore-warnings-reset                                                            Clear all items provided in 'ignoreWarnings' configuration. Ignore specific warnings.
@@ -229,7 +231,7 @@ Options
   --no-module-generator-html-extract                                                 Negative 'module-generator-html-extract' option.
   --module-generator-json-json-parse                                                 Use `JSON.parse` when the JSON string is longer than 20 characters.
   --no-module-generator-json-json-parse                                              Negative 'module-generator-json-json-parse' option.
-  --module-no-parse <value...>                                                       A regular expression, when matched the module is not parsed. An absolute path, when the module starts with this path it is not parsed.
+  --module-no-parse <value...>                                                       A regular expression, when matched the module is not parsed. An absolute path, when the module starts with this path it is not parsed. A glob, when it matches the module's resource path at any depth the module is not parsed.
   --module-no-parse-reset                                                            Clear all items provided in 'module.noParse' configuration. Don't parse files matching. It's matched against the full resolved request.
   --module-parser-asset-data-url-condition-max-size <value>                          Maximum size of asset that should be inline as modules. Default: 8kb.
   --module-parser-css-as <value>                                                     Configure how the CSS source is parsed: as a full stylesheet (default) or as a block's contents (e.g. the content of an HTML `style` attribute).
@@ -417,6 +419,7 @@ Options
   --module-parser-css-module-url-hints-type <value...>                               Default `type` attribute (MIME).
   --module-parser-css-module-url-hints-reset                                         Clear all items provided in 'module.parser.css/module.urlHints' configuration. URL-referenced-asset default hint rules for this parser (JavaScript `new URL(...)`, CSS `url(...)`, HTML `<img src>` / `<link href>` / `<script src>`).
   --module-parser-html-as <value>                                                    Configure how the HTML source is parsed: `"document"` (the default) parses a full page; any other value is the tag name of the context element to parse the source as that element's inner HTML (a fragment) — e.g. `"template"` for a neutral fragment, or `"tbody"` so context-sensitive tags like a bare `<tr>`/`<td>` are kept instead of dropped.
+  --module-parser-html-chunk-name <value>                                            Name the chunk an extracted `<script>`/`<link>` tag becomes, in place of the page and the tag's position. A string may carry `[page]` (the page's path, escaped for a name), `[name]` (the tag's own basename, empty for an inline body), `[index]` (the tag's position in the page) and `[type]`; a function is called with the same values and returns the name. A `<!-- webpackChunkName: "..." -->` comment before a tag wins over it, and either way the name is also the stem the chunk's file is emitted under.
   --module-parser-html-sources [value...]                                            A source entry: either the string `"..."` to inline the built-in default sources, or an object describing a `tag`/`attribute` pair to extract and how to bundle it. Configure extraction of URL-like attribute values (e.g. `<img src>`, `<link href>`, `<script src>`) as webpack dependencies. `true` (default) uses the built-in source list; `false` disables extraction entirely so attributes are left untouched and `<script src>` / `<link rel="modulepreload">` / `<link rel="stylesheet">` no longer become compilation entries; an array lets you customize which `tag`/`attribute` pairs are treated as URLs and how they are bundled. Use the string `"..."` inside the array to inline the defaults. Inline `<script>` and `<style>` bodies are always processed. Use `webpackIgnore` comments or `IgnorePlugin` to skip individual URLs.
   --no-module-parser-html-sources                                                    Negative 'module-parser-html-sources' option.
   --module-parser-html-sources-attribute <value...>                                  Attribute name whose value is treated as a URL.
@@ -470,6 +473,8 @@ Options
   --no-module-parser-javascript-dynamic-import-preload                               Negative 'module-parser-javascript-dynamic-import-preload' option.
   --module-parser-javascript-dynamic-url [value]                                     Enable/disable parsing of dynamic URL. Enable/disable parsing of new URL() syntax.
   --no-module-parser-javascript-dynamic-url                                          Negative 'module-parser-javascript-dynamic-url' option.
+  --module-parser-javascript-esm                                                     Enable/disable parsing of EcmaScript Modules syntax.
+  --no-module-parser-javascript-esm                                                  Negative 'module-parser-javascript-esm' option.
   --module-parser-javascript-exports-presence <value>                                Specifies the behavior of invalid export names in "import ... from ..." and "export ... from ...".
   --no-module-parser-javascript-exports-presence                                     Negative 'module-parser-javascript-exports-presence' option.
   --module-parser-javascript-expr-context-critical                                   Enable warnings for full dynamic dependencies.
@@ -479,7 +484,7 @@ Options
   --module-parser-javascript-expr-context-reg-exp [value]                            Sets the default regular expression for full dynamic dependencies.
   --no-module-parser-javascript-expr-context-reg-exp                                 Negative 'module-parser-javascript-expr-context-reg-exp' option.
   --module-parser-javascript-expr-context-request <value>                            Set the default request for full dynamic dependencies.
-  --module-parser-javascript-harmony                                                 Enable/disable parsing of EcmaScript Modules syntax.
+  --module-parser-javascript-harmony                                                 Deprecated in favor of "esm". Enable/disable parsing of EcmaScript Modules syntax.
   --no-module-parser-javascript-harmony                                              Negative 'module-parser-javascript-harmony' option.
   --module-parser-javascript-import                                                  Enable/disable parsing of import() syntax.
   --no-module-parser-javascript-import                                               Negative 'module-parser-javascript-import' option.
@@ -539,6 +544,7 @@ Options
   --no-module-parser-javascript-strict-this-context-on-imports                       Negative 'module-parser-javascript-strict-this-context-on-imports' option.
   --module-parser-javascript-system                                                  Enable/disable parsing of System.js special syntax like System.import, System.get, System.set and System.register.
   --no-module-parser-javascript-system                                               Negative 'module-parser-javascript-system' option.
+  --module-parser-javascript-top-level-this <value>                                  Set what top-level "this" refers to in a non-ES module: "exports" (the exports object, as in Node.js) or "global" (the global object, as in a classic script).
   --module-parser-javascript-typescript                                              Enable typescript support.
   --no-module-parser-javascript-typescript                                           Negative 'module-parser-javascript-typescript' option.
   --module-parser-javascript-unknown-context-critical                                Enable warnings when using the require function in a not statically analyse-able way.
@@ -607,6 +613,8 @@ Options
   --no-module-parser-javascript-auto-dynamic-import-preload                          Negative 'module-parser-javascript-auto-dynamic-import-preload' option.
   --module-parser-javascript-auto-dynamic-url                                        Enable/disable parsing of dynamic URL.
   --no-module-parser-javascript-auto-dynamic-url                                     Negative 'module-parser-javascript-auto-dynamic-url' option.
+  --module-parser-javascript-auto-esm                                                Enable/disable parsing of EcmaScript Modules syntax.
+  --no-module-parser-javascript-auto-esm                                             Negative 'module-parser-javascript-auto-esm' option.
   --module-parser-javascript-auto-exports-presence <value>                           Specifies the behavior of invalid export names in "import ... from ..." and "export ... from ...".
   --no-module-parser-javascript-auto-exports-presence                                Negative 'module-parser-javascript-auto-exports-presence' option.
   --module-parser-javascript-auto-expr-context-critical                              Enable warnings for full dynamic dependencies.
@@ -616,7 +624,7 @@ Options
   --module-parser-javascript-auto-expr-context-reg-exp [value]                       Sets the default regular expression for full dynamic dependencies.
   --no-module-parser-javascript-auto-expr-context-reg-exp                            Negative 'module-parser-javascript-auto-expr-context-reg-exp' option.
   --module-parser-javascript-auto-expr-context-request <value>                       Set the default request for full dynamic dependencies.
-  --module-parser-javascript-auto-harmony                                            Enable/disable parsing of EcmaScript Modules syntax.
+  --module-parser-javascript-auto-harmony                                            Deprecated in favor of "esm". Enable/disable parsing of EcmaScript Modules syntax.
   --no-module-parser-javascript-auto-harmony                                         Negative 'module-parser-javascript-auto-harmony' option.
   --module-parser-javascript-auto-import                                             Enable/disable parsing of import() syntax.
   --no-module-parser-javascript-auto-import                                          Negative 'module-parser-javascript-auto-import' option.
@@ -676,6 +684,7 @@ Options
   --no-module-parser-javascript-auto-strict-this-context-on-imports                  Negative 'module-parser-javascript-auto-strict-this-context-on-imports' option.
   --module-parser-javascript-auto-system                                             Enable/disable parsing of System.js special syntax like System.import, System.get, System.set and System.register.
   --no-module-parser-javascript-auto-system                                          Negative 'module-parser-javascript-auto-system' option.
+  --module-parser-javascript-auto-top-level-this <value>                             Set what top-level "this" refers to in a non-ES module: "exports" (the exports object, as in Node.js) or "global" (the global object, as in a classic script).
   --module-parser-javascript-auto-typescript                                         Enable typescript support.
   --no-module-parser-javascript-auto-typescript                                      Negative 'module-parser-javascript-auto-typescript' option.
   --module-parser-javascript-auto-unknown-context-critical                           Enable warnings when using the require function in a not statically analyse-able way.
@@ -744,6 +753,8 @@ Options
   --no-module-parser-javascript-dynamic-dynamic-import-preload                       Negative 'module-parser-javascript-dynamic-dynamic-import-preload' option.
   --module-parser-javascript-dynamic-dynamic-url                                     Enable/disable parsing of dynamic URL.
   --no-module-parser-javascript-dynamic-dynamic-url                                  Negative 'module-parser-javascript-dynamic-dynamic-url' option.
+  --module-parser-javascript-dynamic-esm                                             Enable/disable parsing of EcmaScript Modules syntax.
+  --no-module-parser-javascript-dynamic-esm                                          Negative 'module-parser-javascript-dynamic-esm' option.
   --module-parser-javascript-dynamic-exports-presence <value>                        Specifies the behavior of invalid export names in "import ... from ..." and "export ... from ...".
   --no-module-parser-javascript-dynamic-exports-presence                             Negative 'module-parser-javascript-dynamic-exports-presence' option.
   --module-parser-javascript-dynamic-expr-context-critical                           Enable warnings for full dynamic dependencies.
@@ -753,7 +764,7 @@ Options
   --module-parser-javascript-dynamic-expr-context-reg-exp [value]                    Sets the default regular expression for full dynamic dependencies.
   --no-module-parser-javascript-dynamic-expr-context-reg-exp                         Negative 'module-parser-javascript-dynamic-expr-context-reg-exp' option.
   --module-parser-javascript-dynamic-expr-context-request <value>                    Set the default request for full dynamic dependencies.
-  --module-parser-javascript-dynamic-harmony                                         Enable/disable parsing of EcmaScript Modules syntax.
+  --module-parser-javascript-dynamic-harmony                                         Deprecated in favor of "esm". Enable/disable parsing of EcmaScript Modules syntax.
   --no-module-parser-javascript-dynamic-harmony                                      Negative 'module-parser-javascript-dynamic-harmony' option.
   --module-parser-javascript-dynamic-import                                          Enable/disable parsing of import() syntax.
   --no-module-parser-javascript-dynamic-import                                       Negative 'module-parser-javascript-dynamic-import' option.
@@ -813,6 +824,7 @@ Options
   --no-module-parser-javascript-dynamic-strict-this-context-on-imports               Negative 'module-parser-javascript-dynamic-strict-this-context-on-imports' option.
   --module-parser-javascript-dynamic-system                                          Enable/disable parsing of System.js special syntax like System.import, System.get, System.set and System.register.
   --no-module-parser-javascript-dynamic-system                                       Negative 'module-parser-javascript-dynamic-system' option.
+  --module-parser-javascript-dynamic-top-level-this <value>                          Set what top-level "this" refers to in a non-ES module: "exports" (the exports object, as in Node.js) or "global" (the global object, as in a classic script).
   --module-parser-javascript-dynamic-typescript                                      Enable typescript support.
   --no-module-parser-javascript-dynamic-typescript                                   Negative 'module-parser-javascript-dynamic-typescript' option.
   --module-parser-javascript-dynamic-unknown-context-critical                        Enable warnings when using the require function in a not statically analyse-able way.
@@ -879,6 +891,8 @@ Options
   --no-module-parser-javascript-esm-dynamic-import-preload                           Negative 'module-parser-javascript-esm-dynamic-import-preload' option.
   --module-parser-javascript-esm-dynamic-url                                         Enable/disable parsing of dynamic URL.
   --no-module-parser-javascript-esm-dynamic-url                                      Negative 'module-parser-javascript-esm-dynamic-url' option.
+  --module-parser-javascript-esm-esm                                                 Enable/disable parsing of EcmaScript Modules syntax.
+  --no-module-parser-javascript-esm-esm                                              Negative 'module-parser-javascript-esm-esm' option.
   --module-parser-javascript-esm-exports-presence <value>                            Specifies the behavior of invalid export names in "import ... from ..." and "export ... from ...".
   --no-module-parser-javascript-esm-exports-presence                                 Negative 'module-parser-javascript-esm-exports-presence' option.
   --module-parser-javascript-esm-expr-context-critical                               Enable warnings for full dynamic dependencies.
@@ -888,7 +902,7 @@ Options
   --module-parser-javascript-esm-expr-context-reg-exp [value]                        Sets the default regular expression for full dynamic dependencies.
   --no-module-parser-javascript-esm-expr-context-reg-exp                             Negative 'module-parser-javascript-esm-expr-context-reg-exp' option.
   --module-parser-javascript-esm-expr-context-request <value>                        Set the default request for full dynamic dependencies.
-  --module-parser-javascript-esm-harmony                                             Enable/disable parsing of EcmaScript Modules syntax.
+  --module-parser-javascript-esm-harmony                                             Deprecated in favor of "esm". Enable/disable parsing of EcmaScript Modules syntax.
   --no-module-parser-javascript-esm-harmony                                          Negative 'module-parser-javascript-esm-harmony' option.
   --module-parser-javascript-esm-import                                              Enable/disable parsing of import() syntax.
   --no-module-parser-javascript-esm-import                                           Negative 'module-parser-javascript-esm-import' option.
@@ -948,6 +962,7 @@ Options
   --no-module-parser-javascript-esm-strict-this-context-on-imports                   Negative 'module-parser-javascript-esm-strict-this-context-on-imports' option.
   --module-parser-javascript-esm-system                                              Enable/disable parsing of System.js special syntax like System.import, System.get, System.set and System.register.
   --no-module-parser-javascript-esm-system                                           Negative 'module-parser-javascript-esm-system' option.
+  --module-parser-javascript-esm-top-level-this <value>                              Set what top-level "this" refers to in a non-ES module: "exports" (the exports object, as in Node.js) or "global" (the global object, as in a classic script).
   --module-parser-javascript-esm-typescript                                          Enable typescript support.
   --no-module-parser-javascript-esm-typescript                                       Negative 'module-parser-javascript-esm-typescript' option.
   --module-parser-javascript-esm-unknown-context-critical                            Enable warnings when using the require function in a not statically analyse-able way.
@@ -1122,17 +1137,29 @@ Options
   --optimization-minimize                                                            Enable minimizing the output. Uses optimization.minimizer. An options object implies 'true' and sets optimization.minimizeOptions.
   --no-optimization-minimize                                                         Negative 'optimization-minimize' option.
   --no-optimization-minimize-css                                                     Negative 'optimization-minimize-css' option.
+  --optimization-minimize-css-charset <value>                                        How the minimizer states a `.css` asset's encoding. `"auto"` (the default) opens it with `@charset "UTF-8"` only when its output holds a non-ASCII character, so it is read as UTF-8 wherever the server's `Content-Type` names no other charset, which `@charset` cannot override. `false` writes no `@charset` at all, and writes an escaped character past U+FFFF (an icon font's `content: "\F0A86"`) as the character itself, as `"auto"` does once that `@charset` is written. Set `false` only where the asset is read as UTF-8 anyway: a stylesheet with no `@charset` is read in the encoding the server's `Content-Type` names, else in the encoding of the page linking it, so it holds wherever the server names UTF-8 or the page is UTF-8 — and anywhere else every such character reads as other characters.
+  --no-optimization-minimize-css-charset                                             Negative 'optimization-minimize-css-charset' option.
   --optimization-minimize-css-color-fallbacks                                        Write a color the `browserslist` target cannot read as an extra declaration before the one naming it, in a spelling it does read: `color: oklch(59.686% 0.15619 49.7694)` is written as `color: #c65d06` and then the `oklch()` itself, so an engine reading neither the Lab family nor `hwb()` is left with a color rather than with nothing. The fallback is that color clipped into the sRGB gamut and rounded, which the declaration standing after it corrects wherever it is read. Nothing is written where the author already set the property earlier in the same block, where the color holds a substitution or a relative reference this cannot fold, or where the fallback would still name a function the target cannot read. On by default, and only in effect for a `browserslist` target — any other target names no browsers to answer for.
   --no-optimization-minimize-css-color-fallbacks                                     Negative 'optimization-minimize-css-color-fallbacks' option.
   --optimization-minimize-css-comments [value]                                       Which comments survive. `"some"`, the default, keeps a `/*!` banner and a comment annotated `@license` or `@preserve`; `true` (or `"all"`) keeps every comment and `false` keeps none; a string is read as a regular expression source, and it, a `RegExp` or a `(comment) => boolean` predicate is asked about each comment's own text and keeps the ones it accepts — standing in for the default rule rather than beside it, as terser's `format.comments` does, so a pattern that names nothing else drops the ones `"some"` would have kept. A `/*#` source-map pragma is a link rather than a comment, so `"some"` and `"all"` keep it; `false`, a pattern or a predicate decides it like any other. A predicate is handed to the minimizer's worker pool as source, so it must not close over anything.
   --no-optimization-minimize-css-comments                                            Negative 'optimization-minimize-css-comments' option.
+  --optimization-minimize-css-convert-approximate-colors                             Write a polar or Lab color as the nearest hex even where that hex only approximates it. `shortenColors` converts one only where webpack can prove an engine's own conversion lands on the same bytes, and keeps the function in the two places it cannot: a channel sitting too near a `.5` boundary for two implementations to round it alike (it is why esbuild and lightningcss emit different bytes for `hwb(194 0% 0%)`), and a color outside the sRGB gamut, which hex can only clip to a different color. Off by default, for those two reasons, and the two are not the same trade: on the boundary this writes the byte esbuild, lightningcss and cssnano write anyway, while outside the gamut it goes further than any of them — lightningcss keeps the function there and writes a fallback before it, which is what `colorFallbacks` does. A space engines read through transfers of their own (`a98-rgb`, `prophoto-rgb`) is left alone either way, the hex there naming a color no engine paints rather than a near one. This is about replacing the function: a fallback stands before it rather than in its place, so it already clips and rounds this way.
+  --no-optimization-minimize-css-convert-approximate-colors                          Negative 'optimization-minimize-css-convert-approximate-colors' option.
   --optimization-minimize-css-convert-length-units                                   Rewrite a length into a shorter unit it is exactly equal in (`16px` -> `1pc`). Off by default: the authored unit is lost, and once the asset is compressed the rewrite rarely earns anything.
   --no-optimization-minimize-css-convert-length-units                                Negative 'optimization-minimize-css-convert-length-units' option.
+  --optimization-minimize-css-custom-media                                           Resolve the `@custom-media` at-rule: write the query a name stands for wherever a condition asks for it, and drop the rule that named it. `@custom-media --wide (width>400px)` with `@media (--wide)` becomes `@media (width>400px)`. Off by default: `module.parser.css.customMedia` already resolves it in every stylesheet webpack parses, so this is for a `.css` asset that reached the minimizer without being parsed — one emitted by `asset/resource` or copied in. Every rule is read first, so a name resolves wherever its rule stands, the last rule stating it holds, and one name may be read through another; names that read each other in a cycle stand for nothing and are left as written.
+  --no-optimization-minimize-css-custom-media                                        Negative 'optimization-minimize-css-custom-media' option.
+  --optimization-minimize-css-custom-selectors                                       Resolve the `@custom-selector` at-rule: write the selector list a name stands for as `:is(…)` wherever a selector asks for it, and drop the rule that named it. `@custom-selector :--heading h1, h2` with `:--heading` becomes `:is(h1, h2)`. Off by default, for the reason `customMedia` is: `module.parser.css.customSelectors` already resolves it in every stylesheet webpack parses. Rules are read as `customMedia` reads them, and a name is written out only where the target reads `:is()`.
+  --no-optimization-minimize-css-custom-selectors                                    Negative 'optimization-minimize-css-custom-selectors' option.
+  --optimization-minimize-css-drop-overridden-declarations                           Drop a declaration a later one in the same block overrides even where nothing states that the target can read the later value. Off by default. With a `browserslist` target this is already done wherever every browser it names is known to read the later value, so the option only widens the case where no target is selected and there are no engines to name — which is what csso and cssnano do unconditionally. What it gives up is the fallback pair: `color:#c65d06;color:lab(50% 100 -100)` loses the hex, so an engine that cannot read `lab()` is left with nothing. A selection naming a browser the compat tables do not cover is still answered for the whole of it rather than by this option, since naming a browser states a target the option does not override.
+  --no-optimization-minimize-css-drop-overridden-declarations                        Negative 'optimization-minimize-css-drop-overridden-declarations' option.
+  --optimization-minimize-css-extract-comments [value]                               Which comments a minimized asset gives up to its `[file].LICENSE.txt`.
+  --no-optimization-minimize-css-extract-comments                                    Negative 'optimization-minimize-css-extract-comments' option.
   --optimization-minimize-css-fold-case                                              Write a name that matches ASCII case-insensitively in lowercase: an at-rule name, a property name, a pseudo-class or pseudo-element name, a function name, a unit, and a keyword standing in a value whose grammar takes keywords alone. `@MEDIA`, `COLOR`, `:NTH-CHILD`, `URL(`, `1PX` and `currentColor` become `@media`, `color`, `:nth-child`, `url(`, `1px` and `currentcolor`. On by default, and exact: CSS matches every one of these ASCII case-insensitively, so the fold names the same thing. What it never touches is a name the author chose — a custom property, a custom ident such as an animation or grid-area name, an id, a class, a type selector, an attribute's value, or anything inside a substituted value. `@charset` is left as written, being read as bytes rather than matched, and `!important` is always written in lowercase because the printer writes the keyword rather than copying it.
   --no-optimization-minimize-css-fold-case                                           Negative 'optimization-minimize-css-fold-case' option.
   --optimization-minimize-css-lower-unsupported                                      Write a spelling the `browserslist` target cannot read as one it can — the same value said another way, rather than left for an engine that will drop it: a 4-/8-digit hex as `rgba()`, a double-position gradient stop as the two stops it names, `inset` / `overflow` / `place-*` as the longhands they set, `text-decoration` as its own longhands where a slot is newer than the shorthand, `system-ui` as the stack of platform font names it stands for, a `:lang()` or `:not()` holding a list as the `:is()` that means it, a media feature range as the `min-`/`max-` pair, and `light-dark()` as the custom-property pair a color scheme switches. On by default, and only in effect for a `browserslist` target — any other target names no browsers to answer for. Off leaves every such spelling as written, which is how a stylesheet one of these rewrites gets wrong is minified; it never makes the minifier write a spelling the target cannot read.
   --no-optimization-minimize-css-lower-unsupported                                   Negative 'optimization-minimize-css-lower-unsupported' option.
-  --optimization-minimize-css-merge-distant-rules                                    Give a rule the selectors of a later one printing the same block, past the rules standing between them. Off by default because it reorders the cascade, so it holds only where nothing between the two declares a property the shared block does. A block repeated at a distance already compresses on its own, so the join is taken only where the copy of the block it drops is worth more than twice the selector it writes instead. `mergeRules` is the safe half of this, joining only what nothing stands between.
+  --optimization-minimize-css-merge-distant-rules                                    Give a rule the selectors of a later one printing the same block, and an at-rule the block of a later one stating the same condition, past the rules standing between them. Off by default because it reorders the cascade, so it holds only where nothing between the two declares a property the block being moved does for an element its selectors can match (a rule whose selectors all name other element types, `h3` between two rules for `h1` and `h2`, never can) — a condition between counts for what its own rules declare, while `@layer` and anything else whose declarations cannot be read stands in the way whatever it says. A block repeated at a distance already compresses on its own, so a selector join is taken only where the copy of the block it drops is worth more than twice the selector it writes instead; an at-rule join writes no selector and drops the repeated prelude outright. A named `@layer` is not joined this way — its place in the cascade is where its name is first written, not what its prelude states. `mergeRules` is the safe half of this, joining only what nothing stands between.
   --no-optimization-minimize-css-merge-distant-rules                                 Negative 'optimization-minimize-css-merge-distant-rules' option.
   --optimization-minimize-css-merge-longhands                                        Write a family of longhands as the one shorthand that sets them — four sides or corners, the two a pair shorthand sets, or the slots of an order-free one — even where unrelated declarations stand between them. On by default.
   --no-optimization-minimize-css-merge-longhands                                     Negative 'optimization-minimize-css-merge-longhands' option.
@@ -1144,13 +1171,13 @@ Options
   --no-optimization-minimize-css-reduce-functions                                    Negative 'optimization-minimize-css-reduce-functions' option.
   --optimization-minimize-css-remove-dead-rules                                      Drop a rule or declaration nothing can read: a rule whose block ends up empty, a declaration a later one in the same block overrides, a rule an identical later sibling makes dead, and the `@charset` naming an encoding the output is not written in. On by default. Joining rules that are not dead is `mergeRules`.
   --no-optimization-minimize-css-remove-dead-rules                                   Negative 'optimization-minimize-css-remove-dead-rules' option.
-  --optimization-minimize-css-resolve-custom-at-rules                                Resolve the `@custom-media` and `@custom-selector` at-rules: write the query or the selector list a name stands for wherever one asks for it, and drop the rule that named it. `@custom-media --wide (width>400px)` with `@media (--wide)` becomes `@media (width>400px)`, and `@custom-selector :--heading h1, h2` with `:--heading` becomes `:is(h1, h2)`. Off until asked for: `module.parser.css.customMedia` and `module.parser.css.customSelectors` already resolve both in every stylesheet webpack parses, so this is for a `.css` asset that reached the minimizer without being parsed — one emitted by `asset/resource` or copied in. Only a name stated before the rule asking for it is written out — the rules are read in the order they are written — and a rule naming one this has not come to is left as the author had it. A selector list is written as `:is(…)`, so a name is substituted only where the target reads `:is()`.
-  --no-optimization-minimize-css-resolve-custom-at-rules                             Negative 'optimization-minimize-css-resolve-custom-at-rules' option.
+  --optimization-minimize-css-reorder-declarations                                   Print a style rule's declarations in one order by property family, the properties no family names first where they were written, so blocks setting the same things read alike and compress smaller. Only declarations whose order nothing can see move: two spellings of one property, a shorthand and what it sets, two shorthands sharing a longhand, and a flow-relative side and a physical one keep theirs, and a block holding a property no dataset names or a nested rule is printed as written. On by default.
+  --no-optimization-minimize-css-reorder-declarations                                Negative 'optimization-minimize-css-reorder-declarations' option.
   --optimization-minimize-css-rewrite-custom-properties                              Shorten the values of custom properties (`--x: #ffffff` -> `#fff`, `--y: 0.5rem` -> `.5rem`), which are otherwise written back exactly as authored. Off by default: `getComputedStyle().getPropertyValue()` hands this text back, so a rewritten value is a different CSSOM — the one place a declaration's authored text survives. What it may rewrite is exactly what any other value's tokens may be, a color in a substitution's fallback included — that fallback being the property's value rather than the function's own argument.
   --no-optimization-minimize-css-rewrite-custom-properties                           Negative 'optimization-minimize-css-rewrite-custom-properties' option.
   --optimization-minimize-css-rewrite-dir-selector                                   Write a `:dir()` the `browserslist` target cannot read as the `[dir]` attribute selector it approximates: `a:dir(rtl)` becomes `a[dir=rtl]`. Off until asked for, because the two are not the same question — `:dir()` reads the directionality an element resolves to, which it may inherit from an ancestor, while `[dir=rtl]` reads the attribute on the element itself, so an element inside a `dir="rtl"` ancestor matches the first and not the second. Only in effect for a `browserslist` target that reads no `:dir()`; any other target names no browsers to answer for.
   --no-optimization-minimize-css-rewrite-dir-selector                                Negative 'optimization-minimize-css-rewrite-dir-selector' option.
-  --optimization-minimize-css-rewrite-escapes                                        Write an escaped identifier the shortest way that names the same thing, in a value or an id: `grid-area:\66oot` becomes `grid-area:foot` and `#\41 x` becomes `#Ax`. On by default, and exact: the escape and what replaces it are the same identifier. Off leaves every escape as the author wrote it, which is what a consumer comparing the text rather than reading the identifier needs.
+  --optimization-minimize-css-rewrite-escapes                                        Write an escaped identifier the shortest way that names the same thing, wherever it stands — a selector, a property, at-rule or function name, or a value: `grid-area:\66oot` becomes `grid-area:foot`, `#\41 x` becomes `#Ax`, `col\6f r:red` becomes `color:red` and `c\61 lc(` becomes `calc(`. On by default, and exact: the escape and what replaces it are the same identifier. Off leaves every escape as the author wrote it, which is what a consumer comparing the text rather than reading the identifier needs.
   --no-optimization-minimize-css-rewrite-escapes                                     Negative 'optimization-minimize-css-rewrite-escapes' option.
   --optimization-minimize-css-shorten-colors                                         Write each color in the shortest spelling of the same value: `#ffffff` -> `#fff`, `rgb(1 2 3)` -> `#010203`, a named color where the property takes no identifier of the author's own, and every polar and Lab function the target agrees with hex on. On by default.
   --no-optimization-minimize-css-shorten-colors                                      Negative 'optimization-minimize-css-shorten-colors' option.
@@ -1173,6 +1200,8 @@ Options
   --no-optimization-minimize-html-collapse-whitespace                                Negative 'optimization-minimize-html-collapse-whitespace' option.
   --optimization-minimize-html-comments [value]                                      Which comments survive. `"some"`, the default, keeps nothing: every comment an HTML parser reads is inert; `true` (or `"all"`) keeps every comment and `false` keeps none; a string is read as a regular expression source, and it, a `RegExp` or a `(comment) => boolean` predicate is asked about each comment's own text and keeps the ones it accepts — standing in for the default rule rather than beside it, as terser's `format.comments` does, so a pattern that names nothing else drops the ones `"some"` would have kept. A downlevel conditional comment, a server-side include and a `<?…?>` template directive are code rather than comments and stay whatever this says. A predicate is handed to the minimizer's worker pool as source, so it must not close over anything.
   --no-optimization-minimize-html-comments                                           Negative 'optimization-minimize-html-comments' option.
+  --optimization-minimize-html-extract-comments [value]                              Which comments a minimized asset gives up to its `[file].LICENSE.txt`.
+  --no-optimization-minimize-html-extract-comments                                   Negative 'optimization-minimize-html-extract-comments' option.
   --optimization-minimize-html-merge-scripts                                         Print a run of adjacent `<script>` elements as one, joined by a newline and a `;`. Only bare ones fold — any attribute at all, a `src`, `type`, `nonce`, `async` or `id` among them, says the two are not interchangeable with one — and only where the print writes the bodies itself, so a `<script>` that `output.html.inline` fills in after the print is left alone. A body is left alone too wherever appending it would change what it means: one still inside a string, template or block comment would swallow the next, and a directive prologue, a hashbang or a leading `-->` mean what they do only at a start the appended body no longer has. Off by default: it removes elements, so `document.scripts`, a `script:nth-child()` selector and `querySelectorAll("script").length` all read a different document; a later body's `var` and `function` declarations become visible to the bodies before it; and a body that throws takes the rest of its run with it rather than only itself, while one that does not parse takes the whole run, its own code included.
   --no-optimization-minimize-html-merge-scripts                                      Negative 'optimization-minimize-html-merge-scripts' option.
   --optimization-minimize-html-merge-styles                                          Print a run of adjacent `<style>` elements as one sheet. Off by default: it removes elements, so `document.styleSheets`, a `style:nth-child()` selector and `querySelectorAll("style").length` all read a different document. A sheet the CSS minifier does not accept is never folded — appending to one that may be unterminated would make the next sheet part of its last rule — and neither is one led by `@import` / `@charset` / `@namespace`, which apply only at the top of a sheet.
@@ -1204,18 +1233,35 @@ Options
   --optimization-minimize-html-sort-token-lists                                      Print every space-separated token list the DOM reads as a set — `class`, `rel`, `part`, `sandbox`, `blocking`, `itemprop` / `itemref` / `itemtype`, `<output for>` and `<link sizes>` — in token order. Nothing matching those reads order, so this only makes the same markup compress better across pages. Off by default: a script reading `className` or `rel` back sees the new order. Asked for on its own: a list this reorders is rewritten whether or not `normalizeListAttributes` is on, since another order is another spelling. The lists the DOM does not read as a set are left alone whatever this says — `ping` is the order its requests go out in and `accesskey` the order its keys are tried.
   --no-optimization-minimize-html-sort-token-lists                                   Negative 'optimization-minimize-html-sort-token-lists' option.
   --no-optimization-minimize-javascript                                              Negative 'optimization-minimize-javascript' option.
+  --optimization-minimize-json                                                       Minimize JSON assets by re-serializing them without whitespace (defaults to `true` with `experiments.futureDefaults`, otherwise `false`).
+  --no-optimization-minimize-json                                                    Negative 'optimization-minimize-json' option.
+  --no-optimization-minimize-xml                                                     Negative 'optimization-minimize-xml' option.
+  --optimization-minimize-xml-sort-attributes                                        Print attributes with the document's commonest names first, breaking ties by case-sensitive name. Off by default: consumers observing attribute order see the new order.
+  --no-optimization-minimize-xml-sort-attributes                                     Negative 'optimization-minimize-xml-sort-attributes' option.
   --no-optimization-minimize-options-css                                             Negative 'optimization-minimize-options-css' option.
+  --optimization-minimize-options-css-charset <value>                                How the minimizer states a `.css` asset's encoding. `"auto"` (the default) opens it with `@charset "UTF-8"` only when its output holds a non-ASCII character, so it is read as UTF-8 wherever the server's `Content-Type` names no other charset, which `@charset` cannot override. `false` writes no `@charset` at all, and writes an escaped character past U+FFFF (an icon font's `content: "\F0A86"`) as the character itself, as `"auto"` does once that `@charset` is written. Set `false` only where the asset is read as UTF-8 anyway: a stylesheet with no `@charset` is read in the encoding the server's `Content-Type` names, else in the encoding of the page linking it, so it holds wherever the server names UTF-8 or the page is UTF-8 — and anywhere else every such character reads as other characters.
+  --no-optimization-minimize-options-css-charset                                     Negative 'optimization-minimize-options-css-charset' option.
   --optimization-minimize-options-css-color-fallbacks                                Write a color the `browserslist` target cannot read as an extra declaration before the one naming it, in a spelling it does read: `color: oklch(59.686% 0.15619 49.7694)` is written as `color: #c65d06` and then the `oklch()` itself, so an engine reading neither the Lab family nor `hwb()` is left with a color rather than with nothing. The fallback is that color clipped into the sRGB gamut and rounded, which the declaration standing after it corrects wherever it is read. Nothing is written where the author already set the property earlier in the same block, where the color holds a substitution or a relative reference this cannot fold, or where the fallback would still name a function the target cannot read. On by default, and only in effect for a `browserslist` target — any other target names no browsers to answer for.
   --no-optimization-minimize-options-css-color-fallbacks                             Negative 'optimization-minimize-options-css-color-fallbacks' option.
   --optimization-minimize-options-css-comments [value]                               Which comments survive. `"some"`, the default, keeps a `/*!` banner and a comment annotated `@license` or `@preserve`; `true` (or `"all"`) keeps every comment and `false` keeps none; a string is read as a regular expression source, and it, a `RegExp` or a `(comment) => boolean` predicate is asked about each comment's own text and keeps the ones it accepts — standing in for the default rule rather than beside it, as terser's `format.comments` does, so a pattern that names nothing else drops the ones `"some"` would have kept. A `/*#` source-map pragma is a link rather than a comment, so `"some"` and `"all"` keep it; `false`, a pattern or a predicate decides it like any other. A predicate is handed to the minimizer's worker pool as source, so it must not close over anything.
   --no-optimization-minimize-options-css-comments                                    Negative 'optimization-minimize-options-css-comments' option.
+  --optimization-minimize-options-css-convert-approximate-colors                     Write a polar or Lab color as the nearest hex even where that hex only approximates it. `shortenColors` converts one only where webpack can prove an engine's own conversion lands on the same bytes, and keeps the function in the two places it cannot: a channel sitting too near a `.5` boundary for two implementations to round it alike (it is why esbuild and lightningcss emit different bytes for `hwb(194 0% 0%)`), and a color outside the sRGB gamut, which hex can only clip to a different color. Off by default, for those two reasons, and the two are not the same trade: on the boundary this writes the byte esbuild, lightningcss and cssnano write anyway, while outside the gamut it goes further than any of them — lightningcss keeps the function there and writes a fallback before it, which is what `colorFallbacks` does. A space engines read through transfers of their own (`a98-rgb`, `prophoto-rgb`) is left alone either way, the hex there naming a color no engine paints rather than a near one. This is about replacing the function: a fallback stands before it rather than in its place, so it already clips and rounds this way.
+  --no-optimization-minimize-options-css-convert-approximate-colors                  Negative 'optimization-minimize-options-css-convert-approximate-colors' option.
   --optimization-minimize-options-css-convert-length-units                           Rewrite a length into a shorter unit it is exactly equal in (`16px` -> `1pc`). Off by default: the authored unit is lost, and once the asset is compressed the rewrite rarely earns anything.
   --no-optimization-minimize-options-css-convert-length-units                        Negative 'optimization-minimize-options-css-convert-length-units' option.
+  --optimization-minimize-options-css-custom-media                                   Resolve the `@custom-media` at-rule: write the query a name stands for wherever a condition asks for it, and drop the rule that named it. `@custom-media --wide (width>400px)` with `@media (--wide)` becomes `@media (width>400px)`. Off by default: `module.parser.css.customMedia` already resolves it in every stylesheet webpack parses, so this is for a `.css` asset that reached the minimizer without being parsed — one emitted by `asset/resource` or copied in. Every rule is read first, so a name resolves wherever its rule stands, the last rule stating it holds, and one name may be read through another; names that read each other in a cycle stand for nothing and are left as written.
+  --no-optimization-minimize-options-css-custom-media                                Negative 'optimization-minimize-options-css-custom-media' option.
+  --optimization-minimize-options-css-custom-selectors                               Resolve the `@custom-selector` at-rule: write the selector list a name stands for as `:is(…)` wherever a selector asks for it, and drop the rule that named it. `@custom-selector :--heading h1, h2` with `:--heading` becomes `:is(h1, h2)`. Off by default, for the reason `customMedia` is: `module.parser.css.customSelectors` already resolves it in every stylesheet webpack parses. Rules are read as `customMedia` reads them, and a name is written out only where the target reads `:is()`.
+  --no-optimization-minimize-options-css-custom-selectors                            Negative 'optimization-minimize-options-css-custom-selectors' option.
+  --optimization-minimize-options-css-drop-overridden-declarations                   Drop a declaration a later one in the same block overrides even where nothing states that the target can read the later value. Off by default. With a `browserslist` target this is already done wherever every browser it names is known to read the later value, so the option only widens the case where no target is selected and there are no engines to name — which is what csso and cssnano do unconditionally. What it gives up is the fallback pair: `color:#c65d06;color:lab(50% 100 -100)` loses the hex, so an engine that cannot read `lab()` is left with nothing. A selection naming a browser the compat tables do not cover is still answered for the whole of it rather than by this option, since naming a browser states a target the option does not override.
+  --no-optimization-minimize-options-css-drop-overridden-declarations                Negative 'optimization-minimize-options-css-drop-overridden-declarations' option.
+  --optimization-minimize-options-css-extract-comments [value]                       Which comments a minimized asset gives up to its `[file].LICENSE.txt`.
+  --no-optimization-minimize-options-css-extract-comments                            Negative 'optimization-minimize-options-css-extract-comments' option.
   --optimization-minimize-options-css-fold-case                                      Write a name that matches ASCII case-insensitively in lowercase: an at-rule name, a property name, a pseudo-class or pseudo-element name, a function name, a unit, and a keyword standing in a value whose grammar takes keywords alone. `@MEDIA`, `COLOR`, `:NTH-CHILD`, `URL(`, `1PX` and `currentColor` become `@media`, `color`, `:nth-child`, `url(`, `1px` and `currentcolor`. On by default, and exact: CSS matches every one of these ASCII case-insensitively, so the fold names the same thing. What it never touches is a name the author chose — a custom property, a custom ident such as an animation or grid-area name, an id, a class, a type selector, an attribute's value, or anything inside a substituted value. `@charset` is left as written, being read as bytes rather than matched, and `!important` is always written in lowercase because the printer writes the keyword rather than copying it.
   --no-optimization-minimize-options-css-fold-case                                   Negative 'optimization-minimize-options-css-fold-case' option.
   --optimization-minimize-options-css-lower-unsupported                              Write a spelling the `browserslist` target cannot read as one it can — the same value said another way, rather than left for an engine that will drop it: a 4-/8-digit hex as `rgba()`, a double-position gradient stop as the two stops it names, `inset` / `overflow` / `place-*` as the longhands they set, `text-decoration` as its own longhands where a slot is newer than the shorthand, `system-ui` as the stack of platform font names it stands for, a `:lang()` or `:not()` holding a list as the `:is()` that means it, a media feature range as the `min-`/`max-` pair, and `light-dark()` as the custom-property pair a color scheme switches. On by default, and only in effect for a `browserslist` target — any other target names no browsers to answer for. Off leaves every such spelling as written, which is how a stylesheet one of these rewrites gets wrong is minified; it never makes the minifier write a spelling the target cannot read.
   --no-optimization-minimize-options-css-lower-unsupported                           Negative 'optimization-minimize-options-css-lower-unsupported' option.
-  --optimization-minimize-options-css-merge-distant-rules                            Give a rule the selectors of a later one printing the same block, past the rules standing between them. Off by default because it reorders the cascade, so it holds only where nothing between the two declares a property the shared block does. A block repeated at a distance already compresses on its own, so the join is taken only where the copy of the block it drops is worth more than twice the selector it writes instead. `mergeRules` is the safe half of this, joining only what nothing stands between.
+  --optimization-minimize-options-css-merge-distant-rules                            Give a rule the selectors of a later one printing the same block, and an at-rule the block of a later one stating the same condition, past the rules standing between them. Off by default because it reorders the cascade, so it holds only where nothing between the two declares a property the block being moved does for an element its selectors can match (a rule whose selectors all name other element types, `h3` between two rules for `h1` and `h2`, never can) — a condition between counts for what its own rules declare, while `@layer` and anything else whose declarations cannot be read stands in the way whatever it says. A block repeated at a distance already compresses on its own, so a selector join is taken only where the copy of the block it drops is worth more than twice the selector it writes instead; an at-rule join writes no selector and drops the repeated prelude outright. A named `@layer` is not joined this way — its place in the cascade is where its name is first written, not what its prelude states. `mergeRules` is the safe half of this, joining only what nothing stands between.
   --no-optimization-minimize-options-css-merge-distant-rules                         Negative 'optimization-minimize-options-css-merge-distant-rules' option.
   --optimization-minimize-options-css-merge-longhands                                Write a family of longhands as the one shorthand that sets them — four sides or corners, the two a pair shorthand sets, or the slots of an order-free one — even where unrelated declarations stand between them. On by default.
   --no-optimization-minimize-options-css-merge-longhands                             Negative 'optimization-minimize-options-css-merge-longhands' option.
@@ -1227,13 +1273,13 @@ Options
   --no-optimization-minimize-options-css-reduce-functions                            Negative 'optimization-minimize-options-css-reduce-functions' option.
   --optimization-minimize-options-css-remove-dead-rules                              Drop a rule or declaration nothing can read: a rule whose block ends up empty, a declaration a later one in the same block overrides, a rule an identical later sibling makes dead, and the `@charset` naming an encoding the output is not written in. On by default. Joining rules that are not dead is `mergeRules`.
   --no-optimization-minimize-options-css-remove-dead-rules                           Negative 'optimization-minimize-options-css-remove-dead-rules' option.
-  --optimization-minimize-options-css-resolve-custom-at-rules                        Resolve the `@custom-media` and `@custom-selector` at-rules: write the query or the selector list a name stands for wherever one asks for it, and drop the rule that named it. `@custom-media --wide (width>400px)` with `@media (--wide)` becomes `@media (width>400px)`, and `@custom-selector :--heading h1, h2` with `:--heading` becomes `:is(h1, h2)`. Off until asked for: `module.parser.css.customMedia` and `module.parser.css.customSelectors` already resolve both in every stylesheet webpack parses, so this is for a `.css` asset that reached the minimizer without being parsed — one emitted by `asset/resource` or copied in. Only a name stated before the rule asking for it is written out — the rules are read in the order they are written — and a rule naming one this has not come to is left as the author had it. A selector list is written as `:is(…)`, so a name is substituted only where the target reads `:is()`.
-  --no-optimization-minimize-options-css-resolve-custom-at-rules                     Negative 'optimization-minimize-options-css-resolve-custom-at-rules' option.
+  --optimization-minimize-options-css-reorder-declarations                           Print a style rule's declarations in one order by property family, the properties no family names first where they were written, so blocks setting the same things read alike and compress smaller. Only declarations whose order nothing can see move: two spellings of one property, a shorthand and what it sets, two shorthands sharing a longhand, and a flow-relative side and a physical one keep theirs, and a block holding a property no dataset names or a nested rule is printed as written. On by default.
+  --no-optimization-minimize-options-css-reorder-declarations                        Negative 'optimization-minimize-options-css-reorder-declarations' option.
   --optimization-minimize-options-css-rewrite-custom-properties                      Shorten the values of custom properties (`--x: #ffffff` -> `#fff`, `--y: 0.5rem` -> `.5rem`), which are otherwise written back exactly as authored. Off by default: `getComputedStyle().getPropertyValue()` hands this text back, so a rewritten value is a different CSSOM — the one place a declaration's authored text survives. What it may rewrite is exactly what any other value's tokens may be, a color in a substitution's fallback included — that fallback being the property's value rather than the function's own argument.
   --no-optimization-minimize-options-css-rewrite-custom-properties                   Negative 'optimization-minimize-options-css-rewrite-custom-properties' option.
   --optimization-minimize-options-css-rewrite-dir-selector                           Write a `:dir()` the `browserslist` target cannot read as the `[dir]` attribute selector it approximates: `a:dir(rtl)` becomes `a[dir=rtl]`. Off until asked for, because the two are not the same question — `:dir()` reads the directionality an element resolves to, which it may inherit from an ancestor, while `[dir=rtl]` reads the attribute on the element itself, so an element inside a `dir="rtl"` ancestor matches the first and not the second. Only in effect for a `browserslist` target that reads no `:dir()`; any other target names no browsers to answer for.
   --no-optimization-minimize-options-css-rewrite-dir-selector                        Negative 'optimization-minimize-options-css-rewrite-dir-selector' option.
-  --optimization-minimize-options-css-rewrite-escapes                                Write an escaped identifier the shortest way that names the same thing, in a value or an id: `grid-area:\66oot` becomes `grid-area:foot` and `#\41 x` becomes `#Ax`. On by default, and exact: the escape and what replaces it are the same identifier. Off leaves every escape as the author wrote it, which is what a consumer comparing the text rather than reading the identifier needs.
+  --optimization-minimize-options-css-rewrite-escapes                                Write an escaped identifier the shortest way that names the same thing, wherever it stands — a selector, a property, at-rule or function name, or a value: `grid-area:\66oot` becomes `grid-area:foot`, `#\41 x` becomes `#Ax`, `col\6f r:red` becomes `color:red` and `c\61 lc(` becomes `calc(`. On by default, and exact: the escape and what replaces it are the same identifier. Off leaves every escape as the author wrote it, which is what a consumer comparing the text rather than reading the identifier needs.
   --no-optimization-minimize-options-css-rewrite-escapes                             Negative 'optimization-minimize-options-css-rewrite-escapes' option.
   --optimization-minimize-options-css-shorten-colors                                 Write each color in the shortest spelling of the same value: `#ffffff` -> `#fff`, `rgb(1 2 3)` -> `#010203`, a named color where the property takes no identifier of the author's own, and every polar and Lab function the target agrees with hex on. On by default.
   --no-optimization-minimize-options-css-shorten-colors                              Negative 'optimization-minimize-options-css-shorten-colors' option.
@@ -1256,6 +1302,8 @@ Options
   --no-optimization-minimize-options-html-collapse-whitespace                        Negative 'optimization-minimize-options-html-collapse-whitespace' option.
   --optimization-minimize-options-html-comments [value]                              Which comments survive. `"some"`, the default, keeps nothing: every comment an HTML parser reads is inert; `true` (or `"all"`) keeps every comment and `false` keeps none; a string is read as a regular expression source, and it, a `RegExp` or a `(comment) => boolean` predicate is asked about each comment's own text and keeps the ones it accepts — standing in for the default rule rather than beside it, as terser's `format.comments` does, so a pattern that names nothing else drops the ones `"some"` would have kept. A downlevel conditional comment, a server-side include and a `<?…?>` template directive are code rather than comments and stay whatever this says. A predicate is handed to the minimizer's worker pool as source, so it must not close over anything.
   --no-optimization-minimize-options-html-comments                                   Negative 'optimization-minimize-options-html-comments' option.
+  --optimization-minimize-options-html-extract-comments [value]                      Which comments a minimized asset gives up to its `[file].LICENSE.txt`.
+  --no-optimization-minimize-options-html-extract-comments                           Negative 'optimization-minimize-options-html-extract-comments' option.
   --optimization-minimize-options-html-merge-scripts                                 Print a run of adjacent `<script>` elements as one, joined by a newline and a `;`. Only bare ones fold — any attribute at all, a `src`, `type`, `nonce`, `async` or `id` among them, says the two are not interchangeable with one — and only where the print writes the bodies itself, so a `<script>` that `output.html.inline` fills in after the print is left alone. A body is left alone too wherever appending it would change what it means: one still inside a string, template or block comment would swallow the next, and a directive prologue, a hashbang or a leading `-->` mean what they do only at a start the appended body no longer has. Off by default: it removes elements, so `document.scripts`, a `script:nth-child()` selector and `querySelectorAll("script").length` all read a different document; a later body's `var` and `function` declarations become visible to the bodies before it; and a body that throws takes the rest of its run with it rather than only itself, while one that does not parse takes the whole run, its own code included.
   --no-optimization-minimize-options-html-merge-scripts                              Negative 'optimization-minimize-options-html-merge-scripts' option.
   --optimization-minimize-options-html-merge-styles                                  Print a run of adjacent `<style>` elements as one sheet. Off by default: it removes elements, so `document.styleSheets`, a `style:nth-child()` selector and `querySelectorAll("style").length` all read a different document. A sheet the CSS minifier does not accept is never folded — appending to one that may be unterminated would make the next sheet part of its last rule — and neither is one led by `@import` / `@charset` / `@namespace`, which apply only at the top of a sheet.
@@ -1287,6 +1335,11 @@ Options
   --optimization-minimize-options-html-sort-token-lists                              Print every space-separated token list the DOM reads as a set — `class`, `rel`, `part`, `sandbox`, `blocking`, `itemprop` / `itemref` / `itemtype`, `<output for>` and `<link sizes>` — in token order. Nothing matching those reads order, so this only makes the same markup compress better across pages. Off by default: a script reading `className` or `rel` back sees the new order. Asked for on its own: a list this reorders is rewritten whether or not `normalizeListAttributes` is on, since another order is another spelling. The lists the DOM does not read as a set are left alone whatever this says — `ping` is the order its requests go out in and `accesskey` the order its keys are tried.
   --no-optimization-minimize-options-html-sort-token-lists                           Negative 'optimization-minimize-options-html-sort-token-lists' option.
   --no-optimization-minimize-options-javascript                                      Negative 'optimization-minimize-options-javascript' option.
+  --optimization-minimize-options-json                                               Minimize JSON assets by re-serializing them without whitespace (defaults to `true` with `experiments.futureDefaults`, otherwise `false`).
+  --no-optimization-minimize-options-json                                            Negative 'optimization-minimize-options-json' option.
+  --no-optimization-minimize-options-xml                                             Negative 'optimization-minimize-options-xml' option.
+  --optimization-minimize-options-xml-sort-attributes                                Print attributes with the document's commonest names first, breaking ties by case-sensitive name. Off by default: consumers observing attribute order see the new order.
+  --no-optimization-minimize-options-xml-sort-attributes                             Negative 'optimization-minimize-options-xml-sort-attributes' option.
   --optimization-module-ids <value>                                                  Define the algorithm to choose module ids (natural: numeric ids in order of usage, named: readable ids for better debugging, hashed: (deprecated) short hashes as ids for better long term caching, deterministic: numeric hash ids for better long term caching, size: numeric ids focused on minimal initial download size, false: no algorithm used, as custom one can be provided via plugin).
   --no-optimization-module-ids                                                       Negative 'optimization-module-ids' option.
   --optimization-node-env <value>                                                    Set process.env.NODE_ENV to a specific value.
@@ -1309,6 +1362,7 @@ Options
   --no-optimization-split-chunks                                                     Negative 'optimization-split-chunks' option.
   --optimization-split-chunks-automatic-name-delimiter <value>                       Sets the name delimiter for created chunks.
   --optimization-split-chunks-chunks <value>                                         Select chunks for determining shared modules (defaults to "async", "initial" and "all" requires adding these chunks to the HTML).
+  --optimization-split-chunks-dedup-depth <value>                                    Rounds of intersections of the chunk sets to look through for modules shared by chunks no single chunk set holds together (0 looks through the chunk sets alone; every round costs more computation).
   --optimization-split-chunks-default-size-types <value...>                          Size type, like 'javascript', 'webassembly'.
   --optimization-split-chunks-default-size-types-reset                               Clear all items provided in 'optimization.splitChunks.defaultSizeTypes' configuration. Sets the size types which are used when a number is used for sizes.
   --optimization-split-chunks-enforce-size-threshold <value>                         Size of the javascript part of the chunk.
@@ -1354,6 +1408,8 @@ Options
   --output-clean-dry                                                                 Log the assets that should be removed instead of deleting them.
   --no-output-clean-dry                                                              Negative 'output-clean-dry' option.
   --output-clean-keep <value>                                                        Keep these assets.
+  --output-clean-keep-glob <value...>                                                A glob pattern matched against a path, using `/` as path separator on every OS; a `!` prefix excludes what it matches.
+  --output-clean-keep-glob-reset                                                     Clear all items provided in 'output.clean.keep.glob' configuration. A list of glob patterns.
   --output-compare-before-emit                                                       Check if to be emitted file already exists and have the same content before writing to output filesystem.
   --no-output-compare-before-emit                                                    Negative 'output-compare-before-emit' option.
   --output-copy <value...>                                                           Glob or path from where the files are copied. A glob separates with '/', matches dot files, and takes '*', '**', '?', '[]' and '{}'.
@@ -1464,9 +1520,9 @@ Options
   --no-output-html-favicon                                                           Negative 'output-html-favicon' option.
   --output-html-inject <value>                                                       Where to place injected chunk `<script>`/`<link>` tags. `"body"` (default; `"head"` with `output.module`) keeps them next to the entry tag — end of `<body>` on generated pages; `"head"` moves them into `<head>`; `false` suppresses sibling-chunk injection (entry tags and resource hints remain).
   --no-output-html-inject                                                            Negative 'output-html-inject' option.
-  --output-html-inline [value...]                                                    A regular expression matched against the chunk name; matching chunks are inlined. Inline the content of matching chunks directly into the HTML instead of emitting a separate `<script>`/`<link>` tag. `true` inlines every chunk; `"script"` inlines only JavaScript, `"style"` only CSS; an array of `RegExp` patterns matches against the chunk name.
+  --output-html-inline [value...]                                                    A regular expression matched against the chunk name; matching chunks are inlined. Inline the content of matching chunks directly into the HTML instead of emitting a separate `<script>`/`<link>` tag. `true` inlines every chunk; `"script"` inlines only JavaScript, `"style"` only CSS; an array of `RegExp` patterns matches against the chunk name and the filename template it is emitted under. A chunk another entry loads its runtime from by url stays a separate file.
   --no-output-html-inline                                                            Negative 'output-html-inline' option.
-  --output-html-inline-reset                                                         Clear all items provided in 'output.html.inline' configuration. Inline the content of matching chunks directly into the HTML instead of emitting a separate `<script>`/`<link>` tag. `true` inlines every chunk; `"script"` inlines only JavaScript, `"style"` only CSS; an array of `RegExp` patterns matches against the chunk name.
+  --output-html-inline-reset                                                         Clear all items provided in 'output.html.inline' configuration. Inline the content of matching chunks directly into the HTML instead of emitting a separate `<script>`/`<link>` tag. `true` inlines every chunk; `"script"` inlines only JavaScript, `"style"` only CSS; an array of `RegExp` patterns matches against the chunk name and the filename template it is emitted under. A chunk another entry loads its runtime from by url stays a separate file.
   --output-html-integrity [value...]                                                 A hash algorithm name passed to Node.js `crypto.createHash` (e.g. 'sha256', 'sha384', 'sha512'). Add Subresource Integrity (SRI) `integrity` attributes to injected `<script>`/`<link>` tags. `true` uses `['sha384']`; an array sets the hash algorithms; a function receives each referenced asset and returns the algorithms to use or `false` to skip it.
   --no-output-html-integrity                                                         Negative 'output-html-integrity' option.
   --output-html-integrity-reset                                                      Clear all items provided in 'output.html.integrity' configuration. Add Subresource Integrity (SRI) `integrity` attributes to injected `<script>`/`<link>` tags. `true` uses `['sha384']`; an array sets the hash algorithms; a function receives each referenced asset and returns the algorithms to use or `false` to skip it.
@@ -1494,6 +1550,7 @@ Options
   --output-library-auxiliary-comment-commonjs <value>                                Set comment for `commonjs` (exports) section in UMD.
   --output-library-auxiliary-comment-commonjs2 <value>                               Set comment for `commonjs2` (module.exports) section in UMD.
   --output-library-auxiliary-comment-root <value>                                    Set comment for `root` (global variable) section in UMD.
+  --output-library-entry-exports <value>                                             Which modules of an entry the library exposes the exports of: only the last one, or all of them, where a name more than one module binds differently is left out, as 'export *' does.
   --output-library-export <value...>                                                 Part of the export that should be exposed as library.
   --output-library-export-reset                                                      Clear all items provided in 'output.library.export' configuration. Specify which export should be exposed as library.
   --output-library-name <value...>                                                   A part of the library name.
@@ -1710,7 +1767,7 @@ Options
   --no-resolve-prefer-absolute                                                       Negative 'resolve-prefer-absolute' option.
   --resolve-prefer-relative                                                          Prefer to resolve module requests as relative request and fallback to resolving as module.
   --no-resolve-prefer-relative                                                       Negative 'resolve-prefer-relative' option.
-  --resolve-restrictions <value...>                                                  Resolve restriction. Resolve result must fulfill this restriction.
+  --resolve-restrictions <value...>                                                  Resolve restriction. Resolve result must fulfill this restriction. A glob the resolve result must match at any depth.
   --resolve-restrictions-reset                                                       Clear all items provided in 'resolve.restrictions' configuration. A list of resolve restrictions. Resolve results must fulfill all of these restrictions to resolve successfully. Other resolve paths are taken when restrictions are not met.
   --resolve-roots <value...>                                                         Directory in which requests that are server-relative URLs (starting with '/') are resolved.
   --resolve-roots-reset                                                              Clear all items provided in 'resolve.roots' configuration. A list of directories in which requests that are server-relative URLs (starting with '/') are resolved.
@@ -1766,7 +1823,7 @@ Options
   --no-resolve-loader-prefer-absolute                                                Negative 'resolve-loader-prefer-absolute' option.
   --resolve-loader-prefer-relative                                                   Prefer to resolve module requests as relative request and fallback to resolving as module.
   --no-resolve-loader-prefer-relative                                                Negative 'resolve-loader-prefer-relative' option.
-  --resolve-loader-restrictions <value...>                                           Resolve restriction. Resolve result must fulfill this restriction.
+  --resolve-loader-restrictions <value...>                                           Resolve restriction. Resolve result must fulfill this restriction. A glob the resolve result must match at any depth.
   --resolve-loader-restrictions-reset                                                Clear all items provided in 'resolveLoader.restrictions' configuration. A list of resolve restrictions. Resolve results must fulfill all of these restrictions to resolve successfully. Other resolve paths are taken when restrictions are not met.
   --resolve-loader-roots <value...>                                                  Directory in which requests that are server-relative URLs (starting with '/') are resolved.
   --resolve-loader-roots-reset                                                       Clear all items provided in 'resolveLoader.roots' configuration. A list of directories in which requests that are server-relative URLs (starting with '/') are resolved.
@@ -1788,9 +1845,9 @@ Options
   --no-snapshot-context-module-hash                                                  Negative 'snapshot-context-module-hash' option.
   --snapshot-context-module-timestamp                                                Use timestamps of the files/directories to determine invalidation.
   --no-snapshot-context-module-timestamp                                             Negative 'snapshot-context-module-timestamp' option.
-  --snapshot-immutable-paths <value...>                                              A RegExp matching an immutable directory (usually a package manager cache directory, including the tailing slash) A path to an immutable directory (usually a package manager cache directory).
+  --snapshot-immutable-paths <value...>                                              A RegExp matching an immutable directory (usually a package manager cache directory, including the tailing slash) A path to an immutable directory (usually a package manager cache directory). A glob matching an immutable directory at any depth, or relative to the context when it starts with `./` or `../`; a path under several matches takes the outermost.
   --snapshot-immutable-paths-reset                                                   Clear all items provided in 'snapshot.immutablePaths' configuration. List of paths that are managed by a package manager and contain a version or hash in its path so all files are immutable.
-  --snapshot-managed-paths <value...>                                                A RegExp matching a managed directory (usually a node_modules directory, including the tailing slash) A path to a managed directory (usually a node_modules directory).
+  --snapshot-managed-paths <value...>                                                A RegExp matching a managed directory (usually a node_modules directory, including the tailing slash) A path to a managed directory (usually a node_modules directory). A glob matching a managed directory at any depth (e.g. `node_modules`), or relative to the context when it starts with `./` or `../`; a path under several matches takes the outermost.
   --snapshot-managed-paths-reset                                                     Clear all items provided in 'snapshot.managedPaths' configuration. List of paths that are managed by a package manager and can be trusted to not be modified otherwise.
   --snapshot-module-hash                                                             Use hashes of the content of the files/directories to determine invalidation.
   --no-snapshot-module-hash                                                          Negative 'snapshot-module-hash' option.
@@ -1804,7 +1861,7 @@ Options
   --no-snapshot-resolve-build-dependencies-hash                                      Negative 'snapshot-resolve-build-dependencies-hash' option.
   --snapshot-resolve-build-dependencies-timestamp                                    Use timestamps of the files/directories to determine invalidation.
   --no-snapshot-resolve-build-dependencies-timestamp                                 Negative 'snapshot-resolve-build-dependencies-timestamp' option.
-  --snapshot-unmanaged-paths <value...>                                              A RegExp matching an unmanaged directory. A path to an unmanaged directory.
+  --snapshot-unmanaged-paths <value...>                                              A RegExp matching an unmanaged directory. A path to an unmanaged directory. A glob matching an unmanaged directory at any depth, or relative to the context when it starts with `./` or `../`; a path under several matches takes the outermost.
   --snapshot-unmanaged-paths-reset                                                   Clear all items provided in 'snapshot.unmanagedPaths' configuration. List of paths that are not managed by a package manager and the contents are subject to change.
   --stats [value]                                                                    Stats options object or preset name.
   --no-stats                                                                         Negative 'stats' option.