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

package/dist/tests/render/_helpers.d.ts

@@ -0,0 +1,6 @@
+//#region src/tests/render/_helpers.d.ts
+declare function createTempProject(): string;
+declare function writeSfc(dir: string, path: string, content: string): void;
+//#endregion
+export { createTempProject, writeSfc };
+//# sourceMappingURL=_helpers.d.ts.map

package/dist/tests/render/_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.d.ts","names":[],"sources":["../../../src/tests/render/_helpers.ts"],"mappings":";iBAIgB,iBAAA,CAAA;AAAA,iBAKA,QAAA,CAAS,GAAA,UAAa,IAAA,UAAc,OAAA"}

package/dist/tests/render/_helpers.js

@@ -0,0 +1,16 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+//#region src/tests/render/_helpers.ts
+function createTempProject() {
+	return mkdtempSync(join(tmpdir(), "maizzle-render-"));
+}
+function writeSfc(dir, path, content) {
+	const full = join(dir, path);
+	mkdirSync(join(dir, ...path.split("/").slice(0, -1)), { recursive: true });
+	writeFileSync(full, content);
+}
+//#endregion
+export { createTempProject, writeSfc };
+
+//# sourceMappingURL=_helpers.js.map

package/dist/tests/render/_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.js","names":[],"sources":["../../../src/tests/render/_helpers.ts"],"sourcesContent":["import { mkdtempSync, writeFileSync, mkdirSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { tmpdir } from 'node:os'\n\nexport function createTempProject() {\n  const dir = mkdtempSync(join(tmpdir(), 'maizzle-render-'))\n  return dir\n}\n\nexport function writeSfc(dir: string, path: string, content: string) {\n  const full = join(dir, path)\n  mkdirSync(join(dir, ...path.split('/').slice(0, -1)), { recursive: true })\n  writeFileSync(full, content)\n}\n"],"mappings":";;;;AAIA,SAAgB,oBAAoB;CAElC,OADY,YAAY,KAAK,QAAQ,EAAE,kBAAkB,CAC/C;;AAGZ,SAAgB,SAAS,KAAa,MAAc,SAAiB;CACnE,MAAM,OAAO,KAAK,KAAK,KAAK;CAC5B,UAAU,KAAK,KAAK,GAAG,KAAK,MAAM,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,WAAW,MAAM,CAAC;CAC1E,cAAc,MAAM,QAAQ"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"addAttributes.d.ts","names":[],"sources":["../../src/transformers/addAttributes.ts"],"mappings":";;;;;;AA2CA;;;;;;;;;;;;;;;;;;;;;;iBAAgB,aAAA,CAAc,GAAA,EAAK,SAAA,IAAa,MAAA,GAAQ,gBAAA,GAAwB,SAAA"}

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

@@ -1,7 +1,6 @@
-import { walk } from "../utils/ast/walker.mjs";
-import "../utils/ast/index.mjs";
-import { defu } from "defu";
-
+import { walk } from "../utils/ast/walker.js";
+import "../utils/ast/index.js";
+import { defu as defu$1 } from "defu";
 //#region src/transformers/addAttributes.ts
 /**
 * Default attributes to add to elements.
@@ -41,21 +40,25 @@ const DEFAULT_ATTRIBUTES = {
 function addAttributes(dom, config = {}) {
 	const addConfig = config.add;
 	if (addConfig === false) return dom;
-	const attributesToAdd = defu(typeof addConfig === "object" ? addConfig : {}, DEFAULT_ATTRIBUTES);
+	const attributesToAdd = defu$1(typeof addConfig === "object" ? addConfig : {}, DEFAULT_ATTRIBUTES);
 	if (Object.keys(attributesToAdd).length === 0) return dom;
 	for (const [selectorPattern, attributes] of Object.entries(attributesToAdd)) {
+		if (attributes === false) continue;
 		const selectors = selectorPattern.split(",").map((s) => s.trim());
 		walk(dom, (node) => {
 			const el = node;
 			if (!el.name) return;
 			if (selectors.some((selector) => elementMatches(el, selector))) {
 				if (!el.attribs) el.attribs = {};
-				for (const [attrName, attrValue] of Object.entries(attributes)) if (attrName === "class" && el.attribs.class) {
-					const existingClasses = el.attribs.class.split(/\s+/).filter(Boolean);
-					const newClasses = String(attrValue).split(/\s+/).filter(Boolean);
-					const mergedClasses = [...new Set([...existingClasses, ...newClasses])];
-					if (mergedClasses.join(" ") !== el.attribs.class) el.attribs.class = mergedClasses.join(" ");
-				} else if (!(attrName in el.attribs)) el.attribs[attrName] = String(attrValue);
+				for (const [attrName, attrValue] of Object.entries(attributes)) {
+					if (attrValue === false) continue;
+					if (attrName === "class" && el.attribs.class) {
+						const existingClasses = el.attribs.class.split(/\s+/).filter(Boolean);
+						const newClasses = String(attrValue).split(/\s+/).filter(Boolean);
+						const mergedClasses = [...new Set([...existingClasses, ...newClasses])];
+						if (mergedClasses.join(" ") !== el.attribs.class) el.attribs.class = mergedClasses.join(" ");
+					} else if (!(attrName in el.attribs)) el.attribs[attrName] = String(attrValue);
+				}
 			}
 		});
 	}
@@ -95,7 +98,7 @@ function elementMatches(el, selector) {
 	}
 	return el.name === selector;
 }
-
 //#endregion
 export { addAttributes };
-//# sourceMappingURL=addAttributes.mjs.map
+
+//# sourceMappingURL=addAttributes.js.map

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

@@ -0,0 +1,38 @@
+import { ChildNode } from "domhandler";
+
+//#region src/transformers/attributeToStyle.d.ts
+/**
+ * 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'])
+ */
+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 attributeToStyleDom(dom: ChildNode[], attributes?: boolean | string[]): ChildNode[];
+//#endregion
+export { attributeToStyle, attributeToStyleDom };
+//# sourceMappingURL=attributeToStyle.d.ts.map

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

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

@@ -0,0 +1,71 @@
+import { ChildNode } from "domhandler";
+
+//#region src/transformers/base.d.ts
+/**
+ * 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 { BaseUrlOptions, base, baseDom };
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,31 @@
+import { ChildNode } from "domhandler";
+
+//#region src/transformers/columnWidth.d.ts
+/**
+ * Resolve `__MAIZZLE_COLW_{id}__` and `__MAIZZLE_OH_{id}__` placeholders.
+ *
+ * COLW (column width) — emitted by `<Column>` and `<Overlap>`. Walks up to
+ * the nearest ancestor marked `data-maizzle-cw` (Container, Section,
+ * Row, or another Column already resolved) and divides the source
+ * width by `data-maizzle-cw-count`. With `data-maizzle-cw-self`,
+ * reads from the element's own inlined max/width/min-width
+ * instead — used by `<Overlap>` with its own width class.
+ *
+ * OH (overlap height) — emitted by `<Overlap>`. Reads max-height, height,
+ * or min-height from the element's own inlined style.
+ *
+ * Resolution rules:
+ * - Style placeholders for `min-width`: replaced when resolvable, otherwise
+ *   the entire `min-width` declaration is stripped.
+ * - Other style placeholders (Overlap td `width`, etc.): replaced when
+ *   resolvable, otherwise replaced with the count-based fallback or `100%`.
+ * - Comment placeholders: same fallback chain.
+ *
+ * Resolved column widths are written back to `data-maizzle-cw` so nested
+ * rows cascade. All `data-maizzle-cw*` and `data-maizzle-oh-*` are
+ * stripped at the end of the second walk pass.
+ */
+declare function columnWidth(dom: ChildNode[]): ChildNode[];
+//#endregion
+export { columnWidth };
+//# sourceMappingURL=columnWidth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"columnWidth.d.ts","names":[],"sources":["../../src/transformers/columnWidth.ts"],"mappings":";;;;;AAwTA;;;;;;;;;;;;;;;;;;;;;;iBAAgB,WAAA,CAAY,GAAA,EAAK,SAAA,KAAc,SAAA"}