create-zudo-doc 0.2.21 → 1.0.0

package/templates/base/src/components/site-tree-nav.tsx

@@ -1,220 +0,0 @@
-"use client";
-
-// Use preact hook entrypoints directly — the "react" → "preact/compat" alias
-// lets us consume React-typed components in this Preact app (configured
-// project-wide). Same pattern as src/components/sidebar-tree.tsx.
-import { useState } from "preact/hooks";
-import type { NavNode } from "@/utils/docs";
-import { INDENT, connectorLeft, ConnectorLines, CategoryLinkIcon } from "./tree-nav-shared";
-import { ChevronRight } from "@takazudo/zudo-doc/icons";
-
-// site-tree-nav uses wider padding than the narrow sidebar
-const SITE_BASE_PAD = "clamp(0.5rem, 0.8vw, 1rem)";
-
-function padLeft(depth: number): string {
-  if (depth === 0) return SITE_BASE_PAD;
-  return `calc(${depth} * ${INDENT} + 1.25rem + 5px)`;
-}
-
-function reorderTree(tree: NavNode[], order: string[]): NavNode[] {
-  const map = new Map(tree.map((node) => [node.slug, node]));
-  const ordered: NavNode[] = [];
-  for (const slug of order) {
-    const node = map.get(slug);
-    if (node) {
-      ordered.push(node);
-      map.delete(slug);
-    }
-  }
-  // append unmatched nodes at end
-  for (const node of map.values()) {
-    ordered.push(node);
-  }
-  return ordered;
-}
-
-interface SiteTreeNavProps {
-  tree: NavNode[];
-  ariaLabel?: string;
-  categoryOrder?: string[];
-  categoryIgnore?: string[];
-}
-
-export default function SiteTreeNav({
-  tree,
-  ariaLabel = "Site index",
-  categoryOrder,
-  categoryIgnore,
-}: SiteTreeNavProps) {
-  let processedTree = tree;
-  if (categoryIgnore) {
-    const ignoreSet = new Set(categoryIgnore);
-    processedTree = processedTree.filter((node) => !ignoreSet.has(node.slug));
-  }
-  if (categoryOrder) {
-    processedTree = reorderTree(processedTree, categoryOrder);
-  }
-  return (
-    <nav
-      aria-label={ariaLabel}
-      data-site-nav
-      className="grid gap-vsp-md"
-      style={{
-        gridTemplateColumns: "repeat(auto-fill, minmax(min(18rem, 100%), 1fr))",
-      }}
-    >
-      {processedTree.map((node) => (
-        <div key={node.slug} className="min-w-0 border border-muted pl-hsp-sm py-vsp-2xs">
-          {node.children.length > 0 ? (
-            <CategoryNode node={node} depth={0} isLast={true} />
-          ) : (
-            <LeafNode node={node} depth={0} isLast={true} />
-          )}
-        </div>
-      ))}
-    </nav>
-  );
-}
-
-function NodeList({ nodes, depth }: { nodes: NavNode[]; depth: number }) {
-  return (
-    <>
-      {nodes.map((node, index) => {
-        const isLast = index === nodes.length - 1;
-        return node.children.length > 0 ? (
-          <CategoryNode
-            key={node.slug}
-            node={node}
-            depth={depth}
-            isLast={isLast}
-          />
-        ) : (
-          <LeafNode
-            key={node.slug}
-            node={node}
-            depth={depth}
-            isLast={isLast}
-          />
-        );
-      })}
-    </>
-  );
-}
-
-function CategoryNode({
-  node,
-  depth,
-  isLast,
-}: {
-  node: NavNode;
-  depth: number;
-  isLast: boolean;
-}) {
-  const [open, setOpen] = useState(true);
-  const toggle = () => setOpen((prev) => !prev);
-  const paddingLeft = padLeft(depth);
-
-  return (
-    <div className={`${depth >= 1 && !isLast ? "relative" : ""}`}>
-      {depth >= 1 && !isLast && open && (
-        <div
-          className="absolute border-l border-dashed border-muted z-local-1"
-          style={{
-            left: connectorLeft(depth),
-            top: 0,
-            bottom: 0,
-          }}
-        />
-      )}
-      <div className="relative">
-        <ConnectorLines
-          depth={depth}
-          isLast={isLast}
-          widthScale={2}
-          topPad="calc(0.15rem + var(--spacing-vsp-xs))"
-        />
-        <div
-          className="flex w-full items-center justify-between text-small font-semibold pt-[0.15rem] text-fg"
-          style={{ paddingLeft }}
-        >
-          {node.href ? (
-            <a
-              href={node.href}
-              className="flex-1 flex items-start gap-hsp-xs py-vsp-xs text-fg hover:text-accent hover:underline focus:underline"
-            >
-              {depth === 0 && (
-                <span className="flex h-[1lh] items-center">
-                  <CategoryLinkIcon className="w-[18px] 2xl:w-[24px]" />
-                </span>
-              )}
-              {node.label}
-            </a>
-          ) : (
-            <button
-              type="button"
-              onClick={toggle}
-              className="flex-1 py-vsp-xs text-left hover:text-accent hover:underline focus:underline"
-            >
-              {node.label}
-            </button>
-          )}
-          <button
-            type="button"
-            onClick={toggle}
-            className="aspect-square flex items-center justify-center w-[1.75rem] border-y border-l border-muted hover:underline focus:underline"
-            aria-expanded={open}
-            aria-label={open ? `Collapse ${node.label}` : `Expand ${node.label}`}
-          >
-            <ChevronRight className={`h-icon-xs w-icon-xs transition-transform duration-150 ${open ? "rotate-90" : ""} text-muted`} />
-          </button>
-        </div>
-      </div>
-      {open && (
-        <div>
-          <NodeList nodes={node.children} depth={depth + 1} />
-        </div>
-      )}
-    </div>
-  );
-}
-
-function LeafNode({
-  node,
-  depth,
-  isLast,
-}: {
-  node: NavNode;
-  depth: number;
-  isLast: boolean;
-}) {
-  if (!node.href) return null;
-  const isRoot = depth === 0;
-  const paddingLeft = padLeft(depth);
-
-  const topPad = isRoot
-    ? "calc(var(--spacing-vsp-xs) + 0.15rem)"
-    : "var(--spacing-vsp-2xs)";
-
-  return (
-    <div>
-      <div className="relative">
-        <ConnectorLines depth={depth} isLast={isLast} widthScale={2} topPad={topPad} />
-        <a
-          href={node.href}
-          className={isRoot
-            ? "flex items-start gap-hsp-xs py-[calc(var(--spacing-vsp-xs)+0.15rem)] text-small font-semibold text-fg hover:text-accent hover:underline focus:underline"
-            : `block py-vsp-2xs ${isLast ? "pb-vsp-xs" : ""} text-small text-fg hover:text-accent hover:underline focus:underline`
-          }
-          style={{ paddingLeft }}
-        >
-          {isRoot && (
-            <span className="flex h-[1lh] items-center">
-              <CategoryLinkIcon className="w-[18px] 2xl:w-[24px]" />
-            </span>
-          )}
-          {node.label}
-        </a>
-      </div>
-    </div>
-  );
-}

