@angular/cli 14.0.0-next.1 → 14.0.0-next.12

package/models/command.js

@@ -1,143 +0,0 @@
-"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.Command = void 0;
-const core_1 = require("@angular-devkit/core");
-const color_1 = require("../utilities/color");
-const interface_1 = require("./interface");
-class Command {
-    constructor(context, description, logger) {
-        this.context = context;
-        this.description = description;
-        this.logger = logger;
-        this.allowMissingWorkspace = false;
-        this.useReportAnalytics = true;
-        this.workspace = context.workspace;
-        this.analytics = context.analytics || new core_1.analytics.NoopAnalytics();
-    }
-    static setCommandMap(map) {
-        this.commandMap = map;
-    }
-    async initialize(options) { }
-    async printHelp() {
-        await this.printHelpUsage();
-        await this.printHelpOptions();
-        return 0;
-    }
-    async printJsonHelp() {
-        const replacer = (key, value) => key === 'name' ? core_1.strings.dasherize(value) : value;
-        this.logger.info(JSON.stringify(this.description, replacer, 2));
-        return 0;
-    }
-    async printHelpUsage() {
-        this.logger.info(this.description.description);
-        const name = this.description.name;
-        const args = this.description.options.filter((x) => x.positional !== undefined);
-        const opts = this.description.options.filter((x) => x.positional === undefined);
-        const argDisplay = args && args.length > 0 ? ' ' + args.map((a) => `<${a.name}>`).join(' ') : '';
-        const optionsDisplay = opts && opts.length > 0 ? ` [options]` : ``;
-        this.logger.info(`usage: ng ${name}${argDisplay}${optionsDisplay}`);
-        this.logger.info('');
-    }
-    async printHelpOptions(options = this.description.options) {
-        const args = options.filter((opt) => opt.positional !== undefined);
-        const opts = options.filter((opt) => opt.positional === undefined);
-        const formatDescription = (description) => `    ${description.replace(/\n/g, '\n    ')}`;
-        if (args.length > 0) {
-            this.logger.info(`arguments:`);
-            args.forEach((o) => {
-                this.logger.info(`  ${color_1.colors.cyan(o.name)}`);
-                if (o.description) {
-                    this.logger.info(formatDescription(o.description));
-                }
-            });
-        }
-        if (options.length > 0) {
-            if (args.length > 0) {
-                this.logger.info('');
-            }
-            this.logger.info(`options:`);
-            opts
-                .filter((o) => !o.hidden)
-                .sort((a, b) => a.name.localeCompare(b.name))
-                .forEach((o) => {
-                const aliases = o.aliases && o.aliases.length > 0
-                    ? '(' + o.aliases.map((a) => `-${a}`).join(' ') + ')'
-                    : '';
-                this.logger.info(`  ${color_1.colors.cyan('--' + core_1.strings.dasherize(o.name))} ${aliases}`);
-                if (o.description) {
-                    this.logger.info(formatDescription(o.description));
-                }
-            });
-        }
-    }
-    async validateScope(scope) {
-        switch (scope === undefined ? this.description.scope : scope) {
-            case interface_1.CommandScope.OutProject:
-                if (this.workspace) {
-                    this.logger.fatal(core_1.tags.oneLine `
-            The ${this.description.name} command requires to be run outside of a project, but a
-            project definition was found at "${this.workspace.filePath}".
-          `);
-                    // eslint-disable-next-line no-throw-literal
-                    throw 1;
-                }
-                break;
-            case interface_1.CommandScope.InProject:
-                if (!this.workspace) {
-                    this.logger.fatal(core_1.tags.oneLine `
-            The ${this.description.name} command requires to be run in an Angular project, but a
-            project definition could not be found.
-          `);
-                    // eslint-disable-next-line no-throw-literal
-                    throw 1;
-                }
-                break;
-            case interface_1.CommandScope.Everywhere:
-                // Can't miss this.
-                break;
-        }
-    }
-    async reportAnalytics(paths, options, dimensions = [], metrics = []) {
-        for (const option of this.description.options) {
-            const ua = option.userAnalytics;
-            const v = options[option.name];
-            if (v !== undefined && !Array.isArray(v) && ua) {
-                dimensions[ua] = v;
-            }
-        }
-        this.analytics.pageview('/command/' + paths.join('/'), { dimensions, metrics });
-    }
-    async validateAndRun(options) {
-        if (!(options.help === true || options.help === 'json' || options.help === 'JSON')) {
-            await this.validateScope();
-        }
-        let result = await this.initialize(options);
-        if (typeof result === 'number' && result !== 0) {
-            return result;
-        }
-        if (options.help === true) {
-            return this.printHelp();
-        }
-        else if (options.help === 'json' || options.help === 'JSON') {
-            return this.printJsonHelp();
-        }
-        else {
-            const startTime = +new Date();
-            if (this.useReportAnalytics) {
-                await this.reportAnalytics([this.description.name], options);
-            }
-            result = await this.run(options);
-            const endTime = +new Date();
-            this.analytics.timing(this.description.name, 'duration', endTime - startTime);
-            return result;
-        }
-    }
-}
-exports.Command = Command;

