@samva/vite 0.7.0 → 0.9.0

package/dist/project.d.ts

@@ -1,116 +1,2 @@
-import { EmailProjectSource, EmailRenderer, LoadedEmailEntry } from "./email.js";
-import { AssetEntry, RenderedEmail, TransformOptions } from "@samva/markup/compiler";
-import { TemplateDefinition, isTemplateDefinition } from "@samva/markup/template";
-import { EmailDiagnostic } from "@samva/markup/email/diagnostics";
-import { SerializeEmailOptions } from "@samva/markup/email/html";
-//#region src/project.d.ts
-/**
- * Read a project directory into the source map the compiler consumes. Text
- * modules arrive as strings and imported files as bytes, which is the same
- * shape the hosted build hands `compileEmailProject`.
- */
-declare const readEmailProject: (dir: string) => Promise<EmailProjectSource>;
-/** One discovered template: its declared identity and the entry that declares it. */
-interface EmailCatalogEntry {
-  /** The identity the definition declares for itself. */
-  readonly id: string;
-  /** Project-relative path of the authored entry. */
-  readonly entryPath: string;
-  readonly definition: TemplateDefinition<unknown>;
-  readonly loaded: LoadedEmailEntry;
-}
-interface EmailCatalog {
-  readonly templates: readonly EmailCatalogEntry[];
-  /** Candidate entries that turned out to be ordinary modules. */
-  readonly helpers: readonly string[];
-  readonly diagnostics: readonly EmailDiagnostic[];
-  /** Every asset the discovered templates import, deduplicated by content. */
-  readonly assets: readonly AssetEntry[];
-}
-/**
- * Compile and evaluate every candidate entry, keeping the ones that declare a
- * template. Compilation is per entry, exactly as a publication is per template,
- * so shared components and CSS reach each template the same way they reach the
- * hosted build.
- */
-declare const loadEmailCatalog: (input: {
-  readonly renderer: EmailRenderer;
-  readonly files: EmailProjectSource;
-  readonly entryPaths?: readonly string[] | undefined;
-  /**
-   * Reuse one id namespace per entry so a reload replaces its modules instead
-   * of accumulating a new namespace per pass. A watch session sets this; a
-   * one-shot load leaves each entry isolated.
-   */
-  readonly stableNamespaces?: boolean | undefined;
-}) => Promise<EmailCatalog>;
-/** One fixture rendered through the template it belongs to. */
-interface RenderedFixture {
-  readonly templateId: string;
-  readonly fixture: string;
-  readonly rendered: RenderedEmail | undefined;
-  readonly diagnostics: readonly EmailDiagnostic[];
-}
-/**
- * Validate and render every fixture a template declares. A fixture that its own
- * schema rejects is a source defect the author sees here rather than at publish.
- */
-declare const renderEmailFixtures: (entry: EmailCatalogEntry, options?: SerializeEmailOptions) => readonly RenderedFixture[];
-/** A live catalog over a project directory, reloaded when its source changes. */
-interface EmailProjectSession {
-  readonly reload: () => Promise<EmailCatalog>;
-  readonly current: () => EmailCatalog;
-  readonly subscribe: (listener: (path: string) => void) => () => void;
-  readonly close: () => Promise<void>;
-}
-/**
- * The authoring loop: one evaluator, one catalog, reloaded on change. Content
- * semantics come from `compileEmailProject` and `renderEmail`, the same two
- * calls the hosted preview makes, so what an author iterates on locally is what
- * a publication renders.
- */
-declare const createEmailProjectSession: (dir: string, options: TransformOptions) => Promise<EmailProjectSession>;
-interface EmailExportReceipt {
-  readonly templates: readonly {
-    readonly id: string;
-    readonly entryPath: string;
-    readonly fixtures: readonly {
-      readonly fixture: string;
-      readonly html: string;
-      readonly text: string;
-    }[];
-  }[];
-  readonly assets: {
-    readonly base: string;
-    readonly assets: readonly AssetEntry[];
-  };
-  readonly diagnostics: readonly EmailDiagnostic[];
-}
-/**
- * Where an export serves its assets from when the caller names no origin.
- *
- * An export writes one page at `templates/<id>/<fixture>.html` and every asset
- * once at `assets/<content address>`, so the base a page resolves against is
- * the path from its own directory back to that one. A template id is one path
- * segment, so every page sits at the same depth and one base serves them all.
- */
-declare const DEFAULT_EXPORT_ASSET_BASE = "../../assets";
-/**
- * Render every template's fixtures to HTML and text beside the bytes of every
- * asset they reference, with the manifest that maps each address to its file.
- *
- * The export renders in the compiler's export mode, so a relative `assetBase`
- * is accepted and the written page resolves its images from the directory it
- * sits in. Delivery keeps refusing relative references — an inbox has no
- * directory to resolve one against — so an export destined for sending names
- * the https origin it will be served from instead.
- */
-declare const exportEmailProject: (input: {
-  readonly dir: string;
-  readonly out: string;
-  readonly assetBase?: string | undefined;
-  readonly tailwind?: TransformOptions["tailwind"] | undefined;
-}) => Promise<EmailExportReceipt>;
-//#endregion
-export { DEFAULT_EXPORT_ASSET_BASE, EmailCatalog, EmailCatalogEntry, EmailExportReceipt, EmailProjectSession, RenderedFixture, createEmailProjectSession, exportEmailProject, isTemplateDefinition, loadEmailCatalog, readEmailProject, renderEmailFixtures };
-//# sourceMappingURL=project.d.ts.map
+import { A as loadBrandEnv, C as renderChannelFixture, D as BrandSnapshot, E as BrandResolution, F as discoverEntries, I as readProjectFiles, L as templateDirectories, M as DEFAULT_TEMPLATE_DIRS, N as ProjectFiles, O as BrandWarning, P as SAMVA_DIR, S as hasErrors, T as BRAND_SNAPSHOT_DIR, _ as TemplateChannel, a as ProjectOptions, b as emailCompatibility, c as exportProject, d as CompileProjectInput, f as CompiledEntry, g as RenderedFixture, h as RenderedChannel, i as ProjectExportReceipt, j as resolveProjectBrand, k as ResolvedBrand, l as loadProject, m as FailedEntry, n as ExportedFixture, o as ProjectSession, p as CompiledProject, r as LoadedProject, s as createProjectSession, t as DEFAULT_EXPORT_ASSET_BASE, u as projectRoot, v as channelsOf, w as renderEmailFixtures, x as finding, y as compileProject } from "./project-CiUuzKsC.js";
+export { BRAND_SNAPSHOT_DIR, type BrandResolution, type BrandSnapshot, type BrandWarning, CompileProjectInput, CompiledEntry, CompiledProject, DEFAULT_EXPORT_ASSET_BASE, DEFAULT_TEMPLATE_DIRS, ExportedFixture, FailedEntry, LoadedProject, ProjectExportReceipt, type ProjectFiles, ProjectOptions, ProjectSession, RenderedChannel, RenderedFixture, type ResolvedBrand, SAMVA_DIR, TemplateChannel, channelsOf, compileProject, createProjectSession, discoverEntries, emailCompatibility, exportProject, finding, hasErrors, loadBrandEnv, loadProject, projectRoot, readProjectFiles, renderChannelFixture, renderEmailFixtures, resolveProjectBrand, templateDirectories };

