@takazudo/zudo-doc 2.2.0 → 2.2.1

package/dist/routes/_chrome.js

@@ -1,6 +1,9 @@
 import { routeCtx } from "./_context.js";
 import { createChrome } from "../chrome/index.js";
-const chrome = createChrome(routeCtx);
+import { DocHistory } from "../doc-history/index.js";
+const chrome = createChrome(routeCtx, {
+  DocHistory
+});
 const {
   composeMetaTitle,
   HeadWithDefaults,

package/package.json

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

package/routes-src/_chrome.tsx

@@ -4,17 +4,33 @@
 // 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.
+// that calls it ONCE with the reconstructed route context and the single
+// DocHistory host binding needed for island registration (see below) — every
+// OTHER host-bound slot resolves to its package-default stub, so the injected
+// package-routes render stays byte-identical. The host (HOSTCOLLAPSE wave) will
+// call `createChrome` directly with its full real bindings.
 
 import { routeCtx } from "./_context.js";
 import { createChrome } from "@takazudo/zudo-doc/chrome";
+import { DocHistory } from "@takazudo/zudo-doc/doc-history";
+import type { ChromeHostBindings } from "@takazudo/zudo-doc/factory-context";
 import type { DocNavNode } from "./_docs-helpers.js";
 
-// Empty host bindings → package-default stubs (byte-identical injected path).
-const chrome = createChrome(routeCtx);
+// Island-scanner contract (load-bearing): the injected doc routes reach the real
+// DocHistory client island ONLY through this static import → `createChrome`
+// hostBindings chain (docs-slug.tsx → _chrome.tsx → DocHistory). Without it,
+// `deriveDocHistorySlot` falls back to the no-op stub, the SSR marker
+// `data-zfb-island-skip-ssr="DocHistory"` has no matching registry entry, and the
+// History button never hydrates under `packageOwnedRoutes` (zudolab/zudo-doc#2480).
+// The import MUST stay static — a dynamic/type-only import stops zfb's island
+// scanner from walking it. SSR output is unchanged: `DocHistoryArea` gates on
+// `settings.docHistory` and the island is skip-SSR, so binding the real component
+// vs the stub is byte-identical. Mirrors the host's `pages/lib/_chrome.ts`.
+// (The narrow real-island props signature isn't assignable to the structural
+// `FactoryComponent`, so cast — same as the host.)
+const chrome = createChrome(routeCtx, {
+  DocHistory: DocHistory as unknown as ChromeHostBindings["DocHistory"],
+});
 
 export const {
   composeMetaTitle,