html-minifier 4.0.0 → 5.0.0

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

@@ -0,0 +1,33 @@
+/**
+ * Single source of truth for minifier option names, descriptions, types, and shared defaults
+ */
+export type OptionDefinition = {
+    /**
+     * Help text, phrased for the option’s primary CLI form
+     */
+    description: string;
+    /**
+     * Help text for what enabling the option does, where `description` describes the negated form
+     */
+    descriptionAffirmative?: string;
+    /**
+     * Key into the parser and JSON Schema type maps in cli.js and scripts/build-schema.js
+     */
+    type: string;
+};
+/**
+ * @typedef {object} OptionDefinition
+ * @property {string} description Help text, phrased for the option’s primary CLI form
+ * @property {string} [descriptionAffirmative] Help text for what enabling the option does, where `description` describes the negated form
+ * @property {string} type Key into the parser and JSON Schema type maps in cli.js and scripts/build-schema.js
+ */
+/** @type {Record<string, OptionDefinition>} */
+declare const optionDefinitions: Record<string, OptionDefinition>;
+declare const optionDefaults: {
+    continueOnMinifyError: boolean;
+    ignoreCustomComments: RegExp[];
+    ignoreCustomFragments: RegExp[];
+    includeAutoGeneratedTags: boolean;
+};
+export { optionDefinitions, optionDefaults };
+//# sourceMappingURL=option-definitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"option-definitions.d.ts","sourceRoot":"","sources":["../../../src/lib/option-definitions.js"],"names":[],"mappings":"AAAA;;GAEG;AAGA,YAAkB,gBAAgB,GAClC;;;;IAAmB,WAAW,EAAnB,MAAM,CACjB;;;;IAAoB,sBAAsB,AAA1C,CACA,EADW,MAAM,CACjB;;;;IAAmB,IAAI,EAAZ,MAAM,CACnB;CAAA,CAAA;AALD;;;;;GAKG;AAEH,+CAA+C;AAC/C,QAAA,MAAM,iBAAiB,EADZ,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAuNzC,CAAC;AAEF,QAAA,MAAM,cAAc;IAClB,qBAAqB;IACrB,oBAAoB;IAIpB,qBAAqB;IAKrB,wBAAwB;CACzB,CAAC;AAEF,OAAO,EACL,iBAAiB,EACjB,cAAc,EACf,CAAC"}

