create-zudo-doc 0.2.0 → 0.2.2

package/templates/features/docTags/files/pages/[locale]/docs/tags/[tag].tsx

@@ -11,29 +11,14 @@
 //   params: { locale: string; tag: string }
 //   props:  { tagInfo: TagInfo }
 //
+// Tag collection + rendering are shared with the default-locale route via
+// pages/lib/_tag-pages.tsx (#2010) — this file owns only the param shape.
 // Fallback strategy: see pages/lib/locale-merge.ts for full details.
-//   Locale docs take priority; base docs fill in missing slugs.
-//   Build tag map; emit one route per (locale, tag) pair.
 
-import { mergeLocaleDocs } from "../../../lib/locale-merge";
-import { loadDocs } from "../../../_data";
-import { collectTags } from "@/utils/tags";
-import type { TagInfo } from "@/utils/tags";
-import { toRouteSlug } from "@/utils/slug";
-import { t } from "@/config/i18n";
-import { withBase, docsUrl } from "@/utils/base";
 import { settings } from "@/config/settings";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
-import { Breadcrumb } from "@takazudo/zudo-doc/breadcrumb";
-import type { BreadcrumbItem } from "@takazudo/zudo-doc/breadcrumb";
-import { DocCardGrid } from "@takazudo/zudo-doc/nav-indexing";
+import type { TagInfo } from "@/utils/tags";
 import type { JSX } from "preact";
-import { FooterWithDefaults } from "../../../lib/_footer-with-defaults";
-import { HeaderWithDefaults } from "../../../lib/_header-with-defaults";
-import { HeadWithDefaults } from "../../../lib/_head-with-defaults";
-import { composeMetaTitle } from "../../../lib/_compose-meta-title";
-import { DocHistoryArea } from "../../../lib/_doc-history-area";
-import { BodyEndIslands } from "../../../lib/_body-end-islands";
+import { collectTagMapForLocale, TagDetailPageView } from "../../../lib/_tag-pages";
 
 export const frontmatter = { title: "Tag" };
 
@@ -48,18 +33,7 @@ export function paths(): Array<{
   }> = [];
 
   for (const locale of Object.keys(settings.locales)) {
-    const { docs: mergedDocs } = mergeLocaleDocs({
-      baseDocs: loadDocs("docs").filter((d) => !d.data.draft),
-      localeDocs: loadDocs(`docs-${locale}`).filter((d) => !d.data.draft),
-      applyDefaultLocaleOnlyFilter: true,
-    });
-    // category_no_page index files build no route — drop them AFTER the merge
-    // so a locale override carrying the flag first wins the merge (suppressing
-    // the base doc); pre-merge filtering would drop it from localeSlugSet and
-    // the unflagged base doc would resurface as a card linking to a locale
-    // route the docs route never builds.
-    const docs = mergedDocs.filter((d) => !d.data.category_no_page);
-    const tagMap = collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
+    const tagMap = collectTagMapForLocale(locale);
 
     for (const [tag, tagInfo] of tagMap.entries()) {
       result.push({
@@ -81,47 +55,5 @@ export default function LocaleDocTagPage({
   params,
   tagInfo,
 }: PageProps): JSX.Element {
-  const { locale, tag } = params;
-
-  const countText =
-    tagInfo.count === 1
-      ? t("doc.pageCountSingle", locale).replace("{count}", String(tagInfo.count))
-      : t("doc.pageCount", locale).replace("{count}", String(tagInfo.count));
-
-  const pageTitle = `${t("doc.taggedWith", locale)}: ${tag}`;
-
-  const breadcrumbItems: BreadcrumbItem[] = [
-    { label: "Docs" },
-    {
-      label: t("doc.allTags", locale),
-      href: withBase(`/${locale}/docs/tags`),
-    },
-    { label: tag },
-  ];
-
-  const cardItems = tagInfo.docs.map((doc) => ({
-    href: docsUrl(doc.slug, locale),
-    title: doc.title,
-    description: doc.description,
-  }));
-
-  return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(pageTitle)}
-      head={<HeadWithDefaults title={pageTitle} />}
-      lang={locale}
-      noindex={settings.noindex}
-      hideSidebar={true}
-      hideToc={true}
-      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase(`/${locale}/docs/tags/${tag}`)} />}
-      breadcrumbOverride={<Breadcrumb items={breadcrumbItems} />}
-      footerOverride={<FooterWithDefaults lang={locale} />}
-      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
-    >
-      <h1 class="text-heading font-bold mb-vsp-xs">{pageTitle}</h1>
-      <p class="text-muted mb-vsp-lg">{countText}</p>
-      <DocCardGrid ariaLabel={pageTitle} items={cardItems} />
-      <DocHistoryArea slug={`tags/${tag}`} locale={locale} />
-    </DocLayoutWithDefaults>
-  );
+  return <TagDetailPageView locale={params.locale} tag={params.tag} tagInfo={tagInfo} />;
 }

