@angular/cli 14.0.0-next.7 → 14.0.0-rc.0

package/src/command-builder/command-runner.js

@@ -17,50 +17,58 @@ const cli_1 = require("../commands/add/cli");
 const cli_2 = require("../commands/analytics/cli");
 const cli_3 = require("../commands/build/cli");
 const cli_4 = require("../commands/cache/cli");
-const cli_5 = require("../commands/config/cli");
-const cli_6 = require("../commands/deploy/cli");
-const cli_7 = require("../commands/doc/cli");
-const cli_8 = require("../commands/e2e/cli");
-const cli_9 = require("../commands/extract-i18n/cli");
-const cli_10 = require("../commands/generate/cli");
-const cli_11 = require("../commands/lint/cli");
-const cli_12 = require("../commands/make-this-awesome/cli");
-const cli_13 = require("../commands/new/cli");
-const cli_14 = require("../commands/run/cli");
-const cli_15 = require("../commands/serve/cli");
-const cli_16 = require("../commands/test/cli");
-const cli_17 = require("../commands/update/cli");
-const cli_18 = require("../commands/version/cli");
+const cli_5 = require("../commands/completion/cli");
+const cli_6 = require("../commands/config/cli");
+const cli_7 = require("../commands/deploy/cli");
+const cli_8 = require("../commands/doc/cli");
+const cli_9 = require("../commands/e2e/cli");
+const cli_10 = require("../commands/extract-i18n/cli");
+const cli_11 = require("../commands/generate/cli");
+const cli_12 = require("../commands/lint/cli");
+const cli_13 = require("../commands/make-this-awesome/cli");
+const cli_14 = require("../commands/new/cli");
+const cli_15 = require("../commands/run/cli");
+const cli_16 = require("../commands/serve/cli");
+const cli_17 = require("../commands/test/cli");
+const cli_18 = require("../commands/update/cli");
+const cli_19 = require("../commands/version/cli");
 const color_1 = require("../utilities/color");
 const config_1 = require("../utilities/config");
 const package_manager_1 = require("../utilities/package-manager");
 const command_module_1 = require("./command-module");
 const command_1 = require("./utilities/command");
 const json_help_1 = require("./utilities/json-help");
+const normalize_options_middleware_1 = require("./utilities/normalize-options-middleware");
 const COMMANDS = [
-    cli_18.VersionCommandModule,
-    cli_7.DocCommandModule,
-    cli_12.AwesomeCommandModule,
-    cli_5.ConfigCommandModule,
+    cli_19.VersionCommandModule,
+    cli_8.DocCommandModule,
+    cli_13.AwesomeCommandModule,
+    cli_6.ConfigCommandModule,
     cli_2.AnalyticsCommandModule,
     cli_1.AddCommandModule,
-    cli_10.GenerateCommandModule,
+    cli_11.GenerateCommandModule,
     cli_3.BuildCommandModule,
-    cli_8.E2eCommandModule,
-    cli_16.TestCommandModule,
-    cli_15.ServeCommandModule,
-    cli_9.ExtractI18nCommandModule,
-    cli_6.DeployCommandModule,
-    cli_11.LintCommandModule,
-    cli_13.NewCommandModule,
-    cli_17.UpdateCommandModule,
-    cli_14.RunCommandModule,
+    cli_9.E2eCommandModule,
+    cli_17.TestCommandModule,
+    cli_16.ServeCommandModule,
+    cli_10.ExtractI18nCommandModule,
+    cli_7.DeployCommandModule,
+    cli_12.LintCommandModule,
+    cli_14.NewCommandModule,
+    cli_18.UpdateCommandModule,
+    cli_15.RunCommandModule,
     cli_4.CacheCommandModule,
+    cli_5.CompletionCommandModule,
 ].sort(); // Will be sorted by class name.
 const yargsParser = helpers_1.Parser;
 async function runCommand(args, logger) {
     var _a, _b;
-    const { $0, _: positional, help = false, jsonHelp = false, ...rest } = yargsParser(args, { boolean: ['help', 'json-help'], alias: { 'collection': 'c' } });
+    const { $0, _, help = false, jsonHelp = false, getYargsCompletions = false, ...rest } = yargsParser(args, {
+        boolean: ['help', 'json-help', 'get-yargs-completions'],
+        alias: { 'collection': 'c' },
+    });
+    // When `getYargsCompletions` is true the scriptName 'ng' at index 0 is not removed.
+    const positional = getYargsCompletions ? _.slice(1) : _;
     let workspace;
     let globalConfiguration;
     try {
@@ -86,6 +94,7 @@ async function runCommand(args, logger) {
             options: {
                 help,
                 jsonHelp,
+                getYargsCompletions,
                 ...rest,
             },
         },
@@ -103,7 +112,8 @@ async function runCommand(args, logger) {
     }
     if (jsonHelp) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        localYargs.getInternalMethods().getUsageInstance().help = () => (0, json_help_1.jsonHelpUsage)();
+        const usageInstance = localYargs.getInternalMethods().getUsageInstance();
+        usageInstance.help = () => (0, json_help_1.jsonHelpUsage)();
     }
     await localYargs
         .scriptName('ng')
@@ -135,6 +145,7 @@ async function runCommand(args, logger) {
     })
         .demandCommand(1, command_1.demandCommandFailureMessage)
         .recommendCommands()
