@rushstack/rush-sdk 5.57.1 → 5.58.0

package/dist/rush-lib.d.ts

@@ -736,6 +736,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 +958,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 +975,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
  */
@@ -1459,16 +1487,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 +1642,7 @@ export declare class RushConfiguration {
     private _gitChangeLogUpdateCommitMessage;
     private _gitTagSeparator;
     private _hotfixChangeEnabled;
-    private _repositoryUrl;
+    private _repositoryUrls;
     private _repositoryDefaultBranch;
     private _repositoryDefaultRemote;
     private _npmOptions;
@@ -1898,9 +1920,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.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rushstack/rush-sdk",
-	"version": "5.57.1",
+	"version": "5.58.0",
 	"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.44.1",
+		"@rushstack/node-core-library": "3.44.2",
 		"@types/node-fetch": "1.6.9",
 		"tapable": "2.2.1"
 	},
 	"devDependencies": {
-		"@microsoft/rush-lib": "5.57.1",
+		"@microsoft/rush-lib": "5.58.0",
 		"@rushstack/eslint-config": "2.5.0",
-		"@rushstack/heft": "0.43.1",
-		"@rushstack/heft-node-rig": "1.4.2",
+		"@rushstack/heft": "0.44.0",
+		"@rushstack/heft-node-rig": "1.5.0",
 		"@types/heft-jest": "1.0.1",
 		"@types/node": "12.20.24",
 		"@types/semver": "7.3.5"