convoker 0.3.3 → 0.4.0

package/dist/command-8P8qXJ2o.mjs

@@ -0,0 +1,486 @@
+import { O as gray, w as cyan, x as bold } from "./color-DiZvJ0Fc.mjs";
+import { c as setTheme } from "./prompt-a5Ix_Hyc.mjs";
+import { i as convert, n as Positional, t as Option } from "./input-XUsy1LCQ.mjs";
+import process from "node:process";
+
+//#region src/command/error.ts
+/**
+* A Convoker-related error. These are usually handled by default.
+*/
+var ConvokerError = class extends Error {
+	/**
+	* Creates a new Convoker error.
+	* @param message The message.
+	* @param command The command.
+	*/
+	constructor(message, command) {
+		super(message);
+		this.command = command;
+	}
+	/**
+	* Prints the error's message.
+	*/
+	print() {
+		console.error(this.message);
+	}
+};
+/**
+* When the user asks for help.
+*/
+var HelpAskedError = class extends ConvokerError {
+	/**
+	* Creates a new help asked error.
+	* @param command The command.
+	*/
+	constructor(command) {
+		super("user asked for help!", command);
+	}
+};
+/**
+* When you pass too many arguments.
+*/
+var TooManyArgumentsError = class extends ConvokerError {
+	/**
+	* Creates a new too many arguments error.
+	* @param command The command.
+	*/
+	constructor(command) {
+		super("too many arguments!", command);
+	}
+};
+/**
+* When you pass an unknown option, when unknown options aren't allowed.
+*/
+var UnknownOptionError = class extends ConvokerError {
+	/**
+	* Creates a new unknown option error.
+	* @param command The command.
+	* @param key The key.
+	*/
+	constructor(command, key) {
+		super(`unknown option: ${key}!`, command);
+		this.key = key;
+	}
+};
+/**
+* When a required option is missing.
+*/
+var MissingRequiredOptionError = class extends ConvokerError {
+	/**
+	* Creates a new missing required option error.
+	* @param command The command.
+	* @param key The key.
+	* @param entry The entry.
+	*/
+	constructor(command, key, entry) {
+		super(`missing required option: ${key}!`, command);
+		this.key = key;
+		this.entry = entry;
+	}
+};
+var MissingRequiredArgumentError = class extends ConvokerError {
+	/**
+	* Creates a new missing required argument error.
+	* @param command The command.
+	* @param key The key.
+	* @param entry The entry.
+	*/
+	constructor(command, key, entry) {
+		super(`missing required positional argument: ${key}!`, command);
+		this.key = key;
+		this.entry = entry;
+	}
+};
+
+//#endregion
+//#region src/command/index.ts
+/**
+* A command.
+*/
+var Command = class Command {
+	/**
+	* Creates a new command.
+	* @param names The names (aliases).
+	* @param desc The description.
+	* @param version The version.
+	*/
+	constructor(names, desc, version) {
+		this.$children = /* @__PURE__ */ new Map();
+		this.$allowUnknownOptions = false;
+		this.$allowSurpassArgLimit = false;
+		this.$input = {};
+		this.$fn = void 0;
+		this.$middlewares = [];
+		this.$errorFn = void 0;
+		this.$names = Array.isArray(names) ? names : [names];
+		this.$description = desc;
+		this.$version = version;
+	}
+	/**
+	* Adds a set of aliases to this command.
+	* @param aliases The aliases to add.
+	* @returns this
+	*/
+	alias(...aliases) {
+		this.$names.push(...aliases);
+		this.$parent?.add(this);
+		return this;
+	}
+	/**
+	* Adds a description to this command.
+	* @param desc The description.
+	* @returns this
+	*/
+	description(desc) {
+		this.$description = desc;
+		return this;
+	}
+	/**
+	* Adds a version to this command.
+	* @param version The version.
+	* @returns this
+	*/
+	version(version) {
+		this.$version = version;
+		return this;
+	}
+	/**
+	* Sets the input for this command.
+	* @param version The input.
+	* @returns this
+	*/
+	input(input) {
+		this.$input = input;
+		return this;
+	}
+	/**
+	* Adds a chain of middlewares.
+	* @param fns The middlewares to use.
+	* @returns this
+	*/
+	use(...fns) {
+		this.$middlewares.push(...fns);
+		return this;
+	}
+	/**
+	* Sets the action function for this command.
+	* @param fn The action.
+	* @returns this
+	*/
+	action(fn) {
+		this.$fn = fn;
+		return this;
+	}
+	/**
+	* Sets the error function for this command.
+	* @param fn The error handler.
+	* @returns this
+	*/
+	error(fn) {
+		this.$errorFn = fn;
+		return this;
+	}
+	/**
+	* Adds existing commands to this.
+	* @param commands The commands.
+	* @returns this
+	*/
+	add(...commands) {
+		for (const command of commands) {
+			command.$parent = this;
+			const alias = {
+				command,
+				alias: command.$names[0]
+			};
+			for (let i = 0; i < command.$names.length; i++) {
+				if (i === 0) this.$children.set(command.$names[i], { command });
+				this.$children.set(command.$names[i], alias);
+			}
+		}
+		return this;
+	}
+	subCommand(names, descOrBuilder, version) {
+		if (typeof descOrBuilder === "function") {
+			const command$1 = new Command(names);
+			descOrBuilder(command$1);
+			this.add(command$1);
+			return this;
+		}
+		const command = new Command(names, descOrBuilder, version);
+		this.add(command);
+		return command;
+	}
+	/**
+	* Allows unknown options.
+	* @returns this
+	*/
+	allowUnknownOptions() {
+		this.$allowUnknownOptions = true;
+		return this;
+	}
+	/**
+	* Parses a set of command-line arguments.
+	* @param argv The arguments to parse.
+	* @returns A parse result.
+	*/
+	async parse(argv) {
+		let command = this;
+		let found = false;
+		const input = {};
+		const args = [];
+		const opts = {};
+		const errors = [];
+		const map = command.buildInputMap();
+		function getOption(key, isSpecial) {
+			const entry = map.get(key);
+			if (!entry) {
+				if (!command.$allowUnknownOptions && !isSpecial) errors.push(new UnknownOptionError(command, key));
+				return null;
+			}
+			return entry.value;
+		}
+		function setOption(key, option, value) {
+			if (option.$kind === "boolean") opts[key] = "true";
+			else if (value !== void 0) opts[key] = value;
+		}
+		let isVersion = false;
+		let isHelp = false;
+		for (let i = 0; i < argv.length; i++) {
+			const arg = argv[i];
+			if (arg.startsWith("--")) {
+				const [key, value] = arg.slice(2).split("=");
+				let isSpecial = false;
+				if (key === "help") {
+					isHelp = true;
+					isSpecial = true;
+				} else if (key === "version") {
+					isVersion = true;
+					isSpecial = true;
+				}
+				const option = getOption(key, isSpecial);
+				if (option) if (value === void 0) setOption(key, option, option.$kind === "boolean" ? void 0 : argv[++i]);
+				else setOption(key, option, value);
+			} else if (arg.startsWith("-")) {
+				const [shortKeys, value] = arg.slice(1).split("=");
+				const chars = shortKeys.split("");
+				let usedValue = value;
+				for (const char of chars) {
+					let isSpecial = false;
+					if (char === "h") {
+						isHelp = true;
+						isSpecial = true;
+					} else if (char === "V") {
+						isVersion = true;
+						isSpecial = true;
+					}
+					const option = getOption(char, isSpecial);
+					if (!option) continue;
+					if (option.$kind !== "boolean" && usedValue === void 0) usedValue = argv[++i];
+					setOption(char, option, usedValue);
+					usedValue = void 0;
+				}
+			} else if (command.$children.has(arg) && !found) {
+				command = command.$children.get(arg).command;
+				if (command.$theme) setTheme(command.$theme);
+			} else {
+				found = true;
+				args.push(arg);
+			}
+		}
+		let index = 0;
+		for (const key in command.$input) {
+			const entry = command.$input[key];
+			let rawValue;
+			if (entry instanceof Positional) if (entry.$list) {
+				rawValue = args.slice(index);
+				index = args.length;
+				if (!command.$allowSurpassArgLimit && rawValue.length === 0 && entry.$required) errors.push(new MissingRequiredArgumentError(command, key, entry));
+			} else {
+				rawValue = args[index++];
+				if (rawValue === void 0 && entry.$required) errors.push(new MissingRequiredArgumentError(command, key, entry));
+			}
+			else for (const name of entry.$names) if (opts[name] !== void 0) {
+				rawValue = entry.$list ? opts[name].split(entry.$separator ?? ",") : opts[name];
+				break;
+			}
+			if (rawValue !== void 0) input[key] = await convert(entry.$kind, rawValue);
+			else if (entry.$default !== void 0) input[key] = entry.$default;
+			else if (entry.$required) if (entry instanceof Option) errors.push(new MissingRequiredOptionError(command, key, entry));
+			else errors.push(new MissingRequiredArgumentError(command, key, entry));
+		}
+		const remainingArgs = args.slice(index);
+		if (!command.$allowSurpassArgLimit && remainingArgs.length > 0) errors.push(new TooManyArgumentsError(command));
+		return {
+			input,
+			command,
+			errors,
+			isVersion,
+			isHelp
+		};
+	}
+	buildInputMap(ignoreParentMap) {
+		const map = /* @__PURE__ */ new Map();
+		let i = 0;
+		for (const key in this.$input) {
+			const value = this.$input[key];
+			if (value instanceof Positional) map.set(i++, {
+				value,
+				key
+			});
+			else for (const name of value.$names) map.set(name, {
+				value,
+				key
+			});
+		}
+		if (!ignoreParentMap) for (const [key, entry] of this.$parent?.buildInputMap() ?? []) map.set(key, entry);
+		for (const [, { command }] of this.$children) for (const [key, entry] of command.buildInputMap(true)) map.set(key, entry);
+		return map;
+	}
+	/**
+	* Allows surpassing the amount of arguments specified.
+	* @returns this
+	*/
+	allowSurpassArgLimit() {
+		this.$allowSurpassArgLimit = true;
+		return this;
+	}
+	/**
+	* Gets the full command path (name including parents).
+	* @returns The full command path.
+	*/
+	fullCommandPath() {
+		const names = [];
+		let cmd = this;
+		while (cmd) {
+			names.unshift(cmd.$names[0]);
+			cmd = cmd.$parent;
+		}
+		return names.join(" ");
+	}
+	/**
+	* The default error screen.
+	* @param errors The errors.
+	*/
+	defaultErrorScreen(errors) {
+		let printHelpScreen = false;
+		const nonCliErrors = [];
+		for (const error of errors) if (error instanceof ConvokerError) {
+			if (!(error instanceof HelpAskedError)) error.print();
+			printHelpScreen = true;
+		} else nonCliErrors.push(error);
+		if (nonCliErrors.length) throw nonCliErrors[0];
+		if (!printHelpScreen) return;
+		const pad = (s, len) => s.padEnd(len, " ");
+		console.log(`${bold("usage:")} ${cyan(this.fullCommandPath())} ${gray("[options] [arguments]")}`);
+		if (this.$description) console.log(`${this.$description}`);
+		if (this.$version) console.log(`${bold("version")} ${this.$version}`);
+		const opts = Object.entries(this.$input).filter(([, entry]) => entry instanceof Option).map(([key, entry]) => ({
+			key,
+			entry
+		}));
+		if (opts.length > 0) {
+			console.log(bold("options:"));
+			const longest = Math.max(...opts.map(({ entry }) => entry.$names.join(", ").length));
+			for (const { entry } of opts) {
+				const line = `  ${cyan(pad(entry.$names.map((n) => n.length === 1 ? `-${n}` : `--${n}`).join(", "), longest + 4))}${gray(entry.$description ?? "")}`;
+				console.log(line);
+			}
+		}
+		const positionals = Object.entries(this.$input).filter(([, entry]) => entry instanceof Positional).map(([key, entry]) => ({
+			key,
+			entry
+		}));
+		if (positionals.length > 0) {
+			console.log(bold("arguments:"));
+			const longest = Math.max(...positionals.map(({ key }) => key.length));
+			for (const { key, entry } of positionals) {
+				const line = `  ${cyan(pad(entry.$required ? `<${key}>` : `[${key}]`, longest + 4))}${gray(entry.$description ?? "")}`;
+				console.log(line);
+			}
+		}
+		if (this.$children.size > 0) {
+			console.log(bold("sub commands:"));
+			const deduped = Array.from(new Map([...this.$children.values()].map((a) => [a.command.$names[0], a.command])).values());
+			const longest = Math.max(...deduped.map((c) => c.$names[0].length));
+			for (const cmd of deduped) {
+				const line = `  ${cyan(pad(cmd.$names[0], longest + 4))}${gray(cmd.$description) ?? ""}`;
+				console.log(line);
+			}
+			console.log();
+			console.log(`run '${cyan(`${this.fullCommandPath()} <command> --help`)}' for more info on a command.`);
+		}
+	}
+	/**
+	* Handles a set of errors.
+	* @param errors The errors to handle.
+	* @param input The parsed input, if possible.
+	* @returns this
+	*/
+	async handleErrors(errors, input) {
+		let command = this;
+		while (!command.$errorFn && command.$parent) command = command.$parent;
+		if (command.$errorFn) await command.$errorFn(command, errors, input ?? {});
+		else this.defaultErrorScreen(errors);
+		return this;
+	}
+	/**
+	* Runs a command.
+	* @param argv The arguments to run the command with. Defaults to your runtime's `argv` equivalent.
+	* @returns this
+	*/
+	async run(argv) {
+		const result = await this.parse(argv ?? process.argv.slice(2));
+		if (result.isHelp) {
+			result.command.handleErrors([new HelpAskedError(result.command)]);
+			return this;
+		} else if (result.isVersion) {
+			console.log(`${result.command.fullCommandPath()} version ${result.command.$version}`);
+			return this;
+		}
+		try {
+			if (result.errors.length > 0) await result.command.handleErrors(result.errors, result.input);
+			else if (!result.command.$fn) await result.command.handleErrors([new HelpAskedError(result.command), ...result.errors], result.input);
+			else {
+				const middlewares = collectMiddlewares(result.command);
+				if (middlewares.length > 0) await compose(middlewares)(result.input, async () => {
+					await result.command.$fn?.(result.input);
+				});
+				else await result.command.$fn(result.input);
+			}
+		} catch (e) {
+			if (!(e instanceof Error)) console.warn("[convoker] an error that is not instance of `Error` was thrown. this may cause undefined behavior.");
+			await result.command.handleErrors([e]);
+		}
+		return this;
+	}
+};
+function collectMiddlewares(cmd) {
+	const middlewares = [];
+	let current = cmd;
+	while (current) {
+		if (current.$middlewares.length) middlewares.unshift(...current.$middlewares);
+		current = current.$parent;
+	}
+	return middlewares;
+}
+function compose(mws) {
+	return (input, finalNext) => {
+		let index = -1;
+		const dispatch = (i) => {
+			if (i <= index) return Promise.reject(/* @__PURE__ */ new Error("next() called multiple times"));
+			index = i;
+			const fn = mws[i];
+			if (!fn) return finalNext ? finalNext() : Promise.resolve();
+			try {
+				return Promise.resolve(fn(input, () => dispatch(i + 1)));
+			} catch (err) {
+				return Promise.reject(err);
+			}
+		};
+		return dispatch(0);
+	};
+}
+
+//#endregion
+export { MissingRequiredOptionError as a, MissingRequiredArgumentError as i, ConvokerError as n, TooManyArgumentsError as o, HelpAskedError as r, UnknownOptionError as s, Command as t };
+//# sourceMappingURL=command-8P8qXJ2o.mjs.map

