eslint-plugin-maintainability 3.0.8 → 3.0.10

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

@@ -1,20 +0,0 @@
-/**
- * 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 {};

package/src/rules/error-handling/no-missing-error-context.d.ts

@@ -1,26 +0,0 @@
-/**
- * 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: no-missing-error-context
- * Detects thrown errors without context
- *
- * @see https://rules.sonarsource.com/javascript/RSPEC-1128/
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-type MessageIds = 'missingErrorContext' | 'addErrorMessage' | 'addErrorStack' | 'useErrorClass';
-export interface Options {
-    /** Require error message. Default: true */
-    requireMessage?: boolean;
-    /** Require stack trace. Default: false */
-    requireStackTrace?: boolean;
-    /** Ignore in test files. Default: true */
-    ignoreInTests?: boolean;
-}
-type RuleOptions = [Options?];
-export declare const noMissingErrorContext: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/error-handling/no-silent-errors.d.ts

@@ -1,24 +0,0 @@
-/**
- * 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: no-silent-errors
- * Detects empty catch blocks
- *
- * @see https://rules.sonarsource.com/javascript/RSPEC-1186/
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-type MessageIds = 'silentError' | 'addErrorLogging' | 'addErrorHandling' | 'rethrowError';
-export interface Options {
-    /** Allow empty catch if comment explains why. Default: false */
-    allowWithComment?: boolean;
-    /** Ignore in test files. Default: true */
-    ignoreInTests?: boolean;
-}
-type RuleOptions = [Options?];
-export declare const noSilentErrors: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/error-handling/no-unhandled-promise.d.ts

@@ -1,41 +0,0 @@
-/**
- * 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: no-unhandled-promise
- * Detects unhandled Promise rejections
- * CWE-1024: Comparison of Classes by Name
- *
- * @see https://cwe.mitre.org/data/definitions/1024.html
- * @see https://rules.sonarsource.com/javascript/RSPEC-4635/
- */
-import type { TSESLint, TSESTree } from '@interlace/eslint-devkit';
-type MessageIds = 'unhandledPromise' | 'addCatch' | 'useTryCatch' | 'useAwait';
-export interface Options {
-    /** Ignore promises in test files. Default: true */
-    ignoreInTests?: boolean;
-    /** Ignore promises in void expressions. Default: false */
-    ignoreVoidExpressions?: boolean;
-}
-type RuleOptions = [Options?];
-/**
- * Check if a node is a Promise-like expression
- * For now, we check all CallExpressions since we can't statically determine
- * which functions return promises. The isPromiseHandled function will filter out
- * non-promise calls that are inside handled promise chains.
- */
-export declare function isPromiseExpression(node: TSESTree.Node): boolean;
-/**
- * Check if a CallExpression is inside a promise chain callback
- */
-export declare function isInsidePromiseCallback(node: TSESTree.CallExpression): boolean;
-/**
- * Check if promise is handled (has .catch, .then, or is in try/catch)
- */
-export declare function isPromiseHandled(node: TSESTree.Node): boolean;
-export declare const noUnhandledPromise: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/maintainability/cognitive-complexity.d.ts

@@ -1,28 +0,0 @@
-/**
- * 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: cognitive-complexity
- * Detects high cognitive complexity with refactoring suggestions
- * Inspired by SonarQube RSPEC-3776
- *
- * @see https://rules.sonarsource.com/javascript/RSPEC-3776/
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-/**
- * Message IDs for cognitive complexity violations and suggestions
- */
-type MessageIds = 'highCognitiveComplexity' | 'extractMethod' | 'simplifyLogic' | 'useStrategy';
-export interface Options {
-    /** Maximum allowed cognitive complexity score. Default: 15 */
-    maxComplexity?: number;
-    /** Include complexity metrics in error message. Default: false */
-    includeMetrics?: boolean;
-}
-type RuleOptions = [Options?];
-export declare const cognitiveComplexity: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/maintainability/consistent-function-scoping.d.ts

@@ -1,20 +0,0 @@
-/**
- * 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: consistent-function-scoping
- * Disallow functions that are declared in a scope which does not capture any variables from the outer scope
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-type MessageIds = 'inconsistentFunctionScoping' | 'moveToModuleScope';
-export interface Options {
-    /** Check arrow functions for scoping issues */
-    checkArrowFunctions?: boolean;
-}
-type RuleOptions = [Options?];
-export declare const consistentFunctionScoping: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/maintainability/identical-functions.d.ts

