feat(@angular/cli): use environmentSource key for environments

Heavily based on @jsanchezgarcia work in angular#4476.

Fix angular#3857

BREAKING CHANGE:

A new environmentSource entry replaces the previous source entry inside environments.

To migrate the code follow the example below:

Before:
```
"environments": {
  "source": "environments/environment.ts",
  "dev": "environments/environment.ts",
  "prod": "environments/environment.prod.ts"
}
```

After:
```
"environmentSource": "environments/environment.ts",
  "environments": {
  "dev": "environments/environment.ts",
  "prod": "environments/environment.prod.ts"
}
```

docs/documentation/build.md

@@ -22,8 +22,8 @@ By default, the development build target and environment are used.
 The mapping used to determine which environment file is used can be found in `angular-cli.json`:
 
 ```json
+"environmentSource": "environments/environment.ts",
 "environments": {
-  "source": "environments/environment.ts",
   "dev": "environments/environment.ts",
   "prod": "environments/environment.prod.ts"
 }

docs/documentation/overview.md

@@ -29,8 +29,8 @@ By default, the development build target and environment are used.
 The mapping used to determine which environment file is used can be found in `angular-cli.json`:
 
 ```json
+"environmentSource": "environments/environment.ts",
 "environments": {
-  "source": "environments/environment.ts",
   "dev": "environments/environment.ts",
   "prod": "environments/environment.prod.ts"
 }

packages/@angular/cli/blueprints/ng2/files/angular-cli.json

@@ -22,8 +22,8 @@
         "styles.<%= styleExt %>"
       ],
       "scripts": [],
+      "environmentSource": "environments/environment.ts",
       "environments": {
-        "source": "environments/environment.ts",
         "dev": "environments/environment.ts",
         "prod": "environments/environment.prod.ts"
       }

packages/@angular/cli/lib/config/schema.json

@@ -132,6 +132,10 @@
             },
             "additionalProperties": false
           },
+          "environmentSource":{
+            "description": "Source file for environment config.",
+            "type": "string"
+          },
           "environments": {
             "description": "Name and corresponding file for environment config.",
             "type": "object",

packages/@angular/cli/models/webpack-configs/test.js

@@ -103,7 +103,7 @@ const getTestConfig = function (projectRoot, environment, appConfig, testConfig)
         // This plugin is responsible for swapping the environment files.
         // Since it takes a RegExp as first parameter, we need to escape the path.
         // See https://webpack.github.io/docs/list-of-plugins.html#normalmodulereplacementplugin
-        new RegExp(path.resolve(appRoot, appConfig.environments['source'])
+        new RegExp(path.resolve(appRoot, appConfig.environmentSource)
           .replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, '\\$&')),
         path.resolve(appRoot, appConfig.environments[environment])
       ),

packages/@angular/cli/models/webpack-configs/typescript.ts

@@ -19,15 +19,16 @@ function _createAotPlugin(wco: WebpackConfigOptions, options: any) {
   let hostOverrideFileSystem: any = {};
   // process environment file replacement
   if (appConfig.environments) {
-    if (!('source' in appConfig.environments)) {
-      throw new SilentError(`Environment configuration does not contain "source" entry.`);
+    if (appConfig.environmentSource) {
+      throw new SilentError(
+        'Environment configuration does not contain "environmentSource" entry.');
     }
     if (!(buildOptions.environment in appConfig.environments)) {
       throw new SilentError(`Environment "${buildOptions.environment}" does not exist.`);
     }
 
     const appRoot = path.resolve(projectRoot, appConfig.root);
-    const sourcePath = appConfig.environments['source'];
+    const sourcePath = appConfig.environmentSource;
     const envFile = appConfig.environments[buildOptions.environment];
     const environmentContent = fs.readFileSync(path.join(appRoot, envFile)).toString();