@rushstack/rush-sdk 5.104.1 → 5.106.0

package/dist/rush-lib.d.ts

@@ -376,7 +376,17 @@ export declare class CredentialCache {
  *
  * @beta
  */
-export declare type CustomTipId = 'TIP_RUSH_INCONSISTENT_VERSIONS' | string;
+export declare enum CustomTipId {
+    TIP_PNPM_UNEXPECTED_STORE = "TIP_PNPM_UNEXPECTED_STORE",
+    TIP_RUSH_INCONSISTENT_VERSIONS = "TIP_RUSH_INCONSISTENT_VERSIONS",
+    TIP_PNPM_NO_MATCHING_VERSION = "TIP_PNPM_NO_MATCHING_VERSION",
+    TIP_PNPM_NO_MATCHING_VERSION_INSIDE_WORKSPACE = "TIP_PNPM_NO_MATCHING_VERSION_INSIDE_WORKSPACE",
+    TIP_PNPM_PEER_DEP_ISSUES = "TIP_PNPM_PEER_DEP_ISSUES",
+    TIP_PNPM_OUTDATED_LOCKFILE = "TIP_PNPM_OUTDATED_LOCKFILE",
+    TIP_PNPM_TARBALL_INTEGRITY = "TIP_PNPM_TARBALL_INTEGRITY",
+    TIP_PNPM_MISMATCHED_RELEASE_CHANNEL = "TIP_PNPM_MISMATCHED_RELEASE_CHANNEL",
+    TIP_PNPM_INVALID_NODE_VERSION = "TIP_PNPM_INVALID_NODE_VERSION"
+}
 
 /**
  * Used to access the `common/config/rush/custom-tips.json` config file,
@@ -393,27 +403,82 @@ export declare class CustomTipsConfiguration {
      */
     readonly configuration: Readonly<ICustomTipsJson>;
     /**
-     * The list of identifiers that are allowed to be used in the "tipId" field
-     * of the config file.
+     * A registry mapping custom tip IDs to their corresponding metadata.
+     *
+     * @remarks
+     * This registry is used to look up metadata for custom tips based on their IDs. The metadata includes
+     * information such as the severity level, the type of tip, and an optional matching function.
+     *
+     * Each key in the registry corresponds to a `CustomTipIdEnum` value, and each value is an object
+     * implementing the `ICustomTipInfo` interface.
+     *
+     * @example
+     * ```typescript
+     * const tipInfo = CustomTipsConfiguration.customTipRegistry[CustomTipIdEnum.TIP_RUSH_INCONSISTENT_VERSIONS];
+     * console.log(tipInfo.severity);  // Output: CustomTipSeverity.Error
+     * ```
+     *
+     * See {@link CustomTipId} for the list of custom tip IDs.
+     * See {@link ICustomTipInfo} for the structure of the metadata.
      */
-    static readonly supportedTipIds: ReadonlySet<string>;
+    static customTipRegistry: Readonly<Record<CustomTipId, ICustomTipInfo>>;
     constructor(configFilename: string);
-    private _formatTipMessage;
     /**
      * If custom-tips.json defines a tip for the specified tipId,
      * display the tip on the terminal.
+     *
+     * @remarks
+     * The severity of the tip is defined in ${@link CustomTipsConfiguration.customTipRegistry}.
+     * If you want to change the severity specifically for this call, use other API like {@link CustomTipsConfiguration._showErrorTip}.
+     *
+     * @internal
      */
-    showInfoTip(terminal: ITerminal, tipId: CustomTipId): void;
+    _showTip(terminal: ITerminal, tipId: CustomTipId): void;
     /**
      * If custom-tips.json defines a tip for the specified tipId,
      * display the tip on the terminal.
+     * @internal
      */
-    showWarningTip(terminal: ITerminal, tipId: CustomTipId): void;
+    _showInfoTip(terminal: ITerminal, tipId: CustomTipId): void;
     /**
      * If custom-tips.json defines a tip for the specified tipId,
      * display the tip on the terminal.
+     * @internal
+     */
+    _showWarningTip(terminal: ITerminal, tipId: CustomTipId): void;
+    /**
+     * If custom-tips.json defines a tip for the specified tipId,
+     * display the tip on the terminal.
+     * @internal
      */
-    showErrorTip(terminal: ITerminal, tipId: CustomTipId): void;
+    _showErrorTip(terminal: ITerminal, tipId: CustomTipId): void;
+    private _formatMessageHeader;
+    private _writeMessageWithPipes;
+}
+
+/**
+ * The severity of a custom tip.
+ * It determines the printing severity ("Error" = red, "Warning" = yellow, "Info" = normal).
+ *
+ * @beta
+ */
+export declare enum CustomTipSeverity {
+    Warning = "Warning",
+    Error = "Error",
+    Info = "Info"
+}
+
+/**
+ * The type of the custom tip.
+ *
+ * @remarks
+ * There might be types like `git` in the future.
+ *
+ * @beta
+ */
+export declare enum CustomTipType {
+    rush = "rush",
+    pnpm = "pnpm"
 }
 
 /**
@@ -1082,6 +1147,39 @@ export declare interface ICredentialCacheOptions {
     supportEditing: boolean;
 }
 
+/**
+ * Metadata for a custom tip.
+ *
+ * @remarks
+ * This differs from the  {@link ICustomTipItemJson} interface in that these are not configurable by the user;
+ * it's the inherent state of a custom tip. For example, the custom tip for `ERR_PNPM_NO_MATCHING_VERSION`
+ * has a inherent severity of `Error`, and a inherent match function that rush maintainer defines.
+ *
+ * @beta
+ */
+export declare interface ICustomTipInfo {
+    tipId: CustomTipId;
+    /**
+     * The severity of the custom tip. It will determine the printing severity ("Error" = red, "Warning" = yellow, "Info" = normal).
+     *
+     * @remarks
+     *  The severity should be consistent with the original message, unless there are strong reasons not to.
+     */
+    severity: CustomTipSeverity;
+    /**
+     * The type of the custom tip.
+     */
+    type: CustomTipType;
+    /**
+     * The function to determine how to match this tipId.
+     *
+     * @remarks
+     * This function might need to be updated if the depending package is updated.
+     * For example, if `pnpm` change the error logs for "ERR_PNPM_NO_MATCHING_VERSION", we will need to update the match function accordingly.
+     */
+    isMatch?: (str: string) => boolean;
+}
+
 /**
  * An item from the {@link ICustomTipsJson.customTips} list.
  * @beta
@@ -1097,11 +1195,6 @@ export declare interface ICustomTipItemJson {
      * (REQUIRED) The message text to be displayed for this tip.
      */
     message: string;
