✨ feat(vscode): 代码阅读类块改成属性表并默认折叠，类的说明进「说明」行

vscode/src/codeReader/contract.ts

@@ -42,6 +42,33 @@ export interface FunctionFacts {
   returnType?: Node
 }
 
+/**
+ * 父类的一项：TypeScript `extends Base<T>` 里的 Base（一个表达式）和跟在它后面的泛型实参 `<T>`（语法里是两个节点）；
+ * Python 类参数列表里的一项，`metaclass=ABCMeta` 这类关键字参数、`*bases` 也算。
+ */
+export interface BaseFacts {
+  value: Node
+  typeArguments?: Node
+}
+
+export interface ClassFacts {
+  /** 匿名类（`export default class {}`）没有；赋给变量、类字段的类表达式取变量名、字段名。 */
+  name?: Node
+  /** 类自己的说明，同 FunctionFacts.doc：TypeScript 是紧贴在前面的 JSDoc，Python 是主体开头的 docstring。 */
+  doc?: Node
+  /** 同函数：嵌套在函数体、条件等语句块里的类没有。 */
+  access?: Access
+  /** 抽象类（TypeScript 的 `abstract class`）；没有这个概念的语言不填。 */
+  abstract?: boolean
+  decorators: Node[]
+  /** 泛型参数，每个参数一项（TypeScript `<T extends X = Y>` 里的 `T extends X = Y`）。 */
+  typeParameters: Node[]
+  /** 按源码顺序。 */
+  bases: BaseFacts[]
+  /** 实现的接口（TypeScript 的 `implements A, B<T>`），每个接口一项。 */
+  implements: Node[]
+}
+
 /** 导入的一项。 */
 export type ImportItem
   = | { kind: 'named', name: Node, alias?: Node } // import { a as b }、from m import a as b
@@ -77,7 +104,7 @@ export interface BlockShape {
   node: Node
   /**
    * 块自己显示 / 编辑的那一段：复合语句只到主体开始之前，其余是整条语句。
-   * 函数的说明（FunctionFacts.doc）也算在里面：JSDoc 往上延到注释开头，docstring 往下延到字符串结尾。
+   * 函数、类的说明（facts.doc）也算在里面：JSDoc 往上延到注释开头，docstring 往下延到字符串结尾。
    */
   header: SourceSpan
   children: CodeBlock[]
@@ -85,9 +112,13 @@ export interface BlockShape {
 
 /** 预览成属性表的块：语言插件从语法树读出结构化信息（facts），翻译插件把它排成属性表。 */
 export interface FunctionBlock extends BlockShape { kind: 'function', facts: FunctionFacts }
+export interface ClassBlock extends BlockShape { kind: 'class', facts: ClassFacts }
 export interface ImportBlock extends BlockShape { kind: 'import', facts: ImportFacts }
 export interface VariableBlock extends BlockShape { kind: 'const' | 'variable', facts: VariableFacts }
-export type FactBlock = FunctionBlock | ImportBlock | VariableBlock
+export type FactBlock = FunctionBlock | ClassBlock | ImportBlock | VariableBlock
+
+/** 带说明（facts.doc）的块。 */
+export type DocumentedBlock = FunctionBlock | ClassBlock
 
 export type TextKind = Exclude<BlockKind, FactBlock['kind']>
 
@@ -116,12 +147,12 @@ export interface Segment { text: string, role: TokenRole, offset?: number }
  */
 export interface Markdown { markdown: string }
 
-/** 预览里显示的一段文字：着色的词（一行译文、属性值），或整段 Markdown 说明（注释块、函数的说明）。 */
+/** 预览里显示的一段文字：着色的词（一行译文、属性值），或整段 Markdown 说明（注释块、函数和类的说明）。 */
 export type PreviewText = Segment[] | Markdown
 
 /**
  * 属性表里的一行或一个子行讲的是哪个定义：定义出来的那个名字的节点（取自 facts，例如参数名、导入项的名称和别名、
- * 声明的变量名）在源码里的范围。跳到定义时，定义处落在这个范围里就只闪这一行；不填（第三方翻译插件可以不填）就闪整块。
+ * 声明的变量名、类的泛型参数）在源码里的范围。跳到定义时，定义处落在这个范围里就只闪这一行；不填（第三方翻译插件可以不填）就闪整块。
  */
 export interface Defines { defines?: SourceRange }
 
@@ -154,7 +185,7 @@ export interface Translator {
   languageIds: string[]
   /** 只翻 header 那一段；注释块给去掉注释符号的 Markdown 原文。 */
   translate: (block: TextBlock, source: string) => PreviewText
-  /** 函数、导入、常量、变量块 → 属性表。 */
+  /** 函数、类、导入、常量、变量块 → 属性表。 */
   describe: (block: FactBlock, source: string) => PropertyRow[]
 }