dogsbay 0.2.0-beta.126 → 0.2.0-beta.128

package/dist/config/load.js

@@ -537,8 +537,8 @@ function validateContent(content, sourcePath) {
     if (c.html !== undefined && c.html !== "keep" && c.html !== "sanitize") {
         throw new Error(`content.html must be "keep" or "sanitize" in ${sourcePath}; got ${JSON.stringify(c.html)}`);
     }
-    if (c.diagrams !== undefined && typeof c.diagrams !== "boolean") {
-        throw new Error(`content.diagrams must be a boolean in ${sourcePath}; got ${JSON.stringify(c.diagrams)}`);
+    if (c.diagrams !== undefined && typeof c.diagrams !== "boolean" && c.diagrams !== "mermaid-cli" && c.diagrams !== "pele") {
+        throw new Error(`content.diagrams must be true, false, "mermaid-cli" or "pele" in ${sourcePath}; got ${JSON.stringify(c.diagrams)}`);
     }
     const linkIcons = validateLinkIcons(c.linkIcons, sourcePath);
     // versions[] declarations + defaultVersion. When versions[] is

package/dist/config/schema.d.ts

@@ -532,14 +532,20 @@ export interface ContentConfig {
     linkIcons?: boolean | LinkIconsInput;
     /**
      * Build-time SVG render for fenced diagrams (today: just Mermaid;
-     * future: PlantUML, D2, Graphviz under the same flag). When true
-     * (the default), ` ```mermaid ` fences in dogsbay-md sources
-     * become `<Diagram>` components with pre-rendered SVG. Requires
-     * `@mermaid-js/mermaid-cli` (`mmdc`) on PATH or in the
-     * scaffold's node_modules — fail-open if missing (warns once,
-     * keeps the code block). See plans/mermaid-dogsbay-md.md.
-     */
-    diagrams?: boolean;
+     * future: PlantUML, D2, Graphviz under the same flag). When on
+     * (the default), ` ```mermaid ` fences in dogsbay-md and MkDocs
+     * sources become `<Diagram>` components with pre-rendered SVG.
+     *
+     *   - `true` / `"mermaid-cli"` — `mmdc` (`@mermaid-js/mermaid-cli`,
+     *     headless Chromium) on PATH or in the scaffold's node_modules;
+     *     fail-open if missing (warns once, keeps the code block). Draws
+     *     as Mermaid does. See plans/mermaid-dogsbay-md.md.
+     *   - `"pele"` — Pele (npm `pele`), plain JavaScript, no browser;
+     *     its own look, coloured by the site theme in light and dark.
+     *     See plans/pele-diagrams.md.
+     *   - `false` — keep every fence as a code block.
+     */
+    diagrams?: boolean | "mermaid-cli" | "pele";
     /**
      * Declared versions for the version axis. When set, every
      * source must carry a `version:` matching one of these ids

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dogsbay",
-  "version": "0.2.0-beta.126",
+  "version": "0.2.0-beta.128",
   "description": "CLI for Dogsbay — scaffold, build, and serve documentation sites with markdown / MkDocs / Obsidian / OpenAPI sources",
   "type": "module",
   "bin": {
@@ -43,36 +43,36 @@
     "typescript": "^5.9.3",
     "valibot": "1.1.0",
     "yaml": "^2.9.0",
-    "@dogsbay/adoc2md-modular": "0.2.0-beta.126",
-    "@dogsbay/autodoc-python": "0.2.0-beta.126",
-    "@dogsbay/commands": "0.2.0-beta.126",
-    "@dogsbay/format-asciidoc": "0.2.0-beta.126",
-    "@dogsbay/format-astro": "0.2.0-beta.126",
-    "@dogsbay/format-dita": "0.2.0-beta.126",
-    "@dogsbay/format-docusaurus": "0.2.0-beta.126",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.126",
-    "@dogsbay/format-fluidtopics-markdown": "0.2.0-beta.126",
-    "@dogsbay/format-fluidtopics-rest": "0.2.0-beta.126",
-    "@dogsbay/format-gatsby": "0.2.0-beta.126",
-    "@dogsbay/format-gitbook": "0.2.0-beta.126",
-    "@dogsbay/format-hugo": "0.2.0-beta.126",
-    "@dogsbay/format-mdx": "0.2.0-beta.126",
-    "@dogsbay/format-mkdocs": "0.2.0-beta.126",
-    "@dogsbay/format-myst": "0.2.0-beta.126",
-    "@dogsbay/format-obsidian": "0.2.0-beta.126",
-    "@dogsbay/format-openapi": "0.2.0-beta.126",
-    "@dogsbay/format-rst": "0.2.0-beta.126",
-    "@dogsbay/format-openknowledge": "0.2.0-beta.126",
-    "@dogsbay/format-starlight": "0.2.0-beta.126",
-    "@dogsbay/format-topicmap": "0.2.0-beta.126",
-    "@dogsbay/format-vitepress": "0.2.0-beta.126",
-    "@dogsbay/minja": "0.2.0-beta.126",
-    "@dogsbay/render": "0.2.0-beta.126",
-    "@dogsbay/render-html": "0.2.0-beta.126",
-    "@dogsbay/serialize-core": "0.2.0-beta.126",
-    "@dogsbay/site-check": "0.2.0-beta.126",
-    "@dogsbay/site-files": "0.2.0-beta.126",
-    "@dogsbay/types": "0.2.0-beta.126"
+    "@dogsbay/adoc2md-modular": "0.2.0-beta.128",
+    "@dogsbay/autodoc-python": "0.2.0-beta.128",
+    "@dogsbay/commands": "0.2.0-beta.128",
+    "@dogsbay/format-asciidoc": "0.2.0-beta.128",
+    "@dogsbay/format-astro": "0.2.0-beta.128",
+    "@dogsbay/format-docusaurus": "0.2.0-beta.128",
+    "@dogsbay/format-dita": "0.2.0-beta.128",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.128",
+    "@dogsbay/format-fluidtopics-markdown": "0.2.0-beta.128",
+    "@dogsbay/format-fluidtopics-rest": "0.2.0-beta.128",
+    "@dogsbay/format-gatsby": "0.2.0-beta.128",
+    "@dogsbay/format-gitbook": "0.2.0-beta.128",
+    "@dogsbay/format-hugo": "0.2.0-beta.128",
+    "@dogsbay/format-mdx": "0.2.0-beta.128",
+    "@dogsbay/format-mkdocs": "0.2.0-beta.128",
+    "@dogsbay/format-myst": "0.2.0-beta.128",
+    "@dogsbay/format-obsidian": "0.2.0-beta.128",
+    "@dogsbay/format-openapi": "0.2.0-beta.128",
+    "@dogsbay/format-openknowledge": "0.2.0-beta.128",
+    "@dogsbay/format-rst": "0.2.0-beta.128",
+    "@dogsbay/format-topicmap": "0.2.0-beta.128",
+    "@dogsbay/format-starlight": "0.2.0-beta.128",
+    "@dogsbay/format-vitepress": "0.2.0-beta.128",
+    "@dogsbay/minja": "0.2.0-beta.128",
+    "@dogsbay/render": "0.2.0-beta.128",
+    "@dogsbay/render-html": "0.2.0-beta.128",
+    "@dogsbay/serialize-core": "0.2.0-beta.128",
+    "@dogsbay/site-check": "0.2.0-beta.128",
+    "@dogsbay/site-files": "0.2.0-beta.128",
+    "@dogsbay/types": "0.2.0-beta.128"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",

package/skills/platform/dogsbay-documents/SKILL.md

@@ -192,15 +192,15 @@ Code gets a copy button automatically. Pass `--highlight` to colour it.
 
 ## Nesting
 
-When a directive contains another, the outer fence needs more colons:
+Each `:::` closes the innermost block still open, so give every block its own closer:
 
 ```markdown
-::::steps
+:::steps
 1. **Check the lag**
    :::warning
    Above 30 s, page the on-call DBA.
    :::
-::::
+:::
 ```
 
 ## Not available in a single page

package/skills/platform/dogsbay-markdown-directives/SKILL.md

@@ -18,45 +18,43 @@ content
 :::
 ```
 
-Use `::::` (four colons) when the content itself contains `:::`
-(e.g., a directive nested inside another).
+Nested directives can all use `:::` (see Nesting below).
 
-### Nesting: outer fence must be longer
+### Nesting: one closer per block
 
-When a directive contains another directive, **the outer fence
-must be longer (more colons) than the inner**. Same rule as
-code fences. The parser closes a fence at the first matching
-line of the same-or-shorter length, so an inner `:::` will
-prematurely close a `:::` outer — leaving the rest of the
-content stranded outside the directive.
-
-❌ Wrong — the inner `:::` closes the outer `:::steps`:
+Directives nest like XML elements: a closing `:::` ends the
+innermost block still open, so plain `:::` works at every level.
+Write one closer per opener, innermost first:
 
 ```markdown
 :::steps
 1. Install
-:::warning
-Don't skip this.
-:::
+
+   :::warning
+   Don't skip this.
+   :::
+
 2. Configure
 :::
 ```
 
-✅ Right — the four-colon outer survives the three-colon inner:
+❌ Wrong — one `:::` closes ONE block, so this leaves `:::details`
+open to the end of the page (`unclosed-container`):
 
 ```markdown
-::::steps
-1. Install
+:::details{summary="Setup"}
 :::warning
 Don't skip this.
 :::
-2. Configure
-::::
+
+More text.
 ```
 
-Add another colon for each level of nesting (`:::::` for a
-directive inside a `::::` outer, and so on). Most pages never
-go past two levels.
+Scaled colons (`::::steps` around `:::warning`, closed with
+`::::`) still read the same, and are what parsers before
+beta.127 need. Scale anyway when the inner block is a name
+Dogsbay does not know (`:::widget`): the nesting does not count
+it.
 
 ## Callouts