package/templates/features/claudeResources/files/plugins/claude-resources-plugin.mjs

@@ -1,47 +0,0 @@
-// @ts-check
-// zfb plugin module: claude-resources.
-//
-// Wires `runClaudeResourcesPreStep` (from
-// `@takazudo/zudo-doc/integrations/claude-resources`) into zfb's
-// `preBuild` lifecycle hook.
-//
-// Previously this shim spawned a `tsx` subprocess because the integration
-// package shipped only TypeScript source (no build step) and `gray-matter`
-// pulled in a CJS `require("fs")` that esbuild's ESM-only config-loader
-// bundle could not satisfy. Both constraints are now lifted: the package
-// ships compiled `dist/` and the plugin host is plain Node (not an esbuild
-// bundle), so the runner can be imported directly.
-
-/** @import { ZfbBuildHookContext, ZfbPlugin } from "@takazudo/zfb/plugins" */
-
-import { runClaudeResourcesPreStep } from "@takazudo/zudo-doc/integrations/claude-resources";
-
-const PLUGIN_NAME = "@takazudo/zudo-doc-claude-resources";
-
-/** @type {ZfbPlugin} */
-export default {
-  name: PLUGIN_NAME,
-
-  /** @param {ZfbBuildHookContext} ctx */
-  async preBuild(ctx) {
-    const claudeDir = ctx.options["claudeDir"];
-    if (typeof claudeDir !== "string" || claudeDir.length === 0) {
-      throw new Error(
-        `[${PLUGIN_NAME}] preBuild: options.claudeDir must be a non-empty string (got ${JSON.stringify(claudeDir)})`,
-      );
-    }
-    const projectRootOpt = ctx.options["projectRoot"];
-    const docsDirOpt = ctx.options["docsDir"];
-    const result = await runClaudeResourcesPreStep({
-      claudeDir,
-      projectRoot:
-        typeof projectRootOpt === "string" ? projectRootOpt : ctx.projectRoot,
-      docsDir: typeof docsDirOpt === "string" ? docsDirOpt : "src/content/docs",
-    });
-    // Surface a one-line summary so build logs make the generation
-    // observable.
-    ctx.logger.info(
-      `claude-resources: ${result.claudemd} CLAUDE.md, ${result.commands} commands, ${result.skills} skills, ${result.agents} agents`,
-    );
-  },
-};

