feat(enhanced): add experiments.aliasConsumption flag; remove env toggle

- Gate alias-aware consuming behind experiments.aliasConsumption (opt-in)
- Remove FEDERATION_ALIAS_CONSUMPTION env usage
- Update schemas for MF/Share/Consume plugins
- Forward aliasConsumption only when defined
- Enhanced tests passing locally

Author: ScriptedAlchemy

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/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.

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.

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,18 @@ class ModuleFederationPlugin implements WebpackPluginInstance {
         }).apply(compiler);
       }
       if (options.shared) {
-        new SharePlugin({
+        // build SharePlugin options and forward aliasConsumption only when defined
+        const sharePluginOptions: import('../../declarations/plugins/sharing/SharePlugin').SharePluginOptions & {
+          experiments?: { aliasConsumption?: boolean };
+        } = {
           shared: options.shared,
           shareScope: options.shareScope,
-        }).apply(compiler);
+        };
+        const aliasConsumption = options.experiments?.aliasConsumption;
+        if (typeof aliasConsumption === 'boolean') {
+          sharePluginOptions.experiments = { aliasConsumption };
+        }
+        new SharePlugin(sharePluginOptions).apply(compiler);
       }
     });
 

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

@@ -82,6 +82,7 @@ const PLUGIN_NAME = 'ConsumeSharedPlugin';
 
 class ConsumeSharedPlugin {
   private _consumes: [string, ConsumeOptions][];
+  private _aliasConsumption: boolean;
 
   constructor(options: ConsumeSharedPluginOptions) {
     if (typeof options !== 'string') {
@@ -157,6 +158,13 @@ class ConsumeSharedPlugin {
         } as ConsumeOptions;
       },
     );
+
+    // read experiments flag if provided via options
+    // typings may not include experiments yet; cast to any
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    this._aliasConsumption = Boolean(
+      (options as any)?.experiments?.aliasConsumption,
+    );
   }
 
   createConsumeSharedModule(
@@ -698,7 +706,8 @@ class ConsumeSharedPlugin {
         );
 
         // AFTER RESOLVE: alias-aware equality (single-resolution per candidate via cache)
-        {
+        // Guarded by experimental flag provided via options
+        if (this._aliasConsumption) {
           const afterResolveHook = (normalModuleFactory as any)?.hooks
             ?.afterResolve;
           if (afterResolveHook?.tapPromise) {

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

@@ -28,10 +28,16 @@ const validate = createSchemaValidation(
   },
 );
 
+type ShareExperiments = {
+  allowNodeModulesSuffixMatch?: boolean;
+  aliasConsumption?: boolean;
+};
+
 class SharePlugin {
   private _shareScope: string | string[];
   private _consumes: Record<string, ConsumesConfig>[];
   private _provides: Record<string, ProvidesConfig>[];
+  private _experiments?: ShareExperiments;
 
   constructor(options: SharePluginOptions) {
     validate(options);
@@ -98,6 +104,9 @@ class SharePlugin {
     this._shareScope = options.shareScope || 'default';
     this._consumes = consumes;
     this._provides = provides;
+    // keep experiments object if present (validated by schema)
+    // includes allowNodeModulesSuffixMatch and aliasConsumption (experimental)
+    this._experiments = options.experiments as ShareExperiments | undefined;
   }
 
   /**
@@ -111,6 +120,8 @@ class SharePlugin {
     new ConsumeSharedPlugin({
       shareScope: this._shareScope,
       consumes: this._consumes,
+      // forward experiments to ConsumeSharedPlugin
+      experiments: this._experiments,
     }).apply(compiler);
 
     new ProvideSharedPlugin({