@maizzle/framework 6.0.0-rc.17 → 6.0.0-rc.19

package/dist/transformers/inlineLink.d.ts

@@ -4,11 +4,32 @@ import { ChildNode } from "domhandler";
 /**
  * Inline `<link rel="stylesheet">` tags as `<style>` tags.
  *
- * - Local file paths are always inlined (resolved relative to the template)
- * - Remote URLs (http/https) are only inlined if the `inline` attribute is present
- * - Runs before the tailwindcss transformer so CSS is compiled normally
+ * - Local file paths are inlined when `filePath` is provided (resolved
+ *   relative to it).
+ * - Remote URLs (`http://` / `https://`) are only inlined when the link
+ *   carries an `inline` attribute, e.g. `<link rel="stylesheet" inline href="…">`.
+ *
+ * @param html     HTML string to transform.
+ * @param filePath Path of the source file the HTML came from, used as the
+ *                 base for resolving relative `href` values. Required for
+ *                 local-file inlining; remote `inline` links work without it.
+ * @returns        The transformed HTML string.
+ *
+ * @example
+ * import { inlineLink } from '@maizzle/framework'
+ *
+ * const out = await inlineLink(
+ *   '<link rel="stylesheet" href="./styles.css">',
+ *   '/path/to/template.html',
+ * )
+ */
+declare function inlineLink(html: string, filePath?: string): Promise<string>;
+/**
+ * DOM-form of {@link inlineLink} used by the internal transformer pipeline.
+ * Takes a parsed DOM, returns a parsed DOM — avoids redundant
+ * serialize/parse round-trips when chained with other transformers.
  */
-declare function inlineLink(dom: ChildNode[], filePath?: string): Promise<ChildNode[]>;
+declare function inlineLinkDom(dom: ChildNode[], filePath?: string): Promise<ChildNode[]>;
 //#endregion
-export { inlineLink };
+export { inlineLink, inlineLinkDom };
 //# sourceMappingURL=inlineLink.d.ts.map

package/dist/transformers/inlineLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inlineLink.d.ts","names":[],"sources":["../../src/transformers/inlineLink.ts"],"mappings":";;;;;AAYA;;;;;iBAAsB,UAAA,CAAW,GAAA,EAAK,SAAA,IAAa,QAAA,YAAoB,OAAA,CAAQ,SAAA"}
+{"version":3,"file":"inlineLink.d.ts","names":[],"sources":["../../src/transformers/inlineLink.ts"],"mappings":";;;;;AA2BA;;;;;;;;;AASA;;;;;;;;;;;iBATsB,UAAA,CAAW,IAAA,UAAc,QAAA,YAAoB,OAAA;;;;;;iBAS7C,aAAA,CAAc,GAAA,EAAK,SAAA,IAAa,QAAA,YAAoB,OAAA,CAAQ,SAAA"}

package/dist/transformers/{inlineLink.mjs → inlineLink.js}