package/templates/features/docTags/files/pages/[locale]/docs/tags/index.tsx

@@ -3,36 +3,21 @@
 // Page module for the locale-prefixed "All Tags" index route.
 //
 // Non-default-locale "All Tags" index page. paths() emits one route per
-// locale defined in settings.locales (English has no /en prefix — it is
-// handled by pages/docs/tags/index.tsx). The component recomputes the tag
+// locale defined in settings.locales (the default locale has no prefix — it
+// is handled by pages/docs/tags/index.tsx). The component recomputes the tag
 // map at render time using a locale-doc + base-doc fallback strategy
 // (see pages/lib/locale-merge.ts for the merge logic).
 //
-// Fallback strategy (locale first, base as fill): see pages/lib/locale-merge.ts
+// Tag collection + rendering are shared with the default-locale route via
+// pages/lib/_tag-pages.tsx (#2010).
 //
 // paths() contract (zfb ADR-004 — synchronous):
 //   params: { locale: string }
 //   props:  (none — tag map computed at render time)
 
-import { mergeLocaleDocs } from "../../../lib/locale-merge";
-import { loadDocs } from "../../../_data";
-import { collectTags } from "@/utils/tags";
-import { toRouteSlug } from "@/utils/slug";
-import { t } from "@/config/i18n";
-import { withBase } from "@/utils/base";
 import { settings } from "@/config/settings";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
-import { Breadcrumb } from "@takazudo/zudo-doc/breadcrumb";
-import type { BreadcrumbItem } from "@takazudo/zudo-doc/breadcrumb";
-import { TagNav } from "@takazudo/zudo-doc/nav-indexing";
-import type { TagItem, TagNavLabels } from "@takazudo/zudo-doc/nav-indexing";
 import type { JSX } from "preact";
-import { FooterWithDefaults } from "../../../lib/_footer-with-defaults";
-import { HeaderWithDefaults } from "../../../lib/_header-with-defaults";
-import { HeadWithDefaults } from "../../../lib/_head-with-defaults";
-import { composeMetaTitle } from "../../../lib/_compose-meta-title";
-import { DocHistoryArea } from "../../../lib/_doc-history-area";
-import { BodyEndIslands } from "../../../lib/_body-end-islands";
+import { TagsIndexPageView } from "../../../lib/_tag-pages";
 
 export const frontmatter = { title: "All Tags" };
 
