eslint-plugin-llm-core 0.1.0

package/README.md

@@ -0,0 +1,99 @@
+# eslint-plugin-llm-core
+
+ESLint rules that catch the patterns LLM agents get wrong — and teach them to self-correct through structured error messages.
+
+LLMs generate code that _works_ but drifts: arrow functions everywhere, magic numbers, deep nesting, string-interpolated logs, oversized files. These aren't style nitpicks — they compound into codebases that are harder to debug, review, and maintain.
+
+This plugin catches those patterns at lint time and provides error messages designed for LLM comprehension: **what's wrong**, **why it matters**, and **a concrete fix**. The result is AI-generated code that reads like it was written by a senior engineer.
+
+## Why this plugin?
+
+- **Targeted rules** — Every rule addresses a real pattern LLMs consistently get wrong, from `export const fn = () => {}` to `logger.error(\`Failed for ${userId}\`)`
+- **Teaching error messages** — Structured feedback that LLMs can parse and learn from across iterations
+- **Works for humans too** — These are solid code quality rules regardless of who wrote the code
+- **Zero config** — The `recommended` preset is ready out of the box
+- **Suggestions, not auto-fixes** — Transformations that could change semantics are offered as suggestions, keeping you in control
+
+## Installation
+
+```bash
+npm install eslint-plugin-llm-core --save-dev
+```
+
+## Quick Start
+
+```js
+// eslint.config.mjs
+import llmCore from "eslint-plugin-llm-core";
+
+export default [
+  ...llmCore.configs.recommended,
+];
+```
+
+That's it. All recommended rules are now active.
+
+### Available Configs
+
+| Config        | Description                                          |
+| ------------- | ---------------------------------------------------- |
+| `recommended` | Safe defaults — rules most codebases should use      |
+| `all`         | Every rule at `error` — for strict codebases         |
+
+### Manual Rule Configuration
+
+```js
+// eslint.config.mjs
+import llmCore from "eslint-plugin-llm-core";
+
+export default [
+  {
+    plugins: {
+      "llm-core": llmCore,
+    },
+    rules: {
+      "llm-core/no-exported-function-expressions": "error",
+      "llm-core/structured-logging": "error",
+    },
+  },
+];
+```
+
+## Rules
+
+<!-- begin auto-generated rules list -->
+
+💼 Configurations enabled in.\
+🌐 Set in the `all` configuration.\
+✅ Set in the `recommended` configuration.\
+💡 Manually fixable by [editor suggestions](https://eslint.org/docs/latest/use/core-concepts#rule-suggestions).
+
+| Name                                                                               | Description                                                                                                  | 💼    | 💡  |
+| :--------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------- | :---- | :-- |
+| [filename-match-export](docs/rules/filename-match-export.md)                       | Enforce that filenames match their single exported function, class, or component name                        | 🌐 ✅ |     |
+| [max-file-length](docs/rules/max-file-length.md)                                   | Enforce a maximum number of lines per file to encourage proper module separation                             | 🌐 ✅ |     |
+| [max-function-length](docs/rules/max-function-length.md)                           | Enforce a maximum number of lines per function to encourage decomposition                                    | 🌐 ✅ |     |
+| [max-nesting-depth](docs/rules/max-nesting-depth.md)                               | Enforce a maximum nesting depth for control flow statements to reduce cognitive complexity                   | 🌐 ✅ |     |
+| [max-params](docs/rules/max-params.md)                                             | Enforce a maximum number of function parameters to encourage object parameter patterns                       | 🌐 ✅ |     |
+| [naming-conventions](docs/rules/naming-conventions.md)                             | Enforce naming conventions: Base prefix for abstract classes, Error suffix for error classes                 | 🌐 ✅ |     |
+| [no-exported-function-expressions](docs/rules/no-exported-function-expressions.md) | Enforce that exported functions use function declarations instead of function expressions or arrow functions | 🌐 ✅ | 💡  |
+| [no-inline-disable](docs/rules/no-inline-disable.md)                               | Disallow eslint-disable comments that suppress lint errors instead of fixing them                            | 🌐 ✅ |     |
+| [no-magic-numbers](docs/rules/no-magic-numbers.md)                                 | Disallow magic numbers and enforce named constants for clarity                                               | 🌐 ✅ |     |
+| [structured-logging](docs/rules/structured-logging.md)                             | Enforce structured logging with static messages and dynamic values as separate metadata                      | 🌐 ✅ |     |
+
+<!-- end auto-generated rules list -->
+
+## Contributing
+
+```bash
+npm install
+npm run build
+npm run test
+npm run lint
+```
+
+See [CLAUDE.md](CLAUDE.md) for architecture details and how to add new rules.
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import type { TSESLint } from "@typescript-eslint/utils";
+import * as rules from "./rules";
+declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: typeof rules;
+    configs: Record<string, TSESLint.FlatConfig.ConfigArray>;
+};
+export = plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAIjC,QAAA,MAAM,MAAM;;;;;;aAMK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC;CAC/D,CAAC;AAqCF,SAAS,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+const rules = __importStar(require("./rules"));
+const plugin = {
+    meta: {
+        name: "eslint-plugin-llm-core",
+        version: "0.1.0",
+    },
+    rules,
+    configs: {},
+};
+const recommendedRules = {
+    "llm-core/no-exported-function-expressions": "error",
+    "llm-core/filename-match-export": "error",
+    "llm-core/structured-logging": "error",
+    "llm-core/max-nesting-depth": "error",
+    "llm-core/no-inline-disable": "error",
+    "llm-core/max-params": "error",
+    "llm-core/max-function-length": "error",
+    "llm-core/max-file-length": "error",
+    "llm-core/no-magic-numbers": "error",
+    "llm-core/naming-conventions": "error",
+};
+const allRules = Object.fromEntries(Object.keys(rules).map((rule) => [
+    `llm-core/${rule}`,
+    "error",
+]));
+plugin.configs = {
+    recommended: [
+        {
+            plugins: { "llm-core": plugin },
+            rules: recommendedRules,
+        },
+    ],
+    all: [
+        {
+            plugins: { "llm-core": plugin },
+            rules: allRules,
+        },
+    ],
+};
+module.exports = plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,+CAAiC;AAIjC,MAAM,MAAM,GAAG;IACb,IAAI,EAAE;QACJ,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,OAAO;KACjB;IACD,KAAK;IACL,OAAO,EAAE,EAAqD;CAC/D,CAAC;AAEF,MAAM,gBAAgB,GAA8B;IAClD,2CAA2C,EAAE,OAAO;IACpD,gCAAgC,EAAE,OAAO;IACzC,6BAA6B,EAAE,OAAO;IACtC,4BAA4B,EAAE,OAAO;IACrC,4BAA4B,EAAE,OAAO;IACrC,qBAAqB,EAAE,OAAO;IAC9B,8BAA8B,EAAE,OAAO;IACvC,0BAA0B,EAAE,OAAO;IACnC,2BAA2B,EAAE,OAAO;IACpC,6BAA6B,EAAE,OAAO;CACvC,CAAC;AAEF,MAAM,QAAQ,GAA8B,MAAM,CAAC,WAAW,CAC5D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC/B,YAAY,IAAe,EAAE;IAC7B,OAAgB;CACjB,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,OAAO,GAAG;IACf,WAAW,EAAE;QACX;YACE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;YAC/B,KAAK,EAAE,gBAAgB;SACxB;KACF;IACD,GAAG,EAAE;QACH;YACE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;YAC/B,KAAK,EAAE,QAAQ;SAChB;KACF;CACF,CAAC;AAEF,iBAAS,MAAM,CAAC"}

