shell-dsl 0.0.39 → 0.0.40

package/README.md

@@ -33,6 +33,7 @@ bun add shell-dsl memfs
 - **Virtual filesystem** — Uses memfs for complete isolation from the real filesystem
 - **Real filesystem** — Optional sandboxed access to real files with path containment and permissions
 - **Explicit command registry** — Only registered commands can execute
+- **Executable scripts** — Run virtual-filesystem scripts with `./script`, `sh`, `source`, and shebang dispatch
 - **Automatic escaping** — Interpolated values are escaped by default for safety
 - **POSIX-inspired syntax** — Pipes, redirects, control flow operators, and more
 - **Streaming pipelines** — Commands communicate via async iteration
@@ -234,6 +235,15 @@ await sh`echo $USER`.text();        // "alice\n"
 await sh`echo "Home: $HOME"`.text(); // "Home: /home/alice\n"
 ```
 
+`$?` expands to the previous command's exit code:
+
+```ts
+await sh`false; echo exit:$?; true; echo ok:$?`.text();
+// "exit:1\nok:0\n"
+
+await sh`logs clear backend; restart-backend; echo exit:$?; logs backend 100`;
+```
+
 ### Quoting Semantics
 
 | Quote | Behavior |
@@ -374,6 +384,101 @@ Nested substitution is supported:
 await sh`echo "Files: $(ls $(pwd))"`.text();
 ```
 
+## Executable Scripts
+
+Command names containing `/` are treated as virtual-filesystem script paths when no registered command matches. Scripts run inside shell-dsl, not through the host OS:
+
+```ts
+await fs.writeFile("/hello", `
+echo "script: $0"
+echo "args: $1 / $#"
+`.trimStart());
+
+await sh`./hello Alice`.text();
+// "script: ./hello\nargs: Alice / 1\n"
+```
+
+Scripts without a shebang run as shell-dsl scripts. `#!/bin/sh` and `#!/usr/bin/env sh` do the same thing:
+
+```ts
+await fs.writeFile("/greet", `
+#!/bin/sh
+echo "Hello, $1"
+`.trimStart());
+
+await sh`./greet Alice`.text(); // "Hello, Alice\n"
+```
+
+Script execution is subprocess-like: variables and `cd` inside `./script` do not leak back to the caller. Use `source` or `.` when you want the script to mutate the current shell state:
+
+```ts
+await fs.writeFile("/env", "NAME=Alice\ncd /work\n");
+
+await sh`source ./env; echo "$NAME"; pwd`.text();
+// "Alice\n/work\n"
+```
+
+### Positional Parameters
+
+Scripts and `sh -c` support common shell parameters:
+
+| Parameter | Meaning |
+|-----------|---------|
+| `$0` | Script name or `sh -c` argv0 |
+| `$1`, `$2`, ... | Positional arguments |
+| `$#` | Number of positional arguments |
+| `$*` | Positional arguments joined with spaces |
+| `$@` | Positional arguments; quoted `"$@"` expands as separate fields |
+| `$?` | Previous command's exit code |
+
+```ts
+await sh`sh -c 'echo "$0:$1:$#"' name value`.text();
+// "name:value:1\n"
+```
+
+Scripts can stop with an explicit status via `exit`:
+
+```ts
+await fs.writeFile("/restart", "restart-backend\nexit $?\n");
+
+const result = await sh`./restart`.nothrow();
+result.exitCode; // restart-backend's exit code
+```
+
+### Shebang Dispatch
+
+Non-`sh` shebangs dispatch to registered commands by interpreter basename. For example, `#!/bin/cat` runs the registered `cat` command with the script path as its first argument:
+
+```ts
+await fs.writeFile("/show", "#!/bin/cat\nhello\n");
+await sh`./show`.text(); // "#!/bin/cat\nhello\n"
+```
+
+Custom shebangs work the same way:
+
+```ts
+const customCommand: Command = async (ctx) => {
+  await ctx.stdout.writeText(JSON.stringify(ctx.args) + "\n");
+  return 0;
+};
+
+const sh = createShellDSL({
+  fs,
+  cwd: "/",
+  env: {},
+  commands: { ...builtinCommands, custom_command: customCommand },
+});
+
+await fs.writeFile("/run", "#!/bin/custom_command\n");
+await sh`./run arg`.text(); // "[\"./run\",\"arg\"]\n"
+```
+
+`#!/bin/bash` is not enabled by default. If you intentionally want that alias, register one explicitly:
+
+```ts
+commands: { ...builtinCommands, bash: builtinCommands.sh }
+```
+
 ## Defining Custom Commands
 
 Commands are async functions that receive a `CommandContext` and return an exit code (0 = success):
@@ -406,6 +511,9 @@ interface CommandContext {
   fs: VirtualFS;                     // Virtual filesystem
   cwd: string;                       // Current working directory
   env: Record<string, string>;       // Environment variables
+  setCwd(path: string): void;         // Change current working directory
+  exec?: (name: string, args: string[]) => Promise<ExecResult>;
+  shell?: ShellCommandApi;            // Evaluate shell-dsl source from commands
 }
 ```
 
@@ -567,7 +675,7 @@ import { builtinCommands } from "shell-dsl/commands";
 Or import individually:
 
 ```ts