package/dist/command-8P8qXJ2o.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-8P8qXJ2o.mjs","names":["command","command: Command<any>","input: Record<string, unknown>","args: string[]","opts: Record<string, string>","errors: ConvokerError[]","usedValue: string | undefined","rawValue: string | string[] | undefined","names: string[]","cmd: Command<any> | undefined","nonCliErrors: Error[]","middlewares: MiddlewareFn<any>[]","current: Command<any> | undefined"],"sources":["../src/command/error.ts","../src/command/index.ts"],"sourcesContent":["import { Positional, Option } from \"@/input\";\nimport { Command } from \".\";\n\n/**\n * A Convoker-related error. These are usually handled by default.\n */\nexport class ConvokerError extends Error {\n  /**\n   * The command this error happened on.\n   */\n  command: Command<any>;\n\n  /**\n   * Creates a new Convoker error.\n   * @param message The message.\n   * @param command The command.\n   */\n  constructor(message: string, command: Command<any>) {\n    super(message);\n    this.command = command;\n  }\n\n  /**\n   * Prints the error's message.\n   */\n  print() {\n    console.error(this.message);\n  }\n}\n\n/**\n * When the user asks for help.\n */\nexport class HelpAskedError extends ConvokerError {\n  /**\n   * Creates a new help asked error.\n   * @param command The command.\n   */\n  constructor(command: Command<any>) {\n    super(\"user asked for help!\", command);\n  }\n}\n\n/**\n * When you pass too many arguments.\n */\nexport class TooManyArgumentsError extends ConvokerError {\n  /**\n   * Creates a new too many arguments error.\n   * @param command The command.\n   */\n  constructor(command: Command<any>) {\n    super(\"too many arguments!\", command);\n  }\n}\n\n/**\n * When you pass an unknown option, when unknown options aren't allowed.\n */\nexport class UnknownOptionError extends ConvokerError {\n  /**\n   * The option key.\n   */\n  key: string;\n\n  /**\n   * Creates a new unknown option error.\n   * @param command The command.\n   * @param key The key.\n   */\n  constructor(command: Command<any>, key: string) {\n    super(`unknown option: ${key}!`, command);\n    this.key = key;\n  }\n}\n\n/**\n * When a required option is missing.\n */\nexport class MissingRequiredOptionError extends ConvokerError {\n  /**\n   * The option key.\n   */\n  key: string;\n  /**\n   * The option entry.\n   */\n  entry: Option<any, any, any>;\n\n  /**\n   * Creates a new missing required option error.\n   * @param command The command.\n   * @param key The key.\n   * @param entry The entry.\n   */\n  constructor(\n    command: Command<any>,\n    key: string,\n    entry: Option<any, any, any>,\n  ) {\n    super(`missing required option: ${key}!`, command);\n    this.key = key;\n    this.entry = entry;\n  }\n}\n\nexport class MissingRequiredArgumentError extends ConvokerError {\n  /**\n   * The argument key.\n   */\n  key: string;\n  /**\n   * The argument entry.\n   */\n  entry: Positional<any, any, any>;\n\n  /**\n   * Creates a new missing required argument error.\n   * @param command The command.\n   * @param key The key.\n   * @param entry The entry.\n   */\n  constructor(\n    command: Command<any>,\n    key: string,\n    entry: Positional<any, any, any>,\n  ) {\n    super(`missing required positional argument: ${key}!`, command);\n    this.key = key;\n    this.entry = entry;\n  }\n}\n","import process from \"node:process\";\n\nimport { gray, cyan, bold, type Theme } from \"@/color\";\nimport { setTheme as setPromptTheme } from \"@/prompt\";\nimport {\n  ConvokerError,\n  HelpAskedError,\n  MissingRequiredArgumentError,\n  MissingRequiredOptionError,\n  TooManyArgumentsError,\n  UnknownOptionError,\n} from \"./error\";\nimport {\n  convert,\n  Option,\n  Positional,\n  type InferInput,\n  type Input,\n} from \"@/input\";\n\n/**\n * What the command is an alias for.\n */\nexport interface CommandAlias<T extends Input = Input> {\n  /**\n   * A pointer to the command.\n   */\n  command: Command<T>;\n  /**\n   * The name of the command this is an alias for.\n   */\n  alias?: string;\n}\n\n/**\n * The result of the `Command.parse` function.\n */\nexport interface ParseResult<T extends Input> {\n  /**\n   * A pointer to the command to run.\n   */\n  command: Command<T>;\n  /**\n   * The input to pass into the command.\n   */\n  input: InferInput<T>;\n  /**\n   * Errors collected during parsing.\n   */\n  errors: ConvokerError[];\n  /**\n   * If this should result in displaying the version of the command.\n   */\n  isVersion: boolean;\n  /**\n   * If this should result in displaying a help screen.\n   */\n  isHelp: boolean;\n}\n\n/**\n * Command action function.\n */\nexport type ActionFn<T extends Input> = (\n  input: InferInput<T>,\n) => any | Promise<any>;\n\n/**\n * Command middleware function.\n */\nexport type MiddlewareFn<T extends Input = Input> = (\n  input: InferInput<T>,\n  next: () => Promise<any>,\n) => any | Promise<any>;\n\n/**\n * Command error handler.\n */\nexport type ErrorFn<T extends Input> = (\n  command: Command<T>,\n  errors: Error[],\n  input: Partial<InferInput<T>>,\n) => void | Promise<void>;\n\n/**\n * Builder for commands.\n */\nexport type Builder = (c: Command<any>) => Command<any> | void;\n\n/**\n * An input map entry.\n */\ninterface MapEntry {\n  /**\n   * The key of the map entry.\n   */\n  key: string;\n  /**\n   * The value of the map entry.\n   */\n  value: Option<any, any, any> | Positional<any, any, any>;\n}\n\n/**\n * A command.\n */\nexport class Command<T extends Input = Input> {\n  /**\n   * The names (aliases) of this command.\n   */\n  $names: string[];\n  /**\n   * The description of this command.\n   */\n  $description: string | undefined;\n  /**\n   * The theme of this command\n   */\n  $theme: Theme | undefined;\n  /**\n   * The version of this command.\n   */\n  $version: string | undefined;\n  /**\n   * The children of this command.\n   */\n  $children: Map<string, CommandAlias> = new Map();\n  /**\n   * The parent of this command.\n   */\n  $parent: Command<any> | undefined;\n  /**\n   * If this command allows unknown options.\n   */\n  $allowUnknownOptions: boolean = false;\n  /**\n   * If you should be able to surpass the amount of positional arguments defined in the input.\n   */\n  $allowSurpassArgLimit: boolean = false;\n  /**\n   * The input this command takes.\n   */\n  $input: T = {} as T;\n  /**\n   * The action function of this command.\n   */\n  $fn: ActionFn<T> | undefined = undefined;\n  /**\n   * The middlewares associated with this command.\n   */\n  $middlewares: MiddlewareFn<T>[] = [];\n  /**\n   * The error handler of this command.\n   */\n  $errorFn: ErrorFn<T> | undefined = undefined;\n\n  /**\n   * Creates a new command.\n   * @param names The names (aliases).\n   * @param desc The description.\n   * @param version The version.\n   */\n  constructor(names: string | string[], desc?: string, version?: string) {\n    this.$names = Array.isArray(names) ? names : [names];\n    this.$description = desc;\n    this.$version = version;\n  }\n\n  /**\n   * Adds a set of aliases to this command.\n   * @param aliases The aliases to add.\n   * @returns this\n   */\n  alias(...aliases: string[]): this {\n    this.$names.push(...aliases);\n    this.$parent?.add(this);\n    return this;\n  }\n\n  /**\n   * Adds a description to this command.\n   * @param desc The description.\n   * @returns this\n   */\n  description(desc: string): this {\n    this.$description = desc;\n    return this;\n  }\n\n  /**\n   * Adds a version to this command.\n   * @param version The version.\n   * @returns this\n   */\n  version(version: string): this {\n    this.$version = version;\n    return this;\n  }\n\n  /**\n   * Sets the input for this command.\n   * @param version The input.\n   * @returns this\n   */\n  input<TInput extends Input>(input: TInput): Command<TInput> {\n    this.$input = input as any;\n    return this as any;\n  }\n\n  /**\n   * Adds a chain of middlewares.\n   * @param fns The middlewares to use.\n   * @returns this\n   */\n  use(...fns: MiddlewareFn<T>[]): this {\n    this.$middlewares.push(...fns);\n    return this;\n  }\n\n  /**\n   * Sets the action function for this command.\n   * @param fn The action.\n   * @returns this\n   */\n  action(fn: ActionFn<T>): this {\n    this.$fn = fn;\n    return this;\n  }\n\n  /**\n   * Sets the error function for this command.\n   * @param fn The error handler.\n   * @returns this\n   */\n  error(fn: ErrorFn<T>): this {\n    this.$errorFn = fn;\n    return this;\n  }\n\n  /**\n   * Adds existing commands to this.\n   * @param commands The commands.\n   * @returns this\n   */\n  add(...commands: Command<any>[]): this {\n    for (const command of commands) {\n      command.$parent = this;\n      const alias = { command, alias: command.$names[0] };\n      for (let i = 0; i < command.$names.length; i++) {\n        if (i === 0) this.$children.set(command.$names[i], { command });\n        this.$children.set(command.$names[i], alias);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * Creates a new subcommand and adds it.\n   * @param names The aliases of the subcommand.\n   * @param builder A builder to create the command.\n   */\n  subCommand(names: string | string[], builder: Builder): this;\n  /**\n   * Creates a new subcommand and adds it.\n   * @param names The aliases of the subcommand.\n   * @param desc The description of the subcommand.\n   * @param version The version of the subcommand.\n   */\n  subCommand(\n    names: string | string[],\n    desc?: string,\n    version?: string,\n  ): Command<any>;\n\n  subCommand(\n    names: string | string[],\n    descOrBuilder?: Builder | string,\n    version?: string,\n  ): Command<any> {\n    if (typeof descOrBuilder === \"function\") {\n      const command = new Command(names);\n      descOrBuilder(command);\n      this.add(command);\n      return this;\n    }\n\n    const command = new Command(names, descOrBuilder, version);\n    this.add(command);\n    return command;\n  }\n\n  /**\n   * Allows unknown options.\n   * @returns this\n   */\n  allowUnknownOptions(): this {\n    this.$allowUnknownOptions = true;\n    return this;\n  }\n\n  /**\n   * Parses a set of command-line arguments.\n   * @param argv The arguments to parse.\n   * @returns A parse result.\n   */\n  async parse(argv: string[]): Promise<ParseResult<T>> {\n    // eslint-disable-next-line -- alias to this is necessary to go through the tree\n    let command: Command<any> = this;\n    let found = false;\n    const input: Record<string, unknown> = {};\n\n    const args: string[] = [];\n    const opts: Record<string, string> = {};\n\n    const errors: ConvokerError[] = [];\n    const map = command.buildInputMap();\n\n    function getOption(key: string, isSpecial?: boolean) {\n      const entry = map.get(key);\n      if (!entry) {\n        if (!command.$allowUnknownOptions && !isSpecial)\n          errors.push(new UnknownOptionError(command, key));\n        return null;\n      }\n      return entry.value as Option<any, any, any>;\n    }\n\n    function setOption(\n      key: string,\n      option: Option<any, any, any>,\n      value?: string,\n    ) {\n      if (option.$kind === \"boolean\") {\n        opts[key] = \"true\";\n      } else if (value !== undefined) {\n        opts[key] = value;\n      }\n    }\n\n    let isVersion = false;\n    let isHelp = false;\n    for (let i = 0; i < argv.length; i++) {\n      const arg = argv[i];\n      if (arg.startsWith(\"--\")) {\n        // --long[=value] or --long [value]\n        const [key, value] = arg.slice(2).split(\"=\");\n\n        let isSpecial = false;\n        if (key === \"help\") {\n          isHelp = true;\n          isSpecial = true;\n        } else if (key === \"version\") {\n          isVersion = true;\n          isSpecial = true;\n        }\n\n        const option = getOption(key, isSpecial);\n        if (option) {\n          if (value === undefined)\n            setOption(\n              key,\n              option,\n              option.$kind === \"boolean\" ? undefined : argv[++i],\n            );\n          else setOption(key, option, value);\n        }\n      } else if (arg.startsWith(\"-\")) {\n        // -abc or -k[=value] or -k [value]\n        const [shortKeys, value] = arg.slice(1).split(\"=\");\n        const chars = shortKeys.split(\"\");\n        let usedValue: string | undefined = value;\n\n        for (const char of chars) {\n          let isSpecial = false;\n          if (char === \"h\") {\n            isHelp = true;\n            isSpecial = true;\n          } else if (char === \"V\") {\n            isVersion = true;\n            isSpecial = true;\n          }\n\n          const option = getOption(char, isSpecial);\n          if (!option) continue;\n\n          if (option.$kind !== \"boolean\" && usedValue === undefined) {\n            usedValue = argv[++i];\n          }\n          setOption(char, option, usedValue);\n          usedValue = undefined; // only first consumes\n        }\n      } else {\n        // positional\n        if (command.$children.has(arg) && !found) {\n          command = command.$children.get(arg)!.command;\n          if (command.$theme) {\n            setPromptTheme(command.$theme);\n          }\n        } else {\n          found = true;\n          args.push(arg);\n        }\n      }\n    }\n\n    // Apply user values, defaults, or enforce required\n    let index = 0;\n    for (const key in command.$input) {\n      const entry = command.$input[key];\n      let rawValue: string | string[] | undefined;\n\n      if (entry instanceof Positional) {\n        if (entry.$list) {\n          rawValue = args.slice(index);\n          index = args.length;\n          if (\n            !command.$allowSurpassArgLimit &&\n            rawValue.length === 0 &&\n            entry.$required\n          ) {\n            errors.push(new MissingRequiredArgumentError(command, key, entry));\n          }\n        } else {\n          rawValue = args[index++];\n          if (rawValue === undefined && entry.$required) {\n            errors.push(new MissingRequiredArgumentError(command, key, entry));\n          }\n        }\n      } else {\n        for (const name of entry.$names) {\n          if (opts[name] !== undefined) {\n            rawValue = entry.$list\n              ? opts[name].split(entry.$separator ?? \",\")\n              : opts[name];\n            break;\n          }\n        }\n      }\n\n      if (rawValue !== undefined) {\n        input[key] = await convert(entry.$kind, rawValue);\n      } else if (entry.$default !== undefined) {\n        input[key] = entry.$default;\n      } else if (entry.$required) {\n        if (entry instanceof Option) {\n          errors.push(new MissingRequiredOptionError(command, key, entry));\n        } else {\n          errors.push(new MissingRequiredArgumentError(command, key, entry));\n        }\n      }\n    }\n\n    // Check for too many arguments\n    const remainingArgs = args.slice(index);\n    if (!command.$allowSurpassArgLimit && remainingArgs.length > 0) {\n      errors.push(new TooManyArgumentsError(command));\n    }\n\n    return {\n      input: input as InferInput<T>,\n      command,\n      errors,\n      isVersion,\n      isHelp,\n    };\n  }\n\n  private buildInputMap(\n    ignoreParentMap?: boolean,\n  ): Map<string | number, MapEntry> {\n    const map = new Map<string | number, MapEntry>();\n\n    let i = 0;\n    for (const key in this.$input) {\n      const value = this.$input[key];\n      if (value instanceof Positional) {\n        map.set(i++, { value, key });\n      } else {\n        for (const name of value.$names) {\n          map.set(name, { value, key });\n        }\n      }\n    }\n\n    if (!ignoreParentMap) {\n      for (const [key, entry] of this.$parent?.buildInputMap() ?? []) {\n        map.set(key, entry);\n      }\n    }\n\n    for (const [, { command }] of this.$children) {\n      for (const [key, entry] of command.buildInputMap(true)) {\n        map.set(key, entry);\n      }\n    }\n\n    return map;\n  }\n\n  /**\n   * Allows surpassing the amount of arguments specified.\n   * @returns this\n   */\n  allowSurpassArgLimit(): this {\n    this.$allowSurpassArgLimit = true;\n    return this;\n  }\n\n  /**\n   * Gets the full command path (name including parents).\n   * @returns The full command path.\n   */\n  fullCommandPath(): string {\n    const names: string[] = [];\n    // eslint-disable-next-line -- necessary for traversing up the tree\n    let cmd: Command<any> | undefined = this;\n    while (cmd) {\n      names.unshift(cmd.$names[0]);\n      cmd = cmd.$parent;\n    }\n    return names.join(\" \");\n  }\n\n  /**\n   * The default error screen.\n   * @param errors The errors.\n   */\n  defaultErrorScreen(errors: Error[]) {\n    let printHelpScreen = false;\n    const nonCliErrors: Error[] = [];\n\n    for (const error of errors) {\n      if (error instanceof ConvokerError) {\n        if (!(error instanceof HelpAskedError)) error.print();\n        printHelpScreen = true;\n      } else {\n        nonCliErrors.push(error);\n      }\n    }\n\n    if (nonCliErrors.length) throw nonCliErrors[0];\n\n    if (!printHelpScreen) return;\n    const pad = (s: string, len: number) => s.padEnd(len, \" \");\n\n    console.log(\n      `${bold(\"usage:\")} ${cyan(this.fullCommandPath())} ${gray(\"[options] [arguments]\")}`,\n    );\n    if (this.$description) {\n      console.log(`${this.$description}`);\n    }\n\n    if (this.$version) {\n      console.log(`${bold(\"version\")} ${this.$version}`);\n    }\n\n    // OPTIONS\n    const opts = Object.entries(this.$input)\n      .filter(([, entry]) => entry instanceof Option)\n      .map(([key, entry]) => ({ key, entry: entry as Option<any, any, any> }));\n\n    if (opts.length > 0) {\n      console.log(bold(\"options:\"));\n      const longest = Math.max(\n        ...opts.map(({ entry }) => entry.$names.join(\", \").length),\n      );\n      for (const { entry } of opts) {\n        const names = entry.$names\n          .map((n) => (n.length === 1 ? `-${n}` : `--${n}`))\n          .join(\", \");\n        const line = `  ${cyan(pad(names, longest + 4))}${gray(entry.$description ?? \"\")}`;\n        console.log(line);\n      }\n    }\n\n    // POSITIONALS\n    const positionals = Object.entries(this.$input)\n      .filter(([, entry]) => entry instanceof Positional)\n      .map(([key, entry]) => ({\n        key,\n        entry: entry as Positional<any, any, any>,\n      }));\n\n    if (positionals.length > 0) {\n      console.log(bold(\"arguments:\"));\n      const longest = Math.max(...positionals.map(({ key }) => key.length));\n      for (const { key, entry } of positionals) {\n        const name = entry.$required ? `<${key}>` : `[${key}]`;\n        const line = `  ${cyan(pad(name, longest + 4))}${gray(entry.$description ?? \"\")}`;\n        console.log(line);\n      }\n    }\n\n    // SUBCOMMANDS\n    if (this.$children.size > 0) {\n      console.log(bold(\"sub commands:\"));\n      const deduped = Array.from(\n        new Map(\n          [...this.$children.values()].map((a) => [\n            a.command.$names[0],\n            a.command,\n          ]),\n        ).values(),\n      );\n\n      const longest = Math.max(...deduped.map((c) => c.$names[0].length));\n      for (const cmd of deduped) {\n        const line = `  ${cyan(pad(cmd.$names[0], longest + 4))}${gray(cmd.$description) ?? \"\"}`;\n        console.log(line);\n      }\n      console.log();\n      console.log(\n        `run '${cyan(`${this.fullCommandPath()} <command> --help`)}' for more info on a command.`,\n      );\n    }\n  }\n\n  /**\n   * Handles a set of errors.\n   * @param errors The errors to handle.\n   * @param input The parsed input, if possible.\n   * @returns this\n   */\n  async handleErrors(\n    errors: Error[],\n    input?: Partial<InferInput<T>>,\n  ): Promise<this> {\n    // eslint-disable-next-line -- necessary for traversing up the tree\n    let command: Command<any> = this;\n    while (!command.$errorFn && command.$parent) {\n      command = command.$parent;\n    }\n\n    if (command.$errorFn) {\n      await command.$errorFn(command, errors, input ?? {});\n    } else {\n      this.defaultErrorScreen(errors);\n    }\n    return this;\n  }\n\n  /**\n   * Runs a command.\n   * @param argv The arguments to run the command with. Defaults to your runtime's `argv` equivalent.\n   * @returns this\n   */\n  async run(argv?: string[]): Promise<this> {\n    const result = await this.parse(argv ?? process.argv.slice(2));\n    if (result.isHelp) {\n      result.command.handleErrors([new HelpAskedError(result.command)]);\n      return this;\n    } else if (result.isVersion) {\n      console.log(\n        `${result.command.fullCommandPath()} version ${result.command.$version}`,\n      );\n      return this;\n    }\n\n    try {\n      if (result.errors.length > 0) {\n        await result.command.handleErrors(result.errors, result.input);\n      } else if (!result.command.$fn) {\n        await result.command.handleErrors(\n          [new HelpAskedError(result.command), ...result.errors],\n          result.input,\n        );\n      } else {\n        const middlewares = collectMiddlewares(result.command);\n        if (middlewares.length > 0) {\n          const runner = compose(middlewares);\n          // finalNext calls the command action with the same input\n          await runner(result.input, async () => {\n            await result.command.$fn?.(result.input);\n          });\n        } else {\n          await result.command.$fn(result.input);\n        }\n      }\n    } catch (e) {\n      if (!(e instanceof Error)) {\n        console.warn(\n          \"[convoker] an error that is not instance of `Error` was thrown. this may cause undefined behavior.\",\n        );\n      }\n      await result.command.handleErrors([e as Error]);\n    }\n    return this;\n  }\n}\n\nfunction collectMiddlewares(cmd: Command<any>) {\n  const middlewares: MiddlewareFn<any>[] = [];\n  let current: Command<any> | undefined = cmd;\n  while (current) {\n    if (current.$middlewares.length) {\n      middlewares.unshift(...current.$middlewares);\n    }\n    current = current.$parent;\n  }\n  return middlewares;\n}\n\nfunction compose(mws: MiddlewareFn<any>[]) {\n  return (input: InferInput<any>, finalNext?: () => Promise<any>) => {\n    let index = -1;\n    const dispatch = (i: number): Promise<any> => {\n      if (i <= index)\n        return Promise.reject(new Error(\"next() called multiple times\"));\n      index = i;\n      const fn = mws[i];\n      if (!fn) {\n        // when middlewares exhausted call finalNext if provided\n        return finalNext ? finalNext() : Promise.resolve();\n      }\n      try {\n        return Promise.resolve(fn(input, () => dispatch(i + 1)));\n      } catch (err) {\n        return Promise.reject(err);\n      }\n    };\n    return dispatch(0);\n  };\n}\n\nexport * from \"./error\";\n"],"mappings":"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"}