fix(Typings): Output public constructors in .d.ts files

Closes angular#3926.

Closes angular#3963

Author: jteplitz

docs/typescript-definition-package/index.js

@@ -52,11 +52,9 @@ module.exports = new Package('angular-v2-docs', [jsdocPackage, nunjucksPackage,
       id: 'angular2/angular2',
       references: ['../es6-promise/es6-promise.d.ts', '../rx/rx.d.ts'],
       modules: {
-        'angular2/angular2': {namespace: 'ng', id: 'angular2/angular2'}
-        /* TODO(jeffbcross): re-implement with @jteplitz as part of #3926,
+        'angular2/angular2': {namespace: 'ng', id: 'angular2/angular2'},
         'angular2/web_worker/worker': {namespace: 'ngWorker', id: 'angular2/web_worker/worker'},
         'angular2/web_worker/ui': {namespace: 'ngUi', id: 'angular2/web_worker/ui'}
-        */
       }
     },
     {

docs/typescript-definition-package/processors/code_gen.js

@@ -5,6 +5,7 @@ function DtsSerializer(remap) {
 }
 
 DtsSerializer.prototype = {
+  _initializerRegex: /\s*=[^>][^,}]*/g,
 
   constructor: DtsSerializer,
 
@@ -18,15 +19,21 @@ DtsSerializer.prototype = {
     }
     if (ast.parameters) {
       buffer.push('(');
-      buffer.push(ast.parameters.join(', '));
+      var parameters = ast.parameters;
+      for (var i = 0; i < parameters.length; i++) {
+        parameters[i] = parameters[i].replace(this._initializerRegex, '');
+      }
+      buffer.push(parameters.join(', '));
       buffer.push(')');
     }
-    if (ast.returnType) {
-      buffer.push(': ', ast.returnType);
-    } else if (ast.parameters) {
-      buffer.push(': void');
-    } else {
-      buffer.push(': any');
+    if (!isConstructor(ast)) {
+      if (ast.returnType) {
+        buffer.push(': ', ast.returnType);
+      } else if (ast.parameters) {
+        buffer.push(': void');
+      } else {
+        buffer.push(': any');
+      }
     }
     buffer.push(';\n');
   },
@@ -58,6 +65,7 @@ DtsSerializer.prototype = {
     buffer.indent();
     if (ast.newMember) this.member(buffer, ast.newMember);
     if (ast.callMember) this.member(buffer, ast.callMember);
+    if (ast.constructorDoc) this.member(buffer, ast.constructorDoc);
 
     ast.statics.forEach(function(staticMember) {
       this.member(buffer, staticMember);
@@ -144,7 +152,6 @@ DtsSerializer.prototype = {
   }
 };
 
-
 function Buffer() {
   this._globalBuffer = [];
   this._indentedBuffer = [];
@@ -191,7 +198,11 @@ Buffer.prototype = {
   }
 };
 
+function isConstructor(ast) {
+  return ast.parameters && ast.name === "constructor";
+}
 
 module.exports = {
   DtsSerializer: DtsSerializer
 };
+

docs/typescript-package/processors/readTypeScriptModules.js

@@ -150,6 +150,7 @@ module.exports = function readTypeScriptModules(tsParser, modules, getFileInfo,
   function createExportDoc(name, exportSymbol, moduleDoc, basePath, typeChecker) {
     var typeParamString = '';
     var heritageString = '';
+    var typeDefinition = '';
 
     exportSymbol.declarations.forEach(function(decl) {
       var sourceFile = ts.getSourceFileOfNode(decl);
@@ -158,6 +159,10 @@ module.exports = function readTypeScriptModules(tsParser, modules, getFileInfo,
         typeParamString = '<' + getText(sourceFile, decl.typeParameters) + '>';
       }
 
+      if (decl.symbol.flags & ts.SymbolFlags.TypeAlias) {
+        typeDefinition = getText(sourceFile, decl.type);
+      }
+
       if (decl.heritageClauses) {
         decl.heritageClauses.forEach(function(heritage) {
 
@@ -215,6 +220,9 @@ module.exports = function readTypeScriptModules(tsParser, modules, getFileInfo,
     if(exportSymbol.flags & ts.SymbolFlags.Value) {
       exportDoc.returnType = getReturnType(typeChecker, exportSymbol);
     }
+    if (exportSymbol.flags & ts.SymbolFlags.TypeAlias) {
+      exportDoc.typeDefinition = typeDefinition;
+    }
     return exportDoc;
   }
 

modules/angular2/angular2.ts

@@ -1,4 +1,4 @@
 export * from './core';
 export * from './profile';
 export * from './lifecycle_hooks';
-export * from './bootstrap';
+export * from './bootstrap';

modules/angular2/core.ts

@@ -18,3 +18,8 @@ export * from './src/core/directives';
 export * from './src/core/forms';
 export * from './src/core/debug';
 export * from './src/core/change_detection';
+export {Reflector, ReflectionInfo} from './src/core/reflection/reflection';
+export {
+  PlatformReflectionCapabilities
+} from './src/core/reflection/platform_reflection_capabilities';
+export {SetterFn, GetterFn, MethodFn} from './src/core/reflection/types';

modules/angular2/http.ts

@@ -30,6 +30,7 @@ export {BaseRequestOptions, RequestOptions} from './src/http/base_request_option
 export {BaseResponseOptions, ResponseOptions} from './src/http/base_response_options';
 export {XHRBackend, XHRConnection} from './src/http/backends/xhr_backend';
 export {JSONPBackend, JSONPConnection} from './src/http/backends/jsonp_backend';
+export {BrowserJsonp} from './src/http/backends/browser_jsonp';
 export {Http, Jsonp} from './src/http/http';
 
 export {Headers} from './src/http/headers';

modules/angular2/router.ts

@@ -7,12 +7,47 @@
 
 export {Router, RootRouter} from './src/router/router';
 export {RouterOutlet} from './src/router/router_outlet';
+export {
+  DynamicComponentLoader,
+  ComponentRef,
+  ElementRef,
+  Compiler,
+  AppViewManager,
+  ViewRef,
+  HostViewRef,
+  ProtoViewRef,
+  ViewContainerRef,
+  TemplateRef
+} from './core';
+export {
+  Renderer,
+  RenderElementRef,
+  RenderViewRef,
+  RenderProtoViewRef,
+  RenderEventDispatcher,
+  RenderFragmentRef,
+  RenderViewWithFragments
+} from './render';
+export {
+  Binding,
+  Injector,
+  ResolvedBinding,
+  Key,
+  Dependency,
+  ProtoInjector,
+  DependencyProvider,
+  BindingWithVisibility,
+  Visibility,
+  ResolvedFactory
+} from './src/core/di';
 export {RouterLink} from './src/router/router_link';
 export {RouteParams} from './src/router/instruction';
 export {RouteRegistry} from './src/router/route_registry';
 export {LocationStrategy} from './src/router/location_strategy';
 export {HashLocationStrategy} from './src/router/hash_location_strategy';
 export {PathLocationStrategy} from './src/router/path_location_strategy';
+export {PathRecognizer, PathMatch} from './src/router/path_recognizer';
+export {RouteHandler} from './src/router/route_handler';
 export {Location, APP_BASE_HREF} from './src/router/location';
 export {Pipeline} from './src/router/pipeline';
 export * from './src/router/route_config_decorator';
@@ -73,6 +108,8 @@ export const ROUTER_BINDINGS: any[] = CONST_EXPR([
                   }))
 ]);
 
+export interface InjectableReference {}
+
 function routerFactory(registry, pipeline, location, appRoot) {
   return new RootRouter(registry, pipeline, location, appRoot);
 }

modules/angular2/src/core/change_detection.ts

@@ -22,6 +22,13 @@ export {
   IterableDifferFactory,
   KeyValueDiffers,
   KeyValueDiffer,
-  KeyValueDifferFactory
-
-} from './change_detection/change_detection';
+  KeyValueDifferFactory,
+  Lexer,
+  Parser,
+  ChangeDispatcher,
+  BindingTarget,
+  DirectiveIndex,
+  DebugContext,
+  ProtoChangeDetector
+} from 'angular2/src/core/change_detection/change_detection';
+export * from 'angular2/src/core/change_detection/parser/ast';

modules/angular2/src/core/change_detection/change_detection.ts

@@ -21,14 +21,7 @@ import {
   assertionsEnabled
 } from 'angular2/src/core/facade/lang';
 
-export {
-  ASTWithSource,
-  AST,
-  AstTransformer,
-  PropertyRead,
-  LiteralArray,
-  ImplicitReceiver
-} from './parser/ast';
+export * from './parser/ast';
 
 export {Lexer} from './parser/lexer';
 export {Parser} from './parser/parser';

modules/angular2/src/core/compiler.ts

@@ -19,4 +19,14 @@ export {ElementRef} from './compiler/element_ref';
 export {TemplateRef} from './compiler/template_ref';
 export {ViewRef, HostViewRef, ProtoViewRef} from './compiler/view_ref';
 export {ViewContainerRef} from './compiler/view_container_ref';
+export {AppView, AppProtoView, AppProtoViewMergeMapping, AppViewContainer} from './compiler/view';
 export {ComponentRef} from './compiler/dynamic_component_loader';
+export {
+  ElementInjector,
+  PreBuiltObjects,
+  TreeNode,
+  ProtoElementInjector,
+  DirectiveBinding,
+  EventEmitterAccessor
+} from './compiler/element_injector';
+export {ElementBinder} from './compiler/element_binder';