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

package/dist/composables/renderContext.d.ts

@@ -0,0 +1,37 @@
+import { MaizzleConfig } from "../types/config.js";
+import { EventMap, EventName } from "../events/index.js";
+import { UsePlaintextOptions } from "./usePlaintext.js";
+import { InjectionKey } from "vue";
+
+//#region src/composables/renderContext.d.ts
+interface FontRegistration {
+  family: string;
+  slug: string;
+  declaration: string;
+  url: string;
+}
+interface TailwindBlock {
+  id: string;
+  /** Optional raw CSS from the component's `#config` slot. */
+  css?: string;
+}
+interface RenderContext {
+  doctype?: string;
+  preheader?: {
+    text: string;
+    fillerCount: number;
+    shyCount: number;
+  };
+  sfcConfig?: MaizzleConfig;
+  sfcEventHandlers: Array<{
+    name: EventName;
+    handler: EventMap[EventName];
+  }>;
+  plaintext?: UsePlaintextOptions;
+  fonts?: FontRegistration[];
+  tailwindBlocks?: TailwindBlock[];
+}
+declare const RenderContextKey: InjectionKey<RenderContext>;
+//#endregion
+export { FontRegistration, RenderContext, RenderContextKey, TailwindBlock };
+//# sourceMappingURL=renderContext.d.ts.map

package/dist/composables/renderContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderContext.d.ts","names":[],"sources":["../../src/composables/renderContext.ts"],"mappings":";;;;;;UAKiB,gBAAA;EACf,MAAA;EACA,IAAA;EACA,WAAA;EACA,GAAA;AAAA;AAAA,UAGe,aAAA;EACf,EAAA;EANA;EAQA,GAAA;AAAA;AAAA,UAGe,aAAA;EACf,OAAA;EACA,SAAA;IAAc,IAAA;IAAc,WAAA;IAAqB,QAAA;EAAA;EACjD,SAAA,GAAY,aAAA;EACZ,gBAAA,EAAkB,KAAA;IAAQ,IAAA,EAAM,SAAA;IAAW,OAAA,EAAS,QAAA,CAAS,SAAA;EAAA;EAC7D,SAAA,GAAY,mBAAA;EACZ,KAAA,GAAQ,gBAAA;EACR,cAAA,GAAiB,aAAA;AAAA;AAAA,cAGN,gBAAA,EAAkB,YAAA,CAAa,aAAA"}

package/dist/composables/{renderContext.mjs → renderContext.js}

@@ -1,6 +1,6 @@
 //#region src/composables/renderContext.ts
 const RenderContextKey = Symbol("RenderContext");
-
 //#endregion
 export { RenderContextKey };
-//# sourceMappingURL=renderContext.mjs.map
+
+//# sourceMappingURL=renderContext.js.map

package/dist/composables/renderContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderContext.js","names":[],"sources":["../../src/composables/renderContext.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { MaizzleConfig } from '../types/index.ts'\nimport type { EventName, EventMap } from '../events/index.ts'\nimport type { UsePlaintextOptions } from './usePlaintext.ts'\n\nexport interface FontRegistration {\n  family: string\n  slug: string\n  declaration: string\n  url: string\n}\n\nexport interface TailwindBlock {\n  id: string\n  /** Optional raw CSS from the component's `#config` slot. */\n  css?: string\n}\n\nexport interface RenderContext {\n  doctype?: string\n  preheader?: { text: string; fillerCount: number; shyCount: number }\n  sfcConfig?: MaizzleConfig\n  sfcEventHandlers: Array<{ name: EventName; handler: EventMap[EventName] }>\n  plaintext?: UsePlaintextOptions\n  fonts?: FontRegistration[]\n  tailwindBlocks?: TailwindBlock[]\n}\n\nexport const RenderContextKey: InjectionKey<RenderContext> = Symbol('RenderContext')\n"],"mappings":";AA4BA,MAAa,mBAAgD,OAAO,gBAAgB"}

package/dist/composables/useBaseUrl.d.ts

@@ -0,0 +1,19 @@
+import { UrlConfig } from "../types/config.js";
+//#region src/composables/useBaseUrl.d.ts
+/**
+ * Set the base URL for the current email template — same as
+ * `config.url.base`, scoped to one SFC.
+ *
+ * Pass a string to prepend to all default tags/attributes, or an object
+ * for fine-grained control (which tags/attributes, style tags, etc.).
+ *
+ * Usage in SFC <script setup>:
+ * ```ts
+ * useBaseUrl('https://cdn.example.com/emails/')
+ * useBaseUrl({ url: 'https://cdn.example.com/', styleTag: true })
+ * ```
+ */
+declare function useBaseUrl(value: UrlConfig['base']): void;
+//#endregion
+export { useBaseUrl };
+//# sourceMappingURL=useBaseUrl.d.ts.map

package/dist/composables/useBaseUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBaseUrl.d.ts","names":[],"sources":["../../src/composables/useBaseUrl.ts"],"mappings":";;;;;AAkBA;;;;;;;;;;iBAAgB,UAAA,CAAW,KAAA,EAAO,SAAA"}

package/dist/composables/useBaseUrl.js

