@rushstack/rush-sdk 5.112.2-pr4485.2 → 5.112.2-pr4485.3

package/dist/rush-lib.d.ts

@@ -1339,6 +1339,12 @@ export declare interface IExperimentsJson {
      * If true, Rush will not allow node_modules in the repo folder or in parent folders.
      */
     forbidPhantomResolvableNodeModulesFolders?: boolean;
+    /**
+     * If true, when running in watch mode, Rush will check for phase scripts named `_phase:<name>:ipc` and run them instead
+     * of `_phase:<name>` if they exist. The created child process will be provided with an IPC channel and expected to persist
+     * across invocations.
+     */
+    useIPCScriptsInWatchMode?: boolean;
 }
 
 /**
@@ -1743,13 +1749,6 @@ export declare interface IOperationSettings {
      * calculating final hash value when reading and writing the build cache
      */
     dependsOnAdditionalFiles?: string[];
-    /**
-     * When running this operation in watch mode, enable IPC functionality. This allows reusing a long-lived child
-     * process instead of spawning a new child process for each incremental build.
-     *
-     * Implicitly disables the build cache for this operation.
-     */
-    useIPCInWatchMode?: boolean;
 }
 
 /**
@@ -2868,6 +2867,10 @@ export declare class PhasedCommandHooks {
     readonly afterExecuteOperation: AsyncSeriesHook<[
     IOperationRunnerContext & IOperationExecutionResult
     ]>;
+    /**
+     * Hook invoked to shutdown long-lived work in plugins.
+     */
+    readonly shutdown: SyncHook<void>;
     /**
      * Hook invoked after a run has finished and the command is watching for changes.
      * May be used to display additional relevant data to the user.

package/lib/api/ExperimentsConfiguration.d.ts

@@ -59,6 +59,12 @@ export interface IExperimentsJson {
      * If true, Rush will not allow node_modules in the repo folder or in parent folders.
      */
     forbidPhantomResolvableNodeModulesFolders?: boolean;
+    /**
+     * If true, when running in watch mode, Rush will check for phase scripts named `_phase:<name>:ipc` and run them instead
+     * of `_phase:<name>` if they exist. The created child process will be provided with an IPC channel and expected to persist
+     * across invocations.
+     */
+    useIPCScriptsInWatchMode?: boolean;
 }
 /**
  * Use this class to load the "common/config/rush/experiments.json" config file.

package/lib/api/RushProjectConfiguration.d.ts

@@ -73,13 +73,6 @@ export interface IOperationSettings {
      * calculating final hash value when reading and writing the build cache
      */
     dependsOnAdditionalFiles?: string[];
-    /**
-     * When running this operation in watch mode, enable IPC functionality. This allows reusing a long-lived child
-     * process instead of spawning a new child process for each incremental build.
-     *
-     * Implicitly disables the build cache for this operation.
-     */
-    useIPCInWatchMode?: boolean;
 }
 /**
  * Use this class to load the "config/rush-project.json" config file.

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

@@ -50,6 +50,7 @@ export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandC
     private readonly _watchParameter;
     private readonly _timelineParameter;
     private readonly _installParameter;
+    private readonly _noIPCParameter;
     constructor(options: IPhasedScriptActionOptions);
     runAsync(): Promise<void>;
     private _runInitialPhases;

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

@@ -1,8 +1,18 @@
+import type { IPhase } from '../../api/CommandLineConfiguration';
+import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+export declare const PLUGIN_NAME: 'ShellOperationRunnerPlugin';
 /**
  * Core phased command plugin that provides the functionality for executing an operation via shell command.
  */
 export declare class ShellOperationRunnerPlugin implements IPhasedCommandPlugin {
     apply(hooks: PhasedCommandHooks): void;
 }
+/**
+ * Memoizer for custom parameter values by phase
+ * @returns A function that returns the custom parameter values for a given phase
+ */
+export declare function getCustomParameterValuesByPhase(): (phase: IPhase) => ReadonlyArray<string>;
+export declare function formatCommand(rawCommand: string, customParameterValues: ReadonlyArray<string>): string;
+export declare function getDisplayName(phase: IPhase, project: RushConfigurationProject): string;
 //# sourceMappingURL=ShellOperationRunnerPlugin.d.ts.map

package/lib/pluginFramework/PhasedCommandHooks.d.ts

@@ -131,6 +131,10 @@ export declare class PhasedCommandHooks {
     readonly afterExecuteOperation: AsyncSeriesHook<[
         IOperationRunnerContext & IOperationExecutionResult
     ]>;
+    /**
+     * Hook invoked to shutdown long-lived work in plugins.
+     */
+    readonly shutdown: SyncHook<void>;
     /**
      * Hook invoked after a run has finished and the command is watching for changes.
      * May be used to display additional relevant data to the user.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.112.2-pr4485.2",
+  "version": "5.112.2-pr4485.3",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -30,12 +30,12 @@
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.0",
-    "@microsoft/rush-lib": "5.112.2-pr4485.2",
-    "local-node-rig": "1.0.0",
-    "@rushstack/stream-collator": "4.1.18",
+    "@microsoft/rush-lib": "5.112.2-pr4485.3",
     "@rushstack/heft": "0.64.0",
-    "@rushstack/ts-command-line": "4.17.1",
-    "@rushstack/terminal": "0.7.17"
+    "@rushstack/stream-collator": "4.1.18",
+    "local-node-rig": "1.0.0",
+    "@rushstack/terminal": "0.7.17",
+    "@rushstack/ts-command-line": "4.17.1"
   },
   "scripts": {
     "build": "heft build --clean",