shell-dsl 0.0.40 → 0.0.42

package/dist/mjs/src/io/stdout.mjs

@@ -6,14 +6,17 @@ class OutputCollectorImpl {
   resolveWait = null;
   waitPromise = null;
   isTTY;
-  constructor(isTTY = false) {
+  onWrite;
+  constructor(isTTY = false, onWrite) {
     this.isTTY = isTTY;
+    this.onWrite = onWrite;
   }
   async write(chunk) {
     if (this.closed) {
       throw new Error("Output stream is closed");
     }
     this.chunks.push(chunk);
+    await this.onWrite?.(chunk);
     if (this.resolveWait) {
       this.resolveWait();
       this.resolveWait = null;
@@ -112,11 +115,11 @@ class PipeBuffer {
     }
   }
 }
-function createStdout(isTTY = false) {
-  return new OutputCollectorImpl(isTTY);
+function createStdout(isTTY = false, onWrite) {
+  return new OutputCollectorImpl(isTTY, onWrite);
 }
-function createStderr(isTTY = false) {
-  return new OutputCollectorImpl(isTTY);
+function createStderr(isTTY = false, onWrite) {
+  return new OutputCollectorImpl(isTTY, onWrite);
 }
 function createPipe() {
   return new PipeBuffer;
@@ -175,4 +178,4 @@ export {
   BufferTargetCollector
 };
 
-//# debugId=FD52BAF67333F9F064756E2164756E21
+//# debugId=FD76C10E4B60500564756E2164756E21

package/dist/mjs/src/io/stdout.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/io/stdout.ts"],
   "sourcesContent": [
-    "import type { Stdout, Stderr, OutputCollector } from \"../types.mjs\";\n\nexport class OutputCollectorImpl implements OutputCollector {\n  private chunks: Uint8Array[] = [];\n  private closed: boolean = false;\n  private closeResolvers: Array<() => void> = [];\n  private resolveWait: (() => void) | null = null;\n  private waitPromise: Promise<void> | null = null;\n  public isTTY: boolean;\n\n  constructor(isTTY: boolean = false) {\n    this.isTTY = isTTY;\n  }\n\n  async write(chunk: Uint8Array): Promise<void> {\n    if (this.closed) {\n      throw new Error(\"Output stream is closed\");\n    }\n    this.chunks.push(chunk);\n    if (this.resolveWait) {\n      this.resolveWait();\n      this.resolveWait = null;\n      this.waitPromise = null;\n    }\n  }\n\n  async writeText(str: string): Promise<void> {\n    await this.write(new TextEncoder().encode(str));\n  }\n\n  close(): void {\n    this.closed = true;\n    if (this.resolveWait) {\n      this.resolveWait();\n      this.resolveWait = null;\n      this.waitPromise = null;\n    }\n    // Wake up anyone waiting for close\n    for (const resolve of this.closeResolvers) {\n      resolve();\n    }\n    this.closeResolvers = [];\n  }\n\n  async collect(): Promise<Buffer> {\n    // Wait until closed\n    while (!this.closed) {\n      await new Promise<void>((resolve) => {\n        this.closeResolvers.push(resolve);\n      });\n    }\n    return Buffer.concat(this.chunks);\n  }\n\n  async *getReadableStream(): AsyncIterable<Uint8Array> {\n    let index = 0;\n\n    while (true) {\n      while (index < this.chunks.length) {\n        yield this.chunks[index]!;\n        index++;\n      }\n\n      if (this.closed) {\n        break;\n      }\n\n      // Wait for more data or close\n      if (!this.waitPromise) {\n        this.waitPromise = new Promise<void>((resolve) => {\n          this.resolveWait = resolve;\n        });\n      }\n      await this.waitPromise;\n    }\n  }\n}\n\nexport class PipeBuffer implements OutputCollector, Stdout {\n  private chunks: Uint8Array[] = [];\n  private closed: boolean = false;\n  private waitingReaders: Array<() => void> = [];\n  private readIndex: number = 0;\n  public readonly isTTY: boolean = false;\n\n  async write(chunk: Uint8Array): Promise<void> {\n    if (this.closed) {\n      throw new Error(\"Pipe is closed\");\n    }\n    this.chunks.push(chunk);\n    // Wake up any waiting readers\n    for (const resolve of this.waitingReaders) {\n      resolve();\n    }\n    this.waitingReaders = [];\n  }\n\n  async writeText(str: string): Promise<void> {\n    await this.write(new TextEncoder().encode(str));\n  }\n\n  close(): void {\n    this.closed = true;\n    // Wake up any waiting readers\n    for (const resolve of this.waitingReaders) {\n      resolve();\n    }\n    this.waitingReaders = [];\n  }\n\n  async collect(): Promise<Buffer> {\n    // Wait until closed\n    while (!this.closed) {\n      await new Promise<void>((resolve) => {\n        this.waitingReaders.push(resolve);\n      });\n    }\n    return Buffer.concat(this.chunks);\n  }\n\n  async *getReadableStream(): AsyncIterable<Uint8Array> {\n    while (true) {\n      // Yield any available chunks\n      while (this.readIndex < this.chunks.length) {\n        yield this.chunks[this.readIndex]!;\n        this.readIndex++;\n      }\n\n      if (this.closed) {\n        break;\n      }\n\n      // Wait for more data\n      await new Promise<void>((resolve) => {\n        this.waitingReaders.push(resolve);\n      });\n    }\n  }\n}\n\nexport function createStdout(isTTY: boolean = false): OutputCollector {\n  return new OutputCollectorImpl(isTTY);\n}\n\nexport function createStderr(isTTY: boolean = false): OutputCollector {\n  return new OutputCollectorImpl(isTTY);\n}\n\nexport function createPipe(): PipeBuffer {\n  return new PipeBuffer();\n}\n\nexport class BufferTargetCollector implements OutputCollector {\n  private target: Buffer;\n  private offset: number = 0;\n  private closed: boolean = false;\n  private closeResolvers: Array<() => void> = [];\n  public readonly isTTY: boolean = false;\n\n  constructor(target: Buffer) {\n    this.target = target;\n  }\n\n  async write(chunk: Uint8Array): Promise<void> {\n    if (this.closed) {\n      throw new Error(\"Output stream is closed\");\n    }\n    for (let i = 0; i < chunk.length && this.offset < this.target.length; i++) {\n      this.target[this.offset++] = chunk[i]!;\n    }\n  }\n\n  async writeText(str: string): Promise<void> {\n    const bytes = new TextEncoder().encode(str);\n    await this.write(bytes);\n  }\n\n  close(): void {\n    this.closed = true;\n    for (const resolve of this.closeResolvers) {\n      resolve();\n    }\n    this.closeResolvers = [];\n  }\n\n  async collect(): Promise<Buffer> {\n    while (!this.closed) {\n      await new Promise<void>((resolve) => {\n        this.closeResolvers.push(resolve);\n      });\n    }\n    return this.target.subarray(0, this.offset) as Buffer;\n  }\n\n  async *getReadableStream(): AsyncIterable<Uint8Array> {\n    yield this.target.subarray(0, this.offset);\n  }\n}\n\nexport function createBufferTargetCollector(target: Buffer): OutputCollector {\n  return new BufferTargetCollector(target);\n}\n"
+    "import type { Stdout, Stderr, OutputCollector } from \"../types.mjs\";\n\nexport class OutputCollectorImpl implements OutputCollector {\n  private chunks: Uint8Array[] = [];\n  private closed: boolean = false;\n  private closeResolvers: Array<() => void> = [];\n  private resolveWait: (() => void) | null = null;\n  private waitPromise: Promise<void> | null = null;\n  public isTTY: boolean;\n  private onWrite?: (chunk: Uint8Array) => void | Promise<void>;\n\n  constructor(isTTY: boolean = false, onWrite?: (chunk: Uint8Array) => void | Promise<void>) {\n    this.isTTY = isTTY;\n    this.onWrite = onWrite;\n  }\n\n  async write(chunk: Uint8Array): Promise<void> {\n    if (this.closed) {\n      throw new Error(\"Output stream is closed\");\n    }\n    this.chunks.push(chunk);\n    await this.onWrite?.(chunk);\n    if (this.resolveWait) {\n      this.resolveWait();\n      this.resolveWait = null;\n      this.waitPromise = null;\n    }\n  }\n\n  async writeText(str: string): Promise<void> {\n    await this.write(new TextEncoder().encode(str));\n  }\n\n  close(): void {\n    this.closed = true;\n    if (this.resolveWait) {\n      this.resolveWait();\n      this.resolveWait = null;\n      this.waitPromise = null;\n    }\n    // Wake up anyone waiting for close\n    for (const resolve of this.closeResolvers) {\n      resolve();\n    }\n    this.closeResolvers = [];\n  }\n\n  async collect(): Promise<Buffer> {\n    // Wait until closed\n    while (!this.closed) {\n      await new Promise<void>((resolve) => {\n        this.closeResolvers.push(resolve);\n      });\n    }\n    return Buffer.concat(this.chunks);\n  }\n\n  async *getReadableStream(): AsyncIterable<Uint8Array> {\n    let index = 0;\n\n    while (true) {\n      while (index < this.chunks.length) {\n        yield this.chunks[index]!;\n        index++;\n      }\n\n      if (this.closed) {\n        break;\n      }\n\n      // Wait for more data or close\n      if (!this.waitPromise) {\n        this.waitPromise = new Promise<void>((resolve) => {\n          this.resolveWait = resolve;\n        });\n      }\n      await this.waitPromise;\n    }\n  }\n}\n\nexport class PipeBuffer implements OutputCollector, Stdout {\n  private chunks: Uint8Array[] = [];\n  private closed: boolean = false;\n  private waitingReaders: Array<() => void> = [];\n  private readIndex: number = 0;\n  public readonly isTTY: boolean = false;\n\n  async write(chunk: Uint8Array): Promise<void> {\n    if (this.closed) {\n      throw new Error(\"Pipe is closed\");\n    }\n    this.chunks.push(chunk);\n    // Wake up any waiting readers\n    for (const resolve of this.waitingReaders) {\n      resolve();\n    }\n    this.waitingReaders = [];\n  }\n\n  async writeText(str: string): Promise<void> {\n    await this.write(new TextEncoder().encode(str));\n  }\n\n  close(): void {\n    this.closed = true;\n    // Wake up any waiting readers\n    for (const resolve of this.waitingReaders) {\n      resolve();\n    }\n    this.waitingReaders = [];\n  }\n\n  async collect(): Promise<Buffer> {\n    // Wait until closed\n    while (!this.closed) {\n      await new Promise<void>((resolve) => {\n        this.waitingReaders.push(resolve);\n      });\n    }\n    return Buffer.concat(this.chunks);\n  }\n\n  async *getReadableStream(): AsyncIterable<Uint8Array> {\n    while (true) {\n      // Yield any available chunks\n      while (this.readIndex < this.chunks.length) {\n        yield this.chunks[this.readIndex]!;\n        this.readIndex++;\n      }\n\n      if (this.closed) {\n        break;\n      }\n\n      // Wait for more data\n      await new Promise<void>((resolve) => {\n        this.waitingReaders.push(resolve);\n      });\n    }\n  }\n}\n\nexport function createStdout(\n  isTTY: boolean = false,\n  onWrite?: (chunk: Uint8Array) => void | Promise<void>\n): OutputCollector {\n  return new OutputCollectorImpl(isTTY, onWrite);\n}\n\nexport function createStderr(\n  isTTY: boolean = false,\n  onWrite?: (chunk: Uint8Array) => void | Promise<void>\n): OutputCollector {\n  return new OutputCollectorImpl(isTTY, onWrite);\n}\n\nexport function createPipe(): PipeBuffer {\n  return new PipeBuffer();\n}\n\nexport class BufferTargetCollector implements OutputCollector {\n  private target: Buffer;\n  private offset: number = 0;\n  private closed: boolean = false;\n  private closeResolvers: Array<() => void> = [];\n  public readonly isTTY: boolean = false;\n\n  constructor(target: Buffer) {\n    this.target = target;\n  }\n\n  async write(chunk: Uint8Array): Promise<void> {\n    if (this.closed) {\n      throw new Error(\"Output stream is closed\");\n    }\n    for (let i = 0; i < chunk.length && this.offset < this.target.length; i++) {\n      this.target[this.offset++] = chunk[i]!;\n    }\n  }\n\n  async writeText(str: string): Promise<void> {\n    const bytes = new TextEncoder().encode(str);\n    await this.write(bytes);\n  }\n\n  close(): void {\n    this.closed = true;\n    for (const resolve of this.closeResolvers) {\n      resolve();\n    }\n    this.closeResolvers = [];\n  }\n\n  async collect(): Promise<Buffer> {\n    while (!this.closed) {\n      await new Promise<void>((resolve) => {\n        this.closeResolvers.push(resolve);\n      });\n    }\n    return this.target.subarray(0, this.offset) as Buffer;\n  }\n\n  async *getReadableStream(): AsyncIterable<Uint8Array> {\n    yield this.target.subarray(0, this.offset);\n  }\n}\n\nexport function createBufferTargetCollector(target: Buffer): OutputCollector {\n  return new BufferTargetCollector(target);\n}\n"
   ],
-  "mappings": ";AAEO,MAAM,oBAA+C;AAAA,EAClD,SAAuB,CAAC;AAAA,EACxB,SAAkB;AAAA,EAClB,iBAAoC,CAAC;AAAA,EACrC,cAAmC;AAAA,EACnC,cAAoC;AAAA,EACrC;AAAA,EAEP,WAAW,CAAC,QAAiB,OAAO;AAAA,IAClC,KAAK,QAAQ;AAAA;AAAA,OAGT,MAAK,CAAC,OAAkC;AAAA,IAC5C,IAAI,KAAK,QAAQ;AAAA,MACf,MAAM,IAAI,MAAM,yBAAyB;AAAA,IAC3C;AAAA,IACA,KAAK,OAAO,KAAK,KAAK;AAAA,IACtB,IAAI,KAAK,aAAa;AAAA,MACpB,KAAK,YAAY;AAAA,MACjB,KAAK,cAAc;AAAA,MACnB,KAAK,cAAc;AAAA,IACrB;AAAA;AAAA,OAGI,UAAS,CAAC,KAA4B;AAAA,IAC1C,MAAM,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,GAAG,CAAC;AAAA;AAAA,EAGhD,KAAK,GAAS;AAAA,IACZ,KAAK,SAAS;AAAA,IACd,IAAI,KAAK,aAAa;AAAA,MACpB,KAAK,YAAY;AAAA,MACjB,KAAK,cAAc;AAAA,MACnB,KAAK,cAAc;AAAA,IACrB;AAAA,IAEA,WAAW,WAAW,KAAK,gBAAgB;AAAA,MACzC,QAAQ;AAAA,IACV;AAAA,IACA,KAAK,iBAAiB,CAAC;AAAA;AAAA,OAGnB,QAAO,GAAoB;AAAA,IAE/B,OAAO,CAAC,KAAK,QAAQ;AAAA,MACnB,MAAM,IAAI,QAAc,CAAC,YAAY;AAAA,QACnC,KAAK,eAAe,KAAK,OAAO;AAAA,OACjC;AAAA,IACH;AAAA,IACA,OAAO,OAAO,OAAO,KAAK,MAAM;AAAA;AAAA,SAG3B,iBAAiB,GAA8B;AAAA,IACpD,IAAI,QAAQ;AAAA,IAEZ,OAAO,MAAM;AAAA,MACX,OAAO,QAAQ,KAAK,OAAO,QAAQ;AAAA,QACjC,MAAM,KAAK,OAAO;AAAA,QAClB;AAAA,MACF;AAAA,MAEA,IAAI,KAAK,QAAQ;AAAA,QACf;AAAA,MACF;AAAA,MAGA,IAAI,CAAC,KAAK,aAAa;AAAA,QACrB,KAAK,cAAc,IAAI,QAAc,CAAC,YAAY;AAAA,UAChD,KAAK,cAAc;AAAA,SACpB;AAAA,MACH;AAAA,MACA,MAAM,KAAK;AAAA,IACb;AAAA;AAEJ;AAAA;AAEO,MAAM,WAA8C;AAAA,EACjD,SAAuB,CAAC;AAAA,EACxB,SAAkB;AAAA,EAClB,iBAAoC,CAAC;AAAA,EACrC,YAAoB;AAAA,EACZ,QAAiB;AAAA,OAE3B,MAAK,CAAC,OAAkC;AAAA,IAC5C,IAAI,KAAK,QAAQ;AAAA,MACf,MAAM,IAAI,MAAM,gBAAgB;AAAA,IAClC;AAAA,IACA,KAAK,OAAO,KAAK,KAAK;AAAA,IAEtB,WAAW,WAAW,KAAK,gBAAgB;AAAA,MACzC,QAAQ;AAAA,IACV;AAAA,IACA,KAAK,iBAAiB,CAAC;AAAA;AAAA,OAGnB,UAAS,CAAC,KAA4B;AAAA,IAC1C,MAAM,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,GAAG,CAAC;AAAA;AAAA,EAGhD,KAAK,GAAS;AAAA,IACZ,KAAK,SAAS;AAAA,IAEd,WAAW,WAAW,KAAK,gBAAgB;AAAA,MACzC,QAAQ;AAAA,IACV;AAAA,IACA,KAAK,iBAAiB,CAAC;AAAA;AAAA,OAGnB,QAAO,GAAoB;AAAA,IAE/B,OAAO,CAAC,KAAK,QAAQ;AAAA,MACnB,MAAM,IAAI,QAAc,CAAC,YAAY;AAAA,QACnC,KAAK,eAAe,KAAK,OAAO;AAAA,OACjC;AAAA,IACH;AAAA,IACA,OAAO,OAAO,OAAO,KAAK,MAAM;AAAA;AAAA,SAG3B,iBAAiB,GAA8B;AAAA,IACpD,OAAO,MAAM;AAAA,MAEX,OAAO,KAAK,YAAY,KAAK,OAAO,QAAQ;AAAA,QAC1C,MAAM,KAAK,OAAO,KAAK;AAAA,QACvB,KAAK;AAAA,MACP;AAAA,MAEA,IAAI,KAAK,QAAQ;AAAA,QACf;AAAA,MACF;AAAA,MAGA,MAAM,IAAI,QAAc,CAAC,YAAY;AAAA,QACnC,KAAK,eAAe,KAAK,OAAO;AAAA,OACjC;AAAA,IACH;AAAA;AAEJ;AAEO,SAAS,YAAY,CAAC,QAAiB,OAAwB;AAAA,EACpE,OAAO,IAAI,oBAAoB,KAAK;AAAA;AAG/B,SAAS,YAAY,CAAC,QAAiB,OAAwB;AAAA,EACpE,OAAO,IAAI,oBAAoB,KAAK;AAAA;AAG/B,SAAS,UAAU,GAAe;AAAA,EACvC,OAAO,IAAI;AAAA;AAAA;AAGN,MAAM,sBAAiD;AAAA,EACpD;AAAA,EACA,SAAiB;AAAA,EACjB,SAAkB;AAAA,EAClB,iBAAoC,CAAC;AAAA,EAC7B,QAAiB;AAAA,EAEjC,WAAW,CAAC,QAAgB;AAAA,IAC1B,KAAK,SAAS;AAAA;AAAA,OAGV,MAAK,CAAC,OAAkC;AAAA,IAC5C,IAAI,KAAK,QAAQ;AAAA,MACf,MAAM,IAAI,MAAM,yBAAyB;AAAA,IAC3C;AAAA,IACA,SAAS,IAAI,EAAG,IAAI,MAAM,UAAU,KAAK,SAAS,KAAK,OAAO,QAAQ,KAAK;AAAA,MACzE,KAAK,OAAO,KAAK,YAAY,MAAM;AAAA,IACrC;AAAA;AAAA,OAGI,UAAS,CAAC,KAA4B;AAAA,IAC1C,MAAM,QAAQ,IAAI,YAAY,EAAE,OAAO,GAAG;AAAA,IAC1C,MAAM,KAAK,MAAM,KAAK;AAAA;AAAA,EAGxB,KAAK,GAAS;AAAA,IACZ,KAAK,SAAS;AAAA,IACd,WAAW,WAAW,KAAK,gBAAgB;AAAA,MACzC,QAAQ;AAAA,IACV;AAAA,IACA,KAAK,iBAAiB,CAAC;AAAA;AAAA,OAGnB,QAAO,GAAoB;AAAA,IAC/B,OAAO,CAAC,KAAK,QAAQ;AAAA,MACnB,MAAM,IAAI,QAAc,CAAC,YAAY;AAAA,QACnC,KAAK,eAAe,KAAK,OAAO;AAAA,OACjC;AAAA,IACH;AAAA,IACA,OAAO,KAAK,OAAO,SAAS,GAAG,KAAK,MAAM;AAAA;AAAA,SAGrC,iBAAiB,GAA8B;AAAA,IACpD,MAAM,KAAK,OAAO,SAAS,GAAG,KAAK,MAAM;AAAA;AAE7C;AAEO,SAAS,2BAA2B,CAAC,QAAiC;AAAA,EAC3E,OAAO,IAAI,sBAAsB,MAAM;AAAA;",
-  "debugId": "FD52BAF67333F9F064756E2164756E21",
+  "mappings": "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",
+  "debugId": "FD76C10E4B60500564756E2164756E21",
   "names": []
 }

package/dist/mjs/src/shell-dsl.mjs

@@ -15,6 +15,8 @@ class ShellDSL {
   commands;
   shouldThrow = true;
   isTTY;
+  terminal;
+  externalCommand;
   constructor(config) {
     this.fs = config.fs;
     this.initialCwd = config.cwd;
@@ -22,7 +24,9 @@ class ShellDSL {
     this.currentCwd = config.cwd;
     this.currentEnv = { ...config.env };
     this.commands = config.commands;
-    this.isTTY = config.isTTY ?? false;
+    this.terminal = config.terminal ?? { isTTY: config.isTTY ?? false };
+    this.isTTY = this.terminal.isTTY;
+    this.externalCommand = config.externalCommand;
   }
   tag(strings, ...values) {
     let source = strings[0] ?? "";
@@ -73,7 +77,8 @@ class ShellDSL {
           env,
           commands: shell.commands,
           redirectObjects: options?.redirectObjects,
-          isTTY: shell.isTTY
+          terminal: shell.terminal,
+          externalCommand: shell.externalCommand
         });
         const tokens = shell.lex(source);
         const ast = shell.parse(tokens);
@@ -120,7 +125,8 @@ class ShellDSL {
       cwd: this.currentCwd,
       env: this.currentEnv,
       commands: this.commands,
-      isTTY: this.isTTY
+      terminal: this.terminal,
+      externalCommand: this.externalCommand
     });
     return interpreter.execute(program.ast);
   }
@@ -139,7 +145,9 @@ function createShellDSL(config) {
     currentEnv: shell.currentEnv,
     commands: shell.commands,
     shouldThrow: shell.shouldThrow,
-    isTTY: shell.isTTY
+    isTTY: shell.isTTY,
+    terminal: shell.terminal,
+    externalCommand: shell.externalCommand
   });
   tag.cwd = shell.cwd.bind(shell);
   tag.env = shell.env.bind(shell);
@@ -159,4 +167,4 @@ export {
   ShellDSL
 };
 
-//# debugId=8F671D51EF55457364756E2164756E21
+//# debugId=ECD55B1B72D0700F64756E2164756E21

package/dist/mjs/src/shell-dsl.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/shell-dsl.ts"],
   "sourcesContent": [
-    "import type { ShellConfig, Command, VirtualFS, ExecResult, RedirectObjectMap } from \"./types.mjs\";\nimport { isRawValue, isRedirectObject } from \"./types.mjs\";\nimport type { Token } from \"./lexer/tokens.mjs\";\nimport type { ASTNode } from \"./parser/ast.mjs\";\nimport { Lexer } from \"./lexer/lexer.mjs\";\nimport { Parser } from \"./parser/parser.mjs\";\nimport { Interpreter } from \"./interpreter/interpreter.mjs\";\nimport { ShellPromise } from \"./shell-promise.mjs\";\nimport { escape, escapeForInterpolation } from \"./utils/escape.mjs\";\n\nexport interface Program {\n  ast: ASTNode;\n  source: string;\n}\n\nexport class ShellDSL {\n  private fs: VirtualFS;\n  private initialCwd: string;\n  private initialEnv: Record<string, string>;\n  private currentCwd: string;\n  private currentEnv: Record<string, string>;\n  private commands: Record<string, Command>;\n  private shouldThrow: boolean = true;\n  private isTTY: boolean;\n\n  constructor(config: ShellConfig) {\n    this.fs = config.fs;\n    this.initialCwd = config.cwd;\n    this.initialEnv = { ...config.env };\n    this.currentCwd = config.cwd;\n    this.currentEnv = { ...config.env };\n    this.commands = config.commands;\n    this.isTTY = config.isTTY ?? false;\n  }\n\n  // Template tag function\n  tag(strings: TemplateStringsArray, ...values: unknown[]): ShellPromise {\n    // Build the command string with escaped interpolations\n    let source = strings[0] ?? \"\";\n    const redirectObjects: RedirectObjectMap = {};\n    let objIndex = 0;\n\n    for (let i = 0; i < values.length; i++) {\n      const value = values[i];\n      const precedingString = strings[i] ?? \"\";\n\n      if (isRawValue(value)) {\n        source += value.raw;\n      } else if (this.isRedirectTarget(precedingString, value)) {\n        // Value appears after a redirect operator - store as redirect object\n        const marker = `__REDIR_OBJ_${objIndex++}__`;\n        redirectObjects[marker] = value as Buffer | Blob | Response | string;\n        source += marker;\n      } else {\n        source += escapeForInterpolation(value);\n      }\n      source += strings[i + 1] ?? \"\";\n    }\n\n    return this.createPromise(source, { redirectObjects });\n  }\n\n  private isRedirectTarget(precedingString: string, value: unknown): boolean {\n    // Check if value is a redirect object type AND appears after redirect operator\n    if (!isRedirectObject(value) || isRawValue(value)) {\n      return false;\n    }\n    // Check if preceding string ends with redirect operator\n    const trimmed = precedingString.trimEnd();\n    const afterRedirectOp = /(<|>|>>|2>|2>>|&>|&>>)\\s*$/.test(trimmed);\n\n    if (!afterRedirectOp) {\n      return false;\n    }\n\n    // Buffer, Blob, Response are always treated as redirect objects\n    if (Buffer.isBuffer(value) || value instanceof Blob || value instanceof Response) {\n      return true;\n    }\n\n    // For strings after input redirect (<), treat as content per spec\n    // For strings after output redirect (>), they must be Buffers\n    if (typeof value === \"string\") {\n      // Only input redirection supports string content\n      return /<\\s*$/.test(trimmed);\n    }\n\n    return false;\n  }\n\n  private createPromise(source: string, options?: { cwd?: string; env?: Record<string, string>; shouldThrow?: boolean; redirectObjects?: RedirectObjectMap }): ShellPromise {\n    const shell = this;\n\n    return new ShellPromise({\n      execute: async (overrides) => {\n        const cwd = overrides?.cwd ?? options?.cwd ?? shell.currentCwd;\n        const env = { ...shell.currentEnv, ...options?.env, ...overrides?.env };\n\n        const interpreter = new Interpreter({\n          fs: shell.fs,\n          cwd,\n          env,\n          commands: shell.commands,\n          redirectObjects: options?.redirectObjects,\n          isTTY: shell.isTTY,\n        });\n\n        const tokens = shell.lex(source);\n        const ast = shell.parse(tokens);\n        return interpreter.execute(ast);\n      },\n      cwdOverride: options?.cwd,\n      envOverride: options?.env,\n      shouldThrow: options?.shouldThrow ?? this.shouldThrow,\n    });\n  }\n\n  // Global defaults\n  cwd(path: string): void {\n    this.currentCwd = path;\n  }\n\n  env(vars: Record<string, string>): void {\n    Object.assign(this.currentEnv, vars);\n  }\n\n  throws(enable: boolean): void {\n    this.shouldThrow = enable;\n  }\n\n  resetCwd(): void {\n    this.currentCwd = this.initialCwd;\n  }\n\n  resetEnv(): void {\n    this.currentEnv = { ...this.initialEnv };\n  }\n\n  // Utility\n  escape(str: string): string {\n    return escape(str);\n  }\n\n  // Low-level API\n  lex(source: string): Token[] {\n    return new Lexer(source, { preserveNewlines: true }).tokenize();\n  }\n\n  parse(tokens: Token[]): ASTNode {\n    return new Parser(tokens).parse();\n  }\n\n  compile(ast: ASTNode): Program {\n    // For now, the \"program\" is just the AST with source reconstruction\n    return {\n      ast,\n      source: \"\", // Could reconstruct source from AST if needed\n    };\n  }\n\n  async run(program: Program): Promise<ExecResult> {\n    const interpreter = new Interpreter({\n      fs: this.fs,\n      cwd: this.currentCwd,\n      env: this.currentEnv,\n      commands: this.commands,\n      isTTY: this.isTTY,\n    });\n\n    return interpreter.execute(program.ast);\n  }\n}\n\n// Factory function that returns a callable template tag\nexport function createShellDSL(config: ShellConfig): ShellDSL & ((strings: TemplateStringsArray, ...values: unknown[]) => ShellPromise) {\n  const shell = new ShellDSL(config);\n\n  // Create a function that acts as both tag and shell instance\n  const tag = (strings: TemplateStringsArray, ...values: unknown[]) => {\n    return shell.tag(strings, ...values);\n  };\n\n  // Copy all properties and methods from shell to tag function\n  Object.setPrototypeOf(tag, ShellDSL.prototype);\n  Object.assign(tag, {\n    fs: (shell as any).fs,\n    initialCwd: (shell as any).initialCwd,\n    initialEnv: (shell as any).initialEnv,\n    currentCwd: (shell as any).currentCwd,\n    currentEnv: (shell as any).currentEnv,\n    commands: (shell as any).commands,\n    shouldThrow: (shell as any).shouldThrow,\n    isTTY: (shell as any).isTTY,\n  });\n\n  // Bind methods\n  (tag as any).cwd = shell.cwd.bind(shell);\n  (tag as any).env = shell.env.bind(shell);\n  (tag as any).throws = shell.throws.bind(shell);\n  (tag as any).resetCwd = shell.resetCwd.bind(shell);\n  (tag as any).resetEnv = shell.resetEnv.bind(shell);\n  (tag as any).escape = shell.escape.bind(shell);\n  (tag as any).lex = shell.lex.bind(shell);\n  (tag as any).parse = shell.parse.bind(shell);\n  (tag as any).compile = shell.compile.bind(shell);\n  (tag as any).run = shell.run.bind(shell);\n  (tag as any).tag = shell.tag.bind(shell);\n\n  return tag as ShellDSL & ((strings: TemplateStringsArray, ...values: unknown[]) => ShellPromise);\n}\n"
+    "import type {\n  ShellConfig,\n  Command,\n  VirtualFS,\n  ExecResult,\n  RedirectObjectMap,\n  TerminalInfo,\n  ShellCommandFallback,\n} from \"./types.mjs\";\nimport { isRawValue, isRedirectObject } from \"./types.mjs\";\nimport type { Token } from \"./lexer/tokens.mjs\";\nimport type { ASTNode } from \"./parser/ast.mjs\";\nimport { Lexer } from \"./lexer/lexer.mjs\";\nimport { Parser } from \"./parser/parser.mjs\";\nimport { Interpreter } from \"./interpreter/interpreter.mjs\";\nimport { ShellPromise } from \"./shell-promise.mjs\";\nimport { escape, escapeForInterpolation } from \"./utils/escape.mjs\";\n\nexport interface Program {\n  ast: ASTNode;\n  source: string;\n}\n\nexport class ShellDSL {\n  private fs: VirtualFS;\n  private initialCwd: string;\n  private initialEnv: Record<string, string>;\n  private currentCwd: string;\n  private currentEnv: Record<string, string>;\n  private commands: Record<string, Command>;\n  private shouldThrow: boolean = true;\n  private isTTY: boolean;\n  private terminal: TerminalInfo;\n  private externalCommand?: ShellCommandFallback;\n\n  constructor(config: ShellConfig) {\n    this.fs = config.fs;\n    this.initialCwd = config.cwd;\n    this.initialEnv = { ...config.env };\n    this.currentCwd = config.cwd;\n    this.currentEnv = { ...config.env };\n    this.commands = config.commands;\n    this.terminal = config.terminal ?? { isTTY: config.isTTY ?? false };\n    this.isTTY = this.terminal.isTTY;\n    this.externalCommand = config.externalCommand;\n  }\n\n  // Template tag function\n  tag(strings: TemplateStringsArray, ...values: unknown[]): ShellPromise {\n    // Build the command string with escaped interpolations\n    let source = strings[0] ?? \"\";\n    const redirectObjects: RedirectObjectMap = {};\n    let objIndex = 0;\n\n    for (let i = 0; i < values.length; i++) {\n      const value = values[i];\n      const precedingString = strings[i] ?? \"\";\n\n      if (isRawValue(value)) {\n        source += value.raw;\n      } else if (this.isRedirectTarget(precedingString, value)) {\n        // Value appears after a redirect operator - store as redirect object\n        const marker = `__REDIR_OBJ_${objIndex++}__`;\n        redirectObjects[marker] = value as Buffer | Blob | Response | string;\n        source += marker;\n      } else {\n        source += escapeForInterpolation(value);\n      }\n      source += strings[i + 1] ?? \"\";\n    }\n\n    return this.createPromise(source, { redirectObjects });\n  }\n\n  private isRedirectTarget(precedingString: string, value: unknown): boolean {\n    // Check if value is a redirect object type AND appears after redirect operator\n    if (!isRedirectObject(value) || isRawValue(value)) {\n      return false;\n    }\n    // Check if preceding string ends with redirect operator\n    const trimmed = precedingString.trimEnd();\n    const afterRedirectOp = /(<|>|>>|2>|2>>|&>|&>>)\\s*$/.test(trimmed);\n\n    if (!afterRedirectOp) {\n      return false;\n    }\n\n    // Buffer, Blob, Response are always treated as redirect objects\n    if (Buffer.isBuffer(value) || value instanceof Blob || value instanceof Response) {\n      return true;\n    }\n\n    // For strings after input redirect (<), treat as content per spec\n    // For strings after output redirect (>), they must be Buffers\n    if (typeof value === \"string\") {\n      // Only input redirection supports string content\n      return /<\\s*$/.test(trimmed);\n    }\n\n    return false;\n  }\n\n  private createPromise(source: string, options?: { cwd?: string; env?: Record<string, string>; shouldThrow?: boolean; redirectObjects?: RedirectObjectMap }): ShellPromise {\n    const shell = this;\n\n    return new ShellPromise({\n      execute: async (overrides) => {\n        const cwd = overrides?.cwd ?? options?.cwd ?? shell.currentCwd;\n        const env = { ...shell.currentEnv, ...options?.env, ...overrides?.env };\n\n        const interpreter = new Interpreter({\n          fs: shell.fs,\n          cwd,\n          env,\n          commands: shell.commands,\n          redirectObjects: options?.redirectObjects,\n          terminal: shell.terminal,\n          externalCommand: shell.externalCommand,\n        });\n\n        const tokens = shell.lex(source);\n        const ast = shell.parse(tokens);\n        return interpreter.execute(ast);\n      },\n      cwdOverride: options?.cwd,\n      envOverride: options?.env,\n      shouldThrow: options?.shouldThrow ?? this.shouldThrow,\n    });\n  }\n\n  // Global defaults\n  cwd(path: string): void {\n    this.currentCwd = path;\n  }\n\n  env(vars: Record<string, string>): void {\n    Object.assign(this.currentEnv, vars);\n  }\n\n  throws(enable: boolean): void {\n    this.shouldThrow = enable;\n  }\n\n  resetCwd(): void {\n    this.currentCwd = this.initialCwd;\n  }\n\n  resetEnv(): void {\n    this.currentEnv = { ...this.initialEnv };\n  }\n\n  // Utility\n  escape(str: string): string {\n    return escape(str);\n  }\n\n  // Low-level API\n  lex(source: string): Token[] {\n    return new Lexer(source, { preserveNewlines: true }).tokenize();\n  }\n\n  parse(tokens: Token[]): ASTNode {\n    return new Parser(tokens).parse();\n  }\n\n  compile(ast: ASTNode): Program {\n    // For now, the \"program\" is just the AST with source reconstruction\n    return {\n      ast,\n      source: \"\", // Could reconstruct source from AST if needed\n    };\n  }\n\n  async run(program: Program): Promise<ExecResult> {\n    const interpreter = new Interpreter({\n      fs: this.fs,\n      cwd: this.currentCwd,\n      env: this.currentEnv,\n      commands: this.commands,\n      terminal: this.terminal,\n      externalCommand: this.externalCommand,\n    });\n\n    return interpreter.execute(program.ast);\n  }\n}\n\n// Factory function that returns a callable template tag\nexport function createShellDSL(config: ShellConfig): ShellDSL & ((strings: TemplateStringsArray, ...values: unknown[]) => ShellPromise) {\n  const shell = new ShellDSL(config);\n\n  // Create a function that acts as both tag and shell instance\n  const tag = (strings: TemplateStringsArray, ...values: unknown[]) => {\n    return shell.tag(strings, ...values);\n  };\n\n  // Copy all properties and methods from shell to tag function\n  Object.setPrototypeOf(tag, ShellDSL.prototype);\n  Object.assign(tag, {\n    fs: (shell as any).fs,\n    initialCwd: (shell as any).initialCwd,\n    initialEnv: (shell as any).initialEnv,\n    currentCwd: (shell as any).currentCwd,\n    currentEnv: (shell as any).currentEnv,\n    commands: (shell as any).commands,\n    shouldThrow: (shell as any).shouldThrow,\n    isTTY: (shell as any).isTTY,\n    terminal: (shell as any).terminal,\n    externalCommand: (shell as any).externalCommand,\n  });\n\n  // Bind methods\n  (tag as any).cwd = shell.cwd.bind(shell);\n  (tag as any).env = shell.env.bind(shell);\n  (tag as any).throws = shell.throws.bind(shell);\n  (tag as any).resetCwd = shell.resetCwd.bind(shell);\n  (tag as any).resetEnv = shell.resetEnv.bind(shell);\n  (tag as any).escape = shell.escape.bind(shell);\n  (tag as any).lex = shell.lex.bind(shell);\n  (tag as any).parse = shell.parse.bind(shell);\n  (tag as any).compile = shell.compile.bind(shell);\n  (tag as any).run = shell.run.bind(shell);\n  (tag as any).tag = shell.tag.bind(shell);\n\n  return tag as ShellDSL & ((strings: TemplateStringsArray, ...values: unknown[]) => ShellPromise);\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "8F671D51EF55457364756E2164756E21",
+  "mappings": "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",
+  "debugId": "ECD55B1B72D0700F64756E2164756E21",
   "names": []
 }

package/dist/mjs/src/shell-session.mjs

@@ -0,0 +1,182 @@
+// src/shell-session.ts
+import { Lexer } from "./lexer/lexer.mjs";
+import { Parser } from "./parser/parser.mjs";
+import { Interpreter } from "./interpreter/interpreter.mjs";
+import { createStderr, createStdout } from "./io/stdout.mjs";
+import { AsyncQueue } from "./io/async-queue.mjs";
+
+class ShellSession {
+  fs;
+  commands;
+  completions;
+  terminal;
+  interpreter;
+  constructor(options) {
+    this.fs = options.fs;
+    this.commands = options.commands;
+    this.completions = options.completions ?? {};
+    this.terminal = options.terminal ?? { isTTY: options.isTTY ?? false };
+    this.interpreter = new Interpreter({
+      fs: options.fs,
+      cwd: options.cwd,
+      env: options.env,
+      commands: options.commands,
+      terminal: this.terminal,
+      externalCommand: options.externalCommand
+    });
+  }
+  run(source, options = {}) {
+    try {
+      const tokens = new Lexer(source, { preserveNewlines: true }).tokenize();
+      if (tokens.every((token) => token.type === "newline" || token.type === "eof")) {
+        return this.createImmediateExecution(0, "", "");
+      }
+      const ast = new Parser(tokens).parse();
+      return this.interpreter.executeStreaming(ast, options);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return this.createImmediateExecution(2, "", `sh: ${message}
+`);
+    }
+  }
+  runProgram(program, options = {}) {
+    return this.interpreter.executeStreaming(program.ast, options);
+  }
+  getCwd() {
+    return this.interpreter.getCwd();
+  }
+  getEnv() {
+    return this.interpreter.getEnv();
+  }
+  getLastExitCode() {
+    return this.interpreter.getLastExitCode();
+  }
+  async complete(source, cursor = source.length) {
+    const boundedCursor = Math.max(0, Math.min(cursor, source.length));
+    const prefix = source.slice(0, boundedCursor);
+    const { word, start } = getCurrentWord(prefix);
+    if (isCommandPosition(prefix, start) && !looksLikePath(word)) {
+      return {
+        replacement: word,
+        matches: Object.keys(this.commands).filter((name) => name.startsWith(word)).sort().map((name) => `${name} `)
+      };
+    }
+    const commandLine = getCurrentCommandLine(prefix, start);
+    const [command = "", ...args] = splitCompletionWords(commandLine);
+    const completer = command === "" ? undefined : this.completions[command];
+    if (completer) {
+      return completer({
+        source,
+        cursor: boundedCursor,
+        command,
+        args,
+        word,
+        wordStart: start,
+        wordEnd: boundedCursor,
+        cwd: this.getCwd(),
+        env: this.getEnv(),
+        fs: this.fs,
+        terminal: this.terminal
+      });
+    }
+    return this.completePath(word);
+  }
+  async dispose() {}
+  async completePath(word) {
+    const slash = word.lastIndexOf("/");
+    const dirPart = slash === -1 ? "" : word.slice(0, slash + 1);
+    const namePrefix = slash === -1 ? word : word.slice(slash + 1);
+    const basePath = dirPart === "" ? this.getCwd() : dirPart.startsWith("/") ? dirPart : this.fs.resolve(this.getCwd(), dirPart);
+    let entries;
+    try {
+      entries = await this.fs.readdir(basePath);
+    } catch {
+      return { replacement: word, matches: [] };
+    }
+    const matches = await Promise.all(entries.filter((entry) => entry.startsWith(namePrefix)).sort().map(async (entry) => {
+      const candidate = `${dirPart}${escapeCompletionSegment(entry)}`;
+      const path = this.fs.resolve(basePath, entry);
+      try {
+        const stat = await this.fs.stat(path);
+        return stat.isDirectory() ? `${candidate}/` : candidate;
+      } catch {
+        return candidate;
+      }
+    }));
+    if (matches.length === 1 && !matches[0].endsWith("/")) {
+      matches[0] = `${matches[0]} `;
+    }
+    return { replacement: word, matches };
+  }
+  createImmediateExecution(exitCode, stdoutText, stderrText) {
+    const stdout = createStdout();
+    const stderr = createStderr();
+    const output = new AsyncQueue;
+    const exit = (async () => {
+      if (stdoutText.length > 0) {
+        const chunk = new TextEncoder().encode(stdoutText);
+        output.push({ fd: 1, chunk });
+        await stdout.write(chunk);
+      }
+      if (stderrText.length > 0) {
+        const chunk = new TextEncoder().encode(stderrText);
+        output.push({ fd: 2, chunk });
+        await stderr.write(chunk);
+      }
+      stdout.close();
+      stderr.close();
+      output.close();
+      return {
+        stdout: await stdout.collect(),
+        stderr: await stderr.collect(),
+        exitCode
+      };
+    })();
+    return {
+      stdout: stdout.getReadableStream(),
+      stderr: stderr.getReadableStream(),
+      output,
+      exit,
+      kill: () => {}
+    };
+  }
+}
+function createShellSession(config) {
+  return new ShellSession(config);
+}
+function getCurrentWord(prefix) {
+  let start = prefix.length;
+  while (start > 0 && !/\s/.test(prefix[start - 1])) {
+    start--;
+  }
+  return { word: prefix.slice(start), start };
+}
+function isCommandPosition(prefix, wordStart) {
+  const beforeWord = prefix.slice(0, wordStart);
+  const segmentStart = Math.max(beforeWord.lastIndexOf(";"), beforeWord.lastIndexOf("|"), beforeWord.lastIndexOf("&"));
+  const segment = beforeWord.slice(segmentStart + 1).trim();
+  if (segment === "") {
+    return true;
+  }
+  return segment.split(/\s+/).every((part) => /^[A-Za-z_][A-Za-z0-9_]*=/.test(part));
+}
+function getCurrentCommandLine(prefix, wordStart) {
+  const beforeWord = prefix.slice(0, wordStart);
+  const segmentStart = Math.max(beforeWord.lastIndexOf(";"), beforeWord.lastIndexOf("|"), beforeWord.lastIndexOf("&"));
+  return prefix.slice(segmentStart + 1).trimStart();
+}
+function splitCompletionWords(source) {
+  return source.trim().split(/\s+/).filter(Boolean);
+}
+function looksLikePath(word) {
+  return word.startsWith("/") || word.startsWith(".") || word.includes("/");
+}
+function escapeCompletionSegment(segment) {
+  return segment.replace(/([\s\\'"$`!#&;|<>()[\]{}*?])/g, "\\$1");
+}
+export {
+  createShellSession,
+  ShellSession
+};
+
+//# debugId=EDCA97BB05872ACD64756E2164756E21

package/dist/mjs/src/shell-session.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../src/shell-session.ts"],
+  "sourcesContent": [
+    "import type {\n  Command,\n  CommandCompleter,\n  CompletionResult,\n  ExecResult,\n  ShellCommandFallback,\n  ShellConfig,\n  ShellExecution,\n  ShellExecutionOptions,\n  TerminalInfo,\n  VirtualFS,\n} from \"./types.mjs\";\nimport type { Program } from \"./shell-dsl.mjs\";\nimport { Lexer } from \"./lexer/lexer.mjs\";\nimport { Parser } from \"./parser/parser.mjs\";\nimport { Interpreter } from \"./interpreter/interpreter.mjs\";\nimport { createStderr, createStdout } from \"./io/stdout.mjs\";\nimport { AsyncQueue } from \"./io/async-queue.mjs\";\nimport type { ShellOutputEvent } from \"./types.mjs\";\n\nexport interface ShellSessionOptions {\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  commands: Record<string, Command>;\n  completions?: Record<string, CommandCompleter>;\n  isTTY?: boolean;\n  terminal?: TerminalInfo;\n  externalCommand?: ShellCommandFallback;\n}\n\nexport class ShellSession {\n  private fs: VirtualFS;\n  private commands: Record<string, Command>;\n  private completions: Record<string, CommandCompleter>;\n  private terminal: TerminalInfo;\n  private interpreter: Interpreter;\n\n  constructor(options: ShellSessionOptions) {\n    this.fs = options.fs;\n    this.commands = options.commands;\n    this.completions = options.completions ?? {};\n    this.terminal = options.terminal ?? { isTTY: options.isTTY ?? false };\n    this.interpreter = new Interpreter({\n      fs: options.fs,\n      cwd: options.cwd,\n      env: options.env,\n      commands: options.commands,\n      terminal: this.terminal,\n      externalCommand: options.externalCommand,\n    });\n  }\n\n  run(source: string, options: ShellExecutionOptions = {}): ShellExecution {\n    try {\n      const tokens = new Lexer(source, { preserveNewlines: true }).tokenize();\n      if (tokens.every((token) => token.type === \"newline\" || token.type === \"eof\")) {\n        return this.createImmediateExecution(0, \"\", \"\");\n      }\n      const ast = new Parser(tokens).parse();\n      return this.interpreter.executeStreaming(ast, options);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      return this.createImmediateExecution(2, \"\", `sh: ${message}\\n`);\n    }\n  }\n\n  runProgram(program: Program, options: ShellExecutionOptions = {}): ShellExecution {\n    return this.interpreter.executeStreaming(program.ast, options);\n  }\n\n  getCwd(): string {\n    return this.interpreter.getCwd();\n  }\n\n  getEnv(): Record<string, string> {\n    return this.interpreter.getEnv();\n  }\n\n  getLastExitCode(): number {\n    return this.interpreter.getLastExitCode();\n  }\n\n  async complete(source: string, cursor: number = source.length): Promise<CompletionResult> {\n    const boundedCursor = Math.max(0, Math.min(cursor, source.length));\n    const prefix = source.slice(0, boundedCursor);\n    const { word, start } = getCurrentWord(prefix);\n\n    if (isCommandPosition(prefix, start) && !looksLikePath(word)) {\n      return {\n        replacement: word,\n        matches: Object.keys(this.commands)\n          .filter((name) => name.startsWith(word))\n          .sort()\n          .map((name) => `${name} `),\n      };\n    }\n\n    const commandLine = getCurrentCommandLine(prefix, start);\n    const [command = \"\", ...args] = splitCompletionWords(commandLine);\n    const completer = command === \"\" ? undefined : this.completions[command];\n    if (completer) {\n      return completer({\n        source,\n        cursor: boundedCursor,\n        command,\n        args,\n        word,\n        wordStart: start,\n        wordEnd: boundedCursor,\n        cwd: this.getCwd(),\n        env: this.getEnv(),\n        fs: this.fs,\n        terminal: this.terminal,\n      });\n    }\n\n    return this.completePath(word);\n  }\n\n  async dispose(): Promise<void> {\n    // Reserved for future resources owned by a session.\n  }\n\n  private async completePath(word: string): Promise<CompletionResult> {\n    const slash = word.lastIndexOf(\"/\");\n    const dirPart = slash === -1 ? \"\" : word.slice(0, slash + 1);\n    const namePrefix = slash === -1 ? word : word.slice(slash + 1);\n    const basePath = dirPart === \"\"\n      ? this.getCwd()\n      : dirPart.startsWith(\"/\")\n        ? dirPart\n        : this.fs.resolve(this.getCwd(), dirPart);\n\n    let entries: string[];\n    try {\n      entries = await this.fs.readdir(basePath);\n    } catch {\n      return { replacement: word, matches: [] };\n    }\n\n    const matches = await Promise.all(\n      entries\n        .filter((entry) => entry.startsWith(namePrefix))\n        .sort()\n        .map(async (entry) => {\n          const candidate = `${dirPart}${escapeCompletionSegment(entry)}`;\n          const path = this.fs.resolve(basePath, entry);\n          try {\n            const stat = await this.fs.stat(path);\n            return stat.isDirectory() ? `${candidate}/` : candidate;\n          } catch {\n            return candidate;\n          }\n        })\n    );\n\n    if (matches.length === 1 && !matches[0]!.endsWith(\"/\")) {\n      matches[0] = `${matches[0]} `;\n    }\n\n    return { replacement: word, matches };\n  }\n\n  private createImmediateExecution(exitCode: number, stdoutText: string, stderrText: string): ShellExecution {\n    const stdout = createStdout();\n    const stderr = createStderr();\n    const output = new AsyncQueue<ShellOutputEvent>();\n\n    const exit = (async (): Promise<ExecResult> => {\n      if (stdoutText.length > 0) {\n        const chunk = new TextEncoder().encode(stdoutText);\n        output.push({ fd: 1, chunk });\n        await stdout.write(chunk);\n      }\n      if (stderrText.length > 0) {\n        const chunk = new TextEncoder().encode(stderrText);\n        output.push({ fd: 2, chunk });\n        await stderr.write(chunk);\n      }\n      stdout.close();\n      stderr.close();\n      output.close();\n      return {\n        stdout: await stdout.collect(),\n        stderr: await stderr.collect(),\n        exitCode,\n      };\n    })();\n\n    return {\n      stdout: stdout.getReadableStream(),\n      stderr: stderr.getReadableStream(),\n      output,\n      exit,\n      kill: () => {},\n    };\n  }\n}\n\nexport function createShellSession(config: ShellConfig): ShellSession {\n  return new ShellSession(config);\n}\n\nfunction getCurrentWord(prefix: string): { word: string; start: number } {\n  let start = prefix.length;\n  while (start > 0 && !/\\s/.test(prefix[start - 1]!)) {\n    start--;\n  }\n  return { word: prefix.slice(start), start };\n}\n\nfunction isCommandPosition(prefix: string, wordStart: number): boolean {\n  const beforeWord = prefix.slice(0, wordStart);\n  const segmentStart = Math.max(\n    beforeWord.lastIndexOf(\";\"),\n    beforeWord.lastIndexOf(\"|\"),\n    beforeWord.lastIndexOf(\"&\")\n  );\n  const segment = beforeWord.slice(segmentStart + 1).trim();\n  if (segment === \"\") {\n    return true;\n  }\n  return segment.split(/\\s+/).every((part) => /^[A-Za-z_][A-Za-z0-9_]*=/.test(part));\n}\n\nfunction getCurrentCommandLine(prefix: string, wordStart: number): string {\n  const beforeWord = prefix.slice(0, wordStart);\n  const segmentStart = Math.max(\n    beforeWord.lastIndexOf(\";\"),\n    beforeWord.lastIndexOf(\"|\"),\n    beforeWord.lastIndexOf(\"&\")\n  );\n  return prefix.slice(segmentStart + 1).trimStart();\n}\n\nfunction splitCompletionWords(source: string): string[] {\n  return source.trim().split(/\\s+/).filter(Boolean);\n}\n\nfunction looksLikePath(word: string): boolean {\n  return word.startsWith(\"/\") || word.startsWith(\".\") || word.includes(\"/\");\n}\n\nfunction escapeCompletionSegment(segment: string): string {\n  return segment.replace(/([\\s\\\\'\"$`!#&;|<>()[\\]{}*?])/g, \"\\\\$1\");\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "EDCA97BB05872ACD64756E2164756E21",
+  "names": []
+}

package/dist/mjs/src/types.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/types.ts"],
   "sourcesContent": [
-    "// Virtual Filesystem Interface\nexport interface VirtualFSWritable {\n  write(chunk: Uint8Array): Promise<void>;\n  close(): Promise<void>;\n  abort?(reason?: unknown): Promise<void>;\n}\n\nexport interface VirtualFS {\n  readFile(path: string): Promise<Buffer>;\n  readFile(path: string, encoding: BufferEncoding): Promise<string>;\n  readStream(path: string): AsyncIterable<Uint8Array>;\n  readdir(path: string): Promise<string[]>;\n  stat(path: string): Promise<FileStat>;\n  exists(path: string): Promise<boolean>;\n\n  writeFile(path: string, data: Buffer | string): Promise<void>;\n  appendFile(path: string, data: Buffer | string): Promise<void>;\n  writeStream(path: string, opts?: { append?: boolean }): Promise<VirtualFSWritable>;\n  mkdir(path: string, opts?: { recursive?: boolean }): Promise<void>;\n\n  rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n\n  resolve(...paths: string[]): string;\n  dirname(path: string): string;\n  basename(path: string): string;\n  glob(pattern: string, opts?: { cwd?: string }): Promise<string[]>;\n}\n\nexport interface FileStat {\n  isFile(): boolean;\n  isDirectory(): boolean;\n  size: number;\n  mtime: Date;\n  mtimeMs: number;\n}\n\n// Command Interfaces\nexport type Command = (ctx: CommandContext) => Promise<number>;\n\nexport interface ShellRunOptions {\n  argv0?: string;\n  args?: string[];\n}\n\nexport interface ShellCommandApi {\n  eval(source: string): Promise<number>;\n  source(path: string, args?: string[]): Promise<number>;\n  runScript(path: string, args?: string[]): Promise<number>;\n  runShell(source: string, options?: ShellRunOptions): Promise<number>;\n  getLastExitCode(): number;\n  exit(exitCode?: number): never;\n}\n\nexport interface CommandContext {\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 interface Stdin {\n  stream(): AsyncIterable<Uint8Array>;\n  buffer(): Promise<Buffer>;\n  text(): Promise<string>;\n  lines(): AsyncIterable<string>;\n}\n\nexport interface Stdout {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface Stderr {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface OutputCollector extends Stdout {\n  close(): void;\n  collect(): Promise<Buffer>;\n  getReadableStream(): AsyncIterable<Uint8Array>;\n}\n\n// Execution Result\nexport interface ExecResult {\n  stdout: Buffer;\n  stderr: Buffer;\n  exitCode: number;\n}\n\n// Shell Configuration\nexport interface ShellConfig {\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  commands: Record<string, Command>;\n  isTTY?: boolean;\n}\n\n// Raw escape hatch type\nexport interface RawValue {\n  raw: string;\n}\n\nexport function isRawValue(value: unknown): value is RawValue {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"raw\" in value &&\n    typeof (value as RawValue).raw === \"string\"\n  );\n}\n\n// JS Object Redirection types\nexport type RedirectObject = Buffer | Blob | Response | string;\n\nexport interface RedirectObjectMap {\n  [marker: string]: RedirectObject;\n}\n\nexport function isRedirectObject(value: unknown): value is RedirectObject {\n  return (\n    Buffer.isBuffer(value) ||\n    value instanceof Blob ||\n    value instanceof Response ||\n    typeof value === \"string\"\n  );\n}\n"
+    "// Virtual Filesystem Interface\nexport interface VirtualFSWritable {\n  write(chunk: Uint8Array): Promise<void>;\n  close(): Promise<void>;\n  abort?(reason?: unknown): Promise<void>;\n}\n\nexport interface VirtualFS {\n  readFile(path: string): Promise<Buffer>;\n  readFile(path: string, encoding: BufferEncoding): Promise<string>;\n  readStream(path: string): AsyncIterable<Uint8Array>;\n  readdir(path: string): Promise<string[]>;\n  stat(path: string): Promise<FileStat>;\n  exists(path: string): Promise<boolean>;\n\n  writeFile(path: string, data: Buffer | string): Promise<void>;\n  appendFile(path: string, data: Buffer | string): Promise<void>;\n  writeStream(path: string, opts?: { append?: boolean }): Promise<VirtualFSWritable>;\n  mkdir(path: string, opts?: { recursive?: boolean }): Promise<void>;\n\n  rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n\n  resolve(...paths: string[]): string;\n  dirname(path: string): string;\n  basename(path: string): string;\n  glob(pattern: string, opts?: { cwd?: string }): Promise<string[]>;\n}\n\nexport interface FileStat {\n  isFile(): boolean;\n  isDirectory(): boolean;\n  size: number;\n  mtime: Date;\n  mtimeMs: number;\n}\n\n// Command Interfaces\nexport type Command = (ctx: CommandContext) => Promise<number>;\n\nexport interface ShellRunOptions {\n  argv0?: string;\n  args?: string[];\n}\n\nexport interface ShellCommandApi {\n  eval(source: string): Promise<number>;\n  source(path: string, args?: string[]): Promise<number>;\n  runScript(path: string, args?: string[]): Promise<number>;\n  runShell(source: string, options?: ShellRunOptions): Promise<number>;\n  getLastExitCode(): number;\n  exit(exitCode?: number): never;\n}\n\nexport interface TerminalInfo {\n  isTTY: boolean;\n  columns?: number;\n  rows?: number;\n  colorDepth?: number;\n}\n\nexport interface CompletionContext {\n  source: string;\n  cursor: number;\n  command: string;\n  args: string[];\n  word: string;\n  wordStart: number;\n  wordEnd: number;\n  cwd: string;\n  env: Record<string, string>;\n  fs: VirtualFS;\n  terminal: TerminalInfo;\n}\n\nexport interface CompletionResult {\n  replacement: string;\n  matches: string[];\n}\n\nexport type CommandCompleter = (ctx: CompletionContext) => CompletionResult | Promise<CompletionResult>;\n\nexport interface CommandContext {\n  args: string[];\n  stdin: Stdin;\n  stdout: Stdout;\n  stderr: Stderr;\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  terminal: TerminalInfo;\n  signal: AbortSignal;\n  setCwd: (path: string) => void;\n  exec?: (name: string, args: string[]) => Promise<ExecResult>;\n  shell?: ShellCommandApi;\n}\n\nexport interface ExternalCommandContext extends CommandContext {\n  name: string;\n}\n\nexport type ShellCommandFallback = (ctx: ExternalCommandContext) => Promise<number>;\n\nexport interface Stdin {\n  stream(): AsyncIterable<Uint8Array>;\n  buffer(): Promise<Buffer>;\n  text(): Promise<string>;\n  lines(): AsyncIterable<string>;\n}\n\nexport interface ShellInputController extends AsyncIterable<Uint8Array> {\n  write(chunk: Uint8Array | string): Promise<void>;\n  close(): void;\n  abort(reason?: unknown): void;\n}\n\nexport interface Stdout {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface Stderr {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface OutputCollector extends Stdout {\n  close(): void;\n  collect(): Promise<Buffer>;\n  getReadableStream(): AsyncIterable<Uint8Array>;\n}\n\n// Execution Result\nexport interface ExecResult {\n  stdout: Buffer;\n  stderr: Buffer;\n  exitCode: number;\n}\n\nexport interface ShellOutputEvent {\n  fd: 1 | 2;\n  chunk: Uint8Array;\n}\n\nexport type ShellInputSource = AsyncIterable<Uint8Array> | Buffer | string | null;\n\nexport interface ShellExecutionOptions {\n  stdin?: ShellInputSource;\n  stdout?: Stdout;\n  stderr?: Stderr;\n  terminal?: TerminalInfo;\n  signal?: AbortSignal;\n  outputMode?: \"separate\" | \"merged\";\n}\n\nexport interface ShellExecution {\n  stdout: AsyncIterable<Uint8Array>;\n  stderr: AsyncIterable<Uint8Array>;\n  output: AsyncIterable<ShellOutputEvent>;\n  exit: Promise<ExecResult>;\n  kill(reason?: unknown): void;\n}\n\n// Shell Configuration\nexport interface ShellConfig {\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  commands: Record<string, Command>;\n  completions?: Record<string, CommandCompleter>;\n  isTTY?: boolean;\n  terminal?: TerminalInfo;\n  externalCommand?: ShellCommandFallback;\n}\n\n// Raw escape hatch type\nexport interface RawValue {\n  raw: string;\n}\n\nexport function isRawValue(value: unknown): value is RawValue {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"raw\" in value &&\n    typeof (value as RawValue).raw === \"string\"\n  );\n}\n\n// JS Object Redirection types\nexport type RedirectObject = Buffer | Blob | Response | string;\n\nexport interface RedirectObjectMap {\n  [marker: string]: RedirectObject;\n}\n\nexport function isRedirectObject(value: unknown): value is RedirectObject {\n  return (\n    Buffer.isBuffer(value) ||\n    value instanceof Blob ||\n    value instanceof Response ||\n    typeof value === \"string\"\n  );\n}\n"
   ],
-  "mappings": ";AAgHO,SAAS,UAAU,CAAC,OAAmC;AAAA,EAC5D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,SAAS,SACT,OAAQ,MAAmB,QAAQ;AAAA;AAWhC,SAAS,gBAAgB,CAAC,OAAyC;AAAA,EACxE,OACE,OAAO,SAAS,KAAK,KACrB,iBAAiB,QACjB,iBAAiB,YACjB,OAAO,UAAU;AAAA;",
+  "mappings": ";AAqLO,SAAS,UAAU,CAAC,OAAmC;AAAA,EAC5D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,SAAS,SACT,OAAQ,MAAmB,QAAQ;AAAA;AAWhC,SAAS,gBAAgB,CAAC,OAAyC;AAAA,EACxE,OACE,OAAO,SAAS,KAAK,KACrB,iBAAiB,QACjB,iBAAiB,YACjB,OAAO,UAAU;AAAA;",
   "debugId": "9C8E04A91CC7802764756E2164756E21",
   "names": []
 }

package/dist/types/src/index.d.ts

@@ -1,6 +1,7 @@
 export { ShellDSL, createShellDSL, type Program } from "./shell-dsl.ts";
 export { ShellPromise, type ShellPromiseOptions } from "./shell-promise.ts";
-export type { VirtualFS, VirtualFSWritable, FileStat, Command, CommandContext, Stdin, Stdout, Stderr, OutputCollector, ExecResult, ShellConfig, ShellCommandApi, ShellRunOptions, RawValue, } from "./types.ts";
+export { ShellSession, createShellSession, type ShellSessionOptions } from "./shell-session.ts";
+export type { VirtualFS, VirtualFSWritable, FileStat, Command, CommandCompleter, CommandContext, CompletionContext, CompletionResult, Stdin, Stdout, Stderr, OutputCollector, ExecResult, ShellConfig, ShellCommandApi, ShellCommandFallback, ExternalCommandContext, ShellRunOptions, TerminalInfo, ShellInputController, ShellInputSource, ShellExecutionOptions, ShellExecution, ShellOutputEvent, RawValue, } from "./types.ts";
 export { isRawValue } from "./types.ts";
 export { ShellError, LexError, ParseError } from "./errors.ts";
 export { Lexer, lex, tokenToString } from "./lexer/index.ts";
@@ -12,7 +13,9 @@ export { Interpreter, type InterpreterOptions, BreakException, ContinueException
 export { createVirtualFS } from "./fs/index.ts";
 export { FileSystem, ReadOnlyFileSystem, WebFileSystem, createWebUnderlyingFS, type PathOps, type Permission, type PermissionRules, type UnderlyingFS, } from "./fs/index.ts";
 export { createStdin, StdinImpl } from "./io/index.ts";
-export { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from "./io/index.ts";
+export { createStdout, createStderr, createPipe, createShellInput, OutputCollectorImpl, PipeBuffer, ShellInputControllerImpl, } from "./io/index.ts";
+export { analyzeInput } from "./input-analysis.ts";
+export type { InputAnalysis, InputIncompleteReason } from "./input-analysis.ts";
 export { escape, escapeForInterpolation, globVirtualFS } from "./utils/index.ts";
 export type { GlobVirtualFS, GlobOptions } from "./utils/index.ts";
 export { VersionControlSystem } from "./vcs/index.ts";

package/dist/types/src/input-analysis.d.ts

@@ -0,0 +1,14 @@
+import type { ASTNode } from "./parser/ast.ts";
+import { LexError, ParseError } from "./errors.ts";
+export type InputIncompleteReason = "quote" | "heredoc" | "compound" | "pipeline";
+export type InputAnalysis = {
+    kind: "complete";
+    ast: ASTNode;
+} | {
+    kind: "incomplete";
+    reason: InputIncompleteReason;
+} | {
+    kind: "invalid";
+    error: LexError | ParseError | Error;
+};
+export declare function analyzeInput(source: string): InputAnalysis;

package/dist/types/src/interpreter/context.d.ts

@@ -1,4 +1,4 @@
-import type { CommandContext, VirtualFS, Stdin, Stdout, Stderr, ExecResult, ShellCommandApi } from "../types.ts";
+import type { CommandContext, VirtualFS, Stdin, Stdout, Stderr, ExecResult, ShellCommandApi, TerminalInfo } from "../types.ts";
 export interface ContextOptions {
     args: string[];
     stdin: Stdin;
@@ -7,6 +7,8 @@ export interface ContextOptions {
     fs: VirtualFS;
     cwd: string;
     env: Record<string, string>;
+    terminal: TerminalInfo;
+    signal: AbortSignal;
     setCwd: (path: string) => void;
     exec?: (name: string, args: string[]) => Promise<ExecResult>;
     shell?: ShellCommandApi;

package/dist/types/src/interpreter/interpreter.d.ts

@@ -1,5 +1,5 @@
 import type { ASTNode } from "../parser/ast.ts";
-import type { Command, VirtualFS, ExecResult, RedirectObjectMap } from "../types.ts";
+import type { Command, VirtualFS, ExecResult, RedirectObjectMap, TerminalInfo, ShellExecutionOptions, ShellExecution, ShellCommandFallback } from "../types.ts";
 export interface InterpreterOptions {
     fs: VirtualFS;
     cwd: string;
@@ -7,6 +7,9 @@ export interface InterpreterOptions {
     commands: Record<string, Command>;
     redirectObjects?: RedirectObjectMap;
     isTTY?: boolean;
+    terminal?: TerminalInfo;
+    externalCommand?: ShellCommandFallback;
+    signal?: AbortSignal;
     argv0?: string;
     positionalParameters?: string[];
     lastExitCode?: number;
@@ -31,15 +34,22 @@ export declare class Interpreter {
     private redirectObjects;
     private loopDepth;
     private isTTY;
+    private terminal;
+    private activeSignal;
+    private externalCommand?;
     private argv0;
     private positionalParameters;
     private lastExitCode;
     constructor(options: InterpreterOptions);
     getLoopDepth(): number;
     execute(ast: ASTNode): Promise<ExecResult>;
+    executeStreaming(ast: ASTNode, options?: ShellExecutionOptions): ShellExecution;
+    private normalizeInputSource;
     private executeNode;
+    private throwIfAborted;
     private executeCommand;
     private invokeCommand;
+    private invokeExternalCommand;
     private invokeRegisteredCommand;
     private createExec;
     private createShellApi;
@@ -87,4 +97,5 @@ export declare class Interpreter {
     setEnv(vars: Record<string, string>): void;
     getCwd(): string;
     getEnv(): Record<string, string>;
+    getLastExitCode(): number;
 }

package/dist/types/src/io/async-queue.d.ts

@@ -0,0 +1,12 @@
+export declare class AsyncQueue<T> implements AsyncIterable<T> {
+    private items;
+    private closed;
+    private error;
+    private waiters;
+    push(item: T): void;
+    close(): void;
+    fail(reason?: unknown): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    private wake;
+    private wakeWithError;
+}

package/dist/types/src/io/index.d.ts

@@ -1,2 +1,3 @@
 export { StdinImpl, createStdin } from "./stdin.ts";
 export { OutputCollectorImpl, PipeBuffer, createStdout, createStderr, createPipe } from "./stdout.ts";
+export { ShellInputControllerImpl, createShellInput } from "./input-controller.ts";

package/dist/types/src/io/input-controller.d.ts

@@ -0,0 +1,15 @@
+import type { ShellInputController } from "../types.ts";
+export declare class ShellInputControllerImpl implements ShellInputController {
+    private chunks;
+    private closed;
+    private aborted;
+    private abortReason;
+    private waiters;
+    write(chunk: Uint8Array | string): Promise<void>;
+    close(): void;
+    abort(reason?: unknown): void;
+    [Symbol.asyncIterator](): AsyncIterator<Uint8Array>;
+    private wake;
+    private wakeWithError;
+}
+export declare function createShellInput(): ShellInputController;

package/dist/types/src/io/stdout.d.ts

@@ -6,7 +6,8 @@ export declare class OutputCollectorImpl implements OutputCollector {
     private resolveWait;
     private waitPromise;
     isTTY: boolean;
-    constructor(isTTY?: boolean);
+    private onWrite?;
+    constructor(isTTY?: boolean, onWrite?: (chunk: Uint8Array) => void | Promise<void>);
     write(chunk: Uint8Array): Promise<void>;
     writeText(str: string): Promise<void>;
     close(): void;
@@ -25,8 +26,8 @@ export declare class PipeBuffer implements OutputCollector, Stdout {
     collect(): Promise<Buffer>;
     getReadableStream(): AsyncIterable<Uint8Array>;
 }
-export declare function createStdout(isTTY?: boolean): OutputCollector;
-export declare function createStderr(isTTY?: boolean): OutputCollector;
+export declare function createStdout(isTTY?: boolean, onWrite?: (chunk: Uint8Array) => void | Promise<void>): OutputCollector;
+export declare function createStderr(isTTY?: boolean, onWrite?: (chunk: Uint8Array) => void | Promise<void>): OutputCollector;
 export declare function createPipe(): PipeBuffer;
 export declare class BufferTargetCollector implements OutputCollector {
     private target;

package/dist/types/src/shell-dsl.d.ts

@@ -15,6 +15,8 @@ export declare class ShellDSL {
     private commands;
     private shouldThrow;
     private isTTY;
+    private terminal;
+    private externalCommand?;
     constructor(config: ShellConfig);
     tag(strings: TemplateStringsArray, ...values: unknown[]): ShellPromise;
     private isRedirectTarget;