@croct/eslint-plugin 0.8.2 → 0.8.3

package/README.md

@@ -30,50 +30,86 @@ Webpack or Browserify:
 npm i -D @croct/eslint-plugin
 ```
 
-Then, add the following to your `.eslintrc.js` file:
+This plugin uses ESLint's [flat config format](https://eslint.org/docs/latest/use/configure/configuration-files) (ESLint v9+).
+
+### JavaScript
+
+For JavaScript projects, create an `eslint.config.mjs` file:
 
 ```js
-// Workaround for https://github.com/eslint/eslint/issues/3458
-require("@rushstack/eslint-patch/modern-module-resolution");
+import { defineConfig } from 'eslint/config';
+import croct from '@croct/eslint-plugin';
 
-module.exports = {
-   "plugins": ["@croct"]
-}
+export default defineConfig(
+    croct.configs.javascript,
+);
 ```
 
-Note the `require` call at the top of the file. This is a workaround to avoid adding the transitive dependencies of 
-the plugin to the project, which is [currently not supported by the ESLint plugin system](https://github.com/eslint/eslint/issues/3458).
-
 ### TypeScript
 
-For TypeScript projects, you need first to install the TypeScript parser:
+For TypeScript projects, create an `eslint.config.mjs` file:
 
-```sh
-npm i -D @typescript-eslint/parser
+```js
+import { defineConfig } from 'eslint/config';
+import croct from '@croct/eslint-plugin';
+
+export default defineConfig(
+    croct.configs.typescript,
+);
+```
+
+The TypeScript config includes the JavaScript preset, so there's no need to include both.
+
+### React
+
+For React projects, create an `eslint.config.mjs` file:
+
+```js
+import { defineConfig } from 'eslint/config';
+import croct from '@croct/eslint-plugin';
+
+export default defineConfig(
+    croct.configs.react,
+);
 ```
 
-Then, add the following to your `.eslintrc.js` file:
+The React config includes the JavaScript preset, so there's no need to include both.
+
+### Cypress
+
+For Cypress projects, create an `eslint.config.mjs` file:
+
+```js
+import { defineConfig } from 'eslint/config';
+import croct from '@croct/eslint-plugin';
+
+export default defineConfig(
+    croct.configs.cypress,
+);
+```
+
+The Cypress config includes the JavaScript preset, so there's no need to include both.
+
+### Custom rules
+
+You can add custom rules or override existing ones:
 
 ```js
-// Workaround for https://github.com/eslint/eslint/issues/3458
-require("@rushstack/eslint-patch/modern-module-resolution");
-
-module.exports = {
-    "parser": "@typescript-eslint/parser",
-    "plugins": [
-      "@croct"
-    ],
-    "extends": [
-      "plugin:@croct/typescript"
-    ],
-    "parserOptions": {
-      "extends": "./tsconfig.json",
-      "project": ["./tsconfig.json"]
+import { defineConfig } from 'eslint/config';
+import croct from '@croct/eslint-plugin';
+
+export default defineConfig(
+    croct.configs.typescript,
+    {
+        files: ['src/**/*.ts'],
+        rules: {
+            '@typescript-eslint/explicit-function-return-type': 'off',
+        },
     },
-}
+);
 ```
 
-For the list for available presets and rules, see the [reference documentation](docs/README.md). 
+For the list of available presets and rules, see the [reference documentation](docs/README.md). 
 
 ## Basic usage
 

package/configs/typescript.js

@@ -75,6 +75,7 @@ const baseRules = {
     'no-undef': 'off',
     '@typescript-eslint/no-namespace': 'off',
     '@typescript-eslint/restrict-template-expressions': 'off',
+    '@typescript-eslint/consistent-type-imports': 'error',
     // Disable rules that turn `any` into `unknown`, places where `unknown` is the preferred type
     // have that type already.
     '@typescript-eslint/no-unsafe-argument': 'off',
@@ -113,5 +114,13 @@ function createTypescriptConfig(plugin, javascriptConfig) {
             },
             rules: baseRules,
         },
+        {
+            name: '@croct/typescript-test-files',
+            files: ['**/*.test.ts', '**/*.test.tsx'],
+            rules: {
+                // Prevent false warnings when checking mocked interfaces
+                '@typescript-eslint/unbound-method': 'off',
+            },
+        },
     ];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@croct/eslint-plugin",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "ESLint rules and presets applied to all Croct JavaScript projects.",
   "license": "MIT",
   "author": {
@@ -53,7 +53,7 @@
     "typescript-eslint": "^8.53.0"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.14",
+    "@types/jest": "^30.0.0",
     "@types/semver": "^7.5.8",
     "@typescript-eslint/parser": "^8.53.0",
     "@typescript-eslint/rule-tester": "^8.53.0",
@@ -62,7 +62,7 @@
     "eslint": "^9.28.0",
     "eslint-plugin-eslint-plugin": "^6.4.0",
     "eslint-plugin-self": "^1.2.1",
-    "jest": "^29.7.0",
+    "jest": "^30.0.0",
     "ts-jest": "^29.3.4",
     "typescript": "~5.9.0"
   },