windmill-cli 1.641.0 → 1.643.0

package/types/deps/jsr.io/@windmill-labs/cliffy-command/1.0.0-rc.5/command.d.ts

@@ -1,815 +0,0 @@
-import { type ParseFlagsContext } from "../../cliffy-flags/1.0.0-rc.5/mod.js";
-import type { MapTypes, MapValue, MergeOptions, TypedArguments, TypedCommandArguments, TypedEnv, TypedOption, TypedType } from "./_argument_types.js";
-import type { Merge, OneOf, ValueOf } from "./_type_utils.js";
-import { type HelpOptions } from "./help/_help_generator.js";
-import type { ActionHandler, Argument, ArgumentValue, CommandResult, CompleteHandler, CompleteOptions, Completion, DefaultValue, Description, EnvVar, EnvVarOptions, EnvVarValueHandler, ErrorHandler, Example, GlobalEnvVarOptions, GlobalOptionOptions, HelpHandler, Option, OptionOptions, OptionValueHandler, TypeDef, TypeOptions, TypeOrTypeHandler, VersionHandler } from "./types.js";
-/**
- * Chainable command factory class.
- *
- * ```ts
- * import { Command } from "./mod.ts";
- *
- * export const cli = new Command()
- *   .name("todo")
- *   .description("Example command description")
- *   .globalOption("--verbose", "Enable verbose output.")
- *   .globalEnv("VERBOSE=<value>", "Enable verbose output.")
- *   .command("add <todo>", "Add todo.")
- *   .action(({ verbose }, todo: string) => {
- *     if (verbose) {
- *       console.log("Add todo '%s'.", todo);
- *     }
- *   })
- *   .command("delete <id>", "Delete todo.")
- *   .action(({ verbose }, id: string) => {
- *     if (verbose) {
- *       console.log("Delete todo with id '%s'.", id);
- *     }
- *   });
- *
- * if (import.meta.main) {
- *   await cli.parse();
- * }
- * ```
- */
-export declare class Command<TParentCommandGlobals extends Record<string, unknown> | void = void, TParentCommandTypes extends Record<string, unknown> | void = TParentCommandGlobals extends number ? any : void, TCommandOptions extends Record<string, unknown> | void = TParentCommandGlobals extends number ? any : void, TCommandArguments extends Array<unknown> = TParentCommandGlobals extends number ? any : [], TCommandGlobals extends Record<string, unknown> | void = TParentCommandGlobals extends number ? any : void, TCommandTypes extends Record<string, unknown> | void = TParentCommandGlobals extends number ? any : {
-    number: number;
-    integer: number;
-    string: string;
-    boolean: boolean;
-    file: string;
-}, TCommandGlobalTypes extends Record<string, unknown> | void = TParentCommandGlobals extends number ? any : void, TParentCommand extends Command<any> | undefined = TParentCommandGlobals extends number ? any : undefined> {
-    private types;
-    private rawArgs;
-    private literalArgs;
-    private _name;
-    private _parent?;
-    private _globalParent?;
-    private ver?;
-    private desc;
-    private _usage?;
-    private actionHandler?;
-    private globalActionHandler?;
-    private options;
-    private commands;
-    private examples;
-    private envVars;
-    private aliases;
-    private completions;
-    private cmd;
-    private argsDefinition?;
-    private throwOnError;
-    private _allowEmpty;
-    private _stopEarly;
-    private defaultCommand?;
-    private _useRawArgs;
-    private args;
-    private isHidden;
-    private isGlobal;
-    private hasDefaults;
-    private _versionOptions?;
-    private _helpOptions?;
-    private _versionOption?;
-    private _helpOption?;
-    private _help?;
-    private _shouldExit?;
-    private _meta;
-    private _groupName;
-    private _noGlobals;
-    private errorHandler?;
-    /** Disable version option. */
-    versionOption(enable: false): this;
-    /**
-     * Set global version option.
-     *
-     * @param flags The flags of the version option.
-     * @param desc  The description of the version option.
-     * @param opts  Version option options.
-     */
-    versionOption(flags: string, desc?: string, opts?: OptionOptions<Partial<TCommandOptions>, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand> & {
-        global: true;
-    }): this;
-    /**
-     * Set version option.
-     *
-     * @param flags The flags of the version option.
-     * @param desc  The description of the version option.
-     * @param opts  Version option options.
-     */
-    versionOption(flags: string, desc?: string, opts?: OptionOptions<TCommandOptions, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>): this;
-    /**
-     * Set version option.
-     *
-     * @param flags The flags of the version option.
-     * @param desc  The description of the version option.
-     * @param opts  The action of the version option.
-     */
-    versionOption(flags: string, desc?: string, opts?: ActionHandler<TCommandOptions, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>): this;
-    /** Disable help option. */
-    helpOption(enable: false): this;
-    /**
-     * Set global help option.
-     *
-     * @param flags The flags of the help option.
-     * @param desc  The description of the help option.
-     * @param opts  Help option options.
-     */
-    helpOption(flags: string, desc?: string, opts?: OptionOptions<Partial<TCommandOptions>, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand> & {
-        global: true;
-    }): this;
-    /**
-     * Set help option.
-     *
-     * @param flags The flags of the help option.
-     * @param desc  The description of the help option.
-     * @param opts  Help option options.
-     */
-    helpOption(flags: string, desc?: string, opts?: OptionOptions<TCommandOptions, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>): this;
-    /**
-     * Set help option.
-     *
-     * @param flags The flags of the help option.
-     * @param desc  The description of the help option.
-     * @param opts  The action of the help option.
-     */
-    helpOption(flags: string, desc?: string, opts?: ActionHandler<TCommandOptions, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>): this;
-    /**
-     * Add new sub-command.
-     *
-     * @param name      Command definition. E.g: `my-command <input-file:string> <output-file:string>`
-     * @param cmd       The new child command to register.
-     * @param override  Override existing child command.
-     */
-    command<TCommand extends Command<(TGlobalOptions & Record<string, unknown>) | void | undefined, TGlobalTypes | void | undefined, Record<string, unknown> | void, Array<unknown>, Record<string, unknown> | void, Record<string, unknown> | void, Record<string, unknown> | void, Command<TGlobalOptions | void | undefined, TGlobalTypes | void | undefined, Record<string, unknown> | void, Array<unknown>, Record<string, unknown> | void, Record<string, unknown> | void, Record<string, unknown> | void, undefined>>, TGlobalOptions extends (TParentCommand extends Command<any> ? TParentCommandGlobals : Merge<TParentCommandGlobals, TCommandGlobals>), TGlobalTypes extends (TParentCommand extends Command<any> ? TParentCommandTypes : Merge<TParentCommandTypes, TCommandTypes>)>(name: string, cmd: TCommand, override?: boolean): ReturnType<TCommand["reset"]> extends Command<Record<string, unknown> | void, Record<string, unknown> | void, infer Options, infer Arguments, infer GlobalOptions, infer Types, infer GlobalTypes, undefined> ? Command<TGlobalOptions, TGlobalTypes, Options, Arguments, GlobalOptions, Types, GlobalTypes, OneOf<TParentCommand, this>> : never;
-    /**
-     * Add new sub-command.
-     *
-     * @param name      Command definition. E.g: `my-command <input-file:string> <output-file:string>`
-     * @param cmd       The new child command to register.
-     * @param override  Override existing child command.
-     */
-    command<TCommand extends Command<TGlobalOptions | void | undefined, TGlobalTypes | void | undefined, Record<string, unknown> | void, Array<unknown>, Record<string, unknown> | void, Record<string, unknown> | void, Record<string, unknown> | void, OneOf<TParentCommand, this> | undefined>, TGlobalOptions extends (TParentCommand extends Command<any> ? TParentCommandGlobals : Merge<TParentCommandGlobals, TCommandGlobals>), TGlobalTypes extends (TParentCommand extends Command<any> ? TParentCommandTypes : Merge<TParentCommandTypes, TCommandTypes>)>(name: string, cmd: TCommand, override?: boolean): TCommand extends Command<Record<string, unknown> | void, Record<string, unknown> | void, infer Options, infer Arguments, infer GlobalOptions, infer Types, infer GlobalTypes, OneOf<TParentCommand, this> | undefined> ? Command<TGlobalOptions, TGlobalTypes, Options, Arguments, GlobalOptions, Types, GlobalTypes, OneOf<TParentCommand, this>> : never;
-    /**
-     * Add new sub-command.
-     *
-     * @param nameAndArguments  Command definition. E.g: `my-command <input-file:string> <output-file:string>`
-     * @param desc              The description of the new child command.
-     * @param override          Override existing child command.
-     */
-    command<TNameAndArguments extends string, TArguments extends TypedCommandArguments<TNameAndArguments, TParentCommand extends Command<any> ? TParentCommandTypes : Merge<TParentCommandTypes, TCommandGlobalTypes>>>(nameAndArguments: TNameAndArguments, desc?: string, override?: boolean): TParentCommandGlobals extends number ? Command<any> : Command<TParentCommand extends Command<any> ? TParentCommandGlobals : Merge<TParentCommandGlobals, TCommandGlobals>, TParentCommand extends Command<any> ? TParentCommandTypes : Merge<TParentCommandTypes, TCommandGlobalTypes>, void, TArguments, void, void, void, OneOf<TParentCommand, this>>;
-    /**
-     * Add new command alias.
-     *
-     * @param alias Tha name of the alias.
-     */
-    alias(alias: string): this;
-    /** Reset internal command reference to main command. */
-    reset(): OneOf<TParentCommand, this>;
-    /**
-     * Set internal command pointer to child command with given name.
-     * @param name The name of the command to select.
-     */
-    select<TOptions extends Record<string, unknown> | void = any, TArguments extends Array<unknown> = any, TGlobalOptions extends Record<string, unknown> | void = any>(name: string): Command<TParentCommandGlobals, TParentCommandTypes, TOptions, TArguments, TGlobalOptions, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /*****************************************************************************
-     **** SUB HANDLER ************************************************************
-     *****************************************************************************/
-    /** Set command name. Used in auto generated help and shell completions */
-    name(name: string): this;
-    /**
-     * Set command version.
-     *
-     * @param version Semantic version string string or method that returns the version string.
-     */
-    version(version: string | VersionHandler<Partial<TCommandOptions>, Partial<TCommandArguments>, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>): this;
-    /**
-     * Add meta data. Will be displayed in the auto generated help and in the
-     * output of the long version.
-     *
-     * @param name  The name/label of the metadata.
-     * @param value The value of the metadata.
-     */
-    meta(name: string, value: string): this;
-    /** Returns an object of metadata. */
-    getMeta(): Record<string, string>;
-    /** Get metadata value by name. */
-    getMeta(name: string): string;
-    /**
-     * Set command help.
-     *
-     * @param help Help string, method, or config for generator that returns the help string.
-     */
-    help(help: string | HelpHandler<Partial<TCommandOptions>, Partial<TCommandArguments>, TCommandGlobals, TParentCommandGlobals> | HelpOptions): this;
-    /**
-     * Set the long command description.
-     *
-     * @param description The command description.
-     */
-    description(description: Description<TCommandOptions, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>): this;
-    /**
-     * Set the command usage. Defaults to arguments.
-     *
-     * @param usage The command usage.
-     */
-    usage(usage: string): this;
-    /** Hide command from help, completions, etc. */
-    hidden(): this;
-    /** Make command globally available. */
-    global(): this;
-    /**
-     * Set command arguments.
-     *
-     * Syntax: `<requiredArg:string> [optionalArg: number] [...restArgs:string]`
-     */
-    arguments<TArguments extends TypedArguments<TArgs, Merge<TParentCommandTypes, Merge<TCommandGlobalTypes, TCommandTypes>>>, TArgs extends string = string>(args: TArgs): Command<TParentCommandGlobals, TParentCommandTypes, TCommandOptions, TArguments, TCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /**
-     * Set command callback method.
-     *
-     * @param fn Command action handler.
-     */
-    action(fn: ActionHandler<TCommandOptions, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>): this;
-    /**
-     * Set command callback method.
-     *
-     * @param fn Command action handler.
-     */
-    globalAction(fn: ActionHandler<Partial<TCommandOptions>, Array<unknown>, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>): this;
-    /**
-     * Don't throw an error if the command was called without arguments.
-     *
-     * @param allowEmpty Enable/disable allow empty.
-     */
-    allowEmpty<TAllowEmpty extends boolean | undefined = undefined>(allowEmpty?: TAllowEmpty): false extends TAllowEmpty ? this : Command<Partial<TParentCommandGlobals>, TParentCommandTypes, Partial<TCommandOptions>, TCommandArguments, TCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /**
-     * Enable stop early. If enabled, all arguments starting from the first non
-     * option argument will be passed as arguments with type string to the command
-     * action handler.
-     *
-     * For example:
-     *     `command --debug-level warning server --port 80`
-     *
-     * Will result in:
-     *     - options: `{ debugLevel: 'warning' }`
-     *     - args: `['server', '--port', '80']`
-     *
-     * @param stopEarly Enable/disable stop early.
-     */
-    stopEarly(stopEarly?: boolean): this;
-    /**
-     * Disable parsing arguments. If enabled the raw arguments will be passed to
-     * the action handler. This has no effect for parent or child commands. Only
-     * for the command on which this method was called.
-     *
-     * @param useRawArgs Enable/disable raw arguments.
-     */
-    useRawArgs(useRawArgs?: boolean): Command<void, void, void, Array<string>, void, void, void, TParentCommand>;
-    /**
-     * Set default command. The default command is executed when the program
-     * was called without any argument and if no action handler is registered.
-     *
-     * @param name Name of the default command.
-     */
-    default(name: string): this;
-    globalType<THandler extends TypeOrTypeHandler<unknown>, TName extends string = string>(name: TName, handler: THandler, options?: Omit<TypeOptions, "global">): Command<TParentCommandGlobals, TParentCommandTypes, TCommandOptions, TCommandArguments, TCommandGlobals, TCommandTypes, Merge<TCommandGlobalTypes, TypedType<TName, THandler>>, TParentCommand>;
-    /**
-     * Register custom type.
-     *
-     * @param name    The name of the type.
-     * @param handler The callback method to parse the type.
-     * @param options Type options.
-     */
-    type<THandler extends TypeOrTypeHandler<unknown>, TName extends string = string>(name: TName, handler: THandler, options?: TypeOptions): Command<TParentCommandGlobals, TParentCommandTypes, TCommandOptions, TCommandArguments, TCommandGlobals, Merge<TCommandTypes, TypedType<TName, THandler>>, TCommandGlobalTypes, TParentCommand>;
-    /**
-     * Register global complete handler.
-     *
-     * @param name      The name of the completion.
-     * @param complete  The callback method to complete the type.
-     * @param options   Complete options.
-     */
-    globalComplete(name: string, complete: CompleteHandler, options?: Omit<CompleteOptions, "global">): this;
-    /**
-     * Register global complete handler.
-     *
-     * @param name      The name of the completion.
-     * @param complete  The callback method to complete the type.
-     * @param options   Complete options.
-     */
-    complete(name: string, complete: CompleteHandler<Partial<TCommandOptions>, Partial<TCommandArguments>, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, any>, options: CompleteOptions & {
-        global: boolean;
-    }): this;
-    /**
-     * Register complete handler.
-     *
-     * @param name      The name of the completion.
-     * @param complete  The callback method to complete the type.
-     * @param options   Complete options.
-     */
-    complete(name: string, complete: CompleteHandler<TCommandOptions, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>, options?: CompleteOptions): this;
-    /**
-     * Throw validation errors instead of calling `exit()` to handle
-     * validation errors manually.
-     *
-     * A validation error is thrown when the command is wrongly used by the user.
-     * For example: If the user passes some invalid options or arguments to the
-     * command.
-     *
-     * This has no effect for parent commands. Only for the command on which this
-     * method was called and all child commands.
-     *
-     * **Example:**
-     *
-     * ```ts
-     * import { Command, ValidationError } from "./mod.ts";
-     *
-     * const cmd = new Command();
-     * // ...
-     *
-     * try {
-     *   cmd.parse();
-     * } catch(error) {
-     *   if (error instanceof ValidationError) {
-     *     cmd.showHelp();
-     *     Deno.exit(1);
-     *   }
-     *   throw error;
-     * }
-     * ```
-     *
-     * @see ValidationError
-     */
-    throwErrors(): this;
-    /**
-     * Set custom error handler.
-     *
-     * @param handler Error handler callback function.
-     */
-    error(handler: ErrorHandler): this;
-    /** Get error handler callback function. */
-    private getErrorHandler;
-    /**
-     * Same as `.throwErrors()` but also prevents calling `exit()` after
-     * printing help or version with the --help and --version option.
-     */
-    noExit(): this;
-    /**
-     * Disable inheriting global commands, options and environment variables from
-     * parent commands.
-     */
-    noGlobals(): this;
-    /** Check whether the command should throw errors or exit. */
-    protected shouldThrowErrors(): boolean;
-    /** Check whether the command should exit after printing help or version. */
-    protected shouldExit(): boolean;
-    /**
-     * Enable grouping of options and set the name of the group.
-     * All option which are added after calling the `.group()` method will be
-     * grouped in the help output. If the `.group()` method can be use multiple
-     * times to create more groups.
-     *
-     * @param name The name of the option group.
-     */
-    group(name: string | null): this;
-    /**
-     * Register a global option.
-     *
-     * @param flags Flags string e.g: -h, --help, --manual <requiredArg:string> [optionalArg:number] [...restArgs:string]
-     * @param desc Flag description.
-     * @param opts Flag options or custom handler for processing flag value.
-     */
-    globalOption<TFlags extends string, TGlobalOptions extends TypedOption<TFlags, TCommandOptions, Merge<TParentCommandTypes, Merge<TCommandGlobalTypes, TCommandTypes>>, undefined extends TConflicts ? TRequired : false, TDefaultValue>, TMappedGlobalOptions extends MapValue<TGlobalOptions, TMappedValue, TCollect>, TRequired extends OptionOptions["required"] = undefined, TCollect extends OptionOptions["collect"] = undefined, TConflicts extends OptionOptions["conflicts"] = undefined, const TDefaultValue = undefined, TMappedValue = undefined>(flags: TFlags, desc: string, opts?: Omit<GlobalOptionOptions<Partial<TCommandOptions>, TCommandArguments, MergeOptions<TFlags, TCommandGlobals, TGlobalOptions>, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>, "value"> & {
-        default?: DefaultValue<TDefaultValue>;
-        required?: TRequired;
-        collect?: TCollect;
-        value?: OptionValueHandler<MapTypes<ValueOf<TGlobalOptions>>, TMappedValue>;
-    } | OptionValueHandler<MapTypes<ValueOf<TGlobalOptions>>, TMappedValue>): Command<TParentCommandGlobals, TParentCommandTypes, TCommandOptions, TCommandArguments, MergeOptions<TFlags, TCommandGlobals, TMappedGlobalOptions>, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /**
-     * Add a global option.
-     *
-     * @param flags Flags string e.g: -h, --help, --manual <requiredArg:string> [optionalArg:number] [...restArgs:string]
-     * @param desc Flag description.
-     * @param opts Flag options or custom handler for processing flag value.
-     */
-    option<TFlags extends string, TGlobalOptions extends TypedOption<TFlags, TCommandOptions, Merge<TParentCommandTypes, Merge<TCommandGlobalTypes, TCommandTypes>>, undefined extends TConflicts ? TRequired : false, TDefaultValue>, TMappedGlobalOptions extends MapValue<TGlobalOptions, TMappedValue, TCollect>, TRequired extends OptionOptions["required"] = undefined, TCollect extends OptionOptions["collect"] = undefined, TConflicts extends OptionOptions["conflicts"] = undefined, const TDefaultValue = undefined, TMappedValue = undefined>(flags: TFlags, desc: string, opts: Omit<OptionOptions<Partial<TCommandOptions>, TCommandArguments, MergeOptions<TFlags, TCommandGlobals, TGlobalOptions>, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>, "value"> & {
-        global: true;
-        default?: DefaultValue<TDefaultValue>;
-        required?: TRequired;
-        collect?: TCollect;
-        value?: OptionValueHandler<MapTypes<ValueOf<TGlobalOptions>>, TMappedValue>;
-    } | OptionValueHandler<MapTypes<ValueOf<TGlobalOptions>>, TMappedValue>): Command<TParentCommandGlobals, TParentCommandTypes, TCommandOptions, TCommandArguments, MergeOptions<TFlags, TCommandGlobals, TMappedGlobalOptions>, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /**
-     * Register an option.
-     *
-     * @param flags Flags string e.g: -h, --help, --manual <requiredArg:string> [optionalArg:number] [...restArgs:string]
-     * @param desc Flag description.
-     * @param opts Flag options or custom handler for processing flag value.
-     */
-    option<TFlags extends string, TOptions extends TypedOption<TFlags, TCommandOptions, Merge<TParentCommandTypes, Merge<TCommandGlobalTypes, TCommandTypes>>, undefined extends TConflicts ? TRequired : false, TDefaultValue>, TMappedOptions extends MapValue<TOptions, TMappedValue, TCollect>, TRequired extends OptionOptions["required"] = undefined, TCollect extends OptionOptions["collect"] = undefined, TConflicts extends OptionOptions["conflicts"] = undefined, const TDefaultValue = undefined, TMappedValue = undefined>(flags: TFlags, desc: string, opts?: Omit<OptionOptions<MergeOptions<TFlags, TCommandOptions, TMappedOptions>, TCommandArguments, TCommandGlobals, TParentCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>, "value"> & {
-        default?: DefaultValue<TDefaultValue>;
-        required?: TRequired;
-        collect?: TCollect;
-        conflicts?: TConflicts;
-        value?: OptionValueHandler<MapTypes<ValueOf<TOptions>>, TMappedValue>;
-    } | OptionValueHandler<MapTypes<ValueOf<TOptions>>, TMappedValue>): Command<TParentCommandGlobals, TParentCommandTypes, MergeOptions<TFlags, TCommandOptions, TMappedOptions>, TCommandArguments, TCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /**
-     * Register command example.
-     *
-     * @param name          Name of the example.
-     * @param description   The content of the example.
-     */
-    example(name: string, description: string): this;
-    /**
-     * @param flags Flags string e.g: -h, --help, --manual <requiredArg:string> [optionalArg:number] [...restArgs:string]
-     * @param desc Flag description.
-     * @param opts Flag options or custom handler for processing flag value.
-     */
-    /**
-     * Register a global environment variable.
-     *
-     * @param name        Name of the environment variable.
-     * @param description The description of the environment variable.
-     * @param options     Environment variable options.
-     */
-    globalEnv<TNameAndValue extends string, TGlobalEnvVars extends TypedEnv<TNameAndValue, TPrefix, TCommandOptions, Merge<TParentCommandTypes, Merge<TCommandGlobalTypes, TCommandTypes>>, TRequired>, TMappedGlobalEnvVars extends MapValue<TGlobalEnvVars, TMappedValue>, TRequired extends EnvVarOptions["required"] = undefined, TPrefix extends EnvVarOptions["prefix"] = undefined, TMappedValue = undefined>(name: TNameAndValue, description: string, options?: Omit<GlobalEnvVarOptions, "value"> & {
-        required?: TRequired;
-        prefix?: TPrefix;
-        value?: EnvVarValueHandler<MapTypes<ValueOf<TGlobalEnvVars>>, TMappedValue>;
-    }): Command<TParentCommandGlobals, TParentCommandTypes, TCommandOptions, TCommandArguments, Merge<TCommandGlobals, TMappedGlobalEnvVars>, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /**
-     * Register a global environment variable.
-     *
-     * @param name        Name of the environment variable.
-     * @param description The description of the environment variable.
-     * @param options     Environment variable options.
-     */
-    env<N extends string, G extends TypedEnv<N, P, TCommandOptions, Merge<TParentCommandTypes, Merge<TCommandGlobalTypes, TCommandTypes>>, R>, MG extends MapValue<G, V>, R extends EnvVarOptions["required"] = undefined, P extends EnvVarOptions["prefix"] = undefined, V = undefined>(name: N, description: string, options: Omit<EnvVarOptions, "value"> & {
-        global: true;
-        required?: R;
-        prefix?: P;
-        value?: EnvVarValueHandler<MapTypes<ValueOf<G>>, V>;
-    }): Command<TParentCommandGlobals, TParentCommandTypes, TCommandOptions, TCommandArguments, Merge<TCommandGlobals, MG>, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /**
-     * Register an environment variable.
-     *
-     * @param name        Name of the environment variable.
-     * @param description The description of the environment variable.
-     * @param options     Environment variable options.
-     */
-    env<TNameAndValue extends string, TEnvVar extends TypedEnv<TNameAndValue, TPrefix, TCommandOptions, Merge<TParentCommandTypes, Merge<TCommandGlobalTypes, TCommandTypes>>, TRequired>, TMappedEnvVar extends MapValue<TEnvVar, TMappedValue>, TRequired extends EnvVarOptions["required"] = undefined, TPrefix extends EnvVarOptions["prefix"] = undefined, TMappedValue = undefined>(name: TNameAndValue, description: string, options?: Omit<EnvVarOptions, "value"> & {
-        required?: TRequired;
-        prefix?: TPrefix;
-        value?: EnvVarValueHandler<MapTypes<ValueOf<TEnvVar>>, TMappedValue>;
-    }): Command<TParentCommandGlobals, TParentCommandTypes, Merge<TCommandOptions, TMappedEnvVar>, TCommandArguments, TCommandGlobals, TCommandTypes, TCommandGlobalTypes, TParentCommand>;
-    /*****************************************************************************
-     **** MAIN HANDLER ***********************************************************
-     *****************************************************************************/
-    /**
-     * Parse command line arguments and execute matched command.
-     *
-     * @param args Command line args to parse. Ex: `cmd.parse( Deno.args )`
-     */
-    parse(args?: string[]): Promise<TParentCommand extends Command<any> ? CommandResult<Record<string, unknown>, Array<unknown>, Record<string, unknown>, Record<string, unknown>, Record<string, unknown>, Record<string, unknown>, Record<string, unknown>, undefined> : CommandResult<MapTypes<TCommandOptions>, MapTypes<TCommandArguments>, MapTypes<TCommandGlobals>, MapTypes<TParentCommandGlobals>, TCommandTypes, TCommandGlobalTypes, TParentCommandTypes, TParentCommand>>;
-    private parseCommand;
-    private getSubCommand;
-    private parseGlobalOptionsAndEnvVars;
-    private parseOptionsAndEnvVars;
-    /** Register default options like `--version` and `--help`. */
-    private registerDefaults;
-    /**
-     * Execute command.
-     * @param options A map of options.
-     * @param args Command arguments.
-     */
-    private execute;
-    private executeGlobalAction;
-    /** Parse raw command line arguments. */
-    protected parseOptions(ctx: ParseContext, options: Option[], { stopEarly, stopOnUnknown, dotted, }?: ParseOptionsOptions): void;
-    /** Parse argument type. */
-    protected parseType(type: ArgumentValue): unknown;
-    /**
-     * Read and validate environment variables.
-     * @param ctx Parse context.
-     * @param envVars env vars defined by the command.
-     * @param validate when true, throws an error if a required env var is missing.
-     */
-    protected parseEnvVars(ctx: ParseContext, envVars: Array<EnvVar>, validate?: boolean): Promise<void>;
-    protected findEnvVar(names: readonly string[]): Promise<{
-        name: string;
-        value: string;
-    } | undefined>;
-    /**
-     * Parse command-line arguments.
-     * @param ctx     Parse context.
-     * @param options Parsed command line options.
-     */
-    protected parseArguments(ctx: ParseContext, options: Record<string, unknown>): TCommandArguments;
-    private handleError;
-    /**
-     * Handle error. If `throwErrors` is enabled the error will be thrown,
-     * otherwise a formatted error message will be printed and `exit(1)`
-     * will be called. This will also trigger registered error handlers.
-     *
-     * @param error The error to handle.
-     */
-    throw(error: Error): never;
-    /*****************************************************************************
-     **** GETTER *****************************************************************
-     *****************************************************************************/
-    /** Get command name. */
-    getName(): string;
-    /** Get parent command. */
-    getParent(): TParentCommand;
-    /**
-     * Get parent command from global executed command.
-     * Be sure, to call this method only inside an action handler. Unless this or any child command was executed,
-     * this method returns always undefined.
-     */
-    getGlobalParent(): Command<any> | undefined;
-    /** Get main command. */
-    getMainCommand(): Command<any>;
-    /** Get command name aliases. */
-    getAliases(): string[];
-    /**
-     * Get full command path.
-     *
-     * @param name Override the main command name.
-     */
-    getPath(name?: string): string;
-    /** Get arguments definition. E.g: <input-file:string> <output-file:string> */
-    getArgsDefinition(): string | undefined;
-    /**
-     * Get argument by name.
-     *
-     * @param name Name of the argument.
-     */
-    getArgument(name: string): Argument | undefined;
-    /** Get arguments. */
-    getArguments(): Argument[];
-    /** Check if command has arguments. */
-    hasArguments(): boolean;
-    /** Get command version. */
-    getVersion(): string | undefined;
-    /** Get help handler method. */
-    private getVersionHandler;
-    /** Get command description. */
-    getDescription(): string;
-    /** Get auto generated command usage. */
-    getUsage(): string;
-    private getRequiredOptionsDefinition;
-    /** Get short command description. This is the first line of the description. */
-    getShortDescription(): string;
-    /** Get original command-line arguments. */
-    getRawArgs(): string[];
-    /** Get all arguments defined after the double dash. */
-    getLiteralArgs(): string[];
-    /** Output generated help without exiting. */
-    showVersion(): void;
-    /** Returns command name, version and meta data. */
-    getLongVersion(): string;
-    /** Outputs command name, version and meta data. */
-    showLongVersion(): void;
-    /** Output generated help without exiting. */
-    showHelp(options?: HelpOptions): void;
-    /** Get generated help. */
-    getHelp(options?: HelpOptions): string;
-    /** Get help handler method. */
-    private getHelpHandler;
-    private exit;
-    /*****************************************************************************
-     **** Options GETTER *********************************************************
-     *****************************************************************************/
-    /**
-     * Checks whether the command has options or not.
-     *
-     * @param hidden Include hidden options.
-     */
-    hasOptions(hidden?: boolean): boolean;
-    /**
-     * Get options.
-     *
-     * @param hidden Include hidden options.
-     */
-    getOptions(hidden?: boolean): Option[];
-    /**
-     * Get base options.
-     *
-     * @param hidden Include hidden options.
-     */
-    getBaseOptions(hidden?: boolean): Option[];
-    /**
-     * Get global options.
-     *
-     * @param hidden Include hidden options.
-     */
-    getGlobalOptions(hidden?: boolean): Option[];
-    /**
-     * Checks whether the command has an option with given name or not.
-     *
-     * @param name Name of the option. Must be in param-case.
-     * @param hidden Include hidden options.
-     */
-    hasOption(name: string, hidden?: boolean): boolean;
-    /**
-     * Get option by name.
-     *
-     * @param name Name of the option. Must be in param-case.
-     * @param hidden Include hidden options.
-     */
-    getOption(name: string, hidden?: boolean): Option | undefined;
-    /**
-     * Get base option by name.
-     *
-     * @param name Name of the option. Must be in param-case.
-     * @param hidden Include hidden options.
-     */
-    getBaseOption(name: string, hidden?: boolean): Option | undefined;
-    /**
-     * Get global option from parent commands by name.
-     *
-     * @param name Name of the option. Must be in param-case.
-     * @param hidden Include hidden options.
-     */
-    getGlobalOption(name: string, hidden?: boolean): Option | undefined;
-    /**
-     * Remove option by name.
-     *
-     * @param name Name of the option. Must be in param-case.
-     */
-    removeOption(name: string): Option | undefined;
-    /**
-     * Checks whether the command has sub-commands or not.
-     *
-     * @param hidden Include hidden commands.
-     */
-    hasCommands(hidden?: boolean): boolean;
-    /**
-     * Get commands.
-     *
-     * @param hidden Include hidden commands.
-     */
-    getCommands(hidden?: boolean): Array<Command<any>>;
-    /**
-     * Get base commands.
-     *
-     * @param hidden Include hidden commands.
-     */
-    getBaseCommands(hidden?: boolean): Array<Command<any>>;
-    /**
-     * Get global commands.
-     *
-     * @param hidden Include hidden commands.
-     */
-    getGlobalCommands(hidden?: boolean): Array<Command<any>>;
-    /**
-     * Checks whether a child command exists by given name or alias.
-     *
-     * @param name Name or alias of the command.
-     * @param hidden Include hidden commands.
-     */
-    hasCommand(name: string, hidden?: boolean): boolean;
-    /**
-     * Get command by name or alias.
-     *
-     * @param name Name or alias of the command.
-     * @param hidden Include hidden commands.
-     */
-    getCommand<TCommand extends Command<any>>(name: string, hidden?: boolean): TCommand | undefined;
-    /**
-     * Get base command by name or alias.
-     *
-     * @param name Name or alias of the command.
-     * @param hidden Include hidden commands.
-     */
-    getBaseCommand<TCommand extends Command<any>>(name: string, hidden?: boolean): TCommand | undefined;
-    /**
-     * Get global command by name or alias.
-     *
-     * @param name Name or alias of the command.
-     * @param hidden Include hidden commands.
-     */
-    getGlobalCommand<TCommand extends Command<any>>(name: string, hidden?: boolean): TCommand | undefined;
-    /**
-     * Remove sub-command by name or alias.
-     *
-     * @param name Name or alias of the command.
-     */
-    removeCommand(name: string): Command<any> | undefined;
-    /** Get types. */
-    getTypes(): Array<TypeDef>;
-    /** Get base types. */
-    getBaseTypes(): Array<TypeDef>;
-    /** Get global types. */
-    getGlobalTypes(): Array<TypeDef>;
-    /**
-     * Get type by name.
-     *
-     * @param name Name of the type.
-     */
-    getType(name: string): TypeDef | undefined;
-    /**
-     * Get base type by name.
-     *
-     * @param name Name of the type.
-     */
-    getBaseType(name: string): TypeDef | undefined;
-    /**
-     * Get global type by name.
-     *
-     * @param name Name of the type.
-     */
-    getGlobalType(name: string): TypeDef | undefined;
-    /** Get completions. */
-    getCompletions(): Completion<any, any, any, any, any, any, any, any>[];
-    /** Get base completions. */
-    getBaseCompletions(): Completion[];
-    /** Get global completions. */
-    getGlobalCompletions(): Completion[];
-    /**
-     * Get completion by name.
-     *
-     * @param name Name of the completion.
-     */
-    getCompletion(name: string): Completion | undefined;
-    /**
-     * Get base completion by name.
-     *
-     * @param name Name of the completion.
-     */
-    getBaseCompletion(name: string): Completion | undefined;
-    /**
-     * Get global completions by name.
-     *
-     * @param name Name of the completion.
-     */
-    getGlobalCompletion(name: string): Completion | undefined;
-    /**
-     * Checks whether the command has environment variables or not.
-     *
-     * @param hidden Include hidden environment variable.
-     */
-    hasEnvVars(hidden?: boolean): boolean;
-    /**
-     * Get environment variables.
-     *
-     * @param hidden Include hidden environment variable.
-     */
-    getEnvVars(hidden?: boolean): EnvVar[];
-    /**
-     * Get base environment variables.
-     *
-     * @param hidden Include hidden environment variable.
-     */
-    getBaseEnvVars(hidden?: boolean): EnvVar[];
-    /**
-     * Get global environment variables.
-     *
-     * @param hidden Include hidden environment variable.
-     */
-    getGlobalEnvVars(hidden?: boolean): EnvVar[];
-    /**
-     * Checks whether the command has an environment variable with given name or not.
-     *
-     * @param name Name of the environment variable.
-     * @param hidden Include hidden environment variable.
-     */
-    hasEnvVar(name: string, hidden?: boolean): boolean;
-    /**
-     * Get environment variable by name.
-     *
-     * @param name Name of the environment variable.
-     * @param hidden Include hidden environment variable.
-     */
-    getEnvVar(name: string, hidden?: boolean): EnvVar | undefined;
-    /**
-     * Get base environment variable by name.
-     *
-     * @param name Name of the environment variable.
-     * @param hidden Include hidden environment variable.
-     */
-    getBaseEnvVar(name: string, hidden?: boolean): EnvVar | undefined;
-    /**
-     * Get global environment variable by name.
-     *
-     * @param name Name of the environment variable.
-     * @param hidden Include hidden environment variable.
-     */
-    getGlobalEnvVar(name: string, hidden?: boolean): EnvVar | undefined;
-    /** Checks whether the command has examples or not. */
-    hasExamples(): boolean;
-    /** Get all examples. */
-    getExamples(): Example[];
-    /** Checks whether the command has an example with given name or not. */
-    hasExample(name: string): boolean;
-    /** Get example with given name. */
-    getExample(name: string): Example | undefined;
-    private getHelpOption;
-}
-interface ParseContext extends ParseFlagsContext<Record<string, unknown>> {
-    actions: Array<ActionHandler>;
-    env: Record<string, unknown>;
-}
-interface ParseOptionsOptions {
-    stopEarly?: boolean;
-    stopOnUnknown?: boolean;
-    dotted?: boolean;
-}
-export {};
-//# sourceMappingURL=command.d.ts.map