-    /**
-     *  Overrides the "defaultMessagePrefix" for this tip.
-     * Specify an empty string to omit the "defaultMessagePrefix" entirely.
-     */
-    messagePrefix?: string;
 }
 
 /**
@@ -1110,11 +1203,6 @@ export declare interface ICustomTipItemJson {
  * @beta
  */
 export declare interface ICustomTipsJson {
-    /**
-     * If specified, this prefix will be prepended to any the tip messages when they are displayed.
-     * The default value is an empty string.
-     */
-    defaultMessagePrefix?: string;
     /**
      *  Specifies the custom tips to be displayed by Rush.
      */
@@ -1502,6 +1590,11 @@ export declare interface IOperationRunner {
      * exit code
      */
     warningsAreAllowed: boolean;
+    /**
+     * If set to true, this operation is considered a no-op and can be considered always skipped for
+     * analysis purposes.
+     */
+    readonly isNoOp?: boolean;
     /**
      * Method to be executed for the operation.
      */
@@ -1718,7 +1811,7 @@ export declare interface _IPnpmOptionsJson extends IPackageManagerOptionsJsonBas
     /**
      * {@inheritDoc PnpmOptionsConfiguration.pnpmStore}
      */
-    pnpmStore?: PnpmStoreOptions;
+    pnpmStore?: PnpmStoreLocation;
     /**
      * {@inheritDoc PnpmOptionsConfiguration.strictPeerDependencies}
      */
@@ -1759,6 +1852,10 @@ export declare interface _IPnpmOptionsJson extends IPackageManagerOptionsJsonBas
      * {@inheritDoc PnpmOptionsConfiguration.unsupportedPackageJsonSettings}
      */
     unsupportedPackageJsonSettings?: unknown;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.resolutionMode}
+     */
+    resolutionMode?: PnpmResolutionMode;
 }
 
 declare interface IPnpmPackageExtension {
@@ -2752,7 +2849,19 @@ export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfi
      *  - local: Use the standard Rush store path: common/temp/pnpm-store
      *  - global: Use PNPM's global store path
      */
-    readonly pnpmStore: PnpmStoreOptions;
+    readonly pnpmStore: PnpmStoreLocation;
+    /**
+     * This setting determines PNPM's `resolution-mode`  option. The default value is `highest`.
+     *
+     * @remarks
+     * Be aware that the PNPM 8 initially defaulted to `lowest` instead of  `highest`, but PNPM
+     * reverted this decision in 8.6.12 because it caused confusion for users.  Rush 5.106.0 and newer
+     * avoids this confusion by consistently defaulting to `highest` when `resolutionMode` is not
+     * explicitly set in pnpm-config.json or .npmrc, regardless of your PNPM version.
+     *
+     * PNPM documentation: https://pnpm.io/npmrc#resolution-mode
+     */
+    readonly resolutionMode: PnpmResolutionMode | undefined;
     /**
      * The path for PNPM to use as the store directory.
      *
@@ -2896,11 +3005,27 @@ export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfi
     updateGlobalPatchedDependencies(patchedDependencies: Record<string, string> | undefined): void;
 }
 
+/**
+ * Possible values for the `resolutionMode` setting in Rush's pnpm-config.json file.
+ * @remarks
+ * These modes correspond to PNPM's `resolution-mode` values, which are documented here:
+ * {@link https://pnpm.io/npmrc#resolution-mode}
+ *
+ * @public
+ */
+export declare type PnpmResolutionMode = 'highest' | 'time-based' | 'lowest-direct';
+
 /**
  * This represents the available PNPM store options
  * @public
  */
-export declare type PnpmStoreOptions = 'local' | 'global';
+export declare type PnpmStoreLocation = 'local' | 'global';
+
+/**
+ * @deprecated Use {@link PnpmStoreLocation} instead
+ * @public
+ */
+export declare type PnpmStoreOptions = PnpmStoreLocation;
 
 /**
  * @beta
@@ -4092,7 +4217,7 @@ export declare class RushProjectConfiguration {
      * Load the rush-project.json data for all selected projects.
      * Validate compatibility of output folders across all selected phases.
      */
-    static tryLoadAndValidateForProjectsAsync(projects: Iterable<RushConfigurationProject>, phases: ReadonlySet<IPhase>, terminal: ITerminal): Promise<ReadonlyMap<RushConfigurationProject, RushProjectConfiguration>>;
+    static tryLoadForProjectsAsync(projects: Iterable<RushConfigurationProject>, terminal: ITerminal): Promise<ReadonlyMap<RushConfigurationProject, RushProjectConfiguration>>;
     private static _tryLoadJsonForProjectAsync;
     private static _getRushProjectConfiguration;
 }

