create-zudo-doc 0.2.17 → 0.2.18

package/dist/features/dynamic-page-transition.d.ts

@@ -2,10 +2,15 @@ import type { FeatureModule } from "../compose.js";
 /**
  * Dynamic page transition feature.
  *
- * When enabled, wires the SPA client-side router (ClientRouterBootstrap
- * island) and the page-loading overlay (PageLoadingOverlay, pure SSR) into
- * body-end-islands, and injects the View-Transitions CSS + page-loading
- * overlay CSS into global.css.
+ * When enabled:
+ * - Sets `enableClientRouter={settings.dynamicPageTransition}` on every
+ *   `<DocLayoutWithDefaults>` render site — the SSR `<ClientRouter />` render
+ *   self-activates the SPA router on the client as a top-level module side
+ *   effect (primary activation path).
+ * - Wires the ClientRouterBootstrap island and the PageLoadingOverlay (pure
+ *   SSR) into body-end-islands — the island is now a redundant fallback;
+ *   PageLoadingOverlay provides the loading spinner UI.
+ * - Injects the View-Transitions CSS + page-loading overlay CSS into global.css.
  *
  * Bug fix (#2265): the page-loading overlay CSS (.page-loading-overlay /
  * .page-loading-spinner / @keyframes page-loading-spin / [data-zd-nav-pending])

package/dist/features/dynamic-page-transition.js

@@ -1,10 +1,15 @@
 /**
  * Dynamic page transition feature.
  *
- * When enabled, wires the SPA client-side router (ClientRouterBootstrap
- * island) and the page-loading overlay (PageLoadingOverlay, pure SSR) into
- * body-end-islands, and injects the View-Transitions CSS + page-loading
- * overlay CSS into global.css.
+ * When enabled:
+ * - Sets `enableClientRouter={settings.dynamicPageTransition}` on every
+ *   `<DocLayoutWithDefaults>` render site — the SSR `<ClientRouter />` render
+ *   self-activates the SPA router on the client as a top-level module side
+ *   effect (primary activation path).
+ * - Wires the ClientRouterBootstrap island and the PageLoadingOverlay (pure
+ *   SSR) into body-end-islands — the island is now a redundant fallback;
+ *   PageLoadingOverlay provides the loading spinner UI.
+ * - Injects the View-Transitions CSS + page-loading overlay CSS into global.css.
  *
  * Bug fix (#2265): the page-loading overlay CSS (.page-loading-overlay /
  * .page-loading-spinner / @keyframes page-loading-spin / [data-zd-nav-pending])

package/dist/scaffold.js

@@ -463,7 +463,7 @@ function generatePackageJson(choices) {
         // ties this pin to packages/zudo-doc's version, so the lockstep release
         // bumps both together; do not cut a create-zudo-doc release until the
         // matching @takazudo/zudo-doc version (with content.css) is on npm.
-        "@takazudo/zudo-doc": "^0.2.17",
+        "@takazudo/zudo-doc": "^0.2.18",
         // zod — used by the generated zfb.config.ts. zfb-config-gen emits
         // `import { z } from "zod"` for the content-collection schema +
         // `z.toJSONSchema(...)` conversion. Without this dep, the consumer
@@ -517,7 +517,7 @@ function generatePackageJson(choices) {
         // @takazudo/zudo-doc/integrations/doc-history which in turn imports
         // @takazudo/zudo-doc-history-server/git-history. Without this dep the
         // plugin host fails at init with ERR_MODULE_NOT_FOUND — W8A (#1739).
-        deps["@takazudo/zudo-doc-history-server"] = "^0.2.17";
+        deps["@takazudo/zudo-doc-history-server"] = "^0.2.18";
         // W7A (#1736): doc-history-plugin.mjs spawns `tsx -e <inline-script>` to
         // run the v2 runtime in a TS-aware Node subprocess; without tsx the
         // plugin's preBuild step exits with ENOENT before zfb finishes config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-zudo-doc",
-  "version": "0.2.17",
+  "version": "0.2.18",
   "description": "Create a new zudo-doc documentation site",
   "license": "MIT",
   "author": "Takeshi Takatsudo",

package/templates/base/pages/404.tsx

@@ -44,6 +44,7 @@ export default function NotFoundPage(): JSX.Element {
       headerOverride={<HeaderWithDefaults lang={locale} />}
       footerOverride={<FooterWithDefaults lang={locale} />}
       bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+      enableClientRouter={settings.dynamicPageTransition}
     >
       <div class="min-h-[60vh] flex flex-col items-center justify-center px-hsp-2xl py-vsp-xl">
         <h1 class="text-display font-bold mb-vsp-md">404</h1>

package/templates/base/pages/index.tsx

@@ -73,6 +73,7 @@ export default function IndexPage(): JSX.Element {
       headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase("/")} />}
       footerOverride={<FooterWithDefaults lang={locale} />}
       bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+      enableClientRouter={settings.dynamicPageTransition}
     >
       {/* Hero: logo left, title+desc+links right, block centered */}
       <div class="flex justify-center mb-vsp-xl">

