@maizzle/framework 6.1.6 → 6.2.0

package/dist/render/index.js

@@ -9,14 +9,66 @@ import { extname, resolve } from "pathe";
 import defu from "defu";
 //#region src/render/index.ts
 /**
+* Keys read by rendererOptions() when the instance is created. Passing
+* them per render would silently do nothing, so reject them instead.
+*/
+function assertNoRendererOverrides(config) {
+	const overrides = [
+		config.root !== void 0 && "root",
+		config.markdown !== void 0 && "markdown",
+		config.vite !== void 0 && "vite",
+		config.components?.source !== void 0 && "components.source",
+		config.vue?.customElements !== void 0 && "vue.customElements"
+	].filter(Boolean);
+	if (overrides.length) throw new Error(`${overrides.join(", ")} can only be set in createMaizzle(), not per render.`);
+}
+function rendererOptions(config) {
+	return {
+		markdown: config.markdown,
+		root: config.root,
+		componentDirs: normalizeComponentSources(config.components?.source, process.cwd()),
+		vite: config.vite,
+		customElements: config.vue?.customElements
+	};
+}
+/**
+* Run a template through a renderer and the post-render pipeline
+* (transformers, doctype, plaintext). Shared by the one-shot render()
+* and instances from createMaizzle().
+*/
+async function renderWith(renderer, template, resolvedConfig) {
+	if (template == null) throw new Error(`render() received ${template}. If you used \`import X from './x.vue'\`, Node cannot load .vue files natively — pass the path string instead: render('./x.vue').`);
+	if (typeof template !== "string" && typeof template !== "object" && typeof template !== "function") throw new TypeError(`render() expected a file path or SFC source string, got ${typeof template}.`);
+	const { props, ...templateConfig } = resolvedConfig;
+	const isFile = typeof template === "string" && [".vue", ".md"].includes(extname(template)) && !template.includes("\n");
+	const rendered = await renderer.render(isFile ? resolve(template) : template, templateConfig, { props });
+	let html = rendered.html;
+	const doctype = rendered.doctype ?? rendered.templateConfig.doctype ?? "<!DOCTYPE html>";
+	html = await runTransformers(html, rendered.templateConfig, isFile ? resolve(template) : void 0, doctype, rendered.tailwindBlocks);
+	if (doctype) html = `${doctype}\n${html}`;
+	const globalPlaintext = rendered.templateConfig.plaintext;
+	const sfcPlaintext = rendered.plaintext;
+	let plaintextResult;
+	if (globalPlaintext || sfcPlaintext) {
+		const globalCfg = typeof globalPlaintext === "object" ? globalPlaintext : {};
+		const stripOptions = defu(sfcPlaintext?.options, globalCfg.options);
+		plaintextResult = createPlaintext(stripForPlaintext(html), stripOptions);
+	}
+	return {
+		html: stripForHtml(html),
+		config: rendered.templateConfig,
+		plaintext: plaintextResult
+	};
+}
+/**
 * Render a Vue SFC email template to a fully-transformed HTML string.
 * Accepts a file path or a raw SFC source string.
+*
+* Starts and stops a Vite SSR server per call. For repeated renders in a
+* long-running process, use createMaizzle() instead.
 */
 async function render(template, config) {
-	if (template == null) throw new Error(`render() received ${template}. If you used \`import X from './x.vue'\`, Node cannot load .vue files natively — pass the path string instead: render('./x.vue').`);
-	if (typeof template !== "string" && typeof template !== "object" && typeof template !== "function") throw new TypeError(`render() expected a file path or SFC source string, got ${typeof template}.`);
 	const resolvedConfig = resolveConfigObject(config);
-	const { props, ...templateConfig } = resolvedConfig;
 	/**
 	* Reuse a renderer started by the Vite plugin when one is active.
 	* Spinning up a fresh Vite SSR server inside a host Vite dev process
@@ -24,38 +76,32 @@ async function render(template, config) {
 	* "outsideEmitter undefined".
 	*/
 	const active = getActiveRenderer();
-	const renderer = active ?? await createRenderer({
-		markdown: resolvedConfig.markdown,
-		root: resolvedConfig.root,
-		componentDirs: normalizeComponentSources(resolvedConfig.components?.source, process.cwd()),
-		vite: resolvedConfig.vite,
-		customElements: resolvedConfig.vue?.customElements
-	});
+	const renderer = active ?? await createRenderer(rendererOptions(resolvedConfig));
 	try {
-		const isFile = typeof template === "string" && [".vue", ".md"].includes(extname(template)) && !template.includes("\n");
-		const rendered = await renderer.render(isFile ? resolve(template) : template, templateConfig, { props });
-		let html = rendered.html;
-		const doctype = rendered.doctype ?? rendered.templateConfig.doctype ?? "<!DOCTYPE html>";
-		html = await runTransformers(html, rendered.templateConfig, isFile ? resolve(template) : void 0, doctype, rendered.tailwindBlocks);
-		if (doctype) html = `${doctype}\n${html}`;
-		const globalPlaintext = rendered.templateConfig.plaintext;
-		const sfcPlaintext = rendered.plaintext;
-		let plaintextResult;
-		if (globalPlaintext || sfcPlaintext) {
-			const globalCfg = typeof globalPlaintext === "object" ? globalPlaintext : {};
-			const stripOptions = defu(sfcPlaintext?.options, globalCfg.options);
-			plaintextResult = createPlaintext(stripForPlaintext(html), stripOptions);
-		}
-		return {
-			html: stripForHtml(html),
-			config: rendered.templateConfig,
-			plaintext: plaintextResult
-		};
+		return await renderWith(renderer, template, resolvedConfig);
 	} finally {
 		if (!active) await renderer.close();
 	}
 }
+/**
+* Create a Maizzle instance that keeps one Vite SSR server alive across
+* renders. Use this when rendering emails on demand in a long-running
+* process, where the per-call startup cost of render() adds up.
+*/
+async function createMaizzle(config) {
+	const baseConfig = config ?? {};
+	const renderer = await createRenderer(rendererOptions(resolveConfigObject(baseConfig)));
+	return {
+		async render(template, renderConfig) {
+			if (renderConfig) assertNoRendererOverrides(renderConfig);
+			return renderWith(renderer, template, resolveConfigObject(defu(renderConfig, baseConfig)));
+		},
+		close() {
+			return renderer.close();
+		}
+	};
+}
 //#endregion
