@seanhogg/builderforce-webcontainers-core 2026.10.7 → 2026.10.8

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

@@ -1 +1 @@
-{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/shell/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAK5D,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAElF,wEAAwE;AACxE,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAI7C,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,eAAe,UAA+C,CAAC;AAY5E,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA4F5C,CAAC"}
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/shell/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClD,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC7D,iDAAiD;IACjD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAElF,wEAAwE;AACxE,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAK7C,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,eAAe,UAA+D,CAAC;AAe5F,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAuJ5C,CAAC"}

package/dist/shell/builtins.js

@@ -6,21 +6,27 @@ 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';
+import { bracket, test } from './testCommand.js';
+import { readLine } from './lineReader.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,
+    ls, cat, mkdir, rm, cp, mv, touch, pwd, echo, printf, head, tail, grep, wc, env, clear, sleep, basename, dirname, test,
+    '[': bracket,
     true: trueCommand,
     false: falseCommand,
 };
 /** Programs the runtime provides besides coreutils (reported by `which`/`type`). */
-export const SYSTEM_PROGRAMS = ['node', 'npm', 'npx', 'bfsh', 'sh', 'bash'];
+export const SYSTEM_PROGRAMS = ['node', 'npm', 'npx', 'pnpm', 'yarn', 'bfsh', 'sh', 'bash'];
 const HELP = `bfsh — 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
+  Builtins:  cd, pwd, export, unset, exit, source, history, type, which, help,
+             read, local, shift, return, break, continue, jobs, wait
+  Files:     ls [-la], cat, mkdir [-p], rm [-rf], cp [-r], mv, touch, test / [ … ]
   Text:      echo, printf, head, tail, grep, wc, env, clear, sleep, basename, dirname
-  Node:      node <file>, npm install|ci|run|start|test, npx <bin>
+  Node:      node <file>, npm install|ci|run|start|test, npx <bin>, pnpm, yarn
   Syntax:    'quotes' "\$VARS" a && b || c; a | b > out.txt >> log 2>&1 2> err; FOO=bar cmd; $(cmd); *.js
+             if …; then …; elif …; else …; fi   while|until …; do …; done   for x in …; do …; done
+             case $x in a|b) …;; *) …;; esac   name() { …; }   { …; }   ( … )   cat <<EOF … EOF
 
 `;
 export const BUILTINS = {
@@ -103,10 +109,12 @@ export const BUILTINS = {
         }
         return status;
     },
-    async type(ctx) {
+    async type(ctx, shell) {
         let status = 0;
         for (const name of ctx.args) {
-            if (name in BUILTINS)
+            if (shell.functions.has(name))
+                ctx.io.stdout(`${name} is a function\n`);
+            else 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`);
@@ -125,7 +133,79 @@ export const BUILTINS = {
     async set() {
         return 0; // options (-e, -x) are accepted and ignored
     },
+    async break(ctx, shell) {
+        return loopControl(ctx, shell, 'break');
+    },
+    async continue(ctx, shell) {
+        return loopControl(ctx, shell, 'continue');
+    },
+    async return(ctx, shell) {
+        if (!shell.localFrames.length) {
+            ctx.io.stderr('return: can only `return\' from a function or sourced script\n');
+            return 1;
+        }
+        const status = ctx.args[0] === undefined ? shell.lastStatus : Number(ctx.args[0]) & 255;
+        shell.flow = { kind: 'return', status };
+        return status;
+    },
+    async local(ctx, shell) {
+        const frame = shell.localFrames[shell.localFrames.length - 1];
+        if (!frame) {
+            ctx.io.stderr('local: can only be used in a function\n');
+            return 1;
+        }
+        for (const arg of ctx.args) {
+            const eq = arg.indexOf('=');
+            const name = eq > 0 ? arg.slice(0, eq) : arg;
+            if (!frame.has(name))
+                frame.set(name, shell.env[name]);
+            shell.env[name] = eq > 0 ? arg.slice(eq + 1) : '';
+        }
+        return 0;
+    },
+    async shift(ctx, shell) {
+        const count = ctx.args[0] === undefined ? 1 : Number(ctx.args[0]);
+        if (!Number.isInteger(count) || count < 0 || count > shell.positional.length)
+            return 1;
+        shell.positional = shell.positional.slice(count);
+        return 0;
+    },
+    async read(ctx, shell) {
+        const raw = ctx.args.includes('-r');
+        const names = ctx.args.filter((a) => !a.startsWith('-'));
+        let line = await readLine(ctx.io.stdin, ctx.signal);
+        if (line === null)
+            return 1;
+        if (!raw)
+            line = line.replace(/\\(.)/g, '$1');
+        const targets = names.length ? names : ['REPLY'];
+        const fields = names.length ? line.trim().split(/\s+/) : [line];
+        targets.forEach((name, i) => {
+            shell.env[name] = i === targets.length - 1 ? fields.slice(i).join(' ') : fields[i] ?? '';
+        });
+        return 0;
+    },
+    async jobs(ctx, shell) {
+        for (const job of shell.jobs.values())
+            ctx.io.stdout(`[${job.id}]  Running\n`);
+        return 0;
+    },
+    async wait(ctx, shell) {
+        const ids = ctx.args.map((a) => Number(a.replace(/^%/, '')));
+        const jobs = ids.length ? ids.map((id) => shell.jobs.get(id)).filter((j) => !!j) : [...shell.jobs.values()];
+        const statuses = await Promise.all(jobs.map((job) => job.done));
+        return statuses.length ? statuses[statuses.length - 1] : 0;
+    },
 };
