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

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

@@ -0,0 +1,24 @@
+/**
+ * @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, Options } from '../../command-builder/command-module';
+interface ConfigCommandArgs {
+    'json-path'?: string;
+    value?: string;
+    global?: boolean;
+}
+export declare class ConfigCommandModule extends CommandModule<ConfigCommandArgs> implements CommandModuleImplementation<ConfigCommandArgs> {
+    command: string;
+    describe: string;
+    longDescriptionPath: string;
+    builder(localYargs: Argv): Argv<ConfigCommandArgs>;
+    run(options: Options<ConfigCommandArgs>): Promise<number | void>;
+    private get;
+    private set;
+}
+export {};

package/{commands/config-impl.js → src/commands/config/cli.js}

@@ -7,23 +7,108 @@
  * found in the LICENSE file at https://angular.io/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigCommand = void 0;
+exports.ConfigCommandModule = void 0;
+const path_1 = require("path");
 const uuid_1 = require("uuid");
-const command_1 = require("../models/command");
-const interface_1 = require("../models/interface");
-const config_1 = require("../utilities/config");
-const json_file_1 = require("../utilities/json-file");
-const validCliPaths = new Map([
-    ['cli.warnings.versionMismatch', undefined],
-    ['cli.defaultCollection', 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 command_module_1 = require("../../command-builder/command-module");
+const config_1 = require("../../utilities/config");
+const json_file_1 = require("../../utilities/json-file");
+class ConfigCommandModule extends command_module_1.CommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'config [json-path] [value]';
+        this.describe = 'Retrieves or sets Angular configuration values in the angular.json file for the workspace.';
+        this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');
+    }
+    builder(localYargs) {
+        return localYargs
+            .positional('json-path', {
+            description: `The configuration key to set or query, in JSON path format. ` +
+                `For example: "a[3].foo.bar[2]". If no new value is provided, returns the current value of this key.`,
+            type: 'string',
+        })
+            .positional('value', {
+            description: 'If provided, a new value for the given configuration key.',
+            type: 'string',
+        })
+            .option('global', {
+            description: `Access the global configuration in the caller's home directory.`,
+            alias: ['g'],
+            type: 'boolean',
+            default: false,
+        })
+            .strict();
+    }
+    async run(options) {
+        const level = options.global ? 'global' : 'local';
+        const [config] = (0, config_1.getWorkspaceRaw)(level);
+        if (options.value == undefined) {
+            if (!config) {
+                this.context.logger.error('No config found.');
+                return 1;
+            }
+            return this.get(config, options);
+        }
+        else {
+            return this.set(options);
+        }
+    }
+    get(jsonFile, options) {
+        const { logger } = this.context;
+        const value = options.jsonPath
+            ? jsonFile.get(parseJsonPath(options.jsonPath))
+            : jsonFile.content;
+        if (value === undefined) {
+            logger.error('Value cannot be found.');
+            return 1;
+        }
+        else if (typeof value === 'string') {
+            logger.info(value);
+        }
+        else {
+            logger.info(JSON.stringify(value, null, 2));
+        }
+        return 0;
+    }
+    async set(options) {
+        var _a, _b, _c;
+        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],
+        ]);
+        if (options.global &&
+            !options.jsonPath.startsWith('schematics.') &&
+            !validCliPaths.has(options.jsonPath)) {
+            throw new command_module_1.CommandModuleError('Invalid Path.');
+        }
+        const [config, configPath] = (0, config_1.getWorkspaceRaw)(options.global ? 'global' : 'local');
+        const { logger } = this.context;
+        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 modified = config.modify(parseJsonPath(options.jsonPath), normalizeValue(value));
+        if (!modified) {
+            logger.error('Value cannot be found.');
+            return 1;
+        }
+        await (0, config_1.validateWorkspace)((0, json_file_1.parseJson)(config.content));
+        config.save();
+        return 0;
+    }
+}
+exports.ConfigCommandModule = ConfigCommandModule;
 /**
  * Splits a JSON path string into fragments. Fragments can be used to get the value referenced
  * by the path. For example, a path of "a[3].foo.bar[2]" would give you a fragment array of
@@ -42,7 +127,7 @@ function parseJsonPath(path) {
         }
         const match = fragment.match(/([^[]+)((\[.*\])*)/);
         if (!match) {
-            throw new Error('Invalid JSON path.');
+            throw new command_module_1.CommandModuleError('Invalid JSON path.');
         }
         result.push(match[1]);
         if (match[2]) {
@@ -81,75 +166,3 @@ function normalizeValue(value) {
         return value;
     }
 }
-class ConfigCommand extends command_1.Command {
-    async run(options) {
-        const level = options.global ? 'global' : 'local';
-        if (!options.global) {
-            await this.validateScope(interface_1.CommandScope.InProject);
-        }
-        const [config] = (0, config_1.getWorkspaceRaw)(level);
-        if (options.value == undefined) {
-            if (!config) {
-                this.logger.error('No config found.');
-                return 1;
-            }
-            return this.get(config, options);
-        }
-        else {
-            return this.set(options);
-        }
-    }
-    get(jsonFile, options) {
-        let value;
-        if (options.jsonPath) {
-            value = jsonFile.get(parseJsonPath(options.jsonPath));
-        }
-        else {
-            value = jsonFile.content;
-        }
-        if (value === undefined) {
-            this.logger.error('Value cannot be found.');
-            return 1;
-        }
-        else if (typeof value === 'string') {
-            this.logger.info(value);
-        }
-        else {
-            this.logger.info(JSON.stringify(value, null, 2));
-        }
-        return 0;
-    }
-    async set(options) {
-        var _a, _b, _c;
-        if (!((_a = options.jsonPath) === null || _a === void 0 ? void 0 : _a.trim())) {
-            throw new Error('Invalid Path.');
-        }
-        if (options.global &&
-            !options.jsonPath.startsWith('schematics.') &&
-            !validCliPaths.has(options.jsonPath)) {
-            throw new Error('Invalid Path.');
-        }
-        const [config, configPath] = (0, config_1.getWorkspaceRaw)(options.global ? 'global' : 'local');
-        if (!config || !configPath) {
-            this.logger.error('Confguration file cannot be found.');
-            return 1;
-        }
-        const jsonPath = parseJsonPath(options.jsonPath);
-        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 modified = config.modify(jsonPath, normalizeValue(value));
-        if (!modified) {
-            this.logger.error('Value cannot be found.');
-            return 1;
-        }
-        try {
-            await (0, config_1.validateWorkspace)((0, json_file_1.parseJson)(config.content));
-        }
-        catch (error) {
-            this.logger.fatal(error.message);
-            return 1;
-        }
-        config.save();
-        return 0;
-    }
-}
-exports.ConfigCommand = ConfigCommand;

package/{commands/config-long.md → src/commands/config/long-description.md}

@@ -6,8 +6,8 @@ or indirectly on the command line using this command.
 
 The configurable property names match command option names,
 except that in the configuration file, all names must use camelCase,
-while on the command line options can be given in either camelCase or dash-case.
+while on the command line options can be given dash-case.
 
 For further details, see [Workspace Configuration](guide/workspace-config).
 
-For configuration of CLI usage analytics, see [Gathering an Viewing CLI Usage Analytics](./usage-analytics-gathering).
+For configuration of CLI usage analytics, see [Gathering an Viewing CLI Usage Analytics](cli/usage-analytics-gathering).

package/src/commands/deploy/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 DeployCommandModule extends ArchitectCommandModule implements CommandModuleImplementation {
+    missingErrorTarget: string;
+    multiTarget: boolean;
+    command: string;
+    longDescriptionPath: string;
+    describe: string;
+}

package/src/commands/deploy/cli.js

@@ -0,0 +1,35 @@
+"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.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
+  `;
+        this.multiTarget = false;
+        this.command = 'deploy [project]';
+        this.longDescriptionPath = (0, path_1.join)(__dirname, 'long-description.md');
+        this.describe = 'Invokes the deploy builder for a specified project or for the default project in the workspace.';
+    }
+}
+exports.DeployCommandModule = DeployCommandModule;

package/src/commands/doc/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 { CommandModule, CommandModuleImplementation, Options } from '../../command-builder/command-module';
+interface DocCommandArgs {
+    keyword: string;
+    search?: boolean;
+    version?: string;
+}
+export declare class DocCommandModule extends CommandModule<DocCommandArgs> implements CommandModuleImplementation<DocCommandArgs> {
+    command: string;
+    aliases: string[];
+    describe: string;
+    longDescriptionPath?: string;
+    builder(localYargs: Argv): Argv<DocCommandArgs>;
+    run(options: Options<DocCommandArgs>): Promise<number | void>;
+}
+export {};

package/{commands/doc-impl.js → src/commands/doc/cli.js}

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[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];
@@ -29,28 +33,53 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocCommand = void 0;
+exports.DocCommandModule = void 0;
 const open_1 = __importDefault(require("open"));
-const command_1 = require("../models/command");
-class DocCommand extends command_1.Command {
+const command_module_1 = require("../../command-builder/command-module");
+class DocCommandModule extends command_module_1.CommandModule {
+    constructor() {
+        super(...arguments);
+        this.command = 'doc <keyword>';
+        this.aliases = ['d'];
+        this.describe = 'Opens the official Angular documentation (angular.io) in a browser, and searches for a given keyword.';
+    }
+    builder(localYargs) {
+        return localYargs
+            .positional('keyword', {
+            description: 'The keyword to search for, as provided in the search bar in angular.io.',
+            type: 'string',
+            demandOption: true,
+        })
+            .option('search', {
+            description: `Search all of angular.io. Otherwise, searches only API reference documentation.`,
+            alias: ['s'],
+            type: 'boolean',
+            default: false,
+        })
+            .option('version', {
+            description: 'Contains the version of Angular to use for the documentation. ' +
+                'If not provided, the command uses your current Angular core version.',
+            type: 'string',
+        })
+            .strict();
+    }
     async run(options) {
-        if (!options.keyword) {
-            this.logger.error('You should specify a keyword, for instance, `ng doc ActivatedRoute`.');
-            return 0;
-        }
         let domain = 'angular.io';
         if (options.version) {
             // version can either be a string containing "next"
-            if (options.version == 'next') {
+            if (options.version === 'next') {
                 domain = 'next.angular.io';
+            }
+            else if (options.version === 'rc') {
+                domain = 'rc.angular.io';
                 // or a number where version must be a valid Angular version (i.e. not 0, 1 or 3)
             }
             else if (!isNaN(+options.version) && ![0, 1, 3].includes(+options.version)) {
                 domain = `v${options.version}.angular.io`;
             }
             else {
-                this.logger.error('Version should either be a number (2, 4, 5, 6...) or "next"');
-                return 0;
+                this.context.logger.error('Version should either be a number (2, 4, 5, 6...), "rc" or "next"');
+                return 1;
             }
         }
         else {
@@ -68,4 +97,4 @@ class DocCommand extends command_1.Command {
             : `https://${domain}/docs?search=${options.keyword}`);
     }
 }
-exports.DocCommand = DocCommand;
+exports.DocCommandModule = DocCommandModule;

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+import { ArchitectCommandModule } from '../../command-builder/architect-command-module';
+import { CommandModuleImplementation } from '../../command-builder/command-module';
+export declare class E2eCommandModule extends ArchitectCommandModule implements CommandModuleImplementation {
+    multiTarget: boolean;
+    missingErrorTarget: string;
+    command: string;
+    aliases: string[];
+    describe: string;
+    longDescriptionPath?: string;
+}

package/src/commands/e2e/cli.js

@@ -0,0 +1,34 @@
+"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.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.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.';
+    }
+}
+exports.E2eCommandModule = E2eCommandModule;

package/src/commands/extract-i18n/cli.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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 ExtractI18nCommandModule extends ArchitectCommandModule implements CommandModuleImplementation {
+    multiTarget: boolean;
+    command: string;
+    describe: string;
+    longDescriptionPath?: string | undefined;
+}

package/src/commands/extract-i18n/cli.js

@@ -0,0 +1,20 @@
+"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.ExtractI18nCommandModule = void 0;
+const architect_command_module_1 = require("../../command-builder/architect-command-module");
+class ExtractI18nCommandModule extends architect_command_module_1.ArchitectCommandModule {
+    constructor() {
+        super(...arguments);
+        this.multiTarget = false;
+        this.command = 'extract-i18n [project]';
+        this.describe = 'Extracts i18n messages from source code.';
+    }
+}
+exports.ExtractI18nCommandModule = ExtractI18nCommandModule;

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

@@ -0,0 +1,39 @@
+/**
+ * @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';
+interface GenerateCommandArgs extends SchematicsCommandArgs {
+    schematic?: string;
+}
+export declare class GenerateCommandModule extends SchematicsCommandModule implements CommandModuleImplementation<GenerateCommandArgs> {
+    command: string;
+    aliases: string;
+    describe: string;
+    longDescriptionPath?: string | undefined;
+    builder(argv: Argv): Promise<Argv<GenerateCommandArgs>>;
+    run(options: Options<GenerateCommandArgs> & OtherOptions): Promise<number | void>;
+    private getCollectionNames;
+    /**
+     * Generate a command string to be passed to the command builder.
+     *
+     * @example `component [name]` or `@schematics/angular:component [name]`.
+     */
+    private generateCommandString;
+    /**
+     * Get schematics that can to be registered as subcommands.
+     */
+    private getSchematics;
+    /**
+     * Get schematics that should to be registered as subcommands.
+     *
+     * @returns a sorted list of schematic that needs to be registered as subcommands.
+     */
+    private getSchematicsToRegister;
+}
+export {};