@takazudo/zudo-doc 2.2.2 → 2.4.0

package/dist/chrome/index.d.ts

@@ -32,6 +32,7 @@ export declare function createChrome<S extends Settings = Settings>(context: Rou
     }) => import("preact").JSX.Element;
     SiteTreeNavWrapper: import("../factory-context/index.js").FactoryComponent;
     BodyEndIslands: (props: import("../doc-body-end-islands/index.js").BodyEndIslandsProps) => import("preact").JSX.Element;
+    HomePageView: (props: import("../home-page/index.js").HomePageViewProps) => import("preact").JSX.Element;
 };
 /** The wired page-chrome surface returned by {@link createChrome}. */
 export type Chrome = ReturnType<typeof createChrome>;

package/dist/chrome/index.js

@@ -5,6 +5,7 @@ import { createSidebarWithDefaults } from "../sidebar-with-defaults/index.js";
 import { createRenderDocPage } from "../doc-page-renderer/index.js";
 import { createVersionsPageView } from "../versions-page/index.js";
 import { createTagPages } from "../tag-pages/index.js";
+import { createHomePageView } from "../home-page/index.js";
 import {
   deriveComposeMetaTitle,
   deriveBodyEndIslands,
@@ -23,6 +24,7 @@ function createChrome(context, hostBindings = {}) {
   const { collectTagMapForLocale, TagDetailPageView, TagsIndexPageView } = createTagPages(ctx);
   const { SiteTreeNavWrapper } = deriveMdxComponents(ctx);
   const BodyEndIslands = deriveBodyEndIslands(ctx);
+  const HomePageView = createHomePageView(ctx);
   return {
     composeMetaTitle,
     HeadWithDefaults,
@@ -35,7 +37,8 @@ function createChrome(context, hostBindings = {}) {
     TagDetailPageView,
     TagsIndexPageView,
     SiteTreeNavWrapper,
-    BodyEndIslands
+    BodyEndIslands,
+    HomePageView
   };
 }
 export {

package/dist/doc-content-header/index.d.ts

@@ -73,5 +73,9 @@ interface DocContentHeaderProps {
  * are HOST-bound slots (`ctx.hostBindings.buildFrontmatterPreviewEntries` /
  * `…frontmatterRenderers`, defaulting to `() => []` / `{}`). The nested
  * `DocMetainfoArea` / `DocTagsArea` are rebuilt from the same context.
+ *
+ * `ctx.hostBindings.docContentHeaderExtras` (default: absent) renders after
+ * the `<h1>` and before `DocMetainfoArea` — see the `ChromeHostBindings`
+ * interface in `./factory-context`.
  */
 export declare function createDocContentHeader<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: DocContentHeaderProps) => JSX.Element;

package/dist/doc-content-header/index.js

@@ -8,6 +8,7 @@ function createDocContentHeader(ctx) {
   const t = ctx.t;
   const buildFrontmatterPreviewEntries = ctx.hostBindings.buildFrontmatterPreviewEntries ?? (() => []);
   const frontmatterRenderers = ctx.hostBindings.frontmatterRenderers ?? {};
+  const docContentHeaderExtras = ctx.hostBindings.docContentHeaderExtras;
   const DocMetainfoArea = createDocMetainfoArea(ctx);
   const DocTagsArea = createDocTagsArea(ctx);
   function DocContentHeader({
@@ -19,6 +20,13 @@ function createDocContentHeader(ctx) {
   }) {
     return /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-xs", children: entry.data.title }),
+      docContentHeaderExtras?.({
+        entry,
+        slug,
+        locale,
+        isFallback,
+        version
+      }),
       !version && /* @__PURE__ */ jsx(DocMetainfoArea, { slug, locale, isFallback }),
       !version && /* @__PURE__ */ jsx(DocTagsArea, { slug, locale, tags: entry.data.tags }),
       isFallback && !entry.data.generated && /* @__PURE__ */ jsx(

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

@@ -224,6 +224,32 @@ export interface ChromeHostBindings {
     /** MDX content-component overrides (Details / HtmlPreview / Island /
      *  PresetGenerator). Default: package SSR impls + a `PresetGenerator` stub. */
     mdxExtras?: Record<string, FactoryComponent>;
+    /**
+     * Extra content rendered inside the doc content header, between the `<h1>`
+     * and the metainfo block. A RENDERER (not a component) so it is naturally
+     * keyed on the page entry/frontmatter rather than re-deriving them from
+     * props. Default: absent → renders nothing (byte-identical output to the
+     * pre-seam header). Called for `kind === "entry"` doc pages on all 4 doc
+     * routes, INCLUDING versioned pages — it receives `version` and decides for
+     * itself whether/how to render on a versioned page.
+     */
+    docContentHeaderExtras?: (args: {
+        entry: DocPageEntry;
+        slug: string;
+        locale: string;
+        isFallback?: boolean;
+        version?: string;
+    }) => unknown;
+    /**
+     * Extra content rendered in the home hero. A RENDERER (not a component).
+     * Default: absent → renders nothing. The `/` home route is never injected
+     * by the routes plugin (zfb rejects `/`), so this binding fires on injected
+     * `/[locale]` homes and on any host that threads it through `createChrome`.
+     * A `HomePageView` `extras` prop (added in a later task) takes precedence.
+     */
+    homeExtras?: (args: {
+        locale: string;
+    }) => unknown;
 }
 /**
  * The unified chrome context — the superset that fully wires the page chrome:

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

@@ -0,0 +1,51 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { ComponentChildren, JSX } from "preact";
+import type { DocNavNode } from "../doc-page-props/index.js";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { Settings } from "../settings.js";
+export { prepareHomeData } from "./prepare-home-data.js";
+export type { PrepareHomeDataOptions, HomeData } from "./prepare-home-data.js";
+/** Props for the `HomePageView` component built by {@link createHomePageView}. */
+export interface HomePageViewProps {
+    /** Active locale — drives hero copy, link locale-prefixing, and the
+     *  `hostBindings.homeExtras({ locale })` call when `extras` is absent. */
+    locale: string;
+    /**
+     * Extra content rendered after the links row, inside the hero text column.
+     * A VALUE (already-rendered children) — the host-PAGE path. Takes
+     * precedence over `ctx.hostBindings.homeExtras` when both are present.
+     *
+     * This value-vs-renderer asymmetry (prop = value, `hostBindings.homeExtras`
+     * = renderer) is INTENTIONAL, not an oversight to "unify": a host page
+     * already has its JSX in hand (a value), while the injected/bindings path
+     * only has a locale string at render time and must derive its own content
+     * from it (a renderer). Resolved as `extras ?? hostBindings.homeExtras?.({
+     * locale })`.
+     */
+    extras?: ComponentChildren;
+    /** Prepared nav tree for the `SiteTreeNav` grid (already grouped via
+     *  `groupSatelliteNodes` by the caller — the two routes group their own
+     *  locale-specific tree before handing it here). */
+    tree: DocNavNode[];
+    /** Ordered category prefixes, passed through to `SiteTreeNav`. */
+    categoryOrder: string[];
+    /** Unique tag count for the current locale — gates the "all tags" section
+     *  together with `settings.docTags`. */
+    tagCount: number;
+}
+/**
+ * Create a `HomePageView` component from the unified {@link ChromeContext}
+ * (epic Collapse Wiring Shells #2420-style factory shape, adopted for the
+ * home page in #2502).
+ *
+ * Reads `settings`/`t`/`withBase`/`defaultLocale` off the context, derives
+ * `composeMetaTitle` + Head/Header/Footer/BodyEndIslands chrome from the SAME
+ * context (so the injected package-routes path and a host-bound context both
+ * render byte-identically), and computes the locale-URL prefix (`""` for the
+ * default locale, `/{locale}` otherwise) shared by the overview link, the
+ * header `currentPath`, and the "all tags" link — reproducing the exact
+ * per-route path construction `routes/index.tsx` / `routes/locale-index.tsx`
+ * did inline before this extraction.
+ */
+export declare function createHomePageView<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: HomePageViewProps) => JSX.Element;

package/dist/home-page/index.js

@@ -0,0 +1,124 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Island } from "@takazudo/zfb";
+import { DocLayoutWithDefaults } from "../doclayout/index.js";
+import { SiteTreeNav } from "../site-tree-nav-island/index.js";
+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";
+import { assertChromeContext } from "../chrome/assert-chrome-context.js";
+import { prepareHomeData } from "./prepare-home-data.js";
+function createHomePageView(ctx) {
+  assertChromeContext(ctx, "createHomePageView");
+  const settings = ctx.settings;
+  const t = ctx.t;
+  const withBase = ctx.withBase;
+  const defaultLocale = ctx.defaultLocale;
+  const composeMetaTitle = deriveComposeMetaTitle(ctx);
+  const HeadWithDefaults = createHeadWithDefaults(ctx);
+  const HeaderWithDefaults = createHeaderWithDefaults(ctx);
+  const FooterWithDefaults = createFooterWithDefaults(ctx);
+  const BodyEndIslands = deriveBodyEndIslands(ctx);
+  const homeExtras = ctx.hostBindings.homeExtras;
+  function HomePageView({
+    locale,
+    extras,
+    tree,
+    categoryOrder,
+    tagCount
+  }) {
+    const prefix = locale === defaultLocale ? "" : `/${locale}`;
+    const ctaNav = settings.headerNav[0] ?? null;
+    const overview = ctaNav ? withBase(`${prefix}${ctaNav.path}`) : null;
+    const logoUrl = withBase("/img/logo.svg");
+    const resolvedExtras = extras ?? homeExtras?.({ locale });
+    return /* @__PURE__ */ jsxs(
+      DocLayoutWithDefaults,
+      {
+        title: composeMetaTitle(settings.siteName),
+        head: /* @__PURE__ */ jsx(HeadWithDefaults, { title: settings.siteName }),
+        lang: locale,
+        noindex: settings.noindex,
+        hideSidebar: true,
+        hideToc: true,
+        sidebarOverride: /* @__PURE__ */ jsx(Fragment, {}),
+        headerOverride: /* @__PURE__ */ jsx(HeaderWithDefaults, { lang: locale, currentPath: withBase(`${prefix}/`) }),
+        footerOverride: /* @__PURE__ */ jsx(FooterWithDefaults, { lang: locale }),
+        bodyEndComponents: /* @__PURE__ */ jsx(BodyEndIslands, { basePath: settings.base ?? "/" }),
+        enableClientRouter: settings.dynamicPageTransition,
+        children: [
+          /* @__PURE__ */ jsx("div", { class: "flex justify-center mb-vsp-xl", children: /* @__PURE__ */ jsxs("div", { class: "flex flex-col items-center text-center gap-hsp-md lg:flex-row lg:text-left lg:gap-hsp-xl", children: [
+            /* @__PURE__ */ jsx(
+              "div",
+              {
+                class: "w-[320px] max-w-full aspect-[1200/630] bg-fg shrink-0",
+                style: {
+                  WebkitMask: `url(${logoUrl}) center/contain no-repeat`,
+                  mask: `url(${logoUrl}) center/contain no-repeat`
+                },
+                "aria-hidden": "true"
+              }
+            ),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs", children: settings.siteName }),
+              /* @__PURE__ */ jsx("p", { class: "text-muted text-small mb-vsp-sm", children: settings.siteDescription }),
+              /* @__PURE__ */ jsxs("div", { class: "flex items-center justify-center lg:justify-start gap-hsp-md text-small", children: [
+                overview && /* @__PURE__ */ jsxs(Fragment, { children: [
+                  /* @__PURE__ */ jsx("a", { href: overview, class: "text-fg underline hover:text-accent", children: t("nav.overview", locale) }),
+                  /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" })
+                ] }),
+                settings.githubUrl && /* @__PURE__ */ jsxs(
+                  "a",
+                  {
+                    href: settings.githubUrl,
+                    class: "inline-flex items-center gap-[0.3em] text-fg underline hover:text-accent",
+                    target: "_blank",
+                    rel: "noopener noreferrer",
+                    children: [
+                      /* @__PURE__ */ jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", class: "w-[1em] h-[1em] shrink-0", children: /* @__PURE__ */ jsx(
+                        "path",
+                        {
+                          fill: "currentColor",
+                          d: "M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"
+                        }
+                      ) }),
+                      "GitHub"
+                    ]
+                  }
+                )
+              ] }),
+              resolvedExtras
+            ] })
+          ] }) }),
+          Island({
+            when: "idle",
+            children: /* @__PURE__ */ jsx(
+              SiteTreeNav,
+              {
+                tree,
+                categoryOrder,
+                categoryIgnore: ["inbox", "develop"]
+              }
+            )
+          }),
+          settings.docTags && tagCount > 0 && /* @__PURE__ */ jsxs("section", { class: "mt-vsp-xl", children: [
+            /* @__PURE__ */ jsx("h2", { class: "text-title font-bold mb-vsp-md", children: t("doc.allTags", locale) }),
+            /* @__PURE__ */ jsx(
+              "a",
+              {
+                href: withBase(`${prefix}/docs/tags`),
+                class: "text-accent underline hover:text-accent-hover",
+                children: t("doc.allTags", locale)
+              }
+            )
+          ] })
+        ]
+      }
+    );
+  }
+  return HomePageView;
+}
+export {
+  createHomePageView,
+  prepareHomeData
+};

