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

package/src/commands/config/cli.js

@@ -71,25 +71,23 @@ class ConfigCommandModule extends command_module_1.CommandModule {
         return 0;
     }
     async set(options) {
-        var _a, _b, _c;
+        var _a;
         if (!((_a = options.jsonPath) === null || _a === void 0 ? void 0 : _a.trim())) {
             throw new command_module_1.CommandModuleError('Invalid Path.');
         }
-        const validCliPaths = new Map([
-            ['cli.warnings.versionMismatch', undefined],
-            ['cli.defaultCollection', undefined],
-            ['cli.schematicCollections', undefined],
-            ['cli.packageManager', undefined],
-            ['cli.analytics', undefined],
-            ['cli.analyticsSharing.tracking', undefined],
-            ['cli.analyticsSharing.uuid', (v) => (v === '' ? (0, uuid_1.v4)() : `${v}`)],
-            ['cli.cache.enabled', undefined],
-            ['cli.cache.environment', undefined],
-            ['cli.cache.path', undefined],
+        const validGlobalCliPaths = new Set([
+            'cli.warnings.versionMismatch',
+            'cli.defaultCollection',
+            'cli.schematicCollections',
+            'cli.packageManager',
+            'cli.analytics',
+            'cli.analyticsSharing.tracking',
+            'cli.analyticsSharing.uuid',
+            'cli.completion.prompted',
         ]);
         if (options.global &&
             !options.jsonPath.startsWith('schematics.') &&
-            !validCliPaths.has(options.jsonPath)) {
+            !validGlobalCliPaths.has(options.jsonPath)) {
             throw new command_module_1.CommandModuleError('Invalid Path.');
         }
         const [config, configPath] = (0, config_1.getWorkspaceRaw)(options.global ? 'global' : 'local');
@@ -97,7 +95,10 @@ class ConfigCommandModule extends command_module_1.CommandModule {
         if (!config || !configPath) {
             throw new command_module_1.CommandModuleError('Confguration file cannot be found.');
         }
-        const value = (_c = (_b = validCliPaths.get(options.jsonPath)) === null || _b === void 0 ? void 0 : _b(options.value)) !== null && _c !== void 0 ? _c : options.value;
+        const normalizeUUIDValue = (v) => (v === '' ? (0, uuid_1.v4)() : `${v}`);
+        const value = options.jsonPath === 'cli.analyticsSharing.uuid'
+            ? normalizeUUIDValue(options.value)
+            : options.value;
         const modified = config.modify(parseJsonPath(options.jsonPath), normalizeValue(value));
         if (!modified) {
             logger.error('Value cannot be found.');

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

@@ -5,10 +5,11 @@
  * 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 { MissingTargetChoice } from '../../command-builder/architect-base-command-module';
 import { ArchitectCommandModule } from '../../command-builder/architect-command-module';
 import { CommandModuleImplementation } from '../../command-builder/command-module';
 export declare class DeployCommandModule extends ArchitectCommandModule implements CommandModuleImplementation {
-    missingErrorTarget: string;
+    missingTargetChoices: MissingTargetChoice[];
     multiTarget: boolean;
     command: string;
     longDescriptionPath: string;

package/src/commands/deploy/cli.js

@@ -8,24 +8,38 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeployCommandModule = void 0;
-const core_1 = require("@angular-devkit/core");
 const path_1 = require("path");
 const architect_command_module_1 = require("../../command-builder/architect-command-module");
 class DeployCommandModule extends architect_command_module_1.ArchitectCommandModule {
     constructor() {
         super(...arguments);
-        this.missingErrorTarget = core_1.tags.stripIndents `
-  Cannot find "deploy" target for the specified project.
-
-  You should add a package that implements deployment capabilities for your
-  favorite platform.
-  
-  For example:
-    ng add @angular/fire
-    ng add @azure/ng-deploy
-  
-  Find more packages on npm https://www.npmjs.com/search?q=ng%20deploy
-  `;
+        // The below choices should be kept in sync with the list in https://angular.io/guide/deployment
+        this.missingTargetChoices = [
+            {
+                name: 'Amazon S3',
+                value: '@jefiozie/ngx-aws-deploy',
+            },
+            {
+                name: 'Azure',
+                value: '@azure/ng-deploy',
+            },
+            {
+                name: 'Firebase',
+                value: '@angular/fire',
+            },
+            {
+                name: 'Netlify',
+                value: '@netlify-builder/deploy',
+            },
+            {
+                name: 'NPM',
+                value: 'ngx-deploy-npm',
+            },
+            {
+                name: 'GitHub Pages',
+                value: 'angular-cli-ghpages',
+            },
+        ];
         this.multiTarget = false;
         this.command = 'deploy [project]';
         this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');

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

@@ -5,11 +5,12 @@
  * 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 { MissingTargetChoice } from '../../command-builder/architect-base-command-module';
 import { ArchitectCommandModule } from '../../command-builder/architect-command-module';
 import { CommandModuleImplementation } from '../../command-builder/command-module';
 export declare class E2eCommandModule extends ArchitectCommandModule implements CommandModuleImplementation {
+    missingTargetChoices: MissingTargetChoice[];
     multiTarget: boolean;
-    missingErrorTarget: string;
     command: string;
     aliases: string[];
     describe: string;

package/src/commands/e2e/cli.js

@@ -8,24 +8,25 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.E2eCommandModule = void 0;
-const core_1 = require("@angular-devkit/core");
 const architect_command_module_1 = require("../../command-builder/architect-command-module");
 class E2eCommandModule extends architect_command_module_1.ArchitectCommandModule {
     constructor() {
         super(...arguments);
+        this.missingTargetChoices = [
+            {
+                name: 'Cypress',
+                value: '@cypress/schematic',
+            },
+            {
+                name: 'Nightwatch',
+                value: '@nightwatch/schematics',
+            },
+            {
+                name: 'WebdriverIO',
+                value: '@wdio/schematics',
+            },
+        ];
         this.multiTarget = true;
-        this.missingErrorTarget = core_1.tags.stripIndents `
-  Cannot find "e2e" target for the specified project.
-
-  You should add a package that implements end-to-end testing capabilities.
-
-  For example:
-    Cypress: ng add @cypress/schematic
-    Nightwatch: ng add @nightwatch/schematics
-    WebdriverIO: ng add @wdio/schematics
-
-  More options will be added to the list as they become available.
-  `;
         this.command = 'e2e [project]';
         this.aliases = ['e'];
         this.describe = 'Builds and serves an Angular application, then runs end-to-end tests.';

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

@@ -5,10 +5,11 @@
  * 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 { MissingTargetChoice } from '../../command-builder/architect-base-command-module';
 import { ArchitectCommandModule } from '../../command-builder/architect-command-module';
 import { CommandModuleImplementation } from '../../command-builder/command-module';
 export declare class LintCommandModule extends ArchitectCommandModule implements CommandModuleImplementation {
-    missingErrorTarget: string;
+    missingTargetChoices: MissingTargetChoice[];
     multiTarget: boolean;
     command: string;
     longDescriptionPath: string;

package/src/commands/lint/cli.js

@@ -8,20 +8,17 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LintCommandModule = void 0;
-const core_1 = require("@angular-devkit/core");
 const path_1 = require("path");
 const architect_command_module_1 = require("../../command-builder/architect-command-module");
 class LintCommandModule extends architect_command_module_1.ArchitectCommandModule {
     constructor() {
         super(...arguments);
-        this.missingErrorTarget = core_1.tags.stripIndents `
-  Cannot find "lint" target for the specified project.
-  
-  You should add a package that implements linting capabilities.
-  
-  For example:
-    ng add @angular-eslint/schematics
-  `;
+        this.missingTargetChoices = [
+            {
+                name: 'ESLint',
+                value: '@angular-eslint/schematics',
+            },
+        ];
         this.multiTarget = true;
         this.command = 'lint [project]';
         this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');

package/src/commands/new/cli.js

@@ -39,9 +39,14 @@ class NewCommandModule extends schematics_command_module_1.SchematicsCommandModu
         var _a;
         // Register the version of the CLI in the registry.
         const collectionName = (_a = options.collection) !== null && _a !== void 0 ? _a : (await this.getCollectionFromConfig());
-        const workflow = await this.getOrCreateWorkflowForExecution(collectionName, options);
-        workflow.registry.addSmartDefaultProvider('ng-cli-version', () => version_1.VERSION.full);
         const { dryRun, force, interactive, defaults, collection, ...schematicOptions } = options;
+        const workflow = await this.getOrCreateWorkflowForExecution(collectionName, {
+            dryRun,
+            force,
+            interactive,
+            defaults,
+        });
+        workflow.registry.addSmartDefaultProvider('ng-cli-version', () => version_1.VERSION.full);
         // Compatibility check for NPM 7
         if (collectionName === '@schematics/angular' &&
             !schematicOptions.skipInstall &&

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

@@ -20,4 +20,6 @@ export declare class RunCommandModule extends ArchitectBaseCommandModule<RunComm
     builder(argv: Argv): Promise<Argv<RunCommandArgs>>;
     run(options: Options<RunCommandArgs> & OtherOptions): Promise<number>;
     protected makeTargetSpecifier(options?: Options<RunCommandArgs>): Target | undefined;
+    /** @returns a sorted list of target specifiers to be used for auto completion. */
+    private getTargetChoices;
 }

package/src/commands/run/cli.js

@@ -19,11 +19,15 @@ class RunCommandModule extends architect_base_command_module_1.ArchitectBaseComm
         this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');
     }
     async builder(argv) {
+        const { jsonHelp, getYargsCompletions, help } = this.context.args.options;
         const localYargs = argv
             .positional('target', {
             describe: 'The Architect target to run.',
             type: 'string',
             demandOption: true,
+            // Show only in when using --help and auto completion because otherwise comma seperated configuration values will be invalid.
+            // Also, hide choices from JSON help so that we don't display them in AIO.
+            choices: (getYargsCompletions || help) && !jsonHelp ? this.getTargetChoices() : undefined,
         })
             .strict();
         const target = this.makeTargetSpecifier();
@@ -54,6 +58,26 @@ class RunCommandModule extends architect_base_command_module_1.ArchitectBaseComm
             configuration,
         };
     }
+    /** @returns a sorted list of target specifiers to be used for auto completion. */
+    getTargetChoices() {
+        if (!this.context.workspace) {
+            return;
+        }
+        const targets = [];
+        for (const [projectName, project] of this.context.workspace.projects) {
+            for (const [targetName, target] of project.targets) {
+                const currentTarget = `${projectName}:${targetName}`;
+                targets.push(currentTarget);
+                if (!target.configurations) {
+                    continue;
+                }
+                for (const configName of Object.keys(target.configurations)) {
+                    targets.push(`${currentTarget}:${configName}`);
+                }
+            }
+        }
+        return targets.sort();
+    }
 }
 exports.RunCommandModule = RunCommandModule;
 RunCommandModule.scope = command_module_1.CommandScope.In;

package/src/commands/update/cli.js

@@ -67,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. ' +
@@ -656,7 +657,7 @@ 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.name === workspace_schema_1.PackageManager.Yarn,
         });

package/src/utilities/completion.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @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 { logging } from '@angular-devkit/core';
+/**
+ * Checks if it is appropriate to prompt the user to setup autocompletion. If not, does nothing. If
+ * so prompts and sets up autocompletion for the user. Returns an exit code if the program should
+ * terminate, otherwise returns `undefined`.
+ * @returns an exit code if the program should terminate, undefined otherwise.
+ */
+export declare function considerSettingUpAutocompletion(command: string, logger: logging.Logger): Promise<number | undefined>;
+/**
+ * Sets up autocompletion for the user's terminal. This attempts to find the configuration file for
+ * the current shell (`.bashrc`, `.zshrc`, etc.) and append a command which enables autocompletion
+ * for the Angular CLI. Supports only Bash and Zsh. Returns whether or not it was successful.
+ * @return The full path of the configuration file modified.
+ */
+export declare function initializeAutocomplete(): Promise<string>;

package/src/utilities/completion.js

@@ -0,0 +1,219 @@
+"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.initializeAutocomplete = exports.considerSettingUpAutocompletion = void 0;
+const core_1 = require("@angular-devkit/core");
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const process_1 = require("process");
+const color_1 = require("../utilities/color");
+const config_1 = require("../utilities/config");
+const environment_options_1 = require("../utilities/environment-options");
+const tty_1 = require("../utilities/tty");
+/**
+ * Checks if it is appropriate to prompt the user to setup autocompletion. If not, does nothing. If
+ * so prompts and sets up autocompletion for the user. Returns an exit code if the program should
+ * terminate, otherwise returns `undefined`.
+ * @returns an exit code if the program should terminate, undefined otherwise.
+ */
+async function considerSettingUpAutocompletion(command, logger) {
+    // Check if we should prompt the user to setup autocompletion.
+    const completionConfig = await getCompletionConfig();
+    if (!(await shouldPromptForAutocompletionSetup(command, completionConfig))) {
+        return undefined; // Already set up or prompted previously, nothing to do.
+    }
+    // Prompt the user and record their response.
+    const shouldSetupAutocompletion = await promptForAutocompletion();
+    if (!shouldSetupAutocompletion) {
+        // User rejected the prompt and doesn't want autocompletion.
+        logger.info(`
+Ok, you won't be prompted again. Should you change your mind, the following command will set up autocompletion for you:
+
+    ${color_1.colors.yellow(`ng completion`)}
+    `.trim());
+        // Save configuration to remember that the user was prompted and avoid prompting again.
+        await setCompletionConfig({ ...completionConfig, prompted: true });
+        return undefined;
+    }
+    // User accepted the prompt, set up autocompletion.
+    let rcFile;
+    try {
+        rcFile = await initializeAutocomplete();
+    }
+    catch (err) {
+        // Failed to set up autocompeletion, log the error and abort.
+        logger.error(err.message);
+        return 1;
+    }
+    // Notify the user autocompletion was set up successfully.
+    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());
+    // Save configuration to remember that the user was prompted.
+    await setCompletionConfig({ ...completionConfig, prompted: true });
+    return undefined;
+}
+exports.considerSettingUpAutocompletion = considerSettingUpAutocompletion;
+async function getCompletionConfig() {
+    var _a;
+    const wksp = await (0, config_1.getWorkspace)('global');
+    return (_a = wksp === null || wksp === void 0 ? void 0 : wksp.getCli()) === null || _a === void 0 ? void 0 : _a['completion'];
+}
+async function setCompletionConfig(config) {
+    var _a;
+    var _b;
+    const wksp = await (0, config_1.getWorkspace)('global');
+    if (!wksp) {
+        throw new Error(`Could not find global workspace`);
+    }
+    (_a = (_b = wksp.extensions)['cli']) !== null && _a !== void 0 ? _a : (_b['cli'] = {});
+    const cli = wksp.extensions['cli'];
+    if (!core_1.json.isJsonObject(cli)) {
+        throw new Error(`Invalid config found at ${wksp.filePath}. \`extensions.cli\` should be an object.`);
+    }
+    cli.completion = config;
+    await wksp.save();
+}
+async function shouldPromptForAutocompletionSetup(command, config) {
+    // Force whether or not to prompt for autocomplete to give an easy path for e2e testing to skip.
+    if (environment_options_1.forceAutocomplete !== undefined) {
+        return environment_options_1.forceAutocomplete;
+    }
+    // Don't prompt on `ng update` or `ng completion`.
+    if (command === 'update' || command === 'completion') {
+        return false;
+    }
+    // Non-interactive and continuous integration systems don't care about autocompletion.
+    if (!(0, tty_1.isTTY)()) {
+        return false;
+    }
+    // Skip prompt if the user has already been prompted.
+    if (config === null || config === void 0 ? void 0 : config.prompted) {
+        return false;
+    }
+    // `$HOME` variable is necessary to find RC files to modify.
+    const home = process_1.env['HOME'];
+    if (!home) {
+        return false;
+    }
+    // Get possible RC files for the current shell.
+    const shell = process_1.env['SHELL'];
+    if (!shell) {
+        return false;
+    }
+    const rcFiles = getShellRunCommandCandidates(shell, home);
+    if (!rcFiles) {
+        return false; // Unknown shell.
+    }
+    // Check each RC file if they already use `ng completion script` in any capacity and don't prompt.
+    for (const rcFile of rcFiles) {
+        const contents = await fs_1.promises.readFile(rcFile, 'utf-8').catch(() => undefined);
+        if (contents === null || contents === void 0 ? void 0 : contents.includes('ng completion script')) {
+            return false;
+        }
+    }
+    return true;
+}
+async function promptForAutocompletion() {
+    // Dynamically load `inquirer` so users don't have to pay the cost of parsing and executing it for
+    // the 99% of builds that *don't* prompt for autocompletion.
+    const { prompt } = await Promise.resolve().then(() => __importStar(require('inquirer')));
+    const { autocomplete } = await prompt([
+        {
+            name: 'autocomplete',
+            type: 'confirm',
+            message: `
+Would you like to enable autocompletion? This will set up your terminal so pressing TAB while typing
+Angular CLI commands will show possible options and autocomplete arguments. (Enabling autocompletion
+will modify configuration files in your home directory.)
+      `
+                .split('\n')
+                .join(' ')
+                .trim(),
+            default: true,
+        },
+    ]);
+    return autocomplete;
+}
+/**
+ * Sets up autocompletion for the user's terminal. This attempts to find the configuration file for
+ * the current shell (`.bashrc`, `.zshrc`, etc.) and append a command which enables autocompletion
+ * for the Angular CLI. Supports only Bash and Zsh. Returns whether or not it was successful.
+ * @return The full path of the configuration file modified.
+ */
+async function initializeAutocomplete() {
+    var _a, _b;
+    // Get the currently active `$SHELL` and `$HOME` environment variables.
+    const shell = process_1.env['SHELL'];
+    if (!shell) {
+        throw new Error('`$SHELL` environment variable not set. Angular CLI autocompletion only supports Bash or' +
+            " Zsh. If you're on Windows, Cmd and Powershell don't support command autocompletion," +
+            ' but Git Bash or Windows Subsystem for Linux should work, so please try again in one of' +
+            ' those environments.');
+    }
+    const home = process_1.env['HOME'];
+    if (!home) {
+        throw new Error('`$HOME` environment variable not set. Setting up autocompletion modifies configuration files' +
+            ' in the home directory and must be set.');
+    }
+    // Get all the files we can add `ng completion` to which apply to the user's `$SHELL`.
+    const runCommandCandidates = getShellRunCommandCandidates(shell, home);
+    if (!runCommandCandidates) {
+        throw new Error(`Unknown \`$SHELL\` environment variable value (${shell}). Angular CLI autocompletion only supports Bash or Zsh.`);
+    }
+    // Get the first file that already exists or fallback to a new file of the first candidate.
+    const candidates = await Promise.allSettled(runCommandCandidates.map((rcFile) => fs_1.promises.access(rcFile).then(() => rcFile)));
+    const rcFile = (_b = (_a = candidates.find((result) => result.status === 'fulfilled')) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : runCommandCandidates[0];
+    // Append Angular autocompletion setup to RC file.
+    try {
+        await fs_1.promises.appendFile(rcFile, '\n\n# Load Angular CLI autocompletion.\nsource <(ng completion script)\n');
+    }
+    catch (err) {
+        throw new Error(`Failed to append autocompletion setup to \`${rcFile}\`:\n${err.message}`);
+    }
+    return rcFile;
+}
+exports.initializeAutocomplete = initializeAutocomplete;
+/** Returns an ordered list of possible candidates of RC files used by the given shell. */
+function getShellRunCommandCandidates(shell, home) {
+    if (shell.toLowerCase().includes('bash')) {
+        return ['.bashrc', '.bash_profile', '.profile'].map((file) => path.join(home, file));
+    }
+    else if (shell.toLowerCase().includes('zsh')) {
+        return ['.zshrc', '.zsh_profile', '.profile'].map((file) => path.join(home, file));
+    }
+    else {
+        return undefined;
+    }
+}

package/src/utilities/config.d.ts

@@ -10,14 +10,15 @@ 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 | undefined>;

package/src/utilities/config.js

@@ -134,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);
@@ -152,10 +155,13 @@ async function getWorkspace(level = 'local') {
     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, undefined);
-        return undefined;
+        if (level === 'local') {
+            cachedWorkspaces.set(level, undefined);
+            return undefined;
+        }
+        configPath = createGlobalSettings();
     }
     try {
         const workspace = await AngularWorkspace.load(configPath);

package/src/utilities/environment-options.d.ts

@@ -10,3 +10,4 @@ export declare const analyticsShareDisabled: boolean;
 export declare const isCI: boolean;
 export declare const disableVersionCheck: boolean;
 export declare const ngDebug: boolean;
+export declare const forceAutocomplete: boolean | undefined;

package/src/utilities/environment-options.js

@@ -7,7 +7,7 @@
  * 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;
+exports.forceAutocomplete = exports.ngDebug = exports.disableVersionCheck = exports.isCI = exports.analyticsShareDisabled = exports.analyticsDisabled = void 0;
 function isPresent(variable) {
     return typeof variable === 'string' && variable !== '';
 }
@@ -17,8 +17,15 @@ function isDisabled(variable) {
 function isEnabled(variable) {
     return isPresent(variable) && (variable === '1' || variable.toLowerCase() === 'true');
 }
+function optional(variable) {
+    if (!isPresent(variable)) {
+        return undefined;
+    }
+    return isEnabled(variable);
+}
 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']);
+exports.forceAutocomplete = optional(process.env['NG_FORCE_AUTOCOMPLETE']);

package/src/utilities/json-file.js

@@ -59,6 +59,7 @@ class JSONFile {
         }
         const edits = (0, jsonc_parser_1.modify)(this.content, jsonPath, value, {
             getInsertionIndex,
+            // TODO: use indentation from original file.
             formattingOptions: {
                 insertSpaces: true,
                 tabSize: 2,