@@ -50,61 +35,5 @@ interface PageProps {
 export default function LocaleTagsIndexPage({
   params,
 }: PageProps): JSX.Element {
-  const { locale } = params;
-  const pageTitle = t("doc.allTags", locale);
-
-  const { docs: mergedDocs } = mergeLocaleDocs({
-    baseDocs: loadDocs("docs").filter((d) => !d.data.draft),
-    localeDocs: loadDocs(`docs-${locale}`).filter((d) => !d.data.draft),
-    applyDefaultLocaleOnlyFilter: true,
-  });
-  // category_no_page index files build no route — drop them AFTER the merge
-  // so a locale override carrying the flag first wins the merge (suppressing
-  // the base doc); pre-merge filtering would drop it from localeSlugSet and
-  // the unflagged base doc would resurface as a card linking to a locale
-  // route the docs route never builds.
-  const docs = mergedDocs.filter((d) => !d.data.category_no_page);
-  const tagMap = collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
-
-  const labels: TagNavLabels = {
-    tags: t("doc.tags", locale),
-    taggedWith: t("doc.taggedWith", locale),
-  };
-
-  // Sort alphabetically using the page locale — matches documented tag-nav sort order.
-  const tags: TagItem[] = [...tagMap.values()]
-    .sort((a, b) => a.tag.localeCompare(b.tag, locale))
-    .map((info) => ({
-      tag: info.tag,
-      count: info.count,
-      href: withBase(`/${locale}/docs/tags/${info.tag}`),
-    }));
-
-  const breadcrumbItems: BreadcrumbItem[] = [
-    { label: "Docs" },
-    { label: pageTitle },
-  ];
-
-  return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(pageTitle)}
-      head={<HeadWithDefaults title={pageTitle} />}
-      lang={locale}
-      noindex={settings.noindex}
-      hideSidebar={true}
-      hideToc={true}
-      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase(`/${locale}/docs/tags`)} />}
-      breadcrumbOverride={<Breadcrumb items={breadcrumbItems} />}
-      footerOverride={<FooterWithDefaults lang={locale} />}
-      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
-    >
-      <h1 class="text-heading font-bold mb-vsp-lg">{pageTitle}</h1>
-      {!settings.docTags || tags.length === 0 ? (
-        <p class="text-muted">{t("doc.noTags", locale)}</p>
-      ) : (
-        <TagNav variant="all" tags={tags} labels={labels} />
-      )}
-      <DocHistoryArea slug="tags" locale={locale} />
-    </DocLayoutWithDefaults>
-  );
+  return <TagsIndexPageView locale={params.locale} />;
 }

package/templates/features/docTags/files/pages/docs/tags/[tag].tsx

@@ -2,7 +2,7 @@
 /** @jsxImportSource preact */
 // Page module for the default-locale per-tag detail route.
 //
-// Default-locale (en) per-tag detail page. paths() enumerates one route per
+// Default-locale per-tag detail page. paths() enumerates one route per
 // unique tag in the "docs" collection and passes the resolved TagInfo as a
 // prop so the component has zero extra collection reads at render time.
 //
@@ -10,29 +10,13 @@
 //   params: { tag: string }
 //   props:  { tagInfo: TagInfo }
 //
-// Data flow:
-//   getCollection("docs") [sync] → collectTags() → one route per tag
-//   render: DocCardGrid with pre-resolved TagInfo.docs items
+// Tag collection + rendering are shared with the locale-prefixed route via
+// pages/lib/_tag-pages.tsx (#2010) — this file owns only the param shape.
 
-import { getCollection } from "zfb/content";
-import { collectTags } from "@/utils/tags";
+import { defaultLocale } from "@/config/i18n";
 import type { TagInfo } from "@/utils/tags";
-import { toRouteSlug } from "@/utils/slug";
-import { t, defaultLocale } from "@/config/i18n";
-import { settings } from "@/config/settings";
-import { withBase, docsUrl } from "@/utils/base";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
-import { Breadcrumb } from "@takazudo/zudo-doc/breadcrumb";
-import type { BreadcrumbItem } from "@takazudo/zudo-doc/breadcrumb";
-import { DocCardGrid } from "@takazudo/zudo-doc/nav-indexing";
 import type { JSX } from "preact";
-import { bridgeDocsEntries, type ZfbDocsData } from "../../_data";
-import { FooterWithDefaults } from "../../lib/_footer-with-defaults";
-import { HeaderWithDefaults } from "../../lib/_header-with-defaults";
-import { HeadWithDefaults } from "../../lib/_head-with-defaults";
-import { composeMetaTitle } from "../../lib/_compose-meta-title";
-import { DocHistoryArea } from "../../lib/_doc-history-area";
-import { BodyEndIslands } from "../../lib/_body-end-islands";
+import { collectTagMapForLocale, TagDetailPageView } from "../../lib/_tag-pages";
 
 export const frontmatter = { title: "Tag" };
 
