✨ feat(vscode): FastAPI 接口卡片的调用树带上前端调用它的地方

vscode/src/codeReader/blockView.ts

@@ -1,5 +1,5 @@
 import type { Tree } from '@vscode/tree-sitter-wasm'
-import type { BlockAttributes, BlockConcept, BlockKind, CodeBlock, DisplayName, EmbeddedCode, EmbeddedReading, Inline, KindBadge, LanguageAdapter, LibraryRule, LocalSymbol, Markdown, Node, PreviewTable, PreviewText, PropertyRow, RuleCard, RuleContext, Segment, SourceDocument, SourceRange, SourceSpan, StepBlocks, TextBlock, TokenRole, Translator } from './contract'
+import type { BlockAttributes, BlockConcept, BlockKind, CodeBlock, DisplayName, EmbeddedCode, EmbeddedReading, HttpEndpoint, Inline, KindBadge, LanguageAdapter, LibraryRule, LocalSymbol, Markdown, Node, PreviewTable, PreviewText, PropertyRow, RuleCard, RuleContext, Segment, SourceDocument, SourceRange, SourceSpan, StepBlocks, TextBlock, TokenRole, Translator } from './contract'
 import type { TreeSitterRuntime } from './runtime'
 import type { ImportedName } from './symbolLinks'
 import { blockAttributes } from './attributes'
@@ -44,9 +44,16 @@ interface BlockViewBase {
   badge?: KindBadge
   /** 库规则挂在父卡片子行上的子块才有（见 RuleSlot）：展开时画在父卡片属性表第 row 行下面，不排在父卡片的子块里。 */
   slot?: BlockSlot
+  /** 能看调用树的块才有（见 CallTreeTarget）：页面按它摆调用树按钮，宿主按它数棵数、查调用者。 */
+  callTree?: CallTreeTarget
   children: BlockView[]
 }
 
+/** 一块能看调用树：有名字的函数、类是 `{}`；讲 HTTP 接口的库规则卡片带上接口（RuleCard.endpoint），调用者里另外并上前端发这个请求的地方。 */
+export interface CallTreeTarget {
+  endpoint?: HttpEndpoint
+}
+
 /** 子块挂在父卡片的哪儿：属性表第 row 行的第 item 个子行，点那个子行的第一格才在这一行下面展开（见 RuleSlot）。 */
 export interface BlockSlot {
   row: number
@@ -434,6 +441,7 @@ export function toBlockViews(
         ...sourceRows(span),
         headerEndLine: block.header.endRow,
         ...(name && { defines: { startIndex: name.startIndex, endIndex: name.endIndex } }),
+        ...(name && (block.kind === 'function' || block.kind === 'class') && { callTree: {} }),
         attributes: blockAttributes(block),
         concepts: blockConcepts(block),
         ...commentTarget(block),
@@ -460,7 +468,7 @@ export function toBlockViews(
         const { attributes, comments } = block
         return plain({ ...replacement.as, node: block.node, header: statement, children: kept, ...(attributes && { attributes }), ...(comments && { comments }) }, span, id, scope)
       }
-      const { kind, badge, rows, defines, attributes } = replacement
+      const { kind, badge, rows, defines, attributes, endpoint } = replacement
       const slots = new Map((replacement.slots ?? []).map(({ block: child, row, item }): [CodeBlock, BlockSlot] => [child, { row, item }]))
       const { anchor, inner } = anchors.place(scope, kind, defines && source.slice(defines.startIndex, defines.endIndex), rowsText(statement))
       return {
@@ -470,6 +478,7 @@ export function toBlockViews(
         ...sourceRows(span),
         headerEndLine: statement.endRow,
         ...(defines && { defines: { startIndex: defines.startIndex, endIndex: defines.endIndex } }),
+        ...(defines && endpoint && { callTree: { endpoint } }),
         attributes: { ...blockAttributes(block), ...attributes, kind },
         concepts: blockConcepts(block, replacement),
         ...commentTarget(block),