@dogsbay/format-fluidtopics-markdown 0.2.0-beta.92

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @dogsbay/format-fluidtopics-markdown
+ *
+ * Importer for the Fluid Topics Markdown export shape (e.g. the
+ * ServiceNow/ServiceNowDocs GitHub repo): a `markdown/{publication}/**.md`
+ * tree with per-publication `index.md` TOCs, DITA `topic_type` frontmatter,
+ * embedded HTML tables / nav-card grids, dual link schemes, and omitted media.
+ *
+ * Produces the universal Dogsbay contract — ExportPage[] + NavItem[] — via the
+ * shared TreeNode model, so all existing exporters/renderers consume it
+ * unchanged.
+ */
+export type { TreeNode, ExportPage, NavItem, Heading } from "@dogsbay/types";
+export { parseFluidTopicsMarkdown } from "./parse.js";
+export type { ParseResult, ParseOptions } from "./parse.js";
+export { importFluidTopicsProject, detectSource, } from "./importer.js";
+export type { FluidTopicsImportResult } from "./importer.js";
+export { extractFrontmatter, mapFrontmatter } from "./frontmatter.js";
+export { resolveFtLink, applyLinkResolution, toSlug } from "./links.js";
+export { protectTables, restoreTables } from "./html-blocks.js";
+export { buildNav, parseTocList, parseReadmePublications } from "./nav.js";
+export { extractHeadings, slugify } from "./headings.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EACL,wBAAwB,EACxB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { parseFluidTopicsMarkdown } from "./parse.js";
+export { importFluidTopicsProject, detectSource, } from "./importer.js";
+export { extractFrontmatter, mapFrontmatter } from "./frontmatter.js";
+export { resolveFtLink, applyLinkResolution, toSlug } from "./links.js";
+export { protectTables, restoreTables } from "./html-blocks.js";
+export { buildNav, parseTocList, parseReadmePublications } from "./nav.js";
+export { extractHeadings, slugify } from "./headings.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EACL,wBAAwB,EACxB,YAAY,GACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/inline-walker.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Inline token walker — converts markdown-it inline tokens into InlineNode[].
+ *
+ * Flat-annotation (Notion-style) model: bold/italic/strikethrough are
+ * annotations on text spans, not nested elements. Links wrap children.
+ *
+ * Adapted from `@dogsbay/format-mkdocs`'s inline-walker — the inline model is
+ * format-agnostic, so this is intentionally a near-identical copy.
+ */
+import type Token from "markdown-it/lib/token.mjs";
+import type { InlineNode } from "@dogsbay/types";
+/** Convert markdown-it inline token children into structured InlineNode[]. */
+export declare function walkInlineTokens(tokens: Token[] | null): InlineNode[];
+//# sourceMappingURL=inline-walker.d.ts.map

package/dist/inline-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-walker.d.ts","sourceRoot":"","sources":["../src/inline-walker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,OAAO,KAAK,EACV,UAAU,EAOX,MAAM,gBAAgB,CAAC;AAQxB,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,GAAG,UAAU,EAAE,CA8GrE"}

package/dist/inline-walker.js

