apify-cli 0.21.7 → 0.21.8-beta.0

package/dist/lib/command-framework/apify-command.js

@@ -0,0 +1,342 @@
+/* eslint-disable max-classes-per-file */
+import chalk from 'chalk';
+import indentString from 'indent-string';
+import widestLine from 'widest-line';
+import wrapAnsi from 'wrap-ansi';
+import { cachedStdinInput } from '../../entrypoints/_shared.js';
+import { error } from '../outputs.js';
+import { registerCommandForHelpGeneration, renderHelpForCommand, selectiveRenderHelpForCommand } from './help.js';
+import { getMaxLineWidth } from './help/consts.js';
+export var StdinMode;
+(function (StdinMode) {
+    StdinMode[StdinMode["Raw"] = 1] = "Raw";
+    StdinMode[StdinMode["Stringified"] = 2] = "Stringified";
+})(StdinMode || (StdinMode = {}));
+export function camelCaseString(str) {
+    return str.replace(/[-_\s](.)/g, (_, group1) => group1.toUpperCase());
+}
+export function kebabCaseString(str) {
+    return str.replace(/[\s_]+/g, '-');
+}
+export function camelCaseToKebabCase(str) {
+    return str.replace(/([A-Z])/g, '-$1').toLowerCase();
+}
+export const commandRegistry = new Map();
+export class ApifyCommand {
+    static args;
+    static flags;
+    static subcommands;
+    static enableJsonFlag = false;
+    static name;
+    static shortDescription;
+    static description;
+    static aliases;
+    static hidden;
+    static hiddenAliases;
+    telemetryData = {};
+    flags;
+    args;
+    get ctor() {
+        return this.constructor;
+    }
+    pluralString(amount, singular, plural) {
+        return amount === 1 ? singular : plural;
+    }
+    printHelp() {
+        console.log(renderHelpForCommand(this.ctor));
+        process.exit(0);
+    }
+    async _run(rawArgs) {
+        if (rawArgs.help) {
+            this.printHelp();
+        }
+        // Cheating a bit here with the types, but its fine
+        this.args = {};
+        this.flags = {};
+        // If we have this set, we assume that the user wants only the flag
+        if (this.ctor.enableJsonFlag) {
+            if (typeof rawArgs.json === 'boolean') {
+                this.flags.json = rawArgs.json;
+            }
+            else {
+                // Idk exactly if this is achievable but 🤷
+                this.flags.json = false;
+            }
+        }
+        const missingRequiredArgs = new Map();
+        if (this.ctor.args) {
+            for (const [userArgName, builderData] of Object.entries(this.ctor.args)) {
+                if (typeof builderData === 'string') {
+                    throw new RangeError('Do not provide the string for the json arg! It is a type level assertion!');
+                }
+                const yargsArgName = userArgName.replaceAll(' ', '');
+                const camelCasedName = camelCaseString(userArgName);
+                if (rawArgs[yargsArgName]) {
+                    switch (builderData.argTag) {
+                        case 'string':
+                        default:
+                            this.args[camelCasedName] = String(rawArgs[yargsArgName]);
+                            if (rawArgs[yargsArgName] === '-' && builderData.stdin) {
+                                this.args[camelCasedName] = this._handleStdin(builderData.stdin);
+                            }
+                            break;
+                    }
+                }
+                else if (builderData.required) {
+                    missingRequiredArgs.set(userArgName, builderData);
+                }
+            }
+        }
+        if (missingRequiredArgs.size) {
+            this._printMissingRequiredArgs(missingRequiredArgs);
+            return;
+        }
+        if (this.ctor.flags) {
+            for (const [userFlagName, builderData] of Object.entries(this.ctor.flags)) {
+                if (typeof builderData === 'string') {
+                    throw new RangeError('Do not provide the string for the json arg! It is a type level assertion!');
+                }
+                const rawYargsFlagName = kebabCaseString(camelCaseToKebabCase(userFlagName)).toLowerCase();
+                const camelCasedName = camelCaseString(rawYargsFlagName);
+                let yargsFlagName = rawYargsFlagName;
+                if (rawYargsFlagName.startsWith('no-')) {
+                    yargsFlagName = rawYargsFlagName.slice(3);
+                }
+                if (typeof rawArgs[yargsFlagName] !== 'undefined') {
+                    if (Array.isArray(rawArgs[yargsFlagName])) {
+                        error({
+                            message: `Flag --${yargsFlagName} can only be specified once`,
+                        });
+                        return;
+                    }
+                    switch (builderData.flagTag) {
+                        case 'boolean': {
+                            this.flags[camelCasedName] = rawYargsFlagName.startsWith('no-')
+                                ? !rawArgs[yargsFlagName]
+                                : rawArgs[yargsFlagName];
+                            break;
+                        }
+                        case 'integer': {
+                            const parsed = Number(rawArgs[yargsFlagName]);
+                            if (Number.isNaN(parsed) || !Number.isInteger(parsed)) {
+                                error({
+                                    message: `The provided value for the '--${yargsFlagName}' flag could not be processed as an integer.`,
+                                });
+                                return;
+                            }
+                            this.flags[camelCasedName] = parsed;
+                            break;
+                        }
+                        case 'string':
+                        default: {
+                            this.flags[camelCasedName] = rawArgs[yargsFlagName];
+                            if (rawArgs[yargsFlagName] === '-' && builderData.stdin) {
+                                this.flags[camelCasedName] = this._handleStdin(builderData.stdin);
+                            }
+                            if (!this.flags[camelCasedName]) {
+                                error({
+                                    message: `Flag --${yargsFlagName} expects a value`,
+                                });
+                                return;
+                            }
+                            break;
+                        }
+                    }
+                }
+                else if (builderData.required) {
+                    error({
+                        message: `Flag --${yargsFlagName} is required`,
+                    });
+                    return;
+                }
+            }
+        }
+        try {
+            await this.run();
+        }
+        catch (err) {
+            error({ message: err.message });
+        }
+        finally {
+            // analytics
+            /*
+            eventData.installationType = detectInstallationType();
+
+            if (!this.telemetryData.actorLanguage && command && COMMANDS_WITHIN_ACTOR.includes(command)) {
+                const cwdProject = await useCwdProject();
+
+                cwdProject.inspect((project) => {
+                    if (project.type === ProjectLanguage.JavaScript) {
+                        eventData.actorLanguage = LANGUAGE.NODEJS;
+                        eventData.actorNodejsVersion = project.runtime!.version;
+                    } else if (project.type === ProjectLanguage.Python || project.type === ProjectLanguage.Scrapy) {
+                        eventData.actorLanguage = LANGUAGE.PYTHON;
+                        eventData.actorPythonVersion = project.runtime!.version;
+                    }
+                });
+            }
+
+            await maybeTrackTelemetry({
+                eventName: `cli_command_${command}`,
+                eventData,
+            });
+            */
+        }
+    }
+    _printMissingRequiredArgs(missingRequiredArgs) {
+        const help = selectiveRenderHelpForCommand(this.ctor, {
+            showUsageString: true,
+        });
+        const widestArgNameLength = widestLine([...missingRequiredArgs.keys()].join('\n'));
+        const missingArgsStrings = [];
+        for (const [argName, arg] of missingRequiredArgs) {
+            const fullString = `${argName.padEnd(widestArgNameLength)}  ${arg.description}`;
+            const wrapped = wrapAnsi(fullString, getMaxLineWidth() - widestArgNameLength - 2);
+            const indented = indentString(wrapped, widestArgNameLength + 2 + 2).trim();
+            missingArgsStrings.push(`  ${chalk.red('>')}  ${indented}`);
+        }
+        error({
+            message: [
+                `Missing ${missingRequiredArgs.size} required ${this.pluralString(missingRequiredArgs.size, 'argument', 'arguments')}:`,
+                ...missingArgsStrings,
+                chalk.gray('  See more help with --help'),
+                '',
+                help,
+            ].join('\n'),
+        });
+    }
+    _handleStdin(mode) {
+        switch (mode) {
+            case StdinMode.Stringified:
+                return cachedStdinInput?.toString('utf8') ?? '';
+            default:
+                return cachedStdinInput;
+        }
+    }
+    _buildCommandStrings(nameOverride) {
+        let baseDefinition = `${nameOverride || this.ctor.name}`;
+        if (this.ctor.args) {
+            for (const [key, internalBuilderData] of Object.entries(this.ctor.args)) {
+                if (typeof internalBuilderData === 'string') {
+                    throw new RangeError('Do not provide the string for the json arg! It is a type level assertion!');
+                }
+                // We mark all args as optional, even if they are not, to pretty-print a help message ourselves
+                baseDefinition += ` [${key}]`;
+            }
+        }
+        return [baseDefinition, ...(this.ctor.aliases ?? [])];
+    }
+    _buildCommandBuilder() {
+        return (yargs) => {
+            let finalYargs = yargs;
+            if (this.ctor.args) {
+                for (const [key, internalBuilderData] of Object.entries(this.ctor.args)) {
+                    if (typeof internalBuilderData === 'string') {
+                        throw new RangeError('Do not provide the string for the json arg! It is a type level assertion!');
+                    }
+                    // Skip the "json" argument, as it is reserved for the --json flag
+                    if (key.toLowerCase() === 'json') {
+                        continue;
+                    }
+                    finalYargs = internalBuilderData.builder(finalYargs, key);
+                }
+            }
+            if (this.ctor.flags) {
+                for (const [key, internalBuilderData] of Object.entries(this.ctor.flags)) {
+                    if (typeof internalBuilderData === 'string') {
+                        throw new RangeError('Do not provide the string for the json flag! It is a type level assertion!');
+                    }
+                    // Skip the "json" flag, as it is set by enableJsonFlag
+                    if (key.toLowerCase() === 'json') {
+                        continue;
+                    }
+                    const flagKey = kebabCaseString(camelCaseToKebabCase(key)).toLowerCase();
+                    // yargs handles "no-" flags by negating the flag, so we need to handle that differently if we register a flag with a "no-" prefix
+                    if (flagKey.startsWith('no-')) {
+                        finalYargs = internalBuilderData.builder(finalYargs, flagKey.slice(3), [], true);
+                    }
+                    else {
+                        finalYargs = internalBuilderData.builder(finalYargs, flagKey);
+                    }
+                }
+            }
+            if (this.ctor.subcommands?.length) {
+                for (const SubCommandClass of this.ctor.subcommands) {
+                    const yargsObject = new SubCommandClass()._toYargs();
+                    finalYargs = finalYargs.command(yargsObject);
+                }
+            }
+            // Register --json
+            if (this.ctor.enableJsonFlag) {
+                finalYargs = finalYargs.option('json', {
+                    boolean: true,
+                    describe: 'Format output as json.',
+                });
+            }
+            return finalYargs;
+        };
+    }
+    _toYargs() {
+        const baseCmd = {
+            handler: this._run.bind(this),
+            command: this._buildCommandStrings(),
+            describe: this.ctor.hidden ? false : this.ctor.description,
+            builder: this._buildCommandBuilder(),
+        };
+        const baseCommands = [
+            {
+                ...baseCmd,
+                aliases: this.ctor.aliases,
+            },
+        ];
+        if (this.ctor.hiddenAliases?.length) {
+            for (const alias of this.ctor.hiddenAliases) {
+                baseCommands.push({
+                    ...baseCmd,
+                    command: this._buildCommandStrings(alias),
+                    describe: false,
+                });
+            }
+        }
+        return baseCommands;
+    }
+    static registerCommand(entrypoint, yargsInstance) {
+        const instance = new this();
+        const yargsObject = instance._toYargs();
+        yargsInstance.command(yargsObject);
+        registerCommandForHelpGeneration(entrypoint, this);
+        commandRegistry.set(this.name, this);
+        if (this.subcommands?.length) {
+            for (const subcommand of this.subcommands) {
+                commandRegistry.set(`${this.name} ${subcommand.name}`, subcommand);
+            }
+        }
+    }
+}
+export async function runCommand(command, argsFlags) {
+    // This is very much yolo'd in, but its purpose is for testing only
+    const rawObject = {
+        _: [],
+        $0: 'apify',
+    };
+    for (const [key, value] of Object.entries(argsFlags)) {
+        const [type, rawKey] = key.split('_');
+        if (type === 'args') {
+            rawObject[rawKey] = value;
+        }
+        else {
+            const yargsFlagName = kebabCaseString(camelCaseToKebabCase(rawKey)).toLowerCase();
+            // We handle "no-" flags differently, as yargs handles them by negating the base flag name (no-prompt -> prompt=false)
+            if (yargsFlagName.startsWith('no-')) {
+                rawObject[yargsFlagName.slice(3)] = !value;
+            }
+            else {
+                rawObject[yargsFlagName] = value;
+            }
+        }
+    }
+    const instance = new command();
+    // eslint-disable-next-line dot-notation
+    await instance['_run'](rawObject);
+}
+//# sourceMappingURL=apify-command.js.map