package/templates/features/docHistory/files/plugins/doc-history-plugin.mjs

@@ -1,111 +0,0 @@
-// @ts-check
-// zfb plugin module: doc-history.
-//
-// Wires three lifecycle hooks for the doc-history integration:
-//
-//   preBuild  — emits `.zfb/doc-history-meta.json` (per-page git metadata
-//               consumed at bundle time). Calls `runDocHistoryMetaStep`
-//               directly; honours `SKIP_DOC_HISTORY=1` via the runner's
-//               own env check.
-//
-//   postBuild — invokes `runDocHistoryPostBuild` to write
-//               `<outDir>/doc-history/<slug>.json` files. Skipped by default
-//               on local builds (opt in with `GEN_DOC_HISTORY=1`); always runs
-//               in CI; `SKIP_DOC_HISTORY=1` suppresses it everywhere. The
-//               gating lives in `shouldGeneratePostBuild` (#1986).
-//
-//   devMiddleware — reverse-proxies `/doc-history/*` requests to the
-//               standalone `@takazudo/zudo-doc-history-server` on port 4322.
-//
-// Inline functions are not supported by zfb's plugin runtime — see
-// `@takazudo/zfb/plugins` source comment. Plugins must be authored as
-// standalone modules and referenced from `zfb.config.ts` by `name`.
-
-/** @import { ZfbBuildHookContext, ZfbDevMiddlewareContext, ZfbPlugin } from "@takazudo/zfb/plugins" */
-
-import { runDocHistoryMetaStep } from "@takazudo/zudo-doc/integrations/doc-history";
-import { runDocHistoryPostBuild } from "@takazudo/zudo-doc/integrations/doc-history";
-import { createDocHistoryDevMiddleware } from "@takazudo/zudo-doc/integrations/doc-history";
-import { connectToZfbHandler } from "./connect-adapter.mjs";
-
-/** @type {ZfbPlugin} */
-export default {
-  name: "doc-history",
-
-  /** @param {ZfbBuildHookContext} ctx */
-  async preBuild(ctx) {
-    const { docsDir, locales } = ctx.options;
-    // Validate each locale entry before passing downstream so a misconfigured
-    // locales map surfaces a clear error instead of a confusing runtime crash.
-    if (locales != null) {
-      for (const [key, entry] of Object.entries(/** @type {Record<string, unknown>} */ (locales))) {
-        if (
-          entry == null ||
-          typeof entry !== "object" ||
-          typeof /** @type {any} */ (entry).dir !== "string" ||
-          /** @type {any} */ (entry).dir.length === 0
-        ) {
-          throw new Error(
-            `[doc-history] invalid locales entry "${key}": expected { dir: string }`,
-          );
-        }
-      }
-    }
-    await runDocHistoryMetaStep({
-      projectRoot: ctx.projectRoot,
-      docsDir: typeof docsDir === "string" ? docsDir : "src/content/docs",
-      locales:
-        locales != null
-          ? /** @type {Record<string,{dir:string}>} */ (locales)
-          : undefined,
-    });
-  },
-
-  /** @param {ZfbBuildHookContext} ctx */
-  async postBuild(ctx) {
-    try {
-      await runDocHistoryPostBuild(
-        /** @type {import("@takazudo/zudo-doc/integrations/doc-history").DocHistoryOptions} */ (/** @type {unknown} */ (ctx.options)),
-        { outDir: ctx.outDir, logger: ctx.logger },
-      );
-    } catch (err) {
-      // postBuild dropdown JSON is redundant: the parallel build-history CI job
-      // is the deployed source of truth. Downgrade failures to a warning so a
-      // transient git/CLI error does not red the build-site job.
-      const msg = err instanceof Error ? err.message : String(err);
-      if (ctx.logger?.warn) {
-        ctx.logger.warn(`[doc-history] postBuild failed (non-fatal): ${msg}`);
-      } else {
-        console.warn(`[doc-history] postBuild failed (non-fatal): ${msg}`);
-      }
-    }
-  },
-
-  /** @param {ZfbDevMiddlewareContext} ctx */
-  devMiddleware(ctx) {
-    const middleware = createDocHistoryDevMiddleware(
-      /** @type {import("@takazudo/zudo-doc/integrations/doc-history").DocHistoryOptions} */ (/** @type {unknown} */ (ctx.options)),
-      ctx.logger,
-    );
-    // zfb's `register(path, handler)` matches against the FULL request
-    // URL (no base-stripping). For a non-root base (e.g. "/my-docs/"),
-    // requests arrive as `/my-docs/doc-history/foo.json`, so we register
-    // at the full base-prefixed route. For base="/", the prefix is empty
-    // and the route is `/doc-history` as expected. The v2 middleware
-    // itself is base-tolerant (matches via `url.includes("/doc-history/")`)
-    // and slices from `/doc-history/` onward when proxying upstream.
-    const basePrefix = stripTrailingSlash(
-      typeof ctx.options["base"] === "string" ? ctx.options["base"] : "",
-    );
-    ctx.register(`${basePrefix}/doc-history`, connectToZfbHandler(middleware));
-  },
-};
-
-/**
- * @param {string} s
- * @returns {string}
- */
-function stripTrailingSlash(s) {
-  if (typeof s !== "string" || s.length === 0) return "";
-  return s.endsWith("/") ? s.slice(0, -1) : s;
-}

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

