@rushstack/rush-resolver-cache-plugin 5.133.0

package/LICENSE

@@ -0,0 +1,24 @@
+@rushstack/rush-pnpm-resolver-cache-plugin
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @rushstack/rush-resolver-cache-plugin
+
+A Rush plugin that runs after successful dependency installation and generates a cache file to optimize node module resolution.
+
+When this plugin is installed, it will produce a file called `resolver-cache.json` in the temp directory of the default subspace, e.g. `<repo>/common/temp/default/resolver-cache.json`
+
+To use this file, load it, call JSON.parse, and pass the result as the `cacheData` property to the `WorkspaceLayoutCache` constructor from `@rushstack/webpack-workspace-resolve-plugin`. The `workspaceRoot` property should be set to the path `<repo>`.

package/dist/rush-resolver-cache-plugin.d.ts

@@ -0,0 +1,15 @@
+import type { IRushPlugin } from '@rushstack/rush-sdk';
+import type { RushConfiguration } from '@rushstack/rush-sdk';
+import type { RushSession } from '@rushstack/rush-sdk';
+
+/**
+ * Plugin that caches information from the package manager after installation to speed up resolution of imports.
+ * @beta
+ */
+declare class RushResolverCachePlugin implements IRushPlugin {
+    readonly pluginName: 'RushResolverCachePlugin';
+    apply(rushSession: RushSession, rushConfiguration: RushConfiguration): void;
+}
+export default RushResolverCachePlugin;
+
+export { }

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.47.7"
+    }
+  ]
+}

package/lib/afterInstallAsync.d.ts

@@ -0,0 +1,10 @@
+import type { RushSession, RushConfiguration, ILogger, Subspace } from '@rushstack/rush-sdk';
+/**
+ * Plugin entry point for after install.
+ * @param rushSession - The Rush Session
+ * @param rushConfiguration - The Rush Configuration
+ * @param subspace - The subspace that was just installed
+ * @param logger - The initialized logger
+ */
+export declare function afterInstallAsync(rushSession: RushSession, rushConfiguration: RushConfiguration, subspace: Subspace, logger: ILogger): Promise<void>;
+//# sourceMappingURL=afterInstallAsync.d.ts.map

package/lib/afterInstallAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"afterInstallAsync.d.ts","sourceRoot":"","sources":["../src/afterInstallAsync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAEjB,OAAO,EAEP,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAgC7B;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,iBAAiB,EACpC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAuGf"}

package/lib/afterInstallAsync.js

@@ -0,0 +1,115 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.afterInstallAsync = void 0;
+const externals_1 = require("./externals");
+const computeResolverCacheFromLockfileAsync_1 = require("./computeResolverCacheFromLockfileAsync");
+/**
+ * Gets information used to determine compatibility of optional dependencies.
+ * @returns Information about the platform Rush is running on
+ */
+function getPlatformInfo() {
+    var _a, _b, _c;
+    // Acquiring the libc version is a bit more obnoxious than platform and arch,
+    // but all of them are ultimately on the same object.
+    const { platform: os, arch: cpu, glibcVersionRuntime
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+     } = (_c = (_b = (_a = process.report) === null || _a === void 0 ? void 0 : _a.getReport()) === null || _b === void 0 ? void 0 : _b.header) !== null && _c !== void 0 ? _c : process;
+    const libc = glibcVersionRuntime ? 'glibc' : 'musl';
+    return {
+        os,
+        cpu,
+        libc
+    };
+}
+/**
+ * Plugin entry point for after install.
+ * @param rushSession - The Rush Session
+ * @param rushConfiguration - The Rush Configuration
+ * @param subspace - The subspace that was just installed
+ * @param logger - The initialized logger
+ */
+async function afterInstallAsync(rushSession, rushConfiguration, subspace, logger) {
+    const { terminal } = logger;
+    const rushRoot = `${rushConfiguration.rushJsonFolder}/`;
+    const lockFilePath = subspace.getCommittedShrinkwrapFilename();
+    const workspaceRoot = subspace.getSubspaceTempFolderPath();
+    const projectByImporterPath = rushConfiguration.getProjectLookupForRoot(workspaceRoot);
+    const pnpmStoreDir = `${rushConfiguration.pnpmOptions.pnpmStorePath}/v3/files/`;
+    terminal.writeLine(`Using pnpm-lock from: ${lockFilePath}`);
+    terminal.writeLine(`Using pnpm store folder: ${pnpmStoreDir}`);
+    const lockFile = externals_1.PnpmShrinkwrapFile.loadFromFile(lockFilePath, {
+        withCaching: true
+    });
+    if (!lockFile) {
+        throw new Error(`Failed to load shrinkwrap file: ${lockFilePath}`);
+    }
+    const cacheFilePath = `${workspaceRoot}/resolver-cache.json`;
+    terminal.writeLine(`Resolver cache will be written at ${cacheFilePath}`);
+    async function afterExternalPackagesAsync(contexts, missingOptionalDependencies) {
+        /**
+         * Loads the index file from the pnpm store to discover nested package.json files in an external package
+         * For internal packages, assumes there are no nested package.json files.
+         * @param context - The context to find nested package.json files for
+         * @returns A promise that resolves when the nested package.json files are found, if applicable
+         */
+        async function findNestedPackageJsonsForContextAsync(context) {
+            const { descriptionFileRoot, descriptionFileHash } = context;
+            if (descriptionFileHash === undefined) {
+                // Assume this package has no nested package json files for now.
+                terminal.writeDebugLine(`Package at ${descriptionFileRoot} does not having a file list. Assuming no nested "package.json" files.`);
+                return;
+            }
+            // Convert an integrity hash like
+            // sha512-C6uiGQJ+Gt4RyHXXYt+v9f+SN1v83x68URwgxNQ98cvH8kxiuywWGP4XeNZ1paOzZ63aY3cTciCEQJNFUljlLw==
+            // To its hex representation, e.g.
+            // 0baba219027e1ade11c875d762dfaff5ff92375bfcdf1ebc511c20c4d43df1cbc7f24c62bb2c1618fe1778d675a5a3b367adda6377137220844093455258e52f
+            const prefixIndex = descriptionFileHash.indexOf('-');
+            const hash = Buffer.from(descriptionFileHash.slice(prefixIndex + 1), 'base64').toString('hex');
+            // The pnpm store directory has index files of package contents at paths:
+            // <store>/v3/files/<hash (0-2)>/<hash (2-)>-index.json
+            // See https://github.com/pnpm/pnpm/blob/f394cfccda7bc519ceee8c33fc9b68a0f4235532/store/cafs/src/getFilePathInCafs.ts#L33
+            const indexPath = `${pnpmStoreDir}${hash.slice(0, 2)}/${hash.slice(2)}-index.json`;
+            try {
+                const indexContent = await externals_1.FileSystem.readFileAsync(indexPath);
+                const { files } = JSON.parse(indexContent);
+                const filteredFiles = Object.keys(files).filter((file) => file.endsWith('/package.json'));
+                if (filteredFiles.length > 0) {
+                    // eslint-disable-next-line require-atomic-updates
+                    context.files = filteredFiles.map((x) => x.slice(0, -13));
+                }
+            }
+            catch (error) {
+                if (!context.optional) {
+                    throw new Error(`Error reading index file for: "${context.descriptionFileRoot}" (${descriptionFileHash})`);
+                }
+                else {
+                    terminal.writeLine(`Trimming missing optional dependency at: ${descriptionFileRoot}`);
+                    contexts.delete(descriptionFileRoot);
+                    missingOptionalDependencies.add(descriptionFileRoot);
+                }
+            }
+        }
+        // For external packages, update the contexts with data from the pnpm store
+        // This gives us the list of nested package.json files, as well as the actual package name
+        // We could also cache package.json contents, but that proves to be inefficient.
+        await externals_1.Async.forEachAsync(contexts.values(), findNestedPackageJsonsForContextAsync, {
+            concurrency: 20
+        });
+    }
+    const cacheFile = await (0, computeResolverCacheFromLockfileAsync_1.computeResolverCacheFromLockfileAsync)({
+        workspaceRoot,
+        commonPrefixToTrim: rushRoot,
+        platformInfo: getPlatformInfo(),
+        projectByImporterPath,
+        lockfile: lockFile,
+        afterExternalPackagesAsync
+    });
+    const serialized = JSON.stringify(cacheFile);
+    await externals_1.FileSystem.writeFileAsync(cacheFilePath, serialized, {
+        ensureFolderExists: true
+    });
+}
+exports.afterInstallAsync = afterInstallAsync;
+//# sourceMappingURL=afterInstallAsync.js.map

