GeezerVison

v2.3.2

Compare Source

Highlights 💡

More reliable HMR, fewer full-page reloads

HMR now handles code-splitting changes more reliably, reducing unnecessary full-page reloads when chunks are added or rearranged. Newly required chunks are loaded before HMR accept callbacks run, and changes to async chunk dependencies no longer cause unnecessary update propagation.

Experimental rule.as

The experimental rule.as option lets a matched resource use a different path for subsequent rule matching while preserving the original resource for file reading and loaders. For example, as: '[resource-path].txt' lets later .txt rules also process example.source.js. (#​15917)

// rspack.config.mjs
export default {
  module: {
    rules: [
      {
        test: /\.source\.js$/,
        type: 'asset/source',
        as: '[resource-path].txt',
      },
      { test: /\.txt$/, use: './text-loader.js' },
    ],
  },
};

Here, example.source.js matches the later .txt rule as example.source.js.txt; text-loader.js still receives the contents of the original file.

Skip side-effect-free export * passthrough modules

Rspack can now bypass side-effect-free modules that only forward exports with export *, connecting directly to the underlying module. #​16472

Mark the package as side-effect-free in package.json:

{
  "sideEffects": false
}

// src/value.js
export const value = 42;

// src/passthrough.js
export * from './value.js';

// src/index.js
export * from './passthrough.js';

With optimization.sideEffects enabled (the default in production), the export * connection from index.js can now go directly to value.js, skipping passthrough.js.

What's Changed

New Features 🎉

• feat(sri): support hashLoading: "lazy" in SubresourceIntegrityPlugin by @​sd2k in #​16374
• feat: add output.environment.topLevelAwait and await async ESM entries by @​hai-x in #​16386
• feat: support externals.byLayer by @​stormslowly in #​16307
• feat(css): Add opt-in runtime public paths for injected styles by @​scttcper in #​15705
• feat: add experimental rule.as by @​intellild in #​15917
• feat(tree-shaking): prune dynamic imports from unused exports by @​LingyuCoder in #​15449
• feat: skip side-effect-free export * passthrough modules by @​hai-x in #​16472

Performance 🚀

• perf: use memchr SIMD scans and drop winnow by @​intellild in #​16424
• perf(sources): box the replacement name by @​LingyuCoder in #​15878
• perf: lazily create existing loader dependency sets by @​chenjiahan in #​16449
• perf: lazily materialize package.json metadata by @​LingyuCoder in #​16469
• perf(core): trim runtime spec sets on creation by @​guru-irl in #​16478
• perf(sources): share source map text with BytesStr by @​SyMind in #​16468
• perf(core): free the previous compilation's assets during a rebuild by @​guru-irl in #​16479
• perf(sources): compact noSources maps only when retained by @​SyMind in #​16536
• perf: reduce source map memory during asset generation and content hashing by @​LingyuCoder in #​16470

Bug Fixes 🐞

• fix(core): keep property access when inlining an export reached through a re-export by @​flex-mookeun in #​16310
• fix(core): keep the full hash stable across rebuilds without HMR by @​guru-irl in #​16280
• fix(runtime): avoid coercion collisions in chunk ID matchers by @​intellild in #​16423
• fix(devtool): map bootstrap and startup sources by @​LingyuCoder in #​16426
• fix: keep receiver exports for calls on unprovided members by @​hai-x in #​16418
• fix: restore side-effect imports after package metadata changes by @​ahabhgk in #​16435
• fix(cache): reuse completed builds for external and generated modules by @​ahabhgk in #​16429
• fix(core): fold chunk hashes into the full hash in chunk id order by @​guru-irl in #​16293
• fix: keep initializers of unused top-level using declarations by @​hai-x in #​16437
• fix(watcher): preserve concrete paths in native watcher events by @​stormslowly in #​16411
• fix(stats): report each runtime module's own size and chunks by @​guru-irl in #​16076
• fix(hmr): complete new entry chunk dependencies by @​JSerFeng in #​15955
• fix: isolate entry declarations from runtime tables by @​ahabhgk in #​16497
• fix: preserve module namespace key order for mixed exports by @​LingyuCoder in #​16491
• fix(watcher): separate filesystem accuracy from cache by @​stormslowly in #​16512
• fix(watcher): align rename events with watchpack by @​stormslowly in #​16460
• fix: skip cyclic star re-exports when resolving a binding by @​LingyuCoder in #​16496
• fix: preserve lone surrogates during constant evaluation by @​LingyuCoder in #​16494
• fix(watcher): pass SystemTime to mtime_accuracy by @​hai-x in #​16526
• fix(resolver): support UTF-8 BOM in tsconfig files by @​stormslowly in #​16518
• fix: evaluate x in ns to true when x is a re-exported namespace by @​hai-x in #​16509
• fix: preserve negative zero in exports and use JavaScript number strings in constant evaluation by @​LingyuCoder in #​16527
• fix(mf): keep the whole requiredVersion range in mf-manifest.json by @​arnaud-zg in #​16402
• fix(core): distinguish fatal module errors from loader diagnostics by @​ahabhgk in #​16538
• fix(css): scope counter styles and implicit grid lines by @​intellild in #​16520
• fix(hmr): invalidate cached chunks when version tags change by @​JSerFeng in #​16548
• fix(watcher): account for directory mtime accuracy by @​stormslowly in #​16531
• fix(mf): read provided shared fields directly in manifests by @​ahabhgk in #​16533
• fix(resolver): report circular tsconfig extends instead of crashing by @​stormslowly in #​16513
• fix(hmr): load async groups through their last chunk by @​JSerFeng in #​16328
• fix(resolver): reload PnP manifest from cached path by @​stormslowly in #​16543

Refactor 🔨

• refactor(binding): rely on napi-rs for module retention by @​SyMind in #​16431
• refactor: remove unused exports_definitions hook from ConcatenatedModule by @​hai-x in #​16434
• refactor(binding): implement module classes in JavaScript by @​SyMind in #​16436

Document 📖

• docs: clarify split chunks sizing and cache group examples by @​chenjiahan in #​16409
• docs: clarify split chunks counting and troubleshooting by @​chenjiahan in #​16412
• docs: explain entry dependencies and shared runtime by @​chenjiahan in #​16413
• docs: standardize Rspack runtime terminology by @​chenjiahan in #​16427
• docs: clarify Lightning CSS minimizer options and examples by @​chenjiahan in #​16417
• docs: add Nitro to community integrations by @​chenjiahan in #​16428
• docs: introduce rspack-chain for configuration customization by @​chenjiahan in #​16430
• docs: illustrate runtime chunk initialization by @​chenjiahan in #​16414
• docs: add compilation dependency tracking examples by @​chenjiahan in #​16415
• docs: add entrypoints manifest example by @​chenjiahan in #​16416
• docs: refresh Rspack and Rstack introduction by @​chenjiahan in #​16455
• docs: clarify stats asset metadata by @​chenjiahan in #​16461
• docs: redirect moved pages on Cloudflare Pages by @​chenjiahan in #​16465
• docs(website): simplify Rspress configuration by @​SoonIter in #​16522
• docs: expand community plugin list by @​chenjiahan in #​16524
• docs: expand community loader list by @​chenjiahan in #​16528
• docs: clarify chunk ID assignment when chunkIds is false by @​LingyuCoder in #​16523
• docs: use a WebMCP prompt in the Rspack 2.3 announcement by @​SoonIter in #​16553

Other Changes

• test(cache): validate persistent cache hits in config and normal cases by @​ahabhgk in #​16397
• test: exclude external re-export case from cache reuse checks by @​SyMind in #​16425
• ci: use trunk baseline for branch-based PR stacks by @​ScriptedAlchemy in #​16201
• chore(deps): update napi by @​renovate[bot] in #​16230
• chore(deps): update dependency tiny-emitter to v2.1.0 by @​renovate[bot] in #​16440
• test: exclude container tree shaking for configCases cache test by @​ahabhgk in #​16450
• chore(deps): upgrade SWC crates and browserslist-rs by @​chenjiahan in #​16458
• chore(deps): update dependency rsbuild-plugin-google-analytics to v1.1.0 by @​renovate[bot] in #​16438
• chore(deps): update dependency coffee-loader to v5 by @​renovate[bot] in #​16441
• chore(deps): update patch npm dependencies by @​renovate[bot] in #​16476
• chore(deps): update dependency mermaid to ^12.3.0 by @​renovate[bot] in #​16480
• chore: use Rspress built-in Shiki transformers by @​chenjiahan in #​16489
• chore(deps): update dependency playwright to v1.65.0 by @​renovate[bot] in #​16481
• chore(ci): use mini runner for ecosystem ci dispatcher by @​stormslowly in #​14471
• test(watcher): stabilize nested context removal case by @​stormslowly in #​16519
• chore(deps): update Rslib to 1.0.6 by @​SoonIter in #​16471
• chore(deps): update dependency sass-loader to ^17.1.0 by @​renovate[bot] in #​16498
• chore(deps): update rust crate tokio to 1.54.1 by @​renovate[bot] in #​16502
• chore(deps): update dependency jsdom to v31 by @​renovate[bot] in #​16504
• chore(deps): bump swc-next to 0.6.1 by @​CPunisher in #​16525
• chore: bump swc_core from 84.0.1 to 84.0.2 by @​CPunisher in #​16547
• test(stats): cover shared issuers in child compilations by @​stormslowly in #​16456
• chore(deps): update dependency execa to v10 by @​renovate[bot] in #​16503
• test: wait for both watchers to finish the initial batch in rename cases by @​LingyuCoder in #​16530
• test(watcher): validate burst aggregation against event timing by @​stormslowly in #​16544
• test: stabilize cache restoration watch test by @​ahabhgk in #​16555

New Contributors

• @​sd2k made their first contribution in #​16374
• @​scttcper made their first contribution in #​15705
• @​arnaud-zg made their first contribution in #​16402

Full Changelog: web-infra-dev/rspack@v2.3.1...v2.3.2

v2.3.1

Compare Source

What's Changed

New Features 🎉

• feat(runtime): support incremental runtime module updates by @​JSerFeng in #​16326

Performance 🚀

• perf(stats): disable cacheInfo by default by @​chenjiahan in #​16356
• perf(watcher): coalesce queued native watcher batches by @​guru-irl in #​16344
• perf(split-chunks): keep type and layer filters on the native path by @​guru-irl in #​16279
• perf(stats): cache issuer paths during stats generation by @​stormslowly in #​16351

Bug Fixes 🐞

• fix: compare named cache groups by the size they actually save by @​hai-x in #​16291
• fix: don't use the line number as the column of a JS error loc by @​hai-x in #​16324
• fix(css): skip stylesheets of entries not on the page on hot update by @​CyberAP in #​16215
• fix(watcher): wait for aggregateTimeout after the last change by @​guru-irl in #​16304
• fix: avoid using absolute paths in sourcemap hashes by @​cellison-figma in #​16313
• fix(binding): preserve worker callback ownership and native module lifetime by @​SyMind in #​16318
• fix: cache rendered diagnostics across rebuilds by @​JSerFeng in #​16358
• fix(javascript): keep exports referenced through arguments in import().then callback by @​ump45nose in #​16392
• fix(css): include shared initial chunks in filename runtime by @​intellild in #​16355
• fix(css): gate the stylesheet link runtime by chunk loading by @​intellild in #​16340
• fix(sources): preserve missing source contents as null by @​SyMind in #​16366
• fix(lightningcss-loader): preserve parser flags during stylesheet conversion by @​mattcosta7 in #​16378
• fix(sources): don't let a generated-only mapping shadow a mapped one at the same column by @​flex-mookeun in #​16363
• fix(allocative): update root macro for ctor 0.13 by @​hai-x in #​16385
• fix(hmr): validate chunk versions before installation by @​JSerFeng in #​16360
• fix(mf): use correct async startup handlers in rspack runtime by @​hai-x in #​16399

Refactor 🔨

• refactor(javascript): migrate to semantic symbol links by @​CPunisher in #​16335
• refactor(concatenate): drop repeated lookups and dead binding fields by @​hai-x in #​16219

Document 📖

• docs: Rspack 2.3 release blog by @​intellild in #​16179
• docs: refine Rspack 2.3 announcement wording by @​chenjiahan in #​16337
• docs: improve Rspack 2.3 announcement readability by @​chenjiahan in #​16339
• docs: document cache statistics in Stats JSON by @​chenjiahan in #​16353
• docs: simplify split chunks option headings and examples by @​chenjiahan in #​16364
• docs: explain split chunks concepts and cache groups by @​chenjiahan in #​16365
• docs: explain base URI in the asset base path guide by @​chenjiahan in #​16367
• docs: correct split chunks option behavior and defaults by @​chenjiahan in #​16375
• docs: add split chunks option examples by @​chenjiahan in #​16388

Other Changes

• test(cli): remove redundant config extends compatibility test by @​chenjiahan in #​16334
• test: migrate remaining CommonJS configs to TypeScript by @​chenjiahan in #​16342
• test(cli): migrate functional configs to ESM TypeScript by @​chenjiahan in #​16343
• test: migrate remaining mjs configs to TypeScript by @​chenjiahan in #​16354
• chore(deps): replace direct acorn dependency with swc-next parser by @​chenjiahan in #​16352
• test(e2e): migrate configs to ESM TypeScript by @​chenjiahan in #​16357
• chore(deps): update dependency ubuntu to v26 by @​renovate[bot] in #​16381
• chore(deps): update patch npm dependencies by @​renovate[bot] in #​16370
• chore(deps): update github-actions by @​renovate[bot] in #​16380
• chore(deps): update dependency @​microsoft/api-extractor to ^7.60.1 by @​renovate[bot] in #​16372
• chore(deps): update dependency less-loader to ^13.1.0 by @​renovate[bot] in #​16373
• chore(deps): update dependency glob to v14 [security] by @​renovate[bot] in #​16384
• test: move cache related tests to newCacheCases by @​ahabhgk in #​16336
• chore(deps): upgrade Rstack CLI to v0.9.0 by @​chenjiahan in #​16396

New Contributors

• @​ump45nose made their first contribution in #​16392

Full Changelog: web-infra-dev/rspack@v2.3.0...v2.3.1

v2.3.0

Compare Source

What's Changed

🎉 See Announcing Rspack 2.3 for more details.

New Features 🎉

• feat: rename loader filter.code to codeFilter by @​SyMind in #​16184
• feat: integrate allocative snapshots and profiling skill into Rspack by @​intellild in #​16046
• feat: support module.parser.javascript.dynamicUrl by @​HashemKhalifa in #​15933
• feat(watcher): expose watchpack times API on native and node watch file systems by @​stormslowly in #​15754
• feat(javascript): migrate parser to SWC Next by @​LingyuCoder in #​16089
• feat: add loader codeFilter prefilter by @​SyMind in #​16073
• feat(create-rspack): display version in startup banner by @​chenjiahan in #​16167
• feat(rstest): add origin-aware import.meta.resolve hook by @​9aoy in #​16275
• feat(watch): support mixed ignored patterns by @​Perfecto23 in #​13795
• feat: support es2026 target by @​chenjiahan in #​16311
• feat(cache): expose newCache statistics in Stats JSON by @​ahabhgk in #​16282

Performance 🚀

• perf(size): box hot async entry futures to shrink binding size by @​stormslowly in #​16085
• perf(sources): avoid retaining serialized source maps by @​LingyuCoder in #​16072
• perf(loader): schedule loader chains as execution units by @​intellild in #​15401
• perf(loader-runner): read process.env.WASM once by @​guru-irl in #​16127
• perf: avoid creating untouched loader buildInfo by @​guru-irl in #​16077
• perf(resolver): prefer package directories in node_modules by @​stormslowly in #​16154
• perf(watch): lazily convert native watcher time info by @​stormslowly in #​16187
• perf(watcher): reuse directory analysis for unchanged subscriptions by @​stormslowly in #​16180
• perf(core): emit ESM export value descriptors when safe by @​patrickkunka in #​15936
• perf: reuse residual SplitChunks candidates in place by @​JSerFeng in #​16081
• perf(core): scan inline named exports linearly by @​kdy1 in #​16224
• perf(core): skip substring search when path has no fragment marker by @​kdy1 in #​16223
• perf(split-chunks): match built-in cache group conditions once per compilation by @​guru-irl in #​16129
• perf(sources): use slice iteration when parsing string arrays by @​kdy1 in #​16283
• perf(sources): read source map fields from the JSON tape by @​kdy1 in #​16297
• perf: avoid VLQ accumulation for single-sextet mapping values by @​kdy1 in #​16298
• perf(binding): preserve native source graphs during asset updates by @​LingyuCoder in #​16207

Bug Fixes 🐞

• fix: skip build dependency collection after fatal compilation errors by @​ahabhgk in #​16074
• fix(resolver): resolve tsconfig extends through the real path by @​orgads in #​15718
• fix(split-chunks): deduplicate remaining copies in named groups by @​JSerFeng in #​16075
• fix(css): align CSS Modules behavior with webpack css-loader fixtures by @​intellild in #​15816
• fix(tracing): convert JavaScript trace nanoseconds to microseconds by @​LingyuCoder in #​16103
• fix: stabilize module rendering order across platforms by @​hai-x in #​16100
• fix(binding): avoid shared property leak warnings on process exit by @​SoonIter in #​16117
• fix: use the module exports argument for the AMD exports dependency by @​LingyuCoder in #​16122
• fix: respect module arguments in AMD code generation by @​hai-x in #​16148
• fix(mf): make deterministic IDs independent of project paths by @​LingyuCoder in #​16152
• fix(watch): make node watch time info entries deterministic by @​LingyuCoder in #​16126
• fix(javascript): reuse parser source type by @​CPunisher in #​16102
• fix: link import bindings inside define callbacks by @​hai-x in #​16159
• fix(javascript): respect block function scope by @​CPunisher in #​16162
• fix(css): localize type-first nested selectors by @​intellild in #​16011
• fix(javascript): preserve legacy parser behavior by @​CPunisher in #​16164
• fix(lazy-compilation): avoid barrel reloads on activation by @​JSerFeng in #​16026
• fix(split-chunks): support minRemainingSize by @​JSerFeng in #​15594
• fix: release updated allocative crates to resolve napi feature mismatch by @​intellild in #​16171
• fix(HMR): correct hot updated chunk path resolution in Node.js HMR by @​hai-x in #​16174
• fix(release): synchronize workspace versions and CLI peer dependencies by @​intellild in #​16181
• fix: inherit splitChunks request limits in cache groups by @​hai-x in #​16191
• fix(css): calculate CSS module hashes from graph dependencies by @​intellild in #​16120
• fix(core): preserve shorthand assignment keys in concatenation by @​dajiaohuang in #​16205
• fix(cache): unify snapshot path matching and package lookup by @​ahabhgk in #​16194
• fix(javascript): correct loose equality evaluation for nullish values by @​NaamuKim in #​16141
• fix(lazy-compilation): avoid reposting active ids on dispose by @​dajiaohuang in #​16200
• fix: allocative crate package names by @​intellild in #​16212
• fix(mf): support consumes runtime without chunk loading by @​LingyuCoder in #​16209
• fix(mf): normalize single-item container share scopes by @​chenjiahan in #​16251
• fix(css): localize animation names before !important by @​dajiaohuang in #​16204
• fix(watcher): keep watching when unwatching a stale path fails by @​sarankumar1325 in #​16199
• fix(sri): generate integrity hashes for chunks that only contain extracted css by @​ojj1123 in #​15711
• fix: inherit sideEffects through nested package metadata by @​JSerFeng in #​15336
• fix(types): narrow EvalSourceMapDevToolPlugin options by @​chenjiahan in #​16265
• fix(css): keep media attribute of hot replaced stylesheets by @​CyberAP in #​16214
• fix(rsc): collect client components from all entry dependencies by @​sarankumar1325 in #​16254
• fix(watcher): invalidate on native watch

[!IMPORTANT]
✂ PR body was truncated to here.