@rushstack/rush-sdk 5.131.0 → 5.131.2

package/lib-commonjs/loader.d.ts

@@ -1,86 +0,0 @@
-/// <reference types="node" />
-/**
- * Type of {@link ISdkCallbackEvent.logMessage}
- * @public
- */
-export interface IProgressBarCallbackLogMessage {
-    /**
-     * A status message to print in the log window, or `undefined` if there are
-     * no further messages.  This string may contain newlines.
-     */
-    text: string;
-    /**
-     * The type of message.  More message types may be added in the future.
-     */
-    kind: 'info' | 'debug';
-}
-/**
- * Event options for {@link ILoadSdkAsyncOptions.onNotifyEvent}
- * @public
- */
-export interface ISdkCallbackEvent {
-    /**
-     * Allows the caller to display log information about the operation.
-     */
-    logMessage: IProgressBarCallbackLogMessage | undefined;
-    /**
-     * Allows the caller to display a progress bar for long-running operations.
-     *
-     * @remarks
-     * If a long-running operation is required, then `progressPercent` will
-     * start at 0.0 and count upwards and finish at 100.0 if the operation completes
-     * successfully.  If the long-running operation has not yet started, or
-     * is not required, then the value will be `undefined`.
-     */
-    progressPercent: number | undefined;
-}
-/**
- * Type of {@link ILoadSdkAsyncOptions.onNotifyEvent}
- * @public
- */
-export type SdkNotifyEventCallback = (sdkEvent: ISdkCallbackEvent) => void;
-/**
- * Options for {@link RushSdkLoader.loadAsync}
- * @public
- */
-export interface ILoadSdkAsyncOptions {
-    /**
-     * The folder to start from when searching for the Rush workspace configuration.
-     * If this folder does not contain a `rush.json` file, then each parent folder
-     * will be searched.  If `rush.json` is not found, then the SDK fails to load.
-     */
-    rushJsonSearchFolder?: string;
-    /**
-     * A cancellation token that the caller can use to prematurely abort the operation.
-     */
-    abortSignal?: AbortSignal;
-    /**
-     * Allows the caller to monitor the progress of the operation.
-     */
-    onNotifyEvent?: SdkNotifyEventCallback;
-}
-/**
- * Exposes operations that control how the `@microsoft/rush-lib` engine is
- * located and loaded.
- * @public
- */
-export declare class RushSdkLoader {
-    /**
-     * Throws an "AbortError" exception if abortSignal.aborted is true.
-     */
-    private static _checkForCancel;
-    /**
-     * Returns true if the Rush engine has already been loaded.
-     */
-    static get isLoaded(): boolean;
-    /**
-     * Manually load the Rush engine based on rush.json found for `rushJsonSearchFolder`.
-     * Throws an exception if {@link RushSdkLoader.isLoaded} is already `true`.
-     *
-     * @remarks
-     * This API supports an callback that can be used display a progress bar,
-     * log of operations, and allow the operation to be canceled prematurely.
-     */
-    static loadAsync(options?: ILoadSdkAsyncOptions): Promise<void>;
-}
-//# sourceMappingURL=loader.d.ts.map

package/lib-commonjs/loader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":";AAqBA;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,UAAU,EAAE,8BAA8B,GAAG,SAAS,CAAC;IAEvD;;;;;;;;OAQG;IACH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;CACxC;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAwB9B;;OAEG;IACH,WAAkB,QAAQ,IAAI,OAAO,CAEpC;IAED;;;;;;;OAOG;WACiB,SAAS,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAkJ7E"}

package/lib-commonjs/loader.js

