@mudah-cli/testing 0.1.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { TestApp, TestResult, type TestAppOptions } from './test-app.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { TestApp, TestResult } from './test-app.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAuB,MAAM,eAAe,CAAC"}

package/dist/test-app.d.ts

@@ -0,0 +1,56 @@
+import { Application } from '@mudah-cli/core';
+import { Output } from '@mudah-cli/ui';
+import { type CommandModule } from '@mudah-cli/console';
+export interface TestAppOptions {
+    /** App root containing `mudah.json`. */
+    cwd: string;
+    /** Extra command modules to register (in addition to discovered ones). */
+    commands?: CommandModule[];
+    /** Environment map for capability detection. */
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * An in-process test harness around a real Mudah application.
+ *
+ * ```ts
+ * const app = await TestApp.create({ cwd: fixtureApp });
+ * const result = await app.dispatch(['hello', 'world']);
+ * result.exit(0).outContains('hello world');
+ * ```
+ *
+ * Boot (providers + discovery) happens once per `TestApp`; every
+ * `dispatch()` clears the captured output first.
+ */
+export declare class TestApp {
+    readonly app: Application;
+    readonly output: Output;
+    private readonly kernel;
+    private outBuffer;
+    private errBuffer;
+    private booted;
+    private constructor();
+    static create(options: TestAppOptions): Promise<TestApp>;
+    /** Captured stdout since the last dispatch. */
+    outText(): string;
+    /** Captured stderr since the last dispatch. */
+    errText(): string;
+    clear(): void;
+    /**
+     * Dispatch argv in-process. Returns a {@link TestResult} with the exit
+     * code and chained assertions. Never throws for expected CLI failures
+     * (usage errors, unknown commands) — those become exit codes.
+     */
+    dispatch(argv: string[]): Promise<TestResult>;
+}
+/** Chained assertions over a dispatch result. */
+export declare class TestResult {
+    readonly code: number;
+    private readonly app;
+    constructor(code: number, app: TestApp);
+    /** Assert the exit code, with full output in the failure message. */
+    exit(expected: number): this;
+    outContains(text: string): this;
+    outNotContains(text: string): this;
+    errContains(text: string): this;
+    errNotContains(text: string): this;
+}

package/dist/test-app.js

@@ -0,0 +1,133 @@
+import { Application } from '@mudah-cli/core';
+import { detectCapabilities } from '@mudah-cli/terminal';
+import { Output, resolveTheme } from '@mudah-cli/ui';
+import { ConsoleKernel, renderError } from '@mudah-cli/console';
+/**
+ * An in-process test harness around a real Mudah application.
+ *
+ * ```ts
+ * const app = await TestApp.create({ cwd: fixtureApp });
+ * const result = await app.dispatch(['hello', 'world']);
+ * result.exit(0).outContains('hello world');
+ * ```
+ *
+ * Boot (providers + discovery) happens once per `TestApp`; every
+ * `dispatch()` clears the captured output first.
+ */
+export class TestApp {
+    app;
+    output;
+    kernel;
+    outBuffer = '';
+    errBuffer = '';
+    booted = false;
+    constructor(app, output, kernel) {
+        this.app = app;
+        this.output = output;
+        this.kernel = kernel;
+    }
+    static async create(options) {
+        const caps = detectCapabilities({ env: options.env });
+        const app = new Application(options.cwd);
+        const output = new Output({
+            stream: { write: () => { } },
+            errorStream: { write: () => { } },
+            theme: resolveTheme(app.manifest.ui?.theme),
+            colorLevel: caps.colorLevel,
+            unicode: caps.unicode,
+            osc9: caps.osc9,
+        });
+        const kernel = new ConsoleKernel(app, output);
+        const testApp = new TestApp(app, output, kernel);
+        await app.discoverProviders();
+        await app.boot();
+        await app.evaluateLazy();
+        const modules = [...(await app.discoverCommandModules()), ...(options.commands ?? [])];
+        for (const mod of modules) {
+            kernel.register(mod);
+        }
+        testApp.booted = true;
+        return testApp;
+    }
+    /** Captured stdout since the last dispatch. */
+    outText() {
+        return this.outBuffer;
+    }
+    /** Captured stderr since the last dispatch. */
+    errText() {
+        return this.errBuffer;
+    }
+    clear() {
+        this.outBuffer = '';
+        this.errBuffer = '';
+    }
+    /**
+     * Dispatch argv in-process. Returns a {@link TestResult} with the exit
+     * code and chained assertions. Never throws for expected CLI failures
+     * (usage errors, unknown commands) — those become exit codes.
+     */
+    async dispatch(argv) {
+        if (!this.booted)
+            throw new Error('[testing] TestApp is not ready; use TestApp.create().');
+        this.clear();
+        // Route output through the buffers for this dispatch.
+        this.output.redirect({
+            write: (data) => {
+                this.outBuffer += data;
+            },
+        }, {
+            write: (data) => {
+                this.errBuffer += data;
+            },
+        });
+        let code;
+        try {
+            code = await this.kernel.dispatch(argv);
+        }
+        catch (error) {
+            code = renderError(error, this.output);
+        }
+        return new TestResult(code, this);
+    }
+}
+/** Chained assertions over a dispatch result. */
+export class TestResult {
+    code;
+    app;
+    constructor(code, app) {
+        this.code = code;
+        this.app = app;
+    }
+    /** Assert the exit code, with full output in the failure message. */
+    exit(expected) {
+        if (this.code !== expected) {
+            throw new Error(`[testing] Expected exit code ${expected}, got ${this.code}.\n--- stdout ---\n${this.app.outText()}\n--- stderr ---\n${this.app.errText()}`);
+        }
+        return this;
+    }
+    outContains(text) {
+        if (!this.app.outText().includes(text)) {
+            throw new Error(`[testing] stdout missing "${text}".\n--- stdout ---\n${this.app.outText()}`);
+        }
+        return this;
+    }
+    outNotContains(text) {
+        if (this.app.outText().includes(text)) {
+            throw new Error(`[testing] stdout unexpectedly contains "${text}".\n--- stdout ---\n${this.app.outText()}`);
+        }
+        return this;
+    }
+    errContains(text) {
+        if (!this.app.errText().includes(text)) {
+            throw new Error(`[testing] stderr missing "${text}".\n--- stderr ---\n${this.app.errText()}`);
+        }
+        return this;
+    }
+    errNotContains(text) {
+        if (this.app.errText().includes(text)) {
+            throw new Error(`[testing] stderr unexpectedly contains "${text}".\n--- stderr ---\n${this.app.errText()}`);
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=test-app.js.map

package/dist/test-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-app.js","sourceRoot":"","sources":["../src/test-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAsB,MAAM,oBAAoB,CAAC;AAWpF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,OAAO;IACT,GAAG,CAAc;IACjB,MAAM,CAAS;IACP,MAAM,CAAgB;IAC/B,SAAS,GAAG,EAAE,CAAC;IACf,SAAS,GAAG,EAAE,CAAC;IACf,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAoB,GAAgB,EAAE,MAAc,EAAE,MAAqB;QACzE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAuB;QACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;YACxB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE;YAC3B,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE;YAChC,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;YAC3C,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAEjD,MAAM,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC9B,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,GAAG,CAAC,YAAY,EAAE,CAAC;QAEzB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,sBAAsB,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QACvF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,+CAA+C;IAC/C,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,+CAA+C;IAC/C,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAc;QAC3B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3F,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,sDAAsD;QACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAClB;YACE,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE;gBACtB,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;YACzB,CAAC;SACF,EACD;YACE,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE;gBACtB,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;YACzB,CAAC;SACF,CACF,CAAC;QAEF,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAED,iDAAiD;AACjD,MAAM,OAAO,UAAU;IAEV,IAAI;IACI,GAAG;IAFtB,YACW,IAAY,EACJ,GAAY;oBADpB,IAAI;mBACI,GAAG;IACnB,CAAC;IAEJ,qEAAqE;IACrE,IAAI,CAAC,QAAgB;QACnB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,SAAS,IAAI,CAAC,IAAI,sBAAsB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAC5I,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,uBAAuB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,uBAAuB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9G,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,uBAAuB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,uBAAuB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9G,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@mudah-cli/testing",
+  "version": "0.1.0",
+  "description": "In-process command test runner with captured output, mocked prompts, and JSON assertions.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=26"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@mudah-cli/animation": "^0.1.0",
+    "@mudah-cli/console": "^0.1.0",
+    "@mudah-cli/core": "^0.1.0",
+    "@mudah-cli/terminal": "^0.1.0",
+    "@mudah-cli/ui": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}