@fresh-editor/fresh-editor 0.1.76 → 0.1.83

package/plugins/lib/index.ts

@@ -11,7 +11,15 @@
  */
 
 // Types
-export type { RGB, Location, PanelOptions, PanelState, NavigationOptions, HighlightPattern } from "./types.ts";
+export type {
+  RGB,
+  Location,
+  PanelOptions,
+  PanelState,
+  NavigationOptions,
+  HighlightPattern,
+  FileExplorerDecoration,
+} from "./types.ts";
 
 // Panel Management
 export { PanelManager } from "./panel-manager.ts";

package/plugins/lib/types.ts

@@ -11,6 +11,20 @@
  */
 export type RGB = [number, number, number];
 
+/**
+ * File explorer decoration metadata provided by plugins
+ */
+export interface FileExplorerDecoration {
+  /** Absolute or workspace-relative path to decorate */
+  path: string;
+  /** Symbol to display (single character recommended) */
+  symbol?: string;
+  /** RGB color for the symbol */
+  color?: RGB;
+  /** Priority for resolving conflicts (higher wins) */
+  priority?: number;
+}
+
 /**
  * File location with line and column
  */

package/plugins/live_grep.ts

@@ -92,7 +92,7 @@ editor.registerCommand(
   "%cmd.live_grep",
   "%cmd.live_grep_desc",
   "start_live_grep",
-  "normal"
+  null
 );
 
 editor.debug("Live Grep plugin loaded (using Finder abstraction)");

package/plugins/odin-lsp.ts

