create-zudo-doc 3.2.0 → 3.3.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/tauri/files/src/components/find-bar.tsx

@@ -1,122 +0,0 @@
-"use client";
-
-import { useState, useRef, useEffect, useCallback } from "preact/hooks";
-import type { FindResult, FindInPage } from "@/utils/find-in-page";
-
-interface FindBarProps {
-  visible: boolean;
-  onClose: () => void;
-  findInPage: FindInPage;
-  containerSelector: string;
-}
-
-function toMatchInfo(result: FindResult): FindResult | null {
-  return result.matches > 0 ? result : null;
-}
-
-export function FindBar({ visible, onClose, findInPage, containerSelector }: FindBarProps) {
-  const [query, setQuery] = useState("");
-  const [matchInfo, setMatchInfo] = useState<FindResult | null>(null);
-  const inputRef = useRef<HTMLInputElement>(null);
-  // Pin `findInPage` via ref so the visibility-clear effect doesn't
-  // re-run when a new `find-in-page` instance is passed; the latest
-  // value is read at effect-fire time without entering the deps.
-  const findInPageRef = useRef(findInPage);
-  useEffect(() => {
-    findInPageRef.current = findInPage;
-  }, [findInPage]);
-
-  useEffect(() => {
-    if (visible) {
-      inputRef.current?.focus();
-      inputRef.current?.select();
-    }
-  }, [visible]);
-
-  useEffect(() => {
-    if (!visible) {
-      setQuery("");
-      setMatchInfo(null);
-      findInPageRef.current.stop();
-    }
-  }, [visible]);
-
-  const handleFind = useCallback(
-    (text: string) => {
-      const container = document.querySelector(containerSelector);
-      if (!text || !(container instanceof HTMLElement)) {
-        setMatchInfo(null);
-        findInPage.stop();
-        return;
-      }
-      const result = findInPage.find(container, text);
-      setMatchInfo(toMatchInfo(result));
-    },
-    [findInPage, containerSelector],
-  );
-
-  const handleKeyDown = useCallback(
-    (e: React.KeyboardEvent<HTMLInputElement>) => {
-      if (e.key === "Escape") {
-        onClose();
-      } else if (e.key === "Enter") {
-        const result = e.shiftKey ? findInPage.prev() : findInPage.next();
-        setMatchInfo(toMatchInfo(result));
-      }
-    },
-    [onClose, findInPage],
-  );
-
-  if (!visible) return null;
-
-  return (
-    <div className="fixed top-[3.5rem] right-0 z-dropdown flex items-center gap-hsp-sm py-hsp-xs px-hsp-md bg-surface border-b border-l border-muted rounded-bl-lg shadow-md">
-      <input
-        ref={inputRef}
-        className="w-48 py-[4px] px-hsp-sm rounded text-small bg-bg border border-muted text-fg outline-none focus:border-accent"
-        type="text"
-        value={query}
-        placeholder="Find in page..."
-        aria-label="Find in page"
-        onChange={(e) => {
-          setQuery(e.currentTarget.value);
-          handleFind(e.currentTarget.value);
-        }}
-        onKeyDown={handleKeyDown}
-      />
-      <span className="text-caption whitespace-nowrap min-w-[3rem] text-center text-fg/60">
-        {matchInfo ? `${matchInfo.activeMatchOrdinal}/${matchInfo.matches}` : ""}
-      </span>
-      <button
-        type="button"
-        className="py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface"
-        onClick={() => {
-          const result = findInPage.prev();
-          setMatchInfo(toMatchInfo(result));
-        }}
-        title="Previous (Shift+Enter)"
-      >
-        Prev
-      </button>
-      <button
-        type="button"
-        className="py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface"
-        onClick={() => {
-          const result = findInPage.next();
-          setMatchInfo(toMatchInfo(result));
-        }}
-        title="Next (Enter)"
-      >
-        Next
-      </button>
-      <button
-        type="button"
-        className="py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface"
-        onClick={onClose}
-        title="Close (Esc)"
-      >
-        Close
-      </button>
-    </div>
-  );
-}

