@rushstack/rush-sdk 5.134.0 → 5.135.0-pr4927.0

package/dist/rush-lib.d.ts

@@ -17,6 +17,7 @@ import { IPackageJson } from '@rushstack/node-core-library';
 import { IPrefixMatch } from '@rushstack/lookup-by-path';
 import { ITerminal } from '@rushstack/terminal';
 import { ITerminalProvider } from '@rushstack/terminal';
+import { JsonNull } from '@rushstack/node-core-library';
 import { JsonObject } from '@rushstack/node-core-library';
 import { LookupByPath } from '@rushstack/lookup-by-path';
 import { PackageNameParser } from '@rushstack/node-core-library';
@@ -256,6 +257,11 @@ export declare class CobuildConfiguration {
      * to improve the performance in CI validations and the leaf projects have not enabled cache.
      */
     readonly cobuildLeafProjectLogOnlyAllowed: boolean;
+    /**
+     * If true, operations can opt into leveraging cobuilds without restoring from the build cache.
+     *  Operations will need to us the allowCobuildWithoutCache flag to opt into this behavior per phase.
+     */
+    readonly cobuildWithoutCacheAllowed: boolean;
     private _cobuildLockProvider;
     private readonly _cobuildLockProviderFactory;
     private readonly _cobuildJson;
@@ -338,7 +344,7 @@ export declare class CommonVersionsConfiguration {
      * Loads the common-versions.json data from the specified file path.
      * If the file has not been created yet, then an empty object is returned.
      */
-    static loadFromFile(jsonFilename: string, rushConfiguration?: RushConfiguration): CommonVersionsConfiguration;
+    static loadFromFile(jsonFilePath: string, rushConfiguration?: RushConfiguration): CommonVersionsConfiguration;
     private static _deserializeTable;
     private static _serializeTable;
     /**
@@ -678,6 +684,13 @@ export declare const EnvironmentVariableNames: {
      * or `0` to disallow them. (See the comments in the command-line.json file for more information).
      */
     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/
+     */
+    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".
@@ -1231,6 +1244,13 @@ export declare interface ICredentialCacheOptions {
     supportEditing: boolean;
 }
 
+/**
+ * This represents the JSON data structure for the "current-variant.json" data file.
+ */
+declare interface ICurrentVariantJson {
+    variant: string | JsonNull;
+}
+
 /**
  * Metadata for a custom tip.
  *
@@ -1428,6 +1448,12 @@ export declare interface IExperimentsJson {
      * ignore normal discussion group messages or don't know to subscribe.
      */
     rushAlerts?: boolean;
+    /**
+     * Allow cobuilds without using the build cache to store previous execution info. When setting up
+     *  distributed builds, Rush will allow uncacheable projects to still leverage the cobuild feature.
+     * This is useful when you want to speed up operations that can't (or shouldn't) be cached.
+     */
+    allowCobuildWithoutCache?: boolean;
 }
 
 /**
@@ -1543,6 +1569,38 @@ declare interface ILockStepVersionJson extends IVersionPolicyJson {
     mainProject?: string;
 }
 
+/**
+ * Information about the log files for an operation.
+ *
+ * @alpha
+ */
+export declare interface ILogFilePaths {
+    /**
+     * The absolute path to the folder containing the text log files.
+     * Provided as a convenience since it is an intermediary value of producing the text log file path.
+     */
+    textFolder: string;
+    /**
+     * The absolute path to the folder containing the JSONL log files.
+     * Provided as a convenience since it is an intermediary value of producing the jsonl log file path.
+     */
+    jsonlFolder: string;
+    /**
+     * The absolute path to the merged (interleaved stdout and stderr) text log.
+     * ANSI escape codes have been stripped.
+     */
+    text: string;
+    /**
+     * The absolute path to the stderr text log.
+     * ANSI escape codes have been stripped.
+     */
+    error: string;
+    /**
+     * The absolute path to the JSONL log. ANSI escape codes are left intact to be able to reproduce the console output.
+     */
+    jsonl: string;
+}
+
 /**
  * @beta
  */
@@ -1645,6 +1703,10 @@ export declare interface IOperationExecutionResult {
      * The id of the runner which actually runs the building process in cobuild mode.
      */
     readonly cobuildRunnerId: string | undefined;
+    /**
+     * The paths to the log files, if applicable.
+     */
+    readonly logFilePaths: ILogFilePaths | undefined;
 }
 
 /**
@@ -1849,6 +1911,10 @@ export declare interface IOperationSettings {
      *  determined by the -p flag.
      */
     weight?: number;
+    /**
+     * If true, this operation can use cobuilds for orchestration without restoring build cache entries.
+     */
+    allowCobuildWithoutCache?: boolean;
 }
 
 /**
@@ -2163,7 +2229,7 @@ declare interface IRushConfigurationJson {
     pnpmOptions?: _IPnpmOptionsJson;
     yarnOptions?: _IYarnOptionsJson;
     ensureConsistentVersions?: boolean;
-    variants?: unknown;
+    variants?: IRushVariantOptionsJson[];
 }
 
 /**
@@ -2241,15 +2307,9 @@ export declare interface IRushPhaseSharding {
      */
     outputFolderArgumentFormat?: string;
     /**
-     * Configuration for the shard operation. All other configuration applies to the collator operation.
+     * @deprecated Create a separate operation settings object for the shard operation settings with the name `{operationName}:shard`.
      */
