taskninja 1.1.5 → 1.1.7

package/src/node_modules/commander/typings/index.d.ts

@@ -1,1113 +0,0 @@
-// Type definitions for commander
-// Original definitions by: Alan Agius <https://github.com/alan-agius4>, Marcelo Dezem <https://github.com/mdezem>, vvakame <https://github.com/vvakame>, Jules Randolph <https://github.com/sveinburne>
-
-/* eslint-disable @typescript-eslint/no-explicit-any */
-
-// This is a trick to encourage editor to suggest the known literals while still
-// allowing any BaseType value.
-// References:
-// - https://github.com/microsoft/TypeScript/issues/29729
-// - https://github.com/sindresorhus/type-fest/blob/main/source/literal-union.d.ts
-// - https://github.com/sindresorhus/type-fest/blob/main/source/primitive.d.ts
-type LiteralUnion<LiteralType, BaseType extends string | number> =
-  | LiteralType
-  | (BaseType & Record<never, never>);
-
-export class CommanderError extends Error {
-  code: string;
-  exitCode: number;
-  message: string;
-  nestedError?: string;
-
-  /**
-   * Constructs the CommanderError class
-   * @param exitCode - suggested exit code which could be used with process.exit
-   * @param code - an id string representing the error
-   * @param message - human-readable description of the error
-   */
-  constructor(exitCode: number, code: string, message: string);
-}
-
-export class InvalidArgumentError extends CommanderError {
-  /**
-   * Constructs the InvalidArgumentError class
-   * @param message - explanation of why argument is invalid
-   */
-  constructor(message: string);
-}
-export { InvalidArgumentError as InvalidOptionArgumentError }; // deprecated old name
-
-export interface ErrorOptions {
-  // optional parameter for error()
-  /** an id string representing the error */
-  code?: string;
-  /** suggested exit code which could be used with process.exit */
-  exitCode?: number;
-}
-
-export class Argument {
-  description: string;
-  required: boolean;
-  variadic: boolean;
-  defaultValue?: any;
-  defaultValueDescription?: string;
-  parseArg?: <T>(value: string, previous: T) => T;
-  argChoices?: string[];
-
-  /**
-   * Initialize a new command argument with the given name and description.
-   * The default is that the argument is required, and you can explicitly
-   * indicate this with <> around the name. Put [] around the name for an optional argument.
-   */
-  constructor(arg: string, description?: string);
-
-  /**
-   * Return argument name.
-   */
-  name(): string;
-
-  /**
-   * Set the default value, and optionally supply the description to be displayed in the help.
-   */
-  default(value: unknown, description?: string): this;
-
-  /**
-   * Set the custom handler for processing CLI command arguments into argument values.
-   */
-  argParser<T>(fn: (value: string, previous: T) => T): this;
-
-  /**
-   * Only allow argument value to be one of choices.
-   */
-  choices(values: readonly string[]): this;
-
-  /**
-   * Make argument required.
-   */
-  argRequired(): this;
-
-  /**
-   * Make argument optional.
-   */
-  argOptional(): this;
-}
-
-export class Option {
-  flags: string;
-  description: string;
-
-  required: boolean; // A value must be supplied when the option is specified.
-  optional: boolean; // A value is optional when the option is specified.
-  variadic: boolean;
-  mandatory: boolean; // The option must have a value after parsing, which usually means it must be specified on command line.
-  short?: string;
-  long?: string;
-  negate: boolean;
-  defaultValue?: any;
-  defaultValueDescription?: string;
-  presetArg?: unknown;
-  envVar?: string;
-  parseArg?: <T>(value: string, previous: T) => T;
-  hidden: boolean;
-  argChoices?: string[];
-  helpGroupHeading?: string;
-
-  constructor(flags: string, description?: string);
-
-  /**
-   * Set the default value, and optionally supply the description to be displayed in the help.
-   */
-  default(value: unknown, description?: string): this;
-
-  /**
-   * Preset to use when option used without option-argument, especially optional but also boolean and negated.
-   * The custom processing (parseArg) is called.
-   *
-   * @example
-   * ```ts
-   * new Option('--color').default('GREYSCALE').preset('RGB');
-   * new Option('--donate [amount]').preset('20').argParser(parseFloat);
-   * ```
-   */
-  preset(arg: unknown): this;
-
-  /**
-   * Add option name(s) that conflict with this option.
-   * An error will be displayed if conflicting options are found during parsing.
-   *
-   * @example
-   * ```ts
-   * new Option('--rgb').conflicts('cmyk');
-   * new Option('--js').conflicts(['ts', 'jsx']);
-   * ```
-   */
-  conflicts(names: string | string[]): this;
-
-  /**
-   * Specify implied option values for when this option is set and the implied options are not.
-   *
-   * The custom processing (parseArg) is not called on the implied values.
-   *
-   * @example
-   * program
-   *   .addOption(new Option('--log', 'write logging information to file'))
-   *   .addOption(new Option('--trace', 'log extra details').implies({ log: 'trace.txt' }));
-   */
-  implies(optionValues: OptionValues): this;
-
-  /**
-   * Set environment variable to check for option value.
-   *
-   * An environment variables is only used if when processed the current option value is
-   * undefined, or the source of the current value is 'default' or 'config' or 'env'.
-   */
-  env(name: string): this;
-
-  /**
-   * Set the custom handler for processing CLI option arguments into option values.
-   */
-  argParser<T>(fn: (value: string, previous: T) => T): this;
-
-  /**
-   * Whether the option is mandatory and must have a value after parsing.
-   */
-  makeOptionMandatory(mandatory?: boolean): this;
-
-  /**
-   * Hide option in help.
-   */
-  hideHelp(hide?: boolean): this;
-
-  /**
-   * Only allow option value to be one of choices.
-   */
-  choices(values: readonly string[]): this;
-
-  /**
-   * Return option name.
-   */
-  name(): string;
-
-  /**
-   * Return option name, in a camelcase format that can be used
-   * as an object attribute key.
-   */
-  attributeName(): string;
-
-  /**
-   * Set the help group heading.
-   */
-  helpGroup(heading: string): this;
-
-  /**
-   * Return whether a boolean option.
-   *
-   * Options are one of boolean, negated, required argument, or optional argument.
-   */
-  isBoolean(): boolean;
-}
-
-export class Help {
-  /** output helpWidth, long lines are wrapped to fit */
-  helpWidth?: number;
-  minWidthToWrap: number;
-  sortSubcommands: boolean;
-  sortOptions: boolean;
-  showGlobalOptions: boolean;
-
-  constructor();
-
-  /*
-   * prepareContext is called by Commander after applying overrides from `Command.configureHelp()`
-   * and just before calling `formatHelp()`.
-   *
-   * Commander just uses the helpWidth and the others are provided for subclasses.
-   */
-  prepareContext(contextOptions: {
-    error?: boolean;
-    helpWidth?: number;
-    outputHasColors?: boolean;
-  }): void;
-
-  /** Get the command term to show in the list of subcommands. */
-  subcommandTerm(cmd: Command): string;
-  /** Get the command summary to show in the list of subcommands. */
-  subcommandDescription(cmd: Command): string;
-  /** Get the option term to show in the list of options. */
-  optionTerm(option: Option): string;
-  /** Get the option description to show in the list of options. */
-  optionDescription(option: Option): string;
-  /** Get the argument term to show in the list of arguments. */
-  argumentTerm(argument: Argument): string;
-  /** Get the argument description to show in the list of arguments. */
-  argumentDescription(argument: Argument): string;
-
-  /** Get the command usage to be displayed at the top of the built-in help. */
-  commandUsage(cmd: Command): string;
-  /** Get the description for the command. */
-  commandDescription(cmd: Command): string;
-
-  /** Get an array of the visible subcommands. Includes a placeholder for the implicit help command, if there is one. */
-  visibleCommands(cmd: Command): Command[];
-  /** Get an array of the visible options. Includes a placeholder for the implicit help option, if there is one. */
-  visibleOptions(cmd: Command): Option[];
-  /** Get an array of the visible global options. (Not including help.) */
-  visibleGlobalOptions(cmd: Command): Option[];
-  /** Get an array of the arguments which have descriptions. */
-  visibleArguments(cmd: Command): Argument[];
-
-  /** Get the longest command term length. */
-  longestSubcommandTermLength(cmd: Command, helper: Help): number;
-  /** Get the longest option term length. */
-  longestOptionTermLength(cmd: Command, helper: Help): number;
-  /** Get the longest global option term length. */
-  longestGlobalOptionTermLength(cmd: Command, helper: Help): number;
-  /** Get the longest argument term length. */
-  longestArgumentTermLength(cmd: Command, helper: Help): number;
-
-  /** Return display width of string, ignoring ANSI escape sequences. Used in padding and wrapping calculations. */
-  displayWidth(str: string): number;
-
-  /** Style the titles. Called with 'Usage:', 'Options:', etc. */
-  styleTitle(title: string): string;
-
-  /** Usage: <str> */
-  styleUsage(str: string): string;
-  /** Style for command name in usage string.  */
-  styleCommandText(str: string): string;
-
-  styleCommandDescription(str: string): string;
-  styleOptionDescription(str: string): string;
-  styleSubcommandDescription(str: string): string;
-  styleArgumentDescription(str: string): string;
-  /** Base style used by descriptions. */
-  styleDescriptionText(str: string): string;
-
-  styleOptionTerm(str: string): string;
-  styleSubcommandTerm(str: string): string;
-  styleArgumentTerm(str: string): string;
-
-  /** Base style used in terms and usage for options. */
-  styleOptionText(str: string): string;
-  /** Base style used in terms and usage for subcommands. */
-  styleSubcommandText(str: string): string;
-  /** Base style used in terms and usage for arguments. */
-  styleArgumentText(str: string): string;
-
-  /** Calculate the pad width from the maximum term length. */
-  padWidth(cmd: Command, helper: Help): number;
-
-  /**
-   * Wrap a string at whitespace, preserving existing line breaks.
-   * Wrapping is skipped if the width is less than `minWidthToWrap`.
-   */
-  boxWrap(str: string, width: number): string;
-
-  /** Detect manually wrapped and indented strings by checking for line break followed by whitespace. */
-  preformatted(str: string): boolean;
-
-  /**
-   * Format the "item", which consists of a term and description. Pad the term and wrap the description, indenting the following lines.
-   *
-   * So "TTT", 5, "DDD DDDD DD DDD" might be formatted for this.helpWidth=17 like so:
-   *   TTT    DDD DDDD
-   *          DD DDD
-   */
-  formatItem(
-    term: string,
-    termWidth: number,
-    description: string,
-    helper: Help,
-  ): string;
-
-  /**
-   * Format a list of items, given a heading and an array of formatted items.
-   */
-  formatItemList(heading: string, items: string[], helper: Help): string[];
-
-  /**
-   * Group items by their help group heading.
-   */
-  groupItems<T extends Command | Option>(
-    unsortedItems: T[],
-    visibleItems: T[],
-    getGroup: (item: T) => string,
-  ): Map<string, T[]>;
-
-  /** Generate the built-in help text. */
-  formatHelp(cmd: Command, helper: Help): string;
-}
-export type HelpConfiguration = Partial<Help>;
-
-export interface ParseOptions {
-  from: 'node' | 'electron' | 'user';
-}
-export interface HelpContext {
-  // optional parameter for .help() and .outputHelp()
-  error: boolean;
-}
-export interface AddHelpTextContext {
-  // passed to text function used with .addHelpText()
-  error: boolean;
-  command: Command;
-}
-export interface OutputConfiguration {
-  writeOut?(str: string): void;
-  writeErr?(str: string): void;
-  outputError?(str: string, write: (str: string) => void): void;
-
-  getOutHelpWidth?(): number;
-  getErrHelpWidth?(): number;
-
-  getOutHasColors?(): boolean;
-  getErrHasColors?(): boolean;
-  stripColor?(str: string): string;
-}
-
-export type AddHelpTextPosition = 'beforeAll' | 'before' | 'after' | 'afterAll';
-export type HookEvent = 'preSubcommand' | 'preAction' | 'postAction';
-// The source is a string so author can define their own too.
-export type OptionValueSource =
-  | LiteralUnion<'default' | 'config' | 'env' | 'cli' | 'implied', string>
-  | undefined;
-
-export type OptionValues = Record<string, any>;
-
-export class Command {
-  args: string[];
-  processedArgs: any[];
-  readonly commands: readonly Command[];
-  readonly options: readonly Option[];
-  readonly registeredArguments: readonly Argument[];
-  parent: Command | null;
-
-  constructor(name?: string);
-
-  /**
-   * Set the program version to `str`.
-   *
-   * This method auto-registers the "-V, --version" flag
-   * which will print the version number when passed.
-   *
-   * You can optionally supply the  flags and description to override the defaults.
-   */
-  version(str: string, flags?: string, description?: string): this;
-  /**
-   * Get the program version.
-   */
-  version(): string | undefined;
-
-  /**
-   * Define a command, implemented using an action handler.
-   *
-   * @remarks
-   * The command description is supplied using `.description`, not as a parameter to `.command`.
-   *
-   * @example
-   * ```ts
-   * program
-   *   .command('clone <source> [destination]')
-   *   .description('clone a repository into a newly created directory')
-   *   .action((source, destination) => {
-   *     console.log('clone command called');
-   *   });
-   * ```
-   *
-   * @param nameAndArgs - command name and arguments, args are  `<required>` or `[optional]` and last may also be `variadic...`
-   * @param opts - configuration options
-   * @returns new command
-   */
-  command(
-    nameAndArgs: string,
-    opts?: CommandOptions,
-  ): ReturnType<this['createCommand']>;
-  /**
-   * Define a command, implemented in a separate executable file.
-   *
-   * @remarks
-   * The command description is supplied as the second parameter to `.command`.
-   *
-   * @example
-   * ```ts
-   *  program
-   *    .command('start <service>', 'start named service')
-   *    .command('stop [service]', 'stop named service, or all if no name supplied');
-   * ```
-   *
-   * @param nameAndArgs - command name and arguments, args are  `<required>` or `[optional]` and last may also be `variadic...`
-   * @param description - description of executable command
-   * @param opts - configuration options
-   * @returns `this` command for chaining
-   */
-  command(
-    nameAndArgs: string,
-    description: string,
-    opts?: ExecutableCommandOptions,
-  ): this;
-
-  /**
-   * Factory routine to create a new unattached command.
-   *
-   * See .command() for creating an attached subcommand, which uses this routine to
-   * create the command. You can override createCommand to customise subcommands.
-   */
-  createCommand(name?: string): Command;
-
-  /**
-   * Add a prepared subcommand.
-   *
-   * See .command() for creating an attached subcommand which inherits settings from its parent.
-   *
-   * @returns `this` command for chaining
-   */
-  addCommand(cmd: Command, opts?: CommandOptions): this;
-
-  /**
-   * Factory routine to create a new unattached argument.
-   *
-   * See .argument() for creating an attached argument, which uses this routine to
-   * create the argument. You can override createArgument to return a custom argument.
-   */
-  createArgument(name: string, description?: string): Argument;
-
-  /**
-   * Define argument syntax for command.
-   *
-   * The default is that the argument is required, and you can explicitly
-   * indicate this with <> around the name. Put [] around the name for an optional argument.
-   *
-   * @example
-   * ```
-   * program.argument('<input-file>');
-   * program.argument('[output-file]');
-   * ```
-   *
-   * @returns `this` command for chaining
-   */
-  argument<T>(
-    flags: string,
-    description: string,
-    parseArg: (value: string, previous: T) => T,
-    defaultValue?: T,
-  ): this;
-  argument(name: string, description?: string, defaultValue?: unknown): this;
-
-  /**
-   * Define argument syntax for command, adding a prepared argument.
-   *
-   * @returns `this` command for chaining
-   */
-  addArgument(arg: Argument): this;
-
-  /**
-   * Define argument syntax for command, adding multiple at once (without descriptions).
-   *
-   * See also .argument().
-   *
-   * @example
-   * ```
-   * program.arguments('<cmd> [env]');
-   * ```
-   *
-   * @returns `this` command for chaining
-   */
-  arguments(names: string): this;
-
-  /**
-   * Customise or override default help command. By default a help command is automatically added if your command has subcommands.
-   *
-   * @example
-   * ```ts
-   * program.helpCommand('help [cmd]');
-   * program.helpCommand('help [cmd]', 'show help');
-   * program.helpCommand(false); // suppress default help command
-   * program.helpCommand(true); // add help command even if no subcommands
-   * ```
-   */
-  helpCommand(nameAndArgs: string, description?: string): this;
-  helpCommand(enable: boolean): this;
-
-  /**
-   * Add prepared custom help command.
-   */
-  addHelpCommand(cmd: Command): this;
-  /** @deprecated since v12, instead use helpCommand */
-  addHelpCommand(nameAndArgs: string, description?: string): this;
-  /** @deprecated since v12, instead use helpCommand */
-  addHelpCommand(enable?: boolean): this;
-
-  /**
-   * Add hook for life cycle event.
-   */
-  hook(
-    event: HookEvent,
-    listener: (
-      thisCommand: Command,
-      actionCommand: Command,
-    ) => void | Promise<void>,
-  ): this;
-
-  /**
-   * Register callback to use as replacement for calling process.exit.
-   */
-  exitOverride(callback?: (err: CommanderError) => never | void): this;
-
-  /**
-   * Display error message and exit (or call exitOverride).
-   */
-  error(message: string, errorOptions?: ErrorOptions): never;
-
-  /**
-   * You can customise the help with a subclass of Help by overriding createHelp,
-   * or by overriding Help properties using configureHelp().
-   */
-  createHelp(): Help;
-
-  /**
-   * You can customise the help by overriding Help properties using configureHelp(),
-   * or with a subclass of Help by overriding createHelp().
-   */
-  configureHelp(configuration: HelpConfiguration): this;
-  /** Get configuration */
-  configureHelp(): HelpConfiguration;
-
-  /**
-   * The default output goes to stdout and stderr. You can customise this for special
-   * applications. You can also customise the display of errors by overriding outputError.
-   *
-   * The configuration properties are all functions:
-   * ```
-   * // functions to change where being written, stdout and stderr
-   * writeOut(str)
-   * writeErr(str)
-   * // matching functions to specify width for wrapping help
-   * getOutHelpWidth()
-   * getErrHelpWidth()
-   * // functions based on what is being written out
-   * outputError(str, write) // used for displaying errors, and not used for displaying help
-   * ```
-   */
-  configureOutput(configuration: OutputConfiguration): this;
-  /** Get configuration */
-  configureOutput(): OutputConfiguration;
-
-  /**
-   * Copy settings that are useful to have in common across root command and subcommands.
-   *
-   * (Used internally when adding a command using `.command()` so subcommands inherit parent settings.)
-   */
-  copyInheritedSettings(sourceCommand: Command): this;
-
-  /**
-   * Display the help or a custom message after an error occurs.
-   */
-  showHelpAfterError(displayHelp?: boolean | string): this;
-
-  /**
-   * Display suggestion of similar commands for unknown commands, or options for unknown options.
-   */
-  showSuggestionAfterError(displaySuggestion?: boolean): this;
-
-  /**
-   * Register callback `fn` for the command.
-   *
-   * @example
-   * ```
-   * program
-   *   .command('serve')
-   *   .description('start service')
-   *   .action(function() {
-   *     // do work here
-   *   });
-   * ```
-   *
-   * @returns `this` command for chaining
-   */
-  action(fn: (this: this, ...args: any[]) => void | Promise<void>): this;
-
-  /**
-   * Define option with `flags`, `description`, and optional argument parsing function or `defaultValue` or both.
-   *
-   * The `flags` string contains the short and/or long flags, separated by comma, a pipe or space. A required
-   * option-argument is indicated by `<>` and an optional option-argument by `[]`.
-   *
-   * See the README for more details, and see also addOption() and requiredOption().
-   *
-   * @example
-   *
-   * ```js
-   * program
-   *     .option('-p, --pepper', 'add pepper')
-   *     .option('--pt, --pizza-type <TYPE>', 'type of pizza') // required option-argument
-   *     .option('-c, --cheese [CHEESE]', 'add extra cheese', 'mozzarella') // optional option-argument with default
-   *     .option('-t, --tip <VALUE>', 'add tip to purchase cost', parseFloat) // custom parse function
-   * ```
-   *
-   * @returns `this` command for chaining
-   */
-  option(
-    flags: string,
-    description?: string,
-    defaultValue?: string | boolean | string[],
-  ): this;
-  option<T>(
-    flags: string,
-    description: string,
-    parseArg: (value: string, previous: T) => T,
-    defaultValue?: T,
-  ): this;
-  /** @deprecated since v7, instead use choices or a custom function */
-  option(
-    flags: string,
-    description: string,
-    regexp: RegExp,
-    defaultValue?: string | boolean | string[],
-  ): this;
-
-  /**
-   * Define a required option, which must have a value after parsing. This usually means
-   * the option must be specified on the command line. (Otherwise the same as .option().)
-   *
-   * The `flags` string contains the short and/or long flags, separated by comma, a pipe or space.
-   */
-  requiredOption(
-    flags: string,
-    description?: string,
-    defaultValue?: string | boolean | string[],
-  ): this;
-  requiredOption<T>(
-    flags: string,
-    description: string,
-    parseArg: (value: string, previous: T) => T,
-    defaultValue?: T,
-  ): this;
-  /** @deprecated since v7, instead use choices or a custom function */
-  requiredOption(
-    flags: string,
-    description: string,
-    regexp: RegExp,
-    defaultValue?: string | boolean | string[],
-  ): this;
-
-  /**
-   * Factory routine to create a new unattached option.
-   *
-   * See .option() for creating an attached option, which uses this routine to
-   * create the option. You can override createOption to return a custom option.
-   */
-
-  createOption(flags: string, description?: string): Option;
-
-  /**
-   * Add a prepared Option.
-   *
-   * See .option() and .requiredOption() for creating and attaching an option in a single call.
-   */
-  addOption(option: Option): this;
-
-  /**
-   * Whether to store option values as properties on command object,
-   * or store separately (specify false). In both cases the option values can be accessed using .opts().
-   *
-   * @returns `this` command for chaining
-   */
-  storeOptionsAsProperties<T extends OptionValues>(): this & T;
-  storeOptionsAsProperties<T extends OptionValues>(
-    storeAsProperties: true,
-  ): this & T;
-  storeOptionsAsProperties(storeAsProperties?: boolean): this;
-
-  /**
-   * Retrieve option value.
-   */
-  getOptionValue(key: string): any;
-
-  /**
-   * Store option value.
-   */
-  setOptionValue(key: string, value: unknown): this;
-
-  /**
-   * Store option value and where the value came from.
-   */
-  setOptionValueWithSource(
-    key: string,
-    value: unknown,
-    source: OptionValueSource,
-  ): this;
-
-  /**
-   * Get source of option value.
-   */
-  getOptionValueSource(key: string): OptionValueSource | undefined;
-
-  /**
-   * Get source of option value. See also .optsWithGlobals().
-   */
-  getOptionValueSourceWithGlobals(key: string): OptionValueSource | undefined;
-
-  /**
-   * Alter parsing of short flags with optional values.
-   *
-   * @example
-   * ```
-   * // for `.option('-f,--flag [value]'):
-   * .combineFlagAndOptionalValue(true)  // `-f80` is treated like `--flag=80`, this is the default behaviour
-   * .combineFlagAndOptionalValue(false) // `-fb` is treated like `-f -b`
-   * ```
-   *
-   * @returns `this` command for chaining
-   */
-  combineFlagAndOptionalValue(combine?: boolean): this;
-
-  /**
-   * Allow unknown options on the command line.
-   *
-   * @returns `this` command for chaining
-   */
-  allowUnknownOption(allowUnknown?: boolean): this;
-
-  /**
-   * Allow excess command-arguments on the command line. Pass false to make excess arguments an error.
-   *
-   * @returns `this` command for chaining
-   */
-  allowExcessArguments(allowExcess?: boolean): this;
-
-  /**
-   * Enable positional options. Positional means global options are specified before subcommands which lets
-   * subcommands reuse the same option names, and also enables subcommands to turn on passThroughOptions.
-   *
-   * The default behaviour is non-positional and global options may appear anywhere on the command line.
-   *
-   * @returns `this` command for chaining
-   */
-  enablePositionalOptions(positional?: boolean): this;
-
-  /**
-   * Pass through options that come after command-arguments rather than treat them as command-options,
-   * so actual command-options come before command-arguments. Turning this on for a subcommand requires
-   * positional options to have been enabled on the program (parent commands).
-   *
-   * The default behaviour is non-positional and options may appear before or after command-arguments.
-   *
-   * @returns `this` command for chaining
-   */
-  passThroughOptions(passThrough?: boolean): this;
-
-  /**
-   * Parse `argv`, setting options and invoking commands when defined.
-   *
-   * Use parseAsync instead of parse if any of your action handlers are async.
-   *
-   * Call with no parameters to parse `process.argv`. Detects Electron and special node options like `node --eval`. Easy mode!
-   *
-   * Or call with an array of strings to parse, and optionally where the user arguments start by specifying where the arguments are `from`:
-   * - `'node'`: default, `argv[0]` is the application and `argv[1]` is the script being run, with user arguments after that
-   * - `'electron'`: `argv[0]` is the application and `argv[1]` varies depending on whether the electron application is packaged
-   * - `'user'`: just user arguments
-   *
-   * @example
-   * ```
-   * program.parse(); // parse process.argv and auto-detect electron and special node flags
-   * program.parse(process.argv); // assume argv[0] is app and argv[1] is script
-   * program.parse(my-args, { from: 'user' }); // just user supplied arguments, nothing special about argv[0]
-   * ```
-   *
-   * @returns `this` command for chaining
-   */
-  parse(argv?: readonly string[], parseOptions?: ParseOptions): this;
-
-  /**
-   * Parse `argv`, setting options and invoking commands when defined.
-   *
-   * Call with no parameters to parse `process.argv`. Detects Electron and special node options like `node --eval`. Easy mode!
-   *
-   * Or call with an array of strings to parse, and optionally where the user arguments start by specifying where the arguments are `from`:
-   * - `'node'`: default, `argv[0]` is the application and `argv[1]` is the script being run, with user arguments after that
-   * - `'electron'`: `argv[0]` is the application and `argv[1]` varies depending on whether the electron application is packaged
-   * - `'user'`: just user arguments
-   *
-   * @example
-   * ```
-   * await program.parseAsync(); // parse process.argv and auto-detect electron and special node flags
-   * await program.parseAsync(process.argv); // assume argv[0] is app and argv[1] is script
-   * await program.parseAsync(my-args, { from: 'user' }); // just user supplied arguments, nothing special about argv[0]
-   * ```
-   *
-   * @returns Promise
-   */
-  parseAsync(
-    argv?: readonly string[],
-    parseOptions?: ParseOptions,
-  ): Promise<this>;
-
-  /**
-   * Called the first time parse is called to save state and allow a restore before subsequent calls to parse.
-   * Not usually called directly, but available for subclasses to save their custom state.
-   *
-   * This is called in a lazy way. Only commands used in parsing chain will have state saved.
-   */
-  saveStateBeforeParse(): void;
-
-  /**
-   * Restore state before parse for calls after the first.
-   * Not usually called directly, but available for subclasses to save their custom state.
-   *
-   * This is called in a lazy way. Only commands used in parsing chain will have state restored.
-   */
-  restoreStateBeforeParse(): void;
-
-  /**
-   * Parse options from `argv` removing known options,
-   * and return argv split into operands and unknown arguments.
-   *
-   * Side effects: modifies command by storing options. Does not reset state if called again.
-   *
-   *     argv => operands, unknown
-   *     --known kkk op => [op], []
-   *     op --known kkk => [op], []
-   *     sub --unknown uuu op => [sub], [--unknown uuu op]
-   *     sub -- --unknown uuu op => [sub --unknown uuu op], []
-   */
-  parseOptions(argv: string[]): ParseOptionsResult;
-
-  /**
-   * Return an object containing local option values as key-value pairs
-   */
-  opts<T extends OptionValues>(): T;
-
-  /**
-   * Return an object containing merged local and global option values as key-value pairs.
-   */
-  optsWithGlobals<T extends OptionValues>(): T;
-
-  /**
-   * Set the description.
-   *
-   * @returns `this` command for chaining
-   */
-
-  description(str: string): this;
-  /** @deprecated since v8, instead use .argument to add command argument with description */
-  description(str: string, argsDescription: Record<string, string>): this;
-  /**
-   * Get the description.
-   */
-  description(): string;
-
-  /**
-   * Set the summary. Used when listed as subcommand of parent.
-   *
-   * @returns `this` command for chaining
-   */
-
-  summary(str: string): this;
-  /**
-   * Get the summary.
-   */
-  summary(): string;
-
-  /**
-   * Set an alias for the command.
-   *
-   * You may call more than once to add multiple aliases. Only the first alias is shown in the auto-generated help.
-   *
-   * @returns `this` command for chaining
-   */
-  alias(alias: string): this;
-  /**
-   * Get alias for the command.
-   */
-  alias(): string;
-
-  /**
-   * Set aliases for the command.
-   *
-   * Only the first alias is shown in the auto-generated help.
-   *
-   * @returns `this` command for chaining
-   */
-  aliases(aliases: readonly string[]): this;
-  /**
-   * Get aliases for the command.
-   */
-  aliases(): string[];
-
-  /**
-   * Set the command usage.
-   *
-   * @returns `this` command for chaining
-   */
-  usage(str: string): this;
-  /**
-   * Get the command usage.
-   */
-  usage(): string;
-
-  /**
-   * Set the name of the command.
-   *
-   * @returns `this` command for chaining
-   */
-  name(str: string): this;
-  /**
-   * Get the name of the command.
-   */
-  name(): string;
-
-  /**
-   * Set the name of the command from script filename, such as process.argv[1],
-   * or require.main.filename, or __filename.
-   *
-   * (Used internally and public although not documented in README.)
-   *
-   * @example
-   * ```ts
-   * program.nameFromFilename(require.main.filename);
-   * ```
-   *
-   * @returns `this` command for chaining
-   */
-  nameFromFilename(filename: string): this;
-
-  /**
-   * Set the directory for searching for executable subcommands of this command.
-   *
-   * @example
-   * ```ts
-   * program.executableDir(__dirname);
-   * // or
-   * program.executableDir('subcommands');
-   * ```
-   *
-   * @returns `this` command for chaining
-   */
-  executableDir(path: string): this;
-  /**
-   * Get the executable search directory.
-   */
-  executableDir(): string | null;
-
-  /**
-   * Set the help group heading for this subcommand in parent command's help.
-   *
-   * @returns `this` command for chaining
-   */
-  helpGroup(heading: string): this;
-  /**
-   * Get the help group heading for this subcommand in parent command's help.
-   */
-  helpGroup(): string;
-
-  /**
-   * Set the default help group heading for subcommands added to this command.
-   * (This does not override a group set directly on the subcommand using .helpGroup().)
-   *
-   * @example
-   * program.commandsGroup('Development Commands:);
-   * program.command('watch')...
-   * program.command('lint')...
-   * ...
-   *
-   * @returns `this` command for chaining
-   */
-  commandsGroup(heading: string): this;
-  /**
-   * Get the default help group heading for subcommands added to this command.
-   */
-  commandsGroup(): string;
-
-  /**
-   * Set the default help group heading for options added to this command.
-   * (This does not override a group set directly on the option using .helpGroup().)
-   *
-   * @example
-   * program
-   *   .optionsGroup('Development Options:')
-   *   .option('-d, --debug', 'output extra debugging')
-   *   .option('-p, --profile', 'output profiling information')
-   *
-   * @returns `this` command for chaining
-   */
-  optionsGroup(heading: string): this;
-  /**
-   * Get the default help group heading for options added to this command.
-   */
-  optionsGroup(): string;
-
-  /**
-   * Output help information for this command.
-   *
-   * Outputs built-in help, and custom text added using `.addHelpText()`.
-   *
-   */
-  outputHelp(context?: HelpContext): void;
-  /** @deprecated since v7 */
-  outputHelp(cb: (str: string) => string): void;
-
-  /**
-   * Return command help documentation.
-   */
-  helpInformation(context?: HelpContext): string;
-
-  /**
-   * You can pass in flags and a description to override the help
-   * flags and help description for your command. Pass in false
-   * to disable the built-in help option.
-   */
-  helpOption(flags?: string | boolean, description?: string): this;
-
-  /**
-   * Supply your own option to use for the built-in help option.
-   * This is an alternative to using helpOption() to customise the flags and description etc.
-   */
-  addHelpOption(option: Option): this;
-
-  /**
-   * Output help information and exit.
-   *
-   * Outputs built-in help, and custom text added using `.addHelpText()`.
-   */
-  help(context?: HelpContext): never;
-  /** @deprecated since v7 */
-  help(cb: (str: string) => string): never;
-
-  /**
-   * Add additional text to be displayed with the built-in help.
-   *
-   * Position is 'before' or 'after' to affect just this command,
-   * and 'beforeAll' or 'afterAll' to affect this command and all its subcommands.
-   */
-  addHelpText(position: AddHelpTextPosition, text: string): this;
-  addHelpText(
-    position: AddHelpTextPosition,
-    text: (context: AddHelpTextContext) => string,
-  ): this;
-
-  /**
-   * Add a listener (callback) for when events occur. (Implemented using EventEmitter.)
-   */
-  on(event: string | symbol, listener: (...args: any[]) => void): this;
-}
-
-export interface CommandOptions {
-  hidden?: boolean;
-  isDefault?: boolean;
-  /** @deprecated since v7, replaced by hidden */
-  noHelp?: boolean;
-}
-export interface ExecutableCommandOptions extends CommandOptions {
-  executableFile?: string;
-}
-
-export interface ParseOptionsResult {
-  operands: string[];
-  unknown: string[];
-}
-
-export function createCommand(name?: string): Command;
-export function createOption(flags: string, description?: string): Option;
-export function createArgument(name: string, description?: string): Argument;
-
-export const program: Command;