@dogsbay/format-mkdocs 0.2.0-beta.127 → 0.2.0-beta.129

package/dist/importer.js

@@ -75,7 +75,9 @@ export async function importMkdocsProject(sourceDir, opts = {}) {
     const parseOpts = {
         collapse: false,
         youtubeEmbed: true,
-        diagrams: true,
+        // `content.diagrams` (false, true, "mermaid-cli" or "pele"); it was always true here, so
+        // `content.diagrams: false` did not reach MkDocs sources
+        diagrams: opts.diagrams ?? true,
     };
     // Detect mkdocstrings autodoc config
     const mkdocstringsConfig = extractMkdocstringsConfig(config.raw, sourceDir);

package/dist/loader.d.ts

@@ -33,7 +33,7 @@ export declare function parseMkdocsMarkdown(source: string, md: MarkdownIt, opti
     collapse?: boolean;
     env?: Record<string, unknown>;
     youtubeEmbed?: boolean;
-    diagrams?: boolean;
+    diagrams?: boolean | "mermaid-cli" | "pele";
     autodoc?: {
         sourceRoot: string;
         globalOptions?: Record<string, unknown>;

package/dist/loader.js

@@ -37,9 +37,10 @@ export async function parseMkdocsMarkdown(source, md, options) {
     if (options?.youtubeEmbed) {
         liftYouTubeEmbeds(tree);
     }
-    // Render diagram code blocks (mermaid etc.) to SVG (opt-in)
+    // Render diagram code blocks (mermaid etc.) to SVG (opt-in): mmdc, or Pele
+    // (`content.diagrams: pele`, plans/pele-diagrams.md)
     if (options?.diagrams) {
-        await renderDiagrams(tree);
+        await renderDiagrams(tree, options.diagrams === "pele" ? "pele" : "mermaid-cli");
     }
     // Convert api-params HTML comments into structured TreeNodes
     convertApiParams(tree, md);
@@ -182,14 +183,31 @@ const DIAGRAM_LANGS = new Set(["mermaid"]);
  * into { type: "diagram", props: { lang: "mermaid", code: "...", svg: "..." } }.
  * Source code is preserved for round-trip export and search.
  */
-async function renderDiagrams(nodes) {
+async function renderDiagrams(nodes, engine) {
     let renderMermaidSvg;
+    const failed = [];
     try {
-        const mod = await import("./renderers/mermaid.js");
-        renderMermaidSvg = mod.renderMermaidSvg;
+        if (engine === "pele") {
+            // format-dogsbay-md's Pele renderer: one per page, so a repeated diagram gets its own ids
+            const { renderPeleSvg, diagramId } = await import("@dogsbay/format-dogsbay-md");
+            const seen = new Map();
+            renderMermaidSvg = async (code) => {
+                const base = diagramId(code);
+                const n = (seen.get(base) ?? 0) + 1;
+                seen.set(base, n);
+                const r = await renderPeleSvg(code, n === 1 ? base : `${base}-${n}`);
+                if ("error" in r)
+                    failed.push(r.error);
+                return "svg" in r ? r.svg : null;
+            };
+        }
+        else {
+            const mod = await import("./renderers/mermaid.js");
+            renderMermaidSvg = mod.renderMermaidSvg;
+        }
     }
     catch (e) {
-        console.warn("[diagrams] could not load mermaid renderer:", e);
+        console.warn("[diagrams] could not load the diagram renderer:", e);
         return;
     }
     async function walk(nodes) {
@@ -217,6 +235,9 @@ async function renderDiagrams(nodes) {
         }
     }
     await walk(nodes);
+    if (failed.length > 0) {
+        console.warn(`[diagrams] Pele could not draw ${failed.length} diagram(s), left as code blocks: ${failed[0].split("\n")[0].slice(0, 160)}`);
+    }
 }
 /**
  * Extract heading info for table of contents.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/format-mkdocs",
-  "version": "0.2.0-beta.127",
+  "version": "0.2.0-beta.129",
   "description": "MkDocs format plugin for Dogsbay — import/export MkDocs projects via TreeNode[]",
   "type": "module",
   "main": "dist/index.js",
@@ -38,8 +38,7 @@
     "markdown-it": "^14.1.0",
     "tsx": "^4.23.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.10",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.127"
+    "vitest": "^4.1.10"
   },
   "license": "MIT",
   "dependencies": {
@@ -47,9 +46,10 @@
     "markdown-it-deflist": "^3.0.1",
     "nunjucks": "^3.2.4",
     "yaml": "^2.9.0",
-    "@dogsbay/autodoc-python": "0.2.0-beta.127",
-    "@dogsbay/types": "0.2.0-beta.127",
-    "@dogsbay/serialize-core": "0.2.0-beta.127"
+    "@dogsbay/autodoc-python": "0.2.0-beta.129",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.129",
+    "@dogsbay/serialize-core": "0.2.0-beta.129",
+    "@dogsbay/types": "0.2.0-beta.129"
   },
   "repository": {
     "type": "git",