just-bash 1.2.0 → 1.2.2

package/dist/interpreter/errors.d.ts

@@ -99,6 +99,14 @@ export declare class ExecutionLimitError extends ControlFlowError {
     static readonly EXIT_CODE = 126;
     constructor(message: string, limitType: "recursion" | "commands" | "iterations", stdout?: string, stderr?: string);
 }
+/**
+ * Error thrown when break/continue is called in a subshell that was
+ * spawned from within a loop context. Causes the subshell to exit cleanly.
+ */
+export declare class SubshellExitError extends ControlFlowError {
+    readonly name = "SubshellExitError";
+    constructor(stdout?: string, stderr?: string);
+}
 /**
  * Type guard for errors that exit the current scope (return, break, continue).
  * These need special handling vs errexit/nounset which terminate execution.

package/dist/interpreter/types.d.ts

@@ -37,6 +37,8 @@ export interface InterpreterState {
     inCondition: boolean;
     /** Current loop nesting depth (for break/continue) */
     loopDepth: number;
+    /** True if this subshell was spawned from within a loop context (for break/continue to exit subshell) */
+    parentHasLoopContext?: boolean;
     /** Stdin available for commands in compound commands (groups, subshells, while loops with piped input) */
     groupStdin?: string;
     /** Set of variable names that are readonly */

package/dist/types.d.ts

@@ -12,12 +12,16 @@ export interface ExecResult {
 export interface BashExecResult extends ExecResult {
     env: Record<string, string>;
 }
-/** Options for exec calls within commands */
+/** Options for exec calls within commands (internal API) */
 export interface CommandExecOptions {
     /** Environment variables to merge into the exec state */
     env?: Record<string, string>;
-    /** Working directory for the exec */
-    cwd?: string;
+    /**
+     * Working directory for the exec.
+     * Required to prevent bugs where subcommands run in the wrong directory.
+     * Always pass `ctx.cwd` from the calling command's context.
+     */
+    cwd: string;
 }
 /**
  * Context provided to commands during execution.
@@ -52,8 +56,11 @@ export interface CommandContext {
     /**
      * Execute a subcommand (e.g., for `xargs`, `bash -c`).
      * Available when running commands via BashEnv interpreter.
+     *
+     * @param command - The command string to execute
+     * @param options - Required options including `cwd` to prevent directory bugs
      */
-    exec?: (command: string, options?: CommandExecOptions) => Promise<ExecResult>;
+    exec?: (command: string, options: CommandExecOptions) => Promise<ExecResult>;
     /**
      * Secure fetch function for network requests (e.g., for `curl`).
      * Only available when `network` option is configured in BashEnv.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "just-bash",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "A simulated bash environment with virtual filesystem",
   "repository": {
     "type": "git",
@@ -97,6 +97,7 @@
     "test:dist": "vitest run src/cli/just-bash.bundle.test.ts",
     "test:unit": "vitest run --config vitest.unit.config.ts",
     "test:comparison": "vitest run --config vitest.comparison.config.ts",
+    "test:comparison:record": "RECORD_FIXTURES=1 vitest run --config vitest.comparison.config.ts",
     "shell": "npx tsx src/cli/shell.ts",
     "dev:exec": "npx tsx src/cli/exec.ts"
   }