@@ -41,14 +25,7 @@ export function paths(): Array<{
   params: { tag: string };
   props: { tagInfo: TagInfo };
 }> {
-  const allDocs = bridgeDocsEntries(getCollection<ZfbDocsData>("docs"), "docs");
-  // category_no_page index.mdx builds no route — drop it so a tag it carries
-  // doesn't render a DocCard linking to a non-existent /docs/<cat>/ page.
-  const docs = allDocs.filter(
-    (doc) =>
-      !doc.data.unlisted && !doc.data.draft && !doc.data.category_no_page,
-  );
-  const tagMap = collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
+  const tagMap = collectTagMapForLocale(defaultLocale);
 
   return [...tagMap.entries()].map(([tag, tagInfo]) => ({
     params: { tag },
@@ -62,44 +39,5 @@ interface PageProps {
 }
 
 export default function DocTagPage({ params, tagInfo }: PageProps): JSX.Element {
-  const { tag } = params;
-  const locale = defaultLocale;
-
-  const countText =
-    tagInfo.count === 1
-      ? t("doc.pageCountSingle", locale).replace("{count}", String(tagInfo.count))
-      : t("doc.pageCount", locale).replace("{count}", String(tagInfo.count));
-
-  const pageTitle = `${t("doc.taggedWith", locale)}: ${tag}`;
-
-  const breadcrumbItems: BreadcrumbItem[] = [
-    { label: "Docs" },
-    { label: t("doc.allTags", locale), href: withBase("/docs/tags") },
-    { label: tag },
-  ];
-
-  const cardItems = tagInfo.docs.map((doc) => ({
-    href: docsUrl(doc.slug, locale),
-    title: doc.title,
-    description: doc.description,
-  }));
-
-  return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(pageTitle)}
-      head={<HeadWithDefaults title={pageTitle} />}
-      noindex={settings.noindex}
-      hideSidebar={true}
-      hideToc={true}
-      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase(`/docs/tags/${tag}`)} />}
-      breadcrumbOverride={<Breadcrumb items={breadcrumbItems} />}
-      footerOverride={<FooterWithDefaults lang={locale} />}
-      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
-    >
-      <h1 class="text-heading font-bold mb-vsp-xs">{pageTitle}</h1>
-      <p class="text-muted mb-vsp-lg">{countText}</p>
-      <DocCardGrid ariaLabel={pageTitle} items={cardItems} />
-      <DocHistoryArea slug={`tags/${tag}`} locale={locale} />
-    </DocLayoutWithDefaults>
-  );
+  return <TagDetailPageView locale={defaultLocale} tag={params.tag} tagInfo={tagInfo} />;
 }

package/templates/features/docTags/files/pages/docs/tags/index.tsx

@@ -2,89 +2,19 @@
 /** @jsxImportSource preact */
 // Page module for the default-locale "All Tags" index route.
 //
-// Default-locale (en) "All Tags" index page. Collects every tag across the
+// Default-locale "All Tags" index page. Collects every tag across the
 // "docs" collection, sorts them alphabetically, and renders a full tag cloud
 // via the v2 TagNav component. No dynamic params — single static route.
 //
-// Data flow:
-//   getCollection("docs")   [sync, zfb/content]
-//   → collectTags()         builds { tag → { count, docs[] } }
-//   → sort by tag           preserves sort parity with Astro original
-//   → TagNav variant="all"  renders the chip cloud
+// Tag collection + rendering are shared with the locale-prefixed route via
+// pages/lib/_tag-pages.tsx (#2010).
 
-import { getCollection } from "zfb/content";
-import { collectTags } from "@/utils/tags";
-import { toRouteSlug } from "@/utils/slug";
-import { t, defaultLocale } from "@/config/i18n";
-import { withBase } from "@/utils/base";
-import { settings } from "@/config/settings";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
-import { Breadcrumb } from "@takazudo/zudo-doc/breadcrumb";
-import type { BreadcrumbItem } from "@takazudo/zudo-doc/breadcrumb";
-import { TagNav } from "@takazudo/zudo-doc/nav-indexing";
-import type { TagItem, TagNavLabels } from "@takazudo/zudo-doc/nav-indexing";
+import { defaultLocale } from "@/config/i18n";
 import type { JSX } from "preact";
