@rushstack/webpack-workspace-resolve-plugin 0.5.13 → 0.6.0

package/CHANGELOG.json

@@ -1,6 +1,41 @@
 {
   "name": "@rushstack/webpack-workspace-resolve-plugin",
   "entries": [
+    {
+      "version": "0.6.0",
+      "tag": "@rushstack/webpack-workspace-resolve-plugin_v0.6.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/lookup-by-path\" to `0.9.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.0`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.5.14",
+      "tag": "@rushstack/webpack-workspace-resolve-plugin_v0.5.14",
+      "date": "Sat, 07 Feb 2026 01:13:26 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/lookup-by-path\" to `0.8.16`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.1.14`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.5.13",
       "tag": "@rushstack/webpack-workspace-resolve-plugin_v0.5.13",

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Change Log - @rushstack/webpack-workspace-resolve-plugin
 
-This log was last generated on Wed, 04 Feb 2026 20:42:47 GMT and should not be manually modified.
+This log was last generated on Thu, 19 Feb 2026 00:04:53 GMT and should not be manually modified.
+
+## 0.6.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
+
+## 0.5.14
+Sat, 07 Feb 2026 01:13:26 GMT
+
+_Version update only_
 
 ## 0.5.13
 Wed, 04 Feb 2026 20:42:47 GMT

package/dist/tsdoc-metadata.json

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

package/lib-esm/KnownDescriptionFilePlugin.js

@@ -0,0 +1,100 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * A resolver plugin that optimizes locating the package.json file for a module.
+ *
+ * @internal
+ */
+export 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) {
+        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?.length) {
+                    return callback(err);
+                }
+                callback(null, JSON.parse(data.toString()));
+            });
+        }
+        const readDescriptionFile = fileSystem.readJson?.bind(fileSystem) ?? readDescriptionFileWithParse;
+        resolver
+            .getHook(this.source)
+            .tapAsync(KnownDescriptionFilePlugin.name, (request, resolveContext, callback) => {
+            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 = `.${cache.normalizeToSlash?.(remainingPath) ?? remainingPath}`;
+            const descriptionFileRoot = `${path.slice(0, match.index)}`;
+            const descriptionFilePath = `${descriptionFileRoot}${cache.resolverPathSeparator}package.json`;
+            const { contextForPackage } = cache;
+            readDescriptionFile(descriptionFilePath, (err, descriptionFileData) => {
+                if (!descriptionFileData) {
+                    resolveContext.missingDependencies?.add(descriptionFilePath);
+                    return callback(err);
+                }
+                resolveContext.fileDependencies?.add(descriptionFilePath);
+                // Store the resolver context since a WeakMap lookup is cheaper than walking the tree again
+                contextForPackage.set(descriptionFileData, match);
+                // Using the object literal is an order of magnitude faster, at least on node 18.19.1
+                const obj = {
+                    path: request.path,
+                    context: request.context,
+                    descriptionFilePath,
+                    descriptionFileRoot,
+                    descriptionFileData,
+                    relativePath,
+                    ignoreSymlinks: request.ignoreSymlinks,
+                    fullySpecified: request.fullySpecified,
+                    __innerRequest: request.__innerRequest,
+                    __innerRequest_request: request.__innerRequest_request,
+                    __innerRequest_relativePath: request.__innerRequest_relativePath,
+                    request: request.request,
+                    query: request.query,
+                    fragment: request.fragment,
+                    module: request.module,
+                    directory: request.directory,
+                    file: request.file,
+                    internal: request.internal
+                };
+                // Delegate to the resolver step at `target`.
+                resolver.doResolve(target, obj, 'using description file: ' + descriptionFilePath + ' (relative path: ' + relativePath + ')', resolveContext, (e, result) => {
+                    if (e) {
+                        return callback(e);
+                    }
+                    // Don't allow other processing
+                    if (result === undefined) {
+                        return callback(null, null);
+                    }
+                    callback(null, result);
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=KnownDescriptionFilePlugin.js.map

package/lib-esm/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 { InputFileSystem, Resolver } from 'webpack';\n\nimport type { IPrefixMatch } from '@rushstack/lookup-by-path';\n\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    type JsonObjectTypes = ReturnType<NonNullable<InputFileSystem['readJsonSync']>>;\n\n    function readDescriptionFileWithParse(\n      descriptionFilePath: string,\n      callback: (err: Error | null | undefined, data?: JsonObjectTypes) => void\n    ): void {\n      fileSystem.readFile(descriptionFilePath, (err: Error | null | undefined, data?: string | Buffer) => {\n        if (!data?.length) {\n          return callback(err);\n        }\n        callback(null, JSON.parse(data.toString()));\n      });\n    }\n\n    const readDescriptionFile: (\n      descriptionFilePath: string,\n      cb: (err: Error | null | undefined, data?: JsonObjectTypes) => 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);\n\n          // Using the object literal is an order of magnitude faster, at least on node 18.19.1\n          const obj: ResolveRequest = {\n            path: request.path,\n            context: request.context,\n            descriptionFilePath,\n            descriptionFileRoot,\n            descriptionFileData,\n            relativePath,\n            ignoreSymlinks: request.ignoreSymlinks,\n            fullySpecified: request.fullySpecified,\n            __innerRequest: request.__innerRequest,\n            __innerRequest_request: request.__innerRequest_request,\n            __innerRequest_relativePath: request.__innerRequest_relativePath,\n\n            request: request.request,\n            query: request.query,\n            fragment: request.fragment,\n            module: request.module,\n            directory: request.directory,\n            file: request.file,\n            internal: request.internal\n          };\n\n          // Delegate to the resolver step at `target`.\n          resolver.doResolve(\n            target,\n            obj,\n            'using description file: ' + descriptionFilePath + ' (relative path: ' + relativePath + ')',\n            resolveContext,\n            (e: Error | null | undefined, result: ResolveRequest | undefined) => {\n              if (e) {\n                return callback(e);\n              }\n\n              // Don't allow other processing\n              if (result === undefined) {\n                return callback(null, null);\n              }\n              callback(null, result);\n            }\n          );\n        });\n      });\n  }\n}\n"]}

package/lib-esm/KnownPackageDependenciesPlugin.js

@@ -0,0 +1,83 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * A resolver plugin that optimizes resolving installed dependencies for the current package.
+ * Enforces strict resolution.
+ *
+ * @internal
+ */
+export 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) => {
+            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;
+            let scope = cache.contextForPackage.get(descriptionFileData);
+            if (!scope) {
+                scope = cache.contextLookup.findLongestPrefixMatch(path);
+                if (!scope) {
+                    return callback(new Error(`Expected context for ${request.descriptionFileRoot}`));
+                }
+                cache.contextForPackage.set(descriptionFileData, scope);
+            }
+            let dependency;
+            while (scope && !dependency) {
+                dependency = scope.value.findDependency(rawRequest);
+                scope = scope.lastMatch;
+            }
+            if (!dependency) {
+                return callback();
+            }
+            const isPackageRoot = dependency.index === rawRequest.length;
+            const fullySpecified = isPackageRoot ? false : request.fullySpecified;
+            const remainingPath = isPackageRoot ? '.' : `.${rawRequest.slice(dependency.index)}`;
+            const relativePath = (remainingPath.length > 1 && cache.normalizeToSlash?.(remainingPath)) || remainingPath;
+            const { descriptionFileRoot } = dependency.value;
+            const obj = {
+                path: descriptionFileRoot,
+                context: request.context,
+                descriptionFilePath: `${descriptionFileRoot}${cache.resolverPathSeparator}package.json`,
+                descriptionFileRoot,
+                descriptionFileData: undefined,
+                relativePath,
+                ignoreSymlinks: request.ignoreSymlinks,
+                fullySpecified,
+                __innerRequest: request.__innerRequest,
+                __innerRequest_request: request.__innerRequest_request,
+                __innerRequest_relativePath: request.__innerRequest_relativePath,
+                request: relativePath,
+                query: request.query,
+                fragment: request.fragment,
+                module: false,
+                directory: request.directory,
+                file: request.file,
+                internal: request.internal
+            };
+            resolver.doResolve(target, obj, null, resolveContext, callback);
+        });
+    }
+}
+//# sourceMappingURL=KnownPackageDependenciesPlugin.js.map

package/lib-esm/KnownPackageDependenciesPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnownPackageDependenciesPlugin.js","sourceRoot":"","sources":["../src/KnownPackageDependenciesPlugin.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';\n\nimport type { IPrefixMatch } from '@rushstack/lookup-by-path';\n\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        let scope: IPrefixMatch<IResolveContext> | undefined =\n          cache.contextForPackage.get(descriptionFileData);\n        if (!scope) {\n          scope = cache.contextLookup.findLongestPrefixMatch(path);\n          if (!scope) {\n            return callback(new Error(`Expected context for ${request.descriptionFileRoot}`));\n          }\n          cache.contextForPackage.set(descriptionFileData, scope);\n        }\n\n        let dependency: IPrefixMatch<IResolveContext> | undefined;\n        while (scope && !dependency) {\n          dependency = scope.value.findDependency(rawRequest);\n          scope = scope.lastMatch;\n        }\n\n        if (!dependency) {\n          return callback();\n        }\n\n        const isPackageRoot: boolean = dependency.index === rawRequest.length;\n        const fullySpecified: boolean | undefined = isPackageRoot ? false : request.fullySpecified;\n        const remainingPath: string = isPackageRoot ? '.' : `.${rawRequest.slice(dependency.index)}`;\n        const relativePath: string =\n          (remainingPath.length > 1 && cache.normalizeToSlash?.(remainingPath)) || remainingPath;\n        const { descriptionFileRoot } = dependency.value;\n        const obj: ResolveRequest = {\n          path: descriptionFileRoot,\n          context: request.context,\n          descriptionFilePath: `${descriptionFileRoot}${cache.resolverPathSeparator}package.json`,\n          descriptionFileRoot,\n          descriptionFileData: undefined,\n          relativePath,\n          ignoreSymlinks: request.ignoreSymlinks,\n          fullySpecified,\n          __innerRequest: request.__innerRequest,\n          __innerRequest_request: request.__innerRequest_request,\n          __innerRequest_relativePath: request.__innerRequest_relativePath,\n\n          request: relativePath,\n          query: request.query,\n          fragment: request.fragment,\n          module: false,\n          directory: request.directory,\n          file: request.file,\n          internal: request.internal\n        };\n        resolver.doResolve(target, obj, null, resolveContext, callback);\n      });\n  }\n}\n"]}

package/lib-esm/WorkspaceLayoutCache.js

@@ -0,0 +1,85 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { sep as directorySeparator } from 'node:path';
+import { LookupByPath } from '@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
+ */
+export class WorkspaceLayoutCache {
+    constructor(options) {
+        const { cacheData, resolverPathSeparator = directorySeparator } = options;
+        if (resolverPathSeparator !== '/' && resolverPathSeparator !== '\\') {
+            throw new Error(`Unsupported directory separator: ${resolverPathSeparator}`);
+        }
+        const { basePath } = cacheData;
+        const resolveContexts = [];
+        const contextLookup = new 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() {
+                if (!this._descriptionFileRoot) {
+                    const merged = `${basePath}${this._serialized.root}`;
+                    this._descriptionFileRoot = normalizeToPlatform?.(merged) ?? merged;
+                }
+                return this._descriptionFileRoot;
+            }
+            findDependency(request) {
+                if (!this._dependencies) {
+                    // Lazy initialize this object since most packages won't be requested.
+                    const dependencies = new LookupByPath(undefined, '/');
+                    const { name, deps } = this._serialized;
+                    // Handle the self-reference scenario
+                    dependencies.setItem(name, this);
+                    if (deps) {
+                        for (const [key, ordinal] of Object.entries(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);
+            contextLookup.setItemFromSegments(concat(
+            // All paths in the cache file are platform-agnostic
+            LookupByPath.iteratePathSegments(basePath, '/'), LookupByPath.iteratePathSegments(serialized.root, '/')), 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(
+                    // All paths in the cache file are platform-agnostic
+                    concat(LookupByPath.iteratePathSegments(basePath, '/'), LookupByPath.iteratePathSegments(serialized.root, '/')), LookupByPath.iteratePathSegments(file, '/')), resolveContext);
+                }
+            }
+        }
+    }
+}
+function* concat(a, b) {
+    yield* a;
+    yield* b;
+}
+//# sourceMappingURL=WorkspaceLayoutCache.js.map

package/lib-esm/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 (if any) 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 base path. All paths in context entries are prefixed by this path.\n   */\n  basePath: string;\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 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, IPrefixMatch<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 { cacheData, resolverPathSeparator = directorySeparator } = options;\n\n    if (resolverPathSeparator !== '/' && resolverPathSeparator !== '\\\\') {\n      throw new Error(`Unsupported directory separator: ${resolverPathSeparator}`);\n    }\n\n    const { basePath } = cacheData;\n    const resolveContexts: ResolveContext[] = [];\n    const contextLookup: LookupByPath<IResolveContext> = new LookupByPath(undefined, resolverPathSeparator);\n\n    this.contextLookup = contextLookup;\n    this.contextForPackage = new WeakMap<object, IPrefixMatch<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          const merged: string = `${basePath}${this._serialized.root}`;\n          this._descriptionFileRoot = normalizeToPlatform?.(merged) ?? merged;\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\n          const { name, deps } = this._serialized;\n\n          // Handle the self-reference scenario\n          dependencies.setItem(name, this);\n          if (deps) {\n            for (const [key, ordinal] of Object.entries(deps)) {\n              // This calls into the array of instances that is owned by WorkpaceLayoutCache\n              dependencies.setItem(key, resolveContexts[ordinal]);\n            }\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: ResolveContext = new ResolveContext(serialized);\n      resolveContexts.push(resolveContext);\n\n      contextLookup.setItemFromSegments(\n        concat<string>(\n          // All paths in the cache file are platform-agnostic\n          LookupByPath.iteratePathSegments(basePath, '/'),\n          LookupByPath.iteratePathSegments(serialized.root, '/')\n        ),\n        resolveContext\n      );\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              // All paths in the cache file are platform-agnostic\n              concat<string>(\n                LookupByPath.iteratePathSegments(basePath, '/'),\n                LookupByPath.iteratePathSegments(serialized.root, '/')\n              ),\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-esm/WorkspaceResolvePlugin.js

@@ -0,0 +1,50 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { KnownDescriptionFilePlugin } from './KnownDescriptionFilePlugin';
+import { KnownPackageDependenciesPlugin } from './KnownPackageDependenciesPlugin';
+/**
+ * A Webpack plugin that optimizes package.json lookups and resolution of bare specifiers in a monorepo.
+ *
+ * @beta
+ */
+export class WorkspaceResolvePlugin {
+    constructor(options) {
+        this._cache = options.cache;
+        this._resolverNames = new Set(options.resolverNames ?? ['normal', 'context', 'loader']);
+    }
+    apply(compiler) {
+        const cache = this._cache;
+        function handler(resolveOptions) {
+            // Omit default `node_modules`
+            if (resolveOptions.modules) {
+                resolveOptions.modules = resolveOptions.modules.filter((modulePath) => {
+                    return modulePath !== 'node_modules';
+                });
+            }
+            else {
+                resolveOptions.modules = [];
+            }
+            resolveOptions.plugins ?? (resolveOptions.plugins = []);
+            resolveOptions.plugins.push(
+            // Optimize identifying the package.json file for the issuer
+            new KnownDescriptionFilePlugin(cache, 'before-parsed-resolve', 'described-resolve'), 
+            // Optimize locating the installed dependencies of the current package
+            new KnownPackageDependenciesPlugin(cache, 'before-raw-module', 'resolve-as-module'), 
+            // Optimize loading the package.json file for the destination package (bare specifier)
+            new KnownDescriptionFilePlugin(cache, 'before-resolve-as-module', 'resolve-in-package'), 
+            // Optimize loading the package.json file for the destination package (relative path)
+            new KnownDescriptionFilePlugin(cache, 'before-relative', 'described-relative'), 
+            // Optimize locating and loading nested package.json for a directory
+            new KnownDescriptionFilePlugin(cache, 'before-undescribed-existing-directory', 'existing-directory', true), 
+            // Optimize locating and loading nested package.json for a file
+            new KnownDescriptionFilePlugin(cache, 'before-undescribed-raw-file', 'raw-file'));
+            return resolveOptions;
+        }
+        for (const resolverName of this._resolverNames) {
+            compiler.resolverFactory.hooks.resolveOptions
+                .for(resolverName)
+                .tap(WorkspaceResolvePlugin.name, handler);
+        }
+    }
+}
+//# sourceMappingURL=WorkspaceResolvePlugin.js.map

package/lib-esm/WorkspaceResolvePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceResolvePlugin.js","sourceRoot":"","sources":["../src/WorkspaceResolvePlugin.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAK3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAoBlF;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAIjC,YAAmB,OAAuC;QACxD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1F,CAAC;IAEM,KAAK,CAAC,QAAkB;QAC7B,MAAM,KAAK,GAAyB,IAAI,CAAC,MAAM,CAAC;QAEhD,SAAS,OAAO,CAAC,cAA8B;YAC7C,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,cAAc,CAAC,OAAO,KAAtB,cAAc,CAAC,OAAO,GAAK,EAAE,EAAC;YAC9B,cAAc,CAAC,OAAO,CAAC,IAAI;YACzB,4DAA4D;YAC5D,IAAI,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,CAAC;YACnF,sEAAsE;YACtE,IAAI,8BAA8B,CAAC,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;YACnF,sFAAsF;YACtF,IAAI,0BAA0B,CAAC,KAAK,EAAE,0BAA0B,EAAE,oBAAoB,CAAC;YACvF,qFAAqF;YACrF,IAAI,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,CAAC;YAC9E,oEAAoE;YACpE,IAAI,0BAA0B,CAC5B,KAAK,EACL,uCAAuC,EACvC,oBAAoB,EACpB,IAAI,CACL;YACD,+DAA+D;YAC/D,IAAI,0BAA0B,CAAC,KAAK,EAAE,6BAA6B,EAAE,UAAU,CAAC,CACjF,CAAC;YAEF,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,cAAc;iBAC1C,GAAG,CAAC,YAAY,CAAC;iBACjB,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { WebpackPluginInstance, Compiler, ResolveOptions } 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   * Which webpack resolvers to apply the plugin to.\n   * @defaultValue ['normal', 'context', 'loader']\n   */\n  resolverNames?: Iterable<string>;\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  private readonly _resolverNames: Set<string>;\n\n  public constructor(options: IWorkspaceResolvePluginOptions) {\n    this._cache = options.cache;\n    this._resolverNames = new Set(options.resolverNames ?? ['normal', 'context', 'loader']);\n  }\n\n  public apply(compiler: Compiler): void {\n    const cache: WorkspaceLayoutCache = this._cache;\n\n    function handler(resolveOptions: ResolveOptions): 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      resolveOptions.plugins ??= [];\n      resolveOptions.plugins.push(\n        // Optimize identifying the package.json file for the issuer\n        new KnownDescriptionFilePlugin(cache, 'before-parsed-resolve', 'described-resolve'),\n        // Optimize locating the installed dependencies of the current package\n        new KnownPackageDependenciesPlugin(cache, 'before-raw-module', 'resolve-as-module'),\n        // Optimize loading the package.json file for the destination package (bare specifier)\n        new KnownDescriptionFilePlugin(cache, 'before-resolve-as-module', 'resolve-in-package'),\n        // Optimize loading the package.json file for the destination package (relative path)\n        new KnownDescriptionFilePlugin(cache, 'before-relative', 'described-relative'),\n        // Optimize locating and loading nested package.json for a directory\n        new KnownDescriptionFilePlugin(\n          cache,\n          'before-undescribed-existing-directory',\n          'existing-directory',\n          true\n        ),\n        // Optimize locating and loading nested package.json for a file\n        new KnownDescriptionFilePlugin(cache, 'before-undescribed-raw-file', 'raw-file')\n      );\n\n      return resolveOptions;\n    }\n    for (const resolverName of this._resolverNames) {\n      compiler.resolverFactory.hooks.resolveOptions\n        .for(resolverName)\n        .tap(WorkspaceResolvePlugin.name, handler);\n    }\n  }\n}\n"]}

package/lib-esm/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export { WorkspaceResolvePlugin } from './WorkspaceResolvePlugin';
+export { WorkspaceLayoutCache } from './WorkspaceLayoutCache';
+//# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,sBAAsB,EAAuC,MAAM,0BAA0B,CAAC;AACvG,OAAO,EACL,oBAAoB,EAMrB,MAAM,wBAAwB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\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

@@ -1,9 +1,30 @@
 {
   "name": "@rushstack/webpack-workspace-resolve-plugin",
-  "version": "0.5.13",
+  "version": "0.6.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",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./dist/webpack-workspace-resolve-plugin.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/webpack-workspace-resolve-plugin.d.ts",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -18,14 +39,14 @@
     "@types/node": "*"
   },
   "dependencies": {
-    "@rushstack/lookup-by-path": "0.8.15"
+    "@rushstack/lookup-by-path": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "20.17.19",
     "eslint": "~9.37.0",
     "memfs": "4.12.0",
-    "webpack": "~5.103.0",
-    "@rushstack/heft": "1.1.13",
+    "webpack": "~5.105.2",
+    "@rushstack/heft": "1.2.0",
     "local-node-rig": "1.0.0"
   },
   "sideEffects": false,