feat: add interface dependencies

Author: daybrush

lib/jsdoc/augment.js

@@ -17,7 +17,7 @@ function mapDependencies(index, propertyName) {
     var dependencies = {};
     var doc;
     var doclets;
-    var kinds = ['class', 'external', 'interface', 'mixin'];
+    var kinds = ['class', 'external', 'interface', 'mixin', 'typedef'];
     var len = 0;
 
     Object.keys(index).forEach(function(indexName) {
@@ -227,6 +227,37 @@ function getInheritedAdditions(doclets, docs, index) {
     // doclets will be undefined if the inherited symbol isn't documented
     doclets = doclets || [];
 
+    // typedef
+    doclets.filter(function(doclet) {
+        parents = doclet.augments;
+
+        if (doclet.kind !== 'typedef' || !parents || !parents.length) {
+            return false;
+        }
+
+        return true;
+    }).forEach(function(doclet) {
+        parents = doclet.augments;
+
+        parents.forEach(function(p) {
+            if (p.indexOf('$ts:') === 0) {
+                p = p.replace('$ts:', '');
+                var match = p.match(/^[a-zA-Z0-9]{2,}/);
+
+                if (match) {
+                    p = match[0];
+                }
+            }
+
+            var documented = docs.index.documented;
+            var parentDoc = documented[p] && documented[p][0];
+
+            if (!parentDoc || !parentDoc.properties || !parentDoc.properties.length) {
+                return;
+            }
+            doclet.properties = parentDoc.properties.concat(doclet.properties);
+        });
+    });
     for (var i = 0, ii = doclets.length; i < ii; i++) {
         doc = doclets[i];
         parents = doc.augments;

lib/jsdoc/doclet.js

@@ -393,6 +393,13 @@ Doclet.prototype.postTypedef = function() {
     var interfaceInfo = TypeScriptParser.find('TSInterfaceDeclaration', this.meta.code.node);
 
     if (interfaceInfo) {
+        var superInterfaces = interfaceInfo.extends || [];
+
+        if ((!this.augments || !this.augments.length)) {
+            this.augments = superInterfaces.map(function(superInterface) {
+                return superInterface.typeId(self.filename);
+            });
+        }
         if (interfaceInfo.typeParameters.string) {
             this.typeParameters = interfaceInfo.typeParameters;
         }

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@daybrush/jsdoc",
-  "version": "0.3.6",
+  "version": "0.3.7-rc3",
   "description": "An API documentation generator for JavaScript and Typescript.",
   "keywords": [
     "documentation",
@@ -20,7 +20,7 @@
     "@babel/parser": "^7.2.3",
     "@babel/types": "^7.2.2",
     "@daybrush/utils": "^0.4.0",
-    "ast-parser": "^0.0.1",
+    "ast-parser": "^0.0.3",
     "bluebird": "~3.5.0",
     "catharsis": "~0.8.9",
     "escape-string-regexp": "~1.0.5",