distyll 0.1.0

package/dist/rules/single-option-object.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.singleOptionObject = void 0;
+const parser_1 = require("../parser");
+function getDestructuredParams(node) {
+    const params = node.childForFieldName('parameters');
+    if (!params)
+        return [];
+    return params.namedChildren.filter((p) => {
+        // Destructured object parameter: function({ foo }) {}
+        if (p.type === 'object_pattern')
+            return true;
+        // TypeScript: function({ foo }: Options) {}
+        if (p.type === 'required_parameter' || p.type === 'optional_parameter') {
+            const pattern = p.childForFieldName('pattern');
+            if (pattern?.type === 'object_pattern')
+                return true;
+        }
+        return false;
+    });
+}
+function getObjectPatternPropertyCount(node) {
+    let objectPattern = node;
+    if (node.type === 'required_parameter' || node.type === 'optional_parameter') {
+        const pattern = node.childForFieldName('pattern');
+        if (pattern?.type === 'object_pattern')
+            objectPattern = pattern;
+        else
+            return 0;
+    }
+    if (objectPattern.type !== 'object_pattern')
+        return 0;
+    // Count actual properties (not rest elements)
+    return objectPattern.namedChildren.filter((c) => c.type === 'shorthand_property_identifier_pattern' ||
+        c.type === 'pair_pattern' ||
+        c.type === 'object_assignment_pattern' ||
+        c.type === 'assignment_pattern').length;
+}
+function getFunctionName(node) {
+    if (node.type === 'function_declaration' || node.type === 'method_definition') {
+        return node.childForFieldName('name')?.text ?? null;
+    }
+    if (node.parent?.type === 'variable_declarator') {
+        return node.parent.childForFieldName('name')?.text ?? null;
+    }
+    return null;
+}
+exports.singleOptionObject = {
+    name: 'single-option-object',
+    description: 'Flags function parameters that destructure an object with only one property',
+    severity: 'info',
+    check(tree, source, filePath) {
+        const findings = [];
+        const functions = (0, parser_1.findNodesMulti)(tree.rootNode, [
+            'function_declaration',
+            'arrow_function',
+            'function',
+            'method_definition',
+        ]);
+        for (const fn of functions) {
+            const destructuredParams = getDestructuredParams(fn);
+            for (const param of destructuredParams) {
+                const propCount = getObjectPatternPropertyCount(param);
+                if (propCount === 1) {
+                    // Skip if function has only this one parameter and it's a callback
+                    const parent = fn.parent;
+                    if (parent?.type === 'arguments' || parent?.type === 'call_expression') {
+                        continue;
+                    }
+                    const name = getFunctionName(fn);
+                    const label = name ? `Function '${name}'` : 'Function';
+                    findings.push({
+                        file: filePath,
+                        line: param.startPosition.row + 1,
+                        column: param.startPosition.column + 1,
+                        endLine: param.endPosition.row + 1,
+                        endColumn: param.endPosition.column + 1,
+                        rule: 'single-option-object',
+                        severity: 'info',
+                        message: `${label} destructures an options object with only 1 property — use a plain parameter instead`,
+                    });
+                }
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=single-option-object.js.map

package/dist/rules/single-option-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-option-object.js","sourceRoot":"","sources":["../../src/rules/single-option-object.ts"],"names":[],"mappings":"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"}

package/dist/rules/single-use-wrapper.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types';
+export declare const singleUseWrapper: Rule;
+//# sourceMappingURL=single-use-wrapper.d.ts.map

package/dist/rules/single-use-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-use-wrapper.d.ts","sourceRoot":"","sources":["../../src/rules/single-use-wrapper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,UAAU,CAAC;AA+H9C,eAAO,MAAM,gBAAgB,EAAE,IAsD9B,CAAC"}

package/dist/rules/single-use-wrapper.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.singleUseWrapper = void 0;
+const parser_1 = require("../parser");
+function getFunctionBody(node) {
+    return node.childForFieldName('body');
+}
+function getFunctionName(node) {
+    if (node.type === 'function_declaration' || node.type === 'method_definition') {
+        const nameNode = node.childForFieldName('name');
+        return nameNode?.text ?? null;
+    }
+    if (node.type === 'variable_declarator') {
+        const nameNode = node.childForFieldName('name');
+        return nameNode?.text ?? null;
+    }
+    return null;
+}
+function getStatements(body) {
+    if (body.type === 'statement_block') {
+        return body.namedChildren;
+    }
+    return [];
+}
+const COMPLEX_ARG_TYPES = new Set([
+    'arrow_function', 'function', 'object', 'array',
+    'template_string', 'binary_expression', 'new_expression',
+    'ternary_expression', 'conditional_expression',
+    'unary_expression', 'update_expression', 'assignment_expression',
+    'augmented_assignment_expression', 'yield_expression',
+    'spread_element', 'regex', 'class',
+]);
+function isSimpleNode(node) {
+    if (node.type === 'identifier' || node.type === 'this' ||
+        node.type === 'string' || node.type === 'number' ||
+        node.type === 'true' || node.type === 'false' ||
+        node.type === 'null' || node.type === 'undefined') {
+        return true;
+    }
+    // Simple member_expression like a.b (not computed a[b])
+    if (node.type === 'member_expression') {
+        const computed = node.children.some(c => c.type === '[');
+        return !computed;
+    }
+    return false;
+}
+function hasOnlySimpleArguments(callExpr) {
+    // Check if callee involves complex expressions (e.g. new Foo().method())
+    const callee = callExpr.childForFieldName('function');
+    if (callee?.type === 'member_expression') {
+        const object = callee.childForFieldName('object');
+        if (object && COMPLEX_ARG_TYPES.has(object.type))
+            return false;
+        // Also check for chained calls with complex args: foo(complex).bar(simple)
+        if (object?.type === 'call_expression') {
+            if (!hasOnlySimpleArguments(object))
+                return false;
+        }
+    }
+    const args = callExpr.childForFieldName('arguments');
+    if (!args)
+        return true;
+    for (const arg of args.namedChildren) {
+        if (isSimpleNode(arg))
+            continue;
+        // Known complex types
+        if (COMPLEX_ARG_TYPES.has(arg.type))
+            return false;
+        // Anything else unexpected — be conservative, treat as complex
+        return false;
+    }
+    return true;
+}
+function extractCallExpression(node) {
+    if (node.type === 'call_expression')
+        return node;
+    // Parenthesized expression wrapping a call
+    if (node.type === 'parenthesized_expression' && node.namedChildren.length === 1) {
+        return extractCallExpression(node.namedChildren[0]);
+    }
+    return null;
+}
+function isSimpleDelegatingFunction(body) {
+    // For arrow functions with expression body (no braces)
+    if (body.type === 'call_expression') {
+        return hasOnlySimpleArguments(body);
+    }
+    const stmts = getStatements(body);
+    if (stmts.length !== 1)
+        return false;
+    const stmt = stmts[0];
+    // Single return statement with a function call
+    if (stmt.type === 'return_statement') {
+        const returnValue = stmt.namedChildren[0];
+        if (!returnValue)
+            return false;
+        const call = extractCallExpression(returnValue);
+        if (!call)
+            return false;
+        return hasOnlySimpleArguments(call);
+    }
+    // Single expression statement that is a function call (void wrapper)
+    if (stmt.type === 'expression_statement') {
+        const expr = stmt.namedChildren[0];
+        if (!expr)
+            return false;
+        const call = extractCallExpression(expr);
+        if (!call)
+            return false;
+        return hasOnlySimpleArguments(call);
+    }
+    return false;
+}
+function getParameterCount(node) {
+    const params = node.childForFieldName('parameters');
+    if (!params)
+        return 0;
+    return params.namedChildren.filter(c => c.type === 'identifier' ||
+        c.type === 'required_parameter' ||
+        c.type === 'optional_parameter' ||
+        c.type === 'rest_parameter' ||
+        c.type === 'assignment_pattern').length;
+}
+exports.singleUseWrapper = {
+    name: 'single-use-wrapper',
+    description: 'Flags functions that merely delegate to another function without adding logic',
+    severity: 'warning',
+    check(tree, source, filePath) {
+        const findings = [];
+        const functionNodes = (0, parser_1.findNodesMulti)(tree.rootNode, [
+            'function_declaration',
+            'arrow_function',
+            'function',
+        ]);
+        for (const fn of functionNodes) {
+            const body = getFunctionBody(fn);
+            if (!body)
+                continue;
+            if (!isSimpleDelegatingFunction(body))
+                continue;
+            // Skip if function has more than 3 parameters (likely an intentional adapter)
+            if (getParameterCount(fn) > 3)
+                continue;
+            // Skip anonymous functions passed as callbacks — those are idiomatic
+            if (fn.type === 'arrow_function' || fn.type === 'function') {
+                const parent = fn.parent;
+                if (parent?.type === 'arguments' || parent?.type === 'call_expression' ||
+                    parent?.type === 'array' || parent?.type === 'pair') {
+                    continue;
+                }
+            }
+            // Try to get the function name for the message
+            let name = getFunctionName(fn);
+            if (!name && fn.parent?.type === 'variable_declarator') {
+                name = getFunctionName(fn.parent);
+            }
+            const label = name ? `Function '${name}'` : 'Function';
+            findings.push({
+                file: filePath,
+                line: fn.startPosition.row + 1,
+                column: fn.startPosition.column + 1,
+                endLine: fn.endPosition.row + 1,
+                endColumn: fn.endPosition.column + 1,
+                rule: 'single-use-wrapper',
+                severity: 'warning',
+                message: `${label} only delegates to another function — consider inlining it`,
+            });
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=single-use-wrapper.js.map

package/dist/rules/single-use-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-use-wrapper.js","sourceRoot":"","sources":["../../src/rules/single-use-wrapper.ts"],"names":[],"mappings":"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"}

package/dist/rules/unnecessary-try-catch.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types';
+export declare const unnecessaryTryCatch: Rule;
+//# sourceMappingURL=unnecessary-try-catch.d.ts.map

package/dist/rules/unnecessary-try-catch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unnecessary-try-catch.d.ts","sourceRoot":"","sources":["../../src/rules/unnecessary-try-catch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,UAAU,CAAC;AA6D9C,eAAO,MAAM,mBAAmB,EAAE,IAyDjC,CAAC"}

package/dist/rules/unnecessary-try-catch.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unnecessaryTryCatch = void 0;
+const parser_1 = require("../parser");
+const THROWING_CALL_INDICATORS = new Set([
+    'fetch', 'require', 'import', 'eval',
+    'JSON.parse', 'JSON.stringify',
+    'parseInt', 'parseFloat',
+    'decodeURI', 'decodeURIComponent',
+    'atob', 'btoa',
+]);
+function isAwaitExpression(node) {
+    let found = false;
+    (0, parser_1.walkTree)(node, (n) => {
+        if (n.type === 'await_expression')
+            found = true;
+    });
+    return found;
+}
+function containsThrowStatement(node) {
+    let found = false;
+    (0, parser_1.walkTree)(node, (n) => {
+        if (n.type === 'throw_statement')
+            found = true;
+    });
+    return found;
+}
+function containsFunctionCall(node) {
+    let found = false;
+    (0, parser_1.walkTree)(node, (n) => {
+        if (n.type === 'call_expression')
+            found = true;
+    });
+    return found;
+}
+function isPropertyAccess(node) {
+    let found = false;
+    (0, parser_1.walkTree)(node, (n) => {
+        if (n.type === 'member_expression' || n.type === 'subscript_expression')
+            found = true;
+    });
+    return found;
+}
+function catchBlockOnlyRethrows(catchClause) {
+    const body = catchClause.childForFieldName('body');
+    if (!body)
+        return false;
+    const statements = body.namedChildren;
+    if (statements.length !== 1)
+        return false;
+    const stmt = statements[0];
+    if (stmt.type !== 'throw_statement')
+        return false;
+    const thrown = stmt.namedChildren[0];
+    if (!thrown)
+        return false;
+    const catchParam = catchClause.childForFieldName('parameter');
+    if (!catchParam)
+        return false;
+    return thrown.text === catchParam.text;
+}
+exports.unnecessaryTryCatch = {
+    name: 'unnecessary-try-catch',
+    description: 'Flags try-catch blocks that wrap code unlikely to throw',
+    severity: 'warning',
+    check(tree, source, filePath) {
+        const findings = [];
+        const tryStatements = (0, parser_1.findNodes)(tree.rootNode, 'try_statement');
+        for (const tryNode of tryStatements) {
+            const body = tryNode.childForFieldName('body');
+            const handler = tryNode.childForFieldName('handler');
+            if (!body || !handler)
+                continue;
+            // If catch block only rethrows, that's always useless
+            if (catchBlockOnlyRethrows(handler)) {
+                findings.push({
+                    file: filePath,
+                    line: tryNode.startPosition.row + 1,
+                    column: tryNode.startPosition.column + 1,
+                    endLine: tryNode.endPosition.row + 1,
+                    endColumn: tryNode.endPosition.column + 1,
+                    rule: 'unnecessary-try-catch',
+                    severity: 'warning',
+                    message: 'try-catch block catches an error only to rethrow it unchanged',
+                });
+                continue;
+            }
+            // Skip if the try body contains await (async operations can throw)
+            if (isAwaitExpression(body))
+                continue;
+            // Skip if try body contains throw statements
+            if (containsThrowStatement(body))
+                continue;
+            // Skip if try body contains function calls (they might throw)
+            if (containsFunctionCall(body))
+                continue;
+            // Skip if try body contains property access (might throw on null/undefined)
+            if (isPropertyAccess(body))
+                continue;
+            // If we get here, the try body only contains assignments, returns of
+            // literals/variables, or other purely synchronous non-throwing ops
+            findings.push({
+                file: filePath,
+                line: tryNode.startPosition.row + 1,
+                column: tryNode.startPosition.column + 1,
+                endLine: tryNode.endPosition.row + 1,
+                endColumn: tryNode.endPosition.column + 1,
+                rule: 'unnecessary-try-catch',
+                severity: 'warning',
+                message: 'try-catch wraps code that is unlikely to throw — consider removing the try-catch',
+            });
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=unnecessary-try-catch.js.map

package/dist/rules/unnecessary-try-catch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unnecessary-try-catch.js","sourceRoot":"","sources":["../../src/rules/unnecessary-try-catch.ts"],"names":[],"mappings":"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"}

package/dist/rules/unused-imports.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types';
+export declare const unusedImports: Rule;
+//# sourceMappingURL=unused-imports.d.ts.map

package/dist/rules/unused-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-imports.d.ts","sourceRoot":"","sources":["../../src/rules/unused-imports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,UAAU,CAAC;AAuE9C,eAAO,MAAM,aAAa,EAAE,IAyC3B,CAAC"}

package/dist/rules/unused-imports.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unusedImports = void 0;
+const parser_1 = require("../parser");
+function getImportedNames(importNode) {
+    const names = [];
+    (0, parser_1.walkTree)(importNode, (node) => {
+        // import Foo from '...' (default import)
+        if (node.type === 'identifier' && node.parent?.type === 'import_clause') {
+            names.push({ name: node.text, node });
+        }
+        // import { Foo } from '...' or import { Foo as Bar } from '...'
+        if (node.type === 'import_specifier') {
+            const alias = node.childForFieldName('alias');
+            const nameNode = alias ?? node.childForFieldName('name');
+            if (nameNode) {
+                names.push({ name: nameNode.text, node: nameNode });
+            }
+        }
+        // import * as Foo from '...'
+        if (node.type === 'namespace_import') {
+            const nameNode = node.namedChildren.find((c) => c.type === 'identifier');
+            if (nameNode) {
+                names.push({ name: nameNode.text, node: nameNode });
+            }
+        }
+    });
+    return names;
+}
+function collectAllIdentifiers(root, excludeImports) {
+    const excludeSet = new Set(excludeImports.map((n) => n.id));
+    const identifiers = new Set();
+    (0, parser_1.walkTree)(root, (node) => {
+        if (node.type === 'identifier' || node.type === 'shorthand_property_identifier' ||
+            node.type === 'shorthand_property_identifier_pattern') {
+            // Skip nodes that are part of import declarations
+            let parent = node;
+            let isInImport = false;
+            while (parent) {
+                if (parent.type === 'import_statement' || parent.type === 'import_declaration') {
+                    isInImport = true;
+                    break;
+                }
+                parent = parent.parent;
+            }
+            if (!isInImport) {
+                identifiers.add(node.text);
+            }
+        }
+        // Also check type references for TypeScript
+        if (node.type === 'type_identifier') {
+            let parent = node;
+            let isInImport = false;
+            while (parent) {
+                if (parent.type === 'import_statement' || parent.type === 'import_declaration') {
+                    isInImport = true;
+                    break;
+                }
+                parent = parent.parent;
+            }
+            if (!isInImport) {
+                identifiers.add(node.text);
+            }
+        }
+    });
+    return identifiers;
+}
+exports.unusedImports = {
+    name: 'unused-imports',
+    description: 'Flags imported identifiers that are never used in the file',
+    severity: 'warning',
+    check(tree, source, filePath) {
+        const findings = [];
+        const importStatements = (0, parser_1.findNodes)(tree.rootNode, 'import_statement');
+        if (importStatements.length === 0)
+            return findings;
+        // Collect all identifiers used outside of imports
+        const usedIdentifiers = collectAllIdentifiers(tree.rootNode, importStatements);
+        for (const importStmt of importStatements) {
+            // Skip side-effect imports: import './foo' or import 'module'
+            const hasClause = importStmt.children.some((c) => c.type === 'import_clause');
+            if (!hasClause)
+                continue;
+            const importedNames = getImportedNames(importStmt);
+            for (const { name, node } of importedNames) {
+                if (!usedIdentifiers.has(name)) {
+                    findings.push({
+                        file: filePath,
+                        line: node.startPosition.row + 1,
+                        column: node.startPosition.column + 1,
+                        endLine: node.endPosition.row + 1,
+                        endColumn: node.endPosition.column + 1,
+                        rule: 'unused-imports',
+                        severity: 'warning',
+                        message: `'${name}' is imported but never used`,
+                    });
+                }
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=unused-imports.js.map

package/dist/rules/unused-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-imports.js","sourceRoot":"","sources":["../../src/rules/unused-imports.ts"],"names":[],"mappings":";;;AACA,sCAAgD;AAGhD,SAAS,gBAAgB,CAAC,UAA6B;IACrD,MAAM,KAAK,GAAqD,EAAE,CAAC;IAEnE,IAAA,iBAAQ,EAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;QAC5B,yCAAyC;QACzC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,eAAe,EAAE,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,gEAAgE;QAChE,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,6BAA6B;QAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;YACzE,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAuB,EAAE,cAAmC;IACzF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,IAAA,iBAAQ,EAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACtB,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,+BAA+B;YAC3E,IAAI,CAAC,IAAI,KAAK,uCAAuC,EAAE,CAAC;YAC1D,kDAAkD;YAClD,IAAI,MAAM,GAA6B,IAAI,CAAC;YAC5C,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,OAAO,MAAM,EAAE,CAAC;gBACd,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,IAAI,MAAM,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;oBAC/E,UAAU,GAAG,IAAI,CAAC;oBAClB,MAAM;gBACR,CAAC;gBACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,CAAC;YACD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,4CAA4C;QAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACpC,IAAI,MAAM,GAA6B,IAAI,CAAC;YAC5C,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,OAAO,MAAM,EAAE,CAAC;gBACd,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,IAAI,MAAM,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;oBAC/E,UAAU,GAAG,IAAI,CAAC;oBAClB,MAAM;gBACR,CAAC;gBACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,CAAC;YACD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC;AAEY,QAAA,aAAa,GAAS;IACjC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,4DAA4D;IACzE,QAAQ,EAAE,SAAS;IAEnB,KAAK,CAAC,IAAiB,EAAE,MAAc,EAAE,QAAgB;QACvD,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,MAAM,gBAAgB,GAAG,IAAA,kBAAS,EAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAEtE,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QAEnD,kDAAkD;QAClD,MAAM,eAAe,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAE/E,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC;YAC1C,8DAA8D;YAC9D,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAClC,CAAC;YACF,IAAI,CAAC,SAAS;gBAAE,SAAS;YAEzB,MAAM,aAAa,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAEnD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,EAAE,CAAC;gBAC3C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/B,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC;wBAChC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;wBACrC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC;wBACjC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;wBACtC,IAAI,EAAE,gBAAgB;wBACtB,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,IAAI,IAAI,8BAA8B;qBAChD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC"}

package/dist/rules/verbose-comments.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types';
+export declare const verboseComments: Rule;
+//# sourceMappingURL=verbose-comments.d.ts.map

package/dist/rules/verbose-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-comments.d.ts","sourceRoot":"","sources":["../../src/rules/verbose-comments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,UAAU,CAAC;AA8D9C,eAAO,MAAM,eAAe,EAAE,IAwC7B,CAAC"}

package/dist/rules/verbose-comments.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verboseComments = void 0;
+const parser_1 = require("../parser");
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9_$]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter((t) => t.length > 1);
+}
+function jaccardSimilarity(a, b) {
+    if (a.length === 0 || b.length === 0)
+        return 0;
+    const setA = new Set(a);
+    const setB = new Set(b);
+    let intersection = 0;
+    for (const item of setA) {
+        if (setB.has(item))
+            intersection++;
+    }
+    const union = new Set([...setA, ...setB]).size;
+    return union === 0 ? 0 : intersection / union;
+}
+function stripCommentSyntax(text) {
+    return text
+        .replace(/^\/\/\s*/, '')
+        .replace(/^\/\*+\s*/, '')
+        .replace(/\s*\*+\/$/, '')
+        .replace(/^\s*\*\s?/gm, '')
+        .trim();
+}
+function getNextSiblingCode(node) {
+    let sibling = node.nextNamedSibling;
+    // Skip over other comments
+    while (sibling && sibling.type === 'comment') {
+        sibling = sibling.nextNamedSibling;
+    }
+    if (!sibling)
+        return null;
+    // Get just the first line of the sibling code for comparison
+    const text = sibling.text;
+    const firstLine = text.split('\n')[0];
+    return firstLine || null;
+}
+const TRIVIAL_COMMENTS = new Set([
+    'todo', 'fixme', 'hack', 'note', 'bug', 'xxx',
+    'eslint-disable', 'eslint-enable', 'ts-ignore', 'ts-expect-error',
+    'prettier-ignore', 'istanbul ignore', 'c8 ignore',
+    '@ts-ignore', '@ts-expect-error', '@ts-nocheck',
+]);
+function isTrivialOrDirective(commentText) {
+    const lower = commentText.toLowerCase().trim();
+    for (const directive of TRIVIAL_COMMENTS) {
+        if (lower.startsWith(directive))
+            return true;
+    }
+    // Skip very short comments (likely meaningful labels)
+    if (lower.length < 10)
+        return true;
+    return false;
+}
+exports.verboseComments = {
+    name: 'verbose-comments',
+    description: 'Flags comments that restate the code they describe',
+    severity: 'info',
+    check(tree, source, filePath) {
+        const findings = [];
+        const comments = (0, parser_1.findNodes)(tree.rootNode, 'comment');
+        for (const comment of comments) {
+            const raw = stripCommentSyntax(comment.text);
+            if (isTrivialOrDirective(raw))
+                continue;
+            const nextCode = getNextSiblingCode(comment);
+            if (!nextCode)
+                continue;
+            const commentTokens = tokenize(raw);
+            const codeTokens = tokenize(nextCode);
+            if (commentTokens.length < 3)
+                continue;
+            const similarity = jaccardSimilarity(commentTokens, codeTokens);
+            // Only flag if >80% similar — very conservative threshold
+            if (similarity >= 0.8) {
+                findings.push({
+                    file: filePath,
+                    line: comment.startPosition.row + 1,
+                    column: comment.startPosition.column + 1,
+                    endLine: comment.endPosition.row + 1,
+                    endColumn: comment.endPosition.column + 1,
+                    rule: 'verbose-comments',
+                    severity: 'info',
+                    message: `Comment restates the code (${Math.round(similarity * 100)}% similar) — consider removing it`,
+                });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=verbose-comments.js.map