Update TypeScript to 1.8.10 (TypeStrong#204)

Author: spartan563

UPDATING.md

@@ -0,0 +1,55 @@
+
+## Updating
+TypeDoc makes use of internal API methods from the TypeScript compiler - as such you will need
+to recompile it for each and every different TypeScript compiler release. If your project doesn't
+rely on features from the latest TypeScript compiler, you may be able to get away with using
+version of TypeDoc which doesn't target it.
+
+If, however, you need the latest version and one hasn't yet been published then these are the steps
+you should follow to build your own.
+
+```bash
+# Checkout a copy of TypeDoc if you don't have one already
+git clone https://github.com/TypeStrong/typedoc typedoc
+cd typedoc
+
+# Change the version of TypeScript used by the project
+editor package.json
+
+npm install -g grunt-cli # install grunt's CLI globally if you don't have it
+npm install # install TypeDoc's dependencies
+
+# Checkout the version of TypeScript you are targetting
+git clone https://github.com/Microsoft/TypeScript typescript
+cd typescript
+git checkout v1.8.10 # checkout the correct version (as set in package.json)
+npm install -g jake # install the jake build tool globally if you don't have it
+npm install # install TypeScript's build dependencies
+jake local # build TypeScript
+cd ../
+
+# Setup TypeDoc for your TypeScript version
+grunt ts:typescript # compile the internal-API typescript definition files
+grunt string-replace:typescript # format the internal-API typescript files
+
+# Build and run the automated TypeDoc tests
+grunt build_and_test 
+
+# Do a visual inspection to make sure that modules were generated correctly
+ls test/render/specs/modules
+```
+
+Once this has been done, you should have a functional version of TypeDoc for
+your version of TypeScript. If you're so inclined, please open a Pull Request
+with your updated project so that others may benefit from the update.
+
+To make use of your version of TypeDoc in a project, point your `package.json`
+file at it using your GitHub project path.
+
+```json
+{
+    "dependencies": {
+        "typedoc": "mygithubuser/typedoc#v1.8.10"
+    }
+}
+```

index.js

@@ -1,3 +1,4 @@
+"use strict";
 var application_1 = require("./lib/application");
 exports.Application = application_1.Application;
 var cli_1 = require("./lib/cli");

lib/application.js

@@ -1,3 +1,4 @@
+"use strict";
 var __extends = (this && this.__extends) || function (d, b) {
     for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];
     function __() { this.constructor = d; }
@@ -170,5 +171,5 @@ var Application = (function (_super) {
         component_1.Component({ name: "application", internal: true })
     ], Application);
     return Application;
-})(component_1.ChildableComponent);
+}(component_1.ChildableComponent));
 exports.Application = Application;

lib/cli.js

@@ -1,3 +1,4 @@
+"use strict";
 var __extends = (this && this.__extends) || function (d, b) {
     for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];
     function __() { this.constructor = d; }
@@ -103,5 +104,5 @@ var CliApplication = (function (_super) {
         })
     ], CliApplication.prototype, "help", void 0);
     return CliApplication;
-})(application_1.Application);
+}(application_1.Application));
 exports.CliApplication = CliApplication;

lib/converter/components.js

@@ -1,3 +1,4 @@
+"use strict";
 var __extends = (this && this.__extends) || function (d, b) {
     for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];
     function __() { this.constructor = d; }
@@ -11,15 +12,15 @@ var ConverterComponent = (function (_super) {
         _super.apply(this, arguments);
     }
     return ConverterComponent;
-})(component_1.AbstractComponent);
+}(component_1.AbstractComponent));
 exports.ConverterComponent = ConverterComponent;
 var ConverterNodeComponent = (function (_super) {
     __extends(ConverterNodeComponent, _super);
     function ConverterNodeComponent() {
         _super.apply(this, arguments);
     }
     return ConverterNodeComponent;
-})(ConverterComponent);
+}(ConverterComponent));
 exports.ConverterNodeComponent = ConverterNodeComponent;
 var ConverterTypeComponent = (function (_super) {
     __extends(ConverterTypeComponent, _super);
@@ -28,5 +29,5 @@ var ConverterTypeComponent = (function (_super) {
         this.priority = 0;
     }
     return ConverterTypeComponent;
-})(ConverterComponent);
+}(ConverterComponent));
 exports.ConverterTypeComponent = ConverterTypeComponent;

