Add note browser pane

trovedb/qgui/note_browser.py

@@ -0,0 +1,127 @@
+from __future__ import annotations
+from typing import Optional, Callable
+from PySide6.QtCore import Qt, QModelIndex, Signal
+from PySide6.QtWidgets import (
+    QWidget, QTreeView, QVBoxLayout, QHBoxLayout,
+    QPushButton, QMenu, QAbstractItemView,
+)
+from PySide6.QtGui import QAction
+
+from trovedb.trove import Note, TreeNote, Trove
+
+from .trove_tree_model import TroveTreeModel, TroveNode
+
+
+class NoteBrowser(QWidget):
+    """
+    A simple tree browser widget for a Trove.
+
+    Signals:
+        note_selected(Note)  -- emitted when a non-tree note is activated
+        tree_selected(TreeNote) -- emitted when a tree note is activated
+    """
+
+    note_selected = Signal(object)  # Note
+    tree_selected = Signal(object)  # TreeNote
+
+    def __init__(self, trove: Trove, parent: Optional[QWidget] = None):
+        super().__init__(parent)
+        self._model = TroveTreeModel(trove)
+        self._setup_ui()
+
+    # ------------------------------------------------------------------
+    # UI setup
+    # ------------------------------------------------------------------
+
+    def _setup_ui(self) -> None:
+        layout = QVBoxLayout(self)
+        layout.setContentsMargins(0, 0, 0, 0)
+        layout.setSpacing(2)
+
+        self._tree = QTreeView()
+        self._tree.setModel(self._model)
+        self._tree.setHeaderHidden(True)
+        self._tree.setUniformRowHeights(True)
+        self._tree.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
+        self._tree.setEditTriggers(QAbstractItemView.EditTrigger.NoEditTriggers)
+        self._tree.setContextMenuPolicy(Qt.ContextMenuPolicy.CustomContextMenu)
+
+        self._tree.activated.connect(self._on_activated)
+        self._tree.customContextMenuRequested.connect(self._on_context_menu)
+
+        layout.addWidget(self._tree)
+
+        # Minimal toolbar — refresh only for now
+        toolbar = QHBoxLayout()
+        toolbar.setContentsMargins(0, 0, 0, 0)
+        refresh_btn = QPushButton("Refresh")
+        refresh_btn.setFixedWidth(70)
+        refresh_btn.clicked.connect(self._on_refresh)
+        toolbar.addWidget(refresh_btn)
+        toolbar.addStretch()
+        layout.addLayout(toolbar)
+
+    # ------------------------------------------------------------------
+    # Slots
+    # ------------------------------------------------------------------
+
+    def _on_activated(self, index: QModelIndex) -> None:
+        note = index.data(Qt.ItemDataRole.UserRole)
+        if note is None:
+            return
+        if isinstance(note, TreeNote):
+            self.tree_selected.emit(note)
+        else:
+            self.note_selected.emit(note)
+
+    def _on_context_menu(self, pos) -> None:
+        index = self._tree.indexAt(pos)
+        menu = QMenu(self)
+
+        refresh_action = QAction("Refresh", self)
+        refresh_action.triggered.connect(
+            lambda: self._model.invalidate_node(index) if index.isValid() else self._on_refresh()
+        )
+        menu.addAction(refresh_action)
+
+        # Placeholder hooks — wire up to a controller when ready
+        if index.isValid():
+            node: TroveNode = index.internalPointer()
+            if node.is_tree():
+                menu.addSeparator()
+                menu.addAction(QAction("New Note…", self))  # TODO: controller
+                menu.addAction(QAction("New Folder…", self))  # TODO: controller
+            menu.addSeparator()
+            menu.addAction(QAction("Rename…", self))  # TODO: controller
+            menu.addAction(QAction("Delete", self))  # TODO: controller
+
+        menu.exec(self._tree.viewport().mapToGlobal(pos))
+
+    def _on_refresh(self) -> None:
+        """Full model reset — use until event-based invalidation is wired up."""
+        self._model.invalidate_node(QModelIndex())
+
+    # ------------------------------------------------------------------
+    # Public API
+    # ------------------------------------------------------------------
+
+    def select_note(self, note: Note) -> None:
+        """Programmatically select the node matching the given note object."""
+        match = self._find_index(self._model.index(0, 0, QModelIndex()), note)
+        if match is not None and match.isValid():
+            self._tree.setCurrentIndex(match)
+            self._tree.scrollTo(match)
+
+    def _find_index(self, start: QModelIndex, target: Note) -> Optional[QModelIndex]:
+        """DFS over visible model nodes looking for a matching Note."""
+        if not start.isValid():
+            return None
+        node: TroveNode = start.internalPointer()
+        if node.note is target:
+            return start
+        for row in range(self._model.rowCount(start)):
+            child = self._model.index(row, 0, start)
+            result = self._find_index(child, target)
+            if result is not None:
+                return result
+        return None