@trackunit/eslint-plugin-trackunit 0.0.2

package/src/lib/rules/prefer-mouse-event-handler-in-react-props/prefer-mouse-event-handler-in-react-props.js

@@ -0,0 +1,402 @@
+"use strict";
+/**
+ * ESLint rule: prefer-mouse-event-handler-in-react-props
+ *
+ * Enforces using MouseEventHandler<T> instead of () => void or (e: MouseEvent) => void
+ * for onClick* props in React components. This ensures proper React typing and consistency.
+ *
+ * Only flags properties in actual React component props, not in hook options or other interfaces.
+ *
+ * Uses ESLint suggestions (not autofix) to let users choose the appropriate element type.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preferMouseEventHandlerInReactProps = void 0;
+const tslib_1 = require("tslib");
+const utils_1 = require("@typescript-eslint/utils");
+const ts = tslib_1.__importStar(require("typescript"));
+const ast_utils_1 = require("../../utils/ast-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`);
+/**
+ * Checks if a property name starts with "onClick" (case-sensitive).
+ */
+const isOnClickProp = (name) => {
+    return name.startsWith("onClick");
+};
+/**
+ * Extracts the element type from a MouseEvent generic type annotation.
+ * Returns null if not a MouseEvent type or no generic provided.
+ *
+ * Examples:
+ * - MouseEvent<HTMLButtonElement> -> "HTMLButtonElement"
+ * - React.MouseEvent<HTMLDivElement> -> "HTMLDivElement"
+ * - MouseEvent -> null (no generic)
+ */
+const extractElementTypeFromMouseEvent = (typeAnnotation) => {
+    if (typeAnnotation.type !== utils_1.AST_NODE_TYPES.TSTypeReference) {
+        return null;
+    }
+    const { typeName, typeArguments } = typeAnnotation;
+    let isMouseEvent = false;
+    if (typeName.type === utils_1.AST_NODE_TYPES.Identifier) {
+        isMouseEvent = typeName.name === "MouseEvent";
+    }
+    else if (typeName.type === utils_1.AST_NODE_TYPES.TSQualifiedName) {
+        isMouseEvent =
+            typeName.left.type === utils_1.AST_NODE_TYPES.Identifier &&
+                typeName.left.name === "React" &&
+                typeName.right.name === "MouseEvent";
+    }
+    if (!isMouseEvent) {
+        return null;
+    }
+    if (!typeArguments || typeArguments.params.length === 0) {
+        return null;
+    }
+    const firstTypeArg = typeArguments.params[0];
+    if (firstTypeArg?.type === utils_1.AST_NODE_TYPES.TSTypeReference) {
+        if (firstTypeArg.typeName.type === utils_1.AST_NODE_TYPES.Identifier) {
+            return firstTypeArg.typeName.name;
+        }
+    }
+    return null;
+};
+/**
+ * Checks if a type annotation is a MouseEvent type (with or without generics).
+ */
+const isMouseEventType = (typeAnnotation) => {
+    if (typeAnnotation.type !== utils_1.AST_NODE_TYPES.TSTypeReference) {
+        return false;
+    }
+    const { typeName } = typeAnnotation;
+    if (typeName.type === utils_1.AST_NODE_TYPES.Identifier) {
+        return typeName.name === "MouseEvent";
+    }
+    if (typeName.type === utils_1.AST_NODE_TYPES.TSQualifiedName) {
+        return (typeName.left.type === utils_1.AST_NODE_TYPES.Identifier &&
+            typeName.left.name === "React" &&
+            typeName.right.name === "MouseEvent");
+    }
+    return false;
+};
+/**
+ * Checks if a function type returns void.
+ */
+const hasVoidReturn = (funcType) => {
+    const { returnType } = funcType;
+    if (!returnType) {
+        return true;
+    }
+    const typeAnnotation = returnType.typeAnnotation;
+    if (typeAnnotation.type === utils_1.AST_NODE_TYPES.TSVoidKeyword) {
+        return true;
+    }
+    return false;
+};
+/**
+ * Analyzes a TSFunctionType to determine if it should be flagged.
+ */
+const analyzeFunctionType = (funcType) => {
+    if (!hasVoidReturn(funcType)) {
+        return { shouldFlag: false };
+    }
+    const { params } = funcType;
+    // Case A: No parameters - () => void
+    if (params.length === 0) {
+        return {
+            shouldFlag: true,
+            inferredElementType: null,
+            typeAnnotationNode: funcType,
+        };
+    }
+    // Case B: Exactly one parameter that is MouseEvent
+    if (params.length === 1) {
+        const param = params[0];
+        let paramTypeAnnotation;
+        if (param?.type === utils_1.AST_NODE_TYPES.Identifier && param.typeAnnotation) {
+            paramTypeAnnotation = param.typeAnnotation.typeAnnotation;
+        }
+        if (paramTypeAnnotation && isMouseEventType(paramTypeAnnotation)) {
+            const elementType = extractElementTypeFromMouseEvent(paramTypeAnnotation);
+            return {
+                shouldFlag: true,
+                inferredElementType: elementType,
+                typeAnnotationNode: funcType,
+            };
+        }
+    }
+    return { shouldFlag: false };
+};
+/**
+ * Creates suggestion fixes for a given element type.
+ */
+const createSuggestion = (elementType, typeAnnotationNode) => {
+    return {
+        messageId: "suggestMouseEventHandler",
+        data: { elementType },
+        fix: fixer => {
+            return fixer.replaceText(typeAnnotationNode, `MouseEventHandler<${elementType}>`);
+        },
+    };
+};
+/**
+ * Known valid HTML element types for MouseEventHandler.
+ */
+const VALID_HTML_ELEMENT_TYPES = new Set([
+    "Element",
+    "HTMLElement",
+    "HTMLAnchorElement",
+    "HTMLButtonElement",
+    "HTMLDivElement",
+    "HTMLFormElement",
+    "HTMLImageElement",
+    "HTMLInputElement",
+    "HTMLLabelElement",
+    "HTMLLIElement",
+    "HTMLParagraphElement",
+    "HTMLSelectElement",
+    "HTMLSpanElement",
+    "HTMLTableElement",
+    "HTMLTableRowElement",
+    "HTMLTableCellElement",
+    "HTMLTextAreaElement",
+    "HTMLUListElement",
+    "SVGElement",
+    "SVGSVGElement",
+]);
+/**
+ * Extracts element type from a MouseEventHandler type string.
+ */
+const extractElementTypeFromTypeString = (typeString) => {
+    const match = typeString.match(/MouseEventHandler<([^>]+)>/);
+    if (match?.[1]) {
+        const elementType = match[1].trim();
+        if (VALID_HTML_ELEMENT_TYPES.has(elementType)) {
+            return elementType;
+        }
+    }
+    return null;
+};
+/**
+ * Tries to infer the element type by finding where the prop is used in JSX.
+ */
+const inferElementTypeFromUsage = (propName, context) => {
+    try {
+        const services = utils_1.ESLintUtils.getParserServices(context);
+        const checker = services.program.getTypeChecker();
+        const sourceFile = services.program.getSourceFile(context.filename);
+        if (!sourceFile) {
+            return null;
+        }
+        let inferredType = null;
+        const visit = (node) => {
+            if (ts.isJsxAttribute(node)) {
+                const attrName = node.name.getText(sourceFile);
+                if (attrName.startsWith("on")) {
+                    const initializer = node.initializer;
+                    if (initializer && ts.isJsxExpression(initializer) && initializer.expression) {
+                        const expr = initializer.expression;
+                        let referencedName = null;
+                        if (ts.isIdentifier(expr) && expr.text === propName) {
+                            referencedName = propName;
+                        }
+                        if (ts.isArrowFunction(expr) && ts.isCallExpression(expr.body)) {
+                            const callee = expr.body.expression;
+                            if (ts.isIdentifier(callee) && callee.text === propName) {
+                                referencedName = propName;
+                            }
+                        }
+                        if (referencedName) {
+                            const contextualType = checker.getContextualType(expr);
+                            if (contextualType) {
+                                const typeString = checker.typeToString(contextualType);
+                                const elementType = extractElementTypeFromTypeString(typeString);
+                                if (elementType) {
+                                    inferredType = elementType;
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+        return inferredType;
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Gets onClick* properties from a component's props type annotation.
+ */
+const getOnClickPropsFromType = (context, typeAnnotation) => {
+    if (!typeAnnotation) {
+        return [];
+    }
+    const result = [];
+    // Handle inline type literals: ({ onClick }: { onClick: () => void }) => ...
+    if (typeAnnotation.type === utils_1.AST_NODE_TYPES.TSTypeLiteral) {
+        for (const member of typeAnnotation.members) {
+            if (member.type === utils_1.AST_NODE_TYPES.TSPropertySignature &&
+                member.key.type === utils_1.AST_NODE_TYPES.Identifier &&
+                isOnClickProp(member.key.name) &&
+                member.typeAnnotation?.typeAnnotation.type === utils_1.AST_NODE_TYPES.TSFunctionType) {
+                result.push({
+                    name: member.key.name,
+                    typeNode: member.typeAnnotation.typeAnnotation,
+                    propertyNode: member,
+                });
+            }
+        }
+        return result;
+    }
+    // Handle type references: ({ onClick }: ButtonProps) => ...
+    if (typeAnnotation.type === utils_1.AST_NODE_TYPES.TSTypeReference) {
+        try {
+            const services = utils_1.ESLintUtils.getParserServices(context);
+            const checker = services.program.getTypeChecker();
+            const tsNode = services.esTreeNodeToTSNodeMap.get(typeAnnotation);
+            const type = checker.getTypeAtLocation(tsNode);
+            for (const prop of type.getProperties()) {
+                if (isOnClickProp(prop.name)) {
+                    const propType = checker.getTypeOfSymbolAtLocation(prop, tsNode);
+                    const callSignatures = propType.getCallSignatures();
+                    if (callSignatures.length > 0) {
+                        // Find the corresponding ESTree node for this property
+                        const declarations = prop.getDeclarations();
+                        const decl = declarations?.[0];
+                        if (decl) {
+                            const esTreeNode = services.tsNodeToESTreeNodeMap.get(decl);
+                            if (esTreeNode.type === utils_1.AST_NODE_TYPES.TSPropertySignature &&
+                                esTreeNode.typeAnnotation?.typeAnnotation.type === utils_1.AST_NODE_TYPES.TSFunctionType) {
+                                result.push({
+                                    name: prop.name,
+                                    typeNode: esTreeNode.typeAnnotation.typeAnnotation,
+                                    propertyNode: esTreeNode,
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Type checking failed - silently skip
+        }
+    }
+    return result;
+};
+exports.preferMouseEventHandlerInReactProps = createRule({
+    name: "prefer-mouse-event-handler-in-react-props",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Enforce using MouseEventHandler<T> instead of () => void or (e: MouseEvent) => void for onClick* props in React components. " +
+                "This ensures proper React typing and consistency across the codebase.",
+        },
+        hasSuggestions: true,
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    allowedNames: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Prop names to exempt from this rule",
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            preferMouseEventHandler: "Prop '{{propName}}' should use MouseEventHandler<T> instead of {{currentType}}.",
+            suggestMouseEventHandler: "Use MouseEventHandler<{{elementType}}>",
+        },
+    },
+    defaultOptions: [
+        {
+            allowedNames: [],
+        },
+    ],
+    create(context, [options]) {
+        const allowedNames = options.allowedNames ?? [];
+        // Only run on .tsx files
+        const filename = context.filename;
+        if (!filename.endsWith(".tsx")) {
+            return {};
+        }
+        // Track reported property nodes to avoid duplicate reports when multiple components use the same interface
+        const reportedNodes = new Set();
+        const checkComponentProps = (_node, propsParam) => {
+            if (!propsParam) {
+                return;
+            }
+            let typeAnnotation;
+            // Handle both regular parameters (props: Props) and destructured parameters ({prop1, prop2}: Props)
+            if (propsParam.type === utils_1.AST_NODE_TYPES.Identifier || propsParam.type === utils_1.AST_NODE_TYPES.ObjectPattern) {
+                typeAnnotation = propsParam.typeAnnotation?.typeAnnotation;
+            }
+            else {
+                return;
+            }
+            const onClickProps = getOnClickPropsFromType(context, typeAnnotation);
+            for (const { name: propName, typeNode, propertyNode } of onClickProps) {
+                // Skip if already reported (prevents duplicates when multiple components use the same interface)
+                if (reportedNodes.has(propertyNode)) {
+                    continue;
+                }
+                // Check if it's in the allowed list
+                if (allowedNames.includes(propName)) {
+                    continue;
+                }
+                // Analyze the function type
+                const result = analyzeFunctionType(typeNode);
+                if (!result.shouldFlag) {
+                    continue;
+                }
+                // Get the current type as a string for the error message
+                const sourceCode = context.sourceCode;
+                const currentType = sourceCode.getText(typeNode);
+                // Build suggestions
+                const suggestions = [];
+                let inferredElementType = result.inferredElementType;
+                if (!inferredElementType) {
+                    inferredElementType = inferElementTypeFromUsage(propName, context);
+                }
+                if (inferredElementType) {
+                    suggestions.push(createSuggestion(inferredElementType, result.typeAnnotationNode));
+                }
+                else {
+                    suggestions.push(createSuggestion("HTMLButtonElement", result.typeAnnotationNode));
+                    suggestions.push(createSuggestion("HTMLElement", result.typeAnnotationNode));
+                    suggestions.push(createSuggestion("HTMLDivElement", result.typeAnnotationNode));
+                }
+                // Mark as reported to prevent duplicates
+                reportedNodes.add(propertyNode);
+                context.report({
+                    node: propertyNode,
+                    messageId: "preferMouseEventHandler",
+                    data: {
+                        propName,
+                        currentType,
+                    },
+                    suggest: suggestions,
+                });
+            }
+        };
+        return {
+            FunctionDeclaration(node) {
+                if ((0, ast_utils_1.isReactComponent)(node)) {
+                    checkComponentProps(node, node.params[0]);
+                }
+            },
+            ArrowFunctionExpression(node) {
+                if ((0, ast_utils_1.isReactComponent)(node)) {
+                    checkComponentProps(node, node.params[0]);
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=prefer-mouse-event-handler-in-react-props.js.map

package/src/lib/rules/prefer-mouse-event-handler-in-react-props/prefer-mouse-event-handler-in-react-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-mouse-event-handler-in-react-props.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/prefer-mouse-event-handler-in-react-props/prefer-mouse-event-handler-in-react-props.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;AAEH,oDAA2F;AAC3F,uDAAiC;AACjC,qDAAyD;AAQzD,MAAM,UAAU,GAAG,mBAAW,CAAC,WAAW,CACxC,IAAI,CAAC,EAAE,CAAC,6FAA6F,IAAI,IAAI,IAAI,KAAK,CACvH,CAAC;AAeF;;GAEG;AACH,MAAM,aAAa,GAAG,CAAC,IAAY,EAAW,EAAE;IAC9C,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,gCAAgC,GAAG,CAAC,cAAiC,EAAiB,EAAE;IAC5F,IAAI,cAAc,CAAC,IAAI,KAAK,sBAAc,CAAC,eAAe,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,cAAc,CAAC;IAEnD,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,IAAI,QAAQ,CAAC,IAAI,KAAK,sBAAc,CAAC,UAAU,EAAE,CAAC;QAChD,YAAY,GAAG,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC;IAChD,CAAC;SAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,sBAAc,CAAC,eAAe,EAAE,CAAC;QAC5D,YAAY;YACV,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,sBAAc,CAAC,UAAU;gBAChD,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;gBAC9B,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,YAAY,EAAE,IAAI,KAAK,sBAAc,CAAC,eAAe,EAAE,CAAC;QAC1D,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,KAAK,sBAAc,CAAC,UAAU,EAAE,CAAC;YAC7D,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,gBAAgB,GAAG,CAAC,cAAiC,EAAW,EAAE;IACtE,IAAI,cAAc,CAAC,IAAI,KAAK,sBAAc,CAAC,eAAe,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC;IAEpC,IAAI,QAAQ,CAAC,IAAI,KAAK,sBAAc,CAAC,UAAU,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC;IACxC,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,sBAAc,CAAC,eAAe,EAAE,CAAC;QACrD,OAAO,CACL,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,sBAAc,CAAC,UAAU;YAChD,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;YAC9B,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CACrC,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,aAAa,GAAG,CAAC,QAAiC,EAAW,EAAE;IACnE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;IAEhC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;IAEjD,IAAI,cAAc,CAAC,IAAI,KAAK,sBAAc,CAAC,aAAa,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAUF;;GAEG;AACH,MAAM,mBAAmB,GAAG,CAAC,QAAiC,EAAkB,EAAE;IAChF,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IAE5B,qCAAqC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,mBAAmB,EAAE,IAAI;YACzB,kBAAkB,EAAE,QAAQ;SAC7B,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAExB,IAAI,mBAAkD,CAAC;QAEvD,IAAI,KAAK,EAAE,IAAI,KAAK,sBAAc,CAAC,UAAU,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACtE,mBAAmB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;QAC5D,CAAC;QAED,IAAI,mBAAmB,IAAI,gBAAgB,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACjE,MAAM,WAAW,GAAG,gCAAgC,CAAC,mBAAmB,CAAC,CAAC;YAC1E,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,mBAAmB,EAAE,WAAW;gBAChC,kBAAkB,EAAE,QAAQ;aAC7B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,kBAA2C,EAAoB,EAAE;IAC9G,OAAO;QACL,SAAS,EAAE,0BAA0B;QACrC,IAAI,EAAE,EAAE,WAAW,EAAE;QACrB,GAAG,EAAE,KAAK,CAAC,EAAE;YACX,OAAO,KAAK,CAAC,WAAW,CAAC,kBAAkB,EAAE,qBAAqB,WAAW,GAAG,CAAC,CAAC;QACpF,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,SAAS;IACT,aAAa;IACb,mBAAmB;IACnB,mBAAmB;IACnB,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,sBAAsB;IACtB,mBAAmB;IACnB,iBAAiB;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,qBAAqB;IACrB,kBAAkB;IAClB,YAAY;IACZ,eAAe;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,gCAAgC,GAAG,CAAC,UAAkB,EAAiB,EAAE;IAC7E,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC7D,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,wBAAwB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9C,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,yBAAyB,GAAG,CAChC,QAAgB,EAChB,OAAiE,EAClD,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,mBAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEpE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,YAAY,GAAkB,IAAI,CAAC;QAEvC,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;YACpC,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAE/C,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;oBAErC,IAAI,WAAW,IAAI,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;wBAC7E,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC;wBACpC,IAAI,cAAc,GAAkB,IAAI,CAAC;wBAEzC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;4BACpD,cAAc,GAAG,QAAQ,CAAC;wBAC5B,CAAC;wBAED,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;4BAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;4BACpC,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gCACxD,cAAc,GAAG,QAAQ,CAAC;4BAC5B,CAAC;wBACH,CAAC;wBAED,IAAI,cAAc,EAAE,CAAC;4BACnB,MAAM,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;4BACvD,IAAI,cAAc,EAAE,CAAC;gCACnB,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;gCACxD,MAAM,WAAW,GAAG,gCAAgC,CAAC,UAAU,CAAC,CAAC;gCACjE,IAAI,WAAW,EAAE,CAAC;oCAChB,YAAY,GAAG,WAAW,CAAC;gCAC7B,CAAC;4BACH,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,uBAAuB,GAAG,CAC9B,OAAiE,EACjE,cAA6C,EAC4C,EAAE;IAC3F,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAA4F,EAAE,CAAC;IAE3G,6EAA6E;IAC7E,IAAI,cAAc,CAAC,IAAI,KAAK,sBAAc,CAAC,aAAa,EAAE,CAAC;QACzD,KAAK,MAAM,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;YAC5C,IACE,MAAM,CAAC,IAAI,KAAK,sBAAc,CAAC,mBAAmB;gBAClD,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,sBAAc,CAAC,UAAU;gBAC7C,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC9B,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,IAAI,KAAK,sBAAc,CAAC,cAAc,EAC5E,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;oBACrB,QAAQ,EAAE,MAAM,CAAC,cAAc,CAAC,cAAc;oBAC9C,YAAY,EAAE,MAAM;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,4DAA4D;IAC5D,IAAI,cAAc,CAAC,IAAI,KAAK,sBAAc,CAAC,eAAe,EAAE,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,mBAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAClE,MAAM,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAE/C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;gBACxC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBACjE,MAAM,cAAc,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;oBAEpD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9B,uDAAuD;wBACvD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;wBAC5C,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;wBAC/B,IAAI,IAAI,EAAE,CAAC;4BACT,MAAM,UAAU,GAAG,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;4BAC5D,IACE,UAAU,CAAC,IAAI,KAAK,sBAAc,CAAC,mBAAmB;gCACtD,UAAU,CAAC,cAAc,EAAE,cAAc,CAAC,IAAI,KAAK,sBAAc,CAAC,cAAc,EAChF,CAAC;gCACD,MAAM,CAAC,IAAI,CAAC;oCACV,IAAI,EAAE,IAAI,CAAC,IAAI;oCACf,QAAQ,EAAE,UAAU,CAAC,cAAc,CAAC,cAAc;oCAClD,YAAY,EAAE,UAAU;iCACzB,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEW,QAAA,mCAAmC,GAAG,UAAU,CAAsB;IACjF,IAAI,EAAE,2CAA2C;IACjD,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,8HAA8H;gBAC9H,uEAAuE;SAC1E;QACD,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,YAAY,EAAE;wBACZ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,qCAAqC;qBACnD;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,QAAQ,EAAE;YACR,uBAAuB,EAAE,iFAAiF;YAC1G,wBAAwB,EAAE,wCAAwC;SACnE;KACF;IACD,cAAc,EAAE;QACd;YACE,YAAY,EAAE,EAAE;SACjB;KACF;IACD,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC;QACvB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAEhD,yBAAyB;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,2GAA2G;QAC3G,MAAM,aAAa,GAAG,IAAI,GAAG,EAAiB,CAAC;QAE/C,MAAM,mBAAmB,GAAG,CAC1B,KAAsE,EACtE,UAA0C,EAC1C,EAAE;YACF,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,IAAI,cAA6C,CAAC;YAElD,oGAAoG;YACpG,IAAI,UAAU,CAAC,IAAI,KAAK,sBAAc,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,sBAAc,CAAC,aAAa,EAAE,CAAC;gBACtG,cAAc,GAAG,UAAU,CAAC,cAAc,EAAE,cAAc,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,OAAO;YACT,CAAC;YAED,MAAM,YAAY,GAAG,uBAAuB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAEtE,KAAK,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,YAAY,EAAE,CAAC;gBACtE,iGAAiG;gBACjG,IAAI,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;oBACpC,SAAS;gBACX,CAAC;gBAED,oCAAoC;gBACpC,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACpC,SAAS;gBACX,CAAC;gBAED,4BAA4B;gBAC5B,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBAE7C,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;oBACvB,SAAS;gBACX,CAAC;gBAED,yDAAyD;gBACzD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;gBACtC,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAEjD,oBAAoB;gBACpB,MAAM,WAAW,GAA4B,EAAE,CAAC;gBAEhD,IAAI,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC;gBAErD,IAAI,CAAC,mBAAmB,EAAE,CAAC;oBACzB,mBAAmB,GAAG,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACrE,CAAC;gBAED,IAAI,mBAAmB,EAAE,CAAC;oBACxB,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBACrF,CAAC;qBAAM,CAAC;oBACN,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;oBACnF,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;oBAC7E,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBAClF,CAAC;gBAED,yCAAyC;gBACzC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAEhC,OAAO,CAAC,MAAM,CAAC;oBACb,IAAI,EAAE,YAAY;oBAClB,SAAS,EAAE,yBAAyB;oBACpC,IAAI,EAAE;wBACJ,QAAQ;wBACR,WAAW;qBACZ;oBACD,OAAO,EAAE,WAAW;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,OAAO;YACL,mBAAmB,CAAC,IAAkC;gBACpD,IAAI,IAAA,4BAAgB,EAAC,IAAI,CAAC,EAAE,CAAC;oBAC3B,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAED,uBAAuB,CAAC,IAAsC;gBAC5D,IAAI,IAAA,4BAAgB,EAAC,IAAI,CAAC,EAAE,CAAC;oBAC3B,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["/**\n * ESLint rule: prefer-mouse-event-handler-in-react-props\n *\n * Enforces using MouseEventHandler<T> instead of () => void or (e: MouseEvent) => void\n * for onClick* props in React components. This ensures proper React typing and consistency.\n *\n * Only flags properties in actual React component props, not in hook options or other interfaces.\n *\n * Uses ESLint suggestions (not autofix) to let users choose the appropriate element type.\n */\n\nimport { AST_NODE_TYPES, ESLintUtils, TSESLint, TSESTree } from \"@typescript-eslint/utils\";\nimport * as ts from \"typescript\";\nimport { isReactComponent } from \"../../utils/ast-utils\";\n\ntype SuggestionResult = {\n  messageId: \"suggestMouseEventHandler\";\n  data: { elementType: string };\n  fix: (fixer: TSESLint.RuleFixer) => TSESLint.RuleFix;\n};\n\nconst createRule = ESLintUtils.RuleCreator(\n  name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}/${name}.ts`\n);\n\ntype Options = [\n  {\n    /**\n     * Prop names to exempt from this rule.\n     *\n     * @example [\"onClick\"]\n     */\n    allowedNames?: ReadonlyArray<string>;\n  },\n];\n\ntype MessageIds = \"preferMouseEventHandler\" | \"suggestMouseEventHandler\";\n\n/**\n * Checks if a property name starts with \"onClick\" (case-sensitive).\n */\nconst isOnClickProp = (name: string): boolean => {\n  return name.startsWith(\"onClick\");\n};\n\n/**\n * Extracts the element type from a MouseEvent generic type annotation.\n * Returns null if not a MouseEvent type or no generic provided.\n *\n * Examples:\n * - MouseEvent<HTMLButtonElement> -> \"HTMLButtonElement\"\n * - React.MouseEvent<HTMLDivElement> -> \"HTMLDivElement\"\n * - MouseEvent -> null (no generic)\n */\nconst extractElementTypeFromMouseEvent = (typeAnnotation: TSESTree.TypeNode): string | null => {\n  if (typeAnnotation.type !== AST_NODE_TYPES.TSTypeReference) {\n    return null;\n  }\n\n  const { typeName, typeArguments } = typeAnnotation;\n\n  let isMouseEvent = false;\n\n  if (typeName.type === AST_NODE_TYPES.Identifier) {\n    isMouseEvent = typeName.name === \"MouseEvent\";\n  } else if (typeName.type === AST_NODE_TYPES.TSQualifiedName) {\n    isMouseEvent =\n      typeName.left.type === AST_NODE_TYPES.Identifier &&\n      typeName.left.name === \"React\" &&\n      typeName.right.name === \"MouseEvent\";\n  }\n\n  if (!isMouseEvent) {\n    return null;\n  }\n\n  if (!typeArguments || typeArguments.params.length === 0) {\n    return null;\n  }\n\n  const firstTypeArg = typeArguments.params[0];\n  if (firstTypeArg?.type === AST_NODE_TYPES.TSTypeReference) {\n    if (firstTypeArg.typeName.type === AST_NODE_TYPES.Identifier) {\n      return firstTypeArg.typeName.name;\n    }\n  }\n\n  return null;\n};\n\n/**\n * Checks if a type annotation is a MouseEvent type (with or without generics).\n */\nconst isMouseEventType = (typeAnnotation: TSESTree.TypeNode): boolean => {\n  if (typeAnnotation.type !== AST_NODE_TYPES.TSTypeReference) {\n    return false;\n  }\n\n  const { typeName } = typeAnnotation;\n\n  if (typeName.type === AST_NODE_TYPES.Identifier) {\n    return typeName.name === \"MouseEvent\";\n  }\n\n  if (typeName.type === AST_NODE_TYPES.TSQualifiedName) {\n    return (\n      typeName.left.type === AST_NODE_TYPES.Identifier &&\n      typeName.left.name === \"React\" &&\n      typeName.right.name === \"MouseEvent\"\n    );\n  }\n\n  return false;\n};\n\n/**\n * Checks if a function type returns void.\n */\nconst hasVoidReturn = (funcType: TSESTree.TSFunctionType): boolean => {\n  const { returnType } = funcType;\n\n  if (!returnType) {\n    return true;\n  }\n\n  const typeAnnotation = returnType.typeAnnotation;\n\n  if (typeAnnotation.type === AST_NODE_TYPES.TSVoidKeyword) {\n    return true;\n  }\n\n  return false;\n};\n\ntype AnalysisResult =\n  | { shouldFlag: false }\n  | {\n      shouldFlag: true;\n      inferredElementType: string | null;\n      typeAnnotationNode: TSESTree.TSFunctionType;\n    };\n\n/**\n * Analyzes a TSFunctionType to determine if it should be flagged.\n */\nconst analyzeFunctionType = (funcType: TSESTree.TSFunctionType): AnalysisResult => {\n  if (!hasVoidReturn(funcType)) {\n    return { shouldFlag: false };\n  }\n\n  const { params } = funcType;\n\n  // Case A: No parameters - () => void\n  if (params.length === 0) {\n    return {\n      shouldFlag: true,\n      inferredElementType: null,\n      typeAnnotationNode: funcType,\n    };\n  }\n\n  // Case B: Exactly one parameter that is MouseEvent\n  if (params.length === 1) {\n    const param = params[0];\n\n    let paramTypeAnnotation: TSESTree.TypeNode | undefined;\n\n    if (param?.type === AST_NODE_TYPES.Identifier && param.typeAnnotation) {\n      paramTypeAnnotation = param.typeAnnotation.typeAnnotation;\n    }\n\n    if (paramTypeAnnotation && isMouseEventType(paramTypeAnnotation)) {\n      const elementType = extractElementTypeFromMouseEvent(paramTypeAnnotation);\n      return {\n        shouldFlag: true,\n        inferredElementType: elementType,\n        typeAnnotationNode: funcType,\n      };\n    }\n  }\n\n  return { shouldFlag: false };\n};\n\n/**\n * Creates suggestion fixes for a given element type.\n */\nconst createSuggestion = (elementType: string, typeAnnotationNode: TSESTree.TSFunctionType): SuggestionResult => {\n  return {\n    messageId: \"suggestMouseEventHandler\",\n    data: { elementType },\n    fix: fixer => {\n      return fixer.replaceText(typeAnnotationNode, `MouseEventHandler<${elementType}>`);\n    },\n  };\n};\n\n/**\n * Known valid HTML element types for MouseEventHandler.\n */\nconst VALID_HTML_ELEMENT_TYPES = new Set([\n  \"Element\",\n  \"HTMLElement\",\n  \"HTMLAnchorElement\",\n  \"HTMLButtonElement\",\n  \"HTMLDivElement\",\n  \"HTMLFormElement\",\n  \"HTMLImageElement\",\n  \"HTMLInputElement\",\n  \"HTMLLabelElement\",\n  \"HTMLLIElement\",\n  \"HTMLParagraphElement\",\n  \"HTMLSelectElement\",\n  \"HTMLSpanElement\",\n  \"HTMLTableElement\",\n  \"HTMLTableRowElement\",\n  \"HTMLTableCellElement\",\n  \"HTMLTextAreaElement\",\n  \"HTMLUListElement\",\n  \"SVGElement\",\n  \"SVGSVGElement\",\n]);\n\n/**\n * Extracts element type from a MouseEventHandler type string.\n */\nconst extractElementTypeFromTypeString = (typeString: string): string | null => {\n  const match = typeString.match(/MouseEventHandler<([^>]+)>/);\n  if (match?.[1]) {\n    const elementType = match[1].trim();\n    if (VALID_HTML_ELEMENT_TYPES.has(elementType)) {\n      return elementType;\n    }\n  }\n  return null;\n};\n\n/**\n * Tries to infer the element type by finding where the prop is used in JSX.\n */\nconst inferElementTypeFromUsage = (\n  propName: string,\n  context: TSESLint.RuleContext<MessageIds, ReadonlyArray<unknown>>\n): string | null => {\n  try {\n    const services = ESLintUtils.getParserServices(context);\n    const checker = services.program.getTypeChecker();\n    const sourceFile = services.program.getSourceFile(context.filename);\n\n    if (!sourceFile) {\n      return null;\n    }\n\n    let inferredType: string | null = null;\n\n    const visit = (node: ts.Node): void => {\n      if (ts.isJsxAttribute(node)) {\n        const attrName = node.name.getText(sourceFile);\n\n        if (attrName.startsWith(\"on\")) {\n          const initializer = node.initializer;\n\n          if (initializer && ts.isJsxExpression(initializer) && initializer.expression) {\n            const expr = initializer.expression;\n            let referencedName: string | null = null;\n\n            if (ts.isIdentifier(expr) && expr.text === propName) {\n              referencedName = propName;\n            }\n\n            if (ts.isArrowFunction(expr) && ts.isCallExpression(expr.body)) {\n              const callee = expr.body.expression;\n              if (ts.isIdentifier(callee) && callee.text === propName) {\n                referencedName = propName;\n              }\n            }\n\n            if (referencedName) {\n              const contextualType = checker.getContextualType(expr);\n              if (contextualType) {\n                const typeString = checker.typeToString(contextualType);\n                const elementType = extractElementTypeFromTypeString(typeString);\n                if (elementType) {\n                  inferredType = elementType;\n                }\n              }\n            }\n          }\n        }\n      }\n\n      ts.forEachChild(node, visit);\n    };\n\n    visit(sourceFile);\n    return inferredType;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Gets onClick* properties from a component's props type annotation.\n */\nconst getOnClickPropsFromType = (\n  context: TSESLint.RuleContext<MessageIds, ReadonlyArray<unknown>>,\n  typeAnnotation: TSESTree.TypeNode | undefined\n): Array<{ name: string; typeNode: TSESTree.TSFunctionType; propertyNode: TSESTree.Node }> => {\n  if (!typeAnnotation) {\n    return [];\n  }\n\n  const result: Array<{ name: string; typeNode: TSESTree.TSFunctionType; propertyNode: TSESTree.Node }> = [];\n\n  // Handle inline type literals: ({ onClick }: { onClick: () => void }) => ...\n  if (typeAnnotation.type === AST_NODE_TYPES.TSTypeLiteral) {\n    for (const member of typeAnnotation.members) {\n      if (\n        member.type === AST_NODE_TYPES.TSPropertySignature &&\n        member.key.type === AST_NODE_TYPES.Identifier &&\n        isOnClickProp(member.key.name) &&\n        member.typeAnnotation?.typeAnnotation.type === AST_NODE_TYPES.TSFunctionType\n      ) {\n        result.push({\n          name: member.key.name,\n          typeNode: member.typeAnnotation.typeAnnotation,\n          propertyNode: member,\n        });\n      }\n    }\n    return result;\n  }\n\n  // Handle type references: ({ onClick }: ButtonProps) => ...\n  if (typeAnnotation.type === AST_NODE_TYPES.TSTypeReference) {\n    try {\n      const services = ESLintUtils.getParserServices(context);\n      const checker = services.program.getTypeChecker();\n      const tsNode = services.esTreeNodeToTSNodeMap.get(typeAnnotation);\n      const type = checker.getTypeAtLocation(tsNode);\n\n      for (const prop of type.getProperties()) {\n        if (isOnClickProp(prop.name)) {\n          const propType = checker.getTypeOfSymbolAtLocation(prop, tsNode);\n          const callSignatures = propType.getCallSignatures();\n\n          if (callSignatures.length > 0) {\n            // Find the corresponding ESTree node for this property\n            const declarations = prop.getDeclarations();\n            const decl = declarations?.[0];\n            if (decl) {\n              const esTreeNode = services.tsNodeToESTreeNodeMap.get(decl);\n              if (\n                esTreeNode.type === AST_NODE_TYPES.TSPropertySignature &&\n                esTreeNode.typeAnnotation?.typeAnnotation.type === AST_NODE_TYPES.TSFunctionType\n              ) {\n                result.push({\n                  name: prop.name,\n                  typeNode: esTreeNode.typeAnnotation.typeAnnotation,\n                  propertyNode: esTreeNode,\n                });\n              }\n            }\n          }\n        }\n      }\n    } catch {\n      // Type checking failed - silently skip\n    }\n  }\n\n  return result;\n};\n\nexport const preferMouseEventHandlerInReactProps = createRule<Options, MessageIds>({\n  name: \"prefer-mouse-event-handler-in-react-props\",\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description:\n        \"Enforce using MouseEventHandler<T> instead of () => void or (e: MouseEvent) => void for onClick* props in React components. \" +\n        \"This ensures proper React typing and consistency across the codebase.\",\n    },\n    hasSuggestions: true,\n    schema: [\n      {\n        type: \"object\",\n        properties: {\n          allowedNames: {\n            type: \"array\",\n            items: { type: \"string\" },\n            description: \"Prop names to exempt from this rule\",\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      preferMouseEventHandler: \"Prop '{{propName}}' should use MouseEventHandler<T> instead of {{currentType}}.\",\n      suggestMouseEventHandler: \"Use MouseEventHandler<{{elementType}}>\",\n    },\n  },\n  defaultOptions: [\n    {\n      allowedNames: [],\n    },\n  ],\n  create(context, [options]) {\n    const allowedNames = options.allowedNames ?? [];\n\n    // Only run on .tsx files\n    const filename = context.filename;\n    if (!filename.endsWith(\".tsx\")) {\n      return {};\n    }\n\n    // Track reported property nodes to avoid duplicate reports when multiple components use the same interface\n    const reportedNodes = new Set<TSESTree.Node>();\n\n    const checkComponentProps = (\n      _node: TSESTree.FunctionDeclaration | TSESTree.ArrowFunctionExpression,\n      propsParam: TSESTree.Parameter | undefined\n    ) => {\n      if (!propsParam) {\n        return;\n      }\n\n      let typeAnnotation: TSESTree.TypeNode | undefined;\n\n      // Handle both regular parameters (props: Props) and destructured parameters ({prop1, prop2}: Props)\n      if (propsParam.type === AST_NODE_TYPES.Identifier || propsParam.type === AST_NODE_TYPES.ObjectPattern) {\n        typeAnnotation = propsParam.typeAnnotation?.typeAnnotation;\n      } else {\n        return;\n      }\n\n      const onClickProps = getOnClickPropsFromType(context, typeAnnotation);\n\n      for (const { name: propName, typeNode, propertyNode } of onClickProps) {\n        // Skip if already reported (prevents duplicates when multiple components use the same interface)\n        if (reportedNodes.has(propertyNode)) {\n          continue;\n        }\n\n        // Check if it's in the allowed list\n        if (allowedNames.includes(propName)) {\n          continue;\n        }\n\n        // Analyze the function type\n        const result = analyzeFunctionType(typeNode);\n\n        if (!result.shouldFlag) {\n          continue;\n        }\n\n        // Get the current type as a string for the error message\n        const sourceCode = context.sourceCode;\n        const currentType = sourceCode.getText(typeNode);\n\n        // Build suggestions\n        const suggestions: Array<SuggestionResult> = [];\n\n        let inferredElementType = result.inferredElementType;\n\n        if (!inferredElementType) {\n          inferredElementType = inferElementTypeFromUsage(propName, context);\n        }\n\n        if (inferredElementType) {\n          suggestions.push(createSuggestion(inferredElementType, result.typeAnnotationNode));\n        } else {\n          suggestions.push(createSuggestion(\"HTMLButtonElement\", result.typeAnnotationNode));\n          suggestions.push(createSuggestion(\"HTMLElement\", result.typeAnnotationNode));\n          suggestions.push(createSuggestion(\"HTMLDivElement\", result.typeAnnotationNode));\n        }\n\n        // Mark as reported to prevent duplicates\n        reportedNodes.add(propertyNode);\n\n        context.report({\n          node: propertyNode,\n          messageId: \"preferMouseEventHandler\",\n          data: {\n            propName,\n            currentType,\n          },\n          suggest: suggestions,\n        });\n      }\n    };\n\n    return {\n      FunctionDeclaration(node: TSESTree.FunctionDeclaration) {\n        if (isReactComponent(node)) {\n          checkComponentProps(node, node.params[0]);\n        }\n      },\n\n      ArrowFunctionExpression(node: TSESTree.ArrowFunctionExpression) {\n        if (isReactComponent(node)) {\n          checkComponentProps(node, node.params[0]);\n        }\n      },\n    };\n  },\n});\n"]}

package/src/lib/rules/require-classname-alternatives/require-classname-alternatives.d.ts

@@ -0,0 +1,13 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+type MessageIds = "bannedClassAutoFix" | "bannedClassSuggest" | "suggestReplacement";
+type RuleConfig = {
+    /** Map of banned class name patterns to their allowed alternatives */
+    alternatives: Record<string, Array<string>>;
+    /** Optional prefixes to match (e.g., "bg", "text", "border"). If not provided, matches exact class names. */
+    prefixes?: Array<string>;
+};
+type Options = [RuleConfig?];
+export declare const requireClassnameAlternatives: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};