@takazudo/zudo-doc 3.3.0 → 4.0.0

package/dist/preset.d.ts

@@ -3,7 +3,7 @@
  *
  * `zudoDocPreset()` returns the zfb config fragment that every zudo-doc
  * project previously hand-wrote in its `zfb.config.ts` (collections loop,
- * markdown.features, dual-theme codeHighlight, resolveMarkdownLinks,
+ * markdown.features, class-mode codeHighlight, resolveMarkdownLinks,
  * stripMdExt, trailingSlash, minifyHtml, and the integration plugins array). The host
  * config spreads this fragment into `defineConfig` and supplies only the
  * project-specific shell fields it still owns (`framework`, `port`,
@@ -34,6 +34,7 @@
  */
 import { z } from "zod";
 import type { ColorScheme } from "./color-scheme-utils.js";
+import type { TagVocabularyEntry } from "./settings.js";
 /** A single locale's content directory (`settings.locales[code]`). */
 export interface PresetLocaleConfig {
     dir: string;
@@ -79,7 +80,6 @@ export interface PresetSettings {
     minifyHtml?: boolean;
     mermaid: boolean;
     onBrokenMarkdownLinks: "warn" | "error" | "ignore";
-    headingIdStrategy: "flat" | "hierarchical";
     llmsTxt?: boolean;
     changelogs?: PresetChangelogConfig[] | false;
     docHistory?: boolean;
@@ -121,6 +121,20 @@ export interface PresetSettings {
     /** When `false`, disables zfb's CJK-friendly line-break behaviour.
      *  Absent means "use the engine default" (currently `true`). */
     cjkFriendly?: boolean;
+    /**
+     * Active theme pack slug (ADR docs/adr/theme-packs.md, Decision 2/7).
+     * Threaded into the `@takazudo/zudo-doc/plugins/theme-packs` descriptor's
+     * options; the plugin's `setup()` validates it against the resolved
+     * registry and throws loudly on an unknown slug. Omit to use the package
+     * default (`"default"`).
+     */
+    themePack?: string;
+    /**
+     * Enabled pack slugs, in switcher order (ADR Decision 7). `undefined` = all
+     * bundled packs. Threaded into the `@takazudo/zudo-doc/plugins/theme-packs`
+     * descriptor's options alongside `themePack`.
+     */
+    themePacks?: string[];
 }
 /**
  * The directives recipe map (`markdown.features.directives`): directive name →
@@ -143,16 +157,7 @@ export type PresetTranslations = Record<string, Record<string, string>>;
  * data, threaded into the route-context virtual module when
  * `packageOwnedRoutes` is on. Optional — only consumed by the routes plugin.
  */
-export type PresetTagVocabularyEntry = {
-    id: string;
-    label?: string;
-    description?: string;
-    group?: string;
-    aliases?: readonly string[];
-    deprecated?: boolean | {
-        redirect?: string;
-    };
-};
+export type PresetTagVocabularyEntry = TagVocabularyEntry;
 /** Arguments to `zudoDocPreset`. */
 export interface ZudoDocPresetArgs {
     /** The project's `settings` object (structurally `PresetSettings`). */
@@ -216,8 +221,8 @@ export interface PresetMarkdown {
     cjkFriendly?: boolean;
 }
 export interface PresetCodeHighlight {
-    themeLight: string;
-    themeDark: string;
+    mode: "class";
+    defaultStylesheet: true;
 }
 /** The config fragment returned by {@link zudoDocPreset}. */
 export interface ZudoDocPresetResult {

package/dist/preset.js

@@ -15,13 +15,12 @@ function zudoDocPreset({
       features: buildMarkdownFeatures(settings, directiveVocabulary),
       ...settings.cjkFriendly !== void 0 ? { cjkFriendly: settings.cjkFriendly } : {}
     },
-    // Dual-theme syntect (zfb >= 0.1.0-next.45). Theme names are SYNTECT
-    // built-ins, NOT Shiki names. Tokens emit `--shiki-light`/`--shiki-dark`
-    // CSS custom properties resolved by the host CSS via `light-dark()`, so
-    // code follows the in-page light/dark switch with zero client JS.
+    // zfb class mode keeps renderer output semantic and delegates color to
+    // the package's --zfb-hi-* → --zd-syntax-* CSS adapter. Keep the upstream
+    // layered stylesheet enabled as the fallback beneath zudo's unlayered CSS.
     codeHighlight: {
-      themeLight: "base16-ocean.light",
-      themeDark: "base16-ocean.dark"
+      mode: "class",
+      defaultStylesheet: true
     },
     resolveMarkdownLinks: buildResolveMarkdownLinks(settings),
     // Strip `.md` / `.mdx` from in-page `<a href>` so author-written
@@ -105,9 +104,9 @@ function buildMarkdownFeatures(settings, directiveVocabulary) {
     imageDimensions: {},
     // warn-only: failOnBroken=false never fails the build.
     linkValidation: { failOnBroken: false },
-    // Heading-ID strategy is the single source of truth in settings, mirrored
-    // by the host TOC builder so anchors match the rendered IDs.
-    headingIds: { strategy: settings.headingIdStrategy }
+    // Hierarchical heading IDs are zudo-doc's sole contract. The host TOC
+    // builder mirrors the same allocator so anchors match the rendered IDs.
+    headingIds: { strategy: "hierarchical" }
   };
 }
 function buildPlugins(settings, routeContext) {
@@ -195,6 +194,22 @@ function buildPlugins(settings, routeContext) {
         base: settings.base
       }
     },
+    // Theme packs (ADR docs/adr/theme-packs.md, Decision 2, #2820) — a
+    // bare-specifier descriptor, added UNCONDITIONALLY like search-index
+    // above (never an imported plugin function, keeping this preset's
+    // node-free eval-graph guard green). The plugin internally no-ops
+    // (postBuild/devMiddleware write/serve nothing) when the resolved
+    // enabled set has no CSS-bearing pack (i.e. only "default" is enabled),
+    // so an unconfigured project pays no asset cost beyond the bundled
+    // registry scan at plugin setup.
+    {
+      name: "@takazudo/zudo-doc/plugins/theme-packs",
+      options: {
+        base: settings.base,
+        themePack: settings.themePack,
+        themePacks: settings.themePacks
+      }
+    },
     ...settings.llmsTxt ? [
       {
         name: "@takazudo/zudo-doc/plugins/llms-txt",

package/dist/route-context/index.js

@@ -1,5 +1,4 @@
 import { makeUrlHelpers } from "../url-helpers/index.js";
-import { loadCategoryMeta } from "../sidebar-tree/index.js";
 import { extractHeadings as extractHeadingsBase } from "../extract-headings/index.js";
 import { toRouteSlug, toSlugParams } from "../slug/index.js";
 import { resolveTag } from "../tag-helpers/index.js";
@@ -8,7 +7,6 @@ import {
   getNavSectionForSlug as getNavSectionForSlugBase,
   getNavSubtree as getNavSubtreeBase
 } from "../nav-scope/index.js";
-import { mergeLocaleDocs } from "../locale-merge/index.js";
 import {
   createNavSourceDocs
 } from "../nav-source-docs/index.js";
@@ -33,6 +31,7 @@ function createRouteContext(payload, options = {}) {
   const translations = payload.translations;
   const tagVocabulary = payload.tagVocabulary;
   const colorSchemes = payload.colorSchemes;
+  const themePackRegistry = payload.themePackRegistry ?? null;
   const stableDocs = options.stableDocs ?? defaultStableDocs;
   const defaultLocale = settings.defaultLocale;
   const locales = [
@@ -64,8 +63,7 @@ function createRouteContext(payload, options = {}) {
   function extractHeadings(body) {
     return extractHeadingsBase(body, {
       tocMinDepth: settings.tocMinDepth,
-      tocMaxDepth: settings.tocMaxDepth,
-      strategy: settings.headingIdStrategy
+      tocMaxDepth: settings.tocMaxDepth
     });
   }
   function getVocab() {
@@ -78,11 +76,10 @@ function createRouteContext(payload, options = {}) {
     const tagMap = /* @__PURE__ */ new Map();
     for (const entry of entries) {
       const rawTags = entry.data.tags ?? [];
-      const slug = slugFn(entry.id, entry.data);
+      const slug = slugFn(entry.slug, entry.data);
       const seen = /* @__PURE__ */ new Set();
       for (const raw of rawTags) {
         const resolved = resolveTagBound(raw);
-        if (resolved.deprecated) continue;
         if (seen.has(resolved.canonical)) continue;
         seen.add(resolved.canonical);
         if (!tagMap.has(resolved.canonical)) {
@@ -106,6 +103,7 @@ function createRouteContext(payload, options = {}) {
   const base = {
     settings,
     colorSchemes,
+    themePackRegistry,
     i18n,
     defaultLocale,
     locales,

package/dist/route-enumerators/index.d.ts

@@ -3,20 +3,8 @@ import type { DocPageEntry, DocNavNode } from "../doc-page-props/index.js";
 import type { CategoryMeta } from "../sidebar-tree/index.js";
 import type { Settings } from "../settings.js";
 export type { DocPageEntry, DocNavNode, NavSourceDocs };
-/**
- * Minimal docs entry shape needed for tag enumeration (no Content/module_specifier).
- */
-export interface DocsEntryForTags {
-    id: string;
-    data: {
-        slug?: string;
-        draft?: boolean;
-        unlisted?: boolean;
-        category_no_page?: boolean;
-        tags?: string[];
-        [key: string]: unknown;
-    };
-}
+/** Current zfb docs entry used by tag enumeration. */
+export type DocsEntryForTags = DocPageEntry;
 /**
  * Minimal version config shape needed for route enumeration.
  */
@@ -59,11 +47,11 @@ export interface RouteEnumeratorsContext {
     /** Returns true for paths that are only shown in the default locale. */
     isDefaultLocaleOnlyPath: (path: string) => boolean;
     /** Aggregate a `tag → docs` index from a doc collection. */
-    collectTags: (docs: DocsEntryForTags[], slugFn: (id: string, data: {
+    collectTags: (docs: DocsEntryForTags[], slugFn: (entrySlug: string, data: {
         slug?: string;
     }) => string) => Map<string, TagInfoForEnum>;
     /** Convert a content entry slug to a canonical route slug. */
-    toRouteSlug: (id: string) => string;
+    toRouteSlug: (entrySlug: string) => string;
     /** Build the nav tree for a locale (4-arg form with an explicit href builder). */
     buildNavTree: (docs: DocPageEntry[], locale: string, categoryMeta: Map<string, CategoryMeta> | undefined, buildHref: (slug: string, locale: string) => string) => DocNavNode[];
     /** Collect auto-generated index nodes. */
@@ -122,10 +110,10 @@ export interface RouteEnumeratorsAPI {
  * import { docsUrl, versionedDocsUrl, withBase, isDefaultLocaleOnlyPath } from "@/utils/base";
  * import { buildNavTree, collectAutoIndexNodes } from "@/utils/docs";
  * import { collectTags } from "@/utils/tags";
- * import { toRouteSlug } from "@/utils/slug";
+ * import { toRouteSlug } from "@takazudo/zudo-doc/slug";
  * import { loadDocs } from "../_data";
  * import { resolveNavSource, resolveVersionedLocaleSource } from "./_nav-source-docs";
- * import { mergeLocaleDocs } from "./locale-merge";
+ * import { mergeLocaleDocs } from "@takazudo/zudo-doc/locale-merge";
  *
  * export const {
  *   enumerateDocsRoutes,

package/dist/route-enumerators/index.js

@@ -1,4 +1,4 @@
-import { mergeLocaleDocs as mergeLocaleDocsImpl } from "../locale-merge/index.js";
+import { mergeLocaleDocs } from "../locale-merge/index.js";
 function createRouteEnumerators(ctx) {
   const defaultLocale = ctx.defaultLocale;
   const getLocaleKeys = () => Object.keys(ctx.settings.locales);
@@ -15,7 +15,6 @@ function createRouteEnumerators(ctx) {
   const collectAutoIndexNodes = ctx.collectAutoIndexNodes;
   const resolveNavSource = ctx.resolveNavSource;
   const resolveVersionedLocaleSource = ctx.resolveVersionedLocaleSource;
-  const mergeLocaleDocs = mergeLocaleDocsImpl;
   function enumerateDocsRoutes(locale) {
     const urls = [];
     const { docs: allDocs, navDocs, categoryMeta } = resolveNavSource(
@@ -26,7 +25,7 @@ function createRouteEnumerators(ctx) {
     const tree = buildNavTree(navDocs, locale, categoryMeta);
     for (const doc of allDocs) {
       if (doc.data.category_no_page === true) continue;
-      urls.push(docsUrl(doc.data.slug ?? toRouteSlug(doc.id), locale));
+      urls.push(docsUrl(doc.data.slug ?? toRouteSlug(doc.slug), locale));
     }
     for (const node of collectAutoIndexNodes(tree)) {
       urls.push(docsUrl(node.slug, locale));
@@ -52,7 +51,10 @@ function createRouteEnumerators(ctx) {
       });
       docs = result.docs.filter((d) => !d.data.category_no_page);
     }
-    const tagMap = collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
+    const tagMap = collectTags(
+      docs,
+      (entrySlug, data) => data.slug ?? toRouteSlug(entrySlug)
+    );
     for (const tag of tagMap.keys()) {
       const encoded = encodeURIComponent(tag);
       const tagPath = locale === defaultLocale ? `/docs/tags/${encoded}` : `/${locale}/docs/tags/${encoded}`;
@@ -70,7 +72,7 @@ function createRouteEnumerators(ctx) {
       const tree = buildNavTree(navDocs, defaultLocale, categoryMeta);
       for (const doc of allDocs) {
         if (doc.data.category_no_page === true) continue;
-        const slug = doc.data.slug ?? toRouteSlug(doc.id);
+        const slug = doc.data.slug ?? toRouteSlug(doc.slug);
         urls.push(versionedDocsUrl(slug, version.slug));
       }
       for (const node of collectAutoIndexNodes(tree)) {
@@ -88,7 +90,7 @@ function createRouteEnumerators(ctx) {
       const tree = buildNavTree(navDocs, locale, categoryMeta);
       for (const doc of allDocs) {
         if (doc.data.category_no_page === true) continue;
-        const slug = doc.data.slug ?? toRouteSlug(doc.id);
+        const slug = doc.data.slug ?? toRouteSlug(doc.slug);
         urls.push(versionedDocsUrl(slug, version.slug, locale));
       }
       for (const node of collectAutoIndexNodes(tree)) {

package/dist/routes/404.js

@@ -1,6 +1,7 @@
 import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
 import { DocLayoutWithDefaults } from "../doclayout/index.js";
-import { settings, defaultLocale, withBase } from "./_context.js";
+import { resolveThemePackSsrSlug } from "../theme/theme-pack-provider.js";
+import { settings, defaultLocale, withBase, themePackRegistry } from "./_context.js";
 import {
   HeadWithDefaults,
   HeaderWithDefaults,
@@ -18,6 +19,7 @@ function NotFoundPage() {
       title: composeMetaTitle(title),
       head: /* @__PURE__ */ jsx(HeadWithDefaults, { title }),
       lang: locale,
+      dataThemePack: resolveThemePackSsrSlug(themePackRegistry, settings),
       noindex: true,
       hideSidebar: true,
       hideToc: true,

package/dist/routes/_chrome.js

@@ -4,8 +4,8 @@ import { DocHistory } from "../doc-history/index.js";
 import { defineChromeBindings } from "@takazudo/zudo-doc/chrome-bindings";
 import { chromeBindings } from "virtual:zudo-doc-chrome-bindings";
 const chrome = createChrome(routeCtx, {
-  ...defineChromeBindings({ DocHistory }),
-  ...chromeBindings
+  ...chromeBindings,
+  ...defineChromeBindings({ DocHistory })
 });
 const {
   composeMetaTitle,

package/dist/routes/_context.d.ts

@@ -1,5 +1,6 @@
 import type { Settings } from "../settings.js";
 import type { ColorScheme } from "../color-scheme-utils.js";
+import type { ThemePackRegistry } from "../theme-packs-registry/index.js";
 import { type RouteContextPayload } from "../route-context/index.js";
 export type { RouteContextPayload, TagInfo } from "../route-context/index.js";
 /** The serializable route-context payload (from the virtual module). */
@@ -10,19 +11,22 @@ export declare const settings: Settings;
 /** Host color-scheme palette map. `null` when not supplied — `_chrome.tsx`
  *  falls back to `DEFAULT_SCHEME` in that case. */
 export declare const colorSchemes: Record<string, ColorScheme> | null;
+/** Resolved, enabled, ordered theme-pack registry. `null` when the routes
+ *  plugin did not thread one (ADR `docs/adr/theme-packs.md`, Decision 2). */
+export declare const themePackRegistry: ThemePackRegistry | null;
 export declare const i18n: import("../factory-context/index.js").FactoryI18n, defaultLocale: string, locales: readonly string[], getLocaleConfig: (locale: string) => {
     label: string;
     dir: string;
 } | undefined, getLocaleLabel: (locale: string) => string, t: (key: string, locale?: string) => string, urlHelpers: import("../url-helpers/index.js").UrlHelpers, withBase: (path: string) => string, stripBase: (path: string) => string, docsUrl: (slug: string, lang?: string) => string, versionedDocsUrl: (slug: string, versionSlug: string, lang?: string) => string, navHref: (path: string, lang: string | undefined, currentVersion: string | undefined) => string, isDefaultLocaleOnlyPath: (path: string) => boolean, absoluteUrl: (pageUrl: string) => string | undefined, isExternal: (href: string) => boolean, resolveHref: (href: string) => string, buildLocaleLinks: (currentPath: string, currentLang: string) => import("../url-helpers/index.js").LocaleLink[], getCategoryOrder: () => string[], getNavSectionForSlug: (slug: string) => string | undefined, getNavSubtree: (tree: import("./_docs-helpers.js").DocNavNode[], categoryMatch?: string) => import("./_docs-helpers.js").DocNavNode[], extractHeadings: (body: string) => import("../extract-headings/index.js").HeadingItem[], resolveTagBound: (raw: string) => import("../tag-helpers/index.js").ResolvedTag, collectTags: (entries: ReadonlyArray<{
-    id: string;
+    slug: string;
     data: {
         slug?: string;
         title?: string;
         description?: string;
         tags?: string[];
     };
-}>, slugFn: (id: string, data: {
+}>, slugFn: (entrySlug: string, data: {
     slug?: string;
 }) => string) => Map<string, import("./_context.js").TagInfo>, resolveNavSource: (lang: string, currentVersion: string | undefined, options?: import("../nav-source-docs/index.js").NavSourceOptions) => import("../nav-source-docs/index.js").NavSourceDocs, resolveVersionedLocaleSource: (versionSlug: string, versionDocsDir: string | undefined, lang: string, localeDir: string | undefined, options?: import("../nav-source-docs/index.js").NavSourceOptions) => import("../nav-source-docs/index.js").NavSourceDocs, loadNavSourceDocs: (lang: string, currentVersion: string | undefined) => import("../nav-source-docs/index.js").NavSourceDocs, buildDocRouteEntries: (args: import("../doc-route-entries/index.js").BuildDocRouteEntriesArgs) => import("../doc-route-entries/index.js").DocRouteEntry[], enumerateDocsRoutes: (locale: string) => string[], enumerateTagsRoutes: (locale: string) => string[], enumerateVersionedRoutes: (version: import("../route-enumerators/index.js").VersionConfigForEnum, locale: string) => string[], enumerateAllRoutes: () => Map<string, string>, buildNavTree: (docs: import("./_docs-helpers.js").DocPageEntry[], locale: string, categoryMeta: Map<string, import("./_docs-helpers.js").CategoryMeta> | undefined, buildHref: import("../factory-context/index.js").RouteHrefBuilder, options?: {
     buildHref?: import("../factory-context/index.js").RouteHrefBuilder;
-}) => import("./_docs-helpers.js").DocNavNode[], groupSatelliteNodes: (tree: import("./_docs-helpers.js").DocNavNode[], prefixes: string[]) => import("./_docs-helpers.js").DocNavNode[], findNode: (nodes: import("./_docs-helpers.js").DocNavNode[], slug: string) => import("./_docs-helpers.js").DocNavNode | undefined, firstRoutedHref: (node: import("./_docs-helpers.js").DocNavNode) => string | undefined, collectAutoIndexNodes: (nodes: import("./_docs-helpers.js").DocNavNode[]) => import("./_docs-helpers.js").DocNavNode[], isNavVisible: (doc: import("./_docs-helpers.js").DocPageEntry) => boolean, stableDocs: (collectionName: string) => import("./_docs-helpers.js").DocPageEntry[], toRouteSlug: (id: string) => string, toSlugParams: (routeSlug: string) => string[];
+}) => import("./_docs-helpers.js").DocNavNode[], groupSatelliteNodes: (tree: import("./_docs-helpers.js").DocNavNode[], prefixes: string[]) => import("./_docs-helpers.js").DocNavNode[], findNode: (nodes: import("./_docs-helpers.js").DocNavNode[], slug: string) => import("./_docs-helpers.js").DocNavNode | undefined, firstRoutedHref: (node: import("./_docs-helpers.js").DocNavNode) => string | undefined, collectAutoIndexNodes: (nodes: import("./_docs-helpers.js").DocNavNode[]) => import("./_docs-helpers.js").DocNavNode[], isNavVisible: (doc: import("./_docs-helpers.js").DocPageEntry) => boolean, stableDocs: (collectionName: string) => import("./_docs-helpers.js").DocPageEntry[], toRouteSlug: (entrySlug: string) => string, toSlugParams: (routeSlug: string) => string[];

package/dist/routes/_context.js

@@ -6,6 +6,7 @@ const ctx = routeContext;
 const routeCtx = createRouteContext(ctx);
 const settings = routeCtx.settings;
 const colorSchemes = routeCtx.colorSchemes;
+const themePackRegistry = routeCtx.themePackRegistry;
 const {
   i18n,
   defaultLocale,
@@ -88,6 +89,7 @@ export {
   stableDocs,
   stripBase,
   t,
+  themePackRegistry,
   toRouteSlug,
   toSlugParams,
   urlHelpers,

package/dist/routes/_docs-helpers.js

@@ -9,29 +9,17 @@ import { toRouteSlug } from "../slug/index.js";
 function snapshotAnchor(name) {
   return getContentSnapshot()?.collections[name];
 }
-const bridgedByAnchor = /* @__PURE__ */ new WeakMap();
-function bridgeEntry(e, collectionName) {
-  return {
-    slug: e.slug,
-    id: toRouteSlug(e.slug),
-    collection: collectionName,
-    data: e.data,
-    body: e.body,
-    module_specifier: e.module_specifier,
-    Content: e.Content
-  };
-}
-function buildBridged(collectionName) {
-  const raw = getCollection(collectionName);
-  return raw.map((e) => bridgeEntry(e, collectionName)).filter((d) => !d.data.draft);
+const docsByAnchor = /* @__PURE__ */ new WeakMap();
+function buildDocs(collectionName) {
+  return getCollection(collectionName).filter((entry) => !entry.data.draft);
 }
 function stableDocs(collectionName) {
   const anchor = snapshotAnchor(collectionName);
-  if (anchor === void 0) return buildBridged(collectionName);
-  const cached = bridgedByAnchor.get(anchor);
+  if (anchor === void 0) return buildDocs(collectionName);
+  const cached = docsByAnchor.get(anchor);
   if (cached) return cached;
-  const built = buildBridged(collectionName);
-  bridgedByAnchor.set(anchor, built);
+  const built = buildDocs(collectionName);
+  docsByAnchor.set(anchor, built);
   return built;
 }
 function isNavVisible(doc) {
@@ -52,7 +40,7 @@ function toNavNode(node) {
 function findRootIndexDoc(docs) {
   let found;
   for (const d of docs) {
-    const slug = d.data.slug ?? d.id.replace(/\/index$/, "");
+    const slug = d.data.slug ?? toRouteSlug(d.slug);
     if (slug === "") found = d;
   }
   return found;
@@ -75,7 +63,7 @@ function toRootNavNode(doc, locale, buildHref, categoryMeta) {
 function buildNavTree(docs, locale, categoryMeta, buildHref, options) {
   const href = options?.buildHref ?? buildHref;
   const sidebarTree = buildSidebarTree(
-    docs.map((d) => ({ id: d.id, data: d.data })),
+    docs,
     locale,
     {
       categoryMeta,

package/dist/safelist.css

@@ -1,2 +1,2 @@
 /* generated by gen-safelist.mjs — do not edit by hand */
-@source inline("-link -mb-px -ml-hsp-sm -noscript -open -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a]:text-accent [&_a]:underline [&_nav]:mb-0 [data-admonition] [data-kbd-shortcut] [doc-history-meta] [doc-history] [doc-layout] [llms-txt] [zudo-doc] a a2 abbr about above absent absolute accent accent- accent:accent- across activated active actual added admonition admonition- admonition-body admonition-title admonition/callout after after-breadcrumb after-content after-navigate after-sidebar after-title against agent agents ai-chat ai-chat-md ai-chat-trigger alert align-top all allow-same-origin allow-scripts alone already already-executed already-multiline already-picked an anchor anchored and and/or animate-spin announce ansehen antialiased any anywhere anzeigen application/json application/xml applies apply-css-vars approach are area arg aria-atomic aria-busy aria-controls aria-current aria-disabled aria-expanded aria-haspopup aria-hidden aria-label aria-live aria-orientation aria-pressed aria-selected aria-valuemax aria-valuemin aria-valuenow arm arms array arrows article as asc aside aspect-[1200/630] aspect-square asset- assets assistant async at attach attribute attributes auf authored auto autogenerated available avoid await away b back backdrop:bg-bg/30 backdrop:bg-bg/80 backdrop:bg-overlay/60 backdrop:z-modal-backdrop background background-color backtick backticks baked banner bare base base- base64 base:base- based baseline batch be bearbeiten because been before below best between bg bg-[#fff] bg-accent bg-bg bg-chat-assistant-bg bg-chat-user-bg bg-code-bg bg-fg bg-info/10 bg-info/5 bg-muted bg-overlay/30 bg-surface bg-transparent bg-warning/10 bg-warning/5 bi bigint bin blank blanks blob block blockquote blocks blur body body-end-components body-end-scripts bold boolean bootstrap border border-accent border-b border-b-2 border-b-[5px] border-bg/30 border-collapse border-danger border-dashed border-fg border-info/30 border-l border-l-0 border-l-[3px] border-left-width border-muted border-none border-r border-radius border-solid border-t border-t-[2px] border-t-[3px] border-transparent border-warning/30 border-width border-y both bottom-vsp-xl boundaries box-border br brand breadcrumb:end breadcrumb:start break-words browser browsers btn bug build bundler but button buttons by bypassed byte-identical bytes cached call caller calls can cancellation cannot canonical canvas caption card card-grid carry cases cat-nav- catch category catppuccin-latte caught caution center center/contain ch chains change changed changelog changelogs changes checkbox child chrome ci circle cite class class-less claude claude-agents claude-commands claude-md claude-skills cleaned clear clear-css-vars clearing click client client-router client-side clip clobbering close closed closing code code-block-sr-announce code-group code-group-panel col col-resize colgroup collapses collision color color-scheme color-scheme-changed color-scheme-provider color-tweak colorization colors column comma command commands comment commit compare component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher compute computed concrete configuration configure configured confuse connect const construction consumer consumes container containers containing content content-admonition content-link content-type content-wrapper:end content-wrapper:start contents context controller controls converts copy corners correct correctly corrupt count covered covers cp crashes created cross-component crumb- cs css ctx cur current cursor-not-allowed cursor-pointer custom danger dark data data-active data-admonition data-base data-close-search data-current-locale data-default-locale data-find-active data-find-match data-group-id data-header data-header-logo data-header-nav data-header-right data-kbd-shortcut data-language-switcher data-loading-index data-mermaid-enlarge-ready data-mermaid-rendered data-mermaid-src data-nav-active data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-no-results data-open-search data-pan-active data-processed data-result-count-template data-search-count data-search-count-narrow data-search-dialog data-search-input data-search-placeholder data-search-results data-search-unavailable data-sidebar-hidden data-sidebar-resizer data-site-nav data-tab-btn data-tab-default data-tab-label data-tab-value data-tabs data-taglist-group data-testid data-theme data-theme/style data-trailing-slash data-variant data-version-banner data-version-latest data-version-menu data-version-rewire data-version-slug data-version-switcher data-version-toggle data-version-trigger-label data-zd-nosidebar data-zd-toc data-zd-wide data-zfb-transition-persist dd decimal declare decoration decoration-muted default default-transition-duration defaults del delegated delete dependency depth der desc description design design-token design-token-panel design-token-trigger desktop desktop-sidebar desktop-sidebar-toggle desktop-sidebar-toggle-island destructive detach detached details detected deterministic develop dfn diagram diagrams dialog die dieser diff diff-line-added diff-line-content diff-line-empty diff-line-num diff-line-removed diff-row dir directly directories directory disabled disabled:opacity-50 disc display:none dist distinct div dl do doc doc-card- doc-content-band doc-history doc-history-generate doc-history-panel doc-history-trigger doc-page doc-pager doc-prose doc-title docs docs- docs-v- document document-level documentation documented does double-registration draft drag draggable drop dropdown dropdown-child dropdown-parent dropdowns dt duration-150 duration-200 during dynamically e2e each ease-in-out edge einer eject ejected el element elements els else em embedded emit emitting empty empty/undefined en enable end enlarged entire entities entries entry error escape escaped even eventually every exactly excerpt excludes existing exists exit expected export extends f factories failed faithful fall fallback fallbacks falling falls false family fast feature feed fg fields fieldset figcaption figure file fill fills finally find find-match find-match-active fire fires first fixed fixed-width fixtures flag flash flat flex flex-1 flex-col flex-wrap flip flipping flips flush-left focus focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2 focus-visible:underline focus:border-accent focus:outline-none focus:underline font font-bold font-family font-medium font-mono font-sans font-scale font-semibold font-size font-weight font-weight-bold font-weight-medium font-weight-normal font-weight-semibold footer footer- for form format found free fresh from frontmatter frontmatter-preview frozen fs-extra full fully function further g gap-[0.3em] gap-[clamp(1.5rem,3vw,4rem)] gap-hsp-2xs gap-hsp-md gap-hsp-sm gap-hsp-xl gap-hsp-xs gap-vsp-2xs gap-vsp-lg gap-vsp-md gap-vsp-xs gap-x-hsp-2xs gap-x-hsp-lg gap-x-hsp-md gap-x-hsp-sm gap-x-hsp-xs gap-y-vsp-2xs gap-y-vsp-lg gap-y-vsp-md gap-y-vsp-xs gaps gate geladen2026 generate generated generation genuine geometry get github github-dark github-link go got graph gray-matter grid grid-cols-1 grid-cols-2 group group-focus-visible:text-accent group-focus-visible:underline group-focus-within:block group-hover:bg-fg group-hover:block group-hover:text-accent group-hover:text-bg group-hover:underline group-open:rotate-90 guard h-[0.5rem] h-[0.625rem] h-[0.875rem] h-[1.125rem] h-[1.25rem] h-[1.575rem] h-[14px] h-[1em] h-[1lh] h-[2rem] h-[3.5rem] h-[3rem] h-[90vh] h-[calc(100%-3rem)] h-[calc(100vh-3.5rem)] h-dvh h-full h-icon-lg h-icon-md h-icon-sm h-icon-xs h1 h1s h2 h2s h3 h4 h5 h6 half hand hand-copied handle handled handler handlers has hash-link have head head-links head-scripts header header- header-call:end header-call:start heading heading-h2 heading-h3 heading-h4 headings height here hex hidden hierarchical highlight highlighter history hit horizontal host hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)] hover:bg-accent-hover hover:bg-accent/10 hover:bg-surface hover:border-accent hover:border-accent-hover hover:border-fg hover:text-accent hover:text-accent-hover hover:text-fg hover:underline hr href hrefs hsp hsp-2xl hsp-2xs hsp-lg hsp-md hsp-sm hsp-xl hsp-xs html i i18n/theme. i2 i3 i4 icon icon-lg icon-md icon-sm icon-xs identical idle idx if iframe image image-enlarge image-overlay-inset image/png img implementation import important imports in inactive inbox includes index index2026 info inherit inherited initial initialised injected inline inline-block inline-flex inner input input-clear ins inset-0 inside install instance instanceof instead instructions intended intent into invalid inverse inversion invoke is issues it italic item item- items items-baseline items-center items-start its itself javascript justify-between justify-center justify-end justify-start katex kbd keep keeps kept keyboard keyboard-shortcut keydown keystroke keywords khroma kopieren label landing language-switcher last:border-b-0 later latest launch layout leading-normal leading-relaxed leading-snug leading-tight leaf- leak leaves left left-0 left:calc legend legitimate length letter-spacing lg lg:block lg:border lg:border-fg lg:border-solid lg:flex lg:flex-col lg:flex-row lg:gap-hsp-xl lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))] lg:h-[90vh] lg:hidden lg:justify-start lg:m-auto lg:max-h-[90vh] lg:max-w-[52.5rem] lg:ml-[var(--zd-sidebar-w)] lg:pt-vsp-2xl lg:px-hsp-2xl lg:py-vsp-2xl lg:text-left lg:w-[90vw] lg:w-[clamp(16rem,25%,22rem)] li li2 library light like likely line line-height line/statement linger link link- links list-disc list-none listener literal literals lives llms llms-txt load local local-1 local-2 local-3 locale locales log longest-match look lostpointercapture lower luminance m m-0 m21 m6 main major make malformed malicious maps mark marks matches matching math math-display math-inline max max-h-[80vh] max-h-[85vh] max-h-[90vh] max-h-full max-h-none max-w-[46rem] max-w-[85%] max-w-[85vw] max-w-[90vw] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none max-width may mb-0 mb-vsp-2xs mb-vsp-lg mb-vsp-md mb-vsp-sm mb-vsp-xl mb-vsp-xs measures measuring mechanism menu merged mermaid message messages meta meta-knob metadata migration min-h-[60vh] min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[3rem] min-w-[8rem] minifier minor mirror mirrors missing mit ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-sm ml-hsp-xl mod modal modal-backdrop mode module monospace most mounted mouseenter mouseleave mr-hsp-sm ms mt-0 mt-vsp-2xl mt-vsp-2xs mt-vsp-3xs mt-vsp-lg mt-vsp-md mt-vsp-sm mt-vsp-xl must mutates mutation mutations muted mx-auto my-vsp-lg my-vsp-md name named native nav nav-active nav-card- nav/doc navigating navigation navigations near needs nested neutral new newly-swapped next nicht no no-enlarge no-op no-repeat no-underline noch node node:buffer node:fs node:fs/promises node:module node:path nodes nofollow noindex non-empty non-light-dark non-persisted none noopener noreferrer normal noscript not not-object notable note notes now null number numeric object object-contain observe observer occurred of off og:description og:image og:image:alt og:image:height og:image:width og:title og:type og:url oklch ol old older on once one only onto opacity-60 open open/close option or original other others out outline-none over overflow overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y:auto overwrite own p p-0 p-hsp-lg p-hsp-md p-hsp-sm p-hsp-xl package package-owned packages padding page page-loading page-loading-overlay page-loading-spinner page-navigate-end page-title pages pages/. paint paint-and-read palette pan panel panels paren-balance-aware parent parse parsed pass passed passes patch path paths pattern pb-[50vh] pb-vsp-md pb-vsp-xl pb-vsp-xs per per-link permanently persisted pi pick picked picks picocolors pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-sm pl-hsp-xl place placeholder placeholder:text-muted plain plural plus pnpm pointer-events-none pointercancel pointerdown pointermove pointerup polite polygon polyline popover populates port position position:fixed pr-[4px] pr-hsp-lg pr-hsp-md pr-hsp-sm pr-hsp-xl pre pre-lowercased preact preact/compat preact/hooks preact/jsx-runtime preconnect prefix preload pres preserving previously print produce produced produces production project project-root-relative properties property props prose provided proxy pt-[0.15rem] pt-[2px] pt-vsp-3xs pt-vsp-md pt-vsp-sm pt-vsp-xl pt-vsp-xs ptag- public purely px px-hsp-2xl px-hsp-2xs px-hsp-lg px-hsp-md px-hsp-sm px-hsp-xl px-hsp-xs py-0 py-[2px] py-[4px] py-[calc(var(--spacing-vsp-xs)+0.15rem)] py-hsp-2xs py-hsp-sm py-hsp-xs py-vsp-2xs py-vsp-3xs py-vsp-lg py-vsp-md py-vsp-sm py-vsp-xl py-vsp-xs q query question r radius radius-full radius-lg ramp range raw re-encode/decode re-querying re-render re-renders re-run re-running re-selects reach reached reaches read reading ready real real-value received receives recorded recovers redefine ref- references refetch refreshes regenerate regenerates regex reinit reinits relative release released reload relying rem remove removed render rendered renders reorder repaint repair repeated repeating replaced replaces repopulate repository requires reserved reset resize resize-x resolve resolved resolves response restore restores result result-click results results-area retry return returns revision revisions rewrite right right- right-0 ro robots role roles root rotate-180 rotate-90 round round-trip rounded rounded-[0.75rem] rounded-bl-[0.25rem] rounded-bl-[1rem] rounded-bl-lg rounded-br-[0.25rem] rounded-br-[1rem] rounded-full rounded-lg rounded-t-[1rem] rounds route router routes routes-src running runs runtime s safe safer same same-locale samp sans-serif scale scanned schema-mismatch schema-missing scheme scored script script- script-eval script-evaluation script-injection scripts scroll scrollbar scrolled scrollend search search-index section section- see sehen select select-none selection-bg selection-fg self self-start semantic semibold sentinel separator serialised serialize server server-rendered set sets setting setup shadow-[0_1px_3px_color-mix(in_srgb,var(--color-fg)_8%,transparent)] shadow-lg shadow-md shape share shared sharing shiki ship shipped ships short shortcut should show shown shrink-0 sidebar sidebar- sidebar-toggle-island sidebar-tree-island sidebar-w signal similarity single single-line singular site-search site-tree-nav-island sitemap- sites size skill skills skipping skips slash slug sm:border sm:border-muted sm:flex-row sm:grid-cols-2 sm:h-auto sm:items-center sm:justify-between sm:max-h-[80vh] sm:max-w-[52rem] sm:mx-auto sm:my-[10vh] sm:rounded-lg small smooth snapshot snapshots so soft soft-nav solid some somehow source sources space-y-vsp-2xs spacing spacing-0 spacing-px span spans spec specifier specifiers splitter square sr-only src stable stale standalone start state state- state:state- status stay staying sticky still stop stored stray strict string strings strip stripe stroke-linecap stroke-linejoin stroke-width strong stronger style style-attribute styled styles stylesheet sub subagents subsequent success successful summary sup surface surfaces survives svg swap swapped swaps synchronous synchronously syntactically syntect t tab tab-item tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tag tag- tag-item- tagged tags tags:audit take tbody td temp-element template temporary temporary-element terminal terms test-results tested text text-accent text-bg text-body text-caption text-center text-chat-assistant-text text-chat-user-text text-code-fg text-danger text-decoration text-display text-fg text-fg/60 text-heading text-info text-left text-micro text-muted text-muted/50 text-right text-scale-2xl text-scale-2xs text-scale-lg text-scale-md text-scale-sm text-scale-xl text-scale-xs text-small text-title text-warning text/plain textarea tfoot th that the thead their them theme theme-color theme-toggle theme/token then there these they this through throw tighten time tip title to toast toc toggle toggle-ai-chat toggle-design-token-panel toggles token tokens tolerates too toolbar tooltip top-0 top-[3.5rem] top-full top-level total touches tp tr tracked tracking-wider trade-off transition transition-[background,color,border-color] transition-[left,color] transition-colors transition-transform translate-x-0 translated translations transparent treats tree tree-child- tree-item- tree-top- trigger trigger:ai-chat trigger:design-token-panel triggers true truncate truncated try turn twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two type typography u ul umschalten unavailable unchanged und undefined under underline underlines understand unit-tested unknown unlisted unmaintained unobserve unreadable unrelated unreleased unset up up-to-date uppercase usage use used user uses utf-8 utf8 utilities utility v v1 v2 val valid value value-reader values var variable variant verbatim version version- version-menu version-switcher versions vertical via video viewing viewport virtual:zudo-doc-chrome-bindings virtual:zudo-doc-design-token-panel-config virtual:zudo-doc-route-context visible vitesse-dark vocabulary von vsp vsp-2xl vsp-2xs vsp-3xs vsp-lg vsp-md vsp-sm vsp-xl vsp-xs w w-1/2 w-48 w-[0.5rem] w-[0.625rem] w-[0.875rem] w-[1.125rem] w-[1.575rem] w-[1.5rem] w-[1.75rem] w-[14px] w-[16px] w-[16rem] w-[18px] w-[1em] w-[280px] w-[2rem] w-[320px] w-[90vw] w-[var(--zd-sidebar-w)] w-dvw w-full w-icon-lg w-icon-md w-icon-sm w-icon-xs want warn warning was watching wbr wbr- we website weight went were what when where whereas whether which while whitespace-nowrap whitespace-pre whole wide wide-gamut width will wird with without word working worktrees would wrap wrapper wrappers written wrong wrote wurde xl:flex xl:hidden y-scrollbar yet you your z-dropdown z-local-1 z-modal z-modal-backdrop z-sidebar z-toolbar zd-content zd-desktop-sidebar-toggle zd-doc-content-band zd-enlarge-btn zd-enlarge-dialog zd-enlarge-dialog-close zd-enlargeable zd-html-preview-code zd-mermaid-dialog zd-mermaid-enlargeable zd-mermaid-tool-btn zd-mermaid-toolbar zd-mermaid-transform zd-mermaid-viewport zd-sidebar-content-wrapper zd-sidebar-open zfb zfb:after-swap zfb:before-preparation zod zoom zudo-design-tokens/v3 zudo-doc zudo-doc-design-token-panel-modal zudo-doc-design-tokens zudo-doc-design-tokens/v1 zudo-doc-design-tokens/v2 zudo-doc-design-tokens/v3 zudo-doc-sidebar-visible zudo-doc-sidebar-width zudo-doc-theme zudo-doc-theme-bridge zudo-doc-tweak zum");
+@source inline("-link -mb-px -ml-hsp-sm -noscript -open -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a]:text-accent [&_a]:underline [&_nav]:mb-0 [data-admonition] [data-kbd-shortcut] [data-switcher-launcher] [doc-history-meta] [doc-history] [doc-layout] [llms-txt] [zudo-doc] a a2 abbr about above absent absolute accent accent- accent:accent- across activated active actual added admonition admonition- admonition-body admonition-title admonition/callout after after-breadcrumb after-content after-navigate after-sidebar after-title against agent agents ai-chat ai-chat-md ai-chat-trigger alert align-top all allow-same-origin allow-scripts allowed alone already already-executed already-multiline already-picked also always an anchor and and/or animate-pulse animate-spin announce ansehen antialiased any anywhere anzeigen appear application/json application/xml applied applies apply approach are area arg argument aria-atomic aria-busy aria-controls aria-current aria-disabled aria-expanded aria-haspopup aria-hidden aria-label aria-labelledby aria-live aria-orientation aria-pressed aria-selected aria-valuemax aria-valuemin aria-valuenow arm arms arrows article as asc aside aspect-[1200/630] aspect-square asset- assets assistant async at attach attribute attributes auf authored auto autogenerated available avoid await away b back backdrop:bg-bg/30 backdrop:bg-bg/80 backdrop:bg-overlay/60 backdrop:z-modal-backdrop background background-color backtick backticks baked banner bare base base- base64 base:base- based batch be bearbeiten because been before below best between bg bg-[#fff] bg-accent bg-bg bg-chat-assistant-bg bg-chat-user-bg bg-code-bg bg-fg bg-info/10 bg-info/5 bg-muted bg-overlay/30 bg-surface bg-surface/50 bg-transparent bg-warning/10 bg-warning/5 bi bigint bin binaries bind blank blanks block blockquote blocks blur body body-end-components body-end-scripts bold boolean bootstrap border border-accent border-b border-b-2 border-b-[5px] border-bg/30 border-collapse border-danger border-dashed border-fg border-image border-info/30 border-l border-l-0 border-l-[3px] border-left-width border-muted border-none border-r border-radius border-solid border-t border-t-[2px] border-t-[3px] border-transparent border-warning/30 border-width border-y both bottom-hsp-lg bottom-vsp-xl boundaries box-border br brackets brand breadcrumb:end breadcrumb:start break-words brown browser browsers btn budget bug build built built-in bundler but button buttons by bypassed byte-identical bytes cached call callable called caller calls can cancellation cannot canonical canvas caption card card-grid carry cases cat-nav- catch category catppuccin-latte caught caution center center/contain ch chains change changed changelog changelogs changes child choose chrome ci circle cite class class-less class-mode claude claude-agents claude-commands claude-md claude-skills cleaned clear clearing click client client-router client-side clip clobbering close closed closing code code-block-sr-announce code-group code-group-panel col col-resize colgroup collapses collision color color-scheme color-scheme-changed color-scheme-provider color-tweak colorization colors column comma command commands comment commercial commercial-font-denylist commit compare component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher composition compute computed concrete config configuration configure configured confuse connect const construction consumer consumes container containers containing contains content content-admonition content-layer content-link content-type content-wrapper:end content-wrapper:start contents context contract controller controls converts copied copy corners correct correctly corrupt could count covered covers cp crashes created cross-component crumb- cs css css-presence ctx cur current cursor-not-allowed cursor-pointer custom danger dark data data-active data-admonition data-base data-close-search data-current-locale data-default-locale data-doc-description data-doc-pager data-find-active data-find-match data-footer data-group-id data-header data-header-logo data-header-nav data-header-right data-kbd-shortcut data-language-switcher data-loading-index data-mermaid-enlarge-ready data-mermaid-rendered data-mermaid-src data-nav-active data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-no-results data-open-search data-pan-active data-processed data-result-count-template data-search-count data-search-count-narrow data-search-dialog data-search-input data-search-placeholder data-search-results data-search-unavailable data-sidebar-hidden data-sidebar-resizer data-site-nav data-switcher-card data-switcher-launcher data-tab-btn data-tab-default data-tab-label data-tab-value data-tabs data-taglist-group data-testid data-theme data-theme-pack data-theme-pack-switcher data-theme/style data-trailing-slash data-variant data-version-banner data-version-latest data-version-menu data-version-rewire data-version-slug data-version-switcher data-version-toggle data-version-trigger-label data-zd-nosidebar data-zd-theme-pack-css data-zd-theme-pack-css-loading data-zd-toc data-zd-wide data-zfb-transition-persist dd decimal declaration declare declares decoration decoration-muted default default-transition-duration defaults del delegated delete dependency depth der desc description design design-token-panel design-token-trigger desktop desktop-sidebar desktop-sidebar-toggle desktop-sidebar-toggle-island destructive detach detached details determine deterministic develop dfn diagram diagrams dialog die dieser diff diff-line-added diff-line-content diff-line-empty diff-line-num diff-line-removed diff-row dir directly directories directory disabled disabled:opacity-50 disabled:pointer-events-none disc display:none dist distinct div dl do doc doc-card- doc-content-band doc-history doc-history-generate doc-history-panel doc-history-trigger doc-page doc-pager doc-prose doc-title docs docs- docs-v- document document-level documentation documented does dog double-registration draft drag draggable drop dropdown dropdown-child dropdown-parent dropdowns dt duplicate duration-150 duration-200 during dynamically e2e each ease-in-out edge einer eject ejectable ejectables ejected el element elements els else em embedded emit emitting empty empty/undefined en enable enabled end enlarged entire entities entries entry equal error escape escaped even eventually every exactly exceeds excerpt excludes exclusively existing exists exit expected export extends f factories failed fall fallback fallbacks falling falls false family fast feature fg field fields fieldset figcaption figure file fill fills finally find find-match find-match-active fire fires first fixed fixed-width fixtures flag flash flat flex flex-1 flex-col flex-wrap flip flipping flips flush-left focus focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2 focus-visible:underline focus:border-accent focus:outline-none focus:underline font font-bold font-face-parity font-family font-medium font-mono font-sans font-scale font-semibold font-size font-weight font-weight-bold font-weight-medium font-weight-normal font-weight-semibold font/woff2 fonts footer footer- for form format found fox free fresh from frontmatter frontmatter-preview frozen fs-extra full fully function further g gap-[0.3em] gap-[clamp(1.5rem,3vw,4rem)] gap-hsp-2xs gap-hsp-lg gap-hsp-md gap-hsp-sm gap-hsp-xl gap-hsp-xs gap-vsp-2xs gap-vsp-3xs gap-vsp-lg gap-vsp-md gap-vsp-xs gap-x-hsp-2xs gap-x-hsp-lg gap-x-hsp-md gap-x-hsp-sm gap-x-hsp-xs gap-y-vsp-2xs gap-y-vsp-lg gap-y-vsp-md gap-y-vsp-xs gaps gate geladen2026 generate generated generation genuine geometry get github github-dark github-link go got gradient graph gray-matter grid grid-cols-1 grid-cols-2 group group-focus-visible:text-accent group-focus-visible:underline group-focus-within:block group-hover:bg-fg group-hover:block group-hover:text-accent group-hover:text-bg group-hover:underline group-open:rotate-90 guard h-10 h-40 h-[0.5rem] h-[0.625rem] h-[0.875rem] h-[1.125rem] h-[1.25rem] h-[1.575rem] h-[14px] h-[1em] h-[1lh] h-[2rem] h-[3.5rem] h-[3rem] h-[90vh] h-[calc(100%-3rem)] h-[calc(100vh-3.5rem)] h-dvh h-full h-icon-lg h-icon-md h-icon-sm h-icon-xs h1 h1s h2 h22013h4 h2s h3 h4 h5 h6 half hand-copied hand-editable handle handled handler handlers has hash-link have head head-links head-scripts header header- header-call:end header-call:start header-right heading heading-h2 heading-h3 heading-h4 heading-rule headings height here hex hidden hierarchical highlight history hit home horizontal host hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)] hover:bg-accent-hover hover:bg-accent/10 hover:bg-danger/10 hover:bg-surface hover:border-accent hover:border-accent-hover hover:border-fg hover:text-accent hover:text-accent-hover hover:text-fg hover:underline hr href hrefs hsp hsp-2xl hsp-2xs hsp-lg hsp-md hsp-sm hsp-xl hsp-xs html i i18n/theme. i2 i3 i4 icon icon-lg icon-md icon-sm icon-xs identical idle idx if iframe image image-enlarge image-overlay-inset image/png img implementation import important important-allowlist imports in inactive inbox includes incomplete index index2026 info inherit inherited initial initialised injected inline inline-block inline-flex inner input input-clear ins inserted-after-color-mode inserted-after-color-scheme inserted-first inset-0 inside install installation installed instance instanceof instead instructions intended intent internal interpolation into invalid inverse inversion invoke is issues it italic item item- items items-baseline items-center items-end items-start its itself javascript jumps justify-between justify-center justify-end justify-start katex kbd keep keeping keeps keyboard keyboard-shortcut keydown keys keystroke keyword keywords khroma known-token-names kopieren label landing language-switcher last:border-b-0 later latest launch layout lazy leading-normal leading-relaxed leading-snug leading-tight leaf- leak leaves left left-0 left:calc legend legitimate length letter-spacing lg lg:block lg:border lg:border-fg lg:border-solid lg:flex lg:flex-col lg:flex-row lg:gap-hsp-xl lg:grid-cols-3 lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))] lg:h-[90vh] lg:hidden lg:justify-start lg:m-auto lg:max-h-[90vh] lg:max-w-[52.5rem] lg:ml-[var(--zd-sidebar-w)] lg:pt-vsp-2xl lg:px-hsp-2xl lg:py-vsp-2xl lg:text-left lg:w-[90vw] lg:w-[clamp(16rem,25%,22rem)] li li2 library license light light/dark like likely line line-height line/statement linger link link- links list list-disc list-none listener lists literal literals lives llms llms-txt load loaded loading local local-1 local-2 local-3 locale locales log longer longest-match look lostpointercapture lower luminance m m-0 m-auto m21 m6 machinery main major make malformed malicious manually maps mark marks match matches matching math math-display math-inline max max-h-[85vh] max-h-[90vh] max-h-full max-h-none max-w-[64rem] max-w-[85%] max-w-[85vw] max-w-[90vw] max-w-[calc(100vw-2rem)] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none max-w-sm max-width may mb-0 mb-vsp-2xs mb-vsp-lg mb-vsp-md mb-vsp-sm mb-vsp-xl mb-vsp-xs measures measuring mechanism menu mermaid message messages meta meta-knob meta-schema metadata migration min-h-0 min-h-[60vh] min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[3rem] min-w-[8rem] minifier minor mirror mirrors missing mit ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-sm ml-hsp-xl mod modal modal-backdrop mode modify module monospace more most mounted mouseenter mouseleave mr-hsp-sm ms mt-0 mt-vsp-2xl mt-vsp-2xs mt-vsp-3xs mt-vsp-lg mt-vsp-md mt-vsp-xl must mutates mutation mutations muted mx-auto my-vsp-lg my-vsp-md n name named names native nav nav-active nav-card- nav/doc navigating navigation navigations near needs nested neutral new newly-swapped next nicht no no-color-scheme no-data-theme-selector no-enlarge no-op no-repeat no-underline noch node node:buffer node:fs node:fs/promises node:module node:path node:url nodes nofollow noindex non-empty non-light-dark non-literal non-persisted none noopener noreferrer normal noscript not notable note notes now null number numeric object object-contain observe observer occurred of off ofl-required og:description og:image og:image:alt og:image:height og:image:width og:title og:type og:url oklch ol old older on once one only onto opacity-60 open open/close option or original other others out outgoing outline-none over overflow overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y:auto overrides overscroll-contain overwrite own owned p p-0 p-hsp-2xs p-hsp-lg p-hsp-md p-hsp-sm pack package package-owned packages packs padding page page-loading page-loading-overlay page-loading-spinner page-navigate-end page-title pages pages/. paint paint-and-read palette pan panel panels paren-balance-aware parent parse parsed parser part pass passed passes patch path paths pattern payload payload-budget pb-[50vh] pb-vsp-md pb-vsp-xl pb-vsp-xs per per-link permanently persisted pi pick picked picks picocolors pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-sm pl-hsp-xl place placeholder placeholder:text-muted plain plural plus pnpm point pointer-events-none pointercancel pointerdown pointermove pointerup polite polygon polyline popover populates port position position:fixed pr-[4px] pr-hsp-lg pr-hsp-md pr-hsp-sm pr-hsp-xl pre pre-lowercased preact preact/compat preact/hooks preact/jsx-runtime preconnect prefix preload pres preserving preview preview-swatch-color previews2026 previously primary print produce produced produces production project project-owned project-root-relative properties property props prose provided proxy pt-[0.15rem] pt-[2px] pt-vsp-3xs pt-vsp-md pt-vsp-sm pt-vsp-xl pt-vsp-xs ptag- public purely px px-hsp-2xl px-hsp-2xs px-hsp-lg px-hsp-md px-hsp-sm px-hsp-xl px-hsp-xs py-0 py-[2px] py-[4px] py-[calc(var(--spacing-vsp-xs)+0.15rem)] py-hsp-2xs py-hsp-3xs py-hsp-sm py-hsp-xs py-vsp-2xs py-vsp-3xs py-vsp-lg py-vsp-md py-vsp-sm py-vsp-xl py-vsp-xs q query question quick r radius radius-full radius-lg ramp range raw re-encode/decode re-querying re-render re-renders re-run re-running re-selects reach reached reaches read reading real real-value received receives recorded recovers rect redefine redistribution ref- referenced references refetch refreshes regenerate regenerates regex registry reinit reinits rel relative release released reload relying rem remove removed render rendered renderer renderers renders reorder repaint repair repeated repeating replace replaced replacement replaces repopulate repository required requires reserved resize resize-x resolve resolved resolves responded response restore restores result result-click results results-area retry return returns revision revisions rewrite rewrites right right- right-0 right-hsp-lg ring-2 ring-accent risking ro robots role roles root rotate-180 rotate-90 round round-trip rounded rounded-[0.75rem] rounded-bl-[0.25rem] rounded-bl-[1rem] rounded-bl-lg rounded-br-[0.25rem] rounded-br-[1rem] rounded-full rounded-lg rounded-md rounded-t-[1rem] rounds route router routes routes-src running runs runtime s safe safely safer same same-locale samp sans sans-serif scale scanned scanning scheme scoped scoping scored script script- script-eval script-evaluation script-injection scripts scroll scrollbar scrolled scrollend search search-index section section- see sehen select select-none selection-bg selection-fg selector self self-hosted self-start semantic semibold semver sentinel separator serialised serialize server server-rendered set sets setting setup shadow-[0_1px_3px_color-mix(in_srgb,var(--color-fg)_8%,transparent)] shadow-lg shadow-md shape share shared sharing shiki ship shipped ships short shortcut should show shown shrink-0 sidebar sidebar- sidebar-toggle-island sidebar-tree-island sidebar-w signal similarity simple single single-line single-object-literal singular site site-search site-tree-nav-island sitemap- sites size skill skills skipping skips slash slug slug-dir-parity sm:border sm:border-muted sm:flex-row sm:grid-cols-2 sm:h-auto sm:items-center sm:justify-between sm:max-h-[80vh] sm:max-w-[52rem] sm:mx-auto sm:my-[10vh] sm:rounded-lg small smooth snapshot snapshots so soft soft-nav solid some somehow source sources space-y-vsp-2xs spacing spacing-0 spacing-px span spans spec specifiers splitter spread square sr-only src stable stale standalone start state state- state:state- status stay staying sticky still stock stop stored stray strict string strings strip stripe stroke-linecap stroke-linejoin stroke-width strong stronger style style-attribute styled styles stylesheet sub subagents subsequent substitute success successful summary sup supported surface surfaces survives svg swap swapped swaps switcher synchronous synchronously syntactically syntax t tab tab-item tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tag tag- tag-item- tagged tags tags:audit take tbody td temp-element template temporary temporary-element terminal terms test-results tested text text-accent text-bg text-body text-caption text-center text-chat-assistant-text text-chat-user-text text-code-fg text-danger text-decoration text-display text-fg text-fg/60 text-heading text-info text-left text-micro text-muted text-muted/50 text-right text-scale-2xl text-scale-2xs text-scale-lg text-scale-md text-scale-sm text-scale-xl text-scale-xs text-small text-title text-warning text/css text/plain textarea tfoot th than that the thead their them theme theme-color theme-pack theme-pack-changed theme-packs theme-packs/index.json theme-toggle theme/token then there these they this threw through throw tighten time tip title to toast toc toggle toggle-ai-chat toggle-design-token-panel toggles token tokens tolerates too toolbar tooltip top-0 top-[3.5rem] top-full top-level total touches tp tr tracked tracking-wide tracking-wider trade-off transition transition-[background,color,border-color] transition-[left,color] transition-colors transition-transform translate-x-0 translated translations transparent treats tree tree-child- tree-item- tree-top- trigger trigger:ai-chat trigger:design-token-panel triggers true truncate truncated try turn twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two type typeface typography u ul umschalten unavailable unbalanced unchanged und undefined under underline underlines understand unit-tested unknown unlisted unmaintained unobserve unreadable unrelated unreleased unset unterminated until up up-to-date uppercase use used user uses utf-8 utf8 utilities utility v v2 val value value-reader values var variable variant verbatim version version- version-menu version-switcher versions vertical via video viewing viewport virtual:zudo-doc-chrome-bindings virtual:zudo-doc-design-token-panel-config virtual:zudo-doc-route-context visible vitesse-dark vocabulary von vsp vsp-2xl vsp-2xs vsp-3xs vsp-lg vsp-md vsp-sm vsp-xl vsp-xs w w-1/2 w-10 w-48 w-72 w-[0.5rem] w-[0.625rem] w-[0.875rem] w-[1.125rem] w-[1.575rem] w-[1.5rem] w-[1.75rem] w-[14px] w-[16px] w-[16rem] w-[18px] w-[1em] w-[280px] w-[2rem] w-[320px] w-[90vw] w-[calc(100vw-2rem)] w-[var(--zd-sidebar-w)] w-dvw w-full w-icon-lg w-icon-md w-icon-sm w-icon-xs want warn warning was watching wbr wbr- we website weight went were what when where whereas whether which while whitespace-nowrap whitespace-pre whole wide wide-gamut width will wird wired with without word working worktrees would wrap wrapper wrappers written wrong wrote wurde xl:flex xl:hidden y-scrollbar yet you your z-dropdown z-local-1 z-modal z-modal-backdrop z-popover z-sidebar z-toolbar zd-content zd-desktop-sidebar-toggle zd-doc-content-band zd-enlarge-btn zd-enlarge-dialog zd-enlarge-dialog-close zd-enlargeable zd-html-preview-code zd-mermaid-dialog zd-mermaid-enlargeable zd-mermaid-tool-btn zd-mermaid-toolbar zd-mermaid-transform zd-mermaid-viewport zd-sidebar-content-wrapper zd-sidebar-open zd-theme-pack-dialog-title zfb zfb:after-swap zfb:before-preparation zod zoom zudo-design-tokens/v3 zudo-doc zudo-doc-design-token-panel-modal zudo-doc-design-tokens zudo-doc-sidebar-visible zudo-doc-sidebar-width zudo-doc-theme zudo-doc-theme-pack zudo-doc-tweak zum");

package/dist/settings.d.ts

@@ -18,22 +18,14 @@ export type TagGovernanceMode = "off" | "warn" | "strict";
  * - `description`— optional short description for tooling / tag index pages.
  * - `group`      — optional grouping key used by the grouped tag footer
  *                  (e.g. `"type"`, `"level"`, `"topic"`).
- * - `aliases`    — alternate strings that content files may use. Alias
- *                  resolution rewrites these to `id` before aggregation.
- * - `deprecated` — `true` marks the tag as deprecated with no redirect: the
- *                  canonical id is dropped from aggregation. Pass
- *                  `{ redirect: "<other-id>" }` to rewrite this tag to another
- *                  canonical id when it appears in content.
+ * Content must use `id` exactly. Retired or misspelled ids are unknown tags;
+ * the vocabulary intentionally has no alias or deprecation migration fields.
  */
 export interface TagVocabularyEntry {
     id: string;
     label?: string;
     description?: string;
     group?: string;
-    aliases?: readonly string[];
-    deprecated?: boolean | {
-        redirect?: string;
-    };
 }
 export interface HeaderNavChildItem {
     label: string;
@@ -44,7 +36,12 @@ export interface HeaderNavChildItem {
 export interface HeaderNavItem extends HeaderNavChildItem {
     children?: HeaderNavChildItem[];
 }
-export type HeaderRightComponentName = "theme-toggle" | "language-switcher" | "version-switcher" | "github-link" | "search";
+export type HeaderRightBuiltinComponentName = "theme-toggle" | "language-switcher" | "version-switcher" | "github-link" | "search";
+/**
+ * Serializable component name. Built-ins remain suggested, while host-owned
+ * names resolve through `ChromeHostBindings.headerRightComponents`.
+ */
+export type HeaderRightComponentName = HeaderRightBuiltinComponentName | (string & {});
 export type HeaderRightTriggerName = "design-token-panel" | "ai-chat";
 export interface HeaderRightComponentItem {
     type: "component";
@@ -301,7 +298,6 @@ export interface Settings {
     designTokenPanel: boolean;
     tocMinDepth: number;
     tocMaxDepth: number;
-    headingIdStrategy: "flat" | "hierarchical";
     sidebarResizer: boolean;
     sidebarToggle: boolean;
     imageEnlarge: boolean;
@@ -408,4 +404,23 @@ export interface Settings {
      * module. Irrelevant when `designTokenPanel` is `false`.
      */
     designTokenPanelConfigModule?: string;
+    /**
+     * Active theme-pack slug (ADR `docs/adr/theme-packs.md`). `"default"` is
+     * the stock zudo-doc look — no pack stylesheet is loaded. Must be a member
+     * of the resolved `themePacks` list; an unknown slug fails the build
+     * loudly at plugin setup (`src/plugins/routes.ts`).
+     */
+    themePack?: string;
+    /**
+     * Mount the bottom-right theme-pack switcher flyout (and its browse-all
+     * dialog) on every page.
+     */
+    themePackSwitcher?: boolean;
+    /**
+     * Enabled theme-pack slugs, in switcher order. `undefined` = every bundled
+     * pack, `"default"` first then the rest in canonical (alphabetical-by-slug)
+     * order. An explicit list is authoritative: may omit `"default"`, reorder
+     * freely; duplicate or unknown slugs fail the build loudly.
+     */
+    themePacks?: string[];
 }

package/dist/sidebar-tree/build-tree.d.ts

@@ -14,11 +14,10 @@ import type { BuildSidebarTreeOptions, CollectionEntryLike, SidebarFrontmatter,
  * Build a recursive sidebar tree from `entries`. Visibility filtering is
  * applied first; the resulting structure mirrors the filesystem.
  *
- * - Multi-segment ids (e.g. `getting-started/intro`) walk the tree creating
+ * - Multi-segment slugs (e.g. `getting-started/intro`) walk the tree creating
  *   intermediate category nodes as needed.
- * - Single-segment ids represent category index pages (Astro 5 strips
- *   `/index` from the id, so `getting-started/index.mdx` arrives as the id
- *   `getting-started`).
+ * - A trailing `/index` represents a category index page and is stripped from
+ *   the canonical route slug.
  * - Sibling order is determined by `sidebar_position` then alphabetical
  *   slug, with the parent's `sortOrder` (from `_category_.json`) flipping
  *   the comparator when set to `"desc"`.

package/dist/sidebar-tree/build-tree.js

@@ -1,5 +1,6 @@
-function toRouteSlug(id) {
-  return id.replace(/\/index$/, "");
+function toRouteSlug(slug) {
+  if (slug === "index") return "";
+  return slug.replace(/\/index$/, "");
 }
 function toTitleCase(str) {
   return str.split("-").map((word) => word.length === 0 ? word : word[0].toUpperCase() + word.slice(1)).join(" ");
@@ -24,7 +25,7 @@ function buildSidebarTree(entries, locale, options = {}) {
   };
   for (const entry of entries) {
     if (!isNavVisible(entry)) continue;
-    const slug = entry.data.slug ?? entry.slug ?? toRouteSlug(entry.id);
+    const slug = entry.data.slug ?? toRouteSlug(entry.slug);
     if (!slug) continue;
     const parts = slug.split("/");
     if (parts.length <= 1) {

package/dist/sidebar-tree/index.d.ts

@@ -9,8 +9,8 @@
  *     type SidebarNode,
  *   } from "@takazudo/zudo-doc/sidebar-tree";
  *
- * The builder takes a flat list of content collection entries (in either
- * Astro or zfb shape) plus a locale, and emits a recursive `SidebarNode[]`
+ * The builder takes a flat list of current zfb collection entries plus a
+ * locale, and emits a recursive `SidebarNode[]`
  * suitable for rendering or for further sidebar-config processing.
  */
 export { buildSidebarTree, findSidebarNode, flattenSidebarTree, } from "./build-tree.js";