@maizzle/framework 6.0.0-rc.2 → 6.0.0-rc.21

package/dist/transformers/inlineCss.d.ts

@@ -0,0 +1,84 @@
+import { ChildNode } from "domhandler";
+import { Options } from "juice";
+
+//#region src/transformers/inlineCss.d.ts
+/**
+ * Options for the `inlineCss` transformer. Accepts every Juice option plus a
+ * handful of Maizzle-specific extras.
+ */
+interface InlineCssOptions extends Options {
+  /**
+   * Convert `0px`, `0em` etc. to `0` in inline styles.
+   *
+   * @default true
+   */
+  preferUnitlessValues?: boolean;
+  /**
+   * CSS selectors to preserve in `<style>` tags, even after inlining.
+   * Mapped to Juice's `preservedSelectors` option.
+   *
+   * @default []
+   */
+  safelist?: string[];
+  /**
+   * Additional CSS string to inline alongside `<style>` tag contents.
+   * Mapped to Juice's `extraCss` option.
+   */
+  customCSS?: string;
+  /**
+   * Duplicate CSS properties to HTML attributes.
+   * Mapped to Juice's static `styleToAttribute` property.
+   */
+  styleToAttribute?: Record<string, string>;
+  /**
+   * CSS properties to exclude from inlining.
+   * Mapped to Juice's static `excludedProperties` property.
+   */
+  excludedProperties?: string[];
+  /**
+   * Elements that can receive `width` HTML attributes.
+   * Mapped to Juice's static `widthElements` property.
+   *
+   * @default ['img', 'video']
+   */
+  widthElements?: string[];
+  /**
+   * Elements that can receive `height` HTML attributes.
+   * Mapped to Juice's static `heightElements` property.
+   *
+   * @default ['img', 'video']
+   */
+  heightElements?: string[];
+  /**
+   * Template language code blocks to preserve during inlining.
+   * Mapped to Juice's static `codeBlocks` property.
+   */
+  codeBlocks?: Record<string, {
+    start: string;
+    end: string;
+  }>;
+}
+/**
+ * Inline CSS from `<style>` tags into `style` attributes on matching elements.
+ *
+ * @param html    HTML string to transform.
+ * @param options Juice options plus Maizzle-specific extras.
+ * @returns       The transformed HTML string.
+ *
+ * @example
+ * import { inlineCss } from '@maizzle/framework'
+ *
+ * const out = inlineCss('<style>.red{color:red}</style><p class="red">x</p>', {
+ *   removeStyleTags: true,
+ * })
+ */
+declare function inlineCss(html: string, options?: InlineCssOptions): string;
+/**
+ * DOM-form of {@link inlineCss} used by the internal transformer pipeline.
+ * Takes a parsed DOM, returns a parsed DOM — avoids the redundant
+ * serialize/parse round-trips when chained with other transformers.
+ */
+declare function inlineCssDom(dom: ChildNode[], options?: InlineCssOptions): ChildNode[];
+//#endregion
+export { InlineCssOptions, inlineCss, inlineCssDom };
+//# sourceMappingURL=inlineCss.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inlineCss.d.ts","names":[],"sources":["../../src/transformers/inlineCss.ts"],"mappings":";;;;;;AASA;;UAAiB,gBAAA,SAAyB,OAAA;EAuBrB;;;;;EAjBnB,oBAAA;EAAA;;;;;;EAOA,QAAA;EA6BA;;;;EAxBA,SAAA;EA6BgD;;AAiBlD;;EAzCE,gBAAA,GAAmB,MAAA;EAyCiD;;;;EApCpE,kBAAA;EAoCoE;AAStE;;;;;EAtCE,aAAA;EAsCuF;;;;;;EA/BvF,cAAA;EA+BuF;;;;EA1BvF,UAAA,GAAa,MAAA;IAAiB,KAAA;IAAe,GAAA;EAAA;AAAA;;;;;;;;;;;;;;;iBAiB/B,SAAA,CAAU,IAAA,UAAc,OAAA,GAAS,gBAAA;;;;;;iBASjC,YAAA,CAAa,GAAA,EAAK,SAAA,IAAa,OAAA,GAAS,gBAAA,GAAwB,SAAA"}

