feat(nextjs-mf): RSC Support

.changeset/ai-eager-wolf.md

@@ -0,0 +1,11 @@
+---
+"@module-federation/nextjs-mf": patch
+---
+
+Enhanced Next.js App Router demo applications with improved Module Federation integration.
+
+- Updated Next.js App Router demo applications (4000 and 4001) with better RSC support preparation
+- Added comprehensive E2E test coverage for Next.js App Router scenarios
+- Improved demo application configuration and dependency management
+- Enhanced development workflow with better patching and build scripts
+

.changeset/fix-alias-aware-consume-plugin.md

@@ -0,0 +1,16 @@
+---
+'@module-federation/enhanced': patch
+---
+
+fix(enhanced): ConsumeSharedPlugin alias-aware and virtual resource handling
+
+- Skip `data:` (virtual) resources in `afterResolve` and `createModule` so webpack's scheme resolver handles them (fixes container virtual-entry compile failure)
+- Broaden alias-aware matching in `afterResolve` to include deep-path shares that start with the resolved package name (e.g. `next/dist/compiled/react`), ensuring aliased modules are consumed from federation when configured
+- Avoid converting explicit relative/absolute requests into consumes to preserve local nested resolution (fixes deep module sharing version selection)
+- Keep prefix and node_modules suffix matching intact; no behavior change there
+
+These changes restore expected behavior for:
+- Virtual entry compilation
+- Deep module sharing (distinct versions for nested paths)
+- Alias-based sharing (Next.js compiled React)
+

.changeset/next-app-router-improvements.md

@@ -0,0 +1,13 @@
+---
+"@module-federation/nextjs-mf": patch
+---
+
+Enhanced Next.js App Router demo applications and CI/CD infrastructure.
+
+- Updated Next.js App Router demo applications (4000 and 4001) with React 19 and Next.js 15.3.3
+- Added comprehensive E2E test coverage for Next.js App Router scenarios using Cypress
+- Improved demo application configuration with better Module Federation setup
+- Enhanced development workflow with automated Next.js patching scripts
+- Added new CI/CD workflow for Next.js App Router E2E testing
+- Updated existing Next.js demo applications (3000-home, 3001-shop, 3002-checkout) to latest versions
+- Improved build and development scripts across all Next.js applications

.cursorignore

@@ -2,7 +2,7 @@
 **/.cache/
 **/.temp/
 **/coverage/
-**/dist/
+!**/dist/
 
 # Explicitly ignore specific packages
 packages/typescript/

.github/workflows/e2e-manifest.yml

@@ -46,8 +46,8 @@ jobs:
 
       - name: E2E Test for Manifest Demo Development
         if: steps.check-ci.outcome == 'success'
-        run: pnpm run app:manifest:dev & echo "done" && npx wait-on tcp:3009 && npx wait-on tcp:3012 && npx wait-on http://127.0.0.1:4001/ && npx nx run-many --target=e2e --projects=manifest-webpack-host --parallel=2 && npx kill-port 3013 3009 3010 3011 3012 4001
+        run: node tools/scripts/run-manifest-e2e.mjs --mode=dev
 
       - name: E2E Test for Manifest Demo Production
         if: steps.check-ci.outcome == 'success'
-        run: pnpm run app:manifest:prod & echo "done" && npx wait-on tcp:3009 && npx wait-on tcp:3012 && npx wait-on http://127.0.0.1:4001/ && npx nx run-many --target=e2e --projects=manifest-webpack-host --parallel=1 && npx kill-port 3013 3009 3010 3011 3012 4001
+        run: node tools/scripts/run-manifest-e2e.mjs --mode=prod

.github/workflows/e2e-next-app-router.yml

@@ -0,0 +1,54 @@
+name: E2E Test for Next.js App Router
+
+on:
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  e2e-next-app-router:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Install Pnpm
+        run: |
+          corepack prepare [email protected] --activate
+          corepack enable
+
+      - name: Setup Node.js 18
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+          cache: 'pnpm'
+
+      - name: Set Nx SHA
+        uses: nrwl/nx-set-shas@v3
+
+      - name: Set SKIP_DEVTOOLS_POSTINSTALL environment variable
+        run: echo "SKIP_DEVTOOLS_POSTINSTALL=true" >> $GITHUB_ENV
+
+      - name: Set local webpack
+        run: echo "NEXT_PRIVATE_LOCAL_WEBPACK=true" >> $GITHUB_ENV
+
+      - name: Install Dependencies
+        run: pnpm install
+
+      - name: Install Cypress
+        run: npx cypress install
+
+      - name: Run Build for All
+        run: npx nx run-many --targets=build --projects=tag:type:pkg
+
+      - name: Run condition check script
+        id: check-ci
+        run: node tools/scripts/ci-is-affected.mjs --appName=next-app-router-4000,next-app-router-4001
+
+      - name: E2E Test for Next.js App Router
+        if: steps.check-ci.outcome == 'success'
+        run: npx kill-port --port 4000,4001 || true && pnpm run app:next-router:dev & echo "done" && sleep 25 && npx nx run-many --target=e2e --projects=next-app-router-4000,next-app-router-4001 --parallel=1 && lsof -ti tcp:4000,4001 | xargs kill || true

.github/workflows/e2e-next-prod.yml

@@ -43,20 +43,14 @@ jobs:
         id: check-ci
         run: node tools/scripts/ci-is-affected.mjs --appName=3000-home
 
-      - name: E2E Test for Next.js Prod - Home
+      - name: E2E Test for Next.js Prod
         if: steps.check-ci.outcome == 'success'
         run: |
