@samva/markup 0.2.0 → 0.3.0

package/dist/presets/public-gallery.js

@@ -1,4 +1,4 @@
-import { matchesTemplateFacets, registerPublicCorpusEntry } from "./corpus.js";
+import { brandRecreationProvenance, matchesTemplateFacets, registerPublicCorpusEntry } from "./corpus.js";
 import { Result } from "effect";
 //#region presets/public-gallery.ts
 const templateUseCases = [
@@ -14,7 +14,7 @@ const templateCollectionFamilies = [
 	"stage",
 	"style"
 ];
-const isMadeWithSamvaTemplate = (template) => template.corpus._tag === "OwnedEditablePreset";
+const isMadeWithSamvaTemplate = (template) => template.corpus._tag === "OwnedEditablePreset" || template.corpus._tag === "BrandRecreationPreset";
 /** Explicit evidence for every owned preset reviewed in the 2026-08-31 catalog pass. */
 const ownedPresetReviewManifest = {
 	welcome: {
@@ -71,6 +71,12 @@ const ownedPresetReviewManifest = {
 		reviewedAt: "2026-08-31T00:00:00.000Z",
 		notes: "Reviewed team-invite editable SML, public preview data, and gallery identity."
 	},
+	"product-newsletter": {
+		sourcePath: "examples/email-showcase/emails/product-newsletter.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-09-08T00:00:00.000Z",
+		notes: "Reviewed product-newsletter editable SML project, authored assets, public preview data, and gallery identity."
+	},
 	"product-digest": {
 		sourcePath: "packages/markup/presets/product-digest.tsx",
 		reviewedBy: "Samva catalog review",
@@ -167,6 +173,12 @@ const ownedPresetReviewManifest = {
 		reviewedAt: "2026-08-31T00:00:00.000Z",
 		notes: "Reviewed order-delivered editable SML, public preview data, and gallery identity."
 	},
+	"order-receipt": {
+		sourcePath: "examples/email-showcase/emails/order-receipt.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-09-08T00:00:00.000Z",
+		notes: "Reviewed order-receipt editable project with stylesheet and original assets, public preview data, and gallery identity."
+	},
 	"travel-rewards-promo": {
 		sourcePath: "packages/markup/presets/travel-rewards-promo.tsx",
 		reviewedBy: "Samva catalog review",
@@ -244,8 +256,15 @@ const ownedPresetReviewManifest = {
 		reviewedBy: "Samva catalog review",
 		reviewedAt: "2026-08-31T00:00:00.000Z",
 		notes: "Reviewed season-clearance-promo editable SML, public preview data, and gallery identity."
+	},
+	"product-launch-promo": {
+		sourcePath: "examples/email-showcase/emails/product-launch-promo.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-09-08T00:00:00.000Z",
+		notes: "Reviewed product-launch-promo editable project, original Oakline assets, public preview data, and gallery identity."
 	}
 };
+const isBrandRecreationPresetId = (presetId) => Object.hasOwn(brandRecreationProvenance, presetId);
 const audienceFor = (useCase) => {
 	switch (useCase) {
 		case "account-access": return ["product-users"];
@@ -261,35 +280,64 @@ const audienceFor = (useCase) => {
 };
 const facetValues = (collections, prefix) => collections.filter((id) => id.startsWith(`${prefix}:`)).map((id) => id.slice(prefix.length + 1));
 const template = (value) => {
-	const review = ownedPresetReviewManifest[value.presetId];
-	const corpus = {
-		_tag: "OwnedEditablePreset",
-		corpusKind: "owned-editable-sml",
-		provenance: {
-			owner: "Samva",
-			sourcePath: review.sourcePath,
-			recordedAt: review.reviewedAt
-		},
-		review: {
-			state: "approved",
-			reviewedBy: review.reviewedBy,
-			reviewedAt: review.reviewedAt,
-			notes: review.notes
-		},
-		display: {
-			state: "public",
-			attributionLabel: "Made with Samva"
-		},
-		retention: {
-			policy: "retain-until-withdrawn",
-			reviewedAt: review.reviewedAt
-		},
-		takedown: {
-			state: "active",
-			contact: "legal@samva.dev",
-			procedureUrl: "https://samva.dev/contact?subject=Template%20takedown"
+	const corpus = (() => {
+		if (isBrandRecreationPresetId(value.presetId)) {
+			const provenance = brandRecreationProvenance[value.presetId];
+			return {
+				_tag: "BrandRecreationPreset",
+				corpusKind: "brand-recreation-sml",
+				provenance,
+				review: {
+					state: "approved",
+					reviewedBy: "Samva catalog review",
+					reviewedAt: provenance.recordedAt,
+					notes: provenance.reviewedNote
+				},
+				display: {
+					state: "public",
+					attributionLabel: `Recreated with Samva. ${provenance.brand} does not endorse or have an affiliation with this example.`
+				},
+				retention: {
+					policy: "retain-until-withdrawn",
+					reviewedAt: provenance.recordedAt
+				},
+				takedown: {
+					state: "active",
+					contact: "legal@samva.dev",
+					procedureUrl: "https://samva.dev/contact?subject=Template%20takedown"
+				}
+			};
 		}
-	};
+		const review = ownedPresetReviewManifest[value.presetId];
+		return {
+			_tag: "OwnedEditablePreset",
+			corpusKind: "owned-editable-sml",
+			provenance: {
+				owner: "Samva",
+				sourcePath: review.sourcePath,
+				recordedAt: review.reviewedAt
+			},
+			review: {
+				state: "approved",
+				reviewedBy: review.reviewedBy,
+				reviewedAt: review.reviewedAt,
+				notes: review.notes
+			},
+			display: {
+				state: "public",
+				attributionLabel: "Made with Samva"
+			},
+			retention: {
+				policy: "retain-until-withdrawn",
+				reviewedAt: review.reviewedAt
+			},
+			takedown: {
+				state: "active",
+				contact: "legal@samva.dev",
+				procedureUrl: "https://samva.dev/contact?subject=Template%20takedown"
+			}
+		};
+	})();
 	const facets = {
 		jobType: [value.useCase],
 		lifecycle: facetValues(value.collections, "stage"),
@@ -297,7 +345,7 @@ const template = (value) => {
 		season: value.presetId === "seasonal-sale-flyer" || value.presetId === "season-clearance-promo" ? ["seasonal"] : ["evergreen"],
 		audience: audienceFor(value.useCase),
 		design: facetValues(value.collections, "style"),
-		brandProvenance: ["samva-original"]
+		brandProvenance: [corpus._tag === "BrandRecreationPreset" ? "third-party-reference" : "samva-original"]
 	};
 	const registration = registerPublicCorpusEntry({
 		id: value.presetId,
@@ -644,6 +692,24 @@ const publicTemplates = [
 		],
 		relatedTemplates: ["shipping-update", "receipt"]
 	}),
+	template({
+		presetId: "order-receipt",
+		slug: "order-receipt",
+		useCase: "commerce",
+		collections: [
+			"category:transactional",
+			"industry:ecommerce",
+			"stage:transaction",
+			"style:minimal",
+			"style:data-heavy",
+			"style:single-cta"
+		],
+		relatedTemplates: [
+			"receipt",
+			"order-delivered",
+			"shipping-update"
+		]
+	}),
 	template({
 		presetId: "travel-rewards-promo",
 		slug: "travel-rewards-promo",
@@ -812,6 +878,63 @@ const publicTemplates = [
 			"style:single-cta"
 		],
 		relatedTemplates: ["promo", "announcement"]
+	}),
+	template({
+		presetId: "linear-login-code",
+		slug: "linear-login-code",
+		useCase: "account-access",
+		collections: [
+			"category:transactional",
+			"industry:saas",
+			"industry:developer-tools",
+			"stage:activation",
+			"style:minimal",
+			"style:branded",
+			"style:single-cta"
+		],
+		relatedTemplates: ["otp", "email-verification"]
+	}),
+	template({
+		presetId: "product-newsletter",
+		slug: "product-newsletter",
+		useCase: "publishing-campaigns",
+		collections: [
+			"category:digest-editorial",
+			"industry:saas",
+			"industry:developer-tools",
+			"stage:engagement",
+			"style:editorial",
+			"style:branded"
+		],
+		relatedTemplates: ["newsletter", "product-digest"]
+	}),
+	template({
+		presetId: "product-launch-promo",
+		slug: "product-launch-promotion",
+		useCase: "commerce",
+		collections: [
+			"category:marketing",
+			"industry:ecommerce",
+			"stage:engagement",
+			"style:branded",
+			"style:single-cta"
+		],
+		relatedTemplates: ["promo", "season-clearance-promo"]
+	}),
+	template({
+		presetId: "vercel-invitation",
+		slug: "vercel-team-invitation",
+		useCase: "product-communication",
+		collections: [
+			"category:transactional",
+			"industry:saas",
+			"industry:developer-tools",
+			"stage:activation",
+			"style:minimal",
+			"style:branded",
+			"style:single-cta"
+		],
+		relatedTemplates: ["team-invite", "welcome"]
 	})
 ];
 const publicTemplateIds = publicTemplates.map((item) => item.presetId);

package/dist/presets/public-handoff.d.ts

@@ -2,11 +2,18 @@ import { d as Channel } from "../ast-63I-VLQx.js";
 import { PresetCategory } from "../presets.js";
 import { TemplateCollectionId, TemplateUseCase } from "./public-gallery.js";
 import { PublicTemplatePreview } from "./public-preview.js";
+import { PresetProject } from "./sources.js";
 import { Result } from "effect";
 //#region presets/public-handoff.d.ts
+/** The brand a clean-room recreation names, and what its email does. */
+interface TemplateBrandRecreation {
+  readonly brand: string;
+  readonly subject: string;
+}
 /** Where an approved public artifact came from. */
 interface TemplateReferenceProvenance {
-  readonly source: "samva-owned" | "sanitized-synthetic" | "reviewed-public";
+  readonly source: "samva-owned" | "sanitized-synthetic" | "reviewed-public" | "brand-recreation";
+  readonly brandRecreation?: TemplateBrandRecreation;
   /** Stable identifier in the producing system; never a third-party URL. */
   readonly referenceId: string;
   /** Stable ISO-8601 timestamp supplied by the producer. */
@@ -27,6 +34,7 @@ interface ApprovedPublicTemplateArtifact {
     readonly description: string;
     readonly variables: ReadonlyArray<string>;
     readonly source: string;
+    readonly project?: PresetProject;
   };
   readonly gallery: {
     readonly slug: string;
@@ -62,8 +70,9 @@ interface TemplateReferencePacket {
   readonly provenance: TemplateReferenceProvenance;
 }
 interface ValidatedPublicTemplateArtifact {
-  readonly preset: Omit<ApprovedPublicTemplateArtifact["preset"], "source">;
+  readonly preset: Omit<ApprovedPublicTemplateArtifact["preset"], "source" | "project">;
   readonly source: string;
+  readonly project?: PresetProject;
   readonly gallery: ApprovedPublicTemplateArtifact["gallery"] & {
     readonly path: `/templates/${string}`;
   };
@@ -82,6 +91,16 @@ interface PublicHandoffIssue {
 }
 /** Bound authored source before parsing or mounting it. */
 declare const PUBLIC_TEMPLATE_SOURCE_MAX_CHARACTERS = 512000;
+/** Bounds apply to decoded bytes, before evaluation or disk emission. */
+declare const PUBLIC_TEMPLATE_PROJECT_MAX_BYTES: number;
+declare const PUBLIC_TEMPLATE_PROJECT_FILE_MAX_BYTES: number;
+declare const PUBLIC_TEMPLATE_PROJECT_MAX_FILES = 64;
+declare const isSafePublicTemplateProjectPath: (path: string) => boolean;
+/** Reject traversal, collisions, malformed base64 and oversized authored projects. */
+declare const isSafePublicTemplateProject: (project: PresetProject) => boolean;
+/** Digest the complete authored graph independently of caller file ordering. */
+declare const publicTemplateProjectDigest: (project: Pick<PresetProject, "entryPath" | "files">) => Promise<string>;
+declare const isValidTemplateBrandRecreation: (brandRecreation: TemplateBrandRecreation | undefined, project: PresetProject | undefined) => boolean;
 /** Static syntax inventory; loops, branches and component expansion are not evaluated. */
 interface PublicTemplateAuthoredStructure {
   readonly basis: "authored-jsx";
@@ -117,12 +136,17 @@ type TemplateReferenceProjection = {
   readonly relativePath: "preset.tsx";
   readonly contents: string;
 } | {
-  readonly kind: "catalog" | "gallery" | "preview" | "editorial";
-  readonly relativePath: `${"catalog" | "gallery" | "preview" | "editorial"}.json`;
+  readonly kind: "project-file";
+  readonly relativePath: `project/${string}`;
+  readonly contents: string;
+  readonly encoding: "utf8" | "base64";
+} | {
+  readonly kind: "catalog" | "gallery" | "preview" | "editorial" | "project";
+  readonly relativePath: `${"catalog" | "gallery" | "preview" | "editorial" | "project"}.json`;
   readonly contents: string;
 };
 /**
- * Emits the five destination projections as deterministic bytes. The importer
+ * Emits legacy projections plus the complete project as deterministic bytes. The importer
  * owns no checked-in destination files; callers choose an explicit output dir.
  */
 declare const emitTemplateReferencePacket: (packet: TemplateReferencePacket) => ReadonlyArray<TemplateReferenceProjection>;
@@ -136,5 +160,5 @@ declare const emitTemplateReferencePacket: (packet: TemplateReferencePacket) =>
  */
 declare const validatePublicTemplateHandoff: (artifacts: ReadonlyArray<ApprovedPublicTemplateArtifact>) => Result.Result<ReadonlyArray<ValidatedPublicTemplateArtifact>, ReadonlyArray<PublicHandoffIssue>>;
 //#endregion
-export { ApprovedPublicTemplateArtifact, PUBLIC_TEMPLATE_SOURCE_MAX_CHARACTERS, PublicHandoffIssue, PublicHandoffIssueCode, PublicTemplateAuthoredStructure, TemplateReferencePacket, TemplateReferenceProjection, TemplateReferenceProvenance, ValidatedPublicTemplateArtifact, emitTemplateReferencePacket, isSafePublicTemplateAsset, publicTemplateAuthoredStructure, toTemplateReferencePacket, unsupportedPublicTemplateFontTokens, validatePublicTemplateHandoff };
+export { ApprovedPublicTemplateArtifact, PUBLIC_TEMPLATE_PROJECT_FILE_MAX_BYTES, PUBLIC_TEMPLATE_PROJECT_MAX_BYTES, PUBLIC_TEMPLATE_PROJECT_MAX_FILES, PUBLIC_TEMPLATE_SOURCE_MAX_CHARACTERS, PublicHandoffIssue, PublicHandoffIssueCode, PublicTemplateAuthoredStructure, TemplateBrandRecreation, TemplateReferencePacket, TemplateReferenceProjection, TemplateReferenceProvenance, ValidatedPublicTemplateArtifact, emitTemplateReferencePacket, isSafePublicTemplateAsset, isSafePublicTemplateProject, isSafePublicTemplateProjectPath, isValidTemplateBrandRecreation, publicTemplateAuthoredStructure, publicTemplateProjectDigest, toTemplateReferencePacket, unsupportedPublicTemplateFontTokens, validatePublicTemplateHandoff };
 //# sourceMappingURL=public-handoff.d.ts.map

package/dist/presets/public-handoff.js

@@ -11,9 +11,62 @@ const MAX_DATA_IMAGE_ASSET_LENGTH = 32768;
 const DATA_IMAGE = /^data:image\/(?:avif|gif|jpeg|png|svg\+xml|webp)(?:;charset=[a-z0-9-]+)?(?:;base64)?,[^\r\n]+$/i;
 const PUBLIC_TEMPLATE_ASSET_PATH = /^\/templates\/assets\/[A-Za-z0-9][A-Za-z0-9._-]*\.(?:jpe?g|png|webp)$/;
 const BLOCKED_PUBLIC_ASSET = /(?:unsplash|placehold|assets\.example)/i;
-const isTemplateReferenceProvenanceSource = (value) => value === "samva-owned" || value === "sanitized-synthetic" || value === "reviewed-public";
+/** A sample value is non-empty when every string in it is, and no list or object is empty. */
+const nonEmptySample = (value) => {
+	if (typeof value === "string") return nonEmpty(value);
+	if (Array.isArray(value)) return value.length > 0 && value.every(nonEmptySample);
+	if (Predicate.isObject(value)) {
+		const values = Object.values(value);
+		return values.length > 0 && values.every(nonEmptySample);
+	}
+	return true;
+};
+const isTemplateReferenceProvenanceSource = (value) => value === "samva-owned" || value === "sanitized-synthetic" || value === "reviewed-public" || value === "brand-recreation";
 /** Bound authored source before parsing or mounting it. */
 const PUBLIC_TEMPLATE_SOURCE_MAX_CHARACTERS = 512e3;
+/** Bounds apply to decoded bytes, before evaluation or disk emission. */
+const PUBLIC_TEMPLATE_PROJECT_MAX_BYTES = 8388608;
+const PUBLIC_TEMPLATE_PROJECT_FILE_MAX_BYTES = 2097152;
+const PUBLIC_TEMPLATE_PROJECT_MAX_FILES = 64;
+const isSafePublicTemplateProjectPath = (path) => path.length <= 240 && path.split("/").every((part) => /^[A-Za-z0-9_][A-Za-z0-9._-]*$/.test(part) && part !== "." && part !== ".." && part !== "node_modules");
+/** Reject traversal, collisions, malformed base64 and oversized authored projects. */
+const isSafePublicTemplateProject = (project) => {
+	if (!isSafePublicTemplateProjectPath(project.entryPath) || !project.entryPath.endsWith(".tsx") || !/^[a-f0-9]{64}$/.test(project.digest) || project.files.length === 0 || project.files.length > 64) return false;
+	const paths = /* @__PURE__ */ new Set();
+	let total = 0;
+	for (const file of project.files) {
+		if (!isSafePublicTemplateProjectPath(file.path) || paths.has(file.path.toLowerCase())) return false;
+		paths.add(file.path.toLowerCase());
+		let bytes;
+		if (file.encoding === "utf8") {
+			if (file.content.length > 512e3) return false;
+			bytes = new TextEncoder().encode(file.content).length;
+		} else if (file.encoding === "base64") {
+			if (file.content.length > Math.ceil(2097152 / 3) * 4 || file.content.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(file.content)) return false;
+			if (btoa(atob(file.content)) !== file.content) return false;
+			bytes = file.content.length / 4 * 3 - (file.content.endsWith("==") ? 2 : file.content.endsWith("=") ? 1 : 0);
+		} else return false;
+		if (bytes > 2097152) return false;
+		total += bytes;
+		if (total > 8388608) return false;
+	}
+	for (const path of paths) if (path.split("/").slice(0, -1).some((_, index, parts) => paths.has(parts.slice(0, index + 1).join("/")))) return false;
+	return project.files.some((file) => file.path === project.entryPath && file.encoding === "utf8");
+};
+/** Digest the complete authored graph independently of caller file ordering. */
+const publicTemplateProjectDigest = async (project) => {
+	const serialized = JSON.stringify({
+		entryPath: project.entryPath,
+		files: [...project.files].sort((a, b) => a.path.localeCompare(b.path)).map(({ path, content, encoding }) => ({
+			path,
+			content,
+			encoding
+		}))
+	});
+	const bytes = new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(serialized)));
+	return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+};
+const isValidTemplateBrandRecreation = (brandRecreation, project) => brandRecreation !== void 0 && project !== void 0 && brandRecreation.brand.trim().length > 0 && brandRecreation.subject.trim().length > 0;
 const PUBLIC_TEMPLATE_FONT_TOKENS = /* @__PURE__ */ new Set([
 	"sans",
 	"serif",
@@ -167,37 +220,51 @@ const jsonProjection = (kind, value) => ({
 	contents: `${JSON.stringify(value, null, 2)}\n`
 });
 /**
-* Emits the five destination projections as deterministic bytes. The importer
+* Emits legacy projections plus the complete project as deterministic bytes. The importer
 * owns no checked-in destination files; callers choose an explicit output dir.
 */
-const emitTemplateReferencePacket = (packet) => [
-	{
-		kind: "source",
-		relativePath: "preset.tsx",
-		contents: packet.preset.source
-	},
-	jsonProjection("catalog", {
-		id: packet.preset.id,
-		channel: packet.preset.channel,
-		category: packet.preset.category,
-		name: packet.preset.name,
-		description: packet.preset.description,
-		variables: packet.preset.variables
-	}),
-	jsonProjection("gallery", {
-		presetId: packet.preset.id,
-		...packet.gallery,
-		provenance: packet.provenance
-	}),
-	jsonProjection("preview", packet.preview),
-	jsonProjection("editorial", {
-		cardTitle: packet.publicMetadata.cardTitle,
-		cardDescription: packet.publicMetadata.cardDescription,
-		guidance: packet.publicMetadata.guidance,
-		variables: packet.publicMetadata.variableDescriptions,
-		seo: packet.publicMetadata.seo
-	})
-];
+const emitTemplateReferencePacket = (packet) => {
+	const project = packet.preset.project;
+	if (project !== void 0 && (!isSafePublicTemplateProject(project) || project.files.find((file) => file.path === project.entryPath)?.content !== packet.preset.source)) throw new Error("Invalid public template project");
+	if (packet.provenance.source === "brand-recreation" && !isValidTemplateBrandRecreation(packet.provenance.brandRecreation, project)) throw new Error("Invalid public template brand recreation attribution");
+	return [
+		...project === void 0 ? [] : [jsonProjection("project", {
+			...project,
+			files: [...project.files].sort((a, b) => a.path.localeCompare(b.path))
+		}), ...[...project.files].sort((a, b) => a.path.localeCompare(b.path)).map((file) => ({
+			kind: "project-file",
+			relativePath: `project/${file.path}`,
+			contents: file.content,
+			encoding: file.encoding
+		}))],
+		{
+			kind: "source",
+			relativePath: "preset.tsx",
+			contents: packet.preset.source
+		},
+		jsonProjection("catalog", {
+			id: packet.preset.id,
+			channel: packet.preset.channel,
+			category: packet.preset.category,
+			name: packet.preset.name,
+			description: packet.preset.description,
+			variables: packet.preset.variables
+		}),
+		jsonProjection("gallery", {
+			presetId: packet.preset.id,
+			...packet.gallery,
+			provenance: packet.provenance
+		}),
+		jsonProjection("preview", packet.preview),
+		jsonProjection("editorial", {
+			cardTitle: packet.publicMetadata.cardTitle,
+			cardDescription: packet.publicMetadata.cardDescription,
+			guidance: packet.publicMetadata.guidance,
+			variables: packet.publicMetadata.variableDescriptions,
+			seo: packet.publicMetadata.seo
+		})
+	];
+};
 /**
 * Validates metadata and TSX syntax, never executing the template. The Vite importer
 * verifies schema, fixtures and rendered content before writing projections.
@@ -223,6 +290,9 @@ const validatePublicTemplateHandoff = (artifacts) => {
 		if (existingSlugs.has(artifact.gallery.slug) || suppliedSlugs.has(artifact.gallery.slug)) issues.push(issue(id, "duplicate-slug", `canonical slug "${artifact.gallery.slug}" is already present`));
 		suppliedIds.add(id);
 		suppliedSlugs.add(artifact.gallery.slug);
+		const project = artifact.preset.project;
+		if (project !== void 0 && (!isSafePublicTemplateProject(project) || project.files.find((file) => file.path === project.entryPath)?.content !== artifact.preset.source)) issues.push(issue(id, "source", "project must contain safe bounded unique files and the matching UTF-8 entry source"));
+		if (artifact.provenance?.source === "brand-recreation" && !isValidTemplateBrandRecreation(artifact.provenance.brandRecreation, project)) issues.push(issue(id, "provenance", "brand recreations require a complete project, a referenced brand, and its email subject"));
 		if (parsePublicTemplateSource(artifact.preset.source) === void 0) issues.push(issue(id, "source", "source must be a bounded TSX module with a default export; execution is verified by the importer"));
 		if (artifact.preset.channel !== "email") issues.push(issue(id, "channel", "public template source must be an executable email"));
 		if (new Set(artifact.preset.variables).size !== artifact.preset.variables.length || artifact.preset.variables.some((value) => !nonEmpty(value))) issues.push(issue(id, "variables", "declared input fields must be non-empty and unique"));
@@ -230,13 +300,13 @@ const validatePublicTemplateHandoff = (artifacts) => {
 		if (unsupportedFontTokens.length > 0) issues.push(issue(id, "font-token", `unsupported public font token: ${unsupportedFontTokens.join(", ")}`));
 		const sampleVariables = Object.keys(artifact.preview.sampleData);
 		if (!sameStrings(sampleVariables, artifact.preset.variables)) issues.push(issue(id, "sample-data", "sample data must cover every declared variable exactly"));
-		if (Object.values(artifact.preview.sampleData).some((value) => !nonEmpty(value))) issues.push(issue(id, "sample-data", "sample data values must be non-empty"));
+		if (Object.values(artifact.preview.sampleData).some((value) => !nonEmptySample(value))) issues.push(issue(id, "sample-data", "sample data values must be non-empty"));
 		const assetVariables = artifact.preview.assets.map((asset) => asset.variable);
 		if (new Set(assetVariables).size !== assetVariables.length) issues.push(issue(id, "assets", "asset variable references must be unique"));
 		for (const asset of artifact.preview.assets) {
 			const value = artifact.preview.sampleData[asset.variable];
 			if (!artifact.preset.variables.includes(asset.variable)) issues.push(issue(id, "assets", `asset "${asset.variable}" is not a declared preset variable`));
-			if (value === void 0 || !isSafePublicTemplateAsset(value)) issues.push(issue(id, "assets", `asset "${asset.variable}" must reference a bounded HTTPS, /templates/assets, or data:image sample URL`));
+			if (typeof value !== "string" || !isSafePublicTemplateAsset(value)) issues.push(issue(id, "assets", `asset "${asset.variable}" must reference a bounded HTTPS, /templates/assets, or data:image sample URL`));
 		}
 		const metadata = artifact.publicMetadata;
 		const metadataStrings = [
@@ -275,6 +345,7 @@ const validatePublicTemplateHandoff = (artifacts) => {
 				variables: artifact.preset.variables
 			},
 			source: artifact.preset.source,
+			...artifact.preset.project === void 0 ? {} : { project: artifact.preset.project },
 			gallery: reference.gallery,
 			preview: artifact.preview,
 			publicMetadata: artifact.publicMetadata,
@@ -283,6 +354,6 @@ const validatePublicTemplateHandoff = (artifacts) => {
 	}));
 };
 //#endregion
-export { PUBLIC_TEMPLATE_SOURCE_MAX_CHARACTERS, emitTemplateReferencePacket, isSafePublicTemplateAsset, publicTemplateAuthoredStructure, toTemplateReferencePacket, unsupportedPublicTemplateFontTokens, validatePublicTemplateHandoff };
+export { PUBLIC_TEMPLATE_PROJECT_FILE_MAX_BYTES, PUBLIC_TEMPLATE_PROJECT_MAX_BYTES, PUBLIC_TEMPLATE_PROJECT_MAX_FILES, PUBLIC_TEMPLATE_SOURCE_MAX_CHARACTERS, emitTemplateReferencePacket, isSafePublicTemplateAsset, isSafePublicTemplateProject, isSafePublicTemplateProjectPath, isValidTemplateBrandRecreation, publicTemplateAuthoredStructure, publicTemplateProjectDigest, toTemplateReferencePacket, unsupportedPublicTemplateFontTokens, validatePublicTemplateHandoff };
 
 //# sourceMappingURL=public-handoff.js.map

package/dist/presets/public-preview-artifacts.js

@@ -1,7 +1,7 @@
 import { presetCatalog } from "../presets.js";
 import { registerPublicCorpusEntry } from "./corpus.js";
 import { publicTemplates } from "./public-gallery.js";
-import { presetEmailFixtures, presetModuleSource } from "./sources.js";
+import { presetEmailAssets, presetEmailFixtures, presetModuleSource } from "./sources.js";
 import { publicTemplatePreviews } from "./public-preview.js";
 import { Result } from "effect";
 //#region presets/public-preview-artifacts.ts
@@ -63,14 +63,14 @@ const buildPublicTemplatePreviewArtifact = (template) => {
 		message: "canonical preset source is missing"
 	});
 	const sampleData = fixture.input;
-	const assets = [];
+	const assets = new Set(presetEmailAssets[template.presetId]);
 	for (const asset of preview.assets) {
 		const value = sampleData[asset.variable];
-		if (value === void 0) return Result.fail({
+		if (typeof value !== "string") return Result.fail({
 			presetId: template.presetId,
-			message: `sample data is missing asset: ${asset.variable}`
+			message: `sample data is missing a string asset: ${asset.variable}`
 		});
-		assets.push(value);
+		assets.add(value);
 	}
 	return Result.succeed({
 		presetId: template.presetId,
@@ -80,7 +80,7 @@ const buildPublicTemplatePreviewArtifact = (template) => {
 		quality: preview.quality,
 		source,
 		html: fixture.html,
-		assets,
+		assets: [...assets],
 		renders: renderInputs(template.slug, fixture.html)
 	});
 };

package/dist/presets/public-preview.d.ts

@@ -1,10 +1,14 @@
 //#region presets/public-preview.d.ts
 type PreviewQuality = "ready" | "asset-free";
+/** A declared fixture value: JSON, so a template can take a list of stories as well as a string. */
+type PreviewSampleValue = string | number | boolean | null | ReadonlyArray<PreviewSampleValue> | {
+  readonly [key: string]: PreviewSampleValue;
+};
 interface PublicTemplatePreview {
   readonly subject: string;
   readonly preheader: string;
   readonly quality: PreviewQuality;
-  readonly sampleData: Readonly<Record<string, string>>;
+  readonly sampleData: Readonly<Record<string, PreviewSampleValue>>;
   readonly assets: ReadonlyArray<{
     readonly variable: string;
     readonly kind: "image" | "logo";
@@ -12,6 +16,11 @@ interface PublicTemplatePreview {
 }
 /** Gallery metadata augments the actual default fixture; it does not supply render input. */
 declare const publicTemplatePreviews: {
+  readonly "linear-login-code": PublicTemplatePreview;
+  readonly "product-newsletter": PublicTemplatePreview;
+  readonly "order-receipt": PublicTemplatePreview;
+  readonly "vercel-invitation": PublicTemplatePreview;
+  readonly "product-launch-promo": PublicTemplatePreview;
   readonly welcome: PublicTemplatePreview;
   readonly "email-verification": PublicTemplatePreview;
   readonly otp: PublicTemplatePreview;
@@ -52,5 +61,5 @@ declare const publicTemplatePreviews: {
   readonly "season-clearance-promo": PublicTemplatePreview;
 };
 //#endregion
-export { PreviewQuality, PublicTemplatePreview, publicTemplatePreviews };
+export { PreviewQuality, PreviewSampleValue, PublicTemplatePreview, publicTemplatePreviews };
 //# sourceMappingURL=public-preview.d.ts.map

package/dist/presets/public-preview.js

@@ -13,6 +13,20 @@ const preview = (id, quality, assets) => {
 };
 /** Gallery metadata augments the actual default fixture; it does not supply render input. */
 const publicTemplatePreviews = {
+	"linear-login-code": preview("linear-login-code", "ready", []),
+	"product-newsletter": preview("product-newsletter", "ready", [{
+		variable: "leadImage",
+		kind: "image"
+	}]),
+	"order-receipt": preview("order-receipt", "ready", []),
+	"vercel-invitation": preview("vercel-invitation", "ready", [{
+		variable: "userImage",
+		kind: "image"
+	}, {
+		variable: "teamImage",
+		kind: "image"
+	}]),
+	"product-launch-promo": preview("product-launch-promo", "ready", []),
 	welcome: preview("welcome", "ready", [{
 		variable: "logoUrl",
 		kind: "logo"

package/dist/presets/sources.d.ts

@@ -1,20 +1,38 @@
 //#region presets/sources.gen.d.ts
+/** A declared fixture value: JSON, so a template can take a list of stories as well as a string. */
+type PresetEmailFixtureValue = string | number | boolean | null | ReadonlyArray<PresetEmailFixtureValue> | {
+  readonly [key: string]: PresetEmailFixtureValue;
+};
 interface PresetEmailFixture {
-  readonly input: Readonly<Record<string, string>>;
+  readonly input: Readonly<Record<string, PresetEmailFixtureValue>>;
   readonly subject: string;
   readonly preheader: string;
   readonly html: string;
   readonly text: string;
 }
+interface PresetProjectFile {
+  readonly path: string;
+  readonly content: string;
+  readonly encoding: "utf8" | "base64";
+}
+interface PresetProject {
+  readonly entryPath: string;
+  readonly files: ReadonlyArray<PresetProjectFile>;
+  readonly digest: string;
+}
+/** Complete editable projects, including styles and assets. */
+declare const presetProjects: Readonly<Record<string, PresetProject>>;
+declare const presetProject: (id: string) => PresetProject | undefined;
+declare const presetEmailAssets: Readonly<Record<string, ReadonlyArray<string>>>;
 /** Canonical TSX entry source, loaded on demand by authoring surfaces. */
 declare const presetModuleSources: Readonly<Record<string, string>>;
 declare const presetModuleDigests: Readonly<Record<string, string>>;
-declare const presetModuleManifestDigest = "8c97d809a3ff8d6b1bf49a90ce0275aa98882fc733cc3ed9638e2c38dd78f0fc";
+declare const presetModuleManifestDigest = "b2b55659bcb164b0b0269010d7644aabd17b9b2cae1bcdbaad6e6cfee303945a";
 /** SML belongs only to the gated SMS and WhatsApp template compilers. */
 declare const structuredPresetSources: Readonly<Record<string, string>>;
 /** Gallery snapshots generated by executing each declared fixture with actual input. */
 declare const presetEmailFixtures: Readonly<Record<string, Readonly<Record<string, PresetEmailFixture>>>>;
 declare const presetModuleSource: (id: string) => string | undefined;
 //#endregion
-export { PresetEmailFixture, presetEmailFixtures, presetModuleDigests, presetModuleManifestDigest, presetModuleSource, presetModuleSources, structuredPresetSources };
+export { PresetEmailFixture, PresetEmailFixtureValue, PresetProject, PresetProjectFile, presetEmailAssets, presetEmailFixtures, presetModuleDigests, presetModuleManifestDigest, presetModuleSource, presetModuleSources, presetProject, presetProjects, structuredPresetSources };
 //# sourceMappingURL=sources.d.ts.map