@maizzle/framework 6.0.0-rc.9 → 6.0.1

package/dist/plugins/postcss/removeDeclarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeDeclarations.js","names":[],"sources":["../../../src/plugins/postcss/removeDeclarations.ts"],"sourcesContent":["/**\n * postcss-remove-declarations\n *\n * Removes CSS declarations (or whole rules) based on a selector map.\n *\n * The `remove` option maps a selector string to one of:\n *\n *   - `\"*\"`          — remove the entire rule\n *   - `string`       — remove the single named property\n *   - `string[]`     — remove every listed property\n *   - `Record<string, string>` — remove a property only when its value matches.\n *                     Append `!important` to the value to restrict the match\n *                     to non-important declarations only.\n *\n * Example:\n *   removeDeclarations({\n *     remove: {\n *       ':root': '*',\n *       '.foo': ['color', 'margin'],\n *       '.bar': { color: 'red' },\n *     }\n *   })\n */\n\nimport type { Plugin, Root } from 'postcss'\n\nexport type RemoveValue =\n  | '*'\n  | string\n  | string[]\n  | Record<string, string>\n\nexport interface RemoveDeclarationsOptions {\n  remove: Record<string, RemoveValue>\n}\n\nconst IMPORTANT = '!important'\n\nfunction normalizeSelector(selector: string): string {\n  return selector.replace(/(\\r\\n|\\n|\\r)/gm, '')\n}\n\nexport default (options: RemoveDeclarationsOptions): Plugin => {\n  return {\n    postcssPlugin: 'postcss-remove-declarations',\n\n    Once(root: Root) {\n      const remove = options.remove ?? {}\n\n      root.walkRules((rule) => {\n        let toRemove = remove[normalizeSelector(rule.selector)]\n\n        if (!toRemove) return\n\n        // Remove the entire rule\n        if (toRemove === '*') {\n          rule.remove()\n          return\n        }\n\n        // Normalise a bare string into an array\n        if (typeof toRemove === 'string') {\n          toRemove = [toRemove]\n        }\n\n        if (Array.isArray(toRemove)) {\n          const props = toRemove as string[]\n          rule.walkDecls((decl) => {\n            if (props.includes(decl.prop)) decl.remove()\n          })\n        } else if (typeof toRemove === 'object') {\n          // Object: match both property and value\n          const map = toRemove as Record<string, string>\n          rule.walkDecls((decl) => {\n            if (!(decl.prop in map)) return\n\n            let expected = map[decl.prop]\n            const requireNonImportant = expected.endsWith(IMPORTANT)\n\n            if (requireNonImportant) {\n              expected = expected.slice(0, -IMPORTANT.length).trim()\n            }\n\n            if (decl.value !== expected) return\n            if (decl.important && requireNonImportant) return\n\n            decl.remove()\n          })\n        }\n\n        // Remove the rule if all declarations were removed\n        if (rule.nodes?.length === 0) {\n          rule.remove()\n        }\n      })\n    },\n  }\n}\n\nexport const postcss = true\n"],"mappings":";AAoCA,MAAM,YAAY;AAElB,SAAS,kBAAkB,UAA0B;CACnD,OAAO,SAAS,QAAQ,kBAAkB,EAAE;AAC9C;AAEA,IAAA,8BAAgB,YAA+C;CAC7D,OAAO;EACL,eAAe;EAEf,KAAK,MAAY;GACf,MAAM,SAAS,QAAQ,UAAU,CAAC;GAElC,KAAK,WAAW,SAAS;IACvB,IAAI,WAAW,OAAO,kBAAkB,KAAK,QAAQ;IAErD,IAAI,CAAC,UAAU;IAGf,IAAI,aAAa,KAAK;KACpB,KAAK,OAAO;KACZ;IACF;IAGA,IAAI,OAAO,aAAa,UACtB,WAAW,CAAC,QAAQ;IAGtB,IAAI,MAAM,QAAQ,QAAQ,GAAG;KAC3B,MAAM,QAAQ;KACd,KAAK,WAAW,SAAS;MACvB,IAAI,MAAM,SAAS,KAAK,IAAI,GAAG,KAAK,OAAO;KAC7C,CAAC;IACH,OAAO,IAAI,OAAO,aAAa,UAAU;KAEvC,MAAM,MAAM;KACZ,KAAK,WAAW,SAAS;MACvB,IAAI,EAAE,KAAK,QAAQ,MAAM;MAEzB,IAAI,WAAW,IAAI,KAAK;MACxB,MAAM,sBAAsB,SAAS,SAAS,SAAS;MAEvD,IAAI,qBACF,WAAW,SAAS,MAAM,GAAG,GAAiB,CAAC,CAAC,KAAK;MAGvD,IAAI,KAAK,UAAU,UAAU;MAC7B,IAAI,KAAK,aAAa,qBAAqB;MAE3C,KAAK,OAAO;KACd,CAAC;IACH;IAGA,IAAI,KAAK,OAAO,WAAW,GACzB,KAAK,OAAO;GAEhB,CAAC;EACH;CACF;AACF;AAEA,MAAa,UAAU"}

package/dist/plugins/postcss/resolveMaizzleImports.d.ts

@@ -0,0 +1,16 @@
+import { Plugin } from "postcss";
+
+//#region src/plugins/postcss/resolveMaizzleImports.d.ts
+/**
+ * Rewrite `@import "@maizzle/tailwindcss"` (and subpaths like
+ * `@maizzle/tailwindcss/mso`) to absolute file paths so postcss/Tailwind
+ * can resolve them regardless of where the user's template lives or how
+ * their package manager hoists dependencies.
+ *
+ * Resolution order: prefer the user's project copy (so explicit installs
+ * win), then fall back to the copy bundled with the framework.
+ */
+declare function resolveMaizzleImports(userRoot?: string): Plugin;
+//#endregion
+export { resolveMaizzleImports };
+//# sourceMappingURL=resolveMaizzleImports.d.ts.map

package/dist/plugins/postcss/resolveMaizzleImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMaizzleImports.d.ts","names":[],"sources":["../../../src/plugins/postcss/resolveMaizzleImports.ts"],"mappings":";;;;;AAiBA;;;;AAA+E;;;iBAA/D,qBAAA,CAAsB,QAAA,YAAmC,MAAM"}

package/dist/plugins/postcss/resolveMaizzleImports.js

@@ -0,0 +1,39 @@
+import { createRequire } from "node:module";
+//#region src/plugins/postcss/resolveMaizzleImports.ts
+const SUBPATH_RE = new RegExp(`^@maizzle/tailwindcss(?:/|$)`);
+const requireFromFramework = createRequire(import.meta.url);
+/**
+* Rewrite `@import "@maizzle/tailwindcss"` (and subpaths like
+* `@maizzle/tailwindcss/mso`) to absolute file paths so postcss/Tailwind
+* can resolve them regardless of where the user's template lives or how
+* their package manager hoists dependencies.
+*
+* Resolution order: prefer the user's project copy (so explicit installs
+* win), then fall back to the copy bundled with the framework.
+*/
+function resolveMaizzleImports(userRoot = process.cwd()) {
+	const requireFromUser = createRequire(`${userRoot}/_maizzle.js`);
+	function resolve(spec) {
+		try {
+			return requireFromUser.resolve(spec);
+		} catch {}
+		try {
+			return requireFromFramework.resolve(spec);
+		} catch {}
+	}
+	return {
+		postcssPlugin: "maizzle:resolve-tw-imports",
+		AtRule: { import(rule) {
+			const m = rule.params.match(/^\s*["']([^"']+)["']/);
+			if (!m) return;
+			const spec = m[1];
+			if (!SUBPATH_RE.test(spec)) return;
+			const abs = resolve(spec);
+			if (abs) rule.params = rule.params.replace(m[0], `"${abs}"`);
+		} }
+	};
+}
+//#endregion
+export { resolveMaizzleImports };
+
+//# sourceMappingURL=resolveMaizzleImports.js.map

package/dist/plugins/postcss/resolveMaizzleImports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMaizzleImports.js","names":[],"sources":["../../../src/plugins/postcss/resolveMaizzleImports.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport type { Plugin } from 'postcss'\n\nconst PKG = '@maizzle/tailwindcss'\nconst SUBPATH_RE = new RegExp(`^${PKG}(?:/|$)`)\n\nconst requireFromFramework = createRequire(import.meta.url)\n\n/**\n * Rewrite `@import \"@maizzle/tailwindcss\"` (and subpaths like\n * `@maizzle/tailwindcss/mso`) to absolute file paths so postcss/Tailwind\n * can resolve them regardless of where the user's template lives or how\n * their package manager hoists dependencies.\n *\n * Resolution order: prefer the user's project copy (so explicit installs\n * win), then fall back to the copy bundled with the framework.\n */\nexport function resolveMaizzleImports(userRoot: string = process.cwd()): Plugin {\n  const requireFromUser = createRequire(`${userRoot}/_maizzle.js`)\n\n  function resolve(spec: string): string | undefined {\n    try { return requireFromUser.resolve(spec) } catch {}\n    try { return requireFromFramework.resolve(spec) } catch {}\n    return undefined\n  }\n\n  return {\n    postcssPlugin: 'maizzle:resolve-tw-imports',\n    AtRule: {\n      import(rule) {\n        const m = rule.params.match(/^\\s*[\"']([^\"']+)[\"']/)\n        if (!m) return\n        const spec = m[1]\n        if (!SUBPATH_RE.test(spec)) return\n\n        const abs = resolve(spec)\n        if (abs) rule.params = rule.params.replace(m[0], `\"${abs}\"`)\n      },\n    },\n  }\n}\n"],"mappings":";;AAIA,MAAM,aAAa,IAAI,OAAO,8BAAgB;AAE9C,MAAM,uBAAuB,cAAc,OAAO,KAAK,GAAG;;;;;;;;;;AAW1D,SAAgB,sBAAsB,WAAmB,QAAQ,IAAI,GAAW;CAC9E,MAAM,kBAAkB,cAAc,GAAG,SAAS,aAAa;CAE/D,SAAS,QAAQ,MAAkC;EACjD,IAAI;GAAE,OAAO,gBAAgB,QAAQ,IAAI;EAAE,QAAQ,CAAC;EACpD,IAAI;GAAE,OAAO,qBAAqB,QAAQ,IAAI;EAAE,QAAQ,CAAC;CAE3D;CAEA,OAAO;EACL,eAAe;EACf,QAAQ,EACN,OAAO,MAAM;GACX,MAAM,IAAI,KAAK,OAAO,MAAM,sBAAsB;GAClD,IAAI,CAAC,GAAG;GACR,MAAM,OAAO,EAAE;GACf,IAAI,CAAC,WAAW,KAAK,IAAI,GAAG;GAE5B,MAAM,MAAM,QAAQ,IAAI;GACxB,IAAI,KAAK,KAAK,SAAS,KAAK,OAAO,QAAQ,EAAE,IAAI,IAAI,IAAI,EAAE;EAC7D,EACF;CACF;AACF"}

package/dist/plugins/postcss/resolveProps.d.ts

@@ -0,0 +1,8 @@
+import { Plugin } from "postcss";
+
+//#region src/plugins/postcss/resolveProps.d.ts
+declare const _default: () => Plugin;
+declare const postcss = true;
+//#endregion
+export { _default as default, postcss };
+//# sourceMappingURL=resolveProps.d.ts.map

package/dist/plugins/postcss/resolveProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveProps.d.ts","names":[],"sources":["../../../src/plugins/postcss/resolveProps.ts"],"mappings":";;;cAiBsE,QAAA,QA+FnD,MAAM;AAAA,cA+IZ,OAAA"}

package/dist/plugins/postcss/resolveProps.js

@@ -0,0 +1,155 @@
+//#region src/plugins/postcss/resolveProps.ts
+/** Check if a rule's selector includes :root */
+function isRootRule(rule) {
+	const sel = rule.selector;
+	return sel === ":root" || sel.includes(":root");
+}
+/** Check if a rule is inside @layer (not @media or other at-rules) */
+function isInLayer(rule) {
+	return rule.parent?.type === "atrule" && rule.parent.name === "layer";
+}
+/**
+* Parse the first var() call in a string by counting parens.
+* Returns null if no var() found.
+*/
+function findVar(value, startFrom = 0) {
+	const idx = value.indexOf("var(", startFrom);
+	if (idx === -1) return null;
+	let depth = 1;
+	let i = idx + 4;
+	let commaIdx = -1;
+	while (i < value.length && depth > 0) {
+		const ch = value.charCodeAt(i);
+		if (ch === 40) depth++;
+		else if (ch === 41) {
+			if (--depth === 0) break;
+		} else if (ch === 44 && depth === 1 && commaIdx === -1) commaIdx = i;
+		i++;
+	}
+	if (depth !== 0) return null;
+	const name = commaIdx === -1 ? value.slice(idx + 4, i).trim() : value.slice(idx + 4, commaIdx).trim();
+	const fallback = commaIdx === -1 ? void 0 : value.slice(commaIdx + 1, i);
+	return {
+		start: idx,
+		end: i + 1,
+		name,
+		fallback
+	};
+}
+/**
+* Resolve all var() references in a value string.
+* Iterates until no resolvable var() remain.
+*/
+function resolveValue(value, localVars, rootVars, propertyDefaults) {
+	let result = value;
+	let safety = 10;
+	while (safety-- > 0) {
+		const v = findVar(result);
+		if (!v) break;
+		const resolved = localVars.get(v.name) ?? rootVars.get(v.name) ?? propertyDefaults?.get(v.name);
+		if (resolved !== void 0) result = result.slice(0, v.start) + resolved + result.slice(v.end);
+		else if (v.fallback !== void 0) result = result.slice(0, v.start) + v.fallback.trim() + result.slice(v.end);
+		else {
+			if (!findVar(result, v.end)) break;
+			const tail = resolveValue(result.slice(v.end), localVars, rootVars, propertyDefaults);
+			result = result.slice(0, v.end) + tail;
+			break;
+		}
+	}
+	return result;
+}
+var resolveProps_default = () => {
+	return {
+		postcssPlugin: "postcss-resolve-props",
+		Once(root) {
+			const propertyDefaults = /* @__PURE__ */ new Map();
+			root.walkAtRules("property", (rule) => {
+				const name = rule.params.trim();
+				if (!name.startsWith("--")) return;
+				rule.walkDecls("initial-value", (decl) => {
+					propertyDefaults.set(name, decl.value);
+				});
+			});
+			/**
+			* Pass 1: collect :root vars (top-level and inside @layer). Skip
+			* :root inside @media — those are for dark mode and should
+			* stay.
+			*/
+			const rootVars = /* @__PURE__ */ new Map();
+			root.walkRules((rule) => {
+				if (!isRootRule(rule)) return;
+				/**
+				* Allow :root at top level or inside @layer (Tailwind theme vars).
+				* Skip :root inside @media or other non-layer at-rules.
+				*/
+				if (rule.parent?.type !== "root" && !isInLayer(rule)) return;
+				rule.each((node) => {
+					if (node.type === "decl" && node.prop.startsWith("--")) rootVars.set(node.prop, node.value);
+				});
+			});
+			if (rootVars.size > 0) {
+				let changed = true;
+				let iterations = 5;
+				while (changed && iterations-- > 0) {
+					changed = false;
+					for (const [name, value] of rootVars) {
+						if (!value.includes("var(")) continue;
+						const resolved = resolveValue(value, rootVars, rootVars, propertyDefaults);
+						if (resolved !== value) {
+							rootVars.set(name, resolved);
+							changed = true;
+						}
+					}
+				}
+			}
+			root.walkRules((rule) => {
+				/**
+				* Skip :root inside @media — those vars are for dark mode etc. and
+				* must stay in the <style> tag as-is. Allow :root at top
+				* level and inside @layer (processed in pass 3).
+				*/
+				if (isRootRule(rule)) {
+					if (rule.parent?.type !== "root" && !isInLayer(rule)) return;
+				}
+				const localVars = /* @__PURE__ */ new Map();
+				const localDecls = [];
+				let hasVarRefs = false;
+				rule.walk((node) => {
+					if (node.type !== "decl") return;
+					if (node.prop.startsWith("--")) localDecls.push(node);
+					else if (node.value.includes("var(")) hasVarRefs = true;
+				});
+				if (!hasVarRefs && localDecls.length === 0) return;
+				for (const decl of localDecls) {
+					const value = decl.value.includes("var(") ? resolveValue(decl.value, localVars, rootVars, propertyDefaults) : decl.value;
+					localVars.set(decl.prop, value);
+				}
+				if (hasVarRefs) rule.walk((node) => {
+					if (node.type !== "decl") return;
+					if (node.prop.startsWith("--")) return;
+					if (!node.value.includes("var(")) return;
+					const resolved = resolveValue(node.value, localVars, rootVars, propertyDefaults);
+					if (resolved !== node.value) {
+						const cleaned = resolved.replace(/  +/g, " ").trim();
+						if (cleaned) node.value = cleaned;
+						else node.remove();
+					}
+				});
+				for (const decl of localDecls) decl.remove();
+			});
+			root.walkAtRules("property", (rule) => {
+				rule.remove();
+			});
+			root.walkRules((rule) => {
+				if (!isRootRule(rule)) return;
+				if (rule.parent?.type !== "root" && !isInLayer(rule)) return;
+				if (rule.nodes?.length === 0) rule.remove();
+			});
+		}
+	};
+};
+const postcss = true;
+//#endregion
+export { resolveProps_default as default, postcss };
+
+//# sourceMappingURL=resolveProps.js.map

package/dist/plugins/postcss/resolveProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveProps.js","names":[],"sources":["../../../src/plugins/postcss/resolveProps.ts"],"sourcesContent":["/**\n * postcss-resolve-props\n *\n * Resolves CSS custom properties (var() references) and removes\n * the consumed declarations, producing flat CSS for email inlining.\n *\n * Resolution order per var():\n *   1. Local declaration in the same rule\n *   2. :root declaration (top-level only, not inside @media)\n *   3. @property initial-value (Tailwind v4 composable defaults)\n *   4. Fallback value from the var() itself\n *\n * Handles nested var() in both values and fallbacks.\n * Replaces postcss-custom-properties with correct support for\n * local var declarations (Tailwind composable pattern, user CSS).\n */\n\nimport type { AtRule, Declaration, Plugin, Root, Rule } from 'postcss'\n\n/** Check if a rule's selector includes :root */\nfunction isRootRule(rule: Rule): boolean {\n  const sel = rule.selector\n  return sel === ':root' || sel.includes(':root')\n}\n\n/** Check if a rule is inside @layer (not @media or other at-rules) */\nfunction isInLayer(rule: Rule): boolean {\n  return rule.parent?.type === 'atrule' && (rule.parent as any).name === 'layer'\n}\n\n/**\n * Parse the first var() call in a string by counting parens.\n * Returns null if no var() found.\n */\nfunction findVar(value: string, startFrom = 0): {\n  start: number\n  end: number\n  name: string\n  fallback: string | undefined\n} | null {\n  const idx = value.indexOf('var(', startFrom)\n  if (idx === -1) return null\n\n  let depth = 1\n  let i = idx + 4\n  let commaIdx = -1\n\n  while (i < value.length && depth > 0) {\n    const ch = value.charCodeAt(i)\n    if (ch === 40 /* ( */) depth++\n    else if (ch === 41 /* ) */) {\n      if (--depth === 0) break\n    } else if (ch === 44 /* , */ && depth === 1 && commaIdx === -1) {\n      commaIdx = i\n    }\n    i++\n  }\n\n  if (depth !== 0) return null\n\n  const name = commaIdx === -1\n    ? value.slice(idx + 4, i).trim()\n    : value.slice(idx + 4, commaIdx).trim()\n\n  const fallback = commaIdx === -1\n    ? undefined\n    : value.slice(commaIdx + 1, i)\n\n  return { start: idx, end: i + 1, name, fallback }\n}\n\n/**\n * Resolve all var() references in a value string.\n * Iterates until no resolvable var() remain.\n */\nfunction resolveValue(\n  value: string,\n  localVars: Map<string, string>,\n  rootVars: Map<string, string>,\n  propertyDefaults?: Map<string, string>,\n): string {\n  let result = value\n  let safety = 10\n\n  while (safety-- > 0) {\n    const v = findVar(result)\n    if (!v) break\n\n    const resolved = localVars.get(v.name) ?? rootVars.get(v.name) ?? propertyDefaults?.get(v.name)\n\n    if (resolved !== undefined) {\n      result = result.slice(0, v.start) + resolved + result.slice(v.end)\n    } else if (v.fallback !== undefined) {\n      result = result.slice(0, v.start) + v.fallback.trim() + result.slice(v.end)\n    } else {\n      /**\n       * Unresolvable with no fallback — skip past it to avoid infinite loop.\n       * Try to find another var() after this one.\n       */\n      const next = findVar(result, v.end)\n      if (!next) break\n\n      // Process the rest of the string from after this var()\n      const tail = resolveValue(result.slice(v.end), localVars, rootVars, propertyDefaults)\n      result = result.slice(0, v.end) + tail\n      break\n    }\n  }\n\n  return result\n}\n\nexport default (): Plugin => {\n  return {\n    postcssPlugin: 'postcss-resolve-props',\n\n    Once(root: Root) {\n      // Pass 0: collect @property initial-value defaults (Tailwind v4 composable pattern)\n      const propertyDefaults = new Map<string, string>()\n\n      root.walkAtRules('property', (rule: AtRule) => {\n        const name = rule.params.trim()\n        if (!name.startsWith('--')) return\n\n        rule.walkDecls('initial-value', (decl) => {\n          propertyDefaults.set(name, decl.value)\n        })\n      })\n\n      /**\n       * Pass 1: collect :root vars (top-level and inside @layer). Skip\n       * :root inside @media — those are for dark mode and should\n       * stay.\n       */\n      const rootVars = new Map<string, string>()\n\n      root.walkRules((rule) => {\n        if (!isRootRule(rule)) return\n\n        /**\n         * Allow :root at top level or inside @layer (Tailwind theme vars).\n         * Skip :root inside @media or other non-layer at-rules.\n         */\n        if (rule.parent?.type !== 'root' && !isInLayer(rule)) return\n\n        rule.each((node) => {\n          if (node.type === 'decl' && node.prop.startsWith('--')) {\n            rootVars.set(node.prop, node.value)\n          }\n        })\n      })\n\n      // Resolve :root vars referencing other :root vars\n      if (rootVars.size > 0) {\n        let changed = true\n        let iterations = 5\n\n        while (changed && iterations-- > 0) {\n          changed = false\n          for (const [name, value] of rootVars) {\n            if (!value.includes('var(')) continue\n            const resolved = resolveValue(value, rootVars, rootVars, propertyDefaults)\n            if (resolved !== value) {\n              rootVars.set(name, resolved)\n              changed = true\n            }\n          }\n        }\n      }\n\n      // Pass 2: resolve var() in all rules\n      root.walkRules((rule) => {\n        /**\n         * Skip :root inside @media — those vars are for dark mode etc. and\n         * must stay in the <style> tag as-is. Allow :root at top\n         * level and inside @layer (processed in pass 3).\n         */\n        if (isRootRule(rule)) {\n          if (rule.parent?.type !== 'root' && !isInLayer(rule)) return\n        }\n\n        // Collect local --* declarations (walk into nested @media etc.)\n        const localVars = new Map<string, string>()\n        const localDecls: Declaration[] = []\n        let hasVarRefs = false\n\n        rule.walk((node) => {\n          if (node.type !== 'decl') return\n\n          if (node.prop.startsWith('--')) {\n            localDecls.push(node)\n          } else if (node.value.includes('var(')) {\n            hasVarRefs = true\n          }\n        })\n\n        // Skip rules with no var() references and no local vars to clean up\n        if (!hasVarRefs && localDecls.length === 0) return\n\n        // Build local vars map — resolve values that reference other locals or :root\n        for (const decl of localDecls) {\n          const value = decl.value.includes('var(')\n            ? resolveValue(decl.value, localVars, rootVars, propertyDefaults)\n            : decl.value\n\n          localVars.set(decl.prop, value)\n        }\n\n        // Resolve var() in non-custom-property declarations (walk into nested @media etc.)\n        if (hasVarRefs) {\n          rule.walk((node) => {\n            if (node.type !== 'decl') return\n            if (node.prop.startsWith('--')) return\n            if (!node.value.includes('var(')) return\n\n            const resolved = resolveValue(node.value, localVars, rootVars, propertyDefaults)\n\n            if (resolved !== node.value) {\n              // Clean up: collapse whitespace, trim\n              const cleaned = resolved.replace(/  +/g, ' ').trim()\n\n              if (cleaned) {\n                node.value = cleaned\n              } else {\n                // Value resolved to empty — remove the declaration\n                node.remove()\n              }\n            }\n          })\n        }\n\n        // Remove local --* declarations (consumed or no longer needed)\n        for (const decl of localDecls) {\n          decl.remove()\n        }\n      })\n\n      // Remove @property rules (not supported in email clients)\n      root.walkAtRules('property', (rule) => {\n        rule.remove()\n      })\n\n      // Pass 3: drop now-empty :root rules (their vars were removed in pass 2)\n      root.walkRules((rule) => {\n        if (!isRootRule(rule)) return\n        if (rule.parent?.type !== 'root' && !isInLayer(rule)) return\n\n        if (rule.nodes?.length === 0) {\n          rule.remove()\n        }\n      })\n    },\n  }\n}\n\nexport const postcss = true\n"],"mappings":"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"}

package/dist/plugins/postcss/{tailwindCleanup.d.mts → tailwindCleanup.d.ts}

@@ -1,4 +1,4 @@
-import { MaizzleConfig } from "../../types/config.mjs";
+import { MaizzleConfig } from "../../types/config.js";
 import postcss from "postcss";
 
 //#region src/plugins/postcss/tailwindCleanup.d.ts
@@ -15,4 +15,4 @@ import postcss from "postcss";
 declare function tailwindCleanup(config: MaizzleConfig): postcss.Plugin[];
 //#endregion
 export { tailwindCleanup };
-//# sourceMappingURL=tailwindCleanup.d.mts.map
+//# sourceMappingURL=tailwindCleanup.d.ts.map

package/dist/plugins/postcss/tailwindCleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindCleanup.d.ts","names":[],"sources":["../../../src/plugins/postcss/tailwindCleanup.ts"],"mappings":";;;;;;AA0CA;;;;;;;;iBAAgB,eAAA,CAAgB,MAAA,EAAQ,aAAA,GAAgB,OAAA,CAAQ,MAAM"}

package/dist/plugins/postcss/{tailwindCleanup.mjs → tailwindCleanup.js}

@@ -49,7 +49,9 @@ function tailwindCleanup(config) {
 		{
 			postcssPlugin: "tailwind-cleanup-at-rules",
 			AtRule(rule) {
-				if (atRules.includes(rule.name)) rule.remove();
+				if (!atRules.includes(rule.name)) return;
+				if (rule.nodes?.length) rule.replaceWith(rule.nodes);
+				else rule.remove();
 			}
 		},
 		{
@@ -60,7 +62,7 @@ function tailwindCleanup(config) {
 		}
 	];
 }
-
 //#endregion
 export { tailwindCleanup };
-//# sourceMappingURL=tailwindCleanup.mjs.map
+
+//# sourceMappingURL=tailwindCleanup.js.map

package/dist/plugins/postcss/tailwindCleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindCleanup.js","names":[],"sources":["../../../src/plugins/postcss/tailwindCleanup.ts"],"sourcesContent":["import postcss from 'postcss'\nimport type { MaizzleConfig } from '../../types/config.ts'\n\nconst DEFAULT_SELECTORS = [':host', ':lang']\nconst DEFAULT_AT_RULES = ['layer', 'property']\n\n/**\n * Split a selector list on top-level commas only.\n *\n * Commas inside parenthesised groups like `:not(:is(:lang(ae), :lang(ar)))`\n * are not treated as selector separators.\n */\nfunction splitSelector(selector: string): string[] {\n  const parts: string[] = []\n  let depth = 0\n  let start = 0\n\n  for (let i = 0; i < selector.length; i++) {\n    const ch = selector[i]\n    if (ch === '(') depth++\n    else if (ch === ')') depth--\n    else if (ch === ',' && depth === 0) {\n      parts.push(selector.slice(start, i).trim())\n      start = i + 1\n    }\n  }\n\n  parts.push(selector.slice(start).trim())\n\n  return parts.filter(Boolean)\n}\n\n/**\n * Removes CSS rules whose every comma-separated selector part starts with\n * one of the configured prefixes (e.g. ':host', ':lang'). Rules with mixed\n * selectors have the unwanted parts stripped.\n *\n * Also removes entire at-rules by name (e.g. '@layer', '@property').\n *\n * Intended to clean up Tailwind's compiled output after lightningcss has\n * flattened all modern CSS syntax.\n */\nexport function tailwindCleanup(config: MaizzleConfig): postcss.Plugin[] {\n  const selectors: string[] = config.postcss?.removeSelectors ?? DEFAULT_SELECTORS\n  const atRules: string[] = config.postcss?.removeAtRules ?? DEFAULT_AT_RULES\n\n  return [\n    {\n      postcssPlugin: 'tailwind-cleanup-selectors',\n      Rule(rule) {\n        const parts = splitSelector(rule.selector)\n        const kept = parts.filter(p => !selectors.some(s => p === s || p.includes(`${s}(`)))\n        if (kept.length === 0) {\n          rule.remove()\n        } else if (kept.length < parts.length) {\n          rule.selector = kept.join(', ')\n        }\n      },\n    },\n    {\n      postcssPlugin: 'tailwind-cleanup-at-rules',\n      AtRule(rule) {\n        if (!atRules.includes(rule.name)) return\n\n        if (rule.nodes?.length) {\n          // Unwrap: keep children, remove the at-rule wrapper\n          rule.replaceWith(rule.nodes)\n        } else {\n          rule.remove()\n        }\n      },\n    },\n    {\n      postcssPlugin: 'tailwind-cleanup-text-decoration',\n      Declaration(decl) {\n        if (decl.prop === 'text-decoration-line') {\n          decl.prop = 'text-decoration'\n        }\n      },\n    },\n  ]\n}\n"],"mappings":";AAGA,MAAM,oBAAoB,CAAC,SAAS,OAAO;AAC3C,MAAM,mBAAmB,CAAC,SAAS,UAAU;;;;;;;AAQ7C,SAAS,cAAc,UAA4B;CACjD,MAAM,QAAkB,CAAC;CACzB,IAAI,QAAQ;CACZ,IAAI,QAAQ;CAEZ,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,KAAK,SAAS;EACpB,IAAI,OAAO,KAAK;OACX,IAAI,OAAO,KAAK;OAChB,IAAI,OAAO,OAAO,UAAU,GAAG;GAClC,MAAM,KAAK,SAAS,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;GAC1C,QAAQ,IAAI;EACd;CACF;CAEA,MAAM,KAAK,SAAS,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC;CAEvC,OAAO,MAAM,OAAO,OAAO;AAC7B;;;;;;;;;;;AAYA,SAAgB,gBAAgB,QAAyC;CACvE,MAAM,YAAsB,OAAO,SAAS,mBAAmB;CAC/D,MAAM,UAAoB,OAAO,SAAS,iBAAiB;CAE3D,OAAO;EACL;GACE,eAAe;GACf,KAAK,MAAM;IACT,MAAM,QAAQ,cAAc,KAAK,QAAQ;IACzC,MAAM,OAAO,MAAM,QAAO,MAAK,CAAC,UAAU,MAAK,MAAK,MAAM,KAAK,EAAE,SAAS,GAAG,EAAE,EAAE,CAAC,CAAC;IACnF,IAAI,KAAK,WAAW,GAClB,KAAK,OAAO;SACP,IAAI,KAAK,SAAS,MAAM,QAC7B,KAAK,WAAW,KAAK,KAAK,IAAI;GAElC;EACF;EACA;GACE,eAAe;GACf,OAAO,MAAM;IACX,IAAI,CAAC,QAAQ,SAAS,KAAK,IAAI,GAAG;IAElC,IAAI,KAAK,OAAO,QAEd,KAAK,YAAY,KAAK,KAAK;SAE3B,KAAK,OAAO;GAEhB;EACF;EACA;GACE,eAAe;GACf,YAAY,MAAM;IAChB,IAAI,KAAK,SAAS,wBAChB,KAAK,OAAO;GAEhB;EACF;CACF;AACF"}

package/dist/prepare.d.ts

@@ -0,0 +1,17 @@
+//#region src/prepare.d.ts
+interface PrepareOptions {
+  /** Path to a Maizzle config file. */
+  config?: string;
+}
+/**
+ * Generate IDE type definitions in `.maizzle/`
+ * (`auto-imports.d.ts` and `components.d.ts`).
+ *
+ * Intended as a `postinstall` step so editors get autocompletion before the
+ * user runs `dev` or `build`. Spins up the renderer with `dts: true`, runs
+ * a trivial render to trigger the unplugin scans, then shuts down.
+ */
+declare function prepare(options?: PrepareOptions): Promise<void>;
+//#endregion
+export { PrepareOptions, prepare };
+//# sourceMappingURL=prepare.d.ts.map

package/dist/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","names":[],"sources":["../src/prepare.ts"],"mappings":";UAOiB,cAAA;EAAA;EAEf,MAAM;AAAA;;AAAA;AAWR;;;;;;iBAAsB,OAAA,CAAQ,OAAA,GAAS,cAAA,GAAsB,OAAO"}

package/dist/prepare.js

@@ -0,0 +1,44 @@
+import { resolveConfig } from "./config/index.js";
+import { isLaravel } from "./utils/detect.js";
+import { normalizeComponentSources } from "./utils/componentSources.js";
+import { createRenderer } from "./render/createRenderer.js";
+import { relative, resolve } from "node:path";
+import ora from "ora";
+//#region src/prepare.ts
+/**
+* Generate IDE type definitions in `.maizzle/`
+* (`auto-imports.d.ts` and `components.d.ts`).
+*
+* Intended as a `postinstall` step so editors get autocompletion before the
+* user runs `dev` or `build`. Spins up the renderer with `dts: true`, runs
+* a trivial render to trigger the unplugin scans, then shuts down.
+*/
+async function prepare(options = {}) {
+	const spinner = ora({
+		text: "Generating types...",
+		spinner: "circleHalves"
+	}).start();
+	const config = await resolveConfig(options.config);
+	const renderer = await createRenderer({
+		dts: true,
+		markdown: config.markdown,
+		root: config.root,
+		componentDirs: normalizeComponentSources(config.components?.source, process.cwd()),
+		vite: config.vite
+	});
+	try {
+		await renderer.render("<template><div></div></template>", config);
+	} finally {
+		await renderer.close();
+	}
+	const dtsDir = isLaravel() ? resolve(process.cwd(), "resources/js/types/maizzle") : resolve(config.root ?? process.cwd(), ".maizzle");
+	const displayPath = relative(process.cwd(), dtsDir) || dtsDir;
+	spinner.stopAndPersist({
+		symbol: "✅",
+		text: `Types generated in ${displayPath}`
+	});
+}
+//#endregion
+export { prepare };
+
+//# sourceMappingURL=prepare.js.map

package/dist/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","names":[],"sources":["../src/prepare.ts"],"sourcesContent":["import { relative, resolve } from 'node:path'\nimport ora from 'ora'\nimport { resolveConfig } from './config/index.ts'\nimport { createRenderer } from './render/createRenderer.ts'\nimport { isLaravel } from './utils/detect.ts'\nimport { normalizeComponentSources } from './utils/componentSources.ts'\n\nexport interface PrepareOptions {\n  /** Path to a Maizzle config file. */\n  config?: string\n}\n\n/**\n * Generate IDE type definitions in `.maizzle/`\n * (`auto-imports.d.ts` and `components.d.ts`).\n *\n * Intended as a `postinstall` step so editors get autocompletion before the\n * user runs `dev` or `build`. Spins up the renderer with `dts: true`, runs\n * a trivial render to trigger the unplugin scans, then shuts down.\n */\nexport async function prepare(options: PrepareOptions = {}): Promise<void> {\n  const spinner = ora({ text: 'Generating types...', spinner: 'circleHalves' }).start()\n\n  const config = await resolveConfig(options.config)\n\n  const renderer = await createRenderer({\n    dts: true,\n    markdown: config.markdown,\n    root: config.root,\n    componentDirs: normalizeComponentSources(config.components?.source, process.cwd()),\n    vite: config.vite,\n  })\n\n  try {\n    await renderer.render('<template><div></div></template>', config)\n  } finally {\n    await renderer.close()\n  }\n\n  const dtsDir = isLaravel()\n    ? resolve(process.cwd(), 'resources/js/types/maizzle')\n    : resolve(config.root ?? process.cwd(), '.maizzle')\n  const displayPath = relative(process.cwd(), dtsDir) || dtsDir\n\n  spinner.stopAndPersist({\n    symbol: '✅',\n    text: `Types generated in ${displayPath}`,\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;AAoBA,eAAsB,QAAQ,UAA0B,CAAC,GAAkB;CACzE,MAAM,UAAU,IAAI;EAAE,MAAM;EAAuB,SAAS;CAAe,CAAC,CAAC,CAAC,MAAM;CAEpF,MAAM,SAAS,MAAM,cAAc,QAAQ,MAAM;CAEjD,MAAM,WAAW,MAAM,eAAe;EACpC,KAAK;EACL,UAAU,OAAO;EACjB,MAAM,OAAO;EACb,eAAe,0BAA0B,OAAO,YAAY,QAAQ,QAAQ,IAAI,CAAC;EACjF,MAAM,OAAO;CACf,CAAC;CAED,IAAI;EACF,MAAM,SAAS,OAAO,oCAAoC,MAAM;CAClE,UAAU;EACR,MAAM,SAAS,MAAM;CACvB;CAEA,MAAM,SAAS,UAAU,IACrB,QAAQ,QAAQ,IAAI,GAAG,4BAA4B,IACnD,QAAQ,OAAO,QAAQ,QAAQ,IAAI,GAAG,UAAU;CACpD,MAAM,cAAc,SAAS,QAAQ,IAAI,GAAG,MAAM,KAAK;CAEvD,QAAQ,eAAe;EACrB,QAAQ;EACR,MAAM,sBAAsB;CAC9B,CAAC;AACH"}

package/dist/render/active.d.ts

@@ -0,0 +1,8 @@
+import { Renderer } from "./createRenderer.js";
+
+//#region src/render/active.d.ts
+declare function setActiveRenderer(renderer: Renderer | null): void;
+declare function getActiveRenderer(): Renderer | null;
+//#endregion
+export { getActiveRenderer, setActiveRenderer };
+//# sourceMappingURL=active.d.ts.map

package/dist/render/active.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active.d.ts","names":[],"sources":["../../src/render/active.ts"],"mappings":";;;iBAIgB,iBAAA,CAAkB,QAAyB,EAAf,QAAQ;AAAA,iBAIpC,iBAAA,IAAqB,QAAQ"}

package/dist/render/active.js

@@ -0,0 +1,12 @@
+//#region src/render/active.ts
+let activeRenderer = null;
+function setActiveRenderer(renderer) {
+	activeRenderer = renderer;
+}
+function getActiveRenderer() {
+	return activeRenderer;
+}
+//#endregion
+export { getActiveRenderer, setActiveRenderer };
+
+//# sourceMappingURL=active.js.map

package/dist/render/active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active.js","names":[],"sources":["../../src/render/active.ts"],"sourcesContent":["import type { Renderer } from './createRenderer.ts'\n\nlet activeRenderer: Renderer | null = null\n\nexport function setActiveRenderer(renderer: Renderer | null): void {\n  activeRenderer = renderer\n}\n\nexport function getActiveRenderer(): Renderer | null {\n  return activeRenderer\n}\n"],"mappings":";AAEA,IAAI,iBAAkC;AAEtC,SAAgB,kBAAkB,UAAiC;CACjE,iBAAiB;AACnB;AAEA,SAAgB,oBAAqC;CACnD,OAAO;AACT"}

package/dist/render/buildTemplate.d.ts

@@ -0,0 +1,49 @@
+import { EventManager } from "../events/index.js";
+import { MaizzleConfig } from "../types/config.js";
+import { Renderer } from "./createRenderer.js";
+
+//#region src/render/buildTemplate.d.ts
+interface BuildTemplateContext {
+  config: MaizzleConfig;
+  renderer: Renderer;
+  events: EventManager;
+  outputPath: string;
+  outputExtension: string;
+  contentBase: string;
+}
+interface BuildTemplateResult {
+  /** Output files written for this template (html + optional plaintext). */
+  files: string[];
+  /**
+   * Number of SFC-registered `afterBuild` handlers seen while rendering. They
+   * only fire once at end of build on the main thread, so a worker can't run
+   * them — the count lets the orchestrator warn instead of silently dropping.
+   */
+  sfcAfterBuildCount: number;
+}
+/**
+ * Render a single template through the full pipeline and write its output.
+ *
+ * Shared by the sequential build loop and the parallel build worker so both
+ * paths produce byte-identical output. `events` is the manager the per-template
+ * events fire on (config handlers registered via `registerConfig`, SFC handlers
+ * registered here from the render). The caller owns build-scoped events
+ * (`beforeCreate`/`afterBuild`).
+ */
+declare function buildTemplate(templatePath: string, ctx: BuildTemplateContext): Promise<BuildTemplateResult>;
+/**
+ * Extract the static (non-glob) prefix from content patterns.
+ *
+ * For example, `['/abs/path/emails/**\/*.vue']` → `'/abs/path/emails'`
+ *
+ * Used to strip the content base from template paths so the output preserves
+ * only the subdirectory structure.
+ *
+ * With multiple positive patterns (multi-root setups), returns their common
+ * ancestor directory so templates from every root keep a clean relative path.
+ */
+declare function computeContentBase(patterns: string[]): string;
+declare function resolveOutputPath(templatePath: string, outputDir: string, extension: string, contentBase: string): string;
+//#endregion
+export { BuildTemplateContext, BuildTemplateResult, buildTemplate, computeContentBase, resolveOutputPath };
+//# sourceMappingURL=buildTemplate.d.ts.map

package/dist/render/buildTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTemplate.d.ts","names":[],"sources":["../../src/render/buildTemplate.ts"],"mappings":";;;;;UAYiB,oBAAA;EACf,MAAA,EAAQ,aAAA;EACR,QAAA,EAAU,QAAA;EACV,MAAA,EAAQ,YAAA;EACR,UAAA;EACA,eAAA;EACA,WAAA;AAAA;AAAA,UAGe,mBAAA;EANK;EAQpB,KAAA;EAVA;;;;;EAgBA,kBAAkB;AAAA;;;;AAXP;AAGb;;;;AAQoB;iBAYE,aAAA,CACpB,YAAA,UACA,GAAA,EAAK,oBAAA,GACJ,OAAA,CAAQ,mBAAA;;;;;;;;;;;;iBAiHK,kBAAA,CAAmB,QAAkB;AAAA,iBA4BrC,iBAAA,CAAkB,YAAA,UAAsB,SAAA,UAAmB,SAAA,UAAmB,WAAA"}

package/dist/render/buildTemplate.js

@@ -0,0 +1,141 @@
+import { runTransformers } from "../transformers/index.js";
+import { createPlaintext } from "../plaintext.js";
+import { stripForHtml, stripForPlaintext } from "../utils/output-markers.js";
+import { _setCurrentTemplate } from "../composables/useCurrentTemplate.js";
+import { cloneConfig } from "../utils/cloneConfig.js";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, parse, relative, resolve, sep } from "node:path";
+import defu from "defu";
+//#region src/render/buildTemplate.ts
+/**
+* Render a single template through the full pipeline and write its output.
+*
+* Shared by the sequential build loop and the parallel build worker so both
+* paths produce byte-identical output. `events` is the manager the per-template
+* events fire on (config handlers registered via `registerConfig`, SFC handlers
+* registered here from the render). The caller owns build-scoped events
+* (`beforeCreate`/`afterBuild`).
+*/
+async function buildTemplate(templatePath, ctx) {
+	const { config, renderer, events, outputPath, outputExtension, contentBase } = ctx;
+	const absolutePath = resolve(templatePath);
+	const parsedPath = parse(absolutePath);
+	const template = {
+		source: readFileSync(absolutePath, "utf-8"),
+		path: parsedPath
+	};
+	const files = [];
+	let sfcAfterBuildCount = 0;
+	_setCurrentTemplate(parsedPath);
+	try {
+		/**
+		* Clone config per template so beforeRender mutations (setting a
+		* preheader, injecting fetched data, etc.) stay scoped to this template
+		* instead of leaking into later ones through the shared config object.
+		*/
+		const renderConfig = cloneConfig(config);
+		const originalSource = template.source;
+		await events.fireBeforeRender({
+			config: renderConfig,
+			template
+		});
+		const rendered = await renderer.render(absolutePath, renderConfig, template.source !== originalSource ? { source: template.source } : void 0);
+		/**
+		* Register SFC event handlers collected during render so they take part in
+		* the post-render events. Cleared at the end of this call so they don't
+		* leak into the next template (afterBuild is the exception — it's never
+		* cleared by clearSfcHandlers; see the count above).
+		*/
+		for (const { name, handler } of rendered.sfcEventHandlers) {
+			if (name === "afterBuild") sfcAfterBuildCount++;
+			events.on(name, handler);
+		}
+		const templateConfig = rendered.templateConfig;
+		let html = await events.fireAfterRender({
+			config: templateConfig,
+			template,
+			html: rendered.html
+		});
+		const doctype = rendered.doctype ?? templateConfig.doctype ?? "<!DOCTYPE html>";
+		if (templateConfig.useTransformers !== false) html = await runTransformers(html, templateConfig, absolutePath, doctype, rendered.tailwindBlocks);
+		html = await events.fireAfterTransform({
+			config: templateConfig,
+			template,
+			html
+		});
+		if (doctype) html = `${doctype}\n${html}`;
+		const htmlOut = stripForHtml(html);
+		const sfcOutputPath = rendered.outputPath;
+		let outputFilePath;
+		if (sfcOutputPath) {
+			const parsed = parse(resolve(sfcOutputPath));
+			const ext = parsed.ext ? parsed.ext.slice(1) : outputExtension;
+			outputFilePath = join(parsed.dir, `${parsed.name}.${ext}`);
+		} else outputFilePath = resolveOutputPath(templatePath, outputPath, outputExtension, contentBase);
+		mkdirSync(dirname(outputFilePath), { recursive: true });
+		writeFileSync(outputFilePath, htmlOut);
+		files.push(outputFilePath);
+		const globalPlaintext = templateConfig.plaintext;
+		const sfcPlaintext = rendered.plaintext;
+		if (globalPlaintext || sfcPlaintext) {
+			const globalCfg = typeof globalPlaintext === "object" ? globalPlaintext : {};
+			const stripOptions = defu(sfcPlaintext?.options, globalCfg.options);
+			const plaintext = createPlaintext(stripForPlaintext(html), stripOptions);
+			const ptExtension = sfcPlaintext?.extension ?? globalCfg.extension ?? "txt";
+			let ptOutputPath;
+			if (sfcPlaintext?.destination) ptOutputPath = resolveOutputPath(templatePath, resolve(sfcPlaintext.destination), ptExtension, contentBase);
+			else if (sfcOutputPath) {
+				const parsed = parse(outputFilePath);
+				ptOutputPath = join(parsed.dir, `${parsed.name}.${ptExtension}`);
+			} else if (globalCfg.destination) ptOutputPath = resolveOutputPath(templatePath, resolve(globalCfg.destination), ptExtension, contentBase);
+			else ptOutputPath = resolveOutputPath(templatePath, outputPath, ptExtension, contentBase);
+			mkdirSync(dirname(ptOutputPath), { recursive: true });
+			writeFileSync(ptOutputPath, plaintext);
+			files.push(ptOutputPath);
+		}
+	} finally {
+		_setCurrentTemplate(void 0);
+		events.clearSfcHandlers();
+	}
+	return {
+		files,
+		sfcAfterBuildCount
+	};
+}
+/**
+* Extract the static (non-glob) prefix from content patterns.
+*
+* For example, `['/abs/path/emails/**\/*.vue']` → `'/abs/path/emails'`
+*
+* Used to strip the content base from template paths so the output preserves
+* only the subdirectory structure.
+*
+* With multiple positive patterns (multi-root setups), returns their common
+* ancestor directory so templates from every root keep a clean relative path.
+*/
+function computeContentBase(patterns) {
+	const positives = patterns.filter((p) => !p.startsWith("!"));
+	return (positives.length > 0 ? positives : patterns).map((pattern) => {
+		const staticPart = pattern.split(/[*{?[]/)[0];
+		return resolve(staticPart.endsWith("/") ? staticPart : dirname(staticPart));
+	}).reduce(commonPath);
+}
+/** Longest common directory path shared by two absolute paths. */
+function commonPath(a, b) {
+	const aSegments = a.split(sep);
+	const bSegments = b.split(sep);
+	const shared = [];
+	for (let i = 0; i < Math.min(aSegments.length, bSegments.length); i++) {
+		if (aSegments[i] !== bSegments[i]) break;
+		shared.push(aSegments[i]);
+	}
+	return shared.join(sep) || sep;
+}
+function resolveOutputPath(templatePath, outputDir, extension, contentBase) {
+	const name = basename(templatePath).replace(/\.(vue|md)$/, "");
+	return join(outputDir, relative(contentBase, dirname(resolve(templatePath))), `${name}.${extension}`);
+}
+//#endregion
+export { buildTemplate, computeContentBase, resolveOutputPath };
+
+//# sourceMappingURL=buildTemplate.js.map