feat(@schematics/angular): generate applications using TypeScript project references

When generating a project (either via `ng new` or `ng generate application`), the
created TypeScript configuration files (`tsconfig.app.json`/`tsconfig.spec.json`)
will be setup as composite projects and added as project references to in the root
`tsconfig.json`.  This transforms the root `tsconfig.json` into a "solution" style
configuration. This allows IDEs to more accurately discover and provide type information
for the varying types of files (test, application, etc.) within each project.
The Angular build process is otherwise unaffected by these changes.

Author: clydin

packages/schematics/angular/application/files/common-files/tsconfig.app.json.template

@@ -3,13 +3,14 @@
 {
   "extends": "<%= relativePathToWorkspaceRoot %>/tsconfig.json",
   "compilerOptions": {
+    "composite": true,
     "outDir": "<%= relativePathToWorkspaceRoot %>/out-tsc/app",
     "types": []
   },
-  "files": [
-    "src/main.ts"
-  ],
   "include": [
-    "src/**/*.d.ts"
+    "src/**/*.ts"
+  ],
+  "exclude": [
+    "src/**/*.spec.ts"
   ]
 }

packages/schematics/angular/application/files/common-files/tsconfig.spec.json.template

@@ -3,13 +3,13 @@
 {
   "extends": "<%= relativePathToWorkspaceRoot %>/tsconfig.json",
   "compilerOptions": {
+    "composite": true,
     "outDir": "<%= relativePathToWorkspaceRoot %>/out-tsc/spec",
     "types": [
       "jasmine"
     ]
   },
   "include": [
-    "src/**/*.spec.ts",
-    "src/**/*.d.ts"
+    "src/**/*.ts"
   ]
 }

packages/schematics/angular/application/index.ts

@@ -26,19 +26,39 @@ import {
 import { NodePackageInstallTask } from '@angular-devkit/schematics/tasks';
 import { Schema as ComponentOptions } from '../component/schema';
 import { NodeDependencyType, addPackageJsonDependency } from '../utility/dependencies';
+import { JSONFile } from '../utility/json-file';
 import { latestVersions } from '../utility/latest-versions';
 import { relativePathToWorkspaceRoot } from '../utility/paths';
 import { getWorkspace, updateWorkspace } from '../utility/workspace';
 import { Builders, ProjectType } from '../utility/workspace-models';
 import { Schema as ApplicationOptions, Style } from './schema';
 
+function updateTsConfig(...paths: string[]) {
+  return (host: Tree) => {
+    if (!host.exists('tsconfig.json')) {
+      return host;
+    }
+
+    const newReferences = paths.map((path) => ({ path }));
+
+    const file = new JSONFile(host, 'tsconfig.json');
+    const jsonPath = ['references'];
+    const value = file.get(jsonPath);
+    file.modify(jsonPath, Array.isArray(value) ? [...value, ...newReferences] : newReferences);
+  };
+}
+
 export default function (options: ApplicationOptions): Rule {
   return async (host: Tree, context: SchematicContext) => {
     const { appDir, appRootSelector, componentOptions, folderName, sourceDir } =
       await getAppOptions(host, options);
 
     return chain([
       addAppToWorkspaceFile(options, appDir, folderName),
+      updateTsConfig(
+        join(normalize(appDir), 'tsconfig.app.json'),
+        join(normalize(appDir), 'tsconfig.spec.json'),
+      ),
       options.standalone
         ? noop()
         : schematic('module', {

packages/schematics/angular/application/index_spec.ts

@@ -93,8 +93,13 @@ describe('Application Schematic', () => {
   it('should set the right paths in the tsconfig.app.json', async () => {
     const tree = await schematicRunner.runSchematic('application', defaultOptions, workspaceTree);
 
-    const { files, extends: _extends } = readJsonFile(tree, '/projects/foo/tsconfig.app.json');
-    expect(files).toEqual(['src/main.ts']);
+    const {
+      include,
+      exclude,
+      extends: _extends,
+    } = readJsonFile(tree, '/projects/foo/tsconfig.app.json');
+    expect(include).toEqual(['src/**/*.ts']);
+    expect(exclude).toEqual(['src/**/*.spec.ts']);
     expect(_extends).toBe('../../tsconfig.json');
   });
 

packages/schematics/angular/workspace/files/tsconfig.json.template

@@ -22,5 +22,6 @@
     "strictInputAccessModifiers": true,
     "typeCheckHostBindings": true,
     "strictTemplates": true<% } %>
-  }
+  },
+  "files": []
 }