@takazudo/zudo-doc 8.1.3 → 9.1.0

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,

package/dist/theme-packs-registry/resolve-enabled-packs.d.ts

@@ -1,21 +1,28 @@
 import type { ThemePackRegistry } from "./types.js";
 /** The subset of settings this resolver reads. */
 export interface ResolveEnabledPacksSettings {
-    /** Active pack slug — must end up a member of the resolved list. */
-    themePack?: string;
+    /** Active pack slug — must end up a member of the resolved list. Omitted
+     *  means the configured default (`"graphite"`); callers that must honour
+     *  the custom-scheme / fixed-scheme Classic exception normalize it first
+     *  via `resolveConfiguredThemePack`. */
+    themePack?: string | null;
+    /** The resolved `colorMode`; `false` makes an omitted `themePack` Classic. */
+    colorMode?: unknown;
     /** Explicit enabled-pack order, or `undefined` for the canonical default
-     *  order (`"default"` first, then the rest alphabetically). */
+     *  order (`"graphite"` first, `"default"` (Classic) second, then the rest
+     *  alphabetically). */
     themePacks?: string[];
 }
 /**
  * Resolve the ENABLED, ORDERED subset of `registry` per `settings.themePacks`
  * / `settings.themePack` (Decision 7):
  *
- * - `themePacks` omitted → every bundled pack, `"default"` first, then the
- *   rest in canonical (alphabetical-by-slug) order.
+ * - `themePacks` omitted → every bundled pack: the configured default
+ *   (`"graphite"`) first, `"default"` (Classic) second, then the rest in
+ *   canonical (alphabetical-by-slug) order.
  * - `themePacks` an explicit array → authoritative: may omit `"default"`,
  *   reorder freely. Duplicate or unknown slugs throw loudly.
- * - `themePack` (the active slug, default `"default"`) must be a member of
+ * - `themePack` (the active slug, default `"graphite"`) must be a member of
  *   the resolved list — an unknown/excluded active slug throws loudly,
  *   naming the bad slug and the available ones.
  *

package/dist/theme-packs-registry/resolve-enabled-packs.js

@@ -1,12 +1,18 @@
 import { DEFAULT_THEME_PACK_SLUG } from "./meta-schema.js";
+import {
+  CONFIGURED_DEFAULT_THEME_PACK_SLUG,
+  resolveConfiguredThemePack
+} from "./configured-theme-pack.js";
 function resolveEnabledPacks(registry, settings) {
   const bySlug = new Map(registry.map((entry) => [entry.slug, entry]));
   const availableSlugs = registry.map((e) => e.slug);
   let orderedSlugs;
   if (settings.themePacks === void 0) {
-    const hasDefault = bySlug.has(DEFAULT_THEME_PACK_SLUG);
-    const rest = availableSlugs.filter((s) => s !== DEFAULT_THEME_PACK_SLUG).sort();
-    orderedSlugs = hasDefault ? [DEFAULT_THEME_PACK_SLUG, ...rest] : rest;
+    const leading = [CONFIGURED_DEFAULT_THEME_PACK_SLUG, DEFAULT_THEME_PACK_SLUG].filter(
+      (slug) => bySlug.has(slug)
+    );
+    const rest = availableSlugs.filter((s) => !leading.includes(s)).sort();
+    orderedSlugs = [...leading, ...rest];
   } else {
     const requested = settings.themePacks;
     const seen = /* @__PURE__ */ new Set();
@@ -30,10 +36,14 @@ function resolveEnabledPacks(registry, settings) {
     orderedSlugs = [...requested];
   }
   const enabled = orderedSlugs.map((slug) => bySlug.get(slug));
-  const activeSlug = settings.themePack ?? DEFAULT_THEME_PACK_SLUG;
+  const activeSlug = resolveConfiguredThemePack({
+    themePack: settings.themePack,
+    colorMode: settings.colorMode
+  });
   if (!enabled.some((e) => e.slug === activeSlug)) {
+    const migrationHint = activeSlug === CONFIGURED_DEFAULT_THEME_PACK_SLUG && settings.themePacks !== void 0 ? ` "${CONFIGURED_DEFAULT_THEME_PACK_SLUG}" is the default pack when themePack is omitted; add it to themePacks, or set themePack explicitly to an enabled pack (themePack: "default" keeps the Classic look).` : "";
     throw new Error(
-      `zudo-doc: settings.themePack "${activeSlug}" is not one of the enabled theme packs. Enabled packs: ${enabled.map((e) => e.slug).join(", ") || "(none)"}.`
+      `zudo-doc: settings.themePack "${activeSlug}" is not one of the enabled theme packs. Enabled packs: ${enabled.map((e) => e.slug).join(", ") || "(none)"}.` + migrationHint
     );
   }
   return enabled;

