@rushstack/webpack-workspace-resolve-plugin 0.1.0

package/CHANGELOG.json

@@ -0,0 +1,17 @@
+{
+  "name": "@rushstack/webpack-workspace-resolve-plugin",
+  "entries": [
+    {
+      "version": "0.1.0",
+      "tag": "@rushstack/webpack-workspace-resolve-plugin_v0.1.0",
+      "date": "Fri, 16 Aug 2024 00:11:49 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Add plugin for more efficient import resolution in a monorepo with known structure. Optimizes lookup of the relevant `package.json` for a given path, and lookup of npm dependencies of the containing package."
+          }
+        ]
+      }
+    }
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log - @rushstack/webpack-workspace-resolve-plugin
+
+This log was last generated on Fri, 16 Aug 2024 00:11:49 GMT and should not be manually modified.
+
+## 0.1.0
+Fri, 16 Aug 2024 00:11:49 GMT
+
+### Minor changes
+
+- Add plugin for more efficient import resolution in a monorepo with known structure. Optimizes lookup of the relevant `package.json` for a given path, and lookup of npm dependencies of the containing package.
+

package/LICENSE

@@ -0,0 +1,24 @@
+@rushstack/webpack-workspace-resolve-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,35 @@
+# @rushstack/webpack-workspace-resolve-plugin
+
+This package contains a plugin for webpack 5 that leverages a cache file generated from package manager metadata to greatly accelerate module resolution.
+Local benchmarks have shown a savings of around 10% of build time for some fairly large closed source projects.
+
+## Installation
+
+`npm install @rushstack/webpack-workspace-resolve-plugin --save-dev`
+
+## Overview
+
+This plugin is intended primarily for use in pnpm monorepos, but any tool that produces a strict package layout can be made compatible by generating the necessary cache file.
+
+The cache file contains information about the locations of every `package.json` file known to the package manager (including those in subdirectories of packages), as well as the list of declared dependencies of each and where they can be found.
+
+When using this plugin, the following options should be configured for your resolver:
+- `symlinks: false` - Since the cache knows the symlinks for package dependencies, you can avoid the cost of testing for other symlinks unless you are using additional symlinks.
+- `modules: []` - The cache should contain all information necessary to locate available dependencies for any arbitrary folder. If you need to allow resolution in other roots, you can add those, but omit `'node_modules'`.
+
+## Limitations
+
+This plugin depends on the presence of a cache file in the workspace to function. Data in this cache file is assumed not to change while the webpack process is running.
+
+**Note:** Generating the cache file is not in the scope of this plugin.
+
+This plugin does not currently support having subdirectory `package.json` files within workspace projects (e.g. for declaring `{ "type": "module" }` in mixed CommonJS/ESM packages).
+This plugin does not work (well) with a hoisted node_modules installation layout.
+
+## Links
+
+- [CHANGELOG.md](
+  https://github.com/microsoft/rushstack/blob/main/webpack/webpack-workspace-resolve-plugin/CHANGELOG.md) - Find
+  out what's new in the latest version
+
+`@rushstack/webpack5-workspace-resolve-plugin` is part of the [Rush Stack](https://rushstack.io/) family of projects.

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.6"
+    }
+  ]
+}

package/dist/webpack-workspace-resolve-plugin.d.ts

@@ -0,0 +1,130 @@
+import type { Compiler } from 'webpack';
+import { IPrefixMatch } from '@rushstack/lookup-by-path';
+import { LookupByPath } from '@rushstack/lookup-by-path';
+import type { WebpackPluginInstance } from 'webpack';
+
+/**
+ * A function that normalizes a path to a platform-specific format (if needed).
+ * Will be undefined if the platform uses `/` as the path separator.
+ *
+ * @beta
+ */
+export declare type IPathNormalizationFunction = ((input: string) => string) | undefined;
+
+/**
+ * A context for resolving dependencies in a workspace.
+ * @beta
+ */
+export declare interface IResolveContext {
+    /**
+     * The absolute path to the root folder of this context
+     */
+    descriptionFileRoot: string;
+    /**
+     * Find the context that corresponds to a module specifier, when requested in the current context.
+     * @param request - The module specifier to resolve
+     */
+    findDependency(request: string): IPrefixMatch<IResolveContext> | undefined;
+}
+
+/**
+ * The serialized form of the cache file. This file is expected to be generated by a separate tool from
+ * information known to the package manager. Namely, the dependency relationships between packages, and
+ * all the `package.json` files in the workspace (installed or local).
+ * @beta
+ */
+export declare interface IResolverCacheFile {
+    /**
+     * The ordered list of all contexts in the cache
+     */
+    contexts: ISerializedResolveContext[];
+}
+
+/**
+ * Information about a local or installed npm package.
+ * @beta
+ */
+export declare interface ISerializedResolveContext {
+    /**
+     * The path to the root folder of this context.
+     * This path is normalized to use `/` as the separator and should not end with a trailing `/`.
+     */
+    root: string;
+    /**
+     * The name of this package. Used to inject a self-reference into the dependency map.
+     */
+    name: string;
+    /**
+     * Map of declared dependencies to the ordinal of the corresponding context.
+     */
+    deps: Record<string, number>;
+    /**
+     * Set of relative paths to nested `package.json` files within this context.
+     * These paths are normalized to use `/` as the separator and should not begin with a leading `./`.
+     */
+    dirInfoFiles?: string[];
+}
+
+/**
+ * Options for creating a `WorkspaceLayoutCache`.
+ * @beta
+ */
+export declare interface IWorkspaceLayoutCacheOptions {
+    /**
+     * The root folder of the workspace. All paths in the cache file are assumed to be relative to this folder.
+     */
+    workspaceRoot: string;
+    /**
+     * The parsed cache data. File reading is left as an exercise for the caller.
+     */
+    cacheData: IResolverCacheFile;
+    /**
+     * The directory separator used in the `path` field of the resolver inputs.
+     * Will usually be `path.sep`.
+     */
+    resolverPathSeparator?: '/' | '\\';
+}
+
+/**
+ * Options for constructing a `WorkspaceResolvePlugin`.
+ *
+ * @beta
+ */
+export declare interface IWorkspaceResolvePluginOptions {
+    /**
+     * The cache of workspace layout information.
+     */
+    cache: WorkspaceLayoutCache;
+}
+
+/**
+ * A cache of workspace layout information.
+ * @beta
+ */
+export declare class WorkspaceLayoutCache {
+    /**
+     * A lookup of context roots to their corresponding context objects
+     */
+    readonly contextLookup: LookupByPath<IResolveContext>;
+    /**
+     * A weak map of package JSON contents to their corresponding context objects
+     */
+    readonly contextForPackage: WeakMap<object, IResolveContext>;
+    readonly resolverPathSeparator: string;
+    readonly normalizeToSlash: IPathNormalizationFunction;
+    readonly normalizeToPlatform: IPathNormalizationFunction;
+    constructor(options: IWorkspaceLayoutCacheOptions);
+}
+
+/**
+ * A Webpack plugin that optimizes package.json lookups and resolution of bare specifiers in a monorepo.
+ *
+ * @beta
+ */
+export declare class WorkspaceResolvePlugin implements WebpackPluginInstance {
+    private readonly _cache;
+    constructor(cache: WorkspaceLayoutCache);
+    apply(compiler: Compiler): void;
+}
+
+export { }

