@connextar/house 0.1.1 → 0.2.0

package/dist/markdown/guide.js

@@ -0,0 +1,328 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Link } from "../internal/next-link.js";
+import { readTable, isTableStart } from "./table.js";
+import { MarkdownTableView } from "./table-view.js";
+const lines = (markdown) => markdown.replace(/\r\n/g, "\n").split("\n");
+const isFence = (line) => line.trim().startsWith("```");
+const isRule = (line) => /^(-{3,}|\*{3,}|_{3,})$/.test(line.trim());
+const isHeading = (line) => /^#{2,4}\s+/.test(line.trim());
+const isOrderedItem = (line) => /^\s*\d+\.\s+/.test(line);
+const isUnorderedItem = (line) => /^\s*[-*]\s+/.test(line);
+/** Split a raw guide into its title, lede and body. */
+export function parseGuideFrontmatter(markdown) {
+    const all = lines(markdown);
+    let i = 0;
+    let title = "";
+    let lede;
+    while (i < all.length && (all[i] ?? "").trim() === "")
+        i++;
+    if ((all[i] ?? "").startsWith("# ")) {
+        title = (all[i] ?? "")
+            .slice(2)
+            .trim()
+            .replace(/\s*[—-]\s*User Guide$/i, "");
+        i++;
+    }
+    while (i < all.length && (all[i] ?? "").trim() === "")
+        i++;
+    if ((all[i] ?? "").trim().startsWith(">")) {
+        const quote = [];
+        while (i < all.length && (all[i] ?? "").trim().startsWith(">")) {
+            quote.push((all[i] ?? "").trim().replace(/^>\s?/, ""));
+            i++;
+        }
+        lede = quote.join(" ").trim();
+    }
+    return { title, ...(lede === undefined ? {} : { lede }), body: all.slice(i).join("\n") };
+}
+/** Inline Markdown reduced to plain text, for structured data and search. */
+export function stripInline(text) {
+    return text
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+        .replace(/\*\*([^*]+)\*\*/g, "$1")
+        .replace(/\*([^*]+)\*/g, "$1")
+        .replace(/_([^_]+)_/g, "$1")
+        .replace(/`([^`]+)`/g, "$1")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** A heading's text as a URL fragment, before de-duplication. */
+export function headingSlug(text) {
+    return (stripInline(text)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "section");
+}
+/**
+ * Hands out unique fragments in document order: the second "Tips" is `tips-2`.
+ * The renderer and `extractHeadings` each take one, and both feed it exactly the
+ * `##` and `###` headings outside code fences — which is what keeps a contents
+ * link and the heading it points at in step.
+ */
+export function createHeadingIds() {
+    const seen = new Map();
+    return (text) => {
+        const base = headingSlug(text);
+        const count = seen.get(base) ?? 0;
+        seen.set(base, count + 1);
+        return count === 0 ? base : `${base}-${count + 1}`;
+    };
+}
+/** The `##` and `###` headings, in order, with the ids the renderer gives them. */
+export function extractHeadings(body) {
+    const nextId = createHeadingIds();
+    const headings = [];
+    let inFence = false;
+    for (const raw of lines(body)) {
+        if (isFence(raw)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const match = raw.trim().match(/^(#{2,3})\s+(.*)$/);
+        if (!match)
+            continue;
+        const source = match[2] ?? "";
+        headings.push({ id: nextId(source), text: stripInline(source), level: (match[1] ?? "").length });
+    }
+    return headings;
+}
+/**
+ * The `###` steps of a guide's "## Step by step" section as plain text, for
+ * HowTo structured data. Each step's text is its prose and list lines, capped
+ * so the schema stays lean. Empty when the guide has no such section.
+ */
+export function extractHowToSteps(body) {
+    const all = lines(body);
+    const start = all.findIndex((line) => /^##\s+Step by step\s*$/i.test(line.trim()));
+    if (start === -1)
+        return [];
+    let end = all.length;
+    for (let i = start + 1; i < all.length; i++) {
+        if (/^##\s+/.test((all[i] ?? "").trim())) {
+            end = i;
+            break;
+        }
+    }
+    const steps = [];
+    let current = null;
+    const flush = () => {
+        if (!current)
+            return;
+        const text = stripInline(current.parts.join(" "));
+        steps.push({ name: current.name, text: text.length > 320 ? `${text.slice(0, 317)}…` : text || current.name });
+        current = null;
+    };
+    for (let i = start + 1; i < end; i++) {
+        const line = (all[i] ?? "").trim();
+        const step = line.match(/^###\s+(.*)$/);
+        if (step) {
+            flush();
+            current = { name: stripInline(step[1] ?? ""), parts: [] };
+            continue;
+        }
+        if (!current || line === "" || line.startsWith(">"))
+            continue;
+        current.parts.push(line.replace(/^\s*([-*]|\d+\.)\s+/, ""));
+    }
+    flush();
+    return steps;
+}
+/**
+ * Where a link in a guide goes. `other-guide.md#part` becomes
+ * `/guides/other-guide#part`; same-site paths, fragments, `mailto:` and web
+ * addresses pass through; anything else — `javascript:`, `data:`, a
+ * protocol-relative `//host` — becomes `#`.
+ */
+export function resolveGuideHref(href, { guidesPath = "/guides", indexSlug } = {}) {
+    const guide = href.match(/^([\w-]+)\.md(#.*)?$/);
+    if (guide) {
+        const slug = guide[1] ?? "";
+        const hash = guide[2] ?? "";
+        return slug === indexSlug ? `${guidesPath}${hash}` : `${guidesPath}/${slug}${hash}`;
+    }
+    const samePath = href.startsWith("/") && !href.startsWith("//") && !href.startsWith("/\\");
+    if (samePath || href.startsWith("#") || href.startsWith("mailto:") || /^https?:\/\//i.test(href))
+        return href;
+    return "#";
+}
+/** The house look, on the shared theme tokens. */
+export const GUIDE_CLASS_NAMES = {
+    h2: "mt-12 scroll-mt-24 text-2xl font-bold tracking-tight text-foreground",
+    h3: "mt-8 scroll-mt-24 text-lg font-semibold text-foreground",
+    h4: "mt-6 text-base font-semibold text-foreground",
+    paragraph: "my-4 leading-relaxed text-muted-foreground",
+    blockquote: "my-6 border-l-4 border-primary/60 bg-card/60 py-3 pr-3 pl-4 text-muted-foreground italic",
+    orderedList: "my-4 ml-5 list-decimal space-y-2 text-muted-foreground marker:text-muted-foreground",
+    unorderedList: "my-4 ml-5 list-disc space-y-2 text-muted-foreground marker:text-muted-foreground",
+    listItem: "pl-1 leading-relaxed",
+    link: "font-medium text-primary hover:underline",
+    strong: "font-semibold text-foreground",
+    code: "rounded bg-muted px-1.5 py-0.5 font-mono text-[0.85em] text-foreground",
+    pre: "my-6 overflow-x-auto rounded-xl border border-border bg-muted/60 p-4 font-mono text-[0.85em] leading-relaxed text-foreground",
+    hr: "my-8 border-border",
+    table: {},
+};
+/** Render a guide body. */
+export function GuideMarkdown({ content, guidesPath, indexSlug, classNames }) {
+    const c = { ...GUIDE_CLASS_NAMES, ...classNames };
+    // `table` is itself a set of parts, so an override of one part keeps the rest.
+    c.table = { ...GUIDE_CLASS_NAMES.table, ...classNames?.table };
+    const linkOptions = {
+        ...(guidesPath === undefined ? {} : { guidesPath }),
+        ...(indexSlug === undefined ? {} : { indexSlug }),
+    };
+    const inline = (text, keyPrefix) => renderInline(text, keyPrefix, c, linkOptions);
+    const all = lines(content);
+    const nextId = createHeadingIds();
+    const blocks = [];
+    let i = 0;
+    let key = 0;
+    /** A line that ends the paragraph or list item before it. */
+    const startsBlock = (at) => {
+        const line = all[at] ?? "";
+        const trimmed = line.trim();
+        return (trimmed === "" ||
+            isHeading(line) ||
+            trimmed.startsWith(">") ||
+            isRule(line) ||
+            isFence(line) ||
+            isTableStart(all, at));
+    };
+    /** A list: each item, with any wrapped lines that follow it folded in. */
+    const readList = (isItem, marker) => {
+        const items = [];
+        while (i < all.length && isItem(all[i] ?? "")) {
+            let item = (all[i] ?? "").replace(marker, "");
+            i++;
+            while (i < all.length && !startsBlock(i) && !isOrderedItem(all[i] ?? "") && !isUnorderedItem(all[i] ?? "")) {
+                item += ` ${(all[i] ?? "").trim()}`;
+                i++;
+            }
+            items.push(item);
+        }
+        return items;
+    };
+    while (i < all.length) {
+        const line = all[i] ?? "";
+        const trimmed = line.trim();
+        if (trimmed === "") {
+            i++;
+            continue;
+        }
+        if (isRule(line)) {
+            blocks.push(_jsx("hr", { className: c.hr }, key++));
+            i++;
+            continue;
+        }
+        if (isFence(line)) {
+            const code = [];
+            i++;
+            while (i < all.length && !isFence(all[i] ?? "")) {
+                code.push(all[i] ?? "");
+                i++;
+            }
+            i++; // the closing fence; an unclosed one simply runs to the end
+            blocks.push(_jsx("pre", { className: c.pre, children: _jsx("code", { children: code.join("\n") }) }, key++));
+            continue;
+        }
+        const heading = trimmed.match(/^(#{2,4})\s+(.*)$/);
+        if (heading) {
+            const level = (heading[1] ?? "").length;
+            const source = heading[2] ?? "";
+            const nodes = inline(source, `h${key}`);
+            if (level === 2) {
+                blocks.push(_jsx("h2", { id: nextId(source), className: c.h2, children: nodes }, key++));
+            }
+            else if (level === 3) {
+                blocks.push(_jsx("h3", { id: nextId(source), className: c.h3, children: nodes }, key++));
+            }
+            else {
+                blocks.push(_jsx("h4", { className: c.h4, children: nodes }, key++));
+            }
+            i++;
+            continue;
+        }
+        if (trimmed.startsWith(">")) {
+            const quote = [];
+            while (i < all.length && (all[i] ?? "").trim().startsWith(">")) {
+                quote.push((all[i] ?? "").trim().replace(/^>\s?/, ""));
+                i++;
+            }
+            blocks.push(_jsx("blockquote", { className: c.blockquote, children: inline(quote.join(" "), `q${key}`) }, key++));
+            continue;
+        }
+        const table = readTable(all, i);
+        if (table) {
+            const tableKey = key++;
+            blocks.push(_jsx(MarkdownTableView, { table: table.table, classNames: c.table, renderCell: (text, cellKey) => inline(text, `t${tableKey}-${cellKey}`) }, tableKey));
+            i = table.next;
+            continue;
+        }
+        if (isOrderedItem(line)) {
+            const listKey = key++;
+            const items = readList(isOrderedItem, /^\s*\d+\.\s+/);
+            blocks.push(_jsx("ol", { className: c.orderedList, children: items.map((item, n) => (_jsx("li", { className: c.listItem, children: inline(item, `ol${listKey}-${n}`) }, n))) }, listKey));
+            continue;
+        }
+        if (isUnorderedItem(line)) {
+            const listKey = key++;
+            const items = readList(isUnorderedItem, /^\s*[-*]\s+/);
+            blocks.push(_jsx("ul", { className: c.unorderedList, children: items.map((item, n) => (_jsx("li", { className: c.listItem, children: inline(item, `ul${listKey}-${n}`) }, n))) }, listKey));
+            continue;
+        }
+        const paragraph = [];
+        while (i < all.length &&
+            !startsBlock(i) &&
+            (paragraph.length === 0 || (!isOrderedItem(all[i] ?? "") && !isUnorderedItem(all[i] ?? "")))) {
+            paragraph.push((all[i] ?? "").trim());
+            i++;
+        }
+        const paragraphKey = key++;
+        blocks.push(_jsx("p", { className: c.paragraph, children: inline(paragraph.join(" "), `p${paragraphKey}`) }, paragraphKey));
+    }
+    return _jsx(_Fragment, { children: blocks });
+}
+/** Bold, italic, code and links, as React nodes. Links are matched first so their text isn't parsed twice. */
+function renderInline(text, keyPrefix, c, linkOptions) {
+    const nodes = [];
+    const pattern = /(\[([^\]]+)\]\(([^)]+)\))|(\*\*([^*]+)\*\*)|(`([^`]+)`)|(\*([^*]+)\*)|(_([^_]+)_)/g;
+    let lastIndex = 0;
+    let n = 0;
+    for (let match = pattern.exec(text); match !== null; match = pattern.exec(text)) {
+        if (match.index > lastIndex)
+            nodes.push(text.slice(lastIndex, match.index));
+        const key = `${keyPrefix}-${n++}`;
+        if (match[1]) {
+            const href = resolveGuideHref(match[3] ?? "", linkOptions);
+            const label = match[2];
+            if (href.startsWith("/") || href.startsWith("#")) {
+                nodes.push(_jsx(Link, { href: href, className: c.link, children: label }, key));
+            }
+            else if (/^https?:\/\//i.test(href)) {
+                nodes.push(_jsx("a", { href: href, className: c.link, target: "_blank", rel: "noopener noreferrer", children: label }, key));
+            }
+            else {
+                nodes.push(_jsx("a", { href: href, className: c.link, children: label }, key));
+            }
+        }
+        else if (match[4]) {
+            nodes.push(_jsx("strong", { className: c.strong, children: match[5] }, key));
+        }
+        else if (match[6]) {
+            nodes.push(_jsx("code", { className: c.code, children: match[7] }, key));
+        }
+        else if (match[8]) {
+            nodes.push(_jsx("em", { children: match[9] }, key));
+        }
+        else if (match[10]) {
+            nodes.push(_jsx("em", { children: match[11] }, key));
+        }
+        lastIndex = pattern.lastIndex;
+    }
+    if (lastIndex < text.length)
+        nodes.push(text.slice(lastIndex));
+    return nodes;
+}
+//# sourceMappingURL=guide.js.map

package/dist/markdown/guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../src/markdown/guide.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAgC,MAAM,iBAAiB,CAAC;AA0ClF,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAChF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAChE,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5E,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACnE,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClE,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEnE,uDAAuD;AACvD,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,IAAwB,CAAC;IAE7B,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,CAAC,EAAE,CAAC;IAC3D,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACnB,KAAK,CAAC,CAAC,CAAC;aACR,IAAI,EAAE;aACN,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC,EAAE,CAAC;IACN,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,CAAC,EAAE,CAAC;IAC3D,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;YACvD,CAAC,EAAE,CAAC;QACN,CAAC;QACD,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI;SACR,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC;SACjC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC;SAC7B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CACL,WAAW,CAAC,IAAI,CAAC;SACd,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,SAAS,CACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1B,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,GAAG,CAAC,OAAO,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,OAAO;YAAE,SAAS;QACtB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAe,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACnF,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACzC,GAAG,GAAG,CAAC,CAAC;YACR,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,IAAI,OAAO,GAA6C,IAAI,CAAC;IAC7D,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9G,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACxC,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,EAAE,CAAC;YACR,OAAO,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YAC1D,SAAS;QACX,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC9D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,KAAK,CAAC;AACf,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,EAAE,UAAU,GAAG,SAAS,EAAE,SAAS,KAAuB,EAAE;IACzG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACjD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;IACtF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3F,IAAI,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9G,OAAO,GAAG,CAAC;AACb,CAAC;AAoBD,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,EAAE,EAAE,sEAAsE;IAC1E,EAAE,EAAE,yDAAyD;IAC7D,EAAE,EAAE,8CAA8C;IAClD,SAAS,EAAE,4CAA4C;IACvD,UAAU,EAAE,0FAA0F;IACtG,WAAW,EAAE,qFAAqF;IAClG,aAAa,EAAE,kFAAkF;IACjG,QAAQ,EAAE,sBAAsB;IAChC,IAAI,EAAE,0CAA0C;IAChD,MAAM,EAAE,+BAA+B;IACvC,IAAI,EAAE,wEAAwE;IAC9E,GAAG,EAAE,8HAA8H;IACnI,EAAE,EAAE,oBAAoB;IACxB,KAAK,EAAE,EAAE;CACV,CAAC;AAOF,2BAA2B;AAC3B,MAAM,UAAU,aAAa,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAsB;IAC9F,MAAM,CAAC,GAAoB,EAAE,GAAG,iBAAiB,EAAE,GAAG,UAAU,EAAE,CAAC;IACnE,+EAA+E;IAC/E,CAAC,CAAC,KAAK,GAAG,EAAE,GAAG,iBAAiB,CAAC,KAAK,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/D,MAAM,WAAW,GAAG;QAClB,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;QACnD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;KAClD,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,6DAA6D;IAC7D,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,CACL,OAAO,KAAK,EAAE;YACd,SAAS,CAAC,IAAI,CAAC;YACf,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC;YACb,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CACtB,CAAC;IACJ,CAAC,CAAC;IAEF,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,CAAC,MAAiC,EAAE,MAAc,EAAE,EAAE;QACrE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9C,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC9C,CAAC,EAAE,CAAC;YACJ,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC3G,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpC,CAAC,EAAE,CAAC;YACN,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,aAAgB,SAAS,EAAE,CAAC,CAAC,EAAE,IAAtB,GAAG,EAAE,CAAqB,CAAC,CAAC;YACjD,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,CAAC,EAAE,CAAC;YACJ,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxB,CAAC,EAAE,CAAC;YACN,CAAC;YACD,CAAC,EAAE,CAAC,CAAC,4DAA4D;YACjE,MAAM,CAAC,IAAI,CACT,cAAiB,SAAS,EAAE,CAAC,CAAC,GAAG,YAC/B,yBAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAQ,IADtB,GAAG,EAAE,CAET,CACP,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACnD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CACT,aAAgB,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,YAChD,KAAK,IADC,GAAG,EAAE,CAET,CACN,CAAC;YACJ,CAAC;iBAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CACT,aAAgB,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,YAChD,KAAK,IADC,GAAG,EAAE,CAET,CACN,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CACT,aAAgB,SAAS,EAAE,CAAC,CAAC,EAAE,YAC5B,KAAK,IADC,GAAG,EAAE,CAET,CACN,CAAC;YACJ,CAAC;YACD,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/D,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;gBACvD,CAAC,EAAE,CAAC;YACN,CAAC;YACD,MAAM,CAAC,IAAI,CACT,qBAAwB,SAAS,EAAE,CAAC,CAAC,UAAU,YAC5C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,IADpB,GAAG,EAAE,CAET,CACd,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAChC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,KAAC,iBAAiB,IAEhB,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,UAAU,EAAE,CAAC,CAAC,KAAK,EACnB,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC,IAHjE,QAAQ,CAIb,CACH,CAAC;YACF,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QAED,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CACT,aAAkB,SAAS,EAAE,CAAC,CAAC,WAAW,YACvC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACtB,aAAY,SAAS,EAAE,CAAC,CAAC,QAAQ,YAC9B,MAAM,CAAC,IAAI,EAAE,KAAK,OAAO,IAAI,CAAC,EAAE,CAAC,IAD3B,CAAC,CAEL,CACN,CAAC,IALK,OAAO,CAMX,CACN,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;YACvD,MAAM,CAAC,IAAI,CACT,aAAkB,SAAS,EAAE,CAAC,CAAC,aAAa,YACzC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACtB,aAAY,SAAS,EAAE,CAAC,CAAC,QAAQ,YAC9B,MAAM,CAAC,IAAI,EAAE,KAAK,OAAO,IAAI,CAAC,EAAE,CAAC,IAD3B,CAAC,CAEL,CACN,CAAC,IALK,OAAO,CAMX,CACN,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,OACE,CAAC,GAAG,GAAG,CAAC,MAAM;YACd,CAAC,WAAW,CAAC,CAAC,CAAC;YACf,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAC5F,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC,EAAE,CAAC;QACN,CAAC;QACD,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CACT,YAAsB,SAAS,EAAE,CAAC,CAAC,SAAS,YACzC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,YAAY,EAAE,CAAC,IAD1C,YAAY,CAEhB,CACL,CAAC;IACJ,CAAC;IAED,OAAO,4BAAG,MAAM,GAAI,CAAC;AACvB,CAAC;AAED,8GAA8G;AAC9G,SAAS,YAAY,CAAC,IAAY,EAAE,SAAiB,EAAE,CAAkB,EAAE,WAA6B;IACtG,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,oFAAoF,CAAC;IACrG,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,KAAK,IAAI,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChF,IAAI,KAAK,CAAC,KAAK,GAAG,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,CAAC,EAAE,EAAE,CAAC;QAElC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CACR,KAAC,IAAI,IAAW,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,YAC1C,KAAK,IADG,GAAG,CAEP,CACR,CAAC;YACJ,CAAC;iBAAM,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CACR,YAAa,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAC,QAAQ,EAAC,GAAG,EAAC,qBAAqB,YAClF,KAAK,IADA,GAAG,CAEP,CACL,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CACR,YAAa,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,YACvC,KAAK,IADA,GAAG,CAEP,CACL,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CACR,iBAAkB,SAAS,EAAE,CAAC,CAAC,MAAM,YAClC,KAAK,CAAC,CAAC,CAAC,IADE,GAAG,CAEP,CACV,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CACR,eAAgB,SAAS,EAAE,CAAC,CAAC,IAAI,YAC9B,KAAK,CAAC,CAAC,CAAC,IADA,GAAG,CAEP,CACR,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,uBAAe,KAAK,CAAC,CAAC,CAAC,IAAd,GAAG,CAAiB,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,uBAAe,KAAK,CAAC,EAAE,CAAC,IAAf,GAAG,CAAkB,CAAC,CAAC;QAC7C,CAAC;QAED,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAChC,CAAC;IAED,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/markdown/index.d.ts

@@ -0,0 +1,4 @@
+export { createHeadingIds, extractHeadings, extractHowToSteps, GUIDE_CLASS_NAMES, GuideMarkdown, headingSlug, parseGuideFrontmatter, resolveGuideHref, stripInline, type GuideClassNames, type GuideHeading, type GuideLinkOptions, type GuideMarkdownProps, type HowToStep, type ParsedGuide, } from "./guide.js";
+export { alignmentOf, isTableRow, isTableSeparator, isTableStart, readTable, splitTableRow, type MarkdownTable, type TableAlign, } from "./table.js";
+export { MARKDOWN_TABLE_CLASS_NAMES, MarkdownTableView, type MarkdownTableClassNames } from "./table-view.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/markdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/markdown/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/markdown/index.js

@@ -0,0 +1,4 @@
+export { createHeadingIds, extractHeadings, extractHowToSteps, GUIDE_CLASS_NAMES, GuideMarkdown, headingSlug, parseGuideFrontmatter, resolveGuideHref, stripInline, } from "./guide.js";
+export { alignmentOf, isTableRow, isTableSeparator, isTableStart, readTable, splitTableRow, } from "./table.js";
+export { MARKDOWN_TABLE_CLASS_NAMES, MarkdownTableView } from "./table-view.js";
+//# sourceMappingURL=index.js.map

package/dist/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/markdown/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,GAOZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,aAAa,GAGd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAgC,MAAM,iBAAiB,CAAC"}

package/dist/markdown/table-view.d.ts

@@ -0,0 +1,28 @@
+import type { ReactNode } from "react";
+import type { MarkdownTable } from "./table.js";
+/** The parts of a table an app can restyle. Each replaces the default for that part. */
+export interface MarkdownTableClassNames {
+    wrapper: string;
+    table: string;
+    head: string;
+    headerCell: string;
+    row: string;
+    cell: string;
+}
+export declare const MARKDOWN_TABLE_CLASS_NAMES: MarkdownTableClassNames;
+/**
+ * A parsed Markdown table, drawn with the house token classes so it takes the
+ * host app's look. Cells arrive as Markdown text; `renderCell` is the host
+ * renderer's own inline pass (bold, code, links), so a table cell reads exactly
+ * like the prose around it and link rewriting stays the app's business.
+ *
+ * An app whose theme has no tokens (a plain Tailwind palette) passes
+ * `classNames`. Server-safe: no hooks, no client boundary.
+ */
+export declare function MarkdownTableView({ table, renderCell, className, classNames, }: {
+    table: MarkdownTable;
+    renderCell: (text: string, key: string) => ReactNode;
+    className?: string;
+    classNames?: Partial<MarkdownTableClassNames>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=table-view.d.ts.map

package/dist/markdown/table-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-view.d.ts","sourceRoot":"","sources":["../../src/markdown/table-view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AAI5D,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,0BAA0B,EAAE,uBAOxC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,UAAU,EACV,SAAS,EACT,UAAU,GACX,EAAE;IACD,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC/C,+BA4BA"}

package/dist/markdown/table-view.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from "../internal/cx.js";
+const ALIGN = { left: "text-left", center: "text-center", right: "text-right" };
+export const MARKDOWN_TABLE_CLASS_NAMES = {
+    wrapper: "my-6 overflow-x-auto rounded-xl border border-border",
+    table: "w-full border-collapse text-sm",
+    head: "bg-muted/60",
+    headerCell: "px-3 py-2 align-top font-semibold text-foreground",
+    row: "border-t border-border",
+    cell: "px-3 py-2 align-top leading-relaxed text-muted-foreground",
+};
+/**
+ * A parsed Markdown table, drawn with the house token classes so it takes the
+ * host app's look. Cells arrive as Markdown text; `renderCell` is the host
+ * renderer's own inline pass (bold, code, links), so a table cell reads exactly
+ * like the prose around it and link rewriting stays the app's business.
+ *
+ * An app whose theme has no tokens (a plain Tailwind palette) passes
+ * `classNames`. Server-safe: no hooks, no client boundary.
+ */
+export function MarkdownTableView({ table, renderCell, className, classNames, }) {
+    const c = { ...MARKDOWN_TABLE_CLASS_NAMES, ...classNames };
+    return (_jsx("div", { className: cx(c.wrapper, className), children: _jsxs("table", { className: c.table, children: [_jsx("thead", { className: c.head, children: _jsx("tr", { children: table.header.map((cell, col) => (_jsx("th", { scope: "col", className: cx(c.headerCell, ALIGN[table.aligns[col] ?? "left"]), children: renderCell(cell, `th-${col}`) }, col))) }) }), _jsx("tbody", { children: table.rows.map((row, r) => (_jsx("tr", { className: c.row, children: row.map((cell, col) => (_jsx("td", { className: cx(c.cell, ALIGN[table.aligns[col] ?? "left"]), children: renderCell(cell, `td-${r}-${col}`) }, col))) }, r))) })] }) }));
+}
+//# sourceMappingURL=table-view.js.map

package/dist/markdown/table-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-view.js","sourceRoot":"","sources":["../../src/markdown/table-view.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAGvC,MAAM,KAAK,GAA+B,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAY5G,MAAM,CAAC,MAAM,0BAA0B,GAA4B;IACjE,OAAO,EAAE,sDAAsD;IAC/D,KAAK,EAAE,gCAAgC;IACvC,IAAI,EAAE,aAAa;IACnB,UAAU,EAAE,mDAAmD;IAC/D,GAAG,EAAE,wBAAwB;IAC7B,IAAI,EAAE,2DAA2D;CAClE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,KAAK,EACL,UAAU,EACV,SAAS,EACT,UAAU,GAMX;IACC,MAAM,CAAC,GAAG,EAAE,GAAG,0BAA0B,EAAE,GAAG,UAAU,EAAE,CAAC;IAC3D,OAAO,CACL,cAAK,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,YACtC,iBAAO,SAAS,EAAE,CAAC,CAAC,KAAK,aACvB,gBAAO,SAAS,EAAE,CAAC,CAAC,IAAI,YACtB,uBACG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAC/B,aAAc,KAAK,EAAC,KAAK,EAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,YACtF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,IADvB,GAAG,CAEP,CACN,CAAC,GACC,GACC,EACR,0BACG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAC1B,aAAY,SAAS,EAAE,CAAC,CAAC,GAAG,YACzB,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CACtB,aAAc,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,YACpE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,IAD5B,GAAG,CAEP,CACN,CAAC,IALK,CAAC,CAML,CACN,CAAC,GACI,IACF,GACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/markdown/table.d.ts

@@ -0,0 +1,35 @@
+/**
+ * GitHub-flavoured Markdown tables, for the hand-rolled guide renderers.
+ *
+ * The in-app help centres render their guides with small, dependency-free
+ * Markdown parsers. Each grew the same blind spot: a table rendered as one
+ * paragraph of pipes, so every troubleshooting section ("Problem | What to try")
+ * and every plan comparison showed raw markup on a public page. This is the
+ * parsing half, shared; `./table.tsx` draws it.
+ */
+export type TableAlign = "left" | "center" | "right";
+export interface MarkdownTable {
+    header: string[];
+    aligns: TableAlign[];
+    /** Body rows. A short row is padded to the header's width; a long one is cut to it. */
+    rows: string[][];
+}
+/** A line that is a table row: starts and ends with a pipe. */
+export declare function isTableRow(line: string): boolean;
+/** Cells of a table row, with `\|` kept as a literal pipe. */
+export declare function splitTableRow(line: string): string[];
+/** The row under a header: `| --- | :-: | --: |`, nothing but dashes and colons. */
+export declare function isTableSeparator(line: string): boolean;
+/** A row followed by a separator row — a lone `| a | b |` line is prose, not a table. */
+export declare function isTableStart(lines: readonly string[], i: number): boolean;
+export declare function alignmentOf(separatorCell: string): TableAlign;
+/**
+ * Read the table that starts at `lines[i]`, or null when none does. Returns the
+ * index of the first line after it, so a renderer's block loop carries on from
+ * there.
+ */
+export declare function readTable(lines: readonly string[], i: number): {
+    table: MarkdownTable;
+    next: number;
+} | null;
+//# sourceMappingURL=table.d.ts.map

package/dist/markdown/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/markdown/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,uFAAuF;IACvF,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;CAClB;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBpD;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAIzE;AAED,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,CAM7D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB5G"}

package/dist/markdown/table.js

@@ -0,0 +1,79 @@
+/**
+ * GitHub-flavoured Markdown tables, for the hand-rolled guide renderers.
+ *
+ * The in-app help centres render their guides with small, dependency-free
+ * Markdown parsers. Each grew the same blind spot: a table rendered as one
+ * paragraph of pipes, so every troubleshooting section ("Problem | What to try")
+ * and every plan comparison showed raw markup on a public page. This is the
+ * parsing half, shared; `./table.tsx` draws it.
+ */
+/** A line that is a table row: starts and ends with a pipe. */
+export function isTableRow(line) {
+    const trimmed = line.trim();
+    return trimmed.length > 1 && trimmed.startsWith("|") && trimmed.endsWith("|");
+}
+/** Cells of a table row, with `\|` kept as a literal pipe. */
+export function splitTableRow(line) {
+    const inner = line.trim().slice(1, -1);
+    const cells = [];
+    let current = "";
+    for (let i = 0; i < inner.length; i++) {
+        const ch = inner[i];
+        if (ch === "\\" && inner[i + 1] === "|") {
+            current += "|";
+            i++;
+        }
+        else if (ch === "|") {
+            cells.push(current.trim());
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    cells.push(current.trim());
+    return cells;
+}
+/** The row under a header: `| --- | :-: | --: |`, nothing but dashes and colons. */
+export function isTableSeparator(line) {
+    return isTableRow(line) && splitTableRow(line).every((cell) => /^:?-+:?$/.test(cell));
+}
+/** A row followed by a separator row — a lone `| a | b |` line is prose, not a table. */
+export function isTableStart(lines, i) {
+    const line = lines[i];
+    const next = lines[i + 1];
+    return line !== undefined && next !== undefined && isTableRow(line) && isTableSeparator(next);
+}
+export function alignmentOf(separatorCell) {
+    const left = separatorCell.startsWith(":");
+    const right = separatorCell.endsWith(":");
+    if (left && right)
+        return "center";
+    if (right)
+        return "right";
+    return "left";
+}
+/**
+ * Read the table that starts at `lines[i]`, or null when none does. Returns the
+ * index of the first line after it, so a renderer's block loop carries on from
+ * there.
+ */
+export function readTable(lines, i) {
+    if (!isTableStart(lines, i))
+        return null;
+    const header = splitTableRow(lines[i] ?? "");
+    const aligns = splitTableRow(lines[i + 1] ?? "").map(alignmentOf);
+    const width = header.length;
+    let next = i + 2;
+    const rows = [];
+    while (next < lines.length && isTableRow(lines[next] ?? "")) {
+        const cells = splitTableRow(lines[next] ?? "");
+        rows.push(Array.from({ length: width }, (_, col) => cells[col] ?? ""));
+        next++;
+    }
+    return {
+        table: { header, aligns: Array.from({ length: width }, (_, col) => aligns[col] ?? "left"), rows },
+        next,
+    };
+}
+//# sourceMappingURL=table.js.map

package/dist/markdown/table.js.map

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

package/dist/release/changelog.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The shape of a product changelog: numbered, dated releases, each with a
+ * headline, a one-sentence summary and its changes grouped by product area.
+ *
+ * The data is each app's own. What is shared is the shape, the rules that keep
+ * it honest (see `releaseHistoryProblems`) and the page that draws it — so a
+ * release reads the same way in every product, and the drift between an app's
+ * package.json and its public changelog is caught the same way everywhere.
+ */
+/** The kind of change — drives the coloured tag. `changed` means someone may need to act. */
+export type ChangeType = "new" | "improved" | "changed" | "fixed";
+export declare const CHANGE_TYPES: readonly ChangeType[];
+/** One change within a release section. */
+export interface ChangelogChange {
+    type: ChangeType;
+    /** A short headline, sentence case, no full stop. Shown in bold, so it must carry the change alone. */
+    title: string;
+    /** One to three sentences: what a person can now do, and where. May use `**bold**` for UI labels. */
+    text: string;
+}
+/** Changes grouped under a product area, as people name it ("Invoices", "Fixes"). */
+export interface ChangelogSection {
+    heading: string;
+    changes: ChangelogChange[];
+}
+/** A numbered, dated release. */
+export interface ChangelogRelease {
+    /** MAJOR.MINOR.PATCH, no "v". */
+    version: string;
+    /** ISO calendar date (YYYY-MM-DD) the release was cut. */
+    date: string;
+    /** The headline — a few words. */
+    title: string;
+    /** One sentence on why the release matters. */
+    summary: string;
+    /** Most important first; "Fixes" and "Behind the scenes" last. */
+    sections: ChangelogSection[];
+}
+/** What a release guard compares the changelog against. Parsed JSON, so this stays free of `node:fs`. */
+export interface ReleaseManifest {
+    /** `package.json`. */
+    pkg: {
+        version?: string;
+    };
+    /** `package-lock.json`, when the app has one. */
+    lock?: {
+        version?: string;
+        packages?: Record<string, {
+            version?: string;
+        } | undefined>;
+    };
+}
+/**
+ * Everything wrong with a release history, as sentences — an empty list means
+ * it is sound. An app's guard test is one assertion:
+ *
+ * ```ts
+ * expect(releaseHistoryProblems(CHANGELOG, { pkg, lock })).toEqual([]);
+ * ```
+ *
+ * A version lives in three places — package.json, its lockfile and the newest
+ * changelog release — and a bump that touches one and forgets another is the
+ * drift this exists to catch. Returning problems rather than throwing on the
+ * first means a broken history is reported whole.
+ */
+export declare function releaseHistoryProblems(changelog: readonly ChangelogRelease[], manifest?: ReleaseManifest): string[];
+/** A fragment id without dots, so it never needs escaping as a selector: `v0-25-0`. */
+export declare function releaseAnchor(version: string): string;
+/** Format an ISO date as "29 August 2026" (or the locale's equivalent), in UTC so it never shifts a day. */
+export declare function formatReleaseDate(iso: string, locale?: string): string;
+export declare function countChanges(release: ChangelogRelease): number;
+//# sourceMappingURL=changelog.d.ts.map

package/dist/release/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/release/changelog.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,6FAA6F;AAC7F,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAElE,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAA4C,CAAC;AAE3F,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,uGAAuG;IACvG,KAAK,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,yGAAyG;AACzG,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,GAAG,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC,CAAA;KAAE,CAAC;CAC1F;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CA+DnH;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,4GAA4G;AAC5G,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAIvE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAE9D"}