eslint-plugin-etc-misc

June 18, 2026 · View on GitHub

npm version. npm downloads. license.

Opinionated ESLint plugin that combines and curates rules from etc and misc style linting patterns for TypeScript-heavy codebases.

Credits

This plugin builds on ideas and rule work from:

Installation

npm install --save-dev eslint-plugin-etc-misc eslint typescript

Usage (Flat Config)

import etcMisc from "eslint-plugin-etc-misc";
import tsParser from "@typescript-eslint/parser";

export default [
 {
  files: ["**/*.{ts,tsx,mts,cts}"],
  languageOptions: {
   parser: tsParser,
   parserOptions: {
    ecmaVersion: "latest",
    sourceType: "module",
   },
  },
 },
 etcMisc.configs.recommended,
];

If your project uses CommonJS config files, require() works too:

// eslint.config.cjs
const etcMisc = require("eslint-plugin-etc-misc");

module.exports = [etcMisc.configs.recommended];

A good way to adopt this plugin is to pick only the rules you want, then scope them manually to the files where they provide the most value.

import tsParser from "@typescript-eslint/parser";
import etcMisc from "eslint-plugin-etc-misc";

export default [
 {
  files: ["src/**/*.{ts,tsx,mts,cts}"],
  languageOptions: {
   parser: tsParser,
   parserOptions: {
    ecmaVersion: "latest",
    sourceType: "module",
   },
  },
  plugins: {
   "etc-misc": etcMisc,
  },
  rules: {
   "etc-misc/no-assign-mutated-array": "error",
   "etc-misc/no-internal": "error",
   "etc-misc/typescript/require-this-void": "warn",
  },
 },
];

Plugin namespace

Rules are namespaced as etc-misc/<rule-name>, for example:

{
    plugins: {
        "etc-misc": etcMisc,
    },
    rules: {
        "etc-misc/no-t": "error",
    },
}

Presets

Preset
🟢 etcMisc.configs.minimal
🟡 etcMisc.configs.recommended
🟠 etcMisc.configs.strict
🔵 etcMisc.configs.strictTypeChecked
🔴 etcMisc.configs.allStrict
🟣 etcMisc.configs.all

Rules

