@fresh-editor/fresh-editor 0.2.13 → 0.2.16

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # Release Notes
 
+## 0.2.16
+
+### Features
+
+* **Project-Wide Search & Replace**: Search and replace across the entire project. Works reliably with unsaved buffers, large files, and up to 10,000 results. Alt+Enter to replace in project.
+
+* **Hot Exit**: All buffers — including unnamed scratch buffers — persist across sessions automatically. Configurable via `hot_exit` setting (#1148, #1233).
+
+* **Workspace Storage**: Session state always restored on startup, even when opening specific files from CLI. Plugin state also persists across sessions.
+
+### Improvements
+
+* **Keybinding Editor**: Collapsible section headers and plugin mode bindings shown as first-class entries.
+
+* **Markdown Compose Mode**: Easier to discover via global toggle and searchable command palette entries.
+
+* **Tab Naming**: Duplicate tab names are disambiguated with appended numbers.
+
+* **View...Keybinding Style: Menu Checkboxes**: Submenu items now show checkbox indicators for toggled settings.
+
+### Bug Fixes
+
+* Fixed crash when workspace references deleted files (#1278).
+
+* Fixed CapsLock breaking keyboard shortcuts like Ctrl+A, Ctrl+C, etc.
+
+* Fixed bracketed paste not working on Windows Terminal.
+
+* Fixed clipboard not working in client-server session mode.
+
+* Fixed Latin-1 files misdetected as UTF-8 for short files with trailing high bytes.
+
+* Fixed line number bugs: Delete key not updating status bar (#1261), relative line numbers miscounting (#1262).
+
+* Fixed C# LSP not working due to language ID mismatch.
+
+* Fixed remote editing using hardcoded `/tmp` instead of querying the remote system.
+
+* Fixed high memory usage on Windows (#1205).
+
+* Fixed PageUp/PageDown not working in Theme Editor sidebar.
+
+* Fixed unbound keys being swallowed in plugin modes.
+
+### Packaging
+
+* **Linux**: Icons and desktop files added to all packaging methods (deb, rpm, Flatpak, AppImage). Fixed Flatpak AppStream metadata for app stores.
+
+---
+## 0.2.14
+
+### Improvements
+
+* **Keybinding Map Checkboxes**: Submenu items in the keybinding map now show checkbox indicators for toggled settings.
+
+### Bug Fixes
+
+* **Windows Memory Usage**: Fixed high memory usage on Windows caused by buffered input event draining before render (#1205).
+
+---
+
 ## 0.2.13
 
 ### Features

package/package.json

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

package/plugins/audit_mode.ts

@@ -1195,7 +1195,7 @@ registerHandler("review_drill_down", review_drill_down);
 
 // Define the diff-view mode - inherits from "normal" for all standard navigation/selection/copy
 // Only adds diff-specific keybindings (close, hunk navigation)
-editor.defineMode("diff-view", "normal", [
+editor.defineMode("diff-view", [
     // Close the diff view
     ["q", "close"],
     // Hunk navigation (diff-specific)
@@ -1812,7 +1812,7 @@ registerHandler("on_buffer_closed", on_buffer_closed);
 
 editor.on("buffer_closed", "on_buffer_closed");
 
-editor.defineMode("review-mode", "normal", [
+editor.defineMode("review-mode", [
     // Staging actions
     ["s", "review_stage_hunk"], ["d", "review_discard_hunk"],
     // Navigation

package/plugins/config-schema.json

@@ -72,6 +72,7 @@
         "double_click_time_ms": 500,
         "auto_save_enabled": false,
         "auto_save_interval_secs": 30,
+        "hot_exit": true,
         "recovery_enabled": true,
         "auto_recovery_save_interval_secs": 2,
         "auto_revert_poll_interval_ms": 2000,
@@ -489,6 +490,12 @@
           "default": 30,
           "x-section": "Recovery"
         },
+        "hot_exit": {
+          "description": "Whether to preserve unsaved changes in all buffers (file-backed and\nunnamed) across editor sessions (VS Code \"hot exit\" behavior).\nWhen enabled, modified buffers are backed up on clean exit and their\nunsaved changes are restored on next startup.  Unnamed (scratch)\nbuffers are also persisted (Sublime Text / Notepad++ behavior).\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "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",

package/plugins/diagnostics_panel.ts

@@ -247,10 +247,11 @@ editor.on("buffer_activated", "on_diagnostics_buffer_activated");
 // Mode Definition (for custom keybindings beyond Enter/Escape)
 editor.defineMode(
   "diagnostics-extra",
-  "diagnostics-results",
   [
     ["a", "diagnostics_toggle_all"],
     ["r", "diagnostics_refresh"],
+    ["Return", `_finder_diagnostics_panel_select`],
+    ["Escape", `_finder_diagnostics_panel_close`],
   ],
   true
 );

package/plugins/examples/README.md

@@ -2,7 +2,7 @@
 
 This directory contains example plugins demonstrating the editor's plugin system. These are educational examples showing specific API features.
 
-For the complete API reference, see **[docs/development/plugin-api.md](../../docs/development/plugin-api.md)**.
+For the complete API reference, see **[docs/plugins/api/index.md](../../../../docs/plugins/api/index.md)**.
 
 ## Available Examples
 
@@ -80,5 +80,5 @@ editor.debug("My custom plugin loaded");
 
 ## Further Reading
 
-- **Getting Started:** [docs/development/plugin-development.md](../../docs/development/plugin-development.md)
-- **API Reference:** [docs/development/plugin-api.md](../../docs/development/plugin-api.md)
+- **Getting Started:** [docs/development/plugin-development.md](../../../../docs/plugins/development/index.md)
+- **API Reference:** [docs/plugins/api/index.md](../../../../docs/plugins/api/index.md)

package/plugins/examples/hello_world.ts

@@ -5,9 +5,56 @@
  *
  * This is a simple example plugin that demonstrates:
  * - Querying editor state (buffer info, cursor position)
+ * - Obtaining selected text and replacing selection (primary cursor, buffer text)
  * - Sending commands (status messages, text insertion)
  * - Using async/await for plugin actions
  */
+// Global action: Replace selection with quoted selection
+async function quote_selection() : void {
+  const bufferId = editor.getActiveBufferId();
+  const cursorInfo = editor.getPrimaryCursor();
+  if (! cursorInfo.selection) {
+      editor.setStatus(`Nothing is highlighted!`);
+  }
+  const startSelection = cursorInfo.selection.start;
+  const endSelection = cursorInfo.selection.end;
+  const bufText = await 
+      editor.getBufferText(bufferId, startSelection, endSelection);
+
+  // Important! Insertions must be done on byte boundaries. But the text
+  // may be UTF-8 character and may be multiple bytes.
+  // Assumption: a proper selection will be on UTF-8 character boundaries
+  // Therefore: 
+  //   a. instert the end quote first to avoid moving the entire string 
+  //      to the right
+  //   b. insert the start quote second which can now push the string
+  //      to the right without any problems.
+  let success = editor.insertText(bufferId, endSelection, "'");
+  if (!success) {
+    editor.setStatus("Failed to insert end quote");
+    return;
+  }
+
+  success = editor.insertText(bufferId, startSelection, "'");
+  if (!success) {
+    editor.setStatus("Failed to insert start quote");
+    return
+  }
+  const statusMessage = `Quoted: ${bufText}`;
+  editor.setStatus(statusMessage)
+}
+registerHandler("quote_selection", quote_selection);
+ 
+// Global action: Display primary cursor information
+function show_cursor_info() : void {
+  const cursorInfo = editor.getPrimaryCursor();
+  
+  const status = `Cursor at ${cursorInfo.position} Selection start-${cursorInfo.selection.start}, end-${cursorInfo.selection.end}`;
+
+  editor.setStatus(status);
+  editor.debug(`Cursor info: ${status}`);
+}
+registerHandler("show_cursor_info", show_cursor_info);
 
 // Global action: Display buffer information
 function show_buffer_info() : void {
@@ -87,6 +134,18 @@ async function async_demo() : Promise<void> {
 registerHandler("async_demo", async_demo);
 
 // Register commands so they appear in the command palette (Ctrl+P)
+editor.registerCommand(
+  "Hello: Quote Selection",
+  "Quote Selection",
+  "quote_selection"
+);
+
+editor.registerCommand(
+  "Hello: Show Cursor Info",
+  "Display primary cursor information",
+  "show_cursor_info"
+);
+
 editor.registerCommand(
   "Hello: Show Buffer Info",
   "Display active buffer information",

package/plugins/examples/virtual_buffer_demo.ts

@@ -11,7 +11,6 @@ editor.registerCommand(
 // Define a custom mode for the demo buffer
 editor.defineMode(
   "demo-list", // mode name
-  null,         // no parent mode
   [
     ["Return", "demo_goto_item"],
     ["n", "demo_next_item"],

package/plugins/git_blame.ts

@@ -98,7 +98,6 @@ const colors = {
 
 editor.defineMode(
   "git-blame",
-  "normal", // inherit from normal mode for cursor movement
   [
     ["b", "git_blame_go_back"],
     ["q", "git_blame_close"],

package/plugins/git_log.ts

@@ -132,7 +132,6 @@ const colors = {
 // Navigation uses normal cursor movement (arrows, j/k work naturally via parent mode)
 editor.defineMode(
   "git-log",
-  "normal", // inherit from normal mode for cursor movement
   [
     ["Return", "git_log_show_commit"],
     ["Tab", "git_log_show_commit"],
@@ -148,7 +147,6 @@ editor.defineMode(
 // Inherits from normal mode for natural cursor movement
 editor.defineMode(
   "git-commit-detail",
-  "normal", // inherit from normal mode for cursor movement
   [
     ["Return", "git_commit_detail_open_file"],
     ["q", "git_commit_detail_close"],
@@ -160,7 +158,6 @@ editor.defineMode(
 // Define git-file-view mode for viewing files at a specific commit
 editor.defineMode(
   "git-file-view",
-  "normal", // inherit from normal mode for cursor movement
   [
     ["q", "git_file_view_close"],
     ["Escape", "git_file_view_close"],

package/plugins/lib/finder.ts

@@ -923,8 +923,7 @@ export class Finder<T> {
         // Define preview mode
         this.editor.defineMode(
           this.previewModeName,
-          "special",
-          [["q", "close_buffer"]],
+          [["q", "close_buffer"], ["Escape", "close_buffer"]],
           true
         );
 
@@ -978,7 +977,6 @@ export class Finder<T> {
     // Define panel mode
     this.editor.defineMode(
       this.modeName,
-      "normal",
       [
         ["Return", `${this.handlerPrefix}_panel_select`],
         ["Escape", `${this.handlerPrefix}_panel_close`],

package/plugins/lib/fresh.d.ts

@@ -663,6 +663,36 @@ type CreateVirtualBufferOptions = {
 	*/
 	entries?: Array<TextPropertyEntry>;
 };
+type GrepMatch = {
+	/**
+	* Absolute file path
+	*/
+	file: string;
+	/**
+	* Buffer ID if the file is open (0 if not)
+	*/
+	bufferId: number;
+	/**
+	* Byte offset of match start in the file/buffer content
+	*/
+	byteOffset: number;
+	/**
+	* Match length in bytes
+	*/
+	length: number;
+	/**
+	* 1-indexed line number
+	*/
+	line: number;
+	/**
+	* 1-indexed column number
+	*/
+	column: number;
+	/**
+	* The matched line content (for display)
+	*/
+	context: string;
+};
 type LanguagePackConfig = {
 	/**
 	* Comment prefix for line comments (e.g., "//" or "#")
@@ -720,6 +750,16 @@ type LspServerPackConfig = {
 	*/
 	processLimits: ProcessLimitsPackConfig | null;
 };
+type ReplaceResult = {
+	/**
+	* Number of replacements made
+	*/
+	replacements: number;
+	/**
+	* Buffer ID of the edited buffer
+	*/
+	bufferId: number;
+};
 type SpawnResult = {
 	/**
 	* Complete stdout as string
@@ -781,6 +821,11 @@ interface EditorAPI {
 	copyToClipboard(text: string): void;
 	setClipboard(text: string): void;
 	/**
+	* Get the display label for a keybinding by action name and optional mode.
+	* Returns null if no binding is found.
+	*/
+	getKeybindingLabel(action: string, mode: string | null): string | null;
+	/**
 	* Register a command in the command palette (Ctrl+P).
 	* 
 	* Usually you should omit `context` so the command is always visible.
@@ -1234,7 +1279,7 @@ interface EditorAPI {
 	/**
 	* Define a buffer mode (takes bindings as array of [key, command] pairs)
 	*/
-	defineMode(name: string, parent: string | null, bindingsArr: string[][], readOnly?: boolean): boolean;
+	defineMode(name: string, bindingsArr: string[][], readOnly?: boolean, allowTextInput?: boolean): boolean;
 	/**
 	* Set the global editor mode
 	*/
@@ -1316,6 +1361,18 @@ interface EditorAPI {
 	*/
 	getViewState(bufferId: number, key: string): unknown;
 	/**
+	* Set plugin-managed global state (write-through to snapshot + command for persistence).
+	* State is automatically isolated per plugin using the plugin's name.
+	* TODO: Need to think about plugin isolation / namespacing strategy for these APIs.
+	*/
+	setGlobalState(key: string, value: unknown): boolean;
+	/**
+	* Get plugin-managed global state (reads from snapshot).
+	* State is automatically isolated per plugin using the plugin's name.
+	* TODO: Need to think about plugin isolation / namespacing strategy for these APIs.
+	*/
+	getGlobalState(key: string): unknown;
+	/**
 	* Create a scroll sync group for anchor-based synchronized scrolling
 	*/
 	createScrollSyncGroup(groupId: number, leftSplit: number, rightSplit: number): boolean;
@@ -1399,6 +1456,31 @@ interface EditorAPI {
 	*/
 	delay(durationMs: number): Promise<void>;
 	/**
+	* Project-wide grep search (async)
+	* Searches all files in the project, respecting .gitignore.
+	* Open buffers with dirty edits are searched in-memory.
+	*/
+	grepProject(pattern: string, fixedString: boolean | null, caseSensitive: boolean | null, maxResults: number | null, wholeWords: boolean | null): Promise<GrepMatch[]>;
+	/**
+	* Streaming project-wide grep search
+	* Returns a thenable with a searchId property. The progressCallback is called
+	* with batches of matches as they are found.
+	*/
+	grepProjectStreaming(pattern: string, opts?: {
+		fixedString?: boolean;
+		caseSensitive?: boolean;
+		maxResults?: number;
+		wholeWords?: boolean;
+	}, progressCallback?: (matches: GrepMatch[], done: boolean) => void): PromiseLike<GrepMatch[]> & {
+		searchId: number;
+	};
+	/**
+	* Replace matches in a file's buffer (async)
+	* Opens the file if not already in a buffer, applies edits via the buffer model,
+	* and saves. All edits are grouped as a single undo action.
+	*/
+	replaceInFile(filePath: string, matches: number[][], replacement: string): Promise<ReplaceResult>;
+	/**
 	* Send LSP request (async, returns request_id)
 	*/
 	sendLspRequest(language: string, method: string, params: Record<string, unknown> | null): Promise<unknown>;

package/plugins/lib/search-utils.ts

@@ -37,7 +37,7 @@ export interface DebouncedSearchOptions {
 // Editor interface (subset of what we need)
 interface EditorApi {
   readFile(path: string): Promise<string>;
-  defineMode(name: string, parent: string, bindings: [string, string][], readOnly: boolean): void;
+  defineMode(name: string, bindings: [string, string][], readOnly: boolean): void;
   createVirtualBufferInSplit(options: {
     name: string;
     mode: string;
@@ -131,7 +131,7 @@ export class SearchPreview {
 
       if (this.bufferId === null) {
         // Create preview mode if not exists
-        this.editor.defineMode(this.modeName, "special", [["q", "close_buffer"]], true);
+        this.editor.defineMode(this.modeName, [["q", "close_buffer"]], true);
 
         // Create preview in a split on the right
         const result = await this.editor.createVirtualBufferInSplit({