Improve comment description formatting in JSDoc (#54)

Author: vearutop

composer.lock

@@ -288,7 +288,14 @@ private function makeObjectTypeDef(Schema $schema, $path)
 
     private function description(Schema $schema)
     {
-        $res = str_replace("\n", " ", $schema->title . $schema->description);
+        $res = str_replace("\n", " ", trim($schema->title));
+        if (trim($schema->description)) {
+            if ($res) {
+                $res .= ". ";
+            }
+
+            $res .= str_replace("\n", " ", trim($schema->description));
+        }
         if ($res) {
             return ' - ' . rtrim($res, '.') . '.';
         }

src/JSDoc/TypeBuilder.php

@@ -16,7 +16,7 @@ public function testJsonSchema()
         "Person": {
             "type": "object",
             "properties": {
-                "name": {"type": "string", "description": "Person name."},
+                "name": {"type": "string", "title":"     Name    ", "description": "The name of the person."},
                 "age": {"type": "integer"},
                 "isMale": {"type": "boolean"},
                 "partner": {"$ref": "#/definitions/Person"},
@@ -37,7 +37,7 @@ public function testJsonSchema()
 /**
  * @typedef Person
  * @type {Object}
- * @property {String} name - Person name.
+ * @property {String} name - Name. The name of the person.
  * @property {Number} age
  * @property {Boolean} isMale
  * @property {Person} partner