package/templates/features/tauri/files/src/components/find-in-page-init.tsx

@@ -1,59 +0,0 @@
-"use client";
-
-import { useState, useEffect, useRef } from "preact/compat";
-import { FindBar } from "./find-bar";
-import { createFindInPage } from "@/utils/find-in-page";
-
-const CONTENT_SELECTOR = "article.zd-content";
-
-export default function FindInPageInit() {
-  const [isTauri, setIsTauri] = useState(false);
-  const [visible, setVisible] = useState(false);
-  const findInPageRef = useRef(createFindInPage());
-
-  // Detect Tauri environment
-  useEffect(() => {
-    if (typeof window !== "undefined" && "__TAURI_INTERNALS__" in window) {
-      setIsTauri(true);
-    }
-  }, []);
-
-  // Intercept Cmd/Ctrl+F only in Tauri
-  useEffect(() => {
-    if (!isTauri) return;
-
-    const handler = (e: KeyboardEvent) => {
-      if ((e.metaKey || e.ctrlKey) && e.key === "f") {
-        e.preventDefault();
-        setVisible((prev) => !prev);
-      }
-    };
-    document.addEventListener("keydown", handler);
-    return () => document.removeEventListener("keydown", handler);
-  }, [isTauri]);
-
-  // Clear search on zfb page navigation. zfb navigates via SPA body swap and
-  // fires "zfb:before-preparation" on document before nav — it never fires the
-  // native "pagehide" (full-unload) event. The literal is inlined because
-  // downstream scaffolds do not depend on @takazudo/zudo-doc as a runtime dep
-  // (same reason as the designTokenPanel bootstrap).
-  useEffect(() => {
-    const handler = () => {
-      findInPageRef.current.stop();
-      setVisible(false);
-    };
-    document.addEventListener("zfb:before-preparation", handler);
-    return () => document.removeEventListener("zfb:before-preparation", handler);
-  }, []);
-
-  if (!isTauri) return null;
-
-  return (
-    <FindBar
-      visible={visible}
-      onClose={() => setVisible(false)}
-      findInPage={findInPageRef.current}
-      containerSelector={CONTENT_SELECTOR}
-    />
-  );
-}

package/templates/features/tauri/files/src/utils/find-in-page.ts

