@fresh-editor/fresh-editor 0.2.4 → 0.2.11

package/CHANGELOG.md

@@ -1,5 +1,153 @@
 # Release Notes
 
+## 0.2.11
+
+### Features
+
+* **Whitespace Indicators**: Granular control over whitespace visibility — configure space (·) and tab (→) indicators independently for leading, inner, and trailing positions. Master toggle, per-language overrides, and a new `whitespace_indicator_fg` theme color.
+
+* **Indent-Based Code Folding**: Code folding now works in large file mode and for files without LSP folding ranges, using indentation analysis as a fallback. Fold from any line within a block (not just the header). Unified byte-offset pipeline for consistent gutter indicators.
+
+* **Session Open-File Enhancements**: `--wait` flag blocks the CLI until the user dismisses a popup or closes the buffer — enables use as `git core.editor`. Range selection syntax (`file:L-EL`, `file:L:C-EL:EC`) and hover messages (`file:L@"markdown msg"`) for annotated file opening. Auto-attaches a client when `open-file` starts a new session.
+
+* **GUI: macOS Native Integration** (experimental): Native menu bar with dynamic when/checkbox conditions, Cmd keybindings (`macos-gui` keymap), app icon, and `.app` bundle resources. Menu tracking detection prevents state mutations from causing menu jumps.
+
+* **Platform Icons**: Application icons for Windows `.exe`, Linux `.deb`/`.rpm` packages, and macOS app bundles.
+
+### Bug Fixes
+
+* **Bracket Highlight Hanging on Large Files**: Bracket matching now caps scanning at 1MB and uses 16KB bulk reads instead of byte-at-a-time, preventing hangs on large files.
+
+* **Markdown Plugin Activation**: Plugin now activates based on buffer language (not just file extension), fixing cases where `Set Language` to markdown didn't enable smart editing (#1117). Reverse bullet cycling on Shift+Tab now works correctly (#1116).
+
+* **Settings UI**: Fixed Save button mouse click not closing the dialog. Fixed Reset button not showing confirmation dialog. Fixed Discard dialog persisting on reopen.
+
+* **Active Tab Styling Bleed**: Fixed active tab border color bleeding through dropdown menus.
+
+* **Cursor Corruption on Tab Click**: Fixed hardware cursor appearing at wrong position when clicking a tab in an inactive split.
+
+* **Comment Delimiter Colors**: Fixed comment delimiter characters (e.g. `//`) using the wrong color in syntax highlighting.
+
+* **Scroll Events Routing**: Fixed mouse scroll events going to the file explorer panel regardless of mouse position.
+
+* **File Explorer Border**: Fixed hover/drag bugs on the file explorer resize border.
+
+* **Windows Named Pipe Crash**: Fixed crash in `Server::handle_new_connection` on Windows.
+
+* **Bar/Underline Cursor Invisible**: Fixed bar and underline cursor styles being invisible on characters due to REVERSED modifier creating a block-like highlight (#851).
+
+* **Wrapped Line Viewport Scroll**: Fixed viewport scroll limit counting logical lines instead of visual rows, causing erratic scrolling, skipped wrapped rows, and stuck End key with line wrap enabled (#1147).
+
+* **Search on Large Files**: Fixed multi-GB memory consumption, O(N²) offset accumulation, and search scan never completing when capped at max matches. Chunked incremental search, viewport-only overlays, and 100K match cap (#1146).
+
+* **macOS Menu Hover Jump**: Fixed menu bar jumping to leftmost menu during hover by using `WaitUntil` instead of `Poll` and caching menu item states.
+
+### Improvements
+
+* Status log and warning log buffers are now read-only.
+* Replaced `buffer_modified` JS plugin with native Rust diff indicators, eliminating JS↔Rust round-trips on every edit/scroll.
+
+### Internal
+
+* Folding system refactored to use byte offsets instead of line numbers for gutter indicators, fixing consistency issues in large file mode.
+* Unified fold indicator pipeline shared between LSP-based and indent-based folding.
+* Fixed Nix build: include PNG files in source filter for GUI icon resources.
+
+---
+
+## 0.2.9
+
+### Features
+
+* **Code Folding**: Fold/unfold code blocks via LSP foldingRange. Per-view fold state, gutter indicators for collapsed ranges, fold-aware scrolling. Toggle via command palette ("Toggle Fold") (#900). Thanks @asukaminato0721 !
+
+* **Large File Line Numbers**: Large files show byte offsets in gutter/status bar until scanned. On-demand parallel line index scanning (via Ctrl+G prompt or "Scan Line Index" command) gives exact line numbers with progress indicator. Remote scanning counts newlines server-side without data transfer.
+
+* **Markdown Source Editing**: New plugin for smart Markdown source-mode editing — auto-continues list items on Enter (bullets, ordered lists, checkboxes), removes empty markers, Tab indents + cycles bullet style (#1095).
+
+* **GUI mode - can run without terminal** (highly experimental): GPU-accelerated windowed mode via winit + wgpu. Build with `--features gui` and run with `--gui` to try it.
+
+### Improvements
+
+* **Smart Backspace Dedent**: Backspace in leading whitespace removes one indent unit (tab_size spaces or 1 tab) instead of a single character.
+
+* **Diagnostics Panel**: Up/Down now scrolls the editor to preview diagnostic location. Enter jumps and focuses the editor.
+
+* **Glob Patterns in Language Config**: `filenames` field now supports glob patterns (`*.conf`, `*rc`, `/etc/**/rc.*`) for extensionless file detection (#1083).
+
+* Disabled single-quote auto-close in Markdown files (interferes with apostrophes).
+
+### Bug Fixes
+
+* **Auto-Indent**: Fixed `tab_size` setting ignored for auto-indent; fixed indent level lost on normal statement lines; fixed Go auto-dedent using spaces instead of tabs (#1068); fixed Python nested indent after consecutive `:` lines (#1069).
+
+* **File Explorer Dotfiles**: Fixed dotfiles always visible regardless of "Show hidden files" toggle. Config `show_hidden`/`show_gitignored` now applied on init (#1079).
+
+* **LSP Toggle Desync**: Fixed state corruption when toggling LSP off/on — now sends `didClose` so re-enable gets fresh `didOpen` (#952).
+
+* **LSP Client Capabilities**: Now advertises all supported capabilities including `publishDiagnostics`, enabling diagnostics from strict servers like pyright (#1006).
+
+* **LSP Status Indicator**: Fixed status bar indicator disappearing after each request completion (#952).
+
+* **Set Language**: Fixed command storing display name instead of canonical ID, breaking LSP config lookups (#1078).
+
+* **Escape Sequences in Client Mode**: Fixed mouse codes, Shift+Tab, and standalone ESC not working in `fresh -a` attach mode (#1089).
+
+* **Client Mode Terminal Reset**: Fixed terminal not fully restored on exit in client mode (#1089).
+
+* **Ctrl+End with Line Wrap**: Fixed viewport not scrolling to trailing empty line; fixed Down arrow not reaching it (#992).
+
+* **Diagnostics Panel Windows Paths**: Fixed file URIs not decoded properly on Windows (#1071).
+
+* **Debug Keyboard Dialog**: Fixed not capturing keys in client/server mode (#1089).
+
+### Performance
+
+* Replaced linear span lookups in syntax highlighting with O(1) amortized cursor.
+* Eliminated JSON round-trip and JS re-parsing in plugin hook dispatch (~16% CPU reduction).
+* Path-copying PieceTree mutations with structural diff via `Arc::ptr_eq` — O(edit regions) instead of O(all leaves).
+* Viewport-aware filtering and batch API for large file gutter indicators (~780K IPC commands → ~50 per edit).
+
+### Internal
+
+* Update flake.nix to rust 1.92.0
+* Split GUI backend into separate `fresh-gui` crate.
+* Unified language detection with `DetectedLanguage` struct and single `apply_language()` mutation point.
+* CI now runs clippy with `--all-features` to lint GUI code.
+
+---
+
+## 0.2.5
+
+### Features
+
+* **Persistent Auto-Save**: New `auto_save_enabled` config option (default: false) to automatically save modified buffers to their original file at a configurable interval (`auto_save_interval_secs`, default: 30s) (#542)
+
+* **Smart Home**: Home key now uses smart home behavior by default, toggling between the first non-whitespace character and column 0. On soft-wrapped lines, smart home respects visual line boundaries instead of jumping to the physical line start (#1064).
+
+### Bug Fixes
+
+* **Diff View Scrollbar**: Fixed scrollbar click-to-jump and thumb drag not working in side-by-side diff views. Composite buffer views now use row-based scrolling via CompositeViewState.
+
+* **Terminal Bracket Paste**: Fixed pasted text going into the editor buffer instead of the terminal PTY when in terminal mode (#1056).
+
+* **LSP did_open Reliability**: Fixed buffer being incorrectly marked as LSP-opened when the did_open send fails, which prevented retry and could corrupt server document state.
+
+* **Remote Editing Data Loss**: Fixed intermittent data loss when loading large files via SSH remote editing on macOS. The bounded channel now uses backpressure instead of silently dropping data when the buffer overflows (#1059).
+
+### Configuration
+
+* Renamed `auto_save_interval_secs` (recovery) to `auto_recovery_save_interval_secs` to distinguish it from the new persistent auto-save feature. Added `auto_recovery_save_interval_secs` config option (default: 2s).
+
+### Internal
+
+* Introduced typed `LeafId` and `ContainerId` wrappers around `SplitId` to enforce leaf-vs-container constraints at compile time.
+* Enabled `#![deny(clippy::let_underscore_must_use)]` crate-wide; all ignored `Result` values now have explicit annotations or proper error handling.
+* Made `request_completion` and `request_signature_help` infallible, removing dead `Result` return types.
+* Added CONTRIBUTING.md with development guidelines.
+
+---
+
 ## 0.2.4
 
 ### Features

package/README.md

@@ -2,7 +2,7 @@
 
 A modern, full-featured terminal text editor, **with zero configuration**. Familiar keybindings, mouse support, and IDE-level features — no learning curve required.
 
-[Official Website](https://sinelaw.github.io/fresh/)  ·  [Documentation](https://getfresh.dev/docs)  ·  [Discord](https://discord.gg/qUutBj9t)  ·  [Contributing](#contributing)
+[Official Website](https://sinelaw.github.io/fresh/)  ·  [Documentation](https://getfresh.dev/docs)  ·  [Discord](https://discord.gg/gqGh3K4uW3)  ·  [Contributing](#contributing)
 
 **[Quick Install](#installation):**   `curl https://raw.githubusercontent.com/sinelaw/fresh/refs/heads/master/scripts/install.sh | sh`
 
@@ -47,7 +47,7 @@ See more feature demos: [Editing](https://getfresh.dev/docs/blog/editing) (searc
 | **Views & Layout** | split panes, line numbers, line wrap, backgrounds, markdown preview |
 | **Language Server (LSP)** | go to definition, references, hover, code actions, rename, diagnostics, autocompletion |
 | **Productivity** | command palette, menu bar, keyboard macros, git log, diagnostics panel |
-| **Extensibility** | TypeScript plugins (sandboxed Deno), color highlighter, TODO highlighter, merge conflicts, path complete, keymaps |
+| **Extensibility** | TypeScript plugins (sandboxed QuickJS), color highlighter, TODO highlighter, merge conflicts, path complete, keymaps |
 | **Internationalization** | Multiple language support (see [`locales/`](locales/)), plugin translation system |
 
 ## Installation
@@ -240,30 +240,7 @@ cargo build --release
 
 ## Contributing
 
-Thanks for contributing!
-
-1. **Reproduce Before Fixing**: Always include a test case that reproduces the bug (fails) without the fix, and passes with the fix. This ensures the issue is verified and prevents future regressions.
-
-2. **E2E Tests for New Flows**: Any new user flow or feature must include an end-to-end (e2e) test. E2E tests send keyboard/mouse events and examines the final rendered output, do not examine internal state.
-
-3. **No timeouts or time-sensitive tests**: Use "semantic waiting" (waiting for specific state changes/events) instead of fixed timers to ensure test stability. Wait indefinitely, don't put timeouts inside tests (cargo nextest will timeout externally).
-
-4. **Test isolation**: Tests should run in parallel. Use the internal clipboard mode in tests to isolate them from the host system and prevent flakiness in CI. Same for other external resources (temp files, etc. should all be isolated between tests, under a per-test temporary workdir).
-
-5. **Required Formatting**: All code must be formatted with `cargo fmt` before submission. PRs that fail formatting checks will not be merged.
-
-6. **Cross-Platform Consistency**: Avoid hard-coding newline or CRLF related logic, consider the buffer mode.
-
-7. **LSP**: Ensure LSP interactions follow the correct lifecycle (e.g., `didOpen` must always precede other requests to avoid server-side errors). Use the appropriate existing helpers for this pattern.
-
-8. **Regenerate plugin types and schemas**: After modifying the plugin API or config types:
-   - **TypeScript definitions** (`plugins/lib/fresh.d.ts`): Auto-generated from Rust types with `#[derive(TS)]`. Run: `cargo test -p fresh-plugin-runtime write_fresh_dts_file -- --ignored`
-   - **JSON schemas** (`plugins/config-schema.json`, `plugins/schemas/theme.schema.json`): Auto-generated from Rust types with `#[derive(JsonSchema)]`. Run: `./scripts/gen_schema.sh`
-   - **Package schema** (`plugins/schemas/package.schema.json`): Manually maintained - edit directly when adding new language pack fields
-
-9. **Type check plugins**: Run `crates/fresh-editor/plugins/check-types.sh` (requires `tsc`)
-
-**Tip**: You can use tmux + send-keys + render-pane to script ad-hoc tests on the UI, for example when trying to reproduce an issue.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## Privacy
 

package/package.json

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

package/plugins/README.md

@@ -1,6 +1,6 @@
 # Plugins
 
-This directory contains production-ready plugins for the editor. Plugins are written in **TypeScript** and run in a sandboxed Deno environment. They are automatically loaded when the editor starts.
+This directory contains production-ready plugins for the editor. Plugins are written in **TypeScript** and run in a sandboxed QuickJS environment (transpiled via oxc_transformer). They are automatically loaded when the editor starts.
 
 ## Available Plugins
 

package/plugins/clangd_support.ts

@@ -36,22 +36,14 @@ function detectLanguage(path: string): string | null {
 }
 
 function pathToFileUri(path: string): string {
-  let normalized = path.replace(/\\/g, "/");
-  if (!normalized.startsWith("/")) {
-    normalized = "/" + normalized;
-  }
-  return "file://" + encodeURI(normalized);
+  return editor.pathToFileUri(path);
 }
 
 function fileUriToPath(uri: string): string {
   if (!uri.startsWith("file://")) {
     return uri;
   }
-  let path = decodeURI(uri.substring("file://".length));
-  if (path.startsWith("/") && path.length > 2 && path[2] === ":") {
-    path = path.substring(1);
-  }
-  return path;
+  return editor.fileUriToPath(uri) || uri;
 }
 
 function setClangdStatus(message: string): void {

package/plugins/config-schema.json

@@ -41,6 +41,13 @@
         "use_terminal_bg": false,
         "cursor_style": "default",
         "rulers": [],
+        "whitespace_show": true,
+        "whitespace_spaces_leading": false,
+        "whitespace_spaces_inner": false,
+        "whitespace_spaces_trailing": false,
+        "whitespace_tabs_leading": true,
+        "whitespace_tabs_inner": true,
+        "whitespace_tabs_trailing": true,
         "tab_size": 4,
         "auto_indent": true,
         "scroll_offset": 3,
@@ -58,8 +65,10 @@
         "mouse_hover_enabled": true,
         "mouse_hover_delay_ms": 500,
         "double_click_time_ms": 500,
+        "auto_save_enabled": false,
+        "auto_save_interval_secs": 30,
         "recovery_enabled": true,
-        "auto_save_interval_secs": 2,
+        "auto_recovery_save_interval_secs": 2,
         "auto_revert_poll_interval_ms": 2000,
         "keyboard_disambiguate_escape_codes": true,
         "keyboard_report_event_types": false,
@@ -70,6 +79,7 @@
         "highlight_context_bytes": 10000,
         "large_file_threshold_bytes": 1048576,
         "estimated_line_length": 80,
+        "read_concurrency": 64,
         "file_tree_poll_interval_ms": 3000
       }
     },
@@ -276,6 +286,48 @@
           "default": [],
           "x-section": "Display"
         },
+        "whitespace_show": {
+          "description": "Master toggle for whitespace indicator visibility.\nWhen disabled, no whitespace indicators (·, →) are shown regardless\nof the per-position settings below.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Whitespace"
+        },
+        "whitespace_spaces_leading": {
+          "description": "Show space indicators (·) for leading whitespace (indentation).\nLeading whitespace is everything before the first non-space character on a line.\nDefault: false",
+          "type": "boolean",
+          "default": false,
+          "x-section": "Whitespace"
+        },
+        "whitespace_spaces_inner": {
+          "description": "Show space indicators (·) for inner whitespace (between words/tokens).\nInner whitespace is spaces between the first and last non-space characters.\nDefault: false",
+          "type": "boolean",
+          "default": false,
+          "x-section": "Whitespace"
+        },
+        "whitespace_spaces_trailing": {
+          "description": "Show space indicators (·) for trailing whitespace.\nTrailing whitespace is everything after the last non-space character on a line.\nDefault: false",
+          "type": "boolean",
+          "default": false,
+          "x-section": "Whitespace"
+        },
+        "whitespace_tabs_leading": {
+          "description": "Show tab indicators (→) for leading tabs (indentation).\nCan be overridden per-language via `show_whitespace_tabs` in language config.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Whitespace"
+        },
+        "whitespace_tabs_inner": {
+          "description": "Show tab indicators (→) for inner tabs (between words/tokens).\nCan be overridden per-language via `show_whitespace_tabs` in language config.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Whitespace"
+        },
+        "whitespace_tabs_trailing": {
+          "description": "Show tab indicators (→) for trailing tabs.\nCan be overridden per-language via `show_whitespace_tabs` in language config.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Whitespace"
+        },
         "tab_size": {
           "description": "Number of spaces per tab character",
           "type": "integer",
@@ -388,14 +440,28 @@
           "default": 500,
           "x-section": "Mouse"
         },
+        "auto_save_enabled": {
+          "description": "Whether to enable persistent auto-save (save to original file on disk).\nWhen enabled, modified buffers are saved to their original file path\nat a configurable interval.\nDefault: false",
+          "type": "boolean",
+          "default": false,
+          "x-section": "Recovery"
+        },
+        "auto_save_interval_secs": {
+          "description": "Interval in seconds for persistent auto-save.\nModified buffers are saved to their original file at this interval.\nOnly effective when auto_save_enabled is true.\nDefault: 30 seconds",
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0,
+          "default": 30,
+          "x-section": "Recovery"
+        },
         "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.",
           "type": "boolean",
           "default": true,
           "x-section": "Recovery"
         },
-        "auto_save_interval_secs": {
-          "description": "Auto-save interval in seconds for file recovery\nModified buffers are saved to recovery files at this interval.\nDefault: 2 seconds for fast recovery with minimal data loss.\nSet to 0 to disable periodic auto-save (manual recovery only).",
+        "auto_recovery_save_interval_secs": {
+          "description": "Interval in seconds for auto-recovery-save.\nModified buffers are saved to recovery files at this interval.\nOnly effective when recovery_enabled is true.\nDefault: 2 seconds",
           "type": "integer",
           "format": "uint32",
           "minimum": 0,
@@ -474,6 +540,14 @@
           "default": 80,
           "x-section": "Performance"
         },
+        "read_concurrency": {
+          "description": "Maximum number of concurrent filesystem read requests.\nUsed during line-feed scanning and other bulk I/O operations.\nHigher values improve throughput, especially for remote filesystems.\nDefault: 64",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0,
+          "default": 64,
+          "x-section": "Performance"
+        },
         "file_tree_poll_interval_ms": {
           "description": "Poll interval in milliseconds for refreshing expanded directories in the file explorer.\nDirectory modification times are checked at this interval to detect new/deleted files.\nLower values detect changes faster but use more CPU.\nDefault: 3000ms (3 seconds)",
           "type": "integer",
@@ -686,7 +760,8 @@
         "default",
         "emacs",
         "vscode",
-        "macos"
+        "macos",
+        "macos-gui"
       ]
     },
     "LanguageConfig": {

package/plugins/csharp_support.ts

@@ -186,7 +186,7 @@ globalThis.on_csharp_file_open = async function (data: AfterFileOpenData): Promi
       configuredProjectRoots.add(projectRoot);
 
       // Convert path to file:// URI
-      const rootUri = `file://${projectRoot}`;
+      const rootUri = editor.pathToFileUri(projectRoot);
       editor.debug(`csharp_support: Setting LSP root URI to ${rootUri}`);
       editor.setLspRootUri("csharp", rootUri);
     }

package/plugins/diagnostics_panel.ts

@@ -13,7 +13,7 @@
  * - syncWithEditor for bidirectional cursor sync
  */
 
-import { Finder, createLiveProvider, getRelativePath, type FinderProvider } from "./lib/finder.ts";
+import { Finder, createLiveProvider, type FinderProvider } from "./lib/finder.ts";
 
 const editor = getEditor();
 
@@ -49,41 +49,42 @@ function severityToString(severity: number): "error" | "warning" | "info" | "hin
   }
 }
 
-// Convert URI to file path
+// Convert file URI to file path using the editor's built-in URI handling
 function uriToPath(uri: string): string {
-  if (uri.startsWith("file://")) {
-    return uri.slice(7);
+  if (!uri.startsWith("file://")) {
+    return uri;
   }
-  return uri;
+  return editor.fileUriToPath(uri) || uri;
 }
 
 // Get diagnostics based on current filter
 function getDiagnostics(): DiagnosticItem[] {
   const diagnostics = editor.getAllDiagnostics();
 
-  // Get active file URI for filtering
-  let activeUri: string | null = null;
+  // Get active file path for filtering
+  let activePath: string | null = null;
   if (sourceBufferId !== null) {
     const path = editor.getBufferPath(sourceBufferId);
     if (path) {
-      activeUri = "file://" + path;
+      activePath = path.replace(/\\/g, "/");
     }
   }
 
-  // Filter diagnostics
-  const filterUri = showAllFiles ? null : activeUri;
-  const filtered = filterUri
-    ? diagnostics.filter((d) => d.uri === filterUri)
-    : diagnostics;
+  // Filter diagnostics by comparing decoded paths (avoids URI encoding mismatches)
+  const filtered = showAllFiles || !activePath
+    ? diagnostics
+    : diagnostics.filter((d) => uriToPath(d.uri).replace(/\\/g, "/") === activePath);
 
   // Sort by file, then line, then severity
   filtered.sort((a, b) => {
     // File comparison
     if (a.uri !== b.uri) {
       // Active file first
-      if (activeUri) {
-        if (a.uri === activeUri) return -1;
-        if (b.uri === activeUri) return 1;
+      if (activePath) {
+        const aPath = uriToPath(a.uri).replace(/\\/g, "/");
+        const bPath = uriToPath(b.uri).replace(/\\/g, "/");
+        if (aPath === activePath) return -1;
+        if (bPath === activePath) return 1;
       }
       return a.uri < b.uri ? -1 : 1;
     }
@@ -124,15 +125,7 @@ const finder = new Finder<DiagnosticItem>(editor, {
   }),
   groupBy: "file",
   syncWithEditor: true,
-  onSelect: (d) => {
-    const displayPath = getRelativePath(editor, d.file);
-    editor.setStatus(
-      editor.t("status.jumped_to", {
-        file: displayPath,
-        line: String(d.line),
-      })
-    );
-  },
+  navigateOnCursorMove: true,
 });
 
 // Get title based on current filter state
@@ -225,6 +218,11 @@ globalThis.on_diagnostics_buffer_activated = function (data: {
 }): void {
   if (!isOpen) return;
 
+  // Skip virtual buffers (e.g. the diagnostics panel itself) — they have no
+  // file path and would clear the filtered diagnostics list.
+  const path = editor.getBufferPath(data.buffer_id);
+  if (!path) return;
+
   // Update source buffer
   sourceBufferId = data.buffer_id;
 

package/plugins/git_gutter.ts

@@ -396,7 +396,7 @@ globalThis.onGitGutterAfterSave = function (args: {
 
 // Note: Git diff compares the file on disk, not the in-memory buffer.
 // Line indicators automatically track position changes via byte-position markers.
-// A full re-diff happens on save. For unsaved changes, see buffer_modified plugin.
+// A full re-diff happens on save. Unsaved changes are shown natively by the editor.
 
 /**
  * Handle buffer closed - cleanup state

package/plugins/lib/finder.ts

@@ -112,6 +112,9 @@ export interface FinderConfig<T> {
 
   /** Panel-specific: sync cursor with editor */
   syncWithEditor?: boolean;
+
+  /** Panel-specific: navigate source split when cursor moves (preview without focus change) */
+  navigateOnCursorMove?: boolean;
 }
 
 /**
@@ -410,6 +413,7 @@ export class Finder<T> {
       maxResults: 100,
       groupBy: "none",
       syncWithEditor: false,
+      navigateOnCursorMove: false,
       ...config,
     };
 
@@ -1016,6 +1020,24 @@ export class Finder<T> {
         self.editor.setStatus(
           `Item ${itemIndex + 1}/${self.panelState.items.length}`
         );
+
+        // Navigate source split to show the item's location (without focus change)
+        if (self.config.navigateOnCursorMove) {
+          const entry = self.panelState.entries[itemIndex];
+          if (
+            entry.location &&
+            self.panelState.sourceSplitId !== null &&
+            self.panelState.splitId !== null
+          ) {
+            self.editor.openFileInSplit(
+              self.panelState.sourceSplitId,
+              entry.location.file,
+              entry.location.line,
+              entry.location.column
+            );
+            self.editor.focusSplit(self.panelState.splitId);
+          }
+        }
       }
     };
 

package/plugins/lib/fresh.d.ts

@@ -138,6 +138,10 @@ type ViewportInfo = {
 	*/
 	topByte: number;
 	/**
+	* Line number of the first visible line (null when line index unavailable, e.g. large file before scan)
+	*/
+	topLine: number | null;
+	/**
 	* Left column offset (horizontal scroll)
 	*/
 	leftColumn: number;
@@ -260,7 +264,7 @@ type BufferInfo = {
 	view_mode: string;
 	/**
 	* True if any split showing this buffer has compose mode enabled.
-	* Plugins should use this (not view_mode) to decide whether to maintain
+	* Plugins should use this (not `view_mode`) to decide whether to maintain
 	* decorations, since decorations live on the buffer and are filtered
 	* per-split at render time.
 	*/
@@ -269,6 +273,10 @@ type BufferInfo = {
 	* Compose width (if set), from the active split's view state
 	*/
 	compose_width: number | null;
+	/**
+	* The detected language for this buffer (e.g., "rust", "markdown", "text")
+	*/
+	language: string;
 };
 type JsDiagnostic = {
 	/**
@@ -836,6 +844,18 @@ interface EditorAPI {
 	*/
 	pathIsAbsolute(path: string): boolean;
 	/**
+	* Convert a file:// URI to a local file path.
+	* Handles percent-decoding and Windows drive letters.
+	* Returns an empty string if the URI is not a valid file URI.
+	*/
+	fileUriToPath(uri: string): string;
+	/**
+	* Convert a local file path to a file:// URI.
+	* Handles Windows drive letters and special characters.
+	* Returns an empty string if the path cannot be converted.
+	*/
+	pathToFileUri(path: string): string;
+	/**
 	* Get the UTF-8 byte length of a JavaScript string.
 	* 
 	* JS strings are UTF-16 internally, so `str.length` returns the number of
@@ -1147,6 +1167,10 @@ interface EditorAPI {
 	*/
 	setLineIndicator(bufferId: number, line: number, namespace: string, symbol: string, r: number, g: number, b: number, priority: number): boolean;
 	/**
+	* Batch set line indicators in the gutter (all lines share the same namespace/symbol/color/priority)
+	*/
+	setLineIndicators(bufferId: number, lines: number[], namespace: string, symbol: string, r: number, g: number, b: number, priority: number): boolean;
+	/**
 	* Clear line indicators in a namespace
 	*/
 	clearLineIndicators(bufferId: number, namespace: string): boolean;