From d0d6002126fed49914979534e0593219f641f806 Mon Sep 17 00:00:00 2001
From: Hermes <hermes@buzzbee.dev>
Date: Sat, 1 Aug 2026 13:07:20 +0000
Subject: [PATCH] fix: use ref-based selectedNote to prevent re-render focus
 stealing

---
 apps/web/src/routes/_app/notes.tsx |  47 ++--
 fix_ref.py                         | 340 +++++++++++++++++++++++++++++
 2 files changed, 355 insertions(+), 32 deletions(-)
 create mode 100644 fix_ref.py

diff --git a/apps/web/src/routes/_app/notes.tsx b/apps/web/src/routes/_app/notes.tsx
index 8b83731..00b4efa 100644
--- a/apps/web/src/routes/_app/notes.tsx
+++ b/apps/web/src/routes/_app/notes.tsx
@@ -1,22 +1,18 @@
-import { useState, useCallback, useRef, useEffect, memo } from "react";
+import { useState, useRef, useEffect, memo } from "react";
 import { createRoute } from "@tanstack/react-router";
 import { Route as appRoute } from "../_app";
-import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import { api, useApiQuery, useApiMutation } from "@/lib/api";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { api, useApiQuery } from "@/lib/api";
 import { useRealtime } from "@/hooks/use-realtime";
-import { Plus, Trash2, Search, Pin, Archive, FileText, Link as LinkIcon, History } from "lucide-react";
+import { Plus, Trash2, Search, Pin, FileText, Link as LinkIcon, History } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
-import { Badge } from "@/components/ui/badge";
-import { Card, CardContent } from "@/components/ui/card";
 import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger } from "@/components/ui/alert-dialog";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { ScrollArea } from "@/components/ui/scroll-area";
-import { Separator } from "@/components/ui/separator";
 import { cn } from "@/lib/utils";
 import type { Note, PaginatedResponse } from "@/lib/types";
 