package/dist/home-page/prepare-home-data.d.ts

@@ -0,0 +1,46 @@
+import type { RouteContext } from "../factory-context/index.js";
+import type { NavSourceOptions } from "../nav-source-docs/index.js";
+import type { DocNavNode } from "../doc-page-props/index.js";
+export interface PrepareHomeDataOptions {
+    /**
+     * Override nav-source filtering. Default: `{}` for the default locale;
+     * `{ applyDefaultLocaleOnlyFilter: true, keepUnlisted: true }` otherwise.
+     */
+    navSourceOptions?: NavSourceOptions;
+    /**
+     * Override the category-meta directory. When set, category meta is loaded via
+     * `loadCategoryMeta(categoryMetaDir)` on BOTH branches — replacing the default
+     * locale's merged `resolveNavSource` categoryMeta and the non-default locale's
+     * `loadCategoryMeta(getLocaleConfig(locale).dir)`. When unset, the default
+     * locale uses the categoryMeta `resolveNavSource` returns and non-default
+     * locales use `loadCategoryMeta(cfg.dir)` — locale-dir-ONLY.
+     */
+    categoryMetaDir?: string;
+}
+export interface HomeData {
+    /** GROUPED tree — the post-`groupSatelliteNodes` output (spreads onto
+     *  `HomePageViewProps.tree`). */
+    tree: DocNavNode[];
+    categoryOrder: string[];
+    tagCount: number;
+}
+/**
+ * Prepare the home-page nav tree / category order / tag count for `locale`.
+ *
+ * Branches on `locale === ctx.defaultLocale`:
+ *
+ * - Default locale: `resolveNavSource(locale, undefined, {})` and its
+ *   returned `categoryMeta` (the merged base+locale meta) — unless
+ *   `options.categoryMetaDir` is set, in which case that dir is loaded via
+ *   `loadCategoryMeta` instead.
+ * - Non-default locale: requires `ctx.getLocaleConfig(locale)` — throws if
+ *   the locale isn't configured, absorbing the duplicated route/page guard —
+ *   then resolves nav source with the locale-home filter and reads category
+ *   meta from the locale dir ONLY, `loadCategoryMeta(cfg.dir)`. This is
+ *   deliberately NOT the merged base+locale categoryMeta `resolveNavSource`
+ *   returns: locale home pages historically never merged in base meta (unlike
+ *   the locale doc route), and that exact behavior is preserved here — do not
+ *   "fix" it to use the merged meta, that would silently change sidebar-grid
+ *   labels/positions.
+ */
+export declare function prepareHomeData(ctx: RouteContext, locale: string, options?: PrepareHomeDataOptions): HomeData;

