@rushstack/rush-sdk 5.107.4 → 5.109.0

package/dist/rush-lib.d.ts

@@ -771,11 +771,16 @@ export declare const EnvironmentVariableNames: {
      * Explicitly specifies the path for the `tar` binary that is invoked by certain Rush operations.
      */
     readonly RUSH_TAR_BINARY_PATH: "RUSH_TAR_BINARY_PATH";
+    /**
+     * Internal variable used by `rushx` when recursively invoking another `rushx` process, to avoid
+     * nesting event hooks.
+     */
+    readonly _RUSH_RECURSIVE_RUSHX_CALL: "_RUSH_RECURSIVE_RUSHX_CALL";
     /**
      * Internal variable that explicitly specifies the path for the version of `@microsoft/rush-lib` being executed.
      * Will be set upon loading Rush.
      */
-    readonly RUSH_LIB_PATH: "_RUSH_LIB_PATH";
+    readonly _RUSH_LIB_PATH: "_RUSH_LIB_PATH";
     /**
      * When Rush executes shell scripts, it sometimes changes the working directory to be a project folder or
      * the repository root folder.  The original working directory (where the Rush command was invoked) is assigned
@@ -786,6 +791,16 @@ export declare const EnvironmentVariableNames: {
      * assign when they execute lifecycle scripts.
      */
     readonly RUSH_INVOKED_FOLDER: "RUSH_INVOKED_FOLDER";
+    /**
+     * When running a hook script, this environment variable communicates the original arguments
+     * passed to the `rush` or `rushx` command.
+     *
+     * @remarks
+     * Unlike `RUSH_INVOKED_FOLDER`, the `RUSH_INVOKED_ARGS` variable is only available for hook scripts.
+     * Other lifecycle scripts should not make assumptions about Rush's command line syntax
+     * if Rush did not explicitly pass along command-line parameters to their process.
+     */
+    readonly RUSH_INVOKED_ARGS: "RUSH_INVOKED_ARGS";
 };
 
 /**
@@ -808,7 +823,15 @@ declare enum Event_2 {
     /**
      * Post Rush build event
      */
-    postRushBuild = 4
+    postRushBuild = 4,
+    /**
+     * Start of rushx execution event
+     */
+    preRushx = 5,
+    /**
+     * End of rushx execution event
+     */
+    postRushx = 6
 }
 export { Event_2 as Event }
 
@@ -1381,15 +1404,22 @@ export declare interface ILaunchOptions {
      */
     alreadyReportedNodeTooNewError?: boolean;
     /**
-     * Used to specify Rush plugins that are dependencies of the "\@microsoft/rush" package.
+     * Pass along the terminal provider from the CLI version selector.
      *
-     * @internal
+     * @privateRemarks
+     * We should remove this.  The version selector package can be very old.  It's unwise for
+     * `rush-lib` to rely on a potentially ancient `ITerminalProvider` implementation.
      */
-    builtInPluginConfigurations?: _IBuiltInPluginConfiguration[];
+    terminalProvider?: ITerminalProvider;
     /**
-     * Used to specify terminal how to write a message
+     * Used only by `@microsoft/rush/lib/start-dev.js` during development.
+     * Specifies Rush devDependencies of the `@microsoft/rush` to be manually loaded.
+     *
+     * @remarks
+     * Marked as `@internal` because `IBuiltInPluginConfiguration` is internal.
+     * @internal
      */
-    terminalProvider?: ITerminalProvider;
+    builtInPluginConfigurations?: _IBuiltInPluginConfiguration[];
 }
 
 /**
@@ -1851,6 +1881,10 @@ export declare interface _IPnpmOptionsJson extends IPackageManagerOptionsJsonBas
      * {@inheritDoc PnpmOptionsConfiguration.resolutionMode}
      */
     resolutionMode?: PnpmResolutionMode;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.autoInstallPeers}
