create-zudo-doc 2.2.2 → 2.4.0

package/dist/scaffold.d.ts

@@ -11,5 +11,5 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export declare const ZUDO_DOC_PIN = "^2.2.2";
+export declare const ZUDO_DOC_PIN = "^2.4.0";
 export declare function scaffold(choices: UserChoices): Promise<void>;

package/dist/scaffold.js

@@ -18,7 +18,7 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^2.2.2";
+export const ZUDO_DOC_PIN = "^2.4.0";
 /**
  * Files in `templates/base/**` that must never be copied into a generated
  * project. Each entry is matched against the path relative to `templates/base/`
@@ -486,14 +486,18 @@ function generatePackageJson(choices) {
         // zfb external-@import hoisting work. No consumer-facing / CLI change.
         // next.72: routine toolchain bump from next.71, adopted in
         // lockstep with the root package.json pins. No consumer-facing / CLI change.
-        // next.74 (current pin): routine toolchain bump from next.72 (next.73
+        // next.74: routine toolchain bump from next.72 (next.73
         // skipped), adopted in lockstep with the root package.json pins. No
         // consumer-facing / CLI change.
-        "@takazudo/zfb": "0.1.0-next.74",
-        "@takazudo/zfb-runtime": "0.1.0-next.74",
+        // next.75 (current pin): toolchain bump from next.74 restoring Tailwind
+        // class-candidate scanning through symlinked project trees
+        // (zudolab/zudo-doc#2511), adopted in lockstep with the root package.json
+        // pins. No consumer-facing / CLI change.
+        "@takazudo/zfb": "0.1.0-next.75",
+        "@takazudo/zfb-runtime": "0.1.0-next.75",
         // zfb-adapter-cloudflare — required for any route with `prerender = false`.
         // Pinned in lockstep with @takazudo/zfb.
-        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.74",
+        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.75",
         // @takazudo/zudo-doc — published from this monorepo via
         // .github/workflows/publish-zudo-doc.yml. The pin here is bumped in
         // lockstep by scripts/release-create-zudo-doc.sh whenever zudo-doc's
@@ -576,7 +580,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"] = "^2.2.2";
+        deps["@takazudo/zudo-doc-history-server"] = "^2.4.0";
         // tsx is no longer needed here: the relocated package plugin imports the
         // runner directly (no `tsx -e` spawn) since the package ships compiled
         // dist/ — package-first migration #2321 (#2337).

package/package.json

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

package/templates/base/pages/index.tsx

@@ -3,166 +3,39 @@
 // Page module for the site index route.
 //
 // Default-locale (EN) site index. Static route — no paths() export needed.
-// Collects the EN docs tree and renders the site-map grid plus optional
-// tag count.
+// Hands the resolved locale to the shared `prepareHomeData` factory (#2519)
+// — which now owns the nav-tree / tag-count data-prep sequence — and passes
+// the result to the shared HomePageView body (epic #2499, S4 #2503).
 //
 // Data flow:
-//   getCollection("docs")   [sync, zfb ADR-004]
-//   → buildNavTree()        builds the nav tree for the sitemap grid
-//   → collectTags()         counts unique tags for the tag section header
-//   → DocLayoutWithDefaults renders the page with no sidebar/TOC
-
-import { settings } from "@/config/settings";
-import { defaultLocale, t } from "@/config/i18n";
-import { withBase } from "@/utils/base";
-import {
-  buildNavTree,
-  groupSatelliteNodes,
-} from "@/utils/docs";
-import { resolveNavSource } from "./lib/_nav-source-docs";
-import { getCategoryOrder } from "@/utils/nav-scope";
-import { collectTags } from "@/utils/tags";
-import { toRouteSlug } from "@/utils/slug";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
+//   routeContext              host RouteContext (settings + i18n + nav helpers)
+//   → prepareHomeData()       nav tree, category order, tag count
+//   → HomePageView            renders hero + SiteTreeNav grid + tag section
+//
+// Thin consumer of `HomePageView` (S3 #2502) and `prepareHomeData` (#2519):
+// this file's only job is resolving the default locale — mirroring the
+// package route's shape (`packages/zudo-doc/src/routes/index.tsx`). No
+// `extras` here — the showcase's `@Takazudo` brand link (#1453) is
+// project-specific and is not part of the generated project's hero.
+
+import { routeContext } from "./lib/_route-context";
+import { prepareHomeData } from "@takazudo/zudo-doc/home-page";
 import type { JSX } from "preact";
-import type { VNode } from "preact";
-import { Island } from "@takazudo/zfb";
-import { SiteTreeNav } from "@takazudo/zudo-doc/site-tree-nav-island";
-import {
-  FooterWithDefaults,
-  HeaderWithDefaults,
-  HeadWithDefaults,
-  composeMetaTitle,
-} from "./lib/_chrome";
-import { BodyEndIslands } from "./lib/_body-end-islands";
+import { HomePageView } from "./lib/_chrome";
 
 export const frontmatter = { title: "Home" };
 
 export default function IndexPage(): JSX.Element {
-  const locale = defaultLocale;
-
-  // Identity-stable nav source (draft-filtered, unlisted retained). navDocs is
-  // pre-filtered (isNavVisible) and shared with the nav-tree fast-path.
-  const { navDocs, categoryMeta } = resolveNavSource(locale, undefined);
-  const tree = buildNavTree(navDocs, locale, categoryMeta);
-  const categoryOrder = getCategoryOrder();
-  const groupedTree = groupSatelliteNodes(tree, categoryOrder);
+  const locale = routeContext.defaultLocale;
 
-  // Drop category_no_page index files so the count matches the number of tag
-  // pages actually built (the tag routes exclude them too).
-  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");
+  const { tree, categoryOrder, tagCount } = prepareHomeData(routeContext, locale);
 
   return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(settings.siteName)}
-      head={<HeadWithDefaults title={settings.siteName} />}
-      lang={locale}
-      noindex={settings.noindex}
-      hideSidebar={true}
-      hideToc={true}
-      // Empty fragment suppresses DocLayoutWithDefaults' empty-data default
-      // Sidebar island — its marker never hydrates for published-package
-      // consumers (zfb#999) and zfb >= next.38 warns about it; the sidebar is
-      // hidden on this page anyway (zudolab/zudo-doc#2057).
-      sidebarOverride={<></>}
-      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">
-        <div class="flex flex-col items-center text-center gap-hsp-md lg:flex-row lg:text-left lg:gap-hsp-xl">
-          {/* Theme-adaptive logo: SVG used as a CSS mask over `bg-fg` so the
-              foreground color follows the active theme (white on dark, black on
-              light). The neighboring <h1>{settings.siteName}</h1> provides the
-              accessible name; mirrors zudolab/zudo-design-token-lint#65. */}
-          <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"
-          />
-          <div>
-            <h1 class="text-heading font-bold mb-vsp-2xs">{settings.siteName}</h1>
-            <p class="text-muted text-small mb-vsp-sm">{settings.siteDescription}</p>
-            <div class="flex items-center justify-center lg:justify-start gap-hsp-md text-small">
-              {overview && (
-                <>
-                  <a href={overview} class="text-fg underline hover:text-accent">
-                    {t("nav.overview", locale)}
-                  </a>
-                  <span class="text-muted">/</span>
-                </>
-              )}
-              {settings.githubUrl && (
-                <>
-                  <a
-                    href={settings.githubUrl as string}
-                    class="inline-flex items-center gap-[0.3em] text-fg underline hover:text-accent"
-                    target="_blank"
-                    rel="noopener noreferrer"
-                  >
-                    <svg viewBox="0 0 16 16" aria-hidden="true" class="w-[1em] h-[1em] shrink-0">
-                      <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"
-                      />
-                    </svg>
-                    GitHub
-                  </a>
-                  <span class="text-muted">/</span>
-                </>
-              )}
-              {/* @Takazudo link — established in #1453 (project-specific brand link).
-                  The deploy was missing this trailing item, leaving a dangling "/" separator. */}
-              <a
-                href="https://x.com/Takazudo"
-                class="text-fg underline hover:text-accent"
-                target="_blank"
-                rel="noopener noreferrer"
-              >
-                @Takazudo
-              </a>
-            </div>
-          </div>
-        </div>
-      </div>
-
-      {/* Sitemap grid — restored to the original SiteTreeNav island (refs #1453).
-          The Astro reference used <Island when="idle"><SiteTreeNav ...></Island>.
-          DocsSitemap (vertical <details> list) was incorrect; SiteTreeNav gives
-          the responsive multi-column grid the reference renders. */}
-      {Island({
-        when: "idle",
-        children: (
-          <SiteTreeNav
-            tree={groupedTree}
-            categoryOrder={categoryOrder}
-            categoryIgnore={["inbox", "develop"]}
-          />
-        ),
-      }) as unknown as VNode}
-
-      {settings.docTags && tagCount > 0 && (
-        <section class="mt-vsp-xl">
-          <h2 class="text-title font-bold mb-vsp-md">
-            {t("doc.allTags", locale)}
-          </h2>
-          <a href={withBase("/docs/tags")} class="text-accent underline hover:text-accent-hover">
-            {t("doc.allTags", locale)}
-          </a>
-        </section>
-      )}
-    </DocLayoutWithDefaults>
+    <HomePageView
+      locale={locale}
+      tree={tree}
+      categoryOrder={categoryOrder}
+      tagCount={tagCount}
+    />
   );
 }

