@dogsbay/format-astro 0.2.0-beta.121 → 0.2.0-beta.123

package/dist/api-markdown.d.ts

@@ -5,4 +5,3 @@ export declare function apiInlineHtml(text: string): string;
 /** A schema property list with every `description` rendered inline,
  *  through nested `properties` / `items`. A copy; the node is untouched. */
 export declare function apiPropertiesHtml(list: unknown): unknown;
-//# sourceMappingURL=api-markdown.d.ts.map

package/dist/api-markdown.js

@@ -47,4 +47,3 @@ export function apiPropertiesHtml(list) {
         return o;
     });
 }
-//# sourceMappingURL=api-markdown.js.map

package/dist/base-path.d.ts

@@ -188,4 +188,3 @@ export declare function resolvePrefixes(siteUrl: string | undefined, basePath: s
  * its nav entry (`/base`), so prev/next silently falls back to the first item.
  */
 export declare function buildCurrentPath(basePath: string, section: string | undefined, slug: string): string;
-//# sourceMappingURL=base-path.d.ts.map

package/dist/base-path.js

@@ -246,4 +246,3 @@ export function buildCurrentPath(basePath, section, slug) {
         parts.push(slug);
     return parts.length === 0 ? "/" : `/${parts.join("/")}`;
 }
-//# sourceMappingURL=base-path.js.map

package/dist/blog.d.ts

@@ -131,4 +131,3 @@ export declare function emitBlogFiles(outputDir: string, data: BlogData, config:
     skipped: string[];
     pruned: string[];
 };
-//# sourceMappingURL=blog.d.ts.map

package/dist/blog.js

@@ -321,4 +321,3 @@ const title = pageNo === 1 ? siteConfig.siteName : \`\${siteConfig.siteName} —
 </DocsLayout>
 `;
 }
-//# sourceMappingURL=blog.js.map

package/dist/browser.d.ts

@@ -11,4 +11,3 @@ export * from "./llms-txt.js";
 export * from "./sitemap.js";
 export * from "./redirects.js";
 export * from "./base-path.js";
-//# sourceMappingURL=browser.d.ts.map

package/dist/browser.js

@@ -11,4 +11,3 @@ export * from "./llms-txt.js";
 export * from "./sitemap.js";
 export * from "./redirects.js";
 export * from "./base-path.js";
-//# sourceMappingURL=browser.js.map

package/dist/canonical.d.ts

@@ -31,4 +31,3 @@ export interface PageCanonical {
 }
 /** Per page slug: its canonical, noindex and sitemap decision. */
 export declare function canonicalPlan(pages: ExportPage[], o: CanonicalPlanOptions): Map<string, PageCanonical>;
-//# sourceMappingURL=canonical.d.ts.map

package/dist/canonical.js

@@ -104,4 +104,3 @@ export function canonicalPlan(pages, o) {
     }
     return plan;
 }
-//# sourceMappingURL=canonical.js.map

package/dist/capabilities.d.ts

@@ -0,0 +1,28 @@
+/**
+ * What the Astro exporter can and cannot represent.
+ *
+ * This is a CONTRACT, not commentary (the format-docusaurus pattern):
+ * `validateCapabilities` rejects any non-full entry without a note, a test
+ * asserts every `MATRIX_ROWS` type has exactly one declaration here, and the
+ * published component × format matrix (docs/component-format-matrix.md) is
+ * generated from it.
+ *
+ * Declared for the page output `site build` / `convert --to astro` emits:
+ * `treeToAstro` in TEMPLATE mode (src/serialize.ts), where TreeNodes become
+ * real `@dogsbay/ui` components. The hybrid `set:html` mode is not what a
+ * site build ships and is not described here.
+ *
+ * Measured by running `treeToAstro` on parsed dogsbay-md and hand-built
+ * nodes (2026-10-13), not inferred from the case list: several rows have a
+ * case and still lose content. format-astro has NO export ledger — the
+ * inline walker's `report` is never wired (serialize-core inline.ts defaults
+ * it to a no-op) — so every `partial` below is a loss nothing records at
+ * export time. The note is the only place it is stated.
+ *
+ * Support levels:
+ *   full    — renders faithfully as the matching component / element
+ *   partial — survives with reduced fidelity; the note says what is lost
+ *   none    — dropped or flattened
+ */
+import type { CapabilityDeclaration } from "@dogsbay/serialize-core";
+export declare const ASTRO_CAPABILITIES: CapabilityDeclaration[];

package/dist/capabilities.js

