@dogsbay/format-mkdocs 0.2.0-beta.103 → 0.2.0-beta.109

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAqC,MAAM,gBAAgB,CAAC;AAGtF,eAAO,MAAM,MAAM,EAAE,YAiCpB,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAqC,MAAM,gBAAgB,CAAC;AAKtF,eAAO,MAAM,MAAM,EAAE,YA6GpB,CAAC"}

package/dist/cli.js

@@ -1,6 +1,8 @@
-import { existsSync } from "node:fs";
-import { join } from "node:path";
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, writeFileSync, copyFileSync } from "node:fs";
+import { dirname, extname, join } from "node:path";
 import { importMkdocsProject } from "./importer.js";
+import { exportMkdocsProject } from "./export/to-mkdocs-project.js";
+import { formatLedgerReport } from "@dogsbay/serialize-core";
 export const plugin = {
     name: "mkdocs",
     canImport: true,
@@ -12,7 +14,15 @@ export const plugin = {
         { flags: "--custom-css <files>", description: "Custom CSS files to copy (comma-separated)" },
         { flags: "--docusaurus-admonitions", description: "Enable Docusaurus-style ::: admonitions" },
     ],
-    exportOptions: [],
+    // NOT `--theme`: `dogsbay convert` already owns that flag for the Astro
+    // preset, with a default of "default" — which reached this exporter as
+    // `theme: name: default`, a theme MkDocs does not have, and every
+    // `convert --to mkdocs` project failed its first `mkdocs build`.
+    exportOptions: [
+        { flags: "--mkdocs-theme <name>", description: "MkDocs theme for the emitted mkdocs.yml (material | mkdocs | readthedocs)", default: "material" },
+        { flags: "--site-url <url>", description: "site_url for the emitted mkdocs.yml" },
+        { flags: "--repo-url <url>", description: "repo_url for the emitted mkdocs.yml" },
+    ],
     async import(source, opts) {
         const { pages, nav, config } = await importMkdocsProject(source, opts);
         // Attach config metadata for the exporter to consume
@@ -30,5 +40,100 @@ export const plugin = {
         // `{% include %}` in a page means a file under THERE.
         return { pages, nav, contentRoot: join(source, config.docsDir) };
     },
+    /**
+     * Export: TreeNode pages + nav → a complete MkDocs project.
+     *
+     * `exportMkdocsProject` is I/O-free and returns a path → content map, so
+     * everything this method does is create directories and write bytes. It was
+     * written and unit-tested long before it was reachable: `cli.ts` declared
+     * `canExport: true` with no `export` method, and `resolveExporter()` filters
+     * on `canExport && f.export`, so `--to mkdocs` reported an unknown target
+     * while the serializer sat in the same package. That predicate exists
+     * BECAUSE of this plugin.
+     */
+    async export(pages, nav, output, opts) {
+        const result = exportMkdocsProject(pages, nav, {
+            siteName: opts.siteName ?? "Documentation",
+            siteUrl: opts.siteUrl,
+            repoUrl: opts.repoUrl,
+            theme: mkdocsTheme(opts),
+        });
+        for (const [filePath, content] of result.files) {
+            const fullPath = join(output, filePath);
+            mkdirSync(dirname(fullPath), { recursive: true });
+            writeFileSync(fullPath, content);
+        }
+        console.log(`Generated ${result.files.size} MkDocs files`);
+        // Mounted asset dirs, copied under docs/ at the ROOT their refs were
+        // rewritten to (`_assets` for an imported corpus, `images`/`assets` for
+        // hand-authored content). The serializer emits those refs relative to
+        // each page, so the file has to land exactly there or every image 404s
+        // with a clean exit code.
+        const mounts = opts.assetMounts;
+        for (const mount of mounts ?? []) {
+            if (!existsSync(mount.dir))
+                continue;
+            const root = mount.root ?? "_assets";
+            const dest = mount.into ? join(output, "docs", root, mount.into) : join(output, "docs", root);
+            mkdirSync(dest, { recursive: true });
+            if (mount.mediaOnly) {
+                copyMediaTree(mount.dir, dest);
+                continue;
+            }
+            // Skip symlinks rather than copy them: relative links are rewritten to
+            // ABSOLUTE paths into the source checkout, so the output only works on
+            // the machine that produced it. AsciiBinder corpora are full of them.
+            cpSync(mount.dir, dest, {
+                recursive: true,
+                dereference: false,
+                filter: (src) => !lstatSync(src).isSymbolicLink(),
+            });
+        }
+        // Co-located media next to the markdown (the mkdocs shape itself).
+        const sourceDir = opts.sourceDir;
+        if (sourceDir && existsSync(sourceDir))
+            copyMediaTree(sourceDir, join(output, "docs"));
+        if (!result.ledger.isEmpty) {
+            console.log(formatLedgerReport(result.ledger, "mkdocs"));
+        }
+    },
 };
+const MEDIA_EXT = new Set([".png", ".jpg", ".jpeg", ".gif", ".svg", ".webp", ".avif", ".mp4", ".webm", ".pdf", ".ico"]);
+/**
+ * Copy media files only, preserving the directory shape. Never follows a
+ * symlink: AsciiBinder corpora symlink every section back to one images
+ * tree, and following them copied a 64 MB tree once per link.
+ */
+function copyMediaTree(from, to) {
+    for (const entry of readdirSync(from, { withFileTypes: true })) {
+        if (entry.isSymbolicLink())
+            continue;
+        const src = join(from, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === "node_modules" || entry.name.startsWith("."))
+                continue;
+            copyMediaTree(src, join(to, entry.name));
+            continue;
+        }
+        if (!MEDIA_EXT.has(extname(entry.name).toLowerCase()))
+            continue;
+        // Always copy. A same-size skip saved nothing measurable and silently
+        // kept a stale file when a one-character SVG edit left the size unchanged.
+        mkdirSync(to, { recursive: true });
+        copyFileSync(src, join(to, entry.name));
+    }
+}
+const MKDOCS_THEMES = new Set(["material", "mkdocs", "readthedocs"]);
+/**
+ * The MkDocs theme to write. `--mkdocs-theme` wins; a bare `theme` is honoured
+ * only when it names a theme MkDocs actually has, so the Astro preset default
+ * ("default") that `convert` passes through can never reach mkdocs.yml.
+ */
+function mkdocsTheme(opts) {
+    for (const candidate of [opts.mkdocsTheme, opts.theme]) {
+        if (typeof candidate === "string" && MKDOCS_THEMES.has(candidate))
+            return candidate;
+    }
+    return "material";
+}
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpE,aAAa,EAAE;QACb,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,kCAAkC,EAAE,OAAO,EAAE,SAAS,EAAE;QAChG,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,gDAAgD,EAAE;QAC3F,EAAE,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,4CAA4C,EAAE;QAC5F,EAAE,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,yCAAyC,EAAE;KAC9F;IACD,aAAa,EAAE,EAAE;IAEjB,KAAK,CAAC,MAAM,CACV,MAAc,EACd,IAA6B;QAE7B,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACvE,qDAAqD;QACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;QACpD,4DAA4D;QAC5D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,SAAiC,CAAC;QAC9D,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,CAAC;QACD,oEAAoE;QACpE,sDAAsD;QACtD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACnE,CAAC;CACF,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/export/to-mkdocs-project.d.ts