-import { bridgeDocsEntries, type ZfbDocsData } from "../../_data";
-import { FooterWithDefaults } from "../../lib/_footer-with-defaults";
-import { HeaderWithDefaults } from "../../lib/_header-with-defaults";
-import { HeadWithDefaults } from "../../lib/_head-with-defaults";
-import { composeMetaTitle } from "../../lib/_compose-meta-title";
-import { DocHistoryArea } from "../../lib/_doc-history-area";
-import { BodyEndIslands } from "../../lib/_body-end-islands";
+import { TagsIndexPageView } from "../../lib/_tag-pages";
 
 export const frontmatter = { title: "All Tags" };
 
 export default function DocsTagsIndexPage(): JSX.Element {
-  const locale = defaultLocale;
-  const pageTitle = t("doc.allTags", locale);
-
-  const allDocs = bridgeDocsEntries(getCollection<ZfbDocsData>("docs"), "docs");
-  // category_no_page index.mdx builds no route — drop it so a tag it carries
-  // doesn't inflate the tag list with a card linking to a non-existent page.
-  const docs = allDocs.filter(
-    (doc) =>
-      !doc.data.unlisted && !doc.data.draft && !doc.data.category_no_page,
-  );
-  const tagMap = collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
-
-  const labels: TagNavLabels = {
-    tags: t("doc.tags", locale),
-    taggedWith: t("doc.taggedWith", locale),
-  };
-
-  // Sort alphabetically — matches documented tag-nav sort order.
-  const tags: TagItem[] = [...tagMap.values()]
-    .sort((a, b) => a.tag.localeCompare(b.tag, locale))
-    .map((info) => ({
-      tag: info.tag,
-      count: info.count,
-      href: withBase(`/docs/tags/${info.tag}`),
-    }));
-
-  const breadcrumbItems: BreadcrumbItem[] = [
-    { label: "Docs" },
-    { label: pageTitle },
-  ];
-
-  return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(pageTitle)}
-      head={<HeadWithDefaults title={pageTitle} />}
-      noindex={settings.noindex}
-      hideSidebar={true}
-      hideToc={true}
-      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase("/docs/tags")} />}
-      breadcrumbOverride={<Breadcrumb items={breadcrumbItems} />}
-      footerOverride={<FooterWithDefaults lang={locale} />}
-      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
-    >
-      <h1 class="text-heading font-bold mb-vsp-lg">{pageTitle}</h1>
-      {!settings.docTags || tags.length === 0 ? (
-        <p class="text-muted">{t("doc.noTags", locale)}</p>
-      ) : (
-        <TagNav variant="all" tags={tags} labels={labels} />
-      )}
-      <DocHistoryArea slug="tags" locale={locale} />
-    </DocLayoutWithDefaults>
-  );
+  return <TagsIndexPageView locale={defaultLocale} />;
 }

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