-          killall node
-          npx nx run 3000-home:test:e2e:production
-
-      - name: E2E Test for Next.js Prod - Shop
-        if: steps.check-ci.outcome == 'success'
-        run: |
-          killall node
-          npx nx run 3001-shop:test:e2e:production
-
-      - name: E2E Test for Next.js Prod - Checkout
-        if: steps.check-ci.outcome == 'success'
-        run: |
-          killall node
-          npx nx run 3002-checkout:test:e2e:production
+          pnpm run --filter @module-federation/3002-checkout --filter @module-federation/3000-home --filter @module-federation/3001-shop build &&
+          pnpm run app:next:prod &
+          sleep 4 &&
+          npx wait-on tcp:3001 &&
+          npx wait-on tcp:3002 &&
+          npx wait-on tcp:3000 &&
+          npx nx run-many --target=test:e2e --projects=3000-home,3001-shop,3002-checkout --parallel=1 &&
+          npx kill-port 3000,3001,3002

.gitignore

@@ -55,7 +55,6 @@ apps/**/dist
 **/cypress/downloads
 
 # test cases
-!packages/enhanced/test/configCases/**/**/node_modules
 packages/enhanced/test/js
 .ignored
 **/.mf
@@ -88,4 +87,16 @@ vitest.config.*.timestamp*
 .rsbuild
 ssg
 .claude
+# Native binary files
+*.node
+
+# Ignore local worktrees
+worktrees/
+
 __mocks__/
+
+# test mock modules
+# Keep ALL test configCases node_modules (and all nested files) tracked,
+# so we don't need per-path exceptions like next/dist.
+!packages/enhanced/test/configCases/**/node_modules/
+!packages/enhanced/test/configCases/**/node_modules/**

AGENTS.md

@@ -0,0 +1,23 @@
+# AGENTS.md - Module Federation Core Repository Guidelines
+
+## Build/Test Commands
+```bash
+pnpm build              # Build all packages (tag:type:pkg)
+pnpm test               # Run all tests via nx
+pnpm lint               # Lint all packages
+pnpm lint-fix           # Fix linting issues
+pnpm nx run <pkg>:test  # Test specific package
+npx jest path/to/test.ts --no-coverage  # Run single test file
+```
+
+## Code Style
+- **Imports**: External → SDK/core → Local (grouped with blank lines)
+- **Type imports**: `import type { ... }` explicitly marked
+- **Naming**: camelCase functions, PascalCase classes, SCREAMING_SNAKE constants
+- **Files**: kebab-case or PascalCase for class files
+- **Errors**: Use `@module-federation/error-codes`, minimal try-catch
+- **Comments**: Minimal, use `//` inline, `/** */` for deprecation
+- **Async**: Named async functions for major ops, arrow functions in callbacks
+- **Exports**: Named exports preferred, barrel exports in index files
+- **Package manager**: ALWAYS use pnpm, never npm
+- **Parallelization**: Break tasks into 3-10 parallel subtasks minimum

apps/3000-home/next-env.d.ts

@@ -2,4 +2,4 @@
 /// <reference types="next/image-types/global" />
 
 // NOTE: This file should not be edited
-// see https://nextjs.org/docs/pages/building-your-application/configuring/typescript for more information.
+// see https://nextjs.org/docs/pages/api-reference/config/typescript for more information.

apps/3000-home/next.config.js

@@ -1,15 +1,9 @@
-const { withNx } = require('@nx/next/plugins/with-nx');
 const NextFederationPlugin = require('@module-federation/nextjs-mf');
 
 /**
- * @type {import('@nx/next/plugins/with-nx').WithNxOptions}
+ * @type {import('next').NextConfig}
  **/
 const nextConfig = {
-  nx: {
-    // Set this to true if you would like to to use SVGR
-    // See: https://github.com/gregberge/svgr
-    svgr: false,
-  },
   webpack(config, options) {
     const { isServer } = options;
     config.watchOptions = {
@@ -28,6 +22,22 @@ const nextConfig = {
       }/remoteEntry.js`,
     };
 
+    const resolveFromApp = (request) =>
+      require.resolve(request, { paths: [options.dir] });
+
+    config.resolve = config.resolve || {};
+    config.resolve.alias = {
+      ...(config.resolve.alias || {}),
+      'next/dist/compiled/react': resolveFromApp('react'),
+      'next/dist/compiled/react/jsx-runtime':
+        resolveFromApp('react/jsx-runtime'),
+      'next/dist/compiled/react/jsx-dev-runtime': resolveFromApp(
+        'react/jsx-dev-runtime',
+      ),
+      'next/dist/compiled/react-dom': resolveFromApp('react-dom'),
+      'next/dist/compiled/react-dom/client': resolveFromApp('react-dom/client'),
+    };
+
     config.plugins.push(
       new NextFederationPlugin({
         name: 'home_app',
@@ -58,14 +68,8 @@ const nextConfig = {
         },
       }),
     );
-    config.plugins.push({
-      name: 'xxx',
-      apply(compiler) {
-        compiler.options.devtool = false;
-      },
-    });
     return config;
   },
 };
 
-module.exports = withNx(nextConfig);
+module.exports = nextConfig;

apps/3000-home/package.json

@@ -6,15 +6,15 @@
     "@ant-design/cssinjs": "^1.21.0",
     "antd": "5.19.1",
     "lodash": "4.17.21",
-    "next": "14.2.16",
-    "react": "18.3.1",
-    "react-dom": "18.3.1"
+    "next": "15.3.3",
+    "react": "19.1.1",
+    "react-dom": "19.1.1"
   },
   "devDependencies": {
     "@module-federation/nextjs-mf": "workspace:*",
     "@module-federation/runtime": "workspace:*",
-    "@types/react": "18.3.11",
-    "@types/react-dom": "18.3.0",
+    "@types/react": "19.1.8",
+    "@types/react-dom": "19.1.3",
     "webpack": "5.98.0"
   },
   "scripts": {