+function loopControl(ctx, shell, kind) {
+    const levels = ctx.args[0] === undefined ? 1 : Number(ctx.args[0]);
+    if (!Number.isInteger(levels) || levels < 1) {
+        ctx.io.stderr(`${kind}: ${ctx.args[0]}: loop count out of range\n`);
+        return 1;
+    }
+    shell.flow = { kind, levels };
+    return 0;
+}
 BUILTINS['.'] = BUILTINS.source;
 BUILTINS[':'] = async () => 0;
 //# sourceMappingURL=builtins.js.map

package/dist/shell/builtins.js.map

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

package/dist/shell/compound.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Running compound commands (`if`, `while`/`until`, `for`, `case`, `{ }`,
+ * `( )`) against a narrow {@link ScriptRunner}, so the executor stays a
+ * dispatcher. Loop control (`break`, `continue`) and `return` travel as a
+ * {@link Flow} the runner holds: lists stop running while one is set, and the
+ * construct it targets clears it.
+ */
+import type { CompoundCommand, Script, Word } from './ast.js';
+import type { JobInput, ShellIO } from './exec.js';
+export type Flow = {
+    kind: 'break' | 'continue';
+    levels: number;
+} | {
+    kind: 'return';
+    status: number;
+};
+export interface ScriptRunner {
+    flow?: Flow;
+    readonly positional: readonly string[];
+    runScript(script: Script, io: ShellIO, input: JobInput, signal: AbortSignal): Promise<number>;
+    /** Words with splitting and globbing, as command arguments. */
+    expandWords(words: Word[], io: ShellIO, signal: AbortSignal): Promise<string[]>;
+    /** One word as a single string: no splitting, no globbing. */
+    expandText(word: Word, io: ShellIO, signal: AbortSignal): Promise<string>;
+    setVar(name: string, value: string): void;
+    /** A copy of this shell for `( … )`: changes inside do not leak out. */
+    subshell(): ScriptRunner;
+}
+export declare function runCompound(node: CompoundCommand, runner: ScriptRunner, io: ShellIO, input: JobInput, signal: AbortSignal): Promise<number>;
+//# sourceMappingURL=compound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compound.d.ts","sourceRoot":"","sources":["../../src/shell/compound.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGnD,MAAM,MAAM,IAAI,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9F,+DAA+D;IAC/D,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,8DAA8D;IAC9D,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,wEAAwE;IACxE,QAAQ,IAAI,YAAY,CAAC;CAC1B;AAeD,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDjJ"}

package/dist/shell/compound.js

