@mudah-cli/testing 0.8.0 → 0.9.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mudah Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @mudah-cli/testing
+
+In-process test helpers for Mudah apps: `TestApp` for commands, `TestTui` for full-screen
+widgets, plus FS/network/plugin mocks and snapshot assertions. No PTY.
+
+Part of [Mudah](https://github.com/thesimonharms/mudah) — an ergonomic, animation-rich CLI
+framework.
+
+## Install
+
+```sh
+npm install -D @mudah-cli/testing
+```
+
+## Usage
+
+```ts
+import { TestApp, TestTui } from '@mudah-cli/testing';
+
+// Commands — real kernel, real providers, captured streams
+const app = await TestApp.create({ cwd: appRoot });
+const result = await app.dispatch(['welcome', 'Mudah']);
+result.exit(0).outContains('Hello, Mudah!');
+
+// Full-screen widgets — mount, drive, snapshot
+const tui = TestTui.mount(screen.root, { cols: 80, rows: 24 });
+tui.send('down').send('enter');
+expect(tui.snapshot()).toContain('prod');
+```
+
+Also ships `FsMock` / `mockFs`, `NetworkMock`, `MockPluginRegistry`, `diffSnapshots` /
+`diffTrees`, and `assertFast` for perf-budget assertions.
+
+## Links
+
+- [Full documentation](https://github.com/thesimonharms/mudah#readme)
+- [License: MIT](LICENSE)

package/dist/fs-mock.d.ts

@@ -0,0 +1,35 @@
+/**
+ * In-memory virtual filesystem for testing.
+ * No disk I/O — everything stays in memory.
+ *
+ * ```ts
+ * const fs = new FsMock();
+ * fs.write('/etc/config.json', '{}');
+ * const text = fs.read('/etc/config.json');
+ * expect(text).toBe('{}');
+ * ```
+ */
+export declare class FsMock {
+    private root;
+    write(path: string, content: string): void;
+    read(path: string): string | undefined;
+    exists(path: string): boolean;
+    isDir(path: string): boolean;
+    readdir(path: string): string[];
+    readdirRecursive(path: string): string[];
+    rm(path: string): boolean;
+    mkdir(path: string): void;
+    private resolve;
+}
+/**
+ * Global mock helpers: intercept `readFileSync` / `writeFileSync` calls
+ * and redirect them to a FsMock instance.
+ *
+ * ```ts
+ * const mock = new FsMock();
+ * const restore = mockFs(mock);
+ * // Now code using fs.readFileSync reads from `mock`
+ * restore(); // Back to real fs
+ * ```
+ */
+export declare function mockFs(mock: FsMock): () => void;

package/dist/fs-mock.js

@@ -0,0 +1,145 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const fs = require('node:fs');
+/**
+ * In-memory virtual filesystem for testing.
+ * No disk I/O — everything stays in memory.
+ *
+ * ```ts
+ * const fs = new FsMock();
+ * fs.write('/etc/config.json', '{}');
+ * const text = fs.read('/etc/config.json');
+ * expect(text).toBe('{}');
+ * ```
+ */
+export class FsMock {
+    root = { type: 'dir', children: new Map() };
+    write(path, content) {
+        const parts = path.split('/').filter(Boolean);
+        let node = this.root;
+        for (let i = 0; i < parts.length - 1; i++) {
+            if (!node.children)
+                node.children = new Map();
+            let child = node.children.get(parts[i]);
+            if (!child) {
+                child = { type: 'dir', children: new Map() };
+                node.children.set(parts[i], child);
+            }
+            node = child;
+        }
+        if (!node.children)
+            node.children = new Map();
+        node.children.set(parts[parts.length - 1], { type: 'file', content });
+    }
+    read(path) {
+        const node = this.resolve(path);
+        return node?.type === 'file' ? node.content : undefined;
+    }
+    exists(path) {
+        return this.resolve(path) !== undefined;
+    }
+    isDir(path) {
+        return this.resolve(path)?.type === 'dir';
+    }
+    readdir(path) {
+        const node = this.resolve(path);
+        return node?.type === 'dir' && node.children ? [...node.children.keys()].sort() : [];
+    }
+    readdirRecursive(path) {
+        const out = [];
+        const walk = (node, prefix) => {
+            if (!node.children)
+                return;
+            for (const [name, child] of node.children) {
+                const fullPath = prefix === '' ? name : `${prefix}/${name}`;
+                out.push(fullPath);
+                if (child.type === 'dir')
+                    walk(child, fullPath);
+            }
+        };
+        const dir = this.resolve(path);
+        if (dir?.type === 'dir')
+            walk(dir, '');
+        return out.sort();
+    }
+    rm(path) {
+        const parts = path.split('/').filter(Boolean);
+        let node = this.root;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const child = node.children?.get(parts[i]);
+            if (!child)
+                return false;
+            node = child;
+        }
+        return node.children?.delete(parts[parts.length - 1]) ?? false;
+    }
+    mkdir(path) {
+        const parts = path.split('/').filter(Boolean);
+        let node = this.root;
+        for (const part of parts) {
+            if (!node.children)
+                node.children = new Map();
+            let child = node.children.get(part);
+            if (!child) {
+                child = { type: 'dir', children: new Map() };
+                node.children.set(part, child);
+            }
+            node = child;
+        }
+    }
+    resolve(path) {
+        const parts = path.split('/').filter(Boolean);
+        let node = this.root;
+        for (const part of parts) {
+            const next = node.children?.get(part);
+            if (!next)
+                return undefined;
+            node = next;
+        }
+        return node;
+    }
+}
+/**
+ * Global mock helpers: intercept `readFileSync` / `writeFileSync` calls
+ * and redirect them to a FsMock instance.
+ *
+ * ```ts
+ * const mock = new FsMock();
+ * const restore = mockFs(mock);
+ * // Now code using fs.readFileSync reads from `mock`
+ * restore(); // Back to real fs
+ * ```
+ */
+export function mockFs(mock) {
+    const previousRead = fs.readFileSync;
+    const previousWrite = fs.writeFileSync;
+    const previousExists = fs.existsSync;
+    fs.readFileSync = ((path, encoding) => {
+        const key = String(path);
+        const text = mock.read(key) ?? mock.read(`/${key}`);
+        if (text === undefined) {
+            const err = new Error(`ENOENT: no such file or directory, open '${key}'`);
+            err.code = 'ENOENT';
+            throw err;
+        }
+        const enc = encoding === 'utf8' ||
+            encoding === 'utf-8' ||
+            (typeof encoding === 'object' &&
+                encoding !== null &&
+                encoding.encoding === 'utf8');
+        return enc ? text : Buffer.from(text);
+    });
+    fs.writeFileSync = ((path, data) => {
+        mock.write(String(path), typeof data === 'string' ? data : Buffer.from(data).toString('utf8'));
+    });
+    fs.existsSync = ((path) => {
+        const key = String(path);
+        return mock.exists(key) || mock.exists(`/${key}`);
+    });
+    return () => {
+        fs.readFileSync = previousRead;
+        fs.writeFileSync = previousWrite;
+        fs.existsSync = previousExists;
+    };
+}
+//# sourceMappingURL=fs-mock.js.map

package/dist/fs-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-mock.js","sourceRoot":"","sources":["../src/fs-mock.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,2 +1,8 @@
-export { TestApp, TestResult, type TestAppOptions } from './test-app.js';
-export { TestTui, type TestTuiOptions } from './test-tui.js';
+export { type ReplayHandle, type SessionAction, SessionRecorder } from '@mudah-cli/tui';
+export { FsMock, mockFs } from './fs-mock.js';
+export { NetworkMock, type NetworkMockResponse } from './network-mock.js';
+export { createMockPlugin, type MockPlugin, type MockPluginOptions, MockPluginRegistry, } from './plugin-mock.js';
+export { assertHasColor, assertLacksColor, type ColorExpectation } from './snapshot-assert.js';
+export { TestApp, type TestAppOptions, TestResult } from './test-app.js';
+export { assertFast, TestTui, type TestTuiAction, type TestTuiMeasure, type TestTuiOptions, } from './test-tui.js';
+export { diffSnapshots, diffTrees } from './visual-diff.js';

package/dist/index.js

@@ -1,3 +1,9 @@
+export { SessionRecorder } from '@mudah-cli/tui';
+export { FsMock, mockFs } from './fs-mock.js';
+export { NetworkMock } from './network-mock.js';
+export { createMockPlugin, MockPluginRegistry, } from './plugin-mock.js';
+export { assertHasColor, assertLacksColor } from './snapshot-assert.js';
 export { TestApp, TestResult } from './test-app.js';
-export { TestTui } from './test-tui.js';
+export { assertFast, TestTui, } from './test-tui.js';
+export { diffSnapshots, diffTrees } from './visual-diff.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAuB,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,OAAO,EAAuB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAA4B,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAGhB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAyB,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,OAAO,EAAuB,UAAU,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,UAAU,EACV,OAAO,GAIR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/network-mock.d.ts

@@ -0,0 +1,24 @@
+/**
+ * In-memory fetch double for tests. No sockets — handlers return canned
+ * JSON or text by URL string or RegExp.
+ *
+ * ```ts
+ * const net = new NetworkMock();
+ * net.on('https://example.com/a.json', { ok: true });
+ * const body = await (await net.fetch('https://example.com/a.json')).json();
+ * expect(net.calls).toEqual(['https://example.com/a.json']);
+ * ```
+ */
+export interface NetworkMockResponse {
+    status?: number;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+export declare class NetworkMock {
+    private readonly routes;
+    readonly calls: string[];
+    on(url: string | RegExp, body: unknown, status?: number): this;
+    reply(url: string | RegExp, response: NetworkMockResponse): this;
+    /** `fetch` implementation to inject into code under test. */
+    fetch: typeof fetch;
+}

package/dist/network-mock.js

@@ -0,0 +1,31 @@
+export class NetworkMock {
+    routes = [];
+    calls = [];
+    on(url, body, status = 200) {
+        this.routes.push({ match: url, response: { status, body } });
+        return this;
+    }
+    reply(url, response) {
+        this.routes.push({ match: url, response });
+        return this;
+    }
+    /** `fetch` implementation to inject into code under test. */
+    fetch = async (input, _init) => {
+        const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
+        this.calls.push(url);
+        const route = this.routes.find((entry) => typeof entry.match === 'string' ? entry.match === url : entry.match.test(url));
+        if (!route) {
+            return new Response('not found', { status: 404, headers: { 'content-type': 'text/plain' } });
+        }
+        const status = route.response.status ?? 200;
+        const body = route.response.body;
+        if (typeof body === 'string' || body instanceof Uint8Array) {
+            return new Response(body, { status, headers: route.response.headers });
+        }
+        return new Response(JSON.stringify(body ?? null), {
+            status,
+            headers: { 'content-type': 'application/json', ...route.response.headers },
+        });
+    };
+}
+//# sourceMappingURL=network-mock.js.map

package/dist/network-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-mock.js","sourceRoot":"","sources":["../src/network-mock.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,WAAW;IACL,MAAM,GAAqE,EAAE,CAAC;IACtF,KAAK,GAAa,EAAE,CAAC;IAE9B,EAAE,CAAC,GAAoB,EAAE,IAAa,EAAE,MAAM,GAAG,GAAG;QAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAoB,EAAE,QAA6B;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6DAA6D;IAC7D,KAAK,GAAiB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;QAC9F,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAC9E,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;YAC3D,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE;YAChD,MAAM;YACN,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE;SAC3E,CAAC,CAAC;IACL,CAAC,CAAC;CACH"}

package/dist/plugin-mock.d.ts

@@ -0,0 +1,47 @@
+import type { CommandClass, CommandModule, PluginDiscoveryOptions, PluginInfo, ProviderClass } from '@mudah-cli/core';
+export interface MockPluginOptions {
+    name: string;
+    providers?: readonly ProviderClass[];
+    commands?: readonly CommandModule[] | readonly CommandClass[];
+    keywords?: readonly string[];
+}
+/**
+ * A {@link PluginInfo}-shaped plugin plus the extras the mock registry
+ * needs to serve `resolve` / `readPackage` / `importModule`.
+ */
+export interface MockPlugin extends PluginInfo {
+    readonly keywords: readonly string[];
+    /** Module object returned by the injectable `importModule`. */
+    readonly module: Record<string, unknown>;
+}
+/**
+ * Build a plugin fixture that `discoverPlugins` / `loadPlugin` can load
+ * through {@link MockPluginRegistry.asDiscoveryOptions}.
+ */
+export declare function createMockPlugin(options: MockPluginOptions): MockPlugin;
+/**
+ * In-memory plugin graph for kernel tests. Supplies the three injectables
+ * on {@link PluginDiscoveryOptions} so discovery never touches disk.
+ *
+ * ```ts
+ * const registry = new MockPluginRegistry();
+ * registry.register(createMockPlugin({ name: 'demo-plugin', providers: [DemoProvider] }));
+ * const plugins = await discoverPlugins('/app', registry.asDiscoveryOptions());
+ * ```
+ */
+export declare class MockPluginRegistry {
+    private readonly plugins;
+    register(plugin: MockPlugin | MockPluginOptions): this;
+    list(): MockPlugin[];
+    clear(): void;
+    /**
+     * Injectable discovery options matching `packages/core/src/plugins.ts`
+     * {@link PluginDiscoveryOptions}: `resolve`, `readPackage`, `importModule`.
+     */
+    asDiscoveryOptions(): PluginDiscoveryOptions;
+    private resolve;
+    private readPackage;
+    private importModule;
+    private pluginForManifest;
+    private pluginNameFromUrl;
+}

package/dist/plugin-mock.js

@@ -0,0 +1,109 @@
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+/**
+ * Build a plugin fixture that `discoverPlugins` / `loadPlugin` can load
+ * through {@link MockPluginRegistry.asDiscoveryOptions}.
+ */
+export function createMockPlugin(options) {
+    const providers = options.providers ?? [];
+    const commandClasses = (options.commands ?? []).map((entry) => isCommandModule(entry) ? entry.default : entry);
+    const commands = commandClasses.map((ctor) => ({ default: ctor }));
+    const keywords = options.keywords ?? ['mudah-plugin'];
+    const module = {};
+    if (providers.length > 0)
+        module['providers'] = [...providers];
+    if (commandClasses.length > 0)
+        module['commands'] = [...commandClasses];
+    for (const provider of providers) {
+        if (provider.name)
+            module[provider.name] = provider;
+    }
+    return { name: options.name, providers, commands, keywords, module };
+}
+/**
+ * In-memory plugin graph for kernel tests. Supplies the three injectables
+ * on {@link PluginDiscoveryOptions} so discovery never touches disk.
+ *
+ * ```ts
+ * const registry = new MockPluginRegistry();
+ * registry.register(createMockPlugin({ name: 'demo-plugin', providers: [DemoProvider] }));
+ * const plugins = await discoverPlugins('/app', registry.asDiscoveryOptions());
+ * ```
+ */
+export class MockPluginRegistry {
+    plugins = new Map();
+    register(plugin) {
+        const mock = isMockPlugin(plugin) ? plugin : createMockPlugin(plugin);
+        this.plugins.set(mock.name, mock);
+        return this;
+    }
+    list() {
+        return [...this.plugins.values()];
+    }
+    clear() {
+        this.plugins.clear();
+    }
+    /**
+     * Injectable discovery options matching `packages/core/src/plugins.ts`
+     * {@link PluginDiscoveryOptions}: `resolve`, `readPackage`, `importModule`.
+     */
+    asDiscoveryOptions() {
+        return {
+            resolve: (name, from) => this.resolve(name, from),
+            readPackage: (path) => this.readPackage(path),
+            importModule: (url) => this.importModule(url),
+        };
+    }
+    resolve(name, from) {
+        return pathToFileURL(join(from, 'node_modules', name, 'index.js')).href;
+    }
+    async readPackage(path) {
+        const normalized = path.replace(/\\/g, '/');
+        const plugin = this.pluginForManifest(normalized);
+        if (plugin !== undefined) {
+            return {
+                name: plugin.name,
+                main: 'index.js',
+                keywords: [...plugin.keywords],
+            };
+        }
+        if (normalized.endsWith('/package.json') && !normalized.includes('/node_modules/')) {
+            return {
+                name: 'mock-host',
+                dependencies: Object.fromEntries([...this.plugins.keys()].map((name) => [name, '0.0.0'])),
+            };
+        }
+        throw new Error(`[testing] no mock manifest at ${path}`);
+    }
+    async importModule(url) {
+        const name = this.pluginNameFromUrl(url);
+        const plugin = name === undefined ? undefined : this.plugins.get(name);
+        if (plugin === undefined)
+            throw new Error(`[testing] cannot import ${url}`);
+        return { ...plugin.module };
+    }
+    pluginForManifest(normalizedPath) {
+        for (const plugin of this.plugins.values()) {
+            if (normalizedPath.includes(`/node_modules/${plugin.name}/package.json`))
+                return plugin;
+        }
+        return undefined;
+    }
+    pluginNameFromUrl(url) {
+        const path = url.startsWith('file:') ? new URL(url).pathname : url;
+        const normalized = path.replace(/\\/g, '/');
+        for (const name of this.plugins.keys()) {
+            if (normalized.includes(`/node_modules/${name}/`))
+                return name;
+        }
+        const match = /\/node_modules\/((?:@[^/]+\/)?[^/]+)\//.exec(normalized);
+        return match?.[1];
+    }
+}
+function isCommandModule(value) {
+    return typeof value === 'object' && value !== null && 'default' in value;
+}
+function isMockPlugin(value) {
+    return 'module' in value && 'keywords' in value && 'providers' in value && 'commands' in value;
+}
+//# sourceMappingURL=plugin-mock.js.map

package/dist/plugin-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-mock.js","sourceRoot":"","sources":["../src/plugin-mock.ts"],"names":[],"mappings":"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"}

package/dist/snapshot-assert.d.ts

@@ -0,0 +1,17 @@
+export interface ColorExpectation {
+    /** Plain-text fragment to find. */
+    text: string;
+    /** Hex color (case-insensitive) expected on at least one matched cell. */
+    hex: string;
+}
+/**
+ * Assert that `text` contains a fragment painted with the given hex color.
+ * Throws on failure with a diff-style message.
+ */
+export declare function assertHasColor(text: string, expectation: ColorExpectation): void;
+/**
+ * Assert that `text` does NOT contain a fragment painted with the given hex
+ * color (i.e. the fragment is present but in a different color, or absent
+ * entirely).
+ */
+export declare function assertLacksColor(text: string, expectation: ColorExpectation): void;

package/dist/snapshot-assert.js

@@ -0,0 +1,97 @@
+/**
+ * Color assertions for TUI snapshots.
+ *
+ * These are plain functions, not vitest matchers, so they don't force a
+ * vitest dependency on the testing package. The user's tests can wrap them
+ * in `expect(() => assertHasColor(...)).not.toThrow()` or similar.
+ */
+import { stripAnsi } from '@mudah-cli/ui';
+const ANSI_SGR_FOREGROUND = /\x1b\[(?:38;2;(\d+);(\d+);(\d+)|38;5;(\d+)|3[0-8])m/g;
+function hexFromRgb(r, g, b) {
+    return `#${[r, g, b].map((n) => Number(n).toString(16).padStart(2, '0')).join('')}`;
+}
+/** Return runs of (text, optional hex color) covering `text` in order. */
+function styledRuns(text) {
+    const runs = [];
+    let last = 0;
+    let current = { text: '' };
+    for (const match of text.matchAll(ANSI_SGR_FOREGROUND)) {
+        // Close out whatever came before this escape.
+        const start = match.index ?? 0;
+        current.text += text.slice(last, start);
+        if (current.text.length > 0)
+            runs.push(current);
+        // Open a new run carrying the color from this escape.
+        const r = match[1];
+        const g = match[2];
+        const b = match[3];
+        current = r && g && b ? { text: '', hex: hexFromRgb(r, g, b) } : { text: '' };
+        last = start + match[0].length;
+    }
+    current.text += text.slice(last);
+    if (current.text.length > 0)
+        runs.push(current);
+    return runs;
+}
+function hexToRgb(hex) {
+    const v = hex.replace('#', '');
+    const full = v.length === 3
+        ? v
+            .split('')
+            .map((c) => c + c)
+            .join('')
+        : v;
+    const n = parseInt(full, 16);
+    return [(n >> 16) & 0xff, (n >> 8) & 0xff, n & 0xff];
+}
+/**
+ * Assert that `text` contains a fragment painted with the given hex color.
+ * Throws on failure with a diff-style message.
+ */
+export function assertHasColor(text, expectation) {
+    const { text: fragment, hex } = expectation;
+    const plain = stripAnsi(text);
+    const at = plain.indexOf(fragment);
+    if (at < 0) {
+        throw new Error(`[testing] Snapshot does not contain "${fragment}".\n--- snapshot ---\n${text}`);
+    }
+    // Walk the styled runs and find a run whose text overlaps [at, at+fragment.length].
+    const end = at + fragment.length;
+    let cursor = 0;
+    let found;
+    for (const run of styledRuns(text)) {
+        const runStart = cursor;
+        const runEnd = cursor + stripAnsi(run.text).length;
+        if (run.hex !== undefined && runStart < end && runEnd > at) {
+            found = run.hex;
+            break;
+        }
+        cursor = runEnd;
+    }
+    if (found === undefined) {
+        throw new Error(`[testing] "${fragment}" appears in the snapshot but is not painted with a hex color (the cell uses the default style).\n--- snapshot ---\n${text}`);
+    }
+    const [r1, g1, b1] = hexToRgb(found);
+    const [r2, g2, b2] = hexToRgb(hex);
+    if (r1 !== r2 || g1 !== g2 || b1 !== b2) {
+        throw new Error(`[testing] "${fragment}" is painted with ${found} but expected ${hex}.\n--- snapshot ---\n${text}`);
+    }
+}
+/**
+ * Assert that `text` does NOT contain a fragment painted with the given hex
+ * color (i.e. the fragment is present but in a different color, or absent
+ * entirely).
+ */
+export function assertLacksColor(text, expectation) {
+    const { text: fragment } = expectation;
+    if (!stripAnsi(text).includes(fragment))
+        return;
+    try {
+        assertHasColor(text, expectation);
+    }
+    catch {
+        return;
+    }
+    throw new Error(`[testing] "${fragment}" appears painted with ${expectation.hex} when it should not.`);
+}
+//# sourceMappingURL=snapshot-assert.js.map

package/dist/snapshot-assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-assert.js","sourceRoot":"","sources":["../src/snapshot-assert.ts"],"names":[],"mappings":"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"}

package/dist/test-app.d.ts

@@ -1,6 +1,6 @@
+import { type CommandModule } from '@mudah-cli/console';
 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;

package/dist/test-app.js

@@ -1,7 +1,7 @@
+import { ConsoleKernel, renderError } from '@mudah-cli/console';
 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.
  *