@takazudo/zudo-doc 0.2.22 → 1.0.1

package/routes-src/docs-slug.tsx

@@ -0,0 +1,43 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /docs/[[...slug]] — package-owned equivalent of
+// pages/docs/[[...slug]].tsx (epic Package-First Finale #2356, A1 #2361).
+//
+// Default-locale (EN) catch-all docs route. `paths()` enumerates every page in
+// the "docs" collection plus auto-generated category index pages — the
+// load-bearing route-injection seam, reconstructed entirely from the package
+// factories via `_context` (no `@/` imports). Rendering is via the package
+// `renderDocPage` chrome (`_chrome`). Dormant unless `settings.packageOwnedRoutes`
+// is on; even then dropped if the user keeps a `pages/docs/[[...slug]].tsx`
+// stub (Decision 6).
+
+import type { JSX } from "preact";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "@takazudo/zudo-doc/doc-page-props";
+import { settings, defaultLocale, resolveNavSource, buildDocRouteEntries } from "./_context.js";
+import { renderDocPage } from "./_chrome.js";
+
+export const frontmatter = { title: "Docs" };
+
+type DocPageProps = DocPageEntryProps | DocPageAutoIndexProps;
+
+export function paths(): Array<{ params: { slug: string[] }; props: DocPageProps }> {
+  const locale = defaultLocale;
+  const source = resolveNavSource(locale, undefined);
+  return buildDocRouteEntries({
+    source,
+    locale,
+    routeSig: `docs;${locale}`,
+  }).map((item) => ({
+    params: { slug: item.slugParams },
+    props: item.props as DocPageProps,
+  }));
+}
+
+type PageArgs = DocPageProps & { params: { slug: string[] } };
+
+export default function DocsPage(props: PageArgs): JSX.Element {
+  return renderDocPage(props, {
+    locale: defaultLocale,
+    docHistoryContentDir: settings.docsDir,
+  });
+}

package/routes-src/docs-tags-index.tsx

@@ -0,0 +1,14 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /docs/tags — package-owned equivalent of
+// pages/docs/tags/index.tsx (A1 #2361). Default-locale "All Tags" index.
+
+import type { JSX } from "preact";
+import { defaultLocale } from "./_context.js";
+import { TagsIndexPageView } from "./_chrome.js";
+
+export const frontmatter = { title: "All Tags" };
+
+export default function DocsTagsIndexPage(): JSX.Element {
+  return <TagsIndexPageView locale={defaultLocale} />;
+}

package/routes-src/docs-tags-tag.tsx

@@ -0,0 +1,29 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /docs/tags/[tag] — package-owned equivalent of
+// pages/docs/tags/[tag].tsx (A1 #2361). One route per unique tag in the
+// default-locale collection.
+
+import type { JSX } from "preact";
+import type { TagInfo } from "@takazudo/zudo-doc/tag-pages";
+import { defaultLocale } from "./_context.js";
+import { collectTagMapForLocale, TagDetailPageView } from "./_chrome.js";
+
+export const frontmatter = { title: "Tag" };
+
+export function paths(): Array<{ params: { tag: string }; props: { tagInfo: TagInfo } }> {
+  const tagMap = collectTagMapForLocale(defaultLocale);
+  return [...tagMap.entries()].map(([tag, tagInfo]) => ({
+    params: { tag },
+    props: { tagInfo },
+  }));
+}
+
+interface PageProps {
+  params: { tag: string };
+  tagInfo: TagInfo;
+}
+
+export default function DocTagPage({ params, tagInfo }: PageProps): JSX.Element {
+  return <TagDetailPageView locale={defaultLocale} tag={params.tag} tagInfo={tagInfo} />;
+}

package/routes-src/docs-versions.tsx

