bun-workspaces 1.0.0-alpha.37 → 1.0.0-alpha.39

package/README.md

@@ -67,6 +67,13 @@ bw run lint my-alias-a my-alias-b # Run by alias (set by optional config)
 bw run lint "my-workspace-*" # Run for matching workspace names
 bw run lint "alias:my-alias-pattern-*" "path:my-glob/**/*" # Use matching specifiers
 
+# A workspace's script will wait until any workspaces it depends on have completed
+# Similar to Bun's --filter behavior
+bw run lint --dep-order
+
+# Continue running scripts even if a dependency fails
+bw run lint --dep-order --ignore-dep-failure
+
 bw run lint --args="--my-appended-args" # Add args to each script call
 bw run lint --args="--my-arg=<workspaceName>" # Use the workspace name in args
 
@@ -75,6 +82,19 @@ bw run "bun build" --inline # Run an inline command via the Bun shell
 bw run lint --parallel # Run in parallel (default: "auto", the available CPU count)
 bw run lint --parallel=2 # Run in parallel with a max of 2 concurrent scripts
 
+# Use the grouped output style (default when on a TTY)
+bw run my-script --output-style=grouped
+
+# Set the max preview lines for script output in grouped output style
+bw run my-script --output-style=grouped --grouped-lines=all
+bw run my-script --output-style=grouped --grouped-lines=10
+
+# Use simple script output with workspace prefixes (default when not on a TTY)
+bw run my-script --output-style=prefixed
+
+# Use the plain output style (no workspace prefixes)
+bw run my-script --output-style=plain
+
 # Show usage (you can pass --help to any command)
 bw help
 bw --help
@@ -154,6 +174,19 @@ const runManyScripts = async () => {
 
     // Optional. Whether to run the scripts in parallel
     parallel: true,
+
+    // Optional. When true, a workspace's script will wait
+    // until any workspaces it depends on have completed
+    dependencyOrder: false,
+
+    // Optional. When true and dependencyOrder is true,
+    // continue running scripts even if a dependency fails
+    ignoreDependencyFailure: false,
+
+    // Optional, callback when script starts, skips, or exits
+    onScriptEvent: (event, { workspace, exitResult }) => {
+      // event: "start", "skip", "exit"
+    },
   });
 
   // Get a stream of script output

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-workspaces",
-  "version": "1.0.0-alpha.37",
+  "version": "1.0.0-alpha.39",
   "description": "A monorepo management tool for Bun, with a CLI and API to enhance Bun's native workspaces.",
   "license": "MIT",
   "main": "src/index.mjs",

package/src/cli/commands/commandHandlerUtils.mjs

@@ -1,8 +1,8 @@
 import { Option } from "commander";
-import { BunWorkspacesError } from "../../internal/core/index.mjs";
+import { BunWorkspacesError } from "../../internal/core/error/index.mjs";
 import { createLogger, logger } from "../../internal/logger/index.mjs";
 import { getCliCommandConfig } from "./commandsConfig.mjs"; // CONCATENATED MODULE: external "commander"
-// CONCATENATED MODULE: external "../../internal/core/index.mjs"
+// CONCATENATED MODULE: external "../../internal/core/error/index.mjs"
 // CONCATENATED MODULE: external "../../internal/logger/index.mjs"
 // CONCATENATED MODULE: external "./commandsConfig.mjs"
 // CONCATENATED MODULE: ./src/cli/commands/commandHandlerUtils.ts

package/src/cli/commands/commandsConfig.d.ts

@@ -9,6 +9,7 @@ export interface CliCommandConfig {
       flags: string[] | readonly string[];
       description: string;
       values?: string[];
+      deprecated?: boolean;
     }
   >;
 }
@@ -25,6 +26,7 @@ export type CliProjectCommandName = Exclude<
   CliGlobalCommandName
 >;
 export declare const JSON_FLAGS: readonly ["-j", "--json"];
