@rushstack/rush-sdk 5.92.0 → 5.93.1-pr3481.17

package/README.md

@@ -10,7 +10,9 @@ The **@rushstack/rush-sdk** package acts as a lightweight proxy for accessing th
 
 2. When authoring unit tests for a Rush plugin, developers should add **@microsoft/rush-lib** to their **package.json** `devDependencies`. In this context, **@rushstack/rush-sdk** will resolve to that instance for testing purposes.
 
-3. For scripts and tools that are designed to be used in a Rush monorepo, in the future **@rushstack/rush-sdk** will automatically invoke **install-run-rush.js** and load the local installation. This ensures that tools load a compatible version of the Rush engine for the given branch. Once this is implemented, **@rushstack/rush-sdk** can replace **@microsoft/rush-lib** entirely as the official API interface, with the latter serving as the underlying implementation.
+3. For projects within a monorepo that use **@rushstack/rush-sdk** during their build process, child processes will inherit the installation of Rush that invoked them. This is communicated using the `_RUSH_LIB_PATH` environment variable.
+
+4. For scripts and tools that are designed to be used in a Rush monorepo, in the future **@rushstack/rush-sdk** will automatically invoke **install-run-rush.js** and load the local installation. This ensures that tools load a compatible version of the Rush engine for the given branch. Once this is implemented, **@rushstack/rush-sdk** can replace **@microsoft/rush-lib** entirely as the official API interface, with the latter serving as the underlying implementation.
 
 The **@rushstack/rush-sdk** API declarations are identical to the corresponding version of **@microsoft/rush-lib**.
 
@@ -42,8 +44,8 @@ Example 2: How to import an internal API:
 // WARNING: INTERNAL APIS MAY CHANGE AT ANY TIME -- USE THIS AT YOUR OWN RISK:
 
 // Important: Since we're calling an internal API, we need to use the unbundled .d.ts files
-// instead of the normal .d.ts rollup
-import { RushConfiguration } from '@rushstack/rush-sdk/lib/';
+// instead of the normal .d.ts rollup, otherwise TypeScript will complain about a type mismatch.
+import { RushConfiguration } from '@rushstack/rush-sdk/lib/index';
 const config = RushConfiguration.loadFromDefaultLocation();
 console.log(config.commonFolder);
 

package/dist/rush-lib.d.ts

@@ -131,6 +131,55 @@ export declare class ApprovedPackagesPolicy {
     constructor(rushConfiguration: RushConfiguration, rushConfigurationJson: IRushConfigurationJson);
 }
 
+/**
+ * A base class for flag file.
+ * @internal
+ */
+export declare class _BaseFlag<T extends object = JsonObject> {
+    /**
+     * Flag file path
+     */
+    readonly path: string;
+    /**
+     * Content of the flag
+     */
+    protected _state: T;
+    /**
+     * Whether the current state is modified
+     */
+    protected _isModified: boolean;
+    /**
+     * Creates a new flag file
+     * @param folderPath - the folder that this flag is managing
+     * @param state - optional, the state that should be managed or compared
+     */
+    constructor(folderPath: string, state?: Partial<T>);
+    /**
+     * Returns true if the file exists and the contents match the current state.
+     */
+    isValid(): boolean;
+    /**
+     * Writes the flag file to disk with the current state
+     */
+    create(): void;
+    /**
+     * Merge new data into current state by lodash "merge"
+     */
+    mergeFromObject(data: JsonObject): void;
+    /**
+     * Writes the flag file to disk with the current state if modified
+     */
+    saveIfModified(): void;
+    /**
+     * Removes the flag file
+     */
+    clear(): void;
+    /**
+     * Returns Name of the flag file
+     */
+    protected get flagName(): string;
+}
+
 /**
  * Use this class to load and save the "common/config/rush/build-cache.json" config file.
  * This file provides configuration options for cached project build output.
@@ -559,6 +608,11 @@ export declare enum EnvironmentVariableNames {
      * Explicitly specifies the path for the `tar` binary that is invoked by certain Rush operations.
      */
     RUSH_TAR_BINARY_PATH = "RUSH_TAR_BINARY_PATH",
+    /**
+     * Internal variable that explicitly specifies the path for the version of `@microsoft/rush-lib` being executed.
+     * Will be set upon loading Rush.
+     */
+    RUSH_LIB_PATH = "_RUSH_LIB_PATH",
     /**
      * When Rush executes shell scripts, it sometimes changes the working directory to be a project folder or
      * the repository root folder.  The original working directory (where the Rush command was invoked) is assigned
@@ -878,6 +932,11 @@ export declare interface IExperimentsJson {
      * in common/config/rush/command-line.json.
      */
     phasedCommands?: boolean;
+    /**
+     * If true, rush install or rush update implicitly specify --ignore-scripts during pnpm install,
+     * and run install lifecycle scripts by pnpm rebuild --pending after pnpm install successfully.
+     */
+    deferredInstallationScripts?: boolean;
     /**
      * If true, perform a clean install after when running `rush install` or `rush update` if the
      * `.npmrc` file has changed since the last install.
@@ -949,6 +1008,51 @@ declare interface IIndividualVersionJson extends IVersionPolicyJson {
     lockedMajor?: number;
 }
 
+/**
+ * This represents the JSON data structure for the "last-install.flag" file.
+ * @internal
+ */
+export declare interface _ILastInstallFlagJson {
+    /**
+     * Current node version
+     */
+    node: string;
+    /**
+     * Current package manager name
+     */
+    packageManager: PackageManagerName;
+    /**
+     * Current package manager version
+     */
+    packageManagerVersion: string;
+    /**
+     * Current rush json folder
+     */
+    rushJsonFolder: string;
+    /**
+     * The content of package.json, used in the flag file of autoinstaller
+     */
+    packageJson?: IPackageJson;
+    /**
+     * Same with pnpmOptions.pnpmStorePath in rush.json
+     */
+    storePath?: string;
+    /**
+     * True when "useWorkspaces" is true in rush.json
+     */
+    workspaces?: true;
+    /**
+     * True when user explicitly specify "--ignore-scripts" CLI parameter or deferredInstallationScripts
+     */
+    ignoreScripts?: true;
+    /**
+     * When specified, it is a list of selected projects during partial install
+     * It is undefined when full install
+     */
+    selectedProjectNames?: string[];
+    [key: string]: unknown;
+}
+
 /**
  * Options to pass to the rush "launch" functions.
  *
@@ -1433,6 +1537,7 @@ declare interface IRushConfigurationProjectJson {
     skipRushCheck?: boolean;
     publishFolder?: string;
     tags?: string[];
+    splitWorkspace?: boolean;
 }
 
 /**
@@ -1457,6 +1562,16 @@ declare interface IRushConfigurationProjectOptions {
     allowedProjectTags: Set<string> | undefined;
 }
 
+/**
+ * The filter parameters to search from all projects.
+ */
+declare interface IRushConfigurationProjectsFilter {
+    /**
+     * If true, filter out projects that specify splitWorkspace as true.
+     */
+    splitWorkspace: boolean;
+}
+
 /**
  * Part of IRushConfigurationJson.
  */
@@ -1720,19 +1835,9 @@ export declare interface _IYarnOptionsJson extends IPackageManagerOptionsJsonBas
  * it can invalidate the last install.
  * @internal
  */
