@dogsbay/format-rst 0.2.0-beta.101

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+import type { FormatPlugin, ExportPage, NavItem } from "@dogsbay/types";
+import { rstPathToSlug } from "./loaders/plain.js";
+export interface RstImportResult {
+    pages: ExportPage[];
+    nav: NavItem[];
+    /** Which mode actually ran ("sphinx" | "plain"), for reporting. */
+    mode: "sphinx" | "plain";
+}
+export declare function importRst(source: string, opts: Record<string, unknown>): Promise<RstImportResult>;
+export declare const plugin: FormatPlugin;
+export { rstPathToSlug };
+//# 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":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAW,MAAM,gBAAgB,CAAC;AAKjF,OAAO,EAAyC,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAW1F,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,mEAAmE;IACnE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC1B;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC,CA+B1B;AAoHD,eAAO,MAAM,MAAM,EAAE,YAsBpB,CAAC;AAGF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/cli.js

@@ -0,0 +1,188 @@
+/**
+ * FormatPlugin for reStructuredText / Sphinx as a source format.
+ *
+ * Import strategy:
+ *  - **Sphinx mode** when a `conf.py` is found: build the project to XML
+ *    once (toctree, cross-refs, directives, autodoc all resolve), map each
+ *    doc → ExportPage, nav from the toctree. If the Sphinx build fails
+ *    (e.g. conf.py references extensions not installed in this env), fall
+ *    back to plain mode with a warning — content still converts, minus the
+ *    Sphinx-resolved bits (plans/format-rst.md decision #2).
+ *  - **Plain mode** otherwise: docutils per-file, directory-inferred nav.
+ *
+ * Needs Python 3 + docutils (and Sphinx for Sphinx projects) — a migrate-
+ * time requirement, detected up front with an actionable error.
+ */
+import { existsSync, readFileSync, rmSync } from "node:fs";
+import { basename } from "node:path";
+import { extractHeadings } from "@dogsbay/format-dogsbay-md";
+import { parseRstFile, parseRstXml } from "./parse.js";
+import { loadSphinx, findSphinxSrc } from "./loaders/sphinx.js";
+import { walkRstFiles, inferNav, isRstDominant, rstPathToSlug } from "./loaders/plain.js";
+import { sidecarAvailable, sphinxAvailable, missingPythonMessage, RstSidecarError } from "./sidecar.js";
+function prettify(slug) {
+    return slug
+        .split(/[-_/]/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+export async function importRst(source, opts) {
+    if (!existsSync(source))
+        throw new Error(`Source directory not found: ${source}`);
+    if (!sidecarAvailable())
+        throw new RstSidecarError(missingPythonMessage());
+    const hrefPrefix = typeof opts.hrefPrefix === "string" ? opts.hrefPrefix : "";
+    const forcePlain = opts.loader === "plain";
+    const sphinxSrc = forcePlain ? null : findSphinxSrc(source);
+    // Only attempt a Sphinx build when Sphinx is actually installed — else a
+    // docutils-only env pays a guaranteed failing subprocess + scary warning
+    // before falling back. When conf.py exists but Sphinx is missing, note it.
+    if (sphinxSrc && sphinxAvailable()) {
+        try {
+            return importSphinx(source, hrefPrefix);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`rst import: Sphinx build failed, falling back to plain docutils mode.\n  ${msg.split("\n")[0]}`);
+            // Fall back walking the Sphinx SOURCE dir (where conf.py lives), not
+            // the repo root — otherwise slugs gain a spurious `docs/` prefix.
+            return importPlain(sphinxSrc, hrefPrefix);
+        }
+    }
+    if (sphinxSrc && !forcePlain) {
+        console.warn("rst import: a conf.py was found but Sphinx isn't installed — using plain mode " +
+            "(toctree nav + :doc:/:ref: cross-refs won't resolve). Install sphinx for full fidelity.");
+    }
+    return importPlain(sphinxSrc ?? source, hrefPrefix);
+}
+function importSphinx(source, hrefPrefix) {
+    const { docs, nav, outDir } = loadSphinx(source, hrefPrefix);
+    const pages = [];
+    const ledgers = new Map();
+    let failed = 0;
+    try {
+        for (const doc of docs) {
+            try {
+                const xml = readFileSync(doc.xmlPath, "utf-8");
+                const { tree, title, markdown, ledger } = parseRstXml(xml, doc.slug, hrefPrefix);
+                if (ledger.length)
+                    ledgers.set(doc.slug, ledger);
+                pages.push(makePage(doc.slug, tree, title, markdown, ledger));
+            }
+            catch (err) {
+                failed += 1;
+                const m = err instanceof Error ? err.message : String(err);
+                console.warn(`rst import: failed on ${doc.slug}, skipping: ${m}`);
+            }
+        }
+    }
+    finally {
+        // Reclaim the temp XML build dir once every doc has been read — it can
+        // be tens of MB per project and would otherwise leak on every run.
+        rmSync(outDir, { recursive: true, force: true });
+    }
+    reportSkips(failed, docs.length, ledgers);
+    return { pages, nav, mode: "sphinx" };
+}
+function importPlain(source, hrefPrefix) {
+    const sources = walkRstFiles(source);
+    const pages = [];
+    const titles = new Map();
+    const ledgers = new Map();
+    let failed = 0;
+    for (const s of sources) {
+        try {
+            const { tree, title, markdown, ledger } = parseRstFile(s.filePath, hrefPrefix);
+            if (ledger.length)
+                ledgers.set(s.slug, ledger);
+            const page = makePage(s.slug, tree, title, markdown, ledger);
+            titles.set(s.slug, page.title);
+            pages.push(page);
+        }
+        catch (err) {
+            failed += 1;
+            const m = err instanceof Error ? err.message : String(err);
+            console.warn(`rst import: failed on ${s.filePath}, skipping: ${m}`);
+        }
+    }
+    reportSkips(failed, sources.length, ledgers);
+    const nav = inferNav(sources, titles, hrefPrefix);
+    return { pages, nav, mode: "plain" };
+}
+function makePage(slug, tree, title, markdown, ledger) {
+    const headings = extractHeadings(tree);
+    const resolvedTitle = (title && title.trim()) ||
+        headings.find((h) => h.depth === 1)?.text ||
+        prettify(basename(slug));
+    return {
+        slug,
+        title: resolvedTitle,
+        tree,
+        headings,
+        frontmatter: {},
+        // Surface the per-page ledger so downstream consumers (and anyone
+        // inspecting the page) can see which constructs were dropped/degraded.
+        meta: ledger.length ? { rstLedger: ledger } : {},
+        bodyMarkdown: markdown,
+    };
+}
+/**
+ * Report failures + a concrete per-page ledger summary. Previously the CLI
+ * claimed "see per-page ledger" without ever writing one; now it names the
+ * pages and construct kinds so the caveat is actionable.
+ */
+function reportSkips(failed, total, ledgers) {
+    if (failed > 0)
+        console.warn(`rst import: ${failed} of ${total} doc(s) failed and were skipped`);
+    if (ledgers.size === 0)
+        return;
+    const kinds = new Map();
+    let entries = 0;
+    for (const list of ledgers.values()) {
+        entries += list.length;
+        for (const e of list) {
+            const kind = e.construct.replace(/[:0-9].*/, "").trim() || e.construct.slice(0, 24);
+            kinds.set(kind, (kinds.get(kind) ?? 0) + 1);
+        }
+    }
+    const topKinds = [...kinds.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([k, n]) => `${k}×${n}`)
+        .join(", ");
+    const topPages = [...ledgers.entries()]
+        .sort((a, b) => b[1].length - a[1].length)
+        .slice(0, 5)
+        .map(([slug, list]) => `${slug} (${list.length})`)
+        .join(", ");
+    console.warn(`rst import: ${entries} construct(s) across ${ledgers.size} page(s) mapped with caveats or dropped.\n` +
+        `  kinds: ${topKinds}\n` +
+        `  most-affected: ${topPages}\n` +
+        `  (full detail on each page's meta.rstLedger)`);
+}
+export const plugin = {
+    name: "rst",
+    canImport: true,
+    canExport: false,
+    // Detect only when there's a Sphinx conf.py, OR the tree is
+    // rST-DOMINANT (has .rst and no competing .md). A stray CHANGELOG.rst in
+    // a Dogsbay-MD / MkDocs corpus must NOT steal detection — rst is
+    // registered before dogsbay-md (the generic .md catch-all), so this
+    // guard keeps it from claiming markdown trees.
+    detectSource: (path) => findSphinxSrc(path) !== null || isRstDominant(path),
+    importOptions: [
+        {
+            flags: "--loader <name>",
+            description: "Force a loader: 'sphinx' (build via conf.py) or 'plain' (docutils per-file, no toctree/cross-refs). Auto-detected when omitted.",
+        },
+    ],
+    exportOptions: [],
+    async import(source, opts) {
+        const { pages, nav } = await importRst(source, opts);
+        return { pages, nav };
+    },
+};
+// Re-export for the migrate command.
+export { rstPathToSlug };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExG,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAc,EACd,IAA6B;IAE7B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC,gBAAgB,EAAE;QAAE,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAE3E,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC;IAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAE5D,yEAAyE;IACzE,yEAAyE;IACzE,2EAA2E;IAC3E,IAAI,SAAS,IAAI,eAAe,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CACV,4EAA4E,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CACjG,CAAC;YACF,qEAAqE;YACrE,kEAAkE;YAClE,OAAO,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,IAAI,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CACV,gFAAgF;YAC9E,yFAAyF,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC,SAAS,IAAI,MAAM,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC;AAKD,SAAS,YAAY,CAAC,MAAc,EAAE,UAAkB;IACtD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAiB,IAAI,GAAG,EAAE,CAAC;IACxC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC/C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACjF,IAAI,MAAM,CAAC,MAAM;oBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YAChE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,CAAC,CAAC;gBACZ,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,uEAAuE;QACvE,mEAAmE;QACnE,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,UAAkB;IACrD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,OAAO,GAAiB,IAAI,GAAG,EAAE,CAAC;IACxC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC/E,IAAI,MAAM,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC7D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,CAAC;YACZ,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,QAAQ,eAAe,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAClD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,QAAQ,CACf,IAAY,EACZ,IAAwB,EACxB,KAAyB,EACzB,QAAgB,EAChB,MAAwB;IAExB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAc,CAAC;IACpD,MAAM,aAAa,GACjB,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,IAAI;QACzC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,aAAa;QACpB,IAAI;QACJ,QAAQ;QACR,WAAW,EAAE,EAAE;QACf,kEAAkE;QAClE,uEAAuE;QACvE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,SAAS,EAAE,MAAM,EAA8B,CAAC,CAAC,CAAC,EAAE;QAC7E,YAAY,EAAE,QAAQ;KACvB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,MAAc,EAAE,KAAa,EAAE,OAAqB;IACvE,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,eAAe,MAAM,OAAO,KAAK,iCAAiC,CAAC,CAAC;IACjG,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpF,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;SACzC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,CAAC,IAAI,CACV,eAAe,OAAO,wBAAwB,OAAO,CAAC,IAAI,4CAA4C;QACpG,YAAY,QAAQ,IAAI;QACxB,oBAAoB,QAAQ,IAAI;QAChC,+CAA+C,CAClD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,IAAI,EAAE,KAAK;IACX,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,KAAK;IAChB,4DAA4D;IAC5D,yEAAyE;IACzE,iEAAiE;IACjE,oEAAoE;IACpE,+CAA+C;IAC/C,YAAY,EAAE,CAAC,IAAY,EAAW,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC;IAC5F,aAAa,EAAE;QACb;YACE,KAAK,EAAE,iBAAiB;YACxB,WAAW,EACT,iIAAiI;SACpI;KACF;IACD,aAAa,EAAE,EAAE;IACjB,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,IAA6B;QACxD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACxB,CAAC;CACF,CAAC;AAEF,qCAAqC;AACrC,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @dogsbay/format-rst — reStructuredText / Sphinx format plugin.
+ *
+ * Imports `.rst` corpora into TreeNode[] by parsing with docutils/Sphinx
+ * (a Python sidecar) to XML, transforming that AST to Dogsbay-MD, then
+ * parsing with the canonical dogsbay-md parser.
+ *
+ * See plans/format-rst.md.
+ */
+export { rstFileToXml, sidecarAvailable, sphinxAvailable, sphinxBuildXml, findPython, missingPythonMessage, RstSidecarError, } from "./sidecar.js";
+export { parseRstFile, parseRstXml, type ParseRstResult } from "./parse.js";
+export { docutilsXmlToDogsbayMd, type TransformResult, type TransformOptions, type RstLedgerEntry, } from "./transform.js";
+export { loadSphinx, findSphinxSrc, type SphinxLoadResult, type SphinxDoc, } from "./loaders/sphinx.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;;;;;;;;GAQG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @dogsbay/format-rst — reStructuredText / Sphinx format plugin.
+ *
+ * Imports `.rst` corpora into TreeNode[] by parsing with docutils/Sphinx
+ * (a Python sidecar) to XML, transforming that AST to Dogsbay-MD, then
+ * parsing with the canonical dogsbay-md parser.
+ *
+ * See plans/format-rst.md.
+ */
+export { rstFileToXml, sidecarAvailable, sphinxAvailable, sphinxBuildXml, findPython, missingPythonMessage, RstSidecarError, } from "./sidecar.js";
+export { parseRstFile, parseRstXml } from "./parse.js";
+export { docutilsXmlToDogsbayMd, } from "./transform.js";
+export { loadSphinx, findSphinxSrc, } from "./loaders/sphinx.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":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAuB,MAAM,YAAY,CAAC;AAC5E,OAAO,EACL,sBAAsB,GAIvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,aAAa,GAGd,MAAM,qBAAqB,CAAC"}

package/dist/loaders/plain.d.ts

@@ -0,0 +1,25 @@
+import type { NavItem } from "@dogsbay/types";
+export interface RstPageSource {
+    filePath: string;
+    /** Root-relative slug (README/index → index). */
+    slug: string;
+}
+/** Slug for a source path relative to the docs root (README → index). */
+export declare function rstPathToSlug(rel: string): string;
+/** Walk `dir` for every `.rst` file (skipping dotdirs + _build/_static). */
+export declare function walkRstFiles(dir: string): RstPageSource[];
+/**
+ * Infer a nav tree from page slugs (no toctree available in plain mode).
+ * Directory segments become groups; `<dir>/index` is the group's landing
+ * page. Best-effort — the author can curate the emitted nav.yml.
+ */
+export declare function inferNav(pages: RstPageSource[], titles: Map<string, string>, hrefPrefix?: string): NavItem[];
+/**
+ * Detect: is this directory rST-DOMINANT — has `.rst` files and no competing
+ * `.md` files? A stray `CHANGELOG.rst` / `README.rst` in a Markdown corpus
+ * must not make the whole tree read as reStructuredText (format-rst is
+ * registered before the generic dogsbay-md detector). Requires both a
+ * present `.rst` and the absence of `.md`.
+ */
+export declare function isRstDominant(dir: string): boolean;
+//# sourceMappingURL=plain.d.ts.map

package/dist/loaders/plain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain.d.ts","sourceRoot":"","sources":["../../src/loaders/plain.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CA2BzD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,SAAK,GAAG,OAAO,EAAE,CAgCxG;AAUD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAuClD"}

package/dist/loaders/plain.js

@@ -0,0 +1,161 @@
+/**
+ * Plain (non-Sphinx) rST corpus loader — a flat `.rst` walk.
+ *
+ * Used when there's no `conf.py`, or as the fallback when a Sphinx build
+ * fails (e.g. the project's conf.py references extensions not installed in
+ * this env — see plans/format-rst.md decision #2). Plain docutils can't
+ * resolve `toctree`/cross-refs, so nav is inferred from the directory
+ * structure; the transform ledgers the Sphinx-only constructs.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+/** Slug for a source path relative to the docs root (README → index). */
+export function rstPathToSlug(rel) {
+    let p = rel.replace(/\\/g, "/").replace(/\.rst$/i, "");
+    if (p === "README" || p === "index")
+        return "index";
+    p = p.replace(/\/(README|index)$/i, "/index");
+    return p;
+}
+/** Walk `dir` for every `.rst` file (skipping dotdirs + _build/_static). */
+export function walkRstFiles(dir) {
+    const out = [];
+    const SKIP = new Set(["_build", "_static", "_templates", "node_modules"]);
+    const walk = (d) => {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (name.startsWith(".") || SKIP.has(name))
+                continue;
+            const full = join(d, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory())
+                walk(full);
+            else if (name.toLowerCase().endsWith(".rst")) {
+                out.push({ filePath: full, slug: rstPathToSlug(relative(dir, full)) });
+            }
+        }
+    };
+    walk(dir);
+    return out;
+}
+/**
+ * Infer a nav tree from page slugs (no toctree available in plain mode).
+ * Directory segments become groups; `<dir>/index` is the group's landing
+ * page. Best-effort — the author can curate the emitted nav.yml.
+ */
+export function inferNav(pages, titles, hrefPrefix = "") {
+    const root = [];
+    const groups = new Map();
+    // Single group-creation path (returns the group NODE); a group's children
+    // array is `.children`.
+    const ensureGroup = (dir) => {
+        if (!dir)
+            return null;
+        const existing = groups.get(dir);
+        if (existing)
+            return existing;
+        const parentDir = dir.includes("/") ? dir.slice(0, dir.lastIndexOf("/")) : "";
+        const label = prettify(dir.slice(dir.lastIndexOf("/") + 1));
+        const group = { label, children: [] };
+        groups.set(dir, group);
+        const parent = ensureGroup(parentDir);
+        (parent ? parent.children : root).push(group);
+        return group;
+    };
+    for (const p of pages.slice().sort((a, b) => a.slug.localeCompare(b.slug))) {
+        if (p.slug === "index")
+            continue; // root landing, not a nav entry
+        const dir = p.slug.includes("/") ? p.slug.slice(0, p.slug.lastIndexOf("/")) : "";
+        const base = p.slug.slice(p.slug.lastIndexOf("/") + 1);
+        const href = `${hrefPrefix}/${p.slug}`.replace(/\/+/g, "/");
+        if (base === "index") {
+            // Directory landing page — attach as the group's own href.
+            const g = ensureGroup(dir);
+            if (g)
+                g.href = href;
+        }
+        else {
+            const g = ensureGroup(dir);
+            (g ? g.children : root).push({ label: titles.get(p.slug) ?? prettify(base), href });
+        }
+    }
+    return root;
+}
+function prettify(s) {
+    return s
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+/**
+ * Detect: is this directory rST-DOMINANT — has `.rst` files and no competing
+ * `.md` files? A stray `CHANGELOG.rst` / `README.rst` in a Markdown corpus
+ * must not make the whole tree read as reStructuredText (format-rst is
+ * registered before the generic dogsbay-md detector). Requires both a
+ * present `.rst` and the absence of `.md`.
+ */
+export function isRstDominant(dir) {
+    if (!existsSync(dir))
+        return false;
+    try {
+        if (!statSync(dir).isDirectory())
+            return false;
+    }
+    catch {
+        return false;
+    }
+    let rst = false;
+    let md = false;
+    const SKIP = new Set(["_build", "_static", "_templates", "node_modules"]);
+    const walk = (d) => {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return false;
+        }
+        for (const name of entries) {
+            if (name.startsWith(".") || SKIP.has(name))
+                continue;
+            const full = join(d, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (walk(full))
+                    return true; // early-out once md seen
+            }
+            else {
+                const lower = name.toLowerCase();
+                if (lower.endsWith(".md"))
+                    md = true;
+                else if (lower.endsWith(".rst"))
+                    rst = true;
+                if (md)
+                    return true; // competing markdown → not rst-dominant
+            }
+        }
+        return md;
+    };
+    walk(dir);
+    return rst && !md;
+}
+//# sourceMappingURL=plain.js.map

