npm - @peaske7/readit - Versions diffs - 0.1.8 → 0.2.1 - Mend

@peaske7/readit 0.1.8 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (221) hide show

package/.claude/CLAUDE.md +118 -76
package/.claude/commands/review.md +1 -1
package/.claude/roadmap.md +32 -9
package/.claude/user-stories.md +100 -15
package/AGENTS.md +30 -26
package/Makefile +32 -0
package/README.md +90 -5
package/biome.json +18 -8
package/bun.lock +426 -710
package/bunfig.toml +2 -0
package/docs/perf-baseline.md +130 -0
package/docs/superpowers/plans/2026-03-26-surgical-pruning.md +1176 -0
package/docs/superpowers/specs/2026-03-27-go-server-rewrite-design.md +284 -0
package/e2e/comments.spec.ts +14 -58
package/e2e/document-load.spec.ts +1 -23
package/e2e/export.spec.ts +4 -4
package/e2e/perf/add-comment.spec.ts +116 -0
package/e2e/perf/fixtures/generate.ts +327 -0
package/e2e/perf/initial-load.spec.ts +49 -0
package/e2e/perf/perf.setup.ts +23 -0
package/e2e/perf/perf.teardown.ts +9 -0
package/e2e/perf/screenshot-final.png +0 -0
package/e2e/perf/scroll.spec.ts +39 -0
package/e2e/perf/tab-switch.spec.ts +69 -0
package/e2e/perf/text-selection.spec.ts +119 -0
package/e2e/perf/utils/metrics.ts +350 -0
package/e2e/perf/utils/perf-cli.ts +86 -0
package/e2e/persistence-file.spec.ts +41 -26
package/e2e/utils/selection.ts +17 -73
package/go/cmd/readit/main.go +416 -0
package/go/go.mod +20 -0
package/go/go.sum +41 -0
package/go/internal/server/anchor.go +302 -0
package/go/internal/server/anchor_test.go +111 -0
package/go/internal/server/comments.go +390 -0
package/go/internal/server/documents.go +113 -0
package/go/internal/server/embed.go +17 -0
package/go/internal/server/headings.go +33 -0
package/go/internal/server/headings_test.go +75 -0
package/go/internal/server/htmltext.go +123 -0
package/go/internal/server/markdown.go +157 -0
package/go/internal/server/markdown_bench_test.go +42 -0
package/go/internal/server/markdown_test.go +79 -0
package/go/internal/server/server.go +453 -0
package/go/internal/server/server_bench_test.go +122 -0
package/go/internal/server/settings.go +110 -0
package/go/internal/server/sse.go +140 -0
package/go/internal/server/storage.go +275 -0
package/go/internal/server/storage_test.go +118 -0
package/go/internal/server/template.go +66 -0
package/go/internal/server/types.go +101 -0
package/go/internal/server/watcher.go +74 -0
package/index.html +4 -14
package/nvim-readit/lua/readit/health.lua +64 -0
package/nvim-readit/lua/readit/init.lua +463 -0
package/nvim-readit/plugin/readit.lua +19 -0
package/package.json +24 -41
package/playwright.config.ts +12 -0
package/shell/_readit +158 -0
package/shell/readit.zsh +87 -0
package/src/App.svelte +881 -0
package/src/{cli/index.ts → cli.ts} +216 -70
package/src/components/ActionsMenu.svelte +95 -0
package/src/components/CommentBadge.svelte +67 -0
package/src/components/CommentErrorBanner.svelte +33 -0
package/src/components/CommentInput.svelte +75 -0
package/src/components/CommentListItem.svelte +95 -0
package/src/components/CommentManager.svelte +129 -0
package/src/components/CommentNav.svelte +109 -0
package/src/components/DocumentViewer.svelte +218 -0
package/src/components/FloatingComment.svelte +107 -0
package/src/components/Header.svelte +76 -0
package/src/components/InlineEditor.svelte +72 -0
package/src/components/MarginNote.svelte +167 -0
package/src/components/MarginNotesContainer.svelte +33 -0
package/src/components/RawModal.svelte +126 -0
package/src/components/ReanchorConfirm.svelte +30 -0
package/src/components/SettingsModal.svelte +220 -0
package/src/components/ShortcutCapture.svelte +82 -0
package/src/components/ShortcutList.svelte +145 -0
package/src/components/TabBar.svelte +52 -0
package/src/components/TableOfContents.svelte +125 -0
package/src/components/ui/ActionLink.svelte +40 -0
package/src/components/ui/Button.svelte +53 -0
package/src/components/ui/Dialog.svelte +97 -0
package/src/components/ui/DropdownMenu.svelte +85 -0
package/src/components/ui/DropdownMenuItem.svelte +38 -0
package/src/components/ui/DropdownMenuSeparator.svelte +11 -0
package/src/components/ui/Text.svelte +42 -0
package/src/env.d.ts +6 -0
package/src/index.css +36 -166
package/src/lib/__fixtures__/bench-data.ts +1 -54
package/src/lib/anchor.bench.ts +47 -68
package/src/lib/anchor.test.ts +5 -9
package/src/lib/anchor.ts +9 -93
package/src/lib/comment-storage.bench.ts +6 -20
package/src/lib/comment-storage.test.ts +45 -37
package/src/lib/comment-storage.ts +23 -64
package/src/lib/export.bench.ts +9 -23
package/src/lib/export.ts +7 -14
package/src/lib/headings.test.ts +103 -0
package/src/lib/headings.ts +44 -0
package/src/lib/highlight/core.test.ts +1 -6
package/src/lib/highlight/dom.ts +53 -280
package/src/lib/highlight/highlight-registry.ts +221 -0
package/src/lib/highlight/highlight.bench.ts +92 -0
package/src/lib/highlight/highlighter.ts +122 -302
package/src/lib/highlight/{core.ts → resolver.ts} +3 -19
package/src/lib/highlight/types.ts +0 -40
package/src/lib/html-text.test.ts +162 -0
package/src/lib/html-text.ts +161 -0
package/src/lib/i18n/en.ts +13 -36
package/src/lib/i18n/ja.ts +14 -37
package/src/lib/i18n/types.ts +13 -36
package/src/lib/margin-layout.bench.ts +48 -15
package/src/lib/margin-layout.ts +2 -31
package/src/lib/markdown-renderer.test.ts +154 -0
package/src/lib/markdown-renderer.ts +177 -0
package/src/lib/mermaid-config.ts +38 -0
package/src/lib/mermaid-renderer.ts +162 -0
package/src/lib/mermaid-worker.ts +60 -0
package/src/lib/positions.ts +157 -0
package/src/lib/shortcut-registry.ts +138 -103
package/src/lib/utils.ts +2 -48
package/src/main.ts +16 -0
package/src/schema.ts +92 -0
package/src/{server/index.ts → server.ts} +427 -163
package/src/stores/app.svelte.ts +231 -0
package/src/stores/locale.svelte.ts +46 -0
package/src/stores/settings.svelte.ts +90 -0
package/src/stores/shortcuts.svelte.ts +104 -0
package/src/stores/ui.svelte.ts +12 -0
package/src/template.ts +104 -0
package/src/test-setup.ts +47 -0
package/svelte.config.js +5 -0
package/tsconfig.json +2 -2
package/vite.config.ts +31 -3
package/vscode-readit/.mcp.json +7 -0
package/vscode-readit/.vscodeignore +7 -0
package/vscode-readit/bun.lock +78 -0
package/vscode-readit/icon.svg +10 -0
package/vscode-readit/package.json +110 -0
package/vscode-readit/src/extension.ts +117 -0
package/vscode-readit/src/server-manager.ts +272 -0
package/vscode-readit/src/webview-provider.ts +204 -0
package/vscode-readit/tsconfig.json +20 -0
package/e2e/fixtures/sample.html +0 -13
package/src/App.tsx +0 -416
package/src/components/ActionsMenu.tsx +0 -112
package/src/components/DocumentViewer/CodeBlock.tsx +0 -160
package/src/components/DocumentViewer/DocumentViewer.tsx +0 -259
package/src/components/DocumentViewer/IframeContainer.tsx +0 -251
package/src/components/DocumentViewer/InlineCode.tsx +0 -60
package/src/components/DocumentViewer/MermaidDiagram.tsx +0 -137
package/src/components/DocumentViewer/index.ts +0 -1
package/src/components/FloatingTOC.tsx +0 -61
package/src/components/Header.tsx +0 -65
package/src/components/InlineEditor.tsx +0 -74
package/src/components/MarginNote.tsx +0 -207
package/src/components/MarginNotes.tsx +0 -50
package/src/components/RawModal.tsx +0 -143
package/src/components/ReanchorConfirm.tsx +0 -36
package/src/components/SettingsModal.tsx +0 -310
package/src/components/ShortcutCapture.tsx +0 -48
package/src/components/ShortcutList.tsx +0 -198
package/src/components/TabBar.tsx +0 -60
package/src/components/TableOfContents.tsx +0 -108
package/src/components/comments/CommentBadge.tsx +0 -49
package/src/components/comments/CommentInput.tsx +0 -114
package/src/components/comments/CommentListItem.tsx +0 -92
package/src/components/comments/CommentManager.tsx +0 -113
package/src/components/comments/CommentMinimap.tsx +0 -62
package/src/components/comments/CommentNav.tsx +0 -109
package/src/components/ui/ActionBar.tsx +0 -16
package/src/components/ui/ActionLink.tsx +0 -32
package/src/components/ui/Button.tsx +0 -55
package/src/components/ui/Dialog.tsx +0 -156
package/src/components/ui/DropdownMenu.tsx +0 -114
package/src/components/ui/SeparatorDot.tsx +0 -9
package/src/components/ui/Text.tsx +0 -54
package/src/contexts/CommentContext.tsx +0 -229
package/src/contexts/LayoutContext.tsx +0 -88
package/src/contexts/LocaleContext.tsx +0 -35
package/src/hooks/useClickOutside.ts +0 -35
package/src/hooks/useClipboard.ts +0 -82
package/src/hooks/useCommentNavigation.ts +0 -130
package/src/hooks/useComments.ts +0 -323
package/src/hooks/useDocument.ts +0 -156
package/src/hooks/useEditorScheme.ts +0 -51
package/src/hooks/useFontPreference.ts +0 -59
package/src/hooks/useHeadings.test.ts +0 -159
package/src/hooks/useHeadings.ts +0 -129
package/src/hooks/useKeybindings.ts +0 -108
package/src/hooks/useKeyboardShortcuts.ts +0 -63
package/src/hooks/useLayoutMode.ts +0 -44
package/src/hooks/useLocalePreference.ts +0 -42
package/src/hooks/useReanchorMode.ts +0 -33
package/src/hooks/useScrollMetrics.ts +0 -56
package/src/hooks/useScrollSpy.ts +0 -81
package/src/hooks/useTextSelection.ts +0 -123
package/src/hooks/useThemePreference.ts +0 -66
package/src/lib/context.bench.ts +0 -41
package/src/lib/context.test.ts +0 -224
package/src/lib/context.ts +0 -193
package/src/lib/editor-links.ts +0 -59
package/src/lib/highlight/colors.ts +0 -37
package/src/lib/highlight/index.ts +0 -23
package/src/lib/highlight/script-builder.ts +0 -485
package/src/lib/html-processor.test.tsx +0 -170
package/src/lib/html-processor.tsx +0 -95
package/src/lib/i18n/completeness.test.ts +0 -51
package/src/lib/i18n/translations.test.ts +0 -39
package/src/lib/layout-constants.ts +0 -12
package/src/lib/scroll.test.ts +0 -118
package/src/lib/scroll.ts +0 -47
package/src/lib/shortcut-registry.test.ts +0 -173
package/src/lib/utils.test.ts +0 -110
package/src/main.tsx +0 -13
package/src/store/index.test.ts +0 -242
package/src/store/index.ts +0 -254
package/src/types/index.ts +0 -127