+     */
+    autoInstallPeers?: boolean;
 }
 
 declare interface IPnpmPackageExtension {
@@ -2917,6 +2951,13 @@ export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfi
      * The default value is true.  (For now.)
      */
     readonly useWorkspaces: boolean;
+    /**
+     * When true, any missing non-optional peer dependencies are automatically installed.
+     *
+     * @remarks
+     * The default value is same as PNPM default value.  (In PNPM 8.x, this value is true)
+     */
+    readonly autoInstallPeers: boolean | undefined;
     /**
      * The "globalOverrides" setting provides a simple mechanism for overriding version selections
      * for all dependencies of all projects in the monorepo workspace.  The settings are copied
@@ -3164,7 +3205,7 @@ export declare class Rush {
      *
      * Even though this API isn't documented, it is still supported for legacy compatibility.
      */
-    static launch(launcherVersion: string, arg: ILaunchOptions): void;
+    static launch(launcherVersion: string, options: ILaunchOptions): void;
     /**
      * This API is used by the `@microsoft/rush` front end to launch the "rushx" command-line.
      * Third-party tools should not use this API.  Instead, they should execute the "rushx" binary

package/dist/tsdoc-metadata.json

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

package/lib/api/EnvironmentConfiguration.d.ts

@@ -155,11 +155,16 @@ export declare const EnvironmentVariableNames: {
      * Explicitly specifies the path for the `tar` binary that is invoked by certain Rush operations.
      */
     readonly RUSH_TAR_BINARY_PATH: "RUSH_TAR_BINARY_PATH";
+    /**
+     * Internal variable used by `rushx` when recursively invoking another `rushx` process, to avoid
+     * nesting event hooks.
+     */
+    readonly _RUSH_RECURSIVE_RUSHX_CALL: "_RUSH_RECURSIVE_RUSHX_CALL";
     /**
      * Internal variable that explicitly specifies the path for the version of `@microsoft/rush-lib` being executed.
      * Will be set upon loading Rush.
      */
-    readonly RUSH_LIB_PATH: "_RUSH_LIB_PATH";
+    readonly _RUSH_LIB_PATH: "_RUSH_LIB_PATH";
     /**
      * When Rush executes shell scripts, it sometimes changes the working directory to be a project folder or
      * the repository root folder.  The original working directory (where the Rush command was invoked) is assigned
@@ -170,6 +175,16 @@ export declare const EnvironmentVariableNames: {
      * assign when they execute lifecycle scripts.
      */
     readonly RUSH_INVOKED_FOLDER: "RUSH_INVOKED_FOLDER";
+    /**
+     * When running a hook script, this environment variable communicates the original arguments
+     * passed to the `rush` or `rushx` command.
+     *
+     * @remarks
+     * Unlike `RUSH_INVOKED_FOLDER`, the `RUSH_INVOKED_ARGS` variable is only available for hook scripts.
+     * Other lifecycle scripts should not make assumptions about Rush's command line syntax
+     * if Rush did not explicitly pass along command-line parameters to their process.
+     */
+    readonly RUSH_INVOKED_ARGS: "RUSH_INVOKED_ARGS";
 };
 /**
  * Provides Rush-specific environment variable data. All Rush environment variables must start with "RUSH_". This class

package/lib/api/EventHooks.d.ts

@@ -19,7 +19,15 @@ export declare enum Event {
     /**
      * Post Rush build event
      */
-    postRushBuild = 4
+    postRushBuild = 4,
+    /**
+     * Start of rushx execution event
+     */
+    preRushx = 5,
+    /**
+     * End of rushx execution event
+     */
+    postRushx = 6
 }
 /**
  * This class represents Rush event hooks configured for this repo.

package/lib/api/Rush.d.ts

@@ -19,15 +19,22 @@ export interface ILaunchOptions {
      */
     alreadyReportedNodeTooNewError?: boolean;
     /**
-     * Used to specify Rush plugins that are dependencies of the "\@microsoft/rush" package.
+     * Pass along the terminal provider from the CLI version selector.
      *
-     * @internal
+     * @privateRemarks
+     * We should remove this.  The version selector package can be very old.  It's unwise for
+     * `rush-lib` to rely on a potentially ancient `ITerminalProvider` implementation.
      */