package/lib/afterInstallAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"afterInstallAsync.js","sourceRoot":"","sources":["../src/afterInstallAsync.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 type {\n  RushSession,\n  RushConfiguration,\n  RushConfigurationProject,\n  ILogger,\n  LookupByPath,\n  Subspace\n} from '@rushstack/rush-sdk';\nimport type { IResolverCacheFile } from '@rushstack/webpack-workspace-resolve-plugin';\n\nimport { Async, FileSystem, PnpmShrinkwrapFile } from './externals';\nimport {\n  computeResolverCacheFromLockfileAsync,\n  type IPlatformInfo\n} from './computeResolverCacheFromLockfileAsync';\nimport type { IResolverContext } from './types';\n\n/**\n * Gets information used to determine compatibility of optional dependencies.\n * @returns Information about the platform Rush is running on\n */\nfunction getPlatformInfo(): IPlatformInfo {\n  // Acquiring the libc version is a bit more obnoxious than platform and arch,\n  // but all of them are ultimately on the same object.\n  const {\n    platform: os,\n    arch: cpu,\n    glibcVersionRuntime\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  } = (process.report?.getReport() as any)?.header ?? process;\n  const libc: 'glibc' | 'musl' = glibcVersionRuntime ? 'glibc' : 'musl';\n\n  return {\n    os,\n    cpu,\n    libc\n  };\n}\n\n/**\n * Plugin entry point for after install.\n * @param rushSession - The Rush Session\n * @param rushConfiguration - The Rush Configuration\n * @param subspace - The subspace that was just installed\n * @param logger - The initialized logger\n */\nexport async function afterInstallAsync(\n  rushSession: RushSession,\n  rushConfiguration: RushConfiguration,\n  subspace: Subspace,\n  logger: ILogger\n): Promise<void> {\n  const { terminal } = logger;\n  const rushRoot: string = `${rushConfiguration.rushJsonFolder}/`;\n\n  const lockFilePath: string = subspace.getCommittedShrinkwrapFilename();\n  const workspaceRoot: string = subspace.getSubspaceTempFolderPath();\n\n  const projectByImporterPath: LookupByPath<RushConfigurationProject> =\n    rushConfiguration.getProjectLookupForRoot(workspaceRoot);\n\n  const pnpmStoreDir: string = `${rushConfiguration.pnpmOptions.pnpmStorePath}/v3/files/`;\n\n  terminal.writeLine(`Using pnpm-lock from: ${lockFilePath}`);\n  terminal.writeLine(`Using pnpm store folder: ${pnpmStoreDir}`);\n\n  const lockFile: PnpmShrinkwrapFile | undefined = PnpmShrinkwrapFile.loadFromFile(lockFilePath, {\n    withCaching: true\n  });\n  if (!lockFile) {\n    throw new Error(`Failed to load shrinkwrap file: ${lockFilePath}`);\n  }\n\n  const cacheFilePath: string = `${workspaceRoot}/resolver-cache.json`;\n\n  terminal.writeLine(`Resolver cache will be written at ${cacheFilePath}`);\n\n  async function afterExternalPackagesAsync(\n    contexts: Map<string, IResolverContext>,\n    missingOptionalDependencies: Set<string>\n  ): Promise<void> {\n    /**\n     * Loads the index file from the pnpm store to discover nested package.json files in an external package\n     * For internal packages, assumes there are no nested package.json files.\n     * @param context - The context to find nested package.json files for\n     * @returns A promise that resolves when the nested package.json files are found, if applicable\n     */\n    async function findNestedPackageJsonsForContextAsync(context: IResolverContext): Promise<void> {\n      const { descriptionFileRoot, descriptionFileHash } = context;\n\n      if (descriptionFileHash === undefined) {\n        // Assume this package has no nested package json files for now.\n        terminal.writeDebugLine(\n          `Package at ${descriptionFileRoot} does not having a file list. Assuming no nested \"package.json\" files.`\n        );\n        return;\n      }\n\n      // Convert an integrity hash like\n      // sha512-C6uiGQJ+Gt4RyHXXYt+v9f+SN1v83x68URwgxNQ98cvH8kxiuywWGP4XeNZ1paOzZ63aY3cTciCEQJNFUljlLw==\n      // To its hex representation, e.g.\n      // 0baba219027e1ade11c875d762dfaff5ff92375bfcdf1ebc511c20c4d43df1cbc7f24c62bb2c1618fe1778d675a5a3b367adda6377137220844093455258e52f\n      const prefixIndex: number = descriptionFileHash.indexOf('-');\n      const hash: string = Buffer.from(descriptionFileHash.slice(prefixIndex + 1), 'base64').toString('hex');\n\n      // The pnpm store directory has index files of package contents at paths:\n      // <store>/v3/files/<hash (0-2)>/<hash (2-)>-index.json\n      // See https://github.com/pnpm/pnpm/blob/f394cfccda7bc519ceee8c33fc9b68a0f4235532/store/cafs/src/getFilePathInCafs.ts#L33\n      const indexPath: string = `${pnpmStoreDir}${hash.slice(0, 2)}/${hash.slice(2)}-index.json`;\n\n      try {\n        const indexContent: string = await FileSystem.readFileAsync(indexPath);\n        const { files } = JSON.parse(indexContent);\n\n        const filteredFiles: string[] = Object.keys(files).filter((file) => file.endsWith('/package.json'));\n        if (filteredFiles.length > 0) {\n          // eslint-disable-next-line require-atomic-updates\n          context.files = filteredFiles.map((x) => x.slice(0, -13));\n        }\n      } catch (error) {\n        if (!context.optional) {\n          throw new Error(\n            `Error reading index file for: \"${context.descriptionFileRoot}\" (${descriptionFileHash})`\n          );\n        } else {\n          terminal.writeLine(`Trimming missing optional dependency at: ${descriptionFileRoot}`);\n          contexts.delete(descriptionFileRoot);\n          missingOptionalDependencies.add(descriptionFileRoot);\n        }\n      }\n    }\n\n    // For external packages, update the contexts with data from the pnpm store\n    // This gives us the list of nested package.json files, as well as the actual package name\n    // We could also cache package.json contents, but that proves to be inefficient.\n    await Async.forEachAsync(contexts.values(), findNestedPackageJsonsForContextAsync, {\n      concurrency: 20\n    });\n  }\n\n  const cacheFile: IResolverCacheFile = await computeResolverCacheFromLockfileAsync({\n    workspaceRoot,\n    commonPrefixToTrim: rushRoot,\n    platformInfo: getPlatformInfo(),\n    projectByImporterPath,\n    lockfile: lockFile,\n    afterExternalPackagesAsync\n  });\n\n  const serialized: string = JSON.stringify(cacheFile);\n\n  await FileSystem.writeFileAsync(cacheFilePath, serialized, {\n    ensureFolderExists: true\n  });\n}\n"]}

package/lib/computeResolverCacheFromLockfileAsync.d.ts