+        .middleware(normalize_options_middleware_1.normalizeOptionsMiddleware)
         .version(false)
         .showHelpOnFail(false)
         .strict()

package/src/command-builder/schematics-command-module.d.ts

@@ -27,11 +27,8 @@ export declare abstract class SchematicsCommandModule extends CommandModule<Sche
     builder(argv: Argv): Promise<Argv<SchematicsCommandArgs>>;
     /** Get schematic schema options.*/
     protected getSchematicOptions(collection: Collection<FileSystemCollectionDescription, FileSystemSchematicDescription>, schematicName: string, workflow: NodeWorkflow): Promise<Option[]>;
-    private _workflowForBuilder;
     protected getOrCreateWorkflowForBuilder(collectionName: string): NodeWorkflow;
-    private _workflowForExecution;
     protected getOrCreateWorkflowForExecution(collectionName: string, options: SchematicsExecutionOptions): Promise<NodeWorkflow>;
-    private _schematicCollections;
     protected getSchematicCollections(): Promise<Set<string>>;
     protected parseSchematicInfo(schematic: string | undefined): [collectionName: string | undefined, schematicName: string | undefined];
     protected runSchematic(options: {

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

@@ -22,6 +22,12 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
 var __importStar = (this && this.__importStar) || function (mod) {
     if (mod && mod.__esModule) return mod;
     var result = {};
@@ -35,6 +41,7 @@ const core_1 = require("@angular-devkit/core");
 const schematics_1 = require("@angular-devkit/schematics");
 const tools_1 = require("@angular-devkit/schematics/tools");
 const config_1 = require("../utilities/config");
+const memoize_1 = require("../utilities/memoize");
 const tty_1 = require("../utilities/tty");
 const command_module_1 = require("./command-module");
 const json_schema_1 = require("./utilities/json-schema");
@@ -46,7 +53,6 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
         super(...arguments);
         this.allowPrivateSchematics = false;
         this.shouldReportAnalytics = false;
-        this._workflowForBuilder = new Map();
         this.defaultProjectDeprecationWarningShown = false;
     }
     async builder(argv) {
@@ -83,21 +89,12 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
         return (0, json_schema_1.parseJsonSchemaToOptions)(workflow.registry, schemaJson);
     }
     getOrCreateWorkflowForBuilder(collectionName) {
-        const cached = this._workflowForBuilder.get(collectionName);
-        if (cached) {
-            return cached;
-        }
-        const workflow = new tools_1.NodeWorkflow(this.context.root, {
+        return 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) {
-            return this._workflowForExecution;
-        }
         const { logger, root, packageManager } = this.context;
         const { force, dryRun, packageRegistry } = options;
         const workflow = new tools_1.NodeWorkflow(root, {
@@ -112,9 +109,7 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
             optionTransforms: [
                 // Add configuration file defaults
                 async (schematic, current) => {
-                    const projectName = typeof current.project === 'string'
-                        ? current.project
-                        : this.getProjectName();
+                    const projectName = typeof (current === null || current === void 0 ? void 0 : current.project) === 'string' ? current.project : this.getProjectName();
                     return {
                         ...(await (0, config_1.getSchematicDefaults)(schematic.collection.name, schematic.name, projectName)),
                         ...current,
@@ -210,13 +205,10 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
                 }
             });
         }
-        return (this._workflowForExecution = workflow);
+        return workflow;
     }
     async getSchematicCollections() {
         var _a;
-        if (this._schematicCollections) {
-            return this._schematicCollections;
-        }
         const getSchematicCollections = (configSection) => {
             if (!configSection) {
                 return undefined;
@@ -236,18 +228,15 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
             if (project) {
                 const value = getSchematicCollections(workspace.getProjectCli(project));
                 if (value) {
-                    this._schematicCollections = value;
                     return 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;
         }
-        this._schematicCollections = new Set([exports.DEFAULT_SCHEMATICS_COLLECTION]);
-        return this._schematicCollections;
+        return new Set([exports.DEFAULT_SCHEMATICS_COLLECTION]);
     }
     parseSchematicInfo(schematic) {
         if (schematic === null || schematic === void 0 ? void 0 : schematic.includes(':')) {
@@ -331,5 +320,14 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
                 [__dirname, process.cwd()];
     }
 }
-exports.SchematicsCommandModule = SchematicsCommandModule;
 SchematicsCommandModule.scope = command_module_1.CommandScope.In;
+__decorate([
+    memoize_1.memoize
+], SchematicsCommandModule.prototype, "getOrCreateWorkflowForBuilder", null);
+__decorate([
+    memoize_1.memoize
+], SchematicsCommandModule.prototype, "getOrCreateWorkflowForExecution", null);
+__decorate([
+    memoize_1.memoize
+], SchematicsCommandModule.prototype, "getSchematicCollections", null);
+exports.SchematicsCommandModule = SchematicsCommandModule;

package/src/command-builder/utilities/command.d.ts

@@ -8,6 +8,6 @@
 import { Argv } from 'yargs';
 import { CommandContext, CommandModule, CommandModuleImplementation } from '../command-module';
 export declare const demandCommandFailureMessage = "You need to specify a command before moving on. Use '--help' to view the available commands.";
-export declare function addCommandModuleToYargs<T, U extends Partial<CommandModuleImplementation> & {
+export declare function addCommandModuleToYargs<T extends object, U extends Partial<CommandModuleImplementation> & {
     new (context: CommandContext): Partial<CommandModuleImplementation> & CommandModule;
 }>(localYargs: Argv<T>, commandModule: U, context: CommandContext): Argv<T>;

package/src/command-builder/utilities/normalize-options-middleware.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @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 * as yargs from 'yargs';
+/**
+ * A Yargs middleware that normalizes non Array options when the argument has been provided multiple times.
+ *
+ * By default, when an option is non array and it is provided multiple times in the command line, yargs
+ * will not override it's value but instead it will be changed to an array unless `duplicate-arguments-array` is disabled.
+ * But this option also have an effect on real array options which isn't desired.
+ *
+ * See: https://github.com/yargs/yargs-parser/pull/163#issuecomment-516566614
+ */
+export declare function normalizeOptionsMiddleware(args: yargs.Arguments): void;

package/src/command-builder/utilities/normalize-options-middleware.js

@@ -0,0 +1,59 @@
+"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
+ */
+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.normalizeOptionsMiddleware = void 0;
+const yargs = __importStar(require("yargs"));
+/**
+ * A Yargs middleware that normalizes non Array options when the argument has been provided multiple times.
+ *
+ * By default, when an option is non array and it is provided multiple times in the command line, yargs
+ * will not override it's value but instead it will be changed to an array unless `duplicate-arguments-array` is disabled.
+ * But this option also have an effect on real array options which isn't desired.
+ *
+ * See: https://github.com/yargs/yargs-parser/pull/163#issuecomment-516566614
+ */
+function normalizeOptionsMiddleware(args) {
+    // `getOptions` is not included in the types even though it's public API.
+    // https://github.com/yargs/yargs/issues/2098
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const { array } = yargs.getOptions();
+    const arrayOptions = new Set(array);
+    for (const [key, value] of Object.entries(args)) {
+        if (key !== '_' && Array.isArray(value) && !arrayOptions.has(key)) {
+            const newValue = value.pop();
+            // eslint-disable-next-line no-console
+            console.warn(`Option '${key}' has been specified multiple times. The value '${newValue}' will be used.`);
+            args[key] = newValue;
+        }
+    }
+}
+exports.normalizeOptionsMiddleware = normalizeOptionsMiddleware;

package/src/command-builder/utilities/schematic-engine-host.d.ts

@@ -6,9 +6,9 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import { RuleFactory } from '@angular-devkit/schematics';
-import { NodeModulesEngineHost } from '@angular-devkit/schematics/tools';
+import { FileSystemCollectionDesc, NodeModulesEngineHost } from '@angular-devkit/schematics/tools';
 export declare class SchematicEngineHost extends NodeModulesEngineHost {
-    protected _resolveReferenceString(refString: string, parentPath: string): {
+    protected _resolveReferenceString(refString: string, parentPath: string, collectionDescription?: FileSystemCollectionDesc): {
         ref: RuleFactory<{}>;
         path: string;
     } | null;

package/src/command-builder/utilities/schematic-engine-host.js

@@ -21,21 +21,18 @@ const path_1 = require("path");
 const vm_1 = require("vm");
 /**
  * Environment variable to control schematic package redirection
- * Default: Angular schematics only
  */
 const schematicRedirectVariable = (_a = process.env['NG_SCHEMATIC_REDIRECT']) === null || _a === void 0 ? void 0 : _a.toLowerCase();
-function shouldWrapSchematic(schematicFile) {
+function shouldWrapSchematic(schematicFile, schematicEncapsulation) {
     // Check environment variable if present
-    if (schematicRedirectVariable !== undefined) {
-        switch (schematicRedirectVariable) {
-            case '0':
-            case 'false':
-            case 'off':
-            case 'none':
-                return false;
-            case 'all':
-                return true;
-        }
+    switch (schematicRedirectVariable) {
+        case '0':
+        case 'false':
+        case 'off':
+        case 'none':
+            return false;
+        case 'all':
+            return true;
     }
     const normalizedSchematicFile = schematicFile.replace(/\\/g, '/');
     // Never wrap the internal update schematic when executed directly
@@ -45,17 +42,21 @@ function shouldWrapSchematic(schematicFile) {
         !normalizedSchematicFile.includes('node_modules/@angular/cli/node_modules/')) {
         return false;
     }
-    // Default is only first-party Angular schematic packages
+    // Check for first-party Angular schematic packages
     // Angular schematics are safe to use in the wrapped VM context
-    return /\/node_modules\/@(?:angular|schematics|nguniversal)\//.test(normalizedSchematicFile);
+    if (/\/node_modules\/@(?:angular|schematics|nguniversal)\//.test(normalizedSchematicFile)) {
+        return true;
+    }
+    // Otherwise use the value of the schematic collection's encapsulation option (current default of false)
+    return schematicEncapsulation;
 }
 class SchematicEngineHost extends tools_1.NodeModulesEngineHost {
-    _resolveReferenceString(refString, parentPath) {
+    _resolveReferenceString(refString, parentPath, collectionDescription) {
         const [path, name] = refString.split('#', 2);
         // Mimic behavior of ExportStringRef class used in default behavior
         const fullPath = path[0] === '.' ? (0, path_1.resolve)(parentPath !== null && parentPath !== void 0 ? parentPath : process.cwd(), path) : path;
         const schematicFile = require.resolve(fullPath, { paths: [parentPath] });
-        if (shouldWrapSchematic(schematicFile)) {
+        if (shouldWrapSchematic(schematicFile, !!(collectionDescription === null || collectionDescription === void 0 ? void 0 : collectionDescription.encapsulation))) {
             const schematicPath = (0, path_1.dirname)(schematicFile);
             const moduleCache = new Map();
             const factoryInitializer = wrap(schematicFile, schematicPath, moduleCache, name || 'default');
@@ -66,7 +67,7 @@ class SchematicEngineHost extends tools_1.NodeModulesEngineHost {
             return { ref: factory, path: schematicPath };
         }
         // All other schematics use default behavior
-        return super._resolveReferenceString(refString, parentPath);
+        return super._resolveReferenceString(refString, parentPath, collectionDescription);
     }
 }
 exports.SchematicEngineHost = SchematicEngineHost;
@@ -108,6 +109,15 @@ function wrap(schematicFile, schematicDirectory, moduleCache, exportName) {
             // Provide compatibility modules for older versions of @angular/cdk
             return legacyModules[id];
         }
+        else if (id.startsWith('schematics:')) {
+            // Schematics built-in modules use the `schematics` scheme (similar to the Node.js `node` scheme)
+            const builtinId = id.slice(11);
+            const builtinModule = loadBuiltinModule(builtinId);
+            if (!builtinModule) {
+                throw new Error(`Unknown schematics built-in module '${id}' requested from schematic '${schematicFile}'`);
+            }
+            return builtinModule;
+        }
         else if (id.startsWith('@angular-devkit/') || id.startsWith('@schematics/')) {
             // Files should not redirect `@angular/core` and instead use the direct
             // dependency if available. This allows old major version migrations to continue to function
@@ -151,7 +161,9 @@ function wrap(schematicFile, schematicDirectory, moduleCache, exportName) {
     const schematicCode = (0, fs_1.readFileSync)(schematicFile, 'utf8');
     // `module` is required due to @angular/localize ng-add being in UMD format
     const headerCode = '(function() {\nvar exports = {};\nvar module = { exports };\n';
-    const footerCode = exportName ? `\nreturn exports['${exportName}'];});` : '\nreturn exports;});';
+    const footerCode = exportName
+        ? `\nreturn module.exports['${exportName}'];});`
+        : '\nreturn module.exports;});';
     const script = new vm_1.Script(headerCode + schematicCode + footerCode, {
         filename: schematicFile,
         lineOffset: 3,
@@ -170,3 +182,6 @@ function wrap(schematicFile, schematicDirectory, moduleCache, exportName) {
     const exportsFactory = script.runInNewContext(context);
     return exportsFactory;
 }
+function loadBuiltinModule(id) {
+    return undefined;
+}

package/src/commands/analytics/settings/cli.js

@@ -30,7 +30,7 @@ class AnalyticsDisableModule extends AnalyticsSettingModule {
         this.describe = 'Disables analytics gathering and reporting for the user.';
     }
     async run({ global }) {
-        (0, analytics_1.setAnalyticsConfig)(global, false);
+        await (0, analytics_1.setAnalyticsConfig)(global, false);
         process.stderr.write(await (0, analytics_1.getAnalyticsInfoString)());
     }
 }
@@ -43,7 +43,7 @@ class AnalyticsEnableModule extends AnalyticsSettingModule {
         this.describe = 'Enables analytics gathering and reporting for the user.';
     }
     async run({ global }) {
-        (0, analytics_1.setAnalyticsConfig)(global, true);
+        await (0, analytics_1.setAnalyticsConfig)(global, true);
         process.stderr.write(await (0, analytics_1.getAnalyticsInfoString)());
     }
 }

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

@@ -14,7 +14,7 @@ export declare class CacheDisableModule extends CommandModule implements Command
     longDescriptionPath: string | undefined;
     static scope: CommandScope.In;
     builder(localYargs: Argv): Argv;
-    run(): void;
+    run(): Promise<void>;
 }
 export declare class CacheEnableModule extends CommandModule implements CommandModuleImplementation {
     command: string;
@@ -23,5 +23,5 @@ export declare class CacheEnableModule extends CommandModule implements CommandM
     longDescriptionPath: string | undefined;
     static scope: CommandScope.In;
     builder(localYargs: Argv): Argv;
-    run(): void;
+    run(): Promise<void>;
 }

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

@@ -21,7 +21,7 @@ class CacheDisableModule extends command_module_1.CommandModule {
         return localYargs;
     }
     run() {
-        (0, utilities_1.updateCacheConfig)('enabled', false);
+        return (0, utilities_1.updateCacheConfig)(this.getWorkspaceOrThrow(), 'enabled', false);
     }
 }
 exports.CacheDisableModule = CacheDisableModule;
@@ -36,7 +36,7 @@ class CacheEnableModule extends command_module_1.CommandModule {
         return localYargs;
     }
     run() {
-        (0, utilities_1.updateCacheConfig)('enabled', true);
+        return (0, utilities_1.updateCacheConfig)(this.getWorkspaceOrThrow(), 'enabled', true);
     }
 }
 exports.CacheEnableModule = CacheEnableModule;

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

@@ -7,5 +7,5 @@
  */
 import { Cache } from '../../../lib/config/workspace-schema';
 import { AngularWorkspace } from '../../utilities/config';
-export declare function updateCacheConfig<K extends keyof Cache>(key: K, value: Cache[K]): void;
+export declare function updateCacheConfig<K extends keyof Cache>(workspace: AngularWorkspace, key: K, value: Cache[K]): Promise<void>;
 export declare function getCacheConfig(workspace: AngularWorkspace | undefined): Required<Cache>;

package/src/commands/cache/utilities.js

@@ -11,14 +11,13 @@ exports.getCacheConfig = exports.updateCacheConfig = void 0;
 const core_1 = require("@angular-devkit/core");
 const path_1 = require("path");
 const workspace_schema_1 = require("../../../lib/config/workspace-schema");
-const config_1 = require("../../utilities/config");
-function updateCacheConfig(key, value) {
-    const [localWorkspace] = (0, config_1.getWorkspaceRaw)('local');
-    if (!localWorkspace) {
-        throw new Error('Cannot find workspace configuration file.');
-    }
-    localWorkspace.modify(['cli', 'cache', key], value);
-    localWorkspace.save();
+function updateCacheConfig(workspace, key, value) {
+    var _a, _b;
+    var _c;
+    const cli = ((_a = (_c = workspace.extensions)['cli']) !== null && _a !== void 0 ? _a : (_c['cli'] = {}));
+    const cache = ((_b = cli['cache']) !== null && _b !== void 0 ? _b : (cli['cache'] = {}));
+    cache[key] = value;
+    return workspace.save();
 }
 exports.updateCacheConfig = updateCacheConfig;
 function getCacheConfig(workspace) {

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

@@ -0,0 +1,16 @@
+/**
+ * @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 } from '../../command-builder/command-module';
+export declare class CompletionCommandModule extends CommandModule implements CommandModuleImplementation {
+    command: string;
+    describe: string;
+    longDescriptionPath: string;
+    builder(localYargs: Argv): Argv;
+    run(): Promise<number>;
+}

package/src/commands/completion/cli.js

@@ -0,0 +1,61 @@
+"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
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompletionCommandModule = void 0;
+const path_1 = require("path");
+const yargs_1 = __importDefault(require("yargs"));
+const command_module_1 = require("../../command-builder/command-module");
+const command_1 = require("../../command-builder/utilities/command");
+const color_1 = require("../../utilities/color");
+const completion_1 = require("../../utilities/completion");
+class CompletionCommandModule extends command_module_1.CommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'completion';
+        this.describe = 'Set up Angular CLI autocompletion for your terminal.';
+        this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');
+    }
+    builder(localYargs) {
+        return (0, command_1.addCommandModuleToYargs)(localYargs, CompletionScriptCommandModule, this.context);
+    }
+    async run() {
+        let rcFile;
+        try {
+            rcFile = await (0, completion_1.initializeAutocomplete)();
+        }
+        catch (err) {
+            this.context.logger.error(err.message);
+            return 1;
+        }
+        this.context.logger.info(`
+Appended \`source <(ng completion script)\` to \`${rcFile}\`. Restart your terminal or run the following to autocomplete \`ng\` commands:
+
+    ${color_1.colors.yellow('source <(ng completion script)')}
+      `.trim());
+        return 0;
+    }
+}
+exports.CompletionCommandModule = CompletionCommandModule;
+class CompletionScriptCommandModule extends command_module_1.CommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'script';
+        this.describe = 'Generate a bash and zsh real-time type-ahead autocompletion script.';
+        this.longDescriptionPath = undefined;
+    }
+    builder(localYargs) {
+        return localYargs;
+    }
+    run() {
+        yargs_1.default.showCompletionScript();
+    }
+}

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

@@ -0,0 +1,5 @@
+To enable Bash and Zsh real-time type-ahead autocompletion, run
+`ng completion` and restart your terminal.
+
+Alternatively, append `source <(ng completion script)` to the appropriate `.bashrc`,
+`.bash_profile`, `.zshrc`, `.zsh_profile`, or `.profile` file.