@@ -0,0 +1,105 @@
+export const ASTRO_CAPABILITIES = [
+    // ── Blocks ───────────────────────────────────────────────
+    { feature: "heading", support: "full", rendersAs: "`<hN id>` with a hover anchor" },
+    { feature: "paragraph", support: "full", rendersAs: "`<p>`; a lone image becomes `<BlockImage>`" },
+    { feature: "blockquote", support: "full", rendersAs: "styled `<blockquote>`" },
+    { feature: "unordered-list", support: "full", rendersAs: "`<ul>`" },
+    { feature: "ordered-list", support: "full", rendersAs: "`<ol start>`" },
+    { feature: "hr", support: "full", rendersAs: "`<hr>`" },
+    { feature: "table", support: "full", rendersAs: "`<Table>` (block content in cells; caption prop or slot)" },
+    {
+        feature: "code",
+        support: "partial",
+        rendersAs: "`<CodeBlock>`, or `<CodeRich>` with line numbers / highlights / diff / `[!code]` notation",
+        note: "Title, language, highlights, line numbers, diff marks and copyText survive. The `collapse` fence option is consumed and not emitted: the block renders expanded, unrecorded.",
+    },
+    { feature: "math-block", support: "full", rendersAs: "`<MathKatex display>` (KaTeX at build time)" },
+    { feature: "deflist", support: "full", rendersAs: "`<dl><dt><dd>`" },
+    { feature: "figure", support: "full", rendersAs: "`<figure>` + `<figcaption>`; a captioned code block puts the caption in its header" },
+    { feature: "footnote-list", support: "full", rendersAs: "GitHub-style footnotes `<section>` with backrefs" },
+    { feature: "html", support: "full", rendersAs: "raw HTML via `set:html`; a marked callout div becomes `<Alert>`" },
+    {
+        feature: "html-container",
+        support: "partial",
+        rendersAs: "its HTML as authored, or a bare `<div>` around its children (card-grid / mdx-columns classes are recognised)",
+        note: "A children-only container from an importer loses its source tag and attributes (class, id, style); the content is kept.",
+    },
+    { feature: "diagram", support: "full", rendersAs: "`<Diagram>` (source + pre-rendered SVG)" },
+    { feature: "youtube", support: "full", rendersAs: "`<YouTube>`" },
+    // ── Components ───────────────────────────────────────────
+    { feature: "callout", support: "full", rendersAs: "`<Alert variant>` with the authored type kept as `data-type`" },
+    { feature: "details", support: "full", rendersAs: "`<CollapsibleAlert variant title open icon>` (`title`, or its alias `summary`)" },
+    { feature: "details-sheet", support: "full", rendersAs: "`<DetailsSheet>` around the CollapsibleAlert: `<db-details-sheet>` opens it as a right-hand native `<dialog>`; without the script it stays a collapsible block" },
+    { feature: "theme", support: "full", rendersAs: "a `<div class=\"dark …\" data-theme>`: the theme re-declares its tokens on `.dark`, so the subtree turns dark" },
+    { feature: "tabs-variant", support: "full", rendersAs: "TabsList/TabsTrigger given the variant's classes (TAB_VARIANTS), merged over their base" },
+    { feature: "tone", support: "full", rendersAs: "each card's border and tint from the tone (CARD_TONE_CLASSES); a group tone applies to every card without one" },
+    { feature: "tabs", support: "full", rendersAs: "`<Tabs>` / `<TabsTrigger>` / `<TabsContent>` (`<db-tabs>`), sync keys kept" },
+    {
+        feature: "steps",
+        support: "partial",
+        rendersAs: "`<Steps>` / `<Step>` / `<SubSteps>`",
+        note: "A step's body renders; a `title` PROP on a step is not emitted (titles carried in the step's own content, as dogsbay-md writes them, survive).",
+    },
+    {
+        feature: "accordion",
+        support: "full",
+        rendersAs: "`<Accordion type defaultValue>` / `<AccordionItem>`; a child that is not an item stays in reading order around the group",
+    },
+    {
+        feature: "cards",
+        support: "partial",
+        rendersAs: "`<Grid>` of `<Card>`",
+        note: "The grid is always `cols={[1, 2]}`: a `cols` prop is ignored. When the group has `card` children, any non-card child is dropped; in the MkDocs list form, non-list children are dropped and a list item whose content is inline (a tight list) renders an EMPTY card.",
+    },
+    {
+        feature: "card",
+        support: "partial",
+        rendersAs: "`<Card>` with title, description, body and optional link",
+        note: "Outside a card group, an icon that is an image PATH is passed to `<Icon name>`, which renders nothing for it — the logo disappears (inside a group it becomes an `<img>`).",
+    },
+    { feature: "link-card", support: "full", rendersAs: "`<LinkCard>`; with body content, a linked `<Card>`" },
+    { feature: "files", support: "full", rendersAs: "`<FileTree items>`, folders from nesting or a trailing `/`" },
+    { feature: "grid", support: "full", rendersAs: "`<Grid cols gap rows>` / `<GridItem>`" },
+    { feature: "link-button", support: "full", rendersAs: "`<Button href variant>`" },
+    { feature: "related", support: "full", rendersAs: "`<section class=\"related-resources\">` with a caption title" },
+    { feature: "example", support: "full", rendersAs: "`<MarkdownExample source>` (source + live render)" },
+    {
+        feature: "container",
+        support: "partial",
+        rendersAs: "`<div data-directive=\"name\">` with the title as a bold paragraph",
+        note: "An unknown directive has no component: its content and title survive in a marked div with no styling or behaviour.",
+    },
+    {
+        feature: "annotation-list",
+        support: "partial",
+        rendersAs: "a tinted box after the code block",
+        note: "The annotations render as a list beside the code, not as markers/tooltips attached to their lines.",
+    },
+    // ── API reference ────────────────────────────────────────
+    { feature: "endpoint", support: "full", rendersAs: "`<ApiLayout>` + `<EndpointCard>` + `<CodeSamples>` / `<ExampleBlock>`" },
+    { feature: "api-doc", support: "full", rendersAs: "`<ApiDoc html>`" },
+    { feature: "api-class", support: "full", rendersAs: "`<ApiSymbol kind level>`" },
+    { feature: "api-member", support: "full", rendersAs: "`<ApiSymbol kind level>`" },
+    { feature: "api-params", support: "full", rendersAs: "`<ApiParams>`" },
+    { feature: "api-source", support: "full", rendersAs: "`<ApiSource file line>`" },
+    // ── Inline ───────────────────────────────────────────────
+    {
+        feature: "link",
+        support: "full",
+        rendersAs: "`<a>`; an inline `:button` becomes `<Button size=\"sm\">`",
+        note: "A link whose scheme could run script keeps its text and loses the href — by design, but unrecorded (no ledger).",
+    },
+    { feature: "image", support: "full", rendersAs: "`<img loading=\"lazy\">`; alone in a paragraph, `<BlockImage>`" },
+    { feature: "kbd", support: "full", rendersAs: "`<Kbd>` per key, joined by `+`" },
+    {
+        feature: "math",
+        support: "partial",
+        rendersAs: "`<code class=\"math-inline\">` holding the LaTeX source",
+        note: "Inline math is NOT typeset (display math is, via MathKatex): the reader sees raw LaTeX in a code span.",
+    },
+    { feature: "highlight", support: "full", rendersAs: "styled `<mark>`" },
+    { feature: "badge", support: "full", rendersAs: "`<Badge variant>`" },
+    { feature: "icon", support: "full", rendersAs: "`<Icon name=\"pack:name\">`" },
+    { feature: "footnote-ref", support: "full", rendersAs: "`<sup><a href=\"#fn-…\">`" },
+    { feature: "html-inline", support: "full", rendersAs: "raw HTML via `<Fragment set:html>`" },
+];

package/dist/cli.d.ts

@@ -19,4 +19,3 @@ import type { FormatPlugin } from "@dogsbay/types";
  * applied by `dogsbay site build`.
  */
 export declare const plugin: FormatPlugin;
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -1,4 +1,5 @@
 import { emitAstroPages } from "./project.js";
