eslint-plugin-conventions 4.0.0

package/src/rules/conventions/expiring-todo-comments.js

@@ -0,0 +1,307 @@
+"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.expiringTodoComments = 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");
+const eslint_devkit_4 = require("@interlace/eslint-devkit");
+exports.expiringTodoComments = (0, eslint_devkit_1.createRule)({
+    name: 'expiring-todo-comments',
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Add expiration conditions to TODO comments to prevent forgotten tasks',
+        },
+        hasSuggestions: false,
+        messages: {
+            expiringTodoComment: (0, eslint_devkit_2.formatLLMMessage)({
+                icon: eslint_devkit_2.MessageIcons.WARNING,
+                issueName: 'Expiring TODO Comment',
+                description: 'TODO comment has expired condition',
+                severity: 'HIGH',
+                fix: 'Address the TODO or update/remove the condition',
+                documentationLink: 'https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/expiring-todo-comments.md',
+            }),
+            invalidTodoCondition: (0, eslint_devkit_2.formatLLMMessage)({
+                icon: eslint_devkit_2.MessageIcons.WARNING,
+                issueName: 'Invalid TODO Condition',
+                description: '{{term}} TODO comment has invalid condition format',
+                severity: 'MEDIUM',
+                fix: 'Fix the condition format or remove the condition',
+                documentationLink: 'https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/expiring-todo-comments.md',
+            }),
+            multipleTodoConditions: (0, eslint_devkit_2.formatLLMMessage)({
+                icon: eslint_devkit_2.MessageIcons.WARNING,
+                issueName: 'Multiple TODO Conditions',
+                description: 'TODO comment has multiple conditions',
+                severity: 'MEDIUM',
+                fix: 'Use only one condition per TODO comment',
+                documentationLink: 'https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/expiring-todo-comments.md',
+            }),
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    terms: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        default: ['TODO', 'FIXME', 'XXX'],
+                    },
+                    dateFormat: {
+                        type: 'string',
+                        default: 'YYYY-MM-DD',
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [
+        { terms: ['TODO', 'FIXME', 'XXX'], dateFormat: 'YYYY-MM-DD' },
+    ],
+    create(context) {
+        const [options] = context.options;
+        const { terms = ['TODO', 'FIXME', 'XXX'] } = options || {};
+        // Cache package.json data
+        let packageJson = null;
+        function loadPackageJson() {
+            if (packageJson !== null) {
+                return packageJson;
+            }
+            const packageJsonPath = (0, eslint_devkit_4.resolvePath)(process.cwd(), 'package.json');
+            packageJson = (0, eslint_devkit_3.readJsonFileSync)(packageJsonPath);
+            return packageJson;
+        }
+        function parseSemver(version) {
+            const match = version.match(/^(\d+)\.(\d+)\.(\d+)/);
+            if (!match)
+                return null;
+            return {
+                major: parseInt(match[1], 10),
+                minor: parseInt(match[2], 10),
+                patch: parseInt(match[3], 10),
+            };
+        }
+        function compareVersions(version1, version2) {
+            const v1 = parseSemver(version1);
+            const v2 = parseSemver(version2);
+            if (!v1 || !v2)
+                return 0;
+            if (v1.major !== v2.major)
+                return v1.major - v2.major;
+            if (v1.minor !== v2.minor)
+                return v1.minor - v2.minor;
+            return v1.patch - v2.patch;
+        }
+        function checkDateCondition(dateStr) {
+            try {
+                const conditionDate = new Date(dateStr + 'T00:00:00Z'); // UTC
+                const now = new Date();
+                return now >= conditionDate;
+            }
+            catch {
+                return false;
+            }
+        }
+        function checkPackageVersionCondition(operator, targetVersion) {
+            const pkg = loadPackageJson();
+            if (!pkg?.version)
+                return false;
+            const currentVersion = pkg.version;
+            const comparison = compareVersions(currentVersion, targetVersion);
+            switch (operator) {
+                case '>':
+                    return comparison > 0;
+                case '>=':
+                    return comparison >= 0;
+                case '<':
+                    return comparison < 0;
+                case '<=':
+                    return comparison <= 0;
+                case '=':
+                case '==':
+                    return comparison === 0;
+                default:
+                    return false;
+            }
+        }
+        function checkEngineVersionCondition(engine, operator, targetVersion) {
+            if (engine !== 'node')
+                return false;
+            const pkg = loadPackageJson();
+            const nodeVersion = pkg?.engines?.node;
+            if (!nodeVersion)
+                return false;
+            // Simple version comparison for engines
+            const currentVersion = nodeVersion.replace(/^[\^~>=<]+/, '');
+            const comparison = compareVersions(currentVersion, targetVersion);
+            switch (operator) {
+                case '>':
+                    return comparison > 0;
+                case '>=':
+                    return comparison >= 0;
+                case '<':
+                    return comparison < 0;
+                case '<=':
+                    return comparison <= 0;
+                default:
+                    return false;
+            }
+        }
+        function checkDependencyCondition(packageName, present) {
+            const pkg = loadPackageJson();
+            if (!pkg)
+                return false;
+            const allDeps = {
+                ...pkg.dependencies,
+                ...pkg.devDependencies,
+                ...pkg.peerDependencies,
+            };
+            const hasPackage = packageName in allDeps;
+            return present ? hasPackage : hasPackage;
+        }
+        function parseTodoCondition(commentValue, term) {
+            // Match patterns like: TODO [condition]: message
+            // or TODO (@author) [condition]: message
+            // Also handle block comments with * prefix: * TODO [condition]: message
+            const todoRegex = new RegExp(`\\*?\\s*${term}\\s*(?:\\([^)]+\\))?\\s*\\[([^\\]]+)\\]\\s*:\\s*(.+)$`, 'im');
+            const match = commentValue.match(todoRegex);
+            if (!match)
+                return null;
+            const conditionStr = match[1];
+            const rest = match[2];
+            // Split multiple conditions (shouldn't happen, but handle gracefully)
+            const conditions = conditionStr.split(/\s*,\s*/);
+            return { conditions, rest };
+        }
+        function validateCondition(condition) {
+            // Date condition: YYYY-MM-DD
+            if (/^\d{4}-\d{2}-\d{2}$/.test(condition)) {
+                return { type: 'date', value: condition };
+            }
+            // Package version condition: >=1.0.0, >2.0.0, etc.
+            const packageVersionMatch = condition.match(/^([><]=?|=|==)\s*([\d.]+)$/);
+            if (packageVersionMatch) {
+                return {
+                    type: 'package-version',
+                    operator: packageVersionMatch[1],
+                    value: packageVersionMatch[2],
+                };
+            }
+            // Engine version condition: engine:node@>=8, engine:node@>20.0.0
+            const engineVersionMatch = condition.match(/^engine:(\w+)@([><]=?)\s*([\d.]+)$/);
+            if (engineVersionMatch) {
+                const engine = engineVersionMatch[1];
+                // Validate engine name
+                if (!['node', 'npm', 'yarn', 'pnpm'].includes(engine)) {
+                    return null; // Invalid engine, let it be caught as invalid condition
+                }
+                return {
+                    type: 'engine-version',
+                    value: `${engine}@${engineVersionMatch[3]}`,
+                    operator: engineVersionMatch[2],
+                };
+            }
+            // Dependency condition: +package-name or -package-name
+            const depMatch = condition.match(/^([+-])(.+)$/);
+            if (depMatch) {
+                return {
+                    type: 'dependency',
+                    value: depMatch[2],
+                    operator: depMatch[1],
+                };
+            }
+            return null;
+        }
+        function checkCondition(condition) {
+            const parsed = validateCondition(condition);
+            if (!parsed)
+                return false;
+            switch (parsed.type) {
+                case 'date':
+                    return checkDateCondition(parsed.value);
+                case 'package-version':
+                    return parsed.operator
+                        ? checkPackageVersionCondition(parsed.operator, parsed.value)
+                        : false;
+                case 'engine-version': {
+                    const [engine, version] = parsed.value.split('@');
+                    return parsed.operator
+                        ? checkEngineVersionCondition(engine, parsed.operator, version)
+                        : false;
+                }
+                case 'dependency':
+                    return checkDependencyCondition(parsed.value, parsed.operator === '+');
+                default:
+                    return false;
+            }
+        }
+        function checkComment(comment) {
+            const commentValue = comment.value;
+            for (const term of terms) {
+                const parsed = parseTodoCondition(commentValue, term);
+                if (!parsed)
+                    continue;
+                const { conditions, rest } = parsed;
+                // Check for multiple conditions
+                if (conditions.length > 1) {
+                    context.report({
+                        loc: comment.loc,
+                        messageId: 'multipleTodoConditions',
+                        data: {
+                            term,
+                            conditions: conditions.join(', '),
+                        },
+                    });
+                    continue;
+                }
+                const condition = conditions[0];
+                // Validate condition format
+                const parsedCondition = validateCondition(condition);
+                if (!parsedCondition) {
+                    context.report({
+                        loc: comment.loc,
+                        messageId: 'invalidTodoCondition',
+                        data: {
+                            condition,
+                            term,
+                        },
+                    });
+                    continue;
+                }
+                // Check if condition has expired
+                if (checkCondition(condition)) {
+                    context.report({
+                        loc: comment.loc,
+                        messageId: 'expiringTodoComment',
+                        data: {
+                            term,
+                            condition,
+                            message: rest,
+                        },
+                    });
+                }
+                // Only process one term per comment
+                break;
+            }
+        }
+        return {
+            Program() {
+                const sourceCode = context.sourceCode;
+                const comments = sourceCode.getAllComments();
+                for (const comment of comments) {
+                    if (comment.type === 'Line' || comment.type === 'Block') {
+                        checkComment(comment);
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=expiring-todo-comments.js.map

package/src/rules/conventions/expiring-todo-comments.js.map

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

package/src/rules/conventions/filename-case.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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: filename-case
+ * Enforce filename case conventions
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+export type CaseType = 'camelCase' | 'kebabCase' | 'pascalCase' | 'snakeCase';
+export interface Options {
+    /** Case convention to enforce */
+    case?: CaseType;
+    /** List of patterns to ignore completely */
+    ignore?: (string | RegExp)[];
+    /** List of uppercase filenames to allow (without extension). Set to empty array to disable. */
+    allowedUppercaseFiles?: string[];
+    /** List of filenames allowed to use kebab-case regardless of the global case setting */
+    allowedKebabCase?: string[];
+    /** List of filenames allowed to use snake_case regardless of the global case setting */
+    allowedSnakeCase?: string[];
+    /** List of filenames allowed to use camelCase regardless of the global case setting */
+    allowedCamelCase?: string[];
+    /** List of filenames allowed to use PascalCase regardless of the global case setting */
+    allowedPascalCase?: string[];
+}
+type RuleOptions = [Options?];
+export declare const filenameCase: TSESLint.RuleModule<"filenameCase", RuleOptions, unknown, TSESLint.RuleListener> & {
+    name: string;
+};
+export {};

package/src/rules/conventions/filename-case.js

@@ -0,0 +1,264 @@
+"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.filenameCase = 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");
+/**
+ * Default uppercase filenames that are conventionally valid across all case conventions
+ */
+const DEFAULT_ALLOWED_UPPERCASE_FILES = [
+    'README',
+    'LICENSE',
+    'CHANGELOG',
+    'CONTRIBUTING',
+    'AUTHORS',
+    'COPYING',
+    'SECURITY',
+    'NOTICE',
+    'PATENTS',
+    'VERSION',
+];
+exports.filenameCase = (0, eslint_devkit_1.createRule)({
+    name: 'filename-case',
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Enforce filename case conventions for consistency',
+        },
+        hasSuggestions: true,
+        messages: {
+            filenameCase: (0, eslint_devkit_2.formatLLMMessage)({
+                icon: eslint_devkit_2.MessageIcons.WARNING,
+                issueName: 'Filename Case Convention',
+                description: 'Filename "{{current}}" violates {{case}} naming convention',
+                severity: 'MEDIUM',
+                fix: 'Rename file from "{{current}}" to "{{suggested}}" following {{case}} convention',
+                documentationLink: 'https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/filename-case.md',
+            }),
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    case: {
+                        type: 'string',
+                        enum: ['camelCase', 'kebabCase', 'pascalCase', 'snakeCase'],
+                        default: 'kebabCase',
+                    },
+                    ignore: {
+                        type: 'array',
+                        items: {
+                            anyOf: [
+                                { type: 'string' },
+                                { type: 'object' },
+                            ],
+                        },
+                        default: [],
+                    },
+                    allowedUppercaseFiles: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of uppercase filenames to allow (without extension). Defaults to common files like README, LICENSE, etc.',
+                    },
+                    allowedKebabCase: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of filenames allowed to use kebab-case regardless of the global case setting.',
+                        default: [],
+                    },
+                    allowedSnakeCase: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of filenames allowed to use snake_case regardless of the global case setting.',
+                        default: [],
+                    },
+                    allowedCamelCase: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of filenames allowed to use camelCase regardless of the global case setting.',
+                        default: [],
+                    },
+                    allowedPascalCase: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of filenames allowed to use PascalCase regardless of the global case setting.',
+                        default: [],
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [{
+            case: 'kebabCase',
+            ignore: [],
+            allowedUppercaseFiles: DEFAULT_ALLOWED_UPPERCASE_FILES,
+            allowedKebabCase: [],
+            allowedSnakeCase: [],
+            allowedCamelCase: [],
+            allowedPascalCase: [],
+        }],
+    create(context) {
+        const [options] = context.options;
+        const { case: caseType = 'kebabCase', ignore = [], allowedUppercaseFiles = DEFAULT_ALLOWED_UPPERCASE_FILES, allowedKebabCase = [], allowedSnakeCase = [], allowedCamelCase = [], allowedPascalCase = [], } = options || {};
+        // Convert to different case formats
+        function toCamelCase(str) {
+            return str.replace(/[-_](.)/g, (_, letter) => letter.toUpperCase());
+        }
+        function toKebabCase(str) {
+            return str
+                .replace(/([a-z])([A-Z])/g, '$1-$2')
+                .replace(/[\s_]+/g, '-')
+                .toLowerCase();
+        }
+        function toPascalCase(str) {
+            const camel = toCamelCase(str);
+            return camel.charAt(0).toUpperCase() + camel.slice(1);
+        }
+        function toSnakeCase(str) {
+            return str
+                .replace(/([a-z])([A-Z])/g, '$1_$2')
+                .replace(/[\s-]+/g, '_')
+                .toLowerCase();
+        }
+        // Check if filename matches the expected case pattern
+        function isCamelCase(str) {
+            // camelCase: starts with lowercase, no separators, can have uppercase after first char
+            return /^[a-z][a-zA-Z0-9]*$/.test(str);
+        }
+        function isKebabCase(str) {
+            // kebab-case: all lowercase with hyphens as separators
+            return /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(str);
+        }
+        function isPascalCase(str) {
+            // PascalCase: starts with uppercase, no separators
+            return /^[A-Z][a-zA-Z0-9]*$/.test(str);
+        }
+        function isSnakeCase(str) {
+            // snake_case: all lowercase with underscores as separators
+            return /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(str);
+        }
+        function matchesCase(str, expectedCase) {
+            switch (expectedCase) {
+                case 'camelCase':
+                    return isCamelCase(str);
+                case 'kebabCase':
+                    return isKebabCase(str);
+                case 'pascalCase':
+                    return isPascalCase(str);
+                case 'snakeCase':
+                    return isSnakeCase(str);
+                default:
+                    return true;
+            }
+        }
+        // Generate suggested filename
+        function getSuggestedName(basename, nameWithoutExt, targetCase) {
+            let transformed;
+            switch (targetCase) {
+                case 'camelCase':
+                    transformed = toCamelCase(nameWithoutExt);
+                    break;
+                case 'kebabCase':
+                    transformed = toKebabCase(nameWithoutExt);
+                    break;
+                case 'pascalCase':
+                    transformed = toPascalCase(nameWithoutExt);
+                    break;
+                case 'snakeCase':
+                    transformed = toSnakeCase(nameWithoutExt);
+                    break;
+                default:
+                    transformed = nameWithoutExt;
+            }
+            // Add back the extension
+            const ext = basename.slice(nameWithoutExt.length);
+            return transformed + ext;
+        }
+        return {
+            Program(node) {
+                // Get filename from context
+                const filename = context.getFilename();
+                if (!filename) {
+                    return;
+                }
+                // Get just the filename part (without directory)
+                const basename = (0, eslint_devkit_3.getBasename)(filename);
+                // Remove all extensions for checking (handles .spec.ts, .test.tsx, etc.)
+                const nameWithoutExt = basename.replace(/(\.(spec|test|stories|story|e2e|d))*\.[^.]+$/, '');
+                // Skip if no name part (e.g., just extension or dotfile)
+                if (!nameWithoutExt) {
+                    return;
+                }
+                // Check if filename should be ignored
+                for (const ignorePattern of ignore) {
+                    if (typeof ignorePattern === 'string') {
+                        if (basename === ignorePattern) {
+                            return;
+                        }
+                    }
+                    else if (ignorePattern instanceof RegExp) {
+                        if (ignorePattern.test(basename)) {
+                            return;
+                        }
+                    }
+                }
+                // Skip allowed uppercase files (README, LICENSE, etc.) as they are conventionally valid
+                if (allowedUppercaseFiles.includes(nameWithoutExt)) {
+                    return;
+                }
+                // Skip dotfiles (.eslintrc, .gitignore, etc.)
+                if (basename.startsWith('.')) {
+                    return;
+                }
+                // Check if filename is allowed via case-specific overrides
+                // These allow specific files to use a different case than the global setting
+                if (allowedKebabCase.includes(nameWithoutExt) && matchesCase(nameWithoutExt, 'kebabCase')) {
+                    return;
+                }
+                if (allowedSnakeCase.includes(nameWithoutExt) && matchesCase(nameWithoutExt, 'snakeCase')) {
+                    return;
+                }
+                if (allowedCamelCase.includes(nameWithoutExt) && matchesCase(nameWithoutExt, 'camelCase')) {
+                    return;
+                }
+                if (allowedPascalCase.includes(nameWithoutExt) && matchesCase(nameWithoutExt, 'pascalCase')) {
+                    return;
+                }
+                // Check if filename matches the expected case
+                if (!matchesCase(nameWithoutExt, caseType)) {
+                    const suggestedName = getSuggestedName(basename, nameWithoutExt, caseType);
+                    context.report({
+                        node, // Report on the Program node
+                        messageId: 'filenameCase',
+                        data: {
+                            case: caseType,
+                            current: basename,
+                            suggested: suggestedName,
+                        },
+                        suggest: [
+                            {
+                                messageId: 'filenameCase',
+                                data: {
+                                    suggestedName,
+                                },
+                                fix() {
+                                    // This is a file rename operation that can't be auto-fixed
+                                    // Just provide the suggestion
+                                    return null;
+                                },
+                            },
+                        ],
+                    });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=filename-case.js.map

package/src/rules/conventions/filename-case.js.map

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

package/src/rules/conventions/no-commented-code.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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-commented-code
+ * Detects commented-out code blocks
+ *
+ * @see https://rules.sonarsource.com/javascript/RSPEC-125/
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+type MessageIds = 'commentedCode' | 'removeCode' | 'useVersionControl';
+export interface Options {
+    /** Ignore single-line comments. Default: false */
+    ignoreSingleLine?: boolean;
+    /** Ignore comments in test files. Default: true */
+    ignoreInTests?: boolean;
+    /** Minimum lines of commented code to trigger. Default: 1 */
+    minLines?: number;
+}
+type RuleOptions = [Options?];
+export declare const noCommentedCode: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
+    name: string;
+};
+export {};