@samva/markup 0.15.1 → 0.17.0

package/dist/compiler.js

@@ -1,1212 +1,19 @@
 import { n as isObject } from "./guards-eV1qLbf2.js";
 import { n as TEMPLATE_NAME_PATTERN } from "./template-zLUjcwfF.js";
-import { D as samvaBrandPlugin, T as parseBrandSpecifier, _ as renderIr, w as brandSpecifierPattern } from "./html-BvRFepeO.js";
-import { m as PRIMITIVE_CSS } from "./components-3XHjYD3i.js";
-import { c as foregroundDefaults, d as downlevelColors, f as formatColor, l as parseBrandCss, n as DEFAULT_THEME_CSS, p as parseColor, u as printBrandCss } from "./theme-css-s9QwD5Ko.js";
-import { n as isDarkSchemeCondition, r as isDarkSchemeQuery, t as DARK_SCHEME_MEDIA } from "./dark-scheme-CbCwGDWH.js";
-import { a as downlevelMediaQuery, c as renderHeadCss, d as matchesSelector, f as unquote, i as renderDarkRules, l as resolveVariables, o as finalizeValue, r as applyStylesheet, s as foldCalc, u as classListOf } from "./ir-DNL6H7jA.js";
-import { i as buildLineMap, s as lineColumn } from "./diagnostic-codes-UXwOO3A-.js";
-import { a as lowerProject, d as resolveFromDirectory, f as resolveThemeImports, i as completed, l as Findings, n as introducedProfileErrors, r as loadProject, t as checkStaticProfile, u as projectDirectory } from "./profile-AatO_SvP.js";
-import { c as checkAssetBase, i as withoutUnsubscribeRow, l as isAssetPath, n as brandComponents, o as assetEntry, s as assetUrl, t as BRAND_COMPONENT_CLASSES } from "./brand-nreeKWxF.js";
-import { t as EmailCompileError } from "./diagnostics-C0Tr8-eQ.js";
-import { n as compileEmail, r as renderEmailContent } from "./render-DpYouYYG.js";
-import { caniemail, parseHtml, rawData } from "caniemail";
-import { generate, ident, parse, walk } from "css-tree";
+import { o as serializeEmailHtml } from "./html-DJUK2YJF.js";
+import { f as samvaBrandPlugin, l as brandSpecifierPattern, n as render, s as emailElement, t as RenderError, u as parseBrandSpecifier } from "./render-template-DwPDm3Hq.js";
+import { r as collectEmailDiagnostics } from "./jsx-runtime-qL19u3Fy.js";
+import { m as PRIMITIVE_CSS } from "./components-C5850-Qg.js";
+import { c as checkAssetBase, l as isAssetPath, n as brandComponents, o as assetEntry, s as assetUrl, t as BRAND_COMPONENT_CLASSES } from "./brand-CIiEqkU7.js";
+import { r as hasBlockingDiagnostic, t as EmailCompileError } from "./diagnostics-C0Tr8-eQ.js";
+import { i as buildLineMap, s as lineColumn } from "./diagnostic-codes-DZKb0Xcg.js";
+import { r as isDarkSchemeQuery, t as DARK_SCHEME_MEDIA } from "./dark-scheme-CbCwGDWH.js";
+import { c as foregroundDefaults, l as parseBrandCss, n as DEFAULT_THEME_CSS, u as printBrandCss } from "./theme-css-P9F5S7Ic.js";
+import { t as parseStylesheet } from "./css-B_aVKrDo.js";
+import { a as lowerProject, d as Findings, f as projectDirectory, i as completed, m as resolveThemeImports, n as introducedErrors, o as applyStylesheet, p as resolveFromDirectory, r as loadProject, s as renderDarkRules, t as checkTemplate } from "./profile-JTvgCD6X.js";
+import { parse } from "css-tree";
 import { parse as parse$1 } from "@babel/parser";
 import { compile } from "tailwindcss";