package/dist/types/lib/options.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Options processing and per-document minification state
+ */
+import { LRU } from './utils.js';
+import type { MinifierOptions, HTMLAttribute } from '../htmlminifier.js';
+export type CSSContext = {
+    usedSymbols?: Set<string>;
+    usedElements?: Set<string>;
+    usedElementsKey?: string;
+    warned: Set<string>;
+};
+export type CSSResult = {
+    css: string;
+    warnings: string[];
+};
+export type ProcessedOptions = Omit<MinifierOptions, 'preset' | 'canCollapseWhitespace' | 'canTrimWhitespace' | 'ignoreCustomComments' | 'log' | 'minifyCSS' | 'minifyJS' | 'minifyURLs' | 'minifySVG' | 'removeUnusedCSS'> & {
+    name: (name: string) => string;
+    log: (message: any) => unknown;
+    ignoreCustomComments: RegExp[];
+    canCollapseWhitespace: (tag: string, attrs: HTMLAttribute[], defaultFn: (tag: string) => boolean) => boolean;
+    canTrimWhitespace: (tag: string, attrs: HTMLAttribute[], defaultFn: (tag: string) => boolean) => boolean;
+    minifyCSS: (text: string, type?: string, context?: CSSContext) => string | Promise<string>;
+    minifyJS: (text: string, inline?: boolean, isModule?: boolean) => string | Promise<string>;
+    minifyURLs: (text: string) => string | Promise<string>;
+    minifySVG: ((svgContent: string) => string | Promise<string>) | null;
+    canMinifyCSS: ((text: string, type?: 'inline' | 'media') => boolean) | null;
+    canMinifyJS: ((text: string, inline?: boolean) => boolean) | null;
+    canMinifySVG: ((text: string) => boolean) | null;
+    removeUnusedCSS: {
+        safelist: Array<string | RegExp>;
+        scripts: boolean;
+    } | null;
+    cssContext?: CSSContext;
+    documentState?: {
+        hasMathML: boolean;
+    };
+    baseState?: {
+        hasBase: boolean | undefined;
+        source: string;
+    };
+    parallelJS?: boolean;
+    nameParent?: (name: string) => string;
+    namesAsWritten?: boolean;
+    keepClosingSlashHTML?: boolean;
+    insideSVG?: boolean;
+    insideForeignContent?: boolean;
+    namespaceForeign?: 'svg' | 'math';
+};
+/** @param {ProcessedOptions} options */
+declare function shouldMinifyInnerHTML(options: ProcessedOptions): boolean;
+declare const optionKeysExtra: Set<string>;
+export type OptionDependency = OptionDependency[];
+/**
+ * Options that do nothing on their own, and the option each one needs to take effect
+ *
+ * Cache sizes are deliberately absent: They never change output, so they are
+ * configuration for a subsystem rather than a transform that silently fails.
+ *
+ * @typedef {object} OptionDependency
+ * @property {string} option
+ * @property {string} requires
+ * @property {(input: Record<string, any>) => string | false} [unusable] Clause saying why the prerequisite does not count even though it is set
+ * @property {boolean} [clear] Whether to null the option out, where leaving it set would cost work downstream
+ *
+ * @type {OptionDependency[]}
+ */
+declare const optionDependencies: ({
+    option: string;
+    requires: string;
+    unusable: (input: Record<string, any>) => "which a function of your own replaces" | false;
+    clear: boolean;
+} | {
+    unusable?: never;
+    clear?: never;
+    option: string;
+    requires: string;
+})[];
+/**
+ * @param {MinifierOptions} inputOptions - User-provided options
+ * @param {{getLightningCSS: Function, getTerser: Function, getSwc: Function, getSvgo: Function, cssMinifyCache: LRU, jsMinifyCache: LRU, svgMinifyCache: LRU}} deps - Dependencies from htmlminifier.js
+ * @returns {ProcessedOptions} Normalized options with defaults applied
+ */
+declare const processOptions: (inputOptions: MinifierOptions, { getLightningCSS, getTerser, getSwc, getSvgo, cssMinifyCache, jsMinifyCache, svgMinifyCache }: {
+    getLightningCSS: Function;
+    getTerser: Function;
+    getSwc: Function;
+    getSvgo: Function;
+    cssMinifyCache: LRU;
+    jsMinifyCache: LRU;
+    svgMinifyCache: LRU;
+}) => ProcessedOptions;
+export { optionDependencies, optionKeysExtra, shouldMinifyInnerHTML, processOptions };
+//# sourceMappingURL=options.d.ts.map

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

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

