refactor: restructure module federation SDK types and plugins

.eslintrc.json

@@ -1,6 +1,5 @@
 {
   "root": true,
-  "ignorePatterns": ["**/*"],
   "overrides": [
     {
       "files": ["*.ts", "*.tsx"],

.husky/pre-commit

@@ -1,6 +1,17 @@
 #!/usr/bin/env sh
 . "$(dirname -- "$0")/_/husky.sh"
 
+# Regenerate schema validation & SDK types when JSON schemas change
+if git diff --cached --name-only | grep -qE '^packages/enhanced/src/schemas/.+\.json$'; then
+  echo "[husky] Detected schema changes, running pnpm generate:schema..."
+  pnpm generate:schema || {
+    echo "[husky] pnpm generate:schema failed";
+    exit 1;
+  }
+  # Re-stage generated files if any
+  git add packages/enhanced/src/schemas/container/*.check.ts packages/enhanced/src/schemas/container/*.ts packages/enhanced/src/schemas/sharing/*.check.ts packages/enhanced/src/schemas/sharing/*.ts packages/sdk/src/types/plugins/*.ts 2>/dev/null || true
+fi
+
 pnpm run lint-fix
 
 git add .

apps/3000-home/package.json

@@ -26,7 +26,7 @@
     "serve": "npx next dev -p 3000",
     "serve:development": "npx next dev -p 3000",
     "serve:production": "npx next start -p 3000",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "e2e": "pnpm exec cypress run --project . --e2e --config baseUrl=http://localhost:3000 --key 27e40c91-5ac3-4433-8a87-651d10f51cf6",
     "test:e2e": "pnpm -w exec node tools/scripts/run-next-e2e.mjs --mode=dev",
     "test:e2e:production": "pnpm -w exec node tools/scripts/run-next-e2e.mjs --mode=prod"

apps/3001-shop/package.json

@@ -27,7 +27,7 @@
     "serve": "npx next dev -p 3001",
     "serve:development": "npx next dev -p 3001",
     "serve:production": "npx next start -p 3001",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "test:e2e": "pnpm -w exec node tools/scripts/run-next-e2e.mjs --mode=dev",
     "test:e2e:production": "pnpm -w exec node tools/scripts/run-next-e2e.mjs --mode=prod",
     "e2e": "pnpm exec cypress run --project . --e2e --config baseUrl=http://localhost:3001"

apps/3002-checkout/package.json

@@ -27,7 +27,7 @@
     "serve": "npx next dev -p 3002",
     "serve:development": "npx next dev -p 3002",
     "serve:production": "npx next start -p 3002",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "e2e": "pnpm exec cypress run --project . --e2e --config baseUrl=http://localhost:3002",
     "test:e2e": "pnpm -w exec node tools/scripts/run-next-e2e.mjs --mode=dev",
     "test:e2e:production": "pnpm -w exec node tools/scripts/run-next-e2e.mjs --mode=prod"

apps/bundle-size/package.json

@@ -26,7 +26,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3005 --no-hot",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 3005",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3005 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "serve-static": "pnpm exec serve dist -l 3005 --cors",
     "e2e": "pnpm exec cypress run --project . --e2e --config baseUrl=http://127.0.0.1:3005 --browser chrome",
     "e2e:development": "pnpm exec cypress open --project . --e2e --config baseUrl=http://127.0.0.1:3005 --browser electron",

apps/manifest-demo/3009-webpack-provider/package.json

@@ -23,6 +23,6 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3009 --no-hot",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 3009",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3009 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}"
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}"
   }
 }

apps/manifest-demo/3010-rspack-provider/package.json

@@ -24,6 +24,6 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec rspack serve --config rspack.config.js --mode production --port 3010 --no-hot",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec rspack serve --config rspack.config.js --mode development --port 3010",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec rspack serve --config rspack.config.js --mode production --port 3010 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}"
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}"
   }
 }

apps/node-dynamic-remote-new-version/package.json

@@ -14,7 +14,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode development --port 3027",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode development --port 3027",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode production --port 3027 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "test": "pnpm exec jest --config jest.config.ts --passWithNoTests",
     "test:ci": "pnpm exec jest --config jest.config.ts --passWithNoTests --ci --coverage"
   }

apps/node-dynamic-remote/package.json

@@ -14,7 +14,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode development --port 3026",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode development --port 3026",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode production --port 3026 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "test": "pnpm exec jest --config jest.config.ts --passWithNoTests",
     "test:ci": "pnpm exec jest --config jest.config.ts --passWithNoTests --ci --coverage"
   }

apps/node-local-remote/package.json

@@ -13,7 +13,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode development --port 3023",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode development --port 3023",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode production --port 3023 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "test": "pnpm exec jest --config jest.config.ts --passWithNoTests",
     "test:ci": "pnpm exec jest --config jest.config.ts --passWithNoTests --ci --coverage"
   }

apps/node-remote/package.json

@@ -17,7 +17,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode development --port 3022 --no-hot",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode development --port 3022 --no-hot",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --output-path dist --mode production --port 3022 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "test": "pnpm exec jest --config jest.config.ts --passWithNoTests",
     "test:ci": "pnpm exec jest --config jest.config.ts --passWithNoTests --ci --coverage"
   },

apps/react-ts-host/package.json

@@ -24,7 +24,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3003 --no-hot",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 3003",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3003 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "serve-static": "pnpm exec serve dist -l 3003 --cors"
   }
 }

apps/react-ts-nested-remote/package.json

@@ -21,7 +21,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 3005",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 3005",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3005 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "serve-static": "pnpm exec serve dist -l 3005 --cors"
   }
 }

apps/reactRemoteUI/package.json

@@ -20,7 +20,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 4201",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 4201",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.prod.js --mode production --port 4201 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "test": "pnpm exec jest --config jest.config.ts --passWithNoTests",
     "test:ci": "pnpm exec jest --config jest.config.ts --passWithNoTests --ci --coverage",
     "serve-static": "pnpm exec serve dist -l 4201 --cors"

apps/reactStorybook/package.json

@@ -21,7 +21,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 4200",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 4200",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.prod.js --mode production --port 4200 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "test": "pnpm exec jest --config jest.config.ts --passWithNoTests",
     "test:ci": "pnpm exec jest --config jest.config.ts --passWithNoTests --ci --coverage",
     "serve-static": "pnpm exec serve dist -l 4200 --cors",

apps/runtime-demo/3005-runtime-host/package.json

@@ -26,7 +26,7 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3005 --no-hot",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 3005",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3005 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}",
     "serve-static": "pnpm exec serve dist -l 3005 --cors",
     "e2e": "pnpm exec cypress run --project . --e2e --config baseUrl=http://127.0.0.1:3005 --browser chrome",
     "e2e:development": "pnpm exec cypress open --project . --e2e --config baseUrl=http://127.0.0.1:3005 --browser electron",

apps/runtime-demo/3006-runtime-remote/package.json

@@ -23,6 +23,6 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3006 --no-hot",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 3006",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3006 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}"
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}"
   }
 }

apps/runtime-demo/3007-runtime-remote/package.json

@@ -23,6 +23,6 @@
     "serve": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3007 --no-hot",
     "serve:development": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode development --port 3007",
     "serve:production": "NODE_OPTIONS=--max_old_space_size=4096 pnpm exec webpack-cli serve --config webpack.config.js --mode production --port 3007 --no-hot",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}"
+    "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint --no-error-on-unmatched-pattern --ignore-pattern node_modules **/*.{ts,tsx,js,jsx}"
   }
 }

apps/website-new/docs/en/configure/experiments.mdx

@@ -24,19 +24,20 @@ When using this mode, all entrypoints will initialize asynchronously. If you're
 - **Required:** No
 - **Default:** `false`
 
-After setting `true`, the external {props.name || 'Module Federation'}  runtime will be used and the runtime provided by the consumer will be used. (Please make sure your consumer has `provideExternalRuntime: true` set, otherwise it will not run properly!)
+When set to `true`, `@module-federation/runtime-core` will be treated as an external and read from the global `_FEDERATION_RUNTIME_CORE` at runtime. Ensure the consumer provides this global (typically used together with `provideExternalRuntime`), otherwise it will not work.
 
 ## provideExternalRuntime
 
 - **Type:** `boolean`
 - **Required:** No
 - **Default:** `false`
 
-::: warning note
-Make sure to only configure it on the topmost consumer! If multiple consumers inject runtime at the same time, the ones executed later will not overwrite the existing runtime.
-:::
+Only for “pure consumer” scenarios (no `exposes`). When enabled, automatically injects `@module-federation/inject-external-runtime-core-plugin` to provide the external runtime at execution time.
 
-Setting `true` will inject the {props.name || 'Module Federation'}  runtime at the consumer.
+:::warning Notes
+- Using this together with `exposes` will throw an error — only pure consumers can enable it.
+- Prefer configuring it at the topmost consumer to avoid multiple injections.
+:::
 
 ## optimization
 

apps/website-new/docs/en/configure/getpublicpath.mdx

@@ -3,18 +3,21 @@
 - Type: `string`
 - Required: No
 - Default value: `undefined`
-- Purpose: Used to set a dynamic `publicPath`. Once set, the corresponding remote module resources will also use this `publicPath`. For instance, if the deployed project dynamically serves a `cdn_prefix`, `getPublicPath` can be set to `return "https:" + window.navigator.cdn_host + "/resource/app/"`.
+- Effective condition: only effective when `exposes` is set
+- Purpose: Used to set a dynamic `publicPath`. The value must be a stringified function or a stringified return expression. When other consumers load this provider, the string in `getPublicPath` will be executed via `new Function` to obtain the return value, which will be used as the `publicPath` prefix for the module’s static assets.
+  - Function form: ``function(){ return window.cdn_prefix }``
+  - Return form: ``return "https:" + window.navigator.cdn_host + "/resource/app/"``
 
 - Example:
 
-In the example below, `getPublicPath` is set. When other consumers load this provider, the code for `getPublicPath` will be executed using `new Function` to obtain the return value. The content of the return value will be used as the `publicPath` prefix for the static resources of the module.
+In the example below, `getPublicPath` is set. When other consumers load this provider, the string in `getPublicPath` will be executed using `new Function` to obtain the value, which will be used as the `publicPath` prefix for the module’s static assets.
 
 :::tip NOTE
-```getPublicPath``` Must be a function as a string.
+`getPublicPath` must be a stringified function or a stringified return expression.
 :::
 
 :::tip NOTE
-If you're using module federation webpack plugin and want to set a dynamic publicPath, you should set `__webpack_public_path__ = window.cdn_prefix` statement in `getPublicPath` function body.
+If you're using the module federation webpack plugin and want to set a dynamic publicPath, you should set `__webpack_public_path__ = window.cdn_prefix` in the `getPublicPath` function body.
 :::
 
 ```ts title="rspack.config.ts"

apps/website-new/docs/en/configure/treeShakingSharedPlugins.mdx

@@ -1,6 +1,6 @@
 # treeShakingSharedPlugins
 
-Allows users to explicitly specify which plugins should participate in the second tree-shaking pass for shared modules.
+A list of plugin module paths used when building independent shared fallbacks. During the secondary tree-shaking build, each item will be `require(p)`-loaded and instantiated to participate in compilation.
 
 - Type: `string[]`
 - Required: No