+export declare const DEFAULT_GROUPED_LINES = 20;
 export declare const CLI_COMMANDS_CONFIG: {
   readonly doctor: {
     readonly command: "doctor";
@@ -144,9 +146,19 @@ export declare const CLI_COMMANDS_CONFIG: {
         readonly flags: ["-a", "--args <args>"];
         readonly description: "Args to append to the script command";
       };
+      readonly outputStyle: {
+        readonly flags: ["-o", "--output-style <style>"];
+        readonly description: "The output style to use";
+        readonly values: ["grouped", "prefixed", "plain"];
+      };
+      readonly groupedLines: {
+        readonly flags: ["-L", "--grouped-lines <count>"];
+        readonly description: 'With "grouped" output, the max preview lines (number or "all", default 20)';
+      };
       readonly noPrefix: {
         readonly flags: ["-N", "--no-prefix"];
-        readonly description: "Do not prefix the workspace name to the script output";
+        readonly description: "(DEPRECATED) Use --output-style=plain instead";
+        readonly deprecated: true;
       };
       readonly inline: {
         readonly flags: ["-i", "--inline"];
@@ -161,6 +173,14 @@ export declare const CLI_COMMANDS_CONFIG: {
         readonly values: ["bun", "system", "default"];
         readonly description: "When using --inline, the shell to use to run the script";
       };
+      readonly depOrder: {
+        readonly flags: ["-d", "--dep-order"];
+        readonly description: "Scripts for dependent workspaces run only after their dependencies";
+      };
+      readonly ignoreDepFailure: {
+        readonly flags: ["-f", "--ignore-dep-failure"];
+        readonly description: "In dependency order, continue running scripts even if a dependency fails";
+      };
       readonly jsonOutfile: {
         readonly flags: ["-j", "--json-outfile <file>"];
         readonly description: "Output results in a JSON file";
@@ -287,9 +307,19 @@ export declare const getCliCommandConfig: (commandName: CliCommandName) =>
           readonly flags: ["-a", "--args <args>"];
           readonly description: "Args to append to the script command";
         };
+        readonly outputStyle: {
+          readonly flags: ["-o", "--output-style <style>"];
+          readonly description: "The output style to use";
+          readonly values: ["grouped", "prefixed", "plain"];
+        };
+        readonly groupedLines: {
+          readonly flags: ["-L", "--grouped-lines <count>"];
+          readonly description: 'With "grouped" output, the max preview lines (number or "all", default 20)';
+        };
         readonly noPrefix: {
           readonly flags: ["-N", "--no-prefix"];
-          readonly description: "Do not prefix the workspace name to the script output";
+          readonly description: "(DEPRECATED) Use --output-style=plain instead";
+          readonly deprecated: true;
         };
         readonly inline: {
           readonly flags: ["-i", "--inline"];
@@ -304,6 +334,14 @@ export declare const getCliCommandConfig: (commandName: CliCommandName) =>
           readonly values: ["bun", "system", "default"];
           readonly description: "When using --inline, the shell to use to run the script";
         };
+        readonly depOrder: {
+          readonly flags: ["-d", "--dep-order"];
+          readonly description: "Scripts for dependent workspaces run only after their dependencies";
+        };
+        readonly ignoreDepFailure: {
+          readonly flags: ["-f", "--ignore-dep-failure"];
+          readonly description: "In dependency order, continue running scripts even if a dependency fails";
+        };
         readonly jsonOutfile: {
           readonly flags: ["-j", "--json-outfile <file>"];
           readonly description: "Output results in a JSON file";

package/src/cli/commands/commandsConfig.mjs

@@ -1,7 +1,10 @@
-import { SCRIPT_SHELL_OPTIONS } from "../../runScript/scriptShellOption.mjs"; // CONCATENATED MODULE: external "../../runScript/scriptShellOption.mjs"
+import { SCRIPT_SHELL_OPTIONS } from "../../runScript/scriptShellOption.mjs";
+import { OUTPUT_STYLE_VALUES } from "./runScript/output/outputStyle.mjs"; // CONCATENATED MODULE: external "../../runScript/scriptShellOption.mjs"
+// CONCATENATED MODULE: external "./runScript/output/outputStyle.mjs"
 // CONCATENATED MODULE: ./src/cli/commands/commandsConfig.ts
 
 const JSON_FLAGS = ["-j", "--json"];
+const DEFAULT_GROUPED_LINES = 20;
 const CLI_COMMANDS_CONFIG = {
   doctor: {
     command: "doctor",
@@ -123,9 +126,19 @@ const CLI_COMMANDS_CONFIG = {
         flags: ["-a", "--args <args>"],
         description: "Args to append to the script command",
       },
+      outputStyle: {
+        flags: ["-o", "--output-style <style>"],
+        description: "The output style to use",
+        values: [...OUTPUT_STYLE_VALUES],
+      },
+      groupedLines: {
+        flags: ["-L", "--grouped-lines <count>"],
+        description: `With "grouped" output, the max preview lines (number or "all", default ${DEFAULT_GROUPED_LINES})`,
+      },
       noPrefix: {
         flags: ["-N", "--no-prefix"],
-        description: "Do not prefix the workspace name to the script output",
+        description: "(DEPRECATED) Use --output-style=plain instead",
+        deprecated: true,
       },
       inline: {
         flags: ["-i", "--inline"],
@@ -141,6 +154,16 @@ const CLI_COMMANDS_CONFIG = {
         values: [...SCRIPT_SHELL_OPTIONS, "default"],
         description: `When using --inline, the shell to use to run the script`,
       },
+      depOrder: {
+        flags: ["-d", "--dep-order"],
+        description:
+          "Scripts for dependent workspaces run only after their dependencies",
+      },
+      ignoreDepFailure: {
+        flags: ["-f", "--ignore-dep-failure"],
+        description:
+          "In dependency order, continue running scripts even if a dependency fails",
+      },
       jsonOutfile: {
         flags: ["-j", "--json-outfile <file>"],
         description: "Output results in a JSON file",
@@ -153,6 +176,7 @@ const getCliCommandNames = () => Object.keys(CLI_COMMANDS_CONFIG);
 
 export {
   CLI_COMMANDS_CONFIG,
+  DEFAULT_GROUPED_LINES,
   JSON_FLAGS,
   getCliCommandConfig,
   getCliCommandNames,

package/src/cli/commands/runScript/handleRunScript.mjs

@@ -5,11 +5,24 @@ import {
   handleProjectCommand,
   splitWorkspacePatterns,
 } from "../commandHandlerUtils.mjs";
-import { formatRunScriptOutput } from "./formatRunScriptOutput.mjs"; // CONCATENATED MODULE: external "fs"
+import { DEFAULT_GROUPED_LINES } from "../commandsConfig.mjs";
+import {
+  getDefaultOutputStyle,
+  validateOutputStyle,
+} from "./output/outputStyle.mjs";
+import {
+  createScriptEvent,
+  createScriptEventTarget,
+  renderGroupedOutput,
+} from "./output/renderGroupedOutput.mjs";
+import { renderPlainOutput } from "./output/renderPlainOutput.mjs"; // CONCATENATED MODULE: external "fs"
 // CONCATENATED MODULE: external "path"
 // CONCATENATED MODULE: external "../../../internal/logger/index.mjs"
 // CONCATENATED MODULE: external "../commandHandlerUtils.mjs"
-// CONCATENATED MODULE: external "./formatRunScriptOutput.mjs"
+// CONCATENATED MODULE: external "../commandsConfig.mjs"
+// CONCATENATED MODULE: external "./output/outputStyle.mjs"
+// CONCATENATED MODULE: external "./output/renderGroupedOutput.mjs"
+// CONCATENATED MODULE: external "./output/renderPlainOutput.mjs"
 // CONCATENATED MODULE: ./src/cli/commands/runScript/handleRunScript.ts
 
 const runScript = handleProjectCommand(
@@ -53,6 +66,12 @@ const runScript = handleProjectCommand(
     logger.debug(
       `Command: Run script ${JSON.stringify(script)} for ${workspacePatterns.length ? "workspaces " + workspacePatterns.join(", ") : "all workspaces"} (parallel: ${!!options.parallel}, args: ${JSON.stringify(scriptArgs)})`,
     );
+    const workspaces = workspacePatterns.length
+      ? project.findWorkspacesByPattern(...workspacePatterns)
+      : options.inline
+        ? project.workspaces
+        : project.listWorkspacesWithScript(script);
+    const scriptEventTarget = createScriptEventTarget();
     const { output, summary } = project.runScriptAcrossWorkspaces({
       workspacePatterns: workspacePatterns.length
         ? workspacePatterns
@@ -67,6 +86,17 @@ const runScript = handleProjectCommand(
           : true
         : undefined,
       args: scriptArgs,
+      dependencyOrder: options.depOrder,
+      ignoreDependencyFailure: options.ignoreDepFailure,
+      ignoreOutput: logger.printLevel === "silent",
+      onScriptEvent: (event, { workspace, exitResult }) => {
+        scriptEventTarget.dispatchEvent(
+          createScriptEvent[event]({
+            workspace,
+            exitResult,
+          }),
+        );
+      },
       parallel:
         typeof options.parallel === "boolean" ||
         typeof options.parallel === "undefined"
@@ -82,31 +112,77 @@ const runScript = handleProjectCommand(
     const scriptName = options.inline
       ? options.inlineName || "(inline)"
       : script;
-    const handleOutput = async () => {
-      if (logger.printLevel === "silent") return;
-      for await (const { line, metadata } of formatRunScriptOutput(output, {
-        prefix: options.prefix,
-        scriptName,
-      })) {
-        process[metadata.streamName].write(line);
+    const stripDisruptiveControls = workspaces.length > 1 || !!options.parallel;
+    let groupedLines = DEFAULT_GROUPED_LINES;
+    if (options.groupedLines) {
+      if (options.groupedLines === "all") {
+        groupedLines = "all";
+      } else {
+        const parsedGroupedLines = parseInt(options.groupedLines);
+        if (parsedGroupedLines <= 0 || isNaN(parsedGroupedLines)) {
+          logger.error(
+            `Invalid max grouped lines value: ${options.groupedLines}. Must be a positive number or "all".`,
+          );
+          process.exit(1);
+        }
+        groupedLines = parsedGroupedLines;
       }
+    }
+    if (!options.prefix) {
+      logger.warn(
+        "--no-prefix is deprecated and will be removed in a future version. Use --output-style=plain instead.",
+      );
+    }
+    const outputStyleHandlers = {
+      grouped: () =>
+        renderGroupedOutput(
+          workspaces,
+          output,
+          summary,
+          scriptEventTarget,
+          groupedLines,
+        ),
+      prefixed: () =>
+        renderPlainOutput(output, {
+          prefix: true,
+          stripDisruptiveControls,
+        }),
+      plain: () =>
+        renderPlainOutput(output, {
+          prefix: false,
+          stripDisruptiveControls,
+        }),
     };
-    handleOutput();
+    const outputStyle = options.outputStyle
+      ? validateOutputStyle(options.outputStyle)
+      : getDefaultOutputStyle();
+    await outputStyleHandlers[outputStyle]();
     const exitResults = await summary;
     exitResults.scriptResults.forEach(
       ({ success, metadata: { workspace }, exitCode }) => {
-        logger.info(
-          `${success ? "✅" : "❌"} ${workspace.name}: ${scriptName}${exitCode ? ` (exited with code ${exitCode})` : ""}`,
-        );
+        const isSkipped = exitCode === -1;
+        if (isSkipped) {
+          logger.info(
+            `➖ ${workspace.name}: ${scriptName} (skipped due to dependency failure)`,
+          );
+        } else {
+          logger.info(
+            `${success ? "✅" : "❌"} ${workspace.name}: ${scriptName}${exitCode ? ` (exited with code ${exitCode})` : ""}`,
+          );
+        }
       },
     );
     const s = exitResults.scriptResults.length === 1 ? "" : "s";
+    const skippedCount = exitResults.scriptResults.filter(
+      ({ exitCode }) => exitCode === -1,
+    ).length;
+    const skippedMessage = skippedCount ? ` (${skippedCount} skipped)` : "";
     if (exitResults.failureCount) {
-      const message = `${exitResults.failureCount} of ${exitResults.scriptResults.length} script${s} failed`;
+      const message = `${exitResults.failureCount} of ${exitResults.scriptResults.length} script${s} failed${skippedMessage}`;
       logger.info(message);
     } else {
       logger.info(
-        `${exitResults.scriptResults.length} script${s} ran successfully`,
+        `${exitResults.scriptResults.length} script${s} ran successfully${skippedMessage}`,
       );
     }
     if (options.jsonOutfile) {
@@ -155,6 +231,8 @@ const runScript = handleProjectCommand(
     }
     if (exitResults.failureCount) {
       process.exit(1);
+    } else {
+      process.exit(0);
     }
   },
 );

package/src/cli/commands/runScript/index.d.ts

@@ -1,2 +1,2 @@
 export * from "./handleRunScript";
-export * from "./formatRunScriptOutput";
+export * from "./output/renderPlainOutput";

package/src/cli/commands/runScript/index.mjs

@@ -1,2 +1,2 @@
 export * from "./handleRunScript.mjs";
-export * from "./formatRunScriptOutput.mjs"; // CONCATENATED MODULE: ./src/cli/commands/runScript/index.ts
+export * from "./output/renderPlainOutput.mjs"; // CONCATENATED MODULE: ./src/cli/commands/runScript/index.ts

package/src/cli/commands/runScript/output/index.d.ts

@@ -0,0 +1 @@
+export * from "./renderPlainOutput";

package/src/cli/commands/runScript/output/index.mjs

@@ -0,0 +1 @@
+export * from "./renderPlainOutput.mjs"; // CONCATENATED MODULE: ./src/cli/commands/runScript/output/index.ts

package/src/cli/commands/runScript/output/outputStyle.d.ts

@@ -0,0 +1,8 @@
+export declare const OUTPUT_STYLE_VALUES: readonly [
+  "grouped",
+  "prefixed",
+  "plain",
+];
+export type OutputStyleName = (typeof OUTPUT_STYLE_VALUES)[number];
+export declare const getDefaultOutputStyle: () => OutputStyleName;
+export declare const validateOutputStyle: (style: string) => OutputStyleName;

package/src/cli/commands/runScript/output/outputStyle.mjs

@@ -0,0 +1,17 @@
+import { BunWorkspacesError } from "../../../../internal/core/error/index.mjs";
+import { IS_TTY } from "../../../../internal/core/runtime/terminal.mjs"; // CONCATENATED MODULE: external "../../../../internal/core/error/index.mjs"
+// CONCATENATED MODULE: external "../../../../internal/core/runtime/terminal.mjs"
+// CONCATENATED MODULE: ./src/cli/commands/runScript/output/outputStyle.ts
+
+const OUTPUT_STYLE_VALUES = ["grouped", "prefixed", "plain"];
+const getDefaultOutputStyle = () => (IS_TTY ? "grouped" : "prefixed");
+const validateOutputStyle = (style) => {
+  if (!OUTPUT_STYLE_VALUES.includes(style)) {
+    throw new BunWorkspacesError(
+      `Invalid output style: "${style}" (accepted values: ${OUTPUT_STYLE_VALUES.join(", ")})`,
+    );
+  }
+  return style;
+};
+
+export { OUTPUT_STYLE_VALUES, getDefaultOutputStyle, validateOutputStyle };

package/src/cli/commands/runScript/output/renderGroupedOutput.d.ts

@@ -0,0 +1,71 @@
+import {
+  type TypedEvent,
+  TypedEventTarget,
+} from "../../../../internal/core/language/events/typedEventTarget";
+import type {
+  RunScriptAcrossWorkspacesProcessOutput,
+  RunWorkspaceScriptMetadata,
+} from "../../../../project";
+import type {
+  RunScriptExit,
+  RunScriptsSummary,
+  ScriptEventName,
+} from "../../../../runScript";
+import type { Workspace } from "../../../../workspaces";
+type ScriptEvent = TypedEvent<
+  ScriptEventName,
+  {
+    workspace: Workspace;
+    exitResult: RunScriptExit<RunWorkspaceScriptMetadata> | null;
+  }
+>;
+declare class ScriptEventTarget extends TypedEventTarget<{
+  [key in ScriptEvent["type"]]: ScriptEvent;
+}> {}
+export declare const createScriptEventTarget: () => ScriptEventTarget;
+export declare const createScriptEvent: {
+  start: (
+    properties: Omit<
+      {
+        type: ScriptEventName;
+      } & {
+        workspace: Workspace;
+        exitResult: RunScriptExit<RunWorkspaceScriptMetadata> | null;
+      },
+      "type"
+    >,
+    options?: EventInit,
+  ) => ScriptEvent;
+  skip: (
+    properties: Omit<
+      {
+        type: ScriptEventName;
+      } & {
+        workspace: Workspace;
+        exitResult: RunScriptExit<RunWorkspaceScriptMetadata> | null;
+      },
+      "type"
+    >,
+    options?: EventInit,
+  ) => ScriptEvent;
+  exit: (
+    properties: Omit<
+      {
+        type: ScriptEventName;
+      } & {
+        workspace: Workspace;
+        exitResult: RunScriptExit<RunWorkspaceScriptMetadata> | null;
+      },
+      "type"
+    >,
+    options?: EventInit,
+  ) => ScriptEvent;
+};
+export declare const renderGroupedOutput: (
+  workspaces: Workspace[],
+  output: RunScriptAcrossWorkspacesProcessOutput,
+  summary: Promise<RunScriptsSummary<RunWorkspaceScriptMetadata>>,
+  scriptEventTarget: ScriptEventTarget,
+  activeScriptLines: number | "all",
+) => Promise<void>;
+export {};