@@ -0,0 +1,60 @@
+import type { LookupByPath } from '@rushstack/rush-sdk';
+import type { IResolverCacheFile } from '@rushstack/webpack-workspace-resolve-plugin';
+import type { PnpmShrinkwrapFile } from './externals';
+import type { IResolverContext } from './types';
+/**
+ * The only parts of a RushConfigurationProject needed by this tool.
+ * Reduced for unit test typings.
+ */
+export interface IPartialRushProject {
+    projectFolder: string;
+    packageJson: {
+        name: string;
+    };
+}
+export interface IPlatformInfo {
+    os: typeof process.platform;
+    cpu: typeof process.arch;
+    libc: 'glibc' | 'musl';
+}
+/**
+ * Options for computing the resolver cache from a lockfile.
+ */
+export interface IComputeResolverCacheFromLockfileOptions {
+    /**
+     * The root folder of the workspace being installed
+     */
+    workspaceRoot: string;
+    /**
+     * The common root path to trim from the description file roots for brevity
+     */
+    commonPrefixToTrim: string;
+    /**
+     * Information about the platform Rush is running on
+     */
+    platformInfo: IPlatformInfo;
+    /**
+     * A lookup of projects by their importer path
+     */
+    projectByImporterPath: Pick<LookupByPath<IPartialRushProject>, 'findChildPath'>;
+    /**
+     * The lockfile to compute the cache from
+     */
+    lockfile: PnpmShrinkwrapFile;
+    /**
+     * A callback to process external packages after they have been enumerated.
+     * Broken out as a separate function to facilitate testing without hitting the disk.
+     * @remarks This is useful for fetching additional data from the pnpm store
+     * @param contexts - The current context information per description file root
+     * @param missingOptionalDependencies - The set of optional dependencies that were not installed
+     * @returns A promise that resolves when the external packages have been processed
+     */
+    afterExternalPackagesAsync?: (contexts: Map<string, IResolverContext>, missingOptionalDependencies: Set<string>) => Promise<void>;
+}
+/**
+ * Given a lockfile and information about the workspace and platform, computes the resolver cache file.
+ * @param params - The options for computing the resolver cache
+ * @returns A promise that resolves with the resolver cache file
+ */
+export declare function computeResolverCacheFromLockfileAsync(params: IComputeResolverCacheFromLockfileOptions): Promise<IResolverCacheFile>;
+//# sourceMappingURL=computeResolverCacheFromLockfileAsync.d.ts.map

package/lib/computeResolverCacheFromLockfileAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeResolverCacheFromLockfileAsync.d.ts","sourceRoot":"","sources":["../src/computeResolverCacheFromLockfileAsync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,6CAA6C,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC5B,GAAG,EAAE,OAAO,OAAO,CAAC,IAAI,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CACxB;AAkBD;;GAEG;AACH,MAAM,WAAW,wCAAwC;IACvD;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,YAAY,EAAE,aAAa,CAAC;IAC5B;;OAEG;IACH,qBAAqB,EAAE,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,EAAE,eAAe,CAAC,CAAC;IAChF;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,CAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACvC,2BAA2B,EAAE,GAAG,CAAC,MAAM,CAAC,KACrC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,wCAAwC,GAC/C,OAAO,CAAC,kBAAkB,CAAC,CAwG7B"}

package/lib/computeResolverCacheFromLockfileAsync.js

