@dartess/eslint-plugin 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 [//]: # (https://keepachangelog.com/en/1.1.0/)
 
+## [0.3.0] - 2026-01-12
+
+- add `eslint-plugin-react-hooks:recommended` config to `react` config
+
+## [0.2.1] - 2026-01-10
+
+- add `recommended-post-format` config for using after formatting tools
+
 ## [0.2.0] - 2026-01-05
 
 - improve `import-x/no-extraneous-dependencies` options

package/README.md

@@ -11,13 +11,12 @@ Also extends
 
 Also can extends (if it is applicable)
 * `eslint-plugin-react` — `recommended` & `jsx-runtime`
+* `eslint-plugin-react-hooks` — `recommended`
 * `@next/eslint-plugin-next` — `recommended` & `core-web-vitals`
 * `eslint-config-next`
 * `eslint-plugin-mobx` — `recommended`
 * `eslint-plugin-storybook` — `recommended` & `csf-strict`
 
-_(We also use `eslint-plugin-unicorn` and `eslint-plugin-decorator-position` but only special rules, without `recommended` config)_
-
 All of it pinched with extra configs, setups and extra rules. Just take it and use it!
 
 ### Notes
@@ -30,10 +29,18 @@ All of it pinched with extra configs, setups and extra rules. Just take it and u
 
 ## Installation
 
-You'll first need to install [ESLint](https://eslint.org/) and peer deps:
+Install [ESLint](https://eslint.org/), required peer deps and the plugin itself:
 
 ```sh
-npm i -D eslint eslint-plugin-import-x eslint-import-resolver-typescript @eslint-community/eslint-plugin-eslint-comments typescript-eslint eslint-plugin-unicorn eslint-plugin-decorator-position eslint-plugin-de-morgan
+npm i -D eslint \
+  eslint-plugin-import-x \
+  eslint-import-resolver-typescript \
+  eslint-plugin-unicorn \
+  eslint-plugin-decorator-position \
+  eslint-plugin-de-morgan \
+  typescript-eslint \
+  @eslint-community/eslint-plugin-eslint-comments \
+  @dartess/eslint-plugin
 ```
 
 Next, also install the packages that suit your needs.
@@ -51,12 +58,6 @@ npm i -D eslint-plugin-mobx
 npm i -D eslint-plugin-storybook
 ```
 
-Next, install `@dartess/eslint-plugin` itself.
-
-```sh
-npm i -D @dartess/eslint-plugin
-```
-
 ## Usage configs
 
 Shared config based on `eslint-config-airbnb`, `eslint-config-airbnb-typescript`, `eslint-plugin-react/recommended`, `eslint-plugin-react/jsx-runtime`.
@@ -65,6 +66,7 @@ Edit or create `eslint.config.ts` (or `eslint.config.mts`). You probably have to
 
 ```ts
 import dartessEslintPluginRecommended from '@dartess/eslint-plugin/recommended';
+import dartessEslintPluginRecommendedPostFormat from '@dartess/eslint-plugin/recommended-post-format';
 
 // if `react` is used
 import dartessEslintPluginReact from '@dartess/eslint-plugin/react';
@@ -89,6 +91,7 @@ export default [
   },
   
   ...dartessEslintPluginRecommended,
+  
   // if `react` is used
   ...dartessEslintPluginReact,
   // if `next.js` is used
@@ -97,21 +100,26 @@ export default [
   ...dartessEslintPluginMobx,
   // if `storybook` is used
   ...dartessEslintPluginStorybook,
+  
+  // <-- Put here your formatters congifs -->
+  // @see `Fine Tuning` -> `Formatters` section below 
+  
+  ...dartessEslintPluginRecommendedPostFormat,
 ]
 
 ```
 
-## Next steps
+## Fine Tuning
 
-If you're using React, you also probably will want to add 
-[eslint-plugin-react-refresh](https://www.npmjs.com/package/eslint-plugin-react-refresh). 
-This plugin requires manual setup for you build tools.
+### Formatting tools
 
-If you're using Mobx with legacy decorators, you have to enable rule `mobx/missing-make-observable` manually.
+If you're want to (and you should to) use formatting tools, you need to additionally install and setup something else.
 
-### Formatters
+Replace the `<-- Put here your formatters congifs -->` comment with the required code, beacuse we have a special config
+that fine-tunes formatter behavior and should be applied afterward.
 
-If you're want to (and you should to) use formatting tools, you need to additionally install and setup something else.
+In case you for some reason don't want to use any formatting tools, you still have to put 
+`...dartessEslintPluginRecommendedPostFormat` in any place of your config.
 
 #### dprint
 
@@ -131,6 +139,16 @@ Use `eslint-plugin-oxlint` for disabling unnecessary rules.
 * Or use `eslint-plugin-prettier` for running `prettier` as eslint rule.
 * Or use `eslint-plugin-format` with rule `format/prettier` for running `prettier` as eslint rule (you probably will want to add `eslint-config-prettier` for disabling unnecessary rules).
 
+### (for React users)
+
+If you're using React, you also probably will want to add 
+[eslint-plugin-react-refresh](https://www.npmjs.com/package/eslint-plugin-react-refresh). 
+This plugin requires manual setup for you build tools.
+
+### (for Mobx users)
+
+If you're using Mobx with legacy decorators, you have to enable rule `mobx/missing-make-observable` manually.
+
 ## Supported Rules
 
 Each rule has emojis denoting:

package/dist/configs/post-format.d.ts

@@ -0,0 +1,3 @@
+import type { TSESLint } from '@typescript-eslint/utils';
+declare const config: Array<TSESLint.FlatConfig.Config>;
+export default config;

package/dist/configs/post-format.js

@@ -0,0 +1,9 @@
+const config = [
+    {
+        name: '@dartess/recommended-post-format',
+        rules: {
+            curly: ['error', 'all'],
+        },
+    },
+];
+export default config;

package/dist/configs/react.js

@@ -5,7 +5,6 @@ import reactPlugin from 'eslint-plugin-react';
 import reactHooksPlugin from 'eslint-plugin-react-hooks';
 import jsxA11yPlugin from 'eslint-plugin-jsx-a11y';
 import vendorRulesReact from "./vendor-rules/react.js";
-import vendorRulesReactHooks from "./vendor-rules/react-hooks.js";
 const config = [
     {
         name: '@dartess/react-setup',
@@ -19,6 +18,7 @@ const config = [
             },
         },
     },
+    reactHooksPlugin.configs.flat.recommended,
     {
         name: 'react/recommended', // missed name, @see e.g. https://github.com/jsx-eslint/eslint-plugin-react/pull/3882
         ...reactPlugin.configs.flat.recommended,
@@ -71,11 +71,5 @@ const config = [
             'react/jsx-no-undef': 'off', // checked by typescript
         },
     },
-    {
-        name: '@dartess/react-hooks',
-        rules: {
-            ...vendorRulesReactHooks,
-        },
-    },
 ];
 export default config;

package/dist/configs/recommended.js

@@ -85,7 +85,6 @@ const config = [
             'unicorn/no-useless-undefined': 'error',
             'unicorn/prefer-node-protocol': 'error',
             '@dartess/max-parent-import-depth': 'error',
-            curly: ['error', 'all'],
             'import-x/order': [
                 'error',
                 {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dartess/eslint-plugin",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A set of rules and configs for various TypeScript projects",
   "keywords": [
     "eslint",
@@ -16,6 +16,7 @@
   "exports": {
     ".": "./dist/index.js",
     "./recommended": "./dist/configs/recommended.js",
+    "./recommended-post-format": "./dist/configs/post-format.js",
     "./react": "./dist/configs/react.js",
     "./next": "./dist/configs/next.js",
     "./mobx": "./dist/configs/mobx.js",

package/dist/configs/vendor-rules/react-hooks.d.ts

@@ -1,10 +0,0 @@
-declare const rules: {
-    /**
-     * react-hooks
-     * copied from
-     * https://github.com/airbnb/javascript/blob/c25bce83be4db06e6a221d79686c485cd2ed5d5d/packages/eslint-config-airbnb/rules/react-hooks.js
-     * */
-    'react-hooks/rules-of-hooks': "error";
-    'react-hooks/exhaustive-deps': "error";
-};
-export default rules;

package/dist/configs/vendor-rules/react-hooks.js

@@ -1,17 +0,0 @@
-// This file contains code from the `eslint-config-airbnb` project
-// Original author: Jake Teton-Landis (https://twitter.com/@jitl)
-// License: MIT (see LICENSE-eslint-config-airbnb.md file)
-const rules = {
-    /**
-     * react-hooks
-     * copied from
-     * https://github.com/airbnb/javascript/blob/c25bce83be4db06e6a221d79686c485cd2ed5d5d/packages/eslint-config-airbnb/rules/react-hooks.js
-     * */
-    // Enforce Rules of Hooks
-    // https://github.com/facebook/react/blob/c11015ff4f610ac2924d1fc6d569a17657a404fd/packages/eslint-plugin-react-hooks/src/RulesOfHooks.js
-    'react-hooks/rules-of-hooks': 'error',
-    // Verify the list of the dependencies for Hooks like useEffect and similar
-    // https://github.com/facebook/react/blob/1204c789776cb01fbaf3e9f032e7e2ba85a44137/packages/eslint-plugin-react-hooks/src/ExhaustiveDeps.js
-    'react-hooks/exhaustive-deps': 'error',
-};
-export default rules;