bun-workspaces 1.0.2 → 1.1.0

package/README.md

@@ -10,7 +10,7 @@ A CLI and API to enhance your monorepo development with Bun's [native workspaces
 
 - Works right away, with no boilerplate required 🍔🍴
 - Get metadata about your monorepo 🤖
-- Run package.json scripts across workspaces 📋
+- Orchestrate your workspaces' `package.json` scripts 📋
 - Run inline [Bun Shell](https://bun.com/docs/runtime/shell) scripts in workspaces 🐚
 
 This is a tool to help manage a Bun monorepo, offering features beyond what [Bun's --filter feature](https://bun.com/docs/pm/filter) can do. It can be used to get a variety of metadata about your project and run scripts across your workspaces with advanced control.
@@ -84,6 +84,7 @@ bw run "bun build" --inline # Run an inline command via the Bun shell
 bw run lint --parallel=false # Run in series
 bw run lint --parallel=2 # Run in parallel with a max of 2 concurrent scripts
 bw run lint --parallel=auto # Default, based on number of available logical CPUs
+bw run lint --parallel=50% # Run in parallel with a max of 50% of the "auto" limit
 
 # Use the grouped output style (default when on a TTY)
 bw run my-script --output-style=grouped

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-workspaces",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "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/createCli.mjs

@@ -93,7 +93,6 @@ const createCli = ({ defaultCwd = process.cwd(), defaultMiddleware } = {}) => {
       const { project, projectError } = initializeWithGlobalOptions(
         program,
         args,
-        defaultCwd,
         middleware,
       );
       middleware.findProject({

package/src/cli/globalOptions/globalOptions.d.ts

@@ -3,7 +3,6 @@ import type { CliMiddleware } from "../middleware";
 export declare const initializeWithGlobalOptions: (
   program: Command,
   args: string[],
-  defaultCwd: string,
   middleware: CliMiddleware,
 ) => {
   project: import("../../internal/core").Simplify<{

package/src/cli/globalOptions/globalOptions.mjs

@@ -19,6 +19,8 @@ import { getCliGlobalOptionConfig } from "./globalOptionsConfig.mjs"; // CONCATE
 const ERRORS = defineErrors(
   "WorkingDirectoryNotFound",
   "WorkingDirectoryNotADirectory",
+  "NoCwdAndWorkspaceRoot",
+  "ProjectRootNotFound",
 );
 const addGlobalOption = (program, optionName, defaultOverride) => {
   const { mainOption, shortOption, description, param, values, defaultValue } =
@@ -42,13 +44,54 @@ const addGlobalOption = (program, optionName, defaultOverride) => {
     );
   }
 };
-const getWorkingDirectoryFromArgs = (program, args, defaultCwd) => {
-  addGlobalOption(program, "cwd", defaultCwd);
+const getWorkingDirectoryFromArgs = (program, args) => {
+  addGlobalOption(program, "cwd");
+  addGlobalOption(program, "workspaceRoot");
   program.parseOptions(args);
-  return program.opts().cwd;
+  const { cwd, workspaceRoot } = program.opts();
+  if (cwd && workspaceRoot) {
+    throw new ERRORS.NoCwdAndWorkspaceRoot(
+      `Cannot use both ${getCliGlobalOptionConfig("cwd").mainOption} (${getCliGlobalOptionConfig("cwd").shortOption}) and ${getCliGlobalOptionConfig("workspaceRoot").mainOption} (${getCliGlobalOptionConfig("workspaceRoot").shortOption}) options together`,
+    );
+  }
+  return {
+    cwdOption: cwd,
+    workspaceRootOption: workspaceRoot,
+  };
 };
-const defineGlobalOptions = (program, args, defaultCwd, middleware) => {
-  const cwd = getWorkingDirectoryFromArgs(program, args, defaultCwd);
+const findRootFromCwd = () => {
+  let currentDirectory = process.cwd();
+  while (true) {
+    const packageJsonPath = path.join(currentDirectory, "package.json");
+    if (fs.existsSync(packageJsonPath)) {
+      try {
+        const packageJsonContent = JSON.parse(
+          fs.readFileSync(packageJsonPath, "utf8"),
+        );
+        if (packageJsonContent.workspaces) {
+          return currentDirectory;
+        }
+      } catch {
+        continue;
+      }
+    }
+    const parentDirectory = path.dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      break;
+    }
+    currentDirectory = parentDirectory;
+  }
+  throw new ERRORS.ProjectRootNotFound(
+    `${getCliGlobalOptionConfig("workspaceRoot").shortOption}|${getCliGlobalOptionConfig("workspaceRoot").mainOption} option: Project root not found from current working directory "${process.cwd()}"`,
+  );
+};
+const defineGlobalOptions = (program, args, middleware) => {
+  const { cwdOption, workspaceRootOption } = getWorkingDirectoryFromArgs(
+    program,
+    args,
+  );
+  const cwd =
+    cwdOption || (workspaceRootOption ? findRootFromCwd() : process.cwd());
   const exists = fs.existsSync(cwd);
   const isDirectory = exists ? fs.statSync(cwd).isDirectory() : false;
   middleware.processWorkingDirectory({
@@ -98,9 +141,9 @@ const applyGlobalOptions = (options) => {
     projectError: error,
   };
 };
-const initializeWithGlobalOptions = (program, args, defaultCwd, middleware) => {
+const initializeWithGlobalOptions = (program, args, middleware) => {
   program.allowUnknownOption(true);
-  const { cwd } = defineGlobalOptions(program, args, defaultCwd, middleware);
+  const { cwd } = defineGlobalOptions(program, args, middleware);
   program.parseOptions(args);
   program.allowUnknownOption(false);
   const options = program.opts();

package/src/cli/globalOptions/globalOptionsConfig.d.ts

@@ -3,6 +3,7 @@ export interface CliGlobalOptions {
   logLevel: LogLevelSetting;
   cwd: string;
   includeRoot: boolean;
+  workspaceRoot: boolean;
 }
 export interface CliGlobalOptionConfig {
   mainOption: string;
@@ -28,7 +29,7 @@ export declare const getCliGlobalOptionConfig: (
       readonly mainOption: "--cwd";
       readonly shortOption: "-d";
       readonly description: "Working directory";
-      readonly defaultValue: ".";
+      readonly defaultValue: "";
       readonly values: null;
       readonly param: "path";
     }
@@ -39,5 +40,13 @@ export declare const getCliGlobalOptionConfig: (
       readonly defaultValue: "";
       readonly values: null;
       readonly param: "";
+    }
+  | {
+      readonly mainOption: "--workspace-root";
+      readonly shortOption: "-w";
+      readonly description: "Run from the project root above the current working directory";
+      readonly defaultValue: "";
+      readonly values: null;
+      readonly param: "";
     };
 export declare const getCliGlobalOptionNames: () => CliGlobalOptionName[];

package/src/cli/globalOptions/globalOptionsConfig.mjs

@@ -14,7 +14,7 @@ const CLI_GLOBAL_OPTIONS_CONFIG = {
     mainOption: "--cwd",
     shortOption: "-d",
     description: "Working directory",
-    defaultValue: ".",
+    defaultValue: "",
     values: null,
     param: "path",
   },
@@ -26,6 +26,15 @@ const CLI_GLOBAL_OPTIONS_CONFIG = {
     values: null,
     param: "",
   },
+  workspaceRoot: {
+    mainOption: "--workspace-root",
+    shortOption: "-w",
+    description:
+      "Run from the project root above the current working directory",
+    defaultValue: "",
+    values: null,
+    param: "",
+  },
 };
 const getCliGlobalOptionConfig = (optionName) =>
   CLI_GLOBAL_OPTIONS_CONFIG[optionName];

package/src/internal/core/runtime/os.d.ts

@@ -1,4 +1,4 @@
 export declare const IS_WINDOWS: boolean;
 export declare const IS_MACOS: boolean;
 export declare const IS_LINUX: boolean;
-export declare const IS_UNIX: boolean;
+export declare const IS_POSIX: boolean;

package/src/internal/core/runtime/os.mjs

@@ -2,6 +2,6 @@
 const IS_WINDOWS = process.platform === "win32";
 const IS_MACOS = process.platform === "darwin";
 const IS_LINUX = process.platform === "linux";
-const IS_UNIX = IS_MACOS || IS_LINUX;
+const IS_POSIX = IS_MACOS || IS_LINUX;
 
-export { IS_LINUX, IS_MACOS, IS_UNIX, IS_WINDOWS };
+export { IS_LINUX, IS_MACOS, IS_POSIX, IS_WINDOWS };