@fresh-editor/fresh-editor 0.3.1 → 0.3.4

package/CHANGELOG.md

@@ -1,5 +1,143 @@
 # Release Notes
 
+## 0.3.4
+
+### Features
+
+* **Live Grep floating overlay + Utility Dock** (#1796): Live Grep now opens as a centered floating overlay with results on the left and a real-buffer file preview on the right (full syntax highlighting, gutter, soft-wrap). `Esc` returns you to your prior layout exactly. **Resume** (`Alt+r`) reopens the last query with cached results. **Export to Quickfix** (`Alt+M`) sends results into a dockable list.
+
+* New **Utility Dock** at the workspace root hosts the terminal (`` Alt+` ``), Quickfix, Diagnostics, and Find References — they share one pane spanning the full width instead of nesting under whichever split was focused.
+
+* **Pluggable Live Grep providers**: Built-in chain is now ripgrep → **git-grep (default in repos)** → grep, with `ag` / `ack` available via plugin registration. `Alt+P` cycles to the next available provider; the active one shows in the overlay's title bar. Plugins can register custom backends via `editor.getPluginApi("live-grep")`.
+
+* **Settings tree-view**: The left category list is now an expandable tree — categories with multiple sections show chevrons, expanding reveals jumpable section rows, and the tree cursor follows scrolling so you can see where you are in the body. Section jumps snap to the top of the section. Toggle controls render as a chip-style `[ ✓ ACTIVE ]` indicator.
+
+* **HDL language support** (#1528, reported by @bqinTT): Syntax highlighting for **Verilog** (`.v` left mapped to vlang for compatibility, `.vh`/`.verilog`), **SystemVerilog** (`.sv`/`.svh`/`.svi`/`.svp`), and **VHDL** (`.vhd`/`.vhdl`/`.vho`). `svls` wired as the default LSP for Verilog/SystemVerilog (opt-in per project).
+
+* **New `terminal` built-in theme** (#1457, #1798, reported by @AmethystGosling169 and @BrettKinny): Colors come from your terminal's own palette instead of hard-coded RGB — backgrounds use `Default` so transparency and your terminal's background show through; accents use ANSI named colors that remap to whatever your terminal colorscheme defines. Selection uses reverse-video so it inverts whatever colors are already on screen.
+
+* **Theme inheritance with `extends`**: User themes can now `extends: "builtin://light"` (or `dark` / `high-contrast` / `nostalgia` / `terminal`) and layer overrides on top — the same model VSCode/Helix/Sublime/Zed use. With no `extends`, an explicit `editor.bg` triggers luminance-based auto-inference (bright bg → light base, dim → dark), so partial light themes no longer end up with dark UI chrome (#1281, reported by @nico2004444).
+
+* **File explorer context-menu additions** (#1576, reported by @RandomGHUser): **Duplicate** (creates `name copy[.ext]` next to the source, multi-select supported), **Copy Full Path** and **Copy Relative Path** (newline-joined for multi-select). The new entries don't appear on the project root.
+
+* **Distribute clipboard across cursors** (#1057, reported by @graphixillusion): With N cursors and an N-line clipboard, paste now gives each cursor one line in top-to-bottom order — VSCode / Notepad++ "column-mode paste" semantics. A block-selected copy/paste round-trip preserves its rectangular shape. Behavior is unchanged when counts don't match.
+
+* **Discard option in quit prompt** (#1839, reported by @turkishmaid): With `hot_exit` on (the default), the unsaved-changes prompt now offers "(d)iscard and quit" so accidental edits no longer require disabling hot_exit globally to throw away. Picking "save" on quit also chains a Save As prompt for each dirty unnamed buffer instead of silently dropping it.
+
+* **Project name in window title** (#1793, reported by @dAnjou): Title is now `<file> — <project> — Fresh` so multiple Fresh sessions in different projects are distinguishable in your taskbar/window list.
+
+* **Cursor-jump animation toggle** (#1788): New `editor.cursor_jump_animation` setting lets you keep ambient animations (tab slides, dashboard) while disabling just the cursor-jump trail. The master `editor.animations` setting still wins.
+
+### Improvements
+
+* **Search & Replace across project no longer hangs on large binary files** (#1342, reported by @dragonfyre13): Hardcoded extension fast-path skips known-binary files (compiled artifacts, archives, media, ML weights, fonts) before any I/O. Per-file size cap and stronger header sniff (PNG, ZIP-based archives like `.pth`, ELF) catch the formats whose first bytes can look text-like.
+
+* **POSIX ACL writability** (#1765, reported by @cherouize): A file granted write access via `setfacl -m u:NAME:rw` is no longer reported read-only — Fresh now asks the kernel via `faccessat(W_OK)` instead of walking inode mode bits, so ACLs, capabilities, and read-only mounts are all honored.
+
+* **LSP status popup doesn't auto-show**: Auto-popping on first file open stole focus and swallowed keystrokes for users who hadn't asked to enable LSP. The `LSP` indicator is now a manual click target; its `Off` state (configured but not running) is rendered with a more prominent attention-grabbing color so discoverability isn't lost.
+
+* **Hover popup no longer flickers on mouse moves** (#692) inside the editor (gutter, end-of-line, between words). It only dismisses when the mouse leaves the editor area entirely. New hover responses replace the existing popup instead of stacking.
+
+* **Multi-cursor `Ctrl-D` after substring search** (#1697, reported by @dtwilliamson): When the cursor is inside an active search match, "Add cursor at next match" selects the next *search match* instead of expanding to the surrounding word.
+
+* **JavaScript syntax highlighting** (#899, reported by @comesuccingfuccsloot): Routed through tree-sitter, so template literals containing arrow functions or `${expr}` no longer leak `@string` styling across the rest of the file.
+
+* **Smarter auto-indent for Lua / Ruby / Bash / Pascal**: Tree-sitter `indents.scm` is now the single source of truth for keyword-delimited languages, so `(` opening a function call no longer gets treated as a block-opening delimiter.
+
+* **Enter at column 0 doesn't push the line right anymore** (#1425, reported by @goszlanyi): Auto-indent now detects "cursor at column 0 of a non-empty line" and inserts a bare newline. Closing-delimiter lines still get the established indent-before-close behavior.
+
+* **Live Diff virtual lines soft-wrap** (#1787) instead of being truncated at the right edge.
+
+* **Per-workspace hot-exit recovery** (#1550, reported by @goszlanyi): Standalone-mode recovery files are now scoped per working directory. Quitting Fresh in folder B no longer wipes folder A's recovered unnamed-buffer state.
+
+* **Terminal PTY resyncs on tab reveal** (#1795): Resizing the host while a terminal was hidden behind another tab now correctly forwards `SIGWINCH` when you switch back — `$COLUMNS` / `stty size` stay accurate.
+
+* **Open File dialog scrolls correctly on small terminals** (#245): Selection no longer slides past the bottom of the visible list.
+
+* **Keybinding editor scrollbar responds to mouse** (#1593, reported by @Kodiak-01): Click and drag both work; wheel scrolls the viewport instead of moving the selection (so a scrollbar drag isn't undone by the next wheel tick).
+
+* **Settings Number controls** (#1825, e.g. Tab Size): Tab now commits and exits the input; clicking the value cell enters edit mode (matches Enter).
+
+* **Plugin keybinding labels refresh on every prompt open** so plugins surfacing key hints ("`Alt+P` to cycle", overlay headers, etc.) reflect mid-session rebinds without restart.
+
+* **New plugin hook `after_file_explorer_change`** fires on FS-mutating explorer actions (Duplicate, Paste, New File, Rename, Delete) so plugins like git_explorer can refresh badges immediately.
+
+* **Theme picker consistency**: The Theme Editor plugin's picker now shows the same set of themes as the native `Select Theme` prompt — no more divergence from a separate `cwd/themes` scan or normalization mismatches. New plugin API `editor.getAllThemes()` returns the cached map directly so plugins can drop their own filesystem walks.
+
+### Bug Fixes
+
+* **Crash fixes**: `Option::unwrap()` panic when pasting in the Theme Editor (event apply used the wrong split). `DeleteBackward` panics on stale cursor state in vi-mode count prefixes and plugin action batches. Theme editor crash on the new `terminal` theme's modifier fields. Embedded-plugin extraction race across concurrent test processes.
+
+* **Search** (#1537, reported by @pstahle): `Find Selection Next/Previous` on a non-word character (e.g. `}` after goto-matching-bracket) no longer hijacks the search query — it now navigates the existing search instead.
+
+* **OpenLine (Emacs `C-o`)**: Cursor stays on the original line instead of advancing — was previously indistinguishable from Enter.
+
+* **Markdown compose** (#1789, #1790): Wrap budget widened by one column to prevent orphan-word re-wrapping on Windows; current-line highlight now extends across soft-wrapped sub-rows.
+
+* **Viewport** (#1794): Popup anchoring counts true visual rows under wrap, so completion popups appear next to the cursor instead of several rows above in heavily-wrapped buffers.
+
+### Under the Hood
+
+* **Smaller release binaries**: New `dist` cargo profile (`strip=true`, `lto=fat`, `codegen-units=1`, `opt-level=z`) is now applied to release builds. Binary shrinks from 62.4 MB → ~46 MB (-26%). Backtraces are still included in panics.
+
+* **Build performance**: `oxc` and `rquickjs` now build at `opt-level=3` in dev/test profiles to keep iteration fast despite their size.
+
+* **Semantic test framework + ~250 migrated cases**: A new "scenario" test layer dispatches `Action`s straight against an isolated editor instance, skipping plugin loading where the assertion surface (buffer text + caret) can't observe it — about 440 ms saved per test harness. ~250 e2e claims have been migrated across multicursor, block selection, auto-indent, paste, undo/redo, search-modal flows, multibyte handling, and many regression repros (issues #191, #1147, #1305, #1574, #1697, etc.). Property-based theorems over generated action sequences caught two real production crashes in no-render dispatch paths (vi-mode count prefixes, plugin action batches) — both fixed in this release. A pre-existing race in concurrent embedded-plugin extraction (could leave half-written plugins for parallel test processes) is also fixed.
+
+## 0.3.2
+
+### Features
+
+* **Live Diff plugin** (experimental): Unified-diff overlay rendered live in the editable buffer. If your file is unmodified in the editor, it updates as the file changes on disk when auto-revert kicks in - great for watching an agent edit your file. Opt-in via `Live Diff: Toggle (Global)` / `Live Diff: Toggle (Buffer)`. Reference selectable per buffer: `vs HEAD` / `vs Disk` / `vs Branch...` / `vs Default Branch`.
+
+* **New Startup section in Settings** (open Settings and search "Startup") groups everything that fires on launch:
+    - **Blank-workspace flow** (#1753) — *Auto Create Empty Buffer On Last Buffer Close* (Editor) and *Auto Open On Last Buffer Close* (File Explorer). With both off, closing the last buffer leaves a truly blank pane (no `[No Name]`, no gutter, no `~`); buffer-specific status-bar items and menu entries are suppressed, and a subdued centered hint shows the keys to escape (`Ctrl+P` / `Ctrl+O` / `Ctrl+E`).
+    - *Skip Session Restore When Files Passed* — `fresh src/main.rs` opens just that file; bare `fresh` and `fresh some/dir` still restore. Hot-exit recovery still runs. `--restore` overrides.
+    - *Restore Previous Session* (existing, moved into Startup).
+
+* **File explorer side** (thanks @paveloparev!): *Side* under File Explorer in Settings — left or right.
+
+* **Prompt Line now hidden by default**: *Show Prompt Line* now defaults off — the prompt line only appears while a prompt is active. Turn it back on via Settings.
+
+* **Mark mode preserved through Go to Line** so you can extend selections across the jump. Use **Set Mark** command followed by **Goto Line** to start a selection and extend it to the target line.
+
+* **Copy File Path commands**: New commands: "Copy File Path" and "Copy Relative File Path" to copy current buffer's path to your clipboard. Also available by right-clicking on a tab name.
+
+* **CLI Help Localization**: The `--help` output is now fully localized using runtime i18n lookups.
+
+* **Relative +/- Goto Line**: Infers absolute vs relative jumps from a leading sign (e.g., `:+10` jumps 10 lines down, `:10` jumps to line 10).
+
+* **Rust Toolchain Update**: Updated to Rust 1.95 in `rust-toolchain.toml` to fix compatibility issues with newer LLVM/clang versions on systems like Arch Linux (#1782).
+
+### Improvements
+
+* **Plugin loading deferred off the boot critical path** — another ~225 ms saved. Same load order, same hooks, just async.
+
+* **Popup focus**: LSP popups that auto-show on file open (status popup, hover, signature help, plugin Text overlays) no longer steal the next keystroke. They show unfocused with an `[Alt+T to focus]` hint; user-invoked popups (Completion, code actions, status-bar `{remote}`, LSP-status menu) still grab focus on show. Settings / Menu / Prompt modals take precedence over unfocused buffer popups for `Esc` / `popup_focus`.
+
+* **Status Bar visual integration** (#1711): The "Palette: Ctrl+P" hint and "LSP (on)" indicator now blend into the status bar by default. Built-in themes have been updated with coherent prominent colors for these indicators.
+
+* **Prompt interaction and scrolling** (#1660):
+    - Minimal scrolling: the suggestion list no longer recenters the selection on every move, preventing "row jumping" during navigation.
+    - Clicks no longer cause accidental list shifts; double-click correctly confirms selections.
+    - Preview-on-click supported for "Reload with encoding".
+
+* **Global Menu Bar**: "Toggle Menu Bar" state is now persisted globally across all workspaces.
+
+* **Windows integration**: High-quality app icon applied to the running window; app manifest and version info embedded in the binary.
+
+### Bug Fixes
+
+* **Windows subprocesses**: Transient console windows are now hidden when spawning subprocesses (e.g., formatters, linters).
+
+* **Terminal CWD**: Fixed shell spawning failure on Windows when the current directory has a `\\?\` UNC prefix.
+
+* **Live Diff stability**: Fixed crashes on surrogate-pair content (emojis) and corrected gutter rendering for empty lines inside added blocks.
+
+### Under the Hood
+
+* **Syntax Highlight Caching**: New multi-phase caching system (memoised scope lookups and whole-file cache for small files) significantly reduces CPU usage during rendering.
+
 ## 0.3.1
 
 ### Features

package/package.json

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

package/plugins/config-schema.json

@@ -31,6 +31,7 @@
       "$ref": "#/$defs/EditorConfig",
       "default": {
         "animations": true,
+        "cursor_jump_animation": true,
         "line_numbers": true,
         "relative_line_numbers": false,
         "highlight_current_line": true,
@@ -63,7 +64,7 @@
             "{palette}"
           ]
         },
-        "show_prompt_line": true,
+        "show_prompt_line": false,
         "show_vertical_scrollbar": true,
         "show_horizontal_scrollbar": false,
         "show_tilde": true,
@@ -103,6 +104,8 @@
         "auto_save_interval_secs": 30,
         "hot_exit": true,
         "restore_previous_session": true,
+        "skip_session_restore_when_files_passed": true,
+        "auto_create_empty_buffer_on_last_buffer_close": true,
         "recovery_enabled": true,
         "auto_recovery_save_interval_secs": 2,
         "auto_revert_poll_interval_ms": 2000,
@@ -128,7 +131,9 @@
         "show_gitignored": false,
         "custom_ignore_patterns": [],
         "width": "30%",
-        "preview_tabs": true
+        "preview_tabs": true,
+        "side": "left",
+        "auto_open_on_last_buffer_close": true
       }
     },
     "file_browser": {
@@ -243,7 +248,8 @@
         "dark",
         "light",
         "high-contrast",
-        "nostalgia"
+        "nostalgia",
+        "terminal"
       ]
     },
     "LocaleOptions": {
@@ -276,6 +282,12 @@
           "default": true,
           "x-section": "Display"
         },
+        "cursor_jump_animation": {
+          "description": "Enable the cursor-jump trail animation on long cursor moves\n(search jumps, go-to-definition, pane switches). Has no effect\nwhen `animations` is `false`.",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Display"
+        },
         "line_numbers": {
           "description": "Show line numbers in the gutter (default for new buffers)",
           "type": "boolean",
@@ -389,9 +401,9 @@
           "x-section": "Status Bar"
         },
         "show_prompt_line": {
-          "description": "Whether the prompt line is visible by default.\nThe prompt line is the bottom-most line used for command input, search, file open, etc.\nWhen hidden, the prompt line only appears when a prompt is active.\nCan be toggled at runtime via command palette or keybinding.\nDefault: true",
+          "description": "Whether the prompt line is always visible.\nThe prompt line is the bottom-most line used for search, file open, and other prompts.\nWhen `false` (the default), the prompt line auto-hides — it only appears\nwhile a prompt is active and disappears again once the prompt closes.\nWhen `true`, the prompt line is always reserved at the bottom of the screen.\nDefault: false",
           "type": "boolean",
-          "default": true,
+          "default": false,
           "x-section": "Display"
         },
         "show_vertical_scrollbar": {
@@ -643,7 +655,19 @@
           "description": "Whether to auto-open previously opened files (session restore) when\nstarting Fresh in a directory.  When enabled (the default), tabs,\nsplits, cursor positions and the file explorer state are restored\nfrom the last clean exit in the same working directory.  When\ndisabled, Fresh starts with a clean workspace.  The workspace file\non disk is still written on exit, so re-enabling this setting picks\nup whatever state was saved at the most recent clean exit.  The\n`--no-restore` CLI flag is a stronger override: it skips both\nrestoring and saving the workspace.\nDefault: true",
           "type": "boolean",
           "default": true,
-          "x-section": "Recovery"
+          "x-section": "Startup"
+        },
+        "skip_session_restore_when_files_passed": {
+          "description": "When Fresh is launched with one or more file arguments (e.g.\n`fresh src/main.rs README.md`), skip the workspace session restore\nand open only the files passed on the command line. Hot-exit\ncontent (unsaved modified files and unnamed `[No Name]` buffers\nwith content) is still restored so in-progress work is never lost.\nPure-directory invocations (`fresh some/dir`) and bare invocations\n(`fresh` with no args) still restore the previous session normally.\nDisable this option to keep the legacy behavior of always\nrestoring the previous session even when files are passed.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Startup"
+        },
+        "auto_create_empty_buffer_on_last_buffer_close": {
+          "description": "Whether to auto-create a fresh empty `[No Name]` buffer when the\nlast open buffer is closed. When `false`, the editor still creates\nan internal placeholder buffer (it always needs at least one) but\nhides it from the tab bar so the workspace looks blank. Combined\nwith `file_explorer.auto_open_on_last_buffer_close = false`, this\ngives a fully blank workspace where nothing opens automatically.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Startup"
         },
         "recovery_enabled": {
           "description": "Whether to enable file recovery (Emacs-style auto-save)\nWhen enabled, buffers are periodically saved to recovery files\nso they can be recovered if the editor crashes.",
@@ -918,6 +942,16 @@
           "description": "Open files in a \"preview\" (ephemeral) tab on single-click in the\nfile explorer. The preview tab is replaced by the next single-click\ninstead of accumulating tabs. Editing the file, double-clicking\n(or pressing Enter) on it in the explorer, or dragging its tab\npromotes the tab to a permanent tab.\nDefault: true",
           "type": "boolean",
           "default": true
+        },
+        "side": {
+          "description": "Which side of the screen to show the file explorer on.\nDefault: left",
+          "$ref": "#/$defs/FileExplorerSide",
+          "default": "left"
+        },
+        "auto_open_on_last_buffer_close": {
+          "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
         }
       }
     },
@@ -926,6 +960,14 @@
       "type": "string",
       "pattern": "^(100%|[1-9]?[0-9]%|\\d+)$"
     },
+    "FileExplorerSide": {
+      "description": "Side placement for the file explorer panel.",
+      "type": "string",
+      "enum": [
+        "left",
+        "right"
+      ]
+    },
     "FileBrowserConfig": {
       "description": "File browser configuration (for Open File dialog)",
       "type": "object",

package/plugins/diagnostics_panel.ts

@@ -126,6 +126,10 @@ const finder = new Finder<DiagnosticItem>(editor, {
   groupBy: "file",
   syncWithEditor: true,
   navigateOnCursorMove: true,
+  // Diagnostics is a generic "list of locations" UX — route into
+  // the shared Utility Dock so it shares space with Quickfix,
+  // search-replace results, etc. See issue #1796.
+  useUtilityDock: true,
   onClose: () => {
     isOpen = false;
     sourceBufferId = null;

package/plugins/diff_nav.ts

@@ -22,6 +22,13 @@ interface DiffHunk {
   lineCount: number;
 }
 
+/** Hunk shape published by live_diff.ts on `live_diff_hunks` view state. */
+interface LiveDiffHunk {
+  kind: "added" | "removed" | "modified";
+  newStart: number; // 0-indexed
+  newCount: number;
+}
+
 /** A jump target with a byte position for sorting/deduplication */
 interface JumpTarget {
   bytePos: number;
@@ -47,7 +54,19 @@ async function collectTargets(bid: number): Promise<JumpTarget[]> {
     }
   }
 
-  // Source 2: saved-diff (unsaved changes)
+  // Source 2: live-diff hunks (head/disk/branch comparison from live_diff.ts)
+  const liveHunks = editor.getViewState(bid, "live_diff_hunks") as LiveDiffHunk[] | null;
+  if (liveHunks && liveHunks.length > 0) {
+    for (const hunk of liveHunks) {
+      const line = Math.max(0, hunk.newStart);
+      const pos = await editor.getLineStartPosition(line);
+      if (pos !== null) {
+        targets.push({ bytePos: pos, line });
+      }
+    }
+  }
+
+  // Source 3: saved-diff (unsaved changes)
   const diff = editor.getBufferSavedDiff(bid);
   if (diff && !diff.equal) {
     for (const [start, _end] of diff.byte_ranges) {

package/plugins/find_references.ts

@@ -40,6 +40,10 @@ const finder = new Finder<ReferenceLocation>(editor, {
   },
   preview: true,
   maxResults: 100,
+  // Find References is a generic "list of locations" UX — share
+  // the Utility Dock with Diagnostics, Quickfix, search-replace
+  // results, etc. See issue #1796.
+  useUtilityDock: true,
 });
 
 // Pending references for the current prompt

package/plugins/flash.ts

@@ -493,10 +493,19 @@ async function flashJump(): Promise<void> {
   // enough to survive status-bar truncation.  Includes the current
   // pattern so tests (and careful users) can confirm the plugin has
   // accepted each typed key.
+  //
+  // The banner doubles as a synchronization barrier for tests: as long
+  // as setStatus runs AFTER redraw within the same loop iteration, any
+  // observer that sees `Flash[<pattern>]` on screen is guaranteed to
+  // also see the conceals/labels for that same pattern — they were
+  // committed in the redraw immediately before.  Setting the banner
+  // earlier (e.g. in the keypress handler before `continue`) breaks
+  // this invariant: the new banner reaches the screen while the
+  // previous iteration's conceals are still painted, so a renderer
+  // tick in that window shows banner=N with conceals=N-1.
   const setStatusForPattern = (): void => {
     editor.setStatus("Flash[" + state.pattern + "]");
   };
-  setStatusForPattern();
 
   try {
     while (true) {
@@ -522,6 +531,7 @@ async function flashJump(): Promise<void> {
         if (m.label) state.prevLabelByKey.set(matchKey(m), m.label);
       }
       redraw(state.matches, views);
+      setStatusForPattern();
 
       const ev = await editor.getNextKey();
 
@@ -538,7 +548,6 @@ async function flashJump(): Promise<void> {
         if (state.pattern.length > 0) {
           state.pattern = state.pattern.slice(0, -1);
         }
-        setStatusForPattern();
         continue;
       }
 
@@ -551,7 +560,6 @@ async function flashJump(): Promise<void> {
           break;
         }
         state.pattern += ev.key;
-        setStatusForPattern();
         continue;
       }
 

package/plugins/git_explorer.ts

@@ -117,9 +117,14 @@ async function refreshGitExplorerDecorations() {
       return;
     }
 
+    // -z gives NUL-terminated, raw (unquoted) paths. Without it git
+    // wraps any path containing spaces or special chars in double
+    // quotes (e.g. `?? "name copy.txt"`), which the parser would then
+    // key the decoration against — meaning the actual on-disk path
+    // never matches and the badge never appears next to the file.
     const statusResult = await editor.spawnProcess(
       "git",
-      ["status", "--porcelain"],
+      ["status", "--porcelain", "-z"],
       repoRoot
     );
     if (statusResult.exit_code !== 0) {
@@ -155,6 +160,9 @@ editor.on("after_file_open", () => {
 editor.on("after_file_save", () => {
   refreshGitExplorerDecorations();
 });
+editor.on("after_file_explorer_change", () => {
+  refreshGitExplorerDecorations();
+});
 editor.on("editor_initialized", () => {
   refreshGitExplorerDecorations();
 });

package/plugins/lib/finder.ts

@@ -118,6 +118,21 @@ export interface FinderConfig<T> {
 
   /** Called when the panel or prompt is closed (e.g. via Escape) */
   onClose?: () => void;
+
+  /**
+   * When true, panels created by this Finder are routed into the
+   * shared Utility Dock (issue #1796 / Section 2 of
+   * `docs/internal/tui-editor-layout-design.md`). The first
+   * dock-aware utility creates the dock leaf; subsequent ones swap
+   * the dock's active buffer instead of spawning new splits.
+   *
+   * Defaults to `false` so panels with bespoke layouts (e.g.
+   * `theme_editor`'s buffer groups, `pkg`'s side-by-side panes)
+   * keep their independent split. Plugins that present a generic
+   * "list of locations" UX (Diagnostics, Find References, Live
+   * Grep Quickfix) should opt in.
+   */
+  useUtilityDock?: boolean;
 }
 
 /**
@@ -128,6 +143,14 @@ export interface PromptOptions<T> {
   source: SearchSource<T> | FilterSource<T>;
   /** Initial query value */
   initialQuery?: string;
+  /**
+   * Render the prompt as a centred floating overlay with an
+   * embedded preview pane (issue #1796). When true, the editor
+   * draws the input + results + preview inside one floating frame
+   * over the editor area; the underlying split tree is not
+   * mutated. Defaults to false.
+   */
+  floatingOverlay?: boolean;
 }
 
 /**
@@ -277,7 +300,16 @@ export function defaultFuzzyFilter<T>(
 // ============================================================================
 
 /**
- * Parse a grep-style output line (file:line:column:content)
+ * Parse a grep-style output line.
+ *
+ * Accepts both `file:line:column:content` (ripgrep, ag, git-grep with
+ * `--column`, GNU grep with `--column`) and `file:line:content`
+ * (POSIX grep, BSD grep, plenty of custom wrappers that omit the
+ * column). When the column is missing it defaults to 1.
+ *
+ * Returns null only if the line lacks even a `file:line:` prefix —
+ * pure header lines (ripgrep without `--no-heading`, blank lines)
+ * are filtered upstream by the caller's `if (!line.trim()) continue`.
  */
 export function parseGrepLine(line: string): {
   file: string;
@@ -285,13 +317,25 @@ export function parseGrepLine(line: string): {
   column: number;
   content: string;
 } | null {
-  const match = line.match(/^([^:]+):(\d+):(\d+):(.*)$/);
-  if (match) {
+  // Try the four-field shape first so a content payload that
+  // happens to start with digits (e.g. `42 = solve(...)`) doesn't
+  // get mistaken for a column number under the three-field path.
+  const four = line.match(/^([^:]+):(\d+):(\d+):(.*)$/);
+  if (four) {
     return {
-      file: match[1],
-      line: parseInt(match[2], 10),
-      column: parseInt(match[3], 10),
-      content: match[4],
+      file: four[1],
+      line: parseInt(four[2], 10),
+      column: parseInt(four[3], 10),
+      content: four[4],
+    };
+  }
+  const three = line.match(/^([^:]+):(\d+):(.*)$/);
+  if (three) {
+    return {
+      file: three[1],
+      line: parseInt(three[2], 10),
+      column: 1,
+      content: three[3],
     };
   }
   return null;
@@ -465,20 +509,42 @@ export class Finder<T> {
     }
 
     // Start the prompt
+    const overlay = options.floatingOverlay === true;
     if (options.initialQuery) {
       this.editor.startPromptWithInitial(
         options.title,
         this.config.id,
-        options.initialQuery
+        options.initialQuery,
+        overlay
       );
     } else {
-      this.editor.debug(`[Finder] calling startPrompt with title="${options.title}", id="${this.config.id}"`);
-      const result = this.editor.startPrompt(options.title, this.config.id);
+      this.editor.debug(`[Finder] calling startPrompt with title="${options.title}", id="${this.config.id}", overlay=${overlay}`);
+      const result = this.editor.startPrompt(options.title, this.config.id, overlay);
       this.editor.debug(`[Finder] startPrompt returned: ${result}`);
     }
     this.editor.setStatus("Type to search...");
   }
 
+  /**
+   * Re-run the current search against `lastQuery`, bypassing the
+   * "skip-if-same-query" dedup. Useful when the *backend* has
+   * changed (e.g. user cycled Live Grep providers) and the same
+   * query needs to produce different results.
+   *
+   * No-op for filter-mode sources (results are already correct
+   * client-side) and when no prompt is open.
+   */
+  async refresh(): Promise<void> {
+    if (!this.isPromptMode || !this.currentSource) return;
+    if (this.currentSource.mode !== "search") return;
+    const query = this.promptState.lastQuery;
+    // Reset dedup so runSearch doesn't short-circuit on the
+    // unchanged query.
+    this.promptState.lastQuery = "";
+    if (query.length === 0) return;
+    await this.runSearch(query, this.currentSource);
+  }
+
   /**
    * Show static results in panel
    */
@@ -1095,6 +1161,11 @@ export class Finder<T> {
         ratio,
         direction: "horizontal",
         panelId: this.config.id,
+        // Per-finder opt-in via `useUtilityDock` — many Finder
+        // consumers (theme_editor's buffer groups, pkg's side-by-
+        // side panes, …) need their own independent splits and
+        // would break if routed into the shared dock.
+        ...(this.config.useUtilityDock ? { role: "utility_dock" } : {}),
         showLineNumbers: false,
         showCursors: true,
         editingDisabled: true,

package/plugins/lib/fresh.d.ts

@@ -821,6 +821,13 @@ type CreateVirtualBufferInSplitOptions = {
 	* Initial content entries with optional properties
 	*/
 	entries?: Array<TextPropertyEntry>;
+	/**
+	* Split role tag. When set to `"utility_dock"`, the dispatcher
+	* routes this buffer to the existing dock leaf if one exists,
+	* instead of creating a new split. See
+	* `docs/internal/tui-editor-layout-design.md` Section 2.
+	*/
+	role?: string;
 };
 type CreateVirtualBufferOptions = {
 	/**
@@ -1458,6 +1465,11 @@ interface EditorAPI {
 	*/
 	getBuiltinThemes(): unknown;
 	/**
+	* Full theme registry (builtins + user themes + packages + bundles).
+	* Keyed by canonical registry key; each value carries `_key` / `_pack`.
+	*/
+	getAllThemes(): unknown;
+	/**
 	* Delete a custom theme (alias for deleteThemeSync)
 	*/
 	deleteTheme(name: string): boolean;
@@ -1668,9 +1680,15 @@ interface EditorAPI {
 	*/
 	prompt(label: string, initialValue: string): Promise<string | null>;
 	/**
-	* Start an interactive prompt
+	* Start an interactive prompt.
+	* 
+	* When `floatingOverlay` is true, the editor renders the prompt
+	* and its suggestions inside a centred floating frame instead of
+	* the bottom minibuffer row (issue #1796 — Live Grep). The flag
+	* is rendering-only; confirm/cancel/hooks behave identically to a
+	* non-overlay prompt of the same `promptType`.
 	*/
-	startPrompt(label: string, promptType: string): boolean;
+	startPrompt(label: string, promptType: string, floatingOverlay?: boolean): boolean;
 	/**
 	* Begin a key-capture window for the calling plugin.
 	* 
@@ -1704,9 +1722,10 @@ interface EditorAPI {
 	*/
 	getNextKey(): Promise<KeyEventPayload>;
 	/**
-	* Start a prompt with initial value
+	* Start a prompt with initial value. See `startPrompt` for the
+	* meaning of `floatingOverlay`.
 	*/
-	startPromptWithInitial(label: string, promptType: string, initialValue: string): boolean;
+	startPromptWithInitial(label: string, promptType: string, initialValue: string, floatingOverlay?: boolean): boolean;
 	/**
 	* Set suggestions for the current prompt
 	* 
@@ -1715,6 +1734,13 @@ interface EditorAPI {
 	setPromptSuggestions(suggestions: PromptSuggestion[]): boolean;
 	setPromptInputSync(sync: boolean): boolean;
 	/**
+	* Set the title shown in the floating-overlay prompt's frame
+	* header (issue #1796). Pass `null` or omit the argument to
+	* clear the title and fall back to the default. Has no
+	* visible effect on non-overlay prompts.
+	*/
+	setPromptTitle(title?: string | null): boolean;
+	/**
 	* Define a buffer mode (takes bindings as array of [key, command] pairs)
 	*/
 	defineMode(name: string, bindingsArr: string[][], readOnly?: boolean, allowTextInput?: boolean, inheritNormalBindings?: boolean): boolean;
@@ -2099,6 +2125,16 @@ interface HookEventMap {
 		path: string;
 		buffer_id: number;
 	};
+	/**
+	* Fired by the file explorer after a paste/duplicate/etc. mutates
+	* the filesystem without going through a buffer save. Plugins that
+	* surface FS-derived state (git status badges, etc.) should
+	* subscribe in addition to `after_file_save` to refresh on
+	* explorer-driven changes too.
+	*/
+	after_file_explorer_change: {
+		path: string;
+	};
 	// ── text edits ───────────────────────────────────────────────────────────
 	before_insert: {
 		buffer_id: number;