chore(deps): update eslint (major) (#3687)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: xDivisionByZerox <leyla.jaehnig@gmx.de>

Author: renovate[bot]

CONTRIBUTING.md

@@ -365,7 +365,7 @@ function foo(bar: number = 0) {
  *
  * @param bar this is a parameter description. Defaults to `0`.
  *
- * @throws If bar is negative.
+ * @throws {FakerError} If bar is negative.
  */
 function foo(bar: number = 0) {
   // implementation

docs/.vitepress/versions.ts

@@ -31,7 +31,7 @@ function readOtherLatestReleaseTagNames(): string[] {
     }
   }
 
-  return Object.values(latestTagByMajor).sort(semver.rcompare);
+  return Object.values(latestTagByMajor).toSorted(semver.rcompare);
 }
 
 // Set by netlify

eslint.config.ts

@@ -157,6 +157,7 @@ export default defineConfig(
       'unicorn/no-zero-fractions': 'off', // deactivated to raise awareness of floating operations
       'unicorn/number-literal-case': 'off', // incompatible with prettier
       'unicorn/numeric-separators-style': 'off', // "magic numbers" may carry specific meaning
+      'unicorn/prefer-bigint-literals': 'off', // currently there is no clear argument on why literal would be better
       'unicorn/prefer-string-raw': 'off', // The additional prefix doesn't help readability
       'unicorn/prefer-string-slice': 'off', // string.substring is sometimes easier to use
       'unicorn/prefer-ternary': 'off', // ternaries aren't always better

package.json

@@ -98,7 +98,7 @@
     "dist"
   ],
   "devDependencies": {
-    "@eslint/compat": "1.4.1",
+    "@eslint/compat": "2.0.0",
     "@eslint/js": "9.39.2",
     "@stylistic/eslint-plugin": "5.6.1",
     "@types/node": "22.19.3",
@@ -114,9 +114,9 @@
     "eslint": "9.39.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-file-progress": "3.0.2",
-    "eslint-plugin-jsdoc": "54.7.0",
+    "eslint-plugin-jsdoc": "61.5.0",
     "eslint-plugin-prettier": "5.5.4",
-    "eslint-plugin-unicorn": "60.0.0",
+    "eslint-plugin-unicorn": "62.0.0",
     "jiti": "2.6.1",
     "npm-run-all2": "8.0.4",
     "prettier": "3.7.4",

pnpm-lock.yaml

@@ -102,7 +102,7 @@ export function processModuleClasses(project: Project): RawApiDocsPage[] {
         (module: string): boolean =>
           module.endsWith('Module') && !module.startsWith('Simple')
       )
-    ).sort((a, b) => a.getNameOrThrow().localeCompare(b.getNameOrThrow()))
+    ).toSorted((a, b) => a.getNameOrThrow().localeCompare(b.getNameOrThrow()))
   );
 }
 

scripts/apidocs/processing/class.ts

@@ -73,7 +73,7 @@ function getAllMethods(clazz: ClassDeclaration): MethodDeclaration[] {
     }
   }
 
-  return Object.values(methods).sort((a, b) =>
+  return Object.values(methods).toSorted((a, b) =>
     a.getName().localeCompare(b.getName())
   );
 }
@@ -170,7 +170,7 @@ function processMethodLikes<T extends MethodLikeDeclaration>(
         });
       }
     })
-    .sort((a, b) => a.name.localeCompare(b.name));
+    .toSorted((a, b) => a.name.localeCompare(b.name));
 }
 
 export function processMethodLike(

scripts/apidocs/processing/method.ts

@@ -188,7 +188,7 @@ function processComplexParameter(
           });
         }
       })
-      .sort((a, b) => a.name.localeCompare(b.name));
+      .toSorted((a, b) => a.name.localeCompare(b.name));
   }
 
   return [];

scripts/apidocs/processing/parameter.ts

@@ -429,7 +429,7 @@ async function normalizeLocaleFile(filePath: string, definitionKey: string) {
           .slice(0, 1000)
           // sort entries alphabetically
           // We cannot sort the entries locale aware as the sort order is not stable within node versions #2905
-          .sort() as T
+          .toSorted() as T
       );
     }
 

scripts/generate-locales.ts

@@ -6,7 +6,7 @@ import { FakerError } from '../errors/faker-error';
  * @param date The date to convert.
  * @param name The reference name used for error messages. Defaults to `'refDate'`.
  *
- * @throws If the given date is invalid.
+ * @throws {FakerError} If the given date is invalid.
  */
 export function toDate(
   date: string | Date | number,