@@ -0,0 +1,15 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /docs/versions — package-owned equivalent of
+// pages/docs/versions.tsx (A1 #2361). Default-locale versions index; rendered
+// by the package `VersionsPageView` (`_chrome`).
+
+import type { JSX } from "preact";
+import { defaultLocale } from "./_context.js";
+import { VersionsPageView } from "./_chrome.js";
+
+export const frontmatter = { title: "Versions" };
+
+export default function VersionsPage(): JSX.Element {
+  return <VersionsPageView locale={defaultLocale} />;
+}

package/routes-src/index.tsx

@@ -0,0 +1,134 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: / — package-owned equivalent of pages/index.tsx
+// (A1 #2361). Default-locale (EN) site index: site-map grid + optional tag
+// count, rendered through the package chrome (`_chrome`). Static route — no
+// paths() export.
+
+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,
+  BodyEndIslandsStub,
+  composeMetaTitle,
+} 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");
+
+  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={<BodyEndIslandsStub 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>
+  );
+}

package/routes-src/locale-docs-slug.tsx

@@ -0,0 +1,69 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /[locale]/docs/[[...slug]] — package-owned
+// equivalent of pages/[locale]/docs/[[...slug]].tsx (A1 #2361).
+//
+// Non-default-locale catch-all docs route. The dynamic `[locale]` pattern is
+// injected ONCE; `paths()` enumerates one route per (non-default locale, slug)
+// with the locale-first + base-EN-fallback merge — reconstructed via `_context`.
+
+import type { JSX } from "preact";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "@takazudo/zudo-doc/doc-page-props";
+import { settings, getLocaleConfig, resolveNavSource, buildDocRouteEntries } from "./_context.js";
+import { renderDocPage } from "./_chrome.js";
+
+export const frontmatter = { title: "Docs" };
+
+interface LocaleDocPageExtra {
+  contentDir: string;
+  isFallback: boolean;
+}
+
+type DocPageProps =
+  | (DocPageEntryProps & LocaleDocPageExtra)
+  | (DocPageAutoIndexProps & LocaleDocPageExtra);
+
+export function paths(): Array<{
+  params: { locale: string; slug: string[] };
+  props: DocPageProps;
+}> {
+  const result: Array<{
+    params: { locale: string; slug: string[] };
+    props: DocPageProps;
+  }> = [];
+
+  for (const locale of Object.keys(settings.locales)) {
+    const contentDir = getLocaleConfig(locale)?.dir ?? settings.docsDir;
+    const source = resolveNavSource(locale, undefined, {
+      applyDefaultLocaleOnlyFilter: true,
+      keepUnlisted: true,
+    });
+
+    for (const item of buildDocRouteEntries({
+      source,
+      locale,
+      routeSig: `locale-docs;${locale}`,
+    })) {
+      const extra: LocaleDocPageExtra = {
+        contentDir: item.isFallback ? settings.docsDir : contentDir,
+        isFallback: item.isFallback,
+      };
+      result.push({
+        params: { locale, slug: item.slugParams },
+        props: { ...(item.props as DocPageProps), ...extra },
+      });
+    }
+  }
+
+  return result;
+}
+
+type PageArgs = DocPageProps & { params: { locale: string; slug: string[] } };
+
+export default function LocaleDocsPage(props: PageArgs): JSX.Element {
+  return renderDocPage(props, {
+    locale: props.params.locale,
+    isFallback: props.isFallback,
+    docHistoryContentDir: props.contentDir,
+  });
+}

package/routes-src/locale-docs-tags-index.tsx

@@ -0,0 +1,23 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /[locale]/docs/tags — package-owned equivalent of
+// pages/[locale]/docs/tags/index.tsx (A1 #2361). One route per non-default
+// locale; the tag map is computed at render time (locale-first + base merge).
+
+import type { JSX } from "preact";
+import { settings } from "./_context.js";
+import { TagsIndexPageView } from "./_chrome.js";
+
+export const frontmatter = { title: "All Tags" };
+
+export function paths(): Array<{ params: { locale: string } }> {
+  return Object.keys(settings.locales).map((locale) => ({ params: { locale } }));
+}
+
+interface PageProps {
+  params: { locale: string };
+}
+
+export default function LocaleTagsIndexPage({ params }: PageProps): JSX.Element {
+  return <TagsIndexPageView locale={params.locale} />;
+}

