@involvex/fresh-editor 0.1.76 → 0.1.78

package/bin/plugins/todo_highlighter.i18n.json

@@ -0,0 +1,184 @@
+{
+  "en": {
+    "cmd.enable": "TODO Highlighter: Enable",
+    "cmd.enable_desc": "Enable TODO keyword highlighting",
+    "cmd.disable": "TODO Highlighter: Disable",
+    "cmd.disable_desc": "Disable TODO keyword highlighting",
+    "cmd.toggle": "TODO Highlighter: Toggle",
+    "cmd.toggle_desc": "Toggle TODO keyword highlighting",
+    "cmd.show_keywords": "TODO Highlighter: Show Keywords",
+    "cmd.show_keywords_desc": "Show currently tracked keywords",
+    "status.enabled": "TODO Highlighter: Enabled",
+    "status.disabled": "TODO Highlighter: Disabled",
+    "status.loaded": "TODO Highlighter plugin loaded (TypeScript)",
+    "status.keywords": "TODO Keywords: %{keywords}"
+  },
+  "cs": {
+    "cmd.enable": "TODO zvyraznovac: Povolit",
+    "cmd.enable_desc": "Povolit zvyraznovani klicovych slov TODO",
+    "cmd.disable": "TODO zvyraznovac: Zakázat",
+    "cmd.disable_desc": "Zakazat zvyraznovani klicovych slov TODO",
+    "cmd.toggle": "TODO zvyraznovac: Prepnout",
+    "cmd.toggle_desc": "Prepnout zvyraznovani klicovych slov TODO",
+    "cmd.show_keywords": "TODO zvyraznovac: Zobrazit klicova slova",
+    "cmd.show_keywords_desc": "Zobrazit aktualne sledovana klicova slova",
+    "status.enabled": "TODO zvyraznovac: Povolen",
+    "status.disabled": "TODO zvyraznovac: Zakazan",
+    "status.loaded": "Plugin TODO zvyraznovace nacten (TypeScript)",
+    "status.keywords": "TODO klicova slova: %{keywords}"
+  },
+  "de": {
+    "cmd.enable": "TODO-Hervorhebung: Aktivieren",
+    "cmd.enable_desc": "TODO-Schluesselwort-Hervorhebung aktivieren",
+    "cmd.disable": "TODO-Hervorhebung: Deaktivieren",
+    "cmd.disable_desc": "TODO-Schluesselwort-Hervorhebung deaktivieren",
+    "cmd.toggle": "TODO-Hervorhebung: Umschalten",
+    "cmd.toggle_desc": "TODO-Schluesselwort-Hervorhebung umschalten",
+    "cmd.show_keywords": "TODO-Hervorhebung: Schluesselwoerter Anzeigen",
+    "cmd.show_keywords_desc": "Aktuell verfolgte Schluesselwoerter anzeigen",
+    "status.enabled": "TODO-Hervorhebung: Aktiviert",
+    "status.disabled": "TODO-Hervorhebung: Deaktiviert",
+    "status.loaded": "TODO-Hervorhebung-Plugin geladen (TypeScript)",
+    "status.keywords": "TODO-Schluesselwoerter: %{keywords}"
+  },
+  "es": {
+    "cmd.enable": "Resaltador TODO: Activar",
+    "cmd.enable_desc": "Activar resaltado de palabras clave TODO",
+    "cmd.disable": "Resaltador TODO: Desactivar",
+    "cmd.disable_desc": "Desactivar resaltado de palabras clave TODO",
+    "cmd.toggle": "Resaltador TODO: Alternar",
+    "cmd.toggle_desc": "Alternar resaltado de palabras clave TODO",
+    "cmd.show_keywords": "Resaltador TODO: Mostrar Palabras Clave",
+    "cmd.show_keywords_desc": "Mostrar palabras clave rastreadas actualmente",
+    "status.enabled": "Resaltador TODO: Activado",
+    "status.disabled": "Resaltador TODO: Desactivado",
+    "status.loaded": "Plugin Resaltador TODO cargado (TypeScript)",
+    "status.keywords": "Palabras Clave TODO: %{keywords}"
+  },
+  "fr": {
+    "cmd.enable": "Surligneur TODO: Activer",
+    "cmd.enable_desc": "Activer le surlignage des mots-cles TODO",
+    "cmd.disable": "Surligneur TODO: Desactiver",
+    "cmd.disable_desc": "Desactiver le surlignage des mots-cles TODO",
+    "cmd.toggle": "Surligneur TODO: Basculer",
+    "cmd.toggle_desc": "Basculer le surlignage des mots-cles TODO",
+    "cmd.show_keywords": "Surligneur TODO: Afficher les Mots-cles",
+    "cmd.show_keywords_desc": "Afficher les mots-cles actuellement suivis",
+    "status.enabled": "Surligneur TODO: Active",
+    "status.disabled": "Surligneur TODO: Desactive",
+    "status.loaded": "Plugin Surligneur TODO charge (TypeScript)",
+    "status.keywords": "Mots-cles TODO: %{keywords}"
+  },
+  "it": {
+    "cmd.enable": "Evidenziatore TODO: Attiva",
+    "cmd.enable_desc": "Attiva l'evidenziazione delle parole chiave TODO",
+    "cmd.disable": "Evidenziatore TODO: Disattiva",
+    "cmd.disable_desc": "Disattiva l'evidenziazione delle parole chiave TODO",
+    "cmd.toggle": "Evidenziatore TODO: Alterna",
+    "cmd.toggle_desc": "Alterna l'evidenziazione delle parole chiave TODO",
+    "cmd.show_keywords": "Evidenziatore TODO: Mostra parole chiave",
+    "cmd.show_keywords_desc": "Mostra le parole chiave attualmente monitorate",
+    "status.enabled": "Evidenziatore TODO: Attivato",
+    "status.disabled": "Evidenziatore TODO: Disattivato",
+    "status.loaded": "Plugin Evidenziatore TODO caricato (TypeScript)",
+    "status.keywords": "Parole chiave TODO: %{keywords}"
+  },
+  "ja": {
+    "cmd.enable": "TODOハイライター: 有効化",
+    "cmd.enable_desc": "TODOキーワードのハイライトを有効化",
+    "cmd.disable": "TODOハイライター: 無効化",
+    "cmd.disable_desc": "TODOキーワードのハイライトを無効化",
+    "cmd.toggle": "TODOハイライター: 切り替え",
+    "cmd.toggle_desc": "TODOキーワードのハイライトを切り替え",
+    "cmd.show_keywords": "TODOハイライター: キーワード表示",
+    "cmd.show_keywords_desc": "現在追跡中のキーワードを表示",
+    "status.enabled": "TODOハイライター: 有効",
+    "status.disabled": "TODOハイライター: 無効",
+    "status.loaded": "TODOハイライタープラグインを読み込みました (TypeScript)",
+    "status.keywords": "TODOキーワード: %{keywords}"
+  },
+  "ko": {
+    "cmd.enable": "TODO 하이라이터: 활성화",
+    "cmd.enable_desc": "TODO 키워드 강조 표시 활성화",
+    "cmd.disable": "TODO 하이라이터: 비활성화",
+    "cmd.disable_desc": "TODO 키워드 강조 표시 비활성화",
+    "cmd.toggle": "TODO 하이라이터: 전환",
+    "cmd.toggle_desc": "TODO 키워드 강조 표시 전환",
+    "cmd.show_keywords": "TODO 하이라이터: 키워드 표시",
+    "cmd.show_keywords_desc": "현재 추적 중인 키워드 표시",
+    "status.enabled": "TODO 하이라이터: 활성화됨",
+    "status.disabled": "TODO 하이라이터: 비활성화됨",
+    "status.loaded": "TODO 하이라이터 플러그인 로드됨 (TypeScript)",
+    "status.keywords": "TODO 키워드: %{keywords}"
+  },
+  "pt-BR": {
+    "cmd.enable": "Realcador TODO: Ativar",
+    "cmd.enable_desc": "Ativar realce de palavras-chave TODO",
+    "cmd.disable": "Realcador TODO: Desativar",
+    "cmd.disable_desc": "Desativar realce de palavras-chave TODO",
+    "cmd.toggle": "Realcador TODO: Alternar",
+    "cmd.toggle_desc": "Alternar realce de palavras-chave TODO",
+    "cmd.show_keywords": "Realcador TODO: Mostrar Palavras-chave",
+    "cmd.show_keywords_desc": "Mostrar palavras-chave atualmente rastreadas",
+    "status.enabled": "Realcador TODO: Ativado",
+    "status.disabled": "Realcador TODO: Desativado",
+    "status.loaded": "Plugin Realcador TODO carregado (TypeScript)",
+    "status.keywords": "Palavras-chave TODO: %{keywords}"
+  },
+  "ru": {
+    "cmd.enable": "Подсветка TODO: Включить",
+    "cmd.enable_desc": "Включить подсветку ключевых слов TODO",
+    "cmd.disable": "Подсветка TODO: Выключить",
+    "cmd.disable_desc": "Выключить подсветку ключевых слов TODO",
+    "cmd.toggle": "Подсветка TODO: Переключить",
+    "cmd.toggle_desc": "Переключить подсветку ключевых слов TODO",
+    "cmd.show_keywords": "Подсветка TODO: Показать ключевые слова",
+    "cmd.show_keywords_desc": "Показать текущие отслеживаемые ключевые слова",
+    "status.enabled": "Подсветка TODO: Включена",
+    "status.disabled": "Подсветка TODO: Выключена",
+    "status.loaded": "Плагин подсветки TODO загружен (TypeScript)",
+    "status.keywords": "Ключевые слова TODO: %{keywords}"
+  },
+  "th": {
+    "cmd.enable": "ตัวเน้น TODO: เปิดใช้งาน",
+    "cmd.enable_desc": "เปิดใช้งานการเน้นคำสำคัญ TODO",
+    "cmd.disable": "ตัวเน้น TODO: ปิดใช้งาน",
+    "cmd.disable_desc": "ปิดใช้งานการเน้นคำสำคัญ TODO",
+    "cmd.toggle": "ตัวเน้น TODO: สลับ",
+    "cmd.toggle_desc": "สลับการเน้นคำสำคัญ TODO",
+    "cmd.show_keywords": "ตัวเน้น TODO: แสดงคำสำคัญ",
+    "cmd.show_keywords_desc": "แสดงคำสำคัญที่กำลังติดตาม",
+    "status.enabled": "ตัวเน้น TODO: เปิดใช้งานแล้ว",
+    "status.disabled": "ตัวเน้น TODO: ปิดใช้งานแล้ว",
+    "status.loaded": "โหลดปลั๊กอินตัวเน้น TODO แล้ว (TypeScript)",
+    "status.keywords": "คำสำคัญ TODO: %{keywords}"
+  },
+  "uk": {
+    "cmd.enable": "Підсвічування TODO: Увімкнути",
+    "cmd.enable_desc": "Увімкнути підсвічування ключових слів TODO",
+    "cmd.disable": "Підсвічування TODO: Вимкнути",
+    "cmd.disable_desc": "Вимкнути підсвічування ключових слів TODO",
+    "cmd.toggle": "Підсвічування TODO: Перемкнути",
+    "cmd.toggle_desc": "Перемкнути підсвічування ключових слів TODO",
+    "cmd.show_keywords": "Підсвічування TODO: Показати ключові слова",
+    "cmd.show_keywords_desc": "Показати поточні відстежувані ключові слова",
+    "status.enabled": "Підсвічування TODO: Увімкнено",
+    "status.disabled": "Підсвічування TODO: Вимкнено",
+    "status.loaded": "Плагін підсвічування TODO завантажено (TypeScript)",
+    "status.keywords": "Ключові слова TODO: %{keywords}"
+  },
+  "zh-CN": {
+    "cmd.enable": "TODO高亮器: 启用",
+    "cmd.enable_desc": "启用TODO关键字高亮显示",
+    "cmd.disable": "TODO高亮器: 禁用",
+    "cmd.disable_desc": "禁用TODO关键字高亮显示",
+    "cmd.toggle": "TODO高亮器: 切换",
+    "cmd.toggle_desc": "切换TODO关键字高亮显示",
+    "cmd.show_keywords": "TODO高亮器: 显示关键字",
+    "cmd.show_keywords_desc": "显示当前跟踪的关键字",
+    "status.enabled": "TODO高亮器: 已启用",
+    "status.disabled": "TODO高亮器: 已禁用",
+    "status.loaded": "TODO高亮器插件已加载 (TypeScript)",
+    "status.keywords": "TODO关键字: %{keywords}"
+  }
+}

