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

package/dist/transformers/addAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addAttributes.js","names":["merge"],"sources":["../../src/transformers/addAttributes.ts"],"sourcesContent":["import { defu as merge } from 'defu'\nimport type { ChildNode, Element } from 'domhandler'\nimport { walk } from '../utils/ast/index.ts'\nimport type { AttributesConfig } from '../types/config.ts'\n\n/**\n * Default attributes to add to elements.\n */\nconst DEFAULT_ATTRIBUTES: Record<string, Record<string, string | boolean | number>> = {\n  table: {\n    cellpadding: 0,\n    cellspacing: 0,\n    role: 'none',\n  },\n  img: {\n    alt: '',\n  },\n}\n\n/**\n * Add attributes transformer.\n *\n * Automatically adds attributes to HTML elements based on CSS selectors.\n *\n * Default attributes (can be disabled by setting `attributes.add` to false):\n * - table: cellpadding=\"0\", cellspacing=\"0\", role=\"none\"\n * - img: alt=\"\"\n *\n * Supports tag, class, id, and attribute selectors.\n * Multiple selectors can be specified by comma-separating them.\n *\n * Examples:\n * ```js\n * attributes: {\n *   add: {\n *     div: { role: 'article' },\n *     '.test': { editable: true },\n *     '#header': { 'data-id': 'main' },\n *     'div, p': { class: 'content' },\n *   }\n * }\n * ```\n */\nexport function addAttributes(dom: ChildNode[], config: AttributesConfig = {}): ChildNode[] {\n  const addConfig = config.add\n\n  // Disabled when explicitly set to false\n  if (addConfig === false) {\n    return dom\n  }\n\n  // Deep merge user attributes on top of defaults using defu\n  const userAttributes = typeof addConfig === 'object' ? addConfig : {}\n  const attributesToAdd = merge(userAttributes, DEFAULT_ATTRIBUTES) as Record<string, false | Record<string, false | string | boolean | number>>\n\n  if (Object.keys(attributesToAdd).length === 0) {\n    return dom\n  }\n\n  // Process each selector pattern\n  for (const [selectorPattern, attributes] of Object.entries(attributesToAdd)) {\n    // User opted out of this selector entirely (e.g. `table: false`)\n    if (attributes === false) continue\n    // Split by comma for multiple selectors\n    const selectors = selectorPattern.split(',').map(s => s.trim())\n\n    walk(dom, (node) => {\n      const el = node as Element\n      if (!el.name) return\n\n      // Check if element matches any selector in the pattern\n      const matches = selectors.some(selector => elementMatches(el, selector))\n\n      if (matches) {\n        // Initialize attribs if needed\n        if (!el.attribs) {\n          el.attribs = {}\n        }\n\n        for (const [attrName, attrValue] of Object.entries(attributes)) {\n          // User opted out of this specific attribute (e.g. `role: false`)\n          if (attrValue === false) continue\n          // Special handling for class - merge instead of replace\n          if (attrName === 'class' && el.attribs.class) {\n            const existingClasses = el.attribs.class.split(/\\s+/).filter(Boolean)\n            const newClasses = String(attrValue).split(/\\s+/).filter(Boolean)\n            const mergedClasses = [...new Set([...existingClasses, ...newClasses])]\n            if (mergedClasses.join(' ') !== el.attribs.class) {\n              el.attribs.class = mergedClasses.join(' ')\n            }\n          } else {\n            // Only add attribute if not already present\n            if (!(attrName in el.attribs)) {\n              el.attribs[attrName] = String(attrValue)\n            }\n          }\n        }\n      }\n    })\n  }\n\n  return dom\n}\n\n/**\n * Check if an element matches a CSS selector.\n * Supports: tag, .class, #id, [attribute], [attribute=value]\n */\nfunction elementMatches(el: Element, selector: string): boolean {\n  // Remove whitespace\n  selector = selector.trim()\n\n  // Check for attribute selector [attr] or [attr=value]\n  const attrMatch = selector.match(/^\\[([^\\]=]+)(?:=([^\\]]*))?\\]$/)\n  if (attrMatch) {\n    const [, attrName, attrValue] = attrMatch\n    if (attrValue === undefined) {\n      // Just checking if attribute exists\n      return attrName in (el.attribs || {})\n    } else {\n      // Check if attribute has specific value\n      return el.attribs?.[attrName] === attrValue\n    }\n  }\n\n  // Check for class selector .class\n  if (selector.startsWith('.')) {\n    const className = selector.slice(1)\n    const classes = el.attribs?.class?.split(/\\s+/) || []\n    return classes.includes(className)\n  }\n\n  // Check for id selector #id\n  if (selector.startsWith('#')) {\n    const id = selector.slice(1)\n    return el.attribs?.id === id\n  }\n\n  // Check for tag selector (possibly with attribute)\n  // Split tag from attribute if present, e.g., \"div[role=alert]\"\n  const tagAttrMatch = selector.match(/^([a-z][a-z0-9]*)\\[([^\\]]+)\\]$/i)\n  if (tagAttrMatch) {\n    const [, tagName, attrPart] = tagAttrMatch\n    if (el.name !== tagName) return false\n\n    // Parse attribute part: could be \"attr\" or \"attr=value\"\n    const attrEqMatch = attrPart.match(/^([^=]+)(?:=(.*))?$/)\n    if (attrEqMatch) {\n      const [, attrName, attrValue] = attrEqMatch\n      if (attrValue === undefined) {\n        return attrName in (el.attribs || {})\n      } else {\n        return el.attribs?.[attrName] === attrValue\n      }\n    }\n    return false\n  }\n\n  // Simple tag selector\n  return el.name === selector\n}\n"],"mappings":";;;;;;;AAQA,MAAM,qBAAgF;CACpF,OAAO;EACL,aAAa;EACb,aAAa;EACb,MAAM;EACP;CACD,KAAK,EACH,KAAK,IACN;CACF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BD,SAAgB,cAAc,KAAkB,SAA2B,EAAE,EAAe;CAC1F,MAAM,YAAY,OAAO;CAGzB,IAAI,cAAc,OAChB,OAAO;CAKT,MAAM,kBAAkBA,OADD,OAAO,cAAc,WAAW,YAAY,EAAE,EACvB,mBAAmB;CAEjE,IAAI,OAAO,KAAK,gBAAgB,CAAC,WAAW,GAC1C,OAAO;CAIT,KAAK,MAAM,CAAC,iBAAiB,eAAe,OAAO,QAAQ,gBAAgB,EAAE;EAE3E,IAAI,eAAe,OAAO;EAE1B,MAAM,YAAY,gBAAgB,MAAM,IAAI,CAAC,KAAI,MAAK,EAAE,MAAM,CAAC;EAE/D,KAAK,MAAM,SAAS;GAClB,MAAM,KAAK;GACX,IAAI,CAAC,GAAG,MAAM;GAKd,IAFgB,UAAU,MAAK,aAAY,eAAe,IAAI,SAAS,CAE5D,EAAE;IAEX,IAAI,CAAC,GAAG,SACN,GAAG,UAAU,EAAE;IAGjB,KAAK,MAAM,CAAC,UAAU,cAAc,OAAO,QAAQ,WAAW,EAAE;KAE9D,IAAI,cAAc,OAAO;KAEzB,IAAI,aAAa,WAAW,GAAG,QAAQ,OAAO;MAC5C,MAAM,kBAAkB,GAAG,QAAQ,MAAM,MAAM,MAAM,CAAC,OAAO,QAAQ;MACrE,MAAM,aAAa,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,OAAO,QAAQ;MACjE,MAAM,gBAAgB,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,iBAAiB,GAAG,WAAW,CAAC,CAAC;MACvE,IAAI,cAAc,KAAK,IAAI,KAAK,GAAG,QAAQ,OACzC,GAAG,QAAQ,QAAQ,cAAc,KAAK,IAAI;YAI5C,IAAI,EAAE,YAAY,GAAG,UACnB,GAAG,QAAQ,YAAY,OAAO,UAAU;;;IAKhD;;CAGJ,OAAO;;;;;;AAOT,SAAS,eAAe,IAAa,UAA2B;CAE9D,WAAW,SAAS,MAAM;CAG1B,MAAM,YAAY,SAAS,MAAM,gCAAgC;CACjE,IAAI,WAAW;EACb,MAAM,GAAG,UAAU,aAAa;EAChC,IAAI,cAAc,KAAA,GAEhB,OAAO,aAAa,GAAG,WAAW,EAAE;OAGpC,OAAO,GAAG,UAAU,cAAc;;CAKtC,IAAI,SAAS,WAAW,IAAI,EAAE;EAC5B,MAAM,YAAY,SAAS,MAAM,EAAE;EAEnC,QADgB,GAAG,SAAS,OAAO,MAAM,MAAM,IAAI,EAAE,EACtC,SAAS,UAAU;;CAIpC,IAAI,SAAS,WAAW,IAAI,EAAE;EAC5B,MAAM,KAAK,SAAS,MAAM,EAAE;EAC5B,OAAO,GAAG,SAAS,OAAO;;CAK5B,MAAM,eAAe,SAAS,MAAM,kCAAkC;CACtE,IAAI,cAAc;EAChB,MAAM,GAAG,SAAS,YAAY;EAC9B,IAAI,GAAG,SAAS,SAAS,OAAO;EAGhC,MAAM,cAAc,SAAS,MAAM,sBAAsB;EACzD,IAAI,aAAa;GACf,MAAM,GAAG,UAAU,aAAa;GAChC,IAAI,cAAc,KAAA,GAChB,OAAO,aAAa,GAAG,WAAW,EAAE;QAEpC,OAAO,GAAG,UAAU,cAAc;;EAGtC,OAAO;;CAIT,OAAO,GAAG,SAAS"}

package/dist/transformers/attributeToStyle.d.ts

@@ -1,4 +1,3 @@
-import { CssConfig } from "../types/config.js";
 import { ChildNode } from "domhandler";
 
 //#region src/transformers/attributeToStyle.d.ts
@@ -6,20 +5,34 @@ import { ChildNode } from "domhandler";
  * Convert HTML attributes to inline CSS styles.
  *
  * Supported attributes:
- * - width: converted to `width: ${value}${unit}` (supports px and %, defaults to px)
- * - height: converted to `height: ${value}${unit}` (supports px and %, defaults to px)
- * - bgcolor: converted to `background-color: ${value}`
- * - background: converted to `background-image: url('${value}')`
- * - align: on `<table>` elements, `left`/`right` become `float`, `center` becomes `margin: 0 auto`;
- *          on other elements, becomes `text-align: ${value}`
- * - valign: converted to `vertical-align: ${value}`
+ * - `width`: `width: ${value}${unit}` (px and %, defaults to px)
+ * - `height`: `height: ${value}${unit}` (px and %, defaults to px)
+ * - `bgcolor`: `background-color: ${value}`
+ * - `background`: `background-image: url('${value}')`
+ * - `align`: on `<table>`, `left`/`right` become `float`, `center` becomes
+ *   `margin-left/right: auto`; on other elements, becomes `text-align`
+ * - `valign`: `vertical-align: ${value}`
  *
- * Enabled via `config.css.inline.attributeToStyle`:
- * - `true`: process all default attributes
- * - `false` or `undefined`: disabled (returns html unchanged)
- * - `string[]`: process only the specified attributes
+ * @param html       HTML string to transform.
+ * @param attributes `true` to process the default set, an array to restrict
+ *                   to specific attribute names, `false` to disable.
+ * @returns          The transformed HTML string.
+ *
+ * @example
+ * import { attributeToStyle } from '@maizzle/framework'
+ *
+ * const out = attributeToStyle('<table align="center"><tr><td bgcolor="#f00">x</td></tr></table>')
+ *
+ * // Restrict to specific attributes:
+ * const limited = attributeToStyle(html, ['width', 'height'])
+ */
+declare function attributeToStyle(html: string, attributes?: boolean | string[]): string;
+/**
+ * DOM-form of {@link attributeToStyle} 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 attributeToStyle(dom: ChildNode[], config?: CssConfig): ChildNode[];
+declare function attributeToStyleDom(dom: ChildNode[], attributes?: boolean | string[]): ChildNode[];
 //#endregion
-export { attributeToStyle };
+export { attributeToStyle, attributeToStyleDom };
 //# sourceMappingURL=attributeToStyle.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"attributeToStyle.d.ts","names":[],"sources":["../../src/transformers/attributeToStyle.ts"],"mappings":";;;;;;AA0BA;;;;;;;;;;;;;;;iBAAgB,gBAAA,CAAiB,GAAA,EAAK,SAAA,IAAa,MAAA,GAAQ,SAAA,GAAiB,SAAA"}
+{"version":3,"file":"attributeToStyle.d.ts","names":[],"sources":["../../src/transformers/attributeToStyle.ts"],"mappings":";;;;;AAiCA;;;;;AASA;;;;;;;;;;;;;;;;;;iBATgB,gBAAA,CAAiB,IAAA,UAAc,UAAA;;;;;;iBAS/B,mBAAA,CAAoB,GAAA,EAAK,SAAA,IAAa,UAAA,wBAAwC,SAAA"}

package/dist/transformers/attributeToStyle.js

@@ -0,0 +1,94 @@
+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/attributeToStyle.ts
+/**
+* Default list of attributes that can be converted to inline styles.
+*/
+const DEFAULT_ATTRIBUTES = [
+	"width",
+	"height",
+	"bgcolor",
+	"background",
+	"align",
+	"valign"
+];
+/**
+* Convert HTML attributes to inline CSS styles.
+*
+* Supported attributes:
+* - `width`: `width: ${value}${unit}` (px and %, defaults to px)
+* - `height`: `height: ${value}${unit}` (px and %, defaults to px)
+* - `bgcolor`: `background-color: ${value}`
+* - `background`: `background-image: url('${value}')`
+* - `align`: on `<table>`, `left`/`right` become `float`, `center` becomes
+*   `margin-left/right: auto`; on other elements, becomes `text-align`
+* - `valign`: `vertical-align: ${value}`
+*
+* @param html       HTML string to transform.
+* @param attributes `true` to process the default set, an array to restrict
+*                   to specific attribute names, `false` to disable.
+* @returns          The transformed HTML string.
+*
+* @example
+* import { attributeToStyle } from '@maizzle/framework'
+*
+* const out = attributeToStyle('<table align="center"><tr><td bgcolor="#f00">x</td></tr></table>')
+*
+* // Restrict to specific attributes:
+* const limited = attributeToStyle(html, ['width', 'height'])
+*/
+function attributeToStyle(html, attributes = true) {
+	return serialize(attributeToStyleDom(parse(html), attributes));
+}
+/**
+* DOM-form of {@link attributeToStyle} 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 attributeToStyleDom(dom, attributes = true) {
+	if (!attributes) return dom;
+	const attributesToProcess = attributes === true ? DEFAULT_ATTRIBUTES : Array.isArray(attributes) ? attributes : [];
+	if (attributesToProcess.length === 0) return dom;
+	walk(dom, (node) => {
+		const el = node;
+		if (!("attribs" in el) || !el.attribs) return;
+		const styles = [];
+		for (const attr of attributesToProcess) {
+			const value = el.attribs[attr];
+			if (!value) continue;
+			const styleValue = convertAttributeToStyle(el.name, attr, value);
+			if (styleValue) styles.push(styleValue);
+		}
+		if (styles.length > 0) {
+			const existingStyle = el.attribs.style || "";
+			const separator = existingStyle ? "; " : "";
+			el.attribs.style = existingStyle + separator + styles.join("; ");
+		}
+	});
+	return dom;
+}
+/**
+* Convert a single HTML attribute value to a CSS style declaration.
+*/
+function convertAttributeToStyle(tagName, attr, value) {
+	switch (attr) {
+		case "width":
+		case "height": return `${attr}: ${/^\d+$/.test(value) ? `${value}px` : value}`;
+		case "bgcolor": return `background-color: ${value}`;
+		case "background": return `background-image: url('${value}')`;
+		case "align":
+			if (tagName === "table") {
+				if (value === "left" || value === "right") return `float: ${value}`;
+				if (value === "center") return "margin-left: auto; margin-right: auto";
+			}
+			return `text-align: ${value}`;
+		case "valign": return `vertical-align: ${value}`;
+		default: return null;
+	}
+}
+//#endregion
+export { attributeToStyle, attributeToStyleDom };
+
+//# sourceMappingURL=attributeToStyle.js.map

package/dist/transformers/attributeToStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributeToStyle.js","names":[],"sources":["../../src/transformers/attributeToStyle.ts"],"sourcesContent":["import type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\n/**\n * Default list of attributes that can be converted to inline styles.\n */\nconst DEFAULT_ATTRIBUTES = ['width', 'height', 'bgcolor', 'background', 'align', 'valign']\n\n/**\n * Convert HTML attributes to inline CSS styles.\n *\n * Supported attributes:\n * - `width`: `width: ${value}${unit}` (px and %, defaults to px)\n * - `height`: `height: ${value}${unit}` (px and %, defaults to px)\n * - `bgcolor`: `background-color: ${value}`\n * - `background`: `background-image: url('${value}')`\n * - `align`: on `<table>`, `left`/`right` become `float`, `center` becomes\n *   `margin-left/right: auto`; on other elements, becomes `text-align`\n * - `valign`: `vertical-align: ${value}`\n *\n * @param html       HTML string to transform.\n * @param attributes `true` to process the default set, an array to restrict\n *                   to specific attribute names, `false` to disable.\n * @returns          The transformed HTML string.\n *\n * @example\n * import { attributeToStyle } from '@maizzle/framework'\n *\n * const out = attributeToStyle('<table align=\"center\"><tr><td bgcolor=\"#f00\">x</td></tr></table>')\n *\n * // Restrict to specific attributes:\n * const limited = attributeToStyle(html, ['width', 'height'])\n */\nexport function attributeToStyle(html: string, attributes: boolean | string[] = true): string {\n  return serialize(attributeToStyleDom(parse(html), attributes))\n}\n\n/**\n * DOM-form of {@link attributeToStyle} 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 attributeToStyleDom(dom: ChildNode[], attributes: boolean | string[] = true): ChildNode[] {\n  if (!attributes) return dom\n\n  const attributesToProcess: string[] = attributes === true\n    ? DEFAULT_ATTRIBUTES\n    : Array.isArray(attributes)\n      ? attributes\n      : []\n\n  if (attributesToProcess.length === 0) return dom\n\n  walk(dom, (node) => {\n    const el = node as Element\n\n    if (!('attribs' in el) || !el.attribs) {\n      return\n    }\n\n    const styles: string[] = []\n\n    for (const attr of attributesToProcess) {\n      const value = el.attribs[attr]\n      if (!value) continue\n\n      const styleValue = convertAttributeToStyle(el.name, attr, value)\n      if (styleValue) {\n        styles.push(styleValue)\n      }\n    }\n\n    // Append new styles to existing style attribute\n    if (styles.length > 0) {\n      const existingStyle = el.attribs.style || ''\n      const separator = existingStyle ? '; ' : ''\n      el.attribs.style = existingStyle + separator + styles.join('; ')\n    }\n  })\n\n  return dom\n}\n\n/**\n * Convert a single HTML attribute value to a CSS style declaration.\n */\nfunction convertAttributeToStyle(\n  tagName: string,\n  attr: string,\n  value: string,\n): string | null {\n  switch (attr) {\n    case 'width':\n    case 'height': {\n      // Support px and % values, default to px if no unit\n      const normalizedValue = /^\\d+$/.test(value) ? `${value}px` : value\n      return `${attr}: ${normalizedValue}`\n    }\n\n    case 'bgcolor':\n      return `background-color: ${value}`\n\n    case 'background':\n      return `background-image: url('${value}')`\n\n    case 'align': {\n      // On table elements: left/right -> float, center -> margin auto\n      if (tagName === 'table') {\n        if (value === 'left' || value === 'right') {\n          return `float: ${value}`\n        }\n        if (value === 'center') {\n          return 'margin-left: auto; margin-right: auto'\n        }\n      }\n      // On other elements: text-align\n      return `text-align: ${value}`\n    }\n\n    case 'valign':\n      return `vertical-align: ${value}`\n\n    default:\n      return null\n  }\n}\n"],"mappings":";;;;;;;;AAMA,MAAM,qBAAqB;CAAC;CAAS;CAAU;CAAW;CAAc;CAAS;CAAS;;;;;;;;;;;;;;;;;;;;;;;;;;AA2B1F,SAAgB,iBAAiB,MAAc,aAAiC,MAAc;CAC5F,OAAO,UAAU,oBAAoB,MAAM,KAAK,EAAE,WAAW,CAAC;;;;;;;AAQhE,SAAgB,oBAAoB,KAAkB,aAAiC,MAAmB;CACxG,IAAI,CAAC,YAAY,OAAO;CAExB,MAAM,sBAAgC,eAAe,OACjD,qBACA,MAAM,QAAQ,WAAW,GACvB,aACA,EAAE;CAER,IAAI,oBAAoB,WAAW,GAAG,OAAO;CAE7C,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EAEX,IAAI,EAAE,aAAa,OAAO,CAAC,GAAG,SAC5B;EAGF,MAAM,SAAmB,EAAE;EAE3B,KAAK,MAAM,QAAQ,qBAAqB;GACtC,MAAM,QAAQ,GAAG,QAAQ;GACzB,IAAI,CAAC,OAAO;GAEZ,MAAM,aAAa,wBAAwB,GAAG,MAAM,MAAM,MAAM;GAChE,IAAI,YACF,OAAO,KAAK,WAAW;;EAK3B,IAAI,OAAO,SAAS,GAAG;GACrB,MAAM,gBAAgB,GAAG,QAAQ,SAAS;GAC1C,MAAM,YAAY,gBAAgB,OAAO;GACzC,GAAG,QAAQ,QAAQ,gBAAgB,YAAY,OAAO,KAAK,KAAK;;GAElE;CAEF,OAAO;;;;;AAMT,SAAS,wBACP,SACA,MACA,OACe;CACf,QAAQ,MAAR;EACE,KAAK;EACL,KAAK,UAGH,OAAO,GAAG,KAAK,IADS,QAAQ,KAAK,MAAM,GAAG,GAAG,MAAM,MAAM;EAI/D,KAAK,WACH,OAAO,qBAAqB;EAE9B,KAAK,cACH,OAAO,0BAA0B,MAAM;EAEzC,KAAK;GAEH,IAAI,YAAY,SAAS;IACvB,IAAI,UAAU,UAAU,UAAU,SAChC,OAAO,UAAU;IAEnB,IAAI,UAAU,UACZ,OAAO;;GAIX,OAAO,eAAe;EAGxB,KAAK,UACH,OAAO,mBAAmB;EAE5B,SACE,OAAO"}

package/dist/transformers/base.d.ts

@@ -1,8 +1,71 @@
-import { UrlConfig } from "../types/config.js";
 import { ChildNode } from "domhandler";
 
 //#region src/transformers/base.d.ts
-declare function base(dom: ChildNode[], config?: UrlConfig): ChildNode[];
+/**
+ * Options for the `base` transformer.
+ */
+interface BaseUrlOptions {
+  /** Base URL to prepend to relative links. */
+  url: string;
+  /**
+   * Tag/attribute scope for prepending. Omit to use the built-in defaults
+   * (`a[href]`, `img[src]`, `link[href]`, etc.).
+   *
+   * - Array of tag names — restrict the built-in defaults to these tags.
+   * - Object — explicit per-tag attribute map. Each attribute value is
+   *   `true` (use the base url) or a string (use that string as the url
+   *   for this attribute only).
+   */
+  tags?: string[] | Record<string, Record<string, string | boolean>>;
+  /**
+   * Custom attributes to rewrite globally, regardless of tag. Each key
+   * is the attribute name; the value is the URL to prepend.
+   */
+  attributes?: Record<string, string>;
+  /**
+   * Rewrite `url()` references inside `<style>` tag contents.
+   *
+   * @default true
+   */
+  styleTag?: boolean;
+  /**
+   * Rewrite `url()` references inside inline `style` attributes.
+   *
+   * @default true
+   */
+  inlineCss?: boolean;
+}
+/**
+ * Prepend a base URL to relative `src`/`href`/etc. references throughout
+ * the document, including inside `<style>` blocks, inline `style`
+ * attributes, MSO conditional comments, and VML tags.
+ *
+ * @param html    HTML string to transform.
+ * @param options Either a base URL string, or a {@link BaseUrlOptions} object
+ *                for finer control.
+ * @returns       The transformed HTML string.
+ *
+ * @example
+ * import { base } from '@maizzle/framework'
+ *
+ * // Just a URL — applied with the built-in tag/attribute defaults.
+ * const out = base('<img src="/a.png">', 'https://cdn.example.com/')
+ *
+ * // Restrict to specific tags, opt out of style rewriting:
+ * const limited = base(html, {
+ *   url: 'https://cdn.example.com/',
+ *   tags: ['img'],
+ *   styleTag: false,
+ *   inlineCss: false,
+ * })
+ */
+declare function base(html: string, options: string | BaseUrlOptions): string;
+/**
+ * DOM-form of {@link base} 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 baseDom(dom: ChildNode[], options: string | BaseUrlOptions | undefined | null | false): ChildNode[];
 //#endregion
-export { base };
+export { BaseUrlOptions, base, baseDom };
 //# sourceMappingURL=base.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/transformers/base.ts"],"mappings":";;;;iBAwHgB,IAAA,CAAK,GAAA,EAAK,SAAA,IAAa,MAAA,GAAQ,SAAA,GAAiB,SAAA"}
+{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/transformers/base.ts"],"mappings":";;;;;AAUA;UAAiB,cAAA;;EAEf,GAAA;EAUkB;;;;;;;;;EAAlB,IAAA,cAAkB,MAAA,SAAe,MAAA;EAWjC;;;;EANA,UAAA,GAAa,MAAA;EAuIK;;;;;EAjIlB,QAAA;EAiIiE;;AASnE;;;EApIE,SAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;iBA2Hc,IAAA,CAAK,IAAA,UAAc,OAAA,WAAkB,cAAA;;;;;;iBASrC,OAAA,CAAQ,GAAA,EAAK,SAAA,IAAa,OAAA,WAAkB,cAAA,8BAA4C,SAAA"}

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

@@ -1,12 +1,11 @@
-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 { defaultTags, isAbsoluteUrl, processSrcset } from "../utils/url.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 { defaultTags, isAbsoluteUrl, processSrcset } from "../utils/url.js";
 import postcss from "postcss";
 import safeParser from "postcss-safe-parser";
 import valueParser from "postcss-value-parser";
-
 //#region src/transformers/base.ts
 const sourceAttributes = [
 	"src",
@@ -59,24 +58,19 @@ function processInlineStyle(style, url) {
 		return style;
 	}
 }
-function getBaseUrl(config) {
-	const baseUrlConfig = config.base;
-	if (!baseUrlConfig || baseUrlConfig === "") return;
-	return baseUrlConfig;
-}
-function resolveOptions(baseUrlConfig) {
-	if (!baseUrlConfig) return void 0;
-	if (typeof baseUrlConfig === "string") return {
-		url: baseUrlConfig,
+function resolveOptions(input) {
+	if (!input) return void 0;
+	if (typeof input === "string") return {
+		url: input,
 		styleTag: true,
 		inlineCss: true
 	};
-	if (typeof baseUrlConfig === "object" && "url" in baseUrlConfig) return {
-		url: baseUrlConfig.url ?? "",
-		tags: baseUrlConfig.tags,
-		attributes: baseUrlConfig.attributes,
-		styleTag: baseUrlConfig.styleTag ?? true,
-		inlineCss: baseUrlConfig.inlineCss ?? true
+	if (typeof input === "object" && "url" in input) return {
+		url: input.url ?? "",
+		tags: input.tags,
+		attributes: input.attributes,
+		styleTag: input.styleTag ?? true,
+		inlineCss: input.inlineCss ?? true
 	};
 }
 function getTagConfig(tagName, options) {
@@ -88,10 +82,42 @@ function getTagConfig(tagName, options) {
 	}
 	if (typeof tags === "object") return tags[tagName];
 }
-function base(dom, config = {}) {
-	const options = resolveOptions(getBaseUrl(config));
-	if (!options || !options.url) return dom;
-	const { url: baseUrl, styleTag = true, inlineCss = true, attributes = {} } = options;
+/**
+* Prepend a base URL to relative `src`/`href`/etc. references throughout
+* the document, including inside `<style>` blocks, inline `style`
+* attributes, MSO conditional comments, and VML tags.
+*
+* @param html    HTML string to transform.
+* @param options Either a base URL string, or a {@link BaseUrlOptions} object
+*                for finer control.
+* @returns       The transformed HTML string.
+*
+* @example
+* import { base } from '@maizzle/framework'
+*
+* // Just a URL — applied with the built-in tag/attribute defaults.
+* const out = base('<img src="/a.png">', 'https://cdn.example.com/')
+*
+* // Restrict to specific tags, opt out of style rewriting:
+* const limited = base(html, {
+*   url: 'https://cdn.example.com/',
+*   tags: ['img'],
+*   styleTag: false,
+*   inlineCss: false,
+* })
+*/
+function base(html, options) {
+	return serialize(baseDom(parse(html), options));
+}
+/**
+* DOM-form of {@link base} 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 baseDom(dom, options) {
+	const resolved = resolveOptions(options);
+	if (!resolved || !resolved.url) return dom;
+	const { url: baseUrl, styleTag = true, inlineCss = true, attributes = {} } = resolved;
 	walk(dom, (node) => {
 		const el = node;
 		if (!el.name) return;
@@ -104,8 +130,8 @@ function base(dom, config = {}) {
 			return;
 		}
 		if (!el.attribs) return;
-		const tagConfig = getTagConfig(el.name, options);
-		if (tagConfig || options.tags === void 0) for (const [attr, value] of Object.entries(el.attribs)) {
+		const tagConfig = getTagConfig(el.name, resolved);
+		if (tagConfig || resolved.tags === void 0) for (const [attr, value] of Object.entries(el.attribs)) {
 			if (!value) continue;
 			const attrConfig = tagConfig?.[attr];
 			if (!attrConfig && attr !== "style") continue;
@@ -154,7 +180,7 @@ function rewriteMsoComments(html, url) {
 		return result;
 	});
 }
-
 //#endregion
-export { base };
-//# sourceMappingURL=base.mjs.map
+export { base, baseDom };
+
+//# sourceMappingURL=base.js.map

package/dist/transformers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","names":[],"sources":["../../src/transformers/base.ts"],"sourcesContent":["import postcss from 'postcss'\nimport safeParser from 'postcss-safe-parser'\nimport valueParser from 'postcss-value-parser'\nimport { walk, serialize, parse } from '../utils/ast/index.ts'\nimport { isAbsoluteUrl, defaultTags, processSrcset } from '../utils/url.ts'\nimport type { ChildNode, Element } from 'domhandler'\n\n/**\n * Options for the `base` transformer.\n */\nexport interface BaseUrlOptions {\n  /** Base URL to prepend to relative links. */\n  url: string\n  /**\n   * Tag/attribute scope for prepending. Omit to use the built-in defaults\n   * (`a[href]`, `img[src]`, `link[href]`, etc.).\n   *\n   * - Array of tag names — restrict the built-in defaults to these tags.\n   * - Object — explicit per-tag attribute map. Each attribute value is\n   *   `true` (use the base url) or a string (use that string as the url\n   *   for this attribute only).\n   */\n  tags?: string[] | Record<string, Record<string, string | boolean>>\n  /**\n   * Custom attributes to rewrite globally, regardless of tag. Each key\n   * is the attribute name; the value is the URL to prepend.\n   */\n  attributes?: Record<string, string>\n  /**\n   * Rewrite `url()` references inside `<style>` tag contents.\n   *\n   * @default true\n   */\n  styleTag?: boolean\n  /**\n   * Rewrite `url()` references inside inline `style` attributes.\n   *\n   * @default true\n   */\n  inlineCss?: boolean\n}\n\nconst sourceAttributes = ['src', 'href', 'srcset', 'poster', 'background', 'data']\n\n/**\n * Convert the shared `defaultTags` (tag → string[]) into the richer format\n * the transformer needs (tag → Record<attr, true>).\n */\nconst defaultTagConfig: Record<string, Record<string, string | boolean>> = Object.fromEntries(\n  Object.entries(defaultTags).map(([tag, attrs]) => [\n    tag,\n    Object.fromEntries(attrs.map(attr => [attr, true])),\n  ]),\n)\n\nconst postcssBaseUrl: postcss.PluginCreator<{ url: string }> = (opts) => {\n  return {\n    postcssPlugin: 'postcss-base-url',\n    Declaration(decl) {\n      if (!decl.value.includes('url(')) return\n\n      const parsed = valueParser(decl.value)\n      let changed = false\n\n      parsed.walk(node => {\n        if (node.type !== 'function' || node.value !== 'url') return\n\n        const urlNode = node.nodes[0]\n        if (!urlNode) return\n\n        if (isAbsoluteUrl(urlNode.value)) return\n\n        urlNode.value = opts!.url + urlNode.value\n        changed = true\n      })\n\n      if (changed) {\n        decl.value = parsed.toString()\n      }\n    }\n  }\n}\npostcssBaseUrl.postcss = true\n\nfunction processCss(css: string, url: string): string {\n  const { css: result } = postcss([postcssBaseUrl({ url })]).process(css, { parser: safeParser, from: undefined })\n  return result\n}\n\nfunction processInlineStyle(style: string, url: string): string {\n  try {\n    const { css } = postcss([postcssBaseUrl({ url })]).process(`a{${style}}`, { parser: safeParser, from: undefined })\n    const match = css.match(/a\\s*\\{\\s*([\\s\\S]*?)\\s*\\}/)\n    return match?.[1]?.trim() ?? style\n  } catch {\n    return style\n  }\n}\n\nfunction resolveOptions(input: string | BaseUrlOptions | undefined | null | false): BaseUrlOptions | undefined {\n  if (!input) return undefined\n  if (typeof input === 'string') {\n    return { url: input, styleTag: true, inlineCss: true }\n  }\n  if (typeof input === 'object' && 'url' in input) {\n    return {\n      url: input.url ?? '',\n      tags: input.tags,\n      attributes: input.attributes,\n      styleTag: input.styleTag ?? true,\n      inlineCss: input.inlineCss ?? true,\n    }\n  }\n  return undefined\n}\n\nfunction getTagConfig(\n  tagName: string,\n  options: BaseUrlOptions\n): Record<string, string | boolean> | undefined {\n  const { tags } = options\n\n  if (tags === undefined) {\n    return defaultTagConfig[tagName]\n  }\n\n  if (Array.isArray(tags)) {\n    if (!tags.includes(tagName)) return undefined\n    return defaultTagConfig[tagName]\n  }\n\n  if (typeof tags === 'object') {\n    return tags[tagName]\n  }\n\n  return undefined\n}\n\n/**\n * Prepend a base URL to relative `src`/`href`/etc. references throughout\n * the document, including inside `<style>` blocks, inline `style`\n * attributes, MSO conditional comments, and VML tags.\n *\n * @param html    HTML string to transform.\n * @param options Either a base URL string, or a {@link BaseUrlOptions} object\n *                for finer control.\n * @returns       The transformed HTML string.\n *\n * @example\n * import { base } from '@maizzle/framework'\n *\n * // Just a URL — applied with the built-in tag/attribute defaults.\n * const out = base('<img src=\"/a.png\">', 'https://cdn.example.com/')\n *\n * // Restrict to specific tags, opt out of style rewriting:\n * const limited = base(html, {\n *   url: 'https://cdn.example.com/',\n *   tags: ['img'],\n *   styleTag: false,\n *   inlineCss: false,\n * })\n */\nexport function base(html: string, options: string | BaseUrlOptions): string {\n  return serialize(baseDom(parse(html), options))\n}\n\n/**\n * DOM-form of {@link base} 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 baseDom(dom: ChildNode[], options: string | BaseUrlOptions | undefined | null | false): ChildNode[] {\n  const resolved = resolveOptions(options)\n  if (!resolved || !resolved.url) return dom\n\n  const { url: baseUrl, styleTag = true, inlineCss = true, attributes = {} } = resolved\n\n  walk(dom, (node) => {\n    const el = node as Element\n    if (!el.name) return\n\n    // Process <style> tag content with PostCSS\n    if (el.name === 'style' && styleTag && el.children) {\n      for (const child of el.children) {\n        if (child.type === 'text') {\n          const textNode = child as unknown as { data: string }\n          const processed = processCss(textNode.data, baseUrl)\n          if (processed !== textNode.data) {\n            textNode.data = processed\n          }\n        }\n      }\n      return\n    }\n\n    if (!el.attribs) return\n\n    // Process tag-specific attributes (respects tags filter)\n    const tagConfig = getTagConfig(el.name, resolved)\n\n    if (tagConfig || resolved.tags === undefined) {\n      for (const [attr, value] of Object.entries(el.attribs)) {\n        if (!value) continue\n\n        const attrConfig = tagConfig?.[attr]\n        if (!attrConfig && attr !== 'style') continue\n\n        if (attr === 'srcset' && (attrConfig === true || typeof attrConfig === 'string')) {\n          const newSrcset = processSrcset(value, typeof attrConfig === 'string' ? attrConfig : baseUrl)\n          if (newSrcset !== value) {\n            el.attribs.srcset = newSrcset\n          }\n        } else if (attr === 'style' && inlineCss && value.includes('url(')) {\n          const newStyle = processInlineStyle(value, baseUrl)\n          if (newStyle !== value) {\n            el.attribs.style = newStyle\n          }\n        } else if (attrConfig === true && !isAbsoluteUrl(value)) {\n          el.attribs[attr] = baseUrl + value\n        } else if (typeof attrConfig === 'string' && !isAbsoluteUrl(value)) {\n          el.attribs[attr] = attrConfig + value\n        }\n      }\n    }\n\n    // Process custom attributes (not affected by tags filter)\n    for (const [attr, url] of Object.entries(attributes)) {\n      if (el.attribs[attr] && !isAbsoluteUrl(el.attribs[attr])) {\n        el.attribs[attr] = url + el.attribs[attr]\n      }\n    }\n  })\n\n  // VML and MSO comment rewrites require operating on serialized HTML\n  // (HTML comments are not represented as traversable DOM nodes)\n  const serialized = serialize(dom)\n  const rewritten = rewriteMsoComments(rewriteVMLs(serialized, baseUrl), baseUrl)\n\n  // Only re-parse if the regex passes actually changed anything\n  if (rewritten !== serialized) {\n    return parse(rewritten)\n  }\n\n  return dom\n}\n\nfunction rewriteVMLs(html: string, url: string): string {\n  html = html.replace(/<v:image[^>]+src=\"?([^\"\\s]+)\"/gi, (match, src) => {\n    if (isAbsoluteUrl(src)) return match\n    return match.replace(src, url + src)\n  })\n\n  html = html.replace(/<v:fill[^>]+src=\"?([^\"\\s]+)\"/gi, (match, src) => {\n    if (isAbsoluteUrl(src)) return match\n    return match.replace(src, url + src)\n  })\n\n  return html\n}\n\nfunction rewriteMsoComments(html: string, url: string): string {\n  return html.replace(/<!--\\[if [^\\]]+\\]>[\\s\\S]*?<!\\[endif\\]-->/g, (msoBlock) => {\n    let result = msoBlock\n\n    for (const attr of sourceAttributes) {\n      const attrRegex = new RegExp(`\\\\b${attr}=\"([^\"]+)\"`, 'gi')\n      result = result.replace(attrRegex, (match, value) => {\n        if (isAbsoluteUrl(value)) return match\n\n        if (attr === 'srcset') {\n          return `srcset=\"${processSrcset(value, url)}\"`\n        }\n\n        return `${attr}=\"${url}${value}\"`\n      })\n    }\n\n    // Use PostCSS for style attribute url() rewriting inside MSO comments\n    result = result.replace(/style=\"([^\"]+)\"/gi, (match, style) => {\n      if (!style.includes('url(')) return match\n      const processed = processInlineStyle(style, url)\n      return `style=\"${processed}\"`\n    })\n\n    return result\n  })\n}\n"],"mappings":"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"}

package/dist/transformers/{columnWidth.mjs → columnWidth.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/columnWidth.ts
 const RE_PERCENT = /^[\d.]+%$/;
 const NO_BORDER_STYLES = new Set(["none", "hidden"]);
@@ -541,7 +540,7 @@ function columnWidth(dom) {
 	});
 	return dom;
 }
-
 //#endregion
 export { columnWidth };
-//# sourceMappingURL=columnWidth.mjs.map
+
+//# sourceMappingURL=columnWidth.js.map

package/dist/transformers/columnWidth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnWidth.js","names":[],"sources":["../../src/transformers/columnWidth.ts"],"sourcesContent":["import postcss, { type Root, type Declaration } from 'postcss'\nimport safeParser from 'postcss-safe-parser'\nimport { walk } from '../utils/ast/index.ts'\nimport type { ChildNode, Element, ParentNode } from 'domhandler'\n\nconst RE_PERCENT = /^[\\d.]+%$/\nconst NO_BORDER_STYLES = new Set(['none', 'hidden'])\n\n/**\n * Stringify decls into a `; `-joined inline-style attribute. PostCSS raws\n * preserve the original source spacing, which mixes poorly with\n * the fresh decls we inject — plain join keeps output uniform.\n */\nfunction serializeStyle(root: Root): string {\n  const parts: string[] = []\n  root.walkDecls((d) => {\n    parts.push(`${d.prop}: ${d.value}${d.important ? ' !important' : ''}`)\n  })\n  return parts.join('; ')\n}\n\nfunction firstDeclValue(root: Root, prop: string): string | undefined {\n  let found: string | undefined\n  root.walkDecls(prop, (d) => {\n    found = d.value\n    return false\n  })\n  return found\n}\n\n/**\n * Find the user-set `min-width:` value on a column. Juice keeps both ours\n * and the one inlined from a class like `min-w-1/3` — we skip any\n * min-width whose value still contains our placeholder token,\n * returning the first remaining user value, or null.\n */\nfunction findUserMinWidth(root: Root): string | null {\n  let userVal: string | null = null\n  root.walkDecls('min-width', (d) => {\n    if (!d.value.includes('__MAIZZLE_COLW_')) {\n      userVal = d.value\n      return false\n    }\n  })\n  return userVal\n}\n\nfunction resolveLength(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\nfunction lengthToPx(value: string): number | null {\n  const m = value.trim().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 n\n    case 'rem':\n    case 'em': return n * 16\n    case 'pt': return n * 1.333\n    default: return null\n  }\n}\n\nfunction divideLength(value: string, divisor: number): string | null {\n  const m = value.match(/^([\\d.]+)(px|%)$/)\n  if (!m || divisor < 1) return null\n  const n = parseFloat(m[1])\n  return `${parseFloat((n / divisor).toFixed(2))}${m[2]}`\n}\n\nfunction subtractInsetPx(width: string, insetPx: number): string {\n  if (insetPx <= 0) return width\n  const m = width.match(/^([\\d.]+)(px|%)$/)\n  if (!m) return width\n  // Don't subtract px from percentage widths — units don't match.\n  if (m[2] === '%') return width\n  const n = parseFloat(m[1]) - insetPx\n  return `${Math.max(0, Math.round(n))}px`\n}\n\n/**\n * Return the smaller of two px lengths. Clamps our count-based min-width\n * down to the user's `max-width:` so the cap is never silently\n * violated when our computed min would exceed the user's max.\n */\nfunction minPxLength(a: string, b: string): string {\n  const am = a.match(/^([\\d.]+)px$/)\n  const bm = b.match(/^([\\d.]+)px$/)\n  if (!am || !bm) return a\n  return parseFloat(am[1]) < parseFloat(bm[1]) ? a : b\n}\n\n/**\n * Expand a 1-4 token CSS shorthand (T R B L) into a left/right pair:\n *   1: all sides\n *   2: TB RL\n *   3: T RL B\n *   4: T R B L\n */\nfunction shorthandSides(value: string): { left?: string; right?: string } {\n  const parts = value.trim().split(/\\s+/)\n  switch (parts.length) {\n    case 1: return { left: parts[0], right: parts[0] }\n    case 2:\n    case 3: return { left: parts[1], right: parts[1] }\n    case 4: return { left: parts[3], right: parts[1] }\n    default: return {}\n  }\n}\n\n/**\n * Read horizontal padding (left + right) px from a parsed style root.\n * Percentages are skipped — they'd need a known container width.\n */\nfunction horizontalPaddingPx(root: Root): number {\n  let left: number | null = null\n  let right: number | null = null\n\n  // Shorthand applies first; longhand overrides per side.\n  root.walkDecls((d) => {\n    switch (d.prop) {\n      case 'padding': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l) left = lengthToPx(l)\n        if (r) right = lengthToPx(r)\n        break\n      }\n      case 'padding-left':\n        left = lengthToPx(d.value)\n        break\n      case 'padding-right':\n        right = lengthToPx(d.value)\n        break\n    }\n  })\n\n  return (left ?? 0) + (right ?? 0)\n}\n\n/**\n * Extract a px length from a CSS border shorthand (e.g. `1px solid red` → 1).\n * Returns null when the value indicates no border — `none` or `hidden`.\n * Defaults to 3px (CSS `medium`) when a visible style is set but\n * no explicit width token is present in the shorthand value.\n */\nfunction shorthandBorderWidthPx(value: string): number | null {\n  const tokens = value.trim().split(/\\s+/)\n  if (tokens.some((t) => NO_BORDER_STYLES.has(t.toLowerCase()))) return null\n  for (const t of tokens) {\n    const px = lengthToPx(t)\n    if (px != null) return px\n  }\n  // Visible style, no explicit width → CSS default `medium` = 3px.\n  return 3\n}\n\n/**\n * Read horizontal border widths (left + right) px from a parsed style root.\n * Per-side `border-style: none|hidden` overrides count as zero\n * contribution. Returns total px or 0 when nothing resolves.\n */\nfunction horizontalBorderPx(root: Root): number {\n  let left: number | null = null\n  let right: number | null = null\n  let leftNone = false\n  let rightNone = false\n\n  root.walkDecls((d) => {\n    switch (d.prop) {\n      case 'border': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) {\n          leftNone = rightNone = true\n        }\n        else {\n          left = right = w\n          leftNone = rightNone = false\n        }\n        break\n      }\n      case 'border-width': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l) left = lengthToPx(l) ?? left\n        if (r) right = lengthToPx(r) ?? right\n        break\n      }\n      case 'border-style': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l && NO_BORDER_STYLES.has(l.toLowerCase())) leftNone = true\n        if (r && NO_BORDER_STYLES.has(r.toLowerCase())) rightNone = true\n        break\n      }\n      case 'border-left': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) leftNone = true\n        else { left = w; leftNone = false }\n        break\n      }\n      case 'border-right': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) rightNone = true\n        else { right = w; rightNone = false }\n        break\n      }\n      case 'border-left-width':\n        left = lengthToPx(d.value) ?? left\n        break\n      case 'border-right-width':\n        right = lengthToPx(d.value) ?? right\n        break\n      case 'border-left-style':\n        if (NO_BORDER_STYLES.has(d.value.trim().toLowerCase())) leftNone = true\n        break\n      case 'border-right-style':\n        if (NO_BORDER_STYLES.has(d.value.trim().toLowerCase())) rightNone = true\n        break\n    }\n  })\n\n  return (leftNone ? 0 : (left ?? 0)) + (rightNone ? 0 : (right ?? 0))\n}\n\nfunction depth(node: ChildNode): number {\n  let d = 0\n  let cur: ParentNode | null = node.parent\n  while (cur) {\n    d++\n    cur = (cur as any).parent ?? null\n  }\n  return d\n}\n\nfunction readWidthFromRoot(root: Root): string | null {\n  const raw = firstDeclValue(root, 'max-width')\n    ?? firstDeclValue(root, 'width')\n    ?? firstDeclValue(root, 'min-width')\n  return raw ? resolveLength(raw) : null\n}\n\nfunction readHeightFromRoot(root: Root): string | null {\n  const raw = firstDeclValue(root, 'max-height')\n    ?? firstDeclValue(root, 'height')\n    ?? firstDeclValue(root, 'min-height')\n  return raw ? resolveLength(raw) : null\n}\n\nfunction readWidthSource(el: Element, root: Root | null): string | null {\n  const explicit = el.attribs?.['data-maizzle-cw']\n  if (explicit) {\n    const r = resolveLength(explicit)\n    if (r) return r\n  }\n  return root ? readWidthFromRoot(root) : null\n}\n\n/**\n * Convert a user-supplied length to absolute px against the column's source\n * width (post-inset). Percentages multiply against the source while\n * absolute units pass through `resolveLength`. Returns null when\n * the value or source can't be expressed in px.\n */\nfunction userValueToPx(rawValue: string, sourcePx: string | null): string | null {\n  const trimmed = rawValue.trim()\n\n  const absMatch = trimmed.match(/^([\\d.]+)(px|rem|em|pt)$/i)\n  if (absMatch) return resolveLength(trimmed)\n\n  const pctMatch = trimmed.match(/^([\\d.]+)%$/)\n  if (!pctMatch || !sourcePx) return null\n  const sourceMatch = sourcePx.match(/^([\\d.]+)px$/)\n  if (!sourceMatch) return null\n  const pct = parseFloat(pctMatch[1])\n  const src = parseFloat(sourceMatch[1])\n  return `${Math.round((pct / 100) * src)}px`\n}\n\n/**\n * Resolve `__MAIZZLE_COLW_{id}__` and `__MAIZZLE_OH_{id}__` placeholders.\n *\n * COLW (column width) — emitted by `<Column>` and `<Overlap>`. Walks up to\n * the nearest ancestor marked `data-maizzle-cw` (Container, Section,\n * Row, or another Column already resolved) and divides the source\n * width by `data-maizzle-cw-count`. With `data-maizzle-cw-self`,\n * reads from the element's own inlined max/width/min-width\n * instead — used by `<Overlap>` with its own width class.\n *\n * OH (overlap height) — emitted by `<Overlap>`. Reads max-height, height,\n * or min-height from the element's own inlined style.\n *\n * Resolution rules:\n * - Style placeholders for `min-width`: replaced when resolvable, otherwise\n *   the entire `min-width` declaration is stripped.\n * - Other style placeholders (Overlap td `width`, etc.): replaced when\n *   resolvable, otherwise replaced with the count-based fallback or `100%`.\n * - Comment placeholders: same fallback chain.\n *\n * Resolved column widths are written back to `data-maizzle-cw` so nested\n * rows cascade. All `data-maizzle-cw*` and `data-maizzle-oh-*` are\n * stripped at the end of the second walk pass.\n */\nexport function columnWidth(dom: ChildNode[]): ChildNode[] {\n  /**\n   * Cache parsed style ASTs for this columnWidth invocation. The walk-up\n   * loop visits the same Section/Container once per column of a Row,\n   * so without caching each column re-parses every ancestor's style.\n   * Cache is function-local — no cross-build leak via the WeakMap.\n   */\n  const styleCache = new WeakMap<Element, Root>()\n  const parseElStyle = (el: Element): Root => {\n    const cached = styleCache.get(el)\n    if (cached) return cached\n    const style = el.attribs?.style ?? ''\n    const root = style ? safeParser(style) : postcss.root()\n    styleCache.set(el, root)\n    return root\n  }\n\n  const columns: { el: Element; id: string; count: number; d: number; self: boolean }[] = []\n  const heightTargets: { el: Element; id: string }[] = []\n\n  walk(dom, (node) => {\n    const el = node as Element\n    if (!el.attribs) return\n\n    const id = el.attribs['data-maizzle-cw-id']\n    if (id) {\n      const count = parseInt(el.attribs['data-maizzle-cw-count'] || '1', 10)\n      const self = 'data-maizzle-cw-self' in el.attribs\n      columns.push({ el, id, count, d: depth(node), self })\n    }\n\n    const ohId = el.attribs['data-maizzle-oh-id']\n    if (ohId) heightTargets.push({ el, id: ohId })\n  })\n\n  columns.sort((a, b) => a.d - b.d)\n\n  const widthResolutions = new Map<string, string>()\n  const widthFallbacks = new Map<string, string>()\n  /**\n   * Column ids whose absolute user `width:` was promoted to `min-width:`\n   * — the original `width:` declaration must be stripped from the\n   * column's style (otherwise it'd compete with the min-width).\n   */\n  const stripWidth = new Set<string>()\n  /**\n   * Column ids where the user wrote a percentage `width:` (e.g. `w-1/2`) —\n   * explicit opt-out of px-based stacking. Keep the user's `width: X%`\n   * and drop our `min-width:` placeholder so the column stays at\n   * that percentage of its parent forever and never stacks.\n   */\n  const dropMinWidth = new Set<string>()\n  /**\n   * Column ids where the user wrote their own `min-width:` (via `min-w-1/3`).\n   * Juice inlines theirs after ours, so two `min-width:` decls land in\n   * the style — we strip the user's after using its value as the\n   * column's resolution, leaving our placeholder as last word.\n   */\n  const stripUserMinWidth = new Set<string>()\n  /**\n   * Column ids where the user already supplied a `max-width:` of their own.\n   * Our default `max-width: 100%` would just be shadowed by it via\n   * last-wins and bloat the style — so we skip emitting it.\n   */\n  const userHasMaxWidth = new Set<string>()\n\n  for (const { id, count } of columns) {\n    widthFallbacks.set(id, `${Math.round(100 / Math.max(count, 1))}%`)\n  }\n\n  for (const { el, id, count, self } of columns) {\n    const ownRoot = parseElStyle(el)\n\n    let sourceWidth: string | null = null\n    let accumulatedInsetPx = 0\n\n    if (self) {\n      sourceWidth = readWidthFromRoot(ownRoot)\n      accumulatedInsetPx = horizontalPaddingPx(ownRoot) + horizontalBorderPx(ownRoot)\n    }\n    else {\n      /**\n       * Walk up through every ancestor with attribs, accumulating horizontal\n       * padding+border along the way (including the source). Stop at the\n       * first `data-maizzle-cw` ancestor whose width is resolvable.\n       * Markers without a resolvable width (Row emitted empty after\n       * Tailwind dropped a bogus class) shouldn't shadow a real\n       * width on a higher ancestor like `<Container>`.\n       *\n       * With CSS content-box this is technically generous toward the\n       * source's own padding/border, but matches user expectations\n       * when they put `px-9` or `border-2` on a wrapper.\n       */\n      let cur: ParentNode | null = el.parent\n      while (cur) {\n        const parentEl = cur as Element\n        if (parentEl.attribs) {\n          let pRoot: Root | null = null\n          if (parentEl.attribs.style) {\n            pRoot = parseElStyle(parentEl)\n            accumulatedInsetPx += horizontalPaddingPx(pRoot) + horizontalBorderPx(pRoot)\n          }\n          if ('data-maizzle-cw' in parentEl.attribs) {\n            const w = readWidthSource(parentEl, pRoot)\n            if (w) {\n              sourceWidth = w\n              break\n            }\n          }\n        }\n        cur = (cur as any).parent ?? null\n      }\n    }\n\n    const adjusted = sourceWidth ? subtractInsetPx(sourceWidth, accumulatedInsetPx) : null\n    const countBased = adjusted ? divideLength(adjusted, count) : null\n\n    /**\n     * Four user-override paths, decided by which CSS property the user\n     * actually wrote:\n     *\n     *   - `min-width: X` → user's value wins. Convert to px against\n     *                     the source (if %), use as the column's\n     *                     resolution, and strip the user's min-width\n     *                     declaration so our placeholder substitution\n     *                     remains the last `min-width:` in style.\n     *   - `width: X%`   → opt-out of px stacking. Keep `width:` in\n     *                     style, drop our `min-width:` placeholder.\n     *                     Cols stay at X% of parent forever, never stack.\n     *   - `width: Xpx` (or rem/em/pt) → fixed pixel column. Promote to\n     *                     `min-width:`, strip the original `width:` so\n     *                     it doesn't compete.\n     *   - `max-width: X` → CSS cap. Keep the `max-width:` declaration;\n     *                     clamp our count-based min-width *down* to\n     *                     the user's max-width when our min would\n     *                     otherwise violate it.\n     */\n    const userMinRaw = findUserMinWidth(ownRoot)\n    const widthRaw = firstDeclValue(ownRoot, 'width')\n    const maxRaw = firstDeclValue(ownRoot, 'max-width')\n\n    if (userMinRaw) {\n      const minPx = userValueToPx(userMinRaw, adjusted) ?? resolveLength(userMinRaw)\n      if (minPx) {\n        widthResolutions.set(id, minPx)\n        el.attribs['data-maizzle-cw'] = minPx\n        stripUserMinWidth.add(id)\n        continue\n      }\n    }\n\n    if (widthRaw) {\n      const widthVal = resolveLength(widthRaw)\n      if (widthVal?.endsWith('%')) {\n        widthResolutions.set(id, widthVal)\n        el.attribs['data-maizzle-cw'] = widthVal\n        dropMinWidth.add(id)\n        continue\n      }\n      if (widthVal) {\n        widthResolutions.set(id, widthVal)\n        el.attribs['data-maizzle-cw'] = widthVal\n        stripWidth.add(id)\n        continue\n      }\n    }\n\n    if (maxRaw && countBased) {\n      const maxPx = userValueToPx(maxRaw, adjusted)\n      if (maxPx) {\n        const cappedMin = countBased.endsWith('px')\n          ? minPxLength(countBased, maxPx)\n          : maxPx\n        widthResolutions.set(id, cappedMin)\n        el.attribs['data-maizzle-cw'] = cappedMin\n        userHasMaxWidth.add(id)\n        continue\n      }\n    }\n\n    if (countBased) {\n      widthResolutions.set(id, countBased)\n      el.attribs['data-maizzle-cw'] = countBased\n    }\n  }\n\n  const heightResolutions = new Map<string, string>()\n  for (const { el, id } of heightTargets) {\n    if (!el.attribs?.style) continue\n    const h = readHeightFromRoot(parseElStyle(el))\n    if (h) heightResolutions.set(id, h)\n  }\n\n  walk(dom, (node) => {\n    if (node.type === 'comment') {\n      const data = (node as any).data as string\n      if (!data || (!data.includes('__MAIZZLE_COLW_') && !data.includes('__MAIZZLE_OH_'))) return\n      ;(node as any).data = data\n        .replace(/__MAIZZLE_COLW_([^_]+)__/g,\n          (_m, mid) => widthResolutions.get(mid) ?? widthFallbacks.get(mid) ?? '100%')\n        .replace(/__MAIZZLE_OH_([^_]+)__/g,\n          (_m, hid) => heightResolutions.get(hid) ?? '100%')\n      return\n    }\n\n    const el = node as Element\n    if (!el.attribs) return\n\n    const style = el.attribs.style\n    if (style && (style.includes('__MAIZZLE_COLW_') || style.includes('__MAIZZLE_OH_'))) {\n      const root = parseElStyle(el)\n      const cwId = el.attribs['data-maizzle-cw-id']\n\n      /**\n       * Strip user dups BEFORE substitution — last-wins CSS would\n       * otherwise shadow our resolved values in the output.\n       */\n      if (cwId && stripUserMinWidth.has(cwId)) {\n        root.walkDecls('min-width', (d) => {\n          if (!d.value.includes('__MAIZZLE_COLW_')) d.remove()\n        })\n      }\n      if (cwId && stripWidth.has(cwId)) {\n        root.walkDecls('width', (d) => { d.remove() })\n      }\n\n      /**\n       * Substitute the column's `min-width:` placeholder with `width: <res>;\n       * max-width: 100%`. Width gives the same stacking trigger as\n       * min-width — inline-block wraps when children sum > parent\n       * — and the `max-width: 100%` clamp keeps the column from\n       * overflowing the viewport once it drops to its own row on\n       * mobile. Skip the clamp when the user supplied their own.\n       *\n       * Other placeholders (Overlap td `width`, comment markers,\n       * OH height) get a plain value substitution.\n       */\n      root.walkDecls((d) => {\n        if (d.prop === 'min-width') {\n          const m = d.value.match(/^__MAIZZLE_COLW_([^_]+)__$/)\n          if (m) {\n            const mid = m[1]\n            if (dropMinWidth.has(mid) || !widthResolutions.has(mid)) {\n              d.remove()\n              return\n            }\n            const resolved = widthResolutions.get(mid)!\n            const repl: Declaration[] = [postcss.decl({ prop: 'width', value: resolved })]\n            if (!userHasMaxWidth.has(mid)) {\n              repl.push(postcss.decl({ prop: 'max-width', value: '100%' }))\n            }\n            d.replaceWith(...repl)\n            return\n          }\n        }\n        if (d.value.includes('__MAIZZLE_COLW_') || d.value.includes('__MAIZZLE_OH_')) {\n          d.value = d.value\n            .replace(/__MAIZZLE_COLW_([^_]+)__/g,\n              (_m, mid) => widthResolutions.get(mid) ?? widthFallbacks.get(mid) ?? '100%')\n            .replace(/__MAIZZLE_OH_([^_]+)__/g,\n              (_m, hid) => heightResolutions.get(hid) ?? '100%')\n        }\n      })\n\n      const out = serializeStyle(root)\n      if (out) el.attribs.style = out\n      else delete el.attribs.style\n    }\n\n    delete el.attribs['data-maizzle-cw']\n    delete el.attribs['data-maizzle-cw-id']\n    delete el.attribs['data-maizzle-cw-count']\n    delete el.attribs['data-maizzle-cw-self']\n    delete el.attribs['data-maizzle-oh-id']\n  })\n\n  return dom\n}\n"],"mappings":"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"}

package/dist/transformers/entities.d.ts

@@ -2,7 +2,36 @@ import { EntitiesConfig } from "../types/config.js";
 import { ChildNode } from "domhandler";
 
 //#region src/transformers/entities.d.ts
-declare function entities(dom: ChildNode[], config?: EntitiesConfig): ChildNode[];
+/**
+ * Replace literal Unicode characters in text nodes with their HTML entity
+ * equivalents (zero-width joiners, non-breaking spaces, smart quotes,
+ * dashes, etc.) for better email-client rendering.
+ *
+ * @param html   HTML string to transform.
+ * @param custom Extra entries merged on top of the built-in entity map, or
+ *               `false` to disable the transform. Defaults to `true`
+ *               (built-ins only).
+ * @returns      The transformed HTML string.
+ *
+ * @example
+ * import { entities } from '@maizzle/framework'
+ *
+ * // Defaults only
+ * entities('hello world') // → 'hello world'
+ *
+ * // Add a custom mapping
+ * entities('© Maizzle', { '©': '©' })
+ *
+ * // Disable the transform
+ * entities('hello world', false)
+ */
+declare function entities(html: string, custom?: EntitiesConfig): string;
+/**
+ * DOM-form of {@link entities} 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 entitiesDom(dom: ChildNode[], custom?: EntitiesConfig): ChildNode[];
 //#endregion
-export { entities };
+export { entities, entitiesDom };
 //# sourceMappingURL=entities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","names":[],"sources":["../../src/transformers/entities.ts"],"mappings":";;;;iBA8BgB,QAAA,CAAS,GAAA,EAAK,SAAA,IAAa,MAAA,GAAQ,cAAA,GAAwB,SAAA"}
+{"version":3,"file":"entities.d.ts","names":[],"sources":["../../src/transformers/entities.ts"],"mappings":";;;;;;;AAqDA;;;;;;;;;AASA;;;;;;;;;;;iBATgB,QAAA,CAAS,IAAA,UAAc,MAAA,GAAQ,cAAA;;;;;;iBAS/B,WAAA,CAAY,GAAA,EAAK,SAAA,IAAa,MAAA,GAAQ,cAAA,GAAwB,SAAA"}

package/dist/transformers/entities.js

@@ -0,0 +1,73 @@
+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";
+//#region src/transformers/entities.ts
+const DEFAULT_ENTITIES = {
+	"‍": "‍",
+	"‌": "‌",
+	"\xA0": " ",
+	"­": "­",
+	"​": "​",
+	" ": " ",
+	"͏": "͏",
+	" ": " ",
+	"\u2028": "&LineSeparator;",
+	"\u2029": "&ParagraphSeparator;",
+	"·": "·",
+	"–": "–",
+	"—": "—",
+	"‘": "‘",
+	"’": "’",
+	"“": "“",
+	"”": "”",
+	"«": "«",
+	"»": "»",
+	"•": "•",
+	"‹": "‹",
+	"›": "›"
+};
+/**
+* Replace literal Unicode characters in text nodes with their HTML entity
+* equivalents (zero-width joiners, non-breaking spaces, smart quotes,
+* dashes, etc.) for better email-client rendering.
+*
+* @param html   HTML string to transform.
+* @param custom Extra entries merged on top of the built-in entity map, or
+*               `false` to disable the transform. Defaults to `true`
+*               (built-ins only).
+* @returns      The transformed HTML string.
+*
+* @example
+* import { entities } from '@maizzle/framework'
+*
+* // Defaults only
+* entities('hello world') // → 'hello world'
+*
+* // Add a custom mapping
+* entities('© Maizzle', { '©': '©' })
+*
+* // Disable the transform
+* entities('hello world', false)
+*/
+function entities(html, custom = true) {
+	return serialize(entitiesDom(parse(html), custom));
+}
+/**
+* DOM-form of {@link entities} 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 entitiesDom(dom, custom = true) {
+	if (!custom) return dom;
+	const map = typeof custom === "object" ? defu$1(custom, DEFAULT_ENTITIES) : DEFAULT_ENTITIES;
+	walk(dom, (node) => {
+		if (node.type === "text") for (const [char, entity] of Object.entries(map)) node.data = node.data.split(char).join(entity);
+	});
+	return dom;
+}
+//#endregion
+export { entities, entitiesDom };
+
+//# sourceMappingURL=entities.js.map