@takazudo/zudo-doc 5.5.2 → 5.6.0

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[];

package/dist/routes/_docs-helpers.js

@@ -2,10 +2,6 @@ import {
   getCollection,
   getContentSnapshot
 } from "@takazudo/zfb/content";
-import {
-  buildSidebarTree
-} from "../sidebar-tree/index.js";
-import { toRouteSlug } from "../slug/index.js";
 function snapshotAnchor(name) {
   return getContentSnapshot()?.collections[name];
 }
@@ -22,140 +18,6 @@ function stableDocs(collectionName) {
   docsByAnchor.set(anchor, built);
   return built;
 }
-function isNavVisible(doc) {
-  return !doc.data.unlisted && !doc.data.standalone;
-}
-function toNavNode(node) {
-  return {
-    slug: node.id,
-    label: node.label,
-    description: node.description,
-    position: node.sidebar_position ?? 999,
-    href: node.href,
-    hasPage: node.hasPage,
-    children: node.children.map(toNavNode),
-    sortOrder: node.sortOrder ?? "asc"
-  };
-}
-function findRootIndexDoc(docs) {
-  let found;
-  for (const d of docs) {
-    const slug = d.data.slug ?? toRouteSlug(d.slug);
-    if (slug === "") found = d;
-  }
-  return found;
-}
-function toRootNavNode(doc, locale, buildHref, categoryMeta) {
-  const meta = categoryMeta?.get("");
-  const noPage = doc.data.category_no_page ?? meta?.noPage;
-  const sortOrder = doc.data.category_sort_order ?? meta?.sortOrder ?? "asc";
-  return {
-    slug: "",
-    label: doc.data.sidebar_label ?? doc.data.title ?? meta?.label ?? "",
-    description: doc.data.description ?? meta?.description,
-    position: doc.data.sidebar_position ?? meta?.position ?? 999,
-    href: noPage ? void 0 : buildHref("", locale),
-    hasPage: noPage !== true,
-    children: [],
-    sortOrder
-  };
-}
-function buildNavTree(docs, locale, categoryMeta, buildHref, options) {
-  const href = options?.buildHref ?? buildHref;
-  const sidebarTree = buildSidebarTree(
-    docs,
-    locale,
-    {
-      categoryMeta,
-      buildHref: (slug, loc) => href(slug, loc),
-      // Host call sites own visibility; disable the builder's default filter so
-      // breadcrumb (unfiltered) and nav (pre-filtered) paths are unchanged.
-      isNavVisible: () => true
-    }
-  );
-  const result = sidebarTree.map(toNavNode);
-  const rootDoc = findRootIndexDoc(docs);
-  if (rootDoc) {
-    result.push(toRootNavNode(rootDoc, locale, href, categoryMeta));
-    result.sort((a, b) => {
-      const posCompare = a.position - b.position;
-      if (posCompare !== 0) return posCompare;
-      return a.slug.localeCompare(b.slug);
-    });
-  }
-  return result;
-}
-function groupSatelliteNodes(tree, prefixes) {
-  const result = [...tree];
-  for (const prefix of prefixes) {
-    const primaryIdx = result.findIndex((n) => n.slug === prefix);
-    if (primaryIdx < 0) continue;
-    const primary = result[primaryIdx];
-    if (!primary) continue;
-    const satelliteIdxs = [];
-    for (let i = 0; i < result.length; i++) {
-      const node = result[i];
-      if (node && i !== primaryIdx && node.slug.startsWith(`${prefix}-`)) {
-        satelliteIdxs.push(i);
-      }
-    }
-    if (satelliteIdxs.length === 0) continue;
-    const extraChildren = [];
-    for (const idx of satelliteIdxs) {
-      const node = result[idx];
-      if (node) extraChildren.push(node);
-    }
-    result[primaryIdx] = { ...primary, children: [...primary.children, ...extraChildren] };
-    for (const idx of satelliteIdxs.reverse()) result.splice(idx, 1);
-  }
-  return result;
-}
-function findNode(nodes, slug) {
-  for (const node of nodes) {
-    if (node.slug === slug) return node;
-    const found = findNode(node.children, slug);
-    if (found) return found;
-  }
-  return void 0;
-}
-function firstRoutedHref(node) {
-  for (const child of node.children) {
-    if (child.hasPage && child.href) return child.href;
-    const nested = firstRoutedHref(child);
-    if (nested) return nested;
-  }
-  return void 0;
-}
-function collectAutoIndexNodes(nodes) {
-  const result = [];
-  for (const node of nodes) {
-    if (!node.hasPage && node.children.length > 0 && node.href) result.push(node);
-    result.push(...collectAutoIndexNodes(node.children));
-  }
-  return result;
-}
-function buildBreadcrumbs(tree, slug, homeHref, hrefFor) {
-  const parts = slug.split("/");
-  const crumbs = [{ label: "", href: homeHref }];
-  let nodes = tree;
-  for (let i = 0; i < parts.length; i++) {
-    const partialSlug = parts.slice(0, i + 1).join("/");
-    const node = nodes.find((n) => n.slug === partialSlug);
-    if (!node) break;
-    const isLast = i === parts.length - 1;
-    const href = isLast ? void 0 : hrefFor && node.href !== void 0 ? hrefFor(node.slug) : node.href;
-    crumbs.push({ label: node.label, href });
-    nodes = node.children;
-  }
-  return crumbs;
-}
 export {
-  buildBreadcrumbs,
-  buildNavTree,
-  collectAutoIndexNodes,
-  findNode,
-  firstRoutedHref,
-  groupSatelliteNodes,
-  isNavVisible,
   stableDocs
 };