eslint-plugin-maintainability 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+All notable changes to `@interlace/eslint-plugin-maintainability` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Documentation
+
+- 📘 Launched new documentation site: [eslint.interlace.tools](https://eslint.interlace.tools/)
+- 📝 Achieved 100% documentation parity (both .md and .mdx files)
+
+## [1.0.0] - 2026-01-26
+
+### Added
+
+- Initial stable release with 12 maintainability rules
+- LLM-optimized error messages for AI-assisted development
+- 100% test coverage across all rules
+- ESLint 9 flat config support
+- TypeScript type definitions for all rule options
+
+### Rules
+
+#### Complexity Rules
+
+| Rule                        | Description                      |
+| :-------------------------- | :------------------------------- |
+| `max-cognitive-complexity`  | Limit cognitive complexity score |
+| `max-cyclomatic-complexity` | Limit cyclomatic complexity      |
+| `max-depth`                 | Limit nesting depth              |
+| `max-lines`                 | Limit file length                |
+| `max-lines-per-function`    | Limit function length            |
+| `max-params`                | Limit function parameters        |
+
+#### Code Smell Rules
+
+| Rule                       | Description                         |
+| :------------------------- | :---------------------------------- |
+| `no-magic-numbers`         | Disallow magic numbers              |
+| `no-nested-ternary`        | Disallow nested ternary expressions |
+| `no-deep-callback-nesting` | Disallow deeply nested callbacks    |
+| `no-long-parameter-list`   | Disallow long parameter lists       |
+
+#### Clean Code Rules
+
+| Rule                  | Description                                 |
+| :-------------------- | :------------------------------------------ |
+| `prefer-early-return` | Prefer early returns over nested conditions |
+| `no-duplicate-logic`  | Detect duplicated logic blocks (DRY)        |
+
+### Presets
+
+- `recommended` - Balanced maintainability thresholds
+
+### SOLID Principles Mapping
+
+Rules are annotated with SOLID principle alignment:
+
+- Single Responsibility: `max-lines-per-function`, `max-lines`
+- Open/Closed: `prefer-early-return`

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2025 Ofri Peretz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+

package/README.md

@@ -0,0 +1,116 @@
+<p align="center">
+  <a href="https://eslint.interlace.tools" target="blank"><img src="https://eslint.interlace.tools/eslint-interlace-logo-light.svg" alt="ESLint Interlace Logo" width="120" /></a>
+</p>
+
+<p align="center">
+  Code quality, maintainability standards, and cognitive complexity limits.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/eslint-plugin-maintainability" target="_blank"><img src="https://img.shields.io/npm/v/eslint-plugin-maintainability.svg" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/eslint-plugin-maintainability" target="_blank"><img src="https://img.shields.io/npm/dm/eslint-plugin-maintainability.svg" alt="NPM Downloads" /></a>
+  <a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="Package License" /></a>
+  <a href="https://app.codecov.io/gh/ofri-peretz/eslint/components?components%5B0%5D=quality" target="_blank"><img src="https://codecov.io/gh/ofri-peretz/eslint/graph/badge.svg?component=quality" alt="Codecov" /></a>
+  <a href="https://github.com/ofri-peretz/eslint" target="_blank"><img src="https://img.shields.io/badge/Since-Dec_2025-blue?logo=rocket&logoColor=white" alt="Since Dec 2025" /></a>
+</p>
+
+## Description
+
+This plugin elevates your codebase by enforcing high standards for code quality, maintainability, and cognitive complexity. It helps you identify and refactor complex logic that can lead to bugs and technical debt, promoting cleaner and more readable code. By integrating these checks, you ensure that your application remains scalable and easy to maintain for the long term.
+
+## Philosophy
+
+**Interlace** fosters **strength through integration**. Instead of stacking isolated rules, we **interlace** security directly into your workflow to create a resilient fabric of code. We believe tools should **guide rather than gatekeep**, providing educational feedback that strengthens the developer with every interaction.
+
+## Getting Started
+
+- To check out the [guide](https://eslint.interlace.tools/docs/quality), visit [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+- 要查看中文 [指南](https://eslint.interlace.tools/docs/quality), 请访问 [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+- [가이드](https://eslint.interlace.tools/docs/quality) 문서는 [eslint.interlace.tools](https://eslint.interlace.tools)에서 확인하실 수 있습니다. 📚
+- [ガイド](https://eslint.interlace.tools/docs/quality)は [eslint.interlace.tools](https://eslint.interlace.tools)でご確認ください。 📚
+- Para ver la [guía](https://eslint.interlace.tools/docs/quality), visita [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+- للاطلاع على [الدليل](https://eslint.interlace.tools/docs/quality)، قم بزيارة [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+
+```bash
+npm install eslint-plugin-maintainability --save-dev
+```
+
+## ⚙️ Configuration Presets
+
+| Preset        | Description                                |
+| :------------ | :----------------------------------------- |
+| `recommended` | Recommended code quality rules as warnings |
+
+## AI-Optimized Messages
+
+This plugin is optimized for ESLint's [Model Context Protocol (MCP)](https://eslint.org/docs/latest/use/mcp), enabling AI assistants like **Cursor**, **GitHub Copilot**, and **Claude** to:
+
+- Understand the exact vulnerability type via CWE references
+- Apply the correct fix using structured guidance
+- Provide educational context to developers
+
+```json
+// .cursor/mcp.json
+{
+  "mcpServers": {
+    "eslint": {
+      "command": "npx",
+      "args": ["@eslint/mcp@latest"]
+    }
+  }
+}
+```
+
+By providing this structured context (CWE, OWASP, Fix), we enable AI tools to **reason** about the security flaw rather than hallucinating. This allows Copilot/Cursor to suggest the _exact_ correct fix immediately.
+
+## Rules
+
+**Legend**
+
+| Icon | Description                                                        |
+| :--: | :----------------------------------------------------------------- |
+|  💼  | **Recommended**: Included in the recommended preset.               |
+|  ⚠️  | **Warns**: Set to warn in recommended preset.                      |
+|  🔧  | **Auto-fixable**: Automatically fixable by the `--fix` CLI option. |
+|  💡  | **Suggestions**: Providing code suggestions in IDE.                |
+|  🚫  | **Deprecated**: This rule is deprecated.                           |
+
+| Rule                                                                                                             | Pattern/Concept | Description                       | 💼  | ⚠️  | 🔧  | 💡  | 🚫  |
+| :--------------------------------------------------------------------------------------------------------------- | :-------------- | :-------------------------------- | :-: | :-: | :-: | :-: | :-: |
+| [`expiring-todo-comments`](https://eslint.interlace.tools/docs/quality/rules/expiring-todo-comments)             | Quality         | Enforce expiry for TODO comments  |     |     |     |     |     |
+| [`max-parameters`](https://eslint.interlace.tools/docs/quality/rules/max-parameters)                             | Complexity      | Limit function parameters         |     |     |     |     |     |
+| [`no-commented-code`](https://eslint.interlace.tools/docs/quality/rules/no-commented-code)                       | Quality         | Disallow commented code           | 💼  | ⚠️  |     |     |     |
+| [`no-lonely-if`](https://eslint.interlace.tools/docs/quality/rules/no-lonely-if)                                 | Quality         | Disallow lonely if statements     |     |     | 🔧  |     |     |
+| [`no-missing-null-checks`](https://eslint.interlace.tools/docs/quality/rules/no-missing-null-checks)             | Quality         | Enforce null checking             |     |     |     |     |     |
+| [`no-nested-ternary`](https://eslint.interlace.tools/docs/quality/rules/no-nested-ternary)                       | Complexity      | Disallow nested ternaries         |     |     |     |     |     |
+| [`no-unsafe-type-narrowing`](https://eslint.interlace.tools/docs/quality/rules/no-unsafe-type-narrowing)         | Type Safety     | Prevent unsafe type narrowing     |     |     |     |     |     |
+| [`prefer-code-point`](https://eslint.interlace.tools/docs/quality/rules/prefer-code-point)                       | Best Practice   | Prefer Code Point over Char Code  |     |     | 🔧  |     |     |
+| [`prefer-dom-node-text-content`](https://eslint.interlace.tools/docs/quality/rules/prefer-dom-node-text-content) | Quality         | Prefer textContent over innerText |     |     | 🔧  |     |     |
+| [`cognitive-complexity`](https://eslint.interlace.tools/docs/quality/rules/cognitive-complexity)                 | Complexity      | Limit cognitive complexity        | 💼  | ⚠️  |     |     |     |
+| [`nested-complexity-hotspots`](https://eslint.interlace.tools/docs/quality/rules/nested-complexity-hotspots)     | Complexity      | Detect nested complexity hotpots  |     |     |     |     |     |
+| [`error-message`](https://eslint.interlace.tools/docs/quality/rules/error-message)                               | Error Handling  | Enforce error message conventions |     |     |     |     |     |
+| [`no-missing-error-context`](https://eslint.interlace.tools/docs/quality/rules/no-missing-error-context)         | Error Handling  | Ensure errors have context        |     |     |     |     |     |
+| [`no-silent-errors`](https://eslint.interlace.tools/docs/quality/rules/no-silent-errors)                         | Error Handling  | Disallow silent error swallowing  | 💼  | ⚠️  |     |     |     |
+| [`no-unhandled-promise`](https://eslint.interlace.tools/docs/quality/rules/no-unhandled-promise)                 | Error Handling  | Ensure all promises are handled   |     |     |     |     |     |
+
+Part of the **Interlace ESLint Ecosystem** — AI-native security plugins with LLM-optimized error messages:
+
+| Plugin                                                                                           |                                                                            Downloads                                                                             | Description                                 |
+| :----------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------ |
+| [`eslint-plugin-secure-coding`](https://www.npmjs.com/package/eslint-plugin-secure-coding)       |    [![downloads](https://img.shields.io/npm/dt/eslint-plugin-secure-coding.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-secure-coding)    | General security rules & OWASP guidelines.  |
+| [`eslint-plugin-pg`](https://www.npmjs.com/package/eslint-plugin-pg)                             |               [![downloads](https://img.shields.io/npm/dt/eslint-plugin-pg.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-pg)               | PostgreSQL security & best practices.       |
+| [`eslint-plugin-crypto`](https://www.npmjs.com/package/eslint-plugin-crypto)                     |           [![downloads](https://img.shields.io/npm/dt/eslint-plugin-crypto.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-crypto)           | NodeJS Cryptography security rules.         |
+| [`eslint-plugin-jwt`](https://www.npmjs.com/package/eslint-plugin-jwt)                           |              [![downloads](https://img.shields.io/npm/dt/eslint-plugin-jwt.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-jwt)              | JWT security & best practices.              |
+| [`eslint-plugin-browser-security`](https://www.npmjs.com/package/eslint-plugin-browser-security) | [![downloads](https://img.shields.io/npm/dt/eslint-plugin-browser-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-browser-security) | Browser-specific security & XSS prevention. |
+| [`eslint-plugin-express-security`](https://www.npmjs.com/package/eslint-plugin-express-security) | [![downloads](https://img.shields.io/npm/dt/eslint-plugin-express-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-express-security) | Express.js security hardening rules.        |
+| [`eslint-plugin-lambda-security`](https://www.npmjs.com/package/eslint-plugin-lambda-security)   |  [![downloads](https://img.shields.io/npm/dt/eslint-plugin-lambda-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-lambda-security)  | AWS Lambda security best practices.         |
+| [`eslint-plugin-nestjs-security`](https://www.npmjs.com/package/eslint-plugin-nestjs-security)   |  [![downloads](https://img.shields.io/npm/dt/eslint-plugin-nestjs-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-nestjs-security)  | NestJS security rules & patterns.           |
+| [`eslint-plugin-import-next`](https://www.npmjs.com/package/eslint-plugin-import-next)           |      [![downloads](https://img.shields.io/npm/dt/eslint-plugin-import-next.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-import-next)      | Next-gen import sorting & architecture.     |
+
+## 📄 License
+
+MIT © [Ofri Peretz](https://github.com/ofri-peretz)
+
+<p align="center">
+  <a href="https://eslint.interlace.tools/docs/quality"><img src="https://eslint.interlace.tools/images/og-quality.png" alt="ESLint Interlace Plugin" width="300" /></a>
+</p>

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "eslint-plugin-maintainability",
+  "version": "3.0.0",
+  "description": "ESLint rules for reducing cognitive load and ensuring code readability.",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./types": {
+      "types": "./src/types/index.d.ts",
+      "default": "./src/types/index.js"
+    }
+  },
+  "author": "Ofri Peretz <ofriperetzdev@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "eslint",
+    "eslint-plugin",
+    "interlace-quality",
+    "code-quality",
+    "clean-code",
+    "maintainability",
+    "llm-optimized"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {},
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0",
+    "@interlace/eslint-devkit": "*"
+  },
+  "devDependencies": {
+    "@typescript-eslint/parser": "^8.46.2",
+    "@typescript-eslint/rule-tester": "^8.46.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ofri-peretz/eslint",
+    "directory": "packages/eslint-plugin-maintainability"
+  },
+  "homepage": "https://github.com/ofri-peretz/eslint/tree/main/packages/eslint-plugin-maintainability#readme",
+  "bugs": {
+    "url": "https://github.com/ofri-peretz/eslint/issues"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+export declare const rules: {
+    'cognitive-complexity': TSESLint.RuleModule<"highCognitiveComplexity" | "extractMethod" | "simplifyLogic" | "useStrategy", [(import("./rules/maintainability/cognitive-complexity").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'nested-complexity-hotspots': TSESLint.RuleModule<"extractMethod" | "nestedComplexity" | "useEarlyReturn" | "useGuardClauses", [(import("./rules/maintainability/nested-complexity-hotspots").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'identical-functions': TSESLint.RuleModule<"identicalFunctions" | "extractGeneric" | "useHigherOrder" | "applyInheritance", [(import("./rules/maintainability/identical-functions").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'max-parameters': TSESLint.RuleModule<"tooManyParameters" | "useObjectParameter" | "extractToClass" | "splitFunction", [(import("./rules/maintainability/max-parameters").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'no-lonely-if': TSESLint.RuleModule<"noLonelyIf", [(import("./rules/maintainability/no-lonely-if").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'no-nested-ternary': TSESLint.RuleModule<"noNestedTernary", [(import("./rules/maintainability/no-nested-ternary").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'consistent-function-scoping': TSESLint.RuleModule<"inconsistentFunctionScoping" | "moveToModuleScope", [(import("./rules/maintainability/consistent-function-scoping").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'no-unreadable-iife': TSESLint.RuleModule<"unreadableIIFE" | "suggestNamedFunction" | "suggestBlockScope" | "complexIIFE", [(import("./rules/maintainability/no-unreadable-iife").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'maintainability/cognitive-complexity': TSESLint.RuleModule<"highCognitiveComplexity" | "extractMethod" | "simplifyLogic" | "useStrategy", [(import("./rules/maintainability/cognitive-complexity").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'maintainability/nested-complexity-hotspots': TSESLint.RuleModule<"extractMethod" | "nestedComplexity" | "useEarlyReturn" | "useGuardClauses", [(import("./rules/maintainability/nested-complexity-hotspots").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'maintainability/identical-functions': TSESLint.RuleModule<"identicalFunctions" | "extractGeneric" | "useHigherOrder" | "applyInheritance", [(import("./rules/maintainability/identical-functions").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'maintainability/max-parameters': TSESLint.RuleModule<"tooManyParameters" | "useObjectParameter" | "extractToClass" | "splitFunction", [(import("./rules/maintainability/max-parameters").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'maintainability/no-lonely-if': TSESLint.RuleModule<"noLonelyIf", [(import("./rules/maintainability/no-lonely-if").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'maintainability/no-nested-ternary': TSESLint.RuleModule<"noNestedTernary", [(import("./rules/maintainability/no-nested-ternary").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'maintainability/consistent-function-scoping': TSESLint.RuleModule<"inconsistentFunctionScoping" | "moveToModuleScope", [(import("./rules/maintainability/consistent-function-scoping").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'maintainability/no-unreadable-iife': TSESLint.RuleModule<"unreadableIIFE" | "suggestNamedFunction" | "suggestBlockScope" | "complexIIFE", [(import("./rules/maintainability/no-unreadable-iife").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+};
+export declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: {
+        'cognitive-complexity': TSESLint.RuleModule<"highCognitiveComplexity" | "extractMethod" | "simplifyLogic" | "useStrategy", [(import("./rules/maintainability/cognitive-complexity").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'nested-complexity-hotspots': TSESLint.RuleModule<"extractMethod" | "nestedComplexity" | "useEarlyReturn" | "useGuardClauses", [(import("./rules/maintainability/nested-complexity-hotspots").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'identical-functions': TSESLint.RuleModule<"identicalFunctions" | "extractGeneric" | "useHigherOrder" | "applyInheritance", [(import("./rules/maintainability/identical-functions").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'max-parameters': TSESLint.RuleModule<"tooManyParameters" | "useObjectParameter" | "extractToClass" | "splitFunction", [(import("./rules/maintainability/max-parameters").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'no-lonely-if': TSESLint.RuleModule<"noLonelyIf", [(import("./rules/maintainability/no-lonely-if").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'no-nested-ternary': TSESLint.RuleModule<"noNestedTernary", [(import("./rules/maintainability/no-nested-ternary").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'consistent-function-scoping': TSESLint.RuleModule<"inconsistentFunctionScoping" | "moveToModuleScope", [(import("./rules/maintainability/consistent-function-scoping").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'no-unreadable-iife': TSESLint.RuleModule<"unreadableIIFE" | "suggestNamedFunction" | "suggestBlockScope" | "complexIIFE", [(import("./rules/maintainability/no-unreadable-iife").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'maintainability/cognitive-complexity': TSESLint.RuleModule<"highCognitiveComplexity" | "extractMethod" | "simplifyLogic" | "useStrategy", [(import("./rules/maintainability/cognitive-complexity").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'maintainability/nested-complexity-hotspots': TSESLint.RuleModule<"extractMethod" | "nestedComplexity" | "useEarlyReturn" | "useGuardClauses", [(import("./rules/maintainability/nested-complexity-hotspots").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'maintainability/identical-functions': TSESLint.RuleModule<"identicalFunctions" | "extractGeneric" | "useHigherOrder" | "applyInheritance", [(import("./rules/maintainability/identical-functions").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'maintainability/max-parameters': TSESLint.RuleModule<"tooManyParameters" | "useObjectParameter" | "extractToClass" | "splitFunction", [(import("./rules/maintainability/max-parameters").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'maintainability/no-lonely-if': TSESLint.RuleModule<"noLonelyIf", [(import("./rules/maintainability/no-lonely-if").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'maintainability/no-nested-ternary': TSESLint.RuleModule<"noNestedTernary", [(import("./rules/maintainability/no-nested-ternary").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'maintainability/consistent-function-scoping': TSESLint.RuleModule<"inconsistentFunctionScoping" | "moveToModuleScope", [(import("./rules/maintainability/consistent-function-scoping").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'maintainability/no-unreadable-iife': TSESLint.RuleModule<"unreadableIIFE" | "suggestNamedFunction" | "suggestBlockScope" | "complexIIFE", [(import("./rules/maintainability/no-unreadable-iife").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+    };
+};
+export declare const configs: {
+    recommended: {
+        plugins: {
+            '@interlace/maintainability': {
+                meta: {
+                    name: string;
+                    version: string;
+                };
+                rules: {
+                    'cognitive-complexity': TSESLint.RuleModule<"highCognitiveComplexity" | "extractMethod" | "simplifyLogic" | "useStrategy", [(import("./rules/maintainability/cognitive-complexity").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'nested-complexity-hotspots': TSESLint.RuleModule<"extractMethod" | "nestedComplexity" | "useEarlyReturn" | "useGuardClauses", [(import("./rules/maintainability/nested-complexity-hotspots").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'identical-functions': TSESLint.RuleModule<"identicalFunctions" | "extractGeneric" | "useHigherOrder" | "applyInheritance", [(import("./rules/maintainability/identical-functions").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'max-parameters': TSESLint.RuleModule<"tooManyParameters" | "useObjectParameter" | "extractToClass" | "splitFunction", [(import("./rules/maintainability/max-parameters").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'no-lonely-if': TSESLint.RuleModule<"noLonelyIf", [(import("./rules/maintainability/no-lonely-if").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'no-nested-ternary': TSESLint.RuleModule<"noNestedTernary", [(import("./rules/maintainability/no-nested-ternary").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'consistent-function-scoping': TSESLint.RuleModule<"inconsistentFunctionScoping" | "moveToModuleScope", [(import("./rules/maintainability/consistent-function-scoping").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'no-unreadable-iife': TSESLint.RuleModule<"unreadableIIFE" | "suggestNamedFunction" | "suggestBlockScope" | "complexIIFE", [(import("./rules/maintainability/no-unreadable-iife").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'maintainability/cognitive-complexity': TSESLint.RuleModule<"highCognitiveComplexity" | "extractMethod" | "simplifyLogic" | "useStrategy", [(import("./rules/maintainability/cognitive-complexity").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'maintainability/nested-complexity-hotspots': TSESLint.RuleModule<"extractMethod" | "nestedComplexity" | "useEarlyReturn" | "useGuardClauses", [(import("./rules/maintainability/nested-complexity-hotspots").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'maintainability/identical-functions': TSESLint.RuleModule<"identicalFunctions" | "extractGeneric" | "useHigherOrder" | "applyInheritance", [(import("./rules/maintainability/identical-functions").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'maintainability/max-parameters': TSESLint.RuleModule<"tooManyParameters" | "useObjectParameter" | "extractToClass" | "splitFunction", [(import("./rules/maintainability/max-parameters").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'maintainability/no-lonely-if': TSESLint.RuleModule<"noLonelyIf", [(import("./rules/maintainability/no-lonely-if").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'maintainability/no-nested-ternary': TSESLint.RuleModule<"noNestedTernary", [(import("./rules/maintainability/no-nested-ternary").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'maintainability/consistent-function-scoping': TSESLint.RuleModule<"inconsistentFunctionScoping" | "moveToModuleScope", [(import("./rules/maintainability/consistent-function-scoping").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'maintainability/no-unreadable-iife': TSESLint.RuleModule<"unreadableIIFE" | "suggestNamedFunction" | "suggestBlockScope" | "complexIIFE", [(import("./rules/maintainability/no-unreadable-iife").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                };
+            };
+        };
+        rules: {
+            '@interlace/maintainability/maintainability/cognitive-complexity': "warn";
+            '@interlace/maintainability/maintainability/identical-functions': "warn";
+            '@interlace/maintainability/maintainability/max-parameters': "warn";
+        };
+    };
+};
+export default plugin;

package/src/index.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configs = exports.plugin = exports.rules = void 0;
+// Maintainability rules
+const cognitive_complexity_1 = require("./rules/maintainability/cognitive-complexity");
+const nested_complexity_hotspots_1 = require("./rules/maintainability/nested-complexity-hotspots");
+const identical_functions_1 = require("./rules/maintainability/identical-functions");
+const max_parameters_1 = require("./rules/maintainability/max-parameters");
+const no_lonely_if_1 = require("./rules/maintainability/no-lonely-if");
+const no_nested_ternary_1 = require("./rules/maintainability/no-nested-ternary");
+const consistent_function_scoping_1 = require("./rules/maintainability/consistent-function-scoping");
+const no_unreadable_iife_1 = require("./rules/maintainability/no-unreadable-iife");
+exports.rules = {
+    'cognitive-complexity': cognitive_complexity_1.cognitiveComplexity,
+    'nested-complexity-hotspots': nested_complexity_hotspots_1.nestedComplexityHotspots,
+    'identical-functions': identical_functions_1.identicalFunctions,
+    'max-parameters': max_parameters_1.maxParameters,
+    'no-lonely-if': no_lonely_if_1.noLonelyIf,
+    'no-nested-ternary': no_nested_ternary_1.noNestedTernary,
+    'consistent-function-scoping': consistent_function_scoping_1.consistentFunctionScoping,
+    'no-unreadable-iife': no_unreadable_iife_1.noUnreadableIife,
+    // Categorized names
+    'maintainability/cognitive-complexity': cognitive_complexity_1.cognitiveComplexity,
+    'maintainability/nested-complexity-hotspots': nested_complexity_hotspots_1.nestedComplexityHotspots,
+    'maintainability/identical-functions': identical_functions_1.identicalFunctions,
+    'maintainability/max-parameters': max_parameters_1.maxParameters,
+    'maintainability/no-lonely-if': no_lonely_if_1.noLonelyIf,
+    'maintainability/no-nested-ternary': no_nested_ternary_1.noNestedTernary,
+    'maintainability/consistent-function-scoping': consistent_function_scoping_1.consistentFunctionScoping,
+    'maintainability/no-unreadable-iife': no_unreadable_iife_1.noUnreadableIife,
+};
+exports.plugin = {
+    meta: {
+        name: '@interlace/eslint-plugin-maintainability',
+        version: '1.0.0',
+    },
+    rules: exports.rules,
+};
+exports.configs = {
+    recommended: {
+        plugins: {
+            '@interlace/maintainability': exports.plugin,
+        },
+        rules: {
+            '@interlace/maintainability/maintainability/cognitive-complexity': 'warn',
+            '@interlace/maintainability/maintainability/identical-functions': 'warn',
+            '@interlace/maintainability/maintainability/max-parameters': 'warn',
+        },
+    },
+};
+exports.default = exports.plugin;

package/src/rules/error-handling/error-message.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+/**
+ * ESLint Rule: error-message
+ * Enforces providing a message when creating built-in Error objects
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+type MessageIds = 'missingErrorMessage' | 'addErrorMessage';
+export interface Options {
+    /** Allow Error() without message (not recommended) */
+    allowEmptyCatch?: boolean;
+}
+type RuleOptions = [Options?];
+export declare const errorMessage: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
+    name: string;
+};
+export {};