@@ -0,0 +1,105 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeResolverCacheFromLockfileAsync = void 0;
+const helpers_1 = require("./helpers");
+function isPackageCompatible(pack, platformInfo) {
+    var _a, _b, _c;
+    if ((_a = pack.os) === null || _a === void 0 ? void 0 : _a.every((value) => value.toLowerCase() !== platformInfo.os)) {
+        return false;
+    }
+    if ((_b = pack.cpu) === null || _b === void 0 ? void 0 : _b.every((value) => value.toLowerCase() !== platformInfo.cpu)) {
+        return false;
+    }
+    if ((_c = pack.libc) === null || _c === void 0 ? void 0 : _c.every((value) => value.toLowerCase() !== platformInfo.libc)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Given a lockfile and information about the workspace and platform, computes the resolver cache file.
+ * @param params - The options for computing the resolver cache
+ * @returns A promise that resolves with the resolver cache file
+ */
+async function computeResolverCacheFromLockfileAsync(params) {
+    var _a;
+    const { workspaceRoot, commonPrefixToTrim, platformInfo, projectByImporterPath, lockfile, afterExternalPackagesAsync } = params;
+    const contexts = new Map();
+    const missingOptionalDependencies = new Set();
+    // Enumerate external dependencies first, to simplify looping over them for store data
+    for (const [key, pack] of lockfile.packages) {
+        let name = pack.name;
+        const descriptionFileRoot = (0, helpers_1.getDescriptionFileRootFromKey)(workspaceRoot, key, name);
+        // Skip optional dependencies that are incompatible with the current environment
+        if (pack.optional && !isPackageCompatible(pack, platformInfo)) {
+            missingOptionalDependencies.add(descriptionFileRoot);
+            continue;
+        }
+        const integrity = (_a = pack.resolution) === null || _a === void 0 ? void 0 : _a.integrity;
+        if (!name && key.startsWith('/')) {
+            const versionIndex = key.indexOf('@', 2);
+            name = key.slice(1, versionIndex);
+        }
+        if (!name) {
+            throw new Error(`Missing name for ${key}`);
+        }
+        const context = {
+            descriptionFileRoot,
+            descriptionFileHash: integrity,
+            isProject: false,
+            name,
+            deps: new Map(),
+            ordinal: contexts.size,
+            optional: pack.optional
+        };
+        contexts.set(descriptionFileRoot, context);
+        if (pack.dependencies) {
+            (0, helpers_1.resolveDependencies)(workspaceRoot, pack.dependencies, context);
+        }
+        if (pack.optionalDependencies) {
+            (0, helpers_1.resolveDependencies)(workspaceRoot, pack.optionalDependencies, context);
+        }
+    }
+    if (afterExternalPackagesAsync) {
+        await afterExternalPackagesAsync(contexts, missingOptionalDependencies);
+    }
+    // Add the data for workspace projects
+    for (const [importerPath, importer] of lockfile.importers) {
+        // Ignore the root project. This plugin assumes you don't have one.
+        // A non-empty root project results in global dependency hoisting, and that's bad for strictness.
+        if (importerPath === '.') {
+            continue;
+        }
+        const project = projectByImporterPath.findChildPath(importerPath);
+        if (!project) {
+            throw new Error(`Missing project for importer ${importerPath}`);
+        }
+        const context = {
+            descriptionFileRoot: project.projectFolder,
+            descriptionFileHash: undefined, // Not needed anymore
+            name: project.packageJson.name,
+            isProject: true,
+            deps: new Map(),
+            ordinal: contexts.size
+        };
+        contexts.set(project.projectFolder, context);
+        if (importer.dependencies) {
+            (0, helpers_1.resolveDependencies)(workspaceRoot, importer.dependencies, context);
+        }
+        if (importer.devDependencies) {
+            (0, helpers_1.resolveDependencies)(workspaceRoot, importer.devDependencies, context);
+        }
+        if (importer.optionalDependencies) {
+            (0, helpers_1.resolveDependencies)(workspaceRoot, importer.optionalDependencies, context);
+        }
+    }
+    // Convert the intermediate representation to the final cache file
+    const serializedContexts = Array.from(contexts, (0, helpers_1.createContextSerializer)(missingOptionalDependencies, contexts, commonPrefixToTrim));
+    const cacheFile = {
+        contexts: serializedContexts
+    };
+    return cacheFile;
+}
+exports.computeResolverCacheFromLockfileAsync = computeResolverCacheFromLockfileAsync;
+//# sourceMappingURL=computeResolverCacheFromLockfileAsync.js.map

package/lib/computeResolverCacheFromLockfileAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeResolverCacheFromLockfileAsync.js","sourceRoot":"","sources":["../src/computeResolverCacheFromLockfileAsync.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAU3D,uCAAwG;AAoBxG,SAAS,mBAAmB,CAC1B,IAAgE,EAChE,YAA2B;;IAE3B,IAAI,MAAA,IAAI,CAAC,EAAE,0CAAE,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAA,IAAI,CAAC,GAAG,0CAAE,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAA,IAAI,CAAC,IAAI,0CAAE,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAwCD;;;;GAIG;AACI,KAAK,UAAU,qCAAqC,CACzD,MAAgD;;IAEhD,MAAM,EACJ,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,QAAQ,EACR,0BAA0B,EAC3B,GAAG,MAAM,CAAC;IACX,MAAM,QAAQ,GAAkC,IAAI,GAAG,EAAE,CAAC;IAC1D,MAAM,2BAA2B,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE3D,sFAAsF;IACtF,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC5C,IAAI,IAAI,GAAuB,IAAI,CAAC,IAAI,CAAC;QACzC,MAAM,mBAAmB,GAAW,IAAA,uCAA6B,EAAC,aAAa,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAE5F,gFAAgF;QAChF,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;YAC9D,2BAA2B,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YACrD,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAuB,MAAA,IAAI,CAAC,UAAU,0CAAE,SAAS,CAAC;QAEjE,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,YAAY,GAAW,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACjD,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAAqB;YAChC,mBAAmB;YACnB,mBAAmB,EAAE,SAAS;YAC9B,SAAS,EAAE,KAAK;YAChB,IAAI;YACJ,IAAI,EAAE,IAAI,GAAG,EAAE;YACf,OAAO,EAAE,QAAQ,CAAC,IAAI;YACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QAEF,QAAQ,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAE3C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAA,6BAAmB,EAAC,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,IAAA,6BAAmB,EAAC,aAAa,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,IAAI,0BAA0B,EAAE,CAAC;QAC/B,MAAM,0BAA0B,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;IAC1E,CAAC;IAED,sCAAsC;IACtC,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1D,mEAAmE;QACnE,iGAAiG;QACjG,IAAI,YAAY,KAAK,GAAG,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAoC,qBAAqB,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QACnG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,OAAO,GAAqB;YAChC,mBAAmB,EAAE,OAAO,CAAC,aAAa;YAC1C,mBAAmB,EAAE,SAAS,EAAE,qBAAqB;YACrD,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI;YAC9B,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,IAAI,GAAG,EAAE;YACf,OAAO,EAAE,QAAQ,CAAC,IAAI;SACvB,CAAC;QAEF,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAE7C,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAA,6BAAmB,EAAC,aAAa,EAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC7B,IAAA,6BAAmB,EAAC,aAAa,EAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,QAAQ,CAAC,oBAAoB,EAAE,CAAC;YAClC,IAAA,6BAAmB,EAAC,aAAa,EAAE,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,MAAM,kBAAkB,GAAgC,KAAK,CAAC,IAAI,CAChE,QAAQ,EACR,IAAA,iCAAuB,EAAC,2BAA2B,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CACnF,CAAC;IAEF,MAAM,SAAS,GAAuB;QACpC,QAAQ,EAAE,kBAAkB;KAC7B,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC;AA1GD,sFA0GC","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 type { LookupByPath } from '@rushstack/rush-sdk';\nimport type { IPnpmShrinkwrapDependencyYaml } from '@rushstack/rush-sdk/lib/logic/pnpm/PnpmShrinkwrapFile';\nimport type {\n  ISerializedResolveContext,\n  IResolverCacheFile\n} from '@rushstack/webpack-workspace-resolve-plugin';\n\nimport type { PnpmShrinkwrapFile } from './externals';\nimport { getDescriptionFileRootFromKey, resolveDependencies, createContextSerializer } from './helpers';\nimport type { IResolverContext } from './types';\n\n/**\n * The only parts of a RushConfigurationProject needed by this tool.\n * Reduced for unit test typings.\n */\nexport interface IPartialRushProject {\n  projectFolder: string;\n  packageJson: {\n    name: string;\n  };\n}\n\nexport interface IPlatformInfo {\n  os: typeof process.platform;\n  cpu: typeof process.arch;\n  libc: 'glibc' | 'musl';\n}\n\nfunction isPackageCompatible(\n  pack: Pick<IPnpmShrinkwrapDependencyYaml, 'os' | 'cpu' | 'libc'>,\n  platformInfo: IPlatformInfo\n): boolean {\n  if (pack.os?.every((value) => value.toLowerCase() !== platformInfo.os)) {\n    return false;\n  }\n  if (pack.cpu?.every((value) => value.toLowerCase() !== platformInfo.cpu)) {\n    return false;\n  }\n  if (pack.libc?.every((value) => value.toLowerCase() !== platformInfo.libc)) {\n    return false;\n  }\n  return true;\n}\n\n/**\n * Options for computing the resolver cache from a lockfile.\n */\nexport interface IComputeResolverCacheFromLockfileOptions {\n  /**\n   * The root folder of the workspace being installed\n   */\n  workspaceRoot: string;\n  /**\n   * The common root path to trim from the description file roots for brevity\n   */\n  commonPrefixToTrim: string;\n  /**\n   * Information about the platform Rush is running on\n   */\n  platformInfo: IPlatformInfo;\n  /**\n   * A lookup of projects by their importer path\n   */\n  projectByImporterPath: Pick<LookupByPath<IPartialRushProject>, 'findChildPath'>;\n  /**\n   * The lockfile to compute the cache from\n   */\n  lockfile: PnpmShrinkwrapFile;\n  /**\n   * A callback to process external packages after they have been enumerated.\n   * Broken out as a separate function to facilitate testing without hitting the disk.\n   * @remarks This is useful for fetching additional data from the pnpm store\n   * @param contexts - The current context information per description file root\n   * @param missingOptionalDependencies - The set of optional dependencies that were not installed\n   * @returns A promise that resolves when the external packages have been processed\n   */\n  afterExternalPackagesAsync?: (\n    contexts: Map<string, IResolverContext>,\n    missingOptionalDependencies: Set<string>\n  ) => Promise<void>;\n}\n\n/**\n * Given a lockfile and information about the workspace and platform, computes the resolver cache file.\n * @param params - The options for computing the resolver cache\n * @returns A promise that resolves with the resolver cache file\n */\nexport async function computeResolverCacheFromLockfileAsync(\n  params: IComputeResolverCacheFromLockfileOptions\n): Promise<IResolverCacheFile> {\n  const {\n    workspaceRoot,\n    commonPrefixToTrim,\n    platformInfo,\n    projectByImporterPath,\n    lockfile,\n    afterExternalPackagesAsync\n  } = params;\n  const contexts: Map<string, IResolverContext> = new Map();\n  const missingOptionalDependencies: Set<string> = new Set();\n\n  // Enumerate external dependencies first, to simplify looping over them for store data\n  for (const [key, pack] of lockfile.packages) {\n    let name: string | undefined = pack.name;\n    const descriptionFileRoot: string = getDescriptionFileRootFromKey(workspaceRoot, key, name);\n\n    // Skip optional dependencies that are incompatible with the current environment\n    if (pack.optional && !isPackageCompatible(pack, platformInfo)) {\n      missingOptionalDependencies.add(descriptionFileRoot);\n      continue;\n    }\n\n    const integrity: string | undefined = pack.resolution?.integrity;\n\n    if (!name && key.startsWith('/')) {\n      const versionIndex: number = key.indexOf('@', 2);\n      name = key.slice(1, versionIndex);\n    }\n\n    if (!name) {\n      throw new Error(`Missing name for ${key}`);\n    }\n\n    const context: IResolverContext = {\n      descriptionFileRoot,\n      descriptionFileHash: integrity,\n      isProject: false,\n      name,\n      deps: new Map(),\n      ordinal: contexts.size,\n      optional: pack.optional\n    };\n\n    contexts.set(descriptionFileRoot, context);\n\n    if (pack.dependencies) {\n      resolveDependencies(workspaceRoot, pack.dependencies, context);\n    }\n    if (pack.optionalDependencies) {\n      resolveDependencies(workspaceRoot, pack.optionalDependencies, context);\n    }\n  }\n\n  if (afterExternalPackagesAsync) {\n    await afterExternalPackagesAsync(contexts, missingOptionalDependencies);\n  }\n\n  // Add the data for workspace projects\n  for (const [importerPath, importer] of lockfile.importers) {\n    // Ignore the root project. This plugin assumes you don't have one.\n    // A non-empty root project results in global dependency hoisting, and that's bad for strictness.\n    if (importerPath === '.') {\n      continue;\n    }\n\n    const project: IPartialRushProject | undefined = projectByImporterPath.findChildPath(importerPath);\n    if (!project) {\n      throw new Error(`Missing project for importer ${importerPath}`);\n    }\n\n    const context: IResolverContext = {\n      descriptionFileRoot: project.projectFolder,\n      descriptionFileHash: undefined, // Not needed anymore\n      name: project.packageJson.name,\n      isProject: true,\n      deps: new Map(),\n      ordinal: contexts.size\n    };\n\n    contexts.set(project.projectFolder, context);\n\n    if (importer.dependencies) {\n      resolveDependencies(workspaceRoot, importer.dependencies, context);\n    }\n    if (importer.devDependencies) {\n      resolveDependencies(workspaceRoot, importer.devDependencies, context);\n    }\n    if (importer.optionalDependencies) {\n      resolveDependencies(workspaceRoot, importer.optionalDependencies, context);\n    }\n  }\n\n  // Convert the intermediate representation to the final cache file\n  const serializedContexts: ISerializedResolveContext[] = Array.from(\n    contexts,\n    createContextSerializer(missingOptionalDependencies, contexts, commonPrefixToTrim)\n  );\n\n  const cacheFile: IResolverCacheFile = {\n    contexts: serializedContexts\n  };\n\n  return cacheFile;\n}\n"]}

package/lib/externals.d.ts

@@ -0,0 +1,11 @@
+import type { Operation as OperationType, OperationStatus as OperationStatusType } from '@rushstack/rush-sdk';
+import type { PnpmShrinkwrapFile as PnpmShrinkwrapFileType } from '@rushstack/rush-sdk/lib/logic/pnpm/PnpmShrinkwrapFile';
+declare const Operation: typeof OperationType, OperationStatus: typeof OperationStatusType;
+type Operation = OperationType;
+type OperationStatus = OperationStatusType;
+export { Operation, OperationStatus };
+export declare const PnpmShrinkwrapFile: typeof PnpmShrinkwrapFileType;
+export type PnpmShrinkwrapFile = PnpmShrinkwrapFileType;
+export declare const Async: typeof import("@rushstack/node-core-library/lib/Async").Async;
+export declare const FileSystem: typeof import("@rushstack/node-core-library/lib/FileSystem").FileSystem;
+//# sourceMappingURL=externals.d.ts.map

package/lib/externals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"externals.d.ts","sourceRoot":"","sources":["../src/externals.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC9G,OAAO,KAAK,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAO1H,QAAA,MAAQ,SAAS,wBAAE,eAAe,4BAA4B,CAAC;AAE/D,KAAK,SAAS,GAAG,aAAa,CAAC;AAE/B,KAAK,eAAe,GAAG,mBAAmB,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AAgBtC,eAAO,MAAQ,kBAAkB,+BAEyB,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAGxD,eAAO,MAAQ,KAAK,+DAEnB,CAAC;AACF,eAAO,MAAQ,UAAU,yEAExB,CAAC"}

package/lib/externals.js

@@ -0,0 +1,24 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystem = exports.Async = exports.PnpmShrinkwrapFile = exports.OperationStatus = exports.Operation = void 0;
+const { Operation, OperationStatus } = ___rush___rushLibModule;
+exports.Operation = Operation;
+exports.OperationStatus = OperationStatus;
+// Support this plugin being webpacked.
+const req = typeof __non_webpack_require__ === 'function' ? __non_webpack_require__ : require;
+const entryModule = req.main;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getExternal(name) {
+    const externalPath = req.resolve(name, {
+        paths: entryModule === null || entryModule === void 0 ? void 0 : entryModule.paths
+    });
+    return req(externalPath);
+}
+// Private Rush APIs
+exports.PnpmShrinkwrapFile = getExternal('@microsoft/rush-lib/lib/logic/pnpm/PnpmShrinkwrapFile').PnpmShrinkwrapFile;
+// Avoid bundling expensive stuff that's already part of Rush.
+exports.Async = getExternal(`@rushstack/node-core-library/lib/Async`).Async;
+exports.FileSystem = getExternal(`@rushstack/node-core-library/lib/FileSystem`).FileSystem;
+//# sourceMappingURL=externals.js.map

package/lib/externals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externals.js","sourceRoot":"","sources":["../src/externals.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAY3D,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,uBAAuB,CAAC;AAMtD,8BAAS;AAAE,0CAAe;AAEnC,uCAAuC;AACvC,MAAM,GAAG,GAAmB,OAAO,uBAAuB,KAAK,UAAU,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC;AAE9G,MAAM,WAAW,GAAuB,GAAG,CAAC,IAAI,CAAC;AACjD,8DAA8D;AAC9D,SAAS,WAAW,CAAgB,IAAY;IAC9C,MAAM,YAAY,GAAW,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;QAC7C,KAAK,EAAE,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,KAAK;KAC1B,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC;AAC3B,CAAC;AAED,oBAAoB;AACL,0BAAkB,GAAK,WAAW,CAE/C,uDAAuD,CAAC,oBAAC;AAI3D,8DAA8D;AAC/C,aAAK,GAAK,WAAW,CAClC,wCAAwC,CACzC,OAAC;AACa,kBAAU,GAAK,WAAW,CACvC,6CAA6C,CAC9C,YAAC","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 type Module from 'node:module';\n\nimport type { Operation as OperationType, OperationStatus as OperationStatusType } from '@rushstack/rush-sdk';\nimport type { PnpmShrinkwrapFile as PnpmShrinkwrapFileType } from '@rushstack/rush-sdk/lib/logic/pnpm/PnpmShrinkwrapFile';\nimport type * as rushSdkType from '@rushstack/rush-sdk';\n\n// Ultra-cheap \"I am a Rush plugin\" import of rush-lib\n// eslint-disable-next-line @typescript-eslint/naming-convention\ndeclare const ___rush___rushLibModule: typeof rushSdkType;\n\nconst { Operation, OperationStatus } = ___rush___rushLibModule;\n// eslint-disable-next-line @typescript-eslint/no-redeclare\ntype Operation = OperationType;\n// eslint-disable-next-line @typescript-eslint/no-redeclare\ntype OperationStatus = OperationStatusType;\n\nexport { Operation, OperationStatus };\n\n// Support this plugin being webpacked.\nconst req: typeof require = typeof __non_webpack_require__ === 'function' ? __non_webpack_require__ : require;\n\nconst entryModule: Module | undefined = req.main;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction getExternal<TResult = any>(name: string): TResult {\n  const externalPath: string = req.resolve(name, {\n    paths: entryModule?.paths\n  });\n\n  return req(externalPath);\n}\n\n// Private Rush APIs\nexport const { PnpmShrinkwrapFile } = getExternal<\n  typeof import('@rushstack/rush-sdk/lib/logic/pnpm/PnpmShrinkwrapFile')\n>('@microsoft/rush-lib/lib/logic/pnpm/PnpmShrinkwrapFile');\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport type PnpmShrinkwrapFile = PnpmShrinkwrapFileType;\n\n// Avoid bundling expensive stuff that's already part of Rush.\nexport const { Async } = getExternal<typeof import('@rushstack/node-core-library/lib/Async')>(\n  `@rushstack/node-core-library/lib/Async`\n);\nexport const { FileSystem } = getExternal<typeof import('@rushstack/node-core-library/lib/FileSystem')>(\n  `@rushstack/node-core-library/lib/FileSystem`\n);\n"]}

package/lib/helpers.d.ts

@@ -0,0 +1,37 @@
+import type { ISerializedResolveContext } from '@rushstack/webpack-workspace-resolve-plugin';
+import type { IDependencyEntry, IResolverContext } from './types';
+export declare function createBase32Hash(input: string): string;
+export declare function depPathToFilename(depPath: string): string;
+/**
+ * Computes the root folder for a dependency from a reference to it in another package
+ * @param lockfileFolder - The folder that contains the lockfile
+ * @param key - The key of the dependency
+ * @param specifier - The specifier in the lockfile for the dependency
+ * @param context - The owning package
+ * @returns The identifier for the dependency
+ */
+export declare function resolveDependencyKey(lockfileFolder: string, key: string, specifier: string, context: IResolverContext): string;
+/**
+ * Computes the physical path to a dependency based on its entry
+ * @param lockfileFolder - The folder that contains the lockfile during installation
+ * @param key - The key of the dependency
+ * @param name - The name of the dependency, if provided
+ * @returns The physical path to the dependency
+ */
+export declare function getDescriptionFileRootFromKey(lockfileFolder: string, key: string, name?: string): string;
+export declare function resolveDependencies(lockfileFolder: string, collection: Record<string, IDependencyEntry>, context: IResolverContext): void;
+/**
+ *
+ * @param depPath - The path to the dependency
+ * @returns The folder name for the dependency
+ */
+export declare function depPathToFilenameUnescaped(depPath: string): string;
+/**
+ *
+ * @param missingOptionalDependencies - The set of optional dependencies that were not installed
+ * @param contexts - The map of context roots to their respective contexts
+ * @param commonPathPrefix - The common root path to trim
+ * @returns A function that serializes a context into a format that can be written to disk
+ */
+export declare function createContextSerializer(missingOptionalDependencies: Set<string>, contexts: Map<string, IResolverContext>, commonPathPrefix: string): (entry: [string, IResolverContext]) => ISerializedResolveContext;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAE7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMlE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA4BtD;AAGD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASzD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAcR;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAYxG;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC5C,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAON;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,2BAA2B,EAAE,GAAG,CAAC,MAAM,CAAC,EACxC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACvC,gBAAgB,EAAE,MAAM,GACvB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAAK,yBAAyB,CA4BlE"}

package/lib/helpers.js

@@ -0,0 +1,175 @@
+"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.createContextSerializer = exports.depPathToFilenameUnescaped = exports.resolveDependencies = exports.getDescriptionFileRootFromKey = exports.resolveDependencyKey = exports.depPathToFilename = exports.createBase32Hash = void 0;
+const node_crypto_1 = require("node:crypto");
+const path = __importStar(require("node:path"));
+const MAX_LENGTH_WITHOUT_HASH = 120 - 26 - 1;
+const BASE32 = 'abcdefghijklmnopqrstuvwxyz234567'.split('');
+// https://github.com/swansontec/rfc4648.js/blob/ead9c9b4b68e5d4a529f32925da02c02984e772c/src/codec.ts#L82-L118
+function createBase32Hash(input) {
+    const data = (0, node_crypto_1.createHash)('md5').update(input).digest();
+    const mask = 0x1f;
+    let out = '';
+    let bits = 0; // Number of bits currently in the buffer
+    let buffer = 0; // Bits waiting to be written out, MSB first
+    for (let i = 0; i < data.length; ++i) {
+        // eslint-disable-next-line no-bitwise
+        buffer = (buffer << 8) | (0xff & data[i]);
+        bits += 8;
+        // Write out as much as we can:
+        while (bits > 5) {
+            bits -= 5;
+            // eslint-disable-next-line no-bitwise
+            out += BASE32[mask & (buffer >> bits)];
+        }
+    }
+    // Partial character:
+    if (bits) {
+        // eslint-disable-next-line no-bitwise
+        out += BASE32[mask & (buffer << (5 - bits))];
+    }
+    return out;
+}
+exports.createBase32Hash = createBase32Hash;
+// https://github.com/pnpm/pnpm/blob/f394cfccda7bc519ceee8c33fc9b68a0f4235532/packages/dependency-path/src/index.ts#L167-L189
+function depPathToFilename(depPath) {
+    let filename = depPathToFilenameUnescaped(depPath).replace(/[\\/:*?"<>|]/g, '+');
+    if (filename.includes('(')) {
+        filename = filename.replace(/(\)\()|\(/g, '_').replace(/\)$/, '');
+    }
+    if (filename.length > 120 || (filename !== filename.toLowerCase() && !filename.startsWith('file+'))) {
+        return `${filename.substring(0, MAX_LENGTH_WITHOUT_HASH)}_${createBase32Hash(filename)}`;
+    }
+    return filename;
+}
+exports.depPathToFilename = depPathToFilename;
+/**
+ * Computes the root folder for a dependency from a reference to it in another package
+ * @param lockfileFolder - The folder that contains the lockfile
+ * @param key - The key of the dependency
+ * @param specifier - The specifier in the lockfile for the dependency
+ * @param context - The owning package
+ * @returns The identifier for the dependency
+ */
+function resolveDependencyKey(lockfileFolder, key, specifier, context) {
+    if (specifier.startsWith('/')) {
+        return getDescriptionFileRootFromKey(lockfileFolder, specifier);
+    }
+    else if (specifier.startsWith('link:')) {
+        if (context.isProject) {
+            return path.posix.join(context.descriptionFileRoot, specifier.slice(5));
+        }
+        else {
+            return path.posix.join(lockfileFolder, specifier.slice(5));
+        }
+    }
+    else if (specifier.startsWith('file:')) {
+        return getDescriptionFileRootFromKey(lockfileFolder, specifier, key);
+    }
+    else {
+        return getDescriptionFileRootFromKey(lockfileFolder, `/${key}@${specifier}`);
+    }
+}
+exports.resolveDependencyKey = resolveDependencyKey;
+/**
+ * Computes the physical path to a dependency based on its entry
+ * @param lockfileFolder - The folder that contains the lockfile during installation
+ * @param key - The key of the dependency
+ * @param name - The name of the dependency, if provided
+ * @returns The physical path to the dependency
+ */
+function getDescriptionFileRootFromKey(lockfileFolder, key, name) {
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    if (!key.startsWith('file:')) {
+        name = key.slice(1, key.indexOf('@', 2));
+    }
+    if (!name) {
+        throw new Error(`Missing package name for ${key}`);
+    }
+    const originFolder = `${lockfileFolder}/node_modules/.pnpm/${depPathToFilename(key)}/node_modules`;
+    const descriptionFileRoot = `${originFolder}/${name}`;
+    return descriptionFileRoot;
+}
+exports.getDescriptionFileRootFromKey = getDescriptionFileRootFromKey;
+function resolveDependencies(lockfileFolder, collection, context) {
+    for (const [key, value] of Object.entries(collection)) {
+        const version = typeof value === 'string' ? value : value.version;
+        const resolved = resolveDependencyKey(lockfileFolder, key, version, context);
+        context.deps.set(key, resolved);
+    }
+}
+exports.resolveDependencies = resolveDependencies;
+/**
+ *
+ * @param depPath - The path to the dependency
+ * @returns The folder name for the dependency
+ */
+function depPathToFilenameUnescaped(depPath) {
+    if (depPath.indexOf('file:') !== 0) {
+        if (depPath.startsWith('/')) {
+            depPath = depPath.slice(1);
+        }
+        return depPath;
+    }
+    return depPath.replace(':', '+');
+}
+exports.depPathToFilenameUnescaped = depPathToFilenameUnescaped;
+/**
+ *
+ * @param missingOptionalDependencies - The set of optional dependencies that were not installed
+ * @param contexts - The map of context roots to their respective contexts
+ * @param commonPathPrefix - The common root path to trim
+ * @returns A function that serializes a context into a format that can be written to disk
+ */
+function createContextSerializer(missingOptionalDependencies, contexts, commonPathPrefix) {
+    return ([descriptionFileRoot, context]) => {
+        const deps = {};
+        for (const [key, contextRoot] of context.deps) {
+            if (missingOptionalDependencies.has(contextRoot)) {
+                continue;
+            }
+            const resolutionContext = contexts.get(contextRoot);
+            if (!resolutionContext) {
+                throw new Error(`Missing context for ${contextRoot}!`);
+            }
+            deps[key] = resolutionContext.ordinal;
+        }
+        if (!context.name) {
+            throw new Error(`Missing name for ${descriptionFileRoot}`);
+        }
+        const serializedContext = {
+            name: context.name,
+            root: descriptionFileRoot.slice(commonPathPrefix.length),
+            dirInfoFiles: context.files,
+            deps
+        };
+        return serializedContext;
+    };
+}
+exports.createContextSerializer = createContextSerializer;
+//# sourceMappingURL=helpers.js.map

package/lib/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.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 { createHash } from 'node:crypto';\nimport * as path from 'node:path';\n\nimport type { ISerializedResolveContext } from '@rushstack/webpack-workspace-resolve-plugin';\n\nimport type { IDependencyEntry, IResolverContext } from './types';\n\nconst MAX_LENGTH_WITHOUT_HASH: number = 120 - 26 - 1;\nconst BASE32: string[] = 'abcdefghijklmnopqrstuvwxyz234567'.split('');\n\n// https://github.com/swansontec/rfc4648.js/blob/ead9c9b4b68e5d4a529f32925da02c02984e772c/src/codec.ts#L82-L118\nexport function createBase32Hash(input: string): string {\n  const data: Buffer = createHash('md5').update(input).digest();\n\n  const mask: 0x1f = 0x1f;\n  let out: string = '';\n\n  let bits: number = 0; // Number of bits currently in the buffer\n  let buffer: number = 0; // Bits waiting to be written out, MSB first\n  for (let i: number = 0; i < data.length; ++i) {\n    // eslint-disable-next-line no-bitwise\n    buffer = (buffer << 8) | (0xff & data[i]);\n    bits += 8;\n\n    // Write out as much as we can:\n    while (bits > 5) {\n      bits -= 5;\n      // eslint-disable-next-line no-bitwise\n      out += BASE32[mask & (buffer >> bits)];\n    }\n  }\n\n  // Partial character:\n  if (bits) {\n    // eslint-disable-next-line no-bitwise\n    out += BASE32[mask & (buffer << (5 - bits))];\n  }\n\n  return out;\n}\n\n// https://github.com/pnpm/pnpm/blob/f394cfccda7bc519ceee8c33fc9b68a0f4235532/packages/dependency-path/src/index.ts#L167-L189\nexport function depPathToFilename(depPath: string): string {\n  let filename: string = depPathToFilenameUnescaped(depPath).replace(/[\\\\/:*?\"<>|]/g, '+');\n  if (filename.includes('(')) {\n    filename = filename.replace(/(\\)\\()|\\(/g, '_').replace(/\\)$/, '');\n  }\n  if (filename.length > 120 || (filename !== filename.toLowerCase() && !filename.startsWith('file+'))) {\n    return `${filename.substring(0, MAX_LENGTH_WITHOUT_HASH)}_${createBase32Hash(filename)}`;\n  }\n  return filename;\n}\n\n/**\n * Computes the root folder for a dependency from a reference to it in another package\n * @param lockfileFolder - The folder that contains the lockfile\n * @param key - The key of the dependency\n * @param specifier - The specifier in the lockfile for the dependency\n * @param context - The owning package\n * @returns The identifier for the dependency\n */\nexport function resolveDependencyKey(\n  lockfileFolder: string,\n  key: string,\n  specifier: string,\n  context: IResolverContext\n): string {\n  if (specifier.startsWith('/')) {\n    return getDescriptionFileRootFromKey(lockfileFolder, specifier);\n  } else if (specifier.startsWith('link:')) {\n    if (context.isProject) {\n      return path.posix.join(context.descriptionFileRoot, specifier.slice(5));\n    } else {\n      return path.posix.join(lockfileFolder, specifier.slice(5));\n    }\n  } else if (specifier.startsWith('file:')) {\n    return getDescriptionFileRootFromKey(lockfileFolder, specifier, key);\n  } else {\n    return getDescriptionFileRootFromKey(lockfileFolder, `/${key}@${specifier}`);\n  }\n}\n\n/**\n * Computes the physical path to a dependency based on its entry\n * @param lockfileFolder - The folder that contains the lockfile during installation\n * @param key - The key of the dependency\n * @param name - The name of the dependency, if provided\n * @returns The physical path to the dependency\n */\nexport function getDescriptionFileRootFromKey(lockfileFolder: string, key: string, name?: string): string {\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  if (!key.startsWith('file:')) {\n    name = key.slice(1, key.indexOf('@', 2));\n  }\n  if (!name) {\n    throw new Error(`Missing package name for ${key}`);\n  }\n\n  const originFolder: string = `${lockfileFolder}/node_modules/.pnpm/${depPathToFilename(key)}/node_modules`;\n  const descriptionFileRoot: string = `${originFolder}/${name}`;\n  return descriptionFileRoot;\n}\n\nexport function resolveDependencies(\n  lockfileFolder: string,\n  collection: Record<string, IDependencyEntry>,\n  context: IResolverContext\n): void {\n  for (const [key, value] of Object.entries(collection)) {\n    const version: string = typeof value === 'string' ? value : value.version;\n    const resolved: string = resolveDependencyKey(lockfileFolder, key, version, context);\n\n    context.deps.set(key, resolved);\n  }\n}\n\n/**\n *\n * @param depPath - The path to the dependency\n * @returns The folder name for the dependency\n */\nexport function depPathToFilenameUnescaped(depPath: string): string {\n  if (depPath.indexOf('file:') !== 0) {\n    if (depPath.startsWith('/')) {\n      depPath = depPath.slice(1);\n    }\n    return depPath;\n  }\n  return depPath.replace(':', '+');\n}\n\n/**\n *\n * @param missingOptionalDependencies - The set of optional dependencies that were not installed\n * @param contexts - The map of context roots to their respective contexts\n * @param commonPathPrefix - The common root path to trim\n * @returns A function that serializes a context into a format that can be written to disk\n */\nexport function createContextSerializer(\n  missingOptionalDependencies: Set<string>,\n  contexts: Map<string, IResolverContext>,\n  commonPathPrefix: string\n): (entry: [string, IResolverContext]) => ISerializedResolveContext {\n  return ([descriptionFileRoot, context]: [string, IResolverContext]): ISerializedResolveContext => {\n    const deps: ISerializedResolveContext['deps'] = {};\n    for (const [key, contextRoot] of context.deps) {\n      if (missingOptionalDependencies.has(contextRoot)) {\n        continue;\n      }\n\n      const resolutionContext: IResolverContext | undefined = contexts.get(contextRoot);\n      if (!resolutionContext) {\n        throw new Error(`Missing context for ${contextRoot}!`);\n      }\n      deps[key] = resolutionContext.ordinal;\n    }\n\n    if (!context.name) {\n      throw new Error(`Missing name for ${descriptionFileRoot}`);\n    }\n\n    const serializedContext: ISerializedResolveContext = {\n      name: context.name,\n      root: descriptionFileRoot.slice(commonPathPrefix.length),\n      dirInfoFiles: context.files,\n      deps\n    };\n\n    return serializedContext;\n  };\n}\n"]}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+import type { IRushPlugin, RushSession, RushConfiguration } from '@rushstack/rush-sdk';
+/**
+ * Plugin that caches information from the package manager after installation to speed up resolution of imports.
+ * @beta
+ */
+export default class RushResolverCachePlugin implements IRushPlugin {
+    readonly pluginName: 'RushResolverCachePlugin';
+    apply(rushSession: RushSession, rushConfiguration: RushConfiguration): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EAIlB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAwB,YAAW,WAAW;IACjE,SAAgB,UAAU,EAAE,yBAAyB,CAA6B;IAE3E,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,IAAI;CAkCnF"}

package/lib/index.js

@@ -0,0 +1,60 @@
+"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 });
+/**
+ * Plugin that caches information from the package manager after installation to speed up resolution of imports.
+ * @beta
+ */
+class RushResolverCachePlugin {
+    constructor() {
+        this.pluginName = 'RushResolverCachePlugin';
+    }
+    apply(rushSession, rushConfiguration) {
+        rushSession.hooks.afterInstall.tapPromise(this.pluginName, async (command, subspace) => {
+            const logger = rushSession.getLogger('RushResolverCachePlugin');
+            if (rushConfiguration.packageManager !== 'pnpm') {
+                logger.emitError(new Error('The RushResolverCachePlugin currently only supports the "pnpm" package manager'));
+                return;
+            }
+            const pnpmMajorVersion = parseInt(rushConfiguration.packageManagerToolVersion.split('.')[0], 
+            /* radix */ 10);
+            // Lockfile format parsing logic changed in pnpm v8.
+            if (pnpmMajorVersion < 8) {
+                logger.emitError(new Error('The RushResolverCachePlugin currently only supports pnpm version >=8'));
+                return;
+            }
+            // This plugin is not currently webpacked, but these comments are here for future proofing.
+            const { afterInstallAsync } = await Promise.resolve().then(() => __importStar(require(
+            /* webpackChunkMode: 'eager' */
+            /* webpackExports: ["afterInstallAsync"] */
+            './afterInstallAsync')));
+            await afterInstallAsync(rushSession, rushConfiguration, subspace, logger);
+        });
+    }
+}
+exports.default = RushResolverCachePlugin;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;AAW3D;;;GAGG;AACH,MAAqB,uBAAuB;IAA5C;QACkB,eAAU,GAA8B,yBAAyB,CAAC;IAoCpF,CAAC;IAlCQ,KAAK,CAAC,WAAwB,EAAE,iBAAoC;QACzE,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CACvC,IAAI,CAAC,UAAU,EACf,KAAK,EAAE,OAAqB,EAAE,QAAkB,EAAE,EAAE;YAClD,MAAM,MAAM,GAAY,WAAW,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;YAEzE,IAAI,iBAAiB,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;gBAChD,MAAM,CAAC,SAAS,CACd,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAC5F,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,gBAAgB,GAAW,QAAQ,CACvC,iBAAiB,CAAC,yBAAyB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACzD,WAAW,CAAC,EAAE,CACf,CAAC;YACF,oDAAoD;YACpD,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC,CAAC;gBACpG,OAAO;YACT,CAAC;YAED,2FAA2F;YAC3F,MAAM,EAAE,iBAAiB,EAAE,GAAG;YAC5B,+BAA+B;YAC/B,2CAA2C;YAC3C,qBAAqB,GACtB,CAAC;YAEF,MAAM,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5E,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AArCD,0CAqCC","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 type {\n  IRushPlugin,\n  RushSession,\n  RushConfiguration,\n  IRushCommand,\n  ILogger,\n  Subspace\n} from '@rushstack/rush-sdk';\n\n/**\n * Plugin that caches information from the package manager after installation to speed up resolution of imports.\n * @beta\n */\nexport default class RushResolverCachePlugin implements IRushPlugin {\n  public readonly pluginName: 'RushResolverCachePlugin' = 'RushResolverCachePlugin';\n\n  public apply(rushSession: RushSession, rushConfiguration: RushConfiguration): void {\n    rushSession.hooks.afterInstall.tapPromise(\n      this.pluginName,\n      async (command: IRushCommand, subspace: Subspace) => {\n        const logger: ILogger = rushSession.getLogger('RushResolverCachePlugin');\n\n        if (rushConfiguration.packageManager !== 'pnpm') {\n          logger.emitError(\n            new Error('The RushResolverCachePlugin currently only supports the \"pnpm\" package manager')\n          );\n          return;\n        }\n\n        const pnpmMajorVersion: number = parseInt(\n          rushConfiguration.packageManagerToolVersion.split('.')[0],\n          /* radix */ 10\n        );\n        // Lockfile format parsing logic changed in pnpm v8.\n        if (pnpmMajorVersion < 8) {\n          logger.emitError(new Error('The RushResolverCachePlugin currently only supports pnpm version >=8'));\n          return;\n        }\n\n        // This plugin is not currently webpacked, but these comments are here for future proofing.\n        const { afterInstallAsync } = await import(\n          /* webpackChunkMode: 'eager' */\n          /* webpackExports: [\"afterInstallAsync\"] */\n          './afterInstallAsync'\n        );\n\n        await afterInstallAsync(rushSession, rushConfiguration, subspace, logger);\n      }\n    );\n  }\n}\n"]}

package/lib/types.d.ts

@@ -0,0 +1,15 @@
+export interface IResolverContext {
+    descriptionFileRoot: string;
+    descriptionFileHash: string | undefined;
+    name: string;
+    deps: Map<string, string>;
+    isProject: boolean;
+    ordinal: number;
+    optional?: boolean;
+    files?: string[];
+}
+export type IDependencyEntry = string | {
+    version: string;
+    specifier: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/lib/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport interface IResolverContext {\n  descriptionFileRoot: string;\n  descriptionFileHash: string | undefined;\n  name: string;\n  deps: Map<string, string>;\n  isProject: boolean;\n  ordinal: number;\n  optional?: boolean;\n  files?: string[];\n}\n\nexport type IDependencyEntry =\n  | string\n  | {\n      version: string;\n      specifier: string;\n    };\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@rushstack/rush-resolver-cache-plugin",
+  "version": "5.133.0",
+  "description": "A Rush plugin that generates a resolver cache file after successful install.",
+  "license": "MIT",
+  "repository": {
+    "url": "https://github.com/microsoft/rushstack.git",
+    "type": "git",
+    "directory": "rush-plugins/rush-resolver-cache-plugin"
+  },
+  "main": "lib-commonjs/index.js",
+  "types": "dist/rush-resolver-cache-plugin.d.ts",
+  "dependencies": {
+    "@rushstack/rush-sdk": "5.133.0"
+  },
+  "devDependencies": {
+    "@types/webpack-env": "1.18.0",
+    "@rushstack/lookup-by-path": "0.1.2",
+    "@rushstack/terminal": "0.14.0",
+    "@rushstack/node-core-library": "5.7.0",
+    "@rushstack/heft": "0.67.0",
+    "local-node-rig": "1.0.0",
+    "@rushstack/webpack-workspace-resolve-plugin": "0.1.1"
+  },
+  "exports": {
+    ".": {
+      "require": "./lib/index.js",
+      "types": "./dist/rush-resolver-cache-plugin.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "dist/rush-resolver-cache-plugin.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "heft test --clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "heft run --only test -- --clean"
+  }
+}

package/rush-plugin-manifest.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/rush/v5/rush-plugin-manifest.schema.json",
+  "plugins": [
+    {
+      "pluginName": "rush-resolver-cache-plugin",
+      "description": "Rush plugin for generating a resolver cache file after successful install.",
+      "entryPoint": "lib/index.js"
+    }
+  ]
+}