@miyaoka/fsss 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,117 @@
+# fsss
+
+[![npm version](https://img.shields.io/npm/v/@miyaoka/fsss)](https://www.npmjs.com/package/@miyaoka/fsss)
+[![npm downloads](https://img.shields.io/npm/dm/@miyaoka/fsss)](https://www.npmjs.com/package/@miyaoka/fsss)
+[![license](https://img.shields.io/npm/l/@miyaoka/fsss)](https://github.com/miyaoka/fsss/blob/main/LICENSE)
+
+**fsss** — "File Structure, Single Schema" — bun + TypeScript + Zod
+
+> ファイル構造がそのままコマンド構造になり、スキーマを一回書けば CLI フラグ・環境変数・設定ファイルのどこから値が来ても同じように型付きで受け取れる CLI フレームワーク
+>
+> _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._
+
+## File Structure — ファイルを置くだけでコマンドが生える
+
+```
+commands/
+  serve.ts              → my-app serve
+  config/
+    set.ts              → my-app config set
+    get.ts              → my-app config get
+  remote/
+    [name]/
+      push.ts           → my-app remote origin push
+```
+
+ファイルを置くだけでコマンドが生える。ディレクトリのネストがサブコマンドの階層になる。`[name]` は動的セグメントで、`params.name` として値を受け取れる。
+
+## Single Schema — 1つの定義で CLI / env / config を統合
+
+```ts
+// commands/serve.ts
+export default defineCommand({
+  description: "サーバーを起動する",
+  args: {
+    port: {
+      type: z.coerce.number().min(1).max(65535),
+      description: "ポート番号",
+      alias: "p",
+      default: 3000,
+    },
+    host: {
+      type: z.string(),
+      description: "ホスト名",
+      default: "localhost",
+    },
+  },
+  run({ args }) {
+    // args.port: number, args.host: string — 型推論される
+    console.log(`${args.host}:${args.port}`);
+  },
+});
+```
+
+この1つの定義だけで、CLI フラグ・環境変数・設定ファイル・デフォルト値のすべてが統合される。
+
+```
+CLI flag        my-app serve --port 8080           ← 最優先
+env             MYAPP_SERVE_PORT=5000              ← prefix + コマンドパス + arg 名で自動導出
+config file     { "serve": { "port": 4000 } }     ← コマンドツリーと同じ構造
+default         3000
+```
+
+どのソースから来た値も、最終的に同じ Zod スキーマでバリデーションされる。
+
+### 環境変数の自動マッピング
+
+`autoEnv` を指定すると、コマンドパス + arg 名から環境変数名を自動導出する。
+
+```ts
+const cli = createCLI({
+  name: "my-app",
+  autoEnv: { prefix: "MYAPP" },
+});
+```
+
+| コマンド      | arg     | 自動導出される env 名     |
+| ------------- | ------- | ------------------------- |
+| `serve`       | `port`  | `MYAPP_SERVE_PORT`        |
+| `remote push` | `force` | `MYAPP_REMOTE_PUSH_FORCE` |
+
+### 設定ファイルの自動マッピング
+
+config ファイルの JSON 構造はコマンドツリーと一致する。
+
+```json
+{
+  "serve": { "port": 5000, "host": "0.0.0.0" },
+  "remote": { "push": { "force": true } }
+}
+```
+
+```
+my-app --config app.json serve
+```
+
+### ヘルプ自動生成
+
+```
+$ my-app serve --help
+
+サーバーを起動する
+
+Usage: my-app serve [options]
+
+Options:
+  -p, --port <port>  ポート番号 (env: MYAPP_SERVE_PORT, default: 3000)
+      --host <host>  ホスト名 (env: MYAPP_SERVE_HOST, default: localhost)
+  -h, --help         ヘルプを表示する
+```
+
+## ドキュメント
+
+- [ファイルベースルーティング](docs/routing.md) — コマンドツリー、動的セグメント、params と args の分離
+- [スキーマと値の解決](docs/schema.md) — defineCommand、args 定義、値の優先順位、ヘルプ生成
+- [設定ファイルと環境変数](docs/config.md) — autoEnv、config ファイル階層、`--config` フラグ
+- [内部アーキテクチャ](docs/architecture.md) — パイプライン設計、各モジュールの責務、処理トレース
+- [既存ツールとの比較](docs/comparison.md) — commander / oclif / Pastel / Gud CLI / convict との比較

package/dist/cli.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,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,CA4G3C;AAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC"}

package/dist/codegen.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":""}

package/dist/codegen.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { join, relative } from "node:path";
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { parseArgs } from "node:util";
+var PLUGINS_DIR_NAME = "_plugins", PLUGIN_FILE_EXTENSION = ".ts", INTERFACE_NAME_PATTERN = /export\s+interface\s+(\w+)/g;
+async function findAllPluginFiles(t) {
+	let n = [];
+	async function r(t) {
+		let a = await readdir(t, { withFileTypes: !0 });
+		for (let o of a) {
+			if (!o.isDirectory()) continue;
+			let a = join(t, o.name);
+			if (o.name === PLUGINS_DIR_NAME) {
+				let t = await readdir(a, { withFileTypes: !0 });
+				for (let r of t) r.isFile() && r.name.endsWith(PLUGIN_FILE_EXTENSION) && n.push(join(a, r.name));
+				continue;
+			}
+			await r(a);
+		}
+	}
+	return await r(t), n.sort();
+}
+async function extractInterfaceNames(e) {
+	let t = await readFile(e, "utf-8"), n = [], i = INTERFACE_NAME_PATTERN.exec(t);
+	for (; i !== null;) n.push(i[1]), i = INTERFACE_NAME_PATTERN.exec(t);
+	return n;
+}
+async function generateExtensionsType(r, i) {
+	let o = await findAllPluginFiles(r), s = [];
+	for (let e of o) {
+		let n = await extractInterfaceNames(e);
+		if (n.length === 0) continue;
+		let r = relative(i, e).replace(/\.ts$/, ""), a = r.startsWith(".") ? r : `./${r}`;
+		s.push({
+			importPath: a,
+			interfaceNames: n
+		});
+	}
+	let c = ["// このファイルは自動生成されます。手動で編集しないでください。"];
+	if (s.length === 0) c.push("", "declare module \"@miyaoka/fsss\" {", "  // eslint-disable-next-line @typescript-eslint/no-empty-object-type", "  interface Extensions {}", "}", "");
+	else {
+		for (let e of s) {
+			let t = e.interfaceNames.join(", ");
+			c.push(`import type { ${t} } from "${e.importPath}";`);
+		}
+		let e = s.flatMap((e) => e.interfaceNames);
+		c.push("", "declare module \"@miyaoka/fsss\" {", `  interface Extensions extends ${e.join(", ")} {}`, "}", "");
+	}
+	await mkdir(i, { recursive: !0 });
+	let l = join(i, "extensions.d.ts");
+	await writeFile(l, c.join("\n"), "utf-8"), console.log(`Generated ${l}`);
+}
+var { values } = parseArgs({ options: {
+	commandsDir: { type: "string" },
+	outDir: { type: "string" }
+} });
+(values.commandsDir === void 0 || values.outDir === void 0) && (console.error("Usage: bun run codegen.ts --commandsDir <path> --outDir <path>"), process.exit(1)), await generateExtensionsType(values.commandsDir, values.outDir);

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { createCLI } from './cli';
+export { definePlugin } from './plugin';
 export { defineCommand } from './types';
 export type { CLI, CLIOptions } from './cli';
-export type { ArgDef, ArgDefBase, ArgsDefs, CommandConfig, InferArgs, Params, RunContext, } from './types';
+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,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"}
+{"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"}

package/dist/index.js

@@ -204,6 +204,47 @@ function parseTokens(e, t) {
 		doubleDashArgs: i
 	};
 }
+var PLUGINS_DIR_NAME = "_plugins", PLUGIN_FILE_EXTENSION = ".ts";
+function definePlugin(e) {
+	return e;
+}
+async function resolvePlugins(e, t) {
+	let n = {}, r = [];
+	for (let i of e) {
+		let e = await i(t);
+		e.provide !== void 0 && Object.assign(n, e.provide), e.middleware !== void 0 && r.push(e.middleware);
+	}
+	return {
+		extensions: n,
+		middlewares: r
+	};
+}
+function buildMiddlewareChain(e, t) {
+	let n = t;
+	for (let t = e.length - 1; t >= 0; t--) {
+		let r = e[t], i = n;
+		n = (e) => r(e, () => i(e));
+	}
+	return n;
+}
+async function scanPluginsAlongPath(t, n) {
+	let r = [];
+	for (let n of t) {
+		let t = join(n, PLUGINS_DIR_NAME), i;
+		try {
+			i = await readdir(t, { withFileTypes: !0 });
+		} catch {
+			continue;
+		}
+		let a = i.filter((e) => e.isFile() && e.name.endsWith(PLUGIN_FILE_EXTENSION)).sort((e, t) => e.name.localeCompare(t.name));
+		for (let n of a) {
+			let i = join(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 resolvePlugins(r, n);
+}
 function resolveEnvName(e, t, n, r) {
 	if (e !== void 0) return e;
 	if (t !== void 0) return deriveEnvName(t, n, r);
@@ -246,7 +287,7 @@ function resolveValues(e) {
 	}
 	return s;
 }
-var DYNAMIC_SEGMENT_PATTERN = /^\[(.+)]$/, COMMAND_FILE_EXTENSION = ".ts", INDEX_FILE_NAME = "index";
+var DYNAMIC_SEGMENT_PATTERN = /^\[(.+)]$/, COMMAND_FILE_EXTENSION = ".ts", INDEX_FILE_NAME = "index", INTERNAL_PREFIX = "_";
 async function fileExists(e) {
 	try {
 		return (await stat(e)).isFile();
@@ -257,7 +298,7 @@ async function fileExists(e) {
 async function listAvailableEntries(e) {
 	try {
 		let t = await readdir(e, { withFileTypes: !0 }), n = [];
-		for (let e of t) {
+		for (let e of t) if (!e.name.startsWith(INTERNAL_PREFIX)) {
 			if (e.isFile() && e.name.endsWith(COMMAND_FILE_EXTENSION)) {
 				let t = e.name.slice(0, -3);
 				if (t === INDEX_FILE_NAME) continue;
@@ -289,45 +330,47 @@ async function listAvailableEntries(e) {
 	}
 }
 async function resolveRoute(t, r) {
-	let i = resolve(t), a = {}, o = 0;
+	let i = resolve(t), a = {}, o = [i], s = 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, {
+		let l = await readdir(i, { withFileTypes: !0 }), u = n + COMMAND_FILE_EXTENSION, d = l.find((e) => e.isFile() && e.name === u);
+		if (d) return s = t + 1, {
 			kind: "resolved",
-			filePath: join(i, u.name),
+			filePath: join(i, d.name),
 			params: a,
-			remainingTokens: r.slice(o)
+			remainingTokens: r.slice(s),
+			traversedDirs: o
 		};
-		let d = s.find((e) => e.isDirectory() && e.name === n);
-		if (d) {
-			i = join(i, d.name), o = t + 1;
+		let f = l.find((e) => e.isDirectory() && e.name === n);
+		if (f) {
+			i = join(i, f.name), o.push(i), s = t + 1;
 			continue;
 		}
-		let f, p = s.find((e) => {
+		let p, m = l.find((e) => {
 			if (!e.isDirectory()) return !1;
 			let t = e.name.match(DYNAMIC_SEGMENT_PATTERN);
-			return t === null ? !1 : (f = t[1], !0);
+			return t === null ? !1 : (p = t[1], !0);
 		});
-		if (p && f !== void 0) {
-			a[f] = n, i = join(i, p.name), o = t + 1;
+		if (m && p !== void 0) {
+			a[p] = n, i = join(i, m.name), o.push(i), s = t + 1;
 			continue;
 		}
 		break;
 	}
-	let s = join(i, INDEX_FILE_NAME + COMMAND_FILE_EXTENSION);
-	if (await fileExists(s)) return {
+	let l = join(i, INDEX_FILE_NAME + COMMAND_FILE_EXTENSION);
+	if (await fileExists(l)) return {
 		kind: "resolved",
-		filePath: s,
+		filePath: l,
 		params: a,
-		remainingTokens: r.slice(o)
+		remainingTokens: r.slice(s),
+		traversedDirs: o
 	};
-	let l = await listAvailableEntries(i);
+	let u = await listAvailableEntries(i);
 	return {
 		kind: "unresolved",
 		stoppedDir: i,
-		availableEntries: l
+		availableEntries: u
 	};
 }
 function wrapWithStringPreprocess(e) {
@@ -424,14 +467,23 @@ function createCLI(e) {
 			}
 			throw e instanceof Error && (console.error(generateValidationErrorHelp(u, [e.message])), process.exit(EXIT_CODE_ERROR)), e;
 		}
-		await s.run({
+		let { extensions: p, middlewares: m } = await scanPluginsAlongPath(o.traversedDirs, { cliName: n }), h = {
+			commandPath: l,
 			params: o.params,
-			args: f
-		});
+			args: f,
+			extensions: p
+		};
+		await buildMiddlewareChain(m, async (e) => {
+			await s.run({
+				params: e.params,
+				args: e.args,
+				extensions: e.extensions
+			});
+		})(h);
 	}
 	return { run: a };
 }
 function defineCommand(e) {
 	return e;
 }
-export { createCLI, defineCommand };
+export { createCLI, defineCommand, definePlugin };

package/dist/plugin.d.ts

@@ -0,0 +1,12 @@
+import { Extensions, Middleware, MiddlewareContext, PluginContext, PluginSetup } from './types';
+interface ResolvedPlugins {
+    extensions: Extensions;
+    middlewares: Middleware[];
+}
+declare function definePlugin(setup: PluginSetup): PluginSetup;
+declare function resolvePlugins(plugins: PluginSetup[], pluginContext: PluginContext): Promise<ResolvedPlugins>;
+declare function buildMiddlewareChain(middlewares: Middleware[], finalHandler: (context: MiddlewareContext) => Promise<void>): (context: MiddlewareContext) => Promise<void>;
+declare function scanPluginsAlongPath(traversedDirs: string[], pluginContext: PluginContext): Promise<ResolvedPlugins>;
+export { buildMiddlewareChain, definePlugin, resolvePlugins, scanPluginsAlongPath };
+export type { ResolvedPlugins };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACZ,MAAM,SAAS,CAAC;AAKjB,UAAU,eAAe;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,iBAAS,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAErD;AAED,iBAAe,cAAc,CAC3B,OAAO,EAAE,WAAW,EAAE,EACtB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,eAAe,CAAC,CAiB1B;AAGD,iBAAS,oBAAoB,CAC3B,WAAW,EAAE,UAAU,EAAE,EACzB,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1D,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAW/C;AAID,iBAAe,oBAAoB,CACjC,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,eAAe,CAAC,CA+B1B;AAED,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/router.d.ts

@@ -3,6 +3,7 @@ interface RouteResolved {
     filePath: string;
     params: Record<string, string>;
     remainingTokens: string[];
+    traversedDirs: string[];
 }
 interface RouteUnresolved {
     kind: "unresolved";

package/dist/router.d.ts.map

@@ -1 +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"}
+{"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"}

package/dist/types.d.ts

@@ -15,9 +15,27 @@ 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 Extensions {
+}
+interface MiddlewareContext {
+    commandPath: string[];
+    params: Params;
+    args: Record<string, unknown>;
+    extensions: Extensions;
+}
+type Middleware = (context: MiddlewareContext, next: () => Promise<void>) => Promise<void>;
+interface PluginContext {
+    cliName: string;
+}
+interface PluginConfig {
+    provide?: Partial<Extensions>;
+    middleware?: Middleware;
+}
+type PluginSetup = (context: PluginContext) => PluginConfig | Promise<PluginConfig>;
 interface RunContext<T extends ArgsDefs> {
     params: Params;
     args: InferArgs<T>;
+    extensions: Extensions;
 }
 interface CommandConfig<T extends ArgsDefs = ArgsDefs> {
     description?: string;
@@ -26,5 +44,5 @@ interface CommandConfig<T extends ArgsDefs = ArgsDefs> {
 }
 declare function defineCommand<T extends ArgsDefs>(config: CommandConfig<T>): CommandConfig<T>;
 export { defineCommand };
-export type { ArgDef, ArgDefBase, ArgsDefs, CommandConfig, InferArgs, Params, RunContext };
+export type { ArgDef, ArgDefBase, ArgsDefs, CommandConfig, Extensions, InferArgs, Middleware, MiddlewareContext, Params, PluginConfig, PluginContext, PluginSetup, RunContext, };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +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"}
+{"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;AAMrC,UAAU,UAAU;CAAG;AAGvB,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,KAAK,UAAU,GAAG,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAG3F,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAIpF,UAAU,UAAU,CAAC,CAAC,SAAS,QAAQ;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;CACxB;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,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,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miyaoka/fsss",
-  "version": "0.1.0",
+  "version": "0.2.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",
@@ -20,6 +20,9 @@
   ],
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "fsss-codegen": "./dist/codegen.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -30,7 +33,9 @@
     "dist"
   ],
   "scripts": {
-    "prepublishOnly": "vite build",
+    "prepack": "cp ../../README.md .",
+    "postpack": "rm README.md",
+    "prepare": "vite build",
     "build": "vite build",
     "dev": "vite build --watch",
     "test": "bun test",