package/dist/home-page/prepare-home-data.js

@@ -0,0 +1,37 @@
+import { loadCategoryMeta } from "../sidebar-tree/index.js";
+const LOCALE_NAV_SOURCE_OPTIONS = {
+  applyDefaultLocaleOnlyFilter: true,
+  keepUnlisted: true
+};
+function prepareHomeData(ctx, locale, options) {
+  let navDocs;
+  let categoryMeta;
+  if (locale === ctx.defaultLocale) {
+    const resolved = ctx.resolveNavSource(locale, void 0, options?.navSourceOptions ?? {});
+    navDocs = resolved.navDocs;
+    categoryMeta = options?.categoryMetaDir ? loadCategoryMeta(options.categoryMetaDir) : resolved.categoryMeta;
+  } else {
+    const cfg = ctx.getLocaleConfig(locale);
+    if (!cfg) {
+      throw new Error(`prepareHomeData: locale "${locale}" is not configured in settings.locales`);
+    }
+    const resolved = ctx.resolveNavSource(
+      locale,
+      void 0,
+      options?.navSourceOptions ?? LOCALE_NAV_SOURCE_OPTIONS
+    );
+    navDocs = resolved.navDocs;
+    categoryMeta = loadCategoryMeta(options?.categoryMetaDir ?? cfg.dir);
+  }
+  const tree = ctx.buildNavTree(navDocs, locale, categoryMeta, (slug, loc) => ctx.docsUrl(slug, loc));
+  const categoryOrder = ctx.getCategoryOrder();
+  const grouped = ctx.groupSatelliteNodes(tree, categoryOrder);
+  const tagCount = ctx.collectTags(
+    navDocs.filter((d) => !d.data.category_no_page),
+    (id, data) => data.slug ?? ctx.toRouteSlug(id)
+  ).size;
+  return { tree: grouped, categoryOrder, tagCount };
+}
+export {
+  prepareHomeData
+};

