@avandar/acclimate 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/CLIError.ts","../src/AcclimateCLI/AcclimateCLI.ts","../src/AcclimateCLI/createCLI/defaultCLIState.ts","../src/AcclimateCLI/createCLI/createCLI.ts","../src/AcclimateCLI/runCLI/runCLI.ts","../src/Acclimate.ts"],"names":["match","camelCase"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { CLIParamDataType } from \"./AcclimateCLI/AcclimateCLI.types\";\n\ntype CLIErrorInfo =\n  | {\n      code: \"already_run\";\n      details: undefined;\n    }\n  | {\n      code: \"unknown_command\";\n      details: { commandName: string };\n    }\n  | {\n      code: \"invalid_positional_arg_config\";\n      details: { positionalArgName: string };\n    }\n  | {\n      code: \"too_many_positional_args\";\n      details: { count: number };\n    }\n  | {\n      code: \"missing_required_positional_arg\";\n      details: { positionalArgName: string };\n    }\n  | {\n      code: \"missing_required_option\";\n      details: { optionName: string };\n    }\n  | {\n      code: \"unknown_option\";\n      details: {\n        optionName: string;\n      };\n    }\n  | {\n      code: \"invalid_cli_param_value\";\n      details: {\n        paramName: string;\n        paramValue: CLIParamDataType;\n      };\n    }\n  | { code: \"unknown_error\"; details: undefined };\n\ntype CLIErrorOptions = { message: string } & CLIErrorInfo;\n\nexport class CLIError extends Error {\n  static invalidCLIParamValue(options: {\n    paramName: string;\n    paramValue: CLIParamDataType;\n    message?: string;\n  }): CLIError {\n    return new CLIError({\n      message:\n        options.message ?? `Invalid value for CLI param \"${options.paramName}\"`,\n      code: \"invalid_cli_param_value\",\n      details: { paramName: options.paramName, paramValue: options.paramValue },\n    });\n  }\n  static missingRequiredOption(options: {\n    optionName: string;\n    message?: string;\n  }): CLIError {\n    return new CLIError({\n      message:\n        options.message ?? `Required option \"${options.optionName}\" is missing`,\n      code: \"missing_required_option\",\n      details: { optionName: options.optionName },\n    });\n  }\n\n  static missingRequiredPositionalArg(options: {\n    positionalArgName: string;\n    message?: string;\n  }): CLIError {\n    return new CLIError({\n      message:\n        options.message ??\n        `Required positional argument \"${options.positionalArgName}\" is missing`,\n      code: \"missing_required_positional_arg\",\n      details: { positionalArgName: options.positionalArgName },\n    });\n  }\n\n  static unknownOption(options: {\n    optionName: string;\n    message?: string;\n  }): CLIError {\n    return new CLIError({\n      message: options.message ?? `Option \"${options.optionName}\" not found`,\n      code: \"unknown_option\",\n      details: { optionName: options.optionName },\n    });\n  }\n\n  static tooManyPositionalArgs(options: {\n    count: number;\n    message?: string;\n  }): CLIError {\n    return new CLIError({\n      message: options.message ?? \"Too many positional arguments provided.\",\n      code: \"too_many_positional_args\",\n      details: { count: options.count },\n    });\n  }\n\n  static invalidPositionalArgConfig(options: {\n    positionalArgName: string;\n    message?: string;\n  }): CLIError {\n    return new CLIError({\n      message:\n        options.message ??\n        `Positional argument configuration for \"${options.positionalArgName}\" is invalid`,\n      code: \"invalid_positional_arg_config\",\n      details: { positionalArgName: options.positionalArgName },\n    });\n  }\n\n  static unknownCommand(options: {\n    commandName: string;\n    message?: string;\n  }): CLIError {\n    return new CLIError({\n      message: options.message ?? `Command \"${options.commandName}\" not found`,\n      code: \"unknown_command\",\n      details: { commandName: options.commandName },\n    });\n  }\n\n  static alreadyRun(options: { message?: string } = {}): CLIError {\n    return new CLIError({\n      message: options.message ?? \"CLI has already been run\",\n      code: \"already_run\",\n      details: undefined,\n    });\n  }\n\n  constructor(options: CLIErrorOptions) {\n    super(`❌ ${options.message}`);\n  }\n}\n","import { CLIError } from \"@/CLIError\";\nimport type {\n  AddEntry,\n  CLICommandName,\n  CLIFullOptionName,\n  CLIOptionParam,\n  CLIPositionalParam,\n  CLIPositionalParamName,\n  CLIState,\n  FullCLIArgValues,\n  IAcclimateCLI,\n} from \"./AcclimateCLI.types\";\nimport type { EmptyObject, Simplify } from \"type-fest\";\n\nexport function AcclimateCLI<\n  TPositionalParams extends\n    | Record<CLIPositionalParamName, CLIPositionalParam>\n    | EmptyObject,\n  TOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject,\n  TGlobalOptionParams extends\n    | Record<CLIFullOptionName, CLIOptionParam>\n    | EmptyObject,\n  TCommands extends Record<CLICommandName, IAcclimateCLI> | EmptyObject,\n>(\n  state: CLIState<\n    TPositionalParams,\n    TOptionParams,\n    TGlobalOptionParams,\n    TCommands\n  >,\n): IAcclimateCLI<\n  TPositionalParams,\n  TOptionParams,\n  TGlobalOptionParams,\n  TCommands\n> {\n  return {\n    state,\n\n    action: (\n      action: (\n        args: Simplify<\n          FullCLIArgValues<\n            TPositionalParams,\n            TOptionParams,\n            TGlobalOptionParams\n          >\n        >,\n      ) => void,\n    ): IAcclimateCLI<\n      TPositionalParams,\n      TOptionParams,\n      TGlobalOptionParams,\n      TCommands\n    > => {\n      return AcclimateCLI({\n        ...state,\n        action,\n      });\n    },\n\n    description: (\n      description: string,\n    ): IAcclimateCLI<\n      TPositionalParams,\n      TOptionParams,\n      TGlobalOptionParams,\n      TCommands\n    > => {\n      return AcclimateCLI({\n        ...state,\n        description,\n      });\n    },\n\n    addPositionalArg: <\n      PName extends CLIPositionalParamName,\n      P extends CLIPositionalParam<PName>,\n    >(\n      param: P,\n    ) => {\n      if (\n        param.required &&\n        state.positionalArgs.some((p) => {\n          return !p.required;\n        })\n      ) {\n        throw CLIError.invalidPositionalArgConfig({\n          positionalArgName: param.name,\n          message:\n            \"Required positional arguments must be before optional positional arguments\",\n        });\n      }\n\n      return AcclimateCLI({\n        ...state,\n        positionalArgs: [\n          ...state.positionalArgs,\n          { ...param, required: param.required ?? true },\n        ],\n      } as unknown as CLIState<\n        AddEntry<TPositionalParams, P[\"name\"], P>,\n        TOptionParams,\n        TGlobalOptionParams,\n        TCommands\n      >);\n    },\n\n    addGlobalOption: <P extends CLIOptionParam>(param: P) => {\n      const newAliases = (param.aliases ?? []).reduce(\n        (acc, alias) => {\n          acc[alias] = param.name;\n          return acc;\n        },\n        {} as Record<`-${string}` | `--${string}`, `--${string}`>,\n      );\n      return AcclimateCLI<\n        TPositionalParams,\n        TOptionParams,\n        AddEntry<TGlobalOptionParams, P[\"name\"], P>,\n        TCommands\n      >({\n        ...state,\n        aliases: { ...state.aliases, ...newAliases },\n        globalOptionArgs: {\n          ...state.globalOptionArgs,\n          [param.name]: param,\n        },\n      } as unknown as CLIState<\n        TPositionalParams,\n        TOptionParams,\n        AddEntry<TGlobalOptionParams, P[\"name\"], P>,\n        TCommands\n      >);\n    },\n\n    addOption: <P extends CLIOptionParam>(param: P) => {\n      const newAliases = (param.aliases ?? []).reduce(\n        (acc, alias) => {\n          acc[alias] = param.name;\n          return acc;\n        },\n        {} as Record<`-${string}` | `--${string}`, `--${string}`>,\n      );\n      return AcclimateCLI<\n        TPositionalParams,\n        AddEntry<TOptionParams, P[\"name\"], P>,\n        TGlobalOptionParams,\n        TCommands\n      >({\n        ...state,\n        aliases: { ...state.aliases, ...newAliases },\n        optionArgs: { ...state.optionArgs, [param.name]: param },\n      } as unknown as CLIState<\n        TPositionalParams,\n        AddEntry<TOptionParams, P[\"name\"], P>,\n        TGlobalOptionParams,\n        TCommands\n      >);\n    },\n\n    addCommand: <C extends CLICommandName, CommandCLI extends IAcclimateCLI>(\n      commandName: C,\n      cli: CommandCLI,\n    ): IAcclimateCLI<\n      TPositionalParams,\n      TOptionParams,\n      TGlobalOptionParams,\n      AddEntry<TCommands, C, CommandCLI>\n    > => {\n      return AcclimateCLI({\n        ...state,\n        commands: {\n          ...state.commands,\n          [commandName]: cli,\n        },\n      } as unknown as CLIState<\n        TPositionalParams,\n        TOptionParams,\n        TGlobalOptionParams,\n        AddEntry<TCommands, C, CommandCLI>\n      >);\n    },\n\n    getCommandCLI: <C extends Extract<keyof TCommands, CLICommandName>>(\n      commandName: C,\n    ): C extends keyof TCommands ? TCommands[C] : never => {\n      const cmd = state.commands[commandName];\n      if (!cmd) {\n        throw CLIError.unknownCommand({\n          commandName,\n          message: `Command \"${commandName}\" not found`,\n        });\n      }\n      return cmd as C extends keyof TCommands ? TCommands[C] : never;\n    },\n  };\n}\n","import type { CLIState } from \"../AcclimateCLI.types\";\nimport type { EmptyObject } from \"type-fest\";\n\nexport const defaultCLIState: Omit<\n  CLIState<EmptyObject, EmptyObject, EmptyObject, EmptyObject>,\n  \"name\"\n> = {\n  aliases: {},\n  description: undefined,\n  commands: {},\n  positionalArgs: [],\n  optionArgs: {},\n  globalOptionArgs: {},\n  action: () => {},\n};\n","import { AcclimateCLI } from \"../AcclimateCLI\";\nimport { defaultCLIState } from \"./defaultCLIState\";\nimport type { IAcclimateCLI } from \"../AcclimateCLI.types\";\nimport type { EmptyObject } from \"type-fest\";\n\n/**\n * Builder function to create a new CLI instance with a given name.\n *\n * @param name - The name of the CLI.\n * @returns A new CLI instance.\n */\nexport function createCLI(\n  name: string,\n): IAcclimateCLI<EmptyObject, EmptyObject, EmptyObject, EmptyObject> {\n  return AcclimateCLI({ ...defaultCLIState, name });\n}\n","import { camelCase } from \"change-case\";\nimport { match } from \"ts-pattern\";\nimport { CLIError } from \"@/CLIError\";\nimport type {\n  AnyCLI,\n  CLICommandName,\n  CLIFullOptionName,\n  CLIOptionAlias,\n  CLIOptionParam,\n  CLIParam,\n  CLIParamDataType,\n  CLIPositionalParam,\n  CLIPositionalParamName,\n  CLIState,\n  FullCLIArgValues,\n  IAcclimateCLI,\n  ValueOfParam,\n} from \"@/AcclimateCLI/AcclimateCLI.types\";\nimport type { EmptyObject } from \"type-fest\";\n\nfunction _isValidFullOptionName(name: string): name is CLIFullOptionName {\n  return name.startsWith(\"--\");\n}\n\nfunction _isValidOptionAlias(name: string): name is CLIOptionAlias {\n  return name.startsWith(\"-\");\n}\n\nfunction isEmptyObject(obj: object): obj is EmptyObject {\n  return Object.keys(obj).length === 0;\n}\n\nfunction _validateParsedValue<\n  P extends CLIParam<string>,\n  PValue extends ValueOfParam<P>,\n>(options: { parsedValue: PValue; paramConfig: P }): PValue {\n  const { parsedValue, paramConfig } = options;\n  if (paramConfig.validator) {\n    const validator = paramConfig.validator as (\n      value: PValue,\n    ) => boolean | string;\n    const validationResult = validator(parsedValue);\n    if (validationResult === true) {\n      return parsedValue;\n    }\n    throw CLIError.invalidCLIParamValue({\n      paramName: paramConfig.name,\n      paramValue: parsedValue,\n      message:\n        typeof validationResult === \"string\" ? validationResult : undefined,\n    });\n  }\n  return parsedValue;\n}\n\nfunction _parseAndValidateValue<\n  P extends CLIParam<string>,\n  PValue extends ValueOfParam<P>,\n>(options: {\n  inputValue: string | undefined;\n  defaultValue: PValue | undefined;\n  paramConfig: P;\n}): PValue {\n  const { inputValue, defaultValue, paramConfig } = options;\n  if (inputValue === undefined) {\n    // if there is no input value, we use the default value for validation.\n    // if there is no default value, we throw an error.\n    if (defaultValue === undefined) {\n      if (_isValidFullOptionName(paramConfig.name)) {\n        throw CLIError.missingRequiredOption({\n          optionName: paramConfig.name,\n        });\n      } else {\n        throw CLIError.missingRequiredPositionalArg({\n          positionalArgName: paramConfig.name,\n        });\n      }\n    }\n\n    // and then just validate it. (no need to parse it first)\n    return _validateParsedValue({\n      parsedValue: defaultValue,\n      paramConfig,\n    });\n  }\n\n  const parsedValue =\n    paramConfig.parser ?\n      (paramConfig.parser(inputValue) as PValue)\n      // if no parser was set, we use the default parser\n    : (match(paramConfig.type)\n        .with(\"boolean\", () => {\n          return inputValue === \"false\" ? false : true;\n        })\n        .with(\"number\", () => {\n          return Number.parseInt(inputValue, 10);\n        })\n        .with(\"string\", () => {\n          return inputValue;\n        })\n        .exhaustive(() => {\n          return inputValue;\n        }) as PValue);\n  return _validateParsedValue({\n    parsedValue,\n    paramConfig,\n  });\n}\n\nfunction _replaceAliases<\n  TGlobalOptionArgs extends\n    | Record<CLIFullOptionName, CLIOptionParam>\n    | EmptyObject,\n  TOptionArgs extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject,\n  TPositionalArgs extends\n    | Record<CLIPositionalParamName, CLIOptionParam>\n    | EmptyObject,\n  TCommands extends Record<CLICommandName, AnyCLI> | EmptyObject,\n>({\n  aliasedOptionArgs,\n  cli,\n}: {\n  aliasedOptionArgs: Record<CLIOptionAlias, string>;\n  cli: IAcclimateCLI<\n    TGlobalOptionArgs,\n    TOptionArgs,\n    TPositionalArgs,\n    TCommands\n  >;\n}): Record<CLIOptionAlias, string> {\n  const aliasMap = cli.state.aliases;\n  return Object.entries(aliasedOptionArgs).reduce(\n    (acc, [aliasKey, value]) => {\n      const alias = aliasKey as CLIOptionAlias;\n      const optionName = aliasMap[alias] ?? alias;\n      acc[optionName] = value;\n      return acc;\n    },\n    {} as Record<CLIOptionAlias, string>,\n  );\n}\n\nfunction _runCLIHelper<\n  TPositionalParams extends\n    | Record<CLIPositionalParamName, CLIPositionalParam>\n    | EmptyObject,\n  TOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject,\n  TGlobalOptionParams extends\n    | Record<CLIFullOptionName, CLIOptionParam>\n    | EmptyObject,\n  TCommands extends Record<CLICommandName, AnyCLI> | EmptyObject,\n>(options: {\n  rawPositionalArgs: string[];\n  rawOptionArgs: Record<CLIOptionAlias, string>;\n  rawGlobalOptionArgs: Record<CLIFullOptionName, string>;\n  cli: IAcclimateCLI<\n    TPositionalParams,\n    TOptionParams,\n    TGlobalOptionParams,\n    TCommands\n  >;\n}): void {\n  const { rawGlobalOptionArgs, rawOptionArgs, rawPositionalArgs, cli } = {\n    ...options,\n    rawGlobalOptionArgs: _replaceAliases({\n      aliasedOptionArgs: options.rawGlobalOptionArgs,\n      cli: options.cli,\n    }),\n    rawOptionArgs: _replaceAliases({\n      aliasedOptionArgs: options.rawOptionArgs,\n\n      // TODO(jpsyx): fix that this does not have the CLI may not have all\n      cli: options.cli,\n    }),\n  };\n\n  // is the first argument a command?\n  const firstArg = rawPositionalArgs[0];\n  if (\n    firstArg &&\n    !isEmptyObject(cli.state.commands) &&\n    cli.state.commands[firstArg]\n  ) {\n    // add the parent's global options to the sub-command\n    const commandCLI = Object.values(\n      cli.state.globalOptionArgs as Record<CLIFullOptionName, CLIOptionParam>,\n    ).reduce(\n      (newCmd, argConfig) => {\n        return newCmd.addGlobalOption(argConfig);\n      },\n      cli.getCommandCLI(firstArg as Extract<keyof TCommands, string>) as AnyCLI,\n    );\n\n    // run the sub-command\n    return _runCLIHelper({\n      rawPositionalArgs: rawPositionalArgs.slice(1),\n      rawOptionArgs,\n      rawGlobalOptionArgs,\n      cli: commandCLI,\n    });\n  }\n\n  // build the positional arguments dictionary\n  // first check that we haven't supplied too many positional arguments\n  if (rawPositionalArgs.length > cli.state.positionalArgs.length) {\n    throw CLIError.tooManyPositionalArgs({\n      count: rawPositionalArgs.length,\n    });\n  }\n\n  // parse positional arguments\n  const parsedPositionalArgs = cli.state.positionalArgs.reduce(\n    (acc, argConfig, idx) => {\n      const rawVal = rawPositionalArgs[idx];\n      if (argConfig.required && rawVal === undefined) {\n        throw CLIError.missingRequiredPositionalArg({\n          positionalArgName: argConfig.name,\n        });\n      }\n      acc[argConfig.name] = _parseAndValidateValue({\n        inputValue: rawVal,\n        defaultValue: argConfig.defaultValue,\n        paramConfig: argConfig,\n      });\n      return acc;\n    },\n    {} as Record<string, CLIParamDataType>,\n  );\n\n  // parse the options\n  const parsedOptionArgs = Object.values(\n    cli.state.optionArgs as Record<CLIFullOptionName, CLIOptionParam>,\n  ).reduce(\n    (acc, argConfig) => {\n      const rawVal = rawOptionArgs[argConfig.name];\n      if (argConfig.required && rawVal === undefined) {\n        throw CLIError.missingRequiredOption({\n          optionName: argConfig.name,\n        });\n      }\n\n      acc[camelCase(argConfig.name)] = _parseAndValidateValue({\n        inputValue: rawVal,\n        defaultValue: argConfig.defaultValue,\n        paramConfig: argConfig,\n      });\n      return acc;\n    },\n    {} as Record<string, CLIParamDataType>,\n  );\n\n  // parse the global options\n  const parsedGlobalOptionArgs = Object.values(\n    cli.state.globalOptionArgs as Record<CLIFullOptionName, CLIOptionParam>,\n  ).reduce(\n    (acc, argConfig) => {\n      const rawVal = rawGlobalOptionArgs[argConfig.name];\n      if (argConfig.required && rawVal === undefined) {\n        throw CLIError.missingRequiredOption({\n          optionName: argConfig.name,\n        });\n      }\n      acc[camelCase(argConfig.name)] = _parseAndValidateValue({\n        inputValue: rawVal,\n        defaultValue: argConfig.defaultValue,\n        paramConfig: argConfig,\n      });\n      return acc;\n    },\n    {} as Record<string, CLIParamDataType>,\n  );\n\n  // run the action\n  cli.state.action({\n    ...parsedPositionalArgs,\n    ...parsedOptionArgs,\n    ...parsedGlobalOptionArgs,\n  } as FullCLIArgValues<TPositionalParams, TOptionParams, TGlobalOptionParams>);\n}\n\n/**\n * Run a CLI instance given an array of inputs.\n *\n * @param options - The options for running the CLI.\n */\nexport function runCLI(options: { input: string[]; cli: AnyCLI }): void {\n  const { input, cli } = options;\n  const firstOptionIdx = input.findIndex((token) => {\n    return token.startsWith(\"-\");\n  });\n\n  const [rawPositionalArgs, rest] =\n    firstOptionIdx === -1 ?\n      [input, []]\n    : [input.slice(0, firstOptionIdx), input.slice(firstOptionIdx)];\n\n  const rawOptionArgs: Record<CLIOptionAlias, string> = {};\n  const rawGlobalOptionArgs: Record<CLIFullOptionName, string> = {};\n  let currentAlias: CLIOptionAlias | undefined;\n  let currentVals: string[] = [];\n\n  const { aliases, globalOptionArgs } = cli.state as CLIState<\n    Record<CLIFullOptionName, CLIOptionParam>,\n    Record<CLIFullOptionName, CLIOptionParam>,\n    Record<CLIPositionalParamName, CLIOptionParam>,\n    Record<CLICommandName, AnyCLI>\n  >;\n\n  for (const argVal of rest.concat(\"-\")) {\n    if (_isValidOptionAlias(argVal)) {\n      if (currentAlias) {\n        const rawValue = currentVals.join(\" \");\n        const optionName = aliases[currentAlias] ?? currentAlias;\n        if (\n          _isValidFullOptionName(optionName) &&\n          !isEmptyObject(globalOptionArgs) &&\n          globalOptionArgs[optionName]\n        ) {\n          rawGlobalOptionArgs[optionName] = rawValue;\n        } else {\n          rawOptionArgs[optionName] = rawValue;\n        }\n      }\n      currentAlias = argVal;\n      currentVals = [];\n    } else {\n      currentVals.push(argVal);\n    }\n  }\n\n  _runCLIHelper({ rawPositionalArgs, rawOptionArgs, rawGlobalOptionArgs, cli });\n}\n","import { createCLI } from \"./AcclimateCLI\";\nimport { runCLI } from \"./AcclimateCLI/runCLI/runCLI\";\nimport type { IAcclimateCLI } from \"./AcclimateCLI/AcclimateCLI.types\";\n\ntype Acclimate = {\n  /**\n   * Create a new Acclimate CLI instance.\n   *\n   * @param name - The name of the CLI.\n   * @returns A new CLI instance.\n   */\n  createCLI: (name: string) => IAcclimateCLI;\n\n  /**\n   * Run a CLI instance.\n   *\n   * It can only be run once. Calling any other methods after `.run()` will\n   * throw an error.\n   *\n   * @param cli - The CLI instance to run.\n   */\n  run: (cli: IAcclimateCLI) => void;\n};\n\nexport const Acclimate: Acclimate = {\n  createCLI,\n  run: (cli: IAcclimateCLI) => {\n    runCLI({ cli, input: process.argv.slice(2) });\n  },\n};\n"]}

