@fresh-editor/fresh-editor 0.1.63 → 0.1.67

package/plugins/clangd-lsp.ts

@@ -0,0 +1,166 @@
+/// <reference path="./lib/fresh.d.ts" />
+
+/**
+ * C/C++ LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for C/C++ LSP server issues.
+ * When clangd fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects C/C++ LSP server errors (clangd)
+ * - Shows popup with install commands (apt, brew, etc.)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable C/C++ 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 C/C++ LSP server (clangd)
+// See: https://clangd.llvm.org/installation
+const INSTALL_COMMANDS = {
+  apt: "sudo apt install clangd",
+  brew: "brew install llvm",
+  pacman: "sudo pacman -S clang",
+};
+
+// Languages handled by this plugin
+const HANDLED_LANGUAGES = ["c", "cpp"];
+
+// Track error state for C/C++ LSP
+let clangdLspError: {
+  serverCommand: string;
+  message: string;
+  language: string;
+} | null = null;
+
+/**
+ * Handle LSP server errors for C/C++
+ */
+globalThis.on_clangd_lsp_server_error = function (
+  data: LspServerErrorData
+): void {
+  // Only handle C/C++ language errors
+  if (!HANDLED_LANGUAGES.includes(data.language)) {
+    return;
+  }
+
+  editor.debug(`clangd-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  clangdLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+    language: data.language,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `C/C++ LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`C/C++ LSP error: ${data.message}`);
+  }
+};
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_clangd_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a C/C++ LSP error
+ */
+globalThis.on_clangd_lsp_status_clicked = function (
+  data: LspStatusClickedData
+): void {
+  // Only handle C/C++ language clicks when there's an error
+  if (!HANDLED_LANGUAGES.includes(data.language) || !clangdLspError) {
+    return;
+  }
+
+  editor.debug("clangd-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "clangd-lsp-help",
+    title: "C/C++ Language Server Not Found",
+    message: `"${clangdLspError.serverCommand}" provides code completion, diagnostics, and navigation for C/C++ files. Copy a command below to install it for your platform.`,
+    actions: [
+      { id: "copy_apt", label: `Copy: ${INSTALL_COMMANDS.apt}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_pacman", label: `Copy: ${INSTALL_COMMANDS.pacman}` },
+      { id: "disable", label: "Disable C/C++ LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+};
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_clangd_lsp_status_clicked");
+
+/**
+ * Handle action popup results for C/C++ LSP help
+ */
+globalThis.on_clangd_lsp_action_result = function (
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "clangd-lsp-help") {
+    return;
+  }
+
+  editor.debug(`clangd-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_apt":
+      editor.setClipboard(INSTALL_COMMANDS.apt);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.apt);
+      break;
+
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_pacman":
+      editor.setClipboard(INSTALL_COMMANDS.pacman);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pacman);
+      break;
+
+    case "disable":
+      // Disable for both C and C++
+      editor.disableLspForLanguage("c");
+      editor.disableLspForLanguage("cpp");
+      editor.setStatus("C/C++ LSP disabled");
+      clangdLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`clangd-lsp: Unknown action: ${data.action_id}`);
+  }
+};
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_clangd_lsp_action_result");
+
+editor.debug("clangd-lsp: Plugin loaded");

package/plugins/config-schema.json

@@ -4,6 +4,13 @@
   "description": "Main configuration structure",
   "type": "object",
   "properties": {
+    "version": {
+      "description": "Configuration version (for migration support)\nConfigs without this field are treated as version 0",
+      "type": "integer",
+      "format": "uint32",
+      "minimum": 0,
+      "default": 0
+    },
     "theme": {
       "description": "Color theme name",
       "$ref": "#/$defs/ThemeOptions",
@@ -37,7 +44,9 @@
         "mouse_hover_delay_ms": 500,
         "double_click_time_ms": 500,
         "auto_revert_poll_interval_ms": 2000,
-        "file_tree_poll_interval_ms": 3000
+        "file_tree_poll_interval_ms": 3000,
+        "default_line_ending": "lf",
+        "cursor_style": "default"
       }
     },
     "file_explorer": {
@@ -51,6 +60,13 @@
         "width": 0.30000001192092896
       }
     },
+    "file_browser": {
+      "description": "File browser settings (Open File dialog)",
+      "$ref": "#/$defs/FileBrowserConfig",
+      "default": {
+        "show_hidden": false
+      }
+    },
     "terminal": {
       "description": "Terminal settings",
       "$ref": "#/$defs/TerminalConfig",
@@ -98,6 +114,13 @@
     "menu": {
       "description": "Menu bar configuration",
       "$ref": "#/$defs/MenuConfig"
+    },
+    "warnings": {
+      "description": "Warning notification settings",
+      "$ref": "#/$defs/WarningsConfig",
+      "default": {
+        "show_status_indicator": true
+      }
     }
   },
   "$defs": {
@@ -128,7 +151,7 @@
           "default": true
         },
         "line_numbers": {
-          "description": "Show line numbers in the gutter",
+          "description": "Show line numbers in the gutter (default for new buffers)",
           "type": "boolean",
           "default": true
         },
@@ -150,7 +173,7 @@
           "default": true
         },
         "line_wrap": {
-          "description": "Wrap long lines to fit the window width",
+          "description": "Wrap long lines to fit the window width (default for new views)",
           "type": "boolean",
           "default": true
         },
