@takazudo/zudo-doc 1.3.0 → 2.0.0

package/dist/routes/_context.js

@@ -1,64 +1,19 @@
 import { routeContext } from "virtual:zudo-doc-route-context";
-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";
-import {
-  getCategoryOrder as getCategoryOrderBase,
-  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";
-import {
-  createDocRouteEntries
-} from "../doc-route-entries/index.js";
-import {
-  createRouteEnumerators
-} from "../route-enumerators/index.js";
-import {
-  stableDocs,
-  isNavVisible,
-  buildNavTree,
-  buildBreadcrumbs,
-  collectAutoIndexNodes,
-  groupSatelliteNodes,
-  findNode,
-  firstRoutedHref
-} from "./_docs-helpers.js";
+  createRouteContext
+} from "../route-context/index.js";
 const ctx = routeContext;
-const settings = ctx.settings;
-const translations = ctx.translations;
-const tagVocabulary = ctx.tagVocabulary;
-const colorSchemes = ctx.colorSchemes;
-const defaultLocale = settings.defaultLocale;
-const locales = [
-  defaultLocale,
-  ...Object.keys(settings.locales)
-];
-function getLocaleConfig(locale) {
-  return settings.locales[locale];
-}
-function getLocaleLabel(locale) {
-  if (locale === defaultLocale) return defaultLocale.toUpperCase();
-  return getLocaleConfig(locale)?.label ?? locale.toUpperCase();
-}
-function t(key, locale = defaultLocale) {
-  return translations[locale]?.[key] ?? translations[defaultLocale]?.[key] ?? key;
-}
-const i18n = {
+const routeCtx = createRouteContext(ctx);
+const settings = routeCtx.settings;
+const colorSchemes = routeCtx.colorSchemes;
+const {
+  i18n,
   defaultLocale,
   locales,
+  getLocaleConfig,
   getLocaleLabel,
-  t
-};
-const urlHelpers = makeUrlHelpers(settings, i18n);
-const {
+  t,
+  urlHelpers,
   withBase,
   stripBase,
   docsUrl,
@@ -68,115 +23,31 @@ const {
   absoluteUrl,
   isExternal,
   resolveHref,
-  buildLocaleLinks
-} = urlHelpers;
-function getCategoryOrder() {
-  return getCategoryOrderBase(settings.headerNav);
-}
-function getNavSectionForSlug(slug) {
-  return getNavSectionForSlugBase(slug, settings.headerNav);
-}
-function getNavSubtree(tree, categoryMatch) {
-  return getNavSubtreeBase(tree, categoryMatch, settings.headerNav);
-}
-function extractHeadings(body) {
-  return extractHeadingsBase(body, {
-    tocMinDepth: settings.tocMinDepth,
-    tocMaxDepth: settings.tocMaxDepth,
-    strategy: settings.headingIdStrategy
-  });
-}
-function getVocab() {
-  return settings.tagVocabulary ? tagVocabulary : false;
-}
-function resolveTagBound(raw) {
-  return resolveTag(raw, getVocab(), settings.tagGovernance);
-}
-function collectTags(entries, slugFn) {
-  const tagMap = /* @__PURE__ */ new Map();
-  for (const entry of entries) {
-    const rawTags = entry.data.tags ?? [];
-    const slug = slugFn(entry.id, 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)) {
-        tagMap.set(resolved.canonical, { tag: resolved.canonical, count: 0, docs: [] });
-      }
-      const info = tagMap.get(resolved.canonical);
-      info.count++;
-      info.docs.push({
-        slug,
-        title: entry.data.title ?? "",
-        description: entry.data.description
-      });
-    }
-  }
-  return tagMap;
-}
-const navSourceDocs = createNavSourceDocs({
-  defaultLocale,
-  docsDir: settings.docsDir,
-  getVersions: () => settings.versions,
-  getLocaleConfig,
-  loadCategoryMeta,
-  isNavVisible,
-  isDefaultLocaleOnlyPath,
-  stableDocs
-});
-const {
-  resolveNavSource,
-  resolveVersionedLocaleSource,
-  loadNavSourceDocs
-} = navSourceDocs;
-const docRouteEntries = createDocRouteEntries({
-  buildNavTree: (docs, locale, categoryMeta) => buildNavTree(
-    docs,
-    locale,
-    categoryMeta,
-    (slug, loc) => docsUrl(slug, loc)
-  ),
-  buildBreadcrumbs: (tree, slug, locale, urlFor) => buildBreadcrumbs(
-    tree,
-    slug,
-    locale === defaultLocale ? withBase("/") : withBase(`/${locale}/`),
-    urlFor
-  ),
-  collectAutoIndexNodes,
+  buildLocaleLinks,
+  getCategoryOrder,
   getNavSectionForSlug,
   getNavSubtree,
-  toRouteSlug,
-  toSlugParams,
-  extractHeadings
-});
-const { buildDocRouteEntries } = docRouteEntries;
-const routeEnumerators = createRouteEnumerators({
-  defaultLocale,
-  getLocaleKeys: () => Object.keys(settings.locales),
-  getVersions: () => settings.versions,
-  getDocTags: () => settings.docTags,
-  docsUrl,
-  versionedDocsUrl,
-  withBase,
-  loadDocs: (collectionName) => stableDocs(collectionName),
-  isDefaultLocaleOnlyPath,
-  collectTags: (docs, slugFn) => collectTags(docs, slugFn),
-  toRouteSlug,
-  buildNavTree: (docs, locale, categoryMeta) => buildNavTree(docs, locale, categoryMeta, (slug, loc) => docsUrl(slug, loc)),
-  collectAutoIndexNodes,
+  extractHeadings,
+  resolveTagBound,
+  collectTags,
   resolveNavSource,
   resolveVersionedLocaleSource,
-  mergeLocaleDocs
-});
-const {
+  loadNavSourceDocs,
+  buildDocRouteEntries,
   enumerateDocsRoutes,
   enumerateTagsRoutes,
   enumerateVersionedRoutes,
-  enumerateAllRoutes
-} = routeEnumerators;
+  enumerateAllRoutes,
+  buildNavTree,
+  groupSatelliteNodes,
+  findNode,
+  firstRoutedHref,
+  collectAutoIndexNodes,
+  isNavVisible,
+  stableDocs,
+  toRouteSlug,
+  toSlugParams
+} = routeCtx;
 export {
   absoluteUrl,
   buildDocRouteEntries,
@@ -212,6 +83,7 @@ export {
   resolveNavSource,
   resolveTagBound,
   resolveVersionedLocaleSource,
+  routeCtx,
   settings,
   stableDocs,
   stripBase,

package/dist/sidebar-with-defaults/index.d.ts

@@ -2,7 +2,8 @@
 /** @jsxImportSource preact */
 import type { JSX } from "preact";
 import type { SidebarNavNode, SidebarRootMenuItem } from "../sidebar/types.js";
-import type { LocaleLink } from "../url-helpers/index.js";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { Settings } from "../settings.js";
 export type { SidebarNavNode, SidebarRootMenuItem };
 export interface SidebarWithDefaultsProps {
     /** Slug of the active doc page, used to highlight the current entry. */
@@ -19,20 +20,12 @@ export interface SidebarWithDefaultsProps {
      */
     currentPath?: string;
 }
-/** Dependencies injected by the host stub. */
-export interface SidebarWithDefaultsDeps {
-    defaultLocale: string;
-    localeCount: number;
-    buildRootMenuItems: (lang: string, currentVersion: string | undefined) => SidebarRootMenuItem[];
-    buildLocaleLinksForNav: (currentPath: string, lang: string, localeCount: number) => LocaleLink[] | undefined;
-    buildSidebarNodes: (lang: string, navSection: string | undefined, currentVersion: string | undefined, emptyWhenUnsectioned?: boolean) => SidebarNavNode[];
-    getThemeDefaultMode: () => "light" | "dark" | undefined;
-    t: (key: string, lang: string) => string;
-}
 /**
- * Create a `SidebarWithDefaults` component bound to the host's nav builders.
+ * Create a `SidebarWithDefaults` component from the unified {@link ChromeContext}
+ * (epic Collapse Wiring Shells #2420, FACTORIES #2424 — breaking signature).
  *
- * The host stub calls this once with its concrete dependencies and re-exports
- * the result.
+ * Derives its old nav-builder bag from the context: `defaultLocale`/`localeCount`
+ * (= `locales.length`)/`t` read directly; the four nav data-prep builders come
+ * from the shared `chrome/derive` helper (identical to the pre-collapse wiring).
  */
-export declare function createSidebarWithDefaults(deps: SidebarWithDefaultsDeps): (props: SidebarWithDefaultsProps) => JSX.Element;
+export declare function createSidebarWithDefaults<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: SidebarWithDefaultsProps) => JSX.Element;

package/dist/sidebar-with-defaults/index.js

@@ -1,16 +1,12 @@
 import { jsx } from "preact/jsx-runtime";
 import { Island } from "@takazudo/zfb";
 import { SidebarTree } from "../sidebar-tree-island/index.js";
-function createSidebarWithDefaults(deps) {
-  const {
-    defaultLocale,
-    localeCount,
-    buildRootMenuItems,
-    buildLocaleLinksForNav,
-    buildSidebarNodes,
-    getThemeDefaultMode,
-    t
-  } = deps;
+import { deriveNavDataPrep } from "../chrome/derive.js";
+function createSidebarWithDefaults(ctx) {
+  const defaultLocale = ctx.defaultLocale;
+  const localeCount = ctx.locales.length;
+  const t = ctx.t;
+  const { buildRootMenuItems, buildLocaleLinksForNav, buildSidebarNodes, getThemeDefaultMode } = deriveNavDataPrep(ctx);
   function SidebarWithDefaults(props) {
     const {
       currentSlug,

package/dist/tag-pages/index.d.ts

@@ -1,6 +1,8 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { ComponentChildren, JSX } from "preact";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { Settings } from "../settings.js";
 /** Minimal docs entry shape needed by the tag-pages factory. */
 export interface TagPagesDocsEntry {
     id: string;
@@ -108,7 +110,14 @@ export interface TagPagesAPI {
     }) => JSX.Element;
 }
 /**
- * Create the tag-pages functions bound to the host's settings and
- * component dependencies.
+ * Create the tag-pages functions from the unified {@link ChromeContext}
+ * (epic Collapse Wiring Shells #2420, FACTORIES #2424 — breaking signature).
+ *
+ * Reads `settings`/`defaultLocale`/`t`/`withBase`/`docsUrl`/`collectTags`/
+ * `stableDocs` off the context, derives `composeMetaTitle`, and rebuilds the
+ * Head / Header / Footer / BodyEndIslands / DocHistoryArea chrome from the SAME
+ * context. `isDefaultLocaleOnlyPath` is left `undefined` to reproduce the
+ * pre-collapse injected wiring (`routes/_chrome.tsx` passed `undefined`) — the
+ * frozen baseline's tag pages are rendered through that path BYTE-FOR-BYTE.
  */
-export declare function createTagPages(deps: TagPagesDeps): TagPagesAPI;
+export declare function createTagPages<S extends Settings = Settings>(ctx: ChromeContext<S>): TagPagesAPI;

package/dist/tag-pages/index.js

@@ -5,25 +5,30 @@ import { DocCardGrid, TagNav } from "../nav-indexing/index.js";
 import { memoizeDerived } from "../nav-source-cache/index.js";
 import { mergeLocaleDocs } from "../locale-merge/index.js";
 import { toRouteSlug } from "../slug/index.js";
-function createTagPages(deps) {
-  const {
-    settings,
-    defaultLocale,
-    t,
-    withBase,
-    docsUrl,
-    composeMetaTitle,
-    collectTags,
-    stableDocs,
-    isDefaultLocaleOnlyPath,
-    components: {
-      HeadWithDefaults,
-      HeaderWithDefaults,
-      FooterWithDefaults,
-      BodyEndIslands,
-      DocHistoryArea
-    }
-  } = deps;
+import { createHeadWithDefaults } from "../head-with-defaults/index.js";
+import { createHeaderWithDefaults } from "../header-with-defaults/index.js";
+import { createFooterWithDefaults } from "../footer-with-defaults/index.js";
+import { createDocHistoryArea } from "../doc-history-area/index.js";
+import { deriveComposeMetaTitle, deriveBodyEndIslands } from "../chrome/derive.js";
+function createTagPages(ctx) {
+  const settings = ctx.settings;
+  const defaultLocale = ctx.defaultLocale;
+  const t = ctx.t;
+  const withBase = ctx.withBase;
+  const docsUrl = ctx.docsUrl;
+  const composeMetaTitle = deriveComposeMetaTitle(ctx);
+  const collectTags = ctx.collectTags;
+  const stableDocs = ctx.stableDocs;
+  const isDefaultLocaleOnlyPath = void 0;
+  const HeadWithDefaults = createHeadWithDefaults(ctx);
+  const HeaderWithDefaults = createHeaderWithDefaults(
+    ctx
+  );
+  const FooterWithDefaults = createFooterWithDefaults(
+    ctx
+  );
+  const BodyEndIslands = deriveBodyEndIslands(ctx);
+  const DocHistoryArea = createDocHistoryArea(ctx);
   function localePrefix(locale) {
     return locale === defaultLocale ? "" : `/${locale}`;
   }

package/dist/versions-page/index.d.ts

@@ -1,6 +1,8 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { ComponentChildren, JSX } from "preact";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { Settings } from "../settings.js";
 /** Minimal version config entry needed by the versions page. */
 export interface VersionsPageVersionEntry {
     slug: string;
@@ -49,7 +51,12 @@ export interface VersionsPageViewProps {
     children?: ComponentChildren;
 }
 /**
- * Create a `VersionsPageView` component bound to the host's settings and
- * component dependencies.
+ * Create a `VersionsPageView` component from the unified {@link ChromeContext}
+ * (epic Collapse Wiring Shells #2420, FACTORIES #2424 — breaking signature).
+ *
+ * Reads `settings`/`defaultLocale`/`t`/`withBase` off the context, derives
+ * `composeMetaTitle`, and rebuilds the Head / Header / Footer / BodyEndIslands
+ * chrome from the SAME context (so the injected stub path and a host-bound
+ * context both render byte-identically).
  */
-export declare function createVersionsPageView(deps: VersionsPageDeps): (props: VersionsPageViewProps) => JSX.Element;
+export declare function createVersionsPageView<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: VersionsPageViewProps) => JSX.Element;

package/dist/versions-page/index.js

@@ -1,20 +1,24 @@
 import { Fragment, jsx } from "preact/jsx-runtime";
 import { DocLayoutWithDefaults } from "../doclayout/index.js";
 import { VersionsPageContent } from "../nav-indexing/index.js";
-function createVersionsPageView(deps) {
-  const {
-    settings,
-    defaultLocale,
-    t,
-    withBase,
-    composeMetaTitle,
-    components: {
-      HeadWithDefaults,
-      HeaderWithDefaults,
-      FooterWithDefaults,
-      BodyEndIslands
-    }
-  } = deps;
+import { createHeadWithDefaults } from "../head-with-defaults/index.js";
+import { createHeaderWithDefaults } from "../header-with-defaults/index.js";
+import { createFooterWithDefaults } from "../footer-with-defaults/index.js";
+import { deriveComposeMetaTitle, deriveBodyEndIslands } from "../chrome/derive.js";
+function createVersionsPageView(ctx) {
+  const settings = ctx.settings;
+  const defaultLocale = ctx.defaultLocale;
+  const t = ctx.t;
+  const withBase = ctx.withBase;
+  const composeMetaTitle = deriveComposeMetaTitle(ctx);
+  const HeadWithDefaults = createHeadWithDefaults(ctx);
+  const HeaderWithDefaults = createHeaderWithDefaults(
+    ctx
+  );
+  const FooterWithDefaults = createFooterWithDefaults(
+    ctx
+  );
+  const BodyEndIslands = deriveBodyEndIslands(ctx);
   function VersionsPageView({ locale }) {
     const isDefault = locale === defaultLocale;
     const prefix = isDefault ? "" : `/${locale}`;

package/eject/doc-pager/index.tsx

@@ -9,6 +9,8 @@
 
 import type { JSX } from "preact";
 import { ChevronLeft, ChevronRight } from "../icons/index.js";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { Settings } from "../settings.js";
 
 // NavNode is a superset; we only need the fields the pager uses.
 interface PagerNode {
@@ -25,19 +27,15 @@ export interface DocPagerProps {
   locale: string;
 }
 
-/** Dependencies injected by the host stub. */
-export interface DocPagerDeps {
-  /** Translate a UI string key for a locale. */
-  t: (key: string, locale: string) => string;
-}
-
 /**
- * Create a `DocPager` component bound to the host's injected `t` translator.
+ * Create a `DocPager` component from the unified {@link ChromeContext}
+ * (epic Collapse Wiring Shells #2420, FACTORIES #2424 — breaking signature).
+ * Reads only the `t` translator off the context.
  */
-export function createDocPager(
-  deps: DocPagerDeps,
+export function createDocPager<S extends Settings = Settings>(
+  ctx: ChromeContext<S>,
 ): (props: DocPagerProps) => JSX.Element {
-  const { t } = deps;
+  const t = ctx.t;
 
   /**
    * Prev/next pagination nav shared by all four doc-route page components.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "1.3.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",