@@ -0,0 +1,73 @@
+import { patternToRegExp } from './expand.js';
+/** After one pass of a loop body: whether the loop goes on. Consumes the flow aimed at this loop. */
+function continueLoop(runner) {
+    const flow = runner.flow;
+    if (!flow)
+        return true;
+    if (flow.kind === 'return')
+        return false;
+    if (flow.levels > 1) {
+        runner.flow = { kind: flow.kind, levels: flow.levels - 1 };
+        return false;
+    }
+    runner.flow = undefined;
+    return flow.kind === 'continue';
+}
+export async function runCompound(node, runner, io, input, signal) {
+    switch (node.type) {
+        case 'group':
+            return runner.runScript(node.body, io, input, signal);
+        case 'subshell':
+            return runner.subshell().runScript(node.body, io, input, signal);
+        case 'if': {
+            for (const clause of node.clauses) {
+                const condition = await runner.runScript(clause.condition, io, input, signal);
+                if (runner.flow)
+                    return condition;
+                if (condition === 0)
+                    return runner.runScript(clause.body, io, input, signal);
+            }
+            return node.otherwise ? runner.runScript(node.otherwise, io, input, signal) : 0;
+        }
+        case 'while':
+        case 'until': {
+            let status = 0;
+            while (!signal.aborted) {
+                const condition = await runner.runScript(node.condition, io, input, signal);
+                if (runner.flow && !continueLoop(runner))
+                    break;
+                if ((condition === 0) !== (node.type === 'while'))
+                    break;
+                status = await runner.runScript(node.body, io, input, signal);
+                if (!continueLoop(runner))
+                    break;
+            }
+            return status;
+        }
+        case 'for': {
+            const items = node.items ? await runner.expandWords(node.items, io, signal) : [...runner.positional];
+            let status = 0;
+            for (const item of items) {
+                if (signal.aborted)
+                    break;
+                runner.setVar(node.name, item);
+                status = await runner.runScript(node.body, io, input, signal);
+                if (!continueLoop(runner))
+                    break;
+            }
+            return status;
+        }
+        case 'case': {
+            const subject = await runner.expandText(node.subject, io, signal);
+            for (const arm of node.arms) {
+                for (const pattern of arm.patterns) {
+                    if (patternToRegExp(await runner.expandText(pattern, io, signal), { slash: true }).test(subject)) {
+                        return runner.runScript(arm.body, io, input, signal);
+                    }
+                }
+            }
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=compound.js.map

package/dist/shell/compound.js.map

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

package/dist/shell/exec.d.ts

@@ -1,15 +1,18 @@
 /**
  * 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,
+ * stages run concurrently, joined by in-memory pipes; redirects (here-documents
+ * included) swap a stage's stdin/stdout/stderr. Compound commands run through
+ * compound.ts. Dispatch order per simple command: shell functions, 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 { FunctionDefinition, Script, Word } from './ast.js';
+import { type BackgroundJob, type ShellState } from './builtins.js';
 import { type CommandContext } from './context.js';
+import { type Flow, type ScriptRunner } from './compound.js';
 export interface ShellIO {
     stdout(text: string): void;
     stderr(text: string): void;
@@ -35,33 +38,51 @@ export interface ShellOptions {
         rows: number;
     } | undefined;
     commands?: Record<string, ShellCommand>;
+    /** Functions inherited from a parent shell (subshells and `$(…)`). */
+    functions?: Map<string, FunctionDefinition>;
 }
-export declare class Shell implements ShellState {
+export declare class Shell implements ShellState, ScriptRunner {
     readonly options: ShellOptions;
     cwd: string;
     env: Record<string, string>;
     lastStatus: number;
     history: string[];
     exitRequested?: number;
+    flow?: Flow;
+    positional: string[];
+    readonly functions: Map<string, FunctionDefinition>;
+    readonly jobs: Map<number, BackgroundJob>;
+    /** One frame per running function: names declared `local`, with the value to restore. */
+    readonly localFrames: Array<Map<string, string | undefined>>;
     readonly pid: number;
     readonly system: System;
-    private readonly positional;
+    private nextJob;
     private current?;
     constructor(options: ShellOptions);
-    /** A child shell for `npm run` / subshells: same IO, its own cwd and environment. */
+    /** A child shell for `npm run` / subshells: same IO, its own cwd, environment and functions. */
     fork(overrides: {
         cwd?: string;
         env?: Record<string, string>;
         positional?: string[];
     }): Shell;
+    subshell(): 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>;
+    runScript(script: Script, io: ShellIO, input: JobInput, signal: AbortSignal): Promise<number>;
+    expandWords(words: Word[], io: ShellIO, signal: AbortSignal): Promise<string[]>;
+    expandText(word: Word, io: ShellIO, signal: AbortSignal): Promise<string>;
+    setVar(name: string, value: string): void;
     private expandContext;
     private runPipeline;
     private runCommand;
+    private runSimple;
+    /** Apply redirects; returns the new IO, or an exit status when a redirect fails. */
+    private applyRedirects;
     private dispatch;
+    /** A shell function: its own positional parameters and `local` frame; `return` ends it. */
+    private callFunction;
     private spawnExternal;
 }
 //# sourceMappingURL=exec.d.ts.map

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

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

package/dist/shell/exec.js

@@ -4,6 +4,7 @@ import { expandWord, expandWords } from './expand.js';
 import { BUILTINS, COREUTILS } from './builtins.js';
 import { resolvePath } from './context.js';
 import { matchDevServer, runDevServerHandoff } from './devHandoff.js';
+import { runCompound } from './compound.js';
 let nextShellPid = 500;
 export class Shell {
     options;
@@ -12,20 +13,30 @@ export class Shell {
     lastStatus = 0;
     history = [];
     exitRequested;
+    flow;
+    positional;
+    functions;
+    jobs = new Map();
+    /** One frame per running function: names declared `local`, with the value to restore. */
+    localFrames = [];
     pid = nextShellPid++;
     system;
-    positional;
+    nextJob = 1;
     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 ?? [];
+        this.positional = [...(options.positional ?? [])];
+        this.functions = new Map(options.functions);
     }
-    /** A child shell for `npm run` / subshells: same IO, its own cwd and environment. */
+    /** A child shell for `npm run` / subshells: same IO, its own cwd, environment and functions. */
     fork(overrides) {
-        return new Shell({ ...this.options, cwd: overrides.cwd ?? this.cwd, env: { ...this.env, ...overrides.env }, positional: overrides.positional });
+        return new Shell({ ...this.options, cwd: overrides.cwd ?? this.cwd, env: { ...this.env, ...overrides.env }, positional: overrides.positional ?? this.positional, functions: this.functions });
+    }
+    subshell() {
+        return this.fork({});
     }
     /** Parse and run `source`. Syntax errors print and return 2. */
     async exec(source, io, input, signal) {
@@ -43,29 +54,13 @@ export class Shell {
         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();
-            }
+            await this.runScript(script, io, input, signal);
         }
         finally {
             this.current = previous;
+            // A `break`/`continue` outside any loop (or `return` outside a function) must not stop later lines.
+            if (!this.localFrames.length)
+                this.flow = undefined;
         }
         if (signal.aborted && this.lastStatus === 0)
             this.lastStatus = 130;
@@ -78,6 +73,41 @@ export class Shell {
             throw new Error('Shell.run outside a job');
         return this.exec(source, job.io, job.input, job.signal);
     }
+    async runScript(script, io, input, signal) {
+        for (const list of script) {
+            if (this.exitRequested !== undefined || signal.aborted || this.flow)
+                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 || this.flow)
+                        break;
+                    if ((op === '&&') === (status === 0))
+                        status = await this.runPipeline(pipeline, io, input, signal);
+                }
+                return status;
+            };
+            if (list.background) {
+                const id = this.nextJob++;
+                const done = run();
+                this.jobs.set(id, { id, done });
+                void done.finally(() => this.jobs.delete(id));
+                this.lastStatus = 0;
+            }
+            else
+                this.lastStatus = await run();
+        }
+        return this.lastStatus;
+    }
+    expandWords(words, io, signal) {
+        return expandWords(words, this.expandContext(io, signal));
+    }
+    async expandText(word, io, signal) {
+        return (await expandWord(word, this.expandContext(io, signal), { split: false, glob: false })).join('');
+    }
+    setVar(name, value) {
+        this.env[name] = value;
+    }
     expandContext(io, signal) {
         return {
             fs: this.system.fs,
@@ -114,6 +144,23 @@ export class Shell {
         return pipeline.negate ? (status === 0 ? 1 : 0) : status;
     }
     async runCommand(node, io, input, signal, alone) {
+        if (node.type === 'function') {
+            this.functions.set(node.name, node);
+            return 0;
+        }
+        if (node.type === 'simple')
+            return this.runSimple(node, io, input, signal, alone);
+        const redirected = await this.applyRedirects(node.redirects, io, input, signal);
+        if (typeof redirected === 'number')
+            return redirected;
+        try {
+            return await runCompound(node, this, redirected.io, redirected.input, signal);
+        }
+        finally {
+            redirected.flush();
+        }
+    }
+    async runSimple(node, io, input, signal, alone) {
         const ectx = this.expandContext(io, signal);
         const argv = await expandWords(node.words, ectx);
         const assigned = {};
@@ -123,13 +170,28 @@ export class Shell {
             Object.assign(this.env, assigned);
             return 0;
         }
-        // Redirects.
-        let stdout = io.stdout;
-        let stderr = io.stderr;
+        const redirected = await this.applyRedirects(node.redirects, io, input, signal);
+        if (typeof redirected === 'number')
+            return redirected;
+        try {
+            return await this.dispatch(argv, assigned, redirected.io, redirected.input, signal, alone && redirected.io.isTerminal);
+        }
+        finally {
+            redirected.flush();
+        }
+    }
+    /** Apply redirects; returns the new IO, or an exit status when a redirect fails. */
+    async applyRedirects(redirects, io, input, signal) {
+        let { stdout, stderr, isTerminal } = io;
         let stdin = input;
-        let isTerminal = io.isTerminal;
         const flushes = [];
-        for (const redirect of node.redirects) {
+        const fromText = (text) => {
+            const queue = new InputQueue();
+            queue.push(text);
+            queue.push(null);
+            return { queue };
+        };
+        for (const redirect of redirects) {
             if (redirect.op === '2>&1') {
                 stderr = stdout;
                 continue;
@@ -138,7 +200,12 @@ export class Shell {
                 stdout = stderr;
                 continue;
             }
-            const target = (await expandWord(redirect.target, ectx)).join(' ');
+            if (redirect.heredoc) {
+                const text = await this.expandText(redirect.heredoc.body, io, signal);
+                stdin = fromText(text);
+                continue;
+            }
+            const target = (await expandWord(redirect.target, this.expandContext(io, signal))).join(' ');
             const path = resolvePath(this, target);
             if (redirect.op === '<') {
                 const text = this.system.fs.readText(path);
@@ -146,10 +213,7 @@ export class Shell {
                     io.stderr(`bfsh: ${target}: No such file or directory\n`);
                     return 1;
                 }
-                const queue = new InputQueue();
-                queue.push(text);
-                queue.push(null);
-                stdin = { queue };
+                stdin = fromText(text);
                 continue;
             }
             if (this.system.fs.isDirectory(path)) {
@@ -170,16 +234,13 @@ export class Shell {
                 isTerminal = false;
             }
         }
-        try {
-            return await this.dispatch(argv, assigned, { stdout, stderr, isTerminal }, stdin, signal, alone && isTerminal);
-        }
-        finally {
-            for (const flush of flushes)
-                flush();
-        }
+        return { io: { stdout, stderr, isTerminal }, input: stdin, flush: () => flushes.forEach((flush) => flush()) };
     }
     async dispatch(argv, assigned, io, input, signal, attachTerminal) {
         const [name, ...args] = argv;
+        const fn = this.functions.get(name);
+        if (fn)
+            return this.callFunction(fn, args, io, input, signal);
         const env = { ...this.env, ...assigned };
         const ctx = {
             args,
@@ -205,6 +266,31 @@ export class Shell {
             return coreutil(ctx);
         return this.spawnExternal(name, args, env, io, input, signal, attachTerminal);
     }
+    /** A shell function: its own positional parameters and `local` frame; `return` ends it. */
+    async callFunction(fn, args, io, input, signal) {
+        const savedPositional = this.positional;
+        this.positional = args;
+        const frame = new Map();
+        this.localFrames.push(frame);
+        try {
+            let status = await runCompound(fn.body, this, io, input, signal);
+            if (this.flow?.kind === 'return') {
+                status = this.flow.status;
+                this.flow = undefined;
+            }
+            return status;
+        }
+        finally {
+            this.localFrames.pop();
+            for (const [name, value] of frame) {
+                if (value === undefined)
+                    delete this.env[name];
+                else
+                    this.env[name] = value;
+            }
+            this.positional = savedPositional;
+        }
+    }
     async spawnExternal(name, args, env, io, input, signal, attachTerminal) {
         const size = attachTerminal ? this.options.terminalSize?.() : undefined;
         let child;