@samva/markup 0.8.0 → 0.10.0

package/dist/source-locations-DrCM82Ym.d.ts

@@ -1,67 +0,0 @@
-import { f as ElementNode, x as SmlNode } from "./ast-BrDtApwS.js";
-//#region src/source-locations.d.ts
-/**
- * The source payload emitted by the JSX development transform. The transform
- * may omit any field for synthetic calls; only a complete payload can identify
- * a source origin safely.
- */
-interface JsxSource {
-  readonly fileName?: string | undefined;
-  readonly lineNumber?: number | undefined;
-  readonly columnNumber?: number | undefined;
-}
-/** A complete, normalized source origin for a JSX element. */
-interface JsxSourceLocation {
-  readonly fileName: string;
-  readonly lineNumber: number;
-  readonly columnNumber: number;
-}
-/**
- * Runtime-only carrier for JSX source metadata. It is global so separately
- * bundled `jsx-dev-runtime` and `render-template` entries still agree on the
- * sidecar key, and it is a Symbol so it cannot enter SML, HTML, or JSON.
- */
-declare const JSX_SOURCE_LOCATION: unique symbol;
-/** Internal JSX prop used only by an editor preview source transform. */
-declare const JSX_SOURCE_LOCATION_PROP: "__samva_source_location";
-/**
- * A source map is useful only when it is trustworthy. Production `jsx`/`jsxs`
- * currently provide no source metadata, so that path reports a typed absence
- * rather than guessing from output order.
- */
-type SourceLocationUnavailableReason = "no-source-metadata" | "structure-mismatch" | "duplicate-source-origin" | "render-failed" | "stale-preview";
-type UnboundTemplateSourceLocations = {
-  readonly kind: "available";
-  /** Parsed SML node id → the JSX origin that produced that element. */
-  readonly byNodeId: Readonly<Record<string, JsxSourceLocation>>;
-} | {
-  readonly kind: "unavailable";
-  readonly reason: SourceLocationUnavailableReason;
-};
-/** Revision-fenced source map exposed by a mutable workspace preview. */
-type TemplateSourceLocations = {
-  readonly kind: "available";
-  readonly revision: string;
-  /** Parsed SML node id → the JSX origin that produced that element. */
-  readonly byNodeId: Readonly<Record<string, JsxSourceLocation>>;
-} | {
-  readonly kind: "unavailable";
-  readonly reason: SourceLocationUnavailableReason;
-};
-/** Normalize the optional payload accepted by `jsxDEV`. */
-declare const completeJsxSourceLocation: (source: JsxSource | null | undefined) => JsxSourceLocation | undefined;
-/** Attach a source origin without changing the serialized draft shape. */
-declare const attachJsxSourceLocation: (node: ElementNode, source: JsxSourceLocation) => void;
-/** Read the ephemeral origin, if this draft element has one. */
-declare const jsxSourceLocationOf: (node: SmlNode) => JsxSourceLocation | undefined;
-/**
- * Pair a draft tree with its parsed SML tree by element preorder. Text nodes
- * are intentionally ignored: the SML parser normalizes inline whitespace, so
- * only the element structure is stable enough to be a source-map contract.
- */
-declare const mapJsxSourceLocations: (draft: ElementNode, parsed: ElementNode) => UnboundTemplateSourceLocations;
-/** Compare source-map statuses for the emission determinism guard. */
-declare const sameTemplateSourceLocations: (left: UnboundTemplateSourceLocations, right: UnboundTemplateSourceLocations) => boolean;
-//#endregion
-export { SourceLocationUnavailableReason as a, attachJsxSourceLocation as c, mapJsxSourceLocations as d, sameTemplateSourceLocations as f, JsxSourceLocation as i, completeJsxSourceLocation as l, JSX_SOURCE_LOCATION_PROP as n, TemplateSourceLocations as o, JsxSource as r, UnboundTemplateSourceLocations as s, JSX_SOURCE_LOCATION as t, jsxSourceLocationOf as u };
-//# sourceMappingURL=source-locations-DrCM82Ym.d.ts.map

package/dist/source-locations.d.ts