-export { createRenderer, render };
+export { createMaizzle, createRenderer, render };
 
 //# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/render/index.ts"],"sourcesContent":["import { resolve, extname } from 'pathe'\nimport { resolveConfigObject } from '../config/index.ts'\nimport { runTransformers } from '../transformers/index.ts'\nimport { createPlaintext } from '../plaintext.ts'\nimport { stripForHtml, stripForPlaintext } from '../utils/output-markers.ts'\nimport defu from 'defu'\nimport type { Component } from 'vue'\nimport type { MaizzleConfig } from '../types/index.ts'\nimport { createRenderer } from './createRenderer.ts'\nimport { getActiveRenderer } from './active.ts'\nimport { normalizeComponentSources } from '../utils/componentSources.ts'\n\nexport type { Renderer, RenderedTemplate, CreateRendererOptions } from './createRenderer.ts'\nexport { createRenderer } from './createRenderer.ts'\n\nexport interface RenderResult {\n  html: string\n  config: MaizzleConfig\n  plaintext?: string\n}\n\n/**\n * Render a Vue SFC email template to a fully-transformed HTML string.\n * Accepts a file path or a raw SFC source string.\n */\nexport async function render(\n  template: string | Component,\n  config?: Partial<MaizzleConfig>,\n): Promise<RenderResult> {\n  if (template == null) {\n    throw new Error(\n      `render() received ${template}. If you used \\`import X from './x.vue'\\`, Node cannot load .vue files natively — pass the path string instead: render('./x.vue').`,\n    )\n  }\n  if (typeof template !== 'string' && typeof template !== 'object' && typeof template !== 'function') {\n    throw new TypeError(\n      `render() expected a file path or SFC source string, got ${typeof template}.`,\n    )\n  }\n\n  const resolvedConfig = resolveConfigObject(config)\n  const { props, ...templateConfig } = resolvedConfig\n\n  /**\n   * Reuse a renderer started by the Vite plugin when one is active.\n   * Spinning up a fresh Vite SSR server inside a host Vite dev process\n   * (e.g. TanStack Start) collides on env wiring and throws\n   * \"outsideEmitter undefined\".\n   */\n  const active = getActiveRenderer()\n  const renderer = active ?? await createRenderer({\n    markdown: resolvedConfig.markdown,\n    root: resolvedConfig.root,\n    componentDirs: normalizeComponentSources(resolvedConfig.components?.source, process.cwd()),\n    vite: resolvedConfig.vite,\n    customElements: resolvedConfig.vue?.customElements,\n  })\n\n  try {\n    const isFile = typeof template === 'string'\n      && ['.vue', '.md'].includes(extname(template))\n      && !template.includes('\\n')\n\n    const rendered = await renderer.render(isFile ? resolve(template) : template, templateConfig, { props })\n    let html = rendered.html\n\n    const doctype = rendered.doctype ?? rendered.templateConfig.doctype ?? '<!DOCTYPE html>'\n\n    html = await runTransformers(html, rendered.templateConfig, isFile ? resolve(template) : undefined, doctype, rendered.tailwindBlocks)\n    if (doctype) html = `${doctype}\\n${html}`\n\n    const globalPlaintext = rendered.templateConfig.plaintext\n    const sfcPlaintext = rendered.plaintext\n\n    let plaintextResult: string | undefined\n\n    if (globalPlaintext || sfcPlaintext) {\n      const globalCfg = typeof globalPlaintext === 'object' ? globalPlaintext : {}\n      const stripOptions = defu(sfcPlaintext?.options, globalCfg.options)\n      plaintextResult = createPlaintext(stripForPlaintext(html), stripOptions)\n    }\n\n    return { html: stripForHtml(html), config: rendered.templateConfig, plaintext: plaintextResult }\n  } finally {\n    if (!active) await renderer.close()\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAyBA,eAAsB,OACpB,UACA,QACuB;CACvB,IAAI,YAAY,MACd,MAAM,IAAI,MACR,qBAAqB,SAAS,mIAChC;CAEF,IAAI,OAAO,aAAa,YAAY,OAAO,aAAa,YAAY,OAAO,aAAa,YACtF,MAAM,IAAI,UACR,2DAA2D,OAAO,SAAS,EAC7E;CAGF,MAAM,iBAAiB,oBAAoB,MAAM;CACjD,MAAM,EAAE,OAAO,GAAG,mBAAmB;;;;;;;CAQrC,MAAM,SAAS,kBAAkB;CACjC,MAAM,WAAW,UAAU,MAAM,eAAe;EAC9C,UAAU,eAAe;EACzB,MAAM,eAAe;EACrB,eAAe,0BAA0B,eAAe,YAAY,QAAQ,QAAQ,IAAI,CAAC;EACzF,MAAM,eAAe;EACrB,gBAAgB,eAAe,KAAK;CACtC,CAAC;CAED,IAAI;EACF,MAAM,SAAS,OAAO,aAAa,YAC9B,CAAC,QAAQ,KAAK,CAAC,CAAC,SAAS,QAAQ,QAAQ,CAAC,KAC1C,CAAC,SAAS,SAAS,IAAI;EAE5B,MAAM,WAAW,MAAM,SAAS,OAAO,SAAS,QAAQ,QAAQ,IAAI,UAAU,gBAAgB,EAAE,MAAM,CAAC;EACvG,IAAI,OAAO,SAAS;EAEpB,MAAM,UAAU,SAAS,WAAW,SAAS,eAAe,WAAW;EAEvE,OAAO,MAAM,gBAAgB,MAAM,SAAS,gBAAgB,SAAS,QAAQ,QAAQ,IAAI,KAAA,GAAW,SAAS,SAAS,cAAc;EACpI,IAAI,SAAS,OAAO,GAAG,QAAQ,IAAI;EAEnC,MAAM,kBAAkB,SAAS,eAAe;EAChD,MAAM,eAAe,SAAS;EAE9B,IAAI;EAEJ,IAAI,mBAAmB,cAAc;GACnC,MAAM,YAAY,OAAO,oBAAoB,WAAW,kBAAkB,CAAC;GAC3E,MAAM,eAAe,KAAK,cAAc,SAAS,UAAU,OAAO;GAClE,kBAAkB,gBAAgB,kBAAkB,IAAI,GAAG,YAAY;EACzE;EAEA,OAAO;GAAE,MAAM,aAAa,IAAI;GAAG,QAAQ,SAAS;GAAgB,WAAW;EAAgB;CACjG,UAAU;EACR,IAAI,CAAC,QAAQ,MAAM,SAAS,MAAM;CACpC;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/render/index.ts"],"sourcesContent":["import { resolve, extname } from 'pathe'\nimport { resolveConfigObject } from '../config/index.ts'\nimport { runTransformers } from '../transformers/index.ts'\nimport { createPlaintext } from '../plaintext.ts'\nimport { stripForHtml, stripForPlaintext } from '../utils/output-markers.ts'\nimport defu from 'defu'\nimport type { Component } from 'vue'\nimport type { MaizzleConfig } from '../types/index.ts'\nimport { createRenderer, type Renderer } from './createRenderer.ts'\nimport { getActiveRenderer } from './active.ts'\nimport { normalizeComponentSources } from '../utils/componentSources.ts'\n\nexport type { Renderer, RenderedTemplate, CreateRendererOptions } from './createRenderer.ts'\nexport { createRenderer } from './createRenderer.ts'\n\nexport interface RenderResult {\n  html: string\n  config: MaizzleConfig\n  plaintext?: string\n}\n\nexport interface MaizzleInstance {\n  /**\n   * Render a template through the full pipeline, reusing this instance's\n   * renderer. `config` is merged over the config the instance was created\n   * with. Keys that shape the renderer (`root`, `markdown`, `vite`,\n   * `components.source`, `vue.customElements`) can only be set when\n   * creating the instance and throw here. Safe to call concurrently.\n   */\n  render(template: string | Component, config?: Partial<MaizzleConfig>): Promise<RenderResult>\n  /** Shut down the underlying Vite SSR server. */\n  close(): Promise<void>\n}\n\n/**\n * Keys read by rendererOptions() when the instance is created. Passing\n * them per render would silently do nothing, so reject them instead.\n */\nfunction assertNoRendererOverrides(config: Partial<MaizzleConfig>): void {\n  const overrides = [\n    config.root !== undefined && 'root',\n    config.markdown !== undefined && 'markdown',\n    config.vite !== undefined && 'vite',\n    config.components?.source !== undefined && 'components.source',\n    config.vue?.customElements !== undefined && 'vue.customElements',\n  ].filter(Boolean)\n\n  if (overrides.length) {\n    throw new Error(\n      `${overrides.join(', ')} can only be set in createMaizzle(), not per render.`,\n    )\n  }\n}\n\nfunction rendererOptions(config: MaizzleConfig) {\n  return {\n    markdown: config.markdown,\n    root: config.root,\n    componentDirs: normalizeComponentSources(config.components?.source, process.cwd()),\n    vite: config.vite,\n    customElements: config.vue?.customElements,\n  }\n}\n\n/**\n * Run a template through a renderer and the post-render pipeline\n * (transformers, doctype, plaintext). Shared by the one-shot render()\n * and instances from createMaizzle().\n */\nasync function renderWith(\n  renderer: Renderer,\n  template: string | Component,\n  resolvedConfig: MaizzleConfig,\n): Promise<RenderResult> {\n  if (template == null) {\n    throw new Error(\n      `render() received ${template}. If you used \\`import X from './x.vue'\\`, Node cannot load .vue files natively — pass the path string instead: render('./x.vue').`,\n    )\n  }\n  if (typeof template !== 'string' && typeof template !== 'object' && typeof template !== 'function') {\n    throw new TypeError(\n      `render() expected a file path or SFC source string, got ${typeof template}.`,\n    )\n  }\n\n  const { props, ...templateConfig } = resolvedConfig\n\n  const isFile = typeof template === 'string'\n    && ['.vue', '.md'].includes(extname(template))\n    && !template.includes('\\n')\n\n  const rendered = await renderer.render(isFile ? resolve(template) : template, templateConfig, { props })\n  let html = rendered.html\n\n  const doctype = rendered.doctype ?? rendered.templateConfig.doctype ?? '<!DOCTYPE html>'\n\n  html = await runTransformers(html, rendered.templateConfig, isFile ? resolve(template) : undefined, doctype, rendered.tailwindBlocks)\n  if (doctype) html = `${doctype}\\n${html}`\n\n  const globalPlaintext = rendered.templateConfig.plaintext\n  const sfcPlaintext = rendered.plaintext\n\n  let plaintextResult: string | undefined\n\n  if (globalPlaintext || sfcPlaintext) {\n    const globalCfg = typeof globalPlaintext === 'object' ? globalPlaintext : {}\n    const stripOptions = defu(sfcPlaintext?.options, globalCfg.options)\n    plaintextResult = createPlaintext(stripForPlaintext(html), stripOptions)\n  }\n\n  return { html: stripForHtml(html), config: rendered.templateConfig, plaintext: plaintextResult }\n}\n\n/**\n * Render a Vue SFC email template to a fully-transformed HTML string.\n * Accepts a file path or a raw SFC source string.\n *\n * Starts and stops a Vite SSR server per call. For repeated renders in a\n * long-running process, use createMaizzle() instead.\n */\nexport async function render(\n  template: string | Component,\n  config?: Partial<MaizzleConfig>,\n): Promise<RenderResult> {\n  const resolvedConfig = resolveConfigObject(config)\n\n  /**\n   * Reuse a renderer started by the Vite plugin when one is active.\n   * Spinning up a fresh Vite SSR server inside a host Vite dev process\n   * (e.g. TanStack Start) collides on env wiring and throws\n   * \"outsideEmitter undefined\".\n   */\n  const active = getActiveRenderer()\n  const renderer = active ?? await createRenderer(rendererOptions(resolvedConfig))\n\n  try {\n    return await renderWith(renderer, template, resolvedConfig)\n  } finally {\n    if (!active) await renderer.close()\n  }\n}\n\n/**\n * Create a Maizzle instance that keeps one Vite SSR server alive across\n * renders. Use this when rendering emails on demand in a long-running\n * process, where the per-call startup cost of render() adds up.\n */\nexport async function createMaizzle(config?: Partial<MaizzleConfig>): Promise<MaizzleInstance> {\n  const baseConfig = config ?? {}\n  const renderer = await createRenderer(rendererOptions(resolveConfigObject(baseConfig)))\n\n  return {\n    async render(template, renderConfig) {\n      if (renderConfig) assertNoRendererOverrides(renderConfig)\n      return renderWith(renderer, template, resolveConfigObject(defu(renderConfig, baseConfig)))\n    },\n    close() {\n      return renderer.close()\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAsCA,SAAS,0BAA0B,QAAsC;CACvE,MAAM,YAAY;EAChB,OAAO,SAAS,KAAA,KAAa;EAC7B,OAAO,aAAa,KAAA,KAAa;EACjC,OAAO,SAAS,KAAA,KAAa;EAC7B,OAAO,YAAY,WAAW,KAAA,KAAa;EAC3C,OAAO,KAAK,mBAAmB,KAAA,KAAa;CAC9C,CAAC,CAAC,OAAO,OAAO;CAEhB,IAAI,UAAU,QACZ,MAAM,IAAI,MACR,GAAG,UAAU,KAAK,IAAI,EAAE,qDAC1B;AAEJ;AAEA,SAAS,gBAAgB,QAAuB;CAC9C,OAAO;EACL,UAAU,OAAO;EACjB,MAAM,OAAO;EACb,eAAe,0BAA0B,OAAO,YAAY,QAAQ,QAAQ,IAAI,CAAC;EACjF,MAAM,OAAO;EACb,gBAAgB,OAAO,KAAK;CAC9B;AACF;;;;;;AAOA,eAAe,WACb,UACA,UACA,gBACuB;CACvB,IAAI,YAAY,MACd,MAAM,IAAI,MACR,qBAAqB,SAAS,mIAChC;CAEF,IAAI,OAAO,aAAa,YAAY,OAAO,aAAa,YAAY,OAAO,aAAa,YACtF,MAAM,IAAI,UACR,2DAA2D,OAAO,SAAS,EAC7E;CAGF,MAAM,EAAE,OAAO,GAAG,mBAAmB;CAErC,MAAM,SAAS,OAAO,aAAa,YAC9B,CAAC,QAAQ,KAAK,CAAC,CAAC,SAAS,QAAQ,QAAQ,CAAC,KAC1C,CAAC,SAAS,SAAS,IAAI;CAE5B,MAAM,WAAW,MAAM,SAAS,OAAO,SAAS,QAAQ,QAAQ,IAAI,UAAU,gBAAgB,EAAE,MAAM,CAAC;CACvG,IAAI,OAAO,SAAS;CAEpB,MAAM,UAAU,SAAS,WAAW,SAAS,eAAe,WAAW;CAEvE,OAAO,MAAM,gBAAgB,MAAM,SAAS,gBAAgB,SAAS,QAAQ,QAAQ,IAAI,KAAA,GAAW,SAAS,SAAS,cAAc;CACpI,IAAI,SAAS,OAAO,GAAG,QAAQ,IAAI;CAEnC,MAAM,kBAAkB,SAAS,eAAe;CAChD,MAAM,eAAe,SAAS;CAE9B,IAAI;CAEJ,IAAI,mBAAmB,cAAc;EACnC,MAAM,YAAY,OAAO,oBAAoB,WAAW,kBAAkB,CAAC;EAC3E,MAAM,eAAe,KAAK,cAAc,SAAS,UAAU,OAAO;EAClE,kBAAkB,gBAAgB,kBAAkB,IAAI,GAAG,YAAY;CACzE;CAEA,OAAO;EAAE,MAAM,aAAa,IAAI;EAAG,QAAQ,SAAS;EAAgB,WAAW;CAAgB;AACjG;;;;;;;;AASA,eAAsB,OACpB,UACA,QACuB;CACvB,MAAM,iBAAiB,oBAAoB,MAAM;;;;;;;CAQjD,MAAM,SAAS,kBAAkB;CACjC,MAAM,WAAW,UAAU,MAAM,eAAe,gBAAgB,cAAc,CAAC;CAE/E,IAAI;EACF,OAAO,MAAM,WAAW,UAAU,UAAU,cAAc;CAC5D,UAAU;EACR,IAAI,CAAC,QAAQ,MAAM,SAAS,MAAM;CACpC;AACF;;;;;;AAOA,eAAsB,cAAc,QAA2D;CAC7F,MAAM,aAAa,UAAU,CAAC;CAC9B,MAAM,WAAW,MAAM,eAAe,gBAAgB,oBAAoB,UAAU,CAAC,CAAC;CAEtF,OAAO;EACL,MAAM,OAAO,UAAU,cAAc;GACnC,IAAI,cAAc,0BAA0B,YAAY;GACxD,OAAO,WAAW,UAAU,UAAU,oBAAoB,KAAK,cAAc,UAAU,CAAC,CAAC;EAC3F;EACA,QAAQ;GACN,OAAO,SAAS,MAAM;EACxB;CACF;AACF"}

