@samva/markup 0.18.0 → 0.19.0

package/dist/parse-Bex7QFqj.js

@@ -0,0 +1,921 @@
+import { t as hasProperty } from "./guards-eV1qLbf2.js";
+import { t as TEMPLATE_ID_PATTERN } from "./template-zLUjcwfF.js";
+import { K as isValueNode, M as lowerEmailNodes, U as COMPONENT_DEGRADATIONS, p as checkAttribute, y as serializeStyle } from "./components-DNBCz20_.js";
+import { i as lineColumn, t as buildLineMap } from "./diagnostic-model-DJtqbETd.js";
+import { fromMarkdown } from "mdast-util-from-markdown";
+import { mdxExpressionFromMarkdown } from "mdast-util-mdx-expression";
+import { mdxJsxFromMarkdown } from "mdast-util-mdx-jsx";
+import { mdxExpression } from "micromark-extension-mdx-expression";
+import { mdxJsx } from "micromark-extension-mdx-jsx";
+import { isMap, isScalar, parseDocument } from "yaml";
+//#region generated/contract.json
+var components = [
+	{
+		"name": "Email",
+		"import": "@samva/markup/email",
+		"props": [
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true,
+				"description": "CSS classes applied to the primitive's content element."
+			},
+			{
+				"name": "lang",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "dir",
+				"type": "\"ltr\" | \"rtl\"",
+				"optional": true
+			},
+			{
+				"name": "title",
+				"type": "string",
+				"optional": true,
+				"description": "Document title; several clients use it as the fallback preview line."
+			},
+			{
+				"name": "backgroundColor",
+				"type": "string",
+				"optional": true,
+				"description": "The page color, painted across the whole body and, as `bgcolor`, on the wrapper table for clients that drop body styles. Defaults to the theme's `--color-background`, which switches in dark mode."
+			},
+			{
+				"name": "gutter",
+				"type": "number",
+				"optional": true,
+				"description": "Pixels of space each side of the content, so it never touches the screen edge on a narrow viewport. Defaults to 16; `0` lets content run edge to edge."
+			},
+			{
+				"name": "style",
+				"type": "EmailStyle",
+				"optional": true,
+				"description": "Applied to the content cell, where Yahoo and AOL keep body styling."
+			},
+			{
+				"name": "children",
+				"type": "EmailChild",
+				"optional": true
+			}
+		]
+	},
+	{
+		"name": "Section",
+		"import": "@samva/markup/email",
+		"props": [
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true,
+				"description": "CSS classes applied to the primitive's content element."
+			},
+			{
+				"name": "align",
+				"type": "\"left\" | \"center\" | \"right\"",
+				"optional": true
+			},
+			{
+				"name": "width",
+				"type": "number | string",
+				"optional": true,
+				"description": "The band's width. A pixel width (`600`) is a maximum: the band fills a narrower screen, and classic Outlook, which ignores `max-width`, draws it at that width."
+			},
+			{
+				"name": "bgcolor",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "style",
+				"type": "EmailStyle",
+				"optional": true,
+				"description": "Applied to the content cell so padding survives Outlook and Klaviyo."
+			},
+			{
+				"name": "tableStyle",
+				"type": "EmailStyle",
+				"optional": true
+			},
+			{
+				"name": "children",
+				"type": "EmailChild",
+				"optional": true
+			}
+		]
+	},
+	{
+		"name": "Columns",
+		"import": "@samva/markup/email",
+		"props": [
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true,
+				"description": "CSS classes applied to the primitive's content element."
+			},
+			{
+				"name": "align",
+				"type": "\"left\" | \"center\" | \"right\"",
+				"optional": true
+			},
+			{
+				"name": "width",
+				"type": "number | string",
+				"optional": true
+			},
+			{
+				"name": "style",
+				"type": "EmailStyle",
+				"optional": true
+			},
+			{
+				"name": "each",
+				"type": "readonly Item[]",
+				"optional": true,
+				"description": "Repeat the cells for each item: `children` is then a function from an item (and its index in the row) to a `Column`. Without `per` all items share one row."
+			},
+			{
+				"name": "per",
+				"type": "number",
+				"optional": true,
+				"description": "With `each`, the cells in a row; each chunk of items is its own `Columns` table."
+			},
+			{
+				"name": "stack",
+				"type": "boolean",
+				"optional": true,
+				"description": "Stack the cells into one column, each full width, on a viewport narrower than 600px. On by default; `stack={false}` keeps a row of small cells (icons, a price beside a label) side by side. Clients that ignore media queries keep the row."
+			},
+			{
+				"name": "gap",
+				"type": "number",
+				"optional": true,
+				"description": "Pixels between the cells of a row. A stacked row puts the same space between the stacked cells instead, so a gap needs no padding on the cells that would misalign them when stacked. The cells must be written out and always render."
+			},
+			{
+				"name": "children",
+				"type": "EmailChild | ((item: Item, index: number) => EmailChild)",
+				"optional": true,
+				"description": "`Column` elements, or with `each` a function that returns one."
+			}
+		]
+	},
+	{
+		"name": "Column",
+		"import": "@samva/markup/email",
+		"props": [
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true,
+				"description": "CSS classes applied to the primitive's content element."
+			},
+			{
+				"name": "align",
+				"type": "\"left\" | \"center\" | \"right\"",
+				"optional": true
+			},
+			{
+				"name": "valign",
+				"type": "\"top\" | \"middle\" | \"bottom\"",
+				"optional": true
+			},
+			{
+				"name": "width",
+				"type": "number | string",
+				"optional": true
+			},
+			{
+				"name": "style",
+				"type": "EmailStyle",
+				"optional": true
+			},
+			{
+				"name": "children",
+				"type": "EmailChild",
+				"optional": true
+			}
+		]
+	},
+	{
+		"name": "Button",
+		"import": "@samva/markup/email",
+		"props": [
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true,
+				"description": "CSS classes applied to the primitive's content element."
+			},
+			{
+				"name": "href",
+				"type": "string",
+				"optional": false
+			},
+			{
+				"name": "width",
+				"type": "number",
+				"optional": true,
+				"description": "Pixel width of the box. Classic Outlook draws the VML shape at a fixed width, so without this it is estimated from the label and `paddingX`, and the anchor sizes to its label."
+			},
+			{
+				"name": "height",
+				"type": "number",
+				"optional": true,
+				"description": "Pixel height; classic Outlook's VML fallback needs it."
+			},
+			{
+				"name": "paddingX",
+				"type": "number",
+				"optional": true,
+				"description": "Horizontal padding on each side of the label when no `width` fixes the box."
+			},
+			{
+				"name": "backgroundColor",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "color",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "borderRadius",
+				"type": "number",
+				"optional": true
+			},
+			{
+				"name": "borderColor",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "borderWidth",
+				"type": "number",
+				"optional": true
+			},
+			{
+				"name": "fontSize",
+				"type": "number",
+				"optional": true
+			},
+			{
+				"name": "fontFamily",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "align",
+				"type": "\"left\" | \"center\" | \"right\"",
+				"optional": true
+			},
+			{
+				"name": "style",
+				"type": "EmailStyle",
+				"optional": true
+			},
+			{
+				"name": "children",
+				"type": "EmailChild",
+				"optional": true,
+				"description": "The label. A string label is required for the classic Outlook fallback."
+			}
+		]
+	},
+	{
+		"name": "Spacer",
+		"import": "@samva/markup/email",
+		"props": [{
+			"name": "height",
+			"type": "number",
+			"optional": false
+		}]
+	},
+	{
+		"name": "Divider",
+		"import": "@samva/markup/email",
+		"props": [
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true,
+				"description": "CSS classes applied to the primitive's content element."
+			},
+			{
+				"name": "color",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "thickness",
+				"type": "number",
+				"optional": true
+			},
+			{
+				"name": "style",
+				"type": "EmailStyle",
+				"optional": true
+			}
+		]
+	},
+	{
+		"name": "Image",
+		"import": "@samva/markup/email",
+		"props": [
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true,
+				"description": "CSS classes applied to the primitive's content element."
+			},
+			{
+				"name": "src",
+				"type": "string",
+				"optional": false
+			},
+			{
+				"name": "alt",
+				"type": "string",
+				"optional": false,
+				"description": "Required. Use an empty string only for images that carry no meaning."
+			},
+			{
+				"name": "width",
+				"type": "number | string",
+				"optional": true
+			},
+			{
+				"name": "height",
+				"type": "number | string",
+				"optional": true
+			},
+			{
+				"name": "align",
+				"type": "\"left\" | \"center\" | \"right\"",
+				"optional": true
+			},
+			{
+				"name": "style",
+				"type": "EmailStyle",
+				"optional": true
+			}
+		]
+	},
+	{
+		"name": "Link",
+		"import": "@samva/markup/email",
+		"props": [
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true,
+				"description": "CSS classes applied to the primitive's content element."
+			},
+			{
+				"name": "href",
+				"type": "string",
+				"optional": false
+			},
+			{
+				"name": "target",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "rel",
+				"type": "string",
+				"optional": true
+			},
+			{
+				"name": "style",
+				"type": "EmailStyle",
+				"optional": true
+			},
+			{
+				"name": "children",
+				"type": "EmailChild",
+				"optional": true
+			}
+		]
+	},
+	{
+		"name": "BrandLogo",
+		"import": "samva:brand",
+		"props": [
+			{
+				"name": "width",
+				"type": "number",
+				"optional": true,
+				"description": "Rendered width in pixels; the height follows the image."
+			},
+			{
+				"name": "alt",
+				"type": "string",
+				"optional": true,
+				"description": "Defaults to the brand footer's company name."
+			},
+			{
+				"name": "align",
+				"type": "\"left\" | \"center\" | \"right\"",
+				"optional": true
+			},
+			{
+				"name": "className",
+				"type": "string",
+				"optional": true
+			}
+		]
+	},
+	{
+		"name": "BrandFooter",
+		"import": "samva:brand",
+		"props": [{
+			"name": "unsubscribeLabel",
+			"type": "string",
+			"optional": true,
+			"description": "Text of the unsubscribe link."
+		}, {
+			"name": "className",
+			"type": "string",
+			"optional": true
+		}]
+	}
+];
+//#endregion
+//#region src/markdown/frontmatter.ts
+/** The YAML AST keeps duplicate keys, tags and aliases visible instead of coercing them. */
+const readFrontmatter = (source, report) => {
+	const opening = /^(?:\uFEFF)?---[ \t]*(?:\r\n|\n|\r)/.exec(source);
+	if (opening === null) {
+		report("An issue requires YAML frontmatter with title, slug and topic.", 0);
+		return {
+			markdown: source,
+			frontmatter: void 0
+		};
+	}
+	const bodyStart = opening[0].length;
+	const closing = /^---[ \t]*(?:\r?$)/m.exec(source.slice(bodyStart));
+	if (closing === null) {
+		report("Close the YAML frontmatter with a line containing ---.", 0);
+		return {
+			markdown: "",
+			frontmatter: void 0
+		};
+	}
+	const bodyEnd = bodyStart + closing.index;
+	const end = bodyEnd + closing[0].length;
+	const markdown = source.slice(0, end).replace(/[^\r\n]/g, " ") + source.slice(end);
+	const document = parseDocument(source.slice(bodyStart, bodyEnd), { uniqueKeys: true });
+	let invalid = false;
+	const fail = (message, offset = 0) => {
+		invalid = true;
+		report(message, bodyStart + offset);
+	};
+	for (const error of document.errors) fail(error.message, error.pos[0]);
+	for (const warning of document.warnings) fail(warning.message, warning.pos[0]);
+	if (!isMap(document.contents)) {
+		fail("Frontmatter must be a YAML mapping with title, slug and topic.");
+		return {
+			markdown,
+			frontmatter: void 0
+		};
+	}
+	const keys = (map, allowed) => {
+		if (map.tag !== void 0 || map.anchor !== void 0) fail("YAML tags and anchors are not supported.", map.range?.[0]);
+		for (const pair of map.items) {
+			if (!isScalar(pair.key) || typeof pair.key.value !== "string") {
+				fail("Frontmatter field names must be strings.");
+				continue;
+			}
+			if (!allowed.includes(pair.key.value)) fail(`Unknown frontmatter field ${JSON.stringify(pair.key.value)}.`, pair.key.range?.[0]);
+		}
+	};
+	const string = (map, name, required = false) => {
+		const value = map.get(name, true);
+		if (value === void 0 && !required) return void 0;
+		if (!isScalar(value) || typeof value.value !== "string" || required && value.value.trim() === "" || value.tag !== void 0 || value.anchor !== void 0) {
+			fail(`${name} must be ${required ? "a nonempty" : "a"} string.`);
+			return;
+		}
+		return value.value;
+	};
+	const root = document.contents;
+	keys(root, [
+		"title",
+		"slug",
+		"topic",
+		"preheader",
+		"seo",
+		"gate"
+	]);
+	const title = string(root, "title", true);
+	const slug = string(root, "slug", true);
+	const topic = string(root, "topic", true);
+	const preheader = string(root, "preheader");
+	if (slug !== void 0 && !TEMPLATE_ID_PATTERN.test(slug)) fail("slug must be a lowercase kebab-case identifier of at most 100 characters.");
+	let seo;
+	const seoNode = root.get("seo", true);
+	if (seoNode !== void 0) {
+		if (!isMap(seoNode)) fail("seo must be a mapping of title, description and image.");
+		else {
+			keys(seoNode, [
+				"title",
+				"description",
+				"image"
+			]);
+			const seoTitle = string(seoNode, "title");
+			const description = string(seoNode, "description");
+			const image = string(seoNode, "image");
+			if (image !== void 0 && (!URL.canParse(image) || !/^https:\/\//i.test(image) || checkAttribute("img", "src", image, []).diagnostics.length > 0 || URL.canParse(image) && (new URL(image).username !== "" || new URL(image).password !== ""))) fail("seo.image must be a safe absolute https URL without credentials.");
+			seo = {
+				...seoTitle === void 0 ? {} : { title: seoTitle },
+				...description === void 0 ? {} : { description },
+				...image === void 0 ? {} : { image }
+			};
+		}
+	}
+	let gate;
+	const gateNode = root.get("gate", true);
+	if (gateNode !== void 0) {
+		if (!isMap(gateNode)) fail("gate must be a mapping with leadIn.");
+		else {
+			keys(gateNode, ["leadIn"]);
+			const leadIn = gateNode.get("leadIn", true);
+			if (!isScalar(leadIn) || typeof leadIn.value !== "number" || !Number.isSafeInteger(leadIn.value) || leadIn.value < 0 || leadIn.tag !== void 0 || leadIn.anchor !== void 0) fail("gate.leadIn must be a nonnegative integer counting leading top-level blocks.");
+			else gate = { leadIn: leadIn.value };
+		}
+	}
+	return {
+		markdown,
+		frontmatter: invalid || title === void 0 || slug === void 0 || topic === void 0 ? void 0 : {
+			title,
+			slug,
+			topic,
+			...preheader === void 0 ? {} : { preheader },
+			...seo === void 0 ? {} : { seo },
+			...gate === void 0 ? {} : { gate }
+		}
+	};
+};
+//#endregion
+//#region src/markdown/parse.ts
+const componentName = (name) => Object.hasOwn(COMPONENT_DEGRADATIONS, name);
+/** Parse a static issue without importing, evaluating or passing through authored HTML. */
+const parseIssue = (source, file) => {
+	const diagnostics = [];
+	const sourceNodes = [];
+	const lines = buildLineMap(source);
+	const location = (offset) => {
+		const at = lineColumn(lines, offset);
+		return {
+			fileName: file,
+			lineNumber: at.line,
+			columnNumber: at.column
+		};
+	};
+	const report = (code, message, offset) => {
+		diagnostics.push({
+			code,
+			message,
+			severity: "error",
+			origins: [location(offset)]
+		});
+	};
+	const { markdown, frontmatter } = readFrontmatter(source, (message, offset) => report("markdown-frontmatter", message, offset));
+	const result = (nodes) => ({
+		nodes: diagnostics.some((item) => item.severity === "error") ? [] : nodes,
+		frontmatter,
+		diagnostics,
+		sources: [file],
+		sourceNodes
+	});
+	let tree;
+	try {
+		tree = fromMarkdown(markdown, {
+			extensions: [
+				{ disable: { null: ["htmlFlow", "htmlText"] } },
+				mdxJsx(),
+				mdxExpression()
+			],
+			mdastExtensions: [mdxJsxFromMarkdown(), mdxExpressionFromMarkdown()]
+		});
+	} catch (cause) {
+		const line = hasProperty(cause, "line") && typeof cause.line === "number" ? cause.line : 1;
+		const column = hasProperty(cause, "column") && typeof cause.column === "number" ? cause.column : 1;
+		const offset = (lines[line - 1] ?? 0) + column - 1;
+		const html = /<!--|<![A-Z]|<\?/.exec(markdown);
+		report(html === null ? "markdown-syntax" : "markdown-html", html === null ? `Invalid static Markdown: ${String(cause)}` : "Raw HTML, comments and processing instructions are not supported; use Markdown or SML components.", html?.index ?? offset);
+		return result([]);
+	}
+	const start = (node) => node.position?.start.offset ?? 0;
+	const end = (node) => node.position?.end.offset ?? start(node);
+	const src = (node) => {
+		const at = lineColumn(lines, start(node));
+		return [
+			at.line,
+			at.column,
+			0
+		];
+	};
+	const record = (node, kind, tag, properties = [], content) => {
+		const children = "children" in node ? node.children : [];
+		const text = node.type === "text" ? node : children.length === 1 && children[0]?.type === "text" ? children[0] : void 0;
+		const textProperties = text === void 0 ? [] : [{
+			name: "children",
+			value: text.value,
+			literalType: "string",
+			start: start(text),
+			end: end(text),
+			syntax: "markdown"
+		}];
+		sourceNodes.push({
+			kind,
+			tag,
+			start: start(node),
+			end: end(node),
+			contentStart: content?.[0] ?? (children[0] === void 0 ? start(node) : start(children[0])),
+			contentEnd: content?.[1] ?? (children.length === 0 ? end(node) : end(children[children.length - 1])),
+			src: src(node),
+			properties: [...properties, ...textProperties]
+		});
+	};
+	const attach = (items, offset) => {
+		for (const diagnostic of items) diagnostics.push({
+			...diagnostic,
+			origins: [location(offset)]
+		});
+	};
+	const attribute = (tag, name, value, offset) => {
+		attach(checkAttribute(tag, name, value, [location(offset)]).diagnostics, offset);
+	};
+	const definitions = /* @__PURE__ */ new Map();
+	const collectDefinitions = (node) => {
+		if (node.type === "definition" && !definitions.has(node.identifier)) definitions.set(node.identifier, node);
+		if ("children" in node) for (const child of node.children) collectDefinitions(child);
+	};
+	collectDefinitions(tree);
+	const linkProperties = (node, reference, image) => {
+		const properties = [];
+		const property = (name, value, from, to) => {
+			properties.push({
+				name,
+				value,
+				literalType: "string",
+				start: from,
+				end: to,
+				syntax: "markdown"
+			});
+		};
+		const labelEnd = (from, to) => {
+			let depth = 0;
+			for (let index = from; index < to; index++) {
+				if (source[index] === "\\") {
+					index++;
+					continue;
+				}
+				if (source[index] === "`") {
+					let count = 1;
+					while (source[index + count] === "`") count++;
+					const delimiter = "`".repeat(count);
+					let close = source.indexOf(delimiter, index + count);
+					while (close >= 0 && close < to && (source[close - 1] === "`" || source[close + count] === "`")) close = source.indexOf(delimiter, close + count);
+					if (close >= 0 && close < to) {
+						index = close + count - 1;
+						continue;
+					}
+				}
+				if (source[index] === "[") depth++;
+				if (source[index] === "]" && --depth === 0) return index;
+			}
+			return to;
+		};
+		const labelStart = start(node) + (image ? 2 : 1);
+		if (image && "alt" in node) property("alt", node.alt ?? "", labelStart, labelEnd(labelStart - 1, end(node)));
+		const from = start(reference);
+		const to = end(reference);
+		const autolink = source[from] === "<";
+		let cursor = autolink ? from + 1 : labelEnd(from, to) + 2;
+		while (/\s/.test(source[cursor] ?? "") && cursor < to) cursor++;
+		const angle = source[cursor] === "<";
+		if (angle) cursor++;
+		const urlStart = cursor;
+		let depth = 0;
+		for (; cursor < to; cursor++) {
+			const character = source[cursor];
+			if (character === "\\") {
+				cursor++;
+				continue;
+			}
+			if ((autolink || angle) && character === ">") break;
+			if (!autolink && !angle) {
+				if (character === "(") depth++;
+				else if (character === ")") {
+					if (depth === 0) break;
+					depth--;
+				} else if (/\s/.test(character ?? "")) break;
+			}
+		}
+		property(image ? "src" : "href", reference.url, urlStart, cursor);
+		if (angle) cursor++;
+		while (/\s/.test(source[cursor] ?? "") && cursor < to) cursor++;
+		if (reference.title !== null && reference.title !== void 0) {
+			const delimiter = source[cursor] === "(" ? ")" : source[cursor];
+			const titleStart = ++cursor;
+			for (; cursor < to; cursor++) {
+				if (source[cursor] === "\\") {
+					cursor++;
+					continue;
+				}
+				if (source[cursor] === delimiter) break;
+			}
+			property("title", reference.title, titleStart, cursor);
+		}
+		return properties;
+	};
+	const propValue = (spec, value, offset) => {
+		const types = spec.type.split(/\s*\|\s*/);
+		if (types.includes("boolean")) {
+			if (value === true || value === "true") return true;
+			if (value === "false") return false;
+		}
+		if (typeof value === "string") {
+			if (types.includes("string")) return value;
+			if (types.includes("number") && /^-?(?:\d+(?:\.\d*)?|\.\d+)$/.test(value)) {
+				const number = Number(value);
+				if (Number.isFinite(number)) return number;
+			}
+			if (types.some((type) => type === JSON.stringify(value))) return value;
+		}
+		report("markdown-prop", `${spec.name} requires a static ${spec.type} value.`, offset);
+	};
+	const component = (node, columnStack) => {
+		const name = node.name;
+		if (name === null || !componentName(name)) {
+			report(name !== null && /^[a-z]/.test(name) ? "markdown-html" : "unknown-component", `Unsupported tag <${name ?? ""}>; use Markdown or a component from the SML component registry.`, start(node));
+			return [];
+		}
+		const spec = components.find((candidate) => candidate.name === name);
+		if (spec === void 0) {
+			report("markdown-prop", `The generated prop contract is missing ${name}.`, start(node));
+			return [];
+		}
+		const props = {};
+		const properties = [];
+		const seen = /* @__PURE__ */ new Set();
+		for (const attr of node.attributes) {
+			const offset = attr.position?.start.offset ?? start(node);
+			if (attr.type !== "mdxJsxAttribute" || attr.value !== null && attr.value !== void 0 && typeof attr.value !== "string") {
+				report("markdown-expression", "Expressions and spread attributes are not supported in SML Markdown.", offset);
+				continue;
+			}
+			if (seen.has(attr.name)) {
+				report("markdown-prop", `Duplicate ${attr.name} attribute on <${name}>.`, offset);
+				continue;
+			}
+			seen.add(attr.name);
+			const field = spec.props.find((prop) => prop.name === attr.name && prop.name !== "children");
+			if (field === void 0) {
+				report("markdown-prop", `<${name}> does not support the ${attr.name} attribute.`, offset);
+				continue;
+			}
+			const value = propValue(field, attr.value ?? true, offset);
+			if (value === void 0) continue;
+			props[attr.name] = value;
+			if (name === "BrandLogo" && attr.name === "width" && typeof value === "number") attribute("img", "width", value, offset);
+			const attrEnd = attr.position?.end.offset ?? offset + attr.name.length;
+			const quote = source.slice(offset, attrEnd).search(/["']/);
+			properties.push({
+				name: attr.name,
+				value,
+				literalType: typeof value === "string" ? "string" : typeof value === "number" ? "number" : "boolean",
+				start: quote < 0 ? offset : offset + quote,
+				end: attrEnd,
+				syntax: quote < 0 ? "boolean" : "quoted"
+			});
+			if (typeof value === "string") {
+				if (/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f\uE000\uE001]/.test(value)) report("markdown-prop", `${attr.name} contains a control character or reserved token delimiter.`, offset);
+				if (attr.name === "href") attribute("a", "href", value, offset);
+				if (attr.name === "src") attribute("img", "src", value, offset);
+			}
+		}
+		for (const field of spec.props) if (!field.optional && !Object.hasOwn(props, field.name)) report("markdown-prop", `<${name}> requires the ${field.name} attribute.`, start(node));
+		const kids = node.children.flatMap((child) => walk(child, name === "Columns" && props.stack !== false));
+		const raw = source.slice(start(node), end(node));
+		const lastAttribute = node.attributes[node.attributes.length - 1];
+		const openEnd = source.indexOf(">", lastAttribute?.position?.end.offset ?? start(node));
+		const closeStart = source[openEnd - 1] === "/" ? openEnd + 1 : start(node) + raw.lastIndexOf("</");
+		record(node, "component", name, properties, [openEnd + 1, closeStart]);
+		if (kids.length > 0 && !spec.props.some((field) => field.name === "children")) report("markdown-prop", `<${name}> does not accept children.`, start(node));
+		return [{
+			type: "component",
+			name,
+			props,
+			children: kids,
+			...name === "Column" ? { emailColumn: { stack: columnStack } } : {},
+			src: src(node)
+		}];
+	};
+	const intrinsic = (node, type, tag, kids, attrs, properties = []) => {
+		record(node, type, tag, properties);
+		return [{
+			type,
+			tag,
+			children: kids,
+			...attrs === void 0 ? {} : { attrs },
+			src: src(node)
+		}];
+	};
+	const walk = (node, columnStack = false) => {
+		const walkChild = (child) => walk(child, columnStack);
+		switch (node.type) {
+			case "root": return node.children.flatMap(walkChild);
+			case "text":
+				record(node, "text", "#text");
+				if (/[\uE000\uE001]/.test(node.value)) report("markdown-syntax", "Text contains a reserved compiler token delimiter.", start(node));
+				return [node.value];
+			case "paragraph": return intrinsic(node, "block", "p", node.children.flatMap(walkChild));
+			case "heading": return intrinsic(node, "block", `h${node.depth}`, node.children.flatMap(walkChild));
+			case "blockquote": return intrinsic(node, "block", "blockquote", node.children.flatMap(walkChild));
+			case "list": return intrinsic(node, "block", node.ordered ? "ol" : "ul", node.children.flatMap(walkChild), node.ordered && node.start !== null && node.start !== void 0 && node.start !== 1 ? { start: node.start } : void 0);
+			case "listItem": return intrinsic(node, "block", "li", node.children.flatMap(walkChild));
+			case "strong": return intrinsic(node, "inline", "strong", node.children.flatMap(walkChild));
+			case "emphasis": return intrinsic(node, "inline", "em", node.children.flatMap(walkChild));
+			case "inlineCode": return intrinsic(node, "inline", "code", [node.value]);
+			case "code": return intrinsic(node, "block", "pre", [{
+				type: "inline",
+				tag: "code",
+				children: [node.value],
+				src: src(node)
+			}]);
+			case "break": return intrinsic(node, "inline", "br", []);
+			case "thematicBreak": return intrinsic(node, "block", "hr", []);
+			case "link":
+			case "image":
+			case "linkReference":
+			case "imageReference": {
+				const reference = node.type === "linkReference" || node.type === "imageReference" ? definitions.get(node.identifier) : node;
+				if (reference === void 0) {
+					report("markdown-syntax", "The Markdown reference has no definition.", start(node));
+					return [];
+				}
+				const image = node.type === "image" || node.type === "imageReference";
+				const attrs = image ? {
+					src: reference.url,
+					alt: "alt" in node ? node.alt ?? "" : ""
+				} : { href: reference.url };
+				if (reference.title !== null && reference.title !== void 0) attrs.title = reference.title;
+				attribute(image ? "img" : "a", image ? "src" : "href", reference.url, start(node));
+				return intrinsic(node, "inline", image ? "img" : "a", "children" in node ? node.children.flatMap(walkChild) : [], attrs, linkProperties(node, reference, image));
+			}
+			case "definition": return [];
+			case "mdxJsxFlowElement":
+			case "mdxJsxTextElement": return component(node, columnStack);
+			case "mdxFlowExpression":
+			case "mdxTextExpression":
+				report("markdown-expression", "Expressions are not supported in SML Markdown; write static content.", start(node));
+				return [];
+			case "html":
+				report("markdown-html", "Raw HTML is not supported; use Markdown or SML components.", start(node));
+				return [];
+			default:
+				report("markdown-syntax", `Unsupported Markdown construct ${node.type}.`, start(node));
+				return [];
+		}
+	};
+	const nodes = walk(tree);
+	if (!diagnostics.some((item) => item.severity === "error")) {
+		const lowerStatic = (list) => list.flatMap((node) => {
+			if (isValueNode(node)) return [node];
+			if ("type" in node && node.type === "component" && (node.name === "BrandLogo" || node.name === "BrandFooter")) return [];
+			const lowered = {
+				...node,
+				..."children" in node && node.children !== void 0 ? { children: lowerStatic(node.children) } : {}
+			};
+			const at = "src" in node && node.src !== void 0 ? (lines[node.src[0] - 1] ?? 0) + node.src[1] - 1 : 0;
+			return lowerEmailNodes([lowered], void 0, (diagnostic) => attach([{
+				...diagnostic,
+				origins: []
+			}], at));
+		});
+		const lowered = lowerStatic(nodes);
+		const validate = (list) => {
+			for (const node of list) {
+				if (isValueNode(node)) continue;
+				if ("el" in node) {
+					const at = node.src === void 0 ? 0 : (lines[node.src[0] - 1] ?? 0) + node.src[1] - 1;
+					for (const [name, value] of Object.entries(node.attrs ?? {})) if (typeof value === "string" || typeof value === "number") attribute(node.el, name, value, at);
+					if (Array.isArray(node.style)) attach(serializeStyle(Object.fromEntries(node.style), [location(at)]).diagnostics, at);
+				}
+				if ("children" in node && node.children !== void 0) validate(node.children);
+			}
+		};
+		validate(lowered);
+	}
+	sourceNodes.sort((a, b) => a.start - b.start || b.end - a.end);
+	return result(nodes);
+};
+//#endregion
+export { parseIssue as t };