@samva/markup 0.6.0 → 0.8.0

package/dist/{presets → starters}/public-handoff.d.ts

@@ -1,10 +1,10 @@
 import { l as Channel } from "../ast-BrDtApwS.js";
-import { r as PresetCategory } from "../catalog-60eaYC7b.js";
+import { r as StarterCategory } from "../catalog-CKuOooB8.js";
 import { TemplateCollectionId, TemplateUseCase } from "./public-gallery.js";
 import { PublicTemplatePreview } from "./public-preview.js";
-import { PresetProject } from "./sources.js";
+import { StarterProject } from "./sources.js";
 import { Result } from "better-result";
-//#region presets/public-handoff.d.ts
+//#region starters/public-handoff.d.ts
 /** The brand a clean-room recreation names, and what its email does. */
 interface TemplateBrandRecreation {
   readonly brand: string;
@@ -26,15 +26,15 @@ interface ApprovedPublicTemplateArtifact {
     /** Stable ISO-8601 timestamp supplied by the owner. */
     readonly approvedAt: string;
   };
-  readonly preset: {
+  readonly starter: {
     readonly id: string;
     readonly channel: Channel;
-    readonly category: PresetCategory;
+    readonly category: StarterCategory;
     readonly name: string;
     readonly description: string;
     readonly variables: ReadonlyArray<string>;
     readonly source: string;
-    readonly project?: PresetProject;
+    readonly project?: StarterProject;
   };
   readonly gallery: {
     readonly slug: string;
@@ -61,7 +61,7 @@ interface ApprovedPublicTemplateArtifact {
  */
 interface TemplateReferencePacket {
   readonly version: 1;
-  readonly preset: ApprovedPublicTemplateArtifact["preset"];
+  readonly starter: ApprovedPublicTemplateArtifact["starter"];
   readonly gallery: ApprovedPublicTemplateArtifact["gallery"] & {
     readonly path: `/templates/${string}`;
   };
@@ -70,9 +70,9 @@ interface TemplateReferencePacket {
   readonly provenance: TemplateReferenceProvenance;
 }
 interface ValidatedPublicTemplateArtifact {
-  readonly preset: Omit<ApprovedPublicTemplateArtifact["preset"], "source" | "project">;
+  readonly starter: Omit<ApprovedPublicTemplateArtifact["starter"], "source" | "project">;
   readonly source: string;
-  readonly project?: PresetProject;
+  readonly project?: StarterProject;
   readonly gallery: ApprovedPublicTemplateArtifact["gallery"] & {
     readonly path: `/templates/${string}`;
   };
@@ -97,10 +97,10 @@ 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;
+declare const isSafePublicTemplateProject: (project: StarterProject) => 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;
+declare const publicTemplateProjectDigest: (project: Pick<StarterProject, "entryPath" | "files">) => Promise<string>;
+declare const isValidTemplateBrandRecreation: (brandRecreation: TemplateBrandRecreation | undefined, project: StarterProject | undefined) => boolean;
 /** Static syntax inventory; loops, branches and component expansion are not evaluated. */
 interface PublicTemplateAuthoredStructure {
   readonly basis: "authored-jsx";
@@ -133,7 +133,7 @@ declare const isSafePublicTemplateAsset: (value: string) => boolean;
 declare const toTemplateReferencePacket: (artifact: ApprovedPublicTemplateArtifact) => TemplateReferencePacket;
 type TemplateReferenceProjection = {
   readonly kind: "source";
-  readonly relativePath: "preset.tsx";
+  readonly relativePath: "starter.tsx";
   readonly contents: string;
 } | {
   readonly kind: "project-file";
@@ -155,7 +155,7 @@ declare const emitTemplateReferencePacket: (packet: TemplateReferencePacket) =>
  * 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
+ * the existing starter, public-gallery, preview, and editorial contracts; this
  * function never registers or publishes it.
  */
 declare const validatePublicTemplateHandoff: (artifacts: ReadonlyArray<ApprovedPublicTemplateArtifact>) => Result<ReadonlyArray<ValidatedPublicTemplateArtifact>, ReadonlyArray<PublicHandoffIssue>>;

package/dist/{presets → starters}/public-handoff.js

@@ -1,10 +1,10 @@
 import { n as isObject } from "../guards-eV1qLbf2.js";
 import { EMAIL_ELEMENTS } from "../email/elements.js";
-import { presetCatalog } from "../presets.js";
+import { starterCatalog } from "../starters.js";
 import { publicTemplates, templateCollections } from "./public-gallery.js";
 import { Result } from "better-result";
 import { parse } from "@babel/parser";
-//#region presets/public-handoff.ts
+//#region starters/public-handoff.ts
 const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const ISO_TIMESTAMP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/;
 const MAX_HTTPS_ASSET_LENGTH = 2048;
@@ -206,7 +206,7 @@ const isSafePublicTemplateAsset = (value) => {
 /** Normalizes one approved handoff for gallery and future agent consumers. */
 const toTemplateReferencePacket = (artifact) => ({
 	version: 1,
-	preset: artifact.preset,
+	starter: artifact.starter,
 	gallery: {
 		...artifact.gallery,
 		path: `/templates/${artifact.gallery.slug}`
@@ -225,8 +225,8 @@ const jsonProjection = (kind, value) => ({
 * owns no checked-in destination files; callers choose an explicit output dir.
 */
 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");
+	const project = packet.starter.project;
+	if (project !== void 0 && (!isSafePublicTemplateProject(project) || project.files.find((file) => file.path === project.entryPath)?.content !== packet.starter.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", {
@@ -240,19 +240,19 @@ const emitTemplateReferencePacket = (packet) => {
 		}))],
 		{
 			kind: "source",
-			relativePath: "preset.tsx",
-			contents: packet.preset.source
+			relativePath: "starter.tsx",
+			contents: packet.starter.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
+			id: packet.starter.id,
+			channel: packet.starter.channel,
+			category: packet.starter.category,
+			name: packet.starter.name,
+			description: packet.starter.description,
+			variables: packet.starter.variables
 		}),
 		jsonProjection("gallery", {
-			presetId: packet.preset.id,
+			starterId: packet.starter.id,
 			...packet.gallery,
 			provenance: packet.provenance
 		}),
@@ -271,35 +271,35 @@ const emitTemplateReferencePacket = (packet) => {
 * 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
+* the existing starter, public-gallery, preview, and editorial contracts; this
 * function never registers or publishes it.
 */
 const validatePublicTemplateHandoff = (artifacts) => {
 	const issues = [];
-	const existingIds = new Set(presetCatalog.map((preset) => preset.id));
+	const existingIds = new Set(starterCatalog.map((starter) => starter.id));
 	const existingSlugs = new Set(publicTemplates.map((template) => template.slug));
 	const suppliedIds = /* @__PURE__ */ new Set();
 	const suppliedSlugs = /* @__PURE__ */ new Set();
-	const allKnownIds = /* @__PURE__ */ new Set([...publicTemplates.map((template) => template.presetId), ...artifacts.map((artifact) => artifact.preset.id)]);
+	const allKnownIds = /* @__PURE__ */ new Set([...publicTemplates.map((template) => template.starterId), ...artifacts.map((artifact) => artifact.starter.id)]);
 	const knownCollections = new Set(templateCollections.map((collection) => collection.id));
 	for (const artifact of artifacts) {
-		const id = artifact.preset.id;
+		const id = artifact.starter.id;
 		if (artifact.approval.state !== "approved" || !nonEmpty(artifact.approval.approvedBy) || !ISO_TIMESTAMP.test(artifact.approval.approvedAt)) issues.push(issue(id, "approval", "owner approval and an ISO-8601 approval timestamp are required"));
 		if (artifact.provenance === void 0 || !isTemplateReferenceProvenanceSource(artifact.provenance.source) || !nonEmpty(artifact.provenance.referenceId) || !ISO_TIMESTAMP.test(artifact.provenance.recordedAt)) issues.push(issue(id, "provenance", "provenance requires a supported source, identifier, and ISO-8601 timestamp"));
-		if (!SLUG.test(id) || !SLUG.test(artifact.gallery.slug)) issues.push(issue(id, "identity", "preset id and canonical slug must be lowercase kebab-case"));
-		if (existingIds.has(id) || suppliedIds.has(id)) issues.push(issue(id, "duplicate-id", `preset id "${id}" is already present`));
+		if (!SLUG.test(id) || !SLUG.test(artifact.gallery.slug)) issues.push(issue(id, "identity", "starter id and canonical slug must be lowercase kebab-case"));
+		if (existingIds.has(id) || suppliedIds.has(id)) issues.push(issue(id, "duplicate-id", `starter id "${id}" is already present`));
 		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"));
+		const project = artifact.starter.project;
+		if (project !== void 0 && (!isSafePublicTemplateProject(project) || project.files.find((file) => file.path === project.entryPath)?.content !== artifact.starter.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"));
-		const unsupportedFontTokens = unsupportedPublicTemplateFontTokens(artifact.preset.source);
+		if (parsePublicTemplateSource(artifact.starter.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.starter.channel !== "email") issues.push(issue(id, "channel", "public template source must be an executable email"));
+		if (new Set(artifact.starter.variables).size !== artifact.starter.variables.length || artifact.starter.variables.some((value) => !nonEmpty(value))) issues.push(issue(id, "variables", "declared input fields must be non-empty and unique"));
+		const unsupportedFontTokens = unsupportedPublicTemplateFontTokens(artifact.starter.source);
 		if (unsupportedFontTokens.length > 0) issues.push(issue(id, "font-token", `unsupported public font token: ${unsupportedFontTokens.join(", ")}`));
-		const declaredVariables = new Set(artifact.preset.variables);
+		const declaredVariables = new Set(artifact.starter.variables);
 		const undeclaredSample = Object.keys(artifact.preview.sampleData).filter((variable) => !declaredVariables.has(variable));
 		if (undeclaredSample.length > 0) issues.push(issue(id, "sample-data", `sample data supplies undeclared variables: ${sortedUnique(undeclaredSample).join(", ")}`));
 		if (Object.values(artifact.preview.sampleData).some((value) => !nonEmptySample(value))) issues.push(issue(id, "sample-data", "sample data values must be non-empty"));
@@ -307,13 +307,13 @@ const validatePublicTemplateHandoff = (artifacts) => {
 		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 (!artifact.starter.variables.includes(asset.variable)) issues.push(issue(id, "assets", `asset "${asset.variable}" is not a declared starter variable`));
 			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 = [
-			artifact.preset.name,
-			artifact.preset.description,
+			artifact.starter.name,
+			artifact.starter.description,
 			artifact.preview.subject,
 			artifact.preview.preheader,
 			metadata.cardTitle,
@@ -324,7 +324,7 @@ const validatePublicTemplateHandoff = (artifacts) => {
 			...Object.values(metadata.variableDescriptions)
 		];
 		if (metadata.guidance.length === 0 || metadataStrings.some((value) => !nonEmpty(value))) issues.push(issue(id, "public-metadata", "public metadata fields must be non-empty"));
-		if (!sameStrings(Object.keys(metadata.variableDescriptions), artifact.preset.variables)) issues.push(issue(id, "public-metadata", "variable descriptions must cover every declared variable exactly"));
+		if (!sameStrings(Object.keys(metadata.variableDescriptions), artifact.starter.variables)) issues.push(issue(id, "public-metadata", "variable descriptions must cover every declared variable exactly"));
 		if (new Set(artifact.gallery.collections).size !== artifact.gallery.collections.length) issues.push(issue(id, "reference", "collection references must be unique"));
 		for (const collectionId of artifact.gallery.collections) if (!knownCollections.has(collectionId)) issues.push(issue(id, "reference", `collection "${collectionId}" is invalid`));
 		if (new Set(artifact.gallery.relatedTemplates).size !== artifact.gallery.relatedTemplates.length) issues.push(issue(id, "reference", "related template references must be unique"));
@@ -338,16 +338,16 @@ const validatePublicTemplateHandoff = (artifacts) => {
 				...artifact.approval,
 				state: "approved"
 			},
-			preset: {
-				id: artifact.preset.id,
-				channel: artifact.preset.channel,
-				category: artifact.preset.category,
-				name: artifact.preset.name,
-				description: artifact.preset.description,
-				variables: artifact.preset.variables
+			starter: {
+				id: artifact.starter.id,
+				channel: artifact.starter.channel,
+				category: artifact.starter.category,
+				name: artifact.starter.name,
+				description: artifact.starter.description,
+				variables: artifact.starter.variables
 			},
-			source: artifact.preset.source,
-			...artifact.preset.project === void 0 ? {} : { project: artifact.preset.project },
+			source: artifact.starter.source,
+			...artifact.starter.project === void 0 ? {} : { project: artifact.starter.project },
 			gallery: reference.gallery,
 			preview: artifact.preview,
 			publicMetadata: artifact.publicMetadata,

package/dist/{presets → starters}/public-preview-artifacts.d.ts

@@ -1,8 +1,8 @@
-import { t as EmailPresetId } from "../catalog-60eaYC7b.js";
+import { t as EmailStarterId } from "../catalog-CKuOooB8.js";
 import { PublicTemplate } from "./public-gallery.js";
 import { PreviewQuality } from "./public-preview.js";
 import { Result } from "better-result";
-//#region presets/public-preview-artifacts.d.ts
+//#region starters/public-preview-artifacts.d.ts
 type PreviewSurface = "card" | "detail" | "og";
 type PreviewViewport = "desktop" | "mobile";
 type PreviewColorScheme = "light" | "dark";
@@ -16,7 +16,7 @@ interface PublicTemplateRenderInput {
   readonly html: string;
 }
 interface PublicTemplatePreviewArtifact {
-  readonly presetId: EmailPresetId;
+  readonly starterId: EmailStarterId;
   readonly slug: string;
   readonly subject: string;
   readonly preheader: string;
@@ -29,7 +29,7 @@ interface PublicTemplatePreviewArtifact {
   readonly renders: ReadonlyArray<PublicTemplateRenderInput>;
 }
 interface PreviewArtifactBuildIssue {
-  readonly presetId: EmailPresetId;
+  readonly starterId: EmailStarterId;
   readonly message: string;
 }
 /** Build one static preview artifact without loading the editor runtime or performing I/O. */

package/dist/{presets → starters}/public-preview-artifacts.js

@@ -1,10 +1,10 @@
-import { presetCatalog } from "../presets.js";
+import { starterCatalog } from "../starters.js";
 import { registerPublicCorpusEntry } from "./corpus.js";
 import { publicTemplates } from "./public-gallery.js";
-import { presetEmailAssets, presetEmailFixtures, presetModuleSource } from "./sources.js";
+import { starterEmailAssets, starterEmailFixtures, starterModuleSource } from "./sources.js";
 import { publicTemplatePreviews } from "./public-preview.js";
 import { Result } from "better-result";
-//#region presets/public-preview-artifacts.ts
+//#region starters/public-preview-artifacts.ts
 const renderFrames = [
 	{
 		surface: "card",
@@ -46,34 +46,34 @@ const renderInputs = (slug, html) => renderFrames.flatMap((frame) => ["light", "
 /** Build one static preview artifact without loading the editor runtime or performing I/O. */
 const buildPublicTemplatePreviewArtifact = (template) => {
 	const registration = registerPublicCorpusEntry({
-		id: template.presetId,
+		id: template.starterId,
 		corpus: template.corpus,
 		facets: template.facets
 	});
 	if (Result.isError(registration)) return Result.err({
-		presetId: template.presetId,
+		starterId: template.starterId,
 		message: `public corpus registration failed: ${registration.error.message}`
 	});
-	const source = presetModuleSource(template.presetId);
-	const fixture = presetEmailFixtures[template.presetId]?.default;
-	const preset = presetCatalog.find((entry) => entry.id === template.presetId);
-	const preview = publicTemplatePreviews[template.presetId];
-	if (source === void 0 || preset === void 0 || fixture === void 0) return Result.err({
-		presetId: template.presetId,
-		message: "canonical preset source is missing"
+	const source = starterModuleSource(template.starterId);
+	const fixture = starterEmailFixtures[template.starterId]?.default;
+	const starter = starterCatalog.find((entry) => entry.id === template.starterId);
+	const preview = publicTemplatePreviews[template.starterId];
+	if (source === void 0 || starter === void 0 || fixture === void 0) return Result.err({
+		starterId: template.starterId,
+		message: "canonical starter source is missing"
 	});
 	const sampleData = fixture.input;
-	const assets = new Set(presetEmailAssets[template.presetId]);
+	const assets = new Set(starterEmailAssets[template.starterId]);
 	for (const asset of preview.assets) {
 		const value = sampleData[asset.variable];
 		if (typeof value !== "string") return Result.err({
-			presetId: template.presetId,
+			starterId: template.starterId,
 			message: `sample data is missing a string asset: ${asset.variable}`
 		});
 		assets.add(value);
 	}
 	return Result.ok({
-		presetId: template.presetId,
+		starterId: template.starterId,
 		slug: template.slug,
 		subject: fixture.subject,
 		preheader: fixture.preheader,

package/dist/{presets → starters}/public-preview.d.ts

@@ -1,4 +1,4 @@
-//#region presets/public-preview.d.ts
+//#region starters/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> | {

package/dist/{presets → starters}/public-preview.js

@@ -1,7 +1,7 @@
-import { presetEmailFixtures } from "./sources.js";
-//#region presets/public-preview.ts
+import { starterEmailFixtures } from "./sources.js";
+//#region starters/public-preview.ts
 const preview = (id, quality, assets) => {
-	const fixture = presetEmailFixtures[id]?.default;
+	const fixture = starterEmailFixtures[id]?.default;
 	if (fixture === void 0) throw new Error(`Missing generated gallery fixture: ${id}`);
 	return {
 		subject: fixture.subject,

package/dist/starters/showcase.d.ts

@@ -0,0 +1,2 @@
+import { a as ShowcaseProjectId, c as showcaseProject, i as ShowcaseProject, l as showcaseProjects, n as OwnedShowcaseId, o as ShowcaseProvenance, r as SHOWCASE_ROOT, s as isShowcaseProjectId, t as BrandRecreationShowcaseId, u as showcaseSourcePath } from "../showcase-egkusQBf.js";
+export { BrandRecreationShowcaseId, OwnedShowcaseId, SHOWCASE_ROOT, ShowcaseProject, ShowcaseProjectId, ShowcaseProvenance, isShowcaseProjectId, showcaseProject, showcaseProjects, showcaseSourcePath };