@abraca/cli 2.23.0 → 2.24.0

package/dist/abracadabra-cli.cjs

@@ -1349,2351 +1349,2506 @@ registerCommand({
 });
 
 //#endregion
-//#region packages/convert/src/markdown-to-yjs.ts
-function parseInlineArray(raw) {
-	return raw.slice(1, -1).split(",").map((s) => s.trim()).filter(Boolean);
-}
-function stripQuotes(s) {
-	if (s.length >= 2 && (s.startsWith("\"") && s.endsWith("\"") || s.startsWith("'") && s.endsWith("'"))) return s.slice(1, -1).replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
-	return s;
-}
-function parseFrontmatter(markdown) {
-	const noResult = {
-		meta: {},
-		body: markdown
-	};
-	const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
-	if (!match) return noResult;
-	const yamlBlock = match[1];
-	const body = markdown.slice(match[0].length);
-	const raw = {};
-	const lines = yamlBlock.split("\n");
-	let i = 0;
-	while (i < lines.length) {
-		const line = lines[i];
-		const blockSeqKey = line.match(/^(\w[\w-]*):\s*$/);
-		if (blockSeqKey && i + 1 < lines.length && /^\s+-\s/.test(lines[i + 1])) {
-			const key = blockSeqKey[1];
-			const items = [];
-			i++;
-			while (i < lines.length && /^\s+-\s/.test(lines[i])) {
-				items.push(lines[i].replace(/^\s+-\s/, "").trim());
-				i++;
-			}
-			raw[key] = items;
-			continue;
-		}
-		const kvMatch = line.match(/^(\w[\w-]*):\s*(.*)$/);
-		if (kvMatch) {
-			const key = kvMatch[1];
-			const val = kvMatch[2].trim();
-			if (val.startsWith("[") && val.endsWith("]")) raw[key] = parseInlineArray(val).map(stripQuotes);
-			else raw[key] = stripQuotes(val);
-		}
-		i++;
-	}
-	const meta = {};
-	const getStr = (keys) => {
-		for (const k of keys) {
-			const v = raw[k];
-			if (typeof v === "string" && v) return v;
-		}
-	};
-	if (raw["tags"]) meta.tags = Array.isArray(raw["tags"]) ? raw["tags"] : [raw["tags"]];
-	const color = getStr(["color"]);
-	if (color) meta.color = color;
-	const icon = getStr(["icon"]);
-	if (icon) meta.icon = icon;
-	const status = getStr(["status"]);
-	if (status) meta.status = status;
-	const priorityRaw = getStr(["priority"]);
-	if (priorityRaw !== void 0) meta.priority = {
-		low: 1,
-		medium: 2,
-		high: 3,
-		urgent: 4
-	}[priorityRaw.toLowerCase()] ?? (Number(priorityRaw) || 0);
-	const checkedRaw = raw["checked"] ?? raw["done"];
-	if (checkedRaw !== void 0) meta.checked = checkedRaw === "true" || checkedRaw === true;
-	const dateStart = getStr([
-		"dateStart",
-		"date",
-		"created"
-	]);
-	if (dateStart) meta.dateStart = dateStart;
-	const dateEnd = getStr(["dateEnd", "due"]);
-	if (dateEnd) meta.dateEnd = dateEnd;
-	const subtitle = getStr(["subtitle", "description"]);
-	if (subtitle) meta.subtitle = subtitle;
-	const url = getStr(["url"]);
-	if (url) meta.url = url;
-	const language = getStr(["language"]);
-	if (language) meta.language = language;
-	const fileExtension = getStr(["fileExtension"]);
-	if (fileExtension) meta.fileExtension = fileExtension;
-	const codeTheme = getStr(["codeTheme"]);
-	if (codeTheme) meta.codeTheme = codeTheme;
-	const ratingRaw = getStr(["rating"]);
-	if (ratingRaw !== void 0) {
-		const n = Number(ratingRaw);
-		if (!Number.isNaN(n)) meta.rating = Math.min(5, Math.max(0, n));
-	}
-	const rawTitle = typeof raw["title"] === "string" ? raw["title"] : void 0;
-	return {
-		title: rawTitle !== void 0 ? stripQuotes(rawTitle) : void 0,
-		type: getStr(["type"]),
-		meta,
-		body
-	};
-}
-function pushNested(out, inner, wrap) {
-	const children = parseInline(inner);
-	if (children.length === 0) {
-		out.push({
-			text: inner,
-			attrs: { ...wrap }
-		});
-		return;
-	}
-	for (const child of children) out.push({
-		text: child.text,
-		attrs: {
-			...child.attrs ?? {},
-			...wrap
-		}
-	});
-}
-function parseInline(text) {
-	const stripped = text.replace(/\{lang="[^"]*"\}/g, "").replace(/:(?!badge|icon|kbd)(\w[\w-]*)\[([^\]]*)\](\{[^}]*\})?/g, "$2").replace(/:(?!badge|icon|kbd)(\w[\w-]*)(\{[^}]*\})/g, "");
-	const tokens = [];
-	const re = /\$([^$\n]+?)\$|@\[([^\]]+?)\]\(user:([^)]+?)\)|:badge\[([^\]]*)\](\{[^}]*\})?|:icon\{([^}]*)\}|:kbd\{([^}]*)\}|\[\[([0-9a-fA-F-]{36})(?:\|([^\]]+?))?\]\]|~~(.+?)~~|\*\*(.+?)\*\*|\*(.+?)\*|_(.+?)_|`(.+?)`|\[(.+?)\]\((.+?)\)/g;
-	let lastIndex = 0;
-	let match;
-	while ((match = re.exec(stripped)) !== null) {
-		if (match.index > lastIndex) tokens.push({ text: stripped.slice(lastIndex, match.index) });
-		if (match[1] !== void 0) tokens.push({
-			text: match[1],
-			attrs: { mathInline: { expression: match[1] } }
-		});
-		else if (match[2] !== void 0 && match[3] !== void 0) tokens.push({
-			text: match[2],
-			attrs: { mention: {
-				userId: match[3],
-				label: match[2]
-			} }
-		});
-		else if (match[4] !== void 0) {
-			const badgeProps = parseMdcProps(match[5]);
-			tokens.push({
-				text: match[4] || "Badge",
-				attrs: { badge: {
-					label: match[4] || "Badge",
-					color: badgeProps["color"] || "neutral",
-					variant: badgeProps["variant"] || "subtle"
-				} }
-			});
-		} else if (match[6] !== void 0) {
-			const iconProps = parseMdcProps(`{${match[6]}}`);
-			tokens.push({
-				text: "​",
-				attrs: { proseIcon: { name: iconProps["name"] || "i-lucide-star" } }
-			});
-		} else if (match[7] !== void 0) {
-			const kbdProps = parseMdcProps(`{${match[7]}}`);
-			tokens.push({
-				text: kbdProps["value"] || "",
-				attrs: { kbd: { value: kbdProps["value"] || "" } }
-			});
-		} else if (match[8] !== void 0) {
-			const docId = match[8];
-			const label = match[9] ?? docId;
-			tokens.push({
-				text: label,
-				attrs: { docLink: { docId } }
-			});
-		} else if (match[10] !== void 0) pushNested(tokens, match[10], { strike: true });
-		else if (match[11] !== void 0) pushNested(tokens, match[11], { bold: true });
-		else if (match[12] !== void 0) pushNested(tokens, match[12], { italic: true });
-		else if (match[13] !== void 0) pushNested(tokens, match[13], { italic: true });
-		else if (match[14] !== void 0) tokens.push({
-			text: match[14],
-			attrs: { code: true }
-		});
-		else if (match[15] !== void 0 && match[16] !== void 0) tokens.push({
-			text: match[15],
-			attrs: { link: { href: match[16] } }
-		});
-		lastIndex = match.index + match[0].length;
-	}
-	if (lastIndex < stripped.length) tokens.push({ text: stripped.slice(lastIndex) });
-	return tokens.filter((t) => t.text.length > 0);
-}
-function parseTableRow(line) {
-	const parts = line.split("|");
-	return parts.slice(1, parts.length - 1).map((c) => c.trim());
-}
-function isTableSeparator(line) {
-	return /^\|[\s|:-]+\|$/.test(line.trim());
-}
-/** Extract fenced code blocks from MDC #code slot lines. */
-function extractFencedCode(lines) {
-	const result = [];
-	let i = 0;
-	while (i < lines.length) {
-		const fenceMatch = lines[i].match(/^(`{3,})(\w*)/);
-		if (fenceMatch) {
-			const fence = fenceMatch[1];
-			const lang = fenceMatch[2] ?? "";
-			const codeLines = [];
-			i++;
-			while (i < lines.length && !lines[i].startsWith(fence)) {
-				codeLines.push(lines[i]);
-				i++;
-			}
-			i++;
-			result.push({
-				type: "codeBlock",
-				lang,
-				code: codeLines.join("\n")
-			});
-			continue;
-		}
-		i++;
-	}
-	return result;
-}
-/** Extract key="value" pairs from MDC prop syntax `{key="value" other="x"}` */
-function parseMdcProps(propsStr) {
-	if (!propsStr) return {};
-	const result = {};
-	let s = propsStr.trim();
-	if (s.startsWith("{") && s.endsWith("}")) s = s.slice(1, -1);
-	const re = /(\w[\w-]*)(?:=(?:"([^"]*)"|([^\s"}]+)))?/g;
-	let m;
-	while ((m = re.exec(s)) !== null) {
-		const key = m[1];
-		if (m[2] !== void 0) result[key] = m[2];
-		else if (m[3] !== void 0) result[key] = m[3];
-		else result[key] = "true";
-	}
-	return result;
-}
-/** Parse named child MDC blocks from inner lines (e.g. #item for accordion, #tab for tabs) */
-function parseMdcChildren(innerLines, slotPrefix) {
-	const items = [];
-	let current = null;
-	const slotRe = new RegExp(`^#${slotPrefix}(\\{[^}]*\\})?\\s*$`);
-	for (const line of innerLines) {
-		const slotMatch = line.match(slotRe);
-		if (slotMatch) {
-			if (current) items.push(current);
-			const props = parseMdcProps(slotMatch[1]);
-			current = {
-				label: props["label"] || props["title"] || `Item ${items.length + 1}`,
-				icon: props["icon"] || "",
-				lines: []
-			};
-			continue;
-		}
-		if (current) current.lines.push(line);
-		else if (!items.length && !current) current = {
-			label: `Item 1`,
-			icon: "",
-			lines: [line]
-		};
-	}
-	if (current) items.push(current);
-	return items.map((item) => ({
-		label: item.label,
-		icon: item.icon,
-		innerBlocks: parseBlocks(item.lines.join("\n"))
-	}));
-}
-const TASK_RE = /^[-*+]\s+\[([ xX])\]\s+(.*)/;
-/**
-* Consume a list (bullet / ordered / task) starting at `start`. Indented
-* continuation lines and nested lists are captured into each item's
-* `innerBlocks` so the parse → serialise → parse cycle preserves tree
-* structure instead of flattening nested lists onto a single line.
-*
-* `indent` is the column of the item marker for the current list. A
-* nested list starts ≥2 columns deeper. Lines with less indent than
-* `indent` belong to the outer block and stop consumption.
-*/
-function consumeList(lines, start, indent, kind) {
-	const items = [];
-	let i = start;
-	while (i < lines.length) {
-		const line = lines[i];
-		if (line.trim() === "") {
-			let j = i + 1;
-			while (j < lines.length && lines[j].trim() === "") j++;
-			if (j >= lines.length) break;
-			const lookahead = lines[j];
-			if (leadingSpaces(lookahead) < indent) break;
-			if (!matchMarker(lookahead.slice(indent), kind)) break;
-			i = j;
-			continue;
-		}
-		const leading = leadingSpaces(line);
-		if (leading < indent) break;
-		if (leading > indent) break;
-		const m = matchMarker(line.slice(indent), kind);
-		if (!m) break;
-		const item = { text: m.text };
-		if (kind === "task") item.checked = m.checked;
-		i++;
-		const contLines = [];
-		while (i < lines.length) {
-			const next = lines[i];
-			if (next.trim() === "") {
-				let k = i + 1;
-				while (k < lines.length && lines[k].trim() === "") k++;
-				if (k >= lines.length) break;
-				if (leadingSpaces(lines[k]) <= indent) break;
-				contLines.push("");
-				i++;
-				continue;
-			}
-			const nextIndent = leadingSpaces(next);
-			if (nextIndent <= indent) break;
-			const deindentBy = Math.min(nextIndent, indent + 2);
-			contLines.push(next.slice(deindentBy));
-			i++;
-		}
-		if (contLines.length > 0) item.innerBlocks = parseBlocks(contLines.join("\n"));
-		items.push(item);
-	}
-	return {
-		items,
-		next: i
-	};
-}
-function leadingSpaces(s) {
-	let n = 0;
-	while (n < s.length && s[n] === " ") n++;
-	return n;
-}
-function matchMarker(s, kind) {
-	if (kind === "task") {
-		const m = s.match(TASK_RE);
-		if (!m) return null;
-		return {
-			text: m[2],
-			checked: m[1].toLowerCase() === "x"
-		};
-	}
-	if (kind === "bullet") {
-		if (TASK_RE.test(s)) return null;
-		const m = s.match(/^[-*+]\s+(.*)$/);
-		if (!m) return null;
-		return {
-			text: m[1],
-			checked: false
-		};
-	}
-	const m = s.match(/^\d+\.\s+(.*)$/);
-	if (!m) return null;
-	return {
-		text: m[1],
-		checked: false
-	};
-}
-function parseBlocks(markdown) {
-	const rawLines = markdown.split("\n");
-	let firstContentLine = 0;
-	while (firstContentLine < rawLines.length) {
-		const l = rawLines[firstContentLine];
-		if (l.trim() === "" || /^import\s/.test(l) || /^export\s/.test(l)) firstContentLine++;
-		else break;
-	}
-	const stripped = rawLines.slice(firstContentLine).join("\n");
-	const blocks = [];
-	const lines = stripped.split("\n");
-	let i = 0;
-	while (i < lines.length) {
-		const line = lines[i];
-		const fenceBlockMatch = line.match(/^(`{3,})(.*)$/);
-		if (fenceBlockMatch) {
-			const fence = fenceBlockMatch[1];
-			const lang = fenceBlockMatch[2].trim().replace(/\{[^}]*\}$/, "").replace(/\s*\[.*\]$/, "").trim();
-			const codeLines = [];
-			i++;
-			while (i < lines.length && !lines[i].startsWith(fence)) {
-				codeLines.push(lines[i]);
-				i++;
-			}
-			i++;
-			const code = codeLines.join("\n");
-			if (lang === "math") blocks.push({
-				type: "mathBlock",
-				expression: code
-			});
-			else blocks.push({
-				type: "codeBlock",
-				lang,
-				code
-			});
-			continue;
-		}
-		const headingMatch = line.match(/^(#{1,6})\s+(.*)/);
-		if (headingMatch) {
-			blocks.push({
-				type: "heading",
-				level: headingMatch[1].length,
-				text: headingMatch[2].trim()
-			});
-			i++;
-			continue;
-		}
-		if (/^[-*_]{3,}\s*$/.test(line)) {
-			blocks.push({ type: "hr" });
-			i++;
-			continue;
-		}
-		const embedMatch = line.match(/^!\[\[([0-9a-fA-F-]{36})(?:\|([^\]]+))?\]\](\{[^}]*\})?\s*$/);
-		if (embedMatch) {
-			const docId = embedMatch[1];
-			const label = embedMatch[2] ?? "";
-			const props = parseMdcProps(embedMatch[3]);
-			blocks.push({
-				type: "docEmbed",
-				docId,
-				label,
-				props
-			});
-			i++;
-			continue;
-		}
-		const imgMatch = line.match(/^!\[([^\]]*)\]\(([^)]+)\)(\{[^}]*\})?\s*$/);
-		if (imgMatch) {
-			const alt = imgMatch[1] ?? "";
-			const src = imgMatch[2] ?? "";
-			const attrs = parseMdcProps(imgMatch[3]);
-			blocks.push({
-				type: "image",
-				src,
-				alt,
-				width: attrs["width"],
-				height: attrs["height"]
-			});
-			i++;
-			continue;
-		}
-		if (line.startsWith(">")) {
-			const bqLines = [];
-			while (i < lines.length && lines[i].startsWith(">")) {
-				bqLines.push(lines[i].replace(/^>\s?/, ""));
-				i++;
-			}
-			blocks.push({
-				type: "blockquote",
-				lines: bqLines
-			});
-			continue;
-		}
-		if (/^\s*\|/.test(line)) {
-			const tableLines = [];
-			while (i < lines.length && /^\s*\|/.test(lines[i])) {
-				tableLines.push(lines[i]);
-				i++;
-			}
-			if (tableLines.length >= 2 && isTableSeparator(tableLines[1])) {
-				const headerRow = parseTableRow(tableLines[0]);
-				const dataRows = tableLines.slice(2).filter((l) => !isTableSeparator(l)).map(parseTableRow);
-				blocks.push({
-					type: "table",
-					headerRow,
-					dataRows
-				});
-			} else for (const l of tableLines) blocks.push({
-				type: "paragraph",
-				text: l
-			});
-			continue;
-		}
-		const atomMatch = line.match(/^:(\w[\w-]*)(\{[^}]*\})?\s*$/);
-		if (atomMatch && atomMatch[1] === "file") {
-			const props = parseMdcProps(atomMatch[2]);
-			const uploadId = props["upload-id"] ?? props["uploadId"] ?? "";
-			const filename = props["filename"] ?? "";
-			const mime = props["mime"] ?? "";
-			const src = props["src"] ?? (uploadId && filename ? `.abracadabra/files/${uploadId}-${filename}` : "");
-			blocks.push({
-				type: "fileBlock",
-				src,
-				mime,
-				uploadId,
-				filename
-			});
-			i++;
-			continue;
-		}
-		const MDC_OPEN = /^\s*(:{2,})(\w[\w-]*)(\{[^}]*\})?\s*$/;
-		if (MDC_OPEN.test(line)) {
-			const colons = line.match(/^\s*(:+)/)?.[1]?.length ?? 2;
-			const componentName = line.match(/^\s*:{2,}(\w[\w-]*)/)?.[1] ?? "";
-			const innerLines = [];
-			i++;
-			while (i < lines.length) {
-				const l = lines[i];
-				if (new RegExp(`^\\s*:{${colons}}\\s*$`).test(l)) {
-					i++;
-					break;
-				}
-				const innerFence = l.match(/^(\s*`{3,})/);
-				if (innerFence) {
-					const fenceStr = innerFence[1].trimStart();
-					innerLines.push(l);
-					i++;
-					while (i < lines.length && !lines[i].trimStart().startsWith(fenceStr)) {
-						innerLines.push(lines[i]);
-						i++;
-					}
-					if (i < lines.length) {
-						innerLines.push(lines[i]);
-						i++;
-					}
-					continue;
-				}
-				innerLines.push(l);
-				i++;
-			}
-			const nonBlank = innerLines.filter((l) => l.trim().length > 0);
-			if (nonBlank.length) {
-				const minIndent = Math.min(...nonBlank.map((l) => l.match(/^(\s*)/)?.[1]?.length ?? 0));
-				if (minIndent > 0) for (let j = 0; j < innerLines.length; j++) innerLines[j] = innerLines[j].slice(Math.min(minIndent, innerLines[j].length));
-			}
-			let contentStart = 0;
-			if (innerLines[0]?.trim() === "---") {
-				const fmEnd = innerLines.findIndex((l, idx) => idx > 0 && l.trim() === "---");
-				if (fmEnd !== -1) contentStart = fmEnd + 1;
-			}
-			const contentLines = innerLines.slice(contentStart);
-			const defaultSlotLines = [];
-			const codeSlotLines = [];
-			let currentSlot = "default";
-			for (const l of contentLines) {
-				if (/^#code\s*$/.test(l)) {
-					currentSlot = "code";
-					continue;
-				}
-				if (/^#\w+/.test(l) && !/^#{2,}\s/.test(l)) {
-					currentSlot = "other";
-					continue;
-				}
-				if (currentSlot === "default") defaultSlotLines.push(l);
-				else if (currentSlot === "code") codeSlotLines.push(l);
-			}
-			const innerBlocks = parseBlocks(defaultSlotLines.join("\n"));
-			const codeBlocks = extractFencedCode(codeSlotLines);
-			if (new Set([
-				"tip",
-				"note",
-				"info",
-				"warning",
-				"caution",
-				"danger",
-				"callout",
-				"alert"
-			]).has(componentName.toLowerCase())) blocks.push({
-				type: "callout",
-				calloutType: componentName.toLowerCase(),
-				innerBlocks
-			});
-			else {
-				const mdcProps = parseMdcProps(line.match(MDC_OPEN)?.[3]);
-				const lc = componentName.toLowerCase();
-				if (lc === "collapsible") blocks.push({
-					type: "collapsible",
-					label: mdcProps["label"] || "Details",
-					open: mdcProps["open"] === "true",
-					innerBlocks
-				});
-				else if (lc === "steps") blocks.push({
-					type: "steps",
-					innerBlocks
-				});
-				else if (lc === "card") blocks.push({
-					type: "card",
-					title: mdcProps["title"] || "",
-					icon: mdcProps["icon"] || "",
-					to: mdcProps["to"] || "",
-					innerBlocks
-				});
-				else if (lc === "card-group") {
-					const cards = innerBlocks.filter((b) => b.type === "card");
-					if (cards.length) blocks.push({
-						type: "cardGroup",
-						cards
-					});
-					else blocks.push(...innerBlocks);
-				} else if (lc === "code-collapse") blocks.push({
-					type: "codeCollapse",
-					codeBlocks: codeBlocks.length ? codeBlocks : innerBlocks.filter((b) => b.type === "codeBlock")
-				});
-				else if (lc === "code-group") {
-					const allCode = [...innerBlocks.filter((b) => b.type === "codeBlock"), ...codeBlocks];
-					blocks.push({
-						type: "codeGroup",
-						codeBlocks: allCode
-					});
-				} else if (lc === "code-preview") blocks.push({
-					type: "codePreview",
-					innerBlocks,
-					codeBlocks
-				});
-				else if (lc === "code-tree") blocks.push({
-					type: "codeTree",
-					files: mdcProps["files"] || "[]"
-				});
-				else if (lc === "accordion") {
-					const items = parseMdcChildren(contentLines, "item");
-					if (items.length) blocks.push({
-						type: "accordion",
-						items
-					});
-					else blocks.push({
-						type: "accordion",
-						items: [{
-							label: "Item 1",
-							icon: "",
-							innerBlocks
-						}]
-					});
-				} else if (lc === "tabs") {
-					const items = parseMdcChildren(contentLines, "tab");
-					if (items.length) blocks.push({
-						type: "tabs",
-						items
-					});
-					else blocks.push({
-						type: "tabs",
-						items: [{
-							label: "Tab 1",
-							icon: "",
-							innerBlocks
-						}]
-					});
-				} else if (lc === "field") blocks.push({
-					type: "field",
-					name: mdcProps["name"] || "",
-					fieldType: mdcProps["type"] || "string",
-					required: mdcProps["required"] === "true",
-					innerBlocks
-				});
-				else if (lc === "field-group") {
-					const fields = innerBlocks.filter((b) => b.type === "field");
-					if (fields.length) blocks.push({
-						type: "fieldGroup",
-						fields
-					});
-					else blocks.push(...innerBlocks);
-				} else {
-					blocks.push(...innerBlocks);
-					blocks.push(...codeBlocks);
-				}
-			}
-			continue;
-		}
-		if (TASK_RE.test(line)) {
-			const { items, next } = consumeList(lines, i, 0, "task");
-			i = next;
-			blocks.push({
-				type: "taskList",
-				items
-			});
-			continue;
-		}
-		if (/^[-*+]\s+/.test(line)) {
-			const { items, next } = consumeList(lines, i, 0, "bullet");
-			if (items.length > 0) {
-				i = next;
-				blocks.push({
-					type: "bulletList",
-					items
-				});
-				continue;
-			}
-		}
-		if (/^\d+\.\s+/.test(line)) {
-			const { items, next } = consumeList(lines, i, 0, "ordered");
-			if (items.length > 0) {
-				i = next;
-				blocks.push({
-					type: "orderedList",
-					items
-				});
-				continue;
-			}
-		}
-		if (line.trim() === "") {
-			i++;
-			continue;
-		}
-		const paraLines = [];
-		while (i < lines.length && lines[i].trim() !== "" && !/^(#{1,6}\s|[-*+]\s|\d+\.\s|>|`{3,}|\s*\||[-*_]{3,}\s*$|\s*:{2,}\w)/.test(lines[i])) {
-			paraLines.push(lines[i]);
-			i++;
-		}
-		if (paraLines.length) blocks.push({
-			type: "paragraph",
-			text: paraLines.join(" ")
-		});
-		else {
-			blocks.push({
-				type: "paragraph",
-				text: line
-			});
-			i++;
-		}
+//#region packages/convert/src/spec/universal-meta.ts
+const UNIVERSAL_META_KEYS = [
+	{
+		key: "title",
+		type: "string",
+		doc: "Display title; the first H1 is hoisted into this field on import."
+	},
+	{
+		key: "type",
+		type: "string",
+		doc: "Page type (doc, kanban, table, …). Omitted on serialise when \"doc\"."
+	},
+	{
+		key: "color",
+		type: "string",
+		doc: "Hex or CSS color name."
+	},
+	{
+		key: "icon",
+		type: "string",
+		doc: "Lucide icon name in kebab-case."
+	},
+	{
+		key: "datetimeStart",
+		type: "iso-datetime"
+	},
+	{
+		key: "datetimeEnd",
+		type: "iso-datetime"
+	},
+	{
+		key: "allDay",
+		type: "boolean"
+	},
+	{
+		key: "dateTaken",
+		type: "iso-datetime"
+	},
+	{
+		key: "dateStart",
+		type: "iso-date",
+		parseAliases: ["date", "created"]
+	},
+	{
+		key: "dateEnd",
+		type: "iso-date",
+		parseAliases: ["due"]
+	},
+	{
+		key: "timeStart",
+		type: "hh-mm"
+	},
+	{
+		key: "timeEnd",
+		type: "hh-mm"
+	},
+	{
+		key: "tags",
+		type: "string[]"
+	},
+	{
+		key: "checked",
+		type: "boolean",
+		parseAliases: ["done"]
+	},
+	{
+		key: "priority",
+		type: "integer",
+		min: 0,
+		max: 4,
+		doc: "Numeric or named (low/medium/high/urgent → 1/2/3/4)."
+	},
+	{
+		key: "status",
+		type: "string"
+	},
+	{
+		key: "rating",
+		type: "number",
+		min: 0,
+		max: 5
+	},
+	{
+		key: "url",
+		type: "string"
+	},
+	{
+		key: "email",
+		type: "string"
+	},
+	{
+		key: "phone",
+		type: "string"
+	},
+	{
+		key: "number",
+		type: "number"
+	},
+	{
+		key: "unit",
+		type: "string"
+	},
+	{
+		key: "subtitle",
+		type: "string",
+		parseAliases: ["description"]
+	},
+	{
+		key: "note",
+		type: "string"
+	},
+	{
+		key: "taskProgress",
+		type: "integer",
+		min: 0,
+		max: 100
+	},
+	{
+		key: "members",
+		type: "members"
+	},
+	{
+		key: "coverUploadId",
+		type: "string"
+	},
+	{
+		key: "coverDocId",
+		type: "string"
+	},
+	{
+		key: "coverMimeType",
+		type: "string"
+	},
+	{
+		key: "geoType",
+		type: "string-enum",
+		values: [
+			"marker",
+			"line",
+			"measure"
+		]
+	},
+	{
+		key: "geoLat",
+		type: "number"
+	},
+	{
+		key: "geoLng",
+		type: "number"
+	},
+	{
+		key: "geoDescription",
+		type: "string"
+	},
+	{
+		key: "deskX",
+		type: "number"
+	},
+	{
+		key: "deskY",
+		type: "number"
+	},
+	{
+		key: "deskZ",
+		type: "number"
+	},
+	{
+		key: "deskMode",
+		type: "string-enum",
+		values: [
+			"icon",
+			"widget-sm",
+			"widget-lg"
+		]
+	},
+	{
+		key: "mmX",
+		type: "number"
+	},
+	{
+		key: "mmY",
+		type: "number"
+	},
+	{
+		key: "graphX",
+		type: "number"
+	},
+	{
+		key: "graphY",
+		type: "number"
+	},
+	{
+		key: "graphPinned",
+		type: "boolean"
+	},
+	{
+		key: "spX",
+		type: "number"
+	},
+	{
+		key: "spY",
+		type: "number"
+	},
+	{
+		key: "spZ",
+		type: "number"
+	},
+	{
+		key: "spRX",
+		type: "number"
+	},
+	{
+		key: "spRY",
+		type: "number"
+	},
+	{
+		key: "spRZ",
+		type: "number"
+	},
+	{
+		key: "spSX",
+		type: "number"
+	},
+	{
+		key: "spSY",
+		type: "number"
+	},
+	{
+		key: "spSZ",
+		type: "number"
+	},
+	{
+		key: "spShape",
+		type: "string-enum",
+		values: [
+			"box",
+			"sphere",
+			"cylinder",
+			"cone",
+			"plane",
+			"torus",
+			"glb"
+		]
+	},
+	{
+		key: "spOpacity",
+		type: "integer",
+		min: 0,
+		max: 100
+	},
+	{
+		key: "spModelUploadId",
+		type: "string"
+	},
+	{
+		key: "spModelDocId",
+		type: "string"
+	},
+	{
+		key: "slidesTransition",
+		type: "string-enum",
+		values: [
+			"none",
+			"fade",
+			"slide"
+		]
+	},
+	{
+		key: "slidesTheme",
+		type: "string-enum",
+		values: ["dark", "light"]
+	},
+	{
+		key: "__schemaVersion",
+		type: "integer",
+		min: 0
 	}
-	return blocks;
-}
+];
+const UNIVERSAL_META_KEY_NAMES = new Set(UNIVERSAL_META_KEYS.map((k) => k.key));
 /**
-* Insert formatted inline tokens into an already-attached Y.XmlElement.
-* Creates one Y.XmlText per token (attach first, fill second).
+* Build a map of every recognised input key (canonical + aliases) to
+* its canonical key. Used by the frontmatter parser.
 */
-function fillTextInto(el, tokens) {
-	const filtered = tokens.filter((t) => t.text.length > 0);
-	if (!filtered.length) return;
-	const children = filtered.map((tok) => {
-		return (tok.attrs?.docLink)?.docId ? new yjs.XmlElement("docLink") : new yjs.XmlText();
-	});
-	el.insert(0, children);
-	filtered.forEach((tok, i) => {
-		const node = children[i];
-		if (node instanceof yjs.XmlElement) {
-			const dl = tok.attrs.docLink;
-			node.setAttribute("docId", dl.docId);
-			return;
-		}
-		if (tok.attrs) node.insert(0, tok.text, tok.attrs);
-		else node.insert(0, tok.text);
-	});
-}
-function blockElName(b) {
-	switch (b.type) {
-		case "heading": return "heading";
-		case "paragraph": return "paragraph";
-		case "bulletList": return "bulletList";
-		case "orderedList": return "orderedList";
-		case "taskList": return "taskList";
-		case "codeBlock": return "codeBlock";
-		case "blockquote": return "blockquote";
-		case "table": return "table";
-		case "hr": return "horizontalRule";
-		case "callout": return "callout";
-		case "collapsible": return "collapsible";
-		case "steps": return "steps";
-		case "card": return "card";
-		case "cardGroup": return "cardGroup";
-		case "codeCollapse": return "codeCollapse";
-		case "codeGroup": return "codeGroup";
-		case "codePreview": return "codePreview";
-		case "codeTree": return "codeTree";
-		case "accordion": return "accordion";
-		case "tabs": return "tabs";
-		case "field": return "field";
-		case "fieldGroup": return "fieldGroup";
-		case "image": return "image";
-		case "docEmbed": return "docEmbed";
-		case "mathBlock": return "mathBlock";
-		case "fileBlock": return "fileBlock";
+function buildAliasMap() {
+	const map = /* @__PURE__ */ new Map();
+	for (const entry of UNIVERSAL_META_KEYS) {
+		map.set(entry.key, entry.key);
+		for (const alias of entry.parseAliases ?? []) map.set(alias, entry.key);
 	}
+	return map;
 }
-function populateListItemChildren(itemEl, item, _itemKind) {
-	const paraEl = new yjs.XmlElement("paragraph");
-	itemEl.insert(itemEl.length, [paraEl]);
-	fillTextInto(paraEl, parseInline(item.text));
-	if (!item.innerBlocks?.length) return;
-	const innerEls = item.innerBlocks.map((b) => new yjs.XmlElement(blockElName(b)));
-	itemEl.insert(itemEl.length, innerEls);
-	item.innerBlocks.forEach((b, i) => fillBlock(innerEls[i], b));
+
+//#endregion
+//#region packages/convert/src/markdown-to-yjs.ts
+function parseInlineArray(raw) {
+	return raw.slice(1, -1).split(",").map((s) => s.trim()).filter(Boolean);
 }
-function fillBlock(el, block) {
-	switch (block.type) {
-		case "heading":
-			el.setAttribute("level", block.level);
-			fillTextInto(el, parseInline(block.text));
-			break;
-		case "paragraph":
-			fillTextInto(el, parseInline(block.text));
-			break;
-		case "bulletList":
-		case "orderedList": {
-			const listItemEls = block.items.map(() => new yjs.XmlElement("listItem"));
-			el.insert(0, listItemEls);
-			block.items.forEach((item, i) => {
-				populateListItemChildren(listItemEls[i], item, "listItem");
-			});
-			break;
-		}
-		case "taskList": {
-			const taskItemEls = block.items.map(() => new yjs.XmlElement("taskItem"));
-			el.insert(0, taskItemEls);
-			block.items.forEach((item, i) => {
-				taskItemEls[i].setAttribute("checked", !!item.checked);
-				populateListItemChildren(taskItemEls[i], item, "taskItem");
-			});
-			break;
-		}
-		case "codeBlock": {
-			if (block.lang) el.setAttribute("language", block.lang);
-			const xt = new yjs.XmlText();
-			el.insert(0, [xt]);
-			xt.insert(0, block.code);
-			break;
-		}
-		case "blockquote": {
-			const paraEls = block.lines.map(() => new yjs.XmlElement("paragraph"));
-			el.insert(0, paraEls);
-			block.lines.forEach((line, i) => fillTextInto(paraEls[i], parseInline(line)));
-			break;
-		}
-		case "table": {
-			const headerRowEl = new yjs.XmlElement("tableRow");
-			const dataRowEls = block.dataRows.map(() => new yjs.XmlElement("tableRow"));
-			el.insert(0, [headerRowEl, ...dataRowEls]);
-			const headerCellEls = block.headerRow.map(() => new yjs.XmlElement("tableHeader"));
-			headerRowEl.insert(0, headerCellEls);
-			block.headerRow.forEach((cellText, i) => {
-				const paraEl = new yjs.XmlElement("paragraph");
-				headerCellEls[i].insert(0, [paraEl]);
-				fillTextInto(paraEl, parseInline(cellText));
-			});
-			block.dataRows.forEach((row, ri) => {
-				const cellEls = row.map(() => new yjs.XmlElement("tableCell"));
-				dataRowEls[ri].insert(0, cellEls);
-				row.forEach((cellText, ci) => {
-					const paraEl = new yjs.XmlElement("paragraph");
-					cellEls[ci].insert(0, [paraEl]);
-					fillTextInto(paraEl, parseInline(cellText));
-				});
-			});
-			break;
-		}
-		case "hr": break;
-		case "callout": {
-			el.setAttribute("type", block.calloutType);
-			if (!block.innerBlocks.length) {
-				const paraEl = new yjs.XmlElement("paragraph");
-				el.insert(0, [paraEl]);
-				break;
+function stripQuotes(s) {
+	if (s.length >= 2 && (s.startsWith("\"") && s.endsWith("\"") || s.startsWith("'") && s.endsWith("'"))) return s.slice(1, -1).replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
+	return s;
+}
+function parseFrontmatter(markdown) {
+	const noResult = {
+		meta: {},
+		body: markdown
+	};
+	const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+	if (!match) return noResult;
+	const yamlBlock = match[1];
+	const body = markdown.slice(match[0].length);
+	const raw = {};
+	const lines = yamlBlock.split("\n");
+	let i = 0;
+	while (i < lines.length) {
+		const line = lines[i];
+		const blockSeqKey = line.match(/^(\w[\w-]*):\s*$/);
+		if (blockSeqKey && i + 1 < lines.length && /^\s+-\s/.test(lines[i + 1])) {
+			const key = blockSeqKey[1];
+			const items = [];
+			i++;
+			while (i < lines.length && /^\s+-\s/.test(lines[i])) {
+				items.push(lines[i].replace(/^\s+-\s/, "").trim());
+				i++;
 			}
-			const innerEls = block.innerBlocks.map((b) => new yjs.XmlElement(blockElName(b)));
-			el.insert(0, innerEls);
-			block.innerBlocks.forEach((b, i) => fillBlock(innerEls[i], b));
-			break;
-		}
-		case "collapsible": {
-			el.setAttribute("label", block.label);
-			el.setAttribute("open", block.open);
-			const inner = block.innerBlocks.length ? block.innerBlocks : [{
-				type: "paragraph",
-				text: ""
-			}];
-			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
-			el.insert(0, innerEls);
-			inner.forEach((b, i) => fillBlock(innerEls[i], b));
-			break;
+			raw[key] = items;
+			continue;
 		}
-		case "steps": {
-			const inner = block.innerBlocks.length ? block.innerBlocks : [{
-				type: "paragraph",
-				text: ""
-			}];
-			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
-			el.insert(0, innerEls);
-			inner.forEach((b, i) => fillBlock(innerEls[i], b));
-			break;
+		const kvMatch = line.match(/^(\w[\w-]*):\s*(.*)$/);
+		if (kvMatch) {
+			const key = kvMatch[1];
+			const val = kvMatch[2].trim();
+			if (val.startsWith("[") && val.endsWith("]")) raw[key] = parseInlineArray(val).map(stripQuotes);
+			else raw[key] = stripQuotes(val);
 		}
-		case "card": {
-			if (block.title) el.setAttribute("title", block.title);
-			if (block.icon) el.setAttribute("icon", block.icon);
-			if (block.to) el.setAttribute("to", block.to);
-			const inner = block.innerBlocks.length ? block.innerBlocks : [{
-				type: "paragraph",
-				text: ""
-			}];
-			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
-			el.insert(0, innerEls);
-			inner.forEach((b, i) => fillBlock(innerEls[i], b));
-			break;
+		i++;
+	}
+	const meta = {};
+	const getStr = (keys) => {
+		for (const k of keys) {
+			const v = raw[k];
+			if (typeof v === "string" && v) return v;
 		}
-		case "cardGroup": {
-			const cardEls = block.cards.map((b) => new yjs.XmlElement(blockElName(b)));
-			el.insert(0, cardEls);
-			block.cards.forEach((b, i) => fillBlock(cardEls[i], b));
-			break;
+	};
+	if (raw["tags"]) meta.tags = Array.isArray(raw["tags"]) ? raw["tags"] : [raw["tags"]];
+	const color = getStr(["color"]);
+	if (color) meta.color = color;
+	const icon = getStr(["icon"]);
+	if (icon) meta.icon = icon;
+	const status = getStr(["status"]);
+	if (status) meta.status = status;
+	const priorityRaw = getStr(["priority"]);
+	if (priorityRaw !== void 0) meta.priority = {
+		low: 1,
+		medium: 2,
+		high: 3,
+		urgent: 4
+	}[priorityRaw.toLowerCase()] ?? (Number(priorityRaw) || 0);
+	const checkedRaw = raw["checked"] ?? raw["done"];
+	if (checkedRaw !== void 0) meta.checked = checkedRaw === "true" || checkedRaw === true;
+	const dateStart = getStr([
+		"dateStart",
+		"date",
+		"created"
+	]);
+	if (dateStart) meta.dateStart = dateStart;
+	const dateEnd = getStr(["dateEnd", "due"]);
+	if (dateEnd) meta.dateEnd = dateEnd;
+	const subtitle = getStr(["subtitle", "description"]);
+	if (subtitle) meta.subtitle = subtitle;
+	const url = getStr(["url"]);
+	if (url) meta.url = url;
+	const language = getStr(["language"]);
+	if (language) meta.language = language;
+	const fileExtension = getStr(["fileExtension"]);
+	if (fileExtension) meta.fileExtension = fileExtension;
+	const codeTheme = getStr(["codeTheme"]);
+	if (codeTheme) meta.codeTheme = codeTheme;
+	const ratingRaw = getStr(["rating"]);
+	if (ratingRaw !== void 0) {
+		const n = Number(ratingRaw);
+		if (!Number.isNaN(n)) meta.rating = Math.min(5, Math.max(0, n));
+	}
+	for (const [rawKey, rawVal] of Object.entries(raw)) {
+		if (CONSUMED_FM_KEYS.has(rawKey)) continue;
+		if (rawKey.startsWith("_")) continue;
+		const canonical = FM_ALIAS_MAP.get(rawKey);
+		if (canonical) {
+			if (canonical === "title" || canonical === "type") continue;
+			if (meta[canonical] !== void 0) continue;
+			const coerced = coerceMetaValue(rawVal, FM_SPEC_BY_KEY.get(canonical)?.type);
+			if (coerced !== void 0) meta[canonical] = coerced;
+		} else {
+			const coerced = coerceMetaValue(rawVal, void 0);
+			if (coerced !== void 0) meta[rawKey] = coerced;
 		}
-		case "codeCollapse": {
-			const codes = block.codeBlocks.length ? block.codeBlocks : [{
-				type: "codeBlock",
-				lang: "",
-				code: ""
-			}];
-			const codeEl = new yjs.XmlElement("codeBlock");
-			el.insert(0, [codeEl]);
-			fillBlock(codeEl, codes[0]);
-			break;
+	}
+	const rawTitle = typeof raw["title"] === "string" ? raw["title"] : void 0;
+	return {
+		title: rawTitle !== void 0 ? stripQuotes(rawTitle) : void 0,
+		type: getStr(["type"]),
+		meta,
+		body
+	};
+}
+/** Raw YAML keys the hand-rolled section of parseFrontmatter consumes. */
+const CONSUMED_FM_KEYS = new Set([
+	"title",
+	"type",
+	"tags",
+	"color",
+	"icon",
+	"status",
+	"priority",
+	"checked",
+	"done",
+	"dateStart",
+	"date",
+	"created",
+	"dateEnd",
+	"due",
+	"subtitle",
+	"description",
+	"url",
+	"language",
+	"fileExtension",
+	"codeTheme",
+	"rating"
+]);
+const FM_ALIAS_MAP = buildAliasMap();
+const FM_SPEC_BY_KEY = new Map(UNIVERSAL_META_KEYS.map((k) => [k.key, k]));
+/**
+* Coerce a raw YAML scalar/array to the spec's value type. With no spec
+* (custom key) the coercion is best-effort: booleans and numbers are
+* recognised by shape, everything else stays a string. Returns undefined
+* when the value can't be represented (caller skips the key).
+*/
+function coerceMetaValue(rawVal, specType) {
+	if (Array.isArray(rawVal)) return rawVal;
+	const v = rawVal;
+	if (v === "") return void 0;
+	switch (specType) {
+		case "number":
+		case "integer": {
+			const n = Number(v);
+			return Number.isFinite(n) ? n : void 0;
 		}
-		case "codeGroup": {
-			const codes = block.codeBlocks.length ? block.codeBlocks : [{
-				type: "codeBlock",
-				lang: "",
-				code: ""
-			}];
-			const codeEls = codes.map(() => new yjs.XmlElement("codeBlock"));
-			el.insert(0, codeEls);
-			codes.forEach((b, i) => fillBlock(codeEls[i], b));
-			break;
+		case "boolean": return v === "true";
+		case "string[]": return [v];
+		case "members":
+		case "json": try {
+			return JSON.parse(v);
+		} catch {
+			return;
 		}
-		case "codePreview": {
-			const all = [...block.innerBlocks, ...block.codeBlocks];
-			const inner = all.length ? all : [{
-				type: "paragraph",
-				text: ""
-			}];
-			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
-			el.insert(0, innerEls);
-			inner.forEach((b, i) => fillBlock(innerEls[i], b));
-			break;
+		case "string":
+		case "string-enum":
+		case "iso-date":
+		case "iso-datetime":
+		case "hh-mm": return v;
+		case void 0:
+			if (v === "true") return true;
+			if (v === "false") return false;
+			if (/^-?\d+(\.\d+)?$/.test(v)) return Number(v);
+			if (v.startsWith("{")) try {
+				return JSON.parse(v);
+			} catch {}
+			return v;
+	}
+}
+function pushNested(out, inner, wrap) {
+	const children = parseInline(inner);
+	if (children.length === 0) {
+		out.push({
+			text: inner,
+			attrs: { ...wrap }
+		});
+		return;
+	}
+	for (const child of children) out.push({
+		text: child.text,
+		attrs: {
+			...child.attrs ?? {},
+			...wrap
 		}
-		case "codeTree":
-			el.setAttribute("files", block.files);
-			break;
-		case "accordion": {
-			const itemEls = block.items.map(() => new yjs.XmlElement("accordionItem"));
-			el.insert(0, itemEls);
-			block.items.forEach((item, i) => {
-				itemEls[i].setAttribute("label", item.label);
-				if (item.icon) itemEls[i].setAttribute("icon", item.icon);
-				const inner = item.innerBlocks.length ? item.innerBlocks : [{
-					type: "paragraph",
-					text: ""
-				}];
-				const childEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
-				itemEls[i].insert(0, childEls);
-				inner.forEach((b, ci) => fillBlock(childEls[ci], b));
+	});
+}
+function parseInline(text) {
+	const stripped = text.replace(/\{lang="[^"]*"\}/g, "").replace(/:(?!badge|icon|kbd)(\w[\w-]*)\[([^\]]*)\](\{[^}]*\})?/g, "$2").replace(/:(?!badge|icon|kbd)(\w[\w-]*)(\{[^}]*\})/g, "");
+	const tokens = [];
+	const re = /\$([^$\n]+?)\$|@\[([^\]]+?)\]\(user:([^)]+?)\)|:badge\[([^\]]*)\](\{[^}]*\})?|:icon\{([^}]*)\}|:kbd\{([^}]*)\}|\[\[([0-9a-fA-F-]{36})(?:\|([^\]]+?))?\]\]|~~(.+?)~~|\*\*(.+?)\*\*|\*(.+?)\*|_(.+?)_|`(.+?)`|\[(.+?)\]\((.+?)\)/g;
+	let lastIndex = 0;
+	let match;
+	while ((match = re.exec(stripped)) !== null) {
+		if (match.index > lastIndex) tokens.push({ text: stripped.slice(lastIndex, match.index) });
+		if (match[1] !== void 0) tokens.push({
+			text: match[1],
+			attrs: { mathInline: { expression: match[1] } }
+		});
+		else if (match[2] !== void 0 && match[3] !== void 0) tokens.push({
+			text: match[2],
+			attrs: { mention: {
+				userId: match[3],
+				label: match[2]
+			} }
+		});
+		else if (match[4] !== void 0) {
+			const badgeProps = parseMdcProps(match[5]);
+			tokens.push({
+				text: match[4] || "Badge",
+				attrs: { badge: {
+					label: match[4] || "Badge",
+					color: badgeProps["color"] || "neutral",
+					variant: badgeProps["variant"] || "subtle"
+				} }
 			});
-			break;
-		}
-		case "tabs": {
-			const itemEls = block.items.map(() => new yjs.XmlElement("tabsItem"));
-			el.insert(0, itemEls);
-			block.items.forEach((item, i) => {
-				itemEls[i].setAttribute("label", item.label);
-				if (item.icon) itemEls[i].setAttribute("icon", item.icon);
-				const inner = item.innerBlocks.length ? item.innerBlocks : [{
-					type: "paragraph",
-					text: ""
-				}];
-				const childEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
-				itemEls[i].insert(0, childEls);
-				inner.forEach((b, ci) => fillBlock(childEls[ci], b));
+		} else if (match[6] !== void 0) {
+			const iconProps = parseMdcProps(`{${match[6]}}`);
+			tokens.push({
+				text: "​",
+				attrs: { proseIcon: { name: iconProps["name"] || "i-lucide-star" } }
 			});
-			break;
-		}
-		case "field": {
-			if (block.name) el.setAttribute("name", block.name);
-			el.setAttribute("type", block.fieldType);
-			el.setAttribute("required", block.required);
-			const inner = block.innerBlocks.length ? block.innerBlocks : [{
-				type: "paragraph",
-				text: ""
-			}];
-			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
-			el.insert(0, innerEls);
-			inner.forEach((b, i) => fillBlock(innerEls[i], b));
-			break;
+		} else if (match[7] !== void 0) {
+			const kbdProps = parseMdcProps(`{${match[7]}}`);
+			tokens.push({
+				text: kbdProps["value"] || "",
+				attrs: { kbd: { value: kbdProps["value"] || "" } }
+			});
+		} else if (match[8] !== void 0) {
+			const docId = match[8];
+			const label = match[9] ?? docId;
+			tokens.push({
+				text: label,
+				attrs: { docLink: { docId } }
+			});
+		} else if (match[10] !== void 0) pushNested(tokens, match[10], { strike: true });
+		else if (match[11] !== void 0) pushNested(tokens, match[11], { bold: true });
+		else if (match[12] !== void 0) pushNested(tokens, match[12], { italic: true });
+		else if (match[13] !== void 0) pushNested(tokens, match[13], { italic: true });
+		else if (match[14] !== void 0) tokens.push({
+			text: match[14],
+			attrs: { code: true }
+		});
+		else if (match[15] !== void 0 && match[16] !== void 0) tokens.push({
+			text: match[15],
+			attrs: { link: { href: match[16] } }
+		});
+		lastIndex = match.index + match[0].length;
+	}
+	if (lastIndex < stripped.length) tokens.push({ text: stripped.slice(lastIndex) });
+	return tokens.filter((t) => t.text.length > 0);
+}
+function parseTableRow(line) {
+	const parts = line.split("|");
+	return parts.slice(1, parts.length - 1).map((c) => c.trim());
+}
+function isTableSeparator(line) {
+	return /^\|[\s|:-]+\|$/.test(line.trim());
+}
+/** Extract fenced code blocks from MDC #code slot lines. */
+function extractFencedCode(lines) {
+	const result = [];
+	let i = 0;
+	while (i < lines.length) {
+		const fenceMatch = lines[i].match(/^(`{3,})(\w*)/);
+		if (fenceMatch) {
+			const fence = fenceMatch[1];
+			const lang = fenceMatch[2] ?? "";
+			const codeLines = [];
+			i++;
+			while (i < lines.length && !lines[i].startsWith(fence)) {
+				codeLines.push(lines[i]);
+				i++;
+			}
+			i++;
+			result.push({
+				type: "codeBlock",
+				lang,
+				code: codeLines.join("\n")
+			});
+			continue;
 		}
-		case "fieldGroup": {
-			const fieldEls = block.fields.map((b) => new yjs.XmlElement(blockElName(b)));
-			el.insert(0, fieldEls);
-			block.fields.forEach((b, i) => fillBlock(fieldEls[i], b));
-			break;
+		i++;
+	}
+	return result;
+}
+/** Extract key="value" pairs from MDC prop syntax `{key="value" other="x"}` */
+function parseMdcProps(propsStr) {
+	if (!propsStr) return {};
+	const result = {};
+	let s = propsStr.trim();
+	if (s.startsWith("{") && s.endsWith("}")) s = s.slice(1, -1);
+	const re = /(\w[\w-]*)(?:=(?:"([^"]*)"|([^\s"}]+)))?/g;
+	let m;
+	while ((m = re.exec(s)) !== null) {
+		const key = m[1];
+		if (m[2] !== void 0) result[key] = m[2];
+		else if (m[3] !== void 0) result[key] = m[3];
+		else result[key] = "true";
+	}
+	return result;
+}
+/** Parse named child MDC blocks from inner lines (e.g. #item for accordion, #tab for tabs) */
+function parseMdcChildren(innerLines, slotPrefix) {
+	const items = [];
+	let current = null;
+	const slotRe = new RegExp(`^#${slotPrefix}(\\{[^}]*\\})?\\s*$`);
+	for (const line of innerLines) {
+		const slotMatch = line.match(slotRe);
+		if (slotMatch) {
+			if (current) items.push(current);
+			const props = parseMdcProps(slotMatch[1]);
+			current = {
+				label: props["label"] || props["title"] || `Item ${items.length + 1}`,
+				icon: props["icon"] || "",
+				lines: []
+			};
+			continue;
 		}
-		case "image":
-			el.setAttribute("src", block.src);
-			if (block.alt) el.setAttribute("alt", block.alt);
-			if (block.width) el.setAttribute("width", block.width);
-			if (block.height) el.setAttribute("height", block.height);
-			break;
-		case "docEmbed":
-			el.setAttribute("docId", block.docId);
-			for (const flag of [
-				"collapsed",
-				"tall",
-				"seamless"
-			]) if (block.props[flag] === "true" || block.props[flag] === "1") el.setAttribute(flag, true);
-			break;
-		case "mathBlock":
-			el.setAttribute("expression", block.expression);
-			break;
-		case "fileBlock":
-			if (block.src) el.setAttribute("src", block.src);
-			if (block.mime) el.setAttribute("mime", block.mime);
-			if (block.uploadId) el.setAttribute("uploadId", block.uploadId);
-			if (block.filename) el.setAttribute("filename", block.filename);
-			break;
+		if (current) current.lines.push(line);
+		else if (!items.length && !current) current = {
+			label: `Item 1`,
+			icon: "",
+			lines: [line]
+		};
 	}
+	if (current) items.push(current);
+	return items.map((item) => ({
+		label: item.label,
+		icon: item.icon,
+		innerBlocks: parseBlocks(item.lines.join("\n"))
+	}));
 }
+const TASK_RE = /^[-*+]\s+\[([ xX])\]\s+(.*)/;
 /**
-* Parses markdown text and writes the result into a Y.XmlFragment that
-* TipTap's Collaboration extension can read.
-*
-* Requires `fragment.doc` to be set (i.e. the fragment must already be
-* obtained from a live Y.Doc via `ydoc.getXmlFragment('default')`).
+* Consume a list (bullet / ordered / task) starting at `start`. Indented
+* continuation lines and nested lists are captured into each item's
+* `innerBlocks` so the parse → serialise → parse cycle preserves tree
+* structure instead of flattening nested lists onto a single line.
 *
-* @param fragment      The target `Y.Doc.getXmlFragment('default')`
-* @param markdown      Raw markdown string
-* @param fallbackTitle Used as the title when the markdown has no H1
+* `indent` is the column of the item marker for the current list. A
+* nested list starts ≥2 columns deeper. Lines with less indent than
+* `indent` belong to the outer block and stop consumption.
 */
-function populateYDocFromMarkdown(fragment, markdown, fallbackTitle = "Untitled") {
-	const ydoc = fragment.doc;
-	if (!ydoc) {
-		console.warn("[markdownToYjs] fragment has no doc — skipping population");
-		return;
-	}
-	const fm = parseFrontmatter(markdown);
-	const blocks = parseBlocks(fm.body);
-	let title = fallbackTitle;
-	let titleSource;
-	if (fm.title !== void 0) {
-		title = fm.title;
-		titleSource = "frontmatter";
-	}
-	let contentBlocks = blocks;
-	const h1 = blocks.findIndex((b) => b.type === "heading" && b.level === 1);
-	if (h1 !== -1) {
-		title = blocks[h1].text;
-		contentBlocks = blocks.filter((_, i) => i !== h1);
-		titleSource = "h1";
-	}
-	ydoc.transact(() => {
-		const headerEl = new yjs.XmlElement("documentHeader");
-		const metaEl = new yjs.XmlElement("documentMeta");
-		const bodyEls = contentBlocks.map((b) => {
-			switch (b.type) {
-				case "heading": return new yjs.XmlElement("heading");
-				case "paragraph": return new yjs.XmlElement("paragraph");
-				case "bulletList": return new yjs.XmlElement("bulletList");
-				case "orderedList": return new yjs.XmlElement("orderedList");
-				case "taskList": return new yjs.XmlElement("taskList");
-				case "codeBlock": return new yjs.XmlElement("codeBlock");
-				case "blockquote": return new yjs.XmlElement("blockquote");
-				case "table": return new yjs.XmlElement("table");
-				case "hr": return new yjs.XmlElement("horizontalRule");
-				case "callout": return new yjs.XmlElement("callout");
-				case "collapsible": return new yjs.XmlElement("collapsible");
-				case "steps": return new yjs.XmlElement("steps");
-				case "card": return new yjs.XmlElement("card");
-				case "cardGroup": return new yjs.XmlElement("cardGroup");
-				case "codeCollapse": return new yjs.XmlElement("codeCollapse");
-				case "codeGroup": return new yjs.XmlElement("codeGroup");
-				case "codePreview": return new yjs.XmlElement("codePreview");
-				case "codeTree": return new yjs.XmlElement("codeTree");
-				case "accordion": return new yjs.XmlElement("accordion");
-				case "tabs": return new yjs.XmlElement("tabs");
-				case "field": return new yjs.XmlElement("field");
-				case "fieldGroup": return new yjs.XmlElement("fieldGroup");
-				case "image": return new yjs.XmlElement("image");
-				case "docEmbed": return new yjs.XmlElement("docEmbed");
-				case "mathBlock": return new yjs.XmlElement("mathBlock");
-				case "fileBlock": return new yjs.XmlElement("fileBlock");
+function consumeList(lines, start, indent, kind) {
+	const items = [];
+	let i = start;
+	while (i < lines.length) {
+		const line = lines[i];
+		if (line.trim() === "") {
+			let j = i + 1;
+			while (j < lines.length && lines[j].trim() === "") j++;
+			if (j >= lines.length) break;
+			const lookahead = lines[j];
+			if (leadingSpaces(lookahead) < indent) break;
+			if (!matchMarker(lookahead.slice(indent), kind)) break;
+			i = j;
+			continue;
+		}
+		const leading = leadingSpaces(line);
+		if (leading < indent) break;
+		if (leading > indent) break;
+		const m = matchMarker(line.slice(indent), kind);
+		if (!m) break;
+		const item = { text: m.text };
+		if (kind === "task") item.checked = m.checked;
+		i++;
+		const contLines = [];
+		let contMinIndent = Infinity;
+		while (i < lines.length) {
+			const next = lines[i];
+			if (next.trim() === "") {
+				let k = i + 1;
+				while (k < lines.length && lines[k].trim() === "") k++;
+				if (k >= lines.length) break;
+				if (leadingSpaces(lines[k]) <= indent) break;
+				contLines.push("");
+				i++;
+				continue;
 			}
-		});
-		fragment.insert(0, [
-			headerEl,
-			metaEl,
-			...bodyEls
-		]);
-		if (titleSource) headerEl.setAttribute("titleSource", titleSource);
-		const headerXt = new yjs.XmlText();
-		headerEl.insert(0, [headerXt]);
-		headerXt.insert(0, title);
-		for (const k of Object.keys(fm.meta)) {
-			const v = fm.meta[k];
-			if (v === void 0 || v === null) continue;
-			metaEl.setAttribute(k, v);
+			const nextIndent = leadingSpaces(next);
+			if (nextIndent <= indent) break;
+			if (nextIndent < contMinIndent) contMinIndent = nextIndent;
+			contLines.push(next);
+			i++;
 		}
-		if (fm.type) metaEl.setAttribute("type", fm.type);
-		contentBlocks.forEach((block, i) => fillBlock(bodyEls[i], block));
-	});
-}
-
-//#endregion
-//#region packages/convert/src/yjs-to-markdown.ts
-function isXElem(n) {
-	return !!n && typeof n.nodeName === "string";
+		if (contLines.length > 0) {
+			const deindentBy = contMinIndent === Infinity ? 0 : contMinIndent;
+			item.innerBlocks = parseBlocks(contLines.map((l) => l.slice(deindentBy)).join("\n"));
+		}
+		items.push(item);
+	}
+	return {
+		items,
+		next: i
+	};
 }
-function isXText(n) {
-	return !!n && typeof n.nodeName !== "string" && typeof n.toDelta === "function";
+function leadingSpaces(s) {
+	let n = 0;
+	while (n < s.length && s[n] === " ") n++;
+	return n;
 }
-function localizeFragment(fragment) {
-	return fragment;
+function matchMarker(s, kind) {
+	if (kind === "task") {
+		const m = s.match(TASK_RE);
+		if (!m) return null;
+		return {
+			text: m[2],
+			checked: m[1].toLowerCase() === "x"
+		};
+	}
+	if (kind === "bullet") {
+		if (TASK_RE.test(s)) return null;
+		const m = s.match(/^[-*+]\s+(.*)$/);
+		if (!m) return null;
+		return {
+			text: m[1],
+			checked: false
+		};
+	}
+	const m = s.match(/^\d+\.\s+(.*)$/);
+	if (!m) return null;
+	return {
+		text: m[1],
+		checked: false
+	};
 }
-function serializeDelta(delta) {
-	let result = "";
-	for (const op of delta) {
-		if (typeof op.insert !== "string") continue;
-		let text = op.insert;
-		const attrs = op.attributes ?? {};
-		if (attrs.code) {
-			result += `\`${text}\``;
+function parseBlocks(markdown) {
+	const rawLines = markdown.split("\n");
+	let firstContentLine = 0;
+	while (firstContentLine < rawLines.length) {
+		const l = rawLines[firstContentLine];
+		if (l.trim() === "" || /^import\s/.test(l) || /^export\s/.test(l)) firstContentLine++;
+		else break;
+	}
+	const stripped = rawLines.slice(firstContentLine).join("\n");
+	const blocks = [];
+	const lines = stripped.split("\n");
+	let i = 0;
+	while (i < lines.length) {
+		const line = lines[i];
+		const fenceBlockMatch = line.match(/^(`{3,})(.*)$/);
+		if (fenceBlockMatch) {
+			const fence = fenceBlockMatch[1];
+			const lang = fenceBlockMatch[2].trim().replace(/\{[^}]*\}$/, "").replace(/\s*\[.*\]$/, "").trim();
+			const codeLines = [];
+			i++;
+			while (i < lines.length && !lines[i].startsWith(fence)) {
+				codeLines.push(lines[i]);
+				i++;
+			}
+			i++;
+			const code = codeLines.join("\n");
+			if (lang === "math") blocks.push({
+				type: "mathBlock",
+				expression: code
+			});
+			else blocks.push({
+				type: "codeBlock",
+				lang,
+				code
+			});
 			continue;
 		}
-		if (attrs.badge) {
-			const b = attrs.badge;
-			const props = [];
-			if (b.color && b.color !== "neutral") props.push(`color="${b.color}"`);
-			if (b.variant && b.variant !== "subtle") props.push(`variant="${b.variant}"`);
-			result += `:badge[${b.label || text}]${props.length ? `{${props.join(" ")}}` : ""}`;
+		const headingMatch = line.match(/^(#{1,6})\s+(.*)/);
+		if (headingMatch) {
+			blocks.push({
+				type: "heading",
+				level: headingMatch[1].length,
+				text: headingMatch[2].trim()
+			});
+			i++;
 			continue;
 		}
-		if (attrs.proseIcon) {
-			const icon = attrs.proseIcon.name || "i-lucide-star";
-			result += `:icon{name="${icon}"}`;
+		if (/^[-*_]{3,}\s*$/.test(line)) {
+			blocks.push({ type: "hr" });
+			i++;
 			continue;
 		}
-		if (attrs.kbd) {
-			const value = attrs.kbd.value || text;
-			result += `:kbd{value="${value}"}`;
+		const embedMatch = line.match(/^!\[\[([0-9a-fA-F-]{36})(?:\|([^\]]+))?\]\](\{[^}]*\})?\s*$/);
+		if (embedMatch) {
+			const docId = embedMatch[1];
+			const label = embedMatch[2] ?? "";
+			const props = parseMdcProps(embedMatch[3]);
+			blocks.push({
+				type: "docEmbed",
+				docId,
+				label,
+				props
+			});
+			i++;
 			continue;
 		}
-		if (attrs.docLink) {
-			const docId = attrs.docLink.docId;
-			if (docId) {
-				result += text === docId ? `[[${docId}]]` : `[[${docId}|${text}]]`;
-				continue;
-			}
+		const imgMatch = line.match(/^!\[([^\]]*)\]\(([^)]+)\)(\{[^}]*\})?\s*$/);
+		if (imgMatch) {
+			const alt = imgMatch[1] ?? "";
+			const src = imgMatch[2] ?? "";
+			const attrs = parseMdcProps(imgMatch[3]);
+			blocks.push({
+				type: "image",
+				src,
+				alt,
+				width: attrs["width"],
+				height: attrs["height"]
+			});
+			i++;
+			continue;
 		}
-		if (attrs.mention) {
-			const { userId, label } = attrs.mention;
-			if (userId) {
-				result += `@[${label || text}](user:${userId})`;
-				continue;
+		if (line.startsWith(">")) {
+			const bqLines = [];
+			while (i < lines.length && lines[i].startsWith(">")) {
+				bqLines.push(lines[i].replace(/^>\s?/, ""));
+				i++;
 			}
-		}
-		if (attrs.mathInline) {
-			const expr = attrs.mathInline.expression ?? text;
-			result += `$${expr}$`;
+			blocks.push({
+				type: "blockquote",
+				lines: bqLines
+			});
 			continue;
 		}
-		if (attrs.bold) text = `**${text}**`;
-		if (attrs.italic) text = `*${text}*`;
-		if (attrs.strike) text = `~~${text}~~`;
-		if (attrs.link) {
-			const href = attrs.link.href ?? "";
-			text = `[${text}](${href})`;
-		}
-		result += text;
-	}
-	return result;
-}
-function serializeInline(el) {
-	const parts = [];
-	for (const child of el.toArray()) if (isXText(child)) parts.push(serializeDelta(child.toDelta()));
-	else if (isXElem(child)) if (child.nodeName === "docLink") {
-		const docId = child.getAttribute("docId") ?? "";
-		parts.push(`[[${docId}]]`);
-	} else parts.push(serializeInline(child));
-	return parts.join("");
-}
-function serializeBlock(el, indent = "") {
-	if (isXText(el)) return serializeDelta(el.toDelta());
-	switch (el.nodeName) {
-		case "documentHeader":
-		case "documentMeta": return "";
-		case "heading": {
-			const level = Number(el.getAttribute("level") ?? 2);
-			return `${"#".repeat(level)} ${serializeInline(el)}`;
-		}
-		case "paragraph": return serializeInline(el);
-		case "bulletList": return serializeListItems(el, "bullet", indent);
-		case "orderedList": return serializeListItems(el, "ordered", indent);
-		case "taskList": return serializeTaskList(el, indent);
-		case "codeBlock": {
-			const lang = el.getAttribute("language") ?? "";
-			const code = getCodeBlockText(el);
-			if (code === "") return `\`\`\`${lang}\n\`\`\``;
-			return `\`\`\`${lang}\n${code}\n\`\`\``;
-		}
-		case "blockquote": {
-			const lines = [];
-			for (const child of el.toArray()) if (isXElem(child)) {
-				const text = serializeBlock(child);
-				for (const line of text.split("\n")) lines.push(`> ${line}`);
+		if (/^\s*\|/.test(line)) {
+			const tableLines = [];
+			while (i < lines.length && /^\s*\|/.test(lines[i])) {
+				tableLines.push(lines[i]);
+				i++;
 			}
-			return lines.join("\n");
-		}
-		case "table": return serializeTable(el);
-		case "horizontalRule": return "---";
-		case "image": {
-			const src = el.getAttribute("src") ?? "";
-			const alt = el.getAttribute("alt") ?? "";
-			const width = el.getAttribute("width");
-			const height = el.getAttribute("height");
-			const attrs = [];
-			if (width) attrs.push(`width=${width}`);
-			if (height) attrs.push(`height=${height}`);
-			return `![${alt}](${src})${attrs.length ? `{${attrs.join(" ")}}` : ""}`;
-		}
-		case "docEmbed": {
-			const docId = el.getAttribute("docId") ?? "";
-			const collapsed = el.getAttribute("collapsed");
-			const tall = el.getAttribute("tall");
-			const seamless = el.getAttribute("seamless");
-			const flags = [];
-			if (collapsed === true || collapsed === "true") flags.push("collapsed");
-			if (tall === true || tall === "true") flags.push("tall");
-			if (seamless === true || seamless === "true") flags.push("seamless");
-			return `![[${docId}]]${flags.length ? `{${flags.join(" ")}}` : ""}`;
-		}
-		case "mathBlock": return `\`\`\`math\n${el.getAttribute("expression") ?? ""}\n\`\`\``;
-		case "fileBlock": {
-			const uploadId = el.getAttribute("uploadId") ?? "";
-			const filename = el.getAttribute("filename") ?? "";
-			const mime = el.getAttribute("mime") ?? "";
-			const src = el.getAttribute("src") ?? (uploadId && filename ? `.abracadabra/files/${uploadId}-${filename}` : "");
-			const props = [];
-			if (src) props.push(`src="${src}"`);
-			if (mime) props.push(`mime="${mime}"`);
-			if (uploadId) props.push(`upload-id="${uploadId}"`);
-			if (filename) props.push(`filename="${filename}"`);
-			return `:file{${props.join(" ")}}`;
-		}
-		case "callout": return `::${el.getAttribute("type") ?? "note"}\n${serializeChildren(el)}\n::`;
-		case "collapsible": {
-			const label = el.getAttribute("label") ?? "Details";
-			const open = el.getAttribute("open");
-			const props = [`label="${label}"`];
-			if (open === true || open === "true") props.push("open=\"true\"");
-			return `::collapsible{${props.join(" ")}}\n${serializeChildren(el)}\n::`;
-		}
-		case "steps": return `::steps\n${serializeChildren(el)}\n::`;
-		case "card": {
-			const props = [];
-			const title = el.getAttribute("title");
-			const icon = el.getAttribute("icon");
-			const to = el.getAttribute("to");
-			if (title) props.push(`title="${title}"`);
-			if (icon) props.push(`icon="${icon}"`);
-			if (to) props.push(`to="${to}"`);
-			return `::card${props.length ? `{${props.join(" ")}}` : ""}\n${serializeChildren(el)}\n::`;
-		}
-		case "cardGroup": return `::card-group\n${el.toArray().filter((c) => isXElem(c)).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
-		case "codeCollapse": return `::code-collapse\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
-		case "codeGroup": return `::code-group\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
-		case "codePreview": {
-			const children = el.toArray().filter((c) => isXElem(c));
-			const nonCode = children.filter((c) => c.nodeName !== "codeBlock").map((c) => serializeBlock(c)).join("\n\n");
-			const code = children.filter((c) => c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n");
-			const parts = [nonCode];
-			if (code) parts.push(`#code\n${code}`);
-			return `::code-preview\n${parts.filter(Boolean).join("\n\n")}\n::`;
-		}
-		case "codeTree": return `::code-tree{files="${el.getAttribute("files") ?? "[]"}"}\n::`;
-		case "accordion": return serializeSlottedContainer(el, "accordion", "accordionItem", "item");
-		case "tabs": return serializeSlottedContainer(el, "tabs", "tabsItem", "tab");
-		case "field": {
-			const fieldName = el.getAttribute("name") ?? "";
-			const fieldType = el.getAttribute("type") ?? "string";
-			const required = el.getAttribute("required");
-			const props = [`name="${fieldName}"`, `type="${fieldType}"`];
-			if (required === true || required === "true") props.push("required=\"true\"");
-			return `::field{${props.join(" ")}}\n${serializeChildren(el)}\n::`;
-		}
-		case "fieldGroup": return `::field-group\n${el.toArray().filter((c) => isXElem(c)).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
-		default: return serializeChildren(el);
-	}
-}
-function serializeChildren(el) {
-	const blocks = [];
-	for (const child of el.toArray()) if (isXElem(child)) {
-		const text = serializeBlock(child);
-		if (text) blocks.push(text);
-	} else if (isXText(child)) {
-		const text = serializeDelta(child.toDelta());
-		if (text) blocks.push(text);
-	}
-	return blocks.join("\n\n");
-}
-function serializeListItems(el, type, indent) {
-	const lines = [];
-	let counter = 1;
-	for (const child of el.toArray()) {
-		if (!isXElem(child) || child.nodeName !== "listItem") continue;
-		const prefix = type === "bullet" ? "- " : `${counter++}. `;
-		const subParts = [];
-		for (const sub of child.toArray()) {
-			if (!isXElem(sub)) continue;
-			if (sub.nodeName === "bulletList") subParts.push(serializeListItems(sub, "bullet", indent + "  "));
-			else if (sub.nodeName === "orderedList") subParts.push(serializeListItems(sub, "ordered", indent + "  "));
-			else subParts.push(serializeInline(sub));
-		}
-		if (subParts.length <= 1) lines.push(`${indent}${prefix}${subParts[0] ?? ""}`);
-		else {
-			lines.push(`${indent}${prefix}${subParts[0] ?? ""}`);
-			for (let i = 1; i < subParts.length; i++) lines.push(subParts[i]);
+			if (tableLines.length >= 2 && isTableSeparator(tableLines[1])) {
+				const headerRow = parseTableRow(tableLines[0]);
+				const dataRows = tableLines.slice(2).filter((l) => !isTableSeparator(l)).map(parseTableRow);
+				blocks.push({
+					type: "table",
+					headerRow,
+					dataRows
+				});
+			} else for (const l of tableLines) blocks.push({
+				type: "paragraph",
+				text: l
+			});
+			continue;
 		}
-	}
-	return lines.join("\n");
-}
-function serializeTaskList(el, indent) {
-	const lines = [];
-	for (const child of el.toArray()) {
-		if (!isXElem(child) || child.nodeName !== "taskItem") continue;
-		const checked = child.getAttribute("checked");
-		const marker = checked === true || checked === "true" ? "[x]" : "[ ]";
-		let header = "";
-		const nestedParts = [];
-		for (const sub of child.toArray()) {
-			if (!isXElem(sub)) continue;
-			if (sub.nodeName === "paragraph" && header === "") header = serializeInline(sub);
-			else if (sub.nodeName === "bulletList") nestedParts.push(serializeListItems(sub, "bullet", indent + "  "));
-			else if (sub.nodeName === "orderedList") nestedParts.push(serializeListItems(sub, "ordered", indent + "  "));
-			else if (sub.nodeName === "taskList") nestedParts.push(serializeTaskList(sub, indent + "  "));
-			else nestedParts.push(indent + "  " + serializeBlock(sub, indent + "  "));
+		const atomMatch = line.match(/^:(\w[\w-]*)(\{[^}]*\})?\s*$/);
+		if (atomMatch && atomMatch[1] === "file") {
+			const props = parseMdcProps(atomMatch[2]);
+			const uploadId = props["upload-id"] ?? props["uploadId"] ?? "";
+			const filename = props["filename"] ?? "";
+			const mime = props["mime"] ?? "";
+			const src = props["src"] ?? (uploadId && filename ? `.abracadabra/files/${uploadId}-${filename}` : "");
+			blocks.push({
+				type: "fileBlock",
+				src,
+				mime,
+				uploadId,
+				filename
+			});
+			i++;
+			continue;
 		}
-		lines.push(`${indent}- ${marker} ${header}`);
-		for (const part of nestedParts) lines.push(part);
-	}
-	return lines.join("\n");
-}
-function getCodeBlockText(el) {
-	for (const child of el.toArray()) if (isXText(child)) return child.toString();
-	return "";
-}
-function serializeTable(el) {
-	const rows = el.toArray().filter((c) => isXElem(c));
-	if (!rows.length) return "";
-	const serializedRows = [];
-	for (const row of rows) {
-		const cells = row.toArray().filter((c) => isXElem(c)).map((cell) => {
-			return cell.toArray().filter((c) => isXElem(c)).map((c) => serializeInline(c)).join(" ");
-		});
-		serializedRows.push(cells);
-	}
-	if (!serializedRows.length) return "";
-	const colCount = Math.max(...serializedRows.map((r) => r.length));
-	const headerRow = serializedRows[0];
-	const separator = Array(colCount).fill("---");
-	const dataRows = serializedRows.slice(1);
-	const formatRow = (cells) => {
-		return `| ${Array(colCount).fill("").map((_, i) => cells[i] ?? "").join(" | ")} |`;
-	};
-	return [
-		formatRow(headerRow),
-		formatRow(separator),
-		...dataRows.map(formatRow)
-	].join("\n");
-}
-function serializeSlottedContainer(el, containerName, childName, slotPrefix) {
-	return `::${containerName}\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === childName).map((item) => {
-		const label = item.getAttribute("label") ?? "";
-		const icon = item.getAttribute("icon") ?? "";
-		const props = [];
-		if (label) props.push(`label="${label}"`);
-		if (icon) props.push(`icon="${icon}"`);
-		const content = serializeChildren(item);
-		return `#${slotPrefix}{${props.join(" ")}}\n${content}`;
-	}).join("\n\n")}\n::`;
-}
-function generateFrontmatter(label, meta, type) {
-	const lines = [];
-	if (label !== void 0) lines.push(`title: "${escapeYaml(label)}"`);
-	if (type && type !== "doc") lines.push(`type: ${type}`);
-	if (!meta) return `---\n${lines.join("\n")}\n---`;
-	if (meta.tags?.length) lines.push(`tags: [${meta.tags.join(", ")}]`);
-	if (meta.color) lines.push(`color: ${yamlScalar(meta.color)}`);
-	if (meta.icon) lines.push(`icon: ${yamlScalar(meta.icon)}`);
-	if (meta.status) lines.push(`status: ${yamlScalar(meta.status)}`);
-	if (meta.priority !== void 0 && meta.priority !== 0) lines.push(`priority: ${{
-		1: "low",
-		2: "medium",
-		3: "high",
-		4: "urgent"
-	}[meta.priority] ?? meta.priority}`);
-	if (meta.checked !== void 0) lines.push(`checked: ${meta.checked}`);
-	if (meta.language) lines.push(`language: ${yamlScalar(meta.language)}`);
-	if (meta.fileExtension) lines.push(`fileExtension: ${yamlScalar(meta.fileExtension)}`);
-	if (meta.codeTheme) lines.push(`codeTheme: ${yamlScalar(meta.codeTheme)}`);
-	if (meta.dateStart) lines.push(`dateStart: "${escapeYaml(meta.dateStart)}"`);
-	if (meta.dateEnd) lines.push(`dateEnd: "${escapeYaml(meta.dateEnd)}"`);
-	if (meta.subtitle) lines.push(`subtitle: "${escapeYaml(meta.subtitle)}"`);
-	if (meta.url) lines.push(`url: ${meta.url}`);
-	if (meta.rating !== void 0 && meta.rating !== 0) lines.push(`rating: ${meta.rating}`);
-	return `---\n${lines.join("\n")}\n---`;
-}
-/**
-* Render a YAML scalar — bare when safe, double-quoted when the value
-* needs escaping. YAML treats `#`, `:`, leading whitespace, and a few
-* other characters as syntactically significant, so anything starting
-* with one of those gets quoted to stay round-trip safe.
-*/
-function yamlScalar(s) {
-	if (s === "") return "\"\"";
-	if (/^[#&*!|>%@`]/.test(s)) return `"${escapeYaml(s)}"`;
-	if (/[:"]/.test(s)) return `"${escapeYaml(s)}"`;
-	if (/^\s|\s$/.test(s)) return `"${escapeYaml(s)}"`;
-	return s;
-}
-function escapeYaml(s) {
-	return s.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
-}
-function yjsToMarkdown(fragment, label, meta, type) {
-	fragment = localizeFragment(fragment);
-	const { text: headerText, source: titleSource } = readDocumentHeader(fragment);
-	const effectiveTitle = headerText || label;
-	const docMeta = readDocumentMeta(fragment);
-	const effectiveMeta = meta ?? docMeta.meta;
-	const effectiveType = type ?? docMeta.type;
-	const metaIsEmpty = isMetaEmpty(effectiveMeta);
-	const typeIsDefault = !effectiveType || effectiveType === "doc";
-	const bodyBlocks = collectBodyBlocks(fragment);
-	let body;
-	if (titleSource === "h1" && effectiveTitle) {
-		const tail = serializeBlocksClean(bodyBlocks);
-		body = tail === "" ? `# ${effectiveTitle}` : `# ${effectiveTitle}\n\n${tail}`;
-	} else body = serializeBlocksClean(bodyBlocks);
-	const wantFrontmatterTitle = titleSource === "frontmatter";
-	if (!wantFrontmatterTitle && !(!metaIsEmpty || !typeIsDefault)) return body === "" ? "" : `${body}\n`;
-	const frontmatter = generateFrontmatter(wantFrontmatterTitle ? effectiveTitle : void 0, effectiveMeta, effectiveType);
-	if (body === "") return `${frontmatter}\n`;
-	return `${frontmatter}\n\n${body}\n`;
-}
-function readDocumentMeta(fragment) {
-	const meta = {};
-	let type;
-	for (const child of fragment.toArray()) {
-		if (!isXElem(child) || child.nodeName !== "documentMeta") continue;
-		const attrs = child.getAttributes();
-		for (const k of Object.keys(attrs)) {
-			const v = attrs[k];
-			if (v === void 0 || v === null) continue;
-			if (k === "type" && typeof v === "string") {
-				type = v;
+		const MDC_OPEN = /^\s*(:{2,})(\w[\w-]*)(\{[^}]*\})?\s*$/;
+		if (MDC_OPEN.test(line)) {
+			const colons = line.match(/^\s*(:+)/)?.[1]?.length ?? 2;
+			const componentName = line.match(/^\s*:{2,}(\w[\w-]*)/)?.[1] ?? "";
+			const innerLines = [];
+			i++;
+			while (i < lines.length) {
+				const l = lines[i];
+				if (new RegExp(`^\\s*:{${colons}}\\s*$`).test(l)) {
+					i++;
+					break;
+				}
+				const innerFence = l.match(/^(\s*`{3,})/);
+				if (innerFence) {
+					const fenceStr = innerFence[1].trimStart();
+					innerLines.push(l);
+					i++;
+					while (i < lines.length && !lines[i].trimStart().startsWith(fenceStr)) {
+						innerLines.push(lines[i]);
+						i++;
+					}
+					if (i < lines.length) {
+						innerLines.push(lines[i]);
+						i++;
+					}
+					continue;
+				}
+				innerLines.push(l);
+				i++;
+			}
+			const nonBlank = innerLines.filter((l) => l.trim().length > 0);
+			if (nonBlank.length) {
+				const minIndent = Math.min(...nonBlank.map((l) => l.match(/^(\s*)/)?.[1]?.length ?? 0));
+				if (minIndent > 0) for (let j = 0; j < innerLines.length; j++) innerLines[j] = innerLines[j].slice(Math.min(minIndent, innerLines[j].length));
+			}
+			let contentStart = 0;
+			if (innerLines[0]?.trim() === "---") {
+				const fmEnd = innerLines.findIndex((l, idx) => idx > 0 && l.trim() === "---");
+				if (fmEnd !== -1) contentStart = fmEnd + 1;
+			}
+			const contentLines = innerLines.slice(contentStart);
+			const defaultSlotLines = [];
+			const codeSlotLines = [];
+			let currentSlot = "default";
+			for (const l of contentLines) {
+				if (/^#code\s*$/.test(l)) {
+					currentSlot = "code";
+					continue;
+				}
+				if (/^#\w+/.test(l) && !/^#{2,}\s/.test(l)) {
+					currentSlot = "other";
+					continue;
+				}
+				if (currentSlot === "default") defaultSlotLines.push(l);
+				else if (currentSlot === "code") codeSlotLines.push(l);
+			}
+			const innerBlocks = parseBlocks(defaultSlotLines.join("\n"));
+			const codeBlocks = extractFencedCode(codeSlotLines);
+			if (new Set([
+				"tip",
+				"note",
+				"info",
+				"warning",
+				"caution",
+				"danger",
+				"callout",
+				"alert"
+			]).has(componentName.toLowerCase())) blocks.push({
+				type: "callout",
+				calloutType: componentName.toLowerCase(),
+				innerBlocks
+			});
+			else {
+				const mdcProps = parseMdcProps(line.match(MDC_OPEN)?.[3]);
+				const lc = componentName.toLowerCase();
+				if (lc === "collapsible") blocks.push({
+					type: "collapsible",
+					label: mdcProps["label"] || "Details",
+					open: mdcProps["open"] === "true",
+					innerBlocks
+				});
+				else if (lc === "steps") blocks.push({
+					type: "steps",
+					innerBlocks
+				});
+				else if (lc === "card") blocks.push({
+					type: "card",
+					title: mdcProps["title"] || "",
+					icon: mdcProps["icon"] || "",
+					to: mdcProps["to"] || "",
+					innerBlocks
+				});
+				else if (lc === "card-group") {
+					const cards = innerBlocks.filter((b) => b.type === "card");
+					if (cards.length) blocks.push({
+						type: "cardGroup",
+						cards
+					});
+					else blocks.push(...innerBlocks);
+				} else if (lc === "code-collapse") blocks.push({
+					type: "codeCollapse",
+					codeBlocks: codeBlocks.length ? codeBlocks : innerBlocks.filter((b) => b.type === "codeBlock")
+				});
+				else if (lc === "code-group") {
+					const allCode = [...innerBlocks.filter((b) => b.type === "codeBlock"), ...codeBlocks];
+					blocks.push({
+						type: "codeGroup",
+						codeBlocks: allCode
+					});
+				} else if (lc === "code-preview") blocks.push({
+					type: "codePreview",
+					innerBlocks,
+					codeBlocks
+				});
+				else if (lc === "code-tree") blocks.push({
+					type: "codeTree",
+					files: mdcProps["files"] || "[]"
+				});
+				else if (lc === "accordion") {
+					const items = parseMdcChildren(contentLines, "item");
+					if (items.length) blocks.push({
+						type: "accordion",
+						items
+					});
+					else blocks.push({
+						type: "accordion",
+						items: [{
+							label: "Item 1",
+							icon: "",
+							innerBlocks
+						}]
+					});
+				} else if (lc === "tabs") {
+					const items = parseMdcChildren(contentLines, "tab");
+					if (items.length) blocks.push({
+						type: "tabs",
+						items
+					});
+					else blocks.push({
+						type: "tabs",
+						items: [{
+							label: "Tab 1",
+							icon: "",
+							innerBlocks
+						}]
+					});
+				} else if (lc === "field") blocks.push({
+					type: "field",
+					name: mdcProps["name"] || "",
+					fieldType: mdcProps["type"] || "string",
+					required: mdcProps["required"] === "true",
+					innerBlocks
+				});
+				else if (lc === "field-group") {
+					const fields = innerBlocks.filter((b) => b.type === "field");
+					if (fields.length) blocks.push({
+						type: "fieldGroup",
+						fields
+					});
+					else blocks.push(...innerBlocks);
+				} else {
+					blocks.push(...innerBlocks);
+					blocks.push(...codeBlocks);
+				}
+			}
+			continue;
+		}
+		if (TASK_RE.test(line)) {
+			const { items, next } = consumeList(lines, i, 0, "task");
+			i = next;
+			blocks.push({
+				type: "taskList",
+				items
+			});
+			continue;
+		}
+		if (/^[-*+]\s+/.test(line)) {
+			const { items, next } = consumeList(lines, i, 0, "bullet");
+			if (items.length > 0) {
+				i = next;
+				blocks.push({
+					type: "bulletList",
+					items
+				});
 				continue;
 			}
-			meta[k] = v;
 		}
-		break;
-	}
-	return {
-		meta,
-		type
-	};
-}
-function readDocumentHeader(fragment) {
-	for (const child of fragment.toArray()) {
-		if (!isXElem(child) || child.nodeName !== "documentHeader") continue;
-		const text = child.toArray().find((c) => isXText(c));
-		const src = child.getAttribute("titleSource");
-		const source = src === "h1" || src === "frontmatter" ? src : void 0;
-		return {
-			text: text ? text.toString() : "",
-			source
-		};
-	}
-	return { text: "" };
-}
-function collectBodyBlocks(fragment) {
-	const out = [];
-	for (const child of fragment.toArray()) {
-		if (!isXElem(child)) continue;
-		if (child.nodeName === "documentHeader" || child.nodeName === "documentMeta") continue;
-		out.push(child);
-	}
-	return out;
-}
-function serializeBlocksClean(blocks) {
-	const parts = [];
-	for (const block of blocks) {
-		if (block.nodeName === "paragraph" && block.length === 0) {
-			parts.push("");
+		if (/^\d+\.\s+/.test(line)) {
+			const { items, next } = consumeList(lines, i, 0, "ordered");
+			if (items.length > 0) {
+				i = next;
+				blocks.push({
+					type: "orderedList",
+					items
+				});
+				continue;
+			}
+		}
+		if (line.trim() === "") {
+			i++;
 			continue;
 		}
-		parts.push(serializeBlock(block));
-	}
-	while (parts.length && parts[parts.length - 1] === "") parts.pop();
-	return parts.join("\n\n");
-}
-function isMetaEmpty(meta) {
-	if (!meta) return true;
-	for (const key of Object.keys(meta)) {
-		const v = meta[key];
-		if (v === void 0 || v === null) continue;
-		if (typeof v === "string" && v === "") continue;
-		if (Array.isArray(v) && v.length === 0) continue;
-		return false;
-	}
-	return true;
-}
-
-//#endregion
-//#region packages/convert/src/spec/nodes.ts
-const BOOL_FALSE_DEFAULT = {
-	key: "",
-	type: "boolean",
-	default: false,
-	optional: true
-};
-const bool = (key) => ({
-	...BOOL_FALSE_DEFAULT,
-	key
-});
-const str = (key, def) => ({
-	key,
-	type: "string",
-	default: def,
-	optional: true
-});
-const num = (key) => ({
-	key,
-	type: "number",
-	optional: true
-});
-const int = (key) => ({
-	key,
-	type: "integer",
-	optional: true
-});
-const VANILLA_BLOCKS = [
-	{
-		name: "documentHeader",
-		group: "block",
-		wire: "special",
-		doc: "Holds the title; hoisted to frontmatter on serialise."
-	},
-	{
-		name: "documentMeta",
-		group: "block",
-		wire: "special",
-		doc: "Holds page-level meta; serialised into frontmatter."
-	},
-	{
-		name: "paragraph",
-		group: "block",
-		wire: "vanilla",
-		contentBearing: true
-	},
-	{
-		name: "heading",
-		group: "block",
-		wire: "vanilla",
-		attrs: [int("level")],
-		contentBearing: true
-	},
-	{
-		name: "blockquote",
-		group: "block",
-		wire: "vanilla",
-		contentBearing: true
-	},
-	{
-		name: "codeBlock",
-		group: "block",
-		wire: "fence",
-		attrs: [str("language", "")]
-	},
-	{
-		name: "bulletList",
-		group: "block",
-		wire: "vanilla"
-	},
-	{
-		name: "orderedList",
-		group: "block",
-		wire: "vanilla"
-	},
-	{
-		name: "listItem",
-		group: "block",
-		wire: "vanilla",
-		contentBearing: true
-	},
-	{
-		name: "taskList",
-		group: "block",
-		wire: "vanilla"
-	},
-	{
-		name: "taskItem",
-		group: "block",
-		wire: "vanilla",
-		attrs: [bool("checked")],
-		contentBearing: true
-	},
-	{
-		name: "table",
-		group: "block",
-		wire: "vanilla"
-	},
-	{
-		name: "tableRow",
-		group: "block",
-		wire: "vanilla"
-	},
-	{
-		name: "tableHeader",
-		group: "block",
-		wire: "vanilla",
-		contentBearing: true
-	},
-	{
-		name: "tableCell",
-		group: "block",
-		wire: "vanilla",
-		contentBearing: true
-	},
-	{
-		name: "horizontalRule",
-		group: "block",
-		wire: "vanilla"
-	},
-	{
-		name: "image",
-		group: "block",
-		wire: "special",
-		attrs: [
-			str("src"),
-			str("alt", ""),
-			int("width"),
-			int("height")
-		]
-	},
-	{
-		name: "hardBreak",
-		group: "inline",
-		wire: "vanilla"
+		const paraLines = [];
+		while (i < lines.length && lines[i].trim() !== "" && !/^(#{1,6}\s|[-*+]\s|\d+\.\s|>|`{3,}|\s*\||[-*_]{3,}\s*$|\s*:{2,}\w)/.test(lines[i])) {
+			paraLines.push(lines[i]);
+			i++;
+		}
+		if (paraLines.length) blocks.push({
+			type: "paragraph",
+			text: paraLines.join(" ")
+		});
+		else {
+			blocks.push({
+				type: "paragraph",
+				text: line
+			});
+			i++;
+		}
 	}
-];
-const MDC_CONTAINERS = [
-	{
-		name: "callout",
-		group: "block",
-		wire: "mdc-container",
-		attrs: [
-			{
-				key: "type",
-				type: "string",
-				default: "note",
-				optional: true,
-				values: [
-					"note",
-					"tip",
-					"warning",
-					"danger",
-					"info",
-					"caution",
-					"alert",
-					"success",
-					"error"
-				]
-			},
-			str("title"),
-			str("icon")
-		]
-	},
-	{
-		name: "collapsible",
-		group: "block",
-		wire: "mdc-container",
-		attrs: [str("label", "Details"), bool("open")]
-	},
-	{
-		name: "accordion",
-		group: "block",
-		wire: "mdc-slotted",
-		slotChild: "accordionItem"
-	},
-	{
-		name: "accordionItem",
-		group: "block",
-		wire: "mdc-container",
-		mdcTag: "accordion-item",
-		attrs: [str("label", "Item"), str("icon")]
-	},
-	{
-		name: "tabs",
-		group: "block",
-		wire: "mdc-slotted",
-		slotChild: "tabsItem"
-	},
-	{
-		name: "tabsItem",
-		group: "block",
-		wire: "mdc-container",
-		mdcTag: "tabs-item",
-		attrs: [str("label"), str("icon")]
-	},
-	{
-		name: "steps",
-		group: "block",
-		wire: "mdc-container"
-	},
-	{
-		name: "card",
-		group: "block",
-		wire: "mdc-container",
-		attrs: [
-			str("title"),
-			str("icon"),
-			str("to")
-		]
-	},
-	{
-		name: "cardGroup",
-		group: "block",
-		wire: "mdc-slotted",
-		mdcTag: "card-group",
-		slotChild: "card"
-	},
-	{
-		name: "field",
-		group: "block",
-		wire: "mdc-container",
-		attrs: [
-			str("name"),
-			str("type", "string"),
-			bool("required")
-		]
-	},
-	{
-		name: "fieldGroup",
-		group: "block",
-		wire: "mdc-slotted",
-		mdcTag: "field-group",
-		slotChild: "field"
-	},
-	{
-		name: "codeGroup",
-		group: "block",
-		wire: "mdc-slotted",
-		mdcTag: "code-group",
-		slotChild: "codeBlock"
-	},
-	{
-		name: "codeCollapse",
-		group: "block",
-		wire: "mdc-container",
-		mdcTag: "code-collapse"
-	},
-	{
-		name: "codePreview",
-		group: "block",
-		wire: "mdc-container",
-		mdcTag: "code-preview"
-	},
-	{
-		name: "codeTree",
-		group: "block",
-		wire: "mdc-atom-block",
-		mdcTag: "code-tree",
-		attrs: [{
-			key: "files",
-			type: "json"
-		}]
-	},
-	{
-		name: "figure",
-		group: "block",
-		wire: "mdc-container",
-		attrs: [
-			str("src"),
-			str("alt", ""),
-			str("caption")
-		]
-	},
-	{
-		name: "video",
-		group: "block",
-		wire: "mdc-atom-block",
-		attrs: [
-			str("src"),
-			str("poster"),
-			bool("autoplay"),
-			bool("loop"),
-			bool("controls")
-		]
-	},
-	{
-		name: "embed",
-		group: "block",
-		wire: "mdc-atom-block",
-		attrs: [str("src"), str("title")]
-	},
-	{
-		name: "svgEmbed",
-		group: "block",
-		wire: "fence",
-		attrs: [str("title")],
-		mdcTag: "svg",
-		doc: "Serialised as a ```svg fenced block; the SVG markup is the body."
-	},
-	{
-		name: "divider",
-		group: "block",
-		wire: "mdc-atom-block",
-		attrs: [str("label"), str("icon")]
-	},
-	{
-		name: "quote",
-		group: "block",
-		wire: "mdc-container",
-		attrs: [str("cite")]
-	},
-	{
-		name: "progress",
-		group: "block",
-		wire: "mdc-atom-block",
-		attrs: [
-			num("value"),
-			num("max"),
-			str("label")
-		]
-	},
-	{
-		name: "spoiler",
-		group: "block",
-		wire: "mdc-container",
-		attrs: [str("label")]
-	},
-	{
-		name: "colorSwatch",
-		group: "block",
-		wire: "mdc-atom-block",
-		mdcTag: "color-swatch",
-		attrs: [str("color"), str("label")]
-	},
-	{
-		name: "stat",
-		group: "block",
-		wire: "mdc-container",
-		attrs: [
-			str("label"),
-			str("value"),
-			str("icon")
-		]
-	},
-	{
-		name: "statGroup",
-		group: "block",
-		wire: "mdc-slotted",
-		mdcTag: "stat-group",
-		slotChild: "stat"
-	},
-	{
-		name: "button",
-		group: "block",
-		wire: "mdc-atom-block",
-		attrs: [
-			str("label"),
-			str("to"),
-			str("icon"),
-			str("variant")
-		]
-	},
+	return blocks;
+}
+/**
+* Insert formatted inline tokens into an already-attached Y.XmlElement.
+* Creates one Y.XmlText per token (attach first, fill second).
+*/
+function fillTextInto(el, tokens) {
+	const filtered = tokens.filter((t) => t.text.length > 0);
+	if (!filtered.length) return;
+	const children = filtered.map((tok) => {
+		return (tok.attrs?.docLink)?.docId ? new yjs.XmlElement("docLink") : new yjs.XmlText();
+	});
+	el.insert(0, children);
+	filtered.forEach((tok, i) => {
+		const node = children[i];
+		if (node instanceof yjs.XmlElement) {
+			const dl = tok.attrs.docLink;
+			node.setAttribute("docId", dl.docId);
+			return;
+		}
+		if (tok.attrs) node.insert(0, tok.text, tok.attrs);
+		else node.insert(0, tok.text);
+	});
+}
+function blockElName(b) {
+	switch (b.type) {
+		case "heading": return "heading";
+		case "paragraph": return "paragraph";
+		case "bulletList": return "bulletList";
+		case "orderedList": return "orderedList";
+		case "taskList": return "taskList";
+		case "codeBlock": return "codeBlock";
+		case "blockquote": return "blockquote";
+		case "table": return "table";
+		case "hr": return "horizontalRule";
+		case "callout": return "callout";
+		case "collapsible": return "collapsible";
+		case "steps": return "steps";
+		case "card": return "card";
+		case "cardGroup": return "cardGroup";
+		case "codeCollapse": return "codeCollapse";
+		case "codeGroup": return "codeGroup";
+		case "codePreview": return "codePreview";
+		case "codeTree": return "codeTree";
+		case "accordion": return "accordion";
+		case "tabs": return "tabs";
+		case "field": return "field";
+		case "fieldGroup": return "fieldGroup";
+		case "image": return "image";
+		case "docEmbed": return "docEmbed";
+		case "mathBlock": return "mathBlock";
+		case "fileBlock": return "fileBlock";
+	}
+}
+function populateListItemChildren(itemEl, item, _itemKind) {
+	const paraEl = new yjs.XmlElement("paragraph");
+	itemEl.insert(itemEl.length, [paraEl]);
+	fillTextInto(paraEl, parseInline(item.text));
+	if (!item.innerBlocks?.length) return;
+	const innerEls = item.innerBlocks.map((b) => new yjs.XmlElement(blockElName(b)));
+	itemEl.insert(itemEl.length, innerEls);
+	item.innerBlocks.forEach((b, i) => fillBlock(innerEls[i], b));
+}
+function fillBlock(el, block) {
+	switch (block.type) {
+		case "heading":
+			el.setAttribute("level", block.level);
+			fillTextInto(el, parseInline(block.text));
+			break;
+		case "paragraph":
+			fillTextInto(el, parseInline(block.text));
+			break;
+		case "bulletList":
+		case "orderedList": {
+			const listItemEls = block.items.map(() => new yjs.XmlElement("listItem"));
+			el.insert(0, listItemEls);
+			block.items.forEach((item, i) => {
+				populateListItemChildren(listItemEls[i], item, "listItem");
+			});
+			break;
+		}
+		case "taskList": {
+			const taskItemEls = block.items.map(() => new yjs.XmlElement("taskItem"));
+			el.insert(0, taskItemEls);
+			block.items.forEach((item, i) => {
+				taskItemEls[i].setAttribute("checked", !!item.checked);
+				populateListItemChildren(taskItemEls[i], item, "taskItem");
+			});
+			break;
+		}
+		case "codeBlock": {
+			if (block.lang) el.setAttribute("language", block.lang);
+			const xt = new yjs.XmlText();
+			el.insert(0, [xt]);
+			xt.insert(0, block.code);
+			break;
+		}
+		case "blockquote": {
+			const paraEls = block.lines.map(() => new yjs.XmlElement("paragraph"));
+			el.insert(0, paraEls);
+			block.lines.forEach((line, i) => fillTextInto(paraEls[i], parseInline(line)));
+			break;
+		}
+		case "table": {
+			const headerRowEl = new yjs.XmlElement("tableRow");
+			const dataRowEls = block.dataRows.map(() => new yjs.XmlElement("tableRow"));
+			el.insert(0, [headerRowEl, ...dataRowEls]);
+			const headerCellEls = block.headerRow.map(() => new yjs.XmlElement("tableHeader"));
+			headerRowEl.insert(0, headerCellEls);
+			block.headerRow.forEach((cellText, i) => {
+				const paraEl = new yjs.XmlElement("paragraph");
+				headerCellEls[i].insert(0, [paraEl]);
+				fillTextInto(paraEl, parseInline(cellText));
+			});
+			block.dataRows.forEach((row, ri) => {
+				const cellEls = row.map(() => new yjs.XmlElement("tableCell"));
+				dataRowEls[ri].insert(0, cellEls);
+				row.forEach((cellText, ci) => {
+					const paraEl = new yjs.XmlElement("paragraph");
+					cellEls[ci].insert(0, [paraEl]);
+					fillTextInto(paraEl, parseInline(cellText));
+				});
+			});
+			break;
+		}
+		case "hr": break;
+		case "callout": {
+			el.setAttribute("type", block.calloutType);
+			if (!block.innerBlocks.length) {
+				const paraEl = new yjs.XmlElement("paragraph");
+				el.insert(0, [paraEl]);
+				break;
+			}
+			const innerEls = block.innerBlocks.map((b) => new yjs.XmlElement(blockElName(b)));
+			el.insert(0, innerEls);
+			block.innerBlocks.forEach((b, i) => fillBlock(innerEls[i], b));
+			break;
+		}
+		case "collapsible": {
+			el.setAttribute("label", block.label);
+			el.setAttribute("open", block.open);
+			const inner = block.innerBlocks.length ? block.innerBlocks : [{
+				type: "paragraph",
+				text: ""
+			}];
+			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
+			el.insert(0, innerEls);
+			inner.forEach((b, i) => fillBlock(innerEls[i], b));
+			break;
+		}
+		case "steps": {
+			const inner = block.innerBlocks.length ? block.innerBlocks : [{
+				type: "paragraph",
+				text: ""
+			}];
+			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
+			el.insert(0, innerEls);
+			inner.forEach((b, i) => fillBlock(innerEls[i], b));
+			break;
+		}
+		case "card": {
+			if (block.title) el.setAttribute("title", block.title);
+			if (block.icon) el.setAttribute("icon", block.icon);
+			if (block.to) el.setAttribute("to", block.to);
+			const inner = block.innerBlocks.length ? block.innerBlocks : [{
+				type: "paragraph",
+				text: ""
+			}];
+			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
+			el.insert(0, innerEls);
+			inner.forEach((b, i) => fillBlock(innerEls[i], b));
+			break;
+		}
+		case "cardGroup": {
+			const cardEls = block.cards.map((b) => new yjs.XmlElement(blockElName(b)));
+			el.insert(0, cardEls);
+			block.cards.forEach((b, i) => fillBlock(cardEls[i], b));
+			break;
+		}
+		case "codeCollapse": {
+			const codes = block.codeBlocks.length ? block.codeBlocks : [{
+				type: "codeBlock",
+				lang: "",
+				code: ""
+			}];
+			const codeEl = new yjs.XmlElement("codeBlock");
+			el.insert(0, [codeEl]);
+			fillBlock(codeEl, codes[0]);
+			break;
+		}
+		case "codeGroup": {
+			const codes = block.codeBlocks.length ? block.codeBlocks : [{
+				type: "codeBlock",
+				lang: "",
+				code: ""
+			}];
+			const codeEls = codes.map(() => new yjs.XmlElement("codeBlock"));
+			el.insert(0, codeEls);
+			codes.forEach((b, i) => fillBlock(codeEls[i], b));
+			break;
+		}
+		case "codePreview": {
+			const all = [...block.innerBlocks, ...block.codeBlocks];
+			const inner = all.length ? all : [{
+				type: "paragraph",
+				text: ""
+			}];
+			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
+			el.insert(0, innerEls);
+			inner.forEach((b, i) => fillBlock(innerEls[i], b));
+			break;
+		}
+		case "codeTree":
+			el.setAttribute("files", block.files);
+			break;
+		case "accordion": {
+			const itemEls = block.items.map(() => new yjs.XmlElement("accordionItem"));
+			el.insert(0, itemEls);
+			block.items.forEach((item, i) => {
+				itemEls[i].setAttribute("label", item.label);
+				if (item.icon) itemEls[i].setAttribute("icon", item.icon);
+				const inner = item.innerBlocks.length ? item.innerBlocks : [{
+					type: "paragraph",
+					text: ""
+				}];
+				const childEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
+				itemEls[i].insert(0, childEls);
+				inner.forEach((b, ci) => fillBlock(childEls[ci], b));
+			});
+			break;
+		}
+		case "tabs": {
+			const itemEls = block.items.map(() => new yjs.XmlElement("tabsItem"));
+			el.insert(0, itemEls);
+			block.items.forEach((item, i) => {
+				itemEls[i].setAttribute("label", item.label);
+				if (item.icon) itemEls[i].setAttribute("icon", item.icon);
+				const inner = item.innerBlocks.length ? item.innerBlocks : [{
+					type: "paragraph",
+					text: ""
+				}];
+				const childEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
+				itemEls[i].insert(0, childEls);
+				inner.forEach((b, ci) => fillBlock(childEls[ci], b));
+			});
+			break;
+		}
+		case "field": {
+			if (block.name) el.setAttribute("name", block.name);
+			el.setAttribute("type", block.fieldType);
+			el.setAttribute("required", block.required);
+			const inner = block.innerBlocks.length ? block.innerBlocks : [{
+				type: "paragraph",
+				text: ""
+			}];
+			const innerEls = inner.map((b) => new yjs.XmlElement(blockElName(b)));
+			el.insert(0, innerEls);
+			inner.forEach((b, i) => fillBlock(innerEls[i], b));
+			break;
+		}
+		case "fieldGroup": {
+			const fieldEls = block.fields.map((b) => new yjs.XmlElement(blockElName(b)));
+			el.insert(0, fieldEls);
+			block.fields.forEach((b, i) => fillBlock(fieldEls[i], b));
+			break;
+		}
+		case "image":
+			el.setAttribute("src", block.src);
+			if (block.alt) el.setAttribute("alt", block.alt);
+			if (block.width) el.setAttribute("width", block.width);
+			if (block.height) el.setAttribute("height", block.height);
+			break;
+		case "docEmbed":
+			el.setAttribute("docId", block.docId);
+			for (const flag of [
+				"collapsed",
+				"tall",
+				"seamless"
+			]) if (block.props[flag] === "true" || block.props[flag] === "1") el.setAttribute(flag, true);
+			break;
+		case "mathBlock":
+			el.setAttribute("expression", block.expression);
+			break;
+		case "fileBlock":
+			if (block.src) el.setAttribute("src", block.src);
+			if (block.mime) el.setAttribute("mime", block.mime);
+			if (block.uploadId) el.setAttribute("uploadId", block.uploadId);
+			if (block.filename) el.setAttribute("filename", block.filename);
+			break;
+	}
+}
+/**
+* Parses markdown text and writes the result into a Y.XmlFragment that
+* TipTap's Collaboration extension can read.
+*
+* Requires `fragment.doc` to be set (i.e. the fragment must already be
+* obtained from a live Y.Doc via `ydoc.getXmlFragment('default')`).
+*
+* @param fragment      The target `Y.Doc.getXmlFragment('default')`
+* @param markdown      Raw markdown string
+* @param fallbackTitle Used as the title when the markdown has no H1
+*/
+function populateYDocFromMarkdown(fragment, markdown, fallbackTitle = "Untitled") {
+	const ydoc = fragment.doc;
+	if (!ydoc) {
+		console.warn("[markdownToYjs] fragment has no doc — skipping population");
+		return;
+	}
+	const fm = parseFrontmatter(markdown);
+	const blocks = parseBlocks(fm.body);
+	let title = fallbackTitle;
+	let titleSource;
+	if (fm.title !== void 0) {
+		title = fm.title;
+		titleSource = "frontmatter";
+	}
+	let contentBlocks = blocks;
+	const h1 = blocks.findIndex((b) => b.type === "heading" && b.level === 1);
+	if (h1 !== -1) {
+		title = blocks[h1].text;
+		contentBlocks = blocks.filter((_, i) => i !== h1);
+		titleSource = "h1";
+	}
+	ydoc.transact(() => {
+		const headerEl = new yjs.XmlElement("documentHeader");
+		const metaEl = new yjs.XmlElement("documentMeta");
+		const bodyEls = contentBlocks.map((b) => {
+			switch (b.type) {
+				case "heading": return new yjs.XmlElement("heading");
+				case "paragraph": return new yjs.XmlElement("paragraph");
+				case "bulletList": return new yjs.XmlElement("bulletList");
+				case "orderedList": return new yjs.XmlElement("orderedList");
+				case "taskList": return new yjs.XmlElement("taskList");
+				case "codeBlock": return new yjs.XmlElement("codeBlock");
+				case "blockquote": return new yjs.XmlElement("blockquote");
+				case "table": return new yjs.XmlElement("table");
+				case "hr": return new yjs.XmlElement("horizontalRule");
+				case "callout": return new yjs.XmlElement("callout");
+				case "collapsible": return new yjs.XmlElement("collapsible");
+				case "steps": return new yjs.XmlElement("steps");
+				case "card": return new yjs.XmlElement("card");
+				case "cardGroup": return new yjs.XmlElement("cardGroup");
+				case "codeCollapse": return new yjs.XmlElement("codeCollapse");
+				case "codeGroup": return new yjs.XmlElement("codeGroup");
+				case "codePreview": return new yjs.XmlElement("codePreview");
+				case "codeTree": return new yjs.XmlElement("codeTree");
+				case "accordion": return new yjs.XmlElement("accordion");
+				case "tabs": return new yjs.XmlElement("tabs");
+				case "field": return new yjs.XmlElement("field");
+				case "fieldGroup": return new yjs.XmlElement("fieldGroup");
+				case "image": return new yjs.XmlElement("image");
+				case "docEmbed": return new yjs.XmlElement("docEmbed");
+				case "mathBlock": return new yjs.XmlElement("mathBlock");
+				case "fileBlock": return new yjs.XmlElement("fileBlock");
+			}
+		});
+		fragment.insert(0, [
+			headerEl,
+			metaEl,
+			...bodyEls
+		]);
+		if (titleSource) headerEl.setAttribute("titleSource", titleSource);
+		const headerXt = new yjs.XmlText();
+		headerEl.insert(0, [headerXt]);
+		headerXt.insert(0, title);
+		for (const k of Object.keys(fm.meta)) {
+			const v = fm.meta[k];
+			if (v === void 0 || v === null) continue;
+			metaEl.setAttribute(k, v);
+		}
+		if (fm.type) metaEl.setAttribute("type", fm.type);
+		contentBlocks.forEach((block, i) => fillBlock(bodyEls[i], block));
+	});
+}
+
+//#endregion
+//#region packages/convert/src/yjs-to-markdown.ts
+function isXElem(n) {
+	return !!n && typeof n.nodeName === "string";
+}
+function isXText(n) {
+	return !!n && typeof n.nodeName !== "string" && typeof n.toDelta === "function";
+}
+function localizeFragment(fragment) {
+	return fragment;
+}
+function serializeDelta(delta) {
+	let result = "";
+	for (const op of delta) {
+		if (typeof op.insert !== "string") continue;
+		let text = op.insert;
+		const attrs = op.attributes ?? {};
+		if (attrs.code) {
+			result += `\`${text}\``;
+			continue;
+		}
+		if (attrs.badge) {
+			const b = attrs.badge;
+			const props = [];
+			if (b.color && b.color !== "neutral") props.push(`color="${b.color}"`);
+			if (b.variant && b.variant !== "subtle") props.push(`variant="${b.variant}"`);
+			result += `:badge[${b.label || text}]${props.length ? `{${props.join(" ")}}` : ""}`;
+			continue;
+		}
+		if (attrs.proseIcon) {
+			const icon = attrs.proseIcon.name || "i-lucide-star";
+			result += `:icon{name="${icon}"}`;
+			continue;
+		}
+		if (attrs.kbd) {
+			const value = attrs.kbd.value || text;
+			result += `:kbd{value="${value}"}`;
+			continue;
+		}
+		if (attrs.docLink) {
+			const docId = attrs.docLink.docId;
+			if (docId) {
+				result += text === docId ? `[[${docId}]]` : `[[${docId}|${text}]]`;
+				continue;
+			}
+		}
+		if (attrs.mention) {
+			const { userId, label } = attrs.mention;
+			if (userId) {
+				result += `@[${label || text}](user:${userId})`;
+				continue;
+			}
+		}
+		if (attrs.mathInline) {
+			const expr = attrs.mathInline.expression ?? text;
+			result += `$${expr}$`;
+			continue;
+		}
+		if (attrs.bold) text = `**${text}**`;
+		if (attrs.italic) text = `*${text}*`;
+		if (attrs.strike) text = `~~${text}~~`;
+		if (attrs.link) {
+			const href = attrs.link.href ?? "";
+			text = `[${text}](${href})`;
+		}
+		result += text;
+	}
+	return result;
+}
+function serializeInline(el) {
+	const parts = [];
+	for (const child of el.toArray()) if (isXText(child)) parts.push(serializeDelta(child.toDelta()));
+	else if (isXElem(child)) if (child.nodeName === "docLink") {
+		const docId = child.getAttribute("docId") ?? "";
+		parts.push(`[[${docId}]]`);
+	} else parts.push(serializeInline(child));
+	return parts.join("");
+}
+function serializeBlock(el, indent = "") {
+	if (isXText(el)) return serializeDelta(el.toDelta());
+	switch (el.nodeName) {
+		case "documentHeader":
+		case "documentMeta": return "";
+		case "heading": {
+			const level = Number(el.getAttribute("level") ?? 2);
+			return `${"#".repeat(level)} ${serializeInline(el)}`;
+		}
+		case "paragraph": return serializeInline(el);
+		case "bulletList": return serializeListItems(el, "bullet", indent);
+		case "orderedList": return serializeListItems(el, "ordered", indent);
+		case "taskList": return serializeTaskList(el, indent);
+		case "codeBlock": {
+			const lang = el.getAttribute("language") ?? "";
+			const code = getCodeBlockText(el);
+			if (code === "") return `\`\`\`${lang}\n\`\`\``;
+			return `\`\`\`${lang}\n${code}\n\`\`\``;
+		}
+		case "blockquote": {
+			const lines = [];
+			for (const child of el.toArray()) if (isXElem(child)) {
+				const text = serializeBlock(child);
+				for (const line of text.split("\n")) lines.push(`> ${line}`);
+			}
+			return lines.join("\n");
+		}
+		case "table": return serializeTable(el);
+		case "horizontalRule": return "---";
+		case "image": {
+			const src = el.getAttribute("src") ?? "";
+			const alt = el.getAttribute("alt") ?? "";
+			const width = el.getAttribute("width");
+			const height = el.getAttribute("height");
+			const attrs = [];
+			if (width) attrs.push(`width=${width}`);
+			if (height) attrs.push(`height=${height}`);
+			return `![${alt}](${src})${attrs.length ? `{${attrs.join(" ")}}` : ""}`;
+		}
+		case "docEmbed": {
+			const docId = el.getAttribute("docId") ?? "";
+			const collapsed = el.getAttribute("collapsed");
+			const tall = el.getAttribute("tall");
+			const seamless = el.getAttribute("seamless");
+			const flags = [];
+			if (collapsed === true || collapsed === "true") flags.push("collapsed");
+			if (tall === true || tall === "true") flags.push("tall");
+			if (seamless === true || seamless === "true") flags.push("seamless");
+			return `![[${docId}]]${flags.length ? `{${flags.join(" ")}}` : ""}`;
+		}
+		case "mathBlock": return `\`\`\`math\n${el.getAttribute("expression") ?? ""}\n\`\`\``;
+		case "fileBlock": {
+			const uploadId = el.getAttribute("uploadId") ?? "";
+			const filename = el.getAttribute("filename") ?? "";
+			const mime = el.getAttribute("mime") ?? "";
+			const src = el.getAttribute("src") ?? (uploadId && filename ? `.abracadabra/files/${uploadId}-${filename}` : "");
+			const props = [];
+			if (src) props.push(`src="${src}"`);
+			if (mime) props.push(`mime="${mime}"`);
+			if (uploadId) props.push(`upload-id="${uploadId}"`);
+			if (filename) props.push(`filename="${filename}"`);
+			return `:file{${props.join(" ")}}`;
+		}
+		case "callout": return `::${el.getAttribute("type") ?? "note"}\n${serializeChildren(el)}\n::`;
+		case "collapsible": {
+			const label = el.getAttribute("label") ?? "Details";
+			const open = el.getAttribute("open");
+			const props = [`label="${label}"`];
+			if (open === true || open === "true") props.push("open=\"true\"");
+			return `::collapsible{${props.join(" ")}}\n${serializeChildren(el)}\n::`;
+		}
+		case "steps": return `::steps\n${serializeChildren(el)}\n::`;
+		case "card": {
+			const props = [];
+			const title = el.getAttribute("title");
+			const icon = el.getAttribute("icon");
+			const to = el.getAttribute("to");
+			if (title) props.push(`title="${title}"`);
+			if (icon) props.push(`icon="${icon}"`);
+			if (to) props.push(`to="${to}"`);
+			return `::card${props.length ? `{${props.join(" ")}}` : ""}\n${serializeChildren(el)}\n::`;
+		}
+		case "cardGroup": return `::card-group\n${el.toArray().filter((c) => isXElem(c)).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "codeCollapse": return `::code-collapse\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "codeGroup": return `::code-group\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "codePreview": {
+			const children = el.toArray().filter((c) => isXElem(c));
+			const nonCode = children.filter((c) => c.nodeName !== "codeBlock").map((c) => serializeBlock(c)).join("\n\n");
+			const code = children.filter((c) => c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n");
+			const parts = [nonCode];
+			if (code) parts.push(`#code\n${code}`);
+			return `::code-preview\n${parts.filter(Boolean).join("\n\n")}\n::`;
+		}
+		case "codeTree": return `::code-tree{files="${el.getAttribute("files") ?? "[]"}"}\n::`;
+		case "accordion": return serializeSlottedContainer(el, "accordion", "accordionItem", "item");
+		case "tabs": return serializeSlottedContainer(el, "tabs", "tabsItem", "tab");
+		case "field": {
+			const fieldName = el.getAttribute("name") ?? "";
+			const fieldType = el.getAttribute("type") ?? "string";
+			const required = el.getAttribute("required");
+			const props = [`name="${fieldName}"`, `type="${fieldType}"`];
+			if (required === true || required === "true") props.push("required=\"true\"");
+			return `::field{${props.join(" ")}}\n${serializeChildren(el)}\n::`;
+		}
+		case "fieldGroup": return `::field-group\n${el.toArray().filter((c) => isXElem(c)).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		default: return serializeChildren(el);
+	}
+}
+function serializeChildren(el) {
+	const blocks = [];
+	for (const child of el.toArray()) if (isXElem(child)) {
+		const text = serializeBlock(child);
+		if (text) blocks.push(text);
+	} else if (isXText(child)) {
+		const text = serializeDelta(child.toDelta());
+		if (text) blocks.push(text);
+	}
+	return blocks.join("\n\n");
+}
+function serializeListItems(el, type, indent) {
+	const lines = [];
+	let counter = 1;
+	for (const child of el.toArray()) {
+		if (!isXElem(child) || child.nodeName !== "listItem") continue;
+		const prefix = type === "bullet" ? "- " : `${counter++}. `;
+		const subParts = [];
+		for (const sub of child.toArray()) {
+			if (!isXElem(sub)) continue;
+			if (sub.nodeName === "bulletList") subParts.push({
+				text: serializeListItems(sub, "bullet", indent + "  "),
+				isList: true
+			});
+			else if (sub.nodeName === "orderedList") subParts.push({
+				text: serializeListItems(sub, "ordered", indent + "  "),
+				isList: true
+			});
+			else subParts.push({
+				text: serializeInline(sub),
+				isList: false
+			});
+		}
+		lines.push(`${indent}${prefix}${subParts[0]?.text ?? ""}`);
+		for (let i = 1; i < subParts.length; i++) {
+			const part = subParts[i];
+			lines.push(part.isList ? part.text : `${indent}  ${part.text}`);
+		}
+	}
+	return lines.join("\n");
+}
+function serializeTaskList(el, indent) {
+	const lines = [];
+	for (const child of el.toArray()) {
+		if (!isXElem(child) || child.nodeName !== "taskItem") continue;
+		const checked = child.getAttribute("checked");
+		const marker = checked === true || checked === "true" ? "[x]" : "[ ]";
+		let header = "";
+		const nestedParts = [];
+		for (const sub of child.toArray()) {
+			if (!isXElem(sub)) continue;
+			if (sub.nodeName === "paragraph" && header === "") header = serializeInline(sub);
+			else if (sub.nodeName === "bulletList") nestedParts.push(serializeListItems(sub, "bullet", indent + "  "));
+			else if (sub.nodeName === "orderedList") nestedParts.push(serializeListItems(sub, "ordered", indent + "  "));
+			else if (sub.nodeName === "taskList") nestedParts.push(serializeTaskList(sub, indent + "  "));
+			else nestedParts.push(indent + "  " + serializeBlock(sub, indent + "  "));
+		}
+		lines.push(`${indent}- ${marker} ${header}`);
+		for (const part of nestedParts) lines.push(part);
+	}
+	return lines.join("\n");
+}
+function getCodeBlockText(el) {
+	for (const child of el.toArray()) if (isXText(child)) return child.toString();
+	return "";
+}
+function serializeTable(el) {
+	const rows = el.toArray().filter((c) => isXElem(c));
+	if (!rows.length) return "";
+	const serializedRows = [];
+	for (const row of rows) {
+		const cells = row.toArray().filter((c) => isXElem(c)).map((cell) => {
+			return cell.toArray().filter((c) => isXElem(c)).map((c) => serializeInline(c)).join(" ");
+		});
+		serializedRows.push(cells);
+	}
+	if (!serializedRows.length) return "";
+	const colCount = Math.max(...serializedRows.map((r) => r.length));
+	const headerRow = serializedRows[0];
+	const separator = Array(colCount).fill("---");
+	const dataRows = serializedRows.slice(1);
+	const formatRow = (cells) => {
+		return `| ${Array(colCount).fill("").map((_, i) => cells[i] ?? "").join(" | ")} |`;
+	};
+	return [
+		formatRow(headerRow),
+		formatRow(separator),
+		...dataRows.map(formatRow)
+	].join("\n");
+}
+function serializeSlottedContainer(el, containerName, childName, slotPrefix) {
+	return `::${containerName}\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === childName).map((item) => {
+		const label = item.getAttribute("label") ?? "";
+		const icon = item.getAttribute("icon") ?? "";
+		const props = [];
+		if (label) props.push(`label="${label}"`);
+		if (icon) props.push(`icon="${icon}"`);
+		const content = serializeChildren(item);
+		return `#${slotPrefix}{${props.join(" ")}}\n${content}`;
+	}).join("\n\n")}\n::`;
+}
+/**
+* Keys the hand-rolled canonical section below emits itself. The generic
+* spec-driven pass must skip these so each key is serialised exactly once,
+* in the canonical order existing fixtures depend on.
+*/
+const CANONICAL_FM_KEYS = new Set([
+	"title",
+	"type",
+	"tags",
+	"color",
+	"icon",
+	"status",
+	"priority",
+	"checked",
+	"language",
+	"fileExtension",
+	"codeTheme",
+	"dateStart",
+	"dateEnd",
+	"subtitle",
+	"url",
+	"rating"
+]);
+/** Render one meta value as a YAML line, or null when it can't be emitted. */
+function yamlLine(key, v, specType) {
+	if (v === void 0 || v === null) return null;
+	if (Array.isArray(v)) {
+		if (v.length === 0) return null;
+		return `${key}: [${v.map((x) => String(x)).join(", ")}]`;
+	}
+	if (typeof v === "number") return Number.isFinite(v) ? `${key}: ${v}` : null;
+	if (typeof v === "boolean") return `${key}: ${v}`;
+	if (typeof v === "string") return v === "" ? null : `${key}: ${yamlScalar(v)}`;
+	if (specType === "members" || specType === "json" || typeof v === "object") try {
+		const json = JSON.stringify(v);
+		return json.includes("'") ? null : `${key}: '${json}'`;
+	} catch {
+		return null;
+	}
+	return null;
+}
+/**
+* Generate the YAML frontmatter block. Returns '' when there is nothing to
+* emit, so callers can skip the block entirely — an empty `---\n\n---` shell
+* is never produced (docs whose meta holds only internal `_`-keys used to
+* export as exactly that junk).
+*
+* Emission order: the long-standing hand-rolled canonical keys first (byte
+* stability for existing files), then every remaining universal-meta key in
+* registry order, then custom keys alphabetically. Internal keys (leading
+* `_`, e.g. `_metaInitialized`) are never serialised.
+*/
+function generateFrontmatter(label, meta, type) {
+	const lines = [];
+	if (label !== void 0) lines.push(`title: "${escapeYaml(label)}"`);
+	if (type && type !== "doc") lines.push(`type: ${type}`);
+	if (meta) {
+		if (meta.tags?.length) lines.push(`tags: [${meta.tags.join(", ")}]`);
+		if (meta.color) lines.push(`color: ${yamlScalar(meta.color)}`);
+		if (meta.icon) lines.push(`icon: ${yamlScalar(meta.icon)}`);
+		if (meta.status) lines.push(`status: ${yamlScalar(meta.status)}`);
+		if (meta.priority !== void 0 && meta.priority !== 0) lines.push(`priority: ${{
+			1: "low",
+			2: "medium",
+			3: "high",
+			4: "urgent"
+		}[meta.priority] ?? meta.priority}`);
+		if (meta.checked !== void 0) lines.push(`checked: ${meta.checked}`);
+		if (meta.language) lines.push(`language: ${yamlScalar(meta.language)}`);
+		if (meta.fileExtension) lines.push(`fileExtension: ${yamlScalar(meta.fileExtension)}`);
+		if (meta.codeTheme) lines.push(`codeTheme: ${yamlScalar(meta.codeTheme)}`);
+		if (meta.dateStart) lines.push(`dateStart: "${escapeYaml(meta.dateStart)}"`);
+		if (meta.dateEnd) lines.push(`dateEnd: "${escapeYaml(meta.dateEnd)}"`);
+		if (meta.subtitle) lines.push(`subtitle: "${escapeYaml(meta.subtitle)}"`);
+		if (meta.url) lines.push(`url: ${meta.url}`);
+		if (meta.rating !== void 0 && meta.rating !== 0) lines.push(`rating: ${meta.rating}`);
+		const m = meta;
+		for (const spec of UNIVERSAL_META_KEYS) {
+			if (CANONICAL_FM_KEYS.has(spec.key)) continue;
+			const line = yamlLine(spec.key, m[spec.key], spec.type);
+			if (line) lines.push(line);
+		}
+		const customKeys = Object.keys(m).filter((k) => !k.startsWith("_") && !CANONICAL_FM_KEYS.has(k) && !UNIVERSAL_META_KEY_NAMES.has(k)).sort();
+		for (const k of customKeys) {
+			const line = yamlLine(k, m[k]);
+			if (line) lines.push(line);
+		}
+	}
+	if (lines.length === 0) return "";
+	return `---\n${lines.join("\n")}\n---`;
+}
+/**
+* Render a YAML scalar — bare when safe, double-quoted when the value
+* needs escaping. YAML treats `#`, `:`, leading whitespace, and a few
+* other characters as syntactically significant, so anything starting
+* with one of those gets quoted to stay round-trip safe.
+*/
+function yamlScalar(s) {
+	if (s === "") return "\"\"";
+	if (/^[#&*!|>%@`]/.test(s)) return `"${escapeYaml(s)}"`;
+	if (/[:"]/.test(s)) return `"${escapeYaml(s)}"`;
+	if (/^\s|\s$/.test(s)) return `"${escapeYaml(s)}"`;
+	return s;
+}
+function escapeYaml(s) {
+	return s.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+function yjsToMarkdown(fragment, label, meta, type) {
+	fragment = localizeFragment(fragment);
+	const { text: headerText, source: titleSource } = readDocumentHeader(fragment);
+	const effectiveTitle = headerText || label;
+	const docMeta = readDocumentMeta(fragment);
+	const effectiveMeta = meta ?? docMeta.meta;
+	const effectiveType = type ?? docMeta.type;
+	const bodyBlocks = collectBodyBlocks(fragment);
+	let body;
+	if (titleSource === "h1" && effectiveTitle) {
+		const tail = serializeBlocksClean(bodyBlocks);
+		body = tail === "" ? `# ${effectiveTitle}` : `# ${effectiveTitle}\n\n${tail}`;
+	} else body = serializeBlocksClean(bodyBlocks);
+	const frontmatter = generateFrontmatter(titleSource === "frontmatter" ? effectiveTitle : void 0, effectiveMeta, effectiveType);
+	if (frontmatter === "") return body === "" ? "" : `${body}\n`;
+	if (body === "") return `${frontmatter}\n`;
+	return `${frontmatter}\n\n${body}\n`;
+}
+function readDocumentMeta(fragment) {
+	const meta = {};
+	let type;
+	for (const child of fragment.toArray()) {
+		if (!isXElem(child) || child.nodeName !== "documentMeta") continue;
+		const attrs = child.getAttributes();
+		for (const k of Object.keys(attrs)) {
+			const v = attrs[k];
+			if (v === void 0 || v === null) continue;
+			if (k === "type" && typeof v === "string") {
+				type = v;
+				continue;
+			}
+			meta[k] = v;
+		}
+		break;
+	}
+	return {
+		meta,
+		type
+	};
+}
+function readDocumentHeader(fragment) {
+	for (const child of fragment.toArray()) {
+		if (!isXElem(child) || child.nodeName !== "documentHeader") continue;
+		const text = child.toArray().find((c) => isXText(c));
+		const src = child.getAttribute("titleSource");
+		const source = src === "h1" || src === "frontmatter" ? src : void 0;
+		return {
+			text: text ? text.toString() : "",
+			source
+		};
+	}
+	return { text: "" };
+}
+function collectBodyBlocks(fragment) {
+	const out = [];
+	for (const child of fragment.toArray()) {
+		if (!isXElem(child)) continue;
+		if (child.nodeName === "documentHeader" || child.nodeName === "documentMeta") continue;
+		out.push(child);
+	}
+	return out;
+}
+function serializeBlocksClean(blocks) {
+	const parts = [];
+	for (const block of blocks) {
+		if (block.nodeName === "paragraph" && block.length === 0) {
+			parts.push("");
+			continue;
+		}
+		parts.push(serializeBlock(block));
+	}
+	while (parts.length && parts[parts.length - 1] === "") parts.pop();
+	return parts.join("\n\n");
+}
+
+//#endregion
+//#region packages/convert/src/spec/nodes.ts
+const BOOL_FALSE_DEFAULT = {
+	key: "",
+	type: "boolean",
+	default: false,
+	optional: true
+};
+const bool = (key) => ({
+	...BOOL_FALSE_DEFAULT,
+	key
+});
+const str = (key, def) => ({
+	key,
+	type: "string",
+	default: def,
+	optional: true
+});
+const num = (key) => ({
+	key,
+	type: "number",
+	optional: true
+});
+const int = (key) => ({
+	key,
+	type: "integer",
+	optional: true
+});
+const VANILLA_BLOCKS = [
 	{
-		name: "buttonGroup",
+		name: "documentHeader",
 		group: "block",
-		wire: "mdc-slotted",
-		mdcTag: "button-group",
-		slotChild: "button"
+		wire: "special",
+		doc: "Holds the title; hoisted to frontmatter on serialise."
 	},
 	{
-		name: "timeline",
+		name: "documentMeta",
 		group: "block",
-		wire: "mdc-slotted",
-		slotChild: "timelineItem"
+		wire: "special",
+		doc: "Holds page-level meta; serialised into frontmatter."
 	},
 	{
-		name: "timelineItem",
+		name: "paragraph",
 		group: "block",
-		wire: "mdc-container",
-		mdcTag: "timeline-item",
-		attrs: [
-			str("label"),
-			str("icon"),
-			str("date")
-		]
+		wire: "vanilla",
+		contentBearing: true
 	},
 	{
-		name: "diff",
+		name: "heading",
 		group: "block",
-		wire: "mdc-atom-block",
-		attrs: [str("language", ""), {
-			key: "value",
-			type: "string"
-		}]
-	}
-];
-const INLINE_AND_SPECIAL = [
-	{
-		name: "docLink",
-		group: "inline",
-		wire: "special",
-		attrs: [str("docId")],
-		doc: "Wire form `[[uuid|label]]`; label regenerated on export."
+		wire: "vanilla",
+		attrs: [int("level")],
+		contentBearing: true
 	},
 	{
-		name: "docEmbed",
+		name: "blockquote",
 		group: "block",
-		wire: "special",
-		attrs: [
-			str("docId"),
-			bool("collapsed"),
-			bool("tall"),
-			bool("seamless")
-		],
-		doc: "Wire form `![[uuid|label]]{collapsed tall seamless}`."
-	},
-	{
-		name: "mention",
-		group: "inline",
-		wire: "special",
-		attrs: [str("userId")],
-		doc: "Wire form `@[label](user:uuid)`; label regenerated on export."
-	},
-	{
-		name: "mathInline",
-		group: "inline",
-		wire: "special",
-		attrs: [{
-			key: "expression",
-			type: "string"
-		}],
-		doc: "Wire form `$expression$`."
+		wire: "vanilla",
+		contentBearing: true
 	},
 	{
-		name: "mathBlock",
+		name: "codeBlock",
 		group: "block",
 		wire: "fence",
-		attrs: [{
-			key: "expression",
-			type: "string"
-		}],
-		mdcTag: "math",
-		doc: "Wire form ``` ```math\\nexpression\\n``` ```."
+		attrs: [str("language", "")]
 	},
 	{
-		name: "fileBlock",
+		name: "bulletList",
 		group: "block",
-		wire: "mdc-atom-block",
-		mdcTag: "file",
-		attrs: [
-			str("src"),
-			str("mime"),
-			str("uploadId"),
-			str("filename")
-		],
-		doc: "Wire form `:file{src=… mime=… upload-id=… filename=…}`; binary in sidecar."
-	},
-	{
-		name: "badge",
-		group: "inline",
-		wire: "mdc-atom-inl",
-		attrs: [
-			str("label"),
-			str("color"),
-			str("variant", "subtle")
-		],
-		doc: "Wire form `:badge[Label]{color=… variant=…}`."
-	},
-	{
-		name: "proseIcon",
-		group: "inline",
-		wire: "mdc-atom-inl",
-		mdcTag: "icon",
-		attrs: [str("name")],
-		doc: "Wire form `:icon{name=…}`."
-	},
-	{
-		name: "kbd",
-		group: "inline",
-		wire: "mdc-atom-inl",
-		attrs: [str("value")],
-		doc: "Wire form `:kbd{value=…}`."
-	}
-];
-const NODE_SPECS = [
-	...VANILLA_BLOCKS,
-	...MDC_CONTAINERS,
-	...INLINE_AND_SPECIAL
-];
-const NODE_SPEC_BY_NAME = new Map(NODE_SPECS.map((spec) => [spec.name, spec]));
-
-//#endregion
-//#region packages/convert/src/spec/marks.ts
-const MARK_SPECS = [
-	{
-		name: "bold",
-		wire: "delimited",
-		delim: "**"
-	},
-	{
-		name: "italic",
-		wire: "delimited",
-		delim: "*"
-	},
-	{
-		name: "strike",
-		wire: "delimited",
-		delim: "~~"
-	},
-	{
-		name: "code",
-		wire: "delimited",
-		delim: "`"
-	},
-	{
-		name: "link",
-		wire: "link",
-		attrs: [{
-			key: "href",
-			type: "string"
-		}, {
-			key: "title",
-			type: "string",
-			optional: true
-		}]
-	},
-	{
-		name: "underline",
-		wire: "delimited",
-		delim: "__",
-		doc: "Disambiguated from bold by delimiter character. Two underscores = underline; two asterisks = bold."
-	},
-	{
-		name: "highlight",
-		wire: "delimited",
-		delim: "==",
-		doc: "Pandoc-style."
-	},
-	{
-		name: "subscript",
-		wire: "delimited",
-		delim: "~",
-		doc: "Single tilde; double tilde is strike."
+		wire: "vanilla"
 	},
 	{
-		name: "superscript",
-		wire: "delimited",
-		delim: "^"
+		name: "orderedList",
+		group: "block",
+		wire: "vanilla"
 	},
 	{
-		name: "textStyle",
-		wire: "mdc-span",
-		attrs: [
-			{
-				key: "color",
-				type: "string",
-				optional: true
-			},
-			{
-				key: "backgroundColor",
-				type: "string",
-				optional: true
-			},
-			{
-				key: "fontSize",
-				type: "string",
-				optional: true
-			},
-			{
-				key: "fontFamily",
-				type: "string",
-				optional: true
-			}
-		],
-		doc: "Wire form `:span[text]{color=\"…\" font-size=\"…\"}`. Any of the attrs may be set."
-	}
-];
-const MARK_SPEC_BY_NAME = new Map(MARK_SPECS.map((spec) => [spec.name, spec]));
-const MARK_SPEC_BY_DELIM = new Map(MARK_SPECS.filter((spec) => spec.wire === "delimited" && !!spec.delim).map((spec) => [spec.delim, spec]));
-
-//#endregion
-//#region packages/convert/src/spec/universal-meta.ts
-const UNIVERSAL_META_KEYS = [
-	{
-		key: "title",
-		type: "string",
-		doc: "Display title; the first H1 is hoisted into this field on import."
+		name: "listItem",
+		group: "block",
+		wire: "vanilla",
+		contentBearing: true
 	},
 	{
-		key: "type",
-		type: "string",
-		doc: "Page type (doc, kanban, table, …). Omitted on serialise when \"doc\"."
+		name: "taskList",
+		group: "block",
+		wire: "vanilla"
 	},
 	{
-		key: "color",
-		type: "string",
-		doc: "Hex or CSS color name."
+		name: "taskItem",
+		group: "block",
+		wire: "vanilla",
+		attrs: [bool("checked")],
+		contentBearing: true
 	},
 	{
-		key: "icon",
-		type: "string",
-		doc: "Lucide icon name in kebab-case."
+		name: "table",
+		group: "block",
+		wire: "vanilla"
 	},
 	{
-		key: "datetimeStart",
-		type: "iso-datetime"
+		name: "tableRow",
+		group: "block",
+		wire: "vanilla"
 	},
 	{
-		key: "datetimeEnd",
-		type: "iso-datetime"
+		name: "tableHeader",
+		group: "block",
+		wire: "vanilla",
+		contentBearing: true
 	},
 	{
-		key: "allDay",
-		type: "boolean"
+		name: "tableCell",
+		group: "block",
+		wire: "vanilla",
+		contentBearing: true
 	},
 	{
-		key: "dateTaken",
-		type: "iso-datetime"
+		name: "horizontalRule",
+		group: "block",
+		wire: "vanilla"
 	},
 	{
-		key: "dateStart",
-		type: "iso-date",
-		parseAliases: ["date", "created"]
+		name: "image",
+		group: "block",
+		wire: "special",
+		attrs: [
+			str("src"),
+			str("alt", ""),
+			int("width"),
+			int("height")
+		]
 	},
 	{
-		key: "dateEnd",
-		type: "iso-date",
-		parseAliases: ["due"]
-	},
+		name: "hardBreak",
+		group: "inline",
+		wire: "vanilla"
+	}
+];
+const MDC_CONTAINERS = [
 	{
-		key: "timeStart",
-		type: "hh-mm"
+		name: "callout",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			{
+				key: "type",
+				type: "string",
+				default: "note",
+				optional: true,
+				values: [
+					"note",
+					"tip",
+					"warning",
+					"danger",
+					"info",
+					"caution",
+					"alert",
+					"success",
+					"error"
+				]
+			},
+			str("title"),
+			str("icon")
+		]
 	},
 	{
-		key: "timeEnd",
-		type: "hh-mm"
+		name: "collapsible",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [str("label", "Details"), bool("open")]
 	},
 	{
-		key: "tags",
-		type: "string[]"
+		name: "accordion",
+		group: "block",
+		wire: "mdc-slotted",
+		slotChild: "accordionItem"
 	},
 	{
-		key: "checked",
-		type: "boolean",
-		parseAliases: ["done"]
+		name: "accordionItem",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "accordion-item",
+		attrs: [str("label", "Item"), str("icon")]
 	},
 	{
-		key: "priority",
-		type: "integer",
-		min: 0,
-		max: 4,
-		doc: "Numeric or named (low/medium/high/urgent → 1/2/3/4)."
+		name: "tabs",
+		group: "block",
+		wire: "mdc-slotted",
+		slotChild: "tabsItem"
 	},
 	{
-		key: "status",
-		type: "string"
+		name: "tabsItem",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "tabs-item",
+		attrs: [str("label"), str("icon")]
 	},
 	{
-		key: "rating",
-		type: "number",
-		min: 0,
-		max: 5
+		name: "steps",
+		group: "block",
+		wire: "mdc-container"
 	},
 	{
-		key: "url",
-		type: "string"
+		name: "card",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			str("title"),
+			str("icon"),
+			str("to")
+		]
 	},
 	{
-		key: "email",
-		type: "string"
+		name: "cardGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "card-group",
+		slotChild: "card"
 	},
 	{
-		key: "phone",
-		type: "string"
+		name: "field",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			str("name"),
+			str("type", "string"),
+			bool("required")
+		]
 	},
 	{
-		key: "number",
-		type: "number"
+		name: "fieldGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "field-group",
+		slotChild: "field"
 	},
 	{
-		key: "unit",
-		type: "string"
+		name: "codeGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "code-group",
+		slotChild: "codeBlock"
 	},
 	{
-		key: "subtitle",
-		type: "string",
-		parseAliases: ["description"]
+		name: "codeCollapse",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "code-collapse"
 	},
 	{
-		key: "note",
-		type: "string"
+		name: "codePreview",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "code-preview"
 	},
 	{
-		key: "taskProgress",
-		type: "integer",
-		min: 0,
-		max: 100
+		name: "codeTree",
+		group: "block",
+		wire: "mdc-atom-block",
+		mdcTag: "code-tree",
+		attrs: [{
+			key: "files",
+			type: "json"
+		}]
 	},
 	{
-		key: "members",
-		type: "members"
+		name: "figure",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			str("src"),
+			str("alt", ""),
+			str("caption")
+		]
 	},
 	{
-		key: "coverUploadId",
-		type: "string"
+		name: "video",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [
+			str("src"),
+			str("poster"),
+			bool("autoplay"),
+			bool("loop"),
+			bool("controls")
+		]
 	},
 	{
-		key: "coverDocId",
-		type: "string"
+		name: "embed",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [str("src"), str("title")]
 	},
 	{
-		key: "coverMimeType",
-		type: "string"
+		name: "svgEmbed",
+		group: "block",
+		wire: "fence",
+		attrs: [str("title")],
+		mdcTag: "svg",
+		doc: "Serialised as a ```svg fenced block; the SVG markup is the body."
 	},
 	{
-		key: "geoType",
-		type: "string-enum",
-		values: [
-			"marker",
-			"line",
-			"measure"
-		]
+		name: "divider",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [str("label"), str("icon")]
 	},
 	{
-		key: "geoLat",
-		type: "number"
+		name: "quote",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [str("cite")]
 	},
 	{
-		key: "geoLng",
-		type: "number"
+		name: "progress",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [
+			num("value"),
+			num("max"),
+			str("label")
+		]
 	},
 	{
-		key: "geoDescription",
-		type: "string"
+		name: "spoiler",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [str("label")]
 	},
 	{
-		key: "deskX",
-		type: "number"
+		name: "colorSwatch",
+		group: "block",
+		wire: "mdc-atom-block",
+		mdcTag: "color-swatch",
+		attrs: [str("color"), str("label")]
 	},
 	{
-		key: "deskY",
-		type: "number"
+		name: "stat",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			str("label"),
+			str("value"),
+			str("icon")
+		]
 	},
 	{
-		key: "deskZ",
-		type: "number"
+		name: "statGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "stat-group",
+		slotChild: "stat"
 	},
 	{
-		key: "deskMode",
-		type: "string-enum",
-		values: [
-			"icon",
-			"widget-sm",
-			"widget-lg"
+		name: "button",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [
+			str("label"),
+			str("to"),
+			str("icon"),
+			str("variant")
 		]
 	},
 	{
-		key: "mmX",
-		type: "number"
+		name: "buttonGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "button-group",
+		slotChild: "button"
 	},
 	{
-		key: "mmY",
-		type: "number"
+		name: "timeline",
+		group: "block",
+		wire: "mdc-slotted",
+		slotChild: "timelineItem"
 	},
 	{
-		key: "graphX",
-		type: "number"
+		name: "timelineItem",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "timeline-item",
+		attrs: [
+			str("label"),
+			str("icon"),
+			str("date")
+		]
 	},
 	{
-		key: "graphY",
-		type: "number"
+		name: "diff",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [str("language", ""), {
+			key: "value",
+			type: "string"
+		}]
+	}
+];
+const INLINE_AND_SPECIAL = [
+	{
+		name: "docLink",
+		group: "inline",
+		wire: "special",
+		attrs: [str("docId")],
+		doc: "Wire form `[[uuid|label]]`; label regenerated on export."
 	},
 	{
-		key: "graphPinned",
-		type: "boolean"
+		name: "docEmbed",
+		group: "block",
+		wire: "special",
+		attrs: [
+			str("docId"),
+			bool("collapsed"),
+			bool("tall"),
+			bool("seamless")
+		],
+		doc: "Wire form `![[uuid|label]]{collapsed tall seamless}`."
 	},
 	{
-		key: "spX",
-		type: "number"
+		name: "mention",
+		group: "inline",
+		wire: "special",
+		attrs: [str("userId")],
+		doc: "Wire form `@[label](user:uuid)`; label regenerated on export."
 	},
 	{
-		key: "spY",
-		type: "number"
+		name: "mathInline",
+		group: "inline",
+		wire: "special",
+		attrs: [{
+			key: "expression",
+			type: "string"
+		}],
+		doc: "Wire form `$expression$`."
 	},
 	{
-		key: "spZ",
-		type: "number"
+		name: "mathBlock",
+		group: "block",
+		wire: "fence",
+		attrs: [{
+			key: "expression",
+			type: "string"
+		}],
+		mdcTag: "math",
+		doc: "Wire form ``` ```math\\nexpression\\n``` ```."
 	},
 	{
-		key: "spRX",
-		type: "number"
+		name: "fileBlock",
+		group: "block",
+		wire: "mdc-atom-block",
+		mdcTag: "file",
+		attrs: [
+			str("src"),
+			str("mime"),
+			str("uploadId"),
+			str("filename")
+		],
+		doc: "Wire form `:file{src=… mime=… upload-id=… filename=…}`; binary in sidecar."
 	},
 	{
-		key: "spRY",
-		type: "number"
+		name: "badge",
+		group: "inline",
+		wire: "mdc-atom-inl",
+		attrs: [
+			str("label"),
+			str("color"),
+			str("variant", "subtle")
+		],
+		doc: "Wire form `:badge[Label]{color=… variant=…}`."
 	},
 	{
-		key: "spRZ",
-		type: "number"
+		name: "proseIcon",
+		group: "inline",
+		wire: "mdc-atom-inl",
+		mdcTag: "icon",
+		attrs: [str("name")],
+		doc: "Wire form `:icon{name=…}`."
 	},
 	{
-		key: "spSX",
-		type: "number"
+		name: "kbd",
+		group: "inline",
+		wire: "mdc-atom-inl",
+		attrs: [str("value")],
+		doc: "Wire form `:kbd{value=…}`."
+	}
+];
+const NODE_SPECS = [
+	...VANILLA_BLOCKS,
+	...MDC_CONTAINERS,
+	...INLINE_AND_SPECIAL
+];
+const NODE_SPEC_BY_NAME = new Map(NODE_SPECS.map((spec) => [spec.name, spec]));
+
+//#endregion
+//#region packages/convert/src/spec/marks.ts
+const MARK_SPECS = [
+	{
+		name: "bold",
+		wire: "delimited",
+		delim: "**"
 	},
 	{
-		key: "spSY",
-		type: "number"
+		name: "italic",
+		wire: "delimited",
+		delim: "*"
 	},
 	{
-		key: "spSZ",
-		type: "number"
+		name: "strike",
+		wire: "delimited",
+		delim: "~~"
 	},
 	{
-		key: "spShape",
-		type: "string-enum",
-		values: [
-			"box",
-			"sphere",
-			"cylinder",
-			"cone",
-			"plane",
-			"torus",
-			"glb"
-		]
+		name: "code",
+		wire: "delimited",
+		delim: "`"
 	},
 	{
-		key: "spOpacity",
-		type: "integer",
-		min: 0,
-		max: 100
+		name: "link",
+		wire: "link",
+		attrs: [{
+			key: "href",
+			type: "string"
+		}, {
+			key: "title",
+			type: "string",
+			optional: true
+		}]
 	},
 	{
-		key: "spModelUploadId",
-		type: "string"
+		name: "underline",
+		wire: "delimited",
+		delim: "__",
+		doc: "Disambiguated from bold by delimiter character. Two underscores = underline; two asterisks = bold."
 	},
 	{
-		key: "spModelDocId",
-		type: "string"
+		name: "highlight",
+		wire: "delimited",
+		delim: "==",
+		doc: "Pandoc-style."
 	},
 	{
-		key: "slidesTransition",
-		type: "string-enum",
-		values: [
-			"none",
-			"fade",
-			"slide"
-		]
+		name: "subscript",
+		wire: "delimited",
+		delim: "~",
+		doc: "Single tilde; double tilde is strike."
 	},
 	{
-		key: "slidesTheme",
-		type: "string-enum",
-		values: ["dark", "light"]
+		name: "superscript",
+		wire: "delimited",
+		delim: "^"
 	},
 	{
-		key: "__schemaVersion",
-		type: "integer",
-		min: 0
+		name: "textStyle",
+		wire: "mdc-span",
+		attrs: [
+			{
+				key: "color",
+				type: "string",
+				optional: true
+			},
+			{
+				key: "backgroundColor",
+				type: "string",
+				optional: true
+			},
+			{
+				key: "fontSize",
+				type: "string",
+				optional: true
+			},
+			{
+				key: "fontFamily",
+				type: "string",
+				optional: true
+			}
+		],
+		doc: "Wire form `:span[text]{color=\"…\" font-size=\"…\"}`. Any of the attrs may be set."
 	}
 ];
-const UNIVERSAL_META_KEY_NAMES = new Set(UNIVERSAL_META_KEYS.map((k) => k.key));
+const MARK_SPEC_BY_NAME = new Map(MARK_SPECS.map((spec) => [spec.name, spec]));
+const MARK_SPEC_BY_DELIM = new Map(MARK_SPECS.filter((spec) => spec.wire === "delimited" && !!spec.delim).map((spec) => [spec.delim, spec]));
 
 //#endregion
 //#region packages/cli/src/commands/documents.ts