package/templates/base/pages/lib/_doc-body-end.tsx

@@ -18,8 +18,14 @@ import { SidebarResizerInit } from "@takazudo/zudo-doc/sidebar-resizer";
 
 /**
  * The `bodyEndComponents` slot content shared by all four doc-route page
- * components: `BodyEndIslands` (modal overlays, client-router bootstrap,
- * image-enlarge) and the optional `SidebarResizerInit` drag handle.
+ * components: `BodyEndIslands` (modal overlays, optional client-router
+ * bootstrap when `dynamicPageTransition` is on, image-enlarge) and the
+ * optional `SidebarResizerInit` drag handle. Whether the client-router
+ * bootstrap island is included depends on `settings.dynamicPageTransition`
+ * (gated inside `BodyEndIslands`). The SSR `<ClientRouter />` mounted by
+ * `DocLayout` self-activates when `enableClientRouter` is `true`; the
+ * island here is redundant for that activation path and kept only for the
+ * `when="load"` hydration slot.
  */
 export function DocBodyEnd(): JSX.Element {
   return (

package/templates/base/pages/lib/_doc-page-shell.tsx

@@ -218,6 +218,7 @@ export function DocPageShell(props: DocPageShellProps): JSX.Element {
       afterSidebar={<SidebarPrepaint />}
       footerOverride={<FooterWithDefaults lang={locale} />}
       bodyEndComponents={<DocBodyEnd />}
+      enableClientRouter={settings.dynamicPageTransition}
     >
       {kind === "autoIndex" ? (
         /* Auto-index page: category without an index.mdx.

package/templates/features/docTags/files/pages/lib/_tag-pages.tsx

@@ -142,6 +142,7 @@ export function TagDetailPageView({
       breadcrumbOverride={<Breadcrumb items={breadcrumbItems} />}
       footerOverride={<FooterWithDefaults lang={locale} />}
       bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+      enableClientRouter={settings.dynamicPageTransition}
     >
       <h1 class="text-heading font-bold mb-vsp-xs">{pageTitle}</h1>
       <p class="text-muted mb-vsp-lg">{countText}</p>
@@ -198,6 +199,7 @@ export function TagsIndexPageView({ locale }: { locale: string }): JSX.Element {
       breadcrumbOverride={<Breadcrumb items={breadcrumbItems} />}
       footerOverride={<FooterWithDefaults lang={locale} />}
       bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+      enableClientRouter={settings.dynamicPageTransition}
     >
       <h1 class="text-heading font-bold mb-vsp-lg">{pageTitle}</h1>
       {!settings.docTags || tags.length === 0 ? (

package/templates/features/dynamicPageTransition/files/src/components/client-router-bootstrap.tsx

@@ -51,6 +51,14 @@ import type { JSX } from "preact";
  * walks page → BodyEndIslands → ClientRouterBootstrap and includes the
  * client-router barrel in the per-island bundle, where the side-effect
  * import above can fire on the client.
+ *
+ * Note: the SSR `<ClientRouter />` mounted by `DocLayout` (via
+ * `enableClientRouter`) self-activates the SPA router when its head meta
+ * tags reach the browser. This host island is therefore a no-op for
+ * router activation — it is kept only for the `when="load"` hydration
+ * slot and bundle inclusion. The actual on/off gate is
+ * `enableClientRouter` on `<DocLayoutWithDefaults>`, set to
+ * `settings.dynamicPageTransition` at every call site.
  */
 function ClientRouterBootstrap(): JSX.Element | null {
   return null;

package/templates/features/i18n/files/pages/[locale]/index.tsx

@@ -117,6 +117,7 @@ export default function LocaleIndexPage({ params }: PageArgs): JSX.Element {
       headerOverride={<HeaderWithDefaults lang={locale as Locale} currentPath={withBase(`/${locale}/`)} />}
       footerOverride={<FooterWithDefaults lang={locale} />}
       bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+      enableClientRouter={settings.dynamicPageTransition}
     >
       {/* Hero: logo left, title+desc+links right, block centered */}
       <div class="flex justify-center mb-vsp-xl">

package/templates/features/versioning/files/pages/lib/_versions-page.tsx

@@ -73,6 +73,7 @@ export function VersionsPageView({ locale }: { locale: string }): JSX.Element {
       headerOverride={<HeaderWithDefaults lang={locale as Locale} currentPath={withBase(`${prefix}/docs/versions`)} />}
       footerOverride={<FooterWithDefaults lang={locale} />}
       bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+      enableClientRouter={settings.dynamicPageTransition}
     >
       <VersionsPageContent
         latestHref={latestHref}