@angular/cli 14.0.0-next.6 → 14.0.0-next.9

package/src/commands/update/cli.js

@@ -48,20 +48,11 @@ const command_module_1 = require("../../command-builder/command-module");
 const schematic_engine_host_1 = require("../../command-builder/utilities/schematic-engine-host");
 const schematic_workflow_1 = require("../../command-builder/utilities/schematic-workflow");
 const color_1 = require("../../utilities/color");
-const install_package_1 = require("../../utilities/install-package");
+const environment_options_1 = require("../../utilities/environment-options");
 const log_file_1 = require("../../utilities/log-file");
-const package_manager_1 = require("../../utilities/package-manager");
 const package_metadata_1 = require("../../utilities/package-metadata");
 const package_tree_1 = require("../../utilities/package-tree");
 const version_1 = require("../../utilities/version");
-/**
- * Disable CLI version mismatch checks and forces usage of the invoked CLI
- * instead of invoking the local installed version.
- */
-const disableVersionCheckEnv = process.env['NG_DISABLE_VERSION_CHECK'];
-const disableVersionCheck = disableVersionCheckEnv !== undefined &&
-    disableVersionCheckEnv !== '0' &&
-    disableVersionCheckEnv.toLowerCase() !== 'false';
 const ANGULAR_PACKAGES_REGEXP = /^@(?:angular|nguniversal)\//;
 const UPDATE_SCHEMATIC_COLLECTION = path.join(__dirname, 'schematic/collection.json');
 class UpdateCommandModule extends command_module_1.CommandModule {
@@ -76,7 +67,8 @@ class UpdateCommandModule extends command_module_1.CommandModule {
         return localYargs
             .positional('packages', {
             description: 'The names of package(s) to update.',
-            coerce: (value) => (typeof value === 'string' ? [value] : value),
+            type: 'string',
+            array: true,
         })
             .option('force', {
             description: 'Ignore peer dependency version mismatches. ' +
@@ -156,14 +148,14 @@ class UpdateCommandModule extends command_module_1.CommandModule {
     async run(options) {
         var _a, _b;
         const { logger, packageManager } = this.context;
-        await (0, package_manager_1.ensureCompatibleNpm)(this.context.root);
+        packageManager.ensureCompatibility();
         // Check if the current installed CLI version is older than the latest compatible version.
-        if (!disableVersionCheck) {
+        if (!environment_options_1.disableVersionCheck) {
             const cliVersionToInstall = await this.checkCLIVersion(options.packages, options.verbose, options.next);
             if (cliVersionToInstall) {
                 logger.warn('The installed Angular CLI version is outdated.\n' +
                     `Installing a temporary Angular CLI versioned ${cliVersionToInstall} to perform the update.`);
-                return (0, install_package_1.runTempPackageBin)(`@angular/cli@${cliVersionToInstall}`, packageManager, process.argv.slice(2));
+                return this.runTempBinary(`@angular/cli@${cliVersionToInstall}`, process.argv.slice(2));
             }
         }
         const packages = [];
@@ -193,12 +185,12 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                 return 1;
             }
         }
-        logger.info(`Using package manager: '${packageManager}'`);
+        logger.info(`Using package manager: ${color_1.colors.grey(packageManager.name)}`);
         logger.info('Collecting installed dependencies...');
         const rootDependencies = await (0, package_tree_1.getProjectDependencies)(this.context.root);
         logger.info(`Found ${rootDependencies.size} dependencies.`);
         const workflow = new tools_1.NodeWorkflow(this.context.root, {
-            packageManager: this.context.packageManager,
+            packageManager: packageManager.name,
             packageManagerForce: options.force,
             // __dirname -> favor @schematics/update from this package
             // Otherwise, use packages from the active workspace (migrations)
@@ -212,7 +204,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                 force: options.force,
                 next: options.next,
                 verbose: options.verbose,
-                packageManager,
+                packageManager: packageManager.name,
                 packages: [],
             });
             return success ? 0 : 1;
@@ -509,7 +501,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
             verbose: options.verbose,
             force: options.force,
             next: options.next,
-            packageManager: this.context.packageManager,
+            packageManager: this.context.packageManager.name,
             packages: packagesToUpdate,
         });
         if (success) {
@@ -521,9 +513,9 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                 });
             }
             catch { }
-            const result = await (0, install_package_1.installAllPackages)(this.context.packageManager, options.force ? ['--force'] : [], this.context.root);
-            if (result !== 0) {
-                return result;
+            const installationSuccess = await this.context.packageManager.installAll(options.force ? ['--force'] : [], this.context.root);
+            if (!installationSuccess) {
+                return 1;
             }
         }
         if (success && options.createCommits) {
@@ -665,9 +657,9 @@ class UpdateCommandModule extends command_module_1.CommandModule {
      * @returns the version to install or null when there is no update to install.
      */
     async checkCLIVersion(packagesToUpdate, verbose = false, next = false) {
-        const { version } = await (0, package_metadata_1.fetchPackageManifest)(`@angular/cli@${this.getCLIUpdateRunnerVersion(typeof packagesToUpdate === 'string' ? [packagesToUpdate] : packagesToUpdate, next)}`, this.context.logger, {
+        const { version } = await (0, package_metadata_1.fetchPackageManifest)(`@angular/cli@${this.getCLIUpdateRunnerVersion(packagesToUpdate, next)}`, this.context.logger, {
             verbose,
-            usingYarn: this.context.packageManager === workspace_schema_1.PackageManager.Yarn,
+            usingYarn: this.context.packageManager.name === workspace_schema_1.PackageManager.Yarn,
         });
         return version_1.VERSION.full === version ? null : version;
     }
@@ -694,6 +686,44 @@ class UpdateCommandModule extends command_module_1.CommandModule {
         // We end up using Angular ClI v13 to run the migrations if we run the migrations using the CLI installed major version + 1 logic.
         return version_1.VERSION.major;
     }
+    async runTempBinary(packageName, args = []) {
+        const { success, tempNodeModules } = await this.context.packageManager.installTemp(packageName);
+        if (!success) {
+            return 1;
+        }
+        // Remove version/tag etc... from package name
+        // Ex: @angular/cli@latest -> @angular/cli
+        const packageNameNoVersion = packageName.substring(0, packageName.lastIndexOf('@'));
+        const pkgLocation = (0, path_1.join)(tempNodeModules, packageNameNoVersion);
+        const packageJsonPath = (0, path_1.join)(pkgLocation, 'package.json');
+        // Get a binary location for this package
+        let binPath;
+        if ((0, fs_1.existsSync)(packageJsonPath)) {
+            const content = await fs_1.promises.readFile(packageJsonPath, 'utf-8');
+            if (content) {
+                const { bin = {} } = JSON.parse(content);
+                const binKeys = Object.keys(bin);
+                if (binKeys.length) {
+                    binPath = (0, path_1.resolve)(pkgLocation, bin[binKeys[0]]);
+                }
+            }
+        }
+        if (!binPath) {
+            throw new Error(`Cannot locate bin for temporary package: ${packageNameNoVersion}.`);
+        }
+        const { status, error } = (0, child_process_1.spawnSync)(process.execPath, [binPath, ...args], {
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                NG_DISABLE_VERSION_CHECK: 'true',
+                NG_CLI_ANALYTICS: 'false',
+            },
+        });
+        if (status === null && error) {
+            throw error;
+        }
+        return status !== null && status !== void 0 ? status : 0;
+    }
 }
 exports.UpdateCommandModule = UpdateCommandModule;
 UpdateCommandModule.scope = command_module_1.CommandScope.In;

package/src/commands/update/schematic/index.js

@@ -286,6 +286,7 @@ function _getUpdateMetadata(packageJson, logger) {
         }
         else if (typeof packageGroup == 'object' &&
             packageGroup &&
+            !Array.isArray(packageGroup) &&
             Object.values(packageGroup).every((x) => typeof x == 'string')) {
             result.packageGroup = packageGroup;
         }
@@ -362,23 +363,26 @@ function _usageMessage(options, infoMap, logger) {
     })
         .filter(({ info, version, target }) => (target === null || target === void 0 ? void 0 : target['ng-update']) && semver.compare(info.installed.version, version) < 0)
         .map(({ name, info, version, tag, target }) => {
-        var _a;
+        var _a, _b, _c;
         // Look for packageGroup.
-        const packageGroup = target['ng-update']['packageGroup'];
+        const packageGroup = (_a = target['ng-update']) === null || _a === void 0 ? void 0 : _a['packageGroup'];
         if (packageGroup) {
-            const packageGroupName = target['ng-update']['packageGroupName'] || packageGroup[0];
+            const packageGroupNames = Array.isArray(packageGroup)
+                ? packageGroup
+                : Object.keys(packageGroup);
+            const packageGroupName = ((_b = target['ng-update']) === null || _b === void 0 ? void 0 : _b['packageGroupName']) || packageGroupNames[0];
             if (packageGroupName) {
                 if (packageGroups.has(name)) {
                     return null;
                 }
-                packageGroup.forEach((x) => packageGroups.set(x, packageGroupName));
+                packageGroupNames.forEach((x) => packageGroups.set(x, packageGroupName));
                 packageGroups.set(packageGroupName, packageGroupName);
                 name = packageGroupName;
             }
         }
         let command = `ng update ${name}`;
         if (!tag) {
-            command += `@${((_a = semver.parse(version)) === null || _a === void 0 ? void 0 : _a.major) || version}`;
+            command += `@${((_c = semver.parse(version)) === null || _c === void 0 ? void 0 : _c.major) || version}`;
         }
         else if (tag == 'next') {
             command += ' --next';
@@ -508,29 +512,34 @@ function _addPackageGroup(tree, packages, allDependencies, npmPackageJson, logge
     if (!ngUpdateMetadata) {
         return;
     }
-    let packageGroup = ngUpdateMetadata['packageGroup'];
+    const packageGroup = ngUpdateMetadata['packageGroup'];
     if (!packageGroup) {
         return;
     }
+    let packageGroupNormalized = {};
     if (Array.isArray(packageGroup) && !packageGroup.some((x) => typeof x != 'string')) {
-        packageGroup = packageGroup.reduce((acc, curr) => {
+        packageGroupNormalized = packageGroup.reduce((acc, curr) => {
             acc[curr] = maybePackage;
             return acc;
         }, {});
     }
-    // Only need to check if it's an object because we set it right the time before.
-    if (typeof packageGroup != 'object' ||
-        packageGroup === null ||
-        Object.values(packageGroup).some((v) => typeof v != 'string')) {
-        logger.warn(`packageGroup metadata of package ${npmPackageJson.name} is malformed.`);
+    else if (typeof packageGroup == 'object' &&
+        packageGroup &&
+        !Array.isArray(packageGroup) &&
+        Object.values(packageGroup).every((x) => typeof x == 'string')) {
+        packageGroupNormalized = packageGroup;
+    }
+    else {
+        logger.warn(`packageGroup metadata of package ${npmPackageJson.name} is malformed. Ignoring.`);
         return;
     }
-    Object.keys(packageGroup)
-        .filter((name) => !packages.has(name)) // Don't override names from the command line.
-        .filter((name) => allDependencies.has(name)) // Remove packages that aren't installed.
-        .forEach((name) => {
-        packages.set(name, packageGroup[name]);
-    });
+    for (const [name, value] of Object.entries(packageGroupNormalized)) {
+        // Don't override names from the command line.
+        // Remove packages that aren't installed.
+        if (!packages.has(name) && allDependencies.has(name)) {
+            packages.set(name, value);
+        }
+    }
 }
 /**
  * Add peer dependencies of packages on the command line to the list of packages to update.

package/src/commands/version/cli.d.ts

@@ -15,5 +15,4 @@ export declare class VersionCommandModule extends CommandModule implements Comma
     builder(localYargs: Argv): Argv;
     run(): Promise<void>;
     private getVersion;
-    private getPackageManagerVersion;
 }

package/src/commands/version/cli.js

@@ -11,7 +11,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VersionCommandModule = void 0;
-const child_process_1 = require("child_process");
 const module_1 = __importDefault(require("module"));
 const path_1 = require("path");
 const command_module_1 = require("../../command-builder/command-module");
@@ -43,10 +42,11 @@ class VersionCommandModule extends command_module_1.CommandModule {
         return localYargs;
     }
     async run() {
-        const logger = this.context.logger;
+        var _a;
+        const { packageManager, logger, root } = this.context;
         const localRequire = module_1.default.createRequire((0, path_1.resolve)(__filename, '../../../'));
         // Trailing slash is used to allow the path to be treated as a directory
-        const workspaceRequire = module_1.default.createRequire(this.context.root + '/');
+        const workspaceRequire = module_1.default.createRequire(root + '/');
         const cliPackage = localRequire('./package.json');
         let workspacePackage;
         try {
@@ -100,7 +100,7 @@ class VersionCommandModule extends command_module_1.CommandModule {
         logger.info(`
       Angular CLI: ${ngCliVersion}
       Node: ${process.versions.node}${unsupportedNodeVersion ? ' (Unsupported)' : ''}
-      Package Manager: ${this.getPackageManagerVersion()}
+      Package Manager: ${packageManager.name} ${(_a = packageManager.version) !== null && _a !== void 0 ? _a : '<error>'} 
       OS: ${process.platform} ${process.arch}
 
       Angular: ${angularCoreVersion}
@@ -157,24 +157,5 @@ class VersionCommandModule extends command_module_1.CommandModule {
         }
         return '<error>';
     }
-    getPackageManagerVersion() {
-        try {
-            const manager = this.context.packageManager;
-            const version = (0, child_process_1.execSync)(`${manager} --version`, {
-                encoding: 'utf8',
-                stdio: ['ignore', 'pipe', 'ignore'],
-                env: {
-                    ...process.env,
-                    //  NPM updater notifier will prevents the child process from closing until it timeout after 3 minutes.
-                    NO_UPDATE_NOTIFIER: '1',
-                    NPM_CONFIG_UPDATE_NOTIFIER: 'false',
-                },
-            }).trim();
-            return `${manager} ${version}`;
-        }
-        catch {
-            return '<error>';
-        }
-    }
 }
 exports.VersionCommandModule = VersionCommandModule;

package/src/typings-bazel.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @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
+ */
+
+/* eslint-disable import/no-extraneous-dependencies */
+// Workaround for https://github.com/bazelbuild/rules_nodejs/issues/1033
+// Alternative approach instead of https://github.com/angular/angular/pull/33226
+declare module '@yarnpkg/lockfile' {
+  export * from '@types/yarnpkg__lockfile';
+}

package/src/typings.d.ts

@@ -5,20 +5,7 @@
  * 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
  */
-declare module '@yarnpkg/lockfile' {
-    function parse(data: string): Record<string, any>;
-}
-declare module 'ini' {
-    function parse(data: string): Record<string, any>;
-}
 declare module 'npm-pick-manifest' {
     function pickManifest(metadata: import('./utilities/package-metadata').PackageMetadata, selector: string): import('./utilities/package-metadata').PackageManifest;
     export = pickManifest;
 }
-declare module 'pacote' {
-    function manifest(specifier: string, options: Record<string, unknown>): Promise<{
-        name: string;
-        version: string;
-    }>;
-    function packument(specifier: string, options: Record<string, unknown>): Promise<import('./utilities/package-metadata').NpmRepositoryPackageJson>;
-}

package/src/utilities/config.d.ts

@@ -10,17 +10,18 @@ import { PackageManager } from '../../lib/config/workspace-schema';
 import { JSONFile } from './json-file';
 export declare const workspaceSchemaPath: string;
 export declare class AngularWorkspace {
-    private workspace;
+    private readonly workspace;
     readonly filePath: string;
     readonly basePath: string;
     constructor(workspace: workspaces.WorkspaceDefinition, filePath: string);
     get extensions(): Record<string, json.JsonValue | undefined>;
     get projects(): workspaces.ProjectDefinitionCollection;
-    getCli(): Record<string, any>;
-    getProjectCli(projectName: string): Record<string, any>;
+    getCli(): Record<string, any> | undefined;
+    getProjectCli(projectName: string): Record<string, any> | undefined;
+    save(): Promise<void>;
     static load(workspaceFilePath: string): Promise<AngularWorkspace>;
 }
-export declare function getWorkspace(level?: 'local' | 'global'): Promise<AngularWorkspace | null>;
+export declare function getWorkspace(level?: 'local' | 'global'): Promise<AngularWorkspace | undefined>;
 export declare function createGlobalSettings(): string;
 export declare function getWorkspaceRaw(level?: 'local' | 'global'): [JSONFile | null, string | null];
 export declare function validateWorkspace(data: json.JsonObject): Promise<void>;
@@ -28,4 +29,3 @@ export declare function getProjectByCwd(workspace: AngularWorkspace): string | n
 export declare function getConfiguredPackageManager(): Promise<PackageManager | null>;
 export declare function getSchematicDefaults(collection: string, schematic: string, project?: string | null): Promise<{}>;
 export declare function isWarningEnabled(warning: string): Promise<boolean>;
-export declare function getProjectsByPath(workspace: workspaces.WorkspaceDefinition, cwd: string, root: string): string[];

package/src/utilities/config.js

@@ -30,7 +30,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProjectsByPath = exports.isWarningEnabled = exports.getSchematicDefaults = exports.getConfiguredPackageManager = exports.getProjectByCwd = exports.validateWorkspace = exports.getWorkspaceRaw = exports.createGlobalSettings = exports.getWorkspace = exports.AngularWorkspace = exports.workspaceSchemaPath = void 0;
+exports.isWarningEnabled = exports.getSchematicDefaults = exports.getConfiguredPackageManager = exports.getProjectByCwd = exports.validateWorkspace = exports.getWorkspaceRaw = exports.createGlobalSettings = exports.getWorkspace = exports.AngularWorkspace = exports.workspaceSchemaPath = void 0;
 const core_1 = require("@angular-devkit/core");
 const fs_1 = require("fs");
 const os = __importStar(require("os"));
@@ -42,15 +42,16 @@ function isJsonObject(value) {
 }
 function createWorkspaceHost() {
     return {
-        async readFile(path) {
-            return (0, fs_1.readFileSync)(path, 'utf-8');
+        readFile(path) {
+            return fs_1.promises.readFile(path, 'utf-8');
         },
         async writeFile(path, data) {
-            (0, fs_1.writeFileSync)(path, data);
+            await fs_1.promises.writeFile(path, data);
         },
         async isDirectory(path) {
             try {
-                return (0, fs_1.statSync)(path).isDirectory();
+                const stats = await fs_1.promises.stat(path);
+                return stats.isDirectory();
             }
             catch {
                 return false;
@@ -58,7 +59,8 @@ function createWorkspaceHost() {
         },
         async isFile(path) {
             try {
-                return (0, fs_1.statSync)(path).isFile();
+                const stats = await fs_1.promises.stat(path);
+                return stats.isFile();
             }
             catch {
                 return false;
@@ -132,12 +134,15 @@ class AngularWorkspace {
     // Temporary helper functions to support refactoring
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     getCli() {
-        return this.workspace.extensions['cli'] || {};
+        return this.workspace.extensions['cli'];
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     getProjectCli(projectName) {
         const project = this.workspace.projects.get(projectName);
-        return (project === null || project === void 0 ? void 0 : project.extensions['cli']) || {};
+        return project === null || project === void 0 ? void 0 : project.extensions['cli'];
+    }
+    save() {
+        return core_1.workspaces.writeWorkspace(this.workspace, createWorkspaceHost(), this.filePath);
     }
     static async load(workspaceFilePath) {
         const result = await core_1.workspaces.readWorkspace(workspaceFilePath, createWorkspaceHost(), core_1.workspaces.WorkspaceFormat.JSON);
@@ -147,14 +152,16 @@ class AngularWorkspace {
 exports.AngularWorkspace = AngularWorkspace;
 const cachedWorkspaces = new Map();
 async function getWorkspace(level = 'local') {
-    const cached = cachedWorkspaces.get(level);
-    if (cached !== undefined) {
-        return cached;
+    if (cachedWorkspaces.has(level)) {
+        return cachedWorkspaces.get(level);
     }
-    const configPath = level === 'local' ? projectFilePath() : globalFilePath();
+    let configPath = level === 'local' ? projectFilePath() : globalFilePath();
     if (!configPath) {
-        cachedWorkspaces.set(level, null);
-        return null;
+        if (level === 'local') {
+            cachedWorkspaces.set(level, undefined);
+            return undefined;
+        }
+        configPath = createGlobalSettings();
     }
     try {
         const workspace = await AngularWorkspace.load(configPath);
@@ -237,6 +244,7 @@ function findProjectByPath(workspace, location) {
     }
     return projects[0][1];
 }
+let defaultProjectDeprecationWarningShown = false;
 function getProjectByCwd(workspace) {
     if (workspace.projects.size === 1) {
         // If there is only one project, return that one.
@@ -249,6 +257,11 @@ function getProjectByCwd(workspace) {
     const defaultProject = workspace.extensions['defaultProject'];
     if (defaultProject && typeof defaultProject === 'string') {
         // If there is a default project name, return it.
+        if (!defaultProjectDeprecationWarningShown) {
+            console.warn(`DEPRECATED: The 'defaultProject' workspace option has been deprecated. ` +
+                `The project to use will be determined from the current working directory.`);
+            defaultProjectDeprecationWarningShown = true;
+        }
         return defaultProject;
     }
     return null;
@@ -341,33 +354,3 @@ async function isWarningEnabled(warning) {
     return result !== null && result !== void 0 ? result : true;
 }
 exports.isWarningEnabled = isWarningEnabled;
-function getProjectsByPath(workspace, cwd, root) {
-    if (workspace.projects.size === 1) {
-        return Array.from(workspace.projects.keys());
-    }
-    const isInside = (base, potential) => {
-        const absoluteBase = path.resolve(root, base);
-        const absolutePotential = path.resolve(root, potential);
-        const relativePotential = path.relative(absoluteBase, absolutePotential);
-        if (!relativePotential.startsWith('..') && !path.isAbsolute(relativePotential)) {
-            return true;
-        }
-        return false;
-    };
-    const projects = Array.from(workspace.projects.entries())
-        .map(([name, project]) => [path.resolve(root, project.root), name])
-        .filter((tuple) => isInside(tuple[0], cwd))
-        // Sort tuples by depth, with the deeper ones first. Since the first member is a path and
-        // we filtered all invalid paths, the longest will be the deepest (and in case of equality
-        // the sort is stable and the first declared project will win).
-        .sort((a, b) => b[0].length - a[0].length);
-    if (projects.length === 1) {
-        return [projects[0][1]];
-    }
-    else if (projects.length > 1) {
-        const firstPath = projects[0][0];
-        return projects.filter((v) => v[0] === firstPath).map((v) => v[1]);
-    }
-    return [];
-}
-exports.getProjectsByPath = getProjectsByPath;

package/src/{analytics/analytics-environment-options.d.ts → utilities/environment-options.d.ts}

@@ -7,3 +7,6 @@
  */
 export declare const analyticsDisabled: boolean;
 export declare const analyticsShareDisabled: boolean;
+export declare const isCI: boolean;
+export declare const disableVersionCheck: boolean;
+export declare const ngDebug: boolean;

package/src/utilities/environment-options.js

@@ -0,0 +1,24 @@
+"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.ngDebug = exports.disableVersionCheck = exports.isCI = exports.analyticsShareDisabled = exports.analyticsDisabled = void 0;
+function isPresent(variable) {
+    return typeof variable === 'string' && variable !== '';
+}
+function isDisabled(variable) {
+    return isPresent(variable) && (variable === '0' || variable.toLowerCase() === 'false');
+}
+function isEnabled(variable) {
+    return isPresent(variable) && (variable === '1' || variable.toLowerCase() === 'true');
+}
+exports.analyticsDisabled = isDisabled(process.env['NG_CLI_ANALYTICS']);
+exports.analyticsShareDisabled = isDisabled(process.env['NG_CLI_ANALYTICS_SHARE']);
+exports.isCI = isEnabled(process.env['CI']);
+exports.disableVersionCheck = isEnabled(process.env['NG_DISABLE_VERSION_CHECK']);
+exports.ngDebug = isEnabled(process.env['NG_DEBUG']);

package/src/utilities/memoize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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
+ */
+/**
+ * A decorator that memoizes methods and getters.
+ *
+ * **Note**: Be cautious where and how to use this decorator as the size of the cache will grow unbounded.
+ *
+ * @see https://en.wikipedia.org/wiki/Memoization
+ */
+export declare function memoize<T>(target: Object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<T>): TypedPropertyDescriptor<T>;

package/src/utilities/memoize.js

@@ -0,0 +1,69 @@
+"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.memoize = void 0;
+/**
+ * A decorator that memoizes methods and getters.
+ *
+ * **Note**: Be cautious where and how to use this decorator as the size of the cache will grow unbounded.
+ *
+ * @see https://en.wikipedia.org/wiki/Memoization
+ */
+function memoize(target, propertyKey, descriptor) {
+    const descriptorPropertyName = descriptor.get ? 'get' : 'value';
+    const originalMethod = descriptor[descriptorPropertyName];
+    if (typeof originalMethod !== 'function') {
+        throw new Error('Memoize decorator can only be used on methods or get accessors.');
+    }
+    const cache = new Map();
+    return {
+        ...descriptor,
+        [descriptorPropertyName]: function (...args) {
+            for (const arg of args) {
+                if (!isJSONSerializable(arg)) {
+                    throw new Error(`Argument ${isNonPrimitive(arg) ? arg.toString() : arg} is JSON serializable.`);
+                }
+            }
+            const key = JSON.stringify(args);
+            if (cache.has(key)) {
+                return cache.get(key);
+            }
+            const result = originalMethod.apply(this, args);
+            cache.set(key, result);
+            return result;
+        },
+    };
+}
+exports.memoize = memoize;
+/** Method to check if value is a non primitive. */
+function isNonPrimitive(value) {
+    return ((value !== null && typeof value === 'object') ||
+        typeof value === 'function' ||
+        typeof value === 'symbol');
+}
+/** Method to check if the values are JSON serializable */
+function isJSONSerializable(value) {
+    if (!isNonPrimitive(value)) {
+        // Can be seralized since it's a primitive.
+        return true;
+    }
+    let nestedValues;
+    if (Array.isArray(value)) {
+        // It's an array, check each item.
+        nestedValues = value;
+    }
+    else if (Object.prototype.toString.call(value) === '[object Object]') {
+        // It's a plain object, check each value.
+        nestedValues = Object.values(value);
+    }
+    if (!nestedValues || nestedValues.some((v) => !isJSONSerializable(v))) {
+        return false;
+    }
+    return true;
+}