@@ -1,2 +0,0 @@
-import { a as SourceLocationUnavailableReason, c as attachJsxSourceLocation, d as mapJsxSourceLocations, f as sameTemplateSourceLocations, i as JsxSourceLocation, l as completeJsxSourceLocation, n as JSX_SOURCE_LOCATION_PROP, o as TemplateSourceLocations, r as JsxSource, s as UnboundTemplateSourceLocations, t as JSX_SOURCE_LOCATION, u as jsxSourceLocationOf } from "./source-locations-DrCM82Ym.js";
-export { JSX_SOURCE_LOCATION, JSX_SOURCE_LOCATION_PROP, JsxSource, JsxSourceLocation, SourceLocationUnavailableReason, TemplateSourceLocations, UnboundTemplateSourceLocations, attachJsxSourceLocation, completeJsxSourceLocation, jsxSourceLocationOf, mapJsxSourceLocations, sameTemplateSourceLocations };

package/dist/source-locations.js

@@ -1,102 +0,0 @@
-import { t as hasProperty } from "./guards-eV1qLbf2.js";
-//#region src/source-locations.ts
-/**
-* Runtime-only carrier for JSX source metadata. It is global so separately
-* bundled `jsx-dev-runtime` and `render-template` entries still agree on the
-* sidecar key, and it is a Symbol so it cannot enter SML, HTML, or JSON.
-*/
-const JSX_SOURCE_LOCATION = Symbol.for("@samva/markup/jsx-source-location");
-/** Internal JSX prop used only by an editor preview source transform. */
-const JSX_SOURCE_LOCATION_PROP = "__samva_source_location";
-/** Normalize the optional payload accepted by `jsxDEV`. */
-const completeJsxSourceLocation = (source) => {
-	if (source?.fileName === void 0 || source.lineNumber === void 0 || source.columnNumber === void 0) return;
-	return Object.freeze({
-		fileName: source.fileName,
-		lineNumber: source.lineNumber,
-		columnNumber: source.columnNumber
-	});
-};
-/** Attach a source origin without changing the serialized draft shape. */
-const attachJsxSourceLocation = (node, source) => {
-	if (Object.hasOwn(node, JSX_SOURCE_LOCATION)) return;
-	Object.defineProperty(node, JSX_SOURCE_LOCATION, {
-		configurable: false,
-		enumerable: false,
-		value: source,
-		writable: false
-	});
-};
-const isJsxSourceLocation = (value) => hasProperty(value, "fileName") && typeof value.fileName === "string" && hasProperty(value, "lineNumber") && typeof value.lineNumber === "number" && Number.isInteger(value.lineNumber) && hasProperty(value, "columnNumber") && typeof value.columnNumber === "number" && Number.isInteger(value.columnNumber);
-/** Read the ephemeral origin, if this draft element has one. */
-const jsxSourceLocationOf = (node) => {
-	if (node.kind !== "element") return void 0;
-	const value = Object.getOwnPropertyDescriptor(node, JSX_SOURCE_LOCATION)?.value;
-	return isJsxSourceLocation(value) ? value : void 0;
-};
-const elementChildren = (node) => node.children.filter((child) => child.kind === "element");
-const sourceOriginKey = (source) => JSON.stringify([
-	source.fileName,
-	source.lineNumber,
-	source.columnNumber
-]);
-/**
-* Pair a draft tree with its parsed SML tree by element preorder. Text nodes
-* are intentionally ignored: the SML parser normalizes inline whitespace, so
-* only the element structure is stable enough to be a source-map contract.
-*/
-const mapJsxSourceLocations = (draft, parsed) => {
-	const byNodeId = {};
-	const origins = /* @__PURE__ */ new Set();
-	let duplicateOrigin = false;
-	const visit = (draftNode, parsedNode) => {
-		if (draftNode.tag !== parsedNode.tag) return false;
-		const source = jsxSourceLocationOf(draftNode);
-		if (source !== void 0) {
-			const origin = sourceOriginKey(source);
-			if (origins.has(origin)) duplicateOrigin = true;
-			origins.add(origin);
-			if (Object.hasOwn(byNodeId, parsedNode.id)) return false;
-			byNodeId[parsedNode.id] = source;
-		}
-		const draftChildren = elementChildren(draftNode);
-		const parsedChildren = elementChildren(parsedNode);
-		if (draftChildren.length !== parsedChildren.length) return false;
-		for (let index = 0; index < draftChildren.length; index++) if (!visit(draftChildren[index], parsedChildren[index])) return false;
-		return true;
-	};
-	if (!visit(draft, parsed)) return {
-		kind: "unavailable",
-		reason: "structure-mismatch"
-	};
-	if (duplicateOrigin) return {
-		kind: "unavailable",
-		reason: "duplicate-source-origin"
-	};
-	if (Object.keys(byNodeId).length === 0) return {
-		kind: "unavailable",
-		reason: "no-source-metadata"
-	};
-	return {
-		kind: "available",
-		byNodeId: Object.freeze(byNodeId)
-	};
-};
-/** Compare source-map statuses for the emission determinism guard. */
-const sameTemplateSourceLocations = (left, right) => {
-	if (left.kind !== right.kind) return false;
-	if (left.kind === "unavailable") return right.kind === "unavailable" && left.reason === right.reason;
-	if (right.kind === "unavailable") return false;
-	const leftEntries = Object.entries(left.byNodeId);
-	const rightEntries = Object.entries(right.byNodeId);
-	if (leftEntries.length !== rightEntries.length) return false;
-	for (const [nodeId, source] of leftEntries) {
-		const other = right.byNodeId[nodeId];
-		if (other === void 0 || other.fileName !== source.fileName || other.lineNumber !== source.lineNumber || other.columnNumber !== source.columnNumber) return false;
-	}
-	return true;
-};
-//#endregion
-export { JSX_SOURCE_LOCATION, JSX_SOURCE_LOCATION_PROP, attachJsxSourceLocation, completeJsxSourceLocation, jsxSourceLocationOf, mapJsxSourceLocations, sameTemplateSourceLocations };
-
-//# sourceMappingURL=source-locations.js.map

