create-zudo-doc 3.2.0 → 4.0.0

package/templates/features/docHistory/files/src/types/doc-history.ts

@@ -1,7 +0,0 @@
-// Re-export stub for DocHistory types.
-//
-// DocHistoryData and DocHistoryEntry now ship from the package at
-// @takazudo/zudo-doc/island-types (epic #2344, S1a).
-// This file is kept as a stable re-export in case any project-local code
-// references the @/types/doc-history path.
-export type { DocHistoryData, DocHistoryEntry } from "@takazudo/zudo-doc/island-types";

package/templates/features/dynamicPageTransition/files/src/components/client-router-bootstrap.tsx

@@ -1,72 +0,0 @@
-"use client";
-
-// Client-side bootstrap for the @takazudo/zfb-runtime ClientRouter.
-//
-// Why this exists (zudolab/zudo-doc#1524, W7A verification):
-// `<ClientRouter />` (mounted in doc-layout.tsx) emits SSR meta tags + CSS
-// for the SPA soft-swap router, but the actual click/form intercept
-// registration runs as a top-of-module side effect inside
-// `@takazudo/zfb-runtime/src/client-router.ts`:
-//
-//   if (typeof document !== "undefined") { init(); }
-//
-// The host's existing `import { ClientRouter } from "@takazudo/zfb-runtime"`
-// in doc-layout.tsx happens during SSR (where typeof document ===
-// "undefined"), so the side effect is silently skipped — the router
-// module never reaches the client bundle and every navigation falls
-// through to a full page load. W7A's Playwright harness confirmed this:
-// pageswap.viewTransition is null, getAnimations() is empty during nav,
-// and the sidebar DOM identity is destroyed on every click.
-//
-// The fix is a minimal "use client" island whose only job is to
-// side-effect-import `@takazudo/zfb-runtime/client-router` so the same
-// guard fires in the browser. The `init()` is idempotent (guarded by an
-// `initialized` flag in router.ts), so even if the import path is
-// reached again later the registration runs exactly once.
-//
-// Bundle cost: the only thing this island ships to the client is the
-// client-router subgraph (router.ts + swap-functions.ts + events.ts +
-// types.ts + cssesc.ts) plus its single dep on `@takazudo/zfb/runtime`'s
-// island manager. The server-only zfb-runtime modules
-// (createPageRouter, snapshot, framework adapter) are not transitively
-// reachable from the client-router barrel and stay out of the bundle.
-//
-// Why not call init() in useEffect instead of a side-effect import:
-// useEffect fires after Preact mounts, which is after the islands
-// runtime fetches and executes the bundle. Module top-level code runs
-// as soon as the bundle is parsed by the browser — earlier than mount,
-// closer to Astro's <script type="module"> emission timing. The first
-// click on a fresh page typically arrives 100ms+ after parse, so this
-// timing is what makes the SPA-router actually intercept.
-
-// Side-effect import — running this file's bundle in the browser
-// triggers the `if (typeof document !== "undefined") { init(); }` guard
-// at the top of `@takazudo/zfb-runtime/src/client-router.ts`.
-import "@takazudo/zfb-runtime/client-router";
-
-import type { JSX } from "preact";
-
-/**
- * Renders nothing. The island marker exists only so zfb's island scanner
- * walks page → BodyEndIslands → ClientRouterBootstrap and includes the
- * client-router barrel in the per-island bundle, where the side-effect
- * import above can fire on the client.
- *
- * Note: the SSR `<ClientRouter />` mounted by `DocLayout` (via
- * `enableClientRouter`) self-activates the SPA router when its head meta
- * tags reach the browser. This host island is therefore a no-op for
- * router activation — it is kept only for the `when="load"` hydration
- * slot and bundle inclusion. The actual on/off gate is
- * `enableClientRouter` on `<DocLayoutWithDefaults>`, set to
- * `settings.dynamicPageTransition` at every call site.
- */
-function ClientRouterBootstrap(): JSX.Element | null {
-  return null;
-}
-
-// Stable marker name across SSR / scanner / hydration manifest. Required
-// for production minification per the existing pattern in
-// `pages/lib/_body-end-islands.tsx` (zfb PR #150 marker-name alignment).
-ClientRouterBootstrap.displayName = "ClientRouterBootstrap";
-
-export default ClientRouterBootstrap;

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