package/dist/lib/command-framework/apify-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apify-command.js","sourceRoot":"","sources":["../../../src/lib/command-framework/apify-command.ts"],"names":[],"mappings":"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"}

package/dist/lib/command-framework/args.d.ts

@@ -0,0 +1,28 @@
+import type { Argv } from 'yargs';
+import { StdinMode } from './apify-command.js';
+export type ArgTag = 'string';
+export interface BaseArgOptions {
+    required?: boolean;
+    description?: string;
+    aliases?: readonly string[];
+    /**
+     * Whether the argument should be prefilled from stdin
+     * @default false
+     */
+    stdin?: StdinMode;
+}
+export type StringArgOptions = BaseArgOptions;
+export interface TaggedArgBuilder<Tag extends ArgTag, Required = boolean> {
+    argTag: Tag;
+    builder: (args: Argv, objectName: string) => Argv;
+    required: Required;
+    stdin: StdinMode;
+    description: string | undefined;
+    aliases: readonly string[] | undefined;
+}
+declare function stringArg<const T extends StringArgOptions>(option: T): TaggedArgBuilder<'string', T['required']>;
+export declare const Args: {
+    string: typeof stringArg;
+};
+export {};
+//# sourceMappingURL=args.d.ts.map

package/dist/lib/command-framework/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/lib/command-framework/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE9C,MAAM,WAAW,gBAAgB,CAAC,GAAG,SAAS,MAAM,EAAE,QAAQ,GAAG,OAAO;IACvE,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IAGjB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACvC;AAED,iBAAS,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,gBAAgB,EAAE,MAAM,EAAE,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAmBzG;AAED,eAAO,MAAM,IAAI;;CAEhB,CAAC"}

