@samva/markup 0.7.0 → 0.9.0

package/dist/email/brand-footer.js

@@ -0,0 +1,63 @@
+import { EmailCompileError } from "./diagnostics.js";
+import { c as parseBrandCss, i as brandTailwindCss } from "../theme-css-hFqcPSar.js";
+import { BRAND_COMPONENT_CLASSES, brandComponents, withoutUnsubscribeRow } from "./brand.js";
+import { t as applyStylesheet } from "../cascade-t6kxlgEI.js";
+import { a as parseStylesheet, t as compileTailwind } from "../tailwind-CMYpZf1v.js";
+import { compileEmail, renderEmailContent } from "./render.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-B-0bN_Ir.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 { i as UNSUBSCRIBE_URL_PLACEHOLDER, r as UNSUBSCRIBE_LINK, t as BRAND_FOOTER_MARKER } from "../unsubscribe-link-CoesnQDU.js";
+import { Fragment, jsx } from "./jsx-runtime.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/components.d.ts

@@ -1,4 +1,4 @@
-import { c as EmailStyle, f as EmailChild, m as EmailNode } from "../elements-BzjjnoCS.js";
+import { c as EmailStyle, f as EmailChild, m as EmailNode } from "../elements-cqldpaJt.js";
 //#region src/email/components.d.ts
 /** Marks the hidden preview block so the renderer can read it back and the text lane can keep it. */
 declare const PREHEADER_ATTRIBUTE = "data-samva-preheader";