@@ -1,59 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the locale-prefixed per-tag detail route.
-//
-// Non-default-locale per-tag detail page. paths() enumerates every
-// (locale, tag) combination across all non-default locales defined in
-// settings.locales, using the same locale-first + base-fallback merge
-// strategy as the Astro original.
-//
-// paths() contract (zfb ADR-004 — synchronous):
-//   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.
-
-import { settings } from "@/config/settings";
-import type { TagInfo } from "@/utils/tags";
-import type { JSX } from "preact";
-import { collectTagMapForLocale, TagDetailPageView } from "../../../lib/_tag-pages";
-
-export const frontmatter = { title: "Tag" };
-
-/** One route per (non-default locale, tag) pair. */
-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/templates/features/docTags/files/pages/[locale]/docs/tags/index.tsx

@@ -1,39 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// 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 (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).
-//
-// 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 { settings } from "@/config/settings";
-import type { JSX } from "preact";
-import { TagsIndexPageView } from "../../../lib/_tag-pages";
-
-export const frontmatter = { title: "All Tags" };
-
-/** One route per non-default locale (prefixDefaultLocale: false). */
-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/templates/features/docTags/files/pages/docs/tags/[tag].tsx

@@ -1,43 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the default-locale per-tag detail route.
-//
-// 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.
-//
-// paths() contract (zfb ADR-004 — synchronous):
-//   params: { tag: string }
-//   props:  { tagInfo: TagInfo }
-//
-// 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 { defaultLocale } from "@/config/i18n";
-import type { TagInfo } from "@/utils/tags";
-import type { JSX } from "preact";
-import { collectTagMapForLocale, TagDetailPageView } from "../../lib/_tag-pages";
-
-export const frontmatter = { title: "Tag" };
-
-/** One entry per unique tag in the default-locale collection. */
-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/templates/features/docTags/files/pages/docs/tags/index.tsx