@@ -1,4 +1,5 @@
 import type { ExportPage, NavItem } from "@dogsbay/types";
+import { ExportLedger } from "@dogsbay/serialize-core";
 /**
  * Options for project export.
  */
@@ -18,6 +19,8 @@ export interface MkdocsProjectOptions {
 export interface MkdocsProjectExport {
     files: Map<string, string>;
     mkdocsYml: string;
+    /** What could not be represented, per page. Empty is the goal, not the assumption. */
+    ledger: ExportLedger;
 }
 /**
  * Export a set of pages + navigation to a complete MkDocs project.

package/dist/export/to-mkdocs-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-mkdocs-project.d.ts","sourceRoot":"","sources":["../../src/export/to-mkdocs-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EAAE,EACnB,GAAG,EAAE,OAAO,EAAE,EACd,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CAuBrB"}
+{"version":3,"file":"to-mkdocs-project.d.ts","sourceRoot":"","sources":["../../src/export/to-mkdocs-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAgC,MAAM,yBAAyB,CAAC;AAGrF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EAAE,EACnB,GAAG,EAAE,OAAO,EAAE,EACd,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CA6CrB"}

package/dist/export/to-mkdocs-project.js

@@ -1,26 +1,95 @@
-import { treeToMkdocs } from "./to-mkdocs.js";
+import { ExportLedger, frontmatterBlock, yamlScalar } from "@dogsbay/serialize-core";
+import { treeToMkdocs, hrefToSlugKey } from "./to-mkdocs.js";
 /**
  * Export a set of pages + navigation to a complete MkDocs project.
  * Returns file map (path → content) including mkdocs.yml and all .md files.
  */
 export function exportMkdocsProject(pages, nav, options) {
     const files = new Map();
+    const ledger = new ExportLedger();
+    const slugs = new Set(pages.map((p) => p.slug));
     // Generate markdown files
     const allTrees = [];
     for (const page of pages) {
-        const md = treeToMkdocs(page.tree);
-        const filePath = `docs/${page.slug}.md`;
-        files.set(filePath, md);
+        ledger.setPage(page.slug);
+        // A slug is a path under docs/. One that climbs out of it (`../x`),
+        // starts at the root, or carries a backslash is not a page name, it is a
+        // write outside the output tree. Refuse it, on the record.
+        if (!isSafeSlug(page.slug)) {
+            ledger.record({ feature: "page", action: "dropped", detail: `unsafe slug ${JSON.stringify(page.slug)} — not written` });
+            continue;
+        }
+        const path = `docs/${page.slug}.md`;
+        // Two pages on one slug (the importer strips `/index`, so `a.md` and
+        // `a/index.md` both arrive as `a`) used to overwrite silently — last one
+        // won, the ledger stayed empty, and the page count said 4 while 3 files
+        // existed. Keep the first, record the second.
+        if (files.has(path)) {
+            ledger.record({ feature: "page", action: "dropped", detail: `duplicate slug ${page.slug} — a second page with this slug was not written` });
+            continue;
+        }
+        const body = treeToMkdocs(page.tree, { pageSlug: page.slug, slugs, ledger });
+        // MkDocs reads `title:` from page meta; without it the nav label falls back
+        // to the first heading (fine) or the filename (not fine).
+        const fm = pageFrontmatter(page, ledger);
+        files.set(path, fm ? `${fm}\n\n${body}\n` : `${body}\n`);
         allTrees.push(page.tree);
     }
+    ledger.setPage(undefined);
     // Auto-detect required extensions from tree content
     const extensions = detectExtensions(allTrees, options.extraExtensions);
     // Convert nav to mkdocs.yml nav format
-    const navYaml = navToYaml(nav, pages);
+    const navYaml = navToYaml(nav, slugs, ledger);
     // Generate mkdocs.yml
     const yml = buildMkdocsYml(options, extensions, navYaml);
     files.set("mkdocs.yml", yml);
-    return { files, mkdocsYml: yml };
+    return { files, mkdocsYml: yml, ledger };
+}
+function isSafeSlug(slug) {
+    if (!slug || slug.startsWith("/") || slug.includes("\\"))
+        return false;
+    return !slug.split("/").some((seg) => seg === ".." || seg === "." || seg === "");
+}
+/**
+ * Frontmatter keys MkDocs Material reads from page meta. Anything else the
+ * source carried is recorded as dropped rather than silently discarded — a
+ * mkdocs → mkdocs round trip that loses `tags:` looks like success otherwise.
+ */
+const MATERIAL_META = new Set(["tags", "hide", "status", "template", "icon", "search", "subtitle"]);
+function pageFrontmatter(page, ledger) {
+    const fm = (page.frontmatter ?? {});
+    const entries = [];
+    const rawTitle = fm.title ?? page.title;
+    const title = typeof rawTitle === "string" ? rawTitle : page.title;
+    if (title)
+        entries.push(["title", title]);
+    if (typeof fm.description === "string")
+        entries.push(["description", fm.description]);
+    const extra = [];
+    for (const [key, value] of Object.entries(fm)) {
+        if (key === "title" || key === "description")
+            continue;
+        if (MATERIAL_META.has(key)) {
+            if (Array.isArray(value) && value.every((v) => typeof v === "string" || typeof v === "number")) {
+                extra.push(`${key}:\n${value.map((v) => `  - ${yamlScalar(String(v))}`).join("\n")}`);
+            }
+            else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+                extra.push(`${key}: ${typeof value === "string" ? yamlScalar(value) : String(value)}`);
+            }
+            else {
+                ledger.record({ feature: `frontmatter:${key}`, action: "dropped", detail: "unsupported value shape" });
+            }
+            continue;
+        }
+        ledger.record({ feature: `frontmatter:${key}`, action: "dropped", detail: "no MkDocs equivalent" });
+    }
+    if (entries.length === 0 && extra.length === 0)
+        return "";
+    const base = entries.length ? frontmatterBlock(entries) : "";
+    if (!extra.length)
+        return base;
+    const inner = base ? base.replace(/\n---$/, "") : "---";
+    return `${inner}\n${extra.join("\n")}\n---`;
 }
 // ── Extension Detection ─────────────────────────────────────────
 /**
@@ -29,8 +98,12 @@ export function exportMkdocsProject(pages, nav, options) {
  */
 function detectExtensions(allTrees, extra) {
     const found = new Set();
-    // Always include these basics
+    // Always-on. `attr_list` because every heading carries `{ #id }`; the rest
+    // are cheap and what the serializer emits assumes them.
     found.add("toc:\n    permalink: true");
+    found.add("attr_list");
+    found.add("md_in_html");
+    found.add("tables");
     for (const tree of allTrees) {
         walkForExtensions(tree, found);
     }
@@ -53,40 +126,92 @@ function walkForExtensions(nodes, found) {
             case "tabs":
             case "tab":
                 found.add("pymdownx.tabbed:\n    alternate_style: true");
+                found.add("pymdownx.superfences");
                 break;
-            case "code": {
+            case "code":
                 found.add("pymdownx.highlight:\n    anchor_linenums: true");
                 found.add("pymdownx.superfences");
-                if (node.props?.hasAnnotations) {
-                    found.add("pymdownx.superfences");
-                }
                 break;
-            }
+            case "diagram":
+                found.add("pymdownx.superfences:\n    custom_fences:\n      - name: mermaid\n        class: mermaid\n        format: !!python/name:pymdownx.superfences.fence_code_format");
+                break;
             case "deflist":
             case "dt":
             case "dd":
                 found.add("def_list");
                 break;
-            case "html-container":
-                found.add("md_in_html");
-                break;
             case "task-list":
             case "task-item":
                 found.add("pymdownx.tasklist:\n    custom_checkbox: true");
                 break;
+            // Checkboxes are `list-item` nodes with `props.checked` — the shape the
+            // parser emits and the serializer reads; there is no `task-item` node.
+            case "list-item":
+                if (node.props?.checked !== undefined)
+                    found.add("pymdownx.tasklist:\n    custom_checkbox: true");
+                break;
             case "math":
+            case "math-block":
             case "math-inline":
                 found.add("pymdownx.arithmatex:\n    generic: true");
                 break;
             case "footnote":
-            case "footnote-ref":
+            case "footnote-list":
+            case "footnote-def":
                 found.add("footnotes");
                 break;
+            // The serializer emits `:octicons-arrow-right-24:` on a card link.
+            case "card":
+            case "cards":
+            case "link-card":
+                found.add(EMOJI_EXT);
+                break;
+            // An unrealized include is emitted as `--8<-- "path"`.
+            case "include":
+                found.add("pymdownx.snippets");
+                break;
         }
+        if (node.inline)
+            walkInlineForExtensions(node.inline, found);
         if (node.children)
             walkForExtensions(node.children, found);
     }
 }
