@fresh-editor/fresh-editor 0.2.17 → 0.2.20

package/plugins/cmake-lsp.ts

@@ -0,0 +1,138 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * CMake LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for CMake LSP server issues.
+ * When cmake-language-server fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects CMake LSP server errors (cmake-language-server)
+ * - Shows popup with install commands (pip, pipx)
+ * - Provides option to disable CMake LSP
+ *
+ * VS Code: CMake Tools extension (v1.20+ has basic built-in language services)
+ * Neovim: nvim-lspconfig cmake
+ * Alternative: neocmakelsp (more actively maintained, has linting/formatting)
+ * See: https://github.com/neocmakelsp/neocmakelsp
+ */
+
+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 CMake LSP server
+// See: https://github.com/regen100/cmake-language-server
+const INSTALL_COMMANDS = {
+  pip: "pip install cmake-language-server",
+  pipx: "pipx install cmake-language-server",
+};
+
+// Track error state for CMake LSP
+let cmakeLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for CMake
+ */
+function on_cmake_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "cmake") {
+    return;
+  }
+
+  editor.debug(`cmake-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  cmakeLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `CMake LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`CMake LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_cmake_lsp_server_error", on_cmake_lsp_server_error);
+editor.on("lsp_server_error", "on_cmake_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a CMake LSP error
+ */
+function on_cmake_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "cmake" || !cmakeLspError) {
+    return;
+  }
+
+  editor.debug("cmake-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "cmake-lsp-help",
+    title: "CMake Language Server Not Found",
+    message: `"${cmakeLspError.serverCommand}" provides code completion, diagnostics, and navigation for CMakeLists.txt files. Requires Python. Copy a command below to install it, or visit https://github.com/regen100/cmake-language-server for details. Alternative: neocmakelsp (https://github.com/Decodetalkers/neocmakelsp).`,
+    actions: [
+      { id: "copy_pip", label: `Copy: ${INSTALL_COMMANDS.pip}` },
+      { id: "copy_pipx", label: `Copy: ${INSTALL_COMMANDS.pipx}` },
+      { id: "disable", label: "Disable CMake LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_cmake_lsp_status_clicked", on_cmake_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_cmake_lsp_status_clicked");
+
+/**
+ * Handle action popup results for CMake LSP help
+ */
+function on_cmake_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "cmake-lsp-help") {
+    return;
+  }
+
+  editor.debug(`cmake-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_pip":
+      editor.setClipboard(INSTALL_COMMANDS.pip);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pip);
+      break;
+
+    case "copy_pipx":
+      editor.setClipboard(INSTALL_COMMANDS.pipx);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pipx);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("cmake");
+      editor.setStatus("CMake LSP disabled");
+      cmakeLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`cmake-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_cmake_lsp_action_result", on_cmake_lsp_action_result);
+editor.on("action_popup_result", "on_cmake_lsp_action_result");
+
+editor.debug("cmake-lsp: Plugin loaded");

package/plugins/config-schema.json

@@ -34,12 +34,17 @@
         "relative_line_numbers": false,
         "line_wrap": true,
         "wrap_indent": true,
+        "wrap_column": null,
+        "page_width": 80,
         "syntax_highlighting": true,
         "show_menu_bar": true,
+        "menu_bar_mnemonics": true,
         "show_tab_bar": true,
         "show_status_bar": true,
+        "show_prompt_line": true,
         "show_vertical_scrollbar": true,
         "show_horizontal_scrollbar": false,
+        "show_tilde": true,
         "use_terminal_bg": false,
         "cursor_style": "default",
         "rulers": [],
@@ -50,6 +55,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,11 +157,23 @@
       },
       "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",
+      "description": "LSP server configurations by language.\nEach language maps to one or more server configs (multi-LSP support).\nAccepts both single-object and array forms for backwards compatibility.",
       "type": "object",
       "additionalProperties": {
-        "$ref": "#/$defs/LspServerConfig"
+        "$ref": "#/$defs/LspLanguageConfig"
       },
       "default": {}
     },
@@ -245,6 +263,28 @@
           "default": true,
           "x-section": "Display"
         },
+        "wrap_column": {
+          "description": "Column at which to wrap lines when line wrapping is enabled.\nIf not specified (`null`), lines wrap at the viewport edge (default behavior).\nExample: `80` wraps at column 80. The actual wrap column is clamped to the\nviewport width (lines can't wrap beyond the visible area).",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0,
+          "default": null,
+          "x-section": "Display"
+        },
+        "page_width": {
+          "description": "Width of the page in page view mode (in columns).\nControls the content width when page view is active, with centering margins.\nDefaults to 80. Set to `null` to use the full viewport width.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0,
+          "default": 80,
+          "x-section": "Display"
+        },
         "syntax_highlighting": {
           "description": "Enable syntax highlighting for code files",
           "type": "boolean",
@@ -257,6 +297,12 @@
           "default": true,
           "x-section": "Display"
         },
