@localix-ai/flowdown 0.0.0-stage → 0.5.0

package/dist/render/tree.js

@@ -0,0 +1,312 @@
+import "../dialect.js";
+import { normalizeUri } from "../engine/entities.js";
+// src/render/tree.ts
+/**
+* A Markdown tree as elements, for any target that has elements: the one place that says which
+* tag a node becomes, what a task list or a footnote is made of, and which URL is let through.
+*/
+/** The prefix on every id content makes, so it cannot stand in for one of the page's own. */
+const ID_PREFIX = "user-content-";
+const URL_PROPS = [
+	"href",
+	"src",
+	"cite",
+	"longDesc"
+];
+/** `dataCalloutTitle` as the attribute React writes: `data-callout-title`. */
+const attribute = (name) => name.length > 4 && name.startsWith("data") && name.charCodeAt(4) >= 65 && name.charCodeAt(4) <= 90 ? `data-${name.slice(4).replace(/[A-Z]/g, (letter, at) => (at > 0 ? "-" : "") + letter.toLowerCase())}` : name;
+/** A node's own element name and properties (`data.hName`, `data.hProperties`) over the default. */
+const own = (node, tag, props) => {
+	const data = node.data;
+	if (data === void 0) return [tag, props];
+	const name = typeof data.hName === "string" ? data.hName : tag;
+	const extra = data.hProperties;
+	if (extra === void 0) return [name, props];
+	const merged = props === null ? {} : { ...props };
+	for (const key in extra) {
+		const value = extra[key];
+		if (value === void 0 || value === null || value === false) continue;
+		if (key === "className") merged.className = Array.isArray(value) ? value.join(" ") : value;
+		else merged[attribute(key)] = value;
+	}
+	return [name, merged];
+};
+/**
+* The function that draws a tree with `factory`'s elements. Every call of it gives new elements;
+* the caller remembers them by the tree's text.
+*/
+const createRenderer = ({ element: h, text, fragment }) => (root, options) => {
+	const { components, urlTransform } = options;
+	const NEWLINE = text("\n");
+	const SPACE = text(" ");
+	/**
+	* The URL the page's check lets through, or undefined when it refuses one: emptied, or no
+	* answer. An empty URL as written (`[a]()`) stays empty, the link CommonMark writes.
+	*/
+	const allowed = (url, key, node) => {
+		const checked = urlTransform(url, key, node);
+		return checked || (url === "" && checked === "" ? "" : void 0);
+	};
+	/** The page's component for an element the renderer writes itself, or the element. */
+	const pageTag = (name) => components[name] ?? name;
+	const element = (node, tag, props, children) => {
+		const [name, merged] = own(node, tag, props);
+		if (merged !== null && node.data?.hProperties !== void 0) {
+			for (const key of URL_PROPS) {
+				if (typeof merged[key] !== "string") continue;
+				const url = allowed(merged[key], key, node);
+				if (url === void 0) delete merged[key];
+				else merged[key] = url;
+			}
+			if (merged.innerHTML !== void 0) children = [];
+		}
+		const Page = components[name];
+		if (Page === void 0) return h(name, merged, children);
+		return h(Page, merged === null ? { node } : {
+			...merged,
+			node
+		}, children);
+	};
+	/** A run of text-level nodes. */
+	const inline = (nodes) => {
+		const out = [];
+		if (nodes !== void 0) for (const node of nodes) one(node, out, false);
+		return out;
+	};
+	/** A run of blocks, a line break between each: before the first and after the last as well when `around`. */
+	const blocks = (nodes, around) => {
+		const out = [];
+		if (nodes === void 0) return out;
+		if (around) out.push(NEWLINE);
+		for (let index = 0; index < nodes.length; index++) {
+			const node = nodes[index];
+			if (index > 0 && node.type !== "text" && nodes[index - 1].type !== "text") out.push(NEWLINE);
+			one(node, out, false);
+		}
+		if (around && nodes.length > 0) out.push(NEWLINE);
+		return out;
+	};
+	const item = (node, loose) => {
+		const children = node.children ?? [];
+		const out = [];
+		const task = typeof node.checked === "boolean";
+		const box = task ? h(pageTag("input"), {
+			type: "checkbox",
+			disabled: true,
+			"data-task-key": options.offset + (node.position?.start.offset ?? 0),
+			...node.checked ? { checked: true } : null
+		}, []) : null;
+		const first = children[0];
+		if (box !== null && (first === void 0 || first.type !== "paragraph" || first.data?.hName !== void 0)) {
+			if (loose) out.push(NEWLINE, h(pageTag("p"), null, [box]));
+			else out.push(box);
+		}
+		for (let index = 0; index < children.length; index++) {
+			const child = children[index];
+			const paragraph = child.type === "paragraph" && child.data?.hName === void 0;
+			if (loose || index !== 0 || !paragraph) out.push(NEWLINE);
+			if (paragraph) {
+				const words = inline(child.children);
+				if (box !== null && index === 0) {
+					if (words.length > 0) words.unshift(SPACE);
+					words.unshift(box);
+				}
+				if (loose) out.push(element(child, "p", null, words));
+				else out.push(...words);
+			} else one(child, out, false);
+		}
+		const last = children[children.length - 1];
+		if (last !== void 0 && (loose || last.type !== "paragraph" || last.data?.hName !== void 0)) out.push(NEWLINE);
+		return element(node, "li", task ? { className: "task-list-item" } : null, out);
+	};
+	const footnotes = (node) => {
+		const items = [NEWLINE];
+		const definitions = node.children ?? [];
+		for (let at = 0; at < definitions.length; at++) {
+			const definition = definitions[at];
+			const id = normalizeUri(definition.identifier ?? "");
+			const back = [];
+			for (let nth = 1; nth <= (definition.count ?? 1); nth++) {
+				const suffix = nth > 1 ? `-${nth}` : "";
+				if (nth > 1) back.push(SPACE);
+				back.push(h(pageTag("a"), {
+					href: `#${ID_PREFIX}fnref-${id}${suffix}`,
+					"data-footnote-backref": "",
+					"aria-label": `Back to reference ${definition.index}${suffix}`,
+					className: "data-footnote-backref"
+				}, nth > 1 ? [text("↩"), h(pageTag("sup"), null, [text(String(nth))])] : [text("↩")]));
+			}
+			const content = definition.children ?? [];
+			const body = [NEWLINE];
+			const tail = content[content.length - 1];
+			for (let index = 0; index < content.length; index++) {
+				const child = content[index];
+				if (index > 0) body.push(NEWLINE);
+				if (child === tail && child.type === "paragraph" && child.data?.hName === void 0) body.push(h(pageTag("p"), null, [
+					...inline(child.children),
+					SPACE,
+					...back
+				]));
+				else one(child, body, false);
+			}
+			if (tail === void 0 || tail.type !== "paragraph" || tail.data?.hName !== void 0) body.push(NEWLINE, ...back);
+			body.push(NEWLINE);
+			if (at > 0) items.push(NEWLINE);
+			items.push(h(pageTag("li"), { id: `${ID_PREFIX}fn-${id}` }, body));
+		}
+		items.push(NEWLINE);
+		return h(pageTag("section"), {
+			"data-footnotes": "",
+			className: "footnotes"
+		}, [
+			h(pageTag("h2"), {
+				className: "sr-only",
+				id: `${ID_PREFIX}footnote-label`
+			}, [text("Footnotes")]),
+			NEWLINE,
+			h(pageTag("ol"), null, items),
+			NEWLINE
+		]);
+	};
+	const one = (node, out, _tight) => {
+		switch (node.type) {
+			case "text":
+				out.push(text(node.value ?? ""));
+				return;
+			case "paragraph":
+				out.push(element(node, "p", null, inline(node.children)));
+				return;
+			case "heading": {
+				const id = options.headingIds?.get(options.offset + (node.position?.start.offset ?? 0));
+				out.push(element(node, `h${node.depth}`, id === void 0 ? null : { id }, inline(node.children)));
+				return;
+			}
+			case "emphasis":
+				out.push(element(node, "em", null, inline(node.children)));
+				return;
+			case "strong":
+				out.push(element(node, "strong", null, inline(node.children)));
+				return;
+			case "delete":
+				out.push(element(node, "del", null, inline(node.children)));
+				return;
+			case "inlineCode":
+				out.push(element(node, "code", null, [text((node.value ?? "").replace(/\r?\n|\r/g, " "))]));
+				return;
+			case "break":
+				out.push(element(node, "br", null, []), NEWLINE);
+				return;
+			case "link": {
+				const url = node.url ?? "";
+				const href = allowed(url, "href", node);
+				if (href === void 0 && node.children?.length === 1 && node.children[0]?.value === url) {
+					out.push(text(url));
+					return;
+				}
+				const props = href === void 0 ? {} : { href };
+				if (node.title) props.title = node.title;
+				out.push(element(node, "a", props, inline(node.children)));
+				return;
+			}
+			case "image": {
+				const src = allowed(node.url ?? "", "src", node);
+				const props = src ? {
+					src,
+					alt: node.alt ?? ""
+				} : { alt: node.alt ?? "" };
+				if (node.title) props.title = node.title;
+				out.push(element(node, "img", props, []));
+				return;
+			}
+			case "thematicBreak":
+				out.push(element(node, "hr", null, []));
+				return;
+			case "blockquote":
+				out.push(element(node, "blockquote", null, blocks(node.children, true)));
+				return;
+			case "code": {
+				const language = node.lang;
+				if (language === "mermaid" || language === "tree") {
+					const drawn = options.special(language, (node.value ?? "").replace(/\n$/, ""));
+					if (drawn !== void 0) {
+						out.push(drawn);
+						return;
+					}
+				}
+				const code = element(node, "code", language ? { className: `language-${language}` } : null, [text(node.value ?? "")]);
+				const Pre = components.pre;
+				out.push(Pre === void 0 ? h("pre", null, [code]) : h(Pre, { node }, [code]));
+				return;
+			}
+			case "list": {
+				const children = node.children ?? [];
+				let loose = node.spread === true;
+				let tasks = false;
+				for (const child of children) {
+					if (child.spread === true) loose = true;
+					if (typeof child.checked === "boolean") tasks = true;
+				}
+				const props = {};
+				if (node.ordered && typeof node.start === "number" && node.start !== 1) props.start = node.start;
+				if (tasks) props.className = "contains-task-list";
+				const rows = [NEWLINE];
+				for (let index = 0; index < children.length; index++) {
+					if (index > 0) rows.push(NEWLINE);
+					rows.push(item(children[index], loose));
+				}
+				if (children.length > 0) rows.push(NEWLINE);
+				out.push(element(node, node.ordered ? "ol" : "ul", props, rows));
+				return;
+			}
+			case "listItem":
+				out.push(item(node, node.spread === true));
+				return;
+			case "table": {
+				const rows = node.children ?? [];
+				const align = node.align ?? [];
+				const row = (from, header) => element(from, "tr", null, (from.children ?? []).map((cell, index) => element(cell, header ? "th" : "td", align[index] ? { style: { textAlign: align[index] } } : null, inline(cell.children))));
+				const parts = [];
+				const head = rows[0];
+				if (head !== void 0) parts.push(h(pageTag("thead"), null, [row(head, true)]));
+				if (rows.length > 1) parts.push(h(pageTag("tbody"), null, rows.slice(1).map((from) => row(from, false))));
+				out.push(element(node, "table", null, parts));
+				return;
+			}
+			case "footnoteReference": {
+				const id = normalizeUri(node.identifier ?? "");
+				const nth = (node.occurrence ?? 1) > 1 ? `-${node.occurrence}` : "";
+				out.push(h(pageTag("sup"), null, [h(pageTag("a"), {
+					href: `#${ID_PREFIX}fn-${id}`,
+					id: `${ID_PREFIX}fnref-${id}${nth}`,
+					"data-footnote-ref": "",
+					"aria-describedby": `${ID_PREFIX}footnote-label`
+				}, [text(String(node.index))])]));
+				return;
+			}
+			case "footnotes":
+				out.push(footnotes(node));
+				return;
+			case "html": return;
+			case "root":
+				out.push(...blocks(node.children, false));
+				return;
+			default: {
+				const children = node.children === void 0 ? node.value === void 0 ? [] : [text(node.value)] : mixed(node.children);
+				if (typeof node.data?.hName === "string") out.push(element(node, "div", null, children));
+				else out.push(...children);
+			}
+		}
+	};
+	/** The children of an element the tree does not know: blocks or text, as they come. */
+	const mixed = (nodes) => {
+		const out = [];
+		for (const node of nodes) one(node, out, false);
+		return out;
+	};
+	const out = [];
+	one(root, out, false);
+	return fragment(out);
+};
+export { ID_PREFIX, createRenderer };
+
+//# sourceMappingURL=tree.js.map

