feat(enhanced): add include/exclude filtering support for shared modules

[ScriptedAlchemy]

Summary

Implements basic share filtering functionality for ConsumeSharedPlugin and ProvideSharedPlugin, allowing fine-grained control over which shared modules are consumed or provided based on version requirements and request patterns.

Extracted from PR #3904 - focusing only on the enhanced package changes

Features Added

• Version Filtering: Include/exclude shared modules based on semver version requirements
• Request Filtering: Include/exclude shared modules based on request patterns (string/RegExp)
• Singleton Warnings: Automatic warnings when filtering singleton modules
• Comprehensive Testing: Unit tests and config test cases for all filtering scenarios

Technical Implementation

• Enhanced ConsumeSharedPlugin with version and request filtering logic
• Enhanced ProvideSharedPlugin with version and request filtering logic
• Added testRequestFilters utility for request pattern matching
• Added addSingletonFilterWarning utility for singleton filter warnings
• Updated JSON schemas and TypeScript declarations
• Generated new schema validation files

Test Plan

• Unit tests for filtering utilities (11 test cases)
• Config test cases for consume filtering scenarios
• Config test cases for provide filtering scenarios
• All existing sharing tests continue to pass
• Schema generation successful

Files Changed

• Enhanced package source code and tests only
• No changes to other packages or global configuration

🤖 Generated with Claude Code

[netlify]

✅ Deploy Preview for module-federation-docs ready!

Name	Link
🔨 Latest commit	387a5a5
🔍 Latest deploy log	https://app.netlify.com/projects/module-federation-docs/deploys/6882ee16b2e6760007016114
😎 Deploy Preview	https://deploy-preview-3949--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.

[changeset-bot]

🦋 Changeset detected

Latest commit: 387a5a5

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

Enhanced Share Filtering Architecture

This diagram illustrates the architectural components and relationships for the enhanced shared module filtering feature.

Architecture Graph

graph TB
    subgraph "Module Federation Enhanced Plugin"
        MFP[ModuleFederationPlugin]
        MFP --> CSP[ConsumeSharedPlugin]
        MFP --> PSP[ProvideSharedPlugin]
    end
    
    subgraph "Consume Side (ConsumeSharedPlugin)"
        CSP --> CSM[ConsumeSharedModule]
        CSP --> CSD[ConsumeSharedDependency]
        CSP --> CSRF[ConsumeSharedRuntimeModule]
        
        CSM --> VF[Version Filtering Logic]
        CSM --> RF[Request Filtering Logic]
        
        VF --> IVF[Include Version Filter]
        VF --> EVF[Exclude Version Filter]
        
        RF --> IRF[Include Request Filter]
        RF --> ERF[Exclude Request Filter]
        
        IVF --> SATISFY[satisfy function]
        EVF --> SATISFY
        
        CSM --> GDF[getDescriptionFile]
        GDF --> PKG[package.json]
    end
    
    subgraph "Provide Side (ProvideSharedPlugin)"
        PSP --> PSD[ProvideSharedDependency]
        PSP --> PSM[ProvideSharedModule]
        PSP --> PSMF[ProvideSharedModuleFactory]
        
        PSP --> PVF[Provider Version Filter]
        PSP --> PRF[Provider Request Filter]
    end
    
    subgraph "Shared Utilities"
        SATISFY --> SEMVER[Semver Comparison]
        UTILS[utils.ts] --> SATISFY
        UTILS --> WARN[addSingletonFilterWarning]
        UTILS --> MATCH[matchesFilter]
    end
    
    subgraph "Configuration"
        CONFIG[Shared Config] --> FILTER[Filter Options]
        FILTER --> INCLUDE[include - version and request]
        FILTER --> EXCLUDE[exclude - version and request]
        FILTER --> SINGLETON[singleton boolean]
    end
    
    subgraph "Runtime Behavior"
        CSM --> FALLBACK[Fallback Module]
        CSM --> SHARED[Shared Module]
        CSM --> WARNING[Webpack Warning]
        CSM --> ERROR[Module Not Found Error]
        
        FALLBACK --> MODULE[Loaded Module]
        SHARED --> MODULE
    end
    
    subgraph "Test Infrastructure"
        TEST[Config Test Cases] --> CF[consume-filters]
        TEST --> PF[provide-filters]
        
        CF --> NM1[node_modules]
        PF --> NM2[node_modules]
        
        NM1 --> MOCK1[Mock Packages with package.json]
        NM2 --> MOCK2[Mock Packages with package.json]
    end
    
    CONFIG --> CSP
    CONFIG --> PSP
    
    WARNING --> WARN
    
    PKG --> VF
    
    style MFP fill:#e3f2fd
    style CSP fill:#e8f5e9
    style PSP fill:#e8f5e9
    style SATISFY fill:#fff3e0
    style WARNING fill:#fff9c4
    style ERROR fill:#ffebee
    style MODULE fill:#e8f5e9
    style TEST fill:#f3e5f5

