feat: add webpack unbundled type sync script

[ScriptedAlchemy]

Description

This PR introduces a new script, scripts/sync-webpack-unbundled-types.mjs, to automate the regeneration of comprehensive, unbundled TypeScript declaration files for the local webpack/ package.

The primary motivation is to address the "inaccessible types" issue where webpack's default public type output lacks full coverage for internal modules. The script achieves this by:

1. Cloning the upstream webpack repository (supporting specific versions/refs).
2. Executing webpack's native type-generation tooling.
3. Performing an additional custom JS-to-.d.ts emit pass to capture a broader set of unbundled declarations from webpack's source (lib/**, hot/**, bin/**).
4. Merging and syncing these generated types into the local webpack/ directory, while preserving package.json and excluding test-related declarations.

This ensures that the local webpack/ package provides a complete and up-to-date unbundled type definition, improving developer experience and type safety.

The script is invoked via a single pnpm command: pnpm run sync:webpack:types [--version <tag/commit>]. It has been verified to successfully regenerate 662 unique declaration paths and pass pnpm build afterward.

Related Issue

N/A

Types of changes

• Docs change / refactoring / dependency upgrade
• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)

Checklist

• I have added tests to cover my changes.
• All new and existing tests passed.
• I have updated the documentation.

---

 

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

[netlify]

✅ Deploy Preview for module-federation-docs ready!

Name	Link
🔨 Latest commit	67123d8
🔍 Latest deploy log	https://app.netlify.com/projects/module-federation-docs/deploys/69979632495b410007ce9523
😎 Deploy Preview	https://deploy-preview-4459--module-federation-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 67123d8

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[pkg-pr-new]

Open in StackBlitz

@module-federation/devtools

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/devtools@67123d8

@module-federation/cli

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/cli@67123d8

create-module-federation

pnpm add https://pkg.pr.new/module-federation/core/create-module-federation@67123d8

@module-federation/data-prefetch

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/data-prefetch@67123d8

@module-federation/dts-plugin

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/dts-plugin@67123d8

@module-federation/enhanced

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/enhanced@67123d8

@module-federation/error-codes

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/error-codes@67123d8

@module-federation/managers

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/managers@67123d8

@module-federation/manifest

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/manifest@67123d8

@module-federation/metro

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/metro@67123d8

@module-federation/metro-plugin-rnc-cli

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/metro-plugin-rnc-cli@67123d8

@module-federation/metro-plugin-rnef

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/metro-plugin-rnef@67123d8

@module-federation/modern-js-v3

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/modern-js-v3@67123d8

@module-federation/retry-plugin

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/retry-plugin@67123d8

@module-federation/rsbuild-plugin

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/rsbuild-plugin@67123d8

@module-federation/rspack

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/rspack@67123d8

@module-federation/rspress-plugin

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/rspress-plugin@67123d8

@module-federation/runtime

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/runtime@67123d8

@module-federation/runtime-core

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/runtime-core@67123d8

@module-federation/runtime-tools

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/runtime-tools@67123d8

@module-federation/sdk

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/sdk@67123d8

@module-federation/third-party-dts-extractor

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/third-party-dts-extractor@67123d8

@module-federation/treeshake-frontend

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/treeshake-frontend@67123d8

@module-federation/treeshake-server

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/treeshake-server@67123d8

@module-federation/webpack-bundler-runtime

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/webpack-bundler-runtime@67123d8

@module-federation/bridge-react

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/bridge-react@67123d8

@module-federation/bridge-react-webpack-plugin

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/bridge-react-webpack-plugin@67123d8

@module-federation/bridge-shared

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/bridge-shared@67123d8

@module-federation/bridge-vue3

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/bridge-vue3@67123d8

@module-federation/inject-external-runtime-core-plugin

pnpm add https://pkg.pr.new/module-federation/core/@module-federation/inject-external-runtime-core-plugin@67123d8

commit: 67123d8

[github-actions]

Bundle Size Report

4 package(s) changed, 37 unchanged.

Package	Total dist	Delta	ESM gzip	Delta
nextjs-mf	113.5 kB	+2.1 kB (+1.9%)	284 B	no change
enhanced	1.29 MB	+1.6 kB (+0.1%)	744 B	no change
manifest	134.8 kB	+125 B (+0.1%)	182 B	no change
node	123.2 kB	+85 B (+0.1%)	489 B	no change

Total dist: 6.89 MB (+4.0 kB (+0.1%))
Total ESM gzip: 138.6 kB (no change)

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 51e1854107

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".