-import { echo, printf, cat, grep, wc, cp, mv, touch, tee, tree, find, sed, awk, cut, od } from "shell-dsl/commands";
+import { echo, printf, cat, grep, wc, cp, mv, touch, tee, tree, find, sed, awk, cut, od, sh, evalCmd, source, dot, exitCmd } from "shell-dsl/commands";
 ```
 
 | Command | Description |
@@ -595,6 +703,10 @@ import { echo, printf, cat, grep, wc, cp, mv, touch, tee, tree, find, sed, awk,
 | `awk` | Pattern scanning (`{print $1}`, `-F`, `NF`, `NR`) |
 | `cut` | Select fields/characters (`-f`, `-d`, `-c`, `-b`, `-s`, `--complement`) |
 | `od` | Dump binary/text data (`-A`, `-t x1/x2/o1/o2/c`, `-j`, `-N`, `-v`) |
+| `sh` | Run shell-dsl source from a file, stdin, or `-c` string |
+| `eval` | Evaluate arguments as shell-dsl source in the current shell state |
+| `source` / `.` | Execute a script in the current shell state |
+| `exit` | Stop the current shell with an optional exit code |
 | `test` / `[` | File and string tests (`-f`, `-d`, `-e`, `-z`, `-n`, `=`, `!=`) |
 | `true` | Exit with code 0 |
 | `false` | Exit with code 1 |
@@ -948,8 +1060,8 @@ await sh`echo ${{ raw: "$(date)" }}`.text();
 
 1. **No host access** — All commands run in-process against a virtual filesystem
 2. **Automatic escaping** — Interpolated values are escaped by default
-3. **Explicit command registry** — Only registered commands can execute
-4. **No shell spawning** — Never invokes `/bin/sh` or similar
+3. **Explicit command registry** — Only registered commands can execute, including shebang-dispatched interpreters
+4. **No shell spawning** — Never invokes `/bin/sh` or similar; `#!/bin/sh` maps to shell-dsl's in-process `sh`
 
 The `{ raw: ... }` escape hatch exists for advanced use cases but should be used with extreme caution.
 
@@ -968,6 +1080,8 @@ import type {
   FileStat,
   ExecResult,
   ShellConfig,
+  ShellCommandApi,
+  ShellRunOptions,
   RawValue,
   Permission,
   PermissionRules,

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.39",
+  "version": "0.0.40",
   "type": "commonjs"
 }

package/dist/cjs/src/commands/exit/exit.cjs

@@ -0,0 +1,84 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/commands/exit/exit.ts
+var exports_exit = {};
+__export(exports_exit, {
+  exitCmd: () => exitCmd
+});
+module.exports = __toCommonJS(exports_exit);
+function parseExitCode(value) {
+  if (!/^[+-]?\d+$/.test(value)) {
+    return null;
+  }
+  return Number(value);
+}
+var exitCmd = async (ctx) => {
+  if (!ctx.shell) {
+    await ctx.stderr.writeText(`exit: shell control not supported
+`);
+    return 1;
+  }
+  if (ctx.args.length === 0) {
+    ctx.shell.exit(ctx.shell.getLastExitCode());
+    return 0;
+  }
+  const rawExitCode = ctx.args[0];
+  const exitCode = parseExitCode(rawExitCode);
+  if (exitCode === null) {
+    await ctx.stderr.writeText(`exit: ${rawExitCode}: numeric argument required
+`);
+    ctx.shell.exit(2);
+    return 0;
+  }
+  if (!Number.isFinite(exitCode)) {
+    await ctx.stderr.writeText(`exit: ${rawExitCode}: numeric argument required
+`);
+    ctx.shell.exit(2);
+    return 0;
+  }
+  if (ctx.args.length > 1) {
+    await ctx.stderr.writeText(`exit: too many arguments
+`);
+    return 1;
+  }
+  ctx.shell.exit(exitCode);
+  return 0;
+};
+
+//# debugId=03868A825C7B459964756E2164756E21

package/dist/cjs/src/commands/exit/exit.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/commands/exit/exit.ts"],
+  "sourcesContent": [
+    "import type { Command } from \"../../types.cjs\";\n\nfunction parseExitCode(value: string): number | null {\n  if (!/^[+-]?\\d+$/.test(value)) {\n    return null;\n  }\n  return Number(value);\n}\n\nexport const exitCmd: Command = async (ctx) => {\n  if (!ctx.shell) {\n    await ctx.stderr.writeText(\"exit: shell control not supported\\n\");\n    return 1;\n  }\n\n  if (ctx.args.length === 0) {\n    ctx.shell.exit(ctx.shell.getLastExitCode());\n    return 0;\n  }\n\n  const rawExitCode = ctx.args[0]!;\n  const exitCode = parseExitCode(rawExitCode);\n  if (exitCode === null) {\n    await ctx.stderr.writeText(`exit: ${rawExitCode}: numeric argument required\\n`);\n    ctx.shell.exit(2);\n    return 0;\n  }\n\n  if (!Number.isFinite(exitCode)) {\n    await ctx.stderr.writeText(`exit: ${rawExitCode}: numeric argument required\\n`);\n    ctx.shell.exit(2);\n    return 0;\n  }\n\n  if (ctx.args.length > 1) {\n    await ctx.stderr.writeText(\"exit: too many arguments\\n\");\n    return 1;\n  }\n\n  ctx.shell.exit(exitCode);\n  return 0;\n};\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,SAAS,aAAa,CAAC,OAA8B;AAAA,EACnD,IAAI,CAAC,aAAa,KAAK,KAAK,GAAG;AAAA,IAC7B,OAAO;AAAA,EACT;AAAA,EACA,OAAO,OAAO,KAAK;AAAA;AAGd,IAAM,UAAmB,OAAO,QAAQ;AAAA,EAC7C,IAAI,CAAC,IAAI,OAAO;AAAA,IACd,MAAM,IAAI,OAAO,UAAU;AAAA,CAAqC;AAAA,IAChE,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,IAAI,KAAK,WAAW,GAAG;AAAA,IACzB,IAAI,MAAM,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAAA,IAC1C,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,cAAc,IAAI,KAAK;AAAA,EAC7B,MAAM,WAAW,cAAc,WAAW;AAAA,EAC1C,IAAI,aAAa,MAAM;AAAA,IACrB,MAAM,IAAI,OAAO,UAAU,SAAS;AAAA,CAA0C;AAAA,IAC9E,IAAI,MAAM,KAAK,CAAC;AAAA,IAChB,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,CAAC,OAAO,SAAS,QAAQ,GAAG;AAAA,IAC9B,MAAM,IAAI,OAAO,UAAU,SAAS;AAAA,CAA0C;AAAA,IAC9E,IAAI,MAAM,KAAK,CAAC;AAAA,IAChB,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,IAAI,KAAK,SAAS,GAAG;AAAA,IACvB,MAAM,IAAI,OAAO,UAAU;AAAA,CAA4B;AAAA,IACvD,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,MAAM,KAAK,QAAQ;AAAA,EACvB,OAAO;AAAA;",
+  "debugId": "03868A825C7B459964756E2164756E21",
+  "names": []
+}

package/dist/cjs/src/commands/index.cjs

@@ -48,7 +48,9 @@ __export(exports_commands, {
   test: () => import_test.test,
   tee: () => import_tee.tee,
   tail: () => import_tail.tail,
+  source: () => import_sh.source,
   sort: () => import_sort.sort,
+  sh: () => import_sh.sh,
   sed: () => import_sed.sed,
   rm: () => import_rm.rm,
   pwd: () => import_pwd.pwd,
@@ -61,7 +63,12 @@ __export(exports_commands, {
   grep: () => import_grep.grep,
   find: () => import_find.find,
   falseCmd: () => import_true_false.falseCmd,
+  exitCmd: () => import_exit.exitCmd,
+  exit: () => import_exit.exitCmd,
+  evalCmd: () => import_sh.evalCmd,
+  eval: () => import_sh.evalCmd,
   echo: () => import_echo.echo,
+  dot: () => import_sh.dot,
   cut: () => import_cut.cut,
   cp: () => import_cp.cp,
   continueCmd: () => import_break_continue.continueCmd,
@@ -103,6 +110,8 @@ var import_cd = require("./cd/cd.cjs");
 var import_tr = require("./tr/tr.cjs");
 var import_cut = require("./cut/cut.cjs");
 var import_od = require("./od/od.cjs");
+var import_sh = require("./sh/sh.cjs");
+var import_exit = require("./exit/exit.cjs");
 var import_echo2 = require("./echo/echo.cjs");
 var import_printf2 = require("./printf/printf.cjs");
 var import_cat2 = require("./cat/cat.cjs");
@@ -132,6 +141,8 @@ var import_cd2 = require("./cd/cd.cjs");
 var import_tr2 = require("./tr/tr.cjs");
 var import_cut2 = require("./cut/cut.cjs");
 var import_od2 = require("./od/od.cjs");
+var import_sh2 = require("./sh/sh.cjs");
+var import_exit2 = require("./exit/exit.cjs");
 var builtinCommands = {
   echo: import_echo2.echo,
   printf: import_printf2.printf,
@@ -164,7 +175,12 @@ var builtinCommands = {
   cd: import_cd2.cd,
   tr: import_tr2.tr,
   cut: import_cut2.cut,
-  od: import_od2.od
+  od: import_od2.od,
+  sh: import_sh2.sh,
+  eval: import_sh2.evalCmd,
+  source: import_sh2.source,
+  ".": import_sh2.dot,
+  exit: import_exit2.exitCmd
 };
 
-//# debugId=2377F0DD6264750A64756E2164756E21
+//# debugId=4755929D925B13DC64756E2164756E21

package/dist/cjs/src/commands/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/commands/index.ts"],
   "sourcesContent": [
-    "import type { Command } from \"../types.cjs\";\n\nexport { echo } from \"./echo/echo.cjs\";\nexport { printf } from \"./printf/printf.cjs\";\nexport { cat } from \"./cat/cat.cjs\";\nexport { grep } from \"./grep/grep.cjs\";\nexport { wc } from \"./wc/wc.cjs\";\nexport { head } from \"./head/head.cjs\";\nexport { tail } from \"./tail/tail.cjs\";\nexport { sort } from \"./sort/sort.cjs\";\nexport { uniq } from \"./uniq/uniq.cjs\";\nexport { pwd } from \"./pwd/pwd.cjs\";\nexport { ls } from \"./ls/ls.cjs\";\nexport { mkdir } from \"./mkdir/mkdir.cjs\";\nexport { rm } from \"./rm/rm.cjs\";\nexport { test, bracket } from \"./test/test.cjs\";\nexport { trueCmd, falseCmd } from \"./true-false/true-false.cjs\";\nexport { touch } from \"./touch/touch.cjs\";\nexport { cp } from \"./cp/cp.cjs\";\nexport { mv } from \"./mv/mv.cjs\";\nexport { tee } from \"./tee/tee.cjs\";\nexport { tree } from \"./tree/tree.cjs\";\nexport { find } from \"./find/find.cjs\";\nexport { sed } from \"./sed/sed.cjs\";\nexport { awk } from \"./awk/awk.cjs\";\nexport { breakCmd, continueCmd } from \"./break-continue/break-continue.cjs\";\nexport { colon } from \"./colon/colon.cjs\";\nexport { cd } from \"./cd/cd.cjs\";\nexport { tr } from \"./tr/tr.cjs\";\nexport { cut } from \"./cut/cut.cjs\";\nexport { od } from \"./od/od.cjs\";\n\n// Re-export all commands as a bundle\nimport { echo } from \"./echo/echo.cjs\";\nimport { printf } from \"./printf/printf.cjs\";\nimport { cat } from \"./cat/cat.cjs\";\nimport { grep } from \"./grep/grep.cjs\";\nimport { wc } from \"./wc/wc.cjs\";\nimport { head } from \"./head/head.cjs\";\nimport { tail } from \"./tail/tail.cjs\";\nimport { sort } from \"./sort/sort.cjs\";\nimport { uniq } from \"./uniq/uniq.cjs\";\nimport { pwd } from \"./pwd/pwd.cjs\";\nimport { ls } from \"./ls/ls.cjs\";\nimport { mkdir } from \"./mkdir/mkdir.cjs\";\nimport { rm } from \"./rm/rm.cjs\";\nimport { test, bracket } from \"./test/test.cjs\";\nimport { trueCmd, falseCmd } from \"./true-false/true-false.cjs\";\nimport { touch } from \"./touch/touch.cjs\";\nimport { cp } from \"./cp/cp.cjs\";\nimport { mv } from \"./mv/mv.cjs\";\nimport { tee } from \"./tee/tee.cjs\";\nimport { tree } from \"./tree/tree.cjs\";\nimport { find } from \"./find/find.cjs\";\nimport { sed } from \"./sed/sed.cjs\";\nimport { awk } from \"./awk/awk.cjs\";\nimport { breakCmd, continueCmd } from \"./break-continue/break-continue.cjs\";\nimport { colon } from \"./colon/colon.cjs\";\nimport { cd } from \"./cd/cd.cjs\";\nimport { tr } from \"./tr/tr.cjs\";\nimport { cut } from \"./cut/cut.cjs\";\nimport { od } from \"./od/od.cjs\";\n\nexport const builtinCommands: Record<string, Command> = {\n  echo,\n  printf,\n  cat,\n  grep,\n  wc,\n  head,\n  tail,\n  sort,\n  uniq,\n  pwd,\n  ls,\n  mkdir,\n  rm,\n  test,\n  \"[\": bracket,\n  true: trueCmd,\n  false: falseCmd,\n  touch,\n  cp,\n  mv,\n  tee,\n  tree,\n  find,\n  sed,\n  awk,\n  break: breakCmd,\n  continue: continueCmd,\n  \":\": colon,\n  cd,\n  tr,\n  cut,\n  od,\n};\n"
+    "import type { Command } from \"../types.cjs\";\n\nexport { echo } from \"./echo/echo.cjs\";\nexport { printf } from \"./printf/printf.cjs\";\nexport { cat } from \"./cat/cat.cjs\";\nexport { grep } from \"./grep/grep.cjs\";\nexport { wc } from \"./wc/wc.cjs\";\nexport { head } from \"./head/head.cjs\";\nexport { tail } from \"./tail/tail.cjs\";\nexport { sort } from \"./sort/sort.cjs\";\nexport { uniq } from \"./uniq/uniq.cjs\";\nexport { pwd } from \"./pwd/pwd.cjs\";\nexport { ls } from \"./ls/ls.cjs\";\nexport { mkdir } from \"./mkdir/mkdir.cjs\";\nexport { rm } from \"./rm/rm.cjs\";\nexport { test, bracket } from \"./test/test.cjs\";\nexport { trueCmd, falseCmd } from \"./true-false/true-false.cjs\";\nexport { touch } from \"./touch/touch.cjs\";\nexport { cp } from \"./cp/cp.cjs\";\nexport { mv } from \"./mv/mv.cjs\";\nexport { tee } from \"./tee/tee.cjs\";\nexport { tree } from \"./tree/tree.cjs\";\nexport { find } from \"./find/find.cjs\";\nexport { sed } from \"./sed/sed.cjs\";\nexport { awk } from \"./awk/awk.cjs\";\nexport { breakCmd, continueCmd } from \"./break-continue/break-continue.cjs\";\nexport { colon } from \"./colon/colon.cjs\";\nexport { cd } from \"./cd/cd.cjs\";\nexport { tr } from \"./tr/tr.cjs\";\nexport { cut } from \"./cut/cut.cjs\";\nexport { od } from \"./od/od.cjs\";\nexport { sh, evalCmd as eval, evalCmd, source, dot } from \"./sh/sh.cjs\";\nexport { exitCmd as exit, exitCmd } from \"./exit/exit.cjs\";\n\n// Re-export all commands as a bundle\nimport { echo } from \"./echo/echo.cjs\";\nimport { printf } from \"./printf/printf.cjs\";\nimport { cat } from \"./cat/cat.cjs\";\nimport { grep } from \"./grep/grep.cjs\";\nimport { wc } from \"./wc/wc.cjs\";\nimport { head } from \"./head/head.cjs\";\nimport { tail } from \"./tail/tail.cjs\";\nimport { sort } from \"./sort/sort.cjs\";\nimport { uniq } from \"./uniq/uniq.cjs\";\nimport { pwd } from \"./pwd/pwd.cjs\";\nimport { ls } from \"./ls/ls.cjs\";\nimport { mkdir } from \"./mkdir/mkdir.cjs\";\nimport { rm } from \"./rm/rm.cjs\";\nimport { test, bracket } from \"./test/test.cjs\";\nimport { trueCmd, falseCmd } from \"./true-false/true-false.cjs\";\nimport { touch } from \"./touch/touch.cjs\";\nimport { cp } from \"./cp/cp.cjs\";\nimport { mv } from \"./mv/mv.cjs\";\nimport { tee } from \"./tee/tee.cjs\";\nimport { tree } from \"./tree/tree.cjs\";\nimport { find } from \"./find/find.cjs\";\nimport { sed } from \"./sed/sed.cjs\";\nimport { awk } from \"./awk/awk.cjs\";\nimport { breakCmd, continueCmd } from \"./break-continue/break-continue.cjs\";\nimport { colon } from \"./colon/colon.cjs\";\nimport { cd } from \"./cd/cd.cjs\";\nimport { tr } from \"./tr/tr.cjs\";\nimport { cut } from \"./cut/cut.cjs\";\nimport { od } from \"./od/od.cjs\";\nimport { sh, evalCmd, source, dot } from \"./sh/sh.cjs\";\nimport { exitCmd } from \"./exit/exit.cjs\";\n\nexport const builtinCommands: Record<string, Command> = {\n  echo,\n  printf,\n  cat,\n  grep,\n  wc,\n  head,\n  tail,\n  sort,\n  uniq,\n  pwd,\n  ls,\n  mkdir,\n  rm,\n  test,\n  \"[\": bracket,\n  true: trueCmd,\n  false: falseCmd,\n  touch,\n  cp,\n  mv,\n  tee,\n  tree,\n  find,\n  sed,\n  awk,\n  break: breakCmd,\n  continue: continueCmd,\n  \":\": colon,\n  cd,\n  tr,\n  cut,\n  od,\n  sh,\n  eval: evalCmd,\n  source,\n  \".\": dot,\n  exit: exitCmd,\n};\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEqB,IAArB;AACuB,IAAvB;AACoB,IAApB;AACqB,IAArB;AACmB,IAAnB;AACqB,IAArB;AACqB,IAArB;AACqB,IAArB;AACqB,IAArB;AACoB,IAApB;AACmB,IAAnB;AACsB,IAAtB;AACmB,IAAnB;AAC8B,IAA9B;AACkC,IAAlC;AACsB,IAAtB;AACmB,IAAnB;AACmB,IAAnB;AACoB,IAApB;AACqB,IAArB;AACqB,IAArB;AACoB,IAApB;AACoB,IAApB;AACsC,IAAtC;AACsB,IAAtB;AACmB,IAAnB;AACmB,IAAnB;AACoB,IAApB;AACmB,IAAnB;AAGqB,IAArB;AACuB,IAAvB;AACoB,IAApB;AACqB,IAArB;AACmB,IAAnB;AACqB,IAArB;AACqB,IAArB;AACqB,IAArB;AACqB,IAArB;AACoB,IAApB;AACmB,IAAnB;AACsB,IAAtB;AACmB,IAAnB;AAC8B,IAA9B;AACkC,IAAlC;AACsB,IAAtB;AACmB,IAAnB;AACmB,IAAnB;AACoB,IAApB;AACqB,IAArB;AACqB,IAArB;AACoB,IAApB;AACoB,IAApB;AACsC,IAAtC;AACsB,IAAtB;AACmB,IAAnB;AACmB,IAAnB;AACoB,IAApB;AACmB,IAAnB;AAEO,IAAM,kBAA2C;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,KAAK;AAAA,EACL,MAAM;AAAA,EACN,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP,UAAU;AAAA,EACV,KAAK;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
-  "debugId": "2377F0DD6264750A64756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEqB,IAArB;AACuB,IAAvB;AACoB,IAApB;AACqB,IAArB;AACmB,IAAnB;AACqB,IAArB;AACqB,IAArB;AACqB,IAArB;AACqB,IAArB;AACoB,IAApB;AACmB,IAAnB;AACsB,IAAtB;AACmB,IAAnB;AAC8B,IAA9B;AACkC,IAAlC;AACsB,IAAtB;AACmB,IAAnB;AACmB,IAAnB;AACoB,IAApB;AACqB,IAArB;AACqB,IAArB;AACoB,IAApB;AACoB,IAApB;AACsC,IAAtC;AACsB,IAAtB;AACmB,IAAnB;AACmB,IAAnB;AACoB,IAApB;AACmB,IAAnB;AAC0D,IAA1D;AACyC,IAAzC;AAGqB,IAArB;AACuB,IAAvB;AACoB,IAApB;AACqB,IAArB;AACmB,IAAnB;AACqB,IAArB;AACqB,IAArB;AACqB,IAArB;AACqB,IAArB;AACoB,IAApB;AACmB,IAAnB;AACsB,IAAtB;AACmB,IAAnB;AAC8B,IAA9B;AACkC,IAAlC;AACsB,IAAtB;AACmB,IAAnB;AACmB,IAAnB;AACoB,IAApB;AACqB,IAArB;AACqB,IAArB;AACoB,IAApB;AACoB,IAApB;AACsC,IAAtC;AACsB,IAAtB;AACmB,IAAnB;AACmB,IAAnB;AACoB,IAApB;AACmB,IAAnB;AACyC,IAAzC;AACwB,IAAxB;AAEO,IAAM,kBAA2C;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,KAAK;AAAA,EACL,MAAM;AAAA,EACN,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP,UAAU;AAAA,EACV,KAAK;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,MAAM;AAAA,EACN;AAAA,EACA,KAAK;AAAA,EACL,MAAM;AACR;",
+  "debugId": "4755929D925B13DC64756E2164756E21",
   "names": []
 }

package/dist/cjs/src/commands/sh/sh.cjs

@@ -0,0 +1,134 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/commands/sh/sh.ts
+var exports_sh = {};
+__export(exports_sh, {
+  source: () => source,
+  sh: () => sh,
+  evalCmd: () => evalCmd,
+  dot: () => dot
+});
+module.exports = __toCommonJS(exports_sh);
+async function readShellFile(fs, cwd, pathName, stderr) {
+  const path = fs.resolve(cwd, pathName);
+  if (!await fs.exists(path)) {
+    await stderr.writeText(`sh: ${pathName}: No such file or directory
+`);
+    return { ok: false, exitCode: 127 };
+  }
+  const stat = await fs.stat(path);
+  if (stat.isDirectory()) {
+    await stderr.writeText(`sh: ${pathName}: is a directory
+`);
+    return { ok: false, exitCode: 126 };
+  }
+  if (!stat.isFile()) {
+    await stderr.writeText(`sh: ${pathName}: not a file
+`);
+    return { ok: false, exitCode: 126 };
+  }
+  try {
+    return { ok: true, source: await fs.readFile(path, "utf-8") };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    await stderr.writeText(`sh: ${pathName}: ${message}
+`);
+    return { ok: false, exitCode: 126 };
+  }
+}
+var sh = async (ctx) => {
+  if (!ctx.shell) {
+    await ctx.stderr.writeText(`sh: shell evaluation not supported
+`);
+    return 1;
+  }
+  if (ctx.args.length === 0) {
+    return ctx.shell.runShell(await ctx.stdin.text(), { argv0: "sh", args: [] });
+  }
+  const first = ctx.args[0];
+  if (first === "-c") {
+    const source = ctx.args[1];
+    if (source === undefined) {
+      await ctx.stderr.writeText(`sh: -c requires an argument
+`);
+      return 2;
+    }
+    const argv0 = ctx.args[2] ?? "sh";
+    const args = ctx.args[2] === undefined ? [] : ctx.args.slice(3);
+    return ctx.shell.runShell(source, { argv0, args });
+  }
+  if (first.startsWith("-")) {
+    await ctx.stderr.writeText(`sh: unsupported option: ${first}
+`);
+    return 2;
+  }
+  const loaded = await readShellFile(ctx.fs, ctx.cwd, first, ctx.stderr);
+  if (!loaded.ok) {
+    return loaded.exitCode;
+  }
+  return ctx.shell.runShell(loaded.source, { argv0: first, args: ctx.args.slice(1) });
+};
+var evalCmd = async (ctx) => {
+  if (!ctx.shell) {
+    await ctx.stderr.writeText(`eval: shell evaluation not supported
+`);
+    return 1;
+  }
+  if (ctx.args.length === 0) {
+    return 0;
+  }
+  return ctx.shell.eval(ctx.args.join(" "));
+};
+var source = async (ctx) => {
+  if (!ctx.shell) {
+    await ctx.stderr.writeText(`source: shell evaluation not supported
+`);
+    return 1;
+  }
+  const path = ctx.args[0];
+  if (path === undefined) {
+    await ctx.stderr.writeText(`source: filename argument required
+`);
+    return 2;
+  }
+  return ctx.shell.source(path, ctx.args.slice(1));
+};
+var dot = source;
+
+//# debugId=21C185C9E381C0F564756E2164756E21

package/dist/cjs/src/commands/sh/sh.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/commands/sh/sh.ts"],
+  "sourcesContent": [
+    "import type { Command, Stderr, VirtualFS } from \"../../types.cjs\";\n\nasync function readShellFile(\n  fs: VirtualFS,\n  cwd: string,\n  pathName: string,\n  stderr: Stderr\n): Promise<{ ok: true; source: string } | { ok: false; exitCode: number }> {\n  const path = fs.resolve(cwd, pathName);\n\n  if (!(await fs.exists(path))) {\n    await stderr.writeText(`sh: ${pathName}: No such file or directory\\n`);\n    return { ok: false, exitCode: 127 };\n  }\n\n  const stat = await fs.stat(path);\n  if (stat.isDirectory()) {\n    await stderr.writeText(`sh: ${pathName}: is a directory\\n`);\n    return { ok: false, exitCode: 126 };\n  }\n  if (!stat.isFile()) {\n    await stderr.writeText(`sh: ${pathName}: not a file\\n`);\n    return { ok: false, exitCode: 126 };\n  }\n\n  try {\n    return { ok: true, source: await fs.readFile(path, \"utf-8\") };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    await stderr.writeText(`sh: ${pathName}: ${message}\\n`);\n    return { ok: false, exitCode: 126 };\n  }\n}\n\nexport const sh: Command = async (ctx) => {\n  if (!ctx.shell) {\n    await ctx.stderr.writeText(\"sh: shell evaluation not supported\\n\");\n    return 1;\n  }\n\n  if (ctx.args.length === 0) {\n    return ctx.shell.runShell(await ctx.stdin.text(), { argv0: \"sh\", args: [] });\n  }\n\n  const first = ctx.args[0]!;\n  if (first === \"-c\") {\n    const source = ctx.args[1];\n    if (source === undefined) {\n      await ctx.stderr.writeText(\"sh: -c requires an argument\\n\");\n      return 2;\n    }\n\n    const argv0 = ctx.args[2] ?? \"sh\";\n    const args = ctx.args[2] === undefined ? [] : ctx.args.slice(3);\n    return ctx.shell.runShell(source, { argv0, args });\n  }\n\n  if (first.startsWith(\"-\")) {\n    await ctx.stderr.writeText(`sh: unsupported option: ${first}\\n`);\n    return 2;\n  }\n\n  const loaded = await readShellFile(ctx.fs, ctx.cwd, first, ctx.stderr);\n  if (!loaded.ok) {\n    return loaded.exitCode;\n  }\n\n  return ctx.shell.runShell(loaded.source, { argv0: first, args: ctx.args.slice(1) });\n};\n\nexport const evalCmd: Command = async (ctx) => {\n  if (!ctx.shell) {\n    await ctx.stderr.writeText(\"eval: shell evaluation not supported\\n\");\n    return 1;\n  }\n  if (ctx.args.length === 0) {\n    return 0;\n  }\n  return ctx.shell.eval(ctx.args.join(\" \"));\n};\n\nexport const source: Command = async (ctx) => {\n  if (!ctx.shell) {\n    await ctx.stderr.writeText(\"source: shell evaluation not supported\\n\");\n    return 1;\n  }\n  const path = ctx.args[0];\n  if (path === undefined) {\n    await ctx.stderr.writeText(\"source: filename argument required\\n\");\n    return 2;\n  }\n  return ctx.shell.source(path, ctx.args.slice(1));\n};\n\nexport const dot = source;\n"
+  ],
+  "mappings": "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",
+  "debugId": "21C185C9E381C0F564756E2164756E21",
+  "names": []
+}

package/dist/cjs/src/index.cjs

@@ -79,6 +79,7 @@ __export(exports_src, {
   LexError: () => import_errors.LexError,
   Interpreter: () => import_interpreter.Interpreter,
   FileSystem: () => import_fs2.FileSystem,
+  ExitException: () => import_interpreter.ExitException,
   ContinueException: () => import_interpreter.ContinueException,
   BreakException: () => import_interpreter.BreakException
 });
@@ -98,4 +99,4 @@ var import_io2 = require("./io/index.cjs");
 var import_utils = require("./utils/index.cjs");
 var import_vcs = require("./vcs/index.cjs");
 
-//# debugId=188D4F3252D1BB8C64756E2164756E21
+//# debugId=A1C14CC7E153FA4864756E2164756E21

package/dist/cjs/src/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/index.ts"],
   "sourcesContent": [
-    "// Main class exports\nexport { ShellDSL, createShellDSL, type Program } from \"./shell-dsl.cjs\";\nexport { ShellPromise, type ShellPromiseOptions } from \"./shell-promise.cjs\";\n\n// Types\nexport type {\n  VirtualFS,\n  VirtualFSWritable,\n  FileStat,\n  Command,\n  CommandContext,\n  Stdin,\n  Stdout,\n  Stderr,\n  OutputCollector,\n  ExecResult,\n  ShellConfig,\n  RawValue,\n} from \"./types.cjs\";\nexport { isRawValue } from \"./types.cjs\";\n\n// Errors\nexport { ShellError, LexError, ParseError } from \"./errors.cjs\";\n\n// Lexer\nexport { Lexer, lex, tokenToString } from \"./lexer/index.cjs\";\nexport type { Token, RedirectMode } from \"./lexer/index.cjs\";\n\n// Parser\nexport { Parser, parse } from \"./parser/index.cjs\";\nexport type {\n  ASTNode,\n  Redirect,\n  CommandNode,\n  PipelineNode,\n  AndNode,\n  OrNode,\n  SequenceNode,\n  WordNode,\n  WordPart,\n  TextPart,\n  VariablePart,\n  SubstitutionPart,\n  ArithmeticPart,\n  IfNode,\n  ForNode,\n  WhileNode,\n  UntilNode,\n  CaseNode,\n  CaseClause,\n} from \"./parser/index.cjs\";\nexport {\n  isWordNode,\n  isCommandNode,\n  isPipelineNode,\n  isAndNode,\n  isOrNode,\n  isSequenceNode,\n  isIfNode,\n  isForNode,\n  isWhileNode,\n  isUntilNode,\n  isCaseNode,\n} from \"./parser/index.cjs\";\n\n// Interpreter\nexport { Interpreter, type InterpreterOptions, BreakException, ContinueException } from \"./interpreter/index.cjs\";\n\n// Filesystem\nexport { createVirtualFS } from \"./fs/index.cjs\";\nexport {\n  FileSystem,\n  ReadOnlyFileSystem,\n  WebFileSystem,\n  createWebUnderlyingFS,\n  type PathOps,\n  type Permission,\n  type PermissionRules,\n  type UnderlyingFS,\n} from \"./fs/index.cjs\";\n\n// I/O\nexport { createStdin, StdinImpl } from \"./io/index.cjs\";\nexport { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from \"./io/index.cjs\";\n\n// Utilities\nexport { escape, escapeForInterpolation, globVirtualFS } from \"./utils/index.cjs\";\nexport type { GlobVirtualFS, GlobOptions } from \"./utils/index.cjs\";\n\n// Version Control\nexport { VersionControlSystem } from \"./vcs/index.cjs\";\nexport type {\n  VCSConfig,\n  VCSAttributeRule,\n  VCSResolvedAttributes,\n  VCSDiffMode,\n  VCSPatchSuppressionReason,\n  Revision,\n  DiffEntry,\n  TreeManifest,\n  TreeEntry,\n  FileEntry,\n  DirectoryEntry,\n  VCSIndexEntry,\n  VCSIndexFile,\n  CommitOptions,\n  CheckoutOptions,\n  LogOptions,\n  LogEntry,\n  BranchInfo,\n} from \"./vcs/index.cjs\";\n"
+    "// Main class exports\nexport { ShellDSL, createShellDSL, type Program } from \"./shell-dsl.cjs\";\nexport { ShellPromise, type ShellPromiseOptions } from \"./shell-promise.cjs\";\n\n// Types\nexport type {\n  VirtualFS,\n  VirtualFSWritable,\n  FileStat,\n  Command,\n  CommandContext,\n  Stdin,\n  Stdout,\n  Stderr,\n  OutputCollector,\n  ExecResult,\n  ShellConfig,\n  ShellCommandApi,\n  ShellRunOptions,\n  RawValue,\n} from \"./types.cjs\";\nexport { isRawValue } from \"./types.cjs\";\n\n// Errors\nexport { ShellError, LexError, ParseError } from \"./errors.cjs\";\n\n// Lexer\nexport { Lexer, lex, tokenToString } from \"./lexer/index.cjs\";\nexport type { Token, RedirectMode } from \"./lexer/index.cjs\";\n\n// Parser\nexport { Parser, parse } from \"./parser/index.cjs\";\nexport type {\n  ASTNode,\n  Redirect,\n  CommandNode,\n  PipelineNode,\n  AndNode,\n  OrNode,\n  SequenceNode,\n  WordNode,\n  WordPart,\n  TextPart,\n  VariablePart,\n  SubstitutionPart,\n  ArithmeticPart,\n  IfNode,\n  ForNode,\n  WhileNode,\n  UntilNode,\n  CaseNode,\n  CaseClause,\n} from \"./parser/index.cjs\";\nexport {\n  isWordNode,\n  isCommandNode,\n  isPipelineNode,\n  isAndNode,\n  isOrNode,\n  isSequenceNode,\n  isIfNode,\n  isForNode,\n  isWhileNode,\n  isUntilNode,\n  isCaseNode,\n} from \"./parser/index.cjs\";\n\n// Interpreter\nexport { Interpreter, type InterpreterOptions, BreakException, ContinueException, ExitException } from \"./interpreter/index.cjs\";\n\n// Filesystem\nexport { createVirtualFS } from \"./fs/index.cjs\";\nexport {\n  FileSystem,\n  ReadOnlyFileSystem,\n  WebFileSystem,\n  createWebUnderlyingFS,\n  type PathOps,\n  type Permission,\n  type PermissionRules,\n  type UnderlyingFS,\n} from \"./fs/index.cjs\";\n\n// I/O\nexport { createStdin, StdinImpl } from \"./io/index.cjs\";\nexport { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from \"./io/index.cjs\";\n\n// Utilities\nexport { escape, escapeForInterpolation, globVirtualFS } from \"./utils/index.cjs\";\nexport type { GlobVirtualFS, GlobOptions } from \"./utils/index.cjs\";\n\n// Version Control\nexport { VersionControlSystem } from \"./vcs/index.cjs\";\nexport type {\n  VCSConfig,\n  VCSAttributeRule,\n  VCSResolvedAttributes,\n  VCSDiffMode,\n  VCSPatchSuppressionReason,\n  Revision,\n  DiffEntry,\n  TreeManifest,\n  TreeEntry,\n  FileEntry,\n  DirectoryEntry,\n  VCSIndexEntry,\n  VCSIndexFile,\n  CommitOptions,\n  CheckoutOptions,\n  LogOptions,\n  LogEntry,\n  BranchInfo,\n} from \"./vcs/index.cjs\";\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACuD,IAAvD;AACuD,IAAvD;AAiB2B,IAA3B;AAGiD,IAAjD;AAG0C,IAA1C;AAI8B,IAA9B;AAkCO,IAZP;AAewF,IAAxF;AAGgC,IAAhC;AAUO,IATP;AAYuC,IAAvC;AACwF,IAAxF;AAG8D,IAA9D;AAIqC,IAArC;",
-  "debugId": "188D4F3252D1BB8C64756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACuD,IAAvD;AACuD,IAAvD;AAmB2B,IAA3B;AAGiD,IAAjD;AAG0C,IAA1C;AAI8B,IAA9B;AAkCO,IAZP;AAeuG,IAAvG;AAGgC,IAAhC;AAUO,IATP;AAYuC,IAAvC;AACwF,IAAxF;AAG8D,IAA9D;AAIqC,IAArC;",
+  "debugId": "A1C14CC7E153FA4864756E2164756E21",
   "names": []
 }

package/dist/cjs/src/interpreter/context.cjs

@@ -56,7 +56,10 @@ function createCommandContext(options) {
   if (options.exec) {
     ctx.exec = options.exec;
   }
+  if (options.shell) {
+    ctx.shell = options.shell;
+  }
   return ctx;
 }
 
-//# debugId=F914897FD3ECFE8664756E2164756E21
+//# debugId=A1213B6F49E1441764756E2164756E21

package/dist/cjs/src/interpreter/context.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/interpreter/context.ts"],
   "sourcesContent": [
-    "import type { CommandContext, VirtualFS, Stdin, Stdout, Stderr, ExecResult } from \"../types.cjs\";\n\nexport interface ContextOptions {\n  args: string[];\n  stdin: Stdin;\n  stdout: Stdout;\n  stderr: Stderr;\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  setCwd: (path: string) => void;\n  exec?: (name: string, args: string[]) => Promise<ExecResult>;\n}\n\nexport function createCommandContext(options: ContextOptions): CommandContext {\n  const ctx: CommandContext = {\n    args: options.args,\n    stdin: options.stdin,\n    stdout: options.stdout,\n    stderr: options.stderr,\n    fs: options.fs,\n    cwd: options.cwd,\n    env: options.env,\n    setCwd: options.setCwd,\n  };\n  if (options.exec) {\n    ctx.exec = options.exec;\n  }\n  return ctx;\n}\n"
+    "import type { CommandContext, VirtualFS, Stdin, Stdout, Stderr, ExecResult, ShellCommandApi } from \"../types.cjs\";\n\nexport interface ContextOptions {\n  args: string[];\n  stdin: Stdin;\n  stdout: Stdout;\n  stderr: Stderr;\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  setCwd: (path: string) => void;\n  exec?: (name: string, args: string[]) => Promise<ExecResult>;\n  shell?: ShellCommandApi;\n}\n\nexport function createCommandContext(options: ContextOptions): CommandContext {\n  const ctx: CommandContext = {\n    args: options.args,\n    stdin: options.stdin,\n    stdout: options.stdout,\n    stderr: options.stderr,\n    fs: options.fs,\n    cwd: options.cwd,\n    env: options.env,\n    setCwd: options.setCwd,\n  };\n  if (options.exec) {\n    ctx.exec = options.exec;\n  }\n  if (options.shell) {\n    ctx.shell = options.shell;\n  }\n  return ctx;\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcO,SAAS,oBAAoB,CAAC,SAAyC;AAAA,EAC5E,MAAM,MAAsB;AAAA,IAC1B,MAAM,QAAQ;AAAA,IACd,OAAO,QAAQ;AAAA,IACf,QAAQ,QAAQ;AAAA,IAChB,QAAQ,QAAQ;AAAA,IAChB,IAAI,QAAQ;AAAA,IACZ,KAAK,QAAQ;AAAA,IACb,KAAK,QAAQ;AAAA,IACb,QAAQ,QAAQ;AAAA,EAClB;AAAA,EACA,IAAI,QAAQ,MAAM;AAAA,IAChB,IAAI,OAAO,QAAQ;AAAA,EACrB;AAAA,EACA,OAAO;AAAA;",
-  "debugId": "F914897FD3ECFE8664756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeO,SAAS,oBAAoB,CAAC,SAAyC;AAAA,EAC5E,MAAM,MAAsB;AAAA,IAC1B,MAAM,QAAQ;AAAA,IACd,OAAO,QAAQ;AAAA,IACf,QAAQ,QAAQ;AAAA,IAChB,QAAQ,QAAQ;AAAA,IAChB,IAAI,QAAQ;AAAA,IACZ,KAAK,QAAQ;AAAA,IACb,KAAK,QAAQ;AAAA,IACb,QAAQ,QAAQ;AAAA,EAClB;AAAA,EACA,IAAI,QAAQ,MAAM;AAAA,IAChB,IAAI,OAAO,QAAQ;AAAA,EACrB;AAAA,EACA,IAAI,QAAQ,OAAO;AAAA,IACjB,IAAI,QAAQ,QAAQ;AAAA,EACtB;AAAA,EACA,OAAO;AAAA;",
+  "debugId": "A1213B6F49E1441764756E2164756E21",
   "names": []
 }

package/dist/cjs/src/interpreter/index.cjs

@@ -41,6 +41,7 @@ var exports_interpreter = {};
 __export(exports_interpreter, {
   createCommandContext: () => import_context.createCommandContext,
   Interpreter: () => import_interpreter.Interpreter,
+  ExitException: () => import_interpreter.ExitException,
   ContinueException: () => import_interpreter.ContinueException,
   BreakException: () => import_interpreter.BreakException
 });
@@ -48,4 +49,4 @@ module.exports = __toCommonJS(exports_interpreter);
 var import_interpreter = require("./interpreter.cjs");
 var import_context = require("./context.cjs");
 
-//# debugId=D80D067B497FC53D64756E2164756E21
+//# debugId=478C5E50B11BB65664756E2164756E21

package/dist/cjs/src/interpreter/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/interpreter/index.ts"],
   "sourcesContent": [
-    "export { Interpreter, type InterpreterOptions, BreakException, ContinueException } from \"./interpreter.cjs\";\nexport { createCommandContext, type ContextOptions } from \"./context.cjs\";\n"
+    "export { Interpreter, type InterpreterOptions, BreakException, ContinueException, ExitException } from \"./interpreter.cjs\";\nexport { createCommandContext, type ContextOptions } from \"./context.cjs\";\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAwF,IAAxF;AAC0D,IAA1D;",
-  "debugId": "D80D067B497FC53D64756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAuG,IAAvG;AAC0D,IAA1D;",
+  "debugId": "478C5E50B11BB65664756E2164756E21",
   "names": []
 }