fix: 优化生成注释顺序

FrontEndDev-org · Jul 15, 2024 · 694ac7f · 694ac7f
1 parent 6ad5541
commit 694ac7f
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 3 deletions.
diff --git a/src/printer/JsDoc.ts b/src/printer/JsDoc.ts
@@ -63,8 +63,8 @@ export class JsDoc {
     static fromSchema(schema: OpenApi3.SchemaObject) {
         const { deprecated, description, default: defaultValue, format, example, title, externalDocs } = schema;
         return {
-            description,
             summary: title,
+            description,
             deprecated,
             default: defaultValue,
             format,

diff --git a/test/printer/v31.test.ts b/test/printer/v31.test.ts
@@ -12,7 +12,8 @@ test('v3.1 schema', () => {
             schemas: {
                 Category: {
                     $id: 'my-id',
-                    description: 'Category',
+                    title: 'Category Title',
+                    description: 'Category Description',
                     properties: {
                         id: {
                             type: 'integer',
@@ -50,7 +51,8 @@ test('v3.1 schema', () => {
         }),
     ).toMatchInlineSnapshot(`
       "/**
-       * @description Category
+       * @summary Category Title
+       * @description Category Description
        */
       export type Category = {
       /**