RuleFixPreset keyDeprecatedRecommended replacement
array-type🔧🔴 🟣⚠️@typescript-eslint/array-type
class-match-filename—🔴 🟣——
comment-spacing—🔴 🟣——
consistent-empty-lines—🔴 🟣——
consistent-enum-members—🔴 🟣——
consistent-filename—🔴 🟣⚠️unicorn/filename-case
consistent-import—🔴 🟣——
consistent-optional-props🔧🟢 🟡 🟠 🔵 🔴 🟣——
consistent-source-extension—🔴 🟣⚠️import/extensions
consistent-symbol-description—🔴 🟣——
default-case—🔴 🟣——
disallow-import—🔴 🟣——
export-matching-filename-only—🔴 🟣——
match-filename—🔴 🟣——
max-identifier-blocks—🔴 🟣——
no-assign-mutated-array—🟢 🟡 🟠 🔵 🔴 🟣——
no-at-sign-import—🔴 🟣——
no-at-sign-internal-import—🔴 🟣——
no-chain-coalescence-mixture—🔴 🟣——
no-commented-out-code—🔴 🟣⚠️no-commented-code
no-const-enum🔧 💡🟢 🟡 🟠 🔵 🔴 🟣——
no-deprecated—🔴 🟣⚠️@typescript-eslint/no-deprecated
no-enum—🔴 🟣——
no-expression-empty-lines🔧🔴 🟣——
no-foreach—🔵 🔴 🟣——
no-function-declare-after-return🔧🟢 🟡 🟠 🔵 🔴 🟣——
no-implicit-any-catch🔧 💡🟢 🟡 🟠 🔵 🔴 🟣——
no-index-import—🔴 🟣——
no-internal—🟢 🟡 🟠 🔵 🔴 🟣——
no-internal-modules—🔴 🟣——
no-language-mixing—🔴 🟣——
no-misused-generics—🔵 🔴 🟣——
no-mixed-enums—🔴 🟣⚠️@typescript-eslint/no-mixed-enums
no-negated-conditions—🔴 🟣——
no-nodejs-modules—🔴 🟣——
no-param-reassign—🔴 🟣——
no-relative-parent-import—🔴 🟣⚠️import/no-relative-parent-imports
no-restricted-syntax—🔴 🟣⚠️no-restricted-syntax
no-secret—🔴 🟣⚠️secretlint · detect-secrets · no-secrets/no-secrets
no-self-import—🔴 🟣⚠️import/no-self-import
no-shadow—🔴 🟣⚠️@typescript-eslint/no-shadow
no-sibling-import—🔴 🟣——
no-single-line-comment🔧 💡🔴 🟣——
no-t—🟢 🟡 🟠 🔵 🔴 🟣——
no-underscore-export—🔴 🟣——
no-unnecessary-as-const🔧🟢 🟡 🟠 🔵 🔴 🟣——
no-unnecessary-break🔧 💡🟢 🟡 🟠 🔵 🔴 🟣——
no-unnecessary-initialization🔧🟢 🟡 🟠 🔵 🔴 🟣——
no-unnecessary-template-literal🔧🟢 🟡 🟠 🔵 🔴 🟣——
no-unused-disable—🔴 🟣⚠️@eslint-community/eslint-comments/no-unused-disable
no-use-extend-native—🔴 🟣——
no-useless-generics💡🔴 🟣⚠️@typescript-eslint/no-unnecessary-type-parameters
no-value-tostring—🔴 🟣⚠️@typescript-eslint/no-base-to-string
no-vulnerable—🟢 🟡 🟠 🔵 🔴 🟣——
no-writeonly—🔴 🟣——
object-format—🔴 🟣——
only-export-name—🔴 🟣——
prefer-arrow-function-property—🔴 🟣——
prefer-const-require—🔴 🟣——
prefer-includes🔧 💡🔴 🟣⚠️unicorn/prefer-includes
prefer-interface🔧 💡🔴 🟣⚠️@typescript-eslint/consistent-type-definitions
prefer-less-than🔧 💡🔴 🟣——
prefer-object-has-own🔧🔴 🟣⚠️eslint/prefer-object-has-own
prefer-only-export—🔴 🟣——
require-jsdoc—🔴 🟣⚠️jsdoc/require-jsdoc
require-syntax—🔴 🟣——
restrict-identifier-characters—🔴 🟣——
sort-array🔧🔴 🟣——
sort-call-signature—🔴 🟣——
sort-class-members—🔴 🟣⚠️sort-class-members · perfectionist
sort-construct-signature—🔴 🟣——
sort-export-specifiers🔧🔴 🟣——
sort-keys🔧🔴 🟣——
sort-top-comments🔧🔴 🟣——
switch-case-spacing—🔴 🟣⚠️@stylistic/switch-colon-spacing
template-literal-format🔧🔴 🟣——
throw-error💡🟢 🟡 🟠 🔵 🔴 🟣——
throw-new-error🔧🔴 🟣⚠️unicorn/throw-new-error
typescript/array-callback-return-type—🔵 🔴 🟣——
typescript/class-methods-use-this—🔴 🟣⚠️@typescript-eslint/class-methods-use-this
typescript/consistent-array-type-name—🔴 🟣——
typescript/define-function-in-one-statement—🔴 🟣——
typescript/exhaustive-switch—🔴 🟣⚠️@typescript-eslint/switch-exhaustiveness-check
typescript/no-boolean-literal-type🔧🟢 🟡 🟠 🔵 🔴 🟣——
typescript/no-complex-declarator-type—🔴 🟣——
typescript/no-complex-return-type—🔴 🟣——
typescript/no-empty-interfaces—🔴 🟣⚠️@typescript-eslint/no-empty-object-type
typescript/no-inferrable-types—🔴 🟣⚠️@typescript-eslint/no-inferrable-types
typescript/no-multi-type-tuples—🔴 🟣——
typescript/no-never—🔵 🔴 🟣——
typescript/no-redundant-undefined-const🔧 💡🔴 🟣——
typescript/no-redundant-undefined-default-parameter🔧 💡🔴 🟣——
typescript/no-redundant-undefined-let🔧 💡🔴 🟣——
typescript/no-redundant-undefined-optional🔧 💡🔴 🟣——
typescript/no-redundant-undefined-promise-return-type🔧 💡🔴 🟣——
typescript/no-redundant-undefined-readonly-property🔧 💡🔴 🟣——
typescript/no-redundant-undefined-return-type🔧 💡🔴 🟣——
typescript/no-redundant-undefined-var🔧 💡🔴 🟣——
typescript/no-restricted-syntax—🔴 🟣⚠️@typescript-eslint/no-restricted-syntax
typescript/no-unsafe-object-assign—🔵 🔴 🟣——
typescript/no-unsafe-object-assignment—🔵 🔴 🟣——
typescript/prefer-array-type-alias—🔴 🟣——
typescript/prefer-class-method—🔴 🟣——
typescript/prefer-enum—🔵 🔴 🟣——
typescript/prefer-named-tuple-members🔧 💡🔴 🟣——
typescript/prefer-readonly-array🔧🟡 🟠 🔵 🔴 🟣——
typescript/prefer-readonly-array-parameter🔧 💡🟡 🟠 🔵 🔴 🟣——
typescript/prefer-readonly-index-signature🔧🟡 🟠 🔵 🔴 🟣——
typescript/prefer-readonly-map🔧🟡 🟠 🔵 🔴 🟣——
typescript/prefer-readonly-property🔧 💡🟡 🟠 🔵 🔴 🟣——
typescript/prefer-readonly-record🔧🟡 🟠 🔵 🔴 🟣——
typescript/prefer-readonly-set🔧🟡 🟠 🔵 🔴 🟣——
typescript/require-prop-type-annotation🔧 💡🔴 🟣——
typescript/require-readonly-array-property-type🔧 💡🔴 🟣——
typescript/require-readonly-array-return-type🔧 💡🟢 🟡 🟠 🔵 🔴 🟣——
typescript/require-readonly-array-type-alias🔧 💡🔴 🟣——
typescript/require-readonly-map-parameter-type🔧 💡🔴 🟣——
typescript/require-readonly-map-property-type🔧 💡🔴 🟣——
typescript/require-readonly-map-return-type🔧 💡🔴 🟣——
typescript/require-readonly-map-type-alias🔧 💡🔴 🟣——
typescript/require-readonly-record-parameter-type🔧 💡🔴 🟣——
typescript/require-readonly-record-property-type🔧 💡🔴 🟣——
typescript/require-readonly-record-return-type🔧 💡🔴 🟣——
typescript/require-readonly-record-type-alias🔧 💡🔴 🟣——
typescript/require-readonly-set-parameter-type🔧 💡🔴 🟣——
typescript/require-readonly-set-property-type🔧 💡🔴 🟣——
typescript/require-readonly-set-return-type🔧 💡🔴 🟣——
typescript/require-readonly-set-type-alias🔧 💡🔴 🟣——
typescript/require-this-void🔧 💡🟢 🟡 🟠 🔵 🔴 🟣——
underscore-internal—🔴 🟣——
unused-internal-properties—🔴 🟣⚠️unicorn/no-unused-properties
uppercase-iife—🔴 🟣⚠️unicorn/no-unreadable-iife
words—🔴 🟣⚠️write-good-comments

Documentation

Contributors

All Contributors.

Daniel Nixon
Daniel Nixon
💻		 Felix Becker
Felix Becker
💻		 Karl Horky
Karl Horky
💻		 Martin Hochel
Martin Hochel
💻
Nicholas Jamieson
Nicholas Jamieson
💻		 Nick2bad4u
Nick2bad4u
🐛 💻 🖋 📖 🤔 🚇 🚧 🔌 🔬 👀 ⚠️ 🔧		 Snyk bot
Snyk bot
🛡️ 🚇 🚧 👀		 StepSecurity Bot
StepSecurity Bot
🛡️ 🚇 🚧
dependabot[bot]
dependabot[bot]
🚇 🛡️

This project follows the all-contributors specification. Contributions of any kind welcome!

License

MIT