@rushstack/rush-sdk 5.124.6 → 5.125.0

package/dist/rush-lib.d.ts

@@ -15,7 +15,7 @@ import { CommandLineParameterKind } from '@rushstack/ts-command-line';
 import { HookMap } from 'tapable';
 import { IPackageJson } from '@rushstack/node-core-library';
 import { ITerminal } from '@rushstack/terminal';
-import type { ITerminalProvider } from '@rushstack/terminal';
+import { ITerminalProvider } from '@rushstack/terminal';
 import { JsonObject } from '@rushstack/node-core-library';
 import { PackageNameParser } from '@rushstack/node-core-library';
 import type { StdioSummarizer } from '@rushstack/terminal';
@@ -1647,6 +1647,7 @@ export declare interface _IOperationMetadata {
     durationInSeconds: number;
     logPath: string;
     errorLogPath: string;
+    logChunksPath: string;
     cobuildContextId: string | undefined;
     cobuildRunnerId: string | undefined;
 }
@@ -1657,6 +1658,7 @@ export declare interface _IOperationMetadata {
 export declare interface _IOperationMetadataManagerOptions {
     rushProject: RushConfigurationProject;
     phase: IPhase;
+    operation: Operation;
 }
 
 /**
@@ -1677,6 +1679,10 @@ export declare interface IOperationOptions {
      * running the operation.
      */
     runner?: IOperationRunner | undefined;
+    /**
+     * Settings defined in the project configuration for this operation, can be overriden.
+     */
+    settings?: IOperationSettings | undefined;
 }
 
 /**
@@ -1820,6 +1826,13 @@ export declare interface IOperationSettings {
      * calculating final hash value when reading and writing the build cache
      */
     dependsOnAdditionalFiles?: string[];
+    /**
+     * An optional config object for sharding the operation. If specified, the operation will be sharded
+     * into multiple invocations. The `count` property specifies the number of shards to create. The
+     * `shardArgumentFormat` property specifies the format of the argument to pass to the command to
+     * indicate the shard index and count. The default value is `--shard={shardIndex}/{shardCount}`.
+     */
+    sharding?: IRushPhaseSharding;
     /**
      * How many concurrency units this operation should take up during execution. The maximum concurrent units is
      *  determined by the -p flag.
@@ -2204,6 +2217,37 @@ declare interface IRushGitPolicyJson {
     tagSeparator?: string;
 }
 
+/** @alpha */
+export declare interface IRushPhaseSharding {
+    /**
+     * The number of shards to create.
+     */
+    count: number;
+    /**
+     * The format of the argument to pass to the command to indicate the shard index and count.
+     *
+     * @defaultValue `--shard={shardIndex}/{shardCount}`
+     */
+    shardArgumentFormat?: string;
+    /**
+     * An optional argument to pass to the command to indicate the output folder for the shard.
+     *  It must end with `{shardIndex}`.
+     *
+     * @defaultValue `--shard-output-folder=.rush/operations/{phaseName}/shards/{shardIndex}`.
+     */
+    outputFolderArgumentFormat?: string;
+    /**
+     * Configuration for the shard operation. All other configuration applies to the collator operation.
+     */
+    shardOperationSettings?: {
+        /**
+         * How many concurrency units this operation should take up during execution. The maximum concurrent units is
+         *  determined by the -p flag.
+         */
+        weight?: number;
+    };
+}
+
 /**
  * @beta
  */
