typescript-eslint · JoshuaKGoldberg · May 16, 2022 · Mar 20, 2022 · Mar 21, 2022 · Mar 21, 2022
diff --git a/docs/linting/PRESETS.md b/docs/linting/PRESETS.md
@@ -0,0 +1,54 @@
+---
+id: presets
+sidebar_label: Presets
+title: Presets
+---
+
+`@typescript-eslint/eslint-plugin` includes three rulesets you can extend from to pull in the recommended starting rules.
+
+### `plugin:@typescript-eslint/recommended`
+
+Recommended rules for code correctness that you can drop in without additional configuration.
+We strongly recommend all TypeScript projects extend from this preset.
+
+This preset is considered "stable": rule additions and removals will only be done in major version bumps.
+
+```json
+{
+  "extends": ["plugin:@typescript-eslint/recommended"]
+}
+```
+
+### `plugin:@typescript-eslint/recommended-requiring-type-checking`
+
+```json
+{
+  "extends": [
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking"
+  ]
+}
+```
+
+Additional recommended rules that require type information.
+We recommend all TypeScript projects extend from this preset, with the caveat that rules using type information take longer to run.
+See [Linting with Type Information](/docs/linting/type-linting) for more details.
+
+This preset is considered "stable": rule additions and removals will only be done in major version bumps.
+
+### `plugin:@typescript-eslint/strict`
+
+```json
+{
+  "extends": [
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking",
+    "plugin:@typescript-eslint/strict"
+  ]
+}
+```
+
+Additional strict rules that can also catch bugs but are more opinionated than recommended rules.
+If you are an experienced TypeScript user, you may find benefit from extending from this preset.
+
+This preset is considered "unstable": rule additions and removals may be done in minor or even patch version bumps.
diff --git a/packages/eslint-plugin/README.md b/packages/eslint-plugin/README.md
diff --git a/packages/eslint-plugin/docs/rules/README.md b/packages/eslint-plugin/docs/rules/README.md
diff --git a/packages/eslint-plugin/docs/rules/TEMPLATE.md b/packages/eslint-plugin/docs/rules/TEMPLATE.md
@@ -22,6 +22,8 @@ To fill out: tell us more about this rule.
 
 ## Options
 
+This rule is not configurable.
+
 ```jsonc
 // .eslintrc.json
 {
@@ -53,5 +55,6 @@ For example if this rule requires a feature released in a certain TS version.
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/adjacent-overload-signatures.md b/packages/eslint-plugin/docs/rules/adjacent-overload-signatures.md
@@ -108,5 +108,6 @@ If you don't care about the general structure of the code, then you will not nee
 ## Attributes
 
 - [x] ✅ Recommended
+- [x] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/array-type.md b/packages/eslint-plugin/docs/rules/array-type.md
@@ -126,5 +126,6 @@ This matrix lists all possible option combinations and their expected results fo
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/await-thenable.md b/packages/eslint-plugin/docs/rules/await-thenable.md
@@ -54,5 +54,6 @@ This is generally not preferred, but can sometimes be useful for visual consiste
 ## Attributes
 
 - [x] ✅ Recommended
+- [x] ✔ Strict
 - [ ] 🔧 Fixable
 - [x] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/ban-ts-comment.md b/packages/eslint-plugin/docs/rules/ban-ts-comment.md
@@ -146,5 +146,6 @@ If you want to use all of the TypeScript directives.
 ## Attributes
 
 - [x] ✅ Recommended
+- [x] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/ban-tslint-comment.md b/packages/eslint-plugin/docs/rules/ban-tslint-comment.md
@@ -30,12 +30,26 @@ someCode(); // tslint:disable-line
 someCode(); // This is a comment that just happens to mention tslint
 ```
 
+## Options
+
+```jsonc
+// .eslintrc.json
+{
+  "rules": {
+    "@typescript-eslint/ban-tslint-comment": "warn"
+  }
+}
+```
+
+This rule is not configurable.
+
 ## When Not To Use It
 
 If you are still using TSLint.
 
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/ban-types.md b/packages/eslint-plugin/docs/rules/ban-types.md
@@ -190,5 +190,6 @@ const curly2: Record<'a', string> = { a: 'string' };
 ## Attributes
 
 - [x] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/brace-style.md b/packages/eslint-plugin/docs/rules/brace-style.md