package/dist/render/plugins/previewProps.d.ts

@@ -0,0 +1,13 @@
+import { Plugin } from "vite";
+//#region src/render/plugins/previewProps.d.ts
+/**
+ * Vite plugin that compiles the `definePreviewProps()` macro.
+ *
+ * Runs after plugin-vue (and TS stripping), so it sees plain JS. Blanks
+ * out the call inside `setup()`, then re-exports the component wrapped
+ * with `withPreviewProps()`, which gets the macro argument as a
+ * lazy factory evaluated at module scope.
+ */
+export declare function previewProps(runtimePath: string): Plugin;
+//#endregion
+//# sourceMappingURL=previewProps.d.ts.map

package/dist/render/plugins/previewProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewProps.d.ts","names":[],"sources":["../../../src/render/plugins/previewProps.ts"],"mappings":";;;;;;;;;;wBAmIgB,aAAa,sBAAsB"}

package/dist/render/plugins/previewProps.js

@@ -0,0 +1,185 @@
+import { parseAst } from "vite";
+//#region src/render/plugins/previewProps.ts
+const MACRO = "definePreviewProps";
+/**
+* Collect binding names from a declaration target: `a`, `{ a, b: c }`,
+* `[a, ...rest]`, `a = 1`.
+*/
+function patternNames(node, out) {
+	if (!node) return;
+	if (node.type === "Identifier") out.add(node.name);
+	else if (node.type === "ObjectPattern") node.properties.forEach((p) => patternNames(p.type === "RestElement" ? p : p.value, out));
+	else if (node.type === "ArrayPattern") node.elements.forEach((e) => patternNames(e, out));
+	else if (node.type === "AssignmentPattern") patternNames(node.left, out);
+	else if (node.type === "RestElement") patternNames(node.argument, out);
+}
+/**
+* Names declared directly in a statement list (not in nested blocks).
+* Imports are left out on purpose: they're allowed in the macro.
+*/
+function declaredNames(statements, out) {
+	for (let node of statements) {
+		if (node.type === "ExportNamedDeclaration") node = node.declaration;
+		if (!node) continue;
+		if (node.type === "VariableDeclaration") node.declarations.forEach((d) => patternNames(d.id, out));
+		else if ((node.type === "FunctionDeclaration" || node.type === "ClassDeclaration") && node.id) out.add(node.id.name);
+	}
+}
+/**
+* Identifiers an expression reads, minus the ones it declares itself
+* (arrow function params, inner variables) and property names.
+*/
+function referencedNames(root) {
+	const refs = /* @__PURE__ */ new Set();
+	const own = /* @__PURE__ */ new Set();
+	const visit = (node, parent, key) => {
+		if (!node || typeof node.type !== "string") return;
+		if (node.type === "Identifier") {
+			if (!(!parent?.computed && (parent?.type === "MemberExpression" && key === "property" || (parent?.type === "Property" || parent?.type === "MethodDefinition") && key === "key"))) refs.add(node.name);
+			return;
+		}
+		if (node.type === "VariableDeclarator") patternNames(node.id, own);
+		if (node.params) node.params.forEach((p) => patternNames(p, own));
+		if (node.type === "CatchClause") patternNames(node.param, own);
+		for (const [k, value] of Object.entries(node)) if (Array.isArray(value)) value.forEach((child) => visit(child, node, k));
+		else if (value && typeof value === "object") visit(value, node, k);
+	};
+	visit(root);
+	return [...refs].filter((name) => !own.has(name));
+}
+/**
+* Imports read only by the macro arguments, plus the `__returned__` getters
+* Vue adds for them in non-TS templates. Every other identifier counts
+* as a use (even property names like `$setup.x`), so when in doubt
+* an import stays where it is.
+*/
+function previewOnlyImports(ast, args) {
+	const imports = ast.body.filter((n) => n.type === "ImportDeclaration" && n.specifiers.length && !n.attributes?.length);
+	const names = new Set(imports.flatMap((n) => n.specifiers.map((s) => s.local.name)));
+	let getters = [];
+	const used = /* @__PURE__ */ new Set();
+	const skip = /* @__PURE__ */ new Set([...args, ...imports]);
+	const visit = (node, parent, key) => {
+		if (!node || typeof node.type !== "string" || skip.has(node)) return;
+		if (node.type === "VariableDeclarator" && node.id.name === "__returned__" && node.init?.type === "ObjectExpression") {
+			getters = node.init.properties.filter((p) => p.kind === "get" && names.has(p.key?.name));
+			getters.forEach((p) => skip.add(p));
+		}
+		if (node.type === "Identifier") {
+			if (!(parent?.type === "Property" && key === "key" && !parent.computed)) used.add(node.name);
+			return;
+		}
+		for (const [k, value] of Object.entries(node)) if (Array.isArray(value)) value.forEach((child) => visit(child, node, k));
+		else if (value && typeof value === "object") visit(value, node, k);
+	};
+	visit(ast);
+	const inArg = new Set(args.flatMap(referencedNames));
+	const moved = imports.filter((n) => n.specifiers.every((s) => !used.has(s.local.name)) && n.specifiers.some((s) => inArg.has(s.local.name)));
+	const movedNames = new Set(moved.flatMap((n) => n.specifiers.map((s) => s.local.name)));
+	return {
+		imports: moved,
+		getters: getters.filter((p) => movedNames.has(p.key.name))
+	};
+}
+/**
+* `import a, { b as c } from 'x'` -> `const { default: a, b: c } = await import('x')`
+*/
+function dynamicImport(node) {
+	const source = JSON.stringify(node.source.value);
+	const namespace = node.specifiers.find((s) => s.type === "ImportNamespaceSpecifier");
+	const named = node.specifiers.filter((s) => s.type !== "ImportNamespaceSpecifier").map((s) => {
+		if (s.type === "ImportDefaultSpecifier") return `default: ${s.local.name}`;
+		return `${s.imported.type === "Identifier" ? s.imported.name : JSON.stringify(s.imported.value)}: ${s.local.name}`;
+	});
+	return [namespace && `const ${namespace.local.name} = await import(${source})`, named.length && `const { ${named.join(", ")} } = await import(${source})`].filter(Boolean).join("; ");
+}
+/**
+* Vite plugin that compiles the `definePreviewProps()` macro.
+*
+* Runs after plugin-vue (and TS stripping), so it sees plain JS. Blanks
+* out the call inside `setup()`, then re-exports the component wrapped
+* with `withPreviewProps()`, which gets the macro argument as a
+* lazy factory evaluated at module scope.
+*/
+function previewProps(runtimePath) {
+	return {
+		name: "maizzle:preview-props",
+		enforce: "post",
+		transform(code, id) {
+			if (!id.endsWith(".vue") || !code.includes(MACRO)) return;
+			const ast = parseAst(code);
+			const calls = [];
+			const walk = (node, block) => {
+				if (!node || typeof node.type !== "string") return;
+				if (node.type === "ExpressionStatement" && node.expression.type === "CallExpression" && node.expression.callee.type === "Identifier" && node.expression.callee.name === MACRO) {
+					calls.push({
+						node,
+						block
+					});
+					return;
+				}
+				const inner = node.type === "BlockStatement" ? node.body : block;
+				for (const value of Object.values(node)) if (Array.isArray(value)) value.forEach((child) => walk(child, inner));
+				else if (value && typeof value === "object") walk(value, inner);
+			};
+			walk(ast, ast.body);
+			if (calls.length === 0) return;
+			const exportDefault = ast.body.find((n) => n.type === "ExportDefaultDeclaration");
+			if (!exportDefault) return;
+			const [{ node: call, block }] = calls;
+			const arg = call.expression.arguments[0];
+			/**
+			* The argument is moved out of `setup()` to module scope, where
+			* template variables don't exist. Vue hoists literal consts there
+			* though, so check both scopes and reject either one, keeping
+			* the rule simple: inline values and imports only.
+			*/
+			let error;
+			if (calls.length > 1) error = `${MACRO}() can only be called once per template.`;
+			else if (arg) {
+				const declared = /* @__PURE__ */ new Set();
+				declaredNames(ast.body, declared);
+				declaredNames(block, declared);
+				const local = referencedNames(arg).find((name) => declared.has(name));
+				if (local) error = `${MACRO}() cannot use \`${local}\` declared in this template.\nMove it to an import, or write the value inline.`;
+			}
+			/**
+			* Mistakes throw from the factory instead of failing the compile:
+			* it only runs in the dev server, so preview data can never
+			* break `build` or a production `render()`. Macro-only imports
+			* are removed either way, and only loaded by a valid factory.
+			*/
+			const moved = previewOnlyImports(ast, calls.flatMap(({ node }) => node.expression.arguments));
+			let factory = "() => ({})";
+			if (error) factory = `() => { throw new Error(${JSON.stringify(`[maizzle] ${error}`)}) }`;
+			else if (moved.imports.length) factory = `async () => { ${moved.imports.map(dynamicImport).join("; ")}; return (${code.slice(arg.start, arg.end)}) }`;
+			else if (arg) factory = `() => (${code.slice(arg.start, arg.end)})`;
+			/**
+			* Blank the calls, moved imports and their getters in place (keeping
+			* newlines) so line numbers don't shift. A getter takes its comma
+			* along, so the `__returned__` object stays valid.
+			*/
+			const blank = (s) => s.replace(/[^\n]/g, " ");
+			const ranges = [
+				...calls.map(({ node }) => [node.start, node.end]),
+				...moved.imports.map((node) => [node.start, node.end]),
+				...moved.getters.map((node) => [node.start, node.end + (/^\s*,/.exec(code.slice(node.end))?.[0].length ?? 0)])
+			].sort((a, b) => a[0] - b[0]);
+			let out = "";
+			let cursor = 0;
+			for (const [start, end] of ranges) {
+				out += code.slice(cursor, start) + blank(code.slice(start, end));
+				cursor = end;
+			}
+			out += code.slice(cursor, exportDefault.start) + "const __maizzle_sfc = " + code.slice(exportDefault.declaration.start) + `\nimport { withPreviewProps as __maizzle_withPreviewProps } from ${JSON.stringify(runtimePath)}\nexport default __maizzle_withPreviewProps(__maizzle_sfc, ${factory})\n`;
+			return {
+				code: out,
+				map: null
+			};
+		}
+	};
+}
+//#endregion
+export { previewProps };
+
+//# sourceMappingURL=previewProps.js.map

