jsdoc - added namealias

The namealias plugin gets jsdoc to detect lots of documentation it was not
correctly picking up due to the application of the `name` property. This
can be read about in
jsdoc/jsdoc#804 (comment) - this results
in _much_ more complete documentation generation, especially when
properties are defined in constructors.

Author: pnstickne

tasks/jsdoc-conf.json

@@ -29,7 +29,8 @@
         "includePattern": ".+\\.js(doc)?$",
         "excludePattern": "(^|\\/|\\\\)_"
     },
-    "plugins"   : [
+    "plugins": [
+        "./tasks/jsdoc-plugins/namealias",
         "./tasks/jsdoc-plugins/filterpixi",
         "./tasks/jsdoc-plugins/proptomember",
         "./tasks/jsdoc-plugins/sourceproxy",

tasks/jsdoc-plugins/namealias.js

@@ -0,0 +1,29 @@
+/**
+* When JSdoc encounters names it disables the automatic code inspection ability;
+* this is especially problematic for cases like
+*
+* > @class MyClass
+* > @constructor
+*
+* because the properties without an explicit @memberof or fullname are not being included in
+* in the newer JSDoc output.
+*
+* This is a simple plugin, as discussed https://github.com/jsdoc3/jsdoc/issues/804#event-195287680
+* to rewrite the @class [@constructor] to @alias @class which enables JSDoc to collect better data.
+*/
+
+exports.handlers = {};
+exports.handlers.jsdocCommentFound = function (e) {
+
+    var raw = e.comment;
+
+    if (/^(\s*[*])\s*@class\b/m.exec(raw))
+    {
+        // @class X / @constructor -> @alias X / @class
+        raw = raw.replace(/^(\s*[*])\s*@class\s+(\S+).*?$/mg, "$1 @alias $2\n$1 @class");
+        raw = raw.replace(/^(\s*[*])\s*@constructor\b.*?$/mg, "$1");
+
+        e.comment = raw;
+    }
+
+};