dogsbay 0.2.0-beta.126 → 0.2.0-beta.127

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dogsbay",
-  "version": "0.2.0-beta.126",
+  "version": "0.2.0-beta.127",
   "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.127",
+    "@dogsbay/commands": "0.2.0-beta.127",
+    "@dogsbay/format-asciidoc": "0.2.0-beta.127",
+    "@dogsbay/autodoc-python": "0.2.0-beta.127",
+    "@dogsbay/format-astro": "0.2.0-beta.127",
+    "@dogsbay/format-dita": "0.2.0-beta.127",
+    "@dogsbay/format-docusaurus": "0.2.0-beta.127",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.127",
+    "@dogsbay/format-gatsby": "0.2.0-beta.127",
+    "@dogsbay/format-fluidtopics-markdown": "0.2.0-beta.127",
+    "@dogsbay/format-gitbook": "0.2.0-beta.127",
+    "@dogsbay/format-fluidtopics-rest": "0.2.0-beta.127",
+    "@dogsbay/format-mdx": "0.2.0-beta.127",
+    "@dogsbay/format-hugo": "0.2.0-beta.127",
+    "@dogsbay/format-mkdocs": "0.2.0-beta.127",
+    "@dogsbay/format-myst": "0.2.0-beta.127",
+    "@dogsbay/format-obsidian": "0.2.0-beta.127",
+    "@dogsbay/format-openapi": "0.2.0-beta.127",
+    "@dogsbay/format-openknowledge": "0.2.0-beta.127",
+    "@dogsbay/format-starlight": "0.2.0-beta.127",
+    "@dogsbay/format-rst": "0.2.0-beta.127",
+    "@dogsbay/format-topicmap": "0.2.0-beta.127",
+    "@dogsbay/format-vitepress": "0.2.0-beta.127",
+    "@dogsbay/minja": "0.2.0-beta.127",
+    "@dogsbay/render": "0.2.0-beta.127",
+    "@dogsbay/render-html": "0.2.0-beta.127",
+    "@dogsbay/serialize-core": "0.2.0-beta.127",
+    "@dogsbay/site-files": "0.2.0-beta.127",
+    "@dogsbay/site-check": "0.2.0-beta.127",
+    "@dogsbay/types": "0.2.0-beta.127"
   },
   "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