+        "menu_bar_mnemonics": {
+          "description": "Whether menu bar mnemonics (Alt+letter shortcuts) are enabled.\nWhen enabled, pressing Alt+F opens the File menu, Alt+E opens Edit, etc.\nDisabling this frees up Alt+letter keybindings for other actions.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Display"
+        },
         "show_tab_bar": {
           "description": "Whether the tab bar is visible by default.\nThe tab bar shows open files in each split pane.\nCan be toggled at runtime via command palette or keybinding.\nDefault: true",
           "type": "boolean",
@@ -269,6 +315,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",
@@ -281,6 +333,12 @@
           "default": false,
           "x-section": "Display"
         },
+        "show_tilde": {
+          "description": "Show tilde (~) markers on lines after the end of the file.\nThese vim-style markers indicate lines that are not part of the file content.\nDefault: true",
+          "type": "boolean",
+          "default": true,
+          "x-section": "Display"
+        },
         "use_terminal_bg": {
           "description": "Use the terminal's default background color instead of the theme's editor background.\nWhen enabled, the editor background inherits from the terminal emulator,\nallowing transparency or custom terminal backgrounds to show through.\nDefault: false",
           "type": "boolean",
@@ -346,6 +404,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",
@@ -431,7 +495,7 @@
           "x-section": "Completion"
         },
         "accept_suggestion_on_enter": {
-          "description": "Controls whether pressing Enter accepts the selected completion.\n- \"on\": Enter always accepts the completion\n- \"off\": Enter inserts a newline (use Tab to accept)\n- \"smart\": Enter accepts only if the completion text differs from typed text\nDefault: \"on\"",
+          "description": "Controls whether pressing Enter accepts the selected completion.\n  - \"on\": Enter always accepts the completion\n  - \"off\": Enter inserts a newline (use Tab to accept)\n  - \"smart\": Enter accepts only if the completion text differs from typed text\n\nDefault: \"on\"",
           "$ref": "#/$defs/AcceptSuggestionOnEnter",
           "default": "on",
           "x-section": "Completion"
@@ -455,7 +519,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"
@@ -878,10 +942,49 @@
           "type": "boolean",
           "default": true
         },
+        "line_wrap": {
+          "description": "Whether to enable line wrapping for this language.\nIf not specified (`null`), falls back to the global `editor.line_wrap` setting.\nUseful for prose-heavy languages like Markdown where wrapping is desirable\neven if globally disabled.",
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "default": null
+        },
+        "wrap_column": {
+          "description": "Column at which to wrap lines for this language.\nIf not specified (`null`), falls back to the global `editor.wrap_column` setting.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0,
+          "default": null
+        },
+        "page_view": {
+          "description": "Whether to automatically enable page view (compose mode) for this language.\nPage view provides a document-style layout with centered content,\nconcealed formatting markers, and intelligent word wrapping.\nIf not specified (`null`), page view is not auto-activated.",
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "default": null
+        },
+        "page_width": {
+          "description": "Width of the page in page view mode (in columns).\nControls the content width when page view is active, with centering margins.\nIf not specified (`null`), falls back to the global `editor.page_width` setting.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0,
+          "default": null
+        },
         "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.",
@@ -1022,6 +1125,13 @@
       ],
       "x-display-field": "/command"
     },
