@fresh-editor/fresh-editor 0.3.6 → 0.3.7

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fresh-editor/fresh-editor",
-  "version": "0.3.6",
+  "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

@@ -134,7 +134,10 @@
         "preview_tabs": true,
         "side": "left",
         "auto_open_on_last_buffer_close": true,
-        "follow_active_buffer": false
+        "follow_active_buffer": false,
+        "compact_directories": true,
+        "tree_indicator_collapsed": ">",
+        "tree_indicator_expanded": "▼"
       }
     },
     "file_browser": {
@@ -793,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}\"]",
@@ -811,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
         }
       }
     },
@@ -958,6 +963,21 @@
           "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": "▼"
         }
       }
     },
@@ -1643,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"

package/plugins/dashboard.ts

@@ -1586,18 +1586,20 @@ async function dashboardShowOrFocus() {
 registerHandler("dashboardShowOrFocus", dashboardShowOrFocus);
 
 // Auto-open resolution: the session override (set via the exported
-// plugin API from init.ts) wins over the user config. We read from
-// getUserConfig (raw file) rather than getConfig because unknown
-// fields are dropped when the Config struct reserializes. Default
-// is true.
+// plugin API from init.ts) wins over the user-configured value, which
+// comes from the typed plugin-config field declared below. The field
+// shows up in the Settings UI under "Plugin Settings → dashboard".
+editor.defineConfigBoolean("autoOpen", {
+    default: true,
+    description: "Show the dashboard automatically when Fresh starts with no real files open.",
+});
+
 let autoOpenOverride: boolean | null = null;
 
 function autoOpenEnabled(): boolean {
     if (autoOpenOverride !== null) return autoOpenOverride;
-    const cfg = editor.getUserConfig() as Record<string, unknown> | null;
-    const plugins = cfg?.plugins as Record<string, unknown> | undefined;
-    const dashboard = plugins?.dashboard as Record<string, unknown> | undefined;
-    return dashboard?.["auto-open"] !== false;
+    const cfg = (editor.getPluginConfig() ?? {}) as { autoOpen?: boolean };
+    return cfg.autoOpen !== false;
 }
 
 function shouldShowDashboard(): boolean {
@@ -1801,12 +1803,14 @@ editor.exportPluginApi("dashboard", {
 // `plugins.dashboard.enabled` is true in the resolved config — so the
 // standard settings UI is the single enable/disable surface.
 //
-// If the plugin loads mid-session (user toggles it on in Settings),
-// the `ready` hook has already fired, so we also run an immediate
-// check. At startup the `listBuffers().length > 0` guard keeps us
-// dormant until the workspace has actually restored: plugins load
-// before restore, and opening a buffer here would race with the
-// restore and leave a stray Dashboard tab even when real files exist.
+// Auto-open is driven exclusively by the `ready` hook (and the
+// `buffer_closed` handler for the last-tab-closed case). We
+// deliberately do NOT auto-open at module load: dashboard.ts loads
+// during the startup plugin batch, *before* the user's init.ts has
+// been evaluated, so an immediate auto-open would race
+// `setAutoOpen(false)` and dismiss the user's preference. Users who
+// hot-load the plugin mid-session (toggle on in Settings) get the
+// dashboard via the "Show Dashboard" command in the palette.
 editor.on("ready", "dashboardOnReady");
 editor.on("buffer_closed", "dashboardOnBufferClosed");
 editor.on("viewport_changed", "dashboardOnViewportChanged");
@@ -1820,7 +1824,3 @@ editor.registerCommand(
     "Open the dashboard, or bring it to the front if it's already open",
     "dashboardShowOrFocus",
 );
-
-if (editor.listBuffers().length > 0 && shouldShowDashboard()) {
-    openDashboard();
-}

package/plugins/flash.ts

@@ -33,7 +33,24 @@ const VTEXT_PREFIX = "flash-";
 // the closest jump targets get the most comfortable keys.  All
 // lowercase: case-sensitive matching keeps the label letter from also
 // being a valid pattern continuation, which matters for the skip rule.
-const LABEL_POOL = "asdfghjklqwertyuiopzxcvbnm";
+editor.defineConfigString("labelPool", {
+  default: "asdfghjklqwertyuiopzxcvbnm",
+  description: "Characters used as jump labels, in comfort order. Labels are assigned to matches by distance from the cursor, so leftmost characters here land on the nearest matches.",
+});
+editor.defineConfigBoolean("skipRule", {
+  default: true,
+  description: "Skip a label character if it is also the next character after a match — prevents ambiguity between extending the search pattern and jumping.",
+});
+
+function flashSettings(): { labelPool: string; skipRule: boolean } {
+  const cfg = (editor.getPluginConfig() ?? {}) as { labelPool?: string; skipRule?: boolean };
+  return {
+    labelPool: cfg.labelPool && cfg.labelPool.length > 0
+      ? cfg.labelPool
+      : "asdfghjklqwertyuiopzxcvbnm",
+    skipRule: cfg.skipRule ?? true,
+  };
+}
 
 interface Match {
   /** Byte offset where the match starts in its buffer. */
@@ -334,9 +351,10 @@ function assignLabels(
   prevLabelByKey: Map<string, string>,
 ): Match[] {
   if (matches.length === 0) return matches;
-  const skip = buildSkipSet(matches, views, emptyPattern);
+  const { labelPool, skipRule } = flashSettings();
+  const skip = skipRule ? buildSkipSet(matches, views, emptyPattern) : new Set<string>();
   const remaining = new Set<string>();
-  for (const c of LABEL_POOL) if (!skip.has(c)) remaining.add(c);
+  for (const c of labelPool) if (!skip.has(c)) remaining.add(c);
 
   const sorted = sortMatches(matches, startSplitId, startCursor);
 
@@ -353,7 +371,7 @@ function assignLabels(
   // matches in distance order.  Iterate the pool in its native
   // (comfort-ranked) order so home-row letters go to nearest matches.
   const orderedRemaining: string[] = [];
-  for (const c of LABEL_POOL) if (remaining.has(c)) orderedRemaining.push(c);
+  for (const c of labelPool) if (remaining.has(c)) orderedRemaining.push(c);
   let next = 0;
   for (const m of sorted) {
     if (m.label) continue;