@dogsbay/format-myst 0.2.0-beta.101

package/dist/loaders/toc.js

@@ -0,0 +1,154 @@
+/**
+ * Explicit MyST tables of contents:
+ *   - `_toc.yml`  — Jupyter Book (`format: jb-book`, root/parts/chapters/sections)
+ *   - `myst.yml`  — mystmd project config (`project.toc`, file/title/children)
+ *
+ * Both resolve to `NavItem[]`. Doc references (extensionless or `.md`) are
+ * turned into slugs + hrefs via the caller-supplied `slugToHref`.
+ */
+import { parse as parseYaml } from "yaml";
+/** Normalize a MyST doc reference to a root-relative slug. */
+export function refToSlug(ref) {
+    let p = String(ref).replace(/\\/g, "/").trim();
+    p = p.replace(/\.(md|ipynb|rst|myst)$/i, "");
+    p = p.replace(/^\.\//, "").replace(/^\//, "");
+    if (p === "README" || p === "index")
+        return "index";
+    p = p.replace(/\/(README|index)$/i, "/index");
+    return p;
+}
+function prettify(slug) {
+    const base = slug.slice(slug.lastIndexOf("/") + 1);
+    return base
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+/**
+ * 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 function parseJupyterToc(yamlText, titles, slugToHref) {
+    let doc;
+    try {
+        doc = parseYaml(yamlText);
+    }
+    catch {
+        return null;
+    }
+    if (!doc || typeof doc !== "object")
+        return null;
+    const d = doc;
+    if (typeof d.root !== "string")
+        return null;
+    const slugs = [];
+    const label = (slug) => titles.get(slug) ?? prettify(slug);
+    const leaf = (ref) => {
+        const slug = refToSlug(ref);
+        slugs.push(slug);
+        return { label: label(slug), href: slugToHref(slug) };
+    };
+    // A "chapter"/"section" entry: { file, sections?: [...], title? }.
+    const entryToNav = (raw) => {
+        if (!raw || typeof raw !== "object")
+            return null;
+        const e = raw;
+        if (typeof e.file !== "string" && typeof e.url !== "string" && typeof e.glob !== "string") {
+            return null;
+        }
+        if (typeof e.url === "string") {
+            return { label: typeof e.title === "string" ? e.title : e.url, href: e.url };
+        }
+        if (typeof e.glob === "string")
+            return null; // globs need a filesystem walk; caller handles orphans
+        const slug = refToSlug(e.file);
+        slugs.push(slug);
+        const node = {
+            label: typeof e.title === "string" ? e.title : label(slug),
+            href: slugToHref(slug),
+        };
+        const subs = (e.sections ?? e.chapters);
+        if (Array.isArray(subs)) {
+            const children = subs.map(entryToNav).filter((n) => n !== null);
+            if (children.length)
+                node.children = children;
+        }
+        return node;
+    };
+    const nav = [];
+    // Root is the landing page — not usually a nav entry itself, but record it.
+    slugs.push(refToSlug(d.root));
+    if (Array.isArray(d.parts)) {
+        for (const part of d.parts) {
+            if (!part || typeof part !== "object")
+                continue;
+            const p = part;
+            const caption = typeof p.caption === "string" ? p.caption : "Section";
+            const chapters = Array.isArray(p.chapters) ? p.chapters : [];
+            const children = chapters.map(entryToNav).filter((n) => n !== null);
+            nav.push({ label: caption, children });
+        }
+    }
+    else if (Array.isArray(d.chapters)) {
+        for (const ch of d.chapters) {
+            const n = entryToNav(ch);
+            if (n)
+                nav.push(n);
+        }
+    }
+    return { nav, slugs };
+}
+/**
+ * Parse a mystmd `myst.yml` `project.toc`. Returns null when there's no
+ * usable `project.toc`.
+ */
+export function parseMystYmlToc(yamlText, titles, slugToHref) {
+    let doc;
+    try {
+        doc = parseYaml(yamlText);
+    }
+    catch {
+        return null;
+    }
+    const project = doc?.project;
+    const toc = project?.toc;
+    if (!Array.isArray(toc))
+        return null;
+    const slugs = [];
+    const label = (slug) => titles.get(slug) ?? prettify(slug);
+    const entryToNav = (raw) => {
+        if (!raw || typeof raw !== "object")
+            return null;
+        const e = raw;
+        if (typeof e.file === "string") {
+            const slug = refToSlug(e.file);
+            slugs.push(slug);
+            const node = {
+                label: typeof e.title === "string" ? e.title : label(slug),
+                href: slugToHref(slug),
+            };
+            if (Array.isArray(e.children)) {
+                const kids = e.children.map(entryToNav).filter((n) => n !== null);
+                if (kids.length)
+                    node.children = kids;
+            }
+            return node;
+        }
+        if (typeof e.url === "string") {
+            return { label: typeof e.title === "string" ? e.title : e.url, href: e.url };
+        }
+        if (typeof e.title === "string") {
+            // A titled group with children but no file of its own.
+            const node = { label: e.title, children: [] };
+            if (Array.isArray(e.children)) {
+                node.children = e.children.map(entryToNav).filter((n) => n !== null);
+            }
+            return node;
+        }
+        return null;
+    };
+    const nav = toc.map(entryToNav).filter((n) => n !== null);
+    return { nav, slugs };
+}
+//# sourceMappingURL=toc.js.map

package/dist/loaders/toc.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,15 @@
+import type { TreeNode } from "@dogsbay/types";
+import { type TranslateLedgerEntry } from "./translate.js";
+export interface ParseMystResult {
+    tree: TreeNode[];
+    frontmatter: Record<string, unknown>;
+    /** Frontmatter + translated body — the editable Dogsbay-MD for migrate. */
+    markdown: string;
+    /** Translated body only (no frontmatter). */
+    body: string;
+    ledger: TranslateLedgerEntry[];
+    /** In-body `{toctree}` references, in document order. */
+    toctree: string[];
+}
+export declare function parseMyst(src: string): ParseMystResult;
+//# 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":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAmBtD"}

package/dist/parse.js

@@ -0,0 +1,37 @@
+/**
+ * MyST page → { tree, frontmatter, markdown, body, ledger, toctree }.
+ *
+ * Pipeline (mirrors format-gitbook):
+ *   1. Split YAML frontmatter off the body so the body transform can't
+ *      disturb it.
+ *   2. Translate the MyST body → Dogsbay-MD text (`mystToDogsbayMd`).
+ *   3. Parse the translated Dogsbay-MD with the canonical `dogsbayMdToTree`
+ *      — MyST is a near-superset of CommonMark, so once the directives /
+ *      roles / targets are rewritten, its own parser defines correctness
+ *      and yields the TreeNode with zero new node types.
+ *
+ * `markdown` (frontmatter + translated body) is what `migrate-myst` writes
+ * to disk. `toctree` carries any in-body `{toctree}` entries so the loader
+ * can build nav.
+ */
+import { dogsbayMdToTree } from "@dogsbay/format-dogsbay-md";
+import { mystToDogsbayMd } from "./translate.js";
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?/;
+export function parseMyst(src) {
+    const normalized = src.replace(/\r\n?/g, "\n");
+    const fmMatch = normalized.match(FRONTMATTER_RE);
+    const fmBlock = fmMatch ? fmMatch[0] : "";
+    const body = fmMatch ? normalized.slice(fmMatch[0].length) : normalized;
+    const { markdown: translatedBody, ledger, toctree } = mystToDogsbayMd(body);
+    const markdown = fmBlock ? `${fmBlock.replace(/\n?$/, "\n")}\n${translatedBody}` : translatedBody;
+    const { tree, frontmatter } = dogsbayMdToTree(markdown);
+    return {
+        tree,
+        frontmatter: frontmatter ?? {},
+        markdown,
+        body: translatedBody,
+        ledger,
+        toctree,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAA6B,MAAM,gBAAgB,CAAC;AAc5E,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAExE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,cAAc,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAElG,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAExD,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,WAAW,IAAI,EAAE;QAC9B,QAAQ;QACR,IAAI,EAAE,cAAc;QACpB,MAAM;QACN,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/translate.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MyST Markdown → Dogsbay-MD text translator.
+ *
+ * MyST (Markedly Structured Text) is CommonMark + Sphinx-style
+ * **directives**, **roles**, and **targets**. Dogsbay-MD is CommonMark +
+ * `:::` block directives + `{attrs}`. So — exactly like the GitBook and
+ * AsciiDoc pipelines — translation is largely a delimiter rewrite: prose,
+ * lists, tables, and normal fenced code pass through untouched; only the
+ * MyST-specific constructs are rewritten, after which the canonical
+ * `dogsbayMdToTree` parser is the definition of correctness (zero new
+ * TreeNode types).
+ *
+ * Three MyST construct classes:
+ *   - **Directives** — a fenced block, either ```` ```{name} ```` (backtick)
+ *     or `:::{name}` (colon fence). An optional argument follows the name on
+ *     the opener line; `:key: value` option lines may follow; then a blank
+ *     line and the body. These map to `:::` block directives (callouts,
+ *     tabs, grid, details, figure, math, code) and can NEST — emitted with
+ *     DEPTH-AWARE fence lengths (outer gets more colons), mirroring
+ *     format-dogsbay-md's serializer and format-gitbook's translator.
+ *   - **Roles** — inline ``{name}`content` `` → a link / math / `<sub>` /
+ *     code span / emphasis, per role.
+ *   - **Targets** — `(label)=` on its own line before a block → a `{#label}`
+ *     anchor on the following heading (or a bare `<a id>` otherwise), so
+ *     `{ref}`label`` cross-references resolve.
+ *
+ * Fence-aware throughout: MyST syntax inside a plain fenced code block is
+ * literal and never rewritten. Anything unmapped is recorded in the
+ * returned `ledger` (never silent loss — same discipline as format-dita /
+ * format-gitbook) and passed through as best-effort text.
+ *
+ * See plans/format-myst.md.
+ */
+export interface TranslateLedgerEntry {
+    /** The MyST construct that wasn't cleanly mapped. */
+    construct: string;
+    /** Human-readable note on how it was handled. */
+    note: string;
+    /** 1-based source line, when known. */
+    line?: number;
+}
+export interface TranslateResult {
+    markdown: string;
+    ledger: TranslateLedgerEntry[];
+    /**
+     * `toctree` entries collected from the body, in document order, so a
+     * loader can build nav without re-parsing. Each is a raw reference
+     * (a doc path or glob) exactly as authored.
+     */
+    toctree: string[];
+}
+export declare function mystToDogsbayMd(src: string): TranslateResult;
+//# sourceMappingURL=translate.d.ts.map

package/dist/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAwID,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAM5D"}