@@ -1,175 +0,0 @@
-export interface FindResult {
-  matches: number;
-  activeMatchOrdinal: number; // 1-based
-}
-
-export interface FindInPage {
-  find(container: HTMLElement, query: string): FindResult;
-  next(): FindResult;
-  prev(): FindResult;
-  stop(): void;
-}
-
-const MATCH_CLASS = "find-match";
-const ACTIVE_CLASS = "find-match-active";
-const MATCH_ATTR = "data-find-match";
-const ACTIVE_ATTR = "data-find-active";
-
-const EMPTY_RESULT: FindResult = Object.freeze({ matches: 0, activeMatchOrdinal: 0 });
-
-/**
- * Create a DOM-based find-in-page utility.
- *
- * Limitation: only matches within single text nodes. Cross-element matching
- * (e.g. "Hello world" spanning `<strong>Hello</strong> world`) is not supported.
- */
-export function createFindInPage(): FindInPage {
-  let matchElements: HTMLElement[] = [];
-  let activeIndex = -1;
-
-  function clearMarks(): void {
-    const parentsToNormalize = new Set<Node>();
-
-    for (let i = matchElements.length - 1; i >= 0; i--) {
-      const mark = matchElements[i];
-      const parent = mark.parentNode;
-      if (parent) {
-        const textNode = document.createTextNode(mark.textContent || "");
-        parent.replaceChild(textNode, mark);
-        parentsToNormalize.add(parent);
-      }
-    }
-    for (const parent of parentsToNormalize) {
-      (parent as Element).normalize();
-    }
-    matchElements = [];
-    activeIndex = -1;
-  }
-
-  function setActive(index: number): void {
-    if (activeIndex >= 0 && activeIndex < matchElements.length) {
-      const prev = matchElements[activeIndex];
-      prev.classList.remove(ACTIVE_CLASS);
-      prev.removeAttribute(ACTIVE_ATTR);
-    }
-    activeIndex = index;
-    if (activeIndex >= 0 && activeIndex < matchElements.length) {
-      const current = matchElements[activeIndex];
-      current.classList.add(ACTIVE_CLASS);
-      current.setAttribute(ACTIVE_ATTR, "true");
-      current.scrollIntoView?.({ block: "center" });
-    }
-  }
-
-  function currentResult(): FindResult {
-    if (matchElements.length === 0) {
-      return EMPTY_RESULT;
-    }
-    return {
-      matches: matchElements.length,
-      activeMatchOrdinal: activeIndex + 1,
-    };
-  }
-
-  function find(container: HTMLElement, query: string): FindResult {
-    clearMarks();
-
-    if (!query) {
-      return EMPTY_RESULT;
-    }
-
-    const lowerQuery = query.toLowerCase();
-
-    const walker = document.createTreeWalker(
-      container,
-      NodeFilter.SHOW_TEXT,
-      null,
-    );
-
-    const textNodes: Text[] = [];
-    let node: Text | null;
-    while ((node = walker.nextNode() as Text | null)) {
-      textNodes.push(node);
-    }
-
-    for (const textNode of textNodes) {
-      const text = textNode.textContent || "";
-      const lowerText = text.toLowerCase();
-
-      const positions: number[] = [];
-      let searchFrom = 0;
-      while (searchFrom < lowerText.length) {
-        const idx = lowerText.indexOf(lowerQuery, searchFrom);
-        if (idx === -1) break;
-        positions.push(idx);
-        searchFrom = idx + lowerQuery.length;
-      }
-
-      if (positions.length === 0) continue;
-
-      const parent = textNode.parentNode;
-      if (!parent) continue;
-
-      let remainingNode: Text = textNode;
-      const nodeMarks: HTMLElement[] = [];
-
-      for (let i = positions.length - 1; i >= 0; i--) {
-        const pos = positions[i];
-        const matchLen = query.length;
-
-        if (pos + matchLen < remainingNode.length) {
-          remainingNode.splitText(pos + matchLen);
-        }
-
-        let matchNode: Text;
-        if (pos > 0) {
-          matchNode = remainingNode.splitText(pos);
-        } else {
-          matchNode = remainingNode;
-        }
-
-        const mark = document.createElement("mark");
-        mark.className = MATCH_CLASS;
-        mark.setAttribute(MATCH_ATTR, "true");
-        mark.textContent = matchNode.textContent;
-
-        parent.replaceChild(mark, matchNode);
-        nodeMarks.unshift(mark);
-      }
-
-      matchElements.push(...nodeMarks);
-    }
-
-    if (matchElements.length === 0) {
-      return EMPTY_RESULT;
-    }
-
-    setActive(0);
-    return currentResult();
-  }
-
-  function next(): FindResult {
-    if (matchElements.length === 0) {
-      return EMPTY_RESULT;
-    }
-    const newIndex = (activeIndex + 1) % matchElements.length;
-    setActive(newIndex);
-    return currentResult();
-  }
-
-  function prev(): FindResult {
-    if (matchElements.length === 0) {
-      return EMPTY_RESULT;
-    }
-    const newIndex =
-      (activeIndex - 1 + matchElements.length) % matchElements.length;
-    setActive(newIndex);
-    return currentResult();
-  }
-
-  function stop(): void {
-    clearMarks();
-  }
-
-  return { find, next, prev, stop };
-}