@@ -1,20 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the default-locale "All Tags" index route.
-//
-// 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.
-//
-// Tag collection + rendering are shared with the locale-prefixed route via
-// pages/lib/_tag-pages.tsx (#2010).
-
-import { defaultLocale } from "@/config/i18n";
-import type { JSX } from "preact";
-import { TagsIndexPageView } from "../../lib/_tag-pages";
-
-export const frontmatter = { title: "All Tags" };
-
-export default function DocsTagsIndexPage(): JSX.Element {
-  return <TagsIndexPageView locale={defaultLocale} />;
-}

package/templates/features/llmsTxt/files/plugins/llms-txt-plugin.mjs

@@ -1,93 +0,0 @@
-// @ts-check
-// zfb plugin module: llms-txt.
-//
-// Wires two lifecycle hooks for the llms-txt integration:
-//
-//   postBuild — invokes `emitLlmsTxt` to write `dist/llms.txt`,
-//               `dist/llms-full.txt`, and the per-locale variants.
-//               `siteUrl` is normalised to `undefined` when falsy because
-//               the runner switches between absolute and root-relative URLs
-//               based on its presence (matches legacy Astro behaviour).
-//
-//   devMiddleware — serves `/llms.txt`, `/llms-full.txt`, and the per-locale
-//               `/<code>/llms.txt` / `/<code>/llms-full.txt` variants from
-//               the on-the-fly `generateLlmsTxt` generator so dev output
-//               stays in lockstep with the production `emitLlmsTxt`
-//               byte-for-byte.
-//
-// `options` carries `{ siteName, siteDescription, base, siteUrl,
-// defaultLocaleDir, locales }` from the matching entry in `zfb.config.ts`.
-//
-// Inline functions are not supported by zfb's plugin runtime; see the
-// sibling `doc-history-plugin.mjs` for the rationale.
-
-/** @import { ZfbBuildHookContext, ZfbDevMiddlewareContext, ZfbPlugin } from "@takazudo/zfb/plugins" */
-/** @import { LlmsTxtEmitOptions, LlmsTxtDevMiddlewareOptions } from "@takazudo/zudo-doc/integrations/llms-txt" */
-
-import { emitLlmsTxt, createLlmsTxtDevMiddleware } from "@takazudo/zudo-doc/integrations/llms-txt";
-import { connectToZfbHandler } from "./connect-adapter.mjs";
-
-/** @type {ZfbPlugin} */
-export default {
-  name: "llms-txt",
-
-  /** @param {ZfbBuildHookContext} ctx */
-  async postBuild(ctx) {
-    await emitLlmsTxt(/** @type {LlmsTxtEmitOptions} */ (/** @type {unknown} */ ({
-      ...ctx.options,
-      outDir: ctx.outDir,
-      // siteUrl is normalised to undefined when falsy because the runner
-      // switches between absolute and root-relative URLs based on its
-      // presence (matches legacy Astro behaviour).
-      siteUrl: ctx.options["siteUrl"] || undefined,
-      logger: ctx.logger,
-    })));
-  },
-
-  /** @param {ZfbDevMiddlewareContext} ctx */
-  devMiddleware(ctx) {
-    const middleware = createLlmsTxtDevMiddleware(
-      /** @type {LlmsTxtDevMiddlewareOptions} */ (/** @type {unknown} */ (ctx.options)),
-      ctx.logger,
-    );
-    const handler = connectToZfbHandler(middleware);
-
-    // zfb's `register(path, handler)` matches against the FULL request
-    // URL (no base-stripping). For a non-root base (e.g. "/my-docs/"),
-    // requests arrive as `/my-docs/llms.txt` (etc.), so we register
-    // every route with the base prefix. For base="/", the prefix is
-    // empty and routes are `/llms.txt` etc. as expected. The middleware
-    // accepts base-prefixed URLs via the matcher (see `matchLlmsRoute`
-    // in `dev-middleware.ts`).
-    const basePrefix = stripTrailingSlash(
-      typeof ctx.options["base"] === "string" ? ctx.options["base"] : "",
-    );
-    ctx.register(`${basePrefix}/llms.txt`, handler);
-    ctx.register(`${basePrefix}/llms-full.txt`, handler);
-    const locales = ctx.options["locales"];
-    if (Array.isArray(locales)) {
-      for (const locale of locales) {
-        if (locale && typeof locale === "object" && typeof locale.code === "string") {
-          ctx.register(`${basePrefix}/${locale.code}/llms.txt`, handler);
-          ctx.register(`${basePrefix}/${locale.code}/llms-full.txt`, handler);
-        } else {
-          const repr = JSON.stringify(locale);
-          if (ctx.logger?.warn) {
-            ctx.logger.warn(`[llms-txt] skipping malformed locale entry (expected { code: string }): ${repr}`);
-          } else {
-            console.warn(`[llms-txt] skipping malformed locale entry (expected { code: string }): ${repr}`);
-          }
-        }
-      }
-    }
-  },
-};
-
-/**
- * @param {string} s
- * @returns {string}
- */
-function stripTrailingSlash(s) {
-  if (typeof s !== "string" || s.length === 0) return "";
-  return s.endsWith("/") ? s.slice(0, -1) : s;
-}