-    builtInPluginConfigurations?: IBuiltInPluginConfiguration[];
+    terminalProvider?: ITerminalProvider;
     /**
-     * Used to specify terminal how to write a message
+     * Used only by `@microsoft/rush/lib/start-dev.js` during development.
+     * Specifies Rush devDependencies of the `@microsoft/rush` to be manually loaded.
+     *
+     * @remarks
+     * Marked as `@internal` because `IBuiltInPluginConfiguration` is internal.
+     * @internal
      */
-    terminalProvider?: ITerminalProvider;
+    builtInPluginConfigurations?: IBuiltInPluginConfiguration[];
 }
 /**
  * General operations for the Rush engine.
@@ -48,7 +55,7 @@ export declare class Rush {
      *
      * Even though this API isn't documented, it is still supported for legacy compatibility.
      */
-    static launch(launcherVersion: string, arg: ILaunchOptions): void;
+    static launch(launcherVersion: string, options: ILaunchOptions): void;
     /**
      * This API is used by the `@microsoft/rush` front end to launch the "rushx" command-line.
      * Third-party tools should not use this API.  Instead, they should execute the "rushx" binary

package/lib/cli/RushXCommandLine.d.ts

@@ -1,17 +1,8 @@
-/**
- * @internal
- */
-export interface ILaunchRushXInternalOptions {
-    isManaged: boolean;
-    alreadyReportedNodeTooNewError?: boolean;
-}
+import { type ILaunchOptions } from '../api/Rush';
 export declare class RushXCommandLine {
-    static launchRushX(launcherVersion: string, isManaged: boolean): void;
-    /**
-     * @internal
-     */
-    static _launchRushXInternal(launcherVersion: string, options: ILaunchRushXInternalOptions): void;
-    private static _getCommandLineArguments;
+    static launchRushX(launcherVersion: string, options: ILaunchOptions): void;
+    private static _launchRushXInternal;
+    private static _parseCommandLineArguments;
     private static _showUsage;
 }
 //# sourceMappingURL=RushXCommandLine.d.ts.map

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

@@ -1,8 +1,8 @@
 import type { CommandLineFlagParameter, CommandLineIntegerParameter, CommandLineStringParameter } from '@rushstack/ts-command-line';
+import { type ITerminal } from '@rushstack/node-core-library';
 import { BaseRushAction, type IBaseRushActionOptions } from './BaseRushAction';
 import type { IInstallManagerOptions } from '../../logic/base/BaseInstallManagerTypes';
 import type { SelectionParameterSet } from '../parsing/SelectionParameterSet';
-import { type ITerminal } from '@rushstack/node-core-library';
 /**
  * This is the common base class for InstallAction and UpdateAction.
  */
@@ -16,6 +16,7 @@ export declare abstract class BaseInstallAction extends BaseRushAction {
     protected readonly _debugPackageManagerParameter: CommandLineFlagParameter;
     protected readonly _maxInstallAttempts: CommandLineIntegerParameter;
     protected readonly _ignoreHooksParameter: CommandLineFlagParameter;
+    protected readonly _offlineParameter: CommandLineFlagParameter;
     protected _selectionParameters?: SelectionParameterSet;
     constructor(options: IBaseRushActionOptions);
     protected abstract buildInstallOptionsAsync(): Promise<IInstallManagerOptions>;

package/lib/logic/PurgeManager.d.ts

@@ -14,7 +14,7 @@ export declare class PurgeManager {
      * Performs the AsyncRecycler.deleteAll() operation.  This should be called before
      * the PurgeManager instance is disposed.
      */
-    deleteAll(): void;
+    startDeleteAllAsync(): Promise<void>;
     /**
      * Delete everything from the common/temp folder
      */

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

@@ -40,6 +40,11 @@ export interface IInstallManagerOptions {
      * (pnpmfile.js script logic, registry changes, etc).
      */
     recheckShrinkwrap: boolean;
+    /**
+     * Do not attempt to access the network. Report an error if the required dependencies
+     * cannot be obtained from the local cache.
+     */
+    offline: boolean;
     /**
      * The value of the "--network-concurrency" command-line parameter, which
      * is a diagnostic option used to troubleshoot network failures.

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

@@ -90,6 +90,10 @@ export interface IPnpmOptionsJson extends IPackageManagerOptionsJsonBase {
      * {@inheritDoc PnpmOptionsConfiguration.resolutionMode}
      */
     resolutionMode?: PnpmResolutionMode;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.autoInstallPeers}
+     */
+    autoInstallPeers?: boolean;
 }
 /**
  * Options that are only used when the PNPM package manager is selected.
@@ -183,6 +187,13 @@ export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfi
      * The default value is true.  (For now.)
      */
     readonly useWorkspaces: boolean;
+    /**
+     * When true, any missing non-optional peer dependencies are automatically installed.
+     *
+     * @remarks
+     * The default value is same as PNPM default value.  (In PNPM 8.x, this value is true)
+     */
+    readonly autoInstallPeers: boolean | undefined;
     /**
      * The "globalOverrides" setting provides a simple mechanism for overriding version selections
      * for all dependencies of all projects in the monorepo workspace.  The settings are copied

package/lib/utilities/AsyncRecycler.d.ts

@@ -32,7 +32,7 @@ export declare class AsyncRecycler {
      * NOTE: To avoid spawning multiple instances of the same command, moveFolder()
      * MUST NOT be called again after deleteAll() has started.
      */
-    deleteAll(): void;
+    startDeleteAllAsync(): Promise<void>;
     private _renameOrRecurseInFolder;
 }
 //# sourceMappingURL=AsyncRecycler.d.ts.map