@@ -2705,11 +2749,20 @@ export declare class Operation {
      *     output, or an operation using NullOperationRunner, which might use a value of 0.
      */
     weight: number;
+    /**
+     * Get the operation settings for this operation, defaults to the values defined in
+     *  the project configuration.
+     */
+    settings: IOperationSettings | undefined;
     constructor(options?: IOperationOptions);
     /**
      * The name of this operation, for logging.
      */
     get name(): string | undefined;
+    /**
+     * If set to true, this operation is considered a no-op and can be considered always skipped for analysis purposes.
+     */
+    get isNoOp(): boolean;
     /**
      * Adds the specified operation as a dependency and updates the consumer list.
      */
@@ -2727,11 +2780,14 @@ export declare class Operation {
  */
 export declare class _OperationMetadataManager {
     readonly stateFile: _OperationStateFile;
-    private _metadataFolder;
-    private _logPath;
-    private _errorLogPath;
-    private _relativeLogPath;
-    private _relativeErrorLogPath;
+    readonly logFilenameIdentifier: string;
+    private readonly _metadataFolder;
+    private readonly _logPath;
+    private readonly _errorLogPath;
+    private readonly _logChunksPath;
+    private readonly _relativeLogPath;
+    private readonly _relativeLogChunksPath;
+    private readonly _relativeErrorLogPath;
     constructor(options: _IOperationMetadataManagerOptions);
     /**
      * Returns the relative paths of the metadata files to project folder.
@@ -2741,10 +2797,10 @@ export declare class _OperationMetadataManager {
      * Example: `.rush/temp/operation/_phase_build/error.log`
      */
     get relativeFilepaths(): string[];
-    saveAsync({ durationInSeconds, cobuildContextId, cobuildRunnerId, logPath, errorLogPath }: _IOperationMetadata): Promise<void>;
-    tryRestoreAsync({ terminal, logPath, errorLogPath }: {
+    saveAsync({ durationInSeconds, cobuildContextId, cobuildRunnerId, logPath, errorLogPath, logChunksPath }: _IOperationMetadata): Promise<void>;
+    tryRestoreAsync({ terminal, terminalProvider, errorLogPath }: {
+        terminalProvider: ITerminalProvider;
         terminal: ITerminal;
-        logPath: string;
         errorLogPath: string;
     }): Promise<void>;
 }
@@ -4495,7 +4551,7 @@ export declare class RushProjectConfiguration {
      * Examines the list of source files for the project and the target phase and returns a reason
      * why the project cannot enable the build cache for that phase, or undefined if it is safe to so do.
      */
-    getCacheDisabledReason(trackedFileNames: Iterable<string>, phaseName: string): string | undefined;
+    getCacheDisabledReason(trackedFileNames: Iterable<string>, phaseName: string, isNoOp: boolean): string | undefined;
     /**
      * Loads the rush-project.json data for the specified project.
      */

package/dist/tsdoc-metadata.json

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

package/lib/api/CommandLineConfiguration.d.ts

@@ -156,13 +156,6 @@ export declare class CommandLineConfiguration {
      */
     static loadFromFileOrDefault(jsonFilePath?: string): CommandLineConfiguration;
     prependAdditionalPathFolder(pathFolder: string): void;
-    /**
-     * This function replaces colons (":") with underscores ("_").
-     *
-     * ts-command-line restricts command names to lowercase letters, numbers, underscores, and colons.
-     * Replacing colons with underscores produces a filesystem-safe name.
-     */
-    private _normalizeNameForLogFilenameIdentifiers;
     private _translateBulkCommandToPhasedCommand;
 }
 export {};

package/lib/api/RushProjectConfiguration.d.ts

@@ -27,6 +27,36 @@ export interface IRushProjectJson {
     disableBuildCacheForProject?: boolean;
     operationSettings?: IOperationSettings[];
 }
+/** @alpha */
+export interface IRushPhaseSharding {
+    /**
+     * The number of shards to create.
+     */
+    count: number;
+    /**
+     * The format of the argument to pass to the command to indicate the shard index and count.
+     *
+     * @defaultValue `--shard={shardIndex}/{shardCount}`
+     */
+    shardArgumentFormat?: string;
+    /**
+     * An optional argument to pass to the command to indicate the output folder for the shard.
+     *  It must end with `{shardIndex}`.
+     *
+     * @defaultValue `--shard-output-folder=.rush/operations/{phaseName}/shards/{shardIndex}`.
+     */
+    outputFolderArgumentFormat?: string;
+    /**
+     * Configuration for the shard operation. All other configuration applies to the collator operation.
+     */
+    shardOperationSettings?: {
+        /**
+         * How many concurrency units this operation should take up during execution. The maximum concurrent units is
+         *  determined by the -p flag.
+         */
+        weight?: number;
+    };
+}
 /**
  * @alpha
  */
@@ -73,6 +103,13 @@ export interface IOperationSettings {
      * calculating final hash value when reading and writing the build cache
      */
     dependsOnAdditionalFiles?: string[];
+    /**
+     * An optional config object for sharding the operation. If specified, the operation will be sharded
+     * into multiple invocations. The `count` property specifies the number of shards to create. The
+     * `shardArgumentFormat` property specifies the format of the argument to pass to the command to
+     * indicate the shard index and count. The default value is `--shard={shardIndex}/{shardCount}`.
+     */
+    sharding?: IRushPhaseSharding;
     /**
      * How many concurrency units this operation should take up during execution. The maximum concurrent units is
      *  determined by the -p flag.
@@ -111,7 +148,7 @@ export declare class RushProjectConfiguration {
      * Examines the list of source files for the project and the target phase and returns a reason
      * why the project cannot enable the build cache for that phase, or undefined if it is safe to so do.
      */
-    getCacheDisabledReason(trackedFileNames: Iterable<string>, phaseName: string): string | undefined;
+    getCacheDisabledReason(trackedFileNames: Iterable<string>, phaseName: string, isNoOp: boolean): string | undefined;
     /**
      * Loads the rush-project.json data for the specified project.
      */

package/lib/api/packageManager/PnpmPackageManager.d.ts

@@ -11,13 +11,6 @@ export declare class PnpmPackageManager extends PackageManager {
      * Example: `pnpmfile.js` or `.pnpmfile.cjs`
      */
     readonly pnpmfileFilename: string;
-    /**
-     * The filename of the shrinkwrap file of a subspace that is used by the package manager.
-     *
-     * @remarks
-     * Example: `.pnpmfile-subspace.cjs`
-     */
-    subspacePnpmfileFilename: string;
     /** @internal */
     constructor(version: string);
 }

package/lib/cli/actions/CheckAction.d.ts

@@ -4,6 +4,7 @@ export declare class CheckAction extends BaseRushAction {
     private readonly _terminal;
     private readonly _jsonFlag;
     private readonly _verboseFlag;
+    private readonly _subspaceParameter;
     constructor(parser: RushCommandLineParser);
     protected runAsync(): Promise<void>;
 }

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

@@ -49,6 +49,7 @@ export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandC
     private readonly _ignoreHooksParameter;
     private readonly _watchParameter;
     private readonly _timelineParameter;
+    private readonly _cobuildPlanParameter;
     private readonly _installParameter;
     private readonly _noIPCParameter;
     constructor(options: IPhasedScriptActionOptions);

package/lib/index.d.ts

@@ -19,7 +19,7 @@ export { EnvironmentConfiguration, EnvironmentVariableNames, IEnvironmentConfigu
 export { RushConstants } from './logic/RushConstants';
 export { PackageManagerName, PackageManager } from './api/packageManager/PackageManager';
 export { RushConfigurationProject } from './api/RushConfigurationProject';
-export { IRushProjectJson as _IRushProjectJson, IOperationSettings, RushProjectConfiguration } from './api/RushProjectConfiguration';
+export { IRushProjectJson as _IRushProjectJson, IOperationSettings, RushProjectConfiguration, IRushPhaseSharding } from './api/RushProjectConfiguration';
 export { RushUserConfiguration } from './api/RushUserConfiguration';
 export { RushGlobalFolder as _RushGlobalFolder } from './api/RushGlobalFolder';
 export { ApprovedPackagesItem, ApprovedPackagesConfiguration } from './api/ApprovedPackagesConfiguration';

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

@@ -4,7 +4,9 @@ import { ProjectBuildCache } from '../buildCache/ProjectBuildCache';
 import type { IOperationSettings } from '../../api/RushProjectConfiguration';
 import { ProjectLogWritable } from './ProjectLogWritable';
 import type { CobuildConfiguration } from '../../api/CobuildConfiguration';
+import { DisjointSet } from '../cobuild/DisjointSet';
 import { PeriodicCallback } from './PeriodicCallback';
+import type { Operation } from './Operation';
 import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
 import type { ProjectChangeAnalyzer } from '../ProjectChangeAnalyzer';
 import type { BuildCacheConfiguration } from '../../api/BuildCacheConfiguration';
@@ -49,4 +51,7 @@ export declare class CacheableOperationPlugin implements IPhasedCommandPlugin {
     private _createBuildCacheTerminal;
     private _tryGetBuildCacheProjectLogWritable;
 }
+export declare function clusterOperations(initialClusters: DisjointSet<Operation>, operationBuildCacheMap: Map<Operation, {
+    cacheDisabledReason: string | undefined;
+}>): void;
 //# sourceMappingURL=CacheableOperationPlugin.d.ts.map

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

@@ -1,6 +1,7 @@
 import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 import type { IPhase } from '../../api/CommandLineConfiguration';
 import type { IOperationRunner } from './IOperationRunner';
+import type { IOperationSettings } from '../../api/RushProjectConfiguration';
 /**
  * Options for constructing a new Operation.
  * @alpha
@@ -19,6 +20,10 @@ export interface IOperationOptions {
      * running the operation.
      */
     runner?: IOperationRunner | undefined;
+    /**
+     * Settings defined in the project configuration for this operation, can be overriden.
+     */
+    settings?: IOperationSettings | undefined;
 }
 /**
  * The `Operation` class is a node in the dependency graph of work that needs to be scheduled by the
@@ -63,11 +68,20 @@ export declare class Operation {
      *     output, or an operation using NullOperationRunner, which might use a value of 0.
      */
     weight: number;
+    /**
+     * Get the operation settings for this operation, defaults to the values defined in
+     *  the project configuration.
+     */
+    settings: IOperationSettings | undefined;
     constructor(options?: IOperationOptions);
     /**
      * The name of this operation, for logging.
      */
     get name(): string | undefined;
+    /**
+     * If set to true, this operation is considered a no-op and can be considered always skipped for analysis purposes.
+     */
+    get isNoOp(): boolean;
     /**
      * Adds the specified operation as a dependency and updates the consumer list.
      */

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

@@ -1,13 +1,15 @@
-import type { ITerminal } from '@rushstack/terminal';
+import { type ITerminalChunk, type ITerminal, type ITerminalProvider } from '@rushstack/terminal';
 import { OperationStateFile } from './OperationStateFile';
 import type { IPhase } from '../../api/CommandLineConfiguration';
 import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
+import type { Operation } from './Operation';
 /**
  * @internal
  */
 export interface IOperationMetadataManagerOptions {
     rushProject: RushConfigurationProject;
     phase: IPhase;
+    operation: Operation;
 }
 /**
  * @internal
@@ -16,9 +18,13 @@ export interface IOperationMetaData {
     durationInSeconds: number;
     logPath: string;
     errorLogPath: string;
+    logChunksPath: string;
     cobuildContextId: string | undefined;
     cobuildRunnerId: string | undefined;
 }
+export interface ILogChunkStorage {
+    chunks: ITerminalChunk[];
+}
 /**
  * A helper class for managing the meta files of a operation.
  *
@@ -26,11 +32,14 @@ export interface IOperationMetaData {
  */
 export declare class OperationMetadataManager {
     readonly stateFile: OperationStateFile;
-    private _metadataFolder;
-    private _logPath;
-    private _errorLogPath;
-    private _relativeLogPath;
-    private _relativeErrorLogPath;
+    readonly logFilenameIdentifier: string;
+    private readonly _metadataFolder;
+    private readonly _logPath;
+    private readonly _errorLogPath;
+    private readonly _logChunksPath;
+    private readonly _relativeLogPath;
+    private readonly _relativeLogChunksPath;
+    private readonly _relativeErrorLogPath;
     constructor(options: IOperationMetadataManagerOptions);
     /**
      * Returns the relative paths of the metadata files to project folder.
@@ -40,11 +49,12 @@ export declare class OperationMetadataManager {
      * Example: `.rush/temp/operation/_phase_build/error.log`
      */
     get relativeFilepaths(): string[];
-    saveAsync({ durationInSeconds, cobuildContextId, cobuildRunnerId, logPath, errorLogPath }: IOperationMetaData): Promise<void>;
-    tryRestoreAsync({ terminal, logPath, errorLogPath }: {
+    saveAsync({ durationInSeconds, cobuildContextId, cobuildRunnerId, logPath, errorLogPath, logChunksPath }: IOperationMetaData): Promise<void>;
+    tryRestoreAsync({ terminal, terminalProvider, errorLogPath }: {
+        terminalProvider: ITerminalProvider;
         terminal: ITerminal;
-        logPath: string;
         errorLogPath: string;
     }): Promise<void>;
 }
+export declare function normalizeNameForLogFilenameIdentifiers(name: string): string;
 //# sourceMappingURL=OperationMetadataManager.d.ts.map

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

@@ -5,20 +5,53 @@ export declare class ProjectLogWritable extends TerminalWritable {
     private readonly _terminal;
     readonly logPath: string;
     readonly errorLogPath: string;
+    readonly logChunksPath: string;
     readonly relativeLogPath: string;
     readonly relativeErrorLogPath: string;
+    readonly relativeLogChunksPath: string;
     private _logWriter;
     private _errorLogWriter;
-    constructor(project: RushConfigurationProject, terminal: CollatedTerminal, logFilenameIdentifier: string);
+    /**
+     * A new terminal stream that writes all log chunks to a JSON format so they can be faithfully reconstructed
+     *  during build cache restores. This is used for adding warning + error messages in cobuilds where the original
+     *  logs cannot be completely restored from the existing `all.log` and `error.log` files.
+     *
+     * Example output:
+     * libraries/rush-lib/.rush/temp/operations/rush-lib._phase_build.chunks.jsonl
+     * ```
+     * {"kind":"O","text":"Invoking: heft run --only build -- --clean \n"}
+     * {"kind":"O","text":" ---- build started ---- \n"}
+     * {"kind":"O","text":"[build:clean] Deleted 0 files and 5 folders\n"}
+     * {"kind":"O","text":"[build:typescript] Using TypeScript version 5.4.2\n"}
+     * {"kind":"O","text":"[build:lint] Using ESLint version 8.57.0\n"}
+     * {"kind":"E","text":"[build:lint] Warning: libraries/rush-lib/src/logic/operations/LogChunksWritable.ts:15:7 - (@typescript-eslint/typedef) Expected test to have a type annotation.\n"}
+     * {"kind":"E","text":"[build:lint] Warning: libraries/rush-lib/src/logic/operations/LogChunksWritable.ts:15:7 - (@typescript-eslint/no-unused-vars) 'test' is assigned a value but never used.\n"}
+     * {"kind":"O","text":"[build:typescript] Copied 1138 folders or files and linked 0 files\n"}
+     * {"kind":"O","text":"[build:webpack] Using Webpack version 5.82.1\n"}
+     * {"kind":"O","text":"[build:webpack] Running Webpack compilation\n"}
+     * {"kind":"O","text":"[build:api-extractor] Using API Extractor version 7.43.1\n"}
+     * {"kind":"O","text":"[build:api-extractor] Analysis will use the bundled TypeScript version 5.4.2\n"}
+     * {"kind":"O","text":"[build:copy-mock-flush-telemetry-plugin] Copied 1260 folders or files and linked 5 files\n"}
+     * {"kind":"O","text":" ---- build finished (6.856s) ---- \n"}
+     * {"kind":"O","text":"-------------------- Finished (6.858s) --------------------\n"}
+     * ```
+     */
+    private _chunkWriter;
+    private _enableChunkedOutput;
+    constructor(project: RushConfigurationProject, terminal: CollatedTerminal, logFilenameIdentifier: string, options?: {
+        enableChunkedOutput?: boolean;
+    });
     static getLogFilePaths({ project, logFilenameIdentifier, isLegacyLog }: {
         project: RushConfigurationProject;
         logFilenameIdentifier: string;
         isLegacyLog?: boolean;
     }): {
         logPath: string;
+        logChunksPath: string;
         errorLogPath: string;
         relativeLogPath: string;
         relativeErrorLogPath: string;
+        relativeLogChunksPath: string;
     };
     writeChunk(chunk: ITerminalChunk): void;
     protected onWriteChunk(chunk: ITerminalChunk): void;

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

@@ -0,0 +1,9 @@
+import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+export declare const PLUGIN_NAME: 'ShardedPhasedOperationPlugin';
+/**
+ * Phased command that shards a phase into multiple operations.
+ */
+export declare class ShardedPhasedOperationPlugin implements IPhasedCommandPlugin {
+    apply(hooks: PhasedCommandHooks): void;
+}
+//# sourceMappingURL=ShardedPhaseOperationPlugin.d.ts.map

package/lib/logic/operations/ShardedPhaseOperationPlugin.js

@@ -0,0 +1 @@
+module.exports = require("../../../lib-shim/index")._rushSdk_loadInternalModule("logic/operations/ShardedPhaseOperationPlugin");

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

@@ -1,6 +1,7 @@
 import type { IPhase } from '../../api/CommandLineConfiguration';
 import type { RushConfiguration } from '../../api/RushConfiguration';
 import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
+import { type IEnvironment } from '../../utilities/Utilities';
 import type { IOperationRunner, IOperationRunnerContext } from './IOperationRunner';
 import { OperationStatus } from './OperationStatus';
 export interface IOperationRunnerOptions {
@@ -9,6 +10,7 @@ export interface IOperationRunnerOptions {
     commandToRun: string;
     displayName: string;
     phase: IPhase;
+    environment?: IEnvironment;
 }
 /**
  * An `IOperationRunner` subclass that performs an operation via a shell command.
@@ -24,6 +26,7 @@ export declare class ShellOperationRunner implements IOperationRunner {
     private readonly _commandToRun;
     private readonly _rushProject;
     private readonly _rushConfiguration;
+    private readonly _environment?;
     constructor(options: IOperationRunnerOptions);
     executeAsync(context: IOperationRunnerContext): Promise<OperationStatus>;
     getConfigHash(): string;

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

@@ -1,6 +1,8 @@
 import type { IPhase } from '../../api/CommandLineConfiguration';
 import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+import type { RushConfiguration } from '../../api/RushConfiguration';
+import type { IOperationRunner } from './IOperationRunner';
 export declare const PLUGIN_NAME: 'ShellOperationRunnerPlugin';
 /**
  * Core phased command plugin that provides the functionality for executing an operation via shell command.
@@ -8,6 +10,14 @@ export declare const PLUGIN_NAME: 'ShellOperationRunnerPlugin';
 export declare class ShellOperationRunnerPlugin implements IPhasedCommandPlugin {
     apply(hooks: PhasedCommandHooks): void;
 }
+export declare function initializeShellOperationRunner(options: {
+    phase: IPhase;
+    project: RushConfigurationProject;
+    displayName: string;
+    rushConfiguration: RushConfiguration;
+    commandToRun: string | undefined;
+}): IOperationRunner;
+export declare function getScriptToRun(rushProject: RushConfigurationProject, commandToRun: string, shellCommand: string | undefined): string | undefined;
 /**
  * Memoizer for custom parameter values by phase
  * @returns A function that returns the custom parameter values for a given phase

package/lib/logic/versionMismatch/VersionMismatchFinder.d.ts

@@ -8,6 +8,7 @@ export interface IVersionMismatchFinderOptions {
 export interface IVersionMismatchFinderRushCheckOptions extends IVersionMismatchFinderOptions {
     printAsJson?: boolean | undefined;
     truncateLongPackageNameLists?: boolean | undefined;
+    subspace?: Subspace | undefined;
 }
 export interface IVersionMismatchFinderEnsureConsistentVersionsOptions extends IVersionMismatchFinderOptions {
 }

package/lib/utilities/Utilities.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import * as child_process from 'child_process';
 import type { RushConfiguration } from '../api/RushConfiguration';
 import { syncNpmrc } from './npmrcUtilities';
@@ -126,7 +127,7 @@ export declare class Utilities {
      *
      * It's basically the same as executeCommand() except that it returns a Promise.
      */
-    static executeCommandAndInspectOutputAsync(options: IExecuteCommandOptions, onStdoutStreamChunk?: (chunk: string) => string | void, onExit?: (code: number, signal: string) => void): Promise<void>;
+    static executeCommandAndInspectOutputAsync(options: IExecuteCommandOptions, onStdoutStreamChunk?: (chunk: string) => string | void, onExit?: (exitCode: number | null, signal: NodeJS.Signals | null) => void): Promise<void>;
     /**
      * Executes the command with the specified command-line parameters, and waits for it to complete.
      * The current directory will be set to the specified workingDirectory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.124.6",
+  "version": "5.125.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -25,17 +25,17 @@
   "dependencies": {
     "@types/node-fetch": "2.6.2",
     "tapable": "2.2.1",
-    "@rushstack/node-core-library": "4.3.0",
-    "@rushstack/terminal": "0.11.0"
+    "@rushstack/node-core-library": "5.1.0",
+    "@rushstack/terminal": "0.12.0"
   },
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.0",
-    "@rushstack/heft": "0.66.8",
-    "@microsoft/rush-lib": "5.124.6",
-    "@rushstack/stream-collator": "4.1.46",
+    "@rushstack/heft": "0.66.12",
     "local-node-rig": "1.0.0",
-    "@rushstack/ts-command-line": "4.20.1"
+    "@microsoft/rush-lib": "5.125.0",
+    "@rushstack/stream-collator": "4.1.50",
+    "@rushstack/ts-command-line": "4.21.2"
   },
   "scripts": {
     "build": "heft build --clean",