-    shardOperationSettings?: {
-        /**
-         * How many concurrency units this operation should take up during execution. The maximum concurrent units is
-         *  determined by the -p flag.
-         */
-        weight?: number;
-    };
+    shardOperationSettings?: unknown;
 }
 
 /**
@@ -2347,6 +2407,14 @@ export declare interface IRushSessionOptions {
     getIsDebugMode: () => boolean;
 }
 
+/**
+ * Options defining an allowed variant as part of IRushConfigurationJson.
+ */
+declare interface IRushVariantOptionsJson {
+    variantName: string;
+    description: string;
+}
+
 /**
  * Represents a readonly view of a `Stopwatch`.
  * @beta
@@ -3318,7 +3386,7 @@ export declare class RepoStateFile {
      *
      * @returns true if the file was modified, otherwise false.
      */
-    refreshState(rushConfiguration: RushConfiguration, subspace: Subspace | undefined): boolean;
+    refreshState(rushConfiguration: RushConfiguration, subspace: Subspace | undefined, variant?: string): boolean;
     /**
      * Writes the "repo-state.json" file to disk, using the filename that was passed to loadFromFile().
      */
@@ -3404,6 +3472,10 @@ export declare class RushCommandLine {
 export declare class RushConfiguration {
     private static _jsonSchema;
     private readonly _pathTrees;
+    /**
+     * @internal
+     */
+    _currentVariantJsonLoadingPromise: Promise<ICurrentVariantJson | undefined> | undefined;
     private _projects;
     private _projectsByName;
     private _projectsByTag;
@@ -3508,12 +3580,13 @@ export declare class RushConfiguration {
      */
     readonly subspacesFeatureEnabled: boolean;
     /**
-     * If true, the `variants` field is present in rush.json.
+     * The filename of the variant dependency data file.  By default this is
+     * called 'current-variant.json' resides in the Rush common folder.
+     * Its data structure is defined by ICurrentVariantJson.
      *
-     * @internal
-     * @deprecated - Remove when the field is removed from the rush.json schema.
+     * Example: `C:\MyRepo\common\temp\current-variant.json`
      */
-    readonly _hasVariantsField: boolean;
+    readonly currentVariantJsonFilePath: string;
     /**
      * The version of the locally package manager tool.  (Example: "1.2.3")
      */
@@ -3699,6 +3772,12 @@ export declare class RushConfiguration {
      * @internal
      */
     readonly _rushPluginsConfiguration: RushPluginsConfiguration;
+    /**
+     * The variants specified in the rush.json configuration file.
+     *
+     * @beta
+     */
+    readonly variants: ReadonlySet<string>;
     /**
      * Use RushConfiguration.loadFromConfigurationFile() or Use RushConfiguration.loadFromDefaultLocation()
      * instead.
@@ -3825,23 +3904,34 @@ export declare class RushConfiguration {
      * Instead it will be initialized in an empty state, and calling CommonVersionsConfiguration.save()
      * will create the file.
      *
-     * @deprecated Use `getCommonVersions` instead, which gets the correct common version data.
+     * @deprecated Use `getCommonVersions` instead, which gets the correct common version data
+     * for a given active variant.
      */
     get commonVersions(): CommonVersionsConfiguration;
+    /**
+     * Gets the currently-installed variant, if an installation has occurred.
+     * For Rush operations which do not take a --variant parameter, this method
+     * determines which variant, if any, was last specified when performing "rush install"
+     * or "rush update".
+     */
+    getCurrentlyInstalledVariantAsync(): Promise<string | undefined>;
     /**
      * @deprecated Use {@link Subspace.getCommonVersionsFilePath} instead
      */
-    getCommonVersionsFilePath(subspace?: Subspace): string;
+    getCommonVersionsFilePath(subspace?: Subspace, variant?: string): string;
     /**
      * @deprecated Use {@link Subspace.getCommonVersions} instead
      */
-    getCommonVersions(subspace?: Subspace): CommonVersionsConfiguration;
+    getCommonVersions(subspace?: Subspace, variant?: string): CommonVersionsConfiguration;
     /**
      * Returns a map of all direct dependencies that only have a single semantic version specifier.
      *
+     * @param subspace - The subspace to use
+     * @param variant - The name of the current variant in use by the active command.
+     *
      * @returns A map of dependency name --\> version specifier for implicitly preferred versions.
      */
-    getImplicitlyPreferredVersions(subspace?: Subspace): Map<string, string>;
+    getImplicitlyPreferredVersions(subspace?: Subspace, variant?: string): Map<string, string>;
     /**
      * @deprecated Use {@link Subspace.getRepoStateFilePath} instead
      */
@@ -3851,11 +3941,11 @@ export declare class RushConfiguration {
      */
     getRepoState(subspace?: Subspace): RepoStateFile;
     /**
-     * @deprecated Use {@link Subspace.getCommittedShrinkwrapFilename} instead
+     * @deprecated Use {@link Subspace.getCommittedShrinkwrapFilePath} instead
      */
-    getCommittedShrinkwrapFilename(subspace?: Subspace): string;
+    getCommittedShrinkwrapFilename(subspace?: Subspace, variant?: string): string;
     /**
-     * @deprecated Use {@link Subspace.getRepoStateFilePath} instead
+     * @deprecated Use {@link Subspace.getPnpmfilePath} instead
      */
     getPnpmfilePath(subspace?: Subspace): string;
     /**
@@ -3885,6 +3975,7 @@ export declare class RushConfiguration {
      * If the path is not under any project's folder, returns undefined.
      */
     tryGetProjectForPath(currentFolderPath: string): RushConfigurationProject | undefined;
+    private _loadCurrentVariantJsonAsync;
 }
 
 /**
@@ -4120,6 +4211,12 @@ export declare class RushConstants {
      * The NPM scope ("\@rush-temp") that is used for Rush's temporary projects.
      */
     static readonly rushTempNpmScope: '@rush-temp';
+    /**
+     * The folder name ("variants") under which named variant configurations for
+     * alternate dependency sets may be found.
+     * Example: `C:\MyRepo\common\config\rush\variants`
+     */
+    static readonly rushVariantsFolderName: 'variants';
     /**
      * The folder name ("temp") under the common folder, or under the .rush folder in each project's directory where
      * temporary files will be stored.
@@ -4425,11 +4522,11 @@ export declare class RushLifecycleHooks {
     /**
      * The hook to run between preparing the common/temp folder and invoking the package manager during "rush install" or "rush update".
      */
-    readonly beforeInstall: AsyncSeriesHook<[IGlobalCommand, Subspace]>;
+    readonly beforeInstall: AsyncSeriesHook<[IGlobalCommand, Subspace, string | undefined]>;
     /**
      * The hook to run after a successful install.
      */
-    readonly afterInstall: AsyncSeriesHook<[IRushCommand, Subspace]>;
+    readonly afterInstall: AsyncSeriesHook<[IRushCommand, Subspace, string | undefined]>;
     /**
      * A hook to allow plugins to hook custom logic to process telemetry data.
      */
@@ -4568,6 +4665,20 @@ export declare class Subspace {
      */
     getPnpmOptions(): PnpmOptionsConfiguration | undefined;
     private _ensureDetail;
+    /**
+     * Returns the full path of the folder containing this subspace's variant-dependent configuration files
+     * such as `pnpm-lock.yaml`.
+     *
+     * Example: `common/config/subspaces/my-subspace` or `common/config/subspaces/my-subspace/variants/my-variant`
+     * @beta
+     *
+     * @remarks
+     * The following files may be variant-dependent:
+     * - Lockfiles: (i.e. - `pnpm-lock.yaml`, `npm-shrinkwrap.json`, `yarn.lock`, etc)
+     * - 'common-versions.json'
+     * - 'pnpmfile.js'/'.pnpmfile.cjs'
+     */
+    getVariantDependentSubspaceConfigFolderPath(variant: string | undefined): string;
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
@@ -4602,6 +4713,10 @@ export declare class Subspace {
      * @beta
      */
     getTempShrinkwrapFilename(): string;
+    /**
+     * @deprecated - Use {@link Subspace.getTempShrinkwrapPreinstallFilePath} instead.
+     */
+    getTempShrinkwrapPreinstallFilename(subspaceName?: string | undefined): string;
     /**
      * The full path of a backup copy of tempShrinkwrapFilename. This backup copy is made
      * before installation begins, and can be compared to determine how the package manager
@@ -4612,14 +4727,14 @@ export declare class Subspace {
      * or `C:\MyRepo\common\temp\pnpm-lock-preinstall.yaml`
      * @beta
      */
-    getTempShrinkwrapPreinstallFilename(subspaceName?: string | undefined): string;
+    getTempShrinkwrapPreinstallFilePath(): string;
     /**
      * Gets the path to the common-versions.json config file for this subspace.
      *
      * Example: `C:\MyRepo\common\subspaces\my-subspace\common-versions.json`
      * @beta
      */
-    getCommonVersionsFilePath(): string;
+    getCommonVersionsFilePath(variant?: string): string;
     /**
      * Gets the path to the pnpm-config.json config file for this subspace.
      *
@@ -4631,13 +4746,13 @@ export declare class Subspace {
      * Gets the settings from the common-versions.json config file.
      * @beta
      */
-    getCommonVersions(): CommonVersionsConfiguration;
+    getCommonVersions(variant?: string): CommonVersionsConfiguration;
     /**
      * Gets the ensureConsistentVersions property from the common-versions.json config file,
      * or from the rush.json file if it isn't defined in common-versions.json
      * @beta
      */
-    get shouldEnsureConsistentVersions(): boolean;
+    shouldEnsureConsistentVersions(variant?: string): boolean;
     /**
      * Gets the path to the repo-state.json file.
      * @beta
@@ -4650,10 +4765,15 @@ export declare class Subspace {
      */
     getRepoState(): RepoStateFile;
     /**
-     * Gets the committed shrinkwrap file name.
-     * @beta
+     * @deprecated - Use {@link Subspace.getCommittedShrinkwrapFilePath} instead.
      */
     getCommittedShrinkwrapFilename(): string;
+    /**
+     * Gets the committed shrinkwrap file name for a specific variant.
+     * @param variant - The name of the current variant in use by the active command.
+     * @beta
+     */
+    getCommittedShrinkwrapFilePath(variant?: string): string;
     /**
      * Gets the absolute path for "pnpmfile.js" for a specific subspace.
      * @param subspace - The name of the current subspace in use by the active command.
@@ -4673,7 +4793,7 @@ export declare class Subspace {
      * Returns hash value of injected dependencies in related package.json.
      * @beta
      */
-    getPackageJsonInjectedDependenciesHash(): string | undefined;
+    getPackageJsonInjectedDependenciesHash(variant?: string): string | undefined;
 }
 
 /**

package/lib/api/CobuildConfiguration.d.ts

@@ -53,6 +53,11 @@ export declare class CobuildConfiguration {
      * to improve the performance in CI validations and the leaf projects have not enabled cache.
      */
     readonly cobuildLeafProjectLogOnlyAllowed: boolean;
+    /**
+     * If true, operations can opt into leveraging cobuilds without restoring from the build cache.
+     *  Operations will need to us the allowCobuildWithoutCache flag to opt into this behavior per phase.
+     */
+    readonly cobuildWithoutCacheAllowed: boolean;
     private _cobuildLockProvider;
     private readonly _cobuildLockProviderFactory;
     private readonly _cobuildJson;

package/lib/api/CommonVersionsConfiguration.d.ts

@@ -80,7 +80,7 @@ export declare class CommonVersionsConfiguration {
      * Loads the common-versions.json data from the specified file path.
      * If the file has not been created yet, then an empty object is returned.
      */
-    static loadFromFile(jsonFilename: string, rushConfiguration?: RushConfiguration): CommonVersionsConfiguration;
+    static loadFromFile(jsonFilePath: string, rushConfiguration?: RushConfiguration): CommonVersionsConfiguration;
     private static _deserializeTable;
     private static _serializeTable;
     /**

package/lib/api/EnvironmentConfiguration.d.ts

@@ -36,6 +36,13 @@ export declare const EnvironmentVariableNames: {
      * or `0` to disallow them. (See the comments in the command-line.json file for more information).
      */
     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/
+     */
+    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".

package/lib/api/ExperimentsConfiguration.d.ts

@@ -83,6 +83,12 @@ export interface IExperimentsJson {
      * ignore normal discussion group messages or don't know to subscribe.
      */
     rushAlerts?: boolean;
+    /**
+     * Allow cobuilds without using the build cache to store previous execution info. When setting up
+     *  distributed builds, Rush will allow uncacheable projects to still leverage the cobuild feature.
+     * This is useful when you want to speed up operations that can't (or shouldn't) be cached.
+     */
+    allowCobuildWithoutCache?: boolean;
 }
 /**
  * Use this class to load the "common/config/rush/experiments.json" config file.

package/lib/api/RushConfiguration.d.ts

@@ -1,4 +1,4 @@
-import { type PackageNameParser } from '@rushstack/node-core-library';
+import { type PackageNameParser, type JsonNull } from '@rushstack/node-core-library';
 import { LookupByPath } from '@rushstack/lookup-by-path';
 import { RushConfigurationProject, type IRushConfigurationProjectJson } from './RushConfigurationProject';
 import { ApprovedPackagesPolicy } from './ApprovedPackagesPolicy';
@@ -77,6 +77,13 @@ export interface IRushRepositoryJsonMultipleUrls extends IRushRepositoryJsonBase
     urls?: string[];
 }
 export type IRushRepositoryJson = IRushRepositoryJsonSingleUrl | IRushRepositoryJsonMultipleUrls;
+/**
+ * Options defining an allowed variant as part of IRushConfigurationJson.
+ */
+export interface IRushVariantOptionsJson {
+    variantName: string;
+    description: string;
+}
 /**
  * This represents the JSON data structure for the "rush.json" configuration file.
  * See rush.schema.json for documentation.
@@ -106,7 +113,13 @@ export interface IRushConfigurationJson {
     pnpmOptions?: IPnpmOptionsJson;
     yarnOptions?: IYarnOptionsJson;
     ensureConsistentVersions?: boolean;
-    variants?: unknown;
+    variants?: IRushVariantOptionsJson[];
+}
+/**
+ * This represents the JSON data structure for the "current-variant.json" data file.
+ */
+export interface ICurrentVariantJson {
+    variant: string | JsonNull;
 }
 /**
  * The filter parameters to search from all projects
@@ -139,6 +152,10 @@ export interface ITryFindRushJsonLocationOptions {
 export declare class RushConfiguration {
     private static _jsonSchema;
     private readonly _pathTrees;
+    /**
+     * @internal
+     */
+    _currentVariantJsonLoadingPromise: Promise<ICurrentVariantJson | undefined> | undefined;
     private _projects;
     private _projectsByName;
     private _projectsByTag;
@@ -243,12 +260,13 @@ export declare class RushConfiguration {
      */
     readonly subspacesFeatureEnabled: boolean;
     /**
-     * If true, the `variants` field is present in rush.json.
+     * The filename of the variant dependency data file.  By default this is
+     * called 'current-variant.json' resides in the Rush common folder.
+     * Its data structure is defined by ICurrentVariantJson.
      *
-     * @internal
-     * @deprecated - Remove when the field is removed from the rush.json schema.
+     * Example: `C:\MyRepo\common\temp\current-variant.json`
      */
-    readonly _hasVariantsField: boolean;
+    readonly currentVariantJsonFilePath: string;
     /**
      * The version of the locally package manager tool.  (Example: "1.2.3")
      */
@@ -434,6 +452,12 @@ export declare class RushConfiguration {
      * @internal
      */
     readonly _rushPluginsConfiguration: RushPluginsConfiguration;
+    /**
+     * The variants specified in the rush.json configuration file.
+     *
+     * @beta
+     */
+    readonly variants: ReadonlySet<string>;
     /**
      * Use RushConfiguration.loadFromConfigurationFile() or Use RushConfiguration.loadFromDefaultLocation()
      * instead.
@@ -560,23 +584,34 @@ export declare class RushConfiguration {
      * Instead it will be initialized in an empty state, and calling CommonVersionsConfiguration.save()
      * will create the file.
      *
-     * @deprecated Use `getCommonVersions` instead, which gets the correct common version data.
+     * @deprecated Use `getCommonVersions` instead, which gets the correct common version data
+     * for a given active variant.
      */
     get commonVersions(): CommonVersionsConfiguration;
+    /**
+     * Gets the currently-installed variant, if an installation has occurred.
+     * For Rush operations which do not take a --variant parameter, this method
+     * determines which variant, if any, was last specified when performing "rush install"
+     * or "rush update".
+     */
+    getCurrentlyInstalledVariantAsync(): Promise<string | undefined>;
     /**
      * @deprecated Use {@link Subspace.getCommonVersionsFilePath} instead
      */
-    getCommonVersionsFilePath(subspace?: Subspace): string;
+    getCommonVersionsFilePath(subspace?: Subspace, variant?: string): string;
     /**
      * @deprecated Use {@link Subspace.getCommonVersions} instead
      */
-    getCommonVersions(subspace?: Subspace): CommonVersionsConfiguration;
+    getCommonVersions(subspace?: Subspace, variant?: string): CommonVersionsConfiguration;
     /**
      * Returns a map of all direct dependencies that only have a single semantic version specifier.
      *
+     * @param subspace - The subspace to use
+     * @param variant - The name of the current variant in use by the active command.
+     *
      * @returns A map of dependency name --\> version specifier for implicitly preferred versions.
      */
-    getImplicitlyPreferredVersions(subspace?: Subspace): Map<string, string>;
+    getImplicitlyPreferredVersions(subspace?: Subspace, variant?: string): Map<string, string>;
     /**
      * @deprecated Use {@link Subspace.getRepoStateFilePath} instead
      */
@@ -586,11 +621,11 @@ export declare class RushConfiguration {
      */
     getRepoState(subspace?: Subspace): RepoStateFile;
     /**
-     * @deprecated Use {@link Subspace.getCommittedShrinkwrapFilename} instead
+     * @deprecated Use {@link Subspace.getCommittedShrinkwrapFilePath} instead
      */
-    getCommittedShrinkwrapFilename(subspace?: Subspace): string;
+    getCommittedShrinkwrapFilename(subspace?: Subspace, variant?: string): string;
     /**
-     * @deprecated Use {@link Subspace.getRepoStateFilePath} instead
+     * @deprecated Use {@link Subspace.getPnpmfilePath} instead
      */
     getPnpmfilePath(subspace?: Subspace): string;
     /**
@@ -620,5 +655,6 @@ export declare class RushConfiguration {
      * If the path is not under any project's folder, returns undefined.
      */
     tryGetProjectForPath(currentFolderPath: string): RushConfigurationProject | undefined;
+    private _loadCurrentVariantJsonAsync;
 }
 //# sourceMappingURL=RushConfiguration.d.ts.map

package/lib/api/RushProjectConfiguration.d.ts

@@ -47,15 +47,9 @@ export interface IRushPhaseSharding {
      */
     outputFolderArgumentFormat?: string;
     /**
-     * Configuration for the shard operation. All other configuration applies to the collator operation.
-     */
-    shardOperationSettings?: {
-        /**
-         * How many concurrency units this operation should take up during execution. The maximum concurrent units is
-         *  determined by the -p flag.
-         */
-        weight?: number;
-    };
+     * @deprecated Create a separate operation settings object for the shard operation settings with the name `{operationName}:shard`.
+     */
+    shardOperationSettings?: unknown;
 }
 /**
  * @alpha
@@ -115,6 +109,10 @@ export interface IOperationSettings {
      *  determined by the -p flag.
      */
     weight?: number;
+    /**
+     * If true, this operation can use cobuilds for orchestration without restoring build cache entries.
+     */
+    allowCobuildWithoutCache?: boolean;
 }
 /**
  * Use this class to load the "config/rush-project.json" config file.