@microsoft/rush 5.167.0 → 5.169.0

package/CHANGELOG.json

@@ -1,6 +1,42 @@
 {
   "name": "@microsoft/rush",
   "entries": [
+    {
+      "version": "5.169.0",
+      "tag": "@microsoft/rush_v5.169.0",
+      "date": "Thu, 19 Feb 2026 00:05:11 GMT",
+      "comments": {
+        "none": [
+          {
+            "comment": "Sort the `additionalFilesForOperation` property in operation settings entries in projects' `config/rush-project.json` files before computing operation hashes to produce a stable hash for caching."
+          },
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs` and DTS is now under `lib-dts`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          },
+          {
+            "comment": "Add a new \"omitAppleDoubleFilesFromBuildCache\" experiment. When enabled, the Rush build cache will omit macOS AppleDouble metadata files (._*) from cache archives when a companion file exists in the same directory. This prevents platform-specific metadata files from polluting the shared build cache. The exclusion only applies when running on macOS."
+          },
+          {
+            "comment": "Add a new `dependsOnNodeVersion` setting for operation entries in rush-project.json. When enabled, the Node.js version is included in the build cache hash, ensuring that cached outputs are invalidated when the Node.js version changes. Accepts `true` (alias for `\"patch\"`), `\"major\"`, `\"minor\"`, or `\"patch\"` to control the granularity of version matching."
+          }
+        ]
+      }
+    },
+    {
+      "version": "5.168.0",
+      "tag": "@microsoft/rush_v5.168.0",
+      "date": "Thu, 12 Feb 2026 23:01:10 GMT",
+      "comments": {
+        "none": [
+          {
+            "comment": "Add named exports to support named imports to `@rushstack/rush-sdk`."
+          },
+          {
+            "comment": "Fix `rush change --verify` to ignore version-only changes in package.json files and changes to CHANGELOG.md and CHANGELOG.json files, preventing false positives after `rush version --bump` updates package versions and changelogs."
+          }
+        ]
+      }
+    },
     {
       "version": "5.167.0",
       "tag": "@microsoft/rush_v5.167.0",

package/CHANGELOG.md

@@ -1,6 +1,24 @@
 # Change Log - @microsoft/rush
 
-This log was last generated on Thu, 05 Feb 2026 00:24:16 GMT and should not be manually modified.
+This log was last generated on Thu, 19 Feb 2026 00:05:11 GMT and should not be manually modified.
+
+## 5.169.0
+Thu, 19 Feb 2026 00:05:11 GMT
+
+### Updates
+
+- Sort the `additionalFilesForOperation` property in operation settings entries in projects' `config/rush-project.json` files before computing operation hashes to produce a stable hash for caching.
+- Normalize package layout. CommonJS is now under `lib-commonjs` and DTS is now under `lib-dts`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
+- Add a new "omitAppleDoubleFilesFromBuildCache" experiment. When enabled, the Rush build cache will omit macOS AppleDouble metadata files (._*) from cache archives when a companion file exists in the same directory. This prevents platform-specific metadata files from polluting the shared build cache. The exclusion only applies when running on macOS.
+- Add a new `dependsOnNodeVersion` setting for operation entries in rush-project.json. When enabled, the Node.js version is included in the build cache hash, ensuring that cached outputs are invalidated when the Node.js version changes. Accepts `true` (alias for `"patch"`), `"major"`, `"minor"`, or `"patch"` to control the granularity of version matching.
+
+## 5.168.0
+Thu, 12 Feb 2026 23:01:10 GMT
+
+### Updates
+
+- Add named exports to support named imports to `@rushstack/rush-sdk`.
+- Fix `rush change --verify` to ignore version-only changes in package.json files and changes to CHANGELOG.md and CHANGELOG.json files, preventing false positives after `rush version --bump` updates package versions and changelogs.
 
 ## 5.167.0
 Thu, 05 Feb 2026 00:24:16 GMT

package/bin/rush

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib-commonjs/start.js');

package/bin/rush-pnpm

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib-commonjs/start.js');

package/bin/rushx

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib-commonjs/start.js');

package/{lib → lib-commonjs}/RushCommandSelector.js

@@ -52,10 +52,8 @@ class RushCommandSelector {
             RushCommandSelector._failWithError(`This repository is using Rush version ${version} which does not support the ${commandName} command`);
         }
     }
-    static execute(launcherVersion, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    selectedRushLib, options) {
-        const Rush = selectedRushLib.Rush;
+    static execute(launcherVersion, selectedRushLib, options) {
+        const { Rush } = selectedRushLib;
         if (!Rush) {
             // This should be impossible unless we somehow loaded an unexpected version
             RushCommandSelector._failWithError(`Unable to find the "Rush" entry point in @microsoft/rush-lib`);

package/lib-commonjs/RushCommandSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RushCommandSelector.js","sourceRoot":"","sources":["../src/RushCommandSelector.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,gDAAkC;AAGlC,kDAA+C;AAI/C;;;;;;GAMG;AACH,MAAa,mBAAmB;IACvB,MAAM,CAAC,sBAAsB,CAAC,OAAe;QAClD,MAAM,WAAW,GAAgB,mBAAmB,CAAC,eAAe,EAAE,CAAC;QACvE,IAAI,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACxD,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,OAAO,+BAA+B,WAAW,UAAU,CACrG,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,OAAO,CACnB,eAAuB,EACvB,eAAqD,EACrD,OAAuB;QAEvB,MAAM,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC;QAEjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,2EAA2E;YAC3E,mBAAmB,CAAC,cAAc,CAAC,8DAA8D,CAAC,CAAC;QACrG,CAAC;QAED,MAAM,WAAW,GAAgB,mBAAmB,CAAC,eAAe,EAAE,CAAC;QAEvE,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACzB,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,IAAI,CAAC,OAAO,EAAE;oBACrD,iDAAiD,CACpD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE;gBACnC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,8BAA8B,EAAE,OAAO,CAAC,8BAA8B;aACvE,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtB,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,IAAI,CAAC,OAAO,EAAE;oBACrD,6CAA6C,CAChD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,OAAe;QAC3C,OAAO,CAAC,GAAG,CAAC,mBAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,eAAe;QAC5B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7B,WAAW;YACX,iDAAiD;YACjD,mFAAmF;YACnF,MAAM,QAAQ,GAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACtE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO,WAAW,CAAC;YACrB,CAAC;YACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAvED,kDAuEC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\n\nimport type { ILaunchOptions } from '@microsoft/rush-lib/lib/index';\nimport { Colorize } from '@rushstack/terminal';\n\ntype CommandName = 'rush' | 'rush-pnpm' | 'rushx' | undefined;\n\n/**\n * Both \"rush\" and \"rushx\" share the same src/start.ts entry point.  This makes it\n * a little easier for them to share all the same startup checks and version selector\n * logic.  RushCommandSelector looks at argv to determine whether we're doing \"rush\"\n * or \"rushx\" behavior, and then invokes the appropriate entry point in the selected\n * @microsoft/rush-lib.\n */\nexport class RushCommandSelector {\n  public static failIfNotInvokedAsRush(version: string): void {\n    const commandName: CommandName = RushCommandSelector._getCommandName();\n    if (commandName !== 'rush' && commandName !== undefined) {\n      RushCommandSelector._failWithError(\n        `This repository is using Rush version ${version} which does not support the ${commandName} command`\n      );\n    }\n  }\n\n  public static execute(\n    launcherVersion: string,\n    selectedRushLib: typeof import('@microsoft/rush-lib'),\n    options: ILaunchOptions\n  ): void {\n    const { Rush } = selectedRushLib;\n\n    if (!Rush) {\n      // This should be impossible unless we somehow loaded an unexpected version\n      RushCommandSelector._failWithError(`Unable to find the \"Rush\" entry point in @microsoft/rush-lib`);\n    }\n\n    const commandName: CommandName = RushCommandSelector._getCommandName();\n\n    if (commandName === 'rush-pnpm') {\n      if (!Rush.launchRushPnpm) {\n        RushCommandSelector._failWithError(\n          `This repository is using Rush version ${Rush.version}` +\n            ` which does not support the \"rush-pnpm\" command`\n        );\n      }\n      Rush.launchRushPnpm(launcherVersion, {\n        isManaged: options.isManaged,\n        alreadyReportedNodeTooNewError: options.alreadyReportedNodeTooNewError\n      });\n    } else if (commandName === 'rushx') {\n      if (!Rush.launchRushX) {\n        RushCommandSelector._failWithError(\n          `This repository is using Rush version ${Rush.version}` +\n            ` which does not support the \"rushx\" command`\n        );\n      }\n      Rush.launchRushX(launcherVersion, options);\n    } else {\n      Rush.launch(launcherVersion, options);\n    }\n  }\n\n  private static _failWithError(message: string): never {\n    console.log(Colorize.red(message));\n    return process.exit(1);\n  }\n\n  private static _getCommandName(): CommandName {\n    if (process.argv.length >= 2) {\n      // Example:\n      // argv[0]: \"C:\\\\Program Files\\\\nodejs\\\\node.exe\"\n      // argv[1]: \"C:\\\\Program Files\\\\nodejs\\\\node_modules\\\\@microsoft\\\\rush\\\\bin\\\\rushx\"\n      const basename: string = path.basename(process.argv[1]).toUpperCase();\n      if (basename === 'RUSH') {\n        return 'rush';\n      }\n      if (basename === 'RUSH-PNPM') {\n        return 'rush-pnpm';\n      }\n      if (basename === 'RUSHX') {\n        return 'rushx';\n      }\n    }\n    return undefined;\n  }\n}\n"]}

package/{lib → lib-commonjs}/RushVersionSelector.js

@@ -60,7 +60,7 @@ class RushVersionSelector {
             console.log(`Rush version ${version} is not currently installed. Installing...`);
             const resourceName = `rush-${version}`;
             console.log(`Trying to acquire lock for ${resourceName}`);
-            const lock = await node_core_library_1.LockFile.acquire(expectedRushPath, resourceName);
+            const lock = await node_core_library_1.LockFile.acquireAsync(expectedRushPath, resourceName);
             installIsValid = await installMarker.isValidAsync();
             if (installIsValid) {
                 console.log('Another process performed the installation.');
@@ -100,8 +100,15 @@ class RushVersionSelector {
             require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'start'));
         }
         else {
+            // Explicitly resolve the entry point for rush-lib, rather than using a simple require, because
+            // newer versions of rush-lib use the package.json `exports` field, which maps
+            // `lib/index` to `lib-commonjs/index.js`
+            const rushLibEntrypoint = await node_core_library_1.Import.resolveModuleAsync({
+                modulePath: '@microsoft/rush-lib/lib/index',
+                baseFolderPath: expectedRushPath
+            });
+            const rushCliEntrypoint = require(rushLibEntrypoint);
             // For newer rush-lib, RushCommandSelector can test whether "rushx" is supported or not
-            const rushCliEntrypoint = require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush-lib', 'lib', 'index'));
             RushCommandSelector_1.RushCommandSelector.execute(this._currentPackageVersion, rushCliEntrypoint, executeOptions);
         }
     }

package/lib-commonjs/RushVersionSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RushVersionSelector.js","sourceRoot":"","sources":["../src/RushVersionSelector.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\n\nimport * as semver from 'semver';\n\nimport { LockFile, Import } from '@rushstack/node-core-library';\nimport { Utilities } from '@microsoft/rush-lib/lib/utilities/Utilities';\nimport { _FlagFile, _RushGlobalFolder, type ILaunchOptions } from '@microsoft/rush-lib';\n\nimport { RushCommandSelector } from './RushCommandSelector';\nimport type { MinimalRushConfiguration } from './MinimalRushConfiguration';\n\nconst MAX_INSTALL_ATTEMPTS: number = 3;\n\nexport class RushVersionSelector {\n  private _rushGlobalFolder: _RushGlobalFolder;\n  private _currentPackageVersion: string;\n\n  public constructor(currentPackageVersion: string) {\n    this._rushGlobalFolder = new _RushGlobalFolder();\n    this._currentPackageVersion = currentPackageVersion;\n  }\n\n  public async ensureRushVersionInstalledAsync(\n    version: string,\n    configuration: MinimalRushConfiguration | undefined,\n    executeOptions: ILaunchOptions\n  ): Promise<void> {\n    const isLegacyRushVersion: boolean = semver.lt(version, '4.0.0');\n    const expectedRushPath: string = path.join(this._rushGlobalFolder.nodeSpecificPath, `rush-${version}`);\n\n    const installMarker: _FlagFile = new _FlagFile(expectedRushPath, 'last-install', {\n      node: process.versions.node\n    });\n\n    let installIsValid: boolean = await installMarker.isValidAsync();\n    if (!installIsValid) {\n      // Need to install Rush\n      console.log(`Rush version ${version} is not currently installed. Installing...`);\n\n      const resourceName: string = `rush-${version}`;\n\n      console.log(`Trying to acquire lock for ${resourceName}`);\n\n      const lock: LockFile = await LockFile.acquireAsync(expectedRushPath, resourceName);\n      installIsValid = await installMarker.isValidAsync();\n      if (installIsValid) {\n        console.log('Another process performed the installation.');\n      } else {\n        await Utilities.installPackageInDirectoryAsync({\n          directory: expectedRushPath,\n          packageName: isLegacyRushVersion ? '@microsoft/rush' : '@microsoft/rush-lib',\n          version: version,\n          tempPackageTitle: 'rush-local-install',\n          maxInstallAttempts: MAX_INSTALL_ATTEMPTS,\n          // This is using a local configuration to install a package in a shared global location.\n          // Generally that's a bad practice, but in this case if we can successfully install\n          // the package at all, we can reasonably assume it's good for all the repositories.\n          // In particular, we'll assume that two different NPM registries cannot have two\n          // different implementations of the same version of the same package.\n          // This was needed for: https://github.com/microsoft/rushstack/issues/691\n          commonRushConfigFolder: configuration ? configuration.commonRushConfigFolder : undefined,\n          suppressOutput: true\n        });\n\n        console.log(`Successfully installed Rush version ${version} in ${expectedRushPath}.`);\n\n        // If we've made it here without exception, write the flag file\n        await installMarker.createAsync();\n\n        lock.release();\n      }\n    }\n\n    if (semver.lt(version, '3.0.20')) {\n      // In old versions, requiring the entry point invoked the command-line parser immediately,\n      // so fail if \"rushx\" or \"rush-pnpm\" was used\n      RushCommandSelector.failIfNotInvokedAsRush(version);\n      require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'rush'));\n    } else if (semver.lt(version, '4.0.0')) {\n      // In old versions, requiring the entry point invoked the command-line parser immediately,\n      // so fail if \"rushx\" or \"rush-pnpm\" was used\n      RushCommandSelector.failIfNotInvokedAsRush(version);\n      require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'start'));\n    } else {\n      // Explicitly resolve the entry point for rush-lib, rather than using a simple require, because\n      // newer versions of rush-lib use the package.json `exports` field, which maps\n      // `lib/index` to `lib-commonjs/index.js`\n      const rushLibEntrypoint: string = await Import.resolveModuleAsync({\n        modulePath: '@microsoft/rush-lib/lib/index',\n        baseFolderPath: expectedRushPath\n      });\n      const rushCliEntrypoint: typeof import('@microsoft/rush-lib') = require(rushLibEntrypoint);\n      // For newer rush-lib, RushCommandSelector can test whether \"rushx\" is supported or not\n      RushCommandSelector.execute(this._currentPackageVersion, rushCliEntrypoint, executeOptions);\n    }\n  }\n}\n"]}

package/{lib → lib-commonjs}/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n// We're using a path-based import here to minimize the amount of code that is evaluated before\n// we check to see if the Node.js version is too old. If, for whatever reason, Rush crashes with\n// an old Node.js version when evaluating one of the more complex imports, we'll at least\n// shown a meaningful error message.\n// eslint-disable-next-line import/order\nimport { NodeJsCompatibility } from '@microsoft/rush-lib/lib/logic/NodeJsCompatibility';\n\nif (NodeJsCompatibility.reportAncientIncompatibleVersion()) {\n  // The Node.js version is known to have serious incompatibilities.  In that situation, the user\n  // should downgrade Rush to an older release that supported their Node.js version.\n  process.exit(1);\n}\n\nconst alreadyReportedNodeTooNewError: boolean = NodeJsCompatibility.warnAboutVersionTooNew({\n  isRushLib: false,\n  alreadyReportedNodeTooNewError: false\n});\n\nimport * as os from 'node:os';\n\nimport * as semver from 'semver';\n\nimport { Text, PackageJsonLookup } from '@rushstack/node-core-library';\nimport { Colorize, ConsoleTerminalProvider, type ITerminalProvider } from '@rushstack/terminal';\nimport { EnvironmentVariableNames } from '@microsoft/rush-lib';\nimport * as rushLib from '@microsoft/rush-lib';\n\nimport { RushCommandSelector } from './RushCommandSelector';\nimport { RushVersionSelector } from './RushVersionSelector';\nimport { MinimalRushConfiguration } from './MinimalRushConfiguration';\n\n// Load the configuration\nconst configuration: MinimalRushConfiguration | undefined =\n  MinimalRushConfiguration.loadFromDefaultLocation();\n\nconst currentPackageVersion: string = PackageJsonLookup.loadOwnPackageJson(__dirname).version;\n\nlet rushVersionToLoad: string | undefined = undefined;\n\nconst previewVersion: string | undefined = process.env[EnvironmentVariableNames.RUSH_PREVIEW_VERSION];\n\nif (previewVersion) {\n  if (!semver.valid(previewVersion, false)) {\n    console.error(\n      Colorize.red(`Invalid value for RUSH_PREVIEW_VERSION environment variable: \"${previewVersion}\"`)\n    );\n    process.exit(1);\n  }\n\n  rushVersionToLoad = previewVersion;\n\n  const lines: string[] = [];\n  lines.push(\n    `*********************************************************************`,\n    `* WARNING! THE \"RUSH_PREVIEW_VERSION\" ENVIRONMENT VARIABLE IS SET.  *`,\n    `*                                                                   *`,\n    `* You are previewing Rush version:        ${Text.padEnd(previewVersion, 25)} *`\n  );\n\n  if (configuration) {\n    lines.push(`* The rush.json configuration asks for:   ${Text.padEnd(configuration.rushVersion, 25)} *`);\n  }\n\n  lines.push(\n    `*                                                                   *`,\n    `* To restore the normal behavior, unset the RUSH_PREVIEW_VERSION    *`,\n    `* environment variable.                                             *`,\n    `*********************************************************************`\n  );\n\n  console.error(lines.map((line) => Colorize.black(Colorize.yellowBackground(line))).join(os.EOL));\n} else if (configuration) {\n  rushVersionToLoad = configuration.rushVersion;\n}\n\n// If we are previewing an older Rush that doesn't understand the RUSH_PREVIEW_VERSION variable,\n// then unset it.\nif (rushVersionToLoad && semver.lt(rushVersionToLoad, '5.0.0-dev.18')) {\n  delete process.env[EnvironmentVariableNames.RUSH_PREVIEW_VERSION];\n}\n\n// Rush is \"managed\" if its version and configuration are dictated by a repo's rush.json\nconst isManaged: boolean = !!configuration;\n\nconst terminalProvider: ITerminalProvider = new ConsoleTerminalProvider();\n\nconst launchOptions: rushLib.ILaunchOptions = { isManaged, alreadyReportedNodeTooNewError, terminalProvider };\n\n// If we're inside a repo folder, and it's requesting a different version, then use the RushVersionManager to\n// install it\nif (rushVersionToLoad && rushVersionToLoad !== currentPackageVersion) {\n  const versionSelector: RushVersionSelector = new RushVersionSelector(currentPackageVersion);\n  versionSelector\n    .ensureRushVersionInstalledAsync(rushVersionToLoad, configuration, launchOptions)\n    .catch((error: Error) => {\n      console.log(Colorize.red('Error: ' + error.message));\n    });\n} else {\n  // Otherwise invoke the rush-lib that came with this rush package\n  RushCommandSelector.execute(currentPackageVersion, rushLib, launchOptions);\n}\n"]}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n// We're using a path-based import here to minimize the amount of code that is evaluated before\n// we check to see if the Node.js version is too old. If, for whatever reason, Rush crashes with\n// an old Node.js version when evaluating one of the more complex imports, we'll at least\n// shown a meaningful error message.\n// eslint-disable-next-line import/order\nimport { NodeJsCompatibility } from '@microsoft/rush-lib/lib/logic/NodeJsCompatibility';\n\nif (NodeJsCompatibility.reportAncientIncompatibleVersion()) {\n  // The Node.js version is known to have serious incompatibilities.  In that situation, the user\n  // should downgrade Rush to an older release that supported their Node.js version.\n  process.exit(1);\n}\n\nconst alreadyReportedNodeTooNewError: boolean = NodeJsCompatibility.warnAboutVersionTooNew({\n  isRushLib: false,\n  alreadyReportedNodeTooNewError: false\n});\n\nimport * as os from 'node:os';\n\nimport * as semver from 'semver';\n\nimport { Text, PackageJsonLookup } from '@rushstack/node-core-library';\nimport { Colorize, ConsoleTerminalProvider, type ITerminalProvider } from '@rushstack/terminal';\nimport { EnvironmentVariableNames } from '@microsoft/rush-lib';\nimport type { ILaunchOptions } from '@microsoft/rush-lib';\nimport * as rushLib from '@microsoft/rush-lib';\n\nimport { RushCommandSelector } from './RushCommandSelector';\nimport { RushVersionSelector } from './RushVersionSelector';\nimport { MinimalRushConfiguration } from './MinimalRushConfiguration';\n\n// Load the configuration\nconst configuration: MinimalRushConfiguration | undefined =\n  MinimalRushConfiguration.loadFromDefaultLocation();\n\nconst currentPackageVersion: string = PackageJsonLookup.loadOwnPackageJson(__dirname).version;\n\nlet rushVersionToLoad: string | undefined = undefined;\n\nconst previewVersion: string | undefined = process.env[EnvironmentVariableNames.RUSH_PREVIEW_VERSION];\n\nif (previewVersion) {\n  if (!semver.valid(previewVersion, false)) {\n    console.error(\n      Colorize.red(`Invalid value for RUSH_PREVIEW_VERSION environment variable: \"${previewVersion}\"`)\n    );\n    process.exit(1);\n  }\n\n  rushVersionToLoad = previewVersion;\n\n  const lines: string[] = [];\n  lines.push(\n    `*********************************************************************`,\n    `* WARNING! THE \"RUSH_PREVIEW_VERSION\" ENVIRONMENT VARIABLE IS SET.  *`,\n    `*                                                                   *`,\n    `* You are previewing Rush version:        ${Text.padEnd(previewVersion, 25)} *`\n  );\n\n  if (configuration) {\n    lines.push(`* The rush.json configuration asks for:   ${Text.padEnd(configuration.rushVersion, 25)} *`);\n  }\n\n  lines.push(\n    `*                                                                   *`,\n    `* To restore the normal behavior, unset the RUSH_PREVIEW_VERSION    *`,\n    `* environment variable.                                             *`,\n    `*********************************************************************`\n  );\n\n  console.error(lines.map((line) => Colorize.black(Colorize.yellowBackground(line))).join(os.EOL));\n} else if (configuration) {\n  rushVersionToLoad = configuration.rushVersion;\n}\n\n// If we are previewing an older Rush that doesn't understand the RUSH_PREVIEW_VERSION variable,\n// then unset it.\nif (rushVersionToLoad && semver.lt(rushVersionToLoad, '5.0.0-dev.18')) {\n  delete process.env[EnvironmentVariableNames.RUSH_PREVIEW_VERSION];\n}\n\n// Rush is \"managed\" if its version and configuration are dictated by a repo's rush.json\nconst isManaged: boolean = !!configuration;\n\nconst terminalProvider: ITerminalProvider = new ConsoleTerminalProvider();\n\nconst launchOptions: ILaunchOptions = { isManaged, alreadyReportedNodeTooNewError, terminalProvider };\n\n// If we're inside a repo folder, and it's requesting a different version, then use the RushVersionManager to\n// install it\nif (rushVersionToLoad && rushVersionToLoad !== currentPackageVersion) {\n  const versionSelector: RushVersionSelector = new RushVersionSelector(currentPackageVersion);\n  versionSelector\n    .ensureRushVersionInstalledAsync(rushVersionToLoad, configuration, launchOptions)\n    .catch((error: Error) => {\n      console.log(Colorize.red('Error: ' + error.message));\n    });\n} else {\n  // Otherwise invoke the rush-lib that came with this rush package\n  RushCommandSelector.execute(currentPackageVersion, rushLib, launchOptions);\n}\n"]}

package/{lib → lib-dts}/RushCommandSelector.d.ts

@@ -1,4 +1,4 @@
-import type * as rushLib from '@microsoft/rush-lib';
+import type { ILaunchOptions } from '@microsoft/rush-lib/lib/index';
 /**
  * Both "rush" and "rushx" share the same src/start.ts entry point.  This makes it
  * a little easier for them to share all the same startup checks and version selector
@@ -8,7 +8,7 @@ import type * as rushLib from '@microsoft/rush-lib';
  */
 export declare class RushCommandSelector {
     static failIfNotInvokedAsRush(version: string): void;
-    static execute(launcherVersion: string, selectedRushLib: any, options: rushLib.ILaunchOptions): void;
+    static execute(launcherVersion: string, selectedRushLib: typeof import('@microsoft/rush-lib'), options: ILaunchOptions): void;
     private static _failWithError;
     private static _getCommandName;
 }

package/lib-dts/RushCommandSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RushCommandSelector.d.ts","sourceRoot":"","sources":["../src/RushCommandSelector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAKpE;;;;;;GAMG;AACH,qBAAa,mBAAmB;WAChB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;WAS7C,OAAO,CACnB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,cAAc,qBAAqB,CAAC,EACrD,OAAO,EAAE,cAAc,GACtB,IAAI;IAkCP,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B,OAAO,CAAC,MAAM,CAAC,eAAe;CAkB/B"}

package/{lib → lib-dts}/RushVersionSelector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RushVersionSelector.d.ts","sourceRoot":"","sources":["../src/RushVersionSelector.ts"],"names":[],"mappings":"AASA,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAI3E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,sBAAsB,CAAS;gBAEpB,qBAAqB,EAAE,MAAM;IAKnC,+BAA+B,CAC1C,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,wBAAwB,GAAG,SAAS,EACnD,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,IAAI,CAAC;CAiEjB"}
+{"version":3,"file":"RushVersionSelector.d.ts","sourceRoot":"","sources":["../src/RushVersionSelector.ts"],"names":[],"mappings":"AASA,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAI3E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,sBAAsB,CAAS;gBAEpB,qBAAqB,EAAE,MAAM;IAKnC,+BAA+B,CAC1C,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,wBAAwB,GAAG,SAAS,EACnD,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,IAAI,CAAC;CAsEjB"}

package/lib-esm/MinimalRushConfiguration.js

@@ -0,0 +1,58 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import * as path from 'node:path';
+import { JsonFile } from '@rushstack/node-core-library';
+import { RushConfiguration } from '@microsoft/rush-lib';
+import { RushConstants } from '@microsoft/rush-lib/lib/logic/RushConstants';
+import { RushCommandLineParser } from '@microsoft/rush-lib/lib/cli/RushCommandLineParser';
+/**
+ * Represents a minimal subset of the rush.json configuration file. It provides the information necessary to
+ * decide which version of Rush should be installed/used.
+ */
+export class MinimalRushConfiguration {
+    constructor(minimalRushConfigurationJson, rushJsonFilename) {
+        this._rushVersion =
+            minimalRushConfigurationJson.rushVersion || minimalRushConfigurationJson.rushMinimumVersion;
+        this._commonRushConfigFolder = path.join(path.dirname(rushJsonFilename), RushConstants.commonFolderName, 'config', 'rush');
+    }
+    static loadFromDefaultLocation() {
+        const rushJsonLocation = RushConfiguration.tryFindRushJsonLocation({
+            showVerbose: !RushCommandLineParser.shouldRestrictConsoleOutput()
+        });
+        if (rushJsonLocation) {
+            return MinimalRushConfiguration._loadFromConfigurationFile(rushJsonLocation);
+        }
+        else {
+            return undefined;
+        }
+    }
+    static _loadFromConfigurationFile(rushJsonFilename) {
+        try {
+            const minimalRushConfigurationJson = JsonFile.load(rushJsonFilename);
+            return new MinimalRushConfiguration(minimalRushConfigurationJson, rushJsonFilename);
+        }
+        catch (e) {
+            return undefined;
+        }
+    }
+    /**
+     * The version of rush specified by the rushVersion property of the rush.json configuration file. If the
+     *  rushVersion property is not specified, this falls back to the rushMinimumVersion property. This should be
+     *  a semver style version number like "4.0.0"
+     */
+    get rushVersion() {
+        return this._rushVersion;
+    }
+    /**
+     * The folder where Rush's additional config files are stored.  This folder is always a
+     * subfolder called "config\rush" inside the common folder.  (The "common\config" folder
+     * is reserved for configuration files used by other tools.)  To avoid confusion or mistakes,
+     * Rush will report an error if this this folder contains any unrecognized files.
+     *
+     * Example: "C:\MyRepo\common\config\rush"
+     */
+    get commonRushConfigFolder() {
+        return this._commonRushConfigFolder;
+    }
+}
+//# sourceMappingURL=MinimalRushConfiguration.js.map

package/lib-esm/MinimalRushConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MinimalRushConfiguration.js","sourceRoot":"","sources":["../src/MinimalRushConfiguration.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAO1F;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAInC,YAAoB,4BAA2D,EAAE,gBAAwB;QACvG,IAAI,CAAC,YAAY;YACf,4BAA4B,CAAC,WAAW,IAAI,4BAA4B,CAAC,kBAAkB,CAAC;QAC9F,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,IAAI,CACtC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAC9B,aAAa,CAAC,gBAAgB,EAC9B,QAAQ,EACR,MAAM,CACP,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,uBAAuB;QACnC,MAAM,gBAAgB,GAAuB,iBAAiB,CAAC,uBAAuB,CAAC;YACrF,WAAW,EAAE,CAAC,qBAAqB,CAAC,2BAA2B,EAAE;SAClE,CAAC,CAAC;QACH,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,wBAAwB,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,0BAA0B,CAAC,gBAAwB;QAChE,IAAI,CAAC;YACH,MAAM,4BAA4B,GAAkC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACpG,OAAO,IAAI,wBAAwB,CAAC,4BAA4B,EAAE,gBAAgB,CAAC,CAAC;QACtF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,IAAW,sBAAsB;QAC/B,OAAO,IAAI,CAAC,uBAAuB,CAAC;IACtC,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\n\nimport { JsonFile } from '@rushstack/node-core-library';\nimport { RushConfiguration } from '@microsoft/rush-lib';\nimport { RushConstants } from '@microsoft/rush-lib/lib/logic/RushConstants';\nimport { RushCommandLineParser } from '@microsoft/rush-lib/lib/cli/RushCommandLineParser';\n\ninterface IMinimalRushConfigurationJson {\n  rushMinimumVersion: string;\n  rushVersion?: string;\n}\n\n/**\n * Represents a minimal subset of the rush.json configuration file. It provides the information necessary to\n * decide which version of Rush should be installed/used.\n */\nexport class MinimalRushConfiguration {\n  private _rushVersion: string;\n  private _commonRushConfigFolder: string;\n\n  private constructor(minimalRushConfigurationJson: IMinimalRushConfigurationJson, rushJsonFilename: string) {\n    this._rushVersion =\n      minimalRushConfigurationJson.rushVersion || minimalRushConfigurationJson.rushMinimumVersion;\n    this._commonRushConfigFolder = path.join(\n      path.dirname(rushJsonFilename),\n      RushConstants.commonFolderName,\n      'config',\n      'rush'\n    );\n  }\n\n  public static loadFromDefaultLocation(): MinimalRushConfiguration | undefined {\n    const rushJsonLocation: string | undefined = RushConfiguration.tryFindRushJsonLocation({\n      showVerbose: !RushCommandLineParser.shouldRestrictConsoleOutput()\n    });\n    if (rushJsonLocation) {\n      return MinimalRushConfiguration._loadFromConfigurationFile(rushJsonLocation);\n    } else {\n      return undefined;\n    }\n  }\n\n  private static _loadFromConfigurationFile(rushJsonFilename: string): MinimalRushConfiguration | undefined {\n    try {\n      const minimalRushConfigurationJson: IMinimalRushConfigurationJson = JsonFile.load(rushJsonFilename);\n      return new MinimalRushConfiguration(minimalRushConfigurationJson, rushJsonFilename);\n    } catch (e) {\n      return undefined;\n    }\n  }\n\n  /**\n   * The version of rush specified by the rushVersion property of the rush.json configuration file. If the\n   *  rushVersion property is not specified, this falls back to the rushMinimumVersion property. This should be\n   *  a semver style version number like \"4.0.0\"\n   */\n  public get rushVersion(): string {\n    return this._rushVersion;\n  }\n\n  /**\n   * The folder where Rush's additional config files are stored.  This folder is always a\n   * subfolder called \"config\\rush\" inside the common folder.  (The \"common\\config\" folder\n   * is reserved for configuration files used by other tools.)  To avoid confusion or mistakes,\n   * Rush will report an error if this this folder contains any unrecognized files.\n   *\n   * Example: \"C:\\MyRepo\\common\\config\\rush\"\n   */\n  public get commonRushConfigFolder(): string {\n    return this._commonRushConfigFolder;\n  }\n}\n"]}

package/lib-esm/RushCommandSelector.js

@@ -0,0 +1,70 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import * as path from 'node:path';
+import { Colorize } from '@rushstack/terminal';
+/**
+ * Both "rush" and "rushx" share the same src/start.ts entry point.  This makes it
+ * a little easier for them to share all the same startup checks and version selector
+ * logic.  RushCommandSelector looks at argv to determine whether we're doing "rush"
+ * or "rushx" behavior, and then invokes the appropriate entry point in the selected
+ * @microsoft/rush-lib.
+ */
+export class RushCommandSelector {
+    static failIfNotInvokedAsRush(version) {
+        const commandName = RushCommandSelector._getCommandName();
+        if (commandName !== 'rush' && commandName !== undefined) {
+            RushCommandSelector._failWithError(`This repository is using Rush version ${version} which does not support the ${commandName} command`);
+        }
+    }
+    static execute(launcherVersion, selectedRushLib, options) {
+        const { Rush } = selectedRushLib;
+        if (!Rush) {
+            // This should be impossible unless we somehow loaded an unexpected version
+            RushCommandSelector._failWithError(`Unable to find the "Rush" entry point in @microsoft/rush-lib`);
+        }
+        const commandName = RushCommandSelector._getCommandName();
+        if (commandName === 'rush-pnpm') {
+            if (!Rush.launchRushPnpm) {
+                RushCommandSelector._failWithError(`This repository is using Rush version ${Rush.version}` +
+                    ` which does not support the "rush-pnpm" command`);
+            }
+            Rush.launchRushPnpm(launcherVersion, {
+                isManaged: options.isManaged,
+                alreadyReportedNodeTooNewError: options.alreadyReportedNodeTooNewError
+            });
+        }
+        else if (commandName === 'rushx') {
+            if (!Rush.launchRushX) {
+                RushCommandSelector._failWithError(`This repository is using Rush version ${Rush.version}` +
+                    ` which does not support the "rushx" command`);
+            }
+            Rush.launchRushX(launcherVersion, options);
+        }
+        else {
+            Rush.launch(launcherVersion, options);
+        }
+    }
+    static _failWithError(message) {
+        console.log(Colorize.red(message));
+        return process.exit(1);
+    }
+    static _getCommandName() {
+        if (process.argv.length >= 2) {
+            // Example:
+            // argv[0]: "C:\\Program Files\\nodejs\\node.exe"
+            // argv[1]: "C:\\Program Files\\nodejs\\node_modules\\@microsoft\\rush\\bin\\rushx"
+            const basename = path.basename(process.argv[1]).toUpperCase();
+            if (basename === 'RUSH') {
+                return 'rush';
+            }
+            if (basename === 'RUSH-PNPM') {
+                return 'rush-pnpm';
+            }
+            if (basename === 'RUSHX') {
+                return 'rushx';
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=RushCommandSelector.js.map

package/lib-esm/RushCommandSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RushCommandSelector.js","sourceRoot":"","sources":["../src/RushCommandSelector.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAI/C;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IACvB,MAAM,CAAC,sBAAsB,CAAC,OAAe;QAClD,MAAM,WAAW,GAAgB,mBAAmB,CAAC,eAAe,EAAE,CAAC;QACvE,IAAI,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACxD,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,OAAO,+BAA+B,WAAW,UAAU,CACrG,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,OAAO,CACnB,eAAuB,EACvB,eAAqD,EACrD,OAAuB;QAEvB,MAAM,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC;QAEjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,2EAA2E;YAC3E,mBAAmB,CAAC,cAAc,CAAC,8DAA8D,CAAC,CAAC;QACrG,CAAC;QAED,MAAM,WAAW,GAAgB,mBAAmB,CAAC,eAAe,EAAE,CAAC;QAEvE,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACzB,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,IAAI,CAAC,OAAO,EAAE;oBACrD,iDAAiD,CACpD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE;gBACnC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,8BAA8B,EAAE,OAAO,CAAC,8BAA8B;aACvE,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtB,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,IAAI,CAAC,OAAO,EAAE;oBACrD,6CAA6C,CAChD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,OAAe;QAC3C,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,eAAe;QAC5B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7B,WAAW;YACX,iDAAiD;YACjD,mFAAmF;YACnF,MAAM,QAAQ,GAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACtE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO,WAAW,CAAC;YACrB,CAAC;YACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\n\nimport type { ILaunchOptions } from '@microsoft/rush-lib/lib/index';\nimport { Colorize } from '@rushstack/terminal';\n\ntype CommandName = 'rush' | 'rush-pnpm' | 'rushx' | undefined;\n\n/**\n * Both \"rush\" and \"rushx\" share the same src/start.ts entry point.  This makes it\n * a little easier for them to share all the same startup checks and version selector\n * logic.  RushCommandSelector looks at argv to determine whether we're doing \"rush\"\n * or \"rushx\" behavior, and then invokes the appropriate entry point in the selected\n * @microsoft/rush-lib.\n */\nexport class RushCommandSelector {\n  public static failIfNotInvokedAsRush(version: string): void {\n    const commandName: CommandName = RushCommandSelector._getCommandName();\n    if (commandName !== 'rush' && commandName !== undefined) {\n      RushCommandSelector._failWithError(\n        `This repository is using Rush version ${version} which does not support the ${commandName} command`\n      );\n    }\n  }\n\n  public static execute(\n    launcherVersion: string,\n    selectedRushLib: typeof import('@microsoft/rush-lib'),\n    options: ILaunchOptions\n  ): void {\n    const { Rush } = selectedRushLib;\n\n    if (!Rush) {\n      // This should be impossible unless we somehow loaded an unexpected version\n      RushCommandSelector._failWithError(`Unable to find the \"Rush\" entry point in @microsoft/rush-lib`);\n    }\n\n    const commandName: CommandName = RushCommandSelector._getCommandName();\n\n    if (commandName === 'rush-pnpm') {\n      if (!Rush.launchRushPnpm) {\n        RushCommandSelector._failWithError(\n          `This repository is using Rush version ${Rush.version}` +\n            ` which does not support the \"rush-pnpm\" command`\n        );\n      }\n      Rush.launchRushPnpm(launcherVersion, {\n        isManaged: options.isManaged,\n        alreadyReportedNodeTooNewError: options.alreadyReportedNodeTooNewError\n      });\n    } else if (commandName === 'rushx') {\n      if (!Rush.launchRushX) {\n        RushCommandSelector._failWithError(\n          `This repository is using Rush version ${Rush.version}` +\n            ` which does not support the \"rushx\" command`\n        );\n      }\n      Rush.launchRushX(launcherVersion, options);\n    } else {\n      Rush.launch(launcherVersion, options);\n    }\n  }\n\n  private static _failWithError(message: string): never {\n    console.log(Colorize.red(message));\n    return process.exit(1);\n  }\n\n  private static _getCommandName(): CommandName {\n    if (process.argv.length >= 2) {\n      // Example:\n      // argv[0]: \"C:\\\\Program Files\\\\nodejs\\\\node.exe\"\n      // argv[1]: \"C:\\\\Program Files\\\\nodejs\\\\node_modules\\\\@microsoft\\\\rush\\\\bin\\\\rushx\"\n      const basename: string = path.basename(process.argv[1]).toUpperCase();\n      if (basename === 'RUSH') {\n        return 'rush';\n      }\n      if (basename === 'RUSH-PNPM') {\n        return 'rush-pnpm';\n      }\n      if (basename === 'RUSHX') {\n        return 'rushx';\n      }\n    }\n    return undefined;\n  }\n}\n"]}

package/lib-esm/RushVersionSelector.js

@@ -0,0 +1,80 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import * as path from 'node:path';
+import * as semver from 'semver';
+import { LockFile, Import } from '@rushstack/node-core-library';
+import { Utilities } from '@microsoft/rush-lib/lib/utilities/Utilities';
+import { _FlagFile, _RushGlobalFolder } from '@microsoft/rush-lib';
+import { RushCommandSelector } from './RushCommandSelector';
+const MAX_INSTALL_ATTEMPTS = 3;
+export class RushVersionSelector {
+    constructor(currentPackageVersion) {
+        this._rushGlobalFolder = new _RushGlobalFolder();
+        this._currentPackageVersion = currentPackageVersion;
+    }
+    async ensureRushVersionInstalledAsync(version, configuration, executeOptions) {
+        const isLegacyRushVersion = semver.lt(version, '4.0.0');
+        const expectedRushPath = path.join(this._rushGlobalFolder.nodeSpecificPath, `rush-${version}`);
+        const installMarker = new _FlagFile(expectedRushPath, 'last-install', {
+            node: process.versions.node
+        });
+        let installIsValid = await installMarker.isValidAsync();
+        if (!installIsValid) {
+            // Need to install Rush
+            console.log(`Rush version ${version} is not currently installed. Installing...`);
+            const resourceName = `rush-${version}`;
+            console.log(`Trying to acquire lock for ${resourceName}`);
+            const lock = await LockFile.acquireAsync(expectedRushPath, resourceName);
+            installIsValid = await installMarker.isValidAsync();
+            if (installIsValid) {
+                console.log('Another process performed the installation.');
+            }
+            else {
+                await Utilities.installPackageInDirectoryAsync({
+                    directory: expectedRushPath,
+                    packageName: isLegacyRushVersion ? '@microsoft/rush' : '@microsoft/rush-lib',
+                    version: version,
+                    tempPackageTitle: 'rush-local-install',
+                    maxInstallAttempts: MAX_INSTALL_ATTEMPTS,
+                    // This is using a local configuration to install a package in a shared global location.
+                    // Generally that's a bad practice, but in this case if we can successfully install
+                    // the package at all, we can reasonably assume it's good for all the repositories.
+                    // In particular, we'll assume that two different NPM registries cannot have two
+                    // different implementations of the same version of the same package.
+                    // This was needed for: https://github.com/microsoft/rushstack/issues/691
+                    commonRushConfigFolder: configuration ? configuration.commonRushConfigFolder : undefined,
+                    suppressOutput: true
+                });
+                console.log(`Successfully installed Rush version ${version} in ${expectedRushPath}.`);
+                // If we've made it here without exception, write the flag file
+                await installMarker.createAsync();
+                lock.release();
+            }
+        }
+        if (semver.lt(version, '3.0.20')) {
+            // In old versions, requiring the entry point invoked the command-line parser immediately,
+            // so fail if "rushx" or "rush-pnpm" was used
+            RushCommandSelector.failIfNotInvokedAsRush(version);
+            require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'rush'));
+        }
+        else if (semver.lt(version, '4.0.0')) {
+            // In old versions, requiring the entry point invoked the command-line parser immediately,
+            // so fail if "rushx" or "rush-pnpm" was used
+            RushCommandSelector.failIfNotInvokedAsRush(version);
+            require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'start'));
+        }
+        else {
+            // Explicitly resolve the entry point for rush-lib, rather than using a simple require, because
+            // newer versions of rush-lib use the package.json `exports` field, which maps
+            // `lib/index` to `lib-commonjs/index.js`
+            const rushLibEntrypoint = await Import.resolveModuleAsync({
+                modulePath: '@microsoft/rush-lib/lib/index',
+                baseFolderPath: expectedRushPath
+            });
+            const rushCliEntrypoint = require(rushLibEntrypoint);
+            // For newer rush-lib, RushCommandSelector can test whether "rushx" is supported or not
+            RushCommandSelector.execute(this._currentPackageVersion, rushCliEntrypoint, executeOptions);
+        }
+    }
+}
+//# sourceMappingURL=RushVersionSelector.js.map

package/lib-esm/RushVersionSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RushVersionSelector.js","sourceRoot":"","sources":["../src/RushVersionSelector.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\n\nimport * as semver from 'semver';\n\nimport { LockFile, Import } from '@rushstack/node-core-library';\nimport { Utilities } from '@microsoft/rush-lib/lib/utilities/Utilities';\nimport { _FlagFile, _RushGlobalFolder, type ILaunchOptions } from '@microsoft/rush-lib';\n\nimport { RushCommandSelector } from './RushCommandSelector';\nimport type { MinimalRushConfiguration } from './MinimalRushConfiguration';\n\nconst MAX_INSTALL_ATTEMPTS: number = 3;\n\nexport class RushVersionSelector {\n  private _rushGlobalFolder: _RushGlobalFolder;\n  private _currentPackageVersion: string;\n\n  public constructor(currentPackageVersion: string) {\n    this._rushGlobalFolder = new _RushGlobalFolder();\n    this._currentPackageVersion = currentPackageVersion;\n  }\n\n  public async ensureRushVersionInstalledAsync(\n    version: string,\n    configuration: MinimalRushConfiguration | undefined,\n    executeOptions: ILaunchOptions\n  ): Promise<void> {\n    const isLegacyRushVersion: boolean = semver.lt(version, '4.0.0');\n    const expectedRushPath: string = path.join(this._rushGlobalFolder.nodeSpecificPath, `rush-${version}`);\n\n    const installMarker: _FlagFile = new _FlagFile(expectedRushPath, 'last-install', {\n      node: process.versions.node\n    });\n\n    let installIsValid: boolean = await installMarker.isValidAsync();\n    if (!installIsValid) {\n      // Need to install Rush\n      console.log(`Rush version ${version} is not currently installed. Installing...`);\n\n      const resourceName: string = `rush-${version}`;\n\n      console.log(`Trying to acquire lock for ${resourceName}`);\n\n      const lock: LockFile = await LockFile.acquireAsync(expectedRushPath, resourceName);\n      installIsValid = await installMarker.isValidAsync();\n      if (installIsValid) {\n        console.log('Another process performed the installation.');\n      } else {\n        await Utilities.installPackageInDirectoryAsync({\n          directory: expectedRushPath,\n          packageName: isLegacyRushVersion ? '@microsoft/rush' : '@microsoft/rush-lib',\n          version: version,\n          tempPackageTitle: 'rush-local-install',\n          maxInstallAttempts: MAX_INSTALL_ATTEMPTS,\n          // This is using a local configuration to install a package in a shared global location.\n          // Generally that's a bad practice, but in this case if we can successfully install\n          // the package at all, we can reasonably assume it's good for all the repositories.\n          // In particular, we'll assume that two different NPM registries cannot have two\n          // different implementations of the same version of the same package.\n          // This was needed for: https://github.com/microsoft/rushstack/issues/691\n          commonRushConfigFolder: configuration ? configuration.commonRushConfigFolder : undefined,\n          suppressOutput: true\n        });\n\n        console.log(`Successfully installed Rush version ${version} in ${expectedRushPath}.`);\n\n        // If we've made it here without exception, write the flag file\n        await installMarker.createAsync();\n\n        lock.release();\n      }\n    }\n\n    if (semver.lt(version, '3.0.20')) {\n      // In old versions, requiring the entry point invoked the command-line parser immediately,\n      // so fail if \"rushx\" or \"rush-pnpm\" was used\n      RushCommandSelector.failIfNotInvokedAsRush(version);\n      require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'rush'));\n    } else if (semver.lt(version, '4.0.0')) {\n      // In old versions, requiring the entry point invoked the command-line parser immediately,\n      // so fail if \"rushx\" or \"rush-pnpm\" was used\n      RushCommandSelector.failIfNotInvokedAsRush(version);\n      require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'start'));\n    } else {\n      // Explicitly resolve the entry point for rush-lib, rather than using a simple require, because\n      // newer versions of rush-lib use the package.json `exports` field, which maps\n      // `lib/index` to `lib-commonjs/index.js`\n      const rushLibEntrypoint: string = await Import.resolveModuleAsync({\n        modulePath: '@microsoft/rush-lib/lib/index',\n        baseFolderPath: expectedRushPath\n      });\n      const rushCliEntrypoint: typeof import('@microsoft/rush-lib') = require(rushLibEntrypoint);\n      // For newer rush-lib, RushCommandSelector can test whether \"rushx\" is supported or not\n      RushCommandSelector.execute(this._currentPackageVersion, rushCliEntrypoint, executeOptions);\n    }\n  }\n}\n"]}

package/lib-esm/start.js

@@ -0,0 +1,72 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+// We're using a path-based import here to minimize the amount of code that is evaluated before
+// we check to see if the Node.js version is too old. If, for whatever reason, Rush crashes with
+// an old Node.js version when evaluating one of the more complex imports, we'll at least
+// shown a meaningful error message.
+// eslint-disable-next-line import/order
+import { NodeJsCompatibility } from '@microsoft/rush-lib/lib/logic/NodeJsCompatibility';
+if (NodeJsCompatibility.reportAncientIncompatibleVersion()) {
+    // The Node.js version is known to have serious incompatibilities.  In that situation, the user
+    // should downgrade Rush to an older release that supported their Node.js version.
+    process.exit(1);
+}
+const alreadyReportedNodeTooNewError = NodeJsCompatibility.warnAboutVersionTooNew({
+    isRushLib: false,
+    alreadyReportedNodeTooNewError: false
+});
+import * as os from 'node:os';
+import * as semver from 'semver';
+import { Text, PackageJsonLookup } from '@rushstack/node-core-library';
+import { Colorize, ConsoleTerminalProvider } from '@rushstack/terminal';
+import { EnvironmentVariableNames } from '@microsoft/rush-lib';
+import * as rushLib from '@microsoft/rush-lib';
+import { RushCommandSelector } from './RushCommandSelector';
+import { RushVersionSelector } from './RushVersionSelector';
+import { MinimalRushConfiguration } from './MinimalRushConfiguration';
+// Load the configuration
+const configuration = MinimalRushConfiguration.loadFromDefaultLocation();
+const currentPackageVersion = PackageJsonLookup.loadOwnPackageJson(__dirname).version;
+let rushVersionToLoad = undefined;
+const previewVersion = process.env[EnvironmentVariableNames.RUSH_PREVIEW_VERSION];
+if (previewVersion) {
+    if (!semver.valid(previewVersion, false)) {
+        console.error(Colorize.red(`Invalid value for RUSH_PREVIEW_VERSION environment variable: "${previewVersion}"`));
+        process.exit(1);
+    }
+    rushVersionToLoad = previewVersion;
+    const lines = [];
+    lines.push(`*********************************************************************`, `* WARNING! THE "RUSH_PREVIEW_VERSION" ENVIRONMENT VARIABLE IS SET.  *`, `*                                                                   *`, `* You are previewing Rush version:        ${Text.padEnd(previewVersion, 25)} *`);
+    if (configuration) {
+        lines.push(`* The rush.json configuration asks for:   ${Text.padEnd(configuration.rushVersion, 25)} *`);
+    }
+    lines.push(`*                                                                   *`, `* To restore the normal behavior, unset the RUSH_PREVIEW_VERSION    *`, `* environment variable.                                             *`, `*********************************************************************`);
+    console.error(lines.map((line) => Colorize.black(Colorize.yellowBackground(line))).join(os.EOL));
+}
+else if (configuration) {
+    rushVersionToLoad = configuration.rushVersion;
+}
+// If we are previewing an older Rush that doesn't understand the RUSH_PREVIEW_VERSION variable,
+// then unset it.
+if (rushVersionToLoad && semver.lt(rushVersionToLoad, '5.0.0-dev.18')) {
+    delete process.env[EnvironmentVariableNames.RUSH_PREVIEW_VERSION];
+}
+// Rush is "managed" if its version and configuration are dictated by a repo's rush.json
+const isManaged = !!configuration;
+const terminalProvider = new ConsoleTerminalProvider();
+const launchOptions = { isManaged, alreadyReportedNodeTooNewError, terminalProvider };
+// If we're inside a repo folder, and it's requesting a different version, then use the RushVersionManager to
+// install it
+if (rushVersionToLoad && rushVersionToLoad !== currentPackageVersion) {
+    const versionSelector = new RushVersionSelector(currentPackageVersion);
+    versionSelector
+        .ensureRushVersionInstalledAsync(rushVersionToLoad, configuration, launchOptions)
+        .catch((error) => {
+        console.log(Colorize.red('Error: ' + error.message));
+    });
+}
+else {
+    // Otherwise invoke the rush-lib that came with this rush package
+    RushCommandSelector.execute(currentPackageVersion, rushLib, launchOptions);
+}
+//# sourceMappingURL=start.js.map

package/lib-esm/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n// We're using a path-based import here to minimize the amount of code that is evaluated before\n// we check to see if the Node.js version is too old. If, for whatever reason, Rush crashes with\n// an old Node.js version when evaluating one of the more complex imports, we'll at least\n// shown a meaningful error message.\n// eslint-disable-next-line import/order\nimport { NodeJsCompatibility } from '@microsoft/rush-lib/lib/logic/NodeJsCompatibility';\n\nif (NodeJsCompatibility.reportAncientIncompatibleVersion()) {\n  // The Node.js version is known to have serious incompatibilities.  In that situation, the user\n  // should downgrade Rush to an older release that supported their Node.js version.\n  process.exit(1);\n}\n\nconst alreadyReportedNodeTooNewError: boolean = NodeJsCompatibility.warnAboutVersionTooNew({\n  isRushLib: false,\n  alreadyReportedNodeTooNewError: false\n});\n\nimport * as os from 'node:os';\n\nimport * as semver from 'semver';\n\nimport { Text, PackageJsonLookup } from '@rushstack/node-core-library';\nimport { Colorize, ConsoleTerminalProvider, type ITerminalProvider } from '@rushstack/terminal';\nimport { EnvironmentVariableNames } from '@microsoft/rush-lib';\nimport type { ILaunchOptions } from '@microsoft/rush-lib';\nimport * as rushLib from '@microsoft/rush-lib';\n\nimport { RushCommandSelector } from './RushCommandSelector';\nimport { RushVersionSelector } from './RushVersionSelector';\nimport { MinimalRushConfiguration } from './MinimalRushConfiguration';\n\n// Load the configuration\nconst configuration: MinimalRushConfiguration | undefined =\n  MinimalRushConfiguration.loadFromDefaultLocation();\n\nconst currentPackageVersion: string = PackageJsonLookup.loadOwnPackageJson(__dirname).version;\n\nlet rushVersionToLoad: string | undefined = undefined;\n\nconst previewVersion: string | undefined = process.env[EnvironmentVariableNames.RUSH_PREVIEW_VERSION];\n\nif (previewVersion) {\n  if (!semver.valid(previewVersion, false)) {\n    console.error(\n      Colorize.red(`Invalid value for RUSH_PREVIEW_VERSION environment variable: \"${previewVersion}\"`)\n    );\n    process.exit(1);\n  }\n\n  rushVersionToLoad = previewVersion;\n\n  const lines: string[] = [];\n  lines.push(\n    `*********************************************************************`,\n    `* WARNING! THE \"RUSH_PREVIEW_VERSION\" ENVIRONMENT VARIABLE IS SET.  *`,\n    `*                                                                   *`,\n    `* You are previewing Rush version:        ${Text.padEnd(previewVersion, 25)} *`\n  );\n\n  if (configuration) {\n    lines.push(`* The rush.json configuration asks for:   ${Text.padEnd(configuration.rushVersion, 25)} *`);\n  }\n\n  lines.push(\n    `*                                                                   *`,\n    `* To restore the normal behavior, unset the RUSH_PREVIEW_VERSION    *`,\n    `* environment variable.                                             *`,\n    `*********************************************************************`\n  );\n\n  console.error(lines.map((line) => Colorize.black(Colorize.yellowBackground(line))).join(os.EOL));\n} else if (configuration) {\n  rushVersionToLoad = configuration.rushVersion;\n}\n\n// If we are previewing an older Rush that doesn't understand the RUSH_PREVIEW_VERSION variable,\n// then unset it.\nif (rushVersionToLoad && semver.lt(rushVersionToLoad, '5.0.0-dev.18')) {\n  delete process.env[EnvironmentVariableNames.RUSH_PREVIEW_VERSION];\n}\n\n// Rush is \"managed\" if its version and configuration are dictated by a repo's rush.json\nconst isManaged: boolean = !!configuration;\n\nconst terminalProvider: ITerminalProvider = new ConsoleTerminalProvider();\n\nconst launchOptions: ILaunchOptions = { isManaged, alreadyReportedNodeTooNewError, terminalProvider };\n\n// If we're inside a repo folder, and it's requesting a different version, then use the RushVersionManager to\n// install it\nif (rushVersionToLoad && rushVersionToLoad !== currentPackageVersion) {\n  const versionSelector: RushVersionSelector = new RushVersionSelector(currentPackageVersion);\n  versionSelector\n    .ensureRushVersionInstalledAsync(rushVersionToLoad, configuration, launchOptions)\n    .catch((error: Error) => {\n      console.log(Colorize.red('Error: ' + error.message));\n    });\n} else {\n  // Otherwise invoke the rush-lib that came with this rush package\n  RushCommandSelector.execute(currentPackageVersion, rushLib, launchOptions);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/rush",
-  "version": "5.167.0",
+  "version": "5.169.0",
   "description": "A professional solution for consolidating all your JavaScript projects in one Git repo",
   "keywords": [
     "install",
@@ -31,20 +31,39 @@
   "license": "MIT",
   "dependencies": {
     "semver": "~7.5.4",
-    "@microsoft/rush-lib": "5.167.0",
-    "@rushstack/terminal": "0.21.0",
-    "@rushstack/node-core-library": "5.19.1"
+    "@microsoft/rush-lib": "5.169.0",
+    "@rushstack/terminal": "0.22.0",
+    "@rushstack/node-core-library": "5.20.0"
   },
   "devDependencies": {
     "eslint": "~9.37.0",
     "@types/heft-jest": "1.0.1",
     "@types/semver": "7.5.0",
-    "@rushstack/heft": "1.1.13",
+    "@rushstack/heft": "1.2.0",
     "local-node-rig": "1.0.0",
-    "@rushstack/rush-amazon-s3-build-cache-plugin": "5.167.0",
-    "@rushstack/rush-http-build-cache-plugin": "5.167.0",
-    "@rushstack/rush-azure-storage-build-cache-plugin": "5.167.0"
+    "@rushstack/rush-amazon-s3-build-cache-plugin": "5.169.0",
+    "@rushstack/rush-azure-storage-build-cache-plugin": "5.169.0",
+    "@rushstack/rush-http-build-cache-plugin": "5.169.0"
   },
+  "exports": {
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
+  "sideEffects": [
+    "lib-commonjs/start.js",
+    "lib-esm/start.js"
+  ],
   "scripts": {
     "build": "heft build --clean",
     "start": "node lib/start-dev-docs.js",

package/lib/RushCommandSelector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RushCommandSelector.d.ts","sourceRoot":"","sources":["../src/RushCommandSelector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAKpD;;;;;;GAMG;AACH,qBAAa,mBAAmB;WAChB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;WAS7C,OAAO,CACnB,eAAe,EAAE,MAAM,EAEvB,eAAe,EAAE,GAAG,EACpB,OAAO,EAAE,OAAO,CAAC,cAAc,GAC9B,IAAI;IAkCP,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B,OAAO,CAAC,MAAM,CAAC,eAAe;CAkB/B"}

package/lib/RushCommandSelector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RushCommandSelector.js","sourceRoot":"","sources":["../src/RushCommandSelector.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,gDAAkC;AAGlC,kDAA+C;AAI/C;;;;;;GAMG;AACH,MAAa,mBAAmB;IACvB,MAAM,CAAC,sBAAsB,CAAC,OAAe;QAClD,MAAM,WAAW,GAAgB,mBAAmB,CAAC,eAAe,EAAE,CAAC;QACvE,IAAI,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACxD,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,OAAO,+BAA+B,WAAW,UAAU,CACrG,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,OAAO,CACnB,eAAuB;IACvB,8DAA8D;IAC9D,eAAoB,EACpB,OAA+B;QAE/B,MAAM,IAAI,GAAwB,eAAe,CAAC,IAAI,CAAC;QAEvD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,2EAA2E;YAC3E,mBAAmB,CAAC,cAAc,CAAC,8DAA8D,CAAC,CAAC;QACrG,CAAC;QAED,MAAM,WAAW,GAAgB,mBAAmB,CAAC,eAAe,EAAE,CAAC;QAEvE,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACzB,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,IAAI,CAAC,OAAO,EAAE;oBACrD,iDAAiD,CACpD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE;gBACnC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,8BAA8B,EAAE,OAAO,CAAC,8BAA8B;aACvE,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtB,mBAAmB,CAAC,cAAc,CAChC,yCAAyC,IAAI,CAAC,OAAO,EAAE;oBACrD,6CAA6C,CAChD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,OAAe;QAC3C,OAAO,CAAC,GAAG,CAAC,mBAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,eAAe;QAC5B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7B,WAAW;YACX,iDAAiD;YACjD,mFAAmF;YACnF,MAAM,QAAQ,GAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACtE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO,WAAW,CAAC;YACrB,CAAC;YACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAxED,kDAwEC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\n\nimport type * as rushLib from '@microsoft/rush-lib';\nimport { Colorize } from '@rushstack/terminal';\n\ntype CommandName = 'rush' | 'rush-pnpm' | 'rushx' | undefined;\n\n/**\n * Both \"rush\" and \"rushx\" share the same src/start.ts entry point.  This makes it\n * a little easier for them to share all the same startup checks and version selector\n * logic.  RushCommandSelector looks at argv to determine whether we're doing \"rush\"\n * or \"rushx\" behavior, and then invokes the appropriate entry point in the selected\n * @microsoft/rush-lib.\n */\nexport class RushCommandSelector {\n  public static failIfNotInvokedAsRush(version: string): void {\n    const commandName: CommandName = RushCommandSelector._getCommandName();\n    if (commandName !== 'rush' && commandName !== undefined) {\n      RushCommandSelector._failWithError(\n        `This repository is using Rush version ${version} which does not support the ${commandName} command`\n      );\n    }\n  }\n\n  public static execute(\n    launcherVersion: string,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    selectedRushLib: any,\n    options: rushLib.ILaunchOptions\n  ): void {\n    const Rush: typeof rushLib.Rush = selectedRushLib.Rush;\n\n    if (!Rush) {\n      // This should be impossible unless we somehow loaded an unexpected version\n      RushCommandSelector._failWithError(`Unable to find the \"Rush\" entry point in @microsoft/rush-lib`);\n    }\n\n    const commandName: CommandName = RushCommandSelector._getCommandName();\n\n    if (commandName === 'rush-pnpm') {\n      if (!Rush.launchRushPnpm) {\n        RushCommandSelector._failWithError(\n          `This repository is using Rush version ${Rush.version}` +\n            ` which does not support the \"rush-pnpm\" command`\n        );\n      }\n      Rush.launchRushPnpm(launcherVersion, {\n        isManaged: options.isManaged,\n        alreadyReportedNodeTooNewError: options.alreadyReportedNodeTooNewError\n      });\n    } else if (commandName === 'rushx') {\n      if (!Rush.launchRushX) {\n        RushCommandSelector._failWithError(\n          `This repository is using Rush version ${Rush.version}` +\n            ` which does not support the \"rushx\" command`\n        );\n      }\n      Rush.launchRushX(launcherVersion, options);\n    } else {\n      Rush.launch(launcherVersion, options);\n    }\n  }\n\n  private static _failWithError(message: string): never {\n    console.log(Colorize.red(message));\n    return process.exit(1);\n  }\n\n  private static _getCommandName(): CommandName {\n    if (process.argv.length >= 2) {\n      // Example:\n      // argv[0]: \"C:\\\\Program Files\\\\nodejs\\\\node.exe\"\n      // argv[1]: \"C:\\\\Program Files\\\\nodejs\\\\node_modules\\\\@microsoft\\\\rush\\\\bin\\\\rushx\"\n      const basename: string = path.basename(process.argv[1]).toUpperCase();\n      if (basename === 'RUSH') {\n        return 'rush';\n      }\n      if (basename === 'RUSH-PNPM') {\n        return 'rush-pnpm';\n      }\n      if (basename === 'RUSHX') {\n        return 'rushx';\n      }\n    }\n    return undefined;\n  }\n}\n"]}

package/lib/RushVersionSelector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RushVersionSelector.js","sourceRoot":"","sources":["../src/RushVersionSelector.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,gDAAkC;AAElC,+CAAiC;AAEjC,oEAAwD;AACxD,2EAAwE;AACxE,kDAAwF;AAExF,+DAA4D;AAG5D,MAAM,oBAAoB,GAAW,CAAC,CAAC;AAEvC,MAAa,mBAAmB;IAI9B,YAAmB,qBAA6B;QAC9C,IAAI,CAAC,iBAAiB,GAAG,IAAI,4BAAiB,EAAE,CAAC;QACjD,IAAI,CAAC,sBAAsB,GAAG,qBAAqB,CAAC;IACtD,CAAC;IAEM,KAAK,CAAC,+BAA+B,CAC1C,OAAe,EACf,aAAmD,EACnD,cAA8B;QAE9B,MAAM,mBAAmB,GAAY,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,gBAAgB,GAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,QAAQ,OAAO,EAAE,CAAC,CAAC;QAEvG,MAAM,aAAa,GAAc,IAAI,oBAAS,CAAC,gBAAgB,EAAE,cAAc,EAAE;YAC/E,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;SAC5B,CAAC,CAAC;QAEH,IAAI,cAAc,GAAY,MAAM,aAAa,CAAC,YAAY,EAAE,CAAC;QACjE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,uBAAuB;YACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,4CAA4C,CAAC,CAAC;YAEjF,MAAM,YAAY,GAAW,QAAQ,OAAO,EAAE,CAAC;YAE/C,OAAO,CAAC,GAAG,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;YAE1D,MAAM,IAAI,GAAa,MAAM,4BAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;YAC9E,cAAc,GAAG,MAAM,aAAa,CAAC,YAAY,EAAE,CAAC;YACpD,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,MAAM,qBAAS,CAAC,8BAA8B,CAAC;oBAC7C,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,qBAAqB;oBAC5E,OAAO,EAAE,OAAO;oBAChB,gBAAgB,EAAE,oBAAoB;oBACtC,kBAAkB,EAAE,oBAAoB;oBACxC,wFAAwF;oBACxF,mFAAmF;oBACnF,mFAAmF;oBACnF,gFAAgF;oBAChF,qEAAqE;oBACrE,yEAAyE;oBACzE,sBAAsB,EAAE,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC,SAAS;oBACxF,cAAc,EAAE,IAAI;iBACrB,CAAC,CAAC;gBAEH,OAAO,CAAC,GAAG,CAAC,uCAAuC,OAAO,OAAO,gBAAgB,GAAG,CAAC,CAAC;gBAEtF,+DAA+D;gBAC/D,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC;gBAElC,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACjC,0FAA0F;YAC1F,6CAA6C;YAC7C,yCAAmB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5F,CAAC;aAAM,IAAI,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YACvC,0FAA0F;YAC1F,6CAA6C;YAC7C,yCAAmB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,uFAAuF;YACvF,MAAM,iBAAiB,GAAO,OAAO,CACnC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CACtF,CAAC;YACF,yCAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;CACF;AA9ED,kDA8EC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\n\nimport * as semver from 'semver';\n\nimport { LockFile } from '@rushstack/node-core-library';\nimport { Utilities } from '@microsoft/rush-lib/lib/utilities/Utilities';\nimport { _FlagFile, _RushGlobalFolder, type ILaunchOptions } from '@microsoft/rush-lib';\n\nimport { RushCommandSelector } from './RushCommandSelector';\nimport type { MinimalRushConfiguration } from './MinimalRushConfiguration';\n\nconst MAX_INSTALL_ATTEMPTS: number = 3;\n\nexport class RushVersionSelector {\n  private _rushGlobalFolder: _RushGlobalFolder;\n  private _currentPackageVersion: string;\n\n  public constructor(currentPackageVersion: string) {\n    this._rushGlobalFolder = new _RushGlobalFolder();\n    this._currentPackageVersion = currentPackageVersion;\n  }\n\n  public async ensureRushVersionInstalledAsync(\n    version: string,\n    configuration: MinimalRushConfiguration | undefined,\n    executeOptions: ILaunchOptions\n  ): Promise<void> {\n    const isLegacyRushVersion: boolean = semver.lt(version, '4.0.0');\n    const expectedRushPath: string = path.join(this._rushGlobalFolder.nodeSpecificPath, `rush-${version}`);\n\n    const installMarker: _FlagFile = new _FlagFile(expectedRushPath, 'last-install', {\n      node: process.versions.node\n    });\n\n    let installIsValid: boolean = await installMarker.isValidAsync();\n    if (!installIsValid) {\n      // Need to install Rush\n      console.log(`Rush version ${version} is not currently installed. Installing...`);\n\n      const resourceName: string = `rush-${version}`;\n\n      console.log(`Trying to acquire lock for ${resourceName}`);\n\n      const lock: LockFile = await LockFile.acquire(expectedRushPath, resourceName);\n      installIsValid = await installMarker.isValidAsync();\n      if (installIsValid) {\n        console.log('Another process performed the installation.');\n      } else {\n        await Utilities.installPackageInDirectoryAsync({\n          directory: expectedRushPath,\n          packageName: isLegacyRushVersion ? '@microsoft/rush' : '@microsoft/rush-lib',\n          version: version,\n          tempPackageTitle: 'rush-local-install',\n          maxInstallAttempts: MAX_INSTALL_ATTEMPTS,\n          // This is using a local configuration to install a package in a shared global location.\n          // Generally that's a bad practice, but in this case if we can successfully install\n          // the package at all, we can reasonably assume it's good for all the repositories.\n          // In particular, we'll assume that two different NPM registries cannot have two\n          // different implementations of the same version of the same package.\n          // This was needed for: https://github.com/microsoft/rushstack/issues/691\n          commonRushConfigFolder: configuration ? configuration.commonRushConfigFolder : undefined,\n          suppressOutput: true\n        });\n\n        console.log(`Successfully installed Rush version ${version} in ${expectedRushPath}.`);\n\n        // If we've made it here without exception, write the flag file\n        await installMarker.createAsync();\n\n        lock.release();\n      }\n    }\n\n    if (semver.lt(version, '3.0.20')) {\n      // In old versions, requiring the entry point invoked the command-line parser immediately,\n      // so fail if \"rushx\" or \"rush-pnpm\" was used\n      RushCommandSelector.failIfNotInvokedAsRush(version);\n      require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'rush'));\n    } else if (semver.lt(version, '4.0.0')) {\n      // In old versions, requiring the entry point invoked the command-line parser immediately,\n      // so fail if \"rushx\" or \"rush-pnpm\" was used\n      RushCommandSelector.failIfNotInvokedAsRush(version);\n      require(path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush', 'lib', 'start'));\n    } else {\n      // For newer rush-lib, RushCommandSelector can test whether \"rushx\" is supported or not\n      const rushCliEntrypoint: {} = require(\n        path.join(expectedRushPath, 'node_modules', '@microsoft', 'rush-lib', 'lib', 'index')\n      );\n      RushCommandSelector.execute(this._currentPackageVersion, rushCliEntrypoint, executeOptions);\n    }\n  }\n}\n"]}