@samva/vite 0.8.0 → 0.10.0

package/dist/project.d.ts

@@ -1,175 +1,2 @@
-import { EmailProjectSource, EmailRenderer, LoadedEmailEntry } from "./email.js";
-import { AssetEntry, EmailBrand, 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/brand.d.ts
-/** Where `samva brands pull` writes snapshots, relative to the project root. */
-declare const BRAND_SNAPSHOT_DIR = ".samva/brands";
-declare const SNAPSHOT_VERSION = 1;
-/** A brand as a build compiles it, with the digest the API knows its content by. */
-interface ResolvedBrand extends EmailBrand {
-  readonly digest: string;
-}
-/** The file `samva brands pull` writes. */
-interface BrandSnapshot extends ResolvedBrand {
-  readonly version: typeof SNAPSHOT_VERSION;
-  readonly name: string;
-  readonly isDefault: boolean;
-  /** ISO timestamp of the pull. */
-  readonly pulledAt: string;
-}
-type BrandWarningCode = "brand-snapshot-stale" | "brand-offline";
-interface BrandWarning {
-  readonly code: BrandWarningCode;
-  readonly message: string;
-}
-type BrandResolution = {
-  readonly ok: true;
-  /** `undefined` when the project imports no brand. */
-  readonly brand: ResolvedBrand | undefined;
-  readonly source: "live" | "snapshot" | "none";
-  readonly warnings: readonly BrandWarning[];
-} | {
-  readonly ok: false;
-  readonly message: string;
-};
-interface ResolveProjectBrandInput {
-  readonly root: string;
-  readonly files: EmailProjectSource;
-  /** Project-relative theme path; `undefined` when theming is disabled. */
-  readonly themePath?: string | undefined;
-  /** Environment holding `SAMVA_API_KEY`, `SAMVA_API_URL` and `PATH`; see `loadBrandEnv`. */
-  readonly env: Readonly<Record<string, string | undefined>>;
-}
-/**
- * Resolve the brand a project's `samva:brand` import names: live when the
- * environment's credentials reach the API, else the pulled snapshot with a
- * warning, else a failure naming both fixes.
- */
-declare const resolveProjectBrand: (input: ResolveProjectBrandInput) => Promise<BrandResolution>;
-/**
- * The environment a local build resolves the brand with: the process
- * environment plus the project's `.env` files, as the editor's dev server
- * reads them, so `SAMVA_API_KEY` in `.env` reaches `check` and `export` too.
- */
-declare const loadBrandEnv: (root: string) => Promise<Readonly<Record<string, string | undefined>>>;
-//#endregion
-//#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: {
-  /** Directory holding the templates; every `.tsx` under it is a candidate entry. */
-  readonly dir: string;
-  /**
-   * Project root holding shared imports, `theme.css` and `.samva/brands`; defaults to `dir`.
-   * `samva templates export` passes the working directory, as `check` and `build` do.
-   */
-  readonly root?: string | undefined;
-  readonly out: string;
-  readonly assetBase?: string | undefined;
-  /** Project theme file relative to `root`, as in `buildTemplates()`; `false` disables it. */
-  readonly theme?: string | false | undefined;
-}) => Promise<EmailExportReceipt>;
-//#endregion
-export { BRAND_SNAPSHOT_DIR, type BrandResolution, type BrandSnapshot, type BrandWarning, DEFAULT_EXPORT_ASSET_BASE, EmailCatalog, EmailCatalogEntry, EmailExportReceipt, EmailProjectSession, RenderedFixture, type ResolvedBrand, createEmailProjectSession, exportEmailProject, isTemplateDefinition, loadBrandEnv, loadEmailCatalog, readEmailProject, renderEmailFixtures, resolveProjectBrand };
-//# 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-CRqjs-wV.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,2 +1,2 @@
-import { a as loadEmailCatalog, d as BRAND_SNAPSHOT_DIR, h as resolveProjectBrand, i as isTemplateDefinition, m as loadBrandEnv, n as createEmailProjectSession, o as readEmailProject, r as exportEmailProject, s as renderEmailFixtures, t as DEFAULT_EXPORT_ASSET_BASE } from "./project-RON2Ei7d.js";
-export { BRAND_SNAPSHOT_DIR, DEFAULT_EXPORT_ASSET_BASE, createEmailProjectSession, exportEmailProject, isTemplateDefinition, loadBrandEnv, loadEmailCatalog, readEmailProject, renderEmailFixtures, resolveProjectBrand };
+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-Ut6wra0r.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-CRqjs-wV.js";
+import { RenderedIrWhatsApp } from "@samva/markup/render";
+import { EmailDiagnostic } from "@samva/markup/diagnostics";
+//#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-Ut6wra0r.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.8.0",
-  "description": "Unified Vite editor for Samva email, SMS, and WhatsApp templates",
+  "version": "0.10.0",
+  "description": "Local editor, dev server and build for Samva email, SMS and WhatsApp templates",
   "keywords": [
     "email",
     "samva",
@@ -28,6 +28,7 @@
     "!dist/**/*.map",
     "package.json",
     "README.md",
+    "CHANGELOG.md",
     "AGENTS.md",
     "LICENSE"
   ],
@@ -38,10 +39,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 +47,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,17 +65,12 @@
     "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",
     "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.8.0",
-    "better-result": "3.0.1",
-    "caniemail": "2.0.2",
-    "css-tree": "3.2.1",
-    "tailwindcss": "^4.3.3"
+    "@samva/markup": "^0.10.0"
   },
   "devDependencies": {
     "@effect/vitest": "4.0.0-rc.117",

package/dist/discovery-D2eR-rzi.js

@@ -1,35 +0,0 @@
-import { readdir } from "node:fs/promises";
-import { join, relative, sep } from "node:path";
-//#region src/discovery.ts
-const isTemplateFile = (name) => name.endsWith(".tsx");
-const toPosix = (value) => sep === "/" ? value : value.split(sep).join("/");
-/**
-* Recursively lists template files under `dir`. Hidden entries and
-* `node_modules` are skipped. Results are sorted by id for deterministic
-* ordering (the preview list and build output must be stable).
-*/
-const discoverTemplateFiles = async (dir) => {
-	const found = [];
-	const walk = async (current) => {
-		const visible = (await readdir(current, { withFileTypes: true })).filter((entry) => !entry.name.startsWith(".") && entry.name !== "node_modules");
-		await Promise.all(visible.map(async (entry) => {
-			const full = join(current, entry.name);
-			if (entry.isDirectory()) {
-				await walk(full);
-				return;
-			}
-			if (!isTemplateFile(entry.name)) return;
-			found.push({
-				path: full,
-				id: toPosix(relative(dir, full)),
-				kind: "tsx"
-			});
-		}));
-	};
-	await walk(dir);
-	return found.sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
-};
-//#endregion
-export { discoverTemplateFiles as t };
-
-//# sourceMappingURL=discovery-D2eR-rzi.js.map