@fresh-editor/fresh-editor 0.1.65 → 0.1.69

package/plugins/json-lsp.ts

@@ -0,0 +1,145 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+
+/**
+ * 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

@@ -254,6 +254,8 @@ interface CreateVirtualBufferOptions {
   show_cursors?: boolean | null;
   /** Disable all editing commands (default: false) */
   editing_disabled?: boolean | null;
+  /** Enable/disable line wrapping (None = use global setting) */
+  line_wrap?: boolean | null;
 }
 
 /** Options for creating a virtual buffer in an existing split */
@@ -274,6 +276,8 @@ interface CreateVirtualBufferInExistingSplitOptions {
   show_cursors?: boolean | null;
   /** Whether editing is disabled for this buffer (default false) */
   editing_disabled?: boolean | null;
+  /** Enable/disable line wrapping (None = use global setting) */
+  line_wrap?: boolean | null;
 }
 
 /** Options for creating a virtual buffer in the current split as a new tab */
@@ -294,6 +298,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
  */
@@ -308,9 +332,9 @@ interface EditorAPI {
    */
   setStatus(message: string): void;
   /**
-   * Log a debug message to the editor's trace output
+   * Log a debug message from a plugin
    *
-   * Messages appear in stderr when running with RUST_LOG=debug.
+   * Messages appear in log file when running with RUST_LOG=debug.
    * Useful for plugin development and troubleshooting.
    * @param message - Debug message; include context like function name and relevant values
    */
@@ -374,6 +398,8 @@ interface EditorAPI {
    * @param buffer_id - Target buffer ID
    */
   isBufferModified(buffer_id: number): boolean;
+  /** Get the currently active locale */
+  getCurrentLocale(): string;
   /**
    * Get the ID of the focused split pane
    *
@@ -402,6 +428,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 +437,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 ===
   /**
@@ -470,6 +514,30 @@ interface EditorAPI {
    * stay in sync with the saved config.
    */
   reloadConfig(): void;
+  /**
+   * Log an error message from a plugin
+   *
+   * Messages appear in log file when running with RUST_LOG=error.
+   * Use for critical errors that need attention.
+   * @param message - Error message
+   */
+  error(message: string): void;
+  /**
+   * Log a warning message from a plugin
+   *
+   * Messages appear in log file when running with RUST_LOG=warn.
+   * Use for warnings that don't prevent operation but indicate issues.
+   * @param message - Warning message
+   */
+  warn(message: string): void;
+  /**
+   * Log an info message from a plugin
+   *
+   * Messages appear in log file when running with RUST_LOG=info.
+   * Use for important operational messages.
+   * @param message - Info message
+   */
+  info(message: string): void;
   /**
    * Copy text to the system clipboard
    *
@@ -574,16 +642,9 @@ interface EditorAPI {
    * @returns true if insertion succeeded
    */
   insertAtCursor(text: string): boolean;
-  /**
-   * Register a custom command that can be triggered by keybindings or the command palette
-   * @param name - Unique command name (e.g., "my_plugin_action")
-   * @param description - Human-readable description
-   * @param action - JavaScript function name to call when command is triggered
-   * @param contexts - Comma-separated list of contexts, including both built-in (normal, prompt, popup,
-   * fileexplorer, menu) and custom plugin-defined contexts (e.g., "normal,config-editor")
-   * @param source - Plugin source name (empty string for builtin)
-   * @returns true if command was registered
-   */
+  /** Translate a string for a plugin using the current locale */
+  pluginTranslate(plugin_name: string, key: string, args: Record<string, unknown>): string;
+  /** Register a custom command that can be triggered by keybindings or the command palette */
   registerCommand(name: string, description: string, action: string, contexts: string, source: string): boolean;
   /**
    * Unregister a custom command by name
@@ -661,6 +722,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 +740,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 +767,71 @@ 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;
+  /**
+   * Create a scroll sync group for anchor-based synchronized scrolling
+   *
+   * Used for side-by-side diff views where two panes need to scroll together.
+   * The plugin provides the group ID (must be unique per plugin).
+   */
+  createScrollSyncGroup(group_id: number, left_split: number, right_split: number): boolean;
+  /**
+   * Set sync anchors for a scroll sync group
+   *
+   * Anchors map corresponding line numbers between left and right buffers.
+   * Each anchor is a tuple of (left_line, right_line).
+   */
+  setScrollSyncAnchors(group_id: number, anchors: Vec<(usize, usize): boolean;
+  /** Remove a scroll sync group */
+  removeScrollSyncGroup(group_id: number): boolean;
 
   /**
    * Spawn an external process and return a cancellable handle
@@ -734,9 +869,10 @@ interface EditorAPI {
    * @param underline - Add underline decoration
    * @param bold - Use bold text
    * @param italic - Use italic text
+   * @param extend_to_line_end - Extend background to end of visual line
    * @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, extend_to_line_end: boolean): boolean;
   /**
    * Remove a specific overlay by its handle
    * @param buffer_id - The buffer ID
@@ -1011,7 +1147,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/lib/index.ts

@@ -20,5 +20,5 @@ export { PanelManager } from "./panel-manager.ts";
 export { NavigationController } from "./navigation-controller.ts";
 
 // Buffer Creation
-export { VirtualBufferFactory } from "./virtual-buffer-factory.ts";
+export { createVirtualBufferFactory } from "./virtual-buffer-factory.ts";
 export type { VirtualBufferOptions, SplitBufferOptions } from "./virtual-buffer-factory.ts";

package/plugins/lib/navigation-controller.ts

@@ -33,7 +33,7 @@ export class NavigationController<T> {
   private currentIndex: number = 0;
   private options: NavigationOptions<T>;
 
-  constructor(options: NavigationOptions<T> = {}) {
+  constructor(private readonly editor: EditorAPI, options: NavigationOptions<T> = {}) {
     this.options = {
       itemLabel: "Item",
       wrap: false,
@@ -168,13 +168,13 @@ export class NavigationController<T> {
    */
   showStatus(customMessage?: string): void {
     if (this.items.length === 0) {
-      editor.setStatus(`No ${this.options.itemLabel}s`);
+      this.editor.setStatus(`No ${this.options.itemLabel}s`);
       return;
     }
 
     const message = customMessage ||
       `${this.options.itemLabel} ${this.currentIndex + 1}/${this.items.length}`;
-    editor.setStatus(message);
+    this.editor.setStatus(message);
   }
 
   /**

package/plugins/lib/panel-manager.ts

@@ -40,10 +40,12 @@ export class PanelManager {
   /**
    * Create a new PanelManager
    *
+   * @param editor - The editor API instance
    * @param panelName - Display name for the panel (e.g., "*Diagnostics*")
    * @param modeName - Mode name for keybindings (e.g., "diagnostics-list")
    */
   constructor(
+    private readonly editor: EditorAPI,
     private readonly panelName: string,
     private readonly modeName: string
   ) {}
@@ -101,11 +103,11 @@ export class PanelManager {
     }
 
     // Save current context
-    this.state.sourceSplitId = editor.getActiveSplitId();
-    this.state.sourceBufferId = editor.getActiveBufferId();
+    this.state.sourceSplitId = this.editor.getActiveSplitId();
+    this.state.sourceBufferId = this.editor.getActiveBufferId();
 
     // Create virtual buffer in split
-    const bufferId = await editor.createVirtualBufferInSplit({
+    const bufferId = await this.editor.createVirtualBufferInSplit({
       name: this.panelName,
       mode: this.modeName,
       read_only: true,
@@ -118,7 +120,7 @@ export class PanelManager {
 
     // Track state
     this.state.bufferId = bufferId;
-    this.state.splitId = editor.getActiveSplitId();
+    this.state.splitId = this.editor.getActiveSplitId();
     this.state.isOpen = true;
 
     return bufferId;
@@ -134,12 +136,12 @@ export class PanelManager {
 
     // Close the split containing the panel
     if (this.state.splitId !== null) {
-      editor.closeSplit(this.state.splitId);
+      this.editor.closeSplit(this.state.splitId);
     }
 
     // Focus back on source split
     if (this.state.sourceSplitId !== null) {
-      editor.focusSplit(this.state.sourceSplitId);
+      this.editor.focusSplit(this.state.sourceSplitId);
     }
 
     // Reset state
@@ -156,7 +158,7 @@ export class PanelManager {
       return;
     }
 
-    editor.setVirtualBufferContent(this.state.bufferId, entries);
+    this.editor.setVirtualBufferContent(this.state.bufferId, entries);
   }
 
   /**
@@ -177,7 +179,7 @@ export class PanelManager {
    */
   focusSource(): void {
     if (this.state.sourceSplitId !== null) {
-      editor.focusSplit(this.state.sourceSplitId);
+      this.editor.focusSplit(this.state.sourceSplitId);
     }
   }
 
@@ -186,7 +188,7 @@ export class PanelManager {
    */
   focusPanel(): void {
     if (this.state.splitId !== null) {
-      editor.focusSplit(this.state.splitId);
+      this.editor.focusSplit(this.state.splitId);
     }
   }
 
@@ -203,13 +205,13 @@ export class PanelManager {
     }
 
     // Focus source split and open file
-    editor.focusSplit(this.state.sourceSplitId);
-    await editor.openFile(filePath);
+    this.editor.focusSplit(this.state.sourceSplitId);
+    await this.editor.openFile(filePath);
 
     // Jump to location
-    editor.gotoLine(line);
+    this.editor.gotoLine(line);
     if (column > 1) {
-      editor.gotoColumn(column);
+      this.editor.gotoColumn(column);
     }
 
     // Focus back on panel