package/templates/features/versioning/files/pages/[locale]/docs/versions.tsx

@@ -1,48 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the locale-prefixed versions index route.
-//
-// Non-default-locale versions page. paths() emits one route per locale in
-// settings.locales. Locale string is passed as a prop to drive label
-// translation in the component.
-//
-// Rendering is shared with the default-locale route via
-// pages/lib/_versions-page.tsx (#2010).
-//
-// paths() contract (zfb ADR-004 — synchronous):
-//   params: { locale: string }
-//   props:  { locale }
-
-import { settings } from "@/config/settings";
-import type { JSX } from "preact";
-import { VersionsPageView } from "../../lib/_versions-page";
-
-export const frontmatter = { title: "Versions" };
-
-// ---------------------------------------------------------------------------
-// paths() — synchronous (ADR-004)
-// ---------------------------------------------------------------------------
-
-/** One route per non-default locale. */
-export function paths(): Array<{
-  params: { locale: string };
-  props: { locale: string };
-}> {
-  return Object.keys(settings.locales).map((locale) => ({
-    params: { locale },
-    props: { locale },
-  }));
-}
-
-// ---------------------------------------------------------------------------
-// Page component
-// ---------------------------------------------------------------------------
-
-interface PageArgs {
-  params: { locale: string };
-  props: { locale: string };
-}
-
-export default function LocaleVersionsPage({ params }: PageArgs): JSX.Element {
-  return <VersionsPageView locale={params.locale} />;
-}