@threadlabs/looma 0.29.12 → 0.29.13

package/editor/chunks/extensions.js

@@ -1,4 +1,5 @@
 import { n as TABLE_CELL_BACKGROUND_PRESETS } from "./table-backgrounds.js";
+import { a as assignLoomaHeadingIds, c as loomaContainerMarker, d as normalizeLoomaChipTone, f as parseLoomaAttributes, h as splitLoomaFrontmatter, i as applyLoomaCodeNotation, l as loomaHeadingSlug, m as readLoomaAttributes, n as LOOMA_CHIP_TONES, o as formatLoomaAttributes, p as parseLoomaFenceInfo, r as LOOMA_CONTAINER_NAMES, s as loomaCodeFence, u as normalizeLoomaCalloutTone } from "./markdown.js";
 import { Extension, Mark, Node as Node$1, callOrReturn, canInsertNode, combineTransactionSteps, escapeForRegEx, findChildren, findChildrenInRange, findParentNodeClosestToPos, getAttributes, getChangedRanges, getExtensionField, getMarksBetween, getText, getTextSerializersFromSchema, isNodeEmpty, isNodeSelection, markInputRule, markPasteRule, mergeAttributes, nodeInputRule, textInputRule, textblockTypeInputRule, wrappingInputRule } from "@tiptap/core";
 import { NodeSelection, Plugin, PluginKey, Selection, TextSelection } from "@tiptap/pm/state";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
@@ -127,247 +128,6 @@ var LoomaActiveBlock = Extension.create({
 	}
 });
 //#endregion
