xo 0.50.0 → 0.52.1

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unnecessary-qualifier.md

@@ -1,6 +1,10 @@
-# `no-unnecessary-qualifier`
+---
+description: 'Disallow unnecessary namespace qualifiers.'
+---
 
-Disallows unnecessary namespace qualifiers.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unnecessary-qualifier** for documentation.
 
 ## Rule Details
 
@@ -76,23 +80,6 @@ namespace X {
 }
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-unnecessary-qualifier": "warn"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## When Not To Use It
 
 If you don't care about having unneeded namespace or enum qualifiers, then you don't need to use this rule.
-
-## Related To
-
-- TSLint: [no-unnecessary-qualifier](https://palantir.github.io/tslint/rules/no-unnecessary-qualifier/)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unnecessary-type-arguments.md

@@ -1,6 +1,10 @@
-# `no-unnecessary-type-arguments`
+---
+description: 'Disallow type arguments that are equal to the default.'
+---
 
-Disallows type arguments that are equal to the default.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unnecessary-type-arguments** for documentation.
 
 Warns if an explicitly specified type argument is the default for that type parameter.
 
@@ -53,20 +57,3 @@ class D extends C<string> {}
 interface I<T = number> {}
 class Impl implements I<string> {}
 ```
-
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-unnecessary-type-arguments": "warn"
-  }
-}
-```
-
-This rule is not configurable.
-
-## Related To
-
-- TSLint: [use-default-type-parameter](https://palantir.github.io/tslint/rules/use-default-type-parameter)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unnecessary-type-assertion.md

@@ -1,6 +1,10 @@
-# `no-unnecessary-type-assertion`
+---
+description: 'Disallow type assertions that do not change the type of an expression.'
+---
 
-Disallows type assertions that do not change the type of an expression.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unnecessary-type-assertion** for documentation.
 
 This rule prohibits using a type assertion that does not change the type of an expression.
 
@@ -61,9 +65,9 @@ function foo(x: number | undefined): number {
 
 ## Options
 
-This rule optionally takes an object with a single property `typesToIgnore`, which can be set to a list of type names to ignore.
+### `typesToIgnore`
 
-For example, with `@typescript-eslint/no-unnecessary-type-assertion: ["error", { typesToIgnore: ['Foo'] }]`, the following is **correct** code":
+With `@typescript-eslint/no-unnecessary-type-assertion: ["error", { typesToIgnore: ['Foo'] }]`, the following is **correct** code":
 
 ```ts
 type Foo = 3;
@@ -73,7 +77,3 @@ const foo: Foo = 3;
 ## When Not To Use It
 
 If you don't care about having no-op type assertions in your code, then you can turn off this rule.
-
-## Related To
-
-- TSLint: [`no-unnecessary-type-assertion`](https://palantir.github.io/tslint/rules/no-unnecessary-type-assertion/)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unnecessary-type-constraint.md

@@ -1,6 +1,10 @@
-# `no-unnecessary-type-constraint`
+---
+description: 'Disallow unnecessary constraints on generic types.'
+---
 
-Disallows unnecessary constraints on generic types.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unnecessary-type-constraint** for documentation.
 
 ## Rule Details
 
@@ -56,19 +60,6 @@ const Quux = <T>() => {};
 function Quuz<T>() {}
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-unnecessary-type-constraint": "error"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## When Not To Use It
 
 If you don't care about the specific styles of your type constraints, or never use them in the first place, then you will not need this rule.

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unsafe-argument.md

@@ -1,6 +1,10 @@
-# `no-unsafe-argument`
+---
+description: 'Disallow calling a function with a value with type `any`.'
+---
 
-Disallows calling a function with a value with type `any`.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unsafe-argument** for documentation.
 
 Despite your best intentions, the `any` type can sometimes leak into your codebase.
 Call a function with `any` typed argument are not checked at all by TypeScript, so it creates a potential safety hole, and source of bugs in your codebase.
@@ -71,20 +75,6 @@ declare function foo(arg1: unknown, arg2: Set<unkown>, arg3: unknown[]): void;
 foo(1 as any, new Set<any>(), [] as any[]);
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-unsafe-argument": "error"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## Related To
 
 - [`no-explicit-any`](./no-explicit-any.md)
-- TSLint: [`no-unsafe-any`](https://palantir.github.io/tslint/rules/no-unsafe-any/)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unsafe-assignment.md

@@ -1,6 +1,10 @@
-# `no-unsafe-assignment`
+---
+description: 'Disallow assigning a value with type `any` to variables and properties.'
+---
 
-Disallows assigning a value with type `any` to variables and properties.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unsafe-assignment** for documentation.
 
 Despite your best intentions, the `any` type can sometimes leak into your codebase.
 Assigning an `any` typed value to a variable can be hard to pick up on, particularly if it leaks in from an external library. Operations on the variable will not be checked at all by TypeScript, so it creates a potential safety hole, and source of bugs in your codebase.
@@ -74,20 +78,6 @@ const x: unknown[] = y as any[];
 const x: Set<unknown> = y as Set<any>;
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-unsafe-assignment": "error"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## Related To
 
 - [`no-explicit-any`](./no-explicit-any.md)
-- TSLint: [`no-unsafe-any`](https://palantir.github.io/tslint/rules/no-unsafe-any/)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unsafe-call.md

@@ -1,6 +1,10 @@
-# `no-unsafe-call`
+---
+description: 'Disallow calling a value with type `any`.'
+---
 
-Disallows calling a value with type `any`.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unsafe-call** for documentation.
 
 Despite your best intentions, the `any` type can sometimes leak into your codebase.
 The arguments to, and return value of calling an `any` typed variable are not checked at all by TypeScript, so it creates a potential safety hole, and source of bugs in your codebase.
@@ -48,20 +52,6 @@ new Map();
 String.raw`foo`;
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-unsafe-call": "error"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## Related To
 
 - [`no-explicit-any`](./no-explicit-any.md)
-- TSLint: [`no-unsafe-any`](https://palantir.github.io/tslint/rules/no-unsafe-any/)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unsafe-member-access.md

@@ -1,6 +1,10 @@
-# `no-unsafe-member-access`
+---
+description: 'Disallow member access on a value with type `any`.'
+---
 
-Disallows member access on a value with type `any`.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unsafe-member-access** for documentation.
 
 Despite your best intentions, the `any` type can sometimes leak into your codebase.
 Member access on `any` typed variables is not checked at all by TypeScript, so it creates a potential safety hole, and source of bugs in your codebase.
@@ -54,20 +58,6 @@ arr[idx];
 arr[idx++];
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-unsafe-member-access": "error"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## Related To
 
 - [`no-explicit-any`](./no-explicit-any.md)
-- TSLint: [`no-unsafe-any`](https://palantir.github.io/tslint/rules/no-unsafe-any/)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unsafe-return.md

@@ -1,6 +1,10 @@
-# `no-unsafe-return`
+---
+description: 'Disallow returning a value with type `any` from a function.'
+---
 
-Disallows returning a value with type `any` from a function.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unsafe-return** for documentation.
 
 Despite your best intentions, the `any` type can sometimes leak into your codebase.
 Returned `any` typed values are not checked at all by TypeScript, so it creates a potential safety hole, and source of bugs in your codebase.
@@ -91,20 +95,6 @@ function foo2(): unknown[] {
 }
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-unsafe-return": "error"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## Related To
 
 - [`no-explicit-any`](./no-explicit-any.md)
-- TSLint: [`no-unsafe-any`](https://palantir.github.io/tslint/rules/no-unsafe-any/)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unused-expressions.md

@@ -1,28 +1,12 @@
-# `no-unused-expressions`
+---
+description: 'Disallow unused expressions.'
+---
 
-Disallows unused expressions.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unused-expressions** for documentation.
 
 ## Rule Details
 
 This rule extends the base [`eslint/no-unused-expressions`](https://eslint.org/docs/rules/no-unused-expressions) rule.
 It adds support for optional call expressions `x?.()`, and directive in module declarations.
-
-## How to Use
-
-```jsonc
-{
-  // note you must disable the base rule as it can report incorrect errors
-  "no-unused-expressions": "off",
-  "@typescript-eslint/no-unused-expressions": ["error"]
-}
-```
-
-## Options
-
-See [`eslint/no-unused-expressions` options](https://eslint.org/docs/rules/no-unused-expressions#options).
-
-<sup>
-
-Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/docs/rules/no-unused-expressions.md)
-
-</sup>

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-unused-vars.md

@@ -1,28 +1,12 @@
-# `no-unused-vars`
+---
+description: 'Disallow unused variables.'
+---
 
-Disallows unused variables.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unused-vars** for documentation.
 
 ## Rule Details
 
 This rule extends the base [`eslint/no-unused-vars`](https://eslint.org/docs/rules/no-unused-vars) rule.
 It adds support for TypeScript features, such as types.
-
-## How to Use
-
-```jsonc
-{
-  // note you must disable the base rule as it can report incorrect errors
-  "no-unused-vars": "off",
-  "@typescript-eslint/no-unused-vars": ["error"]
-}
-```
-
-## Options
-
-See [`eslint/no-unused-vars` options](https://eslint.org/docs/rules/no-unused-vars#options).
-
-<sup>
-
-Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/docs/rules/no-unused-vars.md)
-
-</sup>

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-use-before-define.md

@@ -1,25 +1,18 @@
-# `no-use-before-define`
+---
+description: 'Disallow the use of variables before they are defined.'
+---
 
-Disallows the use of variables before they are defined.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-use-before-define** for documentation.
 
 ## Rule Details
 
 This rule extends the base [`eslint/no-use-before-define`](https://eslint.org/docs/rules/no-use-before-define) rule.
 It adds support for `type`, `interface` and `enum` declarations.
 
-## How to Use
-
-```jsonc
-{
-  // note you must disable the base rule as it can report incorrect errors
-  "no-use-before-define": "off",
-  "@typescript-eslint/no-use-before-define": ["error"]
-}
-```
-
 ## Options
 
-See [`eslint/no-use-before-define` options](https://eslint.org/docs/rules/no-use-before-define#options).
 This rule adds the following options:
 
 ```ts
@@ -102,13 +95,3 @@ type StringOrNumber = string | number;
 let var2: Enum;
 enum Enum {}
 ```
-
-### Other Options
-
-See [`eslint/no-use-before-define` options](https://eslint.org/docs/rules/no-use-before-define#options).
-
-<sup>
-
-Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/docs/rules/no-use-before-define.md)
-
-</sup>

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-useless-constructor.md

@@ -1,6 +1,10 @@
-# `no-useless-constructor`
+---
+description: 'Disallow unnecessary constructors.'
+---
 
-Disallows unnecessary constructors.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-useless-constructor** for documentation.
 
 ## Rule Details
 
@@ -11,27 +15,7 @@ It adds support for:
 - `public` constructors when there is no superclass,
 - constructors with only parameter properties.
 
-## How to Use
-
-```jsonc
-{
-  // note you must disable the base rule as it can report incorrect errors
-  "no-useless-constructor": "off",
-  "@typescript-eslint/no-useless-constructor": ["error"]
-}
-```
-
-## Options
-
-See [`eslint/no-useless-constructor` options](https://eslint.org/docs/rules/no-useless-constructor#options).
-
-<sup>
-
-Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/docs/rules/no-useless-constructor.md)
-
-</sup>
-
-## Caveat
+### Caveat
 
 This lint rule will report on constructors whose sole purpose is to change visibility of a parent constructor.
 See [discussion on this rule's lack of type information](https://github.com/typescript-eslint/typescript-eslint/issues/3820#issuecomment-917821240) for context.

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-useless-empty-export.md

@@ -1,6 +1,10 @@
-# `no-useless-empty-export`
+---
+description: "Disallow empty exports that don't change anything in a module file."
+---
 
-Disallows empty exports that don't change anything in a module file.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-useless-empty-export** for documentation.
 
 ## Rule Details
 
@@ -37,16 +41,3 @@ export const value = 'Hello, world!';
 ```ts
 import 'some-other-module';
 ```
-
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-useless-empty-export": "warn"
-  }
-}
-```
-
-This rule is not configurable.

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/no-var-requires.md

@@ -1,6 +1,10 @@
-# `no-var-requires`
+---
+description: 'Disallow `require` statements except in import statements.'
+---
 
-Disallows `require` statements except in import statements.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-var-requires** for documentation.
 
 In other words, the use of forms such as `var foo = require("foo")` are banned. Instead use ES6 style imports or `import foo = require("foo")` imports.
 
@@ -26,23 +30,6 @@ require('foo');
 import foo from 'foo';
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/no-var-requires": "error"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## When Not To Use It
 
 If you don't care about TypeScript module syntax, then you will not need this rule.
-
-## Related To
-
-- TSLint: [no-var-requires](https://palantir.github.io/tslint/rules/no-var-requires/)

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/non-nullable-type-assertion-style.md

@@ -1,6 +1,10 @@
-# `non-nullable-type-assertion-style`
+---
+description: 'Enforce non-null assertions over explicit type casts.'
+---
 
-Enforces non-null assertions over explicit type casts.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/non-nullable-type-assertion-style** for documentation.
 
 This rule detects when an `as` cast is doing the same job as a `!` would, and suggests fixing the code to be an `!`.
 
@@ -28,19 +32,6 @@ const definitely = maybe!;
 const alsoDefinitely = maybe!;
 ```
 
-## Options
-
-```jsonc
-// .eslintrc.json
-{
-  "rules": {
-    "@typescript-eslint/non-nullable-type-assertion-style": "warn"
-  }
-}
-```
-
-This rule is not configurable.
-
 ## When Not To Use It
 
 If you don't mind having unnecessarily verbose type casts, you can avoid this rule.

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/object-curly-spacing.md

@@ -1,28 +1,12 @@
-# `object-curly-spacing`
+---
+description: 'Enforce consistent spacing inside braces.'
+---
 
-Enforces consistent spacing inside braces.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/object-curly-spacing** for documentation.
 
 ## Rule Details
 
 This rule extends the base [`eslint/object-curly-spacing`](https://eslint.org/docs/rules/object-curly-spacing) rule.
 It adds support for TypeScript's object types.
-
-## How to Use
-
-```jsonc
-{
-  // note you must disable the base rule as it can report incorrect errors
-  "object-curly-spacing": "off",
-  "@typescript-eslint/object-curly-spacing": ["error"]
-}
-```
-
-## Options
-
-See [`eslint/object-curly-spacing` options](https://eslint.org/docs/rules/object-curly-spacing#options).
-
-<sup>
-
-Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/docs/rules/object-curly-spacing.md)
-
-</sup>

package/node_modules/@typescript-eslint/eslint-plugin/docs/rules/padding-line-between-statements.md

@@ -1,34 +1,25 @@
-# `padding-line-between-statements`
+---
+description: 'Require or disallow padding lines between statements.'
+---
 
-Requires or disallows padding lines between statements.
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/padding-line-between-statements** for documentation.
 
 ## Rule Details
 
 This rule extends the base [`eslint/padding-line-between-statements`](https://eslint.org/docs/rules/padding-line-between-statements) rule.
+It adds support for TypeScript constructs such as `interface` and `type`.
 
-**It adds support for TypeScript constructs such as `interface` and `type`.**
+## Options
 
-## How to Use
+In addition to options provided by ESLint, `interface` and `type` can be used as statement types.
 
-```jsonc
-{
-  // note you must disable the base rule as it can report incorrect errors
-  "padding-line-between-statements": "off",
-  "@typescript-eslint/padding-line-between-statements": [
-    "error",
-    {
-      "blankLine": "always",
-      "prev": "var",
-      "next": "return"
-    }
-  ]
-}
-```
+For example, to add blank lines before interfaces and type definitions:
 
 ```jsonc
 {
   // Example - Add blank lines before interface and type definitions.
-  // note you must disable the base rule as it can report incorrect errors
   "padding-line-between-statements": "off",
   "@typescript-eslint/padding-line-between-statements": [
     "error",
@@ -41,16 +32,4 @@ This rule extends the base [`eslint/padding-line-between-statements`](https://es
 }
 ```
 
-## Options
-
-See [`eslint/padding-line-between-statements` options](https://eslint.org/docs/rules/padding-line-between-statements#options).
-
-In addition to options provided by ESLint, `interface` and `type` can be used as statement types.
-
 **Note:** ESLint `cjs-export` and `cjs-import` statement types are renamed to `exports` and `require` respectively.
-
-<sup>
-
-Taken with ❤️ [from ESLint core](https://github.com/eslint/eslint/blob/main/docs/rules/padding-line-between-statements.md)
-
-</sup>