@avandar/acclimate 0.1.0

package/dist/index.js

@@ -0,0 +1,379 @@
+import { camelCase } from 'change-case';
+import { match } from 'ts-pattern';
+
+// src/CLIError.ts
+var CLIError = class _CLIError extends Error {
+  static invalidCLIParamValue(options) {
+    return new _CLIError({
+      message: options.message ?? `Invalid value for CLI param "${options.paramName}"`,
+      code: "invalid_cli_param_value",
+      details: { paramName: options.paramName, paramValue: options.paramValue }
+    });
+  }
+  static missingRequiredOption(options) {
+    return new _CLIError({
+      message: options.message ?? `Required option "${options.optionName}" is missing`,
+      code: "missing_required_option",
+      details: { optionName: options.optionName }
+    });
+  }
+  static missingRequiredPositionalArg(options) {
+    return new _CLIError({
+      message: options.message ?? `Required positional argument "${options.positionalArgName}" is missing`,
+      code: "missing_required_positional_arg",
+      details: { positionalArgName: options.positionalArgName }
+    });
+  }
+  static unknownOption(options) {
+    return new _CLIError({
+      message: options.message ?? `Option "${options.optionName}" not found`,
+      code: "unknown_option",
+      details: { optionName: options.optionName }
+    });
+  }
+  static tooManyPositionalArgs(options) {
+    return new _CLIError({
+      message: options.message ?? "Too many positional arguments provided.",
+      code: "too_many_positional_args",
+      details: { count: options.count }
+    });
+  }
+  static invalidPositionalArgConfig(options) {
+    return new _CLIError({
+      message: options.message ?? `Positional argument configuration for "${options.positionalArgName}" is invalid`,
+      code: "invalid_positional_arg_config",
+      details: { positionalArgName: options.positionalArgName }
+    });
+  }
+  static unknownCommand(options) {
+    return new _CLIError({
+      message: options.message ?? `Command "${options.commandName}" not found`,
+      code: "unknown_command",
+      details: { commandName: options.commandName }
+    });
+  }
+  static alreadyRun(options = {}) {
+    return new _CLIError({
+      message: options.message ?? "CLI has already been run",
+      code: "already_run",
+      details: void 0
+    });
+  }
+  constructor(options) {
+    super(`\u274C ${options.message}`);
+  }
+};
+
+// src/AcclimateCLI/AcclimateCLI.ts
+function AcclimateCLI(state) {
+  return {
+    state,
+    action: (action) => {
+      return AcclimateCLI({
+        ...state,
+        action
+      });
+    },
+    description: (description) => {
+      return AcclimateCLI({
+        ...state,
+        description
+      });
+    },
+    addPositionalArg: (param) => {
+      if (param.required && state.positionalArgs.some((p) => {
+        return !p.required;
+      })) {
+        throw CLIError.invalidPositionalArgConfig({
+          positionalArgName: param.name,
+          message: "Required positional arguments must be before optional positional arguments"
+        });
+      }
+      return AcclimateCLI({
+        ...state,
+        positionalArgs: [
+          ...state.positionalArgs,
+          { ...param, required: param.required ?? true }
+        ]
+      });
+    },
+    addGlobalOption: (param) => {
+      const newAliases = (param.aliases ?? []).reduce(
+        (acc, alias) => {
+          acc[alias] = param.name;
+          return acc;
+        },
+        {}
+      );
+      return AcclimateCLI({
+        ...state,
+        aliases: { ...state.aliases, ...newAliases },
+        globalOptionArgs: {
+          ...state.globalOptionArgs,
+          [param.name]: param
+        }
+      });
+    },
+    addOption: (param) => {
+      const newAliases = (param.aliases ?? []).reduce(
+        (acc, alias) => {
+          acc[alias] = param.name;
+          return acc;
+        },
+        {}
+      );
+      return AcclimateCLI({
+        ...state,
+        aliases: { ...state.aliases, ...newAliases },
+        optionArgs: { ...state.optionArgs, [param.name]: param }
+      });
+    },
+    addCommand: (commandName, cli) => {
+      return AcclimateCLI({
+        ...state,
+        commands: {
+          ...state.commands,
+          [commandName]: cli
+        }
+      });
+    },
+    getCommandCLI: (commandName) => {
+      const cmd = state.commands[commandName];
+      if (!cmd) {
+        throw CLIError.unknownCommand({
+          commandName,
+          message: `Command "${commandName}" not found`
+        });
+      }
+      return cmd;
+    }
+  };
+}
+
+// src/AcclimateCLI/createCLI/defaultCLIState.ts
+var defaultCLIState = {
+  aliases: {},
+  description: void 0,
+  commands: {},
+  positionalArgs: [],
+  optionArgs: {},
+  globalOptionArgs: {},
+  action: () => {
+  }
+};
+
+// src/AcclimateCLI/createCLI/createCLI.ts
+function createCLI(name) {
+  return AcclimateCLI({ ...defaultCLIState, name });
+}
+function _isValidFullOptionName(name) {
+  return name.startsWith("--");
+}
+function _isValidOptionAlias(name) {
+  return name.startsWith("-");
+}
+function isEmptyObject(obj) {
+  return Object.keys(obj).length === 0;
+}
+function _validateParsedValue(options) {
+  const { parsedValue, paramConfig } = options;
+  if (paramConfig.validator) {
+    const validator = paramConfig.validator;
+    const validationResult = validator(parsedValue);
+    if (validationResult === true) {
+      return parsedValue;
+    }
+    throw CLIError.invalidCLIParamValue({
+      paramName: paramConfig.name,
+      paramValue: parsedValue,
+      message: typeof validationResult === "string" ? validationResult : void 0
+    });
+  }
+  return parsedValue;
+}
+function _parseAndValidateValue(options) {
+  const { inputValue, defaultValue, paramConfig } = options;
+  if (inputValue === void 0) {
+    if (defaultValue === void 0) {
+      if (_isValidFullOptionName(paramConfig.name)) {
+        throw CLIError.missingRequiredOption({
+          optionName: paramConfig.name
+        });
+      } else {
+        throw CLIError.missingRequiredPositionalArg({
+          positionalArgName: paramConfig.name
+        });
+      }
+    }
+    return _validateParsedValue({
+      parsedValue: defaultValue,
+      paramConfig
+    });
+  }
+  const parsedValue = paramConfig.parser ? paramConfig.parser(inputValue) : match(paramConfig.type).with("boolean", () => {
+    return inputValue === "false" ? false : true;
+  }).with("number", () => {
+    return Number.parseInt(inputValue, 10);
+  }).with("string", () => {
+    return inputValue;
+  }).exhaustive(() => {
+    return inputValue;
+  });
+  return _validateParsedValue({
+    parsedValue,
+    paramConfig
+  });
+}
+function _replaceAliases({
+  aliasedOptionArgs,
+  cli
+}) {
+  const aliasMap = cli.state.aliases;
+  return Object.entries(aliasedOptionArgs).reduce(
+    (acc, [aliasKey, value]) => {
+      const alias = aliasKey;
+      const optionName = aliasMap[alias] ?? alias;
+      acc[optionName] = value;
+      return acc;
+    },
+    {}
+  );
+}
+function _runCLIHelper(options) {
+  const { rawGlobalOptionArgs, rawOptionArgs, rawPositionalArgs, cli } = {
+    ...options,
+    rawGlobalOptionArgs: _replaceAliases({
+      aliasedOptionArgs: options.rawGlobalOptionArgs,
+      cli: options.cli
+    }),
+    rawOptionArgs: _replaceAliases({
+      aliasedOptionArgs: options.rawOptionArgs,
+      // TODO(jpsyx): fix that this does not have the CLI may not have all
+      cli: options.cli
+    })
+  };
+  const firstArg = rawPositionalArgs[0];
+  if (firstArg && !isEmptyObject(cli.state.commands) && cli.state.commands[firstArg]) {
+    const commandCLI = Object.values(
+      cli.state.globalOptionArgs
+    ).reduce(
+      (newCmd, argConfig) => {
+        return newCmd.addGlobalOption(argConfig);
+      },
+      cli.getCommandCLI(firstArg)
+    );
+    return _runCLIHelper({
+      rawPositionalArgs: rawPositionalArgs.slice(1),
+      rawOptionArgs,
+      rawGlobalOptionArgs,
+      cli: commandCLI
+    });
+  }
+  if (rawPositionalArgs.length > cli.state.positionalArgs.length) {
+    throw CLIError.tooManyPositionalArgs({
+      count: rawPositionalArgs.length
+    });
+  }
+  const parsedPositionalArgs = cli.state.positionalArgs.reduce(
+    (acc, argConfig, idx) => {
+      const rawVal = rawPositionalArgs[idx];
+      if (argConfig.required && rawVal === void 0) {
+        throw CLIError.missingRequiredPositionalArg({
+          positionalArgName: argConfig.name
+        });
+      }
+      acc[argConfig.name] = _parseAndValidateValue({
+        inputValue: rawVal,
+        defaultValue: argConfig.defaultValue,
+        paramConfig: argConfig
+      });
+      return acc;
+    },
+    {}
+  );
+  const parsedOptionArgs = Object.values(
+    cli.state.optionArgs
+  ).reduce(
+    (acc, argConfig) => {
+      const rawVal = rawOptionArgs[argConfig.name];
+      if (argConfig.required && rawVal === void 0) {
+        throw CLIError.missingRequiredOption({
+          optionName: argConfig.name
+        });
+      }
+      acc[camelCase(argConfig.name)] = _parseAndValidateValue({
+        inputValue: rawVal,
+        defaultValue: argConfig.defaultValue,
+        paramConfig: argConfig
+      });
+      return acc;
+    },
+    {}
+  );
+  const parsedGlobalOptionArgs = Object.values(
+    cli.state.globalOptionArgs
+  ).reduce(
+    (acc, argConfig) => {
+      const rawVal = rawGlobalOptionArgs[argConfig.name];
+      if (argConfig.required && rawVal === void 0) {
+        throw CLIError.missingRequiredOption({
+          optionName: argConfig.name
+        });
+      }
+      acc[camelCase(argConfig.name)] = _parseAndValidateValue({
+        inputValue: rawVal,
+        defaultValue: argConfig.defaultValue,
+        paramConfig: argConfig
+      });
+      return acc;
+    },
+    {}
+  );
+  cli.state.action({
+    ...parsedPositionalArgs,
+    ...parsedOptionArgs,
+    ...parsedGlobalOptionArgs
+  });
+}
+function runCLI(options) {
+  const { input, cli } = options;
+  const firstOptionIdx = input.findIndex((token) => {
+    return token.startsWith("-");
+  });
+  const [rawPositionalArgs, rest] = firstOptionIdx === -1 ? [input, []] : [input.slice(0, firstOptionIdx), input.slice(firstOptionIdx)];
+  const rawOptionArgs = {};
+  const rawGlobalOptionArgs = {};
+  let currentAlias;
+  let currentVals = [];
+  const { aliases, globalOptionArgs } = cli.state;
+  for (const argVal of rest.concat("-")) {
+    if (_isValidOptionAlias(argVal)) {
+      if (currentAlias) {
+        const rawValue = currentVals.join(" ");
+        const optionName = aliases[currentAlias] ?? currentAlias;
+        if (_isValidFullOptionName(optionName) && !isEmptyObject(globalOptionArgs) && globalOptionArgs[optionName]) {
+          rawGlobalOptionArgs[optionName] = rawValue;
+        } else {
+          rawOptionArgs[optionName] = rawValue;
+        }
+      }
+      currentAlias = argVal;
+      currentVals = [];
+    } else {
+      currentVals.push(argVal);
+    }
+  }
+  _runCLIHelper({ rawPositionalArgs, rawOptionArgs, rawGlobalOptionArgs, cli });
+}
+
+// src/Acclimate.ts
+var Acclimate = {
+  createCLI,
+  run: (cli) => {
+    runCLI({ cli, input: process.argv.slice(2) });
+  }
+};
+
+export { Acclimate };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.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":[],"mappings":"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","file":"index.js","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/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@avandar/acclimate",
+  "version": "0.1.0",
+  "description": "A lightweight TypeScript framework for building CLI tools.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier . --write",
+    "format:fix": "prettier . --write",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "demo": "tsx examples/basic.ts",
+    "prepare": "npm run build",
+    "type": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "cli",
+    "framework",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "dependencies": {
+    "change-case": "^5.4.4",
+    "ts-pattern": "^5.9.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.0",
+    "@types/node": "^22.19.2",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import-x": "^4.16.1",
+    "eslint-plugin-unused-imports": "^4.3.0",
+    "prettier": "^3.7.4",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "type-fest": "^5.3.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0",
+    "vitest": "^2.1.9"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}