@fresh-editor/fresh-editor 0.2.17 → 0.2.18

package/plugins/r-lsp.ts

@@ -0,0 +1,118 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * R LSP Helper Plugin
+ *
+ * Server: languageserver (R package)
+ * VS Code: "R" extension by REditorSupport (uses languageserver)
+ * Neovim: nvim-lspconfig r_language_server
+ * Install via: R's install.packages() - runs as an R script
+ * Note: Also install httpgd for plot viewer 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;
+}
+
+const INSTALL_COMMANDS = {
+  r: 'R -e \'install.packages("languageserver")\'',
+  conda: "conda install -c conda-forge r-languageserver",
+};
+
+let rLspError: { serverCommand: string; message: string } | null = null;
+
+function on_r_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "r") {
+    return;
+  }
+
+  editor.debug(`r-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  rLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `R LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`R LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_r_lsp_server_error", on_r_lsp_server_error);
+editor.on("lsp_server_error", "on_r_lsp_server_error");
+
+function on_r_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "r" || !rLspError) {
+    return;
+  }
+
+  editor.debug("r-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "r-lsp-help",
+    title: "R Language Server Not Found",
+    message: `The R language server provides completion, diagnostics, hover, formatting, and go-to-definition for R files. It runs as an R script, so R must be installed.\n\nInstall the languageserver R package, then the server runs via: R --vanilla -e 'languageserver::run()'\nVS Code users: Install the "R" extension by REditorSupport.\nSee: https://github.com/REditorSupport/languageserver`,
+    actions: [
+      { id: "copy_r", label: `Copy: ${INSTALL_COMMANDS.r}` },
+      { id: "copy_conda", label: `Copy: ${INSTALL_COMMANDS.conda}` },
+      { id: "disable", label: "Disable R LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_r_lsp_status_clicked", on_r_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_r_lsp_status_clicked");
+
+function on_r_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "r-lsp-help") {
+    return;
+  }
+
+  editor.debug(`r-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_r":
+      editor.setClipboard(INSTALL_COMMANDS.r);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.r);
+      break;
+
+    case "copy_conda":
+      editor.setClipboard(INSTALL_COMMANDS.conda);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.conda);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("r");
+      editor.setStatus("R LSP disabled");
+      rLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`r-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_r_lsp_action_result", on_r_lsp_action_result);
+editor.on("action_popup_result", "on_r_lsp_action_result");
+
+editor.debug("r-lsp: Plugin loaded");

package/plugins/ruby-lsp.ts

@@ -0,0 +1,165 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Ruby LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Ruby LSP server issues.
+ * When solargraph fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects Ruby LSP server errors (solargraph)
+ * - Shows popup with install commands (gem)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable Ruby LSP
+ *
+ * Alternatives:
+ * - ruby-lsp (Shopify): Modern Ruby LSP - gem install ruby-lsp (https://github.com/Shopify/ruby-lsp)
+ * - Steep: Ruby type checker with LSP support (https://github.com/soutaro/steep)
+ * - Sorbet: Gradual type checker for Ruby (https://sorbet.org/)
+ */
+
+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 Ruby LSP server (solargraph)
+// See: https://solargraph.org/guides/getting-started
+const INSTALL_COMMANDS = {
+  gem: "gem install solargraph",
+  bundler: "bundle add solargraph --group development",
+};
+
+// Alternative LSP server
+const ALT_INSTALL = "gem install ruby-lsp";
+
+// Track error state for Ruby LSP
+let rubyLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Ruby
+ */
+function on_ruby_lsp_server_error(data: LspServerErrorData): void {
+  // Only handle Ruby language errors
+  if (data.language !== "ruby") {
+    return;
+  }
+
+  editor.debug(`ruby-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  rubyLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Ruby LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Ruby LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_ruby_lsp_server_error", on_ruby_lsp_server_error);
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_ruby_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Ruby LSP error
+ */
+function on_ruby_lsp_status_clicked(
+  data: LspStatusClickedData
+): void {
+  // Only handle Ruby language clicks when there's an error
+  if (data.language !== "ruby" || !rubyLspError) {
+    return;
+  }
+
+  editor.debug("ruby-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "ruby-lsp-help",
+    title: "Ruby Language Server Not Found",
+    message: `"${rubyLspError.serverCommand}" provides code completion, diagnostics, and navigation for Ruby files. Requires Ruby/RubyGems. Copy a command below to install it, or visit https://solargraph.org/guides/getting-started for details. Alternative: Shopify's ruby-lsp (https://github.com/Shopify/ruby-lsp).`,
+    actions: [
+      { id: "copy_gem", label: `Copy: ${INSTALL_COMMANDS.gem}` },
+      { id: "copy_bundler", label: `Copy: ${INSTALL_COMMANDS.bundler}` },
+      { id: "copy_alt", label: `Alternative: ${ALT_INSTALL}` },
+      { id: "disable", label: "Disable Ruby LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_ruby_lsp_status_clicked", on_ruby_lsp_status_clicked);
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_ruby_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Ruby LSP help
+ */
+function on_ruby_lsp_action_result(
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "ruby-lsp-help") {
+    return;
+  }
+
+  editor.debug(`ruby-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_gem":
+      editor.setClipboard(INSTALL_COMMANDS.gem);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.gem);
+      break;
+
+    case "copy_bundler":
+      editor.setClipboard(INSTALL_COMMANDS.bundler);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.bundler);
+      break;
+
+    case "copy_alt":
+      editor.setClipboard(ALT_INSTALL);
+      editor.setStatus("Copied: " + ALT_INSTALL);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("ruby");
+      editor.setStatus("Ruby LSP disabled");
+      rubyLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`ruby-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_ruby_lsp_action_result", on_ruby_lsp_action_result);
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_ruby_lsp_action_result");
+
+editor.debug("ruby-lsp: Plugin loaded");

package/plugins/scala-lsp.ts

@@ -0,0 +1,119 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Scala LSP Helper Plugin
+ *
+ * Server: Metals (scalameta.org/metals)
+ * VS Code: "Scala (Metals)" extension
+ * Neovim: nvim-metals plugin (recommended over nvim-lspconfig)
+ * Requires: Java 11+ and Coursier
+ * Supports: sbt, Mill, Gradle, Maven via Bloop/BSP
+ */
+
+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 = {
+  coursier: "cs install metals",
+  brew_cs: "brew install coursier/formulas/coursier && cs install metals",
+  manual: "curl -fL https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs install metals",
+};
+
+let scalaLspError: { serverCommand: string; message: string } | null = null;
+
+function on_scala_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "scala") {
+    return;
+  }
+
+  editor.debug(`scala-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  scalaLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Scala LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Scala LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_scala_lsp_server_error", on_scala_lsp_server_error);
+editor.on("lsp_server_error", "on_scala_lsp_server_error");
+
+function on_scala_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "scala" || !scalaLspError) {
+    return;
+  }
+
+  editor.debug("scala-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "scala-lsp-help",
+    title: "Scala Language Server Not Found",
+    message: `"${scalaLspError.serverCommand}" (Metals) provides completion, diagnostics, refactoring, and debugging for Scala. Requires Java 11+ and Coursier.\n\nSupports sbt, Mill, Gradle, Maven via Bloop/BSP.\nVS Code users: Install "Scala (Metals)" extension.\nNeovim users: Use nvim-metals plugin.\nSee: https://scalameta.org/metals/docs/editors/overview`,
+    actions: [
+      { id: "copy_coursier", label: `Copy: ${INSTALL_COMMANDS.coursier}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew_cs}` },
+      { id: "disable", label: "Disable Scala LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_scala_lsp_status_clicked", on_scala_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_scala_lsp_status_clicked");
+
+function on_scala_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "scala-lsp-help") {
+    return;
+  }
+
+  editor.debug(`scala-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_coursier":
+      editor.setClipboard(INSTALL_COMMANDS.coursier);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.coursier);
+      break;
+
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew_cs);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew_cs);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("scala");
+      editor.setStatus("Scala LSP disabled");
+      scalaLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`scala-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_scala_lsp_action_result", on_scala_lsp_action_result);
+editor.on("action_popup_result", "on_scala_lsp_action_result");
+
+editor.debug("scala-lsp: Plugin loaded");

package/plugins/solidity-lsp.ts

@@ -0,0 +1,130 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Solidity LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Solidity LSP server issues.
+ * When nomicfoundation-solidity-language-server fails to start, this plugin
+ * shows an actionable popup with installation instructions.
+ *
+ * Features:
+ * - Detects Solidity LSP server errors
+ * - Shows popup with install commands (npm)
+ * - Provides option to disable Solidity LSP
+ *
+ * VS Code: "Solidity" by Nomic Foundation (Hardhat), "Solidity" by Juan Blanco
+ * Neovim: nvim-lspconfig solidity
+ * Alternative: solc (Solidity compiler with diagnostics)
+ */
+
+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 Solidity LSP server
+// See: https://github.com/NomicFoundation/hardhat-vscode/tree/main/server
+const INSTALL_COMMANDS = {
+  npm: "npm i -g @nomicfoundation/solidity-language-server",
+};
+
+// Track error state for Solidity LSP
+let solidityLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Solidity
+ */
+function on_solidity_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "solidity") {
+    return;
+  }
+
+  editor.debug(`solidity-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  solidityLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Solidity LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Solidity LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_solidity_lsp_server_error", on_solidity_lsp_server_error);
+editor.on("lsp_server_error", "on_solidity_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Solidity LSP error
+ */
+function on_solidity_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "solidity" || !solidityLspError) {
+    return;
+  }
+
+  editor.debug("solidity-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "solidity-lsp-help",
+    title: "Solidity Language Server Not Found",
+    message: `"${solidityLspError.serverCommand}" (by Nomic Foundation) provides code completion, diagnostics, and navigation for Solidity smart contracts. Requires Node.js. Copy the command below to install it, or visit https://github.com/NomicFoundation/hardhat-vscode for details.`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "disable", label: "Disable Solidity LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_solidity_lsp_status_clicked", on_solidity_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_solidity_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Solidity LSP help
+ */
+function on_solidity_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "solidity-lsp-help") {
+    return;
+  }
+
+  editor.debug(`solidity-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 "disable":
+      editor.disableLspForLanguage("solidity");
+      editor.setStatus("Solidity LSP disabled");
+      solidityLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`solidity-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_solidity_lsp_action_result", on_solidity_lsp_action_result);
+editor.on("action_popup_result", "on_solidity_lsp_action_result");
+
+editor.debug("solidity-lsp: Plugin loaded");

package/plugins/sql-lsp.ts

@@ -0,0 +1,129 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * SQL LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for SQL LSP server issues.
+ * When sqls fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Server: sqls (github.com/sqls-server/sqls)
+ * VS Code: SQLTools extension, Database Client JDBC
+ * Neovim: nvim-lspconfig sqls
+ * Note: sqls needs a config.yml for database connections
+ * Alternative: sql-language-server (npm)
+ */
+
+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 = {
+  go: "go install github.com/sqls-server/sqls@latest",
+  brew: "brew install sqls",
+  npm_alt: "npm install -g sql-language-server",
+};
+
+let sqlLspError: { serverCommand: string; message: string } | null = null;
+
+function on_sql_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "sql") {
+    return;
+  }
+
+  editor.debug(`sql-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  sqlLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `SQL LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`SQL LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_sql_lsp_server_error", on_sql_lsp_server_error);
+editor.on("lsp_server_error", "on_sql_lsp_server_error");
+
+function on_sql_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "sql" || !sqlLspError) {
+    return;
+  }
+
+  editor.debug("sql-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "sql-lsp-help",
+    title: "SQL Language Server Not Found",
+    message: `"${sqlLspError.serverCommand}" provides completion, hover, and diagnostics for SQL files. It requires a config.yml to connect to your database. See: https://github.com/sqls-server/sqls\n\nAlternative: sql-language-server (npm) supports MySQL, PostgreSQL, SQLite.\nVS Code users: Try the SQLTools extension.`,
+    actions: [
+      { id: "copy_go", label: `Copy: ${INSTALL_COMMANDS.go}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm_alt}` },
+      { id: "disable", label: "Disable SQL LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_sql_lsp_status_clicked", on_sql_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_sql_lsp_status_clicked");
+
+function on_sql_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "sql-lsp-help") {
+    return;
+  }
+
+  editor.debug(`sql-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_go":
+      editor.setClipboard(INSTALL_COMMANDS.go);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.go);
+      break;
+
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_npm":
+      editor.setClipboard(INSTALL_COMMANDS.npm_alt);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.npm_alt);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("sql");
+      editor.setStatus("SQL LSP disabled");
+      sqlLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`sql-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_sql_lsp_action_result", on_sql_lsp_action_result);
+editor.on("action_popup_result", "on_sql_lsp_action_result");
+
+editor.debug("sql-lsp: Plugin loaded");