bun-workspaces 1.3.0 → 1.4.0

package/README.md

@@ -80,7 +80,7 @@ bw run lint --dep-order
 bw run lint --dep-order --ignore-dep-failure
 
 bw run lint "my-workspace-*" # Run for matching workspace names
-bw run lint "alias:my-alias-pattern-*" "path:my-glob/**/*" # Use matching specifiers
+bw run lint "alias:my-alias-*" "path:my-glob/**/*" "tag:my-tag" # Use matching specifiers
 
 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
@@ -106,6 +106,9 @@ bw run my-script --output-style=prefixed
 # Use the plain output style (no workspace prefixes)
 bw run my-script --output-style=plain
 
+# Silence all output of the run command
+bw --log-level=silent run my-script --output-style=none
+
 # Show usage (you can pass --help to any command)
 bw help
 bw --help
@@ -118,7 +121,7 @@ bw --cwd=/path/to/your/project ls
 bw --cwd=/path/to/your/project run my-script
 
 # Pass --log-level to any command (debug, info, warn, error, or silent)
-bw --log-level=silent run my-script
+bw --log-level=debug ls
 ```
 
 ### API

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-workspaces",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "A monorepo management tool for Bun, with a CLI and API to enhance Bun's native workspaces.",
   "license": "MIT",
   "exports": {

package/src/cli/commands/commandHandlerUtils.mjs

@@ -19,6 +19,7 @@ const createWorkspaceInfoLines = (workspace) => [
   ` - Path: ${workspace.path}`,
   ` - Glob Match: ${workspace.matchPattern}`,
   ` - Scripts: ${workspace.scripts.join(", ")}`,
+  ` - Tags: ${workspace.tags.join(", ")}`,
   ` - Dependencies: ${workspace.dependencies.join(", ")}`,
   ` - Dependents: ${workspace.dependents.join(", ")}`,
 ];

package/src/cli/commands/commands.mjs

@@ -1,8 +1,10 @@
 import {
   doctor,
   listScripts,
+  listTags,
   listWorkspaces,
   scriptInfo,
+  tagInfo,
   workspaceInfo,
 } from "./handleSimpleCommands.mjs";
 import { runScript } from "./runScript/index.mjs"; // CONCATENATED MODULE: external "./handleSimpleCommands.mjs"
@@ -17,6 +19,8 @@ const defineProjectCommands = (context) => {
   listScripts(context);
   workspaceInfo(context);
   scriptInfo(context);
+  listTags(context);
+  tagInfo(context);
   runScript(context);
 };
 

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

@@ -123,6 +123,42 @@ export declare const CLI_COMMANDS_CONFIG: {
       };
     };
   };
+  readonly listTags: {
+    readonly command: "list-tags";
+    readonly isGlobal: false;
+    readonly aliases: ["ls-tags"];
+    readonly description: "List all tags available with their workspaces";
+    readonly options: {
+      readonly nameOnly: {
+        readonly flags: ["-n", "--name-only"];
+        readonly description: "Only show tag names";
+      };
+      readonly json: {
+        readonly flags: readonly ["-j", "--json"];
+        readonly description: "Output as JSON";
+      };
+      readonly pretty: {
+        readonly flags: ["-p", "--pretty"];
+        readonly description: "Pretty print JSON";
+      };
+    };
+  };
+  readonly tagInfo: {
+    readonly command: "tag-info <tag>";
+    readonly isGlobal: false;
+    readonly aliases: [];
+    readonly description: "Show information about a tag";
+    readonly options: {
+      readonly json: {
+        readonly flags: readonly ["-j", "--json"];
+        readonly description: "Output as JSON";
+      };
+      readonly pretty: {
+        readonly flags: ["-p", "--pretty"];
+        readonly description: "Pretty print JSON";
+      };
+    };
+  };
   readonly runScript: {
     readonly command: "run-script [script] [workspacePatterns...]";
     readonly isGlobal: false;
@@ -284,6 +320,42 @@ export declare const getCliCommandConfig: (commandName: CliCommandName) =>
         };
       };
     }
+  | {
+      readonly command: "list-tags";
+      readonly isGlobal: false;
+      readonly aliases: ["ls-tags"];
+      readonly description: "List all tags available with their workspaces";
+      readonly options: {
+        readonly nameOnly: {
+          readonly flags: ["-n", "--name-only"];
+          readonly description: "Only show tag names";
+        };
+        readonly json: {
+          readonly flags: readonly ["-j", "--json"];
+          readonly description: "Output as JSON";
+        };
+        readonly pretty: {
+          readonly flags: ["-p", "--pretty"];
+          readonly description: "Pretty print JSON";
+        };
+      };
+    }
+  | {
+      readonly command: "tag-info <tag>";
+      readonly isGlobal: false;
+      readonly aliases: [];
+      readonly description: "Show information about a tag";
+      readonly options: {
+        readonly json: {
+          readonly flags: readonly ["-j", "--json"];
+          readonly description: "Output as JSON";
+        };
+        readonly pretty: {
+          readonly flags: ["-p", "--pretty"];
+          readonly description: "Pretty print JSON";
+        };
+      };
+    }
   | {
       readonly command: "run-script [script] [workspacePatterns...]";
       readonly isGlobal: false;

package/src/cli/commands/commandsConfig.mjs

@@ -101,6 +101,42 @@ const CLI_COMMANDS_CONFIG = {
       },
     },
   },
+  listTags: {
+    command: "list-tags",
+    isGlobal: false,
+    aliases: ["ls-tags"],
+    description: "List all tags available with their workspaces",
+    options: {
+      nameOnly: {
+        flags: ["-n", "--name-only"],
+        description: "Only show tag names",
+      },
+      json: {
+        flags: JSON_FLAGS,
+        description: "Output as JSON",
+      },
+      pretty: {
+        flags: ["-p", "--pretty"],
+        description: "Pretty print JSON",
+      },
+    },
+  },
+  tagInfo: {
+    command: "tag-info <tag>",
+    isGlobal: false,
+    aliases: [],
+    description: "Show information about a tag",
+    options: {
+      json: {
+        flags: JSON_FLAGS,
+        description: "Output as JSON",
+      },
+      pretty: {
+        flags: ["-p", "--pretty"],
+        description: "Pretty print JSON",
+      },
+    },
+  },
   runScript: {
     command: "run-script [script] [workspacePatterns...]",
     isGlobal: false,

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

@@ -13,3 +13,9 @@ export declare const workspaceInfo: (
 export declare const scriptInfo: (
   context: import("./commandHandlerUtils").ProjectCommandContext,
 ) => import("commander").Command;
+export declare const listTags: (
+  context: import("./commandHandlerUtils").ProjectCommandContext,
+) => import("commander").Command;
+export declare const tagInfo: (
+  context: import("./commandHandlerUtils").ProjectCommandContext,
+) => import("commander").Command;

package/src/cli/commands/handleSimpleCommands.mjs

@@ -170,5 +170,66 @@ const scriptInfo = handleProjectCommand(
     );
   },
 );
+const listTags = handleProjectCommand("listTags", ({ project }, options) => {
+  logger.debug(`Options: ${JSON.stringify(options)}`);
+  const tagMap = project.mapTagsToWorkspaces();
+  const tags = Object.entries(tagMap).map(([tag, workspaces]) => ({
+    tag,
+    workspaces: workspaces.map(({ name }) => name),
+  }));
+  const lines = [];
+  if (options.json) {
+    lines.push(
+      ...createJsonLines(
+        options.nameOnly ? tags.map(({ tag }) => tag) : tags,
+        options,
+      ),
+    );
+  } else {
+    if (!Object.keys(tagMap).length && !options.nameOnly) {
+      logger.info("No tags found");
+      return;
+    }
+    tags.forEach(({ tag, workspaces }) => {
+      if (options.nameOnly) {
+        lines.push(tag);
+      } else {
+        lines.push(
+          `Tag: ${tag}\n${workspaces.map((name) => ` - ${name}`).join("\n")}`,
+        );
+      }
+    });
+  }
+  if (lines.length) commandOutputLogger.info(lines.join("\n"));
+});
+const handleSimpleCommands_tagInfo = handleProjectCommand(
+  "tagInfo",
+  ({ project }, tag, options) => {
+    logger.debug(`Options: ${JSON.stringify(options)}`);
+    const tagMap = project.mapTagsToWorkspaces();
+    const tagMetadata = tagMap[tag];
+    if (!tagMetadata) {
+      logger.error(`Tag not found: ${JSON.stringify(tag)}`);
+      process.exit(1);
+    }
+    const tagInfo = {
+      name: tag,
+      workspaces: tagMetadata.map(({ name }) => name),
+    };
+    commandOutputLogger.info(
+      options.json
+        ? createJsonLines(tagInfo, options).join("\n")
+        : `Tag: ${tagInfo.name}\n${tagInfo.workspaces.map((name) => ` - ${name}`).join("\n")}`,
+    );
+  },
+);
 
-export { doctor, listScripts, listWorkspaces, scriptInfo, workspaceInfo };
+export {
+  doctor,
+  listScripts,
+  listTags,
+  listWorkspaces,
+  scriptInfo,
+  handleSimpleCommands_tagInfo as tagInfo,
+  workspaceInfo,
+};

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

@@ -23,6 +23,7 @@ export declare const initializeWithGlobalOptions: (
       string,
       import("../..").WorkspaceScriptMetadata
     >;
+    mapTagsToWorkspaces(): Record<string, import("../..").Workspace[]>;
     findWorkspaceByName(
       workspaceName: string,
     ): import("../..").Workspace | null;
@@ -30,6 +31,7 @@ export declare const initializeWithGlobalOptions: (
     findWorkspaceByNameOrAlias(
       nameOrAlias: string,
     ): import("../..").Workspace | null;
+    listWorkspacesWithTag(tag: string): import("../..").Workspace[];
     findWorkspacesByPattern(
       ...workspacePatterns: string[]
     ): import("../..").Workspace[];

package/src/config/public.d.ts

@@ -1,10 +1,7 @@
-export type { ResolvedRootConfig } from "./rootConfig";
-export type { ResolvedWorkspaceConfig } from "./workspaceConfig";
-export {
-  type RootConfig,
-  defineRootConfig,
-} from "./rootConfig/defineRootConfig";
-export {
-  type WorkspaceConfig,
-  defineWorkspaceConfig,
-} from "./workspaceConfig/defineWorkspaceConfig";
+export type { RootConfig, ResolvedRootConfig } from "./rootConfig";
+export type {
+  WorkspaceConfig,
+  ResolvedWorkspaceConfig,
+} from "./workspaceConfig";
+export { defineRootConfig } from "./rootConfig/defineRootConfig";
+export { defineWorkspaceConfig } from "./workspaceConfig/defineWorkspaceConfig";

package/src/config/rootConfig/defineRootConfig.d.ts

@@ -1,11 +1,4 @@
-import { type ResolvedRootConfig } from "./rootConfig";
-export type RootConfig = {
-  defaults?: {
-    parallelMax?: number | string;
-    shell?: string;
-    includeRootWorkspace?: boolean;
-  };
-};
+import { type RootConfig, type ResolvedRootConfig } from "./rootConfig";
 export declare const defineRootConfig: (
   config: RootConfig,
 ) => ResolvedRootConfig;

package/src/config/rootConfig/rootConfig.d.ts

@@ -1,7 +1,15 @@
-import { type FromSchema } from "json-schema-to-ts";
-import { type ScriptShellOption } from "../../runScript";
-import type { ROOT_CONFIG_JSON_SCHEMA } from "./rootConfigSchema";
-export type RootConfig = FromSchema<typeof ROOT_CONFIG_JSON_SCHEMA>;
+import type { ShellOption } from "../../project";
+import { type ParallelMaxValue, type ScriptShellOption } from "../../runScript";
+export type RootConfig = {
+  defaults?: {
+    /** The maximum number of scripts that can run in parallel. (default: "auto") */
+    parallelMax?: ParallelMaxValue;
+    /** The shell to use for inline scripts. (default: "bun") */
+    shell?: ShellOption;
+    /** Whether to include the root workspace in the workspaces list by default. (default: false) */
+    includeRootWorkspace?: boolean;
+  };
+};
 export type ResolvedRootConfig = {
   defaults: {
     parallelMax: number;

package/src/config/rootConfig/rootConfigSchema.mjs

@@ -20,5 +20,6 @@ const ROOT_CONFIG_JSON_SCHEMA = {
     },
   },
 };
+let _validateSchemaType;
 
 export { ROOT_CONFIG_JSON_SCHEMA };

package/src/config/workspaceConfig/defineWorkspaceConfig.d.ts

@@ -1,11 +1,7 @@
 import {
   type ResolvedWorkspaceConfig,
-  type ScriptConfig,
+  type WorkspaceConfig,
 } from "./workspaceConfig";
-export type WorkspaceConfig = {
-  alias?: string | string[];
-  scripts?: Record<string, ScriptConfig>;
-};
 export declare const defineWorkspaceConfig: (
   config: WorkspaceConfig,
 ) => ResolvedWorkspaceConfig;

package/src/config/workspaceConfig/workspaceConfig.d.ts

@@ -1,20 +1,41 @@
-import { type FromSchema } from "json-schema-to-ts";
-import type { WORKSPACE_CONFIG_JSON_SCHEMA } from "./workspaceConfigSchema";
-/**
- * @todo json-schema-to-ts doesn't support the union type for alias as it is,
- * but AJV error messaging for oneOf is not good
- */
-export type WorkspaceConfig = Omit<
-  FromSchema<typeof WORKSPACE_CONFIG_JSON_SCHEMA>,
-  "alias"
-> & {
+/** Configuration that applies to a specific package.json script */
+export type ScriptConfig = {
+  /**
+   * The order in which the script should be executed.
+   *
+   * This is used to sort the scripts in the workspace.
+   *
+   * Scripts with no `order` set will be executed in alphanumerical order
+   * of their relative path from the project root.
+   */
+  order?: number;
+};
+/** Configuration that applies to a specific workspace */
+export type WorkspaceConfig = {
+  /**
+   * An alias or list of aliases for the workspace.
+   *
+   * These must be unique to other workspaces' aliases
+   * and package.json names.
+   */
   alias?: string | string[];
+  /**
+   * Tags for the workspace.
+   *
+   * These can be used to group workspaces
+   * by a common tag.
+   */
+  tags?: string[];
+  /**
+   * Configuration that maps to a script name in the workspace's package.json.
+   */
+  scripts?: Record<string, ScriptConfig>;
 };
 export type ResolvedWorkspaceConfig = {
   aliases: string[];
+  tags: string[];
   scripts: Record<string, ScriptConfig>;
 };
-export type ScriptConfig = NonNullable<WorkspaceConfig["scripts"]>[string];
 export declare const validateWorkspaceConfig: (config: WorkspaceConfig) => void;
 export declare const resolveWorkspaceConfig: (
   config: WorkspaceConfig,

package/src/config/workspaceConfig/workspaceConfig.mjs

@@ -32,6 +32,7 @@ const resolveWorkspaceConfig = (config) => {
   workspaceConfig_validateWorkspaceConfig(config);
   return {
     aliases: resolveOptionalArray(config.alias ?? []),
+    tags: config.tags ?? [],
     scripts: config.scripts ?? {},
   };
 };

package/src/config/workspaceConfig/workspaceConfigSchema.d.ts

@@ -1,24 +1,31 @@
 export declare const WORKSPACE_CONFIG_JSON_SCHEMA: {
-  type: "object";
-  additionalProperties: false;
-  properties: {
-    alias: {
-      type: ("string" | "array")[];
-      items: {
-        type: "string";
+  readonly type: "object";
+  readonly additionalProperties: false;
+  readonly properties: {
+    readonly alias: {
+      readonly type: readonly ["string", "array"];
+      readonly items: {
+        readonly type: "string";
       };
-      uniqueItems: true;
+      readonly uniqueItems: true;
     };
-    scripts: {
-      type: "object";
-      additionalProperties: {
-        type: "object";
-        properties: {
-          order: {
-            type: "number";
+    readonly tags: {
+      readonly type: "array";
+      readonly items: {
+        readonly type: "string";
+      };
+      readonly uniqueItems: true;
+    };
+    readonly scripts: {
+      readonly type: "object";
+      readonly additionalProperties: {
+        readonly type: "object";
+        readonly properties: {
+          readonly order: {
+            readonly type: "number";
           };
         };
-        additionalProperties: false;
+        readonly additionalProperties: false;
       };
     };
   };

package/src/config/workspaceConfig/workspaceConfigSchema.mjs

@@ -10,6 +10,13 @@ const WORKSPACE_CONFIG_JSON_SCHEMA = {
       },
       uniqueItems: true,
     },
+    tags: {
+      type: "array",
+      items: {
+        type: "string",
+      },
+      uniqueItems: true,
+    },
     scripts: {
       type: "object",
       additionalProperties: {
@@ -24,5 +31,6 @@ const WORKSPACE_CONFIG_JSON_SCHEMA = {
     },
   },
 };
+let _validateSchemaType;
 
 export { WORKSPACE_CONFIG_JSON_SCHEMA };

package/src/internal/generated/ajv/validateWorkspaceConfig.mjs

@@ -1 +1 @@
-"use strict";module.exports = validate10;module.exports.default = validate10;const schema11 = {"type":"object","additionalProperties":false,"properties":{"alias":{"type":["string","array"],"items":{"type":"string"},"uniqueItems":true},"scripts":{"type":"object","additionalProperties":{"type":"object","properties":{"order":{"type":"number"}},"additionalProperties":false}}}};function validate10(data, {instancePath="", parentData, parentDataProperty, rootData=data}={}){let vErrors = null;let errors = 0;if(errors === 0){if(data && typeof data == "object" && !Array.isArray(data)){const _errs1 = errors;for(const key0 in data){if(!((key0 === "alias") || (key0 === "scripts"))){validate10.errors = [{instancePath,schemaPath:"#/additionalProperties",keyword:"additionalProperties",params:{additionalProperty: key0},message:"must NOT have additional properties"}];return false;break;}}if(_errs1 === errors){if(data.alias !== undefined){let data0 = data.alias;const _errs2 = errors;if((typeof data0 !== "string") && (!(Array.isArray(data0)))){validate10.errors = [{instancePath:instancePath+"/alias",schemaPath:"#/properties/alias/type",keyword:"type",params:{type: schema11.properties.alias.type},message:"must be string,array"}];return false;}if(errors === _errs2){if(Array.isArray(data0)){var valid1 = true;const len0 = data0.length;for(let i0=0; i0<len0; i0++){const _errs4 = errors;if(typeof data0[i0] !== "string"){validate10.errors = [{instancePath:instancePath+"/alias/" + i0,schemaPath:"#/properties/alias/items/type",keyword:"type",params:{type: "string"},message:"must be string"}];return false;}var valid1 = _errs4 === errors;if(!valid1){break;}}if(valid1){let i1 = data0.length;let j0;if(i1 > 1){const indices0 = {};for(;i1--;){let item0 = data0[i1];if(typeof item0 !== "string"){continue;}if(typeof indices0[item0] == "number"){j0 = indices0[item0];validate10.errors = [{instancePath:instancePath+"/alias",schemaPath:"#/properties/alias/uniqueItems",keyword:"uniqueItems",params:{i: i1, j: j0},message:"must NOT have duplicate items (items ## "+j0+" and "+i1+" are identical)"}];return false;break;}indices0[item0] = i1;}}}}}var valid0 = _errs2 === errors;}else {var valid0 = true;}if(valid0){if(data.scripts !== undefined){let data2 = data.scripts;const _errs6 = errors;if(errors === _errs6){if(data2 && typeof data2 == "object" && !Array.isArray(data2)){for(const key1 in data2){let data3 = data2[key1];const _errs9 = errors;if(errors === _errs9){if(data3 && typeof data3 == "object" && !Array.isArray(data3)){const _errs11 = errors;for(const key2 in data3){if(!(key2 === "order")){validate10.errors = [{instancePath:instancePath+"/scripts/" + key1.replace(/~/g, "~0").replace(/\//g, "~1"),schemaPath:"#/properties/scripts/additionalProperties/additionalProperties",keyword:"additionalProperties",params:{additionalProperty: key2},message:"must NOT have additional properties"}];return false;break;}}if(_errs11 === errors){if(data3.order !== undefined){let data4 = data3.order;if(!((typeof data4 == "number") && (isFinite(data4)))){validate10.errors = [{instancePath:instancePath+"/scripts/" + key1.replace(/~/g, "~0").replace(/\//g, "~1")+"/order",schemaPath:"#/properties/scripts/additionalProperties/properties/order/type",keyword:"type",params:{type: "number"},message:"must be number"}];return false;}}}}else {validate10.errors = [{instancePath:instancePath+"/scripts/" + key1.replace(/~/g, "~0").replace(/\//g, "~1"),schemaPath:"#/properties/scripts/additionalProperties/type",keyword:"type",params:{type: "object"},message:"must be object"}];return false;}}var valid3 = _errs9 === errors;if(!valid3){break;}}}else {validate10.errors = [{instancePath:instancePath+"/scripts",schemaPath:"#/properties/scripts/type",keyword:"type",params:{type: "object"},message:"must be object"}];return false;}}var valid0 = _errs6 === errors;}else {var valid0 = true;}}}}else {validate10.errors = [{instancePath,schemaPath:"#/type",keyword:"type",params:{type: "object"},message:"must be object"}];return false;}}validate10.errors = vErrors;return errors === 0;}
+"use strict";module.exports = validate10;module.exports.default = validate10;const schema11 = {"type":"object","additionalProperties":false,"properties":{"alias":{"type":["string","array"],"items":{"type":"string"},"uniqueItems":true},"tags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"scripts":{"type":"object","additionalProperties":{"type":"object","properties":{"order":{"type":"number"}},"additionalProperties":false}}}};function validate10(data, {instancePath="", parentData, parentDataProperty, rootData=data}={}){let vErrors = null;let errors = 0;if(errors === 0){if(data && typeof data == "object" && !Array.isArray(data)){const _errs1 = errors;for(const key0 in data){if(!(((key0 === "alias") || (key0 === "tags")) || (key0 === "scripts"))){validate10.errors = [{instancePath,schemaPath:"#/additionalProperties",keyword:"additionalProperties",params:{additionalProperty: key0},message:"must NOT have additional properties"}];return false;break;}}if(_errs1 === errors){if(data.alias !== undefined){let data0 = data.alias;const _errs2 = errors;if((typeof data0 !== "string") && (!(Array.isArray(data0)))){validate10.errors = [{instancePath:instancePath+"/alias",schemaPath:"#/properties/alias/type",keyword:"type",params:{type: schema11.properties.alias.type},message:"must be string,array"}];return false;}if(errors === _errs2){if(Array.isArray(data0)){var valid1 = true;const len0 = data0.length;for(let i0=0; i0<len0; i0++){const _errs4 = errors;if(typeof data0[i0] !== "string"){validate10.errors = [{instancePath:instancePath+"/alias/" + i0,schemaPath:"#/properties/alias/items/type",keyword:"type",params:{type: "string"},message:"must be string"}];return false;}var valid1 = _errs4 === errors;if(!valid1){break;}}if(valid1){let i1 = data0.length;let j0;if(i1 > 1){const indices0 = {};for(;i1--;){let item0 = data0[i1];if(typeof item0 !== "string"){continue;}if(typeof indices0[item0] == "number"){j0 = indices0[item0];validate10.errors = [{instancePath:instancePath+"/alias",schemaPath:"#/properties/alias/uniqueItems",keyword:"uniqueItems",params:{i: i1, j: j0},message:"must NOT have duplicate items (items ## "+j0+" and "+i1+" are identical)"}];return false;break;}indices0[item0] = i1;}}}}}var valid0 = _errs2 === errors;}else {var valid0 = true;}if(valid0){if(data.tags !== undefined){let data2 = data.tags;const _errs6 = errors;if(errors === _errs6){if(Array.isArray(data2)){var valid3 = true;const len1 = data2.length;for(let i2=0; i2<len1; i2++){const _errs8 = errors;if(typeof data2[i2] !== "string"){validate10.errors = [{instancePath:instancePath+"/tags/" + i2,schemaPath:"#/properties/tags/items/type",keyword:"type",params:{type: "string"},message:"must be string"}];return false;}var valid3 = _errs8 === errors;if(!valid3){break;}}if(valid3){let i3 = data2.length;let j1;if(i3 > 1){const indices1 = {};for(;i3--;){let item1 = data2[i3];if(typeof item1 !== "string"){continue;}if(typeof indices1[item1] == "number"){j1 = indices1[item1];validate10.errors = [{instancePath:instancePath+"/tags",schemaPath:"#/properties/tags/uniqueItems",keyword:"uniqueItems",params:{i: i3, j: j1},message:"must NOT have duplicate items (items ## "+j1+" and "+i3+" are identical)"}];return false;break;}indices1[item1] = i3;}}}}else {validate10.errors = [{instancePath:instancePath+"/tags",schemaPath:"#/properties/tags/type",keyword:"type",params:{type: "array"},message:"must be array"}];return false;}}var valid0 = _errs6 === errors;}else {var valid0 = true;}if(valid0){if(data.scripts !== undefined){let data4 = data.scripts;const _errs10 = errors;if(errors === _errs10){if(data4 && typeof data4 == "object" && !Array.isArray(data4)){for(const key1 in data4){let data5 = data4[key1];const _errs13 = errors;if(errors === _errs13){if(data5 && typeof data5 == "object" && !Array.isArray(data5)){const _errs15 = errors;for(const key2 in data5){if(!(key2 === "order")){validate10.errors = [{instancePath:instancePath+"/scripts/" + key1.replace(/~/g, "~0").replace(/\//g, "~1"),schemaPath:"#/properties/scripts/additionalProperties/additionalProperties",keyword:"additionalProperties",params:{additionalProperty: key2},message:"must NOT have additional properties"}];return false;break;}}if(_errs15 === errors){if(data5.order !== undefined){let data6 = data5.order;if(!((typeof data6 == "number") && (isFinite(data6)))){validate10.errors = [{instancePath:instancePath+"/scripts/" + key1.replace(/~/g, "~0").replace(/\//g, "~1")+"/order",schemaPath:"#/properties/scripts/additionalProperties/properties/order/type",keyword:"type",params:{type: "number"},message:"must be number"}];return false;}}}}else {validate10.errors = [{instancePath:instancePath+"/scripts/" + key1.replace(/~/g, "~0").replace(/\//g, "~1"),schemaPath:"#/properties/scripts/additionalProperties/type",keyword:"type",params:{type: "object"},message:"must be object"}];return false;}}var valid5 = _errs13 === errors;if(!valid5){break;}}}else {validate10.errors = [{instancePath:instancePath+"/scripts",schemaPath:"#/properties/scripts/type",keyword:"type",params:{type: "object"},message:"must be object"}];return false;}}var valid0 = _errs10 === errors;}else {var valid0 = true;}}}}}else {validate10.errors = [{instancePath,schemaPath:"#/type",keyword:"type",params:{type: "object"},message:"must be object"}];return false;}}validate10.errors = vErrors;return errors === 0;}

package/src/project/implementations/memoryProject.mjs

@@ -113,6 +113,7 @@ class _MemoryProject extends ProjectBase {
       path: "",
       scripts: [],
       aliases: [],
+      tags: [],
       dependencies: [],
       dependents: [],
     };

package/src/project/implementations/projectBase.d.ts

@@ -25,9 +25,11 @@ export declare abstract class ProjectBase implements Project {
   constructor(_ignoreBunVersion?: boolean);
   listWorkspacesWithScript(scriptName: string): Workspace[];
   mapScriptsToWorkspaces(): Record<string, WorkspaceScriptMetadata>;
+  mapTagsToWorkspaces(): Record<string, Workspace[]>;
   findWorkspaceByName(workspaceName: string): Workspace | null;
   findWorkspaceByAlias(alias: string): Workspace | null;
   findWorkspaceByNameOrAlias(nameOrAlias: string): Workspace | null;
+  listWorkspacesWithTag(tag: string): Workspace[];
   findWorkspacesByPattern(...workspacePatterns: string[]): Workspace[];
   createScriptCommand(
     options: CreateProjectScriptCommandOptions,

package/src/project/implementations/projectBase.mjs

@@ -69,6 +69,21 @@ class ProjectBase {
         {},
       );
   }
+  mapTagsToWorkspaces() {
+    const tags = new Set();
+    this.workspaces.forEach((workspace) => {
+      workspace.tags.forEach((tag) => tags.add(tag));
+    });
+    return Array.from(tags)
+      .sort((a, b) => a.localeCompare(b))
+      .reduce(
+        (acc, tag) => ({
+          ...acc,
+          [tag]: this.listWorkspacesWithTag(tag),
+        }),
+        {},
+      );
+  }
   findWorkspaceByName(workspaceName) {
     validateJSTypes(
       {
@@ -120,6 +135,9 @@ class ProjectBase {
       this.findWorkspaceByAlias(nameOrAlias)
     );
   }
+  listWorkspacesWithTag(tag) {
+    return this.workspaces.filter((workspace) => workspace.tags.includes(tag));
+  }
   findWorkspacesByPattern(...workspacePatterns) {
     const workspaces = [];
     if (workspacePatterns.includes(ROOT_WORKSPACE_SELECTOR)) {

package/src/project/project.d.ts

@@ -62,12 +62,16 @@ export interface Project {
   findWorkspaceByAlias(alias: string): Workspace | null;
   /** Find a workspace that matches a workspace's name or an alias if no name matches. */
   findWorkspaceByNameOrAlias(nameOrAlias: string): Workspace | null;
+  /** Find a list of workspaces that have a given tag in their configuration */
+  listWorkspacesWithTag(tag: string): Workspace[];
   /** Accepts a wildcard pattern for finding a list of workspaces by their name*/
   findWorkspacesByPattern(workspacePattern: string): Workspace[];
   /** Get an array of all workspaces that have a given script in their package.json */
   listWorkspacesWithScript(scriptName: string): Workspace[];
   /** Get a mapping of all scripts to the workspaces that have them in their package.json */
   mapScriptsToWorkspaces(): Record<string, WorkspaceScriptMetadata>;
+  /** Get a mapping of all tags to the workspaces that have them in their config */
+  mapTagsToWorkspaces(): Record<string, Workspace[]>;
   /** Create metadata that can be used to run a workspace's script */
   createScriptCommand(
     options: CreateProjectScriptCommandOptions,

package/src/runScript/parallel.d.ts

@@ -4,6 +4,15 @@ export declare const PARALLEL_MAX_VALUES: readonly [
   "default",
 ];
 export type PercentageValue = `${number}%`;
+/**
+ * The maximum number of scripts that can run in parallel.
+ *
+ * - `number`: The exact number of scripts that can run in parallel.
+ * - `"auto"`: The number of available logical CPU threads.
+ * - `"unbounded"`: No limit.
+ * - `"default"`: The default value, either "auto" or the value of the root config's "parallelMax" option.
+ * - `"${number}%"`: A percentage of the available logical CPU threads (e.g. "50%").
+ */
 export type ParallelMaxValue =
   | number
   | (typeof PARALLEL_MAX_VALUES)[number]

package/src/workspaces/findWorkspaces.mjs

@@ -146,6 +146,7 @@ const findWorkspaces = ({
               .concat(workspaceConfig?.aliases ?? []),
           ),
         ],
+        tags: workspaceConfig?.tags ?? [],
         dependencies: [],
         dependents: [],
       };

package/src/workspaces/workspace.d.ts

@@ -10,8 +10,10 @@ export type Workspace = {
   matchPattern: string;
   /** The scripts available in package.json */
   scripts: string[];
-  /** Aliases assigned to the workspace via the `"workspaceAliases"` field in the config */
+  /** Aliases assigned via the `"alias"` field in the workspace's config */
   aliases: string[];
+  /** Tags assigned via the `"tags"` field in the workspace's config */
+  tags: string[];
   /** Names of workspaces that this workspace depends on */
   dependencies: string[];
   /** Names of workspaces that depend on this workspace */

package/src/workspaces/workspacePattern.d.ts

@@ -1,5 +1,5 @@
 import type { Workspace } from "./workspace";
-declare const TARGETS: readonly ["path", "alias", "name"];
+declare const TARGETS: readonly ["path", "alias", "name", "tag"];
 export declare const WORKSPACE_PATTERN_ERRORS: import("../internal/core").DefinedErrors<"InvalidWorkspacePattern">;
 export type WorkspacePatternTarget = (typeof TARGETS)[number];
 export type WorkspacePattern = {

package/src/workspaces/workspacePattern.mjs

@@ -3,7 +3,7 @@ import { createWildcardRegex, defineErrors } from "../internal/core/index.mjs";
 // CONCATENATED MODULE: external "../internal/core/index.mjs"
 // CONCATENATED MODULE: ./src/workspaces/workspacePattern.ts
 
-const TARGETS = ["path", "alias", "name"];
+const TARGETS = ["path", "alias", "name", "tag"];
 const WORKSPACE_PATTERN_ERRORS = defineErrors("InvalidWorkspacePattern");
 const WORKSPACE_PATTERN_SEPARATOR = ":";
 const parseWorkspacePattern = (pattern) => {
@@ -65,6 +65,13 @@ const PATTERN_TARGET_HANDLERS = {
       new bun.Glob(pattern.value).match(workspace.path),
     );
   },
+  tag: (pattern, workspaces, wildcardRegex) => {
+    return workspaces.filter((workspace) =>
+      pattern.value.includes("*")
+        ? workspace.tags.some((tag) => wildcardRegex.test(tag))
+        : workspace.tags.includes(pattern.value),
+    );
+  },
 };
 const matchWorkspacesByPattern = (pattern, workspaces) =>
   PATTERN_TARGET_HANDLERS[pattern.target](