@takazudo/zudo-doc 1.3.0 → 2.0.1

package/dist/doc-page-renderer/index.js

@@ -1,19 +1,26 @@
 import { jsx } from "preact/jsx-runtime";
-function createRenderDocPage(deps) {
-  const {
-    docsUrl,
-    versionedDocsUrl,
-    absoluteUrl,
-    getNavSectionForSlug,
-    toRouteSlug,
-    createMdxComponents,
-    t,
-    buildInlineVersionSwitcher,
-    DocPageShell,
-    DocContentHeader,
-    DocMetainfoArea,
-    DocHistoryArea
-  } = deps;
+import { createDocPageShell } from "../doc-page-shell/index.js";
+import { createDocContentHeader } from "../doc-content-header/index.js";
+import { createDocMetainfoArea } from "../doc-metainfo-area/index.js";
+import { createDocHistoryArea } from "../doc-history-area/index.js";
+import { deriveMdxComponents, deriveInlineVersionSwitcher } from "../chrome/derive.js";
+function createRenderDocPage(ctx) {
+  const docsUrl = ctx.docsUrl;
+  const versionedDocsUrl = ctx.versionedDocsUrl;
+  const absoluteUrl = ctx.absoluteUrl;
+  const getNavSectionForSlug = ctx.getNavSectionForSlug;
+  const toRouteSlug = ctx.toRouteSlug;
+  const createMdxComponents = deriveMdxComponents(ctx).createMdxComponentsBound;
+  const t = ctx.t;
+  const buildInlineVersionSwitcher = deriveInlineVersionSwitcher(
+    ctx
+  );
+  const DocPageShell = createDocPageShell(ctx);
+  const DocContentHeader = createDocContentHeader(
+    ctx
+  );
+  const DocMetainfoArea = createDocMetainfoArea(ctx);
+  const DocHistoryArea = createDocHistoryArea(ctx);
   function renderDocPage(props, opts) {
     const { breadcrumbs, prev, next, headings } = props;
     const { locale, version, isFallback } = opts;

package/dist/doc-page-shell/index.d.ts

@@ -2,6 +2,8 @@
 /** @jsxImportSource preact */
 import type { ComponentChildren, JSX, VNode } from "preact";
 import type { VersionBannerLabels } from "../i18n-version/index.js";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { Settings } from "../settings.js";
 /** A heading item for the TOC. */
 export interface DocPageHeading {
     depth: number;
@@ -130,7 +132,13 @@ export interface DocPageShellDeps {
     }) => JSX.Element;
 }
 /**
- * Create a `DocPageShell` component bound to the host's settings and
- * component dependencies.
+ * Create a `DocPageShell` component from the unified {@link ChromeContext}
+ * (epic Collapse Wiring Shells #2420, FACTORIES #2424 — breaking signature).
+ *
+ * Reads `settings` directly, `composeMetaTitle`/`getTocTitle` from the shared
+ * derive helper + the package toc helper, and rebuilds the Head / Sidebar /
+ * Header / Footer / SidebarPrepaint / DocBodyEnd / DocPager sub-components from
+ * the SAME context (so a host-supplied chrome context flows its real bindings
+ * straight through, byte-identical to the pre-collapse wiring).
  */
-export declare function createDocPageShell(deps: DocPageShellDeps): (props: DocPageShellProps) => JSX.Element;
+export declare function createDocPageShell<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: DocPageShellProps) => JSX.Element;

package/dist/doc-page-shell/index.js

@@ -1,22 +1,29 @@
 import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
 import { Island } from "@takazudo/zfb";
 import { DocLayoutWithDefaults } from "../doclayout/index.js";
-import { Toc, MobileToc } from "../toc/index.js";
+import { Toc, MobileToc, getTocTitle } from "../toc/index.js";
 import { Breadcrumb } from "../breadcrumb/index.js";
 import { NavCardGrid } from "../nav-indexing/index.js";
-function createDocPageShell(deps) {
-  const {
-    settings,
-    composeMetaTitle,
-    getTocTitle,
-    HeadWithDefaults,
-    SidebarWithDefaults,
-    HeaderWithDefaults,
-    FooterWithDefaults,
-    SidebarPrepaint,
-    DocBodyEnd,
-    DocPager
-  } = deps;
+import { createSidebarPrepaint } from "../sidebar-prepaint/index.js";
+import { createHeadWithDefaults } from "../head-with-defaults/index.js";
+import { createSidebarWithDefaults } from "../sidebar-with-defaults/index.js";
+import { createHeaderWithDefaults } from "../header-with-defaults/index.js";
+import { createFooterWithDefaults } from "../footer-with-defaults/index.js";
+import { createDocBodyEnd } from "../doc-body-end/index.js";
+import { createDocPager } from "../doc-pager/index.js";
+import { deriveComposeMetaTitle } from "../chrome/derive.js";
+function createDocPageShell(ctx) {
+  const settings = ctx.settings;
+  const composeMetaTitle = deriveComposeMetaTitle(ctx);
+  const HeadWithDefaults = createHeadWithDefaults(ctx);
+  const SidebarWithDefaults = createSidebarWithDefaults(ctx);
+  const HeaderWithDefaults = createHeaderWithDefaults(ctx);
+  const FooterWithDefaults = createFooterWithDefaults(ctx);
+  const SidebarPrepaint = createSidebarPrepaint({
+    sidebarToggle: Boolean(ctx.settings.sidebarToggle)
+  });
+  const DocBodyEnd = createDocBodyEnd(ctx);
+  const DocPager = createDocPager(ctx);
   function DocPageShell(props) {
     const {
       kind,

package/dist/doc-pager/index.d.ts

@@ -1,6 +1,8 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { JSX } from "preact";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { Settings } from "../settings.js";
 interface PagerNode {
     href?: string;
     label: string;
@@ -13,13 +15,10 @@ export interface DocPagerProps {
     /** Active locale for translated "Previous" / "Next" labels. */
     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 declare function createDocPager(deps: DocPagerDeps): (props: DocPagerProps) => JSX.Element;
+export declare function createDocPager<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: DocPagerProps) => JSX.Element;
 export {};

package/dist/doc-pager/index.js

@@ -1,7 +1,7 @@
 import { jsx, jsxs } from "preact/jsx-runtime";
 import { ChevronLeft, ChevronRight } from "../icons/index.js";
-function createDocPager(deps) {
-  const { t } = deps;
+function createDocPager(ctx) {
+  const t = ctx.t;
   function DocPager({ prev, next, locale }) {
     return /* @__PURE__ */ jsxs("nav", { class: "mt-vsp-2xl grid grid-cols-2 gap-hsp-xl", children: [
       prev ? /* @__PURE__ */ jsxs(

package/dist/doc-route-entries/index.d.ts

@@ -2,6 +2,7 @@ import type { DocPageEntry, DocNavNode, AutoIndexNode, DocPageBaseProps } from "
 import type { NavSourceDocs } from "../nav-source-docs/index.js";
 import type { BreadcrumbItem } from "../breadcrumb/types.js";
 import type { HeadingItem } from "../extract-headings/index.js";
+import type { CategoryMeta } from "../sidebar-tree/index.js";
 export type { DocPageEntry, DocNavNode, AutoIndexNode, DocPageBaseProps, NavSourceDocs };
 /** One enumerated doc route: a content entry or an auto-generated category
  *  index, with all per-page derived data pre-computed. */
@@ -39,49 +40,33 @@ export interface BuildDocRouteEntriesArgs {
 }
 export type { BreadcrumbItem, HeadingItem };
 /**
- * Injected context for `createDocRouteEntries`.
+ * Context slice `createDocRouteEntries` derives its bag from (epic Collapse
+ * Wiring Shells #2420, FACTORIES #2424 — breaking signature). STRUCTURAL SUBSET
+ * of the unified `RouteContext`/`ChromeContext` — the nav-tree builder is
+ * reconstructed by binding the context's 4-arg `buildNavTree` to `docsUrl`, and
+ * the breadcrumb trail by binding the package `buildBreadcrumbs` to the
+ * locale-prefixed `withBase` base, exactly as the pre-collapse wiring did.
  */
 export interface DocRouteEntriesContext {
-    /**
-     * Build the nav tree for a locale from a flat entry array and category meta.
-     * Host passes `buildNavTree` from `@/utils/docs`.
-     */
-    buildNavTree: (docs: DocPageEntry[], locale: string, categoryMeta: Map<string, unknown>) => DocNavNode[];
-    /**
-     * Build breadcrumb trail by walking the nav tree.
-     * Host passes `buildBreadcrumbs` from `@/utils/docs`.
-     */
-    buildBreadcrumbs: (tree: DocNavNode[], slug: string, locale: string, urlFor?: (slug: string) => string) => BreadcrumbItem[];
-    /**
-     * Collect all auto-generated index nodes (categories without index.mdx).
-     * Host passes `collectAutoIndexNodes` from `@/utils/docs`.
-     */
+    /** Default locale code (drives the breadcrumb base-prefix selection). */
+    defaultLocale: string;
+    /** Build the nav tree for a locale (4-arg form with an explicit href builder). */
+    buildNavTree: (docs: DocPageEntry[], locale: string, categoryMeta: Map<string, CategoryMeta> | undefined, buildHref: (slug: string, locale: string) => string) => DocNavNode[];
+    /** Build a docs URL for the given slug and locale. */
+    docsUrl: (slug: string, locale?: string) => string;
+    /** Prefix a path with the configured base directory. */
+    withBase: (path: string) => string;
+    /** Collect all auto-generated index nodes (categories without index.mdx). */
     collectAutoIndexNodes: (tree: DocNavNode[]) => AutoIndexNode[];
-    /**
-     * Determine the nav section (categoryMatch) for a slug.
-     * Host passes `getNavSectionForSlug` from `@/utils/nav-scope`.
-     */
+    /** Determine the nav section (categoryMatch) for a slug. */
     getNavSectionForSlug: (slug: string) => string | undefined;
-    /**
-     * Filter top-level nav nodes by a categoryMatch value.
-     * Host passes `getNavSubtree` from `@/utils/nav-scope`.
-     */
+    /** Filter top-level nav nodes by a categoryMatch value. */
     getNavSubtree: (tree: DocNavNode[], categoryMatch?: string) => DocNavNode[];
-    /**
-     * Convert a content entry slug to a canonical route slug.
-     * Host passes `toRouteSlug` from `@/utils/slug` (or the package's
-     * `@takazudo/zudo-doc/slug`).
-     */
+    /** Convert a content entry slug to a canonical route slug. */
     toRouteSlug: (id: string) => string;
-    /**
-     * Convert a canonical route slug to an optional-catchall params array.
-     * Host passes `toSlugParams` from `@/utils/slug`.
-     */
+    /** Convert a canonical route slug to an optional-catchall params array. */
     toSlugParams: (slug: string) => string[];
-    /**
-     * Extract headings from a raw MDX body.
-     * Host passes the wrapper from `pages/lib/_extract-headings.ts`.
-     */
+    /** Extract headings from a raw MDX body (bound to settings depth/strategy). */
     extractHeadings: (body: string) => HeadingItem[];
 }
 /**
@@ -109,16 +94,7 @@ export interface DocRouteEntriesAPI {
  * import { toRouteSlug, toSlugParams } from "@/utils/slug";
  * import { extractHeadings } from "./_extract-headings";
  *
- * export const { buildDocRouteEntries } = createDocRouteEntries({
- *   buildNavTree,
- *   buildBreadcrumbs,
- *   collectAutoIndexNodes,
- *   getNavSectionForSlug,
- *   getNavSubtree,
- *   toRouteSlug,
- *   toSlugParams,
- *   extractHeadings,
- * });
+ * export const { buildDocRouteEntries } = createDocRouteEntries(routeContext);
  * export type { DocRouteEntry, BuildDocRouteEntriesArgs };
  * ```
  */

package/dist/doc-route-entries/index.js

@@ -1,4 +1,5 @@
 import { memoizeDerived } from "../nav-source-cache/index.js";
+import { buildBreadcrumbs as buildBreadcrumbsImpl } from "../routes/_docs-helpers.js";
 import {
   resolveDocPrevNext,
   flattenSubtree,
@@ -6,16 +7,20 @@ import {
   remapNavChildHrefs
 } from "../doc-route-paths/index.js";
 function createDocRouteEntries(ctx) {
-  const {
-    buildNavTree,
-    buildBreadcrumbs,
-    collectAutoIndexNodes,
-    getNavSectionForSlug,
-    getNavSubtree,
-    toRouteSlug,
-    toSlugParams,
-    extractHeadings
-  } = ctx;
+  const defaultLocale = ctx.defaultLocale;
+  const buildNavTree = (docs, locale, categoryMeta) => ctx.buildNavTree(docs, locale, categoryMeta, (slug, loc) => ctx.docsUrl(slug, loc));
+  const buildBreadcrumbs = (tree, slug, locale, urlFor) => buildBreadcrumbsImpl(
+    tree,
+    slug,
+    locale === defaultLocale ? ctx.withBase("/") : ctx.withBase(`/${locale}/`),
+    urlFor
+  );
+  const collectAutoIndexNodes = ctx.collectAutoIndexNodes;
+  const getNavSectionForSlug = ctx.getNavSectionForSlug;
+  const getNavSubtree = ctx.getNavSubtree;
+  const toRouteSlug = ctx.toRouteSlug;
+  const toSlugParams = ctx.toSlugParams;
+  const extractHeadings = ctx.extractHeadings;
   function buildDocRouteEntries(args) {
     const { source, locale, routeSig, urlFor } = args;
     return memoizeDerived([source.docs], `docRouteEntries;${routeSig}`, () => {

package/dist/doc-tags-area/index.d.ts

@@ -1,28 +1,14 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { VNode } from "preact";
-import type { TagVocabularyEntry, TagGovernanceMode } from "../settings.js";
+import type { TagVocabularyEntry, TagGovernanceMode, Settings } from "../settings.js";
+import type { ChromeContext } from "../factory-context/index.js";
 /** Settings subset read by the DocTagsArea factory. */
 export interface DocTagsAreaSettings {
     docTags: boolean;
     tagVocabulary: boolean | readonly TagVocabularyEntry[];
     tagGovernance: TagGovernanceMode;
 }
-/** Dependencies injected by the host stub. */
-export interface DocTagsAreaDeps {
-    settings: DocTagsAreaSettings;
-    /** Default locale code (e.g. "en"). */
-    defaultLocale: string;
-    /** Tag vocabulary entries (from the host's `@/config/tag-vocabulary`). */
-    tagVocabularyEntries: readonly TagVocabularyEntry[];
-    /**
-     * Build the base-prefixed tag detail page href for the given tag and locale.
-     * Host passes a pre-bound function using `withBase` and `defaultLocale`.
-     */
-    tagHref: (tag: string, locale: string) => string;
-    /** Translate a UI string key for a locale. */
-    t: (key: string, locale: string) => string;
-}
 export interface DocTagsAreaProps {
     /** Page slug, e.g. "guides/sidebar". */
     slug: string;
@@ -32,7 +18,11 @@ export interface DocTagsAreaProps {
     tags: readonly string[] | undefined;
 }
 /**
- * Create a `DocTagsArea` component bound to the host's settings and
- * injected dependencies.
+ * Create a `DocTagsArea` component from the unified {@link ChromeContext}
+ * (epic Collapse Wiring Shells #2420, FACTORIES #2424 — breaking signature).
+ *
+ * Reads `settings`/`t`/`withBase`/`defaultLocale` off the context; the tag
+ * vocabulary is a HOST-bound slot (`ctx.hostBindings.tagVocabulary`, default
+ * `[]`); `tagHref` is reconstructed inline (identical to the pre-collapse wiring).
  */
-export declare function createDocTagsArea(deps: DocTagsAreaDeps): (props: DocTagsAreaProps) => VNode | null;
+export declare function createDocTagsArea<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: DocTagsAreaProps) => VNode | null;

package/dist/doc-tags-area/index.js

@@ -1,8 +1,18 @@
 import { jsx } from "preact/jsx-runtime";
 import { DocTags } from "../metainfo/index.js";
 import { resolvePageTags } from "../tag-helpers/index.js";
-function createDocTagsArea(deps) {
-  const { settings, tagVocabularyEntries, tagHref, t } = deps;
+function createDocTagsArea(ctx) {
+  const settings = ctx.settings;
+  const defaultLocale = ctx.defaultLocale;
+  const withBase = ctx.withBase;
+  const tagVocabularyEntries = ctx.hostBindings.tagVocabulary ?? [];
+  const tagHref = (tag, locale) => {
+    const encoded = encodeURIComponent(tag);
+    return withBase(
+      locale === defaultLocale ? `/docs/tags/${encoded}` : `/${locale}/docs/tags/${encoded}`
+    );
+  };
+  const t = ctx.t;
   function DocTagsArea({ locale, tags }) {
     if (!settings.docTags) return null;
     const rawTags = tags ?? [];

package/dist/factory-context/index.d.ts

@@ -1,4 +1,13 @@
-import type { Settings } from "../settings.js";
+import type { Settings, TagVocabularyEntry } from "../settings.js";
+import type { ColorScheme } from "../color-scheme-utils.js";
+import type { UrlHelpers } from "../url-helpers/index.js";
+import type { NavSourceDocsAPI } from "../nav-source-docs/index.js";
+import type { DocRouteEntriesAPI } from "../doc-route-entries/index.js";
+import type { RouteEnumeratorsAPI } from "../route-enumerators/index.js";
+import type { ResolvedTag } from "../tag-helpers/index.js";
+import type { DocNavNode, DocPageEntry } from "../doc-page-props/index.js";
+import type { HeadingItem } from "../extract-headings/index.js";
+import type { CategoryMeta } from "../sidebar-tree/index.js";
 /**
  * The i18n surface a factory may read. Parameterizes what `base.ts` used to read
  * off the project's `@/config/i18n` singleton directly, so URL/locale logic moves
@@ -78,3 +87,156 @@ export interface FactoryContext<S = Settings> {
     /** Opaque per-locale nav-source handle passed to the pure nav builders. */
     navSource: NavSource;
 }
+/**
+ * The serializable route-context payload carried by the
+ * `virtual:zudo-doc-route-context` module (ADR `route-injection-seam.md`,
+ * Decision 1) — DATA ONLY, no callables. `createRouteContext` rebuilds the full
+ * runtime context from it by calling the importable package factories.
+ */
+export interface RouteContextPayload<S = Settings> {
+    /** The host's resolved settings object. */
+    settings: S;
+    /** Per-locale UI-string tables (`translations[locale][key]`). */
+    translations: Record<string, Record<string, string>>;
+    /** The tag vocabulary (used only when `settings.tagVocabulary` is on). */
+    tagVocabulary: readonly TagVocabularyEntry[];
+    /** Host color-scheme palette map; `null` when the host passed none (chrome
+     *  then falls back to a neutral default scheme). */
+    colorSchemes: Record<string, ColorScheme> | null;
+}
+/** Aggregated `tag → docs` index entry built by `collectTags`. */
+export interface TagInfo {
+    tag: string;
+    count: number;
+    docs: {
+        slug: string;
+        title: string;
+        description?: string;
+    }[];
+}
+/** A docs-href builder: `(slug, locale) => url`. */
+export type RouteHrefBuilder = (slug: string, locale: string) => string;
+/**
+ * The reconstructed route context — `settings` + `i18n` + EVERY callable the
+ * package routes rebuild from the serializable payload (URL helpers, nav-scope,
+ * heading extraction, tag aggregation, nav-source resolution, doc-route-entry
+ * + route enumeration, and the pure nav-tree / slug helpers). Produced by
+ * `createRouteContext` and consumed by `createChrome`.
+ *
+ * It composes the already-typed factory API surfaces ({@link UrlHelpers},
+ * {@link NavSourceDocsAPI}, {@link DocRouteEntriesAPI},
+ * {@link RouteEnumeratorsAPI}) so the callables stay typed by their owning
+ * modules rather than re-declared here.
+ */
+export interface RouteContext<S = Settings> extends UrlHelpers, NavSourceDocsAPI, DocRouteEntriesAPI, RouteEnumeratorsAPI {
+    /** The host's resolved settings object. */
+    settings: S;
+    /** Host color-scheme palette map (or `null`); threaded to chrome head CSS. */
+    colorSchemes: Record<string, ColorScheme> | null;
+    /** The reconstructed i18n surface. */
+    i18n: FactoryI18n;
+    /** Default locale code (un-prefixed `/docs/...`). */
+    defaultLocale: string;
+    /** All supported locale codes, default first. */
+    locales: readonly string[];
+    /** Per-locale `{ label, dir }` config lookup. */
+    getLocaleConfig(locale: string): {
+        label: string;
+        dir: string;
+    } | undefined;
+    /** Display label for a locale. */
+    getLocaleLabel(locale: string): string;
+    /** Translate a UI string key for a locale (falls back to default then key). */
+    t(key: string, locale?: string): string;
+    /** The full URL-helper bag (also spread as own members via `extends`). */
+    urlHelpers: UrlHelpers;
+    /** Ordered category prefixes for the header nav. */
+    getCategoryOrder(): string[];
+    /** The nav section a slug belongs to (or `undefined`). */
+    getNavSectionForSlug(slug: string): string | undefined;
+    /** Scope a nav tree to a category. */
+    getNavSubtree(tree: DocNavNode[], categoryMatch?: string): DocNavNode[];
+    /** Extract TOC headings from a doc body (bound to settings depth/strategy). */
+    extractHeadings(body: string): HeadingItem[];
+    /** Resolve a raw tag against the bound vocabulary + governance. */
+    resolveTagBound(raw: string): ResolvedTag;
+    /** Aggregate a `tag → docs` index from a doc collection. */
+    collectTags(entries: ReadonlyArray<{
+        id: string;
+        data: {
+            slug?: string;
+            title?: string;
+            description?: string;
+            tags?: string[];
+        };
+    }>, slugFn: (id: string, data: {
+        slug?: string;
+    }) => string): Map<string, TagInfo>;
+    /** Build a recursive nav tree from a flat doc collection. */
+    buildNavTree(docs: DocPageEntry[], locale: string, categoryMeta: Map<string, CategoryMeta> | undefined, buildHref: RouteHrefBuilder, options?: {
+        buildHref?: RouteHrefBuilder;
+    }): DocNavNode[];
+    /** Group slug-prefix satellite nodes under their primary node. */
+    groupSatelliteNodes(tree: DocNavNode[], prefixes: string[]): DocNavNode[];
+    /** Find a node by slug anywhere in a nav tree. */
+    findNode(nodes: DocNavNode[], slug: string): DocNavNode | undefined;
+    /** Href of the first routed descendant. */
+    firstRoutedHref(node: DocNavNode): string | undefined;
+    /** Category nodes that have children but no page of their own. */
+    collectAutoIndexNodes(nodes: DocNavNode[]): DocNavNode[];
+    /** Visibility predicate for nav inclusion. */
+    isNavVisible(doc: DocPageEntry): boolean;
+    /** The content-bridge handle: identity-stable, draft-filtered docs loader. */
+    stableDocs(collectionName: string): DocPageEntry[];
+    /** Canonical route slug for a doc id. */
+    toRouteSlug(id: string): string;
+    /** Split a route slug into path params. */
+    toSlugParams(routeSlug: string): string[];
+}
+/**
+ * The genuinely host-bound chrome slots — bindings the serializable
+ * route-context payload deliberately does NOT carry (they are host content /
+ * project config, not serializable settings). Each is OPTIONAL; `createChrome`
+ * fills any omitted slot with the package-default stub that reproduces the
+ * pre-host-collapse (injected package-routes) behaviour BYTE-FOR-BYTE. The host
+ * (HOSTCOLLAPSE wave) later passes the real bindings.
+ */
+export interface ChromeHostBindings {
+    /** Header search widget. Default: the package SearchWidget bound to the site base. */
+    SearchWidget?: FactoryComponent;
+    /** Per-page git-history meta manifest. Default: `{}` (no Created/Updated block). */
+    docHistoryMeta?: Record<string, unknown>;
+    /** Sidebar section config. Default: `{}` (auto-generated tree only). */
+    sidebarsConfig?: Record<string, unknown>;
+    /** Frontmatter preview renderers keyed by field. Default: `{}`. */
+    frontmatterRenderers?: Record<string, FactoryComponent>;
+    /** Frontmatter preview entry builder. Default: `() => []`. */
+    buildFrontmatterPreviewEntries?: (...args: unknown[]) => unknown[];
+    /** Footer tag-list loader. Default: `() => []`. */
+    loadTagsForLocale?: (...args: unknown[]) => unknown[];
+    /** Tag vocabulary for footer columns + the tags area. Default: `[]`. */
+    tagVocabulary?: readonly unknown[];
+    /** Body-end islands (bootstrap islands). Default: the package-island subset
+     *  derived from `settings` (no host-only client-router / token-panel boots). */
+    BodyEndIslands?: FactoryComponent;
+    /** DocHistory island. Default: a no-op stub rendering an empty fragment. */
+    DocHistory?: FactoryComponent;
+    /** MDX content-component overrides (Details / HtmlPreview / Island /
+     *  PresetGenerator). Default: package SSR impls + a `PresetGenerator` stub. */
+    mdxExtras?: Record<string, FactoryComponent>;
+}
+/**
+ * The unified chrome context — the superset that fully wires the page chrome:
+ * the reconstructed {@link RouteContext} (settings + i18n + every callable) PLUS
+ * the host-supplied component allowlist and the host-bound slots. This single
+ * shape governs the package-owned routes today and the host collapse later:
+ * `createRouteContext` produces the {@link RouteContext} portion and
+ * `createChrome` consumes it together with {@link ChromeHostBindings}, supplying
+ * package defaults for the `components` allowlist and every omitted host slot.
+ */
+export interface ChromeContext<S = Settings> extends RouteContext<S> {
+    /** Host-supplied, project-bound component bindings (explicit allowlist). */
+    components: FactoryComponents;
+    /** Host-bound chrome slots (stub defaults in the injected package path). */
+    hostBindings: ChromeHostBindings;
+}

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

@@ -1,6 +1,8 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { VNode } from "preact";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { Settings } from "../settings.js";
 /** Tag info returned by the host's `collectTags` (what the factory sees). */
 export interface FooterTagInfo {
     tag: string;
@@ -44,20 +46,17 @@ export interface FooterWithDefaultsSettings {
     tagVocabulary?: unknown;
     tagGovernance?: string;
 }
-/** Dependencies injected by the host stub. */
-export interface FooterWithDefaultsDeps {
-    settings: FooterWithDefaultsSettings;
-    defaultLocale: string;
-    tagVocabulary: readonly FooterVocabularyEntry[];
-    isExternal: (href: string) => boolean;
-    resolveHref: (href: string) => string;
-    withBase: (path: string) => string;
-    loadTagsForLocale: (lang: string) => FooterTagInfo[];
-}
 /**
- * Create a `FooterWithDefaults` component bound to the host's settings
- * and data-prep utilities.
+ * Create a `FooterWithDefaults` component from the unified {@link ChromeContext}
+ * (epic Collapse Wiring Shells #2420, FACTORIES #2424 — breaking signature).
+ *
+ * Derives its old deps bag from the context: `settings`/`defaultLocale` and the
+ * `isExternal`/`resolveHref`/`withBase` URL helpers read directly; the footer
+ * tag vocabulary + `loadTagsForLocale` are HOST-bound slots
+ * (`ctx.hostBindings.tagVocabulary` / `ctx.hostBindings.loadTagsForLocale`) that
+ * default to `[]` / `() => []` — the package stub renders no tag columns,
+ * byte-identical to the pre-collapse injected path.
  */
-export declare function createFooterWithDefaults(deps: FooterWithDefaultsDeps): (props: {
+export declare function createFooterWithDefaults<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: {
     lang?: string;
 }) => VNode;

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

@@ -1,15 +1,13 @@
 import { jsx } from "preact/jsx-runtime";
 import { Footer } from "../footer/index.js";
-function createFooterWithDefaults(deps) {
-  const {
-    settings,
-    defaultLocale,
-    tagVocabulary,
-    isExternal,
-    resolveHref,
-    withBase,
-    loadTagsForLocale
-  } = deps;
+function createFooterWithDefaults(ctx) {
+  const settings = ctx.settings;
+  const defaultLocale = ctx.defaultLocale;
+  const tagVocabulary = ctx.hostBindings.tagVocabulary ?? [];
+  const isExternal = ctx.isExternal;
+  const resolveHref = ctx.resolveHref;
+  const withBase = ctx.withBase;
+  const loadTagsForLocale = ctx.hostBindings.loadTagsForLocale ?? (() => []);
   function localizeHref(href, lang) {
     if (isExternal(href)) return href;
     if (lang !== defaultLocale) {

package/dist/head/types.d.ts

@@ -79,3 +79,42 @@ export interface HeadProps {
         crossorigin?: "anonymous" | "use-credentials";
     }>;
 }
+/** Stylesheet link descriptor for {@link SiteHeadConfig}. */
+export interface HeadStylesheet {
+    href: string;
+    crossorigin?: "anonymous" | "use-credentials";
+    /** CSS media attribute applied to the `<link media>` attribute. */
+    media?: string;
+    /**
+     * When `true`, loads the stylesheet non-render-blocking via the
+     * `media="print" + onload="this.media='all'"` pattern, plus a
+     * `<noscript><link rel="stylesheet" href>` fallback.
+     * Plain (absent or `false`) emits a normal `<link rel="stylesheet">`.
+     */
+    async?: boolean;
+}
+/** Preconnect hint descriptor for {@link SiteHeadConfig}. */
+export interface HeadPreconnect {
+    href: string;
+    crossorigin?: "anonymous" | "use-credentials";
+}
+/** Preload hint descriptor for {@link SiteHeadConfig}. */
+export interface HeadPreload {
+    href: string;
+    as: string;
+    type?: string;
+    crossorigin?: "anonymous" | "use-credentials";
+}
+/** Meta tag descriptor for {@link SiteHeadConfig}. */
+export interface HeadMeta {
+    name?: string;
+    property?: string;
+    content: string;
+}
+/** Alternate link descriptor for {@link SiteHeadConfig}. */
+export interface HeadAlternateLink {
+    rel: string;
+    href: string;
+    type?: string;
+    title?: string;
+}