package/dist/project.js

@@ -1,294 +1,2 @@
-import { createEmailRenderer } from "./email.js";
-import { watch } from "node:fs";
-import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
-import { isAbsolute, join, relative, resolve, sep } from "node:path";
-import { assetUrl, isAssetPath } from "@samva/markup/compiler";
-import { TEMPLATE_NAME_PATTERN, isTemplateDefinition, isTemplateDefinition as isTemplateDefinition$1 } from "@samva/markup/template";
-//#region src/project.ts
-const toPosix = (value) => sep === "/" ? value : value.split(sep).join("/");
-const isCandidateEntry = (path) => path.endsWith(".tsx");
-const diagnostic = (code, severity, message) => ({
-	code,
-	severity,
-	message,
-	origins: []
-});
-/**
-* Read a project directory into the source map the compiler consumes. Text
-* modules arrive as strings and imported files as bytes, which is the same
-* shape the hosted build hands `compileEmailProject`.
-*/
-const readEmailProject = async (dir) => {
-	const root = resolve(dir);
-	const files = {};
-	const walk = async (current) => {
-		const entries = await readdir(current, { withFileTypes: true });
-		await Promise.all(entries.filter((entry) => !entry.name.startsWith(".") && entry.name !== "node_modules").map(async (entry) => {
-			const full = join(current, entry.name);
-			if (entry.isDirectory()) return walk(full);
-			if (!entry.isFile()) return;
-			const path = toPosix(relative(root, full));
-			files[path] = isAssetPath(path) ? new Uint8Array(await readFile(full)) : await readFile(full, "utf8");
-		}));
-	};
-	await walk(root);
-	return files;
-};
-/**
-* Compile and evaluate every candidate entry, keeping the ones that declare a
-* template. Compilation is per entry, exactly as a publication is per template,
-* so shared components and CSS reach each template the same way they reach the
-* hosted build.
-*/
-const loadEmailCatalog = async (input) => {
-	const candidates = (input.entryPaths ?? Object.keys(input.files).filter(isCandidateEntry)).slice();
-	candidates.sort();
-	const templates = [];
-	const helpers = [];
-	const diagnostics = [];
-	const assets = /* @__PURE__ */ new Map();
-	const declaredBy = /* @__PURE__ */ new Map();
-	const loaded = await Promise.all(candidates.map((entryPath) => loadEntry(input.renderer, input.files, entryPath, input.stableNamespaces === true ? entryPath : void 0)));
-	for (const [index, entryPath] of candidates.entries()) {
-		const result = loaded[index];
-		if (!result.ok) {
-			diagnostics.push(diagnostic("entry-load-error", "error", `${entryPath}: ${result.message}`));
-			continue;
-		}
-		const template = result.entry.template;
-		if (template === void 0) {
-			helpers.push(entryPath);
-			continue;
-		}
-		if (!isTemplateDefinition$1(template)) {
-			helpers.push(entryPath);
-			diagnostics.push(diagnostic("not-a-template", "warning", `${entryPath} default-exports something that is not a template definition. Wrap it with defineEmail, or drop the default export so it reads as a helper module.`));
-			continue;
-		}
-		const previous = declaredBy.get(template.id);
-		if (previous !== void 0) {
-			diagnostics.push(diagnostic("duplicate-template-id", "error", `Template id ${JSON.stringify(template.id)} is declared by both ${previous} and ${entryPath}. An id is a publication's identity, so it must name exactly one template.`));
-			continue;
-		}
-		declaredBy.set(template.id, entryPath);
-		for (const asset of result.entry.compiled.assets) assets.set(asset.digest, asset);
-		diagnostics.push(...result.entry.compiled.diagnostics);
-		templates.push({
-			id: template.id,
-			entryPath,
-			definition: template,
-			loaded: result.entry
-		});
-	}
-	return {
-		templates: templates.sort((left, right) => left.id < right.id ? -1 : 1),
-		helpers,
-		diagnostics,
-		assets: [...assets.values()].sort((left, right) => left.fileName < right.fileName ? -1 : 1)
-	};
-};
-const loadEntry = async (renderer, files, entryPath, namespace) => renderer.load(files, entryPath, namespace).then((entry) => ({
-	ok: true,
-	entry
-}), (cause) => ({
-	ok: false,
-	message: cause instanceof Error ? cause.message : String(cause)
-}));
-/**
-* Validate and render every fixture a template declares. A fixture that its own
-* schema rejects is a source defect the author sees here rather than at publish.
-*/
-const renderEmailFixtures = (entry, options = {}) => Object.entries(entry.definition.fixtures).map(([fixture, data]) => {
-	if (!entry.definition.schema.validate(data)) return {
-		templateId: entry.id,
-		fixture,
-		rendered: void 0,
-		diagnostics: [diagnostic("invalid-fixture", "error", `Fixture ${JSON.stringify(fixture)} does not satisfy ${entry.id}'s own input schema: ${JSON.stringify(entry.definition.schema.validate.errors)}`)]
-	};
-	try {
-		const rendered = entry.loaded.renderEmail(entry.definition, data, options);
-		return {
-			templateId: entry.id,
-			fixture,
-			rendered,
-			diagnostics: rendered.diagnostics
-		};
-	} catch (cause) {
-		return {
-			templateId: entry.id,
-			fixture,
-			rendered: void 0,
-			diagnostics: findingsOf(cause, entry.id, fixture)
-		};
-	}
-});
-const findingsOf = (cause, templateId, fixture) => {
-	const carried = cause.diagnostics;
-	if (Array.isArray(carried) && carried.length > 0) return carried;
-	return [diagnostic("render-failed", "error", `${templateId} could not render fixture ${JSON.stringify(fixture)}: ${cause instanceof Error ? cause.message : String(cause)}`)];
-};
-/**
-* The authoring loop: one evaluator, one catalog, reloaded on change. Content
-* semantics come from `compileEmailProject` and `renderEmail`, the same two
-* calls the hosted preview makes, so what an author iterates on locally is what
-* a publication renders.
-*/
-const createEmailProjectSession = async (dir, options) => {
-	const root = resolve(dir);
-	const renderer = await createEmailRenderer(options);
-	let catalog = {
-		templates: [],
-		helpers: [],
-		diagnostics: [],
-		assets: []
-	};
-	const listeners = /* @__PURE__ */ new Set();
-	const observer = watch(root, { recursive: true }, (_event, name) => {
-		const changed = name === null ? root : toPosix(name.toString());
-		for (const listener of listeners) listener(changed);
-	});
-	const reload = async () => {
-		renderer.invalidate();
-		catalog = await loadEmailCatalog({
-			renderer,
-			files: await readEmailProject(root),
-			stableNamespaces: true
-		});
-		return catalog;
-	};
-	return {
-		reload,
-		current: () => catalog,
-		subscribe: (listener) => {
-			listeners.add(listener);
-			return () => void listeners.delete(listener);
-		},
-		close: async () => {
-			observer.close();
-			listeners.clear();
-			await renderer.close();
-		}
-	};
-};
-/**
-* Where an export serves its assets from when the caller names no origin.
-*
-* An export writes one page at `templates/<id>/<fixture>.html` and every asset
-* once at `assets/<content address>`, so the base a page resolves against is
-* the path from its own directory back to that one. A template id is one path
-* segment, so every page sits at the same depth and one base serves them all.
-*/
-const DEFAULT_EXPORT_ASSET_BASE = "../../assets";
-/**
-* The path an export writes, or `undefined` when a name would leave the root.
-*
-* `defineEmail` already refuses an id or a fixture key that is not one path
-* segment, so this is the guard rather than the contract: the same pattern,
-* plus a containment check, so a name that reaches `join` can never address a
-* file the export does not own.
-*/
-const exportPath = (out, ...segments) => {
-	if (!segments.every((segment) => TEMPLATE_NAME_PATTERN.test(segment))) return void 0;
-	const path = join(out, ...segments);
-	const inside = relative(out, path);
-	return inside === "" || inside === ".." || inside.startsWith(`..${sep}`) || isAbsolute(inside) ? void 0 : path;
-};
-const unsafeExportName = (kind, value) => diagnostic("unsafe-export-name", "error", `${kind} ${JSON.stringify(value)} is not one path segment, so an export cannot write a file for it. Use letters, digits, ".", "_" and "-", starting with a letter, digit or "_".`);
-/**
-* Render every template's fixtures to HTML and text beside the bytes of every
-* asset they reference, with the manifest that maps each address to its file.
-*
-* The export renders in the compiler's export mode, so a relative `assetBase`
-* is accepted and the written page resolves its images from the directory it
-* sits in. Delivery keeps refusing relative references — an inbox has no
-* directory to resolve one against — so an export destined for sending names
-* the https origin it will be served from instead.
-*/
-const exportEmailProject = async (input) => {
-	const out = resolve(input.out);
-	const files = await readEmailProject(input.dir);
-	const base = input.assetBase ?? "../../assets";
-	const renderer = await createEmailRenderer({
-		assetBase: base,
-		...input.tailwind === void 0 ? {} : { tailwind: input.tailwind }
-	});
-	try {
-		const catalog = await loadEmailCatalog({
-			renderer,
-			files
-		});
-		const diagnostics = [...catalog.diagnostics];
-		const written = await Promise.all(catalog.templates.map(async (entry) => {
-			const directory = exportPath(out, "templates", entry.id);
-			if (directory === void 0) return {
-				entry: void 0,
-				diagnostics: [unsafeExportName("Template id", entry.id)]
-			};
-			await mkdir(directory, { recursive: true });
-			const rendered = renderEmailFixtures(entry, { relativeUrls: true });
-			const pages = await Promise.all(rendered.map(async (result) => {
-				if (result.rendered === void 0) return {
-					fixture: void 0,
-					diagnostics: []
-				};
-				const htmlPath = exportPath(out, "templates", entry.id, `${result.fixture}.html`);
-				const textPath = exportPath(out, "templates", entry.id, `${result.fixture}.txt`);
-				if (htmlPath === void 0 || textPath === void 0) return {
-					fixture: void 0,
-					diagnostics: [unsafeExportName("Fixture name", result.fixture)]
-				};
-				await Promise.all([writeFile(htmlPath, result.rendered.html, "utf8"), writeFile(textPath, result.rendered.text, "utf8")]);
-				return {
-					fixture: {
-						fixture: result.fixture,
-						html: toPosix(relative(out, htmlPath)),
-						text: toPosix(relative(out, textPath))
-					},
-					diagnostics: []
-				};
-			}));
-			return {
-				entry: {
-					id: entry.id,
-					entryPath: entry.entryPath,
-					fixtures: pages.map((result) => result.fixture).filter((fixture) => fixture !== void 0)
-				},
-				diagnostics: [...rendered.flatMap((result) => result.diagnostics), ...pages.flatMap((result) => result.diagnostics)]
-			};
-		}));
-		const templates = written.map((result) => result.entry).filter((entry) => entry !== void 0);
-		diagnostics.push(...written.flatMap((result) => result.diagnostics));
-		const assetDirectory = join(out, "assets");
-		if (catalog.assets.length > 0) await mkdir(assetDirectory, { recursive: true });
-		await Promise.all(catalog.assets.map((asset) => {
-			const bytes = files[asset.path];
-			return bytes === void 0 || typeof bytes === "string" ? Promise.resolve() : writeFile(join(assetDirectory, asset.fileName), bytes);
-		}));
-		const receipt = {
-			templates,
-			assets: {
-				base,
-				assets: catalog.assets
-			},
-			diagnostics
-		};
-		await mkdir(out, { recursive: true });
-		await writeFile(join(out, "catalog.json"), `${JSON.stringify({
-			...receipt,
-			assets: {
-				base,
-				assets: catalog.assets.map((asset) => ({
-					...asset,
-					url: assetUrl(asset, base)
-				}))
-			}
-		}, null, 2)}\n`, "utf8");
-		return receipt;
-	} finally {
-		await renderer.close();
-	}
-};
-//#endregion
-export { DEFAULT_EXPORT_ASSET_BASE, createEmailProjectSession, exportEmailProject, isTemplateDefinition, loadEmailCatalog, readEmailProject, renderEmailFixtures };
-
-//# sourceMappingURL=project.js.map
+import { C as discoverEntries, D as readProjectFiles, O as templateDirectories, S as SAMVA_DIR, a as projectRoot, b as resolveProjectBrand, d as emailCompatibility, f as finding, g as BRAND_SNAPSHOT_DIR, h as renderEmailFixtures, i as loadProject, l as channelsOf, m as renderChannelFixture, n as createProjectSession, p as hasErrors, r as exportProject, t as DEFAULT_EXPORT_ASSET_BASE, u as compileProject, x as DEFAULT_TEMPLATE_DIRS, y as loadBrandEnv } from "./project-Cp8qb3s0.js";
+export { BRAND_SNAPSHOT_DIR, DEFAULT_EXPORT_ASSET_BASE, DEFAULT_TEMPLATE_DIRS, SAMVA_DIR, channelsOf, compileProject, createProjectSession, discoverEntries, emailCompatibility, exportProject, finding, hasErrors, loadBrandEnv, loadProject, projectRoot, readProjectFiles, renderChannelFixture, renderEmailFixtures, resolveProjectBrand, templateDirectories };