@@ -0,0 +1,26 @@
+import { RenderContextKey } from "./renderContext.js";
+import { defu as defu$1 } from "defu";
+import { inject } from "vue";
+//#region src/composables/useBaseUrl.ts
+/**
+* Set the base URL for the current email template — same as
+* `config.url.base`, scoped to one SFC.
+*
+* Pass a string to prepend to all default tags/attributes, or an object
+* for fine-grained control (which tags/attributes, style tags, etc.).
+*
+* Usage in SFC <script setup>:
+* ```ts
+* useBaseUrl('https://cdn.example.com/emails/')
+* useBaseUrl({ url: 'https://cdn.example.com/', styleTag: true })
+* ```
+*/
+function useBaseUrl(value) {
+	const ctx = inject(RenderContextKey);
+	if (!ctx) return;
+	ctx.sfcConfig = defu$1({ url: { base: value } }, ctx.sfcConfig ?? {});
+}
+//#endregion
+export { useBaseUrl };
+
+//# sourceMappingURL=useBaseUrl.js.map

package/dist/composables/useBaseUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBaseUrl.js","names":["merge"],"sources":["../../src/composables/useBaseUrl.ts"],"sourcesContent":["import { inject } from 'vue'\nimport { defu as merge } from 'defu'\nimport { RenderContextKey } from './renderContext.ts'\nimport type { UrlConfig } from '../types/index.ts'\n\n/**\n * Set the base URL for the current email template — same as\n * `config.url.base`, scoped to one SFC.\n *\n * Pass a string to prepend to all default tags/attributes, or an object\n * for fine-grained control (which tags/attributes, style tags, etc.).\n *\n * Usage in SFC <script setup>:\n * ```ts\n * useBaseUrl('https://cdn.example.com/emails/')\n * useBaseUrl({ url: 'https://cdn.example.com/', styleTag: true })\n * ```\n */\nexport function useBaseUrl(value: UrlConfig['base']): void {\n  const ctx = inject(RenderContextKey)\n  if (!ctx) return\n  ctx.sfcConfig = merge({ url: { base: value } }, ctx.sfcConfig ?? {})\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,SAAgB,WAAW,OAAgC;CACzD,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,CAAC,KAAK;CACV,IAAI,YAAYA,OAAM,EAAE,KAAK,EAAE,MAAM,OAAO,EAAE,EAAE,IAAI,aAAa,EAAE,CAAC"}

package/dist/composables/{useConfig.d.mts → useConfig.d.ts}

@@ -1,4 +1,4 @@
-import { MaizzleConfig } from "../types/config.mjs";
+import { MaizzleConfig } from "../types/config.js";
 import { InjectionKey } from "vue";
 
 //#region src/composables/useConfig.d.ts
@@ -6,4 +6,4 @@ declare const MaizzleConfigKey: InjectionKey<MaizzleConfig>;
 declare function useConfig(): MaizzleConfig;
 //#endregion
 export { MaizzleConfigKey, useConfig };
-//# sourceMappingURL=useConfig.d.mts.map
+//# sourceMappingURL=useConfig.d.ts.map

package/dist/composables/useConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConfig.d.ts","names":[],"sources":["../../src/composables/useConfig.ts"],"mappings":";;;;cAIa,gBAAA,EAAkB,YAAA,CAAa,aAAA;AAAA,iBAE5B,SAAA,CAAA,GAAa,aAAA"}

package/dist/composables/{useConfig.mjs → useConfig.js}

@@ -1,5 +1,4 @@
 import { inject } from "vue";
-
 //#region src/composables/useConfig.ts
 const MaizzleConfigKey = Symbol("MaizzleConfig");
 function useConfig() {
@@ -7,7 +6,7 @@ function useConfig() {
 	if (!config) throw new Error("useConfig() requires the Maizzle plugin to provide config. Make sure you are using it inside a Maizzle template.");
 	return config;
 }
-
 //#endregion
 export { MaizzleConfigKey, useConfig };
-//# sourceMappingURL=useConfig.mjs.map
+
+//# sourceMappingURL=useConfig.js.map

package/dist/composables/useConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConfig.js","names":[],"sources":["../../src/composables/useConfig.ts"],"sourcesContent":["import { inject } from 'vue'\nimport type { InjectionKey } from 'vue'\nimport type { MaizzleConfig } from '../types/index.ts'\n\nexport const MaizzleConfigKey: InjectionKey<MaizzleConfig> = Symbol('MaizzleConfig')\n\nexport function useConfig(): MaizzleConfig {\n  const config = inject(MaizzleConfigKey)\n\n  if (!config) {\n    throw new Error('useConfig() requires the Maizzle plugin to provide config. Make sure you are using it inside a Maizzle template.')\n  }\n\n  return config\n}\n"],"mappings":";;AAIA,MAAa,mBAAgD,OAAO,gBAAgB;AAEpF,SAAgB,YAA2B;CACzC,MAAM,SAAS,OAAO,iBAAiB;CAEvC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,mHAAmH;CAGrI,OAAO"}

package/dist/composables/{useDoctype.d.mts → useDoctype.d.ts}

@@ -10,4 +10,4 @@
 declare function useDoctype(doctype: string): void;
 //#endregion
 export { useDoctype };
-//# sourceMappingURL=useDoctype.d.mts.map
+//# sourceMappingURL=useDoctype.d.ts.map

package/dist/composables/useDoctype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDoctype.d.ts","names":[],"sources":["../../src/composables/useDoctype.ts"],"mappings":";;AAWA;;;;;;;iBAAgB,UAAA,CAAW,OAAA"}

package/dist/composables/{useDoctype.mjs → useDoctype.js}

@@ -1,6 +1,5 @@
-import { RenderContextKey } from "./renderContext.mjs";
+import { RenderContextKey } from "./renderContext.js";
 import { inject } from "vue";
-
 //#region src/composables/useDoctype.ts
 /**
 * Set the doctype for the current email template.
@@ -14,7 +13,7 @@ function useDoctype(doctype) {
 	const ctx = inject(RenderContextKey);
 	if (ctx) ctx.doctype = doctype;
 }
-
 //#endregion
 export { useDoctype };
-//# sourceMappingURL=useDoctype.mjs.map
+
+//# sourceMappingURL=useDoctype.js.map

package/dist/composables/useDoctype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDoctype.js","names":[],"sources":["../../src/composables/useDoctype.ts"],"sourcesContent":["import { inject } from 'vue'\nimport { RenderContextKey } from './renderContext.ts'\n\n/**\n * Set the doctype for the current email template.\n *\n * Usage in SFC <script setup>:\n * ```ts\n * useDoctype('<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">')\n * ```\n */\nexport function useDoctype(doctype: string): void {\n  const ctx = inject(RenderContextKey)\n  if (ctx) ctx.doctype = doctype\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,WAAW,SAAuB;CAChD,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,KAAK,IAAI,UAAU"}

package/dist/composables/{useEvent.d.mts → useEvent.d.ts}

@@ -1,4 +1,4 @@
-import { EventMap, EventName } from "../events/index.mjs";
+import { EventMap, EventName } from "../events/index.js";
 
 //#region src/composables/useEvent.d.ts
 /**
@@ -14,4 +14,4 @@ import { EventMap, EventName } from "../events/index.mjs";
 declare function useEvent<K extends EventName>(name: K, handler: EventMap[K]): void;
 //#endregion
 export { useEvent };
-//# sourceMappingURL=useEvent.d.mts.map
+//# sourceMappingURL=useEvent.d.ts.map

package/dist/composables/useEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEvent.d.ts","names":[],"sources":["../../src/composables/useEvent.ts"],"mappings":";;;;;AAcA;;;;;;;;iBAAgB,QAAA,WAAmB,SAAA,CAAA,CAAW,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,QAAA,CAAS,CAAA"}

package/dist/composables/{useEvent.mjs → useEvent.js}

@@ -1,6 +1,5 @@
-import { RenderContextKey } from "./renderContext.mjs";
+import { RenderContextKey } from "./renderContext.js";
 import { inject } from "vue";
-
 //#region src/composables/useEvent.ts
 /**
 * Register an event handler from within an SFC's <script setup>.
@@ -19,7 +18,7 @@ function useEvent(name, handler) {
 		handler
 	});
 }
-
 //#endregion
 export { useEvent };
-//# sourceMappingURL=useEvent.mjs.map
+
+//# sourceMappingURL=useEvent.js.map

package/dist/composables/useEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEvent.js","names":[],"sources":["../../src/composables/useEvent.ts"],"sourcesContent":["import { inject } from 'vue'\nimport { RenderContextKey } from './renderContext.ts'\nimport type { EventName, EventMap } from '../events/index.ts'\n\n/**\n * Register an event handler from within an SFC's <script setup>.\n *\n * Usage:\n * ```ts\n * useEvent('beforeRender', ({ config, template }) => {\n *   return template.replace('foo', 'bar')\n * })\n * ```\n */\nexport function useEvent<K extends EventName>(name: K, handler: EventMap[K]) {\n  const ctx = inject(RenderContextKey)\n  if (ctx) ctx.sfcEventHandlers.push({ name, handler })\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,SAA8B,MAAS,SAAsB;CAC3E,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,KAAK,IAAI,iBAAiB,KAAK;EAAE;EAAM;EAAS,CAAC"}

package/dist/composables/useFont.d.ts

@@ -0,0 +1,50 @@
+//#region src/composables/useFont.d.ts
+type FontProvider = 'google' | 'bunny';
+interface UseFontOptions {
+  /**
+   * A single font family name, e.g. `"Roboto"` or `"Open Sans"`.
+   *
+   * For fallback fonts, use the `fallback` option instead of a
+   * comma-separated list here.
+   */
+  family: string;
+  /** CSS fallback list appended to the `font-family` declaration. */
+  fallback?: string;
+  /**
+   * Font provider used to build the stylesheet URL when `url` is omitted.
+   * Bunny Fonts is a drop-in, privacy-friendly Google Fonts mirror.
+   * @default 'google'
+   */
+  provider?: FontProvider;
+  /**
+   * Stylesheet URL. When provided, used as-is for the `<link href>`.
+   * When omitted, a URL is built from `provider`, `family`, `weights`,
+   * `display` and `styles`.
+   */
+  url?: string;
+  /** Font weights to load. Ignored when `url` is provided. */
+  weights?: number[];
+  /** `font-display` value. Ignored when `url` is provided. */
+  display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
+  /** Font styles to load. Ignored when `url` is provided. */
+  styles?: Array<'normal' | 'italic'>;
+}
+/**
+ * Register a font for the current email template.
+ *
+ * Builds a Google Fonts stylesheet URL from `family`/`weights`/`display`/`styles`
+ * (or uses `url` as-is). The renderer injects a `<link>` tag into `<head>`
+ * and merges `--font-{slug}` declarations into the template's existing
+ * `@import "tailwindcss"` style block so a `font-{slug}` utility class
+ * is generated. If no Tailwind import is found, falls back to a `:root`
+ * declaration so the CSS variable is still available.
+ *
+ * Usage in SFC <script setup>:
+ * ```ts
+ * useFont({ family: 'Roboto', fallback: 'Verdana, sans-serif', weights: [400, 600] })
+ * ```
+ */
+declare function useFont(options: UseFontOptions): void;
+//#endregion
+export { FontProvider, UseFontOptions, useFont };
+//# sourceMappingURL=useFont.d.ts.map

package/dist/composables/useFont.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFont.d.ts","names":[],"sources":["../../src/composables/useFont.ts"],"mappings":";KA8CY,YAAA;AAAA,UAEK,cAAA;EAFO;;;;AAExB;;EAOE,MAAA;EAoBc;EAlBd,QAAA;EAAA;;;;;EAMA,QAAA,GAAW,YAAA;EAYX;;;;AA+CF;EArDE,GAAA;;EAEA,OAAA;EAmD6C;EAjD7C,OAAA;;EAEA,MAAA,GAAS,KAAA;AAAA;;;;;;;;;;;;;;;;iBA+CK,OAAA,CAAQ,OAAA,EAAS,cAAA"}

package/dist/composables/useFont.js

@@ -0,0 +1,92 @@
+import { RenderContextKey } from "./renderContext.js";
+import { inject } from "vue";
+//#region src/composables/useFont.ts
+const FAMILY_CATEGORIES = {
+	"Roboto": "sans",
+	"Open Sans": "sans",
+	"Inter": "sans",
+	"Lato": "sans",
+	"Montserrat": "sans",
+	"Merriweather": "serif",
+	"Playfair Display": "serif",
+	"Lora": "serif",
+	"PT Serif": "serif",
+	"Noto Serif": "serif",
+	"Oswald": "display",
+	"Bebas Neue": "display",
+	"Anton": "display",
+	"Lobster": "display",
+	"Pacifico": "display",
+	"Dancing Script": "handwriting",
+	"Caveat": "handwriting",
+	"Shadows Into Light": "handwriting",
+	"Satisfy": "handwriting",
+	"Great Vibes": "handwriting",
+	"Roboto Mono": "mono",
+	"Source Code Pro": "mono",
+	"JetBrains Mono": "mono",
+	"Fira Code": "mono",
+	"Inconsolata": "mono"
+};
+const DEFAULT_FALLBACKS = {
+	sans: "ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", sans-serif",
+	serif: "ui-serif, Georgia, Cambria, \"Times New Roman\", Times, serif",
+	mono: "ui-monospace, Menlo, Consolas, monospace",
+	display: "Impact, \"Arial Black\", system-ui, sans-serif",
+	handwriting: "\"Segoe Script\", \"Brush Script MT\", cursive"
+};
+const PROVIDER_BASE_URL = {
+	google: "https://fonts.googleapis.com/css2",
+	bunny: "https://fonts.bunny.net/css2"
+};
+function slugify(family) {
+	return family.trim().toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+}
+function buildProviderUrl(opts) {
+	const familyParam = opts.family.trim().replace(/\s+/g, "+");
+	const weights = [...opts.weights].sort((a, b) => a - b);
+	const hasItalic = opts.styles.includes("italic");
+	const hasNormal = opts.styles.includes("normal");
+	const axis = hasItalic ? `:ital,wght@${weights.flatMap((w) => [...hasNormal ? [`0,${w}`] : [], `1,${w}`]).join(";")}` : `:wght@${weights.join(";")}`;
+	return `${PROVIDER_BASE_URL[opts.provider]}?family=${familyParam}${axis}&display=${opts.display}`;
+}
+/**
+* Register a font for the current email template.
+*
+* Builds a Google Fonts stylesheet URL from `family`/`weights`/`display`/`styles`
+* (or uses `url` as-is). The renderer injects a `<link>` tag into `<head>`
+* and merges `--font-{slug}` declarations into the template's existing
+* `@import "tailwindcss"` style block so a `font-{slug}` utility class
+* is generated. If no Tailwind import is found, falls back to a `:root`
+* declaration so the CSS variable is still available.
+*
+* Usage in SFC <script setup>:
+* ```ts
+* useFont({ family: 'Roboto', fallback: 'Verdana, sans-serif', weights: [400, 600] })
+* ```
+*/
+function useFont(options) {
+	const ctx = inject(RenderContextKey);
+	if (!ctx) return;
+	ctx.fonts = ctx.fonts ?? [];
+	if (ctx.fonts.some((f) => f.family === options.family)) return;
+	const url = options.url ?? buildProviderUrl({
+		family: options.family,
+		provider: options.provider ?? "google",
+		weights: options.weights ?? [400],
+		display: options.display ?? "swap",
+		styles: options.styles ?? ["normal"]
+	});
+	const fallback = options.fallback ?? DEFAULT_FALLBACKS[FAMILY_CATEGORIES[options.family] ?? "sans"];
+	const declaration = `${/\s/.test(options.family) ? `"${options.family}"` : options.family}, ${fallback}`;
+	ctx.fonts.push({
+		family: options.family,
+		slug: slugify(options.family),
+		declaration,
+		url
+	});
+}
+//#endregion
+export { useFont };
+
+//# sourceMappingURL=useFont.js.map

package/dist/composables/useFont.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFont.js","names":[],"sources":["../../src/composables/useFont.ts"],"sourcesContent":["import { inject } from 'vue'\nimport { RenderContextKey } from './renderContext.ts'\n\ntype FontCategory = 'sans' | 'serif' | 'mono' | 'display' | 'handwriting'\n\nconst FAMILY_CATEGORIES: Record<string, FontCategory> = {\n  // Sans-serif\n  'Roboto': 'sans',\n  'Open Sans': 'sans',\n  'Inter': 'sans',\n  'Lato': 'sans',\n  'Montserrat': 'sans',\n  // Serif\n  'Merriweather': 'serif',\n  'Playfair Display': 'serif',\n  'Lora': 'serif',\n  'PT Serif': 'serif',\n  'Noto Serif': 'serif',\n  // Display\n  'Oswald': 'display',\n  'Bebas Neue': 'display',\n  'Anton': 'display',\n  'Lobster': 'display',\n  'Pacifico': 'display',\n  // Handwriting\n  'Dancing Script': 'handwriting',\n  'Caveat': 'handwriting',\n  'Shadows Into Light': 'handwriting',\n  'Satisfy': 'handwriting',\n  'Great Vibes': 'handwriting',\n  // Monospace\n  'Roboto Mono': 'mono',\n  'Source Code Pro': 'mono',\n  'JetBrains Mono': 'mono',\n  'Fira Code': 'mono',\n  'Inconsolata': 'mono',\n}\n\nconst DEFAULT_FALLBACKS: Record<FontCategory, string> = {\n  sans: 'ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", sans-serif',\n  serif: 'ui-serif, Georgia, Cambria, \"Times New Roman\", Times, serif',\n  mono: 'ui-monospace, Menlo, Consolas, monospace',\n  display: 'Impact, \"Arial Black\", system-ui, sans-serif',\n  handwriting: '\"Segoe Script\", \"Brush Script MT\", cursive',\n}\n\nexport type FontProvider = 'google' | 'bunny'\n\nexport interface UseFontOptions {\n  /**\n   * A single font family name, e.g. `\"Roboto\"` or `\"Open Sans\"`.\n   *\n   * For fallback fonts, use the `fallback` option instead of a\n   * comma-separated list here.\n   */\n  family: string\n  /** CSS fallback list appended to the `font-family` declaration. */\n  fallback?: string\n  /**\n   * Font provider used to build the stylesheet URL when `url` is omitted.\n   * Bunny Fonts is a drop-in, privacy-friendly Google Fonts mirror.\n   * @default 'google'\n   */\n  provider?: FontProvider\n  /**\n   * Stylesheet URL. When provided, used as-is for the `<link href>`.\n   * When omitted, a URL is built from `provider`, `family`, `weights`,\n   * `display` and `styles`.\n   */\n  url?: string\n  /** Font weights to load. Ignored when `url` is provided. */\n  weights?: number[]\n  /** `font-display` value. Ignored when `url` is provided. */\n  display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional'\n  /** Font styles to load. Ignored when `url` is provided. */\n  styles?: Array<'normal' | 'italic'>\n}\n\nconst PROVIDER_BASE_URL: Record<FontProvider, string> = {\n  google: 'https://fonts.googleapis.com/css2',\n  bunny: 'https://fonts.bunny.net/css2',\n}\n\nfunction slugify(family: string): string {\n  return family\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, '-')\n    .replace(/[^a-z0-9-]/g, '')\n}\n\nfunction buildProviderUrl(opts: Required<Omit<UseFontOptions, 'url' | 'fallback'>>): string {\n  const familyParam = opts.family.trim().replace(/\\s+/g, '+')\n  const weights = [...opts.weights].sort((a, b) => a - b)\n  const hasItalic = opts.styles.includes('italic')\n  const hasNormal = opts.styles.includes('normal')\n\n  const axis = hasItalic\n    ? `:ital,wght@${weights.flatMap(w => [\n        ...(hasNormal ? [`0,${w}`] : []),\n        `1,${w}`,\n      ]).join(';')}`\n    : `:wght@${weights.join(';')}`\n\n  return `${PROVIDER_BASE_URL[opts.provider]}?family=${familyParam}${axis}&display=${opts.display}`\n}\n\n/**\n * Register a font for the current email template.\n *\n * Builds a Google Fonts stylesheet URL from `family`/`weights`/`display`/`styles`\n * (or uses `url` as-is). The renderer injects a `<link>` tag into `<head>`\n * and merges `--font-{slug}` declarations into the template's existing\n * `@import \"tailwindcss\"` style block so a `font-{slug}` utility class\n * is generated. If no Tailwind import is found, falls back to a `:root`\n * declaration so the CSS variable is still available.\n *\n * Usage in SFC <script setup>:\n * ```ts\n * useFont({ family: 'Roboto', fallback: 'Verdana, sans-serif', weights: [400, 600] })\n * ```\n */\nexport function useFont(options: UseFontOptions): void {\n  const ctx = inject(RenderContextKey)\n  if (!ctx) return\n\n  ctx.fonts = ctx.fonts ?? []\n  if (ctx.fonts.some(f => f.family === options.family)) return\n\n  const url = options.url ?? buildProviderUrl({\n    family: options.family,\n    provider: options.provider ?? 'google',\n    weights: options.weights ?? [400],\n    display: options.display ?? 'swap',\n    styles: options.styles ?? ['normal'],\n  })\n\n  const fallback = options.fallback\n    ?? DEFAULT_FALLBACKS[FAMILY_CATEGORIES[options.family] ?? 'sans']\n  const quoted = /\\s/.test(options.family) ? `\"${options.family}\"` : options.family\n  const declaration = `${quoted}, ${fallback}`\n\n  ctx.fonts.push({\n    family: options.family,\n    slug: slugify(options.family),\n    declaration,\n    url,\n  })\n}\n"],"mappings":";;;AAKA,MAAM,oBAAkD;CAEtD,UAAU;CACV,aAAa;CACb,SAAS;CACT,QAAQ;CACR,cAAc;CAEd,gBAAgB;CAChB,oBAAoB;CACpB,QAAQ;CACR,YAAY;CACZ,cAAc;CAEd,UAAU;CACV,cAAc;CACd,SAAS;CACT,WAAW;CACX,YAAY;CAEZ,kBAAkB;CAClB,UAAU;CACV,sBAAsB;CACtB,WAAW;CACX,eAAe;CAEf,eAAe;CACf,mBAAmB;CACnB,kBAAkB;CAClB,aAAa;CACb,eAAe;CAChB;AAED,MAAM,oBAAkD;CACtD,MAAM;CACN,OAAO;CACP,MAAM;CACN,SAAS;CACT,aAAa;CACd;AAkCD,MAAM,oBAAkD;CACtD,QAAQ;CACR,OAAO;CACR;AAED,SAAS,QAAQ,QAAwB;CACvC,OAAO,OACJ,MAAM,CACN,aAAa,CACb,QAAQ,QAAQ,IAAI,CACpB,QAAQ,eAAe,GAAG;;AAG/B,SAAS,iBAAiB,MAAkE;CAC1F,MAAM,cAAc,KAAK,OAAO,MAAM,CAAC,QAAQ,QAAQ,IAAI;CAC3D,MAAM,UAAU,CAAC,GAAG,KAAK,QAAQ,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE;CACvD,MAAM,YAAY,KAAK,OAAO,SAAS,SAAS;CAChD,MAAM,YAAY,KAAK,OAAO,SAAS,SAAS;CAEhD,MAAM,OAAO,YACT,cAAc,QAAQ,SAAQ,MAAK,CACjC,GAAI,YAAY,CAAC,KAAK,IAAI,GAAG,EAAE,EAC/B,KAAK,IACN,CAAC,CAAC,KAAK,IAAI,KACZ,SAAS,QAAQ,KAAK,IAAI;CAE9B,OAAO,GAAG,kBAAkB,KAAK,UAAU,UAAU,cAAc,KAAK,WAAW,KAAK;;;;;;;;;;;;;;;;;AAkB1F,SAAgB,QAAQ,SAA+B;CACrD,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,CAAC,KAAK;CAEV,IAAI,QAAQ,IAAI,SAAS,EAAE;CAC3B,IAAI,IAAI,MAAM,MAAK,MAAK,EAAE,WAAW,QAAQ,OAAO,EAAE;CAEtD,MAAM,MAAM,QAAQ,OAAO,iBAAiB;EAC1C,QAAQ,QAAQ;EAChB,UAAU,QAAQ,YAAY;EAC9B,SAAS,QAAQ,WAAW,CAAC,IAAI;EACjC,SAAS,QAAQ,WAAW;EAC5B,QAAQ,QAAQ,UAAU,CAAC,SAAS;EACrC,CAAC;CAEF,MAAM,WAAW,QAAQ,YACpB,kBAAkB,kBAAkB,QAAQ,WAAW;CAE5D,MAAM,cAAc,GADL,KAAK,KAAK,QAAQ,OAAO,GAAG,IAAI,QAAQ,OAAO,KAAK,QAAQ,OAC7C,IAAI;CAElC,IAAI,MAAM,KAAK;EACb,QAAQ,QAAQ;EAChB,MAAM,QAAQ,QAAQ,OAAO;EAC7B;EACA;EACD,CAAC"}

package/dist/composables/useOutlookFallback.d.ts

@@ -0,0 +1,21 @@
+//#region src/composables/useOutlookFallback.d.ts
+/**
+ * Toggle whether descendants emit Outlook (MSO) and VML fallback markup.
+ *
+ * Call once in a Layout/template's `<script setup>` to disable for the
+ * whole tree:
+ *   `useOutlookFallback(false)`
+ *
+ * Components inheriting `false` skip MSO ghost tables, VML rectangles,
+ * `xmlns:v`/`xmlns:o`, mso-specific CSS, and Button's `<Outlook>`
+ * spacers. Each MSO-aware component still accepts an `outlook-fallback`
+ * prop that overrides inheritance for its subtree.
+ *
+ * @param value Pass `true`/`false` to set; omit to just read the
+ *              inherited value (defaults to `true` at the root).
+ * @returns The resolved boolean for the current component.
+ */
+declare function useOutlookFallback(value?: boolean | null): boolean;
+//#endregion
+export { useOutlookFallback };
+//# sourceMappingURL=useOutlookFallback.d.ts.map

package/dist/composables/useOutlookFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOutlookFallback.d.ts","names":[],"sources":["../../src/composables/useOutlookFallback.ts"],"mappings":";;AAoBA;;;;;;;;;;;;;;;iBAAgB,kBAAA,CAAmB,KAAA"}

package/dist/composables/useOutlookFallback.js

@@ -0,0 +1,29 @@
+import { inject, provide } from "vue";
+//#region src/composables/useOutlookFallback.ts
+const OutlookFallbackKey = Symbol("OutlookFallback");
+/**
+* Toggle whether descendants emit Outlook (MSO) and VML fallback markup.
+*
+* Call once in a Layout/template's `<script setup>` to disable for the
+* whole tree:
+*   `useOutlookFallback(false)`
+*
+* Components inheriting `false` skip MSO ghost tables, VML rectangles,
+* `xmlns:v`/`xmlns:o`, mso-specific CSS, and Button's `<Outlook>`
+* spacers. Each MSO-aware component still accepts an `outlook-fallback`
+* prop that overrides inheritance for its subtree.
+*
+* @param value Pass `true`/`false` to set; omit to just read the
+*              inherited value (defaults to `true` at the root).
+* @returns The resolved boolean for the current component.
+*/
+function useOutlookFallback(value) {
+	const inherited = inject(OutlookFallbackKey, true);
+	const enabled = value == null ? inherited : value;
+	provide(OutlookFallbackKey, enabled);
+	return enabled;
+}
+//#endregion
+export { useOutlookFallback };
+
+//# sourceMappingURL=useOutlookFallback.js.map

package/dist/composables/useOutlookFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOutlookFallback.js","names":[],"sources":["../../src/composables/useOutlookFallback.ts"],"sourcesContent":["import { inject, provide, type InjectionKey } from 'vue'\n\nconst OutlookFallbackKey: InjectionKey<boolean> = Symbol('OutlookFallback')\n\n/**\n * Toggle whether descendants emit Outlook (MSO) and VML fallback markup.\n *\n * Call once in a Layout/template's `<script setup>` to disable for the\n * whole tree:\n *   `useOutlookFallback(false)`\n *\n * Components inheriting `false` skip MSO ghost tables, VML rectangles,\n * `xmlns:v`/`xmlns:o`, mso-specific CSS, and Button's `<Outlook>`\n * spacers. Each MSO-aware component still accepts an `outlook-fallback`\n * prop that overrides inheritance for its subtree.\n *\n * @param value Pass `true`/`false` to set; omit to just read the\n *              inherited value (defaults to `true` at the root).\n * @returns The resolved boolean for the current component.\n */\nexport function useOutlookFallback(value?: boolean | null): boolean {\n  const inherited = inject(OutlookFallbackKey, true)\n  const enabled = value == null ? inherited : value\n  provide(OutlookFallbackKey, enabled)\n  return enabled\n}\n"],"mappings":";;AAEA,MAAM,qBAA4C,OAAO,kBAAkB;;;;;;;;;;;;;;;;;AAkB3E,SAAgB,mBAAmB,OAAiC;CAClE,MAAM,YAAY,OAAO,oBAAoB,KAAK;CAClD,MAAM,UAAU,SAAS,OAAO,YAAY;CAC5C,QAAQ,oBAAoB,QAAQ;CACpC,OAAO"}

package/dist/composables/{usePlaintext.d.mts → usePlaintext.d.ts}

@@ -2,6 +2,7 @@
 interface UsePlaintextOptions {
   extension?: string;
   destination?: string;
+  options?: Record<string, unknown>;
 }
 /**
  * Enable plaintext generation for the current email template.
@@ -11,9 +12,10 @@ interface UsePlaintextOptions {
  * usePlaintext()
  * usePlaintext({ extension: 'text' })
  * usePlaintext({ destination: '/custom/path' })
+ * usePlaintext({ options: { ignoreTags: ['br'] } })
  * ```
  */
 declare function usePlaintext(options?: UsePlaintextOptions): void;
 //#endregion
 export { UsePlaintextOptions, usePlaintext };
-//# sourceMappingURL=usePlaintext.d.mts.map
+//# sourceMappingURL=usePlaintext.d.ts.map

package/dist/composables/usePlaintext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlaintext.d.ts","names":[],"sources":["../../src/composables/usePlaintext.ts"],"mappings":";UAGiB,mBAAA;EACf,SAAA;EACA,WAAA;EACA,OAAA,GAAU,MAAA;AAAA;;;;;;;AAcZ;;;;;iBAAgB,YAAA,CAAa,OAAA,GAAU,mBAAA"}

package/dist/composables/{usePlaintext.mjs → usePlaintext.js}

@@ -1,6 +1,5 @@
-import { RenderContextKey } from "./renderContext.mjs";
+import { RenderContextKey } from "./renderContext.js";
 import { inject } from "vue";
-
 //#region src/composables/usePlaintext.ts
 /**
 * Enable plaintext generation for the current email template.
@@ -10,13 +9,14 @@ import { inject } from "vue";
 * usePlaintext()
 * usePlaintext({ extension: 'text' })
 * usePlaintext({ destination: '/custom/path' })
+* usePlaintext({ options: { ignoreTags: ['br'] } })
 * ```
 */
 function usePlaintext(options) {
 	const ctx = inject(RenderContextKey);
 	if (ctx) ctx.plaintext = options ?? {};
 }
-
 //#endregion
 export { usePlaintext };
-//# sourceMappingURL=usePlaintext.mjs.map
+
+//# sourceMappingURL=usePlaintext.js.map

package/dist/composables/usePlaintext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlaintext.js","names":[],"sources":["../../src/composables/usePlaintext.ts"],"sourcesContent":["import { inject } from 'vue'\nimport { RenderContextKey } from './renderContext.ts'\n\nexport interface UsePlaintextOptions {\n  extension?: string\n  destination?: string\n  options?: Record<string, unknown>\n}\n\n/**\n * Enable plaintext generation for the current email template.\n *\n * Usage in SFC <script setup>:\n * ```ts\n * usePlaintext()\n * usePlaintext({ extension: 'text' })\n * usePlaintext({ destination: '/custom/path' })\n * usePlaintext({ options: { ignoreTags: ['br'] } })\n * ```\n */\nexport function usePlaintext(options?: UsePlaintextOptions): void {\n  const ctx = inject(RenderContextKey)\n  if (ctx) ctx.plaintext = options ?? {}\n}\n"],"mappings":";;;;;;;;;;;;;;AAoBA,SAAgB,aAAa,SAAqC;CAChE,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,KAAK,IAAI,YAAY,WAAW,EAAE"}

package/dist/composables/usePreheader.d.ts

@@ -0,0 +1,24 @@
+//#region src/composables/usePreheader.d.ts
+interface UsePreheaderOptions {
+  /** Number of  ͏ filler pairs to render. @default 150 */
+  fillerCount?: number;
+  /** Number of ­ entities to render. @default 150 */
+  shyCount?: number;
+}
+/**
+ * Set the preheader text for the current email template.
+ *
+ * Injects a hidden `<div>` at the start of `<body>` with the preheader text
+ * followed by filler characters that prevent email clients from pulling
+ * in body content after the preheader.
+ *
+ * Usage in SFC <script setup>:
+ * ```ts
+ * usePreheader('Thanks for signing up!')
+ * usePreheader('Welcome!', { fillerCount: 200, shyCount: 200 })
+ * ```
+ */
+declare function usePreheader(text: string, options?: UsePreheaderOptions): void;
+//#endregion
+export { UsePreheaderOptions, usePreheader };
+//# sourceMappingURL=usePreheader.d.ts.map

package/dist/composables/usePreheader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreheader.d.ts","names":[],"sources":["../../src/composables/usePreheader.ts"],"mappings":";UAGiB,mBAAA;EAAA;EAEf,WAAA;;EAEA,QAAA;AAAA;AAgBF;;;;;;;;;;;;;AAAA,iBAAgB,YAAA,CAAa,IAAA,UAAc,OAAA,GAAU,mBAAA"}

package/dist/composables/usePreheader.js

@@ -0,0 +1,28 @@
+import { RenderContextKey } from "./renderContext.js";
+import { inject } from "vue";
+//#region src/composables/usePreheader.ts
+/**
+* Set the preheader text for the current email template.
+*
+* Injects a hidden `<div>` at the start of `<body>` with the preheader text
+* followed by filler characters that prevent email clients from pulling
+* in body content after the preheader.
+*
+* Usage in SFC <script setup>:
+* ```ts
+* usePreheader('Thanks for signing up!')
+* usePreheader('Welcome!', { fillerCount: 200, shyCount: 200 })
+* ```
+*/
+function usePreheader(text, options) {
+	const ctx = inject(RenderContextKey);
+	if (ctx) ctx.preheader = {
+		text,
+		fillerCount: options?.fillerCount ?? 150,
+		shyCount: options?.shyCount ?? 150
+	};
+}
+//#endregion
+export { usePreheader };
+
+//# sourceMappingURL=usePreheader.js.map

package/dist/composables/usePreheader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreheader.js","names":[],"sources":["../../src/composables/usePreheader.ts"],"sourcesContent":["import { inject } from 'vue'\nimport { RenderContextKey } from './renderContext.ts'\n\nexport interface UsePreheaderOptions {\n  /** Number of &#8199;&#847; filler pairs to render. @default 150 */\n  fillerCount?: number\n  /** Number of &shy; entities to render. @default 150 */\n  shyCount?: number\n}\n\n/**\n * Set the preheader text for the current email template.\n *\n * Injects a hidden `<div>` at the start of `<body>` with the preheader text\n * followed by filler characters that prevent email clients from pulling\n * in body content after the preheader.\n *\n * Usage in SFC <script setup>:\n * ```ts\n * usePreheader('Thanks for signing up!')\n * usePreheader('Welcome!', { fillerCount: 200, shyCount: 200 })\n * ```\n */\nexport function usePreheader(text: string, options?: UsePreheaderOptions): void {\n  const ctx = inject(RenderContextKey)\n  if (ctx) {\n    ctx.preheader = {\n      text,\n      fillerCount: options?.fillerCount ?? 150,\n      shyCount: options?.shyCount ?? 150,\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuBA,SAAgB,aAAa,MAAc,SAAqC;CAC9E,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,KACF,IAAI,YAAY;EACd;EACA,aAAa,SAAS,eAAe;EACrC,UAAU,SAAS,YAAY;EAChC"}

package/dist/composables/useTransformers.d.ts

@@ -0,0 +1,34 @@
+import { TransformerToggles } from "../types/config.js";
+//#region src/composables/useTransformers.d.ts
+/**
+ * Toggle the transformer pipeline for the current template.
+ *
+ * - `useTransformers(false)` skips the entire pipeline (CSS inlining,
+ *   purging, shorthand, etc).
+ * - `useTransformers(true)` (or no argument) keeps everything on.
+ * - `useTransformers({ inlineCss: false, minify: false })` runs the
+ *   pipeline but skips the listed transformers.
+ * - `useTransformers({ prettify: true, minify: true })` *enables*
+ *   transformers that would otherwise no-op (boolean-driven ones:
+ *   inlineCss, purgeCss, prettify, minify, shorthandCss, sixHex,
+ *   safeClassNames, entities). Same effect as setting their config
+ *   slice directly, scoped to one template.
+ *
+ * Data-driven transformers (filters, baseURL, urlQuery, addAttributes,
+ * removeAttributes, replaceStrings, attributeToStyle) need actual
+ * values in config — a bare `true` toggle for them is a no-op.
+ *
+ * Mirrors the `useTransformers` config flag, scoped to a single template
+ * — no need to edit `maizzle.config.ts`.
+ *
+ * Usage in SFC <script setup>:
+ * ```ts
+ * useTransformers(false)
+ * useTransformers({ inlineCss: false, minify: false })
+ * useTransformers({ prettify: true })
+ * ```
+ */
+declare function useTransformers(value?: boolean | TransformerToggles): void;
+//#endregion
+export { useTransformers };
+//# sourceMappingURL=useTransformers.d.ts.map

package/dist/composables/useTransformers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTransformers.d.ts","names":[],"sources":["../../src/composables/useTransformers.ts"],"mappings":";;;;;AAiCA;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,eAAA,CAAgB,KAAA,aAAiB,kBAAA"}