/** Combines recursively all intersection types and returns a new single type. */ type Id = TRecord extends Record ? TRecord extends infer InferredRecord ? { [Key in keyof InferredRecord]: Id; } : never : TRecord; /** Converts a union type `A | B | C` into an intersection type `A & B & C`. */ type UnionToIntersection = (TValue extends unknown ? (args: TValue) => unknown : never) extends (args: infer R) => unknown ? R extends Record ? R : never : never; export type BooleanType = boolean | string | undefined; export type StringType = string | undefined; export type ArgType = StringType | BooleanType; export type Collectable = string | undefined; export type Negatable = string | undefined; type UseTypes = undefined extends ((false extends TBooleans ? undefined : TBooleans) & TCollectable & TStrings) ? false : true; /** * Creates a record with all available flags with the corresponding type and * default type. */ export type Values | undefined, TAliases extends Aliases | undefined> = UseTypes extends true ? Record & AddAliases & RecursiveRequired> & CollectUnknownValues, DedotRecord>, TAliases> : Record; export type Aliases = Partial, TAliasNames | ReadonlyArray>>; type AddAliases = { [TArgName in keyof TArgs as AliasNames]: TArgs[TArgName]; }; type AliasNames = TArgName extends keyof TAliases ? string extends TAliases[TArgName] ? TArgName : TAliases[TArgName] extends string ? TArgName | TAliases[TArgName] : TAliases[TArgName] extends Array ? TArgName | TAliases[TArgName][number] : TArgName : TArgName; /** * Spreads all default values of Record `TDefaults` into Record `TArgs` * and makes default values required. * * **Example:** * `SpreadValues<{ foo?: boolean, bar?: number }, { foo: number }>` * * **Result:** `{ foo: boolean | number, bar?: number }` */ type SpreadDefaults = TDefaults extends undefined ? TArgs : TArgs extends Record ? Omit & { [Default in keyof TDefaults]: Default extends keyof TArgs ? (TArgs[Default] & TDefaults[Default] | TDefaults[Default]) extends Record ? NonNullable> : TDefaults[Default] | NonNullable : unknown; } : never; /** * Defines the Record for the `default` option to add * auto-suggestion support for IDE's. */ type Defaults = Id & MapTypes & MapTypes & MapDefaults & MapDefaults>>; type MapDefaults = Partial>; type RecursiveRequired = TRecord extends Record ? { [Key in keyof TRecord]-?: RecursiveRequired; } : TRecord; /** Same as `MapTypes` but also supports collectable options. */ type CollectValues = UnionToIntersection extends string ? (Exclude extends never ? Record : MapTypes, TType, TNegatable>) & (Extract extends never ? Record : RecursiveRequired, Array, TNegatable>>) : MapTypes>; /** Same as `Record` but also supports dotted and negatable options. */ type MapTypes = undefined extends TArgNames ? Record : TArgNames extends `${infer Name}.${infer Rest}` ? { [Key in Name]?: MapTypes; } : TArgNames extends string ? Partial> : Record; type CollectUnknownValues = UnionToIntersection : DedotRecord, string>, Extract>, Array> & Record, string>, Extract>, Array | false>>>; /** Converts `{ "foo.bar.baz": unknown }` into `{ foo: { bar: { baz: unknown } } }`. */ type DedotRecord = Record extends TRecord ? TRecord : TRecord extends Record ? UnionToIntersection : never; }>> : TRecord; type Dedot = TKey extends `${infer Name}.${infer Rest}` ? { [Key in Name]: Dedot; } : { [Key in TKey]: TValue; }; type ValueOf = TValue[keyof TValue]; /** The value returned from `parse`. */ export type Args = Record> = Id; }>; /** The options for the `parse` call. */ export interface ParseOptions | undefined = Record | undefined, TAliases extends Aliases | undefined = Aliases | undefined> { /** * An object mapping string names to strings or arrays of string argument * names to use as aliases. */ alias?: TAliases; /** * A boolean, string or array of strings to always treat as booleans. If * `true` will treat all double hyphenated arguments without equal signs as * `boolean` (e.g. affects `--foo`, not `-f` or `--foo=bar`). * All `boolean` arguments will be set to `false` by default. */ boolean?: TBooleans | ReadonlyArray>; /** An object mapping string argument names to default values. */ default?: TDefault & Defaults; /** A string or array of strings argument names to always treat as strings. */ string?: TStrings | ReadonlyArray>; /** * A string or array of strings argument names to always treat as arrays. * Array options can be used multiple times. All values will be * collected into one array. If a non-array option is used multiple * times, the last value is used. * All Collectable arguments will be set to `[]` by default. */ array?: TCollectable | ReadonlyArray>; } export interface NestedMapping { [key: string]: NestedMapping | unknown; } export {};