✨ feat(vscode): 代码阅读把字典、对象字面量的值展开成键值树

vscode/src/codeReader/languages/python.ts

@@ -1,4 +1,4 @@
-import type { Access, BlockShape, ClassFacts, CodeBlock, FunctionFacts, ImportFacts, ImportItem, LanguageAdapter, Node, ParameterFacts, TextKind, TokenRole } from '../contract'
+import type { Access, BlockShape, ClassFacts, CodeBlock, EntryFacts, FunctionFacts, ImportFacts, ImportItem, LanguageAdapter, Node, ParameterFacts, TextKind, TokenRole } from '../contract'
 import type { CommentRules } from './shared'
 import * as path from 'node:path'
 import { children, compoundShape, leafBlock, leafShape, listBlocks, named, sameNode, syntaxChildren } from './shared'
@@ -230,16 +230,34 @@ function expressionBlock(node: Node, scope: Scope, docstring: boolean): CodeBloc
   const type = expression.childForFieldName('type')
   if (scope === 'class' && type)
     return leafBlock('field', node)
+  const value = expression.childForFieldName('right')
   return {
     kind: scope === 'module' && isConstantTarget(left) ? 'const' : 'variable',
     ...leafShape(node),
     facts: {
       access: scopeAccess(left, scope),
-      declarators: [{ name: left, type: type ?? undefined, value: expression.childForFieldName('right') ?? undefined }],
+      declarators: [{ name: left, type: type ?? undefined, value: value ?? undefined, entries: dictionaryEntries(value) }],
     },
   }
 }
 
+/** 字典字面量的各项：`键: 值`（值又是字典时连它的各项）、`**other`；值不是字典字面量时没有。 */
+function dictionaryEntries(value: Node | null): EntryFacts[] | undefined {
+  if (value?.type !== 'dictionary')
+    return undefined
+  return syntaxChildren(value).flatMap((item): EntryFacts[] => {
+    if (item.type === 'dictionary_splat') {
+      const [spread] = syntaxChildren(item)
+      return spread ? [{ kind: 'spread', value: spread }] : []
+    }
+    const key = item.childForFieldName('key')
+    const itemValue = item.childForFieldName('value')
+    if (item.type !== 'pair' || !key || !itemValue)
+      return []
+    return [{ kind: 'pair', key, value: itemValue, entries: dictionaryEntries(itemValue) }]
+  })
+}
+
 /** elif / else 展平成紧跟 if 的兄弟块。 */
 function ifBlocks(node: Node): CodeBlock[] {
   const blocks = [bodyBlock('if', node, bodyOf(node), 'other')]