refactor(build): replace source in environments with separate environmentDefault entry

Replace `source` in environments with separate `environmentDefault` entry and updated docs to reflect this change

BREAKING CHANGE: angular-cli.json has changed. A new `environmentDefault` 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"
}

Closes angular#3857

Author: jsanchezgarcia

README.md

@@ -137,8 +137,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

@@ -27,8 +27,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

@@ -21,8 +21,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.d.ts

@@ -28,6 +28,10 @@ export interface CliConfig {
          * Global scripts to be included in the build.
          */
         scripts?: string[];
+        /**
+         * Environment source file.
+         */
+        environmentSource?: string,
         /**
          * Name and corresponding file for environment config.
          */

packages/angular-cli/models/webpack-build-common.ts

@@ -102,8 +102,9 @@ export function getWebpackCommonConfig(
 
   // process environment file replacement
   if (appConfig.environments) {
-    if (!('source' in appConfig.environments)) {
-      throw new SilentError(`Environment configuration does not contain "source" entry.`);
+    if (!('environmentSource' in appConfig.environments)) {
+      throw new SilentError(`Environment configuration does not contain 
+        "environmentSource" entry.`);
     }
     if (!(environment in appConfig.environments)) {
       throw new SilentError(`Environment "${environment}" does not exist.`);
@@ -113,7 +114,7 @@ export function getWebpackCommonConfig(
       // 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])
     ));