@orz/ui-markdown 0.0.0-stage → 0.1.0

package/dist/lib/markdown-processor.js

@@ -0,0 +1,35 @@
+import remarkFrontmatter from "remark-frontmatter";
+import remarkGfm from "remark-gfm";
+import remarkParse from "remark-parse";
+import { unified } from "unified";
+import { FRONTMATTER_FLAVOURS, remarkFrontmatterTable, } from "./remark-frontmatter-table.js";
+import { remarkRejectedUrlsAsText } from "./remark-rejected-urls.js";
+/**
+ * Static Markdown syntax shared by every parser and renderer.
+ *
+ * Keep runtime-dependent plugins (references, say) in the caller: their
+ * options belong to the app's context. Keeping
+ * this array at module scope also lets renderers retain plugin-list identity
+ * instead of rebuilding the invariant prefix on every render.
+ *
+ * The order is significant. Rejected URLs are restored to source text before
+ * later tokenizers see them, and `remarkFrontmatterTable` consumes the nodes
+ * produced by `remarkFrontmatter`. Without that tokenizer, frontmatter lines
+ * that begin with digits are parsed as ordered-list items (T-383).
+ */
+export const MARKDOWN_SYNTAX_PLUGINS = [
+    remarkGfm,
+    remarkRejectedUrlsAsText,
+    [remarkFrontmatter, FRONTMATTER_FLAVOURS],
+    remarkFrontmatterTable,
+];
+const processor = unified().use(remarkParse).use(MARKDOWN_SYNTAX_PLUGINS);
+/**
+ * `runSync`, not `parse` alone: `parse` stops at the tokenizer and runs no
+ * transformer, so `remarkFrontmatterTable` — which is one — would never fire
+ * and the caller would hold the `yaml` leaf while the DOM held a table.
+ */
+export function parseMarkdown(source) {
+    return processor.runSync(processor.parse(source), source);
+}
+//# sourceMappingURL=markdown-processor.js.map

package/dist/lib/markdown-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-processor.js","sourceRoot":"","sources":["../../src/lib/markdown-processor.ts"],"names":[],"mappings":"AACA,OAAO,iBAAiB,MAAM,oBAAoB,CAAC;AACnD,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAsB,OAAO,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkB;IACpD,SAAS;IACT,wBAAwB;IACxB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACzC,sBAAsB;CACvB,CAAC;AACF,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAU,CAAC;AACrE,CAAC"}

package/dist/lib/rehype-details.d.ts

@@ -0,0 +1,13 @@
+import type { Root } from "hast";
+/**
+ * Cut exactly two tags out of the escaping that raw HTML otherwise gets.
+ *
+ * react-markdown replaces every `raw` node with a text node holding its
+ * source, which is why an unsupported tag reaches the reader as the characters
+ * they typed. This plugin runs in the window before that, turns the literals
+ * of `MARKER` into elements it builds from constants, and leaves every other
+ * `raw` node exactly where it was — so the set of elements the document can
+ * hold grows by `details` and `summary` and by nothing else.
+ */
+export declare function rehypeDetails(): (tree: Root) => void;
+//# sourceMappingURL=rehype-details.d.ts.map

package/dist/lib/rehype-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-details.d.ts","sourceRoot":"","sources":["../../src/lib/rehype-details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,IAAI,EAAe,MAAM,MAAM,CAAC;AAmQvE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,WACb,IAAI,UA+BnB"}

package/dist/lib/rehype-details.js

