@rushstack/rush-sdk 5.96.0 → 5.97.1-pr3481.18

package/lib/api/CobuildConfiguration.d.ts

@@ -0,0 +1,63 @@
+import { ITerminal } from '@rushstack/node-core-library';
+import { RushSession } from '../pluginFramework/RushSession';
+import type { ICobuildLockProvider } from '../logic/cobuild/ICobuildLockProvider';
+import type { RushConfiguration } from './RushConfiguration';
+/**
+ * @beta
+ */
+export interface ICobuildJson {
+    cobuildEnabled: boolean;
+    cobuildLockProvider: string;
+}
+/**
+ * @beta
+ */
+export interface ICobuildConfigurationOptions {
+    cobuildJson: ICobuildJson;
+    rushConfiguration: RushConfiguration;
+    rushSession: RushSession;
+}
+/**
+ * Use this class to load and save the "common/config/rush/cobuild.json" config file.
+ * This file provides configuration options for the Rush Cobuild feature.
+ * @beta
+ */
+export declare class CobuildConfiguration {
+    private static _jsonSchema;
+    /**
+     * Indicates whether the cobuild feature is enabled.
+     * Typically it is enabled in the cobuild.json config file.
+     *
+     * Note: The orchestrator (or local users) should always have to opt into running with cobuilds by
+     * providing a cobuild context id. Even if cobuilds are "enabled" as a feature, they don't
+     * actually turn on for that particular build unless the cobuild context id is provided as an
+     * non-empty string.
+     */
+    readonly cobuildEnabled: boolean;
+    /**
+     * Cobuild context id
+     *
+     * @remarks
+     * The cobuild feature won't be enabled until the context id is provided as an non-empty string.
+     */
+    readonly cobuildContextId: string | undefined;
+    /**
+     * If true, Rush will automatically handle the leaf project with build cache "disabled" by writing
+     * to the cache in a special "log files only mode". This is useful when you want to use Cobuilds
+     * to improve the performance in CI validations and the leaf projects have not enabled cache.
+     */
+    readonly cobuildLeafProjectLogOnlyAllowed: boolean;
+    readonly cobuildLockProvider: ICobuildLockProvider;
+    private constructor();
+    /**
+     * Attempts to load the cobuild.json data from the standard file path `common/config/rush/cobuild.json`.
+     * If the file has not been created yet, then undefined is returned.
+     */
+    static tryLoadAsync(terminal: ITerminal, rushConfiguration: RushConfiguration, rushSession: RushSession): Promise<CobuildConfiguration | undefined>;
+    static getCobuildConfigFilePath(rushConfiguration: RushConfiguration): string;
+    private static _loadAsync;
+    get contextId(): string | undefined;
+    connectLockProviderAsync(): Promise<void>;
+    disconnectLockProviderAsync(): Promise<void>;
+}
+//# sourceMappingURL=CobuildConfiguration.d.ts.map

package/lib/api/CobuildConfiguration.js

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

package/lib/api/EnvironmentConfiguration.d.ts

