@angular/cli 14.0.0-next.2 → 14.0.0-next.5

package/src/command-builder/utilities/json-help.js

@@ -0,0 +1,90 @@
+"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.jsonHelpUsage = void 0;
+const yargs_1 = __importDefault(require("yargs"));
+function jsonHelpUsage() {
+    var _a, _b, _c;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const localYargs = yargs_1.default;
+    const { deprecatedOptions, alias: aliases, array, string, boolean, number, choices, demandedOptions, default: defaultVal, hiddenOptions = [], } = localYargs.getOptions();
+    const internalMethods = localYargs.getInternalMethods();
+    const usageInstance = internalMethods.getUsageInstance();
+    const context = internalMethods.getContext();
+    const descriptions = usageInstance.getDescriptions();
+    const groups = localYargs.getGroups();
+    const positional = groups[usageInstance.getPositionalGroupName()];
+    const hidden = new Set(hiddenOptions);
+    const normalizeOptions = [];
+    const allAliases = new Set([...Object.values(aliases).flat()]);
+    for (const [names, type] of [
+        [array, 'array'],
+        [string, 'string'],
+        [boolean, 'boolean'],
+        [number, 'number'],
+    ]) {
+        for (const name of names) {
+            if (allAliases.has(name) || hidden.has(name)) {
+                // Ignore hidden, aliases and already visited option.
+                continue;
+            }
+            const positionalIndex = (_a = positional === null || positional === void 0 ? void 0 : positional.indexOf(name)) !== null && _a !== void 0 ? _a : -1;
+            const alias = aliases[name];
+            normalizeOptions.push({
+                name,
+                type,
+                deprecated: deprecatedOptions[name],
+                aliases: (alias === null || alias === void 0 ? void 0 : alias.length) > 0 ? alias : undefined,
+                default: defaultVal[name],
+                required: demandedOptions[name],
+                enum: choices[name],
+                description: (_b = descriptions[name]) === null || _b === void 0 ? void 0 : _b.replace('__yargsString__:', ''),
+                positional: positionalIndex >= 0 ? positionalIndex : undefined,
+            });
+        }
+    }
+    // https://github.com/yargs/yargs/blob/00e4ebbe3acd438e73fdb101e75b4f879eb6d345/lib/usage.ts#L124
+    const subcommands = usageInstance.getCommands()
+        .map(([name, description, _, aliases, deprecated]) => ({
+        name: name.split(' ', 1)[0],
+        command: name,
+        description,
+        aliases,
+        deprecated,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    const parseDescription = (rawDescription) => {
+        try {
+            const { longDescription, describe: shortDescription, longDescriptionRelativePath, } = JSON.parse(rawDescription);
+            return {
+                shortDescription,
+                longDescriptionRelativePath,
+                longDescription,
+            };
+        }
+        catch {
+            return {
+                shortDescription: rawDescription,
+            };
+        }
+    };
+    const [command, rawDescription] = (_c = usageInstance.getUsage()[0]) !== null && _c !== void 0 ? _c : [];
+    const output = {
+        name: [...context.commands].pop(),
+        command: command === null || command === void 0 ? void 0 : command.replace('$0', localYargs['$0']),
+        ...parseDescription(rawDescription),
+        options: normalizeOptions.sort((a, b) => a.name.localeCompare(b.name)),
+        subcommands: subcommands.length ? subcommands : undefined,
+    };
+    return JSON.stringify(output, undefined, 2);
+}
+exports.jsonHelpUsage = jsonHelpUsage;

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

@@ -0,0 +1,40 @@
+/**
+ * @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 { json } from '@angular-devkit/core';
+import yargs from 'yargs';
+/**
+ * An option description.
+ */
+export interface Option extends yargs.Options {
+    /**
+     * The name of the option.
+     */
+    name: string;
+    /**
+     * Whether this option is required or not.
+     */
+    required?: boolean;
+    /**
+     * Format field of this option.
+     */
+    format?: string;
+    /**
+     * Whether this option should be hidden from the help output. It will still show up in JSON help.
+     */
+    hidden?: boolean;
+    /**
+     * If this option can be used as an argument, the position of the argument. Otherwise omitted.
+     */
+    positional?: number;
+    /**
+     * Whether or not to report this option to the Angular Team, and which custom field to use.
+     * If this is falsey, do not report this option.
+     */
+    userAnalytics?: number;
+}
+export declare function parseJsonSchemaToOptions(registry: json.schema.SchemaRegistry, schema: json.JsonObject, interactive?: boolean): Promise<Option[]>;

package/{utilities → src/command-builder/utilities}/json-schema.js

@@ -7,102 +7,9 @@
  * found in the LICENSE file at https://angular.io/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseJsonSchemaToOptions = exports.parseJsonSchemaToCommandDescription = exports.parseJsonSchemaToSubCommandDescription = exports.CommandJsonPathException = void 0;
+exports.parseJsonSchemaToOptions = void 0;
 const core_1 = require("@angular-devkit/core");
-const tools_1 = require("@angular-devkit/schematics/tools");
-const fs_1 = require("fs");
-const path_1 = require("path");
-const interface_1 = require("../models/interface");
-class CommandJsonPathException extends core_1.BaseException {
-    constructor(path, name) {
-        super(`File ${path} was not found while constructing the subcommand ${name}.`);
-        this.path = path;
-        this.name = name;
-    }
-}
-exports.CommandJsonPathException = CommandJsonPathException;
-function _getEnumFromValue(value, enumeration, defaultValue) {
-    if (typeof value !== 'string') {
-        return defaultValue;
-    }
-    if (Object.values(enumeration).includes(value)) {
-        return value;
-    }
-    return defaultValue;
-}
-async function parseJsonSchemaToSubCommandDescription(name, jsonPath, registry, schema) {
-    const options = await parseJsonSchemaToOptions(registry, schema);
-    const aliases = [];
-    if (core_1.json.isJsonArray(schema.$aliases)) {
-        schema.$aliases.forEach((value) => {
-            if (typeof value == 'string') {
-                aliases.push(value);
-            }
-        });
-    }
-    if (core_1.json.isJsonArray(schema.aliases)) {
-        schema.aliases.forEach((value) => {
-            if (typeof value == 'string') {
-                aliases.push(value);
-            }
-        });
-    }
-    if (typeof schema.alias == 'string') {
-        aliases.push(schema.alias);
-    }
-    let longDescription = '';
-    if (typeof schema.$longDescription == 'string' && schema.$longDescription) {
-        const ldPath = (0, path_1.resolve)((0, path_1.dirname)(jsonPath), schema.$longDescription);
-        try {
-            longDescription = (0, fs_1.readFileSync)(ldPath, 'utf-8');
-        }
-        catch (e) {
-            throw new CommandJsonPathException(ldPath, name);
-        }
-    }
-    let usageNotes = '';
-    if (typeof schema.$usageNotes == 'string' && schema.$usageNotes) {
-        const unPath = (0, path_1.resolve)((0, path_1.dirname)(jsonPath), schema.$usageNotes);
-        try {
-            usageNotes = (0, fs_1.readFileSync)(unPath, 'utf-8');
-        }
-        catch (e) {
-            throw new CommandJsonPathException(unPath, name);
-        }
-    }
-    const description = '' + (schema.description === undefined ? '' : schema.description);
-    return {
-        name,
-        description,
-        ...(longDescription ? { longDescription } : {}),
-        ...(usageNotes ? { usageNotes } : {}),
-        options,
-        aliases,
-    };
-}
-exports.parseJsonSchemaToSubCommandDescription = parseJsonSchemaToSubCommandDescription;
-async function parseJsonSchemaToCommandDescription(name, jsonPath, registry, schema) {
-    const subcommand = await parseJsonSchemaToSubCommandDescription(name, jsonPath, registry, schema);
-    // Before doing any work, let's validate the implementation.
-    if (typeof schema.$impl != 'string') {
-        throw new Error(`Command ${name} has an invalid implementation.`);
-    }
-    const ref = new tools_1.ExportStringRef(schema.$impl, (0, path_1.dirname)(jsonPath));
-    const impl = ref.ref;
-    if (impl === undefined || typeof impl !== 'function') {
-        throw new Error(`Command ${name} has an invalid implementation.`);
-    }
-    const scope = _getEnumFromValue(schema.$scope, interface_1.CommandScope, interface_1.CommandScope.Default);
-    const hidden = !!schema.$hidden;
-    return {
-        ...subcommand,
-        scope,
-        hidden,
-        impl,
-    };
-}
-exports.parseJsonSchemaToCommandDescription = parseJsonSchemaToCommandDescription;
-async function parseJsonSchemaToOptions(registry, schema) {
+async function parseJsonSchemaToOptions(registry, schema, interactive = true) {
     const options = [];
     function visitor(current, pointer, parentSchema) {
         if (!parentSchema) {
@@ -131,8 +38,7 @@ async function parseJsonSchemaToOptions(registry, schema) {
             throw new Error('Cannot find type of schema.');
         }
         // We only support number, string or boolean (or array of those), so remove everything else.
-        const types = [...typeSet]
-            .filter((x) => {
+        const types = [...typeSet].filter((x) => {
             switch (x) {
                 case 'boolean':
                 case 'number':
@@ -149,8 +55,7 @@ async function parseJsonSchemaToOptions(registry, schema) {
                 default:
                     return false;
             }
-        })
-            .map((x) => _getEnumFromValue(x, interface_1.OptionType, interface_1.OptionType.String));
+        });
         if (types.length == 0) {
             // This means it's not usable on the command line. e.g. an Object.
             return;
@@ -190,10 +95,11 @@ async function parseJsonSchemaToOptions(registry, schema) {
         const $default = current.$default;
         const $defaultIndex = core_1.json.isJsonObject($default) && $default['$source'] == 'argv' ? $default['index'] : undefined;
         const positional = typeof $defaultIndex == 'number' ? $defaultIndex : undefined;
-        const required = core_1.json.isJsonArray(current.required)
-            ? current.required.indexOf(name) != -1
-            : false;
-        const aliases = core_1.json.isJsonArray(current.aliases)
+        let required = core_1.json.isJsonArray(schema.required) ? schema.required.includes(name) : false;
+        if (required && interactive && current['x-prompt']) {
+            required = false;
+        }
+        const alias = core_1.json.isJsonArray(current.aliases)
             ? [...current.aliases].map((x) => '' + x)
             : current.alias
                 ? ['' + current.alias]
@@ -209,37 +115,30 @@ async function parseJsonSchemaToOptions(registry, schema) {
         const option = {
             name,
             description: '' + (current.description === undefined ? '' : current.description),
-            ...(types.length == 1 ? { type } : { type, types }),
-            ...(defaultValue !== undefined ? { default: defaultValue } : {}),
-            ...(enumValues && enumValues.length > 0 ? { enum: enumValues } : {}),
+            type,
+            default: defaultValue,
+            choices: enumValues.length ? enumValues : undefined,
             required,
-            aliases,
-            ...(format !== undefined ? { format } : {}),
+            alias,
+            format,
             hidden,
-            ...(userAnalytics ? { userAnalytics } : {}),
-            ...(deprecated !== undefined ? { deprecated } : {}),
-            ...(positional !== undefined ? { positional } : {}),
+            userAnalytics,
+            deprecated,
+            positional,
         };
         options.push(option);
     }
     const flattenedSchema = await registry.flatten(schema).toPromise();
     core_1.json.schema.visitJsonSchema(flattenedSchema, visitor);
-    // Sort by positional.
+    // Sort by positional and name.
     return options.sort((a, b) => {
         if (a.positional) {
-            if (b.positional) {
-                return a.positional - b.positional;
-            }
-            else {
-                return 1;
-            }
+            return b.positional ? a.positional - b.positional : a.name.localeCompare(b.name);
         }
         else if (b.positional) {
             return -1;
         }
-        else {
-            return 0;
-        }
+        return a.name.localeCompare(b.name);
     });
 }
 exports.parseJsonSchemaToOptions = parseJsonSchemaToOptions;

package/src/commands/add/add-impl.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 { SchematicCommand } from '../../../models/schematic-command';
+import { Options } from '../../command-builder/command-module';
+import { AddCommandArgs } from './cli';
+declare type AddCommandOptions = Options<AddCommandArgs>;
+export declare class AddCommandModule extends SchematicCommand<AddCommandOptions> {
+    readonly allowPrivateSchematics = true;
+    run(options: AddCommandOptions): Promise<number | void>;
+    private isProjectVersionValid;
+    reportAnalytics(paths: string[], options: AddCommandOptions, dimensions?: (boolean | number | string)[], metrics?: (boolean | number | string)[]): Promise<void>;
+    private isPackageInstalled;
+    private executeSchematic;
+    private findProjectVersion;
+    private hasMismatchedPeer;
+}
+export {};

package/{commands → src/commands/add}/add-impl.js

@@ -10,22 +10,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AddCommand = void 0;
+exports.AddCommandModule = void 0;
 const core_1 = require("@angular-devkit/core");
 const tools_1 = require("@angular-devkit/schematics/tools");
 const npm_package_arg_1 = __importDefault(require("npm-package-arg"));
 const path_1 = require("path");
 const semver_1 = require("semver");
-const workspace_schema_1 = require("../lib/config/workspace-schema");
-const analytics_1 = require("../models/analytics");
-const schematic_command_1 = require("../models/schematic-command");
-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");
-const tty_1 = require("../utilities/tty");
+const workspace_schema_1 = require("../../../lib/config/workspace-schema");
+const schematic_command_1 = require("../../../models/schematic-command");
+const analytics_1 = require("../../analytics/analytics");
+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");
+const tty_1 = require("../../utilities/tty");
 /**
  * The set of packages that should have certain versions excluded from consideration
  * when attempting to find a compatible version for a package.
@@ -35,19 +35,11 @@ const packageVersionExclusions = {
     // @angular/localize@9.x versions do not have peer dependencies setup
     '@angular/localize': '9.x',
 };
-class AddCommand extends schematic_command_1.SchematicCommand {
+class AddCommandModule extends schematic_command_1.SchematicCommand {
     constructor() {
         super(...arguments);
         this.allowPrivateSchematics = true;
     }
-    async initialize(options) {
-        if (options.registry) {
-            return super.initialize({ ...options, packageRegistry: options.registry });
-        }
-        else {
-            return super.initialize(options);
-        }
-    }
     // eslint-disable-next-line max-lines-per-function
     async run(options) {
         var _a;
@@ -72,7 +64,7 @@ class AddCommand extends schematic_command_1.SchematicCommand {
             if (validVersion) {
                 // Already installed so just run schematic
                 this.logger.info('Skipping installation: Package already installed');
-                return this.executeSchematic(packageIdentifier.name, options['--']);
+                return this.executeSchematic(packageIdentifier.name, options);
             }
         }
         const spinner = new spinner_1.Spinner();
@@ -205,7 +197,7 @@ class AddCommand extends schematic_command_1.SchematicCommand {
                 return status;
             }
         }
-        return this.executeSchematic(collectionName, options['--']);
+        return this.executeSchematic(collectionName, options);
     }
     async isProjectVersionValid(packageIdentifier) {
         if (!packageIdentifier.name) {
@@ -251,16 +243,16 @@ class AddCommand extends schematic_command_1.SchematicCommand {
         }
         return false;
     }
-    async executeSchematic(collectionName, options = []) {
-        const runOptions = {
-            schematicOptions: options,
-            collectionName,
-            schematicName: 'ng-add',
-            dryRun: false,
-            force: false,
-        };
+    async executeSchematic(collectionName, options) {
         try {
-            return await this.runSchematic(runOptions);
+            const { collection, verbose, registry, skipConfirmation, skipInstall, interactive, force, dryRun, defaults: defaultVal, ...schematicOptions } = options;
+            return await this.runSchematic({
+                schematicOptions,
+                collectionName,
+                schematicName: 'ng-add',
+                dryRun: false,
+                force: false,
+            });
         }
         catch (e) {
             if (e instanceof tools_1.NodePackageDoesNotSupportSchematics) {
@@ -336,4 +328,4 @@ class AddCommand extends schematic_command_1.SchematicCommand {
         return false;
     }
 }
-exports.AddCommand = AddCommand;
+exports.AddCommandModule = AddCommandModule;

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

@@ -0,0 +1,23 @@
+/**
+ * @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 { CommandModuleImplementation, Options, OtherOptions } from '../../command-builder/command-module';
+import { SchematicsCommandArgs, SchematicsCommandModule } from '../../command-builder/schematics-command-module';
+export interface AddCommandArgs extends SchematicsCommandArgs {
+    collection: string;
+    verbose?: boolean;
+    registry?: string;
+    'skip-confirmation'?: boolean;
+}
+export declare class AddCommandModule extends SchematicsCommandModule implements CommandModuleImplementation<AddCommandArgs> {
+    command: string;
+    describe: string;
+    longDescriptionPath: string;
+    builder(argv: Argv): Promise<Argv<AddCommandArgs>>;
+    run(options: Options<AddCommandArgs> & OtherOptions): Promise<number | void>;
+}

package/src/commands/add/cli.js

@@ -0,0 +1,48 @@
+"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.AddCommandModule = void 0;
+const path_1 = require("path");
+const schematics_command_module_1 = require("../../command-builder/schematics-command-module");
+const add_impl_1 = require("./add-impl");
+class AddCommandModule extends schematics_command_module_1.SchematicsCommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'add <collection>';
+        this.describe = 'Adds support for an external library to your project.';
+        this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');
+    }
+    async builder(argv) {
+        const localYargs = await super.builder(argv);
+        return localYargs
+            .positional('collection', {
+            description: 'The package to be added.',
+            type: 'string',
+            demandOption: true,
+        })
+            .option('registry', { description: 'The NPM registry to use.', type: 'string' })
+            .option('verbose', {
+            description: 'Display additional details about internal operations during execution.',
+            type: 'boolean',
+            default: false,
+        })
+            .option('skip-confirmation', {
+            description: 'Skip asking a confirmation prompt before installing and executing the package. ' +
+                'Ensure package name is correct prior to using this option.',
+            type: 'boolean',
+            default: false,
+        })
+            .strict(false);
+    }
+    run(options) {
+        const command = new add_impl_1.AddCommandModule(this.context, 'add');
+        return command.validateAndRun(options);
+    }
+}
+exports.AddCommandModule = AddCommandModule;

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

@@ -0,0 +1,21 @@
+/**
+ * @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, Options } from '../../command-builder/command-module';
+interface AnalyticsCommandArgs {
+    'setting-or-project': 'on' | 'off' | 'ci' | 'project' | 'prompt' | string;
+    'project-setting'?: 'on' | 'off' | 'prompt' | string;
+}
+export declare class AnalyticsCommandModule extends CommandModule<AnalyticsCommandArgs> {
+    command: string;
+    describe: string;
+    longDescriptionPath: string;
+    builder(localYargs: Argv): Argv<AnalyticsCommandArgs>;
+    run({ settingOrProject, projectSetting, }: Options<AnalyticsCommandArgs>): Promise<number | void>;
+}
+export {};

package/src/commands/analytics/cli.js

@@ -0,0 +1,70 @@
+"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.AnalyticsCommandModule = void 0;
+const path_1 = require("path");
+const analytics_1 = require("../../analytics/analytics");
+const command_module_1 = require("../../command-builder/command-module");
+class AnalyticsCommandModule extends command_module_1.CommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'analytics <setting-or-project>';
+        this.describe = 'Configures the gathering of Angular CLI usage metrics.';
+        this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');
+    }
+    builder(localYargs) {
+        return localYargs
+            .positional('setting-or-project', {
+            description: 'Directly enables or disables all usage analytics for the user, or prompts the user to set the status interactively, ' +
+                'or sets the default status for the project.',
+            choices: ['on', 'off', 'ci', 'prompt'],
+            type: 'string',
+            demandOption: true,
+        })
+            .positional('project-setting', {
+            description: 'Sets the default analytics enablement status for the project.',
+            choices: ['on', 'off', 'prompt'],
+            type: 'string',
+        })
+            .strict();
+    }
+    async run({ settingOrProject, projectSetting, }) {
+        if (settingOrProject === 'project' && projectSetting === undefined) {
+            throw new Error('Argument "project" requires a second argument of one of the following value: on, off.');
+        }
+        switch (settingOrProject) {
+            case 'off':
+                (0, analytics_1.setAnalyticsConfig)('global', false);
+                break;
+            case 'on':
+                (0, analytics_1.setAnalyticsConfig)('global', true);
+                break;
+            case 'ci':
+                (0, analytics_1.setAnalyticsConfig)('global', 'ci');
+                break;
+            case 'project':
+                switch (projectSetting) {
+                    case 'off':
+                        (0, analytics_1.setAnalyticsConfig)('local', false);
+                        break;
+                    case 'on':
+                        (0, analytics_1.setAnalyticsConfig)('local', true);
+                        break;
+                    case 'prompt':
+                        await (0, analytics_1.promptProjectAnalytics)(true);
+                        break;
+                }
+                break;
+            case 'prompt':
+                await (0, analytics_1.promptGlobalAnalytics)(true);
+                break;
+        }
+    }
+}
+exports.AnalyticsCommandModule = AnalyticsCommandModule;

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

@@ -0,0 +1,10 @@
+The value of `setting-or-project` is one of the following.
+
+- `on`: Enables analytics gathering and reporting for the user.
+- `off`: Disables analytics gathering and reporting for the user.
+- `ci`: Enables analytics and configures reporting for use with Continuous Integration,
+  which uses a common CI user.
+- `prompt`: Prompts the user to set the status interactively.
+- `project`: Sets the default status for the project to the `project-setting` value, which can be any of the other values. The `project-setting` argument is ignored for all other values of `setting_or_project`.
+
+For further details, see [Gathering an Viewing CLI Usage Analytics](cli/usage-analytics-gathering).

package/src/commands/build/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 { ArchitectCommandModule } from '../../command-builder/architect-command-module';
+import { CommandModuleImplementation } from '../../command-builder/command-module';
+export declare class BuildCommandModule extends ArchitectCommandModule implements CommandModuleImplementation {
+    multiTarget: boolean;
+    command: string;
+    aliases: string[];
+    describe: string;
+    longDescriptionPath: string;
+}

package/src/commands/build/cli.js

@@ -0,0 +1,23 @@
+"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.BuildCommandModule = void 0;
+const path_1 = require("path");
+const architect_command_module_1 = require("../../command-builder/architect-command-module");
+class BuildCommandModule extends architect_command_module_1.ArchitectCommandModule {
+    constructor() {
+        super(...arguments);
+        this.multiTarget = false;
+        this.command = 'build [project]';
+        this.aliases = ['b'];
+        this.describe = 'Compiles an Angular application or library into an output directory named dist/ at the given output path.';
+        this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');
+    }
+}
+exports.BuildCommandModule = BuildCommandModule;