@fresh-editor/fresh-editor 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Release Notes
 
+## 0.3.2
+
+### Features
+
+* **Live Diff plugin** (experimental): Unified-diff overlay rendered live in the editable buffer. If your file is unmodified in the editor, it updates as the file changes on disk when auto-revert kicks in - great for watching an agent edit your file. Opt-in via `Live Diff: Toggle (Global)` / `Live Diff: Toggle (Buffer)`. Reference selectable per buffer: `vs HEAD` / `vs Disk` / `vs Branch...` / `vs Default Branch`.
+
+* **New Startup section in Settings** (open Settings and search "Startup") groups everything that fires on launch:
+    - **Blank-workspace flow** (#1753) — *Auto Create Empty Buffer On Last Buffer Close* (Editor) and *Auto Open On Last Buffer Close* (File Explorer). With both off, closing the last buffer leaves a truly blank pane (no `[No Name]`, no gutter, no `~`); buffer-specific status-bar items and menu entries are suppressed, and a subdued centered hint shows the keys to escape (`Ctrl+P` / `Ctrl+O` / `Ctrl+E`).
+    - *Skip Session Restore When Files Passed* — `fresh src/main.rs` opens just that file; bare `fresh` and `fresh some/dir` still restore. Hot-exit recovery still runs. `--restore` overrides.
+    - *Restore Previous Session* (existing, moved into Startup).
+
+* **File explorer side** (thanks @paveloparev!): *Side* under File Explorer in Settings — left or right.
+
+* **Prompt Line now hidden by default**: *Show Prompt Line* now defaults off — the prompt line only appears while a prompt is active. Turn it back on via Settings.
+
+* **Mark mode preserved through Go to Line** so you can extend selections across the jump. Use **Set Mark** command followed by **Goto Line** to start a selection and extend it to the target line.
+
+* **Copy File Path commands**: New commands: "Copy File Path" and "Copy Relative File Path" to copy current buffer's path to your clipboard. Also available by right-clicking on a tab name.
+
+* **CLI Help Localization**: The `--help` output is now fully localized using runtime i18n lookups.
+
+* **Relative +/- Goto Line**: Infers absolute vs relative jumps from a leading sign (e.g., `:+10` jumps 10 lines down, `:10` jumps to line 10).
+
+* **Rust Toolchain Update**: Updated to Rust 1.95 in `rust-toolchain.toml` to fix compatibility issues with newer LLVM/clang versions on systems like Arch Linux (#1782).
+
+### Improvements
+
+* **Plugin loading deferred off the boot critical path** — another ~225 ms saved. Same load order, same hooks, just async.
+
+* **Popup focus**: LSP popups that auto-show on file open (status popup, hover, signature help, plugin Text overlays) no longer steal the next keystroke. They show unfocused with an `[Alt+T to focus]` hint; user-invoked popups (Completion, code actions, status-bar `{remote}`, LSP-status menu) still grab focus on show. Settings / Menu / Prompt modals take precedence over unfocused buffer popups for `Esc` / `popup_focus`.
+
+* **Status Bar visual integration** (#1711): The "Palette: Ctrl+P" hint and "LSP (on)" indicator now blend into the status bar by default. Built-in themes have been updated with coherent prominent colors for these indicators.
+
+* **Prompt interaction and scrolling** (#1660):
+    - Minimal scrolling: the suggestion list no longer recenters the selection on every move, preventing "row jumping" during navigation.
+    - Clicks no longer cause accidental list shifts; double-click correctly confirms selections.
+    - Preview-on-click supported for "Reload with encoding".
+
+* **Global Menu Bar**: "Toggle Menu Bar" state is now persisted globally across all workspaces.
+
+* **Windows integration**: High-quality app icon applied to the running window; app manifest and version info embedded in the binary.
+
+### Bug Fixes
+
+* **Windows subprocesses**: Transient console windows are now hidden when spawning subprocesses (e.g., formatters, linters).
+
+* **Terminal CWD**: Fixed shell spawning failure on Windows when the current directory has a `\\?\` UNC prefix.
+
+* **Live Diff stability**: Fixed crashes on surrogate-pair content (emojis) and corrected gutter rendering for empty lines inside added blocks.
+
+### Under the Hood
+
+* **Syntax Highlight Caching**: New multi-phase caching system (memoised scope lookups and whole-file cache for small files) significantly reduces CPU usage during rendering.
+
 ## 0.3.1
 
 ### Features

package/package.json

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

package/plugins/config-schema.json

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

package/plugins/diff_nav.ts

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

package/plugins/flash.ts

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