@takazudo/zudo-doc 2.2.2 → 2.4.0

package/routes-src/index.tsx

@@ -4,131 +4,25 @@
 // (A1 #2361). Default-locale (EN) site index: site-map grid + optional tag
 // count, rendered through the package chrome (`_chrome`). Static route — no
 // paths() export.
+//
+// Thin consumer of `HomePageView` (S3 #2502): this file's only job is
+// resolving the default locale and handing `routeCtx` to the shared
+// `prepareHomeData` factory (#2519) for the data-prep sequence, then handing
+// the result to the shared home body factory.
 
-import type { JSX, VNode } from "preact";
-import { Island } from "@takazudo/zfb";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
-import { SiteTreeNav } from "@takazudo/zudo-doc/site-tree-nav-island";
-import type { SidebarNavNode } from "@takazudo/zudo-doc/sidebar";
-import {
-  settings,
-  defaultLocale,
-  t,
-  withBase,
-  resolveNavSource,
-  buildNavTree,
-  groupSatelliteNodes,
-  getCategoryOrder,
-  collectTags,
-  docsUrl,
-  toRouteSlug,
-} from "./_context.js";
-import type { CategoryMeta } from "./_docs-helpers.js";
-import {
-  HeadWithDefaults,
-  HeaderWithDefaults,
-  FooterWithDefaults,
-  BodyEndIslands,
-  composeMetaTitle,
-} from "./_chrome.js";
+import type { JSX } from "preact";
+import { defaultLocale, routeCtx } from "./_context.js";
+import { prepareHomeData } from "@takazudo/zudo-doc/home-page";
+import { HomePageView } from "./_chrome.js";
 
 export const frontmatter = { title: "Home" };
 
 export default function IndexPage(): JSX.Element {
   const locale = defaultLocale;
 
-  const { navDocs, categoryMeta } = resolveNavSource(locale, undefined);
-  const tree = buildNavTree(
-    navDocs,
-    locale,
-    categoryMeta as Map<string, 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");
+  const { tree, categoryOrder, tagCount } = prepareHomeData(routeCtx, locale);
 
   return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(settings.siteName)}
-      head={<HeadWithDefaults title={settings.siteName} />}
-      lang={locale}
-      noindex={settings.noindex}
-      hideSidebar={true}
-      hideToc={true}
-      sidebarOverride={<></>}
-      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase("/")} />}
-      footerOverride={<FooterWithDefaults lang={locale} />}
-      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
-      enableClientRouter={settings.dynamicPageTransition}
-    >
-      <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">
-          <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"
-                  >
-                    GitHub
-                  </a>
-                  <span class="text-muted">/</span>
-                </>
-              )}
-            </div>
-          </div>
-        </div>
-      </div>
-
-      {Island({
-        when: "idle",
-        children: (
-          <SiteTreeNav
-            tree={groupedTree as unknown as SidebarNavNode[]}
-            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/routes-src/locale-index.tsx

@@ -3,34 +3,19 @@
 // Package route entrypoint: /[locale] — package-owned equivalent of
 // pages/[locale]/index.tsx (A1 #2361). One route per non-default locale; the
 // locale-prefixed site index (site-map grid + optional tag count).
-
-import type { JSX, VNode } from "preact";
-import { Island } from "@takazudo/zfb";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
-import { SiteTreeNav } from "@takazudo/zudo-doc/site-tree-nav-island";
-import type { SidebarNavNode } from "@takazudo/zudo-doc/sidebar";
-import { loadCategoryMeta } from "@takazudo/zudo-doc/sidebar-tree";
-import {
-  settings,
-  getLocaleConfig,
-  t,
-  withBase,
-  resolveNavSource,
-  buildNavTree,
-  groupSatelliteNodes,
-  getCategoryOrder,
-  collectTags,
-  docsUrl,
-  toRouteSlug,
-} from "./_context.js";
-import type { CategoryMeta } from "./_docs-helpers.js";
-import {
-  HeadWithDefaults,
-  HeaderWithDefaults,
-  FooterWithDefaults,
-  BodyEndIslands,
-  composeMetaTitle,
-} from "./_chrome.js";
+//
+// Thin consumer of `HomePageView` (S3 #2502): this file's only job is
+// `paths()` (a locale-routing concern) and handing `routeCtx` + the resolved
+// locale param to the shared `prepareHomeData` factory (#2519), which now
+// owns the locale-specific data prep — `resolveNavSource` with the
+// locale-home filter options, `loadCategoryMeta`, and the locale-config
+// guard. The prepared tree / tag count are handed to the shared home body
+// factory, same as the default-locale route.
+
+import type { JSX } from "preact";
+import { settings, routeCtx } from "./_context.js";
+import { prepareHomeData } from "@takazudo/zudo-doc/home-page";
+import { HomePageView } from "./_chrome.js";
 
 export const frontmatter = { title: "Home" };
 
@@ -48,103 +33,10 @@ interface PageArgs {
 
 export default function LocaleIndexPage({ params }: PageArgs): JSX.Element {
   const locale = params.locale;
-  const cfg = getLocaleConfig(locale);
-  if (!cfg) {
-    throw new Error(`LocaleIndexPage: locale "${locale}" is not configured in settings.locales`);
-  }
-
-  const { navDocs } = resolveNavSource(locale, undefined, {
-    applyDefaultLocaleOnlyFilter: true,
-    keepUnlisted: true,
-  });
-  const categoryMeta = loadCategoryMeta(cfg.dir) as Map<string, CategoryMeta>;
-
-  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(`/${locale}${ctaNav.path}`) : null;
-  const logoUrl = withBase("/img/logo.svg");
+  const { tree, categoryOrder, tagCount } = prepareHomeData(routeCtx, locale);
 
   return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(settings.siteName)}
-      head={<HeadWithDefaults title={settings.siteName} />}
-      lang={locale}
-      noindex={settings.noindex}
-      hideSidebar={true}
-      hideToc={true}
-      sidebarOverride={<></>}
-      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase(`/${locale}/`)} />}
-      footerOverride={<FooterWithDefaults lang={locale} />}
-      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
-      enableClientRouter={settings.dynamicPageTransition}
-    >
-      <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">
-          <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"
-                >
-                  GitHub
-                </a>
-              )}
-            </div>
-          </div>
-        </div>
-      </div>
-
-      {Island({
-        when: "idle",
-        children: (
-          <SiteTreeNav
-            tree={groupedTree as unknown as SidebarNavNode[]}
-            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} />
   );
 }