@kirchdev/duxt 0.3.4 → 0.3.5-dev-main.43-3310f4b

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "@kirchdev/duxt",
-  "version": "0.3.4",
+  "version": "0.3.5-dev-main.43-3310f4b",
   "description": "Nuxt documentation layer on Content v3 — multi-repo, versioned docs from one compact source list.",
   "keywords": [
     "content-v3",
@@ -26,48 +26,68 @@
     "url": "git+https://github.com/kirchDev/duxt.git"
   },
   "bin": {
-    "duxt-report": "./bin/duxt-report.mjs"
+    "duxt": "./bin/duxt.mjs",
+    "duxt-cache-key": "./bin/duxt-cache-key.mjs",
+    "duxt-og-cache": "./bin/duxt-og-cache.mjs"
   },
   "files": [
-    "bin",
     "app",
+    "bruno-model.ts",
+    "bruno-parse.ts",
+    "bruno-zip.ts",
+    "cli.ts",
     "components.json",
     "content-cache.ts",
     "content.config.ts",
     "duxt-app-config.ts",
+    "frontmatter.ts",
+    "git-contributors.ts",
     "highlight-langs.ts",
     "i18n",
     "mdc.config.ts",
     "modules",
     "nuxt.config.ts",
+    "og-image-cache.ts",
     "openapi-model.ts",
     "openapi-parse.ts",
     "public",
     "report.ts",
     "repository-root.ts",
+    "search-records.ts",
+    "section-input.ts",
+    "section-markdown.ts",
+    "section-reports.ts",
+    "sections-bruno.ts",
     "sections-changelog.ts",
     "sections-openapi.ts",
     "sections-resolve.ts",
-    "section-reports.ts",
     "sections.ts",
     "server",
+    "sources-cache.ts",
     "sources-git.ts",
     "sources-resolve.ts",
     "sources.ts",
+    "tfplugindocs.ts",
     "validate-report.ts"
   ],
   "type": "module",
   "main": "./nuxt.config.ts",
   "exports": {
     ".": "./nuxt.config.ts",
+    "./bruno-model": "./bruno-model.ts",
+    "./bruno-parse": "./bruno-parse.ts",
+    "./og-image-cache": "./og-image-cache.ts",
     "./openapi-model": "./openapi-model.ts",
     "./openapi-parse": "./openapi-parse.ts",
+    "./search-records": "./search-records.ts",
     "./sections": "./sections.ts",
+    "./sections-bruno": "./sections-bruno.ts",
     "./sections-openapi": "./sections-openapi.ts",
     "./sections-resolve": "./sections-resolve.ts",
     "./sources": "./sources.ts",
-    "./sources-resolve": "./sources-resolve.ts",
-    "./sources-git": "./sources-git.ts"
+    "./sources-cache": "./sources-cache.ts",
+    "./sources-git": "./sources-git.ts",
+    "./sources-resolve": "./sources-resolve.ts"
   },
   "publishConfig": {
     "access": "public"
@@ -92,10 +112,12 @@
     "@nuxtjs/i18n": "^10.6.0",
     "@nuxtjs/mcp-toolkit": "^0.19.0",
     "@nuxtjs/seo": "^5.3.14",
+    "@nuxtjs/sitemap": "^8.5.0",
     "@resvg/resvg-js": "^2.6.2",
     "@shikijs/transformers": "^4.4.3",
     "@tailwindcss/vite": "^4.3.3",
     "@vueuse/core": "^14.4.0",
+    "citty": "^0.2.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "fuse.js": "^7.5.0",
@@ -125,6 +147,7 @@
     "nuxt": "^4.5.2",
     "oxfmt": "0.65.0",
     "oxlint": "1.80.0",
+    "playwright-core": "^1.63.0",
     "taze": "^21.1.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.11"
@@ -141,7 +164,7 @@
     "format": "oxfmt --check .",
     "format:fix": "oxfmt .",
     "typecheck": "tsc --noEmit",
-    "check": "pnpm lint && pnpm format && pnpm typecheck && pnpm typecheck:app && pnpm test && pnpm check:policy && pnpm check:previews && pnpm build:app && pnpm check:a11y && pnpm check:seo",
+    "check": "pnpm lint && pnpm format && pnpm typecheck && pnpm typecheck:app && pnpm test && pnpm check:policy && pnpm check:previews && pnpm build:app && pnpm check:a11y && pnpm check:seo && pnpm check:images && pnpm check:keyboard && pnpm check:overflow",
     "check:fix": "pnpm lint:fix && pnpm format:fix",
     "previews": "node scripts/build-devtools-previews.ts",
     "check:previews": "node scripts/check-previews.ts",
@@ -152,10 +175,19 @@
     "typecheck:app": "pnpm --filter www typecheck",
     "test": "vitest run",
     "test:watch": "vitest",
-    "report": "pnpm --filter www exec duxt-report",
+    "report": "pnpm --filter www exec duxt report",
+    "cache:key": "node ./bin/duxt-cache-key.mjs --root www",
+    "og:cache": "node ./bin/duxt-og-cache.mjs --root www",
     "build:app": "pnpm --filter www build",
+    "build:www": "pnpm --filter www run build:cf",
     "deploy:www": "pnpm --filter www run deploy",
+    "publish:www": "pnpm --filter www run publish:cf",
     "check:a11y": "node scripts/check-a11y.ts",
-    "check:seo": "node scripts/check-seo.ts"
+    "check:seo": "node scripts/check-seo.ts",
+    "check:images": "node scripts/check-images.ts",
+    "check:keyboard": "node scripts/check-keyboard.ts",
+    "check:overflow": "node scripts/check-overflow.ts",
+    "check:adapters": "node scripts/check-adapters.ts",
+    "check:routes": "node scripts/check-routes.ts"
   }
 }