package/dist/transformers/inlineCss.js

@@ -0,0 +1,91 @@
+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 juice from "juice";
+//#region src/transformers/inlineCss.ts
+/**
+* Inline CSS from `<style>` tags into `style` attributes on matching elements.
+*
+* @param html    HTML string to transform.
+* @param options Juice options plus Maizzle-specific extras.
+* @returns       The transformed HTML string.
+*
+* @example
+* import { inlineCss } from '@maizzle/framework'
+*
+* const out = inlineCss('<style>.red{color:red}</style><p class="red">x</p>', {
+*   removeStyleTags: true,
+* })
+*/
+function inlineCss(html, options = {}) {
+	return serialize(inlineCssDom(parse(html), options));
+}
+/**
+* DOM-form of {@link inlineCss} used by the internal transformer pipeline.
+* Takes a parsed DOM, returns a parsed DOM — avoids the redundant
+* serialize/parse round-trips when chained with other transformers.
+*/
+function inlineCssDom(dom, options = {}) {
+	const { preferUnitlessValues = true, safelist, customCSS = "", styleToAttribute, excludedProperties, widthElements, heightElements, codeBlocks, ...juicePassthrough } = options;
+	juice.styleToAttribute = styleToAttribute ?? {};
+	juice.excludedProperties = ["--tw-shadow", ...excludedProperties ?? []];
+	juice.widthElements = (widthElements ?? ["img", "video"]).map((i) => i.toUpperCase());
+	juice.heightElements = (heightElements ?? ["img", "video"]).map((i) => i.toUpperCase());
+	if (codeBlocks && typeof codeBlocks === "object") Object.entries(codeBlocks).forEach(([key, value]) => {
+		if (value.start && value.end) juice.codeBlocks[key] = value;
+	});
+	walk(dom, (node) => {
+		const el = node;
+		if (el.name === "style" && el.attribs) {
+			if ("embed" in el.attribs && !("data-embed" in el.attribs)) el.attribs["data-embed"] = "";
+			if ("data-embed" in el.attribs && !("embed" in el.attribs)) el.attribs.embed = "";
+			if ("data-embed" in el.attribs) el.attribs["data-maizzle-embed"] = "";
+		}
+	});
+	const serialized = serialize(dom);
+	let inlinedHtml;
+	try {
+		inlinedHtml = juice(serialized, {
+			removeStyleTags: juicePassthrough.removeStyleTags ?? false,
+			removeInlinedSelectors: juicePassthrough.removeInlinedSelectors ?? true,
+			applyWidthAttributes: juicePassthrough.applyWidthAttributes ?? true,
+			applyHeightAttributes: juicePassthrough.applyHeightAttributes ?? true,
+			preservedSelectors: safelist ?? [],
+			...customCSS ? { extraCss: customCSS } : {},
+			inlineDuplicateProperties: juicePassthrough.inlineDuplicateProperties ?? true,
+			...juicePassthrough
+		});
+	} catch {
+		return dom;
+	}
+	const result = parse(inlinedHtml);
+	walk(result, (node) => {
+		const el = node;
+		if (el.attribs?.style) {
+			let style = el.attribs.style.replace(/:\s*/g, ": ").replace(/;\s*/g, "; ").trimEnd();
+			if (!style.endsWith(";")) style += ";";
+			if (preferUnitlessValues) style = style.replace(/\b0(px|rem|em|%|vh|vw|vmin|vmax|in|cm|mm|pt|pc|ex|ch)\b/g, "0");
+			el.attribs.style = style;
+		}
+	});
+	/**
+	* Restore `embed` from our marker so the purge step can detect
+	* these tags and skip them. Drop `data-embed` (juice's name)
+	* since it's redundant once `embed` is back, and let purge
+	* strip `embed` itself at the end of its run.
+	*/
+	walk(result, (node) => {
+		const el = node;
+		if (el.name === "style" && el.attribs && "data-maizzle-embed" in el.attribs) {
+			el.attribs.embed = "";
+			delete el.attribs["data-embed"];
+			delete el.attribs["data-maizzle-embed"];
+		}
+	});
+	return result;
+}
+//#endregion
+export { inlineCss, inlineCssDom };
+
+//# sourceMappingURL=inlineCss.js.map

