@samva/markup 0.16.0 → 0.17.1

package/dist/compatibility.js

@@ -0,0 +1,807 @@
+import { r as renderEmail } from "./render-template-DwPDm3Hq.js";
+import { n as parseColor } from "./css-color-DLM12Osu.js";
+import { n as matchesSelector } from "./selectors-CYWCoxZr.js";
+import { t as parseStylesheet } from "./css-B_aVKrDo.js";
+import { generate, parse, walk } from "css-tree";
+import { caniemail, parseHtml, rawData } from "caniemail";
+//#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/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 checkHtmlCompatibility = (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/sml/compatibility.ts
+/**
+* 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 fixture the renderer refuses throws
+* its `RenderError`: validate fixtures before asking what they deliver.
+*/
+const checkCompatibility = (template, fixtures, options = {}) => {
+	if (template.email === void 0) return [];
+	const sources = template.sources ?? [];
+	const findings = [];
+	for (const [fixture, input] of Object.entries(fixtures)) {
+		const rendered = renderEmail(template, input, {
+			positions: true,
+			...options.brandPlugin === void 0 ? {} : { brandPlugin: options.brandPlugin }
+		});
+		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(...checkHtmlCompatibility({
+			html: rendered.html,
+			fixture,
+			positions,
+			...options.clients === void 0 ? {} : { clients: options.clients }
+		}));
+	}
+	return findings;
+};
+//#endregion
+export { COMPATIBILITY_PROVENANCE, EMAIL_CLIENT_MATRIX, ESSENTIAL_CONSTRUCTS, checkCompatibility, checkHtmlCompatibility, hasBlockingCompatibility, unknownCoverage };