convoker 0.4.0 → 0.4.1

package/dist/color/index.d.mts

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

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

@@ -1,40 +1,7 @@
 import { t as __export } from "./chunk-z5eko27R.mjs";
 
-//#region src/utils.ts
-/**
-* Checks if a value is a plain object.
-* @param value The value to check.
-* @returns If the value is a plain object.
-*/
-function isPlainObject(value) {
-	return value !== null && typeof value === "object" && Object.getPrototypeOf(value) === Object.prototype;
-}
-/**
-* Merges two objects deeply.
-* @param source The source object.
-* @param target The target object.
-* @returns The merged objects.
-*/
-function merge(source, target) {
-	if (Array.isArray(source) && Array.isArray(target)) return target;
-	if (isPlainObject(source) && isPlainObject(target)) {
-		const result = {};
-		new Set([...Object.keys(source), ...Object.keys(target)]).forEach((key) => {
-			const sourceVal = source[key];
-			const targetVal = target[key];
-			if (sourceVal !== void 0 && targetVal !== void 0) result[key] = merge(sourceVal, targetVal);
-			else if (targetVal !== void 0) result[key] = targetVal;
-			else result[key] = sourceVal;
-		});
-		return result;
-	}
-	return target;
-}
-
-//#endregion
 //#region src/color/index.ts
 var color_exports = /* @__PURE__ */ __export({
-	DEFAULT_THEME: () => DEFAULT_THEME,
 	bgBlack: () => bgBlack,
 	bgBlue: () => bgBlue,
 	bgBlueBright: () => bgBlueBright,
@@ -58,7 +25,6 @@ var color_exports = /* @__PURE__ */ __export({
 	createAnsiColor: () => createAnsiColor,
 	cyan: () => cyan,
 	cyanBright: () => cyanBright,
-	defineTheme: () => defineTheme,
 	dim: () => dim,
 	gray: () => gray,
 	green: () => green,
@@ -166,36 +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: "✖",
-		fatal: "✖",
-		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, merge as q, 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 };
-//# sourceMappingURL=color-DiZvJ0Fc.mjs.map
+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

@@ -1,5 +1,5 @@
-import "../index-BtbthYjp.mjs";
-import "../standard-schema-DXS-QnwX.mjs";
-import "../index-ClhbwSD8.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-Cnx4H4D-.mjs";
+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

@@ -1,8 +1,9 @@
-import "../color-DiZvJ0Fc.mjs";
-import "../standard-schema-DTuaYJjO.mjs";
-import "../raw-DEtZFeMv.mjs";
-import "../prompt-a5Ix_Hyc.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-8P8qXJ2o.mjs";
-import "../input-XUsy1LCQ.mjs";
+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-8P8qXJ2o.mjs → command-C9QIG--8.mjs}

@@ -1,8 +1,141 @@
-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 { t as __export } from "./chunk-z5eko27R.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/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,
+	trace: () => trace,
+	warn: () => warn
+});
+let th = DEFAULT_THEME;
+/**
+* Sets the theme for logs.
+* @param theme The theme to set.
+*/
+function setTheme$1(theme) {
+	th = theme;
+}
+/**
+* Default log configuration.
+*/
+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;
+}
+/**
+* Prints messages.
+* @param msgs The messages to print.
+*/
+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");
+}
+/**
+* Prints warning messages.
+* @param msgs The messages to print.
+*/
+function warn(...msgs) {
+	const str = format(msgs, "WARN");
+	if (!config.stderr.write(th.warning(str))) throw new WriteError("stderr");
+}
+/**
+* Prints error messages.
+* @param msgs The messages to print.
+*/
+function error(...msgs) {
+	const str = format(msgs, "ERROR");
+	if (!config.stderr.write(str)) throw new WriteError("stderr");
+}
+/**
+* Prints messages and exits with code -1.
+* @param msgs The messages to print.
+*/
+function fatal(...msgs) {
+	const str = format(msgs, "FATAL");
+	if (!config.stderr.write(str)) throw new WriteError("stderr");
+	process.exit(-1);
+}
+/**
+* Formats a list of messages into a single string.
+* @param msgs The messages to format.
+* @param level The log level.
+* @returns A formatted message.
+*/
+function format(msgs, level) {
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	const msg = msgs.map((m) => typeof m === "string" ? m : JSON.stringify(m, null, config.jsonSpace)).join(" ");
+	switch (config.format) {
+		case "json": return colorize(JSON.stringify({
+			timestamp,
+			level,
+			message: msg
+		}) + "\n", level);
+		case "text":
+		default: return colorize(`[${timestamp}] [${th.symbols[level] ?? level}] ${msg}\n`, level);
+	}
+}
+/**
+* Wraps a string in ANSI codes, based on a log level.
+* @param str The string to color.
+* @param level The log level.
+* @returns An ANSI-wrapped string.
+*/
+function colorize(str, level) {
+	switch (level) {
+		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
 /**
 * A Convoker-related error. These are usually handled by default.
@@ -281,7 +414,10 @@ var Command = class Command {
 				}
 			} else if (command.$children.has(arg) && !found) {
 				command = command.$children.get(arg).command;
-				if (command.$theme) setTheme(command.$theme);
+				if (command.$theme) {
+					setTheme(command.$theme);
+					setTheme$1(command.$theme);
+				}
 			} else {
 				found = true;
 				args.push(arg);
@@ -364,10 +500,10 @@ var Command = class Command {
 	defaultErrorScreen(errors) {
 		let printHelpScreen = false;
 		const nonCliErrors = [];
-		for (const error of errors) if (error instanceof ConvokerError) {
-			if (!(error instanceof HelpAskedError)) error.print();
+		for (const error$1 of errors) if (error$1 instanceof ConvokerError) {
+			if (!(error$1 instanceof HelpAskedError)) error$1.print();
 			printHelpScreen = true;
-		} else nonCliErrors.push(error);
+		} else nonCliErrors.push(error$1);
 		if (nonCliErrors.length) throw nonCliErrors[0];
 		if (!printHelpScreen) return;
 		const pad = (s, len) => s.padEnd(len, " ");
@@ -482,5 +618,5 @@ function compose(mws) {
 }
 
 //#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
+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

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-C9QIG--8.mjs","names":["th: Theme","setTheme","DEFAULT_CONFIG: Config","config: Config","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[]","error","middlewares: MiddlewareFn<any>[]","current: Command<any> | undefined"],"sources":["../src/log/error.ts","../src/log/index.ts","../src/command/error.ts","../src/command/index.ts"],"sourcesContent":["/**\n * Error for when logs fail to write to stdout/stderr.\n */\nexport class WriteError extends Error {\n  /**\n   * Creates a new error for stream writes.\n   * @param streamName The name of the stream.\n   */\n  constructor(streamName: string) {\n    super(`Could not write to \\`${streamName}\\`.`);\n  }\n}\n","import Stream from \"node:stream\";\nimport process from \"node:process\";\nimport { DEFAULT_THEME, type Theme } from \"@/theme\";\nimport { DeepPartial, merge } from \"@/utils\";\nimport { WriteError } from \"./error\";\n\nlet th: Theme = DEFAULT_THEME;\n\n/**\n * Sets the theme for logs.\n * @param theme The theme to set.\n */\nexport function setTheme(theme: Theme) {\n  th = theme;\n}\n\n/**\n * Log configuration.\n */\nexport interface Config {\n  /**\n   * The configuration format.\n   */\n  format: \"text\" | \"json\";\n  /**\n   * Standard output.\n   */\n  stdout: Stream.Writable;\n  /**\n   * Standard error output.\n   */\n  stderr: Stream.Writable;\n  /**\n   * How much space in the JSON output of objects.\n   * This does not change spacing in JSON logs, only for objects passed into log functions.\n   */\n  jsonSpace: number;\n}\n\n/**\n * Default log configuration.\n */\nexport const DEFAULT_CONFIG: Config = {\n  format: \"text\",\n  stderr: process.stderr,\n  stdout: process.stdout,\n  jsonSpace: 2,\n};\n\nlet config: Config = DEFAULT_CONFIG;\n\n/**\n * Sets log configuration.\n * @param cfg The configuration, optionally including a theme.\n */\nexport function setConfig({\n  theme,\n  ...cfg\n}: DeepPartial<Config> & { theme?: Theme }) {\n  config = merge(DEFAULT_CONFIG, cfg);\n  th = theme ?? th;\n}\n\n/**\n * Prints messages.\n * @param msgs The messages to print.\n */\nexport function trace(...msgs: any[]) {\n  const str = format(msgs, \"TRACE\");\n  if (!config.stdout.write(str)) {\n    throw new WriteError(\"stdout\");\n  }\n}\n\n/**\n * Prints messages.\n * @param msgs The messages to print.\n */\nexport function info(...msgs: any[]) {\n  const str = format(msgs, \"INFO\");\n  if (!config.stdout.write(str)) {\n    throw new WriteError(\"stdout\");\n  }\n}\n\n/**\n * Prints warning messages.\n * @param msgs The messages to print.\n */\nexport function warn(...msgs: any[]) {\n  const str = format(msgs, \"WARN\");\n  if (!config.stderr.write(th.warning(str))) {\n    throw new WriteError(\"stderr\");\n  }\n}\n\n/**\n * Prints error messages.\n * @param msgs The messages to print.\n */\nexport function error(...msgs: any[]) {\n  const str = format(msgs, \"ERROR\");\n  if (!config.stderr.write(str)) {\n    throw new WriteError(\"stderr\");\n  }\n}\n\n/**\n * Prints messages and exits with code -1.\n * @param msgs The messages to print.\n */\nexport function fatal(...msgs: any[]) {\n  const str = format(msgs, \"FATAL\");\n  if (!config.stderr.write(str)) {\n    throw new WriteError(\"stderr\");\n  }\n\n  process.exit(-1);\n}\n\nexport * from \"./error\";\n\n/**\n * Formats a list of messages into a single string.\n * @param msgs The messages to format.\n * @param level The log level.\n * @returns A formatted message.\n */\nfunction format(msgs: any[], level: string): string {\n  const timestamp = new Date().toISOString();\n  const msg = msgs\n    .map((m) =>\n      typeof m === \"string\" ? m : JSON.stringify(m, null, config.jsonSpace),\n    )\n    .join(\" \");\n  switch (config.format) {\n    case \"json\":\n      return colorize(\n        JSON.stringify({ timestamp, level, message: msg }) + \"\\n\",\n        level,\n      );\n    case \"text\":\n    default:\n      return colorize(\n        `[${timestamp}] [${(th.symbols as any)[level] ?? level}] ${msg}\\n`,\n        level,\n      );\n  }\n}\n\n/**\n * Wraps a string in ANSI codes, based on a log level.\n * @param str The string to color.\n * @param level The log level.\n * @returns An ANSI-wrapped string.\n */\nfunction colorize(str: string, level: string) {\n  switch (level) {\n    case \"TRACE\":\n      return th.secondary(str);\n    case \"WARN\":\n      return th.warning(str);\n    case \"ERROR\":\n      return th.error(str);\n    case \"FATAL\":\n      return th.styles?.bold ? th.styles.bold(th.error(str)) : th.error(str);\n    case \"INFO\":\n    default:\n      return th.info?.(str) ?? str;\n  }\n}\n","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 } from \"@/color\";\nimport type { Theme } from \"@/theme\";\nimport { setTheme as setPromptTheme } from \"@/prompt\";\nimport { setTheme as setLogTheme } from \"@/log\";\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            setLogTheme(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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"}

package/dist/{index-BYLskLxk.d.mts → index-C0cH9MIP.d.mts}

@@ -1,6 +1,6 @@
-import { n as Theme } from "./index-BtbthYjp.mjs";
-import { t as StandardSchemaV1 } from "./standard-schema-DXS-QnwX.mjs";
-import { i as raw_d_exports } from "./raw-cqTp2vds.mjs";
+import { n as Theme } from "./theme-EERPMtQU.mjs";
+import { t as StandardSchemaV1 } from "./standard-schema-D1sStgzy.mjs";
+import { i as raw_d_exports } from "./raw-BqvlveTU.mjs";
 
 //#region src/prompt/index.d.ts
 declare namespace index_d_exports {
@@ -197,4 +197,4 @@ interface EditorOpts extends BaseOpts<string> {
 declare function editor(opts: EditorOpts): Promise<string>;
 //#endregion
 export { text as _, SearchOpts as a, TextOpts as c, index_d_exports as d, multiselect as f, setTheme as g, select as h, PasswordOpts as i, confirm as l, search as m, ConfirmOpts as n, SelectOption as o, password as p, EditorOpts as r, SelectOpts as s, BaseOpts as t, editor as u };
-//# sourceMappingURL=index-BYLskLxk.d.mts.map
+//# sourceMappingURL=index-C0cH9MIP.d.mts.map

package/dist/{index-ClhbwSD8.d.mts → index-C6iJZTo3.d.mts}

@@ -1,4 +1,4 @@
-import { t as StandardSchemaV1 } from "./standard-schema-DXS-QnwX.mjs";
+import { t as StandardSchemaV1 } from "./standard-schema-D1sStgzy.mjs";
 
 //#region src/input/error.d.ts
 /**
@@ -199,4 +199,4 @@ declare function positional<T extends Kind>(kind: T): Positional<T>;
 declare function argument<T extends Kind>(kind: T): Positional<T>;
 //#endregion
 export { Kind as a, TypeOf as c, index_d_exports as d, option as f, Input as i, argument as l, InputValidationError as m, InferEntry as n, Option as o, positional as p, InferInput as r, Positional as s, BasicKind as t, convert as u };
-//# sourceMappingURL=index-ClhbwSD8.d.mts.map
+//# sourceMappingURL=index-C6iJZTo3.d.mts.map

package/dist/index-CCQ6jz54.d.mts

@@ -0,0 +1,58 @@
+declare namespace index_d_exports {
+  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 };
+}
+/**
+ * If the runtime supports color.
+ */
+declare const supportsColor: boolean;
+/**
+ * Creates a function that wraps a string in ANSI codes.
+ * @param open The opening ANSI code.
+ * @param close The closing ANSI code.
+ * @returns A function that wraps the string in ANSI codes.
+ */
+declare function createAnsiColor(open: number, close: number): (input: any) => string;
+declare const reset: (input: any) => string;
+declare const bold: (input: any) => string;
+declare const dim: (input: any) => string;
+declare const italic: (input: any) => string;
+declare const underline: (input: any) => string;
+declare const overline: (input: any) => string;
+declare const inverse: (input: any) => string;
+declare const hidden: (input: any) => string;
+declare const strikethrough: (input: any) => string;
+declare const black: (input: any) => string;
+declare const red: (input: any) => string;
+declare const green: (input: any) => string;
+declare const yellow: (input: any) => string;
+declare const blue: (input: any) => string;
+declare const magenta: (input: any) => string;
+declare const cyan: (input: any) => string;
+declare const white: (input: any) => string;
+declare const gray: (input: any) => string;
+declare const bgBlack: (input: any) => string;
+declare const bgRed: (input: any) => string;
+declare const bgGreen: (input: any) => string;
+declare const bgYellow: (input: any) => string;
+declare const bgBlue: (input: any) => string;
+declare const bgMagenta: (input: any) => string;
+declare const bgCyan: (input: any) => string;
+declare const bgWhite: (input: any) => string;
+declare const bgGray: (input: any) => string;
+declare const redBright: (input: any) => string;
+declare const greenBright: (input: any) => string;
+declare const yellowBright: (input: any) => string;
+declare const blueBright: (input: any) => string;
+declare const magentaBright: (input: any) => string;
+declare const cyanBright: (input: any) => string;
+declare const whiteBright: (input: any) => string;
+declare const bgRedBright: (input: any) => string;
+declare const bgGreenBright: (input: any) => string;
+declare const bgYellowBright: (input: any) => string;
+declare const bgBlueBright: (input: any) => string;
+declare const bgMagentaBright: (input: any) => string;
+declare const bgCyanBright: (input: any) => string;
+declare const bgWhiteBright: (input: any) => string;
+//#endregion
+export { inverse as A, underline as B, cyanBright as C, greenBright as D, green as E, red as F, whiteBright as H, redBright as I, reset as L, magenta as M, magentaBright as N, hidden as O, overline as P, strikethrough as R, cyan as S, gray 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, index_d_exports 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, dim as w, createAnsiColor as x, blueBright as y, supportsColor as z };
+//# sourceMappingURL=index-CCQ6jz54.d.mts.map

package/dist/{index-Cnx4H4D-.d.mts → index-OUlP1L9o.d.mts}

@@ -1,5 +1,5 @@
-import { n as Theme } from "./index-BtbthYjp.mjs";
-import { i as Input, o as Option, r as InferInput, s as Positional } from "./index-ClhbwSD8.mjs";
+import { n as Theme } from "./theme-EERPMtQU.mjs";
+import { i as Input, o as Option, r as InferInput, s as Positional } from "./index-C6iJZTo3.mjs";
 
 //#region src/command/error.d.ts
 
@@ -313,4 +313,4 @@ declare class Command<T extends Input = Input> {
 }
 //#endregion
 export { ErrorFn as a, ConvokerError as c, MissingRequiredOptionError as d, TooManyArgumentsError as f, CommandAlias as i, HelpAskedError as l, Builder as n, MiddlewareFn as o, UnknownOptionError as p, Command as r, ParseResult as s, ActionFn as t, MissingRequiredArgumentError as u };
-//# sourceMappingURL=index-Cnx4H4D-.d.mts.map
+//# sourceMappingURL=index-OUlP1L9o.d.mts.map

package/dist/index.d.mts

@@ -1,37 +1,92 @@
-import { J as DeepPartial, M as index_d_exports, n as Theme } from "./index-BtbthYjp.mjs";
-import "./standard-schema-DXS-QnwX.mjs";
-import { d as index_d_exports$1 } from "./index-ClhbwSD8.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-Cnx4H4D-.mjs";
-import "./raw-cqTp2vds.mjs";
-import { d as index_d_exports$3 } from "./index-BYLskLxk.mjs";
+import { k as index_d_exports } from "./index-CCQ6jz54.mjs";
+import { i as DeepPartial, n as Theme, r as defineTheme, t as DEFAULT_THEME } from "./theme-EERPMtQU.mjs";
+import "./standard-schema-D1sStgzy.mjs";
+import { d as index_d_exports$1 } from "./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";
+import "./raw-BqvlveTU.mjs";
+import { d as index_d_exports$3 } from "./index-C0cH9MIP.mjs";
 import Stream from "node:stream";
 
 //#region src/log/error.d.ts
+/**
+ * Error for when logs fail to write to stdout/stderr.
+ */
 declare class WriteError extends Error {
+  /**
+   * Creates a new error for stream writes.
+   * @param streamName The name of the stream.
+   */
   constructor(streamName: string);
 }
 declare namespace index_d_exports$2 {
   export { Config, DEFAULT_CONFIG, WriteError, error, fatal, info, setConfig, setTheme, trace, warn };
 }
+/**
+ * Sets the theme for logs.
+ * @param theme The theme to set.
+ */
 declare function setTheme(theme: Theme): void;
+/**
+ * Log configuration.
+ */
 interface Config {
+  /**
+   * The configuration format.
+   */
   format: "text" | "json";
+  /**
+   * Standard output.
+   */
   stdout: Stream.Writable;
+  /**
+   * Standard error output.
+   */
   stderr: Stream.Writable;
+  /**
+   * How much space in the JSON output of objects.
+   * This does not change spacing in JSON logs, only for objects passed into log functions.
+   */
   jsonSpace: number;
 }
+/**
+ * Default log configuration.
+ */
 declare const DEFAULT_CONFIG: Config;
+/**
+ * Sets log configuration.
+ * @param cfg The configuration, optionally including a theme.
+ */
 declare function setConfig({
   theme,
   ...cfg
 }: DeepPartial<Config> & {
   theme?: Theme;
 }): void;
+/**
+ * Prints messages.
+ * @param msgs The messages to print.
+ */
 declare function trace(...msgs: any[]): void;
+/**
+ * Prints messages.
+ * @param msgs The messages to print.
+ */
 declare function info(...msgs: any[]): void;
+/**
+ * Prints warning messages.
+ * @param msgs The messages to print.
+ */
 declare function warn(...msgs: any[]): void;
+/**
+ * Prints error messages.
+ * @param msgs The messages to print.
+ */
 declare function error(...msgs: any[]): void;
+/**
+ * Prints messages and exits with code -1.
+ * @param msgs The messages to print.
+ */
 declare function fatal(...msgs: any[]): void;
 //#endregion
-export { ActionFn, Builder, Command, CommandAlias, ConvokerError, ErrorFn, HelpAskedError, MiddlewareFn, MissingRequiredArgumentError, MissingRequiredOptionError, ParseResult, TooManyArgumentsError, UnknownOptionError, index_d_exports as color, index_d_exports$1 as i, index_d_exports$2 as log, index_d_exports$3 as prompt };
+export { ActionFn, Builder, Command, CommandAlias, ConvokerError, DEFAULT_THEME, ErrorFn, HelpAskedError, MiddlewareFn, MissingRequiredArgumentError, MissingRequiredOptionError, ParseResult, Theme, TooManyArgumentsError, UnknownOptionError, index_d_exports as color, defineTheme, index_d_exports$1 as i, index_d_exports$2 as log, index_d_exports$3 as prompt };
 //# sourceMappingURL=index.d.mts.map