@andrei.fyi/picocli 0.1.0

package/dist/testing/testkit.js

@@ -0,0 +1,112 @@
+import { format } from 'util';
+import { AsyncLocalStorage } from 'async_hooks';
+
+// src/testing/testkit.ts
+var METHODS = ["log", "info", "debug", "warn", "error"];
+var consoleCaptureStorage = new AsyncLocalStorage();
+var depth = 0;
+var original;
+var createConsoleRouter = (method) => (...args) => {
+  const capture = consoleCaptureStorage.getStore();
+  const handler = capture?.[method];
+  if (handler) handler(args);
+  else original?.[method](...args);
+};
+var installConsoleCapture = () => {
+  if (depth++ > 0) return;
+  original = Object.fromEntries(METHODS.map((method) => [method, console[method].bind(console)]));
+  for (const method of METHODS) {
+    console[method] = createConsoleRouter(method);
+  }
+};
+var uninstallConsoleCapture = () => {
+  depth--;
+  if (depth > 0 || !original) return;
+  for (const method of METHODS) console[method] = original[method];
+  original = void 0;
+};
+var withConsoleCapture = async (capture, runCaptured) => {
+  installConsoleCapture();
+  try {
+    return await consoleCaptureStorage.run(capture, runCaptured);
+  } finally {
+    uninstallConsoleCapture();
+  }
+};
+Object.fromEntries(
+  METHODS.map((method) => [method, () => {
+  }])
+);
+
+// src/testing/testkit.ts
+var formatConsoleArgs = (args) => `${format(...args)}
+`;
+var createConsoleCapture = (output) => ({
+  log: (args) => void output.stdout.push(formatConsoleArgs(args)),
+  info: (args) => void output.stdout.push(formatConsoleArgs(args)),
+  debug: (args) => void output.stdout.push(formatConsoleArgs(args)),
+  error: (args) => void output.stderr.push(formatConsoleArgs(args)),
+  warn: (args) => void output.stderr.push(formatConsoleArgs(args))
+});
+var parseJsonResult = (stdout) => {
+  try {
+    const json = JSON.parse(stdout);
+    return { stdout: `${JSON.stringify(json)}
+`, json, hasJson: true };
+  } catch {
+    return { stdout, json: void 0, hasJson: false };
+  }
+};
+var runCliWithOutputFormat = async (app, argv, opts, outputFormat) => {
+  const output = {
+    stdout: [],
+    stderr: [],
+    exitCode: 0,
+    wroteFrameworkStdout: false
+  };
+  const stdin = opts.stdin;
+  const readStdin = stdin === void 0 ? void 0 : async () => stdin;
+  await withConsoleCapture(createConsoleCapture(output), async () => {
+    await app.serve(argv, {
+      stdout: (s) => {
+        output.wroteFrameworkStdout = true;
+        output.stdout.push(s);
+      },
+      stderr: (s) => {
+        output.stderr.push(s);
+      },
+      exit: (code) => {
+        output.exitCode = code;
+      },
+      env: opts.env ?? {},
+      isTTY: opts.isTTY ?? false,
+      stdin: readStdin,
+      format: outputFormat
+    });
+  });
+  const stdout = output.stdout.join("");
+  const stderr = output.stderr.join("");
+  if (outputFormat !== "json" && !output.wroteFrameworkStdout) {
+    return { stdout, stderr, exitCode: output.exitCode, json: void 0, hasJson: false };
+  }
+  const parsed = parseJsonResult(stdout);
+  return {
+    stdout: parsed.stdout,
+    stderr,
+    exitCode: output.exitCode,
+    json: parsed.json,
+    hasJson: parsed.hasJson
+  };
+};
+var runCli = async (app, argv, opts = {}) => {
+  const { hasJson: _, ...result } = await runCliWithOutputFormat(app, argv, opts, void 0);
+  return result;
+};
+var runJson = async (app, argv, opts = {}) => {
+  const result = await runCliWithOutputFormat(app, argv, opts, "json");
+  if (!result.hasJson) throw new Error("runJson expected JSON output");
+  const { hasJson: _, ...publicResult } = result;
+  return publicResult;
+};
+
+export { runCli, runJson };

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@andrei.fyi/picocli",
+  "version": "0.1.0",
+  "description": "Tiny CLI framework for Node and Bun.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22",
+    "bun": ">=1.1.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./mcp": {
+      "import": {
+        "types": "./dist/mcp/index.d.ts",
+        "default": "./dist/mcp/index.js"
+      },
+      "require": {
+        "types": "./dist/mcp/index.d.cts",
+        "default": "./dist/mcp/index.cjs"
+      }
+    },
+    "./testing": {
+      "import": {
+        "types": "./dist/testing/testkit.d.ts",
+        "default": "./dist/testing/testkit.js"
+      },
+      "require": {
+        "types": "./dist/testing/testkit.d.cts",
+        "default": "./dist/testing/testkit.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "mcp": [
+        "./dist/mcp/index.d.cts"
+      ],
+      "testing": [
+        "./dist/testing/testkit.d.cts"
+      ]
+    }
+  },
+  "scripts": {
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "build": "tsup",
+    "examples:typecheck": "tsc --noEmit --module Preserve --moduleResolution bundler --target ESNext --lib ESNext --types node,bun --strict --skipLibCheck examples/**/*.ts",
+    "examples:check": "bun run scripts/check-examples.mjs",
+    "smoke:node": "node ./scripts/smoke-dist.mjs",
+    "smoke:bun": "bun run ./scripts/smoke-dist.mjs",
+    "publint": "bunx publint --level=warning",
+    "attw": "bunx -p @arethetypeswrong/cli attw --pack .",
+    "prepack": "bun run build",
+    "verify": "tsc --noEmit && bun test && tsup && node ./scripts/smoke-dist.mjs && bun run ./scripts/smoke-dist.mjs && bun run examples:typecheck && bun run examples:check && bunx publint --level=warning && bun run attw"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@types/bun": "^1.2.21",
+    "@types/node": "^24.5.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "zod": "^4.3.6"
+  }
+}