convoker 0.3.4 → 0.4.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 trailfrost
+Copyright (c) 2025 sprucepad
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/color/index.d.mts

@@ -0,0 +1,2 @@
+import { A as inverse, B as underline, C as cyanBright, D as greenBright, E as green, F as red, H as whiteBright, I as redBright, L as reset, M as magenta, N as magentaBright, O as hidden, P as overline, R as strikethrough, S as cyan, T as gray, U as yellow, V as white, W as yellowBright, _ as black, a as bgCyanBright, b as bold, c as bgGreenBright, d as bgRed, f as bgRedBright, g as bgYellowBright, h as bgYellow, i as bgCyan, j as italic, l as bgMagenta, m as bgWhiteBright, n as bgBlue, o as bgGray, p as bgWhite, r as bgBlueBright, s as bgGreen, t as bgBlack, u as bgMagentaBright, v as blue, w as dim, x as createAnsiColor, y as blueBright, z as supportsColor } from "../index-CCQ6jz54.mjs";
+export { bgBlack, bgBlue, bgBlueBright, bgCyan, bgCyanBright, bgGray, bgGreen, bgGreenBright, bgMagenta, bgMagentaBright, bgRed, bgRedBright, bgWhite, bgWhiteBright, bgYellow, bgYellowBright, black, blue, blueBright, bold, createAnsiColor, cyan, cyanBright, dim, gray, green, greenBright, hidden, inverse, italic, magenta, magentaBright, overline, red, redBright, reset, strikethrough, supportsColor, underline, white, whiteBright, yellow, yellowBright };

package/dist/color/index.mjs

@@ -0,0 +1,3 @@
+import { A as inverse, B as underline, C as cyan, D as green, E as gray, F as red, H as whiteBright, I as redBright, L as reset, M as magenta, N as magentaBright, O as greenBright, P as overline, R as strikethrough, S as createAnsiColor, T as dim, U as yellow, V as white, W as yellowBright, _ as black, a as bgCyanBright, b as bold, c as bgGreenBright, d as bgRed, f as bgRedBright, g as bgYellowBright, h as bgYellow, i as bgCyan, j as italic, k as hidden, l as bgMagenta, m as bgWhiteBright, n as bgBlue, o as bgGray, p as bgWhite, r as bgBlueBright, s as bgGreen, t as bgBlack, u as bgMagentaBright, v as blue, w as cyanBright, y as blueBright, z as supportsColor } from "../color-s-N9yh90.mjs";
+
+export { bgBlack, bgBlue, bgBlueBright, bgCyan, bgCyanBright, bgGray, bgGreen, bgGreenBright, bgMagenta, bgMagentaBright, bgRed, bgRedBright, bgWhite, bgWhiteBright, bgYellow, bgYellowBright, black, blue, blueBright, bold, createAnsiColor, cyan, cyanBright, dim, gray, green, greenBright, hidden, inverse, italic, magenta, magentaBright, overline, red, redBright, reset, strikethrough, supportsColor, underline, white, whiteBright, yellow, yellowBright };

package/dist/{color-OlJQTTxb.mjs → color-s-N9yh90.mjs}

@@ -1,9 +1,7 @@
 import { t as __export } from "./chunk-z5eko27R.mjs";
-import { i as merge } from "./utils-ChmY93uA.mjs";
 