+    "LspLanguageConfig": {
+      "description": "One or more LSP server configs for this language.\nAccepts both a single object and an array for backwards compatibility.",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/LspServerConfig"
+      }
+    },
     "LspServerConfig": {
       "description": "LSP server configuration",
       "type": "object",
@@ -1029,7 +1139,23 @@
         "command": {
           "description": "Command to spawn the server.\nRequired when enabled=true, ignored when enabled=false.",
           "type": "string",
-          "default": ""
+          "default": "",
+          "x-order": 1
+        },
+        "enabled": {
+          "description": "Whether the server is enabled",
+          "type": "boolean",
+          "default": true,
+          "x-order": 2
+        },
+        "name": {
+          "description": "Display name for this server (e.g., \"tsserver\", \"eslint\").\nDefaults to the command basename if not specified.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "x-order": 3
         },
         "args": {
           "description": "Arguments to pass to the server",
@@ -1037,30 +1163,23 @@
           "items": {
             "type": "string"
           },
-          "default": []
-        },
-        "enabled": {
-          "description": "Whether the server is enabled",
-          "type": "boolean",
-          "default": true
+          "default": [],
+          "x-order": 4
         },
         "auto_start": {
           "description": "Whether to auto-start this LSP server when opening matching files\nIf false (default), the server must be started manually via command palette",
           "type": "boolean",
-          "default": false
-        },
-        "process_limits": {
-          "description": "Process resource limits (memory and CPU)",
-          "$ref": "#/$defs/ProcessLimits",
-          "default": {
-            "max_memory_percent": 50,
-            "max_cpu_percent": 90,
-            "enabled": true
-          }
+          "default": false,
+          "x-order": 5
         },
-        "initialization_options": {
-          "description": "Custom initialization options to send to the server\nThese are passed in the `initializationOptions` field of the LSP Initialize request",
-          "default": null
+        "root_markers": {
+          "description": "File/directory names to search for when detecting the workspace root.\nThe editor walks upward from the opened file's directory looking for\nany of these markers. The first directory containing a match becomes\nthe workspace root sent to the LSP server.\n\nIf empty, falls back to `[\".git\"]` as a universal marker.\nIf the walk reaches a filesystem boundary without a match, uses the\nfile's parent directory (never cwd or $HOME).",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "x-order": 6
         },
         "env": {
           "description": "Environment variables to set for the LSP server process.\nThese are added to (or override) the inherited parent environment.",
@@ -1068,7 +1187,9 @@
           "additionalProperties": {
             "type": "string"
           },
-          "default": {}
+          "default": {},
+          "x-section": "Advanced",
+          "x-order": 10
         },
         "language_id_overrides": {
           "description": "Override the LSP languageId sent in textDocument/didOpen based on file extension.\nMaps file extension (without dot) to LSP language ID string.\nFor example: `{\"tsx\": \"typescriptreact\", \"jsx\": \"javascriptreact\"}`",
@@ -1076,11 +1197,136 @@
           "additionalProperties": {
             "type": "string"
           },
-          "default": {}
+          "default": {},
+          "x-section": "Advanced",
+          "x-order": 11
+        },
+        "initialization_options": {
+          "description": "Custom initialization options to send to the server\nThese are passed in the `initializationOptions` field of the LSP Initialize request",
+          "default": null,
+          "x-section": "Advanced",
+          "x-order": 12
+        },
+        "only_features": {
+          "description": "Restrict this server to only handle the listed features.\nMutually exclusive with `except_features`. If neither is set, all features are handled.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "$ref": "#/$defs/LspFeature"
+          },
+          "default": null,
+          "x-section": "Advanced",
+          "x-order": 13
+        },
+        "except_features": {
+          "description": "Exclude the listed features from this server.\nMutually exclusive with `only_features`. If neither is set, all features are handled.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "$ref": "#/$defs/LspFeature"
+          },
+          "default": null,
+          "x-section": "Advanced",
+          "x-order": 14
+        },
+        "process_limits": {
+          "description": "Process resource limits (memory and CPU)",
+          "$ref": "#/$defs/ProcessLimits",
+          "default": {
+            "max_memory_percent": 50,
+            "max_cpu_percent": 90,
+            "enabled": true
+          },
+          "x-section": "Advanced",
+          "x-order": 15
         }
       },
       "x-display-field": "/command"
     },
+    "LspFeature": {
+      "description": "LSP features that can be routed to specific servers in a multi-server setup.\n\nFeatures are classified as either \"merged\" (results from all servers are combined)\nor \"exclusive\" (first eligible server wins). This classification is used by the\ndispatch layer, not by this enum itself.",
+      "oneOf": [
+        {
+          "description": "Diagnostics (merged: combined from all servers)",
+          "type": "string",
+          "const": "diagnostics"
+        },
+        {
+          "description": "Code completion (merged: combined from all servers)",
+          "type": "string",
+          "const": "completion"
+        },
+        {
+          "description": "Code actions / quick fixes (merged: combined from all servers)",
+          "type": "string",
+          "const": "code_action"
+        },
+        {
+          "description": "Document symbols (merged: combined from all servers)",
+          "type": "string",
+          "const": "document_symbols"
+        },
+        {
+          "description": "Workspace symbols (merged: combined from all servers)",
+          "type": "string",
+          "const": "workspace_symbols"
+        },
+        {
+          "description": "Hover information (exclusive: first eligible server wins)",
+          "type": "string",
+          "const": "hover"
+        },
+        {
+          "description": "Go to definition, declaration, type definition, implementation (exclusive)",
+          "type": "string",
+          "const": "definition"
+        },
+        {
+          "description": "Find references (exclusive)",
+          "type": "string",
+          "const": "references"
+        },
+        {
+          "description": "Document formatting and range formatting (exclusive)",
+          "type": "string",
+          "const": "format"
+        },
+        {
+          "description": "Rename and prepare rename (exclusive)",
+          "type": "string",
+          "const": "rename"
+        },
+        {
+          "description": "Signature help (exclusive)",
+          "type": "string",
+          "const": "signature_help"
+        },
+        {
+          "description": "Inlay hints (exclusive)",
+          "type": "string",
+          "const": "inlay_hints"
+        },
+        {
+          "description": "Folding ranges (exclusive)",
+          "type": "string",
+          "const": "folding_range"
+        },
+        {
+          "description": "Semantic tokens (exclusive)",
+          "type": "string",
+          "const": "semantic_tokens"
+        },
+        {
+          "description": "Document highlight (exclusive)",
+          "type": "string",
+          "const": "document_highlight"
+        }
+      ]
+    },
     "ProcessLimits": {
       "description": "Configuration for process resource limits",
       "type": "object",