package/dist/render/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","names":[],"sources":["../../src/render/tree.ts"],"sourcesContent":["/**\n * A Markdown tree as elements, for any target that has elements: the one place that says which\n * tag a node becomes, what a task list or a footnote is made of, and which URL is let through.\n */\nimport { DIAGRAM_FENCE_LANGUAGE, TREE_FENCE_LANGUAGE } from '../dialect'\nimport { normalizeUri } from '../engine/entities'\nimport type { Node } from '../engine/types'\nimport type { UrlTransform } from '../engine/url'\nimport type { Factory, Props } from './factory'\n\n/** A page's own element for a tag: it gets the tag's properties, and the node it draws as `node`. */\nexport type Components<C> = Record<string, C | undefined>\n\nexport interface RenderOptions<E, C> {\n  components: Components<C>\n  urlTransform: UrlTransform\n  /** Where the tree's text starts in the document: task boxes and headings are keyed by it. */\n  offset: number\n  /** Ids for the headings, by where each starts in the document. */\n  headingIds: ReadonlyMap<number, string> | null\n  /** A ```mermaid or ```tree fence, drawn by the page that asked for one. */\n  special: (language: string, source: string) => E | undefined\n}\n\n/** The prefix on every id content makes, so it cannot stand in for one of the page's own. */\nexport const ID_PREFIX = 'user-content-'\n\nconst URL_PROPS = ['href', 'src', 'cite', 'longDesc'] as const\n\n/** `dataCalloutTitle` as the attribute React writes: `data-callout-title`. */\nconst attribute = (name: string): string =>\n  name.length > 4 && name.startsWith('data') && name.charCodeAt(4) >= 65 && name.charCodeAt(4) <= 90\n    ? `data-${name.slice(4).replace(/[A-Z]/g, (letter, at: number) => (at > 0 ? '-' : '') + letter.toLowerCase())}`\n    : name\n\n/** A node's own element name and properties (`data.hName`, `data.hProperties`) over the default. */\nconst own = (node: Node, tag: string, props: Props | null): [string, Props | null] => {\n  const data = node.data\n  if (data === undefined) return [tag, props]\n  const name = typeof data.hName === 'string' ? data.hName : tag\n  const extra = data.hProperties as Props | undefined\n  if (extra === undefined) return [name, props]\n  const merged: Props = props === null ? {} : { ...props }\n  for (const key in extra) {\n    const value = extra[key]\n    if (value === undefined || value === null || value === false) continue\n    if (key === 'className') merged.className = Array.isArray(value) ? value.join(' ') : value\n    else merged[attribute(key)] = value\n  }\n  return [name, merged]\n}\n\n/**\n * The function that draws a tree with `factory`'s elements. Every call of it gives new elements;\n * the caller remembers them by the tree's text.\n */\nexport const createRenderer =\n  <E, C>({ element: h, text, fragment }: Factory<E, C>) =>\n  (root: Node, options: RenderOptions<E, C>): E => {\n    const { components, urlTransform } = options\n    const NEWLINE = text('\\n')\n    const SPACE = text(' ')\n    /**\n     * The URL the page's check lets through, or undefined when it refuses one: emptied, or no\n     * answer. An empty URL as written (`[a]()`) stays empty, the link CommonMark writes.\n     */\n    const allowed = (url: string, key: string, node: Node): string | undefined => {\n      const checked = urlTransform(url, key, node)\n      return checked || (url === '' && checked === '' ? '' : undefined)\n    }\n    /** The page's component for an element the renderer writes itself, or the element. */\n    const pageTag = (name: string): string | C => components[name] ?? name\n\n    const element = (node: Node, tag: string, props: Props | null, children: E[]): E => {\n      const [name, merged] = own(node, tag, props)\n      if (merged !== null && node.data?.hProperties !== undefined) {\n        // An element an extension made: its URLs pass the page's check like a link's or an image's,\n        // and one refused is dropped, not left as an empty attribute.\n        for (const key of URL_PROPS) {\n          if (typeof merged[key] !== 'string') continue\n          const url = allowed(merged[key] as string, key, node)\n          if (url === undefined) delete merged[key]\n          else merged[key] = url\n        }\n        // An element given its HTML has no children of its own.\n        if (merged.innerHTML !== undefined) children = []\n      }\n      const Page = components[name]\n      if (Page === undefined) return h(name, merged, children)\n      return h(Page, merged === null ? { node } : { ...merged, node }, children)\n    }\n\n    /** A run of text-level nodes. */\n    const inline = (nodes: Node[] | undefined): E[] => {\n      const out: E[] = []\n      if (nodes !== undefined) for (const node of nodes) one(node, out, false)\n      return out\n    }\n\n    /** A run of blocks, a line break between each: before the first and after the last as well when `around`. */\n    const blocks = (nodes: Node[] | undefined, around: boolean): E[] => {\n      const out: E[] = []\n      if (nodes === undefined) return out\n      if (around) out.push(NEWLINE)\n      for (let index = 0; index < nodes.length; index++) {\n        const node = nodes[index] as Node\n        // Text among blocks is what raw HTML left there, with its own line breaks.\n        if (index > 0 && node.type !== 'text' && (nodes[index - 1] as Node).type !== 'text')\n          out.push(NEWLINE)\n        one(node, out, false)\n      }\n      if (around && nodes.length > 0) out.push(NEWLINE)\n      return out\n    }\n\n    const item = (node: Node, loose: boolean): E => {\n      const children = node.children ?? []\n      const out: E[] = []\n      const task = typeof node.checked === 'boolean'\n      const box = task\n        ? h(\n            pageTag('input'),\n            {\n              type: 'checkbox',\n              disabled: true,\n              'data-task-key': options.offset + (node.position?.start.offset ?? 0),\n              ...(node.checked ? { checked: true } : null),\n            },\n            [],\n          )\n        : null\n      const first = children[0]\n      // A task's box opens the item's first paragraph, or stands as one when there is none.\n      if (\n        box !== null &&\n        (first === undefined || first.type !== 'paragraph' || first.data?.hName !== undefined)\n      ) {\n        if (loose) out.push(NEWLINE, h(pageTag('p'), null, [box]))\n        else out.push(box)\n      }\n      for (let index = 0; index < children.length; index++) {\n        const child = children[index] as Node\n        const paragraph = child.type === 'paragraph' && child.data?.hName === undefined\n        if (loose || index !== 0 || !paragraph) out.push(NEWLINE)\n        if (paragraph) {\n          const words = inline(child.children)\n          if (box !== null && index === 0) {\n            if (words.length > 0) words.unshift(SPACE)\n            words.unshift(box)\n          }\n          if (loose) out.push(element(child, 'p', null, words))\n          else out.push(...words)\n        } else one(child, out, false)\n      }\n      const last = children[children.length - 1]\n      if (\n        last !== undefined &&\n        (loose || last.type !== 'paragraph' || last.data?.hName !== undefined)\n      )\n        out.push(NEWLINE)\n      return element(node, 'li', task ? { className: 'task-list-item' } : null, out)\n    }\n\n    const footnotes = (node: Node): E => {\n      const items: E[] = [NEWLINE]\n      const definitions = node.children ?? []\n      for (let at = 0; at < definitions.length; at++) {\n        const definition = definitions[at] as Node\n        const id = normalizeUri(definition.identifier ?? '')\n        const back: E[] = []\n        for (let nth = 1; nth <= (definition.count ?? 1); nth++) {\n          const suffix = nth > 1 ? `-${nth}` : ''\n          if (nth > 1) back.push(SPACE)\n          back.push(\n            h(\n              pageTag('a'),\n              {\n                href: `#${ID_PREFIX}fnref-${id}${suffix}`,\n                'data-footnote-backref': '',\n                'aria-label': `Back to reference ${definition.index}${suffix}`,\n                className: 'data-footnote-backref',\n              },\n              nth > 1 ? [text('↩'), h(pageTag('sup'), null, [text(String(nth))])] : [text('↩')],\n            ),\n          )\n        }\n        const content = definition.children ?? []\n        const body: E[] = [NEWLINE]\n        const tail = content[content.length - 1]\n        for (let index = 0; index < content.length; index++) {\n          const child = content[index] as Node\n          if (index > 0) body.push(NEWLINE)\n          if (child === tail && child.type === 'paragraph' && child.data?.hName === undefined)\n            body.push(h(pageTag('p'), null, [...inline(child.children), SPACE, ...back]))\n          else one(child, body, false)\n        }\n        if (tail === undefined || tail.type !== 'paragraph' || tail.data?.hName !== undefined)\n          body.push(NEWLINE, ...back)\n        body.push(NEWLINE)\n        if (at > 0) items.push(NEWLINE)\n        items.push(h(pageTag('li'), { id: `${ID_PREFIX}fn-${id}` }, body))\n      }\n      items.push(NEWLINE)\n      return h(pageTag('section'), { 'data-footnotes': '', className: 'footnotes' }, [\n        h(pageTag('h2'), { className: 'sr-only', id: `${ID_PREFIX}footnote-label` }, [\n          text('Footnotes'),\n        ]),\n        NEWLINE,\n        h(pageTag('ol'), null, items),\n        NEWLINE,\n      ])\n    }\n\n    const one = (node: Node, out: E[], _tight: boolean): void => {\n      switch (node.type) {\n        case 'text':\n          out.push(text(node.value ?? ''))\n          return\n        case 'paragraph':\n          out.push(element(node, 'p', null, inline(node.children)))\n          return\n        case 'heading': {\n          const id = options.headingIds?.get(options.offset + (node.position?.start.offset ?? 0))\n          out.push(\n            element(\n              node,\n              `h${node.depth}`,\n              id === undefined ? null : { id },\n              inline(node.children),\n            ),\n          )\n          return\n        }\n        case 'emphasis':\n          out.push(element(node, 'em', null, inline(node.children)))\n          return\n        case 'strong':\n          out.push(element(node, 'strong', null, inline(node.children)))\n          return\n        case 'delete':\n          out.push(element(node, 'del', null, inline(node.children)))\n          return\n        case 'inlineCode':\n          out.push(\n            element(node, 'code', null, [text((node.value ?? '').replace(/\\r?\\n|\\r/g, ' '))]),\n          )\n          return\n        case 'break':\n          out.push(element(node, 'br', null, []), NEWLINE)\n          return\n        case 'link': {\n          const url = node.url ?? ''\n          const href = allowed(url, 'href', node)\n          // A bare address the page refuses to link (`ftp://…`) stays the text it was written as.\n          if (\n            href === undefined &&\n            node.children?.length === 1 &&\n            node.children[0]?.value === url\n          ) {\n            out.push(text(url))\n            return\n          }\n          // A refused URL leaves the link without an `href`: an empty one would link to the page.\n          const props: Props = href === undefined ? {} : { href }\n          if (node.title) props.title = node.title\n          out.push(element(node, 'a', props, inline(node.children)))\n          return\n        }\n        case 'image': {\n          // A refused or empty source is left off: `src=\"\"` makes a browser fetch the page again.\n          const src = allowed(node.url ?? '', 'src', node)\n          const props: Props = src ? { src, alt: node.alt ?? '' } : { alt: node.alt ?? '' }\n          if (node.title) props.title = node.title\n          out.push(element(node, 'img', props, []))\n          return\n        }\n        case 'thematicBreak':\n          out.push(element(node, 'hr', null, []))\n          return\n        case 'blockquote':\n          out.push(element(node, 'blockquote', null, blocks(node.children, true)))\n          return\n        case 'code': {\n          const language = node.lang\n          if (language === DIAGRAM_FENCE_LANGUAGE || language === TREE_FENCE_LANGUAGE) {\n            const drawn = options.special(language, (node.value ?? '').replace(/\\n$/, ''))\n            if (drawn !== undefined) {\n              out.push(drawn)\n              return\n            }\n          }\n          const code = element(\n            node,\n            'code',\n            language ? { className: `language-${language}` } : null,\n            [text(node.value ?? '')],\n          )\n          const Pre = components.pre\n          out.push(Pre === undefined ? h('pre', null, [code]) : h(Pre, { node }, [code]))\n          return\n        }\n        case 'list': {\n          const children = node.children ?? []\n          let loose = node.spread === true\n          let tasks = false\n          for (const child of children) {\n            if (child.spread === true) loose = true\n            if (typeof child.checked === 'boolean') tasks = true\n          }\n          const props: Props = {}\n          if (node.ordered && typeof node.start === 'number' && node.start !== 1)\n            props.start = node.start\n          if (tasks) props.className = 'contains-task-list'\n          const rows: E[] = [NEWLINE]\n          for (let index = 0; index < children.length; index++) {\n            if (index > 0) rows.push(NEWLINE)\n            rows.push(item(children[index] as Node, loose))\n          }\n          if (children.length > 0) rows.push(NEWLINE)\n          out.push(element(node, node.ordered ? 'ol' : 'ul', props, rows))\n          return\n        }\n        case 'listItem':\n          out.push(item(node, node.spread === true))\n          return\n        case 'table': {\n          const rows = node.children ?? []\n          const align = node.align ?? []\n          const row = (from: Node, header: boolean): E =>\n            element(\n              from,\n              'tr',\n              null,\n              (from.children ?? []).map((cell, index) =>\n                element(\n                  cell,\n                  header ? 'th' : 'td',\n                  align[index] ? { style: { textAlign: align[index] } } : null,\n                  inline(cell.children),\n                ),\n              ),\n            )\n          const parts: E[] = []\n          const head = rows[0]\n          if (head !== undefined) parts.push(h(pageTag('thead'), null, [row(head, true)]))\n          if (rows.length > 1)\n            parts.push(\n              h(\n                pageTag('tbody'),\n                null,\n                rows.slice(1).map((from) => row(from, false)),\n              ),\n            )\n          out.push(element(node, 'table', null, parts))\n          return\n        }\n        case 'footnoteReference': {\n          const id = normalizeUri(node.identifier ?? '')\n          const nth = (node.occurrence ?? 1) > 1 ? `-${node.occurrence}` : ''\n          out.push(\n            h(pageTag('sup'), null, [\n              h(\n                pageTag('a'),\n                {\n                  href: `#${ID_PREFIX}fn-${id}`,\n                  id: `${ID_PREFIX}fnref-${id}${nth}`,\n                  'data-footnote-ref': '',\n                  'aria-describedby': `${ID_PREFIX}footnote-label`,\n                },\n                [text(String(node.index))],\n              ),\n            ]),\n          )\n          return\n        }\n        case 'footnotes':\n          out.push(footnotes(node))\n          return\n        case 'html':\n          // Raw HTML is drawn only once the HTML stage has made elements of it.\n          return\n        case 'root':\n          out.push(...blocks(node.children, false))\n          return\n        default: {\n          // An extension's node: drawn by the element it names for itself, or as its children.\n          const children =\n            node.children === undefined\n              ? node.value === undefined\n                ? []\n                : [text(node.value)]\n              : mixed(node.children)\n          if (typeof node.data?.hName === 'string') out.push(element(node, 'div', null, children))\n          else out.push(...children)\n        }\n      }\n    }\n\n    /** The children of an element the tree does not know: blocks or text, as they come. */\n    const mixed = (nodes: Node[]): E[] => {\n      const out: E[] = []\n      for (const node of nodes) one(node, out, false)\n      return out\n    }\n\n    const out: E[] = []\n    one(root, out, false)\n    return fragment(out)\n  }\n"],"mappings":"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"}

package/dist/render/view.d.ts

@@ -0,0 +1,55 @@
+import { Extension } from "../engine/types.js";
+import { UrlTransform } from "../engine/url.js";
+import { LabelOverrides } from "./labels.js";
+import { Highlighter } from "./views.js";
+import { VComponent, VNode } from "./vnode.js";
+/** Your own elements for any tag (`a`, `img`, `pre`, `table`, …) or the dialect's. */
+export type ViewComponents = Record<string, VComponent | undefined>;
+export interface ViewOptions {
+  components?: ViewComponents;
+  /** Your own drawing of a ```mermaid fence; `growing` while the fence is still being written. */
+  diagram?: (source: string, growing: boolean) => VNode;
+  /** Your own drawing of a ```tree fence. */
+  tree?: (source: string) => VNode;
+  /** Your own syntax, after the dialect's (`Extension`). */
+  extensions?: Extension[];
+  /** Give headings ids (`setup`, `setup-1`) to link to. */
+  headingIds?: boolean;
+  /** Raw HTML in the text, parsed and sanitized: `@localix-ai/flowdown/html`. Without it the tags are left out. */
+  html?: Extension | null;
+  /** Typeset `$…$`: `@localix-ai/flowdown/math`. */
+  math?: Extension | null;
+  /** Highlight fenced code: `@localix-ai/flowdown/highlight`, or your own. */
+  highlight?: Highlighter | null;
+  /** The words the renderer adds (callout names, button labels), for a page in another language. */
+  labels?: LabelOverrides;
+  /** Rewrite or refuse a link or image URL; by default only safe protocols are kept. */
+  urlTransform?: UrlTransform | null;
+  className?: string;
+  /** Leaves the `flowdown` class off the root element, so the package's stylesheet does not apply. */
+  unstyled?: boolean;
+  /** The caret after streaming text; on by default while streaming. */
+  caret?: boolean;
+  /**
+   * What the ids of a `[!TABS]` form's tabs and panels start with. Two documents on one page need
+   * two prefixes; `@localix-ai/flowdown/dom` gives each of its own.
+   */
+  idPrefix?: string;
+  /** The page the view is drawn on: with one, its tabs, trees and buttons answer the reader. */
+  host?: ViewHost;
+}
+/**
+ * What makes a view alive. A view drawn as HTML text has none, and its tabs, file trees and code
+ * buttons are drawn and nothing more; given one, they carry listeners (`onClick`, `onKeyDown`)
+ * that change what the view shows and ask the host to draw it again.
+ */
+export interface ViewHost {
+  /** Something the reader did changed what the document shows: draw it again, now. */
+  redraw(): void;
+  /** Put `text` on the clipboard; resolves whether it got there. */
+  copy(text: string): Promise<boolean>;
+  /** Save `text` as a file named after its fence's title, or its language. */
+  download(text: string, title: string | undefined, language: string | undefined): void;
+  /** The box of a table, each time it is drawn: a host that can measure makes a wide one scroll. */
+  table?(box: unknown): void;
+}