feat: enhance SharePlugin with unified API improvements for PR8

- Added comprehensive validation for shared configuration
- Enhanced error handling in SharePlugin.apply() method
- Added helper methods for debugging and introspection
- Created comprehensive compiler-unit tests
- Updated jest configuration to include compiler-unit tests
- Fixed test issues with proper mocking of child plugins

All SharePlugin tests passing (25 tests total)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: ScriptedAlchemy

packages/enhanced/jest.config.ts

@@ -36,6 +36,7 @@ export default {
   testMatch: [
     '<rootDir>/test/*.basictest.js',
     '<rootDir>/test/unit/**/*.test.ts',
+    '<rootDir>/test/compiler-unit/**/*.test.ts',
   ],
 
   testEnvironment: path.resolve(__dirname, './test/patch-node-env.js'),

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

@@ -32,15 +32,33 @@ class SharePlugin {
   private _shareScope: string | string[];
   private _consumes: Record<string, ConsumesConfig>[];
   private _provides: Record<string, ProvidesConfig>[];
+  private _options: SharePluginOptions;
 
   constructor(options: SharePluginOptions) {
+    // Validate options first
     validate(options);
 
+    // Store options for debugging and introspection
+    this._options = options;
+
+    // Validate shared configuration
+    if (
+      !options.shared ||
+      (typeof options.shared === 'object' &&
+        Object.keys(options.shared).length === 0)
+    ) {
+      throw new Error(
+        'SharePlugin requires at least one shared module configuration',
+      );
+    }
+
     const sharedOptions: [string, SharedConfig][] = parseOptions(
       options.shared,
       (item, key) => {
         if (typeof item !== 'string')
-          throw new Error('Unexpected array in shared');
+          throw new Error(
+            `Unexpected array in shared configuration for key "${key}"`,
+          );
         const config: SharedConfig =
           item === key || !isRequiredVersion(item)
             ? {
@@ -52,7 +70,15 @@ class SharePlugin {
               };
         return config;
       },
-      (item) => item,
+      (item, key) => {
+        // Enhanced validation for shared config
+        if (item.include && item.exclude) {
+          throw new Error(
+            `Cannot specify both include and exclude filters for shared module "${key}"`,
+          );
+        }
+        return item;
+      },
     );
     const consumes: Record<string, ConsumesConfig>[] = sharedOptions.map(
       ([key, options]) => ({
@@ -100,6 +126,62 @@ class SharePlugin {
     this._provides = provides;
   }
 
+  /**
+   * Get the configuration used to initialize this plugin
+   * @returns The original SharePluginOptions
+   */
+  getOptions(): SharePluginOptions {
+    return this._options;
+  }
+
+  /**
+   * Get the share scope name(s) used by this plugin
+   * @returns The share scope name or array of names
+   */
+  getShareScope(): string | string[] {
+    return this._shareScope;
+  }
+
+  /**
+   * Get the consume configurations generated by this plugin
+   * @returns Array of consume configurations
+   */
+  getConsumes(): Record<string, ConsumesConfig>[] {
+    return this._consumes;
+  }
+
+  /**
+   * Get the provide configurations generated by this plugin
+   * @returns Array of provide configurations
+   */
+  getProvides(): Record<string, ProvidesConfig>[] {
+    return this._provides;
+  }
+
+  /**
+   * Get information about shared modules
+   * @returns Object containing shared module information
+   */
+  getSharedInfo(): {
+    totalShared: number;
+    consumeOnly: number;
+    provideAndConsume: number;
+    shareScopes: string[];
+  } {
+    const consumeOnlyCount = this._consumes.length - this._provides.length;
+    const provideAndConsumeCount = this._provides.length;
+    const shareScopes = Array.isArray(this._shareScope)
+      ? this._shareScope
+      : [this._shareScope];
+
+    return {
+      totalShared: this._consumes.length,
+      consumeOnly: consumeOnlyCount,
+      provideAndConsume: provideAndConsumeCount,
+      shareScopes: shareScopes,
+    };
+  }
+
   /**
    * Applies the plugin to the webpack compiler instance
    * @param compiler - The webpack compiler instance
@@ -108,14 +190,27 @@ class SharePlugin {
     process.env['FEDERATION_WEBPACK_PATH'] =
       process.env['FEDERATION_WEBPACK_PATH'] || getWebpackPath(compiler);
 
-    new ConsumeSharedPlugin({
-      shareScope: this._shareScope,
-      consumes: this._consumes,
-    }).apply(compiler);
-    new ProvideSharedPlugin({
-      shareScope: this._shareScope,
-      provides: this._provides,
-    }).apply(compiler);
+    // Apply ConsumeSharedPlugin with enhanced error handling
+    try {
+      new ConsumeSharedPlugin({
+        shareScope: this._shareScope,
+        consumes: this._consumes,
+      }).apply(compiler);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to apply ConsumeSharedPlugin: ${message}`);
+    }
+
+    // Apply ProvideSharedPlugin with enhanced error handling
+    try {
+      new ProvideSharedPlugin({
+        shareScope: this._shareScope,
+        provides: this._provides,
+      }).apply(compiler);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to apply ProvideSharedPlugin: ${message}`);
+    }
   }
 }