@fresh-editor/fresh-editor 0.2.17 → 0.2.18

package/plugins/config-schema.json

@@ -38,6 +38,7 @@
         "show_menu_bar": true,
         "show_tab_bar": true,
         "show_status_bar": true,
+        "show_prompt_line": true,
         "show_vertical_scrollbar": true,
         "show_horizontal_scrollbar": false,
         "use_terminal_bg": false,
@@ -50,6 +51,7 @@
         "whitespace_tabs_leading": true,
         "whitespace_tabs_inner": true,
         "whitespace_tabs_trailing": true,
+        "use_tabs": false,
         "tab_size": 4,
         "auto_indent": true,
         "auto_close": true,
@@ -151,6 +153,18 @@
       },
       "default": {}
     },
+    "fallback": {
+      "description": "Fallback configuration for files whose type cannot be detected.\nApplied when no extension, filename, glob, or built-in detection matches.\nUseful for setting a default grammar (e.g., \"bash\") and comment_prefix\nfor unrecognized .conf, .rc, .rules, etc. files.",
+      "anyOf": [
+        {
+          "$ref": "#/$defs/LanguageConfig"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
     "lsp": {
       "description": "LSP server configurations by language",
       "type": "object",
@@ -269,6 +283,12 @@
           "default": true,
           "x-section": "Display"
         },
+        "show_prompt_line": {
+          "description": "Whether the prompt line is visible by default.\nThe prompt line is the bottom-most line used for command input, search, file open, etc.\nWhen hidden, the prompt line only appears when a prompt is active.\nCan be toggled at runtime via command palette or keybinding.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Display"
+        },
         "show_vertical_scrollbar": {
           "description": "Whether the vertical scrollbar is visible in each split pane.\nCan be toggled at runtime via command palette or keybinding.\nDefault: true",
           "type": "boolean",
@@ -346,6 +366,12 @@
           "default": true,
           "x-section": "Whitespace"
         },
+        "use_tabs": {
+          "description": "Whether pressing Tab inserts a tab character instead of spaces.\nThis is the global default; individual languages can override it\nvia their own `use_tabs` setting.\nDefault: false (insert spaces)",
+          "type": "boolean",
+          "default": false,
+          "x-section": "Editing"
+        },
         "tab_size": {
           "description": "Number of spaces per tab character",
           "type": "integer",
@@ -455,7 +481,7 @@
           "x-section": "Diagnostics"
         },
         "mouse_hover_enabled": {
-          "description": "Whether mouse hover triggers LSP hover requests.\nWhen enabled, hovering over code with the mouse will show documentation.\nDefault: true",
+          "description": "Whether mouse hover triggers LSP hover requests.\nWhen enabled, hovering over code with the mouse will show documentation.\nOn Windows, this also controls the mouse tracking mode: when disabled,\nthe editor uses xterm mode 1002 (cell motion — click, drag, release only);\nwhen enabled, it uses mode 1003 (all motion — full mouse movement tracking).\nMode 1003 generates high event volume on Windows and may cause input\ncorruption on some systems. On macOS and Linux this setting only controls\nLSP hover; the mouse tracking mode is always full motion.\nDefault: true (macOS/Linux), false (Windows)",
           "type": "boolean",
           "default": true,
           "x-section": "Mouse"
@@ -879,9 +905,12 @@
           "default": true
         },
         "use_tabs": {
-          "description": "Whether pressing Tab should insert a tab character instead of spaces.\nDefaults to false (insert spaces based on tab_size).\nSet to true for languages like Go and Makefile that require tabs.",
-          "type": "boolean",
-          "default": false
+          "description": "Whether pressing Tab should insert a tab character instead of spaces.\nIf not specified (`null`), falls back to the global `editor.use_tabs` setting.\nSet to true for languages like Go and Makefile that require tabs.",
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "default": null
         },
         "tab_size": {
           "description": "Tab size (number of spaces per tab) for this language.\nIf not specified, falls back to the global editor.tab_size setting.",

package/plugins/dart-lsp.ts

@@ -0,0 +1,144 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Dart LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Dart LSP server issues.
+ * The Dart language server is included with the Dart SDK.
+ *
+ * Features:
+ * - Detects Dart LSP server errors
+ * - Shows popup with install instructions for Dart SDK
+ * - Provides option to disable Dart LSP
+ *
+ * VS Code: "Dart" extension by Dart Code (uses bundled analysis server)
+ * Neovim: nvim-lspconfig dartls
+ * Note: The analysis server is bundled with Dart SDK and Flutter SDK
+ * For Flutter: Install Flutter SDK which includes Dart
+ */
+
+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 Dart SDK (which includes the language server)
+// See: https://dart.dev/get-dart
+const INSTALL_COMMANDS = {
+  brew: "brew install dart",
+  apt: "sudo apt install dart",
+  choco: "choco install dart-sdk",
+};
+
+// Track error state for Dart LSP
+let dartLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Dart
+ */
+function on_dart_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "dart") {
+    return;
+  }
+
+  editor.debug(`dart-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  dartLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Dart LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Dart LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_dart_lsp_server_error", on_dart_lsp_server_error);
+editor.on("lsp_server_error", "on_dart_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Dart LSP error
+ */
+function on_dart_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "dart" || !dartLspError) {
+    return;
+  }
+
+  editor.debug("dart-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "dart-lsp-help",
+    title: "Dart Language Server Not Found",
+    message: `The Dart language server is included with the Dart SDK. Install the Dart SDK (or Flutter SDK) to get LSP support. Visit https://dart.dev/get-dart for platform-specific instructions.`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_apt", label: `Copy: ${INSTALL_COMMANDS.apt}` },
+      { id: "copy_choco", label: `Copy: ${INSTALL_COMMANDS.choco} (Windows)` },
+      { id: "disable", label: "Disable Dart LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_dart_lsp_status_clicked", on_dart_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_dart_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Dart LSP help
+ */
+function on_dart_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "dart-lsp-help") {
+    return;
+  }
+
+  editor.debug(`dart-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_apt":
+      editor.setClipboard(INSTALL_COMMANDS.apt);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.apt);
+      break;
+
+    case "copy_choco":
+      editor.setClipboard(INSTALL_COMMANDS.choco);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.choco);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("dart");
+      editor.setStatus("Dart LSP disabled");
+      dartLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`dart-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_dart_lsp_action_result", on_dart_lsp_action_result);
+editor.on("action_popup_result", "on_dart_lsp_action_result");
+
+editor.debug("dart-lsp: Plugin loaded");

package/plugins/elixir-lsp.ts

@@ -0,0 +1,120 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Elixir LSP Helper Plugin
+ *
+ * Server: elixir-ls (github.com/elixir-lsp/elixir-ls)
+ * VS Code: "ElixirLS" extension
+ * Neovim: nvim-lspconfig elixirls
+ * Requires: Elixir and Erlang/OTP installed
+ * Note: The Elixir ecosystem is consolidating around Expert
+ * (github.com/elixir-lang/expert) as the new official LSP server
+ */
+
+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 = {
+  github: "# Download from https://github.com/elixir-lsp/elixir-ls/releases",
+  brew: "brew install elixir-ls",
+  nix: "nix-env -iA nixpkgs.elixir-ls",
+};
+
+let elixirLspError: { serverCommand: string; message: string } | null = null;
+
+function on_elixir_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "elixir") {
+    return;
+  }
+
+  editor.debug(`elixir-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  elixirLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Elixir LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Elixir LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_elixir_lsp_server_error", on_elixir_lsp_server_error);
+editor.on("lsp_server_error", "on_elixir_lsp_server_error");
+
+function on_elixir_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "elixir" || !elixirLspError) {
+    return;
+  }
+
+  editor.debug("elixir-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "elixir-lsp-help",
+    title: "Elixir Language Server Not Found",
+    message: `"${elixirLspError.serverCommand}" provides completion, diagnostics, go-to-definition, Dialyzer integration, and debugging for Elixir. Requires Elixir and Erlang/OTP.\n\nNew: Expert (https://expert-lsp.org) is the upcoming official Elixir LSP, merging ElixirLS, Lexical, and Next LS.\nVS Code users: Install the "ElixirLS" extension.\nSee: https://github.com/elixir-lsp/elixir-ls`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable Elixir LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_elixir_lsp_status_clicked", on_elixir_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_elixir_lsp_status_clicked");
+
+function on_elixir_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "elixir-lsp-help") {
+    return;
+  }
+
+  editor.debug(`elixir-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_nix":
+      editor.setClipboard(INSTALL_COMMANDS.nix);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("elixir");
+      editor.setStatus("Elixir LSP disabled");
+      elixirLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`elixir-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_elixir_lsp_action_result", on_elixir_lsp_action_result);
+editor.on("action_popup_result", "on_elixir_lsp_action_result");
+
+editor.debug("elixir-lsp: Plugin loaded");

package/plugins/erlang-lsp.ts

@@ -0,0 +1,121 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Erlang LSP Helper Plugin
+ *
+ * Server: erlang_ls (github.com/erlang-ls/erlang_ls)
+ * VS Code: "Erlang LS" extension
+ * Neovim: nvim-lspconfig erlangls
+ * Requires: Erlang/OTP 24+, rebar3
+ * Note: erlang_ls is archived; consider ELP (Erlang Language Platform)
+ * by WhatsApp as the recommended successor
+ * ELP: github.com/WhatsApp/erlang-language-platform
+ */
+
+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 = {
+  brew: "brew install erlang_ls",
+  build: "git clone https://github.com/erlang-ls/erlang_ls && cd erlang_ls && make && make install",
+  nix: "nix-env -iA nixpkgs.erlang-ls",
+};
+
+let erlangLspError: { serverCommand: string; message: string } | null = null;
+
+function on_erlang_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "erlang") {
+    return;
+  }
+
+  editor.debug(`erlang-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  erlangLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Erlang LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Erlang LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_erlang_lsp_server_error", on_erlang_lsp_server_error);
+editor.on("lsp_server_error", "on_erlang_lsp_server_error");
+
+function on_erlang_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "erlang" || !erlangLspError) {
+    return;
+  }
+
+  editor.debug("erlang-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "erlang-lsp-help",
+    title: "Erlang Language Server Not Found",
+    message: `"${erlangLspError.serverCommand}" provides completion, diagnostics, navigation, and code actions for Erlang. Requires Erlang/OTP 24+.\n\nNote: erlang_ls is archived. Consider ELP (Erlang Language Platform) by WhatsApp as the successor: https://github.com/WhatsApp/erlang-language-platform\nConfigure via erlang_ls.config in your project root.\nVS Code users: Install "Erlang LS" or "Erlang Language Platform" extension.\nSee: https://github.com/erlang-ls/erlang_ls`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable Erlang LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_erlang_lsp_status_clicked", on_erlang_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_erlang_lsp_status_clicked");
+
+function on_erlang_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "erlang-lsp-help") {
+    return;
+  }
+
+  editor.debug(`erlang-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_nix":
+      editor.setClipboard(INSTALL_COMMANDS.nix);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("erlang");
+      editor.setStatus("Erlang LSP disabled");
+      erlangLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`erlang-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_erlang_lsp_action_result", on_erlang_lsp_action_result);
+editor.on("action_popup_result", "on_erlang_lsp_action_result");
+
+editor.debug("erlang-lsp: Plugin loaded");

package/plugins/fsharp-lsp.ts

@@ -0,0 +1,125 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * F# LSP Helper Plugin
+ *
+ * Server: fsautocomplete (FsAutoComplete)
+ * VS Code: "Ionide-fsharp" extension (bundles fsautocomplete)
+ * Neovim: nvim-lspconfig fsautocomplete
+ * Install via: dotnet tool, brew, or nix
+ * Requires: .NET SDK installed
+ */
+
+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 = {
+  dotnet: "dotnet tool install -g fsautocomplete",
+  brew: "brew install fsautocomplete",
+  nix: "nix-env -iA nixpkgs.fsautocomplete",
+};
+
+let fsharpLspError: { serverCommand: string; message: string } | null = null;
+
+function on_fsharp_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "fsharp") {
+    return;
+  }
+
+  editor.debug(`fsharp-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  fsharpLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `F# LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`F# LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_fsharp_lsp_server_error", on_fsharp_lsp_server_error);
+editor.on("lsp_server_error", "on_fsharp_lsp_server_error");
+
+function on_fsharp_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "fsharp" || !fsharpLspError) {
+    return;
+  }
+
+  editor.debug("fsharp-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "fsharp-lsp-help",
+    title: "F# Language Server Not Found",
+    message: `"${fsharpLspError.serverCommand}" (FsAutoComplete) provides completion, diagnostics, code actions, and refactoring for F#. Requires .NET SDK.\n\nVS Code users: Install "Ionide-fsharp" (bundles fsautocomplete).\nSee: https://github.com/fsharp/FsAutoComplete`,
+    actions: [
+      { id: "copy_dotnet", label: `Copy: ${INSTALL_COMMANDS.dotnet}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable F# LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_fsharp_lsp_status_clicked", on_fsharp_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_fsharp_lsp_status_clicked");
+
+function on_fsharp_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "fsharp-lsp-help") {
+    return;
+  }
+
+  editor.debug(`fsharp-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_dotnet":
+      editor.setClipboard(INSTALL_COMMANDS.dotnet);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.dotnet);
+      break;
+
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_nix":
+      editor.setClipboard(INSTALL_COMMANDS.nix);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.nix);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("fsharp");
+      editor.setStatus("F# LSP disabled");
+      fsharpLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`fsharp-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_fsharp_lsp_action_result", on_fsharp_lsp_action_result);
+editor.on("action_popup_result", "on_fsharp_lsp_action_result");
+
+editor.debug("fsharp-lsp: Plugin loaded");