@rushstack/rush-sdk 5.158.0 → 5.158.1-pr5355.0

package/dist/rush-lib.d.ts

@@ -1428,6 +1428,10 @@ export declare interface IExecuteOperationsContext extends ICreateOperationsCont
      * Not part of the creation context to avoid the overhead of Git calls when initializing the graph.
      */
     readonly inputsSnapshot?: IInputsSnapshot;
+    /**
+     * An abort controller that can be used to abort the current set of queued operations.
+     */
+    readonly abortController: AbortController;
 }
 
 /**
@@ -2189,6 +2193,12 @@ export declare interface IPhasedCommand extends IRushCommand {
      * @alpha
      */
     readonly hooks: PhasedCommandHooks;
+    /**
+     * An abort controller that can be used to abort the command.
+     * Long-lived plugins should listen to the signal to handle any cleanup logic.
+     * @alpha
+     */
+    readonly sessionAbortController: AbortController;
 }
 
 /**
@@ -3103,7 +3113,11 @@ export declare enum OperationStatus {
     /**
      * The Operation was a no-op (for example, it had an empty script)
      */
-    NoOp = "NO OP"
+    NoOp = "NO OP",
+    /**
+     * The Operation was aborted before it could execute.
+     */
+    Aborted = "ABORTED"
 }
 
 /**
@@ -4944,7 +4958,10 @@ export declare class Subspace {
      * Returns the full path of the folder containing this subspace's variant-dependent configuration files
      * such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace` or `common/config/subspaces/my-subspace/variants/my-variant`
+     * Example (variants):               `C:\MyRepo\common\config\rush\variants\my-variant`
+     * Example (variants and subspaces): `C:\MyRepo\common\config\subspaces\my-subspace\variants\my-variant`
+     * Example (subspaces):              `C:\MyRepo\common\config\subspaces\my-subspace`
+     * Example (neither):                `C:\MyRepo\common\config\rush`
      * @beta
      *
      * @remarks
@@ -4957,22 +4974,24 @@ export declare class Subspace {
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush`
      * @beta
      */
     getSubspaceConfigFolderPath(): string;
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace/pnpm-patches` (subspaces feature enabled)
-     * Example: `common/config/pnpm-patches` (subspaces feature disabled)
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\pnpm-patches`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\pnpm-patches`
      * @beta
      */
     getSubspacePnpmPatchesFolderPath(): string;
     /**
-     * The folder where the subspace's node_modules and other temporary files will be stored.
+     * The full path of the folder where the subspace's node_modules and other temporary files will be stored.
      *
-     * Example: `common/temp/subspaces/my-subspace`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\temp\subspaces\my-subspace`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\temp`
      * @beta
      */
     getSubspaceTempFolderPath(): string;
@@ -5004,16 +5023,18 @@ export declare class Subspace {
      */
     getTempShrinkwrapPreinstallFilePath(): string;
     /**
-     * Gets the path to the common-versions.json config file for this subspace.
+     * Gets the full path to the common-versions.json config file for this subspace.
      *
-     * Example: `C:\MyRepo\common\subspaces\my-subspace\common-versions.json`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\common-versions.json`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush\common-versions.json`
      * @beta
      */
     getCommonVersionsFilePath(variant?: string): string;
     /**
-     * Gets the path to the pnpm-config.json config file for this subspace.
+     * Gets the full path to the pnpm-config.json config file for this subspace.
      *
-     * Example: `C:\MyRepo\common\subspaces\my-subspace\pnpm-config.json`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\pnpm-config.json`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush\pnpm-config.json`
      * @beta
      */
     getPnpmConfigFilePath(): string;

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.52.11"
+      "packageVersion": "7.52.13"
     }
   ]
 }

package/lib/api/CommandLineJson.d.ts

@@ -19,6 +19,7 @@ export interface IBaseCommandJson {
 export interface IBulkCommandJson extends IBaseCommandJson {
     commandKind: 'bulk';
     enableParallelism: boolean;
+    allowOversubscription?: boolean;
     ignoreDependencyOrder?: boolean;
     ignoreMissingScript?: boolean;
     incremental?: boolean;
@@ -33,6 +34,7 @@ export interface IBulkCommandJson extends IBaseCommandJson {
 export interface IPhasedCommandWithoutPhasesJson extends IBaseCommandJson {
     commandKind: 'phased';
     enableParallelism: boolean;
+    allowOversubscription?: boolean;
     incremental?: boolean;
 }
 /**

package/lib/api/Subspace.d.ts

@@ -41,7 +41,10 @@ export declare class Subspace {
      * Returns the full path of the folder containing this subspace's variant-dependent configuration files
      * such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace` or `common/config/subspaces/my-subspace/variants/my-variant`
