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

package/dist/components/Section.vue

@@ -63,6 +63,7 @@ const userHasWidth = computed(() => {
 
 const useMarker = outlookFallback && props.width == null && userHasWidth.value
 const msoId = useMarker ? nextId('s') : null
+const tdId = outlookFallback ? nextId('st') : null
 
 const divStyle = computed(() => {
   const parts: string[] = []
@@ -76,13 +77,6 @@ const restAttrs = computed(() => {
   return rest
 })
 
-const tdStyles = computed(() => {
-  const parts: string[] = []
-  if (userStyle.value) parts.push(userStyle.value)
-  if (props.msoStyle) parts.push(props.msoStyle)
-  return parts.length ? parts.join('; ') : ''
-})
-
 const msoWidth = computed(() => {
   if (props.width != null) return normalizeToPixels(props.width)
   if (useMarker) return `__MAIZZLE_MSOW_${msoId}__`
@@ -95,13 +89,12 @@ const colWidthSource = computed(() => {
   return null
 })
 
-const MsoBefore = () => {
-  const tdStyle = tdStyles.value ? ` style="${tdStyles.value}"` : ''
-  return createStaticVNode(
-    `<!--[if mso]><table role="none" cellpadding="0" cellspacing="0" style="width: ${msoWidth.value}"><tr><td${tdStyle}><![endif]-->`,
-    1
-  )
-}
+const tdMarker = tdId ? `__MAIZZLE_MSOTDSTYLE_${tdId}__` : ''
+
+const MsoBefore = () => createStaticVNode(
+  `<!--[if mso]><table role="none" cellpadding="0" cellspacing="0" style="width: ${msoWidth.value}"><tr><td${tdMarker}><![endif]-->`,
+  1
+)
 
 const MsoAfter = () => createStaticVNode(
   '<!--[if mso]></td></tr></table><![endif]-->',
@@ -117,6 +110,8 @@ const MsoAfter = () => createStaticVNode(
     :data-maizzle-msow-id="msoId"
     :data-maizzle-msow-fallback="useMarker ? '100%' : null"
     :data-maizzle-cw="colWidthSource"
+    :data-maizzle-mso-td-id="tdId"
+    :data-maizzle-mso-style="tdId && props.msoStyle ? props.msoStyle : null"
   >
     <slot />
   </div>

package/dist/components/Text.vue

@@ -18,7 +18,7 @@ const props = defineProps({
 
 const attrs = useAttrs()
 
-const defaultClass = computed(() => props.as === 'span' ? 'text-base' : 'm-0 my-4 text-base')
+const defaultClass = computed(() => props.as === 'span' ? 'text-base' : 'mt-4 text-base')
 const mergedClass = computed(() => twMerge(defaultClass.value, attrs.class as string))
 </script>
 

package/dist/composables/defineConfig.d.ts

@@ -3,10 +3,9 @@ import { MaizzleConfig } from "../types/config.js";
 /**
  * Define Maizzle config.
  *
- * Works in both contexts:
- * - In maizzle.config.ts: typed identity function, returns the config as-is
- * - In Vue SFC <script setup>: merges with the global config and provides
- *   the result to child components via useConfig()
+ * In maizzle.config.ts: typed identity function, returns the config as-is
+ * In Vue SFC `<script setup>`: merges with the global config and provides
+ * the result to child components via `useConfig()`
  */
 declare function defineConfig(data?: Partial<MaizzleConfig>): MaizzleConfig;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"defineConfig.d.ts","names":[],"sources":["../../src/composables/defineConfig.ts"],"mappings":";;;;;AAqBA;;;;;iBAAgB,YAAA,CAAa,IAAA,GAAM,OAAA,CAAQ,aAAA,IAAsB,aAAA"}
+{"version":3,"file":"defineConfig.d.ts","names":[],"sources":["../../src/composables/defineConfig.ts"],"mappings":";;;;;AAoBA;;;;iBAAgB,YAAA,CAAa,IAAA,GAAM,OAAA,CAAQ,aAAA,IAAsB,aAAA"}

package/dist/composables/defineConfig.js

@@ -12,10 +12,9 @@ const merge = createDefu((obj, key, value) => {
 /**
 * Define Maizzle config.
 *
-* Works in both contexts:
-* - In maizzle.config.ts: typed identity function, returns the config as-is
-* - In Vue SFC <script setup>: merges with the global config and provides
-*   the result to child components via useConfig()
+* In maizzle.config.ts: typed identity function, returns the config as-is
+* In Vue SFC `<script setup>`: merges with the global config and provides
+* the result to child components via `useConfig()`
 */
 function defineConfig(data = {}) {
 	if (getCurrentInstance()) {

package/dist/composables/defineConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineConfig.js","names":[],"sources":["../../src/composables/defineConfig.ts"],"sourcesContent":["import { getCurrentInstance, inject, provide } from 'vue'\nimport { createDefu } from 'defu'\nimport { MaizzleConfigKey } from './useConfig.ts'\nimport { RenderContextKey } from './renderContext.ts'\nimport type { MaizzleConfig } from '../types/index.ts'\n\nconst merge = createDefu((obj, key, value) => {\n  if (Array.isArray(obj[key])) {\n    obj[key] = value\n    return true\n  }\n})\n\n/**\n * Define Maizzle config.\n *\n * Works in both contexts:\n * - In maizzle.config.ts: typed identity function, returns the config as-is\n * - In Vue SFC <script setup>: merges with the global config and provides\n *   the result to child components via useConfig()\n */\nexport function defineConfig(data: Partial<MaizzleConfig> = {}): MaizzleConfig {\n  // Inside a Vue SFC — merge with global config and provide to children\n  if (getCurrentInstance()) {\n    const globalConfig = inject(MaizzleConfigKey, {} as MaizzleConfig)\n    const merged = merge(data, globalConfig) as MaizzleConfig\n\n    const ctx = inject(RenderContextKey)\n    if (ctx) ctx.sfcConfig = merged\n\n    provide(MaizzleConfigKey, merged)\n\n    return merged\n  }\n\n  // Outside Vue (maizzle.config.ts) — just return the config\n  return data as MaizzleConfig\n}\n"],"mappings":";;;;;AAMA,MAAM,QAAQ,YAAY,KAAK,KAAK,UAAU;CAC5C,IAAI,MAAM,QAAQ,IAAI,KAAK,EAAE;EAC3B,IAAI,OAAO;EACX,OAAO;;EAET;;;;;;;;;AAUF,SAAgB,aAAa,OAA+B,EAAE,EAAiB;CAE7E,IAAI,oBAAoB,EAAE;EAExB,MAAM,SAAS,MAAM,MADA,OAAO,kBAAkB,EAAE,CACT,CAAC;EAExC,MAAM,MAAM,OAAO,iBAAiB;EACpC,IAAI,KAAK,IAAI,YAAY;EAEzB,QAAQ,kBAAkB,OAAO;EAEjC,OAAO;;CAIT,OAAO"}
+{"version":3,"file":"defineConfig.js","names":[],"sources":["../../src/composables/defineConfig.ts"],"sourcesContent":["import { getCurrentInstance, inject, provide } from 'vue'\nimport { createDefu } from 'defu'\nimport { MaizzleConfigKey } from './useConfig.ts'\nimport { RenderContextKey } from './renderContext.ts'\nimport type { MaizzleConfig } from '../types/index.ts'\n\nconst merge = createDefu((obj, key, value) => {\n  if (Array.isArray(obj[key])) {\n    obj[key] = value\n    return true\n  }\n})\n\n/**\n * Define Maizzle config.\n *\n * In maizzle.config.ts: typed identity function, returns the config as-is\n * In Vue SFC `<script setup>`: merges with the global config and provides\n * the result to child components via `useConfig()`\n */\nexport function defineConfig(data: Partial<MaizzleConfig> = {}): MaizzleConfig {\n  // Inside a Vue SFC — merge with global config and provide to children\n  if (getCurrentInstance()) {\n    const globalConfig = inject(MaizzleConfigKey, {} as MaizzleConfig)\n    const merged = merge(data, globalConfig) as MaizzleConfig\n\n    const ctx = inject(RenderContextKey)\n    if (ctx) ctx.sfcConfig = merged\n\n    provide(MaizzleConfigKey, merged)\n\n    return merged\n  }\n\n  // Outside Vue (maizzle.config.ts) — just return the config\n  return data as MaizzleConfig\n}\n"],"mappings":";;;;;AAMA,MAAM,QAAQ,YAAY,KAAK,KAAK,UAAU;CAC5C,IAAI,MAAM,QAAQ,IAAI,KAAK,EAAE;EAC3B,IAAI,OAAO;EACX,OAAO;;EAET;;;;;;;;AASF,SAAgB,aAAa,OAA+B,EAAE,EAAiB;CAE7E,IAAI,oBAAoB,EAAE;EAExB,MAAM,SAAS,MAAM,MADA,OAAO,kBAAkB,EAAE,CACT,CAAC;EAExC,MAAM,MAAM,OAAO,iBAAiB;EACpC,IAAI,KAAK,IAAI,YAAY;EAEzB,QAAQ,kBAAkB,OAAO;EAEjC,OAAO;;CAIT,OAAO"}

package/dist/composables/renderContext.d.ts

@@ -1,5 +1,5 @@
-import { MaizzleConfig } from "../types/config.js";
 import { EventMap, EventName } from "../events/index.js";
+import { MaizzleConfig } from "../types/config.js";
 import { UsePlaintextOptions } from "./usePlaintext.js";
 import { InjectionKey } from "vue";
 
@@ -20,7 +20,6 @@ interface RenderContext {
   preheader?: {
     text: string;
     fillerCount: number;
-    shyCount: number;
   };
   sfcConfig?: MaizzleConfig;
   sfcEventHandlers: Array<{

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

@@ -1 +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"}
+{"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;EAAA;EAC5B,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.js.map

@@ -1 +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"}
+{"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 }\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/useCurrentTemplate.d.ts

@@ -0,0 +1,31 @@
+import { ParsedPath } from "node:path";
+
+//#region src/composables/useCurrentTemplate.d.ts
+/**
+ * Internal — set by the build loop before each template iteration and
+ * cleared in `finally`. Not exported from the package entrypoint.
+ */
+declare function _setCurrentTemplate(parsed: ParsedPath | undefined): void;
+/**
+ * Returns the parsed path of the template currently being processed,
+ * or `undefined` when called outside the per-template scope (e.g. from
+ * `beforeCreate` / `afterBuild`, or outside a build entirely).
+ *
+ * Usage in an SFC `<script setup>`:
+ * ```ts
+ * const file = useCurrentTemplate()
+ * console.log(file?.name) // 'welcome'
+ * ```
+ *
+ * Usage in an event handler:
+ * ```ts
+ * beforeRender() {
+ *   const file = useCurrentTemplate()
+ *   // file?.dir, file?.name, file?.ext, file?.base, file?.root
+ * }
+ * ```
+ */
+declare function useCurrentTemplate(): ParsedPath | undefined;
+//#endregion
+export { _setCurrentTemplate, useCurrentTemplate };
+//# sourceMappingURL=useCurrentTemplate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrentTemplate.d.ts","names":[],"sources":["../../src/composables/useCurrentTemplate.ts"],"mappings":";;;;;AAQA;;iBAAgB,mBAAA,CAAoB,MAAA,EAAQ,UAAA;;;AAuB5C;;;;;;;;;;;;;;;;;iBAAgB,kBAAA,CAAA,GAAsB,UAAA"}

package/dist/composables/useCurrentTemplate.js

@@ -0,0 +1,35 @@
+//#region src/composables/useCurrentTemplate.ts
+let current;
+/**
+* Internal — set by the build loop before each template iteration and
+* cleared in `finally`. Not exported from the package entrypoint.
+*/
+function _setCurrentTemplate(parsed) {
+	current = parsed;
+}
+/**
+* Returns the parsed path of the template currently being processed,
+* or `undefined` when called outside the per-template scope (e.g. from
+* `beforeCreate` / `afterBuild`, or outside a build entirely).
+*
+* Usage in an SFC `<script setup>`:
+* ```ts
+* const file = useCurrentTemplate()
+* console.log(file?.name) // 'welcome'
+* ```
+*
+* Usage in an event handler:
+* ```ts
+* beforeRender() {
+*   const file = useCurrentTemplate()
+*   // file?.dir, file?.name, file?.ext, file?.base, file?.root
+* }
+* ```
+*/
+function useCurrentTemplate() {
+	return current;
+}
+//#endregion
+export { _setCurrentTemplate, useCurrentTemplate };
+
+//# sourceMappingURL=useCurrentTemplate.js.map

package/dist/composables/useCurrentTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrentTemplate.js","names":[],"sources":["../../src/composables/useCurrentTemplate.ts"],"sourcesContent":["import type { ParsedPath } from 'node:path'\n\nlet current: ParsedPath | undefined\n\n/**\n * Internal — set by the build loop before each template iteration and\n * cleared in `finally`. Not exported from the package entrypoint.\n */\nexport function _setCurrentTemplate(parsed: ParsedPath | undefined): void {\n  current = parsed\n}\n\n/**\n * Returns the parsed path of the template currently being processed,\n * or `undefined` when called outside the per-template scope (e.g. from\n * `beforeCreate` / `afterBuild`, or outside a build entirely).\n *\n * Usage in an SFC `<script setup>`:\n * ```ts\n * const file = useCurrentTemplate()\n * console.log(file?.name) // 'welcome'\n * ```\n *\n * Usage in an event handler:\n * ```ts\n * beforeRender() {\n *   const file = useCurrentTemplate()\n *   // file?.dir, file?.name, file?.ext, file?.base, file?.root\n * }\n * ```\n */\nexport function useCurrentTemplate(): ParsedPath | undefined {\n  return current\n}\n"],"mappings":";AAEA,IAAI;;;;;AAMJ,SAAgB,oBAAoB,QAAsC;CACxE,UAAU;;;;;;;;;;;;;;;;;;;;;AAsBZ,SAAgB,qBAA6C;CAC3D,OAAO"}

package/dist/composables/useEvent.d.ts

@@ -7,7 +7,7 @@ import { EventMap, EventName } from "../events/index.js";
  * Usage:
  * ```ts
  * useEvent('beforeRender', ({ config, template }) => {
- *   return template.replace('foo', 'bar')
+ *   return template.source.replace('foo', 'bar')
  * })
  * ```
  */

package/dist/composables/useEvent.js

@@ -7,7 +7,7 @@ import { inject } from "vue";
 * Usage:
 * ```ts
 * useEvent('beforeRender', ({ config, template }) => {
-*   return template.replace('foo', 'bar')
+*   return template.source.replace('foo', 'bar')
 * })
 * ```
 */

package/dist/composables/useEvent.js.map

@@ -1 +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"}
+{"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.source.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/usePreheader.d.ts

@@ -1,9 +1,10 @@
 //#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;
+  /**
+   * Explicit number of filler sequences to render. When omitted, the count
+   * is auto-derived to fill the 200-char inbox preview budget.
+   */
+  spaces?: number;
 }
 /**
  * Set the preheader text for the current email template.
@@ -15,7 +16,7 @@ interface UsePreheaderOptions {
  * Usage in SFC <script setup>:
  * ```ts
  * usePreheader('Thanks for signing up!')
- * usePreheader('Welcome!', { fillerCount: 200, shyCount: 200 })
+ * usePreheader('Welcome!', { spaces: 50 })
  * ```
  */
 declare function usePreheader(text: string, options?: UsePreheaderOptions): void;

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

@@ -1 +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"}
+{"version":3,"file":"usePreheader.d.ts","names":[],"sources":["../../src/composables/usePreheader.ts"],"mappings":";UAKiB,mBAAA;EAAA;;;;EAKf,MAAA;AAAA;;;;;;;;;;;;;;iBAgBc,YAAA,CAAa,IAAA,UAAc,OAAA,GAAU,mBAAA"}

package/dist/composables/usePreheader.js

@@ -1,6 +1,7 @@
 import { RenderContextKey } from "./renderContext.js";
 import { inject } from "vue";
 //#region src/composables/usePreheader.ts
+const PREVIEW_LENGTH = 200;
 /**
 * Set the preheader text for the current email template.
 *
@@ -11,15 +12,14 @@ import { inject } from "vue";
 * Usage in SFC <script setup>:
 * ```ts
 * usePreheader('Thanks for signing up!')
-* usePreheader('Welcome!', { fillerCount: 200, shyCount: 200 })
+* usePreheader('Welcome!', { spaces: 50 })
 * ```
 */
 function usePreheader(text, options) {
 	const ctx = inject(RenderContextKey);
 	if (ctx) ctx.preheader = {
 		text,
-		fillerCount: options?.fillerCount ?? 150,
-		shyCount: options?.shyCount ?? 150
+		fillerCount: options?.spaces !== void 0 ? Math.max(0, options.spaces) : Math.max(0, PREVIEW_LENGTH - text.length)
 	};
 }
 //#endregion

package/dist/composables/usePreheader.js.map

@@ -1 +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"}
+{"version":3,"file":"usePreheader.js","names":[],"sources":["../../src/composables/usePreheader.ts"],"sourcesContent":["import { inject } from 'vue'\nimport { RenderContextKey } from './renderContext.ts'\n\nconst PREVIEW_LENGTH = 200\n\nexport interface UsePreheaderOptions {\n  /**\n   * Explicit number of filler sequences to render. When omitted, the count\n   * is auto-derived to fill the 200-char inbox preview budget.\n   */\n  spaces?: 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!', { spaces: 50 })\n * ```\n */\nexport function usePreheader(text: string, options?: UsePreheaderOptions): void {\n  const ctx = inject(RenderContextKey)\n  if (ctx) {\n    const fillerCount = options?.spaces !== undefined\n      ? Math.max(0, options.spaces)\n      : Math.max(0, PREVIEW_LENGTH - text.length)\n    ctx.preheader = { text, fillerCount }\n  }\n}\n"],"mappings":";;;AAGA,MAAM,iBAAiB;;;;;;;;;;;;;;AAuBvB,SAAgB,aAAa,MAAc,SAAqC;CAC9E,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,KAIF,IAAI,YAAY;EAAE;EAAM,aAHJ,SAAS,WAAW,KAAA,IACpC,KAAK,IAAI,GAAG,QAAQ,OAAO,GAC3B,KAAK,IAAI,GAAG,iBAAiB,KAAK,OAAO;EACR"}

package/dist/composables/useTransformers.d.ts

@@ -11,7 +11,7 @@ import { TransformerToggles } from "../types/config.js";
  * - `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
+ *   safeSelectors, entities). Same effect as setting their config
  *   slice directly, scoped to one template.
  *
  * Data-driven transformers (filters, baseURL, urlQuery, addAttributes,

package/dist/composables/useTransformers.js

@@ -13,7 +13,7 @@ import { getCurrentInstance, inject, provide } from "vue";
 * - `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
+*   safeSelectors, entities). Same effect as setting their config
 *   slice directly, scoped to one template.
 *
 * Data-driven transformers (filters, baseURL, urlQuery, addAttributes,

package/dist/composables/useTransformers.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTransformers.js","names":[],"sources":["../../src/composables/useTransformers.ts"],"sourcesContent":["import { getCurrentInstance, inject, provide } from 'vue'\nimport { MaizzleConfigKey } from './useConfig.ts'\nimport { RenderContextKey } from './renderContext.ts'\nimport type { MaizzleConfig, TransformerToggles } from '../types/index.ts'\n\n/**\n * Toggle the transformer pipeline for the current template.\n *\n * - `useTransformers(false)` skips the entire pipeline (CSS inlining,\n *   purging, shorthand, etc).\n * - `useTransformers(true)` (or no argument) keeps everything on.\n * - `useTransformers({ inlineCss: false, minify: false })` runs the\n *   pipeline but skips the listed transformers.\n * - `useTransformers({ prettify: true, minify: true })` *enables*\n *   transformers that would otherwise no-op (boolean-driven ones:\n *   inlineCss, purgeCss, prettify, minify, shorthandCss, sixHex,\n *   safeClassNames, entities). Same effect as setting their config\n *   slice directly, scoped to one template.\n *\n * Data-driven transformers (filters, baseURL, urlQuery, addAttributes,\n * removeAttributes, replaceStrings, attributeToStyle) need actual\n * values in config — a bare `true` toggle for them is a no-op.\n *\n * Mirrors the `useTransformers` config flag, scoped to a single template\n * — no need to edit `maizzle.config.ts`.\n *\n * Usage in SFC <script setup>:\n * ```ts\n * useTransformers(false)\n * useTransformers({ inlineCss: false, minify: false })\n * useTransformers({ prettify: true })\n * ```\n */\nexport function useTransformers(value: boolean | TransformerToggles = true): void {\n  if (!getCurrentInstance()) return\n\n  const ctx = inject(RenderContextKey)\n  if (!ctx) return\n\n  const globalConfig = inject(MaizzleConfigKey, {} as MaizzleConfig)\n  const merged: MaizzleConfig = {\n    ...(ctx.sfcConfig ?? globalConfig),\n    useTransformers: value,\n  }\n\n  ctx.sfcConfig = merged\n  provide(MaizzleConfigKey, merged)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,gBAAgB,QAAsC,MAAY;CAChF,IAAI,CAAC,oBAAoB,EAAE;CAE3B,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,CAAC,KAAK;CAEV,MAAM,eAAe,OAAO,kBAAkB,EAAE,CAAkB;CAClE,MAAM,SAAwB;EAC5B,GAAI,IAAI,aAAa;EACrB,iBAAiB;EAClB;CAED,IAAI,YAAY;CAChB,QAAQ,kBAAkB,OAAO"}
+{"version":3,"file":"useTransformers.js","names":[],"sources":["../../src/composables/useTransformers.ts"],"sourcesContent":["import { getCurrentInstance, inject, provide } from 'vue'\nimport { MaizzleConfigKey } from './useConfig.ts'\nimport { RenderContextKey } from './renderContext.ts'\nimport type { MaizzleConfig, TransformerToggles } from '../types/index.ts'\n\n/**\n * Toggle the transformer pipeline for the current template.\n *\n * - `useTransformers(false)` skips the entire pipeline (CSS inlining,\n *   purging, shorthand, etc).\n * - `useTransformers(true)` (or no argument) keeps everything on.\n * - `useTransformers({ inlineCss: false, minify: false })` runs the\n *   pipeline but skips the listed transformers.\n * - `useTransformers({ prettify: true, minify: true })` *enables*\n *   transformers that would otherwise no-op (boolean-driven ones:\n *   inlineCss, purgeCss, prettify, minify, shorthandCss, sixHex,\n *   safeSelectors, entities). Same effect as setting their config\n *   slice directly, scoped to one template.\n *\n * Data-driven transformers (filters, baseURL, urlQuery, addAttributes,\n * removeAttributes, replaceStrings, attributeToStyle) need actual\n * values in config — a bare `true` toggle for them is a no-op.\n *\n * Mirrors the `useTransformers` config flag, scoped to a single template\n * — no need to edit `maizzle.config.ts`.\n *\n * Usage in SFC <script setup>:\n * ```ts\n * useTransformers(false)\n * useTransformers({ inlineCss: false, minify: false })\n * useTransformers({ prettify: true })\n * ```\n */\nexport function useTransformers(value: boolean | TransformerToggles = true): void {\n  if (!getCurrentInstance()) return\n\n  const ctx = inject(RenderContextKey)\n  if (!ctx) return\n\n  const globalConfig = inject(MaizzleConfigKey, {} as MaizzleConfig)\n  const merged: MaizzleConfig = {\n    ...(ctx.sfcConfig ?? globalConfig),\n    useTransformers: value,\n  }\n\n  ctx.sfcConfig = merged\n  provide(MaizzleConfigKey, merged)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,gBAAgB,QAAsC,MAAY;CAChF,IAAI,CAAC,oBAAoB,EAAE;CAE3B,MAAM,MAAM,OAAO,iBAAiB;CACpC,IAAI,CAAC,KAAK;CAEV,MAAM,eAAe,OAAO,kBAAkB,EAAE,CAAkB;CAClE,MAAM,SAAwB;EAC5B,GAAI,IAAI,aAAa;EACrB,iBAAiB;EAClB;CAED,IAAI,YAAY;CAChB,QAAQ,kBAAkB,OAAO"}

package/dist/events/index.d.ts

@@ -1,22 +1,33 @@
 import { MaizzleConfig } from "../types/config.js";
+import { ParsedPath } from "node:path";
+
 //#region src/events/index.d.ts
 type EventName = 'beforeCreate' | 'beforeRender' | 'afterRender' | 'afterTransform' | 'afterBuild';
+/**
+ * Info about the template currently being processed, passed to per-template
+ * event handlers. `source` is the SFC file contents; `path` is the result of
+ * `path.parse(absolutePath)` — `{ root, dir, base, ext, name }`.
+ */
+interface TemplateInfo {
+  source: string;
+  path: ParsedPath;
+}
 interface EventMap {
   beforeCreate: (params: {
     config: MaizzleConfig;
   }) => void | Promise<void>;
   beforeRender: (params: {
     config: MaizzleConfig;
-    template: string;
+    template: TemplateInfo;
   }) => string | void | Promise<string | void>;
   afterRender: (params: {
     config: MaizzleConfig;
-    template: string;
+    template: TemplateInfo;
     html: string;
   }) => string | void | Promise<string | void>;
   afterTransform: (params: {
     config: MaizzleConfig;
-    template: string;
+    template: TemplateInfo;
     html: string;
   }) => string | void | Promise<string | void>;
   afterBuild: (params: {
@@ -49,18 +60,19 @@ declare class EventManager {
     config: MaizzleConfig;
   }): Promise<void>;
   /**
-   * Fire beforeRender — if a handler returns a string, it replaces `template`.
+   * Fire beforeRender — if a handler returns a string, it replaces
+   * `template.source` for subsequent handlers and the renderer.
    */
   fireBeforeRender(params: {
     config: MaizzleConfig;
-    template: string;
+    template: TemplateInfo;
   }): Promise<string>;
   /**
    * Fire afterRender — if a handler returns a string, it replaces `html`.
    */
   fireAfterRender(params: {
     config: MaizzleConfig;
-    template: string;
+    template: TemplateInfo;
     html: string;
   }): Promise<string>;
   /**
@@ -68,7 +80,7 @@ declare class EventManager {
    */
   fireAfterTransform(params: {
     config: MaizzleConfig;
-    template: string;
+    template: TemplateInfo;
     html: string;
   }): Promise<string>;
   /**
@@ -93,5 +105,5 @@ declare class EventManager {
   clear(): void;
 }
 //#endregion
-export { EventManager, EventMap, EventName };
+export { EventManager, EventMap, EventName, TemplateInfo };
 //# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/events/index.ts"],"mappings":";;KAEY,SAAA;AAAA,UAEK,QAAA;EACf,YAAA,GAAe,MAAA;IAAU,MAAA,EAAQ,aAAA;EAAA,aAA2B,OAAA;EAC5D,YAAA,GAAe,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;EAAA,sBAAuC,OAAA;EACvF,WAAA,GAAc,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;IAAkB,IAAA;EAAA,sBAAmC,OAAA;EACpG,cAAA,GAAiB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;IAAkB,IAAA;EAAA,sBAAmC,OAAA;EACvG,UAAA,GAAa,MAAA;IAAU,KAAA;IAAiB,MAAA,EAAQ,aAAA;EAAA,aAA2B,OAAA;AAAA;;;;;;;;cAUhE,YAAA;EAAA,QACH,QAAA;EAAA,QAIA,kBAAA;EAjBR;;;EAsBA,cAAA,CAAe,MAAA,EAAQ,aAAA;EAtB0C;;;EAqCjE,EAAA,WAAa,SAAA,CAAA,CAAW,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,QAAA,CAAS,CAAA;EApCxB;;;EA+CrB,gBAAA,CAAiB,MAAA;IAAU,MAAA,EAAQ,aAAA;EAAA,IAAe,OAAA;EA9CxD;;;EAyDM,gBAAA,CAAiB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;EAAA,IAAqB,OAAA;EAzDK;AAUpF;;EAkEQ,eAAA,CAAgB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;IAAkB,IAAA;EAAA,IAAiB,OAAA;EAzCvC;;;EA4D7C,kBAAA,CAAmB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;IAAkB,IAAA;EAAA,IAAiB,OAAA;EAAA;;;EAmBvF,cAAA,CAAe,MAAA;IAAU,KAAA;IAAiB,MAAA,EAAQ,aAAA;EAAA,IAAe,OAAA;EAnG/D;;;;;;;;EAmHR,gBAAA,CAAiB,MAAA,GAAQ,SAAA;EA/FiB;;;EA6G1C,KAAA,CAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/events/index.ts"],"mappings":";;;;KAGY,SAAA;;;AAAZ;;;UAOiB,YAAA;EACf,MAAA;EACA,IAAA,EAAM,UAAA;AAAA;AAAA,UAGS,QAAA;EACf,YAAA,GAAe,MAAA;IAAU,MAAA,EAAQ,aAAA;EAAA,aAA2B,OAAA;EAC5D,YAAA,GAAe,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA,EAAU,YAAA;EAAA,sBAAmC,OAAA;EAC7F,WAAA,GAAc,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA,EAAU,YAAA;IAAc,IAAA;EAAA,sBAAmC,OAAA;EAC1G,cAAA,GAAiB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA,EAAU,YAAA;IAAc,IAAA;EAAA,sBAAmC,OAAA;EAC7G,UAAA,GAAa,MAAA;IAAU,KAAA;IAAiB,MAAA,EAAQ,aAAA;EAAA,aAA2B,OAAA;AAAA;;;;;;;;cAUhE,YAAA;EAAA,QACH,QAAA;EAAA,QAIA,kBAAA;EAlBwC;;;EAuBhD,cAAA,CAAe,MAAA,EAAQ,aAAA;EAtBvB;;;EAqCA,EAAA,WAAa,SAAA,CAAA,CAAW,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,QAAA,CAAS,CAAA;EArCM;;;EAgDnD,gBAAA,CAAiB,MAAA;IAAU,MAAA,EAAQ,aAAA;EAAA,IAAe,OAAA;EA/CrB;;;;EA2D7B,gBAAA,CAAiB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA,EAAU,YAAA;EAAA,IAAiB,OAAA;EA1D3C;;;EA2ElC,eAAA,CAAgB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA,EAAU,YAAA;IAAc,IAAA;EAAA,IAAiB,OAAA;EAjEzE;;;EAoFjB,kBAAA,CAAmB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA,EAAU,YAAA;IAAc,IAAA;EAAA,IAAiB,OAAA;EApC1D;;;EAuDnC,cAAA,CAAe,MAAA;IAAU,KAAA;IAAiB,MAAA,EAAQ,aAAA;EAAA,IAAe,OAAA;EAnBH;;;;;;;;EAmCpE,gBAAA,CAAiB,MAAA,GAAQ,SAAA;EA7GzB;;;EA2HA,KAAA,CAAA;AAAA"}

package/dist/events/index.js

@@ -40,19 +40,16 @@ var EventManager = class {
 		for (const handler of handlers) await handler(params);
 	}
 	/**
-	* Fire beforeRender — if a handler returns a string, it replaces `template`.
+	* Fire beforeRender — if a handler returns a string, it replaces
+	* `template.source` for subsequent handlers and the renderer.
 	*/
 	async fireBeforeRender(params) {
 		const handlers = this.handlers.get("beforeRender") ?? [];
-		let { template } = params;
 		for (const handler of handlers) {
-			const result = await handler({
-				config: params.config,
-				template
-			});
-			if (typeof result === "string") template = result;
+			const result = await handler(params);
+			if (typeof result === "string") params.template.source = result;
 		}
-		return template;
+		return params.template.source;
 	}
 	/**
 	* Fire afterRender — if a handler returns a string, it replaces `html`.

package/dist/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/events/index.ts"],"sourcesContent":["import type { MaizzleConfig } from '../types/index.ts'\n\nexport type EventName = 'beforeCreate' | 'beforeRender' | 'afterRender' | 'afterTransform' | 'afterBuild'\n\nexport interface EventMap {\n  beforeCreate: (params: { config: MaizzleConfig }) => void | Promise<void>\n  beforeRender: (params: { config: MaizzleConfig; template: string }) => string | void | Promise<string | void>\n  afterRender: (params: { config: MaizzleConfig; template: string; html: string }) => string | void | Promise<string | void>\n  afterTransform: (params: { config: MaizzleConfig; template: string; html: string }) => string | void | Promise<string | void>\n  afterBuild: (params: { files: string[]; config: MaizzleConfig }) => void | Promise<void>\n}\n\n/**\n * Central event manager that collects handlers from config and useEvent() calls.\n *\n * Handlers are run in order: config handler first, then SFC handlers in registration order.\n * For events that return a value (beforeRender, afterRender, afterTransform),\n * the returned value replaces the corresponding input for the next handler.\n */\nexport class EventManager {\n  private handlers = new Map<EventName, EventMap[EventName][]>()\n  // Snapshot of config-handler counts per event, captured at registerConfig().\n  // clearSfcHandlers() truncates each list back to this count, dropping any\n  // SFC-registered handlers that were appended after.\n  private configHandlerCount = new Map<EventName, number>()\n\n  /**\n   * Register handlers from the Maizzle config.\n   */\n  registerConfig(config: MaizzleConfig) {\n    const eventNames: EventName[] = ['beforeCreate', 'beforeRender', 'afterRender', 'afterTransform', 'afterBuild']\n\n    for (const name of eventNames) {\n      const handler = config[name]\n      if (typeof handler === 'function') {\n        this.on(name, handler as EventMap[typeof name])\n      }\n      this.configHandlerCount.set(name, this.handlers.get(name)?.length ?? 0)\n    }\n  }\n\n  /**\n   * Register a handler for an event (used by useEvent composable).\n   */\n  on<K extends EventName>(name: K, handler: EventMap[K]) {\n    if (!this.handlers.has(name)) {\n      this.handlers.set(name, [])\n    }\n\n    this.handlers.get(name)!.push(handler)\n  }\n\n  /**\n   * Fire beforeCreate — runs all handlers, config is mutated in place.\n   */\n  async fireBeforeCreate(params: { config: MaizzleConfig }) {\n    const handlers = this.handlers.get('beforeCreate') ?? []\n\n    for (const handler of handlers) {\n      await (handler as EventMap['beforeCreate'])(params)\n    }\n  }\n\n  /**\n   * Fire beforeRender — if a handler returns a string, it replaces `template`.\n   */\n  async fireBeforeRender(params: { config: MaizzleConfig; template: string }): Promise<string> {\n    const handlers = this.handlers.get('beforeRender') ?? []\n\n    let { template } = params\n\n    for (const handler of handlers) {\n      const result = await (handler as EventMap['beforeRender'])({ config: params.config, template })\n\n      if (typeof result === 'string') {\n        template = result\n      }\n    }\n\n    return template\n  }\n\n  /**\n   * Fire afterRender — if a handler returns a string, it replaces `html`.\n   */\n  async fireAfterRender(params: { config: MaizzleConfig; template: string; html: string }): Promise<string> {\n    const handlers = this.handlers.get('afterRender') ?? []\n\n    let { html } = params\n\n    for (const handler of handlers) {\n      const result = await (handler as EventMap['afterRender'])({ config: params.config, template: params.template, html })\n\n      if (typeof result === 'string') {\n        html = result\n      }\n    }\n\n    return html\n  }\n\n  /**\n   * Fire afterTransform — if a handler returns a string, it replaces `html`.\n   */\n  async fireAfterTransform(params: { config: MaizzleConfig; template: string; html: string }): Promise<string> {\n    const handlers = this.handlers.get('afterTransform') ?? []\n\n    let { html } = params\n\n    for (const handler of handlers) {\n      const result = await (handler as EventMap['afterTransform'])({ config: params.config, template: params.template, html })\n\n      if (typeof result === 'string') {\n        html = result\n      }\n    }\n\n    return html\n  }\n\n  /**\n   * Fire afterBuild — runs all handlers with the file list.\n   */\n  async fireAfterBuild(params: { files: string[]; config: MaizzleConfig }) {\n    const handlers = this.handlers.get('afterBuild') ?? []\n\n    for (const handler of handlers) {\n      await (handler as EventMap['afterBuild'])(params)\n    }\n  }\n\n  /**\n   * Drop SFC-registered handlers, keep config-registered ones.\n   *\n   * Per default, only clears events whose scope is per-template\n   * (`beforeRender`, `afterRender`, `afterTransform`). Build-scoped events\n   * (`afterBuild`) accumulate across all templates and fire once at end of\n   * build. Pass an explicit list to override.\n   */\n  clearSfcHandlers(events: EventName[] = ['beforeRender', 'afterRender', 'afterTransform']) {\n    for (const name of events) {\n      const handlers = this.handlers.get(name)\n      if (!handlers) continue\n      const keep = this.configHandlerCount.get(name) ?? 0\n      if (handlers.length > keep) {\n        this.handlers.set(name, handlers.slice(0, keep))\n      }\n    }\n  }\n\n  /**\n   * Clear all handlers entirely.\n   */\n  clear() {\n    this.handlers.clear()\n  }\n}\n"],"mappings":";;;;;;;;AAmBA,IAAa,eAAb,MAA0B;CACxB,2BAAmB,IAAI,KAAuC;CAI9D,qCAA6B,IAAI,KAAwB;;;;CAKzD,eAAe,QAAuB;EAGpC,KAAK,MAAM,QAAQ;GAFc;GAAgB;GAAgB;GAAe;GAAkB;GAErE,EAAE;GAC7B,MAAM,UAAU,OAAO;GACvB,IAAI,OAAO,YAAY,YACrB,KAAK,GAAG,MAAM,QAAiC;GAEjD,KAAK,mBAAmB,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE,UAAU,EAAE;;;;;;CAO3E,GAAwB,MAAS,SAAsB;EACrD,IAAI,CAAC,KAAK,SAAS,IAAI,KAAK,EAC1B,KAAK,SAAS,IAAI,MAAM,EAAE,CAAC;EAG7B,KAAK,SAAS,IAAI,KAAK,CAAE,KAAK,QAAQ;;;;;CAMxC,MAAM,iBAAiB,QAAmC;EACxD,MAAM,WAAW,KAAK,SAAS,IAAI,eAAe,IAAI,EAAE;EAExD,KAAK,MAAM,WAAW,UACpB,MAAO,QAAqC,OAAO;;;;;CAOvD,MAAM,iBAAiB,QAAsE;EAC3F,MAAM,WAAW,KAAK,SAAS,IAAI,eAAe,IAAI,EAAE;EAExD,IAAI,EAAE,aAAa;EAEnB,KAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,SAAS,MAAO,QAAqC;IAAE,QAAQ,OAAO;IAAQ;IAAU,CAAC;GAE/F,IAAI,OAAO,WAAW,UACpB,WAAW;;EAIf,OAAO;;;;;CAMT,MAAM,gBAAgB,QAAoF;EACxG,MAAM,WAAW,KAAK,SAAS,IAAI,cAAc,IAAI,EAAE;EAEvD,IAAI,EAAE,SAAS;EAEf,KAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,SAAS,MAAO,QAAoC;IAAE,QAAQ,OAAO;IAAQ,UAAU,OAAO;IAAU;IAAM,CAAC;GAErH,IAAI,OAAO,WAAW,UACpB,OAAO;;EAIX,OAAO;;;;;CAMT,MAAM,mBAAmB,QAAoF;EAC3G,MAAM,WAAW,KAAK,SAAS,IAAI,iBAAiB,IAAI,EAAE;EAE1D,IAAI,EAAE,SAAS;EAEf,KAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,SAAS,MAAO,QAAuC;IAAE,QAAQ,OAAO;IAAQ,UAAU,OAAO;IAAU;IAAM,CAAC;GAExH,IAAI,OAAO,WAAW,UACpB,OAAO;;EAIX,OAAO;;;;;CAMT,MAAM,eAAe,QAAoD;EACvE,MAAM,WAAW,KAAK,SAAS,IAAI,aAAa,IAAI,EAAE;EAEtD,KAAK,MAAM,WAAW,UACpB,MAAO,QAAmC,OAAO;;;;;;;;;;CAYrD,iBAAiB,SAAsB;EAAC;EAAgB;EAAe;EAAiB,EAAE;EACxF,KAAK,MAAM,QAAQ,QAAQ;GACzB,MAAM,WAAW,KAAK,SAAS,IAAI,KAAK;GACxC,IAAI,CAAC,UAAU;GACf,MAAM,OAAO,KAAK,mBAAmB,IAAI,KAAK,IAAI;GAClD,IAAI,SAAS,SAAS,MACpB,KAAK,SAAS,IAAI,MAAM,SAAS,MAAM,GAAG,KAAK,CAAC;;;;;;CAQtD,QAAQ;EACN,KAAK,SAAS,OAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/events/index.ts"],"sourcesContent":["import type { ParsedPath } from 'node:path'\nimport type { MaizzleConfig } from '../types/index.ts'\n\nexport type EventName = 'beforeCreate' | 'beforeRender' | 'afterRender' | 'afterTransform' | 'afterBuild'\n\n/**\n * Info about the template currently being processed, passed to per-template\n * event handlers. `source` is the SFC file contents; `path` is the result of\n * `path.parse(absolutePath)` — `{ root, dir, base, ext, name }`.\n */\nexport interface TemplateInfo {\n  source: string\n  path: ParsedPath\n}\n\nexport interface EventMap {\n  beforeCreate: (params: { config: MaizzleConfig }) => void | Promise<void>\n  beforeRender: (params: { config: MaizzleConfig; template: TemplateInfo }) => string | void | Promise<string | void>\n  afterRender: (params: { config: MaizzleConfig; template: TemplateInfo; html: string }) => string | void | Promise<string | void>\n  afterTransform: (params: { config: MaizzleConfig; template: TemplateInfo; html: string }) => string | void | Promise<string | void>\n  afterBuild: (params: { files: string[]; config: MaizzleConfig }) => void | Promise<void>\n}\n\n/**\n * Central event manager that collects handlers from config and useEvent() calls.\n *\n * Handlers are run in order: config handler first, then SFC handlers in registration order.\n * For events that return a value (beforeRender, afterRender, afterTransform),\n * the returned value replaces the corresponding input for the next handler.\n */\nexport class EventManager {\n  private handlers = new Map<EventName, EventMap[EventName][]>()\n  // Snapshot of config-handler counts per event, captured at registerConfig().\n  // clearSfcHandlers() truncates each list back to this count, dropping any\n  // SFC-registered handlers that were appended after.\n  private configHandlerCount = new Map<EventName, number>()\n\n  /**\n   * Register handlers from the Maizzle config.\n   */\n  registerConfig(config: MaizzleConfig) {\n    const eventNames: EventName[] = ['beforeCreate', 'beforeRender', 'afterRender', 'afterTransform', 'afterBuild']\n\n    for (const name of eventNames) {\n      const handler = config[name]\n      if (typeof handler === 'function') {\n        this.on(name, handler as EventMap[typeof name])\n      }\n      this.configHandlerCount.set(name, this.handlers.get(name)?.length ?? 0)\n    }\n  }\n\n  /**\n   * Register a handler for an event (used by useEvent composable).\n   */\n  on<K extends EventName>(name: K, handler: EventMap[K]) {\n    if (!this.handlers.has(name)) {\n      this.handlers.set(name, [])\n    }\n\n    this.handlers.get(name)!.push(handler)\n  }\n\n  /**\n   * Fire beforeCreate — runs all handlers, config is mutated in place.\n   */\n  async fireBeforeCreate(params: { config: MaizzleConfig }) {\n    const handlers = this.handlers.get('beforeCreate') ?? []\n\n    for (const handler of handlers) {\n      await (handler as EventMap['beforeCreate'])(params)\n    }\n  }\n\n  /**\n   * Fire beforeRender — if a handler returns a string, it replaces\n   * `template.source` for subsequent handlers and the renderer.\n   */\n  async fireBeforeRender(params: { config: MaizzleConfig; template: TemplateInfo }): Promise<string> {\n    const handlers = this.handlers.get('beforeRender') ?? []\n\n    for (const handler of handlers) {\n      const result = await (handler as EventMap['beforeRender'])(params)\n\n      if (typeof result === 'string') {\n        params.template.source = result\n      }\n    }\n\n    return params.template.source\n  }\n\n  /**\n   * Fire afterRender — if a handler returns a string, it replaces `html`.\n   */\n  async fireAfterRender(params: { config: MaizzleConfig; template: TemplateInfo; html: string }): Promise<string> {\n    const handlers = this.handlers.get('afterRender') ?? []\n\n    let { html } = params\n\n    for (const handler of handlers) {\n      const result = await (handler as EventMap['afterRender'])({ config: params.config, template: params.template, html })\n\n      if (typeof result === 'string') {\n        html = result\n      }\n    }\n\n    return html\n  }\n\n  /**\n   * Fire afterTransform — if a handler returns a string, it replaces `html`.\n   */\n  async fireAfterTransform(params: { config: MaizzleConfig; template: TemplateInfo; html: string }): Promise<string> {\n    const handlers = this.handlers.get('afterTransform') ?? []\n\n    let { html } = params\n\n    for (const handler of handlers) {\n      const result = await (handler as EventMap['afterTransform'])({ config: params.config, template: params.template, html })\n\n      if (typeof result === 'string') {\n        html = result\n      }\n    }\n\n    return html\n  }\n\n  /**\n   * Fire afterBuild — runs all handlers with the file list.\n   */\n  async fireAfterBuild(params: { files: string[]; config: MaizzleConfig }) {\n    const handlers = this.handlers.get('afterBuild') ?? []\n\n    for (const handler of handlers) {\n      await (handler as EventMap['afterBuild'])(params)\n    }\n  }\n\n  /**\n   * Drop SFC-registered handlers, keep config-registered ones.\n   *\n   * Per default, only clears events whose scope is per-template\n   * (`beforeRender`, `afterRender`, `afterTransform`). Build-scoped events\n   * (`afterBuild`) accumulate across all templates and fire once at end of\n   * build. Pass an explicit list to override.\n   */\n  clearSfcHandlers(events: EventName[] = ['beforeRender', 'afterRender', 'afterTransform']) {\n    for (const name of events) {\n      const handlers = this.handlers.get(name)\n      if (!handlers) continue\n      const keep = this.configHandlerCount.get(name) ?? 0\n      if (handlers.length > keep) {\n        this.handlers.set(name, handlers.slice(0, keep))\n      }\n    }\n  }\n\n  /**\n   * Clear all handlers entirely.\n   */\n  clear() {\n    this.handlers.clear()\n  }\n}\n"],"mappings":";;;;;;;;AA8BA,IAAa,eAAb,MAA0B;CACxB,2BAAmB,IAAI,KAAuC;CAI9D,qCAA6B,IAAI,KAAwB;;;;CAKzD,eAAe,QAAuB;EAGpC,KAAK,MAAM,QAAQ;GAFc;GAAgB;GAAgB;GAAe;GAAkB;GAErE,EAAE;GAC7B,MAAM,UAAU,OAAO;GACvB,IAAI,OAAO,YAAY,YACrB,KAAK,GAAG,MAAM,QAAiC;GAEjD,KAAK,mBAAmB,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE,UAAU,EAAE;;;;;;CAO3E,GAAwB,MAAS,SAAsB;EACrD,IAAI,CAAC,KAAK,SAAS,IAAI,KAAK,EAC1B,KAAK,SAAS,IAAI,MAAM,EAAE,CAAC;EAG7B,KAAK,SAAS,IAAI,KAAK,CAAE,KAAK,QAAQ;;;;;CAMxC,MAAM,iBAAiB,QAAmC;EACxD,MAAM,WAAW,KAAK,SAAS,IAAI,eAAe,IAAI,EAAE;EAExD,KAAK,MAAM,WAAW,UACpB,MAAO,QAAqC,OAAO;;;;;;CAQvD,MAAM,iBAAiB,QAA4E;EACjG,MAAM,WAAW,KAAK,SAAS,IAAI,eAAe,IAAI,EAAE;EAExD,KAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,SAAS,MAAO,QAAqC,OAAO;GAElE,IAAI,OAAO,WAAW,UACpB,OAAO,SAAS,SAAS;;EAI7B,OAAO,OAAO,SAAS;;;;;CAMzB,MAAM,gBAAgB,QAA0F;EAC9G,MAAM,WAAW,KAAK,SAAS,IAAI,cAAc,IAAI,EAAE;EAEvD,IAAI,EAAE,SAAS;EAEf,KAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,SAAS,MAAO,QAAoC;IAAE,QAAQ,OAAO;IAAQ,UAAU,OAAO;IAAU;IAAM,CAAC;GAErH,IAAI,OAAO,WAAW,UACpB,OAAO;;EAIX,OAAO;;;;;CAMT,MAAM,mBAAmB,QAA0F;EACjH,MAAM,WAAW,KAAK,SAAS,IAAI,iBAAiB,IAAI,EAAE;EAE1D,IAAI,EAAE,SAAS;EAEf,KAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,SAAS,MAAO,QAAuC;IAAE,QAAQ,OAAO;IAAQ,UAAU,OAAO;IAAU;IAAM,CAAC;GAExH,IAAI,OAAO,WAAW,UACpB,OAAO;;EAIX,OAAO;;;;;CAMT,MAAM,eAAe,QAAoD;EACvE,MAAM,WAAW,KAAK,SAAS,IAAI,aAAa,IAAI,EAAE;EAEtD,KAAK,MAAM,WAAW,UACpB,MAAO,QAAmC,OAAO;;;;;;;;;;CAYrD,iBAAiB,SAAsB;EAAC;EAAgB;EAAe;EAAiB,EAAE;EACxF,KAAK,MAAM,QAAQ,QAAQ;GACzB,MAAM,WAAW,KAAK,SAAS,IAAI,KAAK;GACxC,IAAI,CAAC,UAAU;GACf,MAAM,OAAO,KAAK,mBAAmB,IAAI,KAAK,IAAI;GAClD,IAAI,SAAS,SAAS,MACpB,KAAK,SAAS,IAAI,MAAM,SAAS,MAAM,GAAG,KAAK,CAAC;;;;;;CAQtD,QAAQ;EACN,KAAK,SAAS,OAAO"}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import { defineConfig } from "./composables/defineConfig.js";
 import { usePlaintext } from "./composables/usePlaintext.js";
 import { useBaseUrl } from "./composables/useBaseUrl.js";
 import { useConfig } from "./composables/useConfig.js";
+import { useCurrentTemplate } from "./composables/useCurrentTemplate.js";
 import { useDoctype } from "./composables/useDoctype.js";
 import { useEvent } from "./composables/useEvent.js";
 import { useFont } from "./composables/useFont.js";
@@ -22,7 +23,7 @@ import { inlineLink } from "./transformers/inlineLink.js";
 import { urlQuery } from "./transformers/urlQuery.js";
 import { BaseUrlOptions, base } from "./transformers/base.js";
 import { entities } from "./transformers/entities.js";
-import { safeClassNames } from "./transformers/safeClassNames.js";
+import { safeSelectors } from "./transformers/safeSelectors.js";
 import { attributeToStyle } from "./transformers/attributeToStyle.js";
 import { InlineCssOptions, inlineCss } from "./transformers/inlineCss.js";
 import { ShorthandCssOptions, shorthandCss } from "./transformers/shorthandCss.js";
@@ -35,4 +36,4 @@ import { replaceStrings } from "./transformers/replaceStrings.js";
 import { FormatOptions, format } from "./transformers/format.js";
 import { MinifyOptions, minify } from "./transformers/minify.js";
 import { useHead } from "@unhead/vue";
-export { type AttributesConfig, type BaseUrlOptions, type ComponentSource, type CreateRendererOptions, type CssConfig, type EntitiesConfig, type FilterFunction, type FiltersConfig, type FormatOptions, type HtmlConfig, type InlineCssOptions, type MaizzleConfig, type MinifyOptions, type NormalizedComponentSource, type PlaintextConfig, type PrepareOptions, type PurgeCssOptions, type RemoveAttributeOption, type RemoveAttributeRule, type RenderResult, type RenderedTemplate, type Renderer, type ShorthandCssOptions, type UrlConfig, type UrlQuery, type UrlQueryOptions, addAttributes, attributeToStyle, base, build, createPlaintext, createRenderer, defineConfig, entities, filters, format, inlineCss, inlineLink, maizzle, minify, normalizeComponentSources, prepare, purgeCss, removeAttributes, render, replaceStrings, resolveConfig, safeClassNames, serve, shorthandCss, sixHex, urlQuery, useBaseUrl, useConfig, useDoctype, useEvent, useFont, useHead, useOutlookFallback, usePlaintext, useTransformers, useUrlQuery };
+export { type AttributesConfig, type BaseUrlOptions, type ComponentSource, type CreateRendererOptions, type CssConfig, type EntitiesConfig, type FilterFunction, type FiltersConfig, type FormatOptions, type HtmlConfig, type InlineCssOptions, type MaizzleConfig, type MinifyOptions, type NormalizedComponentSource, type PlaintextConfig, type PrepareOptions, type PurgeCssOptions, type RemoveAttributeOption, type RemoveAttributeRule, type RenderResult, type RenderedTemplate, type Renderer, type ShorthandCssOptions, type UrlConfig, type UrlQuery, type UrlQueryOptions, addAttributes, attributeToStyle, base, build, createPlaintext, createRenderer, defineConfig, entities, filters, format, inlineCss, inlineLink, maizzle, minify, normalizeComponentSources, prepare, purgeCss, removeAttributes, render, replaceStrings, resolveConfig, safeSelectors, serve, shorthandCss, sixHex, urlQuery, useBaseUrl, useConfig, useCurrentTemplate, useDoctype, useEvent, useFont, useHead, useOutlookFallback, usePlaintext, useTransformers, useUrlQuery };

package/dist/index.js

@@ -2,7 +2,7 @@ import { useConfig } from "./composables/useConfig.js";
 import { defineConfig } from "./composables/defineConfig.js";
 import { resolveConfig } from "./config/index.js";
 import { inlineLink } from "./transformers/inlineLink.js";
-import { safeClassNames } from "./transformers/safeClassNames.js";
+import { safeSelectors } from "./transformers/safeSelectors.js";
 import { attributeToStyle } from "./transformers/attributeToStyle.js";
 import { inlineCss } from "./transformers/inlineCss.js";
 import { removeAttributes } from "./transformers/removeAttributes.js";
@@ -20,6 +20,7 @@ import { minify } from "./transformers/minify.js";
 import { normalizeComponentSources } from "./utils/componentSources.js";
 import { createRenderer } from "./render/createRenderer.js";
 import { createPlaintext } from "./plaintext.js";
+import { useCurrentTemplate } from "./composables/useCurrentTemplate.js";
 import { build } from "./build.js";
 import { maizzle } from "./plugin.js";
 import { render } from "./render/index.js";
@@ -34,4 +35,4 @@ import { useTransformers } from "./composables/useTransformers.js";
 import { useBaseUrl } from "./composables/useBaseUrl.js";
 import { useUrlQuery } from "./composables/useUrlQuery.js";
 import { useHead } from "@unhead/vue";
-export { addAttributes, attributeToStyle, base, build, createPlaintext, createRenderer, defineConfig, entities, filters, format, inlineCss, inlineLink, maizzle, minify, normalizeComponentSources, prepare, purgeCss, removeAttributes, render, replaceStrings, resolveConfig, safeClassNames, serve, shorthandCss, sixHex, urlQuery, useBaseUrl, useConfig, useDoctype, useEvent, useFont, useHead, useOutlookFallback, usePlaintext, useTransformers, useUrlQuery };
+export { addAttributes, attributeToStyle, base, build, createPlaintext, createRenderer, defineConfig, entities, filters, format, inlineCss, inlineLink, maizzle, minify, normalizeComponentSources, prepare, purgeCss, removeAttributes, render, replaceStrings, resolveConfig, safeSelectors, serve, shorthandCss, sixHex, urlQuery, useBaseUrl, useConfig, useCurrentTemplate, useDoctype, useEvent, useFont, useHead, useOutlookFallback, usePlaintext, useTransformers, useUrlQuery };

package/dist/render/createRenderer.js

@@ -246,7 +246,8 @@ async function createRenderer(options = {}) {
 			const app = createSSRApp(component);
 			app.use(head);
 			if (config.vue) {
-				for (const plugin of config.vue.plugins ?? []) app.use(plugin);
+				const plugins = typeof config.vue.plugins === "function" ? config.vue.plugins() : config.vue.plugins ?? [];
+				for (const plugin of plugins) app.use(plugin);
 				for (const [name, directive] of Object.entries(config.vue.directives ?? {})) app.directive(name, directive);
 				Object.assign(app.config.globalProperties, config.vue.globalProperties);
 			}
@@ -286,8 +287,8 @@ async function createRenderer(options = {}) {
 				html = serializeDom(dom);
 			}
 			if (renderContext.preheader) {
-				const { text, fillerCount, shyCount } = renderContext.preheader;
-				const previewHtml = `<div style="display:none">${text}${" ͏ ".repeat(fillerCount)}${"­ ".repeat(shyCount)}\u00A0</div>`;
+				const { text, fillerCount } = renderContext.preheader;
+				const previewHtml = `<div style="display:none">${text}${" ͏ ".repeat(fillerCount)}\u00A0</div>`;
 				html = html.replace(/<body([^>]*)>/, `<body$1>${previewHtml}`);
 			}
 			html = html.replaceAll("<!--[-->", "").replaceAll("<!--]-->", "").replaceAll("<!--teleport start anchor-->", "").replaceAll("<!--teleport anchor-->", "").replaceAll("<!--teleport start-->", "").replaceAll("<!--teleport end-->", "");