package/dist/lib/command-framework/args.js

@@ -0,0 +1,23 @@
+import { StdinMode } from './apify-command.js';
+function stringArg(option) {
+    return {
+        argTag: 'string',
+        builder: (args, objectName) => {
+            args.positional(objectName, {
+                type: 'string',
+                alias: option.aliases,
+                description: option.description,
+                demandOption: false,
+            });
+            return args;
+        },
+        required: option.required ?? false,
+        stdin: option.stdin ?? StdinMode.Raw,
+        description: option.description,
+        aliases: option.aliases,
+    };
+}
+export const Args = {
+    string: stringArg,
+};
+//# sourceMappingURL=args.js.map

package/dist/lib/command-framework/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/lib/command-framework/args.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA4B/C,SAAS,SAAS,CAAmC,MAAS;IAC7D,OAAO;QACN,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;YAC7B,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE;gBAC3B,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,MAAM,CAAC,OAAO;gBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,YAAY,EAAE,KAAK;aACnB,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC;QACb,CAAC;QACD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;QAClC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,GAAG;QAEpC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;KACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;IACnB,MAAM,EAAE,SAAS;CACjB,CAAC"}

package/dist/lib/command-framework/flags.d.ts

@@ -0,0 +1,55 @@
+import type { Argv } from 'yargs';
+import { StdinMode } from './apify-command.js';
+export type FlagTag = 'string' | 'boolean' | 'integer';
+export interface BaseFlagOptions {
+    required?: boolean;
+    description?: string;
+    aliases?: readonly string[];
+    char?: string;
+    hidden?: boolean;
+    /**
+     * Maps to the `conflicts` option in yargs, ensures that if this flag is set, others in the array cannot be
+     */
+    exclusive?: readonly string[];
+    /**
+     * Whether the argument should be prefilled from stdin
+     * @default false
+     */
+    stdin?: StdinMode;
+}
+export interface StringFlagOptions<Choices extends readonly string[] = readonly string[]> extends BaseFlagOptions {
+    choices?: Choices;
+    default?: string;
+}
+export interface BooleanFlagOptions extends BaseFlagOptions {
+    default?: boolean;
+}
+export interface IntegerFlagOptions extends BaseFlagOptions {
+    choices?: readonly number[];
+    default?: number;
+}
+export interface TaggedFlagBuilder<Tag extends FlagTag, ChoicesType extends readonly string[] | null, Required = boolean, HasDefault = false> {
+    flagTag: Tag;
+    builder: (args: Argv, objectName: string, extraArgs?: string[], invertDefaultIfSet?: boolean) => Argv;
+    choicesType: ChoicesType;
+    required: Required;
+    hasDefault: HasDefault;
+    stdin: StdinMode;
+    description: string | undefined;
+    aliases: readonly string[] | undefined;
+    char: string | undefined;
+    hidden: boolean | undefined;
+    exclusive: readonly string[] | undefined;
+}
+export declare const Flags: {
+    string: typeof stringFlag;
+    boolean: typeof booleanFlag;
+    integer: typeof integerFlag;
+};
+declare function stringFlag<const Choices extends string[], const T extends StringFlagOptions<readonly string[]>>(options: T & {
+    choices?: Choices;
+}): TaggedFlagBuilder<'string', Choices, T['default'] extends string ? true : T['required'], T['default']>;
+declare function booleanFlag<const T extends BooleanFlagOptions>(options: T): TaggedFlagBuilder<'boolean', never, T['default'] extends boolean ? true : T['required'], T['default']>;
+declare function integerFlag<const T extends IntegerFlagOptions>(options: T): TaggedFlagBuilder<'integer', never, T['default'] extends number ? true : T['required'], T['default']>;
+export {};
+//# sourceMappingURL=flags.d.ts.map