package/dist/integrations/doc-history/pre-build.js

@@ -2,12 +2,8 @@ import fs from "node:fs";
 import path from "node:path";
 import {
   collectContentFiles,
-  getFileCommitsMetaAsync
+  getAllFilesFirstLastMetaAsync
 } from "@takazudo/zudo-doc-history-server/git-history";
-import {
-  makeSemaphore,
-  defaultGitConcurrency
-} from "@takazudo/zudo-doc-history-server/concurrency";
 const META_OUT_RELATIVE_DIR = ".zfb";
 const META_OUT_FILENAME = "doc-history-meta.json";
 function deriveSourceExt(filePath) {
@@ -34,8 +30,6 @@ async function runDocHistoryMetaStep(options) {
       dirEntries.push([code, path.resolve(projectRoot, locale.dir)]);
     }
   }
-  const concurrency = defaultGitConcurrency();
-  const acquire = makeSemaphore(concurrency);
   const jobs = [];
   for (const [localeKey, contentDir] of dirEntries) {
     const files = collectContentFiles(contentDir);
@@ -44,36 +38,20 @@ async function runDocHistoryMetaStep(options) {
       jobs.push({ composedSlug, filePath });
     }
   }
-  const results = new Array(jobs.length).fill(null);
-  await Promise.all(
-    jobs.map(async ({ filePath }, i) => {
-      const release = await acquire();
-      try {
-        const allCommits = await getFileCommitsMetaAsync(filePath);
-        if (allCommits.length === 0) return;
-        const newestInfo = allCommits[0];
-        const oldestInfo = allCommits[allCommits.length - 1] ?? newestInfo;
-        results[i] = {
-          newest: { author: newestInfo.author, date: newestInfo.date },
-          oldest: { author: oldestInfo.author, date: oldestInfo.date }
-        };
-      } finally {
-        release();
-      }
-    })
-  );
+  const contentDirs = dirEntries.map(([, dir]) => dir);
+  const firstLast = await getAllFilesFirstLastMetaAsync(contentDirs);
   const meta = {};