Loading

Component Relationships

Core Components

1. ModuleFederationPlugin

   • Entry point that orchestrates sharing functionality
   • Creates and applies ConsumeSharedPlugin and ProvideSharedPlugin

2. ConsumeSharedPlugin

   • Handles consuming shared modules from other containers
   • Implements filtering logic to determine which shared modules to use
   • Creates ConsumeSharedModule instances with filter configurations

3. ProvideSharedPlugin

   • Handles providing shared modules to other containers
   • Applies filters to determine which modules to expose
   • Creates ProvideSharedModule instances

Filtering Components

4. Filter Types

   • Include Filters: Module must match to be used
   • Exclude Filters: Module must not match to be used
   • Version Filters: Based on semver comparison
   • Request Filters: Based on string/regex matching

5. Utility Functions

   • satisfy(): Semver version comparison
   • matchesFilter(): Request pattern matching
   • getDescriptionFile(): Reads package.json for version info
   • addSingletonFilterWarning(): Warns about singleton conflicts

Data Flow

graph LR
    subgraph "Configuration Input"
        A[webpack.config.js] --> B[shared config]
        B --> C[Module with Filters]
    end
    
    subgraph "Processing"
        C --> D[Plugin Initialization]
        D --> E[Module Resolution]
        E --> F[Filter Evaluation]
        F --> G[Version Check]
        F --> H[Request Check]
    end
    
    subgraph "Output"
        G --> I{Pass}
        H --> I
        I -->|Yes| J[Use Shared Module]
        I -->|No| K[Use Fallback or Error]
        K --> L[Generate Warning]
    end
    
    style A fill:#e3f2fd
    style J fill:#c8e6c9
    style K fill:#ffcdd2
    style L fill:#fff9c4

Loading

Key Interactions

1. Version Resolution Flow

   • ConsumeSharedModule calls getDescriptionFile()
   • Reads actual version from package.json
   • Compares with filter constraints using satisfy()

2. Filter Evaluation Order

   • Include filters checked first (must pass)
   • Exclude filters checked second (must not match)
   • Singleton warnings generated if filters present

3. Fallback Mechanism

   • When filters reject a shared module
   • System attempts to load fallback module
   • Generates appropriate warnings or errors

File Structure

packages/enhanced/src/lib/sharing/
├── ConsumeSharedPlugin.ts      # Main consume-side logic
├── ProvideSharedPlugin.ts      # Main provide-side logic
├── ConsumeSharedModule.ts      # Module wrapper with filtering
├── ProvideSharedModule.ts      # Provider module wrapper
├── utils.ts                    # Shared utilities and helpers
└── ...

packages/enhanced/test/
├── configCases/sharing/
│   ├── consume-filters/        # Integration tests
│   │   ├── webpack.config.js
│   │   ├── warnings.js
│   │   ├── errors.js
│   │   └── node_modules/       # Mock packages
│   └── provide-filters/
│       └── ...
└── unit/sharing/               # Unit tests
    ├── ConsumeSharedPlugin.test.ts
    └── ProvideSharedPlugin.test.ts

[2heal1]

Perfect, i want it for a long time !

[ScriptedAlchemy]

Sorry it took so long, it was stuck in the other branch, but in fairness - i found a few bugs in the process. So probbably better i didnt split it into its own PR from the start.