package/lib/api/CustomTipsConfiguration.d.ts

@@ -5,11 +5,6 @@ import { ITerminal } from '@rushstack/node-core-library';
  * @beta
  */
 export interface ICustomTipsJson {
-    /**
-     * If specified, this prefix will be prepended to any the tip messages when they are displayed.
-     * The default value is an empty string.
-     */
-    defaultMessagePrefix?: string;
     /**
      *  Specifies the custom tips to be displayed by Rush.
      */
@@ -30,11 +25,6 @@ export interface ICustomTipItemJson {
      * (REQUIRED) The message text to be displayed for this tip.
      */
     message: string;
-    /**
-     *  Overrides the "defaultMessagePrefix" for this tip.
-     * Specify an empty string to omit the "defaultMessagePrefix" entirely.
-     */
-    messagePrefix?: string;
 }
 /**
  * An identifier representing a Rush message that can be customized by
@@ -48,7 +38,72 @@ export interface ICustomTipItemJson {
  *
  * @beta
  */
-export type CustomTipId = 'TIP_RUSH_INCONSISTENT_VERSIONS' | string;
+export declare enum CustomTipId {
+    TIP_PNPM_UNEXPECTED_STORE = "TIP_PNPM_UNEXPECTED_STORE",
+    TIP_RUSH_INCONSISTENT_VERSIONS = "TIP_RUSH_INCONSISTENT_VERSIONS",
+    TIP_PNPM_NO_MATCHING_VERSION = "TIP_PNPM_NO_MATCHING_VERSION",
+    TIP_PNPM_NO_MATCHING_VERSION_INSIDE_WORKSPACE = "TIP_PNPM_NO_MATCHING_VERSION_INSIDE_WORKSPACE",
+    TIP_PNPM_PEER_DEP_ISSUES = "TIP_PNPM_PEER_DEP_ISSUES",
+    TIP_PNPM_OUTDATED_LOCKFILE = "TIP_PNPM_OUTDATED_LOCKFILE",
+    TIP_PNPM_TARBALL_INTEGRITY = "TIP_PNPM_TARBALL_INTEGRITY",
+    TIP_PNPM_MISMATCHED_RELEASE_CHANNEL = "TIP_PNPM_MISMATCHED_RELEASE_CHANNEL",
+    TIP_PNPM_INVALID_NODE_VERSION = "TIP_PNPM_INVALID_NODE_VERSION"
+}
+/**
+ * The severity of a custom tip.
+ * It determines the printing severity ("Error" = red, "Warning" = yellow, "Info" = normal).
+ *
+ * @beta
+ */
+export declare enum CustomTipSeverity {
+    Warning = "Warning",
+    Error = "Error",
+    Info = "Info"
+}
+/**
+ * The type of the custom tip.
+ *
+ * @remarks
+ * There might be types like `git` in the future.
+ *
+ * @beta
+ */
+export declare enum CustomTipType {
+    rush = "rush",
+    pnpm = "pnpm"
+}
+/**
+ * Metadata for a custom tip.
+ *
+ * @remarks
+ * This differs from the  {@link ICustomTipItemJson} interface in that these are not configurable by the user;
+ * it's the inherent state of a custom tip. For example, the custom tip for `ERR_PNPM_NO_MATCHING_VERSION`
+ * has a inherent severity of `Error`, and a inherent match function that rush maintainer defines.
+ *
+ * @beta
+ */
+export interface ICustomTipInfo {
+    tipId: CustomTipId;
+    /**
+     * The severity of the custom tip. It will determine the printing severity ("Error" = red, "Warning" = yellow, "Info" = normal).
+     *
+     * @remarks
+     *  The severity should be consistent with the original message, unless there are strong reasons not to.
+     */
+    severity: CustomTipSeverity;
+    /**
+     * The type of the custom tip.
+     */
+    type: CustomTipType;
+    /**
+     * The function to determine how to match this tipId.
+     *
+     * @remarks
+     * This function might need to be updated if the depending package is updated.
+     * For example, if `pnpm` change the error logs for "ERR_PNPM_NO_MATCHING_VERSION", we will need to update the match function accordingly.
+     */
+    isMatch?: (str: string) => boolean;
+}
 /**
  * Used to access the `common/config/rush/custom-tips.json` config file,
  * which allows repo maintainers to configure extra details to be printed alongside
@@ -64,26 +119,56 @@ export declare class CustomTipsConfiguration {
      */
     readonly configuration: Readonly<ICustomTipsJson>;
     /**
-     * The list of identifiers that are allowed to be used in the "tipId" field
-     * of the config file.
+     * A registry mapping custom tip IDs to their corresponding metadata.
+     *
+     * @remarks
+     * This registry is used to look up metadata for custom tips based on their IDs. The metadata includes
+     * information such as the severity level, the type of tip, and an optional matching function.
+     *
+     * Each key in the registry corresponds to a `CustomTipIdEnum` value, and each value is an object
+     * implementing the `ICustomTipInfo` interface.
+     *
+     * @example
+     * ```typescript
+     * const tipInfo = CustomTipsConfiguration.customTipRegistry[CustomTipIdEnum.TIP_RUSH_INCONSISTENT_VERSIONS];
+     * console.log(tipInfo.severity);  // Output: CustomTipSeverity.Error
+     * ```
+     *
+     * See {@link CustomTipId} for the list of custom tip IDs.
+     * See {@link ICustomTipInfo} for the structure of the metadata.
      */
-    static readonly supportedTipIds: ReadonlySet<string>;
+    static customTipRegistry: Readonly<Record<CustomTipId, ICustomTipInfo>>;
     constructor(configFilename: string);
-    private _formatTipMessage;
     /**
      * If custom-tips.json defines a tip for the specified tipId,
      * display the tip on the terminal.
+     *
+     * @remarks
+     * The severity of the tip is defined in ${@link CustomTipsConfiguration.customTipRegistry}.
+     * If you want to change the severity specifically for this call, use other API like {@link CustomTipsConfiguration._showErrorTip}.
+     *
+     * @internal
+     */
+    _showTip(terminal: ITerminal, tipId: CustomTipId): void;
+    /**
+     * If custom-tips.json defines a tip for the specified tipId,
+     * display the tip on the terminal.
+     * @internal
      */
-    showInfoTip(terminal: ITerminal, tipId: CustomTipId): void;
+    _showInfoTip(terminal: ITerminal, tipId: CustomTipId): void;
     /**
      * If custom-tips.json defines a tip for the specified tipId,
      * display the tip on the terminal.
+     * @internal
      */
-    showWarningTip(terminal: ITerminal, tipId: CustomTipId): void;
+    _showWarningTip(terminal: ITerminal, tipId: CustomTipId): void;
     /**
      * If custom-tips.json defines a tip for the specified tipId,
      * display the tip on the terminal.
+     * @internal
      */
-    showErrorTip(terminal: ITerminal, tipId: CustomTipId): void;
+    _showErrorTip(terminal: ITerminal, tipId: CustomTipId): void;
+    private _formatMessageHeader;
+    private _writeMessageWithPipes;
 }
 //# sourceMappingURL=CustomTipsConfiguration.d.ts.map

