@trackunit/eslint-plugin-trackunit 0.4.67 → 0.5.2

package/CHANGELOG.md

@@ -1,3 +1,30 @@
+## 0.5.2 (2026-05-06)
+
+### 🧱 Updated Dependencies
+
+- Updated shared-utils to 1.14.2
+
+## 0.5.1 (2026-05-06)
+
+### 🚀 Features
+
+- **eslint:** one-component-per-file + component-name-matches-filename rules ([#23077](https://github.com/Trackunit/manager/pull/23077))
+
+### 🧱 Updated Dependencies
+
+- Updated shared-utils to 1.14.1
+
+### ❤️ Thank You
+
+- Cursor @cursoragent
+- Michael Buss Rønne @man-trackunit
+
+## 0.5.0 (2026-05-04)
+
+### 🧱 Updated Dependencies
+
+- Updated shared-utils to 1.14.0
+
 ## 0.4.67 (2026-05-01)
 
 This was a version bump only for eslint-plugin-trackunit to align it with other projects, there were no code changes.

package/README.md

@@ -64,6 +64,8 @@ All custom rules are enabled automatically through the presets under the `@track
 | `@trackunit/require-optional-prop-initialization`      | —        | —        | Requires optional component props to be initialized inside the component.                  |
 | `@trackunit/require-component-prop-contracts`          | —        | —        | Requires public component props to satisfy configured prop/interface contracts.            |
 | `@trackunit/require-list-item-virtualization-props`    | —        | —        | Requires `VirtualizationListItemProps` on list items inside `<List>`.                      |
+| `@trackunit/one-component-per-file`                    | warn     | —        | Enforces at most one exported React component per file. `exportedOnly: false` restricts to one total. |
+| `@trackunit/component-name-matches-filename`           | warn     | —        | Enforces that exported React component names match the filename (e.g. `Foo` in `Foo.tsx`). |
 
 ### Testing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/eslint-plugin-trackunit",
-  "version": "0.4.67",
+  "version": "0.5.2",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {

package/src/lib/config/fragments/react-rules.js

@@ -118,6 +118,21 @@ exports.reactCustomRules = {
         },
     ],
     "@trackunit/prefer-field-components": "error",
+    "@trackunit/one-component-per-file": "warn",
+    "@trackunit/component-name-matches-filename": [
+        "warn",
+        {
+            allowedMismatches: [
+                // i18next convention: every library's translation.tsx exports a `Trans` wrapper
+                // named after the library component, not the file.
+                { file: "translation", component: "Trans" },
+                // React context pattern: *Context files always contain both the context object and
+                // the provider component. The provider can't be renamed to match the file because
+                // the context object already uses that name.
+                { file: "*Context", component: "*Provider" },
+            ],
+        },
+    ],
 };
 exports.reactTestingLibraryOverrides = {
     files: ["**/*.spec.ts", "**/*.spec.tsx"],

package/src/lib/config/index.d.ts

@@ -4,6 +4,19 @@ export declare const configs: {
             "@nx": typeof import("@nx/eslint-plugin");
             "@trackunit": {
                 rules: {
+                    "component-name-matches-filename": import("@typescript-eslint/utils/ts-eslint").RuleModule<"componentNameMismatch", [{
+                        allowedMismatches?: ReadonlyArray<{
+                            file: string;
+                            component: string;
+                        }>;
+                    }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
+                    "one-component-per-file": import("@typescript-eslint/utils/ts-eslint").RuleModule<"tooManyExported" | "tooManyComponents", [{
+                        exportedOnly?: boolean;
+                    }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
                     "cva-merge-base-classes-as-array": import("@typescript-eslint/utils/ts-eslint").RuleModule<"stringNeedsArray" | "arrayNeedsSplit", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };
@@ -176,6 +189,19 @@ export declare const configs: {
         plugins: {
             "@trackunit": {
                 rules: {
+                    "component-name-matches-filename": import("@typescript-eslint/utils/ts-eslint").RuleModule<"componentNameMismatch", [{
+                        allowedMismatches?: ReadonlyArray<{
+                            file: string;
+                            component: string;
+                        }>;
+                    }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
+                    "one-component-per-file": import("@typescript-eslint/utils/ts-eslint").RuleModule<"tooManyExported" | "tooManyComponents", [{
+                        exportedOnly?: boolean;
+                    }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
                     "cva-merge-base-classes-as-array": import("@typescript-eslint/utils/ts-eslint").RuleModule<"stringNeedsArray" | "arrayNeedsSplit", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };
@@ -281,6 +307,19 @@ export declare const configs: {
         plugins: {
             "@trackunit": {
                 rules: {
+                    "component-name-matches-filename": import("@typescript-eslint/utils/ts-eslint").RuleModule<"componentNameMismatch", [{
+                        allowedMismatches?: ReadonlyArray<{
+                            file: string;
+                            component: string;
+                        }>;
+                    }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
+                    "one-component-per-file": import("@typescript-eslint/utils/ts-eslint").RuleModule<"tooManyExported" | "tooManyComponents", [{
+                        exportedOnly?: boolean;
+                    }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
                     "cva-merge-base-classes-as-array": import("@typescript-eslint/utils/ts-eslint").RuleModule<"stringNeedsArray" | "arrayNeedsSplit", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };
@@ -789,6 +828,8 @@ export declare const configs: {
             "jsdoc/require-jsdoc"?: undefined;
             "no-console"?: undefined;
             "@typescript-eslint/no-empty-function"?: undefined;
+            "@trackunit/one-component-per-file"?: undefined;
+            "@trackunit/component-name-matches-filename"?: undefined;
         };
         plugins?: undefined;
         settings?: undefined;
@@ -799,6 +840,20 @@ export declare const configs: {
             "jsdoc/require-jsdoc": string;
             "no-console": string;
             "@typescript-eslint/no-empty-function": string;
+            "@trackunit/one-component-per-file": string;
+            "@trackunit/component-name-matches-filename": string;
+        };
+        plugins?: undefined;
+        settings?: undefined;
+        languageOptions?: undefined;
+    } | {
+        files: string[];
+        rules: {
+            "@trackunit/one-component-per-file": string;
+            "@trackunit/component-name-matches-filename": string;
+            "jsdoc/require-jsdoc"?: undefined;
+            "no-console"?: undefined;
+            "@typescript-eslint/no-empty-function"?: undefined;
         };
         plugins?: undefined;
         settings?: undefined;
@@ -874,6 +929,8 @@ export declare const configs: {
             "jsdoc/require-jsdoc"?: undefined;
             "no-console"?: undefined;
             "@typescript-eslint/no-empty-function"?: undefined;
+            "@trackunit/one-component-per-file"?: undefined;
+            "@trackunit/component-name-matches-filename"?: undefined;
         };
         settings?: undefined;
     })[];

package/src/lib/config/plugins.d.ts

@@ -22,6 +22,19 @@ import * as globals from "globals";
 import * as jsoncParser from "jsonc-eslint-parser";
 export declare const localRulesPlugin: {
     rules: {
+        "component-name-matches-filename": import("@typescript-eslint/utils/ts-eslint").RuleModule<"componentNameMismatch", [{
+            allowedMismatches?: ReadonlyArray<{
+                file: string;
+                component: string;
+            }>;
+        }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+            name: string;
+        };
+        "one-component-per-file": import("@typescript-eslint/utils/ts-eslint").RuleModule<"tooManyExported" | "tooManyComponents", [{
+            exportedOnly?: boolean;
+        }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+            name: string;
+        };
         "cva-merge-base-classes-as-array": import("@typescript-eslint/utils/ts-eslint").RuleModule<"stringNeedsArray" | "arrayNeedsSplit", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
             name: string;
         };

package/src/lib/config/presets/base.d.ts

@@ -4,6 +4,19 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
         "@nx": typeof nx;
         "@trackunit": {
             rules: {
+                "component-name-matches-filename": import("@typescript-eslint/utils/ts-eslint").RuleModule<"componentNameMismatch", [{
+                    allowedMismatches?: ReadonlyArray<{
+                        file: string;
+                        component: string;
+                    }>;
+                }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
+                "one-component-per-file": import("@typescript-eslint/utils/ts-eslint").RuleModule<"tooManyExported" | "tooManyComponents", [{
+                    exportedOnly?: boolean;
+                }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
                 "cva-merge-base-classes-as-array": import("@typescript-eslint/utils/ts-eslint").RuleModule<"stringNeedsArray" | "arrayNeedsSplit", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };
@@ -176,6 +189,19 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
     plugins: {
         "@trackunit": {
             rules: {
+                "component-name-matches-filename": import("@typescript-eslint/utils/ts-eslint").RuleModule<"componentNameMismatch", [{
+                    allowedMismatches?: ReadonlyArray<{
+                        file: string;
+                        component: string;
+                    }>;
+                }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
+                "one-component-per-file": import("@typescript-eslint/utils/ts-eslint").RuleModule<"tooManyExported" | "tooManyComponents", [{
+                    exportedOnly?: boolean;
+                }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
                 "cva-merge-base-classes-as-array": import("@typescript-eslint/utils/ts-eslint").RuleModule<"stringNeedsArray" | "arrayNeedsSplit", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };

package/src/lib/config/presets/react.d.ts

@@ -3,6 +3,19 @@ export declare const reactPreset: ({
     plugins: {
         "@trackunit": {
             rules: {
+                "component-name-matches-filename": import("@typescript-eslint/utils/ts-eslint").RuleModule<"componentNameMismatch", [{
+                    allowedMismatches?: ReadonlyArray<{
+                        file: string;
+                        component: string;
+                    }>;
+                }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
+                "one-component-per-file": import("@typescript-eslint/utils/ts-eslint").RuleModule<"tooManyExported" | "tooManyComponents", [{
+                    exportedOnly?: boolean;
+                }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
                 "cva-merge-base-classes-as-array": import("@typescript-eslint/utils/ts-eslint").RuleModule<"stringNeedsArray" | "arrayNeedsSplit", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };
@@ -511,6 +524,8 @@ export declare const reactPreset: ({
         "jsdoc/require-jsdoc"?: undefined;
         "no-console"?: undefined;
         "@typescript-eslint/no-empty-function"?: undefined;
+        "@trackunit/one-component-per-file"?: undefined;
+        "@trackunit/component-name-matches-filename"?: undefined;
     };
     plugins?: undefined;
     settings?: undefined;
@@ -521,6 +536,20 @@ export declare const reactPreset: ({
         "jsdoc/require-jsdoc": string;
         "no-console": string;
         "@typescript-eslint/no-empty-function": string;
+        "@trackunit/one-component-per-file": string;
+        "@trackunit/component-name-matches-filename": string;
+    };
+    plugins?: undefined;
+    settings?: undefined;
+    languageOptions?: undefined;
+} | {
+    files: string[];
+    rules: {
+        "@trackunit/one-component-per-file": string;
+        "@trackunit/component-name-matches-filename": string;
+        "jsdoc/require-jsdoc"?: undefined;
+        "no-console"?: undefined;
+        "@typescript-eslint/no-empty-function"?: undefined;
     };
     plugins?: undefined;
     settings?: undefined;
@@ -596,6 +625,8 @@ export declare const reactPreset: ({
         "jsdoc/require-jsdoc"?: undefined;
         "no-console"?: undefined;
         "@typescript-eslint/no-empty-function"?: undefined;
+        "@trackunit/one-component-per-file"?: undefined;
+        "@trackunit/component-name-matches-filename"?: undefined;
     };
     settings?: undefined;
 })[];

package/src/lib/config/presets/react.js

@@ -66,6 +66,15 @@ exports.reactPreset = [
             "jsdoc/require-jsdoc": "off",
             "no-console": "off",
             "@typescript-eslint/no-empty-function": "off",
+            "@trackunit/one-component-per-file": "off",
+            "@trackunit/component-name-matches-filename": "off",
+        },
+    },
+    {
+        files: ["**/*.spec.ts", "**/*.spec.tsx", "**/*.test.ts", "**/*.test.tsx"],
+        rules: {
+            "@trackunit/one-component-per-file": "off",
+            "@trackunit/component-name-matches-filename": "off",
         },
     },
     {

package/src/lib/rules/component-name-matches-filename/component-name-matches-filename.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ESLint rule: component-name-matches-filename
+ *
+ * Enforces that every exported React component is named after the file it lives in.
+ * For a file named `Foo.tsx`, the exported component must be named `Foo`.
+ *
+ * Anonymous default exports are skipped (no name to compare).
+ * `index.*` files are skipped (they are entry-point re-export files, not component files).
+ *
+ * When combined with `one-component-per-file`, these two rules together fully enforce
+ * the "one named component per file" convention.
+ *
+ * @example
+ * // File: Foo.tsx
+ * // Bad — exported name doesn't match filename
+ * export function Bar() { return <div />; }
+ *
+ * // Good
+ * export function Foo() { return <div />; }
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+type AllowedMismatch = {
+    /** Basename of the file (without extension) where the mismatch is permitted. Supports glob patterns (`*`, `?`). */
+    file: string;
+    /** Exported component name that is permitted despite not matching the filename. Supports glob patterns (`*`, `?`). */
+    component: string;
+};
+type Options = [{
+    allowedMismatches?: ReadonlyArray<AllowedMismatch>;
+}];
+export declare const componentNameMatchesFilename: ESLintUtils.RuleModule<"componentNameMismatch", Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};

package/src/lib/rules/component-name-matches-filename/component-name-matches-filename.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * ESLint rule: component-name-matches-filename
+ *
+ * Enforces that every exported React component is named after the file it lives in.
+ * For a file named `Foo.tsx`, the exported component must be named `Foo`.
+ *
+ * Anonymous default exports are skipped (no name to compare).
+ * `index.*` files are skipped (they are entry-point re-export files, not component files).
+ *
+ * When combined with `one-component-per-file`, these two rules together fully enforce
+ * the "one named component per file" convention.
+ *
+ * @example
+ * // File: Foo.tsx
+ * // Bad — exported name doesn't match filename
+ * export function Bar() { return <div />; }
+ *
+ * // Good
+ * export function Foo() { return <div />; }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.componentNameMatchesFilename = void 0;
+const tslib_1 = require("tslib");
+const utils_1 = require("@typescript-eslint/utils");
+const minimatch_1 = require("minimatch");
+const path_1 = tslib_1.__importDefault(require("path"));
+const component_utils_1 = require("../../utils/component-utils");
+const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}/${name}.ts`);
+exports.componentNameMatchesFilename = createRule({
+    name: "component-name-matches-filename",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Enforce that exported React component names match the filename they live in. " +
+                "index.* files and anonymous default exports are exempt.",
+        },
+        messages: {
+            componentNameMismatch: "Component '{{name}}' should match the filename. " + "Rename it to '{{expected}}' or move it to its own file.",
+        },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    allowedMismatches: {
+                        type: "array",
+                        description: "Pairs that are exempt from the name-matching rule. Both `file` and `component` support glob patterns " +
+                            "(`*`, `?`), so one entry can cover a whole family of files (e.g. { file: '*Context', component: '*Provider' }).",
+                        items: {
+                            type: "object",
+                            properties: {
+                                file: {
+                                    type: "string",
+                                    description: "Basename of the file without extension. Supports glob patterns (`*`, `?`). " +
+                                        "e.g. 'translation' or '*Context'.",
+                                },
+                                component: {
+                                    type: "string",
+                                    description: "Exported component name. Supports glob patterns (`*`, `?`). " + "e.g. 'Trans' or '*Provider'.",
+                                },
+                            },
+                            required: ["file", "component"],
+                            additionalProperties: false,
+                        },
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [{}],
+    create(context, [{ allowedMismatches = [] }]) {
+        const filename = context.filename;
+        const basename = path_1.default.basename(filename, path_1.default.extname(filename));
+        if (basename === "index" || basename === "<input>")
+            return {};
+        // Normalize kebab-case and snake_case filenames to PascalCase.
+        // e.g. `current-weather-status` → `CurrentWeatherStatus`, `app` → `App`.
+        const expectedName = basename
+            .split(/[-_]/)
+            .map(segment => segment.charAt(0).toUpperCase() + segment.slice(1))
+            .join("");
+        const tracker = (0, component_utils_1.createComponentFileTracker)();
+        return {
+            FunctionDeclaration: tracker.onFunctionDeclaration,
+            VariableDeclarator: tracker.onVariableDeclarator,
+            ExportNamedDeclaration: tracker.onExportNamedDeclaration,
+            ExportDefaultDeclaration: tracker.onExportDefaultDeclaration,
+            "Program:exit"() {
+                for (const { name, node } of tracker.getExportedComponents()) {
+                    if (name === null)
+                        continue; // anonymous default exports are exempt
+                    if (name === expectedName)
+                        continue;
+                    const isAllowed = allowedMismatches.some(entry => (0, minimatch_1.minimatch)(basename, entry.file) && (0, minimatch_1.minimatch)(name, entry.component));
+                    if (isAllowed)
+                        continue;
+                    context.report({
+                        node,
+                        messageId: "componentNameMismatch",
+                        data: { name, expected: expectedName },
+                    });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=component-name-matches-filename.js.map

package/src/lib/rules/one-component-per-file/one-component-per-file.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ESLint rule: one-component-per-file
+ *
+ * Enforces that each file contains at most one React component.
+ *
+ * Default mode (`exportedOnly: true`): only one exported component is allowed.
+ * Internal/private components are fine.
+ *
+ * Strict mode (`exportedOnly: false`): only one component total, regardless of
+ * whether it is exported.
+ *
+ * @example
+ * // Bad (default) — two exported components
+ * export function Foo() { return <div />; }
+ * export function Bar() { return <span />; }
+ *
+ * // Good (default) — one exported, one internal
+ * function InternalHelper() { return <span />; }
+ * export function Foo() { return <div><InternalHelper /></div>; }
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+type MessageIds = "tooManyExported" | "tooManyComponents";
+type Options = [{
+    exportedOnly?: boolean;
+}];
+export declare const oneComponentPerFile: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};

package/src/lib/rules/one-component-per-file/one-component-per-file.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * ESLint rule: one-component-per-file
+ *
+ * Enforces that each file contains at most one React component.
+ *
+ * Default mode (`exportedOnly: true`): only one exported component is allowed.
+ * Internal/private components are fine.
+ *
+ * Strict mode (`exportedOnly: false`): only one component total, regardless of
+ * whether it is exported.
+ *
+ * @example
+ * // Bad (default) — two exported components
+ * export function Foo() { return <div />; }
+ * export function Bar() { return <span />; }
+ *
+ * // Good (default) — one exported, one internal
+ * function InternalHelper() { return <span />; }
+ * export function Foo() { return <div><InternalHelper /></div>; }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oneComponentPerFile = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const component_utils_1 = require("../../utils/component-utils");
+const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}/${name}.ts`);
+exports.oneComponentPerFile = createRule({
+    name: "one-component-per-file",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Enforce that each file contains at most one React component. " +
+                "Use exportedOnly: false to also disallow multiple non-exported components.",
+        },
+        messages: {
+            tooManyExported: "Only one component should be exported per file. Move this component to its own file.",
+            tooManyComponents: "Only one component is allowed per file. Move this component to its own file.",
+        },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    exportedOnly: {
+                        type: "boolean",
+                        description: "When true (default), only exported components are counted. " +
+                            "When false, all components in the file count toward the limit.",
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [{ exportedOnly: true }],
+    create(context, [{ exportedOnly = true }]) {
+        const tracker = (0, component_utils_1.createComponentFileTracker)();
+        return {
+            FunctionDeclaration: tracker.onFunctionDeclaration,
+            VariableDeclarator: tracker.onVariableDeclarator,
+            ExportNamedDeclaration: tracker.onExportNamedDeclaration,
+            ExportDefaultDeclaration: tracker.onExportDefaultDeclaration,
+            "Program:exit"() {
+                const components = exportedOnly ? tracker.getExportedComponents() : tracker.getAllComponents();
+                if (components.length <= 1)
+                    return;
+                const messageId = exportedOnly ? "tooManyExported" : "tooManyComponents";
+                for (const { node } of components.slice(1)) {
+                    context.report({ node, messageId });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=one-component-per-file.js.map

package/src/lib/rules-map.d.ts

@@ -1,5 +1,18 @@
 import { ESLintUtils } from "@typescript-eslint/utils";
 export declare const rulesMap: {
+    "component-name-matches-filename": ESLintUtils.RuleModule<"componentNameMismatch", [{
+        allowedMismatches?: ReadonlyArray<{
+            file: string;
+            component: string;
+        }>;
+    }], unknown, ESLintUtils.RuleListener> & {
+        name: string;
+    };
+    "one-component-per-file": ESLintUtils.RuleModule<"tooManyExported" | "tooManyComponents", [{
+        exportedOnly?: boolean;
+    }], unknown, ESLintUtils.RuleListener> & {
+        name: string;
+    };
     "cva-merge-base-classes-as-array": ESLintUtils.RuleModule<"stringNeedsArray" | "arrayNeedsSplit", [], unknown, ESLintUtils.RuleListener> & {
         name: string;
     };

package/src/lib/rules-map.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rulesMap = void 0;
+const component_name_matches_filename_1 = require("./rules/component-name-matches-filename/component-name-matches-filename");
 const cva_merge_base_classes_as_array_1 = require("./rules/cva-merge-base-classes-as-array/cva-merge-base-classes-as-array");
 const design_guideline_button_icon_size_match_1 = require("./rules/design-guideline-button-icon-size-match/design-guideline-button-icon-size-match");
 const no_internal_barrel_files_1 = require("./rules/no-internal-barrel-files/no-internal-barrel-files");
@@ -8,6 +9,7 @@ const no_internal_graphql_when_tagged_with_gql_public_1 = require("./rules/no-in
 const no_jest_mock_trackunit_react_core_hooks_1 = require("./rules/no-jest-mock-trackunit-react-core-hooks/no-jest-mock-trackunit-react-core-hooks");
 const no_template_strings_in_classname_prop_1 = require("./rules/no-template-strings-in-classname-prop/no-template-strings-in-classname-prop");
 const no_typescript_assertion_1 = require("./rules/no-typescript-assertion/no-typescript-assertion");
+const one_component_per_file_1 = require("./rules/one-component-per-file/one-component-per-file");
 const prefer_destructured_imports_1 = require("./rules/prefer-destructured-imports/prefer-destructured-imports");
 const prefer_event_specific_callback_naming_1 = require("./rules/prefer-event-specific-callback-naming/prefer-event-specific-callback-naming");
 const prefer_field_components_1 = require("./rules/prefer-field-components/prefer-field-components");
@@ -17,6 +19,8 @@ const require_component_prop_contracts_1 = require("./rules/require-component-pr
 const require_list_item_virtualization_props_1 = require("./rules/require-list-item-virtualization-props/require-list-item-virtualization-props");
 const require_optional_prop_initialization_1 = require("./rules/require-optional-prop-initialization/require-optional-prop-initialization");
 exports.rulesMap = {
+    "component-name-matches-filename": component_name_matches_filename_1.componentNameMatchesFilename,
+    "one-component-per-file": one_component_per_file_1.oneComponentPerFile,
     "cva-merge-base-classes-as-array": cva_merge_base_classes_as_array_1.cvaMergeBaseClassesAsArray,
     "no-internal-barrel-files": no_internal_barrel_files_1.noInternalBarrelFiles,
     "no-typescript-assertion": no_typescript_assertion_1.noTypescriptAssertion,

package/src/lib/utils/component-utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared utilities for detecting React components and their export status in a file.
+ *
+ * Used by `one-component-per-file` and `component-name-matches-filename` rules.
+ *
+ * ## Handled patterns
+ * - `export function Foo() {}`
+ * - `export const Foo = () => {}`
+ * - `export default function Foo() {}`
+ * - `export default () => {}`
+ * - `const Foo = () => {}; export { Foo }`
+ * - `const Foo = () => {}; export { Foo as Bar }`
+ * - `export const Foo = forwardRef(...)` / `memo(...)` (React wrapper calls)
+ */
+import { TSESTree } from "@typescript-eslint/utils";
+export type ComponentEntry = {
+    /** The name as it appears in the export (null for anonymous default exports). */
+    name: string | null;
+    /** The declaration node to report on (FunctionDeclaration or VariableDeclarator). */
+    node: TSESTree.Node;
+};
+/**
+ * Creates a stateful tracker that collects React component declarations and export
+ * information as ESLint visits AST nodes. Call `getExportedComponents()` or
+ * `getAllComponents()` inside a `Program:exit` handler once traversal is complete.
+ */
+export declare const createComponentFileTracker: () => {
+    onFunctionDeclaration(node: TSESTree.FunctionDeclaration): void;
+    onVariableDeclarator(node: TSESTree.VariableDeclarator): void;
+    onExportNamedDeclaration(node: TSESTree.ExportNamedDeclaration): void;
+    onExportDefaultDeclaration(node: TSESTree.ExportDefaultDeclaration): void;
+    /** Returns all exported React component entries. Call from `Program:exit`. */
+    getExportedComponents(): Array<ComponentEntry>;
+    /** Returns all top-level React component entries, exported or not. Call from `Program:exit`. */
+    getAllComponents(): Array<ComponentEntry>;
+};