package/dist/types/lib/unused-css.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Unused-CSS removal
+ */
+/**
+ * Collect the class names and IDs a document references.
+ *
+ * Style sheet contents are excluded, so that a style sheet never counts as
+ * evidence for its own selectors. An `iframe srcdoc` value is not scanned,
+ * either: It holds a document of its own, minified against its own symbol set.
+ * Over-collecting is safe here (a symbol wrongly considered used is merely
+ * kept), under-collecting is not.
+ *
+ * @param {string} html - Raw document markup
+ * @param {boolean} includeScripts - Also treat identifiers inside inline `script` elements as used
+ * @param {((text: string) => string)} [decode] - Resolves character references in attribute values and foreign script contents
+ * @param {Set<string>} [elements] - Receives the element names the markup uses, lowercased, and the identifiers found in scripts, as possible element names
+ * @returns {Set<string>} Symbols to keep
+ */
+declare function collectUsedSymbols(html: string, includeScripts: boolean, decode?: ((text: string) => string), elements?: Set<string>): Set<string>;
+/**
+ * Determine which class/ID symbols a style sheet defines but the document doesn’t reference.
+ * @param {string} css - Style sheet contents
+ * @param {Set<string>} used - Symbols the document references
+ * @param {Array<string | RegExp>} safelist - Symbols to keep regardless
+ * @returns {string[]} Symbols safe to remove
+ */
+declare function findUnusedSymbols(css: string, used: Set<string>, safelist: Array<string | RegExp>): string[];
+/**
+ * Build the unused-CSS context for a document.
+ * @param {string} html - Raw document markup
+ * @param {boolean} includeScripts - Also treat identifiers inside inline `script` elements as used
+ * @param {((text: string) => string)} [decode] - Resolves character references in attribute values and foreign script contents
+ * @returns {{usedSymbols: Set<string>, usedElements: Set<string>, usedElementsKey: string}}
+ */
+declare function collectUsage(html: string, includeScripts: boolean, decode?: ((text: string) => string)): {
+    usedSymbols: Set<string>;
+    usedElements: Set<string>;
+    usedElementsKey: string;
+};
+/**
+ * Create a Lightning CSS `Selector` visitor that drops selectors naming an unused
+ * class, ID, or element from their list, so the rule stays for the selectors that
+ * remain (`unusedSymbols` alone only removes rules whose selectors are all unused).
+ *
+ * Only a selector’s own compounds are judged: Names inside pseudo-class and
+ * pseudo-element arguments (`:not(.x)`, `:host(.x)`) are left alone.
+ *
+ * @param {string[]} unusedSymbols - Class/ID symbols safe to remove, from `findUnusedSymbols`
+ * @param {Set<string>} usedElements - Lowercase element names the document contains or its scripts name
+ * @param {Array<string | RegExp>} safelist - Symbols to keep regardless
+ * @returns {(selector: Array<{type: string, name?: string}>) => [] | undefined}
+ */
+declare function createSelectorPruner(unusedSymbols: string[], usedElements: Set<string>, safelist: Array<string | RegExp>): (selector: Array<{
+    type: string;
+    name?: string;
+}>) => [] | undefined;
+/**
+ * Normalize the `removeUnusedCSS` option into a settled configuration.
+ *
+ * A misspelled key or a safelist that is not an array would otherwise protect
+ * nothing, and that only surfaces as a missing rule much later—so every value
+ * that gets dropped is reported.
+ *
+ * @param {boolean | {safelist?: Array<string | RegExp>, scripts?: boolean} | undefined} option
+ * @param {(message: string) => unknown} [warn] - Receives one message per ignored value
+ * @returns {{safelist: Array<string | RegExp>, scripts: boolean} | null} Null when disabled
+ */
+declare function normalizeUnusedCSSOptions(option: boolean | {
+    safelist?: Array<string | RegExp>;
+    scripts?: boolean;
+} | undefined, warn?: (message: string) => unknown): {
+    safelist: Array<string | RegExp>;
+    scripts: boolean;
+} | null;
+export { collectUsage, collectUsedSymbols, createSelectorPruner, findUnusedSymbols, normalizeUnusedCSSOptions };
+//# sourceMappingURL=unused-css.d.ts.map

package/dist/types/lib/unused-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-css.d.ts","sourceRoot":"","sources":["../../../src/lib/unused-css.js"],"names":[],"mappings":"AAAA;;GAEG;AA4KH;;;;;;;;;;;;;;GAcG;AACH,iBAAS,kBAAkB,CAAC,IAAI,EANrB,MAMqB,EAAE,cAAc,EALrC,OAKqC,EAAE,MAAM,AAJrD,CACA,EADQ,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAIoB,EAAE,QAAQ,AAH/D,CACA,EADQ,GAAG,CAAC,MAAM,CAG6C,GAFrD,GAAG,CAAC,MAAM,CAAC,CAoGvB;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,GAAG,EALnB,MAKmB,EAAE,IAAI,EAJzB,GAAG,CAAC,MAAM,CAIe,EAAE,QAAQ,EAHnC,KAAK,CAAC,MAAM,GAAG,MAAM,CAGc,GAFjC,MAAM,EAAE,CA4BpB;AA8CD;;;;;;GAMG;AACH,iBAAS,YAAY,CAAC,IAAI,EALf,MAKe,EAAE,cAAc,EAJ/B,OAI+B,EAAE,MAAM,AAH/C,CACA,EADQ,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAGc,GAFrC;IAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAC,CAsB1F;AAED;;;;;;;;;;;;GAYG;AACH,iBAAS,oBAAoB,CAAC,aAAa,EALhC,MAAM,EAK0B,EAAE,YAAY,EAJ9C,GAAG,CAAC,MAAM,CAIoC,EAAE,QAAQ,EAHxD,KAAK,CAAC,MAAM,GAAG,MAAM,CAGmC,GAFtD,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,CAAC,KAAK,EAAE,GAAG,SAAS,CA4B9E;AAID;;;;;;;;;;GAUG;AACH,iBAAS,yBAAyB,CAAC,MAAM,EAJ9B,OAAO,GAAG;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAC,GAAG,SAIrC,EAAE,IAAI,AAH5C,CACA,EADQ,CAAC,OAAO,EAAE,MAAM,KAAK,OAGe,GAFlC;IAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC,GAAG,IAAI,CAyCvE;AAED,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EAC1B,CAAC"}