package/lib/KnownDescriptionFilePlugin.d.ts

@@ -0,0 +1,23 @@
+import type { Resolver } from 'webpack';
+import type { WorkspaceLayoutCache } from './WorkspaceLayoutCache';
+/**
+ * A resolver plugin that optimizes locating the package.json file for a module.
+ *
+ * @internal
+ */
+export declare class KnownDescriptionFilePlugin {
+    readonly source: string;
+    readonly target: string;
+    private readonly _skipForContext;
+    private readonly _cache;
+    /**
+     * Constructs a new instance of `KnownDescriptionFilePlugin`.
+     * @param cache - The workspace layout cache
+     * @param source - The resolve step to hook into
+     * @param target - The resolve step to delegate to
+     * @param skipForContext - If true, don't apply this plugin if the resolver is configured to resolve to a context
+     */
+    constructor(cache: WorkspaceLayoutCache, source: string, target: string, skipForContext?: boolean);
+    apply(resolver: Resolver): void;
+}
+//# sourceMappingURL=KnownDescriptionFilePlugin.d.ts.map

package/lib/KnownDescriptionFilePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnownDescriptionFilePlugin.d.ts","sourceRoot":"","sources":["../src/KnownDescriptionFilePlugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,KAAK,EAAmB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAIpF;;;;GAIG;AACH,qBAAa,0BAA0B;IACrC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C;;;;;;OAMG;gBACgB,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO;IAOjG,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CA2FvC"}

package/lib/KnownDescriptionFilePlugin.js

@@ -0,0 +1,95 @@
+"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.KnownDescriptionFilePlugin = void 0;
+/**
+ * A resolver plugin that optimizes locating the package.json file for a module.
+ *
+ * @internal
+ */
+class KnownDescriptionFilePlugin {
+    /**
+     * Constructs a new instance of `KnownDescriptionFilePlugin`.
+     * @param cache - The workspace layout cache
+     * @param source - The resolve step to hook into
+     * @param target - The resolve step to delegate to
+     * @param skipForContext - If true, don't apply this plugin if the resolver is configured to resolve to a context
+     */
+    constructor(cache, source, target, skipForContext) {
+        this.source = source;
+        this.target = target;
+        this._cache = cache;
+        this._skipForContext = !!skipForContext;
+    }
+    apply(resolver) {
+        var _a, _b;
+        if (this._skipForContext && resolver.options.resolveToContext) {
+            return;
+        }
+        const target = resolver.ensureHook(this.target);
+        const { fileSystem } = resolver;
+        function readDescriptionFileWithParse(descriptionFilePath, callback) {
+            fileSystem.readFile(descriptionFilePath, (err, data) => {
+                if (!(data === null || data === void 0 ? void 0 : data.length)) {
+                    return callback(err);
+                }
+                // eslint-disable-next-line @rushstack/no-new-null
+                callback(null, JSON.parse(data.toString()));
+            });
+        }
+        const readDescriptionFile = (_b = (_a = fileSystem.readJson) === null || _a === void 0 ? void 0 : _a.bind(fileSystem)) !== null && _b !== void 0 ? _b : readDescriptionFileWithParse;
+        resolver
+            .getHook(this.source)
+            .tapAsync(KnownDescriptionFilePlugin.name, (request, resolveContext, callback) => {
+            var _a, _b;
+            const { path } = request;
+            if (!path) {
+                // No request, nothing to do.
+                return callback();
+            }
+            const cache = this._cache;
+            const match = cache.contextLookup.findLongestPrefixMatch(path);
+            if (!match) {
+                // No description file available, proceed without.
+                return callback();
+            }
+            const remainingPath = path.slice(match.index);
+            const relativePath = `.${(_b = (_a = cache.normalizeToSlash) === null || _a === void 0 ? void 0 : _a.call(cache, remainingPath)) !== null && _b !== void 0 ? _b : remainingPath}`;
+            const descriptionFileRoot = `${path.slice(0, match.index)}`;
+            const descriptionFilePath = `${descriptionFileRoot}${cache.resolverPathSeparator}package.json`;
+            const { contextForPackage } = cache;
+            readDescriptionFile(descriptionFilePath, (err, descriptionFileData) => {
+                var _a, _b;
+                if (!descriptionFileData) {
+                    (_a = resolveContext.missingDependencies) === null || _a === void 0 ? void 0 : _a.add(descriptionFilePath);
+                    return callback(err);
+                }
+                (_b = resolveContext.fileDependencies) === null || _b === void 0 ? void 0 : _b.add(descriptionFilePath);
+                // Store the resolver context since a WeakMap lookup is cheaper than walking the tree again
+                contextForPackage.set(descriptionFileData, match.value);
+                // Since we don't allow any alternative processing of request, we can mutate it
+                // instead of cloning it.
+                request.descriptionFileRoot = descriptionFileRoot;
+                request.descriptionFilePath = descriptionFilePath;
+                request.descriptionFileData = descriptionFileData;
+                request.relativePath = relativePath;
+                // Delegate to the resolver step at `target`.
+                resolver.doResolve(target, request, 'using description file: ' + descriptionFilePath + ' (relative path: ' + relativePath + ')', resolveContext, (e, result) => {
+                    if (e) {
+                        return callback(e);
+                    }
+                    // Don't allow other processing
+                    if (result === undefined) {
+                        // eslint-disable-next-line @rushstack/no-new-null
+                        return callback(null, null);
+                    }
+                    // eslint-disable-next-line @rushstack/no-new-null
+                    callback(null, result);
+                });
+            });
+        });
+    }
+}
+exports.KnownDescriptionFilePlugin = KnownDescriptionFilePlugin;
+//# sourceMappingURL=KnownDescriptionFilePlugin.js.map

