feat: title in annotations (#403)

Author: martin-tichovsky-s2

test/programs/annotation-title/main.ts

@@ -0,0 +1,15 @@
+/**
+ * @title filled#
+ */
+interface MySubObject {
+    a: boolean;
+}
+
+interface MyObject {
+    /**
+     * @title empty#
+     */
+    empty;
+
+    filled: MySubObject;
+}

test/programs/annotation-title/schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "MySubObject": {
+      "title": "filled#",
+      "type": "object",
+      "properties": {
+        "a": { "type": "boolean" }
+      },
+      "required": ["a"]
+    }
+  },
+  "properties": {
+    "empty": {
+      "title": "empty#"
+    },
+    "filled": {
+      "$ref": "#/definitions/MySubObject"
+    }
+  },
+  "required": ["empty", "filled"],
+  "type": "object"
+}

test/schema.test.ts

@@ -259,19 +259,15 @@ describe("schema", () => {
     describe("annotations", () => {
         assertSchema("annotation-default", "MyObject");
         assertSchema("annotation-ref", "MyObject", {}, undefined, undefined, {
-            skipCompile: true
+            skipCompile: true,
         });
         assertSchema("annotation-tjs", "MyObject", {
             validationKeywords: ["hide"],
         });
         assertSchema("annotation-id", "MyObject", {}, undefined, undefined, {
-            expectedWarnings: [
-                "schema id ignored",
-                "schema id ignored",
-                "schema id ignored",
-                "schema id ignored"
-            ]
+            expectedWarnings: ["schema id ignored", "schema id ignored", "schema id ignored", "schema id ignored"],
         });
+        assertSchema("annotation-title", "MyObject");
         assertSchema("annotation-items", "MyObject");
 
         assertSchema("typeof-keyword", "MyObject", { typeOfKeyword: true });
@@ -461,6 +457,6 @@ describe("tsconfig.json", () => {
 
 describe("Functionality 'required' in annotation", () => {
     assertSchema("annotation-required", "MyObject", {
-        tsNodeRegister: true
+        tsNodeRegister: true,
     });
 });

typescript-json-schema.ts

@@ -416,7 +416,8 @@ const validationKeywords = {
     format: true,
     default: true,
     $ref: true,
-    id: true
+    id: true,
+    title: true
 };
 
 /**