printable-shell-command 1.2.0 → 2.0.0

package/README.md

@@ -50,8 +50,8 @@ const command = new PrintableShellCommand(/* … */);
 const child_process = spawn(...command.toCommandWithFlatArgs()); // Note the `...`
 
 // or directly
-await command.spawnNode().success;
-await command.spawnNodeInherit().success;
+await command.spawn().success;
+await command.spawnInherit().success;
 ```
 
 ### Spawn a process in `bun`
@@ -64,8 +64,8 @@ const command = new PrintableShellCommand(/* … */);
 await spawn(command.toFlatCommand()).exited;
 
 // or directly
-await command.spawnBun().success;
-await command.spawnBunInherit().success;
+await command.bun.spawnBun().success;
+await command.bun.spawnBunInherit().success;
 ```
 
 ## Protections

package/dist/lib/printable-shell-command/index.d.ts

@@ -103,50 +103,50 @@ export declare class PrintableShellCommand {
     /**
      * The returned child process includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313
      */
-    spawnNode<Stdin extends NodeStdioNull | NodeStdioPipe, Stdout extends NodeStdioNull | NodeStdioPipe, Stderr extends NodeStdioNull | NodeStdioPipe>(options?: NodeSpawnOptions | NodeSpawnOptionsWithoutStdio | NodeSpawnOptionsWithStdioTuple<Stdin, Stdout, Stderr>): // TODO: figure out how to return `ChildProcessByStdio<…>` without duplicating fragile boilerplate.
+    spawn<Stdin extends NodeStdioNull | NodeStdioPipe, Stdout extends NodeStdioNull | NodeStdioPipe, Stderr extends NodeStdioNull | NodeStdioPipe>(options?: NodeSpawnOptions | NodeSpawnOptionsWithoutStdio | NodeSpawnOptionsWithStdioTuple<Stdin, Stdout, Stderr>): // TODO: figure out how to return `ChildProcessByStdio<…>` without duplicating fragile boilerplate.
     NodeChildProcess & {
         success: Promise<void>;
     };
     /** A wrapper for `.spawnNode(…)` that sets stdio to `"inherit"` (common for
      * invoking commands from scripts whose output and interaction should be
      * surfaced to the user). */
-    spawnNodeInherit(options?: Omit<NodeSpawnOptions, "stdio">): NodeChildProcess & {
+    spawnInherit(options?: Omit<NodeSpawnOptions, "stdio">): NodeChildProcess & {
         success: Promise<void>;
     };
+    stdout(options?: Omit<NodeSpawnOptions, "stdio">): Response;
     /** Equivalent to:
      *
      * ```
-     * await this.print().spawnNodeInherit(…).success;
+     * await this.print().spawnInherit(…).success;
      * ```
      */
-    shellOutNode(options?: Omit<NodeSpawnOptions, "stdio">): Promise<void>;
-    /**
-     * The returned subprocess includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313
-     */
-    spawnBun<const In extends BunSpawnOptions.Writable = "ignore", const Out extends BunSpawnOptions.Readable = "pipe", const Err extends BunSpawnOptions.Readable = "inherit">(options?: Omit<BunSpawnOptions.OptionsObject<In, Out, Err>, "cmd">): BunSubprocess<In, Out, Err> & {
-        success: Promise<void>;
+    shellOut(options?: Omit<NodeSpawnOptions, "stdio">): Promise<void>;
+    bun: {
+        /** Equivalent to:
+         *
+         * ```
+         * await this.print().bun.spawnBunInherit(…).success;
+         * ```
+         */
+        spawnBun: <const In extends BunSpawnOptions.Writable = "ignore", const Out extends BunSpawnOptions.Readable = "pipe", const Err extends BunSpawnOptions.Readable = "inherit">(options?: Omit<BunSpawnOptions.OptionsObject<In, Out, Err>, "cmd">) => BunSubprocess<In, Out, Err> & {
+            success: Promise<void>;
+        };
+        /**
+         * A wrapper for `.spawnBunInherit(…)` that sets stdio to `"inherit"` (common
+         * for invoking commands from scripts whose output and interaction should be
+         * surfaced to the user).
+         */
+        spawnBunInherit: (options?: Omit<Omit<BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">, "cmd">, "stdio">) => BunSubprocess<"inherit", "inherit", "inherit"> & {
+            success: Promise<void>;
+        };
+        /** Equivalent to:
+         *
+         * ```
+         * new Response(this.bun.spawnBun(…).stdout);
+         * ```
+         */
+        spawnBunStdout: (options?: Omit<Omit<BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">, "cmd">, "stdio">) => Response;
+        shellOutBun: (options?: Omit<Omit<BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">, "cmd">, "stdio">) => Promise<void>;
     };
-    /**
-     * A wrapper for `.spawnBunInherit(…)` that sets stdio to `"inherit"` (common
-     * for invoking commands from scripts whose output and interaction should be
-     * surfaced to the user).
-     */
-    spawnBunInherit(options?: Omit<Omit<BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">, "cmd">, "stdio">): BunSubprocess<"inherit", "inherit", "inherit"> & {
-        success: Promise<void>;
-    };
-    /** Equivalent to:
-     *
-     * ```
-     * new Response(this.spawnBun(…).stdout);
-     * ```
-     */
-    spawnBunStdout(options?: Omit<Omit<BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">, "cmd">, "stdio">): Response;
-    /** Equivalent to:
-     *
-     * ```
-     * await this.print().spawnBunInherit(…).success;
-     * ```
-     */
-    shellOutBun(options?: Omit<Omit<BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">, "cmd">, "stdio">): Promise<void>;
 }
 export {};

package/dist/lib/printable-shell-command/index.js

@@ -1,4 +1,5 @@
 // src/index.ts
+import { Readable } from "node:stream";
 import { styleText } from "node:util";
 var DEFAULT_MAIN_INDENTATION = "";
 var DEFAULT_ARG_INDENTATION = "  ";
@@ -193,7 +194,7 @@ var PrintableShellCommand = class {
       return "";
     }
     if (options.skipLineWrapBeforeFirstArg ?? false) {
-      return " ";
+      return INLINE_SEPARATOR;
     }
     return this.#intraEntrySeparator(options);
   }
@@ -223,7 +224,7 @@ var PrintableShellCommand = class {
   /**
    * The returned child process includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313
    */
-  spawnNode(options) {
+  spawn(options) {
     const { spawn } = process.getBuiltinModule("node:child_process");
     const subprocess = spawn(...this.forNode(), options);
     Object.defineProperty(subprocess, "success", {
@@ -248,25 +249,35 @@ var PrintableShellCommand = class {
   /** A wrapper for `.spawnNode(…)` that sets stdio to `"inherit"` (common for
    * invoking commands from scripts whose output and interaction should be
    * surfaced to the user). */
-  spawnNodeInherit(options) {
+  spawnInherit(options) {
     if (options && "stdio" in options) {
       throw new Error("Unexpected `stdio` field.");
     }
-    return this.spawnNode({ ...options, stdio: "inherit" });
+    return this.spawn({ ...options, stdio: "inherit" });
+  }
+  stdout(options) {
+    if (options && "stdio" in options) {
+      throw new Error("Unexpected `stdio` field.");
+    }
+    const subprocess = this.spawn({
+      ...options,
+      stdio: ["ignore", "pipe", "inherit"]
+    });
+    return new Response(Readable.toWeb(subprocess.stdout));
   }
   /** Equivalent to:
    *
    * ```
-   * await this.print().spawnNodeInherit(…).success;
+   * await this.print().spawnInherit(…).success;
    * ```
    */
-  async shellOutNode(options) {
-    await this.print().spawnNodeInherit(options).success;
+  async shellOut(options) {
+    await this.print().spawnInherit(options).success;
   }
   /**
    * The returned subprocess includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313
    */
-  spawnBun(options) {
+  #spawnBun(options) {
     if (options && "cmd" in options) {
       throw new Error("Unexpected `cmd` field.");
     }
@@ -295,38 +306,44 @@ var PrintableShellCommand = class {
     });
     return subprocess;
   }
-  /**
-   * A wrapper for `.spawnBunInherit(…)` that sets stdio to `"inherit"` (common
-   * for invoking commands from scripts whose output and interaction should be
-   * surfaced to the user).
-   */
-  spawnBunInherit(options) {
+  #spawnBunInherit(options) {
     if (options && "stdio" in options) {
       throw new Error("Unexpected `stdio` field.");
     }
-    return this.spawnBun({
+    return this.bun.spawnBun({
       ...options,
       stdio: ["inherit", "inherit", "inherit"]
     });
   }
-  /** Equivalent to:
-   *
-   * ```
-   * new Response(this.spawnBun(…).stdout);
-   * ```
-   */
-  spawnBunStdout(options) {
-    return new Response(this.spawnBun(options).stdout);
+  #spawnBunStdout(options) {
+    return new Response(this.bun.spawnBun(options).stdout);
   }
-  /** Equivalent to:
-   *
-   * ```
-   * await this.print().spawnBunInherit(…).success;
-   * ```
-   */
-  async shellOutBun(options) {
-    await this.print().spawnBunInherit(options).success;
+  async #shellOutBun(options) {
+    await this.print().bun.spawnBunInherit(options).success;
   }
+  bun = {
+    /** Equivalent to:
+     *
+     * ```
+     * await this.print().bun.spawnBunInherit(…).success;
+     * ```
+     */
+    spawnBun: this.#spawnBun.bind(this),
+    /**
+     * A wrapper for `.spawnBunInherit(…)` that sets stdio to `"inherit"` (common
+     * for invoking commands from scripts whose output and interaction should be
+     * surfaced to the user).
+     */
+    spawnBunInherit: this.#spawnBunInherit.bind(this),
+    /** Equivalent to:
+     *
+     * ```
+     * new Response(this.bun.spawnBun(…).stdout);
+     * ```
+     */
+    spawnBunStdout: this.#spawnBunStdout.bind(this),
+    shellOutBun: this.#shellOutBun.bind(this)
+  };
 };
 export {
   PrintableShellCommand

package/dist/lib/printable-shell-command/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/index.ts"],
-  "sourcesContent": ["import type {\n  ChildProcess as NodeChildProcess,\n  SpawnOptions as NodeSpawnOptions,\n  SpawnOptionsWithoutStdio as NodeSpawnOptionsWithoutStdio,\n  SpawnOptionsWithStdioTuple as NodeSpawnOptionsWithStdioTuple,\n  StdioNull as NodeStdioNull,\n  StdioPipe as NodeStdioPipe,\n} from \"node:child_process\";\nimport { styleText } from \"node:util\";\nimport type {\n  SpawnOptions as BunSpawnOptions,\n  Subprocess as BunSubprocess,\n} from \"bun\";\n\nconst DEFAULT_MAIN_INDENTATION = \"\";\nconst DEFAULT_ARG_INDENTATION = \"  \";\nconst DEFAULT_ARGUMENT_LINE_WRAPPING = \"by-entry\";\n\nconst INLINE_SEPARATOR = \" \";\nconst LINE_WRAP_LINE_END = \" \\\\\\n\";\n\n// biome-ignore lint/suspicious/noExplicitAny: This is the correct type nere.\nfunction isString(s: any): s is string {\n  return typeof s === \"string\";\n}\n// biome-ignore lint/suspicious/noExplicitAny: This is the correct type nere.\nfunction isStringArray(entries: any[]): entries is string[] {\n  for (const entry of entries) {\n    if (!isString(entry)) {\n      return false;\n    }\n  }\n  return true;\n}\n\n// TODO: allow `.toString()`ables?\ntype SingleArgument = string;\ntype FlagArgumentGroup = string[];\ntype ArgsEntry = SingleArgument | FlagArgumentGroup;\ntype Args = ArgsEntry[];\n\nexport interface PrintOptions {\n  /** Defaults to \"\" */\n  mainIndentation?: string;\n  /** Defaults to \"  \" */\n  argIndentation?: string;\n  /**\n   * - `\"auto\"`: Quote only arguments that need it for safety. This tries to be\n   *   portable and safe across shells, but true safety and portability is hard\n   *   to guarantee.\n   * - `\"extra-safe\"`: Quote all arguments, even ones that don't need it. This is\n   *   more likely to be safe under all circumstances.\n   */\n  quoting?: \"auto\" | \"extra-safe\";\n  /** Line wrapping to use between arguments. Defaults to `\"by-entry\"`. */\n  argumentLineWrapping?:\n    | \"by-entry\"\n    | \"nested-by-entry\"\n    | \"by-argument\"\n    | \"inline\";\n  /** Include the first arg (or first arg group) on the same line as the command, regardless of the `argumentLineWrapping` setting. */\n  skipLineWrapBeforeFirstArg?: true | false;\n  /**\n   * Style text using `node`'s [`styleText(\u2026)`](https://nodejs.org/api/util.html#utilstyletextformat-text-options)\n   *\n   * Example usage:\n   *\n   * ```\n   * new PrintableShellCommand(\"echo\", [\"hi\"]).print({\n   *   styleTextFormat: [\"gray\", \"bold\"],\n   * });\n   * */\n  styleTextFormat?: Parameters<typeof styleText>[0];\n}\n\n// https://mywiki.wooledge.org/BashGuide/SpecialCharacters\nconst SPECIAL_SHELL_CHARACTERS = new Set([\n  \" \",\n  '\"',\n  \"'\",\n  \"`\",\n  \"|\",\n  \"$\",\n  \"*\",\n  \"?\",\n  \">\",\n  \"<\",\n  \"(\",\n  \")\",\n  \"[\",\n  \"]\",\n  \"{\",\n  \"}\",\n  \"&\",\n  \"\\\\\",\n  \";\",\n  \"#\",\n]);\n\n// https://mywiki.wooledge.org/BashGuide/SpecialCharacters\nconst SPECIAL_SHELL_CHARACTERS_FOR_MAIN_COMMAND =\n  // biome-ignore lint/suspicious/noExplicitAny: Workaround to make this package easier to use in a project that otherwise only uses ES2022.)\n  (SPECIAL_SHELL_CHARACTERS as unknown as any).union(new Set([\"=\"]));\n\nexport class PrintableShellCommand {\n  #commandName: string;\n  constructor(\n    commandName: string,\n    private args: Args = [],\n  ) {\n    if (!isString(commandName)) {\n      // biome-ignore lint/suspicious/noExplicitAny: We want to print this, no matter what it is.\n      throw new Error(\"Command name is not a string:\", commandName as any);\n    }\n    this.#commandName = commandName;\n    if (typeof args === \"undefined\") {\n      return;\n    }\n    if (!Array.isArray(args)) {\n      throw new Error(\"Command arguments are not an array\");\n    }\n    for (let i = 0; i < args.length; i++) {\n      const argEntry = args[i];\n      if (typeof argEntry === \"string\") {\n        continue;\n      }\n      if (Array.isArray(argEntry) && isStringArray(argEntry)) {\n        continue;\n      }\n      throw new Error(`Invalid arg entry at index: ${i}`);\n    }\n  }\n\n  get commandName(): string {\n    return this.#commandName;\n  }\n\n  /** For use with `bun`.\n   *\n   * Usage example:\n   *\n   * ```\n   * import { PrintableShellCommand } from \"printable-shell-command\";\n   * import { spawn } from \"bun\";\n   *\n   * const command = new PrintableShellCommand( \u2026 );\n   * await spawn(command.toFlatCommand()).exited;\n   * ```\n   */\n  public toFlatCommand(): string[] {\n    return [this.commandName, ...this.args.flat()];\n  }\n\n  /**\n   * Convenient alias for `toFlatCommand()`.\n   *\n   * Usage example:\n   *\n   * ```\n   * import { PrintableShellCommand } from \"printable-shell-command\";\n   * import { spawn } from \"bun\";\n   *\n   * const command = new PrintableShellCommand( \u2026 );\n   * await spawn(command.forBun()).exited;\n   * ```\n   *\n   * */\n  public forBun(): string[] {\n    return this.toFlatCommand();\n  }\n\n  /**\n   * For use with `node:child_process`\n   *\n   * Usage example:\n   *\n   * ```\n   * import { PrintableShellCommand } from \"printable-shell-command\";\n   * import { spawn } from \"node:child_process\";\n   *\n   * const command = new PrintableShellCommand( \u2026 );\n   * const child_process = spawn(...command.toCommandWithFlatArgs()); // Note the `...`\n   * ```\n   *\n   */\n  public toCommandWithFlatArgs(): [string, string[]] {\n    return [this.commandName, this.args.flat()];\n  }\n\n  /**\n   * For use with `node:child_process`\n   *\n   * Usage example:\n   *\n   * ```\n   * import { PrintableShellCommand } from \"printable-shell-command\";\n   * import { spawn } from \"node:child_process\";\n   *\n   * const command = new PrintableShellCommand( \u2026 );\n   * const child_process = spawn(...command.forNode()); // Note the `...`\n   * ```\n   *\n   * Convenient alias for `toCommandWithFlatArgs()`.\n   */\n  public forNode(): [string, string[]] {\n    return this.toCommandWithFlatArgs();\n  }\n\n  #escapeArg(\n    arg: string,\n    isMainCommand: boolean,\n    options: PrintOptions,\n  ): string {\n    const argCharacters = new Set(arg);\n    const specialShellCharacters = isMainCommand\n      ? SPECIAL_SHELL_CHARACTERS_FOR_MAIN_COMMAND\n      : SPECIAL_SHELL_CHARACTERS;\n    if (\n      options?.quoting === \"extra-safe\" ||\n      // biome-ignore lint/suspicious/noExplicitAny: Workaround to make this package easier to use in a project that otherwise only uses ES2022.)\n      (argCharacters as unknown as any).intersection(specialShellCharacters)\n        .size > 0\n    ) {\n      // Use single quote to reduce the need to escape (and therefore reduce the chance for bugs/security issues).\n      const escaped = arg.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll(\"'\", \"\\\\'\");\n      return `'${escaped}'`;\n    }\n    return arg;\n  }\n\n  #mainIndentation(options: PrintOptions): string {\n    return options?.mainIndentation ?? DEFAULT_MAIN_INDENTATION;\n  }\n\n  #argIndentation(options: PrintOptions): string {\n    return (\n      this.#mainIndentation(options) +\n      (options?.argIndentation ?? DEFAULT_ARG_INDENTATION)\n    );\n  }\n\n  #lineWrapSeparator(options: PrintOptions): string {\n    return LINE_WRAP_LINE_END + this.#argIndentation(options);\n  }\n\n  #argPairSeparator(options: PrintOptions): string {\n    switch (options?.argumentLineWrapping ?? DEFAULT_ARGUMENT_LINE_WRAPPING) {\n      case \"by-entry\": {\n        return INLINE_SEPARATOR;\n      }\n      case \"nested-by-entry\": {\n        return this.#lineWrapSeparator(options) + this.#argIndentation(options);\n      }\n      case \"by-argument\": {\n        return this.#lineWrapSeparator(options);\n      }\n      case \"inline\": {\n        return INLINE_SEPARATOR;\n      }\n      default:\n        throw new Error(\"Invalid argument line wrapping argument.\");\n    }\n  }\n\n  #intraEntrySeparator(options: PrintOptions): string {\n    switch (options?.argumentLineWrapping ?? DEFAULT_ARGUMENT_LINE_WRAPPING) {\n      case \"by-entry\":\n      case \"nested-by-entry\":\n      case \"by-argument\": {\n        return LINE_WRAP_LINE_END + this.#argIndentation(options);\n      }\n      case \"inline\": {\n        return INLINE_SEPARATOR;\n      }\n      default:\n        throw new Error(\"Invalid argument line wrapping argument.\");\n    }\n  }\n\n  #separatorAfterCommand(\n    options: PrintOptions,\n    numFollowingEntries: number,\n  ): string {\n    if (numFollowingEntries === 0) {\n      return \"\";\n    }\n    if (options.skipLineWrapBeforeFirstArg ?? false) {\n      return \" \";\n    }\n    return this.#intraEntrySeparator(options);\n  }\n\n  public getPrintableCommand(options?: PrintOptions): string {\n    // TODO: Why in the world does TypeScript not give the `options` arg the type of `PrintOptions | undefined`???\n    options ??= {};\n    const serializedEntries: string[] = [];\n\n    for (let i = 0; i < this.args.length; i++) {\n      const argsEntry = this.args[i];\n\n      if (isString(argsEntry)) {\n        serializedEntries.push(this.#escapeArg(argsEntry, false, options));\n      } else {\n        serializedEntries.push(\n          argsEntry\n            .map((part) => this.#escapeArg(part, false, options))\n            .join(this.#argPairSeparator(options)),\n        );\n      }\n    }\n\n    let text =\n      this.#mainIndentation(options) +\n      this.#escapeArg(this.commandName, true, options) +\n      this.#separatorAfterCommand(options, serializedEntries.length) +\n      serializedEntries.join(this.#intraEntrySeparator(options));\n    if (options?.styleTextFormat) {\n      text = styleText(options.styleTextFormat, text);\n    }\n    return text;\n  }\n\n  public print(options?: PrintOptions): PrintableShellCommand {\n    console.log(this.getPrintableCommand(options));\n    return this;\n  }\n\n  /**\n   * The returned child process includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313\n   */\n  public spawnNode<\n    Stdin extends NodeStdioNull | NodeStdioPipe,\n    Stdout extends NodeStdioNull | NodeStdioPipe,\n    Stderr extends NodeStdioNull | NodeStdioPipe,\n  >(\n    options?:\n      | NodeSpawnOptions\n      | NodeSpawnOptionsWithoutStdio\n      | NodeSpawnOptionsWithStdioTuple<Stdin, Stdout, Stderr>,\n  ): // TODO: figure out how to return `ChildProcessByStdio<\u2026>` without duplicating fragile boilerplate.\n  NodeChildProcess & { success: Promise<void> } {\n    const { spawn } = process.getBuiltinModule(\"node:child_process\");\n    // @ts-ignore: The TypeScript checker has trouble reconciling the optional (i.e. potentially `undefined`) `options` with the third argument.\n    const subprocess = spawn(...this.forNode(), options) as NodeChildProcess & {\n      success: Promise<void>;\n    };\n    Object.defineProperty(subprocess, \"success\", {\n      get() {\n        return new Promise<void>((resolve, reject) =>\n          this.addListener(\n            \"exit\",\n            (exitCode: number /* we only use the first arg */) => {\n              if (exitCode === 0) {\n                resolve();\n              } else {\n                reject(`Command failed with non-zero exit code: ${exitCode}`);\n              }\n            },\n          ),\n        );\n      },\n      enumerable: false,\n    });\n    return subprocess;\n  }\n\n  /** A wrapper for `.spawnNode(\u2026)` that sets stdio to `\"inherit\"` (common for\n   * invoking commands from scripts whose output and interaction should be\n   * surfaced to the user). */\n  public spawnNodeInherit(\n    options?: Omit<NodeSpawnOptions, \"stdio\">,\n  ): NodeChildProcess & { success: Promise<void> } {\n    if (options && \"stdio\" in options) {\n      throw new Error(\"Unexpected `stdio` field.\");\n    }\n    return this.spawnNode({ ...options, stdio: \"inherit\" });\n  }\n\n  /** Equivalent to:\n   *\n   * ```\n   * await this.print().spawnNodeInherit(\u2026).success;\n   * ```\n   */\n  public async shellOutNode(\n    options?: Omit<NodeSpawnOptions, \"stdio\">,\n  ): Promise<void> {\n    await this.print().spawnNodeInherit(options).success;\n  }\n\n  /**\n   * The returned subprocess includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313\n   */\n  public spawnBun<\n    const In extends BunSpawnOptions.Writable = \"ignore\",\n    const Out extends BunSpawnOptions.Readable = \"pipe\",\n    const Err extends BunSpawnOptions.Readable = \"inherit\",\n  >(\n    options?: Omit<BunSpawnOptions.OptionsObject<In, Out, Err>, \"cmd\">,\n  ): BunSubprocess<In, Out, Err> & { success: Promise<void> } {\n    if (options && \"cmd\" in options) {\n      throw new Error(\"Unexpected `cmd` field.\");\n    }\n    const { spawn } = process.getBuiltinModule(\"bun\") as typeof import(\"bun\");\n    const subprocess = spawn({\n      ...options,\n      cmd: this.forBun(),\n    }) as BunSubprocess<In, Out, Err> & { success: Promise<void> };\n    Object.defineProperty(subprocess, \"success\", {\n      get() {\n        return new Promise<void>((resolve, reject) =>\n          this.exited\n            .then((exitCode: number) => {\n              if (exitCode === 0) {\n                resolve();\n              } else {\n                reject(\n                  new Error(\n                    `Command failed with non-zero exit code: ${exitCode}`,\n                  ),\n                );\n              }\n            })\n            .catch(reject),\n        );\n      },\n      enumerable: false,\n    });\n    return subprocess;\n  }\n\n  /**\n   * A wrapper for `.spawnBunInherit(\u2026)` that sets stdio to `\"inherit\"` (common\n   * for invoking commands from scripts whose output and interaction should be\n   * surfaced to the user).\n   */\n  public spawnBunInherit(\n    options?: Omit<\n      Omit<\n        BunSpawnOptions.OptionsObject<\"inherit\", \"inherit\", \"inherit\">,\n        \"cmd\"\n      >,\n      \"stdio\"\n    >,\n  ): BunSubprocess<\"inherit\", \"inherit\", \"inherit\"> & {\n    success: Promise<void>;\n  } {\n    if (options && \"stdio\" in options) {\n      throw new Error(\"Unexpected `stdio` field.\");\n    }\n    return this.spawnBun({\n      ...options,\n      stdio: [\"inherit\", \"inherit\", \"inherit\"],\n    });\n  }\n\n  /** Equivalent to:\n   *\n   * ```\n   * new Response(this.spawnBun(\u2026).stdout);\n   * ```\n   */\n  public spawnBunStdout(\n    options?: Omit<\n      Omit<\n        BunSpawnOptions.OptionsObject<\"inherit\", \"inherit\", \"inherit\">,\n        \"cmd\"\n      >,\n      \"stdio\"\n    >,\n  ): Response {\n    // biome-ignore lint/suspicious/noExplicitAny: Avoid breaking the lib check when used without `@types/bun`.\n    return new Response((this.spawnBun(options) as any).stdout);\n  }\n\n  /** Equivalent to:\n   *\n   * ```\n   * await this.print().spawnBunInherit(\u2026).success;\n   * ```\n   */\n  public async shellOutBun(\n    options?: Omit<\n      Omit<\n        BunSpawnOptions.OptionsObject<\"inherit\", \"inherit\", \"inherit\">,\n        \"cmd\"\n      >,\n      \"stdio\"\n    >,\n  ): Promise<void> {\n    await this.print().spawnBunInherit(options).success;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type {\n  ChildProcess as NodeChildProcess,\n  SpawnOptions as NodeSpawnOptions,\n  SpawnOptionsWithoutStdio as NodeSpawnOptionsWithoutStdio,\n  SpawnOptionsWithStdioTuple as NodeSpawnOptionsWithStdioTuple,\n  StdioNull as NodeStdioNull,\n  StdioPipe as NodeStdioPipe,\n} from \"node:child_process\";\nimport { Readable } from \"node:stream\";\nimport { styleText } from \"node:util\";\nimport type {\n  SpawnOptions as BunSpawnOptions,\n  Subprocess as BunSubprocess,\n} from \"bun\";\n\nconst DEFAULT_MAIN_INDENTATION = \"\";\nconst DEFAULT_ARG_INDENTATION = \"  \";\nconst DEFAULT_ARGUMENT_LINE_WRAPPING = \"by-entry\";\n\nconst INLINE_SEPARATOR = \" \";\nconst LINE_WRAP_LINE_END = \" \\\\\\n\";\n\n// biome-ignore lint/suspicious/noExplicitAny: This is the correct type nere.\nfunction isString(s: any): s is string {\n  return typeof s === \"string\";\n}\n// biome-ignore lint/suspicious/noExplicitAny: This is the correct type nere.\nfunction isStringArray(entries: any[]): entries is string[] {\n  for (const entry of entries) {\n    if (!isString(entry)) {\n      return false;\n    }\n  }\n  return true;\n}\n\n// TODO: allow `.toString()`ables?\ntype SingleArgument = string;\ntype FlagArgumentGroup = string[];\ntype ArgsEntry = SingleArgument | FlagArgumentGroup;\ntype Args = ArgsEntry[];\n\nexport interface PrintOptions {\n  /** Defaults to \"\" */\n  mainIndentation?: string;\n  /** Defaults to \"  \" */\n  argIndentation?: string;\n  /**\n   * - `\"auto\"`: Quote only arguments that need it for safety. This tries to be\n   *   portable and safe across shells, but true safety and portability is hard\n   *   to guarantee.\n   * - `\"extra-safe\"`: Quote all arguments, even ones that don't need it. This is\n   *   more likely to be safe under all circumstances.\n   */\n  quoting?: \"auto\" | \"extra-safe\";\n  /** Line wrapping to use between arguments. Defaults to `\"by-entry\"`. */\n  argumentLineWrapping?:\n    | \"by-entry\"\n    | \"nested-by-entry\"\n    | \"by-argument\"\n    | \"inline\";\n  /** Include the first arg (or first arg group) on the same line as the command, regardless of the `argumentLineWrapping` setting. */\n  skipLineWrapBeforeFirstArg?: true | false;\n  /**\n   * Style text using `node`'s [`styleText(\u2026)`](https://nodejs.org/api/util.html#utilstyletextformat-text-options)\n   *\n   * Example usage:\n   *\n   * ```\n   * new PrintableShellCommand(\"echo\", [\"hi\"]).print({\n   *   styleTextFormat: [\"gray\", \"bold\"],\n   * });\n   * */\n  styleTextFormat?: Parameters<typeof styleText>[0];\n}\n\n// https://mywiki.wooledge.org/BashGuide/SpecialCharacters\nconst SPECIAL_SHELL_CHARACTERS = new Set([\n  \" \",\n  '\"',\n  \"'\",\n  \"`\",\n  \"|\",\n  \"$\",\n  \"*\",\n  \"?\",\n  \">\",\n  \"<\",\n  \"(\",\n  \")\",\n  \"[\",\n  \"]\",\n  \"{\",\n  \"}\",\n  \"&\",\n  \"\\\\\",\n  \";\",\n  \"#\",\n]);\n\n// https://mywiki.wooledge.org/BashGuide/SpecialCharacters\nconst SPECIAL_SHELL_CHARACTERS_FOR_MAIN_COMMAND =\n  // biome-ignore lint/suspicious/noExplicitAny: Workaround to make this package easier to use in a project that otherwise only uses ES2022.)\n  (SPECIAL_SHELL_CHARACTERS as unknown as any).union(new Set([\"=\"]));\n\nexport class PrintableShellCommand {\n  #commandName: string;\n  constructor(\n    commandName: string,\n    private args: Args = [],\n  ) {\n    if (!isString(commandName)) {\n      // biome-ignore lint/suspicious/noExplicitAny: We want to print this, no matter what it is.\n      throw new Error(\"Command name is not a string:\", commandName as any);\n    }\n    this.#commandName = commandName;\n    if (typeof args === \"undefined\") {\n      return;\n    }\n    if (!Array.isArray(args)) {\n      throw new Error(\"Command arguments are not an array\");\n    }\n    for (let i = 0; i < args.length; i++) {\n      const argEntry = args[i];\n      if (typeof argEntry === \"string\") {\n        continue;\n      }\n      if (Array.isArray(argEntry) && isStringArray(argEntry)) {\n        continue;\n      }\n      throw new Error(`Invalid arg entry at index: ${i}`);\n    }\n  }\n\n  get commandName(): string {\n    return this.#commandName;\n  }\n\n  /** For use with `bun`.\n   *\n   * Usage example:\n   *\n   * ```\n   * import { PrintableShellCommand } from \"printable-shell-command\";\n   * import { spawn } from \"bun\";\n   *\n   * const command = new PrintableShellCommand( \u2026 );\n   * await spawn(command.toFlatCommand()).exited;\n   * ```\n   */\n  public toFlatCommand(): string[] {\n    return [this.commandName, ...this.args.flat()];\n  }\n\n  /**\n   * Convenient alias for `toFlatCommand()`.\n   *\n   * Usage example:\n   *\n   * ```\n   * import { PrintableShellCommand } from \"printable-shell-command\";\n   * import { spawn } from \"bun\";\n   *\n   * const command = new PrintableShellCommand( \u2026 );\n   * await spawn(command.forBun()).exited;\n   * ```\n   *\n   * */\n  public forBun(): string[] {\n    return this.toFlatCommand();\n  }\n\n  /**\n   * For use with `node:child_process`\n   *\n   * Usage example:\n   *\n   * ```\n   * import { PrintableShellCommand } from \"printable-shell-command\";\n   * import { spawn } from \"node:child_process\";\n   *\n   * const command = new PrintableShellCommand( \u2026 );\n   * const child_process = spawn(...command.toCommandWithFlatArgs()); // Note the `...`\n   * ```\n   *\n   */\n  public toCommandWithFlatArgs(): [string, string[]] {\n    return [this.commandName, this.args.flat()];\n  }\n\n  /**\n   * For use with `node:child_process`\n   *\n   * Usage example:\n   *\n   * ```\n   * import { PrintableShellCommand } from \"printable-shell-command\";\n   * import { spawn } from \"node:child_process\";\n   *\n   * const command = new PrintableShellCommand( \u2026 );\n   * const child_process = spawn(...command.forNode()); // Note the `...`\n   * ```\n   *\n   * Convenient alias for `toCommandWithFlatArgs()`.\n   */\n  public forNode(): [string, string[]] {\n    return this.toCommandWithFlatArgs();\n  }\n\n  #escapeArg(\n    arg: string,\n    isMainCommand: boolean,\n    options: PrintOptions,\n  ): string {\n    const argCharacters = new Set(arg);\n    const specialShellCharacters = isMainCommand\n      ? SPECIAL_SHELL_CHARACTERS_FOR_MAIN_COMMAND\n      : SPECIAL_SHELL_CHARACTERS;\n    if (\n      options?.quoting === \"extra-safe\" ||\n      // biome-ignore lint/suspicious/noExplicitAny: Workaround to make this package easier to use in a project that otherwise only uses ES2022.)\n      (argCharacters as unknown as any).intersection(specialShellCharacters)\n        .size > 0\n    ) {\n      // Use single quote to reduce the need to escape (and therefore reduce the chance for bugs/security issues).\n      const escaped = arg.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll(\"'\", \"\\\\'\");\n      return `'${escaped}'`;\n    }\n    return arg;\n  }\n\n  #mainIndentation(options: PrintOptions): string {\n    return options?.mainIndentation ?? DEFAULT_MAIN_INDENTATION;\n  }\n\n  #argIndentation(options: PrintOptions): string {\n    return (\n      this.#mainIndentation(options) +\n      (options?.argIndentation ?? DEFAULT_ARG_INDENTATION)\n    );\n  }\n\n  #lineWrapSeparator(options: PrintOptions): string {\n    return LINE_WRAP_LINE_END + this.#argIndentation(options);\n  }\n\n  #argPairSeparator(options: PrintOptions): string {\n    switch (options?.argumentLineWrapping ?? DEFAULT_ARGUMENT_LINE_WRAPPING) {\n      case \"by-entry\": {\n        return INLINE_SEPARATOR;\n      }\n      case \"nested-by-entry\": {\n        return this.#lineWrapSeparator(options) + this.#argIndentation(options);\n      }\n      case \"by-argument\": {\n        return this.#lineWrapSeparator(options);\n      }\n      case \"inline\": {\n        return INLINE_SEPARATOR;\n      }\n      default:\n        throw new Error(\"Invalid argument line wrapping argument.\");\n    }\n  }\n\n  #intraEntrySeparator(options: PrintOptions): string {\n    switch (options?.argumentLineWrapping ?? DEFAULT_ARGUMENT_LINE_WRAPPING) {\n      case \"by-entry\":\n      case \"nested-by-entry\":\n      case \"by-argument\": {\n        return LINE_WRAP_LINE_END + this.#argIndentation(options);\n      }\n      case \"inline\": {\n        return INLINE_SEPARATOR;\n      }\n      default:\n        throw new Error(\"Invalid argument line wrapping argument.\");\n    }\n  }\n\n  #separatorAfterCommand(\n    options: PrintOptions,\n    numFollowingEntries: number,\n  ): string {\n    if (numFollowingEntries === 0) {\n      return \"\";\n    }\n    if (options.skipLineWrapBeforeFirstArg ?? false) {\n      return INLINE_SEPARATOR;\n    }\n    return this.#intraEntrySeparator(options);\n  }\n\n  public getPrintableCommand(options?: PrintOptions): string {\n    // TODO: Why in the world does TypeScript not give the `options` arg the type of `PrintOptions | undefined`???\n    options ??= {};\n    const serializedEntries: string[] = [];\n\n    for (let i = 0; i < this.args.length; i++) {\n      const argsEntry = this.args[i];\n\n      if (isString(argsEntry)) {\n        serializedEntries.push(this.#escapeArg(argsEntry, false, options));\n      } else {\n        serializedEntries.push(\n          argsEntry\n            .map((part) => this.#escapeArg(part, false, options))\n            .join(this.#argPairSeparator(options)),\n        );\n      }\n    }\n\n    let text =\n      this.#mainIndentation(options) +\n      this.#escapeArg(this.commandName, true, options) +\n      this.#separatorAfterCommand(options, serializedEntries.length) +\n      serializedEntries.join(this.#intraEntrySeparator(options));\n    if (options?.styleTextFormat) {\n      text = styleText(options.styleTextFormat, text);\n    }\n    return text;\n  }\n\n  public print(options?: PrintOptions): PrintableShellCommand {\n    console.log(this.getPrintableCommand(options));\n    return this;\n  }\n\n  /**\n   * The returned child process includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313\n   */\n  public spawn<\n    Stdin extends NodeStdioNull | NodeStdioPipe,\n    Stdout extends NodeStdioNull | NodeStdioPipe,\n    Stderr extends NodeStdioNull | NodeStdioPipe,\n  >(\n    options?:\n      | NodeSpawnOptions\n      | NodeSpawnOptionsWithoutStdio\n      | NodeSpawnOptionsWithStdioTuple<Stdin, Stdout, Stderr>,\n  ): // TODO: figure out how to return `ChildProcessByStdio<\u2026>` without duplicating fragile boilerplate.\n  NodeChildProcess & { success: Promise<void> } {\n    const { spawn } = process.getBuiltinModule(\"node:child_process\");\n    // biome-ignore lint/suspicious/noTsIgnore: We don't want linting to depend on *broken* type checking.\n    // @ts-ignore: The TypeScript checker has trouble reconciling the optional (i.e. potentially `undefined`) `options` with the third argument.\n    const subprocess = spawn(...this.forNode(), options) as NodeChildProcess & {\n      success: Promise<void>;\n    };\n    Object.defineProperty(subprocess, \"success\", {\n      get() {\n        return new Promise<void>((resolve, reject) =>\n          this.addListener(\n            \"exit\",\n            (exitCode: number /* we only use the first arg */) => {\n              if (exitCode === 0) {\n                resolve();\n              } else {\n                reject(`Command failed with non-zero exit code: ${exitCode}`);\n              }\n            },\n          ),\n        );\n      },\n      enumerable: false,\n    });\n    return subprocess;\n  }\n\n  /** A wrapper for `.spawnNode(\u2026)` that sets stdio to `\"inherit\"` (common for\n   * invoking commands from scripts whose output and interaction should be\n   * surfaced to the user). */\n  public spawnInherit(\n    options?: Omit<NodeSpawnOptions, \"stdio\">,\n  ): NodeChildProcess & { success: Promise<void> } {\n    if (options && \"stdio\" in options) {\n      throw new Error(\"Unexpected `stdio` field.\");\n    }\n    return this.spawn({ ...options, stdio: \"inherit\" });\n  }\n\n  public stdout(options?: Omit<NodeSpawnOptions, \"stdio\">): Response {\n    if (options && \"stdio\" in options) {\n      throw new Error(\"Unexpected `stdio` field.\");\n    }\n    const subprocess = this.spawn({\n      ...options,\n      stdio: [\"ignore\", \"pipe\", \"inherit\"],\n    });\n\n    // biome-ignore lint/style/noNonNullAssertion: dude\n    return new Response(Readable.toWeb(subprocess.stdout!));\n  }\n\n  /** Equivalent to:\n   *\n   * ```\n   * await this.print().spawnInherit(\u2026).success;\n   * ```\n   */\n  public async shellOut(\n    options?: Omit<NodeSpawnOptions, \"stdio\">,\n  ): Promise<void> {\n    await this.print().spawnInherit(options).success;\n  }\n\n  /**\n   * The returned subprocess includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313\n   */\n  #spawnBun<\n    const In extends BunSpawnOptions.Writable = \"ignore\",\n    const Out extends BunSpawnOptions.Readable = \"pipe\",\n    const Err extends BunSpawnOptions.Readable = \"inherit\",\n  >(\n    options?: Omit<BunSpawnOptions.OptionsObject<In, Out, Err>, \"cmd\">,\n  ): BunSubprocess<In, Out, Err> & { success: Promise<void> } {\n    if (options && \"cmd\" in options) {\n      throw new Error(\"Unexpected `cmd` field.\");\n    }\n    const { spawn } = process.getBuiltinModule(\"bun\") as typeof import(\"bun\");\n    const subprocess = spawn({\n      ...options,\n      cmd: this.forBun(),\n    }) as BunSubprocess<In, Out, Err> & { success: Promise<void> };\n    Object.defineProperty(subprocess, \"success\", {\n      get() {\n        return new Promise<void>((resolve, reject) =>\n          this.exited\n            .then((exitCode: number) => {\n              if (exitCode === 0) {\n                resolve();\n              } else {\n                reject(\n                  new Error(\n                    `Command failed with non-zero exit code: ${exitCode}`,\n                  ),\n                );\n              }\n            })\n            .catch(reject),\n        );\n      },\n      enumerable: false,\n    });\n    return subprocess;\n  }\n\n  #spawnBunInherit(\n    options?: Omit<\n      Omit<\n        BunSpawnOptions.OptionsObject<\"inherit\", \"inherit\", \"inherit\">,\n        \"cmd\"\n      >,\n      \"stdio\"\n    >,\n  ): BunSubprocess<\"inherit\", \"inherit\", \"inherit\"> & {\n    success: Promise<void>;\n  } {\n    if (options && \"stdio\" in options) {\n      throw new Error(\"Unexpected `stdio` field.\");\n    }\n    return this.bun.spawnBun({\n      ...options,\n      stdio: [\"inherit\", \"inherit\", \"inherit\"],\n    });\n  }\n\n  #spawnBunStdout(\n    options?: Omit<\n      Omit<\n        BunSpawnOptions.OptionsObject<\"inherit\", \"inherit\", \"inherit\">,\n        \"cmd\"\n      >,\n      \"stdio\"\n    >,\n  ): Response {\n    // biome-ignore lint/suspicious/noExplicitAny: Avoid breaking the lib check when used without `@types/bun`.\n    return new Response((this.bun.spawnBun(options) as any).stdout);\n  }\n\n  async #shellOutBun(\n    options?: Omit<\n      Omit<\n        BunSpawnOptions.OptionsObject<\"inherit\", \"inherit\", \"inherit\">,\n        \"cmd\"\n      >,\n      \"stdio\"\n    >,\n  ): Promise<void> {\n    await this.print().bun.spawnBunInherit(options).success;\n  }\n\n  bun = {\n    /** Equivalent to:\n     *\n     * ```\n     * await this.print().bun.spawnBunInherit(\u2026).success;\n     * ```\n     */\n    spawnBun: this.#spawnBun.bind(this),\n    /**\n     * A wrapper for `.spawnBunInherit(\u2026)` that sets stdio to `\"inherit\"` (common\n     * for invoking commands from scripts whose output and interaction should be\n     * surfaced to the user).\n     */\n    spawnBunInherit: this.#spawnBunInherit.bind(this),\n    /** Equivalent to:\n     *\n     * ```\n     * new Response(this.bun.spawnBun(\u2026).stdout);\n     * ```\n     */\n    spawnBunStdout: this.#spawnBunStdout.bind(this),\n    shellOutBun: this.#shellOutBun.bind(this),\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,13 +1,14 @@
 {
 	"name": "printable-shell-command",
-	"version": "1.2.0",
+	"version": "2.0.0",
 	"main": "./src/index.ts",
 	"devDependencies": {
 		"@biomejs/biome": "^2.1.4",
 		"@cubing/dev-config": "^0.3.6",
 		"@types/bun": "^1.2.20",
 		"@types/node": "^24.2.0",
-		"esbuild": "^0.25.5"
+		"esbuild": "^0.25.5",
+		"typescript": "^5.9.3"
 	},
 	"optionalDependencies": {
 		"@types/bun": "^1.2.20",

package/src/index.ts

@@ -6,6 +6,7 @@ import type {
   StdioNull as NodeStdioNull,
   StdioPipe as NodeStdioPipe,
 } from "node:child_process";
+import { Readable } from "node:stream";
 import { styleText } from "node:util";
 import type {
   SpawnOptions as BunSpawnOptions,
@@ -285,7 +286,7 @@ export class PrintableShellCommand {
       return "";
     }
     if (options.skipLineWrapBeforeFirstArg ?? false) {
-      return " ";
+      return INLINE_SEPARATOR;
     }
     return this.#intraEntrySeparator(options);
   }
@@ -328,7 +329,7 @@ export class PrintableShellCommand {
   /**
    * The returned child process includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313
    */
-  public spawnNode<
+  public spawn<
     Stdin extends NodeStdioNull | NodeStdioPipe,
     Stdout extends NodeStdioNull | NodeStdioPipe,
     Stderr extends NodeStdioNull | NodeStdioPipe,
@@ -340,6 +341,7 @@ export class PrintableShellCommand {
   ): // TODO: figure out how to return `ChildProcessByStdio<…>` without duplicating fragile boilerplate.
   NodeChildProcess & { success: Promise<void> } {
     const { spawn } = process.getBuiltinModule("node:child_process");
+    // biome-ignore lint/suspicious/noTsIgnore: We don't want linting to depend on *broken* type checking.
     // @ts-ignore: The TypeScript checker has trouble reconciling the optional (i.e. potentially `undefined`) `options` with the third argument.
     const subprocess = spawn(...this.forNode(), options) as NodeChildProcess & {
       success: Promise<void>;
@@ -367,31 +369,44 @@ export class PrintableShellCommand {
   /** A wrapper for `.spawnNode(…)` that sets stdio to `"inherit"` (common for
    * invoking commands from scripts whose output and interaction should be
    * surfaced to the user). */
-  public spawnNodeInherit(
+  public spawnInherit(
     options?: Omit<NodeSpawnOptions, "stdio">,
   ): NodeChildProcess & { success: Promise<void> } {
     if (options && "stdio" in options) {
       throw new Error("Unexpected `stdio` field.");
     }
-    return this.spawnNode({ ...options, stdio: "inherit" });
+    return this.spawn({ ...options, stdio: "inherit" });
+  }
+
+  public stdout(options?: Omit<NodeSpawnOptions, "stdio">): Response {
+    if (options && "stdio" in options) {
+      throw new Error("Unexpected `stdio` field.");
+    }
+    const subprocess = this.spawn({
+      ...options,
+      stdio: ["ignore", "pipe", "inherit"],
+    });
+
+    // biome-ignore lint/style/noNonNullAssertion: dude
+    return new Response(Readable.toWeb(subprocess.stdout!));
   }
 
   /** Equivalent to:
    *
    * ```
-   * await this.print().spawnNodeInherit(…).success;
+   * await this.print().spawnInherit(…).success;
    * ```
    */
-  public async shellOutNode(
+  public async shellOut(
     options?: Omit<NodeSpawnOptions, "stdio">,
   ): Promise<void> {
-    await this.print().spawnNodeInherit(options).success;
+    await this.print().spawnInherit(options).success;
   }
 
   /**
    * The returned subprocess includes a `.success` `Promise` field, per https://github.com/oven-sh/bun/issues/8313
    */
-  public spawnBun<
+  #spawnBun<
     const In extends BunSpawnOptions.Writable = "ignore",
     const Out extends BunSpawnOptions.Readable = "pipe",
     const Err extends BunSpawnOptions.Readable = "inherit",
@@ -429,12 +444,7 @@ export class PrintableShellCommand {
     return subprocess;
   }
 
-  /**
-   * A wrapper for `.spawnBunInherit(…)` that sets stdio to `"inherit"` (common
-   * for invoking commands from scripts whose output and interaction should be
-   * surfaced to the user).
-   */
-  public spawnBunInherit(
+  #spawnBunInherit(
     options?: Omit<
       Omit<
         BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">,
@@ -448,19 +458,13 @@ export class PrintableShellCommand {
     if (options && "stdio" in options) {
       throw new Error("Unexpected `stdio` field.");
     }
-    return this.spawnBun({
+    return this.bun.spawnBun({
       ...options,
       stdio: ["inherit", "inherit", "inherit"],
     });
   }
 
-  /** Equivalent to:
-   *
-   * ```
-   * new Response(this.spawnBun(…).stdout);
-   * ```
-   */
-  public spawnBunStdout(
+  #spawnBunStdout(
     options?: Omit<
       Omit<
         BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">,
@@ -470,16 +474,10 @@ export class PrintableShellCommand {
     >,
   ): Response {
     // biome-ignore lint/suspicious/noExplicitAny: Avoid breaking the lib check when used without `@types/bun`.
-    return new Response((this.spawnBun(options) as any).stdout);
+    return new Response((this.bun.spawnBun(options) as any).stdout);
   }
 
-  /** Equivalent to:
-   *
-   * ```
-   * await this.print().spawnBunInherit(…).success;
-   * ```
-   */
-  public async shellOutBun(
+  async #shellOutBun(
     options?: Omit<
       Omit<
         BunSpawnOptions.OptionsObject<"inherit", "inherit", "inherit">,
@@ -488,6 +486,30 @@ export class PrintableShellCommand {
       "stdio"
     >,
   ): Promise<void> {
-    await this.print().spawnBunInherit(options).success;
+    await this.print().bun.spawnBunInherit(options).success;
   }
+
+  bun = {
+    /** Equivalent to:
+     *
+     * ```
+     * await this.print().bun.spawnBunInherit(…).success;
+     * ```
+     */
+    spawnBun: this.#spawnBun.bind(this),
+    /**
+     * A wrapper for `.spawnBunInherit(…)` that sets stdio to `"inherit"` (common
+     * for invoking commands from scripts whose output and interaction should be
+     * surfaced to the user).
+     */
+    spawnBunInherit: this.#spawnBunInherit.bind(this),
+    /** Equivalent to:
+     *
+     * ```
+     * new Response(this.bun.spawnBun(…).stdout);
+     * ```
+     */
+    spawnBunStdout: this.#spawnBunStdout.bind(this),
+    shellOutBun: this.#shellOutBun.bind(this),
+  };
 }