+const EMOJI_EXT = "pymdownx.emoji:\n    emoji_index: !!python/name:material.extensions.emoji.twemoji\n    emoji_generator: !!python/name:material.extensions.emoji.to_svg";
+/**
+ * Inline nodes NEST — a highlight inside a link, a struck span inside bold.
+ * Walking one level detected `==x==` at top level and missed the same mark
+ * one link deeper, so the extension was absent and the marks rendered as
+ * literal `==`.
+ */
+function walkInlineForExtensions(nodes, found) {
+    for (const inline of nodes) {
+        switch (inline.type) {
+            case "footnote-ref":
+                found.add("footnotes");
+                break;
+            case "highlight":
+                found.add("pymdownx.mark");
+                break;
+            case "kbd":
+                found.add("pymdownx.keys");
+                break;
+            case "math":
+                found.add("pymdownx.arithmatex:\n    generic: true");
+                break;
+            case "icon":
+                found.add(EMOJI_EXT);
+                break;
+            case "text":
+                if (inline.strikethrough)
+                    found.add("pymdownx.tilde");
+                break;
+        }
+        const kids = inline.children;
+        if (kids)
+            walkInlineForExtensions(kids, found);
+    }
+}
 // ── Nav Conversion ──────────────────────────────────────────────
 /**
  * Convert NavItem[] to mkdocs.yml nav YAML string.
@@ -95,82 +220,89 @@ function walkForExtensions(nodes, found) {
  *   - Home: index.md
  *   - Section:
  *       - Page: path.md
+ *
+ * An href is matched EXACTLY against the exported slugs (after stripping the
+ * origin, query, fragment and slashes). The previous last-segment fuzzy match
+ * would map `/installing/index/` to whichever page's slug ended in `index`
+ * first — wrong for any corpus with more than one index page.
  */