package/lib/utilities/Utilities.d.ts

@@ -47,6 +47,10 @@ export interface ILifecycleCommandOptions {
      * If true, suppress the process's output, but if there is a nonzero exit code then print stderr
      */
     handleOutput: boolean;
+    /**
+     * an existing environment to copy instead of process.env
+     */
+    initialEnvironment?: IEnvironment;
     /**
      * Options for what should be added to the PATH variable
      */

package/lib-shim/helpers.d.ts

@@ -1,6 +1,6 @@
 import type { EnvironmentVariableNames } from '@microsoft/rush-lib';
 export declare const RUSH_LIB_NAME: '@microsoft/rush-lib';
-export declare const RUSH_LIB_PATH_ENV_VAR_NAME: typeof EnvironmentVariableNames.RUSH_LIB_PATH;
+export declare const RUSH_LIB_PATH_ENV_VAR_NAME: typeof EnvironmentVariableNames._RUSH_LIB_PATH;
 export type RushLibModuleType = Record<string, unknown>;
 export interface ISdkContext {
     rushLibModule: RushLibModuleType | undefined;

package/lib-shim/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,qBAA6C,CAAC;AAC1E,eAAO,MAAM,0BAA0B,EAAE,OAAO,wBAAwB,CAAC,aAAgC,CAAC;AAE1G,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,iBAAiB,GAAG,SAAS,CAAC;CAC9C;AAED,eAAO,MAAM,UAAU,EAAE,WAExB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBlF;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAU7D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAOnF"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,qBAA6C,CAAC;AAC1E,eAAO,MAAM,0BAA0B,EAAE,OAAO,wBAAwB,CAAC,cAAiC,CAAC;AAE3G,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,iBAAiB,GAAG,SAAS,CAAC;CAC9C;AAED,eAAO,MAAM,UAAU,EAAE,WAExB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBlF;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAU7D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAOnF"}

package/lib-shim/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,2CAA6B;AAC7B,oEAAkE;AAGrD,QAAA,aAAa,GAA0B,qBAAqB,CAAC;AAC7D,QAAA,0BAA0B,GAAkD,gBAAgB,CAAC;AAQ7F,QAAA,UAAU,GAAgB;IACrC,aAAa,EAAE,SAAS;CACzB,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,cAAsB;IAC5D,IAAI,aAAa,GAAW,cAAc,CAAC;IAE3C,6EAA6E;IAC7E,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE;QACnC,MAAM,gBAAgB,GAAW,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAEvE,IAAI,8BAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;YACvC,OAAO,gBAAgB,CAAC;SACzB;QAED,MAAM,YAAY,GAAW,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,YAAY,KAAK,aAAa,EAAE;YAClC,MAAM;SACP;QAED,aAAa,GAAG,YAAY,CAAC;KAC9B;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AApBD,0DAoBC;AAED,SAAgB,QAAQ,CAAU,UAAkB;IAClD,IAAI,OAAO,uBAAuB,KAAK,UAAU,EAAE;QACjD,6FAA6F;QAC7F,kEAAkE;QAClE,2FAA2F;QAC3F,mBAAmB;QACnB,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;KAC5C;SAAM;QACL,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;KAC5B;AACH,CAAC;AAVD,4BAUC;AAED;;GAEG;AACH,SAAgB,6BAA6B,CAAC,UAAkB;IAC9D,MAAM,iBAAiB,GAAW,0BAAM,CAAC,aAAa,CAAC;QACrD,UAAU,EAAE,qBAAa;QACzB,cAAc,EAAE,UAAU;KAC3B,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACrC,CAAC;AAPD,sEAOC","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 'path';\nimport { Import, FileSystem } from '@rushstack/node-core-library';\nimport type { EnvironmentVariableNames } from '@microsoft/rush-lib';\n\nexport const RUSH_LIB_NAME: '@microsoft/rush-lib' = '@microsoft/rush-lib';\nexport const RUSH_LIB_PATH_ENV_VAR_NAME: typeof EnvironmentVariableNames.RUSH_LIB_PATH = '_RUSH_LIB_PATH';\n\nexport type RushLibModuleType = Record<string, unknown>;\n\nexport interface ISdkContext {\n  rushLibModule: RushLibModuleType | undefined;\n}\n\nexport const sdkContext: ISdkContext = {\n  rushLibModule: undefined\n};\n\n/**\n * Find the rush.json location and return the path, or undefined if a rush.json can't be found.\n *\n * @privateRemarks\n * Keep this in sync with `RushConfiguration.tryFindRushJsonLocation`.\n */\nexport function tryFindRushJsonLocation(startingFolder: string): string | undefined {\n  let currentFolder: string = startingFolder;\n\n  // Look upwards at parent folders until we find a folder containing rush.json\n  for (let i: number = 0; i < 10; ++i) {\n    const rushJsonFilename: string = path.join(currentFolder, 'rush.json');\n\n    if (FileSystem.exists(rushJsonFilename)) {\n      return rushJsonFilename;\n    }\n\n    const parentFolder: string = path.dirname(currentFolder);\n    if (parentFolder === currentFolder) {\n      break;\n    }\n\n    currentFolder = parentFolder;\n  }\n\n  return undefined;\n}\n\nexport function _require<TResult>(moduleName: string): TResult {\n  if (typeof __non_webpack_require__ === 'function') {\n    // If this library has been bundled with Webpack, we need to call the real `require` function\n    // that doesn't get turned into a `__webpack_require__` statement.\n    // `__non_webpack_require__` is a Webpack macro that gets turned into a `require` statement\n    // during bundling.\n    return __non_webpack_require__(moduleName);\n  } else {\n    return require(moduleName);\n  }\n}\n\n/**\n * Require `@microsoft/rush-lib` under the specified folder path.\n */\nexport function requireRushLibUnderFolderPath(folderPath: string): RushLibModuleType {\n  const rushLibModulePath: string = Import.resolveModule({\n    modulePath: RUSH_LIB_NAME,\n    baseFolderPath: folderPath\n  });\n\n  return _require(rushLibModulePath);\n}\n"]}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,2CAA6B;AAC7B,oEAAkE;AAGrD,QAAA,aAAa,GAA0B,qBAAqB,CAAC;AAC7D,QAAA,0BAA0B,GAAmD,gBAAgB,CAAC;AAQ9F,QAAA,UAAU,GAAgB;IACrC,aAAa,EAAE,SAAS;CACzB,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,cAAsB;IAC5D,IAAI,aAAa,GAAW,cAAc,CAAC;IAE3C,6EAA6E;IAC7E,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE;QACnC,MAAM,gBAAgB,GAAW,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAEvE,IAAI,8BAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;YACvC,OAAO,gBAAgB,CAAC;SACzB;QAED,MAAM,YAAY,GAAW,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,YAAY,KAAK,aAAa,EAAE;YAClC,MAAM;SACP;QAED,aAAa,GAAG,YAAY,CAAC;KAC9B;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AApBD,0DAoBC;AAED,SAAgB,QAAQ,CAAU,UAAkB;IAClD,IAAI,OAAO,uBAAuB,KAAK,UAAU,EAAE;QACjD,6FAA6F;QAC7F,kEAAkE;QAClE,2FAA2F;QAC3F,mBAAmB;QACnB,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;KAC5C;SAAM;QACL,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;KAC5B;AACH,CAAC;AAVD,4BAUC;AAED;;GAEG;AACH,SAAgB,6BAA6B,CAAC,UAAkB;IAC9D,MAAM,iBAAiB,GAAW,0BAAM,CAAC,aAAa,CAAC;QACrD,UAAU,EAAE,qBAAa;QACzB,cAAc,EAAE,UAAU;KAC3B,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACrC,CAAC;AAPD,sEAOC","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 'path';\nimport { Import, FileSystem } from '@rushstack/node-core-library';\nimport type { EnvironmentVariableNames } from '@microsoft/rush-lib';\n\nexport const RUSH_LIB_NAME: '@microsoft/rush-lib' = '@microsoft/rush-lib';\nexport const RUSH_LIB_PATH_ENV_VAR_NAME: typeof EnvironmentVariableNames._RUSH_LIB_PATH = '_RUSH_LIB_PATH';\n\nexport type RushLibModuleType = Record<string, unknown>;\n\nexport interface ISdkContext {\n  rushLibModule: RushLibModuleType | undefined;\n}\n\nexport const sdkContext: ISdkContext = {\n  rushLibModule: undefined\n};\n\n/**\n * Find the rush.json location and return the path, or undefined if a rush.json can't be found.\n *\n * @privateRemarks\n * Keep this in sync with `RushConfiguration.tryFindRushJsonLocation`.\n */\nexport function tryFindRushJsonLocation(startingFolder: string): string | undefined {\n  let currentFolder: string = startingFolder;\n\n  // Look upwards at parent folders until we find a folder containing rush.json\n  for (let i: number = 0; i < 10; ++i) {\n    const rushJsonFilename: string = path.join(currentFolder, 'rush.json');\n\n    if (FileSystem.exists(rushJsonFilename)) {\n      return rushJsonFilename;\n    }\n\n    const parentFolder: string = path.dirname(currentFolder);\n    if (parentFolder === currentFolder) {\n      break;\n    }\n\n    currentFolder = parentFolder;\n  }\n\n  return undefined;\n}\n\nexport function _require<TResult>(moduleName: string): TResult {\n  if (typeof __non_webpack_require__ === 'function') {\n    // If this library has been bundled with Webpack, we need to call the real `require` function\n    // that doesn't get turned into a `__webpack_require__` statement.\n    // `__non_webpack_require__` is a Webpack macro that gets turned into a `require` statement\n    // during bundling.\n    return __non_webpack_require__(moduleName);\n  } else {\n    return require(moduleName);\n  }\n}\n\n/**\n * Require `@microsoft/rush-lib` under the specified folder path.\n */\nexport function requireRushLibUnderFolderPath(folderPath: string): RushLibModuleType {\n  const rushLibModulePath: string = Import.resolveModule({\n    modulePath: RUSH_LIB_NAME,\n    baseFolderPath: folderPath\n  });\n\n  return _require(rushLibModulePath);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.107.4",
+  "version": "5.109.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -25,17 +25,17 @@
   "dependencies": {
     "@types/node-fetch": "2.6.2",
     "tapable": "2.2.1",
-    "@rushstack/node-core-library": "3.60.1"
+    "@rushstack/node-core-library": "3.61.0"
   },
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.0",
-    "@microsoft/rush-lib": "5.107.4",
-    "@rushstack/heft": "0.61.3",
+    "@microsoft/rush-lib": "5.109.0",
+    "@rushstack/heft": "0.62.3",
     "local-node-rig": "1.0.0",
-    "@rushstack/stream-collator": "4.1.6",
+    "@rushstack/stream-collator": "4.1.10",
     "@rushstack/ts-command-line": "4.16.1",
-    "@rushstack/terminal": "0.7.5"
+    "@rushstack/terminal": "0.7.9"
   },
   "scripts": {
     "build": "heft build --clean",