feat(enhanced): add alias-aware providing and consuming for shared modules

.changeset/fix-alias-aware-consume-plugin.md

@@ -0,0 +1,16 @@
+---
+'@module-federation/enhanced': patch
+---
+
+fix(enhanced): ConsumeSharedPlugin alias-aware and virtual resource handling
+
+- Skip `data:` (virtual) resources in `afterResolve` and `createModule` so webpack's scheme resolver handles them (fixes container virtual-entry compile failure)
+- Broaden alias-aware matching in `afterResolve` to include deep-path shares that start with the resolved package name (e.g. `next/dist/compiled/react`), ensuring aliased modules are consumed from federation when configured
+- Avoid converting explicit relative/absolute requests into consumes to preserve local nested resolution (fixes deep module sharing version selection)
+- Keep prefix and node_modules suffix matching intact; no behavior change there
+
+These changes restore expected behavior for:
+- Virtual entry compilation
+- Deep module sharing (distinct versions for nested paths)
+- Alias-based sharing (Next.js compiled React)
+

.github/workflows/e2e-manifest.yml

@@ -46,8 +46,8 @@ jobs:
 
       - name: E2E Test for Manifest Demo Development
         if: steps.check-ci.outcome == 'success'
-        run: pnpm run app:manifest:dev & echo "done" && npx wait-on tcp:3009 && npx wait-on tcp:3012 && npx wait-on http://127.0.0.1:4001/ && npx nx run-many --target=e2e --projects=manifest-webpack-host --parallel=2 && npx kill-port 3013 3009 3010 3011 3012 4001
+        run: node tools/scripts/run-manifest-e2e.mjs --mode=dev
 
       - name: E2E Test for Manifest Demo Production
         if: steps.check-ci.outcome == 'success'
-        run: pnpm run app:manifest:prod & echo "done" && npx wait-on tcp:3009 && npx wait-on tcp:3012 && npx wait-on http://127.0.0.1:4001/ && npx nx run-many --target=e2e --projects=manifest-webpack-host --parallel=1 && npx kill-port 3013 3009 3010 3011 3012 4001
+        run: node tools/scripts/run-manifest-e2e.mjs --mode=prod

.gitignore

@@ -55,7 +55,6 @@ apps/**/dist
 **/cypress/downloads
 
 # test cases
-!packages/enhanced/test/configCases/**/**/node_modules
 packages/enhanced/test/js
 .ignored
 **/.mf
@@ -89,3 +88,9 @@ vitest.config.*.timestamp*
 ssg
 .claude
 __mocks__/
