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

vscode/src/codeReader/blockView.test.ts

@@ -29,11 +29,13 @@ function byId(list: BlockView[], id: string): BlockView {
 const SAMPLES: [LanguageAdapter, string, Translator, string][] = [
   [ts, 'typescript', typescriptZhTranslator, 'envLock.ts.txt'],
   [ts, 'typescript', typescriptZhTranslator, 'issueLock.ts.txt'],
+  [ts, 'typescript', typescriptZhTranslator, 'classes.ts.txt'],
   [py, 'python', pythonZhTranslator, 'sample.py'],
   [py, 'python', pythonZhTranslator, 'routes.py'],
+  [py, 'python', pythonZhTranslator, 'classes.py'],
 ]
 
-const PROPERTY_KINDS = new Set(['function', 'import', 'const', 'variable'])
+const PROPERTY_KINDS = new Set(['function', 'class', 'import', 'const', 'variable'])
 
 function translationText(view: BlockView): string {
   if (!('translation' in view))
@@ -57,7 +59,7 @@ describe('blockView', () => {
     }
   })
 
-  it.each(SAMPLES)('%#: 函数、导入、常量、变量块只带属性表，其余块只带一行译文', async (adapter, languageId, translator, fixture) => {
+  it.each(SAMPLES)('%#: 函数、类、导入、常量、变量块只带属性表，其余块只带一行译文', async (adapter, languageId, translator, fixture) => {
     for (const view of flatten(await views(adapter, languageId, translator, readFixture(fixture)))) {
       expect('properties' in view, view.id).toBe(PROPERTY_KINDS.has(view.kind))
       expect('translation' in view, view.id).toBe(!PROPERTY_KINDS.has(view.kind))
@@ -100,6 +102,26 @@ describe('blockView', () => {
     expect(getUser?.children[0]).toMatchObject({ kind: 'comment', startLine: 38, endLine: 38 })
   })
 
+  it('类的说明同样算在类块的头部里：JSDoc 连着中间的装饰器，docstring 连着它前面的注释', async () => {
+    const repo = byId(await views(ts, 'typescript', typescriptZhTranslator, readFixture('classes.ts.txt')), '1')
+    expect(repo).toMatchObject({ kind: 'class', startLine: 2, endLine: 8 })
+    expect(repo.code.split('\n').slice(-3)).toEqual([
+      ' */',
+      '@Injectable()',
+      'export abstract class Repository<K, T extends Entity = Entity> extends Base<string> implements Loader<T>, Disposable {',
+    ])
+    expect('properties' in repo && repo.properties[1]).toEqual({ label: '说明', value: { markdown: '仓库基类。\n\n子类实现 `load`。' } })
+
+    const notFound = byId(await views(py, 'python', pythonZhTranslator, readFixture('classes.py')), '3')
+    expect(notFound).toMatchObject({ kind: 'class', startLine: 17, endLine: 19 })
+    expect(notFound.code.split('\n')).toEqual([
+      'class NotFound(AppException):  # 行尾',
+      '    # 说明前面的注释',
+      '    """找不到资源。"""',
+    ])
+    expect(notFound.children[0]).toMatchObject({ kind: 'variable', startLine: 20, endLine: 20 })
+  })
+
   it('注释块的译文、函数的「说明」是 Markdown 原文，webview 按它渲染', async () => {
     const env = await views(ts, 'typescript', typescriptZhTranslator, readFixture('envLock.ts.txt'))
     expect(byId(env, '0')).toMatchObject({ kind: 'comment', translation: { markdown: expect.stringMatching(/^\.env file lock \/ unlock helpers\.\n\nRecursively/) } })
@@ -157,13 +179,13 @@ describe('blockView', () => {
     expect(signature.filter(token => token.text === 'str')).toEqual([{ text: 'str', role: 'type' }, { text: 'str', role: 'type' }])
   })
 
-  it('块自己的名字（defines）：函数名、只声明一个变量时的变量名（解构模式整个算）；导入、一条语句几个变量、一行译文的块没有', async () => {
+  it('块自己的名字（defines）：函数名、类名（赋给变量的类表达式取变量名）、只声明一个变量时的变量名（解构模式整个算）；导入、一条语句几个变量、一行译文的块、匿名类没有', async () => {
     const own = (source: string, list: BlockView[]): Record<string, string | undefined> =>
       Object.fromEntries(list.map(view => [view.id, view.defines && source.slice(view.defines.startIndex, view.defines.endIndex)]))
-    const pySource = ['import os', 'def f(x): pass', 'a, b = 1, 2', 'for i in x: pass'].join('\n')
-    expect(own(pySource, await views(py, 'python', pythonZhTranslator, pySource))).toEqual({ 0: undefined, 1: 'f', 2: 'a, b', 3: undefined })
-    const tsSource = ['let i = 0, j', 'const { u, v } = o', 'export const h = () => 1'].join('\n')
-    expect(own(tsSource, await views(ts, 'typescript', typescriptZhTranslator, tsSource))).toEqual({ 0: undefined, 1: '{ u, v }', 2: 'h' })
+    const pySource = ['import os', 'def f(x): pass', 'a, b = 1, 2', 'for i in x: pass', 'class K: pass'].join('\n')
+    expect(own(pySource, await views(py, 'python', pythonZhTranslator, pySource))).toEqual({ 0: undefined, 1: 'f', 2: 'a, b', 3: undefined, 4: 'K' })
+    const tsSource = ['let i = 0, j', 'const { u, v } = o', 'export const h = () => 1', 'class A {}', 'const B = class C {}', 'export default class {}'].join('\n')
+    expect(own(tsSource, await views(ts, 'typescript', typescriptZhTranslator, tsSource))).toEqual({ 0: undefined, 1: '{ u, v }', 2: 'h', 3: 'A', 4: 'B', 5: undefined })
   })
 
   it('\\r\\n 和制表符缩进：code 用 \\n 连接，去掉共同的制表符', async () => {