package/dist/render.d.ts

@@ -0,0 +1,54 @@
+import { a as ProjectOptions } from "./project-CiUuzKsC.js";
+import { EmailDiagnostic } from "@samva/markup/email/diagnostics";
+import { RenderedIrWhatsApp } from "@samva/markup/ir";
+//#region src/render.d.ts
+interface RenderTemplateInput extends ProjectOptions {
+  /** A template id, or the project-relative path of its entry. */
+  readonly template: string;
+  readonly fixture: string;
+  /** Overrides the template's locale for formatters. */
+  readonly locale?: string | undefined;
+  /** IANA time zone for date and time formatters; defaults to UTC. */
+  readonly timeZone?: string | undefined;
+}
+type RenderTemplateResult = {
+  readonly ok: true;
+  readonly template: string;
+  readonly fixture: string;
+  readonly subject: string;
+  readonly preheader?: string | undefined;
+  readonly html: string;
+  readonly text: string;
+  readonly diagnostics: readonly EmailDiagnostic[];
+} | {
+  readonly ok: false;
+  readonly diagnostics: readonly EmailDiagnostic[];
+};
+type RenderChannelInput = RenderTemplateInput & {
+  readonly channel: "sms" | "whatsapp";
+};
+type RenderChannelResult = {
+  readonly ok: true;
+  readonly channel: "sms";
+  readonly template: string;
+  readonly fixture: string;
+  readonly text: string;
+  readonly diagnostics: readonly EmailDiagnostic[];
+} | {
+  readonly ok: true;
+  readonly channel: "whatsapp";
+  readonly template: string;
+  readonly fixture: string;
+  readonly message: RenderedIrWhatsApp;
+  readonly diagnostics: readonly EmailDiagnostic[];
+} | {
+  readonly ok: false;
+  readonly diagnostics: readonly EmailDiagnostic[];
+};
+/** Compile the project and render one fixture of one template through its email channel. */
+declare const renderTemplate: (input: RenderTemplateInput) => Promise<RenderTemplateResult>;
+/** Compile the project and render one fixture of one template through its SMS or WhatsApp channel. */
+declare const renderChannel: (input: RenderChannelInput) => Promise<RenderChannelResult>;
+//#endregion
+export { RenderChannelInput, RenderChannelResult, RenderTemplateInput, RenderTemplateResult, renderChannel, renderTemplate };
+//# sourceMappingURL=render.d.ts.map

