@takazudo/zudo-doc 5.5.3 → 5.7.0

package/dist/i18n-version/version-switcher.js

@@ -1,5 +1,6 @@
 import { jsx, jsxs } from "preact/jsx-runtime";
 import { AFTER_NAVIGATE_EVENT } from "../transitions/page-events.js";
+import { CURRENT_PATH_SCRIPT_PRELUDE } from "../current-path/index.js";
 import { UNAVAILABLE_VERSIONS_ATTR } from "../version-availability/index.js";
 function computeVersionSwitcherState(pathname, config, versionSlugs) {
   const normalizedBase = config.base;
@@ -235,6 +236,7 @@ var FLAG="__zdVersionSwitcherRewire";
 if(window[FLAG])return;
 window[FLAG]=true;
 var ATTR=${JSON.stringify(UNAVAILABLE_VERSIONS_ATTR)};
+${CURRENT_PATH_SCRIPT_PRELUDE}
 var computeVersionSwitcherState=${computeVersionSwitcherState.toString()};
 function setActive(a,active){
 a.classList.toggle("font-bold",active);
@@ -276,7 +278,7 @@ for(var j=0;j<versionAnchors.length;j++){
 var s=versionAnchors[j].getAttribute("data-version-slug");
 if(s)slugs.push(s);
 }
-var state=computeVersionSwitcherState(window.location.pathname,config,slugs);
+var state=computeVersionSwitcherState(readCurrentPath(CURRENT_PATH_DATASET_KEY),config,slugs);
 var latest=c.querySelector("[data-version-latest]");
 if(latest){
 latest.setAttribute("href",state.latestHref);

package/dist/md-utils/index.js

@@ -2,8 +2,40 @@ import { readFileSync, readdirSync } from "node:fs";
 import { join, relative } from "node:path";
 import matter from "gray-matter";
 import { toRouteSlug } from "../slug/index.js";
+const NAMED_CHARACTER_REFERENCES = {
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'",
+  nbsp: "\xA0"
+};
+function decodeCharacterReferences(value) {
+  return value.replace(
+    /&#(?:([0-9]+)|[xX]([0-9a-fA-F]+));/g,
+    (reference, decimal, hexadecimal) => {
+      const digits = decimal ?? hexadecimal;
+      if (!digits) return reference;
+      const codePoint = Number.parseInt(digits, decimal ? 10 : 16);
+      if (codePoint > 1114111 || codePoint >= 55296 && codePoint <= 57343) {
+        return reference;
+      }
+      try {
+        return String.fromCodePoint(codePoint);
+      } catch {
+        return reference;
+      }
+    }
+  ).replace(
+    /&(lt|gt|quot|apos|nbsp);/g,
+    (reference, name) => NAMED_CHARACTER_REFERENCES[name] ?? reference
+  ).replace(/&amp;/g, "&");
+}
 function stripMarkdown(md) {
-  return md.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "").replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<[^>]+>/g, "").replace(/^#{1,6}\s+/gm, "").replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1").replace(/_{1,3}([^_]+)_{1,3}/g, "$1").replace(/!\[[^\]]*\]\([^)]+\)/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/^[\s]*[-*+]\s+/gm, "").replace(/^[\s]*\d+\.\s+/gm, "").replace(/^import\s+.*$/gm, "").replace(/^export\s+.*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
+  const withoutCodeCommentsAndTags = md.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "").replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<[^>]+>/g, "");
+  return decodeCharacterReferences(withoutCodeCommentsAndTags).replace(/^#{1,6}\s+/gm, "").replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1").replace(
+    /(^|[^\p{L}\p{N}])(_{1,3})(?=\S)([^_\n]*?\S)\2(?=$|[^\p{L}\p{N}])/gmu,
+    "$1$3"
+  ).replace(/!\[[^\]]*\]\([^)]+\)/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/^[\s]*[-*+]\s+/gm, "").replace(/^[\s]*\d+\.\s+/gm, "").replace(/^import\s+.*$/gm, "").replace(/^export\s+.*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
 }
 function collectMdFiles(dir) {
   const results = [];

package/dist/nav-source-docs/index.d.ts

@@ -1,18 +1,14 @@
 import type { CategoryMeta } from "../sidebar-tree/index.js";
 import type { DocPageEntry } from "../doc-page-props/index.js";
+import type { NavSourceDocs as NavSourceDocsShape } from "../site-schema/types.js";
 import type { Settings } from "../settings.js";
 export type { CategoryMeta, DocPageEntry };
-export interface NavSourceDocs {
-    /** Full doc list (merged + draft-filtered; unlisted retained per options). */
-    docs: DocPageEntry[];
-    /** `docs.filter(isNavVisible)` — stable instance for buildNavTree. */
-    navDocs: DocPageEntry[];
-    /** Stable category-meta Map for the active (locale, version). */
-    categoryMeta: Map<string, CategoryMeta>;
-    /** Slugs that came from the locale collection (for isFallback). Empty for
-     *  default-locale / single-collection cases. */
-    localeSlugSet: ReadonlySet<string>;
-}
+/**
+ * The resolved nav source for one (locale, version) context, carrying zfb
+ * collection entries. The shape itself is browser-safe and declared in
+ * `../site-schema/types.js` (#3395); this alias pins it to `DocPageEntry`.
+ */
+export type NavSourceDocs = NavSourceDocsShape<DocPageEntry>;
 /**
  * How to filter the merged doc list.
  */

package/dist/plugins/route-pages-candidates.d.ts

@@ -0,0 +1,19 @@
+/**
+ * File extensions zfb's router accepts as `pages/` route sources. Mirrors
+ * the Rust-side single source of truth `zfb_types::ROUTABLE_PAGE_EXTENSIONS`
+ * (zfb crate `crates/zfb-types/src/page_extensions.rs`) — that constant is
+ * not importable from JS, so it is copied here deliberately; keep in sync if
+ * zfb ever changes its accepted extension list.
+ */
+export declare const ROUTABLE_PAGE_EXTENSIONS: readonly ["tsx", "ts", "jsx", "js", "mdx", "md", "html"];
+/**
+ * Derive every `pages/`-relative path that would shadow the given injected
+ * route pattern (a zfb `injectRoute` pattern string, e.g.
+ * `"/docs/tags/[tag]"` or `"/[locale]"`). Pure — no filesystem I/O; the
+ * caller probes each candidate against the host's real `pages/` dir.
+ *
+ * Returns `[]` for the empty/root pattern (`"/"`) — never produced by this
+ * plugin's route catalog (zfb rejects `injectRoute("/")` outright), so there
+ * is nothing meaningful to derive.
+ */
+export declare function derivePagesCandidates(pattern: string): string[];

package/dist/plugins/route-pages-candidates.js

@@ -0,0 +1,17 @@
+const ROUTABLE_PAGE_EXTENSIONS = ["tsx", "ts", "jsx", "js", "mdx", "md", "html"];
+function derivePagesCandidates(pattern) {
+  const segments = pattern.split("/").filter(Boolean);
+  if (segments.length === 0) return [];
+  const lastSegment = segments[segments.length - 1];
+  const dirPrefix = segments.length > 1 ? `${segments.slice(0, -1).join("/")}/` : "";
+  const candidates = [];
+  for (const ext of ROUTABLE_PAGE_EXTENSIONS) {
+    candidates.push(`${dirPrefix}${lastSegment}.${ext}`);
+    candidates.push(`${dirPrefix}${lastSegment}/index.${ext}`);
+  }
+  return candidates;
+}
+export {
+  ROUTABLE_PAGE_EXTENSIONS,
+  derivePagesCandidates
+};

package/dist/plugins/routes.d.ts

@@ -1,2 +1,48 @@
+/** One injected route: a zfb route pattern + the package entrypoint specifier
+ *  that renders it, with optional zfb `injectRoute` opts. */
+interface RouteSpec {
+    pattern: string;
+    entrypoint: string;
+    opts?: {
+        prerender?: boolean;
+    };
+    /**
+     * Whether this route counts toward the DTP shadow diagnostic's denominator
+     * (#3434). REQUIRED, deliberately — a newly added route must state its
+     * membership, so forgetting one is a type error instead of the silent
+     * miss #3434 *is*.
+     *
+     * The name is scoped to the DIAGNOSTIC, not to the route's own nature,
+     * because that is all the flag actually asserts. In particular it is NOT
+     * `rendersPanel`: `/404` genuinely DOES render the configured DTP bootstrap
+     * (`routes/404.tsx` passes `bodyEndComponents={<BodyEndIslands …/>}`, and
+     * `routes/_chrome.tsx` feeds that chrome the configured wrapper), so a
+     * `rendersPanel: false` tag on it would be a false claim in the source. It
+     * is likewise not `kind: "doc-content"` — the counted set includes the
+     * locale home, the tag pages and the version pages.
+     *
+     * `false` for the four routes a reader never browses as documentation:
+     * `/sitemap.xml` and `/robots.txt` cannot render an HTML panel at all (they
+     * would hold the check at "not fully shadowed" forever), `/api/ai-chat` is a
+     * JSON endpoint, and `/404` is an error page — losing the panel there says
+     * nothing about whether the site's docs still have one. The never-injected
+     * `/` (see the note in `deriveRoutes`) is absent from the catalog entirely
+     * and so cannot be counted either.
+     */
+    includedInDtpShadowDiagnostic: boolean;
+}
+/**
+ * The DTP shadow diagnostic's warn/silent decision, extracted from `setup()`
+ * so the vacuity guard below is directly unit-testable (#3434).
+ *
+ * Returns `true` only when there is at least one reader-facing route AND every
+ * one of them is shadowed. The emptiness check is the whole reason this is a
+ * named function: `[].every(…)` is vacuously `true`, so an empty denominator
+ * would otherwise fire the warning for every host. That state is unreachable
+ * through `deriveRoutes` today (`/docs/[[...slug]]` is always emitted and
+ * always counted), which is exactly why it needs a test that calls this
+ * directly — a build-driven test cannot construct it.
+ */
+export declare function shouldWarnDtpFullyShadowed(routes: ReadonlyArray<Pick<RouteSpec, "pattern" | "includedInDtpShadowDiagnostic">>, isShadowed: (pattern: string) => boolean): boolean;
 declare const plugin: import("@takazudo/zfb").ZfbPlugin;
 export default plugin;

package/dist/plugins/routes.js

@@ -1,46 +1,61 @@
 import { createRequire } from "node:module";
-import { existsSync, statSync, cpSync, rmSync, mkdirSync } from "node:fs";
+import { existsSync, statSync, readFileSync, cpSync, rmSync, mkdirSync } from "node:fs";
 import { dirname, basename, join } from "node:path";
 import { definePlugin } from "@takazudo/zfb/plugins";
 import {
   loadThemePackRegistry,
   resolveEnabledPacks
 } from "../theme-packs-registry/index.js";
+import { derivePagesCandidates } from "./route-pages-candidates.js";
+function shouldWarnDtpFullyShadowed(routes, isShadowed) {
+  const counted = routes.filter((route) => route.includedInDtpShadowDiagnostic);
+  if (counted.length === 0) return false;
+  return counted.every((route) => isShadowed(route.pattern));
+}
+function isExactDefaultReExport(source, entrypoint) {
+  const withoutComments = source.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
+  const specifier = entrypoint.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const reExportPattern = new RegExp(
+    `export\\s*\\{[^}]*\\bdefault\\b(?!\\s+as\\s)[^}]*\\}\\s*from\\s*(["'])${specifier}\\1`
+  );
+  return reExportPattern.test(withoutComments);
+}
 function deriveRoutes(settings) {
   const routes = [];
   const localeCodes = Object.keys(settings.locales ?? {});
   const hasVersions = Array.isArray(settings.versions) && settings.versions.length > 0;
   const docTags = settings.docTags === true;
   const aiAssistant = settings.aiAssistant === true;
-  routes.push({ pattern: "/404", entrypoint: "@takazudo/zudo-doc/routes/404" });
-  routes.push({ pattern: "/sitemap.xml", entrypoint: "@takazudo/zudo-doc/routes/sitemap.xml" });
-  routes.push({ pattern: "/robots.txt", entrypoint: "@takazudo/zudo-doc/routes/robots.txt" });
-  routes.push({ pattern: "/docs/[[...slug]]", entrypoint: "@takazudo/zudo-doc/routes/docs-slug" });
+  routes.push({ pattern: "/404", entrypoint: "@takazudo/zudo-doc/routes/404", includedInDtpShadowDiagnostic: false });
+  routes.push({ pattern: "/sitemap.xml", entrypoint: "@takazudo/zudo-doc/routes/sitemap.xml", includedInDtpShadowDiagnostic: false });
+  routes.push({ pattern: "/robots.txt", entrypoint: "@takazudo/zudo-doc/routes/robots.txt", includedInDtpShadowDiagnostic: false });
+  routes.push({ pattern: "/docs/[[...slug]]", entrypoint: "@takazudo/zudo-doc/routes/docs-slug", includedInDtpShadowDiagnostic: true });
   if (docTags) {
-    routes.push({ pattern: "/docs/tags", entrypoint: "@takazudo/zudo-doc/routes/docs-tags-index" });
-    routes.push({ pattern: "/docs/tags/[tag]", entrypoint: "@takazudo/zudo-doc/routes/docs-tags-tag" });
+    routes.push({ pattern: "/docs/tags", entrypoint: "@takazudo/zudo-doc/routes/docs-tags-index", includedInDtpShadowDiagnostic: true });
+    routes.push({ pattern: "/docs/tags/[tag]", entrypoint: "@takazudo/zudo-doc/routes/docs-tags-tag", includedInDtpShadowDiagnostic: true });
   }
   if (aiAssistant) {
     routes.push({
       pattern: "/api/ai-chat",
       entrypoint: "@takazudo/zudo-doc/routes/api-ai-chat",
-      opts: { prerender: false }
+      opts: { prerender: false },
+      includedInDtpShadowDiagnostic: false
     });
   }
   if (hasVersions) {
-    routes.push({ pattern: "/docs/versions", entrypoint: "@takazudo/zudo-doc/routes/docs-versions" });
-    routes.push({ pattern: "/v/[version]/docs/[[...slug]]", entrypoint: "@takazudo/zudo-doc/routes/v-docs-slug" });
-    routes.push({ pattern: "/v/[version]/[locale]/docs/[[...slug]]", entrypoint: "@takazudo/zudo-doc/routes/v-locale-docs-slug" });
+    routes.push({ pattern: "/docs/versions", entrypoint: "@takazudo/zudo-doc/routes/docs-versions", includedInDtpShadowDiagnostic: true });
+    routes.push({ pattern: "/v/[version]/docs/[[...slug]]", entrypoint: "@takazudo/zudo-doc/routes/v-docs-slug", includedInDtpShadowDiagnostic: true });
+    routes.push({ pattern: "/v/[version]/[locale]/docs/[[...slug]]", entrypoint: "@takazudo/zudo-doc/routes/v-locale-docs-slug", includedInDtpShadowDiagnostic: true });
   }
   if (localeCodes.length > 0) {
-    routes.push({ pattern: "/[locale]", entrypoint: "@takazudo/zudo-doc/routes/locale-index" });
-    routes.push({ pattern: "/[locale]/docs/[[...slug]]", entrypoint: "@takazudo/zudo-doc/routes/locale-docs-slug" });
+    routes.push({ pattern: "/[locale]", entrypoint: "@takazudo/zudo-doc/routes/locale-index", includedInDtpShadowDiagnostic: true });
+    routes.push({ pattern: "/[locale]/docs/[[...slug]]", entrypoint: "@takazudo/zudo-doc/routes/locale-docs-slug", includedInDtpShadowDiagnostic: true });
     if (docTags) {
-      routes.push({ pattern: "/[locale]/docs/tags", entrypoint: "@takazudo/zudo-doc/routes/locale-docs-tags-index" });
-      routes.push({ pattern: "/[locale]/docs/tags/[tag]", entrypoint: "@takazudo/zudo-doc/routes/locale-docs-tags-tag" });
+      routes.push({ pattern: "/[locale]/docs/tags", entrypoint: "@takazudo/zudo-doc/routes/locale-docs-tags-index", includedInDtpShadowDiagnostic: true });
+      routes.push({ pattern: "/[locale]/docs/tags/[tag]", entrypoint: "@takazudo/zudo-doc/routes/locale-docs-tags-tag", includedInDtpShadowDiagnostic: true });
     }
     if (hasVersions) {
-      routes.push({ pattern: "/[locale]/docs/versions", entrypoint: "@takazudo/zudo-doc/routes/locale-docs-versions" });
+      routes.push({ pattern: "/[locale]/docs/versions", entrypoint: "@takazudo/zudo-doc/routes/locale-docs-versions", includedInDtpShadowDiagnostic: true });
     }
   }
   return routes;
@@ -74,6 +89,7 @@ const plugin = definePlugin({
     const translations = options.translations ?? {};
     const tagVocabulary = options.tagVocabulary ?? [];
     const colorSchemes = options.colorSchemes ?? null;
+    const derivedRoutes = deriveRoutes(settings);
     const themePacksDir = new URL("../theme-packs/", import.meta.url);
     const themePackRegistry = resolveEnabledPacks(
       loadThemePackRegistry(themePacksDir),
@@ -120,6 +136,43 @@ const plugin = definePlugin({
 ` : `export { buildDesignTokenPanelConfig } from "@takazudo/zudo-doc/design-token-panel-config";
 `
     );
+    if (settings.designTokenPanel === true && designTokenPanelConfigAbsPath) {
+      const pagesDir = join(ctx.projectRoot, "pages");
+      const routesByPattern = new Map(derivedRoutes.map((route) => [route.pattern, route]));
+      const readerRoutesAllShadowed = shouldWarnDtpFullyShadowed(derivedRoutes, (pattern) => {
+        const route = routesByPattern.get(pattern);
+        return derivePagesCandidates(pattern).some((rel) => {
+          const abs = join(pagesDir, rel);
+          if (!existsSync(abs)) return false;
+          let source;
+          try {
+            source = readFileSync(abs, "utf8");
+          } catch {
+            return true;
+          }
+          if (route && isExactDefaultReExport(source, route.entrypoint)) {
+            return false;
+          }
+          return true;
+        });
+      });
+      if (readerRoutesAllShadowed) {
+        let chromeBindingsSource;
+        if (chromeBindingsAbsPath !== void 0) {
+          try {
+            chromeBindingsSource = readFileSync(chromeBindingsAbsPath, "utf8");
+          } catch {
+            chromeBindingsSource = void 0;
+          }
+        }
+        const workaroundLikelyApplied = chromeBindingsSource !== void 0 && chromeBindingsSource.includes("DesignTokenPanelBootstrap");
+        if (!workaroundLikelyApplied) {
+          ctx.logger.warn(
+            'zudo-doc: settings.designTokenPanelConfigModule is set, but every reader-facing injected route\'s URL is shadowed by a kept user pages/ file \u2014 the configured Design Token Panel builder can never apply on any documentation page a reader browses on this site (zudolab/zudo-doc#3420). Thread your builder through chromeBindings.DesignTokenPanelBootstrap instead \u2014 that binding wins everywhere, including stub-rendered pages (see the designTokenPanelConfigModule docblock in settings.ts). If you already did this via a chromeBindingsModule that composes the bootstrap indirectly (never spelling "DesignTokenPanelBootstrap" literally in the resolved file), this warning is safe to ignore. A pages/ file that cleanly re-exports a shadowed route\'s own entrypoint (`export { default, paths, frontmatter } from "@takazudo/zudo-doc/routes/\u2026"`) does not count as a real shadow either \u2014 but that check is also a best-effort text scan, not module evaluation, so a file that reaches the same entrypoint some other way may still trigger this warning even though it is safe.'
+          );
+        }
+      }
+    }
     const require2 = createRequire(import.meta.url);
     let stagedRoutesDir;
     const ensureStaged = (routesSrcDir) => {
@@ -131,7 +184,7 @@ const plugin = definePlugin({
       stagedRoutesDir = dest;
       return dest;
     };
-    for (const route of deriveRoutes(settings)) {
+    for (const route of derivedRoutes) {
       let resolvedEntrypoint;
       try {
         const compiledPath = require2.resolve(route.entrypoint);
@@ -159,5 +212,6 @@ const plugin = definePlugin({
 });
 var routes_default = plugin;
 export {
-  routes_default as default
+  routes_default as default,
+  shouldWarnDtpFullyShadowed
 };

package/dist/preset.d.ts

@@ -34,7 +34,7 @@
  */
 import { z } from "zod";
 import type { ColorScheme } from "./color-scheme-utils.js";
-import type { TagVocabularyEntry } from "./settings.js";
+import type { TagVocabularyEntry, FaviconConfig } from "./settings.js";
 import type { DirectiveSpec } from "@takazudo/zfb/config";
 /** A single locale's content directory (`settings.locales[code]`). */
 export interface PresetLocaleConfig {
@@ -76,6 +76,17 @@ export interface PresetSettings {
     base: string;
     siteName: string;
     siteDescription: string;
+    /**
+     * Home-hero logo. `zudoDocPreset()` doesn't otherwise consume this field —
+     * rendering happens in `home-page/index.tsx` against the full `Settings`
+     * object — it is carried here only so `assertNoEmptyStringFaviconOrLogo`
+     * (`config-assertions/index.ts`) can validate a direct `zudoDocPreset()`
+     * call the same way `zudoDoc()` does (#3474).
+     */
+    logo?: string | false;
+    /** Favicon links. Same rationale as {@link PresetSettings.logo} — carried
+     *  only for `assertNoEmptyStringFaviconOrLogo` (#3474). */
+    favicon?: string | FaviconConfig | false;
     siteUrl: string;
     trailingSlash: boolean;
     minifyHtml?: boolean;

package/dist/preset.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { assertNoCommaInVersionSlugs } from "./version-availability/index.js";
+import { assertNoEmptyStringFaviconOrLogo } from "./config-assertions/index.js";
 function zudoDocPreset({
   settings,
   buildDocsSchema,
@@ -9,6 +10,7 @@ function zudoDocPreset({
   colorSchemes
 }) {
   assertNoCommaInVersionSlugs(settings.versions);
+  assertNoEmptyStringFaviconOrLogo(settings);
   const docsSchemaJson = z.toJSONSchema(buildDocsSchema());
   return {
     collections: buildCollections(settings, docsSchemaJson),

package/dist/route-context/index.js

@@ -16,8 +16,8 @@ import {
 import {
   createRouteEnumerators
 } from "../route-enumerators/index.js";
+import { stableDocs as defaultStableDocs } from "../routes/_docs-helpers.js";
 import {
-  stableDocs as defaultStableDocs,
   isNavVisible,
   buildNavTree,
   buildBreadcrumbs,
@@ -25,7 +25,7 @@ import {
   groupSatelliteNodes,
   findNode,
   firstRoutedHref
-} from "../routes/_docs-helpers.js";
+} from "../site-schema/nav-tree.js";
 function createRouteContext(payload, options = {}) {
   const settings = payload.settings;
   const translations = payload.translations;

package/dist/routes/_chrome.d.ts

@@ -1,4 +1,4 @@
-import type { DocNavNode } from "./_docs-helpers.js";
+import type { DocNavNode } from "../site-schema/types.js";
 export declare const composeMetaTitle: (title: string) => string, HeadWithDefaults: (props: import("../head-with-defaults/index.js").HeadWithDefaultsProps) => import("preact").JSX.Element, HeaderWithDefaults: (props: import("../header-with-defaults/index.js").HeaderWithDefaultsProps) => import("preact").JSX.Element, FooterWithDefaults: (props: {
     lang?: string;
 }) => import("preact").VNode, SidebarWithDefaults: (props: import("../sidebar-with-defaults/index.js").SidebarWithDefaultsProps) => import("preact").JSX.Element, renderDocPage: (props: import("../doc-page-props/index.js").DocPageBaseProps, opts: import("../doc-page-renderer/index.js").RenderDocPageOptions) => import("preact").JSX.Element, VersionsPageView: (props: import("../versions-page/index.js").VersionsPageViewProps) => import("preact").JSX.Element, collectTagMapForLocale: (locale: string) => Map<string, import("../tag-pages/index.js").TagInfo>, TagDetailPageView: (props: {

package/dist/routes/_chrome.js

@@ -3,7 +3,11 @@ import { createChrome } from "../chrome/index.js";
 import { DocHistory } from "../doc-history/index.js";
 import { defineChromeBindings } from "@takazudo/zudo-doc/chrome-bindings";
 import { chromeBindings } from "virtual:zudo-doc-chrome-bindings";
+import { ConfiguredDesignTokenPanelBootstrap } from "./_design-token-panel-bootstrap.js";
 const chrome = createChrome(routeCtx, {
+  ...defineChromeBindings({
+    DesignTokenPanelBootstrap: ConfiguredDesignTokenPanelBootstrap
+  }),
   ...chromeBindings,
   ...defineChromeBindings({ DocHistory })
 });

package/dist/routes/_context.d.ts

@@ -17,7 +17,7 @@ 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, versioned?: boolean) => 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<{
+} | 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, versioned?: boolean) => 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("./_chrome.js").DocNavNode[], categoryMatch?: string) => import("./_chrome.js").DocNavNode[], extractHeadings: (body: string) => import("../extract-headings/index.js").HeadingItem[], resolveTagBound: (raw: string) => import("../tag-helpers/index.js").ResolvedTag, collectTags: (entries: ReadonlyArray<{
     slug: string;
     data: {
         slug?: string;
@@ -27,6 +27,6 @@ export declare const i18n: import("../factory-context/index.js").FactoryI18n, de
     };
 }>, 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?: {
+}) => 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("../site-schema/doc-route-entries.js").BuildDocRouteEntriesArgs<import("../doc-page-props/index.js").DocPageEntry>) => import("../site-schema/doc-route-entries.js").DocRouteEntry<import("../doc-page-props/index.js").DocPageEntry>[], 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("../doc-page-props/index.js").DocPageEntry[], locale: string, categoryMeta: Map<string, import("../sidebar-tree/types.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: (entrySlug: string) => string, toSlugParams: (routeSlug: string) => string[];
+}) => import("./_chrome.js").DocNavNode[], groupSatelliteNodes: (tree: import("./_chrome.js").DocNavNode[], prefixes: string[]) => import("./_chrome.js").DocNavNode[], findNode: (nodes: import("./_chrome.js").DocNavNode[], slug: string) => import("./_chrome.js").DocNavNode | undefined, firstRoutedHref: (node: import("./_chrome.js").DocNavNode) => string | undefined, collectAutoIndexNodes: (nodes: import("./_chrome.js").DocNavNode[]) => import("./_chrome.js").DocNavNode[], isNavVisible: (doc: import("../doc-page-props/index.js").DocPageEntry) => boolean, stableDocs: (collectionName: string) => import("../doc-page-props/index.js").DocPageEntry[], toRouteSlug: (entrySlug: string) => string, toSlugParams: (routeSlug: string) => string[];

package/dist/routes/_design-token-panel-bootstrap.d.ts

@@ -0,0 +1,18 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+/**
+ * The design-token-panel island injected routes mount instead of the package
+ * default: identical behavior, except the mode-scoped `PanelConfig` builder is
+ * the one the routes plugin resolved — the host's
+ * `settings.designTokenPanelConfigModule` when set, the package default
+ * otherwise.
+ *
+ * Renders `null` on both SSR and client (the panel self-mounts as a side
+ * effect of `bootstrapDesignTokenPanel`), matching the package default's
+ * non-`ssrFallback` `Island({ when: "load" })` shape.
+ */
+export declare function ConfiguredDesignTokenPanelBootstrap(): JSX.Element | null;
+export declare namespace ConfiguredDesignTokenPanelBootstrap {
+    var displayName: string;
+}

package/dist/routes/_design-token-panel-bootstrap.js

@@ -0,0 +1,11 @@
+"use client";
+import { runDesignTokenPanelBootstrapOnce } from "../design-token-panel-bootstrap.js";
+import { buildDesignTokenPanelConfig } from "virtual:zudo-doc-design-token-panel-config";
+function ConfiguredDesignTokenPanelBootstrap() {
+  runDesignTokenPanelBootstrapOnce(buildDesignTokenPanelConfig, "configured");
+  return null;
+}
+ConfiguredDesignTokenPanelBootstrap.displayName = "ConfiguredDesignTokenPanelBootstrap";
+export {
+  ConfiguredDesignTokenPanelBootstrap
+};

package/dist/routes/_docs-helpers.d.ts

@@ -1,6 +1,4 @@
-import { type CategoryMeta } from "../sidebar-tree/index.js";
-import type { DocNavNode, DocPageEntry } from "../doc-page-props/index.js";
-export type { CategoryMeta, DocNavNode, DocPageEntry };
+import type { DocPageEntry } from "../doc-page-props/index.js";
 /**
  * Identity-stable, draft-filtered `DocPageEntry[]` for a collection. Returns the
  * SAME array instance on every call within one build (anchored on the snapshot
@@ -8,36 +6,3 @@ export type { CategoryMeta, DocNavNode, DocPageEntry };
  * deliberately unmemoized. Passed as `stableDocs` to `createNavSourceDocs`.
  */
 export declare function stableDocs(collectionName: string): DocPageEntry[];
-/** Filter predicate: true when a doc should appear in navigation. */
-export declare function isNavVisible(doc: DocPageEntry): boolean;
-/** A docs-href builder: `(slug, locale) => url`. */
-export type BuildHref = (slug: string, locale: string) => string;
-export interface BuildNavTreeOptions {
-    buildHref?: BuildHref;
-}
-/**
- * Build a recursive navigation tree from a flat doc collection. Delegates tree
- * construction to the shared `buildSidebarTree`; keeps the host-side concerns
- * (DocNavNode shape, root-index node synthesis). `buildHref` parameterizes the
- * href space (default: the injected `docsUrl`). Unlike the host copy this drops
- * the LRU / identity caches — the snapshot-anchored `stableDocs` already makes
- * the input arrays identity-stable so the factory-level `memoizeDerived` short-
- * circuits per build.
- */
-export declare function buildNavTree(docs: DocPageEntry[], locale: string, categoryMeta: Map<string, CategoryMeta> | undefined, buildHref: BuildHref, options?: BuildNavTreeOptions): DocNavNode[];
-/** Group "satellite" nodes (slug-prefix siblings) under their primary node. */
-export declare function groupSatelliteNodes(tree: DocNavNode[], prefixes: string[]): DocNavNode[];
-/** Find a node by slug anywhere in the tree. */
-export declare function findNode(nodes: DocNavNode[], slug: string): DocNavNode | undefined;
-/** Href of the first routed descendant, walking children depth-first. */
-export declare function firstRoutedHref(node: DocNavNode): string | undefined;
-/** Collect all category nodes that have children but no page (no index.mdx). */
-export declare function collectAutoIndexNodes(nodes: DocNavNode[]): DocNavNode[];
-export interface BreadcrumbItem {
-    label: string;
-    href?: string;
-}
-/** Build breadcrumb trail by walking the nav tree. `homeHref` is the locale
- *  docs root (injected). `hrefFor` optionally remaps intermediate crumbs into
- *  a versioned URL space. */
-export declare function buildBreadcrumbs(tree: DocNavNode[], slug: string, homeHref: string, hrefFor?: (slug: string) => string): BreadcrumbItem[];