@angular-devkit/build-angular 12.0.0-rc.0 → 12.0.0

package/src/browser/schema.json

@@ -44,12 +44,7 @@
       "description": "The stylesheet language to use for the application's inline component styles.",
       "type": "string",
       "default": "css",
-      "enum": [
-        "css",
-        "less",
-        "sass",
-        "scss"
-      ]
+      "enum": ["css", "less", "sass", "scss"]
     },
     "stylePreprocessorOptions": {
       "description": "Options to pass to style preprocessors.",
@@ -257,12 +252,7 @@
       "type": "string",
       "description": "Define the output filename cache-busting hashing mode.",
       "default": "none",
-      "enum": [
-        "none",
-        "all",
-        "media",
-        "bundles"
-      ]
+      "enum": ["none", "all", "media", "bundles"]
     },
     "poll": {
       "type": "number",
@@ -286,7 +276,7 @@
       "type": "boolean",
       "description": "Show circular dependency warnings on builds.",
       "default": false,
-      "x-deprecated": "The recommended method to detect circular dependencies in project code is to use a either a lint rule or other external tooling."
+      "x-deprecated": "The recommended method to detect circular dependencies in project code is to use either a lint rule or other external tooling."
     },
     "buildOptimizer": {
       "type": "boolean",
@@ -344,11 +334,6 @@
       "description": "Generates a 'stats.json' file which can be analyzed using tools such as 'webpack-bundle-analyzer'.",
       "default": false
     },
-    "forkTypeChecker": {
-      "type": "boolean",
-      "description": "Run the TypeScript type checker in a forked process.",
-      "default": true
-    },
     "budgets": {
       "description": "Budget thresholds to ensure parts of your application stay within boundaries which you set.",
       "type": "array",
@@ -365,11 +350,7 @@
       "type": "string",
       "description": "Define the crossorigin attribute setting of elements that provide CORS support.",
       "default": "none",
-      "enum": [
-        "none",
-        "anonymous",
-        "use-credentials"
-      ]
+      "enum": ["none", "anonymous", "use-credentials"]
     },
     "allowedCommonJsDependencies": {
       "description": "A list of CommonJS packages that are allowed to be used without a build time warning.",
@@ -381,12 +362,7 @@
     }
   },
   "additionalProperties": false,
-  "required": [
-    "outputPath",
-    "index",
-    "main",
-    "tsConfig"
-  ],
+  "required": ["outputPath", "index", "main", "tsConfig"],
   "definitions": {
     "assetPattern": {
       "oneOf": [
@@ -419,11 +395,7 @@
             }
           },
           "additionalProperties": false,
-          "required": [
-            "glob",
-            "input",
-            "output"
-          ]
+          "required": ["glob", "input", "output"]
         },
         {
           "type": "string"
@@ -445,10 +417,7 @@
             }
           },
           "additionalProperties": false,
-          "required": [
-            "src",
-            "replaceWith"
-          ]
+          "required": ["src", "replaceWith"]
         },
         {
           "type": "object",
@@ -463,10 +432,7 @@
             }
           },
           "additionalProperties": false,
-          "required": [
-            "replace",
-            "with"
-          ]
+          "required": ["replace", "with"]
         }
       ]
     },
@@ -491,9 +457,7 @@
             }
           },
           "additionalProperties": false,
-          "required": [
-            "input"
-          ]
+          "required": ["input"]
         },
         {
           "type": "string",
@@ -507,15 +471,7 @@
         "type": {
           "type": "string",
           "description": "The type of budget.",
-          "enum": [
-            "all",
-            "allScript",
-            "any",
-            "anyScript",
-            "anyComponentStyle",
-            "bundle",
-            "initial"
-          ]
+          "enum": ["all", "allScript", "any", "anyScript", "anyComponentStyle", "bundle", "initial"]
         },
         "name": {
           "type": "string",
@@ -551,9 +507,7 @@
         }
       },
       "additionalProperties": false,
-      "required": [
-        "type"
-      ]
+      "required": ["type"]
     }
   }
 }

