npm - eslint-plugin-conventions - Versions diffs - 4.0.0 - Mend

eslint-plugin-conventions 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (35) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,80 @@
+<p align="center">
+  <a href="https://eslint.interlace.tools" target="blank"><img src="https://eslint.interlace.tools/eslint-interlace-logo-light.svg" alt="ESLint Interlace Logo" width="120" /></a>
+</p>
+<p align="center">
+  Code conventions and style enforcement for JavaScript/TypeScript teams.
+</p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/eslint-plugin-conventions" target="_blank"><img src="https://img.shields.io/npm/v/eslint-plugin-conventions.svg" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/eslint-plugin-conventions" target="_blank"><img src="https://img.shields.io/npm/dm/eslint-plugin-conventions.svg" alt="NPM Downloads" /></a>
+  <a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="Package License" /></a>
+</p>
+## Description
+This plugin enforces consistent code conventions and style patterns across JavaScript and TypeScript projects. It helps teams maintain clean, readable, and maintainable codebases by detecting commented-out code, expired TODOs, deprecated API usage, and inconsistent naming patterns.
+## Philosophy
+**Interlace** fosters **strength through integration**. We believe conventions should be enforced automatically, not debated endlessly. These rules capture best practices from top engineering teams and enforce them consistently across your codebase.
+## Getting Started
+- To check out the [guide](https://eslint.interlace.tools/docs/conventions), visit [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+```bash
+npm install eslint-plugin-conventions --save-dev
+```
+## ⚙️ Configuration Presets
+| Preset        | Description                         |
+| :------------ | :---------------------------------- |
+| `recommended` | Balanced conventions for most teams |
+---
+## 🏢 Usage Example
+```js
+// eslint.config.js
+import conventions from 'eslint-plugin-conventions';
+export default [conventions.configs.recommended];
+```
+---
+## Rules
+| Rule                                                                                     | Description                                               | 💼  | ⚠️  |
+| :--------------------------------------------------------------------------------------- | :-------------------------------------------------------- | :-: | :-: |
+| [no-commented-code](./docs/rules/no-commented-code.md)                                   | Disallow commented-out code blocks                        | 💼  | ⚠️  |
+| [expiring-todo-comments](./docs/rules/expiring-todo-comments.md)                         | Enforce expiration dates on TODO comments                 | 💼  | ⚠️  |
+| [prefer-code-point](./docs/rules/prefer-code-point.md)                                   | Prefer `codePointAt` over `charCodeAt` for Unicode safety |     |     |
+| [prefer-dom-node-text-content](./docs/rules/prefer-dom-node-text-content.md)             | Prefer `textContent` over `innerText` for performance     |     |     |
+| [no-console-spaces](./docs/rules/no-console-spaces.md)                                   | Disallow leading/trailing spaces in console calls         |     |     |
+| [no-deprecated-api](./docs/rules/no-deprecated-api.md)                                   | Disallow usage of deprecated Node.js APIs                 | 💼  | ⚠️  |
+| [prefer-dependency-version-strategy](./docs/rules/prefer-dependency-version-strategy.md) | Enforce consistent version strategies in package.json     |     |     |
+| [filename-case](./docs/rules/filename-case.md)                                           | Enforce consistent file naming conventions                |     |     |
+| [consistent-existence-index-check](./docs/rules/consistent-existence-index-check.md)     | Enforce consistent array index existence checks           |     |     |
+**Legend**: 💼 Recommended | ⚠️ Warns (not error)
+---
+## 🔗 Related ESLint Plugins
+Part of the **Interlace ESLint Ecosystem** — AI-native quality plugins with LLM-optimized error messages:
+| Plugin                                                                                         | Description                         |
+| :--------------------------------------------------------------------------------------------- | :---------------------------------- |
+| [`eslint-plugin-maintainability`](https://www.npmjs.com/package/eslint-plugin-maintainability) | Cognitive complexity & code quality |
+| [`eslint-plugin-reliability`](https://www.npmjs.com/package/eslint-plugin-reliability)         | Error handling & null safety        |
+| [`eslint-plugin-operability`](https://www.npmjs.com/package/eslint-plugin-operability)         | Production readiness & debug code   |
+## 📄 License
+MIT © [Ofri Peretz](https://github.com/ofri-peretz)

package/package.json ADDED Viewed

@@ -0,0 +1,55 @@
+{
+  "name": "eslint-plugin-conventions",
+  "version": "4.0.0",
+  "description": "ESLint rules for team-specific disciplinary patterns and code conventions.",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "author": "Ofri Peretz <ofriperetzdev@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "eslint",
+    "eslint-plugin",
+    "interlace-quality",
+    "conventions",
+    "clean-code",
+    "consistency",
+    "llm-optimized"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0",
+    "@interlace/eslint-devkit": "*"
+  },
+  "devDependencies": {
+    "@typescript-eslint/parser": "^8.46.2",
+    "@typescript-eslint/rule-tester": "^8.46.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ofri-peretz/eslint",
+    "directory": "packages/eslint-plugin-conventions"
+  },
+  "homepage": "https://github.com/ofri-peretz/eslint/tree/main/packages/eslint-plugin-conventions#readme",
+  "bugs": {
+    "url": "https://github.com/ofri-peretz/eslint/issues"
+  }
+}

package/src/index.d.ts ADDED Viewed

@@ -0,0 +1,198 @@
+/**
+ * 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.
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+export declare const rules: {
+    'no-commented-code': TSESLint.RuleModule<"commentedCode" | "removeCode" | "useVersionControl", [(import("./rules/conventions/no-commented-code").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'expiring-todo-comments': TSESLint.RuleModule<"expiringTodoComment" | "invalidTodoCondition" | "multipleTodoConditions", [(import("./rules/conventions/expiring-todo-comments").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'prefer-code-point': TSESLint.RuleModule<"preferCodePoint", [], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'prefer-dom-node-text-content': TSESLint.RuleModule<"preferDomNodeTextContent", [], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'no-console-spaces': TSESLint.RuleModule<"noConsoleSpaces", [], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'no-deprecated-api': TSESLint.RuleModule<"deprecatedAPI" | "useReplacement", [(import("./rules/deprecation/no-deprecated-api").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'prefer-dependency-version-strategy': TSESLint.RuleModule<"preferStrategy" | "invalidStrategy", [(import("./rules/conventions/prefer-dependency-version-strategy").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'filename-case': TSESLint.RuleModule<"filenameCase", [(import("./rules/conventions/filename-case").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'consistent-existence-index-check': TSESLint.RuleModule<"consistentExistenceCheck", [(import("./rules/conventions/consistent-existence-index-check").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'conventions/no-commented-code': TSESLint.RuleModule<"commentedCode" | "removeCode" | "useVersionControl", [(import("./rules/conventions/no-commented-code").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'conventions/expiring-todo-comments': TSESLint.RuleModule<"expiringTodoComment" | "invalidTodoCondition" | "multipleTodoConditions", [(import("./rules/conventions/expiring-todo-comments").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'conventions/prefer-code-point': TSESLint.RuleModule<"preferCodePoint", [], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'conventions/prefer-dom-node-text-content': TSESLint.RuleModule<"preferDomNodeTextContent", [], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'conventions/no-console-spaces': TSESLint.RuleModule<"noConsoleSpaces", [], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'deprecation/no-deprecated-api': TSESLint.RuleModule<"deprecatedAPI" | "useReplacement", [(import("./rules/deprecation/no-deprecated-api").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'conventions/prefer-dependency-version-strategy': TSESLint.RuleModule<"preferStrategy" | "invalidStrategy", [(import("./rules/conventions/prefer-dependency-version-strategy").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'conventions/filename-case': TSESLint.RuleModule<"filenameCase", [(import("./rules/conventions/filename-case").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    'conventions/consistent-existence-index-check': TSESLint.RuleModule<"consistentExistenceCheck", [(import("./rules/conventions/consistent-existence-index-check").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+};
+export declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: {
+        'no-commented-code': TSESLint.RuleModule<"commentedCode" | "removeCode" | "useVersionControl", [(import("./rules/conventions/no-commented-code").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'expiring-todo-comments': TSESLint.RuleModule<"expiringTodoComment" | "invalidTodoCondition" | "multipleTodoConditions", [(import("./rules/conventions/expiring-todo-comments").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'prefer-code-point': TSESLint.RuleModule<"preferCodePoint", [], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'prefer-dom-node-text-content': TSESLint.RuleModule<"preferDomNodeTextContent", [], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'no-console-spaces': TSESLint.RuleModule<"noConsoleSpaces", [], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'no-deprecated-api': TSESLint.RuleModule<"deprecatedAPI" | "useReplacement", [(import("./rules/deprecation/no-deprecated-api").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'prefer-dependency-version-strategy': TSESLint.RuleModule<"preferStrategy" | "invalidStrategy", [(import("./rules/conventions/prefer-dependency-version-strategy").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'filename-case': TSESLint.RuleModule<"filenameCase", [(import("./rules/conventions/filename-case").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'consistent-existence-index-check': TSESLint.RuleModule<"consistentExistenceCheck", [(import("./rules/conventions/consistent-existence-index-check").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'conventions/no-commented-code': TSESLint.RuleModule<"commentedCode" | "removeCode" | "useVersionControl", [(import("./rules/conventions/no-commented-code").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'conventions/expiring-todo-comments': TSESLint.RuleModule<"expiringTodoComment" | "invalidTodoCondition" | "multipleTodoConditions", [(import("./rules/conventions/expiring-todo-comments").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'conventions/prefer-code-point': TSESLint.RuleModule<"preferCodePoint", [], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'conventions/prefer-dom-node-text-content': TSESLint.RuleModule<"preferDomNodeTextContent", [], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'conventions/no-console-spaces': TSESLint.RuleModule<"noConsoleSpaces", [], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'deprecation/no-deprecated-api': TSESLint.RuleModule<"deprecatedAPI" | "useReplacement", [(import("./rules/deprecation/no-deprecated-api").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'conventions/prefer-dependency-version-strategy': TSESLint.RuleModule<"preferStrategy" | "invalidStrategy", [(import("./rules/conventions/prefer-dependency-version-strategy").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'conventions/filename-case': TSESLint.RuleModule<"filenameCase", [(import("./rules/conventions/filename-case").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        'conventions/consistent-existence-index-check': TSESLint.RuleModule<"consistentExistenceCheck", [(import("./rules/conventions/consistent-existence-index-check").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+    };
+};
+export declare const configs: {
+    recommended: {
+        plugins: {
+            '@interlace/conventions': {
+                meta: {
+                    name: string;
+                    version: string;
+                };
+                rules: {
+                    'no-commented-code': TSESLint.RuleModule<"commentedCode" | "removeCode" | "useVersionControl", [(import("./rules/conventions/no-commented-code").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'expiring-todo-comments': TSESLint.RuleModule<"expiringTodoComment" | "invalidTodoCondition" | "multipleTodoConditions", [(import("./rules/conventions/expiring-todo-comments").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'prefer-code-point': TSESLint.RuleModule<"preferCodePoint", [], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'prefer-dom-node-text-content': TSESLint.RuleModule<"preferDomNodeTextContent", [], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'no-console-spaces': TSESLint.RuleModule<"noConsoleSpaces", [], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'no-deprecated-api': TSESLint.RuleModule<"deprecatedAPI" | "useReplacement", [(import("./rules/deprecation/no-deprecated-api").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'prefer-dependency-version-strategy': TSESLint.RuleModule<"preferStrategy" | "invalidStrategy", [(import("./rules/conventions/prefer-dependency-version-strategy").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'filename-case': TSESLint.RuleModule<"filenameCase", [(import("./rules/conventions/filename-case").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'consistent-existence-index-check': TSESLint.RuleModule<"consistentExistenceCheck", [(import("./rules/conventions/consistent-existence-index-check").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'conventions/no-commented-code': TSESLint.RuleModule<"commentedCode" | "removeCode" | "useVersionControl", [(import("./rules/conventions/no-commented-code").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'conventions/expiring-todo-comments': TSESLint.RuleModule<"expiringTodoComment" | "invalidTodoCondition" | "multipleTodoConditions", [(import("./rules/conventions/expiring-todo-comments").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'conventions/prefer-code-point': TSESLint.RuleModule<"preferCodePoint", [], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'conventions/prefer-dom-node-text-content': TSESLint.RuleModule<"preferDomNodeTextContent", [], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'conventions/no-console-spaces': TSESLint.RuleModule<"noConsoleSpaces", [], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'deprecation/no-deprecated-api': TSESLint.RuleModule<"deprecatedAPI" | "useReplacement", [(import("./rules/deprecation/no-deprecated-api").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'conventions/prefer-dependency-version-strategy': TSESLint.RuleModule<"preferStrategy" | "invalidStrategy", [(import("./rules/conventions/prefer-dependency-version-strategy").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'conventions/filename-case': TSESLint.RuleModule<"filenameCase", [(import("./rules/conventions/filename-case").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    'conventions/consistent-existence-index-check': TSESLint.RuleModule<"consistentExistenceCheck", [(import("./rules/conventions/consistent-existence-index-check").Options | undefined)?], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                };
+            };
+        };
+        rules: {
+            '@interlace/conventions/conventions/no-commented-code': "warn";
+            '@interlace/conventions/conventions/expiring-todo-comments': "warn";
+            '@interlace/conventions/deprecation/no-deprecated-api': "warn";
+        };
+    };
+};
+export default plugin;

package/src/index.js ADDED Viewed

@@ -0,0 +1,60 @@
+"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.configs = exports.plugin = exports.rules = void 0;
+// Conventions rules
+const no_commented_code_1 = require("./rules/conventions/no-commented-code");
+const expiring_todo_comments_1 = require("./rules/conventions/expiring-todo-comments");
+const prefer_code_point_1 = require("./rules/conventions/prefer-code-point");
+const prefer_dom_node_text_content_1 = require("./rules/conventions/prefer-dom-node-text-content");
+const no_console_spaces_1 = require("./rules/conventions/no-console-spaces");
+const no_deprecated_api_1 = require("./rules/deprecation/no-deprecated-api");
+const prefer_dependency_version_strategy_1 = require("./rules/conventions/prefer-dependency-version-strategy");
+const filename_case_1 = require("./rules/conventions/filename-case");
+const consistent_existence_index_check_1 = require("./rules/conventions/consistent-existence-index-check");
+exports.rules = {
+    'no-commented-code': no_commented_code_1.noCommentedCode,
+    'expiring-todo-comments': expiring_todo_comments_1.expiringTodoComments,
+    'prefer-code-point': prefer_code_point_1.preferCodePoint,
+    'prefer-dom-node-text-content': prefer_dom_node_text_content_1.preferDomNodeTextContent,
+    'no-console-spaces': no_console_spaces_1.noConsoleSpaces,
+    'no-deprecated-api': no_deprecated_api_1.noDeprecatedApi,
+    'prefer-dependency-version-strategy': prefer_dependency_version_strategy_1.preferDependencyVersionStrategy,
+    'filename-case': filename_case_1.filenameCase,
+    'consistent-existence-index-check': consistent_existence_index_check_1.consistentExistenceIndexCheck,
+    // Categorized names
+    'conventions/no-commented-code': no_commented_code_1.noCommentedCode,
+    'conventions/expiring-todo-comments': expiring_todo_comments_1.expiringTodoComments,
+    'conventions/prefer-code-point': prefer_code_point_1.preferCodePoint,
+    'conventions/prefer-dom-node-text-content': prefer_dom_node_text_content_1.preferDomNodeTextContent,
+    'conventions/no-console-spaces': no_console_spaces_1.noConsoleSpaces,
+    'deprecation/no-deprecated-api': no_deprecated_api_1.noDeprecatedApi,
+    'conventions/prefer-dependency-version-strategy': prefer_dependency_version_strategy_1.preferDependencyVersionStrategy,
+    'conventions/filename-case': filename_case_1.filenameCase,
+    'conventions/consistent-existence-index-check': consistent_existence_index_check_1.consistentExistenceIndexCheck,
+};
+exports.plugin = {
+    meta: {
+        name: 'eslint-plugin-conventions',
+        version: '1.0.0',
+    },
+    rules: exports.rules,
+};
+exports.configs = {
+    recommended: {
+        plugins: {
+            '@interlace/conventions': exports.plugin,
+        },
+        rules: {
+            '@interlace/conventions/conventions/no-commented-code': 'warn',
+            '@interlace/conventions/conventions/expiring-todo-comments': 'warn',
+            '@interlace/conventions/deprecation/no-deprecated-api': 'warn',
+        },
+    },
+};
+exports.default = exports.plugin;
+//# sourceMappingURL=index.js.map

package/src/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/eslint-plugin-conventions/src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,oBAAoB;AACpB,6EAAwE;AACxE,uFAAkF;AAClF,6EAAwE;AACxE,mGAA4F;AAC5F,6EAAwE;AACxE,6EAAwE;AACxE,+GAAyG;AACzG,qEAAiE;AACjE,2GAAqG;AAExF,QAAA,KAAK,GAAG;IACnB,mBAAmB,EAAE,mCAAe;IACpC,wBAAwB,EAAE,6CAAoB;IAC9C,mBAAmB,EAAE,mCAAe;IACpC,8BAA8B,EAAE,uDAAwB;IACxD,mBAAmB,EAAE,mCAAe;IACpC,mBAAmB,EAAE,mCAAe;IACpC,oCAAoC,EAAE,oEAA+B;IACrE,eAAe,EAAE,4BAAY;IAC7B,kCAAkC,EAAE,gEAA6B;IAEjE,oBAAoB;IACpB,+BAA+B,EAAE,mCAAe;IAChD,oCAAoC,EAAE,6CAAoB;IAC1D,+BAA+B,EAAE,mCAAe;IAChD,0CAA0C,EAAE,uDAAwB;IACpE,+BAA+B,EAAE,mCAAe;IAChD,+BAA+B,EAAE,mCAAe;IAChD,gDAAgD,EAAE,oEAA+B;IACjF,2BAA2B,EAAE,4BAAY;IACzC,8CAA8C,EAAE,gEAA6B;CACJ,CAAC;AAE/D,QAAA,MAAM,GAAG;IACpB,IAAI,EAAE;QACJ,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,OAAO;KACjB;IACD,KAAK,EAAL,aAAK;CAC+B,CAAC;AAE1B,QAAA,OAAO,GAAG;IACrB,WAAW,EAAE;QACX,OAAO,EAAE;YACP,wBAAwB,EAAE,cAAM;SACjC;QACD,KAAK,EAAE;YACL,sDAAsD,EAAE,MAAM;YAC9D,2DAA2D,EAAE,MAAM;YACnE,sDAAsD,EAAE,MAAM;SAC/D;KACmC;CACc,CAAC;AAEvD,kBAAe,cAAM,CAAC"}

package/src/lib/eslint-plugin-conventions.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export declare function eslintPluginConventions(): string;

package/src/lib/eslint-plugin-conventions.js ADDED Viewed

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eslintPluginConventions = eslintPluginConventions;
+function eslintPluginConventions() {
+    return 'eslint-plugin-conventions';
+}
+//# sourceMappingURL=eslint-plugin-conventions.js.map

package/src/lib/eslint-plugin-conventions.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"eslint-plugin-conventions.js","sourceRoot":"","sources":["../../../../../packages/eslint-plugin-conventions/src/lib/eslint-plugin-conventions.ts"],"names":[],"mappings":";;AAAA,0DAEC;AAFD,SAAgB,uBAAuB;IACrC,OAAO,2BAA2B,CAAC;AACrC,CAAC"}

package/src/rules/conventions/consistent-existence-index-check.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+/**
+ * ESLint Rule: consistent-existence-index-check
+ * Enforce consistent style for checking object property existence
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+export interface Options {
+    /** Preferred method for checking property existence */
+    preferred?: 'in' | 'hasOwnProperty' | 'Object.hasOwn';
+}
+type RuleOptions = [Options?];
+export declare const consistentExistenceIndexCheck: TSESLint.RuleModule<"consistentExistenceCheck", RuleOptions, unknown, TSESLint.RuleListener> & {
+    name: string;
+};
+export {};

package/src/rules/conventions/consistent-existence-index-check.js ADDED Viewed

@@ -0,0 +1,141 @@
+"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.consistentExistenceIndexCheck = void 0;
+const eslint_devkit_1 = require("@interlace/eslint-devkit");
+const eslint_devkit_2 = require("@interlace/eslint-devkit");
+exports.consistentExistenceIndexCheck = (0, eslint_devkit_1.createRule)({
+    name: 'consistent-existence-index-check',
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Enforce consistent style for checking object property existence',
+        },
+        fixable: 'code',
+        hasSuggestions: true,
+        messages: {
+            consistentExistenceCheck: (0, eslint_devkit_2.formatLLMMessage)({
+                icon: eslint_devkit_2.MessageIcons.WARNING,
+                issueName: 'Inconsistent Property Check',
+                description: 'Use consistent method for property existence checks',
+                severity: 'MEDIUM',
+                fix: 'Use "{{preferred}}" instead of "{{current}}" for property checks',
+                documentationLink: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/in',
+            }),
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    preferred: {
+                        type: 'string',
+                        enum: ['in', 'hasOwnProperty', 'Object.hasOwn'],
+                        default: 'in',
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [{ preferred: 'in' }],
+    create(context) {
+        const [options] = context.options;
+        const { preferred = 'in' } = options || {};
+        function reportInconsistentCheck(node, currentMethod, object, property) {
+            let fix;
+            // Only provide fixes for standalone expressions, not when part of larger expressions
+            const parent = node.parent;
+            const isStandaloneExpression = !parent ||
+                parent.type === 'ExpressionStatement' ||
+                (parent.type === 'VariableDeclarator' && parent.init === node) ||
+                (parent.type === 'AssignmentExpression' && parent.right === node) ||
+                (parent.type === 'ReturnStatement' && parent.argument === node) ||
+                (parent.type === 'ArrowFunctionExpression' && parent.body === node) ||
+                (parent.type === 'IfStatement' && parent.test === node) ||
+                (parent.type === 'WhileStatement' && parent.test === node) ||
+                (parent.type === 'DoWhileStatement' && parent.test === node) ||
+                (parent.type === 'ForStatement' && parent.test === node) ||
+                (parent.type === 'ConditionalExpression' && parent.test === node);
+            if (preferred === 'in' && isStandaloneExpression) {
+                fix = function (fixer) {
+                    const objectText = context.sourceCode.getText(object);
+                    const propertyText = context.sourceCode.getText(property);
+                    return fixer.replaceText(node, `${propertyText} in ${objectText}`);
+                };
+            }
+            else if (preferred === 'hasOwnProperty' && isStandaloneExpression) {
+                fix = function (fixer) {
+                    const objectText = context.sourceCode.getText(object);
+                    const propertyText = context.sourceCode.getText(property);
+                    return fixer.replaceText(node, `${objectText}.hasOwnProperty(${propertyText})`);
+                };
+            }
+            else if (preferred === 'Object.hasOwn' && isStandaloneExpression) {
+                fix = function (fixer) {
+                    const objectText = context.sourceCode.getText(object);
+                    const propertyText = context.sourceCode.getText(property);
+                    return fixer.replaceText(node, `Object.hasOwn(${objectText}, ${propertyText})`);
+                };
+            }
+            context.report({
+                node,
+                messageId: 'consistentExistenceCheck',
+                data: {
+                    current: currentMethod,
+                    preferred,
+                },
+                fix,
+            });
+        }
+        return {
+            // Check for hasOwnProperty calls
+            CallExpression(node) {
+                // Direct hasOwnProperty calls: obj.hasOwnProperty(prop)
+                if (node.callee.type === 'MemberExpression' &&
+                    node.callee.property.type === 'Identifier' &&
+                    node.callee.property.name === 'hasOwnProperty' &&
+                    node.arguments.length === 1 &&
+                    preferred !== 'hasOwnProperty') {
+                    reportInconsistentCheck(node, 'hasOwnProperty', node.callee.object, node.arguments[0]);
+                }
+                // Object.prototype.hasOwnProperty.call(obj, prop)
+                if (node.callee.type === 'MemberExpression' &&
+                    node.callee.object.type === 'MemberExpression' &&
+                    node.callee.object.object.type === 'MemberExpression' &&
+                    node.callee.object.object.object.type === 'Identifier' &&
+                    node.callee.object.object.object.name === 'Object' &&
+                    node.callee.object.object.property.type === 'Identifier' &&
+                    node.callee.object.object.property.name === 'prototype' &&
+                    node.callee.object.property.type === 'Identifier' &&
+                    node.callee.object.property.name === 'hasOwnProperty' &&
+                    node.callee.property.type === 'Identifier' &&
+                    node.callee.property.name === 'call' &&
+                    node.arguments.length >= 2 &&
+                    preferred !== 'hasOwnProperty') {
+                    reportInconsistentCheck(node, 'Object.prototype.hasOwnProperty.call', node.arguments[0], node.arguments[1]);
+                }
+                // Object.hasOwn(obj, prop)
+                if (node.callee.type === 'MemberExpression' &&
+                    node.callee.object.type === 'Identifier' &&
+                    node.callee.object.name === 'Object' &&
+                    node.callee.property.type === 'Identifier' &&
+                    node.callee.property.name === 'hasOwn' &&
+                    node.arguments.length === 2 &&
+                    preferred !== 'Object.hasOwn') {
+                    reportInconsistentCheck(node, 'Object.hasOwn', node.arguments[0], node.arguments[1]);
+                }
+            },
+            // Check for 'in' operator usage
+            BinaryExpression(node) {
+                if (node.operator === 'in' && preferred !== 'in') {
+                    reportInconsistentCheck(node, 'in', node.right, node.left);
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=consistent-existence-index-check.js.map

package/src/rules/conventions/consistent-existence-index-check.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"consistent-existence-index-check.js","sourceRoot":"","sources":["../../../../../../packages/eslint-plugin-conventions/src/rules/conventions/consistent-existence-index-check.ts"],"names":[],"mappings":"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"}

package/src/rules/conventions/expiring-todo-comments.d.ts ADDED Viewed

@@ -0,0 +1,24 @@
+/**
+ * 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: expiring-todo-comments
+ * Add expiration conditions to TODO comments to prevent forgotten tasks
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+type MessageIds = 'expiringTodoComment' | 'invalidTodoCondition' | 'multipleTodoConditions';
+export interface Options {
+    /** Terms to check for (default: ['TODO', 'FIXME', 'XXX']) */
+    terms?: string[];
+    /** Date format for expiry dates */
+    dateFormat?: string;
+    /** Allow warnings for expired TODOs */
+    allowWarningComments?: boolean;
+}
+type RuleOptions = [Options?];
+export declare const expiringTodoComments: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
+    name: string;
+};
+export {};