@samva/markup 0.1.2 → 0.3.0

package/dist/presets/public-gallery.js

@@ -1,3 +1,5 @@
+import { brandRecreationProvenance, matchesTemplateFacets, registerPublicCorpusEntry } from "./corpus.js";
+import { Result } from "effect";
 //#region presets/public-gallery.ts
 const templateUseCases = [
 	"account-access",
@@ -12,11 +14,352 @@ const templateCollectionFamilies = [
 	"stage",
 	"style"
 ];
-const isMadeWithSamvaTemplate = (template) => template.provenance !== void 0;
-const template = (value) => ({
-	...value,
-	path: `/templates/${value.slug}`
-});
+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: {
+		sourcePath: "packages/markup/presets/welcome.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed welcome editable SML, public preview data, and gallery identity."
+	},
+	"email-verification": {
+		sourcePath: "packages/markup/presets/email-verification.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed email-verification editable SML, public preview data, and gallery identity."
+	},
+	otp: {
+		sourcePath: "packages/markup/presets/otp.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed otp editable SML, public preview data, and gallery identity."
+	},
+	"password-reset": {
+		sourcePath: "packages/markup/presets/password-reset.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed password-reset editable SML, public preview data, and gallery identity."
+	},
+	receipt: {
+		sourcePath: "packages/markup/presets/receipt.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed receipt editable SML, public preview data, and gallery identity."
+	},
+	"payment-failed": {
+		sourcePath: "packages/markup/presets/payment-failed.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed payment-failed editable SML, public preview data, and gallery identity."
+	},
+	"shipping-update": {
+		sourcePath: "packages/markup/presets/shipping-update.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed shipping-update editable SML, public preview data, and gallery identity."
+	},
+	notification: {
+		sourcePath: "packages/markup/presets/notification.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed notification editable SML, public preview data, and gallery identity."
+	},
+	"team-invite": {
+		sourcePath: "packages/markup/presets/team-invite.tsx",
+		reviewedBy: "Samva catalog review",
+		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",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed product-digest editable SML, public preview data, and gallery identity."
+	},
+	newsletter: {
+		sourcePath: "packages/markup/presets/newsletter.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed newsletter editable SML, public preview data, and gallery identity."
+	},
+	announcement: {
+		sourcePath: "packages/markup/presets/announcement.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed announcement editable SML, public preview data, and gallery identity."
+	},
+	promo: {
+		sourcePath: "packages/markup/presets/promo.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed promo editable SML, public preview data, and gallery identity."
+	},
+	"event-invite": {
+		sourcePath: "packages/markup/presets/event-invite.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed event-invite editable SML, public preview data, and gallery identity."
+	},
+	"membership-promo": {
+		sourcePath: "packages/markup/presets/membership-promo.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed membership-promo editable SML, public preview data, and gallery identity."
+	},
+	"onboarding-step": {
+		sourcePath: "packages/markup/presets/onboarding-step.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed onboarding-step editable SML, public preview data, and gallery identity."
+	},
+	"trial-ending": {
+		sourcePath: "packages/markup/presets/trial-ending.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed trial-ending editable SML, public preview data, and gallery identity."
+	},
+	"win-back": {
+		sourcePath: "packages/markup/presets/win-back.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed win-back editable SML, public preview data, and gallery identity."
+	},
+	"feedback-request": {
+		sourcePath: "packages/markup/presets/feedback-request.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed feedback-request editable SML, public preview data, and gallery identity."
+	},
+	"editorial-newsletter": {
+		sourcePath: "packages/markup/presets/editorial-newsletter.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed editorial-newsletter editable SML, public preview data, and gallery identity."
+	},
+	"member-referral-offer": {
+		sourcePath: "packages/markup/presets/member-referral-offer.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed member-referral-offer editable SML, public preview data, and gallery identity."
+	},
+	"catalog-sale-newsletter": {
+		sourcePath: "packages/markup/presets/catalog-sale-newsletter.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed catalog-sale-newsletter editable SML, public preview data, and gallery identity."
+	},
+	"limited-time-savings": {
+		sourcePath: "packages/markup/presets/limited-time-savings.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed limited-time-savings editable SML, public preview data, and gallery identity."
+	},
+	"rewards-milestone": {
+		sourcePath: "packages/markup/presets/rewards-milestone.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed rewards-milestone editable SML, public preview data, and gallery identity."
+	},
+	"order-delivered": {
+		sourcePath: "packages/markup/presets/order-delivered.tsx",
+		reviewedBy: "Samva catalog review",
+		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",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed travel-rewards-promo editable SML, public preview data, and gallery identity."
+	},
+	"events-roundup": {
+		sourcePath: "packages/markup/presets/events-roundup.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed events-roundup editable SML, public preview data, and gallery identity."
+	},
+	"product-onboarding-tour": {
+		sourcePath: "packages/markup/presets/product-onboarding-tour.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed product-onboarding-tour editable SML, public preview data, and gallery identity."
+	},
+	"product-updates-roundup": {
+		sourcePath: "packages/markup/presets/product-updates-roundup.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed product-updates-roundup editable SML, public preview data, and gallery identity."
+	},
+	"flash-getaway-offer": {
+		sourcePath: "packages/markup/presets/flash-getaway-offer.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed flash-getaway-offer editable SML, public preview data, and gallery identity."
+	},
+	"membership-benefits-promo": {
+		sourcePath: "packages/markup/presets/membership-benefits-promo.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed membership-benefits-promo editable SML, public preview data, and gallery identity."
+	},
+	"industry-news-digest": {
+		sourcePath: "packages/markup/presets/industry-news-digest.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed industry-news-digest editable SML, public preview data, and gallery identity."
+	},
+	"weekly-deals-circular": {
+		sourcePath: "packages/markup/presets/weekly-deals-circular.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed weekly-deals-circular editable SML, public preview data, and gallery identity."
+	},
+	"data-sharing-review": {
+		sourcePath: "packages/markup/presets/data-sharing-review.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed data-sharing-review editable SML, public preview data, and gallery identity."
+	},
+	"seasonal-sale-flyer": {
+		sourcePath: "packages/markup/presets/seasonal-sale-flyer.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed seasonal-sale-flyer editable SML, public preview data, and gallery identity."
+	},
+	"setup-checklist": {
+		sourcePath: "packages/markup/presets/setup-checklist.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed setup-checklist editable SML, public preview data, and gallery identity."
+	},
+	"feature-release-roundup": {
+		sourcePath: "packages/markup/presets/feature-release-roundup.tsx",
+		reviewedBy: "Samva catalog review",
+		reviewedAt: "2026-08-31T00:00:00.000Z",
+		notes: "Reviewed feature-release-roundup editable SML, public preview data, and gallery identity."
+	},
+	"season-clearance-promo": {
+		sourcePath: "packages/markup/presets/season-clearance-promo.tsx",
+		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"];
+		case "commerce": return ["customers", "shoppers"];
+		case "lifecycle": return ["product-users", "customers"];
+		case "product-communication": return ["product-users", "teams"];
+		case "publishing-campaigns": return [
+			"customers",
+			"members",
+			"readers"
+		];
+	}
+};
+const facetValues = (collections, prefix) => collections.filter((id) => id.startsWith(`${prefix}:`)).map((id) => id.slice(prefix.length + 1));
+const template = (value) => {
+	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"),
+		industry: facetValues(value.collections, "industry"),
+		season: value.presetId === "seasonal-sale-flyer" || value.presetId === "season-clearance-promo" ? ["seasonal"] : ["evergreen"],
+		audience: audienceFor(value.useCase),
+		design: facetValues(value.collections, "style"),
+		brandProvenance: [corpus._tag === "BrandRecreationPreset" ? "third-party-reference" : "samva-original"]
+	};
+	const registration = registerPublicCorpusEntry({
+		id: value.presetId,
+		corpus,
+		facets
+	});
+	if (Result.isFailure(registration)) throw new Error(`${registration.failure.id}: ${registration.failure.message}`);
+	return {
+		...value,
+		path: `/templates/${value.slug}`,
+		corpus,
+		facets: registration.success.facets
+	};
+};
 const publicTemplates = [
 	template({
 		presetId: "welcome",
@@ -349,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",
@@ -517,8 +878,69 @@ 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);
+if (new Set(publicTemplateIds).size !== publicTemplateIds.length) throw new Error("public template registry ids must be unique");
+/** Deterministic strict-intersection search over the canonical public corpus order. */
+const filterPublicTemplatesByFacets = (query) => publicTemplates.filter((item) => matchesTemplateFacets(item.facets, query));
 const members = (id) => publicTemplates.filter((item) => item.collections.some((collectionId) => collectionId === id)).map((item) => item.presetId);
 const collection = (id, relatedCollections = []) => {
 	const [family, slug] = id.split(":");
@@ -559,6 +981,6 @@ const publicTemplateGallery = {
 	collections: templateCollections
 };
 //#endregion
-export { isMadeWithSamvaTemplate, publicTemplateGallery, publicTemplates, templateCollectionFamilies, templateCollections, templateUseCases };
+export { filterPublicTemplatesByFacets, isMadeWithSamvaTemplate, ownedPresetReviewManifest, publicTemplateGallery, publicTemplates, templateCollectionFamilies, templateCollections, templateUseCases };
 
 //# sourceMappingURL=public-gallery.js.map

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

@@ -1,2 +1,164 @@
-import { C as validatePublicTemplateHandoff, S as unsupportedPublicTemplateFontTokens, _ as TemplateReferenceProvenance, b as isSafePublicTemplateAsset, f as ApprovedPublicTemplateArtifact, g as TemplateReferenceProjection, h as TemplateReferencePacket, m as PublicHandoffIssueCode, p as PublicHandoffIssue, v as ValidatedPublicTemplateArtifact, x as toTemplateReferencePacket, y as emitTemplateReferencePacket } from "../public-gallery-D0Zv0pZE.js";
-export { ApprovedPublicTemplateArtifact, PublicHandoffIssue, PublicHandoffIssueCode, TemplateReferencePacket, TemplateReferenceProjection, TemplateReferenceProvenance, ValidatedPublicTemplateArtifact, emitTemplateReferencePacket, isSafePublicTemplateAsset, toTemplateReferencePacket, unsupportedPublicTemplateFontTokens, validatePublicTemplateHandoff };
+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" | "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. */
+  readonly recordedAt: string;
+}
+interface ApprovedPublicTemplateArtifact {
+  readonly approval: {
+    readonly state: "draft" | "approved" | "rejected";
+    readonly approvedBy: string;
+    /** Stable ISO-8601 timestamp supplied by the owner. */
+    readonly approvedAt: string;
+  };
+  readonly preset: {
+    readonly id: string;
+    readonly channel: Channel;
+    readonly category: PresetCategory;
+    readonly name: string;
+    readonly description: string;
+    readonly variables: ReadonlyArray<string>;
+    readonly source: string;
+    readonly project?: PresetProject;
+  };
+  readonly gallery: {
+    readonly slug: string;
+    readonly useCase: TemplateUseCase;
+    readonly collections: ReadonlyArray<TemplateCollectionId>;
+    readonly relatedTemplates: ReadonlyArray<string>;
+  };
+  readonly preview: PublicTemplatePreview;
+  readonly publicMetadata: {
+    readonly cardTitle: string;
+    readonly cardDescription: string;
+    readonly guidance: ReadonlyArray<string>;
+    readonly variableDescriptions: Readonly<Record<string, string>>;
+    readonly seo: {
+      readonly title: string;
+      readonly description: string;
+    };
+  };
+  readonly provenance: TemplateReferenceProvenance;
+}
+/**
+ * A destination-neutral template packet. Gallery and agent callers can use
+ * this shape without depending on a Lab corpus or a particular import source.
+ */
+interface TemplateReferencePacket {
+  readonly version: 1;
+  readonly preset: ApprovedPublicTemplateArtifact["preset"];
+  readonly gallery: ApprovedPublicTemplateArtifact["gallery"] & {
+    readonly path: `/templates/${string}`;
+  };
+  readonly preview: ApprovedPublicTemplateArtifact["preview"];
+  readonly publicMetadata: ApprovedPublicTemplateArtifact["publicMetadata"];
+  readonly provenance: TemplateReferenceProvenance;
+}
+interface ValidatedPublicTemplateArtifact {
+  readonly preset: Omit<ApprovedPublicTemplateArtifact["preset"], "source" | "project">;
+  readonly source: string;
+  readonly project?: PresetProject;
+  readonly gallery: ApprovedPublicTemplateArtifact["gallery"] & {
+    readonly path: `/templates/${string}`;
+  };
+  readonly preview: ApprovedPublicTemplateArtifact["preview"];
+  readonly publicMetadata: ApprovedPublicTemplateArtifact["publicMetadata"];
+  readonly approval: ApprovedPublicTemplateArtifact["approval"] & {
+    readonly state: "approved";
+  };
+  readonly reference: TemplateReferencePacket;
+}
+type PublicHandoffIssueCode = "approval" | "identity" | "duplicate-id" | "duplicate-slug" | "source" | "font-token" | "channel" | "variables" | "sample-data" | "assets" | "public-metadata" | "provenance" | "reference";
+interface PublicHandoffIssue {
+  readonly artifactId: string;
+  readonly code: PublicHandoffIssueCode;
+  readonly message: string;
+}
+/** 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";
+  readonly nodes: ReadonlyArray<{
+    readonly tag: string;
+    readonly depth: number;
+    readonly childIndex: number;
+  }>;
+  readonly components: ReadonlyArray<{
+    readonly tag: string;
+    readonly count: number;
+  }>;
+  readonly palette: ReadonlyArray<string>;
+}
+/** Only generic element names and literal class colors survive deidentification. */
+declare const publicTemplateAuthoredStructure: (source: string) => PublicTemplateAuthoredStructure | undefined;
+/**
+ * Public imports may only refer to the default email Tailwind font-family tokens. A source may
+ * still use the supported `font-*` weight utilities; this check deliberately
+ * rejects a new family token instead of creating a corpus font-hosting path.
+ */
+declare const unsupportedPublicTemplateFontTokens: (source: string) => ReadonlyArray<string>;
+/**
+ * Accept bounded HTTPS URLs, same-origin gallery files under `/templates/assets/`,
+ * or the preview's self-contained image data. Live Unsplash, placehold, and
+ * assets.example hosts are never safe for public sample data.
+ */
+declare const isSafePublicTemplateAsset: (value: string) => boolean;
+/** Normalizes one approved handoff for gallery and future agent consumers. */
+declare const toTemplateReferencePacket: (artifact: ApprovedPublicTemplateArtifact) => TemplateReferencePacket;
+type TemplateReferenceProjection = {
+  readonly kind: "source";
+  readonly relativePath: "preset.tsx";
+  readonly contents: string;
+} | {
+  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 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>;
+/**
+ * Validates metadata and TSX syntax, never executing the template. The Vite importer
+ * verifies schema, fixtures and rendered content before writing projections.
+ * Validates explicitly supplied, owner-approved artifacts without filesystem,
+ * network, persistence, or discovery. Successful output is a projection for
+ * the existing preset, public-gallery, preview, and editorial contracts; this
+ * function never registers or publishes it.
+ */
+declare const validatePublicTemplateHandoff: (artifacts: ReadonlyArray<ApprovedPublicTemplateArtifact>) => Result.Result<ReadonlyArray<ValidatedPublicTemplateArtifact>, ReadonlyArray<PublicHandoffIssue>>;
+//#endregion
+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