package/dist/loaders/plain.js.map

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

package/dist/loaders/sphinx.d.ts

@@ -0,0 +1,26 @@
+import type { NavItem } from "@dogsbay/types";
+export interface SphinxDoc {
+    /** Root-relative slug (docname), e.g. "advanced/setup". */
+    slug: string;
+    /** Absolute path to the emitted docutils XML. */
+    xmlPath: string;
+}
+export interface SphinxLoadResult {
+    /** Source directory containing conf.py. */
+    srcDir: string;
+    /** Directory the XML was built into. */
+    outDir: string;
+    docs: SphinxDoc[];
+    nav: NavItem[];
+    /** Root document name (master_doc / root_doc), default "index". */
+    rootDoc: string;
+}
+/** Find the Sphinx source dir (the dir with conf.py) at or below `dir`. */
+export declare function findSphinxSrc(dir: string): string | null;
+/**
+ * Load a Sphinx project: build to XML, enumerate docs, extract nav.
+ * `outDir` defaults to a temp dir. Throws (via the sidecar) when Python /
+ * Sphinx is unavailable or the build fails.
+ */
+export declare function loadSphinx(sourceDir: string, hrefPrefix?: string): SphinxLoadResult;
+//# sourceMappingURL=sphinx.d.ts.map

package/dist/loaders/sphinx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sphinx.d.ts","sourceRoot":"","sources":["../../src/loaders/sphinx.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;CACjB;AA0BD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQxD;AAkHD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,gBAAgB,CAW/E"}