create-zudo-doc 0.2.21 → 1.0.0

package/templates/features/docHistory/files/src/components/doc-history.tsx

@@ -1,638 +1,10 @@
 "use client";
 
-import { useState, useEffect, useCallback, useMemo, useRef } from "preact/compat";
-import type { Change } from "diff";
-import type { DocHistoryData, DocHistoryEntry } from "@/types/doc-history";
-import { SmartBreak } from "@/utils/smart-break";
-
-interface DocHistoryProps {
-  slug: string;
-  locale?: string;
-  basePath?: string;
-}
-
-type PanelView = "closed" | "revisions" | "diff";
-
-interface DiffSelection {
-  older: DocHistoryEntry;
-  newer: DocHistoryEntry;
-}
-
-/* ────────────────────────────────────────────
- * Icons
- * ──────────────────────────────────────────── */
-
-function HistoryIcon() {
-  return (
-    <svg
-      xmlns="http://www.w3.org/2000/svg"
-      viewBox="0 0 24 24"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth={2}
-      strokeLinecap="round"
-      strokeLinejoin="round"
-      className="h-icon-md w-icon-md"
-    >
-      <circle cx="12" cy="12" r="10" />
-      <polyline points="12 6 12 12 16 14" />
-    </svg>
-  );
-}
-
-function CloseIcon() {
-  return (
-    <svg
-      xmlns="http://www.w3.org/2000/svg"
-      viewBox="0 0 24 24"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth={2}
-      strokeLinecap="round"
-      strokeLinejoin="round"
-      className="h-icon-md w-icon-md"
-    >
-      <path d="M18 6L6 18M6 6l12 12" />
-    </svg>
-  );
-}
-
-function ArrowLeftIcon() {
-  return (
-    <svg
-      xmlns="http://www.w3.org/2000/svg"
-      viewBox="0 0 24 24"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth={2}
-      strokeLinecap="round"
-      strokeLinejoin="round"
-      className="h-icon-sm w-icon-sm"
-    >
-      <path d="M19 12H5M12 19l-7-7 7-7" />
-    </svg>
-  );
-}
-
-/* ────────────────────────────────────────────
- * Spinner (matches page-loading-overlay style)
- * ──────────────────────────────────────────── */
-
-function Spinner() {
-  return (
-    <div className="flex items-center justify-center py-vsp-xl">
-      <span
-        className="inline-block box-border rounded-full animate-spin"
-        style={{
-          width: 48,
-          height: 48,
-          border: "5px solid var(--color-fg, #fff)",
-          borderBottomColor: "transparent",
-        }}
-      />
-    </div>
-  );
-}
-
-/* ────────────────────────────────────────────
- * Side-by-side diff row types and builder
- * ──────────────────────────────────────────── */
-
-interface DiffRow {
-  leftLine: string | null; // null = empty (added-only row)
-  rightLine: string | null; // null = empty (removed-only row)
-  leftNum: number | null;
-  rightNum: number | null;
-  type: "context" | "removed" | "added" | "changed";
-}
-
-type DiffChanges = Change[];
-
-function buildSideBySideRows(
-  changes: DiffChanges,
-): DiffRow[] {
-  const rows: DiffRow[] = [];
-  let leftNum = 0;
-  let rightNum = 0;
-
-  let i = 0;
-  while (i < changes.length) {
-    const change = changes[i];
-
-    if (!change.added && !change.removed) {
-      // Context lines — show on both sides
-      const lines = change.value.replace(/\n$/, "").split("\n");
-      for (const line of lines) {
-        leftNum++;
-        rightNum++;
-        rows.push({ leftLine: line, rightLine: line, leftNum, rightNum, type: "context" });
-      }
-      i++;
-    } else if (change.removed && i + 1 < changes.length && changes[i + 1].added) {
-      // Paired remove+add — show side by side
-      const removedLines = change.value.replace(/\n$/, "").split("\n");
-      const addedLines = changes[i + 1].value.replace(/\n$/, "").split("\n");
-      const maxLen = Math.max(removedLines.length, addedLines.length);
-      for (let j = 0; j < maxLen; j++) {
-        const left = j < removedLines.length ? removedLines[j] : null;
-        const right = j < addedLines.length ? addedLines[j] : null;
-        if (left !== null) leftNum++;
-        if (right !== null) rightNum++;
-        rows.push({
-          leftLine: left,
-          rightLine: right,
-          leftNum: left !== null ? leftNum : null,
-          rightNum: right !== null ? rightNum : null,
-          type: "changed",
-        });
-      }
-      i += 2;
-    } else if (change.removed) {
-      const lines = change.value.replace(/\n$/, "").split("\n");
-      for (const line of lines) {
-        leftNum++;
-        rows.push({ leftLine: line, rightLine: null, leftNum, rightNum: null, type: "removed" });
-      }
-      i++;
-    } else {
-      // added
-      const lines = change.value.replace(/\n$/, "").split("\n");
-      for (const line of lines) {
-        rightNum++;
-        rows.push({ leftLine: null, rightLine: line, leftNum: null, rightNum, type: "added" });
-      }
-      i++;
-    }
-  }
-
-  return rows;
-}
-
-/* ────────────────────────────────────────────
- * DiffViewer sub-component (side-by-side)
- * ──────────────────────────────────────────── */
-
-function DiffViewer({
-  selection,
-  onBack,
-  showBackButton,
-}: {
-  selection: DiffSelection;
-  onBack: () => void;
-  showBackButton: boolean;
-}) {
-  const [changes, setChanges] = useState<DiffChanges | null>(null);
-
-  useEffect(() => {
-    let cancelled = false;
-    // Lazy-load diff — only needed after History → Compare. This keeps the
-    // module out of the eager islands bundle.
-    import("diff").then(({ diffLines }) => {
-      if (!cancelled) {
-        setChanges(diffLines(selection.older.content, selection.newer.content));
-      }
-    });
-    return () => { cancelled = true; };
-  }, [selection.older.content, selection.newer.content]);
-
-  const rows = useMemo(
-    () => (changes ? buildSideBySideRows(changes) : []),
-    [changes],
-  );
-
-  return (
-    <div className="flex flex-col h-full">
-      {/* Header */}
-      <div className="flex items-center gap-hsp-sm px-hsp-lg py-vsp-xs border-b border-muted">
-        {showBackButton && (
-          <button
-            type="button"
-            onClick={onBack}
-            className="text-muted hover:text-fg lg:hidden"
-            aria-label="Back to revisions"
-          >
-            <ArrowLeftIcon />
-          </button>
-        )}
-        <div className="flex-1 min-w-0 flex">
-          <div className="w-1/2 text-small text-muted font-mono truncate pr-hsp-sm">
-            {selection.older.hash.slice(0, 7)}
-          </div>
-          <div className="w-1/2 text-small text-muted font-mono truncate pl-hsp-sm">
-            {selection.newer.hash.slice(0, 7)}
-          </div>
-        </div>
-      </div>
-
-      {/* Side-by-side diff — shows a loading state while the diff module lazy-loads */}
-      {!changes && (
-        <div className="flex-1 flex items-center justify-center py-vsp-xl">
-          <p className="text-small text-muted">Loading diff…</p>
-        </div>
-      )}
-      <div className={`flex-1 overflow-auto${!changes ? " hidden" : ""}`}>
-        <table className="w-full border-collapse" style={{ tableLayout: "fixed" }}>
-          <colgroup>
-            <col style={{ width: "2.5rem" }} />
-            <col />
-            <col style={{ width: "2.5rem" }} />
-            <col />
-          </colgroup>
-          <tbody>
-            {rows.map((row, idx) => {
-              const leftBg =
-                row.type === "removed" || row.type === "changed"
-                  ? "diff-line-removed"
-                  : "";
-              const rightBg =
-                row.type === "added" || row.type === "changed"
-                  ? "diff-line-added"
-                  : "";
-              const leftEmpty = row.leftLine === null;
-              const rightEmpty = row.rightLine === null;
-
-              return (
-                <tr key={idx} className="diff-row">
-                  {/* Left line number */}
-                  <td className={`diff-line-num ${leftBg}`}>
-                    {row.leftNum ?? ""}
-                  </td>
-                  {/* Left content */}
-                  <td className={`diff-line-content ${leftBg}${leftEmpty ? " diff-line-empty" : ""}`}>
-                    {row.leftLine ?? ""}
-                  </td>
-                  {/* Right line number */}
-                  <td className={`diff-line-num ${rightBg}`}>
-                    {row.rightNum ?? ""}
-                  </td>
-                  {/* Right content */}
-                  <td className={`diff-line-content ${rightBg}${rightEmpty ? " diff-line-empty" : ""}`}>
-                    {row.rightLine ?? ""}
-                  </td>
-                </tr>
-              );
-            })}
-          </tbody>
-        </table>
-      </div>
-    </div>
-  );
-}
-
-/* ────────────────────────────────────────────
- * RevisionList sub-component
- * ──────────────────────────────────────────── */
-
-function RevisionList({
-  entries,
-  onSelectDiff,
-}: {
-  entries: DocHistoryEntry[];
-  onSelectDiff: (selection: DiffSelection) => void;
-}) {
-  const [selectedA, setSelectedA] = useState<number>(1); // older (default: second entry)
-  const [selectedB, setSelectedB] = useState<number>(0); // newer (default: first entry)
-
-  if (entries.length === 0) {
-    return (
-      <div className="px-hsp-lg py-vsp-lg text-muted text-small">
-        No revision history available.
-      </div>
-    );
-  }
-
-  const canCompare =
-    selectedA !== selectedB &&
-    selectedA >= 0 &&
-    selectedB >= 0 &&
-    selectedA < entries.length &&
-    selectedB < entries.length;
-
-  function handleCompare() {
-    if (!canCompare) return;
-    const idxOlder = Math.max(selectedA, selectedB);
-    const idxNewer = Math.min(selectedA, selectedB);
-    onSelectDiff({
-      older: entries[idxOlder],
-      newer: entries[idxNewer],
-    });
-  }
-
-  return (
-    <div className="flex flex-col h-full">
-      {/* Compare bar */}
-      {entries.length >= 2 && (
-        <div className="px-hsp-lg py-vsp-xs border-b border-muted flex items-center gap-hsp-sm">
-          <button
-            type="button"
-            disabled={!canCompare}
-            onClick={handleCompare}
-            className={
-              canCompare
-                ? "px-hsp-md py-vsp-2xs text-small rounded bg-accent text-bg hover:bg-accent-hover"
-                : "px-hsp-md py-vsp-2xs text-small rounded bg-surface text-muted cursor-not-allowed"
-            }
-          >
-            Compare
-          </button>
-          <span className="text-caption text-muted">
-            Select two revisions (A / B)
-          </span>
-        </div>
-      )}
-
-      {/* Revision entries */}
-      <div className="flex-1 overflow-auto">
-        {entries.map((entry, idx) => {
-          const isA = selectedA === idx;
-          const isB = selectedB === idx;
-          const dateStr = formatDate(entry.date);
-
-          return (
-            <div
-              key={entry.hash}
-              className={
-                isA || isB
-                  ? "px-hsp-lg py-vsp-xs border-b border-muted bg-surface"
-                  : "px-hsp-lg py-vsp-xs border-b border-muted hover:bg-surface"
-              }
-            >
-              <div className="flex items-start gap-hsp-sm">
-                {/* Selection badges */}
-                {entries.length >= 2 && (
-                  <div className="flex flex-col gap-vsp-2xs pt-[2px] shrink-0">
-                    <button
-                      type="button"
-                      onClick={() => setSelectedA(idx)}
-                      className={
-                        isA
-                          ? "w-[1.5rem] h-[1.25rem] text-caption rounded flex items-center justify-center bg-accent text-bg"
-                          : "w-[1.5rem] h-[1.25rem] text-caption rounded flex items-center justify-center border border-muted text-muted hover:border-fg hover:text-fg"
-                      }
-                      aria-label={`Select revision ${entry.hash.slice(0, 7)} as A`}
-                    >
-                      A
-                    </button>
-                    <button
-                      type="button"
-                      onClick={() => setSelectedB(idx)}
-                      className={
-                        isB
-                          ? "w-[1.5rem] h-[1.25rem] text-caption rounded flex items-center justify-center bg-accent text-bg"
-                          : "w-[1.5rem] h-[1.25rem] text-caption rounded flex items-center justify-center border border-muted text-muted hover:border-fg hover:text-fg"
-                      }
-                      aria-label={`Select revision ${entry.hash.slice(0, 7)} as B`}
-                    >
-                      B
-                    </button>
-                  </div>
-                )}
-
-                {/* Revision info */}
-                <div className="min-w-0 flex-1">
-                  <div className="flex items-baseline gap-hsp-sm">
-                    <code className="text-caption text-accent font-mono">
-                      {entry.hash.slice(0, 7)}
-                    </code>
-                    <span className="text-caption text-muted">{dateStr}</span>
-                  </div>
-                  <div className="text-small text-fg mt-vsp-2xs truncate">
-                    <SmartBreak>{entry.message}</SmartBreak>
-                  </div>
-                  <div className="text-caption text-muted">{entry.author}</div>
-                </div>
-              </div>
-            </div>
-          );
-        })}
-      </div>
-    </div>
-  );
-}
-
-/* ────────────────────────────────────────────
- * Date formatter
- * ──────────────────────────────────────────── */
-
-function formatDate(dateStr: string): string {
-  const d = new Date(dateStr);
-  if (isNaN(d.getTime())) return dateStr;
-  return d.toLocaleDateString(undefined, {
-    year: "numeric",
-    month: "short",
-    day: "numeric",
-  });
-}
-
-/* ────────────────────────────────────────────
- * Main DocHistory component
- * ──────────────────────────────────────────── */
-
-export function DocHistory({ slug, locale, basePath = "/" }: DocHistoryProps) {
-  const [view, setView] = useState<PanelView>("closed");
-  const [data, setData] = useState<DocHistoryData | null>(null);
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-  const [diffSelection, setDiffSelection] = useState<DiffSelection | null>(
-    null,
-  );
-
-  const base = basePath.replace(/\/+$/, "");
-  // Doc-history storage sentinel ("" -> "index"): a root index page has the
-  // canonical route slug "" (-> /docs/), but the per-page JSON is stored/served
-  // under "index" because an empty path segment is unroutable (the server regex
-  // /^\/doc-history\/(.+)\.json$/ rejects ""). Map "" back to "index" so the
-  // fetch path is well-formed.
-  const historySlug = slug === "" ? "index" : slug;
-  const fetchPath = locale
-    ? `${base}/doc-history/${locale}/${historySlug}.json`
-    : `${base}/doc-history/${historySlug}.json`;
-
-  const fetchHistory = useCallback(async () => {
-    if (data) return; // already loaded
-    setLoading(true);
-    setError(null);
-    try {
-      const res = await fetch(fetchPath);
-      if (!res.ok) {
-        throw new Error(`Failed to load history (${res.status})`);
-      }
-      const json: DocHistoryData = await res.json();
-      setData(json);
-    } catch (e) {
-      setError(e instanceof Error ? e.message : "Failed to load history");
-    } finally {
-      setLoading(false);
-    }
-  }, [data, fetchPath]);
-
-  function handleOpen() {
-    setView("revisions");
-    fetchHistory();
-  }
-
-  const handleClose = useCallback(() => {
-    setView("closed");
-    setDiffSelection(null);
-  }, []);
-
-  function handleSelectDiff(selection: DiffSelection) {
-    setDiffSelection(selection);
-    setView("diff");
-  }
-
-  function handleBackToRevisions() {
-    setDiffSelection(null);
-    setView("revisions");
-  }
-
-  // Lock body scroll when panel is open
-  useEffect(() => {
-    if (view !== "closed") {
-      document.body.style.overflow = "hidden";
-    } else {
-      document.body.style.overflow = "";
-    }
-    return () => {
-      document.body.style.overflow = "";
-    };
-  }, [view]);
-
-  // Close on Escape key
-  useEffect(() => {
-    if (view === "closed") return;
-    function handleKeyDown(e: KeyboardEvent) {
-      if (e.key === "Escape") handleClose();
-    }
-    document.addEventListener("keydown", handleKeyDown);
-    return () => document.removeEventListener("keydown", handleKeyDown);
-  }, [view, handleClose]);
-
-  // Close on View Transition navigation
-  useEffect(() => {
-    document.addEventListener("DOMContentLoaded", handleClose);
-    return () => document.removeEventListener("DOMContentLoaded", handleClose);
-  }, [handleClose]);
-
-  const isOpen = view !== "closed";
-  const hasDiff = view === "diff" && diffSelection;
-
-  const dialogRef = useRef<HTMLDialogElement>(null);
-
-  // Sync dialog open/close with React state
-  useEffect(() => {
-    const dialog = dialogRef.current;
-    if (!dialog) return;
-    if (isOpen && !dialog.open) {
-      dialog.showModal();
-    } else if (!isOpen && dialog.open) {
-      dialog.close();
-    }
-  }, [isOpen]);
-
-  // Close React state when dialog is closed natively (Escape key)
-  useEffect(() => {
-    const dialog = dialogRef.current;
-    if (!dialog) return;
-    function onClose() {
-      if (isOpen) handleClose();
-    }
-    dialog.addEventListener("close", onClose);
-    return () => dialog.removeEventListener("close", onClose);
-  }, [isOpen, handleClose]);
-
-  return (
-    <>
-      {/* History button */}
-      {!isOpen && (
-        <div className="flex justify-end mt-vsp-xl">
-          <button
-            type="button"
-            onClick={handleOpen}
-            className="doc-history-trigger flex items-center gap-hsp-xs px-hsp-md py-vsp-xs rounded-lg bg-surface border border-muted text-muted hover:text-fg hover:border-fg transition-colors"
-            aria-label="View document history"
-          >
-            <HistoryIcon />
-            <span className="text-small">History</span>
-          </button>
-        </div>
-      )}
-
-      {/* Full-screen dialog — renders in top layer, above all stacking contexts */}
-      {/* z-modal / backdrop:z-modal-backdrop are defense-in-depth for the
-          SPA-swap window: clicking a history entry link swaps the page body
-          while this dialog is still open, and a native showModal() dialog can
-          momentarily lose top-layer promotion and fall back to z-index:auto,
-          flashing behind the header/sidebar. The explicit modal-tier z-index
-          keeps it above all chrome during that window. Intentionally redundant
-          in the normal (top-layer) case — do not remove as "redundant". */}
-      <dialog
-        ref={dialogRef}
-        aria-label="Document revision history"
-        className="doc-history-panel z-modal fixed inset-0 m-0 h-full w-full max-h-full max-w-full bg-bg border-none p-0 backdrop:z-modal-backdrop backdrop:bg-bg/30"
-        style={{ color: "var(--color-fg)" }}
-      >
-        {/* Panel header */}
-        <div className="flex items-center justify-between px-hsp-lg py-vsp-xs border-b border-muted">
-          <h2 className="text-body font-semibold text-fg">
-            {view === "diff" ? "Diff" : "Revision History"}
-          </h2>
-          <button
-            type="button"
-            onClick={handleClose}
-            className="text-muted hover:text-fg"
-            aria-label="Close history panel"
-          >
-            <CloseIcon />
-          </button>
-        </div>
-
-        {/* Panel body */}
-        <div className="h-[calc(100%-3rem)] overflow-hidden">
-          {loading && <Spinner />}
-
-          {error && (
-            <div className="px-hsp-lg py-vsp-lg text-danger text-small">
-              {error}
-            </div>
-          )}
-
-          {/* Difit-style LR split: revision sidebar | diff area */}
-          {!loading && !error && data && (
-            <div className="flex h-full">
-              {/* Left sidebar: revision list — always visible on lg */}
-              <div
-                className={
-                  hasDiff
-                    ? "hidden lg:flex lg:flex-col lg:w-[clamp(16rem,25%,22rem)] shrink-0 border-r border-muted h-full"
-                    : "flex flex-col w-full h-full"
-                }
-              >
-                <RevisionList
-                  entries={data.entries}
-                  onSelectDiff={handleSelectDiff}
-                />
-              </div>
-
-              {/* Right: diff viewer (on mobile, replaces the sidebar) */}
-              {hasDiff && (
-                <div className="flex-1 min-w-0 h-full">
-                  {/* Key on the compared pair forces a fresh mount whenever the
-                      selection changes, so the previous pair's diff rows can
-                      never render under the new header hashes while the lazy
-                      import("diff") recompute is in flight (#2068). */}
-                  <DiffViewer
-                    key={`${diffSelection.older.hash}:${diffSelection.newer.hash}`}
-                    selection={diffSelection}
-                    onBack={handleBackToRevisions}
-                    showBackButton={true}
-                  />
-                </div>
-              )}
-            </div>
-          )}
-        </div>
-      </dialog>
-    </>
-  );
-}
+// Re-export stub for the DocHistory island.
+//
+// The real component now ships in the package at
+// @takazudo/zudo-doc/doc-history (epic #2344, S4).
+// pages/lib/_doc-history-area.tsx imports directly from there, so this
+// file is only kept as a stable re-export in case any project-local code
+// references the @/components/doc-history path.
+export { DocHistory } from "@takazudo/zudo-doc/doc-history";

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

@@ -1,23 +1,7 @@
-/** A single git revision entry for a document */
-export interface DocHistoryEntry {
-  /** Full commit hash (use .slice(0, 7) for display) */
-  hash: string;
-  /** ISO 8601 date string */
-  date: string;
-  /** Commit author name */
-  author: string;
-  /** First line of commit message */
-  message: string;
-  /** Full file content at this revision */
-  content: string;
-}
-
-/** Complete history data for a single document */
-export interface DocHistoryData {
-  /** Document slug (route path) */
-  slug: string;
-  /** Relative file path in the repository */
-  filePath: string;
-  /** Git revision entries, newest first */
-  entries: DocHistoryEntry[];
-}
+// 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";