✨ feat(vscode): 代码阅读加枚举卡片，Python enum 库规则和 TypeScript enum 画成同一张表

vscode/src/codeReader/translators/zhTemplate.ts

@@ -1,4 +1,4 @@
-import type { Access, AttributeNames, BlockKind, ClassFacts, CommonAttribute, Defines, EntryFacts, FactBlock, FunctionFacts, ImportFacts, ImportItem, Inline, IterationClause, IterationFacts, IterationResult, LanguageAdapter, Markdown, Node, PreviewText, PropertyItem, PropertyRow, Segment, SegmentGroup, SourceDocument, SourceSpan, TextBlock, TokenRole, Translator, VariableBlock } from '../contract'
+import type { Access, AttributeNames, BaseFacts, BlockKind, ClassFacts, CommonAttribute, Defines, EntryFacts, EnumFacts, FactBlock, FunctionFacts, ImportFacts, ImportItem, Inline, IterationClause, IterationFacts, IterationResult, LanguageAdapter, Markdown, Node, PreviewText, PropertyItem, PropertyRow, Segment, SegmentGroup, SourceDocument, SourceSpan, TextBlock, TokenRole, Translator, VariableBlock } from '../contract'
 import { commonIndent, splitLines } from '../editText'
 
 /** 按所在语法节点区分译法的关键字，例如 Python 的 else：if 后「否则」，for / while 后「未中断时」。 */
@@ -136,6 +136,7 @@ const KIND_ZH: Record<BlockKind, string> = {
   import: '导入',
   function: '函数',
   class: '类',
+  enum: '枚举',
   type: '类型',
   field: '字段',
   const: '常量',
@@ -432,6 +433,8 @@ export function createZhTemplateTranslator(table: ZhTable): Translator {
         return functionRows(block.facts, phrases)
       case 'class':
         return classRows(block.facts, phrases)
+      case 'enum':
+        return enumRows(block.facts, phrases)
       case 'import':
         return importRows(block.facts, phrases)
       default:
@@ -611,11 +614,46 @@ function classRows(facts: ClassFacts, say: Phrases): PropertyRow[] {
     ...flagRows('abstract', facts.abstract),
     ...decoratorRows(facts.decorators, say),
     ...listRow('类型参数', facts.typeParameters.map(say.translated), defining(...facts.typeParameters)),
-    ...listRow('父类', facts.bases.map(base => base.typeArguments ? [...say.translated(base.value), ...say.translated(base.typeArguments)] : say.translated(base.value))),
+    ...listRow('父类', facts.bases.map(base => baseText(base, say))),
     ...listRow('实现的接口', facts.implements.map(say.translated)),
   ]
 }
 
+/** 父类的一项：TypeScript 的泛型实参紧跟在后面。 */
+function baseText(base: BaseFacts, say: Phrases): Inline[] {
+  return base.typeArguments ? [...say.translated(base.value), ...say.translated(base.typeArguments)] : say.translated(base.value)
+}
+
+/**
+ * 枚举（TypeScript 的 enum、Python enum 库的类，同一张表）：名称 / 说明 / 访问级别 / 装饰器 / 继承（照写的父类），有才显示；
+ * 成员收成一张表：成员 | 值 | 说明。没写值的成员写语言算出的值（自增的 0、1、2……），算不出来写「自动」，都按说明词着色；
+ * 说明是成员的注释、JSDoc、属性 docstring 的原文用空格连起来，一个成员都没有说明时不给这一列。
+ */
+function enumRows(facts: EnumFacts, say: Phrases): PropertyRow[] {
+  const docs = facts.members.map(member => member.docs.map(node => say.doc(node)?.markdown).filter(Boolean).join(' '))
+  const described = docs.some(Boolean)
+  return [
+    { label: '名称', value: say.name(facts.name, 'type') },
+    ...docRows(facts.doc, say),
+    ...accessRows(facts.access),
+    ...decoratorRows(facts.decorators, say),
+    ...(facts.bases.length > 0 ? [{ label: '继承', value: joined(facts.bases.map(base => baseText(base, say)), ', ') }] : []),
+    {
+      label: '成员',
+      value: count(facts.members.length),
+      columns: described ? ['成员', '值', '说明'] : ['成员', '值'],
+      items: facts.members.map((member, i) => ({
+        cells: [
+          say.name(member.name, 'variable'),
+          member.value ? say.translated(member.value) : [hint(member.computed === undefined ? '自动' : String(member.computed))],
+          ...(described ? [docs[i] ? [segment(docs[i], 'comment', undefined)] : []] : []),
+        ],
+        ...defining(member.name),
+      })),
+    },
+  ]
+}
+
 /** 函数、类、常量、变量的说明：有文字才有这一行。 */
 function docRows(doc: Node | undefined, say: Phrases): PropertyRow[] {
   const markdown = doc && say.doc(doc)