package/src/browser/tests/setup.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license

package/src/browser/tests/setup.js

@@ -1,4 +1,11 @@
 "use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASE_OPTIONS = exports.BROWSER_BUILDER_INFO = exports.describeBuilder = void 0;
 var testing_1 = require("../../testing");

package/src/dev-server/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license

package/src/dev-server/index.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
@@ -52,7 +52,7 @@ const devServerBuildOverriddenKeys = [
  *
  * @experimental Direct usage of this function is considered experimental.
  */
-// tslint:disable-next-line: no-big-function
+// eslint-disable-next-line max-lines-per-function
 function serveWebpackBrowser(options, context, transforms = {}) {
     // Check Angular version.
     const { logger, workspaceRoot } = context;
@@ -65,13 +65,13 @@ function serveWebpackBrowser(options, context, transforms = {}) {
         options.port = await check_port_1.checkPort((_a = options.port) !== null && _a !== void 0 ? _a : 4200, options.host || 'localhost');
         // Override options we need to override, if defined.
         const overrides = Object.keys(options)
-            .filter(key => options[key] !== undefined && devServerBuildOverriddenKeys.includes(key))
+            .filter((key) => options[key] !== undefined && devServerBuildOverriddenKeys.includes(key))
             .reduce((previous, key) => ({
             ...previous,
             [key]: options[key],
         }), {});
         const devServerOptions = Object.keys(options)
-            .filter(key => !devServerBuildOverriddenKeys.includes(key) && key !== 'browserTarget')
+            .filter((key) => !devServerBuildOverriddenKeys.includes(key) && key !== 'browserTarget')
             .reduce((previous, key) => ({
             ...previous,
             [key]: options[key],
@@ -88,8 +88,8 @@ function serveWebpackBrowser(options, context, transforms = {}) {
         (_b = rawBrowserOptions.allowedCommonJsDependencies) !== null && _b !== void 0 ? _b : (rawBrowserOptions.allowedCommonJsDependencies = []);
         rawBrowserOptions.allowedCommonJsDependencies.push('strip-ansi');
         const browserName = await context.getBuilderNameForTarget(browserTarget);
-        const browserOptions = await context.validateOptions({ ...rawBrowserOptions, ...overrides }, browserName);
-        const { config, projectRoot, i18n } = await webpack_browser_config_1.generateI18nBrowserWebpackConfigFromContext(browserOptions, context, wco => [
+        const browserOptions = (await context.validateOptions({ ...rawBrowserOptions, ...overrides }, browserName));
+        const { config, projectRoot, i18n } = await webpack_browser_config_1.generateI18nBrowserWebpackConfigFromContext(browserOptions, context, (wco) => [
             configs_1.getDevServerConfig(wco),
             configs_1.getCommonConfig(wco),
             configs_1.getBrowserConfig(wco),
@@ -106,7 +106,6 @@ function serveWebpackBrowser(options, context, transforms = {}) {
             // This is needed because we cannot use the inline option directly in the config
             // because of the SuppressExtractedTextChunksWebpackPlugin
             // Consider not using SuppressExtractedTextChunksWebpackPlugin when liveReload is enable.
-            // tslint:disable-next-line: no-any
             webpackDevServer.addDevServerEntrypoints(config, {
                 ...config.devServer,
                 inline: true,
@@ -114,12 +113,15 @@ function serveWebpackBrowser(options, context, transforms = {}) {
             // Remove live-reload code from all entrypoints but not main.
             // Otherwise this will break SuppressExtractedTextChunksWebpackPlugin because
             // 'addDevServerEntrypoints' adds addional entry-points to all entries.
-            if (config.entry && typeof config.entry === 'object' && !Array.isArray(config.entry) && config.entry.main) {
+            if (config.entry &&
+                typeof config.entry === 'object' &&
+                !Array.isArray(config.entry) &&
+                config.entry.main) {
                 for (const [key, value] of Object.entries(config.entry)) {
                     if (key === 'main' || !Array.isArray(value)) {
                         continue;
                     }
-                    const webpackClientScriptIndex = value.findIndex(x => x.includes('webpack-dev-server/client/index.js'));
+                    const webpackClientScriptIndex = value.findIndex((x) => x.includes('webpack-dev-server/client/index.js'));
                     if (webpackClientScriptIndex >= 0) {
                         // Remove the webpack-dev-server/client script from array.
                         value.splice(webpackClientScriptIndex, 1);
@@ -131,9 +133,9 @@ function serveWebpackBrowser(options, context, transforms = {}) {
             logger.warn(core_1.tags.stripIndents `NOTICE: Hot Module Replacement (HMR) is enabled for the dev server.
       See https://webpack.js.org/guides/hot-module-replacement for information on working with HMR for Webpack.`);
         }
-        if (options.host
-            && !/^127\.\d+\.\d+\.\d+/g.test(options.host)
-            && options.host !== 'localhost') {
+        if (options.host &&
+            !/^127\.\d+\.\d+\.\d+/g.test(options.host) &&
+            options.host !== 'localhost') {
             logger.warn(core_1.tags.stripIndent `
         Warning: This is a simple server for use in testing or debugging Angular applications
         locally. It hasn't been reviewed for security issues.
@@ -234,12 +236,14 @@ function serveWebpackBrowser(options, context, transforms = {}) {
                 port: buildEvent.port,
             });
             if (index === 0) {
-                logger.info('\n' + core_1.tags.oneLine `
+                logger.info('\n' +
+                    core_1.tags.oneLine `
               **
               Angular Live Development Server is listening on ${options.host}:${buildEvent.port},
               open your browser on ${serverAddress}
               **
-            ` + '\n');
+            ` +
+                    '\n');
                 if (options.open) {
                     const open = await Promise.resolve().then(() => require('open'));
                     await open(serverAddress);
@@ -265,7 +269,10 @@ async function setupLocalize(locale, i18n, browserOptions, webpackConfig) {
             webpackConfig.entry['main'].unshift(localeDescription.dataPath);
         }
         else {
-            webpackConfig.entry['main'] = [localeDescription.dataPath, webpackConfig.entry['main']];
+            webpackConfig.entry['main'] = [
+                localeDescription.dataPath,
+                webpackConfig.entry['main'],
+            ];
         }
     }
     let missingTranslationBehavior = browserOptions.i18nMissingTranslation || 'ignore';

package/src/dev-server/schema.json

@@ -202,7 +202,5 @@
     }
   },
   "additionalProperties": false,
-  "required": [
-    "browserTarget"
-  ]
+  "required": ["browserTarget"]
 }

package/src/dev-server/tests/execute-fetch.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license

package/src/dev-server/tests/execute-fetch.js

@@ -1,14 +1,14 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeOnceAndFetch = void 0;
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
-const node_fetch_1 = require("node-fetch"); // tslint:disable-line:no-implicit-dependencies
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeOnceAndFetch = void 0;
+const node_fetch_1 = require("node-fetch"); // eslint-disable-line import/no-extraneous-dependencies
 const operators_1 = require("rxjs/operators");
 const url_1 = require("url");
 async function executeOnceAndFetch(harness, url, options) {

package/src/dev-server/tests/setup.d.ts

@@ -1,3 +1,10 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
 import { Schema as BrowserSchema } from '../../browser/schema';
 import { BuilderHarness } from '../../testing/builder-harness';
 import { Schema } from '../schema';

package/src/dev-server/tests/setup.js

@@ -1,4 +1,11 @@
 "use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupBrowserTarget = exports.BUILD_TIMEOUT = exports.BASE_OPTIONS = exports.DEV_SERVER_BUILDER_INFO = exports.describeBuilder = void 0;
 const fs_1 = require("fs");

package/src/extract-i18n/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license

package/src/extract-i18n/index.js

@@ -1,13 +1,13 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.execute = void 0;
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = void 0;
 const architect_1 = require("@angular-devkit/architect");
 const build_webpack_1 = require("@angular-devkit/build-webpack");
 const fs = require("fs");
@@ -43,18 +43,18 @@ async function getSerializer(format, sourceLocale, basePath, useLegacyIds, diagn
     switch (format) {
         case schema_2.Format.Xmb:
             const { XmbTranslationSerializer } = await Promise.resolve().then(() => require('@angular/localize/src/tools/src/extract/translation_files/xmb_translation_serializer'));
-            // tslint:disable-next-line: no-any
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             return new XmbTranslationSerializer(basePath, useLegacyIds);
         case schema_2.Format.Xlf:
         case schema_2.Format.Xlif:
         case schema_2.Format.Xliff:
             const { Xliff1TranslationSerializer } = await Promise.resolve().then(() => require('@angular/localize/src/tools/src/extract/translation_files/xliff1_translation_serializer'));
-            // tslint:disable-next-line: no-any
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             return new Xliff1TranslationSerializer(sourceLocale, basePath, useLegacyIds, {});
         case schema_2.Format.Xlf2:
         case schema_2.Format.Xliff2:
             const { Xliff2TranslationSerializer } = await Promise.resolve().then(() => require('@angular/localize/src/tools/src/extract/translation_files/xliff2_translation_serializer'));
-            // tslint:disable-next-line: no-any
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             return new Xliff2TranslationSerializer(sourceLocale, basePath, useLegacyIds, {});
         case schema_2.Format.Json:
             const { SimpleJsonTranslationSerializer } = await Promise.resolve().then(() => require('@angular/localize/src/tools/src/extract/translation_files/json_translation_serializer'));
@@ -69,7 +69,7 @@ async function getSerializer(format, sourceLocale, basePath, useLegacyIds, diagn
                     return path.relative(from, to);
                 },
             };
-            // tslint:disable-next-line: no-any
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             return new ArbTranslationSerializer(sourceLocale, basePath, fileSystem);
     }
 }
@@ -195,9 +195,7 @@ async function execute(options, context, transforms) {
         return webpackResult;
     }
     const basePath = config.context || projectRoot;
-    const { checkDuplicateMessages } = await Promise.resolve().then(() => require(
-    // tslint:disable-next-line: trailing-comma
-    '@angular/localize/src/tools/src/extract/duplicates'));
+    const { checkDuplicateMessages } = await Promise.resolve().then(() => require('@angular/localize/src/tools/src/extract/duplicates'));
     // The filesystem is used to create a relative path for each file
     // from the basePath.  This relative path is then used in the error message.
     const checkFileSystem = {
@@ -206,9 +204,9 @@ async function execute(options, context, transforms) {
         },
     };
     const diagnostics = checkDuplicateMessages(
-    // tslint:disable-next-line: no-any
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     checkFileSystem, ivyMessages, 'warning', 
-    // tslint:disable-next-line: no-any
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     basePath);
     if (diagnostics.messages.length > 0) {
         context.logger.warn(diagnostics.formatDiagnostics(''));

package/src/extract-i18n/ivy-extract-loader.d.ts

@@ -1 +1,8 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
 export default function localizeExtractLoader(this: any, content: string, map: any): void;

package/src/extract-i18n/ivy-extract-loader.js

@@ -1,19 +1,20 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
+Object.defineProperty(exports, "__esModule", { value: true });
 const extraction_1 = require("@angular/localize/src/tools/src/extract/extraction");
 const loader_utils_1 = require("loader-utils");
 const nodePath = require("path");
 function localizeExtractLoader(content, 
 // Source map types are broken in the webpack type definitions
-// tslint:disable-next-line: no-any
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 map) {
+    // eslint-disable-next-line @typescript-eslint/no-this-alias
     const loaderContext = this;
     // Casts are needed to workaround the loader-utils typings limited support for option values
     const options = loader_utils_1.getOptions(this);
@@ -22,7 +23,7 @@ map) {
         // level 2 is warnings
         level: 2,
         debug(...args) {
-            // tslint:disable-next-line: no-console
+            // eslint-disable-next-line no-console
             console.debug(...args);
         },
         info(...args) {
@@ -68,9 +69,9 @@ map) {
             return nodePath.dirname(path);
         },
     };
-    // tslint:disable-next-line: no-any
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const extractor = new extraction_1.MessageExtractor(filesystem, logger, {
-        // tslint:disable-next-line: no-any
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         basePath: this.rootContext,
         useSourceMaps: !!map,
     });

package/src/extract-i18n/schema.json

@@ -13,17 +13,7 @@
       "type": "string",
       "description": "Output format for the generated file.",
       "default": "xlf",
-      "enum": [
-        "xmb",
-        "xlf",
-        "xlif",
-        "xliff",
-        "xlf2",
-        "xliff2",
-        "json",
-        "arb",
-        "legacy-migrate"
-      ]
+      "enum": ["xmb", "xlf", "xlif", "xliff", "xlf2", "xliff2", "json", "arb", "legacy-migrate"]
     },
     "progress": {
       "type": "boolean",
@@ -40,7 +30,5 @@
     }
   },
   "additionalProperties": false,
-  "required": [
-    "browserTarget"
-  ]
+  "required": ["browserTarget"]
 }

package/src/index.d.ts

@@ -1,16 +1,16 @@
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
 export * from './transforms';
 export { AssetPattern, AssetPatternClass as AssetPatternObject, Budget, CrossOrigin, ExtraEntryPoint, ExtraEntryPointClass as ExtraEntryPointObject, FileReplacement, OptimizationClass as OptimizationObject, OptimizationUnion, OutputHashing, Schema as BrowserBuilderOptions, SourceMapClass as SourceMapObject, SourceMapUnion, StylePreprocessorOptions, Type, } from './browser/schema';
-export { buildWebpackBrowser as executeBrowserBuilder, BrowserBuilderOutput, } from './browser';
+export { buildWebpackBrowser as executeBrowserBuilder, BrowserBuilderOutput } from './browser';
 export { serveWebpackBrowser as executeDevServerBuilder, DevServerBuilderOptions, DevServerBuilderOutput, } from './dev-server';
-export { execute as executeExtractI18nBuilder, ExtractI18nBuilderOptions, } from './extract-i18n';
-export { execute as executeKarmaBuilder, KarmaBuilderOptions, KarmaConfigOptions, } from './karma';
-export { execute as executeProtractorBuilder, ProtractorBuilderOptions, } from './protractor';
+export { execute as executeExtractI18nBuilder, ExtractI18nBuilderOptions } from './extract-i18n';
+export { execute as executeKarmaBuilder, KarmaBuilderOptions, KarmaConfigOptions } from './karma';
+export { execute as executeProtractorBuilder, ProtractorBuilderOptions } from './protractor';
 export { execute as executeServerBuilder, ServerBuilderOptions, ServerBuilderOutput, } from './server';
-export { execute as executeNgPackagrBuilder, NgPackagrBuilderOptions, } from './ng-packagr';
+export { execute as executeNgPackagrBuilder, NgPackagrBuilderOptions } from './ng-packagr';

package/src/index.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license

package/src/karma/find-tests.d.ts

@@ -1 +1,8 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
 export declare function findTests(patterns: string[], cwd: string, workspaceRoot: string): string[];

package/src/karma/find-tests.js

@@ -1,13 +1,13 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.findTests = void 0;
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTests = void 0;
 const fs_1 = require("fs");
 const glob = require("glob");
 const path_1 = require("path");
@@ -17,7 +17,7 @@ function findTests(patterns, cwd, workspaceRoot) {
     return patterns.reduce((files, pattern) => {
         const relativePathToMain = cwd.replace(workspaceRoot, '').substr(1); // remove leading slash
         const tests = findMatchingTests(pattern, cwd, relativePathToMain);
-        tests.forEach(file => {
+        tests.forEach((file) => {
             if (!files.includes(file)) {
                 files.push(file);
             }

package/src/karma/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright Google Inc. All Rights Reserved.
+ * Copyright Google LLC All Rights Reserved.
  *
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license