@samva/markup 0.7.0 → 0.8.0

package/dist/{corpus-BjYMqOoY.d.ts → corpus-CPPfgAHN.d.ts}

@@ -1,6 +1,6 @@
-import { n as OwnedShowcaseId, t as BrandRecreationShowcaseId } from "./showcase-DGZAWn4Z.js";
+import { n as OwnedShowcaseId, t as BrandRecreationShowcaseId } from "./showcase-egkusQBf.js";
 import { Result } from "better-result";
-//#region presets/corpus.d.ts
+//#region starters/corpus.d.ts
 type TemplateCorpusKind = "owned-editable-sml" | "brand-recreation-sml" | "inspiration-reference";
 declare const templateFacetOptions: {
   readonly jobType: readonly ["account-access", "commerce", "product-communication", "lifecycle", "publishing-campaigns"];
@@ -32,8 +32,8 @@ interface CorpusTakedown {
   readonly contact: string;
   readonly procedureUrl: string;
 }
-interface OwnedEditablePreset {
-  readonly type: "OwnedEditablePreset";
+interface OwnedEditableStarter {
+  readonly type: "OwnedEditableStarter";
   readonly corpusKind: "owned-editable-sml";
   readonly provenance: {
     readonly owner: "Samva";
@@ -45,8 +45,8 @@ interface OwnedEditablePreset {
   readonly retention: CorpusRetention;
   readonly takedown: CorpusTakedown;
 }
-interface BrandRecreationPreset {
-  readonly type: "BrandRecreationPreset";
+interface BrandRecreationStarter {
+  readonly type: "BrandRecreationStarter";
   readonly corpusKind: "brand-recreation-sml";
   readonly provenance: {
     readonly owner: "Samva";
@@ -64,13 +64,13 @@ interface BrandRecreationPreset {
   readonly takedown: CorpusTakedown;
 }
 /** Clean-room recreations of a named brand's own email, authored as editable Samva projects. */
-declare const brandRecreationProvenance: Record<BrandRecreationShowcaseId, BrandRecreationPreset["provenance"]>;
+declare const brandRecreationProvenance: Record<BrandRecreationShowcaseId, BrandRecreationStarter["provenance"]>;
 /**
- * Owned presets authored as complete showcase projects with their own stylesheet and assets.
- * Every other owned preset is the single module `packages/markup/presets/<id>.tsx`.
+ * 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`.
  */
-declare const ownedShowcasePresetSources: Record<OwnedShowcaseId, string>;
-declare const ownedPresetSourcePath: (id: string) => string;
+declare const ownedShowcaseStarterSources: Record<OwnedShowcaseId, string>;
+declare const ownedStarterSourcePath: (id: string) => string;
 interface InspirationReference {
   readonly type: "InspirationReference";
   readonly corpusKind: "inspiration-reference";
@@ -85,7 +85,7 @@ interface InspirationReference {
   readonly retention: CorpusRetention;
   readonly takedown: CorpusTakedown;
 }
-type TemplateCorpusRecord = OwnedEditablePreset | BrandRecreationPreset | InspirationReference;
+type TemplateCorpusRecord = OwnedEditableStarter | BrandRecreationStarter | InspirationReference;
 interface PublicCorpusRegistration {
   readonly id: string;
   readonly corpus: TemplateCorpusRecord;
@@ -102,5 +102,5 @@ type TemplateFacetQuery = Partial<TemplateFacetSet>;
 /** Strict intersection: every selected value in every selected dimension must match. */
 declare const matchesTemplateFacets: (facets: TemplateFacetSet, query: TemplateFacetQuery) => boolean;
 //#endregion
-export { PublicCorpusRegistrationIssue as a, TemplateFacetQuery as c, matchesTemplateFacets as d, ownedPresetSourcePath as f, templateFacetOptions as h, PublicCorpusRegistration as i, TemplateFacetSet as l, registerPublicCorpusEntry as m, InspirationReference as n, TemplateCorpusKind as o, ownedShowcasePresetSources as p, OwnedEditablePreset as r, TemplateCorpusRecord as s, BrandRecreationPreset as t, brandRecreationProvenance as u };
-//# sourceMappingURL=corpus-BjYMqOoY.d.ts.map
+export { PublicCorpusRegistrationIssue as a, TemplateFacetQuery as c, matchesTemplateFacets as d, ownedShowcaseStarterSources as f, templateFacetOptions as h, PublicCorpusRegistration as i, TemplateFacetSet as l, registerPublicCorpusEntry as m, InspirationReference as n, TemplateCorpusKind as o, ownedStarterSourcePath as p, OwnedEditableStarter as r, TemplateCorpusRecord as s, BrandRecreationStarter as t, brandRecreationProvenance as u };
+//# sourceMappingURL=corpus-CPPfgAHN.d.ts.map

package/dist/{css-COcFOT1y.d.ts → css-CS2jLID6.d.ts}

@@ -1,6 +1,23 @@
 import { r as EmailDiagnostic } from "./diagnostics-BMYtBCQk.js";
 import { m as EmailNode } from "./elements-BzjjnoCS.js";
 import "css-tree";
+//#region src/email/font-stacks.d.ts
+/** One `@font-face` rule, its `src` already resolved to served URLs. */
+interface FontFaceRule {
+  /** The family the rule declares, unquoted. */
+  readonly family: string;
+  /** The rule as it goes into the email's `<head>`. */
+  readonly css: string;
+}
+//#endregion
+//#region src/email/fonts.d.ts
+/**
+ * Maps a relative `src` URL, as authored, to the URL its project file is served
+ * from, or `undefined` when the project has no such file. The stylesheet's host
+ * owns this: it knows which file the stylesheet came from and the asset base.
+ */
+type FontFileResolver = (reference: string) => string | undefined;
+//#endregion
 //#region src/email/selectors.d.ts
 type EmailElementNode = Extract<EmailNode, {
   type: "Element";
@@ -65,8 +82,10 @@ interface CssRule {
 }
 interface Stylesheet {
   readonly rules: readonly CssRule[];
-  /** `@font-face` and other at-rules kept verbatim in `<head>`. */
+  /** `@page`, `@keyframes` and other at-rules kept verbatim in `<head>`. */
   readonly headAtRules: readonly string[];
+  /** Validated `@font-face` rules, `src` resolved; the render hides them from classic Outlook. */
+  readonly fontFaces: readonly FontFaceRule[];
   /** Unconditional custom properties, for resolving `var()` before inlining. */
   readonly variables: Readonly<Record<string, string>>;
   readonly diagnostics: readonly EmailDiagnostic[];
@@ -77,7 +96,14 @@ declare const compileSelector: (selector: string) => CompiledSelector | undefine
 declare const parseStylesheet: (source: string, options?: {
   readonly origin?: string;
   readonly startOrder?: number;
+  /** Resolves a relative `@font-face` src to the URL its project file is served from. */
+  readonly resolveFontFile?: FontFileResolver | undefined;
+  /**
+   * The sheet belongs to the project theme, whose `@import`s the Tailwind
+   * compile resolves; they are layering, not something to report here.
+   */
+  readonly themeImports?: boolean | undefined;
 }) => Stylesheet;
 //#endregion
 export { compileSelector as a, CompiledSelector as c, matchesSelector as d, Stylesheet as i, Compound as l, CssRule as n, parseStylesheet as o, Specificity as r, Ancestry as s, CssDeclaration as t, classListOf as u };
-//# sourceMappingURL=css-COcFOT1y.d.ts.map
+//# sourceMappingURL=css-CS2jLID6.d.ts.map

package/dist/email/assets.d.ts

@@ -0,0 +1,40 @@
+import { r as EmailDiagnostic } from "../diagnostics-BMYtBCQk.js";
+//#region src/email/assets.d.ts
+/** Files a template may import, and what they are served as. */
+declare const ASSET_CONTENT_TYPES: Readonly<Record<string, string>>;
+interface AssetEntry {
+  /** Project-relative path the template imported. */
+  readonly path: string;
+  /** SHA-256 of the exact bytes, lowercase hex. */
+  readonly digest: string;
+  readonly bytes: number;
+  readonly contentType: string;
+  /** `<digest><ext>` — the name the asset has under any base. */
+  readonly fileName: string;
+}
+interface AssetManifest {
+  /** Where these assets are served from in this build. */
+  readonly base: string;
+  readonly assets: readonly AssetEntry[];
+}
+/** True when the compiler turns this import into a content-addressed asset. */
+declare const isAssetPath: (path: string) => boolean;
+/** Address one file by its content. */
+declare const assetEntry: (path: string, bytes: Uint8Array) => Promise<AssetEntry>;
+/**
+ * The URL an asset has under a base. The base is a build input: publication
+ * passes its hosted origin, and a local export passes whatever it will serve
+ * the exported files from.
+ */
+declare const assetUrl: (entry: AssetEntry, base: string) => string;
+/** Record, but never fetch, a URL the template points at. */
+declare const isExternalAsset: (reference: string) => boolean;
+/**
+ * Reject an asset base that would produce URLs a client will not load. The
+ * relative forms are the ones a page on disk resolves against its own
+ * directory, which is what a local export writes.
+ */
+declare const checkAssetBase: (base: string) => readonly EmailDiagnostic[];
+//#endregion
+export { ASSET_CONTENT_TYPES, AssetEntry, AssetManifest, assetEntry, assetUrl, checkAssetBase, isAssetPath, isExternalAsset };
+//# sourceMappingURL=assets.d.ts.map

package/dist/email/assets.js

@@ -0,0 +1,63 @@
+//#region src/email/assets.ts
+/** Files a template may import, and what they are served as. */
+const ASSET_CONTENT_TYPES = {
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".webp": "image/webp",
+	".avif": "image/avif",
+	".svg": "image/svg+xml",
+	".ico": "image/x-icon",
+	".woff": "font/woff",
+	".woff2": "font/woff2",
+	".ttf": "font/ttf",
+	".otf": "font/otf",
+	".pdf": "application/pdf",
+	".txt": "text/plain"
+};
+const extensionOf = (path) => {
+	const dot = path.lastIndexOf(".");
+	return dot < 0 ? "" : path.slice(dot).toLowerCase();
+};
+/** True when the compiler turns this import into a content-addressed asset. */
+const isAssetPath = (path) => Object.hasOwn(ASSET_CONTENT_TYPES, extensionOf(path));
+const hex = (buffer) => Array.from(new Uint8Array(buffer), (byte) => byte.toString(16).padStart(2, "0")).join("");
+/** Address one file by its content. */
+const assetEntry = async (path, bytes) => {
+	const extension = extensionOf(path);
+	const view = new Uint8Array(bytes.byteLength);
+	view.set(bytes);
+	const digest = hex(await crypto.subtle.digest("SHA-256", view));
+	return {
+		path,
+		digest,
+		bytes: bytes.byteLength,
+		contentType: ASSET_CONTENT_TYPES[extension] ?? "application/octet-stream",
+		fileName: `${digest}${extension}`
+	};
+};
+/**
+* The URL an asset has under a base. The base is a build input: publication
+* passes its hosted origin, and a local export passes whatever it will serve
+* the exported files from.
+*/
+const assetUrl = (entry, base) => `${base.replace(/\/+$/, "")}/${entry.fileName}`;
+const EXTERNAL_IMAGE = /^https:\/\//i;
+/** Record, but never fetch, a URL the template points at. */
+const isExternalAsset = (reference) => EXTERNAL_IMAGE.test(reference);
+/**
+* Reject an asset base that would produce URLs a client will not load. The
+* relative forms are the ones a page on disk resolves against its own
+* directory, which is what a local export writes.
+*/
+const checkAssetBase = (base) => /^(https:\/\/|\.{1,2}\/|\/)/i.test(base) ? [] : [{
+	code: "invalid-asset-base",
+	severity: "error",
+	message: `Asset base ${JSON.stringify(base)} must be an https URL, an absolute path, or a relative path for a local export.`,
+	origins: []
+}];
+//#endregion
+export { ASSET_CONTENT_TYPES, assetEntry, assetUrl, checkAssetBase, isAssetPath, isExternalAsset };
+
+//# sourceMappingURL=assets.js.map

package/dist/email/brand-footer.d.ts

@@ -0,0 +1,34 @@
+import { t as EmailContent } from "../template-DWftqh4x.js";
+import { RenderedEmail } from "./render.js";
+import { a as EmailBrand, n as BrandComponents } from "../brand-DcoVkh_S.js";
+//#region src/email/brand-footer.d.ts
+/** A footer block for the send path to append, and its plain-text tail. */
+interface RenderedBrandFooter {
+  readonly html: string;
+  readonly text: string;
+}
+/**
+ * Render `BrandFooter` against a brand on its own, for the send path to
+ * append to a message whose template renders no footer of its own. It
+ * compiles the same component, styled by the same brand theme, a template
+ * would get from `samva:brand`. Without `unsubscribe` the unsubscribe row is
+ * left out.
+ */
+declare const renderBrandFooter: (brand: EmailBrand, options: {
+  readonly unsubscribe: boolean;
+}) => Promise<RenderedBrandFooter>;
+/**
+ * Render content against a brand as a project whose `theme.css` is
+ * `@import "samva:brand";` renders it: Tailwind compiles the brand theme for
+ * the classes the content names, `BrandLogo` and `BrandFooter` are bound to the
+ * brand, and the render inlines the result. A brand preview renders through
+ * this, so it shows what a template importing the brand compiles to.
+ */
+declare const renderBrandSample: (brand: EmailBrand, sample: {
+  /** Every class the content names; nothing is discovered from source here. */
+  readonly classes: readonly string[];
+  readonly render: (components: BrandComponents) => EmailContent;
+}) => Promise<RenderedEmail>;
+//#endregion
+export { RenderedBrandFooter, renderBrandFooter, renderBrandSample };
+//# sourceMappingURL=brand-footer.d.ts.map

package/dist/email/brand-footer.js

@@ -0,0 +1,62 @@
+import { a as renderEmailContent, o as applyStylesheet, r as compileEmail } from "../render-vAv_4r9v.js";
+import { EmailCompileError } from "./diagnostics.js";
+import { BRAND_COMPONENT_CLASSES, brandComponents, withoutUnsubscribeRow } from "./brand.js";
+import { c as parseBrandCss, i as brandTailwindCss } from "../theme-css-hFqcPSar.js";
+import { t as compileTailwind, u as parseStylesheet } from "../tailwind-BYq7Lo6u.js";
+//#region src/email/brand-footer.ts
+/** The brand theme as Tailwind compiles it; a theme outside the grammar is a compile refusal. */
+const brandTheme = (brand) => {
+	const parsed = parseBrandCss(brand.css);
+	if (parsed.isErr()) throw new EmailCompileError({ diagnostics: parsed.error.map((finding) => ({
+		code: finding.code,
+		severity: "error",
+		message: `samva:brand: ${finding.message}`,
+		origins: []
+	})) });
+	return brandTailwindCss(parsed.value);
+};
+/**
+* Render `BrandFooter` against a brand on its own, for the send path to
+* append to a message whose template renders no footer of its own. It
+* compiles the same component, styled by the same brand theme, a template
+* would get from `samva:brand`. Without `unsubscribe` the unsubscribe row is
+* left out.
+*/
+const renderBrandFooter = async (brand, options) => {
+	const tailwind = await compileTailwind(BRAND_COMPONENT_CLASSES, { css: brandTheme(brand) });
+	const node = brandComponents(brand).BrandFooter({});
+	if (node === null) return {
+		html: "",
+		text: ""
+	};
+	const styled = applyStylesheet(node, parseStylesheet(tailwind.css, { origin: "samva:brand" }));
+	const compiled = compileEmail(styled.tree);
+	const rendered = options.unsubscribe ? compiled : withoutUnsubscribeRow({
+		html: compiled.html,
+		text: compiled.text
+	});
+	const text = (rendered.text ?? "").trim();
+	return {
+		html: rendered.html ?? "",
+		text: text === "" ? "" : `\n\n---\n${text}`
+	};
+};
+/**
+* Render content against a brand as a project whose `theme.css` is
+* `@import "samva:brand";` renders it: Tailwind compiles the brand theme for
+* the classes the content names, `BrandLogo` and `BrandFooter` are bound to the
+* brand, and the render inlines the result. A brand preview renders through
+* this, so it shows what a template importing the brand compiles to.
+*/
+const renderBrandSample = async (brand, sample) => {
+	const tailwind = await compileTailwind([...BRAND_COMPONENT_CLASSES, ...sample.classes], { css: "@import \"samva:brand\";" }, {
+		stylesheets: /* @__PURE__ */ new Map(),
+		brandCss: brandTheme(brand)
+	});
+	const components = brandComponents(brand);
+	return renderEmailContent(parseStylesheet(tailwind.css, { origin: "samva:brand" }), () => sample.render(components));
+};
+//#endregion
+export { renderBrandFooter, renderBrandSample };
+
+//# sourceMappingURL=brand-footer.js.map

package/dist/email/brand.d.ts

@@ -0,0 +1,2 @@
+import { a as EmailBrand, c as EmailBrandFooter, d as RenderedFooterMarkers, f as UNSUBSCRIBE_ROW_ATTRIBUTE, g as UNSUBSCRIBE_URL_PLACEHOLDER, h as withoutUnsubscribeRow, i as BrandLogoProps, l as EmailBrandSocialLink, m as renderedFooterMarkers, n as BrandComponents, o as EmailBrandAddress, p as brandComponents, r as BrandFooterProps, s as EmailBrandAssets, t as BRAND_COMPONENT_CLASSES, u as FOOTER_ATTRIBUTE } from "../brand-DcoVkh_S.js";
+export { BRAND_COMPONENT_CLASSES, BrandComponents, BrandFooterProps, BrandLogoProps, EmailBrand, EmailBrandAddress, EmailBrandAssets, EmailBrandFooter, EmailBrandSocialLink, FOOTER_ATTRIBUTE, RenderedFooterMarkers, UNSUBSCRIBE_ROW_ATTRIBUTE, UNSUBSCRIBE_URL_PLACEHOLDER, brandComponents, renderedFooterMarkers, withoutUnsubscribeRow };

package/dist/email/brand.js

@@ -0,0 +1,148 @@
+import { Fragment, jsx } from "./jsx-runtime.js";
+import { i as UNSUBSCRIBE_URL_PLACEHOLDER, r as UNSUBSCRIBE_LINK, t as BRAND_FOOTER_MARKER } from "../unsubscribe-link-CoesnQDU.js";
+//#region src/email/brand.ts
+/** Marks the block the send path recognizes as the template's own footer. */
+const FOOTER_ATTRIBUTE = "data-samva-footer";
+/** Marks the footer row that carries the unsubscribe link. */
+const UNSUBSCRIBE_ROW_ATTRIBUTE = "data-samva-unsubscribe";
+/** Every class the brand components use, compiled for any project that imports them. */
+const BRAND_COMPONENT_CLASSES = [
+	"dark:hidden!",
+	"hidden",
+	"dark:block!",
+	"text-xs",
+	"text-gray-500",
+	"text-center",
+	"font-semibold",
+	"underline"
+];
+const addressLines = (address) => [
+	address.street1,
+	address.street2,
+	[
+		address.city,
+		address.region,
+		address.postalCode
+	].filter((part) => part.trim() !== "").join(", "),
+	address.country
+].filter((line) => line !== void 0 && line.trim() !== "");
+const classes = (...names) => {
+	const joined = names.filter((name) => name !== void 0 && name !== "").join(" ");
+	return joined === "" ? void 0 : joined;
+};
+const row = (children, props = {}) => jsx("tr", {
+	...props,
+	children: jsx("td", {
+		style: { padding: "0 0 8px 0" },
+		children
+	})
+});
+/** Bind `BrandLogo` and `BrandFooter` to one brand. */
+const brandComponents = (brand) => {
+	const assets = brand.assets ?? {};
+	const footer = brand.footer ?? {};
+	const BrandLogo = ({ width = 120, alt, align, className }) => {
+		if (assets.logoUrl === void 0) return null;
+		const label = alt ?? footer.companyName ?? "";
+		const image = (src, imageClass, imageAlt) => jsx("img", {
+			src,
+			alt: imageAlt,
+			width,
+			border: 0,
+			...align === void 0 ? {} : { align },
+			className: classes(imageClass, className),
+			style: {
+				display: "block",
+				outline: "none",
+				border: "none",
+				height: "auto"
+			}
+		});
+		if (assets.logoDarkUrl === void 0) return image(assets.logoUrl, void 0, label);
+		return jsx(Fragment, { children: [image(assets.logoUrl, "dark:hidden!", label), jsx("div", {
+			className: "hidden dark:block!",
+			style: {
+				msoHide: "all",
+				maxHeight: 0,
+				overflow: "hidden"
+			},
+			children: image(assets.logoDarkUrl, void 0, "")
+		})] });
+	};
+	const BrandFooter = ({ unsubscribeLabel = "Unsubscribe", className }) => {
+		const rows = [];
+		if (footer.companyName !== void 0 && footer.companyName.trim() !== "") rows.push(row(jsx("span", {
+			className: "font-semibold",
+			children: footer.companyName
+		})));
+		if (footer.address !== void 0) {
+			const lines = addressLines(footer.address);
+			if (lines.length > 0) rows.push(row(lines.flatMap((line, index) => index === 0 ? [line] : [jsx("br", {}), line])));
+		}
+		const links = footer.socialLinks ?? [];
+		if (links.length > 0) rows.push(row(links.flatMap((link, index) => [...index === 0 ? [] : [" · "], jsx("a", {
+			href: link.url,
+			className: "text-gray-500 underline",
+			children: link.label
+		})])));
+		rows.push(row(unsubscribeLink(unsubscribeLabel), {
+			[UNSUBSCRIBE_ROW_ATTRIBUTE]: "",
+			[BRAND_FOOTER_MARKER]: true
+		}));
+		return jsx("table", {
+			role: "presentation",
+			width: "100%",
+			border: 0,
+			cellpadding: 0,
+			cellspacing: 0,
+			[FOOTER_ATTRIBUTE]: "",
+			[BRAND_FOOTER_MARKER]: true,
+			children: jsx("tbody", { children: jsx("tr", { children: jsx("td", {
+				align: "center",
+				className: classes("text-xs text-gray-500 text-center", className),
+				style: { padding: "32px 16px" },
+				children: jsx("table", {
+					role: "presentation",
+					border: 0,
+					cellpadding: 0,
+					cellspacing: 0,
+					children: jsx("tbody", { children: rows })
+				})
+			}) }) })
+		});
+	};
+	return {
+		BrandLogo,
+		BrandFooter
+	};
+};
+/**
+* The unsubscribe link. Its href is the placeholder, which no author-written
+* link may carry: the serializer accepts it only on this node, and marks it so
+* click tracking never rewrites it.
+*/
+const unsubscribeLink = (label) => jsx("a", {
+	href: UNSUBSCRIBE_URL_PLACEHOLDER,
+	className: "text-gray-500 underline",
+	[UNSUBSCRIBE_LINK]: true,
+	children: label
+});
+const UNSUBSCRIBE_ROW = new RegExp(`<tr ${UNSUBSCRIBE_ROW_ATTRIBUTE}=""[^>]*>[\\s\\S]*?</tr>`, "g");
+const UNSUBSCRIBE_HREF = `href="${UNSUBSCRIBE_URL_PLACEHOLDER}"`;
+/** Read the footer markers from rendered HTML. */
+const renderedFooterMarkers = (html) => ({
+	footer: html.includes(`${FOOTER_ATTRIBUTE}=""`),
+	unsubscribeLink: html.includes(UNSUBSCRIBE_HREF)
+});
+/**
+* Drop the unsubscribe row from a rendered message, for a send that resolved
+* no unsubscribe group: there is no link to put there, so the row goes.
+*/
+const withoutUnsubscribeRow = (rendered) => ({
+	html: rendered.html?.replace(UNSUBSCRIBE_ROW, ""),
+	text: rendered.text?.split("\n").filter((line) => !line.includes(UNSUBSCRIBE_URL_PLACEHOLDER)).join("\n")
+});
+//#endregion
+export { BRAND_COMPONENT_CLASSES, FOOTER_ATTRIBUTE, UNSUBSCRIBE_ROW_ATTRIBUTE, UNSUBSCRIBE_URL_PLACEHOLDER, brandComponents, renderedFooterMarkers, withoutUnsubscribeRow };
+
+//# sourceMappingURL=brand.js.map

package/dist/email/html.d.ts

@@ -1,42 +1,2 @@
-import { r as EmailDiagnostic } from "../diagnostics-BMYtBCQk.js";
-import { m as EmailNode } from "../elements-BzjjnoCS.js";
-import { EmittedPosition } from "./selection.js";
-//#region src/email/html.d.ts
-/** Escape a value for element content. */
-declare const escapeText: (value: string) => string;
-/** Escape a value for a double-quoted attribute. */
-declare const escapeAttribute: (value: string) => string;
-/** camelCase to kebab-case; already-kebab names pass through unchanged. */
-declare const kebab: (property: string) => string;
-/** A bare number is pixels for every property that takes a length. */
-declare const declarationValue: (property: string, value: string | number) => string;
-interface EmailHtmlOutput {
-  readonly html: string;
-  readonly diagnostics: readonly EmailDiagnostic[];
-  /**
-   * Each emitted element's offset range and origins. A compatibility finding
-   * carries a position in the emitted document, and this is what turns that
-   * back into the authoring element the author can edit.
-   */
-  readonly positions: readonly EmittedPosition[];
-}
-/** How this document will be consumed. Delivery is the default; export is opt-in. */
-interface SerializeEmailOptions {
-  /**
-   * Accept relative references. A local export serves assets from a relative
-   * base beside the file; a delivered message has no directory to resolve one
-   * against, so this stays off for anything that will be sent.
-   */
-  readonly relativeUrls?: boolean | undefined;
-  /**
-   * Stamp every element with its instance path, so an editor preview can
-   * resolve a click in the rendered document to exactly one rendered element.
-   * A delivered message never carries it.
-   */
-  readonly instancePaths?: boolean | undefined;
-}
-/** Lower the derived tree to email HTML, reporting every unsupported construct with its origin. */
-declare const serializeEmailHtml: (node: EmailNode, options?: SerializeEmailOptions) => EmailHtmlOutput;
-//#endregion
-export { EmailHtmlOutput, SerializeEmailOptions, declarationValue, escapeAttribute, escapeText, kebab, serializeEmailHtml };
-//# sourceMappingURL=html.d.ts.map
+import { a as escapeText, i as escapeAttribute, n as SerializeEmailOptions, o as kebab, r as declarationValue, s as serializeEmailHtml, t as EmailHtmlOutput } from "../html-Bl9BAdqc.js";
+export { EmailHtmlOutput, SerializeEmailOptions, declarationValue, escapeAttribute, escapeText, kebab, serializeEmailHtml };

package/dist/email/html.js

@@ -1,4 +1,5 @@
 import { n as isObject } from "../guards-eV1qLbf2.js";
+import { i as UNSUBSCRIBE_URL_PLACEHOLDER, n as RESERVED_FOOTER_ATTRIBUTES, r as UNSUBSCRIBE_LINK, t as BRAND_FOOTER_MARKER } from "../unsubscribe-link-CoesnQDU.js";
 import { EMAIL_ELEMENTS, EMAIL_GLOBAL_ATTRIBUTES, emailElement } from "./elements.js";
 import { INSTANCE_PATH_ATTRIBUTE } from "./selection.js";
 //#region src/email/html.ts
@@ -117,9 +118,15 @@ const attributes = (sink, tag, spec, props, origins) => {
 	const emitted = [];
 	const present = /* @__PURE__ */ new Set();
 	let classes;
+	const unsubscribeLink = tag === "a" && props[UNSUBSCRIBE_LINK] === true;
 	for (const [key, value] of Object.entries(props)) {
 		if (key === "key") continue;
 		const name = key === "className" ? "class" : key;
+		if (unsubscribeLink && name === "href" && value === "%samva:unsubscribe-url%") {
+			present.add(name);
+			emitted.push(` href="${UNSUBSCRIBE_URL_PLACEHOLDER}" ses:no-track`);
+			continue;
+		}
 		if (name === "class") {
 			if (value === void 0 || value === null) continue;
 			if (typeof value !== "string") {
@@ -148,6 +155,10 @@ const attributes = (sink, tag, spec, props, origins) => {
 			report(sink, "event-handler", `<${tag} ${name}> is an event handler; email clients strip scripting and Samva refuses it.`, origins);
 			continue;
 		}
+		if (RESERVED_FOOTER_ATTRIBUTES.has(name) && props[BRAND_FOOTER_MARKER] !== true) {
+			report(sink, "reserved-attribute", `<${tag} ${name}> is written only by BrandFooter from samva:brand; render BrandFooter instead of marking an element as the footer.`, origins);
+			continue;
+		}
 		if (/^(data|aria)-[a-z0-9-]+$/.test(name)) {
 			const text = attributeValue(sink, tag, name, { type: "string" }, value, origins);
 			if (text !== void 0) emitted.push(` ${name}="${escapeAttribute(text)}"`);

package/dist/email/render.d.ts

@@ -1,9 +1,9 @@
 import { r as EmailDiagnostic } from "../diagnostics-BMYtBCQk.js";
 import { m as EmailNode } from "../elements-BzjjnoCS.js";
-import { EmittedPosition } from "./selection.js";
-import { SerializeEmailOptions } from "./html.js";
-import { r as TemplateDefinition } from "../template-DWftqh4x.js";
-import { i as Stylesheet } from "../css-COcFOT1y.js";
+import { n as EmittedPosition } from "../selection-CCArx9lU.js";
+import { n as SerializeEmailOptions } from "../html-Bl9BAdqc.js";
+import { r as TemplateDefinition, t as EmailContent } from "../template-DWftqh4x.js";
+import { i as Stylesheet } from "../css-CS2jLID6.js";
 //#region src/email/render.d.ts
 /** Classic Outlook lays a document out correctly only under a transitional doctype. */
 declare const EMAIL_DOCTYPE = "<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">";
@@ -38,6 +38,13 @@ declare const renderEmail: <Input>(template: TemplateDefinition<Input>, data: un
  * loaded into the same process cannot restyle an entry that is rendered again.
  */
 declare const bindStylesheets: (stylesheet?: Stylesheet | undefined) => typeof renderEmail;
+/**
+ * Render authored content against a stylesheet: inline what a client honors,
+ * keep the rest for `<head>`, and lower to HTML and text. `renderEmail` runs a
+ * validated template through it; a host that composes content without a
+ * template definition calls it directly.
+ */
+declare const renderEmailContent: (stylesheet: Stylesheet | undefined, render: () => EmailContent, options?: SerializeEmailOptions) => RenderedEmail;
 //#endregion
-export { EMAIL_DOCTYPE, EmailCompileOutput, RenderedEmail, bindStylesheets, compileEmail, renderEmail };
+export { EMAIL_DOCTYPE, EmailCompileOutput, RenderedEmail, bindStylesheets, compileEmail, renderEmail, renderEmailContent };
 //# sourceMappingURL=render.d.ts.map

package/dist/email/render.js

@@ -1,6 +1,3 @@
-import { i as renderEmail, n as bindStylesheets, r as compileEmail, t as EMAIL_DOCTYPE } from "../render-aaJBnsXK.js";
-import "./html.js";
+import { a as renderEmailContent, i as renderEmail, n as bindStylesheets, r as compileEmail, t as EMAIL_DOCTYPE } from "../render-vAv_4r9v.js";
 import "./diagnostics.js";
-import "./stylesheets.js";
-import "./text.js";
-export { EMAIL_DOCTYPE, bindStylesheets, compileEmail, renderEmail };
+export { EMAIL_DOCTYPE, bindStylesheets, compileEmail, renderEmail, renderEmailContent };