@@ -0,0 +1,109 @@
+/** Convert markdown-it inline token children into structured InlineNode[]. */
+export function walkInlineTokens(tokens) {
+    if (!tokens || tokens.length === 0)
+        return [];
+    const result = [];
+    const annotations = { bold: false, italic: false, strikethrough: false };
+    const containerStack = [];
+    function target() {
+        if (containerStack.length > 0) {
+            return containerStack[containerStack.length - 1].node.children;
+        }
+        return result;
+    }
+    function pushNode(node) {
+        target().push(node);
+    }
+    function makeText(text) {
+        const span = { type: "text", text };
+        if (annotations.bold)
+            span.bold = true;
+        if (annotations.italic)
+            span.italic = true;
+        if (annotations.strikethrough)
+            span.strikethrough = true;
+        return span;
+    }
+    for (const token of tokens) {
+        switch (token.type) {
+            case "strong_open":
+                annotations.bold = true;
+                break;
+            case "strong_close":
+                annotations.bold = false;
+                break;
+            case "em_open":
+                annotations.italic = true;
+                break;
+            case "em_close":
+                annotations.italic = false;
+                break;
+            case "s_open":
+                annotations.strikethrough = true;
+                break;
+            case "s_close":
+                annotations.strikethrough = false;
+                break;
+            case "link_open": {
+                const href = token.attrGet("href") || "";
+                const title = token.attrGet("title") || undefined;
+                const linkNode = { type: "link", href, children: [] };
+                if (title)
+                    linkNode.title = title;
+                containerStack.push({ type: "link", node: linkNode });
+                break;
+            }
+            case "link_close": {
+                const container = containerStack.pop();
+                if (container)
+                    target().push(container.node);
+                break;
+            }
+            case "text": {
+                if (token.content)
+                    pushNode(makeText(token.content));
+                break;
+            }
+            case "code_inline": {
+                const codeNode = { type: "code", text: token.content };
+                pushNode(codeNode);
+                break;
+            }
+            case "image": {
+                const src = token.attrGet("src") || "";
+                const alt = token.content || token.attrGet("alt") || undefined;
+                const title = token.attrGet("title") || undefined;
+                const imgNode = { type: "image", src };
+                if (alt)
+                    imgNode.alt = alt;
+                if (title)
+                    imgNode.title = title;
+                pushNode(imgNode);
+                break;
+            }
+            case "softbreak": {
+                pushNode(makeText(" "));
+                break;
+            }
+            case "hardbreak": {
+                const brNode = { type: "break" };
+                pushNode(brNode);
+                break;
+            }
+            case "html_inline": {
+                const htmlNode = { type: "html-inline", html: token.content };
+                pushNode(htmlNode);
+                break;
+            }
+            default: {
+                if (token.content) {
+                    const htmlNode = { type: "html-inline", html: token.content };
+                    pushNode(htmlNode);
+                }
+                break;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=inline-walker.js.map

package/dist/inline-walker.js.map

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

package/dist/links.d.ts

@@ -0,0 +1,28 @@
+import type { TreeNode } from "@dogsbay/types";
+export interface LinkResolveOptions {
+    /** Route prefix pages are served under (e.g. "/docs"). */
+    hrefPrefix?: string;
+}
+/** Strip `.md`, trailing `/index`, and a bare `index` from a relative path. */
+export declare function toSlug(relPath: string): string;
+/**
+ * Resolve a single link href.
+ *
+ * @param href        the raw href as written
+ * @param fromRelPath the current file's path relative to the `markdown/` root,
+ *                    including `.md` (e.g. "application-development/build.md")
+ * @returns the rewritten href and whether it was recognised/resolved. When
+ *          `resolved` is false the original href is returned unchanged (callers
+ *          may log a warning for broken cross-references).
+ */
+export declare function resolveFtLink(href: string, fromRelPath: string, opts?: LinkResolveOptions): {
+    href: string;
+    resolved: boolean;
+};
+/**
+ * Walk a tree and rewrite every link href via {@link resolveFtLink}. Rewrites
+ * structured inline links and `cards` node item hrefs. Returns the list of
+ * unresolved hrefs (for warning/reporting).
+ */
+export declare function applyLinkResolution(tree: TreeNode[], fromRelPath: string, opts?: LinkResolveOptions): string[];
+//# sourceMappingURL=links.d.ts.map

package/dist/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,+EAA+E;AAC/E,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK9C;AAYD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,kBAAuB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA6BrC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EAAE,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,kBAAuB,GAC5B,MAAM,EAAE,CA0BV"}

package/dist/links.js

@@ -0,0 +1,101 @@
+/**
+ * Link resolution for the Fluid Topics Markdown export.
+ *
+ * The export uses TWO link schemes:
+ *   - Body cross-references: relative `.md` paths (`../concept/plan.md`),
+ *     resolved against the current file's directory.
+ *   - TOC (`index.md`) entries: absolute `raw.githubusercontent.com/.../markdown/
+ *     {pub}/{file}.md` URLs.
+ * Both must resolve to Dogsbay routes. Anchors, mailto:, and other external
+ * http(s) links pass through unchanged. Non-`.md` relative paths (images,
+ * icons) are left to media handling.
+ */
+import { posix } from "node:path";
+const RAW_GH_RE = /^https?:\/\/raw\.githubusercontent\.com\/[^/]+\/[^/]+\/[^/]+\/markdown\/(.+)$/i;
+/** Strip `.md`, trailing `/index`, and a bare `index` from a relative path. */
+export function toSlug(relPath) {
+    return relPath
+        .replace(/\.md$/i, "")
+        .replace(/\/index$/i, "")
+        .replace(/^index$/i, "");
+}
+function toHref(slug, hrefPrefix) {
+    if (!slug)
+        return hrefPrefix || "/";
+    return `${hrefPrefix}/${slug}`;
+}
+function splitAnchor(s) {
+    const i = s.indexOf("#");
+    return i >= 0 ? [s.slice(0, i), s.slice(i + 1)] : [s, ""];
+}
+/**
+ * Resolve a single link href.
+ *
+ * @param href        the raw href as written
+ * @param fromRelPath the current file's path relative to the `markdown/` root,
+ *                    including `.md` (e.g. "application-development/build.md")
+ * @returns the rewritten href and whether it was recognised/resolved. When
+ *          `resolved` is false the original href is returned unchanged (callers
+ *          may log a warning for broken cross-references).
+ */
+export function resolveFtLink(href, fromRelPath, opts = {}) {
+    const hrefPrefix = opts.hrefPrefix ?? "/docs";
+    if (!href)
+        return { href, resolved: false };
+    // Pure anchor.
+    if (href.startsWith("#"))
+        return { href, resolved: true };
+    // Absolute raw.githubusercontent URL (TOC scheme).
+    const raw = RAW_GH_RE.exec(href);
+    if (raw) {
+        const [path, anchor] = splitAnchor(raw[1]);
+        const slug = toSlug(path);
+        return { href: toHref(slug, hrefPrefix) + (anchor ? `#${anchor}` : ""), resolved: true };
+    }
+    // Other external / scheme links (http(s), mailto:, tel:) pass through.
+    if (/^[a-z][a-z0-9+.-]*:/i.test(href))
+        return { href, resolved: true };
+    // Relative link. Only rewrite `.md` targets (and anchored ones); leave
+    // non-markdown relative paths (images/icons) for media handling.
+    const [path, anchor] = splitAnchor(href);
+    if (/\.md$/i.test(path) || path === "") {
+        const dir = posix.dirname(fromRelPath);
+        const resolvedRel = posix.normalize(posix.join(dir, path || "."));
+        const slug = toSlug(resolvedRel);
+        return { href: toHref(slug, hrefPrefix) + (anchor ? `#${anchor}` : ""), resolved: true };
+    }
+    return { href, resolved: false };
+}
+/**
+ * Walk a tree and rewrite every link href via {@link resolveFtLink}. Rewrites
+ * structured inline links and `cards` node item hrefs. Returns the list of
+ * unresolved hrefs (for warning/reporting).
+ */
+export function applyLinkResolution(tree, fromRelPath, opts = {}) {
+    const unresolved = [];
+    function rewrite(href) {
+        const r = resolveFtLink(href, fromRelPath, opts);
+        if (!r.resolved)
+            unresolved.push(href);
+        return r.href;
+    }
+    function walk(nodes) {
+        for (const node of nodes) {
+            if (node.inline) {
+                for (const span of node.inline) {
+                    if (span.type === "link")
+                        span.href = rewrite(span.href);
+                }
+            }
+            // `card` nodes (from nav-card conversion) carry their href in props.
+            if (node.type === "card" && typeof node.props?.href === "string") {
+                node.props.href = rewrite(node.props.href);
+            }
+            if (node.children)
+                walk(node.children);
+        }
+    }
+    walk(tree);
+    return unresolved;
+}
+//# sourceMappingURL=links.js.map

package/dist/links.js.map

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

package/dist/nav.d.ts

@@ -0,0 +1,23 @@
+import type { NavItem } from "@dogsbay/types";
+export interface NavOptions {
+    hrefPrefix?: string;
+    /** Optional publication allow-list (top-level markdown/{pub} folders). */
+    publications?: string[];
+}
+/**
+ * Parse an indented Markdown link list (an `index.md` TOC body) into nested
+ * NavItem[]. Depth comes from leading indentation; hrefs are resolved relative
+ * to `fromRelPath` (so both the relative and raw-github schemes work).
+ */
+export declare function parseTocList(markdown: string, fromRelPath: string, opts?: NavOptions): NavItem[];
+/** Parse the README "List of publications" into ordered {label, pub} pairs. */
+export declare function parseReadmePublications(readme: string): {
+    label: string;
+    pub: string;
+}[];
+/**
+ * Build the full site nav from a Fluid Topics Markdown repo root: README order
+ * for the top level, each publication's `index.md` TOC for its children.
+ */
+export declare function buildNav(sourceDir: string, opts?: NavOptions): NavItem[];
+//# sourceMappingURL=nav.d.ts.map

package/dist/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../src/nav.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,UAAe,GACpB,OAAO,EAAE,CAyBX;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAWxF;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,EAAE,CA2C5E"}

package/dist/nav.js

@@ -0,0 +1,101 @@
+/**
+ * Navigation generation for the Fluid Topics Markdown export.
+ *
+ * Two-level nav, fully encoded in the repo (no API needed):
+ *   - Top level   : the README "List of publications" (curated order).
+ *   - Per-publication: that publication's `index.md` (doc_type: toc) — an
+ *     indented Markdown link list = the authored sidebar.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { resolveFtLink } from "./links.js";
+const LIST_ITEM_RE = /^(\s*)[-*]\s+\[([^\]]*)\]\(([^)]+)\)/;
+const README_PUB_RE = /\[([^\]]*)\]\((?:\.\/)?markdown\/([^/]+)\/index\.md\)/;
+/**
+ * Parse an indented Markdown link list (an `index.md` TOC body) into nested
+ * NavItem[]. Depth comes from leading indentation; hrefs are resolved relative
+ * to `fromRelPath` (so both the relative and raw-github schemes work).
+ */
+export function parseTocList(markdown, fromRelPath, opts = {}) {
+    const roots = [];
+    // Stack of { indent, item } for building the hierarchy.
+    const stack = [];
+    for (const line of markdown.split("\n")) {
+        const m = LIST_ITEM_RE.exec(line);
+        if (!m)
+            continue;
+        const indent = m[1].replace(/\t/g, "  ").length;
+        const label = m[2].trim();
+        const href = resolveFtLink(m[3].trim(), fromRelPath, { hrefPrefix: opts.hrefPrefix }).href;
+        const item = { label, href };
+        while (stack.length > 0 && stack[stack.length - 1].indent >= indent)
+            stack.pop();
+        if (stack.length === 0) {
+            roots.push(item);
+        }
+        else {
+            const parent = stack[stack.length - 1].item;
+            (parent.children ??= []).push(item);
+        }
+        stack.push({ indent, item });
+    }
+    return roots;
+}
+/** Parse the README "List of publications" into ordered {label, pub} pairs. */
+export function parseReadmePublications(readme) {
+    const pubs = [];
+    const seen = new Set();
+    for (const line of readme.split("\n")) {
+        const m = README_PUB_RE.exec(line);
+        if (m && !seen.has(m[2])) {
+            seen.add(m[2]);
+            pubs.push({ label: m[1].trim(), pub: m[2] });
+        }
+    }
+    return pubs;
+}
+/**
+ * Build the full site nav from a Fluid Topics Markdown repo root: README order
+ * for the top level, each publication's `index.md` TOC for its children.
+ */
+export function buildNav(sourceDir, opts = {}) {
+    const readmePath = join(sourceDir, "README.md");
+    const markdownDir = join(sourceDir, "markdown");
+    if (!existsSync(markdownDir))
+        return [];
+    // README gives curated order + labels — but it can omit publications that
+    // exist as dirs (it's hand-curated). So treat the actual markdown/ subdirs
+    // as the source of truth, and use the README only for order + labels.
+    const readmePubs = existsSync(readmePath)
+        ? parseReadmePublications(readFileSync(readmePath, "utf-8"))
+        : [];
+    const labelByPub = new Map(readmePubs.map((p) => [p.pub, p.label]));
+    const readmeOrder = new Map(readmePubs.map((p, i) => [p.pub, i]));
+    // Actual publication dirs (those containing an index.md).
+    let dirs = readdirSync(markdownDir).filter((entry) => {
+        const sub = join(markdownDir, entry);
+        return statSync(sub).isDirectory() && existsSync(join(sub, "index.md"));
+    });
+    if (opts.publications && opts.publications.length > 0) {
+        const allow = new Set(opts.publications);
+        dirs = dirs.filter((pub) => allow.has(pub));
+    }
+    // Order: README order first, then any extras alphabetically.
+    dirs.sort((a, b) => {
+        const ai = readmeOrder.has(a) ? readmeOrder.get(a) : Infinity;
+        const bi = readmeOrder.has(b) ? readmeOrder.get(b) : Infinity;
+        return ai !== bi ? ai - bi : a.localeCompare(b);
+    });
+    const nav = [];
+    for (const pub of dirs) {
+        const label = labelByPub.get(pub) ?? deriveLabel(pub);
+        const children = parseTocList(readFileSync(join(markdownDir, pub, "index.md"), "utf-8"), `${pub}/index.md`, opts);
+        nav.push(children.length > 0 ? { label, children } : { label });
+    }
+    return nav;
+}
+/** Title-case a publication dir name when the README has no label for it. */
+function deriveLabel(pub) {
+    return pub.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+//# sourceMappingURL=nav.js.map

package/dist/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.js","sourceRoot":"","sources":["../src/nav.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,YAAY,GAAG,sCAAsC,CAAC;AAC5D,MAAM,aAAa,GAAG,uDAAuD,CAAC;AAQ9E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,WAAmB,EACnB,OAAmB,EAAE;IAErB,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,wDAAwD;IACxD,MAAM,KAAK,GAAwC,EAAE,CAAC;IAEtD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC;QAChD,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC;QAC3F,MAAM,IAAI,GAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAEtC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,MAAM;YAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QAEjF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5C,CAAC,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,IAAI,GAAqC,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAiB,EAAE,OAAmB,EAAE;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACvC,CAAC,CAAC,uBAAuB,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,0DAA0D;IAC1D,IAAI,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,6DAA6D;IAC7D,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjB,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/D,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/D,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,YAAY,CAC3B,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EACzD,GAAG,GAAG,WAAW,EACjB,IAAI,CACL,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6EAA6E;AAC7E,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Parse one Fluid-Topics-export markdown file into a TreeNode[] + headings.
+ *
+ * Pipeline: extract frontmatter -> protect embedded <table> spans -> markdown-it
+ * parse (html enabled) -> token walker -> restore tables as structured nodes ->
+ * resolve links (dual scheme) -> extract + populate headings.
+ */
+import type MarkdownIt from "markdown-it";
+import type { TreeNode, Heading } from "@dogsbay/types";
+export interface ParseResult {
+    tree: TreeNode[];
+    headings: Heading[];
+    frontmatter: Record<string, unknown> | undefined;
+    /** Hrefs that could not be resolved (for warning/reporting). */
+    unresolvedLinks: string[];
+}
+export interface ParseOptions {
+    /**
+     * The file's path relative to the `markdown/` root, including `.md`
+     * (e.g. "application-development/build.md"). Used to resolve relative links.
+     */
+    fromRelPath?: string;
+    /** Route prefix for resolved links (default "/docs"). */
+    hrefPrefix?: string;
+}
+export declare function parseFluidTopicsMarkdown(source: string, md: MarkdownIt, opts?: ParseOptions): ParseResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAOxD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACjD,gEAAgE;IAChE,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,UAAU,EACd,IAAI,GAAE,YAAiB,GACtB,WAAW,CAqBb"}

package/dist/parse.js

@@ -0,0 +1,22 @@
+import { tokensToTree } from "./walker.js";
+import { extractFrontmatter } from "./frontmatter.js";
+import { protectTables, restoreTables } from "./html-blocks.js";
+import { applyLinkResolution } from "./links.js";
+import { extractHeadings } from "./headings.js";
+export function parseFluidTopicsMarkdown(source, md, opts = {}) {
+    const { frontmatter, body } = extractFrontmatter(source);
+    // Protect embedded tables before markdown-it sees them.
+    const { source: protectedBody, tables } = protectTables(body);
+    const tokens = md.parse(protectedBody, {});
+    const tree = tokensToTree(tokens);
+    // Swap table placeholders for structured nodes.
+    restoreTables(tree, tables, md);
+    // Resolve links (relative .md + absolute raw-github URLs).
+    const unresolvedLinks = applyLinkResolution(tree, opts.fromRelPath ?? "index.md", {
+        hrefPrefix: opts.hrefPrefix,
+    });
+    // Extract + populate headings (writes slug/text onto heading nodes).
+    const headings = extractHeadings(tree);
+    return { tree, headings, frontmatter, unresolvedLinks };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAoBhD,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,EAAc,EACd,OAAqB,EAAE;IAEvB,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEzD,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAElC,gDAAgD;IAChD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAEhC,2DAA2D;IAC3D,MAAM,eAAe,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU,EAAE;QAChF,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC;IAEH,qEAAqE;IACrE,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AAC1D,CAAC"}

package/dist/tree.d.ts

@@ -0,0 +1,2 @@
+export type { TreeNode } from "@dogsbay/types";
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tree.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":""}

package/dist/walker.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Convert a markdown-it token stream into TreeNode[].
+ *
+ * Handles open/close token pairs by recursively collecting children. The
+ * generic `*_open` → `type.replace(/_open$/, "")` fallback covers the GFM
+ * table family (table/thead/tbody/tr/th/td) and definition lists, so they
+ * need no special cases here.
+ *
+ * Adapted from `@dogsbay/format-mkdocs`'s walker, trimmed to plain
+ * CommonMark + GFM (no MkDocs-specific admonition/tab/autodoc tokens).
+ */
+import type Token from "markdown-it/lib/token.mjs";
+import type { TreeNode } from "./tree.js";
+export declare function tokensToTree(tokens: Token[]): TreeNode[];
+//# sourceMappingURL=walker.d.ts.map

package/dist/walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.d.ts","sourceRoot":"","sources":["../src/walker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,CA+BxD"}