eslint-config-un

eslint-config-un

Grown out of the personal collection of rules, an ESLint config aspiring to cover as many rules as possible, be reasonably strict and easily configurable. Only supports ESLint 9 and the flat config format.

Installation

npm i -D eslint-config-un
pnpm i -D eslint-config-un
yarn add -D eslint-config-un

List of configs

Includes the rules from the following configs & plugins:

• Vanilla ESLint rules
• eslint-config-prettier to disable Prettier-incompatible rules
• typescript-eslint
• vue (+ vuejs-accessibility and pinia)
• unicorn
• node (eslint-plugin-n with node prefix)
• import (eslint-plugin-import-x with import prefix)
• promise
• regexp
• security
• sonar (v3 since v0.4.0, v1 before)
• tailwind
• jsonc (since v0.1.4)
• yaml (since v0.1.0)
• toml (since v0.1.3)
• prefer-arrow-functions (since v0.1.0)
• eslint-comments (since v0.1.3)
• package-json (since v0.1.5)
• markdown (since v0.2.0)
• css (since v0.2.0)
• jest (+ jest-extended) (since v0.3.0)
• vitest (since v0.3.0)
• jsdoc (since v0.3.1)
• perfectionist (since v0.4.0)

Features

• Automatically detects the presence of typescript, vue, nuxt, pinia, jest, jest-extended and vitest packages and enables corresponding configurations (which can also be enabled or disabled explicitly).
• Every block of rules supports overrides for rules.
• Designed to be used separately from Prettier: almost all the rules potentially conflicting with Prettier are disabled by default.
• Written in TypeScript so all the options are typed.

Usage

In your eslint.config.[cm]?js:

// @ts-check
import {eslintConfig} from 'eslint-config-un';

export default eslintConfig({
  // your configuration (optional)
});

Notes

• You don't need to install any of the mentioned configs/plugins as they are all the dependencies of this package.
• This package has a peer dependency of eslint>=9. Please ensure you have installed the correct version. Some package managers are installing non-optional peer dependencies automatically.
• Packages lookup (such as typescript or vue) is performed using local-pkg.
• Type-checked, or type-aware TypeScript rules are enabled by default which are known to be performance-demanding. It's just a little heads-up and you should make your own decision whether to keep them enabled. More about type-aware linting.
• By default, TypeScript rules will be enabled in .vue files if enforceTypescriptInScriptSection is set to true in vue's config options which in turn is automatically set to true if typescript package found installed. If you have .vue files authored in both TypeScript and JavaScript, use enforceTypescriptInScriptSection.{files,ignores} to manually specify TS & JS Vue components respectively. It is not currently possible to apply different ESLint rules depending on the value of lang attribute of <script> SFC section.
• All plugins listed above are enabled by default or enabled automatically under certain conditions, but there is some that are disabled by default:
  • prefer-arrow-functions
  • security
  • json
  • yaml
  • toml
  • package-json
  • perfectionist
• Some rules are set to warn by default. You can change some or even all such rule's reporting level using errorsInsteadOfWarnings option. You can find all such rules by inspecting the source code of this package.

Certain rules are disabled for code blocks inside *.md files

If markdown config is enabled (which is the default), the same rules provided by other configs will be applied to code blocks (```lang ... ```) inside Markdown files. This works because under the hood the plugin @eslint/markdown that provides that functionality will create virtual files for each code block with the same extension as specified after ```.

But applying certain rules for code blocks might not be desirable because some of them are too strict for the code that won't be executed anyway or even unfixable (like missing imports). You can find the full list of disabled rules in src/configs/markdown.ts file.

Troubleshooting

TypeError: Key languageOptions: Key globals: Global AudioWorkletGlobalScope has leading or trailing whitespace.

Install globals package as a dev dependency.

Changelog

0.5.0

• [BREAKING] All used ESLint plugins are now loaded unconditionally, allowing the use of any of their rules without requiring that the corresponding config is enabled.
• Abandon eslint-plugin-disable-autofix in favor of manually adding the same functionality.
• [BREAKING] Disabled autofix for no-unnecessary-type-assertion due to this bug.
• New config: deMorgan via eslint-plugin-de-morgan, <u>disabled</u> by default.

Dependencies

• eslint-plugin-unicorn: 56.0.1 -> 57.0.0
  • [BREAKING] Claims to support only eslint>=9.20.0, but we haven't enforced this version range in peerDependencies in case it works fine with the older versions.
  • ESM only now.
  • ❌ (deprecated) no-instanceof-builtins
  • 🟡 (warns) consistent-assert
  • 🟢 (enabled) consistent-date-clone
  • 🟢 no-accessor-recursion
  • 🟢 no-instanceof-builtins
  • 🟢 no-named-default
• @vitest/eslint-plugin: 1.1.28 -> 1.1.31
• eslint-import-resolver-typescript: 3.7.0 -> 3.8.3
• eslint-plugin-perfectionist: 4.8.0 -> 4.9.0
• eslint-plugin-sonarjs: 3.0.1 -> 3.0.2
• eslint-plugin-yml: 1.16.0 -> 1.17.0
• @stylistic/eslint-plugin: 3.1.0 -> 4.0.1
  • ESM only now.
• typescript-eslint: 8.24.0 -> 8.24.1
• eslint-config-flat-gitignore: 2.0.0 -> 2.1.0