docs: add rspack 2 dual-version support design doc#1395
Open
dannyhw wants to merge 1 commit into
Open
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
dannyhw
force-pushed
the
docs/rspack-2-adoption-plan
branch
from
73bc230 to
7faf96c
Compare
Introduce agent_context/ - technical design documentation for substantial efforts, one folder per effort - with the design of dual Rspack 1.x/2.x support: version detection, Node compatibility handling, per-major config generation, persistent cache handling, React Refresh wiring, tracing, Module Federation v1, type accommodations, and the testing strategy.
dannyhw
force-pushed
the
docs/rspack-2-adoption-plan
branch
from
7faf96c to
f45ce26
Compare
dannyhw
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
First PR of the Rspack 2 support stack split out of #1393 — documentation only, no code changes.
Introduces
agent_context/— technical design documentation for substantial efforts, one folder per effort (pointer inAGENTS.md, index inagent_context/README.md) — with the design of dual Rspack 1.x/2.x support: a single release that compiles against Rspack 2 types and runs against both majors, branching at runtime on the installed major, with zero behavior change for Rspack 1 / webpack users.The design doc covers: version detection, Node compatibility handling, per-major config generation, persistent cache handling, React Refresh wiring, tracing, Module Federation v1, type accommodations, and the testing strategy (dual-major unit lane, built-dist smoke suite, per-major tester apps, CI lanes).
The implementation lands in the follow-up stack: #1394 (version detection utilities), then the Node guard, the Rspack 2 types + dual-major test infrastructure, four parallel behavior PRs (config routing, cache warning, MFv1 pre-check, React Refresh), a dual-major smoke suite closer, and per-major tester apps.
feat/rspack-2-supportremains the reference implementation until the stack lands.