@angular/cli 14.0.0-next.8 → 14.0.0-rc.1

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,68 @@
+"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());
+        if ((await (0, completion_1.hasGlobalCliInstall)()) === false) {
+            this.context.logger.warn('Setup completed successfully, but there does not seem to be a global install of the' +
+                ' Angular CLI. For autocompletion to work, the CLI will need to be on your `$PATH`, which' +
+                ' is typically done with the `-g` flag in `npm install -g @angular/cli`.' +
+                '\n\n' +
+                'For more information, see https://angular.io/cli/completion#global-install');
+        }
+        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,73 @@
+Setting up autocompletion configures your terminal, so pressing the `<TAB>` key while in the middle
+of typing will display various commands and options available to you. This makes it very easy to
+discover and use CLI commands without lots of memorization.
+
+![A demo of Angular CLI autocompletion in a terminal. The user types several partial `ng` commands,
+using autocompletion to finish several arguments and list contextual options.
+](/generated/images/guide/cli/completion.gif)
+
+## Automated setup
+
+The CLI should prompt and ask to set up autocompletion for you the first time you use it (v14+).
+Simply answer "Yes" and the CLI will take care of the rest.
+
+```
+$ ng serve
+? 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.) Yes
+Appended `source <(ng completion script)` to `/home/my-username/.bashrc`. Restart your terminal or
+run:
+
+source <(ng completion script)
+
+to autocomplete `ng` commands.
+
+# Serve output...
+```
+
+If you already refused the prompt, it won't ask again. But you can run `ng completion` to
+do the same thing automatically.
+
+This modifies your terminal environment to load Angular CLI autocompletion, but can't update your
+current terminal session. Either restart it or run `source <(ng completion script)` directly to
+enable autocompletion in your current session.
+
+Test it out by typing `ng ser<TAB>` and it should autocomplete to `ng serve`. Ambiguous arguments
+will show all possible options and their documentation, such as `ng generate <TAB>`.
+
+## Manual setup
+
+Some users may have highly customized terminal setups, possibly with configuration files checked
+into source control with an opinionated structure. `ng completion` only ever appends Angular's setup
+to an existing configuration file for your current shell, or creates one if none exists. If you want
+more control over exactly where this configuration lives, you can manually set it up by having your
+shell run at startup:
+
+```bash
+source <(ng completion script)
+```
+
+This is equivalent to what `ng completion` will automatically set up, and gives power users more
+flexibility in their environments when desired.
+
+## Platform support
+
+Angular CLI supports autocompletion for the Bash and Zsh shells on MacOS and Linux operating
+systems.
+
+Windows does not support autocompletion in native shells, such as Cmd and Powershell. However,
+the Angular CLI supports Git Bash and
+[Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/) using Bash or Zsh.
+
+## Global install
+
+Autocompletion works by configuring your terminal to invoke the Angular CLI on startup to load the
+setup script. This means the terminal must be able to find and execute the Angular CLI, typically
+through a global install that places the binary on the user's `$PATH`. If you get
+`command not found: ng`, make sure the CLI is installed globally which you can do with the `-g`
+flag:
+
+```bash
+npm install -g @angular/cli
+```

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/doc/cli.js

@@ -93,8 +93,8 @@ class DocCommandModule extends command_module_1.CommandModule {
             catch { }
         }
         await (0, open_1.default)(options.search
-            ? `https://${domain}/api?query=${options.keyword}`
-            : `https://${domain}/docs?search=${options.keyword}`);
+            ? `https://${domain}/docs?search=${options.keyword}`
+            : `https://${domain}/api?query=${options.keyword}`);
     }
 }
 exports.DocCommandModule = DocCommandModule;

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

@@ -584,8 +584,9 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                     }
                 }
                 const result = await this.executeMigrations(workflow, migration.package, migrations, migration.from, migration.to, options.createCommits);
-                if (!result) {
-                    return 0;
+                // A non-zero value is a failure for the package's migrations
+                if (result !== 0) {
+                    return result;
                 }
             }
         }

package/src/utilities/completion.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @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>;
+/**
+ * Returns whether the user has a global CLI install or `undefined` if this can't be determined.
+ * Execution from `npx` is *not* considered a global CLI install.
+ *
+ * This does *not* mean the current execution is from a global CLI install, only that a global
+ * install exists on the system.
+ */
+export declare function hasGlobalCliInstall(): Promise<boolean | undefined>;