@fresh-editor/fresh-editor 0.2.17 → 0.2.20

package/plugins/typst-lsp.ts

@@ -0,0 +1,165 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Typst LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Typst LSP server issues.
+ * When tinymist fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects Typst LSP server errors (tinymist)
+ * - Shows popup with install commands (cargo, brew, etc.)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable Typst LSP
+ *
+ * Alternatives:
+ * - typst-lsp: Original Typst LSP (superseded by tinymist)
+ *
+ * Notes:
+ * - Tinymist also provides PDF preview and export features
+ * - Also available as VS Code extension "Tinymist Typst"
+ */
+
+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 Typst LSP server (tinymist)
+// See: https://github.com/Myriad-Dreamin/tinymist
+const INSTALL_COMMANDS = {
+  cargo: "cargo install tinymist",
+  brew: "brew install tinymist",
+  nix: "nix-env -iA nixpkgs.tinymist",
+};
+
+// Track error state for Typst LSP
+let typstLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Typst
+ */
+function on_typst_lsp_server_error(data: LspServerErrorData): void {
+  // Only handle Typst language errors
+  if (data.language !== "typst") {
+    return;
+  }
+
+  editor.debug(`typst-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  typstLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Typst LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Typst LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_typst_lsp_server_error", on_typst_lsp_server_error);
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_typst_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Typst LSP error
+ */
+function on_typst_lsp_status_clicked(
+  data: LspStatusClickedData
+): void {
+  // Only handle Typst language clicks when there's an error
+  if (data.language !== "typst" || !typstLspError) {
+    return;
+  }
+
+  editor.debug("typst-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "typst-lsp-help",
+    title: "Typst Language Server Not Found",
+    message: `"${typstLspError.serverCommand}" provides code completion, diagnostics, and preview support for Typst documents. Copy a command below to install it, or visit https://github.com/Myriad-Dreamin/tinymist for details and pre-built binaries. Also available as the "Tinymist Typst" VS Code extension.`,
+    actions: [
+      { id: "copy_cargo", label: `Copy: ${INSTALL_COMMANDS.cargo}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_nix", label: `Copy: ${INSTALL_COMMANDS.nix}` },
+      { id: "disable", label: "Disable Typst LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_typst_lsp_status_clicked", on_typst_lsp_status_clicked);
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_typst_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Typst LSP help
+ */
+function on_typst_lsp_action_result(
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "typst-lsp-help") {
+    return;
+  }
+
+  editor.debug(`typst-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_cargo":
+      editor.setClipboard(INSTALL_COMMANDS.cargo);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.cargo);
+      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("typst");
+      editor.setStatus("Typst LSP disabled");
+      typstLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`typst-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_typst_lsp_action_result", on_typst_lsp_action_result);
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_typst_lsp_action_result");
+
+editor.debug("typst-lsp: Plugin loaded");

package/plugins/vue-lsp.ts

@@ -0,0 +1,118 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Vue LSP Helper Plugin
+ *
+ * Server: vue-language-server (@vue/language-server, formerly Volar)
+ * VS Code: "Vue - Official" extension (replaces deprecated Vetur)
+ * Neovim: nvim-lspconfig volar
+ * Note: Supports hybrid mode with @vue/typescript-plugin for TS integration
+ */
+
+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 = {
+  npm: "npm install -g @vue/language-server",
+  yarn: "yarn global add @vue/language-server",
+  pnpm: "pnpm add -g @vue/language-server",
+};
+
+let vueLspError: { serverCommand: string; message: string } | null = null;
+
+function on_vue_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "vue") {
+    return;
+  }
+
+  editor.debug(`vue-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  vueLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Vue LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Vue LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_vue_lsp_server_error", on_vue_lsp_server_error);
+editor.on("lsp_server_error", "on_vue_lsp_server_error");
+
+function on_vue_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "vue" || !vueLspError) {
+    return;
+  }
+
+  editor.debug("vue-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "vue-lsp-help",
+    title: "Vue Language Server Not Found",
+    message: `"${vueLspError.serverCommand}" (formerly Volar) provides completion, diagnostics, and refactoring for Vue SFCs. It replaces the deprecated Vetur.\n\nFor TypeScript integration, also install @vue/typescript-plugin.\nVS Code users: Install the "Vue - Official" extension.\nSee: https://github.com/vuejs/language-tools`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_pnpm", label: `Copy: ${INSTALL_COMMANDS.pnpm}` },
+      { id: "disable", label: "Disable Vue LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_vue_lsp_status_clicked", on_vue_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_vue_lsp_status_clicked");
+
+function on_vue_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "vue-lsp-help") {
+    return;
+  }
+
+  editor.debug(`vue-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 "copy_pnpm":
+      editor.setClipboard(INSTALL_COMMANDS.pnpm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pnpm);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("vue");
+      editor.setStatus("Vue LSP disabled");
+      vueLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`vue-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_vue_lsp_action_result", on_vue_lsp_action_result);
+editor.on("action_popup_result", "on_vue_lsp_action_result");
+
+editor.debug("vue-lsp: Plugin loaded");

package/plugins/yaml-lsp.ts

@@ -0,0 +1,163 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * YAML LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for YAML LSP server issues.
+ * When yaml-language-server fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects YAML LSP server errors (yaml-language-server)
+ * - Shows popup with install commands (npm, yarn, pnpm)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable YAML LSP
+ *
+ * Notes:
+ * - yaml-language-server supports JSON Schema validation via modeline comments
+ *   e.g. # yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+ * - Built-in Kubernetes schema support
+ */
+
+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 YAML LSP server (yaml-language-server)
+// See: https://github.com/redhat-developer/yaml-language-server
+const INSTALL_COMMANDS = {
+  npm: "npm i -g yaml-language-server",
+  yarn: "yarn global add yaml-language-server",
+  pnpm: "pnpm add -g yaml-language-server",
+};
+
+// Track error state for YAML LSP
+let yamlLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for YAML
+ */
+function on_yaml_lsp_server_error(data: LspServerErrorData): void {
+  // Only handle YAML language errors
+  if (data.language !== "yaml") {
+    return;
+  }
+
+  editor.debug(`yaml-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  yamlLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `YAML LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`YAML LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_yaml_lsp_server_error", on_yaml_lsp_server_error);
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_yaml_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a YAML LSP error
+ */
+function on_yaml_lsp_status_clicked(
+  data: LspStatusClickedData
+): void {
+  // Only handle YAML language clicks when there's an error
+  if (data.language !== "yaml" || !yamlLspError) {
+    return;
+  }
+
+  editor.debug("yaml-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "yaml-lsp-help",
+    title: "YAML Language Server Not Found",
+    message: `"${yamlLspError.serverCommand}" provides code completion, validation, and schema support for YAML files. Requires Node.js. Supports JSON Schema validation and built-in Kubernetes schemas. Copy a command below to install it, or visit https://github.com/redhat-developer/yaml-language-server for details.`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_yarn", label: `Copy: ${INSTALL_COMMANDS.yarn}` },
+      { id: "copy_pnpm", label: `Copy: ${INSTALL_COMMANDS.pnpm}` },
+      { id: "disable", label: "Disable YAML LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_yaml_lsp_status_clicked", on_yaml_lsp_status_clicked);
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_yaml_lsp_status_clicked");
+
+/**
+ * Handle action popup results for YAML LSP help
+ */
+function on_yaml_lsp_action_result(
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "yaml-lsp-help") {
+    return;
+  }
+
+  editor.debug(`yaml-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 "copy_yarn":
+      editor.setClipboard(INSTALL_COMMANDS.yarn);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.yarn);
+      break;
+
+    case "copy_pnpm":
+      editor.setClipboard(INSTALL_COMMANDS.pnpm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.pnpm);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("yaml");
+      editor.setStatus("YAML LSP disabled");
+      yamlLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`yaml-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_yaml_lsp_action_result", on_yaml_lsp_action_result);
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_yaml_lsp_action_result");
+
+editor.debug("yaml-lsp: Plugin loaded");