package/dist/types/lib/urls.d.ts

@@ -0,0 +1,15 @@
+/**
+ * URL minification using Node’s WHATWG URL API
+ *
+ * Produces the shortest equivalent URL representation:
+ * - Same origin: shortest of root-relative or path-relative
+ * - Cross-origin, same scheme: scheme-relative (`//host/path`)
+ * - Otherwise: normalized absolute URL
+ */
+/**
+ * Create a URL minifier function for the given site context.
+ * @param {string} site - The site base URL (used to compute relative URLs)
+ * @returns {(url: string) => string} Minifier function that returns the shortest URL
+ */
+export declare function createUrlMinifier(site: string): (url: string) => string;
+//# sourceMappingURL=urls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../../src/lib/urls.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAH3B,MAG2B,GAFzB,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAkEnC"}

package/dist/types/lib/utils.d.ts

@@ -0,0 +1,132 @@
+/**
+ * General utility functions
+ */
+/**
+ * Stringify with sorted keys, for cache keys—values that can behave differently must not
+ * stringify alike, so unquoted markers stand in for what JSON cannot express
+ * @param {unknown} obj
+ * @returns {string}
+ */
+declare function stableStringify(obj: unknown): string;
+declare class LRU {
+    limit: number;
+    gets: number;
+    hits: number;
+    /** @type {Map<string, unknown>} */
+    map: Map<string, unknown>;
+    constructor(limit?: number);
+    /** @param {string} key */
+    get(key: string): unknown;
+    /**
+     * @param {string} key
+     * @param {unknown} value
+     */
+    set(key: string, value: unknown): void;
+    /** @param {string} key */
+    delete(key: string): void;
+    /** @returns {{ gets: number, hits: number, size: number, limit: number }} */
+    stats(): {
+        gets: number;
+        hits: number;
+        size: number;
+        limit: number;
+    };
+}
+declare const MAX_CACHE_ENTRY_SIZE: number;
+/** @param {string} str */
+declare function hashContent(str: string): string;
+/** @param {string} value */
+declare function uniqueId(value: string): string;
+/**
+ * Write decoded text or an attribute value for an XML parser to read it the same
+ * @param {string} value - Text or attribute value, decoded
+ * @param {boolean} [attribute] - Whether the value is an attribute value
+ * @returns {string}
+ */
+declare function escapeXML(value: string, attribute?: boolean): string;
+/**
+ * Read text in foreign content as HTML does: CDATA sections hold text as written,
+ * while what surrounds them reads character references
+ * @param {string} text
+ * @param {(text: string) => string} decode - `decodeHTML`
+ * @returns {string}
+ */
+declare function decodeForeignText(text: string, decode: (text: string) => string): string;
+/** @param {string} value */
+declare function identity(value: string): string;
+/**
+ * @param {unknown} value
+ * @returns {value is PromiseLike<any>}
+ */
+declare function isThenable(value: unknown): value is PromiseLike<any>;
+/** @param {string} value */
+declare function lowercase(value: string): string;
+/** @param {string} value */
+declare function paramCase(value: string): string;
+/**
+ * Asynchronously replace matches in a string.
+ * @param {string} str - Input string
+ * @param {RegExp} regex - Regular expression with global flag
+ * @param {Function} asyncFn - Async function to process each match
+ * @returns {Promise<string>} Processed string
+ */
+declare function replaceAsync(str: string, regex: RegExp, asyncFn: Function): Promise<string>;
+/** @param {string | RegExp} value */
+declare function parseRegExp(value: string | RegExp): RegExp | undefined;
+/**
+ * Which flag changes what a source matches, so that embedding the source where the
+ * flag cannot follow would silently match something else. `u` and `v` only narrow
+ * what syntax is legal, so a source valid under either stays valid without it—the
+ * difference never surfaces as a syntax error, and this stands in for the one that
+ * would otherwise be raised.
+ * @param {RegExp} pattern
+ * @returns {'u' | 'v' | 'm' | null} The flag the source depends on, or `null` where
+ *   every flag it carries would leave the source matching the same
+ */
+declare function lostFlag(pattern: RegExp): 'u' | 'v' | 'm' | null;
+/**
+ * A pattern’s source, rewritten to match the way its own flags make it match, for
+ * embedding in a larger regex that cannot carry them. `i` and `s` fit into a
+ * source; `m`, `u`, and `v` do not, and are left to the pattern it joins. Where
+ * `i` cannot be written in—a backreference, a range outside ASCII, a range that
+ * spans letters without being one—the source stands as it is, matching less than
+ * the pattern would rather than more.
+ * @param {RegExp} pattern
+ * @returns {string}
+ */
+declare function embedSource(pattern: RegExp): string;
+export type Repeat = {
+    text: string;
+    ranges: [number, number][] | null;
+};
+/**
+ * @param {RegExp | string} pattern - Pattern to judge, or a bare source to read
+ *   as it stands
+ * @returns {string | null} What makes the pattern a backtracking risk, phrased
+ *   to follow the pattern itself, or `null` where it is none
+ */
+declare function describeQuantifierRisk(pattern: RegExp | string): string | null;
+/**
+ * Find the index of the `>` that closes an opening tag, correctly skipping
+ * over quoted attribute values (which may contain `>`).
+ * @param {string} html
+ * @param {number} pos - Start position (just after the tag name)
+ * @param {number} [limit] - Position to stop the search at (exclusive)
+ * @returns {number} Index of the closing `>`, or -1 if not found
+ */
+declare function findTagEnd(html: string, pos: number, limit?: number): number;
+/**
+ * A package that resolves but fails to load—e.g., a native binding built for
+ * another platform—is not one another `npm install` fixes, so name what happened
+ * rather than the install command
+ *
+ * @param {string} label - Minifier name as it should read in the message
+ * @param {string} specifier - Package that failed to load
+ * @param {unknown} cause - Error the import rejected with
+ * @returns {string} Message describing the failure
+ */
+declare function describeDependencyFailure(label: string, specifier: string, cause: unknown): string;
+/** @param {string} doctype */
+declare function isQuirksDoctype(doctype: string): boolean;
+export { stableStringify, findTagEnd, LRU, MAX_CACHE_ENTRY_SIZE, hashContent, uniqueId, escapeXML, decodeForeignText, identity, isQuirksDoctype, isThenable, lowercase, paramCase, replaceAsync, parseRegExp, embedSource, lostFlag, describeQuantifierRisk, describeDependencyFailure };
+//# sourceMappingURL=utils.d.ts.map

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

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

