@samva/vite 0.1.2 → 0.2.0

package/dist/index.js

@@ -1,27 +1,22 @@
-import { a as discoverTemplateFiles, r as resolveThemePath, t as ThemeState } from "./theme-CfJe8s3k.js";
-import { compileSourcePreview, emitModulePreview } from "./emit.js";
+import { n as resolveThemePath, r as discoverTemplateFiles, t as readProjectThemeCss } from "./theme-CBF6Czjm.js";
+import { emitModulePreview } from "./emit.js";
+import { createEmailRenderer } from "./email.js";
+import { isTemplateDefinition, readEmailProject, renderEmailFixtures } from "./project.js";
 import { existsSync } from "node:fs";
-import { readFile, realpath, rename, writeFile } from "node:fs/promises";
-import { dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { open, readFile, realpath, rename, rm, stat } from "node:fs/promises";
+import { extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
-import { Predicate, Result } from "effect";
+import { checkEmailCompatibility, emailSelections } from "@samva/markup/compiler";
+import { Predicate } from "effect";
 import { createServerModuleRunner, loadEnv } from "vite";
 import { createHash, randomUUID } from "node:crypto";
-import { variableReferences } from "@samva/markup/interpolate";
-import { applyOps } from "@samva/markup/ops";
-//#region src/editor-store.ts
-const noop = () => {};
 const hashSource = (source) => createHash("sha256").update(source, "utf8").digest("hex").slice(0, 16);
 const deriveName = (id) => {
-	return id.slice(id.lastIndexOf("/") + 1).replace(/\.(?:samva|tsx)$/, "");
-};
-const kindForId = (id) => {
-	if (id.endsWith(".samva")) return "samva";
-	if (id.endsWith(".tsx")) return "tsx";
+	return id.slice(id.lastIndexOf("/") + 1).replace(/\.tsx$/, "");
 };
+const kindForId = (id) => id.endsWith(".tsx") ? "tsx" : void 0;
 const within = (child, parent) => child === parent || child.startsWith(parent + sep);
 const flattenCompiledDiagnostics = (template) => {
-	if (template.compiled.channel === "email") return [...template.diagnostics, ...template.compiled.bases.flatMap((base) => base.diagnostics ?? [])];
 	return [...template.diagnostics, ...template.compiled.diagnostics ?? []];
 };
 const diagnostic = (file, severity, code, message, span) => ({
@@ -31,18 +26,22 @@ const diagnostic = (file, severity, code, message, span) => ({
 	message,
 	span
 });
+/** A catalog finding, said in the language the email document reports findings in. */
+const asEmailDiagnostic = (item) => ({
+	code: item.code,
+	severity: item.severity,
+	message: item.message,
+	origins: []
+});
 /**
-* Enforces the TSX file contract after Vite evaluates the module. Named exports
-* are deliberately never inspected or invoked; only `default` can be a template.
+* Enforces the TSX file contract for an SML template after Vite evaluates the
+* module. Named exports are deliberately never inspected or invoked; only
+* `default` can be a template.
 */
-const evaluateDefaultExport = (id, name, moduleExports, compile) => {
-	const preview = emitModulePreview(name, moduleExports, compile);
-	const template = preview.templates[0];
-	if (template === void 0) return {
-		ok: false,
-		diagnostics: preview.diagnostics.map((problem) => diagnostic(id, problem.code === "missing-default-export" ? "warning" : "error", problem.code, problem.message, problem.span))
-	};
-	if (!template.ok || template.source === void 0) {
+const evaluateDefaultExport = (id, name, moduleExports) => {
+	const template = emitModulePreview(name, moduleExports).templates[0];
+	if (template === void 0) return { kind: "helper" };
+	if (!template.ok || template.source === void 0 || template.channel === "unknown") {
 		const problems = flattenCompiledDiagnostics(template);
 		return {
 			ok: false,
@@ -51,30 +50,45 @@ const evaluateDefaultExport = (id, name, moduleExports, compile) => {
 	}
 	return {
 		ok: true,
-		source: template.source,
-		channel: template.channel,
-		variables: template.variables
+		template: {
+			channel: template.channel,
+			source: template.source
+		},
+		variables: template.variables.map((variable) => ({
+			name: variable.name,
+			required: variable.required
+		}))
 	};
 };
+/** Two builds of one document differ when what the editor shows differs. */
+const moved = (before, entry) => {
+	if (before === void 0) return true;
+	if (before.rev !== entry.rev || before.authoredSource !== entry.authoredSource) return true;
+	if (before.content.channel !== entry.content.channel) return true;
+	return before.content.channel === "email" && entry.content.channel === "email" && before.content.fixture !== entry.content.fixture;
+};
 var EditorFileStore = class {
 	dir;
-	evaluateTsx;
-	compile;
+	projectRoot;
+	evaluator;
 	realDir;
 	loaded = false;
+	mutationQueue = Promise.resolve();
+	serialize(operation) {
+		const running = this.mutationQueue.then(operation, operation);
+		this.mutationQueue = running.catch(() => void 0);
+		return running;
+	}
 	initialLoad;
 	entries = /* @__PURE__ */ new Map();
 	diagnostics = /* @__PURE__ */ new Map();
-	currentRev = /* @__PURE__ */ new Map();
-	writing = /* @__PURE__ */ new Set();
-	saveChain = /* @__PURE__ */ new Map();
 	session = /* @__PURE__ */ new Map();
 	listeners = /* @__PURE__ */ new Set();
 	catalogListeners = /* @__PURE__ */ new Set();
 	constructor(templatesDir, options = {}) {
 		this.dir = templatesDir;
-		this.evaluateTsx = options.evaluateTsx;
-		this.compile = options.compile ?? (() => void 0);
+		this.projectRoot = options.projectRoot ?? templatesDir;
+		this.evaluator = options.evaluator;
 	}
 	async resolvePath(id) {
 		if (kindForId(id) === void 0 || id.includes("\0")) return void 0;
@@ -96,82 +110,91 @@ var EditorFileStore = class {
 		const rel = full.slice(this.dir.length + 1).split("\\").join("/");
 		return kindForId(rel) === void 0 ? void 0 : rel;
 	}
-	async load(file) {
-		const path = await this.resolvePath(file.id);
-		if (path === void 0) return { diagnostics: [diagnostic(file.id, "error", "template-unavailable", "Template file is missing or resolves outside the configured templates directory.")] };
+	async load(id, previous) {
+		const path = await this.resolvePath(id);
+		if (path === void 0) return { diagnostics: [diagnostic(id, "error", "template-unavailable", "Template file is missing or resolves outside the configured templates directory.")] };
 		const authoredSource = await readFile(path, "utf8").catch(() => void 0);
-		if (authoredSource === void 0) return { diagnostics: [diagnostic(file.id, "error", "template-read-error", "Template file could not be read.")] };
-		const name = this.session.get(file.id)?.name ?? deriveName(file.id);
-		if (file.kind === "samva") {
-			const preview = compileSourcePreview(name, authoredSource, this.compile());
-			if (!preview.ok) {
-				const problems = flattenCompiledDiagnostics(preview);
-				const previous = this.entries.get(file.id);
-				const diagnostics = problems.map((problem) => diagnostic(file.id, "error", problem.code, problem.message, problem.span));
-				if (previous?.template.sourceKind !== "samva") return { diagnostics };
-				const rev = hashSource(authoredSource);
-				return {
-					entry: {
-						...previous,
-						template: {
-							...previous.template,
-							name
-						},
-						source: authoredSource,
-						rev,
-						variables: [...variableReferences(authoredSource)].sort().map((variableName) => ({
-							name: variableName,
-							required: false
-						}))
-					},
-					diagnostics
-				};
-			}
-			const rev = hashSource(authoredSource);
+		if (authoredSource === void 0) return { diagnostics: [diagnostic(id, "error", "template-read-error", "Template file could not be read.")] };
+		const session = this.session.get(id);
+		const name = session?.name ?? deriveName(id);
+		if (this.evaluator === void 0) return {
+			authoredSource,
+			diagnostics: [diagnostic(id, "error", "tsx-evaluator-unavailable", "TSX templates require the Vite evaluator.")]
+		};
+		const evaluated = await this.evaluator.evaluate({
+			path,
+			id,
+			name,
+			fixture: session?.fixture
+		}).catch((cause) => ({
+			ok: false,
+			diagnostics: [diagnostic(id, "error", "module-load-error", cause instanceof Error ? cause.message : String(cause))]
+		}));
+		if ("kind" in evaluated) return {
+			ignored: true,
+			authoredSource,
+			diagnostics: []
+		};
+		if (!evaluated.ok) {
+			if (previous?.content.channel !== "email") return {
+				authoredSource,
+				diagnostics: evaluated.diagnostics
+			};
+			const diagnostics = evaluated.diagnostics.map(asEmailDiagnostic);
 			return {
 				entry: {
 					template: {
-						id: file.id,
+						...previous.template,
 						name,
-						channel: preview.channel,
-						sourceKind: "samva",
-						access: "editable"
+						stale: false
 					},
-					source: authoredSource,
-					rev,
-					variables: [...variableReferences(authoredSource)].sort().map((variableName) => ({
-						name: variableName,
-						required: false
-					}))
+					content: {
+						channel: "email",
+						fixtures: [],
+						fixture: null,
+						render: null,
+						diagnostics,
+						incompatibilities: []
+					},
+					authoredSource,
+					rev: hashSource(authoredSource + JSON.stringify(diagnostics)),
+					variables: []
 				},
-				diagnostics: []
+				authoredSource,
+				diagnostics: evaluated.diagnostics
 			};
 		}
-		if (this.evaluateTsx === void 0) return { diagnostics: [diagnostic(file.id, "error", "tsx-evaluator-unavailable", "TSX templates require the Vite evaluator.")] };
-		const evaluated = await this.evaluateTsx(path, file.id, name, this.compile()).catch((cause) => ({
-			ok: false,
-			diagnostics: [diagnostic(file.id, "error", "module-load-error", cause instanceof Error ? cause.message : String(cause))]
-		}));
-		if (!evaluated.ok) return { diagnostics: evaluated.diagnostics };
-		const rev = hashSource(evaluated.source);
+		const built = evaluated.template;
+		const rev = hashSource(authoredSource + (built.channel === "email" ? built.identity : built.source));
+		const content = built.channel === "email" ? {
+			channel: "email",
+			fixtures: built.fixtures,
+			fixture: built.fixture,
+			render: built.render === null ? null : {
+				revision: rev,
+				...built.render
+			},
+			diagnostics: built.diagnostics,
+			incompatibilities: built.incompatibilities
+		} : {
+			channel: built.channel,
+			source: built.source
+		};
 		return {
 			entry: {
 				template: {
-					id: file.id,
+					id,
 					name,
-					channel: evaluated.channel,
+					channel: built.channel,
 					sourceKind: "tsx",
-					access: "readonly"
+					stale: false
 				},
-				source: evaluated.source,
+				content,
 				authoredSource,
 				rev,
-				variables: evaluated.variables.map((variable) => ({
-					name: variable.name,
-					required: variable.required
-				}))
+				variables: evaluated.variables
 			},
-			diagnostics: []
+			diagnostics: evaluated.diagnostics ?? []
 		};
 	}
 	catalogSnapshot() {
@@ -194,26 +217,30 @@ var EditorFileStore = class {
 	}
 	async rebuild(emitDocuments) {
 		const previous = new Map(this.entries);
+		await this.evaluator?.refresh();
 		const files = await discoverTemplateFiles(this.dir);
-		const loaded = await Promise.all(files.map(async (file) => [file.id, await this.load(file)]));
+		const loaded = await Promise.all(files.map(async (file) => [file.id, await this.load(file.id, previous.get(file.id))]));
 		this.entries.clear();
 		this.diagnostics.clear();
 		for (const [id, result] of loaded) {
-			if (result.entry !== void 0) {
-				this.entries.set(id, result.entry);
-				this.currentRev.set(id, result.entry.rev);
-			} else this.currentRev.delete(id);
+			if (result.entry !== void 0) this.entries.set(id, result.entry);
+			else if (!result.ignored && previous.has(id)) {
+				const lastGood = previous.get(id);
+				const stale = {
+					...lastGood,
+					template: {
+						...lastGood.template,
+						stale: true
+					},
+					authoredSource: result.authoredSource ?? lastGood.authoredSource
+				};
+				this.entries.set(id, stale);
+			}
 			if (result.diagnostics.length > 0) this.diagnostics.set(id, result.diagnostics);
 		}
 		this.loaded = true;
-		if (emitDocuments) for (const [id, entry] of this.entries) {
-			const before = previous.get(id);
-			if (before === void 0 || before.source !== entry.source || before.authoredSource !== entry.authoredSource) this.publish({
-				id,
-				rev: entry.rev,
-				source: entry.source,
-				authoredSource: entry.authoredSource
-			});
+		if (emitDocuments) {
+			for (const [id, entry] of this.entries) if (moved(previous.get(id), entry)) this.publishEntry(id, entry);
 		}
 		for (const listener of this.catalogListeners) listener();
 		return this.catalogSnapshot();
@@ -226,28 +253,7 @@ var EditorFileStore = class {
 		const loading = this.initialLoad;
 		if (loading !== void 0) await loading;
 		else if (!this.loaded) return this.ensureLoaded();
-		return this.rebuild(options.documents ?? true);
-	}
-	/** Recompile one changed editable file without re-evaluating unrelated TSX modules. */
-	async refreshSamva(id) {
-		if (kindForId(id) !== "samva") return this.catalog();
-		if (!this.loaded) return this.ensureLoaded();
-		const result = await this.load({
-			id,
-			path: join(this.dir, id),
-			kind: "samva"
-		});
-		if (result.entry !== void 0) {
-			this.entries.set(id, result.entry);
-			this.currentRev.set(id, result.entry.rev);
-		} else {
-			this.entries.delete(id);
-			this.currentRev.delete(id);
-		}
-		if (result.diagnostics.length > 0) this.diagnostics.set(id, result.diagnostics);
-		else this.diagnostics.delete(id);
-		for (const listener of this.catalogListeners) listener();
-		return this.catalogSnapshot();
+		return this.serialize(() => this.rebuild(options.documents ?? true));
 	}
 	async list() {
 		return (await this.catalog()).templates;
@@ -257,155 +263,144 @@ var EditorFileStore = class {
 		const entry = this.entries.get(id);
 		if (entry === void 0) return void 0;
 		const meta = this.session.get(id);
-		const fields = {
+		return {
 			id: null,
 			name: meta?.name ?? entry.template.name,
-			channel: entry.template.channel,
-			source: entry.source,
 			rev: entry.rev,
 			variables: entry.variables,
-			metadata: meta?.metadata ?? {}
-		};
-		if (entry.template.sourceKind === "tsx") return {
-			...fields,
+			metadata: meta?.metadata ?? {},
+			...entry.content,
 			origin: {
 				kind: "tsx",
-				file: id,
+				file: relative(this.projectRoot, resolve(this.dir, id)).split(sep).join("/"),
 				authoredSource: entry.authoredSource ?? ""
 			},
-			access: {
+			access: entry.content.channel === "email" ? { kind: "editable" } : {
 				kind: "readonly",
-				reason: "TSX templates are code-authored. Edit the default export in your code editor."
+				reason: "This channel has no local source-save adapter."
 			}
 		};
-		return {
-			...fields,
-			origin: {
-				kind: "samva",
-				file: id
-			},
-			access: { kind: "editable" }
-		};
 	}
-	async save(id, update, client) {
-		if (kindForId(id) === "tsx") return {
+	/**
+	* Serialize editor saves and atomically replace the complete entry after a fresh disk check.
+	* Arbitrary external writers do not participate in this queue: the final check and rename
+	* are not a filesystem compare-and-swap, so authors must resolve overlapping saves externally.
+	*/
+	async saveSource(id, baseRev, authoredSource, client) {
+		if (Buffer.byteLength(authoredSource, "utf8") > 1048576) return {
 			ok: false,
-			error: "TSX templates are read-only; edit the default export in source."
+			kind: "refused",
+			error: "Authored source exceeds the 1 MiB limit."
 		};
-		const path = await this.resolvePath(id);
-		if (path === void 0 || kindForId(id) !== "samva") return {
-			ok: false,
-			error: "template not found"
-		};
-		if (update.kind === "metadata") {
-			const prev = this.session.get(id) ?? { metadata: {} };
-			const next = {
-				name: update.patch.name ?? prev.name,
-				metadata: {
-					fromDefault: update.patch.fromDefault === void 0 ? prev.metadata.fromDefault : update.patch.fromDefault ?? void 0,
-					replyToDefault: update.patch.replyToDefault === void 0 ? prev.metadata.replyToDefault : update.patch.replyToDefault ?? void 0
-				}
-			};
-			this.session.set(id, next);
+		await this.ensureLoaded();
+		return this.serialize(async () => {
 			const entry = this.entries.get(id);
-			if (entry !== void 0 && next.name !== void 0) {
-				this.entries.set(id, {
-					...entry,
-					template: {
-						...entry.template,
-						name: next.name
-					}
-				});
-				for (const listener of this.catalogListeners) listener();
+			const path = await this.resolvePath(id);
+			if (entry === void 0 || path === void 0) return {
+				ok: false,
+				kind: "missing",
+				error: "Template not found."
+			};
+			if (entry.content.channel !== "email") return {
+				ok: false,
+				kind: "refused",
+				error: "Only email source is editable here."
+			};
+			const disk = await readFile(path, "utf8");
+			if (entry.rev !== baseRev || disk !== entry.authoredSource) {
+				await this.rebuild(true);
+				return {
+					ok: false,
+					kind: "conflict",
+					error: "Source changed on disk. Reload before saving.",
+					actualRev: this.entries.get(id)?.rev ?? entry.rev
+				};
 			}
-			const current = await readFile(path, "utf8").catch(() => void 0);
-			return {
+			const temporary = `${path}.${randomUUID()}.tmp`;
+			const mode = (await stat(path)).mode;
+			const file = await open(temporary, "wx", mode);
+			try {
+				await file.writeFile(authoredSource, "utf8");
+				await file.chmod(mode);
+				await file.sync();
+				await file.close();
+				if (await readFile(path, "utf8") !== disk) {
+					await this.rebuild(true);
+					return {
+						ok: false,
+						kind: "conflict",
+						error: "Source changed on disk. Reload before saving.",
+						actualRev: this.entries.get(id)?.rev ?? entry.rev
+					};
+				}
+				await rename(temporary, path);
+			} finally {
+				await file.close().finally(() => rm(temporary, { force: true }));
+			}
+			const previous = new Map(this.entries);
+			await this.rebuild(false);
+			for (const [changedId, changed] of this.entries) if (moved(previous.get(changedId), changed)) this.publishEntry(changedId, changed, changedId === id ? client : void 0);
+			const saved = this.entries.get(id);
+			return saved === void 0 ? {
+				ok: false,
+				kind: "missing",
+				error: "The saved entry is no longer discoverable."
+			} : {
 				ok: true,
-				rev: current === void 0 ? this.currentRev.get(id) ?? "" : hashSource(current)
+				rev: saved.rev
 			};
-		}
-		return this.withLock(id, () => this.commit(id, path, update, client));
+		});
 	}
-	async commit(id, path, update, client) {
-		const current = await readFile(path, "utf8").catch(() => void 0);
-		if (current === void 0) return {
+	/**
+	* Show another declared fixture of an email document. It re-renders the same
+	* build, so the revision does not move; the resulting document reaches every
+	* watcher on the change stream, attributed to the client that asked.
+	*/
+	async viewFixture(id, fixture, client) {
+		if (!this.loaded) await this.ensureLoaded();
+		const entry = this.entries.get(id);
+		if (entry === void 0) return {
 			ok: false,
+			kind: "missing",
 			error: "template not found"
 		};
-		const actualRev = hashSource(current);
-		if (update.baseRev !== actualRev) return {
+		if (entry.content.channel !== "email") return {
 			ok: false,
-			conflict: {
-				expectedRev: update.baseRev,
-				actualRev
-			}
+			kind: "refused",
+			error: `A ${entry.content.channel} template renders no fixture.`
+		};
+		if (!entry.content.fixtures.includes(fixture)) return {
+			ok: false,
+			kind: "refused",
+			error: `Template declares no fixture named ${JSON.stringify(fixture)}.`
 		};
-		let nextSource;
-		if (update.kind === "ops") {
-			const applied = applyOps(current, [...update.ops]);
-			if (Result.isFailure(applied)) return {
+		const meta = this.session.get(id);
+		this.session.set(id, {
+			...meta,
+			metadata: meta?.metadata ?? {},
+			fixture
+		});
+		const loaded = await this.load(id, entry);
+		if (loaded.entry === void 0) {
+			if (loaded.diagnostics.length > 0) this.diagnostics.set(id, loaded.diagnostics);
+			return {
 				ok: false,
-				error: applied.failure.message
+				kind: "refused",
+				error: `Template ${id} could not be re-rendered.`
 			};
-			nextSource = applied.success.source;
-		} else nextSource = update.source;
-		const rev = hashSource(nextSource);
-		this.writing.add(id);
-		try {
-			const temp = join(dirname(path), `.${randomUUID()}.samva.tmp`);
-			await writeFile(temp, nextSource, "utf8");
-			await rename(temp, path);
-			await this.refreshSamva(id);
-		} finally {
-			this.writing.delete(id);
 		}
-		this.publish({
-			id,
-			rev,
-			source: nextSource,
-			sourceClient: client
-		});
-		return {
-			ok: true,
-			rev
-		};
+		this.entries.set(id, loaded.entry);
+		this.publishEntry(id, loaded.entry, client);
+		return { ok: true };
 	}
-	withLock(id, run) {
-		const next = (this.saveChain.get(id) ?? Promise.resolve()).then(run, run);
-		this.saveChain.set(id, next.then(noop, noop));
-		return next;
-	}
-	async handleFileChange(path) {
-		const id = this.idFor(path);
-		if (id === void 0 || kindForId(id) !== "samva") return void 0;
-		if (this.writing.has(id)) return void 0;
-		const real = await this.resolvePath(id);
-		if (real === void 0) return void 0;
-		const source = await readFile(real, "utf8").catch(() => void 0);
-		if (source === void 0) return void 0;
-		const rev = hashSource(source);
-		if (rev === this.currentRev.get(id)) return void 0;
-		this.currentRev.set(id, rev);
-		const previous = this.entries.get(id);
-		if (previous !== void 0) this.entries.set(id, {
-			...previous,
-			source,
-			rev,
-			variables: [...variableReferences(source)].sort().map((name) => ({
-				name,
-				required: false
-			}))
-		});
+	publishEntry(id, entry, client) {
 		const change = {
 			id,
-			rev,
-			source,
-			sourceClient: void 0
+			rev: entry.rev,
+			authoredSource: entry.authoredSource,
+			...client === void 0 ? {} : { sourceClient: client },
+			...entry.content
 		};
-		this.publish(change);
-		return change;
-	}
-	publish(change) {
 		for (const listener of this.listeners) listener(change);
 	}
 	subscribe(listener) {
@@ -480,13 +475,23 @@ const isViteInternalPath = (pathname) => VITE_INTERNAL_PREFIXES.some((prefix) =>
 const hasFileExtension = (pathname) => extname(pathname) !== "";
 const underRoute = (route, pathname) => route === "/" || pathname === route || pathname.startsWith(`${route}/`);
 const childRoute = (route, child) => route === "/" ? `/${child}` : `${route}/${child}`;
+const MAX_BODY_BYTES = 6295552;
+var EditorBodyTooLarge = class extends Error {};
 const readBody = (req) => new Promise((done, fail) => {
-	let data = "";
+	const chunks = [];
+	let bytes = 0;
 	req.on("data", (chunk) => {
-		data += chunk;
+		bytes += chunk.length;
+		if (bytes > MAX_BODY_BYTES) {
+			chunks.length = 0;
+			fail(new EditorBodyTooLarge("Request body exceeds the editor limit."));
+			return;
+		}
+		chunks.push(chunk);
 	});
-	req.on("end", () => done(data));
+	req.on("end", () => done(Buffer.concat(chunks).toString("utf8")));
 	req.on("error", fail);
+	req.on("aborted", () => fail(/* @__PURE__ */ new Error("Request body aborted.")));
 });
 const createSseClient = (res, docId, clientId) => {
 	let pending;
@@ -516,13 +521,145 @@ const createSseClient = (res, docId, clientId) => {
 		}
 	};
 };
+/**
+* The dev server is the origin, and it is not https, so a local render points
+* at its asset route by path. Every render here is a preview or the input to a
+* finding — none of it is delivered — and the base a publication serves from is
+* a build input rather than something the author wrote, so nothing is hidden by
+* accepting one here.
+*/
+const LOCAL_RENDER = { relativeUrls: true };
+/**
+* A template's input contract is a JSON Schema, so its variables are that
+* schema's top-level properties. Nested shapes are not flattened into names —
+* a template's input is a document, not a bag of placeholders.
+*/
+const variablesOf = (definition) => {
+	const properties = definition.schema.schema["properties"];
+	if (!Predicate.isObject(properties)) return [];
+	const required = definition.schema.schema["required"];
+	const names = Array.isArray(required) ? required : [];
+	return Object.entries(properties).map(([name, property]) => {
+		const examples = Predicate.isObject(property) ? property["examples"] : void 0;
+		const example = Array.isArray(examples) ? examples[0] : void 0;
+		return {
+			name,
+			required: names.includes(name),
+			...typeof example === "string" ? { sample: example } : {}
+		};
+	});
+};
+/** One executed render of the viewed fixture, stamped so a click resolves to one element. */
+const previewRender = (entry, fixture) => {
+	try {
+		const rendered = entry.loaded.renderEmail(entry.definition, entry.definition.fixtures[fixture], {
+			...LOCAL_RENDER,
+			instancePaths: true
+		});
+		return { render: {
+			subject: rendered.subject,
+			...rendered.preheader === void 0 ? {} : { preheader: rendered.preheader },
+			html: rendered.html,
+			text: rendered.text,
+			selections: emailSelections(rendered.positions)
+		} };
+	} catch {
+		return { render: null };
+	}
+};
+/** An entry that is a template but did not build: a document state, and a catalog finding. */
+const emailBuildFailure = (id, message) => ({
+	ok: true,
+	variables: [],
+	diagnostics: [{
+		file: id,
+		severity: "error",
+		code: "email-build-error",
+		message
+	}],
+	template: {
+		channel: "email",
+		fixtures: [],
+		fixture: null,
+		render: null,
+		diagnostics: [{
+			code: "email-build-error",
+			severity: "error",
+			message,
+			origins: []
+		}],
+		incompatibilities: [],
+		identity: JSON.stringify({ error: message })
+	}
+});
+/** Compile, evaluate and render one email entry through the compiler boundary. */
+const evaluateEmailEntry = async (input) => {
+	const loaded = await input.renderer.load(input.files, input.entryPath, input.entryPath).then((value) => ({
+		ok: true,
+		value
+	}), (cause) => ({
+		ok: false,
+		message: cause instanceof Error ? cause.message : String(cause)
+	}));
+	if (!loaded.ok) return emailBuildFailure(input.id, loaded.message);
+	const definition = loaded.value.template;
+	if (!isTemplateDefinition(definition)) return emailBuildFailure(input.id, `${input.id} default-exports something that is not a template definition.`);
+	for (const asset of loaded.value.compiled.assets) {
+		const bytes = input.files[asset.path];
+		if (bytes !== void 0 && typeof bytes !== "string") input.assets.set(asset.fileName, {
+			contentType: asset.contentType,
+			bytes
+		});
+	}
+	const entry = {
+		id: definition.id,
+		entryPath: input.entryPath,
+		definition,
+		loaded: loaded.value
+	};
+	const fixtures = Object.keys(definition.fixtures);
+	const fixture = input.fixture !== void 0 && fixtures.includes(input.fixture) ? input.fixture : fixtures[0] ?? null;
+	const delivered = renderEmailFixtures(entry, LOCAL_RENDER);
+	const diagnostics = [...loaded.value.compiled.diagnostics, ...delivered.flatMap((result) => result.diagnostics.map((diagnostic) => ({
+		...diagnostic,
+		fixtures: [result.fixture]
+	})))];
+	const incompatibilities = delivered.flatMap((result) => result.rendered === void 0 ? [] : checkEmailCompatibility({
+		html: result.rendered.html,
+		fixture: result.fixture,
+		positions: result.rendered.positions
+	}));
+	return {
+		ok: true,
+		variables: variablesOf(definition),
+		template: {
+			channel: "email",
+			fixtures,
+			fixture,
+			...fixture === null ? { render: null } : previewRender(entry, fixture),
+			diagnostics,
+			incompatibilities,
+			identity: JSON.stringify({
+				diagnostics,
+				incompatibilities,
+				fixtures: delivered.map((result) => ({
+					fixture: result.fixture,
+					subject: result.rendered?.subject ?? null,
+					preheader: result.rendered?.preheader ?? null,
+					html: result.rendered?.html ?? null,
+					text: result.rendered?.text ?? null
+				}))
+			})
+		}
+	};
+};
 const samvaEditor = (options = {}) => {
 	const route = normalizeRoute(options.route ?? DEFAULT_ROUTE);
 	const apiPrefix = childRoute(route, "api");
 	let root = process.cwd();
 	let templatesDir = resolve(root, options.templatesDir ?? "emails");
-	let theme = new ThemeState(resolveThemePath(root, options.theme));
-	let store = new EditorFileStore(templatesDir, { compile: () => theme.applyTo(options.compile) });
+	let themePath = resolveThemePath(root, options.theme);
+	let store = new EditorFileStore(templatesDir, { projectRoot: root });
 	let authenticated = false;
 	const clients = /* @__PURE__ */ new Set();
 	const catalogClients = /* @__PURE__ */ new Set();
@@ -533,7 +670,6 @@ const samvaEditor = (options = {}) => {
 		});
 		return refreshTail;
 	};
-	const queueRefresh = (server, documents) => queueStoreRefresh(server, () => store.refreshAll({ documents }));
 	return {
 		name: "samva-editor",
 		config() {
@@ -548,25 +684,61 @@ const samvaEditor = (options = {}) => {
 		configResolved(resolved) {
 			root = resolved.root;
 			templatesDir = isAbsolute(options.templatesDir ?? "") ? options.templatesDir : resolve(root, options.templatesDir ?? "emails");
-			theme = new ThemeState(resolveThemePath(root, options.theme));
-			store = new EditorFileStore(templatesDir, { compile: () => theme.applyTo(options.compile) });
+			themePath = resolveThemePath(root, options.theme);
+			store = new EditorFileStore(templatesDir, { projectRoot: root });
 			const env = loadEnv(resolved.mode, root, "");
 			authenticated = Boolean(env.SAMVA_API_KEY);
 		},
 		async configureServer(server) {
-			await theme.refresh();
-			const evaluator = createServerModuleRunner(server.environments.ssr, { hmr: false });
+			const moduleRunner = createServerModuleRunner(server.environments.ssr, { hmr: false });
+			const assets = /* @__PURE__ */ new Map();
+			let themeCss;
+			let emailRenderer;
+			let emailRendererLoading;
+			const emailRendererFor = () => emailRendererLoading ??= createEmailRenderer({
+				assetBase: childRoute(apiPrefix, "assets"),
+				...themeCss === void 0 ? {} : { tailwind: { css: themeCss } }
+			}).then((renderer) => {
+				emailRenderer = renderer;
+				return renderer;
+			});
+			let projectFiles;
+			let emailRenderTail = Promise.resolve();
 			store = new EditorFileStore(templatesDir, {
-				compile: () => theme.applyTo(options.compile),
-				evaluateTsx: async (path, id, name, compile) => {
-					const moduleExports = await evaluator.import(path);
-					return evaluateDefaultExport(id, name, moduleExports, compile);
+				projectRoot: root,
+				evaluator: {
+					refresh: async () => {
+						projectFiles = void 0;
+						const nextThemeCss = await readProjectThemeCss(themePath);
+						if (nextThemeCss !== themeCss) {
+							await emailRendererLoading?.then((renderer) => renderer.close());
+							emailRenderer = void 0;
+							emailRendererLoading = void 0;
+							themeCss = nextThemeCss;
+						}
+						emailRenderer?.invalidate();
+					},
+					evaluate: async ({ path, id, name, fixture }) => {
+						const moduleExports = await moduleRunner.import(path);
+						if (!isTemplateDefinition(moduleExports["default"])) return evaluateDefaultExport(id, name, moduleExports);
+						const render = async () => evaluateEmailEntry({
+							renderer: await emailRendererFor(),
+							files: await (projectFiles ??= readEmailProject(root)),
+							entryPath: relative(root, path).split(sep).join("/"),
+							assets,
+							id,
+							fixture
+						});
+						const pending = emailRenderTail.then(render, render);
+						emailRenderTail = pending;
+						return pending;
+					}
 				}
 			});
 			server.watcher.add(templatesDir);
-			if (theme.themePath !== void 0) server.watcher.add(theme.themePath);
+			if (themePath !== void 0) server.watcher.add(themePath);
 			const refreshTheme = () => {
-				theme.refresh().then(() => queueRefresh(server, false));
+				queueStoreRefresh(server, () => store.refreshAll({ documents: true }));
 			};
 			const refreshTsxDependents = (path, shapeChange) => {
 				const ssr = server.environments.ssr;
@@ -585,51 +757,39 @@ const samvaEditor = (options = {}) => {
 					for (const module of changedModules) collectImporters(module);
 					if (shapeChange) ssr.moduleGraph.invalidateAll();
 					else for (const module of invalidated) ssr.moduleGraph.invalidateModule(module);
-					evaluator.evaluatedModules.clear();
+					moduleRunner.evaluatedModules.clear();
 					return store.refreshAll({ documents: true });
 				});
 			};
 			const onChange = (path) => {
-				if (theme.themePath !== void 0 && path === theme.themePath) {
+				if (themePath !== void 0 && path === themePath) {
 					refreshTheme();
 					return;
 				}
-				if (path.endsWith(".samva")) {
-					store.handleFileChange(path).then((change) => {
-						if (change !== void 0) queueStoreRefresh(server, () => store.refreshSamva(change.id));
-					});
-					return;
-				}
 				refreshTsxDependents(path, false);
 			};
 			const onCatalogShape = (path) => {
-				if (theme.themePath !== void 0 && path === theme.themePath) {
+				if (themePath !== void 0 && path === themePath) {
 					refreshTheme();
 					return;
 				}
-				if (store.idFor(path)?.endsWith(".samva")) {
-					queueRefresh(server, true);
-					return;
-				}
 				refreshTsxDependents(path, true);
 			};
 			server.watcher.on("change", onChange);
 			server.watcher.on("add", onCatalogShape);
 			server.watcher.on("unlink", onCatalogShape);
 			const unsubscribe = store.subscribe((change) => {
+				const { sourceClient, ...document } = change;
 				server.ws.send({
 					type: "custom",
 					event: "samva:document",
-					data: change
+					data: document
 				});
 				for (const client of clients) {
 					if (client.docId !== change.id) continue;
-					const origin = change.sourceClient !== void 0 && change.sourceClient === client.clientId ? "self" : "external";
+					const origin = sourceClient !== void 0 && sourceClient === client.clientId ? "self" : "external";
 					client.push({
-						id: change.id,
-						rev: change.rev,
-						source: change.source,
-						authoredSource: change.authoredSource,
+						...document,
 						origin
 					});
 				}
@@ -652,7 +812,8 @@ const samvaEditor = (options = {}) => {
 				server.httpServer?.off("close", cleanup);
 				unsubscribe();
 				unsubscribeCatalog();
-				evaluator.close();
+				moduleRunner.close();
+				emailRendererLoading?.then((renderer) => renderer.close());
 				for (const client of clients) client.res.end();
 				clients.clear();
 				for (const res of catalogClients) res.end();
@@ -671,45 +832,59 @@ const samvaEditor = (options = {}) => {
 					if (pathname === `${apiPrefix}/capabilities`) return sendJson(res, 200, { authenticated });
 					if (pathname === `${apiPrefix}/templates`) {
 						const catalog = await store.catalog();
-						const themeFile = theme.themePath === void 0 ? void 0 : relative(root, theme.themePath);
-						const themeDiagnostics = theme.current().diagnostics.map((item) => ({
-							file: themeFile ?? "theme.css",
-							severity: "error",
-							code: item.code,
-							message: item.message,
-							span: item.span
-						}));
 						return sendJson(res, 200, {
 							templates: catalog.templates,
-							diagnostics: [...catalog.diagnostics, ...themeDiagnostics],
-							theme: {
-								file: themeFile,
-								tokens: theme.current().tokens
-							},
-							compile: theme.applyTo(options.compile)
+							diagnostics: catalog.diagnostics
 						});
 					}
 					if (pathname === `${apiPrefix}/document`) {
 						const id = query.get("id");
 						if (!id) return sendJson(res, 400, { error: "missing id" });
 						if (req.method === "POST") {
-							const raw = await readBody(req);
-							let update;
+							const origin = req.headers.origin;
+							if (origin !== void 0 && origin !== `http://${req.headers.host}` && origin !== `https://${req.headers.host}`) return sendJson(res, 403, { error: "Source saves require the editor origin." });
+							let body;
 							try {
-								update = JSON.parse(raw);
-							} catch {
+								body = JSON.parse(await readBody(req));
+							} catch (error) {
+								if (error instanceof EditorBodyTooLarge) return sendJson(res, 413, { error: error.message });
 								return sendJson(res, 400, { error: "malformed JSON body" });
 							}
-							if (!Predicate.isObject(update)) return sendJson(res, 400, { error: "malformed JSON body" });
-							const outcome = await store.save(id, update, query.get("client") ?? void 0);
+							if (!Predicate.isObject(body) || body["kind"] !== "authoredSource" || typeof body["baseRev"] !== "string" || typeof body["authoredSource"] !== "string") return sendJson(res, 400, { error: "Expected a revision-bound authored source update." });
+							if (Buffer.byteLength(body["authoredSource"], "utf8") > 1048576) return sendJson(res, 413, { error: "Authored source exceeds the 1 MiB limit." });
+							const outcome = await store.saveSource(id, body["baseRev"], body["authoredSource"], query.get("client") ?? void 0);
 							if (outcome.ok) return sendJson(res, 200, { rev: outcome.rev });
-							if ("conflict" in outcome) return sendJson(res, 409, outcome.conflict);
-							return sendJson(res, 422, { error: outcome.error });
+							return sendJson(res, outcome.kind === "conflict" ? 409 : outcome.kind === "missing" ? 404 : 422, outcome);
 						}
+						if (req.method !== "GET") return sendJson(res, 405, { error: "Use GET or POST." });
 						const snapshot = await store.open(id);
 						if (snapshot === void 0) return sendJson(res, 404, { error: "template not found" });
 						return sendJson(res, 200, snapshot);
 					}
+					if (pathname === `${apiPrefix}/fixture`) {
+						const id = query.get("id");
+						if (!id) return sendJson(res, 400, { error: "missing id" });
+						if (req.method !== "POST") return sendJson(res, 405, { error: "viewing a fixture is a POST" });
+						const raw = await readBody(req);
+						let body;
+						try {
+							body = JSON.parse(raw);
+						} catch {
+							return sendJson(res, 400, { error: "malformed JSON body" });
+						}
+						if (!Predicate.isObject(body) || typeof body["fixture"] !== "string") return sendJson(res, 400, { error: "malformed JSON body" });
+						const outcome = await store.viewFixture(id, body["fixture"], query.get("client") ?? void 0);
+						if (outcome.ok) return sendJson(res, 200, {});
+						return sendJson(res, outcome.kind === "missing" ? 404 : 422, { error: outcome.error });
+					}
+					if (pathname.startsWith(`${apiPrefix}/assets/`)) {
+						const asset = assets.get(pathname.slice(`${apiPrefix}/assets/`.length));
+						if (asset === void 0) return sendJson(res, 404, { error: "asset not found" });
+						res.statusCode = 200;
+						res.setHeader("content-type", asset.contentType);
+						res.end(Buffer.from(asset.bytes));
+						return;
+					}
 					if (pathname === `${apiPrefix}/events`) {
 						const id = query.get("id");
 						if (!id) return sendJson(res, 400, { error: "missing id" });
@@ -747,7 +922,7 @@ const samvaEditor = (options = {}) => {
 					if (await serveStatic(res, join(EDITOR_DIR, "index.html"))) return;
 					return next();
 				})().catch((error) => {
-					sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+					sendJson(res, error instanceof EditorBodyTooLarge ? 413 : 500, { error: error instanceof Error ? error.message : String(error) });
 				});
 			};
 			server.middlewares.use(handler);