@seanhogg/builderforce-webcontainers-core 2026.10.1 → 2026.10.3

package/dist/system/ports.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The virtual network: which handler serves which port. One registry per
+ * runtime (kernel or browser host), shared by every process in it, so a server
+ * in one process is reachable from another (`fetch('http://localhost:3000')`)
+ * and from the preview service worker (`/__bfwc/<id>/__port/3000/`).
+ */
+import type { HttpHandler, HttpRequestData, HttpResponseData } from './types.js';
+export interface PortEvent {
+    type: 'open' | 'close';
+    port: number;
+}
+export declare class PortRegistry {
+    private readonly handlers;
+    private readonly listeners;
+    private nextEphemeral;
+    listen(port: number, handler: HttpHandler): {
+        port: number;
+        close(): void;
+    };
+    has(port: number): boolean;
+    ports(): number[];
+    /** Dispatch to the server on `port`; undefined when nothing listens there. */
+    request(port: number, request: HttpRequestData): Promise<HttpResponseData | undefined>;
+    watch(listener: (event: PortEvent) => void): () => void;
+    private emit;
+}
+/** `/__port/3000/api?x` → port 3000, path `/api`. Undefined for any other path. */
+export declare function parsePortPath(path: string): {
+    port: number;
+    path: string;
+} | undefined;
+//# sourceMappingURL=ports.d.ts.map

package/dist/system/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/system/ports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,aAAa,CAAmB;IAExC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,IAAI,IAAI,CAAA;KAAE;IAuB3E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,KAAK,IAAI,MAAM,EAAE;IAIjB,8EAA8E;IACxE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAK5F,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAKvD,OAAO,CAAC,IAAI;CAGb;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAItF"}

package/dist/system/ports.js