lib/converter/context.js

@@ -1,3 +1,4 @@
+"use strict";
 var ts = require("typescript");
 var minimatch_1 = require("minimatch");
 var index_1 = require("../models/index");
@@ -167,5 +168,5 @@ var Context = (function () {
         return typeParameters;
     };
     return Context;
-})();
+}());
 exports.Context = Context;

lib/converter/convert-expression.js

@@ -1,3 +1,4 @@
+"use strict";
 var ts = require("typescript");
 function convertDefaultValue(node) {
     if (node.initializer) {

lib/converter/converter.js

@@ -1,3 +1,4 @@
+"use strict";
 var __extends = (this && this.__extends) || function (d, b) {
     for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];
     function __() { this.constructor = d; }
@@ -65,8 +66,8 @@ var Converter = (function (_super) {
     Converter.prototype.removeNodeConverter = function (converter) {
         var converters = this.nodeConverters;
         var keys = _.keys(this.nodeConverters);
-        for (var _i = 0; _i < keys.length; _i++) {
-            var key = keys[_i];
+        for (var _i = 0, keys_1 = keys; _i < keys_1.length; _i++) {
+            var key = keys_1[_i];
             if (converters[key] === converter) {
                 delete converters[key];
             }
@@ -143,19 +144,19 @@ var Converter = (function (_super) {
         program.getSourceFiles().forEach(function (sourceFile) {
             _this.convertNode(context, sourceFile);
         });
-        var diagnostics = program.getSyntacticDiagnostics();
-        if (diagnostics.length === 0) {
-            diagnostics = program.getGlobalDiagnostics();
-            if (diagnostics.length === 0) {
-                return program.getSemanticDiagnostics();
-            }
-            else {
-                return diagnostics;
-            }
-        }
-        else {
+        var diagnostics = program.getOptionsDiagnostics();
+        if (diagnostics.length)
             return diagnostics;
-        }
+        diagnostics = program.getSyntacticDiagnostics();
+        if (diagnostics.length)
+            return diagnostics;
+        diagnostics = program.getGlobalDiagnostics();
+        if (diagnostics.length)
+            return diagnostics;
+        diagnostics = program.getSemanticDiagnostics();
+        if (diagnostics.length)
+            return diagnostics;
+        return [];
     };
     Converter.prototype.resolve = function (context) {
         this.trigger(Converter.EVENT_RESOLVE_BEGIN, context);
@@ -169,8 +170,7 @@ var Converter = (function (_super) {
         return project;
     };
     Converter.prototype.getDefaultLib = function () {
-        var target = this.application.options.getCompilerOptions().target;
-        return target == 2 ? 'lib.es6.d.ts' : 'lib.d.ts';
+        return ts.getDefaultLibFileName(this.application.options.getCompilerOptions());
     };
     Converter.EVENT_BEGIN = 'begin';
     Converter.EVENT_END = 'end';
@@ -220,5 +220,5 @@ var Converter = (function (_super) {
         component_1.Component({ name: "converter", internal: true, childClass: components_1.ConverterComponent })
     ], Converter);
     return Converter;
-})(component_1.ChildableComponent);
+}(component_1.ChildableComponent));
 exports.Converter = Converter;

lib/converter/factories/comment.js

@@ -1,3 +1,4 @@
+"use strict";
 var ts = require("typescript");
 var index_1 = require("../../models/comments/index");
 function createComment(node) {
@@ -9,7 +10,7 @@ function createComment(node) {
 }
 exports.createComment = createComment;
 function isTopmostModuleDeclaration(node) {
-    if (node.nextContainer && node.nextContainer.kind == 218) {
+    if (node.nextContainer && node.nextContainer.kind == 221) {
         var next = node.nextContainer;
         if (node.name.end + 1 == next.name.pos) {
             return false;
@@ -18,7 +19,7 @@ function isTopmostModuleDeclaration(node) {
     return true;
 }
 function getRootModuleDeclaration(node) {
-    while (node.parent && node.parent.kind == 218) {
+    while (node.parent && node.parent.kind == 221) {
         var parent_1 = node.parent;
         if (node.name.pos == parent_1.name.end + 1) {
             node = parent_1;
@@ -30,10 +31,10 @@ function getRootModuleDeclaration(node) {
     return node;
 }
 function getRawComment(node) {
-    if (node.parent && node.parent.kind === 212) {
+    if (node.parent && node.parent.kind === 215) {
         node = node.parent.parent;
     }
-    else if (node.kind === 218) {
+    else if (node.kind === 221) {
         if (!isTopmostModuleDeclaration(node)) {
             return null;
         }
@@ -45,7 +46,7 @@ function getRawComment(node) {
     var comments = ts.getJsDocComments(node, sourceFile);
     if (comments && comments.length) {
         var comment;
-        if (node.kind == 248) {
+        if (node.kind == 251) {
             if (comments.length == 1)
                 return null;
             comment = comments[0];

lib/converter/factories/declaration.js

@@ -1,3 +1,4 @@
+"use strict";
 var ts = require("typescript");
 var index_1 = require("../../models/index");
 var converter_1 = require("../converter");
@@ -33,28 +34,28 @@ function createDeclaration(context, node, kind, name) {
     if (kind == index_1.ReflectionKind.ExternalModule) {
         isExported = true;
     }
-    else if (node.parent && node.parent.kind == 212) {
-        isExported = isExported || !!(node.parent.parent.flags & 1);
+    else if (node.parent && node.parent.kind == 215) {
+        isExported = isExported || !!(node.parent.parent.flags & 2);
     }
     else {
-        isExported = isExported || !!(node.flags & 1);
+        isExported = isExported || !!(node.flags & 2);
     }
     if (!isExported && context.converter.excludeNotExported) {
         return null;
     }
-    var isPrivate = !!(node.flags & 32);
+    var isPrivate = !!(node.flags & 16);
     if (context.isInherit && isPrivate) {
         return null;
     }
     var isConstructorProperty = false;
     var isStatic = false;
     if (nonStaticKinds.indexOf(kind) == -1) {
-        isStatic = !!(node.flags & 128);
+        isStatic = !!(node.flags & 64);
         if (container.kind == index_1.ReflectionKind.Class) {
-            if (node.parent && node.parent.kind == 144) {
+            if (node.parent && node.parent.kind == 145) {
                 isConstructorProperty = true;
             }
-            else if (!node.parent || node.parent.kind != 214) {
+            else if (!node.parent || node.parent.kind != 217) {
                 isStatic = true;
             }
         }
@@ -88,8 +89,8 @@ function createDeclaration(context, node, kind, name) {
 exports.createDeclaration = createDeclaration;
 function setupDeclaration(context, reflection, node) {
     reflection.setFlag(index_1.ReflectionFlag.External, context.isExternal);
-    reflection.setFlag(index_1.ReflectionFlag.Protected, !!(node.flags & 64));
-    reflection.setFlag(index_1.ReflectionFlag.Public, !!(node.flags & 16));
+    reflection.setFlag(index_1.ReflectionFlag.Protected, !!(node.flags & 32));
+    reflection.setFlag(index_1.ReflectionFlag.Public, !!(node.flags & 8));
     reflection.setFlag(index_1.ReflectionFlag.Optional, !!(node['questionToken']));
     if (context.isInherit &&
         (node.parent == context.inheritParent || reflection.flags.isConstructorProperty)) {

lib/converter/factories/index.js

@@ -1,3 +1,4 @@
+"use strict";
 var comment_1 = require('./comment');
 exports.createComment = comment_1.createComment;
 var declaration_1 = require('./declaration');

lib/converter/factories/parameter.js

@@ -1,3 +1,4 @@
+"use strict";
 var ts = require("typescript");
 var index_1 = require("../../models/reflections/index");
 var converter_1 = require("../converter");

lib/converter/factories/reference.js

@@ -1,3 +1,4 @@
+"use strict";
 var index_1 = require("../../models/types/index");
 function createReferenceType(context, symbol, includeParent) {
     var checker = context.checker;

lib/converter/factories/signature.js

@@ -1,3 +1,4 @@
+"use strict";
 var ts = require("typescript");
 var index_1 = require("../../models/index");
 var converter_1 = require("../converter");
@@ -25,7 +26,7 @@ function createSignature(context, node, name, kind) {
 exports.createSignature = createSignature;
 function extractSignatureType(context, node) {
     var checker = context.checker;
-    if (node.kind & 147 || node.kind & 168) {
+    if (node.kind & 148 || node.kind & 171) {
         try {
             var signature = checker.getSignatureFromDeclaration(node);
             return context.converter.convertType(context, node.type, checker.getReturnTypeOfSignature(signature));

lib/converter/factories/type-parameter.js

@@ -1,3 +1,4 @@
+"use strict";
 var index_1 = require("../../models/index");
 var converter_1 = require("../converter");
 function createTypeParameter(context, node) {

lib/converter/index.js

@@ -1,3 +1,4 @@
+"use strict";
 var context_1 = require("./context");
 exports.Context = context_1.Context;
 var converter_1 = require("./converter");

lib/converter/nodes/accessor.js

@@ -1,3 +1,4 @@
+"use strict";
 var __extends = (this && this.__extends) || function (d, b) {
     for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];
     function __() { this.constructor = d; }
@@ -18,14 +19,14 @@ var AccessorConverter = (function (_super) {
     function AccessorConverter() {
         _super.apply(this, arguments);
         this.supports = [
-            145,
-            146
+            146,
+            147
         ];
     }
     AccessorConverter.prototype.convert = function (context, node) {
         var accessor = index_2.createDeclaration(context, node, index_1.ReflectionKind.Accessor);
         context.withScope(accessor, function () {
-            if (node.kind == 145) {
+            if (node.kind == 146) {
                 accessor.getSignature = index_2.createSignature(context, node, '__get', index_1.ReflectionKind.GetSignature);
             }
             else {
@@ -38,5 +39,5 @@ var AccessorConverter = (function (_super) {
         components_1.Component({ name: 'node:accessor' })
     ], AccessorConverter);
     return AccessorConverter;
-})(components_1.ConverterNodeComponent);
+}(components_1.ConverterNodeComponent));
 exports.AccessorConverter = AccessorConverter;

lib/converter/nodes/alias.js

@@ -1,3 +1,4 @@
+"use strict";
 var __extends = (this && this.__extends) || function (d, b) {
     for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];
     function __() { this.constructor = d; }
@@ -18,7 +19,7 @@ var AliasConverter = (function (_super) {
     function AliasConverter() {
         _super.apply(this, arguments);
         this.supports = [
-            216
+            219
         ];
     }
     AliasConverter.prototype.convert = function (context, node) {
@@ -33,5 +34,5 @@ var AliasConverter = (function (_super) {
         components_1.Component({ name: 'node:alias' })
     ], AliasConverter);
     return AliasConverter;
-})(components_1.ConverterNodeComponent);
+}(components_1.ConverterNodeComponent));
 exports.AliasConverter = AliasConverter;