@@ -30,5 +30,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/class-literal-property-style.md b/packages/eslint-plugin/docs/rules/class-literal-property-style.md
@@ -112,5 +112,6 @@ for how literal values are exposed by your classes.
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/comma-dangle.md b/packages/eslint-plugin/docs/rules/comma-dangle.md
@@ -42,5 +42,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/comma-spacing.md b/packages/eslint-plugin/docs/rules/comma-spacing.md
@@ -30,5 +30,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/consistent-indexed-object-style.md b/packages/eslint-plugin/docs/rules/consistent-indexed-object-style.md
@@ -86,5 +86,6 @@ type Foo = {
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/consistent-type-assertions.md b/packages/eslint-plugin/docs/rules/consistent-type-assertions.md
@@ -120,5 +120,6 @@ If you do not want to enforce consistent type assertions.
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/consistent-type-definitions.md b/packages/eslint-plugin/docs/rules/consistent-type-definitions.md
@@ -88,5 +88,6 @@ If you specifically want to use an interface or type literal for stylistic reaso
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/consistent-type-exports.md b/packages/eslint-plugin/docs/rules/consistent-type-exports.md
@@ -83,5 +83,6 @@ export { Button, type ButtonProps } from 'some-library';
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [x] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/consistent-type-imports.md b/packages/eslint-plugin/docs/rules/consistent-type-imports.md
@@ -68,5 +68,6 @@ const x: import('Bar') = 1;
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/default-param-last.md b/packages/eslint-plugin/docs/rules/default-param-last.md
@@ -66,5 +66,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/dot-notation.md b/packages/eslint-plugin/docs/rules/dot-notation.md
@@ -91,5 +91,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [x] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/explicit-function-return-type.md b/packages/eslint-plugin/docs/rules/explicit-function-return-type.md
@@ -294,5 +294,6 @@ you will not need this rule.
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/explicit-member-accessibility.md b/packages/eslint-plugin/docs/rules/explicit-member-accessibility.md
@@ -352,5 +352,6 @@ If you think defaulting to public is a good default, then you should consider us
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/explicit-module-boundary-types.md b/packages/eslint-plugin/docs/rules/explicit-module-boundary-types.md
@@ -289,5 +289,6 @@ If you wish to make sure all functions have explicit return types, as opposed to
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/func-call-spacing.md b/packages/eslint-plugin/docs/rules/func-call-spacing.md
@@ -30,5 +30,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/indent.md b/packages/eslint-plugin/docs/rules/indent.md
@@ -34,5 +34,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/init-declarations.md b/packages/eslint-plugin/docs/rules/init-declarations.md
@@ -30,5 +30,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/keyword-spacing.md b/packages/eslint-plugin/docs/rules/keyword-spacing.md
@@ -30,5 +30,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/lines-between-class-members.md b/packages/eslint-plugin/docs/rules/lines-between-class-members.md
@@ -81,5 +81,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/member-delimiter-style.md b/packages/eslint-plugin/docs/rules/member-delimiter-style.md
@@ -212,5 +212,6 @@ If you don't care about enforcing a consistent member delimiter in interfaces an
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/member-ordering.md b/packages/eslint-plugin/docs/rules/member-ordering.md
@@ -1116,5 +1116,6 @@ If you don't care about the general structure of your classes and interfaces, th
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/method-signature-style.md b/packages/eslint-plugin/docs/rules/method-signature-style.md
@@ -108,5 +108,6 @@ If you don't want to enforce a particular style for object/interface function ty
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/naming-convention.md b/packages/eslint-plugin/docs/rules/naming-convention.md
@@ -704,5 +704,6 @@ If you do not want to enforce naming conventions for anything.
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [x] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-array-constructor.md b/packages/eslint-plugin/docs/rules/no-array-constructor.md
@@ -53,5 +53,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [x] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-base-to-string.md b/packages/eslint-plugin/docs/rules/no-base-to-string.md
@@ -93,5 +93,6 @@ If you don't mind `"[object Object]"` in your strings, then you will not need th
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [ ] 🔧 Fixable
 - [x] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-confusing-non-null-assertion.md b/packages/eslint-plugin/docs/rules/no-confusing-non-null-assertion.md
@@ -41,6 +41,19 @@ const isEqualsBar = foo.bar == 'hello';
 const isEqualsNum = (1 + foo.num!) == 2;
 ```
 
+## Options
+
+```jsonc
+// .eslintrc.json
+{
+  "rules": {
+    "@typescript-eslint/no-confusing-non-null-assertion": "warn"
+  }
+}
+```
+
+This rule is not configurable.
+
 ## When Not To Use It
 
 If you don't care about this confusion, then you will not need this rule.
@@ -52,5 +65,6 @@ If you don't care about this confusion, then you will not need this rule.
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-confusing-void-expression.md b/packages/eslint-plugin/docs/rules/no-confusing-void-expression.md
@@ -155,5 +155,6 @@ Also, if you prefer concise coding style then also don't use it.
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [x] 🔧 Fixable
 - [x] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-dupe-class-members.md b/packages/eslint-plugin/docs/rules/no-dupe-class-members.md
@@ -30,5 +30,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-duplicate-imports.md b/packages/eslint-plugin/docs/rules/no-duplicate-imports.md
@@ -30,5 +30,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [ ] ✅ Recommended
+- [ ] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-dynamic-delete.md b/packages/eslint-plugin/docs/rules/no-dynamic-delete.md
@@ -40,6 +40,19 @@ delete container[7];
 delete container['-Infinity'];
 ```
 
+## Options
+
+```jsonc
+// .eslintrc.json
+{
+  "rules": {
+    "@typescript-eslint/no-dynamic-delete": "warn"
+  }
+}
+```
+
+This rule is not configurable.
+
 ## When Not To Use It
 
 When you know your keys are safe to delete, this rule can be unnecessary.
@@ -55,5 +68,6 @@ Even repeated minor performance slowdowns likely do not significantly affect you
 ## Attributes
 
 - [ ] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-empty-function.md b/packages/eslint-plugin/docs/rules/no-empty-function.md
@@ -96,5 +96,6 @@ Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/
 ## Attributes
 
 - [x] ✅ Recommended
+- [x] ✔ Strict
 - [ ] 🔧 Fixable
 - [ ] 💭 Requires type information
diff --git a/packages/eslint-plugin/docs/rules/no-empty-interface.md b/packages/eslint-plugin/docs/rules/no-empty-interface.md
@@ -72,5 +72,6 @@ If you don't care about having empty/meaningless interfaces, then you will not n
 ## Attributes
 
 - [x] ✅ Recommended
+- [x] ✔ Strict
 - [x] 🔧 Fixable
 - [ ] 💭 Requires type information