Variable DEFAULT_EXCLUDE_EXTENSIONS`Const`

DEFAULT_EXCLUDE_EXTENSIONS: Set<string> = ...

Vite plugin that marks legacy libraries as external, preventing Rolldown from bundling them and causing CommonJS interop errors at runtime.

The plugin hooks into the resolveId phase with enforce: 'pre' and marks any import whose path starts with <lib>/ as external. Rolldown then skips those imports entirely, leaving them as bare import statements in the output.

Remarks

Rolldown does not recommend marking packages as external in library builds. Doing so shifts the module resolution responsibility to the consumer. Use this plugin only when the legacy library is guaranteed to be available in the target environment.

Param: options

Plugin configuration options.

Returns

A Vite Plugin instance.

Throws

If an option has an invalid runtime value.

Throws

If libs is empty or contains only empty strings.

Example

// vite.config.ts
import { defineConfig } from 'vite'
import { legacyPassThrough } from 'vite-legacy-pass-through'

export default defineConfig({
  plugins: [
    legacyPassThrough({
      libs: ['lib-legacy'],
      showLog: true,
    }),
  ],
})

Variable DEFAULT_EXCLUDE_EXTENSIONSConst

Remarks

Param: options

Returns

Throws

Throws

Example

Settings

Variable DEFAULT_EXCLUDE_EXTENSIONS`Const`