package/routes-src/locale-docs-tags-tag.tsx

@@ -0,0 +1,39 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /[locale]/docs/tags/[tag] — package-owned
+// equivalent of pages/[locale]/docs/tags/[tag].tsx (A1 #2361). One route per
+// (non-default locale, tag) pair.
+
+import type { JSX } from "preact";
+import type { TagInfo } from "@takazudo/zudo-doc/tag-pages";
+import { settings } from "./_context.js";
+import { collectTagMapForLocale, TagDetailPageView } from "./_chrome.js";
+
+export const frontmatter = { title: "Tag" };
+
+export function paths(): Array<{
+  params: { locale: string; tag: string };
+  props: { tagInfo: TagInfo };
+}> {
+  const result: Array<{
+    params: { locale: string; tag: string };
+    props: { tagInfo: TagInfo };
+  }> = [];
+
+  for (const locale of Object.keys(settings.locales)) {
+    const tagMap = collectTagMapForLocale(locale);
+    for (const [tag, tagInfo] of tagMap.entries()) {
+      result.push({ params: { locale, tag }, props: { tagInfo } });
+    }
+  }
+  return result;
+}
+
+interface PageProps {
+  params: { locale: string; tag: string };
+  tagInfo: TagInfo;
+}
+
+export default function LocaleDocTagPage({ params, tagInfo }: PageProps): JSX.Element {
+  return <TagDetailPageView locale={params.locale} tag={params.tag} tagInfo={tagInfo} />;
+}

package/routes-src/locale-docs-versions.tsx

@@ -0,0 +1,23 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /[locale]/docs/versions — package-owned equivalent
+// of pages/[locale]/docs/versions.tsx (A1 #2361). One route per non-default
+// locale; rendered by the shared package `VersionsPageView`.
+
+import type { JSX } from "preact";
+import { settings } from "./_context.js";
+import { VersionsPageView } from "./_chrome.js";
+
+export const frontmatter = { title: "Versions" };
+
+export function paths(): Array<{ params: { locale: string } }> {
+  return Object.keys(settings.locales).map((locale) => ({ params: { locale } }));
+}
+
+interface PageProps {
+  params: { locale: string };
+}
+
+export default function LocaleVersionsPage({ params }: PageProps): JSX.Element {
+  return <VersionsPageView locale={params.locale} />;
+}

package/routes-src/locale-index.tsx

@@ -0,0 +1,150 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// 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,
+  BodyEndIslandsStub,
+  composeMetaTitle,
+} from "./_chrome.js";
+
+export const frontmatter = { title: "Home" };
+
+export function paths(): Array<{ params: { locale: string }; props: { locale: string } }> {
+  return Object.keys(settings.locales).map((locale) => ({
+    params: { locale },
+    props: { locale },
+  }));
+}
+
+interface PageArgs {
+  params: { locale: string };
+  props: { locale: string };
+}
+
+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");
+
+  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={<BodyEndIslandsStub 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>
+  );
+}

package/routes-src/robots.txt.tsx

@@ -0,0 +1,13 @@
+// Package route entrypoint: /robots.txt — package-owned equivalent of
+// pages/robots.txt.tsx (epic Package-First Finale #2356, A1 #2361).
+//
+// Reads `settings` from the route-context virtual module via `_context` and
+// renders through the package `renderRobots` (`@takazudo/zudo-doc/robots`).
+// Dormant unless `settings.packageOwnedRoutes` is on (and even then dropped if
+// the user's `pages/robots.txt.tsx` stub is present — Decision 6).
+
+import { renderRobots } from "@takazudo/zudo-doc/robots";
+import { settings } from "./_context.js";
+
+export const contentType = "text/plain";
+export default () => renderRobots(settings);

