eslint-plugin-conventions 4.0.0

package/src/rules/conventions/no-commented-code.js

@@ -0,0 +1,278 @@
+"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.noCommentedCode = void 0;
+const eslint_devkit_1 = require("@interlace/eslint-devkit");
+const eslint_devkit_2 = require("@interlace/eslint-devkit");
+/**
+ * Check if a comment block contains code-like patterns
+ */
+function looksLikeCode(comment, isBlockComment) {
+    // Remove comment markers for pattern matching
+    let text = comment;
+    if (isBlockComment) {
+        // Remove /* and */ markers and any leading * on each line
+        text = text.replace(/^\s*\/\*+/, '').replace(/\*+\/\s*$/, '');
+        // Remove leading * from each line in block comments
+        text = text
+            .split('\n')
+            .map((line) => line.replace(/^\s*\*+\s*/, ''))
+            .join('\n');
+    }
+    else {
+        // Remove // markers
+        text = text
+            .split('\n')
+            .map((line) => line.replace(/^\s*\/\/+\s*/, ''))
+            .join('\n');
+    }
+    // Split into lines and check each line
+    const lines = text
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    if (lines.length === 0) {
+        return false;
+    }
+    const codePatterns = [
+        /^(const|let|var|function|class|if|for|while|return|import|export)\s+/,
+        /^[a-zA-Z_$][a-zA-Z0-9_$]*\s*[=:]\s*/,
+        /^[a-zA-Z_$][a-zA-Z0-9_$]*\s*\(/,
+        /^[{}[\]]/,
+    ];
+    // Count how many lines look like code
+    let codeLikeLines = 0;
+    // Check if any line looks like code (but not a TODO comment)
+    for (const line of lines) {
+        // Skip TODO/FIXME comments
+        if (/^(TODO|FIXME|HACK|XXX)/i.test(line)) {
+            continue;
+        }
+        // Check if line matches code patterns
+        for (const pattern of codePatterns) {
+            if (pattern.test(line)) {
+                codeLikeLines++;
+                break; // Count each line only once
+            }
+        }
+    }
+    // Consider it code if at least one line looks like code
+    return codeLikeLines > 0;
+}
+/**
+ * Count lines in a comment
+ * For single-line comments, the value doesn't include newlines, so we count 1
+ * For multi-line comments, we count the newlines in the value + 1
+ */
+function countCommentLines(comment) {
+    if (!comment)
+        return 0;
+    const newlineCount = (comment.match(/\n/g) || []).length;
+    // If there are newlines, it's a multi-line comment (newlineCount + 1 lines)
+    // If no newlines, it's a single-line comment (1 line)
+    return newlineCount > 0 ? newlineCount + 1 : 1;
+}
+exports.noCommentedCode = (0, eslint_devkit_2.createRule)({
+    name: 'no-commented-code',
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Detects commented-out code blocks',
+        },
+        hasSuggestions: true,
+        messages: {
+            commentedCode: (0, eslint_devkit_1.formatLLMMessage)({
+                icon: eslint_devkit_1.MessageIcons.WARNING,
+                issueName: 'Commented code',
+                description: 'Commented-out code detected ({{lines}} lines)',
+                severity: 'LOW',
+                fix: 'Remove commented code or use version control for history',
+                documentationLink: 'https://rules.sonarsource.com/javascript/RSPEC-125/',
+            }),
+            removeCode: (0, eslint_devkit_1.formatLLMMessage)({
+                icon: eslint_devkit_1.MessageIcons.INFO,
+                issueName: 'Remove Code',
+                description: 'Remove commented code block',
+                severity: 'LOW',
+                fix: 'Delete the commented code block',
+                documentationLink: 'https://rules.sonarsource.com/javascript/RSPEC-125/',
+            }),
+            useVersionControl: (0, eslint_devkit_1.formatLLMMessage)({
+                icon: eslint_devkit_1.MessageIcons.INFO,
+                issueName: 'Use Git',
+                description: 'Use version control for code history',
+                severity: 'LOW',
+                fix: 'Delete commented code and use git history instead',
+                documentationLink: 'https://git-scm.com/docs/git-log',
+            }),
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    ignoreSingleLine: {
+                        type: 'boolean',
+                        default: false,
+                        description: 'Ignore single-line comments',
+                    },
+                    ignoreInTests: {
+                        type: 'boolean',
+                        default: true,
+                        description: 'Ignore comments in test files',
+                    },
+                    minLines: {
+                        type: 'number',
+                        default: 1,
+                        minimum: 1,
+                        description: 'Minimum lines of commented code to trigger',
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [
+        {
+            ignoreSingleLine: false,
+            ignoreInTests: true,
+            minLines: 1,
+        },
+    ],
+    create(context, [options = {}]) {
+        const { ignoreSingleLine = false, ignoreInTests = true, minLines = 1, } = options || {};
+        const filename = context.getFilename();
+        const isTestFile = ignoreInTests && /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filename);
+        if (isTestFile) {
+            return {};
+        }
+        const sourceCode = context.sourceCode || context.sourceCode;
+        /**
+         * Check comment nodes
+         */
+        function checkComment(node) {
+            try {
+                const commentText = node.value || '';
+                const isBlockComment = node.type === 'Block';
+                const lines = countCommentLines(commentText);
+                // Skip single-line comments if configured
+                if (ignoreSingleLine && lines === 1 && !isBlockComment) {
+                    return;
+                }
+                // Skip if below minimum lines
+                if (lines < minLines) {
+                    return;
+                }
+                // Check if it looks like code
+                if (looksLikeCode(commentText, isBlockComment)) {
+                    context.report({
+                        node,
+                        messageId: 'commentedCode',
+                        data: {
+                            lines: String(lines),
+                        },
+                        suggest: [
+                            {
+                                messageId: 'removeCode',
+                                fix: (fixer) => {
+                                    try {
+                                        // Remove the entire comment
+                                        return fixer.remove(node);
+                                    }
+                                    catch {
+                                        return null;
+                                    }
+                                },
+                            },
+                            {
+                                messageId: 'useVersionControl',
+                                fix: () => null,
+                            },
+                        ],
+                    });
+                }
+            }
+            catch {
+                // Silently skip if there's an error processing the comment
+                return;
+            }
+        }
+        return {
+            Program() {
+                const comments = sourceCode.getAllComments();
+                // Group consecutive comments that look like code
+                const groupedComments = [];
+                let currentGroup = [];
+                for (let i = 0; i < comments.length; i++) {
+                    const comment = comments[i];
+                    const commentText = comment.value || '';
+                    const isBlockComment = comment.type === 'Block';
+                    // Check if this comment looks like code
+                    if (looksLikeCode(commentText, isBlockComment)) {
+                        currentGroup.push(comment);
+                    }
+                    else {
+                        // If current group has comments, add it to grouped comments
+                        if (currentGroup.length > 0) {
+                            groupedComments.push([...currentGroup]);
+                            currentGroup = [];
+                        }
+                    }
+                }
+                // Handle any remaining group
+                if (currentGroup.length > 0) {
+                    groupedComments.push(currentGroup);
+                }
+                // Process each group
+                groupedComments.forEach((group) => {
+                    if (group.length === 1) {
+                        // Single comment - use the standard checkComment function
+                        checkComment(group[0]);
+                    }
+                    else {
+                        // Multiple consecutive comments - report as one error
+                        const firstComment = group[0];
+                        const totalLines = group.reduce((sum, comment) => {
+                            const commentText = comment.value || '';
+                            return sum + countCommentLines(commentText);
+                        }, 0);
+                        if (totalLines >= minLines) {
+                            context.report({
+                                node: firstComment,
+                                messageId: 'commentedCode',
+                                data: {
+                                    lines: String(totalLines),
+                                },
+                                suggest: [
+                                    {
+                                        messageId: 'removeCode',
+                                        fix: (fixer) => {
+                                            try {
+                                                // Remove the entire range of consecutive comments
+                                                return fixer.removeRange([
+                                                    group[0].range[0],
+                                                    group[group.length - 1].range[1],
+                                                ]);
+                                            }
+                                            catch {
+                                                return null;
+                                            }
+                                        },
+                                    },
+                                    {
+                                        messageId: 'useVersionControl',
+                                        fix: () => null,
+                                    },
+                                ],
+                            });
+                        }
+                    }
+                });
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-commented-code.js.map

package/src/rules/conventions/no-commented-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-commented-code.js","sourceRoot":"","sources":["../../../../../../packages/eslint-plugin-conventions/src/rules/conventions/no-commented-code.ts"],"names":[],"mappings":"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"}

package/src/rules/conventions/no-console-spaces.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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-console-spaces
+ * Prevent leading/trailing space between console.log parameters
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+export declare const noConsoleSpaces: TSESLint.RuleModule<"noConsoleSpaces", [], unknown, TSESLint.RuleListener> & {
+    name: string;
+};

package/src/rules/conventions/no-console-spaces.js

@@ -0,0 +1,128 @@
+"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.noConsoleSpaces = void 0;
+const eslint_devkit_1 = require("@interlace/eslint-devkit");
+const eslint_devkit_2 = require("@interlace/eslint-devkit");
+exports.noConsoleSpaces = (0, eslint_devkit_1.createRule)({
+    name: 'no-console-spaces',
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Prevent leading/trailing space between console.log parameters',
+        },
+        fixable: 'code',
+        hasSuggestions: true,
+        messages: {
+            noConsoleSpaces: (0, eslint_devkit_2.formatLLMMessage)({
+                icon: eslint_devkit_2.MessageIcons.WARNING,
+                issueName: 'Console Spaces',
+                description: 'Remove leading/trailing spaces in console method parameters',
+                severity: 'MEDIUM',
+                fix: 'Remove spaces from console method arguments',
+                documentationLink: 'https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-console-spaces.md',
+            }),
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        // Console methods that join parameters with spaces
+        const consoleMethods = new Set([
+            'log',
+            'debug',
+            'info',
+            'warn',
+            'error',
+            'table',
+            'trace',
+            'group',
+            'groupCollapsed',
+        ]);
+        function isInAllowedContext() {
+            // For simplicity, we'll skip the allow option for now
+            return false;
+        }
+        function isConsoleMethodCall(node) {
+            // Check if this is a call to a console method
+            if (node.callee.type === 'MemberExpression' &&
+                node.callee.object.type === 'Identifier' &&
+                node.callee.object.name === 'console' &&
+                node.callee.property.type === 'Identifier' &&
+                consoleMethods.has(node.callee.property.name)) {
+                return true;
+            }
+            return false;
+        }
+        function getConsoleMethodName(node) {
+            // Safe extraction of console method name
+            if (node.callee.type === 'MemberExpression' &&
+                node.callee.property.type === 'Identifier') {
+                return node.callee.property.name;
+            }
+            return 'console';
+        }
+        function hasLeadingOrTrailingSpaces(text) {
+            // Check if string starts or ends with whitespace, but not if it's only whitespace
+            // Only flag if there's actual content with leading/trailing spaces
+            const trimmed = text.trim();
+            return trimmed.length > 0 && /^\s|\s$/.test(text);
+        }
+        function hasLeadingOrTrailingSpacesInTemplate(text) {
+            // For template literals, even whitespace-only quasis should be flagged
+            return /^\s|\s$/.test(text);
+        }
+        return {
+            CallExpression(node) {
+                if (isConsoleMethodCall(node) && !isInAllowedContext()) {
+                    // Check each argument for leading/trailing spaces
+                    for (const arg of node.arguments) {
+                        if (arg.type === 'Literal' && typeof arg.value === 'string') {
+                            if (hasLeadingOrTrailingSpaces(arg.value)) {
+                                context.report({
+                                    node: arg,
+                                    messageId: 'noConsoleSpaces',
+                                    data: {
+                                        method: getConsoleMethodName(node),
+                                        arg: arg.value,
+                                    },
+                                    fix(fixer) {
+                                        const trimmed = arg.value.trim();
+                                        return fixer.replaceText(arg, `'${trimmed}'`);
+                                    },
+                                });
+                            }
+                        }
+                        else if (arg.type === 'TemplateLiteral') {
+                            // Check template literal quasi values for leading/trailing spaces
+                            let hasSpacesInTemplate = false;
+                            for (const quasi of arg.quasis) {
+                                if (hasLeadingOrTrailingSpacesInTemplate(quasi.value.raw)) {
+                                    hasSpacesInTemplate = true;
+                                    break;
+                                }
+                            }
+                            if (hasSpacesInTemplate) {
+                                context.report({
+                                    node: arg,
+                                    messageId: 'noConsoleSpaces',
+                                    data: {
+                                        method: getConsoleMethodName(node),
+                                        arg: 'template literal with spaces',
+                                    },
+                                    // Template literals are harder to fix automatically
+                                    fix: null,
+                                });
+                            }
+                        }
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-console-spaces.js.map

package/src/rules/conventions/no-console-spaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-console-spaces.js","sourceRoot":"","sources":["../../../../../../packages/eslint-plugin-conventions/src/rules/conventions/no-console-spaces.ts"],"names":[],"mappings":"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"}

package/src/rules/conventions/prefer-code-point.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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: prefer-code-point
+ * Prefer codePointAt over charCodeAt for proper Unicode handling
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+export declare const preferCodePoint: TSESLint.RuleModule<"preferCodePoint", [], unknown, TSESLint.RuleListener> & {
+    name: string;
+};

package/src/rules/conventions/prefer-code-point.js

@@ -0,0 +1,95 @@
+"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.preferCodePoint = void 0;
+const eslint_devkit_1 = require("@interlace/eslint-devkit");
+const eslint_devkit_2 = require("@interlace/eslint-devkit");
+exports.preferCodePoint = (0, eslint_devkit_1.createRule)({
+    name: 'prefer-code-point',
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Prefer codePointAt over charCodeAt for proper Unicode character handling',
+        },
+        messages: {
+            preferCodePoint: (0, eslint_devkit_2.formatLLMMessage)({
+                icon: eslint_devkit_2.MessageIcons.WARNING,
+                issueName: 'Prefer codePointAt',
+                description: 'Use codePointAt instead of charCodeAt for Unicode safety',
+                severity: 'MEDIUM',
+                fix: 'Replace charCodeAt() with codePointAt()',
+                documentationLink: 'https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-code-point.md',
+            }),
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {},
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [],
+    create(context) {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        function isInAllowedContext(node) {
+            // For simplicity, we'll skip the allow option for now
+            // This would require more complex logic to check comments/code context
+            return false;
+        }
+        function shouldIgnoreCall(node) {
+            // The unicorn rule flags ALL charCodeAt calls, but allows some contexts
+            if (node.callee.type === 'MemberExpression') {
+                // Allow optional chaining
+                if (node.callee.optional) {
+                    return true;
+                }
+                // Allow computed property access where the property is a variable (not literal)
+                // This means obj[method] is ignored, but obj['charCodeAt'] is still flagged
+                if (node.callee.computed &&
+                    node.callee.property.type === 'Identifier') {
+                    return true;
+                }
+            }
+            return false;
+        }
+        function isCharCodeAtCall(node) {
+            // Check if this is a call to charCodeAt method
+            if (node.callee.type === 'MemberExpression') {
+                // Direct property access: obj.charCodeAt
+                if (node.callee.property.type === 'Identifier' &&
+                    node.callee.property.name === 'charCodeAt') {
+                    return true;
+                }
+                // Computed property access: obj['charCodeAt']
+                if (node.callee.computed &&
+                    node.callee.property.type === 'Literal' &&
+                    node.callee.property.value === 'charCodeAt') {
+                    return true;
+                }
+            }
+            return false;
+        }
+        return {
+            CallExpression(node) {
+                if (isCharCodeAtCall(node) &&
+                    !isInAllowedContext(node) &&
+                    !shouldIgnoreCall(node)) {
+                    context.report({
+                        node,
+                        messageId: 'preferCodePoint',
+                        data: {
+                            current: 'charCodeAt()',
+                            fix: 'codePointAt()',
+                        },
+                    });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=prefer-code-point.js.map

package/src/rules/conventions/prefer-code-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-code-point.js","sourceRoot":"","sources":["../../../../../../packages/eslint-plugin-conventions/src/rules/conventions/prefer-code-point.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAOH,4DAAsD;AACtD,4DAA0E;AAM7D,QAAA,eAAe,GAAG,IAAA,0BAAU,EAA0B;IACjE,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,0EAA0E;SAC7E;QACD,QAAQ,EAAE;YACR,eAAe,EAAE,IAAA,gCAAgB,EAAC;gBAChC,IAAI,EAAE,4BAAY,CAAC,OAAO;gBAC1B,SAAS,EAAE,oBAAoB;gBAC/B,WAAW,EAAE,0DAA0D;gBACvE,QAAQ,EAAE,QAAQ;gBAClB,GAAG,EAAE,yCAAyC;gBAC9C,iBAAiB,EACf,iGAAiG;aACpG,CAAC;SACH;QACD,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;gBACd,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;IACD,cAAc,EAAE,EAAE;IAElB,MAAM,CAAC,OAAsD;QAC3D,6DAA6D;QAC7D,SAAS,kBAAkB,CAAC,IAA6B;YACvD,sDAAsD;YACtD,uEAAuE;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,SAAS,gBAAgB,CAAC,IAA6B;YACrD,wEAAwE;YAExE,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC5C,0BAA0B;gBAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACzB,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,gFAAgF;gBAChF,4EAA4E;gBAC5E,IACE,IAAI,CAAC,MAAM,CAAC,QAAQ;oBACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,EAC1C,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;QAED,SAAS,gBAAgB,CAAC,IAA6B;YACrD,+CAA+C;YAC/C,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC5C,yCAAyC;gBACzC,IACE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;oBAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,EAC1C,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,8CAA8C;gBAC9C,IACE,IAAI,CAAC,MAAM,CAAC,QAAQ;oBACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS;oBACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAK,YAAY,EAC3C,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO;YACL,cAAc,CAAC,IAA6B;gBAC1C,IACE,gBAAgB,CAAC,IAAI,CAAC;oBACtB,CAAC,kBAAkB,CAAC,IAAI,CAAC;oBACzB,CAAC,gBAAgB,CAAC,IAAI,CAAC,EACvB,CAAC;oBACD,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI;wBACJ,SAAS,EAAE,iBAAiB;wBAC5B,IAAI,EAAE;4BACJ,OAAO,EAAE,cAAc;4BACvB,GAAG,EAAE,eAAe;yBACrB;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/src/rules/conventions/prefer-dependency-version-strategy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ */
+/**
+ * prefer-dependency-version-strategy
+ *
+ * Enforces a consistent version strategy (caret, tilde, exact, etc.) for package.json dependencies.
+ * Works alongside @nx/dependency-checks to ensure both version alignment and strategy consistency.
+ *
+ * This rule is designed to complement @nx/dependency-checks, which validates that dependencies
+ * match the lockfile. This rule ensures the version specifier format is consistent.
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+type VersionStrategy = 'caret' | 'tilde' | 'exact' | 'range' | 'any';
+export interface Options {
+    strategy?: VersionStrategy;
+    allowWorkspace?: boolean;
+    allowFile?: boolean;
+    allowLink?: boolean;
+    overrides?: Record<string, VersionStrategy>;
+}
+type RuleOptions = [Options?];
+type MessageIds = 'preferStrategy' | 'invalidStrategy';
+export declare const preferDependencyVersionStrategy: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
+    name: string;
+};
+export {};