package/dist/render.js

@@ -0,0 +1,98 @@
+import { _ as brandDiagnostics, f as finding, h as renderEmailFixtures, i as loadProject, m as renderChannelFixture, p as hasErrors } from "./project-Cp8qb3s0.js";
+//#region src/render.ts
+/** Compile just enough of the project to find and build the named template. */
+const locate = async (input) => {
+	const byPath = input.template.endsWith(".tsx");
+	const project = await loadProject(input, void 0, byPath ? [input.template.replace(/^\.\//, "")] : void 0);
+	const { catalog } = project;
+	const entry = catalog.templates.find((candidate) => byPath ? candidate.entryPath === input.template.replace(/^\.\//, "") : candidate.id === input.template);
+	const brand = brandDiagnostics(project.brand);
+	const ambiguous = entry === void 0 ? [] : catalog.diagnostics.filter((item) => item.code === "duplicate-template-id" && item.message.startsWith(`Template id ${JSON.stringify(entry.id)} `));
+	if (entry !== void 0 && ambiguous.length === 0) return {
+		ok: true,
+		entry,
+		diagnostics: [...brand, ...entry.diagnostics]
+	};
+	const failed = byPath ? catalog.failures.filter((candidate) => candidate.entryPath === input.template.replace(/^\.\//, "")) : catalog.failures;
+	return {
+		ok: false,
+		diagnostics: [
+			...brand,
+			...catalog.diagnostics,
+			...failed.flatMap((candidate) => candidate.diagnostics),
+			...entry !== void 0 || byPath && failed.length > 0 ? [] : [finding("template-not-found", "error", `No template ${JSON.stringify(input.template)} in the project${failed.length > 0 ? ", and some entries did not compile (their findings are listed)" : ""}. Known templates: ${catalog.templates.map((candidate) => candidate.id).join(", ") || "none"}.`)]
+		]
+	};
+};
+/** Compile the project and render one fixture of one template through its email channel. */
+const renderTemplate = async (input) => {
+	const located = await locate(input);
+	if (!located.ok) return located;
+	const { entry } = located;
+	if (!entry.channels.includes("email")) return {
+		ok: false,
+		diagnostics: [finding("missing-channel", "error", `Template ${entry.id} declares no email channel.`)]
+	};
+	const [rendered] = renderEmailFixtures({
+		...entry,
+		fixtures: pick(entry.fixtures, input.fixture)
+	}, renderOptions(input));
+	if (rendered === void 0) return {
+		ok: false,
+		diagnostics: [...located.diagnostics, unknownFixture(entry, input.fixture)]
+	};
+	if (rendered.rendered === void 0 || hasErrors(located.diagnostics)) return {
+		ok: false,
+		diagnostics: [...located.diagnostics, ...rendered.diagnostics]
+	};
+	return {
+		ok: true,
+		template: entry.id,
+		fixture: input.fixture,
+		subject: rendered.rendered.subject,
+		...rendered.rendered.preheader === void 0 ? {} : { preheader: rendered.rendered.preheader },
+		html: rendered.rendered.html,
+		text: rendered.rendered.text,
+		diagnostics: located.diagnostics
+	};
+};
+/** Compile the project and render one fixture of one template through its SMS or WhatsApp channel. */
+const renderChannel = async (input) => {
+	const located = await locate(input);
+	if (!located.ok) return located;
+	const { entry } = located;
+	if (!entry.channels.includes(input.channel)) return {
+		ok: false,
+		diagnostics: [finding("missing-channel", "error", `Template ${entry.id} declares no ${input.channel} channel.`)]
+	};
+	const rendered = renderChannelFixture(entry, input.channel, input.fixture, renderOptions(input));
+	if (!rendered.ok || hasErrors(located.diagnostics)) return {
+		ok: false,
+		diagnostics: [...located.diagnostics, ...rendered.ok ? [] : rendered.diagnostics]
+	};
+	return rendered.channel === "sms" ? {
+		ok: true,
+		channel: "sms",
+		template: entry.id,
+		fixture: input.fixture,
+		text: rendered.text,
+		diagnostics: located.diagnostics
+	} : {
+		ok: true,
+		channel: "whatsapp",
+		template: entry.id,
+		fixture: input.fixture,
+		message: rendered.message,
+		diagnostics: located.diagnostics
+	};
+};
+const renderOptions = (input) => ({
+	...input.locale === void 0 ? {} : { locale: input.locale },
+	...input.timeZone === void 0 ? {} : { timeZone: input.timeZone }
+});
+const pick = (fixtures, name) => Object.hasOwn(fixtures, name) ? { [name]: fixtures[name] } : {};
+const unknownFixture = (entry, fixture) => finding("unknown-fixture", "error", `Template ${entry.id} declares no fixture named ${JSON.stringify(fixture)}. Declared: ${Object.keys(entry.fixtures).join(", ")}.`);
+//#endregion
+export { renderChannel, renderTemplate };
+
+//# sourceMappingURL=render.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@samva/vite",
-  "version": "0.7.0",
-  "description": "Unified Vite editor for Samva email, SMS, and WhatsApp templates",
+  "version": "0.9.0",
+  "description": "Local editor, dev server and build for Samva email, SMS and WhatsApp templates",
   "keywords": [
     "email",
     "samva",
@@ -38,10 +38,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./emit": {
-      "types": "./dist/emit.d.ts",
-      "import": "./dist/emit.js"
-    },
     "./build": {
       "types": "./dist/build.d.ts",
       "import": "./dist/build.js"
@@ -50,9 +46,13 @@
       "types": "./dist/project.d.ts",
       "import": "./dist/project.js"
     },
-    "./email": {
-      "types": "./dist/email.d.ts",
-      "import": "./dist/email.js"
+    "./dev": {
+      "types": "./dist/dev.d.ts",
+      "import": "./dist/dev.js"
+    },
+    "./render": {
+      "types": "./dist/render.d.ts",
+      "import": "./dist/render.js"
     }
   },
   "publishConfig": {
@@ -64,14 +64,13 @@
     "dev:editor": "bun run --filter @samva/vite-editor-app dev",
     "prepack": "bun run build",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run --root ../.. --project packages packages/vite/tests",
+    "test": "vitest run --root ../.. --project packages --project serial-vite packages/vite/tests",
     "test:browser": "turbo run build --filter=@samva/vite && playwright test --config playwright.config.ts --project chromium",
     "test:browser:cross": "turbo run build --filter=@samva/vite && playwright test --config playwright.config.ts"
   },
   "dependencies": {
     "@babel/parser": "^8.0.4",
-    "@samva/markup": "^0.7.0",
-    "better-result": "3.0.1",
+    "@samva/markup": "^0.9.0",
     "caniemail": "2.0.2",
     "css-tree": "3.2.1",
     "tailwindcss": "^4.3.3"