package/routes-src/sitemap.xml.tsx

@@ -0,0 +1,48 @@
+// Package route entrypoint: /sitemap.xml — package-owned equivalent of
+// pages/sitemap.xml.tsx (epic Package-First Finale #2356, A1 #2361).
+//
+// URL enumeration is delegated to `enumerateAllRoutes` (reconstructed in
+// `_context` from `@takazudo/zudo-doc/route-enumerators`) so the sitemap cannot
+// drift from the actual routes the page entrypoints build. Dormant unless
+// `settings.packageOwnedRoutes` is on (Decision 6 precedence still applies).
+
+import { settings, enumerateAllRoutes } from "./_context.js";
+
+export const frontmatter = { title: "Sitemap" };
+export const contentType = "application/xml";
+
+function escapeXml(str: string): string {
+  return str
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
+}
+
+export default function Sitemap(): string {
+  if (!settings.sitemap) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+</urlset>`;
+  }
+
+  const routeMap = enumerateAllRoutes();
+  const siteUrlBase = (settings.siteUrl ?? "").replace(/\/$/, "");
+
+  const urlEntries = [...routeMap.entries()]
+    .sort(([a], [b]) => a.localeCompare(b))
+    .map(
+      ([url, lastmod]) => `  <url>
+    <loc>${escapeXml(siteUrlBase + url)}</loc>
+    <lastmod>${lastmod}</lastmod>
+  </url>`,
+    )
+    .join("\n");
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urlEntries}
+</urlset>
+`;
+}

package/routes-src/v-docs-slug.tsx

@@ -0,0 +1,64 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /v/[version]/docs/[[...slug]] — package-owned
+// equivalent of pages/v/[version]/docs/[[...slug]].tsx (A1 #2361).
+//
+// Versioned EN docs route. The dynamic `[version]` pattern is injected ONCE;
+// `paths()` enumerates one route per (version, slug) over the
+// `docs-v-${version.slug}` collection, with versioned URL closures.
+
+import type { JSX } from "preact";
+import type { VersionConfig } from "@takazudo/zudo-doc/settings";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "@takazudo/zudo-doc/doc-page-props";
+import { settings, resolveNavSource, versionedDocsUrl, buildDocRouteEntries } from "./_context.js";
+import { renderDocPage } from "./_chrome.js";
+
+export const frontmatter = { title: "Docs" };
+
+interface VersionedDocPageExtra {
+  version: VersionConfig;
+}
+
+type DocPageProps =
+  | (DocPageEntryProps & VersionedDocPageExtra)
+  | (DocPageAutoIndexProps & VersionedDocPageExtra);
+
+export function paths(): Array<{
+  params: { version: string; slug: string[] };
+  props: DocPageProps;
+}> {
+  if (!settings.versions) return [];
+
+  const result: Array<{
+    params: { version: string; slug: string[] };
+    props: DocPageProps;
+  }> = [];
+
+  for (const version of settings.versions) {
+    const source = resolveNavSource(settings.defaultLocale, version.slug);
+    const urlFor = (s: string): string => versionedDocsUrl(s, version.slug);
+
+    for (const item of buildDocRouteEntries({
+      source,
+      locale: settings.defaultLocale,
+      routeSig: `v-docs;${version.slug}`,
+      urlFor,
+    })) {
+      result.push({
+        params: { version: version.slug, slug: item.slugParams },
+        props: { ...(item.props as DocPageProps), version },
+      });
+    }
+  }
+
+  return result;
+}
+
+type PageArgs = DocPageProps & { params: { version: string; slug: string[] } };
+
+export default function VersionedDocsPage(props: PageArgs): JSX.Element {
+  return renderDocPage(props, {
+    locale: settings.defaultLocale,
+    version: props.version,
+  });
+}