package/dist/starters/category-mapping.d.ts

@@ -1,13 +0,0 @@
-import { r as StarterCategory } from "../catalog-CKuOooB8.js";
-import { TemplateCollectionId } from "./public-gallery.js";
-//#region starters/category-mapping.d.ts
-declare const LAB_DIMENSIONS: readonly ["newsletter", "receipt", "security", "product-update", "onboarding", "promotion", "shipping", "social-notification"];
-type LabDimension = (typeof LAB_DIMENSIONS)[number];
-declare const LAB_KINDS: readonly ["newsletter", "receipt", "security", "product-update", "onboarding", "promotion", "shipping", "social-notification", "digest", "invoice", "account", "event", "statement", "developer-notification", "unknown"];
-type LabKind = (typeof LAB_KINDS)[number];
-declare const labKindToStarterCategory: Record<LabKind, StarterCategory>;
-declare const starterCategoryToCollection: Record<StarterCategory, TemplateCollectionId>;
-declare const labKindToCollection: (kind: LabKind) => TemplateCollectionId;
-//#endregion
-export { LAB_DIMENSIONS, LAB_KINDS, LabDimension, LabKind, labKindToCollection, labKindToStarterCategory, starterCategoryToCollection };
-//# sourceMappingURL=category-mapping.d.ts.map

package/dist/starters/category-mapping.js

@@ -1,49 +0,0 @@
-//#region starters/category-mapping.ts
-const LAB_DIMENSIONS = [
-	"newsletter",
-	"receipt",
-	"security",
-	"product-update",
-	"onboarding",
-	"promotion",
-	"shipping",
-	"social-notification"
-];
-const LAB_KINDS = [
-	...LAB_DIMENSIONS,
-	"digest",
-	"invoice",
-	"account",
-	"event",
-	"statement",
-	"developer-notification",
-	"unknown"
-];
-const labKindToStarterCategory = {
-	newsletter: "digest",
-	receipt: "transactional",
-	security: "transactional",
-	"product-update": "marketing",
-	onboarding: "lifecycle",
-	promotion: "marketing",
-	shipping: "transactional",
-	"social-notification": "transactional",
-	digest: "digest",
-	invoice: "transactional",
-	account: "transactional",
-	event: "marketing",
-	statement: "transactional",
-	"developer-notification": "transactional",
-	unknown: "transactional"
-};
-const starterCategoryToCollection = {
-	transactional: "category:transactional",
-	digest: "category:digest-editorial",
-	marketing: "category:marketing",
-	lifecycle: "category:lifecycle"
-};
-const labKindToCollection = (kind) => starterCategoryToCollection[labKindToStarterCategory[kind]];
-//#endregion
-export { LAB_DIMENSIONS, LAB_KINDS, labKindToCollection, labKindToStarterCategory, starterCategoryToCollection };
-
-//# sourceMappingURL=category-mapping.js.map