package/bin/plugins/todo_highlighter.ts

@@ -0,0 +1,206 @@
+// TypeScript TODO Highlighter Plugin
+// Highlights TODO, FIXME, XXX keywords in source code
+// Uses targeted overlay invalidation for efficient updates on edits
+const editor = getEditor();
+
+
+interface HighlightConfig {
+  enabled: boolean;
+  keywords: Array<{
+    word: string;
+    color: [number, number, number];
+  }>;
+}
+
+// Plugin configuration
+const config: HighlightConfig = {
+  enabled: false,  // Start disabled, use Enable or Toggle to activate
+  keywords: [
+    { word: "TODO", color: [255, 200, 50] },     // Yellow
+    { word: "FIXME", color: [255, 100, 100] },   // Red
+    { word: "XXX", color: [255, 150, 50] },      // Orange
+    { word: "HACK", color: [200, 100, 255] },    // Purple
+    { word: "NOTE", color: [100, 200, 255] },    // Blue
+  ],
+};
+
+// Namespace for all TODO highlighter overlays
+const NAMESPACE = "todo";
+
+// Process a single line for keyword highlighting
+function highlightLine(
+  bufferId: number,
+  byteStart: number,
+  content: string
+): void {
+  // Search for keywords
+  for (const keyword of config.keywords) {
+    let searchStart = 0;
+    while (true) {
+      const pos = content.indexOf(keyword.word, searchStart);
+      if (pos === -1) break;
+
+      // Check if it's a whole word (preceded by non-word char or start)
+      const isWordStart = pos === 0 || !/\w/.test(content[pos - 1]);
+      const isWordEnd = pos + keyword.word.length >= content.length ||
+                        !/\w/.test(content[pos + keyword.word.length]);
+
+      if (isWordStart && isWordEnd) {
+        const absoluteStart = byteStart + pos;
+        const absoluteEnd = absoluteStart + keyword.word.length;
+
+        // Add overlay with namespace for efficient batch removal
+        editor.addOverlay(
+          bufferId,
+          NAMESPACE,
+          absoluteStart,
+          absoluteEnd,
+          keyword.color[0],
+          keyword.color[1],
+          keyword.color[2],
+          false  // background color, not underline
+        );
+      }
+
+      searchStart = pos + 1;
+    }
+  }
+}
+
+// Clear highlights for a buffer using namespace
+function clearHighlights(bufferId: number): void {
+  editor.clearNamespace(bufferId, NAMESPACE);
+}
+
+// Handle lines_changed events (batched for efficiency)
+// This is called for lines that need (re)processing
+globalThis.onLinesChanged = function(data: {
+  buffer_id: number;
+  lines: Array<{
+    line_number: number;
+    byte_start: number;
+    byte_end: number;
+    content: string;
+  }>;
+}): void {
+  if (!config.enabled) return;
+
+  // Process all changed lines and create overlays for them
+  for (const line of data.lines) {
+    highlightLine(data.buffer_id, line.byte_start, line.content);
+  }
+};
+
+// Handle buffer content changes - clear only affected overlays
+// The editor will automatically re-send the affected lines via lines_changed
+globalThis.onAfterInsert = function(data: {
+  buffer_id: number;
+  position: number;
+  text: string;
+  affected_start: number;
+  affected_end: number;
+}): void {
+  if (!config.enabled) return;
+
+  // Clear only overlays that overlap with the insertion range
+  // These overlays may now span corrupted content (e.g., "TODO" -> "TOxDO")
+  // The affected lines will be re-sent via lines_changed with correct content
+  editor.clearOverlaysInRange(data.buffer_id, data.affected_start, data.affected_end);
+};
+
+globalThis.onAfterDelete = function(data: {
+  buffer_id: number;
+  start: number;
+  end: number;
+  deleted_text: string;
+  affected_start: number;
+  deleted_len: number;
+}): void {
+  if (!config.enabled) return;
+
+  // Clear overlays that overlapped with the deleted range
+  // Overlays that were entirely within the deleted range are already gone
+  // (their markers were deleted), but overlays that spanned the deletion
+  // boundary may now be incorrect
+  // Use a slightly expanded range to catch boundary cases
+  const clearStart = data.affected_start > 0 ? data.affected_start - 1 : 0;
+  const clearEnd = data.affected_start + 1;
+  editor.clearOverlaysInRange(data.buffer_id, clearStart, clearEnd);
+};
+
+// Handle buffer close events
+globalThis.onBufferClosed = function(data: { buffer_id: number }): void {
+  // No cleanup needed - overlays are automatically cleaned up with the buffer
+};
+
+// Register hooks
+editor.on("lines_changed", "onLinesChanged");
+editor.on("after_insert", "onAfterInsert");
+editor.on("after_delete", "onAfterDelete");
+editor.on("buffer_closed", "onBufferClosed");
+
+// Plugin commands
+globalThis.todoHighlighterEnable = function(): void {
+  config.enabled = true;
+  // Refresh lines so next render processes all visible lines
+  const bufferId = editor.getActiveBufferId();
+  editor.refreshLines(bufferId);
+  editor.setStatus(editor.t("status.enabled"));
+};
+
+globalThis.todoHighlighterDisable = function(): void {
+  config.enabled = false;
+  const bufferId = editor.getActiveBufferId();
+  clearHighlights(bufferId);
+  editor.setStatus(editor.t("status.disabled"));
+};
+
+globalThis.todoHighlighterToggle = function(): void {
+  config.enabled = !config.enabled;
+  const bufferId = editor.getActiveBufferId();
+  if (config.enabled) {
+    // Refresh lines so next render processes all visible lines
+    editor.refreshLines(bufferId);
+  } else {
+    clearHighlights(bufferId);
+  }
+  editor.setStatus(config.enabled ? editor.t("status.enabled") : editor.t("status.disabled"));
+};
+
+globalThis.todoHighlighterShowKeywords = function(): void {
+  const keywords = config.keywords.map(k => k.word).join(", ");
+  editor.setStatus(editor.t("status.keywords", { keywords }));
+};
+
+// Register commands
+editor.registerCommand(
+  "%cmd.enable",
+  "%cmd.enable_desc",
+  "todoHighlighterEnable",
+  "normal"
+);
+
+editor.registerCommand(
+  "%cmd.disable",
+  "%cmd.disable_desc",
+  "todoHighlighterDisable",
+  "normal"
+);
+
+editor.registerCommand(
+  "%cmd.toggle",
+  "%cmd.toggle_desc",
+  "todoHighlighterToggle",
+  "normal"
+);
+
+editor.registerCommand(
+  "%cmd.show_keywords",
+  "%cmd.show_keywords_desc",
+  "todoHighlighterShowKeywords",
+  "normal"
+);
+
+// Initialization
+editor.setStatus(editor.t("status.loaded"));
+editor.debug("TODO Highlighter initialized with keywords: " + config.keywords.map(k => k.word).join(", "));

