@rushstack/rush-sdk 5.57.0 → 5.59.0-rc.1

package/dist/rush-lib.d.ts

@@ -721,12 +721,10 @@ export declare interface IExperimentsJson {
      */
     buildCacheWithAllowWarningsInSuccessfulBuild?: boolean;
     /**
-     * If true, the multi-phase commands feature is enabled. To use this feature, create a "phased" command
+     * If true, the phased commands feature is enabled. To use this feature, create a "phased" command
      * in common/config/rush/command-line.json.
-     *
-     * THIS FEATURE IS NOT READY FOR USAGE YET. SEE GITHUB #2300 FOR STATUS.
      */
-    _multiPhaseCommands?: boolean;
+    phasedCommands?: boolean;
 }
 
 /**
@@ -736,6 +734,16 @@ export declare interface IGetChangedProjectsOptions {
     targetBranchName: string;
     terminal: ITerminal;
     shouldFetch?: boolean;
+    /**
+     * If set to `true`, consider a project's external dependency installation layout as defined in the
+     * package manager lockfile when determining if it has changed.
+     */
+    includeExternalDependencies: boolean;
+    /**
+     * If set to `true` apply the `incrementalBuildIgnoredGlobs` property in a project's `rush-project.json`
+     * and exclude matched files from change detection.
+     */
+    enableFiltering: boolean;
 }
 
 declare interface IIndividualVersionJson extends IVersionPolicyJson {
@@ -948,14 +956,12 @@ declare interface IRushPluginsConfigurationJson {
     plugins: IRushPluginConfiguration[];
 }
 
+declare type IRushRepositoryJson = IRushRepositoryJsonSingleUrl | IRushRepositoryJsonMultipleUrls;
+
 /**
  * Part of IRushConfigurationJson.
  */
-declare interface IRushRepositoryJson {
-    /**
-     * The remote url of the repository. This helps "rush change" find the right remote to compare against.
-     */
-    url?: string;
+declare interface IRushRepositoryJsonBase {
     /**
      * The default branch name. This tells "rush change" which remote branch to compare against.
      */
@@ -967,6 +973,26 @@ declare interface IRushRepositoryJson {
     defaultRemote?: string;
 }
 
+declare interface IRushRepositoryJsonMultipleUrls extends IRushRepositoryJsonBase {
+    /**
+     * Remote url(s) of the repository. If a value is provided, \"rush change\" will
+     * use one of these to find the right remote to compare against. Specifying multiple URLs
+     * is useful if a GitHub repository is renamed or for "<projectName>.visualstudio.com" vs
+     * "dev.azure.com/<projectName>" URLs.
+     */
+    urls?: string[];
+}
+
+declare interface IRushRepositoryJsonSingleUrl extends IRushRepositoryJsonBase {
+    /**
+     * The remote url of the repository. If a value is provided,
+     * \"rush change\" will use it to find the right remote to compare against.
+     *
+     * @deprecated Use "urls" instead.
+     */
+    url?: string;
+}
+
 /**
  * @beta
  */
@@ -1429,9 +1455,9 @@ export declare class ProjectChangeAnalyzer {
      * undefined === data isn't available (i.e. - git isn't present)
      */
     private _data;
-    private _filteredData;
-    private _projectStateCache;
-    private _rushConfiguration;
+    private readonly _filteredData;
+    private readonly _projectStateCache;
+    private readonly _rushConfiguration;
     private readonly _git;
     constructor(rushConfiguration: RushConfiguration);
     /**
@@ -1459,16 +1485,10 @@ export declare class ProjectChangeAnalyzer {
     _filterProjectDataAsync<T>(project: RushConfigurationProject, unfilteredProjectData: Map<string, T>, rootDir: string, terminal: ITerminal): Promise<Map<string, T>>;
     /**
      * Gets a list of projects that have changed in the current state of the repo
-     * when compared to the specified branch.
-     */
-    getProjectsWithChangesAsync(options: IGetChangedProjectsOptions): Promise<Set<RushConfigurationProject>>;
-    /**
-     * Gets a list of projects that have changed in the current state of the repo
-     * when compared to the specified branch, taking the shrinkwrap and settings in
+     * when compared to the specified branch, optionally taking the shrinkwrap and settings in
      * the rush-project.json file into consideration.
      */
-    getProjectsImpactedByDiffAsync(options: IGetChangedProjectsOptions): Promise<Set<RushConfigurationProject>>;
-    private _getChangedProjectsInternalAsync;
+    getChangedProjectsAsync(options: IGetChangedProjectsOptions): Promise<Set<RushConfigurationProject>>;
     private _getData;
     private _getIgnoreMatcherForProjectAsync;
     private _getRepoDeps;
@@ -1620,7 +1640,7 @@ export declare class RushConfiguration {
     private _gitChangeLogUpdateCommitMessage;
     private _gitTagSeparator;
     private _hotfixChangeEnabled;
-    private _repositoryUrl;
+    private _repositoryUrls;
     private _repositoryDefaultBranch;
     private _repositoryDefaultRemote;
     private _npmOptions;
@@ -1898,9 +1918,12 @@ export declare class RushConfiguration {
      */
     get hotfixChangeEnabled(): boolean;
     /**
-     * The remote url of the repository. This helps "rush change" find the right remote to compare against.
+     * Remote URL(s) of the repository. If a value is provided, \"rush change\" will
+     * use one of these to find the right remote to compare against. Specifying multiple URLs
+     * is useful if a GitHub repository is renamed or for "<projectName>.visualstudio.com" vs
+     * "dev.azure.com/<projectName>" URLs.
      */
-    get repositoryUrl(): string | undefined;
+    get repositoryUrls(): string[];
     /**
      * The default branch name. This tells "rush change" which remote branch to compare against.
      */
@@ -2450,6 +2473,14 @@ export declare class RushConstants {
      * The name of the per-user Rush configuration data folder.
      */
     static readonly rushUserConfigurationFolderName: string;
+    /**
+     * The name of the project `rush-logs` folder.
+     */
+    static readonly rushLogsFolderName: string;
+    /**
+     * The expected prefix for phase names in "common/config/rush/command-line.json"
+     */
+    static readonly phaseNamePrefix: '_phase:';
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rushstack/rush-sdk",
-	"version": "5.57.0",
+	"version": "5.59.0-rc.1",
 	"description": "An API for interacting with the Rush engine",
 	"repository": {
 		"type": "git",
@@ -12,15 +12,15 @@
 	"typings": "dist/rush-lib.d.ts",
 	"license": "MIT",
 	"dependencies": {
-		"@rushstack/node-core-library": "3.43.2",
+		"@rushstack/node-core-library": "3.44.3",
 		"@types/node-fetch": "1.6.9",
 		"tapable": "2.2.1"
 	},
 	"devDependencies": {
-		"@microsoft/rush-lib": "5.57.0",
-		"@rushstack/eslint-config": "2.4.5",
-		"@rushstack/heft": "0.42.3",
-		"@rushstack/heft-node-rig": "1.2.32",
+		"@microsoft/rush-lib": "5.59.0-rc.1",
+		"@rushstack/eslint-config": "2.5.1",
+		"@rushstack/heft": "0.44.1",
+		"@rushstack/heft-node-rig": "1.5.1",
 		"@types/heft-jest": "1.0.1",
 		"@types/node": "12.20.24",
 		"@types/semver": "7.3.5"