package/vscode-readit/src/webview-provider.ts ADDED Viewed

@@ -0,0 +1,204 @@
+import * as path from "node:path";
+import * as vscode from "vscode";
+import type { ServerManager } from "./server-manager";
+/**
+ * Manages readit webview panels.
+ *
+ * Each panel contains an iframe pointing at the readit server on 127.0.0.1.
+ * This preserves the full interactive experience: SSE live-reload, comment
+ * CRUD, keyboard shortcuts, and all Svelte reactivity — without duplicating
+ * any rendering logic.
+ */
+export class ReaditWebviewProvider implements vscode.Disposable {
+  private panels = new Map<string, vscode.WebviewPanel>();
+  private disposables: vscode.Disposable[] = [];
+  constructor(
+    private readonly extensionUri: vscode.Uri,
+    private readonly serverManager: ServerManager,
+    private readonly outputChannel: vscode.OutputChannel,
+  ) {}
+  /**
+   * Opens (or reveals) a readit preview panel for the given file.
+   * @param filePath Absolute path to the markdown file.
+   * @param readitDistDir Absolute path to the readit dist/ directory.
+   * @param column Which editor column to open the panel in.
+   */
+  async openPreview(
+    filePath: string,
+    readitDistDir: string,
+    column: vscode.ViewColumn = vscode.ViewColumn.Active,
+  ): Promise<void> {
+    // If a panel for this file already exists, reveal it
+    const existing = this.panels.get(filePath);
+    if (existing) {
+      existing.reveal(column);
+      return;
+    }
+    // Ensure the server is running with this file loaded
+    let port: number;
+    try {
+      port = await this.serverManager.ensureRunning(filePath, readitDistDir);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      vscode.window.showErrorMessage(`readit: ${message}`);
+      return;
+    }
+    const fileName = path.basename(filePath);
+    const panel = vscode.window.createWebviewPanel(
+      "readitPreview",
+      `readit: ${fileName}`,
+      column,
+      {
+        enableScripts: true,
+        retainContextWhenHidden: true,
+        localResourceRoots: [this.extensionUri],
+        // Allow the webview to access the local readit server
+        portMapping: [
+          {
+            webviewPort: port,
+            extensionHostPort: port,
+          },
+        ],
+      },
+    );
+    panel.iconPath = vscode.Uri.joinPath(this.extensionUri, "icon.svg");
+    panel.webview.html = this.getWebviewContent(port, filePath, panel.webview);
+    this.panels.set(filePath, panel);
+    // Clean up when the panel is closed
+    panel.onDidDispose(
+      () => {
+        this.panels.delete(filePath);
+        // If no panels remain, stop the server
+        if (this.panels.size === 0) {
+          this.outputChannel.appendLine("Last panel closed, stopping server.");
+          this.serverManager.stop();
+        }
+      },
+      null,
+      this.disposables,
+    );
+  }
+  /**
+   * Generates the HTML content for the webview.
+   * Uses an iframe pointing at the local readit server so the full Svelte app
+   * runs unmodified — SSE, comments, settings, and all.
+   */
+  private getWebviewContent(
+    port: number,
+    _filePath: string,
+    webview: vscode.Webview,
+  ): string {
+    const serverUrl = `http://127.0.0.1:${port}`;
+    const nonce = getNonce();
+    // The CSP allows framing the local readit server and running inline scripts
+    // with a nonce. The iframe approach means all readit functionality works
+    // without any modification to the Svelte frontend.
+    const csp = [
+      `default-src 'none'`,
+      `frame-src http://127.0.0.1:${port}`,
+      `style-src 'unsafe-inline'`,
+      `script-src 'nonce-${nonce}'`,
+    ].join("; ");
+    // Use the VS Code webview API to properly resolve the resource
+    void webview;
+    return /* html */ `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <meta http-equiv="Content-Security-Policy" content="${csp}" />
+  <title>readit</title>
+  <style>
+    html, body {
+      margin: 0;
+      padding: 0;
+      width: 100%;
+      height: 100%;
+      overflow: hidden;
+      background: var(--vscode-editor-background, #1e1e1e);
+    }
+    iframe {
+      border: none;
+      width: 100%;
+      height: 100%;
+    }
+    .loading {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      width: 100%;
+      height: 100%;
+      color: var(--vscode-foreground, #ccc);
+      font-family: var(--vscode-font-family, sans-serif);
+      font-size: 14px;
+    }
+    .loading.hidden {
+      display: none;
+    }
+  </style>
+</head>
+<body>
+  <div id="loading" class="loading">Starting readit server...</div>
+  <iframe
+    id="readit-frame"
+    src="${serverUrl}"
+    sandbox="allow-scripts allow-same-origin allow-forms allow-popups"
+    style="display: none;"
+  ></iframe>
+  <script nonce="${nonce}">
+    const iframe = document.getElementById('readit-frame');
+    const loading = document.getElementById('loading');
+    iframe.addEventListener('load', () => {
+      loading.classList.add('hidden');
+      iframe.style.display = 'block';
+    });
+    // Show iframe after a max timeout even if load event doesn't fire
+    setTimeout(() => {
+      loading.classList.add('hidden');
+      iframe.style.display = 'block';
+    }, 10000);
+  </script>
+</body>
+</html>`;
+  }
+  /** Closes all open panels. */
+  closeAll(): void {
+    for (const panel of this.panels.values()) {
+      panel.dispose();
+    }
+    this.panels.clear();
+  }
+  dispose(): void {
+    this.closeAll();
+    for (const d of this.disposables) {
+      d.dispose();
+    }
+    this.disposables = [];
+  }
+}
+/** Generate a random nonce for CSP inline script tags. */
+function getNonce(): string {
+  const chars =
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  let result = "";
+  for (let i = 0; i < 32; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length));
+  }
+  return result;
+}