-//#region src/color.ts
+//#region src/color/index.ts
 var color_exports = /* @__PURE__ */ __export({
-	DEFAULT_THEME: () => DEFAULT_THEME,
 	bgBlack: () => bgBlack,
 	bgBlue: () => bgBlue,
 	bgBlueBright: () => bgBlueBright,
@@ -27,7 +25,6 @@ var color_exports = /* @__PURE__ */ __export({
 	createAnsiColor: () => createAnsiColor,
 	cyan: () => cyan,
 	cyanBright: () => cyanBright,
-	defineTheme: () => defineTheme,
 	dim: () => dim,
 	gray: () => gray,
 	green: () => green,
@@ -70,14 +67,10 @@ function detectColorSupport() {
 		].some((k) => k in env) || env.CI_NAME === "codeship") return true;
 		return false;
 	}
-	if (typeof Deno !== "undefined" && Deno.noColor !== void 0) return !Deno.noColor;
-	if (typeof process !== "undefined" && process.stdout) {
-		const term = env.TERM || "";
-		if ((env.COLORTERM || "").length > 0) return true;
-		if (term === "dumb") return false;
-		return /(color|ansi|cygwin|xterm|vt100)/i.test(term);
-	}
-	return false;
+	const term = env.TERM || "";
+	if ((env.COLORTERM || "").length > 0) return true;
+	if (term === "dumb") return false;
+	return /(color|ansi|cygwin|xterm|vt100)/i.test(term);
 }
 /**
 * If the runtime supports color.
@@ -139,34 +132,7 @@ const bgBlueBright = createAnsiColor(104, 49);
 const bgMagentaBright = createAnsiColor(105, 49);
 const bgCyanBright = createAnsiColor(106, 49);
 const bgWhiteBright = createAnsiColor(107, 49);
-/**
-* The default theme.
-*/
-const DEFAULT_THEME = {
-	primary: cyan,
-	secondary: gray,
-	success: green,
-	warning: yellow,
-	error: red,
-	symbols: {
-		success: "✔",
-		error: "✖",
-		warning: "⚠"
-	},
-	styles: {
-		bold,
-		italic,
-		underline
-	}
-};
-/**
-* Defines a theme.
-* @param theme The (partial) theme.
-* @returns The theme, merged with the default theme.
-*/
-function defineTheme(theme) {
-	return merge(DEFAULT_THEME, theme);
-}
 
 //#endregion
-export { greenBright as A, strikethrough as B, createAnsiColor as C, dim as D, defineTheme as E, magentaBright as F, yellow as G, underline as H, overline as I, yellowBright as K, red as L, inverse as M, italic as N, gray as O, magenta as P, redBright as R, color_exports as S, cyanBright as T, white as U, supportsColor as V, whiteBright as W, bgYellowBright as _, bgCyan as a, blueBright as b, bgGreen as c, bgMagentaBright as d, bgRed as f, bgYellow as g, bgWhiteBright as h, bgBlueBright as i, hidden as j, green as k, bgGreenBright as l, bgWhite as m, bgBlack as n, bgCyanBright as o, bgRedBright as p, bgBlue as r, bgGray as s, DEFAULT_THEME as t, bgMagenta as u, black as v, cyan as w, bold as x, blue as y, reset as z };
+export { inverse as A, underline as B, cyan as C, green as D, gray as E, red as F, whiteBright as H, redBright as I, reset as L, magenta as M, magentaBright as N, greenBright as O, overline as P, strikethrough as R, createAnsiColor as S, dim as T, yellow as U, white as V, yellowBright as W, black as _, bgCyanBright as a, bold as b, bgGreenBright as c, bgRed as d, bgRedBright as f, bgYellowBright as g, bgYellow as h, bgCyan as i, italic as j, hidden as k, bgMagenta as l, bgWhiteBright as m, bgBlue as n, bgGray as o, bgWhite as p, bgBlueBright as r, bgGreen as s, bgBlack as t, bgMagentaBright as u, blue as v, cyanBright as w, color_exports as x, blueBright as y, supportsColor as z };
+//# sourceMappingURL=color-s-N9yh90.mjs.map

package/dist/color-s-N9yh90.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-s-N9yh90.mjs","names":[],"sources":["../src/color/index.ts"],"sourcesContent":["/**\n * Detects if the runtime supports colored output.\n * @returns If the runtime supports colored output.\n */\nfunction detectColorSupport() {\n  // If running in a browser-like environment, return false\n  if (typeof window !== \"undefined\" && typeof window.document !== \"undefined\") {\n    return false;\n  }\n\n  const env = typeof process !== \"undefined\" ? (process.env ?? {}) : {};\n\n  // Force-disable colors if NO_COLOR is set\n  if (\"NO_COLOR\" in env) return false;\n\n  // Force-enable if FORCE_COLOR is set\n  if (\"FORCE_COLOR\" in env) return true;\n\n  // Check for CI systems that support color\n  if (\"CI\" in env) {\n    if (\n      [\n        \"TRAVIS\",\n        \"CIRCLECI\",\n        \"APPVEYOR\",\n        \"GITLAB_CI\",\n        \"GITHUB_ACTIONS\",\n        \"BUILDKITE\",\n        \"DRONE\",\n      ].some((k) => k in env) ||\n      env.CI_NAME === \"codeship\"\n    ) {\n      return true;\n    }\n    return false;\n  }\n\n  const term = env.TERM || \"\";\n  const colorterm = env.COLORTERM || \"\";\n\n  if (colorterm.length > 0) return true;\n  if (term === \"dumb\") return false;\n\n  return /(color|ansi|cygwin|xterm|vt100)/i.test(term);\n}\n\n/**\n * If the runtime supports color.\n */\nexport const supportsColor = detectColorSupport();\n\n/**\n * Creates a function that wraps a string in ANSI codes.\n * @param open The opening ANSI code.\n * @param close The closing ANSI code.\n * @returns A function that wraps the string in ANSI codes.\n */\nexport function createAnsiColor(\n  open: number,\n  close: number,\n): (input: any) => string {\n  const openCode = `\\u001b[${open}m`;\n  const closeCode = `\\u001b[${close}m`;\n\n  if (!supportsColor) return (input) => input + \"\";\n\n  return (input) => {\n    if (!input) return openCode + closeCode;\n\n    const str = input + \"\";\n    // replace any existing close codes with reopen\n    const replaced = str.replace(\n      new RegExp(`\\u001b\\\\[${close}m`, \"g\"),\n      closeCode + openCode,\n    );\n    return openCode + replaced + closeCode;\n  };\n}\n\nexport const reset = createAnsiColor(0, 0);\nexport const bold = createAnsiColor(1, 22);\nexport const dim = createAnsiColor(2, 22);\nexport const italic = createAnsiColor(3, 23);\nexport const underline = createAnsiColor(4, 24);\nexport const overline = createAnsiColor(53, 55);\nexport const inverse = createAnsiColor(7, 27);\nexport const hidden = createAnsiColor(8, 28);\nexport const strikethrough = createAnsiColor(9, 29);\n\nexport const black = createAnsiColor(30, 39);\nexport const red = createAnsiColor(31, 39);\nexport const green = createAnsiColor(32, 39);\nexport const yellow = createAnsiColor(33, 39);\nexport const blue = createAnsiColor(34, 39);\nexport const magenta = createAnsiColor(35, 39);\nexport const cyan = createAnsiColor(36, 39);\nexport const white = createAnsiColor(37, 39);\nexport const gray = createAnsiColor(90, 39);\n\nexport const bgBlack = createAnsiColor(40, 49);\nexport const bgRed = createAnsiColor(41, 49);\nexport const bgGreen = createAnsiColor(42, 49);\nexport const bgYellow = createAnsiColor(43, 49);\nexport const bgBlue = createAnsiColor(44, 49);\nexport const bgMagenta = createAnsiColor(45, 49);\nexport const bgCyan = createAnsiColor(46, 49);\nexport const bgWhite = createAnsiColor(47, 49);\nexport const bgGray = createAnsiColor(100, 49);\n\nexport const redBright = createAnsiColor(91, 39);\nexport const greenBright = createAnsiColor(92, 39);\nexport const yellowBright = createAnsiColor(93, 39);\nexport const blueBright = createAnsiColor(94, 39);\nexport const magentaBright = createAnsiColor(95, 39);\nexport const cyanBright = createAnsiColor(96, 39);\nexport const whiteBright = createAnsiColor(97, 39);\n\nexport const bgRedBright = createAnsiColor(101, 49);\nexport const bgGreenBright = createAnsiColor(102, 49);\nexport const bgYellowBright = createAnsiColor(103, 49);\nexport const bgBlueBright = createAnsiColor(104, 49);\nexport const bgMagentaBright = createAnsiColor(105, 49);\nexport const bgCyanBright = createAnsiColor(106, 49);\nexport const bgWhiteBright = createAnsiColor(107, 49);\n"],"mappings":"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"}

package/dist/command/index.d.mts

@@ -0,0 +1,5 @@
+import "../theme-EERPMtQU.mjs";
+import "../standard-schema-D1sStgzy.mjs";
+import "../index-C6iJZTo3.mjs";
+import { a as ErrorFn, c as ConvokerError, d as MissingRequiredOptionError, f as TooManyArgumentsError, i as CommandAlias, l as HelpAskedError, n as Builder, o as MiddlewareFn, p as UnknownOptionError, r as Command, s as ParseResult, t as ActionFn, u as MissingRequiredArgumentError } from "../index-OUlP1L9o.mjs";
+export { ActionFn, Builder, Command, CommandAlias, ConvokerError, ErrorFn, HelpAskedError, MiddlewareFn, MissingRequiredArgumentError, MissingRequiredOptionError, ParseResult, TooManyArgumentsError, UnknownOptionError };

package/dist/command/index.mjs

@@ -0,0 +1,9 @@
+import "../color-s-N9yh90.mjs";
+import "../theme-Chg3mOhZ.mjs";
+import "../standard-schema-WhGEzW0C.mjs";
+import "../raw-DVT5lw11.mjs";
+import "../prompt-OXGrAkDf.mjs";
+import { a as MissingRequiredOptionError, i as MissingRequiredArgumentError, n as ConvokerError, o as TooManyArgumentsError, r as HelpAskedError, s as UnknownOptionError, t as Command } from "../command-C9QIG--8.mjs";
+import "../input-li13L1uf.mjs";
+
+export { Command, ConvokerError, HelpAskedError, MissingRequiredArgumentError, MissingRequiredOptionError, TooManyArgumentsError, UnknownOptionError };

package/dist/{command-D2UiQBNA.mjs → command-C9QIG--8.mjs}

@@ -1,195 +1,232 @@
 import { t as __export } from "./chunk-z5eko27R.mjs";
-import { i as merge, n as isDeno, r as isNode, t as isBun } from "./utils-ChmY93uA.mjs";
-import { O as gray, t as DEFAULT_THEME, w as cyan, x as bold } from "./color-OlJQTTxb.mjs";
-import { a as MissingRequiredOptionError, i as MissingRequiredArgumentError, n as HelpAskedError, o as TooManyArgumentsError, s as UnknownOptionError, t as ConvokerError } from "./error-C1S1gs8L.mjs";
-import { c as setTheme } from "./prompt-Cvufljin.mjs";
-import { i as convert, n as Positional, t as Option } from "./input-DRy_sVxZ.mjs";
+import { C as cyan, E as gray, b as bold } from "./color-s-N9yh90.mjs";
+import { r as merge, t as DEFAULT_THEME } from "./theme-Chg3mOhZ.mjs";
+import { c as setTheme } from "./prompt-OXGrAkDf.mjs";
+import { i as convert, n as Positional, t as Option } from "./input-li13L1uf.mjs";
+import process from "node:process";
 
-//#region src/log.ts
+//#region src/log/error.ts
+/**
+* Error for when logs fail to write to stdout/stderr.
+*/
+var WriteError = class extends Error {
+	/**
+	* Creates a new error for stream writes.
+	* @param streamName The name of the stream.
+	*/
+	constructor(streamName) {
+		super(`Could not write to \`${streamName}\`.`);
+	}
+};
+
+//#endregion
+//#region src/log/index.ts
 var log_exports = /* @__PURE__ */ __export({
+	DEFAULT_CONFIG: () => DEFAULT_CONFIG,
+	WriteError: () => WriteError,
 	error: () => error,
 	fatal: () => fatal,
 	info: () => info,
 	setConfig: () => setConfig,
 	setTheme: () => setTheme$1,
-	setup: () => setup,
 	trace: () => trace,
 	warn: () => warn
 });
+let th = DEFAULT_THEME;
 /**
-* Gets the default stdout, in a cross-runtime way.
-* @returns The default stdout.
+* Sets the theme for logs.
+* @param theme The theme to set.
 */
-async function getDefaultStdout() {
-	if (isNode && process.stdout?.writable) {
-		const { Writable } = await import("node:stream");
-		return Writable.toWeb(process.stdout);
-	}
-	if (isDeno && Deno.stdout?.writable) return Deno.stdout.writable;
-	if (isBun && Bun.stdout) return Bun.stdout;
-	return new WritableStream({ write(chunk) {
-		console.log(String(chunk));
-	} });
+function setTheme$1(theme) {
+	th = theme;
 }
 /**
-* Gets the default stderr, in a cross-runtime way.
-* @returns The default stderr.
+* Default log configuration.
 */
-async function getDefaultStderr() {
-	if (isNode && process.stderr?.writable) {
-		const { Writable } = await import("node:stream");
-		return Writable.toWeb(process.stderr);
-	}
-	if (isDeno && Deno.stderr?.writable) return Deno.stderr.writable;
-	if (isBun && Bun.stderr) return Bun.stderr;
-	return new WritableStream({ write(chunk) {
-		console.error(String(chunk));
-	} });
+const DEFAULT_CONFIG = {
+	format: "text",
+	stderr: process.stderr,
+	stdout: process.stdout,
+	jsonSpace: 2
+};
+let config = DEFAULT_CONFIG;
+/**
+* Sets log configuration.
+* @param cfg The configuration, optionally including a theme.
+*/
+function setConfig({ theme,...cfg }) {
+	config = merge(DEFAULT_CONFIG, cfg);
+	th = theme ?? th;
 }
 /**
-* Gets the default stdin, in a cross-runtime way.
-* @returns The default stdin.
+* Prints messages.
+* @param msgs The messages to print.
 */
-async function getDefaultStdin() {
-	if (isNode && process.stdin?.readable) {
-		const { Readable } = await import("node:stream");
-		return Readable.toWeb(process.stdin);
-	}
-	if (isDeno && Deno.stdin?.readable) return Deno.stdin.readable;
-	if (isBun) return Bun.stdin.stream();
-	return new ReadableStream({ start(controller) {
-		controller.close();
-	} });
+function trace(...msgs) {
+	const str = format(msgs, "TRACE");
+	if (!config.stdout.write(str)) throw new WriteError("stdout");
+}
+/**
+* Prints messages.
+* @param msgs The messages to print.
+*/
+function info(...msgs) {
+	const str = format(msgs, "INFO");
+	if (!config.stdout.write(str)) throw new WriteError("stdout");
 }
-let theme = DEFAULT_THEME;
-let config = void 0;
 /**
-* Sets a new theme.
-* @param t The theme.
+* Prints warning messages.
+* @param msgs The messages to print.
 */
-function setTheme$1(t) {
-	theme = t;
+function warn(...msgs) {
+	const str = format(msgs, "WARN");
+	if (!config.stderr.write(th.warning(str))) throw new WriteError("stderr");
 }
 /**
-* Sets new configuration.
-* @param c The config.
+* Prints error messages.
+* @param msgs The messages to print.
 */
-async function setConfig(c) {
-	config = merge({
-		format: "text",
-		stdout: await getDefaultStdout(),
-		stderr: await getDefaultStderr(),
-		stdin: await getDefaultStdin()
-	}, c);
+function error(...msgs) {
+	const str = format(msgs, "ERROR");
+	if (!config.stderr.write(str)) throw new WriteError("stderr");
 }
 /**
-* Sets default configuration.
+* Prints messages and exits with code -1.
+* @param msgs The messages to print.
 */
-async function setup() {
-	await setConfig({});
+function fatal(...msgs) {
+	const str = format(msgs, "FATAL");
+	if (!config.stderr.write(str)) throw new WriteError("stderr");
+	process.exit(-1);
 }
 /**
-* Formats a message to the correct format.
-* @param level The level of mesage.
+* Formats a list of messages into a single string.
 * @param msgs The messages to format.
-* @returns The formatted message.
+* @param level The log level.
+* @returns A formatted message.
 */
-function formatMessages(level, ...msgs) {
+function format(msgs, level) {
 	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-	const msg = msgs.map((m) => typeof m === "string" ? m : JSON.stringify(m, null, 2)).join(" ");
+	const msg = msgs.map((m) => typeof m === "string" ? m : JSON.stringify(m, null, config.jsonSpace)).join(" ");
 	switch (config.format) {
-		case "json": return JSON.stringify({
+		case "json": return colorize(JSON.stringify({
 			timestamp,
 			level,
 			message: msg
-		}) + "\n";
-		case "xml": return `<log>
-  <timestamp>${timestamp}</timestamp>
-  <level>${level}</level>
-  <message>${msg}</message>
-</log>\n`;
-		case "yaml": return `- timestamp: ${timestamp}
-  level: ${level}
-  message: "${msg.replace(/"/g, "\\\"")}"\n`;
-		case "csv": return `"${timestamp}","${level}","${msg.replace(/"/g, "\"\"")}"\n`;
+		}) + "\n", level);
 		case "text":
-		default: return `[${timestamp}] [${level.toUpperCase()}] ${msg}\n`;
+		default: return colorize(`[${timestamp}] [${th.symbols[level] ?? level}] ${msg}\n`, level);
 	}
 }
 /**
-* Colorizes text.
+* Wraps a string in ANSI codes, based on a log level.
+* @param str The string to color.
 * @param level The log level.
-* @param text The text to colorize.
-* @returns The colorized text.
+* @returns An ANSI-wrapped string.
 */
-function colorize(level, text) {
+function colorize(str, level) {
 	switch (level) {
-		case "trace": return theme.secondary ? theme.secondary(text) : text;
-		case "info": return theme.info ? theme.info(text) : text;
-		case "warn": return theme.warning ? theme.warning(text) : text;
-		case "error": return theme.error ? theme.error(text) : text;
-		case "fatal": return theme.error ? theme.error(theme.styles?.bold?.(text) ?? text) : text;
-		default: return text;
+		case "TRACE": return th.secondary(str);
+		case "WARN": return th.warning(str);
+		case "ERROR": return th.error(str);
+		case "FATAL": return th.styles?.bold ? th.styles.bold(th.error(str)) : th.error(str);
+		case "INFO":
+		default: return th.info?.(str) ?? str;
 	}
 }
+
+//#endregion
+//#region src/command/error.ts
 /**
-* Writes to a stream.
-* @param stream The stream to write to.
-* @param msg The message to write.
+* A Convoker-related error. These are usually handled by default.
 */
-async function writeToStream(stream, msg) {
-	const writer = stream.getWriter();
-	try {
-		await writer.write(msg);
-	} finally {
-		writer.releaseLock();
+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 debug information.
-* @param msgs The messages to write.
-*/
-async function trace(...msgs) {
-	const colored = colorize("trace", formatMessages("trace", ...msgs));
-	await writeToStream(config.stdout, colored);
-}
+	/**
+	* Prints the error's message.
+	*/
+	print() {
+		console.error(this.message);
+	}
+};
 /**
-* Prints information.
-* @param msgs The messages to write.
+* When the user asks for help.
 */
-async function info(...msgs) {
-	const colored = colorize("info", formatMessages("info", ...msgs));
-	await writeToStream(config.stdout, colored);
-}
+var HelpAskedError = class extends ConvokerError {
+	/**
+	* Creates a new help asked error.
+	* @param command The command.
+	*/
+	constructor(command) {
+		super("user asked for help!", command);
+	}
+};
 /**
-* Prints warnings.
-* @param msgs The messages to write.
+* When you pass too many arguments.
 */
-async function warn(...msgs) {
-	const colored = colorize("warn", formatMessages("warn", ...msgs));
-	await writeToStream(config.stdout, colored);
-}
+var TooManyArgumentsError = class extends ConvokerError {
+	/**
+	* Creates a new too many arguments error.
+	* @param command The command.
+	*/
+	constructor(command) {
+		super("too many arguments!", command);
+	}
+};
 /**
-* Prints errors.
-* @param msgs The messages to write.
+* When you pass an unknown option, when unknown options aren't allowed.
 */
-async function error(...msgs) {
-	const colored = colorize("error", formatMessages("error", ...msgs));
-	await writeToStream(config.stderr, colored);
-}
+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;
+	}
+};
 /**
-* Prints errors and exits.
-* @param msgs The messages to write.
+* When a required option is missing.
 */
-async function fatal(...msgs) {
-	const colored = colorize("fatal", formatMessages("fatal", ...msgs));
-	await writeToStream(config.stderr, colored);
-	if (isDeno) Deno.exit(-1);
-	else if (isNode || isBun) process.exit(-1);
-}
+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.ts
+//#region src/command/index.ts
 /**
 * A command.
 */
@@ -218,7 +255,7 @@ var Command = class Command {
 	* @returns this
 	*/
 	alias(...aliases) {
-		this.$names.concat(aliases);
+		this.$names.push(...aliases);
 		this.$parent?.add(this);
 		return this;
 	}
@@ -277,19 +314,21 @@ var Command = class Command {
 		return this;
 	}
 	/**
-	* Adds an existing command to this.
-	* @param command The command.
+	* Adds existing commands to this.
+	* @param commands The commands.
 	* @returns this
 	*/
-	add(command) {
-		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);
+	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;
 	}
@@ -526,8 +565,7 @@ var Command = class Command {
 	* @returns this
 	*/
 	async run(argv) {
-		if (!argv) argv = typeof Bun !== "undefined" ? Bun.argv.slice(2) : typeof Deno !== "undefined" ? Deno.args : process.argv.slice(2);
-		const result = await this.parse(argv);
+		const result = await this.parse(argv ?? process.argv.slice(2));
 		if (result.isHelp) {
 			result.command.handleErrors([new HelpAskedError(result.command)]);
 			return this;
@@ -580,4 +618,5 @@ function compose(mws) {
 }
 
 //#endregion
-export { log_exports as n, Command as t };
+export { MissingRequiredOptionError as a, log_exports as c, MissingRequiredArgumentError as i, ConvokerError as n, TooManyArgumentsError as o, HelpAskedError as r, UnknownOptionError as s, Command as t };
+//# sourceMappingURL=command-C9QIG--8.mjs.map