-  for (let i = 0; i < jobs.length; i++) {
-    const result = results[i];
-    if (result == null) continue;
-    meta[jobs[i].composedSlug] = {
+  for (const { composedSlug, filePath } of jobs) {
+    const entry = firstLast.get(filePath);
+    if (entry == null) continue;
+    meta[composedSlug] = {
       // Author comes from the FIRST (oldest) commit.
-      author: result.oldest.author,
+      author: entry.oldest.author,
       // createdDate = oldest commit; updatedDate = newest commit.
-      createdDate: result.oldest.date,
-      updatedDate: result.newest.date,
+      createdDate: entry.oldest.date,
+      updatedDate: entry.newest.date,
       // Source extension for the view-source URL (".md" walkers accepted).
-      ext: deriveSourceExt(jobs[i].filePath)
+      ext: deriveSourceExt(filePath)
     };
   }
   fs.mkdirSync(zfbDir, { recursive: true });

package/dist/plugins/routes.js

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { existsSync, cpSync, rmSync, mkdirSync } from "node:fs";
+import { existsSync, statSync, cpSync, rmSync, mkdirSync } from "node:fs";
 import { dirname, basename, join } from "node:path";
 import { definePlugin } from "@takazudo/zfb/plugins";
 function deriveRoutes(settings) {
@@ -57,6 +57,33 @@ const plugin = definePlugin({
         tagVocabulary,
         colorSchemes
       })};
+`
+    );
+    if (typeof settings.chromeBindingsModule === "string" && settings.chromeBindingsModule.trim() === "") {
+      throw new Error(
+        'zudo-doc: settings.chromeBindingsModule is set to an empty string \u2014 set it to a project-root-relative module path (e.g. "./src/chrome-bindings.tsx") or remove the setting.'
+      );
+    }
+    const chromeBindingsModule = typeof settings.chromeBindingsModule === "string" ? settings.chromeBindingsModule : void 0;
+    let chromeBindingsAbsPath;
+    if (chromeBindingsModule) {
+      const resolved = join(ctx.projectRoot, chromeBindingsModule).split("\\").join("/");
+      if (!existsSync(resolved)) {
+        throw new Error(
+          `zudo-doc: settings.chromeBindingsModule is set to "${chromeBindingsModule}", which resolves to "${resolved}" \u2014 that file does not exist. Create it (must export a named \`chromeBindings: ChromeHostBindings\`) or remove the setting.`
+        );
+      }
+      if (!statSync(resolved).isFile()) {
+        throw new Error(
+          `zudo-doc: settings.chromeBindingsModule is set to "${chromeBindingsModule}", which resolves to "${resolved}" \u2014 that path is a directory, not a module file. Point it at a module file (e.g. "./src/chrome-bindings.tsx") or remove the setting.`
+        );
+      }
+      chromeBindingsAbsPath = resolved;
+    }
+    ctx.addVirtualModule(
+      "virtual:zudo-doc-chrome-bindings",
+      () => chromeBindingsAbsPath ? `export { chromeBindings } from ${JSON.stringify(chromeBindingsAbsPath)};
+` : `export const chromeBindings = {};
 `
     );
     const require2 = createRequire(import.meta.url);