@@ -0,0 +1,201 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Shared data + renderers for the doc-tags pages (#2010).
+//
+// Collapses the per-locale page pairs:
+//   pages/docs/tags/[tag].tsx   + pages/[locale]/docs/tags/[tag].tsx
+//   pages/docs/tags/index.tsx   + pages/[locale]/docs/tags/index.tsx
+// into locale-parameterized helpers. The page files stay thin shells that own
+// only their paths() param shapes; URL prefixes and the default-vs-locale
+// data path branch live here.
+//
+// Data-path branch (kept exactly as the original pages had it):
+//   - Default locale: the "docs" collection directly, filtered
+//     unlisted/draft/category_no_page before tag collection.
+//   - Non-default locale: locale-first merge with base fallback
+//     (see locale-merge.ts) — draft-filtered inputs, unlisted dropped by the
+//     merge default, category_no_page filtered AFTER the merge so a locale
+//     override carrying the flag first wins the merge (suppressing the base
+//     doc); pre-merge filtering would drop it from localeSlugSet and the
+//     unflagged base doc would resurface as a card linking to a locale route
+//     the docs route never builds.
+
+import { collectTags } from "@/utils/tags";
+import type { TagInfo } from "@/utils/tags";
+import { toRouteSlug } from "@/utils/slug";
+import { t, defaultLocale } from "@/config/i18n";
+import { settings } from "@/config/settings";
+import { withBase, docsUrl } from "@/utils/base";
+import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
+import { Breadcrumb } from "@takazudo/zudo-doc/breadcrumb";
+import type { BreadcrumbItem } from "@takazudo/zudo-doc/breadcrumb";
+import { DocCardGrid, TagNav } from "@takazudo/zudo-doc/nav-indexing";
+import type { TagItem, TagNavLabels } from "@takazudo/zudo-doc/nav-indexing";
+import type { JSX } from "preact";
+import { FooterWithDefaults } from "./_footer-with-defaults";
+import { HeaderWithDefaults } from "./_header-with-defaults";
+import { HeadWithDefaults } from "./_head-with-defaults";
+import { composeMetaTitle } from "./_compose-meta-title";
+import { DocHistoryArea } from "./_doc-history-area";
+import { BodyEndIslands } from "./_body-end-islands";
+import { stableDocs, memoizeDerived } from "./_nav-source-cache";
+import { mergeLocaleDocs } from "./locale-merge";
+
+// ---------------------------------------------------------------------------
+// Tag collection
+// ---------------------------------------------------------------------------
+
+/**
+ * Build the { tag → TagInfo } map for one locale, preserving each original
+ * page's exact data path (see the module-header branch notes).
+ *
+ * Memoized on the snapshot-anchored stableDocs identity (same pattern as
+ * _nav-source-cache) so the collection bridging and tag aggregation run once
+ * per locale per build rather than once per built tag page.
+ */
+export function collectTagMapForLocale(locale: string): Map<string, TagInfo> {
+  if (locale === defaultLocale) {
+    const baseDocs = stableDocs("docs");
+    return memoizeDerived([baseDocs], "tagMap;default", () => {
+      // category_no_page index.mdx builds no route — drop it so a tag it carries
+      // doesn't render a DocCard linking to a non-existent /docs/<cat>/ page.
+      const docs = baseDocs.filter(
+        (doc) =>
+          !doc.data.unlisted && !doc.data.draft && !doc.data.category_no_page,
+      );
+      return collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
+    });
+  }
+
+  const baseDocs = stableDocs("docs");
+  const localeDocs = stableDocs(`docs-${locale}`);
+  return memoizeDerived([baseDocs, localeDocs], `tagMap;${locale}`, () => {
+    const { docs: mergedDocs } = mergeLocaleDocs({
+      baseDocs: baseDocs.filter((d) => !d.data.draft),
+      localeDocs: localeDocs.filter((d) => !d.data.draft),
+      applyDefaultLocaleOnlyFilter: true,
+    });
+    const docs = mergedDocs.filter((d) => !d.data.category_no_page);
+    return collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Shared renderers
+// ---------------------------------------------------------------------------
+
+/** URL prefix for a locale: "" for the default locale, "/{locale}" otherwise. */
+function localePrefix(locale: string): string {
+  return locale === defaultLocale ? "" : `/${locale}`;
+}
+
+/** Per-tag detail page (chip target). */
+export function TagDetailPageView({
+  locale,
+  tag,
+  tagInfo,
+}: {
+  locale: string;
+  tag: string;
+  tagInfo: TagInfo;
+}): JSX.Element {
+  const isDefault = locale === defaultLocale;
+  const prefix = localePrefix(locale);
+
+  const countText =
+    tagInfo.count === 1
+      ? t("doc.pageCountSingle", locale).replace("{count}", String(tagInfo.count))
+      : t("doc.pageCount", locale).replace("{count}", String(tagInfo.count));
+
+  const pageTitle = `${t("doc.taggedWith", locale)}: ${tag}`;
+
+  const breadcrumbItems: BreadcrumbItem[] = [
+    { label: "Docs" },
+    { label: t("doc.allTags", locale), href: withBase(`${prefix}/docs/tags`) },
+    { label: tag },
+  ];
+
+  const cardItems = tagInfo.docs.map((doc) => ({
+    href: docsUrl(doc.slug, locale),
+    title: doc.title,
+    description: doc.description,
+  }));
+
+  return (
+    <DocLayoutWithDefaults
+      title={composeMetaTitle(pageTitle)}
+      head={<HeadWithDefaults title={pageTitle} />}
+      // The original default-locale page omitted `lang` entirely; passing
+      // undefined relies on Preact treating an undefined prop as absent.
+      lang={isDefault ? undefined : locale}
+      noindex={settings.noindex}
+      hideSidebar={true}
+      hideToc={true}
+      // Tag segment URL-encoded — emitted href/path sites only; route params
+      // stay raw (e.g. "type:guide" → "type%3Aguide").
+      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase(`${prefix}/docs/tags/${encodeURIComponent(tag)}`)} />}
+      breadcrumbOverride={<Breadcrumb items={breadcrumbItems} />}
+      footerOverride={<FooterWithDefaults lang={locale} />}
+      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+    >
+      <h1 class="text-heading font-bold mb-vsp-xs">{pageTitle}</h1>
+      <p class="text-muted mb-vsp-lg">{countText}</p>
+      <DocCardGrid ariaLabel={pageTitle} items={cardItems} />
+      <DocHistoryArea slug={`tags/${tag}`} locale={locale} />
+    </DocLayoutWithDefaults>
+  );
+}
+
+/** "All Tags" index page — computes the tag map at render time (matching the
+ *  original pages, which had no props from paths()). */
+export function TagsIndexPageView({ locale }: { locale: string }): JSX.Element {
+  const isDefault = locale === defaultLocale;
+  const prefix = localePrefix(locale);
+  const pageTitle = t("doc.allTags", locale);
+
+  const tagMap = collectTagMapForLocale(locale);
+
+  const labels: TagNavLabels = {
+    tags: t("doc.tags", locale),
+    taggedWith: t("doc.taggedWith", locale),
+  };
+
+  // Sort alphabetically using the page locale — matches documented tag-nav sort order.
+  const tags: TagItem[] = [...tagMap.values()]
+    .sort((a, b) => a.tag.localeCompare(b.tag, locale))
+    .map((info) => ({
+      tag: info.tag,
+      count: info.count,
+      // Tag segment URL-encoded — href sites only; route params stay raw.
+      href: withBase(`${prefix}/docs/tags/${encodeURIComponent(info.tag)}`),
+    }));
+
+  const breadcrumbItems: BreadcrumbItem[] = [
+    { label: "Docs" },
+    { label: pageTitle },
+  ];
+
+  return (
+    <DocLayoutWithDefaults
+      title={composeMetaTitle(pageTitle)}
+      head={<HeadWithDefaults title={pageTitle} />}
+      // Same undefined-≡-absent reliance as TagDetailPageView above.
+      lang={isDefault ? undefined : locale}
+      noindex={settings.noindex}
+      hideSidebar={true}
+      hideToc={true}
+      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase(`${prefix}/docs/tags`)} />}
+      breadcrumbOverride={<Breadcrumb items={breadcrumbItems} />}
+      footerOverride={<FooterWithDefaults lang={locale} />}
+      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+    >
+      <h1 class="text-heading font-bold mb-vsp-lg">{pageTitle}</h1>
+      {!settings.docTags || tags.length === 0 ? (
+        <p class="text-muted">{t("doc.noTags", locale)}</p>
+      ) : (
+        <TagNav variant="all" tags={tags} labels={labels} />
+      )}
+      <DocHistoryArea slug="tags" locale={locale} />
+    </DocLayoutWithDefaults>
+  );
+}