+
+# test mock modules
+# Keep ALL test configCases node_modules (and all nested files) tracked,
+# so we don't need per-path exceptions like next/dist.
+!packages/enhanced/test/configCases/**/node_modules/
+!packages/enhanced/test/configCases/**/node_modules/**

AGENTS.md

@@ -0,0 +1,23 @@
+# AGENTS.md - Module Federation Core Repository Guidelines
+
+## Build/Test Commands
+```bash
+pnpm build              # Build all packages (tag:type:pkg)
+pnpm test               # Run all tests via nx
+pnpm lint               # Lint all packages
+pnpm lint-fix           # Fix linting issues
+pnpm nx run <pkg>:test  # Test specific package
+npx jest path/to/test.ts --no-coverage  # Run single test file
+```
+
+## Code Style
+- **Imports**: External → SDK/core → Local (grouped with blank lines)
+- **Type imports**: `import type { ... }` explicitly marked
+- **Naming**: camelCase functions, PascalCase classes, SCREAMING_SNAKE constants
+- **Files**: kebab-case or PascalCase for class files
+- **Errors**: Use `@module-federation/error-codes`, minimal try-catch
+- **Comments**: Minimal, use `//` inline, `/** */` for deprecation
+- **Async**: Named async functions for major ops, arrow functions in callbacks
+- **Exports**: Named exports preferred, barrel exports in index files
+- **Package manager**: ALWAYS use pnpm, never npm
+- **Parallelization**: Break tasks into 3-10 parallel subtasks minimum

nx.json

@@ -1,5 +1,6 @@
 {
   "$schema": "./node_modules/nx/schemas/nx-schema.json",
+  "useDaemonProcess": false,
   "targetDefaults": {
     "build": {
       "inputs": ["production", "^production"],

package.json

@@ -2,7 +2,6 @@
   "name": "module-federation",
   "version": "0.0.0",
   "engines": {
-    "node": "^18",
     "pnpm": "^8.11.0"
   },
   "packageManager": "[email protected]",
@@ -38,7 +37,7 @@
     "build:website": "nx run website-new:build",
     "extract-i18n:website": "nx run website:extract-i18n",
     "sync:pullMFTypes": "concurrently \"node ./packages/enhanced/pullts.js\"",
-    "app:next:dev": "nx run-many --target=serve --configuration=development -p 3000-home,3001-shop,3002-checkout",
+    "app:next:dev": "NX_TUI=false nx run-many --target=serve --configuration=development -p 3000-home,3001-shop,3002-checkout",
     "app:next:build": "nx run-many --target=build --parallel=2 --configuration=production -p 3000-home,3001-shop,3002-checkout",
     "app:next:prod": "nx run-many --target=serve --configuration=production -p 3000-home,3001-shop,3002-checkout",
     "app:node:dev": "nx run-many --target=serve --parallel=10 --configuration=development -p node-host,node-local-remote,node-remote,node-dynamic-remote-new-version,node-dynamic-remote",

packages/bridge/bridge-react/vite.config.ts

@@ -47,6 +47,7 @@ export default defineConfig({
       external: [
         ...perDepsKeys,
         '@remix-run/router',
+        'react-error-boundary',
         /react-dom\/.*/,
         'react-router',
         'react-router-dom/',

packages/enhanced/package.json

@@ -87,6 +87,7 @@
     "@types/btoa": "^1.2.5",
     "ajv": "^8.17.1",
     "enhanced-resolve": "^5.0.0",
+    "memfs": "^4.36.0",
     "terser": "^5.37.0"
   },
   "dependencies": {

packages/enhanced/src/declarations/plugins/sharing/ConsumeSharedModule.d.ts

@@ -75,8 +75,8 @@ export type ConsumeOptions = {
    */
   include?: ConsumeSharedModuleIncludeOptions;
   /**
-   * Enable reconstructed lookup for node_modules paths for this share item
+   * Allow matching against path suffix after node_modules for this share item
    */
-  nodeModulesReconstructedLookup?: boolean;
+  allowNodeModulesSuffixMatch?: boolean;
 };
 const TYPES = new Set(['consume-shared']);

packages/enhanced/src/declarations/plugins/sharing/ConsumeSharedPlugin.d.ts

@@ -25,6 +25,13 @@ export interface ConsumeSharedPluginOptions {
    * Share scope name used for all consumed modules (defaults to 'default').
    */
   shareScope?: string | string[];
+  /**
+   * Experimental features configuration.
+   */
+  experiments?: {
+    /** Enable alias-aware consuming via NormalModuleFactory.afterResolve (experimental). */
+    aliasConsumption?: boolean;
+  };
 }
 /**
  * Modules that should be consumed from share scope. Property names are used to match requested modules in this compilation. Relative requests are resolved, module requests are matched unresolved, absolute paths will match resolved requests. A trailing slash will match all requests with this prefix. In this case shareKey must also have a trailing slash.
@@ -92,5 +99,5 @@ export interface ConsumesConfig {
   request?: string;
   exclude?: IncludeExcludeOptions;
   include?: IncludeExcludeOptions;
-  nodeModulesReconstructedLookup?: boolean;
+  allowNodeModulesSuffixMatch?: boolean;
 }

packages/enhanced/src/declarations/plugins/sharing/ProvideSharedPlugin.d.ts

@@ -88,9 +88,9 @@ export interface ProvidesConfig {
    */
   include?: IncludeExcludeOptions;
   /**
-   * Node modules reconstructed lookup.
+   * Allow matching against path suffix after node_modules.
    */
-  nodeModulesReconstructedLookup?: any;
+  allowNodeModulesSuffixMatch?: any;
   /**
    * Original prefix for prefix matches (internal use).
    */

packages/enhanced/src/declarations/plugins/sharing/SharePlugin.d.ts

@@ -25,6 +25,13 @@ export interface SharePluginOptions {
    * Modules that should be shared in the share scope. When provided, property names are used to match requested modules in this compilation.
    */
   shared: Shared;
+  /**
+   * Experimental features configuration.
+   */
+  experiments?: {
+    /** Enable alias-aware consuming via NormalModuleFactory.afterResolve (experimental). */
+    aliasConsumption?: boolean;
+  };
 }
 /**
  * Modules that should be shared in the share scope. Property names are used to match requested modules in this compilation. Relative requests are resolved, module requests are matched unresolved, absolute paths will match resolved requests. A trailing slash will match all requests with this prefix. In this case shareKey must also have a trailing slash.
@@ -96,9 +103,9 @@ export interface SharedConfig {
    */
   include?: IncludeExcludeOptions;
   /**
-   * Node modules reconstructed lookup.
+   * Allow matching against path suffix after node_modules.
    */
-  nodeModulesReconstructedLookup?: boolean;
+  allowNodeModulesSuffixMatch?: boolean;
 }
 
 export interface IncludeExcludeOptions {

packages/enhanced/src/lib/container/ModuleFederationPlugin.ts

@@ -107,6 +107,8 @@ class ModuleFederationPlugin implements WebpackPluginInstance {
     (new RemoteEntryPlugin(options) as unknown as WebpackPluginInstance).apply(
       compiler,
     );
+
+    // Do not use process.env for alias consumption; flag is forwarded via options
     if (options.experiments?.provideExternalRuntime) {
       if (options.exposes) {
         throw new Error(
@@ -212,10 +214,15 @@ class ModuleFederationPlugin implements WebpackPluginInstance {
         }).apply(compiler);
       }
       if (options.shared) {
-        new SharePlugin({
+        // Build SharePlugin options and pass through aliasConsumption directly
+        const shareOpts = {
           shared: options.shared,
           shareScope: options.shareScope,
-        }).apply(compiler);
+          experiments: {
+            aliasConsumption: options.experiments?.aliasConsumption,
+          },
+        };
+        new SharePlugin(shareOpts).apply(compiler);
       }
     });