274

19

---

unplugin-swc

SWC plugin for Vite, Rollup, and Webpack.

Install

npm i unplugin-swc @swc/core -D

Usage

Vite, Rollup, or Webpack:

import swc from 'unplugin-swc'

export default {
  plugins: [
    // Vite plugin
    swc.vite(),
    // Rollup plugin
    swc.rollup(),
    // Webpack plugin
    swc.webpack(),
  ],
}

tsconfig.json

Following SWC options are inferred from tsconfig.json:

• jsc.parser.syntax: based on file extension
• jsc.parser.jsx, parser.tsx: compilerOptions.jsx
• jsc.parser.decorators: compilerOptions.experimentalDecorators
• jsc.transform.react.pragma: compilerOptions.jsxFactory
• jsc.transform.react.pragmaFrag: compilerOptions.jsxFragmentFactory
• jsc.transform.react.importSource: compilerOptions.jsxImportSource
• jsc.transform.react.runtime: automatic for compilerOptions.jsx: "react-jsx" or "react-jsxdev"; otherwise classic
• jsc.transform.react.development: enabled for compilerOptions.jsx: "react-jsxdev"
• jsc.transform.legacyDecorator: compilerOptions.experimentalDecorators
• jsc.transform.decoratorMetadata: compilerOptions.emitDecoratorMetadata
• jsc.keepClassNames: when decorator is enabled, because original class name is required by libs like type-graphql to generate correct graphql type

If you wish to disable this behavior and use .swcrc to control above jsc options, you can use tsconfigFile option:

// Or swc.rollup
swc.vite({
  tsconfigFile: false,
})

// It's also possible to use a custom tsconfig file instead of tsconfig.json
swc.vite({
  tsconfigFile: './tsconfig.build.json',
})

Minification

Use the minify: true option. It only works for Rollup. Vite uses esbuild to minify code, and Webpack minification is not supported.

To have advanced control over the minification process, use jsc.minify option in .swcrc.

Vite

esbuild will be automatically disabled if you use this plugin.

Options

This plugin accepts all @swc/core options, except for jsc which should be configured in .swcrc instead, and some extra options that are specific to this plugin:

options.tsconfigFile

• Type: boolean, string
• Default: tsconfig.json

Disable the use of tsconfig file or specify a custom one.

options.include

• Type: RegExp
• Default: /\.[jt]sx?$/

Files to include in the transpilation process.

options.exclude

• Type: RegExp
• Default: /node_modules/

Files to exclude in the transpilation process.

options.jsc

• Type: object

Custom jsc options to merge with the default one.

License

MIT © EGOIST