✨ feat(vscode): 代码阅读预览按住 ⌘ / Ctrl 点名字跳到定义

vscode/src/codeReader/editor/messages.ts

@@ -6,6 +6,15 @@ import type { BlockView } from '../blockView'
 
 export interface TranslatorOption { id: string, label: string }
 
+/**
+ * 让预览滚到包含 line 的块。definition 只在跳到定义时有：定义处那个名字在源码里的下标（Segment.offset），
+ * 预览展开把它折叠住的块和属性行，再让那块闪几下。
+ */
+export interface Reveal {
+  line: number
+  definition?: number
+}
+
 export interface DocumentMessage {
   type: 'document'
   /** TextDocument.version：webview 靠它判断是不是新一份文档 */
@@ -15,18 +24,29 @@ export interface DocumentMessage {
   translators: TranslatorOption[]
   translatorId: string
   error?: string
-  /** 从文本编辑器切过来时它顶部那一行：新预览只在第一份 document 里带，webview 滚到包含这行的块 */
-  revealLine?: number
+  /** 新预览只在第一份 document 里带：从文本编辑器切过来时是它顶部那一行，跳到定义时是定义处 */
+  reveal?: Reveal
 }
 
-export type ExtensionToWebview = DocumentMessage
+/**
+ * reveal：已经开着的预览滚到某处（同 DocumentMessage.reveal）
+ * definitionProbed：probeDefinition 的回答，found 表示 VS Code 查得到定义
+ */
+export type ExtensionToWebview
+  = | DocumentMessage
+    | ({ type: 'reveal' } & Reveal)
+    | { type: 'definitionProbed', version: number, offset: number, found: boolean }
 
 /**
  * edit：把 startLine..endLine 这几行整行替换成 text（扩展端给每行补回原来的缩进）
  * visibleLine：预览视口顶部那块的起始行，切回文本编辑器时把这行放到顶部
+ * probeDefinition：按住 ⌘ / Ctrl 悬停到带下标的名字上，问源码 offset 处有没有定义；version 是这份下标所属的文档版本
+ * goToDefinition：⌘ / Ctrl + 点击，跳到 offset 处名字的定义
  */
 export type WebviewToExtension
   = | { type: 'ready' }
     | { type: 'edit', startLine: number, endLine: number, text: string }
     | { type: 'selectTranslator', id: string }
     | { type: 'visibleLine', line: number }
+    | { type: 'probeDefinition', version: number, offset: number }
+    | { type: 'goToDefinition', version: number, offset: number }