@@ -238,9 +261,42 @@
           "format": "uint64",
           "minimum": 0,
           "default": 3000
+        },
+        "default_line_ending": {
+          "description": "Default line ending format for new files.\nFiles loaded from disk will use their detected line ending format.\nOptions: \"lf\" (Unix/Linux/macOS), \"crlf\" (Windows), \"cr\" (Classic Mac)\nDefault: \"lf\"",
+          "$ref": "#/$defs/LineEndingOption",
+          "default": "lf"
+        },
+        "cursor_style": {
+          "description": "Cursor style for the terminal cursor.\nOptions: blinking_block, steady_block, blinking_bar, steady_bar, blinking_underline, steady_underline\nDefault: blinking_block",
+          "$ref": "#/$defs/CursorStyle",
+          "default": "default"
         }
       }
     },
+    "LineEndingOption": {
+      "description": "Default line ending format for new files",
+      "type": "string",
+      "enum": [
+        "lf",
+        "crlf",
+        "cr"
+      ],
+      "default": "lf"
+    },
+    "CursorStyle": {
+      "description": "Terminal cursor style",
+      "type": "string",
+      "enum": [
+        "default",
+        "blinking_block",
+        "steady_block",
+        "blinking_bar",
+        "steady_bar",
+        "blinking_underline",
+        "steady_underline"
+      ]
+    },
     "FileExplorerConfig": {
       "description": "File explorer configuration",
       "type": "object",
@@ -276,6 +332,17 @@
         }
       }
     },
+    "FileBrowserConfig": {
+      "description": "File browser configuration (for Open File dialog)",
+      "type": "object",
+      "properties": {
+        "show_hidden": {
+          "description": "Whether to show hidden files (starting with .) by default in Open File dialog",
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
     "TerminalConfig": {
       "description": "Terminal configuration",
       "type": "object",
@@ -456,8 +523,25 @@
           "minimum": 0,
           "default": null
         },
+        "formatter": {
+          "description": "The formatter for this language (used by format_buffer command)",
+          "anyOf": [
+            {
+              "$ref": "#/$defs/FormatterConfig"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "format_on_save": {
+          "description": "Whether to automatically format on save (uses the formatter above)",
+          "type": "boolean",
+          "default": false
+        },
         "on_save": {
-          "description": "Actions to run when a file of this language is saved\nActions are run in order; if any fails (non-zero exit), subsequent actions don't run",
+          "description": "Actions to run when a file of this language is saved (linters, etc.)\nActions are run in order; if any fails (non-zero exit), subsequent actions don't run\nNote: Use `formatter` + `format_on_save` for formatting, not on_save",
           "type": "array",
           "items": {
             "$ref": "#/$defs/OnSaveAction"
@@ -487,8 +571,42 @@
         }
       ]
     },
+    "FormatterConfig": {
+      "description": "Formatter configuration for a language",
+      "type": "object",
+      "properties": {
+        "command": {
+          "description": "The formatter command to run (e.g., \"rustfmt\", \"prettier\")",
+          "type": "string"
+        },
+        "args": {
+          "description": "Arguments to pass to the formatter\nUse \"$FILE\" to include the file path",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        },
+        "stdin": {
+          "description": "Whether to pass buffer content via stdin (default: true)\nMost formatters read from stdin and write to stdout",
+          "type": "boolean",
+          "default": true
+        },
+        "timeout_ms": {
+          "description": "Timeout in milliseconds (default: 10000)",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0,
+          "default": 10000
+        }
+      },
+      "required": [
+        "command"
+      ],
+      "x-display-field": "/command"
+    },
     "OnSaveAction": {
-      "description": "Action to run when a file is saved",
+      "description": "Action to run when a file is saved (for linters, etc.)",
       "type": "object",
       "properties": {
         "command": {
@@ -516,11 +634,6 @@
           "type": "boolean",
           "default": false
         },
-        "replace_buffer": {
-          "description": "Whether to replace the buffer with the command's stdout\nUseful for formatters",
-          "type": "boolean",
-          "default": false
-        },
         "timeout_ms": {
           "description": "Timeout in milliseconds (default: 10000)",
           "type": "integer",
@@ -528,11 +641,6 @@
           "minimum": 0,
           "default": 10000
         },
-        "optional": {
-          "description": "Whether this action is optional (won't error if command not found)\nUseful for default formatters that may not be installed\nWhen true, shows a status message instead of an error if command is missing",
-          "type": "boolean",
-          "default": false
-        },
         "enabled": {
           "description": "Whether this action is enabled (default: true)\nSet to false to disable an action without removing it from config",
           "type": "boolean",
@@ -754,6 +862,17 @@
           ]
         }
       ]
+    },
+    "WarningsConfig": {
+      "description": "Warning notification configuration",
+      "type": "object",
+      "properties": {
+        "show_status_indicator": {
+          "description": "Show warning/error indicators in the status bar (default: true)\nWhen enabled, displays a colored indicator for LSP errors and other warnings",
+          "type": "boolean",
+          "default": true
+        }
+      }
     }
   }
 }

package/plugins/csharp-lsp.ts

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

package/plugins/css-lsp.ts

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