package/dist/types/lib/whitespace.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Whitespace trimming and collapsing
+ */
+/** @param {string} str */
+declare const trimWhitespace: (str: string) => string;
+/** @param {string} str */
+declare function isAllWhitespace(str: string): boolean;
+/** @param {string} str */
+declare function endsWithWhitespace(str: string): boolean;
+/** @param {string} str */
+declare function collapseWhitespaceAll(str: string): string;
+/**
+ * @param {string} str
+ * @param {{decodeEntities?: boolean | undefined, preserveLineBreaks?: boolean | undefined}} options
+ */
+declare function collapseNoBreakSpaces(str: string, options: {
+    decodeEntities?: boolean | undefined;
+    preserveLineBreaks?: boolean | undefined;
+}): string;
+/**
+ * @param {string} str
+ * @param {{preserveLineBreaks?: boolean | undefined, conservativeCollapse?: boolean | undefined}} options
+ * @param {boolean} trimLeft
+ * @param {boolean} trimRight
+ * @param {boolean} [collapseAll]
+ * @param {boolean} [keepUntrimmed] - Whether a side not trimmed keeps its line breaks as written
+ */
+declare function collapseWhitespace(str: string, options: {
+    preserveLineBreaks?: boolean | undefined;
+    conservativeCollapse?: boolean | undefined;
+}, trimLeft: boolean, trimRight: boolean, collapseAll?: boolean, keepUntrimmed?: boolean): string;
+export type InlineSets = {
+    /**
+     * - Elements whose surrounding whitespace is kept
+     */
+    around: Set<string>;
+    /**
+     * - The same, spelled as end tags
+     */
+    aroundEnd: Set<string>;
+    /**
+     * - Elements whose inner whitespace is kept
+     */
+    within: Set<string>;
+    /**
+     * - The same, spelled as end tags
+     */
+    withinEnd: Set<string>;
+    /**
+     * - `within` under both spellings
+     */
+    withinEither: Set<string>;
+};
+/**
+ * @typedef {object} InlineSets
+ * @prop {Set<string>} around - Elements whose surrounding whitespace is kept
+ * @prop {Set<string>} aroundEnd - The same, spelled as end tags
+ * @prop {Set<string>} within - Elements whose inner whitespace is kept
+ * @prop {Set<string>} withinEnd - The same, spelled as end tags
+ * @prop {Set<string>} withinEither - `within` under both spellings
+ */
+/**
+ * Inline-element membership for the whitespace pass, each set paired with its end-tag
+ * spelling so a lookup takes the tag as it comes rather than slicing off the slash
+ * @param {Set<string>} around
+ * @param {Set<string>} within
+ * @returns {InlineSets}
+ */
+declare function buildInlineSets(around: Set<string>, within: Set<string>): InlineSets;
+declare const defaultInlineSets: InlineSets;
+/**
+ * @param {string} str
+ * @param {string} prevTag
+ * @param {string} nextTag
+ * @param {Array<{name: string, value?: string}>} prevAttrs
+ * @param {Array<{name: string, value?: string}>} nextAttrs
+ * @param {{preserveLineBreaks?: boolean, conservativeCollapse?: boolean, collapseInlineTagWhitespace?: boolean}} options
+ * @param {InlineSets} inlineSets
+ * @param {boolean} [collapseInside] - False where `canCollapseWhitespace` keeps runs inside the text as they are
+ */
+declare function collapseWhitespaceSmart(str: string, prevTag: string, nextTag: string, prevAttrs: Array<{
+    name: string;
+    value?: string;
+}>, nextAttrs: Array<{
+    name: string;
+    value?: string;
+}>, options: {
+    preserveLineBreaks?: boolean;
+    conservativeCollapse?: boolean;
+    collapseInlineTagWhitespace?: boolean;
+}, inlineSets: InlineSets, collapseInside?: boolean): string;
+/** @param {string} tag */
+declare function canCollapseWhitespace(tag: string): boolean;
+/** @param {string} tag */
+declare function canTrimWhitespace(tag: string): boolean;
+export { buildInlineSets, defaultInlineSets, endsWithWhitespace, trimWhitespace, collapseWhitespaceAll, collapseNoBreakSpaces, collapseWhitespace, collapseWhitespaceSmart, canCollapseWhitespace, canTrimWhitespace, isAllWhitespace };
+//# sourceMappingURL=whitespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whitespace.d.ts","sourceRoot":"","sources":["../../../src/lib/whitespace.js"],"names":[],"mappings":"AAAA;;GAEG;AA4BH,0BAA0B;AAC1B,QAAA,MAAM,cAAc,QADR,MAAM,WAQjB,CAAC;AAcF,0BAA0B;AAC1B,iBAAS,eAAe,CAAC,GAAG,EADhB,MACgB,WAU3B;AAGD,0BAA0B;AAC1B,iBAAS,kBAAkB,CAAC,GAAG,EADnB,MACmB,WAE9B;AAUD,0BAA0B;AAC1B,iBAAS,qBAAqB,CAAC,GAAG,EADtB,MACsB,UAOjC;AAwCD;;;GAGG;AACH,iBAAS,qBAAqB,CAAC,GAAG,EAHvB,MAGuB,EAAE,OAAO,EAFhC;IAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAE/C,UAW1C;AAID;;;;;;;GAOG;AACH,iBAAS,kBAAkB,CAAC,GAAG,EAPpB,MAOoB,EAAE,OAAO,EAN7B;IAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAMxD,EAAE,QAAQ,EALvC,OAKuC,EAAE,SAAS,EAJlD,OAIkD,EAAE,WAAW,AAHvE,CACA,EADQ,OAGuE,EAAE,aAAa,AAF9F,CACF,EADU,OAE8F,UAcxG;AAgHE,YAAkB,UAAU,GAC5B;;;;IAAoB,MAAM,EAAnB,GAAG,CAAC,MAAM,CAAC,CAClB;;;;IAAoB,SAAS,EAAtB,GAAG,CAAC,MAAM,CAAC,CAClB;;;;IAAoB,MAAM,EAAnB,GAAG,CAAC,MAAM,CAAC,CAClB;;;;IAAoB,SAAS,EAAtB,GAAG,CAAC,MAAM,CAAC,CAClB;;;;IAAoB,YAAY,EAAzB,GAAG,CAAC,MAAM,CAAC,CACpB;CAAA,CAAA;AAPD;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,iBAAS,eAAe,CAAC,MAAM,EAJpB,GAAG,CAAC,MAAM,CAIU,EAAE,MAAM,EAH5B,GAAG,CAAC,MAAM,CAGkB,GAF1B,UAAU,CAWtB;AAGD,QAAA,MAAM,iBAAiB,YAA8F,CAAC;AAkBtH;;;;;;;;;GASG;AACH,iBAAS,uBAAuB,CAAC,GAAG,EATzB,MASyB,EAAE,OAAO,EARlC,MAQkC,EAAE,OAAO,EAP3C,MAO2C,EAAE,SAAS,EANtD,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,CAMkB,EAAE,SAAS,EALjE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,CAK6B,EAAE,OAAO,EAJ1E;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAAC,2BAA2B,CAAC,EAAE,OAAO,CAAA;CAI1B,EAAE,UAAU,EAHtF,UAGsF,EAAE,cAAc,AAF9G,CACF,EADU,OAE6G,UAgEvH;AASD,0BAA0B;AAC1B,iBAAS,qBAAqB,CAAC,GAAG,EADtB,MACsB,WAEjC;AAED,0BAA0B;AAC1B,iBAAS,iBAAiB,CAAC,GAAG,EADlB,MACkB,WAE7B;AAED,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAChB,CAAC"}