package/public/devtools/checks.html

@@ -236,9 +236,9 @@
   <main>
     <h1>Checks</h1>
     <p class="hint">The build validator, run against what the site is serving now.</p>
-    <div class="stats"><div class="stat "><b>34</b><span>pages checked</span></div><div class="stat "><b>6</b><span>collections</span></div><div class="stat ok"><b>0</b><span>errors</span></div><div class="stat warn"><b>5</b><span>warnings</span></div></div><h2>Warnings</h2><div class="scroll"><table>
+    <div class="stats"><div class="stat "><b>38</b><span>pages checked</span></div><div class="stat "><b>7</b><span>collections</span></div><div class="stat ok"><b>0</b><span>errors</span></div><div class="stat warn"><b>6</b><span>warnings</span></div></div><h2>Warnings</h2><div class="scroll"><table>
     <thead><tr><th scope="col"></th><th scope="col">Warning</th></tr></thead>
-    <tbody><tr><td><span class="tag warn">warn</span></td><td>the generated section &quot;Releases&quot; (CHANGELOG.md): the heading &quot;1.3 (Feb 2026)&quot; on line 41 reads like a release but does not parse as one, so it became part of the release above it instead of a page of its own. A release heading is a version, optionally followed by a date in parentheses: `## 1.4.0 (2024-02-01)`.</td></tr><tr><td><span class="tag warn">warn</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk%2F3.reference%2F2.errors.md" target="_blank" title="/srv/acme-docs/docs_sdk/3.reference/2.errors.md">&quot;docs_sdk/3.reference/2.errors.md&quot;</a> has no title and no description.</td></tr><tr><td><span class="tag warn">warn</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_de_sdk%2Fde%2F3.reference%2F2.errors.md" target="_blank" title="/srv/acme-docs/docs_de_sdk/de/3.reference/2.errors.md">&quot;docs_de_sdk/de/3.reference/2.errors.md&quot;</a> has no title and no description.</td></tr><tr><td><span class="tag warn">warn</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_v1_9%2F3.reference%2F2.errors.md" target="_blank" title="/srv/acme-docs/docs_sdk_v1_9/3.reference/2.errors.md">&quot;docs_sdk_v1_9/3.reference/2.errors.md&quot;</a> has no title and no description.</td></tr><tr><td><span class="tag warn">warn</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk%2F1.getting-started%2Findex.md" target="_blank" title="/srv/acme-docs/docs_sdk/1.getting-started/index.md">&quot;docs_sdk/1.getting-started/index.md&quot;</a> links to &quot;/sdk/guides/cacheing&quot;, which no page serves.</td></tr></tbody>
+    <tbody><tr><td><span class="tag warn">warn</span></td><td>the generated section &quot;Releases&quot; (CHANGELOG.md): the heading &quot;1.3 (Feb 2026)&quot; on line 41 reads like a release but does not parse as one, so it became part of the release above it instead of a page of its own. A release heading is a version, optionally followed by a date in parentheses: `## 1.4.0 (2024-02-01)`.</td></tr><tr><td><span class="tag warn">warn</span></td><td>the generated section &quot;Releases&quot; (CHANGELOG.md): the heading &quot;1.3 (Feb 2026)&quot; on line 41 reads like a release but does not parse as one, so it became part of the release above it instead of a page of its own. A release heading is a version, optionally followed by a date in parentheses: `## 1.4.0 (2024-02-01)`.</td></tr><tr><td><span class="tag warn">warn</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk%2F3.reference%2F2.errors.md" target="_blank" title="/srv/acme-docs/docs_sdk/3.reference/2.errors.md">&quot;docs_sdk/3.reference/2.errors.md&quot;</a> has no title and no description.</td></tr><tr><td><span class="tag warn">warn</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_de_sdk%2Fde%2F3.reference%2F2.errors.md" target="_blank" title="/srv/acme-docs/docs_de_sdk/de/3.reference/2.errors.md">&quot;docs_de_sdk/de/3.reference/2.errors.md&quot;</a> has no title and no description.</td></tr><tr><td><span class="tag warn">warn</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_v1_9%2F3.reference%2F2.errors.md" target="_blank" title="/srv/acme-docs/docs_sdk_v1_9/3.reference/2.errors.md">&quot;docs_sdk_v1_9/3.reference/2.errors.md&quot;</a> has no title and no description.</td></tr><tr><td><span class="tag warn">warn</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk%2F1.getting-started%2Findex.md" target="_blank" title="/srv/acme-docs/docs_sdk/1.getting-started/index.md">&quot;docs_sdk/1.getting-started/index.md&quot;</a> links to &quot;/sdk/guides/cacheing&quot;, which no page serves.</td></tr></tbody>
   </table></div><h2>Translations</h2><ul class="steps"><li><strong>de under &quot;/sdk&quot;: 6/8 pages</strong></li><li class="dim" style="margin-left:1.5rem"><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk%2F2.guides%2F2.caching.md" target="_blank" title="/srv/acme-docs/docs_sdk/2.guides/2.caching.md">&quot;docs_sdk/2.guides/2.caching.md&quot;</a> has no de translation.</li><li class="dim" style="margin-left:1.5rem"><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk%2F4.changelog.md" target="_blank" title="/srv/acme-docs/docs_sdk/4.changelog.md">&quot;docs_sdk/4.changelog.md&quot;</a> has no de translation.</li><li><strong>de under &quot;/sdk/v1.9&quot;: 5/7 pages</strong></li><li class="dim" style="margin-left:1.5rem"><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_v1_9%2F3.reference%2F2.errors.md" target="_blank" title="/srv/acme-docs/docs_sdk_v1_9/3.reference/2.errors.md">&quot;docs_sdk_v1_9/3.reference/2.errors.md&quot;</a> has no de translation.</li><li class="dim" style="margin-left:1.5rem"><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_v1_9%2F4.changelog.md" target="_blank" title="/srv/acme-docs/docs_sdk_v1_9/4.changelog.md">&quot;docs_sdk_v1_9/4.changelog.md&quot;</a> has no de translation.</li></ul>
   </main>
   <script>