package/lib/api/RushProjectConfiguration.d.ts

@@ -124,7 +124,7 @@ export declare class RushProjectConfiguration {
      * Load the rush-project.json data for all selected projects.
      * Validate compatibility of output folders across all selected phases.
      */
-    static tryLoadAndValidateForProjectsAsync(projects: Iterable<RushConfigurationProject>, phases: ReadonlySet<IPhase>, terminal: ITerminal): Promise<ReadonlyMap<RushConfigurationProject, RushProjectConfiguration>>;
+    static tryLoadForProjectsAsync(projects: Iterable<RushConfigurationProject>, terminal: ITerminal): Promise<ReadonlyMap<RushConfigurationProject, RushProjectConfiguration>>;
     private static _tryLoadJsonForProjectAsync;
     private static _getRushProjectConfiguration;
 }

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

@@ -26,6 +26,10 @@ export interface IPhasedScriptActionOptions extends IBaseScriptActionOptions<IPh
  * "build" script for each project.
  */
 export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandConfig> {
+    /**
+     * @internal
+     */
+    _runsBeforeInstall: boolean | undefined;
     readonly hooks: PhasedCommandHooks;
     private readonly _enableParallelism;
     private readonly _isIncrementalBuildAllowed;

package/lib/index.d.ts

@@ -7,7 +7,7 @@ export { RushConfiguration, ITryFindRushJsonLocationOptions } from './api/RushCo
 export { IPackageManagerOptionsJsonBase, IConfigurationEnvironment, IConfigurationEnvironmentVariable, PackageManagerOptionsConfigurationBase } from './logic/base/BasePackageManagerOptionsConfiguration';
 export { INpmOptionsJson as _INpmOptionsJson, NpmOptionsConfiguration } from './logic/npm/NpmOptionsConfiguration';
 export { IYarnOptionsJson as _IYarnOptionsJson, YarnOptionsConfiguration } from './logic/yarn/YarnOptionsConfiguration';
-export { IPnpmOptionsJson as _IPnpmOptionsJson, PnpmStoreOptions, PnpmOptionsConfiguration } from './logic/pnpm/PnpmOptionsConfiguration';
+export { IPnpmOptionsJson as _IPnpmOptionsJson, PnpmStoreLocation, PnpmStoreOptions, PnpmOptionsConfiguration, PnpmResolutionMode } from './logic/pnpm/PnpmOptionsConfiguration';
 export { BuildCacheConfiguration } from './api/BuildCacheConfiguration';
 export { CobuildConfiguration, ICobuildJson } from './api/CobuildConfiguration';
 export { GetCacheEntryIdFunction, IGenerateCacheEntryIdOptions } from './logic/buildCache/CacheEntryId';
@@ -33,7 +33,7 @@ export { VersionPolicyConfiguration } from './api/VersionPolicyConfiguration';
 export { ILaunchOptions, Rush } from './api/Rush';
 export { RushInternals as _RushInternals } from './api/RushInternals';
 export { ExperimentsConfiguration, IExperimentsJson } from './api/ExperimentsConfiguration';
-export { CustomTipsConfiguration, CustomTipId, ICustomTipsJson, ICustomTipItemJson } from './api/CustomTipsConfiguration';
+export { CustomTipsConfiguration, CustomTipId, ICustomTipsJson, ICustomTipInfo, ICustomTipItemJson, CustomTipSeverity, CustomTipType } from './api/CustomTipsConfiguration';
 export { ProjectChangeAnalyzer, IGetChangedProjectsOptions, IRawRepoState as _IRawRepoState } from './logic/ProjectChangeAnalyzer';
 export { IOperationRunner, IOperationRunnerContext } from './logic/operations/IOperationRunner';
 export { IExecutionResult, IOperationExecutionResult } from './logic/operations/IOperationExecutionResult';

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

@@ -6,6 +6,7 @@ import { ProjectLogWritable } from './ProjectLogWritable';
 import { CobuildConfiguration } from '../../api/CobuildConfiguration';
 import { PeriodicCallback } from './PeriodicCallback';
 import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+import type { ProjectChangeAnalyzer } from '../ProjectChangeAnalyzer';
 import type { BuildCacheConfiguration } from '../../api/BuildCacheConfiguration';
 export interface IProjectDeps {
     files: {
@@ -16,6 +17,7 @@ export interface IProjectDeps {
 export interface IOperationBuildCacheContext {
     isCacheWriteAllowed: boolean;
     isCacheReadAllowed: boolean;
+    projectChangeAnalyzer: ProjectChangeAnalyzer;
     projectBuildCache: ProjectBuildCache | undefined;
     cacheDisabledReason: string | undefined;
     operationSettings: IOperationSettings | undefined;
@@ -35,7 +37,6 @@ export interface ICacheableOperationPluginOptions {
 }
 export declare class CacheableOperationPlugin implements IPhasedCommandPlugin {
     private _buildCacheContextByOperation;
-    private _createContext;
     private readonly _options;
     constructor(options: ICacheableOperationPluginOptions);
     apply(hooks: PhasedCommandHooks): void;

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

@@ -84,6 +84,11 @@ export interface IOperationRunner {
      * exit code
      */
     warningsAreAllowed: boolean;
+    /**
+     * If set to true, this operation is considered a no-op and can be considered always skipped for
+     * analysis purposes.
+     */
+    readonly isNoOp?: boolean;
     /**
      * Method to be executed for the operation.
      */

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

@@ -27,6 +27,7 @@ export declare class NullOperationRunner implements IOperationRunner {
     readonly silent: boolean;
     cacheable: boolean;
     readonly warningsAreAllowed: boolean;
+    readonly isNoOp: boolean;
     readonly result: OperationStatus;
     constructor({ name, result, silent }: INullOperationRunnerParams);
     executeAsync(context: IOperationRunnerContext): Promise<OperationStatus>;

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

@@ -0,0 +1,13 @@
+import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+import type { ITerminal } from '@rushstack/node-core-library';
+/**
+ * Core phased command plugin that provides the functionality for generating a base operation graph
+ * from the set of selected projects and phases.
+ */
+export declare class ValidateOperationsPlugin implements IPhasedCommandPlugin {
+    private readonly _terminal;
+    constructor(terminal: ITerminal);
+    apply(hooks: PhasedCommandHooks): void;
+    private _validateOperations;
+}
+//# sourceMappingURL=ValidateOperationsPlugin.d.ts.map

package/lib/logic/operations/ValidateOperationsPlugin.js

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

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

@@ -3,7 +3,21 @@ import { IPackageManagerOptionsJsonBase, PackageManagerOptionsConfigurationBase
  * This represents the available PNPM store options
  * @public
  */
-export type PnpmStoreOptions = 'local' | 'global';
+export type PnpmStoreLocation = 'local' | 'global';
+/**
+ * @deprecated Use {@link PnpmStoreLocation} instead
+ * @public
+ */
+export type PnpmStoreOptions = PnpmStoreLocation;
+/**
+ * Possible values for the `resolutionMode` setting in Rush's pnpm-config.json file.
+ * @remarks
+ * These modes correspond to PNPM's `resolution-mode` values, which are documented here:
+ * {@link https://pnpm.io/npmrc#resolution-mode}
+ *
+ * @public
+ */
+export type PnpmResolutionMode = 'highest' | 'time-based' | 'lowest-direct';
 /**
  * @beta
  */
@@ -31,7 +45,7 @@ export interface IPnpmOptionsJson extends IPackageManagerOptionsJsonBase {
     /**
      * {@inheritDoc PnpmOptionsConfiguration.pnpmStore}
      */
-    pnpmStore?: PnpmStoreOptions;
+    pnpmStore?: PnpmStoreLocation;
     /**
      * {@inheritDoc PnpmOptionsConfiguration.strictPeerDependencies}
      */
@@ -72,6 +86,10 @@ export interface IPnpmOptionsJson extends IPackageManagerOptionsJsonBase {
      * {@inheritDoc PnpmOptionsConfiguration.unsupportedPackageJsonSettings}
      */
     unsupportedPackageJsonSettings?: unknown;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.resolutionMode}
+     */
+    resolutionMode?: PnpmResolutionMode;
 }
 /**
  * Options that are only used when the PNPM package manager is selected.
@@ -96,7 +114,19 @@ export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfi
      *  - local: Use the standard Rush store path: common/temp/pnpm-store
      *  - global: Use PNPM's global store path
      */
-    readonly pnpmStore: PnpmStoreOptions;
+    readonly pnpmStore: PnpmStoreLocation;
+    /**
+     * This setting determines PNPM's `resolution-mode`  option. The default value is `highest`.
+     *
+     * @remarks
+     * Be aware that the PNPM 8 initially defaulted to `lowest` instead of  `highest`, but PNPM
+     * reverted this decision in 8.6.12 because it caused confusion for users.  Rush 5.106.0 and newer
+     * avoids this confusion by consistently defaulting to `highest` when `resolutionMode` is not
+     * explicitly set in pnpm-config.json or .npmrc, regardless of your PNPM version.
+     *
+     * PNPM documentation: https://pnpm.io/npmrc#resolution-mode
+     */
+    readonly resolutionMode: PnpmResolutionMode | undefined;
     /**
      * The path for PNPM to use as the store directory.
      *

package/lib/utilities/Utilities.d.ts

@@ -108,6 +108,13 @@ export declare class Utilities {
      * The current directory will be set to the specified workingDirectory.
      */
     static executeCommand(options: IExecuteCommandOptions): 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.
+     *
+     * It's basically the same as executeCommand() except that it returns a Promise.
+     */
+    static executeCommandAndInspectOutputAsync(options: IExecuteCommandOptions, onStdoutStreamChunk?: (chunkString: string) => 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.
@@ -117,6 +124,13 @@ export declare class Utilities {
      * Attempts to run Utilities.executeCommand() up to maxAttempts times before giving up.
      */
     static executeCommandWithRetry(options: IExecuteCommandOptions, maxAttempts: number, retryCallback?: () => void): void;
+    /**
+     * Attempts to run Utilities.executeCommand() up to maxAttempts times before giving up.
+     * Using `onStdoutStreamChunk` to process the output of the command.
+     *
+     * Note: This is similar to {@link executeCommandWithRetry} except that it returns a Promise and provides a callback to process the output.
+     */
+    static executeCommandAndProcessOutputWithRetryAsync(options: IExecuteCommandOptions, maxAttempts: number, onStdoutStreamChunk?: (chunkString: string) => void, retryCallback?: () => void): Promise<void>;
     /**
      * Executes the command using cmd if running on windows, or using sh if running on a non-windows OS.
      * @param command - the command to run on shell
@@ -163,6 +177,13 @@ export declare class Utilities {
      * "/foobar/node_modules/.bin:/bin"
      */
     private static _prependNodeModulesBinToPath;
+    /**
+     * 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.
+     *
+     * It's the same as _executeCommandInternal except that it returns a promise.
+     */
+    private static _executeCommandAndInspectOutputInternalAsync;
     /**
      * 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/lib/utilities/npmrcUtilities.d.ts

@@ -12,4 +12,5 @@ export interface ILogger {
  * The text of the the synced .npmrc, if one exists. If one does not exist, then undefined is returned.
  */
 export declare function syncNpmrc(sourceNpmrcFolder: string, targetNpmrcFolder: string, useNpmrcPublish?: boolean, logger?: ILogger): string | undefined;
+export declare function isVariableSetInNpmrcFile(sourceNpmrcFolder: string, variableKey: string): boolean;
 //# sourceMappingURL=npmrcUtilities.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.104.1",
+  "version": "5.106.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -31,7 +31,7 @@
     "@types/node": "14.18.36",
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.0",
-    "@microsoft/rush-lib": "5.104.1",
+    "@microsoft/rush-lib": "5.106.0",
     "@rushstack/eslint-config": "3.3.3",
     "@rushstack/heft": "0.58.2",
     "@rushstack/heft-node-rig": "2.2.22",