package/dist/types/presets.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Preset configurations
+ *
+ * Presets provide curated option sets for common use cases:
+ * - `conservative`: Safe minification suitable for most projects
+ * - `comprehensive`: Aggressive minification for maximum file size reduction
+ */
+export declare const presets: {
+    conservative: {
+        caseSensitive: boolean;
+        collapseBooleanAttributes: boolean;
+        collapseWhitespace: boolean;
+        conservativeCollapse: boolean;
+        preserveLineBreaks: boolean;
+        removeComments: boolean;
+        removeDefaultTypeAttributes: boolean;
+        useShortDoctype: boolean;
+    };
+    comprehensive: {
+        collapseAttributeWhitespace: boolean;
+        collapseBooleanAttributes: boolean;
+        collapseEmptyAttributes: boolean;
+        collapseWhitespace: boolean;
+        decodeEntities: boolean;
+        mergeScripts: boolean;
+        minifyCSS: boolean;
+        minifyJS: boolean;
+        minifyJSON: boolean;
+        minifySVG: boolean;
+        minifyURLs: boolean;
+        removeAttributeQuotes: boolean;
+        removeComments: boolean;
+        removeDefaultTypeAttributes: boolean;
+        removeEmptyAttributes: boolean;
+        removeOptionalTags: boolean;
+        removeRedundantAttributes: boolean;
+        selfCloseForeignElements: boolean;
+        useShortDoctype: boolean;
+    };
+};
+/**
+ * @param {string} name - Preset name (“conservative” or “comprehensive”)
+ * @returns {object|null} Preset options object or null if not found
+ */
+export declare function getPreset(name: string): object | null;
+/**
+ * @returns {string[]} Array of preset names
+ */
+export declare function getPresetNames(): string[];
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/presets.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,OAAO;IAClB,YAAY;QACV,aAAa;QACb,yBAAyB;QACzB,kBAAkB;QAClB,oBAAoB;QACpB,kBAAkB;QAClB,cAAc;QACd,2BAA2B;QAC3B,eAAe;;IAEjB,aAAa;QACX,2BAA2B;QAC3B,yBAAyB;QACzB,uBAAuB;QACvB,kBAAkB;QAClB,cAAc;QACd,YAAY;QACZ,SAAS;QACT,QAAQ;QACR,UAAU;QACV,SAAS;QACT,UAAU;QACV,qBAAqB;QACrB,cAAc;QACd,2BAA2B;QAC3B,qBAAqB;QACrB,kBAAkB;QAClB,yBAAyB;QACzB,wBAAwB;QACxB,eAAe;;CAElB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAHnB,MAGmB,GAFjB,MAAM,GAAC,IAAI,CAMvB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAFjB,MAAM,EAAE,CAIpB"}