@@ -0,0 +1,256 @@
+/**
+ * HTML whitespace, spelled out instead of `\s`: that class also matches NBSP
+ * and the Unicode space separators, and every character this recogniser
+ * accepts has to be one a reviewer can read off the grammar.
+ */
+const S = "[ \\t\\n\\f\\r]";
+/**
+ * The five literals the recogniser knows, and the whole of what it knows.
+ * Everything else — `<details class="x">`, `<details open="open">`,
+ * `<details/>`, `<detailsfoo>`, `< details>` — falls through untouched and
+ * reaches the reader as escaped source, which is what raw HTML has always
+ * done here.
+ *
+ * Alternatives rather than one pattern with an optional attribute, so that
+ * `open` is decided by *which literal matched* and never by reading the
+ * match: see `foldElement`.
+ */
+const MARKER = new RegExp([
+    `(?<detailsOpen><details${S}*>)`,
+    `(?<detailsOpenExpanded><details${S}+open${S}*>)`,
+    `(?<detailsClose></details${S}*>)`,
+    `(?<summaryOpen><summary${S}*>)`,
+    `(?<summaryClose></summary${S}*>)`,
+].join("|"), "gi");
+function isMarker(piece) {
+    return "marker" in piece;
+}
+/**
+ * The only path from a recognised literal to an element. Its arguments are the
+ * two constants the recogniser chose between; the matched source is not one of
+ * them and cannot be reached from in here. That is what makes "no byte of the
+ * document ever becomes an attribute value" a property of this signature
+ * rather than of how tightly the regex above is written — a regex loose enough
+ * to accept `<details onclick=x>` would still produce nothing but an empty
+ * `<details>`.
+ */
+function foldElement(tagName, open) {
+    return {
+        type: "element",
+        tagName,
+        properties: open ? { open: true } : {},
+        children: [],
+    };
+}
+/**
+ * Where `consumed` ends, counted from `start`. Lines come out exact wherever
+ * this is used, because a raw node's value holds one newline per source line
+ * it spans; columns and offsets are short by whatever a container strips off
+ * the front of each line (`> ` in a blockquote), and the fold, stamp and
+ * decoration passes all read lines.
+ */
+function advance(start, consumed) {
+    const lines = consumed.split("\n");
+    const breaks = lines.length - 1;
+    return {
+        line: start.line + breaks,
+        column: breaks === 0
+            ? start.column + consumed.length
+            : (lines[breaks]?.length ?? 0) + 1,
+        offset: start.offset === undefined ? undefined : start.offset + consumed.length,
+    };
+}
+function rawAt(value, start) {
+    if (start === undefined)
+        return { type: "raw", value };
+    return {
+        type: "raw",
+        value,
+        position: { start, end: advance(start, value) },
+    };
+}
+function kindOf(groups) {
+    if (groups.detailsClose !== undefined)
+        return "details-close";
+    if (groups.summaryOpen !== undefined)
+        return "summary-open";
+    if (groups.summaryClose !== undefined)
+        return "summary-close";
+    return "details-open";
+}
+/**
+ * One raw node cut into the literals it holds and the text between them, or
+ * null when it holds none — a node nothing matched keeps its identity, which
+ * is the same rule `<Markdown>` follows for its component map (T-60).
+ *
+ * Matching starts anywhere inside the value rather than at its front: a single
+ * raw node routinely carries a whole block of HTML, and
+ * `<details><summary>t</summary><script>alert(1)</script></details>` has to
+ * come apart into two elements and one string of escaped source.
+ */
+function splitRaw(node) {
+    MARKER.lastIndex = 0;
+    let match = MARKER.exec(node.value);
+    if (match === null)
+        return null;
+    const start = node.position?.start;
+    const pointAt = (index) => start === undefined
+        ? undefined
+        : index === 0
+            ? start
+            : advance(start, node.value.slice(0, index));
+    const pieces = [];
+    let consumed = 0;
+    while (match !== null) {
+        if (match.index > consumed) {
+            pieces.push(rawAt(node.value.slice(consumed, match.index), pointAt(consumed)));
+        }
+        const groups = match.groups ?? {};
+        const whole = match.index === 0 && match[0].length === node.value.length ? node : null;
+        pieces.push({
+            marker: kindOf(groups),
+            open: groups.detailsOpenExpanded !== undefined,
+            source: whole ?? rawAt(match[0], pointAt(match.index)),
+        });
+        consumed = match.index + match[0].length;
+        match = MARKER.exec(node.value);
+    }
+    if (consumed < node.value.length) {
+        pieces.push(rawAt(node.value.slice(consumed), pointAt(consumed)));
+    }
+    return pieces;
+}
+/** Every marker nothing paired with goes back to being raw, i.e. to source text. */
+function resolve(pieces) {
+    return pieces.map((piece) => (isMarker(piece) ? piece.source : piece));
+}
+function spanning(open, close) {
+    const start = open.position?.start;
+    const end = close.position?.end;
+    return start === undefined || end === undefined ? undefined : { start, end };
+}
+/** The `details-close` that matches the open marker at `from`; -1 for none. */
+function matchingClose(pieces, from) {
+    let depth = 0;
+    for (let i = from + 1; i < pieces.length; i++) {
+        const piece = pieces[i];
+        if (piece === undefined || !isMarker(piece))
+            continue;
+        if (piece.marker === "details-open")
+            depth++;
+        else if (piece.marker === "details-close") {
+            if (depth === 0)
+                return i;
+            depth--;
+        }
+    }
+    return -1;
+}
+/**
+ * The first `<summary>…</summary>` of a fold, as its own element. A second one
+ * in the same fold, and any that sits outside a fold altogether, keeps its
+ * markers and so reaches the reader as source — without this pass, a rejected
+ * `<details onclick=x>` would leave its `<summary>` behind as a stray element
+ * floating in the document, which is the one place "a rejected tag shows up
+ * whole, as text" would otherwise have an exception.
+ */
+function pairSummary(pieces) {
+    const open = pieces.findIndex((piece) => isMarker(piece) && piece.marker === "summary-open");
+    if (open < 0)
+        return pieces;
+    const close = pieces.findIndex((piece, i) => i > open && isMarker(piece) && piece.marker === "summary-close");
+    if (close < 0)
+        return pieces;
+    const openMarker = pieces[open];
+    const closeMarker = pieces[close];
+    if (openMarker === undefined ||
+        closeMarker === undefined ||
+        !isMarker(openMarker) ||
+        !isMarker(closeMarker)) {
+        return pieces;
+    }
+    const element = foldElement("summary", false);
+    element.children = resolve(pieces.slice(open + 1, close));
+    element.position = spanning(openMarker.source, closeMarker.source);
+    return [...pieces.slice(0, open), element, ...pieces.slice(close + 1)];
+}
+/**
+ * Pair the `details` literals of one children array, innermost pairs last.
+ * A marker whose partner sits in another parent — `<details>` opened in a list
+ * item and closed at the top level — finds nothing here and stays source.
+ */
+function pairDetails(pieces, made) {
+    const out = [];
+    for (let i = 0; i < pieces.length; i++) {
+        const piece = pieces[i];
+        if (piece === undefined)
+            continue;
+        if (!isMarker(piece) || piece.marker !== "details-open") {
+            out.push(piece);
+            continue;
+        }
+        const close = matchingClose(pieces, i);
+        const closeMarker = close < 0 ? undefined : pieces[close];
+        if (closeMarker === undefined || !isMarker(closeMarker)) {
+            out.push(piece);
+            continue;
+        }
+        const element = foldElement("details", piece.open);
+        element.children = resolve(pairSummary(pairDetails(pieces.slice(i + 1, close), made)));
+        element.position = spanning(piece.source, closeMarker.source);
+        made.add(element);
+        out.push(element);
+        i = close;
+    }
+    return out;
+}
+/**
+ * Where a fold may be recognised. `p` and the phrasing elements are absent on
+ * purpose: HTML forbids `<details>` inside `<p>`, and CommonMark gives only
+ * the block form a node of its own, so `a <details>b</details> c` is a line
+ * whose author meant those characters.
+ */
+const FLOW_PARENTS = new Set(["blockquote", "li", "td", "th"]);
+/**
+ * Cut exactly two tags out of the escaping that raw HTML otherwise gets.
+ *
+ * react-markdown replaces every `raw` node with a text node holding its
+ * source, which is why an unsupported tag reaches the reader as the characters
+ * they typed. This plugin runs in the window before that, turns the literals
+ * of `MARKER` into elements it builds from constants, and leaves every other
+ * `raw` node exactly where it was — so the set of elements the document can
+ * hold grows by `details` and `summary` and by nothing else.
+ */
+export function rehypeDetails() {
+    return (tree) => {
+        const made = new Set();
+        const visit = (parent, recognise) => {
+            if (recognise) {
+                const pieces = [];
+                let cut = false;
+                for (const child of parent.children) {
+                    const parts = child.type === "raw" ? splitRaw(child) : null;
+                    if (parts === null) {
+                        pieces.push(child);
+                        continue;
+                    }
+                    pieces.push(...parts);
+                    cut = true;
+                }
+                if (cut) {
+                    parent.children = resolve(pairDetails(pieces, made));
+                }
+            }
+            for (const child of parent.children) {
+                if (child.type !== "element")
+                    continue;
+                // A fold this pass built has had its own children paired already, and
+                // re-reading them would let a rejected literal that is now plain text
+                // pair with something it never stood beside.
+                visit(child, !made.has(child) && FLOW_PARENTS.has(child.tagName));
+            }
+        };
+        visit(tree, true);
+    };
+}
+//# sourceMappingURL=rehype-details.js.map

