@fresh-editor/fresh-editor 0.1.63 → 0.1.67

package/plugins/python-lsp.ts

@@ -0,0 +1,160 @@
+/// <reference path="./lib/fresh.d.ts" />
+
+/**
+ * Python LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Python LSP server issues.
+ * When the Python LSP server fails to start, this plugin shows an
+ * actionable popup with installation instructions.
+ *
+ * Features:
+ * - Detects Python LSP server errors (pylsp, python-lsp-server)
+ * - Shows popup with install commands (pip, pipx)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable Python LSP
+ */
+
+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 Python LSP server (python-lsp-server / pylsp)
+// pipx provides isolated installation (recommended)
+// pip_all includes all optional dependencies (rope, pyflakes, etc.)
+// See: https://github.com/python-lsp/python-lsp-server
+const INSTALL_COMMANDS = {
+  pipx: "pipx install python-lsp-server",
+  pip: "pip install python-lsp-server",
+  pip_all: "pip install 'python-lsp-server[all]'",
+};
+
+// Track error state for Python LSP
+let pythonLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Python
+ */
+globalThis.on_python_lsp_server_error = function (
+  data: LspServerErrorData
+): void {
+  // Only handle Python language errors
+  if (data.language !== "python") {
+    return;
+  }
+
+  editor.debug(
+    `python-lsp: Server error - ${data.error_type}: ${data.message}`
+  );
+
+  // Store error state for later reference
+  pythonLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Python LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Python LSP error: ${data.message}`);
+  }
+};
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_python_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Python LSP error
+ */
+globalThis.on_python_lsp_status_clicked = function (
+  data: LspStatusClickedData
+): void {
+  // Only handle Python language clicks when there's an error
+  if (data.language !== "python" || !pythonLspError) {
+    return;
+  }
+
+  editor.debug("python-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "python-lsp-help",
+    title: "Python Language Server Not Found",
+    message: `"${pythonLspError.serverCommand}" provides code completion, diagnostics, and navigation for Python files. Copy a command below to install it, or search online for your platform.`,
+    actions: [
+      { id: "copy_pipx", label: `Copy: ${INSTALL_COMMANDS.pipx}` },
+      { id: "copy_pip", label: `Copy: ${INSTALL_COMMANDS.pip}` },
+      { id: "copy_pip_all", label: `Copy: ${INSTALL_COMMANDS.pip_all}` },
+      { id: "disable", label: "Disable Python LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+};
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_python_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Python LSP help
+ */
+globalThis.on_python_lsp_action_result = function (
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "python-lsp-help") {
+    return;
+  }
+
+  editor.debug(`python-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_pipx":
+      editor.setClipboard(INSTALL_COMMANDS.pipx);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pipx);
+      break;
+
+    case "copy_pip":
+      editor.setClipboard(INSTALL_COMMANDS.pip);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pip);
+      break;
+
+    case "copy_pip_all":
+      editor.setClipboard(INSTALL_COMMANDS.pip_all);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pip_all);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("python");
+      editor.setStatus("Python LSP disabled");
+      pythonLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`python-lsp: Unknown action: ${data.action_id}`);
+  }
+};
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_python_lsp_action_result");
+
+editor.debug("python-lsp: Plugin loaded");

package/plugins/rust-lsp.ts

