feat: add title in comment (#75)

Author: Himenon

package.json

@@ -53,7 +53,7 @@
     "test:jest": "jest -c ./jest.config.js",
     "test:snapshot": "jest -c ./jest.snapshot.config.js",
     "ts": "ts-node -P tsconfig.build.json",
-    "update:snapshot": "pnpm test:snapshot --updateSnapshot",
+    "update:snapshot": "pnpm jest -c ./jest.snapshot.config.js --updateSnapshot",
     "watch": "pnpm ts ./scripts/watch.ts",
     "validate": "pnpm ts ./scripts/validate.ts"
   },
@@ -105,9 +105,6 @@
     "typescript": "4.2.3",
     "yarn-deduplicate": "3.1.0"
   },
-  "peerDependencies": {
-    "typescript": "4.2.3"
-  },
   "engines": {
     "pnpm": ">=6"
   },

src/internal/OpenApiTools/components/Schema.ts

@@ -27,7 +27,7 @@ export const generatePropertySignatures = (
       return factory.PropertySignature.create({
         name: convertContext.escapePropertySignatureName(propertyName),
         optional: !required.includes(propertyName),
-        comment: schema.description,
+        comment: [schema.title, schema.description].filter(v => !!v).join("\n\n"),
         type: factory.TypeNode.create({
           type: "any",
         }),
@@ -37,7 +37,7 @@ export const generatePropertySignatures = (
       name: convertContext.escapePropertySignatureName(propertyName),
       optional: !required.includes(propertyName),
       type: ToTypeNode.convert(entryPoint, currentPoint, factory, property, context, convertContext, { parent: schema }),
-      comment: typeof property !== "boolean" ? property.description : undefined,
+      comment: typeof property !== "boolean" ? [property.title, property.description].filter(v => !!v).join("\n\n") : undefined,
     });
   });
 };
@@ -86,7 +86,7 @@ export const generateArrayTypeAlias = (
   return factory.TypeAliasDeclaration.create({
     export: true,
     name: convertContext.escapeDeclarationText(name),
-    comment: schema.description,
+    comment: [schema.title, schema.description].filter(v => !!v).join("\n\n"),
     type: ToTypeNode.convert(entryPoint, currentPoint, factory, schema, context, convertContext),
   });
 };
@@ -119,7 +119,7 @@ export const generateNotInferedTypeAlias = (
     export: true,
     name: convertContext.escapeDeclarationText(name),
     type: typeNode,
-    comment: schema.description,
+    comment: [schema.title, schema.description].filter(v => !!v).join("\n\n"),
   });
 };
 
@@ -159,11 +159,12 @@ export const generateTypeAlias = (
       type: schema.type,
     });
   }
+
   return factory.TypeAliasDeclaration.create({
     export: true,
     name: convertContext.escapeDeclarationText(name),
     type,
-    comment: schema.description,
+    comment: [schema.title, schema.description].filter(v => !!v).join("\n\n"),
   });
 };