@fresh-editor/fresh-editor 0.3.5 → 0.3.7

package/CHANGELOG.md

@@ -1,5 +1,152 @@
 # Release Notes
 
+## 0.3.7
+
+Introduces an experimental **multi-window orchestrator** command (`Alt+Q`) - a UI that manages multiple Fresh windows side by side in a single Fresh process.
+
+### Features / Improvements
+
+#### Orchestrator (early experiment)
+
+The new orchestrator command (`Alt+Q`) lets one Fresh process juggle several independent windows — switch between sessions, open new ones from a project path / branch, or visit one in a separate Fresh process. This is an early experiment; expect rough edges. Please share your ideas and bug reports!
+
+#### Search and Replace
+
+Made an effort to improve the search & replace command, tackling several issues:
+
+* **All Files** scope toggle + dedicated current-file command.
+* Editor shortcuts (`Ctrl+P` etc.) pass through the panel.
+* Proper empty / searching / no-results states.
+* Large result sets stay responsive — incremental tree, throttled streaming, capped per-iteration work.
+
+#### Git Log / Review Diff
+
+* **Performance**: Per-commit diffs **stream into file-backed buffers** with full syntax highlighting, per-line add/delete backgrounds, working scrollbar, and `Fold by File` / `Fold by Hunk` commands. Now opens the famous "rewrite bun in rust" commit instantly!
+* **Open file at commit** (#1962): jump from a diff line in the review-branch detail panel to the file at that commit (read-only, `q` to go back).
+
+#### File Explorer
+
+* **Compact directories** (#1406, thanks @Nandaleio!): a directory containing a single child directory renders inline as `com.example.name`, VSCode/IntelliJ-style. On by default; toggle with `file_explorer.compact_directories`.
+* **Configurable tree indicators** (#1940, reported by @MicTheSquid): expand/collapse glyphs themable via *File Explorer → Tree Indicator Expanded / Collapsed* in the Settings UI.
+
+#### Plugins & API
+
+* **`git_statusbar` plugin + status-bar token registration API** (thanks @PavelLoparev!): show the current git branch in the status bar; plugins register their own tokens via `editor.registerStatusBarElement`. Add via *Settings → Editor → Status Bar → Left / Right*.
+* **`tab_actions` plugin** (#1844, thanks @PavelLoparev!): close all / to-the-left / to-the-right and move tabs within the current split.
+* **Plugins can register their own config items**: a new typed registration API lets plugins declare settings that appear in the Settings UI alongside built-in ones (sorted at the bottom of the category list), so users can toggle plugin behaviour from the same place as everything else. The bundled `vi_mode` plugin uses it to expose an **autoStart** option.
+
+#### Editing & Widgets
+
+* **Add Cursors to Line Ends** (#1870, reported by @aquasync): places a cursor at the end of every line in the selection.
+* Widget text inputs gain real selection rendering, `Shift+arrow` / `Ctrl+Shift+arrow` extension, and `Ctrl+C/V/X/A` — used by Search & Replace and plugin dialogs.
+* Floating completion popup on widget `Text` inputs.
+
+#### Live Diff
+
+* Word-level underline highlights on deletion lines; similarity threshold and size caps are runtime-tunable, so large diffs render as modified lines rather than paired add/remove blocks.
+
+### Bug Fixes
+
+* **`init.ts` `setAutoOpen(false)` ignored**: dashboard auto-open is now driven by the `ready` hook so user `init.ts` runs first.
+
+#### Git Log / Review Diff
+
+* **Detail panel `PageUp` / `PageDown`** (action name was wrong); scrollbar now functional on the streamed buffer.
+
+#### File Explorer
+
+* **UI / navigation shortcuts** (#1903): `Ctrl+P` and friends are no longer swallowed when the file explorer has focus.
+* **Switch Project double-click** (#1931, reported by @SolarLune): double-clicking a directory navigates into it instead of dismissing the dialog.
+
+#### Plugins
+
+* **Plugin init scaffold** (#1986, @PavelLoparev): new plugins now generate `fresh.entry` (the current entry-point name) instead of stale `fresh.main`.
+* **Idle CPU from git plugins** (#2009, #2012): `git_statusbar` and `merge_conflict` no longer spawn idle subprocesses; `git_statusbar` is driven off `watchPath(.git/HEAD)`.
+
+#### Editing
+
+* **Smart Home with multiple cursors**: now runs for every cursor, not only the primary.
+* **Soft wrap at trailing space** (#1363, reported by @dragonfyre13): when a trailing space would overflow the wrap column, wrap backs up one word instead of breaking mid-token.
+* **Horizontal scroll-to-view on long lines** (#1873): the viewport now follows the cursor on long lines.
+
+#### Live Diff
+
+* **Wrapped overlay backgrounds** now extend across every visual row of a wrapped line.
+
+#### Rendering
+
+* **Highlighter cache preserved across bulk edits** (#1958): large pastes and replace-all no longer trigger a whole-file reparse.
+* **Phantom cursor offscreen** (#1965): a buffer cursor scrolled past the viewport no longer leaves a stray block at the screen edge.
+* **Split separator background** (#1963): separator cells now paint with `editor_bg` so split borders blend with the panes.
+* **Next / Prev Split un-maximizes** (#1961): navigating to another split un-maximizes first.
+* **Stable cursor-position indicator** (#1967): `Ln L, Col C` no longer jitters as the column count grows.
+* **PTY terminal background** now fills the render rect with the editor bg.
+* **Nostalgia theme** (#1890, reported by @NGRIT41): terminal-pane blue now covers full pane.
+* **Column rulers** suppressed on virtual buffers (dashboard, PTY panes, etc.).
+
+#### Misc
+
+* **No more stray `.fresh/` directory in your working dir** (#1991): orchestrator/cross-restart state now lives under `data_dir` instead of being dropped next to your project files.
+* **Buffer "library path" detection** (#1970, reported by @FF-AntiK): only `.cargo/registry` and `.cargo/git` are treated as Cargo library paths — local `.cargo/config.toml` etc. are no longer flagged.
+* **Julia grammar** (#1852, reported by @goszlanyi): the adjoint operator (`'`) no longer flips the rest of the line into string mode.
+* **`move_word_end` / `select_word_end` labels** (#1878, reported by @sour-dani): translated in all locales.
+
+## 0.3.6
+
+This version includes a major internal refactoring to support multiple windows in a single Fresh process. The work will be used to add a multi-window orchestrator in a future version.
+
+### Features
+
+* **Go to line with selection** (#1764, thanks @PavelLoparev!): New action extends the selection from cursor to target line. Supports absolute and relative (`+10`) jumps.
+
+* **File explorer "follow active buffer"** (#1569, #1803, thanks @ko3n1g!): New `file_explorer.follow_active_buffer` setting (default off). When on, switching tabs expands and highlights the corresponding file without stealing focus.
+
+* **Live Diff**: Near-identical lines now render as modified lines, with new words decorated as underline (instead of two separate add/remove rows). Deletion virtual lines get gutter markers. Fixed live diff colors in `terminal` theme.
+
+* **Auto-start `vi_mode`** (#1086, reported by @jmcblane): Vi mode plugin now exposes `toggle / enable / disable` so `init.ts` can flip vi mode at startup. Add this to your `init.ts` to enable: `editor.getPluginApi("vi-mode")?.enable();`.
+
+In the future I plan to add a way for plugins to register custom config sections in the Settings UI, and then enabling vi-mode auto-start will be available through the UI.
+
+### Improvements
+
+* **openSUSE install instructions** (#1897, thanks @ilmanzo!) added to the README.
+
+* **Quick Open ranking**: Matches at the start of a path segment now beat arbitrary substring hits — `ts` surfaces `tsconfig.json` and `tsc/...` before random `.ts` files.
+
+* **Search & Replace no longer freezes** on result sets in the thousands.
+
+* **Rust code actions** (#1915): `rust-analyzer` now returns `WorkspaceEdit`-based assists like "Fill struct fields" instead of "No code actions available" — Fresh wasn't advertising the capability.
+
+* **Status-bar indicator menus**: Clicking another indicator's icon dismisses the currently-open menu instead of stacking a second one on top.
+
+* **LSP-Servers popup is extensible**: Plugins (starting with the bundled `rust-lsp`) can contribute their own rows.
+
+* **`terminal` built-in theme** (#1914): Diff backgrounds no longer collide with syntax foregrounds, so keywords on deletion lines and strings on addition lines stay readable on terminals (e.g. xfce-terminal) where each ANSI palette index renders identically for fg and bg.
+
+* **Dashboard** matches the editor background and no longer slides in.
+
+* **AppImage install script** has error handling and a `/tmp` fallback so it no longer silently fails when the target directory isn't writable.
+
+### Bug Fixes
+
+* **Crash on startup from a corrupt workspace** (#1939, reported by @zdooder): Restoring a session whose persisted split pointed at a buffer no longer in the buffer map crashed in `render.rs`. The active-buffer pointer is now validated and falls back to a live buffer if it's stale.
+
+* **Completion popup + multicursor** (#1901, reported by @dtwilliamson): Typing a word character or `Backspace` while the popup was open only edited the primary cursor — secondary cursors silently went out of sync after the first keystroke. Accepting a completion now also applies at every cursor.
+
+* **LSP indicator click** (#1941): Bugs fixed: plugin popup stacked under the built-in one; plugin popup ignored the active theme's `popup_bg`; state stayed stale after the LSP process was killed externally; "Disable LSP" didn't actually stop the running server; repeated clicks stacked further popups.
+
+* **Scrollbar theme overrides** (#1554, reported by @klonuo): User themes setting `ui.scrollbar_track_fg`, `ui.scrollbar_track_hover_fg`, or `ui.scrollbar_thumb_hover_fg` had their overrides silently dropped.
+
+* **Utility dock routing** (#1932): `Ctrl+P` → filename now opens the file in the editor area instead of inside the bottom dock when the dock has focus. The split tab-bar `□` button now maximizes the split you clicked, not the active one.
+
+* **Tab drag**: Dropping a tab onto a fresh split (e.g. a Search & Replace result row) no longer panics on the next keystroke.
+
+* **File explorer**: A directory whose `.gitignore` filters out all its contents (e.g. `build/` with `*` inside) stays visible when expanded.
+
+* **Live Diff visual-line motion**: `Down`/`Up` no longer freezes when traversing a deletion block that starts with a blank line.
+
+* **`S-Tab` plugin bindings** now register correctly (terminals deliver Shift+Tab as `BackTab`).
+
 ## 0.3.5
 
 ### Improvements

package/README.md

@@ -65,7 +65,8 @@ Or, pick your preferred method:
 | Windows | [winget](#windows-winget) |
 | Arch Linux | [AUR](#arch-linux-aur) |
 | Debian/Ubuntu | [.deb](#debianubuntu-deb) |
-| Fedora/RHEL | [.rpm](#fedorarhelopensuse-rpm), [Terra](https://terra.fyralabs.com/) |
+| Fedora/RHEL | [.rpm](#fedorarhel-rpm), [Terra](https://terra.fyralabs.com/) |
+| OpenSUSE | [zypper](#opensuse-zypper), [.rpm](#fedorarhel-rpm) |
 | FreeBSD | [ports / pkg](https://www.freshports.org/editors/fresh) |
 | Gentoo | [GURU](#gentoo-guru) |
 | Linux (any distro) | [AppImage](#appimage), [Flatpak](#flatpak) |
@@ -133,7 +134,7 @@ curl -sL $(curl -s https://api.github.com/repos/sinelaw/fresh/releases/latest |
 
 Or download the `.deb` file manually from the [releases page](https://github.com/sinelaw/fresh/releases).
 
-### Fedora/RHEL/openSUSE (.rpm)
+### Fedora/RHEL (.rpm)
 
 Download and install the latest release:
 
@@ -143,6 +144,12 @@ curl -sL $(curl -s https://api.github.com/repos/sinelaw/fresh/releases/latest |
 
 Or download the `.rpm` file manually from the [releases page](https://github.com/sinelaw/fresh/releases).
 
+### OpenSUSE (zypper)
+
+```bash
+zypper install fresh-editor
+```
+
 ### Gentoo ([GURU](https://wiki.gentoo.org/wiki/Project:GURU))
 
 Enable the repository as read in [Project:GURU/Information for End Users](https://wiki.gentoo.org/wiki/Project:GURU/Information_for_End_Users) then emerge the package:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fresh-editor/fresh-editor",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "A modern terminal-based text editor with plugin support",
   "repository": {
     "type": "git",

package/plugins/audit_mode.i18n.json

@@ -21,6 +21,12 @@
     "status.review_branch_empty": "No commits in %{base}..HEAD — nothing to review.",
     "panel.review_branch_header": "Commits (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: navigate | Enter: focus detail | r: refresh | q: close",
+    "status.move_to_diff": "Move cursor to a diff line",
+    "status.move_to_diff_with_context": "Move cursor to a diff line with file context",
+    "status.file_loading": "Loading %{file} at %{hash}...",
+    "status.file_not_found": "File %{file} not found at commit %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (read-only) | Target: line %{line} | q: back",
+    "status.failed_open_file": "Failed to open %{file}",
     "cmd.side_by_side_diff": "Side-by-Side Diff",
     "cmd.side_by_side_diff_desc": "Show side-by-side diff for current file",
     "cmd.add_comment": "Review: Add Comment",
@@ -97,6 +103,12 @@
     "status.review_branch_empty": "Žádné commity v %{base}..HEAD — není co revidovat.",
     "panel.review_branch_header": "Commity (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: navigace | Enter: detail | r: obnovit | q: zavřít",
+    "status.move_to_diff": "Presunte kurzor na radek diffu",
+    "status.move_to_diff_with_context": "Presunte kurzor na radek diffu s kontextem souboru",
+    "status.file_loading": "Nacitam %{file} v %{hash}...",
+    "status.file_not_found": "Soubor %{file} nenalezen v commitu %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (pouze pro cteni) | Cil: radek %{line} | q: zpet",
+    "status.failed_open_file": "Nepodarilo se otevrit %{file}",
     "cmd.side_by_side_diff": "Rozdily vedle sebe",
     "cmd.side_by_side_diff_desc": "Zobrazit rozdily aktualniho souboru vedle sebe",
     "cmd.add_comment": "Revize: Pridat komentar",
@@ -173,6 +185,12 @@
     "status.review_branch_empty": "Keine Commits in %{base}..HEAD — nichts zu überprüfen.",
     "panel.review_branch_header": "Commits (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: Navigation | Enter: Detail | r: Aktualisieren | q: Schließen",
+    "status.move_to_diff": "Cursor auf eine Diff-Zeile bewegen",
+    "status.move_to_diff_with_context": "Cursor auf eine Diff-Zeile mit Dateikontext bewegen",
+    "status.file_loading": "Lade %{file} bei %{hash}...",
+    "status.file_not_found": "Datei %{file} nicht gefunden bei Commit %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (schreibgeschuetzt) | Ziel: Zeile %{line} | q: zurueck",
+    "status.failed_open_file": "%{file} konnte nicht geoeffnet werden",
     "cmd.side_by_side_diff": "Nebeneinander-Ansicht",
     "cmd.side_by_side_diff_desc": "Unterschiede der aktuellen Datei nebeneinander anzeigen",
     "cmd.add_comment": "Review: Kommentar hinzufugen",
@@ -249,6 +267,12 @@
     "status.review_branch_empty": "No hay commits en %{base}..HEAD — nada que revisar.",
     "panel.review_branch_header": "Commits (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: navegar | Enter: detalle | r: actualizar | q: cerrar",
+    "status.move_to_diff": "Mueve el cursor a una linea de diff",
+    "status.move_to_diff_with_context": "Mueve el cursor a una linea de diff con contexto de archivo",
+    "status.file_loading": "Cargando %{file} en %{hash}...",
+    "status.file_not_found": "Archivo %{file} no encontrado en commit %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (solo lectura) | Objetivo: linea %{line} | q: volver",
+    "status.failed_open_file": "Error al abrir %{file}",
     "cmd.side_by_side_diff": "Diferencias Lado a Lado",
     "cmd.side_by_side_diff_desc": "Mostrar diferencias lado a lado del archivo actual",
     "cmd.add_comment": "Revision: Agregar Comentario",
@@ -325,6 +349,12 @@
     "status.review_branch_empty": "Aucun commit dans %{base}..HEAD — rien à revoir.",
     "panel.review_branch_header": "Commits (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k : naviguer | Entrée : détail | r : actualiser | q : fermer",
+    "status.move_to_diff": "Deplacez le curseur sur une ligne de diff",
+    "status.move_to_diff_with_context": "Deplacez le curseur sur une ligne de diff avec contexte de fichier",
+    "status.file_loading": "Chargement de %{file} a %{hash}...",
+    "status.file_not_found": "Fichier %{file} non trouve au commit %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (lecture seule) | Cible: ligne %{line} | q: retour",
+    "status.failed_open_file": "Echec de l'ouverture de %{file}",
     "cmd.side_by_side_diff": "Differences Cote a Cote",
     "cmd.side_by_side_diff_desc": "Afficher les differences du fichier actuel cote a cote",
     "cmd.add_comment": "Revue: Ajouter un Commentaire",
@@ -401,6 +431,12 @@
     "status.review_branch_empty": "Nessun commit in %{base}..HEAD — niente da revisionare.",
     "panel.review_branch_header": "Commit (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: naviga | Invio: dettaglio | r: aggiorna | q: chiudi",
+    "status.move_to_diff": "Sposta il cursore su una riga di diff",
+    "status.move_to_diff_with_context": "Sposta il cursore su una riga di diff con contesto file",
+    "status.file_loading": "Caricamento %{file} a %{hash}...",
+    "status.file_not_found": "File %{file} non trovato al commit %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (sola lettura) | Destinazione: riga %{line} | q: indietro",
+    "status.failed_open_file": "Apertura di %{file} fallita",
     "cmd.side_by_side_diff": "Diff affiancato",
     "cmd.side_by_side_diff_desc": "Mostra diff affiancato per il file corrente",
     "cmd.add_comment": "Revisione: Aggiungi commento",
@@ -477,6 +513,12 @@
     "status.review_branch_empty": "%{base}..HEAD にコミットはありません — レビューする対象がありません。",
     "panel.review_branch_header": "コミット (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: 移動 | Enter: 詳細 | r: 更新 | q: 閉じる",
+    "status.move_to_diff": "カーソルを差分行に移動してください",
+    "status.move_to_diff_with_context": "ファイルコンテキストのある差分行にカーソルを移動してください",
+    "status.file_loading": "%{file} を %{hash} で読み込み中...",
+    "status.file_not_found": "コミット %{hash} でファイル %{file} が見つかりません",
+    "status.file_view_ready": "%{file} @ %{hash} (読み取り専用) | 対象: %{line}行目 | q: 戻る",
+    "status.failed_open_file": "%{file} を開けませんでした",
     "cmd.side_by_side_diff": "サイドバイサイド差分",
     "cmd.side_by_side_diff_desc": "現在のファイルの差分を横並びで表示",
     "cmd.add_comment": "レビュー: コメント追加",
@@ -553,6 +595,12 @@
     "status.review_branch_empty": "%{base}..HEAD에 커밋이 없습니다 — 리뷰할 내용이 없습니다.",
     "panel.review_branch_header": "커밋 (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: 이동 | Enter: 상세 | r: 새로 고침 | q: 닫기",
+    "status.move_to_diff": "커서를 diff 줄로 이동하세요",
+    "status.move_to_diff_with_context": "파일 컨텍스트가 있는 diff 줄로 커서를 이동하세요",
+    "status.file_loading": "%{hash}에서 %{file} 로딩 중...",
+    "status.file_not_found": "커밋 %{hash}에서 파일 %{file}을 찾을 수 없습니다",
+    "status.file_view_ready": "%{file} @ %{hash} (읽기 전용) | 대상: %{line}행 | q: 뒤로",
+    "status.failed_open_file": "%{file}을 열지 못했습니다",
     "cmd.side_by_side_diff": "나란히 비교",
     "cmd.side_by_side_diff_desc": "현재 파일의 차이점을 나란히 표시",
     "cmd.add_comment": "검토: 코멘트 추가",
@@ -629,6 +677,12 @@
     "status.review_branch_empty": "Sem commits em %{base}..HEAD — nada para revisar.",
     "panel.review_branch_header": "Commits (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: navegar | Enter: detalhe | r: atualizar | q: fechar",
+    "status.move_to_diff": "Mova o cursor para uma linha de diff",
+    "status.move_to_diff_with_context": "Mova o cursor para uma linha de diff com contexto de arquivo",
+    "status.file_loading": "Carregando %{file} em %{hash}...",
+    "status.file_not_found": "Arquivo %{file} nao encontrado no commit %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (somente leitura) | Destino: linha %{line} | q: voltar",
+    "status.failed_open_file": "Falha ao abrir %{file}",
     "cmd.side_by_side_diff": "Diferencas Lado a Lado",
     "cmd.side_by_side_diff_desc": "Mostrar diferencas do arquivo atual lado a lado",
     "cmd.add_comment": "Revisao: Adicionar Comentario",
@@ -705,6 +759,12 @@
     "status.review_branch_empty": "Нет коммитов в %{base}..HEAD — нечего просматривать.",
     "panel.review_branch_header": "Коммиты (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: навигация | Enter: детали | r: обновить | q: закрыть",
+    "status.move_to_diff": "Peremesstite kursor na stroku diff",
+    "status.move_to_diff_with_context": "Peremesstite kursor na stroku diff s kontekstom fayla",
+    "status.file_loading": "Zagruzka %{file} v %{hash}...",
+    "status.file_not_found": "Fayl %{file} ne nayden v kommite %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (tol'ko dlya chteniya) | Tsel': stroka %{line} | q: nazad",
+    "status.failed_open_file": "Ne udalos' otkryt' %{file}",
     "cmd.side_by_side_diff": "Сравнение бок о бок",
     "cmd.side_by_side_diff_desc": "Показать изменения текущего файла бок о бок",
     "cmd.add_comment": "Ревью: Добавить комментарий",
@@ -781,6 +841,12 @@
     "status.review_branch_empty": "ไม่มีคอมมิตใน %{base}..HEAD — ไม่มีอะไรต้องตรวจสอบ",
     "panel.review_branch_header": "คอมมิต (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: นำทาง | Enter: รายละเอียด | r: รีเฟรช | q: ปิด",
+    "status.move_to_diff": "เลื่อนเคอร์เซอร์ไปที่บรรทัด diff",
+    "status.move_to_diff_with_context": "เลื่อนเคอร์เซอร์ไปที่บรรทัด diff ที่มีบริบทไฟล์",
+    "status.file_loading": "กำลังโหลด %{file} ที่ %{hash}...",
+    "status.file_not_found": "ไม่พบไฟล์ %{file} ในคอมมิต %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (อ่านอย่างเดียว) | เป้าหมาย: บรรทัด %{line} | q: กลับ",
+    "status.failed_open_file": "ไม่สามารถเปิด %{file} ได้",
     "cmd.side_by_side_diff": "เปรียบเทียบแบบเคียงข้าง",
     "cmd.side_by_side_diff_desc": "แสดงความแตกต่างของไฟล์ปัจจุบันแบบเคียงข้าง",
     "cmd.add_comment": "ตรวจสอบ: เพิ่มความคิดเห็น",
@@ -857,6 +923,12 @@
     "status.review_branch_empty": "Немає комітів у %{base}..HEAD — нічого переглядати.",
     "panel.review_branch_header": "Коміти (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: навігація | Enter: деталі | r: оновити | q: закрити",
+    "status.move_to_diff": "Peremistit' kursor na ryadok diff",
+    "status.move_to_diff_with_context": "Peremistit' kursor na ryadok diff z kontekstom faylu",
+    "status.file_loading": "Zavantazhennya %{file} v %{hash}...",
+    "status.file_not_found": "Fayl %{file} ne znaydeno v komiti %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (til'ky dlya chytannya) | Tsil': ryadok %{line} | q: nazad",
+    "status.failed_open_file": "Ne vdalosya vidkryty %{file}",
     "cmd.side_by_side_diff": "Порівняння поруч",
     "cmd.side_by_side_diff_desc": "Показати зміни поточного файлу поруч",
     "cmd.add_comment": "Рев'ю: Додати коментар",
@@ -933,6 +1005,12 @@
     "status.review_branch_empty": "Không có commit nào trong %{base}..HEAD — không có gì để xem xét.",
     "panel.review_branch_header": "Commit (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k: điều hướng | Enter: chi tiết | r: làm mới | q: đóng",
+    "status.move_to_diff": "Di chuyển con trỏ đến dòng diff",
+    "status.move_to_diff_with_context": "Di chuyển con trỏ đến dòng diff có ngữ cảnh tệp",
+    "status.file_loading": "Đang tải %{file} tại %{hash}...",
+    "status.file_not_found": "Không tìm thấy tệp %{file} tại commit %{hash}",
+    "status.file_view_ready": "%{file} @ %{hash} (chỉ đọc) | Đích: dòng %{line} | q: quay lại",
+    "status.failed_open_file": "Không thể mở %{file}",
     "cmd.side_by_side_diff": "So sánh song song",
     "cmd.side_by_side_diff_desc": "Hiển thị khác biệt song song cho tệp hiện tại",
     "cmd.add_comment": "Xem xét: Thêm nhận xét",
@@ -1009,6 +1087,12 @@
     "status.review_branch_empty": "%{base}..HEAD 中没有提交 — 无需审查。",
     "panel.review_branch_header": "提交 (%{base}..HEAD)",
     "panel.review_branch_footer": "j/k：导航 | Enter：详情 | r：刷新 | q：关闭",
+    "status.move_to_diff": "请将光标移动到差异行",
+    "status.move_to_diff_with_context": "请将光标移动到带有文件上下文的差异行",
+    "status.file_loading": "正在加载 %{file} 于 %{hash}...",
+    "status.file_not_found": "在提交 %{hash} 中未找到文件 %{file}",
+    "status.file_view_ready": "%{file} @ %{hash} (只读) | 目标: 第%{line}行 | q: 返回",
+    "status.failed_open_file": "无法打开 %{file}",
     "cmd.side_by_side_diff": "并排差异",
     "cmd.side_by_side_diff_desc": "并排显示当前文件的差异",
     "cmd.add_comment": "审查: 添加评论",

package/plugins/audit_mode.ts

@@ -4640,13 +4640,121 @@ async function review_branch_refresh(): Promise<void> {
 }
 registerHandler("review_branch_refresh", review_branch_refresh);
 
-/** Enter: focus the detail panel (so the user can scroll/click within it). */
+/** Is the detail panel the currently-focused buffer? */
+function isReviewBranchDetailFocused(): boolean {
+    return (
+        branchState.detailBufferId !== null &&
+        editor.getActiveBufferId() === branchState.detailBufferId
+    );
+}
+
+/** The currently-selected commit in the log panel, or null. */
+function selectedReviewBranchCommit(): GitCommit | null {
+    if (branchState.commits.length === 0) return null;
+    const i = Math.max(
+        0,
+        Math.min(branchState.selectedIndex, branchState.commits.length - 1),
+    );
+    return branchState.commits[i] ?? null;
+}
+
+/**
+ * Enter: on the log panel jumps focus into the detail panel; on the detail
+ * panel opens the file at the cursor position at the selected commit (if any).
+ */
 function review_branch_enter(): void {
     if (branchState.groupId === null) return;
+    if (isReviewBranchDetailFocused()) {
+        void review_branch_detail_open_file();
+        return;
+    }
     editor.focusBufferGroupPanel(branchState.groupId, "detail");
 }
 registerHandler("review_branch_enter", review_branch_enter);
 
+/**
+ * Open the file at the cursor's `(file, line)` text-properties at the
+ * currently-selected commit, in a read-only virtual buffer. Mirrors the
+ * git-log plugin's `git_log_detail_open_file` so users get the same
+ * drill-down from the review-branch detail panel.
+ */
+async function review_branch_detail_open_file(): Promise<void> {
+    if (branchState.detailBufferId === null) return;
+    const commit = selectedReviewBranchCommit();
+    if (!commit) return;
+
+    const props = editor.getTextPropertiesAtCursor(branchState.detailBufferId);
+    if (props.length === 0) {
+        editor.setStatus(editor.t("status.move_to_diff"));
+        return;
+    }
+    const file = props[0].file as string | undefined;
+    const line = (props[0].line as number | undefined) ?? 1;
+    if (!file) {
+        editor.setStatus(editor.t("status.move_to_diff_with_context"));
+        return;
+    }
+
+    editor.setStatus(
+        editor.t("status.file_loading", { file, hash: commit.shortHash }),
+    );
+    const result = await editor.spawnProcess("git", [
+        "show",
+        `${commit.hash}:${file}`,
+    ]);
+    if (result.exit_code !== 0) {
+        editor.setStatus(
+            editor.t("status.file_not_found", { file, hash: commit.shortHash }),
+        );
+        return;
+    }
+
+    const lines = result.stdout.split("\n");
+    const entries: TextPropertyEntry[] = lines.map((l, i) => ({
+        text: l + (i < lines.length - 1 ? "\n" : ""),
+        properties: { type: "content", line: i + 1 },
+    }));
+
+    // `*<hash>:<path>*` matches the virtual-name convention the host uses
+    // to detect syntax from the trailing filename's extension.
+    const name = `*${commit.shortHash}:${file}*`;
+    const view = await editor.createVirtualBuffer({
+        name,
+        mode: "review-branch-file-view",
+        readOnly: true,
+        editingDisabled: true,
+        showLineNumbers: true,
+        entries,
+    });
+    if (view) {
+        const byte = await editor.getLineStartPosition(Math.max(0, line - 1));
+        if (byte !== null) editor.setBufferCursor(view.bufferId, byte);
+        editor.setStatus(
+            editor.t("status.file_view_ready", {
+                file,
+                hash: commit.shortHash,
+                line: String(line),
+            }),
+        );
+    } else {
+        editor.setStatus(editor.t("status.failed_open_file", { file }));
+    }
+}
+registerHandler(
+    "review_branch_detail_open_file",
+    review_branch_detail_open_file,
+);
+
+/** Tab: toggle focus between the log and detail panels. */
+function review_branch_tab(): void {
+    if (branchState.groupId === null) return;
+    editor.focusBufferGroupPanel(
+        branchState.groupId,
+        isReviewBranchDetailFocused() ? "log" : "detail",
+    );
+}
+registerHandler("review_branch_tab", review_branch_tab);
+
 /** q/Escape: focus-back from detail, or close when already on log. */
 function review_branch_close_or_back(): void {
     if (branchState.groupId === null) return;
@@ -4683,9 +4791,11 @@ editor.defineMode(
         // from the Normal keymap via `inheritNormalBindings: true`.
         ["k", "move_up"],
         ["j", "move_down"],
-        // Enter: focus the right-hand detail panel.
+        // Enter: from the log, focus the detail panel; from the detail
+        // panel, open the file at the cursor at the selected commit.
         ["Return", "review_branch_enter"],
-        ["Tab", "review_branch_enter"],
+        // Tab: toggle focus between the log and detail panels.
+        ["Tab", "review_branch_tab"],
         ["r", "review_branch_refresh"],
         ["q", "review_branch_close_or_back"],
         ["Escape", "review_branch_close_or_back"],
@@ -4695,6 +4805,32 @@ editor.defineMode(
     true, // inheritNormalBindings — PageUp/PageDown/arrows/Home/End come from Normal
 );
 
+/** Close the file-view virtual buffer opened from the review-branch detail panel. */
+function review_branch_file_view_close(): void {
+    const id = editor.getActiveBufferId();
+    if (id) editor.closeBuffer(id);
+}
+registerHandler("review_branch_file_view_close", review_branch_file_view_close);
+
+// Mode for the read-only "git show <hash>:<file>" buffer opened from the
+// review-branch detail panel. Mirrors git-log's `git-log-file-view`:
+// q/Escape close the view, j/k alias Up/Down, and all other Normal
+// bindings (arrows, PageUp/Down, Home/End, Ctrl+C copy) are inherited so
+// unbound keys don't fall through to edit actions and trip the
+// `editing_disabled` status message (see #566).
+editor.defineMode(
+    "review-branch-file-view",
+    [
+        ["k", "move_up"],
+        ["j", "move_down"],
+        ["q", "review_branch_file_view_close"],
+        ["Escape", "review_branch_file_view_close"],
+    ],
+    true, // read-only
+    false, // allow_text_input
+    true, // inherit Normal-context bindings for unbound keys
+);
+
 // Register Modes and Commands
 editor.registerCommand("%cmd.review_diff", "%cmd.review_diff_desc", "start_review_diff", null);
 editor.registerCommand("%cmd.review_branch", "%cmd.review_branch_desc", "start_review_branch", null);

package/plugins/config-schema.json

@@ -133,7 +133,11 @@
         "width": "30%",
         "preview_tabs": true,
         "side": "left",
-        "auto_open_on_last_buffer_close": true
+        "auto_open_on_last_buffer_close": true,
+        "follow_active_buffer": false,
+        "compact_directories": true,
+        "tree_indicator_collapsed": ">",
+        "tree_indicator_expanded": "▼"
       }
     },
     "file_browser": {
@@ -792,7 +796,8 @@
             "{messages}"
           ],
           "x-section": "Status Bar",
-          "x-dual-list-sibling": "/editor/status_bar/right"
+          "x-dual-list-sibling": "/editor/status_bar/right",
+          "x-dynamically-extendable-status-bar-elements": true
         },
         "right": {
           "description": "Elements shown on the right side of the status bar.\nDefault: [\"{line_ending}\", \"{encoding}\", \"{language}\", \"{lsp}\", \"{warnings}\", \"{update}\", \"{palette}\"]",
@@ -810,7 +815,8 @@
             "{palette}"
           ],
           "x-section": "Status Bar",
-          "x-dual-list-sibling": "/editor/status_bar/left"
+          "x-dual-list-sibling": "/editor/status_bar/left",
+          "x-dynamically-extendable-status-bar-elements": true
         }
       }
     },
@@ -952,6 +958,26 @@
           "description": "Automatically focus the file explorer when the last buffer is\nclosed. Set to `false` for a \"blank workspace\" workflow where\nnothing opens automatically and the user explicitly invokes the\nfile explorer (e.g. via keybinding or command palette).\nDefault: true",
           "type": "boolean",
           "default": true
+        },
+        "follow_active_buffer": {
+          "description": "When the file explorer sidebar is open, automatically expand the\ntree and highlight the file that corresponds to the active buffer\nwhenever you switch tabs. Set to `true` to keep the explorer\nselection in sync with the active tab.\nDefault: false",
+          "type": "boolean",
+          "default": false
+        },
+        "compact_directories": {
+          "description": "Render single-child directory chains on a single line, e.g.\n`src/main/java/com/example`. Only applies when each intermediate\ndirectory in the chain is expanded and has exactly one visible\nchild that is itself a directory. Mirrors VSCode's\n`explorer.compactFolders`.\nDefault: true",
+          "type": "boolean",
+          "default": true
+        },
+        "tree_indicator_collapsed": {
+          "description": "Symbol shown next to a collapsed (closed) directory in the file\nexplorer tree. A short string (single character recommended).\nA trailing space is added automatically during rendering; the\nrenderer pads narrower indicators so collapsed/expanded rows align.\nDefault: \">\"",
+          "type": "string",
+          "default": ">"
+        },
+        "tree_indicator_expanded": {
+          "description": "Symbol shown next to an expanded (open) directory in the file\nexplorer tree. A short string (single character recommended).\nA trailing space is added automatically during rendering; the\nrenderer pads narrower indicators so collapsed/expanded rows align.\nDefault: \"▼\"",
+          "type": "string",
+          "default": "▼"
         }
       }
     },
@@ -1637,6 +1663,10 @@
             "null"
           ],
           "readOnly": true
+        },
+        "settings": {
+          "description": "Plugin-specific settings. The shape is defined by each plugin's\n`<plugin_name>.schema.json` sidecar file; the host stores the value as\nuntyped JSON so a malformed plugin schema can't poison the rest of the\nconfig. Plugins read this via `editor.getPluginConfig()` and the\nSettings UI renders it as a sub-category under \"Plugin Settings\".",
+          "readOnly": true
         }
       },
       "x-display-field": "/enabled"