@involvex/fresh-editor 0.1.76 → 0.1.78

package/bin/plugins/find_references.i18n.json

@@ -0,0 +1,275 @@
+{
+  "cs": {
+    "cmd.show_references": "Zobrazit panel odkazu",
+    "cmd.show_references_desc": "Zobrazit aktualni odkazy",
+    "cmd.hide_references": "Skryt panel odkazu",
+    "cmd.hide_references_desc": "Zavrit panel odkazu",
+    "status.ready": "Plugin Najit odkazy nacten",
+    "status.no_references": "Zadne odkazy pro '{symbol}' nenalezeny",
+    "status.found_references": "Nalezeno {count} odkazu{limit} - Nahoru/Dolu navigace, RET skok, q zavrit",
+    "status.showing_first": " (zobrazuji prvnich {max})",
+    "status.reference_index": "Odkaz {current}/{total}",
+    "status.jumped_to": "Skok na {file}:{line}",
+    "status.no_references_to_jump": "Zadne odkazy k preskoceni",
+    "status.source_split_unavailable": "Rozdeleni zdroje neni k dispozici",
+    "status.move_cursor": "Presunte kurzor na radek odkazu",
+    "status.closed": "Panel odkazu zavren",
+    "status.failed_open_panel": "Nepodarilo se otevrit panel odkazu",
+    "panel.header": "Odkazy na {symbol} ({count}{limit})",
+    "panel.limited": ", omezeno na {max}",
+    "panel.no_references": "Zadne odkazy nenalezeny",
+    "panel.help": "[Nahoru/Dolu] navigace  [RET] skok  [q/Esc] zavrit"
+  },
+  "de": {
+    "cmd.show_references": "Referenzen-Panel anzeigen",
+    "cmd.show_references_desc": "Aktuelle Referenzen anzeigen",
+    "cmd.hide_references": "Referenzen-Panel ausblenden",
+    "cmd.hide_references_desc": "Das Referenzen-Panel schliessen",
+    "status.ready": "Referenzen-Plugin geladen",
+    "status.no_references": "Keine Referenzen fur '{symbol}' gefunden",
+    "status.found_references": "{count} Referenz(en) gefunden{limit} - Auf/Ab navigieren, RET springen, q schliessen",
+    "status.showing_first": " (zeige erste {max})",
+    "status.reference_index": "Referenz {current}/{total}",
+    "status.jumped_to": "Gesprungen zu {file}:{line}",
+    "status.no_references_to_jump": "Keine Referenzen zum Springen",
+    "status.source_split_unavailable": "Quell-Split nicht verfugbar",
+    "status.move_cursor": "Cursor auf eine Referenzzeile bewegen",
+    "status.closed": "Referenzen-Panel geschlossen",
+    "status.failed_open_panel": "Fehler beim Offnen des Referenzen-Panels",
+    "panel.header": "Referenzen zu {symbol} ({count}{limit})",
+    "panel.limited": ", begrenzt auf {max}",
+    "panel.no_references": "Keine Referenzen gefunden",
+    "panel.help": "[Auf/Ab] navigieren  [RET] springen  [q/Esc] schliessen"
+  },
+  "en": {
+    "cmd.show_references": "Show References Panel",
+    "cmd.show_references_desc": "Display current references",
+    "cmd.hide_references": "Hide References Panel",
+    "cmd.hide_references_desc": "Close the references panel",
+    "status.ready": "Find References plugin loaded",
+    "status.no_references": "No references found for '{symbol}'",
+    "status.found_references": "Found {count} reference(s){limit} - Up/Down navigate, RET jump, q close",
+    "status.showing_first": " (showing first {max})",
+    "status.reference_index": "Reference {current}/{total}",
+    "status.jumped_to": "Jumped to {file}:{line}",
+    "status.no_references_to_jump": "No references to jump to",
+    "status.source_split_unavailable": "Source split not available",
+    "status.move_cursor": "Move cursor to a reference line",
+    "status.closed": "References panel closed",
+    "status.failed_open_panel": "Failed to open references panel",
+    "panel.header": "References to {symbol} ({count}{limit})",
+    "panel.limited": ", limited to {max}",
+    "panel.no_references": "No references found",
+    "panel.help": "[Up/Down] navigate  [RET] jump  [q/Esc] close"
+  },
+  "es": {
+    "cmd.show_references": "Mostrar Panel de Referencias",
+    "cmd.show_references_desc": "Mostrar las referencias actuales",
+    "cmd.hide_references": "Ocultar Panel de Referencias",
+    "cmd.hide_references_desc": "Cerrar el panel de referencias",
+    "status.ready": "Plugin Buscar Referencias cargado",
+    "status.no_references": "No se encontraron referencias para '{symbol}'",
+    "status.found_references": "Se encontraron {count} referencia(s){limit} - Arriba/Abajo navegar, RET saltar, q cerrar",
+    "status.showing_first": " (mostrando primeros {max})",
+    "status.reference_index": "Referencia {current}/{total}",
+    "status.jumped_to": "Salto a {file}:{line}",
+    "status.no_references_to_jump": "No hay referencias a las que saltar",
+    "status.source_split_unavailable": "Division de origen no disponible",
+    "status.move_cursor": "Mueve el cursor a una linea de referencia",
+    "status.closed": "Panel de referencias cerrado",
+    "status.failed_open_panel": "Error al abrir el panel de referencias",
+    "panel.header": "Referencias a {symbol} ({count}{limit})",
+    "panel.limited": ", limitado a {max}",
+    "panel.no_references": "No se encontraron referencias",
+    "panel.help": "[Arriba/Abajo] navegar  [RET] saltar  [q/Esc] cerrar"
+  },
+  "fr": {
+    "cmd.show_references": "Afficher le panneau des references",
+    "cmd.show_references_desc": "Afficher les references actuelles",
+    "cmd.hide_references": "Masquer le panneau des references",
+    "cmd.hide_references_desc": "Fermer le panneau des references",
+    "status.ready": "Plugin Trouver les References charge",
+    "status.no_references": "Aucune reference trouvee pour '{symbol}'",
+    "status.found_references": "{count} reference(s) trouvee(s){limit} - Haut/Bas naviguer, RET sauter, q fermer",
+    "status.showing_first": " (affichage des {max} premiers)",
+    "status.reference_index": "Reference {current}/{total}",
+    "status.jumped_to": "Saute a {file}:{line}",
+    "status.no_references_to_jump": "Aucune reference vers laquelle sauter",
+    "status.source_split_unavailable": "Panneau source non disponible",
+    "status.move_cursor": "Deplacez le curseur sur une ligne de reference",
+    "status.closed": "Panneau des references ferme",
+    "status.failed_open_panel": "Echec de l'ouverture du panneau des references",
+    "panel.header": "References a {symbol} ({count}{limit})",
+    "panel.limited": ", limite a {max}",
+    "panel.no_references": "Aucune reference trouvee",
+    "panel.help": "[Haut/Bas] naviguer  [RET] sauter  [q/Esc] fermer"
+  },
+  "it": {
+    "cmd.show_references": "Mostra pannello riferimenti",
+    "cmd.show_references_desc": "Visualizza i riferimenti correnti",
+    "cmd.hide_references": "Nascondi pannello riferimenti",
+    "cmd.hide_references_desc": "Chiudi il pannello riferimenti",
+    "status.ready": "Plugin Trova riferimenti caricato",
+    "status.no_references": "Nessun riferimento trovato per '{symbol}'",
+    "status.found_references": "Trovati {count} riferimenti{limit} - Su/Giù naviga, RET vai a, q chiudi",
+    "status.showing_first": " (visualizzati i primi {max})",
+    "status.reference_index": "Riferimento {current}/{total}",
+    "status.jumped_to": "Passato a {file}:{line}",
+    "status.no_references_to_jump": "Nessun riferimento a cui passare",
+    "status.source_split_unavailable": "Split sorgente non disponibile",
+    "status.move_cursor": "Sposta il cursore su una riga di riferimento",
+    "status.closed": "Pannello riferimenti chiuso",
+    "status.failed_open_panel": "Impossibile aprire il pannello riferimenti",
+    "panel.header": "Riferimenti a {symbol} ({count}{limit})",
+    "panel.limited": ", limitati a {max}",
+    "panel.no_references": "Nessun riferimento trovato",
+    "panel.help": "[Su/Giù] naviga  [RET] vai a  [q/Esc] chiudi"
+  },
+  "ja": {
+    "cmd.show_references": "参照パネルを表示",
+    "cmd.show_references_desc": "現在の参照を表示",
+    "cmd.hide_references": "参照パネルを非表示",
+    "cmd.hide_references_desc": "参照パネルを閉じる",
+    "status.ready": "参照検索プラグインが読み込まれました",
+    "status.no_references": "'{symbol}' の参照が見つかりません",
+    "status.found_references": "{count} 件の参照が見つかりました{limit} - 上/下で移動、RETでジャンプ、qで閉じる",
+    "status.showing_first": " (最初の {max} 件を表示)",
+    "status.reference_index": "参照 {current}/{total}",
+    "status.jumped_to": "{file}:{line} にジャンプしました",
+    "status.no_references_to_jump": "ジャンプする参照がありません",
+    "status.source_split_unavailable": "ソース分割が利用できません",
+    "status.move_cursor": "カーソルを参照行に移動してください",
+    "status.closed": "参照パネルを閉じました",
+    "status.failed_open_panel": "参照パネルを開けませんでした",
+    "panel.header": "{symbol} への参照 ({count}{limit})",
+    "panel.limited": "、最大 {max} 件",
+    "panel.no_references": "参照が見つかりません",
+    "panel.help": "[上/下] 移動  [RET] ジャンプ  [q/Esc] 閉じる"
+  },
+  "ko": {
+    "cmd.show_references": "참조 패널 표시",
+    "cmd.show_references_desc": "현재 참조 표시",
+    "cmd.hide_references": "참조 패널 숨기기",
+    "cmd.hide_references_desc": "참조 패널 닫기",
+    "status.ready": "참조 찾기 플러그인이 로드되었습니다",
+    "status.no_references": "'{symbol}'에 대한 참조를 찾을 수 없습니다",
+    "status.found_references": "{count}개의 참조를 찾았습니다{limit} - 위/아래 탐색, RET 이동, q 닫기",
+    "status.showing_first": " (처음 {max}개 표시)",
+    "status.reference_index": "참조 {current}/{total}",
+    "status.jumped_to": "{file}:{line}(으)로 이동했습니다",
+    "status.no_references_to_jump": "이동할 참조가 없습니다",
+    "status.source_split_unavailable": "소스 분할을 사용할 수 없습니다",
+    "status.move_cursor": "커서를 참조 줄로 이동하세요",
+    "status.closed": "참조 패널이 닫혔습니다",
+    "status.failed_open_panel": "참조 패널을 열 수 없습니다",
+    "panel.header": "{symbol}에 대한 참조 ({count}{limit})",
+    "panel.limited": ", {max}개로 제한",
+    "panel.no_references": "참조를 찾을 수 없습니다",
+    "panel.help": "[위/아래] 탐색  [RET] 이동  [q/Esc] 닫기"
+  },
+  "pt-BR": {
+    "cmd.show_references": "Mostrar Painel de Referencias",
+    "cmd.show_references_desc": "Exibir referencias atuais",
+    "cmd.hide_references": "Ocultar Painel de Referencias",
+    "cmd.hide_references_desc": "Fechar o painel de referencias",
+    "status.ready": "Plugin Encontrar Referencias carregado",
+    "status.no_references": "Nenhuma referencia encontrada para '{symbol}'",
+    "status.found_references": "Encontradas {count} referencia(s){limit} - Cima/Baixo navegar, RET pular, q fechar",
+    "status.showing_first": " (mostrando primeiras {max})",
+    "status.reference_index": "Referencia {current}/{total}",
+    "status.jumped_to": "Pulou para {file}:{line}",
+    "status.no_references_to_jump": "Nenhuma referencia para pular",
+    "status.source_split_unavailable": "Divisao de origem nao disponivel",
+    "status.move_cursor": "Mova o cursor para uma linha de referencia",
+    "status.closed": "Painel de referencias fechado",
+    "status.failed_open_panel": "Falha ao abrir o painel de referencias",
+    "panel.header": "Referencias a {symbol} ({count}{limit})",
+    "panel.limited": ", limitado a {max}",
+    "panel.no_references": "Nenhuma referencia encontrada",
+    "panel.help": "[Cima/Baixo] navegar  [RET] pular  [q/Esc] fechar"
+  },
+  "ru": {
+    "cmd.show_references": "Показать панель ссылок",
+    "cmd.show_references_desc": "Показать текущие ссылки",
+    "cmd.hide_references": "Скрыть панель ссылок",
+    "cmd.hide_references_desc": "Закрыть панель ссылок",
+    "status.ready": "Плагин поиска ссылок загружен",
+    "status.no_references": "Ссылки для '{symbol}' не найдены",
+    "status.found_references": "Найдено {count} ссылок{limit} - Вверх/Вниз навигация, RET переход, q закрыть",
+    "status.showing_first": " (показаны первые {max})",
+    "status.reference_index": "Ссылка {current}/{total}",
+    "status.jumped_to": "Переход к {file}:{line}",
+    "status.no_references_to_jump": "Нет ссылок для перехода",
+    "status.source_split_unavailable": "Разделение источника недоступно",
+    "status.move_cursor": "Переместите курсор на строку ссылки",
+    "status.closed": "Панель ссылок закрыта",
+    "status.failed_open_panel": "Не удалось открыть панель ссылок",
+    "panel.header": "Ссылки на {symbol} ({count}{limit})",
+    "panel.limited": ", ограничено до {max}",
+    "panel.no_references": "Ссылки не найдены",
+    "panel.help": "[Вверх/Вниз] навигация  [RET] переход  [q/Esc] закрыть"
+  },
+  "th": {
+    "cmd.show_references": "แสดงแผงการอ้างอิง",
+    "cmd.show_references_desc": "แสดงการอ้างอิงปัจจุบัน",
+    "cmd.hide_references": "ซ่อนแผงการอ้างอิง",
+    "cmd.hide_references_desc": "ปิดแผงการอ้างอิง",
+    "status.ready": "โหลดปลั๊กอินค้นหาการอ้างอิงแล้ว",
+    "status.no_references": "ไม่พบการอ้างอิงสำหรับ '{symbol}'",
+    "status.found_references": "พบ {count} การอ้างอิง{limit} - ขึ้น/ลง นำทาง, RET ข้าม, q ปิด",
+    "status.showing_first": " (แสดง {max} รายการแรก)",
+    "status.reference_index": "การอ้างอิง {current}/{total}",
+    "status.jumped_to": "ข้ามไปที่ {file}:{line}",
+    "status.no_references_to_jump": "ไม่มีการอ้างอิงให้ข้าม",
+    "status.source_split_unavailable": "การแยกแหล่งที่มาไม่พร้อมใช้งาน",
+    "status.move_cursor": "เลื่อนเคอร์เซอร์ไปที่บรรทัดการอ้างอิง",
+    "status.closed": "ปิดแผงการอ้างอิงแล้ว",
+    "status.failed_open_panel": "ไม่สามารถเปิดแผงการอ้างอิง",
+    "panel.header": "การอ้างอิงถึง {symbol} ({count}{limit})",
+    "panel.limited": ", จำกัด {max}",
+    "panel.no_references": "ไม่พบการอ้างอิง",
+    "panel.help": "[ขึ้น/ลง] นำทาง  [RET] ข้าม  [q/Esc] ปิด"
+  },
+  "uk": {
+    "cmd.show_references": "Показати панель посилань",
+    "cmd.show_references_desc": "Показати поточні посилання",
+    "cmd.hide_references": "Сховати панель посилань",
+    "cmd.hide_references_desc": "Закрити панель посилань",
+    "status.ready": "Плагін пошуку посилань завантажено",
+    "status.no_references": "Посилання для '{symbol}' не знайдено",
+    "status.found_references": "Знайдено {count} посилань{limit} - Вгору/Вниз навігація, RET перехід, q закрити",
+    "status.showing_first": " (показано перші {max})",
+    "status.reference_index": "Посилання {current}/{total}",
+    "status.jumped_to": "Перехід до {file}:{line}",
+    "status.no_references_to_jump": "Немає посилань для переходу",
+    "status.source_split_unavailable": "Розділення джерела недоступне",
+    "status.move_cursor": "Перемістіть курсор на рядок посилання",
+    "status.closed": "Панель посилань закрито",
+    "status.failed_open_panel": "Не вдалося відкрити панель посилань",
+    "panel.header": "Посилання на {symbol} ({count}{limit})",
+    "panel.limited": ", обмежено до {max}",
+    "panel.no_references": "Посилання не знайдено",
+    "panel.help": "[Вгору/Вниз] навігація  [RET] перехід  [q/Esc] закрити"
+  },
+  "zh-CN": {
+    "cmd.show_references": "显示引用面板",
+    "cmd.show_references_desc": "显示当前引用",
+    "cmd.hide_references": "隐藏引用面板",
+    "cmd.hide_references_desc": "关闭引用面板",
+    "status.ready": "查找引用插件已加载",
+    "status.no_references": "未找到 '{symbol}' 的引用",
+    "status.found_references": "找到 {count} 个引用{limit} - 上/下导航，回车跳转，q 关闭",
+    "status.showing_first": " (显示前 {max} 个)",
+    "status.reference_index": "引用 {current}/{total}",
+    "status.jumped_to": "跳转到 {file}:{line}",
+    "status.no_references_to_jump": "没有可跳转的引用",
+    "status.source_split_unavailable": "源分割不可用",
+    "status.move_cursor": "将光标移动到引用行",
+    "status.closed": "引用面板已关闭",
+    "status.failed_open_panel": "无法打开引用面板",
+    "panel.header": "{symbol} 的引用 ({count}{limit})",
+    "panel.limited": "，限制为 {max}",
+    "panel.no_references": "未找到引用",
+    "panel.help": "[上/下] 导航  [回车] 跳转  [q/Esc] 关闭"
+  }
+}