package/public/devtools/config.html

@@ -236,9 +236,29 @@
   <main>
     <h1>Config</h1>
     <p class="hint">The merged <code>duxt</code> config, and which side of the merge each value came from.</p>
-    <div class="stats"><div class="stat "><b>15</b><span>keys</span></div><div class="stat ok"><b>6</b><span>from the site</span></div><div class="stat "><b>8</b><span>from the layer</span></div><div class="stat "><b>1</b><span>computed</span></div></div><div class="note">Arrays are replaced whole, objects merge key by key. A row marked <span class="tag">build</span> was computed by <code>modules/config.ts</code> and is written nowhere.</div><div class="filterbar"><input type="search" class="filter" data-filter placeholder="Filter keys" aria-label="Filter keys"><span class="count" data-filter-count role="status" aria-live="polite"></span></div><div class="scroll"><table>
+    <div class="stats"><div class="stat "><b>22</b><span>keys</span></div><div class="stat ok"><b>6</b><span>from the site</span></div><div class="stat "><b>15</b><span>from the layer</span></div><div class="stat "><b>1</b><span>computed</span></div></div><div class="note">Arrays are replaced whole, objects merge key by key. A row marked <span class="tag">build</span> was computed by <code>modules/config.ts</code> and is written nowhere.</div><div class="filterbar"><input type="search" class="filter" data-filter placeholder="Filter keys" aria-label="Filter keys"><span class="count" data-filter-count role="status" aria-live="polite"></span></div><div class="scroll"><table>
     <thead><tr><th scope="col">Key</th><th scope="col">From</th><th scope="col">Value</th></tr></thead>