package/dist/starters/corpus.d.ts

@@ -1,2 +0,0 @@
-import { a as PublicCorpusRegistrationIssue, c as TemplateFacetQuery, d as matchesTemplateFacets, f as ownedShowcaseStarterSources, h as templateFacetOptions, i as PublicCorpusRegistration, l as TemplateFacetSet, m as registerPublicCorpusEntry, n as InspirationReference, o as TemplateCorpusKind, p as ownedStarterSourcePath, r as OwnedEditableStarter, s as TemplateCorpusRecord, t as BrandRecreationStarter, u as brandRecreationProvenance } from "../corpus-CPPfgAHN.js";
-export { BrandRecreationStarter, InspirationReference, OwnedEditableStarter, PublicCorpusRegistration, PublicCorpusRegistrationIssue, TemplateCorpusKind, TemplateCorpusRecord, TemplateFacetQuery, TemplateFacetSet, brandRecreationProvenance, matchesTemplateFacets, ownedShowcaseStarterSources, ownedStarterSourcePath, registerPublicCorpusEntry, templateFacetOptions };

package/dist/starters/corpus.js

@@ -1,194 +0,0 @@
-import { n as isObject } from "../guards-eV1qLbf2.js";
-import { starterCatalog } from "../starters.js";
-import { showcaseProject, showcaseProjects, showcaseSourcePath } from "./showcase.js";
-import { Result } from "better-result";
-//#region starters/corpus.ts
-const templateFacetOptions = {
-	jobType: [
-		"account-access",
-		"commerce",
-		"product-communication",
-		"lifecycle",
-		"publishing-campaigns"
-	],
-	lifecycle: [
-		"acquisition",
-		"activation",
-		"engagement",
-		"transaction",
-		"retention",
-		"recovery"
-	],
-	industry: [
-		"saas",
-		"ecommerce",
-		"developer-tools",
-		"newsletters-media"
-	],
-	season: ["evergreen", "seasonal"],
-	audience: [
-		"product-users",
-		"customers",
-		"members",
-		"readers",
-		"shoppers",
-		"teams"
-	],
-	design: [
-		"minimal",
-		"branded",
-		"editorial",
-		"data-heavy",
-		"single-cta"
-	],
-	brandProvenance: ["samva-original", "third-party-reference"]
-};
-/** Clean-room recreations of a named brand's own email, authored as editable Samva projects. */
-const brandRecreationProvenance = Object.fromEntries(showcaseProjects.flatMap((project) => project.provenance.kind === "brand-recreation" ? [[project.id, {
-	owner: "Samva",
-	sourcePath: showcaseSourcePath(project),
-	recordedAt: project.recordedAt,
-	brand: project.provenance.brand,
-	subject: project.provenance.subject,
-	reviewedNote: project.provenance.reviewedNote
-}]] : []));
-/**
-* Owned starters authored as complete showcase projects with their own stylesheet and assets.
-* Every other owned starter is the single module `packages/markup/starters/<id>.tsx`.
-*/
-const ownedShowcaseStarterSources = Object.fromEntries(showcaseProjects.flatMap((project) => project.provenance.kind === "owned" ? [[project.id, showcaseSourcePath(project)]] : []));
-const ownedStarterSourcePath = (id) => {
-	const project = showcaseProject(id);
-	return project === void 0 || project.provenance.kind !== "owned" ? `packages/markup/starters/${id}.tsx` : showcaseSourcePath(project);
-};
-const ISO_TIMESTAMP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/;
-const nonEmpty = (value) => value.trim().length > 0;
-const isHttpsUrl = (value) => {
-	const url = URL.parse(value);
-	return url?.protocol === "https:" && url.hostname.length > 0 && url.username.length === 0 && url.password.length === 0;
-};
-const requiredFacetDimensions = [
-	"jobType",
-	"lifecycle",
-	"industry",
-	"season",
-	"audience",
-	"design",
-	"brandProvenance"
-];
-/** Exact key sets: a record carrying anything else is not the shape this gate admits. */
-const exactKeys = (value, keys) => isObject(value) && Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key));
-const isStringIn = (value, values) => typeof value === "string" && values.includes(value);
-const isStringArrayIn = (value, values) => Array.isArray(value) && value.every((entry) => isStringIn(entry, values));
-const isReview = (value) => exactKeys(value, [
-	"state",
-	"reviewedBy",
-	"reviewedAt",
-	"notes"
-]) && isStringIn(value.state, [
-	"draft",
-	"approved",
-	"rejected"
-]) && typeof value.reviewedBy === "string" && typeof value.reviewedAt === "string" && typeof value.notes === "string";
-const isDisplay = (value) => exactKeys(value, ["state", "attributionLabel"]) && isStringIn(value.state, ["hidden", "public"]) && typeof value.attributionLabel === "string";
-const isRetention = (value) => exactKeys(value, ["policy", "reviewedAt"]) && isStringIn(value.policy, ["retain-until-withdrawn", "retain-while-linked"]) && typeof value.reviewedAt === "string";
-const isTakedown = (value) => exactKeys(value, [
-	"state",
-	"contact",
-	"procedureUrl"
-]) && isStringIn(value.state, ["active", "removed"]) && typeof value.contact === "string" && typeof value.procedureUrl === "string";
-/** The four governance blocks every corpus record carries, whatever its kind. */
-const hasGovernance = (value) => isReview(value.review) && isDisplay(value.display) && isRetention(value.retention) && isTakedown(value.takedown);
-const CORPUS_KEYS = [
-	"type",
-	"corpusKind",
-	"provenance",
-	"review",
-	"display",
-	"retention",
-	"takedown"
-];
-const isCorpusRecord = (value) => {
-	if (!exactKeys(value, CORPUS_KEYS) || !hasGovernance(value)) return false;
-	const provenance = value.provenance;
-	if (value.type === "OwnedEditableStarter") return value.corpusKind === "owned-editable-sml" && exactKeys(provenance, [
-		"owner",
-		"sourcePath",
-		"recordedAt"
-	]) && provenance.owner === "Samva" && typeof provenance.sourcePath === "string" && typeof provenance.recordedAt === "string";
-	if (value.type === "BrandRecreationStarter") return value.corpusKind === "brand-recreation-sml" && exactKeys(provenance, [
-		"owner",
-		"sourcePath",
-		"recordedAt",
-		"brand",
-		"subject",
-		"reviewedNote"
-	]) && provenance.owner === "Samva" && typeof provenance.sourcePath === "string" && typeof provenance.recordedAt === "string" && typeof provenance.brand === "string" && typeof provenance.subject === "string" && typeof provenance.reviewedNote === "string";
-	return value.type === "InspirationReference" && value.corpusKind === "inspiration-reference" && exactKeys(provenance, [
-		"publisher",
-		"sourceUrl",
-		"capturedAt",
-		"rightsBasis"
-	]) && typeof provenance.publisher === "string" && typeof provenance.sourceUrl === "string" && typeof provenance.capturedAt === "string" && isStringIn(provenance.rightsBasis, ["display-link-and-commentary", "permission"]);
-};
-const isFacetSet = (value) => exactKeys(value, requiredFacetDimensions) && requiredFacetDimensions.every((dimension) => isStringArrayIn(value[dimension], templateFacetOptions[dimension]));
-const isCorpusEntry = (value) => exactKeys(value, [
-	"id",
-	"corpus",
-	"facets"
-]) && typeof value.id === "string" && isCorpusRecord(value.corpus) && isFacetSet(value.facets);
-const canonicalOwnedStarterSources = new Map(starterCatalog.filter((starter) => starter.channel === "email" && !Object.hasOwn(brandRecreationProvenance, starter.id)).map((starter) => [starter.id, ownedStarterSourcePath(starter.id)]));
-/** Decode and gate a record before it can enter any public projection. */
-const registerPublicCorpusEntry = (input) => {
-	if (!isCorpusEntry(input)) return Result.err({
-		id: "unknown",
-		message: "record does not match a corpus schema"
-	});
-	const { id, corpus, facets } = input;
-	const timestamps = [
-		corpus.review.reviewedAt,
-		corpus.retention.reviewedAt,
-		corpus.type === "InspirationReference" ? corpus.provenance.capturedAt : corpus.provenance.recordedAt
-	];
-	if (!nonEmpty(id) || corpus.review.state !== "approved" || !nonEmpty(corpus.review.reviewedBy) || !nonEmpty(corpus.review.notes) || corpus.display.state !== "public" || !nonEmpty(corpus.display.attributionLabel) || corpus.takedown.state !== "active" || !nonEmpty(corpus.takedown.contact) || !isHttpsUrl(corpus.takedown.procedureUrl) || timestamps.some((timestamp) => !ISO_TIMESTAMP.test(timestamp))) return Result.err({
-		id,
-		message: "public corpus records require approved review, display, retention, and takedown metadata"
-	});
-	if (corpus.type === "OwnedEditableStarter" && (canonicalOwnedStarterSources.get(id) !== corpus.provenance.sourcePath || corpus.retention.policy !== "retain-until-withdrawn" || facets.brandProvenance.some((value) => value !== "samva-original"))) return Result.err({
-		id,
-		message: "owned starters require a canonical editable TSX source"
-	});
-	if (corpus.type === "BrandRecreationStarter") {
-		const canonical = Object.entries(brandRecreationProvenance).find(([starterId]) => starterId === id)?.[1];
-		if (canonical === void 0 || Object.entries(canonical).some(([key, value]) => corpus.provenance[key] !== value) || !nonEmpty(corpus.provenance.brand) || !nonEmpty(corpus.provenance.subject) || corpus.retention.policy !== "retain-until-withdrawn" || facets.brandProvenance.some((value) => value !== "third-party-reference")) return Result.err({
-			id,
-			message: "brand recreations require a canonical source, a referenced brand and subject, and third-party provenance"
-		});
-	}
-	if (corpus.type === "InspirationReference" && (!isHttpsUrl(corpus.provenance.sourceUrl) || corpus.retention.policy !== "retain-while-linked" || facets.brandProvenance.some((value) => value !== "third-party-reference"))) return Result.err({
-		id,
-		message: "inspiration references require an HTTPS source and third-party provenance facet"
-	});
-	for (const dimension of requiredFacetDimensions) {
-		const values = facets[dimension];
-		if (values.length === 0 || new Set(values).size !== values.length) return Result.err({
-			id,
-			message: `facet ${dimension} must be populated without duplicates`
-		});
-	}
-	return Result.ok({
-		id,
-		corpus,
-		facets
-	});
-};
-/** Strict intersection: every selected value in every selected dimension must match. */
-const matchesTemplateFacets = (facets, query) => requiredFacetDimensions.every((dimension) => {
-	const selected = query[dimension];
-	const available = new Set(facets[dimension]);
-	return selected === void 0 || selected.every((value) => available.has(value));
-});
-//#endregion
-export { brandRecreationProvenance, matchesTemplateFacets, ownedShowcaseStarterSources, ownedStarterSourcePath, registerPublicCorpusEntry, templateFacetOptions };
-
-//# sourceMappingURL=corpus.js.map

package/dist/starters/library.d.ts

@@ -1,18 +0,0 @@
-//#region starters/library.gen.d.ts
-/** One public gallery template whose project the Agents Worker serves at `/library/<digest>.json`. */
-interface LibraryTemplate {
-  readonly slug: string;
-  readonly starterId: string;
-  readonly name: string;
-  /** SHA-256 of the served project bytes, lowercase hex. */
-  readonly digest: string;
-  /** Project-relative paths, so a listing needs no fetch. */
-  readonly paths: ReadonlyArray<string>;
-  readonly byteSize: number;
-}
-declare const libraryTemplates: ReadonlyArray<LibraryTemplate>;
-/** Identifies this exact library; a workspace records it to notice a changed gallery. */
-declare const libraryManifestDigest = "60bd511a973a6d1fe17bc6a03990118dd2a0e8a1f14556f09aaf54713420fd53";
-//#endregion
-export { LibraryTemplate, libraryManifestDigest, libraryTemplates };
-//# sourceMappingURL=library.d.ts.map