package/dist/types/tokenchain.d.ts

@@ -0,0 +1,36 @@
+declare class Sorter {
+    /** @type {Map<string, number>} */
+    rank: Map<string, number>;
+    /** @type {Map<string, Sorter | (() => Sorter)>} */
+    sorterMap: Map<string, Sorter | (() => Sorter)>;
+    constructor();
+    /** @param {string} token */
+    child(token: string): Sorter | undefined;
+    /**
+     * @param {string[]} tokens
+     * @param {number} fromIndex
+     * @returns {string[]}
+     */
+    sort(tokens: string[], fromIndex?: number): string[];
+}
+declare class TokenChain {
+    /** @type {Map<string, {lists: Map<string, {tokens: string[], weight: number}>, count: number, processed: number}>} */
+    map: Map<string, {
+        lists: Map<string, {
+            tokens: string[];
+            weight: number;
+        }>;
+        count: number;
+        processed: number;
+    }>;
+    constructor();
+    /**
+     * @param {string[]} tokens
+     * @param {number} [weight]
+     */
+    add(tokens: string[], weight?: number): void;
+    /** @param {Map<string, number>} [localeRanks] */
+    createSorter(localeRanks?: Map<string, number>): Sorter;
+}
+export default TokenChain;
+//# sourceMappingURL=tokenchain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenchain.d.ts","sourceRoot":"","sources":["../../src/tokenchain.js"],"names":[],"mappings":"AAAA,cAAM,MAAM;IAIR,kCAAkC;IAC7B,IAAI,EADE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAE9B,mDAAmD;IAC9C,SAAS,EADH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IALjD,cAOC;IAED,4BAA4B;IAC5B,KAAK,CAAC,KAAK,EADC,MACD,sBAQV;IAED;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAJA,MAAM,EAIN,EAAE,SAAS,GAHX,MAGe,GAFb,MAAM,EAAE,CAsCpB;CACF;AAID,cAAM,UAAU;IAGZ,sHAAsH;IACjH,GAAG,EADG,GAAG,CAAC,MAAM,EAAE;QAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;YAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;IAFpH,cAIC;IAED;;;OAGG;IACH,GAAG,CAAC,MAAM,EAHC,MAAM,EAGP,EAAE,MAAM,AAFf,CAAwB,EAAhB,MAEW,QAiBrB;IAED,iDAAiD;IACjD,YAAY,CAAC,WAAW,AADpB,CAA0C,EAAlC,GAAG,CAAC,MAAM,EAAE,MAAM,CACN,UAuDvB;CACF;eAEc,UAAU"}