package/dist/lib/rehype-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-details.js","sourceRoot":"","sources":["../../src/lib/rehype-details.ts"],"names":[],"mappings":"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"}

package/dist/lib/rehype-source-lines.d.ts

@@ -0,0 +1,23 @@
+import type { Root } from "hast";
+export declare const SOURCE_LINE_ATTR = "data-loc";
+/**
+ * Where a code block's contents begin in the source (T-52). The stamped
+ * range starts at the opening fence for fenced blocks but at the first code
+ * line for indented ones; the renderer records the resolved start so
+ * selection anchoring can map a code renderer's per-line rows back to source lines
+ * without re-deriving markdown syntax.
+ */
+export declare const CODE_CONTENT_START_ATTR = "data-loc-content-start";
+/** `data-loc="start-end"` → 1-based inclusive source line range. */
+export declare function parseSourceLoc(value: string | null | undefined): {
+    start: number;
+    end: number;
+} | null;
+/**
+ * Rehype plugin stamping every block element with the markdown source line
+ * range it was rendered from. This is the whole bridge between "what the
+ * reader selected in the rendered document" and "which source lines the
+ * anchor stores" — remark/rehype keep positions intact, so no offset math.
+ */
+export declare function rehypeSourceLines(): (tree: Root) => void;
+//# sourceMappingURL=rehype-source-lines.d.ts.map