@@ -0,0 +1,135 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+
+/**
+ * Odin LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Odin LSP server issues.
+ * When ols (Odin Language Server) fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects Odin LSP server errors (ols)
+ * - Shows popup with build instructions
+ * - Allows copying build commands to clipboard
+ * - Provides option to disable Odin LSP
+ *
+ * OLS: https://github.com/DanielGavin/ols
+ */
+
+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;
+}
+
+// OLS GitHub repository
+const OLS_URL = "https://github.com/DanielGavin/ols";
+
+// Track error state for Odin LSP
+let odinLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Odin
+ */
+globalThis.on_odin_lsp_server_error = function (data: LspServerErrorData): void {
+  // Only handle Odin language errors
+  if (data.language !== "odin") {
+    return;
+  }
+
+  editor.debug(`odin-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  odinLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Odin LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Odin LSP error: ${data.message}`);
+  }
+};
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_odin_lsp_server_error");
+
+/**
+ * Handle status bar click when there's an Odin LSP error
+ */
+globalThis.on_odin_lsp_status_clicked = function (
+  data: LspStatusClickedData
+): void {
+  // Only handle Odin language clicks when there's an error
+  if (data.language !== "odin" || !odinLspError) {
+    return;
+  }
+
+  editor.debug("odin-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "odin-lsp-help",
+    title: "Odin Language Server Not Found",
+    message: `"${odinLspError.serverCommand}" (OLS) provides code completion, diagnostics, and navigation for Odin files.\n\nInstallation: ${OLS_URL}`,
+    actions: [
+      { id: "disable", label: "Disable Odin LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+};
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_odin_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Odin LSP help
+ */
+globalThis.on_odin_lsp_action_result = function (
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "odin-lsp-help") {
+    return;
+  }
+
+  editor.debug(`odin-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "disable":
+      editor.disableLspForLanguage("odin");
+      editor.setStatus("Odin LSP disabled");
+      odinLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`odin-lsp: Unknown action: ${data.action_id}`);
+  }
+};
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_odin_lsp_action_result");
+
+editor.debug("odin-lsp: Plugin loaded");

package/plugins/search_replace.ts

@@ -478,7 +478,7 @@ editor.registerCommand(
   "%cmd.search_replace",
   "%cmd.search_replace_desc",
   "start_search_replace",
-  "normal"
+  null
 );
 
 // Plugin initialization

package/plugins/theme_editor.ts

@@ -484,10 +484,17 @@ function findThemesDir(): string {
  */
 async function loadBuiltinThemes(): Promise<string[]> {
   try {
-    const builtinThemes = editor.getBuiltinThemes() as Record<string, string>;
+    editor.debug("[theme_editor] loadBuiltinThemes: calling editor.getBuiltinThemes()");
+    const rawThemes = editor.getBuiltinThemes();
+    editor.debug(`[theme_editor] loadBuiltinThemes: got rawThemes type=${typeof rawThemes}`);
+    // getBuiltinThemes returns a JSON string, need to parse it
+    const builtinThemes = typeof rawThemes === "string"
+      ? JSON.parse(rawThemes) as Record<string, string>
+      : rawThemes as Record<string, string>;
+    editor.debug(`[theme_editor] loadBuiltinThemes: parsed ${Object.keys(builtinThemes).length} themes`);
     return Object.keys(builtinThemes);
   } catch (e) {
-    editor.debug(`Failed to load built-in themes list: ${e}`);
+    editor.debug(`[theme_editor] Failed to load built-in themes list: ${e}`);
     throw e;
   }
 }
@@ -497,13 +504,17 @@ async function loadBuiltinThemes(): Promise<string[]> {
  */
 async function loadThemeFile(name: string): Promise<Record<string, unknown> | null> {
   try {
-    const builtinThemes = editor.getBuiltinThemes() as Record<string, string>;
+    const rawThemes = editor.getBuiltinThemes();
+    // getBuiltinThemes returns a JSON string, need to parse it
+    const builtinThemes = typeof rawThemes === "string"
+      ? JSON.parse(rawThemes) as Record<string, string>
+      : rawThemes as Record<string, string>;
     if (name in builtinThemes) {
       return JSON.parse(builtinThemes[name]);
     }
     return null;
   } catch (e) {
-    editor.debug(`Failed to load theme data for '${name}': ${e}`);
+    editor.debug(`[theme_editor] Failed to load theme data for '${name}': ${e}`);
     return null;
   }
 }
@@ -1190,7 +1201,12 @@ globalThis.onThemeSelectInitialPromptConfirmed = async function(args: {
   selected_index: number | null;
   input: string;
 }): Promise<boolean> {
-  if (args.prompt_type !== "theme-select-initial") return true;
+  editor.debug(`[theme_editor] onThemeSelectInitialPromptConfirmed called with: ${JSON.stringify(args)}`);
+  if (args.prompt_type !== "theme-select-initial") {
+    editor.debug(`[theme_editor] prompt_type mismatch, expected 'theme-select-initial', got '${args.prompt_type}'`);
+    return true;
+  }
+  editor.debug(`[theme_editor] prompt_type matched, processing selection...`);
 
   const value = args.input.trim();
 
@@ -1252,7 +1268,9 @@ globalThis.onThemeSelectInitialPromptConfirmed = async function(args: {
   }
 
   // Now open the editor with loaded theme
+  editor.debug(`[theme_editor] About to call doOpenThemeEditor()`);
   await doOpenThemeEditor();
+  editor.debug(`[theme_editor] doOpenThemeEditor() completed`);
 
   return true;
 };
@@ -1642,7 +1660,9 @@ globalThis.theme_editor_nav_prev_section = function(): void {
  * Open the theme editor - prompts user to select theme first
  */
 globalThis.open_theme_editor = async function(): Promise<void> {
+  editor.debug("[theme_editor] open_theme_editor called");
   if (isThemeEditorOpen()) {
+    editor.debug("[theme_editor] already open, focusing");
     // Focus the existing theme editor split
     if (state.splitId !== null) {
       editor.focusSplit(state.splitId);
@@ -1651,12 +1671,15 @@ globalThis.open_theme_editor = async function(): Promise<void> {
     return;
   }
 
+  editor.debug("[theme_editor] saving context");
   // Save context
   state.sourceSplitId = editor.getActiveSplitId();
   state.sourceBufferId = editor.getActiveBufferId();
 
+  editor.debug("[theme_editor] loading builtin themes...");
   // Load available themes
   state.builtinThemes = await loadBuiltinThemes();
+  editor.debug(`[theme_editor] loaded ${state.builtinThemes.length} builtin themes`);
 
   // Get current theme name from config
   const config = editor.getConfig() as Record<string, unknown>;
@@ -1704,10 +1727,13 @@ globalThis.open_theme_editor = async function(): Promise<void> {
  * Actually open the theme editor with loaded theme data
  */
 async function doOpenThemeEditor(): Promise<void> {
+  editor.debug("[theme_editor] doOpenThemeEditor: building display entries");
   // Build initial entries
   const entries = buildDisplayEntries();
+  editor.debug(`[theme_editor] doOpenThemeEditor: built ${entries.length} entries`);
 
   // Create virtual buffer in current split (no new split)
+  editor.debug("[theme_editor] doOpenThemeEditor: calling createVirtualBuffer...");
   const bufferId = await editor.createVirtualBuffer({
     name: "*Theme Editor*",
     mode: "theme-editor",
@@ -1717,13 +1743,20 @@ async function doOpenThemeEditor(): Promise<void> {
     show_cursors: true,
     editing_disabled: true,
   });
+  editor.debug(`[theme_editor] doOpenThemeEditor: createVirtualBuffer returned bufferId=${bufferId}`);
+  editor.debug(`[theme_editor] doOpenThemeEditor: checking if bufferId !== null...`);
 
   if (bufferId !== null) {
+    editor.debug(`[theme_editor] doOpenThemeEditor: bufferId is not null, setting state...`);
     state.bufferId = bufferId;
     state.splitId = null;
 
+    editor.debug(`[theme_editor] doOpenThemeEditor: calling applyHighlighting...`);
     applyHighlighting();
+    editor.debug(`[theme_editor] doOpenThemeEditor: applyHighlighting completed`);
+    editor.debug(`[theme_editor] doOpenThemeEditor: calling setStatus...`);
     editor.setStatus(editor.t("status.ready"));
+    editor.debug(`[theme_editor] doOpenThemeEditor: completed successfully`);
   } else {
     editor.setStatus(editor.t("status.open_failed"));
   }
@@ -2037,12 +2070,11 @@ globalThis.onThemeDeletePromptConfirmed = async function(args: {
 // Command Registration
 // =============================================================================
 
-// Main command to open theme editor (always available)
+// Main command to open theme editor (always available - no context restriction)
 editor.registerCommand(
   "%cmd.edit_theme",
   "%cmd.edit_theme_desc",
-  "open_theme_editor",
-  "normal"
+  "open_theme_editor"
 );
 
 // Buffer-scoped commands - only visible when a buffer with mode "theme-editor" is focused

package/plugins/vi_mode.ts

@@ -2724,17 +2724,23 @@ editor.on("prompt_confirmed", "vi_command_handler");
 let viModeEnabled = false;
 
 globalThis.vi_mode_toggle = function (): void {
+  editor.debug("[vi_mode_toggle] called, viModeEnabled was: " + viModeEnabled);
   viModeEnabled = !viModeEnabled;
+  editor.debug("[vi_mode_toggle] viModeEnabled now: " + viModeEnabled);
 
   if (viModeEnabled) {
+    editor.debug("[vi_mode_toggle] enabling vi mode, calling switchMode('normal')");
     switchMode("normal");
+    editor.debug("[vi_mode_toggle] switchMode done, setting status");
     editor.setStatus(editor.t("status.enabled"));
   } else {
+    editor.debug("[vi_mode_toggle] disabling vi mode");
     editor.setEditorMode(null);
     state.mode = "normal";
     state.pendingOperator = null;
     editor.setStatus(editor.t("status.disabled"));
   }
+  editor.debug("[vi_mode_toggle] done");
 };
 
 editor.registerCommand(

package/plugins/welcome.ts

@@ -15,14 +15,14 @@ editor.registerCommand(
   "%cmd.open_help",
   "%cmd.open_help_desc",
   "show_help",
-  "normal"
+  null
 );
 
 editor.registerCommand(
   "%cmd.save_file",
   "%cmd.save_file_desc",
   "save",
-  "normal"
+  null
 );
 
 // Register commands with custom TypeScript callbacks
@@ -36,7 +36,7 @@ editor.registerCommand(
   "%cmd.say_hello",
   "%cmd.say_hello_desc",
   "plugin_say_hello",
-  "normal"
+  null
 );
 
 globalThis.plugin_insert_time = function(): void {
@@ -50,7 +50,7 @@ editor.registerCommand(
   "%cmd.insert_time",
   "%cmd.insert_time_desc",
   "plugin_insert_time",
-  "normal"
+  null
 );
 
 globalThis.plugin_insert_comment = function(): void {
@@ -63,7 +63,7 @@ editor.registerCommand(
   "%cmd.insert_comment",
   "%cmd.insert_comment_desc",
   "plugin_insert_comment",
-  "normal"
+  null
 );
 
 // Debug output