eslint-plugin-maintainability 3.0.12 → 3.0.14

package/src/rules/error-handling/no-unhandled-promise.js

@@ -1,261 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.noUnhandledPromise = void 0;
-exports.isPromiseExpression = isPromiseExpression;
-exports.isInsidePromiseCallback = isInsidePromiseCallback;
-exports.isPromiseHandled = isPromiseHandled;
-const eslint_devkit_1 = require("@interlace/eslint-devkit");
-const eslint_devkit_2 = require("@interlace/eslint-devkit");
-function isPromiseExpression(node) {
-    if (node.type === 'CallExpression') {
-        return true;
-    }
-    if (node.type === 'AwaitExpression') {
-        return false;
-    }
-    return false;
-}
-function isInsidePromiseCallback(node) {
-    let current = node;
-    let depth = 0;
-    const maxDepth = 10;
-    while (current && depth < maxDepth) {
-        const parent = current
-            .parent;
-        if (!parent)
-            break;
-        if (parent.type === 'ArrowFunctionExpression' ||
-            parent.type === 'FunctionExpression') {
-            const funcParent = parent
-                .parent;
-            if (funcParent &&
-                funcParent.type === 'CallExpression' &&
-                funcParent.callee &&
-                funcParent.callee.type === 'MemberExpression') {
-                const memberExpr = funcParent.callee;
-                if (memberExpr.property.type === 'Identifier') {
-                    const methodName = memberExpr.property.name;
-                    if (methodName === 'then' ||
-                        methodName === 'catch' ||
-                        methodName === 'finally') {
-                        return true;
-                    }
-                }
-            }
-        }
-        current = parent;
-        depth++;
-    }
-    return false;
-}
-function isPromiseHandled(node) {
-    if (node.type === 'Identifier') {
-        const parent = node.parent;
-        if (parent &&
-            parent.type === 'MemberExpression' &&
-            parent.object === node) {
-            if (parent.property.type === 'Identifier') {
-                const methodName = parent.property.name;
-                if (methodName === 'catch' ||
-                    methodName === 'then' ||
-                    methodName === 'finally') {
-                    const memberParent = parent.parent;
-                    if (memberParent &&
-                        memberParent.type === 'CallExpression' &&
-                        memberParent.callee === parent) {
-                        return true;
-                    }
-                }
-            }
-        }
-    }
-    let current = node;
-    let depth = 0;
-    const maxDepth = 10;
-    while (current && depth < maxDepth) {
-        const parent = current
-            .parent;
-        if (!parent)
-            break;
-        if (parent.type === 'MemberExpression' && parent.object === current) {
-            if (parent.property.type === 'Identifier') {
-                const methodName = parent.property.name;
-                if (methodName === 'catch' ||
-                    methodName === 'then' ||
-                    methodName === 'finally') {
-                    const memberParent = parent.parent;
-                    if (memberParent &&
-                        memberParent.type === 'CallExpression' &&
-                        memberParent.callee === parent) {
-                        return true;
-                    }
-                }
-            }
-        }
-        if (parent.type === 'TryStatement') {
-            return true;
-        }
-        if (parent.type === 'AwaitExpression') {
-            return true;
-        }
-        current = parent;
-        depth++;
-    }
-    return false;
-}
-exports.noUnhandledPromise = (0, eslint_devkit_2.createRule)({
-    name: 'no-unhandled-promise',
-    meta: {
-        type: 'problem',
-        docs: {
-            url: 'https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-maintainability/docs/rules/no-unhandled-promise.md',
-            description: 'Detects unhandled Promise rejections',
-            cwe: 'CWE-1024',
-            cvss: 7.5,
-        },
-        hasSuggestions: true,
-        messages: {
-            unhandledPromise: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.WARNING,
-                issueName: 'Unhandled promise',
-                cwe: 'CWE-1024',
-                description: 'Unhandled Promise rejection detected',
-                severity: 'HIGH',
-                fix: 'Add .catch() handler or use try/catch with await',
-                documentationLink: 'https://rules.sonarsource.com/javascript/RSPEC-4635/',
-            }),
-            addCatch: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Add catch handler',
-                description: 'Add .catch() handler to promise',
-                severity: 'LOW',
-                fix: 'promise.catch(error => console.error(error))',
-                documentationLink: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/catch',
-            }),
-            useTryCatch: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Use try/catch',
-                description: 'Use try/catch with await',
-                severity: 'LOW',
-                fix: 'try { await promise; } catch (error) { handle(error); }',
-                documentationLink: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch',
-            }),
-            useAwait: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Use await',
-                description: 'Use await to handle promise',
-                severity: 'LOW',
-                fix: 'await promise;',
-                documentationLink: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await',
-            }),
-        },
-        schema: [
-            {
-                type: 'object',
-                properties: {
-                    ignoreInTests: {
-                        type: 'boolean',
-                        default: true,
-                        description: 'Ignore promises in test files',
-                    },
-                    ignoreVoidExpressions: {
-                        type: 'boolean',
-                        default: false,
-                        description: 'Ignore promises in void expressions',
-                    },
-                },
-                additionalProperties: false,
-            },
-        ],
-    },
-    defaultOptions: [
-        {
-            ignoreInTests: true,
-            ignoreVoidExpressions: false,
-        },
-    ],
-    create(context, [options = {}]) {
-        const { ignoreInTests = true, ignoreVoidExpressions = false } = options || {};
-        const filename = context.filename;
-        const isTestFile = ignoreInTests && /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filename);
-        if (isTestFile) {
-            return {};
-        }
-        function checkCallExpression(node) {
-            if (isInsidePromiseCallback(node)) {
-                return;
-            }
-            if (node.callee.type === 'MemberExpression' &&
-                node.callee.property.type === 'Identifier') {
-                const methodName = node.callee.property.name;
-                if (methodName === 'then' ||
-                    methodName === 'catch' ||
-                    methodName === 'finally') {
-                    if (node.arguments.length > 0 &&
-                        node.arguments[0].type === 'ArrowFunctionExpression') {
-                        const callback = node.arguments[0];
-                        if (callback.body.type === 'BlockStatement' &&
-                            callback.body.body.length === 0) {
-                        }
-                        else {
-                            return;
-                        }
-                    }
-                    else {
-                        return;
-                    }
-                }
-            }
-            if (!isPromiseExpression(node)) {
-                return;
-            }
-            if (isPromiseHandled(node)) {
-                return;
-            }
-            if (ignoreVoidExpressions) {
-                const parent = node
-                    .parent;
-                if (parent &&
-                    parent.type === 'UnaryExpression' &&
-                    parent.operator === 'void') {
-                    return;
-                }
-            }
-            const parent = node
-                .parent;
-            if (parent && parent.type === 'CallExpression') {
-                const grandParent = parent.parent;
-                if (!(grandParent &&
-                    grandParent.type === 'MemberExpression' &&
-                    grandParent.object === parent &&
-                    grandParent.property.type === 'Identifier' &&
-                    (grandParent.property.name === 'then' ||
-                        grandParent.property.name === 'catch' ||
-                        grandParent.property.name === 'finally'))) {
-                    return;
-                }
-            }
-            context.report({
-                node,
-                messageId: 'unhandledPromise',
-                suggest: [
-                    {
-                        messageId: 'addCatch',
-                        fix: () => null,
-                    },
-                    {
-                        messageId: 'useTryCatch',
-                        fix: () => null,
-                    },
-                    {
-                        messageId: 'useAwait',
-                        fix: () => null,
-                    },
-                ],
-            });
-        }
-        return {
-            CallExpression: checkCallExpression,
-        };
-    },
-});
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noUnhandledPromise=void 0;exports.isPromiseExpression=isPromiseExpression;exports.isInsidePromiseCallback=isInsidePromiseCallback;exports.isPromiseHandled=isPromiseHandled;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");function isPromiseExpression(node){if(node.type==="CallExpression"){return true}if(node.type==="AwaitExpression"){return false}return false}function isInsidePromiseCallback(node){let current=node;let depth=0;const maxDepth=10;while(current&&depth<maxDepth){const parent=current.parent;if(!parent)break;if(parent.type==="ArrowFunctionExpression"||parent.type==="FunctionExpression"){const funcParent=parent.parent;if(funcParent&&funcParent.type==="CallExpression"&&funcParent.callee&&funcParent.callee.type==="MemberExpression"){const memberExpr=funcParent.callee;if(memberExpr.property.type==="Identifier"){const methodName=memberExpr.property.name;if(methodName==="then"||methodName==="catch"||methodName==="finally"){return true}}}}current=parent;depth++}return false}function isPromiseHandled(node){if(node.type==="Identifier"){const parent=node.parent;if(parent&&parent.type==="MemberExpression"&&parent.object===node){if(parent.property.type==="Identifier"){const methodName=parent.property.name;if(methodName==="catch"||methodName==="then"||methodName==="finally"){const memberParent=parent.parent;if(memberParent&&memberParent.type==="CallExpression"&&memberParent.callee===parent){return true}}}}}let current=node;let depth=0;const maxDepth=10;while(current&&depth<maxDepth){const parent=current.parent;if(!parent)break;if(parent.type==="MemberExpression"&&parent.object===current){if(parent.property.type==="Identifier"){const methodName=parent.property.name;if(methodName==="catch"||methodName==="then"||methodName==="finally"){const memberParent=parent.parent;if(memberParent&&memberParent.type==="CallExpression"&&memberParent.callee===parent){return true}}}}if(parent.type==="TryStatement"){return true}if(parent.type==="AwaitExpression"){return true}current=parent;depth++}return false}exports.noUnhandledPromise=(0,eslint_devkit_2.createRule)({name:"no-unhandled-promise",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-maintainability/docs/rules/no-unhandled-promise.md",description:"Detects unhandled Promise rejections",cwe:"CWE-1024",cvss:7.5},hasSuggestions:true,messages:{unhandledPromise:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.WARNING,issueName:"Unhandled promise",cwe:"CWE-1024",description:"Unhandled Promise rejection detected",severity:"HIGH",fix:"Add .catch() handler or use try/catch with await",documentationLink:"https://rules.sonarsource.com/javascript/RSPEC-4635/"}),addCatch:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add catch handler",description:"Add .catch() handler to promise",severity:"LOW",fix:"promise.catch(error => console.error(error))",documentationLink:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/catch"}),useTryCatch:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use try/catch",description:"Use try/catch with await",severity:"LOW",fix:"try { await promise; } catch (error) { handle(error); }",documentationLink:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch"}),useAwait:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use await",description:"Use await to handle promise",severity:"LOW",fix:"await promise;",documentationLink:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await"})},schema:[{type:"object",properties:{ignoreInTests:{type:"boolean",default:true,description:"Ignore promises in test files"},ignoreVoidExpressions:{type:"boolean",default:false,description:"Ignore promises in void expressions"}},additionalProperties:false}]},defaultOptions:[{ignoreInTests:true,ignoreVoidExpressions:false}],create(context,[options={}]){const{ignoreInTests=true,ignoreVoidExpressions=false}=options||{};const filename=context.filename;const isTestFile=ignoreInTests&&/\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filename);if(isTestFile){return{}}function checkCallExpression(node){if(isInsidePromiseCallback(node)){return}if(node.callee.type==="MemberExpression"&&node.callee.property.type==="Identifier"){const methodName=node.callee.property.name;if(methodName==="then"||methodName==="catch"||methodName==="finally"){if(node.arguments.length>0&&node.arguments[0].type==="ArrowFunctionExpression"){const callback=node.arguments[0];if(callback.body.type==="BlockStatement"&&callback.body.body.length===0){}else{return}}else{return}}}if(!isPromiseExpression(node)){return}if(isPromiseHandled(node)){return}if(ignoreVoidExpressions){const parent2=node.parent;if(parent2&&parent2.type==="UnaryExpression"&&parent2.operator==="void"){return}}const parent=node.parent;if(parent&&parent.type==="CallExpression"){const grandParent=parent.parent;if(!(grandParent&&grandParent.type==="MemberExpression"&&grandParent.object===parent&&grandParent.property.type==="Identifier"&&(grandParent.property.name==="then"||grandParent.property.name==="catch"||grandParent.property.name==="finally"))){return}}context.report({node,messageId:"unhandledPromise",suggest:[{messageId:"addCatch",fix:()=>null},{messageId:"useTryCatch",fix:()=>null},{messageId:"useAwait",fix:()=>null}]})}return{CallExpression:checkCallExpression}}});