-export declare class _LastInstallFlag {
-    private _state;
-    /**
-     * Returns the full path to the flag file
-     */
-    readonly path: string;
-    /**
-     * Creates a new LastInstall flag
-     * @param folderPath - the folder that this flag is managing
-     * @param state - optional, the state that should be managed or compared
-     */
-    constructor(folderPath: string, state?: JsonObject);
+export declare class _LastInstallFlag extends _BaseFlag<_ILastInstallFlagJson> {
     /**
+     * @override
      * Returns true if the file exists and the contents match the current state.
      */
     isValid(options?: _ILockfileValidityCheckOptions): boolean;
@@ -1746,14 +1851,6 @@ export declare class _LastInstallFlag {
         rushVerb: string;
     }): boolean;
     private _isValid;
-    /**
-     * Writes the flag file to disk with the current state
-     */
-    create(): void;
-    /**
-     * Removes the flag file
-     */
-    clear(): void;
     /**
      * Returns the name of the flag file
      */
@@ -2566,6 +2663,8 @@ export declare class RushConfiguration {
     private _projects;
     private _projectsByName;
     private _projectsByTag;
+    private _filteredProjectsCache;
+    private _hasSplitWorkspaceProject;
     private _commonVersionsConfigurationsByVariant;
     /**
      * The name of the package manager being used to install dependencies
@@ -2620,6 +2719,12 @@ export declare class RushConfiguration {
      * Example: `C:\MyRepo\common\temp`
      */
     readonly commonTempFolder: string;
+    /**
+     * The folder where temporary files will be stored.  This is always a subfolder called "temp"
+     * under the common folder.
+     * Example: `C:\MyRepo\common\temp-split`
+     */
+    readonly commonTempSplitFolder: string;
     /**
      * The folder where automation scripts are stored.  This is always a subfolder called "scripts"
      * under the common folder.
@@ -2674,6 +2779,21 @@ export declare class RushConfiguration {
      * or `C:\MyRepo\common\temp\pnpm-lock-preinstall.yaml`
      */
     readonly tempShrinkwrapPreinstallFilename: string;
+    /**
+     * The filename (without any path) of the shrinkwrap file for split workspace that is used by the package manager.
+     * @remarks
+     * This property merely reports the filename; the file itself may not actually exist.
+     * Example: `pnpm-lock.yaml`
+     */
+    readonly splitWorkspaceShrinkwrapFilename: string;
+    /**
+     * The full path of the temporary shrinkwrap file for split workspace that is used during
+     * "rush install". This file may get rewritten by the package manager during installation.
+     * @remarks
+     * This property merely reports the filename; the file itself may not actually exist.
+     * Example: `C:\MyRepo\common\temp-split\pnpm-lock.yaml`
+     */
+    readonly tempSplitWorkspaceShrinkwrapFilename: string;
     /**
      * The filename of the variant dependency data file.  By default this is
      * called 'current-variant.json' resides in the Rush common folder.
@@ -2929,6 +3049,11 @@ export declare class RushConfiguration {
      * @beta
      */
     get projectsByTag(): ReadonlyMap<string, ReadonlySet<RushConfigurationProject>>;
+    /**
+     * Search for projects according to filter
+     * @beta
+     */
+    getFilteredProjects(filter: IRushConfigurationProjectsFilter): RushConfigurationProject[];
     /**
      * Settings from the common-versions.json config file.
      * @remarks
@@ -2947,6 +3072,10 @@ export declare class RushConfiguration {
      * or "rush update".
      */
     get currentInstalledVariant(): string | undefined;
+    /**
+     * Is there any split workspace project.
+     */
+    get hasSplitWorkspaceProject(): boolean;
     /**
      * Gets the path to the common-versions.json config file for a specific variant.
      * @param variant - The name of the current variant in use by the active command.
@@ -2979,6 +3108,11 @@ export declare class RushConfiguration {
      * @param variant - The name of the current variant in use by the active command.
      */
     getCommittedShrinkwrapFilename(variant?: string | undefined): string;
+    /**
+     * Gets the committed shrinkwrap file name for split workspace.
+     * @param variant - The name of the current variant in use by the active command.
+     */
+    getCommittedSplitWorkspaceShrinkwrapFilename(): string;
     /**
      * Gets the absolute path for "pnpmfile.js" for a specific variant.
      * @param variant - The name of the current variant in use by the active command.
@@ -3014,6 +3148,12 @@ export declare class RushConfiguration {
      */
     tryGetProjectForPath(currentFolderPath: string): RushConfigurationProject | undefined;
     private _getVariantConfigFolderPath;
+    /**
+     * Split workspace can only works on PNPM with "useWorkspaces" enabled.
+     * The workspace project can NOT depend on a split workspace project.
+     * The split workspace project CAN depend on a workspace project.
+     */
+    private _validateSplitWorkspaceRelationships;
 }
 
 /**
@@ -3129,6 +3269,11 @@ export declare class RushConfigurationProject {
      * @beta
      */
     readonly tags: ReadonlySet<string>;
+    /**
+     * Whether this project is a split workspace project.
+     * @beta
+     */
+    readonly splitWorkspace: boolean;
     /** @internal */
     constructor(options: IRushConfigurationProjectOptions);
     /**
@@ -3238,6 +3383,12 @@ export declare class RushConstants {
      * Example: `C:\MyRepo\common\temp`
      */
     static readonly rushTempFolderName: string;
+    /**
+     * The folder name ("temp-split") under the common folder, or under the .rush folder in each project's directory where
+     * temporary files will be stored.
+     * Example: `C:\MyRepo\common\temp-split`
+     */
+    static readonly rushTempSplitFolderName: string;
     /**
      * The folder name ("projects") where temporary projects will be stored.
      * Example: `C:\MyRepo\common\temp\projects`

package/lib/api/EnvironmentConfiguration.d.ts

@@ -128,6 +128,11 @@ export declare enum EnvironmentVariableNames {
      * Explicitly specifies the path for the `tar` binary that is invoked by certain Rush operations.
      */
     RUSH_TAR_BINARY_PATH = "RUSH_TAR_BINARY_PATH",
+    /**
+     * Internal variable that explicitly specifies the path for the version of `@microsoft/rush-lib` being executed.
+     * Will be set upon loading Rush.
+     */
+    RUSH_LIB_PATH = "_RUSH_LIB_PATH",
     /**
      * When Rush executes shell scripts, it sometimes changes the working directory to be a project folder or
      * the repository root folder.  The original working directory (where the Rush command was invoked) is assigned

package/lib/api/ExperimentsConfiguration.d.ts

@@ -35,6 +35,11 @@ export interface IExperimentsJson {
      * in common/config/rush/command-line.json.
      */
     phasedCommands?: boolean;
+    /**
+     * If true, rush install or rush update implicitly specify --ignore-scripts during pnpm install,
+     * and run install lifecycle scripts by pnpm rebuild --pending after pnpm install successfully.
+     */
+    deferredInstallationScripts?: boolean;
     /**
      * If true, perform a clean install after when running `rush install` or `rush update` if the
      * `.npmrc` file has changed since the last install.

package/lib/api/LastInstallFlag.d.ts

@@ -1,6 +1,52 @@
-import { JsonObject } from '@rushstack/node-core-library';
+import { IPackageJson } from '@rushstack/node-core-library';
+import { BaseFlag } from './base/BaseFlag';
+import { PackageManagerName } from './packageManager/PackageManager';
 import { RushConfiguration } from './RushConfiguration';
 export declare const LAST_INSTALL_FLAG_FILE_NAME: string;
+/**
+ * This represents the JSON data structure for the "last-install.flag" file.
+ * @internal
+ */
+export interface ILastInstallFlagJson {
+    /**
+     * Current node version
+     */
+    node: string;
+    /**
+     * Current package manager name
+     */
+    packageManager: PackageManagerName;
+    /**
+     * Current package manager version
+     */
+    packageManagerVersion: string;
+    /**
+     * Current rush json folder
+     */
+    rushJsonFolder: string;
+    /**
+     * The content of package.json, used in the flag file of autoinstaller
+     */
+    packageJson?: IPackageJson;
+    /**
+     * Same with pnpmOptions.pnpmStorePath in rush.json
+     */
+    storePath?: string;
+    /**
+     * True when "useWorkspaces" is true in rush.json
+     */
+    workspaces?: true;
+    /**
+     * True when user explicitly specify "--ignore-scripts" CLI parameter or deferredInstallationScripts
+     */
+    ignoreScripts?: true;
+    /**
+     * When specified, it is a list of selected projects during partial install
+     * It is undefined when full install
+     */
+    selectedProjectNames?: string[];
+    [key: string]: unknown;
+}
 /**
  * @internal
  */
@@ -15,19 +61,9 @@ export interface ILockfileValidityCheckOptions {
  * it can invalidate the last install.
  * @internal
  */
-export declare class LastInstallFlag {
-    private _state;
-    /**
-     * Returns the full path to the flag file
-     */
-    readonly path: string;
-    /**
-     * Creates a new LastInstall flag
-     * @param folderPath - the folder that this flag is managing
-     * @param state - optional, the state that should be managed or compared
-     */
-    constructor(folderPath: string, state?: JsonObject);
+export declare class LastInstallFlag extends BaseFlag<ILastInstallFlagJson> {
     /**
+     * @override
      * Returns true if the file exists and the contents match the current state.
      */
     isValid(options?: ILockfileValidityCheckOptions): boolean;
@@ -41,14 +77,6 @@ export declare class LastInstallFlag {
         rushVerb: string;
     }): boolean;
     private _isValid;
-    /**
-     * Writes the flag file to disk with the current state
-     */
-    create(): void;
-    /**
-     * Removes the flag file
-     */
-    clear(): void;
     /**
      * Returns the name of the flag file
      */
@@ -69,5 +97,14 @@ export declare class LastInstallFlagFactory {
      * @internal
      */
     static getCommonTempFlag(rushConfiguration: RushConfiguration, extraState?: Record<string, string>): LastInstallFlag;
+    /**
+     * Gets the LastInstall flag and sets the current state. This state is used to compare
+     * against the last-known-good state tracked by the LastInstall flag.
+     * @param rushConfiguration - the configuration of the Rush repo to get the install
+     * state from
+     *
+     * @internal
+     */
+    static getCommonTempSplitFlag(rushConfiguration: RushConfiguration): LastInstallFlag;
 }
 //# sourceMappingURL=LastInstallFlag.d.ts.map

package/lib/api/LastLinkFlag.d.ts

@@ -1,16 +1,12 @@
-import { LastInstallFlag } from './LastInstallFlag';
-import { RushConfiguration } from './RushConfiguration';
+import { BaseFlag } from './base/BaseFlag';
+import type { RushConfiguration } from './RushConfiguration';
 export declare const LAST_LINK_FLAG_FILE_NAME: string;
 /**
  * A helper class for managing the last-link flag, which is persistent and
  * indicates that linking was completed successfully.
  * @internal
  */
-export declare class LastLinkFlag extends LastInstallFlag {
-    /**
-     * @override
-     */
-    isValid(): boolean;
+export declare class LastLinkFlag extends BaseFlag {
     /**
      * @override
      */

package/lib/api/Rush.d.ts

@@ -1,4 +1,5 @@
 import { IPackageJson, ITerminalProvider } from '@rushstack/node-core-library';
+import '../utilities/SetRushLibPath';
 import { IBuiltInPluginConfiguration } from '../pluginFramework/PluginLoader/BuiltInPluginLoader';
 /**
  * Options to pass to the rush "launch" functions.

package/lib/api/RushConfiguration.d.ts

@@ -117,6 +117,15 @@ export interface IRushConfigurationJson {
 export interface ICurrentVariantJson {
     variant: string | JsonNull;
 }
+/**
+ * The filter parameters to search from all projects.
+ */
+export interface IRushConfigurationProjectsFilter {
+    /**
+     * If true, filter out projects that specify splitWorkspace as true.
+     */
+    splitWorkspace: boolean;
+}
 /**
  * Options for `RushConfiguration.tryFindRushJsonLocation`.
  * @public
@@ -143,6 +152,8 @@ export declare class RushConfiguration {
     private _projects;
     private _projectsByName;
     private _projectsByTag;
+    private _filteredProjectsCache;
+    private _hasSplitWorkspaceProject;
     private _commonVersionsConfigurationsByVariant;
     /**
      * The name of the package manager being used to install dependencies
@@ -197,6 +208,12 @@ export declare class RushConfiguration {
      * Example: `C:\MyRepo\common\temp`
      */
     readonly commonTempFolder: string;
+    /**
+     * The folder where temporary files will be stored.  This is always a subfolder called "temp"
+     * under the common folder.
+     * Example: `C:\MyRepo\common\temp-split`
+     */
+    readonly commonTempSplitFolder: string;
     /**
      * The folder where automation scripts are stored.  This is always a subfolder called "scripts"
      * under the common folder.
@@ -251,6 +268,21 @@ export declare class RushConfiguration {
      * or `C:\MyRepo\common\temp\pnpm-lock-preinstall.yaml`
      */
     readonly tempShrinkwrapPreinstallFilename: string;
+    /**
+     * The filename (without any path) of the shrinkwrap file for split workspace that is used by the package manager.
+     * @remarks
+     * This property merely reports the filename; the file itself may not actually exist.
+     * Example: `pnpm-lock.yaml`
+     */
+    readonly splitWorkspaceShrinkwrapFilename: string;
+    /**
+     * The full path of the temporary shrinkwrap file for split workspace that is used during
+     * "rush install". This file may get rewritten by the package manager during installation.
+     * @remarks
+     * This property merely reports the filename; the file itself may not actually exist.
+     * Example: `C:\MyRepo\common\temp-split\pnpm-lock.yaml`
+     */
+    readonly tempSplitWorkspaceShrinkwrapFilename: string;
     /**
      * The filename of the variant dependency data file.  By default this is
      * called 'current-variant.json' resides in the Rush common folder.
@@ -506,6 +538,11 @@ export declare class RushConfiguration {
      * @beta
      */
     get projectsByTag(): ReadonlyMap<string, ReadonlySet<RushConfigurationProject>>;
+    /**
+     * Search for projects according to filter
+     * @beta
+     */
+    getFilteredProjects(filter: IRushConfigurationProjectsFilter): RushConfigurationProject[];
     /**
      * Settings from the common-versions.json config file.
      * @remarks
@@ -524,6 +561,10 @@ export declare class RushConfiguration {
      * or "rush update".
      */
     get currentInstalledVariant(): string | undefined;
+    /**
+     * Is there any split workspace project.
+     */
+    get hasSplitWorkspaceProject(): boolean;
     /**
      * Gets the path to the common-versions.json config file for a specific variant.
      * @param variant - The name of the current variant in use by the active command.
@@ -556,6 +597,11 @@ export declare class RushConfiguration {
      * @param variant - The name of the current variant in use by the active command.
      */
     getCommittedShrinkwrapFilename(variant?: string | undefined): string;
+    /**
+     * Gets the committed shrinkwrap file name for split workspace.
+     * @param variant - The name of the current variant in use by the active command.
+     */
+    getCommittedSplitWorkspaceShrinkwrapFilename(): string;
     /**
      * Gets the absolute path for "pnpmfile.js" for a specific variant.
      * @param variant - The name of the current variant in use by the active command.
@@ -591,5 +637,11 @@ export declare class RushConfiguration {
      */
     tryGetProjectForPath(currentFolderPath: string): RushConfigurationProject | undefined;
     private _getVariantConfigFolderPath;
+    /**
+     * Split workspace can only works on PNPM with "useWorkspaces" enabled.
+     * The workspace project can NOT depend on a split workspace project.
+     * The split workspace project CAN depend on a workspace project.
+     */
+    private _validateSplitWorkspaceRelationships;
 }
 //# sourceMappingURL=RushConfiguration.d.ts.map

package/lib/api/RushConfigurationProject.d.ts

@@ -16,6 +16,7 @@ export interface IRushConfigurationProjectJson {
     skipRushCheck?: boolean;
     publishFolder?: string;
     tags?: string[];
+    splitWorkspace?: boolean;
 }
 /**
  * @internal
@@ -151,6 +152,11 @@ export declare class RushConfigurationProject {
      * @beta
      */
     readonly tags: ReadonlySet<string>;
+    /**
+     * Whether this project is a split workspace project.
+     * @beta
+     */
+    readonly splitWorkspace: boolean;
     /** @internal */
     constructor(options: IRushConfigurationProjectOptions);
     /**

package/lib/api/base/BaseFlag.d.ts

@@ -0,0 +1,50 @@
+import { JsonObject } from '@rushstack/node-core-library';
+/**
+ * A base class for flag file.
+ * @internal
+ */
+export declare class BaseFlag<T extends object = JsonObject> {
+    /**
+     * Flag file path
+     */
+    readonly path: string;
+    /**
+     * Content of the flag
+     */
+    protected _state: T;
+    /**
+     * Whether the current state is modified
+     */
+    protected _isModified: boolean;
+    /**
+     * Creates a new flag file
+     * @param folderPath - the folder that this flag is managing
+     * @param state - optional, the state that should be managed or compared
+     */
+    constructor(folderPath: string, state?: Partial<T>);
+    /**
+     * Returns true if the file exists and the contents match the current state.
+     */
+    isValid(): boolean;
+    /**
+     * Writes the flag file to disk with the current state
+     */
+    create(): void;
+    /**
+     * Merge new data into current state by lodash "merge"
+     */
+    mergeFromObject(data: JsonObject): void;
+    /**
+     * Writes the flag file to disk with the current state if modified
+     */
+    saveIfModified(): void;
+    /**
+     * Removes the flag file
+     */
+    clear(): void;
+    /**
+     * Returns Name of the flag file
+     */
+    protected get flagName(): string;
+}
+//# sourceMappingURL=BaseFlag.d.ts.map

package/lib/api/base/BaseFlag.js

@@ -0,0 +1 @@
+module.exports = require("../../../lib-shim/index")._rushSdk_loadInternalModule("api/base/BaseFlag");

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

@@ -11,7 +11,21 @@ export declare class PnpmPackageManager extends PackageManager {
      * Example: `pnpmfile.js` or `.pnpmfile.cjs`
      */
     readonly pnpmfileFilename: string;
+    /**
+     * The filename of the shrinkwrap file of split workspace that is used by the package manager.
+     *
+     * @remarks
+     * Example: `.pnpmfile-split-workspace.cjs`
+     */
+    splitWorkspacePnpmfileFilename: string;
     /** @internal */
     constructor(version: string);
+    /**
+     * The filename of the global shrinkwrap file that is used by the package manager.
+     *
+     * @remarks
+     * Example: `global-pnpmfile.cjs`
+     */
+    get globalPnpmfileFilename(): string;
 }
 //# sourceMappingURL=PnpmPackageManager.d.ts.map

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

@@ -3,6 +3,13 @@ import type { IInstallManagerOptions } from '../../logic/base/BaseInstallManager
 import { RushCommandLineParser } from '../RushCommandLineParser';
 export declare class InstallAction extends BaseInstallAction {
     private readonly _checkOnlyParameter;
+    private _ignoreScriptsParameter;
+    /**
+     * Whether split workspace projects are included in install
+     *
+     * This parameter only supported when there is split workspace project
+     */
+    private _includeSplitWorkspaceParameter?;
     constructor(parser: RushCommandLineParser);
     protected buildInstallOptionsAsync(): Promise<IInstallManagerOptions>;
 }

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

@@ -34,6 +34,10 @@ export interface IJsonEntry {
      * @see {@link ../../api/RushConfigurationProject#RushConfigurationProject.tags | RushConfigurationProject.tags}
      */
     tags: string[];
+    /**
+     * @see {@link ../../api/RushConfigurationProject#RushConfigurationProject.splitWorkspace | RushConfigurationProject.splitWorkspace}
+     */
+    splitWorkspace: boolean;
 }
 export interface IJsonOutput {
     projects: IJsonEntry[];

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

@@ -4,6 +4,13 @@ import { RushCommandLineParser } from '../RushCommandLineParser';
 export declare class UpdateAction extends BaseInstallAction {
     private readonly _fullParameter;
     private readonly _recheckParameter;
+    private _ignoreScriptsParameter;
+    /**
+     * Whether split workspace projects are included in update
+     *
+     * This parameter only supported when there is split workspace project
+     */
+    private _includeSplitWorkspaceParameter?;
     constructor(parser: RushCommandLineParser);
     protected runAsync(): Promise<void>;
     protected buildInstallOptionsAsync(): Promise<IInstallManagerOptions>;

package/lib/cli/parsing/SelectionParameterSet.d.ts

@@ -20,7 +20,15 @@ export declare class SelectionParameterSet {
     private readonly _fromVersionPolicy;
     private readonly _toVersionPolicy;
     private readonly _selectorParserByScope;
+    private readonly _selectors;
+    private _isSelectionSpecified;
     constructor(rushConfiguration: RushConfiguration, action: CommandLineParameterProvider, gitOptions: IGitSelectorParserOptions);
+    /**
+     * Check if any of the selection parameters have a value specified on the command line
+     *
+     * Returns true if specifying any selection parameters, otherwise false.
+     */
+    get isSelectionSpecified(): boolean;
     /**
      * Computes the set of selected projects based on all parameter values.
      *
@@ -28,14 +36,19 @@ export declare class SelectionParameterSet {
      */
     getSelectedProjectsAsync(terminal: ITerminal): Promise<Set<RushConfigurationProject>>;
     /**
-     * Represents the selection as `--filter` parameters to pnpm.
+     * Represents the selection as `--filter` parameters to pnpm, and selected projects when partial install
      *
      * @remarks
      * This is a separate from the selection to allow the filters to be represented more concisely.
      *
-     * @see https://pnpm.js.org/en/filtering
+     * @see https://pnpm.io/filtering
      */
-    getPnpmFilterArgumentsAsync(terminal: ITerminal): Promise<string[]>;
+    getPnpmFilterArgumentsAsync(terminal: ITerminal): Promise<{
+        pnpmFilterArguments: string[];
+        splitWorkspacePnpmFilterArguments: string[];
+        selectedProjects: Set<RushConfigurationProject> | undefined;
+        hasSelectSplitWorkspaceProject: boolean;
+    }>;
     /**
      * Usage telemetry for selection parameters. Only saved locally, and if requested in the config.
      */
@@ -47,5 +60,6 @@ export declare class SelectionParameterSet {
      * Handles '.', unscoped names, and scoped names.
      */
     private _evaluateProjectParameterAsync;
+    toArguments(): string[];
 }
 //# sourceMappingURL=SelectionParameterSet.d.ts.map

package/lib/index.d.ts

@@ -25,7 +25,8 @@ export { RepoStateFile } from './logic/RepoStateFile';
 export { LookupByPath } from './logic/LookupByPath';
 export { EventHooks, Event } from './api/EventHooks';
 export { ChangeManager } from './api/ChangeManager';
-export { LastInstallFlag as _LastInstallFlag, ILockfileValidityCheckOptions as _ILockfileValidityCheckOptions } from './api/LastInstallFlag';
+export { LastInstallFlag as _LastInstallFlag, ILastInstallFlagJson as _ILastInstallFlagJson, ILockfileValidityCheckOptions as _ILockfileValidityCheckOptions } from './api/LastInstallFlag';
+export { BaseFlag as _BaseFlag } from './api/base/BaseFlag';
 export { VersionPolicyDefinitionName, BumpType, LockStepVersionPolicy, IndividualVersionPolicy, VersionPolicy } from './api/VersionPolicy';
 export { VersionPolicyConfiguration } from './api/VersionPolicyConfiguration';
 export { ILaunchOptions, Rush } from './api/Rush';

package/lib/logic/PurgeManager.d.ts

@@ -9,6 +9,7 @@ export declare class PurgeManager {
     private _rushGlobalFolder;
     private _rushUserFolderRecycler;
     readonly commonTempFolderRecycler: AsyncRecycler;
+    readonly commonTempSplitFolderRecycler: AsyncRecycler;
     constructor(rushConfiguration: RushConfiguration, rushGlobalFolder: RushGlobalFolder);
     /**
      * Performs the AsyncRecycler.deleteAll() operation.  This should be called before

package/lib/logic/RushConstants.d.ts

@@ -43,6 +43,12 @@ export declare class RushConstants {
      * Example: `C:\MyRepo\common\temp`
      */
     static readonly rushTempFolderName: string;
+    /**
+     * The folder name ("temp-split") under the common folder, or under the .rush folder in each project's directory where
+     * temporary files will be stored.
+     * Example: `C:\MyRepo\common\temp-split`
+     */
+    static readonly rushTempSplitFolderName: string;
     /**
      * The folder name ("projects") where temporary projects will be stored.
      * Example: `C:\MyRepo\common\temp\projects`

package/lib/logic/base/BaseInstallManagerTypes.d.ts

@@ -1,3 +1,5 @@
+import type { SelectionParameterSet } from '../../cli/parsing/SelectionParameterSet';
+import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 export interface IInstallManagerOptions {
     /**
      * Whether the global "--debug" flag was specified.
@@ -61,5 +63,26 @@ export interface IInstallManagerOptions {
      * Callback to invoke between preparing the common/temp folder and running installation.
      */
     beforeInstallAsync?: () => Promise<void>;
+    /**
+     * Whether to specify "--ignore-scripts" command-line parameter, which ignores
+     * install lifecycle scripts in package.json and its dependencies
+     */
+    ignoreScripts: boolean;
+    /**
+     * Whether to install for projects in split workspace
+     */
+    includeSplitWorkspace: boolean;
+    /**
+     * Filters to be passed to PNPM during installation for split workspace.
+     */
+    splitWorkspacePnpmFilterArguments: string[];
+    /**
+     * Selected projects during partial install.
+     */
+    selectedProjects?: Set<RushConfigurationProject>;
+    /**
+     * Selection parameters for partial install.
+     */
+    selectionParameters?: SelectionParameterSet;
 }
 //# sourceMappingURL=BaseInstallManagerTypes.d.ts.map

package/lib/logic/installManager/InstallHelpers.d.ts

@@ -3,6 +3,7 @@ import { RushConfiguration } from '../../api/RushConfiguration';
 import { RushGlobalFolder } from '../../api/RushGlobalFolder';
 export declare class InstallHelpers {
     static generateCommonPackageJson(rushConfiguration: RushConfiguration, dependencies?: Map<string, string>): void;
+    static generateCommonSplitPackageJson(rushConfiguration: RushConfiguration): void;
     static getPackageManagerEnvironment(rushConfiguration: RushConfiguration, options?: {
         debug?: boolean;
     }): NodeJS.ProcessEnv;

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

@@ -1,5 +1,6 @@
 import type { LogBase } from '@pnpm/logger';
 import type { IPackageJson } from '@rushstack/node-core-library';
+import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 import type { IPnpmShrinkwrapYaml } from './PnpmShrinkwrapFile';
 /**
  * The `settings` parameter passed to {@link IPnpmfileShim.hooks.readPackage} and
@@ -19,6 +20,20 @@ export interface IPnpmfileShimSettings {
     workspaceVersions: Record<string, string>;
     userPnpmfilePath?: string;
 }
+export interface IWorkspaceProjectInfo extends Pick<RushConfigurationProject, 'packageName' | 'projectRelativeFolder'> {
+    packageVersion: RushConfigurationProject['packageJson']['version'];
+}
+/**
+ * The `settings` parameter passed to {@link IPnpmfileShim.hooks.readPackage} and
+ * {@link IPnpmfileShim.hooks.afterAllResolved}.
+ */
+export interface ISplitWorkspacePnpmfileShimSettings {
+    semverPath: string;
+    pathNormalizerPath: string;
+    workspaceProjects: Record<string, IWorkspaceProjectInfo>;
+    splitWorkspaceProjects: Record<string, IWorkspaceProjectInfo>;
+    userPnpmfilePath?: string;
+}
 /**
  * The `context` parameter passed to {@link IPnpmfile.hooks.readPackage}, as defined by the
  * pnpmfile API contract.
@@ -26,6 +41,7 @@ export interface IPnpmfileShimSettings {
 export interface IPnpmfileContext {
     log: (message: string) => void;
     pnpmfileShimSettings?: IPnpmfileShimSettings;
+    splitWorkspacePnpmfileShimSettings?: ISplitWorkspacePnpmfileShimSettings;
 }
 /**
  * The `log` parameter passed to {@link IPnpmfile.hooks.filterLog}.

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

@@ -1,9 +1,15 @@
 import { BaseProjectShrinkwrapFile } from '../base/BaseProjectShrinkwrapFile';
 import { PnpmShrinkwrapFile } from './PnpmShrinkwrapFile';
+import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 /**
  *
  */
 export declare class PnpmProjectShrinkwrapFile extends BaseProjectShrinkwrapFile<PnpmShrinkwrapFile> {
+    /**
+     * When split workspace projects turn off shared-workspace-lockfiles, Pnpm creates individual
+     * shrinkwrap files for each project.
+     */
+    static generateIndividualProjectShrinkwrapAsync(project: RushConfigurationProject): Promise<void>;
     /**
      * Generate and write the project shrinkwrap file to <project>/.rush/temp/shrinkwrap-deps.json.
      * @returns True if the project shrinkwrap was created or updated, false otherwise.
@@ -16,6 +22,7 @@ export declare class PnpmProjectShrinkwrapFile extends BaseProjectShrinkwrapFile
     protected generateProjectShrinkwrapMap(): Map<string, string> | undefined;
     protected generateWorkspaceProjectShrinkwrapMap(): Map<string, string> | undefined;
     protected generateLegacyProjectShrinkwrapMap(): Map<string, string>;
+    protected generateIndividualProjectShrinkwrapMap(): Map<string, string>;
     private _addDependencyRecursive;
     private _resolveAndAddPeerDependencies;
     /**

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

@@ -4,6 +4,7 @@ import { RushConfiguration } from '../../api/RushConfiguration';
 import { IShrinkwrapFilePolicyValidatorOptions } from '../policy/ShrinkwrapFilePolicy';
 import { IExperimentsJson } from '../../api/ExperimentsConfiguration';
 import { RushConfigurationProject } from '../../api/RushConfigurationProject';
+import { SplitWorkspacePnpmfileConfiguration } from './SplitWorkspacePnpmfileConfiguration';
 import { PnpmProjectShrinkwrapFile } from './PnpmProjectShrinkwrapFile';
 import { PackageManagerOptionsConfigurationBase } from '../base/BasePackageManagerOptionsConfiguration';
 export interface IPeerDependenciesMetaYaml {
@@ -91,6 +92,14 @@ export interface IPnpmShrinkwrapYaml {
     dependencies: {
         [dependency: string]: string;
     };
+    /** The list of resolved version numbers for develop dependencies */
+    devDependencies: {
+        [dependency: string]: string;
+    };
+    /** The list of resolved version numbers for optional dependencies */
+    optionalDependencies: {
+        [dependency: string]: string;
+    };
     /** The list of importers for local workspace projects */
     importers: {
         [relativePath: string]: IPnpmShrinkwrapImporterYaml;
@@ -105,6 +114,10 @@ export interface IPnpmShrinkwrapYaml {
     specifiers: {
         [dependency: string]: string;
     };
+    /** The list of override version number  for dependencies */
+    overrides: {
+        [dependency: string]: string;
+    };
 }
 /**
  * Given an encoded "dependency key" from the PNPM shrinkwrap file, this parses it into an equivalent
@@ -117,15 +130,23 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     readonly isWorkspaceCompatible: boolean;
     readonly registry: string;
     readonly dependencies: ReadonlyMap<string, string>;
+    readonly devDependencies: ReadonlyMap<string, string>;
+    readonly optionalDependencies: ReadonlyMap<string, string>;
     readonly importers: ReadonlyMap<string, IPnpmShrinkwrapImporterYaml>;
     readonly specifiers: ReadonlyMap<string, string>;
     readonly packages: ReadonlyMap<string, IPnpmShrinkwrapDependencyYaml>;
+    readonly overrides: ReadonlyMap<string, string>;
     private readonly _shrinkwrapJson;
     private readonly _integrities;
     private _pnpmfileConfiguration;
+    private _splitWorkspaceGlobalPnpmfileConfiguration;
+    private _individualPackageName;
+    private _individualShrinkwrapImporter;
     private constructor();
     static loadFromFile(shrinkwrapYamlFilename: string): PnpmShrinkwrapFile | undefined;
     static loadFromString(shrinkwrapContent: string): PnpmShrinkwrapFile;
+    setIndividualPackage(packageName: string, splitWorkspaceGlobalPnpmfileConfiguration?: SplitWorkspacePnpmfileConfiguration): void;
+    get isIndividual(): boolean;
     getShrinkwrapHash(experimentsConfig?: IExperimentsJson): string;
     /** @override */
     validate(packageManagerOptionsConfig: PackageManagerOptionsConfigurationBase, policyOptions: IShrinkwrapFilePolicyValidatorOptions, experimentsConfig?: IExperimentsJson): void;
@@ -192,8 +213,12 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     getImporterKeyByPath(workspaceRoot: string, projectFolder: string): string;
     getImporter(importerKey: string): IPnpmShrinkwrapImporterYaml | undefined;
     getIntegrityForImporter(importerKey: string): Map<string, string> | undefined;
+    getIntegrityForIndividualProject(): Map<string, string>;
     /** @override */
     isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, variant?: string): Promise<boolean>;
+    isSplitWorkspaceProjectModified(project: RushConfigurationProject): boolean;
+    isSplitWorkspaceIndividualProjectModified(project: RushConfigurationProject): boolean;
+    private _isProjectModified;
     private _getIntegrityForPackage;
     private _addIntegrities;
     /**
@@ -203,5 +228,6 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     private _getPackageId;
     private _parsePnpmDependencyKey;
     private _serializeInternal;
+    private _getIndividualShrinkwrapImporter;
 }
 //# sourceMappingURL=PnpmShrinkwrapFile.d.ts.map

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

@@ -0,0 +1,3 @@
+import type { IPnpmfileHooks } from './IPnpmfile';
+export declare const hooks: IPnpmfileHooks;
+//# sourceMappingURL=SplitWorkspaceGlobalPnpmfileShim.d.ts.map

package/lib/logic/pnpm/SplitWorkspaceGlobalPnpmfileShim.js

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

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

@@ -0,0 +1,23 @@
+import { IPackageJson } from '@rushstack/node-core-library';
+import type { RushConfiguration } from '../../api/RushConfiguration';
+/**
+ * Loads PNPM's pnpmfile.js configuration, and invokes it to preprocess package.json files,
+ * optionally utilizing a pnpmfile shim to inject preferred versions.
+ */
+export declare class SplitWorkspacePnpmfileConfiguration {
+    private _context;
+    constructor(rushConfiguration: RushConfiguration);
+    /**
+     * Split workspace use global pnpmfile, because in split workspace, user may set `shared-workspace-lockfile=false`.
+     * That means each project owns their individual pnpmfile under project folder. While the global pnpmfile could be
+     * under the common/temp-split/ folder and be used by all split workspace projects.
+     */
+    static writeCommonTempSplitGlobalPnpmfileAsync(rushConfiguration: RushConfiguration): Promise<void>;
+    private static _getSplitWorkspacePnpmfileShimSettings;
+    /**
+     * Transform a package.json file using the pnpmfile.js hook.
+     * @returns the tranformed object, or the original input if pnpmfile.js was not found.
+     */
+    transform(packageJson: IPackageJson): IPackageJson;
+}
+//# sourceMappingURL=SplitWorkspacePnpmfileConfiguration.d.ts.map

package/lib/logic/pnpm/SplitWorkspacePnpmfileConfiguration.js

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

package/lib/logic/selectors/SplitWorkspaceProjectSelectorParser.d.ts

@@ -0,0 +1,10 @@
+import type { RushConfiguration } from '../../api/RushConfiguration';
+import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
+import type { IEvaluateSelectorOptions, ISelectorParser } from './ISelectorParser';
+export declare class SplitWorkspaceProjectSelectorParser implements ISelectorParser<RushConfigurationProject> {
+    private readonly _rushConfiguration;
+    constructor(rushConfiguration: RushConfiguration);
+    evaluateSelectorAsync({ unscopedSelector, terminal, parameterName }: IEvaluateSelectorOptions): Promise<Iterable<RushConfigurationProject>>;
+    getCompletions(): Iterable<string>;
+}
+//# sourceMappingURL=SplitWorkspaceProjectSelectorParser.d.ts.map

package/lib/logic/selectors/SplitWorkspaceProjectSelectorParser.js

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

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

@@ -4,8 +4,10 @@ import { RushConfigurationProject } from '../../api/RushConfigurationProject';
 export declare class VersionMismatchFinderProject extends VersionMismatchFinderEntity {
     packageName: string;
     private _fileManager;
+    private _project;
     constructor(project: RushConfigurationProject);
     get filePath(): string;
+    get project(): RushConfigurationProject;
     get allDependencies(): ReadonlyArray<PackageJsonDependency>;
     tryGetDependency(packageName: string): PackageJsonDependency | undefined;
     tryGetDevDependency(packageName: string): PackageJsonDependency | undefined;

package/lib/utilities/PathConstants.d.ts

@@ -11,6 +11,7 @@ export declare const assetsFolderPath: string;
  */
 export declare const scriptsFolderName: string;
 export declare const pnpmfileShimFilename: string;
+export declare const splitWorkspacePnpmfileShimFilename: string;
 export declare const installRunScriptFilename: string;
 export declare const installRunRushScriptFilename: string;
 export declare const installRunRushxScriptFilename: string;

package/lib/utilities/SetRushLibPath.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SetRushLibPath.d.ts.map

package/lib/utilities/SetRushLibPath.js

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

package/lib/utilities/npmrcUtilities.d.ts

@@ -11,5 +11,5 @@ export interface ILogger {
  * @returns
  * 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 syncNpmrc(sourceNpmrcFolder: string, targetNpmrcFolder: string, useNpmrcPublish?: boolean, sourceNpmrcFilename?: string, logger?: ILogger): string | undefined;
 //# sourceMappingURL=npmrcUtilities.d.ts.map

package/lib-shim/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuLA;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAO1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkNA;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAO1E"}

package/lib-shim/index.js

@@ -48,7 +48,9 @@ function _require(moduleName) {
 }
 // SCENARIO 1:  Rush's PluginManager has initialized "rush-sdk" with Rush's own instance of rush-lib.
 // The Rush host process will assign "global.___rush___rushLibModule" before loading the plugin.
-let rushLibModule = global.___rush___rushLibModule || global.___rush___rushLibModuleFromInstallAndRunRush;
+let rushLibModule = global.___rush___rushLibModule ||
+    global.___rush___rushLibModuleFromEnvironment ||
+    global.___rush___rushLibModuleFromInstallAndRunRush;
 let errorMessage = '';
 // SCENARIO 2:  The project importing "rush-sdk" has installed its own instance of "rush-lib"
 // as a package.json dependency.  For example, this is used by the Jest tests for Rush plugins.
@@ -84,7 +86,28 @@ if (rushLibModule === undefined) {
         }
     }
 }
-// SCENARIO 3:  A tool or script depends on "rush-sdk", and is meant to be used inside a monorepo folder.
+// SCENARIO 3: A tool or script has been invoked as a child process by an instance of "rush-lib" and can use the
+// version that invoked it. In this case, use process.env._RUSH_LIB_PATH to find "rush-lib".
+if (rushLibModule === undefined) {
+    const rushLibVariable = '_RUSH_LIB_PATH';
+    const rushLibPath = process.env[rushLibVariable];
+    if (rushLibPath) {
+        terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from process.env.${rushLibVariable} from caller package`);
+        try {
+            rushLibModule = _require(rushLibPath);
+        }
+        catch (error) {
+            // Log this as a warning, since it is unexpected to define an incorrect value of the variable.
+            terminal.writeWarningLine(`Failed to load ${RUSH_LIB_NAME} via process.env.${rushLibVariable}`);
+        }
+        if (rushLibModule !== undefined) {
+            // to track which scenario is active and how it got initialized.
+            global.___rush___rushLibModuleFromEnvironment = rushLibModule;
+            terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from process.env.${rushLibVariable}`);
+        }
+    }
+}
+// SCENARIO 4:  A standalone tool or script depends on "rush-sdk", and is meant to be used inside a monorepo folder.
 // In this case, we can use install-run-rush.js to obtain the appropriate rush-lib version for the monorepo.
 if (rushLibModule === undefined) {
     try {

package/lib-shim/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'path';\nimport {\n  JsonFile,\n  JsonObject,\n  Import,\n  IPackageJson,\n  PackageJsonLookup,\n  Executable,\n  FileSystem,\n  Terminal,\n  ConsoleTerminalProvider\n} from '@rushstack/node-core-library';\nimport type { SpawnSyncReturns } from 'child_process';\n\nconst RUSH_LIB_NAME: string = '@microsoft/rush-lib';\n\nconst verboseEnabled: boolean = typeof process !== 'undefined' && process.env.RUSH_SDK_DEBUG === '1';\nconst terminal: Terminal = new Terminal(\n  new ConsoleTerminalProvider({\n    verboseEnabled\n  })\n);\n\ntype RushLibModuleType = Record<string, unknown>;\ndeclare const global: NodeJS.Global &\n  typeof globalThis & {\n    ___rush___rushLibModule?: RushLibModuleType;\n    ___rush___rushLibModuleFromInstallAndRunRush?: RushLibModuleType;\n  };\n\nfunction _require<TResult>(moduleName: string): TResult {\n  if (typeof __non_webpack_require__ === 'function') {\n    // If this library has been bundled with Webpack, we need to call the real `require` function\n    // that doesn't get turned into a `__webpack_require__` statement.\n    // `__non_webpack_require__` is a Webpack macro that gets turned into a `require` statement\n    // during bundling.\n    return __non_webpack_require__(moduleName);\n  } else {\n    return require(moduleName);\n  }\n}\n\n// SCENARIO 1:  Rush's PluginManager has initialized \"rush-sdk\" with Rush's own instance of rush-lib.\n// The Rush host process will assign \"global.___rush___rushLibModule\" before loading the plugin.\nlet rushLibModule: RushLibModuleType | undefined =\n  global.___rush___rushLibModule || global.___rush___rushLibModuleFromInstallAndRunRush;\nlet errorMessage: string = '';\n\n// SCENARIO 2:  The project importing \"rush-sdk\" has installed its own instance of \"rush-lib\"\n// as a package.json dependency.  For example, this is used by the Jest tests for Rush plugins.\nif (rushLibModule === undefined) {\n  const importingPath: string | null | undefined = module?.parent?.filename;\n  if (importingPath) {\n    const callerPackageFolder: string | undefined =\n      PackageJsonLookup.instance.tryGetPackageFolderFor(importingPath);\n\n    if (callerPackageFolder !== undefined) {\n      const callerPackageJson: IPackageJson = _require(path.join(callerPackageFolder, 'package.json'));\n\n      // Does the caller properly declare a dependency on rush-lib?\n      if (\n        (callerPackageJson.dependencies && callerPackageJson.dependencies[RUSH_LIB_NAME] !== undefined) ||\n        (callerPackageJson.devDependencies &&\n          callerPackageJson.devDependencies[RUSH_LIB_NAME] !== undefined) ||\n        (callerPackageJson.peerDependencies &&\n          callerPackageJson.peerDependencies[RUSH_LIB_NAME] !== undefined)\n      ) {\n        // Try to resolve rush-lib from the caller's folder\n        terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from caller package`);\n        try {\n          rushLibModule = requireRushLibUnderFolderPath(callerPackageFolder);\n        } catch (error) {\n          // If we fail to resolve it, ignore the error\n          terminal.writeVerboseLine(`Failed to load ${RUSH_LIB_NAME} from caller package`);\n        }\n\n        // If two different libraries invoke `rush-sdk`, and one of them provides \"rush-lib\"\n        // then the first version to be loaded wins.  We do not support side-by-side instances of \"rush-lib\".\n        if (rushLibModule !== undefined) {\n          // to track which scenario is active and how it got initialized.\n          global.___rush___rushLibModule = rushLibModule;\n          terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from caller`);\n        }\n      }\n    }\n  }\n}\n\n// SCENARIO 3:  A tool or script depends on \"rush-sdk\", and is meant to be used inside a monorepo folder.\n// In this case, we can use install-run-rush.js to obtain the appropriate rush-lib version for the monorepo.\nif (rushLibModule === undefined) {\n  try {\n    const rushJsonPath: string | undefined = tryFindRushJsonLocation(process.cwd());\n    if (!rushJsonPath) {\n      throw new Error(\n        'Unable to find rush.json in the current folder or its parent folders.\\n' +\n          'This tool is meant to be invoked from a working directory inside a Rush repository.'\n      );\n    }\n    const monorepoRoot: string = path.dirname(rushJsonPath);\n\n    const rushJson: JsonObject = JsonFile.load(rushJsonPath);\n    const { rushVersion } = rushJson;\n\n    const installRunNodeModuleFolder: string = path.join(\n      monorepoRoot,\n      `common/temp/install-run/@microsoft+rush@${rushVersion}`\n    );\n\n    try {\n      // First, try to load the version of \"rush-lib\" that was installed by install-run-rush.js\n      terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush`);\n      rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);\n    } catch (e) {\n      let installAndRunRushStderrContent: string = '';\n      try {\n        const installAndRunRushJSPath: string = path.join(monorepoRoot, 'common/scripts/install-run-rush.js');\n\n        terminal.writeLine('The Rush engine has not been installed yet. Invoking install-run-rush.js...');\n\n        const installAndRuhRushProcess: SpawnSyncReturns<string> = Executable.spawnSync(\n          'node',\n          [installAndRunRushJSPath, '--help'],\n          {\n            stdio: 'pipe'\n          }\n        );\n\n        installAndRunRushStderrContent = installAndRuhRushProcess.stderr;\n        if (installAndRuhRushProcess.status !== 0) {\n          throw new Error(`The ${RUSH_LIB_NAME} package failed to install`);\n        }\n\n        // Retry to load \"rush-lib\" after install-run-rush run\n        terminal.writeVerboseLine(\n          `Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush a second time`\n        );\n        rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);\n      } catch (e) {\n        console.error(`${installAndRunRushStderrContent}`);\n        throw new Error(`The ${RUSH_LIB_NAME} package failed to load`);\n      }\n    }\n\n    if (rushLibModule !== undefined) {\n      // to track which scenario is active and how it got initialized.\n      global.___rush___rushLibModuleFromInstallAndRunRush = rushLibModule;\n      terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} installed by install-run-rush`);\n    }\n  } catch (e) {\n    // no-catch\n    errorMessage = (e as Error).message;\n  }\n}\n\nif (rushLibModule === undefined) {\n  // This error indicates that a project is trying to import \"@rushstack/rush-sdk\", but the Rush engine\n  // instance cannot be found.  If you are writing Jest tests for a Rush plugin, add \"@microsoft/rush-lib\"\n  // to the devDependencies for your project.\n  console.error(`Error: The @rushstack/rush-sdk package was not able to load the Rush engine:\n${errorMessage}\n`);\n  process.exit(1);\n}\n\n// Based on TypeScript's __exportStar()\nfor (const property in rushLibModule) {\n  if (property !== 'default' && !exports.hasOwnProperty(property)) {\n    const rushLibModuleForClosure: RushLibModuleType = rushLibModule;\n\n    // Based on TypeScript's __createBinding()\n    Object.defineProperty(exports, property, {\n      enumerable: true,\n      get: function () {\n        return rushLibModuleForClosure[property];\n      }\n    });\n  }\n}\n\n/**\n * Used by the .js stubs for path-based imports of `@microsoft/rush-lib` internal APIs.\n */\nexport function _rushSdk_loadInternalModule(srcImportPath: string): unknown {\n  if (!exports._RushInternals) {\n    throw new Error(\n      `Rush version ${exports.Rush.version} does not support internal API imports via rush-sdk`\n    );\n  }\n  return exports._RushInternals.loadModule(srcImportPath);\n}\n\n/**\n * Require `@microsoft/rush-lib` under the specified folder path.\n */\nfunction requireRushLibUnderFolderPath(folderPath: string): RushLibModuleType {\n  const rushLibModulePath: string = Import.resolveModule({\n    modulePath: RUSH_LIB_NAME,\n    baseFolderPath: folderPath\n  });\n\n  return _require(rushLibModulePath);\n}\n\n/**\n * Find the rush.json location and return the path, or undefined if a rush.json can't be found.\n *\n * @privateRemarks\n * Keep this in sync with `RushConfiguration.tryFindRushJsonLocation`.\n */\nfunction tryFindRushJsonLocation(startingFolder: string): string | undefined {\n  let currentFolder: string = startingFolder;\n\n  // Look upwards at parent folders until we find a folder containing rush.json\n  for (let i: number = 0; i < 10; ++i) {\n    const rushJsonFilename: string = path.join(currentFolder, 'rush.json');\n\n    if (FileSystem.exists(rushJsonFilename)) {\n      return rushJsonFilename;\n    }\n\n    const parentFolder: string = path.dirname(currentFolder);\n    if (parentFolder === currentFolder) {\n      break;\n    }\n\n    currentFolder = parentFolder;\n  }\n\n  return undefined;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'path';\nimport {\n  JsonFile,\n  JsonObject,\n  Import,\n  IPackageJson,\n  PackageJsonLookup,\n  Executable,\n  FileSystem,\n  Terminal,\n  ConsoleTerminalProvider\n} from '@rushstack/node-core-library';\nimport type { SpawnSyncReturns } from 'child_process';\n\nconst RUSH_LIB_NAME: '@microsoft/rush-lib' = '@microsoft/rush-lib';\n\nconst verboseEnabled: boolean = typeof process !== 'undefined' && process.env.RUSH_SDK_DEBUG === '1';\nconst terminal: Terminal = new Terminal(\n  new ConsoleTerminalProvider({\n    verboseEnabled\n  })\n);\n\ntype RushLibModuleType = Record<string, unknown>;\ndeclare const global: NodeJS.Global &\n  typeof globalThis & {\n    ___rush___rushLibModule?: RushLibModuleType;\n    ___rush___rushLibModuleFromEnvironment?: RushLibModuleType;\n    ___rush___rushLibModuleFromInstallAndRunRush?: RushLibModuleType;\n  };\n\nfunction _require<TResult>(moduleName: string): TResult {\n  if (typeof __non_webpack_require__ === 'function') {\n    // If this library has been bundled with Webpack, we need to call the real `require` function\n    // that doesn't get turned into a `__webpack_require__` statement.\n    // `__non_webpack_require__` is a Webpack macro that gets turned into a `require` statement\n    // during bundling.\n    return __non_webpack_require__(moduleName);\n  } else {\n    return require(moduleName);\n  }\n}\n\n// SCENARIO 1:  Rush's PluginManager has initialized \"rush-sdk\" with Rush's own instance of rush-lib.\n// The Rush host process will assign \"global.___rush___rushLibModule\" before loading the plugin.\nlet rushLibModule: RushLibModuleType | undefined =\n  global.___rush___rushLibModule ||\n  global.___rush___rushLibModuleFromEnvironment ||\n  global.___rush___rushLibModuleFromInstallAndRunRush;\nlet errorMessage: string = '';\n\n// SCENARIO 2:  The project importing \"rush-sdk\" has installed its own instance of \"rush-lib\"\n// as a package.json dependency.  For example, this is used by the Jest tests for Rush plugins.\nif (rushLibModule === undefined) {\n  const importingPath: string | null | undefined = module?.parent?.filename;\n  if (importingPath) {\n    const callerPackageFolder: string | undefined =\n      PackageJsonLookup.instance.tryGetPackageFolderFor(importingPath);\n\n    if (callerPackageFolder !== undefined) {\n      const callerPackageJson: IPackageJson = _require(path.join(callerPackageFolder, 'package.json'));\n\n      // Does the caller properly declare a dependency on rush-lib?\n      if (\n        (callerPackageJson.dependencies && callerPackageJson.dependencies[RUSH_LIB_NAME] !== undefined) ||\n        (callerPackageJson.devDependencies &&\n          callerPackageJson.devDependencies[RUSH_LIB_NAME] !== undefined) ||\n        (callerPackageJson.peerDependencies &&\n          callerPackageJson.peerDependencies[RUSH_LIB_NAME] !== undefined)\n      ) {\n        // Try to resolve rush-lib from the caller's folder\n        terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from caller package`);\n        try {\n          rushLibModule = requireRushLibUnderFolderPath(callerPackageFolder);\n        } catch (error) {\n          // If we fail to resolve it, ignore the error\n          terminal.writeVerboseLine(`Failed to load ${RUSH_LIB_NAME} from caller package`);\n        }\n\n        // If two different libraries invoke `rush-sdk`, and one of them provides \"rush-lib\"\n        // then the first version to be loaded wins.  We do not support side-by-side instances of \"rush-lib\".\n        if (rushLibModule !== undefined) {\n          // to track which scenario is active and how it got initialized.\n          global.___rush___rushLibModule = rushLibModule;\n          terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from caller`);\n        }\n      }\n    }\n  }\n}\n\n// SCENARIO 3: A tool or script has been invoked as a child process by an instance of \"rush-lib\" and can use the\n// version that invoked it. In this case, use process.env._RUSH_LIB_PATH to find \"rush-lib\".\nif (rushLibModule === undefined) {\n  const rushLibVariable: '_RUSH_LIB_PATH' = '_RUSH_LIB_PATH';\n  const rushLibPath: string | undefined = process.env[rushLibVariable];\n  if (rushLibPath) {\n    terminal.writeVerboseLine(\n      `Try to load ${RUSH_LIB_NAME} from process.env.${rushLibVariable} from caller package`\n    );\n    try {\n      rushLibModule = _require(rushLibPath);\n    } catch (error) {\n      // Log this as a warning, since it is unexpected to define an incorrect value of the variable.\n      terminal.writeWarningLine(`Failed to load ${RUSH_LIB_NAME} via process.env.${rushLibVariable}`);\n    }\n\n    if (rushLibModule !== undefined) {\n      // to track which scenario is active and how it got initialized.\n      global.___rush___rushLibModuleFromEnvironment = rushLibModule;\n      terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from process.env.${rushLibVariable}`);\n    }\n  }\n}\n\n// SCENARIO 4:  A standalone tool or script depends on \"rush-sdk\", and is meant to be used inside a monorepo folder.\n// In this case, we can use install-run-rush.js to obtain the appropriate rush-lib version for the monorepo.\nif (rushLibModule === undefined) {\n  try {\n    const rushJsonPath: string | undefined = tryFindRushJsonLocation(process.cwd());\n    if (!rushJsonPath) {\n      throw new Error(\n        'Unable to find rush.json in the current folder or its parent folders.\\n' +\n          'This tool is meant to be invoked from a working directory inside a Rush repository.'\n      );\n    }\n    const monorepoRoot: string = path.dirname(rushJsonPath);\n\n    const rushJson: JsonObject = JsonFile.load(rushJsonPath);\n    const { rushVersion } = rushJson;\n\n    const installRunNodeModuleFolder: string = path.join(\n      monorepoRoot,\n      `common/temp/install-run/@microsoft+rush@${rushVersion}`\n    );\n\n    try {\n      // First, try to load the version of \"rush-lib\" that was installed by install-run-rush.js\n      terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush`);\n      rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);\n    } catch (e) {\n      let installAndRunRushStderrContent: string = '';\n      try {\n        const installAndRunRushJSPath: string = path.join(monorepoRoot, 'common/scripts/install-run-rush.js');\n\n        terminal.writeLine('The Rush engine has not been installed yet. Invoking install-run-rush.js...');\n\n        const installAndRuhRushProcess: SpawnSyncReturns<string> = Executable.spawnSync(\n          'node',\n          [installAndRunRushJSPath, '--help'],\n          {\n            stdio: 'pipe'\n          }\n        );\n\n        installAndRunRushStderrContent = installAndRuhRushProcess.stderr;\n        if (installAndRuhRushProcess.status !== 0) {\n          throw new Error(`The ${RUSH_LIB_NAME} package failed to install`);\n        }\n\n        // Retry to load \"rush-lib\" after install-run-rush run\n        terminal.writeVerboseLine(\n          `Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush a second time`\n        );\n        rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);\n      } catch (e) {\n        console.error(`${installAndRunRushStderrContent}`);\n        throw new Error(`The ${RUSH_LIB_NAME} package failed to load`);\n      }\n    }\n\n    if (rushLibModule !== undefined) {\n      // to track which scenario is active and how it got initialized.\n      global.___rush___rushLibModuleFromInstallAndRunRush = rushLibModule;\n      terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} installed by install-run-rush`);\n    }\n  } catch (e) {\n    // no-catch\n    errorMessage = (e as Error).message;\n  }\n}\n\nif (rushLibModule === undefined) {\n  // This error indicates that a project is trying to import \"@rushstack/rush-sdk\", but the Rush engine\n  // instance cannot be found.  If you are writing Jest tests for a Rush plugin, add \"@microsoft/rush-lib\"\n  // to the devDependencies for your project.\n  console.error(`Error: The @rushstack/rush-sdk package was not able to load the Rush engine:\n${errorMessage}\n`);\n  process.exit(1);\n}\n\n// Based on TypeScript's __exportStar()\nfor (const property in rushLibModule) {\n  if (property !== 'default' && !exports.hasOwnProperty(property)) {\n    const rushLibModuleForClosure: RushLibModuleType = rushLibModule;\n\n    // Based on TypeScript's __createBinding()\n    Object.defineProperty(exports, property, {\n      enumerable: true,\n      get: function () {\n        return rushLibModuleForClosure[property];\n      }\n    });\n  }\n}\n\n/**\n * Used by the .js stubs for path-based imports of `@microsoft/rush-lib` internal APIs.\n */\nexport function _rushSdk_loadInternalModule(srcImportPath: string): unknown {\n  if (!exports._RushInternals) {\n    throw new Error(\n      `Rush version ${exports.Rush.version} does not support internal API imports via rush-sdk`\n    );\n  }\n  return exports._RushInternals.loadModule(srcImportPath);\n}\n\n/**\n * Require `@microsoft/rush-lib` under the specified folder path.\n */\nfunction requireRushLibUnderFolderPath(folderPath: string): RushLibModuleType {\n  const rushLibModulePath: string = Import.resolveModule({\n    modulePath: RUSH_LIB_NAME,\n    baseFolderPath: folderPath\n  });\n\n  return _require(rushLibModulePath);\n}\n\n/**\n * Find the rush.json location and return the path, or undefined if a rush.json can't be found.\n *\n * @privateRemarks\n * Keep this in sync with `RushConfiguration.tryFindRushJsonLocation`.\n */\nfunction tryFindRushJsonLocation(startingFolder: string): string | undefined {\n  let currentFolder: string = startingFolder;\n\n  // Look upwards at parent folders until we find a folder containing rush.json\n  for (let i: number = 0; i < 10; ++i) {\n    const rushJsonFilename: string = path.join(currentFolder, 'rush.json');\n\n    if (FileSystem.exists(rushJsonFilename)) {\n      return rushJsonFilename;\n    }\n\n    const parentFolder: string = path.dirname(currentFolder);\n    if (parentFolder === currentFolder) {\n      break;\n    }\n\n    currentFolder = parentFolder;\n  }\n\n  return undefined;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.92.0",
+  "version": "5.93.1-pr3481.17",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -17,10 +17,10 @@
     "@rushstack/node-core-library": "3.55.2"
   },
   "devDependencies": {
+    "@microsoft/rush-lib": "5.93.1-pr3481.17",
     "@types/heft-jest": "1.0.1",
     "@types/semver": "7.3.5",
     "@types/webpack-env": "1.18.0",
-    "@microsoft/rush-lib": "5.92.0",
     "@rushstack/eslint-config": "3.2.0",
     "@rushstack/heft": "0.49.7",
     "@rushstack/heft-node-rig": "1.12.4",