@dartess/eslint-plugin 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 [//]: # (https://keepachangelog.com/en/1.1.0/)
 
+## [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
+- add rule `@dartess/ts-named-tuple-elements`
+- add `@dartess/ts-named-tuple-elements` to `recommended` config
+
 ## [0.1.0] - 2026-01-02
 
 - add `eslint-plugin-de-morgan` to `recommended` config

package/README.md

@@ -30,10 +30,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 +59,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 +67,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 +92,7 @@ export default [
   },
   
   ...dartessEslintPluginRecommended,
+  
   // if `react` is used
   ...dartessEslintPluginReact,
   // if `next.js` is used
@@ -97,21 +101,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 +140,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:
@@ -148,6 +167,7 @@ Each rule has emojis denoting:
 | [stories-export-meta](docs/rules/stories-export-meta.md)                                                   | Storybook's Meta should be typed                                              | ✅ |    |    |
 | [stories-export-typed](docs/rules/stories-export-typed.md)                                                 | Storybook's Stories should be typed                                           | ✅ |    |    |
 | [max-parent-import-depth](docs/rules/max-parent-import-depth.md)                                           | Limit relative imports to a maximum parent depth.                             | ✅ |    |    |
+| [ts-named-tuple-elements](docs/rules/ts-named-tuple-elements.md)                                           | Enforce (or forbid) named tuple elements                                      | ✅ |    |    |
 
 ## Code Reuse Policy
 

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/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',
                 {
@@ -222,6 +221,8 @@ const config = [
                     disallowTypeAnnotations: false,
                 },
             ],
+            // require names for tuple elements
+            '@dartess/ts-named-tuple-elements': 'error',
         },
     },
     {

package/dist/configs/vendor-rules/imports.js

@@ -26,25 +26,20 @@ const rules = {
                 'test/**', // tape, common npm pattern
                 'tests/**', // also common npm pattern
                 'spec/**', // mocha, rspec-like pattern
+                'scripts/**', // custom infra scripts
                 '**/__tests__/**', // jest pattern
                 '**/__mocks__/**', // jest pattern
                 'test.{js,jsx}', // repos with a single test file
                 'test-*.{js,jsx}', // repos with multiple top-level test files
                 '**/*{.,_}{test,spec}.{js,jsx}', // tests where the extension or filename suffix denotes that it is a test
-                '**/jest.config.js', // jest config
                 '**/jest.setup.js', // jest setup
-                '**/vue.config.js', // vue-cli config
-                '**/webpack.config.js', // webpack config
-                '**/webpack.config.*.js', // webpack config
-                '**/rollup.config.js', // rollup config
-                '**/rollup.config.*.js', // rollup config
                 '**/gulpfile.js', // gulp config
                 '**/gulpfile.*.js', // gulp config
                 '**/Gruntfile{,.js}', // grunt config
-                '**/protractor.conf.js', // protractor config
-                '**/protractor.conf.*.js', // protractor config
-                '**/karma.conf.js', // karma config
                 '**/.eslintrc.js', // eslint config
+                '**/*.conf{,ig}.js', // any configs
+                '**/*.conf{,ig}.*.js', // any configs
+                '**/*.stories.jsx', // storybook stories
             ],
             optionalDependencies: false,
         },

package/dist/index.js

@@ -6,6 +6,7 @@ import ruleStoriesExportTyped from "./rules/stories-export-typed.js";
 import ruleStrictObservableComponentsDeclaration from "./rules/strict-observable-components-declaration.js";
 import ruleRequireObserver from "./rules/require-observer.js";
 import ruleMaxParentImportDepth from "./rules/max-parent-import-depth.js";