-// Simple TipTap-like editor using contentEditable
+// Simple TipTap-like editor using contentEditable - saves on blur only
 const NoteEditor = memo(function NoteEditor({ initialContent, onSave, placeholder = "Start writing..." }: { initialContent: string; onSave: (html: string) => void; placeholder?: string }) {
   const editorRef = useRef<HTMLDivElement>(null);
   const [isPlaceholder, setIsPlaceholder] = useState(!initialContent);
@@ -82,12 +78,10 @@ const NoteTitleInput = memo(function NoteTitleInput({ noteId, initialTitle }: {
 function NotesPage() {
   const queryClient = useQueryClient();
   const [search, setSearch] = useState("");
-  const [selectedNote, setSelectedNote] = useState<Note | null>(null);
-  const [editorContent, setEditorContent] = useState("");
-  const saveTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-  const selectedNoteRef = useRef<Note | null>(null);
+  const [selectedNoteId, setSelectedNoteId] = useState<string | null>(null);
   const [showBacklinks, setShowBacklinks] = useState(false);
   const [showVersions, setShowVersions] = useState(false);
+  const selectedNoteRef = useRef<Note | null>(null);
 
   useRealtime({ enabled: true });
 
@@ -102,9 +96,8 @@ function NotesPage() {
     mutationFn: () => api.post<Note>("/notes", { title: "Untitled", content: "" }),
     onSuccess: (note) => {
       queryClient.invalidateQueries({ queryKey: ["notes"] });
-      setSelectedNote(note);
       selectedNoteRef.current = note;
-      setEditorContent("");
+      setSelectedNoteId(note.id);
     },
   });
 
@@ -117,34 +110,24 @@ function NotesPage() {
     mutationFn: (id: string) => api.delete("/notes/" + id),
     onSuccess: () => {
       queryClient.invalidateQueries({ queryKey: ["notes"] });
-      setSelectedNote(null);
+      selectedNoteRef.current = null;
+      setSelectedNoteId(null);
     },
   });
 
   const selectNote = async (note: Note) => {
     try {
       const detail = await api.get<Note>("/notes/" + note.id);
-      setSelectedNote(detail);
       selectedNoteRef.current = detail;
-      setEditorContent(detail.content || "");
     } catch {
-      setSelectedNote(note);
       selectedNoteRef.current = note;
-      setEditorContent(note.content || "");
     }
+    setSelectedNoteId(note.id);
     setShowBacklinks(false);
     setShowVersions(false);
   };
 
-  const handleContentChange = useCallback((html: string) => {
-    if (saveTimerRef.current) clearTimeout(saveTimerRef.current);
-    saveTimerRef.current = setTimeout(() => {
-      const note = selectedNoteRef.current;
-      if (note) {
-        updateMutation.mutate({ id: note.id, data: { content: html } });
-      }
-    }, 500);
-  }, [updateMutation]);
+  const selectedNote = selectedNoteRef.current;
 
   return (
     <div className="flex h-[calc(100vh-8rem)] -m-4 md:-m-6">
@@ -174,7 +157,7 @@ function NotesPage() {
                   onClick={() => selectNote(note)}
                   className={cn(
                     "w-full text-left px-3 py-2 rounded-md text-sm transition-colors",
-                    selectedNote?.id === note.id ? "bg-accent text-accent-foreground" : "hover:bg-accent/50"
+                    selectedNoteId === note.id ? "bg-accent text-accent-foreground" : "hover:bg-accent/50"
                   )}
                 >
                   <div className="flex items-center gap-2">
@@ -196,7 +179,7 @@ function NotesPage() {
         {selectedNote ? (
           <>
             <div className="flex items-center gap-2 p-3 border-b">
-              <NoteTitleInput noteId={selectedNote.id} initialTitle={selectedNote.title} />
+              <NoteTitleInput key={selectedNote.id} noteId={selectedNote.id} initialTitle={selectedNote.title} />
               <div className="flex items-center gap-1 shrink-0">
                 <Button variant="ghost" size="icon" className="h-8 w-8" onClick={() => setShowBacklinks(!showBacklinks)} aria-label="Backlinks">
                   <LinkIcon className="h-4 w-4" />
@@ -224,7 +207,7 @@ function NotesPage() {
               </div>
             </div>
             <div className="flex-1 overflow-auto">
-              <NoteEditor key={selectedNote?.id || 'none'} initialContent={editorContent} onSave={handleContentChange} />
+              <NoteEditor key={selectedNote.id} initialContent={selectedNote.content || ''} onSave={(html) => { if (selectedNoteRef.current) { updateMutation.mutate({ id: selectedNoteRef.current.id, data: { content: html } }); } }} />
             </div>
             {/* Backlinks section */}
             {showBacklinks && selectedNote.backlinks && selectedNote.backlinks.length > 0 && (
diff --git a/fix_ref.py b/fix_ref.py
new file mode 100644
index 0000000..4ca7b47
--- /dev/null
+++ b/fix_ref.py
@@ -0,0 +1,340 @@
+import sys
+
+with open(sys.argv[1], 'r') as f:
+    content = f.read()
+
+old = '''function NotesPage() {
+  const queryClient = useQueryClient();
+  const [search, setSearch] = useState("");
+  const [selectedNote, setSelectedNote] = useState<Note | null>(null);
+  const [showBacklinks, setShowBacklinks] = useState(false);
+  const [showVersions, setShowVersions] = useState(false);
+
+  useRealtime({ enabled: true });
+
+  const { data: notesData, isLoading } = useApiQuery<PaginatedResponse<Note>>(
+    ["notes", search],
+    "/notes?limit=200" + (search ? "&search=" + encodeURIComponent(search) : "")
+  );
+
+  const notes = notesData?.items || [];
+
+  const createMutation = useMutation({
+    mutationFn: () => api.post<Note>("/notes", { title: "Untitled", content: "" }),
+    onSuccess: (note) => {
+      queryClient.invalidateQueries({ queryKey: ["notes"] });
+      setSelectedNote(note);
+    },
+  });
+
+  const updateMutation = useMutation({
+    mutationFn: ({ id, data }: { id: string; data: any }) => api.patch<Note>("/notes/" + id, data),
+    onSuccess: () => { queryClient.invalidateQueries({ queryKey: ["notes"] }); },
+  });
+
+  const deleteMutation = useMutation({
+    mutationFn: (id: string) => api.delete("/notes/" + id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["notes"] });
+      setSelectedNote(null);
+    },
+  });
+
+  const selectNote = async (note: Note) => {
+    try {
+      const detail = await api.get<Note>("/notes/" + note.id);
+      setSelectedNote(detail);
+    } catch {
+      setSelectedNote(note);
+    }
+    setShowBacklinks(false);
+    setShowVersions(false);
+  };
+
+  return (
+    <div className="flex h-[calc(100vh-8rem)] -m-4 md:-m-6">
+      {/* Left pane - note list */}
+      <div className="w-72 border-r flex flex-col shrink-0">
+        <div className="p-3 border-b">
+          <div className="relative">
+            <Search className="absolute left-2.5 top-2.5 h-4 w-4 text-muted-foreground" />
+            <Input placeholder="Search notes..." value={search} onChange={(e) => setSearch(e.target.value)} className="pl-8" />
+          </div>
+        </div>
+        <div className="p-2">
+          <Button size="sm" className="w-full" onClick={() => createMutation.mutate()} aria-label="New note">
+            <Plus className="h-4 w-4 mr-2" />New Note
+          </Button>
+        </div>
+        <ScrollArea className="flex-1">
+          {isLoading ? (
+            <div className="p-4 text-sm text-muted-foreground">Loading...</div>
+          ) : notes.length === 0 ? (
+            <div className="p-4 text-sm text-muted-foreground">No notes yet.</div>
+          ) : (
+            <div className="space-y-0.5 p-2">
+              {notes.map((note) => (
+                <button
+                  key={note.id}
+                  onClick={() => selectNote(note)}
+                  className={cn(
+                    "w-full text-left px-3 py-2 rounded-md text-sm transition-colors",
+                    selectedNote?.id === note.id ? "bg-accent text-accent-foreground" : "hover:bg-accent/50"
+                  )}
+                >
+                  <div className="flex items-center gap-2">
+                    {note.isPinned && <Pin className="h-3 w-3 shrink-0 text-muted-foreground" />}
+                    <span className="truncate font-medium">{note.title}</span>
+                  </div>
+                  <p className="text-xs text-muted-foreground mt-0.5">
+                    {new Date(note.updatedAt).toLocaleDateString()}
+                  </p>
+                </button>
+              ))}
+            </div>
+          )}
+        </ScrollArea>
+      </div>
+
+      {/* Right pane - editor */}
+      <div className="flex-1 flex flex-col">
+        {selectedNote ? (
+          <>
+            <div className="flex items-center gap-2 p-3 border-b">
+              <NoteTitleInput key={selectedNote.id} noteId={selectedNote.id} initialTitle={selectedNote.title} />
+              <div className="flex items-center gap-1 shrink-0">
+                <Button variant="ghost" size="icon" className="h-8 w-8" onClick={() => setShowBacklinks(!showBacklinks)} aria-label="Backlinks">
+                  <LinkIcon className="h-4 w-4" />
+                </Button>
+                <Button variant="ghost" size="icon" className="h-8 w-8" onClick={() => setShowVersions(!showVersions)} aria-label="Version history">
+                  <History className="h-4 w-4" />
+                </Button>
+                <AlertDialog>
+                  <AlertDialogTrigger asChild>
+                    <Button variant="ghost" size="icon" className="h-8 w-8 text-destructive" aria-label="Delete note">
+                      <Trash2 className="h-4 w-4" />
+                    </Button>
+                  </AlertDialogTrigger>
+                  <AlertDialogContent>
+                    <AlertDialogHeader>
+                      <AlertDialogTitle>Delete Note</AlertDialogTitle>
+                      <AlertDialogDescription>Are you sure you want to delete "{selectedNote.title}"?</AlertDialogDescription>
+                    </AlertDialogHeader>
+                    <AlertDialogFooter>
+                      <AlertDialogCancel>Cancel</AlertDialogCancel>
+                      <AlertDialogAction onClick={() => deleteMutation.mutate(selectedNote.id)} className="bg-destructive text-destructive-foreground">Delete</AlertDialogAction>
+                    </AlertDialogFooter>
+                  </AlertDialogContent>
+                </AlertDialog>
+              </div>
+            </div>
+            <div className="flex-1 overflow-auto">
+              <NoteEditor key={selectedNote?.id || 'none'} initialContent={selectedNote?.content || ''} onSave={(html) => { if (selectedNote) { updateMutation.mutate({ id: selectedNote.id, data: { content: html } }); } }} />
+            </div>
+            {/* Backlinks section */}
+            {showBacklinks && selectedNote.backlinks && selectedNote.backlinks.length > 0 && (
+              <div className="border-t p-3">
+                <h4 className="text-sm font-semibold mb-2">Linked from</h4>
+                <div className="space-y-1">
+                  {selectedNote.backlinks.map((bl) => (
+                    <div key={bl.noteId} className="text-sm text-muted-foreground hover:text-foreground cursor-pointer">
+                      {bl.noteTitle}
+                    </div>
+                  ))}
+                </div>
+              </div>
+            )}
+            {/* Version history */}
+            {showVersions && (
+              <div className="border-t p-3">
+                <h4 className="text-sm font-semibold mb-2">Version History</h4>
+                <p className="text-xs text-muted-foreground">Version history available via API.</p>
+              </div>
+            )}
+          </>
+        ) : (
+          <div className="flex items-center justify-center flex-1 text-muted-foreground">
+            <div className="text-center">
+              <FileText className="h-12 w-12 mx-auto mb-3 opacity-50" />
+              <p>Select a note or create a new one</p>
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}'''
+
+new = '''function NotesPage() {
+  const queryClient = useQueryClient();
+  const [search, setSearch] = useState("");
+  const [selectedNoteId, setSelectedNoteId] = useState<string | null>(null);
+  const [showBacklinks, setShowBacklinks] = useState(false);
+  const [showVersions, setShowVersions] = useState(false);
+  const selectedNoteRef = useRef<Note | null>(null);
+
+  useRealtime({ enabled: true });
+
+  const { data: notesData, isLoading } = useApiQuery<PaginatedResponse<Note>>(
+    ["notes", search],
+    "/notes?limit=200" + (search ? "&search=" + encodeURIComponent(search) : "")
+  );
+
+  const notes = notesData?.items || [];
+
+  const createMutation = useMutation({
+    mutationFn: () => api.post<Note>("/notes", { title: "Untitled", content: "" }),
+    onSuccess: (note) => {
+      queryClient.invalidateQueries({ queryKey: ["notes"] });
+      selectedNoteRef.current = note;
+      setSelectedNoteId(note.id);
+    },
+  });
+
+  const updateMutation = useMutation({
+    mutationFn: ({ id, data }: { id: string; data: any }) => api.patch<Note>("/notes/" + id, data),
+    onSuccess: () => { queryClient.invalidateQueries({ queryKey: ["notes"] }); },
+  });
+
+  const deleteMutation = useMutation({
+    mutationFn: (id: string) => api.delete("/notes/" + id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["notes"] });
+      selectedNoteRef.current = null;
+      setSelectedNoteId(null);
+    },
+  });
+
+  const selectNote = async (note: Note) => {
+    try {
+      const detail = await api.get<Note>("/notes/" + note.id);
+      selectedNoteRef.current = detail;
+    } catch {
+      selectedNoteRef.current = note;
+    }
+    setSelectedNoteId(note.id);
+    setShowBacklinks(false);
+    setShowVersions(false);
+  };
+
+  const selectedNote = selectedNoteRef.current;
+
+  return (
+    <div className="flex h-[calc(100vh-8rem)] -m-4 md:-m-6">
+      {/* Left pane - note list */}
+      <div className="w-72 border-r flex flex-col shrink-0">
+        <div className="p-3 border-b">
+          <div className="relative">
+            <Search className="absolute left-2.5 top-2.5 h-4 w-4 text-muted-foreground" />
+            <Input placeholder="Search notes..." value={search} onChange={(e) => setSearch(e.target.value)} className="pl-8" />
+          </div>
+        </div>
+        <div className="p-2">
+          <Button size="sm" className="w-full" onClick={() => createMutation.mutate()} aria-label="New note">
+            <Plus className="h-4 w-4 mr-2" />New Note
+          </Button>
+        </div>
+        <ScrollArea className="flex-1">
+          {isLoading ? (
+            <div className="p-4 text-sm text-muted-foreground">Loading...</div>
+          ) : notes.length === 0 ? (
+            <div className="p-4 text-sm text-muted-foreground">No notes yet.</div>
+          ) : (
+            <div className="space-y-0.5 p-2">
+              {notes.map((note) => (
+                <button
+                  key={note.id}
+                  onClick={() => selectNote(note)}
+                  className={cn(
+                    "w-full text-left px-3 py-2 rounded-md text-sm transition-colors",
+                    selectedNoteId === note.id ? "bg-accent text-accent-foreground" : "hover:bg-accent/50"
+                  )}
+                >
+                  <div className="flex items-center gap-2">
+                    {note.isPinned && <Pin className="h-3 w-3 shrink-0 text-muted-foreground" />}
+                    <span className="truncate font-medium">{note.title}</span>
+                  </div>
+                  <p className="text-xs text-muted-foreground mt-0.5">
+                    {new Date(note.updatedAt).toLocaleDateString()}
+                  </p>
+                </button>
+              ))}
+            </div>
+          )}
+        </ScrollArea>
+      </div>
+
+      {/* Right pane - editor */}
+      <div className="flex-1 flex flex-col">
+        {selectedNote ? (
+          <>
+            <div className="flex items-center gap-2 p-3 border-b">
+              <NoteTitleInput key={selectedNote.id} noteId={selectedNote.id} initialTitle={selectedNote.title} />
+              <div className="flex items-center gap-1 shrink-0">
+                <Button variant="ghost" size="icon" className="h-8 w-8" onClick={() => setShowBacklinks(!showBacklinks)} aria-label="Backlinks">
+                  <LinkIcon className="h-4 w-4" />
+                </Button>
+                <Button variant="ghost" size="icon" className="h-8 w-8" onClick={() => setShowVersions(!showVersions)} aria-label="Version history">
+                  <History className="h-4 w-4" />
+                </Button>
+                <AlertDialog>
+                  <AlertDialogTrigger asChild>
+                    <Button variant="ghost" size="icon" className="h-8 w-8 text-destructive" aria-label="Delete note">
+                      <Trash2 className="h-4 w-4" />
+                    </Button>
+                  </AlertDialogTrigger>
+                  <AlertDialogContent>
+                    <AlertDialogHeader>
+                      <AlertDialogTitle>Delete Note</AlertDialogTitle>
+                      <AlertDialogDescription>Are you sure you want to delete "{selectedNote.title}"?</AlertDialogDescription>
+                    </AlertDialogHeader>
+                    <AlertDialogFooter>
+                      <AlertDialogCancel>Cancel</AlertDialogCancel>
+                      <AlertDialogAction onClick={() => deleteMutation.mutate(selectedNote.id)} className="bg-destructive text-destructive-foreground">Delete</AlertDialogAction>
+                    </AlertDialogFooter>
+                  </AlertDialogContent>
+                </AlertDialog>
+              </div>
+            </div>
+            <div className="flex-1 overflow-auto">
+              <NoteEditor key={selectedNote.id} initialContent={selectedNote.content || ''} onSave={(html) => { if (selectedNoteRef.current) { updateMutation.mutate({ id: selectedNoteRef.current.id, data: { content: html } }); } }} />
+            </div>
+            {/* Backlinks section */}
+            {showBacklinks && selectedNote.backlinks && selectedNote.backlinks.length > 0 && (
+              <div className="border-t p-3">
+                <h4 className="text-sm font-semibold mb-2">Linked from</h4>
+                <div className="space-y-1">
+                  {selectedNote.backlinks.map((bl) => (
+                    <div key={bl.noteId} className="text-sm text-muted-foreground hover:text-foreground cursor-pointer">
+                      {bl.noteTitle}
+                    </div>
+                  ))}
+                </div>
+              </div>
+            )}
+            {/* Version history */}
+            {showVersions && (
+              <div className="border-t p-3">
+                <h4 className="text-sm font-semibold mb-2">Version History</h4>
+                <p className="text-xs text-muted-foreground">Version history available via API.</p>
+              </div>
+            )}
+          </>
+        ) : (
+          <div className="flex items-center justify-center flex-1 text-muted-foreground">
+            <div className="text-center">
+              <FileText className="h-12 w-12 mx-auto mb-3 opacity-50" />
+              <p>Select a note or create a new one</p>
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}'''
+
+content = content.replace(old, new, 1)
+
+with open(sys.argv[1], 'w') as f:
+    f.write(content)
+print('Done')