package/src/rules/maintainability/cognitive-complexity.js

@@ -1,341 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cognitiveComplexity = void 0;
-const eslint_devkit_1 = require("@interlace/eslint-devkit");
-const eslint_devkit_2 = require("@interlace/eslint-devkit");
-const eslint_devkit_3 = require("@interlace/eslint-devkit");
-exports.cognitiveComplexity = (0, eslint_devkit_2.createRule)({
-    name: 'cognitive-complexity',
-    meta: {
-        type: 'suggestion',
-        docs: {
-            url: 'https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-maintainability/docs/rules/cognitive-complexity.md',
-            description: 'Enforces a maximum cognitive complexity threshold with refactoring guidance',
-            cwe: 'CWE-1104',
-            cvss: 7.5,
-        },
-        messages: {
-            highCognitiveComplexity: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.COMPLEXITY,
-                issueName: 'High cognitive complexity',
-                cwe: 'CWE-1104',
-                description: '{{functionName}}: {{complexity}}/{{max}} ({{overBy}} over)',
-                severity: 'HIGH',
-                fix: 'Extract logic to helpers',
-                documentationLink: 'https://en.wikipedia.org/wiki/Cognitive_complexity',
-            }),
-            extractMethod: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Extract Method',
-                description: 'Extract nested logic to separate method',
-                severity: 'LOW',
-                fix: 'Extract to "{{methodName}}" (reduces complexity by ~{{reduction}})',
-                documentationLink: 'https://refactoring.guru/extract-method',
-            }),
-            simplifyLogic: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Simplify Logic',
-                description: 'Simplify conditional logic',
-                severity: 'LOW',
-                fix: 'Use guard clauses and early returns',
-                documentationLink: 'https://refactoring.guru/replace-nested-conditional-with-guard-clauses',
-            }),
-            useStrategy: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Use Strategy Pattern',
-                description: 'Apply design pattern to reduce complexity',
-                severity: 'LOW',
-                fix: 'Apply {{pattern}} pattern',
-                documentationLink: 'https://refactoring.guru/design-patterns/strategy',
-            }),
-        },
-        schema: [
-            {
-                type: 'object',
-                properties: {
-                    maxComplexity: {
-                        type: 'number',
-                        default: 15,
-                        minimum: 1,
-                    },
-                    includeMetrics: {
-                        type: 'boolean',
-                        default: true,
-                    },
-                },
-                additionalProperties: false,
-            },
-        ],
-    },
-    defaultOptions: [
-        {
-            maxComplexity: 15,
-            includeMetrics: true,
-        },
-    ],
-    create(context) {
-        const { maxComplexity = 15 } = context.options[0] || {};
-        const filename = context.filename;
-        function calculateCognitiveComplexity(node) {
-            let complexity = 0;
-            const breakdown = {
-                conditionals: 0,
-                loops: 0,
-                switches: 0,
-                nesting: 0,
-                logicalOperators: 0,
-                catches: 0,
-                recursion: 0,
-            };
-            const functionName = node.type === 'FunctionDeclaration' && node.id
-                ? node.id.name
-                : 'anonymous';
-            function traverse(n, currentNesting) {
-                if (n.type === 'IfStatement') {
-                    complexity += 1 + currentNesting;
-                    breakdown.conditionals++;
-                    traverse(n.test, currentNesting);
-                    traverse(n.consequent, currentNesting + 1);
-                    if (n.alternate) {
-                        if (n.alternate.type === 'IfStatement') {
-                            traverse(n.alternate, currentNesting);
-                        }
-                        else {
-                            complexity += 1;
-                            traverse(n.alternate, currentNesting + 1);
-                        }
-                    }
-                    return;
-                }
-                if (n.type === 'ForStatement' ||
-                    n.type === 'ForInStatement' ||
-                    n.type === 'ForOfStatement' ||
-                    n.type === 'WhileStatement' ||
-                    n.type === 'DoWhileStatement') {
-                    complexity += 1 + currentNesting;
-                    breakdown.loops++;
-                    if (n.type === 'ForStatement') {
-                        if (n.init)
-                            traverse(n.init, currentNesting);
-                        if (n.test)
-                            traverse(n.test, currentNesting);
-                        if (n.update)
-                            traverse(n.update, currentNesting);
-                        traverse(n.body, currentNesting + 1);
-                    }
-                    else if (n.type === 'WhileStatement' ||
-                        n.type === 'DoWhileStatement') {
-                        traverse(n.test, currentNesting);
-                        traverse(n.body, currentNesting + 1);
-                    }
-                    else {
-                        if ('left' in n)
-                            traverse(n.left, currentNesting);
-                        if ('right' in n)
-                            traverse(n.right, currentNesting);
-                        traverse(n.body, currentNesting + 1);
-                    }
-                    return;
-                }
-                if (n.type === 'SwitchStatement') {
-                    complexity += 1 + currentNesting;
-                    breakdown.switches++;
-                    traverse(n.discriminant, currentNesting);
-                    n.cases.forEach((c) => traverse(c, currentNesting + 1));
-                    return;
-                }
-                if (n.type === 'LogicalExpression') {
-                    if (n.operator === '&&' ||
-                        n.operator === '||' ||
-                        n.operator === '??') {
-                        complexity += 1;
-                        breakdown.logicalOperators++;
-                    }
-                }
-                if (n.type === 'CatchClause') {
-                    complexity += 1 + currentNesting;
-                    breakdown.catches++;
-                    traverse(n.body, currentNesting + 1);
-                    return;
-                }
-                if (n.type === 'ConditionalExpression') {
-                    complexity += 1 + currentNesting;
-                    breakdown.conditionals++;
-                }
-                if (n.type === 'CallExpression') {
-                    if (n.callee.type === 'Identifier' &&
-                        n.callee.name === functionName) {
-                        complexity += 1;
-                        breakdown.recursion++;
-                    }
-                }
-                if (n.type === 'BlockStatement' ||
-                    n.type === 'FunctionDeclaration' ||
-                    n.type === 'FunctionExpression' ||
-                    n.type === 'ArrowFunctionExpression') {
-                    breakdown.nesting = Math.max(breakdown.nesting, currentNesting);
-                }
-                const visited = new Set();
-                function traverseChild(child) {
-                    if (child && typeof child === 'object' && 'type' in child) {
-                        const childNode = child;
-                        if (!visited.has(childNode)) {
-                            visited.add(childNode);
-                            traverse(childNode, currentNesting);
-                        }
-                    }
-                }
-                const childKeys = [
-                    'body',
-                    'test',
-                    'consequent',
-                    'alternate',
-                    'init',
-                    'update',
-                    'left',
-                    'right',
-                    'argument',
-                    'arguments',
-                    'callee',
-                    'object',
-                    'property',
-                    'elements',
-                    'properties',
-                    'expression',
-                    'expressions',
-                    'declarations',
-                    'declaration',
-                    'specifiers',
-                    'source',
-                    'key',
-                    'value',
-                    'handler',
-                    'block',
-                    'finalizer',
-                ];
-                for (const key of childKeys) {
-                    const child = n[key];
-                    if (child) {
-                        if (Array.isArray(child)) {
-                            child.forEach(traverseChild);
-                        }
-                        else {
-                            traverseChild(child);
-                        }
-                    }
-                }
-            }
-            if (node.body) {
-                traverse(node.body, 0);
-            }
-            return { total: complexity, breakdown };
-        }
-        function suggestExtractions(node, breakdown) {
-            const suggestions = [];
-            if (breakdown.nesting >= 4 && node.loc) {
-                suggestions.push({
-                    name: 'extractNestedLogic',
-                    reason: `Nesting depth of ${breakdown.nesting} makes code hard to follow`,
-                    lineRange: [node.loc.start.line, node.loc.end.line],
-                    estimatedComplexityReduction: Math.floor(breakdown.nesting * 1.5),
-                });
-            }
-            if (breakdown.switches >= 2 && node.loc) {
-                suggestions.push({
-                    name: 'refactorSwitchToStrategy',
-                    reason: `${breakdown.switches} switch statements suggest strategy pattern`,
-                    lineRange: [node.loc.start.line, node.loc.end.line],
-                    estimatedComplexityReduction: breakdown.switches * 2,
-                });
-            }
-            if (breakdown.loops >= 3 && node.loc) {
-                suggestions.push({
-                    name: 'extractLoopLogic',
-                    reason: `${breakdown.loops} loops can be extracted to separate methods`,
-                    lineRange: [node.loc.start.line, node.loc.end.line],
-                    estimatedComplexityReduction: breakdown.loops * 2,
-                });
-            }
-            if (breakdown.conditionals >= 5 && node.loc) {
-                suggestions.push({
-                    name: 'simplifyConditionals',
-                    reason: `${breakdown.conditionals} conditional branches could use Guard Clauses`,
-                    lineRange: [node.loc.start.line, node.loc.end.line],
-                    estimatedComplexityReduction: Math.floor(breakdown.conditionals * 0.8),
-                });
-            }
-            return suggestions;
-        }
-        function suggestPattern(breakdown) {
-            if (breakdown.switches >= 2)
-                return 'Strategy Pattern';
-            if (breakdown.conditionals >= 5)
-                return 'Guard Clauses + Early Return';
-            if (breakdown.loops >= 3)
-                return 'Extract Method + Pipeline';
-            if (breakdown.nesting >= 4)
-                return 'Extract Method + Composed Functions';
-            return 'Extract Method';
-        }
-        function estimateRefactoringTime(complexity, breakdown) {
-            const baseTime = Math.floor((complexity - maxComplexity) * 3);
-            const nestingPenalty = breakdown.nesting >= 4 ? 15 : 0;
-            const totalMinutes = baseTime + nestingPenalty;
-            if (totalMinutes < 30)
-                return `${totalMinutes} minutes`;
-            if (totalMinutes < 60)
-                return '30-60 minutes';
-            return `${Math.ceil(totalMinutes / 60)} hours`;
-        }
-        function checkFunction(node) {
-            const { total: complexity, breakdown } = calculateCognitiveComplexity(node);
-            if (complexity <= maxComplexity)
-                return;
-            const functionSignature = (0, eslint_devkit_3.extractFunctionSignature)(node);
-            const suggestions = suggestExtractions(node, breakdown);
-            const pattern = suggestPattern(breakdown);
-            const estimatedTime = estimateRefactoringTime(complexity, breakdown);
-            context.report({
-                node,
-                messageId: 'highCognitiveComplexity',
-                data: {
-                    functionName: functionSignature,
-                    complexity: String(complexity),
-                    max: String(maxComplexity),
-                    overBy: String(complexity - maxComplexity),
-                    current: String(complexity),
-                    filePath: filename,
-                    line: String(node.loc?.start.line ?? 0),
-                    conditionals: String(breakdown.conditionals),
-                    loops: String(breakdown.loops),
-                    nesting: String(breakdown.nesting),
-                    pattern,
-                    estimatedTime,
-                },
-                suggest: suggestions.length > 0
-                    ? suggestions.map((suggestion, index) => {
-                        const messageId = index === 0
-                            ? 'extractMethod'
-                            : index === 1
-                                ? 'useStrategy'
-                                : 'simplifyLogic';
-                        return {
-                            messageId,
-                            data: {
-                                methodName: suggestion.name,
-                                pattern,
-                                reduction: String(suggestion.estimatedComplexityReduction),
-                            },
-                            fix: () => null,
-                        };
-                    })
-                    : undefined,
-            });
-        }
-        return {
-            FunctionDeclaration: checkFunction,
-            FunctionExpression: checkFunction,
-            ArrowFunctionExpression: checkFunction,
-        };
-    },
-});
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.cognitiveComplexity=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");const eslint_devkit_3=require("@interlace/eslint-devkit");exports.cognitiveComplexity=(0,eslint_devkit_2.createRule)({name:"cognitive-complexity",meta:{type:"suggestion",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-maintainability/docs/rules/cognitive-complexity.md",description:"Enforces a maximum cognitive complexity threshold with refactoring guidance",cwe:"CWE-1104",cvss:7.5},messages:{highCognitiveComplexity:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.COMPLEXITY,issueName:"High cognitive complexity",cwe:"CWE-1104",description:"{{functionName}}: {{complexity}}/{{max}} ({{overBy}} over)",severity:"HIGH",fix:"Extract logic to helpers",documentationLink:"https://en.wikipedia.org/wiki/Cognitive_complexity"}),extractMethod:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Extract Method",description:"Extract nested logic to separate method",severity:"LOW",fix:'Extract to "{{methodName}}" (reduces complexity by ~{{reduction}})',documentationLink:"https://refactoring.guru/extract-method"}),simplifyLogic:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Simplify Logic",description:"Simplify conditional logic",severity:"LOW",fix:"Use guard clauses and early returns",documentationLink:"https://refactoring.guru/replace-nested-conditional-with-guard-clauses"}),useStrategy:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Strategy Pattern",description:"Apply design pattern to reduce complexity",severity:"LOW",fix:"Apply {{pattern}} pattern",documentationLink:"https://refactoring.guru/design-patterns/strategy"})},schema:[{type:"object",properties:{maxComplexity:{type:"number",default:15,minimum:1},includeMetrics:{type:"boolean",default:true}},additionalProperties:false}]},defaultOptions:[{maxComplexity:15,includeMetrics:true}],create(context){const{maxComplexity=15}=context.options[0]||{};const filename=context.filename;function calculateCognitiveComplexity(node){let complexity=0;const breakdown={conditionals:0,loops:0,switches:0,nesting:0,logicalOperators:0,catches:0,recursion:0};const functionName=node.type==="FunctionDeclaration"&&node.id?node.id.name:"anonymous";function traverse(n,currentNesting){if(n.type==="IfStatement"){complexity+=1+currentNesting;breakdown.conditionals++;traverse(n.test,currentNesting);traverse(n.consequent,currentNesting+1);if(n.alternate){if(n.alternate.type==="IfStatement"){traverse(n.alternate,currentNesting)}else{complexity+=1;traverse(n.alternate,currentNesting+1)}}return}if(n.type==="ForStatement"||n.type==="ForInStatement"||n.type==="ForOfStatement"||n.type==="WhileStatement"||n.type==="DoWhileStatement"){complexity+=1+currentNesting;breakdown.loops++;if(n.type==="ForStatement"){if(n.init)traverse(n.init,currentNesting);if(n.test)traverse(n.test,currentNesting);if(n.update)traverse(n.update,currentNesting);traverse(n.body,currentNesting+1)}else if(n.type==="WhileStatement"||n.type==="DoWhileStatement"){traverse(n.test,currentNesting);traverse(n.body,currentNesting+1)}else{if("left"in n)traverse(n.left,currentNesting);if("right"in n)traverse(n.right,currentNesting);traverse(n.body,currentNesting+1)}return}if(n.type==="SwitchStatement"){complexity+=1+currentNesting;breakdown.switches++;traverse(n.discriminant,currentNesting);n.cases.forEach(c=>traverse(c,currentNesting+1));return}if(n.type==="LogicalExpression"){if(n.operator==="&&"||n.operator==="||"||n.operator==="??"){complexity+=1;breakdown.logicalOperators++}}if(n.type==="CatchClause"){complexity+=1+currentNesting;breakdown.catches++;traverse(n.body,currentNesting+1);return}if(n.type==="ConditionalExpression"){complexity+=1+currentNesting;breakdown.conditionals++}if(n.type==="CallExpression"){if(n.callee.type==="Identifier"&&n.callee.name===functionName){complexity+=1;breakdown.recursion++}}if(n.type==="BlockStatement"||n.type==="FunctionDeclaration"||n.type==="FunctionExpression"||n.type==="ArrowFunctionExpression"){breakdown.nesting=Math.max(breakdown.nesting,currentNesting)}const visited=new Set;function traverseChild(child){if(child&&typeof child==="object"&&"type"in child){const childNode=child;if(!visited.has(childNode)){visited.add(childNode);traverse(childNode,currentNesting)}}}const childKeys=["body","test","consequent","alternate","init","update","left","right","argument","arguments","callee","object","property","elements","properties","expression","expressions","declarations","declaration","specifiers","source","key","value","handler","block","finalizer"];for(const key of childKeys){const child=n[key];if(child){if(Array.isArray(child)){child.forEach(traverseChild)}else{traverseChild(child)}}}}if(node.body){traverse(node.body,0)}return{total:complexity,breakdown}}function suggestExtractions(node,breakdown){const suggestions=[];if(breakdown.nesting>=4&&node.loc){suggestions.push({name:"extractNestedLogic",reason:`Nesting depth of ${breakdown.nesting} makes code hard to follow`,lineRange:[node.loc.start.line,node.loc.end.line],estimatedComplexityReduction:Math.floor(breakdown.nesting*1.5)})}if(breakdown.switches>=2&&node.loc){suggestions.push({name:"refactorSwitchToStrategy",reason:`${breakdown.switches} switch statements suggest strategy pattern`,lineRange:[node.loc.start.line,node.loc.end.line],estimatedComplexityReduction:breakdown.switches*2})}if(breakdown.loops>=3&&node.loc){suggestions.push({name:"extractLoopLogic",reason:`${breakdown.loops} loops can be extracted to separate methods`,lineRange:[node.loc.start.line,node.loc.end.line],estimatedComplexityReduction:breakdown.loops*2})}if(breakdown.conditionals>=5&&node.loc){suggestions.push({name:"simplifyConditionals",reason:`${breakdown.conditionals} conditional branches could use Guard Clauses`,lineRange:[node.loc.start.line,node.loc.end.line],estimatedComplexityReduction:Math.floor(breakdown.conditionals*.8)})}return suggestions}function suggestPattern(breakdown){if(breakdown.switches>=2)return"Strategy Pattern";if(breakdown.conditionals>=5)return"Guard Clauses + Early Return";if(breakdown.loops>=3)return"Extract Method + Pipeline";if(breakdown.nesting>=4)return"Extract Method + Composed Functions";return"Extract Method"}function estimateRefactoringTime(complexity,breakdown){const baseTime=Math.floor((complexity-maxComplexity)*3);const nestingPenalty=breakdown.nesting>=4?15:0;const totalMinutes=baseTime+nestingPenalty;if(totalMinutes<30)return`${totalMinutes} minutes`;if(totalMinutes<60)return"30-60 minutes";return`${Math.ceil(totalMinutes/60)} hours`}function checkFunction(node){const{total:complexity,breakdown}=calculateCognitiveComplexity(node);if(complexity<=maxComplexity)return;const functionSignature=(0,eslint_devkit_3.extractFunctionSignature)(node);const suggestions=suggestExtractions(node,breakdown);const pattern=suggestPattern(breakdown);const estimatedTime=estimateRefactoringTime(complexity,breakdown);context.report({node,messageId:"highCognitiveComplexity",data:{functionName:functionSignature,complexity:String(complexity),max:String(maxComplexity),overBy:String(complexity-maxComplexity),current:String(complexity),filePath:filename,line:String(node.loc?.start.line??0),conditionals:String(breakdown.conditionals),loops:String(breakdown.loops),nesting:String(breakdown.nesting),pattern,estimatedTime},suggest:suggestions.length>0?suggestions.map((suggestion,index)=>{const messageId=index===0?"extractMethod":index===1?"useStrategy":"simplifyLogic";return{messageId,data:{methodName:suggestion.name,pattern,reduction:String(suggestion.estimatedComplexityReduction)},fix:()=>null}}):void 0})}return{FunctionDeclaration:checkFunction,FunctionExpression:checkFunction,ArrowFunctionExpression:checkFunction}}});