package/dist/index.d.cts

@@ -0,0 +1,223 @@
+import { EmptyObject, Simplify, CamelCasedProperties } from 'type-fest';
+
+type CLIPositionalParamName = string;
+type CLICommandName = string;
+type CLIFullOptionName = `--${string}`;
+type CLIOptionAlias = `--${string}` | `-${string}`;
+type _DropNonStringKeys<T> = {
+    [K in Extract<keyof T, string>]: T[K];
+};
+type AddEntry<T, K extends string, V> = Simplify<_DropNonStringKeys<T & {
+    [Key in K]: V;
+}>>;
+type _FullCLIParams<TPositionalArgs extends Record<CLIPositionalParamName, CLIPositionalParam>, TOptionArgs extends Record<CLIFullOptionName, CLIOptionParam>, TGlobalOptionArgs extends Record<CLIFullOptionName, CLIOptionParam>> = _DropNonStringKeys<TPositionalArgs & TOptionArgs & TGlobalOptionArgs>;
+type ValueOfParam<T extends CLIParam> = T extends CLIStringParam<string, infer PValue> ? PValue : T extends CLINumberParam<string, infer PValue> ? PValue : T extends CLIBooleanParam<string> ? boolean : never;
+type FullCLIArgValues<TPositionalArgs extends Record<CLIPositionalParamName, CLIPositionalParam>, TOptionArgs extends Record<CLIFullOptionName, CLIOptionParam>, TGlobalOptionArgs extends Record<CLIFullOptionName, CLIOptionParam>> = CamelCasedProperties<{
+    [K in keyof _FullCLIParams<TPositionalArgs, TOptionArgs, TGlobalOptionArgs>]: ValueOfParam<_FullCLIParams<TPositionalArgs, TOptionArgs, TGlobalOptionArgs>[K]>;
+}>;
+type CLIBaseParam<PName extends string> = {
+    /**
+     * The name of the param.
+     */
+    name: PName;
+    /**
+     * The description of the option.
+     */
+    description?: string;
+    /**
+     * Whether to ask the user for a value if the input is empty by entering
+     * into an interactive prompt and waiting for a user's input.
+     *
+     * If `true`, a default message will be presented to the user. Otherwise,
+     * if a `{ message }` object is provided, the custom message will be presented
+     * to the user.
+     */
+    askIfEmpty?: boolean | {
+        message: string;
+    };
+};
+type CLIStringParam<PName extends string, PValue extends string = string> = CLIBaseParam<PName> & {
+    type: "string";
+    choices?: PValue[];
+    /**
+     * The default value of the option.
+     * If `required` is true, the `defaultValue` is ignored, because the user
+     * must always provide a value.
+     */
+    defaultValue?: PValue;
+    /**
+     * A custom validator function to apply on the parsed value.
+     * For example, this is where we might want to check if a value is of the
+     * expected format or if it is within a certain range.
+     *
+     * Returning anything other than `true` will be treated as an error message.
+     *
+     * If `false` then a generic error message will be used. Otherwise, if a
+     * string is returned, then that will be used as the error message.
+     * @default undefined
+     */
+    validator?: (value: PValue) => boolean | string;
+    /**
+     * Parses the raw string input into the expected data type.
+     *
+     * If not provided, the default parser will return the value as is.
+     *
+     * @param value - The value to parse.
+     * @returns The parsed value.
+     */
+    parser?: (value: string) => PValue;
+};
+type CLINumberParam<PName extends string, T extends number = number> = CLIBaseParam<PName> & {
+    type: "number";
+    choices?: T[];
+    /**
+     * The default value of the option.
+     * If `required` is true, the `defaultValue` is ignored, because the user
+     * must always provide a value.
+     */
+    defaultValue?: T;
+    /**
+     * A custom validator function to apply on the parsed value.
+     * For example, this is where we might want to check if a value is of the
+     * expected format or if it is within a certain range.
+     *
+     * Returning anything other than `true` will be treated as an error message.
+     *
+     * If `false` then a generic error message will be used. Otherwise, if a
+     * string is returned, then that will be used as the error message.
+     * @default undefined
+     */
+    validator?: (value: T) => boolean | string;
+    /**
+     * Parses the raw string input into the expected data type.
+     *
+     * If not provided, the default parser will call `Number.parseInt(value, 10)`.
+     *
+     * @param value - The value to parse.
+     * @returns The parsed value.
+     */
+    parser?: (value: string) => T;
+};
+type CLIBooleanParam<PName extends string> = CLIBaseParam<PName> & {
+    type: "boolean";
+    /**
+     * The default value of the option.
+     * If `required` is true, the `defaultValue` is ignored, because the user
+     * must always provide a value.
+     */
+    defaultValue?: boolean;
+    /**
+     * A custom validator function to apply on the parsed value.
+     * For example, this is where we might want to check if a value is of the
+     * expected format or if it is within a certain range.
+     *
+     * Returning anything other than `true` will be treated as an error message.
+     *
+     * If `false` then a generic error message will be used. Otherwise, if a
+     * string is returned, then that will be used as the error message.
+     * @default undefined
+     */
+    validator?: (value: boolean) => boolean | string;
+    /**
+     * Parses the raw string input into the expected data type.
+     *
+     * If not provided, the default parser will treat the string "false" as false
+     * and any other value as true. This means that empty strings are treated
+     * as true, which is what allows booleans to be parsed as flags by default
+     * (without having to explicitly set "true").
+     *
+     * @param value - The value to parse.
+     * @returns The parsed value.
+     */
+    parser?: (value: string) => boolean;
+};
+type CLIParam<PName extends string = string> = CLIStringParam<PName> | CLINumberParam<PName> | CLIBooleanParam<PName>;
+type CLIPositionalParam<PName extends string = string> = CLIParam<PName> & {
+    /**
+     * Whether the parameter is required.
+     *
+     * Positional arguments can only be optional if they are not followed by any
+     * required positional arguments.
+     *
+     * @default true
+     */
+    required: boolean;
+};
+type CLIOptionParam<PName extends CLIFullOptionName = CLIFullOptionName> = CLIParam<PName> & {
+    /**
+     * The aliases of the positional argument.
+     * Aliases must start with `-` or `--` and must be unique within the CLI.
+     */
+    aliases?: readonly CLIOptionAlias[];
+    /**
+     * Whether the parameter is required.
+     * @default false
+     */
+    required: boolean;
+};
+type AnyCLI = IAcclimateCLI<any, any, any, any>;
+type CLIState<TPositionalParams extends Record<CLIPositionalParamName, CLIPositionalParam> | EmptyObject, TOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject, TGlobalOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject, TCommands extends Record<CLICommandName, AnyCLI> | EmptyObject> = {
+    /** The name of the CLI. */
+    name: string;
+    /**
+     * The aliases for options in the CLI. Keys are aliases and values are the
+     * canonical name of the option.
+     */
+    aliases: Record<CLIOptionAlias, Extract<keyof TGlobalOptionParams | keyof TOptionParams, CLIFullOptionName>>;
+    /** The description of the CLI. */
+    description?: string;
+    /** The commands of the CLI. */
+    commands: TCommands;
+    /** The positional arguments of the CLI. */
+    positionalArgs: TPositionalParams extends EmptyObject ? readonly CLIPositionalParam[] : ReadonlyArray<TPositionalParams[keyof TPositionalParams]>;
+    /** The named options of the CLI. */
+    optionArgs: TOptionParams;
+    /** The global options of the CLI. */
+    globalOptionArgs: TGlobalOptionParams;
+    /** The action to run when the CLI is executed. */
+    action: (args: Simplify<FullCLIArgValues<TPositionalParams, TOptionParams, TGlobalOptionParams>>) => void;
+};
+type IAcclimateCLI<TPositionalParams extends Record<CLIPositionalParamName, CLIPositionalParam> | EmptyObject = EmptyObject, TOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject = EmptyObject, TGlobalOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject = EmptyObject, TCommands extends Record<CLICommandName, AnyCLI> | EmptyObject = EmptyObject> = {
+    /** The internal state of the CLI. */
+    state: CLIState<TPositionalParams, TOptionParams, TGlobalOptionParams, TCommands>;
+    /** Set the description of the CLI. */
+    description: (description: string) => IAcclimateCLI<TPositionalParams, TOptionParams, TGlobalOptionParams, TCommands>;
+    action: (action: (args: Simplify<FullCLIArgValues<TPositionalParams, TOptionParams, TGlobalOptionParams>>) => void) => IAcclimateCLI<TPositionalParams, TOptionParams, TGlobalOptionParams, TCommands>;
+    /**
+     * Add a sub-command to the CLI. A command is essentially a nested CLI.
+     *
+     * If the first positional argument is a command, then Acclimate will parse
+     * all subsequent arguments with that command's CLI.
+     */
+    addCommand: <C extends CLICommandName, CommandCLI extends IAcclimateCLI<any, any, any, any>>(commandName: C, cli: CommandCLI) => IAcclimateCLI<TPositionalParams, TOptionParams, TGlobalOptionParams, AddEntry<TCommands, C, CommandCLI>>;
+    /** Add a positional argument to the CLI. */
+    addPositionalArg: <PName extends CLIPositionalParamName, P extends CLIPositionalParam<PName>>(param: P) => IAcclimateCLI<AddEntry<TPositionalParams, P["name"], P>, TOptionParams, TGlobalOptionParams, TCommands>;
+    /** Add a global option to the CLI that is available to all commands. */
+    addGlobalOption: <const P extends CLIOptionParam>(param: P) => IAcclimateCLI<TPositionalParams, TOptionParams, AddEntry<TGlobalOptionParams, P["name"], P>, TCommands>;
+    /** Add a named option to the CLI. */
+    addOption: <P extends CLIOptionParam>(param: P) => IAcclimateCLI<TPositionalParams, AddEntry<TOptionParams, P["name"], P>, TGlobalOptionParams, TCommands>;
+    /** Get a command's CLI by name. */
+    getCommandCLI: <C extends Extract<keyof TCommands, CLICommandName>>(commandName: C) => C extends keyof TCommands ? TCommands[C] : never;
+};
+
+type Acclimate = {
+    /**
+     * Create a new Acclimate CLI instance.
+     *
+     * @param name - The name of the CLI.
+     * @returns A new CLI instance.
+     */
+    createCLI: (name: string) => IAcclimateCLI;
+    /**
+     * Run a CLI instance.
+     *
+     * It can only be run once. Calling any other methods after `.run()` will
+     * throw an error.
+     *
+     * @param cli - The CLI instance to run.
+     */
+    run: (cli: IAcclimateCLI) => void;
+};
+declare const Acclimate: Acclimate;
+
+export { Acclimate };

