import type { ArgumentOptions, ArgumentValue, DefaultValue, FlagOptions, TypeHandler, ValueHandler,} from "../flags/types.ts";import { MapTypes } from "./_argument_types.ts";import type { ValidationError } from "./_errors.ts";import type { Command } from "./command.ts";import type { HelpOptions } from "./help/_help_generator.ts";import type { Type } from "./type.ts";import type { Merge } from "./_type_utils.ts";
export type { ArgumentValue, DefaultValue, TypeHandler };
export type TypeOrTypeHandler<TValue> = Type<TValue> | TypeHandler<TValue>;
export type Id<TValue> = TValue extends Record<string, unknown> ? TValue extends infer U ? { [K in keyof U]: Id<U[K]> } : never : TValue;
export type Description< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> = | string | DescriptionHandler< TOptions, TArguments, TGlobals, TParentGlobals, TTypes, TGlobalTypes, TParentTypes, TParentCommand >;
export type DescriptionHandler< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> = ( this: Command< TParentGlobals, TParentTypes, TOptions, TArguments, TGlobals, TTypes, TGlobalTypes, TParentCommand >,) => string;
export type ActionHandler< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> = ( this: Command< TParentGlobals, TParentTypes, TOptions, TArguments, TGlobals, TTypes, TGlobalTypes, TParentCommand >, options: CommandOptions<TOptions, TGlobals, TParentGlobals>, ...args: MapTypes<TArguments>) => unknown;
export type CommandOptions< TOptions extends Record<string, any> | void = any, TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void,> = MapTypes<Merge<TParentGlobals, Merge<TGlobals, TOptions>>>;
export interface Argument extends ArgumentOptions { name: string; action: string; type: string;}
export interface CommandResult< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> { options: Id<Merge<Merge<TParentGlobals, TGlobals>, TOptions>>; args: TArguments; literal: string[]; cmd: Command< TParentGlobals, TParentTypes, TOptions, TArguments, TGlobals, TTypes, TGlobalTypes, TParentCommand >;}
export type OptionValueHandler<TValue = any, TReturn = TValue> = ValueHandler< TValue, TReturn>;
type ExcludedCommandOptions = | "name" | "args" | "type" | "optionalValue" | "requiredValue" | "aliases" | "variadic" | "list" | "value" | "default";
export interface GlobalOptionOptions< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> extends Omit<FlagOptions, ExcludedCommandOptions> { override?: boolean; hidden?: boolean; action?: ActionHandler< TOptions, TArguments, TGlobals, TParentGlobals, TTypes, TGlobalTypes, TParentTypes, TParentCommand >; prepend?: boolean; value?: OptionValueHandler; default?: DefaultValue;}
export interface OptionOptions< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> extends GlobalOptionOptions< TOptions, TArguments, TGlobals, TParentGlobals, TTypes, TGlobalTypes, TParentTypes, TParentCommand > { global?: boolean;}
export interface Option< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> extends OptionOptions< TOptions, TArguments, TGlobals, TParentGlobals, TTypes, TGlobalTypes, TParentTypes, TParentCommand >, Omit<FlagOptions, "value"> { description: string; flags: Array<string>; typeDefinition?: string; args: Argument[]; groupName?: string;}
export type EnvVarValueHandler<TValue = any, TReturn = TValue> = ( val: TValue,) => TReturn;
export interface GlobalEnvVarOptions { hidden?: boolean; required?: boolean; prefix?: string | undefined; value?: EnvVarValueHandler; exitCode?: number;}
export interface EnvVarOptions extends GlobalEnvVarOptions { global?: boolean;}
export interface EnvVar extends EnvVarOptions { name: string; names: string[]; description: string; type: string; details: Argument;}
export interface TypeOptions { override?: boolean; global?: boolean;}
export interface TypeDef extends TypeOptions { name: string; handler: Type<unknown> | TypeHandler<unknown>;}
export interface Example { name: string; description: string;}
export interface CompleteOptions { override?: boolean; global?: boolean;}
export interface Completion< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> extends CompleteOptions { name: string; complete: CompleteHandler< TOptions, TArguments, TGlobals, TParentGlobals, TTypes, TGlobalTypes, TParentTypes, TParentCommand >;}
export type CompleteHandlerResult = | Array<string | number | boolean> | Promise<Array<string | number | boolean>>;
export type ValuesHandlerResult = Array<string | number | boolean>;
export type CompleteHandler< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined,> = ( cmd: Command< TParentGlobals, TParentTypes, TOptions, TArguments, TGlobals, TTypes, TGlobalTypes, TParentCommand >, parent?: Command<any>,) => CompleteHandlerResult;
export type HelpHandler< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined, TCommand extends Command< TParentGlobals, TParentTypes, TOptions, TArguments, TGlobals, TTypes, TGlobalTypes, TParentCommand > = Command< TParentGlobals, TParentTypes, TOptions, TArguments, TGlobals, TTypes, TGlobalTypes, TParentCommand >,> = (this: TCommand, cmd: TCommand, options: HelpOptions) => string;
export type VersionHandler< TOptions extends Record<string, any> | void = any, TArguments extends Array<unknown> = TOptions extends number ? any : [], TGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TParentGlobals extends Record<string, any> | void = TOptions extends number ? any : void, TTypes extends Record<string, any> | void = TOptions extends number ? any : void, TGlobalTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentTypes extends Record<string, any> | void = TOptions extends number ? any : void, TParentCommand extends Command<any> | undefined = TOptions extends number ? any : undefined, TCommand extends Command< TParentGlobals, TParentTypes, TOptions, TArguments, TGlobals, TTypes, TGlobalTypes, TParentCommand > = Command< TParentGlobals, TParentTypes, TOptions, TArguments, TGlobals, TTypes, TGlobalTypes, TParentCommand >,> = (this: TCommand, cmd: TCommand) => string;
export type ErrorHandler = ( error: Error | ValidationError, cmd: Command,) => unknown;