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

package/README.md

@@ -0,0 +1,60 @@
+# @dogsbay/format-fluidtopics-markdown
+
+Importer for the **Fluid Topics Markdown export** shape — e.g. the
+[`ServiceNow/ServiceNowDocs`](https://github.com/ServiceNow/ServiceNowDocs)
+GitHub repo (Apache-2.0). Converts an FT Markdown repo into Dogsbay's universal
+contract (`ExportPage[]` + `NavItem[]`) via the shared `TreeNode` model, so every
+existing exporter/renderer consumes it unchanged.
+
+Import-only. (Export back to Fluid Topics is not supported.)
+
+## The format it handles
+
+A `markdown/{publication}/**.md` tree where:
+
+- each publication's **`index.md`** has `doc_type: toc` and an indented Markdown
+  link list (the authored sidebar); the **README** "List of publications" gives
+  the top-level order;
+- topic frontmatter carries DITA semantics — `topic_type` (concept / task /
+  reference), `title`, `description`, `locale`, `release`, `last_updated`;
+- bodies are *dirty* Markdown: embedded raw `<table>` / DITA **nav-card** grids,
+  **two link schemes** (relative `.md` in bodies, absolute
+  `raw.githubusercontent` URLs in TOCs), and **omitted media** (dangling
+  relative image paths).
+
+See the format analysis in `dogsbay-research`
+(`content/formats/fluidtopics-markdown-format.md`).
+
+## Usage
+
+```ts
+import { importFluidTopicsProject } from "@dogsbay/format-fluidtopics-markdown";
+
+const { pages, nav } = await importFluidTopicsProject("/path/to/ServiceNowDocs", {
+  hrefPrefix: "/docs",
+});
+```
+
+Or via the format plugin (for CLI composition):
+
+```ts
+import { plugin } from "@dogsbay/format-fluidtopics-markdown/cli";
+// plugin.name === "fluidtopics-markdown"; plugin.detectSource(path); plugin.import(...)
+```
+
+## What it does
+
+- **Frontmatter** → Dogsbay conventions (`topic_type`→`type`, `last_updated`→`date`,
+  `locale`→`lang`, `release`→`version`); unknown keys preserved.
+- **Embedded HTML tables** → structured `table` nodes; **`nav-card`** grids →
+  `cards` nodes (title / description / icon / href).
+- **Links** → resolved to routes from both the relative-`.md` and the absolute
+  `raw.githubusercontent` schemes; unresolved hrefs are reported, not fatal.
+- **Nav** → built from each publication's `index.md` TOC + the README order.
+
+## Status
+
+Phase 1–3 scaffold (parser + importer + nav, tests green). Not yet wired into the
+CLI `convert` / a `migrate-fluidtopics` command, and media handling currently
+leaves icon/image paths untouched — see
+`dogsbay-research/plans/format-fluidtopics-markdown.md`.

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+import type { FormatPlugin } from "@dogsbay/types";
+/**
+ * Fluid Topics Markdown format plugin.
+ *
+ * Import-only: consumes a ServiceNowDocs-style FT Markdown export (a
+ * `markdown/{publication}/**` tree). Export back to FT is not supported.
+ */
+export declare const plugin: FormatPlugin;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,gBAAgB,CAAC;AAGxE;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,YAepB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,20 @@
+import { detectSource, importFluidTopicsProject } from "./importer.js";
+/**
+ * Fluid Topics Markdown format plugin.
+ *
+ * Import-only: consumes a ServiceNowDocs-style FT Markdown export (a
+ * `markdown/{publication}/**` tree). Export back to FT is not supported.
+ */
+export const plugin = {
+    name: "fluidtopics-markdown",
+    canImport: true,
+    canExport: false,
+    detectSource,
+    importOptions: [],
+    async import(source, opts) {
+        const { pages, nav } = await importFluidTopicsProject(source, opts);
+        opts.siteName = opts.siteName || "Documentation";
+        return { pages, nav };
+    },
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,IAAI,EAAE,sBAAsB;IAC5B,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,KAAK;IAChB,YAAY;IACZ,aAAa,EAAE,EAAE;IAEjB,KAAK,CAAC,MAAM,CACV,MAAc,EACd,IAA6B;QAE7B,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACxB,CAAC;CACF,CAAC"}

package/dist/frontmatter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Lift YAML frontmatter from a raw markdown source. Returns the parsed object
+ * and the body with the block stripped. Tolerates malformed/empty YAML.
+ */
+export declare function extractFrontmatter(source: string): {
+    frontmatter: Record<string, unknown> | undefined;
+    body: string;
+};
+/**
+ * Map a Fluid-Topics frontmatter object onto Dogsbay frontmatter conventions.
+ *
+ * Known FT keys are translated to their Dogsbay equivalents; unrecognised keys
+ * pass through unchanged so nothing is lost. The result is suitable for
+ * `parseMeta(...)` and for emitting as page frontmatter.
+ */
+export declare function mapFrontmatter(fm: Record<string, unknown> | undefined): Record<string, unknown>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;CACd,CAeA;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB"}

package/dist/frontmatter.js

@@ -0,0 +1,85 @@
+/**
+ * Frontmatter handling for the Fluid Topics Markdown export.
+ *
+ * The export's frontmatter keys are inconsistent across files and over time
+ * (e.g. `llms.txt` advertises `product_area`/`canonical_url`, while topic
+ * files actually carry `topic_type`/`description`/`locale`/`release`). So
+ * everything here is **presence-keyed and optional** — we map what's there
+ * and never assume a key exists.
+ *
+ * See content/formats/fluidtopics-markdown-format.md in dogsbay-research.
+ */
+import YAML from "yaml";
+/** Match a YAML frontmatter block at the start of a markdown source. */
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?/;
+/**
+ * Lift YAML frontmatter from a raw markdown source. Returns the parsed object
+ * and the body with the block stripped. Tolerates malformed/empty YAML.
+ */
+export function extractFrontmatter(source) {
+    const match = FRONTMATTER_RE.exec(source);
+    if (!match)
+        return { frontmatter: undefined, body: source };
+    const body = source.slice(match[0].length);
+    const raw = match[1];
+    if (raw.trim().length === 0)
+        return { frontmatter: undefined, body };
+    try {
+        const parsed = YAML.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return { frontmatter: parsed, body };
+        }
+    }
+    catch {
+        /* tolerate malformed YAML */
+    }
+    return { frontmatter: undefined, body };
+}
+/**
+ * Map a Fluid-Topics frontmatter object onto Dogsbay frontmatter conventions.
+ *
+ * Known FT keys are translated to their Dogsbay equivalents; unrecognised keys
+ * pass through unchanged so nothing is lost. The result is suitable for
+ * `parseMeta(...)` and for emitting as page frontmatter.
+ */
+export function mapFrontmatter(fm) {
+    if (!fm)
+        return {};
+    const out = {};
+    // DITA topic type (concept | task | reference) → Dogsbay `type`.
+    if (typeof fm.topic_type === "string")
+        out.type = fm.topic_type;
+    // Last-edited date → `date`.
+    if (fm.last_updated != null)
+        out.date = fm.last_updated;
+    // Locale → `lang`.
+    if (typeof fm.locale === "string")
+        out.lang = fm.locale;
+    // Release family → `version`.
+    if (typeof fm.release === "string")
+        out.version = fm.release;
+    // Straight-through fields.
+    if (typeof fm.title === "string")
+        out.title = fm.title;
+    if (typeof fm.description === "string")
+        out.description = fm.description;
+    // Preserve every other source key (excluding the ones already remapped or
+    // intentionally dropped) so the import is non-lossy.
+    const remapped = new Set([
+        "topic_type",
+        "last_updated",
+        "locale",
+        "release",
+        "title",
+        "description",
+        "reading_time_minutes", // derivable; dropped from output
+        "doc_type", // structural marker for TOC files
+        "bundle", // structural marker for TOC files
+    ]);
+    for (const [k, v] of Object.entries(fm)) {
+        if (!remapped.has(k) && !(k in out))
+            out[k] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,wEAAwE;AACxE,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAI/C,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,EAAE,WAAW,EAAE,MAAiC,EAAE,IAAI,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,EAAuC;IAEvC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,MAAM,GAAG,GAA4B,EAAE,CAAC;IAExC,iEAAiE;IACjE,IAAI,OAAO,EAAE,CAAC,UAAU,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC;IAChE,6BAA6B;IAC7B,IAAI,EAAE,CAAC,YAAY,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC;IACxD,mBAAmB;IACnB,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC;IACxD,8BAA8B;IAC9B,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ;QAAE,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;IAC7D,2BAA2B;IAC3B,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ;QAAE,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ;QAAE,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC;IAEzE,0EAA0E;IAC1E,qDAAqD;IACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;QACvB,YAAY;QACZ,cAAc;QACd,QAAQ;QACR,SAAS;QACT,OAAO;QACP,aAAa;QACb,sBAAsB,EAAE,iCAAiC;QACzD,UAAU,EAAE,kCAAkC;QAC9C,QAAQ,EAAE,kCAAkC;KAC7C,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/headings.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Heading extraction + slug population.
+ *
+ * Walks the tree, computes a stable slug for each heading (de-duplicated),
+ * writes `slug`/`text` back onto the heading node's props (so the renderer
+ * can emit anchors), and returns the flat Heading[] for TOC generation.
+ */
+import type { TreeNode, Heading } from "@dogsbay/types";
+export declare function extractHeadings(tree: TreeNode[]): Heading[];
+/** Extract plain text from a node, preferring structured inline content. */
+export declare function extractText(node: TreeNode): string;
+export declare function slugify(text: string): string;
+//# sourceMappingURL=headings.d.ts.map

package/dist/headings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headings.d.ts","sourceRoot":"","sources":["../src/headings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAc,MAAM,gBAAgB,CAAC;AAEpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CA6B3D;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAWlD;AAyBD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU5C"}

package/dist/headings.js

@@ -0,0 +1,76 @@
+export function extractHeadings(tree) {
+    const headings = [];
+    const seen = new Map();
+    function walk(nodes) {
+        for (const node of nodes) {
+            if (node.type === "heading") {
+                const level = node.props?.level ?? 1;
+                const text = extractText(node);
+                let slug = node.props?.slug;
+                if (!slug) {
+                    const base = slugify(text);
+                    const count = seen.get(base) ?? 0;
+                    slug = count === 0 ? base : `${base}-${count}`;
+                    seen.set(base, count + 1);
+                }
+                if (!node.props)
+                    node.props = {};
+                node.props.slug = slug;
+                node.props.text = text;
+                headings.push({ depth: level, slug, text });
+            }
+            if (node.children)
+                walk(node.children);
+        }
+    }
+    walk(tree);
+    return headings;
+}
+/** Extract plain text from a node, preferring structured inline content. */
+export function extractText(node) {
+    const parts = [];
+    if (node.inline) {
+        parts.push(extractInlineText(node.inline));
+    }
+    else if (node.html) {
+        parts.push(node.html.replace(/<[^>]+>/g, ""));
+    }
+    if (node.children) {
+        for (const child of node.children)
+            parts.push(extractText(child));
+    }
+    return parts.filter(Boolean).join(" ").trim();
+}
+function extractInlineText(nodes) {
+    const parts = [];
+    for (const node of nodes) {
+        switch (node.type) {
+            case "text":
+            case "code":
+                parts.push(node.text);
+                break;
+            case "link":
+            case "highlight":
+                parts.push(extractInlineText(node.children));
+                break;
+            case "image":
+                if (node.alt)
+                    parts.push(node.alt);
+                break;
+            case "html-inline":
+                parts.push(node.html.replace(/<[^>]+>/g, ""));
+                break;
+        }
+    }
+    return parts.join("");
+}
+export function slugify(text) {
+    return (text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, "")
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .trim() || "section");
+}
+//# sourceMappingURL=headings.js.map

package/dist/headings.js.map

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

package/dist/html-blocks.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Embedded-HTML handling for the Fluid Topics Markdown export.
+ *
+ * FT/DITA exports emit raw `<table>` blocks inside the Markdown — including
+ * DITA "nav-card" landing grids — often with blank lines inside cells (which
+ * would otherwise shred the table across multiple markdown-it html_blocks) and
+ * sometimes with no blank line before the following heading (`</table>##...`).
+ *
+ * Strategy: BEFORE markdown-it runs, replace each `<table>...</table>` span
+ * with an isolated placeholder comment (so the surrounding markdown parses
+ * cleanly); AFTER walking, swap each placeholder node for a structured
+ * TreeNode:
+ *   - `class="nav-card"` -> a `cards` node (title / description / icon / href)
+ *   - any other table     -> a `table` node (thead/tbody/tr/th/td + prose cells)
+ */
+import type MarkdownIt from "markdown-it";
+import type { TreeNode } from "@dogsbay/types";
+/** Pull `<table>...</table>` spans out of the source, leaving placeholders. */
+export declare function protectTables(source: string): {
+    source: string;
+    tables: string[];
+};
+/** Replace placeholder html nodes with structured table/cards TreeNodes. */
+export declare function restoreTables(tree: TreeNode[], tables: string[], md: MarkdownIt): void;
+//# sourceMappingURL=html-blocks.d.ts.map

package/dist/html-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-blocks.d.ts","sourceRoot":"","sources":["../src/html-blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAQlF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,CAkBtF"}

package/dist/html-blocks.js

@@ -0,0 +1,151 @@
+const TABLE_RE = /<table[\s\S]*?<\/table>/gi;
+const PLACEHOLDER_RE = /<!--FT_TABLE_(\d+)-->/;
+/** Pull `<table>...</table>` spans out of the source, leaving placeholders. */
+export function protectTables(source) {
+    const tables = [];
+    const out = source.replace(TABLE_RE, (m) => {
+        const i = tables.length;
+        tables.push(m);
+        return `\n\n<!--FT_TABLE_${i}-->\n\n`;
+    });
+    return { source: out, tables };
+}
+/** Replace placeholder html nodes with structured table/cards TreeNodes. */
+export function restoreTables(tree, tables, md) {
+    function walk(nodes) {
+        for (let i = 0; i < nodes.length; i++) {
+            const node = nodes[i];
+            if (node.type === "html" && node.html) {
+                const m = PLACEHOLDER_RE.exec(node.html);
+                if (m) {
+                    const idx = Number(m[1]);
+                    if (tables[idx] !== undefined) {
+                        nodes[i] = convertTable(tables[idx], md);
+                        continue;
+                    }
+                }
+            }
+            if (node.children)
+                walk(node.children);
+        }
+    }
+    walk(tree);
+}
+const ROW_RE = /<tr[^>]*>([\s\S]*?)<\/tr>/gi;
+const CELL_RE = /<t([dh])\b[^>]*>([\s\S]*?)<\/t\1>/gi;
+const LINK_RE = /\[([\s\S]*?)\]\(([^)]+)\)/;
+const IMG_RE = /!\[[^\]]*\]\(([^)]+)\)/;
+/** Private-use marker that stands in for an extracted inline image so the
+ * remaining link label can be split into title / description around it. */
+const ICON_MARKER = String.fromCharCode(0xe000);
+function isNavCard(html) {
+    return /<table[^>]*\bclass="[^"]*\bnav-card\b[^"]*"/i.test(html);
+}
+/** Parse one nav-card cell into a card item. */
+function parseCard(cellInner) {
+    const trimmed = cellInner.trim();
+    if (!trimmed)
+        return null;
+    // Extract the inline image (icon) FIRST and replace it with a marker, so the
+    // outer link regex isn't fooled by the image's own `](...)`. The nav-card
+    // label shape is "Title text ![](icon.svg) Description text".
+    let icon;
+    let work = trimmed;
+    const img = IMG_RE.exec(trimmed);
+    if (img) {
+        icon = img[1].trim();
+        work = trimmed.slice(0, img.index) + ICON_MARKER + trimmed.slice(img.index + img[0].length);
+    }
+    const link = LINK_RE.exec(work);
+    if (!link) {
+        const card = { title: stripTags(trimmed) };
+        if (icon)
+            card.icon = icon;
+        return card;
+    }
+    const href = link[2].trim();
+    const [titleRaw, ...descParts] = link[1].split(ICON_MARKER);
+    const title = stripTags(titleRaw || "").trim() || stripTags(trimmed.split(ICON_MARKER).join(" "));
+    const description = descParts.length > 0 ? stripTags(descParts.join("")).trim() || undefined : undefined;
+    const card = { title };
+    if (description)
+        card.description = description;
+    if (icon)
+        card.icon = icon;
+    if (href)
+        card.href = href;
+    return card;
+}
+function convertTable(html, md) {
+    const rows = [];
+    let rowMatch;
+    ROW_RE.lastIndex = 0;
+    while ((rowMatch = ROW_RE.exec(html)) !== null) {
+        const cells = [];
+        let header = false;
+        let cellMatch;
+        CELL_RE.lastIndex = 0;
+        while ((cellMatch = CELL_RE.exec(rowMatch[1])) !== null) {
+            if (cellMatch[1].toLowerCase() === "h")
+                header = true;
+            cells.push(cellMatch[2]);
+        }
+        if (cells.length > 0)
+            rows.push({ header, cells });
+    }
+    if (isNavCard(html)) {
+        // Emit `cards` with child `card` nodes (props: title/href/description/icon)
+        // — the shape @dogsbay/format-dogsbay-md's serializer renders as :::cards.
+        const children = [];
+        for (const row of rows) {
+            for (const cell of row.cells) {
+                const card = parseCard(cell);
+                if (!card)
+                    continue;
+                const props = { title: card.title };
+                if (card.description)
+                    props.description = card.description;
+                if (card.icon)
+                    props.icon = card.icon;
+                if (card.href)
+                    props.href = card.href;
+                children.push({ type: "card", props });
+            }
+        }
+        return { type: "cards", props: { variant: "nav-card" }, children };
+    }
+    // Generic table -> thead/tbody/tr/th/td with prose cells.
+    const headerRows = rows.filter((r) => r.header);
+    const bodyRows = rows.filter((r) => !r.header);
+    const children = [];
+    const cellNode = (inner, tag) => ({
+        type: tag,
+        children: [{ type: "prose", html: md.renderInline(stripBlank(inner)) }],
+    });
+    if (headerRows.length > 0) {
+        children.push({
+            type: "thead",
+            children: headerRows.map((r) => ({
+                type: "tr",
+                children: r.cells.map((c) => cellNode(c, "th")),
+            })),
+        });
+    }
+    if (bodyRows.length > 0) {
+        children.push({
+            type: "tbody",
+            children: bodyRows.map((r) => ({
+                type: "tr",
+                children: r.cells.map((c) => cellNode(c, "td")),
+            })),
+        });
+    }
+    return { type: "table", children };
+}
+function stripTags(s) {
+    return s.replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
+}
+function stripBlank(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=html-blocks.js.map

package/dist/html-blocks.js.map

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

package/dist/importer.d.ts

@@ -0,0 +1,14 @@
+import type { ExportPage, NavItem } from "@dogsbay/types";
+export interface FluidTopicsImportResult {
+    pages: ExportPage[];
+    nav: NavItem[];
+    /** Hrefs that could not be resolved, keyed by page slug (for reporting). */
+    unresolved: Record<string, string[]>;
+}
+/**
+ * Detect a Fluid Topics Markdown export: a `markdown/` directory whose
+ * immediate subfolders each contain an `index.md`, and/or an `llms.txt`.
+ */
+export declare function detectSource(path: string): boolean;
+export declare function importFluidTopicsProject(sourceDir: string, opts?: Record<string, unknown>): Promise<FluidTopicsImportResult>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../src/importer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM1D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYlD;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,uBAAuB,CAAC,CA+DlC"}

package/dist/importer.js

@@ -0,0 +1,106 @@
+/**
+ * Fluid Topics Markdown export importer.
+ *
+ * Reads a ServiceNowDocs-style repo (a `markdown/{publication}/**.md` tree with
+ * per-publication `index.md` TOCs and a README "List of publications") and
+ * produces ExportPage[] + NavItem[] — the universal format contract.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative, basename } from "node:path";
+import MarkdownIt from "markdown-it";
+import { parseMeta } from "@dogsbay/types";
+import { parseFluidTopicsMarkdown } from "./parse.js";
+import { mapFrontmatter } from "./frontmatter.js";
+import { buildNav } from "./nav.js";
+/**
+ * Detect a Fluid Topics Markdown export: a `markdown/` directory whose
+ * immediate subfolders each contain an `index.md`, and/or an `llms.txt`.
+ */
+export function detectSource(path) {
+    const markdownDir = join(path, "markdown");
+    if (!existsSync(markdownDir))
+        return false;
+    if (existsSync(join(path, "llms.txt")))
+        return true;
+    try {
+        return readdirSync(markdownDir).some((entry) => {
+            const sub = join(markdownDir, entry);
+            return statSync(sub).isDirectory() && existsSync(join(sub, "index.md"));
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export async function importFluidTopicsProject(sourceDir, opts = {}) {
+    const markdownDir = join(sourceDir, "markdown");
+    if (!existsSync(markdownDir)) {
+        throw new Error(`No markdown/ directory found in ${sourceDir}`);
+    }
+    const hrefPrefix = typeof opts.hrefPrefix === "string" ? opts.hrefPrefix : "/docs";
+    const taxonomyNames = Array.isArray(opts.taxonomyNames)
+        ? opts.taxonomyNames
+        : undefined;
+    // Optional publication allow-list (the top-level markdown/{pub} folder).
+    // Lets callers scope a migration to one or a few publications.
+    const publications = Array.isArray(opts.publications) && opts.publications.length > 0
+        ? new Set(opts.publications)
+        : undefined;
+    const md = new MarkdownIt({ html: true, linkify: true });
+    let files = findMarkdownFiles(markdownDir);
+    if (publications) {
+        files = files.filter((f) => {
+            const top = relative(markdownDir, f).split(/[\\/]/)[0];
+            return publications.has(top);
+        });
+    }
+    const pages = [];
+    const unresolved = {};
+    for (const filePath of files) {
+        const relPath = relative(markdownDir, filePath).split("\\").join("/");
+        const slug = relPath.replace(/\.md$/i, "").replace(/\/index$/i, "").replace(/^index$/i, "") || "index";
+        try {
+            const source = readFileSync(filePath, "utf-8");
+            const { tree, headings, frontmatter, unresolvedLinks } = parseFluidTopicsMarkdown(source, md, { fromRelPath: relPath, hrefPrefix });
+            const mapped = mapFrontmatter(frontmatter);
+            const title = (typeof mapped.title === "string" && mapped.title) ||
+                headings.find((h) => h.depth === 1)?.text ||
+                labelFromPath(relPath);
+            const meta = parseMeta(mapped, { slug, taxonomyNames });
+            pages.push({ slug, title, tree, headings, frontmatter: mapped, meta });
+            if (unresolvedLinks.length > 0)
+                unresolved[slug] = unresolvedLinks;
+        }
+        catch (err) {
+            console.warn(`Warning: failed to parse ${relPath}: ${err.message}`);
+        }
+    }
+    const nav = buildNav(sourceDir, {
+        hrefPrefix,
+        publications: publications ? [...publications] : undefined,
+    });
+    return { pages, nav, unresolved };
+}
+// ── helpers ─────────────────────────────────────────────
+function findMarkdownFiles(dir) {
+    const results = [];
+    function walk(d) {
+        for (const entry of readdirSync(d)) {
+            const full = join(d, entry);
+            if (statSync(full).isDirectory()) {
+                walk(full);
+            }
+            else if (entry.toLowerCase().endsWith(".md")) {
+                results.push(full);
+            }
+        }
+    }
+    walk(dir);
+    return results.sort();
+}
+function labelFromPath(path) {
+    return basename(path, ".md")
+        .replace(/[-_]/g, " ")
+        .replace(/\b\w/g, (c) => c.toUpperCase());
+}
+//# sourceMappingURL=importer.js.map

package/dist/importer.js.map

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