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

package/src/command-builder/schematics-command-module.js

@@ -6,27 +6,48 @@
  * 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
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchematicsCommandModule = void 0;
+exports.SchematicsCommandModule = exports.DEFAULT_SCHEMATICS_COLLECTION = void 0;
 const core_1 = require("@angular-devkit/core");
 const schematics_1 = require("@angular-devkit/schematics");
 const tools_1 = require("@angular-devkit/schematics/tools");
-const inquirer_1 = __importDefault(require("inquirer"));
 const config_1 = require("../utilities/config");
 const tty_1 = require("../utilities/tty");
 const command_module_1 = require("./command-module");
 const json_schema_1 = require("./utilities/json-schema");
 const schematic_engine_host_1 = require("./utilities/schematic-engine-host");
 const schematic_workflow_1 = require("./utilities/schematic-workflow");
-const DEFAULT_SCHEMATICS_COLLECTION = '@schematics/angular';
+exports.DEFAULT_SCHEMATICS_COLLECTION = '@schematics/angular';
 class SchematicsCommandModule extends command_module_1.CommandModule {
     constructor() {
         super(...arguments);
         this.allowPrivateSchematics = false;
         this.shouldReportAnalytics = false;
+        this._workflowForBuilder = new Map();
+        this.defaultProjectDeprecationWarningShown = false;
     }
     async builder(argv) {
         return argv
@@ -62,13 +83,16 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
         return (0, json_schema_1.parseJsonSchemaToOptions)(workflow.registry, schemaJson);
     }
     getOrCreateWorkflowForBuilder(collectionName) {
-        if (this._workflowForBuilder) {
-            return this._workflowForBuilder;
+        const cached = this._workflowForBuilder.get(collectionName);
+        if (cached) {
+            return cached;
         }
-        return (this._workflowForBuilder = new tools_1.NodeWorkflow(this.context.root, {
+        const workflow = new tools_1.NodeWorkflow(this.context.root, {
             resolvePaths: this.getResolvePaths(collectionName),
             engineHostCreator: (options) => new schematic_engine_host_1.SchematicEngineHost(options.resolvePaths),
-        }));
+        });
+        this._workflowForBuilder.set(collectionName, workflow);
+        return workflow;
     }
     async getOrCreateWorkflowForExecution(collectionName, options) {
         if (this._workflowForExecution) {
@@ -79,7 +103,7 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
         const workflow = new tools_1.NodeWorkflow(root, {
             force,
             dryRun,
-            packageManager,
+            packageManager: packageManager.name,
             // A schema registry is required to allow customizing addUndefinedDefaults
             registry: new core_1.schema.CoreSchemaRegistry(schematics_1.formats.standardFormats),
             packageRegistry,
@@ -118,7 +142,7 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
             return options;
         });
         if (options.interactive !== false && (0, tty_1.isTTY)()) {
-            workflow.registry.usePromptProvider((definitions) => {
+            workflow.registry.usePromptProvider(async (definitions) => {
                 const questions = definitions
                     .filter((definition) => !options.defaults || definition.default === undefined)
                     .map((definition) => {
@@ -177,35 +201,53 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
                     }
                     return question;
                 });
-                return inquirer_1.default.prompt(questions);
+                if (questions.length) {
+                    const { prompt } = await Promise.resolve().then(() => __importStar(require('inquirer')));
+                    return prompt(questions);
+                }
+                else {
+                    return {};
+                }
             });
         }
         return (this._workflowForExecution = workflow);
     }
-    async getDefaultSchematicCollection() {
-        if (this._defaultSchematicCollection) {
-            return this._defaultSchematicCollection;
+    async getSchematicCollections() {
+        var _a;
+        if (this._schematicCollections) {
+            return this._schematicCollections;
         }
-        let workspace = await (0, config_1.getWorkspace)('local');
+        const getSchematicCollections = (configSection) => {
+            if (!configSection) {
+                return undefined;
+            }
+            const { schematicCollections, defaultCollection } = configSection;
+            if (Array.isArray(schematicCollections)) {
+                return new Set(schematicCollections);
+            }
+            else if (typeof defaultCollection === 'string') {
+                return new Set([defaultCollection]);
+            }
+            return undefined;
+        };
+        const { workspace, globalConfiguration } = this.context;
         if (workspace) {
             const project = (0, config_1.getProjectByCwd)(workspace);
             if (project) {
-                const value = workspace.getProjectCli(project)['defaultCollection'];
-                if (typeof value == 'string') {
-                    return (this._defaultSchematicCollection = value);
+                const value = getSchematicCollections(workspace.getProjectCli(project));
+                if (value) {
+                    this._schematicCollections = value;
+                    return value;
                 }
             }
-            const value = workspace.getCli()['defaultCollection'];
-            if (typeof value === 'string') {
-                return (this._defaultSchematicCollection = value);
-            }
         }
-        workspace = await (0, config_1.getWorkspace)('global');
-        const value = workspace === null || workspace === void 0 ? void 0 : workspace.getCli()['defaultCollection'];
-        if (typeof value === 'string') {
-            return (this._defaultSchematicCollection = value);
+        const value = (_a = getSchematicCollections(workspace === null || workspace === void 0 ? void 0 : workspace.getCli())) !== null && _a !== void 0 ? _a : getSchematicCollections(globalConfiguration === null || globalConfiguration === void 0 ? void 0 : globalConfiguration.getCli());
+        if (value) {
+            this._schematicCollections = value;
+            return value;
         }
-        return (this._defaultSchematicCollection = DEFAULT_SCHEMATICS_COLLECTION);
+        this._schematicCollections = new Set([exports.DEFAULT_SCHEMATICS_COLLECTION]);
+        return this._schematicCollections;
     }
     parseSchematicInfo(schematic) {
         if (schematic === null || schematic === void 0 ? void 0 : schematic.includes(':')) {
@@ -260,22 +302,20 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
         if (!workspace) {
             return undefined;
         }
-        const projectNames = (0, config_1.getProjectsByPath)(workspace, process.cwd(), workspace.basePath);
-        if (projectNames.length === 1) {
-            return projectNames[0];
+        const projectName = (0, config_1.getProjectByCwd)(workspace);
+        if (projectName) {
+            return projectName;
         }
-        else {
-            if (projectNames.length > 1) {
+        const defaultProjectName = workspace.extensions['defaultProject'];
+        if (typeof defaultProjectName === 'string' && defaultProjectName) {
+            if (!this.defaultProjectDeprecationWarningShown) {
                 logger.warn(core_1.tags.oneLine `
-            Two or more projects are using identical roots.
-            Unable to determine project using current working directory.
-            Using default workspace project instead.
+            DEPRECATED: The 'defaultProject' workspace option has been deprecated.
+            The project to use will be determined from the current working directory.
           `);
+                this.defaultProjectDeprecationWarningShown = true;
             }
-            const defaultProjectName = workspace.extensions['defaultProject'];
-            if (typeof defaultProjectName === 'string' && defaultProjectName) {
-                return defaultProjectName;
-            }
+            return defaultProjectName;
         }
         return undefined;
     }
@@ -283,7 +323,7 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
         const { workspace, root } = this.context;
         return workspace
             ? // Workspace
-                collectionName === DEFAULT_SCHEMATICS_COLLECTION
+                collectionName === exports.DEFAULT_SCHEMATICS_COLLECTION
                     ? // Favor __dirname for @schematics/angular to use the build-in version
                         [__dirname, process.cwd(), root]
                     : [process.cwd(), root, __dirname]

package/src/commands/add/cli.js

@@ -20,8 +20,6 @@ const workspace_schema_1 = require("../../../lib/config/workspace-schema");
 const analytics_1 = require("../../analytics/analytics");
 const schematics_command_module_1 = require("../../command-builder/schematics-command-module");
 const color_1 = require("../../utilities/color");
-const install_package_1 = require("../../utilities/install-package");
-const package_manager_1 = require("../../utilities/package-manager");
 const package_metadata_1 = require("../../utilities/package-metadata");
 const prompt_1 = require("../../utilities/prompt");
 const spinner_1 = require("../../utilities/spinner");
@@ -84,9 +82,9 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
     // eslint-disable-next-line max-lines-per-function
     async run(options) {
         var _a;
-        const { root, logger, packageManager } = this.context;
+        const { logger, packageManager } = this.context;
         const { verbose, registry, collection, skipConfirmation } = options;
-        await (0, package_manager_1.ensureCompatibleNpm)(root);
+        packageManager.ensureCompatibility();
         let packageIdentifier;
         try {
             packageIdentifier = (0, npm_package_arg_1.default)(collection);
@@ -107,8 +105,8 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
         }
         const spinner = new spinner_1.Spinner();
         spinner.start('Determining package manager...');
-        const usingYarn = packageManager === workspace_schema_1.PackageManager.Yarn;
-        spinner.info(`Using package manager: ${color_1.colors.grey(packageManager)}`);
+        const usingYarn = packageManager.name === workspace_schema_1.PackageManager.Yarn;
+        spinner.info(`Using package manager: ${color_1.colors.grey(packageManager.name)}`);
         if (packageIdentifier.name && packageIdentifier.type === 'tag' && !packageIdentifier.rawSpec) {
             // only package name provided; search for viable version
             // plus special cases for packages that did not have peer deps setup
@@ -131,7 +129,8 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
                 packageIdentifier = npm_package_arg_1.default.resolve(latestManifest.name, latestManifest.version);
             }
             // Adjust the version based on name and peer dependencies
-            if (latestManifest && Object.keys(latestManifest.peerDependencies).length === 0) {
+            if ((latestManifest === null || latestManifest === void 0 ? void 0 : latestManifest.peerDependencies) &&
+                Object.keys(latestManifest.peerDependencies).length === 0) {
                 spinner.succeed(`Found compatible package version: ${color_1.colors.grey(packageIdentifier.toString())}.`);
             }
             else if (!latestManifest || (await this.hasMismatchedPeer(latestManifest))) {
@@ -210,19 +209,19 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
         if (savePackage === false) {
             // Temporary packages are located in a different directory
             // Hence we need to resolve them using the temp path
-            const { status, tempNodeModules } = await (0, install_package_1.installTempPackage)(packageIdentifier.raw, packageManager, registry ? [`--registry="${registry}"`] : undefined);
+            const { success, tempNodeModules } = await packageManager.installTemp(packageIdentifier.raw, registry ? [`--registry="${registry}"`] : undefined);
             const resolvedCollectionPath = require.resolve((0, path_1.join)(collectionName, 'package.json'), {
                 paths: [tempNodeModules],
             });
-            if (status !== 0) {
-                return status;
+            if (!success) {
+                return 1;
             }
             collectionName = (0, path_1.dirname)(resolvedCollectionPath);
         }
         else {
-            const status = await (0, install_package_1.installPackage)(packageIdentifier.raw, packageManager, savePackage, registry ? [`--registry="${registry}"`] : undefined);
-            if (status !== 0) {
-                return status;
+            const success = await packageManager.install(packageIdentifier.raw, savePackage, registry ? [`--registry="${registry}"`] : undefined);
+            if (!success) {
+                return 1;
             }
         }
         return this.executeSchematic({ ...options, collection: collectionName });
@@ -301,6 +300,7 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
         }
     }
     async findProjectVersion(name) {
+        var _a, _b;
         const { logger, root } = this.context;
         let installedPackage;
         try {
@@ -322,7 +322,7 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
         }
         catch { }
         if (projectManifest) {
-            const version = projectManifest.dependencies[name] || projectManifest.devDependencies[name];
+            const version = ((_a = projectManifest.dependencies) === null || _a === void 0 ? void 0 : _a[name]) || ((_b = projectManifest.devDependencies) === null || _b === void 0 ? void 0 : _b[name]);
             if (version) {
                 return version;
             }

package/src/commands/add/long-description.md

@@ -1,10 +1,7 @@
 Adds the npm package for a published library to your workspace, and configures
-the project in the current working directory (or the default project if you are
-not in a project directory) to use that library, as specified by the library's schematic.
+the project in the current working directory to use that library, as specified by the library's schematic.
 For example, adding `@angular/pwa` configures your project for PWA support:
 
 ```bash
 ng add @angular/pwa
 ```
-
-The default project is the value of `defaultProject` in `angular.json`.

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

@@ -10,7 +10,7 @@ import { CommandModule, CommandModuleImplementation, Options } from '../../comma
 export declare class AnalyticsCommandModule extends CommandModule implements CommandModuleImplementation {
     command: string;
     describe: string;
-    longDescriptionPath?: string | undefined;
+    longDescriptionPath?: string;
     builder(localYargs: Argv): Argv;
     run(_options: Options<{}>): void;
 }

package/src/commands/analytics/info/cli.d.ts

@@ -10,7 +10,7 @@ import { CommandModule, CommandModuleImplementation, Options } from '../../../co
 export declare class AnalyticsInfoCommandModule extends CommandModule implements CommandModuleImplementation {
     command: string;
     describe: string;
-    longDescriptionPath?: string | undefined;
+    longDescriptionPath?: string;
     builder(localYargs: Argv): Argv;
     run(_options: Options<{}>): Promise<void>;
 }

package/src/commands/analytics/settings/cli.d.ts

@@ -11,7 +11,7 @@ interface AnalyticsCommandArgs {
     global: boolean;
 }
 declare abstract class AnalyticsSettingModule extends CommandModule<AnalyticsCommandArgs> implements CommandModuleImplementation<AnalyticsCommandArgs> {
-    longDescriptionPath?: string | undefined;
+    longDescriptionPath?: string;
     builder(localYargs: Argv): Argv<AnalyticsCommandArgs>;
     abstract run({ global }: Options<AnalyticsCommandArgs>): Promise<void>;
 }

package/src/commands/cache/clean/cli.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @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 { Argv } from 'yargs';
+import { CommandModule, CommandModuleImplementation, CommandScope } from '../../../command-builder/command-module';
+export declare class CacheCleanModule extends CommandModule implements CommandModuleImplementation {
+    command: string;
+    describe: string;
+    longDescriptionPath: string | undefined;
+    static scope: CommandScope.In;
+    builder(localYargs: Argv): Argv;
+    run(): Promise<void>;
+}

package/src/commands/cache/clean/cli.js

@@ -0,0 +1,32 @@
+"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.CacheCleanModule = void 0;
+const fs_1 = require("fs");
+const command_module_1 = require("../../../command-builder/command-module");
+const utilities_1 = require("../utilities");
+class CacheCleanModule extends command_module_1.CommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'clean';
+        this.describe = 'Deletes persistent disk cache from disk.';
+    }
+    builder(localYargs) {
+        return localYargs.strict();
+    }
+    run() {
+        const { path } = (0, utilities_1.getCacheConfig)(this.context.workspace);
+        return fs_1.promises.rm(path, {
+            force: true,
+            recursive: true,
+            maxRetries: 3,
+        });
+    }
+}
+exports.CacheCleanModule = CacheCleanModule;

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

@@ -0,0 +1,17 @@
+/**
+ * @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 { Argv } from 'yargs';
+import { CommandModule, CommandModuleImplementation, CommandScope, Options } from '../../command-builder/command-module';
+export declare class CacheCommandModule extends CommandModule implements CommandModuleImplementation {
+    command: string;
+    describe: string;
+    longDescriptionPath: string;
+    static scope: CommandScope.In;
+    builder(localYargs: Argv): Argv;
+    run(_options: Options<{}>): void;
+}

package/src/commands/cache/cli.js

@@ -0,0 +1,38 @@
+"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.CacheCommandModule = void 0;
+const path_1 = require("path");
+const command_module_1 = require("../../command-builder/command-module");
+const command_1 = require("../../command-builder/utilities/command");
+const cli_1 = require("./clean/cli");
+const cli_2 = require("./info/cli");
+const cli_3 = require("./settings/cli");
+class CacheCommandModule extends command_module_1.CommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'cache';
+        this.describe = 'Configure persistent disk cache and retrieve cache statistics.';
+        this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');
+    }
+    builder(localYargs) {
+        const subcommands = [
+            cli_3.CacheEnableModule,
+            cli_3.CacheDisableModule,
+            cli_1.CacheCleanModule,
+            cli_2.CacheInfoCommandModule,
+        ].sort();
+        for (const module of subcommands) {
+            localYargs = (0, command_1.addCommandModuleToYargs)(localYargs, module, this.context);
+        }
+        return localYargs.demandCommand(1, command_1.demandCommandFailureMessage).strict();
+    }
+    run(_options) { }
+}
+exports.CacheCommandModule = CacheCommandModule;

package/src/commands/cache/info/cli.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @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 { Argv } from 'yargs';
+import { CommandModule, CommandModuleImplementation, CommandScope } from '../../../command-builder/command-module';
+export declare class CacheInfoCommandModule extends CommandModule implements CommandModuleImplementation {
+    command: string;
+    describe: string;
+    longDescriptionPath?: string | undefined;
+    static scope: CommandScope.In;
+    builder(localYargs: Argv): Argv;
+    run(): Promise<void>;
+    private getSizeOfDirectory;
+    private formatSize;
+    private effectiveEnabledStatus;
+}

package/src/commands/cache/info/cli.js

@@ -0,0 +1,82 @@
+"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.CacheInfoCommandModule = void 0;
+const core_1 = require("@angular-devkit/core");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const command_module_1 = require("../../../command-builder/command-module");
+const environment_options_1 = require("../../../utilities/environment-options");
+const utilities_1 = require("../utilities");
+class CacheInfoCommandModule extends command_module_1.CommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'info';
+        this.describe = 'Prints persistent disk cache configuration and statistics in the console.';
+    }
+    builder(localYargs) {
+        return localYargs.strict();
+    }
+    async run() {
+        const { path, environment, enabled } = (0, utilities_1.getCacheConfig)(this.context.workspace);
+        this.context.logger.info(core_1.tags.stripIndents `
+      Enabled: ${enabled ? 'yes' : 'no'}
+      Environment: ${environment}
+      Path: ${path}
+      Size on disk: ${await this.getSizeOfDirectory(path)}
+      Effective status on current machine: ${this.effectiveEnabledStatus() ? 'enabled' : 'disabled'}
+    `);
+    }
+    async getSizeOfDirectory(path) {
+        const directoriesStack = [path];
+        let size = 0;
+        while (directoriesStack.length) {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            const dirPath = directoriesStack.pop();
+            let entries = [];
+            try {
+                entries = await fs_1.promises.readdir(dirPath);
+            }
+            catch { }
+            for (const entry of entries) {
+                const entryPath = (0, path_1.join)(dirPath, entry);
+                const stats = await fs_1.promises.stat(entryPath);
+                if (stats.isDirectory()) {
+                    directoriesStack.push(entryPath);
+                }
+                size += stats.size;
+            }
+        }
+        return this.formatSize(size);
+    }
+    formatSize(size) {
+        if (size <= 0) {
+            return '0 bytes';
+        }
+        const abbreviations = ['bytes', 'kB', 'MB', 'GB'];
+        const index = Math.floor(Math.log(size) / Math.log(1024));
+        const roundedSize = size / Math.pow(1024, index);
+        // bytes don't have a fraction
+        const fractionDigits = index === 0 ? 0 : 2;
+        return `${roundedSize.toFixed(fractionDigits)} ${abbreviations[index]}`;
+    }
+    effectiveEnabledStatus() {
+        const { enabled, environment } = (0, utilities_1.getCacheConfig)(this.context.workspace);
+        if (enabled) {
+            switch (environment) {
+                case 'ci':
+                    return environment_options_1.isCI;
+                case 'local':
+                    return !environment_options_1.isCI;
+            }
+        }
+        return enabled;
+    }
+}
+exports.CacheInfoCommandModule = CacheInfoCommandModule;

package/src/commands/cache/long-description.md

@@ -0,0 +1,53 @@
+Angular CLI saves a number of cachable operations on disk by default.
+
+When you re-run the same build, the build system restores the state of the previous build and re-uses previously performed operations, which decreases the time taken to build and test your applications and libraries.
+
+To amend the default cache settings, add the `cli.cache` object to your [Workspace Configuration](guide/workspace-config).
+The object goes under `cli.cache` at the top level of the file, outside the `projects` sections.
+
+```jsonc
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "cli": {
+    "cache": {
+      // ...
+    }
+  },
+  "projects": {}
+}
+```
+
+For more information, see [cache options](guide/workspace-config#cache-options).
+
+### Cache environments
+
+By default, disk cache is only enabled for local environments. The value of environment can be one of the following:
+
+- `all` - allows disk cache on all machines.
+- `local` - allows disk cache only on development machines.
+- `ci` - allows disk cache only on continuous integration (Ci) systems.
+
+To change the environment setting to `all`, run the following command:
+
+```bash
+ng config cli.cache.environment all
+```
+
+For more information, see `environment` in [cache options](guide/workspace-config#cache-options).
+
+<div class="alert is-helpful">
+
+The Angular CLI checks for the presence and value of the `CI` environment variable to determine in which environment it is running.
+
+</div>
+
+### Cache path
+
+By default, `.angular/cache` is used as a base directory to store cache results.
+
+To change this path to `.cache/ng`, run the following command:
+
+```bash
+ng config cli.cache.path ".cache/ng"
+```

package/src/commands/cache/settings/cli.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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 { Argv } from 'yargs';
+import { CommandModule, CommandModuleImplementation, CommandScope } from '../../../command-builder/command-module';
+export declare class CacheDisableModule extends CommandModule implements CommandModuleImplementation {
+    command: string;
+    aliases: string;
+    describe: string;
+    longDescriptionPath: string | undefined;
+    static scope: CommandScope.In;
+    builder(localYargs: Argv): Argv;
+    run(): void;
+}
+export declare class CacheEnableModule extends CommandModule implements CommandModuleImplementation {
+    command: string;
+    aliases: string;
+    describe: string;
+    longDescriptionPath: string | undefined;
+    static scope: CommandScope.In;
+    builder(localYargs: Argv): Argv;
+    run(): void;
+}