@miyaoka/fsss 0.3.1 → 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/codegen.js

@@ -2,6 +2,7 @@
 import { join as e, relative as t } from "node:path";
 import { mkdir as n, readFile as r, readdir as i, writeFile as a } from "node:fs/promises";
 import { parseArgs as o } from "node:util";
+//#region src/codegen.ts
 var s = "_plugins", c = ".ts", l = /export\s+interface\s+(\w+)/g;
 async function u(t) {
 	let n = [];
@@ -55,3 +56,4 @@ var { values: p } = o({ options: {
 	outDir: { type: "string" }
 } });
 (p.commandsDir === void 0 || p.outDir === void 0) && (console.error("Usage: bun run codegen.ts --commandsDir <path> --outDir <path>"), process.exit(1)), await f(p.commandsDir, p.outDir);
+//#endregion

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;AAkED,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

@@ -2,6 +2,7 @@ import { join as e, relative as t, resolve as n } from "node:path";
 import { ZodBoolean as r, ZodError as i, ZodNumber as a, z as o } from "zod";
 import { readFile as s, readdir as c, stat as l } from "node:fs/promises";
 import { homedir as u } from "node:os";
+//#region src/config.ts
 function d(e) {
 	return typeof e == "object" && !!e;
 }
@@ -37,7 +38,7 @@ function h(t, n) {
 	let r = [];
 	return r.push(e(u(), ".config", t, "config.json")), r.push(e(process.cwd(), `${t}.config.json`)), n !== void 0 && r.push(n), r;
 }
-async function ee(e, t) {
+async function g(e, t) {
 	let n = h(e, t), r;
 	for (let e of n) {
 		let t = await p(e);
@@ -51,124 +52,161 @@ async function ee(e, t) {
 	}
 	return r;
 }
-function g(e, t, n) {
+//#endregion
+//#region src/auto-mapping.ts
+function _(e, t, n) {
 	return [
 		e,
 		...t,
 		n
 	].join("_").toUpperCase();
 }
-function _(e, t) {
+function v(e, t) {
 	return [...e, t].join(".");
 }
-function v(e) {
+//#endregion
+//#region src/zod-utils.ts
+function y(e) {
 	return e instanceof r;
 }
-function te(e) {
+function ee(e) {
 	return e instanceof a;
 }
-var y = "  ", b = 2;
-function x(e, t, n, r) {
+//#endregion
+//#region src/help.ts
+var b = "  ", x = 2;
+function S(e, t, n, r) {
 	if (e.env !== void 0) return e.env;
-	if (t !== void 0) return g(t, n, r);
+	if (t !== void 0) return _(t, n, r);
+}
+function te(e) {
+	switch (typeof e) {
+		case "string":
+		case "number":
+		case "boolean":
+		case "bigint": return String(e);
+		default: return JSON.stringify(e);
+	}
 }
-function S(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: ${String(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 C(e, t, n, r) {
-	let i = v(t.type) ? "" : ` <${e}>`, a = `${t.alias === void 0 ? "    " : `-${t.alias}, `}--${e}${i}`, o = x(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}${S(t, o)}`
+		right: `${t.description}${C(t, o)}`
 	};
 }
-function w() {
+function T() {
 	return {
 		left: "-h, --help",
 		right: "ヘルプを表示する"
 	};
 }
-function T(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];
+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, 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 && l.push("[options]");
+	}
+	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}`);
+			}
 		}
-		n && s.push("[options]");
+		return c.join("\n");
 	}
-	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 = w();
-		return o.push(`${y}${e.left}  ${e.right}`), o.join("\n");
+	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");
 	}
-	o.push("Options:");
-	let l = c.map(([e, t]) => C(e, t, a, n));
-	l.push(w());
-	let u = Math.max(...l.map((e) => e.left.length));
-	for (let e of l) {
-		let t = " ".repeat(u - e.left.length + b);
-		o.push(`${y}${e.left}${t}${e.right}`);
+	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 o.join("\n");
+	return c.join("\n");
 }
-function E(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(`${y}<${e.paramName}>`);
+			i.push(`${b}<${e.paramName}>`);
 			continue;
 		}
-		i.push(`${y}${e.name}`);
+		i.push(`${b}${e.name}`);
 	}
 	return i.join("\n");
 }
-function D(e, t) {
+function O(e, t) {
 	return [
 		`Error: ${t.join(", ")}`,
 		"",
 		e
 	].join("\n");
 }
-function O(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]) => C(e, t, o, r));
-			t.push(w());
-			let n = Math.max(...t.map((e) => e.left.length));
-			for (let e of t) {
-				let t = " ".repeat(n - e.left.length + b);
-				c.push(`${y}${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(`${y}<${e.paramName}>`);
+				u.push(`${b}<${e.paramName}>`);
 				continue;
 			}
 			let t = e.name === n ? " (default)" : "";
-			c.push(`${y}${e.name}${t}`);
+			u.push(`${b}${e.name}${t}`);
 		}
 	}
-	return c.join("\n");
+	return u.join("\n");
 }
-var k = "--", A = "-", ne = "--", re = "--no-", j = "true", M = "false";
-function N(e, t, n) {
+//#endregion
+//#region src/parser.ts
+var k = "--", A = "-", j = "--", M = "--no-", N = "true", ie = "false";
+function P(e, t, n) {
 	let r = e.get(t);
 	if (r) {
 		r.push(n);
@@ -176,51 +214,51 @@ function N(e, t, n) {
 	}
 	e.set(t, [n]);
 }
-function P(e, t) {
+function F(e, t) {
 	return t + 1 >= e.length ? !1 : !e[t + 1].startsWith(A);
 }
-function F(e, t) {
-	let n = new Map(), r = [], i = [], a = 0;
+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)) {
-			N(n, o.slice(5), M), a++;
+		if (o.startsWith(M)) {
+			P(n, o.slice(5), ie), a++;
 			continue;
 		}
 		if (o.startsWith(k) && o.includes("=")) {
 			let e = o.indexOf("=");
-			N(n, o.slice(2, e), o.slice(e + 1)), a++;
+			P(n, o.slice(2, e), o.slice(e + 1)), a++;
 			continue;
 		}
 		if (o.startsWith(k)) {
 			let r = o.slice(2);
 			if (t.booleanFlags.has(r)) {
-				N(n, r, j), a++;
+				P(n, r, N), a++;
 				continue;
 			}
-			if (P(e, a)) {
-				N(n, r, e[a + 1]), a += 2;
+			if (F(e, a)) {
+				P(n, r, e[a + 1]), a += 2;
 				continue;
 			}
 			throw Error(`Flag --${r} requires a value`);
 		}
 		if (o.startsWith(A) && !o.startsWith(k) && o.includes("=")) {
 			let e = o.indexOf("="), r = o.slice(1, e), i = o.slice(e + 1);
-			N(n, t.aliases.get(r) ?? r, i), a++;
+			P(n, t.aliases.get(r) ?? r, i), a++;
 			continue;
 		}
 		if (o.startsWith(A) && !o.startsWith(k)) {
 			let r = o.slice(1), i = t.aliases.get(r) ?? r;
 			if (t.booleanFlags.has(i)) {
-				N(n, i, j), a++;
+				P(n, i, N), a++;
 				continue;
 			}
-			if (P(e, a)) {
-				N(n, i, e[a + 1]), a += 2;
+			if (F(e, a)) {
+				P(n, i, e[a + 1]), a += 2;
 				continue;
 			}
 			throw Error(`Flag -${r} requires a value`);
@@ -233,11 +271,13 @@ function F(e, t) {
 		doubleDashArgs: i
 	};
 }
-var I = "_plugins", L = ".ts";
-function R(e) {
+//#endregion
+//#region src/plugin.ts
+var L = "_plugins", R = ".ts";
+function z(e) {
 	return e;
 }
-async function z(e, t) {
+async function B(e, t) {
 	let n = {}, r = [];
 	for (let i of e) {
 		let e = await i(t);
@@ -248,7 +288,7 @@ async function z(e, t) {
 		middlewares: r
 	};
 }
-function B(e, t) {
+function V(e, t) {
 	let n = t;
 	for (let t = e.length - 1; t >= 0; t--) {
 		let r = e[t], i = n;
@@ -256,29 +296,31 @@ function B(e, t) {
 	}
 	return n;
 }
-async function V(t, n) {
+async function H(t, n) {
 	let r = [];
 	for (let n of t) {
-		let t = e(n, I), i;
+		let t = e(n, L), i;
 		try {
 			i = await c(t, { withFileTypes: !0 });
 		} catch {
 			continue;
 		}
-		let a = i.filter((e) => e.isFile() && e.name.endsWith(L)).sort((e, t) => e.name.localeCompare(t.name));
+		let a = i.filter((e) => e.isFile() && e.name.endsWith(R)).sort((e, t) => e.name.localeCompare(t.name));
 		for (let n of a) {
 			let i = e(t, n.name), a = (await import(i)).default;
 			if (a === void 0) throw Error(`Plugin file ${i} does not have a default export`);
 			r.push(a);
 		}
 	}
-	return z(r, n);
+	return B(r, n);
 }
-function H(e, t, n, r) {
+//#endregion
+//#region src/resolver.ts
+function U(e, t, n, r) {
 	if (e !== void 0) return e;
-	if (t !== void 0) return g(t, n, r);
+	if (t !== void 0) return _(t, n, r);
 }
-function U(e) {
+function W(e) {
 	let { argsDefs: t, parsedTokens: n, env: r, config: i, commandPath: a, envPrefix: o } = e, s = {}, c = 0;
 	for (let [e, l] of Object.entries(t)) {
 		let t = n.flags.get(e);
@@ -294,7 +336,7 @@ function U(e) {
 			s[e] = n.positionals[c], c++;
 			continue;
 		}
-		let u = H(l.env, o, a, e);
+		let u = U(l.env, o, a, e);
 		if (u !== void 0) {
 			let t = r[u];
 			if (t !== void 0) {
@@ -303,7 +345,7 @@ function U(e) {
 			}
 		}
 		if (i !== void 0) {
-			let t = f(i, l.config ?? _(a, e));
+			let t = f(i, l.config ?? v(a, e));
 			if (t !== void 0) {
 				s[e] = t;
 				continue;
@@ -316,29 +358,39 @@ function U(e) {
 	}
 	return s;
 }
-var W = /^\[(.+)]$/, G = ".ts", K = "index", q = "_";
-async function J(e) {
+//#endregion
+//#region src/router.ts
+var G = /^\[(.+)]$/, K = [".ts", ".js"], q = "index", J = "_";
+function Y(e) {
+	return K.find((t) => e.endsWith(t));
+}
+function ae(e, t) {
+	return e.slice(0, -t.length);
+}
+async function oe(e) {
 	try {
 		return (await l(e)).isFile();
 	} catch {
 		return !1;
 	}
 }
-async function Y(e) {
+async function se(e) {
 	try {
-		let t = await c(e, { withFileTypes: !0 }), n = [];
-		for (let e of t) if (!e.name.startsWith(q)) {
-			if (e.isFile() && e.name.endsWith(G)) {
-				let t = e.name.slice(0, -3);
-				if (t === K) continue;
-				n.push({
-					name: t,
+		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 = ae(e.name, t);
+				if (i === q || r.has(i)) continue;
+				r.add(i), n.push({
+					name: i,
 					isDynamic: !1
 				});
 				continue;
 			}
 			if (e.isDirectory()) {
-				let t = e.name.match(W);
+				let t = e.name.match(G);
 				if (t !== null) {
 					n.push({
 						name: e.name,
@@ -363,52 +415,56 @@ async function X(t, r) {
 	for (let t = 0; t < r.length; t++) {
 		let n = r[t];
 		if (n.startsWith("-")) break;
-		let l = await c(i, { withFileTypes: !0 }), u = n + G, d = l.find((e) => e.isFile() && e.name === u);
-		if (d) return s = t + 1, {
+		let l = await c(i, { withFileTypes: !0 }), u = K.reduce((e, t) => e ?? l.find((e) => e.isFile() && e.name === n + t), void 0);
+		if (u) return s = t + 1, {
 			kind: "resolved",
-			filePath: e(i, d.name),
+			filePath: e(i, u.name),
 			params: a,
 			remainingTokens: r.slice(s),
 			traversedDirs: o
 		};
-		let f = l.find((e) => e.isDirectory() && e.name === n);
-		if (f) {
-			i = e(i, f.name), o.push(i), s = t + 1;
+		let d = l.find((e) => e.isDirectory() && e.name === n);
+		if (d) {
+			i = e(i, d.name), o.push(i), s = t + 1;
 			continue;
 		}
-		let p, m = l.find((e) => {
+		let f, p = l.find((e) => {
 			if (!e.isDirectory()) return !1;
-			let t = e.name.match(W);
-			return t === null ? !1 : (p = t[1], !0);
+			let t = e.name.match(G);
+			return t === null ? !1 : (f = t[1], !0);
 		});
-		if (m && p !== void 0) {
-			a[p] = n, i = e(i, m.name), o.push(i), s = t + 1;
+		if (p && f !== void 0) {
+			a[f] = n, i = e(i, p.name), o.push(i), s = t + 1;
 			continue;
 		}
 		break;
 	}
-	let l = e(i, K + G);
-	if (await J(l)) return {
-		kind: "resolved",
-		filePath: l,
-		params: a,
-		remainingTokens: r.slice(s),
-		traversedDirs: o
-	};
-	let u = await Y(i);
+	for (let t of K) {
+		let n = e(i, q + t);
+		if (await oe(n)) return {
+			kind: "resolved",
+			filePath: n,
+			params: a,
+			remainingTokens: r.slice(s),
+			traversedDirs: o
+		};
+	}
+	let l = await se(i);
 	return {
 		kind: "unresolved",
 		stoppedDir: i,
-		availableEntries: u
+		availableEntries: l
 	};
 }
-function ie(e) {
-	return v(e) ? o.preprocess((e) => typeof e == "string" ? e === "true" || e === "1" : e, e) : te(e) ? o.preprocess((e) => typeof e == "string" ? Number(e) : e, e) : e;
+//#endregion
+//#region src/validator.ts
+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 ae(e, t) {
+function le(e, t) {
 	let n = {};
 	for (let [t, r] of Object.entries(e)) {
-		let e = ie(r.type);
+		let e = ce(r.type);
 		if (r.multiple === !0) {
 			n[t] = o.array(e);
 			continue;
@@ -417,10 +473,21 @@ function ae(e, t) {
 	}
 	return o.object(n).parse(t);
 }
-var oe = "commands", se = 2, Z = 1;
-function Q(e) {
-	let t = new Set(), n = new Map();
-	for (let [r, i] of Object.entries(e)) v(i.type) && t.add(r), i.alias !== void 0 && n.set(i.alias, r);
+//#endregion
+//#region src/cli.ts
+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 {
 		booleanFlags: t,
 		aliases: n
@@ -429,11 +496,11 @@ function Q(e) {
 function $(e, r) {
 	return t(n(e), r).replace(/\.ts$/, "").split("/").filter((e) => e !== "index" && !e.startsWith("["));
 }
-function ce(e, r) {
+function me(e, r) {
 	let i = t(n(e), r);
 	return i === "" || i === "." ? [] : i.split("/").filter((e) => !e.startsWith("["));
 }
-function le(e) {
+function he(e) {
 	let t, n = [];
 	for (let r = 0; r < e.length; r++) {
 		let i = e[r];
@@ -454,84 +521,101 @@ function le(e) {
 		remainingTokens: n
 	};
 }
-function ue(e) {
-	let t = e.commandsDir ?? oe, r = e.name, a = e.autoEnv?.prefix, o = e.defaultCommand;
-	async function s() {
-		let { configPath: e, remainingTokens: s } = le(process.argv.slice(se)), 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 = O({
+				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 = E({
-				programName: r,
-				commandPath: ce(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 = T({
+		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 = Q(u), m;
+		let m = pe(d), h;
 		try {
-			let t = F(c.remainingTokens, p), n = await ee(r, e);
-			m = ae(u, U({
-				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(D(f, t)), process.exit(Z);
+				console.error(O(p, t)), process.exit(Z);
 			}
-			throw e instanceof Error && (console.error(D(f, [e.message])), process.exit(Z)), e;
+			throw e instanceof Error && (console.error(O(p, [e.message])), process.exit(Z)), e;
 		}
-		let { extensions: h, middlewares: g } = await V(c.traversedDirs, { cliName: r }), _ = {
-			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 B(g, async (e) => {
-			await l.run({
+		await V(v, async (e) => {
+			await u.run({
 				params: e.params,
 				args: e.args,
 				extensions: e.extensions
 			});
-		})(_);
+		})(y);
 	}
-	return { run: s };
+	return { run: c };
 }
-function de(e) {
+//#endregion
+//#region src/types.ts
+function ve(e) {
 	return e;
 }
-export { ue as createCLI, de as defineCommand, R as definePlugin };
+//#endregion
+export { _e as createCLI, ve as defineCommand, z as definePlugin };

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAQA,UAAU,aAAa;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,WAAW,GAAG,aAAa,GAAG,eAAe,CAAC;AAqDnD,iBAAe,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAmFvF;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAiBA,UAAU,aAAa;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,WAAW,GAAG,aAAa,GAAG,eAAe,CAAC;AAsEnD,iBAAe,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAuFvF;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miyaoka/fsss",
-  "version": "0.3.1",
+  "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",
@@ -38,12 +38,12 @@
   "devDependencies": {
     "@tsconfig/node24": "24.0.4",
     "@types/bun": "1.3.10",
-    "oxfmt": "0.36.0",
-    "oxlint": "1.51.0",
+    "oxfmt": "0.37.0",
+    "oxlint": "1.52.0",
     "oxlint-tsgolint": "0.16.0",
     "typescript": "5.9.3",
     "unplugin-dts": "1.0.0-beta.6",
-    "vite": "8.0.0-beta.16"
+    "vite": "8.0.0-beta.18"
   },
   "scripts": {
     "build": "vite build",