@fresh-editor/fresh-editor 0.2.17 → 0.2.20

package/plugins/julia-lsp.ts

@@ -0,0 +1,111 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Julia LSP Helper Plugin
+ *
+ * Server: LanguageServer.jl (Julia package)
+ * VS Code: "Julia" extension (bundles LanguageServer.jl)
+ * Neovim: nvim-lspconfig julials
+ * Install via: Julia's Pkg.add() - runs as a Julia script
+ * Note: First startup can be slow due to Julia compilation
+ */
+
+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 = {
+  julia: 'julia -e \'using Pkg; Pkg.add("LanguageServer")\'',
+};
+
+let juliaLspError: { serverCommand: string; message: string } | null = null;
+
+function on_julia_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "julia") {
+    return;
+  }
+
+  editor.debug(`julia-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  juliaLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Julia LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Julia LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_julia_lsp_server_error", on_julia_lsp_server_error);
+editor.on("lsp_server_error", "on_julia_lsp_server_error");
+
+function on_julia_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "julia" || !juliaLspError) {
+    return;
+  }
+
+  editor.debug("julia-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "julia-lsp-help",
+    title: "Julia Language Server Not Found",
+    message: `The Julia language server (LanguageServer.jl) provides completion, diagnostics, formatting, and navigation for Julia. Julia must be installed.\n\nNote: First startup is slow due to Julia's compilation. Consider using PackageCompiler.jl for faster restarts.\nVS Code users: Install the "Julia" extension (auto-installs LanguageServer.jl).\nSee: https://github.com/julia-vscode/LanguageServer.jl`,
+    actions: [
+      { id: "copy_julia", label: `Copy: ${INSTALL_COMMANDS.julia}` },
+      { id: "disable", label: "Disable Julia LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_julia_lsp_status_clicked", on_julia_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_julia_lsp_status_clicked");
+
+function on_julia_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "julia-lsp-help") {
+    return;
+  }
+
+  editor.debug(`julia-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_julia":
+      editor.setClipboard(INSTALL_COMMANDS.julia);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.julia);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("julia");
+      editor.setStatus("Julia LSP disabled");
+      juliaLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`julia-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_julia_lsp_action_result", on_julia_lsp_action_result);
+editor.on("action_popup_result", "on_julia_lsp_action_result");
+
+editor.debug("julia-lsp: Plugin loaded");

package/plugins/kotlin-lsp.ts

@@ -0,0 +1,162 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Kotlin LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Kotlin LSP server issues.
+ * When kotlin-language-server fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects Kotlin LSP server errors (kotlin-language-server)
+ * - Shows popup with install commands (brew, SDKMAN, snap)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable Kotlin LSP
+ *
+ * VS Code: "Kotlin" extension (fwcd.kotlin)
+ * Neovim: nvim-lspconfig kotlin_language_server
+ * Note: Requires JDK 11+. For full IDE support, consider IntelliJ IDEA
+ */
+
+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 Kotlin LSP server (kotlin-language-server)
+// See: https://github.com/fwcd/kotlin-language-server
+const INSTALL_COMMANDS = {
+  brew: "brew install kotlin-language-server",
+  snap: "sudo snap install kotlin-language-server --classic",
+  nix: "nix-env -i kotlin-language-server",
+};
+
+// Track error state for Kotlin LSP
+let kotlinLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Kotlin
+ */
+function on_kotlin_lsp_server_error(data: LspServerErrorData): void {
+  // Only handle Kotlin language errors
+  if (data.language !== "kotlin") {
+    return;
+  }
+
+  editor.debug(`kotlin-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  kotlinLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Kotlin LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Kotlin LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_kotlin_lsp_server_error", on_kotlin_lsp_server_error);
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_kotlin_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Kotlin LSP error
+ */
+function on_kotlin_lsp_status_clicked(
+  data: LspStatusClickedData
+): void {
+  // Only handle Kotlin language clicks when there's an error
+  if (data.language !== "kotlin" || !kotlinLspError) {
+    return;
+  }
+
+  editor.debug("kotlin-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "kotlin-lsp-help",
+    title: "Kotlin Language Server Not Found",
+    message: `"${kotlinLspError.serverCommand}" provides code completion, diagnostics, and navigation for Kotlin files. Requires a JDK (Java 11+). Copy a command below to install it, or visit https://github.com/fwcd/kotlin-language-server for build instructions and releases. For full Kotlin IDE support, consider IntelliJ IDEA or Android Studio.`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_snap", label: `Copy: ${INSTALL_COMMANDS.snap}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable Kotlin LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_kotlin_lsp_status_clicked", on_kotlin_lsp_status_clicked);
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_kotlin_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Kotlin LSP help
+ */
+function on_kotlin_lsp_action_result(
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "kotlin-lsp-help") {
+    return;
+  }
+
+  editor.debug(`kotlin-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_snap":
+      editor.setClipboard(INSTALL_COMMANDS.snap);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.snap);
+      break;
+
+    case "copy_nix":
+      editor.setClipboard(INSTALL_COMMANDS.nix);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("kotlin");
+      editor.setStatus("Kotlin LSP disabled");
+      kotlinLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`kotlin-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_kotlin_lsp_action_result", on_kotlin_lsp_action_result);
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_kotlin_lsp_action_result");
+
+editor.debug("kotlin-lsp: Plugin loaded");

package/plugins/lib/finder.ts

@@ -115,6 +115,9 @@ export interface FinderConfig<T> {
 
   /** Panel-specific: navigate source split when cursor moves (preview without focus change) */
   navigateOnCursorMove?: boolean;
+
+  /** Called when the panel or prompt is closed (e.g. via Escape) */
+  onClose?: () => void;
 }
 
 /**
@@ -1254,18 +1257,17 @@ export class Finder<T> {
     if (this.config.onSelect) {
       this.config.onSelect(item, entry);
     } else if (entry.location) {
-      // Default: open file at location
-      if (this.panelState.sourceSplitId !== null) {
-        this.editor.focusSplit(this.panelState.sourceSplitId);
-      }
-      this.editor.openFile(
-        entry.location.file,
-        entry.location.line,
-        entry.location.column
-      );
-      this.editor.setStatus(
-        `Jumped to ${entry.location.file}:${entry.location.line}`
-      );
+      const loc = entry.location;
+
+      // Close the panel first. This is necessary because
+      // navigateOnCursorMove's focusSplit(panelSplitId) can interfere with
+      // the jump — it queues a FocusSplit that runs after OpenFileInSplit
+      // and restores the panel as the active split.
+      this.closePanel();
+
+      // Now navigate with the panel gone — only one split remains
+      this.editor.openFile(loc.file, loc.line, loc.column);
+      this.editor.setStatus(`Jumped to ${loc.file}:${loc.line}`);
     }
   }
 
@@ -1306,6 +1308,11 @@ export class Finder<T> {
     }
 
     this.editor.setStatus("Closed");
+
+    // Notify the caller that the panel was closed
+    if (this.config.onClose) {
+      this.config.onClose();
+    }
   }
 
   private revealItem(index: number): void {

package/plugins/lib/fresh.d.ts

@@ -539,7 +539,6 @@ type BackgroundProcessResult = {
 type BufferSavedDiff = {
 	equal: boolean;
 	byte_ranges: Array<[number, number]>;
-	line_ranges: Array<[number, number]> | null;
 };
 type CreateVirtualBufferInExistingSplitOptions = {
 	/**
@@ -1031,6 +1030,31 @@ interface EditorAPI {
 	*/
 	readDir(path: string): DirEntry[];
 	/**
+	* Create a directory (and all parent directories) recursively.
+	* Returns true if the directory was created or already exists.
+	*/
+	createDir(path: string): boolean;
+	/**
+	* Remove a file or directory by moving it to the OS trash/recycle bin.
+	* For safety, the path must be under the OS temp directory or the Fresh
+	* config directory. Returns true on success.
+	*/
+	removePath(path: string): boolean;
+	/**
+	* Rename/move a file or directory. Returns true on success.
+	* Falls back to copy then trash for cross-filesystem moves.
+	*/
+	renamePath(from: string, to: string): boolean;
+	/**
+	* Copy a file or directory recursively to a new location.
+	* Returns true on success.
+	*/
+	copyPath(from: string, to: string): boolean;
+	/**
+	* Get the OS temporary directory path.
+	*/
+	getTempDir(): string;
+	/**
 	* Get current config as JS object
 	*/
 	getConfig(): unknown;
@@ -1071,6 +1095,11 @@ interface EditorAPI {
 	*/
 	reloadGrammars(): Promise<void>;
 	/**
+	* Get the directory where this plugin's files are stored.
+	* For package plugins this is `<plugins_dir>/packages/<plugin_name>/`.
+	*/
+	getPluginDir(): string;
+	/**
 	* Get config directory path
 	*/
 	getConfigDir(): string;

package/plugins/lua-lsp.ts

@@ -0,0 +1,161 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Lua LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Lua LSP server issues.
+ * When lua-language-server fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects Lua LSP server errors (lua-language-server / LuaLS)
+ * - Shows popup with install commands (brew, pacman, etc.)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable Lua LSP
+ *
+ * Alternatives:
+ * - EmmyLua: IntelliJ-based Lua IDE support
+ */
+
+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 Lua LSP server (lua-language-server / LuaLS)
+// See: https://luals.github.io/#install
+const INSTALL_COMMANDS = {
+  brew: "brew install lua-language-server",
+  pacman: "sudo pacman -S lua-language-server",
+  nix: "nix-env -i lua-language-server",
+};
+
+// Track error state for Lua LSP
+let luaLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Lua
+ */
+function on_lua_lsp_server_error(data: LspServerErrorData): void {
+  // Only handle Lua language errors
+  if (data.language !== "lua") {
+    return;
+  }
+
+  editor.debug(`lua-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  luaLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Lua LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Lua LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_lua_lsp_server_error", on_lua_lsp_server_error);
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_lua_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Lua LSP error
+ */
+function on_lua_lsp_status_clicked(
+  data: LspStatusClickedData
+): void {
+  // Only handle Lua language clicks when there's an error
+  if (data.language !== "lua" || !luaLspError) {
+    return;
+  }
+
+  editor.debug("lua-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "lua-lsp-help",
+    title: "Lua Language Server Not Found",
+    message: `"${luaLspError.serverCommand}" (LuaLS) provides code completion, diagnostics, and navigation for Lua files. Copy a command below to install it, or visit https://luals.github.io/#install for platform-specific instructions. Pre-built binaries are also available from https://github.com/LuaLS/lua-language-server/releases.`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_pacman", label: `Copy: ${INSTALL_COMMANDS.pacman}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable Lua LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_lua_lsp_status_clicked", on_lua_lsp_status_clicked);
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_lua_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Lua LSP help
+ */
+function on_lua_lsp_action_result(
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "lua-lsp-help") {
+    return;
+  }
+
+  editor.debug(`lua-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_pacman":
+      editor.setClipboard(INSTALL_COMMANDS.pacman);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pacman);
+      break;
+
+    case "copy_nix":
+      editor.setClipboard(INSTALL_COMMANDS.nix);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("lua");
+      editor.setStatus("Lua LSP disabled");
+      luaLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`lua-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_lua_lsp_action_result", on_lua_lsp_action_result);
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_lua_lsp_action_result");
+
+editor.debug("lua-lsp: Plugin loaded");

package/plugins/nim-lsp.ts

@@ -0,0 +1,118 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Nim LSP Helper Plugin
+ *
+ * Server: nimlangserver (github.com/nim-lang/langserver)
+ * VS Code: "Nim" extension (nimsaem.nimvscode)
+ * Neovim: nvim-lspconfig nim_langserver
+ * Install via: nimble (Nim package manager)
+ * Alternative: nimlsp (older, less maintained)
+ */
+
+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 = {
+  nimble: "nimble install nimlangserver",
+  choosenim: "choosenim stable && nimble install nimlangserver",
+};
+
+let nimLspError: { serverCommand: string; message: string } | null = null;
+
+function on_nim_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "nim") {
+    return;
+  }
+
+  editor.debug(`nim-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  nimLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Nim LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Nim LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_nim_lsp_server_error", on_nim_lsp_server_error);
+editor.on("lsp_server_error", "on_nim_lsp_server_error");
+
+function on_nim_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "nim" || !nimLspError) {
+    return;
+  }
+
+  editor.debug("nim-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "nim-lsp-help",
+    title: "Nim Language Server Not Found",
+    message: `"${nimLspError.serverCommand}" provides completion, diagnostics, hover, and go-to-definition for Nim. Requires Nim and nimble.\n\nInstall Nim via choosenim: curl https://nim-lang.org/choosenim/init.sh -sSf | sh\nVS Code users: Install the "Nim" extension.\nSee: https://github.com/nim-lang/langserver`,
+    actions: [
+      { id: "copy_nimble", label: `Copy: ${INSTALL_COMMANDS.nimble}` },
+      { id: "copy_choosenim", label: `Copy: ${INSTALL_COMMANDS.choosenim}` },
+      { id: "disable", label: "Disable Nim LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_nim_lsp_status_clicked", on_nim_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_nim_lsp_status_clicked");
+
+function on_nim_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "nim-lsp-help") {
+    return;
+  }
+
+  editor.debug(`nim-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_nimble":
+      editor.setClipboard(INSTALL_COMMANDS.nimble);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nimble);
+      break;
+
+    case "copy_choosenim":
+      editor.setClipboard(INSTALL_COMMANDS.choosenim);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.choosenim);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("nim");
+      editor.setStatus("Nim LSP disabled");
+      nimLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`nim-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_nim_lsp_action_result", on_nim_lsp_action_result);
+editor.on("action_popup_result", "on_nim_lsp_action_result");
+
+editor.debug("nim-lsp: Plugin loaded");