@rushstack/rush-sdk 5.107.0 → 5.107.1-pr3481.20

package/dist/rush-lib.d.ts

@@ -132,6 +132,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 "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.
@@ -1284,6 +1333,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.
@@ -1363,6 +1417,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.
  *
@@ -1950,6 +2049,7 @@ declare interface IRushConfigurationProjectJson {
     skipRushCheck?: boolean;
     publishFolder?: string;
     tags?: string[];
+    splitWorkspace?: boolean;
 }
 
 /**
@@ -1974,6 +2074,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.
  */
@@ -2264,19 +2374,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;
@@ -2290,14 +2390,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
      */
@@ -3205,6 +3297,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
@@ -3259,6 +3353,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.
@@ -3313,6 +3413,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.
@@ -3579,6 +3694,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
@@ -3597,6 +3717,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.
@@ -3629,6 +3753,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.
@@ -3664,6 +3793,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;
 }
 
 /**
@@ -3779,6 +3914,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);
     /**
@@ -3888,6 +4028,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/ExperimentsConfiguration.d.ts

@@ -41,6 +41,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/RushConfiguration.d.ts

@@ -118,6 +118,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
@@ -144,6 +153,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
@@ -198,6 +209,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.
@@ -252,6 +269,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.
@@ -518,6 +550,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
@@ -536,6 +573,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.
@@ -568,6 +609,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.
@@ -603,5 +649,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 "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

@@ -27,7 +27,8 @@ export { RepoStateFile } from './logic/RepoStateFile';
 export { LookupByPath, IPrefixMatch } 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/UnlinkManager.d.ts

@@ -11,7 +11,7 @@ export declare class UnlinkManager {
      *
      * Returns true if anything was deleted.
      */
-    unlink(force?: boolean): boolean;
+    unlinkAsync(force?: boolean): Promise<boolean>;
     /**
      * Delete:
      *  - all the node_modules symlinks of configured Rush projects
@@ -19,6 +19,6 @@ export declare class UnlinkManager {
      *
      * Returns true if anything was deleted
      * */
-    private _deleteProjectFiles;
+    private _deleteProjectFilesAsync;
 }
 //# sourceMappingURL=UnlinkManager.d.ts.map

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.
@@ -69,5 +71,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 {
@@ -86,6 +87,10 @@ export interface IPnpmShrinkwrapYaml {
     lockfileVersion?: string | number;
     /** The list of resolved version numbers for direct dependencies */
     dependencies: Record<string, string>;
+    /** The list of resolved version numbers for dev dependencies */
+    devDependencies: Record<string, string>;
+    /** The list of resolved version numbers for optional dependencies */
+    optionalDependencies: Record<string, string>;
     /** The list of importers for local workspace projects */
     importers: Record<string, IPnpmShrinkwrapImporterYaml>;
     /** The description of the solved graph */
@@ -112,6 +117,8 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     readonly isWorkspaceCompatible: boolean;
     readonly registry: string;
     readonly dependencies: ReadonlyMap<string, IPnpmVersionSpecifier>;
+    readonly devDependencies: ReadonlyMap<string, IPnpmVersionSpecifier>;
+    readonly optionalDependencies: ReadonlyMap<string, IPnpmVersionSpecifier>;
     readonly importers: ReadonlyMap<string, IPnpmShrinkwrapImporterYaml>;
     readonly specifiers: ReadonlyMap<string, string>;
     readonly packages: ReadonlyMap<string, IPnpmShrinkwrapDependencyYaml>;
@@ -119,9 +126,14 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     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;
@@ -208,8 +220,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;
     /**
@@ -219,5 +235,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/Utilities.d.ts

@@ -102,6 +102,12 @@ export declare class Utilities {
      * hard disk.
      */
     static dangerouslyDeletePath(folderPath: string): void;
+    /**
+     * BE VERY CAREFUL CALLING THIS FUNCTION!
+     * If you specify the wrong folderPath (e.g. "/"), it could potentially delete your entire
+     * hard disk.
+     */
+    static dangerouslyDeletePathAsync(folderPath: string): Promise<void>;
     static isFileTimestampCurrent(dateToCompare: Date, inputFilenames: string[]): boolean;
     /**
      * Executes the command with the specified command-line parameters, and waits for it to complete.

package/lib/utilities/npmrcUtilities.d.ts

@@ -11,6 +11,6 @@ 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;
 export declare function isVariableSetInNpmrcFile(sourceNpmrcFolder: string, variableKey: string): boolean;
 //# sourceMappingURL=npmrcUtilities.d.ts.map

package/lib/utilities/objectUtilities.d.ts

@@ -4,4 +4,9 @@
 export declare function objectsAreDeepEqual<TObject>(a: TObject, b: TObject): boolean;
 export declare function cloneDeep<TObject>(obj: TObject): TObject;
 export declare function merge<TBase extends object, TOther>(base: TBase, other: TOther): (TBase & TOther) | TOther;
+/**
+ * Performs a partial deep comparison between `obj` and `source` to
+ * determine if `obj` contains equivalent property values.
+ */
+export declare function isMatch<TObject>(obj: TObject, source: TObject): boolean;
 //# sourceMappingURL=objectUtilities.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.107.0",
+  "version": "5.107.1-pr3481.20",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -28,16 +28,15 @@
     "@rushstack/node-core-library": "3.60.0"
   },
   "devDependencies": {
-    "@types/node": "18.17.15",
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.0",
-    "@microsoft/rush-lib": "5.107.0",
+    "@microsoft/rush-lib": "5.107.1-pr3481.20",
     "@rushstack/eslint-config": "3.3.4",
-    "@rushstack/heft": "0.59.0",
-    "@rushstack/heft-node-rig": "2.2.23",
-    "@rushstack/stream-collator": "4.1.1",
+    "@rushstack/heft": "0.60.0",
+    "local-node-rig": "1.0.0",
+    "@rushstack/stream-collator": "4.1.2",
     "@rushstack/ts-command-line": "4.16.0",
-    "@rushstack/terminal": "0.7.0"
+    "@rushstack/terminal": "0.7.1"
   },
   "scripts": {
     "build": "heft build --clean",