shell-dsl 0.0.21 → 0.0.23

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\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  }\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        });\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    });\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  });\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 { 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"
   ],
-  "mappings": "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",
-  "debugId": "7846EA9AA40AD9AA64756E2164756E21",
+  "mappings": "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",
+  "debugId": "8F671D51EF55457364756E2164756E21",
   "names": []
 }

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

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/types.ts"],
   "sourcesContent": [
-    "// Virtual Filesystem Interface\nexport interface VirtualFS {\n  readFile(path: string): Promise<Buffer>;\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  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}\n\n// Command Interfaces\nexport type Command = (ctx: CommandContext) => Promise<number>;\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}\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}\n\nexport interface Stderr {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\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}\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 VirtualFS {\n  readFile(path: string): Promise<Buffer>;\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  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}\n\n// Command Interfaces\nexport type Command = (ctx: CommandContext) => Promise<number>;\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}\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"
   ],
-  "mappings": ";AAmFO,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": ";AAsFO,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/commands/cut/cut.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "../../types.ts";
+export declare const cut: Command;

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

@@ -25,4 +25,5 @@ export { breakCmd, continueCmd } from "./break-continue/break-continue.ts";
 export { colon } from "./colon/colon.ts";
 export { cd } from "./cd/cd.ts";
 export { tr } from "./tr/tr.ts";
+export { cut } from "./cut/cut.ts";
 export declare const builtinCommands: Record<string, Command>;

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

@@ -6,6 +6,7 @@ export interface InterpreterOptions {
     env: Record<string, string>;
     commands: Record<string, Command>;
     redirectObjects?: RedirectObjectMap;
+    isTTY?: boolean;
 }
 export declare class BreakException extends Error {
     levels: number;
@@ -22,6 +23,7 @@ export declare class Interpreter {
     private commands;
     private redirectObjects;
     private loopDepth;
+    private isTTY;
     constructor(options: InterpreterOptions);
     getLoopDepth(): number;
     execute(ast: ASTNode): Promise<ExecResult>;

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

@@ -5,6 +5,8 @@ export declare class OutputCollectorImpl implements OutputCollector {
     private closeResolvers;
     private resolveWait;
     private waitPromise;
+    isTTY: boolean;
+    constructor(isTTY?: boolean);
     write(chunk: Uint8Array): Promise<void>;
     writeText(str: string): Promise<void>;
     close(): void;
@@ -16,20 +18,22 @@ export declare class PipeBuffer implements OutputCollector, Stdout {
     private closed;
     private waitingReaders;
     private readIndex;
+    readonly isTTY: boolean;
     write(chunk: Uint8Array): Promise<void>;
     writeText(str: string): Promise<void>;
     close(): void;
     collect(): Promise<Buffer>;
     getReadableStream(): AsyncIterable<Uint8Array>;
 }
-export declare function createStdout(): OutputCollector;
-export declare function createStderr(): OutputCollector;
+export declare function createStdout(isTTY?: boolean): OutputCollector;
+export declare function createStderr(isTTY?: boolean): OutputCollector;
 export declare function createPipe(): PipeBuffer;
 export declare class BufferTargetCollector implements OutputCollector {
     private target;
     private offset;
     private closed;
     private closeResolvers;
+    readonly isTTY: boolean;
     constructor(target: Buffer);
     write(chunk: Uint8Array): Promise<void>;
     writeText(str: string): Promise<void>;

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

@@ -14,6 +14,7 @@ export declare class ShellDSL {
     private currentEnv;
     private commands;
     private shouldThrow;
+    private isTTY;
     constructor(config: ShellConfig);
     tag(strings: TemplateStringsArray, ...values: unknown[]): ShellPromise;
     private isRedirectTarget;

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

@@ -45,10 +45,12 @@ export interface Stdin {
 export interface Stdout {
     write(chunk: Uint8Array): Promise<void>;
     writeText(str: string): Promise<void>;
+    isTTY: boolean;
 }
 export interface Stderr {
     write(chunk: Uint8Array): Promise<void>;
     writeText(str: string): Promise<void>;
+    isTTY: boolean;
 }
 export interface OutputCollector extends Stdout {
     close(): void;
@@ -65,6 +67,7 @@ export interface ShellConfig {
     cwd: string;
     env: Record<string, string>;
     commands: Record<string, Command>;
+    isTTY?: boolean;
 }
 export interface RawValue {
     raw: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "A sandboxed shell-style DSL for running scriptable command pipelines in-process without host OS access",
   "author": "ricsam <oss@ricsam.dev>",
   "license": "MIT",