package/dist/lib/rehype-source-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-source-lines.d.ts","sourceRoot":"","sources":["../../src/lib/rehype-source-lines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAmC1C,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAEhE,oEAAoE;AACpE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,WACjB,IAAI,UAmBnB"}

package/dist/lib/rehype-source-lines.js

@@ -0,0 +1,77 @@
+/**
+ * Block-level tags that make useful annotation anchors. Inline elements are
+ * skipped: a selection maps to its closest block, which is the granularity
+ * an annotation anchors at.
+ *
+ * `tr` is on the list even though it nests inside `table` (T-142). A GFM
+ * table row is exactly one source line, so stamping rows is what lets one
+ * edited cell highlight its own row instead of washing the whole table
+ * green; the table keeps its stamp as the fallback for table-wide
+ * selections. Consumers resolve nesting by taking the innermost match.
+ *
+ * `details` is here for a second reason on top of that one (T-385): a reader
+ * who closes a fold leaves every annotation inside it with a zero rect, and
+ * whatever lays out marks beside them has to walk up the stamped ancestors to
+ * find something it can still measure — the fold's own header.
+ */
+const BLOCK_TAGS = new Set([
+    "p",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "li",
+    "pre",
+    "blockquote",
+    "details",
+    "table",
+    "tr",
+    "hr",
+]);
+export const SOURCE_LINE_ATTR = "data-loc";
+/**
+ * Where a code block's contents begin in the source (T-52). The stamped
+ * range starts at the opening fence for fenced blocks but at the first code
+ * line for indented ones; the renderer records the resolved start so
+ * selection anchoring can map a code renderer's per-line rows back to source lines
+ * without re-deriving markdown syntax.
+ */
+export const CODE_CONTENT_START_ATTR = "data-loc-content-start";
+/** `data-loc="start-end"` → 1-based inclusive source line range. */
+export function parseSourceLoc(value) {
+    if (!value)
+        return null;
+    const match = /^(\d+)-(\d+)$/.exec(value);
+    if (!match)
+        return null;
+    return { start: Number(match[1]), end: Number(match[2]) };
+}
+/**
+ * Rehype plugin stamping every block element with the markdown source line
+ * range it was rendered from. This is the whole bridge between "what the
+ * reader selected in the rendered document" and "which source lines the
+ * anchor stores" — remark/rehype keep positions intact, so no offset math.
+ */
+export function rehypeSourceLines() {
+    return (tree) => {
+        const visit = (node) => {
+            if (node.type === "element" &&
+                BLOCK_TAGS.has(node.tagName) &&
+                node.position?.start.line !== undefined &&
+                node.position.end.line !== undefined) {
+                node.properties[SOURCE_LINE_ATTR] =
+                    `${node.position.start.line}-${node.position.end.line}`;
+            }
+            if ("children" in node) {
+                for (const child of node.children) {
+                    if (child.type === "element")
+                        visit(child);
+                }
+            }
+        };
+        visit(tree);
+    };
+}
+//# sourceMappingURL=rehype-source-lines.js.map

