@samva/markup 0.1.0

package/dist/presets/public-handoff.js

@@ -0,0 +1,105 @@
+import { collectVariableReferences } from "../ast.js";
+import { parseSml } from "../parser.js";
+import { compileSource } from "../compile.js";
+import { RECOMMENDED_THEME, presetCatalog } from "../presets.js";
+import { publicTemplates, templateCollections } from "./public-gallery.js";
+import { Result } from "effect";
+//#region presets/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 sortedUnique = (values) => [...new Set(values)].sort();
+const sameStrings = (left, right) => JSON.stringify(sortedUnique(left)) === JSON.stringify(sortedUnique(right));
+const nonEmpty = (value) => value.trim().length > 0;
+const issue = (artifactId, code, message) => ({
+	artifactId,
+	code,
+	message
+});
+/**
+* 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.
+*/
+const validatePublicTemplateHandoff = (artifacts) => {
+	const issues = [];
+	const existingIds = new Set(presetCatalog.map((preset) => preset.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 knownCollections = new Set(templateCollections.map((collection) => collection.id));
+	for (const artifact of artifacts) {
+		const id = artifact.preset.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 (!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 (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 compiled = compileSource(artifact.preset.source, { theme: { overrides: [RECOMMENDED_THEME] } });
+		if (Result.isFailure(compiled)) issues.push(issue(id, "source", compiled.failure.message));
+		else if (artifact.preset.channel !== "email" || compiled.success.channel !== "email") issues.push(issue(id, "channel", "public template source must compile as email"));
+		const parsed = parseSml(artifact.preset.source);
+		if (Result.isSuccess(parsed)) {
+			const sourceVariables = [...collectVariableReferences(parsed.success)];
+			if (!sameStrings(artifact.preset.variables, sourceVariables)) issues.push(issue(id, "variables", "declared variables must exactly match source references"));
+		}
+		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"));
+		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];
+			const url = value === void 0 ? null : URL.parse(value);
+			if (!artifact.preset.variables.includes(asset.variable)) issues.push(issue(id, "assets", `asset "${asset.variable}" is not a declared preset variable`));
+			if (url === null || url.protocol !== "https:") issues.push(issue(id, "assets", `asset "${asset.variable}" must reference a valid HTTPS sample URL`));
+		}
+		const metadata = artifact.publicMetadata;
+		const metadataStrings = [
+			artifact.preset.name,
+			artifact.preset.description,
+			artifact.preview.subject,
+			artifact.preview.preheader,
+			metadata.cardTitle,
+			metadata.cardDescription,
+			metadata.seo.title,
+			metadata.seo.description,
+			...metadata.guidance,
+			...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 (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"));
+		for (const relatedId of artifact.gallery.relatedTemplates) if (relatedId === id || !allKnownIds.has(relatedId)) issues.push(issue(id, "reference", `related template "${relatedId}" is invalid`));
+	}
+	if (issues.length > 0) return Result.fail(issues);
+	return Result.succeed(artifacts.map((artifact) => ({
+		approval: {
+			...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
+		},
+		source: artifact.preset.source,
+		gallery: {
+			...artifact.gallery,
+			path: `/templates/${artifact.gallery.slug}`
+		},
+		preview: artifact.preview,
+		publicMetadata: artifact.publicMetadata
+	})));
+};
+//#endregion
+export { validatePublicTemplateHandoff };
+
+//# sourceMappingURL=public-handoff.js.map

package/dist/presets/public-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-handoff.js","names":[],"sources":["../../presets/public-handoff.ts"],"sourcesContent":["import { Result } from \"effect\";\n\nimport { collectVariableReferences, type Channel } from \"../src/ast\";\nimport { compileSource } from \"../src/compile\";\nimport { parseSml } from \"../src/parser\";\nimport { presetCatalog, RECOMMENDED_THEME, type PresetCategory } from \"./catalog\";\nimport {\n  publicTemplates,\n  templateCollections,\n  type TemplateCollectionId,\n  type TemplateUseCase,\n} from \"./public-gallery\";\nimport type { PublicTemplatePreview } from \"./public-preview\";\n\nexport interface ApprovedPublicTemplateArtifact {\n  readonly approval: {\n    readonly state: \"draft\" | \"approved\" | \"rejected\";\n    readonly approvedBy: string;\n    /** Stable ISO-8601 timestamp supplied by the owner. */\n    readonly approvedAt: string;\n  };\n  readonly preset: {\n    readonly id: string;\n    readonly channel: Channel;\n    readonly category: PresetCategory;\n    readonly name: string;\n    readonly description: string;\n    readonly variables: ReadonlyArray<string>;\n    readonly source: string;\n  };\n  readonly gallery: {\n    readonly slug: string;\n    readonly useCase: TemplateUseCase;\n    readonly collections: ReadonlyArray<TemplateCollectionId>;\n    readonly relatedTemplates: ReadonlyArray<string>;\n  };\n  readonly preview: PublicTemplatePreview;\n  readonly publicMetadata: {\n    readonly cardTitle: string;\n    readonly cardDescription: string;\n    readonly guidance: ReadonlyArray<string>;\n    readonly variableDescriptions: Readonly<Record<string, string>>;\n    readonly seo: { readonly title: string; readonly description: string };\n  };\n}\n\nexport interface ValidatedPublicTemplateArtifact {\n  readonly preset: Omit<ApprovedPublicTemplateArtifact[\"preset\"], \"source\">;\n  readonly source: string;\n  readonly gallery: ApprovedPublicTemplateArtifact[\"gallery\"] & {\n    readonly path: `/templates/${string}`;\n  };\n  readonly preview: ApprovedPublicTemplateArtifact[\"preview\"];\n  readonly publicMetadata: ApprovedPublicTemplateArtifact[\"publicMetadata\"];\n  readonly approval: ApprovedPublicTemplateArtifact[\"approval\"] & { readonly state: \"approved\" };\n}\n\nexport type PublicHandoffIssueCode =\n  | \"approval\"\n  | \"identity\"\n  | \"duplicate-id\"\n  | \"duplicate-slug\"\n  | \"source\"\n  | \"channel\"\n  | \"variables\"\n  | \"sample-data\"\n  | \"assets\"\n  | \"public-metadata\"\n  | \"reference\";\n\nexport interface PublicHandoffIssue {\n  readonly artifactId: string;\n  readonly code: PublicHandoffIssueCode;\n  readonly message: string;\n}\n\nconst SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\nconst ISO_TIMESTAMP = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$/;\n\nconst sortedUnique = (values: ReadonlyArray<string>): ReadonlyArray<string> =>\n  [...new Set(values)].sort();\n\nconst sameStrings = (left: ReadonlyArray<string>, right: ReadonlyArray<string>): boolean =>\n  JSON.stringify(sortedUnique(left)) === JSON.stringify(sortedUnique(right));\n\nconst nonEmpty = (value: string): boolean => value.trim().length > 0;\n\nconst issue = (\n  artifactId: string,\n  code: PublicHandoffIssueCode,\n  message: string,\n): PublicHandoffIssue => ({ artifactId, code, message });\n\n/**\n * Validates explicitly supplied, owner-approved artifacts without filesystem,\n * network, persistence, or discovery. Successful output is a projection for\n * the existing preset, public-gallery, preview, and editorial contracts; this\n * function never registers or publishes it.\n */\nexport const validatePublicTemplateHandoff = (\n  artifacts: ReadonlyArray<ApprovedPublicTemplateArtifact>,\n): Result.Result<\n  ReadonlyArray<ValidatedPublicTemplateArtifact>,\n  ReadonlyArray<PublicHandoffIssue>\n> => {\n  const issues: Array<PublicHandoffIssue> = [];\n  const existingIds = new Set<string>(presetCatalog.map((preset) => preset.id));\n  const existingSlugs = new Set<string>(publicTemplates.map((template) => template.slug));\n  const suppliedIds = new Set<string>();\n  const suppliedSlugs = new Set<string>();\n  const allKnownIds = new Set<string>([\n    ...publicTemplates.map((template) => template.presetId),\n    ...artifacts.map((artifact) => artifact.preset.id),\n  ]);\n  const knownCollections = new Set<string>(templateCollections.map((collection) => collection.id));\n\n  for (const artifact of artifacts) {\n    const id = artifact.preset.id;\n\n    if (\n      artifact.approval.state !== \"approved\" ||\n      !nonEmpty(artifact.approval.approvedBy) ||\n      !ISO_TIMESTAMP.test(artifact.approval.approvedAt)\n    ) {\n      issues.push(\n        issue(id, \"approval\", \"owner approval and an ISO-8601 approval timestamp are required\"),\n      );\n    }\n\n    if (!SLUG.test(id) || !SLUG.test(artifact.gallery.slug)) {\n      issues.push(\n        issue(id, \"identity\", \"preset id and canonical slug must be lowercase kebab-case\"),\n      );\n    }\n    if (existingIds.has(id) || suppliedIds.has(id)) {\n      issues.push(issue(id, \"duplicate-id\", `preset id \"${id}\" is already present`));\n    }\n    if (existingSlugs.has(artifact.gallery.slug) || suppliedSlugs.has(artifact.gallery.slug)) {\n      issues.push(\n        issue(id, \"duplicate-slug\", `canonical slug \"${artifact.gallery.slug}\" is already present`),\n      );\n    }\n    suppliedIds.add(id);\n    suppliedSlugs.add(artifact.gallery.slug);\n\n    const compiled = compileSource(artifact.preset.source, {\n      theme: { overrides: [RECOMMENDED_THEME] },\n    });\n    if (Result.isFailure(compiled)) {\n      issues.push(issue(id, \"source\", compiled.failure.message));\n    } else if (artifact.preset.channel !== \"email\" || compiled.success.channel !== \"email\") {\n      issues.push(issue(id, \"channel\", \"public template source must compile as email\"));\n    }\n\n    const parsed = parseSml(artifact.preset.source);\n    if (Result.isSuccess(parsed)) {\n      const sourceVariables = [...collectVariableReferences(parsed.success)];\n      if (!sameStrings(artifact.preset.variables, sourceVariables)) {\n        issues.push(\n          issue(id, \"variables\", \"declared variables must exactly match source references\"),\n        );\n      }\n    }\n\n    const sampleVariables = Object.keys(artifact.preview.sampleData);\n    if (!sameStrings(sampleVariables, artifact.preset.variables)) {\n      issues.push(\n        issue(id, \"sample-data\", \"sample data must cover every declared variable exactly\"),\n      );\n    }\n    if (Object.values(artifact.preview.sampleData).some((value) => !nonEmpty(value))) {\n      issues.push(issue(id, \"sample-data\", \"sample data values must be non-empty\"));\n    }\n\n    const assetVariables = artifact.preview.assets.map((asset) => asset.variable);\n    if (new Set(assetVariables).size !== assetVariables.length) {\n      issues.push(issue(id, \"assets\", \"asset variable references must be unique\"));\n    }\n    for (const asset of artifact.preview.assets) {\n      const value = artifact.preview.sampleData[asset.variable];\n      const url = value === undefined ? null : URL.parse(value);\n      if (!artifact.preset.variables.includes(asset.variable)) {\n        issues.push(\n          issue(id, \"assets\", `asset \"${asset.variable}\" is not a declared preset variable`),\n        );\n      }\n      if (url === null || url.protocol !== \"https:\") {\n        issues.push(\n          issue(id, \"assets\", `asset \"${asset.variable}\" must reference a valid HTTPS sample URL`),\n        );\n      }\n    }\n\n    const metadata = artifact.publicMetadata;\n    const metadataStrings = [\n      artifact.preset.name,\n      artifact.preset.description,\n      artifact.preview.subject,\n      artifact.preview.preheader,\n      metadata.cardTitle,\n      metadata.cardDescription,\n      metadata.seo.title,\n      metadata.seo.description,\n      ...metadata.guidance,\n      ...Object.values(metadata.variableDescriptions),\n    ];\n    if (metadata.guidance.length === 0 || metadataStrings.some((value) => !nonEmpty(value))) {\n      issues.push(issue(id, \"public-metadata\", \"public metadata fields must be non-empty\"));\n    }\n    if (!sameStrings(Object.keys(metadata.variableDescriptions), artifact.preset.variables)) {\n      issues.push(\n        issue(\n          id,\n          \"public-metadata\",\n          \"variable descriptions must cover every declared variable exactly\",\n        ),\n      );\n    }\n\n    if (new Set(artifact.gallery.collections).size !== artifact.gallery.collections.length) {\n      issues.push(issue(id, \"reference\", \"collection references must be unique\"));\n    }\n    for (const collectionId of artifact.gallery.collections) {\n      if (!knownCollections.has(collectionId)) {\n        issues.push(issue(id, \"reference\", `collection \"${collectionId}\" is invalid`));\n      }\n    }\n    if (\n      new Set(artifact.gallery.relatedTemplates).size !== artifact.gallery.relatedTemplates.length\n    ) {\n      issues.push(issue(id, \"reference\", \"related template references must be unique\"));\n    }\n    for (const relatedId of artifact.gallery.relatedTemplates) {\n      if (relatedId === id || !allKnownIds.has(relatedId)) {\n        issues.push(issue(id, \"reference\", `related template \"${relatedId}\" is invalid`));\n      }\n    }\n  }\n\n  if (issues.length > 0) return Result.fail(issues);\n\n  return Result.succeed(\n    artifacts.map((artifact) => ({\n      approval: { ...artifact.approval, state: \"approved\" },\n      preset: {\n        id: artifact.preset.id,\n        channel: artifact.preset.channel,\n        category: artifact.preset.category,\n        name: artifact.preset.name,\n        description: artifact.preset.description,\n        variables: artifact.preset.variables,\n      },\n      source: artifact.preset.source,\n      gallery: {\n        ...artifact.gallery,\n        path: `/templates/${artifact.gallery.slug}`,\n      },\n      preview: artifact.preview,\n      publicMetadata: artifact.publicMetadata,\n    })),\n  );\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,41 @@
+import { EmailPresetId } from "../presets.js";
+import { PublicTemplate } from "./public-gallery.js";
+import { PreviewQuality } from "./public-preview.js";
+import { Result } from "effect";
+//#region presets/public-preview-artifacts.d.ts
+type PreviewSurface = "card" | "detail" | "og";
+type PreviewViewport = "desktop" | "mobile";
+type PreviewColorScheme = "light" | "dark";
+interface PublicTemplateRenderInput {
+  readonly name: `${string}.${PreviewSurface}.${PreviewViewport}.${PreviewColorScheme}.html`;
+  readonly surface: PreviewSurface;
+  readonly viewport: PreviewViewport;
+  readonly colorScheme: PreviewColorScheme;
+  readonly width: number;
+  readonly height: number;
+  readonly html: string;
+}
+interface PublicTemplatePreviewArtifact {
+  readonly presetId: EmailPresetId;
+  readonly slug: string;
+  readonly subject: string;
+  readonly preheader: string;
+  readonly quality: PreviewQuality;
+  readonly source: string;
+  readonly html: string;
+  readonly assets: ReadonlyArray<string>;
+  readonly renders: ReadonlyArray<PublicTemplateRenderInput>;
+}
+interface PreviewArtifactBuildIssue {
+  readonly presetId: EmailPresetId;
+  readonly message: string;
+}
+/** Build one static preview artifact without loading the editor runtime or performing I/O. */
+declare const buildPublicTemplatePreviewArtifact: (template: PublicTemplate) => Result.Result<PublicTemplatePreviewArtifact, PreviewArtifactBuildIssue>;
+/** Build only the requested canonical subset, preserving manifest order and aggregated failures. */
+declare const buildPublicTemplatePreviewArtifactsFor: (templates: ReadonlyArray<PublicTemplate>) => Result.Result<ReadonlyArray<PublicTemplatePreviewArtifact>, ReadonlyArray<PreviewArtifactBuildIssue>>;
+/** Build the complete canonical public gallery. */
+declare const buildPublicTemplatePreviewArtifacts: () => Result.Result<readonly PublicTemplatePreviewArtifact[], readonly PreviewArtifactBuildIssue[]>;
+//#endregion
+export { PreviewArtifactBuildIssue, PreviewColorScheme, PreviewSurface, PreviewViewport, PublicTemplatePreviewArtifact, PublicTemplateRenderInput, buildPublicTemplatePreviewArtifact, buildPublicTemplatePreviewArtifacts, buildPublicTemplatePreviewArtifactsFor };
+//# sourceMappingURL=public-preview-artifacts.d.ts.map

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

@@ -0,0 +1,109 @@
+import { interpolate } from "../interpolate.js";
+import { compileSource } from "../compile.js";
+import { RECOMMENDED_THEME, presetCatalog } from "../presets.js";
+import { publicTemplates } from "./public-gallery.js";
+import { publicTemplatePreviews } from "./public-preview.js";
+import { presetSource } from "./sources.js";
+import { Result } from "effect";
+//#region presets/public-preview-artifacts.ts
+const renderFrames = [
+	{
+		surface: "card",
+		viewport: "desktop",
+		width: 600,
+		height: 760
+	},
+	{
+		surface: "card",
+		viewport: "mobile",
+		width: 390,
+		height: 680
+	},
+	{
+		surface: "detail",
+		viewport: "desktop",
+		width: 720,
+		height: 900
+	},
+	{
+		surface: "detail",
+		viewport: "mobile",
+		width: 390,
+		height: 844
+	},
+	{
+		surface: "og",
+		viewport: "desktop",
+		width: 1200,
+		height: 630
+	}
+];
+const renderInputs = (slug, html) => renderFrames.flatMap((frame) => ["light", "dark"].map((colorScheme) => ({
+	...frame,
+	colorScheme,
+	name: `${slug}.${frame.surface}.${frame.viewport}.${colorScheme}.html`,
+	html
+})));
+/** Build one static preview artifact without loading the editor runtime or performing I/O. */
+const buildPublicTemplatePreviewArtifact = (template) => {
+	const source = presetSource(template.presetId);
+	const preset = presetCatalog.find((entry) => entry.id === template.presetId);
+	const preview = publicTemplatePreviews[template.presetId];
+	if (source === void 0 || preset === void 0) return Result.fail({
+		presetId: template.presetId,
+		message: "canonical preset source is missing"
+	});
+	const compiled = compileSource(source, { theme: { overrides: [RECOMMENDED_THEME] } });
+	if (Result.isFailure(compiled) || compiled.success.channel !== "email") return Result.fail({
+		presetId: template.presetId,
+		message: "canonical preset did not compile as email"
+	});
+	const variableSchema = preset.variables.map((name) => ({
+		name,
+		type: "string",
+		required: true
+	}));
+	const rendered = interpolate(compiled.success.html, preview.sampleData, variableSchema);
+	if (rendered.missing.size > 0) return Result.fail({
+		presetId: template.presetId,
+		message: `sample data is missing: ${[...rendered.missing].sort().join(", ")}`
+	});
+	const sampleData = preview.sampleData;
+	const assets = [];
+	for (const asset of preview.assets) {
+		const value = sampleData[asset.variable];
+		if (value === void 0) return Result.fail({
+			presetId: template.presetId,
+			message: `sample data is missing asset: ${asset.variable}`
+		});
+		assets.push(value);
+	}
+	return Result.succeed({
+		presetId: template.presetId,
+		slug: template.slug,
+		subject: preview.subject,
+		preheader: preview.preheader,
+		quality: preview.quality,
+		source,
+		html: rendered.rendered,
+		assets,
+		renders: renderInputs(template.slug, rendered.rendered)
+	});
+};
+/** Build only the requested canonical subset, preserving manifest order and aggregated failures. */
+const buildPublicTemplatePreviewArtifactsFor = (templates) => {
+	const artifacts = [];
+	const issues = [];
+	for (const template of templates) {
+		const artifact = buildPublicTemplatePreviewArtifact(template);
+		if (Result.isSuccess(artifact)) artifacts.push(artifact.success);
+		else issues.push(artifact.failure);
+	}
+	return issues.length > 0 ? Result.fail(issues) : Result.succeed(artifacts);
+};
+/** Build the complete canonical public gallery. */
+const buildPublicTemplatePreviewArtifacts = () => buildPublicTemplatePreviewArtifactsFor(publicTemplates);
+//#endregion
+export { buildPublicTemplatePreviewArtifact, buildPublicTemplatePreviewArtifacts, buildPublicTemplatePreviewArtifactsFor };
+
+//# sourceMappingURL=public-preview-artifacts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public-preview-artifacts.js","names":[],"sources":["../../presets/public-preview-artifacts.ts"],"sourcesContent":["import { Result } from \"effect\";\n\nimport { compileSource } from \"../src/compile\";\nimport { interpolate, type DocumentVariable } from \"../src/interpolate\";\nimport { presetCatalog, RECOMMENDED_THEME, type EmailPresetId } from \"./catalog\";\nimport { publicTemplates, type PublicTemplate } from \"./public-gallery\";\nimport { publicTemplatePreviews, type PreviewQuality } from \"./public-preview\";\nimport { presetSource } from \"./sources.gen\";\n\nexport type PreviewSurface = \"card\" | \"detail\" | \"og\";\nexport type PreviewViewport = \"desktop\" | \"mobile\";\nexport type PreviewColorScheme = \"light\" | \"dark\";\n\nexport interface PublicTemplateRenderInput {\n  readonly name: `${string}.${PreviewSurface}.${PreviewViewport}.${PreviewColorScheme}.html`;\n  readonly surface: PreviewSurface;\n  readonly viewport: PreviewViewport;\n  readonly colorScheme: PreviewColorScheme;\n  readonly width: number;\n  readonly height: number;\n  readonly html: string;\n}\n\nexport interface PublicTemplatePreviewArtifact {\n  readonly presetId: EmailPresetId;\n  readonly slug: string;\n  readonly subject: string;\n  readonly preheader: string;\n  readonly quality: PreviewQuality;\n  readonly source: string;\n  readonly html: string;\n  readonly assets: ReadonlyArray<string>;\n  readonly renders: ReadonlyArray<PublicTemplateRenderInput>;\n}\n\nexport interface PreviewArtifactBuildIssue {\n  readonly presetId: EmailPresetId;\n  readonly message: string;\n}\n\nconst renderFrames = [\n  { surface: \"card\", viewport: \"desktop\", width: 600, height: 760 },\n  { surface: \"card\", viewport: \"mobile\", width: 390, height: 680 },\n  { surface: \"detail\", viewport: \"desktop\", width: 720, height: 900 },\n  { surface: \"detail\", viewport: \"mobile\", width: 390, height: 844 },\n  { surface: \"og\", viewport: \"desktop\", width: 1200, height: 630 },\n] as const satisfies ReadonlyArray<{\n  readonly surface: PreviewSurface;\n  readonly viewport: PreviewViewport;\n  readonly width: number;\n  readonly height: number;\n}>;\n\nconst renderInputs = (slug: string, html: string): ReadonlyArray<PublicTemplateRenderInput> =>\n  renderFrames.flatMap((frame) =>\n    ([\"light\", \"dark\"] as const).map((colorScheme) => ({\n      ...frame,\n      colorScheme,\n      name: `${slug}.${frame.surface}.${frame.viewport}.${colorScheme}.html`,\n      html,\n    })),\n  );\n\n/** Build one static preview artifact without loading the editor runtime or performing I/O. */\nexport const buildPublicTemplatePreviewArtifact = (\n  template: PublicTemplate,\n): Result.Result<PublicTemplatePreviewArtifact, PreviewArtifactBuildIssue> => {\n  const source = presetSource(template.presetId);\n  const preset = presetCatalog.find((entry) => entry.id === template.presetId);\n  const preview = publicTemplatePreviews[template.presetId];\n  if (source === undefined || preset === undefined) {\n    return Result.fail({\n      presetId: template.presetId,\n      message: \"canonical preset source is missing\",\n    });\n  }\n\n  const compiled = compileSource(source, { theme: { overrides: [RECOMMENDED_THEME] } });\n  if (Result.isFailure(compiled) || compiled.success.channel !== \"email\") {\n    return Result.fail({\n      presetId: template.presetId,\n      message: \"canonical preset did not compile as email\",\n    });\n  }\n\n  const variableSchema: ReadonlyArray<DocumentVariable> = preset.variables.map((name) => ({\n    name,\n    type: \"string\",\n    required: true,\n  }));\n  const rendered = interpolate(compiled.success.html, preview.sampleData, variableSchema);\n  if (rendered.missing.size > 0) {\n    return Result.fail({\n      presetId: template.presetId,\n      message: `sample data is missing: ${[...rendered.missing].sort().join(\", \")}`,\n    });\n  }\n\n  const sampleData: Readonly<Record<string, string>> = preview.sampleData;\n  const assets: Array<string> = [];\n  for (const asset of preview.assets) {\n    const value = sampleData[asset.variable];\n    if (value === undefined) {\n      return Result.fail({\n        presetId: template.presetId,\n        message: `sample data is missing asset: ${asset.variable}`,\n      });\n    }\n    assets.push(value);\n  }\n  return Result.succeed({\n    presetId: template.presetId,\n    slug: template.slug,\n    subject: preview.subject,\n    preheader: preview.preheader,\n    quality: preview.quality,\n    source,\n    html: rendered.rendered,\n    assets,\n    renders: renderInputs(template.slug, rendered.rendered),\n  });\n};\n\n/** Build only the requested canonical subset, preserving manifest order and aggregated failures. */\nexport const buildPublicTemplatePreviewArtifactsFor = (\n  templates: ReadonlyArray<PublicTemplate>,\n): Result.Result<\n  ReadonlyArray<PublicTemplatePreviewArtifact>,\n  ReadonlyArray<PreviewArtifactBuildIssue>\n> => {\n  const artifacts: Array<PublicTemplatePreviewArtifact> = [];\n  const issues: Array<PreviewArtifactBuildIssue> = [];\n\n  for (const template of templates) {\n    const artifact = buildPublicTemplatePreviewArtifact(template);\n    if (Result.isSuccess(artifact)) artifacts.push(artifact.success);\n    else issues.push(artifact.failure);\n  }\n\n  return issues.length > 0 ? Result.fail(issues) : Result.succeed(artifacts);\n};\n\n/** Build the complete canonical public gallery. */\nexport const buildPublicTemplatePreviewArtifacts = () =>\n  buildPublicTemplatePreviewArtifactsFor(publicTemplates);\n"],"mappings":";;;;;;;;AAwCA,MAAM,eAAe;CACnB;EAAE,SAAS;EAAQ,UAAU;EAAW,OAAO;EAAK,QAAQ;CAAI;CAChE;EAAE,SAAS;EAAQ,UAAU;EAAU,OAAO;EAAK,QAAQ;CAAI;CAC/D;EAAE,SAAS;EAAU,UAAU;EAAW,OAAO;EAAK,QAAQ;CAAI;CAClE;EAAE,SAAS;EAAU,UAAU;EAAU,OAAO;EAAK,QAAQ;CAAI;CACjE;EAAE,SAAS;EAAM,UAAU;EAAW,OAAO;EAAM,QAAQ;CAAI;AACjE;AAOA,MAAM,gBAAgB,MAAc,SAClC,aAAa,SAAS,UACnB,CAAC,SAAS,MAAM,CAAC,CAAW,KAAK,iBAAiB;CACjD,GAAG;CACH;CACA,MAAM,GAAG,KAAK,GAAG,MAAM,QAAQ,GAAG,MAAM,SAAS,GAAG,YAAY;CAChE;AACF,EAAE,CACJ;;AAGF,MAAa,sCACX,aAC4E;CAC5E,MAAM,SAAS,aAAa,SAAS,QAAQ;CAC7C,MAAM,SAAS,cAAc,MAAM,UAAU,MAAM,OAAO,SAAS,QAAQ;CAC3E,MAAM,UAAU,uBAAuB,SAAS;CAChD,IAAI,WAAW,KAAA,KAAa,WAAW,KAAA,GACrC,OAAO,OAAO,KAAK;EACjB,UAAU,SAAS;EACnB,SAAS;CACX,CAAC;CAGH,MAAM,WAAW,cAAc,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,iBAAiB,EAAE,EAAE,CAAC;CACpF,IAAI,OAAO,UAAU,QAAQ,KAAK,SAAS,QAAQ,YAAY,SAC7D,OAAO,OAAO,KAAK;EACjB,UAAU,SAAS;EACnB,SAAS;CACX,CAAC;CAGH,MAAM,iBAAkD,OAAO,UAAU,KAAK,UAAU;EACtF;EACA,MAAM;EACN,UAAU;CACZ,EAAE;CACF,MAAM,WAAW,YAAY,SAAS,QAAQ,MAAM,QAAQ,YAAY,cAAc;CACtF,IAAI,SAAS,QAAQ,OAAO,GAC1B,OAAO,OAAO,KAAK;EACjB,UAAU,SAAS;EACnB,SAAS,2BAA2B,CAAC,GAAG,SAAS,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI;CAC5E,CAAC;CAGH,MAAM,aAA+C,QAAQ;CAC7D,MAAM,SAAwB,CAAC;CAC/B,KAAK,MAAM,SAAS,QAAQ,QAAQ;EAClC,MAAM,QAAQ,WAAW,MAAM;EAC/B,IAAI,UAAU,KAAA,GACZ,OAAO,OAAO,KAAK;GACjB,UAAU,SAAS;GACnB,SAAS,iCAAiC,MAAM;EAClD,CAAC;EAEH,OAAO,KAAK,KAAK;CACnB;CACA,OAAO,OAAO,QAAQ;EACpB,UAAU,SAAS;EACnB,MAAM,SAAS;EACf,SAAS,QAAQ;EACjB,WAAW,QAAQ;EACnB,SAAS,QAAQ;EACjB;EACA,MAAM,SAAS;EACf;EACA,SAAS,aAAa,SAAS,MAAM,SAAS,QAAQ;CACxD,CAAC;AACH;;AAGA,MAAa,0CACX,cAIG;CACH,MAAM,YAAkD,CAAC;CACzD,MAAM,SAA2C,CAAC;CAElD,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,WAAW,mCAAmC,QAAQ;EAC5D,IAAI,OAAO,UAAU,QAAQ,GAAG,UAAU,KAAK,SAAS,OAAO;OAC1D,OAAO,KAAK,SAAS,OAAO;CACnC;CAEA,OAAO,OAAO,SAAS,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,QAAQ,SAAS;AAC3E;;AAGA,MAAa,4CACX,uCAAuC,eAAe"}