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

package/dist/transformers/sixHex.js

@@ -1,19 +1,31 @@
+import { parse } from "../utils/ast/parser.js";
 import { walk } from "../utils/ast/walker.js";
+import { serialize } from "../utils/ast/serializer.js";
 import "../utils/ast/index.js";
 import { conv } from "color-shorthand-hex-to-six-digit";
-
 //#region src/transformers/sixHex.ts
 const targets = new Set(["bgcolor", "color"]);
 /**
-* Six-digit HEX transformer.
-*
-* Converts 3-digit HEX color codes to 6-digit in `bgcolor` and `color`
+* Convert 3-digit HEX color codes to 6-digit in `bgcolor` and `color`
 * attributes, for better email client compatibility.
 *
-* Enabled by default via `css.sixHex`.
+* @param html HTML string to transform.
+* @returns    The transformed HTML string.
+*
+* @example
+* import { sixHex } from '@maizzle/framework'
+*
+* const out = sixHex('<font color="#abc">x</font>')
 */
-function sixHex(dom, config = {}) {
-	if (config.sixHex === false) return dom;
+function sixHex(html) {
+	return serialize(sixHexDom(parse(html)));
+}
+/**
+* DOM-form of {@link sixHex} used by the internal transformer pipeline.
+* Takes a parsed DOM, returns a parsed DOM — avoids redundant
+* serialize/parse round-trips when chained with other transformers.
+*/
+function sixHexDom(dom) {
 	walk(dom, (node) => {
 		const el = node;
 		if (!el.attribs) return;
@@ -24,7 +36,7 @@ function sixHex(dom, config = {}) {
 	});
 	return dom;
 }
-
 //#endregion
-export { sixHex };
+export { sixHex, sixHexDom };
+
 //# sourceMappingURL=sixHex.js.map

package/dist/transformers/sixHex.js.map

@@ -1 +1 @@
-{"version":3,"file":"sixHex.js","names":[],"sources":["../../src/transformers/sixHex.ts"],"sourcesContent":["import { conv } from 'color-shorthand-hex-to-six-digit'\nimport type { ChildNode, Element } from 'domhandler'\nimport { walk } from '../utils/ast/index.ts'\nimport type { CssConfig } from '../types/config.ts'\n\nconst targets = new Set(['bgcolor', 'color'])\n\n/**\n * Six-digit HEX transformer.\n *\n * Converts 3-digit HEX color codes to 6-digit in `bgcolor` and `color`\n * attributes, for better email client compatibility.\n *\n * Enabled by default via `css.sixHex`.\n */\nexport function sixHex(dom: ChildNode[], config: CssConfig = {}): ChildNode[] {\n  if (config.sixHex === false) {\n    return dom\n  }\n\n  walk(dom, (node) => {\n    const el = node as Element\n\n    if (!el.attribs) {\n      return\n    }\n\n    for (const attr of targets) {\n      const value = el.attribs[attr]\n\n      if (value) {\n        el.attribs[attr] = conv(value)\n      }\n    }\n  })\n\n  return dom\n}\n"],"mappings":";;;;;AAKA,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,QAAQ,CAAC;;;;;;;;;AAU7C,SAAgB,OAAO,KAAkB,SAAoB,EAAE,EAAe;AAC5E,KAAI,OAAO,WAAW,MACpB,QAAO;AAGT,MAAK,MAAM,SAAS;EAClB,MAAM,KAAK;AAEX,MAAI,CAAC,GAAG,QACN;AAGF,OAAK,MAAM,QAAQ,SAAS;GAC1B,MAAM,QAAQ,GAAG,QAAQ;AAEzB,OAAI,MACF,IAAG,QAAQ,QAAQ,KAAK,MAAM;;GAGlC;AAEF,QAAO"}
+{"version":3,"file":"sixHex.js","names":[],"sources":["../../src/transformers/sixHex.ts"],"sourcesContent":["import { conv } from 'color-shorthand-hex-to-six-digit'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\nconst targets = new Set(['bgcolor', 'color'])\n\n/**\n * Convert 3-digit HEX color codes to 6-digit in `bgcolor` and `color`\n * attributes, for better email client compatibility.\n *\n * @param html HTML string to transform.\n * @returns    The transformed HTML string.\n *\n * @example\n * import { sixHex } from '@maizzle/framework'\n *\n * const out = sixHex('<font color=\"#abc\">x</font>')\n */\nexport function sixHex(html: string): string {\n  return serialize(sixHexDom(parse(html)))\n}\n\n/**\n * DOM-form of {@link sixHex} used by the internal transformer pipeline.\n * Takes a parsed DOM, returns a parsed DOM — avoids redundant\n * serialize/parse round-trips when chained with other transformers.\n */\nexport function sixHexDom(dom: ChildNode[]): ChildNode[] {\n  walk(dom, (node) => {\n    const el = node as Element\n\n    if (!el.attribs) {\n      return\n    }\n\n    for (const attr of targets) {\n      const value = el.attribs[attr]\n\n      if (value) {\n        el.attribs[attr] = conv(value)\n      }\n    }\n  })\n\n  return dom\n}\n"],"mappings":";;;;;;AAIA,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,QAAQ,CAAC;;;;;;;;;;;;;AAc7C,SAAgB,OAAO,MAAsB;CAC3C,OAAO,UAAU,UAAU,MAAM,KAAK,CAAC,CAAC;;;;;;;AAQ1C,SAAgB,UAAU,KAA+B;CACvD,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EAEX,IAAI,CAAC,GAAG,SACN;EAGF,KAAK,MAAM,QAAQ,SAAS;GAC1B,MAAM,QAAQ,GAAG,QAAQ;GAEzB,IAAI,OACF,GAAG,QAAQ,QAAQ,KAAK,MAAM;;GAGlC;CAEF,OAAO"}

package/dist/transformers/tailwindComponent.js

@@ -2,7 +2,6 @@ import { walk } from "../utils/ast/walker.js";
 import "../utils/ast/index.js";
 import { compileTailwindCss } from "../utils/compileTailwindCss.js";
 import { resolve } from "node:path";
-
 //#region src/transformers/tailwindComponent.ts
 const DEFAULT_SEED = "@import \"@maizzle/tailwindcss\";";
 const OPEN_RE = /^mz-tw:(\S+)$/;
@@ -87,7 +86,7 @@ function buildCssInput(configCss, classes) {
 	if (!classes.size) return seed;
 	return `${seed}\n@source inline("${[...classes].join(" ").replace(/"/g, "\\\"")}");`;
 }
-
 //#endregion
 export { tailwindComponent };
+
 //# sourceMappingURL=tailwindComponent.js.map

package/dist/transformers/tailwindComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"tailwindComponent.js","names":[],"sources":["../../src/transformers/tailwindComponent.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { ChildNode, Element, Comment } from 'domhandler'\nimport { walk } from '../utils/ast/index.ts'\nimport { compileTailwindCss } from '../utils/compileTailwindCss.ts'\nimport type { TailwindBlock } from '../composables/renderContext.ts'\nimport type { MaizzleConfig } from '../types/config.ts'\n\nconst DEFAULT_SEED = '@import \"@maizzle/tailwindcss\";'\n\ninterface BlockMeta {\n  id: string\n  configCss?: string\n  nested: boolean\n  classes: Set<string>\n}\n\nconst OPEN_RE = /^mz-tw:(\\S+)$/\nconst CLOSE_RE = /^\\/mz-tw:(\\S+)$/\n\n/**\n * Compile Tailwind CSS for each top-level <Tailwind> block in the render\n * context. Nested <Tailwind> instances are flattened: their classes flow\n * up to the outermost block, their `#config` slot (if any) is ignored.\n * One <style> per outermost block is appended to <head>; marker comments\n * are stripped after.\n */\nexport async function tailwindComponent(\n  dom: ChildNode[],\n  blocks: TailwindBlock[],\n  config: MaizzleConfig,\n  filePath?: string,\n): Promise<ChildNode[]> {\n  if (!blocks.length) return dom\n\n  const map = new Map<string, BlockMeta>()\n  for (const b of blocks) {\n    map.set(b.id, { id: b.id, configCss: b.css, nested: false, classes: new Set() })\n  }\n\n  const stack: string[] = []\n  const markers: Comment[] = []\n\n  walk(dom, (node) => {\n    if (node.type === 'comment') {\n      const data = (node as Comment).data\n      const open = data.match(OPEN_RE)\n      const close = data.match(CLOSE_RE)\n      if (open) {\n        const id = open[1]\n        const meta = map.get(id)\n        if (meta && stack.length > 0) meta.nested = true\n        if (meta) stack.push(id)\n        markers.push(node as Comment)\n      } else if (close) {\n        const id = close[1]\n        if (stack[stack.length - 1] === id) stack.pop()\n        markers.push(node as Comment)\n      }\n      return\n    }\n\n    const el = node as Element\n    // Always assign to the OUTERMOST active marker (stack[0]) so nested\n    // <Tailwind> blocks merge their classes into the parent's scope.\n    if (el.attribs?.class && stack.length > 0) {\n      map.get(stack[0])!.classes.add(el.attribs.class)\n    }\n  })\n\n  const fromPath = filePath ?? resolve(process.cwd(), 'template.vue')\n\n  let head: Element | undefined\n  walk(dom, (n) => {\n    if (!head && (n as Element).name === 'head') head = n as Element\n  })\n\n  if (!head) {\n    throw new Error('`Tailwind` component requires `Head` component to be present in the template.')\n  }\n\n  // Compile + inject one <style raw> per outermost block. `raw` opts the\n  // existing tailwindcss transformer out of recompiling already-compiled CSS.\n  for (const meta of map.values()) {\n    if (meta.nested) continue\n\n    const cssInput = buildCssInput(meta.configCss, meta.classes)\n    const css = (await compileTailwindCss(cssInput, config, `${fromPath}?tw=${meta.id}`)).trim()\n    if (!css) continue\n\n    const styleNode: Element = {\n      type: 'tag',\n      name: 'style',\n      attribs: { raw: '' },\n      children: [],\n      parent: head,\n      prev: null,\n      next: null,\n    } as any\n\n    const textNode = {\n      type: 'text',\n      data: css,\n      parent: styleNode,\n      prev: null,\n      next: null,\n    } as any\n\n    styleNode.children = [textNode]\n    head.children.push(styleNode)\n  }\n\n  // Strip marker comments from their parents\n  for (const c of markers) {\n    const parent = c.parent as Element | null\n    if (!parent?.children) continue\n    const i = parent.children.indexOf(c)\n    if (i >= 0) parent.children.splice(i, 1)\n  }\n\n  return dom\n}\n\nfunction buildCssInput(configCss: string | undefined, classes: Set<string>): string {\n  const seed = configCss ?? DEFAULT_SEED\n\n  if (!classes.size) return seed\n\n  const inline = [...classes].join(' ').replace(/\"/g, '\\\\\"')\n  return `${seed}\\n@source inline(\"${inline}\");`\n}\n"],"mappings":";;;;;;AAOA,MAAM,eAAe;AASrB,MAAM,UAAU;AAChB,MAAM,WAAW;;;;;;;;AASjB,eAAsB,kBACpB,KACA,QACA,QACA,UACsB;AACtB,KAAI,CAAC,OAAO,OAAQ,QAAO;CAE3B,MAAM,sBAAM,IAAI,KAAwB;AACxC,MAAK,MAAM,KAAK,OACd,KAAI,IAAI,EAAE,IAAI;EAAE,IAAI,EAAE;EAAI,WAAW,EAAE;EAAK,QAAQ;EAAO,yBAAS,IAAI,KAAK;EAAE,CAAC;CAGlF,MAAM,QAAkB,EAAE;CAC1B,MAAM,UAAqB,EAAE;AAE7B,MAAK,MAAM,SAAS;AAClB,MAAI,KAAK,SAAS,WAAW;GAC3B,MAAM,OAAQ,KAAiB;GAC/B,MAAM,OAAO,KAAK,MAAM,QAAQ;GAChC,MAAM,QAAQ,KAAK,MAAM,SAAS;AAClC,OAAI,MAAM;IACR,MAAM,KAAK,KAAK;IAChB,MAAM,OAAO,IAAI,IAAI,GAAG;AACxB,QAAI,QAAQ,MAAM,SAAS,EAAG,MAAK,SAAS;AAC5C,QAAI,KAAM,OAAM,KAAK,GAAG;AACxB,YAAQ,KAAK,KAAgB;cACpB,OAAO;IAChB,MAAM,KAAK,MAAM;AACjB,QAAI,MAAM,MAAM,SAAS,OAAO,GAAI,OAAM,KAAK;AAC/C,YAAQ,KAAK,KAAgB;;AAE/B;;EAGF,MAAM,KAAK;AAGX,MAAI,GAAG,SAAS,SAAS,MAAM,SAAS,EACtC,KAAI,IAAI,MAAM,GAAG,CAAE,QAAQ,IAAI,GAAG,QAAQ,MAAM;GAElD;CAEF,MAAM,WAAW,YAAY,QAAQ,QAAQ,KAAK,EAAE,eAAe;CAEnE,IAAI;AACJ,MAAK,MAAM,MAAM;AACf,MAAI,CAAC,QAAS,EAAc,SAAS,OAAQ,QAAO;GACpD;AAEF,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,gFAAgF;AAKlG,MAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE;AAC/B,MAAI,KAAK,OAAQ;EAGjB,MAAM,OAAO,MAAM,mBADF,cAAc,KAAK,WAAW,KAAK,QAAQ,EACZ,QAAQ,GAAG,SAAS,MAAM,KAAK,KAAK,EAAE,MAAM;AAC5F,MAAI,CAAC,IAAK;EAEV,MAAM,YAAqB;GACzB,MAAM;GACN,MAAM;GACN,SAAS,EAAE,KAAK,IAAI;GACpB,UAAU,EAAE;GACZ,QAAQ;GACR,MAAM;GACN,MAAM;GACP;AAUD,YAAU,WAAW,CARJ;GACf,MAAM;GACN,MAAM;GACN,QAAQ;GACR,MAAM;GACN,MAAM;GACP,CAE8B;AAC/B,OAAK,SAAS,KAAK,UAAU;;AAI/B,MAAK,MAAM,KAAK,SAAS;EACvB,MAAM,SAAS,EAAE;AACjB,MAAI,CAAC,QAAQ,SAAU;EACvB,MAAM,IAAI,OAAO,SAAS,QAAQ,EAAE;AACpC,MAAI,KAAK,EAAG,QAAO,SAAS,OAAO,GAAG,EAAE;;AAG1C,QAAO;;AAGT,SAAS,cAAc,WAA+B,SAA8B;CAClF,MAAM,OAAO,aAAa;AAE1B,KAAI,CAAC,QAAQ,KAAM,QAAO;AAG1B,QAAO,GAAG,KAAK,oBADA,CAAC,GAAG,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,MAAM,OAAM,CAChB"}
+{"version":3,"file":"tailwindComponent.js","names":[],"sources":["../../src/transformers/tailwindComponent.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { ChildNode, Element, Comment } from 'domhandler'\nimport { walk } from '../utils/ast/index.ts'\nimport { compileTailwindCss } from '../utils/compileTailwindCss.ts'\nimport type { TailwindBlock } from '../composables/renderContext.ts'\nimport type { MaizzleConfig } from '../types/config.ts'\n\nconst DEFAULT_SEED = '@import \"@maizzle/tailwindcss\";'\n\ninterface BlockMeta {\n  id: string\n  configCss?: string\n  nested: boolean\n  classes: Set<string>\n}\n\nconst OPEN_RE = /^mz-tw:(\\S+)$/\nconst CLOSE_RE = /^\\/mz-tw:(\\S+)$/\n\n/**\n * Compile Tailwind CSS for each top-level <Tailwind> block in the render\n * context. Nested <Tailwind> instances are flattened: their classes flow\n * up to the outermost block, their `#config` slot (if any) is ignored.\n * One <style> per outermost block is appended to <head>; marker comments\n * are stripped after.\n */\nexport async function tailwindComponent(\n  dom: ChildNode[],\n  blocks: TailwindBlock[],\n  config: MaizzleConfig,\n  filePath?: string,\n): Promise<ChildNode[]> {\n  if (!blocks.length) return dom\n\n  const map = new Map<string, BlockMeta>()\n  for (const b of blocks) {\n    map.set(b.id, { id: b.id, configCss: b.css, nested: false, classes: new Set() })\n  }\n\n  const stack: string[] = []\n  const markers: Comment[] = []\n\n  walk(dom, (node) => {\n    if (node.type === 'comment') {\n      const data = (node as Comment).data\n      const open = data.match(OPEN_RE)\n      const close = data.match(CLOSE_RE)\n      if (open) {\n        const id = open[1]\n        const meta = map.get(id)\n        if (meta && stack.length > 0) meta.nested = true\n        if (meta) stack.push(id)\n        markers.push(node as Comment)\n      } else if (close) {\n        const id = close[1]\n        if (stack[stack.length - 1] === id) stack.pop()\n        markers.push(node as Comment)\n      }\n      return\n    }\n\n    const el = node as Element\n    // Always assign to the OUTERMOST active marker (stack[0]) so nested\n    // <Tailwind> blocks merge their classes into the parent's scope.\n    if (el.attribs?.class && stack.length > 0) {\n      map.get(stack[0])!.classes.add(el.attribs.class)\n    }\n  })\n\n  const fromPath = filePath ?? resolve(process.cwd(), 'template.vue')\n\n  let head: Element | undefined\n  walk(dom, (n) => {\n    if (!head && (n as Element).name === 'head') head = n as Element\n  })\n\n  if (!head) {\n    throw new Error('`Tailwind` component requires `Head` component to be present in the template.')\n  }\n\n  // Compile + inject one <style raw> per outermost block. `raw` opts the\n  // existing tailwindcss transformer out of recompiling already-compiled CSS.\n  for (const meta of map.values()) {\n    if (meta.nested) continue\n\n    const cssInput = buildCssInput(meta.configCss, meta.classes)\n    const css = (await compileTailwindCss(cssInput, config, `${fromPath}?tw=${meta.id}`)).trim()\n    if (!css) continue\n\n    const styleNode: Element = {\n      type: 'tag',\n      name: 'style',\n      attribs: { raw: '' },\n      children: [],\n      parent: head,\n      prev: null,\n      next: null,\n    } as any\n\n    const textNode = {\n      type: 'text',\n      data: css,\n      parent: styleNode,\n      prev: null,\n      next: null,\n    } as any\n\n    styleNode.children = [textNode]\n    head.children.push(styleNode)\n  }\n\n  // Strip marker comments from their parents\n  for (const c of markers) {\n    const parent = c.parent as Element | null\n    if (!parent?.children) continue\n    const i = parent.children.indexOf(c)\n    if (i >= 0) parent.children.splice(i, 1)\n  }\n\n  return dom\n}\n\nfunction buildCssInput(configCss: string | undefined, classes: Set<string>): string {\n  const seed = configCss ?? DEFAULT_SEED\n\n  if (!classes.size) return seed\n\n  const inline = [...classes].join(' ').replace(/\"/g, '\\\\\"')\n  return `${seed}\\n@source inline(\"${inline}\");`\n}\n"],"mappings":";;;;;AAOA,MAAM,eAAe;AASrB,MAAM,UAAU;AAChB,MAAM,WAAW;;;;;;;;AASjB,eAAsB,kBACpB,KACA,QACA,QACA,UACsB;CACtB,IAAI,CAAC,OAAO,QAAQ,OAAO;CAE3B,MAAM,sBAAM,IAAI,KAAwB;CACxC,KAAK,MAAM,KAAK,QACd,IAAI,IAAI,EAAE,IAAI;EAAE,IAAI,EAAE;EAAI,WAAW,EAAE;EAAK,QAAQ;EAAO,yBAAS,IAAI,KAAK;EAAE,CAAC;CAGlF,MAAM,QAAkB,EAAE;CAC1B,MAAM,UAAqB,EAAE;CAE7B,KAAK,MAAM,SAAS;EAClB,IAAI,KAAK,SAAS,WAAW;GAC3B,MAAM,OAAQ,KAAiB;GAC/B,MAAM,OAAO,KAAK,MAAM,QAAQ;GAChC,MAAM,QAAQ,KAAK,MAAM,SAAS;GAClC,IAAI,MAAM;IACR,MAAM,KAAK,KAAK;IAChB,MAAM,OAAO,IAAI,IAAI,GAAG;IACxB,IAAI,QAAQ,MAAM,SAAS,GAAG,KAAK,SAAS;IAC5C,IAAI,MAAM,MAAM,KAAK,GAAG;IACxB,QAAQ,KAAK,KAAgB;UACxB,IAAI,OAAO;IAChB,MAAM,KAAK,MAAM;IACjB,IAAI,MAAM,MAAM,SAAS,OAAO,IAAI,MAAM,KAAK;IAC/C,QAAQ,KAAK,KAAgB;;GAE/B;;EAGF,MAAM,KAAK;EAGX,IAAI,GAAG,SAAS,SAAS,MAAM,SAAS,GACtC,IAAI,IAAI,MAAM,GAAG,CAAE,QAAQ,IAAI,GAAG,QAAQ,MAAM;GAElD;CAEF,MAAM,WAAW,YAAY,QAAQ,QAAQ,KAAK,EAAE,eAAe;CAEnE,IAAI;CACJ,KAAK,MAAM,MAAM;EACf,IAAI,CAAC,QAAS,EAAc,SAAS,QAAQ,OAAO;GACpD;CAEF,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,gFAAgF;CAKlG,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE;EAC/B,IAAI,KAAK,QAAQ;EAGjB,MAAM,OAAO,MAAM,mBADF,cAAc,KAAK,WAAW,KAAK,QACN,EAAE,QAAQ,GAAG,SAAS,MAAM,KAAK,KAAK,EAAE,MAAM;EAC5F,IAAI,CAAC,KAAK;EAEV,MAAM,YAAqB;GACzB,MAAM;GACN,MAAM;GACN,SAAS,EAAE,KAAK,IAAI;GACpB,UAAU,EAAE;GACZ,QAAQ;GACR,MAAM;GACN,MAAM;GACP;EAUD,UAAU,WAAW,CAAC;GAPpB,MAAM;GACN,MAAM;GACN,QAAQ;GACR,MAAM;GACN,MAAM;GAGsB,CAAC;EAC/B,KAAK,SAAS,KAAK,UAAU;;CAI/B,KAAK,MAAM,KAAK,SAAS;EACvB,MAAM,SAAS,EAAE;EACjB,IAAI,CAAC,QAAQ,UAAU;EACvB,MAAM,IAAI,OAAO,SAAS,QAAQ,EAAE;EACpC,IAAI,KAAK,GAAG,OAAO,SAAS,OAAO,GAAG,EAAE;;CAG1C,OAAO;;AAGT,SAAS,cAAc,WAA+B,SAA8B;CAClF,MAAM,OAAO,aAAa;CAE1B,IAAI,CAAC,QAAQ,MAAM,OAAO;CAG1B,OAAO,GAAG,KAAK,oBADA,CAAC,GAAG,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,MAAM,OACX,CAAC"}

package/dist/transformers/tailwindcss.js

@@ -3,7 +3,6 @@ import "../utils/ast/index.js";
 import { compileTailwindCss } from "../utils/compileTailwindCss.js";
 import { decodeStyleEntities } from "../utils/decodeStyleEntities.js";
 import { dirname, relative, resolve } from "node:path";
-
 //#region src/transformers/tailwindcss.ts
 /**
 * Check if CSS content uses Tailwind features that require source scanning.
@@ -92,7 +91,7 @@ async function tailwindcss(dom, config, filePath) {
 	}
 	return dom;
 }
-
 //#endregion
 export { tailwindcss };
+
 //# sourceMappingURL=tailwindcss.js.map

package/dist/transformers/tailwindcss.js.map

@@ -1 +1 @@
-{"version":3,"file":"tailwindcss.js","names":[],"sources":["../../src/transformers/tailwindcss.ts"],"sourcesContent":["import { resolve, dirname, relative } from 'node:path'\nimport type { ChildNode, Element } from 'domhandler'\nimport { walk } from '../utils/ast/index.ts'\nimport { decodeStyleEntities } from '../utils/decodeStyleEntities.ts'\nimport { compileTailwindCss } from '../utils/compileTailwindCss.ts'\nimport type { MaizzleConfig } from '../types/config.ts'\n\n/**\n * Check if CSS content uses Tailwind features that require source scanning.\n *\n * Only CSS that imports Tailwind (or @maizzle/tailwindcss) needs @source\n * directives. Plain CSS without Tailwind imports doesn't need scanning\n * and would pass through @source directives unconsumed.\n */\nfunction usesTailwind(css: string): boolean {\n  return /((@import|@reference)\\s+[\"'](tailwindcss|@maizzle\\/tailwindcss)|@tailwind\\s)/.test(css)\n}\n\n/**\n * Build @source directives for Tailwind CSS scanning.\n *\n * Configures two types of sources:\n * 1. Exclusions for output dir and user-configured paths\n * 2. Inline source with all class attribute values from the rendered DOM,\n *    capturing classes from all components (built-in + user), dynamic\n *    expressions, and the template itself — Tailwind's scanner handles\n *    the actual class extraction from these raw values\n */\nfunction buildSourceDirectives(dom: ChildNode[], config: MaizzleConfig, fromDir: string): string {\n  const directives: string[] = []\n\n  // Exclude output dir and user-configured paths\n  const excludePaths = [\n    resolve(config.output?.path ?? 'dist'),\n    ...(config.css?.exclude ?? []).map(p => resolve(p)),\n  ]\n\n  for (const p of excludePaths) {\n    directives.push(`@source not \"${relative(fromDir, resolve(p))}\";`)\n  }\n\n  // Inline source: collect all class attribute values from the rendered DOM.\n  // After Vue SSR, the DOM contains every class from every component\n  // (built-in framework components, user components, dynamic bindings).\n  // We pass these raw values to Tailwind's scanner via @source inline().\n  const classes: string[] = []\n  walk(dom, (n) => {\n    const cls = (n as Element).attribs?.class\n    if (cls) classes.push(cls)\n  })\n\n  if (classes.length) {\n    directives.push(`@source inline(\"${classes.join(' ')}\");`)\n  }\n\n  return directives.join('\\n')\n}\n\n/**\n * Tailwind CSS transformer.\n *\n * Compiles CSS inside <style> tags in the DOM using\n * @tailwindcss/postcss, then lowers modern CSS syntax with lightningcss.\n *\n * Configures Tailwind sources to scan:\n * - Rendered class attributes (via `@source inline`) for all classes from all components\n * - User project files (via Tailwind's auto-detection from base/from path)\n *\n * User `@source` and `@source not directives` in style tags are preserved.\n * Source directives are only added to style tags that import Tailwind.\n *\n * Runs as the first transformer in the pipeline so that subsequent\n * transformers (inliner, purge, etc.) work with fully compiled CSS.\n */\nexport async function tailwindcss(dom: ChildNode[], config: MaizzleConfig, filePath?: string): Promise<ChildNode[]> {\n  const styleTags: { node: Element; cssContent: string }[] = []\n\n  walk(dom, (node) => {\n    if ((node as Element).name !== 'style') return\n\n    const el = node as Element\n    const attrs = el.attribs || {}\n\n    // `raw` opts out of compilation entirely (marker is consumed here).\n    // `embed`/`data-embed` only signal \"preserve tag after inlining\" — they\n    // still need to go through compile so Tailwind/@apply resolves.\n    if ('raw' in attrs) {\n      delete el.attribs.raw\n      return\n    }\n\n    // Get text content from children and decode HTML entities\n    const rawContent = el.children\n      .filter(child => child.type === 'text')\n      .map(child => (child as any).data)\n      .join('')\n\n    if (!rawContent.trim()) return\n\n    styleTags.push({ node: el, cssContent: decodeStyleEntities(rawContent) })\n  })\n\n  if (!styleTags.length) return dom\n\n  const fromPath = filePath ?? resolve(process.cwd(), 'template.vue')\n  const fromDir = dirname(fromPath)\n\n  // Only compute source directives if at least one style tag uses Tailwind\n  const hasTailwindStyles = styleTags.some(({ cssContent }) => usesTailwind(cssContent))\n  const sourceDirectives = hasTailwindStyles\n    ? buildSourceDirectives(dom, config, fromDir)\n    : ''\n\n  for (let i = 0; i < styleTags.length; i++) {\n    const { node, cssContent } = styleTags[i]\n\n    // Only add source directives to style tags that import Tailwind —\n    // plain CSS doesn't need them and @tailwindcss/postcss would leave\n    // the directives unconsumed in the output\n    const fullCss = usesTailwind(cssContent)\n      ? `${cssContent}\\n${sourceDirectives}`\n      : cssContent\n\n    try {\n      const optimized = await compileTailwindCss(fullCss, config, `${fromPath}?style=${i}`)\n\n      // Replace the style tag's children with the compiled CSS\n      node.children = [{\n        type: 'text',\n        data: optimized,\n        parent: node,\n      } as any]\n    } catch {\n      // If CSS processing fails, still replace with decoded content\n      // so HTML entities don't break the CSS\n      node.children = [{\n        type: 'text',\n        data: cssContent,\n        parent: node,\n      } as any]\n    }\n  }\n\n  return dom\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAS,aAAa,KAAsB;AAC1C,QAAO,+EAA+E,KAAK,IAAI;;;;;;;;;;;;AAajG,SAAS,sBAAsB,KAAkB,QAAuB,SAAyB;CAC/F,MAAM,aAAuB,EAAE;CAG/B,MAAM,eAAe,CACnB,QAAQ,OAAO,QAAQ,QAAQ,OAAO,EACtC,IAAI,OAAO,KAAK,WAAW,EAAE,EAAE,KAAI,MAAK,QAAQ,EAAE,CAAC,CACpD;AAED,MAAK,MAAM,KAAK,aACd,YAAW,KAAK,gBAAgB,SAAS,SAAS,QAAQ,EAAE,CAAC,CAAC,IAAI;CAOpE,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,MAAM;EACf,MAAM,MAAO,EAAc,SAAS;AACpC,MAAI,IAAK,SAAQ,KAAK,IAAI;GAC1B;AAEF,KAAI,QAAQ,OACV,YAAW,KAAK,mBAAmB,QAAQ,KAAK,IAAI,CAAC,KAAK;AAG5D,QAAO,WAAW,KAAK,KAAK;;;;;;;;;;;;;;;;;;AAmB9B,eAAsB,YAAY,KAAkB,QAAuB,UAAyC;CAClH,MAAM,YAAqD,EAAE;AAE7D,MAAK,MAAM,SAAS;AAClB,MAAK,KAAiB,SAAS,QAAS;EAExC,MAAM,KAAK;AAMX,MAAI,UALU,GAAG,WAAW,EAAE,GAKV;AAClB,UAAO,GAAG,QAAQ;AAClB;;EAIF,MAAM,aAAa,GAAG,SACnB,QAAO,UAAS,MAAM,SAAS,OAAO,CACtC,KAAI,UAAU,MAAc,KAAK,CACjC,KAAK,GAAG;AAEX,MAAI,CAAC,WAAW,MAAM,CAAE;AAExB,YAAU,KAAK;GAAE,MAAM;GAAI,YAAY,oBAAoB,WAAW;GAAE,CAAC;GACzE;AAEF,KAAI,CAAC,UAAU,OAAQ,QAAO;CAE9B,MAAM,WAAW,YAAY,QAAQ,QAAQ,KAAK,EAAE,eAAe;CACnE,MAAM,UAAU,QAAQ,SAAS;CAIjC,MAAM,mBADoB,UAAU,MAAM,EAAE,iBAAiB,aAAa,WAAW,CAAC,GAElF,sBAAsB,KAAK,QAAQ,QAAQ,GAC3C;AAEJ,MAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,EAAE,MAAM,eAAe,UAAU;EAKvC,MAAM,UAAU,aAAa,WAAW,GACpC,GAAG,WAAW,IAAI,qBAClB;AAEJ,MAAI;AAIF,QAAK,WAAW,CAAC;IACf,MAAM;IACN,MALgB,MAAM,mBAAmB,SAAS,QAAQ,GAAG,SAAS,SAAS,IAAI;IAMnF,QAAQ;IACT,CAAQ;UACH;AAGN,QAAK,WAAW,CAAC;IACf,MAAM;IACN,MAAM;IACN,QAAQ;IACT,CAAQ;;;AAIb,QAAO"}
+{"version":3,"file":"tailwindcss.js","names":[],"sources":["../../src/transformers/tailwindcss.ts"],"sourcesContent":["import { resolve, dirname, relative } from 'node:path'\nimport type { ChildNode, Element } from 'domhandler'\nimport { walk } from '../utils/ast/index.ts'\nimport { decodeStyleEntities } from '../utils/decodeStyleEntities.ts'\nimport { compileTailwindCss } from '../utils/compileTailwindCss.ts'\nimport type { MaizzleConfig } from '../types/config.ts'\n\n/**\n * Check if CSS content uses Tailwind features that require source scanning.\n *\n * Only CSS that imports Tailwind (or @maizzle/tailwindcss) needs @source\n * directives. Plain CSS without Tailwind imports doesn't need scanning\n * and would pass through @source directives unconsumed.\n */\nfunction usesTailwind(css: string): boolean {\n  return /((@import|@reference)\\s+[\"'](tailwindcss|@maizzle\\/tailwindcss)|@tailwind\\s)/.test(css)\n}\n\n/**\n * Build @source directives for Tailwind CSS scanning.\n *\n * Configures two types of sources:\n * 1. Exclusions for output dir and user-configured paths\n * 2. Inline source with all class attribute values from the rendered DOM,\n *    capturing classes from all components (built-in + user), dynamic\n *    expressions, and the template itself — Tailwind's scanner handles\n *    the actual class extraction from these raw values\n */\nfunction buildSourceDirectives(dom: ChildNode[], config: MaizzleConfig, fromDir: string): string {\n  const directives: string[] = []\n\n  // Exclude output dir and user-configured paths\n  const excludePaths = [\n    resolve(config.output?.path ?? 'dist'),\n    ...(config.css?.exclude ?? []).map(p => resolve(p)),\n  ]\n\n  for (const p of excludePaths) {\n    directives.push(`@source not \"${relative(fromDir, resolve(p))}\";`)\n  }\n\n  // Inline source: collect all class attribute values from the rendered DOM.\n  // After Vue SSR, the DOM contains every class from every component\n  // (built-in framework components, user components, dynamic bindings).\n  // We pass these raw values to Tailwind's scanner via @source inline().\n  const classes: string[] = []\n  walk(dom, (n) => {\n    const cls = (n as Element).attribs?.class\n    if (cls) classes.push(cls)\n  })\n\n  if (classes.length) {\n    directives.push(`@source inline(\"${classes.join(' ')}\");`)\n  }\n\n  return directives.join('\\n')\n}\n\n/**\n * Tailwind CSS transformer.\n *\n * Compiles CSS inside <style> tags in the DOM using\n * @tailwindcss/postcss, then lowers modern CSS syntax with lightningcss.\n *\n * Configures Tailwind sources to scan:\n * - Rendered class attributes (via `@source inline`) for all classes from all components\n * - User project files (via Tailwind's auto-detection from base/from path)\n *\n * User `@source` and `@source not directives` in style tags are preserved.\n * Source directives are only added to style tags that import Tailwind.\n *\n * Runs as the first transformer in the pipeline so that subsequent\n * transformers (inliner, purge, etc.) work with fully compiled CSS.\n */\nexport async function tailwindcss(dom: ChildNode[], config: MaizzleConfig, filePath?: string): Promise<ChildNode[]> {\n  const styleTags: { node: Element; cssContent: string }[] = []\n\n  walk(dom, (node) => {\n    if ((node as Element).name !== 'style') return\n\n    const el = node as Element\n    const attrs = el.attribs || {}\n\n    // `raw` opts out of compilation entirely (marker is consumed here).\n    // `embed`/`data-embed` only signal \"preserve tag after inlining\" — they\n    // still need to go through compile so Tailwind/@apply resolves.\n    if ('raw' in attrs) {\n      delete el.attribs.raw\n      return\n    }\n\n    // Get text content from children and decode HTML entities\n    const rawContent = el.children\n      .filter(child => child.type === 'text')\n      .map(child => (child as any).data)\n      .join('')\n\n    if (!rawContent.trim()) return\n\n    styleTags.push({ node: el, cssContent: decodeStyleEntities(rawContent) })\n  })\n\n  if (!styleTags.length) return dom\n\n  const fromPath = filePath ?? resolve(process.cwd(), 'template.vue')\n  const fromDir = dirname(fromPath)\n\n  // Only compute source directives if at least one style tag uses Tailwind\n  const hasTailwindStyles = styleTags.some(({ cssContent }) => usesTailwind(cssContent))\n  const sourceDirectives = hasTailwindStyles\n    ? buildSourceDirectives(dom, config, fromDir)\n    : ''\n\n  for (let i = 0; i < styleTags.length; i++) {\n    const { node, cssContent } = styleTags[i]\n\n    // Only add source directives to style tags that import Tailwind —\n    // plain CSS doesn't need them and @tailwindcss/postcss would leave\n    // the directives unconsumed in the output\n    const fullCss = usesTailwind(cssContent)\n      ? `${cssContent}\\n${sourceDirectives}`\n      : cssContent\n\n    try {\n      const optimized = await compileTailwindCss(fullCss, config, `${fromPath}?style=${i}`)\n\n      // Replace the style tag's children with the compiled CSS\n      node.children = [{\n        type: 'text',\n        data: optimized,\n        parent: node,\n      } as any]\n    } catch {\n      // If CSS processing fails, still replace with decoded content\n      // so HTML entities don't break the CSS\n      node.children = [{\n        type: 'text',\n        data: cssContent,\n        parent: node,\n      } as any]\n    }\n  }\n\n  return dom\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAS,aAAa,KAAsB;CAC1C,OAAO,+EAA+E,KAAK,IAAI;;;;;;;;;;;;AAajG,SAAS,sBAAsB,KAAkB,QAAuB,SAAyB;CAC/F,MAAM,aAAuB,EAAE;CAG/B,MAAM,eAAe,CACnB,QAAQ,OAAO,QAAQ,QAAQ,OAAO,EACtC,IAAI,OAAO,KAAK,WAAW,EAAE,EAAE,KAAI,MAAK,QAAQ,EAAE,CAAC,CACpD;CAED,KAAK,MAAM,KAAK,cACd,WAAW,KAAK,gBAAgB,SAAS,SAAS,QAAQ,EAAE,CAAC,CAAC,IAAI;CAOpE,MAAM,UAAoB,EAAE;CAC5B,KAAK,MAAM,MAAM;EACf,MAAM,MAAO,EAAc,SAAS;EACpC,IAAI,KAAK,QAAQ,KAAK,IAAI;GAC1B;CAEF,IAAI,QAAQ,QACV,WAAW,KAAK,mBAAmB,QAAQ,KAAK,IAAI,CAAC,KAAK;CAG5D,OAAO,WAAW,KAAK,KAAK;;;;;;;;;;;;;;;;;;AAmB9B,eAAsB,YAAY,KAAkB,QAAuB,UAAyC;CAClH,MAAM,YAAqD,EAAE;CAE7D,KAAK,MAAM,SAAS;EAClB,IAAK,KAAiB,SAAS,SAAS;EAExC,MAAM,KAAK;EAMX,IAAI,UALU,GAAG,WAAW,EAAE,GAKV;GAClB,OAAO,GAAG,QAAQ;GAClB;;EAIF,MAAM,aAAa,GAAG,SACnB,QAAO,UAAS,MAAM,SAAS,OAAO,CACtC,KAAI,UAAU,MAAc,KAAK,CACjC,KAAK,GAAG;EAEX,IAAI,CAAC,WAAW,MAAM,EAAE;EAExB,UAAU,KAAK;GAAE,MAAM;GAAI,YAAY,oBAAoB,WAAW;GAAE,CAAC;GACzE;CAEF,IAAI,CAAC,UAAU,QAAQ,OAAO;CAE9B,MAAM,WAAW,YAAY,QAAQ,QAAQ,KAAK,EAAE,eAAe;CACnE,MAAM,UAAU,QAAQ,SAAS;CAIjC,MAAM,mBADoB,UAAU,MAAM,EAAE,iBAAiB,aAAa,WAAW,CAC3C,GACtC,sBAAsB,KAAK,QAAQ,QAAQ,GAC3C;CAEJ,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,EAAE,MAAM,eAAe,UAAU;EAKvC,MAAM,UAAU,aAAa,WAAW,GACpC,GAAG,WAAW,IAAI,qBAClB;EAEJ,IAAI;GAIF,KAAK,WAAW,CAAC;IACf,MAAM;IACN,MAAM,MALgB,mBAAmB,SAAS,QAAQ,GAAG,SAAS,SAAS,IAAI;IAMnF,QAAQ;IACT,CAAQ;UACH;GAGN,KAAK,WAAW,CAAC;IACf,MAAM;IACN,MAAM;IACN,QAAQ;IACT,CAAQ;;;CAIb,OAAO"}

package/dist/transformers/urlQuery.d.ts

@@ -1,24 +1,36 @@
-import { UrlConfig } from "../types/config.js";
+import { UrlQueryOptions } from "../types/config.js";
 import { ChildNode } from "domhandler";
 
 //#region src/transformers/urlQuery.d.ts
 /**
- * URL query transformer.
+ * Append query parameters to URLs found in matching attributes/elements.
  *
- * Appends query parameters to URLs found in specified attributes of
- * specified HTML tags.
+ * @param html    HTML string to transform.
+ * @param params  Query parameters to append (e.g. `{ utm_source: 'newsletter' }`).
+ * @param options Behaviour overrides — `tags` (CSS selectors, default `['a']`),
+ *                `attributes` (default `['src', 'href', 'poster', 'srcset', 'background']`),
+ *                `strict` (default `true`, only rewrites absolute URLs),
+ *                `qs` (forwarded to `query-string`, default `{ encode: false }`).
+ * @returns       The transformed HTML string.
  *
- * Reads config from the `config.url` object in `MaizzleConfig` (pass
- * `config.url` directly when calling as a standalone transformer).
- * The `_options` key inside `query` controls behaviour:
- * - `tags`       — CSS selectors for elements to process. Default: `['a']`
- * - `attributes` — attribute names to process. Default: `['src', 'href', 'poster', 'srcset', 'background']`
- * - `strict`     — only append to absolute URLs. Default: `true`
- * - `qs`         — options forwarded to query-string. Default: `{ encode: false }`
+ * @example
+ * import { urlQuery } from '@maizzle/framework'
  *
- * All non-`_options` keys inside `query` are treated as URL parameters to append.
+ * const out = urlQuery(
+ *   '<a href="https://example.com">x</a>',
+ *   { utm_source: 'newsletter' },
+ * )
+ *
+ * // Restrict to specific tags / attributes:
+ * urlQuery(html, { ref: 'email' }, { tags: ['a', 'img'], attributes: ['href', 'src'] })
+ */
+declare function urlQuery(html: string, params?: Record<string, unknown>, options?: UrlQueryOptions): string;
+/**
+ * DOM-form of {@link urlQuery} 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 urlQuery(dom: ChildNode[], config?: UrlConfig): ChildNode[];
+declare function urlQueryDom(dom: ChildNode[], params?: Record<string, unknown>, options?: UrlQueryOptions): ChildNode[];
 //#endregion
-export { urlQuery };
+export { urlQuery, urlQueryDom };
 //# sourceMappingURL=urlQuery.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"urlQuery.d.ts","names":[],"sources":["../../src/transformers/urlQuery.ts"],"mappings":";;;;;;AA0CA;;;;;;;;;;;;;;iBAAgB,QAAA,CAAS,GAAA,EAAK,SAAA,IAAa,MAAA,GAAQ,SAAA,GAAiB,SAAA"}
+{"version":3,"file":"urlQuery.d.ts","names":[],"sources":["../../src/transformers/urlQuery.ts"],"mappings":";;;;;;AAiDA;;;;;;;;;;;AAaA;;;;;;;;;iBAbgB,QAAA,CACd,IAAA,UACA,MAAA,GAAQ,MAAA,mBACR,OAAA,GAAS,eAAA;;;;;;iBAUK,WAAA,CACd,GAAA,EAAK,SAAA,IACL,MAAA,GAAQ,MAAA,mBACR,OAAA,GAAS,eAAA,GACR,SAAA"}

package/dist/transformers/urlQuery.js

@@ -1,7 +1,9 @@
+import { parse } from "../utils/ast/parser.js";
+import { serialize } from "../utils/ast/serializer.js";
+import "../utils/ast/index.js";
 import { isAbsoluteUrl } from "../utils/url.js";
 import queryString from "query-string";
 import { selectAll } from "css-select";
-
 //#region src/transformers/urlQuery.ts
 const DEFAULT_ATTRIBUTES = [
 	"src",
@@ -22,27 +24,37 @@ function appendParams(url, params, qsOptions, strict) {
 	}, qsOptions);
 }
 /**
-* URL query transformer.
+* Append query parameters to URLs found in matching attributes/elements.
+*
+* @param html    HTML string to transform.
+* @param params  Query parameters to append (e.g. `{ utm_source: 'newsletter' }`).
+* @param options Behaviour overrides — `tags` (CSS selectors, default `['a']`),
+*                `attributes` (default `['src', 'href', 'poster', 'srcset', 'background']`),
+*                `strict` (default `true`, only rewrites absolute URLs),
+*                `qs` (forwarded to `query-string`, default `{ encode: false }`).
+* @returns       The transformed HTML string.
 *
-* Appends query parameters to URLs found in specified attributes of
-* specified HTML tags.
+* @example
+* import { urlQuery } from '@maizzle/framework'
 *
-* Reads config from the `config.url` object in `MaizzleConfig` (pass
-* `config.url` directly when calling as a standalone transformer).
-* The `_options` key inside `query` controls behaviour:
-* - `tags`       — CSS selectors for elements to process. Default: `['a']`
-* - `attributes` — attribute names to process. Default: `['src', 'href', 'poster', 'srcset', 'background']`
-* - `strict`     — only append to absolute URLs. Default: `true`
-* - `qs`         — options forwarded to query-string. Default: `{ encode: false }`
+* const out = urlQuery(
+*   '<a href="https://example.com">x</a>',
+*   { utm_source: 'newsletter' },
+* )
 *
-* All non-`_options` keys inside `query` are treated as URL parameters to append.
+* // Restrict to specific tags / attributes:
+* urlQuery(html, { ref: 'email' }, { tags: ['a', 'img'], attributes: ['href', 'src'] })
 */
-function urlQuery(dom, config = {}) {
-	const queryConfig = config.query;
-	if (!queryConfig || Object.keys(queryConfig).length === 0) return dom;
-	const { _options, ...params } = queryConfig;
-	const options = _options ?? {};
-	if (Object.keys(params).length === 0) return dom;
+function urlQuery(html, params = {}, options = {}) {
+	return serialize(urlQueryDom(parse(html), params, options));
+}
+/**
+* DOM-form of {@link urlQuery} 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 urlQueryDom(dom, params = {}, options = {}) {
+	if (!params || Object.keys(params).length === 0) return dom;
 	const tags = options.tags ?? DEFAULT_TAGS;
 	const attributes = options.attributes ?? DEFAULT_ATTRIBUTES;
 	const strict = options.strict ?? true;
@@ -59,7 +71,7 @@ function urlQuery(dom, config = {}) {
 	}
 	return dom;
 }
-
 //#endregion
-export { urlQuery };
+export { urlQuery, urlQueryDom };
+
 //# sourceMappingURL=urlQuery.js.map

package/dist/transformers/urlQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"urlQuery.js","names":[],"sources":["../../src/transformers/urlQuery.ts"],"sourcesContent":["import queryString from 'query-string'\nimport { selectAll } from 'css-select'\nimport type { ChildNode, Element } from 'domhandler'\nimport { isAbsoluteUrl } from '../utils/url.ts'\nimport type { UrlConfig, UrlQueryOptions } from '../types/config.ts'\n\nconst DEFAULT_ATTRIBUTES = ['src', 'href', 'poster', 'srcset', 'background']\nconst DEFAULT_TAGS = ['a']\n\n/**\n * Append query parameters to a URL string using query-string.\n */\nfunction appendParams(\n  url: string,\n  params: Record<string, unknown>,\n  qsOptions: queryString.StringifyOptions,\n  strict: boolean,\n): string {\n  if (strict && !isAbsoluteUrl(url)) return url\n\n  return queryString.stringifyUrl(\n    { url, query: params as queryString.StringifiableRecord },\n    qsOptions,\n  )\n}\n\n/**\n * URL query transformer.\n *\n * Appends query parameters to URLs found in specified attributes of\n * specified HTML tags.\n *\n * Reads config from the `config.url` object in `MaizzleConfig` (pass\n * `config.url` directly when calling as a standalone transformer).\n * The `_options` key inside `query` controls behaviour:\n * - `tags`       — CSS selectors for elements to process. Default: `['a']`\n * - `attributes` — attribute names to process. Default: `['src', 'href', 'poster', 'srcset', 'background']`\n * - `strict`     — only append to absolute URLs. Default: `true`\n * - `qs`         — options forwarded to query-string. Default: `{ encode: false }`\n *\n * All non-`_options` keys inside `query` are treated as URL parameters to append.\n */\nexport function urlQuery(dom: ChildNode[], config: UrlConfig = {}): ChildNode[] {\n  const queryConfig = config.query\n\n  if (!queryConfig || Object.keys(queryConfig).length === 0) return dom\n\n  const { _options, ...params } = queryConfig as Record<string, unknown>\n  const options = (_options ?? {}) as UrlQueryOptions\n\n  if (Object.keys(params).length === 0) return dom\n\n  const tags = options.tags ?? DEFAULT_TAGS\n  const attributes = options.attributes ?? DEFAULT_ATTRIBUTES\n  const strict = options.strict ?? true\n  const qsOptions: queryString.StringifyOptions = { encode: false, ...((options.qs ?? {}) as queryString.StringifyOptions) }\n\n  // Use css-select to find all elements matching any of the tag selectors\n  const selector = tags.join(', ')\n  const elements = selectAll(selector, dom) as Element[]\n\n  for (const el of elements) {\n    for (const attr of attributes) {\n      const value = el.attribs[attr]\n      if (!value) continue\n\n      const updated = appendParams(value, params, qsOptions, strict)\n      if (updated !== value) {\n        el.attribs[attr] = updated\n      }\n    }\n  }\n\n  return dom\n}\n"],"mappings":";;;;;AAMA,MAAM,qBAAqB;CAAC;CAAO;CAAQ;CAAU;CAAU;CAAa;AAC5E,MAAM,eAAe,CAAC,IAAI;;;;AAK1B,SAAS,aACP,KACA,QACA,WACA,QACQ;AACR,KAAI,UAAU,CAAC,cAAc,IAAI,CAAE,QAAO;AAE1C,QAAO,YAAY,aACjB;EAAE;EAAK,OAAO;EAA2C,EACzD,UACD;;;;;;;;;;;;;;;;;;AAmBH,SAAgB,SAAS,KAAkB,SAAoB,EAAE,EAAe;CAC9E,MAAM,cAAc,OAAO;AAE3B,KAAI,CAAC,eAAe,OAAO,KAAK,YAAY,CAAC,WAAW,EAAG,QAAO;CAElE,MAAM,EAAE,UAAU,GAAG,WAAW;CAChC,MAAM,UAAW,YAAY,EAAE;AAE/B,KAAI,OAAO,KAAK,OAAO,CAAC,WAAW,EAAG,QAAO;CAE7C,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,YAA0C;EAAE,QAAQ;EAAO,GAAK,QAAQ,MAAM,EAAE;EAAoC;CAI1H,MAAM,WAAW,UADA,KAAK,KAAK,KAAK,EACK,IAAI;AAEzC,MAAK,MAAM,MAAM,SACf,MAAK,MAAM,QAAQ,YAAY;EAC7B,MAAM,QAAQ,GAAG,QAAQ;AACzB,MAAI,CAAC,MAAO;EAEZ,MAAM,UAAU,aAAa,OAAO,QAAQ,WAAW,OAAO;AAC9D,MAAI,YAAY,MACd,IAAG,QAAQ,QAAQ;;AAKzB,QAAO"}
+{"version":3,"file":"urlQuery.js","names":[],"sources":["../../src/transformers/urlQuery.ts"],"sourcesContent":["import queryString from 'query-string'\nimport { selectAll } from 'css-select'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize } from '../utils/ast/index.ts'\nimport { isAbsoluteUrl } from '../utils/url.ts'\nimport type { UrlQueryOptions } from '../types/config.ts'\n\nconst DEFAULT_ATTRIBUTES = ['src', 'href', 'poster', 'srcset', 'background']\nconst DEFAULT_TAGS = ['a']\n\n/**\n * Append query parameters to a URL string using query-string.\n */\nfunction appendParams(\n  url: string,\n  params: Record<string, unknown>,\n  qsOptions: queryString.StringifyOptions,\n  strict: boolean,\n): string {\n  if (strict && !isAbsoluteUrl(url)) return url\n\n  return queryString.stringifyUrl(\n    { url, query: params as queryString.StringifiableRecord },\n    qsOptions,\n  )\n}\n\n/**\n * Append query parameters to URLs found in matching attributes/elements.\n *\n * @param html    HTML string to transform.\n * @param params  Query parameters to append (e.g. `{ utm_source: 'newsletter' }`).\n * @param options Behaviour overrides — `tags` (CSS selectors, default `['a']`),\n *                `attributes` (default `['src', 'href', 'poster', 'srcset', 'background']`),\n *                `strict` (default `true`, only rewrites absolute URLs),\n *                `qs` (forwarded to `query-string`, default `{ encode: false }`).\n * @returns       The transformed HTML string.\n *\n * @example\n * import { urlQuery } from '@maizzle/framework'\n *\n * const out = urlQuery(\n *   '<a href=\"https://example.com\">x</a>',\n *   { utm_source: 'newsletter' },\n * )\n *\n * // Restrict to specific tags / attributes:\n * urlQuery(html, { ref: 'email' }, { tags: ['a', 'img'], attributes: ['href', 'src'] })\n */\nexport function urlQuery(\n  html: string,\n  params: Record<string, unknown> = {},\n  options: UrlQueryOptions = {},\n): string {\n  return serialize(urlQueryDom(parse(html), params, options))\n}\n\n/**\n * DOM-form of {@link urlQuery} 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 urlQueryDom(\n  dom: ChildNode[],\n  params: Record<string, unknown> = {},\n  options: UrlQueryOptions = {},\n): ChildNode[] {\n  if (!params || Object.keys(params).length === 0) return dom\n\n  const tags = options.tags ?? DEFAULT_TAGS\n  const attributes = options.attributes ?? DEFAULT_ATTRIBUTES\n  const strict = options.strict ?? true\n  const qsOptions: queryString.StringifyOptions = { encode: false, ...((options.qs ?? {}) as queryString.StringifyOptions) }\n\n  // Use css-select to find all elements matching any of the tag selectors\n  const selector = tags.join(', ')\n  const elements = selectAll(selector, dom) as Element[]\n\n  for (const el of elements) {\n    for (const attr of attributes) {\n      const value = el.attribs[attr]\n      if (!value) continue\n\n      const updated = appendParams(value, params, qsOptions, strict)\n      if (updated !== value) {\n        el.attribs[attr] = updated\n      }\n    }\n  }\n\n  return dom\n}\n"],"mappings":";;;;;;;AAOA,MAAM,qBAAqB;CAAC;CAAO;CAAQ;CAAU;CAAU;CAAa;AAC5E,MAAM,eAAe,CAAC,IAAI;;;;AAK1B,SAAS,aACP,KACA,QACA,WACA,QACQ;CACR,IAAI,UAAU,CAAC,cAAc,IAAI,EAAE,OAAO;CAE1C,OAAO,YAAY,aACjB;EAAE;EAAK,OAAO;EAA2C,EACzD,UACD;;;;;;;;;;;;;;;;;;;;;;;;AAyBH,SAAgB,SACd,MACA,SAAkC,EAAE,EACpC,UAA2B,EAAE,EACrB;CACR,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,QAAQ,QAAQ,CAAC;;;;;;;AAQ7D,SAAgB,YACd,KACA,SAAkC,EAAE,EACpC,UAA2B,EAAE,EAChB;CACb,IAAI,CAAC,UAAU,OAAO,KAAK,OAAO,CAAC,WAAW,GAAG,OAAO;CAExD,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,YAA0C;EAAE,QAAQ;EAAO,GAAK,QAAQ,MAAM,EAAE;EAAoC;CAI1H,MAAM,WAAW,UADA,KAAK,KAAK,KACQ,EAAE,IAAI;CAEzC,KAAK,MAAM,MAAM,UACf,KAAK,MAAM,QAAQ,YAAY;EAC7B,MAAM,QAAQ,GAAG,QAAQ;EACzB,IAAI,CAAC,OAAO;EAEZ,MAAM,UAAU,aAAa,OAAO,QAAQ,WAAW,OAAO;EAC9D,IAAI,YAAY,OACd,GAAG,QAAQ,QAAQ;;CAKzB,OAAO"}

package/dist/types/config.d.ts

@@ -1,9 +1,11 @@
 import { RemoveValue } from "../plugins/postcss/removeDeclarations.js";
 import { Directive, Plugin } from "vue";
 import { Options } from "juice";
-import * as oxfmt from "oxfmt";
+import * as _$oxfmt from "oxfmt";
+import * as _$html_crush0 from "html-crush";
 import { InlineConfig } from "vite";
-import * as shiki from "shiki";
+import * as _$string_strip_html0 from "string-strip-html";
+import * as _$shiki from "shiki";
 import { Options as Options$1 } from "unplugin-vue-markdown/types";
 
 //#region src/types/config.d.ts
@@ -186,9 +188,9 @@ interface CssConfig {
     sort?: 'mobile-first' | 'desktop-first' | ((a: string, b: string) => number);
   };
   /**
-   * Convert unitless CSS values to their unitless equivalents.
+   * Strip units from zero values in inlined styles.
    *
-   * For example, `line-height: 24px` with a `16px` font becomes `line-height: 1.5`.
+   * For example, `padding: 0px 16px` becomes `padding: 0 16px`.
    *
    * @default true
    */
@@ -229,7 +231,11 @@ interface CssConfig {
    */
   removeDeclarations?: Record<string, RemoveValue>;
   /**
-   * File paths to exclude from CSS processing.
+   * Glob patterns or paths excluded from Tailwind's `@source` scanner.
+   *
+   * Tailwind won't generate utilities for classes used in these files.
+   * Useful for ignoring AMP variants or any templates whose classes
+   * shouldn't end up in the output CSS.
    *
    * @example
    * css: {
@@ -258,12 +264,23 @@ interface AttributesConfig {
    */
   add?: false | Record<string, false | Record<string, false | string | boolean | number>>;
   /**
-   * Remove attributes from HTML elements by name or name-value pair.
+   * Remove attributes from HTML elements.
+   *
+   * Empty `style` and `class` attributes are always stripped, regardless
+   * of config. Entries added here are appended to those defaults.
+   *
+   * - String — remove when the attribute's value is empty.
+   * - `{ name, value: 'literal' }` — remove when the value matches exactly.
+   * - `{ name, value: /regex/ }` — remove when the value matches the regex.
    *
    * @example
    * html: {
    *   attributes: {
-   *     remove: ['data-test', { name: 'class', value: /^js-/ }],
+   *     remove: [
+   *       'data-foo',
+   *       { name: 'role', value: 'none' },
+   *       { name: 'class', value: /^js-/ },
+   *     ],
    *   }
    * }
    */
@@ -335,13 +352,16 @@ interface HtmlConfig {
    *
    * Set to `true` to enable with defaults, or pass options.
    */
-  format?: boolean | oxfmt.FormatOptions;
+  format?: boolean | _$oxfmt.FormatOptions;
   /**
    * Minify the HTML output.
    *
-   * Set to `true` to enable with defaults, or pass options.
+   * Set to `true` to enable with defaults, or pass `html-crush`
+   * options to customize.
+   *
+   * @see https://codsen.com/os/html-crush
    */
-  minify?: boolean | Record<string, unknown>;
+  minify?: boolean | Partial<_$html_crush0.Opts>;
 }
 type FilterFunction = (str: string, value: string) => string;
 type FiltersConfig = false | Record<string, FilterFunction>;
@@ -351,7 +371,7 @@ interface MarkdownConfig extends Options$1 {
    *
    * @default 'github-light'
    */
-  shikiTheme?: shiki.BundledTheme;
+  shikiTheme?: _$shiki.BundledTheme;
 }
 interface VueConfig {
   /** Vue plugins to register on the app instance before rendering. */
@@ -366,7 +386,7 @@ interface VueConfig {
  *
  * - `false` skips the listed transformer.
  * - `true` force-enables it for this run (only meaningful for boolean-driven
- *   transformers: inlineCSS, purgeCSS, prettify, minify, shorthandCSS,
+ *   transformers: inlineCss, purgeCss, prettify, minify, shorthandCss,
  *   sixHex, safeClassNames, entities). Layers on the matching
  *   `css.*` / `html.*` config slice.
  * - missing keys keep their default behavior.
@@ -382,20 +402,45 @@ interface VueConfig {
 interface TransformerToggles {
   safeClassNames?: boolean;
   attributeToStyle?: boolean;
-  inlineCSS?: boolean;
+  inlineCss?: boolean;
   removeAttributes?: boolean;
-  shorthandCSS?: boolean;
+  shorthandCss?: boolean;
   sixHex?: boolean;
   addAttributes?: boolean;
   filters?: boolean;
   baseURL?: boolean;
   urlQuery?: boolean;
-  purgeCSS?: boolean;
+  purgeCss?: boolean;
   entities?: boolean;
   replaceStrings?: boolean;
   prettify?: boolean;
   minify?: boolean;
 }
+/**
+ * Plaintext generation options.
+ *
+ * Control where plaintext files are written, what extension they use,
+ * and the options forwarded to `string-strip-html`.
+ */
+interface PlaintextConfig {
+  /**
+   * Output directory for plaintext files. When omitted, files are written
+   * next to their HTML counterpart in `build.output.path`.
+   */
+  destination?: string;
+  /**
+   * File extension for plaintext files (without the leading dot).
+   *
+   * @default 'txt'
+   */
+  extension?: string;
+  /**
+   * Options forwarded to `string-strip-html`.
+   *
+   * @see https://codsen.com/os/string-strip-html
+   */
+  options?: Partial<_$string_strip_html0.Opts>;
+}
 interface MaizzleConfig {
   /**
    * Root directory for the Maizzle email project.
@@ -536,11 +581,18 @@ interface MaizzleConfig {
   /**
    * Generate a plaintext version of the email.
    *
-   * Set to `true` to enable, or pass a string path or options object.
+   * Set to `true` to enable with defaults, or pass an object to configure
+   * destination directory, file extension, and `string-strip-html` options.
    *
    * @default false
+   * @example
+   * plaintext: {
+   *   destination: 'build_production/plaintext',
+   *   extension: 'txt',
+   *   options: { ignoreTags: ['br'] },
+   * }
    */
-  plaintext?: boolean | string | Record<string, unknown>;
+  plaintext?: boolean | PlaintextConfig;
   /** PostCSS processing options. */
   postcss?: PostcssConfig;
   /**
@@ -552,7 +604,7 @@ interface MaizzleConfig {
    *
    * @default true
    * @example
-   * useTransformers: { inlineCSS: false, minify: false }
+   * useTransformers: { inlineCss: false, minify: false }
    */
   useTransformers?: boolean | TransformerToggles;
   /**
@@ -636,5 +688,5 @@ interface MaizzleConfig {
   [key: string]: any;
 }
 //#endregion
-export { AttributesConfig, CaniemailClient, ChecksConfig, CssConfig, EntitiesConfig, FilterFunction, FiltersConfig, HtmlConfig, MaizzleConfig, MarkdownConfig, PostcssConfig, TransformerToggles, UrlConfig, UrlQuery, UrlQueryOptions, VueConfig };
+export { AttributesConfig, CaniemailClient, ChecksConfig, CssConfig, EntitiesConfig, FilterFunction, FiltersConfig, HtmlConfig, MaizzleConfig, MarkdownConfig, PlaintextConfig, PostcssConfig, TransformerToggles, UrlConfig, UrlQuery, UrlQueryOptions, VueConfig };
 //# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/types/config.ts"],"mappings":"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"}
+{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/types/config.ts"],"mappings":"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"}

package/dist/types/config.js

@@ -1 +1 @@
-export {  };
+export {};

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-import { AttributesConfig, CaniemailClient, ChecksConfig, CssConfig, EntitiesConfig, FilterFunction, FiltersConfig, HtmlConfig, MaizzleConfig, MarkdownConfig, PostcssConfig, TransformerToggles, UrlConfig, UrlQuery, UrlQueryOptions } from "./config.js";
-export { type AttributesConfig, type CaniemailClient, type ChecksConfig, type CssConfig, type EntitiesConfig, type FilterFunction, type FiltersConfig, type HtmlConfig, type MaizzleConfig, type MarkdownConfig, type PostcssConfig, type TransformerToggles, type UrlConfig, type UrlQuery, type UrlQueryOptions };
+import { AttributesConfig, CaniemailClient, ChecksConfig, CssConfig, EntitiesConfig, FilterFunction, FiltersConfig, HtmlConfig, MaizzleConfig, MarkdownConfig, PlaintextConfig, PostcssConfig, TransformerToggles, UrlConfig, UrlQuery, UrlQueryOptions } from "./config.js";
+export { type AttributesConfig, type CaniemailClient, type ChecksConfig, type CssConfig, type EntitiesConfig, type FilterFunction, type FiltersConfig, type HtmlConfig, type MaizzleConfig, type MarkdownConfig, type PlaintextConfig, type PostcssConfig, type TransformerToggles, type UrlConfig, type UrlQuery, type UrlQueryOptions };

package/dist/types/index.js

@@ -1 +1 @@
-export {  };
+export {};

package/dist/utils/ast/index.js

@@ -1,5 +1,4 @@
 import { parse } from "./parser.js";
 import { walk } from "./walker.js";
 import { serialize } from "./serializer.js";
-
-export { parse, serialize, walk };
+export { parse, serialize, walk };

package/dist/utils/ast/parser.js

@@ -1,6 +1,5 @@
 import { Parser } from "htmlparser2";
 import { DomHandler } from "domhandler";
-
 //#region src/utils/ast/parser.ts
 function parse(html, options = {}) {
 	const handler = new DomHandler();
@@ -9,7 +8,7 @@ function parse(html, options = {}) {
 	parser.end();
 	return handler.dom;
 }
-
 //#endregion
 export { parse };
+
 //# sourceMappingURL=parser.js.map

package/dist/utils/ast/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","names":[],"sources":["../../../src/utils/ast/parser.ts"],"sourcesContent":["import { Parser } from 'htmlparser2'\nimport { DomHandler } from 'domhandler'\nimport type { ChildNode, DomHandlerOptions } from 'domhandler'\n\nexport function parse(html: string, options: DomHandlerOptions = {}): ChildNode[] {\n  const handler = new DomHandler()\n  const parser = new Parser(handler, options)\n  parser.write(html)\n  parser.end()\n  return handler.dom\n}\n"],"mappings":";;;;AAIA,SAAgB,MAAM,MAAc,UAA6B,EAAE,EAAe;CAChF,MAAM,UAAU,IAAI,YAAY;CAChC,MAAM,SAAS,IAAI,OAAO,SAAS,QAAQ;AAC3C,QAAO,MAAM,KAAK;AAClB,QAAO,KAAK;AACZ,QAAO,QAAQ"}
+{"version":3,"file":"parser.js","names":[],"sources":["../../../src/utils/ast/parser.ts"],"sourcesContent":["import { Parser } from 'htmlparser2'\nimport { DomHandler } from 'domhandler'\nimport type { ChildNode, DomHandlerOptions } from 'domhandler'\n\nexport function parse(html: string, options: DomHandlerOptions = {}): ChildNode[] {\n  const handler = new DomHandler()\n  const parser = new Parser(handler, options)\n  parser.write(html)\n  parser.end()\n  return handler.dom\n}\n"],"mappings":";;;AAIA,SAAgB,MAAM,MAAc,UAA6B,EAAE,EAAe;CAChF,MAAM,UAAU,IAAI,YAAY;CAChC,MAAM,SAAS,IAAI,OAAO,SAAS,QAAQ;CAC3C,OAAO,MAAM,KAAK;CAClB,OAAO,KAAK;CACZ,OAAO,QAAQ"}

package/dist/utils/ast/serializer.js

@@ -1,6 +1,5 @@
 import { walk } from "./walker.js";
 import render from "dom-serializer";
-
 //#region src/utils/ast/serializer.ts
 /**
 * Re-encode < and > as entities in text nodes inside <code> elements.
@@ -31,7 +30,7 @@ function serialize(dom, options) {
 		...options
 	});
 }
-
 //#endregion
 export { serialize };
+
 //# sourceMappingURL=serializer.js.map

package/dist/utils/ast/serializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.js","names":[],"sources":["../../../src/utils/ast/serializer.ts"],"sourcesContent":["import render from 'dom-serializer'\nimport type { ChildNode } from 'domhandler'\nimport type { DomSerializerOptions } from 'dom-serializer'\nimport { walk } from './walker.ts'\n\n/**\n * Re-encode < and > as entities in text nodes inside <code> elements.\n *\n * The DOM parser decodes entities like &#x3C; into raw < in text nodes.\n * With encodeEntities: false the serializer outputs them as-is, which\n * creates broken HTML (e.g. </a> inside a code block closes the real tag).\n *\n * We selectively fix this for <code> contents only, so the rest of the\n * document (where encodeEntities: false is needed) is unaffected.\n */\nfunction encodeCodeTextNodes(dom: ChildNode[]): void {\n  walk(dom, (node) => {\n    const el = node as import('domhandler').Element\n    if (el.name !== 'code') return\n\n    walk(el.children ?? [], (child) => {\n      if (child.type === 'text') {\n        const text = child as import('domhandler').Text\n        text.data = text.data.replace(/</g, '&lt;').replace(/>/g, '&gt;')\n      }\n    })\n  })\n}\n\nexport function serialize(dom: ChildNode[], options?: DomSerializerOptions): string {\n  encodeCodeTextNodes(dom)\n  return render(dom, { encodeEntities: false, ...options })\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAS,oBAAoB,KAAwB;AACnD,MAAK,MAAM,SAAS;EAClB,MAAM,KAAK;AACX,MAAI,GAAG,SAAS,OAAQ;AAExB,OAAK,GAAG,YAAY,EAAE,GAAG,UAAU;AACjC,OAAI,MAAM,SAAS,QAAQ;IACzB,MAAM,OAAO;AACb,SAAK,OAAO,KAAK,KAAK,QAAQ,MAAM,OAAO,CAAC,QAAQ,MAAM,OAAO;;IAEnE;GACF;;AAGJ,SAAgB,UAAU,KAAkB,SAAwC;AAClF,qBAAoB,IAAI;AACxB,QAAO,OAAO,KAAK;EAAE,gBAAgB;EAAO,GAAG;EAAS,CAAC"}
+{"version":3,"file":"serializer.js","names":[],"sources":["../../../src/utils/ast/serializer.ts"],"sourcesContent":["import render from 'dom-serializer'\nimport type { ChildNode } from 'domhandler'\nimport type { DomSerializerOptions } from 'dom-serializer'\nimport { walk } from './walker.ts'\n\n/**\n * Re-encode < and > as entities in text nodes inside <code> elements.\n *\n * The DOM parser decodes entities like &#x3C; into raw < in text nodes.\n * With encodeEntities: false the serializer outputs them as-is, which\n * creates broken HTML (e.g. </a> inside a code block closes the real tag).\n *\n * We selectively fix this for <code> contents only, so the rest of the\n * document (where encodeEntities: false is needed) is unaffected.\n */\nfunction encodeCodeTextNodes(dom: ChildNode[]): void {\n  walk(dom, (node) => {\n    const el = node as import('domhandler').Element\n    if (el.name !== 'code') return\n\n    walk(el.children ?? [], (child) => {\n      if (child.type === 'text') {\n        const text = child as import('domhandler').Text\n        text.data = text.data.replace(/</g, '&lt;').replace(/>/g, '&gt;')\n      }\n    })\n  })\n}\n\nexport function serialize(dom: ChildNode[], options?: DomSerializerOptions): string {\n  encodeCodeTextNodes(dom)\n  return render(dom, { encodeEntities: false, ...options })\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAS,oBAAoB,KAAwB;CACnD,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EACX,IAAI,GAAG,SAAS,QAAQ;EAExB,KAAK,GAAG,YAAY,EAAE,GAAG,UAAU;GACjC,IAAI,MAAM,SAAS,QAAQ;IACzB,MAAM,OAAO;IACb,KAAK,OAAO,KAAK,KAAK,QAAQ,MAAM,OAAO,CAAC,QAAQ,MAAM,OAAO;;IAEnE;GACF;;AAGJ,SAAgB,UAAU,KAAkB,SAAwC;CAClF,oBAAoB,IAAI;CACxB,OAAO,OAAO,KAAK;EAAE,gBAAgB;EAAO,GAAG;EAAS,CAAC"}

package/dist/utils/ast/walker.js

@@ -6,7 +6,7 @@ function walk(ast, callback) {
 	}
 	for (const node of ast) traverse(node);
 }
-
 //#endregion
 export { walk };
+
 //# sourceMappingURL=walker.js.map