@seanhogg/builderforce-webcontainers-core 2026.10.1 → 2026.10.3

package/dist/shell/builtins.js

@@ -0,0 +1,131 @@
+/**
+ * Builtins that change or inspect the shell itself (cd, export, exit…), plus
+ * the command tables the executor dispatches on.
+ */
+import { findExecutable } from '../system/commands.js';
+import { resolvePath } from './context.js';
+import { cat, cp, ls, mkdir, mv, pwd, rm, touch } from './fileCommands.js';
+import { basename, clear, dirname, echo, env, falseCommand, grep, head, printf, sleep, tail, trueCommand, wc } from './textCommands.js';
+/** Coreutils: plain commands, also spawnable as standalone programs. */
+export const COREUTILS = {
+    ls, cat, mkdir, rm, cp, mv, touch, pwd, echo, printf, head, tail, grep, wc, env, clear, sleep, basename, dirname,
+    true: trueCommand,
+    false: falseCommand,
+};
+/** Programs the runtime provides besides coreutils (reported by `which`/`type`). */
+export const SYSTEM_PROGRAMS = ['node', 'npm', 'npx', 'jsh', 'sh', 'bash'];
+const HELP = `jsh — BuilderForce WebContainers shell
+
+  Builtins:  cd, pwd, export, unset, exit, source, history, type, which, help
+  Files:     ls [-la], cat, mkdir [-p], rm [-rf], cp [-r], mv, touch
+  Text:      echo, printf, head, tail, grep, wc, env, clear, sleep, basename, dirname
+  Node:      node <file>, npm install|ci|run|start|test, npx <bin>
+  Syntax:    'quotes' "\$VARS" a && b || c; a | b > out.txt >> log 2>&1 2> err; FOO=bar cmd; $(cmd); *.js
+
+`;
+export const BUILTINS = {
+    async cd(ctx, shell) {
+        const home = shell.env.HOME && ctx.fs.isDirectory(shell.env.HOME) ? shell.env.HOME : '/';
+        const target = ctx.args[0] === '-' ? shell.env.OLDPWD ?? shell.cwd : ctx.args[0] ?? home;
+        const path = resolvePath(ctx, target);
+        if (!ctx.fs.isDirectory(path)) {
+            ctx.io.stderr(`cd: ${ctx.fs.isFile(path) ? 'not a directory' : 'no such file or directory'}: ${target}\n`);
+            return 1;
+        }
+        shell.env.OLDPWD = shell.cwd;
+        shell.cwd = path;
+        shell.env.PWD = path;
+        if (ctx.args[0] === '-')
+            ctx.io.stdout(path + '\n');
+        return 0;
+    },
+    async export(ctx, shell) {
+        if (!ctx.args.length) {
+            ctx.io.stdout(Object.entries(shell.env).map(([k, v]) => `export ${k}=${JSON.stringify(v)}`).join('\n') + '\n');
+            return 0;
+        }
+        for (const arg of ctx.args) {
+            const eq = arg.indexOf('=');
+            if (eq > 0)
+                shell.env[arg.slice(0, eq)] = arg.slice(eq + 1);
+            else if (!(arg in shell.env))
+                shell.env[arg] = '';
+        }
+        return 0;
+    },
+    async unset(ctx, shell) {
+        for (const name of ctx.args)
+            delete shell.env[name];
+        return 0;
+    },
+    async exit(ctx, shell) {
+        const code = ctx.args[0] === undefined ? shell.lastStatus : Number(ctx.args[0]);
+        shell.exitRequested = Number.isFinite(code) ? code & 255 : 2;
+        return shell.exitRequested;
+    },
+    async source(ctx, shell) {
+        const file = ctx.args[0];
+        if (!file) {
+            ctx.io.stderr('source: filename argument required\n');
+            return 2;
+        }
+        const text = ctx.fs.readText(resolvePath(ctx, file));
+        if (text === undefined) {
+            ctx.io.stderr(`source: ${file}: No such file or directory\n`);
+            return 1;
+        }
+        return shell.run(text);
+    },
+    async history(ctx, shell) {
+        ctx.io.stdout(shell.history.map((line, i) => `${String(i + 1).padStart(5)}  ${line}`).join('\n') + (shell.history.length ? '\n' : ''));
+        return 0;
+    },
+    async help(ctx) {
+        ctx.io.stdout(HELP);
+        return 0;
+    },
+    async which(ctx) {
+        let status = 0;
+        for (const name of ctx.args.filter((a) => !a.startsWith('-'))) {
+            if (name in COREUTILS || SYSTEM_PROGRAMS.includes(name))
+                ctx.io.stdout(`/usr/local/bin/${name}\n`);
+            else if (name in BUILTINS)
+                ctx.io.stdout(`${name}: shell built-in command\n`);
+            else {
+                const file = findExecutable(ctx.fs, name, ctx.cwd, ctx.env);
+                if (file)
+                    ctx.io.stdout(file + '\n');
+                else {
+                    ctx.io.stderr(`${name} not found\n`);
+                    status = 1;
+                }
+            }
+        }
+        return status;
+    },
+    async type(ctx) {
+        let status = 0;
+        for (const name of ctx.args) {
+            if (name in BUILTINS)
+                ctx.io.stdout(`${name} is a shell builtin\n`);
+            else if (name in COREUTILS || SYSTEM_PROGRAMS.includes(name))
+                ctx.io.stdout(`${name} is /usr/local/bin/${name}\n`);
+            else {
+                const file = findExecutable(ctx.fs, name, ctx.cwd, ctx.env);
+                if (file)
+                    ctx.io.stdout(`${name} is ${file}\n`);
+                else {
+                    ctx.io.stderr(`type: ${name}: not found\n`);
+                    status = 1;
+                }
+            }
+        }
+        return status;
+    },
+    async set() {
+        return 0; // options (-e, -x) are accepted and ignored
+    },
+};
+BUILTINS['.'] = BUILTINS.source;
+BUILTINS[':'] = async () => 0;
+//# sourceMappingURL=builtins.js.map

