Merge branch 'tommueller-master' adds compodoc

Author: gonzofish

README.md

@@ -165,6 +165,10 @@ Creates the project structure and a slew of files:
 |__package.json
 |__README.md
 |__tsconfig.json
+|__tsconfig.doc.json
+|__tsconfig.es5.json
+|__tsconfig.es2015.json
+|__tsconfig.test.json
 |__tslint.json
 ```
 
@@ -192,6 +196,9 @@ Creates the project structure and a slew of files:
     the library
 - `test.ts`: contains code needed to get the Angular test environment bootstrapped
 - `tsconfig.json`: the TypeScript configuration for the project
+- `tsconfig.*.json`: the TypeScript configuration for specific tasks (`doc` is for
+    documentation generationg, `es5` & `es2015` are for builds, and `test` is for
+    testing)
 - `tslint.json`: the linting rules for the project
 - `vendor.ts`: contains a list of dependencies that Angular needs loaded before the
     application is loaded

commands/initial/index.js

@@ -42,6 +42,7 @@ module.exports = (rootDir, ...args) => {
             { destination: srcDir('index.ts'), name: 'src/index.ts' },
             { destination: srcDir('test.js'), name: 'src/test.js', overwrite: true },
             { name: 'tsconfig.json', overwrite: true },
+            { name: 'tsconfig.doc.json', overwrite: true },
             { name: 'tsconfig.es2015.json', overwrite: true },
             { name: 'tsconfig.es5.json', overwrite: true },
             { name: 'tsconfig.test.json', overwrite: true },

commands/initial/templates/package.json

@@ -7,15 +7,16 @@
   "es2015": "./{{ name }}.js",
   "typings": "./{{ packageName }}.d.ts",
   "scripts": {
-    "build": "node ./tasks/build",
+    "build": "node ./tasks/build && npm run compodoc",
     "g": "node ./node_modules/angular-librarian",
     "lint": "tslint ./src/**/*.ts",
     "postbuild": "rimraf build",
     "posttagVersion": "npm run build && npm publish dist",
     "prebuild": "rimraf dist out-tsc",
     "start": "webpack-dev-server --open --config ./webpack/webpack.dev.js",
     "tagVersion": "node ./tasks/tag-version",
-    "test": "node ./tasks/test"
+    "test": "node ./tasks/test",
+    "compodoc": "compodoc src -p tsconfig.doc.json --disableInternal --disablePrivate"
   },
   "keywords": [],
   "author": "",
@@ -32,6 +33,7 @@
   },
   "devDependencies": {
     "@angular/compiler-cli": "^5.0.0",
+    "@compodoc/compodoc": "^1.0.7",
     "@types/jasmine": "^2.0.0",
     "@types/node": "^8.0.0",
     "angular-librarian": "{{ librarianVersion }}",

commands/initial/templates/tsconfig.doc.json

@@ -0,0 +1,25 @@
+{
+  "angularCompilerOptions": {
+      "strictMetadataEmit": true,
+      "skipTemplateCodegen": true
+  },
+  "compilerOptions": {
+      "baseUrl": "",
+      "declaration": true,
+      "emitDecoratorMetadata": true,
+      "experimentalDecorators": true,
+      "lib": ["es2015", "dom"],
+      "mapRoot": "./",
+      "module": "es2015",
+      "moduleResolution": "node",
+      "outDir": "./dist",
+      "sourceMap": true,
+      "target": "es5",
+      "typeRoots": [
+          "./node_modules/@types"
+      ]
+  },
+  "awesomeTypescriptLoaderOptions": {
+      "forkChecker": true
+  }
+}

commands/upgrade/index.js

@@ -128,6 +128,7 @@ const updateFiles = () => {
         { name: 'tsconfig.es5.json', overwrite: true },
         { name: 'tsconfig.es2015.json', overwrite: true },
         { name: 'tsconfig.json', overwrite: true },
+        { name: 'tsconfig.doc.json', overwrite: true },
         { name: 'tsconfig.test.json', overwrite: true },
         { name: 'tslint.json', overwrite: true },
         { destination: srcDir('test.js'), name: 'src/test.js', overwrite: true },

test/initial.spec.js

@@ -249,6 +249,7 @@ tap.test('command: initial', (suite) => {
                 { destination: '/created/src/index.ts', name: 'src/index.ts' },
                 { destination: '/created/src/test.js', name: 'src/test.js', overwrite: true },
                 { name: 'tsconfig.json', overwrite: true },
+                { name: 'tsconfig.doc.json', overwrite: true },
                 { name: 'tsconfig.es2015.json', overwrite: true },
                 { name: 'tsconfig.es5.json', overwrite: true },
                 { name: 'tsconfig.test.json', overwrite: true },

test/upgrade.spec.js

@@ -259,6 +259,7 @@ tap.test('command: upgrade', (suite) => {
                     { name: 'tsconfig.es5.json', overwrite: true },
                     { name: 'tsconfig.es2015.json', overwrite: true },
                     { name: 'tsconfig.json', overwrite: true },
+                    { name: 'tsconfig.doc.json', overwrite: true },
                     { name: 'tsconfig.test.json', overwrite: true },
                     { name: 'tslint.json', overwrite: true },
                     {