export declare const atLeast: {
  (times: 0): <A>(self: Args<A>) => Args<Array<A>>
  (times: number): <A>(self: Args<A>) => Args<NonEmptyArray<A>>
  <A>(self: Args<A>, times: 0): Args<Array<A>>
  <A>(self: Args<A>, times: number): Args<NonEmptyArray<A>>
}

export declare const atMost: {
  (times: number): <A>(self: Args<A>) => Args<Array<A>>
  <A>(self: Args<A>, times: number): Args<Array<A>>
}

export declare const between: {
  (min: 0, max: number): <A>(self: Args<A>) => Args<Array<A>>
  (min: number, max: number): <A>(self: Args<A>) => Args<NonEmptyArray<A>>
  <A>(self: Args<A>, min: 0, max: number): Args<Array<A>>
  <A>(self: Args<A>, min: number, max: number): Args<NonEmptyArray<A>>
}

export declare const getHelp: <A>(self: Args<A>) => HelpDoc

export declare const getIdentifier: <A>(self: Args<A>) => Option<string>

export declare const getMaxSize: <A>(self: Args<A>) => number

export declare const getMinSize: <A>(self: Args<A>) => number

export declare const getUsage: <A>(self: Args<A>) => Usage

export declare const optional: <A>(self: Args<A>) => Args<Option<A>>

export declare const repeated: <A>(self: Args<A>) => Args<Array<A>>

export declare const validate: {
  (
    args: ReadonlyArray<string>,
    config: CliConfig
  ): <A>(self: Args<A>) => Effect<[Array<string>, A], ValidationError, FileSystem | Path | Terminal>
  <A>(
    self: Args<A>,
    args: ReadonlyArray<string>,
    config: CliConfig
  ): Effect<[Array<string>, A], ValidationError, FileSystem | Path | Terminal>
}

export declare const withDefault: {
  <const B>(fallback: B): <A>(self: Args<A>) => Args<B | A>
  <A, const B>(self: Args<A>, fallback: B): Args<A | B>
}

export declare const withDescription: {
  (description: string): <A>(self: Args<A>) => Args<A>
  <A>(self: Args<A>, description: string): Args<A>
}

export declare const withFallbackConfig: {
  <B>(config: Config<B>): <A>(self: Args<A>) => Args<B | A>
  <A, B>(self: Args<A>, config: Config<B>): Args<A | B>
}

export declare const withSchema: {
  <A, I extends A, B>(schema: Schema<B, I, FileSystem | Path | Terminal>): (self: Args<A>) => Args<B>
  <A, I extends A, B>(self: Args<A>, schema: Schema<B, I, FileSystem | Path | Terminal>): Args<B>
}

export declare const wizard: {
  (
    config: CliConfig
  ): <A>(self: Args<A>) => Effect<Array<string>, ValidationError | QuitException, FileSystem | Path | Terminal>
  <A>(
    self: Args<A>,
    config: CliConfig
  ): Effect<Array<string>, ValidationError | QuitException, FileSystem | Path | Terminal>
}

export declare const all: <const Arg extends Iterable<Args<any>> | Record<string, Args<any>>>(
  arg: Arg
) => All.Return<Arg>

export declare const boolean: (options?: Args.BaseArgsConfig) => Args<boolean>

export declare const choice: <A>(choices: ReadonlyArray<[string, A]>, config?: Args.BaseArgsConfig) => Args<A>

export declare const date: (config?: Args.BaseArgsConfig) => Args<globalThis.Date>

export declare const directory: (config?: Args.PathArgsConfig) => Args<string>

export declare const file: (config?: Args.PathArgsConfig) => Args<string>

export declare const fileContent: (
  config?: Args.BaseArgsConfig | undefined
) => Args<readonly [path: string, content: Uint8Array]>

export declare const fileParse: (config?: Args.FormatArgsConfig | undefined) => Args<unknown>

export declare const fileSchema: <I, A>(
  schema: Schema<A, I, FileSystem | Path | Terminal>,
  config?: Args.FormatArgsConfig | undefined
) => Args<A>

export declare const fileText: (
  config?: Args.BaseArgsConfig | undefined
) => Args<readonly [path: string, content: string]>

export declare const float: (config?: Args.BaseArgsConfig) => Args<number>

export declare const integer: (config?: Args.BaseArgsConfig) => Args<number>

export declare const none: Args<void>

export declare const path: (config?: Args.PathArgsConfig) => Args<string>

export declare const redacted: (config?: Args.BaseArgsConfig) => Args<Redacted>

export declare const secret: (config?: Args.BaseArgsConfig) => Args<Secret>

export declare const text: (config?: Args.BaseArgsConfig) => Args<string>

export declare const map: {
  <A, B>(f: (a: A) => B): (self: Args<A>) => Args<B>
  <A, B>(self: Args<A>, f: (a: A) => B): Args<B>
}

export declare const mapEffect: {
  <A, B>(f: (a: A) => Effect<B, HelpDoc, FileSystem | Path | Terminal>): (self: Args<A>) => Args<B>
  <A, B>(self: Args<A>, f: (a: A) => Effect<B, HelpDoc, FileSystem | Path | Terminal>): Args<B>
}

export declare const mapTryCatch: {
  <A, B>(f: (a: A) => B, onError: (e: unknown) => HelpDoc): (self: Args<A>) => Args<B>
  <A, B>(self: Args<A>, f: (a: A) => B, onError: (e: unknown) => HelpDoc): Args<B>
}

export interface Args<A> extends Args.Variance<A>, Pipeable {}

export declare const isArgs: (u: unknown) => u is Args<unknown>

export declare const ArgsTypeId: typeof ArgsTypeId

export type ArgsTypeId = typeof ArgsTypeId

export type ArgsAny = Args<any>

export type Return<Arg extends Iterable<ArgsAny> | Record<string, ArgsAny>> = [Arg] extends [ReadonlyArray<ArgsAny>]
  ? ReturnTuple<Arg>
  : [Arg] extends [Iterable<ArgsAny>]
    ? ReturnIterable<Arg>
    : [Arg] extends [Record<string, ArgsAny>]
      ? ReturnObject<Arg>
      : never

export type ReturnIterable<T extends Iterable<ArgsAny>> = [T] extends [Iterable<Args.Variance<infer A>>]
  ? Args<Array<A>>
  : never

export type ReturnObject<T> = [T] extends [{ [K: string]: ArgsAny }]
  ? Args<{
      -readonly [K in keyof T]: [T[K]] extends [Args.Variance<infer _A>] ? _A : never
    }>
  : never

export type ReturnTuple<T extends ReadonlyArray<unknown>> =
  Args<
    T[number] extends never
      ? []
      : {
          -readonly [K in keyof T]: [T[K]] extends [Args.Variance<infer _A>] ? _A : never
        }
  > extends infer X
    ? X
    : never

export interface BaseArgsConfig {
  readonly name?: string
}

export interface FormatArgsConfig extends BaseArgsConfig {
  readonly format?: "json" | "yaml" | "ini" | "toml"
}

export interface PathArgsConfig extends BaseArgsConfig {
  readonly exists?: Primitive.PathExists
}

export interface Variance<A> {
  readonly [ArgsTypeId]: {
    readonly _A: (_: never) => A
  }
}