package/dist/preset.d.ts

@@ -83,6 +83,15 @@ export interface PresetSettings {
      * succeeds). See `docs/adr/route-injection-seam.md`. (#2404)
      */
     packageOwnedRoutes?: boolean;
+    /**
+     * Project-root-relative path to a host module exporting a named
+     * `chromeBindings: ChromeHostBindings` (from `@takazudo/zudo-doc/factory-context`).
+     * Only consumed when `packageOwnedRoutes` is on — see `settings.ts` and
+     * `docs/adr/route-injection-seam.md` ("Host-callables channel") for the
+     * full contract. Omit to keep the injected chrome shim's bindings at their
+     * package-default stubs (byte-identical to today).
+     */
+    chromeBindingsModule?: string;
     /** Gate for the `/docs/tags` + `/docs/tags/[tag]` injected routes. */
     docTags?: boolean;
     /** Gate for the SSR `/api/ai-chat` injected route (`prerender: false`). */

package/dist/routes/_chrome.d.ts

@@ -8,6 +8,6 @@ export declare const composeMetaTitle: (title: string) => string, HeadWithDefaul
 }) => import("preact").JSX.Element, TagsIndexPageView: (props: {
     locale: string;
     children?: import("preact").ComponentChildren;
-}) => import("preact").JSX.Element, SiteTreeNavWrapper: import("../factory-context/index.js").FactoryComponent, BodyEndIslands: (props: import("../doc-body-end-islands/index.js").BodyEndIslandsProps) => import("preact").JSX.Element;
+}) => import("preact").JSX.Element, SiteTreeNavWrapper: import("../factory-context/index.js").FactoryComponent, BodyEndIslands: (props: import("../doc-body-end-islands/index.js").BodyEndIslandsProps) => import("preact").JSX.Element, HomePageView: (props: import("../home-page/index.js").HomePageViewProps) => import("preact").JSX.Element;
 export { buildDocRouteEntries } from "./_context.js";
 export type { DocNavNode };