package/dist/transformers/inlineCss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineCss.js","names":[],"sources":["../../src/transformers/inlineCss.ts"],"sourcesContent":["import juice from 'juice'\nimport { walk, parse, serialize } from '../utils/ast/index.ts'\nimport type { ChildNode, Element } from 'domhandler'\nimport type { Options as JuiceOptions } from 'juice'\n\n/**\n * Options for the `inlineCss` transformer. Accepts every Juice option plus a\n * handful of Maizzle-specific extras.\n */\nexport interface InlineCssOptions extends JuiceOptions {\n  /**\n   * Convert `0px`, `0em` etc. to `0` in inline styles.\n   *\n   * @default true\n   */\n  preferUnitlessValues?: boolean\n  /**\n   * CSS selectors to preserve in `<style>` tags, even after inlining.\n   * Mapped to Juice's `preservedSelectors` option.\n   *\n   * @default []\n   */\n  safelist?: string[]\n  /**\n   * Additional CSS string to inline alongside `<style>` tag contents.\n   * Mapped to Juice's `extraCss` option.\n   */\n  customCSS?: string\n  /**\n   * Duplicate CSS properties to HTML attributes.\n   * Mapped to Juice's static `styleToAttribute` property.\n   */\n  styleToAttribute?: Record<string, string>\n  /**\n   * CSS properties to exclude from inlining.\n   * Mapped to Juice's static `excludedProperties` property.\n   */\n  excludedProperties?: string[]\n  /**\n   * Elements that can receive `width` HTML attributes.\n   * Mapped to Juice's static `widthElements` property.\n   *\n   * @default ['img', 'video']\n   */\n  widthElements?: string[]\n  /**\n   * Elements that can receive `height` HTML attributes.\n   * Mapped to Juice's static `heightElements` property.\n   *\n   * @default ['img', 'video']\n   */\n  heightElements?: string[]\n  /**\n   * Template language code blocks to preserve during inlining.\n   * Mapped to Juice's static `codeBlocks` property.\n   */\n  codeBlocks?: Record<string, { start: string; end: string }>\n}\n\n/**\n * Inline CSS from `<style>` tags into `style` attributes on matching elements.\n *\n * @param html    HTML string to transform.\n * @param options Juice options plus Maizzle-specific extras.\n * @returns       The transformed HTML string.\n *\n * @example\n * import { inlineCss } from '@maizzle/framework'\n *\n * const out = inlineCss('<style>.red{color:red}</style><p class=\"red\">x</p>', {\n *   removeStyleTags: true,\n * })\n */\nexport function inlineCss(html: string, options: InlineCssOptions = {}): string {\n  return serialize(inlineCssDom(parse(html), options))\n}\n\n/**\n * DOM-form of {@link inlineCss} used by the internal transformer pipeline.\n * Takes a parsed DOM, returns a parsed DOM — avoids the redundant\n * serialize/parse round-trips when chained with other transformers.\n */\nexport function inlineCssDom(dom: ChildNode[], options: InlineCssOptions = {}): ChildNode[] {\n  const {\n    preferUnitlessValues = true,\n    safelist,\n    customCSS = '',\n    styleToAttribute,\n    excludedProperties,\n    widthElements,\n    heightElements,\n    codeBlocks,\n    ...juicePassthrough\n  } = options\n\n  // Configure Juice static properties\n  juice.styleToAttribute = styleToAttribute ?? {}\n  juice.excludedProperties = ['--tw-shadow', ...(excludedProperties ?? [])]\n  juice.widthElements = (widthElements ?? ['img', 'video']).map(i => i.toUpperCase()) as unknown as HTMLElement[]\n  juice.heightElements = (heightElements ?? ['img', 'video']).map(i => i.toUpperCase()) as unknown as HTMLElement[]\n\n  // Add custom code blocks\n  if (codeBlocks && typeof codeBlocks === 'object') {\n    Object.entries(codeBlocks).forEach(([key, value]) => {\n      if (value.start && value.end) {\n        juice.codeBlocks[key] = value\n      }\n    })\n  }\n\n  // Handle style tags with embed attributes.\n  // We add a marker attribute that persists through the pipeline,\n  // then restore data-embed from it after Juice runs.\n  walk(dom, (node) => {\n    const el = node as Element\n    if (el.name === 'style' && el.attribs) {\n      // Sync data-embed ↔ embed. Use `in` so presence-only attrs\n      // (<style embed> → attribs.embed === '') still count.\n      if ('embed' in el.attribs && !('data-embed' in el.attribs)) {\n        el.attribs['data-embed'] = ''\n      }\n      if ('data-embed' in el.attribs && !('embed' in el.attribs)) {\n        el.attribs.embed = ''\n      }\n\n      // Add marker that persists through the pipeline\n      if ('data-embed' in el.attribs) {\n        el.attribs['data-maizzle-embed'] = ''\n      }\n    }\n  })\n\n  // Serialize for juice (juice requires a string)\n  const serialized = serialize(dom)\n\n  let inlinedHtml: string\n\n  try {\n    const juiceOptions: JuiceOptions = {\n      removeStyleTags: juicePassthrough.removeStyleTags ?? false,\n      removeInlinedSelectors: juicePassthrough.removeInlinedSelectors ?? true,\n      applyWidthAttributes: juicePassthrough.applyWidthAttributes ?? true,\n      applyHeightAttributes: juicePassthrough.applyHeightAttributes ?? true,\n      preservedSelectors: safelist ?? [],\n      ...customCSS ? { extraCss: customCSS } : {},\n      inlineDuplicateProperties: juicePassthrough.inlineDuplicateProperties ?? true,\n      ...juicePassthrough,\n    }\n\n    inlinedHtml = juice(serialized, juiceOptions)\n  } catch {\n    // If Juice fails, return the dom unchanged\n    return dom\n  }\n\n  // Post-process for preferUnitlessValues\n  const result = parse(inlinedHtml)\n\n  walk(result, (node) => {\n    const el = node as Element\n    if (el.attribs?.style) {\n      // Normalize style formatting: ensure spaces after : and ;\n      let style = el.attribs.style\n        .replace(/:\\s*/g, ': ')\n        .replace(/;\\s*/g, '; ')\n        .trimEnd()\n\n      // Ensure trailing semicolon\n      if (!style.endsWith(';')) {\n        style += ';'\n      }\n\n      if (preferUnitlessValues) {\n        style = style.replace(\n          /\\b0(px|rem|em|%|vh|vw|vmin|vmax|in|cm|mm|pt|pc|ex|ch)\\b/g,\n          '0'\n        )\n      }\n\n      el.attribs.style = style\n    }\n  })\n\n  /**\n   * Restore `embed` from our marker so the purge step can detect\n   * these tags and skip them. Drop `data-embed` (juice's name)\n   * since it's redundant once `embed` is back, and let purge\n   * strip `embed` itself at the end of its run.\n   */\n  walk(result, (node) => {\n    const el = node as Element\n    if (el.name === 'style' && el.attribs && 'data-maizzle-embed' in el.attribs) {\n      el.attribs.embed = ''\n      delete el.attribs['data-embed']\n      delete el.attribs['data-maizzle-embed']\n    }\n  })\n\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAyEA,SAAgB,UAAU,MAAc,UAA4B,EAAE,EAAU;CAC9E,OAAO,UAAU,aAAa,MAAM,KAAK,EAAE,QAAQ,CAAC;;;;;;;AAQtD,SAAgB,aAAa,KAAkB,UAA4B,EAAE,EAAe;CAC1F,MAAM,EACJ,uBAAuB,MACvB,UACA,YAAY,IACZ,kBACA,oBACA,eACA,gBACA,YACA,GAAG,qBACD;CAGJ,MAAM,mBAAmB,oBAAoB,EAAE;CAC/C,MAAM,qBAAqB,CAAC,eAAe,GAAI,sBAAsB,EAAE,CAAE;CACzE,MAAM,iBAAiB,iBAAiB,CAAC,OAAO,QAAQ,EAAE,KAAI,MAAK,EAAE,aAAa,CAAC;CACnF,MAAM,kBAAkB,kBAAkB,CAAC,OAAO,QAAQ,EAAE,KAAI,MAAK,EAAE,aAAa,CAAC;CAGrF,IAAI,cAAc,OAAO,eAAe,UACtC,OAAO,QAAQ,WAAW,CAAC,SAAS,CAAC,KAAK,WAAW;EACnD,IAAI,MAAM,SAAS,MAAM,KACvB,MAAM,WAAW,OAAO;GAE1B;CAMJ,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EACX,IAAI,GAAG,SAAS,WAAW,GAAG,SAAS;GAGrC,IAAI,WAAW,GAAG,WAAW,EAAE,gBAAgB,GAAG,UAChD,GAAG,QAAQ,gBAAgB;GAE7B,IAAI,gBAAgB,GAAG,WAAW,EAAE,WAAW,GAAG,UAChD,GAAG,QAAQ,QAAQ;GAIrB,IAAI,gBAAgB,GAAG,SACrB,GAAG,QAAQ,wBAAwB;;GAGvC;CAGF,MAAM,aAAa,UAAU,IAAI;CAEjC,IAAI;CAEJ,IAAI;EAYF,cAAc,MAAM,YAAY;GAV9B,iBAAiB,iBAAiB,mBAAmB;GACrD,wBAAwB,iBAAiB,0BAA0B;GACnE,sBAAsB,iBAAiB,wBAAwB;GAC/D,uBAAuB,iBAAiB,yBAAyB;GACjE,oBAAoB,YAAY,EAAE;GAClC,GAAG,YAAY,EAAE,UAAU,WAAW,GAAG,EAAE;GAC3C,2BAA2B,iBAAiB,6BAA6B;GACzE,GAAG;GAGuC,CAAC;SACvC;EAEN,OAAO;;CAIT,MAAM,SAAS,MAAM,YAAY;CAEjC,KAAK,SAAS,SAAS;EACrB,MAAM,KAAK;EACX,IAAI,GAAG,SAAS,OAAO;GAErB,IAAI,QAAQ,GAAG,QAAQ,MACpB,QAAQ,SAAS,KAAK,CACtB,QAAQ,SAAS,KAAK,CACtB,SAAS;GAGZ,IAAI,CAAC,MAAM,SAAS,IAAI,EACtB,SAAS;GAGX,IAAI,sBACF,QAAQ,MAAM,QACZ,4DACA,IACD;GAGH,GAAG,QAAQ,QAAQ;;GAErB;;;;;;;CAQF,KAAK,SAAS,SAAS;EACrB,MAAM,KAAK;EACX,IAAI,GAAG,SAAS,WAAW,GAAG,WAAW,wBAAwB,GAAG,SAAS;GAC3E,GAAG,QAAQ,QAAQ;GACnB,OAAO,GAAG,QAAQ;GAClB,OAAO,GAAG,QAAQ;;GAEpB;CAEF,OAAO"}

package/dist/transformers/inlineLink.d.ts

@@ -0,0 +1,35 @@
+import { ChildNode } from "domhandler";
+
+//#region src/transformers/inlineLink.d.ts
+/**
+ * Inline `<link rel="stylesheet">` tags as `<style>` tags.
+ *
+ * - 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 inlineLinkDom(dom: ChildNode[], filePath?: string): Promise<ChildNode[]>;
+//#endregion
+export { inlineLink, inlineLinkDom };
+//# sourceMappingURL=inlineLink.d.ts.map

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

@@ -0,0 +1 @@
+{"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 as parse$1 } 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$1(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":["parse"],"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,cAAcA,QAAM,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

@@ -0,0 +1,21 @@
+import { Opts, Opts as MinifyOptions } from "html-crush";
+
+//#region src/transformers/minify.d.ts
+/**
+ * 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 })
+ */
+declare function minify(html: string, options?: Partial<Opts>): string;
+//#endregion
+export { type MinifyOptions, minify };
+//# sourceMappingURL=minify.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}