bob-core 3.0.0-beta.1 → 3.0.0-beta.3

package/dist/esm/src/index.js

@@ -67,91 +67,118 @@ var m = class {
 	}
 }, g = class extends Error {
 	$type = "BobError";
-}, _ = class extends g {
+};
+//#endregion
+//#region src/errors/renderError.ts
+function _(t) {
+	return e.bold.yellow(`'${t}'`);
+}
+var te = /\x1b\[[0-9;]*m/g;
+function ne(e) {
+	return e.replace(te, "").length;
+}
+function v(t, n) {
+	let { title: r, details: i, hint: a } = n, o = i && i.length > 0 || a != null, s = e.dim("│"), c = e.dim("└─");
+	if (t.log(""), t.log(`  ${e.red("error:")} ${r}`), o) {
+		if (t.log(`   ${s}`), i && i.length > 0) {
+			let e = i.map(([e]) => ne(e)), n = Math.max(...e);
+			for (let r = 0; r < i.length; r++) {
+				let [a, o] = i[r], c = " ".repeat(n - e[r]);
+				t.log(`   ${s}  ${a}${c}  ${o}`);
+			}
+		}
+		a == null ? t.log(`   ${s}`) : (t.log(`   ${s}`), t.log(`   ${c} try: ${a}`));
+	}
+	t.log("");
+}
+//#endregion
+//#region src/errors/CommandNotFoundError.ts
+var y = class extends g {
 	constructor(e) {
 		super(`Command "${e}" not found.`), this.command = e;
 	}
-	pretty(t) {
-		t.log(""), t.log(`  ${e.bold.white.bgRed(" ERROR ")} Command ${e.bold.yellow(this.command)} not found.`), t.log("");
+	pretty(e) {
+		v(e, { title: `command ${_(this.command)} not found` });
 	}
-}, v = class extends g {
+};
+//#endregion
+//#region src/flags/helpers.ts
+function b(t, n) {
+	let r = "multiple" in n && n.multiple, i = `${e.yellow.bold(t)} is required`;
+	return n.description && (i += `: ${e.gray(`(${n.description})`)}`), i += ` ${e.green(`(${n.type}${r ? "[]" : ""})`)}\n`, i;
+}
+function x(e) {
+	return e == null ? [] : typeof e == "string" ? [e] : e;
+}
+//#endregion
+//#region src/errors/InvalidFlag.ts
+var S = class extends g {
 	constructor(e, t = {}) {
 		super(`Flag ${e} is not recognized`), this.flag = e, this.flagsSchema = t;
 	}
 	pretty(t) {
-		t.log(""), t.log(`  ${e.bold.white.bgRed(" ERROR ")} Flag ${e.bold.yellow(this.flag)} is not recognized.`);
-		let n = Object.entries(this.flagsSchema);
-		if (n.length > 0) {
-			t.log(""), t.log(`  ${e.dim("Available flags:")}`), t.log("");
-			let r = n.map(([e, t]) => {
-				let n = t.alias ? typeof t.alias == "string" ? [t.alias] : t.alias : [], r = t.type === "option" && "options" in t && t.options ? t.options.join(" | ") : t.type;
-				return {
-					nameWithAlias: `--${e}${n.length > 0 ? n.map((e) => `, -${e}`).join("") : ""}`,
-					description: t.description || "",
-					typeDisplay: r
-				};
-			}), i = Math.max(...r.map((e) => e.nameWithAlias.length));
-			for (let n of r) {
-				let r = " ".repeat(i - n.nameWithAlias.length + 2);
-				t.log(`    ${e.green(n.nameWithAlias)}${r}${n.description}  ${e.dim(`(${n.typeDisplay})`)}`);
-			}
-		}
-		t.log("");
+		let n = Object.entries(this.flagsSchema).map(([t, n]) => {
+			let r = x(n.alias), i = `--${t}${r.length > 0 ? r.map((e) => `, -${e}`).join("") : ""}`, a = n.type === "option" && "options" in n && n.options ? n.options.join(" | ") : n.type, o = n.description ?? "", s = o ? `${o} ${e.dim(`(${a})`)}` : e.dim(`(${a})`);
+			return [e.cyan(i), s];
+		});
+		v(t, {
+			title: `flag ${_(this.flag)} is not recognized`,
+			details: n
+		});
 	}
-}, y = class extends g {
+}, C = class extends g {
 	constructor(e) {
 		super(`Argument "${e}" is required.`), this.argument = e;
 	}
-	pretty(t) {
-		t.log(""), t.log(`  ${e.bold.white.bgRed(" ERROR ")} Argument ${e.bold.yellow(this.argument)} is required.`), t.log("");
+	pretty(e) {
+		v(e, { title: `argument ${_(this.argument)} is required` });
 	}
-}, b = class extends g {
+}, w = class extends g {
 	constructor(e) {
 		super(`Flag "${e}" is required.`), this.flag = e;
 	}
-	pretty(t) {
-		t.log(""), t.log(`  ${e.bold.white.bgRed(" ERROR ")} Flag ${e.bold.yellow(this.flag)} is required.`), t.log("");
+	pretty(e) {
+		v(e, { title: `flag ${_(this.flag)} is required` });
 	}
-}, x = class extends g {
+}, T = class extends g {
 	constructor(e, t) {
 		let n = `Argument "${e.arg}" value is invalid.`;
 		e.reason ? n += ` Reason: ${e.reason}` : n += ` Value: "${e.value}"`, super(n), this.detail = e, this.argDefinition = t;
 	}
 	pretty(t) {
 		let n = [];
-		if (this.detail.reason != null && n.push(["Reason", this.detail.reason]), this.detail.value != null && n.push(["Value", e.yellow(this.detail.value)]), this.argDefinition?.help != null && n.push(["Help", e.green(this.argDefinition.help)]), t.log(""), t.log(`  ${e.bold.white.bgRed(" ERROR ")} Argument ${e.bold.yellow(this.detail.arg)} value is invalid.`), n.length > 0) {
-			t.log("");
-			let r = Math.max(...n.map(([e]) => e.length));
-			for (let [i, a] of n) t.log(`  ${" ".repeat(r - i.length)}${e.dim(i)}  ${a}`);
-		}
-		t.log("");
+		this.detail.value != null && n.push([e.dim("value"), e.yellow(`"${this.detail.value}"`)]), this.detail.reason != null && n.push([e.dim("reason"), this.detail.reason]), this.argDefinition?.help != null && n.push([e.dim("help"), e.green(this.argDefinition.help)]), v(t, {
+			title: `argument ${_(this.detail.arg)} is invalid`,
+			details: n
+		});
 	}
-}, S = class extends g {
+}, E = class extends g {
 	constructor(e, t) {
 		let n = `Flag "${e.flag}" value is invalid.`;
 		e.reason ? n += ` Reason: ${e.reason}` : n += ` Value: "${e.value}"`, super(n), this.param = e, this.flagDefinition = t;
 	}
 	pretty(t) {
 		let n = [];
-		if (this.param.reason != null && n.push(["Reason", this.param.reason]), this.param.value != null && n.push(["Value", e.yellow(this.param.value)]), this.flagDefinition?.help != null && n.push(["Help", e.green(this.flagDefinition.help)]), t.log(""), t.log(`  ${e.bold.white.bgRed(" ERROR ")} Flag ${e.bold.yellow(this.param.flag)} value is invalid.`), n.length > 0) {
-			t.log("");
-			let r = Math.max(...n.map(([e]) => e.length));
-			for (let [i, a] of n) t.log(`  ${" ".repeat(r - i.length)}${e.dim(i)}  ${a}`);
-		}
-		t.log("");
+		this.param.value != null && n.push([e.dim("value"), e.yellow(`"${this.param.value}"`)]), this.param.reason != null && n.push([e.dim("reason"), this.param.reason]), this.flagDefinition?.help != null && n.push([e.dim("help"), e.green(this.flagDefinition.help)]), v(t, {
+			title: `flag ${_(this.param.flag)} is invalid`,
+			details: n
+		});
 	}
-}, C = class extends g {
+}, D = class extends g {
 	constructor(e, t) {
 		super(`Too many arguments provided. Expected ${e}, got ${t}.`), this.expected = e, this.received = t;
 	}
 	pretty(t) {
-		t.log(""), t.log(`  ${e.bold.white.bgRed(" ERROR ")} Too many arguments. Expected ${e.bold.yellow(String(this.expected))}, got ${e.bold.yellow(String(this.received))}.`), t.log("");
+		v(t, {
+			title: "too many arguments",
+			details: [[e.dim("expected"), e.green(String(this.expected))], [e.dim("received"), e.bold.yellow(String(this.received))]]
+		});
 	}
-}, w = class extends Error {
+}, O = class extends Error {
 	constructor(e) {
 		super(e);
 	}
-}, T = class {
+}, k = class {
 	flags;
 	parsedFlags = null;
 	args;
@@ -179,7 +206,7 @@ var m = class {
 	}
 	async setFlag(e, t) {
 		if (!this.parsedFlags) throw Error("Flags have not been parsed yet. Call init() first.");
-		if (!(e in this.flags)) throw new v(e, this.flags);
+		if (!(e in this.flags)) throw new S(e, this.flags);
 		this.parsedFlags[e] = t;
 	}
 	argument(e, t) {
@@ -188,7 +215,7 @@ var m = class {
 	}
 	async setArgument(e, t) {
 		if (!this.parsedArgs) throw Error("Arguments have not been parsed yet. Call init() first.");
-		if (!(e in this.args)) throw new x({
+		if (!(e in this.args)) throw new T({
 			arg: e,
 			reason: `Argument "${e}" is not recognized`
 		});
@@ -204,7 +231,7 @@ var m = class {
 			let n = this.flags[e], r = Array.isArray(n.alias) ? n.alias : n.alias ? [n.alias] : [];
 			for (let e of r) t.add(e);
 		}
-		for (let n in e) if (!t.has(n)) throw new v(n, this.flags);
+		for (let n in e) if (!t.has(n)) throw new S(n, this.flags);
 	}
 	async handleOptions(e) {
 		let t = {};
@@ -221,7 +248,7 @@ var m = class {
 			}
 			t[e] = await this.parseValue(n.shift(), r, "arg", { name: e });
 		}
-		if (this.shouldRejectExtraArguments && n.length > 0) throw new C(r, r + n.length);
+		if (this.shouldRejectExtraArguments && n.length > 0) throw new D(r, r + n.length);
 		return t;
 	}
 	async resolveFlagValue(e, t, n) {
@@ -249,20 +276,20 @@ var m = class {
 			ux: this.ux,
 			ctx: this.opts.ctx,
 			definition: t,
-			cmd: this.opts.cmd ?? Z
+			cmd: this.opts.cmd ?? X
 		};
 	}
 	async safeParse(e, t, n, r) {
 		try {
 			return t.parse(e, this.buildOpts(r?.name ?? "", t));
 		} catch (t) {
-			if (t instanceof S || t instanceof x || !r) throw t;
+			if (t instanceof E || t instanceof T || !r) throw t;
 			let i = t instanceof Error ? t.message : String(t);
-			throw n === "flag" ? new S({
+			throw n === "flag" ? new E({
 				flag: r.name,
 				value: e,
 				reason: i
-			}) : new x({
+			}) : new T({
 				arg: r.name,
 				value: e,
 				reason: i
@@ -273,10 +300,10 @@ var m = class {
 		for (let r in e) {
 			let i = e[r], a = t?.[r], o = this.isEmptyValue(a);
 			if (i.required && o) {
-				if (!this.shouldPromptForMissingFlags) throw n === "flag" ? new b(r) : new y(r);
+				if (!this.shouldPromptForMissingFlags) throw n === "flag" ? new w(r) : new C(r);
 				let e = await this.promptFor(r, i);
 				if (e != null && t) a = await this.parseValue(e, i, n, { name: r }), t[r] = a;
-				else throw n === "flag" ? new b(r) : new y(r);
+				else throw n === "flag" ? new w(r) : new C(r);
 			}
 		}
 	}
@@ -295,92 +322,88 @@ var m = class {
 };
 //#endregion
 //#region src/flags/custom.ts
-function E(e) {
-	return (t) => ({
-		type: "custom",
-		default: e?.multiple || t?.multiple ? [] : null,
-		parse: (e) => e,
-		...e,
-		...t
-	});
-}
-//#endregion
-//#region src/flags/helpers.ts
-function D(t, n) {
-	let r = "multiple" in n && n.multiple, i = `${e.yellow.bold(t)} is required`;
-	return n.description && (i += `: ${e.gray(`(${n.description})`)}`), i += ` ${e.green(`(${n.type}${r ? "[]" : ""})`)}\n`, i;
+function A(e) {
+	function t(t) {
+		return {
+			type: "custom",
+			default: e?.multiple || t?.multiple ? [] : null,
+			...e,
+			...t
+		};
+	}
+	return t;
 }
 //#endregion
 //#region src/shared/parsers.ts
-function te(e) {
+function re(e) {
 	if (typeof e == "boolean") throw Error(`Expected a string, got boolean "${e}"`);
 	return String(e);
 }
-function ne(e, t) {
+function ie(e, t) {
 	let n = typeof e == "number" ? e : Number(e);
-	if (isNaN(n)) throw new w("must be a valid number");
-	if (t?.min !== void 0 && n < t.min) throw new w(`is below minimum ${t.min}`);
-	if (t?.max !== void 0 && n > t.max) throw new w(`exceeds maximum ${t.max}`);
+	if (isNaN(n)) throw new O("must be a valid number");
+	if (t?.min !== void 0 && n < t.min) throw new O(`is below minimum ${t.min}`);
+	if (t?.max !== void 0 && n > t.max) throw new O(`exceeds maximum ${t.max}`);
 	return n;
 }
-function re(e) {
+function ae(e) {
 	if (typeof e == "boolean") return e;
 	let t = String(e).toLowerCase();
 	if (t === "true" || t === "1") return !0;
 	if (t === "false" || t === "0") return !1;
-	throw new w(`Invalid boolean value: "${e}". Expected true, false, 1, or 0.`);
+	throw new O(`Invalid boolean value: "${e}". Expected true, false, 1, or 0.`);
 }
-function ie(e, t) {
+function oe(e, t) {
 	let n = String(e);
-	if (!t.includes(n)) throw new w(`must be one of: ${t.map((e) => `"${e}"`).join(", ")}`);
+	if (!t.includes(n)) throw new O(`must be one of: ${t.map((e) => `"${e}"`).join(", ")}`);
 	return n;
 }
-function ae(e, n) {
+function se(e, n) {
 	let r = String(e);
-	if (n?.exists && !t.existsSync(r)) throw new w("file does not exist");
+	if (n?.exists && !t.existsSync(r)) throw new O("file does not exist");
 	return r;
 }
-function oe(e, n) {
+function ce(e, n) {
 	let r = String(e);
 	if (n?.exists) try {
-		if (!t.lstatSync(r).isDirectory()) throw new w("directory does not exist");
+		if (!t.lstatSync(r).isDirectory()) throw new O("directory does not exist");
 	} catch (e) {
-		throw e instanceof w ? e : new w("directory does not exist");
+		throw e instanceof O ? e : new O("directory does not exist");
 	}
 	return r;
 }
-function se(e) {
+function le(e) {
 	try {
 		return new URL(String(e));
 	} catch {
-		throw new w(`Invalid URL: "${e}"`);
+		throw new O(`Invalid URL: "${e}"`);
 	}
 }
 //#endregion
 //#region src/flags/boolean.ts
-var ce = E({
+var ue = A({
 	default: !1,
-	parse: (e) => re(e),
+	parse: (e) => ae(e),
 	ask: async (e) => {
-		let t = D(e.name, e.definition);
+		let t = b(e.name, e.definition);
 		return await e.ux.askForToggle(t);
 	},
 	type: "boolean"
 });
 //#endregion
 //#region src/shared/ask-helpers.ts
-function O(e, t) {
+function j(e, t) {
 	return (n) => {
 		if ((n == null || typeof n == "string" && n.trim() === "") && e.required) return "This value is required";
 		try {
 			e.parse(n, t);
 		} catch (e) {
-			return e instanceof w ? e.message : "Invalid value";
+			return e instanceof O ? e.message : "Invalid value";
 		}
 		return !0;
 	};
 }
-function k(e, t) {
+function M(e, t) {
 	return (n) => {
 		if ((n == null || n.trim() === "") && e.required) return "Please enter at least one value";
 		for (let r of n.split(",")) {
@@ -388,36 +411,36 @@ function k(e, t) {
 			if (n !== "") try {
 				e.parse(n, t);
 			} catch (e) {
-				return e instanceof w ? `"${n}": ${e.message}` : `"${n}": Invalid value`;
+				return e instanceof O ? `"${n}": ${e.message}` : `"${n}": Invalid value`;
 			}
 		}
 		return !0;
 	};
 }
-async function le(e) {
-	let t = e.definition, n = "multiple" in t && t.multiple, r = D(e.name, t);
+async function de(e) {
+	let t = e.definition, n = "multiple" in t && t.multiple, r = b(e.name, t);
 	return n ? await e.ux.askForList(r + "Please provide one or more values, separated by commas:\n", {
 		separator: ",",
-		validate: k(t, e)
-	}) : "secret" in t && t.secret ? e.ux.askForPassword(r, { validate: O(t, e) }) : await e.ux.askForInput(r, { validate: O(t, e) });
+		validate: M(t, e)
+	}) : "secret" in t && t.secret ? e.ux.askForPassword(r, { validate: j(t, e) }) : await e.ux.askForInput(r, { validate: j(t, e) });
 }
-async function ue(e) {
-	let t = e.definition, n = "multiple" in t && t.multiple, r = D(e.name, t);
+async function fe(e) {
+	let t = e.definition, n = "multiple" in t && t.multiple, r = b(e.name, t);
 	return n ? await e.ux.askForList(r + "Please provide one or more values, separated by commas:\n", {
 		separator: ",",
-		validate: k(t, e)
+		validate: M(t, e)
 	}) : await e.ux.askForNumber(r, { validate: (n) => {
 		if (n === void 0 && t.required) return "This value is required";
 		if (n !== void 0) try {
 			t.parse(String(n), e);
 		} catch (e) {
-			return e instanceof w ? e.message : "Invalid value";
+			return e instanceof O ? e.message : "Invalid value";
 		}
 		return !0;
 	} });
 }
-async function de(e) {
-	let t = e.definition, n = "multiple" in t && t.multiple, r = D(e.name, t);
+async function pe(e) {
+	let t = e.definition, n = "multiple" in t && t.multiple, r = b(e.name, t);
 	if (t.type !== "option") return null;
 	let i = t.options.map((e) => ({
 		name: e,
@@ -425,86 +448,86 @@ async function de(e) {
 	}));
 	return n ? await e.ux.askForCheckbox(r, i) : await e.ux.askForSelect(r, i);
 }
-async function fe(e) {
-	let t = D(e.name, e.definition);
+async function me(e) {
+	let t = b(e.name, e.definition);
 	return e.ux.askForFile(t, { basePath: process.cwd() });
 }
-async function pe(e) {
-	let t = D(e.name, e.definition);
+async function he(e) {
+	let t = b(e.name, e.definition);
 	return e.ux.askForDirectory(t, { basePath: process.cwd() });
 }
-async function me(e) {
-	let t = D(e.name, e.definition);
-	return await e.ux.askForInput(t, { validate: O(e.definition, e) });
+async function ge(e) {
+	let t = b(e.name, e.definition);
+	return await e.ux.askForInput(t, { validate: j(e.definition, e) });
 }
 //#endregion
 //#region src/flags/directory.ts
-var A = E({
-	parse: (e, t) => oe(e, { exists: t.definition.exists }),
-	ask: pe,
+var N = A({
+	parse: (e, t) => ce(e, { exists: t.definition.exists }),
+	ask: he,
 	type: "directory"
-}), j = E({
-	parse: (e, t) => ae(e, { exists: t.definition.exists }),
-	ask: fe,
+}), P = A({
+	parse: (e, t) => se(e, { exists: t.definition.exists }),
+	ask: me,
 	type: "file"
-}), M = E({
-	parse: (e, t) => ne(e, {
+}), F = A({
+	parse: (e, t) => ie(e, {
 		min: t.definition.min,
 		max: t.definition.max
 	}),
-	ask: ue,
+	ask: fe,
 	type: "number"
 });
 //#endregion
 //#region src/flags/option.ts
-function N(e) {
-	return E({
-		parse: (e, t) => ie(e, t.definition.options),
-		ask: de,
+function I(e) {
+	return A({
+		parse: (e, t) => oe(e, t.definition.options),
+		ask: pe,
 		...e,
 		type: "option"
 	})();
 }
 //#endregion
 //#region src/flags/string.ts
-var P = E({
-	parse: (e) => te(e),
-	ask: le,
+var L = A({
+	parse: (e) => re(e),
+	ask: de,
 	type: "string"
-}), F = E({
-	parse: (e) => se(e),
-	ask: me,
+}), R = A({
+	parse: (e) => le(e),
+	ask: ge,
 	type: "url"
-}), I = {
-	string: P,
-	number: M,
-	option: N,
-	file: j,
-	directory: A,
-	url: F,
-	custom: E
-}, L = {
-	string: P,
-	number: M,
-	boolean: ce,
-	option: N,
-	file: j,
-	directory: A,
-	url: F,
-	custom: E
+}), z = {
+	string: L,
+	number: F,
+	option: I,
+	file: P,
+	directory: N,
+	url: R,
+	custom: A
+}, B = {
+	string: L,
+	number: F,
+	boolean: ue,
+	option: I,
+	file: P,
+	directory: N,
+	url: R,
+	custom: A
 };
 //#endregion
 //#region src/lib/string.ts
-function R(e) {
+function V(e) {
 	return Array(e + 5).join(" ");
 }
 //#endregion
 //#region src/options/HelpOption.ts
-function he(e) {
+function _e(e) {
 	let t = e.type;
 	return t === "option" && "options" in e && e.options ? `enum: ${e.options.join("|")}` : t ?? "custom";
 }
-var z = L.boolean({
+var H = B.boolean({
 	alias: ["h"],
 	handler: (t, n) => {
 		if (!t) return { shouldStop: !1 };
@@ -512,7 +535,7 @@ var z = L.boolean({
 			...r.baseFlags,
 			...r.flags
 		}, o = Object.entries(i), s = Object.entries(a), c = s.map(([e, t]) => {
-			let n = Array.isArray(t.alias) ? t.alias : t.alias ? [t.alias] : [];
+			let n = x(t.alias);
 			return {
 				name: e,
 				...t,
@@ -524,7 +547,7 @@ var z = L.boolean({
 		if (o.length > 0) {
 			console.log(`\n${e.yellow("Arguments")}:`);
 			for (let [t, n] of o) {
-				let r = R(f - t.length), i = `  ${e.green(t)} ${r} ${n.description ?? "\b"}`;
+				let r = V(f - t.length), i = `  ${e.green(t)} ${r} ${n.description ?? "\b"}`;
 				if (n.default !== void 0 && !n.required) {
 					let t = typeof n.default == "function" ? "[function]" : n.multiple ? JSON.stringify(n.default) : n.default;
 					i += ` ${e.yellow(`[default: ${t}]`)}`;
@@ -535,8 +558,8 @@ var z = L.boolean({
 		if (s.length > 0) {
 			console.log(`\n${e.yellow("Options")}:`);
 			for (let t of c) {
-				let n = R(f - t.flagWithAlias.length), r = `  ${e.green(t.flagWithAlias)} ${n} ${t.description ?? "\b"}`;
-				if (t.type && (r += ` ${e.white(`(${he(t)})`)}`), t.default !== void 0 && !t.required) {
+				let n = V(f - t.flagWithAlias.length), r = `  ${e.green(t.flagWithAlias)} ${n} ${t.description ?? "\b"}`;
+				if (t.type && (r += ` ${e.white(`(${_e(t)})`)}`), t.default !== void 0 && !t.required) {
 					let n = typeof t.default == "function" ? "(function)" : t.default;
 					r += ` ${e.yellow(`[default: ${n}]`)}`;
 				}
@@ -552,22 +575,22 @@ var z = L.boolean({
 		}
 		return { shouldStop: !0 };
 	}
-}), ge = class extends Error {
+}), ve = class extends Error {
 	name = "ExitPromptError";
 };
 //#endregion
 //#region src/ux/helpers.ts
-async function B(e, t) {
+async function U(e, t) {
 	try {
 		return await e();
 	} catch (e) {
-		if (e instanceof ge || e instanceof Error && e.name === "ExitPromptError") return t;
+		if (e instanceof ve || e instanceof Error && e.name === "ExitPromptError") return t;
 		throw e;
 	}
 }
 //#endregion
 //#region src/ux/askForCheckbox.ts
-async function V(e, t, n) {
+async function W(e, t, n) {
 	if (t.length === 0) throw Error("No options provided");
 	let r = t.map((e) => typeof e == "string" ? {
 		name: e,
@@ -579,7 +602,7 @@ async function V(e, t, n) {
 		checked: e.checked,
 		description: e.description
 	});
-	return B(() => i({
+	return U(() => i({
 		message: e,
 		choices: r,
 		required: n?.required,
@@ -591,8 +614,8 @@ async function V(e, t, n) {
 }
 //#endregion
 //#region src/ux/askForConfirmation.ts
-async function H(e = "Do you want to continue?", t) {
-	return B(() => a({
+async function G(e = "Do you want to continue?", t) {
+	return U(() => a({
 		message: e,
 		default: t?.default ?? !1,
 		transformer: t?.transformer
@@ -600,8 +623,8 @@ async function H(e = "Do you want to continue?", t) {
 }
 //#endregion
 //#region src/ux/askForEditor.ts
-async function U(e, t) {
-	return B(() => o({
+async function K(e, t) {
+	return U(() => o({
 		message: e,
 		default: t?.default,
 		postfix: t?.postfix,
@@ -611,8 +634,8 @@ async function U(e, t) {
 }
 //#endregion
 //#region src/ux/askForExpand.ts
-async function W(e, t, n) {
-	return B(() => s({
+async function q(e, t, n) {
+	return U(() => s({
 		message: e,
 		choices: t,
 		default: n?.default
@@ -620,8 +643,8 @@ async function W(e, t, n) {
 }
 //#endregion
 //#region src/ux/askForFileSelector.ts
-async function G(e, t) {
-	return B(async () => {
+async function J(e, t) {
+	return U(async () => {
 		let n = await ee({
 			message: e,
 			basePath: t?.basePath,
@@ -636,8 +659,8 @@ async function G(e, t) {
 }
 //#endregion
 //#region src/ux/askForInput.ts
-async function K(e, t) {
-	return B(() => c({
+async function ye(e, t) {
+	return U(() => c({
 		message: e,
 		default: t?.default,
 		required: t?.required,
@@ -647,9 +670,9 @@ async function K(e, t) {
 }
 //#endregion
 //#region src/ux/askForList.ts
-async function q(e, t) {
+async function be(e, t) {
 	let n = t?.separator ?? ",";
-	return B(async () => (await c({
+	return U(async () => (await c({
 		message: e,
 		default: t?.default,
 		validate: t?.validate
@@ -657,8 +680,8 @@ async function q(e, t) {
 }
 //#endregion
 //#region src/ux/askForNumber.ts
-async function J(e, t) {
-	return B(async () => await l({
+async function xe(e, t) {
+	return U(async () => await l({
 		message: e,
 		default: t?.default,
 		required: t?.required,
@@ -670,8 +693,8 @@ async function J(e, t) {
 }
 //#endregion
 //#region src/ux/askForPassword.ts
-async function _e(e, t) {
-	return B(() => u({
+async function Se(e, t) {
+	return U(() => u({
 		message: e,
 		mask: t?.mask,
 		validate: t?.validate
@@ -679,8 +702,8 @@ async function _e(e, t) {
 }
 //#endregion
 //#region src/ux/askForRawList.ts
-async function ve(e, t, n) {
-	return B(() => d({
+async function Ce(e, t, n) {
+	return U(() => d({
 		message: e,
 		choices: t,
 		loop: n?.loop
@@ -688,8 +711,8 @@ async function ve(e, t, n) {
 }
 //#endregion
 //#region src/ux/askForSearch.ts
-async function ye(e, t, n) {
-	return B(() => f({
+async function we(e, t, n) {
+	return U(() => f({
 		message: e,
 		source: t,
 		pageSize: n?.pageSize,
@@ -698,13 +721,13 @@ async function ye(e, t, n) {
 }
 //#endregion
 //#region src/ux/askForSelect.ts
-async function be(e, t, n) {
+async function Te(e, t, n) {
 	if (t.length === 0) throw Error("No options provided");
 	let r = t.map((e) => typeof e == "string" ? {
 		name: e,
 		value: e
 	} : e);
-	return B(() => p({
+	return U(() => p({
 		message: e,
 		choices: r,
 		default: n?.default,
@@ -714,9 +737,9 @@ async function be(e, t, n) {
 }
 //#endregion
 //#region src/ux/askForToggle.ts
-async function Y(e, t) {
+async function Ee(e, t) {
 	let n = t?.active ?? "Yes", r = t?.inactive ?? "No";
-	return B(() => a({
+	return U(() => a({
 		message: e,
 		default: t?.default ?? !1,
 		transformer: (e) => e ? n : r
@@ -724,7 +747,7 @@ async function Y(e, t) {
 }
 //#endregion
 //#region src/ux/keyValue.ts
-function xe(t, n) {
+function De(t, n) {
 	let r = n?.separator ?? ": ", i = n?.keyStyle ?? e.bold, a = Array.isArray(t) ? t : Object.entries(t);
 	if (a.length === 0) return;
 	let o = Math.max(...a.map(([e]) => e.length));
@@ -732,7 +755,7 @@ function xe(t, n) {
 }
 //#endregion
 //#region src/ux/loader.ts
-function Se(e = "", t = [
+function Oe(e = "", t = [
 	"⠙",
 	"⠘",
 	"⠰",
@@ -744,23 +767,30 @@ function Se(e = "", t = [
 	"⠋",
 	"⠉"
 ], n = 100) {
-	let r = e, i = null, a = 0, o = setInterval(function() {
-		i &&= (process.stdout.write("\r" + " ".repeat(i.length + 5) + "\r"), null), process.stdout.write("\r" + t[a++] + " " + r), a %= t.length;
-	}, n), s = () => {
-		clearInterval(o), process.stdout.write("\r" + " ".repeat(r.length + 5) + "\r");
+	let r = e, i = null, a = e.length, o = 0, s = (e) => {
+		let t = process.stdout.columns || 80, n = e + 2, r = Math.max(1, Math.ceil(n / t));
+		if (process.stdout.isTTY && process.stdout.clearLine && process.stdout.moveCursor) {
+			r > 1 && process.stdout.moveCursor(0, -(r - 1));
+			for (let e = 0; e < r; e++) process.stdout.cursorTo(0), process.stdout.clearLine(1), e < r - 1 && process.stdout.moveCursor(0, 1);
+			r > 1 && process.stdout.moveCursor(0, -(r - 1)), process.stdout.cursorTo(0);
+		} else process.stdout.write("\r" + " ".repeat(e + 5) + "\r");
+	}, c = setInterval(function() {
+		i !== null && (s(Math.max(i.length, r.length)), i = null), process.stdout.write("\r" + t[o++] + " " + r), o %= t.length;
+	}, n), l = () => {
+		clearInterval(c), s(a);
 	};
 	return {
-		[Symbol.dispose]: s,
-		[Symbol.asyncDispose]: s,
+		[Symbol.dispose]: l,
+		[Symbol.asyncDispose]: l,
 		updateText: (e) => {
-			i = r, r = e;
+			i = r, r = e, a = Math.max(a, e.length);
 		},
-		stop: s
+		stop: l
 	};
 }
 //#endregion
 //#region src/ux/progressBar.ts
-function Ce(e, t) {
+function ke(e, t) {
 	let n = t?.width ?? 30, r = t?.completeChar ?? "█", i = t?.incompleteChar ?? "░", a = 0, o = !1, s = () => {
 		if (o) return;
 		let t = e <= 0 ? 1 : Math.min(a / e, 1), s = Math.round(t * n), c = `${r.repeat(s) + i.repeat(n - s)}  ${Math.round(t * 100)}%  ${a}/${e}`;
@@ -782,7 +812,7 @@ function Ce(e, t) {
 }
 //#endregion
 //#region src/ux/table.ts
-function we(t, n) {
+function Ae(t, n) {
 	if (t.length === 0) return;
 	let r = n ?? Object.keys(t[0]).map((e) => ({ key: e })), i = r.map((e) => e.header ?? e.key.toUpperCase()), a = r.map((e, n) => {
 		let r = Math.max(i[n].length, ...t.map((t) => (e.format ? e.format(t[e.key]) : String(t[e.key] ?? "")).length));
@@ -808,71 +838,71 @@ function we(t, n) {
 }
 //#endregion
 //#region src/ux/index.ts
-var X = class {
+var Y = class {
 	askForConfirmation(e, t) {
-		return H(e, t);
+		return G(e, t);
 	}
 	askForInput(e, t) {
-		return K(e, t);
+		return ye(e, t);
 	}
 	askForPassword(e, t) {
-		return _e(e, t);
+		return Se(e, t);
 	}
 	askForNumber(e, t) {
-		return J(e, t);
+		return xe(e, t);
 	}
 	askForSelect(e, t, n) {
-		return be(e, t, n);
+		return Te(e, t, n);
 	}
 	askForCheckbox(e, t, n) {
-		return V(e, t, n);
+		return W(e, t, n);
 	}
 	askForSearch(e, t, n) {
-		return ye(e, t, n);
+		return we(e, t, n);
 	}
 	askForList(e, t) {
-		return q(e, t);
+		return be(e, t);
 	}
 	askForToggle(e, t) {
-		return Y(e, t);
+		return Ee(e, t);
 	}
 	askForEditor(e, t) {
-		return U(e, t);
+		return K(e, t);
 	}
 	askForRawList(e, t, n) {
-		return ve(e, t, n);
+		return Ce(e, t, n);
 	}
 	askForExpand(e, t, n) {
-		return W(e, t, n);
+		return q(e, t, n);
 	}
 	askForFile(e, t) {
-		return G(e, {
+		return J(e, {
 			...t,
 			type: "file"
 		});
 	}
 	askForDirectory(e, t) {
-		return G(e, {
+		return J(e, {
 			...t,
 			type: "directory"
 		});
 	}
 	askForFileSelector(e, t) {
-		return G(e, t);
+		return J(e, t);
 	}
 	keyValue(e, t) {
-		return xe(e, t);
+		return De(e, t);
 	}
 	table(e, t) {
-		return we(e, t);
+		return Ae(e, t);
 	}
 	newProgressBar(e, t) {
-		return Ce(e, t);
+		return ke(e, t);
 	}
 	newLoader(e, t, n) {
-		return Se(e, t, n);
+		return Oe(e, t, n);
 	}
-}, Z = class {
+}, X = class {
 	static $type = "BobCommand";
 	static command = "";
 	static description = "";
@@ -890,9 +920,9 @@ var X = class {
 	logger;
 	ux;
 	parser;
-	static baseFlags = { help: z };
+	static baseFlags = { help: H };
 	newCommandParser(e) {
-		return new T({
+		return new k({
 			ux: e.ux,
 			ctx: e.ctx,
 			flags: e.flags,
@@ -901,7 +931,7 @@ var X = class {
 		});
 	}
 	newUX() {
-		return new X();
+		return new Y();
 	}
 	async run(e) {
 		let t = this.constructor;
@@ -950,22 +980,22 @@ var X = class {
 };
 //#endregion
 //#region src/lib/helpers.ts
-function Te(e) {
+function je(e) {
 	return typeof e == "object" && !!e && "$type" in e && e.$type === "BobError";
 }
-function Q(e) {
-	return typeof e == "function" ? e.prototype instanceof Z || e.$type === "BobCommand" : !1;
+function Z(e) {
+	return typeof e == "function" ? e.prototype instanceof X || e.$type === "BobCommand" : !1;
 }
 //#endregion
 //#region src/CommandRegistry.ts
-var Ee = class {
+var Q = class {
 	commands = {};
 	aliases = {};
 	ux;
 	logger;
 	stringSimilarity;
 	constructor(e) {
-		this.logger = e?.logger ?? new m(), this.ux = e?.ux ?? new X(), this.stringSimilarity = e?.stringSimilarity ?? new h();
+		this.logger = e?.logger ?? new m(), this.ux = e?.ux ?? new Y(), this.stringSimilarity = e?.stringSimilarity ?? new h();
 	}
 	getAvailableCommands() {
 		return [...Object.keys(this.commands), ...Object.keys(this.aliases)];
@@ -976,7 +1006,7 @@ var Ee = class {
 	importFile = async (e) => (await import(e)).default;
 	commandResolver = async (e) => {
 		let t = await this.importFile(e);
-		return t ? (t && typeof t == "object" && "default" in t && (t = t.default), typeof t == "function" && Q(t) ? t : null) : null;
+		return t ? (t && typeof t == "object" && "default" in t && (t = t.default), typeof t == "function" && Z(t) ? t : null) : null;
 	};
 	withCommandResolver(e) {
 		return this.commandResolver = e, this;
@@ -985,7 +1015,7 @@ var Ee = class {
 		return this.importFile = e, this;
 	}
 	registerCommand(e, t = !1) {
-		if (!Q(e)) throw Error("Invalid command, it must extend the Command class.");
+		if (!Z(e)) throw Error("Invalid command, it must extend the Command class.");
 		let n = e.command;
 		if (!n) throw Error(`Cannot register a command with no name. ${e.name} `);
 		if (!t && this.commands[n]) throw Error(`Command ${n} already registered.`);
@@ -1000,7 +1030,7 @@ var Ee = class {
 	async loadCommandsPath(e) {
 		for await (let t of this.listCommandsFiles(e)) try {
 			let e = await this.commandResolver(t);
-			Q(e) && this.registerCommand(e);
+			Z(e) && this.registerCommand(e);
 		} catch (e) {
 			throw Error(`Command ${t} failed to load. ${e}`, { cause: e });
 		}
@@ -1012,10 +1042,10 @@ var Ee = class {
 			if (!i) {
 				let r = await this.suggestCommand(t);
 				if (r) return await this.runCommand(e, r, ...n);
-				throw new _(t);
+				throw new y(t);
 			}
 			r = new i();
-		} else r = Q(t) ? new t() : t;
+		} else r = Z(t) ? new t() : t;
 		return await r.run({
 			ctx: e,
 			logger: this.logger,
@@ -1028,15 +1058,11 @@ var Ee = class {
 			let e = n[i];
 			return await this.askRunSimilarCommand(t, e) ? e : null;
 		}
-		if (o.length) {
-			this.logger.error(`${e.bgRed(" ERROR ")} Command ${e.yellow(t)} not found.\n`);
-			let n = await this.ux.askForSelect(e.green("Did you mean to run one of these commands instead?"), o);
-			if (n) return n;
-		}
-		throw new _(t);
+		if (o.length) return await this.ux.askForSelect(`${e.red("unknown command")} ${e.bold.yellow(`'${t}'`)} ${e.dim("—")} did you mean one of these?`, o) || null;
+		throw new y(t);
 	}
 	async askRunSimilarCommand(t, n) {
-		return this.logger.error(`${e.bgRed(" ERROR ")} Command ${e.yellow(t)} not found.\n`), this.ux.askForConfirmation(`${e.green(`Do you want to run ${e.yellow(n)} instead?`)} `);
+		return this.ux.askForConfirmation(`${e.red("unknown command")} ${e.bold.yellow(`'${t}'`)} ${e.dim("—")} did you mean ${e.bold.green(`'${n}'`)}?`);
 	}
 	async *listCommandsFiles(e) {
 		let r = await t.promises.readdir(e, { withFileTypes: !0 });
@@ -1049,23 +1075,25 @@ var Ee = class {
 			}
 		}
 	}
-}, De = class {
+}, Me = class {
 	logger;
 	constructor(e) {
 		this.logger = e;
 	}
 	handle(e) {
-		if (Te(e)) return e.pretty(this.logger), -1;
+		if (je(e)) return e.pretty(this.logger), -1;
 		throw e;
 	}
-}, Oe = class extends Z {
+}, Ne, Pe = class extends X {
 	static command = "help";
 	static description = e.bold("Show help information about the CLI and its commands");
 	constructor(e) {
 		super(), this.opts = e;
 	}
 	async handle() {
-		let t = this.opts.commandRegistry.getCommands().filter((e) => !e.hidden), n = this.opts.cliName ?? "Bob CLI", r = this.opts.cliVersion ?? "0.0.0", i = (await import("../package-BNru0kNU.js"))?.default?.version ?? "0.0.0";
+		let t = this.opts.commandRegistry.getCommands().filter((e) => !e.hidden), n = this.opts.cliName ?? "Bob CLI", r = this.opts.cliVersion ?? "0.0.0";
+		Ne ??= (await import("../package-DtqoIUbm.js"))?.default?.version ?? "0.0.0";
+		let i = Ne;
 		this.logger.log(`${n} ${e.green(r)} (core: ${e.yellow(i)})
 
 ${e.yellow("Usage")}:
@@ -1087,25 +1115,25 @@ ${e.yellow("Available commands")}:
 			r && this.logger.log(e.yellow(`${t}:`));
 			let i = n.sort((e, t) => e.command.toLowerCase().localeCompare(t.command.toLowerCase()));
 			for (let t of i) {
-				let n = t.aliases.length > 0 ? e.gray(` (${t.aliases.join(", ")})`) : "", i = R(a - (t.command.length + (t.aliases.length > 0 ? ` (${t.aliases.join(", ")})`.length : 0)));
+				let n = t.aliases.length > 0 ? e.gray(` (${t.aliases.join(", ")})`) : "", i = V(a - (t.command.length + (t.aliases.length > 0 ? ` (${t.aliases.join(", ")})`.length : 0)));
 				r && (i = i.slice(2)), this.logger.log(`${r ? "  " : ""}${e.green(t.command)}${n} ${i} ${t.description}`);
 			}
 		}
 	}
-}, ke = class {
+}, Fe = class {
 	ctx;
 	logger;
 	commandRegistry;
 	exceptionHandler;
 	helpCommand;
 	newCommandRegistry(e) {
-		return new Ee(e);
+		return new Q(e);
 	}
 	newHelpCommand(e) {
-		return new Oe(e);
+		return new Pe(e);
 	}
 	newExceptionHandler(e) {
-		return new De(e.logger);
+		return new Me(e.logger);
 	}
 	constructor(e = {}) {
 		this.ctx = e.ctx, this.logger = e.logger ?? new m(), this.commandRegistry = this.newCommandRegistry({ logger: this.logger }), this.exceptionHandler = this.newExceptionHandler({ logger: this.logger }), this.helpCommand = this.newHelpCommand({
@@ -1163,27 +1191,27 @@ ${e.yellow("Available commands")}:
 		}
 		n.startsWith("--") && (r = !0, n = n.slice(2)), n.endsWith("?") && (l = !1, n = n.slice(0, -1)), n.endsWith("*") && (c = !0, a = [], n = n.slice(0, -1)), i = i ?? t[n] ?? t[`--${n}`];
 		let u;
-		return u = r ? s ? L.boolean({
+		return u = r ? s ? B.boolean({
 			description: i,
 			alias: o,
 			...a === void 0 ? {} : { default: a }
-		}) : c ? L.string({
+		}) : c ? B.string({
 			description: i,
 			alias: o,
 			multiple: !0,
 			...l ? { required: !0 } : {},
 			default: a ?? []
-		}) : L.string({
+		}) : B.string({
 			description: i,
 			alias: o,
 			...l ? { required: !0 } : {},
 			...a === void 0 ? {} : { default: a }
-		}) : c ? I.string({
+		}) : c ? z.string({
 			description: i,
 			multiple: !0,
 			...l ? { required: !0 } : {},
 			default: a ?? []
-		}) : I.string({
+		}) : z.string({
 			description: i,
 			...l ? { required: !0 } : {},
 			...a === void 0 ? {} : { default: a }
@@ -1193,7 +1221,7 @@ ${e.yellow("Available commands")}:
 			definition: u
 		};
 	}
-}, Ae = class extends Z {
+}, Ie = class extends X {
 	static signature = "";
 	static helperDefinitions = {};
 	static get command() {
@@ -1221,4 +1249,4 @@ ${e.yellow("Available commands")}:
 	}
 };
 //#endregion
-export { I as Args, x as BadCommandArgument, S as BadCommandFlag, g as BobError, ke as Cli, Z as Command, _ as CommandNotFoundError, T as CommandParser, Ee as CommandRegistry, $ as CommandSignatureParser, Ae as CommandWithSignature, De as ExceptionHandler, L as Flags, z as HelpCommandFlag, v as InvalidFlag, m as Logger, y as MissingRequiredArgumentValue, b as MissingRequiredFlagValue, h as StringSimilarity, C as TooManyArguments, X as UX, w as ValidationError, V as askForCheckbox, H as askForConfirmation, U as askForEditor, W as askForExpand, G as askForFileSelector, K as askForInput, q as askForList, J as askForNumber, _e as askForPassword, ve as askForRawList, ye as askForSearch, be as askForSelect, Y as askForToggle, xe as keyValue, Se as newLoader, Ce as newProgressBar, we as table, B as withCancelHandling };
+export { z as Args, T as BadCommandArgument, E as BadCommandFlag, g as BobError, Fe as Cli, X as Command, y as CommandNotFoundError, k as CommandParser, Q as CommandRegistry, $ as CommandSignatureParser, Ie as CommandWithSignature, Me as ExceptionHandler, B as Flags, H as HelpCommandFlag, S as InvalidFlag, m as Logger, C as MissingRequiredArgumentValue, w as MissingRequiredFlagValue, h as StringSimilarity, D as TooManyArguments, Y as UX, O as ValidationError, W as askForCheckbox, G as askForConfirmation, K as askForEditor, q as askForExpand, J as askForFileSelector, ye as askForInput, be as askForList, xe as askForNumber, Se as askForPassword, Ce as askForRawList, we as askForSearch, Te as askForSelect, Ee as askForToggle, De as keyValue, Oe as newLoader, ke as newProgressBar, Ae as table, U as withCancelHandling };