-    <tbody><tr><td><code>title</code></td><td><span class="tag ok">consumer</span></td><td><code>Acme SDK</code></td></tr><tr><td><code>navigation</code></td><td><span class="tag muted">layer</span></td><td><details class="json"><summary><span class="dim">1 entries</span> <code class="peek">[{&quot;label&quot;:&quot;duxt.defaults.navigation.docs&quot;,&quot;icon&quot;:&quot;lucide:book-open-text&quot;}]</code></summary><pre class="json">[
+    <tbody><tr><td><code>title</code></td><td><span class="tag ok">consumer</span></td><td><code>Acme SDK</code></td></tr><tr><td><code>copy</code></td><td><span class="tag muted">layer</span></td><td><details class="json"><summary><span class="dim">1 keys</span> <code class="peek">{&quot;models&quot;:[{&quot;label&quot;:&quot;duxt.page.copy.chatgpt&quot;,&quot;icon&quot;:&quot;simple-icons:openai&quot;,&quot;url&quot;:&quot;https://chatgpt…</code></summary><pre class="json">{
+  <span class="j-key">&quot;models&quot;</span>: [
+    {
+      <span class="j-key">&quot;label&quot;</span>: <span class="j-str">&quot;duxt.page.copy.chatgpt&quot;</span>,
+      <span class="j-key">&quot;icon&quot;</span>: <span class="j-str">&quot;simple-icons:openai&quot;</span>,
+      <span class="j-key">&quot;url&quot;</span>: <span class="j-str">&quot;https://chatgpt.com/?q=&quot;</span>
+    },
+    {
+      <span class="j-key">&quot;label&quot;</span>: <span class="j-str">&quot;duxt.page.copy.claude&quot;</span>,
+      <span class="j-key">&quot;icon&quot;</span>: <span class="j-str">&quot;simple-icons:claude&quot;</span>,
+      <span class="j-key">&quot;url&quot;</span>: <span class="j-str">&quot;https://claude.ai/new?q=&quot;</span>
+    }
+  ]
+}</pre></details></td></tr><tr><td><code>contributors</code></td><td><span class="tag muted">layer</span></td><td><span class="dim">1 keys</span> <code>{&quot;avatarUrl&quot;:&quot;https://github.com/{username}.png?size=40&quot;}</code></td></tr><tr><td><code>toc</code></td><td><span class="tag muted">layer</span></td><td><span class="dim">2 keys</span> <code>{&quot;depth&quot;:3,&quot;scrollOffset&quot;:96}</code></td></tr><tr><td><code>search</code></td><td><span class="tag muted">layer</span></td><td><details class="json"><summary><span class="dim">2 keys</span> <code class="peek">{&quot;fuzzy&quot;:{&quot;threshold&quot;:0.35,&quot;minMatchCharLength&quot;:3,&quot;limit&quot;:20},&quot;recentPages&quot;:5}</code></summary><pre class="json">{
+  <span class="j-key">&quot;fuzzy&quot;</span>: {
+    <span class="j-key">&quot;threshold&quot;</span>: <span class="j-num">0.35</span>,
+    <span class="j-key">&quot;minMatchCharLength&quot;</span>: <span class="j-num">3</span>,
+    <span class="j-key">&quot;limit&quot;</span>: <span class="j-num">20</span>
+  },
+  <span class="j-key">&quot;recentPages&quot;</span>: <span class="j-num">5</span>
+}</pre></details></td></tr><tr><td><code>openapi</code></td><td><span class="tag muted">layer</span></td><td><span class="dim">2 keys</span> <code>{&quot;exampleDepth&quot;:6,&quot;schemaDepth&quot;:8}</code></td></tr><tr><td><code>shortcuts</code></td><td><span class="tag muted">layer</span></td><td><span class="dim">1 keys</span> <code>{&quot;singleCharacter&quot;:true}</code></td></tr><tr><td><code>announcements</code></td><td><span class="tag muted">layer</span></td><td><span class="dim">0 entries</span> <code>[]</code></td></tr><tr><td><code>navigation</code></td><td><span class="tag muted">layer</span></td><td><details class="json"><summary><span class="dim">1 entries</span> <code class="peek">[{&quot;label&quot;:&quot;duxt.defaults.navigation.docs&quot;,&quot;icon&quot;:&quot;lucide:book-open-text&quot;}]</code></summary><pre class="json">[
   {
     <span class="j-key">&quot;label&quot;</span>: <span class="j-str">&quot;duxt.defaults.navigation.docs&quot;</span>,
     <span class="j-key">&quot;icon&quot;</span>: <span class="j-str">&quot;lucide:book-open-text&quot;</span>
@@ -280,7 +300,7 @@
     <span class="j-key">&quot;path&quot;</span>: <span class="j-str">&quot;docs&quot;</span>,
     <span class="j-key">&quot;repo&quot;</span>: <span class="j-str">&quot;acme/cli&quot;</span>
   }
-]</pre></details></td></tr><tr><td><code>resolvedSources</code></td><td><span class="tag">build</span></td><td><details class="json"><summary><span class="dim">6 entries</span> <code class="peek">[{&quot;collection&quot;:&quot;docs_sdk&quot;,&quot;prefix&quot;:&quot;/sdk&quot;,&quot;repo&quot;:&quot;sdk&quot;,&quot;version&quot;:&quot;v2&quot;,&quot;isDefault&quot;:true,&quot;reposito…</code></summary><pre class="json">[
+]</pre></details></td></tr><tr><td><code>resolvedSources</code></td><td><span class="tag">build</span></td><td><details class="json"><summary><span class="dim">7 entries</span> <code class="peek">[{&quot;collection&quot;:&quot;docs_sdk&quot;,&quot;prefix&quot;:&quot;/sdk&quot;,&quot;repo&quot;:&quot;sdk&quot;,&quot;version&quot;:&quot;v2&quot;,&quot;isDefault&quot;:true,&quot;reposito…</code></summary><pre class="json">[
   {
     <span class="j-key">&quot;collection&quot;</span>: <span class="j-str">&quot;docs_sdk&quot;</span>,
     <span class="j-key">&quot;prefix&quot;</span>: <span class="j-str">&quot;/sdk&quot;</span>,
@@ -362,6 +382,7 @@
     <span class="j-key">&quot;collection&quot;</span>: <span class="j-str">&quot;docs_sdk_releases&quot;</span>,
     <span class="j-key">&quot;prefix&quot;</span>: <span class="j-str">&quot;/sdk/releases&quot;</span>,
     <span class="j-key">&quot;repo&quot;</span>: <span class="j-str">&quot;sdk&quot;</span>,
+    <span class="j-key">&quot;version&quot;</span>: <span class="j-str">&quot;v2&quot;</span>,
     <span class="j-key">&quot;isDefault&quot;</span>: <span class="j-word">true</span>,
     <span class="j-key">&quot;repository&quot;</span>: <span class="j-str">&quot;acme/sdk&quot;</span>,
     <span class="j-key">&quot;repositoryUrl&quot;</span>: <span class="j-str">&quot;https://github.com/acme/sdk&quot;</span>,
@@ -380,7 +401,41 @@
       <span class="j-key">&quot;navigation&quot;</span>: <span class="j-str">&quot;sections&quot;</span>,
       <span class="j-key">&quot;icon&quot;</span>: <span class="j-str">&quot;lucide:tag&quot;</span>,
       <span class="j-key">&quot;layout&quot;</span>: <span class="j-str">&quot;changelog&quot;</span>,
-      <span class="j-key">&quot;versioning&quot;</span>: <span class="j-str">&quot;global&quot;</span>,
+      <span class="j-key">&quot;versioning&quot;</span>: <span class="j-str">&quot;per-version&quot;</span>,
+      <span class="j-key">&quot;localisation&quot;</span>: <span class="j-str">&quot;original&quot;</span>,
+      <span class="j-key">&quot;remote&quot;</span>: <span class="j-word">true</span>,
+      <span class="j-key">&quot;report&quot;</span>: {
+        <span class="j-key">&quot;pages&quot;</span>: <span class="j-num">4</span>,
+        <span class="j-key">&quot;warnings&quot;</span>: [
+          <span class="j-str">&quot;the heading \&quot;1.3 (Feb 2026)\&quot; on line 41 reads like a release but does not parse as one, so it became part of the release above it instead of a page of its own. A release heading is a version, optionally followed by a date in parentheses: `## 1.4.0 (2024-02-01)`.&quot;</span>
+        ]
+      }
+    }
+  },
+  {
+    <span class="j-key">&quot;collection&quot;</span>: <span class="j-str">&quot;docs_sdk_v1_9_releases&quot;</span>,
+    <span class="j-key">&quot;prefix&quot;</span>: <span class="j-str">&quot;/sdk/v1.9/releases&quot;</span>,
+    <span class="j-key">&quot;repo&quot;</span>: <span class="j-str">&quot;sdk&quot;</span>,
+    <span class="j-key">&quot;version&quot;</span>: <span class="j-str">&quot;v1.9&quot;</span>,
+    <span class="j-key">&quot;isDefault&quot;</span>: <span class="j-word">false</span>,
+    <span class="j-key">&quot;repository&quot;</span>: <span class="j-str">&quot;acme/sdk&quot;</span>,
+    <span class="j-key">&quot;repositoryUrl&quot;</span>: <span class="j-str">&quot;https://github.com/acme/sdk&quot;</span>,
+    <span class="j-key">&quot;ref&quot;</span>: <span class="j-str">&quot;v1.9.4&quot;</span>,
+    <span class="j-key">&quot;refKind&quot;</span>: <span class="j-str">&quot;tag&quot;</span>,
+    <span class="j-key">&quot;path&quot;</span>: <span class="j-str">&quot;CHANGELOG.md&quot;</span>,
+    <span class="j-key">&quot;locale&quot;</span>: <span class="j-str">&quot;en&quot;</span>,
+    <span class="j-key">&quot;isDefaultLocale&quot;</span>: <span class="j-word">true</span>,
+    <span class="j-key">&quot;status&quot;</span>: <span class="j-str">&quot;deprecated&quot;</span>,
+    <span class="j-key">&quot;history&quot;</span>: <span class="j-word">false</span>,
+    <span class="j-key">&quot;generated&quot;</span>: {
+      <span class="j-key">&quot;type&quot;</span>: <span class="j-str">&quot;changelog&quot;</span>,
+      <span class="j-key">&quot;label&quot;</span>: <span class="j-str">&quot;Releases&quot;</span>,
+      <span class="j-key">&quot;slug&quot;</span>: <span class="j-str">&quot;releases&quot;</span>,
+      <span class="j-key">&quot;declaration&quot;</span>: <span class="j-num">0</span>,
+      <span class="j-key">&quot;navigation&quot;</span>: <span class="j-str">&quot;sections&quot;</span>,
+      <span class="j-key">&quot;icon&quot;</span>: <span class="j-str">&quot;lucide:tag&quot;</span>,
+      <span class="j-key">&quot;layout&quot;</span>: <span class="j-str">&quot;changelog&quot;</span>,
+      <span class="j-key">&quot;versioning&quot;</span>: <span class="j-str">&quot;per-version&quot;</span>,
       <span class="j-key">&quot;localisation&quot;</span>: <span class="j-str">&quot;original&quot;</span>,
       <span class="j-key">&quot;remote&quot;</span>: <span class="j-word">true</span>,
       <span class="j-key">&quot;report&quot;</span>: {

package/public/devtools/pages.html

@@ -236,7 +236,7 @@
   <main>
     <h1>Pages</h1>
     <p class="hint">Every page in every collection, with the frontmatter and git metadata attached to it.</p>
-    <div class="stats"><div class="stat "><b>34</b><span>pages</span></div><div class="stat "><b>6</b><span>collections</span></div><div class="stat "><b>26</b><span>with history</span></div><div class="stat warn"><b>3</b><span>without a title</span></div></div><details open>
+    <div class="stats"><div class="stat "><b>38</b><span>pages</span></div><div class="stat "><b>7</b><span>collections</span></div><div class="stat "><b>26</b><span>with history</span></div><div class="stat warn"><b>3</b><span>without a title</span></div></div><details open>
       <summary>docs_sdk <span class="dim">8 pages</span></summary>
       
       <div class="scroll"><table>
@@ -277,6 +277,13 @@
       <div class="scroll"><table>
     <thead><tr><th scope="col">Path</th><th scope="col">Title</th><th scope="col">Description</th><th scope="col">Icon</th><th scope="col">Last updated</th><th scope="col">Contributors</th><th scope="col">File</th></tr></thead>
     <tbody><tr><td><code>/sdk/releases</code></td><td>Releases</td><td><span class="tag warn">missing</span></td><td><span class="dim">—</span></td><td><span class="dim">no history</span></td><td><span class="dim">—</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_releases%2Findex.md" target="_blank" title="/srv/acme-docs/docs_sdk_releases/index.md">index.md</a></td></tr><tr><td><code>/sdk/releases/0.2.0</code></td><td>0.2.0</td><td><span class="tag warn">missing</span></td><td><span class="dim">—</span></td><td><span class="dim">no history</span></td><td><span class="dim">—</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_releases%2F1.0.2.0.md" target="_blank" title="/srv/acme-docs/docs_sdk_releases/1.0.2.0.md">1.0.2.0.md</a></td></tr><tr><td><code>/sdk/releases/0.1.1</code></td><td>0.1.1</td><td><span class="tag warn">missing</span></td><td><span class="dim">—</span></td><td><span class="dim">no history</span></td><td><span class="dim">—</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_releases%2F2.0.1.1.md" target="_blank" title="/srv/acme-docs/docs_sdk_releases/2.0.1.1.md">2.0.1.1.md</a></td></tr><tr><td><code>/sdk/releases/0.1.0</code></td><td>0.1.0</td><td><span class="tag warn">missing</span></td><td><span class="dim">—</span></td><td><span class="dim">no history</span></td><td><span class="dim">—</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_releases%2F3.0.1.0.md" target="_blank" title="/srv/acme-docs/docs_sdk_releases/3.0.1.0.md">3.0.1.0.md</a></td></tr></tbody>
+  </table></div>
+    </details><details>
+      <summary>docs_sdk_v1_9_releases <span class="dim">4 pages</span></summary>
+      
+      <div class="scroll"><table>
+    <thead><tr><th scope="col">Path</th><th scope="col">Title</th><th scope="col">Description</th><th scope="col">Icon</th><th scope="col">Last updated</th><th scope="col">Contributors</th><th scope="col">File</th></tr></thead>
+    <tbody><tr><td><code>/sdk/v1.9/releases</code></td><td>Releases</td><td><span class="tag warn">missing</span></td><td><span class="dim">—</span></td><td><span class="dim">no history</span></td><td><span class="dim">—</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_v1_9_releases%2Findex.md" target="_blank" title="/srv/acme-docs/docs_sdk_v1_9_releases/index.md">index.md</a></td></tr><tr><td><code>/sdk/v1.9/releases/0.2.0</code></td><td>0.2.0</td><td><span class="tag warn">missing</span></td><td><span class="dim">—</span></td><td><span class="dim">no history</span></td><td><span class="dim">—</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_v1_9_releases%2F1.0.2.0.md" target="_blank" title="/srv/acme-docs/docs_sdk_v1_9_releases/1.0.2.0.md">1.0.2.0.md</a></td></tr><tr><td><code>/sdk/v1.9/releases/0.1.1</code></td><td>0.1.1</td><td><span class="tag warn">missing</span></td><td><span class="dim">—</span></td><td><span class="dim">no history</span></td><td><span class="dim">—</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_v1_9_releases%2F2.0.1.1.md" target="_blank" title="/srv/acme-docs/docs_sdk_v1_9_releases/2.0.1.1.md">2.0.1.1.md</a></td></tr><tr><td><code>/sdk/v1.9/releases/0.1.0</code></td><td>0.1.0</td><td><span class="tag warn">missing</span></td><td><span class="dim">—</span></td><td><span class="dim">no history</span></td><td><span class="dim">—</span></td><td><a class="file" href="/__nuxt_devtools__/open-in-editor?file=%2Fsrv%2Facme-docs%2Fdocs_sdk_v1_9_releases%2F3.0.1.0.md" target="_blank" title="/srv/acme-docs/docs_sdk_v1_9_releases/3.0.1.0.md">3.0.1.0.md</a></td></tr></tbody>
   </table></div>
     </details>
   </main>

package/public/devtools/paths.html

@@ -241,7 +241,7 @@
     <button type="submit">Resolve</button>
   </form><ol class="steps"><li>Locale segment stripped: <code>/de/sdk/v1-9/guides/caching</code> → <code>/sdk/v1-9/guides/caching</code>, language <code>de</code>. <span class="dim">The locale translates the interface, never the content tree — but it does pick the collection.</span></li><li>Longest matching prefix is <code>/sdk</code> → collection <code>docs_de_sdk</code>, version <code>v2</code>, language <code>de</code>.</li><li>Falls back to <code>docs_sdk</code>. <span class="dim">A page is translated whole or not at all, so this is a chain of collections rather than a merge.</span></li><li><span class="tag error">stops here</span> Collection <code>docs_de_sdk</code> has no page at <code>/sdk/v1-9/guides/caching</code>.</li></ol><h2>The same page in other sources</h2><div class="scroll"><table>
     <thead><tr><th scope="col">Prefix</th><th scope="col">Version</th><th scope="col">Language</th><th scope="col">Would be</th><th scope="col">State</th></tr></thead>
-    <tbody><tr><td><code>/sdk</code></td><td>v2</td><td>en <span class="tag">original</span></td><td><code>/sdk/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk</code></td><td>v2</td><td>de</td><td><code>/sdk/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk/v1.9</code></td><td>v1.9</td><td>en <span class="tag">original</span></td><td><code>/sdk/v1.9/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk/v1.9</code></td><td>v1.9</td><td>de</td><td><code>/sdk/v1.9/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk/releases</code></td><td>—</td><td>en <span class="tag">original</span></td><td><code>/sdk/releases/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr></tbody>
+    <tbody><tr><td><code>/sdk</code></td><td>v2</td><td>en <span class="tag">original</span></td><td><code>/sdk/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk</code></td><td>v2</td><td>de</td><td><code>/sdk/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk/v1.9</code></td><td>v1.9</td><td>en <span class="tag">original</span></td><td><code>/sdk/v1.9/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk/v1.9</code></td><td>v1.9</td><td>de</td><td><code>/sdk/v1.9/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk/releases</code></td><td>v2</td><td>en <span class="tag">original</span></td><td><code>/sdk/releases/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr><tr><td><code>/sdk/v1.9/releases</code></td><td>v1.9</td><td>en <span class="tag">original</span></td><td><code>/sdk/v1.9/releases/v1-9/guides/caching</code></td><td><span class="tag muted">missing</span></td></tr></tbody>
   </table></div><h2>Nearest paths in docs_de_sdk</h2><div class="scroll"><table>
     <thead><tr><th scope="col">Path</th></tr></thead>
     <tbody><tr><td><code>/sdk/getting-started</code></td></tr><tr><td><code>/sdk/getting-started/install</code></td></tr><tr><td><code>/sdk/guides/deploying</code></td></tr><tr><td><code>/sdk/reference/client</code></td></tr><tr><td><code>/sdk/reference/errors</code></td></tr><tr><td><code>/sdk</code></td></tr></tbody>

package/public/devtools/sources.html

@@ -236,9 +236,9 @@
   <main>
     <h1>Sources</h1>
     <p class="hint">What <code>duxt.sources</code> became: one collection per source and version, and the URL prefix each serves.</p>
-    <div class="stats"><div class="stat "><b>6</b><span>collections</span></div><div class="stat "><b>2</b><span>repositories</span></div><div class="stat "><b>2</b><span>versions</span></div><div class="stat "><b>1</b><span>generated section</span></div><div class="stat warn"><b>2</b><span>not current</span></div></div><div class="scroll"><table>
+    <div class="stats"><div class="stat "><b>7</b><span>collections</span></div><div class="stat "><b>2</b><span>repositories</span></div><div class="stat "><b>2</b><span>versions</span></div><div class="stat "><b>2</b><span>generated sections</span></div><div class="stat warn"><b>3</b><span>not current</span></div></div><div class="scroll"><table>
     <thead><tr><th scope="col">Prefix</th><th scope="col">Collection</th><th scope="col">Repository</th><th scope="col">Folder / artefact</th><th scope="col">Ref</th><th scope="col">Version</th><th scope="col">Status</th><th scope="col">Reserved segments</th></tr></thead>
-    <tbody><tr><td><code>/sdk</code></td><td><code>docs_sdk</code></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>docs</code></td><td>main <span class="dim">(branch)</span></td><td>v2 <span class="tag">default</span></td><td><span class="tag ok">current</span></td><td><code>v1.9</code> <code>releases</code></td></tr><tr><td><code>/sdk</code></td><td><code>docs_de_sdk</code></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>docs/de</code></td><td>main <span class="dim">(branch)</span></td><td>v2 <span class="tag">default</span></td><td><span class="tag ok">current</span></td><td><code>v1.9</code> <code>releases</code></td></tr><tr><td><code>/sdk/v1.9</code></td><td><code>docs_sdk_v1_9</code></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>docs</code></td><td>v1.9.4 <span class="dim">(tag)</span></td><td>v1.9</td><td><span class="tag warn">deprecated</span></td><td><span class="dim">—</span></td></tr><tr><td><code>/sdk/v1.9</code></td><td><code>docs_de_sdk_v1_9</code></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>docs/de</code></td><td>v1.9.4 <span class="dim">(tag)</span></td><td>v1.9</td><td><span class="tag warn">deprecated</span></td><td><span class="dim">—</span></td></tr><tr><td><code>/cli</code></td><td><code>docs_cli</code></td><td><a class="file" href="https://github.com/acme/cli" target="_blank">acme/cli</a></td><td><code>docs</code></td><td><span class="dim">checkout</span></td><td>— <span class="tag">default</span></td><td><span class="tag ok">current</span></td><td><span class="dim">—</span></td></tr><tr><td><code>/sdk/releases</code></td><td><code>docs_sdk_releases</code> <span class="tag">changelog</span></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>CHANGELOG.md</code></td><td>main <span class="dim">(branch)</span></td><td>— <span class="tag">default</span></td><td><span class="tag ok">current</span></td><td><span class="dim">—</span></td></tr></tbody>
+    <tbody><tr><td><code>/sdk</code></td><td><code>docs_sdk</code></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>docs</code></td><td>main <span class="dim">(branch)</span></td><td>v2 <span class="tag">default</span></td><td><span class="tag ok">current</span></td><td><code>v1.9</code> <code>releases</code></td></tr><tr><td><code>/sdk</code></td><td><code>docs_de_sdk</code></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>docs/de</code></td><td>main <span class="dim">(branch)</span></td><td>v2 <span class="tag">default</span></td><td><span class="tag ok">current</span></td><td><code>v1.9</code> <code>releases</code></td></tr><tr><td><code>/sdk/v1.9</code></td><td><code>docs_sdk_v1_9</code></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>docs</code></td><td>v1.9.4 <span class="dim">(tag)</span></td><td>v1.9</td><td><span class="tag warn">deprecated</span></td><td><code>releases</code></td></tr><tr><td><code>/sdk/v1.9</code></td><td><code>docs_de_sdk_v1_9</code></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>docs/de</code></td><td>v1.9.4 <span class="dim">(tag)</span></td><td>v1.9</td><td><span class="tag warn">deprecated</span></td><td><code>releases</code></td></tr><tr><td><code>/cli</code></td><td><code>docs_cli</code></td><td><a class="file" href="https://github.com/acme/cli" target="_blank">acme/cli</a></td><td><code>docs</code></td><td><span class="dim">checkout</span></td><td>— <span class="tag">default</span></td><td><span class="tag ok">current</span></td><td><span class="dim">—</span></td></tr><tr><td><code>/sdk/releases</code></td><td><code>docs_sdk_releases</code> <span class="tag">changelog</span></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>CHANGELOG.md</code></td><td>main <span class="dim">(branch)</span></td><td>v2 <span class="tag">default</span></td><td><span class="tag ok">current</span></td><td><span class="dim">—</span></td></tr><tr><td><code>/sdk/v1.9/releases</code></td><td><code>docs_sdk_v1_9_releases</code> <span class="tag">changelog</span></td><td><a class="file" href="https://github.com/acme/sdk" target="_blank">acme/sdk</a></td><td><code>CHANGELOG.md</code></td><td>v1.9.4 <span class="dim">(tag)</span></td><td>v1.9</td><td><span class="tag warn">deprecated</span></td><td><span class="dim">—</span></td></tr></tbody>
   </table></div><p class="hint">Configured in /srv/acme-docs/app/app.config.ts.</p>
   </main>
   <script>

package/public/devtools/versions.html

@@ -242,6 +242,9 @@
   </table></div><p class="hint">* the version served without a version segment.</p><h2>acme/sdk <span class="tag muted">de</span></h2><div class="scroll"><table class="matrix">
     <thead><tr><th scope="col">Page</th><th scope="col">v2 *</th><th scope="col">v1.9</th></tr></thead>
     <tbody><tr><td><code>/</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/getting-started</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/getting-started/install</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/guides/deploying</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/reference/client</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/reference/errors</code></td><td class="mark yes">✓</td><td class="mark no">·</td></tr></tbody>
+  </table></div><p class="hint">* the version served without a version segment.</p><h2>acme/sdk <span class="tag muted">en</span> <span class="tag muted">Releases</span></h2><div class="scroll"><table class="matrix">
+    <thead><tr><th scope="col">Page</th><th scope="col">v2 *</th><th scope="col">v1.9</th></tr></thead>
+    <tbody><tr><td><code>/</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/0.1.0</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/0.1.1</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/0.2.0</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr></tbody>
   </table></div><p class="hint">* the version served without a version segment.</p><h2>acme/sdk <span class="tag muted">v2</span></h2><div class="scroll"><table class="matrix">
     <thead><tr><th scope="col">Page</th><th scope="col">en *</th><th scope="col">de</th></tr></thead>
     <tbody><tr><td><code>/</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/changelog</code></td><td class="mark yes">✓</td><td class="mark no">·</td></tr><tr><td><code>/getting-started</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/getting-started/install</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/guides/caching</code></td><td class="mark yes">✓</td><td class="mark no">·</td></tr><tr><td><code>/guides/deploying</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/reference/client</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr><tr><td><code>/reference/errors</code></td><td class="mark yes">✓</td><td class="mark yes">✓</td></tr></tbody>

package/report.ts

@@ -264,8 +264,11 @@ export function duxtReportMarkdown(data: DuxtReport): string {
 /* The command                                                                 */
 /* -------------------------------------------------------------------------- */
 
+/** The two shapes the same report is printed in. */
+export type DuxtReportFormat = 'markdown' | 'json';
+
 /**
- * The command, as a function of its arguments and its data.
+ * The report as text, and the exit code that goes with it.
  *
  * HERE rather than in the bin, and that is not tidiness. The bin has to be
  * plain JavaScript — Node refuses to strip types from a file under
@@ -275,29 +278,35 @@ export function duxtReportMarkdown(data: DuxtReport): string {
  * therefore lives on this side, where it is typed and tested, and the bin is
  * left with nothing to get wrong.
  *
+ * It takes the format rather than the argv it was asked for in. Which spelling
+ * selects JSON is the command line's business, and `cli.ts` is where the
+ * command line is read — a second place sniffing argv is how the two drift
+ * into disagreeing about what a valid invocation is.
+ *
  * Returns the exit code rather than setting it: warnings do not fail, because
  * they are what somebody else's repository going stale looks like, and a check
  * that cannot survive that is a check that gets switched off.
  */
-export function runDuxtReportCli(
-  argv: string[],
-  data: DuxtReport
+export function duxtReportOutput(
+  data: DuxtReport,
+  format: DuxtReportFormat = 'markdown'
 ): { output: string; exitCode: number } {
-  const output = argv.includes('--json')
-    ? JSON.stringify(
-        {
-          ...data,
-          // A Set does not survive `JSON.stringify` — it serialises as `{}`,
-          // which is a silently empty anchor list rather than an error.
-          pages: data.pages?.map((page) => ({
-            ...page,
-            anchors: [...page.anchors]
-          }))
-        },
-        undefined,
-        2
-      )
-    : duxtReportMarkdown(data);
+  const output =
+    format === 'json'
+      ? JSON.stringify(
+          {
+            ...data,
+            // A Set does not survive `JSON.stringify` — it serialises as `{}`,
+            // which is a silently empty anchor list rather than an error.
+            pages: data.pages?.map((page) => ({
+              ...page,
+              anchors: [...page.anchors]
+            }))
+          },
+          undefined,
+          2
+        )
+      : duxtReportMarkdown(data);
 
   return { output, exitCode: data.findings.errors.length ? 1 : 0 };
 }