@@ -0,0 +1,164 @@
+/// <reference path="./lib/fresh.d.ts" />
+
+/**
+ * Rust LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Rust LSP server issues.
+ * When rust-analyzer fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects Rust LSP server errors (rust-analyzer)
+ * - Shows popup with install commands (rustup, brew)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable Rust LSP
+ */
+
+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 Rust LSP server
+// rustup is the official recommended method
+// brew is a good alternative for macOS users
+// See: https://rust-analyzer.github.io/book/installation.html
+const INSTALL_COMMANDS = {
+  rustup: "rustup component add rust-analyzer",
+  brew: "brew install rust-analyzer",
+};
+
+// Track error state for Rust LSP
+let rustLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Rust
+ */
+globalThis.on_rust_lsp_server_error = function (
+  data: LspServerErrorData
+): void {
+  // Only handle Rust language errors
+  if (data.language !== "rust") {
+    return;
+  }
+
+  editor.debug(`rust-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  rustLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Rust LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Rust LSP error: ${data.message}`);
+  }
+};
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_rust_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Rust LSP error
+ */
+globalThis.on_rust_lsp_status_clicked = function (
+  data: LspStatusClickedData
+): void {
+  editor.debug(
+    `rust-lsp: lsp_status_clicked hook received - language=${data.language}, has_error=${data.has_error}, rustLspError=${rustLspError ? "SET" : "NULL"}`
+  );
+
+  // Only handle Rust language clicks when there's an error
+  if (data.language !== "rust" || !rustLspError) {
+    editor.debug(
+      `rust-lsp: Skipping - language check=${data.language !== "rust"}, error check=${!rustLspError}`
+    );
+    return;
+  }
+
+  editor.debug("rust-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  const result = editor.showActionPopup({
+    id: "rust-lsp-help",
+    title: "Rust Language Server Not Found",
+    message: `"${rustLspError.serverCommand}" provides code completion, diagnostics, and navigation for Rust files. Copy a command below to install it, or search online for your platform.`,
+    actions: [
+      { id: "copy_rustup", label: `Copy: ${INSTALL_COMMANDS.rustup}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "disable", label: "Disable Rust LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+  editor.debug(`rust-lsp: showActionPopup returned ${result}`);
+};
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_rust_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Rust LSP help
+ */
+globalThis.on_rust_lsp_action_result = function (
+  data: ActionPopupResultData
+): void {
+  editor.debug(
+    `rust-lsp: action_popup_result received - popup_id=${data.popup_id}, action_id=${data.action_id}`
+  );
+
+  // Only handle our popup
+  if (data.popup_id !== "rust-lsp-help") {
+    editor.debug("rust-lsp: Not our popup, skipping");
+    return;
+  }
+
+  editor.debug(`rust-lsp: Action selected - ${data.action_id}, rustLspError will remain SET`);
+
+  switch (data.action_id) {
+    case "copy_rustup":
+      editor.setClipboard(INSTALL_COMMANDS.rustup);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.rustup);
+      break;
+
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("rust");
+      editor.setStatus("Rust LSP disabled");
+      rustLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`rust-lsp: Unknown action: ${data.action_id}`);
+  }
+};
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_rust_lsp_action_result");
+
+editor.debug("rust-lsp: Plugin loaded");

package/plugins/typescript-lsp.ts

@@ -0,0 +1,165 @@
+/// <reference path="./lib/fresh.d.ts" />
+
+/**
+ * TypeScript/JavaScript LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for TypeScript/JavaScript LSP server issues.
+ * When typescript-language-server fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects TypeScript LSP server errors (typescript-language-server, tsserver)
+ * - Shows popup with install commands (npm, yarn, pnpm)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable TypeScript LSP
+ */
+
+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 TypeScript LSP server
+// Both typescript-language-server AND typescript packages are required
+// See: https://github.com/typescript-language-server/typescript-language-server
+const INSTALL_COMMANDS = {
+  npm: "npm install -g typescript-language-server typescript",
+  yarn: "yarn global add typescript-language-server typescript",
+  pnpm: "pnpm add -g typescript-language-server typescript",
+};
+
+// Languages handled by this plugin
+const HANDLED_LANGUAGES = ["typescript", "javascript", "typescriptreact", "javascriptreact"];
+
+// Track error state for TypeScript LSP
+let tsLspError: { serverCommand: string; message: string; language: string } | null = null;
+
+/**
+ * Handle LSP server errors for TypeScript/JavaScript
+ */
+globalThis.on_typescript_lsp_server_error = function (
+  data: LspServerErrorData
+): void {
+  // Only handle TypeScript/JavaScript language errors
+  if (!HANDLED_LANGUAGES.includes(data.language)) {
+    return;
+  }
+
+  editor.debug(
+    `typescript-lsp: Server error - ${data.error_type}: ${data.message}`
+  );
+
+  // Store error state for later reference
+  tsLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+    language: data.language,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `TypeScript LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`TypeScript LSP error: ${data.message}`);
+  }
+};
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_typescript_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a TypeScript LSP error
+ */
+globalThis.on_typescript_lsp_status_clicked = function (
+  data: LspStatusClickedData
+): void {
+  // Only handle TypeScript/JavaScript language clicks when there's an error
+  if (!HANDLED_LANGUAGES.includes(data.language) || !tsLspError) {
+    return;
+  }
+
+  editor.debug("typescript-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "typescript-lsp-help",
+    title: "TypeScript Language Server Not Found",
+    message: `"${tsLspError.serverCommand}" provides code completion, diagnostics, and navigation for TypeScript/JavaScript files. Copy a command below to install it, or search online for your platform.`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_yarn", label: `Copy: ${INSTALL_COMMANDS.yarn}` },
+      { id: "copy_pnpm", label: `Copy: ${INSTALL_COMMANDS.pnpm}` },
+      { id: "disable", label: "Disable TypeScript LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+};
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_typescript_lsp_status_clicked");
+
+/**
+ * Handle action popup results for TypeScript LSP help
+ */
+globalThis.on_typescript_lsp_action_result = function (
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "typescript-lsp-help") {
+    return;
+  }
+
+  editor.debug(`typescript-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 "copy_pnpm":
+      editor.setClipboard(INSTALL_COMMANDS.pnpm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pnpm);
+      break;
+
+    case "disable":
+      // Disable for all TypeScript/JavaScript variants
+      editor.disableLspForLanguage("typescript");
+      editor.disableLspForLanguage("javascript");
+      editor.setStatus("TypeScript/JavaScript LSP disabled");
+      tsLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`typescript-lsp: Unknown action: ${data.action_id}`);
+  }
+};
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_typescript_lsp_action_result");
+
+editor.debug("typescript-lsp: Plugin loaded");