@takazudo/zudo-doc 1.2.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -207,6 +207,14 @@
       "types": "./dist/mdx-components/index.d.ts",
       "default": "./dist/mdx-components/index.js"
     },
+    "./route-context": {
+      "types": "./dist/route-context/index.d.ts",
+      "default": "./dist/route-context/index.js"
+    },
+    "./chrome": {
+      "types": "./dist/chrome/index.d.ts",
+      "default": "./dist/chrome/index.js"
+    },
     "./safelist.css": "./dist/safelist.css",
     "./safelist": "./dist/safelist.css",
     "./content.css": "./dist/content.css",
@@ -515,9 +523,9 @@
   ],
   "peerDependencies": {
     "preact": "^10.29.1",
-    "@takazudo/zfb": "^0.1.0-next.69",
-    "@takazudo/zfb-runtime": "^0.1.0-next.69",
-    "@takazudo/zudo-doc-history-server": "^1.1.0",
+    "@takazudo/zfb": "^0.1.0-next.70",
+    "@takazudo/zfb-runtime": "^0.1.0-next.70",
+    "@takazudo/zudo-doc-history-server": "^1.2.0",
     "@takazudo/zdtp": "^0.3.3",
     "shiki": "^4.0.2",
     "zod": "^4.3.6",
@@ -559,8 +567,8 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zfb": "0.1.0-next.69",
-    "@takazudo/zfb-runtime": "0.1.0-next.69"
+    "@takazudo/zfb": "0.1.0-next.70",
+    "@takazudo/zfb-runtime": "0.1.0-next.70"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json",

package/routes-src/_chrome.tsx

@@ -1,558 +1,37 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// routes/_chrome — package-default chrome wiring for the package-owned page
-// route entrypoints (epic Package-First Finale #2356, A1 #2361).
+// routes/_chrome — thin chrome shim for the package-owned route entrypoints
+// (epic Package-First Finale #2356, A1 #2361).
 //
-// The page routes (index / 404 / docs / versions / tags) render through the
-// package's render factories (`doc-page-renderer`, `versions-page`,
-// `tag-pages`) + chrome factories (`head/header/footer/sidebar-with-defaults`,
-// `doc-page-shell`, …). The HOST stubs (`pages/lib/_*`) wire those factories
-// with host singletons AND a handful of host-only bindings the ADR's
-// serializable virtual module deliberately does NOT carry:
-//
-//   - the project `colorSchemes` palette map (HeadWithDefaults CSS generation),
-//   - the `sidebars` config (sidebar section resolution),
-//   - the `#doc-history-meta` JSON manifest (DocMetainfoArea / DocHistoryArea),
-//   - the project `frontmatter-preview-renderers`,
-//   - project island bootstraps wired through `BodyEndIslands`.
-//
-// Those are host-content / project-config bindings, NOT serializable settings,
-// so per the ADR (Decision 1: "components are package defaults"; showcase-only
-// slots resolve to a package stub) this module supplies PACKAGE DEFAULTS for
-// them: an empty default color scheme, an auto-generated (empty) sidebars
-// config, an empty doc-history manifest, empty frontmatter renderers, and a
-// package no-op `BodyEndIslands` stub. The seam (data-context + paths()
-// enumeration) is fully reconstructed in `_context`; the END-TO-END render
-// proof of a stub-less injected route — including re-homing these host-only
-// bindings — is A2's job (#2363). With `packageOwnedRoutes` off this module is
-// never evaluated; it only needs to typecheck and import.
-
-import type { JSX, VNode, ComponentChildren } from "preact";
-import {
-  settings,
-  defaultLocale,
-  locales,
-  t,
-  withBase,
-  stripBase,
-  docsUrl,
-  versionedDocsUrl,
-  absoluteUrl,
-  navHref,
-  buildLocaleLinks,
-  getNavSectionForSlug,
-  getCategoryOrder,
-  toRouteSlug,
-  resolveNavSource,
-  loadNavSourceDocs,
-  buildNavTree,
-  groupSatelliteNodes,
-  collectAutoIndexNodes,
-  findNode,
-  firstRoutedHref,
-  collectTags,
-  stableDocs,
-  colorSchemes,
-} from "./_context.js";
-import type { CategoryMeta, DocNavNode } from "./_docs-helpers.js";
-
-import { createComposeMetaTitle } from "@takazudo/zudo-doc/compose-meta-title";
-import {
-  generateCssCustomProperties,
-  generateLightDarkCssProperties,
-  type ColorScheme,
-} from "@takazudo/zudo-doc/color-scheme-utils";
-import { createHeadWithDefaults } from "@takazudo/zudo-doc/head-with-defaults";
-import { createHeaderWithDefaults } from "@takazudo/zudo-doc/header-with-defaults";
-import { createFooterWithDefaults } from "@takazudo/zudo-doc/footer-with-defaults";
-import { createSidebarWithDefaults } from "@takazudo/zudo-doc/sidebar-with-defaults";
-import { createSidebarPrepaint } from "@takazudo/zudo-doc/sidebar-prepaint";
-import { createDocBodyEnd } from "@takazudo/zudo-doc/doc-body-end";
-import { createBodyEndIslands } from "@takazudo/zudo-doc/doc-body-end-islands";
-import { createDocPager } from "@takazudo/zudo-doc/doc-pager";
-import { createDocPageShell } from "@takazudo/zudo-doc/doc-page-shell";
-import { createDocContentHeader } from "@takazudo/zudo-doc/doc-content-header";
-import { createDocMetainfoArea } from "@takazudo/zudo-doc/doc-metainfo-area";
-import { createDocTagsArea } from "@takazudo/zudo-doc/doc-tags-area";
-import { createDocHistoryArea } from "@takazudo/zudo-doc/doc-history-area";
-import { createInlineVersionSwitcher } from "@takazudo/zudo-doc/inline-version-switcher";
-import { createRenderDocPage } from "@takazudo/zudo-doc/doc-page-renderer";
-import { createVersionsPageView } from "@takazudo/zudo-doc/versions-page";
-import { createTagPages } from "@takazudo/zudo-doc/tag-pages";
-import { createMdxComponents } from "@takazudo/zudo-doc/mdx-components";
-import { createCategoryNavWrapper } from "@takazudo/zudo-doc/category-nav";
-import { createCategoryTreeNavWrapper } from "@takazudo/zudo-doc/category-tree-nav";
-import { createSiteTreeNavWrapper } from "@takazudo/zudo-doc/site-tree-nav";
-import { getTocTitle } from "@takazudo/zudo-doc/toc";
-import { SearchWidget } from "@takazudo/zudo-doc/search-widget";
-import { buildGitHubRepoUrl, buildGitHubSourceUrl } from "@takazudo/zudo-doc/github-helpers";
-import { toHistorySlug } from "@takazudo/zudo-doc/slug";
-import {
-  buildRootMenuItems as buildRootMenuItemsBase,
-  buildLocaleLinksForNav as buildLocaleLinksForNavBase,
-  remapVersionedHrefs,
-  getThemeDefaultMode as getThemeDefaultModeBase,
-} from "@takazudo/zudo-doc/nav-data-prep";
-import { buildSidebarForSection } from "@takazudo/zudo-doc/sidebar-utils";
-import { Details } from "@takazudo/zudo-doc/details";
-import {
-  HtmlPreviewWrapper,
-  type HtmlPreviewWrapperProps,
-} from "@takazudo/zudo-doc/html-preview-wrapper";
-
-// ---------------------------------------------------------------------------
-// Package-default host-only bindings (see module header).
-// ---------------------------------------------------------------------------
-
-/** Package-default color scheme — a neutral 16-step grey ramp. The project's
- *  real `colorSchemes` palette map is project DATA (not in `settings`), so it
- *  is not in the serializable virtual module; A2 re-homes it for the render
- *  proof. Semantic roles fall back to `SEMANTIC_DEFAULTS`. */
-const GREY_RAMP: ColorScheme["palette"] = [
-  "#000000", "#1a1a1a", "#333333", "#4d4d4d", "#666666", "#808080",
-  "#999999", "#b3b3b3", "#cccccc", "#d9d9d9", "#e6e6e6", "#f2f2f2",
-  "#ff5555", "#50fa7b", "#f1fa8c", "#8be9fd",
-];
-const DEFAULT_SCHEME: ColorScheme = {
-  background: "#000000",
-  foreground: "#ffffff",
-  cursor: "#ffffff",
-  selectionBg: "#444444",
-  selectionFg: "#ffffff",
-  palette: GREY_RAMP,
-};
-
-/** Empty doc-history manifest — the real `#doc-history-meta` virtual JSON is
- *  host-bound. With the flag off this is never read. */
-const docHistoryMeta: Record<string, never> = {};
-
-/** Empty sidebars config — sidebar sections fall back to the auto-generated
- *  tree. The project `sidebars` config is host-bound (A2). */
-const sidebarsConfig: Record<string, never> = {};
-
-/** Package-default body-end islands — the package-island subset of the host's
- *  `BodyEndIslands` (AiChatModal / ImageEnlarge / MermaidEnlarge), reconstructed
- *  from the serializable virtual-module `settings` flags (#2406 / #2401(c)).
- *  The host-owned bootstraps (client-router / design-token-panel) cannot live
- *  in the package, so they are NOT included here — A2/S4 re-homes those. */
-const BodyEndIslands = createBodyEndIslands({ settings });
-
-/** Package no-op DocHistory island stub — renders an empty fragment (the
- *  `DocHistoryComponent` contract requires a VNode, not null). */
-function DocHistoryStub(_props: { slug: string; locale?: string; basePath?: string }): VNode {
-  return (<></>) as VNode;
-}
-
-/** SearchWidget adapter: the package `SearchWidget` requires a `base` prop, but
- *  the `HeaderWithDefaults` dep signature omits it (the host stub injects it).
- *  Inject the base-prefixed search index root here. */
-function SearchWidgetBound(props: {
-  placeholderText: string;
-  shortcutHint: string;
-  resultCountTemplate: string;
-  searchLabel: string;
-  searchUnavailableText: string;
-  loadingIndexText: string;
-  noResultsText: string;
-}): JSX.Element {
-  return SearchWidget({ ...props, base: withBase("/") });
-}
-
-// ---------------------------------------------------------------------------
-// composeMetaTitle + Head.
-// ---------------------------------------------------------------------------
-
-export const composeMetaTitle = createComposeMetaTitle(settings.siteName);
-
-// Scheme-selection: resolve the active color scheme(s) from the host
-// `colorSchemes` map supplied via the virtual module. Falls back to
-// `DEFAULT_SCHEME` for any missing key or when `colorSchemes` is absent.
-// `generateCssCustomProperties` is called in single-scheme mode
-// (`settings.colorMode` is false); `generateLightDarkCssProperties` in
-// light/dark mode. Both delegate to DEFAULT_SCHEME when `colorSchemes` is null.
-function resolveHostScheme(key: string): ColorScheme {
-  if (!colorSchemes) return DEFAULT_SCHEME;
-  return colorSchemes[key] ?? DEFAULT_SCHEME;
-}
-
-export const HeadWithDefaults = createHeadWithDefaults({
-  settings,
-  composeMetaTitle,
-  withBase,
-  absoluteUrl,
-  // Called only in single-scheme mode (colorMode false): resolve via settings.colorScheme.
-  generateCssCustomProperties: () =>
-    generateCssCustomProperties(resolveHostScheme(settings.colorScheme)),
-  // Called only in light/dark mode (colorMode truthy): resolve the pair.
-  generateLightDarkCssProperties: () => {
-    const cm = settings.colorMode;
-    if (cm) {
-      return generateLightDarkCssProperties(
-        resolveHostScheme(cm.lightScheme),
-        resolveHostScheme(cm.darkScheme),
-      );
-    }
-    // Should not be reached (head-with-defaults only calls this when colorMode
-    // is truthy), but guard the contract by falling back to DEFAULT_SCHEME.
-    return generateLightDarkCssProperties(DEFAULT_SCHEME, DEFAULT_SCHEME);
-  },
-});
-
-// ---------------------------------------------------------------------------
-// nav data-prep (bound to settings via _context helpers).
-// ---------------------------------------------------------------------------
-
-function buildRootMenuItems(lang: string, currentVersion: string | undefined) {
-  return buildRootMenuItemsBase(
-    lang,
-    currentVersion,
-    settings.headerNav,
-    (key, l) => t(key, l),
-    (path, l, v) => navHref(path, l, v),
-  );
-}
-
-function buildLocaleLinksForNav(currentPath: string, lang: string, localeCount: number) {
-  return buildLocaleLinksForNavBase(currentPath, lang, localeCount, (path, l) =>
-    buildLocaleLinks(path, l),
-  );
-}
-
-function buildSidebarNodes(
-  lang: string,
-  navSection: string | undefined,
-  currentVersion: string | undefined,
-  emptyWhenUnsectioned = true,
-) {
-  if (navSection === undefined && emptyWhenUnsectioned) return [];
-  const { navDocs, categoryMeta } = loadNavSourceDocs(lang, currentVersion);
-  const explicitPrefixes = getCategoryOrder().filter((cm) => cm !== "!");
-  const rawNodes = buildSidebarForSection(
-    navDocs,
-    lang,
-    navSection,
-    categoryMeta as unknown as Map<string, CategoryMeta>,
-    sidebarsConfig,
-    (d, l, meta) =>
-      buildNavTree(
-        d as never[],
-        l,
-        meta as Map<string, CategoryMeta> | undefined,
-        (slug, loc) => docsUrl(slug, loc),
-      ) as never[],
-    explicitPrefixes,
-  );
-  return currentVersion
-    ? remapVersionedHrefs(rawNodes, currentVersion, lang, (slug, v, l) =>
-        versionedDocsUrl(slug, v, l),
-      )
-    : rawNodes;
-}
-
-function getThemeDefaultMode() {
-  return getThemeDefaultModeBase(settings.colorMode);
-}
-
-// ---------------------------------------------------------------------------
-// Header / Footer / Sidebar.
-// ---------------------------------------------------------------------------
-
-export const HeaderWithDefaults = createHeaderWithDefaults({
-  settings,
-  defaultLocale,
-  locales,
-  t,
-  withBase,
-  stripBase,
-  docsUrl,
-  navHref,
-  versionedDocsUrl,
-  buildLocaleLinksForNav,
-  buildRootMenuItems,
-  buildSidebarNodes,
-  getThemeDefaultMode,
-  buildGitHubRepoUrl: () => buildGitHubRepoUrl(settings.githubUrl),
-  SearchWidget: SearchWidgetBound,
-});
-
-export const FooterWithDefaults = createFooterWithDefaults({
-  settings,
-  defaultLocale,
-  tagVocabulary: [],
-  isExternal: (href: string) => /^https?:\/\//.test(href),
-  resolveHref: (href: string) => (/^https?:\/\//.test(href) ? href : withBase(href)),
-  withBase,
-  // The footer taglist is host-bound (project tag aggregation); package default
-  // renders no tag columns.
-  loadTagsForLocale: () => [],
-});
-
-export const SidebarWithDefaults = createSidebarWithDefaults({
-  defaultLocale,
-  localeCount: locales.length,
-  buildRootMenuItems,
-  buildLocaleLinksForNav,
-  buildSidebarNodes,
-  getThemeDefaultMode,
-  t,
-});
-
-const SidebarPrepaint = createSidebarPrepaint({ sidebarToggle: settings.sidebarToggle });
-const DocBodyEnd = createDocBodyEnd({ settings, BodyEndIslands });
-const DocPager = createDocPager({ t });
-
-// ---------------------------------------------------------------------------
-// Doc content header / metainfo / tags / history.
-// ---------------------------------------------------------------------------
-
-const DocMetainfoArea = createDocMetainfoArea({
-  settings,
-  defaultLocale,
-  docHistoryMeta,
-  t,
-  toHistorySlug,
-});
-
-const DocTagsArea = createDocTagsArea({
-  settings,
-  defaultLocale,
-  tagVocabularyEntries: [],
-  tagHref: (tag: string, locale: string) => {
-    const encoded = encodeURIComponent(tag);
-    return withBase(
-      locale === defaultLocale
-        ? `/docs/tags/${encoded}`
-        : `/${locale}/docs/tags/${encoded}`,
-    );
-  },
-  t,
-});
-
-const DocContentHeader = createDocContentHeader({
-  t,
-  buildFrontmatterPreviewEntries: () => [],
-  frontmatterRenderers: {},
-  DocMetainfoArea,
-  DocTagsArea,
-});
-
-const DocHistoryArea = createDocHistoryArea({
-  settings,
-  defaultLocale,
-  docHistoryMeta,
-  t,
-  toHistorySlug,
-  buildGitHubSourceUrl: (contentDir: string, entryId: string) =>
-    buildGitHubSourceUrl(settings.githubUrl, contentDir, entryId),
-  DocHistory: DocHistoryStub,
-});
-
-const buildInlineVersionSwitcher = createInlineVersionSwitcher({
-  settings,
-  defaultLocale,
-  t,
-  docsUrl,
-  versionedDocsUrl,
-  withBase,
-});
-
-// ---------------------------------------------------------------------------
-// MDX components (locale-bound nav wrappers + package defaults).
-// ---------------------------------------------------------------------------
-
-const CategoryNavWrapper = createCategoryNavWrapper({
-  defaultLocale,
-  resolveNavSource: resolveNavSource as never,
-  buildNavTree: ((docs: unknown[], locale: string, categoryMeta: Map<string, unknown>) =>
-    buildNavTree(
-      docs as never[],
-      locale,
-      categoryMeta as Map<string, CategoryMeta>,
-      (slug, loc) => docsUrl(slug, loc),
-    )) as never,
-  findNode: findNode as never,
-  firstRoutedHref: firstRoutedHref as never,
-});
-
-const CategoryTreeNavWrapper = createCategoryTreeNavWrapper({
-  defaultLocale,
-  resolveNavSource: resolveNavSource as never,
-  buildNavTree: ((docs: unknown[], locale: string, categoryMeta: Map<string, unknown>) =>
-    buildNavTree(
-      docs as never[],
-      locale,
-      categoryMeta as Map<string, CategoryMeta>,
-      (slug, loc) => docsUrl(slug, loc),
-    )) as never,
-  groupSatelliteNodes: groupSatelliteNodes as never,
-  findNode: findNode as never,
-});
-
-const SiteTreeNavWrapper = createSiteTreeNavWrapper({
-  defaultLocale,
-  resolveNavSource: resolveNavSource as never,
-  buildNavTree: ((docs: unknown[], locale: string, categoryMeta: Map<string, unknown>) =>
-    buildNavTree(
-      docs as never[],
-      locale,
-      categoryMeta as Map<string, CategoryMeta>,
-      (slug, loc) => docsUrl(slug, loc),
-    )) as never,
-  groupSatelliteNodes: groupSatelliteNodes as never,
-  getCategoryOrder,
-});
-
-/** HtmlPreview MDX binding (package default).
- *
- *  Mirrors the host stub (`pages/_mdx-components.ts`): the global preview
- *  config is `settings.htmlPreview`, a SERIALIZABLE setting that DOES ride in
- *  the route-context virtual module, so the package can read it directly (no
- *  host config needed). `HtmlPreviewWrapper` wraps the bare preview in
- *  `<Island when="visible">`, which SSR-renders the preview tree — so an
- *  injected docs page using `<HtmlPreview html="…" />` renders correct HTML.
- *
- *  Hydration caveat: the interactive code-toggle hydrates only if zfb's islands
- *  scanner reaches the `@takazudo/zfb` <Island> import inside
- *  `HtmlPreviewWrapper`. The esbuild islands bundler does NOT walk imports of
- *  modules whose realpath is under `node_modules` (the same gap the routes
- *  plugin stages around — see `plugins/routes.ts`; upstream report:
- *  Takazudo/zudo-front-builder, "islands bundler skips addVirtualModule /
- *  import-walk for node_modules route realpaths"). SSR output is unaffected. */
-function HtmlPreviewBound(props: HtmlPreviewWrapperProps): JSX.Element {
-  return HtmlPreviewWrapper({
-    globalConfig: settings.htmlPreview ?? null,
-    ...props,
-  }) as JSX.Element;
-}
-
-/** Island MDX binding (package default) — an SSR pass-through that renders its
- *  children, deliberately NOT the real `@takazudo/zfb` <Island>.
- *
- *  Why a pass-through and not `Island → @takazudo/zfb` (the sub-issue's literal
- *  ask): the MDX corpus never uses `<Island>` as a real render tag (only inside
- *  changelog prose), and the host stub itself uses this same pass-through. The
- *  real zfb <Island> emits `data-zfb-island="<firstChildTagName>"` for generic
- *  MDX children, i.e. a hydration marker pointing at a non-existent manifest
- *  entry — and the islands scanner can't register it anyway from a package
- *  (node_modules) import (upstream report above). A pass-through renders the
- *  server-renderable children correctly with no bogus marker, which is the
- *  complete and correct behaviour for the corpus. `when` is ignored at SSR
- *  time (it only matters to the client hydration runtime). */
-function IslandPassthrough(props: {
-  when?: "load" | "idle" | "visible" | "media";
-  children?: ComponentChildren;
-}): ComponentChildren {
-  return props.children ?? null;
-}
-
-export function createMdxComponentsBound(lang: string = defaultLocale) {
-  return createMdxComponents({
-    settings,
-    locale: lang,
-    navData: {
-      CategoryNav: CategoryNavWrapper as never,
-      CategoryTreeNav: CategoryTreeNavWrapper as never,
-      SiteTreeNav: SiteTreeNavWrapper as never,
-    },
-    // Package-owned content components wired here so an INJECTED docs route
-    // (packageOwnedRoutes, no host `pages/` stub) renders MDX using these tags
-    // without the "MDX requires '<X>' to be passed via the 'components' prop"
-    // error (sub-issue #2390 / supersedes #2377).
-    //   - Details      → fully functional (pure <details>, no client JS).
-    //   - HtmlPreview  → SSR-renders; see HtmlPreviewBound for the hydration
-    //                    caveat tied to the node_modules islands-scanner gap.
-    //   - Island       → SSR pass-through; see IslandPassthrough.
-    // PresetGenerator stays a package stub (render nothing): it is the
-    // showcase's project-bound interactive island and downstream projects stub
-    // it. The showcase keeps its host-owned docs catch-all routes (allowlisted)
-    // so its real PresetGenerator still renders.
-    extras: {
-      Details: Details as never,
-      HtmlPreview: HtmlPreviewBound as never,
-      Island: IslandPassthrough as never,
-      PresetGenerator: (_props: unknown) => null,
-    },
-  });
-}
-
-// ---------------------------------------------------------------------------
-// DocPageShell + renderDocPage.
-// ---------------------------------------------------------------------------
-
-const DocPageShell = createDocPageShell({
-  settings,
+// The chrome wiring was PROMOTED to the public, shared
+// `createChrome(context, hostBindings)` builder
+// (`@takazudo/zudo-doc/chrome`, CTX #2423). This module is now just the seam
+// that calls it ONCE with the reconstructed route context and NO host bindings
+// — so every host-bound slot resolves to its package-default stub and the
+// injected package-routes render is byte-identical to before. The host
+// (HOSTCOLLAPSE wave) will call `createChrome` directly with real bindings.
+
+import { routeCtx } from "./_context.js";
+import { createChrome } from "@takazudo/zudo-doc/chrome";
+import type { DocNavNode } from "./_docs-helpers.js";
+
+// Empty host bindings → package-default stubs (byte-identical injected path).
+const chrome = createChrome(routeCtx);
+
+export const {
   composeMetaTitle,
-  getTocTitle,
   HeadWithDefaults,
-  SidebarWithDefaults,
   HeaderWithDefaults,
   FooterWithDefaults,
-  SidebarPrepaint,
-  DocBodyEnd,
-  DocPager,
-});
-
-export const renderDocPage = createRenderDocPage({
-  docsUrl,
-  versionedDocsUrl,
-  absoluteUrl,
-  getNavSectionForSlug,
-  toRouteSlug,
-  createMdxComponents: createMdxComponentsBound,
-  t,
-  buildInlineVersionSwitcher,
-  DocPageShell,
-  DocContentHeader,
-  DocMetainfoArea,
-  DocHistoryArea,
-});
-
-// ---------------------------------------------------------------------------
-// VersionsPageView + TagPages.
-// ---------------------------------------------------------------------------
-
-export const VersionsPageView = createVersionsPageView({
-  settings,
-  defaultLocale,
-  t,
-  withBase,
-  composeMetaTitle,
-  components: {
-    HeadWithDefaults,
-    HeaderWithDefaults,
-    FooterWithDefaults,
-    BodyEndIslands,
-  },
-});
-
-const tagPages = createTagPages({
-  settings,
-  defaultLocale,
-  t,
-  withBase,
-  docsUrl,
-  composeMetaTitle,
-  collectTags: collectTags as never,
-  stableDocs: stableDocs as never,
-  isDefaultLocaleOnlyPath: undefined,
-  components: {
-    HeadWithDefaults,
-    HeaderWithDefaults,
-    FooterWithDefaults,
-    BodyEndIslands,
-    DocHistoryArea: DocHistoryArea as never,
-  },
-});
-
-export const { collectTagMapForLocale, TagDetailPageView, TagsIndexPageView } = tagPages;
-
-// Re-export the locale-aware site-tree wrapper + the package-default body-end
-// islands for the index entrypoints.
-export { SiteTreeNavWrapper, BodyEndIslands };
-
-// Bring the doc-route-entries builder + types into the chrome surface so the
-// doc entrypoints import a single module.
-export {
-  buildDocRouteEntries,
-} from "./_context.js";
+  SidebarWithDefaults,
+  renderDocPage,
+  VersionsPageView,
+  collectTagMapForLocale,
+  TagDetailPageView,
+  TagsIndexPageView,
+  SiteTreeNavWrapper,
+  BodyEndIslands,
+} = chrome;
+
+// The doc-route-entries builder lives on the route context; the doc entrypoints
+// import it from this chrome module so they reach a single barrel.
+export { buildDocRouteEntries } from "./_context.js";
 export type { DocNavNode };