package/dist/lib/command-framework/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../src/lib/command-framework/flags.ts"],"names":[],"mappings":"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"}

package/dist/lib/command-framework/flags.js

@@ -0,0 +1,102 @@
+import { camelCaseToKebabCase, kebabCaseString, StdinMode } from './apify-command.js';
+export const Flags = {
+    string: stringFlag,
+    boolean: booleanFlag,
+    integer: integerFlag,
+};
+function stringFlag(options) {
+    return {
+        flagTag: 'string',
+        builder: (args, objectName, extraAliases, invertDefaultIfSet = false) => {
+            const allAliases = new Set([...(options.aliases ?? []), ...(extraAliases ?? [])]);
+            if (options.char) {
+                allAliases.add(options.char);
+            }
+            allAliases.delete(objectName);
+            return args.option(objectName, {
+                demandOption: false,
+                describe: options.description,
+                alias: [...allAliases].map((alias) => kebabCaseString(camelCaseToKebabCase(alias))),
+                hidden: options.hidden ?? false,
+                conflicts: options.exclusive,
+                default: invertDefaultIfSet ? !options.default : options.default,
+                choices: options.choices,
+                string: true,
+                // we only require something be passed in if we don't have a default or read from stdin
+                nargs: 1,
+            });
+        },
+        choicesType: options.choices,
+        required: (options.required ?? false),
+        hasDefault: options.default,
+        stdin: options.stdin ?? StdinMode.Raw,
+        description: options.description,
+        aliases: options.aliases,
+        char: options.char,
+        hidden: options.hidden,
+        exclusive: options.exclusive,
+    };
+}
+function booleanFlag(options) {
+    return {
+        flagTag: 'boolean',
+        builder: (args, objectName, extraAliases, invertDefaultIfSet = false) => {
+            const allAliases = new Set([...(options.aliases ?? []), ...(extraAliases ?? [])]);
+            if (options.char) {
+                allAliases.add(options.char);
+            }
+            allAliases.delete(objectName);
+            return args.option(objectName, {
+                demandOption: false,
+                describe: options.description,
+                alias: [...allAliases].map((alias) => kebabCaseString(camelCaseToKebabCase(alias))),
+                hidden: options.hidden ?? false,
+                conflicts: options.exclusive,
+                default: invertDefaultIfSet ? !options.default : options.default,
+                boolean: true,
+            });
+        },
+        choicesType: null,
+        required: (options.required ?? false),
+        hasDefault: options.default,
+        stdin: options.stdin ?? StdinMode.Raw,
+        description: options.description,
+        aliases: options.aliases,
+        char: options.char,
+        hidden: options.hidden,
+        exclusive: options.exclusive,
+    };
+}
+function integerFlag(options) {
+    return {
+        flagTag: 'integer',
+        builder: (args, objectName, extraAliases, invertDefaultIfSet = false) => {
+            const allAliases = new Set([...(options.aliases ?? []), ...(extraAliases ?? [])]);
+            if (options.char) {
+                allAliases.add(options.char);
+            }
+            allAliases.delete(objectName);
+            return args.option(objectName, {
+                demandOption: false,
+                describe: options.description,
+                alias: [...allAliases].map((alias) => kebabCaseString(camelCaseToKebabCase(alias))),
+                hidden: options.hidden ?? false,
+                conflicts: options.exclusive,
+                default: invertDefaultIfSet ? !options.default : options.default,
+                choices: options.choices,
+                string: true,
+                nargs: 1,
+            });
+        },
+        choicesType: null,
+        required: (options.required ?? false),
+        hasDefault: options.default,
+        stdin: options.stdin ?? StdinMode.Raw,
+        description: options.description,
+        aliases: options.aliases,
+        char: options.char,
+        hidden: options.hidden,
+        exclusive: options.exclusive,
+    };
+}
+//# sourceMappingURL=flags.js.map

