@haklex/rich-litexml 0.11.0 → 0.13.0

package/dist/index.mjs

@@ -1,4 +1,1142 @@
-import { a as registerCustomWriters, c as registerCustomReaders, i as createDefaultRegistry, l as registerBuiltinReaders, n as deserializeNodesFromXml, o as registerBuiltinWriters, r as wrapWithFormatTags, s as LitexmlRegistry, t as deserializeFromXml } from "./deserializer-CfdlNh2e.js";
+import { customAlphabet } from "nanoid";
+import { parseHTML } from "linkedom";
+//#region src/readers/builtin.ts
+function extractBlockId$1(el) {
+	const id = el.getAttribute("id");
+	return id ? { $: { blockId: id } } : {};
+}
+var ELEMENT_DEFAULTS = {
+	direction: "ltr",
+	format: "",
+	indent: 0,
+	textFormat: 0,
+	textStyle: "",
+	version: 1
+};
+function registerBuiltinReaders(registry) {
+	registry.registerReader("p", (el, ctx) => ({
+		type: "paragraph",
+		...extractBlockId$1(el),
+		children: ctx.parseChildren(el),
+		...ELEMENT_DEFAULTS
+	}));
+	for (let level = 1; level <= 6; level++) registry.registerReader(`h${level}`, (el, ctx) => ({
+		type: "heading",
+		tag: `h${level}`,
+		...extractBlockId$1(el),
+		children: ctx.parseChildren(el),
+		...ELEMENT_DEFAULTS
+	}));
+	registry.registerReader("blockquote", (el, ctx) => {
+		const attribution = el.getAttribute("attribution");
+		const base = {
+			...extractBlockId$1(el),
+			children: ctx.parseChildren(el),
+			...ELEMENT_DEFAULTS
+		};
+		if (attribution !== null) return {
+			type: "rich-quote",
+			attribution,
+			...base
+		};
+		return {
+			type: "quote",
+			...base
+		};
+	});
+	registry.registerReader("hr", (el) => ({
+		type: "horizontalrule",
+		...extractBlockId$1(el),
+		version: 1
+	}));
+	registry.registerReader("ul", (el, ctx) => {
+		return {
+			type: "list",
+			listType: el.getAttribute("type") === "check" ? "check" : "bullet",
+			tag: "ul",
+			start: 1,
+			...extractBlockId$1(el),
+			children: ctx.parseChildren(el),
+			direction: "ltr",
+			format: "",
+			indent: 0,
+			version: 1
+		};
+	});
+	registry.registerReader("ol", (el, ctx) => ({
+		type: "list",
+		listType: "number",
+		tag: "ol",
+		start: Number(el.getAttribute("start") ?? 1),
+		...extractBlockId$1(el),
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		version: 1
+	}));
+	registry.registerReader("li", (el, ctx) => {
+		const checked = el.getAttribute("checked");
+		return {
+			type: "listitem",
+			...extractBlockId$1(el),
+			...checked !== null ? { checked: checked === "true" } : {},
+			children: ctx.parseChildren(el),
+			...ELEMENT_DEFAULTS,
+			value: 1
+		};
+	});
+	registry.registerReader("a", (el, ctx) => ({
+		type: "link",
+		url: el.getAttribute("href") ?? "",
+		target: el.getAttribute("target") ?? null,
+		title: el.getAttribute("title") ?? null,
+		rel: null,
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		version: 1
+	}));
+	registry.registerReader("table", (el, ctx) => ({
+		type: "table",
+		...extractBlockId$1(el),
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		version: 1
+	}));
+	registry.registerReader("tr", (el, ctx) => ({
+		type: "tablerow",
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		version: 1
+	}));
+	registry.registerReader("th", (el, ctx) => ({
+		type: "tablecell",
+		headerState: 1,
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		version: 1
+	}));
+	registry.registerReader("td", (el, ctx) => ({
+		type: "tablecell",
+		headerState: 0,
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		version: 1
+	}));
+}
+//#endregion
+//#region src/readers/custom.ts
+var idAlphabet = "abcdefghijklmnopqrstuvwxyz0123456789";
+var makePollIdSuffix = customAlphabet(idAlphabet, 10);
+var makeOptionIdSuffix = customAlphabet(idAlphabet, 6);
+var makeChatParticipantId = customAlphabet(idAlphabet, 6);
+var makeChatMessageId = customAlphabet(idAlphabet, 8);
+function extractBlockId(el) {
+	const id = el.getAttribute("id");
+	return id ? { $: { blockId: id } } : {};
+}
+function numAttr(el, name) {
+	const v = el.getAttribute(name);
+	return v !== null ? Number(v) : void 0;
+}
+/**
+* Extract CDATA text content from an element.
+* linkedom (HTML parser) converts <![CDATA[...]]> to a comment node
+* with value "[CDATA[...]]", so we detect that pattern.
+*/
+function extractCdataText(el) {
+	for (const child of el.childNodes) if (child.nodeType === 8) {
+		const val = child.nodeValue ?? "";
+		if (val.startsWith("[CDATA[") && val.endsWith("]]")) return val.slice(7, -2);
+	}
+	return null;
+}
+function extractRawText(el) {
+	return extractCdataText(el) ?? el.textContent ?? "";
+}
+function registerCustomReaders(registry) {
+	registry.registerReader("img", (el) => {
+		if (el.parentElement?.tagName.toLowerCase() === "gallery") return false;
+		return {
+			type: "image",
+			...extractBlockId(el),
+			src: el.getAttribute("src") ?? "",
+			altText: el.getAttribute("alt") ?? "",
+			width: numAttr(el, "width"),
+			height: numAttr(el, "height"),
+			caption: el.getAttribute("caption") ?? void 0,
+			thumbhash: el.getAttribute("thumbhash") ?? void 0,
+			accent: el.getAttribute("accent") ?? void 0,
+			version: 1
+		};
+	});
+	registry.registerReader("video", (el) => ({
+		type: "video",
+		...extractBlockId(el),
+		src: el.getAttribute("src") ?? "",
+		poster: el.getAttribute("poster") ?? void 0,
+		width: numAttr(el, "width"),
+		height: numAttr(el, "height"),
+		version: 1
+	}));
+	registry.registerReader("link-card", (el) => ({
+		type: "link-card",
+		...extractBlockId(el),
+		url: el.getAttribute("url") ?? "",
+		source: el.getAttribute("source") ?? void 0,
+		title: el.getAttribute("title") ?? void 0,
+		description: el.getAttribute("description") ?? void 0,
+		favicon: el.getAttribute("favicon") ?? void 0,
+		image: el.getAttribute("image") ?? void 0,
+		version: 1
+	}));
+	registry.registerReader("embed", (el) => ({
+		type: "embed",
+		...extractBlockId(el),
+		url: el.getAttribute("url") ?? "",
+		source: el.getAttribute("source") ?? null,
+		version: 1
+	}));
+	registry.registerReader("codeblock", (el) => ({
+		type: "code-block",
+		...extractBlockId(el),
+		code: extractRawText(el),
+		language: el.getAttribute("lang") ?? "",
+		version: 1
+	}));
+	registry.registerReader("mermaid", (el) => ({
+		type: "mermaid",
+		...extractBlockId(el),
+		diagram: extractRawText(el),
+		version: 1
+	}));
+	registry.registerReader("math", (el) => {
+		if (el.getAttribute("display") === "block") return {
+			type: "katex-block",
+			...extractBlockId(el),
+			equation: extractRawText(el),
+			version: 1
+		};
+		const color = el.getAttribute("color");
+		return {
+			type: "katex-inline",
+			equation: extractRawText(el),
+			...color ? { color } : {},
+			version: 1
+		};
+	});
+	registry.registerReader("alert", (el, ctx) => {
+		const content = { root: {
+			type: "root",
+			children: ctx.parseChildren(el),
+			direction: "ltr",
+			format: "",
+			indent: 0,
+			version: 1
+		} };
+		return {
+			type: "alert-quote",
+			...extractBlockId(el),
+			alertType: el.getAttribute("type") ?? "note",
+			content,
+			version: 1
+		};
+	});
+	registry.registerReader("banner", (el, ctx) => {
+		const content = { root: {
+			type: "root",
+			children: ctx.parseChildren(el),
+			direction: "ltr",
+			format: "",
+			indent: 0,
+			version: 1
+		} };
+		return {
+			type: "banner",
+			...extractBlockId(el),
+			bannerType: el.getAttribute("type") ?? "note",
+			content,
+			version: 1
+		};
+	});
+	registry.registerReader("nested-doc", (el, ctx) => {
+		const content = { root: {
+			type: "root",
+			children: ctx.parseChildren(el),
+			direction: "ltr",
+			format: "",
+			indent: 0,
+			version: 1
+		} };
+		return {
+			type: "nested-doc",
+			...extractBlockId(el),
+			content,
+			version: 1
+		};
+	});
+	registry.registerReader("details", (el, ctx) => ({
+		type: "details",
+		...extractBlockId(el),
+		summary: el.getAttribute("summary") ?? "",
+		open: el.getAttribute("open") === "true",
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		version: 1
+	}));
+	registry.registerReader("spoiler", (el, ctx) => ({
+		type: "spoiler",
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		textFormat: 0,
+		textStyle: "",
+		version: 1
+	}));
+	registry.registerReader("ruby", (el, ctx) => ({
+		type: "ruby",
+		reading: el.getAttribute("rt") ?? "",
+		children: ctx.parseChildren(el),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		textFormat: 0,
+		textStyle: "",
+		version: 1
+	}));
+	registry.registerReader("mention", (el) => ({
+		type: "mention",
+		platform: el.getAttribute("platform") ?? "",
+		handle: el.getAttribute("handle") ?? "",
+		displayName: el.textContent || void 0,
+		version: 1
+	}));
+	registry.registerReader("tag", (el) => ({
+		type: "tag",
+		text: el.textContent ?? "",
+		format: 0,
+		detail: 0,
+		mode: "normal",
+		style: "",
+		version: 1
+	}));
+	registry.registerReader("comment", (el) => ({
+		type: "comment",
+		text: el.textContent ?? "",
+		format: 0,
+		detail: 0,
+		mode: "normal",
+		style: "",
+		version: 1
+	}));
+	registry.registerReader("footnote", (el) => ({
+		type: "footnote",
+		identifier: el.getAttribute("ref") ?? "",
+		version: 1
+	}));
+	registry.registerReader("footnote-section", (el) => {
+		const definitions = {};
+		for (const child of el.children) if (child.tagName.toLowerCase() === "def") {
+			const ref = child.getAttribute("ref") ?? "";
+			definitions[ref] = child.textContent ?? "";
+		}
+		return {
+			type: "footnote-section",
+			...extractBlockId(el),
+			definitions,
+			version: 1
+		};
+	});
+	registry.registerReader("gallery", (el) => {
+		const images = [];
+		for (const child of el.children) if (child.tagName.toLowerCase() === "img") images.push({
+			src: child.getAttribute("src") ?? "",
+			alt: child.getAttribute("alt") ?? void 0
+		});
+		return {
+			type: "gallery",
+			...extractBlockId(el),
+			images,
+			layout: el.getAttribute("layout") ?? "grid",
+			version: 1
+		};
+	});
+	registry.registerReader("excalidraw", (el) => ({
+		type: "excalidraw",
+		...extractBlockId(el),
+		snapshot: extractCdataText(el) || el.getAttribute("snapshot") || "",
+		version: 1
+	}));
+	registry.registerReader("grid", (el, ctx) => {
+		const cells = [];
+		for (const child of el.children) if (child.tagName.toLowerCase() === "cell") {
+			const children = ctx.parseChildren(child);
+			cells.push({ root: {
+				type: "root",
+				children,
+				direction: "ltr",
+				format: "",
+				indent: 0,
+				version: 1
+			} });
+		}
+		return {
+			type: "grid-container",
+			...extractBlockId(el),
+			cols: numAttr(el, "cols") ?? 2,
+			gap: el.getAttribute("gap") ?? "16px",
+			cells,
+			version: 1
+		};
+	});
+	registry.registerReader("agent-diff", (el) => ({
+		type: "agent-diff",
+		...extractBlockId(el),
+		opType: el.getAttribute("op") ?? "insert",
+		diffEntryId: el.getAttribute("entry") ?? "",
+		version: 1
+	}));
+	registry.registerReader("code-snippet", (el) => {
+		const files = [];
+		for (const child of el.children) if (child.tagName.toLowerCase() === "file") files.push({
+			filename: child.getAttribute("name") ?? "",
+			code: extractRawText(child),
+			language: child.getAttribute("lang") ?? ""
+		});
+		return {
+			type: "code-snippet",
+			...extractBlockId(el),
+			files,
+			version: 1
+		};
+	});
+	registry.registerReader("chat", (el) => {
+		const variant = el.getAttribute("variant") === "user-user" ? "user-user" : "user-agent";
+		const participants = [];
+		const messages = [];
+		for (const child of el.children) {
+			const tag = child.tagName.toLowerCase();
+			if (tag === "participants") for (const p of child.children) {
+				if (p.tagName.toLowerCase() !== "participant") continue;
+				const kind = p.getAttribute("kind") === "agent" ? "agent" : "user";
+				participants.push({
+					id: p.getAttribute("id") || `p_${makeChatParticipantId()}`,
+					kind,
+					name: p.getAttribute("name") || void 0,
+					avatar: p.getAttribute("avatar") || void 0
+				});
+			}
+			else if (tag === "messages") for (const m of child.children) {
+				if (m.tagName.toLowerCase() !== "message") continue;
+				messages.push({
+					id: m.getAttribute("id") || `m_${makeChatMessageId()}`,
+					participantId: m.getAttribute("participant") ?? "",
+					content: m.textContent ?? ""
+				});
+			}
+		}
+		return {
+			type: "chat",
+			...extractBlockId(el),
+			variant,
+			participants,
+			messages,
+			version: 1
+		};
+	});
+	registry.registerReader("poll", (el) => {
+		let question = "";
+		const options = [];
+		for (const child of el.children) {
+			const tag = child.tagName.toLowerCase();
+			if (tag === "question") question = child.textContent ?? "";
+			else if (tag === "option") {
+				const id = child.getAttribute("id") || `o_${makeOptionIdSuffix()}`;
+				options.push({
+					id,
+					label: child.textContent ?? ""
+				});
+			}
+		}
+		const mode = el.getAttribute("mode") === "multiple" ? "multiple" : "single";
+		const closeAt = el.getAttribute("close-at");
+		const showResultsAttr = el.getAttribute("show-results");
+		const showResults = showResultsAttr === "always" || showResultsAttr === "after-vote" || showResultsAttr === "after-close" ? showResultsAttr : void 0;
+		return {
+			type: "poll",
+			...extractBlockId(el),
+			pollId: el.getAttribute("poll-id") || `p_${makePollIdSuffix()}`,
+			question,
+			options,
+			mode,
+			...closeAt ? { closeAt } : {},
+			...showResults ? { showResults } : {},
+			version: 1
+		};
+	});
+}
+//#endregion
+//#region src/registry.ts
+var LitexmlRegistry = class {
+	constructor() {
+		this.writers = /* @__PURE__ */ new Map();
+		this.readers = /* @__PURE__ */ new Map();
+	}
+	registerWriter(nodeType, writer) {
+		this.writers.set(nodeType, writer);
+	}
+	registerReader(tagName, reader) {
+		this.readers.set(tagName.toLowerCase(), reader);
+	}
+	getWriter(nodeType) {
+		return this.writers.get(nodeType);
+	}
+	getReader(tagName) {
+		return this.readers.get(tagName.toLowerCase());
+	}
+};
+//#endregion
+//#region src/writers/builtin.ts
+function blockId$1(node) {
+	return node.$?.blockId ? { id: node.$.blockId } : {};
+}
+function registerBuiltinWriters(registry) {
+	registry.registerWriter("paragraph", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "p",
+			attrs: blockId$1(n),
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("heading", (node, ctx) => {
+		const n = node;
+		return {
+			tag: n.tag ?? "h1",
+			attrs: blockId$1(n),
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	const writeQuote = (node, ctx) => {
+		const n = node;
+		const attrs = { ...blockId$1(n) };
+		if (typeof n.attribution === "string" && n.attribution.trim() !== "") attrs.attribution = n.attribution;
+		return {
+			tag: "blockquote",
+			attrs,
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	};
+	registry.registerWriter("quote", writeQuote);
+	registry.registerWriter("rich-quote", writeQuote);
+	registry.registerWriter("horizontalrule", (node) => {
+		return {
+			tag: "hr",
+			attrs: blockId$1(node),
+			selfClosing: true
+		};
+	});
+	registry.registerWriter("list", (node, ctx) => {
+		const n = node;
+		const tag = n.listType === "number" ? "ol" : "ul";
+		const attrs = { ...blockId$1(n) };
+		if (n.listType === "check") attrs.type = "check";
+		return {
+			tag,
+			attrs,
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("listitem", (node, ctx) => {
+		const n = node;
+		const attrs = { ...blockId$1(n) };
+		if (n.checked !== void 0) attrs.checked = String(n.checked);
+		return {
+			tag: "li",
+			attrs,
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("link", (node, ctx) => {
+		const n = node;
+		const attrs = { href: n.url ?? "" };
+		if (n.target) attrs.target = n.target;
+		if (n.title) attrs.title = n.title;
+		return {
+			tag: "a",
+			attrs,
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("autolink", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "a",
+			attrs: { href: n.url ?? "" },
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("table", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "table",
+			attrs: blockId$1(n),
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("tablerow", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "tr",
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("tablecell", (node, ctx) => {
+		const n = node;
+		return {
+			tag: n.headerState === 1 ? "th" : "td",
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+}
+//#endregion
+//#region src/writers/custom.ts
+function blockId(node) {
+	return node.$?.blockId ? { id: node.$.blockId } : {};
+}
+function optAttr(attrs) {
+	const result = {};
+	for (const [k, v] of Object.entries(attrs)) if (v !== void 0 && v !== null && v !== "") result[k] = String(v);
+	return result;
+}
+function registerCustomWriters(registry) {
+	registry.registerWriter("image", (node) => {
+		const n = node;
+		return {
+			tag: "img",
+			attrs: optAttr({
+				...blockId(n),
+				src: n.src,
+				alt: n.altText,
+				width: n.width != null ? String(n.width) : void 0,
+				height: n.height != null ? String(n.height) : void 0,
+				caption: n.caption,
+				thumbhash: n.thumbhash,
+				accent: n.accent
+			}),
+			selfClosing: true
+		};
+	});
+	registry.registerWriter("video", (node) => {
+		const n = node;
+		return {
+			tag: "video",
+			attrs: optAttr({
+				...blockId(n),
+				src: n.src,
+				poster: n.poster
+			}),
+			selfClosing: true
+		};
+	});
+	registry.registerWriter("link-card", (node) => {
+		const n = node;
+		return {
+			tag: "link-card",
+			attrs: optAttr({
+				...blockId(n),
+				url: n.url,
+				source: n.source,
+				title: n.title,
+				description: n.description,
+				favicon: n.favicon,
+				image: n.image
+			}),
+			selfClosing: true
+		};
+	});
+	registry.registerWriter("embed", (node) => {
+		const n = node;
+		return {
+			tag: "embed",
+			attrs: optAttr({
+				...blockId(n),
+				url: n.url,
+				source: n.source
+			}),
+			selfClosing: true
+		};
+	});
+	registry.registerWriter("code-block", (node) => {
+		const n = node;
+		return {
+			tag: "codeblock",
+			attrs: optAttr({
+				...blockId(n),
+				lang: n.language
+			}),
+			children: [n.code ?? ""]
+		};
+	});
+	registry.registerWriter("mermaid", (node) => {
+		const n = node;
+		return {
+			tag: "mermaid",
+			attrs: blockId(n),
+			children: [n.diagram ?? ""]
+		};
+	});
+	registry.registerWriter("katex-block", (node) => {
+		const n = node;
+		return {
+			tag: "math",
+			attrs: {
+				...blockId(n),
+				display: "block"
+			},
+			children: [n.equation ?? ""]
+		};
+	});
+	registry.registerWriter("katex-inline", (node) => {
+		const n = node;
+		const attrs = {};
+		if (n.color) attrs.color = n.color;
+		return {
+			tag: "math",
+			attrs: Object.keys(attrs).length > 0 ? attrs : void 0,
+			children: [n.equation ?? ""]
+		};
+	});
+	registry.registerWriter("alert-quote", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "alert",
+			attrs: optAttr({
+				...blockId(n),
+				type: n.alertType
+			}),
+			children: ctx.serializeNestedState(n.content)
+		};
+	});
+	registry.registerWriter("banner", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "banner",
+			attrs: optAttr({
+				...blockId(n),
+				type: n.bannerType
+			}),
+			children: ctx.serializeNestedState(n.content)
+		};
+	});
+	registry.registerWriter("nested-doc", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "nested-doc",
+			attrs: blockId(n),
+			children: ctx.serializeNestedState(n.content ?? n.contentState)
+		};
+	});
+	registry.registerWriter("excalidraw", (node) => {
+		const n = node;
+		if (!n.snapshot) return {
+			tag: "excalidraw",
+			attrs: optAttr(blockId(n)),
+			selfClosing: true
+		};
+		return {
+			tag: "excalidraw",
+			attrs: optAttr(blockId(n)),
+			children: [{ cdata: n.snapshot }]
+		};
+	});
+	registry.registerWriter("grid-container", (node, ctx) => {
+		const n = node;
+		const cells = (n.cells ?? []).map((cellState) => ({
+			tag: "cell",
+			children: ctx.serializeNestedState(cellState)
+		}));
+		return {
+			tag: "grid",
+			attrs: optAttr({
+				...blockId(n),
+				cols: n.cols != null ? String(n.cols) : void 0,
+				gap: n.gap
+			}),
+			children: cells
+		};
+	});
+	registry.registerWriter("agent-diff", (node) => {
+		const n = node;
+		return {
+			tag: "agent-diff",
+			attrs: optAttr({
+				...blockId(n),
+				op: n.opType,
+				entry: n.diffEntryId
+			}),
+			selfClosing: true
+		};
+	});
+	registry.registerWriter("details", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "details",
+			attrs: optAttr({
+				...blockId(n),
+				summary: n.summary,
+				open: n.open != null ? String(n.open) : void 0
+			}),
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("spoiler", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "spoiler",
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("ruby", (node, ctx) => {
+		const n = node;
+		return {
+			tag: "ruby",
+			attrs: optAttr({ rt: n.reading }),
+			children: ctx.serializeChildren(n.children ?? [])
+		};
+	});
+	registry.registerWriter("mention", (node) => {
+		const n = node;
+		return {
+			tag: "mention",
+			attrs: optAttr({
+				platform: n.platform,
+				handle: n.handle
+			}),
+			children: [n.displayName ?? n.handle ?? ""]
+		};
+	});
+	registry.registerWriter("tag", (node) => {
+		return {
+			tag: "tag",
+			children: [node.text ?? ""]
+		};
+	});
+	registry.registerWriter("comment", (node) => {
+		return {
+			tag: "comment",
+			children: [node.text ?? ""]
+		};
+	});
+	registry.registerWriter("footnote", (node) => {
+		return {
+			tag: "footnote",
+			attrs: { ref: node.identifier ?? "" },
+			selfClosing: true
+		};
+	});
+	registry.registerWriter("footnote-section", (node) => {
+		const n = node;
+		const defs = n.definitions ?? {};
+		const children = Object.entries(defs).map(([ref, text]) => ({
+			tag: "def",
+			attrs: { ref },
+			children: [text]
+		}));
+		return {
+			tag: "footnote-section",
+			attrs: blockId(n),
+			children
+		};
+	});
+	registry.registerWriter("gallery", (node) => {
+		const n = node;
+		const images = (n.images ?? []).map((img) => ({
+			tag: "img",
+			attrs: optAttr({
+				src: img.src,
+				alt: img.alt
+			}),
+			selfClosing: true
+		}));
+		return {
+			tag: "gallery",
+			attrs: optAttr({
+				...blockId(n),
+				layout: n.layout
+			}),
+			children: images
+		};
+	});
+	registry.registerWriter("code-snippet", (node) => {
+		const n = node;
+		const files = (n.files ?? []).map((f) => ({
+			tag: "file",
+			attrs: optAttr({
+				name: f.filename,
+				lang: f.language
+			}),
+			children: [f.code ?? ""]
+		}));
+		return {
+			tag: "code-snippet",
+			attrs: blockId(n),
+			children: files
+		};
+	});
+	registry.registerWriter("chat", (node) => {
+		const n = node;
+		const participantsEl = {
+			tag: "participants",
+			children: (n.participants ?? []).map((p) => ({
+				tag: "participant",
+				attrs: optAttr({
+					id: p.id,
+					kind: p.kind,
+					name: p.name,
+					avatar: p.avatar
+				}),
+				children: []
+			}))
+		};
+		const messagesEl = {
+			tag: "messages",
+			children: (n.messages ?? []).map((m) => ({
+				tag: "message",
+				attrs: optAttr({
+					id: m.id,
+					participant: m.participantId
+				}),
+				children: [m.content ?? ""]
+			}))
+		};
+		return {
+			tag: "chat",
+			attrs: optAttr({
+				...blockId(n),
+				variant: n.variant
+			}),
+			children: [participantsEl, messagesEl]
+		};
+	});
+	registry.registerWriter("poll", (node) => {
+		const n = node;
+		const optionElements = (n.options ?? []).map((option) => ({
+			tag: "option",
+			attrs: optAttr({ id: option.id }),
+			children: [option.label ?? ""]
+		}));
+		return {
+			tag: "poll",
+			attrs: optAttr({
+				...blockId(n),
+				"poll-id": n.pollId,
+				"mode": n.mode,
+				"close-at": n.closeAt,
+				"show-results": n.showResults
+			}),
+			children: [{
+				tag: "question",
+				children: [n.question ?? ""]
+			}, ...optionElements]
+		};
+	});
+}
+//#endregion
+//#region src/default-registry.ts
+function createDefaultRegistry() {
+	const registry = new LitexmlRegistry();
+	registerBuiltinWriters(registry);
+	registerBuiltinReaders(registry);
+	registerCustomWriters(registry);
+	registerCustomReaders(registry);
+	return registry;
+}
+//#endregion
+//#region src/text-format.ts
+/** Ordered list: bit value → XML tag. Order determines nesting (outer→inner). */
+var FORMAT_BIT_TO_TAG = [
+	[1, "b"],
+	[2, "i"],
+	[4, "s"],
+	[8, "u"],
+	[16, "code"],
+	[32, "sub"],
+	[64, "sup"],
+	[128, "mark"]
+];
+/** Reverse map: XML tag name → bit value (includes aliases) */
+var FORMAT_TAG_TO_BIT = {
+	b: 1,
+	strong: 1,
+	i: 2,
+	em: 2,
+	s: 4,
+	del: 4,
+	strike: 4,
+	u: 8,
+	code: 16,
+	sub: 32,
+	sup: 64,
+	mark: 128
+};
+/** Wrap text content with nested format tags based on bitmask. */
+function wrapWithFormatTags(text, format) {
+	if (format === 0) return [text];
+	let content = [text];
+	for (let idx = FORMAT_BIT_TO_TAG.length - 1; idx >= 0; idx--) {
+		const [bit, tag] = FORMAT_BIT_TO_TAG[idx];
+		if (format & bit) content = [{
+			tag,
+			children: content
+		}];
+	}
+	return content;
+}
+/** Check if a tag name is a known text format tag. */
+function isFormatTag(tagName) {
+	return tagName.toLowerCase() in FORMAT_TAG_TO_BIT;
+}
+/** Get the format bit for a tag name. Returns 0 if not a format tag. */
+function getFormatBit(tagName) {
+	return FORMAT_TAG_TO_BIT[tagName.toLowerCase()] ?? 0;
+}
+//#endregion
+//#region src/deserializer.ts
+function parseXml(xml) {
+	const { document } = parseHTML(`<!DOCTYPE html><html><body>${xml}</body></html>`);
+	return document;
+}
+function deserializeFromXml(xml, registry) {
+	const doc = parseXml(xml);
+	const docEl = doc.querySelector("doc") ?? doc.body;
+	return { root: {
+		type: "root",
+		children: createReaderContext(registry).parseChildren(docEl),
+		direction: "ltr",
+		format: "",
+		indent: 0,
+		version: 1
+	} };
+}
+function deserializeNodesFromXml(xml, registry) {
+	const doc = parseXml(`<fragment>${xml}</fragment>`);
+	const fragment = doc.querySelector("fragment") ?? doc.body;
+	return createReaderContext(registry).parseChildren(fragment);
+}
+/** Structural containers whose whitespace-only text nodes are layout artifacts, not content */
+var BLOCK_TAGS = new Set([
+	"doc",
+	"fragment",
+	"root",
+	"ul",
+	"ol",
+	"table",
+	"tr",
+	"blockquote",
+	"alert",
+	"banner",
+	"details",
+	"nested-doc",
+	"gallery",
+	"codeblock",
+	"code-snippet",
+	"footnote-section",
+	"grid",
+	"cell",
+	"excalidraw"
+]);
+function isBlockContainer(element) {
+	return BLOCK_TAGS.has(element.tagName.toLowerCase());
+}
+function createReaderContext(registry) {
+	const ctx = {
+		parseChildren(element) {
+			const blockLevel = isBlockContainer(element);
+			const nodes = [];
+			for (const child of element.childNodes) if (child.nodeType === 3) {
+				const text = child.textContent ?? "";
+				if (blockLevel && text.trim() === "") continue;
+				if (text === "") continue;
+				nodes.push(makeTextNode(text, 0));
+			} else if (child.nodeType === 1) {
+				const parsed = parseElement(child, registry, ctx, 0);
+				if (parsed) if (Array.isArray(parsed)) nodes.push(...parsed);
+				else nodes.push(parsed);
+			}
+			return nodes;
+		},
+		parseNestedState(xml) {
+			return deserializeFromXml(xml, registry);
+		}
+	};
+	return ctx;
+}
+function parseElement(element, registry, ctx, inheritedFormat) {
+	const tag = element.tagName.toLowerCase();
+	if (isFormatTag(tag)) return parseInlineChildren(element, registry, ctx, inheritedFormat | getFormatBit(tag));
+	if (tag === "br") return {
+		type: "linebreak",
+		version: 1
+	};
+	if (tag === "node") return parseFallbackNode(element);
+	const reader = registry.getReader(tag);
+	if (reader) {
+		const result = reader(element, ctx);
+		if (result !== false) return result;
+	}
+	return ctx.parseChildren(element);
+}
+function parseInlineChildren(element, registry, ctx, format) {
+	const nodes = [];
+	for (const child of element.childNodes) if (child.nodeType === 3) {
+		const text = child.textContent ?? "";
+		if (text === "") continue;
+		nodes.push(makeTextNode(text, format));
+	} else if (child.nodeType === 1) {
+		const parsed = parseElement(child, registry, ctx, format);
+		if (parsed) if (Array.isArray(parsed)) nodes.push(...parsed);
+		else nodes.push(parsed);
+	}
+	return nodes;
+}
+function parseFallbackNode(element) {
+	const type = element.getAttribute("type") ?? "unknown";
+	const id = element.getAttribute("id");
+	const dataStr = element.getAttribute("data");
+	const data = dataStr ? JSON.parse(dataStr) : {};
+	return {
+		type,
+		...id ? { $: { blockId: id } } : {},
+		...data,
+		version: 1
+	};
+}
+function makeTextNode(text, format) {
+	return {
+		type: "text",
+		text,
+		format,
+		detail: 0,
+		mode: "normal",
+		style: "",
+		version: 1
+	};
+}
+//#endregion
 //#region src/xml-utils.ts
 var ESCAPE_MAP = {
 	"&": "&amp;",