@miyaoka/fsss 0.1.0

package/dist/auto-mapping.d.ts

@@ -0,0 +1,4 @@
+declare function deriveEnvName(prefix: string, commandPath: string[], argName: string): string;
+declare function deriveConfigPath(commandPath: string[], argName: string): string;
+export { deriveConfigPath, deriveEnvName };
+//# sourceMappingURL=auto-mapping.d.ts.map

package/dist/auto-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-mapping.d.ts","sourceRoot":"","sources":["../src/auto-mapping.ts"],"names":[],"mappings":"AAIA,iBAAS,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrF;AAMD,iBAAS,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,15 @@
+interface AutoEnvConfig {
+    prefix: string;
+}
+interface CLIOptions {
+    name: string;
+    commandsDir?: string;
+    autoEnv?: AutoEnvConfig;
+}
+interface CLI {
+    run: () => Promise<void>;
+}
+declare function createCLI(options: CLIOptions): CLI;
+export { createCLI };
+export type { CLI, CLIOptions };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAYA,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;CACzB;AAED,UAAU,GAAG;IACX,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAgFD,iBAAS,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG,CA2F3C;AAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+declare function getByDotPath(obj: Record<string, unknown>, path: string): unknown;
+declare function loadConfig(filePath: string): Promise<Record<string, unknown> | undefined>;
+declare function deepMerge(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown>;
+declare function resolveConfigPaths(appName: string, cliConfigPath: string | undefined): string[];
+declare function loadMergedConfig(appName: string, cliConfigPath: string | undefined): Promise<Record<string, unknown> | undefined>;
+export { deepMerge, getByDotPath, loadConfig, loadMergedConfig, resolveConfigPaths };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,iBAAS,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAYzE;AAGD,iBAAe,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAOxF;AAGD,iBAAS,SAAS,CAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAGD,iBAAS,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAexF;AAGD,iBAAe,gBAAgB,CAC7B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAiB9C;AAED,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/help.d.ts

@@ -0,0 +1,20 @@
+import { AvailableEntry } from './router';
+import { ArgsDefs } from './types';
+interface HelpConfig {
+    programName: string;
+    commandPath: string[];
+    description?: string;
+    argsDefs?: ArgsDefs;
+    envPrefix?: string;
+}
+declare function generateHelp(config: HelpConfig): string;
+interface SubcommandHelpConfig {
+    programName: string;
+    commandPath: string[];
+    availableEntries: AvailableEntry[];
+}
+declare function generateSubcommandHelp(config: SubcommandHelpConfig): string;
+declare function generateValidationErrorHelp(helpText: string, errors: string[]): string;
+export { generateHelp, generateSubcommandHelp, generateValidationErrorHelp };
+export type { HelpConfig, SubcommandHelpConfig };
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +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;AAED,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,CAAC;AAC7E,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createCLI } from './cli';
+export { defineCommand } from './types';
+export type { CLI, CLIOptions } from './cli';
+export type { ArgDef, ArgDefBase, ArgsDefs, CommandConfig, InferArgs, Params, RunContext, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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,SAAS,EACT,MAAM,EACN,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,437 @@
+import { join, relative, resolve } from "node:path";
+import { ZodBoolean, ZodError, ZodNumber, z } from "zod";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+function isRecord(e) {
+	return typeof e == "object" && !!e;
+}
+function getByDotPath(e, t) {
+	let n = t.split("."), r = e;
+	for (let e of n) {
+		if (!isRecord(r)) return;
+		r = r[e];
+	}
+	return r;
+}
+async function loadConfig(e) {
+	try {
+		let t = await readFile(e, "utf-8");
+		return JSON.parse(t);
+	} catch {
+		return;
+	}
+}
+function deepMerge(e, t) {
+	let n = { ...e };
+	for (let [e, r] of Object.entries(t)) {
+		let t = n[e];
+		if (isRecord(t) && isRecord(r)) {
+			n[e] = deepMerge(t, r);
+			continue;
+		}
+		n[e] = r;
+	}
+	return n;
+}
+function resolveConfigPaths(t, n) {
+	let r = [];
+	return r.push(join(homedir(), ".config", t, "config.json")), r.push(join(process.cwd(), `${t}.config.json`)), n !== void 0 && r.push(n), r;
+}
+async function loadMergedConfig(e, t) {
+	let n = resolveConfigPaths(e, t), r;
+	for (let e of n) {
+		let t = await loadConfig(e);
+		if (t !== void 0) {
+			if (r === void 0) {
+				r = t;
+				continue;
+			}
+			r = deepMerge(r, t);
+		}
+	}
+	return r;
+}
+function deriveEnvName(e, t, n) {
+	return [
+		e,
+		...t,
+		n
+	].join("_").toUpperCase();
+}
+function deriveConfigPath(e, t) {
+	return [...e, t].join(".");
+}
+function isBooleanSchema(e) {
+	return e instanceof ZodBoolean;
+}
+function isNumberSchema(e) {
+	return e instanceof ZodNumber;
+}
+var INDENT = "  ", COLUMN_GAP = 2;
+function resolveEnvNameForHelp(e, t, n, r) {
+	if (e.env !== void 0) return e.env;
+	if (t !== void 0) return deriveEnvName(t, n, r);
+}
+function formatOptionMeta(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(", ")})`;
+}
+function formatOptionLine(e, t, n, r) {
+	let i = isBooleanSchema(t.type) ? "" : ` <${e}>`, a = `${t.alias === void 0 ? "    " : `-${t.alias}, `}--${e}${i}`, o = resolveEnvNameForHelp(t, n, r, e);
+	return {
+		left: a,
+		right: `${t.description}${formatOptionMeta(t, o)}`
+	};
+}
+function formatHelpLine() {
+	return {
+		left: "-h, --help",
+		right: "ヘルプを表示する"
+	};
+}
+function generateHelp(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];
+	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);
+		}
+		n && s.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 = formatHelpLine();
+		return o.push(`${INDENT}${e.left}  ${e.right}`), o.join("\n");
+	}
+	o.push("Options:");
+	let l = c.map(([e, t]) => formatOptionLine(e, t, a, n));
+	l.push(formatHelpLine());
+	let u = Math.max(...l.map((e) => e.left.length));
+	for (let e of l) {
+		let t = " ".repeat(u - e.left.length + COLUMN_GAP);
+		o.push(`${INDENT}${e.left}${t}${e.right}`);
+	}
+	return o.join("\n");
+}
+function generateSubcommandHelp(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(`${INDENT}<${e.paramName}>`);
+			continue;
+		}
+		i.push(`${INDENT}${e.name}`);
+	}
+	return i.join("\n");
+}
+function generateValidationErrorHelp(e, t) {
+	return [
+		`Error: ${t.join(", ")}`,
+		"",
+		e
+	].join("\n");
+}
+var LONG_FLAG_PREFIX = "--", SHORT_FLAG_PREFIX = "-", DOUBLE_DASH = "--", NEGATION_PREFIX = "--no-", BOOLEAN_TRUE = "true", BOOLEAN_FALSE = "false";
+function addFlag(e, t, n) {
+	let r = e.get(t);
+	if (r) {
+		r.push(n);
+		return;
+	}
+	e.set(t, [n]);
+}
+function isNextTokenAvailable(e, t) {
+	return t + 1 >= e.length ? !1 : !e[t + 1].startsWith(SHORT_FLAG_PREFIX);
+}
+function parseTokens(e, t) {
+	let n = /* @__PURE__ */ new Map(), r = [], i = [], a = 0;
+	for (; a < e.length;) {
+		let o = e[a];
+		if (o === DOUBLE_DASH) {
+			i = e.slice(a + 1);
+			break;
+		}
+		if (o.startsWith(NEGATION_PREFIX)) {
+			addFlag(n, o.slice(5), BOOLEAN_FALSE), a++;
+			continue;
+		}
+		if (o.startsWith(LONG_FLAG_PREFIX) && o.includes("=")) {
+			let e = o.indexOf("=");
+			addFlag(n, o.slice(2, e), o.slice(e + 1)), a++;
+			continue;
+		}
+		if (o.startsWith(LONG_FLAG_PREFIX)) {
+			let r = o.slice(2);
+			if (t.booleanFlags.has(r)) {
+				addFlag(n, r, BOOLEAN_TRUE), a++;
+				continue;
+			}
+			if (isNextTokenAvailable(e, a)) {
+				addFlag(n, r, e[a + 1]), a += 2;
+				continue;
+			}
+			throw Error(`Flag --${r} requires a value`);
+		}
+		if (o.startsWith(SHORT_FLAG_PREFIX) && !o.startsWith(LONG_FLAG_PREFIX) && o.includes("=")) {
+			let e = o.indexOf("="), r = o.slice(1, e), i = o.slice(e + 1);
+			addFlag(n, t.aliases.get(r) ?? r, i), a++;
+			continue;
+		}
+		if (o.startsWith(SHORT_FLAG_PREFIX) && !o.startsWith(LONG_FLAG_PREFIX)) {
+			let r = o.slice(1), i = t.aliases.get(r) ?? r;
+			if (t.booleanFlags.has(i)) {
+				addFlag(n, i, BOOLEAN_TRUE), a++;
+				continue;
+			}
+			if (isNextTokenAvailable(e, a)) {
+				addFlag(n, i, e[a + 1]), a += 2;
+				continue;
+			}
+			throw Error(`Flag -${r} requires a value`);
+		}
+		r.push(o), a++;
+	}
+	return {
+		flags: n,
+		positionals: r,
+		doubleDashArgs: i
+	};
+}
+function resolveEnvName(e, t, n, r) {
+	if (e !== void 0) return e;
+	if (t !== void 0) return deriveEnvName(t, n, r);
+}
+function resolveValues(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);
+		if (t !== void 0) {
+			if (l.multiple === !0) {
+				s[e] = t;
+				continue;
+			}
+			s[e] = t[t.length - 1];
+			continue;
+		}
+		if (l.positional === !0 && c < n.positionals.length) {
+			s[e] = n.positionals[c], c++;
+			continue;
+		}
+		let u = resolveEnvName(l.env, o, a, e);
+		if (u !== void 0) {
+			let t = r[u];
+			if (t !== void 0) {
+				s[e] = t;
+				continue;
+			}
+		}
+		if (i !== void 0) {
+			let t = getByDotPath(i, l.config ?? deriveConfigPath(a, e));
+			if (t !== void 0) {
+				s[e] = t;
+				continue;
+			}
+		}
+		if ("default" in l) {
+			s[e] = l.default;
+			continue;
+		}
+	}
+	return s;
+}
+var DYNAMIC_SEGMENT_PATTERN = /^\[(.+)]$/, COMMAND_FILE_EXTENSION = ".ts", INDEX_FILE_NAME = "index";
+async function fileExists(e) {
+	try {
+		return (await stat(e)).isFile();
+	} catch {
+		return !1;
+	}
+}
+async function listAvailableEntries(e) {
+	try {
+		let t = await readdir(e, { withFileTypes: !0 }), n = [];
+		for (let e of t) {
+			if (e.isFile() && e.name.endsWith(COMMAND_FILE_EXTENSION)) {
+				let t = e.name.slice(0, -3);
+				if (t === INDEX_FILE_NAME) continue;
+				n.push({
+					name: t,
+					isDynamic: !1
+				});
+				continue;
+			}
+			if (e.isDirectory()) {
+				let t = e.name.match(DYNAMIC_SEGMENT_PATTERN);
+				if (t !== null) {
+					n.push({
+						name: e.name,
+						isDynamic: !0,
+						paramName: t[1]
+					});
+					continue;
+				}
+				n.push({
+					name: e.name,
+					isDynamic: !1
+				});
+			}
+		}
+		return n;
+	} catch {
+		return [];
+	}
+}
+async function resolveRoute(t, r) {
+	let i = resolve(t), a = {}, o = 0;
+	for (let t = 0; t < r.length; t++) {
+		let n = r[t];
+		if (n.startsWith("-")) break;
+		let s = await readdir(i, { withFileTypes: !0 }), l = n + COMMAND_FILE_EXTENSION, u = s.find((e) => e.isFile() && e.name === l);
+		if (u) return o = t + 1, {
+			kind: "resolved",
+			filePath: join(i, u.name),
+			params: a,
+			remainingTokens: r.slice(o)
+		};
+		let d = s.find((e) => e.isDirectory() && e.name === n);
+		if (d) {
+			i = join(i, d.name), o = t + 1;
+			continue;
+		}
+		let f, p = s.find((e) => {
+			if (!e.isDirectory()) return !1;
+			let t = e.name.match(DYNAMIC_SEGMENT_PATTERN);
+			return t === null ? !1 : (f = t[1], !0);
+		});
+		if (p && f !== void 0) {
+			a[f] = n, i = join(i, p.name), o = t + 1;
+			continue;
+		}
+		break;
+	}
+	let s = join(i, INDEX_FILE_NAME + COMMAND_FILE_EXTENSION);
+	if (await fileExists(s)) return {
+		kind: "resolved",
+		filePath: s,
+		params: a,
+		remainingTokens: r.slice(o)
+	};
+	let l = await listAvailableEntries(i);
+	return {
+		kind: "unresolved",
+		stoppedDir: i,
+		availableEntries: l
+	};
+}
+function wrapWithStringPreprocess(e) {
+	return isBooleanSchema(e) ? z.preprocess((e) => typeof e == "string" ? e === "true" || e === "1" : e, e) : isNumberSchema(e) ? z.preprocess((e) => typeof e == "string" ? Number(e) : e, e) : e;
+}
+function validateArgs(e, t) {
+	let n = {};
+	for (let [t, r] of Object.entries(e)) {
+		let e = wrapWithStringPreprocess(r.type);
+		if (r.multiple === !0) {
+			n[t] = z.array(e);
+			continue;
+		}
+		n[t] = e;
+	}
+	return z.object(n).parse(t);
+}
+var DEFAULT_COMMANDS_DIR = "commands", ARGV_SKIP = 2, EXIT_CODE_ERROR = 1;
+function buildParserConfig(e) {
+	let t = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new Map();
+	for (let [r, i] of Object.entries(e)) isBooleanSchema(i.type) && t.add(r), i.alias !== void 0 && n.set(i.alias, r);
+	return {
+		booleanFlags: t,
+		aliases: n
+	};
+}
+function extractCommandPath(e, r) {
+	return relative(resolve(e), r).replace(/\.ts$/, "").split("/").filter((e) => e !== "index" && !e.startsWith("["));
+}
+function extractPartialCommandPath(e, r) {
+	let i = relative(resolve(e), r);
+	return i === "" || i === "." ? [] : i.split("/").filter((e) => !e.startsWith("["));
+}
+function extractFrameworkFlags(e) {
+	let t, n = [];
+	for (let r = 0; r < e.length; r++) {
+		let i = e[r];
+		if (i.startsWith("--config=")) {
+			t = i.slice(9);
+			continue;
+		}
+		if (i === "--config" || i === "-c") {
+			let n = e[r + 1];
+			if (n === void 0) throw Error("--config requires a file path");
+			t = n, r++;
+			continue;
+		}
+		n.push(i);
+	}
+	return {
+		configPath: t,
+		remainingTokens: n
+	};
+}
+function createCLI(e) {
+	let t = e.commandsDir ?? DEFAULT_COMMANDS_DIR, n = e.name, r = e.autoEnv?.prefix;
+	async function a() {
+		let { configPath: e, remainingTokens: a } = extractFrameworkFlags(process.argv.slice(ARGV_SKIP)), o = await resolveRoute(t, a);
+		if (o.kind === "unresolved") {
+			let e = generateSubcommandHelp({
+				programName: n,
+				commandPath: extractPartialCommandPath(t, o.stoppedDir),
+				availableEntries: o.availableEntries
+			});
+			console.log(e);
+			return;
+		}
+		let s = (await import(o.filePath)).default, c = s.args ?? {}, l = extractCommandPath(t, o.filePath), u = generateHelp({
+			programName: n,
+			commandPath: l,
+			description: s.description,
+			argsDefs: Object.keys(c).length > 0 ? c : void 0,
+			envPrefix: r
+		});
+		if (o.remainingTokens.includes("--help") || o.remainingTokens.includes("-h")) {
+			console.log(u);
+			return;
+		}
+		let d = buildParserConfig(c), f;
+		try {
+			let t = parseTokens(o.remainingTokens, d), i = await loadMergedConfig(n, e);
+			f = validateArgs(c, resolveValues({
+				argsDefs: c,
+				parsedTokens: t,
+				env: process.env,
+				config: i,
+				commandPath: l,
+				envPrefix: r
+			}));
+		} catch (e) {
+			if (e instanceof ZodError) {
+				let t = e.issues.map((e) => `${e.path.join(".")}: ${e.message}`);
+				console.error(generateValidationErrorHelp(u, t)), process.exit(EXIT_CODE_ERROR);
+			}
+			throw e instanceof Error && (console.error(generateValidationErrorHelp(u, [e.message])), process.exit(EXIT_CODE_ERROR)), e;
+		}
+		await s.run({
+			params: o.params,
+			args: f
+		});
+	}
+	return { run: a };
+}
+function defineCommand(e) {
+	return e;
+}
+export { createCLI, defineCommand };

package/dist/parser.d.ts

@@ -0,0 +1,13 @@
+interface ParsedTokens {
+    flags: Map<string, string[]>;
+    positionals: string[];
+    doubleDashArgs: string[];
+}
+interface ParserConfig {
+    booleanFlags: Set<string>;
+    aliases: Map<string, string>;
+}
+declare function parseTokens(tokens: string[], config: ParserConfig): ParsedTokens;
+export { parseTokens };
+export type { ParsedTokens, ParserConfig };
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,UAAU,YAAY;IACpB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AA0BD,iBAAS,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CA6FzE;AAED,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/resolver.d.ts

@@ -0,0 +1,14 @@
+import { ParsedTokens } from './parser';
+import { ArgsDefs } from './types';
+interface ResolverInput {
+    argsDefs: ArgsDefs;
+    parsedTokens: ParsedTokens;
+    env: Record<string, string | undefined>;
+    config: Record<string, unknown> | undefined;
+    commandPath: string[];
+    envPrefix: string | undefined;
+}
+declare function resolveValues(input: ResolverInput): Record<string, unknown>;
+export { resolveValues };
+export type { ResolverInput };
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,UAAU,aAAa;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAmBD,iBAAS,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0DpE;AAED,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,21 @@
+interface RouteResolved {
+    kind: "resolved";
+    filePath: string;
+    params: Record<string, string>;
+    remainingTokens: string[];
+}
+interface RouteUnresolved {
+    kind: "unresolved";
+    stoppedDir: string;
+    availableEntries: AvailableEntry[];
+}
+interface AvailableEntry {
+    name: string;
+    isDynamic: boolean;
+    paramName?: string;
+}
+type RouteResult = RouteResolved | RouteUnresolved;
+declare function resolveRoute(commandsDir: string, tokens: string[]): Promise<RouteResult>;
+export { resolveRoute };
+export type { AvailableEntry, RouteResolved, RouteResult, RouteUnresolved };
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAOA,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;CAC3B;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;AAgDnD,iBAAe,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CA8EvF;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+import { z, ZodType } from 'zod';
+interface ArgDefBase<T extends ZodType> {
+    type: T;
+    description: string;
+    alias?: string;
+    positional?: boolean;
+    default?: z.output<T>;
+    env?: string;
+    config?: string;
+    multiple?: boolean;
+}
+type ArgDef = ArgDefBase<ZodType>;
+type ArgsDefs = Record<string, ArgDef>;
+type InferArgs<T extends ArgsDefs> = {
+    [K in keyof T]: T[K]["multiple"] extends true ? z.output<T[K]["type"]>[] : z.output<T[K]["type"]>;
+};
+type Params = Record<string, string>;
+interface RunContext<T extends ArgsDefs> {
+    params: Params;
+    args: InferArgs<T>;
+}
+interface CommandConfig<T extends ArgsDefs = ArgsDefs> {
+    description?: string;
+    args?: T;
+    run: (context: RunContext<T>) => void | Promise<void>;
+}
+declare function defineCommand<T extends ArgsDefs>(config: CommandConfig<T>): CommandConfig<T>;
+export { defineCommand };
+export type { ArgDef, ArgDefBase, ArgsDefs, CommandConfig, InferArgs, Params, RunContext };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAItC,UAAU,UAAU,CAAC,CAAC,SAAS,OAAO;IACpC,IAAI,EAAE,CAAC,CAAC;IACR,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAGD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AAGlC,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAIvC,KAAK,SAAS,CAAC,CAAC,SAAS,QAAQ,IAAI;KAClC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CAClG,CAAC;AAMF,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAIrC,UAAU,UAAU,CAAC,CAAC,SAAS,QAAQ;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;CACpB;AAED,UAAU,aAAa,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,GAAG,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAOD,iBAAS,aAAa,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAErF;AAED,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC"}

package/dist/validator.d.ts

@@ -0,0 +1,4 @@
+import { ArgsDefs } from './types';
+declare function validateArgs(argsDefs: ArgsDefs, rawValues: Record<string, unknown>): Record<string, unknown>;
+export { validateArgs };
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA+BxC,iBAAS,YAAY,CACnB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/zod-utils.d.ts

@@ -0,0 +1,5 @@
+import { ZodType } from 'zod';
+declare function isBooleanSchema(schema: ZodType): boolean;
+declare function isNumberSchema(schema: ZodType): boolean;
+export { isBooleanSchema, isNumberSchema };
+//# sourceMappingURL=zod-utils.d.ts.map

package/dist/zod-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-utils.d.ts","sourceRoot":"","sources":["../src/zod-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAM1D,iBAAS,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEjD;AAMD,iBAAS,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEhD;AAED,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@miyaoka/fsss",
+  "version": "0.1.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",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/miyaoka/fsss.git"
+  },
+  "bugs": "https://github.com/miyaoka/fsss/issues",
+  "keywords": [
+    "cli",
+    "framework",
+    "file-based-routing",
+    "zod",
+    "bun",
+    "typescript"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepublishOnly": "vite build",
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "bun test",
+    "typecheck": "tsgo --noEmit",
+    "lint": "oxlint --type-aware .",
+    "fix": "oxlint --type-aware --fix . && oxfmt ."
+  },
+  "dependencies": {
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@tsconfig/node24": "catalog:",
+    "@types/bun": "catalog:",
+    "oxfmt": "catalog:",
+    "oxlint": "catalog:",
+    "oxlint-tsgolint": "catalog:",
+    "typescript": "catalog:",
+    "unplugin-dts": "catalog:",
+    "vite": "catalog:"
+  }
+}