package/models/interface.d.ts

@@ -1,196 +0,0 @@
-/**
- * @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 { analytics, json, logging } from '@angular-devkit/core';
-import { AngularWorkspace } from '../utilities/config';
-/**
- * Value type of arguments.
- */
-export declare type Value = number | string | boolean | (number | string | boolean)[];
-/**
- * An object representing parsed arguments from the command line.
- */
-export interface Arguments {
-    [argName: string]: Value | undefined;
-    /**
-     * Extra arguments that were not parsed. Will be omitted if all arguments were parsed.
-     */
-    '--'?: string[];
-}
-/**
- * The base interface for Command, understood by the command runner.
- */
-export interface CommandInterface<T extends Arguments = Arguments> {
-    printHelp(options: T): Promise<number>;
-    printJsonHelp(options: T): Promise<number>;
-    validateAndRun(options: T): Promise<number>;
-}
-/**
- * Command constructor.
- */
-export interface CommandConstructor {
-    new (context: CommandContext, description: CommandDescription, logger: logging.Logger): CommandInterface;
-}
-/**
- * A command runner context.
- */
-export interface CommandContext {
-    currentDirectory: string;
-    root: string;
-    workspace?: AngularWorkspace;
-    analytics?: analytics.Analytics;
-}
-/**
- * Value types of an Option.
- */
-export declare enum OptionType {
-    Any = "any",
-    Array = "array",
-    Boolean = "boolean",
-    Number = "number",
-    String = "string"
-}
-/**
- * An option description. This is exposed when using `ng --help=json`.
- */
-export interface Option {
-    /**
-     * The name of the option.
-     */
-    name: string;
-    /**
-     * A short description of the option.
-     */
-    description: string;
-    /**
-     * The type of option value. If multiple types exist, this type will be the first one, and the
-     * types array will contain all types accepted.
-     */
-    type: OptionType;
-    /**
-     * {@see type}
-     */
-    types?: OptionType[];
-    /**
-     * If this field is set, only values contained in this field are valid. This array can be mixed
-     * types (strings, numbers, boolean). For example, if this field is "enum: ['hello', true]",
-     * then "type" will be either string or boolean, types will be at least both, and the values
-     * accepted will only be either 'hello' or true (not false or any other string).
-     * This mean that prefixing with `no-` will not work on this field.
-     */
-    enum?: Value[];
-    /**
-     * If this option maps to a subcommand in the parent command, will contain all the subcommands
-     * supported. There is a maximum of 1 subcommand Option per command, and the type of this
-     * option will always be "string" (no other types). The value of this option will map into
-     * this map and return the extra information.
-     */
-    subcommands?: {
-        [name: string]: SubCommandDescription;
-    };
-    /**
-     * Aliases supported by this option.
-     */
-    aliases: 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;
-    /**
-     * Default value of this option.
-     */
-    default?: string | number | boolean;
-    /**
-     * If this option can be used as an argument, the position of the argument. Otherwise omitted.
-     */
-    positional?: number;
-    /**
-     * Smart default object.
-     */
-    $default?: OptionSmartDefault;
-    /**
-     * 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;
-    /**
-     * Deprecation. If this flag is not false a warning will be shown on the console. Either `true`
-     * or a string to show the user as a notice.
-     */
-    deprecated?: boolean | string;
-}
-/**
- * Scope of the command.
- */
-export declare enum CommandScope {
-    InProject = "in",
-    OutProject = "out",
-    Everywhere = "all",
-    Default = "in"
-}
-/**
- * A description of a command and its options.
- */
-export interface SubCommandDescription {
-    /**
-     * The name of the subcommand.
-     */
-    name: string;
-    /**
-     * Short description (1-2 lines) of this sub command.
-     */
-    description: string;
-    /**
-     * A long description of the sub command, in Markdown format.
-     */
-    longDescription?: string;
-    /**
-     * Additional notes about usage of this sub command, in Markdown format.
-     */
-    usageNotes?: string;
-    /**
-     * List of all supported options.
-     */
-    options: Option[];
-    /**
-     * Aliases supported for this sub command.
-     */
-    aliases: string[];
-}
-/**
- * A description of a command, its metadata.
- */
-export interface CommandDescription extends SubCommandDescription {
-    /**
-     * Scope of the command, whether it can be executed in a project, outside of a project or
-     * anywhere.
-     */
-    scope: CommandScope;
-    /**
-     * Whether this command should be hidden from a list of all commands.
-     */
-    hidden: boolean;
-    /**
-     * The constructor of the command, which should be extending the abstract Command<> class.
-     */
-    impl: CommandConstructor;
-}
-export interface OptionSmartDefault {
-    $source: string;
-    [key: string]: json.JsonValue;
-}
-export interface CommandDescriptionMap {
-    [key: string]: CommandDescription;
-}