@@ -1,192 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RushSdkLoader = void 0;
-const path = __importStar(require("path"));
-const node_core_library_1 = require("@rushstack/node-core-library");
-const helpers_1 = require("./helpers");
-/**
- * Exposes operations that control how the `@microsoft/rush-lib` engine is
- * located and loaded.
- * @public
- */
-class RushSdkLoader {
-    /**
-     * Throws an "AbortError" exception if abortSignal.aborted is true.
-     */
-    static _checkForCancel(abortSignal, onNotifyEvent, progressPercent) {
-        if (!(abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted)) {
-            return;
-        }
-        if (onNotifyEvent) {
-            onNotifyEvent({
-                logMessage: {
-                    kind: 'info',
-                    text: `The operation was canceled`
-                },
-                progressPercent
-            });
-        }
-        const error = new Error('The operation was canceled');
-        error.name = 'AbortError';
-        throw error;
-    }
-    /**
-     * Returns true if the Rush engine has already been loaded.
-     */
-    static get isLoaded() {
-        return helpers_1.sdkContext.rushLibModule !== undefined;
-    }
-    /**
-     * Manually load the Rush engine based on rush.json found for `rushJsonSearchFolder`.
-     * Throws an exception if {@link RushSdkLoader.isLoaded} is already `true`.
-     *
-     * @remarks
-     * This API supports an callback that can be used display a progress bar,
-     * log of operations, and allow the operation to be canceled prematurely.
-     */
-    static async loadAsync(options) {
-        // SCENARIO 5: The rush-lib engine is loaded manually using rushSdkLoader.loadAsync().
-        var _a, _b;
-        if (!options) {
-            options = {};
-        }
-        if (RushSdkLoader.isLoaded) {
-            throw new Error('RushSdkLoader.loadAsync() failed because the Rush engine has already been loaded');
-        }
-        const onNotifyEvent = options.onNotifyEvent;
-        let progressPercent = undefined;
-        const abortSignal = options.abortSignal;
-        try {
-            const rushJsonSearchFolder = (_a = options.rushJsonSearchFolder) !== null && _a !== void 0 ? _a : process.cwd();
-            if (onNotifyEvent) {
-                onNotifyEvent({
-                    logMessage: {
-                        kind: 'debug',
-                        text: `Searching for rush.json starting from: ` + rushJsonSearchFolder
-                    },
-                    progressPercent
-                });
-            }
-            const rushJsonPath = (0, helpers_1.tryFindRushJsonLocation)(rushJsonSearchFolder);
-            if (!rushJsonPath) {
-                throw new Error('Unable to find rush.json in the specified folder or its parent folders:\n' +
-                    `${rushJsonSearchFolder}\n`);
-            }
-            const monorepoRoot = path.dirname(rushJsonPath);
-            const rushJson = await node_core_library_1.JsonFile.loadAsync(rushJsonPath);
-            const { rushVersion } = rushJson;
-            const installRunNodeModuleFolder = path.join(monorepoRoot, `common/temp/install-run/@microsoft+rush@${rushVersion}`);
-            try {
-                // First, try to load the version of "rush-lib" that was installed by install-run-rush.js
-                if (onNotifyEvent) {
-                    onNotifyEvent({
-                        logMessage: {
-                            kind: 'info',
-                            text: `Trying to load  ${helpers_1.RUSH_LIB_NAME} installed by install-run-rush`
-                        },
-                        progressPercent
-                    });
-                }
-                helpers_1.sdkContext.rushLibModule = (0, helpers_1.requireRushLibUnderFolderPath)(installRunNodeModuleFolder);
-            }
-            catch (e1) {
-                let installAndRunRushStderrContent = '';
-                try {
-                    const installAndRunRushJSPath = path.join(monorepoRoot, 'common/scripts/install-run-rush.js');
-                    if (onNotifyEvent) {
-                        onNotifyEvent({
-                            logMessage: {
-                                kind: 'info',
-                                text: 'The Rush engine has not been installed yet. Invoking install-run-rush.js...'
-                            },
-                            progressPercent
-                        });
-                    }
-                    // Start the installation
-                    progressPercent = 0;
-                    const installAndRunRushProcess = node_core_library_1.Executable.spawnSync('node', [installAndRunRushJSPath, '--help'], {
-                        stdio: 'pipe'
-                    });
-                    installAndRunRushStderrContent = installAndRunRushProcess.stderr;
-                    if (installAndRunRushProcess.status !== 0) {
-                        throw new Error(`The ${helpers_1.RUSH_LIB_NAME} package failed to install`);
-                    }
-                    if (abortSignal) {
-                        RushSdkLoader._checkForCancel(abortSignal, onNotifyEvent, progressPercent);
-                    }
-                    // TODO: Implement incremental progress updates
-                    progressPercent = 90;
-                    // Retry to load "rush-lib" after install-run-rush run
-                    if (onNotifyEvent) {
-                        onNotifyEvent({
-                            logMessage: {
-                                kind: 'debug',
-                                text: `Trying to load  ${helpers_1.RUSH_LIB_NAME} installed by install-run-rush a second time`
-                            },
-                            progressPercent
-                        });
-                    }
-                    helpers_1.sdkContext.rushLibModule = (0, helpers_1.requireRushLibUnderFolderPath)(installRunNodeModuleFolder);
-                    progressPercent = 100;
-                }
-                catch (e2) {
-                    // eslint-disable-next-line no-console
-                    console.error(`${installAndRunRushStderrContent}`);
-                    throw new Error(`The ${helpers_1.RUSH_LIB_NAME} package failed to load`);
-                }
-            }
-            if (helpers_1.sdkContext.rushLibModule !== undefined) {
-                // to track which scenario is active and how it got initialized.
-                global.___rush___rushLibModuleFromInstallAndRunRush = helpers_1.sdkContext.rushLibModule;
-                if (onNotifyEvent) {
-                    onNotifyEvent({
-                        logMessage: {
-                            kind: 'debug',
-                            text: `Loaded ${helpers_1.RUSH_LIB_NAME} installed by install-run-rush`
-                        },
-                        progressPercent
-                    });
-                }
-            }
-        }
-        catch (e) {
-            if (onNotifyEvent) {
-                onNotifyEvent({
-                    logMessage: {
-                        kind: 'info',
-                        text: 'The operation failed: ' + ((_b = e.message) !== null && _b !== void 0 ? _b : 'An unknown error occurred')
-                    },
-                    progressPercent
-                });
-            }
-            throw e;
-        }
-    }
-}
-exports.RushSdkLoader = RushSdkLoader;
-//# sourceMappingURL=loader.js.map