package/bin/plugins/typescript-lsp.ts

@@ -0,0 +1,167 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+
+/**
+ * TypeScript/JavaScript LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for TypeScript/JavaScript LSP server issues.
+ * When typescript-language-server fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects TypeScript LSP server errors (typescript-language-server, tsserver)
+ * - Shows popup with install commands (npm, yarn, pnpm)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable TypeScript 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 TypeScript LSP server
+// Both typescript-language-server AND typescript packages are required
+// See: https://github.com/typescript-language-server/typescript-language-server
+const INSTALL_COMMANDS = {
+  npm: "npm install -g typescript-language-server typescript",
+  yarn: "yarn global add typescript-language-server typescript",
+  pnpm: "pnpm add -g typescript-language-server typescript",
+};
+
+// Languages handled by this plugin
+const HANDLED_LANGUAGES = ["typescript", "javascript", "typescriptreact", "javascriptreact"];
+
+// Track error state for TypeScript LSP
+let tsLspError: { serverCommand: string; message: string; language: string } | null = null;
+
+/**
+ * Handle LSP server errors for TypeScript/JavaScript
+ */
+globalThis.on_typescript_lsp_server_error = function (
+  data: LspServerErrorData
+): void {
+  // Only handle TypeScript/JavaScript language errors
+  if (!HANDLED_LANGUAGES.includes(data.language)) {
+    return;
+  }
+
+  editor.debug(
+    `typescript-lsp: Server error - ${data.error_type}: ${data.message}`
+  );
+
+  // Store error state for later reference
+  tsLspError = {
+    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(
+      `TypeScript LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`TypeScript LSP error: ${data.message}`);
+  }
+};
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_typescript_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a TypeScript LSP error
+ */
+globalThis.on_typescript_lsp_status_clicked = function (
+  data: LspStatusClickedData
+): void {
+  // Only handle TypeScript/JavaScript language clicks when there's an error
+  if (!HANDLED_LANGUAGES.includes(data.language) || !tsLspError) {
+    return;
+  }
+
+  editor.debug("typescript-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "typescript-lsp-help",
+    title: "TypeScript Language Server Not Found",
+    message: `"${tsLspError.serverCommand}" provides code completion, diagnostics, and navigation for TypeScript/JavaScript files. Copy a command below to install it, or search online for your platform.`,
+    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 TypeScript LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+};
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_typescript_lsp_status_clicked");
+
+/**
+ * Handle action popup results for TypeScript LSP help
+ */
+globalThis.on_typescript_lsp_action_result = function (
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "typescript-lsp-help") {
+    return;
+  }
+
+  editor.debug(`typescript-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":
+      // Disable for all TypeScript/JavaScript variants
+      editor.disableLspForLanguage("typescript");
+      editor.disableLspForLanguage("javascript");
+      editor.setStatus("TypeScript/JavaScript LSP disabled");
+      tsLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`typescript-lsp: Unknown action: ${data.action_id}`);
+  }
+};
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_typescript_lsp_action_result");
+
+editor.debug("typescript-lsp: Plugin loaded");