@@ -1,17 +1,41 @@
-import { walk } from "../utils/ast/walker.mjs";
-import "../utils/ast/index.mjs";
+import { parse } from "../utils/ast/parser.js";
+import { walk } from "../utils/ast/walker.js";
+import { serialize } from "../utils/ast/serializer.js";
+import "../utils/ast/index.js";
 import { readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-
 //#region src/transformers/inlineLink.ts
 /**
 * Inline `<link rel="stylesheet">` tags as `<style>` tags.
 *
-* - Local file paths are always inlined (resolved relative to the template)
-* - Remote URLs (http/https) are only inlined if the `inline` attribute is present
-* - Runs before the tailwindcss transformer so CSS is compiled normally
+* - Local file paths are inlined when `filePath` is provided (resolved
+*   relative to it).
+* - Remote URLs (`http://` / `https://`) are only inlined when the link
+*   carries an `inline` attribute, e.g. `<link rel="stylesheet" inline href="…">`.
+*
+* @param html     HTML string to transform.
+* @param filePath Path of the source file the HTML came from, used as the
+*                 base for resolving relative `href` values. Required for
+*                 local-file inlining; remote `inline` links work without it.
+* @returns        The transformed HTML string.
+*
+* @example
+* import { inlineLink } from '@maizzle/framework'
+*
+* const out = await inlineLink(
+*   '<link rel="stylesheet" href="./styles.css">',
+*   '/path/to/template.html',
+* )
 */
-async function inlineLink(dom, filePath) {
+async function inlineLink(html, filePath) {
+	return serialize(await inlineLinkDom(parse(html), filePath));
+}
+/**
+* DOM-form of {@link inlineLink} used by the internal transformer pipeline.
+* Takes a parsed DOM, returns a parsed DOM — avoids redundant
+* serialize/parse round-trips when chained with other transformers.
+*/
+async function inlineLinkDom(dom, filePath) {
 	const links = [];
 	walk(dom, (node) => {
 		if (node.name !== "link") return;
@@ -70,7 +94,7 @@ async function inlineLink(dom, filePath) {
 	}
 	return dom;
 }
-
 //#endregion
-export { inlineLink };
-//# sourceMappingURL=inlineLink.mjs.map
+export { inlineLink, inlineLinkDom };
+
+//# sourceMappingURL=inlineLink.js.map

package/dist/transformers/inlineLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineLink.js","names":[],"sources":["../../src/transformers/inlineLink.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport { resolve, dirname } from 'node:path'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\n/**\n * Inline `<link rel=\"stylesheet\">` tags as `<style>` tags.\n *\n * - Local file paths are inlined when `filePath` is provided (resolved\n *   relative to it).\n * - Remote URLs (`http://` / `https://`) are only inlined when the link\n *   carries an `inline` attribute, e.g. `<link rel=\"stylesheet\" inline href=\"…\">`.\n *\n * @param html     HTML string to transform.\n * @param filePath Path of the source file the HTML came from, used as the\n *                 base for resolving relative `href` values. Required for\n *                 local-file inlining; remote `inline` links work without it.\n * @returns        The transformed HTML string.\n *\n * @example\n * import { inlineLink } from '@maizzle/framework'\n *\n * const out = await inlineLink(\n *   '<link rel=\"stylesheet\" href=\"./styles.css\">',\n *   '/path/to/template.html',\n * )\n */\nexport async function inlineLink(html: string, filePath?: string): Promise<string> {\n  return serialize(await inlineLinkDom(parse(html), filePath))\n}\n\n/**\n * DOM-form of {@link inlineLink} used by the internal transformer pipeline.\n * Takes a parsed DOM, returns a parsed DOM — avoids redundant\n * serialize/parse round-trips when chained with other transformers.\n */\nexport async function inlineLinkDom(dom: ChildNode[], filePath?: string): Promise<ChildNode[]> {\n  const links: { node: Element; parent: ChildNode; index: number }[] = []\n\n  walk(dom, (node) => {\n    if ((node as Element).name !== 'link') return\n\n    const el = node as Element\n    const attrs = el.attribs || {}\n\n    if (attrs.rel !== 'stylesheet' || !attrs.href) return\n\n    const parent = el.parent as ChildNode\n\n    if (parent && 'children' in parent) {\n      const index = (parent.children as ChildNode[]).indexOf(el)\n      if (index !== -1) {\n        links.push({ node: el, parent, index })\n      }\n    } else {\n      // Top-level node\n      const index = dom.indexOf(el)\n      if (index !== -1) {\n        links.push({ node: el, parent: null as any, index })\n      }\n    }\n  })\n\n  for (const { node, parent, index } of links) {\n    const href = node.attribs.href\n    const isRemote = href.startsWith('http://') || href.startsWith('https://')\n\n    let css: string | undefined\n\n    if (isRemote) {\n      if (!('inline' in node.attribs)) continue\n\n      try {\n        const response = await fetch(href)\n        css = await response.text()\n      } catch {\n        continue\n      }\n    } else {\n      if (!filePath) continue\n\n      try {\n        const absolutePath = resolve(dirname(filePath), href)\n        css = readFileSync(absolutePath, 'utf8')\n      } catch {\n        continue\n      }\n    }\n\n    const styleNode = {\n      type: 'tag',\n      name: 'style',\n      attribs: {},\n      children: [{\n        type: 'text',\n        data: css,\n        parent: null as any,\n      }],\n      parent: parent || null,\n    } as any\n\n    // Set parent reference on the text child\n    styleNode.children[0].parent = styleNode\n\n    const siblings = parent && 'children' in parent\n      ? parent.children as ChildNode[]\n      : dom\n\n    siblings.splice(index, 1, styleNode)\n  }\n\n  return dom\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,eAAsB,WAAW,MAAc,UAAoC;CACjF,OAAO,UAAU,MAAM,cAAc,MAAM,KAAK,EAAE,SAAS,CAAC;;;;;;;AAQ9D,eAAsB,cAAc,KAAkB,UAAyC;CAC7F,MAAM,QAA+D,EAAE;CAEvE,KAAK,MAAM,SAAS;EAClB,IAAK,KAAiB,SAAS,QAAQ;EAEvC,MAAM,KAAK;EACX,MAAM,QAAQ,GAAG,WAAW,EAAE;EAE9B,IAAI,MAAM,QAAQ,gBAAgB,CAAC,MAAM,MAAM;EAE/C,MAAM,SAAS,GAAG;EAElB,IAAI,UAAU,cAAc,QAAQ;GAClC,MAAM,QAAS,OAAO,SAAyB,QAAQ,GAAG;GAC1D,IAAI,UAAU,IACZ,MAAM,KAAK;IAAE,MAAM;IAAI;IAAQ;IAAO,CAAC;SAEpC;GAEL,MAAM,QAAQ,IAAI,QAAQ,GAAG;GAC7B,IAAI,UAAU,IACZ,MAAM,KAAK;IAAE,MAAM;IAAI,QAAQ;IAAa;IAAO,CAAC;;GAGxD;CAEF,KAAK,MAAM,EAAE,MAAM,QAAQ,WAAW,OAAO;EAC3C,MAAM,OAAO,KAAK,QAAQ;EAC1B,MAAM,WAAW,KAAK,WAAW,UAAU,IAAI,KAAK,WAAW,WAAW;EAE1E,IAAI;EAEJ,IAAI,UAAU;GACZ,IAAI,EAAE,YAAY,KAAK,UAAU;GAEjC,IAAI;IAEF,MAAM,OAAM,MADW,MAAM,KAAK,EACb,MAAM;WACrB;IACN;;SAEG;GACL,IAAI,CAAC,UAAU;GAEf,IAAI;IAEF,MAAM,aADe,QAAQ,QAAQ,SAAS,EAAE,KACjB,EAAE,OAAO;WAClC;IACN;;;EAIJ,MAAM,YAAY;GAChB,MAAM;GACN,MAAM;GACN,SAAS,EAAE;GACX,UAAU,CAAC;IACT,MAAM;IACN,MAAM;IACN,QAAQ;IACT,CAAC;GACF,QAAQ,UAAU;GACnB;EAGD,UAAU,SAAS,GAAG,SAAS;EAM/B,CAJiB,UAAU,cAAc,SACrC,OAAO,WACP,KAEK,OAAO,OAAO,GAAG,UAAU;;CAGtC,OAAO"}

package/dist/transformers/minify.d.ts

@@ -1,17 +1,21 @@
-import { MaizzleConfig } from "../types/config.js";
+import { Opts, Opts as MinifyOptions } from "html-crush";
 
 //#region src/transformers/minify.d.ts
 /**
- * Minify transformer.
+ * Minify an HTML string using `html-crush`. Maizzle's only default that
+ * differs from html-crush's own defaults is `removeLineBreaks: true`.
  *
- * Minifies HTML using the `html-crush` package.
- * Enabled by setting `minify: true` (or passing options object).
- * User options are merged on top of the defaults.
+ * @param html    HTML string to minify.
+ * @param options [html-crush options](https://codsen.com/os/html-crush) merged
+ *                on top of the Maizzle defaults.
+ * @returns       The minified HTML string.
  *
- * The only Maizzle default that differs from html-crush's own defaults
- * is `removeLineBreaks: true`.
+ * @example
+ * import { minify } from '@maizzle/framework'
+ *
+ * const tight = minify('<p>  hello  </p>', { removeIndentations: true })
  */
-declare function minify(html: string, config?: MaizzleConfig): string;
+declare function minify(html: string, options?: Partial<Opts>): string;
 //#endregion
-export { minify };
+export { type MinifyOptions, minify };
 //# sourceMappingURL=minify.d.ts.map

package/dist/transformers/minify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"minify.d.ts","names":[],"sources":["../../src/transformers/minify.ts"],"mappings":";;;;;AAmBA;;;;;;;;iBAAgB,MAAA,CAAO,IAAA,UAAc,MAAA,GAAQ,aAAA"}
+{"version":3,"file":"minify.d.ts","names":[],"sources":["../../src/transformers/minify.ts"],"mappings":";;;;AAwBA;;;;;;;;;;;;;iBAAgB,MAAA,CAAO,IAAA,UAAc,OAAA,GAAS,OAAA,CAAQ,IAAA"}

package/dist/transformers/minify.js

@@ -0,0 +1,25 @@
+import { defu as defu$1 } from "defu";
+import { crush } from "html-crush";
+//#region src/transformers/minify.ts
+const DEFAULT_OPTIONS = { removeLineBreaks: true };
+/**
+* Minify an HTML string using `html-crush`. Maizzle's only default that
+* differs from html-crush's own defaults is `removeLineBreaks: true`.
+*
+* @param html    HTML string to minify.
+* @param options [html-crush options](https://codsen.com/os/html-crush) merged
+*                on top of the Maizzle defaults.
+* @returns       The minified HTML string.
+*
+* @example
+* import { minify } from '@maizzle/framework'
+*
+* const tight = minify('<p>  hello  </p>', { removeIndentations: true })
+*/
+function minify(html, options = {}) {
+	return crush(html, defu$1(options, DEFAULT_OPTIONS)).result;
+}
+//#endregion
+export { minify };
+
+//# sourceMappingURL=minify.js.map

package/dist/transformers/minify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minify.js","names":["merge"],"sources":["../../src/transformers/minify.ts"],"sourcesContent":["import { crush } from 'html-crush'\nimport { defu as merge } from 'defu'\nimport type { Opts as HtmlCrushOptions } from 'html-crush'\n\nexport type { Opts as MinifyOptions } from 'html-crush'\n\nconst DEFAULT_OPTIONS: Partial<HtmlCrushOptions> = {\n  removeLineBreaks: true,\n}\n\n/**\n * Minify an HTML string using `html-crush`. Maizzle's only default that\n * differs from html-crush's own defaults is `removeLineBreaks: true`.\n *\n * @param html    HTML string to minify.\n * @param options [html-crush options](https://codsen.com/os/html-crush) merged\n *                on top of the Maizzle defaults.\n * @returns       The minified HTML string.\n *\n * @example\n * import { minify } from '@maizzle/framework'\n *\n * const tight = minify('<p>  hello  </p>', { removeIndentations: true })\n */\nexport function minify(html: string, options: Partial<HtmlCrushOptions> = {}): string {\n  const merged = merge(options, DEFAULT_OPTIONS) as Partial<HtmlCrushOptions>\n  return crush(html, merged).result\n}\n"],"mappings":";;;AAMA,MAAM,kBAA6C,EACjD,kBAAkB,MACnB;;;;;;;;;;;;;;;AAgBD,SAAgB,OAAO,MAAc,UAAqC,EAAE,EAAU;CAEpF,OAAO,MAAM,MADEA,OAAM,SAAS,gBACL,CAAC,CAAC"}

package/dist/transformers/msoPlaceholders.d.ts

@@ -0,0 +1,28 @@
+import { ChildNode } from "domhandler";
+
+//#region src/transformers/msoPlaceholders.d.ts
+/**
+ * Resolve all `__MAIZZLE_MSO*__` placeholders inside MSO conditional comments
+ * by reading inlined style + `data-*` markers on the paired elements.
+ *
+ * Two placeholder families:
+ *
+ * MSOW (`__MAIZZLE_MSOW_{id}__`) — emitted by `<Container>` and `<Section>`.
+ *   Source element is marked with `data-maizzle-msow-id`. Reads inlined
+ *   `max-width:` (falls back to `width:`) and normalizes to px. Falls
+ *   back to `data-maizzle-msow-fallback` (default `600px`) when the
+ *   value can't be parsed.
+ *
+ * MSOTDSTYLE (`__MAIZZLE_MSOTDSTYLE_{id}__`) — emitted by `<Container>`'s
+ *   MSO `<td>`. Source element is marked with `data-maizzle-mso-td-id`.
+ *   Copies every `padding*` declaration from inlined style and appends
+ *   the `data-maizzle-mso-style` value (the user's `msoStyle` prop).
+ *   Empty input resolves to '' so the placeholder collapses cleanly.
+ *
+ * Single collect-walk + single substitute-walk: the same Container div
+ * carries both marker kinds, so one element visit fills both maps.
+ */
+declare function msoPlaceholders(dom: ChildNode[]): ChildNode[];
+//#endregion
+export { msoPlaceholders };
+//# sourceMappingURL=msoPlaceholders.d.ts.map

package/dist/transformers/msoPlaceholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msoPlaceholders.d.ts","names":[],"sources":["../../src/transformers/msoPlaceholders.ts"],"mappings":";;;;;AA4CA;;;;;;;;;;;;;;;;;;;iBAAgB,eAAA,CAAgB,GAAA,EAAK,SAAA,KAAc,SAAA"}

package/dist/transformers/msoPlaceholders.js

@@ -0,0 +1,88 @@
+import { walk } from "../utils/ast/walker.js";
+import "../utils/ast/index.js";
+//#region src/transformers/msoPlaceholders.ts
+const RE_MAX_WIDTH = /(?:^|;\s*)max-width:\s*([^;]+)/i;
+const RE_WIDTH = /(?:^|;\s*)width:\s*([^;]+)/i;
+const RE_PERCENT = /^[\d.]+%$/;
+const PADDING_DECL_RE = /(?:^|;)\s*(padding(?:-[a-z-]+)?\s*:\s*[^;]+)/gi;
+function resolveWidth(value) {
+	const trimmed = value.trim();
+	if (RE_PERCENT.test(trimmed)) return trimmed;
+	const m = trimmed.match(/^([\d.]+)(px|rem|em|pt)?$/i);
+	if (!m) return null;
+	const n = parseFloat(m[1]);
+	switch ((m[2] || "px").toLowerCase()) {
+		case "px": return `${Math.round(n)}px`;
+		case "rem":
+		case "em": return `${Math.round(n * 16)}px`;
+		case "pt": return `${Math.round(n * 1.333)}px`;
+		default: return null;
+	}
+}
+/**
+* Resolve all `__MAIZZLE_MSO*__` placeholders inside MSO conditional comments
+* by reading inlined style + `data-*` markers on the paired elements.
+*
+* Two placeholder families:
+*
+* MSOW (`__MAIZZLE_MSOW_{id}__`) — emitted by `<Container>` and `<Section>`.
+*   Source element is marked with `data-maizzle-msow-id`. Reads inlined
+*   `max-width:` (falls back to `width:`) and normalizes to px. Falls
+*   back to `data-maizzle-msow-fallback` (default `600px`) when the
+*   value can't be parsed.
+*
+* MSOTDSTYLE (`__MAIZZLE_MSOTDSTYLE_{id}__`) — emitted by `<Container>`'s
+*   MSO `<td>`. Source element is marked with `data-maizzle-mso-td-id`.
+*   Copies every `padding*` declaration from inlined style and appends
+*   the `data-maizzle-mso-style` value (the user's `msoStyle` prop).
+*   Empty input resolves to '' so the placeholder collapses cleanly.
+*
+* Single collect-walk + single substitute-walk: the same Container div
+* carries both marker kinds, so one element visit fills both maps.
+*/
+function msoPlaceholders(dom) {
+	const widths = /* @__PURE__ */ new Map();
+	const tdStyles = /* @__PURE__ */ new Map();
+	walk(dom, (node) => {
+		const a = node.attribs;
+		if (!a) return;
+		const msowId = a["data-maizzle-msow-id"];
+		const tdId = a["data-maizzle-mso-td-id"];
+		if (!msowId && !tdId) return;
+		const style = a.style ?? "";
+		if (msowId) {
+			delete a["data-maizzle-msow-id"];
+			const fallback = a["data-maizzle-msow-fallback"] ?? "600px";
+			delete a["data-maizzle-msow-fallback"];
+			const raw = style.match(RE_MAX_WIDTH)?.[1] ?? style.match(RE_WIDTH)?.[1];
+			const resolved = raw ? resolveWidth(raw) : null;
+			widths.set(msowId, resolved ?? fallback);
+		}
+		if (tdId) {
+			delete a["data-maizzle-mso-td-id"];
+			const msoStyle = (a["data-maizzle-mso-style"] ?? "").trim().replace(/;\s*$/, "");
+			delete a["data-maizzle-mso-style"];
+			const parts = [];
+			if (style) for (const m of style.matchAll(PADDING_DECL_RE)) parts.push(m[1].trim());
+			if (msoStyle) parts.push(msoStyle);
+			tdStyles.set(tdId, parts.length ? ` style="${parts.join("; ")}"` : "");
+		}
+	});
+	if (widths.size === 0 && tdStyles.size === 0) return dom;
+	walk(dom, (node) => {
+		if (node.type !== "comment") return;
+		let data = node.data;
+		if (!data) return;
+		const hasMsow = widths.size > 0 && data.includes("__MAIZZLE_MSOW_");
+		const hasTd = tdStyles.size > 0 && data.includes("__MAIZZLE_MSOTDSTYLE_");
+		if (!hasMsow && !hasTd) return;
+		if (hasMsow) for (const [id, val] of widths) data = data.replaceAll(`__MAIZZLE_MSOW_${id}__`, val);
+		if (hasTd) for (const [id, val] of tdStyles) data = data.replaceAll(`__MAIZZLE_MSOTDSTYLE_${id}__`, val);
+		node.data = data;
+	});
+	return dom;
+}
+//#endregion
+export { msoPlaceholders };
+
+//# sourceMappingURL=msoPlaceholders.js.map

package/dist/transformers/msoPlaceholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msoPlaceholders.js","names":["el"],"sources":["../../src/transformers/msoPlaceholders.ts"],"sourcesContent":["import { walk } from '../utils/ast/index.ts'\nimport type { ChildNode, Element } from 'domhandler'\n\nconst RE_MAX_WIDTH = /(?:^|;\\s*)max-width:\\s*([^;]+)/i\nconst RE_WIDTH = /(?:^|;\\s*)width:\\s*([^;]+)/i\nconst RE_PERCENT = /^[\\d.]+%$/\nconst PADDING_DECL_RE = /(?:^|;)\\s*(padding(?:-[a-z-]+)?\\s*:\\s*[^;]+)/gi\n\nfunction resolveWidth(value: string): string | null {\n  const trimmed = value.trim()\n  if (RE_PERCENT.test(trimmed)) return trimmed\n  const m = trimmed.match(/^([\\d.]+)(px|rem|em|pt)?$/i)\n  if (!m) return null\n  const n = parseFloat(m[1])\n  switch ((m[2] || 'px').toLowerCase()) {\n    case 'px': return `${Math.round(n)}px`\n    case 'rem':\n    case 'em': return `${Math.round(n * 16)}px`\n    case 'pt': return `${Math.round(n * 1.333)}px`\n    default: return null\n  }\n}\n\n/**\n * Resolve all `__MAIZZLE_MSO*__` placeholders inside MSO conditional comments\n * by reading inlined style + `data-*` markers on the paired elements.\n *\n * Two placeholder families:\n *\n * MSOW (`__MAIZZLE_MSOW_{id}__`) — emitted by `<Container>` and `<Section>`.\n *   Source element is marked with `data-maizzle-msow-id`. Reads inlined\n *   `max-width:` (falls back to `width:`) and normalizes to px. Falls\n *   back to `data-maizzle-msow-fallback` (default `600px`) when the\n *   value can't be parsed.\n *\n * MSOTDSTYLE (`__MAIZZLE_MSOTDSTYLE_{id}__`) — emitted by `<Container>`'s\n *   MSO `<td>`. Source element is marked with `data-maizzle-mso-td-id`.\n *   Copies every `padding*` declaration from inlined style and appends\n *   the `data-maizzle-mso-style` value (the user's `msoStyle` prop).\n *   Empty input resolves to '' so the placeholder collapses cleanly.\n *\n * Single collect-walk + single substitute-walk: the same Container div\n * carries both marker kinds, so one element visit fills both maps.\n */\nexport function msoPlaceholders(dom: ChildNode[]): ChildNode[] {\n  const widths = new Map<string, string>()\n  const tdStyles = new Map<string, string>()\n\n  walk(dom, (node) => {\n    const el = node as Element\n    const a = el.attribs\n    if (!a) return\n\n    const msowId = a['data-maizzle-msow-id']\n    const tdId = a['data-maizzle-mso-td-id']\n    if (!msowId && !tdId) return\n\n    const style = a.style ?? ''\n\n    if (msowId) {\n      delete a['data-maizzle-msow-id']\n      const fallback = a['data-maizzle-msow-fallback'] ?? '600px'\n      delete a['data-maizzle-msow-fallback']\n      const raw = style.match(RE_MAX_WIDTH)?.[1] ?? style.match(RE_WIDTH)?.[1]\n      const resolved = raw ? resolveWidth(raw) : null\n      widths.set(msowId, resolved ?? fallback)\n    }\n\n    if (tdId) {\n      delete a['data-maizzle-mso-td-id']\n      const msoStyle = (a['data-maizzle-mso-style'] ?? '').trim().replace(/;\\s*$/, '')\n      delete a['data-maizzle-mso-style']\n\n      const parts: string[] = []\n      if (style) {\n        for (const m of style.matchAll(PADDING_DECL_RE)) {\n          parts.push(m[1].trim())\n        }\n      }\n      if (msoStyle) parts.push(msoStyle)\n\n      tdStyles.set(tdId, parts.length ? ` style=\"${parts.join('; ')}\"` : '')\n    }\n  })\n\n  if (widths.size === 0 && tdStyles.size === 0) return dom\n\n  walk(dom, (node) => {\n    if (node.type !== 'comment') return\n    let data = (node as any).data as string\n    if (!data) return\n    const hasMsow = widths.size > 0 && data.includes('__MAIZZLE_MSOW_')\n    const hasTd = tdStyles.size > 0 && data.includes('__MAIZZLE_MSOTDSTYLE_')\n    if (!hasMsow && !hasTd) return\n\n    if (hasMsow) {\n      for (const [id, val] of widths) {\n        data = data.replaceAll(`__MAIZZLE_MSOW_${id}__`, val)\n      }\n    }\n    if (hasTd) {\n      for (const [id, val] of tdStyles) {\n        data = data.replaceAll(`__MAIZZLE_MSOTDSTYLE_${id}__`, val)\n      }\n    }\n    ;(node as any).data = data\n  })\n\n  return dom\n}\n"],"mappings":";;;AAGA,MAAM,eAAe;AACrB,MAAM,WAAW;AACjB,MAAM,aAAa;AACnB,MAAM,kBAAkB;AAExB,SAAS,aAAa,OAA8B;CAClD,MAAM,UAAU,MAAM,MAAM;CAC5B,IAAI,WAAW,KAAK,QAAQ,EAAE,OAAO;CACrC,MAAM,IAAI,QAAQ,MAAM,6BAA6B;CACrD,IAAI,CAAC,GAAG,OAAO;CACf,MAAM,IAAI,WAAW,EAAE,GAAG;CAC1B,SAAS,EAAE,MAAM,MAAM,aAAa,EAApC;EACE,KAAK,MAAM,OAAO,GAAG,KAAK,MAAM,EAAE,CAAC;EACnC,KAAK;EACL,KAAK,MAAM,OAAO,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC;EACxC,KAAK,MAAM,OAAO,GAAG,KAAK,MAAM,IAAI,MAAM,CAAC;EAC3C,SAAS,OAAO;;;;;;;;;;;;;;;;;;;;;;;;AAyBpB,SAAgB,gBAAgB,KAA+B;CAC7D,MAAM,yBAAS,IAAI,KAAqB;CACxC,MAAM,2BAAW,IAAI,KAAqB;CAE1C,KAAK,MAAM,SAAS;EAElB,MAAM,IAAIA,KAAG;EACb,IAAI,CAAC,GAAG;EAER,MAAM,SAAS,EAAE;EACjB,MAAM,OAAO,EAAE;EACf,IAAI,CAAC,UAAU,CAAC,MAAM;EAEtB,MAAM,QAAQ,EAAE,SAAS;EAEzB,IAAI,QAAQ;GACV,OAAO,EAAE;GACT,MAAM,WAAW,EAAE,iCAAiC;GACpD,OAAO,EAAE;GACT,MAAM,MAAM,MAAM,MAAM,aAAa,GAAG,MAAM,MAAM,MAAM,SAAS,GAAG;GACtE,MAAM,WAAW,MAAM,aAAa,IAAI,GAAG;GAC3C,OAAO,IAAI,QAAQ,YAAY,SAAS;;EAG1C,IAAI,MAAM;GACR,OAAO,EAAE;GACT,MAAM,YAAY,EAAE,6BAA6B,IAAI,MAAM,CAAC,QAAQ,SAAS,GAAG;GAChF,OAAO,EAAE;GAET,MAAM,QAAkB,EAAE;GAC1B,IAAI,OACF,KAAK,MAAM,KAAK,MAAM,SAAS,gBAAgB,EAC7C,MAAM,KAAK,EAAE,GAAG,MAAM,CAAC;GAG3B,IAAI,UAAU,MAAM,KAAK,SAAS;GAElC,SAAS,IAAI,MAAM,MAAM,SAAS,WAAW,MAAM,KAAK,KAAK,CAAC,KAAK,GAAG;;GAExE;CAEF,IAAI,OAAO,SAAS,KAAK,SAAS,SAAS,GAAG,OAAO;CAErD,KAAK,MAAM,SAAS;EAClB,IAAI,KAAK,SAAS,WAAW;EAC7B,IAAI,OAAQ,KAAa;EACzB,IAAI,CAAC,MAAM;EACX,MAAM,UAAU,OAAO,OAAO,KAAK,KAAK,SAAS,kBAAkB;EACnE,MAAM,QAAQ,SAAS,OAAO,KAAK,KAAK,SAAS,wBAAwB;EACzE,IAAI,CAAC,WAAW,CAAC,OAAO;EAExB,IAAI,SACF,KAAK,MAAM,CAAC,IAAI,QAAQ,QACtB,OAAO,KAAK,WAAW,kBAAkB,GAAG,KAAK,IAAI;EAGzD,IAAI,OACF,KAAK,MAAM,CAAC,IAAI,QAAQ,UACtB,OAAO,KAAK,WAAW,wBAAwB,GAAG,KAAK,IAAI;EAG9D,KAAc,OAAO;GACtB;CAEF,OAAO"}

package/dist/transformers/purgeCss.d.ts

@@ -0,0 +1,43 @@
+import { ChildNode } from "domhandler";
+import { Opts } from "email-comb";
+
+//#region src/transformers/purgeCss.d.ts
+/**
+ * Options for the `purgeCss` transformer.
+ */
+interface PurgeCssOptions extends Partial<Omit<Opts, 'whitelist'>> {
+  /**
+   * Selectors to preserve regardless of whether they're matched in the
+   * markup. Appended to Maizzle's built-in safelist (Gmail, Apple Mail,
+   * Outlook.com hooks, etc). Mapped to email-comb's `whitelist` option.
+   */
+  safelist?: string[];
+}
+/**
+ * Remove unused CSS from an HTML string.
+ *
+ * Uses `email-comb` together with a DOM-aware deep-purge step to strip
+ * CSS selectors and class/id references that are not matched anywhere
+ * in the document body.
+ *
+ * @param html    HTML string to transform.
+ * @param options Email-comb options plus a Maizzle `safelist`.
+ * @returns       The transformed HTML string.
+ *
+ * @example
+ * import { purgeCss } from '@maizzle/framework'
+ *
+ * const out = purgeCss('<style>.a{}.b{}</style><p class="a">x</p>', {
+ *   safelist: ['.keep'],
+ * })
+ */
+declare function purgeCss(html: string, options?: PurgeCssOptions): string;
+/**
+ * DOM-form of {@link purgeCss} used by the internal transformer
+ * pipeline. Takes a parsed DOM, returns a parsed DOM — avoids redundant
+ * serialize/parse round-trips when chained with other transformers.
+ */
+declare function purgeCssDom(dom: ChildNode[], options?: PurgeCssOptions): ChildNode[];
+//#endregion
+export { PurgeCssOptions, purgeCss, purgeCssDom };
+//# sourceMappingURL=purgeCss.d.ts.map

package/dist/transformers/purgeCss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purgeCss.d.ts","names":[],"sources":["../../src/transformers/purgeCss.ts"],"mappings":";;;;;;AAqCA;UAAiB,eAAA,SAAwB,OAAA,CAAQ,IAAA,CAAK,IAAA;;;;;;EAMpD,QAAA;AAAA;;;;;;AAqBF;;;;;;;;;AASA;;;;iBATgB,QAAA,CAAS,IAAA,UAAc,OAAA,GAAS,eAAA;;;;;;iBAShC,WAAA,CAAY,GAAA,EAAK,SAAA,IAAa,OAAA,GAAS,eAAA,GAAuB,SAAA"}

package/dist/transformers/{purgeCSS.mjs → purgeCss.js}

@@ -1,13 +1,12 @@
-import { parse } from "../utils/ast/parser.mjs";
-import { walk } from "../utils/ast/walker.mjs";
-import { serialize } from "../utils/ast/serializer.mjs";
-import "../utils/ast/index.mjs";
-import { defu } from "defu";
+import { parse } from "../utils/ast/parser.js";
+import { walk } from "../utils/ast/walker.js";
+import { serialize } from "../utils/ast/serializer.js";
+import "../utils/ast/index.js";
+import { defu as defu$1 } from "defu";
 import safeParser from "postcss-safe-parser";
 import { selectAll } from "css-select";
 import { comb } from "email-comb";
-
-//#region src/transformers/purgeCSS.ts
+//#region src/transformers/purgeCss.ts
 const DEFAULT_SAFELIST = [
 	"*body*",
 	".gmail*",
@@ -36,27 +35,35 @@ const DEFAULT_OPTIONS = {
 	whitelist: [...DEFAULT_SAFELIST]
 };
 /**
-* Remove unused CSS transformer.
+* Remove unused CSS from an HTML string.
+*
+* Uses `email-comb` together with a DOM-aware deep-purge step to strip
+* CSS selectors and class/id references that are not matched anywhere
+* in the document body.
 *
-* Uses `email-comb` to strip CSS selectors and corresponding class/id
-* references that are not matched anywhere in the HTML body.
+* @param html    HTML string to transform.
+* @param options Email-comb options plus a Maizzle `safelist`.
+* @returns       The transformed HTML string.
 *
-* Enable by setting `css.purge: true` (or passing options).
-* The user-supplied options are merged on top of the defaults, so
-* `safelist` values are **appended** to the built-in safelist rather
-* than replacing it.
+* @example
+* import { purgeCss } from '@maizzle/framework'
 *
-* Accepts `ChildNode[]` as input, serializes internally before passing
-* to email-comb (which requires a raw HTML string), then parses the
-* result back to `ChildNode[]` so it fits in the DOM pipeline.
+* const out = purgeCss('<style>.a{}.b{}</style><p class="a">x</p>', {
+*   safelist: ['.keep'],
+* })
 */
-function purgeCSS(dom, config = {}) {
-	const option = config.purge;
-	if (!option) return dom;
-	const userOptions = typeof option === "object" ? option : {};
-	const userSafelist = Array.isArray(userOptions.safelist) ? userOptions.safelist : [];
-	const { safelist: _discard, ...restUserOptions } = userOptions;
-	const options = defu({
+function purgeCss(html, options = {}) {
+	return serialize(purgeCssDom(parse(html), options));
+}
+/**
+* DOM-form of {@link purgeCss} used by the internal transformer
+* pipeline. Takes a parsed DOM, returns a parsed DOM — avoids redundant
+* serialize/parse round-trips when chained with other transformers.
+*/
+function purgeCssDom(dom, options = {}) {
+	const userSafelist = Array.isArray(options.safelist) ? options.safelist : [];
+	const { safelist: _discard, ...restUserOptions } = options;
+	const combOptions = defu$1({
 		...restUserOptions,
 		whitelist: [...DEFAULT_SAFELIST, ...userSafelist]
 	}, DEFAULT_OPTIONS);
@@ -89,8 +96,8 @@ function purgeCSS(dom, config = {}) {
 		});
 		textNode.data = `${token}{}`;
 	});
-	if (extraWhitelist.length) options.whitelist = [...options.whitelist ?? [], ...extraWhitelist];
-	const { result } = comb(serialize(dom), options);
+	if (extraWhitelist.length) combOptions.whitelist = [...combOptions.whitelist ?? [], ...extraWhitelist];
+	const { result } = comb(serialize(dom), combOptions);
 	/**
 	* Comb returns a fresh string, so we work off the post-parse tree:
 	* find each embed style tag whose body still starts with the stub
@@ -168,7 +175,7 @@ function deepPurge(dom, safelist) {
 	});
 	return dom;
 }
-
 //#endregion
-export { purgeCSS };
-//# sourceMappingURL=purgeCSS.mjs.map
+export { purgeCss, purgeCssDom };
+
+//# sourceMappingURL=purgeCss.js.map

package/dist/transformers/purgeCss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purgeCss.js","names":["merge"],"sources":["../../src/transformers/purgeCss.ts"],"sourcesContent":["import { comb } from 'email-comb'\nimport { defu as merge } from 'defu'\nimport safeParser from 'postcss-safe-parser'\nimport { selectAll } from 'css-select'\nimport type { ChildNode, Element } from 'domhandler'\nimport type { Opts as CombOptions } from 'email-comb'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\nconst DEFAULT_SAFELIST: string[] = [\n  '*body*', // Gmail\n  '.gmail*', // Gmail\n  '.apple*', // Apple Mail\n  '.ios*', // Mail on iOS\n  '.ox-*', // Open-Xchange\n  '.outlook*', // Outlook.com\n  '[data-ogs*', // Outlook.com\n  '.bloop_container', // Airmail\n  '.Singleton', // Apple Mail 10\n  '.unused', // Notes 8\n  '.moz-text-html', // Thunderbird\n  '.mail-detail-content', // Comcast, Libero webmail\n  '*edo*', // Edison (all)\n  '#*', // Freenet uses #msgBody\n  '.lang*', // Fenced code blocks\n]\n\nconst DEFAULT_OPTIONS = {\n  backend: [\n    { heads: '{{', tails: '}}' },\n    { heads: '{%', tails: '%}' },\n  ],\n  whitelist: [...DEFAULT_SAFELIST],\n}\n\n/**\n * Options for the `purgeCss` transformer.\n */\nexport interface PurgeCssOptions extends Partial<Omit<CombOptions, 'whitelist'>> {\n  /**\n   * Selectors to preserve regardless of whether they're matched in the\n   * markup. Appended to Maizzle's built-in safelist (Gmail, Apple Mail,\n   * Outlook.com hooks, etc). Mapped to email-comb's `whitelist` option.\n   */\n  safelist?: string[]\n}\n\n/**\n * Remove unused CSS from an HTML string.\n *\n * Uses `email-comb` together with a DOM-aware deep-purge step to strip\n * CSS selectors and class/id references that are not matched anywhere\n * in the document body.\n *\n * @param html    HTML string to transform.\n * @param options Email-comb options plus a Maizzle `safelist`.\n * @returns       The transformed HTML string.\n *\n * @example\n * import { purgeCss } from '@maizzle/framework'\n *\n * const out = purgeCss('<style>.a{}.b{}</style><p class=\"a\">x</p>', {\n *   safelist: ['.keep'],\n * })\n */\nexport function purgeCss(html: string, options: PurgeCssOptions = {}): string {\n  return serialize(purgeCssDom(parse(html), options))\n}\n\n/**\n * DOM-form of {@link purgeCss} used by the internal transformer\n * pipeline. Takes a parsed DOM, returns a parsed DOM — avoids redundant\n * serialize/parse round-trips when chained with other transformers.\n */\nexport function purgeCssDom(dom: ChildNode[], options: PurgeCssOptions = {}): ChildNode[] {\n  const userSafelist = Array.isArray(options.safelist) ? options.safelist : []\n\n  const { safelist: _discard, ...restUserOptions } = options\n\n  // Merge user options on top of defaults.\n  // defu merges objects deeply; for arrays it appends user values.\n  // We want the user safelist appended to the default safelist,\n  // so we build whitelist manually.\n  const combOptions = merge(\n    { ...restUserOptions, whitelist: [...DEFAULT_SAFELIST, ...userSafelist] },\n    DEFAULT_OPTIONS,\n  )\n\n  // Deep purge first: DOM-aware selector removal using PostCSS + css-select.\n  // Runs before email-comb so that email-comb can clean up orphaned classes\n  // in HTML attributes left behind by removed CSS rules.\n  const safelist = [...DEFAULT_SAFELIST, ...userSafelist]\n  dom = deepPurge(dom, safelist)\n\n  /**\n   * Shield embed style tags from email-comb. Comb has no skip option,\n   * so it strips CSS comments and drops class refs it can't match\n   * against visible CSS. Swap each embed tag's body for a unique\n   * stub rule (`.maizzle-keep-N{}`) so comb keeps the tag, then\n   * whitelist that stub plus every selector from the original\n   * CSS so comb leaves matching refs alone elsewhere — and\n   * finally restore the original CSS once comb has run.\n   */\n  const stash: { token: string; original: string; textNode: any }[] = []\n  const extraWhitelist: string[] = []\n  walk(dom, (node) => {\n    const el = node as Element\n    if (el.name !== 'style' || !el.attribs) return\n    if (!('embed' in el.attribs) && !('data-embed' in el.attribs)) return\n    const textNode = el.children?.find((c: any) => c.type === 'text') as any\n    if (!textNode?.data) return\n    const idx = stash.length\n    const token = `.maizzle-keep-${idx}`\n    extraWhitelist.push(token)\n    for (const m of textNode.data.matchAll(/(?<![\\w-])[.#][a-zA-Z_][\\w-]*/g)) {\n      extraWhitelist.push(m[0])\n    }\n    stash.push({ token, original: textNode.data, textNode })\n    textNode.data = `${token}{}`\n  })\n\n  if (extraWhitelist.length) {\n    combOptions.whitelist = [...(combOptions.whitelist as string[] ?? []), ...extraWhitelist]\n  }\n\n  const { result } = comb(serialize(dom), combOptions)\n\n  /**\n   * Comb returns a fresh string, so we work off the post-parse tree:\n   * find each embed style tag whose body still starts with the stub\n   * token we planted earlier and swap the original CSS back in.\n   */\n  let purgedDom = parse(result)\n\n  if (stash.length) {\n    walk(purgedDom, (node) => {\n      const el = node as Element\n      if (el.name !== 'style' || !el.attribs) return\n      if (!('embed' in el.attribs) && !('data-embed' in el.attribs)) return\n      const textNode = el.children?.find((c: any) => c.type === 'text') as any\n      if (!textNode?.data) return\n      const trimmed = textNode.data.trim()\n      const match = stash.find(s => trimmed === `${s.token}{}` || trimmed.startsWith(`${s.token}{`))\n      if (match) textNode.data = match.original\n    })\n  }\n\n  // Clean up data-embed/embed attributes — no longer needed after purging\n  walk(purgedDom, (node) => {\n    const el = node as Element\n    if (el.name === 'style' && el.attribs) {\n      delete el.attribs['data-embed']\n      delete el.attribs.embed\n    }\n  })\n\n  return purgedDom\n}\n\n/**\n * Deep purge: uses PostCSS to parse CSS in non-embedded style tags,\n * then checks each selector against the DOM with css-select.\n * Removes rules where no selector matches any element.\n */\nfunction isSafelisted(selector: string, safelist: string[]): boolean {\n  return safelist.some((pattern) => {\n    if (pattern.startsWith('*') && pattern.endsWith('*')) {\n      return selector.includes(pattern.slice(1, -1))\n    }\n    if (pattern.endsWith('*')) {\n      return selector.startsWith(pattern.slice(0, -1))\n    }\n    if (pattern.startsWith('*')) {\n      return selector.endsWith(pattern.slice(1))\n    }\n    return selector === pattern\n  })\n}\n\nfunction deepPurge(dom: ChildNode[], safelist: string[]): ChildNode[] {\n  walk(dom, (node) => {\n    const el = node as Element\n\n    if (el.name !== 'style' || !el.attribs) return\n    if ('data-embed' in el.attribs || 'embed' in el.attribs) return\n\n    const textNode = el.children?.find((c: any) => c.type === 'text') as any\n    if (!textNode?.data?.trim()) return\n\n    const root = safeParser(textNode.data)\n\n    root.walkRules((rule) => {\n      // Skip rules inside @media or other at-rules — those may target\n      // states we can't match statically (hover, responsive, etc.)\n      if (rule.parent?.type === 'atrule') return\n\n      const selectors = rule.selectors ?? [rule.selector]\n      const matched = selectors.filter((sel) => {\n        // Keep safelisted selectors\n        if (isSafelisted(sel, safelist)) return true\n\n        // Skip pseudo-classes/elements that can't be matched statically.\n        // Functional pseudos like :not(), :is(), :where(), :has() are\n        // matchable by css-select, so we only skip dynamic/state ones.\n        if (/::[\\w-]/.test(sel)) return true\n        if (/(?<!:):(?!not\\b|is\\b|where\\b|has\\b)[\\w-]/.test(sel.replace(/\\\\./g, ''))) return true\n\n        try {\n          return selectAll(sel, dom).length > 0\n        } catch {\n          // If css-select can't parse the selector, keep it\n          return true\n        }\n      })\n\n      if (matched.length === 0) {\n        rule.remove()\n      } else if (matched.length < selectors.length) {\n        rule.selectors = matched\n      }\n    })\n\n    // Remove empty at-rules\n    root.walkAtRules((atRule) => {\n      if (atRule.nodes?.length === 0) {\n        atRule.remove()\n      }\n    })\n\n    const purgedCss = root.toString()\n\n    if (purgedCss.trim()) {\n      textNode.data = purgedCss\n    } else {\n      // Remove the style tag entirely if empty\n      const parent = el.parent\n      if (parent && 'children' in parent) {\n        const idx = parent.children.indexOf(el as any)\n        if (idx !== -1) parent.children.splice(idx, 1)\n      }\n    }\n  })\n\n  return dom\n}\n"],"mappings":"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"}

package/dist/transformers/removeAttributes.d.ts

@@ -1,31 +1,54 @@
-import { AttributesConfig } from "../types/config.js";
 import { ChildNode } from "domhandler";
 
 //#region src/transformers/removeAttributes.d.ts
 /**
- * Remove attributes transformer.
+ * Single attribute-removal rule.
+ */
+interface RemoveAttributeRule {
+  /** Attribute name to match. */
+  name: string;
+  /**
+   * Match condition for the attribute's value:
+   * - `string` — remove when the value matches exactly.
+   * - `RegExp` — remove when the value matches the regex.
+   * - `boolean` / omitted — remove when the value is empty.
+   */
+  value?: string | RegExp | boolean;
+}
+/**
+ * Entry passed to {@link removeAttributes}. A bare string targets the named
+ * attribute and removes it when its value is empty.
+ */
+type RemoveAttributeOption = string | RemoveAttributeRule;
+/**
+ * Remove HTML attributes from elements.
  *
- * Removes specified HTML attributes from elements.
+ * Empty `style` and `class` attributes are always stripped, regardless of
+ * what you pass. Your entries are appended to those defaults.
  *
- * By default, removes empty `style` and `class` attributes.
+ * - `'data-src'` — remove when the value is empty.
+ * - `{ name: 'id', value: 'test' }` — remove when the value matches exactly.
+ * - `{ name: 'data-id', value: /\d/ }` — remove when the value matches the regex.
  *
- * Supports:
- * - String: removes attribute when empty (boolean or empty string)
- * - Object with name and value: removes when attribute matches exactly
- * - Object with name and RegExp value: removes when attribute value matches regex
+ * @param html       HTML string to transform.
+ * @param attributes Additional attribute-removal rules to apply on top of the defaults.
+ * @returns          The transformed HTML string.
  *
- * Configured via `remove` array:
- * ```js
- * {
- *   remove: [
- *     'data-src',                    // Remove empty data-src attributes
- *     { name: 'id', value: 'test' }, // Remove id="test" exactly
- *     { name: 'data-id', value: /\d/ } // Remove data-id when value contains digits
- *   ]
- * }
- * ```
+ * @example
+ * import { removeAttributes } from '@maizzle/framework'
+ *
+ * const out = removeAttributes('<p style="" data-x="">x</p>', [
+ *   'data-x',
+ *   { name: 'role', value: 'none' },
+ * ])
+ */
+declare function removeAttributes(html: string, attributes?: RemoveAttributeOption[]): string;
+/**
+ * DOM-form of {@link removeAttributes} used by the internal transformer
+ * pipeline. Takes a parsed DOM, returns a parsed DOM — avoids redundant
+ * serialize/parse round-trips when chained with other transformers.
  */
-declare function removeAttributes(dom: ChildNode[], config?: AttributesConfig): ChildNode[];
+declare function removeAttributesDom(dom: ChildNode[], attributes?: RemoveAttributeOption[]): ChildNode[];
 //#endregion
-export { removeAttributes };
+export { RemoveAttributeOption, RemoveAttributeRule, removeAttributes, removeAttributesDom };
 //# sourceMappingURL=removeAttributes.d.ts.map

package/dist/transformers/removeAttributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"removeAttributes.d.ts","names":[],"sources":["../../src/transformers/removeAttributes.ts"],"mappings":";;;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;iBAAgB,gBAAA,CAAiB,GAAA,EAAK,SAAA,IAAa,MAAA,GAAQ,gBAAA,GAAwB,SAAA"}
+{"version":3,"file":"removeAttributes.d.ts","names":[],"sources":["../../src/transformers/removeAttributes.ts"],"mappings":";;;;;AAMA;UAAiB,mBAAA;;EAEf,IAAA;EAAA;;;;;AAcF;EAPE,KAAA,YAAiB,MAAA;AAAA;;;AA+BnB;;KAxBY,qBAAA,YAAiC,mBAAA;;;;;;;AAiC7C;;;;;;;;;;;;;;;;iBATgB,gBAAA,CAAiB,IAAA,UAAc,UAAA,GAAY,qBAAA;;;;;;iBAS3C,mBAAA,CAAoB,GAAA,EAAK,SAAA,IAAa,UAAA,GAAY,qBAAA,KAA+B,SAAA"}