@takazudo/zudo-doc 8.1.2 → 9.0.0

package/dist/theme-packs/sakura/pack.css

@@ -57,7 +57,7 @@
 }
 
 /* ---- Shippori Mincho — display serif for the title, h2 and the
-        wordmark (static 600 heading weight + 700 logo weight).
+        wordmark (static 600 title weight + 700 h2/logo weight).
         Latin subsets only; the bare serif generic supplies CJK. ---- */
 
 @font-face {
@@ -280,22 +280,59 @@ html[data-theme-pack="sakura"] a[data-nav-active] {
     );
 }
 
-/* signature move #2 — the h2 petal rule: a rose stroke that loosens
-   into drifting transparency. Re-points the SSR-inlined
-   `style="border-image:linear-gradient(...)"` gradient — the
-   border-image !important carve-out (Decision 6.6). */
+/* signature move #2 — the h2 petal rule: a 2px rose stroke that loosens
+   into drifting transparency; h3 takes a quieter 1px muted rule and h4
+   none. The rules are top-anchored background gradients; border-image
+   none !important (the Decision 6.6 carve-out) keeps the SSR-inlined
+   `style="border-image:linear-gradient(...)"` from painting a second
+   bar. */
 html[data-theme-pack="sakura"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
-  font-size: 1.6rem;
-}
-html[data-theme-pack="sakura"] .zd-content h2 {
-  border-top-width: 2px;
-  border-image: linear-gradient(
-      to right,
-      var(--zd-accent) 0 2.5rem,
-      color-mix(in srgb, var(--zd-accent) 30%, transparent) 55%,
-      transparent
-    )
-    1 !important;
+  border-image: none !important;
+  border-top-width: 0;
+  border-bottom-width: 0;
+  padding-top: 1.25rem;
+  padding-bottom: 0;
+  font-size: 2rem;
+  font-weight: 700;
+  line-height: 1.3;
+  background-image: linear-gradient(
+    to right,
+    var(--zd-accent) 0,
+    var(--zd-accent) 4rem,
+    color-mix(in oklch, var(--zd-accent) 68%, transparent) 62%,
+    transparent 100%
+  );
+  background-size: 100% 2px;
+  background-repeat: no-repeat;
+  background-position: top left;
+}
+html[data-theme-pack="sakura"] .zd-content h3:where(:not(.zd-compact-prose *)) {
+  border-image: none !important;
+  border-top-width: 0;
+  border-bottom-width: 0;
+  padding-top: 0.875rem;
+  padding-bottom: 0;
+  font-size: 1.375rem;
+  font-weight: 600;
+  line-height: 1.4;
+  background-image: linear-gradient(
+    to right,
+    color-mix(in oklch, var(--zd-muted) 42%, transparent),
+    color-mix(in oklch, var(--zd-muted) 22%, transparent) 40%,
+    transparent 76%
+  );
+  background-size: 100% 1px;
+  background-repeat: no-repeat;
+  background-position: top left;
+}
+html[data-theme-pack="sakura"] .zd-content h4:where(:not(.zd-compact-prose *)) {
+  border-width: 0;
+  padding-top: 0;
+  padding-bottom: 0;
+  font-size: 1.2rem;
+  font-weight: 500;
+  line-height: 1.45;
+  background-image: none;
 }
 
 /* h3 — a round blossom bud before the heading */
@@ -309,6 +346,11 @@ html[data-theme-pack="sakura"] .zd-content h3::before {
   margin-right: 0.5em;
   vertical-align: 0.12em;
 }
