feat: add fallback version support for share filtering

INCREMENTAL_PR_PLAN_REVISED.md

@@ -3,6 +3,8 @@
 ## Overview
 Based on a detailed diff analysis, this document provides a more accurate breakdown of changes into focused, incremental PRs. Each PR represents a distinct feature, fix, or refactor that can be merged independently.
 
+**IMPORTANT**: All PRs should be compared against the `share-filter` branch as the base branch for measuring changes and creating pull requests.
+
 ## Updated PR Sequence
 
 ### PR 1: Runtime Safety Fixes
@@ -128,6 +130,8 @@ shared: {
 ---
 
 ### PR 6: Fallback Version Support
+**Branch from**: `pr5-request-pattern-filtering`
+**Compare against**: `share-filter` branch
 **Size**: Small (~6 files)
 **Risk**: Low
 **Type**: Feature
@@ -140,7 +144,7 @@ shared: {
 - Unit tests for fallback version
 - Integration tests
 
-**Depends on**: PR 4
+**Depends on**: PR 4 and PR 5
 
 **API**:
 ```javascript

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

@@ -1,3 +1,17 @@
+import type { SemVerRange } from 'webpack/lib/util/semver';
+
+export interface ConsumeSharedModuleExcludeOptions {
+  request?: string | RegExp;
+  version?: string;
+  fallbackVersion?: string;
+}
+
+export interface ConsumeSharedModuleIncludeOptions {
+  request?: string | RegExp;
+  version?: string;
+  fallbackVersion?: string;
+}
+
 export type ConsumeOptions = {
   /**
    * fallback request
@@ -51,29 +65,18 @@ export type ConsumeOptions = {
    */
   issuerLayer?: string | null;
   /**
-   * Include filters for consuming shared modules
+   * Filter object for consuming shared modules.
+   * Modules matching the criteria in this object will be excluded.
    */
-  include?: {
-    /**
-     * Version requirement that must be satisfied for the shared module to be included
-     */
-    version?: string;
-    /**
-     * Request pattern that must match for the shared module to be included
-     */
-    request?: string | RegExp;
-  };
+  exclude?: ConsumeSharedModuleExcludeOptions;
   /**
-   * Exclude filters for consuming shared modules
+   * Filter object for consuming shared modules.
+   * Only modules matching the criteria in this object will be included.
    */
-  exclude?: {
-    /**
-     * Version requirement that if satisfied will exclude the shared module
-     */
-    version?: string;
-    /**
-     * Request pattern that if matched will exclude the shared module
-     */
-    request?: string | RegExp;
-  };
+  include?: ConsumeSharedModuleIncludeOptions;
+  /**
+   * Enable reconstructed lookup for node_modules paths for this share item
+   */
+  nodeModulesReconstructedLookup?: boolean;
 };
+const TYPES = new Set(['consume-shared']);

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

@@ -41,6 +41,7 @@ export interface IncludeExcludeOptions {
   version?: string;
   fallbackVersion?: string;
 }
+
 /**
  * Advanced configuration for modules that should be consumed from share scope.
  */

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

@@ -32,6 +32,13 @@ export interface ProvidesObject {
    */
   [k: string]: ProvidesConfig | ProvidesItem;
 }
+
+export interface IncludeExcludeOptions {
+  request?: string | RegExp;
+  version?: string;
+  fallbackVersion?: string;
+}
+
 /**
  * Advanced configuration for modules that should be provided as shared modules to the share scope.
  */
@@ -73,29 +80,15 @@ export interface ProvidesConfig {
    */
   request?: string;
   /**
-   * Include filters for providing shared modules.
+   * Filter for the shared module.
+   */
+  exclude?: IncludeExcludeOptions;
+  /**
+   * Filter for the shared module.
    */
-  include?: {
-    /**
-     * Version requirement that must be satisfied for the module to be provided.
-     */
-    version?: string;
-    /**
-     * Request pattern that must match for the module to be provided.
-     */
-    request?: string | RegExp;
-  };
+  include?: IncludeExcludeOptions;
   /**
-   * Exclude filters for providing shared modules.
+   * Node modules reconstructed lookup.
    */
-  exclude?: {
-    /**
-     * Version requirement that if satisfied will exclude the module from being provided.
-     */
-    version?: string;
-    /**
-     * Request pattern that if matched will exclude the module from being provided.
-     */
-    request?: string | RegExp;
-  };
+  nodeModulesReconstructedLookup?: any;
 }

packages/enhanced/src/lib/sharing/ConsumeSharedFallbackDependency.ts

@@ -13,11 +13,15 @@ const { dependencies } = require(
 ) as typeof import('webpack');
 
 class ConsumeSharedFallbackDependency extends dependencies.ModuleDependency {
+  layer?: string | null;
+
   /**
    * @param {string} request the request
+   * @param {string | null} layer the layer for the fallback module
    */
-  constructor(request: string) {
+  constructor(request: string, layer?: string | null) {
     super(request);
+    this.layer = layer;
   }
 
   override get type(): string {

packages/enhanced/src/lib/sharing/ConsumeSharedModule.ts

@@ -52,6 +52,8 @@ const makeSerializable = require(
  * @property {boolean} eager include the fallback module in a sync way
  * @property {string | null=} layer Share a specific layer of the module, if the module supports layers
  * @property {string | null=} issuerLayer Issuer layer in which the module should be resolved
+ * @property {{ version?: string; fallbackVersion?: string }} exclude Options for excluding certain versions
+ * @property {{ version?: string; fallbackVersion?: string }} include Options for including only certain versions
  */
 
 const TYPES = new Set(['consume-shared']);
@@ -173,7 +175,10 @@ class ConsumeSharedModule extends Module {
     this.buildMeta = {};
     this.buildInfo = {};
     if (this.options.import) {
-      const dep = new ConsumeSharedFallbackDependency(this.options.import);
+      const dep = new ConsumeSharedFallbackDependency(
+        this.options.import,
+        this.options.layer,
+      );
       if (this.options.eager) {
         this.addDependency(dep);
       } else {