package/vscode-readit/tsconfig.json ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "types": ["node"],
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "rootDir": "src",
+    "noUnusedLocals": true,
+    "noUnusedParameters": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/e2e/fixtures/sample.html DELETED Viewed

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <title>Test Document</title>
-</head>
-<body>
-  <h1>Test Document</h1>
-  <p>This is a paragraph for testing text selection.</p>
-  <h2>Second Section</h2>
-  <p>Here is another paragraph with some more text to select and comment on.</p>
-</body>
-</html>

package/src/App.tsx DELETED Viewed

@@ -1,416 +0,0 @@
-import { use, useCallback, useEffect, useRef } from "react";
-import { Toaster } from "sonner";
-import { CommentInput } from "./components/comments/CommentInput";
-import { CommentMinimap } from "./components/comments/CommentMinimap";
-import { CommentNav } from "./components/comments/CommentNav";
-import { DocumentViewer } from "./components/DocumentViewer";
-import { FloatingTOC } from "./components/FloatingTOC";
-import { Header } from "./components/Header";
-import { MarginNotes } from "./components/MarginNotes";
-import { ReanchorConfirm } from "./components/ReanchorConfirm";
-import { TabBar } from "./components/TabBar";
-import { TableOfContents } from "./components/TableOfContents";
-import { textVariants } from "./components/ui/Text";
-import { CommentContext, CommentProvider } from "./contexts/CommentContext";
-import { LayoutContext, LayoutProvider } from "./contexts/LayoutContext";
-import { useLocale } from "./contexts/LocaleContext";
-import { useClipboard } from "./hooks/useClipboard";
-import { useDocument } from "./hooks/useDocument";
-import { useHeadings } from "./hooks/useHeadings";
-import { useKeyboardShortcuts } from "./hooks/useKeyboardShortcuts";
-import { useScrollMetrics } from "./hooks/useScrollMetrics";
-import { useScrollSpy } from "./hooks/useScrollSpy";
-import { useTextSelection } from "./hooks/useTextSelection";
-import { calculateScrollTarget, getElementTopInDocument } from "./lib/scroll";
-import { ShortcutActions } from "./lib/shortcut-registry";
-import { cn } from "./lib/utils";
-import { appStore, useAppStore } from "./store";
-const TOASTER_ICONS = { success: null, error: null, info: null, warning: null };
-const TOASTER_OPTIONS = {
-  unstyled: true,
-  duration: 2000,
-  classNames: {
-    toast: cn(
-      "backdrop-blur-sm bg-white/90 dark:bg-zinc-900/90 border border-zinc-100 dark:border-zinc-800 px-3 py-2 shadow-sm rounded-md",
-      textVariants({ variant: "caption" }),
-    ),
-  },
-};
-interface AppContentProps {
-  document: NonNullable<ReturnType<typeof useDocument>["document"]>;
-  reload: ReturnType<typeof useDocument>["reload"];
-}
-function AppContent({ document, reload }: AppContentProps) {
-  const { t } = useLocale();
-  const {
-    comments,
-    sortedComments,
-    addComment,
-    reanchorComment,
-    reanchorTarget,
-    cancelReanchor,
-    hoveredCommentId,
-    setHoveredCommentId,
-    navigatePrevious,
-    navigateNext,
-  } = use(CommentContext)!;
-  const {
-    selection,
-    highlightPositions,
-    documentPositions,
-    pendingSelectionTop,
-    onTextSelect,
-    onPositionsChange,
-    clearSelection,
-  } = useTextSelection();
-  const {
-    copyAll,
-    copyAllRaw,
-    exportJson,
-    copySelectionRaw,
-    copySelectionForLLM,
-  } = useClipboard({
-    comments,
-    document: document ?? undefined,
-    selection: selection ?? undefined,
-    clearSelection,
-    t,
-  });
-  const { shortcuts, isFullscreen } = use(LayoutContext)!;
-  useKeyboardShortcuts(shortcuts, {
-    [ShortcutActions.COPY_ALL]: copyAll,
-    [ShortcutActions.COPY_ALL_RAW]: copyAllRaw,
-    [ShortcutActions.NAVIGATE_NEXT]: navigateNext,
-    [ShortcutActions.NAVIGATE_PREVIOUS]: navigatePrevious,
-    [ShortcutActions.COPY_SELECTION_RAW]: copySelectionRaw,
-    [ShortcutActions.COPY_SELECTION_LLM]: copySelectionForLLM,
-    [ShortcutActions.CLEAR_SELECTION]: clearSelection,
-  });
-  const scrollMetrics = useScrollMetrics();
-  const headings = useHeadings(
-    document?.content ?? null,
-    document?.type ?? null,
-  );
-  const activeHeadingId = useScrollSpy(headings.map((h) => h.id));
-  const scrollToHeading = useCallback(
-    (id: string) => {
-      let elementRect: DOMRect | undefined;
-      let iframeTopOffset: number | undefined;
-      if (document?.type === "html") {
-        const iframe = window.document.querySelector("iframe");
-        const el = iframe?.contentDocument?.getElementById(id);
-        if (!el || !iframe) return;
-        elementRect = el.getBoundingClientRect();
-        iframeTopOffset = iframe.getBoundingClientRect().top;
-      } else {
-        elementRect = window.document
-          .getElementById(id)
-          ?.getBoundingClientRect();
-      }
-      if (!elementRect) return;
-      const elementTop = getElementTopInDocument({
-        elementRect,
-        scrollY: window.scrollY,
-        iframeTopOffset,
-      });
-      const scrollTarget = calculateScrollTarget({
-        elementTop,
-        viewportHeight: window.innerHeight,
-      });
-      window.scrollTo({ top: scrollTarget, behavior: "smooth" });
-    },
-    [document?.type],
-  );
-  const handleHighlightClick = useCallback((commentId: string) => {
-    const marginNote = window.document.querySelector(
-      `article[data-comment-id="${commentId}"]`,
-    );
-    if (marginNote) {
-      marginNote.scrollIntoView({ behavior: "smooth", block: "center" });
-    }
-  }, []);
-  // Scroll save/restore for tab switching
-  const setScrollY = useAppStore((s) => s.setScrollY);
-  const savedScrollY = useAppStore(
-    (s) => s.getActiveDocumentState()?.scrollY ?? 0,
-  );
-  const scrollRestored = useRef(false);
-  // Save scroll position on unmount
-  useEffect(() => {
-    return () => {
-      setScrollY(window.scrollY);
-    };
-  }, [setScrollY]);
-  // Restore scroll position on mount (after highlights paint)
-  useEffect(() => {
-    if (savedScrollY === 0 || scrollRestored.current) return;
-    scrollRestored.current = true;
-    requestAnimationFrame(() => {
-      requestAnimationFrame(() => {
-        window.scrollTo(0, savedScrollY);
-      });
-    });
-  }, [savedScrollY]);
-  const handleAddComment = useCallback(
-    (commentText: string) => {
-      if (!selection) return;
-      addComment(
-        selection.text,
-        commentText,
-        selection.startOffset,
-        selection.endOffset,
-      );
-      clearSelection();
-    },
-    [selection, addComment, clearSelection],
-  );
-  const handleConfirmReanchor = useCallback(() => {
-    if (!selection || !reanchorTarget) return;
-    reanchorComment(
-      reanchorTarget.commentId,
-      selection.text,
-      selection.startOffset,
-      selection.endOffset,
-    );
-    cancelReanchor();
-    clearSelection();
-  }, [
-    selection,
-    reanchorTarget,
-    reanchorComment,
-    cancelReanchor,
-    clearSelection,
-  ]);
-  const handleCancelReanchor = useCallback(() => {
-    cancelReanchor();
-    clearSelection();
-  }, [cancelReanchor, clearSelection]);
-  if (!document) return null;
-  return (
-    <div className="min-h-screen bg-white dark:bg-zinc-900 text-zinc-900 dark:text-zinc-100 flex flex-col">
-      <Toaster
-        position="bottom-right"
-        icons={TOASTER_ICONS}
-        toastOptions={TOASTER_OPTIONS}
-      />
-      <Header
-        fileName={document.fileName}
-        onCopyAll={copyAll}
-        onCopyAllRaw={copyAllRaw}
-        onExportJson={exportJson}
-        onReload={reload}
-      />
-      <div
-        className={`flex-1 flex gap-4 w-full ${!isFullscreen ? "max-w-7xl mx-auto" : ""} ${hoveredCommentId ? "has-comment-focus" : ""}`}
-      >
-        {!isFullscreen && headings.length > 0 && (
-          <aside className="w-48 flex-shrink-0 py-6 pl-6 hidden xl:block">
-            <div className="sticky top-64 max-h-[calc(100vh-17rem)] overflow-y-auto">
-              <TableOfContents
-                headings={headings}
-                activeId={activeHeadingId}
-                onHeadingClick={scrollToHeading}
-              />
-            </div>
-          </aside>
-        )}
-        {isFullscreen && (
-          <FloatingTOC
-            headings={headings}
-            activeId={activeHeadingId}
-            onHeadingClick={scrollToHeading}
-          />
-        )}
-        <div className="flex-1 px-6 py-6">
-          <DocumentViewer
-            content={document.content}
-            type={document.type}
-            comments={comments}
-            headings={headings}
-            pendingSelection={selection ?? undefined}
-            onTextSelect={onTextSelect}
-            onHighlightPositionsChange={onPositionsChange}
-            onHighlightHover={setHoveredCommentId}
-            onHighlightClick={handleHighlightClick}
-          />
-        </div>
-        <div className="w-72 flex-shrink-0 py-6 pr-4 relative">
-          {selection && pendingSelectionTop !== undefined && (
-            <div
-              className="absolute left-0 right-0 z-10 bg-white dark:bg-zinc-900"
-              style={{ top: pendingSelectionTop }}
-            >
-              {reanchorTarget !== null ? (
-                <ReanchorConfirm
-                  selectionText={selection.text}
-                  onConfirm={handleConfirmReanchor}
-                  onCancel={handleCancelReanchor}
-                />
-              ) : (
-                <CommentInput
-                  key={selection.text}
-                  selectedText={selection.text}
-                  onSubmit={handleAddComment}
-                  onCancel={clearSelection}
-                  onCopyRaw={copySelectionRaw}
-                  onCopyForLLM={copySelectionForLLM}
-                />
-              )}
-            </div>
-          )}
-          <MarginNotes
-            sortedComments={sortedComments}
-            highlightPositions={highlightPositions}
-            pendingSelectionTop={selection ? pendingSelectionTop : undefined}
-          />
-        </div>
-      </div>
-      <CommentMinimap
-        documentPositions={documentPositions}
-        documentHeight={scrollMetrics.documentHeight}
-        viewportHeight={scrollMetrics.viewportHeight}
-      />
-      <CommentNav />
-      <footer className="py-4 text-center text-sm text-zinc-400 dark:text-zinc-500">
-        {t("app.footer")}
-      </footer>
-    </div>
-  );
-}
-function useTabKeyboardShortcuts() {
-  useEffect(() => {
-    const handleKeyDown = (event: KeyboardEvent) => {
-      if (!event.metaKey) return;
-      // Cmd+1-9: switch to tab by index
-      const digit = Number.parseInt(event.key, 10);
-      if (digit >= 1 && digit <= 9) {
-        const { documentOrder } = appStore.getState();
-        if (documentOrder.length <= 1) return;
-        const targetIndex = Math.min(digit - 1, documentOrder.length - 1);
-        const targetPath = documentOrder[targetIndex];
-        if (targetPath) {
-          event.preventDefault();
-          appStore.getState().setActiveDocument(targetPath);
-        }
-      }
-    };
-    window.addEventListener("keydown", handleKeyDown);
-    return () => window.removeEventListener("keydown", handleKeyDown);
-  }, []);
-}
-function App() {
-  const { t } = useLocale();
-  const { document, error, isInitialized, reload } = useDocument();
-  const documentOrder = useAppStore((s) => s.documentOrder);
-  useTabKeyboardShortcuts();
-  useEffect(() => {
-    const eventSource = new EventSource("/api/heartbeat");
-    return () => eventSource.close();
-  }, []);
-  if (error) {
-    return (
-      <div className="min-h-screen bg-white dark:bg-zinc-900 text-zinc-900 dark:text-zinc-100 flex items-center justify-center">
-        <div className="text-red-600">{error}</div>
-      </div>
-    );
-  }
-  if (!isInitialized) {
-    return (
-      <div className="min-h-screen bg-white dark:bg-zinc-900 text-zinc-900 dark:text-zinc-100 flex items-center justify-center">
-        <div className="text-zinc-500 dark:text-zinc-400">
-          {t("app.loading")}
-        </div>
-      </div>
-    );
-  }
-  if (documentOrder.length === 0) {
-    return (
-      <div className="min-h-screen bg-white dark:bg-zinc-900 text-zinc-900 dark:text-zinc-100 flex flex-col">
-        <TabBar />
-        <div className="flex-1 flex flex-col items-center justify-center gap-3">
-          <p className="text-zinc-400 dark:text-zinc-500 text-sm">
-            {t("app.noDocuments")}
-          </p>
-          <p className="text-zinc-400 dark:text-zinc-500 text-xs">
-            {t("app.noDocumentsHintPrefix")}
-            {t("app.noDocumentsHintPrefix") && " "}
-            <code className="bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 rounded text-xs">
-              readit open &lt;file.md&gt;
-            </code>{" "}
-            {t("app.noDocumentsHintSuffix")}
-          </p>
-        </div>
-      </div>
-    );
-  }
-  if (!document) {
-    return (
-      <div className="min-h-screen bg-white dark:bg-zinc-900 text-zinc-900 dark:text-zinc-100 flex items-center justify-center">
-        <div className="text-zinc-500 dark:text-zinc-400">
-          {t("app.loading")}
-        </div>
-      </div>
-    );
-  }
-  return (
-    <>
-      <TabBar />
-      <LayoutProvider>
-        <CommentProvider
-          filePath={document.filePath}
-          clean={document.clean}
-          documentContent={document.content}
-          fileName={document.fileName}
-          documentType={document.type}
-        >
-          <AppContent document={document} reload={reload} />
-        </CommentProvider>
-      </LayoutProvider>
-    </>
-  );
-}
-export default App;