@@ -9,8 +9,6 @@ interface EmailProps {
   readonly dir?: "ltr" | "rtl" | undefined;
   /** Document title; several clients use it as the fallback preview line. */
   readonly title?: string | undefined;
-  /** Hidden preview text shown in the inbox list next to the subject. */
-  readonly preheader?: string | undefined;
   readonly backgroundColor?: string | undefined;
   /** Applied to the content cell, where Yahoo and AOL keep body styling. */
   readonly style?: EmailStyle | undefined;
@@ -19,7 +17,7 @@ interface EmailProps {
 /** The hidden inbox preview block. Padding characters stop the client borrowing body copy. */
 declare const preheaderNode: (text: string) => EmailNode;
 /** Document shell: the head every target client needs, plus the body content cell. */
-declare const Email: ({ className, lang, dir, title, preheader, backgroundColor, style, children }: EmailProps) => EmailNode;
+declare const Email: ({ className, lang, dir, title, backgroundColor, style, children }: EmailProps) => EmailNode;
 interface SectionProps {
   /** CSS classes applied to the primitive's content element. */
   readonly className?: string | undefined;
@@ -33,17 +31,30 @@ interface SectionProps {
 }
 /** A full-width band of content, as the single-cell table every client agrees on. */
 declare const Section: ({ className, align, width, bgcolor, style, tableStyle, children }: SectionProps) => EmailNode;
-interface ColumnsProps {
+interface ColumnsProps<Item = never> {
   /** CSS classes applied to the primitive's content element. */
   readonly className?: string | undefined;
   readonly align?: "left" | "center" | "right" | undefined;
   readonly width?: number | string | undefined;
   readonly style?: EmailStyle | undefined;
-  /** `Column` elements; anything else is a content-model error. */
-  readonly children?: EmailChild;
+  /**
+   * Repeat the cells for each item: `children` is then a function from an item (and its index in
+   * the row) to a `Column`. Without `per` all items share one row.
+   */
+  readonly each?: readonly Item[] | undefined;
+  /** With `each`, the cells in a row; each chunk of items is its own `Columns` table. */
+  readonly per?: number | undefined;
+  /** `Column` elements, or with `each` a function that returns one. */
+  readonly children?: EmailChild | ((item: Item, index: number) => EmailChild);
 }
-/** A row of side-by-side `Column`s. No flex or grid conversion happens here. */
-declare const Columns: ({ className, align, width, style, children }: ColumnsProps) => EmailNode;
+/** The equal share of a row that each of `count` cells takes, whole percent rounded down. */
+declare const equalColumnWidth: (count: number) => string;
+/**
+ * A row of side-by-side `Column`s. No flex or grid conversion happens here. With `each` it repeats
+ * its cells over a list, `per` to a row, and splits the row equally between cells that state no
+ * width.
+ */
+declare const Columns: <Item = never>({ className, align, width, style, each, per, children }: ColumnsProps<Item>) => EmailNode;
 interface ColumnProps {
   /** CSS classes applied to the primitive's content element. */
   readonly className?: string | undefined;
@@ -121,5 +132,5 @@ interface LinkProps {
 /** A text link that opens outside the client and cannot reach back at the opener. */
 declare const Link: ({ className, href, target, rel, style, children }: LinkProps) => EmailNode;
 //#endregion
-export { Button, ButtonProps, Column, ColumnProps, Columns, ColumnsProps, Divider, DividerProps, Email, EmailProps, Image, ImageProps, Link, LinkProps, PREHEADER_ATTRIBUTE, Section, SectionProps, Spacer, SpacerProps, preheaderNode };
+export { Button, ButtonProps, Column, ColumnProps, Columns, ColumnsProps, Divider, DividerProps, Email, EmailProps, Image, ImageProps, Link, LinkProps, PREHEADER_ATTRIBUTE, Section, SectionProps, Spacer, SpacerProps, equalColumnWidth, preheaderNode };
 //# sourceMappingURL=components.d.ts.map

package/dist/email/components.js

@@ -1,4 +1,4 @@
-import { jsx, rawMarkup, reportEmailDiagnostic } from "./jsx-runtime.js";
+import { EmailNode, Fragment, jsx, normalizeChildren, rawMarkup, reportEmailDiagnostic } from "./jsx-runtime.js";
 import { escapeAttribute, escapeText } from "./html.js";
 //#region src/email/components.ts
 /** Marks the hidden preview block so the renderer can read it back and the text lane can keep it. */
@@ -34,7 +34,7 @@ const preheaderNode = (text) => jsx("div", {
 	})]
 });
 /** Document shell: the head every target client needs, plus the body content cell. */
-const Email = ({ className, lang = "en", dir = "ltr", title, preheader, backgroundColor, style, children }) => jsx("html", {
+const Email = ({ className, lang = "en", dir = "ltr", title, backgroundColor, style, children }) => jsx("html", {
 	lang,
 	dir,
 	xmlns: "http://www.w3.org/1999/xhtml",
@@ -66,7 +66,7 @@ const Email = ({ className, lang = "en", dir = "ltr", title, preheader, backgrou
 			padding: 0,
 			...backgroundColor === void 0 ? {} : { backgroundColor }
 		},
-		children: [preheader === void 0 ? null : preheaderNode(preheader), presentation({
+		children: [presentation({
 			align: "center",
 			width: "100%",
 			...backgroundColor === void 0 ? {} : { bgcolor: backgroundColor }
@@ -88,13 +88,48 @@ const Section = ({ className, align = "center", width = "100%", bgcolor, style,
 	...style === void 0 ? {} : { style },
 	children
 }));
-/** A row of side-by-side `Column`s. No flex or grid conversion happens here. */
-const Columns = ({ className, align = "center", width = "100%", style, children }) => presentation({
-	className,
-	align,
-	width,
-	...style === void 0 ? {} : { style }
-}, children, { style: { width: "100%" } });
+/** The equal share of a row that each of `count` cells takes, whole percent rounded down. */
+const equalColumnWidth = (count) => `${Math.floor(100 / count)}%`;
+/** Give a `Column` that states no width its equal share, keeping the primitive's attribute order. */
+const withColumnWidth = (node, width) => {
+	if (node.type === "Fragment") return EmailNode.Fragment({ children: node.children.map((child) => withColumnWidth(child, width)) });
+	if (node.type !== "Element" || node.tag !== "td" || node.props.width !== void 0) return node;
+	const props = {};
+	for (const [key, value] of Object.entries(node.props)) {
+		if (key === "style") props.width = width;
+		props[key] = value;
+	}
+	if (props.width === void 0) props.width = width;
+	return EmailNode.Element({
+		...node,
+		props
+	});
+};
+/**
+* A row of side-by-side `Column`s. No flex or grid conversion happens here. With `each` it repeats
+* its cells over a list, `per` to a row, and splits the row equally between cells that state no
+* width.
+*/
+const Columns = ({ className, align = "center", width = "100%", style, each, per, children }) => {
+	const table = {
+		className,
+		align,
+		width,
+		...style === void 0 ? {} : { style }
+	};
+	if (each === void 0 || typeof children !== "function") return presentation(table, children, { style: { width: "100%" } });
+	if (per !== void 0 && (!Number.isInteger(per) || per < 1)) reportEmailDiagnostic({
+		code: "invalid-columns-per",
+		severity: "error",
+		message: "<Columns per> must be a positive integer."
+	});
+	const size = per !== void 0 && Number.isInteger(per) && per >= 1 ? per : void 0;
+	const chunks = [];
+	if (size === void 0) chunks.push(each);
+	else for (let at = 0; at < each.length; at += size) chunks.push(each.slice(at, at + size));
+	const share = equalColumnWidth(size ?? Math.max(each.length, 1));
+	return jsx(Fragment, { children: chunks.map((chunk) => presentation(table, chunk.flatMap((item, index) => normalizeChildren(children(item, index)).map((cell) => withColumnWidth(cell, share))), { style: { width: "100%" } })) });
+};
 /** One cell of a `Columns` row. */
 const Column = ({ className, align, valign, width, style, children }) => jsx("td", {
 	className,
@@ -235,6 +270,6 @@ const Link = ({ className, href, target = "_blank", rel = "noopener noreferrer",
 	children
 });
 //#endregion
-export { Button, Column, Columns, Divider, Email, Image, Link, PREHEADER_ATTRIBUTE, Section, Spacer, preheaderNode };
+export { Button, Column, Columns, Divider, Email, Image, Link, PREHEADER_ATTRIBUTE, Section, Spacer, equalColumnWidth, preheaderNode };
 
 //# sourceMappingURL=components.js.map

package/dist/email/diagnostics.d.ts

@@ -1,2 +1,2 @@
-import { a as formatEmailDiagnostic, i as EmailDiagnosticSeverity, n as EmailCompileError, o as hasBlockingDiagnostic, r as EmailDiagnostic, t as EmailCompatibilityAssessment } from "../diagnostics-BMYtBCQk.js";
-export { EmailCompatibilityAssessment, EmailCompileError, EmailDiagnostic, EmailDiagnosticSeverity, formatEmailDiagnostic, hasBlockingDiagnostic };
+import { a as TemplateDiagnostic, i as EmailDiagnosticSeverity, n as EmailCompileError, o as formatEmailDiagnostic, r as EmailDiagnostic, s as hasBlockingDiagnostic, t as EmailCompatibilityAssessment } from "../diagnostics-B-Gym34R.js";
+export { EmailCompatibilityAssessment, EmailCompileError, EmailDiagnostic, EmailDiagnosticSeverity, TemplateDiagnostic, formatEmailDiagnostic, hasBlockingDiagnostic };

package/dist/email/diagnostics.js

@@ -11,7 +11,8 @@ var EmailCompileError = class extends TaggedError("EmailCompileError") {
 /** `emails/welcome.tsx:12:3 unsupported-element: …` — the shape agents iterate on. */
 const formatEmailDiagnostic = (diagnostic) => {
 	const origin = diagnostic.origins[0];
-	return `${origin === void 0 ? "<unknown source>" : `${origin.fileName}:${origin.lineNumber}:${origin.columnNumber}`} ${diagnostic.code}: ${diagnostic.message}`;
+	const head = `${origin === void 0 ? "<unknown source>" : `${origin.fileName}:${origin.lineNumber}:${origin.columnNumber}`} ${diagnostic.code}: ${diagnostic.message}`;
+	return diagnostic.fix === void 0 ? head : `${head}\n  Fix: ${diagnostic.fix}`;
 };
 /** True when a set of findings must stop the compile or refuse a publication. */
 const hasBlockingDiagnostic = (diagnostics) => diagnostics.some((diagnostic) => diagnostic.severity === "error");

package/dist/email/elements.d.ts

@@ -1,2 +1,2 @@
-import { a as EmailGlobalProps, c as EmailStyle, d as isUrlAttribute, i as EmailElementSpec, l as EmailTag, n as EMAIL_GLOBAL_ATTRIBUTES, o as EmailIntrinsicElements, r as EmailAttributeSpec, s as EmailLayout, t as EMAIL_ELEMENTS, u as emailElement } from "../elements-BzjjnoCS.js";
+import { a as EmailGlobalProps, c as EmailStyle, d as isUrlAttribute, i as EmailElementSpec, l as EmailTag, n as EMAIL_GLOBAL_ATTRIBUTES, o as EmailIntrinsicElements, r as EmailAttributeSpec, s as EmailLayout, t as EMAIL_ELEMENTS, u as emailElement } from "../elements-cqldpaJt.js";
 export { EMAIL_ELEMENTS, EMAIL_GLOBAL_ATTRIBUTES, EmailAttributeSpec, EmailElementSpec, EmailGlobalProps, EmailIntrinsicElements, EmailLayout, EmailStyle, EmailTag, emailElement, isUrlAttribute };

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 escapeAttribute, c as serializeEmailHtml, i as declarationValue, l as serializeStyle, n as SerializeEmailOptions, o as escapeText, r as checkAttribute, s as kebab, t as EmailHtmlOutput } from "../html-BJepOwZ4.js";
+export { EmailHtmlOutput, SerializeEmailOptions, checkAttribute, declarationValue, escapeAttribute, escapeText, kebab, serializeEmailHtml, serializeStyle };

package/dist/email/html.js

@@ -1,6 +1,7 @@
 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";
+import { INSTANCE_PATH_ATTRIBUTE } from "../preview.js";
 //#region src/email/html.ts
 /** Escape a value for element content. */
 const escapeText = (value) => value.replace(/[&<>]/g, (character) => ({
@@ -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)}"`);
@@ -261,7 +272,50 @@ const serializeEmailHtml = (node, options = {}) => {
 		positions: sink.positions
 	};
 };
+/** An authored style object as a declaration list, checked by the same rules as a serialized tree. */
+const serializeStyle = (style, origins) => {
+	const sink = {
+		diagnostics: [],
+		positions: [],
+		written: 0,
+		relativeUrls: false,
+		instancePaths: false
+	};
+	return {
+		css: declarations(sink, style, origins),
+		diagnostics: sink.diagnostics
+	};
+};
+/**
+* Check one static attribute value against its element's spec, as serialization does. Returns
+* the text that would be emitted, or `undefined` when the attribute is dropped or invalid.
+*/
+const checkAttribute = (tag, name, value, origins) => {
+	const sink = {
+		diagnostics: [],
+		positions: [],
+		written: 0,
+		relativeUrls: false,
+		instancePaths: false
+	};
+	const element = emailElement(tag);
+	const globals = EMAIL_GLOBAL_ATTRIBUTES;
+	const attributeSpec = () => {
+		if (/^(data|aria)-[a-z0-9-]+$/.test(name)) return { type: "string" };
+		if (Object.hasOwn(globals, name)) return globals[name];
+		if (element !== void 0 && Object.hasOwn(element.attributes, name)) return element.attributes[name];
+	};
+	const spec = attributeSpec();
+	if (spec === void 0) return {
+		text: void 0,
+		diagnostics: sink.diagnostics
+	};
+	return {
+		text: attributeValue(sink, tag, name, spec, value, origins),
+		diagnostics: sink.diagnostics
+	};
+};
 //#endregion
-export { declarationValue, escapeAttribute, escapeText, kebab, serializeEmailHtml };
+export { checkAttribute, declarationValue, escapeAttribute, escapeText, kebab, serializeEmailHtml, serializeStyle };
 
 //# sourceMappingURL=html.js.map

package/dist/email/jsx-dev-runtime.d.ts

@@ -1,5 +1,5 @@
-import { r as JsxSource } from "../source-locations-DrCM82Ym.js";
-import { g as JSX, h as Fragment, m as EmailNode, p as EmailComponent } from "../elements-BzjjnoCS.js";
+import { n as JsxSource } from "../source-locations-C8wCsiAy.js";
+import { g as JSX, h as Fragment, m as EmailNode, p as EmailComponent } from "../elements-cqldpaJt.js";
 //#region src/email/jsx-dev-runtime.d.ts
 /** Development JSX retains compiler-provided origins directly on the semantic tree. */
 declare const jsxDEV: (type: string | EmailComponent<Record<string, unknown>> | typeof Fragment, props: Record<string, unknown> | null, _key?: unknown, _staticChildren?: boolean, source?: JsxSource) => EmailNode;

package/dist/email/jsx-runtime.d.ts

@@ -1,2 +1,2 @@
-import { C as reportEmailDiagnostic, S as rawMarkup, _ as currentEmailOrigins, b as jsxs, f as EmailChild, g as JSX, h as Fragment, m as EmailNode, p as EmailComponent, v as drainEmailDiagnostics, x as normalizeChildren, y as jsx } from "../elements-BzjjnoCS.js";
+import { C as reportEmailDiagnostic, S as rawMarkup, _ as currentEmailOrigins, b as jsxs, f as EmailChild, g as JSX, h as Fragment, m as EmailNode, p as EmailComponent, v as drainEmailDiagnostics, x as normalizeChildren, y as jsx } from "../elements-cqldpaJt.js";
 export { EmailChild, EmailComponent, EmailNode, Fragment, JSX, currentEmailOrigins, drainEmailDiagnostics, jsx, jsxs, normalizeChildren, rawMarkup, reportEmailDiagnostic };

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 { r as EmailDiagnostic } from "../diagnostics-B-Gym34R.js";
+import { m as EmailNode } from "../elements-cqldpaJt.js";
+import { n as EmittedPosition } from "../preview-Ekdg1dXG.js";
+import { n as SerializeEmailOptions } from "../html-BJepOwZ4.js";
+import { n as EmailContent } from "../template-_QE_rQND.js";
+import { i as Stylesheet } from "../css-BVQKICKC.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\">";
@@ -30,14 +30,11 @@ interface RenderedEmail {
   readonly diagnostics: readonly EmailDiagnostic[];
   readonly positions: readonly EmittedPosition[];
 }
-/** Render one validated input through the template's only content function. Host isolation is required for untrusted source. */
-declare const renderEmail: <Input>(template: TemplateDefinition<Input>, data: unknown, options?: SerializeEmailOptions) => RenderedEmail;
 /**
- * A render bound to the sheets registered so far. A compiled project's wrapper
- * calls this once its own stylesheet imports have run, so a later project
- * loaded into the same process cannot restyle an entry that is rendered again.
+ * Render authored content against a stylesheet: inline what a client honors,
+ * keep the rest for `<head>`, and lower to HTML and text.
  */
-declare const bindStylesheets: (stylesheet?: Stylesheet | undefined) => typeof renderEmail;
+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, compileEmail, renderEmailContent };
 //# sourceMappingURL=render.d.ts.map