@miyaoka/fsss 0.3.2 → 0.4.0

package/dist/cli.d.ts

@@ -1,16 +1,21 @@
 interface AutoEnvConfig {
     prefix: string;
 }
+interface VersionConfig {
+    number: string;
+    alias?: string | false;
+}
 interface CLIOptions {
     name: string;
     commandsDir?: string;
     autoEnv?: AutoEnvConfig;
     defaultCommand?: string;
+    version?: string | VersionConfig;
 }
 interface CLI {
     run: () => Promise<void>;
 }
 declare function createCLI(options: CLIOptions): CLI;
 export { createCLI };
-export type { CLI, CLIOptions };
+export type { CLI, CLIOptions, VersionConfig };
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAkBA,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,GAAG;IACX,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAgFD,iBAAS,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG,CAgJ3C;AAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAkBA,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACxB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CAClC;AAED,UAAU,GAAG;IACX,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAwGD,iBAAS,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG,CAkK3C;AAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC"}

package/dist/help.d.ts

@@ -6,6 +6,8 @@ interface HelpConfig {
     description?: string;
     argsDefs?: ArgsDefs;
     envPrefix?: string;
+    showVersion: boolean;
+    versionAlias?: string;
 }
 declare function generateHelp(config: HelpConfig): string;
 interface SubcommandHelpConfig {
@@ -22,6 +24,8 @@ interface DefaultCommandHelpConfig {
     description?: string;
     argsDefs?: ArgsDefs;
     envPrefix?: string;
+    showVersion: boolean;
+    versionAlias?: string;
     availableEntries: AvailableEntry[];
 }
 declare function generateDefaultCommandHelp(config: DefaultCommandHelpConfig): string;

package/dist/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAU,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGhD,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgFD,iBAAS,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA8DhD;AAGD,UAAU,oBAAoB;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,iBAAS,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAuBpE;AAID,iBAAS,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAG/E;AAID,UAAU,wBAAwB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,iBAAS,0BAA0B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAiE5E;AAED,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,GAC5B,CAAC;AACF,YAAY,EAAE,wBAAwB,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAU,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGhD,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAwFD,iBAAS,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAkFhD;AAGD,UAAU,oBAAoB;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,iBAAS,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAuBpE;AAID,iBAAS,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAG/E;AAID,UAAU,wBAAwB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,iBAAS,0BAA0B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAkE5E;AAED,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,GAC5B,CAAC;AACF,YAAY,EAAE,wBAAwB,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { createCLI } from './cli';
 export { definePlugin } from './plugin';
 export { defineCommand } from './types';
-export type { CLI, CLIOptions } from './cli';
+export type { CLI, CLIOptions, VersionConfig } from './cli';
 export type { ArgDef, ArgDefBase, ArgsDefs, CommandConfig, Extensions, InferArgs, Middleware, MiddlewareContext, Params, PluginConfig, PluginContext, PluginSetup, RunContext, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAC7C,YAAY,EACV,MAAM,EACN,UAAU,EACV,QAAQ,EACR,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,MAAM,EACN,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC5D,YAAY,EACV,MAAM,EACN,UAAU,EACV,QAAQ,EACR,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,MAAM,EACN,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -69,17 +69,17 @@ function v(e, t) {
 function y(e) {
 	return e instanceof r;
 }
-function b(e) {
+function ee(e) {
 	return e instanceof a;
 }
 //#endregion
 //#region src/help.ts
-var x = "  ", S = 2;
-function C(e, t, n, r) {
+var b = "  ", x = 2;
+function S(e, t, n, r) {
 	if (e.env !== void 0) return e.env;
 	if (t !== void 0) return _(t, n, r);
 }
-function w(e) {
+function te(e) {
 	switch (typeof e) {
 		case "string":
 		case "number":
@@ -88,62 +88,84 @@ function w(e) {
 		default: return JSON.stringify(e);
 	}
 }
-function ee(e, t) {
+function C(e, t) {
 	let n = [];
-	return t !== void 0 && n.push(`env: ${t}`), "default" in e && e.default !== void 0 && n.push(`default: ${w(e.default)}`), n.length === 0 ? "" : ` (${n.join(", ")})`;
+	return t !== void 0 && n.push(`env: ${t}`), "default" in e && e.default !== void 0 && n.push(`default: ${te(e.default)}`), n.length === 0 ? "" : ` (${n.join(", ")})`;
 }
-function T(e, t, n, r) {
-	let i = y(t.type) ? "" : ` <${e}>`, a = `${t.alias === void 0 ? "    " : `-${t.alias}, `}--${e}${i}`, o = C(t, n, r, e);
+function w(e, t, n, r) {
+	let i = y(t.type) ? "" : ` <${e}>`, a = `${t.alias === void 0 ? "    " : `-${t.alias}, `}--${e}${i}`, o = S(t, n, r, e);
 	return {
 		left: a,
-		right: `${t.description}${ee(t, o)}`
+		right: `${t.description}${C(t, o)}`
 	};
 }
-function E() {
+function T() {
 	return {
 		left: "-h, --help",
 		right: "ヘルプを表示する"
 	};
 }
+function E(e) {
+	return {
+		left: `${e === void 0 ? "    " : `-${e}, `}--version`,
+		right: "バージョンを表示する"
+	};
+}
 function D(e) {
-	let { programName: t, commandPath: n, description: r, argsDefs: i, envPrefix: a } = e, o = [];
-	r !== void 0 && (o.push(r), o.push(""));
-	let s = [t, ...n];
+	let { programName: t, commandPath: n, description: r, argsDefs: i, envPrefix: a, showVersion: o, versionAlias: s } = e, c = [];
+	r !== void 0 && (c.push(r), c.push(""));
+	let l = [t, ...n];
 	if (i !== void 0) {
 		let e = Object.entries(i), t = e.some(([, e]) => e.positional === !0), n = e.some(([, e]) => e.positional !== !0);
 		if (t) {
 			let t = e.filter(([, e]) => e.positional === !0).map(([e]) => `<${e}>`);
-			s.push(...t);
+			l.push(...t);
 		}
-		n && s.push("[options]");
+		n && l.push("[options]");
 	}
-	if (o.push(`Usage: ${s.join(" ")}`), o.push(""), i === void 0) return o.join("\n");
-	let c = Object.entries(i).filter(([, e]) => e.positional !== !0);
-	if (c.length === 0) {
-		o.push("Options:");
-		let e = E();
-		return o.push(`${x}${e.left}  ${e.right}`), o.join("\n");
+	if (c.push(`Usage: ${l.join(" ")}`), c.push(""), i === void 0) {
+		if (o) {
+			c.push("Options:");
+			let e = [T(), E(s)], t = Math.max(...e.map((e) => e.left.length));
+			for (let n of e) {
+				let e = " ".repeat(t - n.left.length + x);
+				c.push(`${b}${n.left}${e}${n.right}`);
+			}
+		}
+		return c.join("\n");
 	}
-	o.push("Options:");
-	let l = c.map(([e, t]) => T(e, t, a, n));
-	l.push(E());
-	let u = Math.max(...l.map((e) => e.left.length));
-	for (let e of l) {
-		let t = " ".repeat(u - e.left.length + S);
-		o.push(`${x}${e.left}${t}${e.right}`);
+	let u = Object.entries(i).filter(([, e]) => e.positional !== !0);
+	if (u.length === 0) {
+		c.push("Options:");
+		let e = [T()];
+		o && e.push(E(s));
+		let t = Math.max(...e.map((e) => e.left.length));
+		for (let n of e) {
+			let e = " ".repeat(t - n.left.length + x);
+			c.push(`${b}${n.left}${e}${n.right}`);
+		}
+		return c.join("\n");
 	}
-	return o.join("\n");
+	c.push("Options:");
+	let d = u.map(([e, t]) => w(e, t, a, n));
+	d.push(T()), o && d.push(E(s));
+	let f = Math.max(...d.map((e) => e.left.length));
+	for (let e of d) {
+		let t = " ".repeat(f - e.left.length + x);
+		c.push(`${b}${e.left}${t}${e.right}`);
+	}
+	return c.join("\n");
 }
-function te(e) {
+function ne(e) {
 	let { programName: t, commandPath: n, availableEntries: r } = e, i = [], a = [t, ...n].join(" ");
 	if (i.push(`Usage: ${a} <command>`), i.push(""), r.length === 0) return i.push("No available commands."), i.join("\n");
 	i.push("Available commands:");
 	for (let e of r) {
 		if (e.isDynamic) {
-			i.push(`${x}<${e.paramName}>`);
+			i.push(`${b}<${e.paramName}>`);
 			continue;
 		}
-		i.push(`${x}${e.name}`);
+		i.push(`${b}${e.name}`);
 	}
 	return i.join("\n");
 }
@@ -154,38 +176,36 @@ function O(e, t) {
 		e
 	].join("\n");
 }
-function k(e) {
-	let { programName: t, defaultCommandName: n, commandPath: r, description: i, argsDefs: a, envPrefix: o, availableEntries: s } = e, c = [];
-	if (i !== void 0 && (c.push(i), c.push("")), a !== void 0 && Object.entries(a).some(([, e]) => e.positional !== !0) ? c.push(`Usage: ${t} [options]`) : c.push(`Usage: ${t}`), c.push(`       ${t} <command>`), c.push(""), a !== void 0) {
+function re(e) {
+	let { programName: t, defaultCommandName: n, commandPath: r, description: i, argsDefs: a, envPrefix: o, showVersion: s, versionAlias: c, availableEntries: l } = e, u = [];
+	i !== void 0 && (u.push(i), u.push("")), a !== void 0 && Object.entries(a).some(([, e]) => e.positional !== !0) ? u.push(`Usage: ${t} [options]`) : u.push(`Usage: ${t}`), u.push(`       ${t} <command>`), u.push("");
+	let d = [];
+	if (a !== void 0) {
 		let e = Object.entries(a).filter(([, e]) => e.positional !== !0);
-		if (e.length > 0) {
-			c.push("Options:");
-			let t = e.map(([e, t]) => T(e, t, o, r));
-			t.push(E());
-			let n = Math.max(...t.map((e) => e.left.length));
-			for (let e of t) {
-				let t = " ".repeat(n - e.left.length + S);
-				c.push(`${x}${e.left}${t}${e.right}`);
-			}
-			c.push("");
-		}
+		d.push(...e.map(([e, t]) => w(e, t, o, r)));
+	}
+	d.push(T()), s && d.push(E(c)), u.push("Options:");
+	let f = Math.max(...d.map((e) => e.left.length));
+	for (let e of d) {
+		let t = " ".repeat(f - e.left.length + x);
+		u.push(`${b}${e.left}${t}${e.right}`);
 	}
-	if (s.length > 0) {
-		c.push("Available commands:");
-		for (let e of s) {
+	if (u.push(""), l.length > 0) {
+		u.push("Available commands:");
+		for (let e of l) {
 			if (e.isDynamic) {
-				c.push(`${x}<${e.paramName}>`);
+				u.push(`${b}<${e.paramName}>`);
 				continue;
 			}
 			let t = e.name === n ? " (default)" : "";
-			c.push(`${x}${e.name}${t}`);
+			u.push(`${b}${e.name}${t}`);
 		}
 	}
-	return c.join("\n");
+	return u.join("\n");
 }
 //#endregion
 //#region src/parser.ts
-var A = "--", j = "-", ne = "--", re = "--no-", M = "true", N = "false";
+var k = "--", A = "-", j = "--", M = "--no-", N = "true", ie = "false";
 function P(e, t, n) {
 	let r = e.get(t);
 	if (r) {
@@ -195,29 +215,29 @@ function P(e, t, n) {
 	e.set(t, [n]);
 }
 function F(e, t) {
-	return t + 1 >= e.length ? !1 : !e[t + 1].startsWith(j);
+	return t + 1 >= e.length ? !1 : !e[t + 1].startsWith(A);
 }
 function I(e, t) {
 	let n = /* @__PURE__ */ new Map(), r = [], i = [], a = 0;
 	for (; a < e.length;) {
 		let o = e[a];
-		if (o === ne) {
+		if (o === j) {
 			i = e.slice(a + 1);
 			break;
 		}
-		if (o.startsWith(re)) {
-			P(n, o.slice(5), N), a++;
+		if (o.startsWith(M)) {
+			P(n, o.slice(5), ie), a++;
 			continue;
 		}
-		if (o.startsWith(A) && o.includes("=")) {
+		if (o.startsWith(k) && o.includes("=")) {
 			let e = o.indexOf("=");
 			P(n, o.slice(2, e), o.slice(e + 1)), a++;
 			continue;
 		}
-		if (o.startsWith(A)) {
+		if (o.startsWith(k)) {
 			let r = o.slice(2);
 			if (t.booleanFlags.has(r)) {
-				P(n, r, M), a++;
+				P(n, r, N), a++;
 				continue;
 			}
 			if (F(e, a)) {
@@ -226,15 +246,15 @@ function I(e, t) {
 			}
 			throw Error(`Flag --${r} requires a value`);
 		}
-		if (o.startsWith(j) && !o.startsWith(A) && o.includes("=")) {
+		if (o.startsWith(A) && !o.startsWith(k) && o.includes("=")) {
 			let e = o.indexOf("="), r = o.slice(1, e), i = o.slice(e + 1);
 			P(n, t.aliases.get(r) ?? r, i), a++;
 			continue;
 		}
-		if (o.startsWith(j) && !o.startsWith(A)) {
+		if (o.startsWith(A) && !o.startsWith(k)) {
 			let r = o.slice(1), i = t.aliases.get(r) ?? r;
 			if (t.booleanFlags.has(i)) {
-				P(n, i, M), a++;
+				P(n, i, N), a++;
 				continue;
 			}
 			if (F(e, a)) {
@@ -344,24 +364,24 @@ var G = /^\[(.+)]$/, K = [".ts", ".js"], q = "index", J = "_";
 function Y(e) {
 	return K.find((t) => e.endsWith(t));
 }
-function ie(e, t) {
+function ae(e, t) {
 	return e.slice(0, -t.length);
 }
-async function ae(e) {
+async function oe(e) {
 	try {
 		return (await l(e)).isFile();
 	} catch {
 		return !1;
 	}
 }
-async function oe(e) {
+async function se(e) {
 	try {
 		let t = (await c(e, { withFileTypes: !0 })).toSorted((e, t) => (e.isFile() ? K.indexOf(Y(e.name) ?? "") : -1) - (t.isFile() ? K.indexOf(Y(t.name) ?? "") : -1)), n = [], r = /* @__PURE__ */ new Set();
 		for (let e of t) {
 			if (e.name.startsWith(J)) continue;
 			let t = e.isFile() ? Y(e.name) : void 0;
 			if (t !== void 0) {
-				let i = ie(e.name, t);
+				let i = ae(e.name, t);
 				if (i === q || r.has(i)) continue;
 				r.add(i), n.push({
 					name: i,
@@ -421,7 +441,7 @@ async function X(t, r) {
 	}
 	for (let t of K) {
 		let n = e(i, q + t);
-		if (await ae(n)) return {
+		if (await oe(n)) return {
 			kind: "resolved",
 			filePath: n,
 			params: a,
@@ -429,7 +449,7 @@ async function X(t, r) {
 			traversedDirs: o
 		};
 	}
-	let l = await oe(i);
+	let l = await se(i);
 	return {
 		kind: "unresolved",
 		stoppedDir: i,
@@ -438,13 +458,13 @@ async function X(t, r) {
 }
 //#endregion
 //#region src/validator.ts
-function se(e) {
-	return y(e) ? o.preprocess((e) => typeof e == "string" ? e === "true" || e === "1" : e, e) : b(e) ? o.preprocess((e) => typeof e == "string" ? Number(e) : e, e) : e;
+function ce(e) {
+	return y(e) ? o.preprocess((e) => typeof e == "string" ? e === "true" || e === "1" : e, e) : ee(e) ? o.preprocess((e) => typeof e == "string" ? Number(e) : e, e) : e;
 }
-function ce(e, t) {
+function le(e, t) {
 	let n = {};
 	for (let [t, r] of Object.entries(e)) {
-		let e = se(r.type);
+		let e = ce(r.type);
 		if (r.multiple === !0) {
 			n[t] = o.array(e);
 			continue;
@@ -455,8 +475,17 @@ function ce(e, t) {
 }
 //#endregion
 //#region src/cli.ts
-var le = "commands", Z = 2, Q = 1;
-function ue(e) {
+var ue = "commands", de = 2, Z = 1, Q = "V";
+function fe(e) {
+	return typeof e == "string" ? {
+		number: e,
+		alias: Q
+	} : {
+		number: e.number,
+		alias: e.alias === !1 ? void 0 : e.alias ?? Q
+	};
+}
+function pe(e) {
 	let t = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new Map();
 	for (let [r, i] of Object.entries(e)) y(i.type) && t.add(r), i.alias !== void 0 && n.set(i.alias, r);
 	return {
@@ -467,11 +496,11 @@ function ue(e) {
 function $(e, r) {
 	return t(n(e), r).replace(/\.ts$/, "").split("/").filter((e) => e !== "index" && !e.startsWith("["));
 }
-function de(e, r) {
+function me(e, r) {
 	let i = t(n(e), r);
 	return i === "" || i === "." ? [] : i.split("/").filter((e) => !e.startsWith("["));
 }
-function fe(e) {
+function he(e) {
 	let t, n = [];
 	for (let r = 0; r < e.length; r++) {
 		let i = e[r];
@@ -492,87 +521,101 @@ function fe(e) {
 		remainingTokens: n
 	};
 }
-function pe(e) {
-	let t = e.commandsDir ?? le, r = e.name, a = e.autoEnv?.prefix, o = e.defaultCommand;
-	async function s() {
-		let { configPath: e, remainingTokens: s } = fe(process.argv.slice(Z)), c = await X(t, s);
-		if (c.kind === "unresolved") if (n(c.stoppedDir) === n(t) && o !== void 0) {
-			if (s.includes("--help") || s.includes("-h")) {
-				let e = await X(t, [o]);
+function ge(e, t) {
+	return e.some((e) => e === "--version" || t !== void 0 && e === `-${t}`);
+}
+function _e(e) {
+	let t = e.commandsDir ?? ue, r = e.name, a = e.autoEnv?.prefix, o = e.defaultCommand, s = e.version === void 0 ? void 0 : fe(e.version);
+	async function c() {
+		let { configPath: e, remainingTokens: c } = he(process.argv.slice(de)), l = await X(t, c);
+		if (l.kind === "unresolved") {
+			let e = n(l.stoppedDir) === n(t), i = c.some((e) => !e.startsWith("-"));
+			if (e && !i && s !== void 0 && ge(c, s.alias)) {
+				console.log(s.number);
+				return;
+			}
+			if (e && o !== void 0) {
+				if (c.includes("--help") || c.includes("-h")) {
+					let e = await X(t, [o]);
+					if (e.kind === "unresolved") throw Error(`defaultCommand "${o}" does not match any command file`);
+					let n = (await import(e.filePath)).default, i = n.args ?? {}, c = re({
+						programName: r,
+						defaultCommandName: o,
+						commandPath: $(t, e.filePath),
+						description: n.description,
+						argsDefs: Object.keys(i).length > 0 ? i : void 0,
+						envPrefix: a,
+						showVersion: s !== void 0,
+						versionAlias: s?.alias,
+						availableEntries: l.availableEntries
+					});
+					console.log(c);
+					return;
+				}
+				let e = await X(t, [o, ...c]);
 				if (e.kind === "unresolved") throw Error(`defaultCommand "${o}" does not match any command file`);
-				let n = (await import(e.filePath)).default, i = n.args ?? {}, s = k({
+				l = e;
+			} else {
+				let e = ne({
 					programName: r,
-					defaultCommandName: o,
-					commandPath: $(t, e.filePath),
-					description: n.description,
-					argsDefs: Object.keys(i).length > 0 ? i : void 0,
-					envPrefix: a,
-					availableEntries: c.availableEntries
+					commandPath: me(t, l.stoppedDir),
+					availableEntries: l.availableEntries
 				});
-				console.log(s);
+				console.log(e);
 				return;
 			}
-			let e = await X(t, [o, ...s]);
-			if (e.kind === "unresolved") throw Error(`defaultCommand "${o}" does not match any command file`);
-			c = e;
-		} else {
-			let e = te({
-				programName: r,
-				commandPath: de(t, c.stoppedDir),
-				availableEntries: c.availableEntries
-			});
-			console.log(e);
-			return;
 		}
-		let l = (await import(c.filePath)).default, u = l.args ?? {}, d = $(t, c.filePath), f = D({
+		let u = (await import(l.filePath)).default, d = u.args ?? {}, f = $(t, l.filePath), p = D({
 			programName: r,
-			commandPath: d,
-			description: l.description,
-			argsDefs: Object.keys(u).length > 0 ? u : void 0,
-			envPrefix: a
+			commandPath: f,
+			description: u.description,
+			argsDefs: Object.keys(d).length > 0 ? d : void 0,
+			envPrefix: a,
+			showVersion: s !== void 0,
+			versionAlias: s?.alias
 		});
-		if (c.remainingTokens.includes("--help") || c.remainingTokens.includes("-h")) {
-			console.log(f);
+		if (l.remainingTokens.includes("--help") || l.remainingTokens.includes("-h")) {
+			console.log(p);
 			return;
 		}
-		let p = ue(u), m;
+		let m = pe(d), h;
 		try {
-			let t = I(c.remainingTokens, p), n = await g(r, e);
-			m = ce(u, W({
-				argsDefs: u,
+			let t = I(l.remainingTokens, m), n = await g(r, e);
+			h = le(d, W({
+				argsDefs: d,
 				parsedTokens: t,
 				env: process.env,
 				config: n,
-				commandPath: d,
+				commandPath: f,
 				envPrefix: a
 			}));
 		} catch (e) {
 			if (e instanceof i) {
 				let t = e.issues.map((e) => `${e.path.join(".")}: ${e.message}`);
-				console.error(O(f, t)), process.exit(Q);
+				console.error(O(p, t)), process.exit(Z);
 			}
-			throw e instanceof Error && (console.error(O(f, [e.message])), process.exit(Q)), e;
+			throw e instanceof Error && (console.error(O(p, [e.message])), process.exit(Z)), e;
 		}
-		let { extensions: h, middlewares: _ } = await H(c.traversedDirs, { cliName: r }), v = {
-			commandPath: d,
-			params: c.params,
-			args: m,
-			extensions: h
+		let { extensions: _, middlewares: v } = await H(l.traversedDirs, { cliName: r }), y = {
+			commandPath: f,
+			params: l.params,
+			args: h,
+			extensions: _
 		};
-		await V(_, async (e) => {
-			await l.run({
+		await V(v, async (e) => {
+			await u.run({
 				params: e.params,
 				args: e.args,
 				extensions: e.extensions
 			});
-		})(v);
+		})(y);
 	}
-	return { run: s };
+	return { run: c };
 }
 //#endregion
 //#region src/types.ts
-function me(e) {
+function ve(e) {
 	return e;
 }
 //#endregion
-export { pe as createCLI, me as defineCommand, z as definePlugin };
+export { _e as createCLI, ve as defineCommand, z as definePlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miyaoka/fsss",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "A CLI framework where your file structure becomes your command structure, and a single schema gives you typed values whether they come from flags, env vars, or config files.",
   "type": "module",
   "author": "miyaoka",