feat(eslint-plugin): add config that disables type-aware linting

docs/linting/Configurations.mdx

@@ -15,14 +15,14 @@ title: Configurations
 
 If your project does not enable [typed linting](./Typed_Linting.mdx), we suggest enabling the [`recommended`](#recommended) and [`stylistic`](#stylistic) configurations to start:
 
-```json
-{
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:@typescript-eslint/stylistic"
-  ]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:@typescript-eslint/stylistic',
+  ],
+};
 ```
 
 > If a majority of developers working on your project are comfortable with TypeScript and typescript-eslint, consider replacing `recommended` with `strict`.
@@ -31,14 +31,14 @@ If your project does not enable [typed linting](./Typed_Linting.mdx), we suggest
 
 If your project enables [typed linting](./Typed_Linting.mdx), we suggest enabling the [`recommended-type-checked`](#recommended-type-checked) and [`stylistic-type-checked`](#stylistic-type-checked) configurations to start:
 
-```json
-{
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended-type-checked",
-    "plugin:@typescript-eslint/stylistic-type-checked"
-  ]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended-type-checked',
+    'plugin:@typescript-eslint/stylistic-type-checked',
+  ],
+};
 ```
 
 > If a majority of developers working on your project are comfortable with TypeScript and typescript-eslint, consider replacing `recommended-type-checked` with `strict-type-checked`.
@@ -70,10 +70,10 @@ Recommended rules for code correctness that you can drop in without additional c
 These rules are those whose reports are almost always for a bad practice and/or likely bug.
 `recommended` also disables core ESLint rules known to conflict with typescript-eslint rules or cause issues in TypeScript codebases.
 
-```json
-{
-  "extends": ["plugin:@typescript-eslint/recommended"]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: ['plugin:@typescript-eslint/recommended'],
+};
 ```
 
 See [`configs/recommended.ts`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/configs/recommended.ts) for the exact contents of this config.
@@ -83,10 +83,10 @@ See [`configs/recommended.ts`](https://github.com/typescript-eslint/typescript-e
 Contains all of `recommended` along with additional recommended rules that require type information.
 Rules newly added in this configuration are similarly useful to those in `recommended`.
 
-```json
-{
-  "extends": ["plugin:@typescript-eslint/recommended-type-checked"]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: ['plugin:@typescript-eslint/recommended-type-checked'],
+};
 ```
 
 See [`configs/recommended-type-checked.ts`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/configs/recommended-type-checked.ts) for the exact contents of this config.
@@ -96,10 +96,10 @@ See [`configs/recommended-type-checked.ts`](https://github.com/typescript-eslint
 Contains all of `recommended`, as well as additional strict rules that can also catch bugs.
 Rules added in `strict` are more opinionated than recommended rules and might not apply to all projects.
 
-```json
-{
-  "extends": ["plugin:@typescript-eslint/strict"]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: ['plugin:@typescript-eslint/strict'],
+};
 ```
 
 See [`configs/strict.ts`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/configs/strict.ts) for the exact contents of this config.
@@ -113,10 +113,10 @@ We recommend a TypeScript project extend from `plugin:@typescript-eslint/strict`
 Contains all of `recommended`, `recommended-type-checked`, and `strict`, along with additional strict rules that require type information.
 Rules newly added in this configuration are similarly useful (and opinionated) to those in `strict`.
 
-```json
-{
-  "extends": ["plugin:@typescript-eslint/strict-type-checked"]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: ['plugin:@typescript-eslint/strict-type-checked'],
+};
 ```
 
 See [`configs/strict-type-checked.ts`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/configs/strict-type-checked.ts) for the exact contents of this config.
@@ -130,10 +130,10 @@ We recommend a TypeScript project extend from `plugin:@typescript-eslint/strict-
 Rules considered to be best practice for modern TypeScript codebases, but that do not impact program logic.
 These rules are generally opinionated about enforcing simpler code patterns.
 
-```json
-{
-  "extends": ["plugin:@typescript-eslint/stylistic"]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: ['plugin:@typescript-eslint/stylistic'],
+};
 ```
 
 See [`configs/stylistic.ts`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/configs/stylistic.ts) for the exact contents of this config.
@@ -143,18 +143,17 @@ See [`configs/stylistic.ts`](https://github.com/typescript-eslint/typescript-esl
 Contains all of `stylistic`, along with additional stylistic rules that require type information.
 Rules newly added in this configuration are similarly opinionated to those in `stylistic`.
 
-```json
-{
-  "extends": ["plugin:@typescript-eslint/stylistic-type-checked"]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: ['plugin:@typescript-eslint/stylistic-type-checked'],
+};
 ```
 
 See [`configs/stylistic-type-checked.ts`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/configs/strict-type-checked.ts) for the exact contents of this config.
 
 ## Other Configurations
 
-typescript-eslint includes a scattering of utility configurations used by the recommended configurations.
-We don't recommend using these directly; instead, extend from an earlier recommended rule.
+typescript-eslint includes a few utility configurations.
 
 ### `all`
 
@@ -171,26 +170,51 @@ Many rules conflict with each other and/or are intended to be configured per-pro
 ### `base`
 
 A minimal ruleset that sets only the required parser and plugin options needed to run typescript-eslint.
-
-<configuration-contents expanded name="base" />
+We don't recommend using this directly; instead, extend from an earlier recommended rule.
 
 This config is automatically included if you use any of the recommended configurations.
 
 See [`configs/base.ts`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/configs/base.ts) for the exact contents of this config.
 
+### `disable-type-checked`
+
+A utility ruleset that will disable type-aware linting and all type-aware rules available in our project.
+This config makes it easy to have your base config concerned with type-aware linting, and then conditionally use [overrides](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-based-on-glob-patterns) to disable type-aware linting on specific subsets of your codebase.
+
+See [`configs/disable-type-checked.ts`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/configs/disable-type-checked.ts) for the exact contents of this config.
+
+:::info
+If you use type-aware rules from other plugins, you will need to manually disable these rules or use a premade config they provide to disable them.
+:::
+
+```js title=".eslintrc.js"
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/eslint-recommended',
+  ],
+  overrides: [
+    {
+      files: ['*.js'],
+      extends: ['plugin:@typescript-eslint/disable-type-checked'],
+    },
+  ],
+};
+```
+
 ### `eslint-recommended`
 
 This ruleset is meant to be used after extending `eslint:recommended`.
 It disables core ESLint rules that are already checked by the TypeScript compiler.
 Additionally, it enables rules that promote using the more modern constructs TypeScript allows for.
 
-```jsonc
-{
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/eslint-recommended"
-  ]
-}
+```js title=".eslintrc.js"
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/eslint-recommended',
+  ],
+};
 ```
 
 This config is automatically included if you use any of the recommended configurations.

docs/linting/Typed_Linting.mdx

@@ -55,14 +55,47 @@ module.exports = {
 };
 ```
 
-See [the `@typescript-eslint/parser` docs for more details](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/parser/README.md#parseroptionsproject).
+See [the `@typescript-eslint/parser` docs for more details](../architecture/Parser.mdx#project).
 
 :::note
 If your project is a multi-package monorepo, see [our docs on configuring a monorepo](./typed-linting/Monorepos.mdx).
 :::
 
 ## FAQs
 
+### How can I disable type-aware linting for a subset of files?
+
+You can combine ESLint's [overrides](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-based-on-glob-patterns) config in conjunction with our [`disable-type-checked`](./Configurations.mdx#disable-type-checked) config to turn off type-aware linting on specific subsets of files.
+
+```js title=".eslintrc.js"
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:@typescript-eslint/recommended-type-checked',
+  ],
+  plugins: ['@typescript-eslint'],
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: true,
+    tsconfigRootDir: __dirname,
+  },
+  root: true,
+  // Added lines start
+  overrides: [
+    {
+      files: ['*.js'],
+      extends: ['plugin:@typescript-eslint/disable-type-checked'],
+    },
+  ],
+  // Added lines end
+};
+```
+
+:::info
+If you use type-aware rules from other plugins, you will need to manually disable these rules or use a premade config they provide to disable them.
+:::
+
 ### How is performance?
 
 Typed rules come with a catch.

packages/eslint-plugin/src/configs/disable-type-checked.ts

@@ -0,0 +1,53 @@
+// THIS CODE WAS AUTOMATICALLY GENERATED
+// DO NOT EDIT THIS CODE BY HAND
+// SEE https://typescript-eslint.io/linting/configs
+//
+// For developers working in the typescript-eslint monorepo:
+// You can regenerate it using `yarn generate:configs`
+
+export = {
+  parserOptions: { project: null, program: null },
+  rules: {
+    '@typescript-eslint/await-thenable': 'off',
+    '@typescript-eslint/consistent-type-exports': 'off',
+    '@typescript-eslint/dot-notation': 'off',
+    '@typescript-eslint/naming-convention': 'off',
+    '@typescript-eslint/no-base-to-string': 'off',
+    '@typescript-eslint/no-confusing-void-expression': 'off',
+    '@typescript-eslint/no-floating-promises': 'off',
+    '@typescript-eslint/no-for-in-array': 'off',
+    '@typescript-eslint/no-implied-eval': 'off',
+    '@typescript-eslint/no-meaningless-void-operator': 'off',
+    '@typescript-eslint/no-misused-promises': 'off',
+    '@typescript-eslint/no-redundant-type-constituents': 'off',
+    '@typescript-eslint/no-throw-literal': 'off',
+    '@typescript-eslint/no-unnecessary-boolean-literal-compare': 'off',
+    '@typescript-eslint/no-unnecessary-condition': 'off',
+    '@typescript-eslint/no-unnecessary-qualifier': 'off',
+    '@typescript-eslint/no-unnecessary-type-arguments': 'off',
+    '@typescript-eslint/no-unnecessary-type-assertion': 'off',
+    '@typescript-eslint/no-unsafe-argument': 'off',
+    '@typescript-eslint/no-unsafe-assignment': 'off',
+    '@typescript-eslint/no-unsafe-call': 'off',
+    '@typescript-eslint/no-unsafe-member-access': 'off',
+    '@typescript-eslint/no-unsafe-return': 'off',
+    '@typescript-eslint/non-nullable-type-assertion-style': 'off',
+    '@typescript-eslint/prefer-includes': 'off',
+    '@typescript-eslint/prefer-nullish-coalescing': 'off',
+    '@typescript-eslint/prefer-readonly': 'off',
+    '@typescript-eslint/prefer-readonly-parameter-types': 'off',
+    '@typescript-eslint/prefer-reduce-type-parameter': 'off',
+    '@typescript-eslint/prefer-regexp-exec': 'off',
+    '@typescript-eslint/prefer-return-this-type': 'off',
+    '@typescript-eslint/prefer-string-starts-ends-with': 'off',
+    '@typescript-eslint/promise-function-async': 'off',
+    '@typescript-eslint/require-array-sort-compare': 'off',
+    '@typescript-eslint/require-await': 'off',
+    '@typescript-eslint/restrict-plus-operands': 'off',
+    '@typescript-eslint/restrict-template-expressions': 'off',
+    '@typescript-eslint/return-await': 'off',
+    '@typescript-eslint/strict-boolean-expressions': 'off',
+    '@typescript-eslint/switch-exhaustiveness-check': 'off',
+    '@typescript-eslint/unbound-method': 'off',
+  },
+};