@rushstack/rush-sdk 5.116.0 → 5.117.0

package/dist/rush-lib.d.ts

@@ -660,13 +660,6 @@ 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".
@@ -2006,7 +1999,7 @@ declare interface IRushConfigurationJson {
     pnpmOptions?: _IPnpmOptionsJson;
     yarnOptions?: _IYarnOptionsJson;
     ensureConsistentVersions?: boolean;
-    variants?: IRushVariantOptionsJson[];
+    variants?: unknown;
 }
 
 /**
@@ -2159,14 +2152,6 @@ 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
@@ -3239,7 +3224,6 @@ export declare class RepoStateFile {
      * If the file has not been created yet, then an empty object is returned.
      *
      * @param jsonFilename - The path to the repo-state.json file.
-     * @param variant - The variant currently being used by Rush.
      */
     static loadFromFile(jsonFilename: string): RepoStateFile;
     /**
@@ -3328,12 +3312,10 @@ export declare class Rush {
  */
 export declare class RushConfiguration {
     private static _jsonSchema;
-    private _variants;
     private readonly _pathTrees;
     private _projects;
     private _projectsByName;
     private _projectsByTag;
-    private _commonVersionsConfigurationsByVariant;
     private readonly _subspacesByName;
     private readonly _subspaces;
     /**
@@ -3435,13 +3417,12 @@ export declare class RushConfiguration {
      */
     readonly subspacesFeatureEnabled: boolean;
     /**
-     * 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.
+     * If true, the `variants` field is present in rush.json.
      *
-     * Example: `C:\MyRepo\common\temp\current-variant.json`
+     * @internal
+     * @deprecated - Remove when the field is removed from the rush.json schema.
      */
-    readonly currentVariantJsonFilename: string;
+    readonly _hasVariantsField: boolean;
     /**
      * The version of the locally package manager tool.  (Example: "1.2.3")
      */
@@ -3743,17 +3724,9 @@ 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
-     * for a given active variant.
+     * @deprecated Use `getCommonVersions` instead, which gets the correct common version data.
      */
     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".
-     */
-    get currentInstalledVariant(): string | undefined;
     /**
      * @deprecated Use {@link Subspace.getCommonVersionsFilePath} instead
      */
@@ -3764,11 +3737,10 @@ export declare class RushConfiguration {
     getCommonVersions(subspace?: Subspace): CommonVersionsConfiguration;
     /**
      * Returns a map of all direct dependencies that only have a single semantic version specifier.
-     * @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(variant?: string | undefined): Map<string, string>;
+    getImplicitlyPreferredVersions(): Map<string, string>;
     /**
      * @deprecated Use {@link Subspace.getRepoStateFilePath} instead
      */
@@ -4015,6 +3987,10 @@ export declare class RushConfigurationProject {
  * the Rush config files; instead, they should rely on the official APIs from rush-lib.
  */
 export declare class RushConstants {
+    /**
+     * The filename ("rush.json") for the root-level configuration file.
+     */
+    static readonly rushJsonFilename: 'rush.json';
     /**
      * The filename ("browser-approved-packages.json") for an optional policy configuration file
      * that stores a list of NPM packages that have been approved for usage by Rush projects.
@@ -4022,11 +3998,11 @@ export declare class RushConstants {
      * (e.g. whose approval criteria mostly focuses on licensing and code size), and one for everywhere else
      * (e.g. tooling projects whose approval criteria mostly focuses on avoiding node_modules sprawl).
      */
-    static readonly browserApprovedPackagesFilename: string;
+    static readonly browserApprovedPackagesFilename: 'browser-approved-packages.json';
     /**
      * The folder name ("changes") where change files will be stored.
      */
-    static readonly changeFilesFolderName: string;
+    static readonly changeFilesFolderName: 'changes';
     /**
      * The filename ("nonbrowser-approved-packages.json") for an optional policy configuration file
      * that stores a list of NPM packages that have been approved for usage by Rush projects.
@@ -4034,76 +4010,70 @@ export declare class RushConstants {
      * (e.g. whose approval criteria mostly focuses on licensing and code size), and one for everywhere else
      * (e.g. tooling projects whose approval criteria mostly focuses on avoiding node_modules sprawl).
      */
-    static readonly nonbrowserApprovedPackagesFilename: string;
+    static readonly nonbrowserApprovedPackagesFilename: 'nonbrowser-approved-packages.json';
     /**
      * The folder name ("common") where Rush's common data will be stored.
      */
-    static readonly commonFolderName: string;
+    static readonly commonFolderName: 'common';
     /**
      * The NPM scope ("\@rush-temp") that is used for Rush's temporary projects.
      */
-    static readonly rushTempNpmScope: string;
+    static readonly rushTempNpmScope: '@rush-temp';
     /**
      * The folder name ("temp") 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`
      */
-    static readonly rushTempFolderName: string;
+    static readonly rushTempFolderName: 'temp';
     /**
      * The folder name ("projects") where temporary projects will be stored.
      * Example: `C:\MyRepo\common\temp\projects`
      */
-    static readonly rushTempProjectsFolderName: string;
-    /**
-     * 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: string;
+    static readonly rushTempProjectsFolderName: 'projects';
     /**
      * The filename ("npm-shrinkwrap.json") used to store an installation plan for the NPM package manger.
      */
-    static readonly npmShrinkwrapFilename: string;
+    static readonly npmShrinkwrapFilename: 'npm-shrinkwrap.json';
     /**
      * Number of installation attempts
      */
-    static readonly defaultMaxInstallAttempts: number;
+    static readonly defaultMaxInstallAttempts: 1;
     /**
      * The filename ("pnpm-lock.yaml") used to store an installation plan for the PNPM package manger
      * (PNPM version 3.x and later).
      */
-    static readonly pnpmV3ShrinkwrapFilename: string;
+    static readonly pnpmV3ShrinkwrapFilename: 'pnpm-lock.yaml';
     /**
      * The filename ("pnpmfile.js") used to add custom configuration to PNPM (PNPM version 1.x and later).
      */
-    static readonly pnpmfileV1Filename: string;
+    static readonly pnpmfileV1Filename: 'pnpmfile.js';
     /**
      * The filename (".pnpmfile.cjs") used to add custom configuration to PNPM (PNPM version 6.x and later).
      */
-    static readonly pnpmfileV6Filename: string;
+    static readonly pnpmfileV6Filename: '.pnpmfile.cjs';
     /**
      * The filename ("global-pnpmfile.cjs") used to add custom configuration to subspaces
      */
-    static readonly pnpmfileGlobalFilename: string;
+    static readonly pnpmfileGlobalFilename: 'global-pnpmfile.cjs';
     /**
      * The folder name used to store patch files for pnpm
      * Example: `C:\MyRepo\common\config\pnpm-patches`
      * Example: `C:\MyRepo\common\temp\patches`
      */
-    static readonly pnpmPatchesFolderName: string;
+    static readonly pnpmPatchesFolderName: 'patches';
     /**
      * The folder name under `/common/temp` used to store checked-in patches.
      * Example: `C:\MyRepo\common\pnpm-patches`
      */
-    static readonly pnpmPatchesCommonFolderName: string;
+    static readonly pnpmPatchesCommonFolderName: `pnpm-patches`;
     /**
      * The filename ("shrinkwrap.yaml") used to store state for pnpm
      */
-    static readonly yarnShrinkwrapFilename: string;
+    static readonly yarnShrinkwrapFilename: 'yarn.lock';
     /**
      * The folder name ("node_modules") where NPM installs its packages.
      */
-    static readonly nodeModulesFolderName: string;
+    static readonly nodeModulesFolderName: 'node_modules';
     /**
      * The filename ("pinned-versions.json") for an old configuration file that
      * that is no longer supported.
@@ -4111,98 +4081,98 @@ export declare class RushConstants {
      * @deprecated This feature has been superseded by the "preferredVersions" setting
      * in common-versions.json
      */
-    static readonly pinnedVersionsFilename: string;
+    static readonly pinnedVersionsFilename: 'pinned-versions.json';
     /**
      * The filename ("common-versions.json") for an optional configuration file
      * that stores dependency version information that affects all projects in the repo.
      * This configuration file should go in the "common/config/rush" folder.
      */
-    static readonly commonVersionsFilename: string;
+    static readonly commonVersionsFilename: 'common-versions.json';
     /**
      * The filename ("repo-state.json") for a file used by Rush to
      * store the state of various features as they stand in the repo.
      */
-    static readonly repoStateFilename: string;
+    static readonly repoStateFilename: 'repo-state.json';
     /**
      * The filename ("custom-tips.json") for the file used by Rush to
      * print user-customized messages.
      * This configuration file should go in the "common/config/rush" folder.
      */
-    static readonly customTipsFilename: string;
+    static readonly customTipsFilename: 'custom-tips.json';
     /**
      * The name of the per-project folder where project-specific Rush files are stored. For example,
      * the package-deps files, which are used by commands to determine if a particular project needs to be rebuilt.
      */
-    static readonly projectRushFolderName: string;
+    static readonly projectRushFolderName: '.rush';
     /**
      * Custom command line configuration file, which is used by rush for implementing
      * custom command and options.
      */
-    static readonly commandLineFilename: string;
-    static readonly versionPoliciesFilename: string;
+    static readonly commandLineFilename: 'command-line.json';
+    static readonly versionPoliciesFilename: 'version-policies.json';
     /**
      * Experiments configuration file.
      */
-    static readonly experimentsFilename: string;
+    static readonly experimentsFilename: 'experiments.json';
     /**
      * Pnpm configuration file
      */
-    static readonly pnpmConfigFilename: string;
+    static readonly pnpmConfigFilename: 'pnpm-config.json';
     /**
      * Rush plugins configuration file name.
      */
-    static readonly rushPluginsConfigFilename: string;
+    static readonly rushPluginsConfigFilename: 'rush-plugins.json';
     /**
      * Rush plugin manifest file name.
      */
-    static readonly rushPluginManifestFilename: string;
+    static readonly rushPluginManifestFilename: 'rush-plugin-manifest.json';
     /**
      * The artifactory.json configuration file name.
      */
-    static readonly artifactoryFilename: string;
+    static readonly artifactoryFilename: 'artifactory.json';
     /**
      * The subspaces.json configuration file name
      */
-    static readonly subspacesConfigFilename: string;
+    static readonly subspacesConfigFilename: 'subspaces.json';
     /**
      * The name of the default subspace if one isn't specified but subspaces is enabled.
      */
-    static readonly defaultSubspaceName: string;
+    static readonly defaultSubspaceName: 'default';
     /**
      * Build cache configuration file.
      */
-    static readonly buildCacheFilename: string;
+    static readonly buildCacheFilename: 'build-cache.json';
     /**
      * Build cache version number, incremented when the logic to create cache entries changes.
      * Changing this ensures that cache entries generated by an old version will no longer register as a cache hit.
      */
-    static readonly buildCacheVersion: number;
+    static readonly buildCacheVersion: 1;
     /**
      * Cobuild configuration file.
      */
-    static readonly cobuildFilename: string;
+    static readonly cobuildFilename: 'cobuild.json';
     /**
      * Per-project configuration filename.
      */
-    static readonly rushProjectConfigFilename: string;
+    static readonly rushProjectConfigFilename: 'rush-project.json';
     /**
      * The URL ("http://rushjs.io") for the Rush web site.
      */
-    static readonly rushWebSiteUrl: string;
+    static readonly rushWebSiteUrl: 'https://rushjs.io';
     /**
      * The name of the NPM package for the Rush tool ("\@microsoft/rush").
      */
-    static readonly rushPackageName: string;
+    static readonly rushPackageName: '@microsoft/rush';
     /**
      * The folder name ("rush-recycler") where Rush moves large folder trees
      * before asynchronously deleting them.
      */
-    static readonly rushRecyclerFolderName: string;
+    static readonly rushRecyclerFolderName: 'rush-recycler';
     /**
      * The name of the file to drop in project-folder/.rush/temp/ containing a listing of the project's direct
      * and indirect dependencies. This is used to detect if a project's dependencies have changed since the last build.
      */
-    static readonly projectShrinkwrapFilename: string;
+    static readonly projectShrinkwrapFilename: 'shrinkwrap-deps.json';
     /**
      * The value of the "commandKind" property for a bulk command in command-line.json
      */
@@ -4218,26 +4188,26 @@ export declare class RushConstants {
     /**
      * The name of the incremental build command.
      */
-    static readonly buildCommandName: string;
+    static readonly buildCommandName: 'build';
     /**
      * The name of the non-incremental build command.
      */
-    static readonly rebuildCommandName: string;
-    static readonly updateCloudCredentialsCommandName: string;
+    static readonly rebuildCommandName: 'rebuild';
+    static readonly updateCloudCredentialsCommandName: 'update-cloud-credentials';
     /**
      * When a hash generated that contains multiple input segments, this character may be used
      * to separate them to avoid issues like
      * crypto.createHash('sha1').update('a').update('bc').digest('hex') === crypto.createHash('sha1').update('ab').update('c').digest('hex')
      */
-    static readonly hashDelimiter: string;
+    static readonly hashDelimiter: '|';
     /**
      * The name of the per-user Rush configuration data folder.
      */
-    static readonly rushUserConfigurationFolderName: string;
+    static readonly rushUserConfigurationFolderName: '.rush-user';
     /**
      * The name of the project `rush-logs` folder.
      */
-    static readonly rushLogsFolderName: string;
+    static readonly rushLogsFolderName: 'rush-logs';
     /**
      * The expected prefix for phase names in "common/config/rush/command-line.json"
      */
@@ -4247,7 +4217,7 @@ export declare class RushConstants {
      * how long to wait after the last encountered file system event before execution. If another
      * file system event occurs in this interval, the timeout will reset.
      */
-    static readonly defaultWatchDebounceMs: number;
+    static readonly defaultWatchDebounceMs: 1000;
     /**
      * The name of the parameter that can be used to bypass policies.
      */
@@ -4255,11 +4225,11 @@ export declare class RushConstants {
     /**
      * Merge Queue ignore configuration file.
      */
-    static readonly mergeQueueIgnoreFileName: string;
+    static readonly mergeQueueIgnoreFileName: '.mergequeueignore';
     /**
      * The filename ("project-impact-graph.yaml") for the project impact graph file.
      */
-    static readonly projectImpactGraphFilename: string;
+    static readonly projectImpactGraphFilename: 'project-impact-graph.yaml';
 }
 
 /**
@@ -4504,27 +4474,23 @@ export declare class Subspace {
      */
     getCommonVersionsFilePath(): string;
     /**
-     * Gets the settings from the common-versions.json config file for a specific variant.
-     * @param variant - The name of the current variant in use by the active command.
+     * Gets the settings from the common-versions.json config file.
      * @beta
      */
     getCommonVersions(): CommonVersionsConfiguration;
     /**
-     * Gets the path to the repo-state.json file for a specific variant.
-     * @param variant - The name of the current variant in use by the active command.
+     * Gets the path to the repo-state.json file.
      * @beta
      */
     getRepoStateFilePath(): string;
     /**
-     * Gets the contents from the repo-state.json file for a specific variant.
+     * Gets the contents from the repo-state.json file.
      * @param subspaceName - The name of the subspace in use by the active command.
-     * @param variant - The name of the current variant in use by the active command.
      * @beta
      */
     getRepoState(): RepoStateFile;
     /**
-     * Gets the committed shrinkwrap file name for a specific variant.
-     * @param variant - The name of the current variant in use by the active command.
+     * Gets the committed shrinkwrap file name.
      * @beta
      */
     getCommittedShrinkwrapFilename(): string;

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.40.6"
+      "packageVersion": "7.41.0"
     }
   ]
 }

package/lib/api/EnvironmentConfiguration.d.ts

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

@@ -1,4 +1,4 @@
-import { type JsonNull, type PackageNameParser } from '@rushstack/node-core-library';
+import { type PackageNameParser } from '@rushstack/node-core-library';
 import { RushConfigurationProject, type IRushConfigurationProjectJson } from './RushConfigurationProject';
 import { ApprovedPackagesPolicy } from './ApprovedPackagesPolicy';
 import { EventHooks } from './EventHooks';
@@ -77,13 +77,6 @@ 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.
@@ -112,13 +105,7 @@ export interface IRushConfigurationJson {
     pnpmOptions?: IPnpmOptionsJson;
     yarnOptions?: IYarnOptionsJson;
     ensureConsistentVersions?: boolean;
-    variants?: IRushVariantOptionsJson[];
-}
-/**
- * This represents the JSON data structure for the "current-variant.json" data file.
- */
-export interface ICurrentVariantJson {
-    variant: string | JsonNull;
+    variants?: unknown;
 }
 /**
  * The filter parameters to search from all projects
@@ -150,12 +137,10 @@ export interface ITryFindRushJsonLocationOptions {
  */
 export declare class RushConfiguration {
     private static _jsonSchema;
-    private _variants;
     private readonly _pathTrees;
     private _projects;
     private _projectsByName;
     private _projectsByTag;
-    private _commonVersionsConfigurationsByVariant;
     private readonly _subspacesByName;
     private readonly _subspaces;
     /**
@@ -257,13 +242,12 @@ export declare class RushConfiguration {
      */
     readonly subspacesFeatureEnabled: boolean;
     /**
-     * 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.
+     * If true, the `variants` field is present in rush.json.
      *
-     * Example: `C:\MyRepo\common\temp\current-variant.json`
+     * @internal
+     * @deprecated - Remove when the field is removed from the rush.json schema.
      */
-    readonly currentVariantJsonFilename: string;
+    readonly _hasVariantsField: boolean;
     /**
      * The version of the locally package manager tool.  (Example: "1.2.3")
      */
@@ -565,17 +549,9 @@ 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
-     * for a given active variant.
+     * @deprecated Use `getCommonVersions` instead, which gets the correct common version data.
      */
     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".
-     */
-    get currentInstalledVariant(): string | undefined;
     /**
      * @deprecated Use {@link Subspace.getCommonVersionsFilePath} instead
      */
@@ -586,11 +562,10 @@ export declare class RushConfiguration {
     getCommonVersions(subspace?: Subspace): CommonVersionsConfiguration;
     /**
      * Returns a map of all direct dependencies that only have a single semantic version specifier.
-     * @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(variant?: string | undefined): Map<string, string>;
+    getImplicitlyPreferredVersions(): Map<string, string>;
     /**
      * @deprecated Use {@link Subspace.getRepoStateFilePath} instead
      */

package/lib/api/Subspace.d.ts

@@ -74,27 +74,23 @@ export declare class Subspace {
      */
     getCommonVersionsFilePath(): string;
     /**
-     * Gets the settings from the common-versions.json config file for a specific variant.
-     * @param variant - The name of the current variant in use by the active command.
+     * Gets the settings from the common-versions.json config file.
      * @beta
      */
     getCommonVersions(): CommonVersionsConfiguration;
     /**
-     * Gets the path to the repo-state.json file for a specific variant.
-     * @param variant - The name of the current variant in use by the active command.
+     * Gets the path to the repo-state.json file.
      * @beta
      */
     getRepoStateFilePath(): string;
     /**
-     * Gets the contents from the repo-state.json file for a specific variant.
+     * Gets the contents from the repo-state.json file.
      * @param subspaceName - The name of the subspace in use by the active command.
-     * @param variant - The name of the current variant in use by the active command.
      * @beta
      */
     getRepoState(): RepoStateFile;
     /**
-     * Gets the committed shrinkwrap file name for a specific variant.
-     * @param variant - The name of the current variant in use by the active command.
+     * Gets the committed shrinkwrap file name.
      * @beta
      */
     getCommittedShrinkwrapFilename(): string;

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

@@ -9,7 +9,6 @@ import type { Subspace } from '../../api/Subspace';
  */
 export declare abstract class BaseInstallAction extends BaseRushAction {
     protected readonly _terminal: ITerminal;
-    protected readonly _variant: CommandLineStringParameter;
     protected readonly _purgeParameter: CommandLineFlagParameter;
     protected readonly _bypassPolicyParameter: CommandLineFlagParameter;
     protected readonly _noLinkParameter: CommandLineFlagParameter;

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

@@ -2,7 +2,6 @@ import type { RushCommandLineParser } from '../RushCommandLineParser';
 import { BaseRushAction } from './BaseRushAction';
 export declare class CheckAction extends BaseRushAction {
     private readonly _terminal;
-    private readonly _variant;
     private readonly _jsonFlag;
     private readonly _verboseFlag;
     constructor(parser: RushCommandLineParser);

package/lib/logic/DependencyAnalyzer.d.ts

@@ -7,7 +7,7 @@ export interface IDependencyAnalysis {
     commonVersionsConfiguration: CommonVersionsConfiguration;
     /**
      * A map of all direct dependencies that only have a single semantic version specifier,
-     * unless the variant has the {@link CommonVersionsConfiguration.implicitlyPreferredVersions} option
+     * unless the {@link CommonVersionsConfiguration.implicitlyPreferredVersions} option
      * set to `false`.
      */
     implicitlyPreferredVersionByPackageName: Map<string, string>;
@@ -19,12 +19,12 @@ export interface IDependencyAnalysis {
 export declare class DependencyAnalyzer {
     private static _dependencyAnalyzerByRushConfiguration;
     private _rushConfiguration;
-    private _analysisByVariant;
+    private _analysis;
     private constructor();
     static forRushConfiguration(rushConfiguration: RushConfiguration): DependencyAnalyzer;
-    getAnalysis(variant?: string): IDependencyAnalysis;
+    getAnalysis(): IDependencyAnalysis;
     /**
-     * Generates the {@link IDependencyAnalysis} for a variant.
+     * Generates the {@link IDependencyAnalysis}.
      *
      * @remarks
      * The result of this function is not cached.

package/lib/logic/PackageJsonUpdaterTypes.d.ts

@@ -45,10 +45,6 @@ export interface IPackageJsonUpdaterRushBaseUpdateOptions {
      * actionName
      */
     actionName: string;
-    /**
-     * The variant to consider when performing installations and validating shrinkwrap updates.
-     */
-    variant?: string | undefined;
 }
 /**
  * Configuration options for adding or updating a dependency in a single project

package/lib/logic/RepoStateFile.d.ts

@@ -34,7 +34,6 @@ export declare class RepoStateFile {
      * If the file has not been created yet, then an empty object is returned.
      *
      * @param jsonFilename - The path to the repo-state.json file.
-     * @param variant - The variant currently being used by Rush.
      */
     static loadFromFile(jsonFilename: string): RepoStateFile;
     /**

package/lib/logic/RushConstants.d.ts

@@ -9,6 +9,10 @@
  * the Rush config files; instead, they should rely on the official APIs from rush-lib.
  */
 export declare class RushConstants {
+    /**
+     * The filename ("rush.json") for the root-level configuration file.
+     */
+    static readonly rushJsonFilename: 'rush.json';
     /**
      * The filename ("browser-approved-packages.json") for an optional policy configuration file
      * that stores a list of NPM packages that have been approved for usage by Rush projects.
@@ -16,11 +20,11 @@ export declare class RushConstants {
      * (e.g. whose approval criteria mostly focuses on licensing and code size), and one for everywhere else
      * (e.g. tooling projects whose approval criteria mostly focuses on avoiding node_modules sprawl).
      */
-    static readonly browserApprovedPackagesFilename: string;
+    static readonly browserApprovedPackagesFilename: 'browser-approved-packages.json';
     /**
      * The folder name ("changes") where change files will be stored.
      */
-    static readonly changeFilesFolderName: string;
+    static readonly changeFilesFolderName: 'changes';
     /**
      * The filename ("nonbrowser-approved-packages.json") for an optional policy configuration file
      * that stores a list of NPM packages that have been approved for usage by Rush projects.
@@ -28,76 +32,70 @@ export declare class RushConstants {
      * (e.g. whose approval criteria mostly focuses on licensing and code size), and one for everywhere else
      * (e.g. tooling projects whose approval criteria mostly focuses on avoiding node_modules sprawl).
      */
-    static readonly nonbrowserApprovedPackagesFilename: string;
+    static readonly nonbrowserApprovedPackagesFilename: 'nonbrowser-approved-packages.json';
     /**
      * The folder name ("common") where Rush's common data will be stored.
      */
-    static readonly commonFolderName: string;
+    static readonly commonFolderName: 'common';
     /**
      * The NPM scope ("\@rush-temp") that is used for Rush's temporary projects.
      */
-    static readonly rushTempNpmScope: string;
+    static readonly rushTempNpmScope: '@rush-temp';
     /**
      * The folder name ("temp") 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`
      */
-    static readonly rushTempFolderName: string;
+    static readonly rushTempFolderName: 'temp';
     /**
      * The folder name ("projects") where temporary projects will be stored.
      * Example: `C:\MyRepo\common\temp\projects`
      */
-    static readonly rushTempProjectsFolderName: string;
-    /**
-     * 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: string;
+    static readonly rushTempProjectsFolderName: 'projects';
     /**
      * The filename ("npm-shrinkwrap.json") used to store an installation plan for the NPM package manger.
      */
-    static readonly npmShrinkwrapFilename: string;
+    static readonly npmShrinkwrapFilename: 'npm-shrinkwrap.json';
     /**
      * Number of installation attempts
      */
-    static readonly defaultMaxInstallAttempts: number;
+    static readonly defaultMaxInstallAttempts: 1;
     /**
      * The filename ("pnpm-lock.yaml") used to store an installation plan for the PNPM package manger
      * (PNPM version 3.x and later).
      */
-    static readonly pnpmV3ShrinkwrapFilename: string;
+    static readonly pnpmV3ShrinkwrapFilename: 'pnpm-lock.yaml';
     /**
      * The filename ("pnpmfile.js") used to add custom configuration to PNPM (PNPM version 1.x and later).
      */
-    static readonly pnpmfileV1Filename: string;
+    static readonly pnpmfileV1Filename: 'pnpmfile.js';
     /**
      * The filename (".pnpmfile.cjs") used to add custom configuration to PNPM (PNPM version 6.x and later).
      */
-    static readonly pnpmfileV6Filename: string;
+    static readonly pnpmfileV6Filename: '.pnpmfile.cjs';
     /**
      * The filename ("global-pnpmfile.cjs") used to add custom configuration to subspaces
      */
-    static readonly pnpmfileGlobalFilename: string;
+    static readonly pnpmfileGlobalFilename: 'global-pnpmfile.cjs';
     /**
      * The folder name used to store patch files for pnpm
      * Example: `C:\MyRepo\common\config\pnpm-patches`
      * Example: `C:\MyRepo\common\temp\patches`
      */
-    static readonly pnpmPatchesFolderName: string;
+    static readonly pnpmPatchesFolderName: 'patches';
     /**
      * The folder name under `/common/temp` used to store checked-in patches.
      * Example: `C:\MyRepo\common\pnpm-patches`
      */
-    static readonly pnpmPatchesCommonFolderName: string;
+    static readonly pnpmPatchesCommonFolderName: `pnpm-patches`;
     /**
      * The filename ("shrinkwrap.yaml") used to store state for pnpm
      */
-    static readonly yarnShrinkwrapFilename: string;
+    static readonly yarnShrinkwrapFilename: 'yarn.lock';
     /**
      * The folder name ("node_modules") where NPM installs its packages.
      */
-    static readonly nodeModulesFolderName: string;
+    static readonly nodeModulesFolderName: 'node_modules';
     /**
      * The filename ("pinned-versions.json") for an old configuration file that
      * that is no longer supported.
@@ -105,98 +103,98 @@ export declare class RushConstants {
      * @deprecated This feature has been superseded by the "preferredVersions" setting
      * in common-versions.json
      */
-    static readonly pinnedVersionsFilename: string;
+    static readonly pinnedVersionsFilename: 'pinned-versions.json';
     /**
      * The filename ("common-versions.json") for an optional configuration file
      * that stores dependency version information that affects all projects in the repo.
      * This configuration file should go in the "common/config/rush" folder.
      */
-    static readonly commonVersionsFilename: string;
+    static readonly commonVersionsFilename: 'common-versions.json';
     /**
      * The filename ("repo-state.json") for a file used by Rush to
      * store the state of various features as they stand in the repo.
      */
-    static readonly repoStateFilename: string;
+    static readonly repoStateFilename: 'repo-state.json';
     /**
      * The filename ("custom-tips.json") for the file used by Rush to
      * print user-customized messages.
      * This configuration file should go in the "common/config/rush" folder.
      */
-    static readonly customTipsFilename: string;
+    static readonly customTipsFilename: 'custom-tips.json';
     /**
      * The name of the per-project folder where project-specific Rush files are stored. For example,
      * the package-deps files, which are used by commands to determine if a particular project needs to be rebuilt.
      */
-    static readonly projectRushFolderName: string;
+    static readonly projectRushFolderName: '.rush';
     /**
      * Custom command line configuration file, which is used by rush for implementing
      * custom command and options.
      */
-    static readonly commandLineFilename: string;
-    static readonly versionPoliciesFilename: string;
+    static readonly commandLineFilename: 'command-line.json';
+    static readonly versionPoliciesFilename: 'version-policies.json';
     /**
      * Experiments configuration file.
      */
-    static readonly experimentsFilename: string;
+    static readonly experimentsFilename: 'experiments.json';
     /**
      * Pnpm configuration file
      */
-    static readonly pnpmConfigFilename: string;
+    static readonly pnpmConfigFilename: 'pnpm-config.json';
     /**
      * Rush plugins configuration file name.
      */
-    static readonly rushPluginsConfigFilename: string;
+    static readonly rushPluginsConfigFilename: 'rush-plugins.json';
     /**
      * Rush plugin manifest file name.
      */
-    static readonly rushPluginManifestFilename: string;
+    static readonly rushPluginManifestFilename: 'rush-plugin-manifest.json';
     /**
      * The artifactory.json configuration file name.
      */
-    static readonly artifactoryFilename: string;
+    static readonly artifactoryFilename: 'artifactory.json';
     /**
      * The subspaces.json configuration file name
      */
-    static readonly subspacesConfigFilename: string;
+    static readonly subspacesConfigFilename: 'subspaces.json';
     /**
      * The name of the default subspace if one isn't specified but subspaces is enabled.
      */
-    static readonly defaultSubspaceName: string;
+    static readonly defaultSubspaceName: 'default';
     /**
      * Build cache configuration file.
      */
-    static readonly buildCacheFilename: string;
+    static readonly buildCacheFilename: 'build-cache.json';
     /**
      * Build cache version number, incremented when the logic to create cache entries changes.
      * Changing this ensures that cache entries generated by an old version will no longer register as a cache hit.
      */
-    static readonly buildCacheVersion: number;
+    static readonly buildCacheVersion: 1;
     /**
      * Cobuild configuration file.
      */
-    static readonly cobuildFilename: string;
+    static readonly cobuildFilename: 'cobuild.json';
     /**
      * Per-project configuration filename.
      */
-    static readonly rushProjectConfigFilename: string;
+    static readonly rushProjectConfigFilename: 'rush-project.json';
     /**
      * The URL ("http://rushjs.io") for the Rush web site.
      */
-    static readonly rushWebSiteUrl: string;
+    static readonly rushWebSiteUrl: 'https://rushjs.io';
     /**
      * The name of the NPM package for the Rush tool ("\@microsoft/rush").
      */
-    static readonly rushPackageName: string;
+    static readonly rushPackageName: '@microsoft/rush';
     /**
      * The folder name ("rush-recycler") where Rush moves large folder trees
      * before asynchronously deleting them.
      */
-    static readonly rushRecyclerFolderName: string;
+    static readonly rushRecyclerFolderName: 'rush-recycler';
     /**
      * The name of the file to drop in project-folder/.rush/temp/ containing a listing of the project's direct
      * and indirect dependencies. This is used to detect if a project's dependencies have changed since the last build.
      */
-    static readonly projectShrinkwrapFilename: string;
+    static readonly projectShrinkwrapFilename: 'shrinkwrap-deps.json';
     /**
      * The value of the "commandKind" property for a bulk command in command-line.json
      */
@@ -212,26 +210,26 @@ export declare class RushConstants {
     /**
      * The name of the incremental build command.
      */
-    static readonly buildCommandName: string;
+    static readonly buildCommandName: 'build';
     /**
      * The name of the non-incremental build command.
      */
-    static readonly rebuildCommandName: string;
-    static readonly updateCloudCredentialsCommandName: string;
+    static readonly rebuildCommandName: 'rebuild';
+    static readonly updateCloudCredentialsCommandName: 'update-cloud-credentials';
     /**
      * When a hash generated that contains multiple input segments, this character may be used
      * to separate them to avoid issues like
      * crypto.createHash('sha1').update('a').update('bc').digest('hex') === crypto.createHash('sha1').update('ab').update('c').digest('hex')
      */
-    static readonly hashDelimiter: string;
+    static readonly hashDelimiter: '|';
     /**
      * The name of the per-user Rush configuration data folder.
      */
-    static readonly rushUserConfigurationFolderName: string;
+    static readonly rushUserConfigurationFolderName: '.rush-user';
     /**
      * The name of the project `rush-logs` folder.
      */
-    static readonly rushLogsFolderName: string;
+    static readonly rushLogsFolderName: 'rush-logs';
     /**
      * The expected prefix for phase names in "common/config/rush/command-line.json"
      */
@@ -241,7 +239,7 @@ export declare class RushConstants {
      * how long to wait after the last encountered file system event before execution. If another
      * file system event occurs in this interval, the timeout will reset.
      */
-    static readonly defaultWatchDebounceMs: number;
+    static readonly defaultWatchDebounceMs: 1000;
     /**
      * The name of the parameter that can be used to bypass policies.
      */
@@ -249,10 +247,10 @@ export declare class RushConstants {
     /**
      * Merge Queue ignore configuration file.
      */
-    static readonly mergeQueueIgnoreFileName: string;
+    static readonly mergeQueueIgnoreFileName: '.mergequeueignore';
     /**
      * The filename ("project-impact-graph.yaml") for the project impact graph file.
      */
-    static readonly projectImpactGraphFilename: string;
+    static readonly projectImpactGraphFilename: 'project-impact-graph.yaml';
 }
 //# sourceMappingURL=RushConstants.d.ts.map

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

@@ -58,10 +58,6 @@ export interface IInstallManagerOptions {
      * If specified when using PNPM, the logs will be in /common/temp/pnpm.log
      */
     collectLogFile: boolean;
-    /**
-     * The variant to consider when performing installations and validating shrinkwrap updates.
-     */
-    variant?: string | undefined;
     /**
      * Retry the install the specified number of times
      */

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

@@ -78,11 +78,10 @@ export declare abstract class BaseShrinkwrapFile {
      * a given package.json. Returns true if any dependencies are not aligned with the shrinkwrap.
      *
      * @param project - the Rush project that is being validated against the shrinkwrap
-     * @param variant - the variant that is being validated
      *
      * @virtual
      */
-    abstract isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, subspace: Subspace, variant?: string): Promise<boolean>;
+    abstract isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, subspace: Subspace): Promise<boolean>;
     /** @virtual */
     protected abstract serialize(): string;
     protected _getTempProjectNames(dependencies: {

package/lib/logic/npm/NpmShrinkwrapFile.d.ts

@@ -25,6 +25,6 @@ export declare class NpmShrinkwrapFile extends BaseShrinkwrapFile {
     /** @override */
     getProjectShrinkwrap(project: RushConfigurationProject): BaseProjectShrinkwrapFile<NpmShrinkwrapFile> | undefined;
     /** @override */
-    isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, subspace: Subspace, variant?: string): Promise<boolean>;
+    isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, subspace: Subspace): Promise<boolean>;
 }
 //# sourceMappingURL=NpmShrinkwrapFile.d.ts.map

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

@@ -219,7 +219,7 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     getImporter(importerKey: string): IPnpmShrinkwrapImporterYaml | undefined;
     getIntegrityForImporter(importerKey: string): Map<string, string> | undefined;
     /** @override */
-    isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, subspace: Subspace, variant?: string): Promise<boolean>;
+    isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, subspace: Subspace): Promise<boolean>;
     private _getIntegrityForPackage;
     private _addIntegrities;
     /**

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

@@ -1,15 +1,6 @@
 import { type IPackageJson } from '@rushstack/node-core-library';
 import type { RushConfiguration } from '../../api/RushConfiguration';
 import type { Subspace } from '../../api/Subspace';
-/**
- * Options used when generating the pnpmfile shim settings file.
- */
-export interface IPnpmfileShimOptions {
-    /**
-     * The variant that the client pnpmfile will be sourced from.
-     */
-    variant?: string;
-}
 /**
  * Loads PNPM's pnpmfile.js configuration, and invokes it to preprocess package.json files,
  * optionally utilizing a pnpmfile shim to inject preferred versions.
@@ -17,8 +8,8 @@ export interface IPnpmfileShimOptions {
 export declare class PnpmfileConfiguration {
     private _context;
     private constructor();
-    static initializeAsync(rushConfiguration: RushConfiguration, subspace: Subspace, pnpmfileShimOptions?: IPnpmfileShimOptions): Promise<PnpmfileConfiguration>;
-    static writeCommonTempPnpmfileShimAsync(rushConfiguration: RushConfiguration, targetDir: string, subspace: Subspace, options?: IPnpmfileShimOptions): Promise<void>;
+    static initializeAsync(rushConfiguration: RushConfiguration, subspace: Subspace): Promise<PnpmfileConfiguration>;
+    static writeCommonTempPnpmfileShimAsync(rushConfiguration: RushConfiguration, targetDir: string, subspace: Subspace): Promise<void>;
     private static _getPnpmfileShimSettingsAsync;
     /**
      * Transform a package.json file using the pnpmfile.js hook.

package/lib/logic/policy/PolicyValidator.d.ts

@@ -4,7 +4,6 @@ export interface IPolicyValidatorOptions {
     bypassPolicyAllowed?: boolean;
     bypassPolicy?: boolean;
     allowShrinkwrapUpdates?: boolean;
-    shrinkwrapVariant?: string;
 }
 export declare function validatePolicyAsync(rushConfiguration: RushConfiguration, subspace: Subspace, options: IPolicyValidatorOptions): Promise<void>;
 //# sourceMappingURL=PolicyValidator.d.ts.map

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

@@ -3,7 +3,6 @@ import type { RushConfiguration } from '../../api/RushConfiguration';
 import type { VersionMismatchFinderEntity } from './VersionMismatchFinderEntity';
 import type { Subspace } from '../../api/Subspace';
 export interface IVersionMismatchFinderOptions {
-    variant?: string | undefined;
     subspace?: Subspace;
 }
 export interface IVersionMismatchFinderRushCheckOptions extends IVersionMismatchFinderOptions {

package/lib/logic/yarn/YarnShrinkwrapFile.d.ts

@@ -51,6 +51,6 @@ export declare class YarnShrinkwrapFile extends BaseShrinkwrapFile {
     /** @override */
     getProjectShrinkwrap(project: RushConfigurationProject): BaseProjectShrinkwrapFile<YarnShrinkwrapFile> | undefined;
     /** @override */
-    isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, subspace: Subspace, variant?: string): Promise<boolean>;
+    isWorkspaceProjectModifiedAsync(project: RushConfigurationProject, subspace: Subspace): Promise<boolean>;
 }
 //# sourceMappingURL=YarnShrinkwrapFile.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.116.0",
+  "version": "5.117.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -26,16 +26,16 @@
     "@types/node-fetch": "2.6.2",
     "tapable": "2.2.1",
     "@rushstack/node-core-library": "4.0.2",
-    "@rushstack/terminal": "0.9.0"
+    "@rushstack/terminal": "0.10.0"
   },
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.0",
-    "@rushstack/heft": "0.65.4",
+    "@rushstack/heft": "0.65.5",
     "local-node-rig": "1.0.0",
-    "@rushstack/stream-collator": "4.1.31",
-    "@microsoft/rush-lib": "5.116.0",
-    "@rushstack/ts-command-line": "4.17.3"
+    "@microsoft/rush-lib": "5.117.0",
+    "@rushstack/stream-collator": "4.1.32",
+    "@rushstack/ts-command-line": "4.17.4"
   },
   "scripts": {
     "build": "heft build --clean",

package/lib/api/Variants.d.ts

@@ -1,11 +0,0 @@
-import type { ICommandLineStringDefinition } from '@rushstack/ts-command-line';
-/**
- * Namespace for utilities relating to the Variants feature.
- */
-export declare class Variants {
-    /**
-     * Provides the parameter configuration for '--variant'.
-     */
-    static readonly VARIANT_PARAMETER: ICommandLineStringDefinition;
-}
-//# sourceMappingURL=Variants.d.ts.map

package/lib/api/Variants.js

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