unplugin-oxlint

🌋 A universal bundler plugin for integrating the Oxlint linter into your project.

Features

🚀 A quick and simple way to use oxlint in your project.

🛠️ Support linting with both bundler plugin and Node.js API.

⚙️ Support common bundlers like Vite, Rollup, esbuild, and Webpack by unplugin.

🔍 Support mixed use in eslint projects by eslint-plugin-oxlint.

😊 Friendly output in terminal grouped by filepath.

⚡ Only lint the files that have changed for better performance by chokidar.

Installation

1# npm
2npm i -D oxlint unplugin-oxlint
3
4# pnpm
5pnpm add -D oxlint unplugin-oxlint
6
7# yar
8yarn add -D oxlint unplugin-oxlint

Usage

Bundler Plugin

Recommended the bundler plugin way to use the full options of unplugin-oxlint.

1// vite.config.ts
2import Oxlint from 'unplugin-oxlint/vite'
3
4export default defineConfig({
5  plugins: [Oxlint()],
6})

1// rollup.config.js
2import Oxlint from 'unplugin-oxlint/rollup'
3
4export default {
5  plugins: [Oxlint()],
6}

1// esbuild.config.js
2import { build } from 'esbuild'
3
4build({
5  plugins: [require('unplugin-oxlint/esbuild')()],
6})

1// webpack.config.js
2module.exports = {
3  /* ... */
4  plugins: [require('unplugin-oxlint/webpack')()],
5}

Node.js API

For cases that require execution in a Node.js environment, an API method is also provided to perform linting actions.

Tips: The Node.js API supports most options except for watch.

1// scripts/lint.js
2import { lint } from 'unplugin-oxlint'
3
4lint({ includes: 'src/**/*.ts', glob: true })

If you're looking for a way to use lint in scripts.

1{
2  "scripts": {
3    "lint": "node scripts/lint.js"
4  }
5}

And the lint function can alse be used for creating integrations with other projects.

1type Lint = (options: Omit<Options, 'watch'>) => Promise<LintResult[]>
2
3interface LintResult {
4  filename: string
5  severity: 'off' | 'warning' | 'error'
6  message: string
7  linter: 'oxlint' | 'eslint'
8  ruleId: string
9}

Playground

See playground.

ESLint

If you are looking for a way to use oxlint in projects that still need ESLint, You can use eslint-plugin-oxlint to turn off ESLint rules that are already supported by oxlint.

The rules are extracted from here

unplugin-oxlint will automatically run the eslint script after oxlint when build start and file change.

1# npm
2npm i -D eslint eslint-plugin-oxlint
3
4# pnpm
5pnpm add -D eslint eslint-plugin-oxlint
6
7# yarn
8yarn add -D eslint eslint-plugin-oxlint

Example

Use eslint-plugin-oxlint with @antfu/eslint-config

1// eslint.config.js
2import antfu from '@antfu/eslint-config'
3import oxlint from 'eslint-plugin-oxlint'
4
5export default [
6  ...await antfu(),
7  oxlint.configs['flat/all'],
8]

Options

For all options please refer to docs.

This plugin accepts most options of vite-plugin-oxlint, and some extra options that are specific to this plugin.

options.path

• Type: string | string[]
• Default: '.'

options.includes

• Type: string | string[]
• Default: '.'

Paths to files or dirs to be watched, for more details see: chokidar v4

And for those who wants to use glob pattern, unplugin-oxlint also provide glob options.

options.glob

• Type: boolean
• Default: false

Watched by glob patterns

Example:

1Oxlint({
2  includes: ['src/**/*.ts'],
3  glob: true,
4}),

options.excludes

• Type: RegExp[]
• Default: [/[\\/]node_modules[\\/]/, /[\\/]\.git[\\/]/]

options.rootDir

• Type: string
• Default: '.'

options.fix

• Type: boolean
• Default: false

Fix as many issues as possible. Only unfixed issues are reported in the output

options.watch

• Type: boolean
• Default: false

Continue to watch for changes in any of the resolved path

options.config

• Type: string
• Default: ''

ESLint configuration file

options.noIgnore

• Type: boolean
• Default: false

Disables excluding of files from .eslintignore files, --ignore-path flags and --ignore-pattern flags

options.quiet

• Type: boolean
• Default: false

Disable reporting on warnings, only errors are reported

options.denyWarnings

• Type: boolean
• Default: false

Ensure warnings produce a non-zero exit code

options.packageManager

• Type: 'npm' | 'pnpm' | 'yarn' | 'bun'

Declare the package manager which you want to use

Normally you don't need to modify this option. unplugin-oxlint will automatically detect package.json and lock file by nypm

License

MIT License © 2024-PRESENT Tamago