@@ -9,7 +9,7 @@ export interface IEnvironmentConfigurationInitializeOptions {
  * Names of environment variables used by Rush.
  * @beta
  */
-export declare enum EnvironmentVariableNames {
+export declare const EnvironmentVariableNames: {
     /**
      * This variable overrides the temporary folder used by Rush.
      * The default value is "common/temp" under the repository root.
@@ -17,43 +17,43 @@ export declare enum EnvironmentVariableNames {
      * @remarks This environment variable is not compatible with workspace installs. If attempting
      * to move the PNPM store path, see the `RUSH_PNPM_STORE_PATH` environment variable.
      */
-    RUSH_TEMP_FOLDER = "RUSH_TEMP_FOLDER",
+    readonly RUSH_TEMP_FOLDER: "RUSH_TEMP_FOLDER";
     /**
      * This variable overrides the version of Rush that will be installed by
      * the version selector.  The default value is determined by the "rushVersion"
      * field from rush.json.
      */
-    RUSH_PREVIEW_VERSION = "RUSH_PREVIEW_VERSION",
+    readonly RUSH_PREVIEW_VERSION: "RUSH_PREVIEW_VERSION";
     /**
      * If this variable is set to "1", Rush will not fail the build when running a version
      * of Node that does not match the criteria specified in the "nodeSupportedVersionRange"
      * field from rush.json.
      */
-    RUSH_ALLOW_UNSUPPORTED_NODEJS = "RUSH_ALLOW_UNSUPPORTED_NODEJS",
+    readonly RUSH_ALLOW_UNSUPPORTED_NODEJS: "RUSH_ALLOW_UNSUPPORTED_NODEJS";
     /**
      * Setting this environment variable overrides the value of `allowWarningsInSuccessfulBuild`
      * in the `command-line.json` configuration file. Specify `1` to allow warnings in a successful build,
      * or `0` to disallow them. (See the comments in the command-line.json file for more information).
      */
-    RUSH_ALLOW_WARNINGS_IN_SUCCESSFUL_BUILD = "RUSH_ALLOW_WARNINGS_IN_SUCCESSFUL_BUILD",
+    readonly RUSH_ALLOW_WARNINGS_IN_SUCCESSFUL_BUILD: "RUSH_ALLOW_WARNINGS_IN_SUCCESSFUL_BUILD";
     /**
      * This variable selects a specific installation variant for Rush to use when installing
      * and linking package dependencies.
      * For more information, see the command-line help for the `--variant` parameter
      * and this article:  https://rushjs.io/pages/advanced/installation_variants/
      */
-    RUSH_VARIANT = "RUSH_VARIANT",
+    readonly RUSH_VARIANT: "RUSH_VARIANT";
     /**
      * Specifies the maximum number of concurrent processes to launch during a build.
      * For more information, see the command-line help for the `--parallelism` parameter for "rush build".
      */
-    RUSH_PARALLELISM = "RUSH_PARALLELISM",
+    readonly RUSH_PARALLELISM: "RUSH_PARALLELISM";
     /**
      * If this variable is set to "1", Rush will create symlinks with absolute paths instead
      * of relative paths. This can be necessary when a repository is moved during a build or
      * if parts of a repository are moved into a sandbox.
      */
-    RUSH_ABSOLUTE_SYMLINKS = "RUSH_ABSOLUTE_SYMLINKS",
+    readonly RUSH_ABSOLUTE_SYMLINKS: "RUSH_ABSOLUTE_SYMLINKS";
     /**
      * When using PNPM as the package manager, this variable can be used to configure the path that
      * PNPM will use as the store directory.
@@ -61,18 +61,18 @@ export declare enum EnvironmentVariableNames {
      * If a relative path is used, then the store path will be resolved relative to the process's
      * current working directory.  An absolute path is recommended.
      */
-    RUSH_PNPM_STORE_PATH = "RUSH_PNPM_STORE_PATH",
+    readonly RUSH_PNPM_STORE_PATH: "RUSH_PNPM_STORE_PATH";
     /**
      * When using PNPM as the package manager, this variable can be used to control whether or not PNPM
      * validates the integrity of the PNPM store during installation. The value of this environment variable must be
      * `1` (for true) or `0` (for false). If not specified, defaults to the value in .npmrc.
      */
-    RUSH_PNPM_VERIFY_STORE_INTEGRITY = "RUSH_PNPM_VERIFY_STORE_INTEGRITY",
+    readonly RUSH_PNPM_VERIFY_STORE_INTEGRITY: "RUSH_PNPM_VERIFY_STORE_INTEGRITY";
     /**
      * This environment variable can be used to specify the `--target-folder` parameter
      * for the "rush deploy" command.
      */
-    RUSH_DEPLOY_TARGET_FOLDER = "RUSH_DEPLOY_TARGET_FOLDER",
+    readonly RUSH_DEPLOY_TARGET_FOLDER: "RUSH_DEPLOY_TARGET_FOLDER";
     /**
      * Overrides the location of the `~/.rush` global folder where Rush stores temporary files.
      *
@@ -89,7 +89,7 @@ export declare enum EnvironmentVariableNames {
      *
      * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
      */
-    RUSH_GLOBAL_FOLDER = "RUSH_GLOBAL_FOLDER",
+    readonly RUSH_GLOBAL_FOLDER: "RUSH_GLOBAL_FOLDER";
     /**
      * Provides a credential for a remote build cache, if configured.  This credential overrides any cached credentials.
      *
@@ -103,7 +103,7 @@ export declare enum EnvironmentVariableNames {
      *
      * For information on SAS tokens, see here: https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview
      */
-    RUSH_BUILD_CACHE_CREDENTIAL = "RUSH_BUILD_CACHE_CREDENTIAL",
+    readonly RUSH_BUILD_CACHE_CREDENTIAL: "RUSH_BUILD_CACHE_CREDENTIAL";
     /**
      * Setting this environment variable overrides the value of `buildCacheEnabled` in the `build-cache.json`
      * configuration file.
@@ -113,26 +113,49 @@ export declare enum EnvironmentVariableNames {
      *
      * If there is no build cache configured, then this environment variable is ignored.
      */
-    RUSH_BUILD_CACHE_ENABLED = "RUSH_BUILD_CACHE_ENABLED",
+    readonly RUSH_BUILD_CACHE_ENABLED: "RUSH_BUILD_CACHE_ENABLED";
     /**
      * Overrides the value of `isCacheWriteAllowed` in the `build-cache.json` configuration file. The value of this
      * environment variable must be `1` (for true) or `0` (for false). If there is no build cache configured, then
      * this environment variable is ignored.
      */
-    RUSH_BUILD_CACHE_WRITE_ALLOWED = "RUSH_BUILD_CACHE_WRITE_ALLOWED",
+    readonly RUSH_BUILD_CACHE_WRITE_ALLOWED: "RUSH_BUILD_CACHE_WRITE_ALLOWED";
+    /**
+     * Setting this environment variable overrides the value of `cobuildEnabled` in the `cobuild.json`
+     * configuration file.
+     *
+     * @remarks
+     * Specify `1` to enable the cobuild or `0` to disable it.
+     *
+     * If there is no cobuild configured, then this environment variable is ignored.
+     */
+    readonly RUSH_COBUILD_ENABLED: "RUSH_COBUILD_ENABLED";
+    /**
+     * Setting this environment variable opt into running with cobuilds.
+     *
+     * @remarks
+     * If there is no cobuild configured, then this environment variable is ignored.
+     */
+    readonly RUSH_COBUILD_CONTEXT_ID: "RUSH_COBUILD_CONTEXT_ID";
+    /**
+     * If this variable is set to "1", When getting distributed builds, Rush will automatically handle the leaf project
+     * with build cache "disabled" by writing to the cache in a special "log files only mode". This is useful when you
+     * want to use Cobuilds to improve the performance in CI validations and the leaf projects have not enabled cache.
+     */
+    readonly RUSH_COBUILD_LEAF_PROJECT_LOG_ONLY_ALLOWED: "RUSH_COBUILD_LEAF_PROJECT_LOG_ONLY_ALLOWED";
     /**
      * Explicitly specifies the path for the Git binary that is invoked by certain Rush operations.
      */
-    RUSH_GIT_BINARY_PATH = "RUSH_GIT_BINARY_PATH",
+    readonly RUSH_GIT_BINARY_PATH: "RUSH_GIT_BINARY_PATH";
     /**
      * Explicitly specifies the path for the `tar` binary that is invoked by certain Rush operations.
      */
-    RUSH_TAR_BINARY_PATH = "RUSH_TAR_BINARY_PATH",
+    readonly 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",
+    readonly 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
@@ -142,8 +165,8 @@ export declare enum EnvironmentVariableNames {
      * The `RUSH_INVOKED_FOLDER` variable is the same idea as the `INIT_CWD` variable that package managers
      * assign when they execute lifecycle scripts.
      */
-    RUSH_INVOKED_FOLDER = "RUSH_INVOKED_FOLDER"
-}
+    readonly RUSH_INVOKED_FOLDER: "RUSH_INVOKED_FOLDER";
+};
 /**
  * Provides Rush-specific environment variable data. All Rush environment variables must start with "RUSH_". This class
  * is designed to be used by RushConfiguration.
@@ -164,6 +187,9 @@ export declare class EnvironmentConfiguration {
     private static _buildCacheCredential;
     private static _buildCacheEnabled;
     private static _buildCacheWriteAllowed;
+    private static _cobuildEnabled;
+    private static _cobuildContextId;
+    private static _cobuildLeafProjectLogOnlyAllowed;
     private static _gitBinaryPath;
     private static _tarBinaryPath;
     /**
@@ -219,6 +245,21 @@ export declare class EnvironmentConfiguration {
      * See {@link EnvironmentVariableNames.RUSH_BUILD_CACHE_WRITE_ALLOWED}
      */
     static get buildCacheWriteAllowed(): boolean | undefined;
+    /**
+     * If set, enables or disables the cobuild feature.
+     * See {@link EnvironmentVariableNames.RUSH_COBUILD_ENABLED}
+     */
+    static get cobuildEnabled(): boolean | undefined;
+    /**
+     * Provides a determined cobuild context id if configured
+     * See {@link EnvironmentVariableNames.RUSH_COBUILD_CONTEXT_ID}
+     */
+    static get cobuildContextId(): string | undefined;
+    /**
+     * If set, enables or disables the cobuild leaf project log only feature.
+     * See {@link EnvironmentVariableNames.RUSH_COBUILD_LEAF_PROJECT_LOG_ONLY_ALLOWED}
+     */
+    static get cobuildLeafProjectLogOnlyAllowed(): boolean | undefined;
     /**
      * Allows the git binary path to be explicitly provided.
      * See {@link EnvironmentVariableNames.RUSH_GIT_BINARY_PATH}

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/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>;