@fresh-editor/fresh-editor 0.1.65 → 0.1.67

package/plugins/html-lsp.ts

@@ -0,0 +1,143 @@
+/// <reference path="./lib/fresh.d.ts" />
+
+/**
+ * HTML LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for HTML LSP server issues.
+ * When the HTML language server fails to start, this plugin shows an
+ * actionable popup with installation instructions.
+ *
+ * Features:
+ * - Detects HTML LSP server errors
+ * - Shows popup with install commands (npm)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable HTML 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 HTML LSP server
+// vscode-langservers-extracted provides HTML, CSS, and JSON language servers
+// See: https://www.npmjs.com/package/vscode-langservers-extracted
+const INSTALL_COMMANDS = {
+  npm: "npm install -g vscode-langservers-extracted",
+};
+
+// Track error state for HTML LSP
+let htmlLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for HTML
+ */
+globalThis.on_html_lsp_server_error = function (
+  data: LspServerErrorData
+): void {
+  // Only handle HTML language errors
+  if (data.language !== "html") {
+    return;
+  }
+
+  editor.debug(`html-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  htmlLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `HTML LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`HTML LSP error: ${data.message}`);
+  }
+};
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_html_lsp_server_error");
+
+/**
+ * Handle status bar click when there's an HTML LSP error
+ */
+globalThis.on_html_lsp_status_clicked = function (
+  data: LspStatusClickedData
+): void {
+  // Only handle HTML language clicks when there's an error
+  if (data.language !== "html" || !htmlLspError) {
+    return;
+  }
+
+  editor.debug("html-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "html-lsp-help",
+    title: "HTML Language Server Not Found",
+    message: `"${htmlLspError.serverCommand}" provides code completion, diagnostics, and formatting for HTML files. Copy the command below to install it.`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "disable", label: "Disable HTML LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+};
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_html_lsp_status_clicked");
+
+/**
+ * Handle action popup results for HTML LSP help
+ */
+globalThis.on_html_lsp_action_result = function (
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "html-lsp-help") {
+    return;
+  }
+
+  editor.debug(`html-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("html");
+      editor.setStatus("HTML LSP disabled");
+      htmlLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`html-lsp: Unknown action: ${data.action_id}`);
+  }
+};
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_html_lsp_action_result");
+
+editor.debug("html-lsp: Plugin loaded");

package/plugins/json-lsp.ts

@@ -0,0 +1,143 @@
+/// <reference path="./lib/fresh.d.ts" />
+
+/**
+ * JSON LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for JSON LSP server issues.
+ * When the JSON language server fails to start, this plugin shows an
+ * actionable popup with installation instructions.
+ *
+ * Features:
+ * - Detects JSON LSP server errors
+ * - Shows popup with install commands (npm)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable JSON 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 JSON LSP server
+// vscode-langservers-extracted provides HTML, CSS, and JSON language servers
+// See: https://www.npmjs.com/package/vscode-langservers-extracted
+const INSTALL_COMMANDS = {
+  npm: "npm install -g vscode-langservers-extracted",
+};
+
+// Track error state for JSON LSP
+let jsonLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for JSON
+ */
+globalThis.on_json_lsp_server_error = function (
+  data: LspServerErrorData
+): void {
+  // Only handle JSON language errors
+  if (data.language !== "json") {
+    return;
+  }
+
+  editor.debug(`json-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  jsonLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `JSON LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`JSON LSP error: ${data.message}`);
+  }
+};
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_json_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a JSON LSP error
+ */
+globalThis.on_json_lsp_status_clicked = function (
+  data: LspStatusClickedData
+): void {
+  // Only handle JSON language clicks when there's an error
+  if (data.language !== "json" || !jsonLspError) {
+    return;
+  }
+
+  editor.debug("json-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "json-lsp-help",
+    title: "JSON Language Server Not Found",
+    message: `"${jsonLspError.serverCommand}" provides code completion, validation, and formatting for JSON files. Copy the command below to install it.`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "disable", label: "Disable JSON LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+};
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_json_lsp_status_clicked");
+
+/**
+ * Handle action popup results for JSON LSP help
+ */
+globalThis.on_json_lsp_action_result = function (
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "json-lsp-help") {
+    return;
+  }
+
+  editor.debug(`json-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("json");
+      editor.setStatus("JSON LSP disabled");
+      jsonLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`json-lsp: Unknown action: ${data.action_id}`);
+  }
+};
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_json_lsp_action_result");
+
+editor.debug("json-lsp: Plugin loaded");

package/plugins/lib/fresh.d.ts

@@ -294,6 +294,26 @@ interface CreateVirtualBufferInCurrentSplitOptions {
   editing_disabled?: boolean | null;
 }
 
+/** JavaScript representation of ActionSpec (with optional count) */
+interface ActionSpecJs {
+  action: string;
+  count?: number | null;
+}
+
+/** TypeScript struct for action popup action */
+interface TsActionPopupAction {
+  id: string;
+  label: string;
+}
+
+/** TypeScript struct for action popup options */
+interface TsActionPopupOptions {
+  id: string;
+  title: string;
+  message: string;
+  actions: TsActionPopupAction[];
+}
+
 /**
  * Main editor API interface
  */
