@fresh-editor/fresh-editor 0.2.17 → 0.2.20

package/plugins/erlang-lsp.ts

@@ -0,0 +1,121 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Erlang LSP Helper Plugin
+ *
+ * Server: erlang_ls (github.com/erlang-ls/erlang_ls)
+ * VS Code: "Erlang LS" extension
+ * Neovim: nvim-lspconfig erlangls
+ * Requires: Erlang/OTP 24+, rebar3
+ * Note: erlang_ls is archived; consider ELP (Erlang Language Platform)
+ * by WhatsApp as the recommended successor
+ * ELP: github.com/WhatsApp/erlang-language-platform
+ */
+
+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 erlang_ls",
+  build: "git clone https://github.com/erlang-ls/erlang_ls && cd erlang_ls && make && make install",
+  nix: "nix-env -iA nixpkgs.erlang-ls",
+};
+
+let erlangLspError: { serverCommand: string; message: string } | null = null;
+
+function on_erlang_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "erlang") {
+    return;
+  }
+
+  editor.debug(`erlang-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  erlangLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Erlang LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Erlang LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_erlang_lsp_server_error", on_erlang_lsp_server_error);
+editor.on("lsp_server_error", "on_erlang_lsp_server_error");
+
+function on_erlang_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "erlang" || !erlangLspError) {
+    return;
+  }
+
+  editor.debug("erlang-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "erlang-lsp-help",
+    title: "Erlang Language Server Not Found",
+    message: `"${erlangLspError.serverCommand}" provides completion, diagnostics, navigation, and code actions for Erlang. Requires Erlang/OTP 24+.\n\nNote: erlang_ls is archived. Consider ELP (Erlang Language Platform) by WhatsApp as the successor: https://github.com/WhatsApp/erlang-language-platform\nConfigure via erlang_ls.config in your project root.\nVS Code users: Install "Erlang LS" or "Erlang Language Platform" extension.\nSee: https://github.com/erlang-ls/erlang_ls`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable Erlang LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_erlang_lsp_status_clicked", on_erlang_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_erlang_lsp_status_clicked");
+
+function on_erlang_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "erlang-lsp-help") {
+    return;
+  }
+
+  editor.debug(`erlang-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 "disable":
+      editor.disableLspForLanguage("erlang");
+      editor.setStatus("Erlang LSP disabled");
+      erlangLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`erlang-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_erlang_lsp_action_result", on_erlang_lsp_action_result);
+editor.on("action_popup_result", "on_erlang_lsp_action_result");
+
+editor.debug("erlang-lsp: Plugin loaded");

package/plugins/fsharp-lsp.ts

@@ -0,0 +1,125 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * F# LSP Helper Plugin
+ *
+ * Server: fsautocomplete (FsAutoComplete)
+ * VS Code: "Ionide-fsharp" extension (bundles fsautocomplete)
+ * Neovim: nvim-lspconfig fsautocomplete
+ * Install via: dotnet tool, brew, or nix
+ * Requires: .NET SDK 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 = {
+  dotnet: "dotnet tool install -g fsautocomplete",
+  brew: "brew install fsautocomplete",
+  nix: "nix-env -iA nixpkgs.fsautocomplete",
+};
+
+let fsharpLspError: { serverCommand: string; message: string } | null = null;
+
+function on_fsharp_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "fsharp") {
+    return;
+  }
+
+  editor.debug(`fsharp-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  fsharpLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `F# LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`F# LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_fsharp_lsp_server_error", on_fsharp_lsp_server_error);
+editor.on("lsp_server_error", "on_fsharp_lsp_server_error");
+
+function on_fsharp_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "fsharp" || !fsharpLspError) {
+    return;
+  }
+
+  editor.debug("fsharp-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "fsharp-lsp-help",
+    title: "F# Language Server Not Found",
+    message: `"${fsharpLspError.serverCommand}" (FsAutoComplete) provides completion, diagnostics, code actions, and refactoring for F#. Requires .NET SDK.\n\nVS Code users: Install "Ionide-fsharp" (bundles fsautocomplete).\nSee: https://github.com/fsharp/FsAutoComplete`,
+    actions: [
+      { id: "copy_dotnet", label: `Copy: ${INSTALL_COMMANDS.dotnet}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable F# LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_fsharp_lsp_status_clicked", on_fsharp_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_fsharp_lsp_status_clicked");
+
+function on_fsharp_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "fsharp-lsp-help") {
+    return;
+  }
+
+  editor.debug(`fsharp-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_dotnet":
+      editor.setClipboard(INSTALL_COMMANDS.dotnet);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.dotnet);
+      break;
+
+    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 "disable":
+      editor.disableLspForLanguage("fsharp");
+      editor.setStatus("F# LSP disabled");
+      fsharpLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`fsharp-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_fsharp_lsp_action_result", on_fsharp_lsp_action_result);
+editor.on("action_popup_result", "on_fsharp_lsp_action_result");
+
+editor.debug("fsharp-lsp: Plugin loaded");

package/plugins/git_gutter.ts

@@ -248,6 +248,8 @@ async function updateGitGutter(bufferId: number): Promise<void> {
       editor.debug("Git Gutter: file not tracked by git");
       editor.clearLineIndicators(bufferId, NAMESPACE);
       state.hunks = [];
+      // Signal to other plugins that git is not available for this buffer
+      editor.setViewState(bufferId, "git_gutter_hunks", null);
       return;
     }
 
@@ -304,6 +306,9 @@ async function updateGitGutter(bufferId: number): Promise<void> {
     }
 
     state.hunks = hunks;
+
+    // Export hunks for other plugins (e.g. diff_nav) via shared view state
+    editor.setViewState(bufferId, "git_gutter_hunks", hunks);
   } finally {
     state.updating = false;
   }

package/plugins/gleam-lsp.ts

@@ -0,0 +1,124 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Gleam LSP Helper Plugin
+ *
+ * Server: Built into the Gleam compiler (gleam lsp)
+ * VS Code: "Gleam" extension
+ * Neovim: nvim-lspconfig gleam
+ * Note: LSP is bundled with the Gleam binary - install Gleam to get it
+ */
+
+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 gleam",
+  cargo: "cargo install gleam",
+  nix: "nix-env -iA nixpkgs.gleam",
+};
+
+let gleamLspError: { serverCommand: string; message: string } | null = null;
+
+function on_gleam_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "gleam") {
+    return;
+  }
+
+  editor.debug(`gleam-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  gleamLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Gleam LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Gleam LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_gleam_lsp_server_error", on_gleam_lsp_server_error);
+editor.on("lsp_server_error", "on_gleam_lsp_server_error");
+
+function on_gleam_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "gleam" || !gleamLspError) {
+    return;
+  }
+
+  editor.debug("gleam-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "gleam-lsp-help",
+    title: "Gleam Language Server Not Found",
+    message: `The Gleam language server is built into the Gleam compiler binary. Install Gleam to get LSP support - no separate installation needed.\n\nProvides completion, diagnostics, hover, go-to-definition, and formatting.\nVS Code users: Install the "Gleam" extension.\nSee: https://gleam.run/getting-started/installing/`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_cargo", label: `Copy: ${INSTALL_COMMANDS.cargo}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable Gleam LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_gleam_lsp_status_clicked", on_gleam_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_gleam_lsp_status_clicked");
+
+function on_gleam_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "gleam-lsp-help") {
+    return;
+  }
+
+  editor.debug(`gleam-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_cargo":
+      editor.setClipboard(INSTALL_COMMANDS.cargo);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.cargo);
+      break;
+
+    case "copy_nix":
+      editor.setClipboard(INSTALL_COMMANDS.nix);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("gleam");
+      editor.setStatus("Gleam LSP disabled");
+      gleamLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`gleam-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_gleam_lsp_action_result", on_gleam_lsp_action_result);
+editor.on("action_popup_result", "on_gleam_lsp_action_result");
+
+editor.debug("gleam-lsp: Plugin loaded");

package/plugins/graphql-lsp.ts

@@ -0,0 +1,139 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * GraphQL LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for GraphQL LSP server issues.
+ * When graphql-lsp fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects GraphQL LSP server errors (graphql-lsp)
+ * - Shows popup with install commands (npm)
+ * - Provides option to disable GraphQL LSP
+ *
+ * VS Code: "GraphQL: Language Feature Support" extension
+ * Neovim: nvim-lspconfig graphql
+ * Note: Requires a graphql-config file (.graphqlrc, graphql.config.js, etc.)
+ * Alternative: Apollo GraphQL extension (for Apollo users)
+ * Config docs: https://the-guild.dev/graphql/config
+ */
+
+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 GraphQL LSP server
+// See: https://github.com/graphql/graphiql/tree/main/packages/graphql-language-service-cli
+const INSTALL_COMMANDS = {
+  npm: "npm i -g graphql-language-service-cli",
+  yarn: "yarn global add graphql-language-service-cli",
+};
+
+// Track error state for GraphQL LSP
+let graphqlLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for GraphQL
+ */
+function on_graphql_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "graphql") {
+    return;
+  }
+
+  editor.debug(`graphql-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  graphqlLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `GraphQL LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`GraphQL LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_graphql_lsp_server_error", on_graphql_lsp_server_error);
+editor.on("lsp_server_error", "on_graphql_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a GraphQL LSP error
+ */
+function on_graphql_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "graphql" || !graphqlLspError) {
+    return;
+  }
+
+  editor.debug("graphql-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "graphql-lsp-help",
+    title: "GraphQL Language Server Not Found",
+    message: `"${graphqlLspError.serverCommand}" provides code completion, validation, and hover info for GraphQL schemas and queries. Requires Node.js and a .graphqlrc config. Copy a command below to install it, or visit https://github.com/graphql/graphiql/tree/main/packages/graphql-language-service-cli for details.`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_yarn", label: `Copy: ${INSTALL_COMMANDS.yarn}` },
+      { id: "disable", label: "Disable GraphQL LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_graphql_lsp_status_clicked", on_graphql_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_graphql_lsp_status_clicked");
+
+/**
+ * Handle action popup results for GraphQL LSP help
+ */
+function on_graphql_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "graphql-lsp-help") {
+    return;
+  }
+
+  editor.debug(`graphql-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 "disable":
+      editor.disableLspForLanguage("graphql");
+      editor.setStatus("GraphQL LSP disabled");
+      graphqlLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`graphql-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_graphql_lsp_action_result", on_graphql_lsp_action_result);
+editor.on("action_popup_result", "on_graphql_lsp_action_result");
+
+editor.debug("graphql-lsp: Plugin loaded");

package/plugins/haskell-lsp.ts

@@ -0,0 +1,125 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Haskell LSP Helper Plugin
+ *
+ * Server: haskell-language-server (HLS)
+ * VS Code: "Haskell" extension (installs HLS via GHCup)
+ * Neovim: nvim-lspconfig hls
+ * Install via: GHCup (recommended), brew, nix
+ * Note: HLS must match your GHC version
+ */
+
+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 = {
+  ghcup: "ghcup install hls",
+  brew: "brew install haskell-language-server",
+  nix: "nix-env -iA nixpkgs.haskell-language-server",
+};
+
+let haskellLspError: { serverCommand: string; message: string } | null = null;
+
+function on_haskell_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "haskell") {
+    return;
+  }
+
+  editor.debug(`haskell-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  haskellLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Haskell LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Haskell LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_haskell_lsp_server_error", on_haskell_lsp_server_error);
+editor.on("lsp_server_error", "on_haskell_lsp_server_error");
+
+function on_haskell_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "haskell" || !haskellLspError) {
+    return;
+  }
+
+  editor.debug("haskell-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "haskell-lsp-help",
+    title: "Haskell Language Server Not Found",
+    message: `"${haskellLspError.serverCommand}" (HLS) provides completion, diagnostics, code actions, and refactoring for Haskell. HLS must match your GHC version.\n\nRecommended: Install via GHCup (manages GHC + HLS versions).\nInstall GHCup: curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh\nVS Code users: Install the "Haskell" extension (auto-installs HLS via GHCup).\nSee: https://haskell-language-server.readthedocs.io`,
+    actions: [
+      { id: "copy_ghcup", label: `Copy: ${INSTALL_COMMANDS.ghcup}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable Haskell LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_haskell_lsp_status_clicked", on_haskell_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_haskell_lsp_status_clicked");
+
+function on_haskell_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "haskell-lsp-help") {
+    return;
+  }
+
+  editor.debug(`haskell-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_ghcup":
+      editor.setClipboard(INSTALL_COMMANDS.ghcup);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.ghcup);
+      break;
+
+    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 "disable":
+      editor.disableLspForLanguage("haskell");
+      editor.setStatus("Haskell LSP disabled");
+      haskellLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`haskell-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_haskell_lsp_action_result", on_haskell_lsp_action_result);
+editor.on("action_popup_result", "on_haskell_lsp_action_result");
+
+editor.debug("haskell-lsp: Plugin loaded");