@takazudo/zudo-doc 8.1.2 → 9.0.0

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/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>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "8.1.2",
+  "version": "9.0.0",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -753,10 +753,10 @@
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "1.32.2",
     "@takazudo/zdtp": "^0.5.2 || ^0.6.0 || ^0.7.0 || ^0.8.0",
-    "@takazudo/zfb": "^5.1.4",
-    "@takazudo/zfb-md-wasm": "^5.1.4",
-    "@takazudo/zfb-runtime": "^5.1.4",
-    "@takazudo/zudo-doc-history-server": "^8.0.0",
+    "@takazudo/zfb": "^5.1.5",
+    "@takazudo/zfb-md-wasm": "^5.1.5",
+    "@takazudo/zfb-runtime": "^5.1.5",
+    "@takazudo/zudo-doc-history-server": "^9.0.0",
     "diff": "^8.0.0",
     "katex": "^0.18.2 || ^0.19.0",
     "zod": "^4.3.6"
@@ -796,9 +796,9 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "1.32.2",
     "@takazudo/mdx-formatter": "1.3.0",
-    "@takazudo/zfb": "5.1.4",
-    "@takazudo/zfb-md-wasm": "5.1.4",
-    "@takazudo/zfb-runtime": "5.1.4",
+    "@takazudo/zfb": "5.1.5",
+    "@takazudo/zfb-md-wasm": "5.1.5",
+    "@takazudo/zfb-runtime": "5.1.5",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
@@ -808,7 +808,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "8.1.2"
+    "@takazudo/zudo-doc-history-server": "9.0.0"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",