+     * Example (variants):               `C:\MyRepo\common\config\rush\variants\my-variant`
+     * Example (variants and subspaces): `C:\MyRepo\common\config\subspaces\my-subspace\variants\my-variant`
+     * Example (subspaces):              `C:\MyRepo\common\config\subspaces\my-subspace`
+     * Example (neither):                `C:\MyRepo\common\config\rush`
      * @beta
      *
      * @remarks
@@ -54,22 +57,24 @@ export declare class Subspace {
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush`
      * @beta
      */
     getSubspaceConfigFolderPath(): string;
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace/pnpm-patches` (subspaces feature enabled)
-     * Example: `common/config/pnpm-patches` (subspaces feature disabled)
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\pnpm-patches`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\pnpm-patches`
      * @beta
      */
     getSubspacePnpmPatchesFolderPath(): string;
     /**
-     * The folder where the subspace's node_modules and other temporary files will be stored.
+     * The full path of the folder where the subspace's node_modules and other temporary files will be stored.
      *
-     * Example: `common/temp/subspaces/my-subspace`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\temp\subspaces\my-subspace`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\temp`
      * @beta
      */
     getSubspaceTempFolderPath(): string;
@@ -101,16 +106,18 @@ export declare class Subspace {
      */
     getTempShrinkwrapPreinstallFilePath(): string;
     /**
-     * Gets the path to the common-versions.json config file for this subspace.
+     * Gets the full path to the common-versions.json config file for this subspace.
      *
-     * Example: `C:\MyRepo\common\subspaces\my-subspace\common-versions.json`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\common-versions.json`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush\common-versions.json`
      * @beta
      */
     getCommonVersionsFilePath(variant?: string): string;
     /**
-     * Gets the path to the pnpm-config.json config file for this subspace.
+     * Gets the full path to the pnpm-config.json config file for this subspace.
      *
-     * Example: `C:\MyRepo\common\subspaces\my-subspace\pnpm-config.json`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\pnpm-config.json`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush\pnpm-config.json`
      * @beta
      */
     getPnpmConfigFilePath(): string;

package/lib/cli/scriptActions/PhasedScriptAction.d.ts

@@ -1,3 +1,4 @@
+import type { IPhasedCommand } from '../../pluginFramework/RushLifeCycle';
 import { PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
 import { BaseScriptAction, type IBaseScriptActionOptions } from './BaseScriptAction';
 import type { IPhase, IPhasedCommandConfig } from '../../api/CommandLineConfiguration';
@@ -6,6 +7,7 @@ import type { IPhase, IPhasedCommandConfig } from '../../api/CommandLineConfigur
  */
 export interface IPhasedScriptActionOptions extends IBaseScriptActionOptions<IPhasedCommandConfig> {
     enableParallelism: boolean;
+    allowOversubscription: boolean;
     incremental: boolean;
     disableBuildCache: boolean;
     originalPhases: Set<IPhase>;
@@ -25,13 +27,15 @@ export interface IPhasedScriptActionOptions extends IBaseScriptActionOptions<IPh
  * and "rebuild" commands are also modeled as phased commands with a single phase that invokes the npm
  * "build" script for each project.
  */
-export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandConfig> {
+export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandConfig> implements IPhasedCommand {
     /**
      * @internal
      */
     _runsBeforeInstall: boolean | undefined;
     readonly hooks: PhasedCommandHooks;
+    readonly sessionAbortController: AbortController;
     private readonly _enableParallelism;
+    private readonly _allowOversubscription;
     private readonly _isIncrementalBuildAllowed;
     private readonly _disableBuildCache;
     private readonly _originalPhases;
@@ -43,6 +47,7 @@ export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandC
     private readonly _knownPhases;
     private readonly _terminal;
     private _changedProjectsOnly;
+    private _executionAbortController;
     private readonly _changedProjectsOnlyParameter;
     private readonly _selectionParameters;
     private readonly _verboseParameter;

package/lib/logic/DependencySpecifier.d.ts

@@ -65,6 +65,17 @@ export declare class DependencySpecifier {
      */
     readonly aliasTarget: DependencySpecifier | undefined;
     constructor(packageName: string, versionSpecifier: string);
+    /**
+     * Clears the dependency specifier parse cache.
+     */
+    static clearCache(): void;
+    /**
+     * Parses a dependency specifier with caching.
+     * @param packageName - The name of the package the version specifier corresponds to
+     * @param versionSpecifier - The version specifier to parse
+     * @returns The parsed dependency specifier
+     */
+    static parseWithCache(packageName: string, versionSpecifier: string): DependencySpecifier;
     static getDependencySpecifierType(specifierType: string): DependencySpecifierType;
 }
 //# sourceMappingURL=DependencySpecifier.d.ts.map

package/lib/logic/operations/IPCOperationRunner.d.ts

@@ -1,3 +1,4 @@
+import type { OperationRequestRunCallback } from '@rushstack/operation-graph';
 import type { IPhase } from '../../api/CommandLineConfiguration';
 import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 import type { IOperationRunner, IOperationRunnerContext } from './IOperationRunner';
@@ -9,7 +10,7 @@ export interface IIPCOperationRunnerOptions {
     commandToRun: string;
     commandForHash: string;
     persist: boolean;
-    requestRun: (requestor?: string) => void;
+    requestRun: OperationRequestRunCallback;
 }
 /**
  * Runner that hosts a long-lived process to which it communicates via IPC.

package/lib/logic/operations/OperationExecutionManager.d.ts

@@ -9,6 +9,7 @@ export interface IOperationExecutionManagerOptions {
     quietMode: boolean;
     debugMode: boolean;
     parallelism: number;
+    allowOversubscription: boolean;
     inputsSnapshot?: IInputsSnapshot;
     destination?: TerminalWritable;
     beforeExecuteOperationAsync?: (operation: OperationExecutionRecord) => Promise<OperationStatus | undefined>;
@@ -27,6 +28,7 @@ export declare class OperationExecutionManager {
     private readonly _executionRecords;
     private readonly _quietMode;
     private readonly _parallelism;
+    private readonly _allowOversubscription;
     private readonly _totalOperations;
     private readonly _outputWritable;
     private readonly _colorsNewlinesTransform;
@@ -39,6 +41,7 @@ export declare class OperationExecutionManager {
     private readonly _createEnvironmentForOperation?;
     private _hasAnyFailures;
     private _hasAnyNonAllowedWarnings;
+    private _hasAnyAborted;
     private _completedOperations;
     private _executionQueue;
     constructor(operations: Set<Operation>, options: IOperationExecutionManagerOptions);
@@ -47,7 +50,7 @@ export declare class OperationExecutionManager {
      * Executes all operations which have been registered, returning a promise which is resolved when all the
      * operations are completed successfully, or rejects when any operation fails.
      */
-    executeAsync(): Promise<IExecutionResult>;
+    executeAsync(abortController: AbortController): Promise<IExecutionResult>;
     private _reportOperationErrorIfAny;
     /**
      * Handles the result of the operation and propagates any relevant effects.

package/lib/logic/operations/OperationStatus.d.ts

@@ -46,7 +46,11 @@ export declare enum OperationStatus {
     /**
      * The Operation was a no-op (for example, it had an empty script)
      */
-    NoOp = "NO OP"
+    NoOp = "NO OP",
+    /**
+     * The Operation was aborted before it could execute.
+     */
+    Aborted = "ABORTED"
 }
 /**
  * The set of statuses that are considered terminal.

package/lib/logic/pnpm/PnpmShrinkwrapFile.d.ts

@@ -89,7 +89,6 @@ export declare function parsePnpm9DependencyKey(dependencyName: string, versionS
 export declare function parsePnpmDependencyKey(dependencyName: string, versionSpecifier: IPnpmVersionSpecifier): DependencySpecifier | undefined;
 export declare function normalizePnpmVersionSpecifier(versionSpecifier: IPnpmVersionSpecifier): string;
 export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
-    private static _cacheByLockfilePath;
     readonly shrinkwrapFileMajorVersion: number;
     readonly isWorkspaceCompatible: boolean;
     readonly registry: string;
@@ -99,12 +98,17 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     readonly packages: ReadonlyMap<string, IPnpmShrinkwrapDependencyYaml>;
     readonly overrides: ReadonlyMap<string, string>;
     readonly packageExtensionsChecksum: undefined | string;
+    readonly hash: string;
     private readonly _shrinkwrapJson;
     private readonly _integrities;
     private _pnpmfileConfiguration;
     private constructor();
     static getLockfileV9PackageId(name: string, version: string): string;
-    static loadFromFile(shrinkwrapYamlFilePath: string, { withCaching }?: ILoadFromFileOptions): PnpmShrinkwrapFile | undefined;
+    /**
+     * Clears the cache of PnpmShrinkwrapFile instances to free up memory.
+     */
+    static clearCache(): void;
+    static loadFromFile(shrinkwrapYamlFilePath: string, options?: ILoadFromFileOptions): PnpmShrinkwrapFile | undefined;
     static loadFromString(shrinkwrapContent: string): PnpmShrinkwrapFile;
     getShrinkwrapHash(experimentsConfig?: IExperimentsJson): string;
     /**

package/lib/pluginFramework/PhasedCommandHooks.d.ts

@@ -114,6 +114,10 @@ export interface IExecuteOperationsContext extends ICreateOperationsContext {
      * Not part of the creation context to avoid the overhead of Git calls when initializing the graph.
      */
     readonly inputsSnapshot?: IInputsSnapshot;
+    /**
+     * An abort controller that can be used to abort the current set of queued operations.
+     */
+    readonly abortController: AbortController;
 }
 /**
  * Hooks into the execution process for phased commands

package/lib/pluginFramework/RushLifeCycle.d.ts

@@ -28,6 +28,12 @@ export interface IPhasedCommand extends IRushCommand {
      * @alpha
      */
     readonly hooks: PhasedCommandHooks;
+    /**
+     * An abort controller that can be used to abort the command.
+     * Long-lived plugins should listen to the signal to handle any cleanup logic.
+     * @alpha
+     */
+    readonly sessionAbortController: AbortController;
 }
 /**
  * Hooks into the lifecycle of the Rush process invocation that plugins may tap into.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.158.0",
+  "version": "5.158.1-pr5355.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -36,23 +36,23 @@
   "dependencies": {
     "@pnpm/lockfile.types": "~1.0.3",
     "tapable": "2.2.1",
-    "@rushstack/lookup-by-path": "0.7.4",
-    "@rushstack/node-core-library": "5.14.0",
-    "@rushstack/package-deps-hash": "4.4.5",
-    "@rushstack/terminal": "0.15.4"
+    "@rushstack/lookup-by-path": "0.7.6",
+    "@rushstack/node-core-library": "5.14.0-pr5355.0",
+    "@rushstack/terminal": "0.16.0",
+    "@rushstack/package-deps-hash": "4.4.7"
   },
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.8",
     "eslint": "~9.25.1",
     "webpack": "~5.98.0",
-    "@microsoft/rush-lib": "5.158.0",
-    "@rushstack/heft": "0.74.3",
-    "@rushstack/heft-webpack5-plugin": "0.11.39",
-    "@rushstack/ts-command-line": "5.0.2",
-    "@rushstack/webpack-preserve-dynamic-require-plugin": "0.11.106",
+    "@rushstack/heft": "0.74.5",
+    "@microsoft/rush-lib": "5.158.1-pr5355.0",
+    "@rushstack/heft-webpack5-plugin": "0.11.42",
+    "@rushstack/stream-collator": "4.1.109",
+    "@rushstack/ts-command-line": "5.0.3",
     "local-node-rig": "1.0.0",
-    "@rushstack/stream-collator": "4.1.107"
+    "@rushstack/webpack-preserve-dynamic-require-plugin": "0.11.108"
   },
   "scripts": {
     "build": "heft build --clean",