@fresh-editor/fresh-editor 0.3.2 → 0.3.5

package/CHANGELOG.md

@@ -1,5 +1,105 @@
 # Release Notes
 
+## 0.3.5
+
+### Improvements
+
+* **Live Grep overlay polish**: Surrounding editor is now visibly dimmed; shortcut hints and the active provider moved into a toolbar row with plainer labels; match cap raised from 100 to 1000 (with a `1000+ matches` indicator); provider errors render as a disabled result entry instead of a silent "0 matches"; `ripgrep` provider renamed to `rg`.
+
+### Bug Fixes
+
+* **Live Grep on Windows returned no results**: `git grep` outputs `\r\n`; splitting on `\n` left a trailing `\r` that broke the result regex. Split on `\r?\n` instead.
+
+* **Plain `grep` provider was broken**: `--column` is a ripgrep-only flag and was being passed unconditionally. Removed.
+
+### Under the Hood
+
+* **Plugin API: `setPromptTitle` takes styled segments** (`{ text, style? }[]`) instead of a single string, so plugins control hint colouring directly instead of the renderer guessing structure from punctuation.
+
+## 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fresh-editor/fresh-editor",
-  "version": "0.3.2",
+  "version": "0.3.5",
   "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,
@@ -247,7 +248,8 @@
         "dark",
         "light",
         "high-contrast",
-        "nostalgia"
+        "nostalgia",
+        "terminal"
       ]
     },
     "LocaleOptions": {
@@ -280,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",

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/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/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/git_grep.ts

@@ -48,8 +48,10 @@ async function searchWithGitGrep(query: string): Promise<GrepMatch[]> {
   );
 
   if (result.exit_code === 0) {
-    return parseGrepOutput(result.stdout, 100) as GrepMatch[];
+    return parseGrepOutput(result.stdout, 100, (msg) => editor.debug(msg)) as GrepMatch[];
   }
+  editor.error(`[git_grep] process exited with code ${result.exit_code}: ${result.stderr}`);
+  editor.setStatus(`git grep failed (exit ${result.exit_code})`);
   return [];
 }
 

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: four[1],
+      line: parseInt(four[2], 10),
+      column: parseInt(four[3], 10),
+      content: four[4],
+    };
+  }
+  const three = line.match(/^([^:]+):(\d+):(.*)$/);
+  if (three) {
     return {
-      file: match[1],
-      line: parseInt(match[2], 10),
-      column: parseInt(match[3], 10),
-      content: match[4],
+      file: three[1],
+      line: parseInt(three[2], 10),
+      column: 1,
+      content: three[3],
     };
   }
   return null;
@@ -302,7 +346,8 @@ export function parseGrepLine(line: string): {
  */
 export function parseGrepOutput(
   stdout: string,
-  maxResults: number = 100
+  maxResults: number = 100,
+  debug?: (msg: string) => void
 ): Array<{ file: string; line: number; column: number; content: string }> {
   const results: Array<{
     file: string;
@@ -311,14 +356,16 @@ export function parseGrepOutput(
     content: string;
   }> = [];
 
-  for (const line of stdout.split("\n")) {
-    if (!line.trim()) continue;
+  for (const line of stdout.split(/\r?\n/)) {
+    if (!line) continue;
     const match = parseGrepLine(line);
     if (match) {
       results.push(match);
       if (results.length >= maxResults) {
         break;
       }
+    } else if (debug) {
+      debug(`[parseGrepOutput] failed to parse line: ${line}`);
     }
   }
 
@@ -465,20 +512,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
    */
@@ -718,7 +787,8 @@ export class Finder<T> {
           // Parse as grep output by default
           const parsed = parseGrepOutput(
             result.stdout,
-            this.config.maxResults
+            this.config.maxResults,
+            (msg) => this.editor.debug(msg)
           ) as unknown as T[];
           this.updatePromptResults(parsed);
 
@@ -761,9 +831,26 @@ export class Finder<T> {
       }
     } catch (e) {
       const errorMsg = String(e);
-      if (!errorMsg.includes("killed") && !errorMsg.includes("not found")) {
-        this.editor.setStatus(`Search error: ${e}`);
+      // "killed" / "not found" come from the cancellation path (a
+      // newer search aborted this one). Suppress those entirely —
+      // the user didn't ask for them.
+      if (errorMsg.includes("killed") || errorMsg.includes("not found")) {
+        return;
       }
+      // Render the error inside the overlay's result list itself.
+      // The status bar is shared and clobbered by other code paths,
+      // so it's not a reliable place to surface a feature-scoped
+      // error — the overlay is where the user is looking.
+      this.promptState.results = [];
+      this.promptState.entries = [];
+      const display = errorMsg.replace(/^Error:\s*/, "");
+      this.editor.setPromptSuggestions([
+        {
+          text: `⚠ ${display}`,
+          value: "",
+          disabled: true,
+        },
+      ]);
     }
   }
 
@@ -1095,6 +1182,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 = {
 	/**
@@ -982,6 +989,10 @@ type SpawnResult = {
 	*/
 	exit_code: number;
 };
+type StyledText = {
+	text: string;
+	style?: Partial<OverlayOptions>;
+};
 type TextPropertiesAtCursor = Array<Record<string, unknown>>;
 type TsHighlightSpan = {
 	start: number;
@@ -1458,6 +1469,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 +1684,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 +1726,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 +1738,18 @@ interface EditorAPI {
 	setPromptSuggestions(suggestions: PromptSuggestion[]): boolean;
 	setPromptInputSync(sync: boolean): boolean;
 	/**
+	* Set the title shown in the floating-overlay prompt's frame
+	* header (issue #1796) as styled segments. Each segment
+	* carries optional `Partial<OverlayOptions>`, the same
+	* styling primitive used by virtual text — plugins mark
+	* keybinding hints with `{ fg: "ui.help_key_fg" }`,
+	* separators with `{ fg: "ui.popup_border_fg" }`, etc. Pass
+	* an empty array to clear the title and fall back to the
+	* prompt-type default. Has no visible effect on non-overlay
+	* prompts.
+	*/
+	setPromptTitle(title: StyledText[]): 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 +2134,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;