+import ruleTsNamedTupleElements from "./rules/ts-named-tuple-elements.js";
 const plugin = {
     meta: {
         name: packageJson.name,
@@ -20,6 +21,7 @@ const plugin = {
         'strict-observable-components-declaration': ruleStrictObservableComponentsDeclaration,
         'require-observer': ruleRequireObserver,
         'max-parent-import-depth': ruleMaxParentImportDepth,
+        'ts-named-tuple-elements': ruleTsNamedTupleElements,
     },
 };
 export default plugin;

package/dist/rules/jsx-text-as-child.d.ts

@@ -1,6 +1,6 @@
 import { ESLintUtils } from '@typescript-eslint/utils';
 type Options = [
-    {
+    mainOptions: {
         allowDigits?: boolean;
         allowEmoji?: boolean;
         allowSpecialSymbols?: boolean;

package/dist/rules/prevent-mixing-external-and-internal-classes.d.ts

@@ -4,7 +4,7 @@ import { ESLintUtils } from '@typescript-eslint/utils';
  * @author Sergey Kozlov
  */
 type Options = [
-    {
+    mainOptions: {
         libName?: string;
     }
 ];

package/dist/rules/strict-observable-components-declaration.d.ts

@@ -4,7 +4,7 @@ import { ESLintUtils } from '@typescript-eslint/utils';
  * @author Sergey Kozlov
  */
 type Options = [
-    {
+    mainOptions: {
         ignoreObserverArg?: Array<string>;
         allowedHocs?: Array<string>;
     }

package/dist/rules/ts-named-tuple-elements.d.ts

@@ -0,0 +1,13 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+/**
+ * @fileoverview Enforce (or forbid) named tuple elements
+ * @author Sergey Kozlov
+ */
+type Options = [
+    mainOptions: {
+        mode?: 'always' | 'never';
+    }
+];
+type MessageIds = 'requireNames' | 'forbidNames';
+declare const _default: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener>;
+export default _default;

package/dist/rules/ts-named-tuple-elements.js

@@ -0,0 +1,47 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export default ESLintUtils.RuleCreator(() => '')({
+    name: 'ts-named-tuple-elements',
+    defaultOptions: [{ mode: 'always' }],
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Enforces consistent usage of named elements in TypeScript tuple types.',
+        },
+        messages: {
+            requireNames: 'Tuple elements must have names.',
+            forbidNames: 'Tuple elements must not have names.',
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    mode: {
+                        type: 'string',
+                        enum: ['always', 'never'],
+                        default: 'always',
+                    },
+                },
+            },
+        ],
+    },
+    create(context) {
+        const [options] = context.options;
+        const { mode = 'always' } = options ?? {};
+        switch (mode) {
+            case 'always':
+                return {
+                    'TSTupleType > :not(TSNamedTupleMember)': node => {
+                        context.report({ node, messageId: 'requireNames' });
+                    },
+                };
+            case 'never':
+                return {
+                    'TSTupleType > TSNamedTupleMember': node => {
+                        context.report({ node, messageId: 'forbidNames' });
+                    },
+                };
+            default:
+                throw new Error(`Invalig mode value: ${String(mode)}`);
+        }
+    },
+});

package/docs/rules/ts-named-tuple-elements.md

@@ -0,0 +1,36 @@
+# Enforce (or forbid) named tuple elements (ts-named-tuple-elements)
+
+Enforces consistent usage of named elements in TypeScript tuple types.  
+This rule helps improve readability, self-documentation, and maintainability of tuple types
+by explicitly naming their elements instead of relying on positional meaning.
+
+## Rule Details
+
+Examples of **incorrect** code for this rule:
+
+```ts
+type Location = [number, number]
+```
+
+Examples of **correct** code for this rule:
+
+```ts
+type Location = [lat: number, long: number]
+```
+
+## Options
+
+`mode`: `always` (by default) or `never`
+
+```json
+{
+  "@dartess/ts-named-tuple-elements": [
+    "error",
+    {
+      "mode": "never"
+    }
+  ]
+}
+```
+
+When mode is "never", tuple elements should not have names.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dartess/eslint-plugin",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "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",