package/dist/lib/rehype-source-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-source-lines.js","sourceRoot":"","sources":["../../src/lib/rehype-source-lines.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,YAAY;IACZ,SAAS;IACT,OAAO;IACP,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAEhE,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAC5B,KAAgC;IAEhC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,IAAU,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,CAAC,IAAoB,EAAE,EAAE;YACrC,IACE,IAAI,CAAC,IAAI,KAAK,SAAS;gBACvB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC5B,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS;gBACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,EACpC,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;oBAC/B,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC5D,CAAC;YACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;gBACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;wBAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/remark-frontmatter-table.d.ts

@@ -0,0 +1,119 @@
+import type { Parent, Root, Text } from "mdast";
+import type { Plugin } from "unified";
+/**
+ * The subtree a frontmatter block becomes (T-240). Registered with mdast below
+ * rather than cast into place, so a walker over the mdast tree narrows on
+ * these types the way it does on a table's.
+ */
+export interface Frontmatter extends Parent {
+    type: "frontmatter";
+    children: FrontmatterBody[];
+}
+export interface FrontmatterBody extends Parent {
+    type: "frontmatterBody";
+    children: FrontmatterFieldNode[];
+}
+export interface FrontmatterFieldNode extends Parent {
+    type: "frontmatterField";
+    children: Array<FrontmatterKey | FrontmatterValue>;
+}
+export interface FrontmatterKey extends Parent {
+    type: "frontmatterKey";
+    children: Text[];
+}
+export interface FrontmatterValue extends Parent {
+    type: "frontmatterValue";
+    children: Text[];
+}
+declare module "mdast" {
+    interface RootContentMap {
+        frontmatter: Frontmatter;
+        frontmatterBody: FrontmatterBody;
+        frontmatterField: FrontmatterFieldNode;
+        frontmatterKey: FrontmatterKey;
+        frontmatterValue: FrontmatterValue;
+        /**
+         * `remark-frontmatter`'s other flavour. Core mdast registers `yaml` and
+         * leaves this one to whoever turns TOML on.
+         */
+        toml: Omit<import("mdast").Yaml, "type"> & {
+            type: "toml";
+        };
+    }
+}
+/**
+ * One field of a frontmatter block: where its key and its value each sit in
+ * the source, as absolute half-open offsets. `key` is null for a line that has
+ * no key at all — TOML's `[section]`, or anything ahead of the first field.
+ */
+export type FrontmatterField = {
+    key: {
+        start: number;
+        end: number;
+    } | null;
+    value: {
+        start: number;
+        end: number;
+    };
+    /** 1-based source lines, inclusive; `endLine` grows with continuation lines. */
+    line: number;
+    endLine: number;
+};
+/**
+ * The flavours `remark-frontmatter` is switched on for. A module constant because it is passed as a
+ * plugin option, and a fresh array on every render is a fresh plugin list:
+ * react-markdown rebuilds the whole document, and a rebuilt text node
+ * collapses whatever selection was sitting in it (T-60).
+ */
+export declare const FRONTMATTER_FLAVOURS: Array<"yaml" | "toml">;
+/**
+ * Cut a frontmatter block into fields, one line at a time — deliberately not
+ * by parsing YAML (T-240).
+ *
+ * Decorating the rendered text by source offset rests on every rendered
+ * character sitting at a known source offset: a word-level highlight is mapped
+ * back onto the source by addition, a text node is entered only while its span
+ * and its value agree character for character, and a reader's line/column
+ * selection is turned into an offset. Parsing and rendering the
+ * *result* breaks all three at once — a key can be normalised, the order
+ * reshuffled, `~` spelled `null` — so what comes out of here is only ever a
+ * verbatim slice of the source. That is also what lets an annotation anchor on
+ * one key or one value, and what lets the page's own search find them.
+ *
+ * The price, stated where a reader will look for it: a `meta:` with indented
+ * children lands whole in one value cell, because a continuation line has
+ * nothing but its indentation to say it is one. `white-space: pre-wrap` on the
+ * cell keeps that readable; expanding a nested map into rows of its own needs
+ * real YAML semantics and is out of scope here.
+ */
+export declare function frontmatterFields(source: string, block: {
+    start: {
+        line: number;
+    };
+    end: {
+        line: number;
+    };
+}, sep: string): FrontmatterField[];
+/**
+ * remark plugin: swap each `yaml` / `toml` node for a two-column table of its
+ * fields (T-240). It consumes what `remark-frontmatter` produces, so it has to
+ * run after it.
+ *
+ * A table-shaped subtree rather than a bespoke one, because anything that
+ * already compares tables reads that shape: it knows `table` / `tableRow` /
+ * `tableCell`, pairs rows by their leftmost cell, and splices a removed row
+ * back where it stood. Frontmatter is a two-column table whose keys are the
+ * row keys, so nothing new has to be taught — the data is laid out at an
+ * entrance that exists.
+ *
+ * Custom node types plus `data.hName`, not real mdast `table` nodes: the
+ * `table` handler in `mdast-util-to-hast` makes row 0 a `<thead>` header, and
+ * frontmatter has no header — the first field would be drawn as one. `hName`
+ * renames an element after that handler has run and cannot undo what it did,
+ * so the unknown-node route is the only one that controls the output exactly.
+ * It also puts the `<tbody>` there explicitly, which is what keeps a pass
+ * that restores a removed field's stand-in row from appending it to the end of
+ * the table instead of into its body.
+ */
+export declare const remarkFrontmatterTable: Plugin<[], Root>;
+//# sourceMappingURL=remark-frontmatter-table.d.ts.map

