@dartess/eslint-plugin 0.0.9 → 0.2.0

package/CHANGELOG.md

@@ -2,11 +2,21 @@
 
 [//]: # (https://keepachangelog.com/en/1.1.0/)
 
+## [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
+
 ## [0.0.9] - 2026-01-02
 
 - remove overriding `@typescript-eslint/return-await` rule
 - cleanup disabled rules
-- add `prefer-object-has-own` to `recomended`: previously was disabled because of old browsers support
+- add `prefer-object-has-own` to `recommended`: previously was disabled because of old browsers support
 - apply `no-throw-literal` only for `js`-files (for `ts` files already enabled `@typescript-eslint/only-throw-error`)
 
 ## [0.0.8] - 2025-12-28

package/README.md

@@ -7,6 +7,7 @@ Also extends
 * `typescript-eslint` — `strictTypeChecked` & `stylisticTypeChecked`
 * `eslint-plugin-import-x` — `recommended` & `typescript`
 * `@eslint-community/eslint-plugin-eslint-comments` — `recommended`
+* `eslint-plugin-de-morgan` — `recommended`
 
 Also can extends (if it is applicable)
 * `eslint-plugin-react` — `recommended` & `jsx-runtime`
@@ -32,7 +33,7 @@ All of it pinched with extra configs, setups and extra rules. Just take it and u
 You'll first need to install [ESLint](https://eslint.org/) and peer deps:
 
 ```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
+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
 ```
 
 Next, also install the packages that suit your needs.
@@ -127,8 +128,8 @@ Use `eslint-plugin-oxlint` for disabling unnecessary rules.
 #### Prettier (Old School)
 
 * Use `eslint-config-prettier` for disabling unnecessary rules.
-* Use `eslint-plugin-prettier` for running `prettier` as eslint rule.
-* 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).
+* 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).
 
 ## Supported Rules
 
@@ -147,6 +148,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/recommended.js

@@ -9,6 +9,7 @@ import pluginJs from '@eslint/js';
 import eslintCommentsPlugin from '@eslint-community/eslint-plugin-eslint-comments/configs';
 // @ts-ignore: https://github.com/NullVoxPopuli/eslint-plugin-decorator-position/issues/778
 import eslintPluginDecoratorPosition from 'eslint-plugin-decorator-position';
+import eslintPluginDeMorgan from 'eslint-plugin-de-morgan';
 import dartessPlugin from "../index.js";
 import vendorRulesBestPractices from "./vendor-rules/best-practices.js";
 import vendorRulesErrors from "./vendor-rules/errors.js";
@@ -44,6 +45,7 @@ const config = [
     eslintPluginImportX.flatConfigs.recommended,
     eslintPluginImportX.flatConfigs.typescript,
     eslintCommentsPlugin.recommended,
+    eslintPluginDeMorgan.configs.recommended,
     {
         name: '@dartess/recommended',
         plugins: {
@@ -220,6 +222,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.0.9",
+  "version": "0.2.0",
   "description": "A set of rules and configs for various TypeScript projects",
   "keywords": [
     "eslint",
@@ -50,6 +50,7 @@
     "@next/eslint-plugin-next": "^16.0.0",
     "eslint": "^9.0.0",
     "eslint-import-resolver-typescript": "^4.0.0",
+    "eslint-plugin-de-morgan": "^2.0.0",
     "eslint-plugin-decorator-position": "^6.0.0",
     "eslint-plugin-import-x": "^4.1.0",
     "eslint-plugin-jsx-a11y": "^6.10.0",