+html[data-theme-pack="sakura"] .zd-content h3:where(:not(.zd-compact-prose *))::before {
+  width: 0.3em;
+  height: 0.3em;
+  opacity: 0.7;
+}
 
 /* the lead — airy, one breath rosier than body ink (10.9:1+) */
 html[data-theme-pack="sakura"] .zd-content > p[data-doc-description] {

package/dist/theme-packs/solar/pack.css

@@ -211,26 +211,59 @@ html[data-theme-pack="solar"] main nav[aria-label="Breadcrumb"] li > span {
 }
 
 /* h2 rule: a precise 2px blue→cyan fade instead of the default fg
-   gradient. The SSR-inlined `style="border-image:linear-gradient(...)"`
-   bar is defeated with border-image none !important (Decision 6.6's
-   sole allowlisted carve-out) + a zeroed border-top; the fade is then
-   painted as a 2px top-anchored background gradient. */
+   gradient; h3 takes a quieter 1px muted rule and h4 none. The
+   SSR-inlined `style="border-image:linear-gradient(...)"` bar is
+   defeated with border-image none !important (Decision 6.6's sole
+   allowlisted carve-out) + zeroed borders; each rule is painted as a
+   top-anchored background gradient. */
 html[data-theme-pack="solar"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
-  font-size: 1.5rem;
-}
-html[data-theme-pack="solar"] .zd-content h2 {
   border-image: none !important;
   border-top-width: 0;
+  border-bottom-width: 0;
+  padding-top: 1.25rem;
+  padding-bottom: 0;
+  font-size: 1.75rem;
+  font-weight: 700;
+  line-height: 1.3;
   background-image: linear-gradient(
     to right,
-    var(--zd-accent),
-    var(--zd-accent-hover) 45%,
-    transparent 88%
+    var(--zd-accent) 0%,
+    var(--zd-accent) 24%,
+    var(--zd-accent-hover) 65%,
+    transparent 100%
   );
   background-size: 100% 2px;
   background-repeat: no-repeat;
   background-position: top left;
 }
+html[data-theme-pack="solar"] .zd-content h3:where(:not(.zd-compact-prose *)) {
+  border-image: none !important;
+  border-top-width: 0;
+  border-bottom-width: 0;
+  padding-top: 0.875rem;
+  padding-bottom: 0;
+  font-size: 1.375rem;
+  font-weight: 600;
+  line-height: 1.4;
+  background-image: linear-gradient(
+    to right,
+    color-mix(in oklch, var(--zd-muted) 42%, transparent),
+    color-mix(in oklch, var(--zd-muted) 22%, transparent) 40%,
+    transparent 76%
+  );
+  background-size: 100% 1px;
+  background-repeat: no-repeat;
+  background-position: top left;
+}
+html[data-theme-pack="solar"] .zd-content h4:where(:not(.zd-compact-prose *)) {
+  border-width: 0;
+  padding-top: 0;
+  padding-bottom: 0;
+  font-size: 1.2rem;
+  font-weight: 500;
+  line-height: 1.45;
+  background-image: none;
+}
 
 /* prose links: quiet underline that sharpens to cyan on hover */
 html[data-theme-pack="solar"] .zd-content a {

package/dist/theme-packs/warm-mineral/meta.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": 1,
+  "slug": "warm-mineral",
+  "name": "Warm Mineral",
+  "description": "Warm mineral tones — sandstone paper by day, umber stone at night, a terracotta accent and quiet hairline rules.",
+  "mode": "dark",
+  "version": "1.0.0",
+  "fonts": {
+    "sans": "System",
+    "mono": "System",
+    "loaded": []
+  },
+  "preview": {
+    "light": {
+      "bg": "#F3EFE8",
+      "fg": "#47403A",
+      "accent": "#92471C",
+      "syntax": {
+        "keyword": "#92471C",
+        "string": "#556047",
+        "comment": "#655B52",
+        "callable": "#505E67"
+      }
+    },
+    "dark": {
+      "bg": "#2D2A27",
+      "fg": "#D6CFC6",
+      "accent": "#E5AA7D",
+      "syntax": {
+        "keyword": "#E5AA7D",
+        "string": "#A9B892",
+        "comment": "#B7ADA2",
+        "callable": "#A6B4BD"
+      }
+    }
+  }
+}

package/dist/theme-packs/warm-mineral/pack.css

@@ -0,0 +1,401 @@
+/* ============================================================
+   Warm Mineral — zudo-doc theme pack (ADR docs/adr/theme-packs.md)
+
+   Sandstone and umber stone, carrying a terracotta accent.
+   One of the three soft-tone packs (graphite, warm-mineral,
+   quiet-slate) that share the same component treatment and differ
+   only in palette. Colour only: typography, spacing, geometry and
+   heading hierarchy are the package defaults (no fonts loaded).
+
+   Roles beyond the public --zd-* tokens are inlined per mode:
+     line           decorative rules, separators and tree guides
+     control border necessary field / control / diagram boundaries
+     heading        heading ink, one step stronger than body text
+     hover bg       inactive navigation hover fill
+     active bg      current navigation fill (90% bg + 10% accent)
+     state bgs      admonition fills (90% bg + 10% state colour)
+   Classic (the reserved "default" pack) shares one muted role for
+   text, borders and comments; these packs keep muted at readable
+   text contrast and give decorative rules their own quieter line.
+
+   Production-only contrast repairs (not part of the ordinary
+   palette): diff rows use the opaque state fills instead of the
+   15% foreground tint, and code line / word highlights use opaque
+   active / hover fills (no stacked alpha) keeping the accent marker
+   and underline, so every syntax role stays >= 4.6:1.
+
+   Every rule is scoped under html[data-theme-pack="warm-mineral"]; the
+   pack never declares color-scheme and follows the mode the page
+   already resolved (light-dark()).
+   ============================================================ */
+
+html[data-theme-pack="warm-mineral"] {
+  /* Tier-2 semantic roles */
+  --zd-bg: light-dark(#F3EFE8, #2D2A27);
+  --zd-fg: light-dark(#47403A, #D6CFC6);
+  --zd-surface: light-dark(#E9E3D9, #36322E);
+  --zd-muted: light-dark(#655B52, #B7ADA2);
+  --zd-accent: light-dark(#92471C, #E5AA7D);
+  --zd-accent-hover: light-dark(#8C441B, #E7AF84);
+  --zd-code-bg: light-dark(#E9E3D9, #262320);
+  --zd-code-fg: light-dark(#47403A, #D6CFC6);
+  --zd-success: light-dark(#556047, #A9B892);
+  --zd-danger: light-dark(#824F4A, #D3A29B);
+  --zd-warning: light-dark(#70592F, #D2B482);
+  --zd-info: light-dark(#505E67, #A6B4BD);
+  --zd-selection-bg: light-dark(#92471C, #E5AA7D);
+  --zd-selection-fg: light-dark(#F9F5EF, #292522);
+  --zd-matched-keyword-bg: light-dark(#92471C, #E5AA7D);
+  --zd-matched-keyword-fg: light-dark(#F9F5EF, #292522);
+  --zd-chat-user-bg: light-dark(#92471C, #E5AA7D);
+  --zd-chat-user-text: light-dark(#F9F5EF, #292522);
+  --zd-chat-assistant-bg: light-dark(#E9E3D9, #36322E);
+  --zd-chat-assistant-text: light-dark(#47403A, #D6CFC6);
+  --zd-image-overlay-bg: light-dark(#F3EFE8, #2D2A27);
+  --zd-image-overlay-fg: light-dark(#47403A, #D6CFC6);
+  /* Mermaid: text is body text; edges are necessary diagram lines */
+  --zd-mermaid-node-bg: light-dark(#E9E3D9, #36322E);
+  --zd-mermaid-text: light-dark(#47403A, #D6CFC6);
+  --zd-mermaid-line: light-dark(#847668, #968A7E);
+  --zd-mermaid-label-bg: light-dark(#F3EFE8, #2D2A27);
+  --zd-mermaid-note-bg: light-dark(#E4DDCF, #3D3732);
+  
+  /* syntax — explicit role mapping */
+  --zd-syntax-comment: light-dark(#655B52, #B7ADA2);
+  --zd-syntax-string: light-dark(#556047, #A9B892);
+  --zd-syntax-number: light-dark(#70592F, #D2B482);
+  --zd-syntax-keyword: light-dark(#92471C, #E5AA7D);
+  --zd-syntax-callable: light-dark(#505E67, #A6B4BD);
+  --zd-syntax-type: light-dark(#70592F, #D2B482);
+  --zd-syntax-name: light-dark(#47403A, #D6CFC6);
+  --zd-syntax-inserted: light-dark(#556047, #A9B892);
+  --zd-syntax-deleted: light-dark(#824F4A, #D3A29B);
+  /* diff rows: opaque audited state fills instead of the 15% tint */
+  --zfb-hi-ins-bg: light-dark(#E3E1D8, #393832);
+  --zfb-hi-del-bg: light-dark(#E8DFD8, #3E3633);
+  
+  /* Tier-3 seams */
+  --zdc-nav-active-indicator-color: light-dark(#E9DED4, #3F3730);
+}
+
+/* ---- page, chrome surfaces and decorative rules ---- */
+
+html[data-theme-pack="warm-mineral"] header[data-header],
+html[data-theme-pack="warm-mineral"] footer[data-footer] {
+  background-color: var(--zd-surface);
+  border-color: light-dark(#D8CEC1, #4D4640);
+}
+
+html[data-theme-pack="warm-mineral"] footer[data-footer] div {
+  border-color: light-dark(#D8CEC1, #4D4640);
+}
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar],
+html[data-theme-pack="warm-mineral"] #desktop-sidebar div,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] div,
+html[data-theme-pack="warm-mineral"] #desktop-sidebar nav,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] nav {
+  border-color: light-dark(#D8CEC1, #4D4640);
+}
+
+html[data-theme-pack="warm-mineral"] nav[data-zd-toc] ul,
+html[data-theme-pack="warm-mineral"] div[data-zd-mobile-toc],
+html[data-theme-pack="warm-mineral"] div[data-zd-mobile-toc] ul {
+  border-color: light-dark(#D8CEC1, #4D4640);
+}
+
+html[data-theme-pack="warm-mineral"] [data-site-nav] div,
+html[data-theme-pack="warm-mineral"] [data-tabs-nav],
+html[data-theme-pack="warm-mineral"] [data-version-menu] > li,
+html[data-theme-pack="warm-mineral"] [data-nav-more-menu] > li,
+html[data-theme-pack="warm-mineral"] [data-language-menu] > li,
+html[data-theme-pack="warm-mineral"] dialog[data-search-dialog] > div div,
+html[data-theme-pack="warm-mineral"] dialog[data-search-dialog] [data-search-count-narrow],
+html[data-theme-pack="warm-mineral"] dialog[data-doc-history-panel] > div,
+html[data-theme-pack="warm-mineral"] [data-theme-pack-switcher] dialog div,
+html[data-theme-pack="warm-mineral"] dialog[data-zd-ai-chat] > div > div {
+  border-color: light-dark(#D8CEC1, #4D4640);
+}
+
+html[data-theme-pack="warm-mineral"] .zd-content h1,
+html[data-theme-pack="warm-mineral"] .zd-content table,
+html[data-theme-pack="warm-mineral"] .zd-content th,
+html[data-theme-pack="warm-mineral"] .zd-content td,
+html[data-theme-pack="warm-mineral"] .zd-content hr,
+html[data-theme-pack="warm-mineral"] .zd-content pre,
+html[data-theme-pack="warm-mineral"] .zd-content .code-block-title,
+html[data-theme-pack="warm-mineral"] .zd-content > section,
+html[data-theme-pack="warm-mineral"] .zd-content > ol > li:not(:hover):not(:focus-within),
+html[data-theme-pack="warm-mineral"] .zd-content > nav[data-doc-pager] > a:not(:hover),
+html[data-theme-pack="warm-mineral"] .zd-home-rule {
+  border-color: light-dark(#D8CEC1, #4D4640);
+}
+
+/* ---- necessary control and field boundaries ---- */
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar button,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] button,
+html[data-theme-pack="warm-mineral"] header[data-header] button,
+html[data-theme-pack="warm-mineral"] [data-nav-item-dropdown] > div > div,
+html[data-theme-pack="warm-mineral"] [data-version-menu],
+html[data-theme-pack="warm-mineral"] button[data-version-toggle]:not(:hover),
+html[data-theme-pack="warm-mineral"] button[data-language-toggle]:not(:hover),
+html[data-theme-pack="warm-mineral"] button[data-doc-history-trigger]:not(:hover),
+html[data-theme-pack="warm-mineral"] button[data-switcher-launcher]:not(:hover),
+html[data-theme-pack="warm-mineral"] dialog[data-search-dialog] > div,
+html[data-theme-pack="warm-mineral"] [data-site-nav] button,
+html[data-theme-pack="warm-mineral"] [data-nav-more-menu],
+html[data-theme-pack="warm-mineral"] [data-language-menu],
+html[data-theme-pack="warm-mineral"] [data-theme-pack-switcher] dialog,
+html[data-theme-pack="warm-mineral"] dialog[data-zd-ai-chat] input,
+html[data-theme-pack="warm-mineral"] dialog.zd-enlarge-dialog,
+html[data-theme-pack="warm-mineral"] dialog.zd-mermaid-dialog,
+html[data-theme-pack="warm-mineral"] .code-btn:not(:hover),
+html[data-theme-pack="warm-mineral"] .zd-desktop-sidebar-toggle,
+html[data-theme-pack="warm-mineral"] .zd-desktop-toc-toggle,
+html[data-theme-pack="warm-mineral"] kbd {
+  border-color: light-dark(#847668, #968A7E);
+}
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar [data-sidebar-filter-region] > div,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] [data-sidebar-filter-region] > div {
+  box-shadow: inset 0 0 0 1px light-dark(#847668, #968A7E);
+}
+
+/* ---- headings ---- */
+
+html[data-theme-pack="warm-mineral"] .zd-content h1,
+html[data-theme-pack="warm-mineral"] .zd-content h2,
+html[data-theme-pack="warm-mineral"] .zd-content h3,
+html[data-theme-pack="warm-mineral"] .zd-content h4,
+html[data-theme-pack="warm-mineral"] .zd-content h5,
+html[data-theme-pack="warm-mineral"] .zd-content h6 {
+  color: light-dark(#38322D, #E2DBD2);
+}
+
+html[data-theme-pack="warm-mineral"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  border-image: linear-gradient(to right, color-mix(in srgb, light-dark(#847668, #968A7E) 65%, light-dark(#F3EFE8, #2D2A27)), transparent) 1 !important;
+}
+
+html[data-theme-pack="warm-mineral"] .zd-content h3:where(:not(.zd-compact-prose *)),
+html[data-theme-pack="warm-mineral"] .zd-content h4:where(:not(.zd-compact-prose *)) {
+  border-image: linear-gradient(to right, light-dark(#D8CEC1, #4D4640), transparent) 1 !important;
+}
+
+/* ---- code ---- */
+
+html[data-theme-pack="warm-mineral"] .zd-content .code-block-title {
+  background-color: var(--zd-code-bg);
+  color: var(--zd-muted);
+}
+
+html[data-theme-pack="warm-mineral"] pre.hi-root .line.highlighted,
+html[data-theme-pack="warm-mineral"] pre.hi-root [data-line-highlight="true"] {
+  background-color: light-dark(#E9DED4, #3F3730);
+  box-shadow: inset 3px 0 0 var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] pre.hi-root .line .highlighted-word {
+  background-color: light-dark(#E4DDCF, #3D3732);
+}
+
+html[data-theme-pack="warm-mineral"] .zd-content th,
+html[data-theme-pack="warm-mineral"] .zd-content thead {
+  background-color: var(--zd-surface);
+}
+
+/* ---- current navigation: active fill, accent text, 3px marker ---- */
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar a[aria-current="page"],
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] a[aria-current="page"],
+html[data-theme-pack="warm-mineral"] #desktop-sidebar div:has(> a[aria-current="page"]),
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] div:has(> a[aria-current="page"]) {
+  background-color: light-dark(#E9DED4, #3F3730);
+  color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar a[aria-current="page"],
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] a[aria-current="page"] {
+  box-shadow: inset 3px 0 0 var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar a[aria-current="page"] *,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] a[aria-current="page"] *,
+html[data-theme-pack="warm-mineral"] #desktop-sidebar div:has(> a[aria-current="page"]) > button,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] div:has(> a[aria-current="page"]) > button,
+html[data-theme-pack="warm-mineral"] #desktop-sidebar div:has(> a[aria-current="page"]) > button *,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] div:has(> a[aria-current="page"]) > button * {
+  color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar div:has(> a[aria-current="page"]) > button,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] div:has(> a[aria-current="page"]) > button {
+  background-color: transparent;
+  border-color: light-dark(#847668, #968A7E);
+}
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar a[aria-current="page"]:hover,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] a[aria-current="page"]:hover,
+html[data-theme-pack="warm-mineral"] #desktop-sidebar a[aria-current="page"]:focus-visible,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] a[aria-current="page"]:focus-visible,
+html[data-theme-pack="warm-mineral"] #desktop-sidebar div:has(> a[aria-current="page"]) > button:hover,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] div:has(> a[aria-current="page"]) > button:hover,
+html[data-theme-pack="warm-mineral"] #desktop-sidebar div:has(> a[aria-current="page"]) > button:focus-visible,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] div:has(> a[aria-current="page"]) > button:focus-visible {
+  background-color: light-dark(#E9DED4, #3F3730);
+  color: var(--zd-accent-hover);
+}
+
+html[data-theme-pack="warm-mineral"] [data-header-nav] a[aria-current="page"],
+html[data-theme-pack="warm-mineral"] [data-header-nav] a[aria-current="page"]:hover,
+html[data-theme-pack="warm-mineral"] [data-header-nav] a[aria-current="page"]:focus-visible {
+  background-color: light-dark(#E9DED4, #3F3730);
+  color: var(--zd-accent);
+  box-shadow: inset 0 -3px 0 var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] [data-header-nav] a[aria-current="page"] * {
+  color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] nav[data-zd-toc] a {
+  padding-inline: 0.5rem;
+}
+
+html[data-theme-pack="warm-mineral"] nav[data-zd-toc] a[aria-current="true"] {
+  background-color: light-dark(#E9DED4, #3F3730);
+  color: var(--zd-accent);
+  box-shadow: inset 3px 0 0 var(--zd-accent);
+}
+
+/* ---- inactive navigation hover ---- */
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar [data-sidebar-tree-root] a:not([aria-current="page"]):hover,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] [data-sidebar-tree-root] a:not([aria-current="page"]):hover {
+  background-color: light-dark(#E4DDCF, #3D3732);
+  color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] [data-site-nav] a:hover {
+  color: var(--zd-accent);
+}
+
+/* ---- tag chips: line outline, bg fill, opaque muted count ---- */
+
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip] > [data-zd-tag-chip-outline] {
+  background-color: light-dark(#D8CEC1, #4D4640);
+}
+
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip] > [data-zd-tag-chip-label] {
+  background-color: var(--zd-bg);
+  color: var(--zd-fg);
+}
+
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip] [data-zd-tag-count],
+html[data-theme-pack="warm-mineral"] footer[data-footer] [data-zd-tag-count] {
+  opacity: 1;
+  color: var(--zd-muted);
+}
+
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip]:hover > [data-zd-tag-chip-outline],
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip]:focus-visible > [data-zd-tag-chip-outline] {
+  background-color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip]:hover > [data-zd-tag-chip-label],
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip]:focus-visible > [data-zd-tag-chip-label] {
+  background-color: light-dark(#E4DDCF, #3D3732);
+  color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip]:hover [data-zd-tag-count],
+html[data-theme-pack="warm-mineral"] a[data-zd-tag-chip]:focus-visible [data-zd-tag-count],
+html[data-theme-pack="warm-mineral"] footer[data-footer] a:hover [data-zd-tag-count],
+html[data-theme-pack="warm-mineral"] footer[data-footer] a:focus-visible [data-zd-tag-count] {
+  color: var(--zd-accent);
+}
+
+/* ---- admonitions: soft fills, semantic title + stripe (labels/icons kept) ---- */
+
+html[data-theme-pack="warm-mineral"] [data-admonition="note"] {
+  background-color: light-dark(#E9DED4, #3F3730);
+  border-left-color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="note"] .admonition-title {
+  color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="important"] {
+  background-color: light-dark(#E9DED4, #3F3730);
+  border-left-color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="important"] .admonition-title {
+  color: var(--zd-accent);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="info"] {
+  background-color: light-dark(#E3E0DB, #393836);
+  border-left-color: var(--zd-info);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="info"] .admonition-title {
+  color: var(--zd-info);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="tip"] {
+  background-color: light-dark(#E3E1D8, #393832);
+  border-left-color: var(--zd-success);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="tip"] .admonition-title {
+  color: var(--zd-success);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="warning"] {
+  background-color: light-dark(#E6E0D6, #3E3830);
+  border-left-color: var(--zd-warning);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="warning"] .admonition-title {
+  color: var(--zd-warning);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="danger"] {
+  background-color: light-dark(#E8DFD8, #3E3633);
+  border-left-color: var(--zd-danger);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="danger"] .admonition-title {
+  color: var(--zd-danger);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="caution"] {
+  background-color: light-dark(#E8DFD8, #3E3633);
+  border-left-color: var(--zd-danger);
+}
+
+html[data-theme-pack="warm-mineral"] [data-admonition="caution"] .admonition-title {
+  color: var(--zd-danger);
+}
+
+/* ---- keyboard focus: 2px accent outline, 3px offset (inset inside scrollers so it is never clipped) ---- */
+
+html[data-theme-pack="warm-mineral"] :focus-visible {
+  outline: 2px solid var(--zd-accent);
+  outline-offset: 3px;
+}
+
+html[data-theme-pack="warm-mineral"] #desktop-sidebar :focus-visible,
+html[data-theme-pack="warm-mineral"] aside[data-zd-mobile-sidebar] :focus-visible,
+html[data-theme-pack="warm-mineral"] nav[data-zd-toc] :focus-visible,
+html[data-theme-pack="warm-mineral"] div[data-zd-mobile-toc] :focus-visible {
+  outline-offset: -2px;
+}
+
+html[data-theme-pack="warm-mineral"] .zd-content a,
+html[data-theme-pack="warm-mineral"] .zd-content button {
+  text-underline-offset: 3px;
+}

package/dist/theme-packs-registry/configured-theme-pack.d.ts

@@ -0,0 +1,21 @@
+/** The pack an ordinary configuration resolves to when `themePack` is omitted. */
+export declare const CONFIGURED_DEFAULT_THEME_PACK_SLUG = "graphite";
+/** Inputs read by {@link resolveConfiguredThemePack}. */
+export interface ConfiguredThemePackInput {
+    /** The configured slug. `null`/`undefined` mean "omitted". */
+    themePack?: string | null;
+    /** The resolved `colorMode` setting; `false` is the fixed-scheme opt-out. */
+    colorMode?: unknown;
+    /** `true` when the caller supplied its own `colorSchemes` data. */
+    customColorSchemes?: boolean;
+}
+/**
+ * Resolve the effective configured pack slug:
+ *
+ * 1. an explicit (non-nullish) `themePack` wins verbatim — validation of the
+ *    slug stays with the registry resolver, which fails loudly;
+ * 2. omitted + custom `colorSchemes` or `colorMode: false` → `"default"`
+ *    (Classic, no pack stylesheet);
+ * 3. otherwise → {@link CONFIGURED_DEFAULT_THEME_PACK_SLUG}.
+ */
+export declare function resolveConfiguredThemePack(input: ConfiguredThemePackInput): string;

package/dist/theme-packs-registry/configured-theme-pack.js

@@ -0,0 +1,13 @@
+const RESERVED_DEFAULT_SLUG = "default";
+const CONFIGURED_DEFAULT_THEME_PACK_SLUG = "graphite";
+function resolveConfiguredThemePack(input) {
+  if (input.themePack !== void 0 && input.themePack !== null) return input.themePack;
+  if (input.customColorSchemes === true || input.colorMode === false) {
+    return RESERVED_DEFAULT_SLUG;
+  }
+  return CONFIGURED_DEFAULT_THEME_PACK_SLUG;
+}
+export {
+  CONFIGURED_DEFAULT_THEME_PACK_SLUG,
+  resolveConfiguredThemePack
+};

package/dist/theme-packs-registry/index.d.ts

@@ -1,4 +1,5 @@
 export { THEME_PACK_SLUG_RE, DEFAULT_THEME_PACK_SLUG, themePackMetaSchema, type ThemePackMeta, type ThemePackSwatches, } from "./meta-schema.js";
+export { CONFIGURED_DEFAULT_THEME_PACK_SLUG, resolveConfiguredThemePack, type ConfiguredThemePackInput, } from "./configured-theme-pack.js";
 export { KNOWN_THEME_PACK_TOKEN_NAMES, COMMERCIAL_FONT_DENYLIST, THEME_PACK_SOFT_BUDGET_BYTES, } from "./token-manifest.js";
 export { validateThemePack, type ThemePackValidationInput, type ThemePackValidationIssue, type ThemePackValidationResult, type ThemePackValidationSeverity, } from "./validator.js";
 export type { ThemePackRegistry, ThemePackRegistryEntry } from "./types.js";

package/dist/theme-packs-registry/index.js

@@ -3,6 +3,10 @@ import {
   DEFAULT_THEME_PACK_SLUG,
   themePackMetaSchema
 } from "./meta-schema.js";
+import {
+  CONFIGURED_DEFAULT_THEME_PACK_SLUG,
+  resolveConfiguredThemePack
+} from "./configured-theme-pack.js";
 import {
   KNOWN_THEME_PACK_TOKEN_NAMES,
   COMMERCIAL_FONT_DENYLIST,
@@ -20,11 +24,13 @@ import {
 } from "./build-registry.js";
 export {
   COMMERCIAL_FONT_DENYLIST,
+  CONFIGURED_DEFAULT_THEME_PACK_SLUG,
   DEFAULT_THEME_PACK_SLUG,
   KNOWN_THEME_PACK_TOKEN_NAMES,
   THEME_PACK_SLUG_RE,
   THEME_PACK_SOFT_BUDGET_BYTES,
   buildThemePackRegistry,
+  resolveConfiguredThemePack,
   resolveEnabledPacks,
   schemaVersion,
   themePackMetaSchema,