@dogsbay/format-myst 0.2.0-beta.101

package/README.md

@@ -0,0 +1,61 @@
+# @dogsbay/format-myst
+
+Import [MyST Markdown](https://mystmd.org) — the Markdown flavour used by
+[Sphinx `myst-parser`](https://myst-parser.readthedocs.io),
+[Jupyter Book](https://jupyterbook.org), and
+[`mystmd`](https://mystmd.org) — into Dogsbay.
+
+MyST is CommonMark + Sphinx-style **directives**, **roles**, and
+**targets**. This package translates those constructs to Dogsbay-MD and
+reuses the canonical `@dogsbay/format-dogsbay-md` parser — no Python, no
+new document-node types.
+
+## Use it via the CLI
+
+```bash
+# Convert a MyST corpus to canonical Dogsbay-MD (pure content, no SSG)
+npx dogsbay convert ./my-myst-docs --to dogsbay-md -o ./out
+
+# One-way migrate to a scaffolded Dogsbay site (content/ + astro/ + config)
+npx dogsbay migrate-myst ./my-myst-docs -o ./my-site
+cd ./my-site && npx dogsbay site dev
+```
+
+The format is auto-detected — a `myst.yml` / `_toc.yml`, or MyST-specific
+syntax in the Markdown, is enough.
+
+## What it converts
+
+- **Admonitions** (`{note}`, `{warning}`, `{tip}`, …) → callouts
+- **sphinx-design** `{tab-set}`/`{tab-item}`, `{grid}`, `{dropdown}`,
+  `{card}` → tabs / grid / details / card
+- **Code** `{code-block}` (with `:caption:` / `:linenos:`) → fenced code
+- **Math** `{math}` and `$$…$$` → KaTeX; inline `$…$` and `` {math}`…` ``
+- **Figures / images** `{figure}` / `{image}` → Markdown images + captions
+- **Roles** `{ref}` `{doc}` `{eq}` `{sub}` `{sup}` `{abbr}` `{kbd}`
+  `{download}` `{file}` … → links / HTML / code
+- **Targets** `(label)=` → heading `{#id}` anchors for cross-references
+- **Version notes** `{versionadded}` / `{versionchanged}` / `{deprecated}`
+  → compact inline notes
+- **Nav** from `_toc.yml`, `myst.yml`, `{toctree}`, or directory structure
+
+Constructs that can't be cleanly mapped (`{list-table}`, `{include}`,
+unknown directives/roles) are kept as best-effort content and recorded in a
+per-page **ledger** — never silently dropped.
+
+## Programmatic API
+
+```ts
+import { parseMyst, mystToDogsbayMd, loadMyst } from "@dogsbay/format-myst";
+
+const { tree, markdown, ledger, toctree } = parseMyst(mystSource);
+const { markdown } = mystToDogsbayMd(bodyOnly);   // translate, no parse
+const { pages, nav, navSource } = /* via the CLI plugin */;
+```
+
+See [plans/format-myst.md](../../plans/format-myst.md) for the full
+construct-mapping table.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+import type { FormatPlugin, ExportPage, NavItem } from "@dogsbay/types";
+export interface MystImportResult {
+    pages: ExportPage[];
+    nav: NavItem[];
+    /** Directory to mirror non-Markdown assets from. */
+    docsDir: string;
+    navSource: string;
+}
+export declare function importMyst(source: string, opts: Record<string, unknown>): Promise<MystImportResult>;
+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":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAW,MAAM,gBAAgB,CAAC;AAajF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CA8C3B;AAED,eAAO,MAAM,MAAM,EAAE,YAWpB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,79 @@
+/**
+ * FormatPlugin for MyST Markdown as a source format.
+ *
+ * Orchestrates: detect corpus → loadMyst (config/TOC + page walk + nav) →
+ * translate each page (parseMyst) → assemble ExportPage[] + NavItem[].
+ *
+ * MyST is Markdown, so this plugin MUST be registered after GitBook/rST and
+ * before the generic dogsbay-md detector — `detectMyst` requires an explicit
+ * MyST config/TOC or MyST-specific syntax, so it won't claim a plain-Markdown
+ * or GitBook corpus.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { extractHeadings } from "@dogsbay/format-dogsbay-md";
+import { parseMyst } from "./parse.js";
+import { loadMyst, detectMyst } from "./loaders/load.js";
+function prettify(slug) {
+    return slug
+        .split(/[-_/]/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+export async function importMyst(source, opts) {
+    if (!existsSync(source)) {
+        throw new Error(`Source directory not found: ${source}`);
+    }
+    const hrefPrefix = typeof opts.hrefPrefix === "string" ? opts.hrefPrefix : "";
+    const { pages: pageSources, nav, docsDir, navSource } = loadMyst(source, { hrefPrefix });
+    const pages = [];
+    let failed = 0;
+    let ledgerTotal = 0;
+    for (const ps of pageSources) {
+        try {
+            const content = readFileSync(ps.filePath, "utf-8");
+            const { tree, frontmatter, body, ledger } = parseMyst(content);
+            ledgerTotal += ledger.length;
+            const headings = extractHeadings(tree);
+            const h1 = headings.find((h) => h.depth === 1);
+            const fmTitle = typeof frontmatter.title === "string" && frontmatter.title.trim()
+                ? frontmatter.title
+                : undefined;
+            const title = fmTitle || h1?.text || prettify(ps.slug.split("/").pop() ?? ps.slug);
+            pages.push({
+                slug: ps.slug,
+                title,
+                tree,
+                headings,
+                frontmatter,
+                meta: ledger.length ? { mystLedger: ledger } : {},
+                bodyMarkdown: body,
+            });
+        }
+        catch (err) {
+            failed += 1;
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`myst import: failed to convert ${ps.filePath} (slug "${ps.slug}"), skipping: ${msg}`);
+        }
+    }
+    if (failed > 0) {
+        console.warn(`myst import: ${failed} of ${pageSources.length} page(s) failed and were skipped`);
+    }
+    if (ledgerTotal > 0) {
+        console.warn(`myst import: ${ledgerTotal} construct(s) mapped with caveats (see per-page ledger)`);
+    }
+    return { pages, nav, docsDir, navSource };
+}
+export const plugin = {
+    name: "myst",
+    canImport: true,
+    canExport: false,
+    detectSource: (path) => detectMyst(path),
+    importOptions: [],
+    exportOptions: [],
+    async import(source, opts) {
+        const { pages, nav, docsDir } = await importMyst(source, opts);
+        return { pages, nav, contentRoot: docsDir };
+    },
+};
+//# 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;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEzD,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;AAUD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,IAA6B;IAE7B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9E,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAEzF,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAC/D,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC;YAC7B,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAc,CAAC;YACpD,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;YAC/C,MAAM,OAAO,GACX,OAAO,WAAW,CAAC,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE;gBAC/D,CAAC,CAAC,WAAW,CAAC,KAAK;gBACnB,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,KAAK,GAAG,OAAO,IAAI,EAAE,EAAE,IAAI,IAAI,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;YACnF,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,KAAK;gBACL,IAAI;gBACJ,QAAQ;gBACR,WAAW;gBACX,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,UAAU,EAAE,MAAM,EAA8B,CAAC,CAAC,CAAC,EAAE;gBAC9E,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,CAAC;YACZ,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,CAAC,QAAQ,WAAW,EAAE,CAAC,IAAI,iBAAiB,GAAG,EAAE,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,gBAAgB,MAAM,OAAO,WAAW,CAAC,MAAM,kCAAkC,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,gBAAgB,WAAW,yDAAyD,CAAC,CAAC;IACrG,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,CAAC,IAAY,EAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IACzD,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,IAA6B;QACxD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAC9C,CAAC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @dogsbay/format-myst — MyST Markdown format plugin. Imports MyST
+ * (Sphinx myst-parser / Jupyter Book / mystmd) corpora into TreeNode[] by
+ * translating MyST directives, roles, and targets to Dogsbay-MD, then
+ * parsing with the canonical dogsbay-md parser (zero new node types).
+ *
+ * See plans/format-myst.md.
+ */
+export { parseMyst, type ParseMystResult } from "./parse.js";
+export { mystToDogsbayMd, type TranslateResult, type TranslateLedgerEntry, } from "./translate.js";
+export { loadMyst, detectMyst, walkMarkdown, pathToSlug, type MystLoadResult, type MystPageSource, } from "./loaders/load.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;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @dogsbay/format-myst — MyST Markdown format plugin. Imports MyST
+ * (Sphinx myst-parser / Jupyter Book / mystmd) corpora into TreeNode[] by
+ * translating MyST directives, roles, and targets to Dogsbay-MD, then
+ * parsing with the canonical dogsbay-md parser (zero new node types).
+ *
+ * See plans/format-myst.md.
+ */
+export { parseMyst } from "./parse.js";
+export { mystToDogsbayMd, } from "./translate.js";
+export { loadMyst, detectMyst, walkMarkdown, pathToSlug, } from "./loaders/load.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;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAwB,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,eAAe,GAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,GAGX,MAAM,mBAAmB,CAAC"}

package/dist/loaders/load.d.ts

@@ -0,0 +1,31 @@
+import type { NavItem } from "@dogsbay/types";
+export interface MystPageSource {
+    filePath: string;
+    /** Root-relative slug (README/index → index). */
+    slug: string;
+}
+export interface MystLoadResult {
+    pages: MystPageSource[];
+    nav: NavItem[];
+    /** Directory the docs live under (for asset mirroring). */
+    docsDir: string;
+    /** How nav was derived — surfaced by migrate-myst for its summary. */
+    navSource: "_toc.yml" | "myst.yml" | "toctree" | "directory";
+}
+/** Slug for a source path relative to the docs root (README/index → index). */
+export declare function pathToSlug(rel: string): string;
+/** Walk `dir` for every Markdown page (skipping build/dot dirs). */
+export declare function walkMarkdown(dir: string): MystPageSource[];
+/**
+ * Detect: does this directory look like a MyST corpus? A config/TOC file is
+ * a definitive signal; otherwise require MyST syntax in at least one sampled
+ * Markdown file (bounded scan — never read the whole tree).
+ */
+export declare function detectMyst(sourceDir: string): boolean;
+export interface MystLoadOptions {
+    hrefPrefix?: string;
+}
+export declare function loadMyst(source: string, opts?: MystLoadOptions): MystLoadResult;
+/** Directory-structure nav (best-effort; the author can curate nav.yml). */
+export declare function inferNav(pages: MystPageSource[], titles: Map<string, string>, hrefPrefix?: string): NavItem[];
+//# sourceMappingURL=load.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/loaders/load.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAI9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;CAC9D;AAKD,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAwB1D;AAiBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAoBrD;AAuCD,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,cAAc,CAiDnF;AAoCD,4EAA4E;AAC5E,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,UAAU,SAAK,GACd,OAAO,EAAE,CA4BX"}

package/dist/loaders/load.js

@@ -0,0 +1,265 @@
+/**
+ * MyST corpus loader — discover pages, build nav, detect the format.
+ *
+ * MyST content is Markdown (`.md`, sometimes `.ipynb`), so — unlike rST —
+ * "has .md files" can't be the signal. A MyST corpus is recognised by an
+ * explicit config/TOC (`myst.yml`, `_toc.yml`) OR by MyST-specific syntax
+ * (```` ```{directive} ````, `:::{directive}`, `` {role}`…` ``, `(target)=`)
+ * appearing across its Markdown. Registered BEFORE the generic dogsbay-md
+ * detector, AFTER GitBook/rST, so it never steals a plain-Markdown or
+ * GitBook corpus.
+ *
+ * Nav, in priority order:
+ *   1. `_toc.yml`   (Jupyter Book)
+ *   2. `myst.yml`   (mystmd `project.toc`)
+ *   3. `{toctree}`  directives, resolved recursively from the root doc
+ *   4. directory structure (best-effort fallback)
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, join, relative } from "node:path";
+import { parseMyst } from "../parse.js";
+import { parseJupyterToc, parseMystYmlToc, refToSlug } from "./toc.js";
+const SKIP_DIRS = new Set(["_build", "_static", "_templates", "node_modules", "dist", ".git"]);
+const MD_EXT = /\.(md|markdown)$/i;
+/** Slug for a source path relative to the docs root (README/index → index). */
+export function pathToSlug(rel) {
+    let p = rel.replace(/\\/g, "/").replace(MD_EXT, "");
+    if (p === "README" || p === "index")
+        return "index";
+    p = p.replace(/\/(README|index)$/i, "/index");
+    return p;
+}
+/** Walk `dir` for every Markdown page (skipping build/dot dirs). */
+export function walkMarkdown(dir) {
+    const out = [];
+    const walk = (d) => {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (name.startsWith(".") || SKIP_DIRS.has(name))
+                continue;
+            const full = join(d, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory())
+                walk(full);
+            else if (MD_EXT.test(name))
+                out.push({ filePath: full, slug: pathToSlug(relative(dir, full)) });
+        }
+    };
+    walk(dir);
+    return out;
+}
+// ── Detection ──────────────────────────────────────────────────────────────
+/** MyST directive / role / target markers used for syntax sniffing. */
+const MYST_MARKERS = [
+    /^```\{[a-zA-Z0-9_+-]+\}/m, // ```{note}
+    /^:::+\{[a-zA-Z0-9_+-]+\}/m, // :::{note}
+    /\{(?:ref|doc|eq|numref|math|sub|sup|abbr|kbd|download|term)\}`/, // roles
+    /^\([A-Za-z0-9_.:+-]+\)=\s*$/m, // (target)=
+];
+/** Does the file's text carry recognisable MyST syntax? */
+function hasMystSyntax(text) {
+    return MYST_MARKERS.some((re) => re.test(text));
+}
+/**
+ * Detect: does this directory look like a MyST corpus? A config/TOC file is
+ * a definitive signal; otherwise require MyST syntax in at least one sampled
+ * Markdown file (bounded scan — never read the whole tree).
+ */
+export function detectMyst(sourceDir) {
+    if (!existsSync(sourceDir))
+        return false;
+    try {
+        if (!statSync(sourceDir).isDirectory())
+            return false;
+    }
+    catch {
+        return false;
+    }
+    if (findConfig(sourceDir))
+        return true;
+    // Syntax sniff — sample up to 40 Markdown files.
+    const pages = walkMarkdown(sourceDir);
+    if (pages.length === 0)
+        return false;
+    for (const p of pages.slice(0, 40)) {
+        try {
+            if (hasMystSyntax(readFileSync(p.filePath, "utf-8")))
+                return true;
+        }
+        catch {
+            // unreadable — skip
+        }
+    }
+    return false;
+}
+/** Find a MyST config/TOC at (or one level under) the source root. */
+function findConfig(dir) {
+    for (const [file, kind] of [
+        ["_toc.yml", "_toc.yml"],
+        ["myst.yml", "myst.yml"],
+    ]) {
+        const p = join(dir, file);
+        if (existsSync(p))
+            return { kind, path: p, base: dir };
+    }
+    // One level down (a `docs/` or `content/` subdir).
+    let entries = [];
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    for (const name of entries) {
+        if (name.startsWith(".") || SKIP_DIRS.has(name))
+            continue;
+        const sub = join(dir, name);
+        try {
+            if (!statSync(sub).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        for (const [file, kind] of [
+            ["_toc.yml", "_toc.yml"],
+            ["myst.yml", "myst.yml"],
+        ]) {
+            const p = join(sub, file);
+            if (existsSync(p))
+                return { kind, path: p, base: sub };
+        }
+    }
+    return null;
+}
+export function loadMyst(source, opts = {}) {
+    const hrefPrefix = opts.hrefPrefix ?? "";
+    const cfg = findConfig(source);
+    const docsDir = cfg ? cfg.base : source;
+    const pages = walkMarkdown(docsDir);
+    const slugToHref = (slug) => slug === "index" ? `${hrefPrefix}/`.replace(/\/+$/, "/") : `${hrefPrefix}/${slug}`.replace(/\/+/g, "/");
+    // Titles + per-page toctree, parsed once (cheap — used for nav labels and
+    // toctree nav). Reused by the importer so pages aren't parsed twice there.
+    const titles = new Map();
+    const toctrees = new Map();
+    for (const p of pages) {
+        try {
+            const parsed = parseMyst(readFileSync(p.filePath, "utf-8"));
+            const t = (typeof parsed.frontmatter.title === "string" && parsed.frontmatter.title.trim()) ||
+                // Scan the translated BODY, not the full markdown — a `# comment`
+                // line inside YAML frontmatter must not be misread as the title.
+                firstHeading(parsed.body);
+            if (t)
+                titles.set(p.slug, t);
+            if (parsed.toctree.length)
+                toctrees.set(p.slug, parsed.toctree);
+        }
+        catch {
+            // unreadable/unparseable page — skip for nav; importer will report it
+        }
+    }
+    // 1 + 2: explicit config TOC.
+    if (cfg) {
+        const yamlText = readFileSync(cfg.path, "utf-8");
+        const toc = cfg.kind === "_toc.yml"
+            ? parseJupyterToc(yamlText, titles, slugToHref)
+            : parseMystYmlToc(yamlText, titles, slugToHref);
+        if (toc && toc.nav.length) {
+            return { pages, nav: toc.nav, docsDir, navSource: cfg.kind };
+        }
+    }
+    // 3: toctree-derived nav from the root doc.
+    const rootSlug = pages.some((p) => p.slug === "index") ? "index" : undefined;
+    if (rootSlug && toctrees.size > 0) {
+        const nav = buildToctreeNav(rootSlug, toctrees, titles, slugToHref, new Set());
+        if (nav.length)
+            return { pages, nav, docsDir, navSource: "toctree" };
+    }
+    // 4: directory-structure fallback.
+    return { pages, nav: inferNav(pages, titles, hrefPrefix), docsDir, navSource: "directory" };
+}
+/** First `# heading` text in a Markdown string, if any. */
+function firstHeading(md) {
+    const m = md.match(/^#\s+(.+?)\s*(\{#[^}]+\})?\s*$/m);
+    return m ? m[1].trim() : undefined;
+}
+/**
+ * Build nav by resolving `{toctree}` entries recursively from `slug`. A
+ * doc that itself has a toctree becomes a group whose children are its
+ * toctree entries. `seen` guards against cyclic toctrees.
+ */
+function buildToctreeNav(slug, toctrees, titles, slugToHref, seen) {
+    if (seen.has(slug))
+        return [];
+    seen.add(slug);
+    const entries = toctrees.get(slug) ?? [];
+    const out = [];
+    for (const ref of entries) {
+        if (ref.includes("*"))
+            continue; // globs need a walk; orphans cover them
+        const childSlug = refToSlug(ref);
+        const label = titles.get(childSlug) ?? prettify(childSlug);
+        const node = { label, href: slugToHref(childSlug) };
+        const grandkids = buildToctreeNav(childSlug, toctrees, titles, slugToHref, seen);
+        if (grandkids.length)
+            node.children = grandkids;
+        out.push(node);
+    }
+    return out;
+}
+/** Directory-structure nav (best-effort; the author can curate nav.yml). */
+export function inferNav(pages, titles, hrefPrefix = "") {
+    const root = [];
+    const groups = new Map();
+    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 group = { label: prettify(dir.slice(dir.lastIndexOf("/") + 1)), 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;
+        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") {
+            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(slug) {
+    const base = basename(slug);
+    return base
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+//# sourceMappingURL=load.js.map

package/dist/loaders/load.js.map

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

package/dist/loaders/toc.d.ts

@@ -0,0 +1,19 @@
+import type { NavItem } from "@dogsbay/types";
+/** Normalize a MyST doc reference to a root-relative slug. */
+export declare function refToSlug(ref: string): string;
+export interface TocResult {
+    nav: NavItem[];
+    /** Slugs referenced by the TOC, in order (root first). */
+    slugs: string[];
+}
+/**
+ * Parse a Jupyter Book `_toc.yml`. Returns null when the YAML isn't a
+ * jb-book TOC (so the caller can fall back to another nav source).
+ */
+export declare function parseJupyterToc(yamlText: string, titles: Map<string, string>, slugToHref: (slug: string) => string): TocResult | null;
+/**
+ * Parse a mystmd `myst.yml` `project.toc`. Returns null when there's no
+ * usable `project.toc`.
+ */
+export declare function parseMystYmlToc(yamlText: string, titles: Map<string, string>, slugToHref: (slug: string) => string): TocResult | null;
+//# sourceMappingURL=toc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../src/loaders/toc.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C;AAWD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACnC,SAAS,GAAG,IAAI,CAgElB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACnC,SAAS,GAAG,IAAI,CA8ClB"}