package/dist/tree-nav-shared/index.d.ts

@@ -9,10 +9,14 @@ export declare function connectorLabelStart(depth: number, widthScale: number, g
 export declare function CategoryLinkIcon({ class: className }: {
     class?: string;
 }): import("@takazudo/zfb").Description;
-export declare function ConnectorLines({ depth, isLast, widthScale, topPad, }: {
+export declare function ConnectorLines({ depth, isLast, widthScale, topPad, left: leftOverride, width: widthOverride, }: {
     depth: number;
     isLast: boolean;
     widthScale?: number;
+    /** Overrides the depth-derived x position of the vertical line. */
+    left?: string;
+    /** Overrides the horizontal connector's length. */
+    width?: string;
     /**
      * Padding-top of the inner content row that holds the link text. The horizontal
      * connector and (when `isLast`) the vertical clip both anchor to the first-line

package/dist/tree-nav-shared/index.js

@@ -29,17 +29,20 @@ function ConnectorLines({
   depth,
   isLast,
   widthScale = 1,
-  topPad = "0px"
+  topPad = "0px",
+  left: leftOverride,
+  width: widthOverride
 }) {
   if (depth === 0) return null;
-  const left = connectorLeft(depth);
-  const width = connectorWidth(widthScale);
+  const left = leftOverride ?? connectorLeft(depth);
+  const width = widthOverride ?? connectorWidth(widthScale);
   const firstLineMid = `calc(${topPad} + 0.5lh)`;
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(
       "div",
       {
         class: "absolute border-l border-dashed border-muted",
+        "data-tree-connector": true,
         style: {
           left,
           top: "0px",
@@ -51,6 +54,7 @@ function ConnectorLines({
       "div",
       {
         class: "absolute border-t border-dashed border-muted",
+        "data-tree-connector": true,
         style: {
           left,
           width,

package/dist/wind.json

@@ -67,6 +67,7 @@
     "col-span-full",
     "col-start-1",
     "contents",
+    "cursor-default",
     "cursor-not-allowed",
     "cursor-pointer",
     "disabled:cursor-default",
@@ -91,7 +92,6 @@
     "focus-visible:outline-accent",
     "focus-visible:outline-offset-2",
     "focus-visible:text-accent",
-    "focus-visible:text-fg",
     "focus-visible:underline",
     "focus-within:border-accent",
     "focus-within:z-local-1",
@@ -147,9 +147,11 @@
     "h-[0.5rem]",
     "h-[0.625rem]",
     "h-[0.875rem]",
+    "h-[1.0625rem]",
     "h-[1.125rem]",
     "h-[1.25rem]",
     "h-[1.575rem]",
+    "h-[1.875rem]",
     "h-[10rem]",
     "h-[14px]",
     "h-[1em]",
@@ -290,6 +292,7 @@
     "my-vsp-md",
     "no-underline",
     "object-contain",
+    "opacity-50",
     "opacity-60",
     "outline-none",
     "overflow-auto",
@@ -455,11 +458,13 @@
     "w-[0.5rem]",
     "w-[0.625rem]",
     "w-[0.875rem]",
+    "w-[1.0625rem]",
     "w-[1.125rem]",
     "w-[1.25rem]",
     "w-[1.575rem]",
     "w-[1.5rem]",
     "w-[1.75rem]",
+    "w-[1.875rem]",
     "w-[12rem]",
     "w-[14px]",
     "w-[16px]",

package/dist/zdtp-loader.d.ts

@@ -1,7 +1,7 @@
 import type { PanelConfig, PanelInstanceHandle } from "@takazudo/zdtp";
 export * from "@takazudo/zdtp";
 /**
- * Mount zdtp's opaque Preact root only while the activating island still owns
+ * Mount zdtp's opaque panel root only while the activating island still owns
  * the pending import. Once configured, zdtp keeps its document-lifetime root
  * and its existing navigation cleanup semantics.
  */

package/eject/footer/footer.tsx

@@ -143,7 +143,7 @@ export function Footer(props: FooterProps): Child {
                         class="text-caption text-muted hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline"
                       >
                         #{tag}
-                        <span class="opacity-60" aria-hidden="true">
+                        <span data-zd-tag-count class="opacity-60" aria-hidden="true">
                           &nbsp;({count})
                         </span>
                       </a>