@fresh-editor/fresh-editor 0.2.17 → 0.2.20

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/diagnostics_panel.ts

@@ -126,6 +126,10 @@ const finder = new Finder<DiagnosticItem>(editor, {
   groupBy: "file",
   syncWithEditor: true,
   navigateOnCursorMove: true,
+  onClose: () => {
+    isOpen = false;
+    sourceBufferId = null;
+  },
 });
 
 // Get title based on current filter state
@@ -244,18 +248,6 @@ registerHandler("on_diagnostics_buffer_activated", on_diagnostics_buffer_activat
 editor.on("diagnostics_updated", "on_diagnostics_updated");
 editor.on("buffer_activated", "on_diagnostics_buffer_activated");
 
-// Mode Definition (for custom keybindings beyond Enter/Escape)
-editor.defineMode(
-  "diagnostics-extra",
-  [
-    ["a", "diagnostics_toggle_all"],
-    ["r", "diagnostics_refresh"],
-    ["Return", `_finder_diagnostics_panel_select`],
-    ["Escape", `_finder_diagnostics_panel_close`],
-  ],
-  true
-);
-
 // Command Registration
 editor.registerCommand(
   "%cmd.show_diagnostics_panel",

package/plugins/diff_nav.i18n.json

@@ -0,0 +1,128 @@
+{
+  "en": {
+    "cmd.next_change": "Next Change",
+    "cmd.next_change_desc": "Jump to the next changed region",
+    "cmd.prev_change": "Previous Change",
+    "cmd.prev_change_desc": "Jump to the previous changed region",
+    "status.no_changes": "No changes",
+    "status.change": "Change %{n}/%{total}",
+    "status.change_wrapped": "Change %{n}/%{total} [wrapped]"
+  },
+  "cs": {
+    "cmd.next_change": "Další změna",
+    "cmd.next_change_desc": "Přejít na další změněnou oblast",
+    "cmd.prev_change": "Předchozí změna",
+    "cmd.prev_change_desc": "Přejít na předchozí změněnou oblast",
+    "status.no_changes": "Žádné změny",
+    "status.change": "Změna %{n}/%{total}",
+    "status.change_wrapped": "Změna %{n}/%{total} [zabaleno]"
+  },
+  "de": {
+    "cmd.next_change": "Nächste Änderung",
+    "cmd.next_change_desc": "Zur nächsten geänderten Region springen",
+    "cmd.prev_change": "Vorherige Änderung",
+    "cmd.prev_change_desc": "Zur vorherigen geänderten Region springen",
+    "status.no_changes": "Keine Änderungen",
+    "status.change": "Änderung %{n}/%{total}",
+    "status.change_wrapped": "Änderung %{n}/%{total} [umgebrochen]"
+  },
+  "es": {
+    "cmd.next_change": "Siguiente cambio",
+    "cmd.next_change_desc": "Saltar a la siguiente región modificada",
+    "cmd.prev_change": "Cambio anterior",
+    "cmd.prev_change_desc": "Saltar a la región modificada anterior",
+    "status.no_changes": "Sin cambios",
+    "status.change": "Cambio %{n}/%{total}",
+    "status.change_wrapped": "Cambio %{n}/%{total} [envuelto]"
+  },
+  "fr": {
+    "cmd.next_change": "Modification suivante",
+    "cmd.next_change_desc": "Aller à la prochaine région modifiée",
+    "cmd.prev_change": "Modification précédente",
+    "cmd.prev_change_desc": "Aller à la région modifiée précédente",
+    "status.no_changes": "Aucune modification",
+    "status.change": "Modification %{n}/%{total}",
+    "status.change_wrapped": "Modification %{n}/%{total} [bouclé]"
+  },
+  "it": {
+    "cmd.next_change": "Modifica successiva",
+    "cmd.next_change_desc": "Vai alla prossima regione modificata",
+    "cmd.prev_change": "Modifica precedente",
+    "cmd.prev_change_desc": "Vai alla regione modificata precedente",
+    "status.no_changes": "Nessuna modifica",
+    "status.change": "Modifica %{n}/%{total}",
+    "status.change_wrapped": "Modifica %{n}/%{total} [avvolto]"
+  },
+  "ja": {
+    "cmd.next_change": "次の変更",
+    "cmd.next_change_desc": "次の変更箇所にジャンプ",
+    "cmd.prev_change": "前の変更",
+    "cmd.prev_change_desc": "前の変更箇所にジャンプ",
+    "status.no_changes": "変更なし",
+    "status.change": "変更 %{n}/%{total}",
+    "status.change_wrapped": "変更 %{n}/%{total} [折り返し]"
+  },
+  "ko": {
+    "cmd.next_change": "다음 변경",
+    "cmd.next_change_desc": "다음 변경된 영역으로 이동",
+    "cmd.prev_change": "이전 변경",
+    "cmd.prev_change_desc": "이전 변경된 영역으로 이동",
+    "status.no_changes": "변경 없음",
+    "status.change": "변경 %{n}/%{total}",
+    "status.change_wrapped": "변경 %{n}/%{total} [순환]"
+  },
+  "pt-BR": {
+    "cmd.next_change": "Próxima alteração",
+    "cmd.next_change_desc": "Ir para a próxima região alterada",
+    "cmd.prev_change": "Alteração anterior",
+    "cmd.prev_change_desc": "Ir para a região alterada anterior",
+    "status.no_changes": "Sem alterações",
+    "status.change": "Alteração %{n}/%{total}",
+    "status.change_wrapped": "Alteração %{n}/%{total} [retornou]"
+  },
+  "ru": {
+    "cmd.next_change": "Следующее изменение",
+    "cmd.next_change_desc": "Перейти к следующей изменённой области",
+    "cmd.prev_change": "Предыдущее изменение",
+    "cmd.prev_change_desc": "Перейти к предыдущей изменённой области",
+    "status.no_changes": "Нет изменений",
+    "status.change": "Изменение %{n}/%{total}",
+    "status.change_wrapped": "Изменение %{n}/%{total} [цикл]"
+  },
+  "th": {
+    "cmd.next_change": "การเปลี่ยนแปลงถัดไป",
+    "cmd.next_change_desc": "ข้ามไปยังพื้นที่ที่เปลี่ยนแปลงถัดไป",
+    "cmd.prev_change": "การเปลี่ยนแปลงก่อนหน้า",
+    "cmd.prev_change_desc": "ข้ามไปยังพื้นที่ที่เปลี่ยนแปลงก่อนหน้า",
+    "status.no_changes": "ไม่มีการเปลี่ยนแปลง",
+    "status.change": "การเปลี่ยนแปลง %{n}/%{total}",
+    "status.change_wrapped": "การเปลี่ยนแปลง %{n}/%{total} [วนรอบ]"
+  },
+  "uk": {
+    "cmd.next_change": "Наступна зміна",
+    "cmd.next_change_desc": "Перейти до наступної зміненої області",
+    "cmd.prev_change": "Попередня зміна",
+    "cmd.prev_change_desc": "Перейти до попередньої зміненої області",
+    "status.no_changes": "Немає змін",
+    "status.change": "Зміна %{n}/%{total}",
+    "status.change_wrapped": "Зміна %{n}/%{total} [цикл]"
+  },
+  "vi": {
+    "cmd.next_change": "Thay đổi tiếp theo",
+    "cmd.next_change_desc": "Nhảy đến vùng thay đổi tiếp theo",
+    "cmd.prev_change": "Thay đổi trước đó",
+    "cmd.prev_change_desc": "Nhảy đến vùng thay đổi trước đó",
+    "status.no_changes": "Không có thay đổi",
+    "status.change": "Thay đổi %{n}/%{total}",
+    "status.change_wrapped": "Thay đổi %{n}/%{total} [quay vòng]"
+  },
+  "zh-CN": {
+    "cmd.next_change": "下一个更改",
+    "cmd.next_change_desc": "跳转到下一个已更改的区域",
+    "cmd.prev_change": "上一个更改",
+    "cmd.prev_change_desc": "跳转到上一个已更改的区域",
+    "status.no_changes": "没有更改",
+    "status.change": "更改 %{n}/%{total}",
+    "status.change_wrapped": "更改 %{n}/%{total} [已循环]"
+  }
+}

package/plugins/diff_nav.ts

@@ -0,0 +1,196 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Diff Navigation Plugin
+ *
+ * Provides unified next/previous change commands that merge changes from all
+ * available diff sources: git diff AND piece-tree saved-diff. This means a
+ * single keybinding pair navigates both committed and unsaved changes.
+ *
+ * When only one source is available (e.g. file not tracked by git), it still
+ * works using that source alone.
+ */
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface DiffHunk {
+  type: "added" | "modified" | "deleted";
+  startLine: number; // 1-indexed
+  lineCount: number;
+}
+
+/** A jump target with a byte position for sorting/deduplication */
+interface JumpTarget {
+  bytePos: number;
+  line: number; // 0-indexed, for scrollToLineCenter
+}
+
+// =============================================================================
+// Collecting jump targets from all sources
+// =============================================================================
+
+async function collectTargets(bid: number): Promise<JumpTarget[]> {
+  const targets: JumpTarget[] = [];
+
+  // Source 1: git gutter hunks
+  const hunks = editor.getViewState(bid, "git_gutter_hunks") as DiffHunk[] | null;
+  if (hunks && hunks.length > 0) {
+    for (const hunk of hunks) {
+      const line = Math.max(0, hunk.startLine - 1); // 0-indexed
+      const pos = await editor.getLineStartPosition(line);
+      if (pos !== null) {
+        targets.push({ bytePos: pos, line });
+      }
+    }
+  }
+
+  // Source 2: saved-diff (unsaved changes)
+  const diff = editor.getBufferSavedDiff(bid);
+  if (diff && !diff.equal) {
+    for (const [start, _end] of diff.byte_ranges) {
+      // We don't know the line yet; resolve it lazily after dedup
+      targets.push({ bytePos: start, line: -1 });
+    }
+  }
+
+  if (targets.length === 0) return targets;
+
+  // Sort by byte position
+  targets.sort((a, b) => a.bytePos - b.bytePos);
+
+  // Deduplicate: if two targets are on the same line, keep the first.
+  // Resolve line numbers for saved-diff targets that still have line = -1.
+  const deduped: JumpTarget[] = [];
+  const seenLines = new Set<number>();
+
+  for (const t of targets) {
+    // Resolve line if unknown
+    if (t.line === -1) {
+      // Jump cursor temporarily to find the line, then restore.
+      // Instead, use a simpler heuristic: find the line by checking
+      // existing targets or using getLineStartPosition in reverse.
+      // Actually, we can set cursor, read line, but that's side-effectful.
+      // Simpler: just check if any existing target has a bytePos close enough.
+      // For dedup, we check if any already-added target has same bytePos.
+      let isDup = false;
+      for (const existing of deduped) {
+        if (Math.abs(existing.bytePos - t.bytePos) < 2) {
+          isDup = true;
+          break;
+        }
+      }
+      if (isDup) continue;
+      deduped.push(t);
+    } else {
+      if (seenLines.has(t.line)) continue;
+      seenLines.add(t.line);
+      // Also check if a saved-diff target at similar byte pos was already added
+      let isDup = false;
+      for (const existing of deduped) {
+        if (existing.line === -1 && Math.abs(existing.bytePos - t.bytePos) < 2) {
+          // Replace the unresolved one with this one (which has a known line)
+          existing.line = t.line;
+          isDup = true;
+          break;
+        }
+      }
+      if (isDup) continue;
+      deduped.push(t);
+    }
+  }
+
+  return deduped;
+}
+
+// =============================================================================
+// Navigation
+// =============================================================================
+
+function goToTarget(bid: number, target: JumpTarget): void {
+  if (target.line >= 0) {
+    const splitId = editor.getActiveSplitId();
+    editor.scrollToLineCenter(splitId, bid, target.line);
+  }
+  editor.setBufferCursor(bid, target.bytePos);
+}
+
+async function diff_nav_next(): Promise<void> {
+  const bid = editor.getActiveBufferId();
+  const targets = await collectTargets(bid);
+
+  if (targets.length === 0) {
+    editor.setStatus(editor.t("status.no_changes"));
+    return;
+  }
+
+  const cursor = editor.getCursorPosition();
+  let idx = targets.findIndex((t) => t.bytePos > cursor);
+  let wrapped = false;
+  if (idx === -1) {
+    idx = 0;
+    wrapped = true;
+  }
+
+  goToTarget(bid, targets[idx]);
+
+  const msg = wrapped
+    ? editor.t("status.change_wrapped", { n: String(idx + 1), total: String(targets.length) })
+    : editor.t("status.change", { n: String(idx + 1), total: String(targets.length) });
+  editor.setStatus(msg);
+}
+registerHandler("diff_nav_next", diff_nav_next);
+
+async function diff_nav_prev(): Promise<void> {
+  const bid = editor.getActiveBufferId();
+  const targets = await collectTargets(bid);
+
+  if (targets.length === 0) {
+    editor.setStatus(editor.t("status.no_changes"));
+    return;
+  }
+
+  const cursor = editor.getCursorPosition();
+  let idx = -1;
+  for (let i = targets.length - 1; i >= 0; i--) {
+    if (targets[i].bytePos < cursor) {
+      idx = i;
+      break;
+    }
+  }
+  let wrapped = false;
+  if (idx === -1) {
+    idx = targets.length - 1;
+    wrapped = true;
+  }
+
+  goToTarget(bid, targets[idx]);
+
+  const msg = wrapped
+    ? editor.t("status.change_wrapped", { n: String(idx + 1), total: String(targets.length) })
+    : editor.t("status.change", { n: String(idx + 1), total: String(targets.length) });
+  editor.setStatus(msg);
+}
+registerHandler("diff_nav_prev", diff_nav_prev);
+
+// =============================================================================
+// Registration
+// =============================================================================
+
+editor.registerCommand(
+  "%cmd.next_change",
+  "%cmd.next_change_desc",
+  "diff_nav_next",
+  null
+);
+
+editor.registerCommand(
+  "%cmd.prev_change",
+  "%cmd.prev_change_desc",
+  "diff_nav_prev",
+  null
+);
+
+editor.debug("Diff Nav 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");