package/dist/routes/_chrome.js

@@ -1,8 +1,10 @@
 import { routeCtx } from "./_context.js";
 import { createChrome } from "../chrome/index.js";
 import { DocHistory } from "../doc-history/index.js";
+import { chromeBindings } from "virtual:zudo-doc-chrome-bindings";
 const chrome = createChrome(routeCtx, {
-  DocHistory
+  DocHistory,
+  ...chromeBindings
 });
 const {
   composeMetaTitle,
@@ -16,7 +18,8 @@ const {
   TagDetailPageView,
   TagsIndexPageView,
   SiteTreeNavWrapper,
-  BodyEndIslands
+  BodyEndIslands,
+  HomePageView
 } = chrome;
 import { buildDocRouteEntries } from "./_context.js";
 export {
@@ -24,6 +27,7 @@ export {
   FooterWithDefaults,
   HeadWithDefaults,
   HeaderWithDefaults,
+  HomePageView,
   SidebarWithDefaults,
   SiteTreeNavWrapper,
   TagDetailPageView,

package/dist/routes/index.js

@@ -1,115 +1,12 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
-import { Island } from "@takazudo/zfb";
-import { DocLayoutWithDefaults } from "../doclayout/index.js";
-import { SiteTreeNav } from "../site-tree-nav-island/index.js";
-import {
-  settings,
-  defaultLocale,
-  t,
-  withBase,
-  resolveNavSource,
-  buildNavTree,
-  groupSatelliteNodes,
-  getCategoryOrder,
-  collectTags,
-  docsUrl,
-  toRouteSlug
-} from "./_context.js";
-import {
-  HeadWithDefaults,
-  HeaderWithDefaults,
-  FooterWithDefaults,
-  BodyEndIslands,
-  composeMetaTitle
-} from "./_chrome.js";
+import { jsx } from "preact/jsx-runtime";
+import { defaultLocale, routeCtx } from "./_context.js";
+import { prepareHomeData } from "../home-page/prepare-home-data.js";
+import { HomePageView } from "./_chrome.js";
 const frontmatter = { title: "Home" };
 function IndexPage() {
   const locale = defaultLocale;
-  const { navDocs, categoryMeta } = resolveNavSource(locale, void 0);
-  const tree = buildNavTree(
-    navDocs,
-    locale,
-    categoryMeta,
-    (slug, loc) => docsUrl(slug, loc)
-  );
-  const categoryOrder = getCategoryOrder();
-  const groupedTree = groupSatelliteNodes(tree, categoryOrder);
-  const tagCount = collectTags(
-    navDocs.filter((d) => !d.data.category_no_page),
-    (id, data) => data.slug ?? toRouteSlug(id)
-  ).size;
-  const ctaNav = settings.headerNav[0] ?? null;
-  const overview = ctaNav ? withBase(ctaNav.path) : null;
-  const logoUrl = withBase("/img/logo.svg");
-  return /* @__PURE__ */ jsxs(
-    DocLayoutWithDefaults,
-    {
-      title: composeMetaTitle(settings.siteName),
-      head: /* @__PURE__ */ jsx(HeadWithDefaults, { title: settings.siteName }),
-      lang: locale,
-      noindex: settings.noindex,
-      hideSidebar: true,
-      hideToc: true,
-      sidebarOverride: /* @__PURE__ */ jsx(Fragment, {}),
-      headerOverride: /* @__PURE__ */ jsx(HeaderWithDefaults, { lang: locale, currentPath: withBase("/") }),
-      footerOverride: /* @__PURE__ */ jsx(FooterWithDefaults, { lang: locale }),
-      bodyEndComponents: /* @__PURE__ */ jsx(BodyEndIslands, { basePath: settings.base ?? "/" }),
-      enableClientRouter: settings.dynamicPageTransition,
-      children: [
-        /* @__PURE__ */ jsx("div", { class: "flex justify-center mb-vsp-xl", children: /* @__PURE__ */ jsxs("div", { class: "flex flex-col items-center text-center gap-hsp-md lg:flex-row lg:text-left lg:gap-hsp-xl", children: [
-          /* @__PURE__ */ jsx(
-            "div",
-            {
-              class: "w-[320px] max-w-full aspect-[1200/630] bg-fg shrink-0",
-              style: {
-                WebkitMask: `url(${logoUrl}) center/contain no-repeat`,
-                mask: `url(${logoUrl}) center/contain no-repeat`
-              },
-              "aria-hidden": "true"
-            }
-          ),
-          /* @__PURE__ */ jsxs("div", { children: [
-            /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs", children: settings.siteName }),
-            /* @__PURE__ */ jsx("p", { class: "text-muted text-small mb-vsp-sm", children: settings.siteDescription }),
-            /* @__PURE__ */ jsxs("div", { class: "flex items-center justify-center lg:justify-start gap-hsp-md text-small", children: [
-              overview && /* @__PURE__ */ jsxs(Fragment, { children: [
-                /* @__PURE__ */ jsx("a", { href: overview, class: "text-fg underline hover:text-accent", children: t("nav.overview", locale) }),
-                /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" })
-              ] }),
-              settings.githubUrl && /* @__PURE__ */ jsxs(Fragment, { children: [
-                /* @__PURE__ */ jsx(
-                  "a",
-                  {
-                    href: settings.githubUrl,
-                    class: "inline-flex items-center gap-[0.3em] text-fg underline hover:text-accent",
-                    target: "_blank",
-                    rel: "noopener noreferrer",
-                    children: "GitHub"
-                  }
-                ),
-                /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" })
-              ] })
-            ] })
-          ] })
-        ] }) }),
-        Island({
-          when: "idle",
-          children: /* @__PURE__ */ jsx(
-            SiteTreeNav,
-            {
-              tree: groupedTree,
-              categoryOrder,
-              categoryIgnore: ["inbox", "develop"]
-            }
-          )
-        }),
-        settings.docTags && tagCount > 0 && /* @__PURE__ */ jsxs("section", { class: "mt-vsp-xl", children: [
-          /* @__PURE__ */ jsx("h2", { class: "text-title font-bold mb-vsp-md", children: t("doc.allTags", locale) }),
-          /* @__PURE__ */ jsx("a", { href: withBase("/docs/tags"), class: "text-accent underline hover:text-accent-hover", children: t("doc.allTags", locale) })
-        ] })
-      ]
-    }
-  );
+  const { tree, categoryOrder, tagCount } = prepareHomeData(routeCtx, locale);
+  return /* @__PURE__ */ jsx(HomePageView, { locale, tree, categoryOrder, tagCount });
 }
 export {
   IndexPage as default,