@dogsbay/format-astro 0.2.0-beta.122 → 0.2.0-beta.124

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

@@ -26,4 +26,3 @@
  */
 import type { CapabilityDeclaration } from "@dogsbay/serialize-core";
 export declare const ASTRO_CAPABILITIES: CapabilityDeclaration[];
-//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.js

@@ -30,6 +30,9 @@ export const ASTRO_CAPABILITIES = [
     { 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",
@@ -55,6 +58,7 @@ export const ASTRO_CAPABILITIES = [
         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" },
@@ -99,4 +103,3 @@ export const ASTRO_CAPABILITIES = [
     { feature: "footnote-ref", support: "full", rendersAs: "`<sup><a href=\"#fn-…\">`" },
     { feature: "html-inline", support: "full", rendersAs: "raw HTML via `<Fragment set:html>`" },
 ];
-//# sourceMappingURL=capabilities.js.map

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

@@ -53,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

@@ -32,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

@@ -60,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

@@ -3536,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, 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 = {
@@ -248,6 +248,19 @@ 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 renderAroundGroup(node, "tab", (n) => tabsToAstro(n, ctx), (c) => nodeToAstro(c, ctx), "\n");
         case "ordered-list":
@@ -417,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>`;
@@ -1061,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
@@ -1081,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
@@ -1097,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}
@@ -1364,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");
@@ -1398,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>`;
@@ -1461,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>`;
@@ -1722,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

package/dist/taxonomy.d.ts

@@ -144,4 +144,3 @@ export declare function emitTaxonomyRoutes(pages: ExportPage[], outputDir: strin
      */
     urlPrefix?: string;
 }): string[];
-//# sourceMappingURL=taxonomy.d.ts.map

package/dist/taxonomy.js

@@ -534,4 +534,3 @@ function escapeHtml(s) {
         .replace(/>/g, ">")
         .replace(/"/g, """);
 }
-//# sourceMappingURL=taxonomy.js.map

package/dist/theme-css.d.ts

@@ -15,6 +15,14 @@
  * tone added to the palette is automatically safelisted.
  */
 export declare function buildToneSafelist(): string;
+/**
+ * The same pin for the variant, tone and theme-scope tables
+ * (plans/dita-variants-themes.md). A line of its own, marked ASTRO-ONLY:
+ * render-html copies this stylesheet, and a renderer that compiles from the
+ * page's own classes (render-html, dogsbay-ssg) needs no safelist — there it
+ * put every variant's classes on every page (scripts/sources.mjs drops it).
+ */
+export declare function buildVariantSafelist(): string;
 export declare function generateGlobalCss(): string;
 /** The theme presets by name. A name not here falls back to "default", as writeThemeFile always did. */
 export declare const THEMES: Record<string, {
@@ -23,4 +31,3 @@ export declare const THEMES: Record<string, {
 }>;
 /** A site's src/styles/theme.css for a preset: the Tailwind theme mapping plus the preset's tokens. */
 export declare function themeCss(themeName?: string): string;
-//# sourceMappingURL=theme-css.d.ts.map

package/dist/theme-css.js

@@ -8,7 +8,7 @@
  * css/ (packages/render-html/scripts/sources.mjs), which dogsbay-ssg and the
  * single-page renderer use.
  */
-import { TONE_CLASSES } from "./tone-classes.js";
+import { TONE_CLASSES, CARD_TONE_CLASSES, TAB_VARIANTS, THEME_SCOPES } from "./tone-classes.js";
 // ── CSS generation (ported from import-mkdocs.ts) ───────
 /**
  * Build the `@source inline("...")` directive that pins the
@@ -36,6 +36,26 @@ export function buildToneSafelist() {
     }
     return [...seen].sort().join(" ");
 }
+/**
+ * The same pin for the variant, tone and theme-scope tables
+ * (plans/dita-variants-themes.md). A line of its own, marked ASTRO-ONLY:
+ * render-html copies this stylesheet, and a renderer that compiles from the
+ * page's own classes (render-html, dogsbay-ssg) needs no safelist — there it
+ * put every variant's classes on every page (scripts/sources.mjs drops it).
+ */
+export function buildVariantSafelist() {
+    const seen = new Set();
+    const sources = [
+        ...Object.values(CARD_TONE_CLASSES),
+        ...Object.values(TAB_VARIANTS).flatMap((v) => [v.list, v.trigger]),
+        ...Object.values(THEME_SCOPES),
+    ];
+    for (const classes of sources)
+        for (const cls of classes.split(/\s+/))
+            if (cls)
+                seen.add(cls);
+    return [...seen].sort().join(" ");
+}
 export function generateGlobalCss() {
     return `@import "tailwindcss";
 @import "./theme.css";
@@ -67,6 +87,7 @@ export function generateGlobalCss() {
    Tailwind doesn't see them in the scanned globs, leaving grid
    demo cells with no visible background. */
 @source inline("${buildToneSafelist()}");
+@source inline("${buildVariantSafelist()}"); /* ASTRO-ONLY: variants, tones, theme scopes */
 
 /* Prose typography for rendered content.
    Every element rule is guarded with :not(.dba-api *): API-reference
@@ -93,8 +114,9 @@ export function generateGlobalCss() {
      looked like a colour bug in one button rather than a cascade bug in both.
      (No backticks in this comment: the whole stylesheet is a template
      literal.) */
-  & a:not(.dba-api *):not([data-variant]) { color: var(--primary); text-decoration: underline; text-underline-offset: 2px; }
-  & a:hover:not(.dba-api *):not([data-variant]) { opacity: 0.8; }
+  /* Not a whole-card link (LinkCard, the video card: \`a.not-prose\`): its underline ran under every line of the card */
+  & a:not(.dba-api *):not([data-variant]):not(.not-prose) { color: var(--primary); text-decoration: underline; text-underline-offset: 2px; }
+  & a:hover:not(.dba-api *):not([data-variant]):not(.not-prose) { opacity: 0.8; }
 
   & strong:not(.dba-api *) { font-weight: 600; }
   & code:not(.dba-api *) { font-size: 0.875em; padding: 0.15em 0.35em; border-radius: 0.25rem; background: var(--muted); font-family: var(--font-code, ui-monospace, monospace); }
@@ -108,6 +130,9 @@ export function generateGlobalCss() {
   & ol:not(.dba-api *) { 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 */
+  & [data-component="files"] ul:not(.dba-api *) { list-style: none; padding-left: 0; }
+  & [data-component="files"] li > ul:not(.dba-api *) { padding-left: 1rem; }
 
   & blockquote:not(.dba-api *) { border-left: 4px solid var(--border); padding-left: 1rem; color: var(--muted-foreground); font-style: italic; margin: 1rem 0; }
 
@@ -652,4 +677,3 @@ ${tokens.dark}
 }
 `;
 }
-//# sourceMappingURL=theme-css.js.map

package/dist/tone-classes.d.ts

@@ -10,5 +10,43 @@
  * their content/ outside the scanned globs won't pick them up at
  * all). See generateGlobalCss in theme-css.ts.
  */
+/**
+ * A table entry by author-supplied key, own properties only. A plain
+ * `TABLE[key]` with `toString`, `constructor` or `__proto__` returns
+ * Object.prototype members: a function's source landed in a class attribute,
+ * an unknown theme name passed as valid, and a tab variant crashed the build.
+ */
+export declare function lookup<T>(table: Record<string, T>, key: unknown): T | undefined;
 export declare const TONE_CLASSES: Record<string, string>;
-//# sourceMappingURL=tone-classes.d.ts.map
+/**
+ * The shared tone vocabulary for components that take one (`tone` on cards,
+ * DITA `tone-*` tokens): the callout palette, which every theme preset
+ * defines (`--info`, `--success`, `--warning`, `--danger`).
+ */
+export declare const TONES: readonly ["info", "success", "warning", "danger"];
+export type Tone = (typeof TONES)[number];
+/** A toned card: the callout recipe, a 50% border and a 5% tint. */
+export declare const CARD_TONE_CLASSES: Record<string, string>;
+/**
+ * Tab variants (`:::tabs{variant="pills"}`; DITA `db-tabs pills`). COMPLETE
+ * class strings for the list and each trigger, not additions: render-html has
+ * no tailwind-merge, so a variant replaces its base string there, and Astro
+ * passes it as `class` to TabsList/TabsTrigger, whose tailwind-variants merge
+ * resolves the conflicts the same way — but only for a class GROUP the variant
+ * also sets, so each string resets every base group it replaces (`p-0` before
+ * its own padding, `border-b-0`, `rounded-none`, `aria-selected:shadow-none`). packages/ui
+ * tests/tabs-variants.test.ts runs the real merge against the base classes.
+ * Existing sites therefore get variants without re-copying the components.
+ */
+export declare const TAB_VARIANTS: Record<string, {
+    list: string;
+    trigger: string;
+}>;
+/**
+ * Scoped themes (TreeNode `theme`; DITA `db-theme-<name>`). The theme
+ * declares its dark tokens on `.dark` and the `dark:` variant is
+ * `&:where(.dark, .dark *)`, so a wrapper with class `dark` re-themes its
+ * subtree with no new CSS. `light` inside a dark page and brand presets per
+ * subtree are phase 2 (plans/dita-variants-themes.md).
+ */
+export declare const THEME_SCOPES: Record<string, string>;

package/dist/tone-classes.js

@@ -10,6 +10,15 @@
  * their content/ outside the scanned globs won't pick them up at
  * all). See generateGlobalCss in theme-css.ts.
  */
+/**
+ * A table entry by author-supplied key, own properties only. A plain
+ * `TABLE[key]` with `toString`, `constructor` or `__proto__` returns
+ * Object.prototype members: a function's source landed in a class attribute,
+ * an unknown theme name passed as valid, and a tab variant crashed the build.
+ */
+export function lookup(table, key) {
+    return typeof key === "string" && Object.prototype.hasOwnProperty.call(table, key) ? table[key] : undefined;
+}
 export const TONE_CLASSES = {
     // Primary scale (intensity)
     "primary": "bg-primary text-primary-foreground",
@@ -27,4 +36,49 @@ export const TONE_CLASSES = {
     "purple": "bg-purple-500/15 text-purple-700 dark:text-purple-300",
     "red": "bg-red-500/15 text-red-700 dark:text-red-300",
 };
-//# sourceMappingURL=tone-classes.js.map
+/**
+ * The shared tone vocabulary for components that take one (`tone` on cards,
+ * DITA `tone-*` tokens): the callout palette, which every theme preset
+ * defines (`--info`, `--success`, `--warning`, `--danger`).
+ */
+export const TONES = ["info", "success", "warning", "danger"];
+/** A toned card: the callout recipe, a 50% border and a 5% tint. */
+export const CARD_TONE_CLASSES = {
+    info: "border-info/50 bg-info/5",
+    success: "border-success/50 bg-success/5",
+    warning: "border-warning/50 bg-warning/5",
+    danger: "border-danger/50 bg-danger/5",
+};
+/**
+ * Tab variants (`:::tabs{variant="pills"}`; DITA `db-tabs pills`). COMPLETE
+ * class strings for the list and each trigger, not additions: render-html has
+ * no tailwind-merge, so a variant replaces its base string there, and Astro
+ * passes it as `class` to TabsList/TabsTrigger, whose tailwind-variants merge
+ * resolves the conflicts the same way — but only for a class GROUP the variant
+ * also sets, so each string resets every base group it replaces (`p-0` before
+ * its own padding, `border-b-0`, `rounded-none`, `aria-selected:shadow-none`). packages/ui
+ * tests/tabs-variants.test.ts runs the real merge against the base classes.
+ * Existing sites therefore get variants without re-copying the components.
+ */
+export const TAB_VARIANTS = {
+    pills: {
+        list: "flex flex-wrap items-center gap-2 border-b-0 border-transparent bg-transparent p-0 px-3 pt-3 pb-1 text-muted-foreground",
+        trigger: "inline-flex items-center justify-center whitespace-nowrap rounded-full border border-border px-4 py-1.5 text-sm font-medium ring-offset-background transition-all focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 aria-selected:border-primary aria-selected:bg-primary aria-selected:text-primary-foreground aria-selected:shadow-none",
+    },
+    underline: {
+        list: "flex items-center gap-6 border-b border-border bg-transparent p-0 px-4 text-muted-foreground",
+        trigger: "-mb-px inline-flex items-center justify-center whitespace-nowrap rounded-none border-b-2 border-transparent p-0 px-0.5 pt-3 pb-2 text-sm font-medium ring-offset-background transition-all focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 hover:text-foreground aria-selected:border-primary aria-selected:bg-transparent aria-selected:text-foreground aria-selected:shadow-none",
+    },
+};
+/**
+ * Scoped themes (TreeNode `theme`; DITA `db-theme-<name>`). The theme
+ * declares its dark tokens on `.dark` and the `dark:` variant is
+ * `&:where(.dark, .dark *)`, so a wrapper with class `dark` re-themes its
+ * subtree with no new CSS. `light` inside a dark page and brand presets per
+ * subtree are phase 2 (plans/dita-variants-themes.md).
+ */
+// The first and last child's margins are trimmed with `!`: the prose heading
+// rule (`.docs-prose h3:not(…)`) out-specifies a plain `[&>:first-child]` rule.
+export const THEME_SCOPES = {
+    dark: "dark my-6 rounded-xl border border-border bg-background p-6 text-foreground [&>:first-child]:mt-0! [&>:last-child]:mb-0!",
+};

package/dist/write-if-changed.d.ts

@@ -18,4 +18,3 @@ export declare function writeFileSync(path: fs.PathOrFileDescriptor, data: Write
 /** `fs.copyFileSync`, skipped when the destination already holds the source's bytes. */
 export declare function copyFileSync(src: fs.PathLike, dest: fs.PathLike, mode?: number): void;
 export {};
-//# sourceMappingURL=write-if-changed.d.ts.map