@typescript-eslint/eslint-plugin 6.10.1-alpha.9 → 6.11.0

package/docs/rules/no-unsafe-enum-comparison.md

@@ -6,21 +6,23 @@ description: 'Disallow comparing an enum value with a non-enum value.'
 >
 > See **https://typescript-eslint.io/rules/no-unsafe-enum-comparison** for documentation.
 
-The TypeScript compiler can be surprisingly lenient when working with enums.
-For example, it will allow you to compare enum values against numbers even though they might not have any type overlap:
+The TypeScript compiler can be surprisingly lenient when working with enums. String enums are widely considered to be safer than number enums, but even string enums have some pitfalls. For example, it is allowed to compare enum values against literals:
 
 ```ts
-enum Fruit {
-  Apple,
-  Banana,
+enum Vegetable {
+  Asparagus = 'asparagus',
 }
 
-declare let fruit: Fruit;
+declare const vegetable: Vegetable;
 
-fruit === 999; // No error
+vegetable === 'asparagus'; // No error
 ```
 
-This rule flags when an enum typed value is compared to a non-enum `number`.
+The above code snippet should instead be written as `vegetable === Vegetable.Asparagus`. Allowing literals in comparisons subverts the point of using enums in the first place. By enforcing comparisons with properly typed enums:
+
+- It makes a codebase more resilient to enum members changing values.
+- It allows for code IDEs to use the "Rename Symbol" feature to quickly rename an enum.
+- It aligns code to the proper enum semantics of referring to them by name and treating their values as implementation details.
 
 ## Examples
 
@@ -35,7 +37,7 @@ enum Fruit {
 
 declare let fruit: Fruit;
 
-fruit === 999;
+fruit === 0;
 ```
 
 ```ts
@@ -57,7 +59,7 @@ enum Fruit {
 
 declare let fruit: Fruit;
 
-fruit === Fruit.Banana;
+fruit === Fruit.Apple;
 ```
 
 ```ts

package/docs/rules/no-unsafe-unary-minus.md

@@ -0,0 +1,50 @@
+---
+description: 'Require unary negation to take a number.'
+---
+
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/no-unsafe-unary-minus** for documentation.
+
+TypeScript does not prevent you from putting a minus sign before things other than numbers:
+
+```ts
+const s = 'hello';
+const x = -s; // x is NaN
+```
+
+This rule restricts the unary `-` operator to `number | bigint`.
+
+## Examples
+
+### ❌ Incorrect
+
+```ts
+declare const a: string;
+-a;
+
+declare const b: {};
+-b;
+```
+
+### ✅ Correct
+
+```ts
+-42;
+-42n;
+
+declare const a: number;
+-a;
+
+declare const b: number;
+-b;
+
+declare const c: number | bigint;
+-c;
+
+declare const d: any;
+-d;
+
+declare const e: 1 | 2;
+-e;
+```

package/index.d.ts

@@ -1,9 +1,9 @@
-import type { TSESLint } from '@typescript-eslint/utils';
+import type { ClassicConfig } from '@typescript-eslint/utils/ts-eslint';
 
 import type rules from './rules';
 
 declare const cjsExport: {
-  configs: Record<string, TSESLint.Linter.Config>;
+  configs: Record<string, ClassicConfig.Config>;
   rules: typeof rules;
 };
 export = cjsExport;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typescript-eslint/eslint-plugin",
-  "version": "6.10.1-alpha.9+99833124c",
+  "version": "6.11.0",
   "description": "TypeScript plugin for ESLint",
   "files": [
     "dist",
@@ -57,10 +57,10 @@
   },
   "dependencies": {
     "@eslint-community/regexpp": "^4.5.1",
-    "@typescript-eslint/scope-manager": "6.10.1-alpha.9+99833124c",
-    "@typescript-eslint/type-utils": "6.10.1-alpha.9+99833124c",
-    "@typescript-eslint/utils": "6.10.1-alpha.9+99833124c",
-    "@typescript-eslint/visitor-keys": "6.10.1-alpha.9+99833124c",
+    "@typescript-eslint/scope-manager": "6.11.0",
+    "@typescript-eslint/type-utils": "6.11.0",
+    "@typescript-eslint/utils": "6.11.0",
+    "@typescript-eslint/visitor-keys": "6.11.0",
     "debug": "^4.3.4",
     "graphemer": "^1.4.0",
     "ignore": "^5.2.4",
@@ -73,8 +73,8 @@
     "@types/debug": "*",
     "@types/marked": "*",
     "@types/natural-compare": "*",
-    "@typescript-eslint/rule-schema-to-typescript-types": "6.10.0",
-    "@typescript-eslint/rule-tester": "6.10.1-alpha.9+99833124c",
+    "@typescript-eslint/rule-schema-to-typescript-types": "6.11.0",
+    "@typescript-eslint/rule-tester": "6.11.0",
     "ajv": "^6.12.6",
     "chalk": "^5.3.0",
     "cross-fetch": "*",
@@ -103,5 +103,5 @@
     "type": "opencollective",
     "url": "https://opencollective.com/typescript-eslint"
   },
-  "gitHead": "99833124c5218c541f1734e6e310aff2261d59e1"
+  "gitHead": "06496e206a3219c01b370f6b5f8c89d41a4b86b8"
 }