@fresh-editor/fresh-editor 0.2.16 → 0.2.18

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");

package/plugins/nix-lsp.ts

@@ -0,0 +1,125 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Nix LSP Helper Plugin
+ *
+ * Server: nil (github.com/oxalica/nil)
+ * VS Code: "Nix IDE" extension (uses nil or nixd)
+ * Neovim: nvim-lspconfig nil_ls
+ * Alternative: nixd (richer completions, option evaluation, flake support)
+ * Note: rnix-lsp is deprecated, use nil or nixd instead
+ */
+
+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 = {
+  nix_profile: "nix profile install github:oxalica/nil",
+  nix_env: "nix-env -iA nixpkgs.nil",
+  nixd: "nix profile install nixpkgs#nixd",
+};
+
+let nixLspError: { serverCommand: string; message: string } | null = null;
+
+function on_nix_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "nix") {
+    return;
+  }
+
+  editor.debug(`nix-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  nixLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Nix LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Nix LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_nix_lsp_server_error", on_nix_lsp_server_error);
+editor.on("lsp_server_error", "on_nix_lsp_server_error");
+
+function on_nix_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "nix" || !nixLspError) {
+    return;
+  }
+
+  editor.debug("nix-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "nix-lsp-help",
+    title: "Nix Language Server Not Found",
+    message: `"${nixLspError.serverCommand}" provides completion, diagnostics, go-to-definition, and rename for Nix files.\n\nAlternative: nixd offers richer completions, option evaluation, and flake support.\nNote: rnix-lsp is deprecated.\nVS Code users: Install "Nix IDE" extension.\nSee: https://github.com/oxalica/nil`,
+    actions: [
+      { id: "copy_nix_profile", label: `Copy: ${INSTALL_COMMANDS.nix_profile}` },
+      { id: "copy_nix_env", label: `Copy: ${INSTALL_COMMANDS.nix_env}` },
+      { id: "copy_nixd", label: `Copy: ${INSTALL_COMMANDS.nixd}` },
+      { id: "disable", label: "Disable Nix LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_nix_lsp_status_clicked", on_nix_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_nix_lsp_status_clicked");
+
+function on_nix_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "nix-lsp-help") {
+    return;
+  }
+
+  editor.debug(`nix-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_nix_profile":
+      editor.setClipboard(INSTALL_COMMANDS.nix_profile);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix_profile);
+      break;
+
+    case "copy_nix_env":
+      editor.setClipboard(INSTALL_COMMANDS.nix_env);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix_env);
+      break;
+
+    case "copy_nixd":
+      editor.setClipboard(INSTALL_COMMANDS.nixd);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nixd);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("nix");
+      editor.setStatus("Nix LSP disabled");
+      nixLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`nix-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_nix_lsp_action_result", on_nix_lsp_action_result);
+editor.on("action_popup_result", "on_nix_lsp_action_result");
+
+editor.debug("nix-lsp: Plugin loaded");

package/plugins/nushell-lsp.ts

@@ -0,0 +1,144 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Nushell LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Nushell LSP server issues.
+ * The LSP server is built into the Nushell binary (nu --lsp).
+ *
+ * Features:
+ * - Detects Nushell LSP server errors
+ * - Shows popup with install instructions for Nushell
+ * - Provides option to disable Nushell LSP
+ *
+ * VS Code: "Nushell" extension (vscode-nushell-lang)
+ * Neovim: nvim-lspconfig nushell
+ * Note: The LSP server is built into the `nu` binary itself
+ * No separate LSP installation needed if Nushell is installed
+ */
+
+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 Nushell (which includes the language server)
+// See: https://www.nushell.sh/book/installation.html
+const INSTALL_COMMANDS = {
+  cargo: "cargo install nu",
+  brew: "brew install nushell",
+  winget: "winget install nushell",
+};
+
+// Track error state for Nushell LSP
+let nushellLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Nushell
+ */
+function on_nushell_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "nushell") {
+    return;
+  }
+
+  editor.debug(`nushell-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  nushellLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Nushell LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Nushell LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_nushell_lsp_server_error", on_nushell_lsp_server_error);
+editor.on("lsp_server_error", "on_nushell_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Nushell LSP error
+ */
+function on_nushell_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "nushell" || !nushellLspError) {
+    return;
+  }
+
+  editor.debug("nushell-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "nushell-lsp-help",
+    title: "Nushell Language Server Not Found",
+    message: `The Nushell LSP server is built into the "nu" binary. Install Nushell to get LSP support. Visit https://www.nushell.sh/book/installation.html for platform-specific instructions.`,
+    actions: [
+      { id: "copy_cargo", label: `Copy: ${INSTALL_COMMANDS.cargo}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_winget", label: `Copy: ${INSTALL_COMMANDS.winget} (Windows)` },
+      { id: "disable", label: "Disable Nushell LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_nushell_lsp_status_clicked", on_nushell_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_nushell_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Nushell LSP help
+ */
+function on_nushell_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "nushell-lsp-help") {
+    return;
+  }
+
+  editor.debug(`nushell-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_cargo":
+      editor.setClipboard(INSTALL_COMMANDS.cargo);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.cargo);
+      break;
+
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_winget":
+      editor.setClipboard(INSTALL_COMMANDS.winget);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.winget);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("nushell");
+      editor.setStatus("Nushell LSP disabled");
+      nushellLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`nushell-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_nushell_lsp_action_result", on_nushell_lsp_action_result);
+editor.on("action_popup_result", "on_nushell_lsp_action_result");
+
+editor.debug("nushell-lsp: Plugin loaded");

package/plugins/ocaml-lsp.ts

@@ -0,0 +1,119 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * OCaml LSP Helper Plugin
+ *
+ * Server: ocaml-lsp-server (binary: ocamllsp)
+ * VS Code: "OCaml Platform" extension
+ * Neovim: nvim-lspconfig ocamllsp
+ * Install via: opam (OCaml package manager)
+ * Note: Requires opam switch with merlin installed
+ */
+
+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 = {
+  opam: "opam install ocaml-lsp-server",
+  brew_opam: "brew install opam && opam init && opam install ocaml-lsp-server",
+  nix: "nix-env -iA nixpkgs.ocaml-lsp",
+};
+
+let ocamlLspError: { serverCommand: string; message: string } | null = null;
+
+function on_ocaml_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "ocaml") {
+    return;
+  }
+
+  editor.debug(`ocaml-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  ocamlLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `OCaml LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`OCaml LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_ocaml_lsp_server_error", on_ocaml_lsp_server_error);
+editor.on("lsp_server_error", "on_ocaml_lsp_server_error");
+
+function on_ocaml_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "ocaml" || !ocamlLspError) {
+    return;
+  }
+
+  editor.debug("ocaml-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "ocaml-lsp-help",
+    title: "OCaml Language Server Not Found",
+    message: `"${ocamlLspError.serverCommand}" provides completion, diagnostics, type info, and refactoring for OCaml. Built on merlin.\n\nRequires opam (OCaml package manager). Install ocaml-lsp-server in your current opam switch.\nVS Code users: Install the "OCaml Platform" extension.\nSee: https://github.com/ocaml/ocaml-lsp`,
+    actions: [
+      { id: "copy_opam", label: `Copy: ${INSTALL_COMMANDS.opam}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable OCaml LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_ocaml_lsp_status_clicked", on_ocaml_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_ocaml_lsp_status_clicked");
+
+function on_ocaml_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "ocaml-lsp-help") {
+    return;
+  }
+
+  editor.debug(`ocaml-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_opam":
+      editor.setClipboard(INSTALL_COMMANDS.opam);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.opam);
+      break;
+
+    case "copy_nix":
+      editor.setClipboard(INSTALL_COMMANDS.nix);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("ocaml");
+      editor.setStatus("OCaml LSP disabled");
+      ocamlLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`ocaml-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_ocaml_lsp_action_result", on_ocaml_lsp_action_result);
+editor.on("action_popup_result", "on_ocaml_lsp_action_result");
+
+editor.debug("ocaml-lsp: Plugin loaded");