@fresh-editor/fresh-editor 0.2.5 → 0.2.12

package/CHANGELOG.md

@@ -1,5 +1,151 @@
 # Release Notes
 
+## 0.2.12
+
+### Features
+
+* **Auto-Close Config**: Separate `auto_close` toggle (default: true) to independently control bracket/quote auto-close, skip-over, and pair deletion — previously coupled to `auto_indent`. Per-language overrides via `languages.<lang>.auto_close` (#1144).
+
+* **Surround Selection**: Typing an opening delimiter with a selection wraps it instead of replacing it (e.g. selecting `hello` and typing `(` produces `(hello)`). Controlled by `auto_surround` config with per-language overrides.
+
+* **Smart Quote Suppression**: Quotes typed inside an existing string no longer auto-close, preventing unwanted doubled quotes (#1142).
+
+* **Read-Only Mode**: Files without write permission and library/toolchain paths (rustup, /usr/include, /nix/store, Homebrew Cellar, .nuget, Xcode SDKs) automatically open as read-only. New "Toggle Read Only" command to override. Status bar shows `[RO]` indicator.
+
+### Bug Fixes
+
+* **Multi-Cursor Enter**: Fixed Enter key in markdown mode only inserting a newline at the last cursor, ignoring secondary cursors. Falls back to built-in insert_newline when multiple cursors are active (#1140).
+
+* **Multi-Cursor Position Drift**: Fixed cursors with no events during bulk edits (e.g. Delete at end of buffer) drifting to stale positions. Uses saturating arithmetic to prevent overflow with overlapping selections (#1140).
+
+### Improvements
+
+* **Log Noise Reduction**: Disabled span close events (~90% of log volume) by default and moved 12 high-frequency log sites to trace level. Typical log size reduced from ~266MB to ~5-10MB. Set `FRESH_LOG_SPANS=1` to re-enable (#1154).
+
+### Internal
+
+* Added multi-cursor shadow model property-based tests with random operation sequences across 2-3 cursors.
+* Added e2e regression tests for multi-cursor Enter with auto_indent, Ctrl+D selection, tree-sitter, and markdown grammar.
+
+---
+
+## 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

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/GpNWqMUH)  ·  [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fresh-editor/fresh-editor",
-  "version": "0.2.5",
+  "version": "0.2.12",
   "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,8 +41,17 @@
         "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,
+        "auto_close": true,
+        "auto_surround": true,
         "scroll_offset": 3,
         "default_line_ending": "lf",
         "trim_trailing_whitespace_on_save": false,
@@ -72,6 +81,7 @@
         "highlight_context_bytes": 10000,
         "large_file_threshold_bytes": 1048576,
         "estimated_line_length": 80,
+        "read_concurrency": 64,
         "file_tree_poll_interval_ms": 3000
       }
     },
@@ -278,6 +288,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",
@@ -292,6 +344,18 @@
           "default": true,
           "x-section": "Editing"
         },
+        "auto_close": {
+          "description": "Automatically close brackets, parentheses, and quotes when typing.\nWhen enabled, typing an opening delimiter like `(`, `[`, `{`, `\"`, `'`, or `` ` ``\nwill automatically insert the matching closing delimiter.\nAlso enables skip-over (moving past existing closing delimiters) and\npair deletion (deleting both delimiters when backspacing between them).\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Editing"
+        },
+        "auto_surround": {
+          "description": "Automatically surround selected text with matching pairs when typing\nan opening delimiter. When enabled and text is selected, typing `(`, `[`,\n`{`, `\"`, `'`, or `` ` `` wraps the selection instead of replacing it.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Editing"
+        },
         "scroll_offset": {
           "description": "Minimum lines to keep visible above/below cursor when scrolling",
           "type": "integer",
@@ -490,6 +554,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",
@@ -702,7 +774,8 @@
         "default",
         "emacs",
         "vscode",
-        "macos"
+        "macos",
+        "macos-gui"
       ]
     },
     "LanguageConfig": {
@@ -743,6 +816,22 @@
           "type": "boolean",
           "default": true
         },
+        "auto_close": {
+          "description": "Whether to auto-close brackets, parentheses, and quotes for this language.\nIf not specified (`null`), falls back to the global `editor.auto_close` setting.",
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "default": null
+        },
+        "auto_surround": {
+          "description": "Whether to auto-surround selected text with matching pairs for this language.\nIf not specified (`null`), falls back to the global `editor.auto_surround` setting.",
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "default": null
+        },
         "highlighter": {
           "description": "Preferred highlighter backend (auto, tree-sitter, or textmate)",
           "$ref": "#/$defs/HighlighterPreference",

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 (None 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
+	*/
+	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;