package/bin/plugins/find_references.ts

@@ -0,0 +1,359 @@
+/// <reference path="../types/fresh.d.ts" />
+const editor = getEditor();
+
+
+/**
+ * Find References Plugin (TypeScript)
+ *
+ * Displays LSP find references results in a virtual buffer split view.
+ * Listens for lsp_references hook from the editor and shows results.
+ * Uses cursor movement for navigation (Up/Down/j/k work naturally).
+ */
+
+// Panel state
+let panelOpen = false;
+let referencesBufferId: number | null = null;
+let sourceSplitId: number | null = null;
+let referencesSplitId: number | null = null; // Track the split we created
+let currentReferences: ReferenceItem[] = [];
+let currentSymbol: string = "";
+let lineCache: Map<string, string[]> = new Map(); // Cache file contents
+
+// Maximum number of results to display
+const MAX_RESULTS = 100;
+
+// Reference item structure
+interface ReferenceItem {
+  file: string;
+  line: number;
+  column: number;
+  lineText?: string; // Cached line text
+}
+
+// Define the references mode with minimal keybindings
+// Navigation uses normal cursor movement (arrows, j/k work naturally)
+editor.defineMode(
+  "references-list",
+  null, // no parent mode
+  [
+    ["Return", "references_goto"],
+    ["q", "references_close"],
+    ["Escape", "references_close"],
+  ],
+  true // read-only
+);
+
+// Get relative path for display
+function getRelativePath(filePath: string): string {
+  const cwd = editor.getCwd();
+  if (filePath.startsWith(cwd)) {
+    return filePath.slice(cwd.length + 1); // Remove cwd and leading /
+  }
+  return filePath;
+}
+
+// Format a reference for display with line preview
+function formatReference(item: ReferenceItem): string {
+  const displayPath = getRelativePath(item.file);
+  const location = `${displayPath}:${item.line}:${item.column}`;
+
+  // Truncate location if too long, leaving room for line text
+  const maxLocationLen = 50;
+  const truncatedLocation = location.length > maxLocationLen
+    ? "..." + location.slice(-(maxLocationLen - 3))
+    : location.padEnd(maxLocationLen);
+
+  // Get line text preview (truncated)
+  const lineText = item.lineText || "";
+  const trimmedLine = lineText.trim();
+  const maxLineLen = 60;
+  const displayLine = trimmedLine.length > maxLineLen
+    ? trimmedLine.slice(0, maxLineLen - 3) + "..."
+    : trimmedLine;
+
+  return `  ${truncatedLocation}  ${displayLine}\n`;
+}
+
+// Build entries for the virtual buffer
+function buildPanelEntries(): TextPropertyEntry[] {
+  const entries: TextPropertyEntry[] = [];
+
+  // Header with symbol name
+  const totalCount = currentReferences.length;
+  const limitNote = totalCount >= MAX_RESULTS ? editor.t("panel.limited", { max: String(MAX_RESULTS) }) : "";
+  const symbolDisplay = currentSymbol ? `'${currentSymbol}'` : "symbol";
+  entries.push({
+    text: `═══ ${editor.t("panel.header", { symbol: symbolDisplay, count: String(totalCount), limit: limitNote })} ═══\n`,
+    properties: { type: "header" },
+  });
+
+  if (currentReferences.length === 0) {
+    entries.push({
+      text: "  " + editor.t("panel.no_references") + "\n",
+      properties: { type: "empty" },
+    });
+  } else {
+    // Add each reference
+    for (let i = 0; i < currentReferences.length; i++) {
+      const ref = currentReferences[i];
+      entries.push({
+        text: formatReference(ref),
+        properties: {
+          type: "reference",
+          index: i,
+          location: {
+            file: ref.file,
+            line: ref.line,
+            column: ref.column,
+          },
+        },
+      });
+    }
+  }
+
+  // Footer
+  entries.push({
+    text: `───────────────────────────────────────────────────────────────────────────────\n`,
+    properties: { type: "separator" },
+  });
+  entries.push({
+    text: editor.t("panel.help") + "\n",
+    properties: { type: "help" },
+  });
+
+  return entries;
+}
+
+// Load line text for references
+async function loadLineTexts(references: ReferenceItem[]): Promise<void> {
+  // Group references by file
+  const fileRefs: Map<string, ReferenceItem[]> = new Map();
+  for (const ref of references) {
+    if (!fileRefs.has(ref.file)) {
+      fileRefs.set(ref.file, []);
+    }
+    fileRefs.get(ref.file)!.push(ref);
+  }
+
+  // Load each file and extract lines
+  for (const [filePath, refs] of fileRefs) {
+    try {
+      // Check cache first
+      let lines = lineCache.get(filePath);
+      if (!lines) {
+        const content = await editor.readFile(filePath);
+        lines = content.split("\n");
+        lineCache.set(filePath, lines);
+      }
+
+      // Set line text for each reference
+      for (const ref of refs) {
+        const lineIndex = ref.line - 1; // Convert 1-based to 0-based
+        if (lineIndex >= 0 && lineIndex < lines.length) {
+          ref.lineText = lines[lineIndex];
+        } else {
+          ref.lineText = "";
+        }
+      }
+    } catch (error) {
+      // If file can't be read, leave lineText empty
+      for (const ref of refs) {
+        ref.lineText = "";
+      }
+    }
+  }
+}
+
+// Show references panel
+async function showReferencesPanel(symbol: string, references: ReferenceItem[]): Promise<void> {
+  // Only save the source split ID if panel is not already open
+  // (avoid overwriting it with the references split ID on subsequent calls)
+  if (!panelOpen) {
+    sourceSplitId = editor.getActiveSplitId();
+  }
+
+  // Limit results
+  const limitedRefs = references.slice(0, MAX_RESULTS);
+
+  // Set references and symbol
+  currentSymbol = symbol;
+  currentReferences = limitedRefs;
+
+  // Load line texts for preview
+  await loadLineTexts(currentReferences);
+
+  // Build panel entries
+  const entries = buildPanelEntries();
+
+  // Create or update virtual buffer in horizontal split
+  // The panel_id mechanism will reuse the existing buffer/split if it exists
+  try {
+    referencesBufferId = await editor.createVirtualBufferInSplit({
+      name: "*References*",
+      mode: "references-list",
+      read_only: true,
+      entries: entries,
+      ratio: 0.7, // Original pane takes 70%, references takes 30%
+      panel_id: "references-panel",
+      show_line_numbers: false,
+      show_cursors: true, // Enable cursor for navigation
+    });
+
+    panelOpen = true;
+    // Track the references split (it becomes active after creation)
+    referencesSplitId = editor.getActiveSplitId();
+
+    const limitMsg = references.length > MAX_RESULTS
+      ? editor.t("status.showing_first", { max: String(MAX_RESULTS) })
+      : "";
+    editor.setStatus(
+      editor.t("status.found_references", { count: String(references.length), limit: limitMsg })
+    );
+    editor.debug(`References panel opened with buffer ID ${referencesBufferId}, split ID ${referencesSplitId}`);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    editor.setStatus(editor.t("status.failed_open_panel"));
+    editor.debug(`ERROR: createVirtualBufferInSplit failed: ${errorMessage}`);
+  }
+}
+
+// Handle lsp_references hook
+globalThis.on_lsp_references = function (data: { symbol: string; locations: ReferenceItem[] }): void {
+  editor.debug(`Received ${data.locations.length} references for '${data.symbol}'`);
+
+  if (data.locations.length === 0) {
+    editor.setStatus(editor.t("status.no_references", { symbol: data.symbol }));
+    return;
+  }
+
+  // Clear line cache for fresh results
+  lineCache.clear();
+
+  // Show the references panel
+  showReferencesPanel(data.symbol, data.locations);
+};
+
+// Register the hook handler
+editor.on("lsp_references", "on_lsp_references");
+
+// Handle cursor movement to show current reference info
+globalThis.on_references_cursor_moved = function (data: {
+  buffer_id: number;
+  cursor_id: number;
+  old_position: number;
+  new_position: number;
+}): void {
+  // Only handle cursor movement in our references buffer
+  if (referencesBufferId === null || data.buffer_id !== referencesBufferId) {
+    return;
+  }
+
+  // Get cursor line to determine which reference is selected
+  // getCursorLine() returns the line for the active buffer
+  const cursorLine = editor.getCursorLine();
+
+  // Line 0 is header, lines 1 to N are references
+  const refIndex = cursorLine - 1;
+
+  if (refIndex >= 0 && refIndex < currentReferences.length) {
+    editor.setStatus(editor.t("status.reference_index", { current: String(refIndex + 1), total: String(currentReferences.length) }));
+  }
+};
+
+// Register cursor movement handler
+editor.on("cursor_moved", "on_references_cursor_moved");
+
+// Hide references panel
+globalThis.hide_references_panel = function (): void {
+  if (!panelOpen) {
+    return;
+  }
+
+  if (referencesBufferId !== null) {
+    editor.closeBuffer(referencesBufferId);
+  }
+
+  // Close the split we created (if it exists and is different from source)
+  if (referencesSplitId !== null && referencesSplitId !== sourceSplitId) {
+    editor.closeSplit(referencesSplitId);
+  }
+
+  panelOpen = false;
+  referencesBufferId = null;
+  sourceSplitId = null;
+  referencesSplitId = null;
+  currentReferences = [];
+  currentSymbol = "";
+  lineCache.clear();
+  editor.setStatus(editor.t("status.closed"));
+};
+
+// Navigation: go to selected reference (based on cursor position)
+globalThis.references_goto = function (): void {
+  if (currentReferences.length === 0) {
+    editor.setStatus(editor.t("status.no_references_to_jump"));
+    return;
+  }
+
+  if (sourceSplitId === null) {
+    editor.setStatus(editor.t("status.source_split_unavailable"));
+    return;
+  }
+
+  if (referencesBufferId === null) {
+    return;
+  }
+
+  // Get text properties at cursor position
+  const props = editor.getTextPropertiesAtCursor(referencesBufferId);
+  editor.debug(`references_goto: props.length=${props.length}, referencesBufferId=${referencesBufferId}, sourceSplitId=${sourceSplitId}`);
+
+  if (props.length > 0) {
+    editor.debug(`references_goto: props[0]=${JSON.stringify(props[0])}`);
+    const location = props[0].location as
+      | { file: string; line: number; column: number }
+      | undefined;
+    if (location) {
+      editor.debug(`references_goto: opening ${location.file}:${location.line}:${location.column} in split ${sourceSplitId}`);
+      // Open file in the source split, not the references split
+      editor.openFileInSplit(
+        sourceSplitId,
+        location.file,
+        location.line,
+        location.column || 0
+      );
+      const displayPath = getRelativePath(location.file);
+      editor.setStatus(editor.t("status.jumped_to", { file: displayPath, line: String(location.line) }));
+    } else {
+      editor.debug(`references_goto: no location in props[0]`);
+      editor.setStatus(editor.t("status.move_cursor"));
+    }
+  } else {
+    editor.debug(`references_goto: no props found at cursor`);
+    editor.setStatus(editor.t("status.move_cursor"));
+  }
+};
+
+// Close the references panel
+globalThis.references_close = function (): void {
+  globalThis.hide_references_panel();
+};
+
+// Register commands
+editor.registerCommand(
+  "%cmd.show_references",
+  "%cmd.show_references_desc",
+  "show_references_panel",
+  "normal"
+);
+
+editor.registerCommand(
+  "%cmd.hide_references",
+  "%cmd.hide_references_desc",
+  "hide_references_panel",
+  "normal"
+);
+
+// Plugin initialization
+editor.setStatus(editor.t("status.ready"));
+editor.debug("Find References plugin initialized");