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)
• cssInJs (since v0.2.0), using eslint-plugin-css
• jest (+ jest-extended) (since v0.3.0)
• vitest (since v0.3.0)
• jsdoc (since v0.3.1)
• perfectionist (since v0.4.0)
• de-morgan (since v0.5.0)
• qwik (since v0.6.0)
• json-schema-validator (since v0.6.0)
• angular (since v0.7.0), using @angular-eslint/eslint-plugin and @angular-eslint/eslint-plugin-template
• css (since v0.7.0), using @eslint/css
• noUnusedImports (since v0.7.0), using eslint-plugin-unused-imports
• react (since v0.8.0), using @eslint-react/eslint-plugin, eslint-plugin-react, eslint-plugin-react-hooks, eslint-plugin-react-refresh and eslint-plugin-react-compiler
• jsxA11y (since v0.8.0), using eslint-plugin-jsx-a11y
• pnpm (since v0.8.0), using eslint-plugin-pnpm
• nextJs (since v0.9.0), using @next/eslint-plugin-next
• casePolice (since v0.9.0), using eslint-plugin-case-police
• astro (since v0.9.0), using eslint-plugin-astro
• svelte (since v0.10.0), using eslint-plugin-svelte
• es (since v0.10.0), using eslint-plugin-es-x
• cloudfrontFunctions (since v0.10.0) for Amazon CloudFront Functions
• solid (since v0.10.0), using eslint-plugin-solid
• nodeDependencies (since v0.10.0), using eslint-plugin-node-dependencies
• jsInline (since v0.10.0), using eslint-plugin-html
• html (since v0.10.0), using @html-eslint/eslint-plugin

Features

• Automatically detects the presence of typescript, vue, nuxt, pinia, jest, jest-extended, vitest, @builder.io/qwik, @qwik.dev/core, @angular/core, react, next, astro, svelte and solid-js 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 configs listed above are enabled by default or enabled automatically under certain conditions, but there is some that are disabled by default:
  • preferArrowFunctions
  • security
  • json
  • yaml
  • toml
  • packageJson
  • perfectionist
  • deMorgan
  • jsonSchemaValidator
  • casePolice
• 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.10.0

• New config: svelte via eslint-plugin-svelte, enabled automatically if svelte package is installed.
• New config: es via eslint-plugin-es-x, <u>disabled</u> by default.
• New config: cloudfrontFunctions for Amazon CloudFront Functions, <u>disabled</u> by default.
• New config: solid via eslint-plugin-solid, enabled automatically if solid-js package is installed.
• New config: nodeDependencies via eslint-plugin-node-dependencies, <u>disabled</u> by default.
• New config: jsInline via eslint-plugin-html, enabled by default.
• New config: html via @html-eslint/eslint-plugin, enabled by default unless angular config is enabled.
• [BREAKING] Minimum supported ESLint version is now ^9.15.0 as support for meta.defaultOptions is necessary for some rules to work.
• [BREAKING] Set the minimum supported Node.js version to 20.
• ESLint plugins are now loaded on demand, i.e. only if they are actually used anywhere in the config. You can opt out of this behavior by setting loadPluginsOnDemand option to false.
• Added an option to import config to specify eslint-plugin-import-x plugin settings.
• [BREAKING] Passing empty array to files will now disable the config.
• Set a new option allowRethrowing: true for @typescript-eslint/only-throw-error rule.
• Enabled vue/no-custom-modifiers-on-v-model and vue/no-multiple-template-root rules for Vue 2 codebases.
• Introduced a new root option mode with possible values of app and lib. It currently only controls whether you're allowed to import from devDependencies or not.
• [BREAKING] Importing from peerDependencies is now allowed by default (rule: import/no-extraneous-dependencies). Also disabled this rule in cli config.
• Added the ability to change plugin prefixes.
• extraConfigs now always get a name in the form of eslint-config-un/extra-config/<provided name or "unnamed<config index>">.
• Set a new option reportGlobalThis: true for no-shadow-restricted-names rule.

Dependencies

• typescript-eslint: 8.31.1 -> 8.32.0
  • 🟢 (enabled) no-unnecessary-type-conversion.
• angular-eslint: 19.3.0 -> 19.4.0
  • 🟢 (enabled) prefer-template-literal
  • 🟢 prefer-output-emitter-ref
• eslint-plugin-vue: 10.0.1 -> 10.1.0
  • 🟢 (enabled) define-props-destructuring. Enforced no props destructuring by default.
• eslint-plugin-unicorn: 59.0.0 -> 59.0.1
• @eslint-react/eslint-plugin: 1.48.5 -> 1.49.0
  • 🟢 (enabled) jsx-key-before-spread
• @next/eslint-plugin-next: 15.3.1 -> 15.3.2
• @vitest/eslint-plugin: 1.1.43 -> 1.1.44
• eslint-config-prettier: 10.1.2 -> 10.1.5
• eslint-plugin-import-x: 4.11.0 -> 4.11.1
• eslint-plugin-jsdoc: 50.6.11 -> 50.6.14