@samva/markup 0.1.1 → 0.2.0

package/dist/presets/public-gallery.js

@@ -1,3 +1,5 @@
+import { matchesTemplateFacets, registerPublicCorpusEntry } from "./corpus.js";
+import { Result } from "effect";
 //#region presets/public-gallery.ts
 const templateUseCases = [
 	"account-access",
@@ -12,10 +14,304 @@ const templateCollectionFamilies = [
 	"stage",
 	"style"
 ];
-const template = (value) => ({
-	...value,
-	path: `/templates/${value.slug}`
-});
+const isMadeWithSamvaTemplate = (template) => template.corpus._tag === "OwnedEditablePreset";
+/** 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-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."
+	},
+	"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."
+	}
+};
+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 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 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: ["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",
@@ -518,6 +814,10 @@ const publicTemplates = [
 		relatedTemplates: ["promo", "announcement"]
 	})
 ];
+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(":");
@@ -558,6 +858,6 @@ const publicTemplateGallery = {
 	collections: templateCollections
 };
 //#endregion
-export { 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,9 +1,17 @@
-import { d as Channel } from "../ast-DAhnAvQN.js";
+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 { Result } from "effect";
 //#region presets/public-handoff.d.ts
+/** Where an approved public artifact came from. */
+interface TemplateReferenceProvenance {
+  readonly source: "samva-owned" | "sanitized-synthetic" | "reviewed-public";
+  /** 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";
@@ -37,6 +45,21 @@ interface ApprovedPublicTemplateArtifact {
       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">;
@@ -49,14 +72,63 @@ interface ValidatedPublicTemplateArtifact {
   readonly approval: ApprovedPublicTemplateArtifact["approval"] & {
     readonly state: "approved";
   };
+  readonly reference: TemplateReferencePacket;
 }
-type PublicHandoffIssueCode = "approval" | "identity" | "duplicate-id" | "duplicate-slug" | "source" | "channel" | "variables" | "sample-data" | "assets" | "public-metadata" | "reference";
+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;
+/** 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: "catalog" | "gallery" | "preview" | "editorial";
+  readonly relativePath: `${"catalog" | "gallery" | "preview" | "editorial"}.json`;
+  readonly contents: string;
+};
+/**
+ * Emits the five destination projections 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
@@ -64,5 +136,5 @@ interface PublicHandoffIssue {
  */
 declare const validatePublicTemplateHandoff: (artifacts: ReadonlyArray<ApprovedPublicTemplateArtifact>) => Result.Result<ReadonlyArray<ValidatedPublicTemplateArtifact>, ReadonlyArray<PublicHandoffIssue>>;
 //#endregion
-export { ApprovedPublicTemplateArtifact, PublicHandoffIssue, PublicHandoffIssueCode, ValidatedPublicTemplateArtifact, validatePublicTemplateHandoff };
+export { ApprovedPublicTemplateArtifact, PUBLIC_TEMPLATE_SOURCE_MAX_CHARACTERS, PublicHandoffIssue, PublicHandoffIssueCode, PublicTemplateAuthoredStructure, TemplateReferencePacket, TemplateReferenceProjection, TemplateReferenceProvenance, ValidatedPublicTemplateArtifact, emitTemplateReferencePacket, isSafePublicTemplateAsset, publicTemplateAuthoredStructure, toTemplateReferencePacket, unsupportedPublicTemplateFontTokens, validatePublicTemplateHandoff };
 //# sourceMappingURL=public-handoff.d.ts.map