@samva/markup 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samva/markup",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Type-safe authoring and compilation primitives for Samva templates",
   "keywords": [
     "email",
@@ -26,6 +26,7 @@
   "files": [
     "dist",
     "!dist/**/*.map",
+    "samva-brand.d.ts",
     "generated",
     "package.json",
     "README.md",
@@ -88,10 +89,6 @@
       "types": "./dist/checks.d.ts",
       "import": "./dist/checks.js"
     },
-    "./footer": {
-      "types": "./dist/footer.d.ts",
-      "import": "./dist/footer.js"
-    },
     "./conditionals": {
       "types": "./dist/conditionals.d.ts",
       "import": "./dist/conditionals.js"
@@ -124,41 +121,49 @@
       "types": "./dist/predicate.d.ts",
       "import": "./dist/predicate.js"
     },
-    "./presets": {
-      "types": "./dist/presets.d.ts",
-      "import": "./dist/presets.js"
+    "./starters": {
+      "types": "./dist/starters.d.ts",
+      "import": "./dist/starters.js"
+    },
+    "./starters/category-mapping": {
+      "types": "./dist/starters/category-mapping.d.ts",
+      "import": "./dist/starters/category-mapping.js"
+    },
+    "./starters/corpus": {
+      "types": "./dist/starters/corpus.d.ts",
+      "import": "./dist/starters/corpus.js"
     },
-    "./presets/category-mapping": {
-      "types": "./dist/presets/category-mapping.d.ts",
-      "import": "./dist/presets/category-mapping.js"
+    "./starters/library": {
+      "types": "./dist/starters/library.d.ts",
+      "import": "./dist/starters/library.js"
     },
-    "./presets/corpus": {
-      "types": "./dist/presets/corpus.d.ts",
-      "import": "./dist/presets/corpus.js"
+    "./starters/public-gallery": {
+      "types": "./dist/starters/public-gallery.d.ts",
+      "import": "./dist/starters/public-gallery.js"
     },
-    "./presets/public-gallery": {
-      "types": "./dist/presets/public-gallery.d.ts",
-      "import": "./dist/presets/public-gallery.js"
+    "./starters/public-handoff": {
+      "types": "./dist/starters/public-handoff.d.ts",
+      "import": "./dist/starters/public-handoff.js"
     },
-    "./presets/public-handoff": {
-      "types": "./dist/presets/public-handoff.d.ts",
-      "import": "./dist/presets/public-handoff.js"
+    "./starters/public-preview": {
+      "types": "./dist/starters/public-preview.d.ts",
+      "import": "./dist/starters/public-preview.js"
     },
-    "./presets/public-preview": {
-      "types": "./dist/presets/public-preview.d.ts",
-      "import": "./dist/presets/public-preview.js"
+    "./starters/public-preview-artifacts": {
+      "types": "./dist/starters/public-preview-artifacts.d.ts",
+      "import": "./dist/starters/public-preview-artifacts.js"
     },
-    "./presets/public-preview-artifacts": {
-      "types": "./dist/presets/public-preview-artifacts.d.ts",
-      "import": "./dist/presets/public-preview-artifacts.js"
+    "./starters/showcase": {
+      "types": "./dist/starters/showcase.d.ts",
+      "import": "./dist/starters/showcase.js"
     },
-    "./presets/showcase": {
-      "types": "./dist/presets/showcase.d.ts",
-      "import": "./dist/presets/showcase.js"
+    "./starters/sources": {
+      "types": "./dist/starters/sources.d.ts",
+      "import": "./dist/starters/sources.js"
     },
-    "./presets/sources": {
-      "types": "./dist/presets/sources.d.ts",
-      "import": "./dist/presets/sources.js"
+    "./starters/theme": {
+      "types": "./dist/starters/theme.d.ts",
+      "import": "./dist/starters/theme.js"
     },
     "./printer": {
       "types": "./dist/printer.d.ts",
@@ -176,10 +181,6 @@
       "types": "./dist/source-locations.d.ts",
       "import": "./dist/source-locations.js"
     },
-    "./theme": {
-      "types": "./dist/theme.d.ts",
-      "import": "./dist/theme.js"
-    },
     "./theme-css": {
       "types": "./dist/theme-css.d.ts",
       "import": "./dist/theme-css.js"
@@ -192,10 +193,6 @@
       "types": "./dist/tsx-source-instrumentation.d.ts",
       "import": "./dist/tsx-source-instrumentation.js"
     },
-    "./tokens": {
-      "types": "./dist/tokens.d.ts",
-      "import": "./dist/tokens.js"
-    },
     "./variables": {
       "types": "./dist/variables.d.ts",
       "import": "./dist/variables.js"
@@ -233,6 +230,10 @@
       "types": "./dist/email/diagnostics.d.ts",
       "import": "./dist/email/diagnostics.js"
     },
+    "./email/assets": {
+      "types": "./dist/email/assets.d.ts",
+      "import": "./dist/email/assets.js"
+    },
     "./email/source-edit": {
       "types": "./dist/email/source-edit.d.ts",
       "import": "./dist/email/source-edit.js"
@@ -249,6 +250,17 @@
       "types": "./dist/email/text.d.ts",
       "import": "./dist/email/text.js"
     },
+    "./samva-brand": {
+      "types": "./samva-brand.d.ts"
+    },
+    "./email/brand-footer": {
+      "types": "./dist/email/brand-footer.d.ts",
+      "import": "./dist/email/brand-footer.js"
+    },
+    "./email/brand": {
+      "types": "./dist/email/brand.d.ts",
+      "import": "./dist/email/brand.js"
+    },
     "./email/stylesheets": {
       "types": "./dist/email/stylesheets.d.ts",
       "import": "./dist/email/stylesheets.js"
@@ -260,7 +272,7 @@
   "scripts": {
     "build": "tsdown",
     "prepack": "bun run build",
-    "codegen:presets": "bun run ../vite/scripts/codegen-presets.ts && oxfmt presets/sources.gen.ts",
+    "codegen:starters": "bun run ../vite/scripts/codegen-starters.ts && oxfmt starters/sources.gen.ts starters/library.gen.ts",
     "import:public-handoff": "bun run ../vite/scripts/import-public-template-handoff.ts",
     "corpus:render": "bun run scripts/render-compatibility-corpus.ts",
     "codegen:tailwind": "bun run scripts/codegen-tailwind.ts && oxfmt src/email/tailwind-stylesheets.gen.ts",

package/samva-brand.d.ts

@@ -0,0 +1,14 @@
+// The `samva:brand` module a template imports its brand components from. The
+// compiler resolves the specifier to a generated module bound to the build's
+// brand; this declaration is what a project's own `tsc` sees. Add
+// `"types": ["@samva/markup/samva-brand"]` to the project's tsconfig.
+
+declare module "samva:brand" {
+  export const BrandLogo: import("@samva/markup/email/brand").BrandComponents["BrandLogo"];
+  export const BrandFooter: import("@samva/markup/email/brand").BrandComponents["BrandFooter"];
+}
+
+declare module "samva:brand/*" {
+  export const BrandLogo: import("@samva/markup/email/brand").BrandComponents["BrandLogo"];
+  export const BrandFooter: import("@samva/markup/email/brand").BrandComponents["BrandFooter"];
+}

package/dist/footer.d.ts

@@ -1,66 +0,0 @@
-import { s as TokenTable } from "./theme-6ApjjiBo.js";
-//#region src/footer.d.ts
-/** The per-recipient unsubscribe URL is not known at accept time (the body is
- * shared across a send's deliveries), so the footer is composed with this
- * placeholder in the unsubscribe href and the plain-text tail. The email queue
- * processor substitutes each delivery's minted token URL at dispatch. The link
- * carries `ses:no-track` so click tracking never rewrites (and thereby breaks)
- * the placeholder. */
-declare const FOOTER_UNSUBSCRIBE_PLACEHOLDER = "%samva:unsubscribe-url%";
-/** One labelled social link. Structurally mirrors `DesignSocialLink`. */
-interface FooterSocialLink {
-  readonly label: string;
-  readonly url: string;
-}
-/** A structured postal address. Structurally mirrors `DesignAddress`. */
-interface FooterAddress {
-  readonly street1: string;
-  readonly street2?: string | undefined;
-  readonly city: string;
-  readonly region: string;
-  readonly postalCode: string;
-  readonly country: string;
-}
-/** The effective footer content. Structurally mirrors `DesignFooter`. */
-interface FooterContent {
-  readonly companyName?: string | undefined;
-  readonly address?: FooterAddress | undefined;
-  readonly socialLinks?: ReadonlyArray<FooterSocialLink> | undefined;
-  readonly customHtml?: string | undefined;
-}
-/** Which compliance-relevant footer fields the effective content is missing,
- *  surfaced on the design read path for the dashboard's footer nudge. */
-interface FooterCompleteness {
-  /** No physical mailing address is set anywhere in the cascade (CAN-SPAM). */
-  readonly missingAddress: boolean;
-}
-interface RenderedFooter {
-  /** Table-based footer block, ready to inject before the body's `</body>`. */
-  readonly html: string;
-  /** Plain-text footer tail, appended to the text alternative. */
-  readonly text: string;
-  readonly completeness: FooterCompleteness;
-}
-/**
- * Which compliance-relevant fields the footer content lacks — the signal the
- * dashboard's footer nudge reads. Derivable from `design.footer` alone (no token table),
- * so the design read path can report it without composing the block. A
- * `customHtml` footer is treated as complete (the org owns its own content).
- */
-declare const footerCompleteness: (footer: FooterContent | undefined) => FooterCompleteness;
-/**
- * Compose the injected footer for one send. `unsubscribeUrl` is the placeholder
- * (`FOOTER_UNSUBSCRIBE_PLACEHOLDER`) when a group resolved and dispatch will
- * mint the per-recipient link, or `null` to omit the unsubscribe row entirely
- * (no group resolved). Never throws and never blocks: whatever content exists
- * renders, and the missing pieces are reported via `completeness`.
- */
-declare const renderFooterBlock: (input: {
-  readonly footer: FooterContent;
-  readonly tokens: TokenTable;
-  readonly unsubscribeUrl: string | null;
-  readonly unsubscribeLabel?: string | undefined;
-}) => RenderedFooter;
-//#endregion
-export { FOOTER_UNSUBSCRIBE_PLACEHOLDER, FooterAddress, FooterCompleteness, FooterContent, FooterSocialLink, RenderedFooter, footerCompleteness, renderFooterBlock };
-//# sourceMappingURL=footer.d.ts.map

package/dist/footer.js

@@ -1,93 +0,0 @@
-//#region src/footer.ts
-/** The per-recipient unsubscribe URL is not known at accept time (the body is
-* shared across a send's deliveries), so the footer is composed with this
-* placeholder in the unsubscribe href and the plain-text tail. The email queue
-* processor substitutes each delivery's minted token URL at dispatch. The link
-* carries `ses:no-track` so click tracking never rewrites (and thereby breaks)
-* the placeholder. */
-const FOOTER_UNSUBSCRIBE_PLACEHOLDER = "%samva:unsubscribe-url%";
-const escapeText = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-const escapeAttribute = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
-const isSafeUrl = (url) => /^(https?:|mailto:)/i.test(url.trim());
-const addressLines = (address) => {
-	const region = [
-		address.city,
-		address.region,
-		address.postalCode
-	].filter(Boolean).join(", ");
-	return [
-		address.street1,
-		address.street2,
-		region,
-		address.country
-	].filter((line) => typeof line === "string" && line.trim().length > 0);
-};
-/**
-* Which compliance-relevant fields the footer content lacks — the signal the
-* dashboard's footer nudge reads. Derivable from `design.footer` alone (no token table),
-* so the design read path can report it without composing the block. A
-* `customHtml` footer is treated as complete (the org owns its own content).
-*/
-const footerCompleteness = (footer) => ({ missingAddress: footer?.customHtml === void 0 && (footer?.address === void 0 || addressLines(footer.address).length === 0) });
-/**
-* Compose the injected footer for one send. `unsubscribeUrl` is the placeholder
-* (`FOOTER_UNSUBSCRIBE_PLACEHOLDER`) when a group resolved and dispatch will
-* mint the per-recipient link, or `null` to omit the unsubscribe row entirely
-* (no group resolved). Never throws and never blocks: whatever content exists
-* renders, and the missing pieces are reported via `completeness`.
-*/
-const renderFooterBlock = (input) => {
-	const { footer, tokens, unsubscribeUrl } = input;
-	const unsubscribeLabel = input.unsubscribeLabel ?? "Unsubscribe";
-	const fontFamily = tokens.fontFamilies["body"] ?? tokens.fontFamilies["sans"] ?? "sans-serif";
-	const mutedColor = tokens.colors["gray-500"] ?? tokens.colors["neutral-500"] ?? "#6a7282";
-	const linkColor = tokens.colors["brand"] ?? mutedColor;
-	const containerPx = tokens.containerPx["xl"] ?? 600;
-	const fontSizePx = tokens.text["xs"]?.sizePx ?? 12;
-	const lineHeightPx = tokens.text["xs"]?.lineHeightPx ?? 18;
-	const fontFamilyAttribute = escapeAttribute(fontFamily);
-	const mutedColorAttribute = escapeAttribute(mutedColor);
-	const linkColorAttribute = escapeAttribute(linkColor);
-	const rows = [];
-	const textLines = [];
-	if (typeof footer.customHtml === "string" && footer.customHtml.trim().length > 0) rows.push(`<tr><td style="padding:0 0 12px 0;">${footer.customHtml}</td></tr>`);
-	else {
-		if (typeof footer.companyName === "string" && footer.companyName.trim().length > 0) {
-			rows.push(`<tr><td style="padding:0 0 4px 0;font-weight:600;">${escapeText(footer.companyName)}</td></tr>`);
-			textLines.push(footer.companyName);
-		}
-		if (footer.address !== void 0) {
-			const lines = addressLines(footer.address);
-			if (lines.length > 0) {
-				rows.push(`<tr><td style="padding:0 0 8px 0;">${lines.map(escapeText).join("<br />")}</td></tr>`);
-				textLines.push(lines.join(", "));
-			}
-		}
-		if (footer.socialLinks !== void 0 && footer.socialLinks.length > 0) {
-			const links = footer.socialLinks.map((link) => isSafeUrl(link.url) ? `<a href="${escapeAttribute(link.url.trim())}" style="color:${linkColorAttribute};text-decoration:underline;" ses:no-track>${escapeText(link.label)}</a>` : escapeText(link.label));
-			rows.push(`<tr><td style="padding:0 0 8px 0;">${links.join("<span style=\"padding:0 6px;\">·</span>")}</td></tr>`);
-			textLines.push(footer.socialLinks.map((link) => `${link.label}: ${link.url}`).join("  "));
-		}
-	}
-	if (unsubscribeUrl !== null) {
-		rows.push(`<tr><td style="padding:0;"><a href="${escapeAttribute(unsubscribeUrl)}" style="color:${mutedColorAttribute};text-decoration:underline;" ses:no-track>${escapeText(unsubscribeLabel)}</a></td></tr>`);
-		textLines.push(`${unsubscribeLabel}: ${unsubscribeUrl}`);
-	}
-	return {
-		html: rows.length === 0 ? "" : [
-			`<table role="presentation" cellpadding="0" cellspacing="0" border="0" width="100%" style="width:100%;border-collapse:collapse;">`,
-			`<tr><td align="center" style="padding:32px 16px;">`,
-			`<table role="presentation" cellpadding="0" cellspacing="0" border="0" width="${containerPx}" style="width:100%;max-width:${containerPx}px;border-collapse:collapse;font-family:${fontFamilyAttribute};font-size:${fontSizePx}px;line-height:${lineHeightPx}px;color:${mutedColorAttribute};text-align:center;">`,
-			...rows,
-			`</table>`,
-			`</td></tr>`,
-			`</table>`
-		].join(""),
-		text: textLines.length === 0 ? "" : `\n\n---\n${textLines.join("\n")}`,
-		completeness: footerCompleteness(footer)
-	};
-};
-//#endregion
-export { FOOTER_UNSUBSCRIBE_PLACEHOLDER, footerCompleteness, renderFooterBlock };
-
-//# sourceMappingURL=footer.js.map

package/dist/presets/corpus.d.ts

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

package/dist/presets/showcase.d.ts

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