package/dist/lib/command-framework/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../src/lib/command-framework/flags.ts"],"names":[],"mappings":"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"}

package/dist/lib/command-framework/help/CommandHelp.d.ts

@@ -0,0 +1,11 @@
+import type { ArgTag, TaggedArgBuilder } from '../args.js';
+import type { FlagTag, TaggedFlagBuilder } from '../flags.js';
+import { BaseCommandRenderer, type SelectiveRenderOptions } from './_BaseCommandRenderer.js';
+export declare class CommandHelp extends BaseCommandRenderer {
+    render(): string;
+    selectiveRender(options: SelectiveRenderOptions): string;
+    protected pushUsageString(result: string[]): void;
+    protected pushArguments(result: string[], args: [string, TaggedArgBuilder<ArgTag, unknown>][]): void;
+    protected pushFlags(result: string[], flags: Map<string, TaggedFlagBuilder<FlagTag, string[] | null, unknown, unknown>>): void;
+}
+//# sourceMappingURL=CommandHelp.d.ts.map

package/dist/lib/command-framework/help/CommandHelp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandHelp.d.ts","sourceRoot":"","sources":["../../../../src/lib/command-framework/help/CommandHelp.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAqC7F,qBAAa,WAAY,SAAQ,mBAAmB;IAC5C,MAAM,IAAI,MAAM;IAchB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM;IAkB/D,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE;IA4H1C,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE;IAyB7F,SAAS,CAAC,SAAS,CAClB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;CAmElF"}