package/templates/base/pages/lib/_chrome.ts

@@ -163,4 +163,5 @@ export const {
   TagsIndexPageView,
   SiteTreeNavWrapper,
   BodyEndIslands,
+  HomePageView,
 } = chrome;

package/templates/base/src/config/color-schemes.ts

@@ -88,15 +88,16 @@ export const colorSchemes: Record<string, ColorScheme> = {
     ],
     semantic: {
       surface: 10,
-      muted: 8,
+      muted: "oklch(0.492 0.000 0.00)" /* upstream #6b6b6b (p8) → L-0.036 for AA (scheme-a11y #2489) */, // muted-vs-bg → 4.61:1
       accent: 5,
-      accentHover: 14,
+      accentHover: "oklch(0.492 0.027 257.67)" /* upstream #8590a0 (p14) → L-0.158, C-0.000 for AA (scheme-a11y #2489) */, // accent-hover-vs-bg → 4.61:1
       codeBg: 10,
       codeFg: 11,
       success: 2,
       danger: 1,
       warning: 3,
       info: 4,
+      mermaidNoteBg: "oklch(0.821 0.007 53.44)" /* derived bg-elevated from bg (p9) — default (p0) collided 1:1 with mermaidText/p11 (scheme-a11y #2489) */,
       imageOverlayBg: 11,
       imageOverlayFg: 10,
       matchedKeywordBg: "oklch(0.959 0.109 102.63)" /* #fff59d */,
@@ -117,13 +118,13 @@ export const colorSchemes: Record<string, ColorScheme> = {
     ],
     semantic: {
       surface: 0,
-      muted: 8,
+      muted: "oklch(0.657 0.000 0.00)" /* upstream #888888 (p8) → L+0.030 for AA (scheme-a11y #2489) */, // muted-vs-{bg,codeBg,chatAssistantBg} → 4.62:1
       accent: 12,
       accentHover: 14,
-      codeBg: 10,
+      codeBg: "oklch(0.281 0.000 0.00)" /* upstream #383838 (p10) → L-0.060 toward bg for muted-vs-codeBg AA (rendered-bg #2510) */,
       codeFg: 11,
       success: 2,
-      danger: 1,
+      danger: "oklch(0.662 0.143 16.99)" /* upstream #da6871 → L+0.006 for AA (scheme-a11y #2489) */, // admonition-danger → 4.61:1
       warning: 3,
       info: 4,
       imageOverlayBg: 0,

package/templates/features/claudeResources/files/src/integrations/claude-resources/__tests__/escape-for-mdx.test.ts

@@ -31,4 +31,12 @@ describe("escapeForMdx", () => {
   it("escapes self-closing non-allowlisted component tags", () => {
     expect(escapeForMdx("<Component />")).toMatch(/&lt;Component\s*\/&gt;/);
   });
+
+  it("escapes the compact self-closing form <Foo/> (no space before slash)", () => {
+    // Regression: the opening-tag regex only matches the spaced form <Foo />,
+    // so the compact <Foo/> needs the dedicated self-closing branch.
+    const out = escapeForMdx("<Foo/>");
+    expect(out).toBe("&lt;Foo/&gt;");
+    expect(out).not.toContain("<Foo/>");
+  });
 });

package/templates/features/claudeResources/files/src/integrations/claude-resources/escape-for-mdx.ts

@@ -67,7 +67,11 @@ export function escapeForMdx(content: string): string {
             return `</${name}>`;
           },
         )
-        // Escape self-closing tags: <Name />
+        // Escape self-closing tags. The spaced form <Foo /> is already handled
+        // by the opening-tag regex above ((\s[^>]*)? matches " /", then > closes),
+        // but the COMPACT form <Foo/> (no space before the slash) is NOT — the
+        // name is consumed, (\s[^>]*)? matches empty, then the regex needs ">"
+        // and finds "/". So this branch is still required for the compact form.
         .replace(
           /<([A-Za-z][A-Za-z0-9_-]*)(\s[^>]*)?\s*\/>/g,
           (match, name: string) => {
@@ -84,7 +88,7 @@ export function escapeForMdx(content: string): string {
       // Restore inline code placeholders
       escaped = escaped.replace(
         new RegExp(`${inlinePlaceholder}(\\d+)\x00`, "g"),
-        (_, idx: string) => inlineCodes[Number(idx)],
+        (_, idx: string) => inlineCodes[Number(idx)] ?? "",
       );
 
       return escaped;

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

@@ -11,34 +11,24 @@
 //   props:  { locale }           — resolved locale passed to component
 //
 // Data flow (inside component — sync per ADR-004):
-//   getCollection(`docs-${locale}`)  + base fallback merge
-//   → buildNavTree()   → groupSatelliteNodes()
-//   → collectTags()    → tag section
+//   routeContext              host RouteContext (settings + i18n + nav helpers)
+//   → prepareHomeData()       nav tree, category order, tag count
+//   → HomePageView            renders hero + SiteTreeNav grid + tag section
+//
+// Thin consumer of `HomePageView` (S3 #2502) and `prepareHomeData` (#2519):
+// this file's only job is `paths()` (a locale-routing concern) — mirroring
+// the package route's shape (`packages/zudo-doc/src/routes/locale-index.tsx`).
+// The locale-specific data prep — `resolveNavSource` with the locale-home
+// filter options, `loadCategoryMeta`, and the locale-config guard — now lives
+// in `prepareHomeData`. No `extras` here — the showcase's `@Takazudo` brand
+// link (#1453) is project-specific and is not part of the generated
+// project's hero.
 
 import { settings } from "@/config/settings";
-import { t, getLocaleConfig, type Locale } from "@/config/i18n";
-import { withBase } from "@/utils/base";
-import {
-  buildNavTree,
-  groupSatelliteNodes,
-  loadCategoryMeta,
-} from "@/utils/docs";
-import { getCategoryOrder } from "@/utils/nav-scope";
-import { collectTags } from "@/utils/tags";
-import { toRouteSlug } from "@/utils/slug";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
+import { routeContext } from "../lib/_route-context";
+import { prepareHomeData } from "@takazudo/zudo-doc/home-page";
 import type { JSX } from "preact";
-import type { VNode } from "preact";
-import { Island } from "@takazudo/zfb";
-import { SiteTreeNav } from "@takazudo/zudo-doc/site-tree-nav-island";
-import { resolveNavSource } from "../lib/_nav-source-docs";
-import {
-  FooterWithDefaults,
-  HeaderWithDefaults,
-  HeadWithDefaults,
-  composeMetaTitle,
-} from "../lib/_chrome";
-import { BodyEndIslands } from "../lib/_body-end-islands";
+import { HomePageView } from "../lib/_chrome";
 
 export const frontmatter = { title: "Home" };
 
@@ -69,147 +59,14 @@ interface PageArgs {
 export default function LocaleIndexPage({ params }: PageArgs): JSX.Element {
   const locale = params.locale;
 
-  // Guard: paths() only emits routes for locales defined in settings.locales,
-  // but the component can still be exercised with an unconfigured locale value
-  // (e.g. during testing or if the router dispatches an unexpected param).
-  // Fail loudly rather than silently serving EN content under a bogus prefix.
-  const cfg = getLocaleConfig(locale);
-  if (!cfg) {
-    throw new Error(`LocaleIndexPage: locale "${locale}" is not configured in settings.locales`);
-  }
-
-  // Identity-stable, locale-first merge with EN fallback (shared `navDocs`
-  // instance). categoryMeta is intentionally locale-dir-only here — this page
-  // historically did NOT merge in base meta (unlike the locale doc route), so
-  // we keep that exact behavior to preserve output.
-  const { navDocs } = resolveNavSource(locale as Locale, undefined, {
-    applyDefaultLocaleOnlyFilter: true,
-    keepUnlisted: true,
-  });
-  const categoryMeta = loadCategoryMeta(cfg.dir);
-
-  const tree = buildNavTree(navDocs, locale as Locale, categoryMeta);
-  const categoryOrder = getCategoryOrder();
-  const groupedTree = groupSatelliteNodes(tree, categoryOrder);
-
-  // Drop category_no_page index files so the count matches the number of tag
-  // pages actually built (the tag routes exclude them too).
-  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(`/${locale}${ctaNav.path}`) : null;
-  const logoUrl = withBase("/img/logo.svg");
+  const { tree, categoryOrder, tagCount } = prepareHomeData(routeContext, locale);
 
   return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(settings.siteName)}
-      head={<HeadWithDefaults title={settings.siteName} />}
-      lang={locale}
-      noindex={settings.noindex}
-      hideSidebar={true}
-      hideToc={true}
-      // Empty fragment suppresses DocLayoutWithDefaults' empty-data default
-      // Sidebar island — its marker never hydrates for published-package
-      // consumers (zfb#999) and zfb >= next.38 warns about it; the sidebar is
-      // hidden on this page anyway (zudolab/zudo-doc#2057).
-      sidebarOverride={<></>}
-      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">
-        <div class="flex flex-col items-center text-center gap-hsp-md lg:flex-row lg:text-left lg:gap-hsp-xl">
-          {/* Theme-adaptive logo: SVG used as a CSS mask over `bg-fg` so the
-              foreground color follows the active theme (white on dark, black on
-              light). The neighboring <h1>{settings.siteName}</h1> provides the
-              accessible name; mirrors zudolab/zudo-design-token-lint#65. */}
-          <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"
-          />
-          <div>
-            <h1 class="text-heading font-bold mb-vsp-2xs">{settings.siteName}</h1>
-            <p class="text-muted text-small mb-vsp-sm">{settings.siteDescription}</p>
-            <div class="flex items-center justify-center lg:justify-start gap-hsp-md text-small">
-              {overview && (
-                <>
-                  <a href={overview} class="text-fg underline hover:text-accent">
-                    {t("nav.overview", locale)}
-                  </a>
-                  <span class="text-muted">/</span>
-                </>
-              )}
-              {settings.githubUrl && (
-                <>
-                  <a
-                    href={settings.githubUrl as string}
-                    class="inline-flex items-center gap-[0.3em] text-fg underline hover:text-accent"
-                    target="_blank"
-                    rel="noopener noreferrer"
-                  >
-                    <svg viewBox="0 0 16 16" aria-hidden="true" class="w-[1em] h-[1em] shrink-0">
-                      <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"
-                      />
-                    </svg>
-                    GitHub
-                  </a>
-                  <span class="text-muted">/</span>
-                </>
-              )}
-              {/* @Takazudo link — ported from pages/index.tsx (refs #1453).
-                  The locale home was missing this trailing item, leaving a
-                  dangling "/" separator after GitHub. */}
-              <a
-                href="https://x.com/Takazudo"
-                class="text-fg underline hover:text-accent"
-                target="_blank"
-                rel="noopener noreferrer"
-              >
-                @Takazudo
-              </a>
-            </div>
-          </div>
-        </div>
-      </div>
-
-      {/* Sitemap grid — SiteTreeNav island mirrors the EN home (refs #1453).
-          The locale home was using DocsSitemap (vertical <details> list);
-          replaced with the same SiteTreeNav island used by pages/index.tsx. */}
-      {Island({
-        when: "idle",
-        children: (
-          <SiteTreeNav
-            tree={groupedTree}
-            categoryOrder={categoryOrder}
-            categoryIgnore={["inbox", "develop"]}
-          />
-        ),
-      }) as unknown as VNode}
-
-      {settings.docTags && tagCount > 0 && (
-        <section class="mt-vsp-xl">
-          <h2 class="text-title font-bold mb-vsp-md">
-            {t("doc.allTags", locale)}
-          </h2>
-          <a
-            href={withBase(`/${locale}/docs/tags`)}
-            class="text-accent underline hover:text-accent-hover"
-          >
-            {t("doc.allTags", locale)}
-          </a>
-        </section>
-      )}
-    </DocLayoutWithDefaults>
+    <HomePageView
+      locale={locale}
+      tree={tree}
+      categoryOrder={categoryOrder}
+      tagCount={tagCount}
+    />
   );
 }