+import { ASTRO_CAPABILITIES } from "./capabilities.js";
 /**
  * `dogsbay convert --to astro` plugin.
  *
@@ -22,6 +23,7 @@ export const plugin = {
     name: "astro",
     canImport: false,
     canExport: true,
+    capabilities: ASTRO_CAPABILITIES,
     detectSource: () => false,
     exportOptions: [
         { flags: "--local", description: "Use file: references to local monorepo packages (for development)" },
@@ -51,4 +53,3 @@ export const plugin = {
         });
     },
 };
-//# sourceMappingURL=cli.js.map

package/dist/diff-decoration.d.ts

@@ -76,4 +76,3 @@ export declare function decorateDiff(node: TreeNode, rendered: string, renderPee
  * both color modes, no hardcoded palette (key-decisions doctrine).
  */
 export declare const DIFF_CSS = "/* tree-diff decorations \u2014 one DiffTree, rendered by the normal components.\n   Mark styling is GUARDED by html:not([data-diff-hidden]) rather than\n   force-reset under hidden mode: a reset like \"border-left: none\n   !important\" also clobbers a component's OWN border (an added warning\n   callout lost its left edge \u2014 user find, adapters/mysql). Guarded\n   rules simply stop applying, and component styling survives. */\n[data-diff] { position: relative; }\nhtml:not([data-diff-hidden]) [data-diff=\"added\"] {\n  background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 12%, transparent);\n  border-left: 3px solid var(--color-success, oklch(0.72 0.19 150));\n  padding-left: 0.75rem;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"] {\n  background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 10%, transparent);\n  border-left: 3px solid var(--color-destructive, oklch(0.64 0.21 25));\n  padding-left: 0.75rem;\n  opacity: 0.75;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"] :is(p, li, code, pre) { text-decoration: line-through; text-decoration-thickness: 1px; }\nhtml:not([data-diff-hidden]) [data-diff=\"changed\"] {\n  border-left: 3px solid var(--color-warning, oklch(0.8 0.16 85));\n  padding-left: 0.75rem;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"moved\"] {\n  border-left: 3px dashed var(--color-info, oklch(0.7 0.14 240));\n  padding-left: 0.75rem;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"moved\"][data-diff-from]::after {\n  content: \"moved from \" attr(data-diff-from);\n  display: block;\n  font-size: 0.75rem;\n  color: var(--color-muted-foreground, inherit);\n  opacity: 0.8;\n}\n\n/* Explicit \"added\"/\"removed\" label pills straddling the block's top\n   edge. Components with their own chrome (callouts, code blocks)\n   camouflage a tint-only mark \u2014 a green-tinted warning callout reads\n   as a callout variant, not as new content (user feedback,\n   better-auth adapters/mysql). Table rows are excluded (a pill can't\n   straddle a tr); nested marks defer to the outermost label. */\nhtml:not([data-diff-hidden]) [data-diff=\"added\"]:not(tr, th, td)::before,\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"]:not(tr, th, td)::before {\n  position: absolute;\n  top: 0;\n  right: 0.6rem;\n  transform: translateY(-55%);\n  font-size: 0.65rem;\n  font-weight: 600;\n  letter-spacing: 0.04em;\n  line-height: 1.4;\n  padding: 0 0.5rem;\n  border-radius: 99px;\n  z-index: 1;\n  text-decoration: none;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"added\"]:not(tr, th, td)::before {\n  content: \"added\";\n  background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 25%, var(--color-background, Canvas));\n  border: 1px solid color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 45%, transparent);\n}\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"]:not(tr, th, td)::before {\n  content: \"removed\";\n  background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 20%, var(--color-background, Canvas));\n  border: 1px solid color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 45%, transparent);\n}\n[data-diff] [data-diff]::before { content: none !important; }\n\n/* Nav change markers (the sidebar is client-rendered from nav.json, so\n   the styles ship here rather than with the component). Same contract as\n   the tab markers: a GLYPH carries the meaning, colour reinforces it,\n   visually-hidden text announces it. */\n.db-nav-mark {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  flex-shrink: 0;\n  width: 1rem;\n  height: 1rem;\n  margin-left: auto;\n  border-radius: 99px;\n  font-size: 0.75rem;\n  font-weight: 700;\n  line-height: 1;\n  color: var(--color-muted-foreground, currentColor);\n}\n.db-nav-mark[data-nav-mark=\"added\"] { color: var(--color-success, oklch(0.72 0.19 150)); }\n.db-nav-mark[data-nav-mark=\"changed\"] { color: var(--color-warning, oklch(0.8 0.16 85)); }\n.db-nav-mark[data-nav-mark=\"removed\"] { color: var(--color-destructive, oklch(0.64 0.21 25)); }\n.db-nav-mark[data-nav-mark=\"moved\"] { color: var(--color-info, oklch(0.7 0.14 240)); }\n/* a subtree marker is a hint about descendants, not a claim about this row */\n.db-nav-mark[data-nav-mark-subtree] { opacity: 0.55; }\n/* removed pages get a SECOND non-colour signal */\n/* Belt-and-braces: a subtree mark must never strike through its own row. */\n[data-nav-mark-row=\"removed\"]:not([data-nav-mark-subtree]) { text-decoration: line-through; opacity: 0.7; }\n@media (forced-colors: active) {\n  .db-nav-mark { color: CanvasText; }\n}\n\n/* Which tab changed? A marked panel is invisible until opened, so its\n   trigger carries a marker (the group's bar says \"in here\", the marker\n   says \"this one\"). The marker is a GLYPH, not a colored dot: colour\n   alone fails WCAG 1.4.1 and background-tinted dots vanish entirely in\n   forced-colors mode. Colour reinforces; shape carries the meaning.\n   Visually-hidden text rides along (emitted by the serializer). */\n.db-tab-mark {\n  display: inline-block;\n  margin-left: 0.35rem;\n  font-size: 0.75rem;\n  font-weight: 700;\n  line-height: 1;\n  vertical-align: middle;\n  color: var(--color-muted-foreground, currentColor);\n}\n[data-diff-hidden] .db-tab-mark { display: none; }\n.db-tab-mark[data-diff-tab=\"changed\"] { color: var(--color-warning, oklch(0.8 0.16 85)); }\n.db-tab-mark[data-diff-tab=\"added\"] { color: var(--color-success, oklch(0.72 0.19 150)); }\n.db-tab-mark[data-diff-tab=\"removed\"] { color: var(--color-destructive, oklch(0.64 0.21 25)); }\n.db-tab-mark[data-diff-tab=\"moved\"] { color: var(--color-info, oklch(0.7 0.14 240)); }\n@media (forced-colors: active) {\n  .db-tab-mark { color: CanvasText; }\n}\nins.db-diff-ins {\n  text-decoration: none;\n  background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 22%, transparent);\n  border-radius: 2px;\n  padding: 0 1px;\n}\ndel.db-diff-del {\n  background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 18%, transparent);\n  border-radius: 2px;\n  padding: 0 1px;\n}\n.db-diff-pair { display: grid; gap: 0.25rem; margin-block: 1rem; }\n.db-diff-pair-label {\n  font-size: 0.7rem;\n  text-transform: uppercase;\n  letter-spacing: 0.08em;\n  color: var(--color-muted-foreground, inherit);\n  opacity: 0.8;\n}\ntr[data-diff] { border-left-width: 3px; }\n\n/* Folded unchanged sections are CHROME, not content callouts:\n   dashed, dimmed, compact \u2014 visually \"collapsed context\". */\n.db-diff-fold {\n  border: 1px dashed color-mix(in oklch, currentColor 25%, transparent) !important;\n  border-left-width: 1px !important;\n  background: transparent !important;\n  opacity: 0.7;\n  margin-block: 0.5rem !important;\n}\n.db-diff-fold:hover, .db-diff-fold[open] { opacity: 1; }\n.db-diff-fold summary, .db-diff-fold [data-slot=\"trigger\"] {\n  font-size: 0.85rem;\n}\n\n/* The comparison banner at the top of each reader page. */\n.db-diff-banner-row { display: flex; flex-wrap: wrap; gap: 0.4rem 0.8rem; align-items: center; width: 100%; }\n.db-diff-banner {\n  border: 1px solid color-mix(in oklch, currentColor 15%, transparent);\n  border-radius: 8px;\n  padding: 0.75rem 1rem;\n  margin-block-end: 1.5rem;\n  font-size: 0.85rem;\n  display: flex;\n  flex-wrap: wrap;\n  gap: 0.4rem 1rem;\n  align-items: center;\n}\n.db-diff-banner .db-chip {\n  display: inline-block;\n  border-radius: 99px;\n  padding: 0.05rem 0.6rem;\n  font-size: 0.75rem;\n  border: 1px solid transparent;\n}\n.db-chip-added { background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 15%, transparent); }\n.db-chip-removed { background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 12%, transparent); }\n.db-chip-changed { background: color-mix(in oklch, var(--color-warning, oklch(0.8 0.16 85)) 15%, transparent); }\n.db-chip-moved { background: color-mix(in oklch, var(--color-info, oklch(0.7 0.14 240)) 12%, transparent); }\n.db-chip-muted { border-color: color-mix(in oklch, currentColor 25%, transparent); opacity: 0.8; }\n\n/* The persistent view-switcher bar (Reader / Docs-ops / Agent):\n   perspectives on ONE comparison \u2014 tabs are links, verification\n   lives in the chrome, the Monitor CTA sits next to the value. */\n.db-cmp-bar {\n  position: sticky;\n  /* BELOW the docs header, not under it: both were sticky at top:0 and\n     the header's higher z-index simply swallowed this bar on scroll \u2014\n     the chrome carrying the trust contract was the chrome that vanished.\n     --db-header-height is declared by DocsLayout (the header sizes itself\n     from the same variable, so they cannot drift). */\n  top: var(--db-header-height, 3.25rem);\n  z-index: 30;\n  display: flex;\n  flex-wrap: wrap;\n  gap: 0.4rem 0.9rem;\n  align-items: center;\n  padding: 0.5rem 0.9rem;\n  margin-block-end: 1rem;\n  border: 1px solid color-mix(in oklch, currentColor 15%, transparent);\n  border-radius: 8px;\n  background: var(--color-background, Canvas);\n  font-size: 0.8rem;\n}\n.db-cmp-bar .db-chip {\n  display: inline-block;\n  border-radius: 99px;\n  padding: 0.05rem 0.6rem;\n  font-size: 0.75rem;\n  border: 1px solid transparent;\n}\n.db-cmp-bar button.db-chip { cursor: pointer; background: transparent; font: inherit; font-size: 0.75rem; color: inherit; }\n.db-cmp-tabs {\n  display: inline-flex;\n  gap: 0.15rem;\n  border: 1px solid color-mix(in oklch, currentColor 20%, transparent);\n  border-radius: 99px;\n  padding: 0.1rem;\n}\n.db-cmp-tab {\n  padding: 0.1rem 0.7rem;\n  border-radius: 99px;\n  text-decoration: none;\n  color: inherit;\n}\n.db-cmp-tab[aria-current=\"page\"] {\n  background: color-mix(in oklch, currentColor 12%, transparent);\n  font-weight: 600;\n}\n.db-cmp-pairs { position: relative; display: inline-block; }\n.db-cmp-pairs summary { cursor: pointer; }\n.db-cmp-pairs ul {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  margin: 0.25rem 0 0;\n  padding: 0.35rem 0.75rem;\n  list-style: none;\n  background: var(--color-background, Canvas);\n  border: 1px solid color-mix(in oklch, currentColor 20%, transparent);\n  border-radius: 8px;\n  white-space: nowrap;\n  z-index: 40;\n}\n.db-cmp-monitor { text-decoration: none; border-color: color-mix(in oklch, currentColor 30%, transparent) !important; }\n.db-cmp-monitor:hover { background: color-mix(in oklch, currentColor 10%, transparent); }\n\n/* A wholly added/removed PAGE carries one mark around all its content.\n   The per-block tint would be overwhelming at page scale, so page level\n   gets a stronger edge and a much lighter wash \u2014 legible at a glance,\n   still readable as prose. The \"added\"/\"removed\" pill (the ::before on\n   [data-diff]) rides on this wrapper, which is exactly right: it labels\n   the page, once. */\nhtml:not([data-diff-hidden]) [data-diff].db-diff-page {\n  border-left-width: 5px;\n  padding-left: 1rem;\n  padding-block: 0.5rem;\n  border-radius: 0 6px 6px 0;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"added\"].db-diff-page {\n  background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 5%, transparent);\n}\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"].db-diff-page {\n  background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 5%, transparent);\n  opacity: 1; /* the page is READABLE \u2014 the mark says removed, not the dimming */\n}\n/* \u2026and a removed PAGE is not struck through \u2014 that is for a deleted line,\n   not for a document the reader still needs to read. */\n[data-diff=\"removed\"].db-diff-page :is(p, li, code, pre) { text-decoration: none; }\n\n/* Changed raw HTML: the faithful new render, plus the previous version\n   one click away. Without it a deletion inside opaque markup (a dropped\n   table column) is simply invisible \u2014 the reader is told \"something\n   changed\" and shown no evidence. */\n.db-diff-html-before {\n  margin-block-start: 0.5rem;\n  font-size: 0.8rem;\n  border: 1px dashed color-mix(in oklch, currentColor 25%, transparent);\n  border-radius: 6px;\n  padding: 0.25rem 0.6rem;\n}\n/* Full-strength text: the summary is a CONTROL \u2014 dimming it (opacity or\n   muted-foreground) drops it below 4.5:1 and axe rightly fails it. */\n.db-diff-html-before summary { cursor: pointer; color: inherit; }\n.db-diff-html-before[open] summary { margin-block-end: 0.5rem; }\n[data-diff-hidden] .db-diff-html-before { display: none; }\n\n/* Merged code diffs carry a hidden clean twin (the post-change\n   render); Hide highlights swaps them. */\n.db-diff-code { position: relative; }\n.db-diff-code-clean { display: none; }\n[data-diff-hidden] .db-diff-code-clean { display: block; }\n[data-diff-hidden] .db-diff-code-merged { display: none; }\n\n/* Whitespace-only code edits are still marked (indentation is\n   semantic in YAML/Python/markdown) \u2014 but NAMED, so the reader\n   is not hunting an invisible 3-space shift. */\nhtml:not([data-diff-hidden]) .db-diff-code-ws .db-diff-code-merged::before {\n  content: \"whitespace only\";\n  position: absolute;\n  top: 0;\n  right: 0.6rem;\n  transform: translateY(-55%);\n  z-index: 1;\n  font-size: 0.65rem;\n  font-weight: 600;\n  letter-spacing: 0.04em;\n  line-height: 1.4;\n  padding: 0 0.5rem;\n  border-radius: 99px;\n  background: color-mix(in oklch, var(--color-warning, oklch(0.8 0.16 85)) 22%, var(--color-background, Canvas));\n  border: 1px solid color-mix(in oklch, var(--color-warning, oklch(0.8 0.16 85)) 45%, transparent);\n}\n\n/* Hide highlights \u2014 read the target version clean. One attribute on\n   <html>: the guarded mark rules above stop applying by themselves;\n   only content that does not exist in the target version (removed\n   blocks, del runs, the \"before\" code side) needs hiding, plus the\n   ins tint. */\n[data-diff-hidden] :is([data-diff=\"removed\"], del.db-diff-del, .db-diff-pair-label) { display: none !important; }\n[data-diff-hidden] ins.db-diff-ins { background: transparent; padding: 0; }\n";
-//# sourceMappingURL=diff-decoration.d.ts.map

package/dist/diff-decoration.js

@@ -538,4 +538,3 @@ html:not([data-diff-hidden]) .db-diff-code-ws .db-diff-code-merged::before {
 [data-diff-hidden] :is([data-diff="removed"], del.db-diff-del, .db-diff-pair-label) { display: none !important; }
 [data-diff-hidden] ins.db-diff-ins { background: transparent; padding: 0; }
 `;
-//# sourceMappingURL=diff-decoration.js.map

package/dist/granularity.d.ts

@@ -80,4 +80,3 @@ export declare function bookSlugFrom(slugs: string[], fallback: string): string;
 /** Strip the route prefix + leading slash + anchor/query from a nav href → slug. */
 export declare function slugFromHref(href: string | undefined, hrefPrefix: string): string;
 export declare function slugify(text: string): string;
-//# sourceMappingURL=granularity.d.ts.map

package/dist/granularity.js

@@ -244,4 +244,3 @@ export function slugify(text) {
         .replace(/^-+|-+$/g, "")
         .trim() || "section");
 }
-//# sourceMappingURL=granularity.js.map

package/dist/head-metadata.d.ts

@@ -23,4 +23,3 @@ export interface HeadMetadataOptions {
     indexable?: (p: ExportPage) => boolean;
 }
 export declare function headMetadata(pages: ExportPage[], nav: NavItem[], o: HeadMetadataOptions): Map<string, HeadMetadata>;
-//# sourceMappingURL=head-metadata.d.ts.map

package/dist/head-metadata.js

@@ -53,4 +53,3 @@ export function headMetadata(pages, nav, o) {
     }
     return plan;
 }
-//# sourceMappingURL=head-metadata.js.map

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize.js";
 export { writeFileSync, copyFileSync } from "./write-if-changed.js";
+export { ASTRO_CAPABILITIES } from "./capabilities.js";
 export { detectLeadingNodes, deriveDescription } from "./lead.js";
 export type { LeadingNodeInfo } from "./lead.js";
 export type { AstroGenResult, AstroGenOptions, AstroRenderMode } from "./serialize.js";
@@ -31,4 +32,4 @@ export type { DiffMarks } from "./diff-decoration.js";
 export { BOOK_SEGMENT, assembleBook, bookHeading, bookSlugFrom, estimateTreeBytes, openAsPageNode, rewriteIntraBookLinks, shiftHeadings, slugFromHref, } from "./granularity.js";
 export type { AssembleBookOptions, BookView } from "./granularity.js";
 export { pageUnitPrefix, inPageUnit, normalizeTarget } from "./redirects.js";
-//# sourceMappingURL=index.d.ts.map
+export { TONES, CARD_TONE_CLASSES, TAB_VARIANTS, THEME_SCOPES } from "./tone-classes.js";

package/dist/index.js

@@ -1,6 +1,8 @@
 // Astro serializer (TreeNode[] → Astro component markup)
 export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize.js";
 export { writeFileSync, copyFileSync } from "./write-if-changed.js";
+// Component × format matrix: what the page output represents, per TreeNode type.
+export { ASTRO_CAPABILITIES } from "./capabilities.js";
 // Auto-lede detection — figures out whether a page tree already
 // has a leading H1 / paragraph so format-astro can decide whether
 // to inject frontmatter title + description at the top of <main>.
@@ -58,4 +60,5 @@ export { DIFF_CSS, decorateDiff, diffMarksOf, hasDiffMarks, injectAttrs, inlineS
  */
 export { BOOK_SEGMENT, assembleBook, bookHeading, bookSlugFrom, estimateTreeBytes, openAsPageNode, rewriteIntraBookLinks, shiftHeadings, slugFromHref, } from "./granularity.js";
 export { pageUnitPrefix, inPageUnit, normalizeTarget } from "./redirects.js";
-//# sourceMappingURL=index.js.map
+// Variants, tones and scoped themes: the class tables both renderers draw from
+export { TONES, CARD_TONE_CLASSES, TAB_VARIANTS, THEME_SCOPES } from "./tone-classes.js";

package/dist/lead.d.ts

@@ -1,2 +1 @@
 export { detectLeadingNodes, deriveDescription, type LeadingNodeInfo } from "@dogsbay/serialize-core";
-//# sourceMappingURL=lead.d.ts.map

package/dist/lead.js

@@ -1,4 +1,3 @@
 // Moved to @dogsbay/serialize-core (src/lead.ts), so @dogsbay/site-check can use
 // these without depending on format-astro, which brings @dogsbay/ui and astro.
 export { detectLeadingNodes, deriveDescription } from "@dogsbay/serialize-core";
-//# sourceMappingURL=lead.js.map

package/dist/llms-txt.d.ts

@@ -120,4 +120,3 @@ export declare function buildSectionLlmsTxt(siteConfig: Pick<SiteConfig, "siteNa
  * line, then either the full body (default) or just a description.
  */
 export declare function buildLlmsFullTxt(siteConfig: Pick<SiteConfig, "siteName" | "description" | "siteUrl">, nav: NavItem[], pages: ExportPage[], options?: BuildLlmsFullTxtOptions): string;
-//# sourceMappingURL=llms-txt.d.ts.map

package/dist/llms-txt.js

@@ -148,4 +148,3 @@ function getPageDescription(page, limit) {
     const firstPara = extractFirstParagraph(page.tree);
     return firstPara ? truncate(firstPara, limit) : "";
 }
-//# sourceMappingURL=llms-txt.js.map

package/dist/plugins.d.ts

@@ -37,4 +37,3 @@ export interface EmitPluginRuntimeOptions {
 export declare function emitPluginRuntime(options: EmitPluginRuntimeOptions): void;
 /** Test-only: clear emitted plugin runtime files. */
 export declare function _clearPluginRuntime(outputDir: string): void;
-//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.js

@@ -338,4 +338,3 @@ export function _clearPluginRuntime(outputDir) {
     rmSync(join(outputDir, PLUGIN_CONFIG_DIR_REL), { recursive: true, force: true });
     rmSync(join(outputDir, PLUGIN_STYLES_DIR_REL), { recursive: true, force: true });
 }
-//# sourceMappingURL=plugins.js.map

package/dist/project.d.ts

@@ -682,4 +682,3 @@ export declare function rootVersionOf(options: Pick<AstroProjectOptions, "versio
  * introduced in a release (Kbd, FileTree) reaches sites scaffolded earlier.
  */
 export declare function copyComponents(outputDir: string): string[];
-//# sourceMappingURL=project.d.ts.map

package/dist/project.js

@@ -3336,6 +3336,8 @@ export function copyComponents(outputDir) {
         "icon",
         // Inline :kbd and the :::files tree.
         "kbd", "files",
+        // :::details{sheet} / DITA db-details sheet
+        "details-sheet",
     ];
     const added = [];
     for (const name of needed) {
@@ -3534,4 +3536,3 @@ function resolveComponentsSource() {
         return demo;
     return null;
 }
-//# sourceMappingURL=project.js.map

package/dist/redirects.d.ts

@@ -113,4 +113,3 @@ export declare function renderMetaRefreshPage(rule: RedirectRule, siteUrl?: stri
  * lands at `<mount>/<mount>/old/`.
  */
 export declare function stubPathForRule(rule: RedirectRule, prefix: string): string;
-//# sourceMappingURL=redirects.d.ts.map

package/dist/redirects.js

@@ -221,4 +221,3 @@ export function stubPathForRule(rule, prefix) {
     }
     return p ? `${p}/index.html` : "index.html";
 }
-//# sourceMappingURL=redirects.js.map

package/dist/serialize.d.ts

@@ -41,4 +41,3 @@ export declare function componentAttr(name: string, value: string): string;
 /** Escape text for use directly in an Astro template (not inside an expression). */
 export declare function escapeTemplate(s: string): string;
 export declare function treeToAstro(nodes: TreeNode[], options?: AstroGenOptions): AstroGenResult;
-//# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.js

@@ -1,7 +1,7 @@
-import { walkInline, applyTextFlags, renderLeaf, indent, isSafeHref, apiPageLayout, apiSymbolLevels, } from "@dogsbay/serialize-core";
+import { walkInline, applyTextFlags, renderLeaf, indent, isSafeHref, apiPageLayout, apiSymbolLevels, renderAroundGroup, isDetailsSheet, } from "@dogsbay/serialize-core";
 import { parseInline } from "@dogsbay/format-dogsbay-md";
 import { decorateDiff, hasDiffMarks } from "./diff-decoration.js";
-import { TONE_CLASSES } from "./tone-classes.js";
+import { TONE_CLASSES, CARD_TONE_CLASSES, TAB_VARIANTS, THEME_SCOPES, lookup } from "./tone-classes.js";
 import { apiBlockHtml, apiPropertiesHtml } from "./api-markdown.js";
 export { TONE_CLASSES };
 const COMPONENT_IMPORTS = {
@@ -16,6 +16,9 @@ const COMPONENT_IMPORTS = {
     details: [
         'import CollapsibleAlert from "@ui/alert/CollapsibleAlert.astro";',
     ],
+    "details-sheet": [
+        'import DetailsSheet from "@ui/details-sheet/DetailsSheet.astro";',
+    ],
     code: [
         'import CodeBlock from "@ui/code-block/CodeBlock.astro";',
     ],
@@ -245,8 +248,21 @@ function nodeToAstroBase(node, ctx) {
             return genericContainerToAstro(node, ctx);
         case "details":
             return detailsToAstro(node, ctx);
+        case "theme": {
+            // A scoped theme: `.dark` re-declares the tokens for its subtree, so a
+            // plain wrapper is enough (THEME_SCOPES); an unknown name keeps the content
+            const name = node.props?.name;
+            const scope = lookup(THEME_SCOPES, name);
+            const inner = childrenToAstro(node, ctx);
+            if (!scope)
+                return inner;
+            const passthrough = renderPassthroughAttrs(node.props, ["name", "class", "data-theme"]);
+            // The default (expression) form: an entity-escaped `[&>…]` is not a
+            // class Tailwind's scanner recognises, so the rule was never generated
+            return `<div${mergeClassAttr(scope, node.props?.class)} data-theme="${escapeAttr(name)}"${passthrough}>\n${indentStr(inner, 2)}\n</div>`;
+        }
         case "tabs":
-            return tabsToAstro(node, ctx);
+            return renderAroundGroup(node, "tab", (n) => tabsToAstro(n, ctx), (c) => nodeToAstro(c, ctx), "\n");
         case "ordered-list":
             return wrapBlock("ol", "", node, childrenToAstro(node, ctx), ["start"])
                 .replace(/^<ol(\s[^>]*)?>/, (m) => {
@@ -370,7 +386,7 @@ function nodeToAstroBase(node, ctx) {
         case "link-button":
             return linkButtonToAstro(node, ctx);
         case "accordion":
-            return accordionToAstro(node, ctx);
+            return renderAroundGroup(node, "accordion-item", (n) => accordionToAstro(n, ctx), (c) => nodeToAstro(c, ctx), "\n");
         case "accordion-item":
             // Bare accordion-item outside an :::accordion wrapper. Wrap it in an
             // Accordion shell so the output is still a valid widget.
@@ -414,7 +430,7 @@ ${childrenToAstro(node, ctx)}
             // controls the bg/text combo (see TONE_CLASSES). Authors can also pass
             // their own `class` to override.
             if (label !== undefined) {
-                const toneClasses = TONE_CLASSES[tone] ?? TONE_CLASSES["primary-light"];
+                const toneClasses = lookup(TONE_CLASSES, tone) ?? TONE_CLASSES["primary-light"];
                 return `<GridItem ${attrParts.join(" ")}${classAttr}${passthrough}>
   <div class="flex h-full min-h-16 items-center justify-center rounded-lg font-mono text-sm font-medium ${toneClasses}">${escapeTemplate(label)}</div>
 </GridItem>`;
@@ -1000,7 +1016,8 @@ function detailsToAstro(node, ctx) {
     ctx.imports.add("details");
     // `variant` as documented; `type` as dogsbay-ssg (and callouts) read it.
     const variant = node.props?.variant ?? node.props?.type ?? "note";
-    const title = node.props?.title ?? "Details";
+    // `summary` is dogsbay-md's alias for the title (`:::details{summary="…"}`)
+    const title = node.props?.title ?? node.props?.summary ?? "Details";
     const open = node.props?.open;
     const icon = node.props?.icon;
     const inner = childrenToAstro(node, ctx);
@@ -1011,11 +1028,16 @@ function detailsToAstro(node, ctx) {
         attrs.push(`icon="${escapeAttr(icon)}"`);
     const classAttr = mergeClassAttr("my-4", node.props?.class);
     const passthrough = renderPassthroughAttrs(node.props, [
-        "variant", "type", "title", "open", "icon", "class", "summary",
+        "variant", "type", "title", "open", "icon", "class", "summary", "sheet",
     ]);
-    return `<CollapsibleAlert ${attrs.join(" ")}${classAttr}${passthrough}>
+    const alert = `<CollapsibleAlert ${attrs.join(" ")}${classAttr}${passthrough}>
 ${indentStr(inner, 2)}
 </CollapsibleAlert>`;
+    // `sheet`: the same details, opened as a side sheet by <db-details-sheet>
+    if (!isDetailsSheet(node.props))
+        return alert;
+    ctx.imports.add("details-sheet");
+    return `<DetailsSheet>\n${indentStr(alert, 2)}\n</DetailsSheet>`;
 }
 function tabsToAstro(node, ctx) {
     ctx.imports.add("tabs");
@@ -1052,11 +1074,15 @@ function tabsToAstro(node, ctx) {
         removed: "−",
         moved: "→",
     };
+    // A variant's class strings are complete (TAB_VARIANTS): TabsList and
+    // TabsTrigger merge a `class` over their base with tailwind-variants
+    const variant = lookup(TAB_VARIANTS, node.props?.variant);
+    const triggerClass = variant ? ` class="${escapeAttr(variant.trigger)}"` : "";
     const triggers = tabItems
         .map((t) => {
         const signal = tabDiffSignal(t.node);
         if (!signal) {
-            return `    <TabsTrigger${componentAttr("value", t.value)}>${escapeTemplate(t.label)}</TabsTrigger>`;
+            return `    <TabsTrigger${componentAttr("value", t.value)}${triggerClass}>${escapeTemplate(t.label)}</TabsTrigger>`;
         }
         const glyph = TAB_GLYPH[signal] ?? "•";
         // The glyph and its announced text are ONE element: "Hide
@@ -1072,7 +1098,7 @@ function tabsToAstro(node, ctx) {
         // a title containing `&` was emitted `&amp;` here and `&` there, so the
         // trigger and its panel no longer paired and the tab rendered empty.
         // `data-diff-tab` is a plain data attribute — entity escaping is right.
-        return `    <TabsTrigger${componentAttr("value", t.value)} data-diff-tab="${escapeAttr(signal)}">${escapeTemplate(t.label)}<Fragment set:html={${escapeExpr(marker)}} /></TabsTrigger>`;
+        return `    <TabsTrigger${componentAttr("value", t.value)}${triggerClass} data-diff-tab="${escapeAttr(signal)}">${escapeTemplate(t.label)}<Fragment set:html={${escapeExpr(marker)}} /></TabsTrigger>`;
     })
         .join("\n");
     const contents = tabItems
@@ -1088,7 +1114,7 @@ function tabsToAstro(node, ctx) {
     const syncAttr = syncKey ? componentAttr("syncKey", syncKey) : "";
     // Same encoding as the trigger/content `value` it selects — see above.
     return `<Tabs${componentAttr("defaultValue", defaultValue)}${syncAttr}${classAttr}${passthrough}>
-  <TabsList>
+  <TabsList${variant ? ` class="${escapeAttr(variant.list)}"` : ""}>
 ${triggers}
   </TabsList>
 ${contents}
@@ -1355,7 +1381,7 @@ function cardsToAstro(node, ctx) {
     // Grid-level attributes on the :::cards container
     const outerClass = mergeClassAttr("", node.props?.class);
     const outerPass = renderPassthroughAttrs(node.props, [
-        "cols", "gap", "rows", "class",
+        "cols", "gap", "rows", "class", "tone",
     ]);
     // MDX pattern: children are card nodes with title/href/icon props
     const cardNodes = (node.children ?? []).filter((c) => c.type === "card");
@@ -1389,12 +1415,15 @@ function cardsToAstro(node, ctx) {
             const desc = lead + (inner
                 ? `<${descTag} class="text-sm text-muted-foreground mt-1 [text-decoration:none]">${inner}</${descTag}>`
                 : "");
+            // A tone (TONES; the card's own, else the group's) sets the card's
+            // border and tint: Card's tailwind-variants merge replaces bg-card
+            const toned = lookup(CARD_TONE_CLASSES, card.props?.tone ?? node.props?.tone);
             const cardDefaultClass = href
-                ? "p-4 hover:border-foreground/20 transition-colors"
-                : "p-4";
+                ? toned ? `p-4 ${toned} hover:shadow-md transition-colors` : "p-4 hover:border-foreground/20 transition-colors"
+                : toned ? `p-4 ${toned}` : "p-4";
             const cardClassAttr = mergeClassAttr(cardDefaultClass, card.props?.class);
             const cardPass = renderPassthroughAttrs(card.props, [
-                "title", "href", "description", "icon", "variant", "class",
+                "title", "href", "description", "icon", "variant", "class", "tone",
             ]);
             if (href) {
                 return `<Card${cardClassAttr}${cardPass}>\n<CardContent class="p-0">\n<a href="${escapeAttr(href)}" class="[text-decoration:none] text-foreground">\n${iconHtml}\n${titleHtml}\n${desc}\n</a>\n</CardContent>\n</Card>`;
@@ -1452,12 +1481,14 @@ function standaloneCardToAstro(node, ctx) {
     const desc = lead + (inner
         ? `<${descTag} class="text-sm text-muted-foreground mt-1 [text-decoration:none]">${inner}</${descTag}>`
         : "");
+    // A tone (TONES), as on a card in a group (cardsToAstro)
+    const toned = lookup(CARD_TONE_CLASSES, node.props?.tone);
     const cardDefaultClass = href
-        ? "p-4 hover:border-foreground/20 transition-colors"
-        : "p-4";
+        ? toned ? `p-4 ${toned} hover:shadow-md transition-colors` : "p-4 hover:border-foreground/20 transition-colors"
+        : toned ? `p-4 ${toned}` : "p-4";
     const classAttr = mergeClassAttr(cardDefaultClass, node.props?.class);
     const passthrough = renderPassthroughAttrs(node.props, [
-        "title", "href", "description", "icon", "variant", "class",
+        "title", "href", "description", "icon", "variant", "class", "tone",
     ]);
     if (href) {
         return `<Card${classAttr}${passthrough}>\n<CardContent class="p-0">\n<a href="${escapeAttr(href)}" class="[text-decoration:none] text-foreground">\n${iconHtml}\n${titleHtml}\n${desc}\n</a>\n</CardContent>\n</Card>`;
@@ -1571,13 +1602,16 @@ function accordionToAstro(node, ctx) {
     ]);
     const items = (node.children ?? [])
         .filter((c) => c.type === "accordion-item")
-        .map((item) => accordionItemToAstro(item, ctx, /*standalone*/ false))
+        .map((item, i) => accordionItemToAstro(item, ctx, /*standalone*/ false, i + 1))
         .join("\n");
     return `<Accordion${typeAttr}${defaultAttr}${classAttr}${passthrough}>\n${items}\n</Accordion>`;
 }
-function accordionItemToAstro(node, ctx, standalone) {
+function accordionItemToAstro(node, ctx, standalone, 
+/** 1-based position: an item with no `value` must not share one with its siblings */
+index = 1) {
     ctx.imports.add("accordion");
-    const value = node.props?.value ?? "item-1";
+    // Items are matched by value: a shared fallback opened and closed them together
+    const value = node.props?.value ?? `item-${index}`;
     const label = node.props?.label ?? node.props?.title ?? "Item";
     const valueAttr = componentAttr("value", value);
     const classAttr = mergeClassAttr("", node.props?.class);
@@ -1644,6 +1678,10 @@ function htmlContainerToAstro(node, ctx) {
         const inner = childrenToAstro(node, ctx);
         return `<div class="columns-1 sm:columns-2 gap-4 [&_ul]:m-0">\n${inner}\n</div>`;
     }
+    // A container parsed from raw HTML (a one-line `<details>` body) carries
+    // its content in `html`, not children — rendering only children dropped it
+    if (!node.children?.length && node.html)
+        return htmlToAstro(node.html, ctx);
     const inner = childrenToAstro(node, ctx);
     return `<div>\n${inner}\n</div>`;
 }
@@ -1706,4 +1744,3 @@ const indentStr = indent;
 function escapeHtml(s) {
     return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
-//# sourceMappingURL=serialize.js.map

package/dist/sitemap.d.ts

@@ -105,4 +105,3 @@ export declare function buildSitemapIndex(options: BuildSitemapOptions): string;
 export declare function pageHref(slug: string | undefined, prefix: string): string;
 export declare function normalizePrefix(basePath: string | undefined): string;
 export declare function originOf(siteUrl: string): string;
-//# sourceMappingURL=sitemap.d.ts.map

package/dist/sitemap.js

@@ -124,4 +124,3 @@ export function originOf(siteUrl) {
 function stripTrailingSlash(s) {
     return s.replace(/\/+$/, "");
 }
-//# sourceMappingURL=sitemap.js.map