@@ -0,0 +1,57 @@
+const EPHEMERAL_START = 49152;
+export class PortRegistry {
+    handlers = new Map();
+    listeners = new Set();
+    nextEphemeral = EPHEMERAL_START;
+    listen(port, handler) {
+        let actual = port;
+        if (!actual) {
+            while (this.handlers.has(this.nextEphemeral))
+                this.nextEphemeral++;
+            actual = this.nextEphemeral++;
+        }
+        if (this.handlers.has(actual)) {
+            throw Object.assign(new Error(`listen EADDRINUSE: address already in use :::${actual}`), { code: 'EADDRINUSE', errno: -98, syscall: 'listen', address: '::', port: actual });
+        }
+        this.handlers.set(actual, handler);
+        this.emit({ type: 'open', port: actual });
+        let open = true;
+        return {
+            port: actual,
+            close: () => {
+                if (!open || this.handlers.get(actual) !== handler)
+                    return;
+                open = false;
+                this.handlers.delete(actual);
+                this.emit({ type: 'close', port: actual });
+            },
+        };
+    }
+    has(port) {
+        return this.handlers.has(port);
+    }
+    ports() {
+        return [...this.handlers.keys()].sort((a, b) => a - b);
+    }
+    /** Dispatch to the server on `port`; undefined when nothing listens there. */
+    async request(port, request) {
+        const handler = this.handlers.get(port);
+        return handler ? handler(request) : undefined;
+    }
+    watch(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    emit(event) {
+        for (const listener of this.listeners)
+            listener(event);
+    }
+}
+/** `/__port/3000/api?x` → port 3000, path `/api`. Undefined for any other path. */
+export function parsePortPath(path) {
+    const m = /^\/__port\/(\d{1,5})(\/.*)?$/.exec(path);
+    if (!m)
+        return undefined;
+    return { port: Number(m[1]), path: m[2] ?? '/' };
+}
+//# sourceMappingURL=ports.js.map

package/dist/system/ports.js.map

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

package/dist/system/process.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Running one program in-process: its stdin queue, TTY line discipline,
+ * output listeners and kill signal, packaged as a {@link ChildHandle}. The core
+ * kernel uses it for every process; the browser worker uses it for the one
+ * program it hosts. Also the WebContainer-shaped wrapper (`output`/`input`
+ * streams) that public `spawn` returns.
+ */
+import type { ChildHandle, Program, SpawnOptions, System } from './types.js';
+export declare function allocatePid(): number;
+export interface RunProgramOptions extends SpawnOptions {
+    program: Program;
+    args: string[];
+    system: System;
+    cwd: string;
+    env: Record<string, string>;
+    pid?: number;
+}
+export declare function runProgram(options: RunProgramOptions): ChildHandle;
+/** The public process shape, deliberately the same as `@webcontainer/api`'s `WebContainerProcess`. */
+export interface WebContainerProcess {
+    /** stdout and stderr, interleaved as written (`\r\n` line endings when attached to a terminal). */
+    readonly output: ReadableStream<string>;
+    readonly input: WritableStream<string>;
+    readonly exit: Promise<number>;
+    kill(signal?: string): void;
+    resize(dimensions: {
+        cols: number;
+        rows: number;
+    } | number, rows?: number): void;
+}
+export declare function toWebContainerProcess(child: ChildHandle, terminal: boolean): WebContainerProcess;
+//# sourceMappingURL=process.d.ts.map

package/dist/system/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/system/process.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAa,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAKxF,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAWD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAwFlE;AAED,sGAAsG;AACtG,MAAM,WAAW,mBAAmB;IAClC,mGAAmG;IACnG,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAuBhG"}

package/dist/system/process.js

@@ -0,0 +1,130 @@
+import { InputQueue, LineDiscipline, toTerminal } from './terminal.js';
+let nextPid = 1000;
+export function allocatePid() {
+    return nextPid++;
+}
+/** Decode byte chunks without splitting multi-byte characters across writes. */
+function textSink(emit) {
+    const decoder = new TextDecoder();
+    return (chunk) => {
+        const text = typeof chunk === 'string' ? chunk : decoder.decode(chunk, { stream: true });
+        if (text)
+            emit(text);
+    };
+}
+export function runProgram(options) {
+    const pid = options.pid ?? allocatePid();
+    const stdin = new InputQueue();
+    const stdoutListeners = new Set();
+    const stderrListeners = new Set();
+    const resizeListeners = new Set();
+    const controller = new AbortController();
+    const emitOut = (text) => stdoutListeners.forEach((l) => l(text));
+    const emitErr = (text) => stderrListeners.forEach((l) => l(text));
+    let settled = false;
+    let forceExit = () => undefined;
+    const kill = (signal = 'SIGTERM') => {
+        if (settled)
+            return;
+        if (!controller.signal.aborted)
+            controller.abort(signal);
+        else if (signal === 'SIGKILL')
+            forceExit(137);
+    };
+    const size = options.terminal ? { ...options.terminal } : undefined;
+    const discipline = size
+        ? new LineDiscipline({ echo: emitOut, deliver: (chunk) => stdin.push(chunk), signal: (name) => kill(name) })
+        : undefined;
+    const io = {
+        stdout: textSink(emitOut),
+        stderr: textSink(emitErr),
+        onStdin: (listener) => stdin.subscribe(listener),
+        terminal: size && discipline
+            ? {
+                get cols() {
+                    return size.cols;
+                },
+                get rows() {
+                    return size.rows;
+                },
+                onResize(listener) {
+                    resizeListeners.add(listener);
+                    return () => resizeListeners.delete(listener);
+                },
+                setRawMode(raw) {
+                    discipline.raw = raw;
+                },
+            }
+            : undefined,
+    };
+    const exit = new Promise((resolve) => {
+        forceExit = (code) => {
+            settled = true;
+            resolve(code);
+        };
+        queueMicrotask(async () => {
+            let code;
+            try {
+                code = await options.program({ args: options.args, cwd: options.cwd, env: options.env, io, system: options.system, signal: controller.signal });
+            }
+            catch (error) {
+                io.stderr(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+                code = 1;
+            }
+            settled = true;
+            resolve(code);
+        });
+    });
+    return {
+        pid,
+        onStdout(listener) {
+            stdoutListeners.add(listener);
+            return () => stdoutListeners.delete(listener);
+        },
+        onStderr(listener) {
+            stderrListeners.add(listener);
+            return () => stderrListeners.delete(listener);
+        },
+        write(data) {
+            if (discipline)
+                discipline.input(data);
+            else
+                stdin.push(data);
+        },
+        closeStdin: () => stdin.push(null),
+        kill,
+        resize(cols, rows) {
+            if (!size)
+                return;
+            size.cols = cols;
+            size.rows = rows;
+            resizeListeners.forEach((l) => l(cols, rows));
+        },
+        exit,
+    };
+}
+export function toWebContainerProcess(child, terminal) {
+    const output = new ReadableStream({
+        start(controller) {
+            const push = (chunk) => controller.enqueue(terminal ? toTerminal(chunk) : chunk);
+            child.onStdout(push);
+            child.onStderr(push);
+            void child.exit.then(() => controller.close());
+        },
+    });
+    const input = new WritableStream({
+        write: (chunk) => child.write(chunk),
+        close: () => child.closeStdin(),
+    });
+    return {
+        output,
+        input,
+        exit: child.exit,
+        kill: (signal) => child.kill(signal),
+        resize(dimensions, rows) {
+            const size = typeof dimensions === 'number' ? { cols: dimensions, rows: rows ?? 24 } : dimensions;
+            child.resize?.(size.cols, size.rows);
+        },
+    };
+}
+//# sourceMappingURL=process.js.map

package/dist/system/process.js.map

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

package/dist/system/programs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The command table: every program a process can be. Hosts start from
+ * `defaultPrograms()` and may add or replace entries (a custom `git`, say).
+ *
+ * `npm`/`npx` live in the shell (they run scripts through it), so spawning them
+ * directly runs them through a one-shot shell; coreutils run standalone.
+ */
+import type { Program } from './types.js';
+export declare function defaultPrograms(): Record<string, Program>;
+//# sourceMappingURL=programs.d.ts.map

package/dist/system/programs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../../src/system/programs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAY1C,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzD"}

package/dist/system/programs.js

@@ -0,0 +1,22 @@
+import { nodeProgram } from '../node/program.js';
+import { shellProgram } from '../shell/program.js';
+import { COREUTILS } from '../shell/builtins.js';
+import { asProgram } from '../shell/context.js';
+const quote = (arg) => (/^[\w@%+=:,./-]+$/.test(arg) ? arg : `'${arg.replace(/'/g, `'\\''`)}'`);
+function viaShell(command) {
+    return (ctx) => shellProgram({ ...ctx, args: ['-c', [command, ...ctx.args].map(quote).join(' ')] });
+}
+export function defaultPrograms() {
+    const programs = {
+        node: nodeProgram,
+        jsh: shellProgram,
+        sh: shellProgram,
+        bash: shellProgram,
+        npm: viaShell('npm'),
+        npx: viaShell('npx'),
+    };
+    for (const [name, command] of Object.entries(COREUTILS))
+        programs[name] = asProgram(command, name);
+    return programs;
+}
+//# sourceMappingURL=programs.js.map

package/dist/system/programs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../src/system/programs.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AAExG,SAAS,QAAQ,CAAC,OAAe;IAC/B,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,QAAQ,GAA4B;QACxC,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,YAAY;QACjB,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC;QACpB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC;KACrB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnG,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/system/terminal.d.ts

@@ -0,0 +1,45 @@
+/**
+ * What a kernel's TTY layer does between xterm.js and a program:
+ *
+ * - InputQueue: stdin as a buffered stream of string chunks (data that arrives
+ *   before the program subscribes is kept, not dropped).
+ * - LineDiscipline: "cooked" mode — echo, backspace, Ctrl-U, Enter delivers the
+ *   line, Ctrl-C raises SIGINT, Ctrl-D is end-of-file. A program that calls
+ *   `setRawMode(true)` (the shell, prompts libraries) gets keystrokes untouched.
+ * - toTerminal: `\n` → `\r\n` on output (the TTY's ONLCR), since xterm.js
+ *   only moves to column 0 on `\r`.
+ */
+export declare class InputQueue {
+    private readonly buffered;
+    private readonly listeners;
+    private ended;
+    private draining;
+    push(chunk: string | null): void;
+    subscribe(listener: (chunk: string | null) => void): () => void;
+    /**
+     * Deliver on a microtask: a subscriber has always stored its unsubscribe
+     * function by then, and chunks stay buffered until someone is actually
+     * listening — one that leaves early does not take data with it.
+     */
+    private drain;
+    /** Everything until end-of-file. */
+    readAll(): Promise<string>;
+    get isEnded(): boolean;
+}
+export declare function toTerminal(text: string): string;
+export interface LineDisciplineOptions {
+    /** Echo to the terminal. */
+    echo(text: string): void;
+    /** A completed line (with its `\n`), or `null` for end-of-file. */
+    deliver(chunk: string | null): void;
+    /** Ctrl-C / Ctrl-\. */
+    signal(name: 'SIGINT' | 'SIGQUIT'): void;
+}
+export declare class LineDiscipline {
+    private readonly options;
+    raw: boolean;
+    private line;
+    constructor(options: LineDisciplineOptions);
+    input(data: string): void;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/dist/system/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/system/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IACvE,OAAO,CAAC,KAAK,CAAS;IAEtB,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAOhC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAM/D;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAYb,oCAAoC;IACpC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAY1B,IAAI,OAAO,IAAI,OAAO,CAErB;CACF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,uBAAuB;IACvB,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;CAC1C;AAED,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,GAAG,UAAS;IACZ,OAAO,CAAC,IAAI,CAAM;gBAEW,OAAO,EAAE,qBAAqB;IAE3D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAgD1B"}

package/dist/system/terminal.js

@@ -0,0 +1,127 @@
+/**
+ * What a kernel's TTY layer does between xterm.js and a program:
+ *
+ * - InputQueue: stdin as a buffered stream of string chunks (data that arrives
+ *   before the program subscribes is kept, not dropped).
+ * - LineDiscipline: "cooked" mode — echo, backspace, Ctrl-U, Enter delivers the
+ *   line, Ctrl-C raises SIGINT, Ctrl-D is end-of-file. A program that calls
+ *   `setRawMode(true)` (the shell, prompts libraries) gets keystrokes untouched.
+ * - toTerminal: `\n` → `\r\n` on output (the TTY's ONLCR), since xterm.js
+ *   only moves to column 0 on `\r`.
+ */
+export class InputQueue {
+    buffered = [];
+    listeners = new Set();
+    ended = false;
+    draining = false;
+    push(chunk) {
+        if (this.ended)
+            return;
+        if (chunk === null)
+            this.ended = true;
+        this.buffered.push(chunk);
+        this.drain();
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        this.drain();
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Deliver on a microtask: a subscriber has always stored its unsubscribe
+     * function by then, and chunks stay buffered until someone is actually
+     * listening — one that leaves early does not take data with it.
+     */
+    drain() {
+        if (this.draining || !this.listeners.size || !this.buffered.length)
+            return;
+        this.draining = true;
+        queueMicrotask(() => {
+            this.draining = false;
+            while (this.buffered.length && this.listeners.size) {
+                const chunk = this.buffered.shift();
+                for (const listener of [...this.listeners])
+                    listener(chunk);
+            }
+        });
+    }
+    /** Everything until end-of-file. */
+    readAll() {
+        return new Promise((resolve) => {
+            let text = '';
+            const stop = this.subscribe((chunk) => {
+                if (chunk === null) {
+                    stop();
+                    resolve(text);
+                }
+                else
+                    text += chunk;
+            });
+        });
+    }
+    get isEnded() {
+        return this.ended;
+    }
+}
+export function toTerminal(text) {
+    return text.replace(/\r?\n/g, '\r\n');
+}
+export class LineDiscipline {
+    options;
+    raw = false;
+    line = '';
+    constructor(options) {
+        this.options = options;
+    }
+    input(data) {
+        if (this.raw) {
+            this.options.deliver(data);
+            return;
+        }
+        // Arrow keys and other escape sequences have no meaning in cooked mode.
+        const text = data.replace(/\x1b\[[0-9;]*[A-Za-z~]|\x1bO[A-Za-z]/g, '');
+        for (const ch of text) {
+            switch (ch) {
+                case '\r':
+                case '\n':
+                    this.options.echo('\r\n');
+                    this.options.deliver(this.line + '\n');
+                    this.line = '';
+                    break;
+                case '\x7f':
+                case '\b':
+                    if (this.line) {
+                        this.line = [...this.line].slice(0, -1).join('');
+                        this.options.echo('\b \b');
+                    }
+                    break;
+                case '\x03':
+                    this.options.echo('^C\r\n');
+                    this.line = '';
+                    this.options.signal('SIGINT');
+                    break;
+                case '\x1c':
+                    this.options.signal('SIGQUIT');
+                    break;
+                case '\x04':
+                    if (this.line) {
+                        this.options.deliver(this.line);
+                        this.line = '';
+                    }
+                    else
+                        this.options.deliver(null);
+                    break;
+                case '\x15':
+                    this.options.echo('\b \b'.repeat([...this.line].length));
+                    this.line = '';
+                    break;
+                default:
+                    if (ch >= ' ' || ch === '\t') {
+                        this.line += ch;
+                        this.options.echo(ch);
+                    }
+            }
+        }
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/system/terminal.js.map

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

package/dist/system/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * The contract between programs (node, the shell, npm, coreutils) and whatever
+ * hosts them. Programs only ever see these ports, so the same program code runs
+ * in-process under the core `Kernel` (Node tests) and one-per-Web-Worker in the
+ * browser runtime, where `spawn` and `listen` are relayed to the page.
+ */
+import type { VirtualFileSystem } from '../vfs.js';
+import type { PackageCache } from '../installer/registry.js';
+export interface TerminalPort {
+    cols: number;
+    rows: number;
+    onResize(listener: (cols: number, rows: number) => void): () => void;
+    /** Raw mode: the program handles keystrokes itself (no line editing, no echo). */
+    setRawMode(raw: boolean): void;
+}
+export interface ProgramIO {
+    stdout(chunk: string | Uint8Array): void;
+    stderr(chunk: string | Uint8Array): void;
+    /** Stdin chunks as they arrive; `null` is end-of-file. Buffered until the first subscriber. */
+    onStdin(listener: (chunk: string | null) => void): () => void;
+    /** Present when attached to a terminal (xterm.js). */
+    terminal?: TerminalPort;
+}
+export interface SpawnOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    /** Attach to a terminal of this size (`isTTY`, line discipline, `\r\n` output). */
+    terminal?: {
+        cols: number;
+        rows: number;
+    };
+}
+/** A child as its parent sees it (separate stdout/stderr, unlike the public API). */
+export interface ChildHandle {
+    readonly pid: number;
+    onStdout(listener: (chunk: string) => void): () => void;
+    onStderr(listener: (chunk: string) => void): () => void;
+    write(data: string): void;
+    closeStdin(): void;
+    kill(signal?: string): void;
+    resize?(cols: number, rows: number): void;
+    readonly exit: Promise<number>;
+}
+export interface HttpRequestData {
+    method: string;
+    /** Path and query, as the server sees it (`/api?x=1`). */
+    url: string;
+    headers: Record<string, string>;
+    body: Uint8Array | null;
+}
+export interface HttpResponseData {
+    status: number;
+    statusText?: string;
+    headers: Record<string, string | string[]>;
+    body: Uint8Array;
+}
+export type HttpHandler = (request: HttpRequestData) => Promise<HttpResponseData>;
+export interface System {
+    fs: VirtualFileSystem;
+    /** Outbound network (registry, `http.request`, `fetch`). */
+    fetch(input: string, init?: RequestInit): Promise<Response>;
+    spawn(command: string, args: string[], options?: SpawnOptions): ChildHandle;
+    /** Register a virtual server; throws `EADDRINUSE`. Port 0 picks a free one. Returns the port and an unlisten. */
+    listen(port: number, handler: HttpHandler): {
+        port: number;
+        close(): void;
+    };
+    /** Send a request to a virtual server in this runtime (`http.get('http://localhost:3000')`); undefined when nothing listens. */
+    loopback(port: number, request: HttpRequestData): Promise<HttpResponseData | undefined>;
+    /** Where a browser reaches a server on `port` (the preview URL), if known. */
+    serverUrl(port: number): string | undefined;
+    /** Tell the host a server is ready (`server-ready`); used by the dev-server handoff. */
+    announceServer(port: number, url: string): void;
+    /** The in-browser dev server's preview URL, for `vite`/`react-scripts start` handoff. */
+    previewUrl?: string;
+    /**
+     * This program has the JS realm to itself (one process per Web Worker): node
+     * may install `process`, `Buffer`, timers on `globalThis`, and the host routes
+     * the realm's uncaught errors to it through `trapUncaught`.
+     */
+    ownsRealm?: boolean;
+    /** Register for the realm's uncaught errors and unhandled rejections. */
+    trapUncaught?(handler: (error: unknown) => void): () => void;
+    /** npm registry and cache for `npm install`. */
+    registry?: string;
+    packageCache?: PackageCache;
+}
+export interface ProgramContext {
+    /** Arguments after the program name. */
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    io: ProgramIO;
+    system: System;
+    /** Aborted by kill(): in-process programs stop at their next await. */
+    signal: AbortSignal;
+}
+/** A program resolves with its exit code. */
+export type Program = (ctx: ProgramContext) => Promise<number>;
+//# sourceMappingURL=types.d.ts.map

package/dist/system/types.d.ts.map

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

package/dist/system/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/system/types.js.map

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