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

vscode/src/codeReader/blockView.ts

@@ -1,4 +1,4 @@
-import type { BlockAttributes, BlockKind, CodeBlock, DisplayName, KindBadge, LanguageAdapter, LibraryRule, Markdown, Node, PreviewTable, PreviewText, PropertyRow, RuleContext, Segment, SourceDocument, SourceRange, TextBlock, TokenRole, Translator } from './contract'
+import type { BlockAttributes, BlockKind, CodeBlock, DisplayName, KindBadge, LanguageAdapter, LibraryRule, LocalSymbol, Markdown, Node, PreviewTable, PreviewText, PropertyRow, RuleContext, Segment, SourceDocument, SourceRange, TextBlock, TokenRole, Translator } from './contract'
 import type { TreeSitterRuntime } from './runtime'
 import { blockAttributes } from './attributes'
 import { commonIndent, splitLines } from './editText'
@@ -212,31 +212,42 @@ export function toBlockViews(blocks: CodeBlock[], document: SourceDocument, tran
   return blocks.map((block, i) => build(block, String(i), ''))
 }
 
-/** 一份源码的视图数据，和它里面起了中文名的定义（预览找用到它们的各处要用，见 displayNames.ts）。 */
+/**
+ * 一份源码的视图数据，和它里面起了中文名的定义（预览找用到它们的各处要用，见 displayNames.ts）、
+ * 语言插件自己认得出的名字（LanguageAdapter.symbols，语言扩展查不到定义、各处出现时用）。
+ */
 export interface DocumentViews {
   blocks: BlockView[]
   displayNames: DisplayName[]
+  symbols: LocalSymbol[]
 }
 
 /**
- * 解析一份源码并转成视图数据（中文名记号交给翻译插件去掉）；语法树用完即释放。
- * calleeKind 交出调用的名字的定义眼下查到是哪种块（SourceDocument.calleeKind）。
+ * 排视图数据时宿主另外交给规则、翻译插件的：用哪些库规则（RuleRun），调用的名字眼下查到定义成哪种块（SourceDocument.calleeKind），
+ * 命令名的命令规则（SourceDocument.commandRule）。
  */
+export interface DocumentExtras {
+  rules?: RuleRun
+  calleeKind?: SourceDocument['calleeKind']
+  commandRule?: SourceDocument['commandRule']
+}
+
+/** 解析一份源码并转成视图数据（中文名记号交给翻译插件去掉）；语法树用完即释放。 */
 export async function readBlockViews(
   runtime: Pick<TreeSitterRuntime, 'parse'>,
   adapter: LanguageAdapter,
   translator: Translator | undefined,
   languageId: string,
   source: string,
-  rules: RuleRun = NO_RULES,
-  calleeKind?: SourceDocument['calleeKind'],
+  extras: DocumentExtras = {},
 ): Promise<DocumentViews> {
   const tree = await runtime.parse(adapter, languageId, source)
   try {
     const { names, markers } = adapter.displayNames?.find(tree.rootNode, source, languageId) ?? { names: [], markers: [] }
-    const document: SourceDocument = { source, language: adapter, markers, ...(calleeKind && { calleeKind }) }
-    const blocks = toBlockViews(adapter.toBlocks(tree.rootNode, source, languageId), document, translator, rules)
-    return { blocks, displayNames: names }
+    const { calleeKind, commandRule } = extras
+    const document: SourceDocument = { source, language: adapter, markers, ...(calleeKind && { calleeKind }), ...(commandRule && { commandRule }) }
+    const blocks = toBlockViews(adapter.toBlocks(tree.rootNode, source, languageId), document, translator, extras.rules)
+    return { blocks, displayNames: names, symbols: adapter.symbols?.(tree.rootNode, source, languageId) ?? [] }
   }
   finally {
     tree.delete()