@fresh-editor/fresh-editor 0.2.17 → 0.2.20

package/CHANGELOG.md

@@ -1,5 +1,149 @@
 # Release Notes
 
+## 0.2.20
+
+### Features
+
+* **Multi-LSP Server Support**: Configure multiple LSP servers per language (e.g., pylsp + pyright for Python). Servers are routed by feature using `only_features`/`except_features` filters, completions are merged from all eligible servers, and diagnostics are tracked per-server. Per-server status is shown in the status bar (#971).
+
+* **Per-Language Editor Settings**: `line_wrap`, `wrap_column`, `page_view`, and `page_width` can now be configured per-language. For example, wrap Markdown at 80 columns while keeping code unwrapped (#1371).
+
+* **Diff Chunk Navigation Plugin**: New built-in plugin for navigating between diff chunks, merging git and saved-diff sources.
+
+### Improvements
+
+* **Faster Startup (~350ms → ~170ms)**: Syntax grammars are pre-compiled at build time, package loading moved from JavaScript to Rust, plugin I/O and transpilation run in parallel, and redundant grammar rebuilds are eliminated. Plugins can now declare dependencies via `import type` from `"fresh:plugin/..."` and are topologically sorted.
+
+* **Settings UI Overhaul**: Modernized visual design with wider modal (160 cols), rounded corner borders, Nerd Font category icons, styled `[✓]` toggles, and reverse-video key hints. Keyboard navigation rewritten: Tab cycles sequentially through all fields and buttons, composite controls (Map, ObjectArray, TextList) support internal navigation, entry dialogs have section headers with explicit field ordering, PageDown/PageUp work in the main panel, and TextList edits auto-accept on navigation. Focus indicator now highlights per-row in composite controls.
+
+* **Settings Deep Search**: Also in the Settings UI: Search now walks into Map entries, TextList items, and nested JSON values. Searching "python" finds the "python" key in language/LSP maps. Results show hierarchical breadcrumbs (e.g., "Languages > python") and auto-focus the matching entry.
+
+* **Per-Language Workspace Root Detection**: New `root_markers` field on LSP server configs. The editor walks upward from the file's directory looking for configured markers (e.g., `Cargo.toml`, `package.json`), replacing the old cwd-based root (#1360).
+
+* **Page View Mode**: "Compose" mode renamed to "Page View". Can now auto-activate per language via `page_view: true` in language config. Old keybinding names continue to work.
+
+* **256-Color Contrast Enforcement**: When running in a 256-color terminal, foreground colors are automatically adjusted to meet WCAG 3.0:1 minimum contrast ratio against their background. Fixes illegible text in Solarized Dark, Nord, Dracula, and light themes under tmux without truecolor.
+
+* **LSP in Library Files**: Files in library paths (site-packages, node_modules, .cargo) now keep LSP enabled for Goto Definition, Hover, and Find References while remaining read-only (#1344).
+
+* **Goto Matching Bracket**: Works inside bracket bodies by searching backward for the nearest enclosing bracket, matching VS Code and JetBrains behavior. All bracket searches are bounded to prevent hangs on huge files (#1258).
+
+* **LSP Head-of-Line Blocking Fix**: LSP notifications (didClose, didChange, shutdown) are no longer blocked behind pending request responses.
+
+* **New Settings**: `show_tilde` to hide EOF tilde markers (#1290), `menu_bar_mnemonics` to disable Alt+key menu shortcuts (#1257).
+
+* **`getPluginDir()` Plugin API**: Plugins can now locate their own package directory to find bundled scripts or install local dependencies.
+
+### Bug Fixes
+
+* Fixed CSI u and xterm modifyOtherKeys key sequences inserted as literal text in terminal session mode (#1113).
+
+* Fixed word selection (Ctrl+W) stopping at accented/Unicode characters (#1332).
+
+* Fixed double-click backward drag losing the initial word selection (#1334).
+
+* Fixed block cursor invisible in zellij due to double cursor-inversion (#1338).
+
+* Fixed cursor visibility and command palette rendering in zellij (#1255).
+
+* Fixed undo incorrectly clearing the modified flag after hot exit recovery, which could cause data loss.
+
+* Fixed bulk edit (e.g., toggle comment) displacing inlay hints on subsequent lines (#1263). Displaced markers are now restored to exact positions on undo.
+
+* Fixed large file syntax highlighting lost when revisiting a file, caused by checkpoint offset drift during partial cache updates.
+
+* Fixed embedded language highlighting (e.g., CSS in HTML) breaking at large file offsets.
+
+* Fixed Enter key leaking into the markdown buffer when the file explorer panel is focused.
+
+* Fixed large file recovery saving the entire file as individual chunks instead of using the recovery format.
+
+* Fixed read-only detection for files not owned by the current user (now checks effective uid/gid instead of file mode bits).
+
+## 0.2.18
+
+### Features
+
+* **Bracketed Paste on Windows & Input Overhaul**: Bracketed paste now works on Windows Terminal (reverted in v0.2.17 due to #1284), and keyboard issues are resolved (#1054). **Mouse hover is disabled by default on Windows** because reliable bracketed paste requires cell-motion tracking; enabling hover switches to all-motion tracking which can insert corrupt text under heavy mouse movement or slow CPU. Re-enable it in Settings UI under Editor → Mouse Hover Enabled. Under the hood, crossterm's Windows input handling is replaced with a new `fresh-winterm` crate using direct VT input reads, with corrupt mouse sequence detection, UTF-16 surrogate handling, and console mode heartbeat to counteract ConPTY drift.
+
+* **30 New Syntax Grammars**: Dockerfile, CMake, INI, SCSS, LESS, PowerShell, Kotlin, Swift, Dart, Elixir, F#, Nix, Terraform/HCL, Protobuf, GraphQL, Julia, Nim, Gleam, V, Solidity, KDL, Nushell, Starlark, Justfile, Earthfile, Go Module, Vue, Svelte, Astro, Hyprlang (#1266). These grammars are preliminary — please report highlighting issues for your language so we can improve them.
+
+* **Broad LSP Support**: Added LSP configs and helper plugins (with install instructions) for Nix, Kotlin, Swift, Scala, Elixir, Erlang, Haskell, OCaml, Clojure, R, Julia, Perl, Nim, Gleam, F#, Dart (#1252), Nushell (#1031), Solidity (#857), Vue, Svelte, Astro, Tailwind CSS, Terraform/HCL, CMake, Protobuf, GraphQL, SQL, Bash, Lua, Ruby, PHP, YAML, TOML, and Typst. LSP integration for these languages is early-stage — feedback from users of these languages is welcome.
+
+* **Deno LSP Auto-Detection**: Automatically detects and uses the Deno language server for JS/TS projects (#1191).
+
+* **`show_prompt_line` Setting**: New config option to auto-hide the prompt line. Applied immediately from Settings UI (#1273).
+
+* **`use_tabs` Setting**: Global `editor.use_tabs` config option for default tab indentation (#1295).
+
+### Improvements
+
+* **Plugin Commands in Keybinding Editor**: Plugin-registered commands are now shown and searchable in the keybinding editor.
+
+* **Theme Editor ANSI Colors**: Named ANSI colors display as "terminal native" instead of misleading RGB values, with correct native color swatches (#1301).
+
+* **Status Bar Language Info**: Shows "[syntax only]" when a language has no LSP config entry.
+
+* **Fallback Language Config**: Undetected file types now get a fallback language configuration (#1219).
+
+* **File Deletion Uses Trash**: `removePath` now uses the system trash instead of permanent deletion.
+
+* **Package Manager Cross-Platform**: Plugin package manager uses cross-platform APIs instead of Unix-specific commands on Windows (#1215).
+
+### Bug Fixes
+
+* Fixed arrow keys not working in `less`/`git log` in the embedded terminal, including `TERM` env var not being set on Unix.
+
+* Fixed Tab key getting trapped in TextList editing mode in Settings UI.
+
+* Fixed `{`, `}`, `;` highlighted as operators instead of punctuation in C/C++ (#1318, #1319).
+
+* Fixed auto-dedent for languages without tree-sitter, e.g. Dart.
+
+* Fixed auto-indent after closing brace in nested C++ blocks.
+
+* Fixed mouse click selecting wrong item in scrolled settings list.
+
+* Fixed keybindings for plugin-registered commands not executing (#1312).
+
+* Fixed Find Next/Find Previous ignoring cursor position (#1305).
+
+* Fixed Tab indent affecting lines outside selection (#1304).
+
+* Fixed Shift+letter keybinding deletion not persisting (#1303).
+
+* Fixed word selection not preserved when dragging after double-click (#1202, #1317).
+
+* Fixed `removePath` failing on Windows due to UNC path mismatch.
+
+* Fixed external files missing from tab bar after session restore.
+
+* Fixed scroll wheel targeting focused split instead of split under pointer (#1270).
+
+* Fixed wrap indent not working with tab indentation (#1283).
+
+* Fixed LSP "no server configured" for Kotlin and 30+ other languages.
+
+* Fixed Diff syntax highlighting scope-to-category mappings.
+
+* Fixed extension mappings for `.cjs`, `.mjs`, `.mts`, `.cts`, `Jenkinsfile`, `Brewfile`.
+
+* Fixed LSP initialization timeout too short (increased from 10s to 60s).
+
+### Internal
+
+* Added syntax highlighting validation suite with 93 fixture files and e2e tests.
+
+* Added e2e tests for Settings UI, keybinding editor, search/replace, and plugin commands.
+
+* Fixed multiple flaky e2e tests (search/replace, plugin uninstall, Settings UI).
+
+* Removed redundant `SIGUSR1` handler; relies on harness signal handler for backtraces.
+
+* Cleaned up completed design docs.
+
+---
+
 ## 0.2.17
 
 ### Bug Fixes

package/package.json

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

package/plugins/astro-lsp.ts

@@ -0,0 +1,118 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Astro LSP Helper Plugin
+ *
+ * Server: @astrojs/language-server (binary: astro-ls)
+ * VS Code: "Astro" official extension
+ * Neovim: nvim-lspconfig astro
+ * Note: Powered by Volar; may need typescript.tsdk init option
+ */
+
+interface LspServerErrorData {
+  language: string;
+  server_command: string;
+  error_type: string;
+  message: string;
+}
+
+interface LspStatusClickedData {
+  language: string;
+  has_error: boolean;
+}
+
+interface ActionPopupResultData {
+  popup_id: string;
+  action_id: string;
+}
+
+const INSTALL_COMMANDS = {
+  npm: "npm install -g @astrojs/language-server",
+  yarn: "yarn global add @astrojs/language-server",
+  pnpm: "pnpm add -g @astrojs/language-server",
+};
+
+let astroLspError: { serverCommand: string; message: string } | null = null;
+
+function on_astro_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "astro") {
+    return;
+  }
+
+  editor.debug(`astro-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  astroLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Astro LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Astro LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_astro_lsp_server_error", on_astro_lsp_server_error);
+editor.on("lsp_server_error", "on_astro_lsp_server_error");
+
+function on_astro_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "astro" || !astroLspError) {
+    return;
+  }
+
+  editor.debug("astro-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "astro-lsp-help",
+    title: "Astro Language Server Not Found",
+    message: `"${astroLspError.serverCommand}" provides completion, diagnostics, and formatting for Astro components. Powered by the Volar framework.\n\nRequires TypeScript to be installed in your project for full functionality.\nVS Code users: Install the official "Astro" extension.\nSee: https://github.com/withastro/language-tools`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_pnpm", label: `Copy: ${INSTALL_COMMANDS.pnpm}` },
+      { id: "disable", label: "Disable Astro LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_astro_lsp_status_clicked", on_astro_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_astro_lsp_status_clicked");
+
+function on_astro_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "astro-lsp-help") {
+    return;
+  }
+
+  editor.debug(`astro-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_npm":
+      editor.setClipboard(INSTALL_COMMANDS.npm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.npm);
+      break;
+
+    case "copy_pnpm":
+      editor.setClipboard(INSTALL_COMMANDS.pnpm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pnpm);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("astro");
+      editor.setStatus("Astro LSP disabled");
+      astroLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`astro-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_astro_lsp_action_result", on_astro_lsp_action_result);
+editor.on("action_popup_result", "on_astro_lsp_action_result");
+
+editor.debug("astro-lsp: Plugin loaded");

package/plugins/bash-lsp.ts

@@ -0,0 +1,161 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Bash/Shell LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Bash LSP server issues.
+ * When bash-language-server fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects Bash LSP server errors (bash-language-server)
+ * - Shows popup with install commands (npm, yarn, pnpm)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable Bash LSP
+ *
+ * Alternatives:
+ * - ShellCheck: Linting/static analysis for shell scripts (https://www.shellcheck.net/)
+ */
+
+interface LspServerErrorData {
+  language: string;
+  server_command: string;
+  error_type: string;
+  message: string;
+}
+
+interface LspStatusClickedData {
+  language: string;
+  has_error: boolean;
+}
+
+interface ActionPopupResultData {
+  popup_id: string;
+  action_id: string;
+}
+
+// Install commands for Bash LSP server (bash-language-server)
+// See: https://github.com/bash-lsp/bash-language-server
+const INSTALL_COMMANDS = {
+  npm: "npm i -g bash-language-server",
+  yarn: "yarn global add bash-language-server",
+  pnpm: "pnpm add -g bash-language-server",
+};
+
+// Track error state for Bash LSP
+let bashLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Bash
+ */
+function on_bash_lsp_server_error(data: LspServerErrorData): void {
+  // Only handle Bash language errors
+  if (data.language !== "bash") {
+    return;
+  }
+
+  editor.debug(`bash-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  bashLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Bash LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Bash LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_bash_lsp_server_error", on_bash_lsp_server_error);
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_bash_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Bash LSP error
+ */
+function on_bash_lsp_status_clicked(
+  data: LspStatusClickedData
+): void {
+  // Only handle Bash language clicks when there's an error
+  if (data.language !== "bash" || !bashLspError) {
+    return;
+  }
+
+  editor.debug("bash-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "bash-lsp-help",
+    title: "Bash Language Server Not Found",
+    message: `"${bashLspError.serverCommand}" provides code completion, diagnostics, and navigation for shell scripts. Requires Node.js. Copy a command below to install it, or visit https://github.com/bash-lsp/bash-language-server for details. For linting, also consider ShellCheck (https://www.shellcheck.net/).`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_yarn", label: `Copy: ${INSTALL_COMMANDS.yarn}` },
+      { id: "copy_pnpm", label: `Copy: ${INSTALL_COMMANDS.pnpm}` },
+      { id: "disable", label: "Disable Bash LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_bash_lsp_status_clicked", on_bash_lsp_status_clicked);
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_bash_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Bash LSP help
+ */
+function on_bash_lsp_action_result(
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "bash-lsp-help") {
+    return;
+  }
+
+  editor.debug(`bash-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_npm":
+      editor.setClipboard(INSTALL_COMMANDS.npm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.npm);
+      break;
+
+    case "copy_yarn":
+      editor.setClipboard(INSTALL_COMMANDS.yarn);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.yarn);
+      break;
+
+    case "copy_pnpm":
+      editor.setClipboard(INSTALL_COMMANDS.pnpm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pnpm);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("bash");
+      editor.setStatus("Bash LSP disabled");
+      bashLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`bash-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_bash_lsp_action_result", on_bash_lsp_action_result);
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_bash_lsp_action_result");
+
+editor.debug("bash-lsp: Plugin loaded");

package/plugins/clojure-lsp.ts

@@ -0,0 +1,125 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Clojure LSP Helper Plugin
+ *
+ * Server: clojure-lsp (github.com/clojure-lsp/clojure-lsp)
+ * VS Code: "Calva" extension (bundles clojure-lsp)
+ * Neovim: nvim-lspconfig clojure_lsp
+ * Note: Works with Clojure, ClojureScript, and ClojureDart
+ * No project setup needed - analyzes classpath automatically
+ */
+
+interface LspServerErrorData {
+  language: string;
+  server_command: string;
+  error_type: string;
+  message: string;
+}
+
+interface LspStatusClickedData {
+  language: string;
+  has_error: boolean;
+}
+
+interface ActionPopupResultData {
+  popup_id: string;
+  action_id: string;
+}
+
+const INSTALL_COMMANDS = {
+  brew: "brew install clojure-lsp/brew/clojure-lsp-native",
+  nix: "nix-shell -p clojure-lsp",
+  script: "sudo bash < <(curl -s https://raw.githubusercontent.com/clojure-lsp/clojure-lsp/master/install)",
+};
+
+let clojureLspError: { serverCommand: string; message: string } | null = null;
+
+function on_clojure_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "clojure") {
+    return;
+  }
+
+  editor.debug(`clojure-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  clojureLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Clojure LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Clojure LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_clojure_lsp_server_error", on_clojure_lsp_server_error);
+editor.on("lsp_server_error", "on_clojure_lsp_server_error");
+
+function on_clojure_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "clojure" || !clojureLspError) {
+    return;
+  }
+
+  editor.debug("clojure-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "clojure-lsp-help",
+    title: "Clojure Language Server Not Found",
+    message: `"${clojureLspError.serverCommand}" provides completion, diagnostics, refactoring, and navigation for Clojure/ClojureScript.\n\nNo special project setup needed - it analyzes classpath automatically.\nVS Code users: Install "Calva" (bundles clojure-lsp and nREPL client).\nSee: https://clojure-lsp.io`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "copy_script", label: `Copy: install script (Linux/macOS)` },
+      { id: "disable", label: "Disable Clojure LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_clojure_lsp_status_clicked", on_clojure_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_clojure_lsp_status_clicked");
+
+function on_clojure_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "clojure-lsp-help") {
+    return;
+  }
+
+  editor.debug(`clojure-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_nix":
+      editor.setClipboard(INSTALL_COMMANDS.nix);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix);
+      break;
+
+    case "copy_script":
+      editor.setClipboard(INSTALL_COMMANDS.script);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.script);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("clojure");
+      editor.setStatus("Clojure LSP disabled");
+      clojureLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`clojure-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_clojure_lsp_action_result", on_clojure_lsp_action_result);
+editor.on("action_popup_result", "on_clojure_lsp_action_result");
+
+editor.debug("clojure-lsp: Plugin loaded");