package/models/interface.js

@@ -1,31 +0,0 @@
-"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.CommandScope = exports.OptionType = void 0;
-/**
- * Value types of an Option.
- */
-var OptionType;
-(function (OptionType) {
-    OptionType["Any"] = "any";
-    OptionType["Array"] = "array";
-    OptionType["Boolean"] = "boolean";
-    OptionType["Number"] = "number";
-    OptionType["String"] = "string";
-})(OptionType = exports.OptionType || (exports.OptionType = {}));
-/**
- * Scope of the command.
- */
-var CommandScope;
-(function (CommandScope) {
-    CommandScope["InProject"] = "in";
-    CommandScope["OutProject"] = "out";
-    CommandScope["Everywhere"] = "all";
-    CommandScope["Default"] = "in";
-})(CommandScope = exports.CommandScope || (exports.CommandScope = {}));

package/models/parser.d.ts

@@ -1,39 +0,0 @@
-/**
- * @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 { BaseException, logging } from '@angular-devkit/core';
-import { Arguments, Option } from './interface';
-export declare class ParseArgumentException extends BaseException {
-    readonly comments: string[];
-    readonly parsed: Arguments;
-    readonly ignored: string[];
-    constructor(comments: string[], parsed: Arguments, ignored: string[]);
-}
-/**
- * Parse the arguments in a consistent way, but without having any option definition. This tries
- * to assess what the user wants in a free form. For example, using `--name=false` will set the
- * name properties to a boolean type.
- * This should only be used when there's no schema available or if a schema is "true" (anything is
- * valid).
- *
- * @param args Argument list to parse.
- * @returns An object that contains a property per flags from the args.
- */
-export declare function parseFreeFormArguments(args: string[]): Arguments;
-/**
- * Parse the arguments in a consistent way, from a list of standardized options.
- * The result object will have a key per option name, with the `_` key reserved for positional
- * arguments, and `--` will contain everything that did not match. Any key that don't have an
- * option will be pushed back in `--` and removed from the object. If you need to validate that
- * there's no additionalProperties, you need to check the `--` key.
- *
- * @param args The argument array to parse.
- * @param options List of supported options. {@see Option}.
- * @param logger Logger to use to warn users.
- * @returns An object that contains a property per option.
- */
-export declare function parseArguments(args: string[], options: Option[] | null, logger?: logging.Logger): Arguments;