@@ -1,33 +0,0 @@
-/**
- * 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: identical-functions
- * Detects functions with identical implementations and suggests DRY refactoring
- * Inspired by SonarQube RSPEC-4144
- *
- * @see https://rules.sonarsource.com/javascript/RSPEC-4144/
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-type MessageIds = 'identicalFunctions' | 'extractGeneric' | 'useHigherOrder' | 'applyInheritance';
-export interface Options {
-    /** Minimum lines to consider for duplicate detection. Default: 3 */
-    minLines?: number;
-    /** Similarity percentage threshold (0-100). Default: 90 */
-    similarityThreshold?: number;
-    /** Ignore test files. Default: false */
-    ignoreTestFiles?: boolean;
-}
-type RuleOptions = [Options?];
-/**
- * Build the generic extracted-function name suggested for a duplication group.
- * Shared by the unified-function template and the report data so the two can
- * never drift apart.
- */
-export declare function buildGenericName(firstFunctionName: string): string;
-export declare const identicalFunctions: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/maintainability/max-parameters.d.ts

@@ -1,29 +0,0 @@
-/**
- * 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: max-parameters
- * Detects functions with too many parameters
- *
- * Note: ESLint has max-params, but this rule provides LLM-optimized messages
- * and additional context about refactoring to object parameters
- *
- * @see https://rules.sonarsource.com/javascript/RSPEC-107/
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-type MessageIds = 'tooManyParameters' | 'useObjectParameter' | 'extractToClass' | 'splitFunction';
-export interface Options {
-    /** Maximum allowed parameters. Default: 4 */
-    max?: number;
-    /** Ignore constructors. Default: false */
-    ignoreConstructors?: boolean;
-    /** Ignore overridden methods. Default: false */
-    ignoreOverriddenMethods?: boolean;
-}
-type RuleOptions = [Options?];
-export declare const maxParameters: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/maintainability/nested-complexity-hotspots.d.ts

@@ -1,31 +0,0 @@
-/**
- * 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: nested-complexity-hotspots
- * Identifies nested control structures that harm readability
- * Priority 3: Enhanced Complexity Analysis
- *
- * @see https://en.wikipedia.org/wiki/Cyclomatic_complexity
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-type MessageIds = 'nestedComplexity' | 'useEarlyReturn' | 'useGuardClauses' | 'extractMethod';
-export interface Options {
-    /** Maximum nesting depth. Default: 4 */
-    maxDepth?: number;
-    /** Count nested conditionals. Default: true */
-    countConditionals?: boolean;
-    /** Count nested loops. Default: true */
-    countLoops?: boolean;
-}
-type RuleOptions = [Options?];
-/**
- * Calculate nesting depth for a node
- * Note: Currently unused, keeping for future implementation
- */
-export declare const nestedComplexityHotspots: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/maintainability/no-lonely-if.d.ts

@@ -1,19 +0,0 @@
-/**
- * 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: no-lonely-if
- * Prevent lone if statements inside else blocks
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-export interface Options {
-    /** Allow lonely if in specific contexts */
-    allow?: string[];
-}
-type RuleOptions = [Options?];
-export declare const noLonelyIf: TSESLint.RuleModule<"noLonelyIf", RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/maintainability/no-nested-ternary.d.ts

@@ -1,19 +0,0 @@
-/**
- * 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: no-nested-ternary
- * Prevent nested ternary expressions
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-export interface Options {
-    /** Allow nested ternaries in specific contexts */
-    allow?: string[];
-}
-type RuleOptions = [Options?];
-export declare const noNestedTernary: TSESLint.RuleModule<"noNestedTernary", RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};

package/src/rules/maintainability/no-unreadable-iife.d.ts

@@ -1,24 +0,0 @@
-/**
- * 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: no-unreadable-iife
- * Prevent unreadable Immediately Invoked Function Expressions (unicorn-inspired)
- */
-import type { TSESLint } from '@interlace/eslint-devkit';
-type MessageIds = 'unreadableIIFE' | 'suggestNamedFunction' | 'suggestBlockScope' | 'complexIIFE';
-export interface Options {
-    /** Maximum number of statements allowed in IIFE */
-    maxStatements?: number;
-    /** Maximum depth of nesting allowed in IIFE */
-    maxDepth?: number;
-    /** Allow IIFEs that return values */
-    allowReturningIIFE?: boolean;
-}
-type RuleOptions = [Options?];
-export declare const noUnreadableIife: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
-    name: string;
-};
-export {};