@@ -1,72 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the locale-prefixed site index route.
-//
-// Non-default-locale site index. paths() emits one route per locale defined
-// in settings.locales (never the default locale — that is handled by
-// pages/index.tsx since prefixDefaultLocale is false).
-//
-// paths() contract (zfb ADR-004 — synchronous):
-//   params: { locale: string }   — e.g. "ja"
-//   props:  { locale }           — resolved locale passed to component
-//
-// Data flow (inside component — sync per ADR-004):
-//   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 { routeContext } from "../lib/_route-context";
-import { prepareHomeData } from "@takazudo/zudo-doc/home-page";
-import type { JSX } from "preact";
-import { HomePageView } from "../lib/_chrome";
-
-export const frontmatter = { title: "Home" };
-
-// ---------------------------------------------------------------------------
-// paths() — synchronous (ADR-004)
-// ---------------------------------------------------------------------------
-
-/** Emit 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 LocaleIndexPage({ params }: PageArgs): JSX.Element {
-  const locale = params.locale;
-
-  const { tree, categoryOrder, tagCount } = prepareHomeData(routeContext, locale);
-
-  return (
-    <HomePageView
-      locale={locale}
-      tree={tree}
-      categoryOrder={categoryOrder}
-      tagCount={tagCount}
-    />
-  );
-}

package/templates/features/imageEnlarge/files/src/components/image-enlarge.tsx

@@ -1,11 +0,0 @@
-"use client";
-
-// Re-export shim for the ImageEnlarge island.
-//
-// The real component and its SSR fallback now ship in the package at
-// @takazudo/zudo-doc/image-enlarge (epic #2344, S3).
-// pages/lib/_body-end-islands.tsx imports them directly from there; this
-// overlay overwrites the base W6A no-op stub so that any project-local
-// code referencing the @/components/image-enlarge path resolves to the
-// real island when the imageEnlarge feature is enabled.
-export { ImageEnlarge, ImageEnlargeSsrFallback } from "@takazudo/zudo-doc/image-enlarge";

package/templates/features/sidebarToggle/files/src/components/desktop-sidebar-toggle.tsx

@@ -1,6 +0,0 @@
-// Thin re-export shim. DesktopSidebarToggle moved into the package
-// (`@takazudo/zudo-doc/desktop-sidebar-toggle-island`) as part of the
-// package-first migration (#2344, S2). Host code using
-// `@/components/desktop-sidebar-toggle` still resolves correctly;
-// the implementation lives in the package.
-export { DesktopSidebarToggle, SIDEBAR_STORAGE_KEY } from "@takazudo/zudo-doc/desktop-sidebar-toggle-island";

package/templates/features/tagGovernance/files/scripts/tags-audit.ts

@@ -1,131 +0,0 @@
-#!/usr/bin/env -S tsx
-/**
- * scripts/tags-audit.ts
- *
- * Thin re-export shim — the audit logic lives in @takazudo/zudo-doc/tags-audit
- * (S9b #2334). This file exists for backward-compat with any project-side
- * imports of these functions (e.g. custom scripts that import helpers from here).
- *
- * The `tags:audit` package.json script does not invoke this file directly;
- * it uses the `tags-audit` package bin from @takazudo/zudo-doc instead.
- *
- * CLI usage (still works via tsx for debugging):
- *   tsx scripts/tags-audit.ts [--fix] [--ci] [--json]
- */
-
-import { join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import pc from "picocolors";
-import pluralize from "pluralize";
-import stringSimilarity from "string-similarity";
-
-import { settings } from "../src/config/settings";
-import { tagVocabulary } from "../src/config/tag-vocabulary";
-
-// Re-export everything from the package core so existing callers continue
-// to work unchanged.
-export {
-  audit,
-  applyFixes,
-  buildIndex,
-  collectMdxFiles,
-  computeRewrites,
-  formatTextReport,
-  hasHardIssues,
-  normalizeTags,
-  rewriteAliasesByteStable,
-} from "@takazudo/zudo-doc/tags-audit";
-export type {
-  AliasIssue,
-  AuditOptions,
-  AuditReport,
-  DeprecatedIssue,
-  NearDuplicatePair,
-  NearDupHelpers,
-  TagVocabularyEntry,
-  UnknownIssue,
-} from "@takazudo/zudo-doc/tags-audit";
-
-// Backward-compat: expose findNearDuplicates with project helpers pre-bound.
-import { findNearDuplicates as _findNearDuplicates } from "@takazudo/zudo-doc/tags-audit";
-export function findNearDuplicates(
-  tags: string[],
-): import("@takazudo/zudo-doc/tags-audit").NearDuplicatePair[] {
-  return _findNearDuplicates(tags, {
-    singular: pluralize.singular,
-    compareTwoStrings: stringSimilarity.compareTwoStrings,
-  });
-}
-
-// ── CLI runner (legacy — package bin is preferred) ─────────────────────────
-
-const __filename = fileURLToPath(import.meta.url);
-const isMain =
-  process.argv[1] !== undefined &&
-  resolve(process.argv[1]) === resolve(__filename);
-
-if (isMain) {
-  const { audit: coreAudit, computeRewrites: coreComputeRewrites, applyFixes: coreApplyFixes, hasHardIssues: coreHasHardIssues, formatTextReport: coreFormatReport } =
-    await import("@takazudo/zudo-doc/tags-audit");
-
-  const argv = process.argv.slice(2);
-  const flags = {
-    fix: argv.includes("--fix"),
-    ci: argv.includes("--ci"),
-    json: argv.includes("--json"),
-  };
-
-  const ROOT_DIR = resolve(__filename, "..", "..");
-  const docsDir = join(ROOT_DIR, settings.docsDir);
-  const localeDirs = Object.values(settings.locales ?? {}).map((l) =>
-    join(ROOT_DIR, l.dir),
-  );
-  const contentDirs = [docsDir, ...localeDirs];
-  const vocabularyActive =
-    Boolean(settings.tagVocabulary) && settings.tagGovernance !== "off";
-
-  if (flags.fix) {
-    const rewrites = coreComputeRewrites(tagVocabulary);
-    const touched = await coreApplyFixes(contentDirs, rewrites, ROOT_DIR);
-    if (flags.json) {
-      process.stdout.write(JSON.stringify({ fixed: touched }, null, 2) + "\n");
-    } else if (touched.length === 0) {
-      console.log(pc.green("✓ No alias rewrites needed"));
-    } else {
-      console.log(pc.green(`✓ Rewrote aliases in ${touched.length} file(s):`));
-      for (const f of touched) console.log(`  ${f}`);
-    }
-    process.exit(0);
-  }
-
-  const report = await coreAudit({
-    rootDir: ROOT_DIR,
-    contentDirs,
-    vocabulary: tagVocabulary,
-    governance: settings.tagGovernance,
-    vocabularyActive,
-    nearDupHelpers: {
-      singular: pluralize.singular,
-      compareTwoStrings: stringSimilarity.compareTwoStrings,
-    },
-  });
-
-  if (flags.json) {
-    process.stdout.write(JSON.stringify(report, null, 2) + "\n");
-  } else {
-    console.log(coreFormatReport(report, settings.tagGovernance, vocabularyActive, pc));
-  }
-
-  const hardIssues = coreHasHardIssues(report);
-  if (hardIssues && (flags.ci || settings.tagGovernance === "strict")) {
-    process.exit(1);
-  }
-  if (hardIssues) {
-    console.error(
-      pc.yellow(
-        "Note: tag issues found but running in non-strict mode (exit 0). Use --ci to fail.",
-      ),
-    );
-  }
-}