@dogsbay/format-mkdocs 0.2.0-beta.0

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

@@ -0,0 +1,192 @@
+import { treeToMkdocs } 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();
+    // 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);
+        allTrees.push(page.tree);
+    }
+    // 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);
+    // Generate mkdocs.yml
+    const yml = buildMkdocsYml(options, extensions, navYaml);
+    files.set("mkdocs.yml", yml);
+    return { files, mkdocsYml: yml };
+}
+// ── Extension Detection ─────────────────────────────────────────
+/**
+ * Walk all trees and detect which MkDocs extensions are needed
+ * based on which TreeNode types appear.
+ */
+function detectExtensions(allTrees, extra) {
+    const found = new Set();
+    // Always include these basics
+    found.add("toc:\n    permalink: true");
+    for (const tree of allTrees) {
+        walkForExtensions(tree, found);
+    }
+    if (extra) {
+        for (const e of extra)
+            found.add(e);
+    }
+    return [...found];
+}
+function walkForExtensions(nodes, found) {
+    for (const node of nodes) {
+        switch (node.type) {
+            case "callout":
+                found.add("admonition");
+                break;
+            case "details":
+                found.add("admonition");
+                found.add("pymdownx.details");
+                break;
+            case "tabs":
+            case "tab":
+                found.add("pymdownx.tabbed:\n    alternate_style: true");
+                break;
+            case "code": {
+                found.add("pymdownx.highlight:\n    anchor_linenums: true");
+                found.add("pymdownx.superfences");
+                if (node.props?.hasAnnotations) {
+                    found.add("pymdownx.superfences");
+                }
+                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;
+            case "math":
+            case "math-inline":
+                found.add("pymdownx.arithmatex:\n    generic: true");
+                break;
+            case "footnote":
+            case "footnote-ref":
+                found.add("footnotes");
+                break;
+        }
+        if (node.children)
+            walkForExtensions(node.children, found);
+    }
+}
+// ── Nav Conversion ──────────────────────────────────────────────
+/**
+ * Convert NavItem[] to mkdocs.yml nav YAML string.
+ *
+ * MkDocs nav format:
+ *   - Home: index.md
+ *   - Section:
+ *       - Page: path.md
+ */
+function navToYaml(items, pages, 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));
+            }
+        }
+        else if (item.href) {
+            // Leaf page
+            const slug = hrefToSlug(item.href, pages);
+            if (slug) {
+                lines.push(`${prefix}- ${item.label}: ${slug}.md`);
+            }
+        }
+    }
+    return lines.filter(Boolean).join("\n");
+}
+/**
+ * Convert an href ("/mkdocs/configuring") to a slug ("configuring")
+ * by matching against known pages.
+ */
+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;
+}
+// ── YAML Generation ─────────────────────────────────────────────
+function buildMkdocsYml(options, extensions, navYaml) {
+    const lines = [];
+    lines.push(`site_name: ${options.siteName}`);
+    if (options.siteUrl)
+        lines.push(`site_url: ${options.siteUrl}`);
+    if (options.repoUrl)
+        lines.push(`repo_url: ${options.repoUrl}`);
+    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("    - navigation.tracking");
+    lines.push("    - navigation.sections");
+    lines.push("    - toc.integrate");
+    lines.push("");
+    // Nav
+    lines.push("nav:");
+    lines.push(navYaml);
+    lines.push("");
+    // Extensions
+    lines.push("markdown_extensions:");
+    for (const ext of extensions) {
+        if (ext.includes("\n")) {
+            // Multi-line extension config (e.g. "pymdownx.tabbed:\n    alternate_style: true")
+            const extLines = ext.split("\n");
+            lines.push(`  - ${extLines[0]}`);
+            for (let i = 1; i < extLines.length; i++) {
+                lines.push(`      ${extLines[i].trimStart()}`);
+            }
+        }
+        else {
+            lines.push(`  - ${ext}`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=to-mkdocs-project.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,6 @@
+import type { TreeNode } from "../tree.js";
+/**
+ * Convert a TreeNode[] back to MkDocs-compatible Markdown.
+ */
+export declare function treeToMkdocs(nodes: TreeNode[]): string;
+//# sourceMappingURL=to-mkdocs.d.ts.map

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

@@ -0,0 +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"}

package/dist/export/to-mkdocs.js

@@ -0,0 +1,178 @@
+/**
+ * Convert a TreeNode[] back to MkDocs-compatible Markdown.
+ */
+export function treeToMkdocs(nodes) {
+    return nodes.map(nodeToMkdocs).join("\n\n");
+}
+function nodeToMkdocs(node) {
+    switch (node.type) {
+        case "frontmatter":
+            return `---\n${node.props?.content ?? ""}\n---`;
+        case "references":
+            return referencesToMkdocs(node);
+        case "callout":
+            return calloutToMkdocs(node);
+        case "details":
+            return detailsToMkdocs(node);
+        case "tabs":
+            return tabsToMkdocs(node);
+        case "tab":
+            return tabToMkdocs(node);
+        case "code":
+            return codeToMkdocs(node);
+        case "diagram":
+            return diagramToMkdocs(node);
+        case "annotation-list":
+            return annotationListToMkdocs(node);
+        case "heading":
+            return headingToMkdocs(node);
+        case "paragraph":
+            return childrenToMkdocs(node);
+        case "prose":
+            return node.html ?? "";
+        case "blockquote":
+            return blockquoteToMkdocs(node);
+        case "ordered-list":
+            return orderedListToMkdocs(node);
+        case "unordered-list":
+            return unorderedListToMkdocs(node);
+        case "list-item":
+            return childrenToMkdocs(node);
+        case "html-container":
+            return htmlContainerToMkdocs(node);
+        case "hr":
+            return "---";
+        case "html":
+            return node.html ?? "";
+        default:
+            return node.html ?? childrenToMkdocs(node);
+    }
+}
+function calloutToMkdocs(node) {
+    const variant = node.props?.variant ?? "note";
+    const title = node.props?.title;
+    const inline = node.props?.inline;
+    let opener = "!!!";
+    let line = `${opener} ${variant}`;
+    if (inline)
+        line += ` ${inline}`;
+    line += titleSuffix(variant, title);
+    const inner = childrenToMkdocs(node);
+    if (!inner)
+        return line;
+    return `${line}\n\n${indent(inner, 4)}`;
+}
+function detailsToMkdocs(node) {
+    const variant = node.props?.variant ?? "note";
+    const title = node.props?.title;
+    const open = node.props?.open;
+    const opener = open ? "???+" : "???";
+    let line = `${opener} ${variant}`;
+    line += titleSuffix(variant, title);
+    const inner = childrenToMkdocs(node);
+    if (!inner)
+        return line;
+    return `${line}\n\n${indent(inner, 4)}`;
+}
+function tabsToMkdocs(node) {
+    if (!node.children)
+        return "";
+    return node.children.map(nodeToMkdocs).join("\n\n");
+}
+function tabToMkdocs(node) {
+    const title = node.props?.title ?? "Tab";
+    const inner = childrenToMkdocs(node);
+    if (!inner)
+        return `=== "${title}"`;
+    return `=== "${title}"\n\n${indent(inner, 4)}`;
+}
+function codeToMkdocs(node) {
+    const lang = node.props?.lang ?? "";
+    const code = (node.props?.code ?? "").replace(/\n$/, "");
+    const fence = node.props?.fence ?? "```";
+    return `${fence}${lang}\n${code}\n${fence}`;
+}
+function diagramToMkdocs(node) {
+    const lang = node.props?.lang ?? "mermaid";
+    const code = (node.props?.code ?? "").replace(/\n$/, "");
+    return `\`\`\`${lang}\n${code}\n\`\`\``;
+}
+function referencesToMkdocs(node) {
+    const entries = (node.props?.entries ?? []);
+    return entries
+        .map((e) => {
+        let line = `[${e.label}]: ${e.href}`;
+        if (e.title)
+            line += ` "${e.title}"`;
+        return line;
+    })
+        .join("\n");
+}
+function annotationListToMkdocs(node) {
+    return childrenToMkdocs(node);
+}
+function headingToMkdocs(node) {
+    const level = node.props?.level ?? 1;
+    const hashes = "#".repeat(level);
+    const text = childrenToMkdocs(node);
+    return `${hashes} ${text}`;
+}
+function blockquoteToMkdocs(node) {
+    const inner = childrenToMkdocs(node);
+    return inner
+        .split("\n")
+        .map((line) => (line ? `> ${line}` : ">"))
+        .join("\n");
+}
+function orderedListToMkdocs(node) {
+    if (!node.children)
+        return "";
+    return node.children
+        .map((child, i) => {
+        const text = nodeToMkdocs(child);
+        return `${i + 1}. ${text}`;
+    })
+        .join("\n");
+}
+function unorderedListToMkdocs(node) {
+    if (!node.children)
+        return "";
+    return node.children
+        .map((child) => {
+        const text = nodeToMkdocs(child);
+        return `- ${text}`;
+    })
+        .join("\n");
+}
+function htmlContainerToMkdocs(node) {
+    const tag = node.props?.tag ?? "div";
+    const attrs = node.props?.attrs ?? {};
+    const attrStr = Object.entries(attrs)
+        .map(([k, v]) => (v ? ` ${k}="${v}"` : ` ${k}`))
+        .join("");
+    const inner = childrenToMkdocs(node);
+    return `<${tag}${attrStr} markdown>\n\n${inner}\n\n</${tag}>`;
+}
+function childrenToMkdocs(node) {
+    if (!node.children || node.children.length === 0)
+        return "";
+    return node.children.map(nodeToMkdocs).join("\n\n");
+}
+function titleSuffix(variant, title) {
+    if (title === null)
+        return ' ""';
+    if (title === undefined)
+        return "";
+    const autoTitle = variant.charAt(0).toUpperCase() + variant.slice(1);
+    if (title === autoTitle)
+        return "";
+    return ` "${title}"`;
+}
+function indent(text, spaces) {
+    const prefix = " ".repeat(spaces);
+    return text
+        .split("\n")
+        .map((line) => (line ? `${prefix}${line}` : line))
+        .join("\n");
+}
+//# sourceMappingURL=to-mkdocs.js.map

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

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

package/dist/importer.d.ts

@@ -0,0 +1,30 @@
+import type { ExportPage, NavItem } from "@dogsbay/types";
+/**
+ * Parsed MkDocs project config — extracted from mkdocs.yml.
+ */
+export interface MkdocsConfig {
+    siteName: string;
+    docsDir: string;
+    repoUrl?: string;
+    editUri?: string;
+    copyright?: string;
+    extensions: (string | Record<string, unknown>)[];
+    raw: Record<string, unknown>;
+}
+/**
+ * Result of importing a MkDocs project.
+ */
+export interface MkdocsImportResult {
+    pages: ExportPage[];
+    nav: NavItem[];
+    config: MkdocsConfig;
+}
+/**
+ * Read and parse mkdocs.yml.
+ */
+export declare function readMkdocsConfig(sourceDir: string): MkdocsConfig;
+/**
+ * Import a MkDocs project: parse all pages and extract navigation.
+ */
+export declare function importMkdocsProject(sourceDir: string, opts?: Record<string, unknown>): Promise<MkdocsImportResult>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../src/importer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAK1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IACjD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAgBhE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAyJ7B"}