oxlint-plugin-deslop

Opinionated Oxlint rules that reject low-evidence, low-signal, AI-slop code patterns.

Rules are vendored from dmmulroy/anti-slop (generic rules) alongside additional deslop rules, all renamed under the deslop/* namespace. The vendored source is MIT licensed; see Credits below.

Install

npm install --save-dev oxlint-plugin-deslop
# @oxlint/plugins comes along as a runtime dependency — keep it in sync with your oxlint version

Requires a runtime with native TypeScript plugin support: Bun, Deno, or Node.js >= 22.18 / 20.19.

Usage

Register the plugin in oxlint.config.ts and enable every rule as an error via the exported recommended config:

import { defineConfig } from "oxlint";
import deslopPlugin, { configs as deslopConfigs } from "oxlint-plugin-deslop";

export default defineConfig({
  jsPlugins: [deslopPlugin],
  options: {
    ...deslopConfigs.recommended.options,
  },
  rules: {
    ...deslopConfigs.recommended.rules,
  },
});

The recommended config also enables standard type-aware rules (typescript/no-deprecated, typescript/no-floating-promises), so it sets options.typeAware. Type-aware linting requires the oxlint-tsgolint package to be installed.

Or with .oxlintrc.json (list the rules explicitly):

{
  "jsPlugins": ["oxlint-plugin-deslop"],
  "options": {
    "typeAware": true
  },
  "rules": {
    "deslop/no-array-filter-map": "error",
    "deslop/no-reduce-accumulator-copy": "error",
    "deslop/no-chained-type-assertions": "error",
    "deslop/no-conditional-empty-object-spread": "error",
    "deslop/no-known-value-widening": "error",
    "deslop/no-module-mocking": "error",
    "deslop/no-object-parameters": "error",
    "deslop/no-reflect-apply": "error",
    "deslop/no-reflect-get": "error",
    "deslop/no-runtime-typeof": "error",
    "deslop/no-shape-in-symbol-names": "error",
    "deslop/no-unknown-parameters": "error",
    "deslop/no-unknown-returns": "error",
    "deslop/no-unknown-type-aliases": "error",
    "deslop/no-unsafe-dictionary-type": "error",
    "deslop/no-widen-then-assert": "error",
    "deslop/require-safety-comment-for-type-assertion": "error",
    "deslop/no-call-only-assertions": "error",
    "deslop/no-pass-through-type-alias": "error",
    "typescript/no-deprecated": "error",
    "typescript/no-floating-promises": "error"
  }
}

Rules

Generic (deslop/*)

The rules use Oxlint's ESTree and lexical-scope APIs rather than a TypeScript type checker. They resolve same-file aliases but do not infer imported type definitions or cross-file call signatures.

Standard (typescript/*, in recommended)

Opt-in (deslop/canonical-class-names, default off)

Enforces canonical Tailwind CSS class spellings with --fix support (mt-[16px] → mt-4). Same source of truth as the Tailwind language server. Excluded from recommended because it requires a cssPath option — add it manually:

export default defineConfig({
  jsPlugins: [deslopPlugin],
  options: {
    ...deslopConfigs.recommended.options,
  },
  rules: {
    ...deslopConfigs.recommended.rules,
    "deslop/canonical-class-names": ["warn", { cssPath: "./src/styles.css" }],
  },
});

Requires Tailwind CSS v4 (tailwindcss is an optional peer). Options: cssPath (required, absolute or relative to cwd), rootFontSize (default 16), attributes (default ["class", "className"]), calleeFunctions (default ["cn", "clsx", "cva", "twMerge", "tw", "classNames", "cx"]). Only rewrites individual spellings — ordering/dedup belongs to the formatter. Strings with ${} interpolations are skipped.

Credits

• Generic rules vendored verbatim from dmmulroy/anti-slop (MIT, © Dillon Mulroy), including src/shared/*.

License

MIT