@rolldown/pluginutils

The README file is missing

Changelog

1.0.0-beta.9 (2025-05-19)

⚠ BREAKING CHANGES

• rolldown: update to oxc@0.70.0 to refine printing comments (#4562)
• align directive rendering with esbuild (#4557)
• don't expose And class in pluginutils (#4537)
• add OutputOptions#legalComments and remove OutputOptions#comments (#4528)
• expose withFilter function via rolldown/filter instead of rolldown (#4369)
• allows users to specify filter expressions directly using an array syntax instead of an object with a "custom" key (#4368)
• use camel cases for package.json#exports field (#4366)
• filter expr binding conversion (#4343)

Features

• add OutputOptions[#legal](https://github.com/rolldown/rolldown/issues/legal)Comments and remove OutputOptions[#comments](https://github.com/rolldown/rolldown/issues/comments) (#4528) (aa7e253)
• add watcher.off method to remove event listener (#4388) (ca23f2d), closes #4382
• allow to preserve legal comments with minify: true (#4591) (9a837fc)
• allows users to specify filter expressions directly using an array syntax instead of an object with a "custom" key (#4368) (4a50b6d)
• better error message for manualChunks (#4530) (5b8c925)
• builtin-plugin: expose webWorkerPostPlugin (#4594) (d89470c)
• cleanUrl rust interpreter (#4480) (1988c3d)
• debug: add call_id to load and transform events (#4296) (432acb3)
• debug: distinguish if resolve_id hook is called automatically or manually (#4254) (1b90f35)
• debug: emit ModuleGraphReady event (#4515) (29d88da), closes #4135
• debug: inject call_id for each pair of HookResolveIdCall events (#4255) (d93e66e)
• expose isolatedDeclaration (#4410) (92d35c5)
• expose loadConfig in api (#4428) (9a4338e), closes #4313
• expose oxc-resolver (#4485) (8aae298)
• filter expr binding conversion (#4343) (6c73e55)
• filter expression node binding types (#4340) (684e2b5)
• hmr: handle import.meta.hot.invalidate (#4339) (9725513)
• hmr: support sourcemap (#4570) (d3b21fe)
• implement filter expr filtering (#4346) (d35f587)
• introduce filter expression (#4323) (21b9e45)
• make BindingMinifyOptions fields optional (#4307) (165d0b1), closes #4306
• make RolldownBuild.watchFiles to async (#4520) (4666852)
• merge emitDecoratorMetadata from tsconfig.json (#4555) (3f14835), closes #4552
• move filter related utils to @rolldown/pluginutils (#4429) (f932e9e)
• output.virtualDirname (#4521) (2e52dbc)
• parse filter expr (#4338) (e394f40)
• partial preserveModules impl (#4456) (a3b1473)
• plugin/transform: allow readonly array for options (#4266) (86482ea)
• plugin/vite-resolve: port changes after Vite 6 (#4269) (7c1fae3), closes #4270
• plugin: support code filter for renderChunk hook (#4351) (ef1f137), closes #4231
• pluginutils: Query filter impl (#4535) (6c06a1c)
• pluginutils: add exactRegex and prefixRegex (#4458) (7c58822)
• pluginutils: add makeIdFiltersToMatchWithQuery function (#4469) (75757fa)
• preserveModules (#4457) (4b0464e)
• rolldown_error: add necessary id for some errors (#4533) (d4801c4), closes #4427
• rolldown_plugin_asset_import_meta_url: initialize assetImportMetaUrlPlugin (#4563) (84c4bac)
• rolldown_plugin_asset: align resolveId with rolldown-vite (#4545) (d6e2358)
• rolldown_plugin_asset: initialize asset plugin (#4541) (51bbd05)
• rolldown_plugin_asset: partially align load hook with rolldown-vite (#4561) (a58cdd9)
• rolldown_plugin_dynamic_import_vars: basic support for custom resolver (#4333) (ad5315f), closes #3968
• rolldown_plugin_dynamic_import_vars: complete basic alignment work (#4334) (1fd551c), closes #3968
• rolldown_plugin_dynamic_import_vars: introduce resolver option (#4309) (89aa613), closes #3968
• rolldown_plugin_dynamic_import_vars: prepare for custom resolver (#4328) (a15677b), closes #3968
• rolldown_plugin_dynamic_import_vars: support include and exclude (#4288) (c4e6cad), closes #3968
• rolldown_plugin_import_glob: support brace expansion (#4121) (54afc8f), closes #3982
• rolldown_plugin_reporter: align the logic in renderChunk hook (#4464) (db88da2), closes #3968
• rolldown_plugin_reporter: basically align behavior with rolldown-vite (#4475) (90102d7), closes #3968
• rolldown_plugin_reporter: further aligned with rolldown-vite (#4476) (3985436), closes #3968
• rolldown_plugin_reporter: prepare for chunk reporting (#4449) (e270f24), closes #3968
• rolldown_plugin_web_worker_post: align with rolldown-vite (#4576) (0d7e06c)
• rolldown: oxc_resolver v8 (#4392) (0de485b)
• rolldown: bump oxc_resolver to v7.0 (#4367) (63723d5)
• rolldown: expose experimental entry for browser (#4446) (069b04b)
• rolldown: expose ModuleTypes type (#4506) (513a17a)
• rolldown: oxc v0.66.0 (#4275) (35ee0e7)
• rolldown: oxc v0.68.1 (#4405) (4d4df59)
• rolldown: oxc v0.69.0 (#4478) (4940c31)
• rolldown: oxc v0.76.0 (#4345) (86ed7c3)
• rolldown: oxc_resolver v9.0.0 (#4462) (9ef061d)
• rolldown: update to oxc@0.70.0 to refine printing comments (#4562) (1c583fe)
• rust: execute cjs as it is (#4465) (5becdcf)
• rust: impl Query filter (#4542) (8a5f862)
• rust: initialize rolldown_plugin_vite_css (#4418) (f2531a6)
• rust: support LegalComments::Inline (#4444) (6921d6c)
• support extra IdParams and cleanUrl (#4479) (55a9209)
• support variadic args for or and and filter expr (#4371) (3fe195c)
• types: allow rollup plugin to be assigned to plugins option (#4568) (42e496f)
• types: expose more watcher related types (#4383) (21263e5)
• validate hoistTransitiveImports (#4262) (ac258d5)
• watcher: support result.close at bundle end event (#4423) (f579291)
• watch: support result.close at error event (#4424) (7bb3956)

Bug Fixes

• asset ModuleType not available in TypeScript package (#4489) (8ac92a4)
• add debug information for debug wasm binaries (#4549) (cc66f4b)
• align directive rendering with esbuild (#4557) (709eb63)
• align resolve extension order with esbuild (#4277) (6565161)
• align sanitize_filename with rollup (#4244) (d53650c)
• align validator with the actual types for output.polyfillRequire / output.minify.deadCodeElimination (#4294) (6e313e1)
• chunk level directives rendering (#4551) (a16881d), closes #4548
• chunk_exports: Prevent duplicate external module imports (#4408) (f90a05f), closes #4406
• chunk.imports should include external imports (#4315) (62dee06)
• ci: fix incorrect tag name for lychee-action (#4352) (2531185)
• cli: ROLLUP_WATCH should be set when config is loaded (#4293) (f845728), closes #3967
• cli: invalid type used with --target (#4407) (8cce9fc), closes #4387
• consolidate log related types (#4355) (0174d14), closes #4330
• debug: ensure emitting json object per line and correct types (#4295) (1d1fa3d)
• don't minify .d.ts related chunk (#4240) (d984417)
• dynamic import with backquotes are not bundled (#4435) (76c6380)
• ensure executing of plain imported cjs, fixes #4443 (#4468) (df9b4ee)
• hmr: accpet deps (#4314) (6aca0ce)
• hmr: aovid using quote_stmt, it make sourcemap panic (#4571) (7b949a0)
• hmr: enable incremental_build (#4298) (7209cf3)
• hmr: export full reload info if reach to hmr root (#4242) (9b57bd3)
• hmr: hmr chunk execute dependencies before create import.meta.hot (#4320) (2a06dfe)
• hmr: make sure runtime module imported for each chunk (#4438) (4d444b0)
• hmr: normalize hmr chunk sourcemap sources path (#4572) (6691f45)
• hmr: preserve original import.meta.hot when no HMR context exists (#4391) (bc78fa1), closes #4390 #4370
• hmr: reexport named declaration (#4319) (3858daa)
• hmr: register cjs module exports (#4511) (66f4623)
• hmr: remove duplicated import statment (#4556) (69aebee)
• hmr: rewrite import default/namespace reference (#4299) (a0733d0)
• hmr: rewrite import.meta.hot (#4370) (7b030ee)
• moduleSideEffects function should also apply to external module (#4305) (77c8935)
• node: add type property to RenderedChunk (#4553) (8ca4fde)
• node: ensure comments option got passed to rust (#4527) (35571e5), closes #4491
• plugin/vite-resolve: align default externalize logic with Vite (#4247) (a37e704)
• plugin/vite-resolve: external was serialized incorrectly (#4270) (3a98131)
• preserveModules cjs interop (#4529) (1e7b372)
• render_chunk_exports: add missing semicolon to exported value assignment (#4498) (8739f25), closes #4459
• rolldown_plugin_transform: use or instead of xor for transformOptions.lang (#4587) (ef90f2e)
• rolldown_transform_plugin: incorrect detection of file extension (#4241) (eae9262), closes #3881
• rust: ramdom segmentation fault (#4473) (42fd8e2)
• should not convert module to cjs if there exists toplevel this but no module,exports used (#4514) (f606614)
• should not throw for circular cjs imports, fixes #3529 (#4467) (3240812)
• should rewrite jsx_name when jsx: preserve (#4516) (d95f99e)
• should try to resolve .json extension by default (#4276) (e84206b), closes #4274
• transform hook code filter does not work (#4386) (a720367), closes #4379
• use correct FileTemplate when enable preserve_modules (#4517) (a779c8c)
• using original error if normalize original plugin error has error (#4263) (d378cad)
• watch-cli: call result.close at bundle end or error (#4426) (55efe08)
• watch: allow call result.close multiply times (#4425) (e19ea12)

Performance Improvements

• avoid allocating unnecessary memory in runtime for module_types map (#4301) (f675391)
• enable Wasm 128bit SIMD Extension (#4484) (9d84ea8)
• reduce wasm release binary size (#4547) (bf53a10)
• rename: reduce some string allocations (#4487) (c51bc5c)
• rolldown_plugin_alias: avoid unnecessary to_string allocations (#4268) (bf18d12), closes #3968
• rolldown_plugin_json: change register_hook_usage to return HookUsage::Transform (#4375) (baf6ca1), closes #3968
• rolldown: reduce size of ModuleLoaderMsg from 1472 to 24 bytes (#4496) (71d87e5)
• rolldown: remove ArcStr usages in finalize_chunks (#4494) (4dcaa00)
• rolldown: speedup extract_hash_placeholders with memchr (#4495) (38fd4b8)
• rust: improve PreProcessor[#visit](https://github.com/rolldown/rolldown/issues/visit)_export_named_declaration (#4419) (f7e95d8)

Miscellaneous Chores

• don't expose And class in pluginutils (#4537) (985af6d)
• expose withFilter function via rolldown/filter instead of rolldown (#4369) (ead9749)
• use camel cases for package.json[#exports](https://github.com/rolldown/rolldown/issues/exports) field (#4366) (2fa6d40)

Bug Fixes

• attach more comments related to export decl (#4219) (a684277)
• avoid empty line at the beginning of emitted chunks caused by file without imports (#4179) (a3b5f54), closes #4150
• avoid hang if load error (#4056) (f262f1f)
• avoid load again if load success at concurrent load (#4156) (821fc82)
• build: handle empty dependencies in rolldown configuration (#4108) (934d75d)
• clear js side cache at bundle fininsh (#4158) (10afd61)
• convert severity of missing_export diagnostic to warning when importee module is ts/tsx (#4147) (57ae80d)
• correct bundle size calculation (#3994) (748d395)
• correct the behavior when multiple transform filter option are specified (#4059) (92f7cc6)
• debug: prevent multiple writes on the same file (#4117) (9131bdc)
• deconfilct chunk name after name generated (#4191) (1534f4a)
• don't unwatch files when close watcher (#4105) (729b6cb), closes #4084
• filter should not stabilize args.specifier (#3972) (85c4bdd)
• filter test case (#3975) (eeb1005)
• hmr: should generate correct commonjs wrapper (#4131) (afae765), closes #4129
• hmr: should register cjs exports differing from esm (#4132) (ca47ca2)
• isolated_declaration: skip external id (#4026) (8b7c824)
• make sure flush before write into stdio (#4157) (85dcb2a)
• named_function_expression_argument (#4074) (e95a392), closes #4045 #4061
• node: ensure this.meta.watchMode is true in watch mode (#3969) (7ddcaea), closes #3960
• node: fix webcontainer fallback for cjs rolldown + silence pkg.pr.new check error (#3958) (465ee23)
• node: resolveId id filter is optional (#3991) (c7e4434)
• preserve leading comments of export default decl (#4122) (e3ab62a), closes #4006
• rolldown_plugin_transform: incorrect detection of source_type (#4214) (bfe3e9e), closes #4203
• rolldown_utils: normalize ids before filtering (#3955) (dc245f0)
• runtime module should get executed first always (#3978) (1c679ee), closes #3650
• rust: preserve-legal should correspond to Comments::PreserveLegal (#4137) (cef50bd), closes #4118
• rust: avoid panic when assetFileNames hash length exceeds 22 (#4019) (86710df), closes #4016
• rust: crashes with object containing shorthand to NaN (#4197) (7d55cda), closes #4196 #4123
• support nested plugin for withFilter (#4106) (698bd4c)
• typo in example code (#4167) (31e3f1b)
• validate hmr option (#4067) (c1d0963)

Features

• add withFilter util function (#4087) (c89829d)
• add hmr option binding (#4053) (cb9a009)
• add hmr runtime implement option (#4115) (dcaa72b)
• add hook usage meta (#4181) (95255cf)
• cli: enable using syntax sugar (#4202) (59e9a96)
• cli: support --input option (#4201) (6f18af6), closes #4175
• cli: support ROLLUP_WATCH and ROLLDOWN_WATCH environment variables (#3967) (bc1eba7), closes #3961
• debug: add DebugTracer for improved tracing management (#4182) (b8a64bb)
• debug: add plugin_index hook-related events (#4148) (6a35d00)
• debug: add events about resolve_id hook (#4180) (0735e9a)
• debug: add lifecycle-related events (#4168) (d9c5457)
• debug: clean up opened files when bundler get dropped (#4185) (baf201a)
• debug: rename buildId to SessionId (#4184) (f67f29f)
• debug: set up event-based tracking system for bundler actions (#4094) (bdc799c), closes #4049 #4049
• debug: trace load hook actions (#4103) (0e12b69)
• debug: unify naming (#4183) (211c9df)
• docs: generate llms.txt and llms-full.txt (#3979) (ef1de29)
• export ResolveIdExtraOptions (#4050) (25f3c61)
• hmr/poc: support HMR on situation that adds modules or modifies import statements (#3965) (7452fa0)
• hmr: allow to configurate connected address of dev server (#4001) (06fa09d)
• hmr: export hmr boundary info (#4116) (149a7b9)
• hmr: prepare hmr support on nodejs (#4002) (d97c9cc)
• initial implementation of @rolldown/browser (#4112) (a0a7d95), closes #4012
• node: auto fallback wasm binding on webcontainer (#3922) (c6972f4)
• node: expose RenderedModule type (#3963) (311f70c)
• optimize dep unchanged (#3974) (c586f68)
• partial builtin report plugin (#4136) (6ad31d7)
• rolldown_filter_analyzer (#4232) (d0ad1e9)
• rolldown_plugin_transform: enable env and assumptions (#4211) (73f1910), closes #3968
• rolldown_plugin_transform: support assumptions option in transform_options (#4209) (932b46f), closes #3968
• rolldown_plugin_transform: support target option in transform_options (#4210) (e00c4ca), closes #3968
• rolldown: oxc v0.65.0 (#4235) (d63b266), closes #4166 #4198
• support MinimalPluginContext for outputOptions hook (#3993) (19eaa2d)
• support RolldownBuild#watchFiles (#4057) (34efde9)

Performance Improvements

• aovid unnecessary allocate at PreliminaryFilename new (#4194) (c391b5e)
• avoid clone immutable scoping field (#3980) (d024a79)
• avoid lock contention (#3984) (86fb332)
• cache renderChunk meta (#3999) (e117288)
• code filter contains (#3973) (acbb339)
• lazy renderChunk meta#chunks (#4008) (d5262e2)
• make js plugin tracing more accurate (#4204) (76ba8e5)
• node: cache properties of OutputChunk and OutputAsset (#4063) (f32a14f)
• rolldown_plugin_json: use concat_string! instead of format! (#4030) (825c877)
• rust: use array instead of phf_set (#4079) (d30dcc5)
• rust: use into_owned instead of to_string to avoid unnecessary allocation (#4149) (5b4032a)
• rust: use phf_set for large datasets (#4216) (c2596d3), closes #4079
• skip empty hook with hook_usage meta (#4187) (37e71eb)
• skip empty js hook for js plugin (#4192) (5e53564)