package/dist/lib/remark-frontmatter-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-frontmatter-table.d.ts","sourceRoot":"","sources":["../../src/lib/remark-frontmatter-table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAQ,MAAM,EAAE,IAAI,EAAe,IAAI,EAAE,MAAM,OAAO,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKtC;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAgB,SAAQ,MAAM;IAC7C,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAClD,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,cAAc,GAAG,gBAAgB,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,IAAI,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAiB,SAAQ,MAAM;IAC9C,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,IAAI,EAAE,CAAC;CAClB;AAUD,OAAO,QAAQ,OAAO,CAAC;IACrB,UAAU,cAAc;QACtB,WAAW,EAAE,WAAW,CAAC;QACzB,eAAe,EAAE,eAAe,CAAC;QACjC,gBAAgB,EAAE,oBAAoB,CAAC;QACvC,cAAc,EAAE,cAAc,CAAC;QAC/B,gBAAgB,EAAE,gBAAgB,CAAC;QACnC;;;WAGG;QACH,IAAI,EAAE,IAAI,CAAC,OAAO,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7D;CACF;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3C,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAoB,CAAC;AAc7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACzD,GAAG,EAAE,MAAM,GACV,gBAAgB,EAAE,CAkDpB;AAkID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAgBnD,CAAC"}