package/lib-commonjs/loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.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 'path';\nimport type { SpawnSyncReturns } from 'child_process';\nimport { JsonFile, type JsonObject, Executable } from '@rushstack/node-core-library';\n\nimport {\n  tryFindRushJsonLocation,\n  RUSH_LIB_NAME,\n  type RushLibModuleType,\n  requireRushLibUnderFolderPath,\n  sdkContext\n} from './helpers';\n\ndeclare const global: typeof globalThis & {\n  ___rush___rushLibModule?: RushLibModuleType;\n  ___rush___rushLibModuleFromEnvironment?: RushLibModuleType;\n  ___rush___rushLibModuleFromInstallAndRunRush?: RushLibModuleType;\n};\n\n/**\n * Type of {@link ISdkCallbackEvent.logMessage}\n * @public\n */\nexport interface IProgressBarCallbackLogMessage {\n  /**\n   * A status message to print in the log window, or `undefined` if there are\n   * no further messages.  This string may contain newlines.\n   */\n  text: string;\n\n  /**\n   * The type of message.  More message types may be added in the future.\n   */\n  kind: 'info' | 'debug';\n}\n\n/**\n * Event options for {@link ILoadSdkAsyncOptions.onNotifyEvent}\n * @public\n */\nexport interface ISdkCallbackEvent {\n  /**\n   * Allows the caller to display log information about the operation.\n   */\n  logMessage: IProgressBarCallbackLogMessage | undefined;\n\n  /**\n   * Allows the caller to display a progress bar for long-running operations.\n   *\n   * @remarks\n   * If a long-running operation is required, then `progressPercent` will\n   * start at 0.0 and count upwards and finish at 100.0 if the operation completes\n   * successfully.  If the long-running operation has not yet started, or\n   * is not required, then the value will be `undefined`.\n   */\n  progressPercent: number | undefined;\n}\n\n/**\n * Type of {@link ILoadSdkAsyncOptions.onNotifyEvent}\n * @public\n */\nexport type SdkNotifyEventCallback = (sdkEvent: ISdkCallbackEvent) => void;\n\n/**\n * Options for {@link RushSdkLoader.loadAsync}\n * @public\n */\nexport interface ILoadSdkAsyncOptions {\n  /**\n   * The folder to start from when searching for the Rush workspace configuration.\n   * If this folder does not contain a `rush.json` file, then each parent folder\n   * will be searched.  If `rush.json` is not found, then the SDK fails to load.\n   */\n  rushJsonSearchFolder?: string;\n\n  /**\n   * A cancellation token that the caller can use to prematurely abort the operation.\n   */\n  abortSignal?: AbortSignal;\n\n  /**\n   * Allows the caller to monitor the progress of the operation.\n   */\n  onNotifyEvent?: SdkNotifyEventCallback;\n}\n\n/**\n * Exposes operations that control how the `@microsoft/rush-lib` engine is\n * located and loaded.\n * @public\n */\nexport class RushSdkLoader {\n  /**\n   * Throws an \"AbortError\" exception if abortSignal.aborted is true.\n   */\n  private static _checkForCancel(\n    abortSignal: AbortSignal,\n    onNotifyEvent: SdkNotifyEventCallback | undefined,\n    progressPercent: number | undefined\n  ): void {\n    if (!abortSignal?.aborted) {\n      return;\n    }\n\n    if (onNotifyEvent) {\n      onNotifyEvent({\n        logMessage: {\n          kind: 'info',\n          text: `The operation was canceled`\n        },\n        progressPercent\n      });\n    }\n\n    const error: Error = new Error('The operation was canceled');\n    error.name = 'AbortError';\n    throw error;\n  }\n\n  /**\n   * Returns true if the Rush engine has already been loaded.\n   */\n  public static get isLoaded(): boolean {\n    return sdkContext.rushLibModule !== undefined;\n  }\n\n  /**\n   * Manually load the Rush engine based on rush.json found for `rushJsonSearchFolder`.\n   * Throws an exception if {@link RushSdkLoader.isLoaded} is already `true`.\n   *\n   * @remarks\n   * This API supports an callback that can be used display a progress bar,\n   * log of operations, and allow the operation to be canceled prematurely.\n   */\n  public static async loadAsync(options?: ILoadSdkAsyncOptions): Promise<void> {\n    // SCENARIO 5: The rush-lib engine is loaded manually using rushSdkLoader.loadAsync().\n\n    if (!options) {\n      options = {};\n    }\n\n    if (RushSdkLoader.isLoaded) {\n      throw new Error('RushSdkLoader.loadAsync() failed because the Rush engine has already been loaded');\n    }\n\n    const onNotifyEvent: SdkNotifyEventCallback | undefined = options.onNotifyEvent;\n    let progressPercent: number | undefined = undefined;\n\n    const abortSignal: AbortSignal | undefined = options.abortSignal;\n\n    try {\n      const rushJsonSearchFolder: string = options.rushJsonSearchFolder ?? process.cwd();\n\n      if (onNotifyEvent) {\n        onNotifyEvent({\n          logMessage: {\n            kind: 'debug',\n            text: `Searching for rush.json starting from: ` + rushJsonSearchFolder\n          },\n          progressPercent\n        });\n      }\n\n      const rushJsonPath: string | undefined = tryFindRushJsonLocation(rushJsonSearchFolder);\n      if (!rushJsonPath) {\n        throw new Error(\n          'Unable to find rush.json in the specified folder or its parent folders:\\n' +\n            `${rushJsonSearchFolder}\\n`\n        );\n      }\n      const monorepoRoot: string = path.dirname(rushJsonPath);\n\n      const rushJson: JsonObject = await JsonFile.loadAsync(rushJsonPath);\n      const { rushVersion } = rushJson;\n\n      const installRunNodeModuleFolder: string = path.join(\n        monorepoRoot,\n        `common/temp/install-run/@microsoft+rush@${rushVersion}`\n      );\n\n      try {\n        // First, try to load the version of \"rush-lib\" that was installed by install-run-rush.js\n        if (onNotifyEvent) {\n          onNotifyEvent({\n            logMessage: {\n              kind: 'info',\n              text: `Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush`\n            },\n            progressPercent\n          });\n        }\n        sdkContext.rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);\n      } catch (e1) {\n        let installAndRunRushStderrContent: string = '';\n        try {\n          const installAndRunRushJSPath: string = path.join(\n            monorepoRoot,\n            'common/scripts/install-run-rush.js'\n          );\n\n          if (onNotifyEvent) {\n            onNotifyEvent({\n              logMessage: {\n                kind: 'info',\n                text: 'The Rush engine has not been installed yet. Invoking install-run-rush.js...'\n              },\n              progressPercent\n            });\n          }\n\n          // Start the installation\n          progressPercent = 0;\n\n          const installAndRunRushProcess: SpawnSyncReturns<string> = Executable.spawnSync(\n            'node',\n            [installAndRunRushJSPath, '--help'],\n            {\n              stdio: 'pipe'\n            }\n          );\n\n          installAndRunRushStderrContent = installAndRunRushProcess.stderr;\n          if (installAndRunRushProcess.status !== 0) {\n            throw new Error(`The ${RUSH_LIB_NAME} package failed to install`);\n          }\n\n          if (abortSignal) {\n            RushSdkLoader._checkForCancel(abortSignal, onNotifyEvent, progressPercent);\n          }\n\n          // TODO: Implement incremental progress updates\n          progressPercent = 90;\n\n          // Retry to load \"rush-lib\" after install-run-rush run\n          if (onNotifyEvent) {\n            onNotifyEvent({\n              logMessage: {\n                kind: 'debug',\n                text: `Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush a second time`\n              },\n              progressPercent\n            });\n          }\n\n          sdkContext.rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);\n\n          progressPercent = 100;\n        } catch (e2) {\n          // eslint-disable-next-line no-console\n          console.error(`${installAndRunRushStderrContent}`);\n          throw new Error(`The ${RUSH_LIB_NAME} package failed to load`);\n        }\n      }\n\n      if (sdkContext.rushLibModule !== undefined) {\n        // to track which scenario is active and how it got initialized.\n        global.___rush___rushLibModuleFromInstallAndRunRush = sdkContext.rushLibModule;\n        if (onNotifyEvent) {\n          onNotifyEvent({\n            logMessage: {\n              kind: 'debug',\n              text: `Loaded ${RUSH_LIB_NAME} installed by install-run-rush`\n            },\n            progressPercent\n          });\n        }\n      }\n    } catch (e) {\n      if (onNotifyEvent) {\n        onNotifyEvent({\n          logMessage: {\n            kind: 'info',\n            text: 'The operation failed: ' + (e.message ?? 'An unknown error occurred')\n          },\n          progressPercent\n        });\n      }\n      throw e;\n    }\n  }\n}\n"]}

package/lib-esnext/generate-stubs.js

@@ -1,57 +0,0 @@
-// 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 'path';
-import { FileSystem, Import, Path } from '@rushstack/node-core-library';
-function generateLibFilesRecursively(options) {
-    for (const folderItem of FileSystem.readFolderItems(options.parentSourcePath)) {
-        const sourcePath = path.join(options.parentSourcePath, folderItem.name);
-        const targetPath = path.join(options.parentTargetPath, folderItem.name);
-        if (folderItem.isDirectory()) {
-            // create destination folder
-            FileSystem.ensureEmptyFolder(targetPath);
-            generateLibFilesRecursively({
-                parentSourcePath: sourcePath,
-                parentTargetPath: targetPath,
-                parentSrcImportPathWithSlash: options.parentSrcImportPathWithSlash + folderItem.name + '/',
-                libShimIndexPath: options.libShimIndexPath
-            });
-        }
-        else {
-            if (folderItem.name.endsWith('.d.ts')) {
-                FileSystem.copyFile({
-                    sourcePath: sourcePath,
-                    destinationPath: targetPath
-                });
-            }
-            else if (folderItem.name.endsWith('.js')) {
-                const srcImportPath = options.parentSrcImportPathWithSlash + path.parse(folderItem.name).name;
-                const shimPath = path.relative(options.parentTargetPath, options.libShimIndexPath);
-                const shimPathLiteral = JSON.stringify(Path.convertToSlashes(shimPath));
-                const srcImportPathLiteral = JSON.stringify(srcImportPath);
-                FileSystem.writeFile(targetPath, 
-                // Example:
-                // module.exports = require("../../../lib-shim/index")._rushSdk_loadInternalModule("logic/policy/GitEmailPolicy");
-                `module.exports = require(${shimPathLiteral})._rushSdk_loadInternalModule(${srcImportPathLiteral});`);
-            }
-        }
-    }
-}
-// Entry point invoked by "runScript" action from config/heft.json
-export async function runAsync() {
-    const rushLibFolder = Import.resolvePackage({
-        baseFolderPath: __dirname,
-        packageName: '@microsoft/rush-lib'
-    });
-    const stubsTargetPath = path.resolve(__dirname, '../lib');
-    // eslint-disable-next-line no-console
-    console.log('generate-stubs: Generating stub files under: ' + stubsTargetPath);
-    generateLibFilesRecursively({
-        parentSourcePath: path.join(rushLibFolder, 'lib'),
-        parentTargetPath: stubsTargetPath,
-        parentSrcImportPathWithSlash: '',
-        libShimIndexPath: path.join(__dirname, '../lib-shim/index')
-    });
-    // eslint-disable-next-line no-console
-    console.log('generate-stubs: Completed successfully.');
-}
-//# sourceMappingURL=generate-stubs.js.map

package/lib-esnext/generate-stubs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate-stubs.js","sourceRoot":"","sources":["../src/generate-stubs.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAExE,SAAS,2BAA2B,CAAC,OAKpC;IACC,KAAK,MAAM,UAAU,IAAI,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC9E,MAAM,UAAU,GAAW,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAChF,MAAM,UAAU,GAAW,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAEhF,IAAI,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC7B,4BAA4B;YAC5B,UAAU,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YACzC,2BAA2B,CAAC;gBAC1B,gBAAgB,EAAE,UAAU;gBAC5B,gBAAgB,EAAE,UAAU;gBAC5B,4BAA4B,EAAE,OAAO,CAAC,4BAA4B,GAAG,UAAU,CAAC,IAAI,GAAG,GAAG;gBAC1F,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;aAC3C,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,UAAU,CAAC,QAAQ,CAAC;oBAClB,UAAU,EAAE,UAAU;oBACtB,eAAe,EAAE,UAAU;iBAC5B,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,aAAa,GAAW,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;gBACtG,MAAM,QAAQ,GAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBAC3F,MAAM,eAAe,GAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAChF,MAAM,oBAAoB,GAAW,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;gBAEnE,UAAU,CAAC,SAAS,CAClB,UAAU;gBACV,WAAW;gBACX,kHAAkH;gBAClH,4BAA4B,eAAe,iCAAiC,oBAAoB,IAAI,CACrG,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,aAAa,GAAW,MAAM,CAAC,cAAc,CAAC;QAClD,cAAc,EAAE,SAAS;QACzB,WAAW,EAAE,qBAAqB;KACnC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAW,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClE,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,+CAA+C,GAAG,eAAe,CAAC,CAAC;IAC/E,2BAA2B,CAAC;QAC1B,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;QACjD,gBAAgB,EAAE,eAAe;QACjC,4BAA4B,EAAE,EAAE;QAChC,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC;KAC5D,CAAC,CAAC;IACH,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC","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';\n\nimport { FileSystem, Import, Path } from '@rushstack/node-core-library';\n\nfunction generateLibFilesRecursively(options: {\n  parentSourcePath: string;\n  parentTargetPath: string;\n  parentSrcImportPathWithSlash: string;\n  libShimIndexPath: string;\n}): void {\n  for (const folderItem of FileSystem.readFolderItems(options.parentSourcePath)) {\n    const sourcePath: string = path.join(options.parentSourcePath, folderItem.name);\n    const targetPath: string = path.join(options.parentTargetPath, folderItem.name);\n\n    if (folderItem.isDirectory()) {\n      // create destination folder\n      FileSystem.ensureEmptyFolder(targetPath);\n      generateLibFilesRecursively({\n        parentSourcePath: sourcePath,\n        parentTargetPath: targetPath,\n        parentSrcImportPathWithSlash: options.parentSrcImportPathWithSlash + folderItem.name + '/',\n        libShimIndexPath: options.libShimIndexPath\n      });\n    } else {\n      if (folderItem.name.endsWith('.d.ts')) {\n        FileSystem.copyFile({\n          sourcePath: sourcePath,\n          destinationPath: targetPath\n        });\n      } else if (folderItem.name.endsWith('.js')) {\n        const srcImportPath: string = options.parentSrcImportPathWithSlash + path.parse(folderItem.name).name;\n        const shimPath: string = path.relative(options.parentTargetPath, options.libShimIndexPath);\n        const shimPathLiteral: string = JSON.stringify(Path.convertToSlashes(shimPath));\n        const srcImportPathLiteral: string = JSON.stringify(srcImportPath);\n\n        FileSystem.writeFile(\n          targetPath,\n          // Example:\n          // module.exports = require(\"../../../lib-shim/index\")._rushSdk_loadInternalModule(\"logic/policy/GitEmailPolicy\");\n          `module.exports = require(${shimPathLiteral})._rushSdk_loadInternalModule(${srcImportPathLiteral});`\n        );\n      }\n    }\n  }\n}\n\n// Entry point invoked by \"runScript\" action from config/heft.json\nexport async function runAsync(): Promise<void> {\n  const rushLibFolder: string = Import.resolvePackage({\n    baseFolderPath: __dirname,\n    packageName: '@microsoft/rush-lib'\n  });\n\n  const stubsTargetPath: string = path.resolve(__dirname, '../lib');\n  // eslint-disable-next-line no-console\n  console.log('generate-stubs: Generating stub files under: ' + stubsTargetPath);\n  generateLibFilesRecursively({\n    parentSourcePath: path.join(rushLibFolder, 'lib'),\n    parentTargetPath: stubsTargetPath,\n    parentSrcImportPathWithSlash: '',\n    libShimIndexPath: path.join(__dirname, '../lib-shim/index')\n  });\n  // eslint-disable-next-line no-console\n  console.log('generate-stubs: Completed successfully.');\n}\n"]}

package/lib-esnext/helpers.js

@@ -1,54 +0,0 @@
-// 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 'path';
-import { Import, FileSystem } from '@rushstack/node-core-library';
-export const RUSH_LIB_NAME = '@microsoft/rush-lib';
-export const RUSH_LIB_PATH_ENV_VAR_NAME = '_RUSH_LIB_PATH';
-export const sdkContext = {
-    rushLibModule: undefined
-};
-/**
- * Find the rush.json location and return the path, or undefined if a rush.json can't be found.
- *
- * @privateRemarks
- * Keep this in sync with `RushConfiguration.tryFindRushJsonLocation`.
- */
-export function tryFindRushJsonLocation(startingFolder) {
-    let currentFolder = startingFolder;
-    // Look upwards at parent folders until we find a folder containing rush.json
-    for (let i = 0; i < 10; ++i) {
-        const rushJsonFilename = path.join(currentFolder, 'rush.json');
-        if (FileSystem.exists(rushJsonFilename)) {
-            return rushJsonFilename;
-        }
-        const parentFolder = path.dirname(currentFolder);
-        if (parentFolder === currentFolder) {
-            break;
-        }
-        currentFolder = parentFolder;
-    }
-    return undefined;
-}
-export function _require(moduleName) {
-    if (typeof __non_webpack_require__ === 'function') {
-        // If this library has been bundled with Webpack, we need to call the real `require` function
-        // that doesn't get turned into a `__webpack_require__` statement.
-        // `__non_webpack_require__` is a Webpack macro that gets turned into a `require` statement
-        // during bundling.
-        return __non_webpack_require__(moduleName);
-    }
-    else {
-        return require(moduleName);
-    }
-}
-/**
- * Require `@microsoft/rush-lib` under the specified folder path.
- */
-export function requireRushLibUnderFolderPath(folderPath) {
-    const rushLibModulePath = Import.resolveModule({
-        modulePath: RUSH_LIB_NAME,
-        baseFolderPath: folderPath
-    });
-    return _require(rushLibModulePath);
-}
-//# sourceMappingURL=helpers.js.map

package/lib-esnext/helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAGlE,MAAM,CAAC,MAAM,aAAa,GAA0B,qBAAqB,CAAC;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAmD,gBAAgB,CAAC;AAQ3G,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,aAAa,EAAE,SAAS;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,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,CAAC;QACpC,MAAM,gBAAgB,GAAW,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAEvE,IAAI,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACxC,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,MAAM,YAAY,GAAW,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;YACnC,MAAM;QACR,CAAC;QAED,aAAa,GAAG,YAAY,CAAC;IAC/B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAU,UAAkB;IAClD,IAAI,OAAO,uBAAuB,KAAK,UAAU,EAAE,CAAC;QAClD,6FAA6F;QAC7F,kEAAkE;QAClE,2FAA2F;QAC3F,mBAAmB;QACnB,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,UAAkB;IAC9D,MAAM,iBAAiB,GAAW,MAAM,CAAC,aAAa,CAAC;QACrD,UAAU,EAAE,aAAa;QACzB,cAAc,EAAE,UAAU;KAC3B,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACrC,CAAC","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/lib-esnext/index.js

@@ -1,180 +0,0 @@
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-var _a;
-import * as path from 'path';
-import { JsonFile, PackageJsonLookup, Executable } from '@rushstack/node-core-library';
-import { Terminal, ConsoleTerminalProvider } from '@rushstack/terminal';
-import { RushGlobalFolder } from '@microsoft/rush-lib/lib-esnext/api/RushGlobalFolder';
-import { RUSH_LIB_NAME, RUSH_LIB_PATH_ENV_VAR_NAME, _require, requireRushLibUnderFolderPath, tryFindRushJsonLocation, sdkContext } from './helpers';
-const verboseEnabled = typeof process !== 'undefined' &&
-    (process.env.RUSH_SDK_DEBUG === '1' || process.env._RUSH_SDK_DEBUG === '1');
-const terminal = new Terminal(new ConsoleTerminalProvider({
-    verboseEnabled
-}));
-let errorMessage = '';
-// SCENARIO 1:  Rush's PluginManager has initialized "rush-sdk" with Rush's own instance of rush-lib.
-// The Rush host process will assign "global.___rush___rushLibModule" before loading the plugin.
-if (sdkContext.rushLibModule === undefined) {
-    sdkContext.rushLibModule =
-        global.___rush___rushLibModule ||
-            global.___rush___rushLibModuleFromEnvironment ||
-            global.___rush___rushLibModuleFromRushGlobalFolder ||
-            global.___rush___rushLibModuleFromInstallAndRunRush;
-}
-// SCENARIO 2:  The project importing "rush-sdk" has installed its own instance of "rush-lib"
-// as a package.json dependency.  For example, this is used by the Jest tests for Rush plugins.
-if (sdkContext.rushLibModule === undefined) {
-    const importingPath = (_a = module === null || module === void 0 ? void 0 : module.parent) === null || _a === void 0 ? void 0 : _a.filename;
-    if (importingPath) {
-        const callerPackageFolder = PackageJsonLookup.instance.tryGetPackageFolderFor(importingPath);
-        if (callerPackageFolder !== undefined) {
-            const callerPackageJson = _require(path.join(callerPackageFolder, 'package.json'));
-            // Does the caller properly declare a dependency on rush-lib?
-            if ((callerPackageJson.dependencies && callerPackageJson.dependencies[RUSH_LIB_NAME] !== undefined) ||
-                (callerPackageJson.devDependencies &&
-                    callerPackageJson.devDependencies[RUSH_LIB_NAME] !== undefined) ||
-                (callerPackageJson.peerDependencies &&
-                    callerPackageJson.peerDependencies[RUSH_LIB_NAME] !== undefined)) {
-                // Try to resolve rush-lib from the caller's folder
-                terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from caller package`);
-                try {
-                    sdkContext.rushLibModule = requireRushLibUnderFolderPath(callerPackageFolder);
-                }
-                catch (error) {
-                    // If we fail to resolve it, ignore the error
-                    terminal.writeVerboseLine(`Failed to load ${RUSH_LIB_NAME} from caller package`);
-                }
-                // If two different libraries invoke `rush-sdk`, and one of them provides "rush-lib"
-                // then the first version to be loaded wins.  We do not support side-by-side instances of "rush-lib".
-                if (sdkContext.rushLibModule !== undefined) {
-                    // to track which scenario is active and how it got initialized.
-                    global.___rush___rushLibModule = sdkContext.rushLibModule;
-                    terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from caller`);
-                }
-            }
-        }
-    }
-}
-// SCENARIO 3: A tool or script has been invoked as a child process by an instance of "rush-lib" and can use the
-// version that invoked it. In this case, use process.env._RUSH_LIB_PATH to find "rush-lib".
-if (sdkContext.rushLibModule === undefined) {
-    const rushLibPath = process.env[RUSH_LIB_PATH_ENV_VAR_NAME];
-    if (rushLibPath) {
-        terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from process.env.${RUSH_LIB_PATH_ENV_VAR_NAME} from caller package`);
-        try {
-            sdkContext.rushLibModule = _require(rushLibPath);
-        }
-        catch (error) {
-            // Log this as a warning, since it is unexpected to define an incorrect value of the variable.
-            terminal.writeWarningLine(`Failed to load ${RUSH_LIB_NAME} via process.env.${RUSH_LIB_PATH_ENV_VAR_NAME}`);
-        }
-        if (sdkContext.rushLibModule !== undefined) {
-            // to track which scenario is active and how it got initialized.
-            global.___rush___rushLibModuleFromEnvironment = sdkContext.rushLibModule;
-            terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from process.env.${RUSH_LIB_PATH_ENV_VAR_NAME}`);
-        }
-    }
-}
-// SCENARIO 4:  A standalone tool or script depends on "rush-sdk", and is meant to be used inside a monorepo folder.
-// In this case, we can first load the rush-lib version in rush global folder. If the expected version is not installed,
-// using install-run-rush.js to obtain the appropriate rush-lib version for the monorepo.
-if (sdkContext.rushLibModule === undefined) {
-    try {
-        const rushJsonPath = tryFindRushJsonLocation(process.cwd());
-        if (!rushJsonPath) {
-            throw new Error('Unable to find rush.json in the current folder or its parent folders.\n' +
-                'This tool is meant to be invoked from a working directory inside a Rush repository.');
-        }
-        const monorepoRoot = path.dirname(rushJsonPath);
-        const rushJson = JsonFile.load(rushJsonPath);
-        const { rushVersion } = rushJson;
-        try {
-            terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from rush global folder`);
-            const rushGlobalFolder = new RushGlobalFolder();
-            // The path needs to keep align with the logic inside RushVersionSelector
-            const expectedGlobalRushInstalledFolder = `${rushGlobalFolder.nodeSpecificPath}/rush-${rushVersion}`;
-            terminal.writeVerboseLine(`The expected global rush installed folder is "${expectedGlobalRushInstalledFolder}"`);
-            sdkContext.rushLibModule = requireRushLibUnderFolderPath(expectedGlobalRushInstalledFolder);
-        }
-        catch (e) {
-            terminal.writeVerboseLine(`Failed to load ${RUSH_LIB_NAME} from rush global folder: ${e.message}`);
-        }
-        if (sdkContext.rushLibModule !== undefined) {
-            // to track which scenario is active and how it got initialized.
-            global.___rush___rushLibModuleFromRushGlobalFolder = sdkContext.rushLibModule;
-            terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} installed from rush global folder`);
-        }
-        else {
-            const installRunNodeModuleFolder = `${monorepoRoot}/common/temp/install-run/@microsoft+rush@${rushVersion}`;
-            try {
-                // First, try to load the version of "rush-lib" that was installed by install-run-rush.js
-                terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush`);
-                sdkContext.rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);
-            }
-            catch (e1) {
-                let installAndRunRushStderrContent = '';
-                try {
-                    const installAndRunRushJSPath = `${monorepoRoot}/common/scripts/install-run-rush.js`;
-                    terminal.writeLine('The Rush engine has not been installed yet. Invoking install-run-rush.js...');
-                    const installAndRunRushProcess = Executable.spawnSync('node', [installAndRunRushJSPath, '--help'], {
-                        stdio: 'pipe'
-                    });
-                    installAndRunRushStderrContent = installAndRunRushProcess.stderr;
-                    if (installAndRunRushProcess.status !== 0) {
-                        throw new Error(`The ${RUSH_LIB_NAME} package failed to install`);
-                    }
-                    // Retry to load "rush-lib" after install-run-rush run
-                    terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush a second time`);
-                    sdkContext.rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);
-                }
-                catch (e2) {
-                    // eslint-disable-next-line no-console
-                    console.error(`${installAndRunRushStderrContent}`);
-                    throw new Error(`The ${RUSH_LIB_NAME} package failed to load`);
-                }
-            }
-            if (sdkContext.rushLibModule !== undefined) {
-                // to track which scenario is active and how it got initialized.
-                global.___rush___rushLibModuleFromInstallAndRunRush = sdkContext.rushLibModule;
-                terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} installed by install-run-rush`);
-            }
-        }
-    }
-    catch (e) {
-        // no-catch
-        errorMessage = e.message;
-    }
-}
-if (sdkContext.rushLibModule === undefined) {
-    // This error indicates that a project is trying to import "@rushstack/rush-sdk", but the Rush engine
-    // instance cannot be found.  If you are writing Jest tests for a Rush plugin, add "@microsoft/rush-lib"
-    // to the devDependencies for your project.
-    // eslint-disable-next-line no-console
-    console.error(`Error: The @rushstack/rush-sdk package was not able to load the Rush engine:
-${errorMessage}
-`);
-    process.exit(1);
-}
-// Based on TypeScript's __exportStar()
-for (const property in sdkContext.rushLibModule) {
-    if (property !== 'default' && !exports.hasOwnProperty(property)) {
-        const rushLibModuleForClosure = sdkContext.rushLibModule;
-        // Based on TypeScript's __createBinding()
-        Object.defineProperty(exports, property, {
-            enumerable: true,
-            get: function () {
-                return rushLibModuleForClosure[property];
-            }
-        });
-    }
-}
-/**
- * Used by the .js stubs for path-based imports of `@microsoft/rush-lib` internal APIs.
- */
-export function _rushSdk_loadInternalModule(srcImportPath) {
-    if (!exports._RushInternals) {
-        throw new Error(`Rush version ${exports.Rush.version} does not support internal API imports via rush-sdk`);
-    }
-    return exports._RushInternals.loadModule(srcImportPath);
-}
-//# sourceMappingURL=index.js.map