@dogsbay/ssg 0.2.0-beta.129 → 0.2.0-beta.131

package/dist/package/client.mjs

@@ -631,17 +631,43 @@ function initAnchors(signal) {
     });
   }, { signal });
 }
-var providers = /* @__PURE__ */ new Set();
-function closeDetached() {
-  for (const p of providers) if (!p.isConnected) closeMobile(p);
+var providers = /* @__PURE__ */ new Map();
+var unreachable = /* @__PURE__ */ new Set();
+function releaseDetached() {
+  for (const [p, ac] of providers) {
+    if (p.isConnected) continue;
+    closeMobile(p);
+    ac.abort();
+    providers.delete(p);
+  }
+  for (const p of unreachable) if (!p.isConnected) closeMobile(p);
+}
+function withSignal(signal, fn) {
+  const proto = EventTarget.prototype;
+  const add = proto.addEventListener;
+  let added = 0;
+  proto.addEventListener = function(type, listener, o) {
+    added++;
+    const own = typeof o === "object" ? o.signal : void 0;
+    add.call(this, type, listener, typeof o === "object" ? { ...o, signal: own ? AbortSignal.any([own, signal]) : signal } : { capture: o === true, signal });
+  };
+  try {
+    fn();
+  } finally {
+    proto.addEventListener = add;
+  }
+  return added;
 }
 function wireSidebars() {
+  releaseDetached();
   document.querySelectorAll("[data-component='sidebar-provider']").forEach((p) => {
-    initSidebar(p);
-    providers.add(p);
+    if (providers.has(p) || unreachable.has(p)) return;
+    const ac = new AbortController();
+    if (withSignal(ac.signal, () => initSidebar(p))) providers.set(p, ac);
+    else if (p.querySelector("[data-component='sidebar']")) unreachable.add(p);
   });
-  document.removeEventListener("keydown", closeDetached);
-  document.addEventListener("keydown", closeDetached);
+  document.removeEventListener("keydown", releaseDetached);
+  document.addEventListener("keydown", releaseDetached);
 }
 var current;
 function mount(o = {}) {
@@ -664,7 +690,8 @@ function mount(o = {}) {
     unmount() {
       if (signal.aborted) return;
       ac.abort();
-      for (const p of providers) closeMobile(p);
+      for (const p of [...providers.keys(), ...unreachable]) closeMobile(p);
+      releaseDetached();
       if (current === page) current = void 0;
     }
   };

package/dist/package/css.mjs

@@ -4,7 +4,7 @@ import "./chunks/chunk-3BM23K4O.mjs";
 import { compile } from "tailwindcss";
 
 // src/generated/css-assets.ts
-var THEME_CSS = { "api.css": "/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/ui api-symbol.css, api-source.css, EndpointCard.astro, EndpointSection.astro, PropertyItem.astro. Do not edit. */\n/* API Symbol badges, coloured by kind. Text on its own 20% tint must reach\n   WCAG AA (4.5:1) on the page background: the light colours were L 0.5\u20130.6\n   (3.2\u20134.0:1) and are L 0.44 (5.0:1 or more); render-html's\n   tests/contrast.test.ts measures every kind in both modes. */\n.api-badge {\n  display: inline-flex;\n  align-items: center;\n  border-radius: 0.375rem;\n  padding: 0.125rem 0.5rem;\n  font-size: 0.7rem;\n  font-weight: 600;\n  letter-spacing: 0.025em;\n  text-transform: uppercase;\n  vertical-align: middle;\n  flex-shrink: 0;\n}\n\n.api-badge-class {\n  background-color: oklch(0.44 0.18 265 / 0.2);\n  color: oklch(0.44 0.18 265);\n}\n.dark .api-badge-class {\n  background-color: oklch(0.7 0.15 265 / 0.2);\n  color: oklch(0.7 0.15 265);\n}\n\n.api-badge-meth {\n  background-color: oklch(0.44 0.15 155 / 0.2);\n  color: oklch(0.44 0.15 155);\n}\n.dark .api-badge-meth {\n  background-color: oklch(0.7 0.15 155 / 0.2);\n  color: oklch(0.7 0.15 155);\n}\n\n.api-badge-attr {\n  background-color: oklch(0.44 0.15 55 / 0.2);\n  color: oklch(0.44 0.15 55);\n}\n.dark .api-badge-attr {\n  background-color: oklch(0.75 0.15 55 / 0.2);\n  color: oklch(0.75 0.15 55);\n}\n\n.api-badge-func {\n  background-color: oklch(0.44 0.18 330 / 0.2);\n  color: oklch(0.44 0.18 330);\n}\n.dark .api-badge-func {\n  background-color: oklch(0.7 0.15 330 / 0.2);\n  color: oklch(0.7 0.15 330);\n}\n\n.api-badge-module {\n  background-color: oklch(0.44 0.12 200 / 0.2);\n  color: oklch(0.44 0.12 200);\n}\n.dark .api-badge-module {\n  background-color: oklch(0.65 0.12 200 / 0.2);\n  color: oklch(0.65 0.12 200);\n}\n\n/* API Symbol container */\n.api-symbol {\n  margin-top: 2rem;\n  padding-top: 1.5rem;\n  border-top: 1px solid var(--border, oklch(0.5 0 0 / 0.15));\n}\n\n.api-symbol:first-child {\n  margin-top: 0;\n  padding-top: 0;\n  border-top: none;\n}\n\n.api-symbol-heading {\n  display: flex;\n  align-items: center;\n  gap: 0.5rem;\n  margin-bottom: 0.75rem;\n}\n\n.api-symbol-heading code {\n  font-size: 1.25em;\n  font-weight: 600;\n}\n\n.api-symbol-bases {\n  font-size: 0.875rem;\n  color: var(--muted-foreground);\n  margin-bottom: 0.5rem;\n}\n\n.api-source {\n  margin-top: 0.75rem;\n  margin-bottom: 0.75rem;\n  border: 1px solid var(--color-border, oklch(0.85 0 0));\n  border-radius: 0.375rem;\n  overflow: hidden;\n}\n\n.api-source summary {\n  cursor: pointer;\n  padding: 0.5rem 0.75rem;\n  font-size: 0.8125rem;\n  font-weight: 500;\n  color: var(--color-muted-foreground, oklch(0.55 0 0));\n  background: var(--color-muted, oklch(0.96 0 0));\n  user-select: none;\n}\n\n.api-source summary:hover {\n  color: var(--color-foreground, oklch(0.15 0 0));\n}\n\n.api-source[open] summary {\n  border-bottom: 1px solid var(--color-border, oklch(0.85 0 0));\n}\n\n/* Remove extra margin from the code block inside */\n.api-source pre {\n  margin: 0 !important;\n  border-radius: 0 !important;\n  border: none !important;\n}\n\n\n  /* An operation's description is Markdown rendered to HTML (lists, code,\n     paragraphs), placed where the page's prose styles do not reach: without\n     these a bulleted field list reads as loose lines. */\n  .api-description > * + * {\n    margin-top: 0.5rem;\n  }\n  .api-description ul {\n    list-style: disc;\n    padding-left: 1.25rem;\n  }\n  .api-description ol {\n    list-style: decimal;\n    padding-left: 1.25rem;\n  }\n  .api-description li + li,\n  .api-description li > ul,\n  .api-description li > ol {\n    margin-top: 0.125rem;\n  }\n  .api-description ul ul {\n    list-style: circle;\n  }\n  /* Field names (`id`, `scm_type`) stand out in the JSON key colour,\n     on a faint tint of it. Override --api-field in the theme to change it; a site\n     scaffolded before the token existed gets --api-post, the same blue. */\n  .api-description code {\n    font-family: var(--font-mono, ui-monospace, monospace);\n    font-size: 0.85em;\n    font-weight: 600;\n    color: var(--api-field, var(--api-post, var(--foreground)));\n    background-color: color-mix(in oklab, var(--api-field, var(--api-post, var(--foreground))) 8%, transparent);\n    border-radius: 0.25rem;\n    padding: 0.0625rem 0.3rem;\n  }\n  /* A code block in a description (a JSON shape, `?order_by=`) is one\n     full-width block, as Swagger UI shows it: the chip styling above,\n     applied per line, read as a stack of separate highlights. */\n  .api-description pre {\n    overflow-x: auto;\n    border-radius: 0.375rem;\n    padding: 0.5rem 0.75rem;\n    background-color: var(--code-background, color-mix(in oklab, var(--foreground) 6%, transparent));\n  }\n  .api-description pre code {\n    display: block;\n    padding: 0;\n    border-radius: 0;\n    background: none;\n    white-space: pre;\n  }\n  .api-description a {\n    color: var(--primary);\n    text-decoration: underline;\n    text-underline-offset: 2px;\n  }\n\n\n  details[open] > summary [data-section-chevron] {\n    transform: rotate(90deg);\n  }\n\n\n  details[open] > summary [data-property-chevron] {\n    transform: rotate(90deg);\n  }\n", "code-rich.css": "/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/ui code-rich.css. Do not edit. */\n/* CodeRich annotation styles \u2014 applied via CSS classes from Shiki transformers */\n\n/* \u2500\u2500 All lines \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .line {\n  /* inline-block, not inline-flex: a flex line makes each token span a flex item, and\n     browsers then copy a hand-made selection with a line break between tokens. */\n  display: inline-block;\n  width: 100%;\n}\n\n/* \u2500\u2500 Gutter (single column: line number + diff marker) \u2500\u2500 */\n.code-rich-body .gutter {\n  display: inline-block;\n  min-width: 4ch;\n  margin-right: 1.5ch;\n  text-align: right;\n  /* Theme-aware, and NO alpha. This was a fixed dark grey at 70%\n     opacity: fine on a light code background, 1.3:1 against the dark\n     one \u2014 line numbers were effectively invisible in dark mode.\n     Opacity compounds it, since it blends toward whatever is behind.\n     --muted-foreground already flips per theme (L 0.45 / 0.708). */\n  color: var(--muted-foreground);\n  user-select: none;\n  flex-shrink: 0;\n}\n.code-rich-body .gutter.add {\n  color: oklch(0.55 0.2 145);\n}\n.code-rich-body .gutter.remove {\n  color: oklch(0.55 0.2 25);\n}\n\n/* Dark mode: the diff gutters sit on TINTED line backgrounds, not on\n   the plain code background, and at L0.55 they measure 2.89:1 (add)\n   and 2.63:1 (remove) there \u2014 both well under AA. Light mode is\n   unaffected, so these are overrides rather than a changed base.\n   Raised to L0.72 for headroom over the 4.5:1 floor. */\n.dark .code-rich-body .gutter.add {\n  color: oklch(0.72 0.2 145);\n}\n.dark .code-rich-body .gutter.remove {\n  color: oklch(0.72 0.14 25);\n}\n\n/* \u2500\u2500 Diff line backgrounds \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .line.diff.add {\n  background-color: oklch(0.75 0.18 145 / 0.15);\n}\n.code-rich-body .line.diff.remove {\n  background-color: oklch(0.65 0.2 25 / 0.15);\n}\n\n/* \u2500\u2500 Focus \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body pre.has-focused .line:not(.focused) {\n  opacity: 0.7;\n  transition: opacity 0.3s;\n}\n.code-rich-body pre.has-focused:hover .line:not(.focused) {\n  opacity: 0.9;\n}\n.code-rich-body pre.has-focused .line.focused {\n  opacity: 1;\n}\n\n/* \u2500\u2500 Highlight (background only) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .line.highlighted {\n  background-color: oklch(0.7 0.1 250 / 0.08);\n}\n\n/* \u2500\u2500 Error / Warning / Info levels \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .line.highlighted.error {\n  background-color: oklch(0.65 0.2 25 / 0.08);\n}\n.code-rich-body .line.highlighted.warning {\n  background-color: oklch(0.75 0.18 65 / 0.08);\n}\n.code-rich-body .line.highlighted.info {\n  background-color: oklch(0.7 0.15 250 / 0.08);\n}\n\n/* \u2500\u2500 Word highlight \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .highlighted-word {\n  background-color: oklch(0.7 0.1 250 / 0.25);\n  border-radius: 3px;\n  padding: 1px 4px;\n  margin: 0 -1px;\n}\n", "docs.css": `/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/format-astro (generateGlobalCss). Do not edit. */
+var THEME_CSS = { "api.css": "/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/ui api-symbol.css, api-source.css, EndpointCard.astro, EndpointSection.astro, PropertyItem.astro. Do not edit. */\n/* API Symbol badges, coloured by kind. Text on its own 20% tint must reach\n   WCAG AA (4.5:1) on the page background: the light colours were L 0.5\u20130.6\n   (3.2\u20134.0:1) and are L 0.44 (5.0:1 or more); render-html's\n   tests/contrast.test.ts measures every kind in both modes. */\n.api-badge {\n  display: inline-flex;\n  align-items: center;\n  border-radius: 0.375rem;\n  padding: 0.125rem 0.5rem;\n  font-size: 0.7rem;\n  font-weight: 600;\n  letter-spacing: 0.025em;\n  text-transform: uppercase;\n  vertical-align: middle;\n  flex-shrink: 0;\n}\n\n.api-badge-class {\n  background-color: oklch(0.44 0.18 265 / 0.2);\n  color: oklch(0.44 0.18 265);\n}\n.dark .api-badge-class {\n  background-color: oklch(0.7 0.15 265 / 0.2);\n  color: oklch(0.7 0.15 265);\n}\n\n.api-badge-meth {\n  background-color: oklch(0.44 0.15 155 / 0.2);\n  color: oklch(0.44 0.15 155);\n}\n.dark .api-badge-meth {\n  background-color: oklch(0.7 0.15 155 / 0.2);\n  color: oklch(0.7 0.15 155);\n}\n\n.api-badge-attr {\n  background-color: oklch(0.44 0.15 55 / 0.2);\n  color: oklch(0.44 0.15 55);\n}\n.dark .api-badge-attr {\n  background-color: oklch(0.75 0.15 55 / 0.2);\n  color: oklch(0.75 0.15 55);\n}\n\n.api-badge-func {\n  background-color: oklch(0.44 0.18 330 / 0.2);\n  color: oklch(0.44 0.18 330);\n}\n.dark .api-badge-func {\n  background-color: oklch(0.7 0.15 330 / 0.2);\n  color: oklch(0.7 0.15 330);\n}\n\n.api-badge-module {\n  background-color: oklch(0.44 0.12 200 / 0.2);\n  color: oklch(0.44 0.12 200);\n}\n.dark .api-badge-module {\n  background-color: oklch(0.65 0.12 200 / 0.2);\n  color: oklch(0.65 0.12 200);\n}\n\n/* API Symbol container */\n.api-symbol {\n  margin-top: 2rem;\n  padding-top: 1.5rem;\n  border-top: 1px solid var(--border, oklch(0.5 0 0 / 0.15));\n}\n\n.api-symbol:first-child {\n  margin-top: 0;\n  padding-top: 0;\n  border-top: none;\n}\n\n.api-symbol-heading {\n  display: flex;\n  align-items: center;\n  gap: 0.5rem;\n  margin-bottom: 0.75rem;\n}\n\n.api-symbol-heading code {\n  font-size: 1.25em;\n  font-weight: 600;\n}\n\n.api-symbol-bases {\n  font-size: 0.875rem;\n  color: var(--muted-foreground);\n  margin-bottom: 0.5rem;\n}\n\n.api-source {\n  margin-top: 0.75rem;\n  margin-bottom: 0.75rem;\n  border: 1px solid var(--color-border, oklch(0.85 0 0));\n  border-radius: 0.375rem;\n  overflow: hidden;\n}\n\n.api-source summary {\n  cursor: pointer;\n  padding: 0.5rem 0.75rem;\n  font-size: 0.8125rem;\n  font-weight: 500;\n  color: var(--color-muted-foreground, oklch(0.55 0 0));\n  background: var(--color-muted, oklch(0.96 0 0));\n  user-select: none;\n}\n\n.api-source summary:hover {\n  color: var(--color-foreground, oklch(0.15 0 0));\n}\n\n.api-source[open] summary {\n  border-bottom: 1px solid var(--color-border, oklch(0.85 0 0));\n}\n\n/* Remove extra margin from the code block inside */\n.api-source pre {\n  margin: 0 !important;\n  border-radius: 0 !important;\n  border: none !important;\n}\n\n\n  /* An operation's description is Markdown rendered to HTML (lists, code,\n     paragraphs), placed where the page's prose styles do not reach: without\n     these a bulleted field list reads as loose lines. */\n  .api-description > * + * {\n    margin-top: 0.5rem;\n  }\n  .api-description ul {\n    list-style: disc;\n    padding-left: 1.25rem;\n  }\n  .api-description ol {\n    list-style: decimal;\n    padding-left: 1.25rem;\n  }\n  .api-description li + li,\n  .api-description li > ul,\n  .api-description li > ol {\n    margin-top: 0.125rem;\n  }\n  .api-description ul ul {\n    list-style: circle;\n  }\n  /* Field names (`id`, `scm_type`) stand out in the JSON key colour,\n     on a faint tint of it. Override --api-field in the theme to change it; a site\n     scaffolded before the token existed gets --api-post, the same blue. */\n  .api-description code {\n    font-family: var(--font-mono, ui-monospace, monospace);\n    font-size: 0.85em;\n    font-weight: 600;\n    color: var(--api-field, var(--api-post, var(--foreground)));\n    background-color: color-mix(in oklab, var(--api-field, var(--api-post, var(--foreground))) 8%, transparent);\n    border-radius: 0.25rem;\n    padding: 0.0625rem 0.3rem;\n  }\n  /* A code block in a description (a JSON shape, `?order_by=`) is one\n     full-width block, as Swagger UI shows it: the chip styling above,\n     applied per line, read as a stack of separate highlights. */\n  .api-description pre {\n    overflow-x: auto;\n    border-radius: 0.375rem;\n    padding: 0.5rem 0.75rem;\n    background-color: var(--code-background, color-mix(in oklab, var(--foreground) 6%, transparent));\n  }\n  .api-description pre code {\n    display: block;\n    padding: 0;\n    border-radius: 0;\n    background: none;\n    white-space: pre;\n  }\n  .api-description a {\n    color: var(--primary);\n    text-decoration: underline;\n    text-underline-offset: 2px;\n  }\n\n\n  details[open] > summary [data-section-chevron] {\n    transform: rotate(90deg);\n  }\n\n\n  details[open] > summary [data-property-chevron] {\n    transform: rotate(90deg);\n  }\n", "code-rich.css": '/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/ui code-rich.css. Do not edit. */\n/* CodeRich annotation styles \u2014 applied via CSS classes from Shiki transformers */\n\n/* \u2500\u2500 All lines \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .line {\n  /* inline-block, not inline-flex: a flex line makes each token span a flex item, and\n     browsers then copy a hand-made selection with a line break between tokens. */\n  display: inline-block;\n  width: 100%;\n}\n\n/* \u2500\u2500 Gutter (single column: line number + diff marker) \u2500\u2500 */\n.code-rich-body .gutter {\n  display: inline-block;\n  min-width: 4ch;\n  margin-right: 1.5ch;\n  text-align: right;\n  /* Theme-aware, and NO alpha. This was a fixed dark grey at 70%\n     opacity: fine on a light code background, 1.3:1 against the dark\n     one \u2014 line numbers were effectively invisible in dark mode.\n     Opacity compounds it, since it blends toward whatever is behind.\n     --muted-foreground already flips per theme (L 0.45 / 0.708). */\n  color: var(--muted-foreground);\n  user-select: none;\n  flex-shrink: 0;\n}\n.code-rich-body .gutter.add {\n  color: oklch(0.55 0.2 145);\n}\n.code-rich-body .gutter.remove {\n  color: oklch(0.55 0.2 25);\n}\n\n/* Dark mode: the diff gutters sit on TINTED line backgrounds, not on\n   the plain code background, and at L0.55 they measure 2.89:1 (add)\n   and 2.63:1 (remove) there \u2014 both well under AA. Light mode is\n   unaffected, so these are overrides rather than a changed base.\n   Raised to L0.72 for headroom over the 4.5:1 floor. */\n.dark .code-rich-body .gutter.add {\n  color: oklch(0.72 0.2 145);\n}\n.dark .code-rich-body .gutter.remove {\n  color: oklch(0.72 0.14 25);\n}\n\n/* \u2500\u2500 Diff line backgrounds \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .line.diff.add {\n  background-color: oklch(0.75 0.18 145 / 0.15);\n}\n.code-rich-body .line.diff.remove {\n  background-color: oklch(0.65 0.2 25 / 0.15);\n}\n\n/* \u2500\u2500 Focus \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body pre.has-focused .line:not(.focused) {\n  opacity: 0.7;\n  transition: opacity 0.3s;\n}\n.code-rich-body pre.has-focused:hover .line:not(.focused) {\n  opacity: 0.9;\n}\n.code-rich-body pre.has-focused .line.focused {\n  opacity: 1;\n}\n\n/* \u2500\u2500 Highlight (background only) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .line.highlighted {\n  background-color: oklch(0.7 0.1 250 / 0.08);\n}\n\n/* \u2500\u2500 Error / Warning / Info levels \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .line.highlighted.error {\n  background-color: oklch(0.65 0.2 25 / 0.08);\n}\n.code-rich-body .line.highlighted.warning {\n  background-color: oklch(0.75 0.18 65 / 0.08);\n}\n.code-rich-body .line.highlighted.info {\n  background-color: oklch(0.7 0.15 250 / 0.08);\n}\n\n/* \u2500\u2500 Word highlight \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.code-rich-body .highlighted-word {\n  background-color: oklch(0.7 0.1 250 / 0.25);\n  border-radius: 3px;\n  padding: 1px 4px;\n  margin: 0 -1px;\n}\n\n/* \u2500\u2500 `collapse` fence option: line runs folded behind a toggle \u2500\u2500\n   No script: a checkbox inside the label. Lines hide only where :has() works,\n   so a browser without it shows every line rather than losing them. */\n.code-rich-body .code-collapse-label {\n  display: inline-block;\n  width: 100%;\n  cursor: pointer;\n  user-select: none;\n  /* The code\'s own colour: a muted label fell under 4.5:1 on the code background */\n  border-block: 1px dashed color-mix(in oklab, currentColor 35%, transparent);\n  font-style: italic;\n}\n.code-rich-body .code-collapse-toggle {\n  position: absolute;\n  width: 1px;\n  height: 1px;\n  opacity: 0;\n}\n.code-rich-body .code-collapse-label:has(.code-collapse-toggle:focus-visible) {\n  outline: 2px solid var(--ring);\n  outline-offset: -2px;\n}\n/* The label stays when open, so focus stays on the checkbox and it folds again */\n.code-rich-body .code-collapse-label::before {\n  content: "\u25B8 ";\n}\n.code-rich-body .code-collapse-label:has(.code-collapse-toggle:checked)::before {\n  content: "\u25BE ";\n}\n.code-rich-body .code-collapse:has(.code-collapse-toggle:not(:checked)) > .code-collapse-lines {\n  display: none;\n}\n', "docs.css": `/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/format-astro (generateGlobalCss). Do not edit. */
 
 /* Custom elements have no user-agent style, so an unstyled one is
    display:inline \u2014 on which w-full does nothing and a border paints
@@ -71,7 +71,10 @@ var THEME_CSS = { "api.css": "/* Generated by packages/render-html/scripts/sync-
   & li > * + *:not(.dba-api *) { margin-top: 0.75rem; }
 
   & ul:not(.dba-api *) { list-style: disc; padding-left: 1.5rem; margin: 0.75rem 0; }
-  & ol:not(.dba-api *) { list-style: decimal; padding-left: 1.5rem; margin: 0.75rem 0; }
+  /* Not a step list, nor a list inside one: Steps.astro draws their numbers as circles, and this
+     rule (one class and an element) outranked its .steps-list { list-style: none }, so each step
+     showed its "2." beside its circle */
+  & ol:not(.dba-api *):not(.steps-list, .sub-steps-list, .steps-list ol) { list-style: decimal; padding-left: 1.5rem; margin: 0.75rem 0; }
   & li:not(.dba-api *) { margin: 0.25rem 0; }
   & li > ul:not(.dba-api *), & li > ol:not(.dba-api *) { margin: 0.25rem 0; }
   /* A file tree draws its own folder and file icons (files/markup.ts): the list rules above gave it bullets too */
@@ -220,7 +223,166 @@ var THEME_CSS = { "api.css": "/* Generated by packages/render-html/scripts/sync-
     display: none;
   }
 }
-`, "steps.css": '/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/ui Steps.astro, SubSteps.astro. Do not edit. */\n\n  .steps-list {\n    position: relative;\n    padding-left: 1.75rem;\n    counter-reset: step;\n    list-style: none;\n    margin: 0;\n  }\n\n  .steps-list > li {\n    position: relative;\n    padding-bottom: 1.5rem;\n    counter-increment: step;\n  }\n\n  .steps-list > li:last-child {\n    padding-bottom: 0;\n  }\n\n  /* Numbered circle */\n  .steps-list > li::before {\n    content: counter(step);\n    position: absolute;\n    left: -1.75rem;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    width: 1.5rem;\n    height: 1.5rem;\n    border-radius: 9999px;\n    border: 2px solid var(--color-border);\n    background: var(--color-background);\n    color: var(--color-foreground);\n    font-size: 0.75rem;\n    font-weight: 600;\n    line-height: 1;\n  }\n\n  /* Connector line */\n  .steps-list > li:not(:last-child)::after {\n    content: "";\n    position: absolute;\n    left: calc(-1.75rem + 0.6875rem);\n    top: 1.75rem;\n    bottom: 0;\n    width: 1px;\n    background: var(--color-border);\n  }\n\n  /* Sub-steps: nested ol inside li */\n  .steps-list > li ol {\n    position: relative;\n    padding-left: 1.5rem;\n    counter-reset: substep;\n    list-style: none;\n    margin: 0.75rem 0 0 0;\n  }\n\n  .steps-list > li ol > li {\n    position: relative;\n    padding-bottom: 1rem;\n    counter-increment: substep;\n  }\n\n  .steps-list > li ol > li:last-child {\n    padding-bottom: 0;\n  }\n\n  /* Lettered circle (a, b, c) */\n  .steps-list > li ol > li::before {\n    content: counter(substep, lower-alpha);\n    position: absolute;\n    left: -1.5rem;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    width: 1.25rem;\n    height: 1.25rem;\n    border-radius: 9999px;\n    border: 1.5px solid var(--color-border);\n    background: var(--color-background);\n    color: var(--color-muted-foreground, #737373);\n    font-size: 0.625rem;\n    font-weight: 600;\n    line-height: 1;\n  }\n\n  /* Sub-step connector line */\n  .steps-list > li ol > li:not(:last-child)::after {\n    content: "";\n    position: absolute;\n    left: calc(-1.5rem + 0.5625rem);\n    top: 1.5rem;\n    bottom: 0;\n    width: 1px;\n    background: var(--color-border);\n    opacity: 0.6;\n  }\n\n\n  .sub-steps-list {\n    position: relative;\n    padding-left: 1.5rem;\n    counter-reset: substep;\n    list-style: none;\n    margin: 0.75rem 0 0 0;\n  }\n\n  .sub-steps-list > li {\n    position: relative;\n    padding-bottom: 1rem;\n    counter-increment: substep;\n  }\n\n  .sub-steps-list > li:last-child {\n    padding-bottom: 0;\n  }\n\n  /* Lettered circle (a, b, c) */\n  .sub-steps-list > li::before {\n    content: counter(substep, lower-alpha);\n    position: absolute;\n    left: -1.5rem;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    width: 1.25rem;\n    height: 1.25rem;\n    border-radius: 9999px;\n    border: 1.5px solid var(--color-border);\n    background: var(--color-background);\n    color: var(--color-muted-foreground, #737373);\n    font-size: 0.625rem;\n    font-weight: 600;\n    line-height: 1;\n  }\n\n  /* Connector line (thinner) */\n  .sub-steps-list > li:not(:last-child)::after {\n    content: "";\n    position: absolute;\n    left: calc(-1.5rem + 0.5625rem);\n    top: 1.5rem;\n    bottom: 0;\n    width: 1px;\n    background: var(--color-border);\n    opacity: 0.6;\n  }\n', "theme-default.css": '/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/format-astro (themeCss("default")). Do not edit. */\n@custom-variant dark (&:where(.dark, .dark *));\n\n@theme inline {\n  --color-background: var(--background);\n  --color-foreground: var(--foreground);\n  --color-card: var(--card);\n  --color-card-foreground: var(--card-foreground);\n  --color-popover: var(--popover);\n  --color-popover-foreground: var(--popover-foreground);\n  --color-primary: var(--primary);\n  --color-primary-foreground: var(--primary-foreground);\n  --color-secondary: var(--secondary);\n  --color-secondary-foreground: var(--secondary-foreground);\n  --color-muted: var(--muted);\n  --color-muted-foreground: var(--muted-foreground);\n  --color-accent: var(--accent);\n  --color-accent-foreground: var(--accent-foreground);\n  --color-destructive: var(--destructive);\n  --color-destructive-foreground: var(--destructive-foreground);\n  --color-border: var(--border);\n  --color-input: var(--input);\n  --color-ring: var(--ring);\n  --radius-sm: calc(var(--radius) - 4px);\n  --radius-md: calc(var(--radius) - 2px);\n  --radius-lg: var(--radius);\n  --radius-xl: calc(var(--radius) + 4px);\n\n  /* Sidebar */\n  --color-sidebar: var(--sidebar);\n  --color-sidebar-foreground: var(--sidebar-foreground);\n  --color-sidebar-primary: var(--sidebar-primary);\n  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);\n  --color-sidebar-accent: var(--sidebar-accent);\n  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);\n  --color-sidebar-border: var(--sidebar-border);\n  --color-sidebar-ring: var(--sidebar-ring);\n\n  /* Admonition colors */\n  --color-note: var(--note);\n  --color-note-foreground: var(--note-foreground);\n  --color-abstract: var(--abstract);\n  --color-info: var(--info);\n  --color-tip: var(--tip);\n  --color-success: var(--success);\n  --color-question: var(--question);\n  --color-warning: var(--warning);\n  --color-failure: var(--failure);\n  --color-danger: var(--danger);\n  --color-bug: var(--bug);\n  --color-example: var(--example);\n  --color-quote: var(--quote);\n\n  /* Code */\n  --color-code-bg: var(--code-background);\n  --color-code-fg: var(--code-foreground);\n\n  /* API reference \u2014 HTTP method, type, status, role colors */\n  --color-api-field: var(--api-field);\n  --color-api-get: var(--api-get);\n  --color-api-post: var(--api-post);\n  --color-api-put: var(--api-put);\n  --color-api-patch: var(--api-patch);\n  --color-api-delete: var(--api-delete);\n  --color-api-head: var(--api-head);\n  --color-api-required: var(--api-required);\n  --color-api-deprecated: var(--api-deprecated);\n  --color-api-type-string: var(--api-type-string);\n  --color-api-type-number: var(--api-type-number);\n  --color-api-type-boolean: var(--api-type-boolean);\n  --color-api-type-object: var(--api-type-object);\n  --color-api-type-array: var(--api-type-array);\n  --color-api-status-2xx: var(--api-status-2xx);\n  --color-api-status-3xx: var(--api-status-3xx);\n  --color-api-status-4xx: var(--api-status-4xx);\n  --color-api-status-5xx: var(--api-status-5xx);\n\n  /* Fonts */\n  --font-sans: var(--font-sans);\n  --font-mono: var(--font-code);\n  --font-family-code: var(--font-code);\n}\n\n:root {\n  --background: oklch(1 0 0);\n  --foreground: oklch(0.145 0.014 285.823);\n  --card: oklch(1 0 0);\n  --card-foreground: oklch(0.145 0.014 285.823);\n  --popover: oklch(1 0 0);\n  --popover-foreground: oklch(0.145 0.014 285.823);\n  --primary: oklch(0.205 0.014 285.823);\n  --primary-foreground: oklch(0.985 0 0);\n  --secondary: oklch(0.965 0.001 286.375);\n  --secondary-foreground: oklch(0.205 0.014 285.823);\n  --muted: oklch(0.965 0.001 286.375);\n  --muted-foreground: oklch(0.45 0.014 285.938);\n  --accent: oklch(0.965 0.001 286.375);\n  --accent-foreground: oklch(0.205 0.014 285.823);\n  --destructive: oklch(0.45 0.245 27.325);\n  --destructive-foreground: oklch(0.985 0 0);\n  --border: oklch(0.922 0.004 286.32);\n  --input: oklch(0.922 0.004 286.32);\n  --ring: oklch(0.708 0.014 285.823);\n  --radius: 0.625rem;\n  --note: oklch(0.637 0.174 259.126);\n  --note-foreground: var(--foreground);\n  --abstract: oklch(0.691 0.148 221.723);\n  --info: oklch(0.722 0.128 207.084);\n  --tip: oklch(0.731 0.112 178.627);\n  --success: oklch(0.754 0.175 149.577);\n  --question: oklch(0.809 0.19 126.526);\n  --warning: oklch(0.74 0.175 62.778);\n  --failure: oklch(0.614 0.194 21.602);\n  --danger: oklch(0.577 0.245 16.439);\n  --bug: oklch(0.548 0.258 349.761);\n  --example: oklch(0.534 0.222 286.033);\n  --quote: oklch(0.65 0 0);\n  --sidebar: oklch(0.985 0 0);\n  --sidebar-foreground: oklch(0.145 0.014 285.823);\n  --sidebar-primary: oklch(0.205 0.014 285.823);\n  --sidebar-primary-foreground: oklch(0.985 0 0);\n  --sidebar-accent: oklch(0.965 0.001 286.375);\n  --sidebar-accent-foreground: oklch(0.205 0.014 285.823);\n  --sidebar-border: oklch(0.922 0.004 286.32);\n  --sidebar-ring: oklch(0.708 0.014 285.823);\n  --code-background: oklch(0.965 0.004 264);\n  --code-foreground: oklch(0.3 0.014 253.833);\n\n  /* API reference \u2014 always-dark code panel */\n  --api-panel-bg: oklch(0.145 0.014 253.833);\n  --api-panel-fg: oklch(0.926 0.013 253.833);\n\n  /* API semantic colors \u2014 HTTP methods, types, status codes */\n  /* Light mode: darkened for WCAG AA on the 20%/10% tints. See .dark. */\n  --api-get: oklch(0.435 0.095 162);\n  --api-post: oklch(0.45 0.174 259);\n  --api-put: oklch(0.455 0.105 63);\n  --api-patch: oklch(0.455 0.13 45);\n  --api-delete: oklch(0.45 0.179 22);\n  --api-head: oklch(0.47 0.222 286);\n  --api-required: oklch(0.45 0.179 22);\n  --api-deprecated: oklch(0.455 0.105 63);\n  /* A field name in an operation\'s description (`id`, `name`): the JSON\n     key colour of the highlighted examples (github-light-default #0550ae). */\n  --api-field: oklch(0.47 0.16 254);\n  --api-type-string: oklch(0.435 0.095 162);\n  --api-type-number: oklch(0.45 0.174 259);\n  --api-type-boolean: oklch(0.455 0.105 63);\n  --api-type-object: oklch(0.47 0.222 286);\n  --api-type-array: oklch(0.455 0.13 45);\n  --api-status-2xx: oklch(0.435 0.095 162);\n  --api-status-3xx: oklch(0.45 0.174 259);\n  --api-status-4xx: oklch(0.455 0.105 63);\n  --api-status-5xx: oklch(0.45 0.179 22);\n\n  --font-sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;\n  --font-heading: var(--font-sans);\n  --font-code: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;\n}\n\n.dark {\n  --background: oklch(0.145 0.014 285.823);\n  --foreground: oklch(0.985 0 0);\n  --card: oklch(0.145 0.014 285.823);\n  --card-foreground: oklch(0.985 0 0);\n  --popover: oklch(0.145 0.014 285.823);\n  --popover-foreground: oklch(0.985 0 0);\n  --primary: oklch(0.985 0 0);\n  --primary-foreground: oklch(0.205 0.014 285.823);\n  --secondary: oklch(0.269 0.007 286.033);\n  --secondary-foreground: oklch(0.985 0 0);\n  --muted: oklch(0.269 0.007 286.033);\n  --muted-foreground: oklch(0.708 0.014 285.823);\n  --accent: oklch(0.269 0.007 286.033);\n  --accent-foreground: oklch(0.985 0 0);\n  --destructive: oklch(0.704 0.191 22.216);\n  --destructive-foreground: oklch(0.145 0.014 285.823);\n  --border: oklch(0.269 0.007 286.033);\n  --input: oklch(0.269 0.007 286.033);\n  --ring: oklch(0.439 0.01 286.375);\n  --note-foreground: var(--foreground);\n  --sidebar: oklch(0.205 0.014 285.823);\n  --sidebar-foreground: oklch(0.985 0 0);\n  --sidebar-primary: oklch(0.488 0.243 264.376);\n  --sidebar-primary-foreground: oklch(0.985 0 0);\n  --sidebar-accent: oklch(0.269 0.007 286.033);\n  --sidebar-accent-foreground: oklch(0.985 0 0);\n  --sidebar-border: oklch(0.269 0.007 286.033);\n  --sidebar-ring: oklch(0.439 0.01 286.375);\n  --code-background: oklch(0.18 0.014 253.833);\n  --code-foreground: oklch(0.926 0.013 253.833);\n\n  /* API semantic colors \u2014 lightened for dark mode (AA on 20%/10% tints). */\n  --api-get: oklch(0.720 0.135 162);\n  --api-post: oklch(0.755 0.174 259);\n  --api-put: oklch(0.745 0.15 63);\n  --api-patch: oklch(0.725 0.18 45);\n  --api-delete: oklch(0.805 0.194 22);\n  --api-head: oklch(0.740 0.182 286);\n  --api-required: oklch(0.805 0.194 22);\n  --api-deprecated: oklch(0.745 0.15 63);\n  --api-field: oklch(0.79 0.11 245); /* github-dark-default #79c0ff */\n  --api-type-string: oklch(0.690 0.135 162);\n  --api-type-number: oklch(0.725 0.174 259);\n  --api-type-boolean: oklch(0.720 0.15 63);\n  --api-type-object: oklch(0.740 0.182 286);\n  --api-type-array: oklch(0.725 0.18 45);\n  --api-status-2xx: oklch(0.720 0.135 162);\n  --api-status-3xx: oklch(0.755 0.174 259);\n  --api-status-4xx: oklch(0.770 0.15 63);\n  --api-status-5xx: oklch(0.805 0.194 22);\n}\n\n@layer base {\n  * { @apply border-border outline-ring/50; }\n  body { @apply bg-background text-foreground font-sans; }\n}\n\n/* Shiki dual-theme: light by default, dark when .dark class is active */\n.shiki,\n.shiki span,\n.astro-code,\n.astro-code span {\n  color: var(--shiki-light) !important;\n}\n.shiki,\n.astro-code {\n  background-color: var(--shiki-light-bg) !important;\n}\n.dark .shiki,\n.dark .shiki span,\n.dark .astro-code,\n.dark .astro-code span {\n  color: var(--shiki-dark) !important;\n}\n.dark .shiki,\n.dark .astro-code {\n  background-color: var(--shiki-dark-bg) !important;\n}\n/* Fix comment color contrast for WCAG AA */\n.shiki span[style*="--shiki-light:#6E7781"],\n.astro-code span[style*="--shiki-light:#6E7781"] {\n  --shiki-light: #576069 !important;\n}\n', "theme-mintlify.css": '/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/format-astro (themeCss("mintlify")). Do not edit. */\n@custom-variant dark (&:where(.dark, .dark *));\n\n@theme inline {\n  --color-background: var(--background);\n  --color-foreground: var(--foreground);\n  --color-card: var(--card);\n  --color-card-foreground: var(--card-foreground);\n  --color-popover: var(--popover);\n  --color-popover-foreground: var(--popover-foreground);\n  --color-primary: var(--primary);\n  --color-primary-foreground: var(--primary-foreground);\n  --color-secondary: var(--secondary);\n  --color-secondary-foreground: var(--secondary-foreground);\n  --color-muted: var(--muted);\n  --color-muted-foreground: var(--muted-foreground);\n  --color-accent: var(--accent);\n  --color-accent-foreground: var(--accent-foreground);\n  --color-destructive: var(--destructive);\n  --color-destructive-foreground: var(--destructive-foreground);\n  --color-border: var(--border);\n  --color-input: var(--input);\n  --color-ring: var(--ring);\n  --radius-sm: calc(var(--radius) - 4px);\n  --radius-md: calc(var(--radius) - 2px);\n  --radius-lg: var(--radius);\n  --radius-xl: calc(var(--radius) + 4px);\n\n  /* Sidebar */\n  --color-sidebar: var(--sidebar);\n  --color-sidebar-foreground: var(--sidebar-foreground);\n  --color-sidebar-primary: var(--sidebar-primary);\n  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);\n  --color-sidebar-accent: var(--sidebar-accent);\n  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);\n  --color-sidebar-border: var(--sidebar-border);\n  --color-sidebar-ring: var(--sidebar-ring);\n\n  /* Admonition colors */\n  --color-note: var(--note);\n  --color-note-foreground: var(--note-foreground);\n  --color-abstract: var(--abstract);\n  --color-info: var(--info);\n  --color-tip: var(--tip);\n  --color-success: var(--success);\n  --color-question: var(--question);\n  --color-warning: var(--warning);\n  --color-failure: var(--failure);\n  --color-danger: var(--danger);\n  --color-bug: var(--bug);\n  --color-example: var(--example);\n  --color-quote: var(--quote);\n\n  /* Code */\n  --color-code-bg: var(--code-background);\n  --color-code-fg: var(--code-foreground);\n\n  /* API reference \u2014 HTTP method, type, status, role colors */\n  --color-api-field: var(--api-field);\n  --color-api-get: var(--api-get);\n  --color-api-post: var(--api-post);\n  --color-api-put: var(--api-put);\n  --color-api-patch: var(--api-patch);\n  --color-api-delete: var(--api-delete);\n  --color-api-head: var(--api-head);\n  --color-api-required: var(--api-required);\n  --color-api-deprecated: var(--api-deprecated);\n  --color-api-type-string: var(--api-type-string);\n  --color-api-type-number: var(--api-type-number);\n  --color-api-type-boolean: var(--api-type-boolean);\n  --color-api-type-object: var(--api-type-object);\n  --color-api-type-array: var(--api-type-array);\n  --color-api-status-2xx: var(--api-status-2xx);\n  --color-api-status-3xx: var(--api-status-3xx);\n  --color-api-status-4xx: var(--api-status-4xx);\n  --color-api-status-5xx: var(--api-status-5xx);\n\n  /* Fonts */\n  --font-sans: var(--font-sans);\n  --font-mono: var(--font-code);\n  --font-family-code: var(--font-code);\n}\n\n:root {\n  --background: oklch(0.993 0.005 95);\n  --foreground: oklch(0.15 0.01 260);\n  --card: oklch(0.993 0.005 95);\n  --card-foreground: oklch(0.15 0.01 260);\n  --popover: oklch(0.993 0.005 95);\n  --popover-foreground: oklch(0.15 0.01 260);\n  --primary: oklch(0.15 0.01 260);\n  --primary-foreground: oklch(0.985 0 0);\n  --secondary: oklch(0.97 0.002 260);\n  --secondary-foreground: oklch(0.15 0.01 260);\n  --muted: oklch(0.97 0.002 260);\n  --muted-foreground: oklch(0.45 0.01 260);\n  --accent: oklch(0.97 0.002 260);\n  --accent-foreground: oklch(0.15 0.01 260);\n  --destructive: oklch(0.55 0.22 25);\n  --destructive-foreground: oklch(0.985 0 0);\n  --border: oklch(0.91 0.004 260);\n  --input: oklch(0.91 0.004 260);\n  --ring: oklch(0.7 0.01 260);\n  --radius: 1rem;\n  /* Callout colors \u2014 soft pastel backgrounds matching Mintlify */\n  --note: oklch(0.62 0.18 260);\n  --note-foreground: var(--foreground);\n  --abstract: oklch(0.65 0.14 220);\n  --info: oklch(0.65 0.14 230);\n  --tip: oklch(0.65 0.16 155);\n  --success: oklch(0.65 0.16 155);\n  --question: oklch(0.7 0.15 270);\n  --warning: oklch(0.7 0.15 75);\n  --failure: oklch(0.6 0.2 25);\n  --danger: oklch(0.55 0.22 25);\n  --bug: oklch(0.55 0.22 350);\n  --example: oklch(0.55 0.2 285);\n  --quote: oklch(0.55 0 0);\n  /* Sidebar */\n  --sidebar: oklch(0.993 0.005 95);\n  --sidebar-foreground: oklch(0.15 0.01 260);\n  --sidebar-primary: oklch(0.15 0.01 260);\n  --sidebar-primary-foreground: oklch(0.985 0 0);\n  --sidebar-accent: oklch(0.97 0.002 260);\n  --sidebar-accent-foreground: oklch(0.15 0.01 260);\n  --sidebar-border: oklch(0.93 0.004 260);\n  --sidebar-ring: oklch(0.7 0.01 260);\n  /* Code \u2014 light gray background, matching Mintlify\'s inline code */\n  --code-background: oklch(0.96 0.003 260);\n  --code-foreground: oklch(0.25 0.01 260);\n\n  /* API reference \u2014 always-dark code panel */\n  --api-panel-bg: oklch(0.145 0.014 253.833);\n  --api-panel-fg: oklch(0.926 0.013 253.833);\n\n  /* API semantic colors \u2014 HTTP methods, types, status codes */\n  /* Light mode: darkened for WCAG AA on the 20%/10% tints. See .dark. */\n  --api-get: oklch(0.435 0.095 162);\n  --api-post: oklch(0.45 0.174 259);\n  --api-put: oklch(0.455 0.105 63);\n  --api-patch: oklch(0.455 0.13 45);\n  --api-delete: oklch(0.45 0.179 22);\n  --api-head: oklch(0.47 0.222 286);\n  --api-required: oklch(0.45 0.179 22);\n  --api-deprecated: oklch(0.455 0.105 63);\n  /* A field name in an operation\'s description (`id`, `name`): the JSON\n     key colour of the highlighted examples (github-light-default #0550ae). */\n  --api-field: oklch(0.47 0.16 254);\n  --api-type-string: oklch(0.435 0.095 162);\n  --api-type-number: oklch(0.45 0.174 259);\n  --api-type-boolean: oklch(0.455 0.105 63);\n  --api-type-object: oklch(0.47 0.222 286);\n  --api-type-array: oklch(0.455 0.13 45);\n  --api-status-2xx: oklch(0.435 0.095 162);\n  --api-status-3xx: oklch(0.45 0.174 259);\n  --api-status-4xx: oklch(0.455 0.105 63);\n  --api-status-5xx: oklch(0.45 0.179 22);\n\n  /* Fonts \u2014 system sans for body, JetBrains Mono for code */\n  --font-sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;\n  --font-heading: var(--font-sans);\n  --font-code: "JetBrains Mono", "Fira Code", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n}\n\n.dark {\n  --background: oklch(0.16 0.01 260);\n  --foreground: oklch(0.93 0.005 260);\n  --card: oklch(0.18 0.01 260);\n  --card-foreground: oklch(0.93 0.005 260);\n  --popover: oklch(0.18 0.01 260);\n  --popover-foreground: oklch(0.93 0.005 260);\n  --primary: oklch(0.93 0.005 260);\n  --primary-foreground: oklch(0.16 0.01 260);\n  --secondary: oklch(0.22 0.008 260);\n  --secondary-foreground: oklch(0.93 0.005 260);\n  --muted: oklch(0.22 0.008 260);\n  --muted-foreground: oklch(0.65 0.01 260);\n  --accent: oklch(0.22 0.008 260);\n  --accent-foreground: oklch(0.93 0.005 260);\n  --destructive: oklch(0.65 0.2 25);\n  --destructive-foreground: oklch(0.16 0.01 260);\n  --border: oklch(0.28 0.008 260);\n  --input: oklch(0.28 0.008 260);\n  --ring: oklch(0.45 0.01 260);\n  --note-foreground: var(--foreground);\n  --sidebar: oklch(0.16 0.01 260);\n  --sidebar-foreground: oklch(0.93 0.005 260);\n  --sidebar-primary: oklch(0.55 0.2 260);\n  --sidebar-primary-foreground: oklch(0.93 0.005 260);\n  --sidebar-accent: oklch(0.22 0.008 260);\n  --sidebar-accent-foreground: oklch(0.93 0.005 260);\n  --sidebar-border: oklch(0.28 0.008 260);\n  --sidebar-ring: oklch(0.45 0.01 260);\n  --code-background: oklch(0.2 0.01 260);\n  --code-foreground: oklch(0.9 0.01 260);\n\n  /* API semantic colors \u2014 lightened for dark mode (AA on 20%/10% tints). */\n  --api-get: oklch(0.720 0.135 162);\n  --api-post: oklch(0.755 0.174 259);\n  --api-put: oklch(0.745 0.15 63);\n  --api-patch: oklch(0.725 0.18 45);\n  --api-delete: oklch(0.805 0.194 22);\n  --api-head: oklch(0.740 0.182 286);\n  --api-required: oklch(0.805 0.194 22);\n  --api-deprecated: oklch(0.745 0.15 63);\n  --api-field: oklch(0.79 0.11 245); /* github-dark-default #79c0ff */\n  --api-type-string: oklch(0.690 0.135 162);\n  --api-type-number: oklch(0.725 0.174 259);\n  --api-type-boolean: oklch(0.720 0.15 63);\n  --api-type-object: oklch(0.740 0.182 286);\n  --api-type-array: oklch(0.725 0.18 45);\n  --api-status-2xx: oklch(0.720 0.135 162);\n  --api-status-3xx: oklch(0.755 0.174 259);\n  --api-status-4xx: oklch(0.770 0.15 63);\n  --api-status-5xx: oklch(0.805 0.194 22);\n}\n\n@layer base {\n  * { @apply border-border outline-ring/50; }\n  body { @apply bg-background text-foreground font-sans; }\n}\n\n/* Shiki dual-theme: light by default, dark when .dark class is active */\n.shiki,\n.shiki span,\n.astro-code,\n.astro-code span {\n  color: var(--shiki-light) !important;\n}\n.shiki,\n.astro-code {\n  background-color: var(--shiki-light-bg) !important;\n}\n.dark .shiki,\n.dark .shiki span,\n.dark .astro-code,\n.dark .astro-code span {\n  color: var(--shiki-dark) !important;\n}\n.dark .shiki,\n.dark .astro-code {\n  background-color: var(--shiki-dark-bg) !important;\n}\n/* Fix comment color contrast for WCAG AA */\n.shiki span[style*="--shiki-light:#6E7781"],\n.astro-code span[style*="--shiki-light:#6E7781"] {\n  --shiki-light: #576069 !important;\n}\n', "image-zoom.css": "/* Generated by scripts/sync-astro-styles.mjs from @dogsbay/plugin-image-zoom styles.css. Do not edit. */\n/**\n * Styles shipped by @dogsbay/plugin-image-zoom.\n *\n * Imported into the user's `src/styles/global.css` by `dogsbay\n * site build` via the plugin runtime emitter.\n */\n\n[data-zoomable] {\n  cursor: zoom-in;\n  transition: transform 200ms ease;\n}\n\n.medium-zoom-overlay {\n  z-index: 100;\n}\n\n.medium-zoom-image {\n  cursor: zoom-out;\n  z-index: 101;\n}\n\n.medium-zoom--opened [data-zoomable] {\n  cursor: default;\n}\n", "ssg.css": `/*
+`, "steps.css": `/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/ui Steps.astro, SubSteps.astro. Do not edit. */
+
+  .steps-list {
+    position: relative;
+    padding-left: 1.75rem;
+    counter-reset: step;
+    list-style: none;
+    margin: 0;
+  }
+
+  .steps-list > li {
+    position: relative;
+    padding-bottom: 1.5rem;
+    counter-increment: step;
+  }
+
+  .steps-list > li:last-child {
+    padding-bottom: 0;
+  }
+
+  /* Numbered circle */
+  .steps-list > li::before {
+    content: counter(step);
+    position: absolute;
+    left: -1.75rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 1.5rem;
+    height: 1.5rem;
+    border-radius: 9999px;
+    border: 2px solid var(--color-border);
+    background: var(--color-background);
+    color: var(--color-foreground);
+    font-size: 0.75rem;
+    font-weight: 600;
+    line-height: 1;
+  }
+
+  /* Connector line */
+  .steps-list > li:not(:last-child)::after {
+    content: "";
+    position: absolute;
+    left: calc(-1.75rem + 0.6875rem);
+    top: 1.75rem;
+    bottom: 0;
+    width: 1px;
+    background: var(--color-border);
+  }
+
+  /* Sub-steps: nested ol inside li */
+  .steps-list > li ol {
+    position: relative;
+    padding-left: 1.5rem;
+    counter-reset: substep;
+    list-style: none;
+    margin: 0.75rem 0 0 0;
+  }
+
+  .steps-list > li ol > li {
+    position: relative;
+    padding-bottom: 1rem;
+    counter-increment: substep;
+  }
+
+  .steps-list > li ol > li:last-child {
+    padding-bottom: 0;
+  }
+
+  /* Lettered circle (a, b, c) */
+  .steps-list > li ol > li::before {
+    content: counter(substep, lower-alpha);
+    position: absolute;
+    left: -1.5rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 1.25rem;
+    height: 1.25rem;
+    border-radius: 9999px;
+    border: 1.5px solid var(--color-border);
+    background: var(--color-background);
+    color: var(--color-muted-foreground, #737373);
+    font-size: 0.625rem;
+    font-weight: 600;
+    line-height: 1;
+  }
+
+  /* Sub-step connector line */
+  .steps-list > li ol > li:not(:last-child)::after {
+    content: "";
+    position: absolute;
+    left: calc(-1.5rem + 0.5625rem);
+    top: 1.5rem;
+    bottom: 0;
+    width: 1px;
+    background: var(--color-border);
+    opacity: 0.6;
+  }
+
+  /* A step's title on its own line, above its detail (format-astro and render-html mark it) */
+  .steps-list > li > .step-title {
+    display: block;
+  }
+
+
+  .sub-steps-list {
+    position: relative;
+    padding-left: 1.5rem;
+    counter-reset: substep;
+    list-style: none;
+    margin: 0.75rem 0 0 0;
+  }
+
+  .sub-steps-list > li {
+    position: relative;
+    padding-bottom: 1rem;
+    counter-increment: substep;
+  }
+
+  .sub-steps-list > li:last-child {
+    padding-bottom: 0;
+  }
+
+  /* Lettered circle (a, b, c) */
+  .sub-steps-list > li::before {
+    content: counter(substep, lower-alpha);
+    position: absolute;
+    left: -1.5rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 1.25rem;
+    height: 1.25rem;
+    border-radius: 9999px;
+    border: 1.5px solid var(--color-border);
+    background: var(--color-background);
+    color: var(--color-muted-foreground, #737373);
+    font-size: 0.625rem;
+    font-weight: 600;
+    line-height: 1;
+  }
+
+  /* Connector line (thinner) */
+  .sub-steps-list > li:not(:last-child)::after {
+    content: "";
+    position: absolute;
+    left: calc(-1.5rem + 0.5625rem);
+    top: 1.5rem;
+    bottom: 0;
+    width: 1px;
+    background: var(--color-border);
+    opacity: 0.6;
+  }
+
+  /* A step's title on its own line, above its detail (format-astro and render-html mark it) */
+  .sub-steps-list > li > .step-title {
+    display: block;
+  }
+`, "theme-default.css": '/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/format-astro (themeCss("default")). Do not edit. */\n@custom-variant dark (&:where(.dark, .dark *));\n\n@theme inline {\n  --color-background: var(--background);\n  --color-foreground: var(--foreground);\n  --color-card: var(--card);\n  --color-card-foreground: var(--card-foreground);\n  --color-popover: var(--popover);\n  --color-popover-foreground: var(--popover-foreground);\n  --color-primary: var(--primary);\n  --color-primary-foreground: var(--primary-foreground);\n  --color-secondary: var(--secondary);\n  --color-secondary-foreground: var(--secondary-foreground);\n  --color-muted: var(--muted);\n  --color-muted-foreground: var(--muted-foreground);\n  --color-accent: var(--accent);\n  --color-accent-foreground: var(--accent-foreground);\n  --color-destructive: var(--destructive);\n  --color-destructive-foreground: var(--destructive-foreground);\n  --color-border: var(--border);\n  --color-input: var(--input);\n  --color-ring: var(--ring);\n  --radius-sm: calc(var(--radius) - 4px);\n  --radius-md: calc(var(--radius) - 2px);\n  --radius-lg: var(--radius);\n  --radius-xl: calc(var(--radius) + 4px);\n\n  /* Sidebar */\n  --color-sidebar: var(--sidebar);\n  --color-sidebar-foreground: var(--sidebar-foreground);\n  --color-sidebar-primary: var(--sidebar-primary);\n  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);\n  --color-sidebar-accent: var(--sidebar-accent);\n  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);\n  --color-sidebar-border: var(--sidebar-border);\n  --color-sidebar-ring: var(--sidebar-ring);\n\n  /* Admonition colors */\n  --color-note: var(--note);\n  --color-note-foreground: var(--note-foreground);\n  --color-abstract: var(--abstract);\n  --color-info: var(--info);\n  --color-tip: var(--tip);\n  --color-success: var(--success);\n  --color-question: var(--question);\n  --color-warning: var(--warning);\n  --color-failure: var(--failure);\n  --color-danger: var(--danger);\n  --color-bug: var(--bug);\n  --color-example: var(--example);\n  --color-quote: var(--quote);\n\n  /* Code */\n  --color-code-bg: var(--code-background);\n  --color-code-fg: var(--code-foreground);\n\n  /* API reference \u2014 HTTP method, type, status, role colors */\n  --color-api-field: var(--api-field);\n  --color-api-get: var(--api-get);\n  --color-api-post: var(--api-post);\n  --color-api-put: var(--api-put);\n  --color-api-patch: var(--api-patch);\n  --color-api-delete: var(--api-delete);\n  --color-api-head: var(--api-head);\n  --color-api-required: var(--api-required);\n  --color-api-deprecated: var(--api-deprecated);\n  --color-api-type-string: var(--api-type-string);\n  --color-api-type-number: var(--api-type-number);\n  --color-api-type-boolean: var(--api-type-boolean);\n  --color-api-type-object: var(--api-type-object);\n  --color-api-type-array: var(--api-type-array);\n  --color-api-status-2xx: var(--api-status-2xx);\n  --color-api-status-3xx: var(--api-status-3xx);\n  --color-api-status-4xx: var(--api-status-4xx);\n  --color-api-status-5xx: var(--api-status-5xx);\n\n  /* Fonts */\n  --font-sans: var(--font-sans);\n  --font-mono: var(--font-code);\n  --font-family-code: var(--font-code);\n}\n\n:root {\n  --background: oklch(1 0 0);\n  --foreground: oklch(0.145 0.014 285.823);\n  --card: oklch(1 0 0);\n  --card-foreground: oklch(0.145 0.014 285.823);\n  --popover: oklch(1 0 0);\n  --popover-foreground: oklch(0.145 0.014 285.823);\n  --primary: oklch(0.205 0.014 285.823);\n  --primary-foreground: oklch(0.985 0 0);\n  --secondary: oklch(0.965 0.001 286.375);\n  --secondary-foreground: oklch(0.205 0.014 285.823);\n  --muted: oklch(0.965 0.001 286.375);\n  --muted-foreground: oklch(0.45 0.014 285.938);\n  --accent: oklch(0.965 0.001 286.375);\n  --accent-foreground: oklch(0.205 0.014 285.823);\n  --destructive: oklch(0.45 0.245 27.325);\n  --destructive-foreground: oklch(0.985 0 0);\n  --border: oklch(0.922 0.004 286.32);\n  --input: oklch(0.922 0.004 286.32);\n  --ring: oklch(0.708 0.014 285.823);\n  --radius: 0.625rem;\n  --note: oklch(0.637 0.174 259.126);\n  --note-foreground: var(--foreground);\n  --abstract: oklch(0.691 0.148 221.723);\n  --info: oklch(0.722 0.128 207.084);\n  --tip: oklch(0.731 0.112 178.627);\n  --success: oklch(0.754 0.175 149.577);\n  --question: oklch(0.809 0.19 126.526);\n  --warning: oklch(0.74 0.175 62.778);\n  --failure: oklch(0.614 0.194 21.602);\n  --danger: oklch(0.577 0.245 16.439);\n  --bug: oklch(0.548 0.258 349.761);\n  --example: oklch(0.534 0.222 286.033);\n  --quote: oklch(0.65 0 0);\n  --sidebar: oklch(0.985 0 0);\n  --sidebar-foreground: oklch(0.145 0.014 285.823);\n  --sidebar-primary: oklch(0.205 0.014 285.823);\n  --sidebar-primary-foreground: oklch(0.985 0 0);\n  --sidebar-accent: oklch(0.965 0.001 286.375);\n  --sidebar-accent-foreground: oklch(0.205 0.014 285.823);\n  --sidebar-border: oklch(0.922 0.004 286.32);\n  --sidebar-ring: oklch(0.708 0.014 285.823);\n  --code-background: oklch(0.965 0.004 264);\n  --code-foreground: oklch(0.3 0.014 253.833);\n\n  /* API reference \u2014 always-dark code panel */\n  --api-panel-bg: oklch(0.145 0.014 253.833);\n  --api-panel-fg: oklch(0.926 0.013 253.833);\n\n  /* API semantic colors \u2014 HTTP methods, types, status codes */\n  /* Light mode: darkened for WCAG AA on the 20%/10% tints. See .dark. */\n  --api-get: oklch(0.435 0.095 162);\n  --api-post: oklch(0.45 0.174 259);\n  --api-put: oklch(0.455 0.105 63);\n  --api-patch: oklch(0.455 0.13 45);\n  --api-delete: oklch(0.45 0.179 22);\n  --api-head: oklch(0.47 0.222 286);\n  --api-required: oklch(0.45 0.179 22);\n  --api-deprecated: oklch(0.455 0.105 63);\n  /* A field name in an operation\'s description (`id`, `name`): the JSON\n     key colour of the highlighted examples (github-light-default #0550ae). */\n  --api-field: oklch(0.47 0.16 254);\n  --api-type-string: oklch(0.435 0.095 162);\n  --api-type-number: oklch(0.45 0.174 259);\n  --api-type-boolean: oklch(0.455 0.105 63);\n  --api-type-object: oklch(0.47 0.222 286);\n  --api-type-array: oklch(0.455 0.13 45);\n  --api-status-2xx: oklch(0.435 0.095 162);\n  --api-status-3xx: oklch(0.45 0.174 259);\n  --api-status-4xx: oklch(0.455 0.105 63);\n  --api-status-5xx: oklch(0.45 0.179 22);\n\n  --font-sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;\n  --font-heading: var(--font-sans);\n  --font-code: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;\n}\n\n.dark {\n  --background: oklch(0.145 0.014 285.823);\n  --foreground: oklch(0.985 0 0);\n  --card: oklch(0.145 0.014 285.823);\n  --card-foreground: oklch(0.985 0 0);\n  --popover: oklch(0.145 0.014 285.823);\n  --popover-foreground: oklch(0.985 0 0);\n  --primary: oklch(0.985 0 0);\n  --primary-foreground: oklch(0.205 0.014 285.823);\n  --secondary: oklch(0.269 0.007 286.033);\n  --secondary-foreground: oklch(0.985 0 0);\n  --muted: oklch(0.269 0.007 286.033);\n  --muted-foreground: oklch(0.708 0.014 285.823);\n  --accent: oklch(0.269 0.007 286.033);\n  --accent-foreground: oklch(0.985 0 0);\n  --destructive: oklch(0.704 0.191 22.216);\n  --destructive-foreground: oklch(0.145 0.014 285.823);\n  --border: oklch(0.269 0.007 286.033);\n  --input: oklch(0.269 0.007 286.033);\n  --ring: oklch(0.439 0.01 286.375);\n  --note-foreground: var(--foreground);\n  --sidebar: oklch(0.205 0.014 285.823);\n  --sidebar-foreground: oklch(0.985 0 0);\n  --sidebar-primary: oklch(0.488 0.243 264.376);\n  --sidebar-primary-foreground: oklch(0.985 0 0);\n  --sidebar-accent: oklch(0.269 0.007 286.033);\n  --sidebar-accent-foreground: oklch(0.985 0 0);\n  --sidebar-border: oklch(0.269 0.007 286.033);\n  --sidebar-ring: oklch(0.439 0.01 286.375);\n  --code-background: oklch(0.18 0.014 253.833);\n  --code-foreground: oklch(0.926 0.013 253.833);\n\n  /* API semantic colors \u2014 lightened for dark mode (AA on 20%/10% tints). */\n  --api-get: oklch(0.720 0.135 162);\n  --api-post: oklch(0.755 0.174 259);\n  --api-put: oklch(0.745 0.15 63);\n  --api-patch: oklch(0.725 0.18 45);\n  --api-delete: oklch(0.805 0.194 22);\n  --api-head: oklch(0.740 0.182 286);\n  --api-required: oklch(0.805 0.194 22);\n  --api-deprecated: oklch(0.745 0.15 63);\n  --api-field: oklch(0.79 0.11 245); /* github-dark-default #79c0ff */\n  --api-type-string: oklch(0.690 0.135 162);\n  --api-type-number: oklch(0.725 0.174 259);\n  --api-type-boolean: oklch(0.720 0.15 63);\n  --api-type-object: oklch(0.740 0.182 286);\n  --api-type-array: oklch(0.725 0.18 45);\n  --api-status-2xx: oklch(0.720 0.135 162);\n  --api-status-3xx: oklch(0.755 0.174 259);\n  --api-status-4xx: oklch(0.770 0.15 63);\n  --api-status-5xx: oklch(0.805 0.194 22);\n}\n\n@layer base {\n  * { @apply border-border outline-ring/50; }\n  body { @apply bg-background text-foreground font-sans; }\n}\n\n/* Shiki dual-theme: light by default, dark when .dark class is active */\n.shiki,\n.shiki span,\n.astro-code,\n.astro-code span {\n  color: var(--shiki-light) !important;\n}\n.shiki,\n.astro-code {\n  background-color: var(--shiki-light-bg) !important;\n}\n.dark .shiki,\n.dark .shiki span,\n.dark .astro-code,\n.dark .astro-code span {\n  color: var(--shiki-dark) !important;\n}\n.dark .shiki,\n.dark .astro-code {\n  background-color: var(--shiki-dark-bg) !important;\n}\n/* Fix comment color contrast for WCAG AA */\n.shiki span[style*="--shiki-light:#6E7781"],\n.astro-code span[style*="--shiki-light:#6E7781"] {\n  --shiki-light: #576069 !important;\n}\n', "theme-mintlify.css": '/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/format-astro (themeCss("mintlify")). Do not edit. */\n@custom-variant dark (&:where(.dark, .dark *));\n\n@theme inline {\n  --color-background: var(--background);\n  --color-foreground: var(--foreground);\n  --color-card: var(--card);\n  --color-card-foreground: var(--card-foreground);\n  --color-popover: var(--popover);\n  --color-popover-foreground: var(--popover-foreground);\n  --color-primary: var(--primary);\n  --color-primary-foreground: var(--primary-foreground);\n  --color-secondary: var(--secondary);\n  --color-secondary-foreground: var(--secondary-foreground);\n  --color-muted: var(--muted);\n  --color-muted-foreground: var(--muted-foreground);\n  --color-accent: var(--accent);\n  --color-accent-foreground: var(--accent-foreground);\n  --color-destructive: var(--destructive);\n  --color-destructive-foreground: var(--destructive-foreground);\n  --color-border: var(--border);\n  --color-input: var(--input);\n  --color-ring: var(--ring);\n  --radius-sm: calc(var(--radius) - 4px);\n  --radius-md: calc(var(--radius) - 2px);\n  --radius-lg: var(--radius);\n  --radius-xl: calc(var(--radius) + 4px);\n\n  /* Sidebar */\n  --color-sidebar: var(--sidebar);\n  --color-sidebar-foreground: var(--sidebar-foreground);\n  --color-sidebar-primary: var(--sidebar-primary);\n  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);\n  --color-sidebar-accent: var(--sidebar-accent);\n  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);\n  --color-sidebar-border: var(--sidebar-border);\n  --color-sidebar-ring: var(--sidebar-ring);\n\n  /* Admonition colors */\n  --color-note: var(--note);\n  --color-note-foreground: var(--note-foreground);\n  --color-abstract: var(--abstract);\n  --color-info: var(--info);\n  --color-tip: var(--tip);\n  --color-success: var(--success);\n  --color-question: var(--question);\n  --color-warning: var(--warning);\n  --color-failure: var(--failure);\n  --color-danger: var(--danger);\n  --color-bug: var(--bug);\n  --color-example: var(--example);\n  --color-quote: var(--quote);\n\n  /* Code */\n  --color-code-bg: var(--code-background);\n  --color-code-fg: var(--code-foreground);\n\n  /* API reference \u2014 HTTP method, type, status, role colors */\n  --color-api-field: var(--api-field);\n  --color-api-get: var(--api-get);\n  --color-api-post: var(--api-post);\n  --color-api-put: var(--api-put);\n  --color-api-patch: var(--api-patch);\n  --color-api-delete: var(--api-delete);\n  --color-api-head: var(--api-head);\n  --color-api-required: var(--api-required);\n  --color-api-deprecated: var(--api-deprecated);\n  --color-api-type-string: var(--api-type-string);\n  --color-api-type-number: var(--api-type-number);\n  --color-api-type-boolean: var(--api-type-boolean);\n  --color-api-type-object: var(--api-type-object);\n  --color-api-type-array: var(--api-type-array);\n  --color-api-status-2xx: var(--api-status-2xx);\n  --color-api-status-3xx: var(--api-status-3xx);\n  --color-api-status-4xx: var(--api-status-4xx);\n  --color-api-status-5xx: var(--api-status-5xx);\n\n  /* Fonts */\n  --font-sans: var(--font-sans);\n  --font-mono: var(--font-code);\n  --font-family-code: var(--font-code);\n}\n\n:root {\n  --background: oklch(0.993 0.005 95);\n  --foreground: oklch(0.15 0.01 260);\n  --card: oklch(0.993 0.005 95);\n  --card-foreground: oklch(0.15 0.01 260);\n  --popover: oklch(0.993 0.005 95);\n  --popover-foreground: oklch(0.15 0.01 260);\n  --primary: oklch(0.15 0.01 260);\n  --primary-foreground: oklch(0.985 0 0);\n  --secondary: oklch(0.97 0.002 260);\n  --secondary-foreground: oklch(0.15 0.01 260);\n  --muted: oklch(0.97 0.002 260);\n  --muted-foreground: oklch(0.45 0.01 260);\n  --accent: oklch(0.97 0.002 260);\n  --accent-foreground: oklch(0.15 0.01 260);\n  --destructive: oklch(0.55 0.22 25);\n  --destructive-foreground: oklch(0.985 0 0);\n  --border: oklch(0.91 0.004 260);\n  --input: oklch(0.91 0.004 260);\n  --ring: oklch(0.7 0.01 260);\n  --radius: 1rem;\n  /* Callout colors \u2014 soft pastel backgrounds matching Mintlify */\n  --note: oklch(0.62 0.18 260);\n  --note-foreground: var(--foreground);\n  --abstract: oklch(0.65 0.14 220);\n  --info: oklch(0.65 0.14 230);\n  --tip: oklch(0.65 0.16 155);\n  --success: oklch(0.65 0.16 155);\n  --question: oklch(0.7 0.15 270);\n  --warning: oklch(0.7 0.15 75);\n  --failure: oklch(0.6 0.2 25);\n  --danger: oklch(0.55 0.22 25);\n  --bug: oklch(0.55 0.22 350);\n  --example: oklch(0.55 0.2 285);\n  --quote: oklch(0.55 0 0);\n  /* Sidebar */\n  --sidebar: oklch(0.993 0.005 95);\n  --sidebar-foreground: oklch(0.15 0.01 260);\n  --sidebar-primary: oklch(0.15 0.01 260);\n  --sidebar-primary-foreground: oklch(0.985 0 0);\n  --sidebar-accent: oklch(0.97 0.002 260);\n  --sidebar-accent-foreground: oklch(0.15 0.01 260);\n  --sidebar-border: oklch(0.93 0.004 260);\n  --sidebar-ring: oklch(0.7 0.01 260);\n  /* Code \u2014 light gray background, matching Mintlify\'s inline code */\n  --code-background: oklch(0.96 0.003 260);\n  --code-foreground: oklch(0.25 0.01 260);\n\n  /* API reference \u2014 always-dark code panel */\n  --api-panel-bg: oklch(0.145 0.014 253.833);\n  --api-panel-fg: oklch(0.926 0.013 253.833);\n\n  /* API semantic colors \u2014 HTTP methods, types, status codes */\n  /* Light mode: darkened for WCAG AA on the 20%/10% tints. See .dark. */\n  --api-get: oklch(0.435 0.095 162);\n  --api-post: oklch(0.45 0.174 259);\n  --api-put: oklch(0.455 0.105 63);\n  --api-patch: oklch(0.455 0.13 45);\n  --api-delete: oklch(0.45 0.179 22);\n  --api-head: oklch(0.47 0.222 286);\n  --api-required: oklch(0.45 0.179 22);\n  --api-deprecated: oklch(0.455 0.105 63);\n  /* A field name in an operation\'s description (`id`, `name`): the JSON\n     key colour of the highlighted examples (github-light-default #0550ae). */\n  --api-field: oklch(0.47 0.16 254);\n  --api-type-string: oklch(0.435 0.095 162);\n  --api-type-number: oklch(0.45 0.174 259);\n  --api-type-boolean: oklch(0.455 0.105 63);\n  --api-type-object: oklch(0.47 0.222 286);\n  --api-type-array: oklch(0.455 0.13 45);\n  --api-status-2xx: oklch(0.435 0.095 162);\n  --api-status-3xx: oklch(0.45 0.174 259);\n  --api-status-4xx: oklch(0.455 0.105 63);\n  --api-status-5xx: oklch(0.45 0.179 22);\n\n  /* Fonts \u2014 system sans for body, JetBrains Mono for code */\n  --font-sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;\n  --font-heading: var(--font-sans);\n  --font-code: "JetBrains Mono", "Fira Code", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n}\n\n.dark {\n  --background: oklch(0.16 0.01 260);\n  --foreground: oklch(0.93 0.005 260);\n  --card: oklch(0.18 0.01 260);\n  --card-foreground: oklch(0.93 0.005 260);\n  --popover: oklch(0.18 0.01 260);\n  --popover-foreground: oklch(0.93 0.005 260);\n  --primary: oklch(0.93 0.005 260);\n  --primary-foreground: oklch(0.16 0.01 260);\n  --secondary: oklch(0.22 0.008 260);\n  --secondary-foreground: oklch(0.93 0.005 260);\n  --muted: oklch(0.22 0.008 260);\n  --muted-foreground: oklch(0.65 0.01 260);\n  --accent: oklch(0.22 0.008 260);\n  --accent-foreground: oklch(0.93 0.005 260);\n  --destructive: oklch(0.65 0.2 25);\n  --destructive-foreground: oklch(0.16 0.01 260);\n  --border: oklch(0.28 0.008 260);\n  --input: oklch(0.28 0.008 260);\n  --ring: oklch(0.45 0.01 260);\n  --note-foreground: var(--foreground);\n  --sidebar: oklch(0.16 0.01 260);\n  --sidebar-foreground: oklch(0.93 0.005 260);\n  --sidebar-primary: oklch(0.55 0.2 260);\n  --sidebar-primary-foreground: oklch(0.93 0.005 260);\n  --sidebar-accent: oklch(0.22 0.008 260);\n  --sidebar-accent-foreground: oklch(0.93 0.005 260);\n  --sidebar-border: oklch(0.28 0.008 260);\n  --sidebar-ring: oklch(0.45 0.01 260);\n  --code-background: oklch(0.2 0.01 260);\n  --code-foreground: oklch(0.9 0.01 260);\n\n  /* API semantic colors \u2014 lightened for dark mode (AA on 20%/10% tints). */\n  --api-get: oklch(0.720 0.135 162);\n  --api-post: oklch(0.755 0.174 259);\n  --api-put: oklch(0.745 0.15 63);\n  --api-patch: oklch(0.725 0.18 45);\n  --api-delete: oklch(0.805 0.194 22);\n  --api-head: oklch(0.740 0.182 286);\n  --api-required: oklch(0.805 0.194 22);\n  --api-deprecated: oklch(0.745 0.15 63);\n  --api-field: oklch(0.79 0.11 245); /* github-dark-default #79c0ff */\n  --api-type-string: oklch(0.690 0.135 162);\n  --api-type-number: oklch(0.725 0.174 259);\n  --api-type-boolean: oklch(0.720 0.15 63);\n  --api-type-object: oklch(0.740 0.182 286);\n  --api-type-array: oklch(0.725 0.18 45);\n  --api-status-2xx: oklch(0.720 0.135 162);\n  --api-status-3xx: oklch(0.755 0.174 259);\n  --api-status-4xx: oklch(0.770 0.15 63);\n  --api-status-5xx: oklch(0.805 0.194 22);\n}\n\n@layer base {\n  * { @apply border-border outline-ring/50; }\n  body { @apply bg-background text-foreground font-sans; }\n}\n\n/* Shiki dual-theme: light by default, dark when .dark class is active */\n.shiki,\n.shiki span,\n.astro-code,\n.astro-code span {\n  color: var(--shiki-light) !important;\n}\n.shiki,\n.astro-code {\n  background-color: var(--shiki-light-bg) !important;\n}\n.dark .shiki,\n.dark .shiki span,\n.dark .astro-code,\n.dark .astro-code span {\n  color: var(--shiki-dark) !important;\n}\n.dark .shiki,\n.dark .astro-code {\n  background-color: var(--shiki-dark-bg) !important;\n}\n/* Fix comment color contrast for WCAG AA */\n.shiki span[style*="--shiki-light:#6E7781"],\n.astro-code span[style*="--shiki-light:#6E7781"] {\n  --shiki-light: #576069 !important;\n}\n', "image-zoom.css": "/* Generated by scripts/sync-astro-styles.mjs from @dogsbay/plugin-image-zoom styles.css. Do not edit. */\n/**\n * Styles shipped by @dogsbay/plugin-image-zoom.\n *\n * Imported into the user's `src/styles/global.css` by `dogsbay\n * site build` via the plugin runtime emitter.\n */\n\n[data-zoomable] {\n  cursor: zoom-in;\n  transition: transform 200ms ease;\n}\n\n.medium-zoom-overlay {\n  z-index: 100;\n}\n\n.medium-zoom-image {\n  cursor: zoom-out;\n  z-index: 101;\n}\n\n.medium-zoom--opened [data-zoomable] {\n  cursor: default;\n}\n", "ssg.css": `/*
  * dogsbay-ssg additions to the Astro styles (docs.css, theme-*.css).
  *
  * Parts that elements create at run time (lazy nav rows, the select's

package/dist/package/types/core/build.d.ts

@@ -1,3 +1,15 @@
+/**
+ * The build. Pure and in-memory: files in, files out. Nothing here
+ * touches a filesystem, so the same code runs in Node, a browser and
+ * a Cloudflare Worker.
+ *
+ * Memory: pages are processed one at a time in two passes. Pass 1
+ * reads only front matter (titles for the nav); pass 2 templates,
+ * parses, renders and emits each page, then drops its tree. Only the
+ * search postings and a few short strings per page (for llms.txt, the
+ * sitemap and redirect checks) grow with the site.
+ */
+import { type ParseDiagnostic } from "@dogsbay/format-dogsbay-md/browser";
 import { type DefaultTable } from "./canonical.js";
 import type { TreeNode } from "@dogsbay/types";
 import type { Highlighter } from "@dogsbay/highlight";
@@ -195,11 +207,69 @@ export interface BuildStats {
 export interface BuildResult {
     files: Map<string, OutputContent>;
     warnings: string[];
+    /** The warnings as data, one per warning, in the same order. */
+    problems: BuildProblem[];
     stats: BuildStats;
     config: SiteConfig;
 }
+/**
+ * A warning as data (plans/playground-asks.md), for a host that shows it by its file: the
+ * playground's problem list. `text` is the warning as `warnings` has it and the CLI prints it.
+ */
+export interface BuildProblem {
+    /** Its kind: `template`, `parse`, `front-matter`, `link`, `nav`, `icon`… (stable, for filtering). */
+    code: string;
+    /** The unit's prefix (`/` for the root unit), for a unit's warning. */
+    unit?: string;
+    /** The project path of the file it is about (`content/guide/a.md`), when it is about one. */
+    file?: string;
+    /** 1-based, in `file`. */
+    line?: number;
+    column?: number;
+    /** The warning without its `[unit]` and file. */
+    message: string;
+    text: string;
+}
+/** Where a warning is, and its message when the text says more (a file first). */
+type ProblemAt = Partial<Omit<BuildProblem, "code" | "text">>;
+/** Adds a warning: its text to `warnings`, and the problem. */
+export type Report = (code: string, text: string, at?: ProblemAt) => void;
+/**
+ * What the parser recovered from on a page (an unclosed `:::`, an unknown directive), its front
+ * matter that does not parse, or its template error. `line` is 1-based in the page's file, front
+ * matter counted; none when it is not known (a problem only in text an include or a variable put
+ * there, or a template error).
+ */
+export interface PageDiagnostic {
+    code: string;
+    message: string;
+    line?: number;
+    /** The directive's name, without colons, on `unknown-container` and `unknown-inline`. */
+    name?: string;
+}
+/**
+ * The parser's diagnostics on `parsed` (the body after templating) with lines in the file: `line`,
+ * and the lines its message names ("opened on line 3"). Untemplated, the body's lines are the file's
+ * after the front matter. Templated, lines can move: a diagnostic the body as written also has takes
+ * that one's lines; one only the templated text has has no `line`, and its message says the lines
+ * it names are the templated page's. Messages are detached (a session keeps them; some quote a line).
+ */
+export declare function linedDiagnostics(found: ParseDiagnostic[], raw: string, body: string, parsed: string): PageDiagnostic[];
 /** A file's text, read now if it is lazy. */
 export declare function readText(c: FileContent): Promise<string>;
+/**
+ * Whether a file that is not a page is copied to the site: nothing under a dot folder and no dot
+ * file (`.env`, `.github/`), except under a `.gitbook/` folder, at any depth, where GitBook keeps a
+ * space's images (`.gitbook/assets/`). @dogsbay/detect and the playground's import make the same
+ * folder exception (detect also keeps dot files, such as `.gitbook.yaml`, which it reads).
+ */
+export declare const copiedPath: (p: string) => boolean;
+/**
+ * Whether a file `copiedPath` lets through is copied: an untrusted build takes only passive files
+ * and no host configuration ("untrusted"), a sanitizing one no HTML, XML or script ("active").
+ * The dev session's changed assets go through it too.
+ */
+export declare function assetVerdict(p: string, c: FileContent, untrusted: boolean, sanitizing: boolean): Promise<"copy" | "untrusted" | "active">;
 type Emit = (path: string, content: FileContent | TextStream) => Promise<void>;
 /** A built unit, kept by a dev session to render its pages again. */
 export interface UnitHandle {
@@ -230,9 +300,12 @@ export interface BuildContext {
     highlighter: Highlighter;
     emit: Emit;
     warnings: string[];
+    problems: BuildProblem[];
+    report: Report;
     phase: Record<string, number>;
     theme: LoadedTheme;
     state: SiteState;
+    diagnostics?: BuildHooks["diagnostics"];
 }
 /** Internal: a dev session's view of a build (see src/core/dev.ts). */
 export interface BuildHooks {
@@ -241,6 +314,11 @@ export interface BuildHooks {
     /** Render no content pages (they are rendered on request); implies keep. */
     lazy?: boolean;
     context?: (ctx: BuildContext) => void;
+    /**
+     * Parse each page with the parser's diagnostics, and hand them over as it renders: its project
+     * path, and the list (empty when it has none, so a fixed page clears).
+     */
+    diagnostics?: (file: string, list: PageDiagnostic[]) => void;
     unitBuilt?: (unit: BuildUnit, handle: UnitHandle, classes: Set<string>) => void;
 }
 /** Build one unit again without rendering its pages (they are rendered on request). */

package/dist/package/types/core/dev.d.ts

@@ -21,18 +21,33 @@
  * Node-free: the dev server (src/node/dev.ts) owns the file map and the
  * watcher, and updates `input.files` before calling `change`.
  */
-import { type BuildInput, type OutputContent } from "./build.js";
+import { type BuildProblem, type PageDiagnostic, type BuildInput, type OutputContent } from "./build.js";
 import { type SiteConfig } from "./config.js";
 export interface DevSession {
     config: SiteConfig;
     /** A built file by its path in the site (`guide/install.html`), rendering it first when stale. */
     get(path: string): Promise<OutputContent | undefined>;
-    /** Paths (relative to the project) that changed, were added or were removed; `input.files` is already updated. */
+    /**
+     * Paths (relative to the project) that changed, were added or were removed; `input.files` is
+     * already updated. It does not throw: a change that fails sets `buildError` (and `buildProblem`)
+     * and resolves `{ css: false }`, and the last good site stays served.
+     */
     change(paths: string[]): Promise<{
         css: boolean;
     }>;
     /** Warnings not handed out yet (the start's, then those of each change and page render). */
     takeWarnings(): string[];
+    /**
+     * The same warnings as data, not handed out yet (its own count: taking one kind leaves the other):
+     * the file each is about as a project path, with its line when known, and a code.
+     */
+    takeProblems(): BuildProblem[];
+    /**
+     * A page's diagnostics, by its source file (a project path): what the parser recovered from, its
+     * front matter that does not parse, its template error, with lines in the file. A page not
+     * rendered since its last change is rendered first. Empty for a file that is no page.
+     */
+    diagnostics(source: string): Promise<PageDiagnostic[]>;
     /** The site path of the page built from a source file (relative to the project), if it is one. */
     pageFor(source: string): string | undefined;
     /** The source file (relative to the project) of a page, by its site path. */
@@ -44,6 +59,8 @@ export interface DevSession {
      * whatever it is, so an edit elsewhere cannot hide the error.
      */
     readonly buildError: string | undefined;
+    /** `buildError` as data: a config that does not parse names the config file, with its line and column. */
+    readonly buildProblem: BuildProblem | undefined;
 }
 /**
  * By default every page is rendered at the start, as `build` does: search has its index and

package/dist/package/types/core/diagrams.d.ts

@@ -20,6 +20,8 @@ export interface DiagramRenderer {
     maxBatch?: number;
 }
 /** The renderers a host has, by engine (`content.diagrams` picks one). */
+/** A diagram warning: the message, and the page it is on (its path in the unit), when it is one page's. */
+export type DiagramWarn = (message: string, file?: string) => void;
 export type DiagramRenderers = Partial<Record<DiagramEngine, DiagramRenderer>>;
 /**
  * The renderer a build uses: the configured engine's, else the other one the
@@ -81,9 +83,9 @@ export declare class DiagramStore {
      * Pin the diagrams of pages that are built (`live`), and render those not
      * rendered yet (for an earlier unit, say) in one call.
      */
-    flush(warn: (m: string) => void, live: (file: string) => boolean): Promise<void>;
+    flush(warn: DiagramWarn, live: (file: string) => boolean): Promise<void>;
     /** Before a page renders: keep its diagrams, and render those not in the store, in one call. */
-    ensure(codes: string[], file: string, warn: (m: string) => void): Promise<void>;
+    ensure(codes: string[], file: string, warn: DiagramWarn): Promise<void>;
     get(code: string): string | undefined;
     private pin;
     private put;

package/dist/package/types/package/browser.d.ts

@@ -19,7 +19,7 @@ export declare function openDevSession(input: BuildInput & {
     configText?: string;
 }, o?: DevOptions): Promise<DevSession>;
 export { prebuiltSiteCss };
-export type { BuildInput, BuildResult, FileContent, OutputContent, SinkContent, SiteCssBuilder, BuiltPage, HighlightPool } from "../core/build.js";
+export type { BuildInput, BuildResult, FileContent, OutputContent, SinkContent, SiteCssBuilder, BuiltPage, HighlightPool, BuildProblem, PageDiagnostic } from "../core/build.js";
 export type { DevOptions, DevSession } from "../core/dev.js";
 export { parseConfig, ConfigError, type SiteConfig, type DiagramEngine } from "../core/config.js";
 export type { DiagramRenderer, DiagramRenderers, DiagramRequest, DiagramResult } from "../core/diagrams.js";