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

package/dist/transformers/purgeCss.js

@@ -0,0 +1,181 @@
+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
+const DEFAULT_SAFELIST = [
+	"*body*",
+	".gmail*",
+	".apple*",
+	".ios*",
+	".ox-*",
+	".outlook*",
+	"[data-ogs*",
+	".bloop_container",
+	".Singleton",
+	".unused",
+	".moz-text-html",
+	".mail-detail-content",
+	"*edo*",
+	"#*",
+	".lang*"
+];
+const DEFAULT_OPTIONS = {
+	backend: [{
+		heads: "{{",
+		tails: "}}"
+	}, {
+		heads: "{%",
+		tails: "%}"
+	}],
+	whitelist: [...DEFAULT_SAFELIST]
+};
+/**
+* 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'],
+* })
+*/
+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);
+	const safelist = [...DEFAULT_SAFELIST, ...userSafelist];
+	dom = deepPurge(dom, safelist);
+	/**
+	* Shield embed style tags from email-comb. Comb has no skip option,
+	* so it strips CSS comments and drops class refs it can't match
+	* against visible CSS. Swap each embed tag's body for a unique
+	* stub rule (`.maizzle-keep-N{}`) so comb keeps the tag, then
+	* whitelist that stub plus every selector from the original
+	* CSS so comb leaves matching refs alone elsewhere — and
+	* finally restore the original CSS once comb has run.
+	*/
+	const stash = [];
+	const extraWhitelist = [];
+	walk(dom, (node) => {
+		const el = node;
+		if (el.name !== "style" || !el.attribs) return;
+		if (!("embed" in el.attribs) && !("data-embed" in el.attribs)) return;
+		const textNode = el.children?.find((c) => c.type === "text");
+		if (!textNode?.data) return;
+		const token = `.maizzle-keep-${stash.length}`;
+		extraWhitelist.push(token);
+		for (const m of textNode.data.matchAll(/(?<![\w-])[.#][a-zA-Z_][\w-]*/g)) extraWhitelist.push(m[0]);
+		stash.push({
+			token,
+			original: textNode.data,
+			textNode
+		});
+		textNode.data = `${token}{}`;
+	});
+	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
+	* token we planted earlier and swap the original CSS back in.
+	*/
+	let purgedDom = parse(result);
+	if (stash.length) walk(purgedDom, (node) => {
+		const el = node;
+		if (el.name !== "style" || !el.attribs) return;
+		if (!("embed" in el.attribs) && !("data-embed" in el.attribs)) return;
+		const textNode = el.children?.find((c) => c.type === "text");
+		if (!textNode?.data) return;
+		const trimmed = textNode.data.trim();
+		const match = stash.find((s) => trimmed === `${s.token}{}` || trimmed.startsWith(`${s.token}{`));
+		if (match) textNode.data = match.original;
+	});
+	walk(purgedDom, (node) => {
+		const el = node;
+		if (el.name === "style" && el.attribs) {
+			delete el.attribs["data-embed"];
+			delete el.attribs.embed;
+		}
+	});
+	return purgedDom;
+}
+/**
+* Deep purge: uses PostCSS to parse CSS in non-embedded style tags,
+* then checks each selector against the DOM with css-select.
+* Removes rules where no selector matches any element.
+*/
+function isSafelisted(selector, safelist) {
+	return safelist.some((pattern) => {
+		if (pattern.startsWith("*") && pattern.endsWith("*")) return selector.includes(pattern.slice(1, -1));
+		if (pattern.endsWith("*")) return selector.startsWith(pattern.slice(0, -1));
+		if (pattern.startsWith("*")) return selector.endsWith(pattern.slice(1));
+		return selector === pattern;
+	});
+}
+function deepPurge(dom, safelist) {
+	walk(dom, (node) => {
+		const el = node;
+		if (el.name !== "style" || !el.attribs) return;
+		if ("data-embed" in el.attribs || "embed" in el.attribs) return;
+		const textNode = el.children?.find((c) => c.type === "text");
+		if (!textNode?.data?.trim()) return;
+		const root = safeParser(textNode.data);
+		root.walkRules((rule) => {
+			if (rule.parent?.type === "atrule") return;
+			const selectors = rule.selectors ?? [rule.selector];
+			const matched = selectors.filter((sel) => {
+				if (isSafelisted(sel, safelist)) return true;
+				if (/::[\w-]/.test(sel)) return true;
+				if (/(?<!:):(?!not\b|is\b|where\b|has\b)[\w-]/.test(sel.replace(/\\./g, ""))) return true;
+				try {
+					return selectAll(sel, dom).length > 0;
+				} catch {
+					return true;
+				}
+			});
+			if (matched.length === 0) rule.remove();
+			else if (matched.length < selectors.length) rule.selectors = matched;
+		});
+		root.walkAtRules((atRule) => {
+			if (atRule.nodes?.length === 0) atRule.remove();
+		});
+		const purgedCss = root.toString();
+		if (purgedCss.trim()) textNode.data = purgedCss;
+		else {
+			const parent = el.parent;
+			if (parent && "children" in parent) {
+				const idx = parent.children.indexOf(el);
+				if (idx !== -1) parent.children.splice(idx, 1);
+			}
+		}
+	});
+	return dom;
+}
+//#endregion
+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

@@ -0,0 +1,54 @@
+import { ChildNode } from "domhandler";
+
+//#region src/transformers/removeAttributes.d.ts
+/**
+ * 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.
+ *
+ * Empty `style` and `class` attributes are always stripped, regardless of
+ * what you pass. Your entries are appended to those defaults.
+ *
+ * - `'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.
+ *
+ * @param html       HTML string to transform.
+ * @param attributes Additional attribute-removal rules to apply on top of the defaults.
+ * @returns          The transformed HTML string.
+ *
+ * @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 removeAttributesDom(dom: ChildNode[], attributes?: RemoveAttributeOption[]): ChildNode[];
+//#endregion
+export { RemoveAttributeOption, RemoveAttributeRule, removeAttributes, removeAttributesDom };
+//# sourceMappingURL=removeAttributes.d.ts.map

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

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

package/dist/transformers/removeAttributes.js

@@ -0,0 +1,70 @@
+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";
+//#region src/transformers/removeAttributes.ts
+/**
+* Remove HTML attributes from elements.
+*
+* Empty `style` and `class` attributes are always stripped, regardless of
+* what you pass. Your entries are appended to those defaults.
+*
+* - `'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.
+*
+* @param html       HTML string to transform.
+* @param attributes Additional attribute-removal rules to apply on top of the defaults.
+* @returns          The transformed HTML string.
+*
+* @example
+* import { removeAttributes } from '@maizzle/framework'
+*
+* const out = removeAttributes('<p style="" data-x="">x</p>', [
+*   'data-x',
+*   { name: 'role', value: 'none' },
+* ])
+*/
+function removeAttributes(html, attributes = []) {
+	return serialize(removeAttributesDom(parse(html), attributes));
+}
+/**
+* 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.
+*/
+function removeAttributesDom(dom, attributes = []) {
+	const attributesToRemove = [
+		"style",
+		"class",
+		...attributes
+	];
+	walk(dom, (node) => {
+		const el = node;
+		if (!el.attribs) return;
+		for (const attr of attributesToRemove) {
+			let attrName;
+			let attrValue;
+			if (typeof attr === "string") {
+				attrName = attr;
+				attrValue = true;
+			} else {
+				attrName = attr.name;
+				attrValue = attr.value;
+			}
+			const currentValue = el.attribs[attrName];
+			if (currentValue === void 0) continue;
+			let shouldRemove = false;
+			if (typeof attrValue === "boolean") shouldRemove = currentValue === "" || currentValue === true;
+			else if (typeof attrValue === "string") shouldRemove = currentValue === attrValue;
+			else if (attrValue instanceof RegExp) shouldRemove = attrValue.test(currentValue);
+			else shouldRemove = currentValue === "";
+			if (shouldRemove) delete el.attribs[attrName];
+		}
+	});
+	return dom;
+}
+//#endregion
+export { removeAttributes, removeAttributesDom };
+
+//# sourceMappingURL=removeAttributes.js.map

package/dist/transformers/removeAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeAttributes.js","names":[],"sources":["../../src/transformers/removeAttributes.ts"],"sourcesContent":["import type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\n/**\n * Single attribute-removal rule.\n */\nexport interface RemoveAttributeRule {\n  /** Attribute name to match. */\n  name: string\n  /**\n   * Match condition for the attribute's value:\n   * - `string` — remove when the value matches exactly.\n   * - `RegExp` — remove when the value matches the regex.\n   * - `boolean` / omitted — remove when the value is empty.\n   */\n  value?: string | RegExp | boolean\n}\n\n/**\n * Entry passed to {@link removeAttributes}. A bare string targets the named\n * attribute and removes it when its value is empty.\n */\nexport type RemoveAttributeOption = string | RemoveAttributeRule\n\n/**\n * Remove HTML attributes from elements.\n *\n * Empty `style` and `class` attributes are always stripped, regardless of\n * what you pass. Your entries are appended to those defaults.\n *\n * - `'data-src'` — remove when the value is empty.\n * - `{ name: 'id', value: 'test' }` — remove when the value matches exactly.\n * - `{ name: 'data-id', value: /\\d/ }` — remove when the value matches the regex.\n *\n * @param html       HTML string to transform.\n * @param attributes Additional attribute-removal rules to apply on top of the defaults.\n * @returns          The transformed HTML string.\n *\n * @example\n * import { removeAttributes } from '@maizzle/framework'\n *\n * const out = removeAttributes('<p style=\"\" data-x=\"\">x</p>', [\n *   'data-x',\n *   { name: 'role', value: 'none' },\n * ])\n */\nexport function removeAttributes(html: string, attributes: RemoveAttributeOption[] = []): string {\n  return serialize(removeAttributesDom(parse(html), attributes))\n}\n\n/**\n * DOM-form of {@link removeAttributes} 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 removeAttributesDom(dom: ChildNode[], attributes: RemoveAttributeOption[] = []): ChildNode[] {\n  // Empty style/class are always stripped; user entries are appended.\n  const attributesToRemove: RemoveAttributeOption[] = ['style', 'class', ...attributes]\n\n  walk(dom, (node) => {\n    const el = node as Element\n    if (!el.attribs) return\n\n    for (const attr of attributesToRemove) {\n      let attrName: string\n      let attrValue: string | RegExp | boolean | undefined\n\n      if (typeof attr === 'string') {\n        attrName = attr\n        attrValue = true // Remove when value is empty (boolean true or empty string)\n      } else {\n        attrName = attr.name\n        attrValue = attr.value\n      }\n\n      const currentValue = el.attribs[attrName]\n\n      // Skip if attribute doesn't exist\n      if (currentValue === undefined) continue\n\n      let shouldRemove = false\n\n      if (typeof attrValue === 'boolean') {\n        // Remove if value is empty (boolean true is treated as no-value attribute)\n        shouldRemove = currentValue === '' || (currentValue as unknown) === true\n      } else if (typeof attrValue === 'string') {\n        // Remove if value matches exactly\n        shouldRemove = currentValue === attrValue\n      } else if (attrValue instanceof RegExp) {\n        // Remove if value matches regex\n        shouldRemove = attrValue.test(currentValue)\n      } else {\n        // Default: remove if empty\n        shouldRemove = currentValue === ''\n      }\n\n      if (shouldRemove) {\n        delete el.attribs[attrName]\n      }\n    }\n  })\n\n  return dom\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,iBAAiB,MAAc,aAAsC,EAAE,EAAU;CAC/F,OAAO,UAAU,oBAAoB,MAAM,KAAK,EAAE,WAAW,CAAC;;;;;;;AAQhE,SAAgB,oBAAoB,KAAkB,aAAsC,EAAE,EAAe;CAE3G,MAAM,qBAA8C;EAAC;EAAS;EAAS,GAAG;EAAW;CAErF,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EACX,IAAI,CAAC,GAAG,SAAS;EAEjB,KAAK,MAAM,QAAQ,oBAAoB;GACrC,IAAI;GACJ,IAAI;GAEJ,IAAI,OAAO,SAAS,UAAU;IAC5B,WAAW;IACX,YAAY;UACP;IACL,WAAW,KAAK;IAChB,YAAY,KAAK;;GAGnB,MAAM,eAAe,GAAG,QAAQ;GAGhC,IAAI,iBAAiB,KAAA,GAAW;GAEhC,IAAI,eAAe;GAEnB,IAAI,OAAO,cAAc,WAEvB,eAAe,iBAAiB,MAAO,iBAA6B;QAC/D,IAAI,OAAO,cAAc,UAE9B,eAAe,iBAAiB;QAC3B,IAAI,qBAAqB,QAE9B,eAAe,UAAU,KAAK,aAAa;QAG3C,eAAe,iBAAiB;GAGlC,IAAI,cACF,OAAO,GAAG,QAAQ;;GAGtB;CAEF,OAAO"}

package/dist/transformers/{replaceStrings.d.mts → replaceStrings.d.ts}

@@ -1,4 +1,4 @@
-import { MaizzleConfig } from "../types/config.mjs";
+import { MaizzleConfig } from "../types/config.js";
 
 //#region src/transformers/replaceStrings.d.ts
 /**
@@ -13,4 +13,4 @@ import { MaizzleConfig } from "../types/config.mjs";
 declare function replaceStrings(html: string, config?: MaizzleConfig): string;
 //#endregion
 export { replaceStrings };
-//# sourceMappingURL=replaceStrings.d.mts.map
+//# sourceMappingURL=replaceStrings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replaceStrings.d.ts","names":[],"sources":["../../src/transformers/replaceStrings.ts"],"mappings":";;;;;AAWA;;;;;;;iBAAgB,cAAA,CAAe,IAAA,UAAc,MAAA,GAAQ,aAAA"}

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

@@ -13,7 +13,7 @@ function replaceStrings(html, config = {}) {
 	if (!replacements || Object.keys(replacements).length === 0) return html;
 	return Object.entries(replacements).reduce((result, [pattern, replacement]) => result.replace(new RegExp(pattern, "gi"), replacement), html);
 }
-
 //#endregion
 export { replaceStrings };
-//# sourceMappingURL=replaceStrings.mjs.map
+
+//# sourceMappingURL=replaceStrings.js.map

package/dist/transformers/replaceStrings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replaceStrings.js","names":[],"sources":["../../src/transformers/replaceStrings.ts"],"sourcesContent":["import type { MaizzleConfig } from '../types/config.ts'\n\n/**\n * Replace strings transformer.\n *\n * Replaces strings in the HTML using the key-value pairs defined in\n * `config.replaceStrings`. Each key is treated as a regular expression\n * pattern (case-insensitive, global), and the value is the replacement.\n *\n * Character classes must be escaped in keys, e.g. `\\\\s` for `\\s`.\n */\nexport function replaceStrings(html: string, config: MaizzleConfig = {}): string {\n  const replacements = config.replaceStrings\n\n  if (!replacements || Object.keys(replacements).length === 0) return html\n\n  return Object.entries(replacements).reduce(\n    (result, [pattern, replacement]) => result.replace(new RegExp(pattern, 'gi'), replacement),\n    html,\n  )\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,eAAe,MAAc,SAAwB,EAAE,EAAU;CAC/E,MAAM,eAAe,OAAO;CAE5B,IAAI,CAAC,gBAAgB,OAAO,KAAK,aAAa,CAAC,WAAW,GAAG,OAAO;CAEpE,OAAO,OAAO,QAAQ,aAAa,CAAC,QACjC,QAAQ,CAAC,SAAS,iBAAiB,OAAO,QAAQ,IAAI,OAAO,SAAS,KAAK,EAAE,YAAY,EAC1F,KACD"}

package/dist/transformers/{safeClassNames.d.mts → safeClassNames.d.ts}

@@ -1,4 +1,4 @@
-import { CssConfig } from "../types/config.mjs";
+import { CssConfig } from "../types/config.js";
 import { ChildNode } from "domhandler";
 
 //#region src/transformers/safeClassNames.d.ts
@@ -19,4 +19,4 @@ import { ChildNode } from "domhandler";
 declare function safeClassNames(dom: ChildNode[], config?: CssConfig): ChildNode[];
 //#endregion
 export { safeClassNames };
-//# sourceMappingURL=safeClassNames.d.mts.map
+//# sourceMappingURL=safeClassNames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safeClassNames.d.ts","names":[],"sources":["../../src/transformers/safeClassNames.ts"],"mappings":";;;;;;AAsGA;;;;;;;;;;;;iBAAgB,cAAA,CAAe,GAAA,EAAK,SAAA,IAAa,MAAA,GAAQ,SAAA,GAAiB,SAAA"}

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

@@ -1,8 +1,7 @@
-import { walk } from "../utils/ast/walker.mjs";
-import "../utils/ast/index.mjs";
+import { walk } from "../utils/ast/walker.js";
+import "../utils/ast/index.js";
 import postcss from "postcss";
 import safeParser from "postcss-safe-parser";
-
 //#region src/transformers/safeClassNames.ts
 const DEFAULT_REPLACEMENTS = {
 	":": "-",
@@ -97,7 +96,7 @@ function safeClassNames(dom, config = {}) {
 	});
 	return dom;
 }
-
 //#endregion
 export { safeClassNames };
-//# sourceMappingURL=safeClassNames.mjs.map
+
+//# sourceMappingURL=safeClassNames.js.map

package/dist/transformers/safeClassNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeClassNames.js","names":[],"sources":["../../src/transformers/safeClassNames.ts"],"sourcesContent":["import postcss from 'postcss'\nimport safeParser from 'postcss-safe-parser'\nimport type { ChildNode, Element } from 'domhandler'\nimport { walk } from '../utils/ast/index.ts'\nimport type { CssConfig } from '../types/config.ts'\n\nconst DEFAULT_REPLACEMENTS: Record<string, string> = {\n  ':': '-',\n  '/': '-',\n  '%': 'pc',\n  '.': '_',\n  ',': '_',\n  '#': '_',\n  '[': '',\n  ']': '',\n  '(': '',\n  ')': '',\n  '{': '',\n  '}': '',\n  '!': '-i',\n  '&': 'and-',\n  '<': 'lt-',\n  '=': 'eq-',\n  '>': 'gt-',\n  '|': 'or-',\n  '@': 'at-',\n  '?': 'q-',\n  '\\\\': '-',\n  '\"': '-',\n  \"'\": '-',\n  '*': '-',\n  '+': '-',\n  ';': '-',\n  '^': '-',\n  '`': '-',\n  '~': '-',\n  '$': '-',\n}\n\nfunction escapeForRegex(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\n/**\n * Replace escaped special characters in CSS selectors.\n *\n * Tailwind generates selectors like `.sm\\:text-base`. This function\n * replaces the `\\:` with `-` (or whatever the configured replacement is)\n * so the selector becomes `.sm-text-base`, which is safe for email clients.\n */\nfunction processCssSelectors(css: string, replacements: Record<string, string>): string {\n  // Matches \\<char> in CSS selectors — e.g. \\: \\/ \\. \\[ etc.\n  const selectorRegex = new RegExp(\n    `\\\\\\\\(${Object.keys(replacements).map(escapeForRegex).join('|')})`,\n    'g',\n  )\n\n  return postcss([\n    (root: postcss.Root) => {\n      root.walkRules((rule: postcss.Rule) => {\n        rule.selector = rule.selector\n          .replace(selectorRegex, (_matched, char) => replacements[char] ?? _matched)\n          // Handle CSS unicode escape for comma (\\2c  → _)\n          .replaceAll('\\\\2c ', '_')\n      })\n    },\n  ]).process(css, { parser: safeParser }).css\n}\n\n/**\n * Replace unsafe special characters in a class attribute value.\n *\n * Splits on whitespace and replaces each char from the replacements map\n * in each class token individually.\n */\nfunction processClassAttr(classStr: string, replacements: Record<string, string>): string {\n  return classStr\n    .split(/\\s+/)\n    .filter(Boolean)\n    .map((cls) => {\n      for (const [from, to] of Object.entries(replacements)) {\n        cls = cls.split(from).join(to)\n      }\n      return cls\n    })\n    .join(' ')\n}\n\n/**\n * Safe class names transformer.\n *\n * Replaces unsafe characters (`:`, `/`, `[`, `]`, etc.) in:\n * - CSS selectors inside `<style>` tags\n * - HTML `class` attributes\n *\n * This makes Tailwind utility classes like `sm:text-base` safe for\n * email clients that cannot handle escaped characters in class names.\n *\n * Enabled by default. Disable by setting `css.safe` to `false`.\n * Customize replacements by passing a `Record<string, string>` — user\n * values are merged on top of the defaults.\n */\nexport function safeClassNames(dom: ChildNode[], config: CssConfig = {}): ChildNode[] {\n  const option = config.safe ?? true\n\n  if (!option) return dom\n\n  const replacements: Record<string, string> =\n    option && typeof option === 'object'\n      ? { ...DEFAULT_REPLACEMENTS, ...option }\n      : DEFAULT_REPLACEMENTS\n\n  walk(dom, (node) => {\n    const el = node as Element\n\n    // Process CSS selectors inside <style> tags\n    if (el.name === 'style' && el.children?.length) {\n      const text = el.children.find((c) => c.type === 'text') as any\n      if (text?.data?.trim()) {\n        text.data = processCssSelectors(text.data, replacements)\n      }\n    }\n\n    // Replace special chars in class attributes\n    if ('attribs' in el && el.attribs?.class) {\n      el.attribs.class = processClassAttr(el.attribs.class, replacements)\n    }\n  })\n\n  return dom\n}\n"],"mappings":";;;;;AAMA,MAAM,uBAA+C;CACnD,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,MAAM;CACN,MAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN;AAED,SAAS,eAAe,GAAmB;CACzC,OAAO,EAAE,QAAQ,uBAAuB,OAAO;;;;;;;;;AAUjD,SAAS,oBAAoB,KAAa,cAA8C;CAEtF,MAAM,gBAAgB,IAAI,OACxB,QAAQ,OAAO,KAAK,aAAa,CAAC,IAAI,eAAe,CAAC,KAAK,IAAI,CAAC,IAChE,IACD;CAED,OAAO,QAAQ,EACZ,SAAuB;EACtB,KAAK,WAAW,SAAuB;GACrC,KAAK,WAAW,KAAK,SAClB,QAAQ,gBAAgB,UAAU,SAAS,aAAa,SAAS,SAAS,CAE1E,WAAW,SAAS,IAAI;IAC3B;GAEL,CAAC,CAAC,QAAQ,KAAK,EAAE,QAAQ,YAAY,CAAC,CAAC;;;;;;;;AAS1C,SAAS,iBAAiB,UAAkB,cAA8C;CACxF,OAAO,SACJ,MAAM,MAAM,CACZ,OAAO,QAAQ,CACf,KAAK,QAAQ;EACZ,KAAK,MAAM,CAAC,MAAM,OAAO,OAAO,QAAQ,aAAa,EACnD,MAAM,IAAI,MAAM,KAAK,CAAC,KAAK,GAAG;EAEhC,OAAO;GACP,CACD,KAAK,IAAI;;;;;;;;;;;;;;;;AAiBd,SAAgB,eAAe,KAAkB,SAAoB,EAAE,EAAe;CACpF,MAAM,SAAS,OAAO,QAAQ;CAE9B,IAAI,CAAC,QAAQ,OAAO;CAEpB,MAAM,eACJ,UAAU,OAAO,WAAW,WACxB;EAAE,GAAG;EAAsB,GAAG;EAAQ,GACtC;CAEN,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EAGX,IAAI,GAAG,SAAS,WAAW,GAAG,UAAU,QAAQ;GAC9C,MAAM,OAAO,GAAG,SAAS,MAAM,MAAM,EAAE,SAAS,OAAO;GACvD,IAAI,MAAM,MAAM,MAAM,EACpB,KAAK,OAAO,oBAAoB,KAAK,MAAM,aAAa;;EAK5D,IAAI,aAAa,MAAM,GAAG,SAAS,OACjC,GAAG,QAAQ,QAAQ,iBAAiB,GAAG,QAAQ,OAAO,aAAa;GAErE;CAEF,OAAO"}

package/dist/transformers/shorthandCss.d.ts

@@ -0,0 +1,47 @@
+import { ChildNode } from "domhandler";
+
+//#region src/transformers/shorthandCss.d.ts
+/**
+ * Options for the `shorthandCss` transformer.
+ */
+interface ShorthandCssOptions {
+  /**
+   * Restrict the transform to a list of HTML tag names. Omit to apply to
+   * every element with a `style` attribute.
+   *
+   * @example ['td', 'div']
+   */
+  tags?: string[];
+}
+/**
+ * Rewrite longhand CSS inside inline `style` attributes with shorthand
+ * syntax. Works with margin, padding, and border when all sides are
+ * specified.
+ *
+ * For example:
+ * `margin-left: 2px; margin-right: 2px; margin-top: 4px; margin-bottom: 4px`
+ * becomes:
+ * `margin: 4px 2px`
+ *
+ * @param html    HTML string to transform.
+ * @param options Optional Maizzle options (`tags`).
+ * @returns       The transformed HTML string.
+ *
+ * @example
+ * import { shorthandCss } from '@maizzle/framework'
+ *
+ * const out = shorthandCss(
+ *   '<p style="margin-top: 4px; margin-right: 2px; margin-bottom: 4px; margin-left: 2px;">x</p>',
+ *   { tags: ['p'] },
+ * )
+ */
+declare function shorthandCss(html: string, options?: ShorthandCssOptions): string;
+/**
+ * DOM-form of {@link shorthandCss} 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 shorthandCssDom(dom: ChildNode[], options?: ShorthandCssOptions): ChildNode[];
+//#endregion
+export { ShorthandCssOptions, shorthandCss, shorthandCssDom };
+//# sourceMappingURL=shorthandCss.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shorthandCss.d.ts","names":[],"sources":["../../src/transformers/shorthandCss.ts"],"mappings":";;;;;AASA;UAAiB,mBAAA;;;;AAgCjB;;;EAzBE,IAAA;AAAA;;;;;AAkCF;;;;;;;;;;;;;;;;;;iBATgB,YAAA,CAAa,IAAA,UAAc,OAAA,GAAS,mBAAA;;;;;;iBASpC,eAAA,CAAgB,GAAA,EAAK,SAAA,IAAa,OAAA,GAAS,mBAAA,GAA2B,SAAA"}

package/dist/transformers/shorthandCss.js

@@ -0,0 +1,61 @@
+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 postcss from "postcss";
+import safeParser from "postcss-safe-parser";
+import mergeLonghand from "postcss-merge-longhand";
+//#region src/transformers/shorthandCss.ts
+/**
+* Rewrite longhand CSS inside inline `style` attributes with shorthand
+* syntax. Works with margin, padding, and border when all sides are
+* specified.
+*
+* For example:
+* `margin-left: 2px; margin-right: 2px; margin-top: 4px; margin-bottom: 4px`
+* becomes:
+* `margin: 4px 2px`
+*
+* @param html    HTML string to transform.
+* @param options Optional Maizzle options (`tags`).
+* @returns       The transformed HTML string.
+*
+* @example
+* import { shorthandCss } from '@maizzle/framework'
+*
+* const out = shorthandCss(
+*   '<p style="margin-top: 4px; margin-right: 2px; margin-bottom: 4px; margin-left: 2px;">x</p>',
+*   { tags: ['p'] },
+* )
+*/
+function shorthandCss(html, options = {}) {
+	return serialize(shorthandCssDom(parse(html), options));
+}
+/**
+* DOM-form of {@link shorthandCss} 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 shorthandCssDom(dom, options = {}) {
+	const allowedTags = options.tags ?? [];
+	const hasTagFilter = allowedTags.length > 0;
+	walk(dom, (node) => {
+		const el = node;
+		if (!el.attribs?.style) return;
+		if (hasTagFilter && !allowedTags.includes(el.name)) return;
+		const styleValue = el.attribs.style;
+		try {
+			const { css } = postcss().use(mergeLonghand).process(`div { ${styleValue} }`, { parser: safeParser });
+			const match = css.match(/div\s*\{\s*([^}]+)\s*\}/);
+			if (match && match[1]) {
+				const newStyle = match[1].trim();
+				if (newStyle !== styleValue) el.attribs.style = newStyle;
+			}
+		} catch {}
+	});
+	return dom;
+}
+//#endregion
+export { shorthandCss, shorthandCssDom };
+
+//# sourceMappingURL=shorthandCss.js.map

package/dist/transformers/shorthandCss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthandCss.js","names":[],"sources":["../../src/transformers/shorthandCss.ts"],"sourcesContent":["import postcss from 'postcss'\nimport safeParser from 'postcss-safe-parser'\nimport mergeLonghand from 'postcss-merge-longhand'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\n/**\n * Options for the `shorthandCss` transformer.\n */\nexport interface ShorthandCssOptions {\n  /**\n   * Restrict the transform to a list of HTML tag names. Omit to apply to\n   * every element with a `style` attribute.\n   *\n   * @example ['td', 'div']\n   */\n  tags?: string[]\n}\n\n/**\n * Rewrite longhand CSS inside inline `style` attributes with shorthand\n * syntax. Works with margin, padding, and border when all sides are\n * specified.\n *\n * For example:\n * `margin-left: 2px; margin-right: 2px; margin-top: 4px; margin-bottom: 4px`\n * becomes:\n * `margin: 4px 2px`\n *\n * @param html    HTML string to transform.\n * @param options Optional Maizzle options (`tags`).\n * @returns       The transformed HTML string.\n *\n * @example\n * import { shorthandCss } from '@maizzle/framework'\n *\n * const out = shorthandCss(\n *   '<p style=\"margin-top: 4px; margin-right: 2px; margin-bottom: 4px; margin-left: 2px;\">x</p>',\n *   { tags: ['p'] },\n * )\n */\nexport function shorthandCss(html: string, options: ShorthandCssOptions = {}): string {\n  return serialize(shorthandCssDom(parse(html), options))\n}\n\n/**\n * DOM-form of {@link shorthandCss} 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 shorthandCssDom(dom: ChildNode[], options: ShorthandCssOptions = {}): ChildNode[] {\n  const allowedTags = options.tags ?? []\n  const hasTagFilter = allowedTags.length > 0\n\n  walk(dom, (node) => {\n    const el = node as Element\n\n    // Skip if no attribs or no style\n    if (!el.attribs?.style) {\n      return\n    }\n\n    // Skip if tag filter is active and this tag is not allowed\n    if (hasTagFilter && !allowedTags.includes(el.name)) {\n      return\n    }\n\n    const styleValue = el.attribs.style\n\n    try {\n      // Process the style with postcss-merge-longhand\n      // Wrap in a dummy selector since postcss needs a rule\n      const { css } = postcss()\n        .use(mergeLonghand)\n        .process(`div { ${styleValue} }`, { parser: safeParser })\n\n      // Extract the content between the braces\n      const match = css.match(/div\\s*\\{\\s*([^}]+)\\s*\\}/)\n      if (match && match[1]) {\n        const newStyle = match[1].trim()\n        if (newStyle !== styleValue) {\n          el.attribs.style = newStyle\n        }\n      }\n    } catch {\n      // If processing fails, keep the original style\n    }\n  })\n\n  return dom\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,aAAa,MAAc,UAA+B,EAAE,EAAU;CACpF,OAAO,UAAU,gBAAgB,MAAM,KAAK,EAAE,QAAQ,CAAC;;;;;;;AAQzD,SAAgB,gBAAgB,KAAkB,UAA+B,EAAE,EAAe;CAChG,MAAM,cAAc,QAAQ,QAAQ,EAAE;CACtC,MAAM,eAAe,YAAY,SAAS;CAE1C,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EAGX,IAAI,CAAC,GAAG,SAAS,OACf;EAIF,IAAI,gBAAgB,CAAC,YAAY,SAAS,GAAG,KAAK,EAChD;EAGF,MAAM,aAAa,GAAG,QAAQ;EAE9B,IAAI;GAGF,MAAM,EAAE,QAAQ,SAAS,CACtB,IAAI,cAAc,CAClB,QAAQ,SAAS,WAAW,KAAK,EAAE,QAAQ,YAAY,CAAC;GAG3D,MAAM,QAAQ,IAAI,MAAM,0BAA0B;GAClD,IAAI,SAAS,MAAM,IAAI;IACrB,MAAM,WAAW,MAAM,GAAG,MAAM;IAChC,IAAI,aAAa,YACf,GAAG,QAAQ,QAAQ;;UAGjB;GAGR;CAEF,OAAO"}

package/dist/transformers/sixHex.d.ts

@@ -0,0 +1,25 @@
+import { ChildNode } from "domhandler";
+
+//#region src/transformers/sixHex.d.ts
+/**
+ * Convert 3-digit HEX color codes to 6-digit in `bgcolor` and `color`
+ * attributes, for better email client compatibility.
+ *
+ * @param html HTML string to transform.
+ * @returns    The transformed HTML string.
+ *
+ * @example
+ * import { sixHex } from '@maizzle/framework'
+ *
+ * const out = sixHex('<font color="#abc">x</font>')
+ */
+declare function sixHex(html: string): string;
+/**
+ * DOM-form of {@link sixHex} 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 sixHexDom(dom: ChildNode[]): ChildNode[];
+//#endregion
+export { sixHex, sixHexDom };
+//# sourceMappingURL=sixHex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sixHex.d.ts","names":[],"sources":["../../src/transformers/sixHex.ts"],"mappings":";;;;;AAkBA;;;;;AASA;;;;;iBATgB,MAAA,CAAO,IAAA;;;;;;iBASP,SAAA,CAAU,GAAA,EAAK,SAAA,KAAc,SAAA"}

package/dist/transformers/sixHex.js

@@ -0,0 +1,42 @@
+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 { conv } from "color-shorthand-hex-to-six-digit";
+//#region src/transformers/sixHex.ts
+const targets = new Set(["bgcolor", "color"]);
+/**
+* Convert 3-digit HEX color codes to 6-digit in `bgcolor` and `color`
+* attributes, for better email client compatibility.
+*
+* @param html HTML string to transform.
+* @returns    The transformed HTML string.
+*
+* @example
+* import { sixHex } from '@maizzle/framework'
+*
+* const out = sixHex('<font color="#abc">x</font>')
+*/
+function sixHex(html) {
+	return serialize(sixHexDom(parse(html)));
+}
+/**
+* DOM-form of {@link sixHex} 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 sixHexDom(dom) {
+	walk(dom, (node) => {
+		const el = node;
+		if (!el.attribs) return;
+		for (const attr of targets) {
+			const value = el.attribs[attr];
+			if (value) el.attribs[attr] = conv(value);
+		}
+	});
+	return dom;
+}
+//#endregion
+export { sixHex, sixHexDom };
+
+//# sourceMappingURL=sixHex.js.map

package/dist/transformers/sixHex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sixHex.js","names":[],"sources":["../../src/transformers/sixHex.ts"],"sourcesContent":["import { conv } from 'color-shorthand-hex-to-six-digit'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\nconst targets = new Set(['bgcolor', 'color'])\n\n/**\n * Convert 3-digit HEX color codes to 6-digit in `bgcolor` and `color`\n * attributes, for better email client compatibility.\n *\n * @param html HTML string to transform.\n * @returns    The transformed HTML string.\n *\n * @example\n * import { sixHex } from '@maizzle/framework'\n *\n * const out = sixHex('<font color=\"#abc\">x</font>')\n */\nexport function sixHex(html: string): string {\n  return serialize(sixHexDom(parse(html)))\n}\n\n/**\n * DOM-form of {@link sixHex} 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 function sixHexDom(dom: ChildNode[]): ChildNode[] {\n  walk(dom, (node) => {\n    const el = node as Element\n\n    if (!el.attribs) {\n      return\n    }\n\n    for (const attr of targets) {\n      const value = el.attribs[attr]\n\n      if (value) {\n        el.attribs[attr] = conv(value)\n      }\n    }\n  })\n\n  return dom\n}\n"],"mappings":";;;;;;AAIA,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,QAAQ,CAAC;;;;;;;;;;;;;AAc7C,SAAgB,OAAO,MAAsB;CAC3C,OAAO,UAAU,UAAU,MAAM,KAAK,CAAC,CAAC;;;;;;;AAQ1C,SAAgB,UAAU,KAA+B;CACvD,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EAEX,IAAI,CAAC,GAAG,SACN;EAGF,KAAK,MAAM,QAAQ,SAAS;GAC1B,MAAM,QAAQ,GAAG,QAAQ;GAEzB,IAAI,OACF,GAAG,QAAQ,QAAQ,KAAK,MAAM;;GAGlC;CAEF,OAAO"}