✨ feat(vscode): 代码阅读契约加命令规则（按命令名注册、读一条命令）、按位置的参数 / 输出 / 返回、解释器和选项块、分情况 / 命令 / 管道种类、常量色；模板引擎加节点读法；没有定义、高亮提供者的语言用语言插件认的同一文件里的名字跳转、高亮

vscode/src/codeReader/editor/documentMessage.ts

@@ -1,9 +1,10 @@
-import type { DisplayName, RuleContext, SourceDocument } from '../contract'
+import type { DisplayName, LocalSymbol, RuleContext, SourceDocument } from '../contract'
 import type { CodeReaderRegistry } from '../registry'
 import type { TreeSitterRuntime } from '../runtime'
 import type { DocumentMessage } from './messages'
 import { fileAttributes, mergeAttributeNames } from '../attributes'
 import { readBlockViews } from '../blockView'
+import { commandRuleLookup } from '../commandRules'
 import { ruleAttributeNames } from '../libraryRules'
 
 /** 生成预览数据要读的那点文档信息（TextDocument 的子集）。 */
@@ -13,10 +14,11 @@ export interface DocumentSnapshot {
   getText: () => string
 }
 
-/** 发给预览的文档，和这份源码里起了中文名的定义（扩展端接着找用到它们的各处）。 */
+/** 发给预览的文档，和这份源码里起了中文名的定义（扩展端接着找用到它们的各处）、语言插件自己认得出的名字（LocalSymbol）。 */
 export interface DocumentRead {
   message: DocumentMessage
   displayNames: DisplayName[]
+  symbols: LocalSymbol[]
 }
 
 /**
@@ -26,7 +28,7 @@ export interface DocumentRead {
  */
 export async function documentMessage(
   document: DocumentSnapshot,
-  registry: Pick<CodeReaderRegistry, 'languageFor' | 'translatorsFor' | 'selectedTranslator' | 'rulesFor'>,
+  registry: Pick<CodeReaderRegistry, 'languageFor' | 'translatorsFor' | 'selectedTranslator' | 'rulesFor' | 'commandRulesFor'>,
   runtime: Pick<TreeSitterRuntime, 'parse'>,
   report: (message: string) => void,
   lookup?: RuleContext['lookup'],
@@ -47,14 +49,18 @@ export async function documentMessage(
   }
   const adapter = registry.languageFor(languageId)
   if (!adapter)
-    return { message: { ...message, error: `代码阅读还不支持「${languageId}」这种语言` }, displayNames: [] }
+    return { message: { ...message, error: `代码阅读还不支持「${languageId}」这种语言` }, displayNames: [], symbols: [] }
   try {
     const rules = registry.rulesFor(languageId)
-    const { blocks, displayNames } = await readBlockViews(runtime, adapter, translator, languageId, source, { rules, report, lookup }, calleeKind)
+    const { blocks, displayNames, symbols } = await readBlockViews(runtime, adapter, translator, languageId, source, {
+      rules: { rules, report, lookup },
+      calleeKind,
+      commandRule: commandRuleLookup(registry.commandRulesFor(languageId), report),
+    })
     const names = mergeAttributeNames([translator?.attributeNames, ...ruleAttributeNames(rules, translator?.displayLanguage, report)])
-    return { message: { ...message, blocks, attributes: fileAttributes(blocks, names) }, displayNames }
+    return { message: { ...message, blocks, attributes: fileAttributes(blocks, names) }, displayNames, symbols }
   }
   catch (err) {
-    return { message: { ...message, error: err instanceof Error ? err.message : String(err) }, displayNames: [] }
+    return { message: { ...message, error: err instanceof Error ? err.message : String(err) }, displayNames: [], symbols: [] }
   }
 }