-function navToYaml(items, pages, indent = 2) {
+function navToYaml(items, slugs, ledger, indent = 2) {
     const lines = [];
     const prefix = " ".repeat(indent);
     for (const item of items) {
-        if (item.children && item.children.length > 0) {
-            // Group with children
-            if (item.href) {
-                // Group has its own page + children
-                lines.push(`${prefix}- ${item.label}:`);
-                const slug = hrefToSlug(item.href, pages);
-                if (slug) {
-                    lines.push(`${prefix}    - ${item.label}: ${slug}.md`);
-                }
-                lines.push(navToYaml(item.children, pages, indent + 4));
-            }
-            else {
-                // Group without own page
-                lines.push(`${prefix}- ${item.label}:`);
-                lines.push(navToYaml(item.children, pages, indent + 4));
-            }
+        const label = yamlScalar(item.label ?? "");
+        const target = item.href ? navTarget(item.href, slugs) : null;
+        // Children FIRST, so a group whose entries all failed to resolve is
+        // skipped rather than emitted as `- Group:` — a null section, which is a
+        // hard `mkdocs build` configuration abort, not a warning.
+        const inner = item.children?.length ? navToYaml(item.children, slugs, ledger, indent + 4) : "";
+        if (item.href && !target) {
+            ledger.record({ feature: "nav-entry", action: "dropped", detail: `${item.label ?? ""} → ${item.href}: not an exported page` });
         }
-        else if (item.href) {
-            // Leaf page
-            const slug = hrefToSlug(item.href, pages);
-            if (slug) {
-                lines.push(`${prefix}- ${item.label}: ${slug}.md`);
-            }
+        if (inner) {
+            lines.push(`${prefix}- ${label}:`);
+            if (target)
+                lines.push(`${prefix}    - ${label}: ${target}`);
+            lines.push(inner);
+        }
+        else if (target) {
+            lines.push(`${prefix}- ${label}: ${target}`);
+        }
+        else if (item.children?.length) {
+            ledger.record({ feature: "nav-entry", action: "dropped", detail: `${item.label ?? ""}: section with no exported pages` });
         }
     }
     return lines.filter(Boolean).join("\n");
 }
 /**
- * Convert an href ("/mkdocs/configuring") to a slug ("configuring")
- * by matching against known pages.
+ * What a nav href becomes in mkdocs.yml: a `slug.md` for an exported page,
+ * the URL itself for an external link (MkDocs supports `- Label: https://…`
+ * natively), or null when it names nothing we emit.
  */
-function hrefToSlug(href, pages) {
-    // Strip leading path prefix — take the last segment(s)
-    const parts = href.replace(/^\//, "").split("/");
-    // Try matching against page slugs
-    for (const page of pages) {
-        // Exact match on slug
-        if (parts.join("/") === page.slug || parts.slice(1).join("/") === page.slug) {
-            return page.slug;
-        }
-        // Match on last segment
-        if (parts[parts.length - 1] === page.slug.split("/").pop()) {
-            return page.slug;
-        }
-    }
-    // Fallback: use last path segment
-    return parts[parts.length - 1] || null;
+function navTarget(href, slugs) {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith("//"))
+        return href;
+    const slug = hrefToSlug(href, slugs);
+    return slug ? `${slug}.md` : null;
+}
+function hrefToSlug(href, slugs) {
+    const key = hrefToSlugKey(href);
+    if (slugs.has(key))
+        return key;
+    if (slugs.has(`${key}/index`))
+        return `${key}/index`;
+    if (key === "" && slugs.has("index"))
+        return "index";
+    return null;
 }
 // ── YAML Generation ─────────────────────────────────────────────
 function buildMkdocsYml(options, extensions, navYaml) {
     const lines = [];
-    lines.push(`site_name: ${options.siteName}`);
+    lines.push(`site_name: ${yamlScalar(options.siteName)}`);
     if (options.siteUrl)
-        lines.push(`site_url: ${options.siteUrl}`);
+        lines.push(`site_url: ${yamlScalar(options.siteUrl)}`);
     if (options.repoUrl)
-        lines.push(`repo_url: ${options.repoUrl}`);
+        lines.push(`repo_url: ${yamlScalar(options.repoUrl)}`);
+    lines.push("use_directory_urls: true");
     lines.push("");
     // Theme
     lines.push("theme:");
     lines.push(`  name: ${options.theme ?? "material"}`);
     lines.push("  features:");
     lines.push("    - content.code.copy");
-    lines.push("    - navigation.instant");
+    lines.push("    - content.tabs.link");
     lines.push("    - navigation.tracking");
     lines.push("    - navigation.sections");
-    lines.push("    - toc.integrate");
+    lines.push("    - navigation.indexes");
+    lines.push("    - navigation.top");
+    lines.push("    - toc.follow");
     lines.push("");
     // Nav
-    lines.push("nav:");
-    lines.push(navYaml);
-    lines.push("");
+    if (navYaml) {
+        lines.push("nav:");
+        lines.push(navYaml);
+        lines.push("");
+    }
     // Extensions
     lines.push("markdown_extensions:");
     for (const ext of extensions) {
@@ -179,7 +311,7 @@ function buildMkdocsYml(options, extensions, navYaml) {
             const extLines = ext.split("\n");
             lines.push(`  - ${extLines[0]}`);
             for (let i = 1; i < extLines.length; i++) {
-                lines.push(`      ${extLines[i].trimStart()}`);
+                lines.push(`  ${extLines[i]}`);
             }
         }
         else {

package/dist/export/to-mkdocs-project.js.map

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

package/dist/export/to-mkdocs.d.ts

@@ -1,6 +1,56 @@
-import type { TreeNode } from "../tree.js";
 /**
- * Convert a TreeNode[] back to MkDocs-compatible Markdown.
+ * MkDocs serializer — TreeNode[] → MkDocs (Python-Markdown + PyMdown) Markdown.
+ *
+ * Built on `@dogsbay/serialize-core`: shape-tolerant leaf reads, the shared
+ * inline walk, and a ledger for what could not be represented. The first
+ * version of this file predated the core and read `node.children` only, so
+ * every heading and paragraph parsed from real dogsbay-md — where the text is
+ * on `node.inline` — serialized as `# ` with no title. The tier-3 export
+ * conformance suite caught it the moment the exporter was wired in.
+ *
+ * Python-Markdown differs from CommonMark in ways that matter here:
+ *
+ * - Nested block content inside a list item, admonition or tab must be
+ *   indented by FOUR spaces. Two-space continuation (fine in CommonMark)
+ *   detaches the block and renders it at top level.
+ * - There is no native tabs/steps/cards syntax; PyMdown supplies
+ *   `=== "Tab"`, and the rest is expressed with `attr_list` / `md_in_html`.
+ * - Heading ids come from `attr_list` (`# Title { #id }`), and the corpus
+ *   cross-references depend on the AUTHORED ids surviving — AsciiDoc-derived
+ *   ids like `additional-resources_welcome-index` would not be regenerated by
+ *   the toc extension's slugifier.
  */
-export declare function treeToMkdocs(nodes: TreeNode[]): string;
+import type { TreeNode, NavItem } from "@dogsbay/types";
+import { ExportLedger } from "@dogsbay/serialize-core";
+export interface MkdocsSerializeOptions {
+    /**
+     * Slug of the page being serialized (`welcome/oke_about`). Used to make
+     * site-rooted links (`/welcome/index/#anchor`) and asset refs
+     * (`/images/x.png`) RELATIVE to the emitted file, which is how MkDocs
+     * resolves and validates them. Without it links are emitted verbatim.
+     */
+    pageSlug?: string;
+    /**
+     * Every page slug in the export. A site-rooted href is rewritten to a
+     * relative `.md` link only when it names a page we are actually emitting;
+     * anything else (an asset, an external route) is left alone.
+     */
+    slugs?: ReadonlySet<string>;
+    /** Loss recorder. One per export run; entries are stamped with the page. */
+    ledger?: ExportLedger;
+}
+/**
+ * Convert a TreeNode[] to MkDocs-compatible Markdown.
+ */
+export declare function treeToMkdocs(nodes: TreeNode[], options?: MkdocsSerializeOptions): string;
+/**
+ * Site-rooted page links → relative `.md` links, which MkDocs resolves,
+ * validates, and rewrites for `use_directory_urls`. Only rewritten when the
+ * target is a page in this export; everything else passes through so an
+ * asset or external route is never turned into a dead `.md`.
+ */
+export declare function mkdocsHref(href: string): string;
+/** Normalise an href or slug to the slug form pages are keyed by. */
+export declare function hrefToSlugKey(href: string): string;
+export type { NavItem };
 //# sourceMappingURL=to-mkdocs.d.ts.map

package/dist/export/to-mkdocs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-mkdocs.d.ts","sourceRoot":"","sources":["../../src/export/to-mkdocs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"to-mkdocs.d.ts","sourceRoot":"","sources":["../../src/export/to-mkdocs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAc,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAcL,YAAY,EAEb,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AASD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAQ5F;AAyUD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB/C;AAgiBD,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,YAAY,EAAE,OAAO,EAAE,CAAC"}