package/dist/shell/builtins.js.map

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

package/dist/shell/context.d.ts

@@ -0,0 +1,41 @@
+/**
+ * What a shell command runs with. Builtins get the shell's own state (to `cd`
+ * and `export`); coreutils only need IO, cwd and the file system, which is why
+ * they can also be spawned as standalone programs (`spawn('ls', ['-la'])`).
+ */
+import type { VirtualFileSystem } from '../vfs.js';
+import type { Program, System } from '../system/types.js';
+import { InputQueue } from '../system/terminal.js';
+export interface CommandIO {
+    stdout(text: string): void;
+    stderr(text: string): void;
+    stdin: InputQueue;
+    /** stdout is a terminal (colours, `clear`). */
+    isTerminal: boolean;
+}
+export interface CommandContext {
+    /** Arguments after the command name. */
+    args: string[];
+    /** The command name as typed (for messages). */
+    name: string;
+    cwd: string;
+    env: Record<string, string>;
+    fs: VirtualFileSystem;
+    system: System;
+    io: CommandIO;
+    signal: AbortSignal;
+}
+export type Command = (ctx: CommandContext) => Promise<number>;
+export declare function resolvePath(ctx: {
+    cwd: string;
+    env: Record<string, string>;
+}, path: string): string;
+/** Split `-abc` style flags from operands (`--` ends flags). */
+export declare function parseFlags(args: string[], withValue?: string[]): {
+    flags: Set<string>;
+    values: Record<string, string>;
+    operands: string[];
+};
+/** Run a coreutil as a standalone program (spawned directly rather than from the shell). */
+export declare function asProgram(command: Command, name: string): Program;
+//# sourceMappingURL=context.d.ts.map

package/dist/shell/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/shell/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE/D,wBAAgB,WAAW,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnG;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B/I;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAmBjE"}

package/dist/shell/context.js

