@fresh-editor/fresh-editor 0.2.17 → 0.2.20

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

package/plugins/perl-lsp.ts

@@ -0,0 +1,118 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Perl LSP Helper Plugin
+ *
+ * Server: PerlNavigator (github.com/bscan/PerlNavigator)
+ * VS Code: "Perl Navigator" extension
+ * Neovim: nvim-lspconfig perlnavigator
+ * Alternative: Perl::LanguageServer (cpan, older)
+ * Note: PerlNavigator includes perlcritic and perltidy integration
+ */
+
+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 perlnavigator-server",
+  cpan_alt: "cpanm Perl::LanguageServer",
+};
+
+let perlLspError: { serverCommand: string; message: string } | null = null;
+
+function on_perl_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "perl") {
+    return;
+  }
+
+  editor.debug(`perl-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  perlLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Perl LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Perl LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_perl_lsp_server_error", on_perl_lsp_server_error);
+editor.on("lsp_server_error", "on_perl_lsp_server_error");
+
+function on_perl_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "perl" || !perlLspError) {
+    return;
+  }
+
+  editor.debug("perl-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "perl-lsp-help",
+    title: "Perl Language Server Not Found",
+    message: `"${perlLspError.serverCommand}" (PerlNavigator) provides completion, diagnostics, navigation, and perlcritic/perltidy integration for Perl.\n\nAlternative: Perl::LanguageServer (older, via CPAN).\nVS Code users: Install the "Perl Navigator" extension.\nSee: https://github.com/bscan/PerlNavigator`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_cpan", label: `Copy: ${INSTALL_COMMANDS.cpan_alt}` },
+      { id: "disable", label: "Disable Perl LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_perl_lsp_status_clicked", on_perl_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_perl_lsp_status_clicked");
+
+function on_perl_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "perl-lsp-help") {
+    return;
+  }
+
+  editor.debug(`perl-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_cpan":
+      editor.setClipboard(INSTALL_COMMANDS.cpan_alt);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.cpan_alt);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("perl");
+      editor.setStatus("Perl LSP disabled");
+      perlLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`perl-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_perl_lsp_action_result", on_perl_lsp_action_result);
+editor.on("action_popup_result", "on_perl_lsp_action_result");
+
+editor.debug("perl-lsp: Plugin loaded");

package/plugins/php-lsp.ts

@@ -0,0 +1,165 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * PHP LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for PHP LSP server issues.
+ * When phpactor fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects PHP LSP server errors (phpactor)
+ * - Shows popup with install commands (composer, brew)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable PHP LSP
+ *
+ * Alternatives:
+ * - Intelephense: Feature-rich PHP LSP (https://intelephense.com/) - npm i -g intelephense
+ * - PHPStan: Static analysis tool (https://phpstan.org/)
+ * - Psalm: PHP static analysis (https://psalm.dev/)
+ */
+
+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 PHP LSP server (phpactor)
+// See: https://phpactor.readthedocs.io/en/master/usage/getting-started.html
+const INSTALL_COMMANDS = {
+  composer: "composer global require phpactor/phpactor",
+  brew: "brew install phpactor",
+};
+
+// Alternative LSP server
+const ALT_INSTALL = "npm i -g intelephense";
+
+// Track error state for PHP LSP
+let phpLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for PHP
+ */
+function on_php_lsp_server_error(data: LspServerErrorData): void {
+  // Only handle PHP language errors
+  if (data.language !== "php") {
+    return;
+  }
+
+  editor.debug(`php-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  phpLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `PHP LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`PHP LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_php_lsp_server_error", on_php_lsp_server_error);
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_php_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a PHP LSP error
+ */
+function on_php_lsp_status_clicked(
+  data: LspStatusClickedData
+): void {
+  // Only handle PHP language clicks when there's an error
+  if (data.language !== "php" || !phpLspError) {
+    return;
+  }
+
+  editor.debug("php-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "php-lsp-help",
+    title: "PHP Language Server Not Found",
+    message: `"${phpLspError.serverCommand}" provides code completion, diagnostics, and navigation for PHP files. Requires PHP and Composer. Copy a command below to install it, or visit https://phpactor.readthedocs.io for details. Alternative: Intelephense (https://intelephense.com/) is a popular Node.js-based PHP LSP.`,
+    actions: [
+      { id: "copy_composer", label: `Copy: ${INSTALL_COMMANDS.composer}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_alt", label: `Alternative: ${ALT_INSTALL}` },
+      { id: "disable", label: "Disable PHP LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_php_lsp_status_clicked", on_php_lsp_status_clicked);
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_php_lsp_status_clicked");
+
+/**
+ * Handle action popup results for PHP LSP help
+ */
+function on_php_lsp_action_result(
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "php-lsp-help") {
+    return;
+  }
+
+  editor.debug(`php-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_composer":
+      editor.setClipboard(INSTALL_COMMANDS.composer);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.composer);
+      break;
+
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_alt":
+      editor.setClipboard(ALT_INSTALL);
+      editor.setStatus("Copied: " + ALT_INSTALL);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("php");
+      editor.setStatus("PHP LSP disabled");
+      phpLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`php-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_php_lsp_action_result", on_php_lsp_action_result);
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_php_lsp_action_result");
+
+editor.debug("php-lsp: Plugin loaded");