-//#region src/markdown/index.ts
-/**
-* Callout tones a document stores, in the order the editor offers them. The Callout component also
-* takes `neutral` and `success`, which Markdown and the editor store as `note`.
-*/
-var LOOMA_CALLOUT_TONES = [
-	"note",
-	"tip",
-	"info",
-	"important",
-	"warning",
-	"danger"
-];
-/** Names that read as a stored tone: `caution` is `danger`, and `neutral` is the same muted aside as `note`. */
-var LOOMA_CALLOUT_TONE_ALIASES = {
-	caution: "danger",
-	neutral: "note"
-};
-/**
-* Maps a tone name or alias, in any case, onto a stored tone.
-* @failure Unknown and non-string values become `note`.
-*/
-function normalizeLoomaCalloutTone(value) {
-	if (typeof value !== "string") return "note";
-	const tone = value.toLowerCase();
-	return LOOMA_CALLOUT_TONES.includes(tone) ? tone : LOOMA_CALLOUT_TONE_ALIASES[tone] ?? "note";
-}
-/** The hues chips and swatches take as their tone, written `:chip[Label]{tone=green}`. */
-var LOOMA_CHIP_TONES = [
-	"neutral",
-	"blue",
-	"green",
-	"yellow",
-	"red",
-	"purple"
-];
-/**
-* Keeps a chip tone within the palette.
-* @failure Unknown values become `neutral`.
-*/
-function normalizeLoomaChipTone(value) {
-	return LOOMA_CHIP_TONES.includes(value) ? value : "neutral";
-}
-/**
-* Names that open a `:::` container, matched without regard to case. A container with any other
-* name is ordinary text.
-*/
-var LOOMA_CONTAINER_NAMES = /* @__PURE__ */ new Set([
-	...LOOMA_CALLOUT_TONES,
-	"caution",
-	"details",
-	"figure",
-	"tabs",
-	"code-group"
-]);
-var ATTRIBUTE_KEY = /[A-Za-z][\w-]*/y;
-var ATTRIBUTE_ID = /#([\w-]+)/y;
-var ATTRIBUTE_VALUE = /[^\s"'=<>`{}]+/y;
-function sticky(pattern, source, index) {
-	pattern.lastIndex = index;
-	return pattern.exec(source);
-}
-/**
-* Reads a brace attribute list starting at `source[start]`, which must be `{`.
-* @contract Returns the attributes and the index just past the closing brace.
-* @failure Returns null for anything that is not a complete, well-formed list, so the text stays literal.
-*/
-function readLoomaAttributes(source, start = 0) {
-	if (source[start] !== "{") return null;
-	const attributes = {};
-	let index = start + 1;
-	for (;;) {
-		while (source[index] === " " || source[index] === "	") index++;
-		if (source[index] === "}") return {
-			attributes,
-			end: index + 1
-		};
-		if (index > start + 1 && !/\s/.test(source[index - 1])) return null;
-		const id = sticky(ATTRIBUTE_ID, source, index);
-		if (id) {
-			attributes.id = id[1];
-			index += id[0].length;
-			continue;
-		}
-		const key = sticky(ATTRIBUTE_KEY, source, index);
-		if (!key) return null;
-		index += key[0].length;
-		if (source[index] !== "=") {
-			attributes[key[0]] = true;
-			continue;
-		}
-		index++;
-		const quote = source[index];
-		if (quote === "\"" || quote === "'") {
-			const close = source.indexOf(quote, index + 1);
-			if (close < 0) return null;
-			attributes[key[0]] = source.slice(index + 1, close);
-			index = close + 1;
-			continue;
-		}
-		const value = sticky(ATTRIBUTE_VALUE, source, index);
-		if (!value) return null;
-		attributes[key[0]] = value[0];
-		index += value[0].length;
-	}
-}
-/**
-* Reads a whole string as one brace attribute list.
-* @failure Returns null unless the string is exactly one well-formed list.
-*/
-function parseLoomaAttributes(source) {
-	const read = readLoomaAttributes(source);
-	return read && read.end === source.length ? read.attributes : null;
-}
-/**
-* Writes attributes as a brace list, `id` first as `#id`, then the rest in order.
-* @contract `true` writes a bare key; values are quoted only when they need it. `false`, null and
-* undefined values are left out, and an empty set writes an empty string. An ID that `#` cannot
-* carry, or any ID when `hashId` is false, is written `id=…`.
-*/
-function formatLoomaAttributes(attributes, { hashId = true } = {}) {
-	const items = [];
-	const { id, ...rest } = attributes;
-	const hashed = hashId && typeof id === "string" && /^[\w-]+$/.test(id);
-	if (hashed) items.push(`#${id}`);
-	for (const [key, value] of Object.entries(hashed ? rest : attributes)) if (value === true) items.push(key);
-	else if (value === false || value === null || value === void 0) continue;
-	else {
-		const text = String(value);
-		items.push(/^[^\s"'=<>`{}]+$/.test(text) ? `${key}=${text}` : text.includes("\"") ? `${key}='${text}'` : `${key}="${text}"`);
-	}
-	return items.length ? `{${items.join(" ")}}` : "";
-}
-/**
-* The anchor a heading's text derives: NFC, lowercase, keeping letters, numbers and combining
-* marks, with every other run of characters one hyphen.
-* @failure Text with no letters or numbers, such as only emoji, derives `heading`.
-*/
-function loomaHeadingSlug(text) {
-	return text.normalize("NFC").toLowerCase().replace(/[^\p{L}\p{N}\p{M}]+/gu, "-").replace(/^-+|-+$/g, "") || "heading";
-}
-/**
-* Gives every heading of a document its anchor, in document order.
-* @contract A custom ID is kept unless an earlier heading already has it. Any other heading takes
-* its slug, or the slug's first free suffix (`-1`, `-2`…), never one a later custom ID reserves.
-*/
-function assignLoomaHeadingIds(headings) {
-	const reserved = new Set(headings.map(({ id }) => id).filter((id) => Boolean(id)));
-	const used = /* @__PURE__ */ new Set();
-	return headings.map(({ text, id: custom }) => {
-		let id = custom || loomaHeadingSlug(text);
-		if (custom ? used.has(id) : used.has(id) || reserved.has(id)) {
-			const stem = id;
-			let suffix = 1;
-			while (used.has(`${stem}-${suffix}`) || reserved.has(`${stem}-${suffix}`)) suffix++;
-			id = `${stem}-${suffix}`;
-		}
-		used.add(id);
-		return id;
-	});
-}
-/** Reads a fence's info string: ```` ```ts title="a.ts" {1,3-5} :line-numbers ````. */
-function parseLoomaFenceInfo(info) {
-	const source = info.trim();
-	const language = /^[^\s={:]+(?=[\s{:]|$)/.exec(source)?.[0];
-	const meta = (language ? source.slice(language.length) : source).trim();
-	const title = /(?:^|\s)title="([^"]*)"/.exec(meta)?.[1];
-	const rest = meta.replace(/(?:^|\s)title="[^"]*"/, "");
-	const lines = /* @__PURE__ */ new Set();
-	for (const range of /\{([\d\s,-]+)\}/.exec(rest)?.[1].split(",") ?? []) {
-		const [from = NaN, to = from] = range.split("-").map((part) => Number.parseInt(part, 10));
-		for (let line = from; line <= to; line++) lines.add(line);
-	}
-	const numbers = /:(no-)?line-numbers(?![\w-])/.exec(rest);
-	return {
-		...language ? { language } : {},
-		meta,
-		...title !== void 0 ? { title } : {},
-		lines: [...lines].sort((a, b) => a - b),
-		...numbers ? { lineNumbers: numbers[1] === void 0 } : {}
-	};
-}
-var MAPPING_KEY = /^(?:[^\s#:'"\-?,[\]{}&*!|>%@`][^:\n]*?|"[^"\n]*"|'[^'\n]*')[ \t]*:(?:[ \t]|$)/;
-var NOTATION = /[ \t]*(?:\/\/|#|--|<!--|\{?\/\*)[ \t]*\[!code highlight(?::(\d+))?\][ \t]*(?:-->|\*\/\}?)?[ \t]*$/;
-var ESCAPED_NOTATION = /\[\\(\\*!code highlight)/g;
-/**
-* Applies code notation: a line ending in a `[!code highlight]` comment is highlighted and loses
-* the comment, `[!code highlight:3]` covers three lines, and a marker alone on its line is removed
-* with the line and applies to the lines after it. A backslash between `[` and `!` escapes a
-* marker, `[\!code highlight]`, which then shows as text with one backslash fewer and highlights
-* nothing.
-* @contract Returns the code a reader sees and its highlighted line numbers, from 1, ascending.
-* ponytail: matched on source lines, so a string that ends in the marker counts too.
-*/
-function applyLoomaCodeNotation(code) {
-	const kept = [];
-	const lines = /* @__PURE__ */ new Set();
-	for (const line of code.split("\n")) {
-		const match = NOTATION.exec(line);
-		if (!match) {
-			kept.push(line);
-			continue;
-		}
-		const rest = line.slice(0, match.index);
-		const own = rest.trim() !== "";
-		if (own) kept.push(rest);
-		for (let count = 0; count < Number(match[1] ?? 1); count++) lines.add(kept.length + (own ? 0 : 1) + count);
-	}
-	return {
-		code: kept.join("\n").replace(ESCAPED_NOTATION, "[$1"),
-		lines: [...lines].sort((a, b) => a - b)
-	};
-}
-/**
-* Splits YAML front matter from the start of a document.
-* @contract Front matter opens with a `---` line at the very start and closes at a `---` or `...`
-* line, and what lies between is a YAML mapping: its first line that is not blank or a comment
-* starts with a key, whose value may be a scalar, a list or a mapping. `source` is the block as
-* written, delimiters included.
-* @failure Returns null when the document has none.
-*/
-function splitLoomaFrontmatter(document) {
-	const match = /^---[ \t]*\r?\n([\s\S]*?)\r?\n(?:---|\.\.\.)[ \t]*(?:\r?\n|$)/.exec(document.slice(0, 8192));
-	const first = match?.[1].split(/\r?\n/).find((line) => line.trim() && !line.trimStart().startsWith("#"));
-	if (!match || !first || !MAPPING_KEY.test(first)) return null;
-	return {
-		source: match[0].trimEnd(),
-		yaml: match[1],
-		body: document.slice(match[0].length)
-	};
-}
-/** The colons a container opens and closes with, given how deeply containers nest inside it. */
-function loomaContainerMarker(nestedDepth) {
-	return ":".repeat(3 + Math.max(0, nestedDepth));
-}
-/** A backtick fence longer than any run of backticks in the code, and at least three long. */
-function loomaCodeFence(code) {
-	const longest = Math.max(0, ...(code.match(/`+/g) ?? []).map((run) => run.length));
-	return "`".repeat(Math.max(3, longest + 1));
-}
-//#endregion
 //#region src/editor/extensions/callout.ts
 /**
 * A durable block container for informational editor content, saved as Looma's Callout.
@@ -735,6 +495,24 @@ var LoomaTabs = Node$1.create({
 				parseHTML: (element) => element.getAttribute("group") ?? "",
 				renderHTML: (attributes) => attributes.group ? { group: attributes.group } : {}
 			},
+			defaultValue: {
+				default: null,
+				parseHTML: (element) => element.getAttribute("data-default-value"),
+				renderHTML: (attributes) => attributes.defaultValue === null ? {} : {
+					"data-default-value": attributes.defaultValue,
+					value: attributes.defaultValue
+				}
+			},
+			queryString: {
+				default: null,
+				parseHTML: (element) => element.getAttribute("data-query-string"),
+				renderHTML: (attributes) => attributes.queryString === null ? {} : { "data-query-string": attributes.queryString }
+			},
+			lazy: {
+				default: null,
+				parseHTML: (element) => element.hasAttribute("data-lazy") ? element.getAttribute("data-lazy") !== "false" : null,
+				renderHTML: (attributes) => attributes.lazy === null ? {} : { "data-lazy": String(attributes.lazy) }
+			},
 			codeGroup: {
 				default: false,
 				parseHTML: (element) => element.classList.contains("code-group"),
@@ -773,11 +551,18 @@ var LoomaTab = Node$1.create({
 	defining: true,
 	isolating: true,
 	addAttributes() {
-		return { label: {
-			default: "",
-			parseHTML: (element) => element.getAttribute("aria-label") ?? "",
-			renderHTML: (attributes) => ({ "aria-label": attributes.label })
-		} };
+		return {
+			value: {
+				default: null,
+				parseHTML: (element) => element.getAttribute("data-value"),
+				renderHTML: (attributes) => attributes.value === null ? {} : { "data-value": attributes.value }
+			},
+			label: {
+				default: "",
+				parseHTML: (element) => element.getAttribute("aria-label") ?? "",
+				renderHTML: (attributes) => ({ "aria-label": attributes.label })
+			}
+		};
 	},
 	parseHTML() {
 		return [{ tag: "ui-tabs > section" }];
@@ -975,14 +760,18 @@ async function navigateTableOfContents(editor, id) {
 	target.tabIndex = -1;
 	target.focus({ preventScroll: true });
 }
+function importAuthoredNavigation(element, schema) {
+	return DOMParser.fromSchema(schema).parse(element).content;
+}
 /**
-* Automatic whole-document navigation with durable configuration only.
+* Automatic navigation, or an explicitly authored navigation body imported from a document.
 * @ownership The schema owns configuration/anchors; node views derive entries.
 * @lifecycle Headless views subscribe to transactions and unsubscribe on destroy.
 */
 var LoomaTableOfContents = Node$1.create({
 	name: "loomaTableOfContents",
 	group: "block",
+	content: "block*",
 	atom: true,
 	selectable: true,
 	isolating: true,
@@ -1002,8 +791,25 @@ var LoomaTableOfContents = Node$1.create({
 			}
 		};
 	},
-	parseHTML: () => [{ tag: "nav[data-looma-toc]" }],
+	parseHTML: () => [{
+		tag: "nav[data-looma-toc]",
+		getContent: (element, schema) => {
+			if (!(element instanceof HTMLElement) || !element.hasAttribute("data-authored-body")) return Fragment.empty;
+			return importAuthoredNavigation(element, schema);
+		}
+	}],
 	renderHTML({ node }) {
+		if (node.childCount) return [
+			"nav",
+			{
+				"data-looma-toc": "",
+				"data-authored-body": "",
+				"data-format": node.attrs.format,
+				"data-depth": node.attrs.depth,
+				"aria-label": "Table of contents"
+			},
+			0
+		];
 		return contentsHtml(this.editor?.view?.state.doc ?? node, normalizeTableOfContentsConfig(node.attrs));
 	},
 	addCommands() {
@@ -1019,8 +825,15 @@ var LoomaTableOfContents = Node$1.create({
 			dom.contentEditable = "false";
 			let current = node;
 			const render = () => {
-				const { dom: content } = DOMSerializer.renderSpec(document, contentsHtml(editor.state.doc, normalizeTableOfContentsConfig(current.attrs)));
-				dom.replaceChildren(content);
+				if (current.childCount) {
+					const nav = document.createElement("nav");
+					nav.setAttribute("aria-label", "Table of contents");
+					nav.append(DOMSerializer.fromSchema(editor.schema).serializeFragment(current.content));
+					dom.replaceChildren(nav);
+				} else {
+					const { dom: content } = DOMSerializer.renderSpec(document, contentsHtml(editor.state.doc, normalizeTableOfContentsConfig(current.attrs)));
+					dom.replaceChildren(content);
+				}
 			};
 			dom.addEventListener("click", (event) => {
 				const anchor = event.target.closest("a");
@@ -10176,6 +9989,22 @@ function loomaMarkdownFromDoc(doc) {
 	const custom = customHeadingIds(doc);
 	let heading = 0;
 	const nodes = {
+		loomaTableOfContents: (state, node, parent, index) => {
+			if (node.childCount) {
+				state.write(html(node));
+				state.closeBlock(node);
+			} else NODES.loomaTableOfContents(state, node, parent, index);
+		},
+		loomaTabs: (state, node, parent, index) => {
+			if ([
+				node.attrs.defaultValue,
+				node.attrs.queryString,
+				node.attrs.lazy
+			].some((value) => value !== null && value !== void 0) || Array.from({ length: node.childCount }, (_, index) => node.child(index)).some((tab) => tab.attrs.value !== null && tab.attrs.value !== void 0)) {
+				state.write(html(node));
+				state.closeBlock(node);
+			} else NODES.loomaTabs(state, node, parent, index);
+		},
 		heading: (state, node) => {
 			state.write(`${"#".repeat(node.attrs.level)} `);
 			state.renderInline(node, false);
@@ -11955,4 +11784,4 @@ function createLoomaSlashCommandExtension(options = {}) {
 	});
 }
 //#endregion
-export { LoomaActiveBlockPluginKey as $, filterLoomaMentionItems as A, LoomaFigcaption as B, loomaMarkdownToHtml as C, createLoomaMentionExtension as D, LoomaMentionSuggestionPluginKey as E, LoomaTableOfContents as F, LoomaChip as G, LoomaExpand as H, getTableOfContentsEntries as I, LOOMA_CALLOUT_TONES as J, normalizeLoomaChipColor as K, normalizeTableOfContentsConfig as L, LoomaImage as M, normalizeImageDimension as N, DEFAULT_MENTION_RESULT_LIMIT as O, normalizeImagePlacement as P, LoomaActiveBlock as Q, LoomaTab as R, loomaMarkdownFromDoc as S, siteRelativeHref as T, revealLoomaExpandAt as U, LoomaFigure as V, LOOMA_CHIP_COLORS as W, LOOMA_ACTIVE_BLOCK_CLASS as X, LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS as Y, LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS as Z, getActiveTableCellAlignment as _, getActiveTableUiState as a, setActiveTableCellBackground as b, insertTableAtRange as c, LoomaTableKit as d, getDefaultEditorExtensions as f, LoomaTableHeader as g, LoomaTableCell as h, getDefaultSlashCommands as i, normalizeMentionResultLimit as j, MAX_MENTION_RESULT_LIMIT as k, normalizeActiveTableColumnWidths as l, LoomaTable as m, createLoomaSlashCommandExtension as n, handleTableAction as o, getLoomaTableExtensions as p, LoomaCallout as q, filterLoomaSlashCommands as r, handleTableOverlayAction as s, LoomaSlashCommand as t, shouldShowTextFormattingToolbar as u, getActiveTableCellBackground as v, createSiteRelativeLinks as w, LoomaSmartPaste as x, setActiveTableCellAlignment as y, LoomaTabs as z };
+export { filterLoomaMentionItems as A, LoomaFigcaption as B, loomaMarkdownToHtml as C, createLoomaMentionExtension as D, LoomaMentionSuggestionPluginKey as E, LoomaTableOfContents as F, LoomaChip as G, LoomaExpand as H, getTableOfContentsEntries as I, LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS as J, normalizeLoomaChipColor as K, normalizeTableOfContentsConfig as L, LoomaImage as M, normalizeImageDimension as N, DEFAULT_MENTION_RESULT_LIMIT as O, normalizeImagePlacement as P, LoomaActiveBlockPluginKey as Q, LoomaTab as R, loomaMarkdownFromDoc as S, siteRelativeHref as T, revealLoomaExpandAt as U, LoomaFigure as V, LOOMA_CHIP_COLORS as W, LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS as X, LOOMA_ACTIVE_BLOCK_CLASS as Y, LoomaActiveBlock as Z, getActiveTableCellAlignment as _, getActiveTableUiState as a, setActiveTableCellBackground as b, insertTableAtRange as c, LoomaTableKit as d, getDefaultEditorExtensions as f, LoomaTableHeader as g, LoomaTableCell as h, getDefaultSlashCommands as i, normalizeMentionResultLimit as j, MAX_MENTION_RESULT_LIMIT as k, normalizeActiveTableColumnWidths as l, LoomaTable as m, createLoomaSlashCommandExtension as n, handleTableAction as o, getLoomaTableExtensions as p, LoomaCallout as q, filterLoomaSlashCommands as r, handleTableOverlayAction as s, LoomaSlashCommand as t, shouldShowTextFormattingToolbar as u, getActiveTableCellBackground as v, createSiteRelativeLinks as w, LoomaSmartPaste as x, setActiveTableCellAlignment as y, LoomaTabs as z };

package/editor/chunks/markdown.js

@@ -0,0 +1,242 @@
+//#region src/markdown/index.ts
+/**
+* Callout tones a document stores, in the order the editor offers them. The Callout component also
+* takes `neutral` and `success`, which Markdown and the editor store as `note`.
+*/
+var LOOMA_CALLOUT_TONES = [
+	"note",
+	"tip",
+	"info",
+	"important",
+	"warning",
+	"danger"
+];
+/** Names that read as a stored tone: `caution` is `danger`, and `neutral` is the same muted aside as `note`. */
+var LOOMA_CALLOUT_TONE_ALIASES = {
+	caution: "danger",
+	neutral: "note"
+};
+/**
+* Maps a tone name or alias, in any case, onto a stored tone.
+* @failure Unknown and non-string values become `note`.
+*/
+function normalizeLoomaCalloutTone(value) {
+	if (typeof value !== "string") return "note";
+	const tone = value.toLowerCase();
+	return LOOMA_CALLOUT_TONES.includes(tone) ? tone : LOOMA_CALLOUT_TONE_ALIASES[tone] ?? "note";
+}
+/** The hues chips and swatches take as their tone, written `:chip[Label]{tone=green}`. */
+var LOOMA_CHIP_TONES = [
+	"neutral",
+	"blue",
+	"green",
+	"yellow",
+	"red",
+	"purple"
+];
+/**
+* Keeps a chip tone within the palette.
+* @failure Unknown values become `neutral`.
+*/
+function normalizeLoomaChipTone(value) {
+	return LOOMA_CHIP_TONES.includes(value) ? value : "neutral";
+}
+/**
+* Names that open a `:::` container, matched without regard to case. A container with any other
+* name is ordinary text.
+*/
+var LOOMA_CONTAINER_NAMES = /* @__PURE__ */ new Set([
+	...LOOMA_CALLOUT_TONES,
+	"caution",
+	"details",
+	"figure",
+	"tabs",
+	"code-group"
+]);
+var ATTRIBUTE_KEY = /[A-Za-z][\w-]*/y;
+var ATTRIBUTE_ID = /#([\w-]+)/y;
+var ATTRIBUTE_VALUE = /[^\s"'=<>`{}]+/y;
+function sticky(pattern, source, index) {
+	pattern.lastIndex = index;
+	return pattern.exec(source);
+}
+/**
+* Reads a brace attribute list starting at `source[start]`, which must be `{`.
+* @contract Returns the attributes and the index just past the closing brace.
+* @failure Returns null for anything that is not a complete, well-formed list, so the text stays literal.
+*/
+function readLoomaAttributes(source, start = 0) {
+	if (source[start] !== "{") return null;
+	const attributes = {};
+	let index = start + 1;
+	for (;;) {
+		while (source[index] === " " || source[index] === "	") index++;
+		if (source[index] === "}") return {
+			attributes,
+			end: index + 1
+		};
+		if (index > start + 1 && !/\s/.test(source[index - 1])) return null;
+		const id = sticky(ATTRIBUTE_ID, source, index);
+		if (id) {
+			attributes.id = id[1];
+			index += id[0].length;
+			continue;
+		}
+		const key = sticky(ATTRIBUTE_KEY, source, index);
+		if (!key) return null;
+		index += key[0].length;
+		if (source[index] !== "=") {
+			attributes[key[0]] = true;
+			continue;
+		}
+		index++;
+		const quote = source[index];
+		if (quote === "\"" || quote === "'") {
+			const close = source.indexOf(quote, index + 1);
+			if (close < 0) return null;
+			attributes[key[0]] = source.slice(index + 1, close);
+			index = close + 1;
+			continue;
+		}
+		const value = sticky(ATTRIBUTE_VALUE, source, index);
+		if (!value) return null;
+		attributes[key[0]] = value[0];
+		index += value[0].length;
+	}
+}
+/**
+* Reads a whole string as one brace attribute list.
+* @failure Returns null unless the string is exactly one well-formed list.
+*/
+function parseLoomaAttributes(source) {
+	const read = readLoomaAttributes(source);
+	return read && read.end === source.length ? read.attributes : null;
+}
+/**
+* Writes attributes as a brace list, `id` first as `#id`, then the rest in order.
+* @contract `true` writes a bare key; values are quoted only when they need it. `false`, null and
+* undefined values are left out, and an empty set writes an empty string. An ID that `#` cannot
+* carry, or any ID when `hashId` is false, is written `id=…`.
+*/
+function formatLoomaAttributes(attributes, { hashId = true } = {}) {
+	const items = [];
+	const { id, ...rest } = attributes;
+	const hashed = hashId && typeof id === "string" && /^[\w-]+$/.test(id);
+	if (hashed) items.push(`#${id}`);
+	for (const [key, value] of Object.entries(hashed ? rest : attributes)) if (value === true) items.push(key);
+	else if (value === false || value === null || value === void 0) continue;
+	else {
+		const text = String(value);
+		items.push(/^[^\s"'=<>`{}]+$/.test(text) ? `${key}=${text}` : text.includes("\"") ? `${key}='${text}'` : `${key}="${text}"`);
+	}
+	return items.length ? `{${items.join(" ")}}` : "";
+}
+/**
+* The anchor a heading's text derives: NFC, lowercase, keeping letters, numbers and combining
+* marks, with every other run of characters one hyphen.
+* @failure Text with no letters or numbers, such as only emoji, derives `heading`.
+*/
+function loomaHeadingSlug(text) {
+	return text.normalize("NFC").toLowerCase().replace(/[^\p{L}\p{N}\p{M}]+/gu, "-").replace(/^-+|-+$/g, "") || "heading";
+}
+/**
+* Gives every heading of a document its anchor, in document order.
+* @contract A custom ID is kept unless an earlier heading already has it. Any other heading takes
+* its slug, or the slug's first free suffix (`-1`, `-2`…), never one a later custom ID reserves.
+*/
+function assignLoomaHeadingIds(headings) {
+	const reserved = new Set(headings.map(({ id }) => id).filter((id) => Boolean(id)));
+	const used = /* @__PURE__ */ new Set();
+	return headings.map(({ text, id: custom }) => {
+		let id = custom || loomaHeadingSlug(text);
+		if (custom ? used.has(id) : used.has(id) || reserved.has(id)) {
+			const stem = id;
+			let suffix = 1;
+			while (used.has(`${stem}-${suffix}`) || reserved.has(`${stem}-${suffix}`)) suffix++;
+			id = `${stem}-${suffix}`;
+		}
+		used.add(id);
+		return id;
+	});
+}
+/** Reads a fence's info string: ```` ```ts title="a.ts" {1,3-5} :line-numbers ````. */
+function parseLoomaFenceInfo(info) {
+	const source = info.trim();
+	const language = /^[^\s={:]+(?=[\s{:]|$)/.exec(source)?.[0];
+	const meta = (language ? source.slice(language.length) : source).trim();
+	const title = /(?:^|\s)title="([^"]*)"/.exec(meta)?.[1];
+	const rest = meta.replace(/(?:^|\s)title="[^"]*"/, "");
+	const lines = /* @__PURE__ */ new Set();
+	for (const range of /\{([\d\s,-]+)\}/.exec(rest)?.[1].split(",") ?? []) {
+		const [from = NaN, to = from] = range.split("-").map((part) => Number.parseInt(part, 10));
+		for (let line = from; line <= to; line++) lines.add(line);
+	}
+	const numbers = /:(no-)?line-numbers(?![\w-])/.exec(rest);
+	return {
+		...language ? { language } : {},
+		meta,
+		...title !== void 0 ? { title } : {},
+		lines: [...lines].sort((a, b) => a - b),
+		...numbers ? { lineNumbers: numbers[1] === void 0 } : {}
+	};
+}
+var MAPPING_KEY = /^(?:[^\s#:'"\-?,[\]{}&*!|>%@`][^:\n]*?|"[^"\n]*"|'[^'\n]*')[ \t]*:(?:[ \t]|$)/;
+var NOTATION = /[ \t]*(?:\/\/|#|--|<!--|\{?\/\*)[ \t]*\[!code highlight(?::(\d+))?\][ \t]*(?:-->|\*\/\}?)?[ \t]*$/;
+var ESCAPED_NOTATION = /\[\\(\\*!code highlight)/g;
+/**
+* Applies code notation: a line ending in a `[!code highlight]` comment is highlighted and loses
+* the comment, `[!code highlight:3]` covers three lines, and a marker alone on its line is removed
+* with the line and applies to the lines after it. A backslash between `[` and `!` escapes a
+* marker, `[\!code highlight]`, which then shows as text with one backslash fewer and highlights
+* nothing.
+* @contract Returns the code a reader sees and its highlighted line numbers, from 1, ascending.
+* ponytail: matched on source lines, so a string that ends in the marker counts too.
+*/
+function applyLoomaCodeNotation(code) {
+	const kept = [];
+	const lines = /* @__PURE__ */ new Set();
+	for (const line of code.split("\n")) {
+		const match = NOTATION.exec(line);
+		if (!match) {
+			kept.push(line);
+			continue;
+		}
+		const rest = line.slice(0, match.index);
+		const own = rest.trim() !== "";
+		if (own) kept.push(rest);
+		for (let count = 0; count < Number(match[1] ?? 1); count++) lines.add(kept.length + (own ? 0 : 1) + count);
+	}
+	return {
+		code: kept.join("\n").replace(ESCAPED_NOTATION, "[$1"),
+		lines: [...lines].sort((a, b) => a - b)
+	};
+}
+/**
+* Splits YAML front matter from the start of a document.
+* @contract Front matter opens with a `---` line at the very start and closes at a `---` or `...`
+* line, and what lies between is a YAML mapping: its first line that is not blank or a comment
+* starts with a key, whose value may be a scalar, a list or a mapping. `source` is the block as
+* written, delimiters included.
+* @failure Returns null when the document has none.
+*/
+function splitLoomaFrontmatter(document) {
+	const match = /^---[ \t]*\r?\n([\s\S]*?)\r?\n(?:---|\.\.\.)[ \t]*(?:\r?\n|$)/.exec(document.slice(0, 8192));
+	const first = match?.[1].split(/\r?\n/).find((line) => line.trim() && !line.trimStart().startsWith("#"));
+	if (!match || !first || !MAPPING_KEY.test(first)) return null;
+	return {
+		source: match[0].trimEnd(),
+		yaml: match[1],
+		body: document.slice(match[0].length)
+	};
+}
+/** The colons a container opens and closes with, given how deeply containers nest inside it. */
+function loomaContainerMarker(nestedDepth) {
+	return ":".repeat(3 + Math.max(0, nestedDepth));
+}
+/** A backtick fence longer than any run of backticks in the code, and at least three long. */
+function loomaCodeFence(code) {
+	const longest = Math.max(0, ...(code.match(/`+/g) ?? []).map((run) => run.length));
+	return "`".repeat(Math.max(3, longest + 1));
+}
+//#endregion
+export { assignLoomaHeadingIds as a, loomaContainerMarker as c, normalizeLoomaChipTone as d, parseLoomaAttributes as f, splitLoomaFrontmatter as h, applyLoomaCodeNotation as i, loomaHeadingSlug as l, readLoomaAttributes as m, LOOMA_CHIP_TONES as n, formatLoomaAttributes as o, parseLoomaFenceInfo as p, LOOMA_CONTAINER_NAMES as r, loomaCodeFence as s, LOOMA_CALLOUT_TONES as t, normalizeLoomaCalloutTone as u };

package/editor/expressmark.d.ts

@@ -0,0 +1,31 @@
+import type { JSONContent } from "@tiptap/core";
+import { type ConversionOptions, type Document } from "expressmark";
+/**
+ * A conversion cannot faithfully represent the named input at this document location.
+ * @failure Callers retain the original document and can report the unsupported feature and path.
+ */
+export declare class EditorMarkdownConversionError extends Error {
+    readonly path: string;
+    readonly feature: string;
+    constructor(path: string, feature: string);
+}
+/**
+ * Maps an editor's saved JSON to the independent Expressive Markdown AST without DOM access.
+ * @contract Unsupported nodes, marks and durable attributes throw with their location; input is never mutated.
+ */
+export declare function editorDocumentToExpressmark(document: JSONContent, options?: ConversionOptions): Document;
+/**
+ * Maps supported Expressive Markdown content into the Looma editor's saved JSON shape.
+ * @contract The editor schema cannot represent arbitrary format extensions; unsupported meanings fail explicitly.
+ */
+export declare function expressmarkToEditorDocument(document: Document): JSONContent;
+/**
+ * Writes an editor document using Expressmark's shared parser/writer and safe HTML policy.
+ * @failure Unsupported editor data raises EditorMarkdownConversionError before any input is changed.
+ */
+export declare function editorDocumentToMarkdown(document: JSONContent, options?: ConversionOptions): string;
+/**
+ * Parses Expressive Markdown into editable JSON for the supported editor schema.
+ * @failure Unsupported content or root metadata stops conversion instead of being silently flattened.
+ */
+export declare function markdownToEditorDocument(markdown: string, options?: ConversionOptions): JSONContent;