@@ -0,0 +1,65 @@
+import { InputQueue } from '../system/terminal.js';
+import { join, normalizePath } from '../paths.js';
+export function resolvePath(ctx, path) {
+    if (path === '~' || path.startsWith('~/'))
+        return join(ctx.env.HOME ?? '/home/user', path.slice(1));
+    return path.startsWith('/') ? normalizePath(path) : join(ctx.cwd, path);
+}
+/** Split `-abc` style flags from operands (`--` ends flags). */
+export function parseFlags(args, withValue = []) {
+    const flags = new Set();
+    const values = {};
+    const operands = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--') {
+            operands.push(...args.slice(i + 1));
+            break;
+        }
+        if (arg.startsWith('--') && arg.length > 2) {
+            const [k, v] = arg.slice(2).split('=', 2);
+            if (v !== undefined)
+                values[k] = v;
+            else if (withValue.includes(k))
+                values[k] = args[++i] ?? '';
+            else
+                flags.add(k);
+        }
+        else if (arg.startsWith('-') && arg.length > 1 && !/^-\d/.test(arg)) {
+            for (let j = 1; j < arg.length; j++) {
+                const f = arg[j];
+                if (withValue.includes(f)) {
+                    values[f] = arg.slice(j + 1) || args[++i] || '';
+                    break;
+                }
+                flags.add(f);
+            }
+        }
+        else
+            operands.push(arg);
+    }
+    return { flags, values, operands };
+}
+/** Run a coreutil as a standalone program (spawned directly rather than from the shell). */
+export function asProgram(command, name) {
+    return async (ctx) => {
+        const stdin = new InputQueue();
+        const stop = ctx.io.onStdin((chunk) => stdin.push(chunk));
+        try {
+            return await command({
+                args: ctx.args,
+                name,
+                cwd: ctx.cwd,
+                env: ctx.env,
+                fs: ctx.system.fs,
+                system: ctx.system,
+                io: { stdout: ctx.io.stdout, stderr: ctx.io.stderr, stdin, isTerminal: !!ctx.io.terminal },
+                signal: ctx.signal,
+            });
+        }
+        finally {
+            stop();
+        }
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/shell/context.js.map

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

package/dist/shell/devHandoff.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Dev-server handoff. `vite`, `vite dev`, `react-scripts start` (what `npm run
+ * dev` / `npm start` usually run) cannot run here as-is — Vite itself needs
+ * esbuild's native binary — but the runtime already IS a Vite-style dev server:
+ * the in-browser DevServer serving the preview. So these commands announce that
+ * preview as their server (`server-ready`) and stay "running" until Ctrl-C,
+ * which is exactly what a host waiting on `npm run dev` expects.
+ */
+import type { CommandContext } from './context.js';
+interface Handoff {
+    tool: string;
+    defaultPort: number;
+}
+/** Does this command line start a dev server we hand off? */
+export declare function matchDevServer(argv: string[]): Handoff | undefined;
+export declare function runDevServerHandoff(ctx: CommandContext, argv: string[], handoff: Handoff): Promise<number>;
+export {};
+//# sourceMappingURL=devHandoff.d.ts.map

package/dist/shell/devHandoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devHandoff.d.ts","sourceRoot":"","sources":["../../src/shell/devHandoff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,GAAG,SAAS,CAMlE;AASD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBhH"}

package/dist/shell/devHandoff.js

@@ -0,0 +1,36 @@
+/** Does this command line start a dev server we hand off? */
+export function matchDevServer(argv) {
+    const [command, ...rest] = argv;
+    const sub = rest[0] !== undefined && !rest[0].startsWith('-') ? rest[0] : undefined;
+    if (command === 'vite' && (sub === undefined || sub === 'dev' || sub === 'serve'))
+        return { tool: 'vite', defaultPort: 5173 };
+    if ((command === 'react-scripts' || command === 'craco') && sub === 'start')
+        return { tool: 'react-scripts', defaultPort: 3000 };
+    return undefined;
+}
+function portOf(argv, fallback, env) {
+    const at = argv.findIndex((a) => a === '--port' || a.startsWith('--port='));
+    const value = at < 0 ? env.PORT : argv[at].includes('=') ? argv[at].split('=')[1] : argv[at + 1];
+    const port = Number(value);
+    return Number.isInteger(port) && port > 0 ? port : fallback;
+}
+export async function runDevServerHandoff(ctx, argv, handoff) {
+    const url = ctx.system.previewUrl;
+    if (!url) {
+        ctx.io.stderr(`${handoff.tool}: no in-browser preview is attached to this runtime, so there is nothing to serve.\n`);
+        return 1;
+    }
+    const port = portOf(argv, handoff.defaultPort, ctx.env);
+    const banner = handoff.tool === 'vite'
+        ? `\n  VITE (BuilderForce in-browser dev server)  ready\n\n  ➜  Local:   ${url}\n\n`
+        : `\nCompiled successfully!\n\nYou can now view the app in the browser.\n\n  Local:  ${url}\n\n`;
+    ctx.io.stdout(banner);
+    ctx.system.announceServer(port, url);
+    await new Promise((resolve) => {
+        if (ctx.signal.aborted)
+            resolve();
+        ctx.signal.addEventListener('abort', () => resolve());
+    });
+    return 130;
+}
+//# sourceMappingURL=devHandoff.js.map

package/dist/shell/devHandoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devHandoff.js","sourceRoot":"","sources":["../../src/shell/devHandoff.ts"],"names":[],"mappings":"AAeA,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC9H,IAAI,CAAC,OAAO,KAAK,eAAe,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACjI,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,MAAM,CAAC,IAAc,EAAE,QAAgB,EAAE,GAA2B;IAC3E,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACnG,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAmB,EAAE,IAAc,EAAE,OAAgB;IAC7F,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,sFAAsF,CAAC,CAAC;QACrH,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,MAAM;QACpC,CAAC,CAAC,yEAAyE,GAAG,MAAM;QACpF,CAAC,CAAC,qFAAqF,GAAG,MAAM,CAAC;IACnG,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAClC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/shell/exec.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The executor: runs a parsed script. Lists honour `&&`/`||`/`;`/`&`; pipeline
+ * stages run concurrently, joined by in-memory pipes; redirects swap a stage's
+ * stdin/stdout/stderr for files. Dispatch order per command: shell builtins,
+ * extra in-process commands (npm, npx), the dev-server handoff, coreutils, and
+ * finally `system.spawn` (node, scripts on PATH, `.bin` entries) — which in the
+ * browser is a separate Web Worker.
+ */
+import type { System } from '../system/types.js';
+import { InputQueue } from '../system/terminal.js';
+import { type ShellState } from './builtins.js';
+import { type CommandContext } from './context.js';
+export interface ShellIO {
+    stdout(text: string): void;
+    stderr(text: string): void;
+    /** stdout is a terminal. */
+    isTerminal: boolean;
+}
+/** A job's stdin: a queue, and (interactive) a raw keystroke tap for a terminal-attached child. */
+export interface JobInput {
+    queue: InputQueue;
+    /** Route raw terminal input straight to `sink` (a child with its own line discipline), or back to the queue. */
+    setRawSink?(sink: ((data: string) => void) | undefined): void;
+}
+/** In-process commands with access to the shell (npm runs scripts through it). */
+export type ShellCommand = (ctx: CommandContext, shell: Shell, input: JobInput) => Promise<number>;
+export interface ShellOptions {
+    system: System;
+    cwd: string;
+    env: Record<string, string>;
+    positional?: string[];
+    /** The terminal size, when attached to one. */
+    terminalSize?: () => {
+        cols: number;
+        rows: number;
+    } | undefined;
+    commands?: Record<string, ShellCommand>;
+}
+export declare class Shell implements ShellState {
+    readonly options: ShellOptions;
+    cwd: string;
+    env: Record<string, string>;
+    lastStatus: number;
+    history: string[];
+    exitRequested?: number;
+    readonly pid: number;
+    readonly system: System;
+    private readonly positional;
+    private current?;
+    constructor(options: ShellOptions);
+    /** A child shell for `npm run` / subshells: same IO, its own cwd and environment. */
+    fork(overrides: {
+        cwd?: string;
+        env?: Record<string, string>;
+        positional?: string[];
+    }): Shell;
+    /** Parse and run `source`. Syntax errors print and return 2. */
+    exec(source: string, io: ShellIO, input: JobInput, signal: AbortSignal): Promise<number>;
+    /** `source` and friends: run in this shell with the current job's IO. */
+    run(source: string): Promise<number>;
+    private expandContext;
+    private runPipeline;
+    private runCommand;
+    private dispatch;
+    private spawnExternal;
+}
+//# sourceMappingURL=exec.d.ts.map

package/dist/shell/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/shell/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAGhE,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4BAA4B;IAC5B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,mGAAmG;AACnG,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,gHAAgH;IAChH,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;CAC/D;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEnG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAID,qBAAa,KAAM,YAAW,UAAU;IAW1B,QAAQ,CAAC,OAAO,EAAE,YAAY;IAV1C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,UAAU,SAAK;IACf,OAAO,EAAE,MAAM,EAAE,CAAM;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,SAAkB;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;IACtC,OAAO,CAAC,OAAO,CAAC,CAAwD;gBAEnD,OAAO,EAAE,YAAY;IAO1C,qFAAqF;IACrF,IAAI,CAAC,SAAS,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,KAAK;IAI7F,gEAAgE;IAC1D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAmC9F,yEAAyE;IACzE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMpC,OAAO,CAAC,aAAa;YAkBP,WAAW;YAmBX,UAAU;YA+DV,QAAQ;YAwBR,aAAa;CA0B5B"}

package/dist/shell/exec.js

@@ -0,0 +1,247 @@
+import { InputQueue } from '../system/terminal.js';
+import { parse, ShellSyntaxError } from './parse.js';
+import { expandWord, expandWords } from './expand.js';
+import { BUILTINS, COREUTILS } from './builtins.js';
+import { resolvePath } from './context.js';
+import { matchDevServer, runDevServerHandoff } from './devHandoff.js';
+let nextShellPid = 500;
+export class Shell {
+    options;
+    cwd;
+    env;
+    lastStatus = 0;
+    history = [];
+    exitRequested;
+    pid = nextShellPid++;
+    system;
+    positional;
+    current;
+    constructor(options) {
+        this.options = options;
+        this.system = options.system;
+        this.cwd = options.cwd;
+        this.env = { ...options.env, PWD: options.cwd };
+        this.positional = options.positional ?? [];
+    }
+    /** A child shell for `npm run` / subshells: same IO, its own cwd and environment. */
+    fork(overrides) {
+        return new Shell({ ...this.options, cwd: overrides.cwd ?? this.cwd, env: { ...this.env, ...overrides.env }, positional: overrides.positional });
+    }
+    /** Parse and run `source`. Syntax errors print and return 2. */
+    async exec(source, io, input, signal) {
+        let script;
+        try {
+            script = parse(source);
+        }
+        catch (error) {
+            if (!(error instanceof ShellSyntaxError))
+                throw error;
+            io.stderr(`jsh: ${error.message}\n`);
+            this.lastStatus = 2;
+            return 2;
+        }
+        const previous = this.current;
+        this.current = { io, input, signal };
+        try {
+            for (const list of script) {
+                if (this.exitRequested !== undefined || signal.aborted)
+                    break;
+                const run = async () => {
+                    let status = await this.runPipeline(list.first, io, input, signal);
+                    for (const { op, pipeline } of list.rest) {
+                        if (this.exitRequested !== undefined || signal.aborted)
+                            break;
+                        if ((op === '&&') === (status === 0))
+                            status = await this.runPipeline(pipeline, io, input, signal);
+                    }
+                    return status;
+                };
+                if (list.background) {
+                    void run();
+                    this.lastStatus = 0;
+                }
+                else
+                    this.lastStatus = await run();
+            }
+        }
+        finally {
+            this.current = previous;
+        }
+        if (signal.aborted && this.lastStatus === 0)
+            this.lastStatus = 130;
+        return this.exitRequested ?? this.lastStatus;
+    }
+    /** `source` and friends: run in this shell with the current job's IO. */
+    run(source) {
+        const job = this.current;
+        if (!job)
+            throw new Error('Shell.run outside a job');
+        return this.exec(source, job.io, job.input, job.signal);
+    }
+    expandContext(io, signal) {
+        return {
+            fs: this.system.fs,
+            cwd: this.cwd,
+            get: (name) => this.env[name],
+            set: (name, value) => void (this.env[name] = value),
+            positional: this.positional,
+            lastStatus: this.lastStatus,
+            pid: this.pid,
+            substitute: async (source) => {
+                let out = '';
+                const sub = this.fork({});
+                await sub.exec(source, { stdout: (t) => (out += t), stderr: io.stderr, isTerminal: false }, { queue: emptyInput() }, signal);
+                return out;
+            },
+        };
+    }
+    async runPipeline(pipeline, io, input, signal) {
+        const count = pipeline.commands.length;
+        const pipes = Array.from({ length: count - 1 }, () => new InputQueue());
+        const statuses = await Promise.all(pipeline.commands.map(async (command, i) => {
+            const stdin = i === 0 ? input : { queue: pipes[i - 1] };
+            const stdout = i === count - 1 ? io.stdout : (text) => pipes[i].push(text);
+            const stageIO = { stdout, stderr: io.stderr, isTerminal: io.isTerminal && i === count - 1 };
+            try {
+                return await this.runCommand(command, stageIO, stdin, signal, count === 1);
+            }
+            finally {
+                if (i < count - 1)
+                    pipes[i].push(null);
+            }
+        }));
+        const status = statuses[statuses.length - 1];
+        return pipeline.negate ? (status === 0 ? 1 : 0) : status;
+    }
+    async runCommand(node, io, input, signal, alone) {
+        const ectx = this.expandContext(io, signal);
+        const argv = await expandWords(node.words, ectx);
+        const assigned = {};
+        for (const { name, value } of node.assignments)
+            assigned[name] = (await expandWord(value, ectx, { split: false, glob: false })).join('');
+        if (!argv.length) {
+            Object.assign(this.env, assigned);
+            return 0;
+        }
+        // Redirects.
+        let stdout = io.stdout;
+        let stderr = io.stderr;
+        let stdin = input;
+        let isTerminal = io.isTerminal;
+        const flushes = [];
+        for (const redirect of node.redirects) {
+            if (redirect.op === '2>&1') {
+                stderr = stdout;
+                continue;
+            }
+            if (redirect.op === '>&2') {
+                stdout = stderr;
+                continue;
+            }
+            const target = (await expandWord(redirect.target, ectx)).join(' ');
+            const path = resolvePath(this, target);
+            if (redirect.op === '<') {
+                const text = this.system.fs.readText(path);
+                if (text === undefined) {
+                    io.stderr(`jsh: ${target}: No such file or directory\n`);
+                    return 1;
+                }
+                const queue = new InputQueue();
+                queue.push(text);
+                queue.push(null);
+                stdin = { queue };
+                continue;
+            }
+            if (this.system.fs.isDirectory(path)) {
+                io.stderr(`jsh: ${target}: Is a directory\n`);
+                return 1;
+            }
+            const append = redirect.op === '>>' || redirect.op === '2>>';
+            let content = append ? this.system.fs.readText(path) ?? '' : '';
+            this.system.fs.writeFile(path, content);
+            const sink = (text) => void (content += text);
+            flushes.push(() => this.system.fs.writeFile(path, content));
+            if (redirect.op === '2>' || redirect.op === '2>>')
+                stderr = sink;
+            else if (redirect.op === '&>')
+                stdout = stderr = sink;
+            else {
+                stdout = sink;
+                isTerminal = false;
+            }
+        }
+        try {
+            return await this.dispatch(argv, assigned, { stdout, stderr, isTerminal }, stdin, signal, alone && isTerminal);
+        }
+        finally {
+            for (const flush of flushes)
+                flush();
+        }
+    }
+    async dispatch(argv, assigned, io, input, signal, attachTerminal) {
+        const [name, ...args] = argv;
+        const env = { ...this.env, ...assigned };
+        const ctx = {
+            args,
+            name,
+            cwd: this.cwd,
+            env,
+            fs: this.system.fs,
+            system: this.system,
+            io: { stdout: io.stdout, stderr: io.stderr, stdin: input.queue, isTerminal: io.isTerminal },
+            signal,
+        };
+        const builtin = BUILTINS[name];
+        if (builtin)
+            return builtin(ctx, this);
+        const command = this.options.commands?.[name];
+        if (command)
+            return command(ctx, this, input);
+        const handoff = matchDevServer(argv);
+        if (handoff)
+            return runDevServerHandoff(ctx, argv, handoff);
+        const coreutil = COREUTILS[name];
+        if (coreutil)
+            return coreutil(ctx);
+        return this.spawnExternal(name, args, env, io, input, signal, attachTerminal);
+    }
+    async spawnExternal(name, args, env, io, input, signal, attachTerminal) {
+        const size = attachTerminal ? this.options.terminalSize?.() : undefined;
+        let child;
+        try {
+            child = this.system.spawn(name, args, { cwd: this.cwd, env, terminal: size });
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+            io.stderr(`jsh: command not found: ${name}\n`);
+            return 127;
+        }
+        child.onStdout(io.stdout);
+        child.onStderr(io.stderr);
+        let stop;
+        if (size && input.setRawSink)
+            input.setRawSink((data) => child.write(data));
+        else
+            stop = input.queue.subscribe((chunk) => (chunk === null ? child.closeStdin() : child.write(chunk)));
+        const onAbort = () => child.kill(typeof signal.reason === 'string' ? signal.reason : 'SIGINT');
+        if (signal.aborted)
+            onAbort();
+        signal.addEventListener('abort', onAbort);
+        try {
+            return await child.exit;
+        }
+        finally {
+            signal.removeEventListener('abort', onAbort);
+            if (size && input.setRawSink)
+                input.setRawSink(undefined);
+            stop?.();
+        }
+    }
+}
+function emptyInput() {
+    const queue = new InputQueue();
+    queue.push(null);
+    return queue;
+}
+//# sourceMappingURL=exec.js.map