-//#region src/email/compatibility-assessment.ts
-const VERIFIED_VALUES = /^(?:left|right|center|justify)$/i;
-const SIMPLE_COLOR = /^(?:#[\da-f]{3,8}|rgba?\([^()]+\)|transparent|white|black)$/i;
-/**
-* A feature matrix establishes support, not the effect on a particular message.
-* These rules interpret the pinned caniemail@2.0.2 limitations using emitted
-* values. Unresolved layout, fallback and client-account behavior stays unverified.
-*/
-const assessCompatibility = (title, client, support, context, blocking) => {
-	const result = (assessment, heading, explanation) => ({
-		assessment,
-		title: heading,
-		explanation
-	});
-	if (client === "outlook.windows" && support === "partial" && (title === "display" || title === "display:none") && context.hiddenContentOffsets.length > 0) return result("risk", "Hidden content becomes visible in classic Outlook", "Classic Outlook ignores display:none on images and does not inherit it onto nested tables. The emitted inline styles contain hidden content without a resolved hiding fallback. Add a supported hiding fallback before publishing.");
-	if (blocking) return result("risk", `${title} is unavailable in a target client`, "This construct is required for message content, structure or navigation. Replace it with a supported construct before publishing.");
-	const explained = context.explanation(title, client, support);
-	if (explained !== void 0) return result(title.startsWith("system-ui,") ? "degradation" : "not-applicable", title.startsWith("system-ui,") ? "A fallback font will be used" : `${title}: limitation avoided`, explained);
-	const declarations = (property) => context.declarations(property);
-	const every = (property, predicate) => {
-		const values = declarations(property);
-		return context.complete && values.length > 0 && values.every(({ value }) => predicate(value));
-	};
-	const attributesAvoid = (attribute, unsupportedElement) => {
-		const values = context.attributes(attribute);
-		return values.length > 0 && values.every(({ element }) => element !== unsupportedElement);
-	};
-	if (title === "font-size" && support === "partial" && ["outlook.windows", "yahoo.desktop-webmail"].includes(client) && declarations("font-size").some(({ value }) => /\d(?:\.\d+)?rem\b/i.test(value))) return result("risk", "Text sizes use unsupported rem units", "These clients cannot apply the emitted rem font sizes. Use pixel sizes to preserve the intended text size.");
-	if (title === "target attribute" && context.attributes("target").some(({ value }) => value !== "_blank")) return result("risk", "Links cannot keep the requested window target", "These clients open links in a new window regardless of the requested target. Use a new-window target or remove the dependency on another browsing context.");
-	if (title.startsWith("system-ui,") && declarations("font-family").some(({ value }) => !/(?:^|,)\s*(?:sans-serif|serif|monospace)\s*$/i.test(value))) return result("risk", "An unsupported font stack has no generic fallback", "Declare a generic fallback so the client has an explicit font choice when the requested system font is unavailable.");
-	if (title === "border-radius" && support !== "partial") return result("degradation", "Corners may appear square", "CSS corner rounding is unavailable in this client. Uncovered elements appear square; a separate VML shape can retain rounding. This finding does not establish a content or navigation failure.");
-	if (title === "border-radius" && client === "yahoo.desktop-webmail" && support === "partial") return result("degradation", "Corner shapes may differ", "This client does not support elliptical slash syntax. Review the recorded values if that corner shape is part of the intended design.");
-	if (title === "background") {
-		const values = [...declarations("background"), ...declarations("background-color")];
-		if (context.complete && values.length > 0 && values.every(({ value }) => SIMPLE_COLOR.test(value)) && declarations("background-image").every(({ value }) => value.toLowerCase() === "none")) return result("not-applicable", "Backgrounds use supported color values", "The emitted backgrounds use simple colors. The cited multiple-background and background-size shorthand limitations do not apply.");
-	}
-	if (title === "dir attribute" && client === "outlook.windows" && attributesAvoid("dir", "a")) return result("not-applicable", "Direction is set outside links", "The cited direction bug affects anchor elements. No emitted anchor carries a dir attribute.");
-	if (title === "lang attribute" && client === "yahoo.desktop-webmail" && attributesAvoid("lang", "td")) return result("not-applicable", "Language is set outside table cells", "The cited language-attribute limitation affects table cells. No emitted td carries a lang attribute.");
-	if (title === "role attribute" && client === "yahoo.desktop-webmail" && context.attributes("role").length > 0 && context.attributes("role").every(({ element }) => element === "table")) return result("not-applicable", "Roles are applied to supported tables", "Every emitted role attribute is on a table, matching this client's supported element scope.");
-	if (title === "text-align" && support === "partial" && every("text-align", (value) => VERIFIED_VALUES.test(value))) return result("not-applicable", "Text uses supported alignment values", "The emitted alignment values do not use match-parent or flow-relative start/end values.");
-	if (title === "font-weight" && support === "partial") {
-		const pattern = client === "outlook.windows" ? /^(?:normal|bold|400|700)$/i : /^(?:normal|bold|[1-9]00)$/i;
-		if (every("font-weight", (value) => pattern.test(value))) return result("not-applicable", "Font weights avoid the numeric limitation", "The emitted weights use values preserved by this client's pinned numeric-weight rule.");
-		return result("degradation", "Font weight may be approximated", "This client may substitute a supported weight. Text remains present, but its emphasis can look different.");
-	}
-	if (title === "outline" && every("outline", (value) => value === "none" || value === "0")) return result("unverified", "Image outlines need a client check", "The emitted styles remove outlines. The matrix cannot establish whether this client adds its own link or image outline.");
-	if (title === "width attribute" && client === "outlook.windows" && context.attributes(title.split(" ")[0]).some(({ value, element }) => element === "img" && value.includes("%"))) return result("risk", "Percentage image dimensions use the wrong reference size", "Classic Outlook sizes percentage image attributes against the image file rather than its parent. Use fixed image dimensions with an appropriate responsive fallback.");
-	if (title === "overflow" && declarations("overflow").some(({ value }) => /^(?:auto|scroll)$/i.test(value))) return result("risk", "Scrollable content may be inaccessible", "These clients cannot reliably expose content hidden behind a scrolling container. Keep required email content visible without scrolling inside an element.");
-	return result("unverified", {
-		"<body> element": "Body styling needs a client check",
-		border: "Borders need an Outlook check",
-		"color-scheme meta tag": "Dark appearance needs a client check",
-		display: "Display behavior needs a client check",
-		"display:none": "Hidden content needs an Outlook check",
-		"height attribute": "Image sizing needs a high-DPI Outlook check",
-		"height property": "Element heights need a client check",
-		"line-height": "Line spacing needs an Outlook check",
-		margin: "Outer spacing needs a client check",
-		"max-height property": "Height limits need an Outlook check",
-		"max-width": "Width limits need a client check",
-		"@media": "Conditional styles need a client check",
-		opacity: "Transparent content needs an Outlook check",
-		overflow: "Clipped content needs a client check",
-		"overflow-wrap": "Long text wrapping needs a client check",
-		padding: "Cell spacing needs an Outlook check",
-		"<style> element": "Retained styles need a client check",
-		"text-decoration": "Link decoration needs a client check",
-		"width attribute": "Image sizing needs a high-DPI Outlook check",
-		"width property": "Element widths need an Outlook check",
-		"word-break": "Word breaking needs a client check"
-	}[title] ?? `${title} needs a client check`, "The feature matrix identifies a support difference but does not establish its effect on this message. Check the affected fixtures in the listed clients before relying on this behavior; no automatic source change is justified by this observation alone.");
-};
-//#endregion
-//#region src/email/compatibility-context.ts
-const NON_HIDING_VALUES = {
-	"mso-hide": /^none$/,
-	visibility: /^visible$/,
-	opacity: /^(?:1(?:\.0+)?|100(?:\.0+)?%)$/,
-	overflow: /^visible$/,
-	"overflow-y": /^visible$/,
-	"overflow-x": /^visible$/,
-	clip: /^auto$/,
-	"clip-path": /^none$/
-};
-const POSITIVE_FIXED_HEIGHT = /^(?:\d+(?:\.\d+)?|\.\d+)(?:px|pt|pc|in|cm|mm)$/;
-/** Evidence from actual declarations and elements, never a text match in email content. */
-const compatibilityContext = (html, css) => {
-	const declarations = /* @__PURE__ */ new Map();
-	const attributes = /* @__PURE__ */ new Map();
-	const elements = /* @__PURE__ */ new Map();
-	let complete = true;
-	let unresolvedStyles = false;
-	const hiddenContentOffsets = [];
-	const addCss = (source, context, offset, element) => {
-		const inline = /* @__PURE__ */ new Map();
-		if (context === "stylesheet" && source.trim() !== "") unresolvedStyles = true;
-		try {
-			const ast = parse(source, { context });
-			walk(ast, (node) => {
-				if (node.type === "Raw") complete = false;
-				if (node.type !== "Declaration") return;
-				const property = node.property.toLowerCase();
-				const entries = declarations.get(property) ?? [];
-				const value = generate(node.value);
-				entries.push({
-					value,
-					offset,
-					element
-				});
-				if (!inline.get(property)?.important || node.important) inline.set(property, {
-					value: value.toLowerCase(),
-					important: Boolean(node.important)
-				});
-				declarations.set(property, entries);
-			});
-		} catch {
-			complete = false;
-		}
-		return inline;
-	};
-	const { document } = parseHtml(html);
-	const visit = (node, ancestors = []) => {
-		let descendants = ancestors;
-		if (node.type === "comment" && /\[if\b/i.test(node.data)) unresolvedStyles = true;
-		if ("attribs" in node) {
-			const offset = node.startIndex ?? void 0;
-			if (offset !== void 0) {
-				const entries = elements.get(node.name) ?? [];
-				entries.push(offset);
-				elements.set(node.name, entries);
-			}
-			for (const [name, value] of Object.entries(node.attribs)) {
-				const entries = attributes.get(name) ?? [];
-				entries.push({
-					value,
-					offset,
-					element: node.name
-				});
-				attributes.set(name, entries);
-			}
-			const styles = node.attribs.style === void 0 ? /* @__PURE__ */ new Map() : addCss(node.attribs.style, "declarationList", offset, node.name);
-			descendants = [...ancestors, {
-				offset,
-				styles
-			}];
-			const fallback = descendants.some(({ styles: candidate }) => {
-				const candidateDisplay = candidate.get("display")?.value;
-				return candidateDisplay !== void 0 && !/^(?:none|block|inline|inline-block|table|table-row|table-cell|table-row-group)$/i.test(candidateDisplay) || candidate.has("all") || Object.entries(NON_HIDING_VALUES).some(([property, neutral]) => {
-					const value = candidate.get(property)?.value;
-					return value !== void 0 && !neutral.test(value);
-				}) || ["height", "max-height"].some((property) => {
-					const value = candidate.get(property)?.value;
-					return value !== void 0 && value !== (property === "height" ? "auto" : "none") && !(POSITIVE_FIXED_HEIGHT.test(value) && Number.parseFloat(value) > 0);
-				});
-			});
-			const hiddenAncestor = ancestors.find(({ styles: candidate }) => candidate.get("display")?.value === "none");
-			const display = styles.get("display")?.value;
-			if (!fallback && node.name === "img" && display === "none" && hiddenAncestor === void 0 && offset !== void 0) hiddenContentOffsets.push(offset);
-			if (!fallback && node.name === "table" && hiddenAncestor !== void 0 && display === void 0 && hiddenAncestor.offset !== void 0) hiddenContentOffsets.push(hiddenAncestor.offset);
-			if (node.name === "style") {
-				for (const child of node.children) if (child.type === "text") addCss(child.data, "stylesheet");
-			}
-		}
-		if ("children" in node) for (const child of node.children) visit(child, descendants);
-	};
-	for (const child of document.children) visit(child);
-	if (css !== void 0) addCss(css, "stylesheet");
-	const everyValue = (property, predicate) => {
-		const entries = declarations.get(property);
-		return complete && entries !== void 0 && entries.length > 0 && entries.every(({ value }) => predicate(value));
-	};
-	return {
-		/** Known hidden-content failures; unresolved cascade or fallback evidence cannot block. */
-		get hiddenContentOffsets() {
-			return complete && !unresolvedStyles ? [...new Set(hiddenContentOffsets)] : [];
-		},
-		/** Incomplete CSS cannot prove that every occurrence avoids a limitation. */
-		get complete() {
-			return complete;
-		},
-		declarations(property) {
-			return declarations.get(property) ?? [];
-		},
-		attributes(name) {
-			return attributes.get(name) ?? [];
-		},
-		/** Bounded exceptions to caniemail@2.0.2's feature-wide matrix, tied to its client rules. */
-		explanation(title, client, support) {
-			if (title === "font-size" && support === "partial" && ["outlook.windows", "yahoo.desktop-webmail"].includes(client) && everyValue("font-size", (value) => /^(?:0|(?:\d+(?:\.\d+)?|\.\d+)px)$/i.test(value))) return "All font sizes use pixels; this client's rem-unit limitation does not apply.";
-			if (title === "border-radius" && support === "partial" && client === "yahoo.desktop-webmail" && everyValue("border-radius", (value) => /^(?:0|(?:\d+(?:\.\d+)?|\.\d+)(?:px|%))(?:\s+(?:0|(?:\d+(?:\.\d+)?|\.\d+)(?:px|%))){0,3}$/i.test(value))) return "These corner radii do not use the unsupported elliptical slash syntax.";
-			if (title === "target attribute" && [
-				"gmail.desktop-webmail",
-				"gmail.ios",
-				"gmail.android",
-				"outlook.outlook-com",
-				"yahoo.desktop-webmail",
-				"outlook.windows",
-				"apple-mail.macos",
-				"apple-mail.ios"
-			].includes(client) && attributes.has("target") && attributes.get("target").every(({ value }) => value === "_blank")) return "Links already request a new window, matching the client's enforced behavior.";
-			if (title === "system-ui, ui-serif, ui-sans-serif, ui-rounded, ui-monospace" && everyValue("font-family", (value) => /(?:^|,)\s*(?:sans-serif|serif|monospace)\s*$/i.test(value))) return "Every font stack ends with a generic fallback. Font appearance can differ in this client.";
-		},
-		offsets(title) {
-			const element = /^<([a-z0-9]+)> element$/i.exec(title);
-			if (element !== null) return elements.get(element[1]) ?? [];
-			const attribute = /^([a-z-]+) attribute$/i.exec(title);
-			const entries = attribute !== null ? attributes.get(attribute[1]) : declarations.get(title.startsWith("system-ui,") ? "font-family" : title.replace(/ property$/, ""));
-			return [...new Set(entries?.flatMap(({ offset }) => offset === void 0 ? [] : [offset]) ?? [])];
-		}
-	};
-};
-//#endregion
-//#region src/email/fonts.ts
-const FONT_FILE = /\.woff2$/i;
-const WOFF2_FORMAT = /^woff2(?:-variations)?$/i;
-const SCHEME = /^[a-z][a-z0-9+.-]*:/i;
-const declarationValue = (declaration) => declaration.type === "Declaration" ? generate(declaration.value).trim() : "";
-/**
-* Validate one `@font-face` and rewrite its project-relative `src` URLs.
-* Accepts only WOFF2: a relative URL must name a `.woff2` file the project has,
-* and an `https:` URL stays an external reference. `local()` entries pass.
-*/
-const compileFontFace = (node, origin, resolve) => {
-	const diagnostics = [];
-	const fail = (code, message) => diagnostics.push({
-		code,
-		severity: "error",
-		message: `${origin}: ${message}`,
-		origins: []
-	});
-	if (node.type !== "Atrule" || node.block === null || node.block.children === null) return {
-		rule: void 0,
-		diagnostics
-	};
-	let family;
-	let sources = 0;
-	for (const declaration of node.block.children) {
-		if (declaration.type !== "Declaration") continue;
-		const property = declaration.property.toLowerCase();
-		if (property === "font-family") family = unquote(declarationValue(declaration));
-		if (property !== "src") continue;
-		const authored = declarationValue(declaration);
-		let value;
-		try {
-			value = parse(authored, { context: "value" });
-		} catch {
-			fail("email-font-src", "@font-face src could not be parsed.");
-			continue;
-		}
-		walk(value, { enter: (part) => {
-			if (part.type === "Function" && part.name.toLowerCase() === "format") {
-				const format = unquote(generate(part).slice(7, -1));
-				if (!WOFF2_FORMAT.test(format)) fail("email-font-format", `@font-face format(${format}) is not supported. Email fonts are WOFF2 only; convert the file to .woff2.`);
-				return;
-			}
-			if (part.type !== "Url") return;
-			sources++;
-			const reference = part.value;
-			const path = reference.replace(/[?#].*$/, "");
-			if (/^https:\/\//i.test(reference)) {
-				if (!FONT_FILE.test(path) && !/format\(\s*['"]?woff2/i.test(generate(value))) fail("email-font-format", `@font-face src ${JSON.stringify(reference)} is not a WOFF2 file. Email fonts are WOFF2 only.`);
-				return;
-			}
-			if (SCHEME.test(reference) || reference.startsWith("//")) {
-				fail("email-font-src", `@font-face src ${JSON.stringify(reference)} must be a project .woff2 file or an https URL.`);
-				return;
-			}
-			if (!FONT_FILE.test(path)) {
-				fail("email-font-format", `@font-face src ${JSON.stringify(reference)} is not a .woff2 file. Email fonts are WOFF2 only; convert the file to .woff2.`);
-				return;
-			}
-			const url = resolve?.(reference);
-			if (url === void 0) {
-				fail("email-font-missing", `@font-face src ${JSON.stringify(reference)} names no file in the project. Paths resolve from the stylesheet's own directory.`);
-				return;
-			}
-			part.value = url;
-		} });
-		declaration.value = {
-			type: "Raw",
-			value: generate(value).replace(/\)(?=(?:format|tech)\()/gi, ") ")
-		};
-	}
-	if (family === void 0 || family === "") fail("email-font-family", "@font-face declares no font-family.");
-	if (sources === 0) fail("email-font-src", "@font-face declares no url() src.");
-	if (diagnostics.length > 0 || family === void 0) return {
-		rule: void 0,
-		diagnostics
-	};
-	return {
-		rule: {
-			family,
-			css: generate(node)
-		},
-		diagnostics
-	};
-};
-//#endregion
-//#region src/email/css.ts
-const UNLAYERED = Number.MAX_SAFE_INTEGER;
-const CONDITIONAL_AT_RULES = /* @__PURE__ */ new Set([
-	"media",
-	"supports",
-	"container"
-]);
-const HEAD_AT_RULES = /* @__PURE__ */ new Set([
-	"page",
-	"counter-style",
-	"keyframes"
-]);
-const ROOT_SELECTORS = /* @__PURE__ */ new Set([
-	":root",
-	":host",
-	"html",
-	"*",
-	":where(:root)"
-]);
-const text = (node) => node === null || node === void 0 ? "" : generate(node);
-/** The CSS specificity triple for one selector, ignoring the parts email clients drop. */
-const specificityOf = (selector) => {
-	let id = 0;
-	let cls = 0;
-	let type = 0;
-	const visit = (node) => {
-		switch (node.type) {
-			case "IdSelector":
-				id += 1;
-				break;
-			case "ClassSelector":
-			case "AttributeSelector":
-				cls += 1;
-				break;
-			case "PseudoClassSelector":
-				if (node.name !== "where") cls += 1;
-				break;
-			case "TypeSelector":
-				if (node.name !== "*") type += 1;
-				break;
-			case "PseudoElementSelector": type += 1;
-		}
-		if ("children" in node && node.children !== null && node.children !== void 0) for (const child of node.children) visit(child);
-	};
-	visit(selector);
-	return [
-		id,
-		cls,
-		type
-	];
-};
-const hasPseudo = (selector) => {
-	let found = false;
-	const visit = (node) => {
-		if (node.type === "PseudoClassSelector" || node.type === "PseudoElementSelector") found = true;
-		if ("children" in node && node.children !== null && node.children !== void 0) for (const child of node.children) visit(child);
-	};
-	visit(selector);
-	return found;
-};
-const COMBINATORS = {
-	" ": "descendant",
-	">": "child",
-	"+": "adjacent",
-	"~": "sibling"
-};
-/** Compile a selector into the plain-data matcher the render lane uses. */
-const compileSelector = (selector) => {
-	let ast;
-	try {
-		ast = parse(selector, {
-			context: "selector",
-			positions: false
-		});
-	} catch {
-		return;
-	}
-	if (ast.type !== "Selector" || ast.children === null) return void 0;
-	const parts = [];
-	let tag;
-	let id;
-	let classes = [];
-	let attributes = [];
-	let opaque = false;
-	const flush = (after) => {
-		parts.push({
-			compound: {
-				tag,
-				id,
-				classes,
-				attributes,
-				opaque
-			},
-			...after === void 0 ? {} : { after }
-		});
-		tag = void 0;
-		id = void 0;
-		classes = [];
-		attributes = [];
-		opaque = false;
-	};
-	for (const node of ast.children) switch (node.type) {
-		case "TypeSelector":
-			if (node.name !== "*") tag = node.name.toLowerCase();
-			break;
-		case "IdSelector":
-			id = node.name;
-			break;
-		case "ClassSelector":
-			classes.push(ident.decode(node.name));
-			break;
-		case "AttributeSelector":
-			attributes.push({
-				name: node.name.name,
-				operator: node.matcher ?? void 0,
-				value: node.value === null || node.value === void 0 ? void 0 : node.value.type === "String" ? node.value.value : node.value.name
-			});
-			break;
-		case "Combinator":
-			flush(COMBINATORS[node.name.trim() === "" ? " " : node.name] ?? "descendant");
-			break;
-		default: opaque = true;
-	}
-	flush();
-	return { parts };
-};
-/** Substitute a nested rule's `&` against its parent selector. */
-const nestSelector = (parent, child) => child.includes("&") ? child.replaceAll("&", parent) : `${parent} ${child}`;
-/** Parse one stylesheet into rules, keeping layer, order and conditions. */
-const parseStylesheet = (source, options = {}) => {
-	const rules = [];
-	const headAtRules = [];
-	const fontFaces = [];
-	const variables = {};
-	const darkVariables = {};
-	const conditionalVariables = /* @__PURE__ */ new Set();
-	const diagnostics = [];
-	const layers = /* @__PURE__ */ new Map();
-	const selectorFacts = /* @__PURE__ */ new Map();
-	let order = options.startOrder ?? 0;
-	/** Everything a rule needs from its selector, computed once per distinct string. */
-	const factsFor = (selector) => {
-		const cached = selectorFacts.get(selector);
-		if (cached !== void 0) return cached;
-		let facts;
-		try {
-			const node = parse(selector, {
-				context: "selector",
-				positions: false
-			});
-			const classes = /* @__PURE__ */ new Set();
-			walk(node, {
-				visit: "ClassSelector",
-				enter: (part) => {
-					classes.add(ident.decode(part.name));
-				}
-			});
-			facts = {
-				classes: [...classes],
-				specificity: specificityOf(node),
-				pseudo: hasPseudo(node),
-				matcher: compileSelector(selector)
-			};
-		} catch {
-			facts = {
-				classes: [],
-				specificity: [
-					0,
-					0,
-					0
-				],
-				pseudo: true,
-				matcher: void 0
-			};
-		}
-		selectorFacts.set(selector, facts);
-		return facts;
-	};
-	let ast;
-	try {
-		ast = parse(source, {
-			parseValue: false,
-			parseCustomProperty: false,
-			positions: false
-		});
-	} catch (cause) {
-		return {
-			rules: [],
-			headAtRules: [],
-			fontFaces: [],
-			variables: {},
-			darkVariables: {},
-			diagnostics: [{
-				code: "css-parse-error",
-				severity: "error",
-				message: `${options.origin ?? "stylesheet"} could not be parsed: ${String(cause)}`,
-				origins: []
-			}]
-		};
-	}
-	const declarationsOf = (block) => {
-		const output = [];
-		if (block === null || block.type !== "Block" || block.children === null) return output;
-		for (const child of block.children) {
-			if (child.type !== "Declaration") continue;
-			output.push({
-				property: child.property,
-				value: downlevelColors(text(child.value).trim().replace(/[\t\n\r\f]/g, " ")),
-				important: child.important === true
-			});
-		}
-		return output;
-	};
-	const emit = (selector, context, declarations) => {
-		if (declarations.length === 0) return;
-		const facts = factsFor(selector);
-		if (ROOT_SELECTORS.has(selector.trim())) for (const declaration of declarations) {
-			if (!declaration.property.startsWith("--")) continue;
-			if (context.conditions.length === 0) variables[declaration.property] = declaration.value;
-			else if (isDarkSchemeCondition(context.conditions)) darkVariables[declaration.property] = declaration.value;
-			else conditionalVariables.add(declaration.property);
-		}
-		rules.push({
-			selector,
-			classes: facts.classes,
-			specificity: facts.specificity,
-			declarations,
-			order: order++,
-			layer: context.layer,
-			conditions: context.conditions,
-			inlinable: context.conditions.length === 0 && !facts.pseudo,
-			matcher: facts.matcher
-		});
-	};
-	/**
-	* Declarations directly in a block belong to the enclosing selector, whether
-	* that block is the rule's own or a `@media` nested inside it — which is
-	* exactly the shape Tailwind v4 emits for a responsive utility.
-	*/
-	const walkBlock = (block, context) => {
-		if (block === null || block.type !== "Block" || block.children === null) return;
-		const declarations = declarationsOf(block);
-		if (declarations.length > 0 && context.selector !== void 0) emit(context.selector, context, declarations);
-		for (const child of block.children) if (child.type !== "Declaration") visitNode(child, context);
-	};
-	const visitNode = (node, context) => {
-		if (node.type === "Rule") {
-			const prelude = node.prelude;
-			const selectors = prelude.type === "SelectorList" && prelude.children !== null ? [...prelude.children] : [prelude];
-			for (const selector of selectors) {
-				const own = text(selector).trim();
-				if (own === "") continue;
-				walkBlock(node.block, {
-					...context,
-					selector: context.selector === void 0 ? own : nestSelector(context.selector, own)
-				});
-			}
-			return;
-		}
-		if (node.type !== "Atrule") return;
-		const name = node.name.toLowerCase();
-		if (name === "layer") {
-			const prelude = text(node.prelude).trim();
-			if (node.block === null) {
-				for (const declared of prelude.split(",").map((part) => part.trim())) if (declared !== "" && !layers.has(declared)) layers.set(declared, layers.size);
-				return;
-			}
-			const named = prelude.split(",")[0]?.trim() ?? "";
-			if (named !== "" && !layers.has(named)) layers.set(named, layers.size);
-			walkBlock(node.block, {
-				...context,
-				layer: layers.get(named) ?? context.layer
-			});
-			return;
-		}
-		if (name === "theme" || name === "scope") {
-			const into = context.conditions.length === 0 ? variables : isDarkSchemeCondition(context.conditions) ? darkVariables : void 0;
-			for (const declaration of declarationsOf(node.block)) if (declaration.property.startsWith("--")) {
-				if (into === void 0) conditionalVariables.add(declaration.property);
-				else into[declaration.property] = declaration.value;
-			}
-			for (const child of node.block?.children ?? []) if (child.type !== "Declaration") visitNode(child, context);
-			return;
-		}
-		if (name === "property") {
-			const initial = declarationsOf(node.block).find((declaration) => declaration.property === "initial-value");
-			const property = text(node.prelude).trim();
-			if (initial !== void 0 && property.startsWith("--") && !(property in variables)) variables[property] = initial.value;
-			return;
-		}
-		if (CONDITIONAL_AT_RULES.has(name)) {
-			walkBlock(node.block, {
-				...context,
-				conditions: [...context.conditions, `@${name} ${text(node.prelude).trim()}`]
-			});
-			return;
-		}
-		if (name === "font-face") {
-			const face = compileFontFace(node, options.origin ?? "stylesheet", options.resolveFontFile);
-			if (face.rule !== void 0) fontFaces.push(face.rule);
-			diagnostics.push(...face.diagnostics);
-			return;
-		}
-		if (HEAD_AT_RULES.has(name)) {
-			headAtRules.push(generate(node));
-			return;
-		}
-		if (name === "import") {
-			if (options.themeImports === true) return;
-			diagnostics.push({
-				code: "css-import-unresolved",
-				severity: "error",
-				message: `${options.origin ?? "stylesheet"} uses @import ${text(node.prelude).trim()}; import the stylesheet from the template module instead so the compiler can resolve it.`,
-				origins: []
-			});
-			return;
-		}
-		if (name === "charset" || name === "namespace") return;
-		diagnostics.push({
-			code: "css-unsupported-at-rule",
-			severity: "warning",
-			message: `@${name} is not applied to email output; remove it or move the declarations into a class rule.`,
-			origins: []
-		});
-	};
-	if (ast.type === "StyleSheet" && ast.children !== null) for (const child of ast.children) visitNode(child, {
-		conditions: [],
-		layer: UNLAYERED
-	});
-	for (const property of conditionalVariables) if (property in variables) diagnostics.push({
-		code: "css-conditional-variable",
-		severity: "warning",
-		message: `${property} is redefined inside a conditional at-rule. Inlined declarations take the unconditional value; keep the override on a class rule so the retained head rule can apply it.`,
-		origins: []
-	});
-	return {
-		rules,
-		headAtRules,
-		fontFaces,
-		variables,
-		darkVariables,
-		diagnostics
-	};
-};
-//#endregion
-//#region src/email/contrast.ts
-const CANVAS = {
-	light: {
-		r: 1,
-		g: 1,
-		b: 1,
-		a: 1
-	},
-	dark: {
-		r: 18 / 255,
-		g: 18 / 255,
-		b: 18 / 255,
-		a: 1
-	}
-};
-/** The ratios `email-contrast` holds a message to, and what counts as large text. */
-const CONTRAST_THRESHOLDS = {
-	/** Text below this is an error at any size. */
-	textError: 3,
-	/** Normal-size text below this is a warning (WCAG AA). */
-	textWarning: 4.5,
-	/** Text at least this many pixels is large, as is bold text at `largeBoldPx`. */
-	largePx: 24,
-	largeBoldPx: 18.5,
-	/** A filled button below this against its surroundings is an error. */
-	shapeError: 1.5,
-	/** A filled button below this is a warning (WCAG 1.4.11). */
-	shapeWarning: 3,
-	/** A button border at least this against the surroundings keeps the shape. */
-	border: 3
-};
-const TEXT_ERROR = CONTRAST_THRESHOLDS.textError;
-const TEXT_WARNING = CONTRAST_THRESHOLDS.textWarning;
-const LARGE_PX = CONTRAST_THRESHOLDS.largePx;
-const LARGE_BOLD_PX = CONTRAST_THRESHOLDS.largeBoldPx;
-const SHAPE_ERROR = CONTRAST_THRESHOLDS.shapeError;
-const SHAPE_WARNING = CONTRAST_THRESHOLDS.shapeWarning;
-const INSET_BORDER = CONTRAST_THRESHOLDS.border;
-const SKIPPED_TAGS = /* @__PURE__ */ new Set([
-	"head",
-	"style",
-	"title",
-	"script"
-]);
-const INVISIBLE = /[\s\u200b-\u200f\ufeff\u00a0\u00ad]|\u034f/g;
-const DARK_QUERY = /^@media\b[^{]*\(\s*prefers-color-scheme\s*:\s*dark\s*\)/i;
-const clamp = (value) => value < 0 ? 0 : value > 1 ? 1 : value;
-const channel = (value) => {
-	const v = clamp(value);
-	return v <= .04045 ? v / 12.92 : ((v + .055) / 1.055) ** 2.4;
-};
-const luminance = (color) => .2126 * channel(color.r) + .7152 * channel(color.g) + .0722 * channel(color.b);
-const ratioOf = (left, right) => {
-	const a = luminance(left);
-	const b = luminance(right);
-	return (Math.max(a, b) + .05) / (Math.min(a, b) + .05);
-};
-const hex = (color) => `#${[
-	color.r,
-	color.g,
-	color.b
-].map((value) => Math.round(clamp(value) * 255).toString(16).padStart(2, "0")).join("")}`;
-const over = (top, below) => ({
-	r: top.r * top.a + below.r * (1 - top.a),
-	g: top.g * top.a + below.g * (1 - top.a),
-	b: top.b * top.a + below.b * (1 - top.a),
-	a: 1
-});
-const declarationsOf = (source) => {
-	const found = [];
-	try {
-		walk(parse(source, {
-			context: "declarationList",
-			positions: false
-		}), (node) => {
-			if (node.type === "Declaration") found.push({
-				property: node.property.toLowerCase(),
-				value: generate(node.value).trim()
-			});
-		});
-	} catch {
-		return [];
-	}
-	return found;
-};
-/** Split on whitespace that is not inside parentheses. */
-const tokens = (value) => {
-	const found = [];
-	let depth = 0;
-	let current = "";
-	for (const char of value) {
-		if (char === "(") depth += 1;
-		if (char === ")") depth -= 1;
-		if (/\s/.test(char) && depth === 0) {
-			if (current !== "") found.push(current);
-			current = "";
-		} else current += char;
-	}
-	if (current !== "") found.push(current);
-	return found;
-};
-const declaredColor = (value) => {
-	const color = parseColor(value);
-	return color === void 0 ? "unknown" : color;
-};
-const pixels = (value) => {
-	const trimmed = value.trim();
-	if (/^[+-]?0+(?:\.0+)?$/.test(trimmed)) return 0;
-	const match = /^(\d+(?:\.\d+)?|\.\d+)px$/i.exec(trimmed);
-	return match === null ? void 0 : Number(match[1]);
-};
-const BORDER_STYLES = /^(?:solid|dashed|dotted|double|groove|ridge|inset|outset|none|hidden)$/i;
-const WIDTH_KEYWORDS = {
-	thin: 1,
-	medium: 3,
-	thick: 5
-};
-const resolve = (declarations) => {
-	let background;
-	let image = false;
-	let color;
-	let display;
-	let fontSize;
-	let bold;
-	const border = {
-		width: void 0,
-		visible: void 0,
-		color: void 0
-	};
-	for (const { property, value } of declarations) {
-		const lower = value.toLowerCase();
-		switch (property) {
-			case "background":
-				image = /url\(|gradient\(/.test(lower);
-				background = tokens(value).filter((part) => !/^(?:url|[\w-]*gradient)\(/i.test(part)).map(parseColor).find((entry) => entry !== void 0) ?? (/var\(|currentcolor|inherit|initial|unset/.test(lower) ? "unknown" : void 0);
-				break;
-			case "background-color":
-				background = declaredColor(value);
-				break;
-			case "background-image":
-				image = lower !== "none";
-				break;
-			case "color":
-				color = declaredColor(value);
-				break;
-			case "display":
-				display = lower.replace(/\s*!important$/, "");
-				break;
-			case "font-size":
-				fontSize = pixels(value);
-				break;
-			case "font-weight": {
-				const weight = Number(lower);
-				if (lower === "bold" || lower === "bolder") bold = true;
-				else if (lower === "normal" || lower === "lighter") bold = false;
-				else if (!Number.isNaN(weight)) bold = weight >= 700;
-				break;
-			}
-			case "border":
-			case "border-width":
-			case "border-color":
-			case "border-style": {
-				const parts = tokens(value);
-				if (property === "border") {
-					border.width = WIDTH_KEYWORDS.medium;
-					border.visible = false;
-					border.color = "unknown";
-				}
-				const styles = parts.filter((part) => BORDER_STYLES.test(part));
-				if (styles.length > 0) border.visible = styles.every((part) => !/^(?:none|hidden)$/i.test(part));
-				const sizes = parts.map((part) => pixels(part) ?? WIDTH_KEYWORDS[part.toLowerCase()]).filter((entry) => entry !== void 0);
-				if (sizes.length > 0) border.width = Math.min(...sizes);
-				else if (property === "border-width") border.width = void 0;
-				const named = parts.filter((part) => pixels(part) === void 0 && WIDTH_KEYWORDS[part.toLowerCase()] === void 0 && !BORDER_STYLES.test(part));
-				if (property !== "border-width" && property !== "border-style" && named.length > 0) {
-					const colors = named.map(parseColor);
-					border.color = colors.every((entry) => entry !== void 0) ? colors[0] : "unknown";
-				}
-				break;
-			}
-		}
-	}
-	return {
-		background,
-		image,
-		color,
-		display,
-		fontSize,
-		bold,
-		border
-	};
-};
-/** Properties a declaration list sets, for deciding whether an unimportant dark rule can apply. */
-const has = (declarations, property) => declarations.some((entry) => entry.property === property);
-const advance = (parent, style, tag) => {
-	let background = parent.background;
-	let ownBackground;
-	if (style.image || style.background === "unknown") background = "unknown";
-	else if (style.background !== void 0 && style.background.a > 0) {
-		if (style.background.a >= 1) background = style.background;
-		else if (parent.background !== "unknown") background = over(style.background, parent.background);
-		else background = "unknown";
-		if (background !== "unknown") ownBackground = background;
-	}
-	let color = tag === "a" ? void 0 : parent.color;
-	if (style.color === "unknown") color = "unknown";
-	else if (style.color !== void 0) color = style.color;
-	return {
-		ownBackground,
-		state: {
-			background,
-			color,
-			fontSize: style.fontSize ?? parent.fontSize,
-			bold: style.bold ?? parent.bold,
-			hidden: parent.hidden || style.display === "none"
-		}
-	};
-};
-const originsAt$1 = (positions, offset) => {
-	if (offset === void 0) return [];
-	let best;
-	for (const position of positions) {
-		if (offset < position.start || offset >= position.end) continue;
-		if (best === void 0 || position.end - position.start < best.end - best.start) best = position;
-	}
-	return best?.origins ?? [];
-};
-const compareRules = (left, right) => {
-	const important = (rule) => rule.declarations.some((d) => d.important) ? 1 : 0;
-	return important(left) - important(right) || left.specificity[0] - right.specificity[0] || left.specificity[1] - right.specificity[1] || left.specificity[2] - right.specificity[2] || left.order - right.order;
-};
-const textOf = (node) => node.children.map((child) => "data" in child ? String(child.data) : "").join("");
-const MODE_LABEL = {
-	light: "Light mode",
-	dark: "Dark mode"
-};
-const FIX = "Pair background and text tokens (bg-primary with text-primary-foreground) and give the theme's dark-mode @theme a value for the token, or choose colors that reach";
-/**
-* Check text and filled-control contrast in the emitted document, in light and
-* dark presentation.
-*/
-const checkEmailContrast = (input) => {
-	const { document } = parseHtml(input.html);
-	const sheets = input.css === void 0 ? [] : [input.css];
-	const collect = (nodes) => {
-		for (const node of nodes) {
-			if (!("attribs" in node)) continue;
-			if (node.name === "style") sheets.push(textOf(node));
-			else collect(node.children);
-		}
-	};
-	collect(document.children);
-	const darkRules = sheets.flatMap((sheet) => parseStylesheet(sheet).rules).filter((rule) => rule.conditions.length === 1 && DARK_QUERY.test(rule.conditions[0])).toSorted(compareRules);
-	const findings = /* @__PURE__ */ new Map();
-	const report = (mode, kind, foreground, background, ratio, required, severity, offset) => {
-		const origins = originsAt$1(input.positions ?? [], offset);
-		const measured = ratio.toFixed(2);
-		const colors = `${hex(foreground)} on ${hex(background)}`;
-		const message = kind === "text" ? `${MODE_LABEL[mode]}: text ${colors} has a contrast ratio of ${measured}:1; ${required}:1 is required. ${FIX} ${required}:1.` : `${MODE_LABEL[mode]}: the button background ${hex(foreground)} against its surroundings ${hex(background)} has a contrast ratio of ${measured}:1; ${SHAPE_WARNING}:1 is required for the shape to stay visible (below ${SHAPE_ERROR}:1 it disappears). ${FIX} ${SHAPE_WARNING}:1, or give the button a border that does.`;
-		const key = JSON.stringify([
-			mode,
-			kind,
-			hex(foreground),
-			hex(background),
-			measured,
-			origins
-		]);
-		const existing = findings.get(key);
-		if (existing !== void 0) {
-			if (origins.length > 0) existing.occurrences.push(origins);
-			return;
-		}
-		findings.set(key, {
-			key,
-			occurrences: origins.length > 0 ? [origins] : [],
-			diagnostic: {
-				code: "email-contrast",
-				severity,
-				message,
-				origins,
-				...input.fixture === void 0 ? {} : { fixtures: [input.fixture] }
-			}
-		});
-	};
-	const visit = (node, parents, parentAncestry, previous) => {
-		const inline = declarationsOf(node.attribs.style ?? "");
-		const attribute = node.attribs.bgcolor === void 0 ? [] : [{
-			property: "background-color",
-			value: node.attribs.bgcolor
-		}];
-		const shape = {
-			type: "Element",
-			tag: node.name,
-			props: node.attribs,
-			children: [],
-			origins: [],
-			authored: false
-		};
-		const ancestry = {
-			element: shape,
-			parent: parentAncestry,
-			previous
-		};
-		const base = [...attribute, ...inline];
-		const dark = [...base];
-		for (const rule of darkRules) {
-			if (!matchesSelector(rule.matcher, ancestry)) continue;
-			for (const declaration of rule.declarations) {
-				const property = declaration.property.toLowerCase();
-				if (declaration.important || !has(inline, property)) dark.push({
-					property,
-					value: declaration.value.replace(/\s*!important$/i, "")
-				});
-			}
-		}
-		const styles = {
-			light: resolve(base),
-			dark: resolve(dark)
-		};
-		const direct = node.children.some((child) => child.type === "text" && String(child.data).replace(INVISIBLE, "") !== "");
-		const states = {
-			light: parents.light,
-			dark: parents.dark
-		};
-		for (const mode of ["light", "dark"]) {
-			const parent = parents[mode];
-			const style = styles[mode];
-			const { state, ownBackground } = advance(parent, style, node.name);
-			states[mode] = state;
-			if (state.hidden) continue;
-			if (node.name === "a" && ownBackground !== void 0 && parent.background !== "unknown" && !style.image) {
-				const ratio = ratioOf(ownBackground, parent.background);
-				if (ratio < SHAPE_WARNING) {
-					const { width, visible, color } = style.border;
-					const bordered = visible === true && width !== void 0 && width > 0 && color !== void 0;
-					if (!(bordered && color !== "unknown" && ratioOf(over(color, parent.background), parent.background) >= INSET_BORDER) && !(bordered && color === "unknown")) report(mode, "button", ownBackground, parent.background, ratio, SHAPE_WARNING, ratio < SHAPE_ERROR ? "error" : "warning", node.startIndex ?? void 0);
-				}
-			}
-			if (direct && state.color !== void 0 && state.color !== "unknown" && state.background !== "unknown") {
-				const ink = over(state.color, state.background);
-				const ratio = ratioOf(ink, state.background);
-				const required = state.fontSize !== void 0 && (state.fontSize >= LARGE_PX || state.bold && state.fontSize >= LARGE_BOLD_PX) ? TEXT_ERROR : TEXT_WARNING;
-				if (ratio < required) report(mode, "text", ink, state.background, ratio, required, ratio < TEXT_ERROR ? "error" : "warning", node.startIndex ?? void 0);
-			}
-		}
-		if (!SKIPPED_TAGS.has(node.name) && (!states.light.hidden || !states.dark.hidden)) {
-			let siblings = [];
-			for (const child of node.children) {
-				if (!("attribs" in child) || SKIPPED_TAGS.has(child.name)) continue;
-				const done = visit(child, states, ancestry, siblings);
-				siblings = [...siblings, done];
-			}
-		}
-		return shape;
-	};
-	const root = {
-		light: {
-			background: CANVAS.light,
-			color: void 0,
-			fontSize: void 0,
-			bold: false,
-			hidden: false
-		},
-		dark: {
-			background: CANVAS.dark,
-			color: void 0,
-			fontSize: void 0,
-			bold: false,
-			hidden: false
-		}
-	};
-	let siblings = [];
-	for (const node of document.children) {
-		if (!("attribs" in node) || SKIPPED_TAGS.has(node.name)) continue;
-		siblings = [...siblings, visit(node, root, void 0, siblings)];
-	}
-	return [...findings.values()].map(({ diagnostic, occurrences }) => ({
-		...diagnostic,
-		...occurrences.length > 1 ? { occurrences } : {}
-	}));
-};
-//#endregion
-//#region src/email/compatibility.ts
-/**
-* The pinned matrix. Every finding is reported per client, and a client absent
-* from this list is a client Samva makes no claim about.
-*/
-const EMAIL_CLIENT_MATRIX = [
-	{
-		id: "gmail.desktop-webmail",
-		label: "Gmail web"
-	},
-	{
-		id: "gmail.ios",
-		label: "Gmail iOS"
-	},
-	{
-		id: "gmail.android",
-		label: "Gmail Android"
-	},
-	{
-		id: "apple-mail.macos",
-		label: "Apple Mail macOS"
-	},
-	{
-		id: "apple-mail.ios",
-		label: "Apple Mail iOS"
-	},
-	{
-		id: "yahoo.desktop-webmail",
-		label: "Yahoo web"
-	},
-	{
-		id: "outlook.outlook-com",
-		label: "Outlook web and new Windows"
-	},
-	{
-		id: "outlook.windows",
-		label: "Outlook classic Windows"
-	}
-];
-const LABELS = new Map(EMAIL_CLIENT_MATRIX.map((target) => [target.id, target.label]));
-const COMPATIBILITY_PROVENANCE = {
-	rules: "caniemail@2.0.2",
-	apiVersion: rawData.api_version,
-	lastUpdate: rawData.last_update_date
-};
-/**
-* The constructs whose loss actually breaks a message: the recipient reads
-* something different, in a different order, follows a link that does not work,
-* or sees a layout that has collapsed. A target client dropping one of these
-* blocks publication.
-*
-* The list is deliberately short and enumerated, because the contract is to
-* block *known* failures. Nonessential differences require an assessment of
-* emitted values: a concrete risk warns, expected differences and unverified
-* behavior remain compatibility observations.
-*/
-const ESSENTIAL_CONSTRUCTS = /* @__PURE__ */ new Set([
-	"<table> element",
-	"<div> element",
-	"<p> element",
-	"<span> element",
-	"<ul>, <ol> and <dl>",
-	"<h1> to <h6> elements",
-	"HTML5 doctype",
-	"width attribute",
-	"height attribute",
-	"align attribute",
-	"valign attribute",
-	"<img> element",
-	"display",
-	"mailto: links",
-	"Local anchors"
-]);
-const KNOWN_TITLES = new Set(rawData.data.map((feature) => feature.title));
-/** The innermost recorded node containing an offset, so a finding names its element. */
-const originsAt = (positions, offset) => {
-	let best;
-	for (const position of positions) {
-		if (offset < position.start || offset >= position.end) continue;
-		if (best === void 0 || position.end - position.start < best.end - best.start) best = position;
-	}
-	return best?.origins ?? [];
-};
-const slug = (title) => title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-/**
-* Check the emitted document against the pinned matrix.
-*
-* Findings are grouped by construct rather than repeated per client, so one
-* unsupported property is one diagnostic naming every client that drops it.
-*/
-const checkEmailCompatibility = (input) => {
-	const targets = input.clients ?? EMAIL_CLIENT_MATRIX;
-	const context = compatibilityContext(input.html, input.css);
-	const targetClients = targets.map((target) => target.id);
-	const reports = [caniemail({
-		clients: targetClients,
-		html: input.html
-	}), ...input.css === void 0 ? [] : [caniemail({
-		clients: targetClients,
-		css: input.css
-	})]];
-	const grouped = /* @__PURE__ */ new Map();
-	for (const bucket of reports.flatMap((report) => [report.issues.errors, report.issues.warnings])) for (const [client, issues] of bucket) {
-		const label = LABELS.get(client) ?? client;
-		for (const raw of issues) {
-			const hiddenContentFailure = client === "outlook.windows" && raw.support === "partial" && (raw.title === "display" || raw.title === "display:none") && context.hiddenContentOffsets.length > 0;
-			const blocking = hiddenContentFailure || raw.support !== "partial" && ESSENTIAL_CONSTRUCTS.has(raw.title);
-			const { explanation, ...compatibility } = assessCompatibility(raw.title, client, raw.support, context, blocking);
-			const key = JSON.stringify([
-				raw.title,
-				raw.support,
-				compatibility,
-				explanation
-			]);
-			const offsets = hiddenContentFailure ? context.hiddenContentOffsets : context.offsets(raw.title);
-			const entry = grouped.get(key);
-			if (entry === void 0) grouped.set(key, {
-				title: raw.title,
-				support: raw.support,
-				clients: /* @__PURE__ */ new Set([label]),
-				notes: new Set(raw.notes),
-				explanation,
-				compatibility,
-				blocking,
-				offsets
-			});
-			else {
-				entry.clients.add(label);
-				for (const note of raw.notes) entry.notes.add(note);
-			}
-		}
-	}
-	const findings = [];
-	for (const entry of grouped.values()) {
-		const severity = entry.blocking ? "error" : entry.compatibility.assessment === "risk" ? "warning" : "info";
-		const occurrences = entry.offsets.map((offset) => originsAt(input.positions ?? [], offset)).filter((origins) => origins.length > 0);
-		const clients = [...entry.clients].sort();
-		const dropped = entry.support === "partial" ? clients.length === 1 ? "partially supports" : "partially support" : clients.length === 1 ? "does not support" : "do not support";
-		findings.push({
-			code: `caniemail/${slug(entry.title)}`,
-			severity,
-			message: `${clients.join(", ")} ${dropped} ${entry.title}. ${entry.explanation}`,
-			compatibility: entry.compatibility,
-			origins: occurrences[0] ?? [],
-			...occurrences.length === 0 ? {} : { occurrences },
-			...input.fixture === void 0 ? {} : { fixtures: [input.fixture] },
-			clients,
-			...entry.notes.size === 0 ? {} : { notes: [...entry.notes].join(" ") },
-			provenance: `${COMPATIBILITY_PROVENANCE.rules} (caniemail data ${COMPATIBILITY_PROVENANCE.apiVersion}, updated ${COMPATIBILITY_PROVENANCE.lastUpdate})`
-		});
-	}
-	findings.push(...checkEmailContrast(input));
-	return findings.sort((left, right) => left.code.localeCompare(right.code));
-};
-/**
-* Constructs the pinned data says nothing about for a target client. These are
-* reported so "we did not check that" is never mistaken for "that works".
-*/
-const unknownCoverage = (titles) => [...titles].filter((title) => !KNOWN_TITLES.has(title)).sort().map((title) => ({
-	code: "caniemail/unknown-coverage",
-	severity: "info",
-	message: `The pinned rules say nothing about ${title}, so no client claim is made about it. Verify it in a real client before relying on it.`,
-	origins: [],
-	provenance: `${COMPATIBILITY_PROVENANCE.rules} (caniemail data ${COMPATIBILITY_PROVENANCE.apiVersion}, updated ${COMPATIBILITY_PROVENANCE.lastUpdate})`
-}));
-/** A publication carrying one of these is refused; the message would arrive broken. */
-const hasBlockingCompatibility = (findings) => findings.some((finding) => finding.severity === "error");
-//#endregion
 //#region src/email/tailwind-stylesheets.gen.ts
 /** The exact Tailwind release the compiler runs, recorded in every build manifest. */
 const TAILWIND_VERSION = "4.3.3";
@@ -1324,7 +131,7 @@ const compileTailwind = async (candidates, options = {}, imports = { stylesheets
 				base,
 				content: builtIn
 			});
-			if (parseBrandSpecifier(id, imports.brandPlugin) !== void 0) {
+			if (parseBrandSpecifier(id, { brandPlugin: imports.brandPlugin }) !== void 0) {
 				if (imports.brandCss === void 0) throw new TypeError(`${id} has no brand in this build`);
 				return Promise.resolve({
 					path: id,
@@ -1526,7 +333,9 @@ const scriptBrandImports = (path, source, plugin) => {
 * the project imports no brand. A project that names two brands gets the
 * first here and a refusal from the compile.
 */
-const projectBrandSpecifier = (files, themePath = "theme.css", brandPlugin = samvaBrandPlugin) => {
+const projectBrandSpecifier = (files, options = {}) => {
+	const themePath = options.themePath ?? "theme.css";
+	const brandPlugin = options.brandPlugin ?? samvaBrandPlugin;
 	const theme = files[themePath];
 	const fromTheme = typeof theme === "string" ? resolveThemeImports(themePath, theme, files, brandPlugin).brandSpecifiers : [];
 	const fromScripts = Object.keys(files).sort().filter((path) => SCRIPT.test(path) && typeof files[path] === "string").flatMap((path) => scriptBrandImports(path, files[path], brandPlugin)).map((request) => request.specifier);
@@ -1565,7 +374,7 @@ const resolveTheme = (files, tailwind, brand, brandPlugin) => {
 	});
 	else if (specifiers.length === 1) {
 		const specifier = specifiers[0];
-		const named = parseBrandSpecifier(specifier, brandPlugin)?.slug;
+		const named = parseBrandSpecifier(specifier, { brandPlugin })?.slug;
 		const origins = [requests[0].origin];
 		if (brand === void 0) refusals.push({
 			code: "brand-unavailable",
@@ -1649,66 +458,8 @@ const transformProject = async (files, options) => {
 	};
 };
 //#endregion
-//#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, plugin) => {
-	const parsed = parseBrandCss(brand.css);
-	if (parsed.isErr()) throw new EmailCompileError({ diagnostics: parsed.error.map((finding) => ({
-		code: finding.code,
-		severity: "error",
-		message: `${plugin.specifier}: ${finding.message}`,
-		origins: []
-	})) });
-	return printBrandCss(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 its brand import. Without `unsubscribe` the unsubscribe row is
-* left out.
-*/
-const renderBrandFooter = async (brand, options) => {
-	const plugin = options.brandPlugin ?? samvaBrandPlugin;
-	const tailwind = await compileTailwind(BRAND_COMPONENT_CLASSES, { css: brandTheme(brand, plugin) });
-	const node = brandComponents(brand, plugin).BrandFooter({});
-	if (node === null) return {
-		html: "",
-		text: "",
-		headCss: ""
-	};
-	const styled = applyStylesheet(node, parseStylesheet(tailwind.css, { origin: plugin.specifier }));
-	const compiled = compileEmail(styled.tree, { brandPlugin: plugin });
-	const rendered = options.unsubscribe ? compiled : withoutUnsubscribeRow({
-		html: compiled.html,
-		text: compiled.text
-	}, plugin);
-	const text = (rendered.text ?? "").trim();
-	return {
-		html: rendered.html ?? "",
-		text: text === "" ? "" : `\n\n---\n${text}`,
-		headCss: `${renderDarkRules(styled.darkRules)}${styled.headCss}`
-	};
-};
-/**
-* Render content against a brand as a project whose `theme.css` imports only
-* the 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, brandPlugin = samvaBrandPlugin) => {
-	const tailwind = await compileTailwind([...BRAND_COMPONENT_CLASSES, ...sample.classes], { css: `@import ${JSON.stringify(brandPlugin.specifier)};` }, {
-		stylesheets: /* @__PURE__ */ new Map(),
-		brandCss: brandTheme(brand, brandPlugin),
-		brandPlugin
-	});
-	const components = brandComponents(brand, brandPlugin);
-	return renderEmailContent(parseStylesheet(tailwind.css, { origin: brandPlugin.specifier }), () => sample.render(components), { brandPlugin });
-};
-//#endregion
 //#region src/sml/compile.ts
-/** Compile a project's entry template to IR without evaluating any of it. */
+/** Compile a project's entry template without evaluating any of it. */
 const compileTemplate = async (options) => {
 	const findings = new Findings();
 	const project = loadProject(options.files, options.entry, findings, { brandPlugin: options.brandPlugin ?? samvaBrandPlugin });
@@ -1734,38 +485,251 @@ const compileTemplate = async (options) => {
 	});
 };
 //#endregion
-//#region src/sml/compatibility.ts
+//#region src/email/text.ts
+const PARAGRAPH = "\n\n";
+const LINE = "\n";
+const INVISIBLE = /\u200b|\u200c|\u200d|\u200e|\u200f|\u2060|\ufeff/g;
+const isLayoutTable = (props) => props.role === "presentation" || props.role === "none";
 /**
-* Check what each declared fixture delivers against the pinned client matrix. The rules run on the
-* rendered document, because what a client drops is what the compiler produced, and every finding
-* is located at the source of the element that produced it.
+* A data-table cell that reads as nothing and holds only imagery with empty alt text carries no
+* column of its own; an empty cell without such an image is a positional placeholder.
 */
-const checkTemplateCompatibility = (ir, fixtures, options = {}) => {
-	if (ir.email === void 0) return [];
-	const sources = ir.sources ?? [];
-	const findings = [];
-	for (const [fixture, input] of Object.entries(fixtures)) {
-		const rendered = renderIr(ir, input, { positions: true });
-		const positions = (rendered.positions ?? []).map((position, index) => ({
-			start: position.start,
-			end: position.end,
-			tag: position.tag,
-			instancePath: String(index),
-			authored: true,
-			origins: position.src === void 0 ? [] : [{
-				fileName: sources[position.src[2] ?? 0] ?? "",
-				lineNumber: position.src[0],
-				columnNumber: position.src[1]
-			}]
-		}));
-		findings.push(...checkEmailCompatibility({
-			html: rendered.html,
-			fixture,
-			positions,
-			...options.clients === void 0 ? {} : { clients: options.clients }
-		}));
+const isDecorativeCell = (cell, context) => {
+	const images = collect(cell.children, (tag) => tag === "img", () => true);
+	return images.length > 0 && images.every((image) => image.props.alt === "") && childText(cell, context).trim() === "";
+};
+/** Wrap a block's content in separators; empty blocks contribute nothing. */
+const block = (inner, separator) => {
+	const trimmed = inner.replace(/^\s+/, "").replace(/\s+$/, "");
+	return trimmed === "" ? "" : `${separator}${trimmed}${separator}`;
+};
+const collect = (nodes, keep, descend) => nodes.flatMap((child) => {
+	if (child.type === "Fragment") return collect(child.children, keep, descend);
+	if (child.type !== "Element") return [];
+	if (keep(child.tag)) return [child];
+	return descend(child.tag) ? collect(child.children, keep, descend) : [];
+});
+const TABLE_SECTIONS = /* @__PURE__ */ new Set([
+	"thead",
+	"tbody",
+	"tfoot"
+]);
+const childText = (node, context) => node.children.map((child) => derive(child, context)).join("");
+const derive = (node, context) => {
+	switch (node.type) {
+		case "Text": return context.preformatted ? node.value : node.value.replace(INVISIBLE, "").replace(/[^\S\n]+/g, " ");
+		case "Raw": return node.text;
+		case "Fragment": return node.children.map((child) => derive(child, context)).join("");
+		case "Element": {
+			const spec = emailElement(node.tag);
+			if (spec === void 0) return childText(node, context);
+			switch (spec.layout) {
+				case "metadata": return "";
+				case "document":
+				case "inline":
+				case "list-item": return childText(node, context);
+				case "break": return LINE;
+				case "rule": return `${PARAGRAPH}---${PARAGRAPH}`;
+				case "image": {
+					const alt = typeof node.props.alt === "string" ? node.props.alt.trim() : "";
+					return alt === "" ? "" : `[${alt}]`;
+				}
+				case "link": {
+					const label = childText(node, context).replace(/\s+/g, " ").trim();
+					const href = typeof node.props.href === "string" ? node.props.href : "";
+					if (href === "" || href === label) return label;
+					return label === "" ? href : `${label} (${href})`;
+				}
+				case "list": {
+					const indent = "  ".repeat(context.listDepth);
+					const start = Number(node.props.start ?? 1);
+					const first = Number.isFinite(start) ? start : 1;
+					const nested = {
+						...context,
+						listDepth: context.listDepth + 1
+					};
+					const lines = collect(node.children, (tag) => tag === "li", () => false).map((item, index) => {
+						const marker = node.tag === "ol" ? `${first + index}.` : "-";
+						const continuation = `${indent}${" ".repeat(marker.length + 1)}`;
+						const [head = "", ...rest] = derive(item, nested).replace(/^\s+/, "").replace(/\s+$/, "").replace(/\n{2,}/g, LINE).split("\n");
+						return [`${indent}${marker} ${head}`, ...rest.map((line) => line.trim() === "" ? "" : /^\s/.test(line) ? line : `${continuation}${line}`)].join(LINE);
+					});
+					return block(lines.join(LINE), PARAGRAPH);
+				}
+				case "table": {
+					if (isLayoutTable(node.props)) return childText(node, context);
+					const rows = collect(node.children, (tag) => tag === "tr", (tag) => TABLE_SECTIONS.has(tag)).map((row) => collect(row.children, (tag) => tag === "td" || tag === "th", () => false).filter((cell) => !isDecorativeCell(cell, context)).map((cell) => childText(cell, context).replace(/\s+/g, " ").trim()).join(" | "));
+					return block(rows.join(LINE), PARAGRAPH);
+				}
+				case "row": return block(collect(node.children, (tag) => tag === "td" || tag === "th", () => false).map((cell) => childText(cell, context).replace(/^\s+|\s+$/g, "")).filter((cell) => cell !== "").join(LINE), LINE);
+				case "table-section":
+				case "cell": return block(childText(node, context), LINE);
+				case "preformatted": return block(childText(node, {
+					...context,
+					preformatted: true
+				}), PARAGRAPH);
+				case "block": return block(childText(node, context), PARAGRAPH);
+			}
+		}
+	}
+};
+/** Collapse the separators the walk emits into readable plain text. */
+const normalize = (value) => value.replace(/\r\n?/g, "\n").split("\n").map((line) => line.replace(/[^\S\n]+$/, "")).join("\n").replace(/\n{3,}/g, PARAGRAPH).trim();
+/** Derive the plain-text alternative from the semantic tree in reading order. */
+const deriveEmailText = (node) => normalize(derive(node, {
+	preformatted: false,
+	listDepth: 0
+}));
+//#endregion
+//#region src/email/render.ts
+/**
+* Lower the derived tree to HTML and its plain-text alternative. A blocking finding leaves no
+* output; every finding comes back in `diagnostics`.
+*/
+const lowerEmail = (node, options = {}) => {
+	const serialized = serializeEmailHtml(node, options);
+	const diagnostics = [...collectEmailDiagnostics(node), ...serialized.diagnostics];
+	if (hasBlockingDiagnostic(diagnostics)) return {
+		output: void 0,
+		diagnostics
+	};
+	return {
+		output: {
+			html: serialized.html,
+			text: deriveEmailText(node),
+			diagnostics,
+			positions: serialized.positions
+		},
+		diagnostics
+	};
+};
+//#endregion
+//#region src/email/footer.ts
+const EMPTY_FOOTER = {
+	html: "",
+	text: "",
+	headCss: ""
+};
+/**
+* Compile `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 its brand import. The footer always carries the
+* unsubscribe row; the send drops it with `withoutUnsubscribeRow` from `./brand` where the message
+* has none. A brand theme outside the grammar leaves no footer and comes back as diagnostics.
+*/
+const compileFooter = async (brand, options = {}) => {
+	const plugin = options.brandPlugin ?? samvaBrandPlugin;
+	const theme = parseBrandCss(brand.css);
+	if (theme.isErr()) return {
+		footer: void 0,
+		diagnostics: theme.error.map((finding) => ({
+			code: finding.code,
+			severity: "error",
+			message: `${plugin.specifier}: ${finding.message}`,
+			origins: []
+		}))
+	};
+	const tailwind = await compileTailwind(BRAND_COMPONENT_CLASSES, { css: printBrandCss(theme.value) });
+	const node = brandComponents(brand, plugin).BrandFooter({});
+	if (node === null) return {
+		footer: EMPTY_FOOTER,
+		diagnostics: []
+	};
+	const styled = applyStylesheet(node, parseStylesheet(tailwind.css, { origin: plugin.specifier }));
+	const lowered = lowerEmail(styled.tree, { brandPlugin: plugin });
+	const diagnostics = [...styled.diagnostics, ...lowered.diagnostics];
+	if (lowered.output === void 0 || hasBlockingDiagnostic(diagnostics)) return {
+		footer: void 0,
+		diagnostics
+	};
+	const text = lowered.output.text.trim();
+	return {
+		footer: {
+			html: lowered.output.html,
+			text: text === "" ? "" : `\n\n---\n${text}`,
+			headCss: `${renderDarkRules(styled.darkRules)}${styled.headCss}`
+		},
+		diagnostics
+	};
+};
+//#endregion
+//#region src/email/brand-preview.ts
+const ENTRY = "sample.tsx";
+const sampleSource = (plugin) => `import { defineTemplate } from "@samva/markup";
+import { Email, Section } from "@samva/markup/email";
+import { jsonSchema } from "@samva/markup/input-schema";
+import { BrandFooter, BrandLogo } from ${JSON.stringify(plugin.specifier)};
+
+export default defineTemplate({
+  id: "brand-preview",
+  schema: jsonSchema({ type: "object", properties: {} }),
+  fixtures: { default: {} },
+  email: {
+    subject: () => "Your order is on its way",
+    body: () => (
+      <Email className="bg-background font-sans">
+        <Section style={{ padding: "32px 24px" }}>
+          <BrandLogo />
+          <h1 className="text-2xl font-semibold text-foreground font-heading">Your order is on its way</h1>
+          <p className="text-base text-foreground font-sans">
+            Thanks for your order. Here is a quick summary, and a link to follow it to your door.
+          </p>
+          <div className="p-4 rounded bg-card text-card-foreground">
+            <p className="inline-block px-2 py-1 text-sm font-semibold rounded bg-accent text-accent-foreground">
+              Order 1042
+            </p>
+            <p className="text-sm text-muted-foreground">2 items, arriving Thursday</p>
+          </div>
+          <p>
+            <a
+              href="https://example.com/orders/1042"
+              className="inline-block px-6 py-3 font-semibold no-underline rounded bg-primary text-primary-foreground"
+            >
+              Track your order
+            </a>
+          </p>
+        </Section>
+        <BrandFooter />
+      </Email>
+    ),
+  },
+});
+`;
+const previewBrand = async (brand, options = {}) => {
+	const plugin = options.brandPlugin ?? samvaBrandPlugin;
+	const compiled = await compileTemplate({
+		files: { [ENTRY]: sampleSource(plugin) },
+		entry: ENTRY,
+		assetBase: "/",
+		tailwind: { css: `@import ${JSON.stringify(plugin.specifier)};` },
+		brand,
+		brandPlugin: plugin
+	});
+	if (compiled.template === void 0) return {
+		html: void 0,
+		diagnostics: compiled.diagnostics
+	};
+	try {
+		const { html } = render(compiled.template, {}, {
+			channel: "email",
+			brandPlugin: plugin
+		});
+		return {
+			html,
+			diagnostics: compiled.diagnostics
+		};
+	} catch (cause) {
+		if (!RenderError.is(cause)) throw cause;
+		return {
+			html: void 0,
+			diagnostics: [...compiled.diagnostics, ...cause.diagnostics.map((finding) => ({
+				code: finding.code,
+				severity: "error",
+				message: finding.message,
+				origins: []
+			}))]
+		};
 	}
-	return findings;
 };
 //#endregion
-export { COMPATIBILITY_PROVENANCE, EMAIL_CLIENT_MATRIX, ESSENTIAL_CONSTRUCTS, TAILWIND_VERSION, TEMPLATE_NAME_PATTERN, applyStylesheet, checkEmailCompatibility, checkStaticProfile, checkTemplateCompatibility, classListOf, compileSelector, compileTailwind, compileTemplate, discoverClassCandidates, downlevelColors, downlevelMediaQuery, finalizeValue, foldCalc, formatColor, hasBlockingCompatibility, introducedProfileErrors, matchesSelector, parseBrandSpecifier, parseColor, parseStylesheet, projectBrandSpecifier, renderBrandFooter, renderBrandSample, renderHeadCss, resolveVariables, transformProject, unknownCoverage };
+export { TEMPLATE_NAME_PATTERN, checkTemplate, compileFooter, compileTemplate, introducedErrors, parseBrandSpecifier, previewBrand, projectBrandSpecifier };