@kitlangton/terminal-control 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kit Langton
+
+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,29 @@
+# @kitlangton/terminal-control
+
+Typed terminal application control and testing client for `termctrl driver`, with stable screen snapshots, keyboard interaction, readable logs, recordings, and opt-in failure evidence.
+
+Install the package with Vitest after the initial npm publication:
+
+```bash
+bun add -d @kitlangton/terminal-control vitest
+```
+
+The matching native `termctrl` binary is installed automatically on macOS or GNU/Linux on arm64 or x64:
+
+```ts
+import { TerminalControl } from "@kitlangton/terminal-control"
+
+await using terminal = await TerminalControl.make()
+```
+
+For development or custom native builds, the runtime resolves an explicit `binaryPath` first, then `TERMCTRL_BINARY`, before the installed native package.
+
+Visible screen text and frames are stable snapshot surfaces:
+
+```ts
+await using session = await terminal.launch({ command: ["my-tui"] })
+await session.screen.waitForText("Ready")
+expect(await session.screen.text()).toMatchSnapshot()
+```
+
+For line-oriented output, use `session.logs.text()`; for exact ANSI/VT bytes, use `session.transcript.ansi()`. Artifact and recording configuration is opt-in because terminal output and input may contain secrets. See the repository `README.md` for the complete workflow.

package/dist/index.d.ts

