Plugins embutidos

O Oxlint traz implementações nativas em Rust de vários plugins ESLint populares. Grande parte das regras dos configs recommended já existe — resultado útil sem setup extra.

Também há plugins escritos em JavaScript com API compatível com ESLint: Plugins JS.

O que é “plugin” no Oxlint

Plugin é um conjunto nomeado de regras. Habilitar o plugin disponibiliza regras; flags de categoria ligam/desligam e definem severidade.

Migrando do ESLint, os nomes são familiares: import, react, jsx-a11y, jest, unicorn etc.

Habilitar plugin

Recomendado: use arquivo de config para listar plugins e compartilhar com o time.

Na config

Campo plugins:

.oxlintrc.json

{
  "plugins": ["import"]
}

oxlint.config.ts

import { defineConfig } from "oxlint";

export default defineConfig({
  plugins: ["import"],
});

Definir plugins substitui o conjunto padrão — inclua todos os que precisa.

Na CLI

--<nome-do-plugin>-plugin, por exemplo:

oxlint --import-plugin

Flags de categoria (-D, -W, -A) controlam o que fica ligado:

oxlint --import-plugin -D correctness -W suspicious

Regras de correctness já vêm ligadas por padrão.

oxlint --help lista todos os flags de plugin.

Desativar plugins padrão

Na config

plugins: [] desliga todos os padrão — só o conjunto base de regras.

.oxlintrc.json

{
  "plugins": []
}

oxlint.config.ts

import { defineConfig } from "oxlint";

export default defineConfig({
  plugins: [],
});

Na CLI

--disable-<nome>-plugin para plugins que vêm ligados por padrão:

oxlint --disable-unicorn-plugin

Só plugins padrão têm esse “disable”; os demais basta omitir.

Plugins suportados

Nome plugin	Padrão	Origem
eslint	Sim	Regras do ESLint
typescript	Sim	typescript-eslint (@typescript-eslint/plugin); regras com tipo em modo type-aware
unicorn	Sim	eslint-plugin-unicorn
react	Não	eslint-plugin-react, eslint-plugin-react-hooks, eslint-plugin-react-refresh
react-perf	Não	eslint-plugin-react-perf
nextjs	Não	@next/eslint-plugin-next
oxc	Sim	Regras Oxc e parte portada do deepscan
import	Não	eslint-plugin-import (equivalente a eslint-plugin-import-x)
jsdoc	Não	eslint-plugin-jsdoc
jsx-a11y	Não	eslint-plugin-jsx-a11y
node	Não	eslint-plugin-n
promise	Não	eslint-plugin-promise
jest	Não	eslint-plugin-jest
vitest	Não	@vitest/eslint-plugin
vue	Não	Regras eslint-plugin-vue que funcionam com tags script

Status de cobertura: issue product plan. Frameworks/arquivos: matriz de compatibilidade.

Novos plugins

Foco em plugins nativos e plugins JS compatíveis. Contribuições que adicionam regras a plugins existentes são bem-vindas.

Novo conjunto como plugin nativo: abra uma discussion no GitHub.