package/dist/rules/filename-match-export.d.ts

@@ -0,0 +1,5 @@
+declare const _default: import("@typescript-eslint/utils/dist/ts-eslint").RuleModule<"filenameMismatch", [], unknown, import("@typescript-eslint/utils/dist/ts-eslint").RuleListener> & {
+    name: string;
+};
+export default _default;
+//# sourceMappingURL=filename-match-export.d.ts.map

package/dist/rules/filename-match-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename-match-export.d.ts","sourceRoot":"","sources":["../../src/rules/filename-match-export.ts"],"names":[],"mappings":";;;AAmDA,wBAwKG"}

package/dist/rules/filename-match-export.js

@@ -0,0 +1,198 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("@typescript-eslint/utils");
+const create_rule_1 = require("../utils/create-rule");
+const IGNORED_FILENAMES = new Set([
+    "index",
+    "types",
+    "constants",
+    "enums",
+    "errors",
+    "utils",
+    "helpers",
+]);
+function kebabToCamel(str) {
+    return str.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function kebabToPascal(str) {
+    const camel = kebabToCamel(str);
+    return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+function getBaseName(filename) {
+    return filename.replace(/(\.(test|spec))?\.(ts|tsx|js|jsx|mjs|cjs)$/, "");
+}
+function filenameMatchesExport(filename, exportName) {
+    const base = getBaseName(filename);
+    if (base === exportName)
+        return true;
+    if (kebabToCamel(base) === exportName)
+        return true;
+    if (kebabToPascal(base) === exportName)
+        return true;
+    // Also handle PascalCase filename matching camelCase export
+    const lowerFirst = base.charAt(0).toLowerCase() + base.slice(1);
+    if (lowerFirst === exportName)
+        return true;
+    return false;
+}
+function isIgnoredFile(filename) {
+    return IGNORED_FILENAMES.has(getBaseName(filename));
+}
+function isTestFile(filename) {
+    return /\.(test|spec)\.(ts|tsx|js|jsx|mjs|cjs)$/.test(filename);
+}
+exports.default = (0, create_rule_1.createRule)({
+    name: "filename-match-export",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Enforce that filenames match their single exported function, class, or component name",
+        },
+        messages: {
+            filenameMismatch: [
+                "Filename '{{ filename }}' does not match its single export '{{ exportName }}'.",
+                "",
+                "Why: Mismatched filenames make code harder to navigate and search.",
+                "When a file exports a single function or class, the filename should reflect what it contains.",
+                "",
+                "How to fix:",
+                "  Rename the file to match: {{ expectedFilename }}",
+                "  Or rename the export to match the filename.",
+            ].join("\n"),
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        const filename = path_1.default.basename(context.filename);
+        if (isIgnoredFile(filename) || isTestFile(filename)) {
+            return {};
+        }
+        const base = getBaseName(filename);
+        if (base === "index") {
+            return {};
+        }
+        const exportedNames = [];
+        return {
+            ExportNamedDeclaration(node) {
+                // Re-exports: export { x } from './y' — skip
+                if (node.source)
+                    return;
+                if (node.declaration) {
+                    if (node.declaration.type === utils_1.AST_NODE_TYPES.FunctionDeclaration &&
+                        node.declaration.id) {
+                        exportedNames.push({
+                            name: node.declaration.id.name,
+                            node: node.declaration.id,
+                        });
+                    }
+                    else if (node.declaration.type === utils_1.AST_NODE_TYPES.ClassDeclaration &&
+                        node.declaration.id) {
+                        exportedNames.push({
+                            name: node.declaration.id.name,
+                            node: node.declaration.id,
+                        });
+                    }
+                    else if (node.declaration.type === utils_1.AST_NODE_TYPES.VariableDeclaration) {
+                        for (const declarator of node.declaration.declarations) {
+                            if (declarator.id.type === utils_1.AST_NODE_TYPES.Identifier) {
+                                exportedNames.push({
+                                    name: declarator.id.name,
+                                    node: declarator.id,
+                                });
+                            }
+                        }
+                    }
+                    else if (node.declaration.type === utils_1.AST_NODE_TYPES.TSEnumDeclaration &&
+                        node.declaration.id) {
+                        exportedNames.push({
+                            name: node.declaration.id.name,
+                            node: node.declaration.id,
+                        });
+                    }
+                    else if (node.declaration.type === utils_1.AST_NODE_TYPES.TSTypeAliasDeclaration &&
+                        node.declaration.id) {
+                        exportedNames.push({
+                            name: node.declaration.id.name,
+                            node: node.declaration.id,
+                        });
+                    }
+                    else if (node.declaration.type === utils_1.AST_NODE_TYPES.TSInterfaceDeclaration &&
+                        node.declaration.id) {
+                        exportedNames.push({
+                            name: node.declaration.id.name,
+                            node: node.declaration.id,
+                        });
+                    }
+                }
+                // Named specifiers: export { foo, bar }
+                for (const specifier of node.specifiers) {
+                    if (specifier.type === utils_1.AST_NODE_TYPES.ExportSpecifier) {
+                        const exported = specifier.exported;
+                        if (exported.type === utils_1.AST_NODE_TYPES.Identifier) {
+                            exportedNames.push({ name: exported.name, node: exported });
+                        }
+                    }
+                }
+            },
+            ExportDefaultDeclaration(node) {
+                const declaration = node.declaration;
+                if (declaration.type === utils_1.AST_NODE_TYPES.FunctionDeclaration &&
+                    declaration.id) {
+                    exportedNames.push({
+                        name: declaration.id.name,
+                        node: declaration.id,
+                    });
+                }
+                else if (declaration.type === utils_1.AST_NODE_TYPES.ClassDeclaration &&
+                    declaration.id) {
+                    exportedNames.push({
+                        name: declaration.id.name,
+                        node: declaration.id,
+                    });
+                }
+                else if (declaration.type === utils_1.AST_NODE_TYPES.Identifier) {
+                    exportedNames.push({
+                        name: declaration.name,
+                        node: declaration,
+                    });
+                }
+                // Anonymous defaults are not named — nothing to match
+            },
+            "Program:exit"() {
+                if (exportedNames.length !== 1)
+                    return;
+                const { name: exportName, node: exportNode } = exportedNames[0];
+                if (filenameMatchesExport(filename, exportName))
+                    return;
+                const ext = filename.slice(filename.indexOf("."));
+                // Determine expected filename style based on current filename convention
+                const hasKebab = base.includes("-");
+                let expectedBase;
+                if (hasKebab) {
+                    // Convert export name to kebab-case
+                    expectedBase = exportName
+                        .replace(/([a-z])([A-Z])/g, "$1-$2")
+                        .toLowerCase();
+                }
+                else {
+                    expectedBase = exportName;
+                }
+                context.report({
+                    node: exportNode,
+                    messageId: "filenameMismatch",
+                    data: {
+                        filename,
+                        exportName,
+                        expectedFilename: `${expectedBase}${ext}`,
+                    },
+                });
+            },
+        };
+    },
+});
+//# sourceMappingURL=filename-match-export.js.map

package/dist/rules/filename-match-export.js.map

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

package/dist/rules/index.d.ts

@@ -0,0 +1,11 @@
+export { default as "no-exported-function-expressions" } from "./no-exported-function-expressions";
+export { default as "filename-match-export" } from "./filename-match-export";
+export { default as "structured-logging" } from "./structured-logging";
+export { default as "max-nesting-depth" } from "./max-nesting-depth";
+export { default as "no-inline-disable" } from "./no-inline-disable";
+export { default as "max-params" } from "./max-params";
+export { default as "max-function-length" } from "./max-function-length";
+export { default as "max-file-length" } from "./max-file-length";
+export { default as "no-magic-numbers" } from "./no-magic-numbers";
+export { default as "naming-conventions" } from "./naming-conventions";
+//# sourceMappingURL=index.d.ts.map

package/dist/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kCAAkC,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/rules/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports["naming-conventions"] = exports["no-magic-numbers"] = exports["max-file-length"] = exports["max-function-length"] = exports["max-params"] = exports["no-inline-disable"] = exports["max-nesting-depth"] = exports["structured-logging"] = exports["filename-match-export"] = exports["no-exported-function-expressions"] = void 0;
+var no_exported_function_expressions_1 = require("./no-exported-function-expressions");
+Object.defineProperty(exports, "no-exported-function-expressions", { enumerable: true, get: function () { return __importDefault(no_exported_function_expressions_1).default; } });
+var filename_match_export_1 = require("./filename-match-export");
+Object.defineProperty(exports, "filename-match-export", { enumerable: true, get: function () { return __importDefault(filename_match_export_1).default; } });
+var structured_logging_1 = require("./structured-logging");
+Object.defineProperty(exports, "structured-logging", { enumerable: true, get: function () { return __importDefault(structured_logging_1).default; } });
+var max_nesting_depth_1 = require("./max-nesting-depth");
+Object.defineProperty(exports, "max-nesting-depth", { enumerable: true, get: function () { return __importDefault(max_nesting_depth_1).default; } });
+var no_inline_disable_1 = require("./no-inline-disable");
+Object.defineProperty(exports, "no-inline-disable", { enumerable: true, get: function () { return __importDefault(no_inline_disable_1).default; } });
+var max_params_1 = require("./max-params");
+Object.defineProperty(exports, "max-params", { enumerable: true, get: function () { return __importDefault(max_params_1).default; } });
+var max_function_length_1 = require("./max-function-length");
+Object.defineProperty(exports, "max-function-length", { enumerable: true, get: function () { return __importDefault(max_function_length_1).default; } });
+var max_file_length_1 = require("./max-file-length");
+Object.defineProperty(exports, "max-file-length", { enumerable: true, get: function () { return __importDefault(max_file_length_1).default; } });
+var no_magic_numbers_1 = require("./no-magic-numbers");
+Object.defineProperty(exports, "no-magic-numbers", { enumerable: true, get: function () { return __importDefault(no_magic_numbers_1).default; } });
+var naming_conventions_1 = require("./naming-conventions");
+Object.defineProperty(exports, "naming-conventions", { enumerable: true, get: function () { return __importDefault(naming_conventions_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":";;;;;;AAAA,uFAAmG;AAA1F,qKAAA,OAAO,OAAsC;AACtD,iEAA6E;AAApE,+IAAA,OAAO,OAA2B;AAC3C,2DAAuE;AAA9D,yIAAA,OAAO,OAAwB;AACxC,yDAAqE;AAA5D,uIAAA,OAAO,OAAuB;AACvC,yDAAqE;AAA5D,uIAAA,OAAO,OAAuB;AACvC,2CAAuD;AAA9C,yHAAA,OAAO,OAAgB;AAChC,6DAAyE;AAAhE,2IAAA,OAAO,OAAyB;AACzC,qDAAiE;AAAxD,mIAAA,OAAO,OAAqB;AACrC,uDAAmE;AAA1D,qIAAA,OAAO,OAAsB;AACtC,2DAAuE;AAA9D,yIAAA,OAAO,OAAwB"}

package/dist/rules/max-file-length.d.ts

@@ -0,0 +1,12 @@
+type Options = [
+    {
+        max?: number;
+        skipBlankLines?: boolean;
+        skipTestFiles?: boolean;
+    }
+];
+declare const _default: import("@typescript-eslint/utils/dist/ts-eslint").RuleModule<"maxFileLength", Options, unknown, import("@typescript-eslint/utils/dist/ts-eslint").RuleListener> & {
+    name: string;
+};
+export default _default;
+//# sourceMappingURL=max-file-length.d.ts.map

package/dist/rules/max-file-length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-file-length.d.ts","sourceRoot":"","sources":["../../src/rules/max-file-length.ts"],"names":[],"mappings":"AAKA,KAAK,OAAO,GAAG;IACb;QACE,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB;CACF,CAAC;;;;AAEF,wBAkFG"}

package/dist/rules/max-file-length.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const create_rule_1 = require("../utils/create-rule");
+exports.default = (0, create_rule_1.createRule)({
+    name: "max-file-length",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Enforce a maximum number of lines per file to encourage proper module separation",
+        },
+        messages: {
+            maxFileLength: [
+                "File has {{ lines }} lines, exceeding the maximum of {{ max }}.",
+                "",
+                "Why: Large files are hard to navigate and often contain unrelated logic.",
+                "They indicate poor module separation and make code review harder.",
+                "",
+                "How to fix:",
+                "  1. Split the file by responsibility — each file should have a clear, single purpose",
+                "  2. Extract related functions into their own module (e.g., validation.ts, formatting.ts)",
+                "  3. Move types/interfaces to a separate types.ts file",
+                "  4. Move constants to a constants.ts file",
+            ].join("\n"),
+        },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    max: {
+                        type: "integer",
+                        minimum: 1,
+                        description: "Maximum allowed lines per file (default: 250)",
+                    },
+                    skipBlankLines: {
+                        type: "boolean",
+                        description: "Whether to skip blank lines when counting (default: true)",
+                    },
+                    skipTestFiles: {
+                        type: "boolean",
+                        description: "Whether to skip test files (.test.ts, .spec.ts) (default: true)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [{ max: 250, skipBlankLines: true, skipTestFiles: true }],
+    create(context, [options]) {
+        const max = options.max ?? 250;
+        const skipBlankLines = options.skipBlankLines ?? true;
+        const skipTestFiles = options.skipTestFiles ?? true;
+        const sourceCode = context.sourceCode;
+        return {
+            "Program:exit"(node) {
+                if (skipTestFiles) {
+                    const filename = path_1.default.basename(context.filename);
+                    if (/\.(test|spec)\.(ts|tsx|js|jsx|mjs|cjs)$/.test(filename)) {
+                        return;
+                    }
+                }
+                const text = sourceCode.getText(node);
+                const allLines = text.split("\n");
+                const lines = skipBlankLines
+                    ? allLines.filter((line) => line.trim().length > 0).length
+                    : allLines.length;
+                if (lines <= max)
+                    return;
+                context.report({
+                    node,
+                    loc: { line: 1, column: 0 },
+                    messageId: "maxFileLength",
+                    data: {
+                        lines: String(lines),
+                        max: String(max),
+                    },
+                });
+            },
+        };
+    },
+});
+//# sourceMappingURL=max-file-length.js.map

package/dist/rules/max-file-length.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-file-length.js","sourceRoot":"","sources":["../../src/rules/max-file-length.ts"],"names":[],"mappings":";;;;;AAAA,gDAAwB;AACxB,sDAAkD;AAYlD,kBAAe,IAAA,wBAAU,EAAsB;IAC7C,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,kFAAkF;SACrF;QACD,QAAQ,EAAE;YACR,aAAa,EAAE;gBACb,iEAAiE;gBACjE,EAAE;gBACF,0EAA0E;gBAC1E,mEAAmE;gBACnE,EAAE;gBACF,aAAa;gBACb,uFAAuF;gBACvF,2FAA2F;gBAC3F,wDAAwD;gBACxD,4CAA4C;aAC7C,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;QACD,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,GAAG,EAAE;wBACH,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,WAAW,EAAE,+CAA+C;qBAC7D;oBACD,cAAc,EAAE;wBACd,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,2DAA2D;qBAC9D;oBACD,aAAa,EAAE;wBACb,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,iEAAiE;qBACpE;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;IACD,cAAc,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACzE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;QAC/B,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;QACtD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;QACpD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAEtC,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;oBACjD,IAAI,yCAAyC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC7D,OAAO;oBACT,CAAC;gBACH,CAAC;gBAED,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,KAAK,GAAG,cAAc;oBAC1B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM;oBAC1D,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAEpB,IAAI,KAAK,IAAI,GAAG;oBAAE,OAAO;gBAEzB,OAAO,CAAC,MAAM,CAAC;oBACb,IAAI;oBACJ,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;oBAC3B,SAAS,EAAE,eAAe;oBAC1B,IAAI,EAAE;wBACJ,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;wBACpB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;qBACjB;iBACF,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/max-function-length.d.ts

@@ -0,0 +1,11 @@
+type Options = [
+    {
+        max?: number;
+        skipBlankLines?: boolean;
+    }
+];
+declare const _default: import("@typescript-eslint/utils/dist/ts-eslint").RuleModule<"maxFunctionLength", Options, unknown, import("@typescript-eslint/utils/dist/ts-eslint").RuleListener> & {
+    name: string;
+};
+export default _default;
+//# sourceMappingURL=max-function-length.d.ts.map

package/dist/rules/max-function-length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-function-length.d.ts","sourceRoot":"","sources":["../../src/rules/max-function-length.ts"],"names":[],"mappings":"AAKA,KAAK,OAAO,GAAG;IACb;QACE,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B;CACF,CAAC;;;;AAEF,wBA2HG"}