@@ -0,0 +1,217 @@
+export type Color = {
+    r: number;
+    g: number;
+    b: number;
+};
+export type Attributes = {
+    bold: boolean;
+    italic: boolean;
+    faint: boolean;
+    invisible: boolean;
+    strikethrough: boolean;
+    overline: boolean;
+    underline: "single" | null;
+};
+export type Cell = {
+    x: number;
+    y: number;
+    text: string;
+    width: number;
+    foreground: Color;
+    background: Color;
+    attributes: Attributes;
+};
+export type Cursor = {
+    x: number;
+    y: number;
+    color: Color;
+    blinking: boolean;
+};
+export type Frame = {
+    version: 1;
+    cols: number;
+    rows: number;
+    foreground: Color;
+    background: Color;
+    cursor: Cursor | null;
+    cells: Cell[];
+};
+export type ScreenSnapshot = {
+    reason: CaptureReason;
+    frame: Frame;
+    text: string;
+    ansi?: Uint8Array;
+    svg?: string;
+};
+export type CaptureReason = "idle" | "deadline" | "exited" | "outputclosed";
+export type CaptureResult = ScreenSnapshot;
+export type ProcessExit = {
+    code: number;
+    signal: string | null;
+    success: boolean;
+};
+export type SessionStatus = {
+    state: "running" | "exited";
+    exit: ProcessExit | null;
+    cols: number;
+    rows: number;
+    cellWidth: number;
+    cellHeight: number;
+    idleForMs: number | null;
+    hasVisibleContent: boolean;
+    recording: boolean;
+    logsTruncated: boolean;
+};
+export type ControlLetter = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z";
+export type Key = "Enter" | "Escape" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Tab" | "Shift+Tab" | "Backspace" | "Delete" | "Home" | "End" | "PageUp" | "PageDown" | `Control+${Uppercase<ControlLetter>}`;
+export type Viewport = {
+    cols: number;
+    rows: number;
+    cellWidth?: number;
+    cellHeight?: number;
+};
+export type LaunchOptions = {
+    command: readonly [string, ...string[]];
+    cwd?: string;
+    record?: string | true | "on-failure";
+    viewport?: Viewport;
+    host?: "opentui";
+    color?: "auto" | "always" | "never";
+    maxBytes?: number;
+    env?: Readonly<Record<string, string>>;
+    inheritEnv?: boolean;
+};
+export type ArtifactOptions = {
+    directory: string;
+    onFailure?: boolean;
+    includeTranscript?: boolean;
+    includeRecording?: boolean;
+};
+export type DriverOptions = {
+    binaryPath?: string;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    artifacts?: false | ArtifactOptions;
+};
+export type WaitOptions = {
+    timeoutMs?: number;
+};
+export type IdleOptions = WaitOptions & {
+    quietForMs?: number;
+};
+export type CaptureOptions = {
+    settleMs?: number;
+    deadlineMs?: number;
+    allowIncomplete?: boolean;
+    includeAnsi?: boolean;
+    includeSvg?: boolean;
+};
+export type StableCaptureOptions = Omit<CaptureOptions, "allowIncomplete">;
+export type WaitForExitResult = {
+    reason: "exited";
+    exit: ProcessExit;
+} | {
+    reason: "deadline";
+};
+export type ArtifactManifest = {
+    directory: string;
+    screenText: string;
+    screenFrame: string;
+    screenSvg: string;
+    metadata: string;
+    logsText: string;
+    transcript?: string;
+    recording?: string;
+};
+type DriverRequest = <T>(method: string, params?: unknown, sessionId?: string) => Promise<T>;
+export declare class TerminalControlError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class IncompleteCaptureError extends Error {
+    readonly capture: CaptureResult;
+    constructor(capture: CaptureResult);
+}
+export declare function resolveTerminalControlBinary(explicit?: string): string;
+export declare class TerminalControl implements AsyncDisposable {
+    private readonly child;
+    private readonly pending;
+    private readonly ready;
+    private nextRequestId;
+    private nextSessionId;
+    private closed;
+    private stderr;
+    private readySettled;
+    private rejectReady;
+    private readonly artifacts;
+    private constructor();
+    static make(options?: DriverOptions): Promise<TerminalControl>;
+    launch(options: LaunchOptions): Promise<Session>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    private request;
+    private failAll;
+    private abort;
+}
+export declare class Session implements AsyncDisposable {
+    private readonly request;
+    readonly id: string;
+    private readonly artifacts;
+    private readonly temporaryRecording?;
+    private readonly launchOptions?;
+    readonly screen: Screen;
+    readonly keyboard: Keyboard;
+    readonly logs: Logs;
+    readonly transcript: Transcript;
+    private stopped;
+    constructor(request: DriverRequest, id: string, artifacts?: false | ArtifactOptions, temporaryRecording?: string | undefined, launchOptions?: LaunchOptions | undefined);
+    status(): Promise<SessionStatus>;
+    waitForExit(options?: WaitOptions): Promise<WaitForExitResult>;
+    resize(viewport: Viewport): Promise<void>;
+    recording(): Promise<Uint8Array>;
+    saveRecording(path: string): Promise<void>;
+    shouldWriteFailureArtifacts(): boolean;
+    writeArtifacts(name?: string): Promise<ArtifactManifest>;
+    withArtifactsOnFailure<T>(name: string, run: () => Promise<T>): Promise<T>;
+    stop(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export declare class Screen {
+    private readonly request;
+    private readonly sessionId;
+    constructor(request: DriverRequest, sessionId: string);
+    waitForText(text: string | RegExp, options?: WaitOptions): Promise<void>;
+    waitForIdle(options?: IdleOptions): Promise<void>;
+    waitUntil(predicate: (snapshot: ScreenSnapshot) => boolean | Promise<boolean>, options?: WaitOptions): Promise<ScreenSnapshot>;
+    capture(options?: CaptureOptions): Promise<ScreenSnapshot>;
+    frame(options?: StableCaptureOptions): Promise<Frame>;
+    text(options?: StableCaptureOptions): Promise<string>;
+}
+export declare class Keyboard {
+    private readonly request;
+    private readonly sessionId;
+    constructor(request: DriverRequest, sessionId: string);
+    type(value: string, options?: {
+        paceMs?: number;
+    }): Promise<void>;
+    press(key: Key): Promise<void>;
+    sequence(keys: readonly Key[], options?: {
+        paceMs?: number;
+    }): Promise<void>;
+    write(value: Uint8Array): Promise<void>;
+    private send;
+}
+export declare class Logs {
+    private readonly request;
+    private readonly sessionId;
+    constructor(request: DriverRequest, sessionId: string);
+    text(): Promise<string>;
+}
+export declare class Transcript {
+    private readonly request;
+    private readonly sessionId;
+    constructor(request: DriverRequest, sessionId: string);
+    ansi(): Promise<Uint8Array>;
+}
+export {};
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,462 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { createRequire } from "node:module";
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { createInterface } from "node:readline";
+export class TerminalControlError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "TerminalControlError";
+        this.code = code;
+    }
+}
+export class IncompleteCaptureError extends Error {
+    capture;
+    constructor(capture) {
+        super(`screen capture completed with ${capture.reason} instead of a settled frame`);
+        this.name = "IncompleteCaptureError";
+        this.capture = capture;
+    }
+}
+const nativePackages = {
+    "darwin-arm64": "@kitlangton/terminal-control-darwin-arm64",
+    "darwin-x64": "@kitlangton/terminal-control-darwin-x64",
+    "linux-arm64": "@kitlangton/terminal-control-linux-arm64-gnu",
+    "linux-x64": "@kitlangton/terminal-control-linux-x64-gnu",
+};
+export function resolveTerminalControlBinary(explicit) {
+    if (explicit)
+        return explicit;
+    if (process.env.TERMCTRL_BINARY)
+        return process.env.TERMCTRL_BINARY;
+    const target = `${process.platform}-${process.arch}`;
+    const packageName = nativePackages[target];
+    if (!packageName) {
+        throw new Error(`no packaged termctrl binary is available for ${target}; provide binaryPath`);
+    }
+    try {
+        return createRequire(import.meta.url).resolve(`${packageName}/bin/termctrl`);
+    }
+    catch {
+        throw new Error(`termctrl native package ${packageName} is not installed; provide binaryPath`);
+    }
+}
+export class TerminalControl {
+    child;
+    pending = new Map();
+    ready;
+    nextRequestId = 1;
+    nextSessionId = 1;
+    closed = false;
+    stderr = "";
+    readySettled = false;
+    rejectReady = () => { };
+    artifacts;
+    constructor(options) {
+        this.artifacts = options.artifacts ?? false;
+        this.child = spawn(resolveTerminalControlBinary(options.binaryPath), ["driver"], {
+            cwd: options.cwd,
+            env: { ...process.env, ...options.env },
+            stdio: "pipe",
+        });
+        this.ready = new Promise((resolve, reject) => {
+            this.rejectReady = reject;
+            const lines = createInterface({ input: this.child.stdout });
+            lines.on("line", (line) => {
+                let message;
+                try {
+                    message = JSON.parse(line);
+                }
+                catch (error) {
+                    this.abort(new Error(`invalid termctrl driver response: ${String(error)}`));
+                    return;
+                }
+                if (message.type === "hello") {
+                    if (this.readySettled) {
+                        this.abort(new Error("termctrl driver sent more than one hello message"));
+                        return;
+                    }
+                    if (message.protocolVersion !== 1) {
+                        this.abort(new Error(`unsupported termctrl protocol version ${message.protocolVersion}`));
+                        return;
+                    }
+                    this.readySettled = true;
+                    resolve(message);
+                    return;
+                }
+                if (message.type === "error") {
+                    if (message.id === null) {
+                        this.abort(new TerminalControlError(message.error.code, message.error.message));
+                        return;
+                    }
+                    const pending = this.pending.get(message.id);
+                    if (!pending)
+                        return;
+                    this.pending.delete(message.id);
+                    pending.reject(new TerminalControlError(message.error.code, message.error.message));
+                    return;
+                }
+                const pending = this.pending.get(message.id);
+                if (!pending)
+                    return;
+                this.pending.delete(message.id);
+                pending.resolve(message.result);
+            });
+            this.child.once("error", (error) => this.abort(error));
+        });
+        this.child.stderr.on("data", (chunk) => {
+            this.stderr = (this.stderr + new TextDecoder().decode(chunk)).slice(-8_192);
+        });
+        this.child.once("exit", (code, signal) => {
+            if (this.closed)
+                return;
+            const detail = this.stderr.trim();
+            const error = new Error(`termctrl driver exited (${signal ?? code ?? "unknown"})${detail ? `: ${detail}` : ""}`);
+            this.abort(error);
+        });
+    }
+    static async make(options = {}) {
+        const client = new TerminalControl(options);
+        await client.ready;
+        return client;
+    }
+    async launch(options) {
+        const sessionId = `session-${this.nextSessionId++}`;
+        const temporaryRecording = options.record === true || options.record === "on-failure"
+            ? join(tmpdir(), `termctrl-${process.pid}-${randomUUID()}.termctrl`)
+            : undefined;
+        const record = temporaryRecording ?? options.record;
+        await this.request("launch", {
+            command: [...options.command],
+            cwd: options.cwd,
+            record,
+            cols: options.viewport?.cols,
+            rows: options.viewport?.rows,
+            cellWidth: options.viewport?.cellWidth,
+            cellHeight: options.viewport?.cellHeight,
+            host: options.host,
+            color: options.color,
+            maxBytes: options.maxBytes,
+            env: options.env,
+            inheritEnv: options.inheritEnv,
+        }, sessionId);
+        return new Session((method, params, id) => this.request(method, params, id), sessionId, this.artifacts, temporaryRecording, options);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        await this.request("shutdown");
+        this.child.stdin.end();
+        this.closed = true;
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+    async request(method, params, sessionId) {
+        await this.ready;
+        if (this.closed)
+            throw new Error("termctrl driver is closed");
+        const id = this.nextRequestId++;
+        const result = new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+        });
+        const request = JSON.stringify({ id, method, sessionId, ...(params === undefined ? {} : { params }) });
+        this.child.stdin.write(`${request}\n`, (error) => {
+            if (!error)
+                return;
+            const pending = this.pending.get(id);
+            this.pending.delete(id);
+            pending?.reject(error);
+            this.abort(error);
+        });
+        return result;
+    }
+    failAll(error) {
+        for (const pending of this.pending.values())
+            pending.reject(error);
+        this.pending.clear();
+    }
+    abort(error) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (!this.readySettled) {
+            this.readySettled = true;
+            this.rejectReady(error);
+        }
+        this.failAll(error);
+        this.child.stdin.destroy();
+        this.child.kill();
+    }
+}
+export class Session {
+    request;
+    id;
+    artifacts;
+    temporaryRecording;
+    launchOptions;
+    screen;
+    keyboard;
+    logs;
+    transcript;
+    stopped = false;
+    constructor(request, id, artifacts = false, temporaryRecording, launchOptions) {
+        this.request = request;
+        this.id = id;
+        this.artifacts = artifacts;
+        this.temporaryRecording = temporaryRecording;
+        this.launchOptions = launchOptions;
+        this.screen = new Screen(request, id);
+        this.keyboard = new Keyboard(request, id);
+        this.logs = new Logs(request, id);
+        this.transcript = new Transcript(request, id);
+    }
+    status() {
+        return this.request("status", undefined, this.id).then((status) => ({
+            state: status.state,
+            exit: status.exit,
+            cols: status.cols,
+            rows: status.rows,
+            cellWidth: status.cell_width,
+            cellHeight: status.cell_height,
+            idleForMs: status.idle_for_ms,
+            hasVisibleContent: status.has_visible_content,
+            recording: status.recording,
+            logsTruncated: status.logs_truncated,
+        }));
+    }
+    waitForExit(options = {}) {
+        return this.request("waitForExit", { timeoutMs: options.timeoutMs }, this.id);
+    }
+    resize(viewport) {
+        return this.request("resize", {
+            cols: viewport.cols,
+            rows: viewport.rows,
+            cellWidth: viewport.cellWidth,
+            cellHeight: viewport.cellHeight,
+        }, this.id);
+    }
+    async recording() {
+        const result = await this.request("recording", undefined, this.id);
+        return Uint8Array.from(result.bytes);
+    }
+    async saveRecording(path) {
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, await this.recording());
+    }
+    shouldWriteFailureArtifacts() {
+        return this.artifacts !== false && this.artifacts.onFailure !== false;
+    }
+    async writeArtifacts(name = this.id) {
+        if (!this.artifacts)
+            throw new Error("configure Terminal Control artifacts before writing failure evidence");
+        const directory = join(this.artifacts.directory, artifactName(name));
+        const includeTranscript = this.artifacts.includeTranscript === true;
+        const capture = await this.screen.capture({
+            allowIncomplete: true,
+            includeAnsi: includeTranscript,
+            includeSvg: true,
+            deadlineMs: 250,
+        });
+        const [logs, status] = await Promise.all([this.logs.text(), this.status()]);
+        await mkdir(directory, { recursive: true });
+        const manifest = {
+            directory,
+            screenText: join(directory, "screen.txt"),
+            screenFrame: join(directory, "screen.json"),
+            screenSvg: join(directory, "screen.svg"),
+            metadata: join(directory, "metadata.json"),
+            logsText: join(directory, "logs.txt"),
+        };
+        await Promise.all([
+            writeFile(manifest.screenText, capture.text),
+            writeFile(manifest.screenFrame, JSON.stringify(capture.frame, null, 2)),
+            writeFile(manifest.screenSvg, capture.svg ?? ""),
+            writeFile(manifest.logsText, logs),
+            writeFile(manifest.metadata, JSON.stringify({
+                sessionId: this.id,
+                captureReason: capture.reason,
+                launch: artifactLaunchOptions(this.launchOptions),
+                status,
+            }, null, 2)),
+        ]);
+        if (includeTranscript && capture.ansi) {
+            manifest.transcript = join(directory, "transcript.ansi");
+            await writeFile(manifest.transcript, capture.ansi);
+        }
+        if (this.artifacts.includeRecording && status.recording) {
+            manifest.recording = join(directory, "recording.termctrl");
+            await writeFile(manifest.recording, await this.recording());
+        }
+        return manifest;
+    }
+    async withArtifactsOnFailure(name, run) {
+        try {
+            return await run();
+        }
+        catch (error) {
+            if (this.shouldWriteFailureArtifacts())
+                await this.writeArtifacts(name);
+            throw error;
+        }
+    }
+    async stop() {
+        if (this.stopped)
+            return;
+        await this.request("stop", undefined, this.id);
+        this.stopped = true;
+        if (this.temporaryRecording)
+            await rm(this.temporaryRecording, { force: true });
+    }
+    async [Symbol.asyncDispose]() {
+        await this.stop();
+    }
+}
+export class Screen {
+    request;
+    sessionId;
+    constructor(request, sessionId) {
+        this.request = request;
+        this.sessionId = sessionId;
+    }
+    waitForText(text, options = {}) {
+        if (typeof text === "string") {
+            return this.request("waitForText", { text, timeoutMs: options.timeoutMs }, this.sessionId);
+        }
+        return this.waitUntil((snapshot) => {
+            text.lastIndex = 0;
+            return text.test(snapshot.text);
+        }, options).then(() => undefined);
+    }
+    waitForIdle(options = {}) {
+        return this.request("waitForIdle", {
+            quietForMs: options.quietForMs,
+            timeoutMs: options.timeoutMs,
+        }, this.sessionId);
+    }
+    async waitUntil(predicate, options = {}) {
+        const timeoutMs = options.timeoutMs ?? 5_000;
+        const deadline = Date.now() + timeoutMs;
+        while (true) {
+            const snapshot = await this.capture({ allowIncomplete: true, settleMs: 0, deadlineMs: 0 });
+            if (await predicate(snapshot))
+                return snapshot;
+            if (Date.now() >= deadline)
+                throw new Error("timed out waiting for visible terminal predicate");
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+    async capture(options = {}) {
+        const wire = await this.request("capture", {
+            settleMs: options.settleMs,
+            deadlineMs: options.deadlineMs,
+            includeAnsi: options.includeAnsi === true,
+            includeSvg: options.includeSvg === true,
+        }, this.sessionId);
+        const capture = {
+            reason: wire.reason,
+            frame: wire.shot.frame,
+            text: wire.shot.text,
+            ...(options.includeAnsi ? { ansi: Uint8Array.from(wire.shot.ansi) } : {}),
+            ...(wire.shot.svg ? { svg: wire.shot.svg } : {}),
+        };
+        if (!options.allowIncomplete && (capture.reason === "deadline" || capture.reason === "outputclosed")) {
+            throw new IncompleteCaptureError(capture);
+        }
+        return capture;
+    }
+    async frame(options = {}) {
+        return (await this.capture(options)).frame;
+    }
+    async text(options = {}) {
+        return (await this.capture(options)).text;
+    }
+}
+export class Keyboard {
+    request;
+    sessionId;
+    constructor(request, sessionId) {
+        this.request = request;
+        this.sessionId = sessionId;
+    }
+    type(value, options = {}) {
+        return this.send([{ type: "text", value }], options.paceMs);
+    }
+    press(key) {
+        return this.send([keyAtom(key)]);
+    }
+    sequence(keys, options = {}) {
+        return this.send(keys.map(keyAtom), options.paceMs);
+    }
+    write(value) {
+        return this.send([{ type: "bytes", value: Array.from(value) }]);
+    }
+    send(input, paceMs = 0) {
+        return this.request("send", { input, paceMs }, this.sessionId);
+    }
+}
+export class Logs {
+    request;
+    sessionId;
+    constructor(request, sessionId) {
+        this.request = request;
+        this.sessionId = sessionId;
+    }
+    async text() {
+        const result = await this.request("logs", { ansi: false }, this.sessionId);
+        return new TextDecoder().decode(Uint8Array.from(result.bytes));
+    }
+}
+export class Transcript {
+    request;
+    sessionId;
+    constructor(request, sessionId) {
+        this.request = request;
+        this.sessionId = sessionId;
+    }
+    async ansi() {
+        const result = await this.request("logs", { ansi: true }, this.sessionId);
+        return Uint8Array.from(result.bytes);
+    }
+}
+const namedKeys = {
+    Enter: "enter",
+    Escape: "escape",
+    ArrowUp: "arrowUp",
+    ArrowDown: "arrowDown",
+    ArrowLeft: "arrowLeft",
+    ArrowRight: "arrowRight",
+    Tab: "tab",
+    "Shift+Tab": "shiftTab",
+    Backspace: "backspace",
+    Delete: "delete",
+    Home: "home",
+    End: "end",
+    PageUp: "pageUp",
+    PageDown: "pageDown",
+};
+function keyAtom(key) {
+    if (isControlKey(key)) {
+        return { type: "control", value: key.slice("Control+".length).toLowerCase() };
+    }
+    return { type: "key", value: namedKeys[key] };
+}
+function isControlKey(key) {
+    return key.startsWith("Control+");
+}
+function artifactName(name) {
+    const safe = name.replace(/[^A-Za-z0-9_.-]+/g, "-").replace(/^-+|-+$/g, "");
+    return safe || "failure";
+}
+function artifactLaunchOptions(options) {
+    if (!options?.env)
+        return options;
+    return {
+        ...options,
+        env: Object.fromEntries(Object.keys(options.env).map((key) => [key, "[redacted]"])),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/vitest.d.ts

@@ -0,0 +1,21 @@
+type MatcherResult = {
+    pass: boolean;
+    message: () => string;
+};
+type MatcherRegistry = {
+    extend(matchers: Record<string, (received: unknown, expected: string) => Promise<MatcherResult>>): void;
+};
+export declare const terminalControlMatchers: {
+    toHaveScreenText(received: unknown, expected: string): Promise<MatcherResult>;
+};
+export declare function extendTerminalControlMatchers(expect: MatcherRegistry): void;
+declare module "vitest" {
+    interface Assertion<T> {
+        toHaveScreenText(expected: string): Promise<void>;
+    }
+    interface AsymmetricMatchersContaining {
+        toHaveScreenText(expected: string): Promise<void>;
+    }
+}
+export {};
+//# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAGA,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,MAAM,CAAA;CACtB,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,IAAI,CAAA;CACxG,CAAA;AAED,eAAO,MAAM,uBAAuB;+BACD,OAAO,YAAY,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CA8BpF,CAAA;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE3E;AAED,OAAO,QAAQ,QAAQ,CAAC;IACtB,UAAU,SAAS,CAAC,CAAC;QACnB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAClD;IAED,UAAU,4BAA4B;QACpC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAClD;CACF"}

package/dist/vitest.js

@@ -0,0 +1,39 @@
+import { IncompleteCaptureError, Screen, Session } from "./index.js";
+export const terminalControlMatchers = {
+    async toHaveScreenText(received, expected) {
+        if (!(received instanceof Session) && !(received instanceof Screen)) {
+            return {
+                pass: false,
+                message: () => "toHaveScreenText expects a Terminal Control Session or Screen",
+            };
+        }
+        const screen = received instanceof Session ? received.screen : received;
+        let actual;
+        let incomplete = "";
+        try {
+            actual = await screen.text();
+        }
+        catch (error) {
+            if (!(error instanceof IncompleteCaptureError))
+                throw error;
+            actual = error.capture.text;
+            incomplete = `\nCapture was incomplete: ${error.capture.reason}.`;
+        }
+        const pass = incomplete === "" && actual === expected;
+        let artifact = "";
+        if (!pass && received instanceof Session && received.shouldWriteFailureArtifacts()) {
+            const files = await received.writeArtifacts("screen-text");
+            artifact = `\nArtifacts: ${files.directory}`;
+        }
+        return {
+            pass,
+            message: () => pass
+                ? "expected visible terminal screen not to equal the supplied text"
+                : `expected visible terminal screen:\n${expected}\n\nreceived:\n${actual}${incomplete}${artifact}`,
+        };
+    },
+};
+export function extendTerminalControlMatchers(expect) {
+    expect.extend(terminalControlMatchers);
+}
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.js","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAYpE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,KAAK,CAAC,gBAAgB,CAAC,QAAiB,EAAE,QAAgB;QACxD,IAAI,CAAC,CAAC,QAAQ,YAAY,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,YAAY,MAAM,CAAC,EAAE,CAAC;YACpE,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,GAAG,EAAE,CAAC,+DAA+D;aAC/E,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,YAAY,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAA;QACvE,IAAI,MAAc,CAAA;QAClB,IAAI,UAAU,GAAG,EAAE,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,sBAAsB,CAAC;gBAAE,MAAM,KAAK,CAAA;YAC3D,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAA;YAC3B,UAAU,GAAG,6BAA6B,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAA;QACnE,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,KAAK,EAAE,IAAI,MAAM,KAAK,QAAQ,CAAA;QACrD,IAAI,QAAQ,GAAG,EAAE,CAAA;QACjB,IAAI,CAAC,IAAI,IAAI,QAAQ,YAAY,OAAO,IAAI,QAAQ,CAAC,2BAA2B,EAAE,EAAE,CAAC;YACnF,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;YAC1D,QAAQ,GAAG,gBAAgB,KAAK,CAAC,SAAS,EAAE,CAAA;QAC9C,CAAC;QACD,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;gBACjB,CAAC,CAAC,iEAAiE;gBACnE,CAAC,CAAC,sCAAsC,QAAQ,kBAAkB,MAAM,GAAG,UAAU,GAAG,QAAQ,EAAE;SACrG,CAAA;IACH,CAAC;CACF,CAAA;AAED,MAAM,UAAU,6BAA6B,CAAC,MAAuB;IACnE,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAA;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@kitlangton/terminal-control",
+  "version": "0.1.0",
+  "description": "Typed terminal application control and testing with snapshots, recordings, and failure artifacts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kitlangton/terminal-control.git",
+    "directory": "packages/test"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vitest": {
+      "types": "./dist/vitest.d.ts",
+      "import": "./dist/vitest.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "test": "cargo build --manifest-path ../../Cargo.toml --bin termctrl && bun test src/index.test.ts",
+    "typecheck": "tsc --noEmit",
+    "prepack": "bun run build"
+  },
+  "optionalDependencies": {
+    "@kitlangton/terminal-control-darwin-arm64": "0.1.0",
+    "@kitlangton/terminal-control-darwin-x64": "0.1.0",
+    "@kitlangton/terminal-control-linux-arm64-gnu": "0.1.0",
+    "@kitlangton/terminal-control-linux-x64-gnu": "0.1.0"
+  },
+  "peerDependencies": {
+    "vitest": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.0",
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.4"
+  }
+}