feat(enhanced): implement layer-aware module sharing with comprehensive test coverage (PR9)

[ScriptedAlchemy]

Summary

This PR implements enhanced layer support for module sharing in Module Federation, enabling layer-aware module resolution with proper fallback mechanisms. It also includes comprehensive test coverage for both ConsumeSharedPlugin and ProvideSharedPlugin.

Key Features

🎯 Layer-Aware Module Sharing

• Added issuerLayer parameter support throughout ConsumeSharedPlugin and related modules
• Implemented issuerLayer fallback pattern that tries layer-specific resolution first, then falls back to non-layered resolution
• Added createLookupKeyForSharing utility to generate layer-aware lookup keys (e.g., (client)react, (server)express)
• Support for layer-specific module sharing configuration with proper precedence rules

🧪 Comprehensive Test Coverage

• ConsumeSharedPlugin: Added 70+ tests covering all critical business logic including:

  • Multi-stage module resolution with layer support
  • Import resolution logic with error handling
  • RequiredVersion resolution and package extraction
  • Include/exclude version filtering with fallback support
  • Singleton warning generation for version filters

• ProvideSharedPlugin: Added 73 tests covering:

  • shouldProvideSharedModule method with semver validation
  • provideSharedModule with version resolution and request filtering
  • Module matching and multi-stage resolution logic
  • Warning generation rules (only for version filters with singleton)

🔧 Additional Improvements

• Fixed infinite recursion in node module imports with circular dependencies
• Added request pattern filtering tests with extractPathAfterNodeModules utility
• Fixed rsbuild-plugin build dependencies configuration
• Improved test infrastructure stability and CI reliability

Implementation Details

The layer support follows a consistent fallback pattern across all resolution stages:

const match = 
  unresolvedConsumes.get(createLookupKeyForSharing(request, contextInfo.issuerLayer)) ||
  unresolvedConsumes.get(createLookupKeyForSharing(request, undefined));

This enables scenarios like:

• Client-specific React version: (client)react
• Server-specific Express version: (server)express
• Automatic fallback to shared version when no layer-specific config exists

Testing

• Unit tests validate issuerLayer fallback behavior and utility functions
• Integration tests cover layer-specific module sharing scenarios
• Performance tests ensure efficient handling of large-scale configurations
• All tests pass with improved assertions for CI stability

Breaking Changes

None - all changes are backward compatible with existing configurations.

Related Issues

Completes PR9 implementation as defined in the incremental PR plan for enhanced layer support.

[changeset-bot]

🦋 Changeset detected

Latest commit: 80a7180

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 33 packages

Name	Type
@module-federation/enhanced	Patch
@module-federation/node	Patch
@module-federation/sdk	Patch
@module-federation/modern-js	Patch
@module-federation/nextjs-mf	Patch
@module-federation/rsbuild-plugin	Patch
@module-federation/rspress-plugin	Patch
@module-federation/storybook-addon	Patch
@module-federation/modernjsapp	Patch
@module-federation/devtools	Patch
@module-federation/cli	Patch
@module-federation/data-prefetch	Patch
@module-federation/dts-plugin	Patch
@module-federation/esbuild	Patch
@module-federation/managers	Patch
@module-federation/manifest	Patch
@module-federation/retry-plugin	Patch
@module-federation/rspack	Patch
@module-federation/runtime-core	Patch
@module-federation/runtime	Patch
@module-federation/utilities	Patch
@module-federation/webpack-bundler-runtime	Patch
@module-federation/bridge-react-webpack-plugin	Patch
@module-federation/bridge-react	Patch
@module-federation/bridge-vue3	Patch
remote5	Patch
website-new	Patch
@module-federation/runtime-tools	Patch
@module-federation/inject-external-runtime-core-plugin	Patch
@module-federation/third-party-dts-extractor	Patch
@module-federation/bridge-shared	Patch
@module-federation/error-codes	Patch
create-module-federation	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[ScriptedAlchemy]

• feat(nextjs-mf): RSC Support  #3736
• feat(enhanced): implement layer-aware module sharing with comprehensive test coverage (PR9) #3915 👈 (View in Graphite)
• PR8: SharePlugin - Unified API #3914 : 1 other dependent PR (#3991 )
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[netlify]

✅ Deploy Preview for module-federation-docs ready!

Name	Link
🔨 Latest commit	80a7180
🔍 Latest deploy log	https://app.netlify.com/projects/module-federation-docs/deploys/689ad984597f410008668ecb
😎 Deploy Preview	https://deploy-preview-3915--module-federation-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[ScriptedAlchemy]

delete this

[ScriptedAlchemy]

make this a patch and update it based on the actual changes in the pr (if any) otherwise delete

[ScriptedAlchemy]

remove this line