package/lib/KnownDescriptionFilePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnownDescriptionFilePlugin.js","sourceRoot":"","sources":["../src/KnownDescriptionFilePlugin.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 { Resolver } from 'webpack';\nimport type { IPrefixMatch } from '@rushstack/lookup-by-path';\nimport type { IResolveContext, WorkspaceLayoutCache } from './WorkspaceLayoutCache';\n\ntype ResolveRequest = Parameters<Resolver['hooks']['resolveStep']['call']>[1];\n\n/**\n * A resolver plugin that optimizes locating the package.json file for a module.\n *\n * @internal\n */\nexport class KnownDescriptionFilePlugin {\n  public readonly source: string;\n  public readonly target: string;\n\n  private readonly _skipForContext: boolean;\n  private readonly _cache: WorkspaceLayoutCache;\n\n  /**\n   * Constructs a new instance of `KnownDescriptionFilePlugin`.\n   * @param cache - The workspace layout cache\n   * @param source - The resolve step to hook into\n   * @param target - The resolve step to delegate to\n   * @param skipForContext - If true, don't apply this plugin if the resolver is configured to resolve to a context\n   */\n  public constructor(cache: WorkspaceLayoutCache, source: string, target: string, skipForContext?: boolean) {\n    this.source = source;\n    this.target = target;\n    this._cache = cache;\n    this._skipForContext = !!skipForContext;\n  }\n\n  public apply(resolver: Resolver): void {\n    if (this._skipForContext && resolver.options.resolveToContext) {\n      return;\n    }\n\n    const target: ReturnType<Resolver['ensureHook']> = resolver.ensureHook(this.target);\n    const { fileSystem } = resolver;\n\n    function readDescriptionFileWithParse(\n      descriptionFilePath: string,\n      callback: (err: Error | null | undefined, data?: object) => void\n    ): void {\n      fileSystem.readFile(descriptionFilePath, (err: Error | null | undefined, data?: string | Buffer) => {\n        if (!data?.length) {\n          return callback(err);\n        }\n        // eslint-disable-next-line @rushstack/no-new-null\n        callback(null, JSON.parse(data.toString()));\n      });\n    }\n\n    const readDescriptionFile: (\n      descriptionFilePath: string,\n      cb: (err: Error | null | undefined, data?: object) => void\n    ) => void = fileSystem.readJson?.bind(fileSystem) ?? readDescriptionFileWithParse;\n\n    resolver\n      .getHook(this.source)\n      .tapAsync(KnownDescriptionFilePlugin.name, (request, resolveContext, callback) => {\n        const { path } = request;\n        if (!path) {\n          // No request, nothing to do.\n          return callback();\n        }\n\n        const cache: WorkspaceLayoutCache = this._cache;\n\n        const match: IPrefixMatch<IResolveContext> | undefined =\n          cache.contextLookup.findLongestPrefixMatch(path);\n        if (!match) {\n          // No description file available, proceed without.\n          return callback();\n        }\n\n        const remainingPath: string = path.slice(match.index);\n        const relativePath: string = `.${cache.normalizeToSlash?.(remainingPath) ?? remainingPath}`;\n        const descriptionFileRoot: string = `${path.slice(0, match.index)}`;\n        const descriptionFilePath: string = `${descriptionFileRoot}${cache.resolverPathSeparator}package.json`;\n\n        const { contextForPackage } = cache;\n\n        readDescriptionFile(descriptionFilePath, (err, descriptionFileData) => {\n          if (!descriptionFileData) {\n            resolveContext.missingDependencies?.add(descriptionFilePath);\n            return callback(err);\n          }\n\n          resolveContext.fileDependencies?.add(descriptionFilePath);\n          // Store the resolver context since a WeakMap lookup is cheaper than walking the tree again\n          contextForPackage.set(descriptionFileData, match.value);\n\n          // Since we don't allow any alternative processing of request, we can mutate it\n          // instead of cloning it.\n          request.descriptionFileRoot = descriptionFileRoot;\n          request.descriptionFilePath = descriptionFilePath;\n          request.descriptionFileData = descriptionFileData;\n          request.relativePath = relativePath;\n\n          // Delegate to the resolver step at `target`.\n          resolver.doResolve(\n            target,\n            request,\n            'using description file: ' + descriptionFilePath + ' (relative path: ' + relativePath + ')',\n            resolveContext,\n            (e: Error | undefined, result: ResolveRequest | undefined) => {\n              if (e) {\n                return callback(e);\n              }\n\n              // Don't allow other processing\n              if (result === undefined) {\n                // eslint-disable-next-line @rushstack/no-new-null\n                return callback(null, null);\n              }\n              // eslint-disable-next-line @rushstack/no-new-null\n              callback(null, result);\n            }\n          );\n        });\n      });\n  }\n}\n"]}

package/lib/KnownPackageDependenciesPlugin.d.ts

@@ -0,0 +1,22 @@
+import type { Resolver } from 'webpack';
+import type { WorkspaceLayoutCache } from './WorkspaceLayoutCache';
+/**
+ * A resolver plugin that optimizes resolving installed dependencies for the current package.
+ * Enforces strict resolution.
+ *
+ * @internal
+ */
+export declare class KnownPackageDependenciesPlugin {
+    readonly source: string;
+    readonly target: string;
+    private readonly _cache;
+    /**
+     * Constructs a new instance of `KnownPackageDependenciesPlugin`.
+     * @param cache - The workspace layout cache
+     * @param source - The resolve step to hook into
+     * @param target - The resolve step to delegate to
+     */
+    constructor(cache: WorkspaceLayoutCache, source: string, target: string);
+    apply(resolver: Resolver): void;
+}
+//# sourceMappingURL=KnownPackageDependenciesPlugin.d.ts.map

package/lib/KnownPackageDependenciesPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnownPackageDependenciesPlugin.d.ts","sourceRoot":"","sources":["../src/KnownPackageDependenciesPlugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,KAAK,EAAmB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAIpF;;;;;GAKG;AACH,qBAAa,8BAA8B;IACzC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C;;;;;OAKG;gBACgB,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMvE,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAsDvC"}

package/lib/KnownPackageDependenciesPlugin.js

@@ -0,0 +1,72 @@
+"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.KnownPackageDependenciesPlugin = void 0;
+/**
+ * A resolver plugin that optimizes resolving installed dependencies for the current package.
+ * Enforces strict resolution.
+ *
+ * @internal
+ */
+class KnownPackageDependenciesPlugin {
+    /**
+     * Constructs a new instance of `KnownPackageDependenciesPlugin`.
+     * @param cache - The workspace layout cache
+     * @param source - The resolve step to hook into
+     * @param target - The resolve step to delegate to
+     */
+    constructor(cache, source, target) {
+        this.source = source;
+        this.target = target;
+        this._cache = cache;
+    }
+    apply(resolver) {
+        const target = resolver.ensureHook(this.target);
+        resolver
+            .getHook(this.source)
+            .tapAsync(KnownPackageDependenciesPlugin.name, (request, resolveContext, callback) => {
+            var _a;
+            const { path, request: rawRequest } = request;
+            if (!path) {
+                return callback();
+            }
+            if (!rawRequest) {
+                return callback();
+            }
+            const { descriptionFileData } = request;
+            if (!descriptionFileData) {
+                return callback(new Error(`Expected descriptionFileData for ${path}`));
+            }
+            const cache = this._cache;
+            const context = cache.contextForPackage.get(descriptionFileData);
+            if (!context) {
+                return callback(new Error(`Expected context for ${request.descriptionFileRoot}`));
+            }
+            const match = context.findDependency(rawRequest);
+            if (!match) {
+                return callback();
+            }
+            const isPackageRoot = match.index === rawRequest.length;
+            const fullySpecified = isPackageRoot ? false : request.fullySpecified;
+            const remainingPath = isPackageRoot ? '.' : `.${rawRequest.slice(match.index)}`;
+            const relativePath = (remainingPath.length > 1 && ((_a = cache.normalizeToSlash) === null || _a === void 0 ? void 0 : _a.call(cache, remainingPath))) || remainingPath;
+            const { descriptionFileRoot } = match.value;
+            const obj = {
+                ...request,
+                path: descriptionFileRoot,
+                descriptionFileRoot,
+                descriptionFileData: undefined,
+                descriptionFilePath: `${descriptionFileRoot}${cache.resolverPathSeparator}package.json`,
+                relativePath: relativePath,
+                request: relativePath,
+                fullySpecified,
+                module: false
+            };
+            // eslint-disable-next-line @rushstack/no-new-null
+            resolver.doResolve(target, obj, null, resolveContext, callback);
+        });
+    }
+}
+exports.KnownPackageDependenciesPlugin = KnownPackageDependenciesPlugin;
+//# sourceMappingURL=KnownPackageDependenciesPlugin.js.map

package/lib/KnownPackageDependenciesPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnownPackageDependenciesPlugin.js","sourceRoot":"","sources":["../src/KnownPackageDependenciesPlugin.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAQ3D;;;;;GAKG;AACH,MAAa,8BAA8B;IAMzC;;;;;OAKG;IACH,YAAmB,KAA2B,EAAE,MAAc,EAAE,MAAc;QAC5E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,QAAkB;QAC7B,MAAM,MAAM,GAAuC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpF,QAAQ;aACL,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;aACpB,QAAQ,CAAC,8BAA8B,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE;;YACnF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;YAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,QAAQ,EAAE,CAAC;YACpB,CAAC;YAED,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,QAAQ,EAAE,CAAC;YACpB,CAAC;YAED,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC;YACxC,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACzB,OAAO,QAAQ,CAAC,IAAI,KAAK,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,KAAK,GAAyB,IAAI,CAAC,MAAM,CAAC;YAEhD,MAAM,OAAO,GAAgC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YAC9F,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC,IAAI,KAAK,CAAC,wBAAwB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;YACpF,CAAC;YAED,MAAM,KAAK,GAA8C,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAC5F,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,QAAQ,EAAE,CAAC;YACpB,CAAC;YAED,MAAM,aAAa,GAAY,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,MAAM,CAAC;YACjE,MAAM,cAAc,GAAwB,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;YAC3F,MAAM,aAAa,GAAW,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACxF,MAAM,YAAY,GAChB,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,KAAI,MAAA,KAAK,CAAC,gBAAgB,sDAAG,aAAa,CAAC,CAAA,CAAC,IAAI,aAAa,CAAC;YACzF,MAAM,EAAE,mBAAmB,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;YAC5C,MAAM,GAAG,GAAmB;gBAC1B,GAAG,OAAO;gBACV,IAAI,EAAE,mBAAmB;gBACzB,mBAAmB;gBACnB,mBAAmB,EAAE,SAAS;gBAC9B,mBAAmB,EAAE,GAAG,mBAAmB,GAAG,KAAK,CAAC,qBAAqB,cAAc;gBAEvF,YAAY,EAAE,YAAY;gBAC1B,OAAO,EAAE,YAAY;gBACrB,cAAc;gBACd,MAAM,EAAE,KAAK;aACd,CAAC;YACF,kDAAkD;YAClD,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACP,CAAC;CACF;AAxED,wEAwEC","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 { Resolver } from 'webpack';\nimport type { IPrefixMatch } from '@rushstack/lookup-by-path';\nimport type { IResolveContext, WorkspaceLayoutCache } from './WorkspaceLayoutCache';\n\ntype ResolveRequest = Parameters<Resolver['hooks']['resolveStep']['call']>[1];\n\n/**\n * A resolver plugin that optimizes resolving installed dependencies for the current package.\n * Enforces strict resolution.\n *\n * @internal\n */\nexport class KnownPackageDependenciesPlugin {\n  public readonly source: string;\n  public readonly target: string;\n\n  private readonly _cache: WorkspaceLayoutCache;\n\n  /**\n   * Constructs a new instance of `KnownPackageDependenciesPlugin`.\n   * @param cache - The workspace layout cache\n   * @param source - The resolve step to hook into\n   * @param target - The resolve step to delegate to\n   */\n  public constructor(cache: WorkspaceLayoutCache, source: string, target: string) {\n    this.source = source;\n    this.target = target;\n    this._cache = cache;\n  }\n\n  public apply(resolver: Resolver): void {\n    const target: ReturnType<Resolver['ensureHook']> = resolver.ensureHook(this.target);\n\n    resolver\n      .getHook(this.source)\n      .tapAsync(KnownPackageDependenciesPlugin.name, (request, resolveContext, callback) => {\n        const { path, request: rawRequest } = request;\n        if (!path) {\n          return callback();\n        }\n\n        if (!rawRequest) {\n          return callback();\n        }\n\n        const { descriptionFileData } = request;\n        if (!descriptionFileData) {\n          return callback(new Error(`Expected descriptionFileData for ${path}`));\n        }\n\n        const cache: WorkspaceLayoutCache = this._cache;\n\n        const context: IResolveContext | undefined = cache.contextForPackage.get(descriptionFileData);\n        if (!context) {\n          return callback(new Error(`Expected context for ${request.descriptionFileRoot}`));\n        }\n\n        const match: IPrefixMatch<IResolveContext> | undefined = context.findDependency(rawRequest);\n        if (!match) {\n          return callback();\n        }\n\n        const isPackageRoot: boolean = match.index === rawRequest.length;\n        const fullySpecified: boolean | undefined = isPackageRoot ? false : request.fullySpecified;\n        const remainingPath: string = isPackageRoot ? '.' : `.${rawRequest.slice(match.index)}`;\n        const relativePath: string =\n          (remainingPath.length > 1 && cache.normalizeToSlash?.(remainingPath)) || remainingPath;\n        const { descriptionFileRoot } = match.value;\n        const obj: ResolveRequest = {\n          ...request,\n          path: descriptionFileRoot,\n          descriptionFileRoot,\n          descriptionFileData: undefined,\n          descriptionFilePath: `${descriptionFileRoot}${cache.resolverPathSeparator}package.json`,\n\n          relativePath: relativePath,\n          request: relativePath,\n          fullySpecified,\n          module: false\n        };\n        // eslint-disable-next-line @rushstack/no-new-null\n        resolver.doResolve(target, obj, null, resolveContext, callback);\n      });\n  }\n}\n"]}

package/lib/WorkspaceLayoutCache.d.ts

@@ -0,0 +1,97 @@
+import { LookupByPath, type IPrefixMatch } from '@rushstack/lookup-by-path';
+/**
+ * Information about a local or installed npm package.
+ * @beta
+ */
+export interface ISerializedResolveContext {
+    /**
+     * The path to the root folder of this context.
+     * This path is normalized to use `/` as the separator and should not end with a trailing `/`.
+     */
+    root: string;
+    /**
+     * The name of this package. Used to inject a self-reference into the dependency map.
+     */
+    name: string;
+    /**
+     * Map of declared dependencies to the ordinal of the corresponding context.
+     */
+    deps: Record<string, number>;
+    /**
+     * Set of relative paths to nested `package.json` files within this context.
+     * These paths are normalized to use `/` as the separator and should not begin with a leading `./`.
+     */
+    dirInfoFiles?: string[];
+}
+/**
+ * The serialized form of the cache file. This file is expected to be generated by a separate tool from
+ * information known to the package manager. Namely, the dependency relationships between packages, and
+ * all the `package.json` files in the workspace (installed or local).
+ * @beta
+ */
+export interface IResolverCacheFile {
+    /**
+     * The ordered list of all contexts in the cache
+     */
+    contexts: ISerializedResolveContext[];
+}
+/**
+ * A context for resolving dependencies in a workspace.
+ * @beta
+ */
+export interface IResolveContext {
+    /**
+     * The absolute path to the root folder of this context
+     */
+    descriptionFileRoot: string;
+    /**
+     * Find the context that corresponds to a module specifier, when requested in the current context.
+     * @param request - The module specifier to resolve
+     */
+    findDependency(request: string): IPrefixMatch<IResolveContext> | undefined;
+}
+/**
+ * Options for creating a `WorkspaceLayoutCache`.
+ * @beta
+ */
+export interface IWorkspaceLayoutCacheOptions {
+    /**
+     * The root folder of the workspace. All paths in the cache file are assumed to be relative to this folder.
+     */
+    workspaceRoot: string;
+    /**
+     * The parsed cache data. File reading is left as an exercise for the caller.
+     */
+    cacheData: IResolverCacheFile;
+    /**
+     * The directory separator used in the `path` field of the resolver inputs.
+     * Will usually be `path.sep`.
+     */
+    resolverPathSeparator?: '/' | '\\';
+}
+/**
+ * A function that normalizes a path to a platform-specific format (if needed).
+ * Will be undefined if the platform uses `/` as the path separator.
+ *
+ * @beta
+ */
+export type IPathNormalizationFunction = ((input: string) => string) | undefined;
+/**
+ * A cache of workspace layout information.
+ * @beta
+ */
+export declare class WorkspaceLayoutCache {
+    /**
+     * A lookup of context roots to their corresponding context objects
+     */
+    readonly contextLookup: LookupByPath<IResolveContext>;
+    /**
+     * A weak map of package JSON contents to their corresponding context objects
+     */
+    readonly contextForPackage: WeakMap<object, IResolveContext>;
+    readonly resolverPathSeparator: string;
+    readonly normalizeToSlash: IPathNormalizationFunction;
+    readonly normalizeToPlatform: IPathNormalizationFunction;
+    constructor(options: IWorkspaceLayoutCacheOptions);
+}
+//# sourceMappingURL=WorkspaceLayoutCache.d.ts.map

package/lib/WorkspaceLayoutCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceLayoutCache.d.ts","sourceRoot":"","sources":["../src/WorkspaceLayoutCache.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,yBAAyB,EAAE,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,eAAe,CAAC,GAAG,SAAS,CAAC;CAC5E;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,EAAE,kBAAkB,CAAC;IAC9B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;AAUjF;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,SAAgB,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;IAC7D;;OAEG;IACH,SAAgB,iBAAiB,EAAE,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAEpE,SAAgB,qBAAqB,EAAE,MAAM,CAAC;IAC9C,SAAgB,gBAAgB,EAAE,0BAA0B,CAAC;IAC7D,SAAgB,mBAAmB,EAAE,0BAA0B,CAAC;gBAE7C,OAAO,EAAE,4BAA4B;CAoFzD"}

package/lib/WorkspaceLayoutCache.js

@@ -0,0 +1,86 @@
+"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.WorkspaceLayoutCache = void 0;
+const node_path_1 = require("node:path");
+const lookup_by_path_1 = require("@rushstack/lookup-by-path");
+function backslashToSlash(path) {
+    return path.replace(/\\/g, '/');
+}
+function slashToBackslash(path) {
+    return path.replace(/\//g, '\\');
+}
+/**
+ * A cache of workspace layout information.
+ * @beta
+ */
+class WorkspaceLayoutCache {
+    constructor(options) {
+        const { workspaceRoot, cacheData, resolverPathSeparator = node_path_1.sep } = options;
+        if (resolverPathSeparator !== '/' && resolverPathSeparator !== '\\') {
+            throw new Error(`Unsupported directory separator: ${resolverPathSeparator}`);
+        }
+        const resolveContexts = [];
+        const contextLookup = new lookup_by_path_1.LookupByPath(undefined, resolverPathSeparator);
+        this.contextLookup = contextLookup;
+        this.contextForPackage = new WeakMap();
+        const normalizeToSlash = resolverPathSeparator === '\\' ? backslashToSlash : undefined;
+        const normalizeToPlatform = resolverPathSeparator === '\\' ? slashToBackslash : undefined;
+        this.resolverPathSeparator = resolverPathSeparator;
+        this.normalizeToSlash = normalizeToSlash;
+        this.normalizeToPlatform = normalizeToPlatform;
+        // Internal class due to coupling to `resolveContexts`
+        class ResolveContext {
+            constructor(serialized) {
+                this._serialized = serialized;
+                this._descriptionFileRoot = undefined;
+                this._dependencies = undefined;
+            }
+            get descriptionFileRoot() {
+                var _a;
+                if (!this._descriptionFileRoot) {
+                    this._descriptionFileRoot = `${workspaceRoot}${resolverPathSeparator}${(_a = normalizeToPlatform === null || normalizeToPlatform === void 0 ? void 0 : normalizeToPlatform(this._serialized.root)) !== null && _a !== void 0 ? _a : this._serialized.root}`;
+                }
+                return this._descriptionFileRoot;
+            }
+            findDependency(request) {
+                if (!this._dependencies) {
+                    // Lazy initialize this object since most packages won't be requested.
+                    const dependencies = new lookup_by_path_1.LookupByPath(undefined, '/');
+                    // Handle the self-reference scenario
+                    dependencies.setItem(this._serialized.name, this);
+                    for (const [key, ordinal] of Object.entries(this._serialized.deps)) {
+                        // This calls into the array of instances that is owned by WorkpaceLayoutCache
+                        dependencies.setItem(key, resolveContexts[ordinal]);
+                    }
+                    this._dependencies = dependencies;
+                }
+                return this._dependencies.findLongestPrefixMatch(request);
+            }
+        }
+        for (const serialized of cacheData.contexts) {
+            const resolveContext = new ResolveContext(serialized);
+            resolveContexts.push(resolveContext);
+            const descriptionFileRoot = resolveContext.descriptionFileRoot;
+            contextLookup.setItem(descriptionFileRoot, resolveContext);
+            // Handle nested package.json files. These may modify some properties, but the dependency resolution
+            // will match the original package root. Typically these are used to set the `type` field to `module`.
+            if (serialized.dirInfoFiles) {
+                for (const file of serialized.dirInfoFiles) {
+                    contextLookup.setItemFromSegments(concat(
+                    // Root is normalized to platform slashes
+                    lookup_by_path_1.LookupByPath.iteratePathSegments(descriptionFileRoot, resolverPathSeparator), 
+                    // Subpaths are platform-agnostic
+                    lookup_by_path_1.LookupByPath.iteratePathSegments(file, '/')), resolveContext);
+                }
+            }
+        }
+    }
+}
+exports.WorkspaceLayoutCache = WorkspaceLayoutCache;
+function* concat(a, b) {
+    yield* a;
+    yield* b;
+}
+//# sourceMappingURL=WorkspaceLayoutCache.js.map

package/lib/WorkspaceLayoutCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceLayoutCache.js","sourceRoot":"","sources":["../src/WorkspaceLayoutCache.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 { sep as directorySeparator } from 'node:path';\n\nimport { LookupByPath, type IPrefixMatch } from '@rushstack/lookup-by-path';\n\n/**\n * Information about a local or installed npm package.\n * @beta\n */\nexport interface ISerializedResolveContext {\n  /**\n   * The path to the root folder of this context.\n   * This path is normalized to use `/` as the separator and should not end with a trailing `/`.\n   */\n  root: string;\n  /**\n   * The name of this package. Used to inject a self-reference into the dependency map.\n   */\n  name: string;\n  /**\n   * Map of declared dependencies to the ordinal of the corresponding context.\n   */\n  deps: Record<string, number>;\n  /**\n   * Set of relative paths to nested `package.json` files within this context.\n   * These paths are normalized to use `/` as the separator and should not begin with a leading `./`.\n   */\n  dirInfoFiles?: string[];\n}\n\n/**\n * The serialized form of the cache file. This file is expected to be generated by a separate tool from\n * information known to the package manager. Namely, the dependency relationships between packages, and\n * all the `package.json` files in the workspace (installed or local).\n * @beta\n */\nexport interface IResolverCacheFile {\n  /**\n   * The ordered list of all contexts in the cache\n   */\n  contexts: ISerializedResolveContext[];\n}\n\n/**\n * A context for resolving dependencies in a workspace.\n * @beta\n */\nexport interface IResolveContext {\n  /**\n   * The absolute path to the root folder of this context\n   */\n  descriptionFileRoot: string;\n  /**\n   * Find the context that corresponds to a module specifier, when requested in the current context.\n   * @param request - The module specifier to resolve\n   */\n  findDependency(request: string): IPrefixMatch<IResolveContext> | undefined;\n}\n\n/**\n * Options for creating a `WorkspaceLayoutCache`.\n * @beta\n */\nexport interface IWorkspaceLayoutCacheOptions {\n  /**\n   * The root folder of the workspace. All paths in the cache file are assumed to be relative to this folder.\n   */\n  workspaceRoot: string;\n  /**\n   * The parsed cache data. File reading is left as an exercise for the caller.\n   */\n  cacheData: IResolverCacheFile;\n  /**\n   * The directory separator used in the `path` field of the resolver inputs.\n   * Will usually be `path.sep`.\n   */\n  resolverPathSeparator?: '/' | '\\\\';\n}\n\n/**\n * A function that normalizes a path to a platform-specific format (if needed).\n * Will be undefined if the platform uses `/` as the path separator.\n *\n * @beta\n */\nexport type IPathNormalizationFunction = ((input: string) => string) | undefined;\n\nfunction backslashToSlash(path: string): string {\n  return path.replace(/\\\\/g, '/');\n}\n\nfunction slashToBackslash(path: string): string {\n  return path.replace(/\\//g, '\\\\');\n}\n\n/**\n * A cache of workspace layout information.\n * @beta\n */\nexport class WorkspaceLayoutCache {\n  /**\n   * A lookup of context roots to their corresponding context objects\n   */\n  public readonly contextLookup: LookupByPath<IResolveContext>;\n  /**\n   * A weak map of package JSON contents to their corresponding context objects\n   */\n  public readonly contextForPackage: WeakMap<object, IResolveContext>;\n\n  public readonly resolverPathSeparator: string;\n  public readonly normalizeToSlash: IPathNormalizationFunction;\n  public readonly normalizeToPlatform: IPathNormalizationFunction;\n\n  public constructor(options: IWorkspaceLayoutCacheOptions) {\n    const { workspaceRoot, cacheData, resolverPathSeparator = directorySeparator } = options;\n\n    if (resolverPathSeparator !== '/' && resolverPathSeparator !== '\\\\') {\n      throw new Error(`Unsupported directory separator: ${resolverPathSeparator}`);\n    }\n\n    const resolveContexts: IResolveContext[] = [];\n    const contextLookup: LookupByPath<IResolveContext> = new LookupByPath(undefined, resolverPathSeparator);\n\n    this.contextLookup = contextLookup;\n    this.contextForPackage = new WeakMap<object, IResolveContext>();\n\n    const normalizeToSlash: IPathNormalizationFunction =\n      resolverPathSeparator === '\\\\' ? backslashToSlash : undefined;\n    const normalizeToPlatform: IPathNormalizationFunction =\n      resolverPathSeparator === '\\\\' ? slashToBackslash : undefined;\n\n    this.resolverPathSeparator = resolverPathSeparator;\n    this.normalizeToSlash = normalizeToSlash;\n    this.normalizeToPlatform = normalizeToPlatform;\n\n    // Internal class due to coupling to `resolveContexts`\n    class ResolveContext implements IResolveContext {\n      private readonly _serialized: ISerializedResolveContext;\n      private _descriptionFileRoot: string | undefined;\n      private _dependencies: LookupByPath<IResolveContext> | undefined;\n\n      public constructor(serialized: ISerializedResolveContext) {\n        this._serialized = serialized;\n        this._descriptionFileRoot = undefined;\n        this._dependencies = undefined;\n      }\n\n      public get descriptionFileRoot(): string {\n        if (!this._descriptionFileRoot) {\n          this._descriptionFileRoot = `${workspaceRoot}${resolverPathSeparator}${\n            normalizeToPlatform?.(this._serialized.root) ?? this._serialized.root\n          }`;\n        }\n        return this._descriptionFileRoot;\n      }\n\n      public findDependency(request: string): IPrefixMatch<IResolveContext> | undefined {\n        if (!this._dependencies) {\n          // Lazy initialize this object since most packages won't be requested.\n          const dependencies: LookupByPath<IResolveContext> = new LookupByPath(undefined, '/');\n          // Handle the self-reference scenario\n          dependencies.setItem(this._serialized.name, this);\n          for (const [key, ordinal] of Object.entries(this._serialized.deps)) {\n            // This calls into the array of instances that is owned by WorkpaceLayoutCache\n            dependencies.setItem(key, resolveContexts[ordinal]);\n          }\n          this._dependencies = dependencies;\n        }\n\n        return this._dependencies.findLongestPrefixMatch(request);\n      }\n    }\n\n    for (const serialized of cacheData.contexts) {\n      const resolveContext: IResolveContext = new ResolveContext(serialized);\n      resolveContexts.push(resolveContext);\n\n      const descriptionFileRoot: string = resolveContext.descriptionFileRoot;\n      contextLookup.setItem(descriptionFileRoot, resolveContext);\n\n      // Handle nested package.json files. These may modify some properties, but the dependency resolution\n      // will match the original package root. Typically these are used to set the `type` field to `module`.\n      if (serialized.dirInfoFiles) {\n        for (const file of serialized.dirInfoFiles) {\n          contextLookup.setItemFromSegments(\n            concat<string>(\n              // Root is normalized to platform slashes\n              LookupByPath.iteratePathSegments(descriptionFileRoot, resolverPathSeparator),\n              // Subpaths are platform-agnostic\n              LookupByPath.iteratePathSegments(file, '/')\n            ),\n            resolveContext\n          );\n        }\n      }\n    }\n  }\n}\n\nfunction* concat<T>(a: Iterable<T>, b: Iterable<T>): IterableIterator<T> {\n  yield* a;\n  yield* b;\n}\n"]}

package/lib/WorkspaceResolvePlugin.d.ts

@@ -0,0 +1,24 @@
+import type { WebpackPluginInstance, Compiler } from 'webpack';
+import type { WorkspaceLayoutCache } from './WorkspaceLayoutCache';
+/**
+ * Options for constructing a `WorkspaceResolvePlugin`.
+ *
+ * @beta
+ */
+export interface IWorkspaceResolvePluginOptions {
+    /**
+     * The cache of workspace layout information.
+     */
+    cache: WorkspaceLayoutCache;
+}
+/**
+ * A Webpack plugin that optimizes package.json lookups and resolution of bare specifiers in a monorepo.
+ *
+ * @beta
+ */
+export declare class WorkspaceResolvePlugin implements WebpackPluginInstance {
+    private readonly _cache;
+    constructor(cache: WorkspaceLayoutCache);
+    apply(compiler: Compiler): void;
+}
+//# sourceMappingURL=WorkspaceResolvePlugin.d.ts.map

package/lib/WorkspaceResolvePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceResolvePlugin.d.ts","sourceRoot":"","sources":["../src/WorkspaceResolvePlugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAInE;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,qBAAqB;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAE3B,KAAK,EAAE,oBAAoB;IAIvC,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAgCvC"}

package/lib/WorkspaceResolvePlugin.js

@@ -0,0 +1,49 @@
+"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.WorkspaceResolvePlugin = void 0;
+const KnownDescriptionFilePlugin_1 = require("./KnownDescriptionFilePlugin");
+const KnownPackageDependenciesPlugin_1 = require("./KnownPackageDependenciesPlugin");
+/**
+ * A Webpack plugin that optimizes package.json lookups and resolution of bare specifiers in a monorepo.
+ *
+ * @beta
+ */
+class WorkspaceResolvePlugin {
+    constructor(cache) {
+        this._cache = cache;
+    }
+    apply(compiler) {
+        compiler.resolverFactory.hooks.resolveOptions
+            .for('normal')
+            .tap(WorkspaceResolvePlugin.name, (resolveOptions) => {
+            var _a;
+            // Omit default `node_modules`
+            if (resolveOptions.modules) {
+                resolveOptions.modules = resolveOptions.modules.filter((modulePath) => {
+                    return modulePath !== 'node_modules';
+                });
+            }
+            else {
+                resolveOptions.modules = [];
+            }
+            const cache = this._cache;
+            (_a = resolveOptions.plugins) !== null && _a !== void 0 ? _a : (resolveOptions.plugins = []);
+            resolveOptions.plugins.push(
+            // Optimize identifying the package.json file for the issuer
+            new KnownDescriptionFilePlugin_1.KnownDescriptionFilePlugin(cache, 'parsed-resolve', 'described-resolve'), 
+            // Optimize locating the installed dependencies of the current package
+            new KnownPackageDependenciesPlugin_1.KnownPackageDependenciesPlugin(cache, 'raw-module', 'resolve-as-module'), 
+            // Optimize loading the package.json file for the destination package
+            new KnownDescriptionFilePlugin_1.KnownDescriptionFilePlugin(cache, 'relative', 'described-relative'), 
+            // Optimize locating and loading nested package.json for a directory
+            new KnownDescriptionFilePlugin_1.KnownDescriptionFilePlugin(cache, 'undescribed-existing-directory', 'existing-directory', true), 
+            // Optimize locating and loading nested package.json for a file
+            new KnownDescriptionFilePlugin_1.KnownDescriptionFilePlugin(cache, 'undescribed-raw-file', 'raw-file'));
+            return resolveOptions;
+        });
+    }
+}
+exports.WorkspaceResolvePlugin = WorkspaceResolvePlugin;
+//# sourceMappingURL=WorkspaceResolvePlugin.js.map

package/lib/WorkspaceResolvePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceResolvePlugin.js","sourceRoot":"","sources":["../src/WorkspaceResolvePlugin.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAK3D,6EAA0E;AAC1E,qFAAkF;AAclF;;;;GAIG;AACH,MAAa,sBAAsB;IAGjC,YAAmB,KAA2B;QAC5C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,QAAkB;QAC7B,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,cAAc;aAC1C,GAAG,CAAC,QAAQ,CAAC;aACb,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE;;YACnD,8BAA8B;YAC9B,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC3B,cAAc,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,UAAkB,EAAE,EAAE;oBAC5E,OAAO,UAAU,KAAK,cAAc,CAAC;gBACvC,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,cAAc,CAAC,OAAO,GAAG,EAAE,CAAC;YAC9B,CAAC;YAED,MAAM,KAAK,GAAyB,IAAI,CAAC,MAAM,CAAC;YAEhD,MAAA,cAAc,CAAC,OAAO,oCAAtB,cAAc,CAAC,OAAO,GAAK,EAAE,EAAC;YAC9B,cAAc,CAAC,OAAO,CAAC,IAAI;YACzB,4DAA4D;YAC5D,IAAI,uDAA0B,CAAC,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;YAC5E,sEAAsE;YACtE,IAAI,+DAA8B,CAAC,KAAK,EAAE,YAAY,EAAE,mBAAmB,CAAC;YAC5E,qEAAqE;YACrE,IAAI,uDAA0B,CAAC,KAAK,EAAE,UAAU,EAAE,oBAAoB,CAAC;YACvE,oEAAoE;YACpE,IAAI,uDAA0B,CAAC,KAAK,EAAE,gCAAgC,EAAE,oBAAoB,EAAE,IAAI,CAAC;YACnG,+DAA+D;YAC/D,IAAI,uDAA0B,CAAC,KAAK,EAAE,sBAAsB,EAAE,UAAU,CAAC,CAC1E,CAAC;YAEF,OAAO,cAAc,CAAC;QACxB,CAAC,CAAC,CAAC;IACP,CAAC;CACF;AAvCD,wDAuCC","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 { WebpackPluginInstance, Compiler } from 'webpack';\n\nimport type { WorkspaceLayoutCache } from './WorkspaceLayoutCache';\nimport { KnownDescriptionFilePlugin } from './KnownDescriptionFilePlugin';\nimport { KnownPackageDependenciesPlugin } from './KnownPackageDependenciesPlugin';\n\n/**\n * Options for constructing a `WorkspaceResolvePlugin`.\n *\n * @beta\n */\nexport interface IWorkspaceResolvePluginOptions {\n  /**\n   * The cache of workspace layout information.\n   */\n  cache: WorkspaceLayoutCache;\n}\n\n/**\n * A Webpack plugin that optimizes package.json lookups and resolution of bare specifiers in a monorepo.\n *\n * @beta\n */\nexport class WorkspaceResolvePlugin implements WebpackPluginInstance {\n  private readonly _cache: WorkspaceLayoutCache;\n\n  public constructor(cache: WorkspaceLayoutCache) {\n    this._cache = cache;\n  }\n\n  public apply(compiler: Compiler): void {\n    compiler.resolverFactory.hooks.resolveOptions\n      .for('normal')\n      .tap(WorkspaceResolvePlugin.name, (resolveOptions) => {\n        // Omit default `node_modules`\n        if (resolveOptions.modules) {\n          resolveOptions.modules = resolveOptions.modules.filter((modulePath: string) => {\n            return modulePath !== 'node_modules';\n          });\n        } else {\n          resolveOptions.modules = [];\n        }\n\n        const cache: WorkspaceLayoutCache = this._cache;\n\n        resolveOptions.plugins ??= [];\n        resolveOptions.plugins.push(\n          // Optimize identifying the package.json file for the issuer\n          new KnownDescriptionFilePlugin(cache, 'parsed-resolve', 'described-resolve'),\n          // Optimize locating the installed dependencies of the current package\n          new KnownPackageDependenciesPlugin(cache, 'raw-module', 'resolve-as-module'),\n          // Optimize loading the package.json file for the destination package\n          new KnownDescriptionFilePlugin(cache, 'relative', 'described-relative'),\n          // Optimize locating and loading nested package.json for a directory\n          new KnownDescriptionFilePlugin(cache, 'undescribed-existing-directory', 'existing-directory', true),\n          // Optimize locating and loading nested package.json for a file\n          new KnownDescriptionFilePlugin(cache, 'undescribed-raw-file', 'raw-file')\n        );\n\n        return resolveOptions;\n      });\n  }\n}\n"]}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { WorkspaceResolvePlugin, type IWorkspaceResolvePluginOptions } from './WorkspaceResolvePlugin';
+export { WorkspaceLayoutCache, type IPathNormalizationFunction, type IWorkspaceLayoutCacheOptions, type IResolveContext, type ISerializedResolveContext, type IResolverCacheFile } from './WorkspaceLayoutCache';
+//# 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,EAAE,sBAAsB,EAAE,KAAK,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AACvG,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC"}

package/lib/index.js

@@ -0,0 +1,10 @@
+"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.WorkspaceLayoutCache = exports.WorkspaceResolvePlugin = void 0;
+var WorkspaceResolvePlugin_1 = require("./WorkspaceResolvePlugin");
+Object.defineProperty(exports, "WorkspaceResolvePlugin", { enumerable: true, get: function () { return WorkspaceResolvePlugin_1.WorkspaceResolvePlugin; } });
+var WorkspaceLayoutCache_1 = require("./WorkspaceLayoutCache");
+Object.defineProperty(exports, "WorkspaceLayoutCache", { enumerable: true, get: function () { return WorkspaceLayoutCache_1.WorkspaceLayoutCache; } });
+//# 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;;;AAE3D,mEAAuG;AAA9F,gIAAA,sBAAsB,OAAA;AAC/B,+DAOgC;AAN9B,4HAAA,oBAAoB,OAAA","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 { WorkspaceResolvePlugin, type IWorkspaceResolvePluginOptions } from './WorkspaceResolvePlugin';\nexport {\n  WorkspaceLayoutCache,\n  type IPathNormalizationFunction,\n  type IWorkspaceLayoutCacheOptions,\n  type IResolveContext,\n  type ISerializedResolveContext,\n  type IResolverCacheFile\n} from './WorkspaceLayoutCache';\n"]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@rushstack/webpack-workspace-resolve-plugin",
+  "version": "0.1.0",
+  "description": "This plugin leverages workspace-level metadata to greatly accelerate module resolution.",
+  "main": "lib/index.js",
+  "typings": "dist/webpack-workspace-resolve-plugin.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/rushstack.git",
+    "directory": "webpack/webpack-workspace-resolve-plugin"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  },
+  "peerDependencies": {
+    "webpack": "^5.68.0",
+    "@types/node": "*"
+  },
+  "dependencies": {
+    "@rushstack/lookup-by-path": "0.1.1"
+  },
+  "devDependencies": {
+    "memfs": "3.4.3",
+    "webpack": "~5.82.1",
+    "@rushstack/heft": "0.66.26",
+    "local-node-rig": "1.0.0"
+  },
+  "sideEffects": false,
+  "peerDependenciesMeta": {
+    "@types/node": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "heft run --only test -- --clean"
+  }
+}