@samva/markup 0.18.0 → 0.19.0

package/dist/render-template-DwPDm3Hq.js

@@ -1,1226 +0,0 @@
-import { callFormatter, createFmt } from "./fmt.js";
-import { TaggedError } from "better-result";
-//#region src/compiled-template.ts
-/** The version this package writes. A publication pins the version it was built with. */
-const COMPILED_TEMPLATE_VERSION = 1;
-//#endregion
-//#region src/email/samva-brand-plugin.ts
-/**
-* Samva's brand plugin, the compiler's default. A template imports its
-* organization's brand from `samva:brand`, and Samva's send path fills
-* `%samva:unsubscribe-url%` per delivery and turns `data-samva-no-track` into
-* its email provider's own no-track marker.
-*/
-const samvaBrandPlugin = {
-	specifier: "samva:brand",
-	footerAttribute: "data-samva-footer",
-	unsubscribeRowAttribute: "data-samva-unsubscribe",
-	unsubscribeUrlPlaceholder: "%samva:unsubscribe-url%",
-	noTrackAttribute: "data-samva-no-track"
-};
-//#endregion
-//#region src/email/brand-plugin.ts
-const SLUG = "[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?";
-const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&");
-/** `<specifier>` or `<specifier>/<slug>`, as a regular expression source with no groups. */
-const brandSpecifierPattern = (plugin) => `${escapeRegExp(plugin.specifier)}(?:\\/${SLUG})?`;
-/** The brand a specifier names: `undefined` slug means the default brand; `undefined` when it names none. */
-const parseBrandSpecifier = (specifier, options = {}) => {
-	const plugin = options.brandPlugin ?? samvaBrandPlugin;
-	const match = new RegExp(`^${escapeRegExp(plugin.specifier)}(?:\\/(${SLUG}))?$`).exec(specifier);
-	return match === null ? void 0 : { slug: match[1] };
-};
-/** The attributes only `BrandFooter` writes; an authored element carrying one is refused. */
-const reservedBrandAttributes = (plugin) => /* @__PURE__ */ new Set([
-	plugin.footerAttribute,
-	plugin.unsubscribeRowAttribute,
-	plugin.noTrackAttribute
-]);
-//#endregion
-//#region src/email/elements.ts
-/** Attributes every supported element accepts. `class`/`className`/`style` are handled separately. */
-const EMAIL_GLOBAL_ATTRIBUTES = {
-	id: { type: "string" },
-	title: { type: "string" },
-	lang: { type: "string" },
-	dir: {
-		type: "string",
-		values: [
-			"ltr",
-			"rtl",
-			"auto"
-		]
-	},
-	role: { type: "string" }
-};
-const alignment = {
-	type: "string",
-	values: [
-		"left",
-		"center",
-		"right"
-	]
-};
-const verticalAlignment = {
-	type: "string",
-	values: [
-		"top",
-		"middle",
-		"bottom"
-	]
-};
-const flowAttributes = { align: alignment };
-const cellAttributes = {
-	align: alignment,
-	valign: verticalAlignment,
-	width: { type: "measure" },
-	height: { type: "measure" },
-	bgcolor: { type: "string" },
-	colspan: { type: "number" },
-	rowspan: { type: "number" }
-};
-const block = (attributes) => ({
-	content: "flow",
-	layout: "block",
-	attributes
-});
-const inline = () => ({
-	content: "flow",
-	layout: "inline",
-	attributes: {}
-});
-/** The complete supported vocabulary. Anything outside it is a compile error with a source location. */
-const EMAIL_ELEMENTS = {
-	html: {
-		content: "flow",
-		layout: "document",
-		attributes: {
-			xmlns: { type: "string" },
-			"xmlns:o": { type: "string" },
-			"xmlns:v": { type: "string" },
-			"xmlns:w": { type: "string" }
-		},
-		childElements: ["head", "body"]
-	},
-	head: {
-		content: "flow",
-		layout: "metadata",
-		attributes: {},
-		childElements: [
-			"title",
-			"meta",
-			"style"
-		]
-	},
-	title: {
-		content: "text",
-		layout: "metadata",
-		attributes: {}
-	},
-	style: {
-		content: "raw",
-		layout: "metadata",
-		attributes: { type: { type: "string" } }
-	},
-	meta: {
-		content: "void",
-		layout: "metadata",
-		attributes: {
-			name: { type: "string" },
-			content: { type: "string" },
-			charset: { type: "string" },
-			"http-equiv": { type: "string" }
-		}
-	},
-	body: {
-		content: "flow",
-		layout: "block",
-		attributes: { bgcolor: { type: "string" } }
-	},
-	div: block(flowAttributes),
-	section: block(flowAttributes),
-	article: block(flowAttributes),
-	header: block(flowAttributes),
-	footer: block(flowAttributes),
-	main: block(flowAttributes),
-	center: block({}),
-	p: block(flowAttributes),
-	blockquote: block(flowAttributes),
-	pre: {
-		content: "flow",
-		layout: "preformatted",
-		attributes: {}
-	},
-	h1: block(flowAttributes),
-	h2: block(flowAttributes),
-	h3: block(flowAttributes),
-	h4: block(flowAttributes),
-	h5: block(flowAttributes),
-	h6: block(flowAttributes),
-	span: inline(),
-	strong: inline(),
-	b: inline(),
-	em: inline(),
-	i: inline(),
-	u: inline(),
-	s: inline(),
-	small: inline(),
-	code: inline(),
-	a: {
-		content: "flow",
-		layout: "link",
-		attributes: {
-			href: {
-				type: "url",
-				required: true
-			},
-			target: { type: "string" },
-			rel: { type: "string" },
-			name: { type: "string" }
-		}
-	},
-	img: {
-		content: "void",
-		layout: "image",
-		attributes: {
-			src: {
-				type: "url",
-				required: true
-			},
-			alt: {
-				type: "string",
-				required: true
-			},
-			width: { type: "measure" },
-			height: { type: "measure" },
-			border: { type: "measure" },
-			align: alignment
-		}
-	},
-	table: {
-		content: "flow",
-		layout: "table",
-		attributes: {
-			width: { type: "measure" },
-			height: { type: "measure" },
-			border: { type: "measure" },
-			cellpadding: { type: "measure" },
-			cellspacing: { type: "measure" },
-			align: alignment,
-			bgcolor: { type: "string" }
-		},
-		childElements: [
-			"caption",
-			"colgroup",
-			"thead",
-			"tbody",
-			"tfoot",
-			"tr"
-		]
-	},
-	caption: {
-		content: "flow",
-		layout: "block",
-		attributes: flowAttributes
-	},
-	colgroup: {
-		content: "flow",
-		layout: "table-section",
-		attributes: {
-			span: { type: "number" },
-			width: { type: "measure" }
-		},
-		childElements: ["col"]
-	},
-	col: {
-		content: "void",
-		layout: "table-section",
-		attributes: {
-			span: { type: "number" },
-			width: { type: "measure" }
-		}
-	},
-	thead: {
-		content: "flow",
-		layout: "table-section",
-		attributes: {
-			align: alignment,
-			valign: verticalAlignment,
-			bgcolor: { type: "string" }
-		},
-		childElements: ["tr"]
-	},
-	tbody: {
-		content: "flow",
-		layout: "table-section",
-		attributes: {
-			align: alignment,
-			valign: verticalAlignment,
-			bgcolor: { type: "string" }
-		},
-		childElements: ["tr"]
-	},
-	tfoot: {
-		content: "flow",
-		layout: "table-section",
-		attributes: {
-			align: alignment,
-			valign: verticalAlignment,
-			bgcolor: { type: "string" }
-		},
-		childElements: ["tr"]
-	},
-	tr: {
-		content: "flow",
-		layout: "row",
-		attributes: {
-			align: alignment,
-			valign: verticalAlignment,
-			bgcolor: { type: "string" },
-			height: { type: "measure" }
-		},
-		childElements: ["td", "th"]
-	},
-	td: {
-		content: "flow",
-		layout: "cell",
-		attributes: cellAttributes
-	},
-	th: {
-		content: "flow",
-		layout: "cell",
-		attributes: cellAttributes
-	},
-	ul: {
-		content: "flow",
-		layout: "list",
-		attributes: {},
-		childElements: ["li"]
-	},
-	ol: {
-		content: "flow",
-		layout: "list",
-		attributes: {
-			start: { type: "number" },
-			type: { type: "string" }
-		},
-		childElements: ["li"]
-	},
-	li: {
-		content: "flow",
-		layout: "list-item",
-		attributes: {}
-	},
-	br: {
-		content: "void",
-		layout: "break",
-		attributes: {}
-	},
-	hr: {
-		content: "void",
-		layout: "rule",
-		attributes: {
-			width: { type: "measure" },
-			size: { type: "number" },
-			align: alignment
-		}
-	}
-};
-/** Attributes that must carry a URL; these are checked against the safe-scheme rule. */
-const isUrlAttribute = (tag, attribute) => {
-	return EMAIL_ELEMENTS[tag]?.attributes[attribute]?.type === "url";
-};
-/** Look up one supported element, or `undefined` when the tag is outside the vocabulary. */
-const emailElement = (tag) => Object.hasOwn(EMAIL_ELEMENTS, tag) ? EMAIL_ELEMENTS[tag] : void 0;
-//#endregion
-//#region src/sms-segments.ts
-const GSM7_EXTENDED = /* @__PURE__ */ new Set([
-	"[",
-	"]",
-	"{",
-	"}",
-	"\\",
-	"~",
-	"|",
-	"€",
-	"^",
-	"\f"
-]);
-const GSM7_BASIC_PATTERN = /^[@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞÆæßÉ !"#¤%&'()*+,\-./:;<=>?¡0-9ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijklmnopqrstuvwxyzäöñüà]*$/;
-const containsNonGsmCharacters = (text) => {
-	for (const char of text) {
-		if (GSM7_EXTENDED.has(char)) continue;
-		if (!GSM7_BASIC_PATTERN.test(char)) return true;
-	}
-	return false;
-};
-const smsSegmentInfo = (text) => {
-	if (containsNonGsmCharacters(text)) {
-		const codePoints = [...text].length;
-		const segmentCount = codePoints <= 70 ? 1 : Math.ceil(codePoints / 67);
-		return {
-			encoding: "ucs2",
-			characterCount: text.length,
-			segmentCount
-		};
-	}
-	let encodedLength = 0;
-	for (const char of text) encodedLength += GSM7_EXTENDED.has(char) ? 2 : 1;
-	const segmentCount = encodedLength <= 160 ? 1 : Math.ceil(encodedLength / 153);
-	return {
-		encoding: "gsm7",
-		characterCount: text.length,
-		segmentCount
-	};
-};
-//#endregion
-//#region src/render-template.ts
-var RenderError = class extends TaggedError("RenderError") {
-	constructor(args) {
-		super({
-			diagnostics: args.diagnostics,
-			message: `Template render rejected: ${args.diagnostics.map((item) => `${item.code}: ${item.message}`).join("; ")}`
-		});
-	}
-};
-const fail = (code, message) => {
-	throw new RenderError({ diagnostics: [{
-		code,
-		message
-	}] });
-};
-const MAX_ITERATIONS = 1e4;
-const MAX_DEPTH = 64;
-/** Classic Outlook lays a document out correctly only under a transitional doctype. */
-const EMAIL_DOCTYPE = "<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">";
-const PREHEADER_TARGET_LENGTH = 200;
-const PREHEADER_PADDING = "\xA0‌​‍‎‏";
-const escapeText = (value) => value.replace(/[&<>]/g, (character) => ({
-	"&": "&amp;",
-	"<": "&lt;",
-	">": "&gt;"
-})[character] ?? character);
-const escapeAttribute = (value) => value.replace(/[&<>"']/g, (character) => ({
-	"&": "&amp;",
-	"<": "&lt;",
-	">": "&gt;",
-	"\"": "&quot;",
-	"'": "&#39;"
-})[character] ?? character);
-const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f]/;
-const SAFE_URL_SCHEME = /^(https:\/\/|mailto:|tel:|cid:|#)/i;
-/** A delivered message can resolve only an absolute URL, so relative references are refused. */
-const isSafeUrl = (value) => !/^[\u0000- ]/.test(value) && !CONTROL_CHARACTERS.test(value) && !value.includes("\\") && SAFE_URL_SCHEME.test(value);
-const CSS_PROPERTY = /^(--[a-zA-Z0-9-]+|[a-zA-Z][a-zA-Z0-9-]*)$/;
-const CSS_UNSAFE = /[;{}<>\\]|expression\s*\(|@import|\/\*/i;
-const CSS_URL = /url\(\s*(['"]?)([^'")]*)\1\s*\)/gi;
-const kebab = (property) => property.startsWith("--") ? property : property.replace(/[A-Z]/g, (l) => `-${l.toLowerCase()}`);
-const UNITLESS = /* @__PURE__ */ new Set([
-	"opacity",
-	"zIndex",
-	"fontWeight",
-	"lineHeight",
-	"order",
-	"flexGrow",
-	"flexShrink",
-	"columnCount",
-	"orphans",
-	"widows",
-	"zoom",
-	"fillOpacity",
-	"strokeOpacity"
-]);
-const declarationValue = (property, value) => typeof value === "number" && value !== 0 && !UNITLESS.has(property) && !property.startsWith("--") ? `${value}px` : String(value);
-const report = (ctx, code, message) => {
-	ctx.diagnostics.push({
-		code,
-		message
-	});
-};
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const has = (value, key) => Object.hasOwn(value, key);
-const FORBIDDEN_SEGMENTS = /* @__PURE__ */ new Set([
-	"__proto__",
-	"constructor",
-	"prototype"
-]);
-const ARRAY_INDEX = /^(0|[1-9]\d*)$/;
-const step = (value, segment) => {
-	if (FORBIDDEN_SEGMENTS.has(segment)) return void 0;
-	if (Array.isArray(value)) return ARRAY_INDEX.test(segment) && Object.hasOwn(value, segment) ? value[Number(segment)] : void 0;
-	if (isRecord(value) && Object.hasOwn(value, segment)) return value[segment];
-};
-const resolvePath = (ctx, scope, path) => {
-	if (typeof path !== "string" || path === "") return void 0;
-	const [first = "", ...rest] = path.split(".");
-	if (FORBIDDEN_SEGMENTS.has(first)) return void 0;
-	let current = first.startsWith("$") ? scope.get(first) : step(ctx.input, first);
-	for (const segment of rest) {
-		if (current === void 0 || current === null) return void 0;
-		current = step(current, segment);
-	}
-	return current;
-};
-const invalid = (message) => fail("invalid-value", message);
-/** The text a value contributes: strings as is, finite numbers, nothing for null and booleans. */
-const textOf = (value) => {
-	if (typeof value === "string") return value;
-	if (typeof value === "number") return Number.isFinite(value) ? String(value) : invalid("A non-finite number cannot be text.");
-	if (value === null || value === void 0 || typeof value === "boolean") return "";
-	return invalid("An object or array cannot be rendered as text.");
-};
-const finiteNumber = (value, what) => typeof value === "number" && Number.isFinite(value) ? value : invalid(`${what} must be a finite number.`);
-const arithmetic = (op, left, right) => {
-	if ((op === "/" || op === "%") && right === 0) return invalid("Division by zero.");
-	let result;
-	switch (op) {
-		case "+":
-			result = left + right;
-			break;
-		case "-":
-			result = left - right;
-			break;
-		case "*":
-			result = left * right;
-			break;
-		case "/":
-			result = left / right;
-			break;
-		case "%":
-			result = left % right;
-			break;
-		default: return invalid(`Unknown arithmetic operator ${JSON.stringify(op)}.`);
-	}
-	return Number.isFinite(result) ? result : invalid("Arithmetic produced a non-finite number.");
-};
-const formatterContext = (ctx) => {
-	ctx.fmt ??= createFmt({
-		locale: ctx.locale,
-		timeZone: ctx.timeZone
-	});
-	return ctx.fmt;
-};
-const applyFormat = (ctx, name, args) => {
-	if (typeof name !== "string") return invalid("A format node needs a formatter name.");
-	try {
-		return callFormatter(formatterContext(ctx), name, args);
-	} catch (error) {
-		return fail("format-error", error instanceof Error ? error.message : String(error));
-	}
-};
-const nullish = (value) => value === void 0 ? null : value;
-const compare = (op, left, right) => {
-	switch (op) {
-		case "eq": return nullish(left) === nullish(right);
-		case "ne": return nullish(left) !== nullish(right);
-		case "lt":
-		case "gt":
-		case "le":
-		case "ge": {
-			if (!(typeof left === "number" && typeof right === "number" || typeof left === "string" && typeof right === "string")) return false;
-			const a = left;
-			const b = right;
-			if (op === "lt") return a < b;
-			if (op === "gt") return a > b;
-			return op === "le" ? a <= b : a >= b;
-		}
-		default: return invalid(`Unknown comparison ${JSON.stringify(op)}.`);
-	}
-};
-const checkDepth = (depth) => {
-	if (depth > MAX_DEPTH) fail("render-limit", `Templates nest at most ${MAX_DEPTH} levels deep.`);
-};
-const evalArgs = (ctx, scope, args, depth) => Array.isArray(args) ? args.map((arg) => evalValue(ctx, scope, arg, depth + 1)) : invalid("Arguments must be an array.");
-const evalValue = (ctx, scope, value, depth) => {
-	checkDepth(depth);
-	if (value === null || typeof value !== "object") return value;
-	if (Array.isArray(value)) return invalid("Unknown value node.");
-	const node = value;
-	if (has(node, "bind")) return resolvePath(ctx, scope, node.bind);
-	if (has(node, "lit")) return node.lit;
-	if (has(node, "concat")) return evalArgs(ctx, scope, node.concat, depth).map(textOf).join("");
-	if (has(node, "format")) return applyFormat(ctx, node.format, evalArgs(ctx, scope, node.args, depth));
-	if (has(node, "if")) return evalPredicate(ctx, scope, node.if, depth + 1) ? evalValue(ctx, scope, node.then, depth + 1) : evalValue(ctx, scope, node.else, depth + 1);
-	if (has(node, "op")) {
-		const [left, right] = evalArgs(ctx, scope, node.args, depth);
-		return arithmetic(node.op, finiteNumber(left, "An arithmetic operand"), finiteNumber(right, "An arithmetic operand"));
-	}
-	if (has(node, "count")) {
-		const items = evalValue(ctx, scope, node.count, depth + 1);
-		if (!Array.isArray(items)) return invalid("count applies to an array.");
-		return selectItems(ctx, scope, items, String(node.as), node.where, depth).length;
-	}
-	if (has(node, "length")) {
-		const measured = evalValue(ctx, scope, node.length, depth + 1);
-		return typeof measured === "string" || Array.isArray(measured) ? measured.length : invalid("length applies to a string or an array.");
-	}
-	return invalid("Unknown value node.");
-};
-const evalPredicate = (ctx, scope, predicate, depth) => {
-	checkDepth(depth);
-	if (typeof predicate !== "object" || predicate === null || Array.isArray(predicate)) return invalid("Unknown predicate.");
-	const node = predicate;
-	if (has(node, "present")) return Boolean(resolvePath(ctx, scope, node.present));
-	if (has(node, "truthy")) return Boolean(evalValue(ctx, scope, node.truthy, depth + 1));
-	if (has(node, "not")) return !evalPredicate(ctx, scope, node.not, depth + 1);
-	if (has(node, "and")) return asArray(node.and).every((item) => evalPredicate(ctx, scope, item, depth + 1));
-	if (has(node, "or")) return asArray(node.or).some((item) => evalPredicate(ctx, scope, item, depth + 1));
-	if (has(node, "cmp")) {
-		const [left, right] = evalArgs(ctx, scope, node.args, depth);
-		return compare(node.cmp, left, right);
-	}
-	return invalid("Unknown predicate.");
-};
-const asArray = (value) => Array.isArray(value) ? value : invalid("Expected an array.");
-const declarations = (ctx, scope, entries, depth) => {
-	const parts = [];
-	for (const entry of entries) {
-		if (!Array.isArray(entry) || entry.length !== 2) {
-			report(ctx, "invalid-style", "A style declaration is a [property, value] pair.");
-			continue;
-		}
-		const [property, raw] = entry;
-		const value = evalValue(ctx, scope, raw, depth + 1);
-		if (value === void 0 || value === null) continue;
-		if (typeof property !== "string" || !CSS_PROPERTY.test(property)) {
-			report(ctx, "unsupported-style-property", `Style property ${JSON.stringify(property)} is not a CSS property name.`);
-			continue;
-		}
-		if (typeof value !== "string" && !(typeof value === "number" && Number.isFinite(value))) {
-			report(ctx, "invalid-style-value", `Style ${property} must be a string or finite number.`);
-			continue;
-		}
-		const text = declarationValue(property, value);
-		if (CSS_UNSAFE.test(text) || CONTROL_CHARACTERS.test(text)) {
-			report(ctx, "unsafe-style-value", `Style ${property} contains CSS that could break out of the declaration.`);
-			continue;
-		}
-		let unsafeUrl;
-		for (const match of text.matchAll(CSS_URL)) if (!isSafeUrl(match[2] ?? "")) unsafeUrl = match[2] ?? "";
-		if (unsafeUrl !== void 0) {
-			report(ctx, "unsafe-url", `Style ${property} points at ${JSON.stringify(unsafeUrl)}; email URLs must use https:, mailto:, tel:, cid: or a fragment.`);
-			continue;
-		}
-		parts.push(`${kebab(property)}:${text}`);
-	}
-	return parts.join(";");
-};
-const styleText = (ctx, scope, style, depth) => {
-	checkDepth(depth);
-	if (typeof style === "string") {
-		if (CONTROL_CHARACTERS.test(style)) {
-			report(ctx, "unsafe-style-value", "A style contains control characters.");
-			return "";
-		}
-		return style;
-	}
-	if (Array.isArray(style)) return declarations(ctx, scope, style, depth);
-	if (isRecord(style) && has(style, "if")) return evalPredicate(ctx, scope, style.if, depth + 1) ? styleText(ctx, scope, style.then, depth + 1) : styleText(ctx, scope, style.else, depth + 1);
-	report(ctx, "invalid-style", "An element style is a string, a declaration list or a conditional.");
-	return "";
-};
-const attributeText = (ctx, tag, name, spec, value) => {
-	if (value === void 0 || value === null || value === false) return void 0;
-	if (value === true) return "";
-	if (typeof value !== "string" && !(typeof value === "number" && Number.isFinite(value))) {
-		report(ctx, "invalid-attribute-value", `<${tag} ${name}> must be a string or finite number, not ${typeof value}.`);
-		return;
-	}
-	const text = String(value);
-	if (CONTROL_CHARACTERS.test(text)) {
-		report(ctx, "invalid-attribute-value", `<${tag} ${name}> contains control characters.`);
-		return;
-	}
-	if (spec.values !== void 0 && !spec.values.includes(text)) {
-		report(ctx, "invalid-attribute-value", `<${tag} ${name}> accepts ${spec.values.join(", ")}; received ${JSON.stringify(text)}.`);
-		return;
-	}
-	if (spec.type === "number" && !/^-?\d+$/.test(text)) {
-		report(ctx, "invalid-attribute-value", `<${tag} ${name}> must be an integer.`);
-		return;
-	}
-	if (spec.type === "measure" && !/^\d+(\.\d+)?%?$/.test(text)) {
-		report(ctx, "invalid-attribute-value", `<${tag} ${name}> must be a pixel count or a percentage.`);
-		return;
-	}
-	if (spec.type === "url" && !isSafeUrl(text)) {
-		report(ctx, "unsafe-url", `<${tag} ${name}> must use https:, mailto:, tel:, cid: or a fragment; received ${JSON.stringify(text)}. A relative path resolves only in an export, never in a delivered message.`);
-		return;
-	}
-	return text;
-};
-const buildAttributes = (ctx, scope, tag, spec, node, props, depth) => {
-	const emitted = [];
-	const present = /* @__PURE__ */ new Set();
-	let classes;
-	const source = node.attrs ?? {};
-	if (!isRecord(source)) {
-		report(ctx, "invalid-attribute-value", `<${tag}> attrs must be an object.`);
-		return "";
-	}
-	for (const [key, raw] of Object.entries(source)) {
-		if (key === "key") continue;
-		const name = key === "className" ? "class" : key;
-		const value = evalValue(ctx, scope, raw, depth + 1);
-		props.set(name, value);
-		if (tag === "a" && name === "href" && raw === ctx.brandPlugin.unsubscribeUrlPlaceholder) {
-			present.add(name);
-			emitted.push(` href="${escapeAttribute(ctx.brandPlugin.unsubscribeUrlPlaceholder)}" ${ctx.brandPlugin.noTrackAttribute}`);
-			continue;
-		}
-		if (name === "class") {
-			if (value === void 0 || value === null) continue;
-			if (typeof value !== "string") {
-				report(ctx, "invalid-attribute-value", `<${tag} class> must be a string.`);
-				continue;
-			}
-			if (CONTROL_CHARACTERS.test(value)) {
-				report(ctx, "invalid-attribute-value", `<${tag} class> contains control characters.`);
-				continue;
-			}
-			if (classes !== void 0) {
-				report(ctx, "duplicate-attribute", `<${tag}> sets both class and className; keep one.`);
-				continue;
-			}
-			classes = value;
-			emitted.push(` class="${escapeAttribute(value)}"`);
-			continue;
-		}
-		if (name === "style") {
-			report(ctx, "invalid-style", `<${tag}> writes its style on the element, not as an attribute.`);
-			continue;
-		}
-		if (/^on/i.test(name)) {
-			report(ctx, "event-handler", `<${tag} ${name}> is an event handler; email clients strip scripting and Samva refuses it.`);
-			continue;
-		}
-		if (ctx.reservedAttributes.has(name) && node.reserved !== true) {
-			report(ctx, "reserved-attribute", `<${tag} ${name}> is reserved for the brand footer.`);
-			continue;
-		}
-		if (/^(data|aria)-[a-z0-9-]+$/.test(name)) {
-			const text = attributeText(ctx, tag, name, { type: "string" }, value);
-			if (text !== void 0) emitted.push(` ${name}="${escapeAttribute(text)}"`);
-			continue;
-		}
-		const globals = EMAIL_GLOBAL_ATTRIBUTES;
-		const attribute = Object.hasOwn(globals, name) ? globals[name] : Object.hasOwn(spec.attributes, name) ? spec.attributes[name] : void 0;
-		if (attribute === void 0) {
-			report(ctx, "unsupported-attribute", `<${tag}> does not support the ${name} attribute.`);
-			continue;
-		}
-		present.add(name);
-		const text = attributeText(ctx, tag, name, attribute, value);
-		if (text !== void 0) emitted.push(` ${name}="${escapeAttribute(text)}"`);
-	}
-	for (const [name, attribute] of Object.entries(spec.attributes)) if (attribute.required === true && !present.has(name)) report(ctx, "missing-attribute", `<${tag}> requires the ${name} attribute.`);
-	if (node.style !== void 0) {
-		const css = styleText(ctx, scope, node.style, depth + 1);
-		if (css !== "") emitted.push(` style="${escapeAttribute(css)}"`);
-	}
-	return emitted.join("");
-};
-const checkContentModel = (ctx, tag, spec, children) => {
-	if (spec.content === "void") {
-		if (children.length > 0) report(ctx, "void-element-children", `<${tag}> cannot have children.`);
-		return;
-	}
-	if (spec.content === "text" || spec.content === "raw") {
-		for (const child of children) if (child.t !== "text") report(ctx, "invalid-content", `<${tag}> accepts text only.`);
-		return;
-	}
-	if (spec.childElements === void 0) return;
-	for (const child of children) {
-		if (child.t === "raw") continue;
-		if (child.t === "text") {
-			if (child.v.trim() !== "") report(ctx, "invalid-content", `<${tag}> cannot contain text directly; put it inside <${spec.childElements[0]}>.`);
-			continue;
-		}
-		if (!spec.childElements.includes(child.tag)) report(ctx, "invalid-content", `<${tag}> accepts only ${spec.childElements.map((name) => `<${name}>`).join(", ")}; found <${child.tag}>.`);
-	}
-};
-const pushText = (out, value) => {
-	if (value === null || value === void 0 || typeof value === "boolean") return;
-	out.push({
-		t: "text",
-		v: textOf(value)
-	});
-};
-const evalElement = (ctx, scope, node, depth, out) => {
-	const tag = node.el;
-	if (ctx.plain) {
-		report(ctx, "unsupported-element", "A plain-text body cannot contain elements.");
-		return;
-	}
-	const spec = typeof tag === "string" ? emailElement(tag) : void 0;
-	if (spec === void 0) {
-		report(ctx, "unsupported-element", `<${String(tag)}> is not part of the supported email vocabulary.`);
-		return;
-	}
-	const children = [];
-	for (const child of node.children ?? []) evalNode(ctx, scope, child, depth + 1, children);
-	checkContentModel(ctx, tag, spec, children);
-	if (spec.content === "raw") {
-		const css = children.map((child) => child.t === "text" ? child.v : "").join("");
-		if (/<\/|<!--/i.test(css)) {
-			report(ctx, "unsafe-raw-text", `<${tag}> content cannot contain markup.`);
-			return;
-		}
-	}
-	const props = /* @__PURE__ */ new Map();
-	const attrs = buildAttributes(ctx, scope, tag, spec, node, props, depth);
-	out.push({
-		t: "el",
-		tag,
-		content: spec.content,
-		layout: spec.layout,
-		attrs,
-		props,
-		children,
-		src: node.src
-	});
-};
-const evalRaw = (ctx, scope, node, depth, out) => {
-	if (ctx.plain) {
-		out.push({
-			t: "text",
-			v: node.text === void 0 ? "" : textOf(evalValue(ctx, scope, node.text, depth + 1))
-		});
-		return;
-	}
-	const html = asArray(node.raw).map((part) => rawPart(ctx, scope, part, depth + 1)).join("");
-	const text = node.text === void 0 ? "" : textOf(evalValue(ctx, scope, node.text, depth + 1));
-	out.push({
-		t: "raw",
-		html,
-		text
-	});
-};
-const rawPart = (ctx, scope, part, depth) => {
-	if (typeof part === "string") return part;
-	const record = part;
-	if (isRecord(record) && has(record, "attr")) return escapeAttribute(textOf(evalValue(ctx, scope, record.attr, depth + 1)));
-	if (isRecord(record) && has(record, "text")) return escapeText(textOf(evalValue(ctx, scope, record.text, depth + 1)));
-	return invalid("A raw part is a string, {attr} or {text}.");
-};
-const loopKey = (name) => name.startsWith("$") ? name : `$${name}`;
-/** The items that satisfy a `where` clause, each bound as the loop variable while it is tested. */
-const selectItems = (ctx, scope, items, as, where, depth) => {
-	if (where === void 0) return items;
-	const key = loopKey(as);
-	return items.filter((item) => {
-		if (++ctx.iterations > MAX_ITERATIONS) fail("render-limit", `A render iterates at most ${MAX_ITERATIONS} times.`);
-		const inner = new Map(scope);
-		inner.set(key, item);
-		return evalPredicate(ctx, inner, where, depth + 1);
-	});
-};
-const evalEach = (ctx, scope, node, depth, out) => {
-	const source = evalValue(ctx, scope, node.each, depth + 1);
-	if (!Array.isArray(source)) invalid("each needs an array.");
-	const selected = selectItems(ctx, scope, source, String(node.as), node.where, depth);
-	let items = selected;
-	if (node.chunk !== void 0) {
-		if (!Number.isInteger(node.chunk) || node.chunk < 1) invalid("chunk is a positive integer.");
-		const slices = [];
-		for (let at = 0; at < selected.length; at += node.chunk) slices.push(selected.slice(at, at + node.chunk));
-		items = slices;
-	}
-	const itemKey = loopKey(String(node.as));
-	const indexKey = node.index === void 0 ? void 0 : loopKey(String(node.index));
-	for (const [index, item] of items.entries()) {
-		if (++ctx.iterations > MAX_ITERATIONS) fail("render-limit", `A render iterates at most ${MAX_ITERATIONS} times.`);
-		const inner = new Map(scope);
-		inner.set(itemKey, item);
-		if (indexKey !== void 0) inner.set(indexKey, index);
-		for (const child of asArray(node.children)) evalNode(ctx, inner, child, depth + 1, out);
-	}
-};
-const evalNode = (ctx, scope, node, depth, out) => {
-	checkDepth(depth);
-	if (node === null || typeof node !== "object") {
-		pushText(out, node);
-		return;
-	}
-	if (!isRecord(node)) {
-		invalid("An array cannot be rendered as a node.");
-		return;
-	}
-	if (has(node, "el")) return evalElement(ctx, scope, node, depth, out);
-	if (has(node, "each")) return evalEach(ctx, scope, node, depth, out);
-	if (has(node, "raw")) return evalRaw(ctx, scope, node, depth, out);
-	if (has(node, "preheader")) {
-		if (!ctx.markerUsed && ctx.preheader !== void 0 && !ctx.plain) {
-			ctx.markerUsed = true;
-			out.push(preheaderBlock(ctx, ctx.preheader));
-		}
-		return;
-	}
-	if (has(node, "if") && Array.isArray(node.then)) {
-		const branch = evalPredicate(ctx, scope, node.if, depth + 1) ? node.then : node.else ?? [];
-		for (const child of branch) evalNode(ctx, scope, child, depth + 1, out);
-		return;
-	}
-	pushText(out, evalValue(ctx, scope, node, depth + 1));
-};
-const PREHEADER_STYLE = [
-	["display", "none"],
-	["overflow", "hidden"],
-	["lineHeight", "1px"],
-	["opacity", 0],
-	["maxHeight", 0],
-	["maxWidth", 0]
-];
-/** The hidden inbox-preview block: the text, then padding so the client cannot borrow body copy. */
-const preheaderBlock = (ctx, text) => {
-	const children = [text];
-	if (text.length < PREHEADER_TARGET_LENGTH) children.push({
-		el: "div",
-		attrs: { "data-samva-preheader-padding": true },
-		children: [PREHEADER_PADDING.repeat(Math.ceil((PREHEADER_TARGET_LENGTH - text.length) / 7))]
-	});
-	const out = [];
-	evalElement(ctx, /* @__PURE__ */ new Map(), {
-		el: "div",
-		attrs: { "data-samva-preheader": text },
-		style: PREHEADER_STYLE,
-		children
-	}, 0, out);
-	return out[0] ?? {
-		t: "text",
-		v: ""
-	};
-};
-/** Put the block first inside `<body>`, or return undefined when there is no body. */
-const insertPreheader = (nodes, block) => {
-	for (const [index, node] of nodes.entries()) {
-		if (node.t !== "el") continue;
-		if (node.tag === "body") return nodes.with(index, {
-			...node,
-			children: [block, ...node.children]
-		});
-		const replaced = insertPreheader(node.children, block);
-		if (replaced !== void 0) return nodes.with(index, {
-			...node,
-			children: replaced
-		});
-	}
-};
-const serialize = (node) => {
-	switch (node.t) {
-		case "text": return escapeText(node.v);
-		case "raw": return node.html;
-		case "el":
-			if (node.content === "raw") {
-				const css = node.children.map((child) => child.t === "text" ? child.v : "").join("");
-				return css === "" ? "" : `<${node.tag}${node.attrs}>${css}</${node.tag}>`;
-			}
-			if (node.content === "void") return `<${node.tag}${node.attrs} />`;
-			return `<${node.tag}${node.attrs}>${node.children.map(serialize).join("")}</${node.tag}>`;
-	}
-};
-/** Serialize while recording where each element lands, for the same document `serialize` writes. */
-const serializeWithPositions = (nodes, offset) => {
-	const positions = [];
-	let written = offset;
-	const write = (node) => {
-		switch (node.t) {
-			case "text": {
-				const out = escapeText(node.v);
-				written += out.length;
-				return out;
-			}
-			case "raw":
-				written += node.html.length;
-				return node.html;
-			case "el": {
-				const start = written;
-				let out;
-				if (node.content === "raw") {
-					const css = node.children.map((child) => child.t === "text" ? child.v : "").join("");
-					out = css === "" ? "" : `<${node.tag}${node.attrs}>${css}</${node.tag}>`;
-					written += out.length;
-				} else if (node.content === "void") {
-					out = `<${node.tag}${node.attrs} />`;
-					written += out.length;
-				} else {
-					const open = `<${node.tag}${node.attrs}>`;
-					written += open.length;
-					const inner = node.children.map(write).join("");
-					const close = `</${node.tag}>`;
-					written += close.length;
-					out = `${open}${inner}${close}`;
-				}
-				positions.push({
-					start,
-					end: written,
-					tag: node.tag,
-					...node.src === void 0 ? {} : { src: node.src }
-				});
-				return out;
-			}
-		}
-	};
-	return {
-		html: nodes.map(write).join(""),
-		positions
-	};
-};
-const PARAGRAPH = "\n\n";
-const LINE = "\n";
-const INVISIBLE = /​|‌|‍|‎|‏|⁠|/g;
-const TABLE_SECTIONS = /* @__PURE__ */ new Set([
-	"thead",
-	"tbody",
-	"tfoot"
-]);
-const isLayoutTable = (props) => props.get("role") === "presentation" || props.get("role") === "none";
-const wrap = (inner, separator) => {
-	const trimmed = inner.replace(/^\s+/, "").replace(/\s+$/, "");
-	return trimmed === "" ? "" : `${separator}${trimmed}${separator}`;
-};
-const collect = (nodes, keep, descend) => nodes.flatMap((child) => {
-	if (child.t !== "el") return [];
-	if (keep(child.tag)) return [child];
-	return descend(child.tag) ? collect(child.children, keep, descend) : [];
-});
-const childText = (node, context) => node.children.map((child) => derive(child, context)).join("");
-const isDecorativeCell = (cell, context) => {
-	const images = collect(cell.children, (tag) => tag === "img", () => true);
-	return images.length > 0 && images.every((image) => image.props.get("alt") === "") && childText(cell, context).trim() === "";
-};
-const deriveList = (node, context) => {
-	const indent = "  ".repeat(context.listDepth);
-	const start = Number(node.props.get("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 wrap(lines.join(LINE), PARAGRAPH);
-};
-const deriveTable = (node, context) => {
-	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 wrap(rows.join(LINE), PARAGRAPH);
-};
-const deriveElement = (node, context) => {
-	switch (node.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 = node.props.get("alt");
-			const trimmed = typeof alt === "string" ? alt.trim() : "";
-			return trimmed === "" ? "" : `[${trimmed}]`;
-		}
-		case "link": {
-			const label = childText(node, context).replace(/\s+/g, " ").trim();
-			const target = node.props.get("href");
-			const href = typeof target === "string" ? target : "";
-			if (href === "" || href === label) return label;
-			return label === "" ? href : `${label} (${href})`;
-		}
-		case "list": return deriveList(node, context);
-		case "table": return deriveTable(node, context);
-		case "row": return wrap(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 wrap(childText(node, context), LINE);
-		case "preformatted": return wrap(childText(node, {
-			...context,
-			preformatted: true
-		}), PARAGRAPH);
-		case "block": return wrap(childText(node, context), PARAGRAPH);
-	}
-};
-const derive = (node, context) => {
-	switch (node.t) {
-		case "text": return context.preformatted ? node.v : node.v.replace(INVISIBLE, "").replace(/[^\S\n]+/g, " ");
-		case "raw": return node.text;
-		case "el": return deriveElement(node, context);
-	}
-};
-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();
-const createContext = (template, input, options, plain) => {
-	if (template.sml !== 1) fail("unsupported-version", `The template was compiled as version ${String(template.sml)}; this renderer reads version 1.`);
-	const brandPlugin = options.brandPlugin ?? samvaBrandPlugin;
-	return {
-		input,
-		locale: options.locale ?? template.locale,
-		timeZone: options.timeZone,
-		plain,
-		brandPlugin,
-		reservedAttributes: reservedBrandAttributes(brandPlugin),
-		diagnostics: [],
-		iterations: 0,
-		fmt: void 0,
-		preheader: void 0,
-		markerUsed: false
-	};
-};
-const settle = (ctx) => {
-	if (ctx.diagnostics.length > 0) throw new RenderError({ diagnostics: ctx.diagnostics });
-};
-/**
-* Render the email channel against one validated input. `positions` also returns where each
-* element landed in the HTML, which compatibility findings and editor selections map back to source.
-*/
-const renderEmail = (template, input, options = {}) => {
-	const ctx = createContext(template, input, options, false);
-	const email = template.email;
-	if (email === void 0) return fail("missing-channel", "The template has no email channel.");
-	const empty = /* @__PURE__ */ new Map();
-	const subject = textOf(evalValue(ctx, empty, email.subject, 0));
-	if (/[\r\n\u0000]/.test(subject)) fail("invalid-subject", "Invalid email subject: it must be one line of text.");
-	if (email.preheader !== void 0) {
-		const value = evalValue(ctx, empty, email.preheader, 0);
-		if (value !== void 0 && value !== null) ctx.preheader = textOf(value);
-	}
-	const preheader = ctx.preheader;
-	let tree = [];
-	const nodes = [];
-	evalNode(ctx, empty, email.body, 0, nodes);
-	tree = nodes;
-	if (preheader !== void 0 && !ctx.markerUsed) {
-		const block = preheaderBlock(ctx, preheader);
-		tree = insertPreheader(tree, block) ?? [block, ...tree];
-	}
-	settle(ctx);
-	const text = normalize(tree.map((node) => derive(node, {
-		preformatted: false,
-		listDepth: 0
-	})).join(""));
-	if (options.positions === true) {
-		const prefix = serializeWithPositions(tree, 0).html.startsWith("<html") ? EMAIL_DOCTYPE : "";
-		const shifted = serializeWithPositions(tree, prefix.length);
-		return {
-			subject,
-			preheader,
-			html: `${prefix}${shifted.html}`,
-			text,
-			positions: shifted.positions
-		};
-	}
-	const serialized = tree.map(serialize).join("");
-	return {
-		subject,
-		preheader,
-		html: serialized.startsWith("<html") ? `${EMAIL_DOCTYPE}${serialized}` : serialized,
-		text
-	};
-};
-const plainText = (ctx, nodes) => {
-	const out = [];
-	for (const node of asArray(nodes)) evalNode(ctx, /* @__PURE__ */ new Map(), node, 0, out);
-	return out.map((node) => node.t === "text" ? node.v : node.t === "raw" ? node.text : "").join("");
-};
-const renderSms = (template, input, options) => {
-	const ctx = createContext(template, input, options, true);
-	const sms = template.sms;
-	if (sms === void 0) return fail("missing-channel", "The template has no SMS channel.");
-	const text = plainText(ctx, sms.body);
-	settle(ctx);
-	return {
-		text,
-		segments: smsSegmentInfo(text)
-	};
-};
-const resolveButtons = (ctx, nodes, out, depth) => {
-	checkDepth(depth);
-	const scope = /* @__PURE__ */ new Map();
-	const value = (part) => textOf(evalValue(ctx, scope, part, 0));
-	for (const node of asArray(nodes)) {
-		if ("if" in node) {
-			const branch = evalPredicate(ctx, scope, node.if, depth + 1) ? node.then : node.else ?? [];
-			resolveButtons(ctx, branch, out, depth + 1);
-			continue;
-		}
-		switch (node.type) {
-			case "quick-reply":
-				out.push({
-					type: "quick-reply",
-					text: value(node.text)
-				});
-				break;
-			case "url": {
-				const url = value(node.url);
-				if (!isSafeUrl(url)) invalid("A button URL must be an absolute https URL.");
-				out.push({
-					type: "url",
-					text: value(node.text),
-					url
-				});
-				break;
-			}
-			case "phone":
-				out.push({
-					type: "phone",
-					text: value(node.text),
-					phone: value(node.phone)
-				});
-				break;
-			case "copy-code":
-				out.push({
-					type: "copy-code",
-					code: value(node.code)
-				});
-				break;
-			case "flow":
-				out.push({
-					type: "flow",
-					text: value(node.text),
-					flow: node.flow,
-					action: node.action,
-					...node.screen === void 0 ? {} : { screen: node.screen }
-				});
-				break;
-			default: invalid("Unknown WhatsApp button.");
-		}
-	}
-};
-/** The WhatsApp channel with every text rendered and conditional buttons resolved. */
-const renderWhatsApp = (template, input, options) => {
-	const ctx = createContext(template, input, options, true);
-	const whatsapp = template.whatsapp;
-	if (whatsapp === void 0) return fail("missing-channel", "The template has no WhatsApp channel.");
-	const header = whatsapp.header === void 0 ? void 0 : {
-		type: whatsapp.header.type,
-		text: plainText(ctx, whatsapp.header.content)
-	};
-	if (header !== void 0 && header.type !== "text" && !isSafeUrl(header.text)) invalid("A media header URL must be an absolute https URL.");
-	const body = plainText(ctx, whatsapp.body);
-	const footer = whatsapp.footer === void 0 ? void 0 : plainText(ctx, whatsapp.footer);
-	const buttons = [];
-	resolveButtons(ctx, whatsapp.buttons ?? [], buttons, 0);
-	settle(ctx);
-	return {
-		language: whatsapp.language,
-		category: whatsapp.category,
-		...header === void 0 ? {} : { header },
-		body,
-		...footer === void 0 ? {} : { footer },
-		buttons
-	};
-};
-const CHANNEL_RENDERERS = {
-	email: (template, input, options) => renderEmail(template, input, options),
-	sms: renderSms,
-	whatsapp: renderWhatsApp
-};
-/**
-* Render one channel of a compiled template against one validated input. It throws only
-* `RenderError`: a template compiled by another version, a channel the template does not declare,
-* or input or markup the renderer refuses.
-*/
-const render = (template, input, options) => CHANNEL_RENDERERS[options.channel](template, input, options);
-//#endregion
-export { EMAIL_ELEMENTS as a, isUrlAttribute as c, reservedBrandAttributes as d, samvaBrandPlugin as f, smsSegmentInfo as i, brandSpecifierPattern as l, render as n, EMAIL_GLOBAL_ATTRIBUTES as o, COMPILED_TEMPLATE_VERSION as p, renderEmail as r, emailElement as s, RenderError as t, parseBrandSpecifier as u };