@@ -402,6 +422,8 @@ interface EditorAPI {
    * @returns true if process is running, false if not found or exited
    */
   isProcessRunning(#[bigint] process_id: number): boolean;
+  /** Compute syntax highlighting for a buffer range */
+  getHighlights(buffer_id: number, start: number, end: number): Promise<TsHighlightSpan[]>;
   /** Get diff vs last saved snapshot for a buffer */
   getBufferSavedDiff(buffer_id: number): TsBufferSavedDiff | null;
   /**
@@ -409,6 +431,22 @@ interface EditorAPI {
    * @returns Array of Diagnostic objects with file URI, severity, message, and range
    */
   getAllDiagnostics(): TsDiagnostic[];
+  /**
+   * Get text from a buffer range
+   *
+   * Used by vi mode plugin for yank operations - reads text without deleting.
+   * @param buffer_id - Buffer ID
+   * @param start - Start byte offset
+   * @param end - End byte offset
+   * @returns Text content of the range, or empty string on error
+   */
+  getBufferText(buffer_id: number, start: number, end: number): Promise<string>;
+  /**
+   * Get the current global editor mode
+   *
+   * @returns Current mode name or null if no mode is active
+   */
+  getEditorMode(): string;
 
   // === Buffer Info Queries ===
   /**
@@ -661,6 +699,8 @@ interface EditorAPI {
    * await editor.delay(100);  // Wait 100ms
    */
   delay(#[bigint] ms: number): Promise<[]>;
+  /** Find a buffer ID by its file path */
+  findBufferByPath(path: string): number;
   /**
    * Start a prompt with pre-filled initial value
    * @param label - Label to display (e.g., "Git grep: ")
@@ -677,6 +717,13 @@ interface EditorAPI {
    * @returns Promise resolving to the JSON response value
    */
   sendLspRequest(language: string, method: string, params?: unknown | null): Promise<unknown>;
+  /**
+   * Set the scroll position of a specific split
+   * @param split_id - The split ID
+   * @param top_byte - The byte offset of the top visible line
+   * @returns true if successful
+   */
+  setSplitScroll(split_id: number, top_byte: number): boolean;
   /**
    * Set the ratio of a split container
    * @param split_id - ID of the split
@@ -697,6 +744,55 @@ interface EditorAPI {
    * @returns true if the command was sent successfully
    */
   setBufferCursor(buffer_id: number, position: number): boolean;
+  /**
+   * Execute a built-in editor action by name
+   *
+   * This is used by vi mode plugin to run motions and then check cursor position.
+   * For example, to implement "dw" (delete word), the plugin:
+   * 1. Saves current cursor position
+   * 2. Calls executeAction("move_word_right") - cursor moves
+   * 3. Gets new cursor position
+   * 4. Deletes from old to new position
+   *
+   * @param action_name - Action name (e.g., "move_word_right", "move_line_end")
+   * @returns true if action was sent successfully
+   */
+  executeAction(action_name: string): boolean;
+  /**
+   * Execute multiple actions in sequence, each with an optional repeat count
+   *
+   * Used by vi mode for count prefix (e.g., "3dw" = delete 3 words).
+   * All actions execute atomically with no plugin roundtrips between them.
+   *
+   * @param actions - Array of {action: string, count?: number} objects
+   * @returns true if actions were sent successfully
+   */
+  executeActions(actions: ActionSpecJs[]): boolean;
+  /**
+   * Set the global editor mode (for modal editing like vi mode)
+   *
+   * When a mode is set, its keybindings take precedence over normal key handling.
+   * Pass null/undefined to clear the mode and return to normal editing.
+   *
+   * @param mode - Mode name (e.g., "vi-normal") or null to clear
+   * @returns true if command was sent successfully
+   */
+  setEditorMode(mode?: string | null): boolean;
+  /**
+   * Show an action popup with buttons for user interaction
+   *
+   * When the user selects an action, the ActionPopupResult hook is fired.
+   * @param options - Popup configuration with id, title, message, and actions
+   */
+  showActionPopup(options: TsActionPopupOptions): boolean;
+  /**
+   * Disable LSP for a specific language and persist to config
+   *
+   * This is used by LSP helper plugins to let users disable LSP for languages
+   * where the server is not available or not working.
+   * @param language - The language to disable LSP for (e.g., "python", "rust")
+   */
+  disableLspForLanguage(language: string): boolean;
 
   /**
    * Spawn an external process and return a cancellable handle
@@ -736,7 +832,7 @@ interface EditorAPI {
    * @param italic - Use italic text
    * @returns true if overlay was added
    */
-  addOverlay(buffer_id: number, namespace: string, start: number, end: number, r: number, g: number, b: number, underline: boolean, bold: boolean, italic: boolean): boolean;
+  addOverlay(buffer_id: number, namespace: string, start: number, end: number, r: number, g: number, b: number, bg_r: i16, bg_g: i16, bg_b: i16, underline: boolean, bold: boolean, italic: boolean): boolean;
   /**
    * Remove a specific overlay by its handle
    * @param buffer_id - The buffer ID
@@ -1011,7 +1107,7 @@ interface EditorAPI {
    * ["q", "close_buffer"]
    * ], true);
    */
-  defineMode(name: string, parent?: string | null, bindings: Vec<(String, String): boolean;
+  defineMode(name: string, parent: string, bindings: Vec<(String, String): boolean;
   /**
    * Switch the current split to display a buffer
    * @param buffer_id - ID of the buffer to show

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