package/dist/index.d.ts

@@ -0,0 +1,223 @@
+import { EmptyObject, Simplify, CamelCasedProperties } from 'type-fest';
+
+type CLIPositionalParamName = string;
+type CLICommandName = string;
+type CLIFullOptionName = `--${string}`;
+type CLIOptionAlias = `--${string}` | `-${string}`;
+type _DropNonStringKeys<T> = {
+    [K in Extract<keyof T, string>]: T[K];
+};
+type AddEntry<T, K extends string, V> = Simplify<_DropNonStringKeys<T & {
+    [Key in K]: V;
+}>>;
+type _FullCLIParams<TPositionalArgs extends Record<CLIPositionalParamName, CLIPositionalParam>, TOptionArgs extends Record<CLIFullOptionName, CLIOptionParam>, TGlobalOptionArgs extends Record<CLIFullOptionName, CLIOptionParam>> = _DropNonStringKeys<TPositionalArgs & TOptionArgs & TGlobalOptionArgs>;
+type ValueOfParam<T extends CLIParam> = T extends CLIStringParam<string, infer PValue> ? PValue : T extends CLINumberParam<string, infer PValue> ? PValue : T extends CLIBooleanParam<string> ? boolean : never;
+type FullCLIArgValues<TPositionalArgs extends Record<CLIPositionalParamName, CLIPositionalParam>, TOptionArgs extends Record<CLIFullOptionName, CLIOptionParam>, TGlobalOptionArgs extends Record<CLIFullOptionName, CLIOptionParam>> = CamelCasedProperties<{
+    [K in keyof _FullCLIParams<TPositionalArgs, TOptionArgs, TGlobalOptionArgs>]: ValueOfParam<_FullCLIParams<TPositionalArgs, TOptionArgs, TGlobalOptionArgs>[K]>;
+}>;
+type CLIBaseParam<PName extends string> = {
+    /**
+     * The name of the param.
+     */
+    name: PName;
+    /**
+     * The description of the option.
+     */
+    description?: string;
+    /**
+     * Whether to ask the user for a value if the input is empty by entering
+     * into an interactive prompt and waiting for a user's input.
+     *
+     * If `true`, a default message will be presented to the user. Otherwise,
+     * if a `{ message }` object is provided, the custom message will be presented
+     * to the user.
+     */
+    askIfEmpty?: boolean | {
+        message: string;
+    };
+};
+type CLIStringParam<PName extends string, PValue extends string = string> = CLIBaseParam<PName> & {
+    type: "string";
+    choices?: PValue[];
+    /**
+     * The default value of the option.
+     * If `required` is true, the `defaultValue` is ignored, because the user
+     * must always provide a value.
+     */
+    defaultValue?: PValue;
+    /**
+     * A custom validator function to apply on the parsed value.
+     * For example, this is where we might want to check if a value is of the
+     * expected format or if it is within a certain range.
+     *
+     * Returning anything other than `true` will be treated as an error message.
+     *
+     * If `false` then a generic error message will be used. Otherwise, if a
+     * string is returned, then that will be used as the error message.
+     * @default undefined
+     */
+    validator?: (value: PValue) => boolean | string;
+    /**
+     * Parses the raw string input into the expected data type.
+     *
+     * If not provided, the default parser will return the value as is.
+     *
+     * @param value - The value to parse.
+     * @returns The parsed value.
+     */
+    parser?: (value: string) => PValue;
+};
+type CLINumberParam<PName extends string, T extends number = number> = CLIBaseParam<PName> & {
+    type: "number";
+    choices?: T[];
+    /**
+     * The default value of the option.
+     * If `required` is true, the `defaultValue` is ignored, because the user
+     * must always provide a value.
+     */
+    defaultValue?: T;
+    /**
+     * A custom validator function to apply on the parsed value.
+     * For example, this is where we might want to check if a value is of the
+     * expected format or if it is within a certain range.
+     *
+     * Returning anything other than `true` will be treated as an error message.
+     *
+     * If `false` then a generic error message will be used. Otherwise, if a
+     * string is returned, then that will be used as the error message.
+     * @default undefined
+     */
+    validator?: (value: T) => boolean | string;
+    /**
+     * Parses the raw string input into the expected data type.
+     *
+     * If not provided, the default parser will call `Number.parseInt(value, 10)`.
+     *
+     * @param value - The value to parse.
+     * @returns The parsed value.
+     */
+    parser?: (value: string) => T;
+};
+type CLIBooleanParam<PName extends string> = CLIBaseParam<PName> & {
+    type: "boolean";
+    /**
+     * The default value of the option.
+     * If `required` is true, the `defaultValue` is ignored, because the user
+     * must always provide a value.
+     */
+    defaultValue?: boolean;
+    /**
+     * A custom validator function to apply on the parsed value.
+     * For example, this is where we might want to check if a value is of the
+     * expected format or if it is within a certain range.
+     *
+     * Returning anything other than `true` will be treated as an error message.
+     *
+     * If `false` then a generic error message will be used. Otherwise, if a
+     * string is returned, then that will be used as the error message.
+     * @default undefined
+     */
+    validator?: (value: boolean) => boolean | string;
+    /**
+     * Parses the raw string input into the expected data type.
+     *
+     * If not provided, the default parser will treat the string "false" as false
+     * and any other value as true. This means that empty strings are treated
+     * as true, which is what allows booleans to be parsed as flags by default
+     * (without having to explicitly set "true").
+     *
+     * @param value - The value to parse.
+     * @returns The parsed value.
+     */
+    parser?: (value: string) => boolean;
+};
+type CLIParam<PName extends string = string> = CLIStringParam<PName> | CLINumberParam<PName> | CLIBooleanParam<PName>;
+type CLIPositionalParam<PName extends string = string> = CLIParam<PName> & {
+    /**
+     * Whether the parameter is required.
+     *
+     * Positional arguments can only be optional if they are not followed by any
+     * required positional arguments.
+     *
+     * @default true
+     */
+    required: boolean;
+};
+type CLIOptionParam<PName extends CLIFullOptionName = CLIFullOptionName> = CLIParam<PName> & {
+    /**
+     * The aliases of the positional argument.
+     * Aliases must start with `-` or `--` and must be unique within the CLI.
+     */
+    aliases?: readonly CLIOptionAlias[];
+    /**
+     * Whether the parameter is required.
+     * @default false
+     */
+    required: boolean;
+};
+type AnyCLI = IAcclimateCLI<any, any, any, any>;
+type CLIState<TPositionalParams extends Record<CLIPositionalParamName, CLIPositionalParam> | EmptyObject, TOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject, TGlobalOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject, TCommands extends Record<CLICommandName, AnyCLI> | EmptyObject> = {
+    /** The name of the CLI. */
+    name: string;
+    /**
+     * The aliases for options in the CLI. Keys are aliases and values are the
+     * canonical name of the option.
+     */
+    aliases: Record<CLIOptionAlias, Extract<keyof TGlobalOptionParams | keyof TOptionParams, CLIFullOptionName>>;
+    /** The description of the CLI. */
+    description?: string;
+    /** The commands of the CLI. */
+    commands: TCommands;
+    /** The positional arguments of the CLI. */
+    positionalArgs: TPositionalParams extends EmptyObject ? readonly CLIPositionalParam[] : ReadonlyArray<TPositionalParams[keyof TPositionalParams]>;
+    /** The named options of the CLI. */
+    optionArgs: TOptionParams;
+    /** The global options of the CLI. */
+    globalOptionArgs: TGlobalOptionParams;
+    /** The action to run when the CLI is executed. */
+    action: (args: Simplify<FullCLIArgValues<TPositionalParams, TOptionParams, TGlobalOptionParams>>) => void;
+};
+type IAcclimateCLI<TPositionalParams extends Record<CLIPositionalParamName, CLIPositionalParam> | EmptyObject = EmptyObject, TOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject = EmptyObject, TGlobalOptionParams extends Record<CLIFullOptionName, CLIOptionParam> | EmptyObject = EmptyObject, TCommands extends Record<CLICommandName, AnyCLI> | EmptyObject = EmptyObject> = {
+    /** The internal state of the CLI. */
+    state: CLIState<TPositionalParams, TOptionParams, TGlobalOptionParams, TCommands>;
+    /** Set the description of the CLI. */
+    description: (description: string) => IAcclimateCLI<TPositionalParams, TOptionParams, TGlobalOptionParams, TCommands>;
+    action: (action: (args: Simplify<FullCLIArgValues<TPositionalParams, TOptionParams, TGlobalOptionParams>>) => void) => IAcclimateCLI<TPositionalParams, TOptionParams, TGlobalOptionParams, TCommands>;
+    /**
+     * Add a sub-command to the CLI. A command is essentially a nested CLI.
+     *
+     * If the first positional argument is a command, then Acclimate will parse
+     * all subsequent arguments with that command's CLI.
+     */
+    addCommand: <C extends CLICommandName, CommandCLI extends IAcclimateCLI<any, any, any, any>>(commandName: C, cli: CommandCLI) => IAcclimateCLI<TPositionalParams, TOptionParams, TGlobalOptionParams, AddEntry<TCommands, C, CommandCLI>>;
+    /** Add a positional argument to the CLI. */
+    addPositionalArg: <PName extends CLIPositionalParamName, P extends CLIPositionalParam<PName>>(param: P) => IAcclimateCLI<AddEntry<TPositionalParams, P["name"], P>, TOptionParams, TGlobalOptionParams, TCommands>;
+    /** Add a global option to the CLI that is available to all commands. */
+    addGlobalOption: <const P extends CLIOptionParam>(param: P) => IAcclimateCLI<TPositionalParams, TOptionParams, AddEntry<TGlobalOptionParams, P["name"], P>, TCommands>;
+    /** Add a named option to the CLI. */
+    addOption: <P extends CLIOptionParam>(param: P) => IAcclimateCLI<TPositionalParams, AddEntry<TOptionParams, P["name"], P>, TGlobalOptionParams, TCommands>;
+    /** Get a command's CLI by name. */
+    getCommandCLI: <C extends Extract<keyof TCommands, CLICommandName>>(commandName: C) => C extends keyof TCommands ? TCommands[C] : never;
+};
+
+type Acclimate = {
+    /**
+     * Create a new Acclimate CLI instance.
+     *
+     * @param name - The name of the CLI.
+     * @returns A new CLI instance.
+     */
+    createCLI: (name: string) => IAcclimateCLI;
+    /**
+     * Run a CLI instance.
+     *
+     * It can only be run once. Calling any other methods after `.run()` will
+     * throw an error.
+     *
+     * @param cli - The CLI instance to run.
+     */
+    run: (cli: IAcclimateCLI) => void;
+};
+declare const Acclimate: Acclimate;
+
+export { Acclimate };