package/dist/render/plugins/previewProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewProps.js","names":[],"sources":["../../../src/render/plugins/previewProps.ts"],"sourcesContent":["import { parseAst } from 'vite'\nimport type { Plugin } from 'vite'\n\nconst MACRO = 'definePreviewProps'\n\n/**\n * Collect binding names from a declaration target: `a`, `{ a, b: c }`,\n * `[a, ...rest]`, `a = 1`.\n */\nfunction patternNames(node: any, out: Set<string>): void {\n  if (!node) return\n  if (node.type === 'Identifier') out.add(node.name)\n  else if (node.type === 'ObjectPattern') node.properties.forEach((p: any) => patternNames(p.type === 'RestElement' ? p : p.value, out))\n  else if (node.type === 'ArrayPattern') node.elements.forEach((e: any) => patternNames(e, out))\n  else if (node.type === 'AssignmentPattern') patternNames(node.left, out)\n  else if (node.type === 'RestElement') patternNames(node.argument, out)\n}\n\n/**\n * Names declared directly in a statement list (not in nested blocks).\n * Imports are left out on purpose: they're allowed in the macro.\n */\nfunction declaredNames(statements: any[], out: Set<string>): void {\n  for (let node of statements) {\n    if (node.type === 'ExportNamedDeclaration') node = node.declaration\n    if (!node) continue\n    if (node.type === 'VariableDeclaration') node.declarations.forEach((d: any) => patternNames(d.id, out))\n    else if ((node.type === 'FunctionDeclaration' || node.type === 'ClassDeclaration') && node.id) out.add(node.id.name)\n  }\n}\n\n/**\n * Identifiers an expression reads, minus the ones it declares itself\n * (arrow function params, inner variables) and property names.\n */\nfunction referencedNames(root: any): string[] {\n  const refs = new Set<string>()\n  const own = new Set<string>()\n\n  const visit = (node: any, parent?: any, key?: string): void => {\n    if (!node || typeof node.type !== 'string') return\n    if (node.type === 'Identifier') {\n      const isPropertyName = !parent?.computed && (\n        (parent?.type === 'MemberExpression' && key === 'property')\n        || ((parent?.type === 'Property' || parent?.type === 'MethodDefinition') && key === 'key')\n      )\n      if (!isPropertyName) refs.add(node.name)\n      return\n    }\n    if (node.type === 'VariableDeclarator') patternNames(node.id, own)\n    if (node.params) node.params.forEach((p: any) => patternNames(p, own))\n    if (node.type === 'CatchClause') patternNames(node.param, own)\n    for (const [k, value] of Object.entries(node)) {\n      if (Array.isArray(value)) value.forEach(child => visit(child, node, k))\n      else if (value && typeof value === 'object') visit(value, node, k)\n    }\n  }\n  visit(root)\n\n  return [...refs].filter(name => !own.has(name))\n}\n\n/**\n * Imports read only by the macro arguments, plus the `__returned__` getters\n * Vue adds for them in non-TS templates. Every other identifier counts\n * as a use (even property names like `$setup.x`), so when in doubt\n * an import stays where it is.\n */\nfunction previewOnlyImports(ast: any, args: any[]): { imports: any[]; getters: any[] } {\n  const imports = ast.body.filter((n: any) => n.type === 'ImportDeclaration' && n.specifiers.length && !n.attributes?.length)\n  const names = new Set<string>(imports.flatMap((n: any) => n.specifiers.map((s: any) => s.local.name)))\n\n  let getters: any[] = []\n  const used = new Set<string>()\n  const skip = new Set([...args, ...imports])\n\n  const visit = (node: any, parent?: any, key?: string): void => {\n    if (!node || typeof node.type !== 'string' || skip.has(node)) return\n    if (node.type === 'VariableDeclarator' && node.id.name === '__returned__' && node.init?.type === 'ObjectExpression') {\n      getters = node.init.properties.filter((p: any) => p.kind === 'get' && names.has(p.key?.name))\n      getters.forEach(p => skip.add(p))\n    }\n    if (node.type === 'Identifier') {\n      if (!(parent?.type === 'Property' && key === 'key' && !parent.computed)) used.add(node.name)\n      return\n    }\n    for (const [k, value] of Object.entries(node)) {\n      if (Array.isArray(value)) value.forEach(child => visit(child, node, k))\n      else if (value && typeof value === 'object') visit(value, node, k)\n    }\n  }\n  visit(ast)\n\n  const inArg = new Set(args.flatMap(referencedNames))\n  const moved = imports.filter((n: any) =>\n    n.specifiers.every((s: any) => !used.has(s.local.name))\n    && n.specifiers.some((s: any) => inArg.has(s.local.name)),\n  )\n  const movedNames = new Set(moved.flatMap((n: any) => n.specifiers.map((s: any) => s.local.name)))\n\n  return { imports: moved, getters: getters.filter(p => movedNames.has(p.key.name)) }\n}\n\n/**\n * `import a, { b as c } from 'x'` -> `const { default: a, b: c } = await import('x')`\n */\nfunction dynamicImport(node: any): string {\n  const source = JSON.stringify(node.source.value)\n  const namespace = node.specifiers.find((s: any) => s.type === 'ImportNamespaceSpecifier')\n  const named = node.specifiers\n    .filter((s: any) => s.type !== 'ImportNamespaceSpecifier')\n    .map((s: any) => {\n      if (s.type === 'ImportDefaultSpecifier') return `default: ${s.local.name}`\n      const imported = s.imported.type === 'Identifier' ? s.imported.name : JSON.stringify(s.imported.value)\n      return `${imported}: ${s.local.name}`\n    })\n\n  return [\n    namespace && `const ${namespace.local.name} = await import(${source})`,\n    named.length && `const { ${named.join(', ')} } = await import(${source})`,\n  ].filter(Boolean).join('; ')\n}\n\n/**\n * Vite plugin that compiles the `definePreviewProps()` macro.\n *\n * Runs after plugin-vue (and TS stripping), so it sees plain JS. Blanks\n * out the call inside `setup()`, then re-exports the component wrapped\n * with `withPreviewProps()`, which gets the macro argument as a\n * lazy factory evaluated at module scope.\n */\nexport function previewProps(runtimePath: string): Plugin {\n  return {\n    name: 'maizzle:preview-props',\n    enforce: 'post',\n    transform(code, id) {\n      if (!id.endsWith('.vue') || !code.includes(MACRO)) return\n\n      const ast = parseAst(code) as any\n      const calls: { node: any; block: any[] }[] = []\n\n      const walk = (node: any, block: any[]): void => {\n        if (!node || typeof node.type !== 'string') return\n        if (\n          node.type === 'ExpressionStatement'\n          && node.expression.type === 'CallExpression'\n          && node.expression.callee.type === 'Identifier'\n          && node.expression.callee.name === MACRO\n        ) {\n          calls.push({ node, block })\n          return\n        }\n        const inner = node.type === 'BlockStatement' ? node.body : block\n        for (const value of Object.values(node)) {\n          if (Array.isArray(value)) value.forEach(child => walk(child, inner))\n          else if (value && typeof value === 'object') walk(value, inner)\n        }\n      }\n      walk(ast, ast.body)\n\n      if (calls.length === 0) return\n\n      const exportDefault = ast.body.find((n: any) => n.type === 'ExportDefaultDeclaration')\n      if (!exportDefault) return\n\n      const [{ node: call, block }] = calls\n      const arg = call.expression.arguments[0]\n\n      /**\n       * The argument is moved out of `setup()` to module scope, where\n       * template variables don't exist. Vue hoists literal consts there\n       * though, so check both scopes and reject either one, keeping\n       * the rule simple: inline values and imports only.\n       */\n      let error: string | undefined\n      if (calls.length > 1) {\n        error = `${MACRO}() can only be called once per template.`\n      } else if (arg) {\n        const declared = new Set<string>()\n        declaredNames(ast.body, declared)\n        declaredNames(block, declared)\n\n        const local = referencedNames(arg).find(name => declared.has(name))\n        if (local) {\n          error = `${MACRO}() cannot use \\`${local}\\` declared in this template.\\nMove it to an import, or write the value inline.`\n        }\n      }\n\n      /**\n       * Mistakes throw from the factory instead of failing the compile:\n       * it only runs in the dev server, so preview data can never\n       * break `build` or a production `render()`. Macro-only imports\n       * are removed either way, and only loaded by a valid factory.\n       */\n      const moved = previewOnlyImports(ast, calls.flatMap(({ node }) => node.expression.arguments))\n\n      let factory = '() => ({})'\n      if (error) {\n        factory = `() => { throw new Error(${JSON.stringify(`[maizzle] ${error}`)}) }`\n      } else if (moved.imports.length) {\n        factory = `async () => { ${moved.imports.map(dynamicImport).join('; ')}; return (${code.slice(arg.start, arg.end)}) }`\n      } else if (arg) {\n        factory = `() => (${code.slice(arg.start, arg.end)})`\n      }\n\n      /**\n       * Blank the calls, moved imports and their getters in place (keeping\n       * newlines) so line numbers don't shift. A getter takes its comma\n       * along, so the `__returned__` object stays valid.\n       */\n      const blank = (s: string) => s.replace(/[^\\n]/g, ' ')\n      const ranges = [\n        ...calls.map(({ node }) => [node.start, node.end]),\n        ...moved.imports.map(node => [node.start, node.end]),\n        ...moved.getters.map(node => [node.start, node.end + (/^\\s*,/.exec(code.slice(node.end))?.[0].length ?? 0)]),\n      ].sort((a, b) => a[0] - b[0])\n\n      let out = ''\n      let cursor = 0\n      for (const [start, end] of ranges) {\n        out += code.slice(cursor, start) + blank(code.slice(start, end))\n        cursor = end\n      }\n\n      out += code.slice(cursor, exportDefault.start)\n        + 'const __maizzle_sfc = '\n        + code.slice(exportDefault.declaration.start)\n        + `\\nimport { withPreviewProps as __maizzle_withPreviewProps } from ${JSON.stringify(runtimePath)}`\n        + `\\nexport default __maizzle_withPreviewProps(__maizzle_sfc, ${factory})\\n`\n\n      return { code: out, map: null }\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/render/withPreviewProps.d.ts

@@ -0,0 +1,15 @@
+import { Component } from "vue";
+//#region src/render/withPreviewProps.d.ts
+/**
+ * Set on a per-render config by the dev server. Global symbol registry
+ * so the Node and Vite SSR module instances agree on the key.
+ */
+export declare const PreviewPropsKey: unique symbol;
+/**
+ * Wrap a template that calls `definePreviewProps()`. Passes the real props
+ * through untouched, and only in dev server renders merges the sample
+ * props underneath them. The factory is never called otherwise.
+ */
+export declare function withPreviewProps(component: Component, previewProps: () => Record<string, any> | Promise<Record<string, any>>): Component;
+//#endregion
+//# sourceMappingURL=withPreviewProps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"withPreviewProps.d.ts","names":[],"sources":["../../src/render/withPreviewProps.ts"],"mappings":";;;;;;qBAQa;;;;;;wBAOG,iBACd,WAAW,WACX,oBAAoB,sBAAsB,QAAQ,uBACjD"}

package/dist/render/withPreviewProps.js

@@ -0,0 +1,40 @@
+import { MaizzleConfigKey } from "../composables/useConfig.js";
+import { defineComponent, h, inject } from "vue";
+//#region src/render/withPreviewProps.ts
+/**
+* Set on a per-render config by the dev server. Global symbol registry
+* so the Node and Vite SSR module instances agree on the key.
+*/
+const PreviewPropsKey = Symbol.for("maizzle.previewProps");
+/**
+* Wrap a template that calls `definePreviewProps()`. Passes the real props
+* through untouched, and only in dev server renders merges the sample
+* props underneath them. The factory is never called otherwise.
+*/
+function withPreviewProps(component, previewProps) {
+	return defineComponent({
+		name: component.__name,
+		inheritAttrs: false,
+		setup(_, { attrs, slots }) {
+			if (!inject(MaizzleConfigKey)?.[PreviewPropsKey]) return () => h(component, attrs, slots);
+			const withPreview = (preview) => {
+				const props = {
+					...preview,
+					...attrs
+				};
+				return () => h(component, props, slots);
+			};
+			/**
+			* The factory is async when the sample data comes from imports,
+			* which it loads itself. Vue's SSR renderer awaits an async
+			* setup(), so those modules only load in the dev server.
+			*/
+			const preview = previewProps();
+			return preview instanceof Promise ? preview.then(withPreview) : withPreview(preview);
+		}
+	});
+}
+//#endregion
+export { PreviewPropsKey, withPreviewProps };
+
+//# sourceMappingURL=withPreviewProps.js.map

package/dist/render/withPreviewProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withPreviewProps.js","names":[],"sources":["../../src/render/withPreviewProps.ts"],"sourcesContent":["import { defineComponent, h, inject } from 'vue'\nimport type { Component } from 'vue'\nimport { MaizzleConfigKey } from '../composables/useConfig.ts'\n\n/**\n * Set on a per-render config by the dev server. Global symbol registry\n * so the Node and Vite SSR module instances agree on the key.\n */\nexport const PreviewPropsKey = Symbol.for('maizzle.previewProps')\n\n/**\n * Wrap a template that calls `definePreviewProps()`. Passes the real props\n * through untouched, and only in dev server renders merges the sample\n * props underneath them. The factory is never called otherwise.\n */\nexport function withPreviewProps(\n  component: Component,\n  previewProps: () => Record<string, any> | Promise<Record<string, any>>,\n): Component {\n  return defineComponent({\n    name: (component as { __name?: string }).__name,\n    inheritAttrs: false,\n    setup(_, { attrs, slots }) {\n      const config = inject(MaizzleConfigKey) as Record<symbol, unknown> | undefined\n      if (!config?.[PreviewPropsKey]) return () => h(component, attrs, slots)\n\n      const withPreview = (preview: Record<string, any>) => {\n        const props = { ...preview, ...attrs }\n        return () => h(component, props, slots)\n      }\n\n      /**\n       * The factory is async when the sample data comes from imports,\n       * which it loads itself. Vue's SSR renderer awaits an async\n       * setup(), so those modules only load in the dev server.\n       */\n      const preview = previewProps()\n      return preview instanceof Promise ? preview.then(withPreview) : withPreview(preview)\n    },\n  })\n}\n"],"mappings":";;;;;;;AAQA,MAAa,kBAAkB,OAAO,IAAI,sBAAsB;;;;;;AAOhE,SAAgB,iBACd,WACA,cACW;CACX,OAAO,gBAAgB;EACrB,MAAO,UAAkC;EACzC,cAAc;EACd,MAAM,GAAG,EAAE,OAAO,SAAS;GAEzB,IAAI,CADW,OAAO,gBACZ,CAAC,GAAG,kBAAkB,aAAa,EAAE,WAAW,OAAO,KAAK;GAEtE,MAAM,eAAe,YAAiC;IACpD,MAAM,QAAQ;KAAE,GAAG;KAAS,GAAG;IAAM;IACrC,aAAa,EAAE,WAAW,OAAO,KAAK;GACxC;;;;;;GAOA,MAAM,UAAU,aAAa;GAC7B,OAAO,mBAAmB,UAAU,QAAQ,KAAK,WAAW,IAAI,YAAY,OAAO;EACrF;CACF,CAAC;AACH"}

package/dist/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","names":[],"sources":["../src/serve.ts"],"mappings":";;;;iBA4DiB;EACf,SAAS,QAAQ;;EAEjB;;EAEA;;EAEA;;;;;;;;;;;wBAYoB,MAAM,UAAS,eAAiB,QAAA;wBA+vBtC,YAAY,QAAQ,eAAe"}
+{"version":3,"file":"serve.d.ts","names":[],"sources":["../src/serve.ts"],"mappings":";;;;iBA6DiB;EACf,SAAS,QAAQ;;EAEjB;;EAEA;;EAEA;;;;;;;;;;;wBAYoB,MAAM,UAAS,eAAiB,QAAA;wBAiwBtC,YAAY,QAAQ,eAAe"}

package/dist/serve.js

@@ -9,6 +9,7 @@ import { stripForHtml, stripForPlaintext } from "./utils/output-markers.js";
 import { _setCurrentTemplate } from "./composables/useCurrentTemplate.js";
 import { cloneConfig } from "./utils/cloneConfig.js";
 import { setActiveRenderer } from "./render/active.js";
+import { PreviewPropsKey } from "./render/withPreviewProps.js";
 import { serveLint } from "./server/linter.js";
 import { serveCompatibility } from "./server/compatibility.js";
 import { sendEmail } from "./server/email.js";
@@ -450,9 +451,11 @@ function getRendered(absolutePath, config, renderer, events) {
 				* Mirror the build's per-template event pipeline (see buildTemplate)
 				* so dev preview fires the same beforeRender / afterRender /
 				* afterTransform hooks and matches production output. Clone config so
-				* beforeRender mutations stay scoped to this render.
+				* beforeRender mutations stay scoped to this render. The one deliberate
+				* difference: flag it so `definePreviewProps()` sample data applies.
 				*/
 				const renderConfig = cloneConfig(config);
+				Object.assign(renderConfig, { [PreviewPropsKey]: true });
 				const template = {
 					source: readFileSync(absolutePath, "utf-8"),
 					path: parse(absolutePath)