[Tracking] Rollup Plugin Compat Status

Plugin Hooks

Fully Supported Hooks

[x] options
[x] buildStart
[x] buildEnd
[x] renderStart
[x] renderError
[x] generateBundle
[x] writeBundle
[x] closeBundle
[x] banner
[x] footer
[x] intro
[x] outro
[x] augmentChunkHash

Partually Supported Hooks

Hooks in this section can work as intended for most commonly seen plugins, but they may have some niche options / behavior that are not implemented yet.

Our priority at this stage is implement enough compatibility for most plugins to run, and determine whether to support the niche options at a later stage based on user demand. Some options are explicitly marked as "will not support" due to architectural incompatibility and limited use case.

outputOptions
- the PluginContext is not supported yet.
resolveId
- the 3rd argument options.attributes is not supported yet
- the following fileds in the return value are not supported yet:
- external
- attributes
- resolvedBy
- syntheticNamedExports
load
- the following fileds in the return value are not supported yet:
- attributes
- syntheticNamedExports
- ast ^{will not support}
transform
- the following fileds in the return value are not supported yet:
- attributes
- syntheticNamedExports
- ast ^{will not support}
renderChunk
- the meta argument is not supported yet
moduleParsed
- the argument moduleInfo is only partially compatible
resolveDynamicImport
- the 3rd argument options.attributes is not supported yet
onLog
- the meta property is not supported yet

Not Yet Supported

[ ] shouldTransformCachedModule
[ ] resolveFileUrl
[ ] resolveImportMeta
[ ] renderDynamicImport
[ ] closeWatcher
[ ] watchChange

Plugin Context

Supported Properties

[x] debug
[x] error
[x] info
[x] warn
[x] getFileName

Partially Supported Properties

resolve
- options.isEntry and options.attributes are not supported yet
emitFile
- only support emitting assets for now
getModuleIds
- only support in output generation hooks
getModuleInfo
- only support in output generation hooks

Not Yet Supported Properties

getCombinedSourcemap
load
meta
cache
addWatchFile, only support as a empty function
getWatchFiles
setAssetSource
parse ^{will not support}

Vite Internal Plugins Compatibility

[x] assetPlugin.
[x] assetImportMetaUrlPlugin
[x] clientInjectionsPlugin
[x] completeSystemWrapPlugin
[x] cssPlugin
[x] cssPostPlugin
[x] cssAnalysisPlugin
[x] dataURIPlugin
[x] definePlugin
[x] *dynamicImportVarsPlugin
[x] esbuildPlugin
[x] buildEsbuildPlugin
[x] htmlInlineProxyPlugin
[x] buildHtmlPlugin
[x] importAnalysisPlugin
[x] buildImportAnalysisPlugin
[ ] importGlobPlugin - needs resolveId#option the argument fileds attributes
[x] jsonPlugin
[x] loadFallbackPlugin
[x] manifestPlugin
[x] metadataPlugin , needs mutate( add extra fileds) renderChunkArgs#RenderedChunk and using it at augmentChunkHash/generateBundle, it rewrite to stored at js side.
[x] modulePreloadPolyfillPlugin
[x] optimizedDepsPlugin
[x] preAliasPlugin
[x] buildReporterPlugin
[x] resolvePlugin
[ ] splitVendorChunkPlugin - needs manualChunks. @deprecated
[x] terserPlugin
[x] wasmFallbackPlugin
[x] wasmHelperPlugin
[ ] webWorkerPostPlugin - needs resolveImportMeta
[x] webWorkerPlugin - needs shouldTransformCachedModule
[x] workerImportMetaUrlPlugin - needs shouldTransformCachedModule
[x] ssrManifestPlugin

Vite Public Plugins Compatibility

[x] @vitejs/plugin-vue
[x] @vitejs/plugin-vue-jsx
[x] @vitejs/plugin-react

Rollup Official Plugins Compatibility

Supported as Built-in

The following Rollup plugins are no longer needed because Rolldown offers built-in support for equivalent features:

@rollup/plugin-alias - use resolve.alias option instead.
@rollup/plugin-commonjs - Rolldown has built-in support
@rollup/plugin-inject - use inject option instead.
@rollup/plugin-node-resolve - Rolldown has built-in support
@rollup/plugin-json - Rolldown has built-in support
@rollup/plugin-replace - Rolldown provides built-in support via import { replacePlugin } from 'rolldown/experimental'
@rollup/plugin-swc, @rollup/plugin-babel, @rollup/plugin-sucrase - Rolldown has built-in TS / JSX transform support via Oxc. Target-lowering transforms are WIP.

Fully Compatible Plugins

[x] @rollup/plugin-auto-install
[x] @rollup/plugin-beep
[x] @rollup/plugin-data-uri
[x] @rollup/plugin-dsv
[x] @rollup/plugin-eslint - consider using oxlint instead
[x] @rollup/plugin-esm-shim
[x] @rollup/plugin-graphql
[x] @rollup/plugin-legacy
[x] @rollup/plugin-run
[x] @rollup/plugin-terser - Rolldown has built-in minifcation via output.minify option, but it's still WIP
[x] @rollup/plugin-virtual - we could provider a rust plugin to make it faster
[x] @rollup/plugin-yaml
[x] @rollup/plugin-multi-entry
[x] @rollup/plugin-image
[x] @rollup/plugin-url
[x] @rollup/plugin-wasm will likely have built-in support
[x] @rollup/plugin-html
[x] @rollup/plugin-buble

Not Yet Compatible

[ ] @rollup/plugin-strip - uses PluginContext#parse
[ ] @rollup/plugin-typescript - Rolldown will support emitting bundled dts with isolatedDeclarations: true in the future
[ ] @rollup/plugin-dynamic-import-vars using PluginContext#parse, will have built-in support

Vite Ecosystem

analog

[ ] jitPlugin - needs find plugin by plugin name at buildStart options, then using the plugin transform, see here

astro

[ ] astroScannerPlugin - needs using PluginContext#getModuleInfo as TransformResult#meta, see here, (todo find usage)
[ ] markdown - needs LoadResult#meta
[ ] html - needs mutate NormalizedOption#plugins at options hook, see here
[ ] astroHeadBuildPlugin - needs mutate ModuleInfo#meta using PluginContext#getModuleInfo at generateBundle hook, see here
[ ] postprocess direct using acorn#parse
[ ] vitePluginAnalyzer using ModuleInfo#meta by PluginContext#getModuleIds/getModuleInfo at generateBundle hook, see here
[ ] vitePluginContent mutate NormalizedOption#input at options hook, see here, mutate NormalizedOption#manualChunks at same file
[ ] css TODO
[ ] import.meta.ROLLUP_FILE_URL_*

histoire

mutate NormalizedOption#external(look like is not correct), see here

qwik

qwikCityPlugin used moduleSideEffect: no-treeshake, see here

rolldown / rolldown