@trackunit/eslint-plugin-trackunit 0.0.2

package/src/lib/rules/prefer-destructured-imports/prefer-destructured-imports.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Enforce destructured imports instead of namespace imports for configured packages.
+ * This rule helps maintain consistent import styles by converting namespace imports and detecting global UMD usage.
+ * @example
+ * // ❌ Bad (namespace import)
+ * import React from "react";
+ * const Component = () => {
+ *   React.useEffect(() => {}, []);
+ *   return <div />;
+ * };
+ *
+ * // ✅ Good (destructured import)
+ * import { useEffect } from "react";
+ * const Component = () => {
+ *   useEffect(() => {}, []);
+ *   return <div />;
+ * };
+ * @example
+ * // ❌ Bad (global UMD usage without import)
+ * interface Props {
+ *   children: React.ReactNode;
+ * }
+ *
+ * // ✅ Good (explicit import)
+ * import { ReactNode } from "react";
+ * interface Props {
+ *   children: ReactNode;
+ * }
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+type MessageIds = "preferDestructured" | "preferDestructuredGlobal";
+type PackageConfig = {
+    /** Mapping of package names to their global UMD variable names (e.g., { "react": "React", "lodash": "_" }) */
+    packages: Record<string, string>;
+};
+type Options = [PackageConfig?];
+/**
+ * ESLint rule: prefer-destructured-imports
+ *
+ * ## Configuration
+ *
+ * This rule requires explicit configuration to specify which packages to enforce.
+ * Without configuration, the rule does nothing.
+ *
+ * @example
+ * // .eslintrc.js - Enforce for React
+ * {
+ *   "rules": {
+ *     "@trackunit/prefer-destructured-imports": ["error", {
+ *       "packages": {
+ *         "react": "React"
+ *       }
+ *     }]
+ *   }
+ * }
+ * @example
+ * // .eslintrc.js - Multiple packages
+ * {
+ *   "rules": {
+ *     "@trackunit/prefer-destructured-imports": ["error", {
+ *       "packages": {
+ *         "react": "React",
+ *         "lodash": "_",
+ *         "jquery": "$"
+ *       }
+ *     }]
+ *   }
+ * }
+ */
+export declare const preferDestructuredImports: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};

package/src/lib/rules/prefer-destructured-imports/prefer-destructured-imports.js

@@ -0,0 +1,333 @@
+"use strict";
+/**
+ * @fileoverview Enforce destructured imports instead of namespace imports for configured packages.
+ * This rule helps maintain consistent import styles by converting namespace imports and detecting global UMD usage.
+ * @example
+ * // ❌ Bad (namespace import)
+ * import React from "react";
+ * const Component = () => {
+ *   React.useEffect(() => {}, []);
+ *   return <div />;
+ * };
+ *
+ * // ✅ Good (destructured import)
+ * import { useEffect } from "react";
+ * const Component = () => {
+ *   useEffect(() => {}, []);
+ *   return <div />;
+ * };
+ * @example
+ * // ❌ Bad (global UMD usage without import)
+ * interface Props {
+ *   children: React.ReactNode;
+ * }
+ *
+ * // ✅ Good (explicit import)
+ * import { ReactNode } from "react";
+ * interface Props {
+ *   children: ReactNode;
+ * }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preferDestructuredImports = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const import_utils_1 = require("../../utils/import-utils");
+const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}.ts`);
+/**
+ * ESLint rule: prefer-destructured-imports
+ *
+ * ## Configuration
+ *
+ * This rule requires explicit configuration to specify which packages to enforce.
+ * Without configuration, the rule does nothing.
+ *
+ * @example
+ * // .eslintrc.js - Enforce for React
+ * {
+ *   "rules": {
+ *     "@trackunit/prefer-destructured-imports": ["error", {
+ *       "packages": {
+ *         "react": "React"
+ *       }
+ *     }]
+ *   }
+ * }
+ * @example
+ * // .eslintrc.js - Multiple packages
+ * {
+ *   "rules": {
+ *     "@trackunit/prefer-destructured-imports": ["error", {
+ *       "packages": {
+ *         "react": "React",
+ *         "lodash": "_",
+ *         "jquery": "$"
+ *       }
+ *     }]
+ *   }
+ * }
+ */
+exports.preferDestructuredImports = createRule({
+    name: "prefer-destructured-imports",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Prefer destructured imports instead of namespace imports for certain packages",
+        },
+        fixable: "code",
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    packages: {
+                        type: "object",
+                        description: "Mapping of package names to their global UMD variable names (e.g., { 'react': 'React' })",
+                        additionalProperties: {
+                            type: "string",
+                        },
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            preferDestructured: "Prefer destructured imports instead of namespace imports",
+            preferDestructuredGlobal: "Import '{{members}}' from '{{packageName}}' instead of using the global {{globalName}} variable",
+        },
+    },
+    defaultOptions: [],
+    create(context) {
+        const sourceCode = context.sourceCode;
+        const options = context.options[0];
+        // Return early if no packages are configured
+        if (options === undefined || Object.keys(options.packages).length === 0) {
+            return {};
+        }
+        const packageToGlobalName = options.packages;
+        const targetPackages = Object.keys(packageToGlobalName);
+        // Helper to check if a string is a valid/configured package name
+        const isValidPackageName = (value) => {
+            return targetPackages.includes(value);
+        };
+        // Track which global identifiers are actually imported (to avoid false positives)
+        const importedGlobalIdentifiers = new Set();
+        const namespaceImports = new Map();
+        const usagesByImport = new Map();
+        // Track usages of global identifiers that aren't imported (e.g., React.ReactElement without importing React)
+        const globalUsages = new Map();
+        return {
+            ImportDeclaration(node) {
+                const sourceValue = node.source.value;
+                if (typeof sourceValue === "string" && isValidPackageName(sourceValue)) {
+                    const globalName = packageToGlobalName[sourceValue];
+                    // Get any existing destructured imports
+                    const existingSpecifiers = new Set(node.specifiers
+                        .filter((s) => s.type === utils_1.AST_NODE_TYPES.ImportSpecifier)
+                        .map(s => s.local.name));
+                    // Find the namespace or default import if it exists
+                    const namespaceOrDefaultSpecifier = node.specifiers.find((s) => s.type === utils_1.AST_NODE_TYPES.ImportDefaultSpecifier || s.type === utils_1.AST_NODE_TYPES.ImportNamespaceSpecifier);
+                    if (namespaceOrDefaultSpecifier) {
+                        const importName = namespaceOrDefaultSpecifier.local.name;
+                        // Only mark this global as imported if the import name matches the global name
+                        // This prevents false positives when someone imports React as a different name
+                        if (importName === globalName) {
+                            importedGlobalIdentifiers.add(globalName);
+                        }
+                        // If this import also has destructured specifiers, store it as both
+                        if (existingSpecifiers.size > 0) {
+                            namespaceImports.set("destructured", { node, existingSpecifiers });
+                        }
+                        namespaceImports.set(importName, { node, existingSpecifiers });
+                        usagesByImport.set(importName, new Map());
+                    }
+                    else if (existingSpecifiers.size > 0) {
+                        // Store pure destructured imports
+                        namespaceImports.set("destructured", { node, existingSpecifiers });
+                        // Do NOT mark the global as imported - we want to catch global usage even with destructured imports
+                    }
+                }
+            },
+            // Handle React.something in regular code
+            MemberExpression(node) {
+                const objectNode = node.object;
+                if (objectNode.type === utils_1.AST_NODE_TYPES.Identifier && node.property.type === utils_1.AST_NODE_TYPES.Identifier) {
+                    // Check if this is a tracked namespace import
+                    if (namespaceImports.has(objectNode.name)) {
+                        const usages = usagesByImport.get(objectNode.name);
+                        if (usages) {
+                            usages.set(node.range[0], {
+                                name: node.property.name,
+                                start: node.range[0],
+                                end: node.range[1],
+                            });
+                        }
+                    }
+                    // Check if this is a global identifier usage (e.g., React.ReactElement without import)
+                    else if (!importedGlobalIdentifiers.has(objectNode.name)) {
+                        // Find if this identifier matches any of our configured global names
+                        for (const packageName of targetPackages) {
+                            const globalName = packageToGlobalName[packageName];
+                            if (objectNode.name === globalName) {
+                                if (!globalUsages.has(globalName)) {
+                                    globalUsages.set(globalName, {
+                                        packageName: packageName,
+                                        members: new Set(),
+                                        nodes: [],
+                                    });
+                                }
+                                const usage = globalUsages.get(globalName);
+                                if (usage) {
+                                    usage.members.add(node.property.name);
+                                    usage.nodes.push(node);
+                                }
+                                break;
+                            }
+                        }
+                    }
+                }
+            },
+            // Handle React.ReactNode in type annotations
+            TSQualifiedName(node) {
+                if (node.left.type === utils_1.AST_NODE_TYPES.Identifier) {
+                    // Check if this is a tracked namespace import
+                    if (namespaceImports.has(node.left.name)) {
+                        const usages = usagesByImport.get(node.left.name);
+                        if (usages) {
+                            usages.set(node.range[0], {
+                                name: node.right.name,
+                                start: node.range[0],
+                                end: node.range[1],
+                            });
+                        }
+                    }
+                    // Check if this is a global identifier usage
+                    else if (!importedGlobalIdentifiers.has(node.left.name)) {
+                        for (const packageName of targetPackages) {
+                            const globalName = packageToGlobalName[packageName];
+                            if (node.left.name === globalName) {
+                                if (!globalUsages.has(globalName)) {
+                                    globalUsages.set(globalName, {
+                                        packageName: packageName,
+                                        members: new Set(),
+                                        nodes: [],
+                                    });
+                                }
+                                const usage = globalUsages.get(globalName);
+                                if (usage) {
+                                    usage.members.add(node.right.name);
+                                    usage.nodes.push(node);
+                                }
+                                break;
+                            }
+                        }
+                    }
+                }
+            },
+            // Note: TSQualifiedName already handles React.ReactElement, React.RefObject, etc.
+            // This visitor is kept for potential future expansion but currently does nothing
+            // to avoid duplicate tracking with TSQualifiedName
+            TSTypeReference(_node) {
+                // TSQualifiedName visitor handles all qualified type names (React.Something)
+                // No action needed here
+            },
+            "Program:exit"() {
+                // Report errors for namespace imports
+                for (const [importName, { node: importNode }] of namespaceImports) {
+                    const usages = usagesByImport.get(importName);
+                    if (!usages || usages.size === 0) {
+                        continue;
+                    }
+                    const sourceValue = importNode.source.value;
+                    if (typeof sourceValue !== "string" || !isValidPackageName(sourceValue)) {
+                        continue;
+                    }
+                    context.report({
+                        node: importNode,
+                        messageId: "preferDestructured",
+                        fix(fixer) {
+                            const fixes = [];
+                            // Collect all specifiers needed from usages (e.g., ["useState", "useEffect"] from React.useState, React.useEffect)
+                            const specifiersFromUsages = Array.from(usages.values()).map(usage => usage.name);
+                            // Check if there's a separate destructured import to merge with
+                            const existingDestructured = namespaceImports.get("destructured");
+                            const otherDestructuredImport = existingDestructured && existingDestructured.node !== importNode
+                                ? existingDestructured.node
+                                : undefined;
+                            // Replace the namespace import with destructured imports (merges if other import exists)
+                            fixes.push(...(0, import_utils_1.replaceNamespaceWithDestructured)({
+                                sourceCode,
+                                fixer,
+                                packageName: sourceValue,
+                                namespaceImportToReplace: importNode,
+                                specifiersToAdd: specifiersFromUsages,
+                                mergeIntoImport: otherDestructuredImport,
+                            }));
+                            // Remove namespace/default prefix from all usages
+                            for (const { start, end } of usages.values()) {
+                                const text = sourceCode.getText().slice(start, end);
+                                const newText = text.replace(new RegExp(`^${importName}\\.`), "");
+                                fixes.push(fixer.replaceTextRange([start, end], newText));
+                            }
+                            return fixes;
+                        },
+                    });
+                }
+                // Report errors for global UMD variable usages (e.g., React.ReactElement without import)
+                for (const [globalName, { packageName, members, nodes }] of globalUsages) {
+                    if (members.size === 0 || nodes.length === 0) {
+                        continue;
+                    }
+                    // Report on the first usage node
+                    const firstNode = nodes[0];
+                    if (!firstNode) {
+                        continue;
+                    }
+                    const membersList = Array.from(members);
+                    const existingDestructured = namespaceImports.get("destructured");
+                    // Filter out members that are already imported (no need to add them again)
+                    const membersToAdd = existingDestructured
+                        ? membersList.filter(member => !existingDestructured.existingSpecifiers.has(member))
+                        : membersList;
+                    context.report({
+                        node: firstNode,
+                        messageId: "preferDestructuredGlobal",
+                        data: {
+                            globalName,
+                            packageName,
+                            members: membersList.sort().join(", "), // Sort only for display in error message
+                        },
+                        fix(fixer) {
+                            const fixes = [];
+                            // Only update imports if there are new members to add
+                            if (membersToAdd.length > 0) {
+                                fixes.push(...(0, import_utils_1.addImportSpecifiers)({
+                                    sourceCode,
+                                    fixer,
+                                    packageName,
+                                    specifiers: membersToAdd,
+                                    existingImport: existingDestructured?.node,
+                                }));
+                            }
+                            // Replace all global usages (React.X → X)
+                            // Deduplicate nodes by range and sort by position (reverse order to maintain positions)
+                            const uniqueNodesByRange = new Map();
+                            for (const node of nodes) {
+                                const rangeKey = `${node.range[0]}-${node.range[1]}`;
+                                if (!uniqueNodesByRange.has(rangeKey)) {
+                                    uniqueNodesByRange.set(rangeKey, node);
+                                }
+                            }
+                            const sortedNodes = Array.from(uniqueNodesByRange.values()).sort((a, b) => b.range[0] - a.range[0]);
+                            for (const node of sortedNodes) {
+                                const nodeText = sourceCode.getText(node);
+                                const newText = nodeText.replace(new RegExp(`^${globalName}\\.`), "");
+                                fixes.push(fixer.replaceText(node, newText));
+                            }
+                            return fixes;
+                        },
+                    });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=prefer-destructured-imports.js.map

package/src/lib/rules/prefer-destructured-imports/prefer-destructured-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-destructured-imports.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/prefer-destructured-imports/prefer-destructured-imports.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Enforce destructured imports instead of namespace imports for configured packages.\n * This rule helps maintain consistent import styles by converting namespace imports and detecting global UMD usage.\n * @example\n * // ❌ Bad (namespace import)\n * import React from \"react\";\n * const Component = () => {\n *   React.useEffect(() => {}, []);\n *   return <div />;\n * };\n *\n * // ✅ Good (destructured import)\n * import { useEffect } from \"react\";\n * const Component = () => {\n *   useEffect(() => {}, []);\n *   return <div />;\n * };\n * @example\n * // ❌ Bad (global UMD usage without import)\n * interface Props {\n *   children: React.ReactNode;\n * }\n *\n * // ✅ Good (explicit import)\n * import { ReactNode } from \"react\";\n * interface Props {\n *   children: ReactNode;\n * }\n */\n\nimport { AST_NODE_TYPES, ESLintUtils, TSESTree } from \"@typescript-eslint/utils\";\nimport { addImportSpecifiers, replaceNamespaceWithDestructured } from \"../../utils/import-utils\";\n\nconst createRule = ESLintUtils.RuleCreator(\n  name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}.ts`\n);\n\ntype MessageIds = \"preferDestructured\" | \"preferDestructuredGlobal\";\n\ntype PackageConfig = {\n  /** Mapping of package names to their global UMD variable names (e.g., { \"react\": \"React\", \"lodash\": \"_\" }) */\n  packages: Record<string, string>;\n};\n\ntype Options = [PackageConfig?];\n\n/**\n * ESLint rule: prefer-destructured-imports\n *\n * ## Configuration\n *\n * This rule requires explicit configuration to specify which packages to enforce.\n * Without configuration, the rule does nothing.\n *\n * @example\n * // .eslintrc.js - Enforce for React\n * {\n *   \"rules\": {\n *     \"@trackunit/prefer-destructured-imports\": [\"error\", {\n *       \"packages\": {\n *         \"react\": \"React\"\n *       }\n *     }]\n *   }\n * }\n * @example\n * // .eslintrc.js - Multiple packages\n * {\n *   \"rules\": {\n *     \"@trackunit/prefer-destructured-imports\": [\"error\", {\n *       \"packages\": {\n *         \"react\": \"React\",\n *         \"lodash\": \"_\",\n *         \"jquery\": \"$\"\n *       }\n *     }]\n *   }\n * }\n */\nexport const preferDestructuredImports = createRule<Options, MessageIds>({\n  name: \"prefer-destructured-imports\",\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description: \"Prefer destructured imports instead of namespace imports for certain packages\",\n    },\n    fixable: \"code\",\n    schema: [\n      {\n        type: \"object\",\n        properties: {\n          packages: {\n            type: \"object\",\n            description: \"Mapping of package names to their global UMD variable names (e.g., { 'react': 'React' })\",\n            additionalProperties: {\n              type: \"string\",\n            },\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      preferDestructured: \"Prefer destructured imports instead of namespace imports\",\n      preferDestructuredGlobal:\n        \"Import '{{members}}' from '{{packageName}}' instead of using the global {{globalName}} variable\",\n    },\n  },\n  defaultOptions: [],\n  create(context) {\n    const sourceCode = context.sourceCode;\n    const options = context.options[0];\n\n    // Return early if no packages are configured\n    if (options === undefined || Object.keys(options.packages).length === 0) {\n      return {};\n    }\n\n    const packageToGlobalName = options.packages;\n    const targetPackages = Object.keys(packageToGlobalName);\n\n    // Helper to check if a string is a valid/configured package name\n    const isValidPackageName = (value: string): boolean => {\n      return targetPackages.includes(value);\n    };\n\n    // Track which global identifiers are actually imported (to avoid false positives)\n    const importedGlobalIdentifiers = new Set<string>();\n\n    const namespaceImports = new Map<string, { node: TSESTree.ImportDeclaration; existingSpecifiers: Set<string> }>();\n    const usagesByImport = new Map<string, Map<number, { name: string; start: number; end: number }>>();\n\n    // Track usages of global identifiers that aren't imported (e.g., React.ReactElement without importing React)\n    const globalUsages = new Map<string, { packageName: string; members: Set<string>; nodes: Array<TSESTree.Node> }>();\n\n    return {\n      ImportDeclaration(node: TSESTree.ImportDeclaration) {\n        const sourceValue = node.source.value;\n        if (typeof sourceValue === \"string\" && isValidPackageName(sourceValue)) {\n          const globalName = packageToGlobalName[sourceValue];\n\n          // Get any existing destructured imports\n          const existingSpecifiers = new Set(\n            node.specifiers\n              .filter((s): s is TSESTree.ImportSpecifier => s.type === AST_NODE_TYPES.ImportSpecifier)\n              .map(s => s.local.name)\n          );\n\n          // Find the namespace or default import if it exists\n          const namespaceOrDefaultSpecifier = node.specifiers.find(\n            (s): s is TSESTree.ImportDefaultSpecifier | TSESTree.ImportNamespaceSpecifier =>\n              s.type === AST_NODE_TYPES.ImportDefaultSpecifier || s.type === AST_NODE_TYPES.ImportNamespaceSpecifier\n          );\n\n          if (namespaceOrDefaultSpecifier) {\n            const importName = namespaceOrDefaultSpecifier.local.name;\n            // Only mark this global as imported if the import name matches the global name\n            // This prevents false positives when someone imports React as a different name\n            if (importName === globalName) {\n              importedGlobalIdentifiers.add(globalName);\n            }\n\n            // If this import also has destructured specifiers, store it as both\n            if (existingSpecifiers.size > 0) {\n              namespaceImports.set(\"destructured\", { node, existingSpecifiers });\n            }\n            namespaceImports.set(importName, { node, existingSpecifiers });\n            usagesByImport.set(importName, new Map());\n          } else if (existingSpecifiers.size > 0) {\n            // Store pure destructured imports\n            namespaceImports.set(\"destructured\", { node, existingSpecifiers });\n            // Do NOT mark the global as imported - we want to catch global usage even with destructured imports\n          }\n        }\n      },\n\n      // Handle React.something in regular code\n      MemberExpression(node: TSESTree.MemberExpression) {\n        const objectNode = node.object;\n\n        if (objectNode.type === AST_NODE_TYPES.Identifier && node.property.type === AST_NODE_TYPES.Identifier) {\n          // Check if this is a tracked namespace import\n          if (namespaceImports.has(objectNode.name)) {\n            const usages = usagesByImport.get(objectNode.name);\n            if (usages) {\n              usages.set(node.range[0], {\n                name: node.property.name,\n                start: node.range[0],\n                end: node.range[1],\n              });\n            }\n          }\n          // Check if this is a global identifier usage (e.g., React.ReactElement without import)\n          else if (!importedGlobalIdentifiers.has(objectNode.name)) {\n            // Find if this identifier matches any of our configured global names\n            for (const packageName of targetPackages) {\n              const globalName = packageToGlobalName[packageName];\n              if (objectNode.name === globalName) {\n                if (!globalUsages.has(globalName)) {\n                  globalUsages.set(globalName, {\n                    packageName: packageName,\n                    members: new Set(),\n                    nodes: [],\n                  });\n                }\n                const usage = globalUsages.get(globalName);\n                if (usage) {\n                  usage.members.add(node.property.name);\n                  usage.nodes.push(node);\n                }\n                break;\n              }\n            }\n          }\n        }\n      },\n\n      // Handle React.ReactNode in type annotations\n      TSQualifiedName(node: TSESTree.TSQualifiedName) {\n        if (node.left.type === AST_NODE_TYPES.Identifier) {\n          // Check if this is a tracked namespace import\n          if (namespaceImports.has(node.left.name)) {\n            const usages = usagesByImport.get(node.left.name);\n            if (usages) {\n              usages.set(node.range[0], {\n                name: node.right.name,\n                start: node.range[0],\n                end: node.range[1],\n              });\n            }\n          }\n          // Check if this is a global identifier usage\n          else if (!importedGlobalIdentifiers.has(node.left.name)) {\n            for (const packageName of targetPackages) {\n              const globalName = packageToGlobalName[packageName];\n              if (node.left.name === globalName) {\n                if (!globalUsages.has(globalName)) {\n                  globalUsages.set(globalName, {\n                    packageName: packageName,\n                    members: new Set(),\n                    nodes: [],\n                  });\n                }\n                const usage = globalUsages.get(globalName);\n                if (usage) {\n                  usage.members.add(node.right.name);\n                  usage.nodes.push(node);\n                }\n                break;\n              }\n            }\n          }\n        }\n      },\n\n      // Note: TSQualifiedName already handles React.ReactElement, React.RefObject, etc.\n      // This visitor is kept for potential future expansion but currently does nothing\n      // to avoid duplicate tracking with TSQualifiedName\n      TSTypeReference(_node: TSESTree.TSTypeReference) {\n        // TSQualifiedName visitor handles all qualified type names (React.Something)\n        // No action needed here\n      },\n\n      \"Program:exit\"() {\n        // Report errors for namespace imports\n        for (const [importName, { node: importNode }] of namespaceImports) {\n          const usages = usagesByImport.get(importName);\n          if (!usages || usages.size === 0) {\n            continue;\n          }\n\n          const sourceValue = importNode.source.value;\n\n          if (typeof sourceValue !== \"string\" || !isValidPackageName(sourceValue)) {\n            continue;\n          }\n\n          context.report({\n            node: importNode,\n            messageId: \"preferDestructured\",\n            fix(fixer) {\n              const fixes = [];\n\n              // Collect all specifiers needed from usages (e.g., [\"useState\", \"useEffect\"] from React.useState, React.useEffect)\n              const specifiersFromUsages = Array.from(usages.values()).map(usage => usage.name);\n\n              // Check if there's a separate destructured import to merge with\n              const existingDestructured = namespaceImports.get(\"destructured\");\n              const otherDestructuredImport =\n                existingDestructured && existingDestructured.node !== importNode\n                  ? existingDestructured.node\n                  : undefined;\n\n              // Replace the namespace import with destructured imports (merges if other import exists)\n              fixes.push(\n                ...replaceNamespaceWithDestructured({\n                  sourceCode,\n                  fixer,\n                  packageName: sourceValue,\n                  namespaceImportToReplace: importNode,\n                  specifiersToAdd: specifiersFromUsages,\n                  mergeIntoImport: otherDestructuredImport,\n                })\n              );\n\n              // Remove namespace/default prefix from all usages\n              for (const { start, end } of usages.values()) {\n                const text = sourceCode.getText().slice(start, end);\n                const newText = text.replace(new RegExp(`^${importName}\\\\.`), \"\");\n                fixes.push(fixer.replaceTextRange([start, end], newText));\n              }\n\n              return fixes;\n            },\n          });\n        }\n\n        // Report errors for global UMD variable usages (e.g., React.ReactElement without import)\n        for (const [globalName, { packageName, members, nodes }] of globalUsages) {\n          if (members.size === 0 || nodes.length === 0) {\n            continue;\n          }\n\n          // Report on the first usage node\n          const firstNode = nodes[0];\n          if (!firstNode) {\n            continue;\n          }\n\n          const membersList = Array.from(members);\n          const existingDestructured = namespaceImports.get(\"destructured\");\n\n          // Filter out members that are already imported (no need to add them again)\n          const membersToAdd = existingDestructured\n            ? membersList.filter(member => !existingDestructured.existingSpecifiers.has(member))\n            : membersList;\n\n          context.report({\n            node: firstNode,\n            messageId: \"preferDestructuredGlobal\",\n            data: {\n              globalName,\n              packageName,\n              members: membersList.sort().join(\", \"), // Sort only for display in error message\n            },\n            fix(fixer) {\n              const fixes = [];\n\n              // Only update imports if there are new members to add\n              if (membersToAdd.length > 0) {\n                fixes.push(\n                  ...addImportSpecifiers({\n                    sourceCode,\n                    fixer,\n                    packageName,\n                    specifiers: membersToAdd,\n                    existingImport: existingDestructured?.node,\n                  })\n                );\n              }\n\n              // Replace all global usages (React.X → X)\n              // Deduplicate nodes by range and sort by position (reverse order to maintain positions)\n              const uniqueNodesByRange = new Map<string, TSESTree.Node>();\n              for (const node of nodes) {\n                const rangeKey = `${node.range[0]}-${node.range[1]}`;\n                if (!uniqueNodesByRange.has(rangeKey)) {\n                  uniqueNodesByRange.set(rangeKey, node);\n                }\n              }\n\n              const sortedNodes = Array.from(uniqueNodesByRange.values()).sort((a, b) => b.range[0] - a.range[0]);\n\n              for (const node of sortedNodes) {\n                const nodeText = sourceCode.getText(node);\n                const newText = nodeText.replace(new RegExp(`^${globalName}\\\\.`), \"\");\n                fixes.push(fixer.replaceText(node, newText));\n              }\n\n              return fixes;\n            },\n          });\n        }\n      },\n    };\n  },\n});\n"]}

package/src/lib/rules/prefer-event-specific-callback-naming/name-suggestion-strategies.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Strategy-based name suggestion system for the prefer-event-specific-callback-naming rule.
+ *
+ * This module provides a structured, extensible approach to generating suggested names
+ * for callback functions based on different naming patterns. Each strategy handles a
+ * specific type of problematic name and knows how to transform it correctly.
+ *
+ * Strategies are evaluated in order - the first matching strategy wins.
+ */
+/**
+ * Context passed to name suggestion strategies.
+ */
+export type NameSuggestionContext = {
+    /** The current callback name (e.g., "onPrimary", "onClose", "handleClick") */
+    callbackName: string;
+    /** The event handler prop name (e.g., "onClick", "primaryAction", "onSubmit") */
+    eventName: string;
+};
+/**
+ * A strategy for suggesting renamed callback names.
+ * Each strategy handles a specific pattern of problematic naming.
+ */
+export type NameSuggestionStrategy = {
+    /** Human-readable name for debugging and logging */
+    name: string;
+    /** Returns true if this strategy should handle the given context */
+    matches: (ctx: NameSuggestionContext) => boolean;
+    /** Returns the suggested name for the callback */
+    suggest: (ctx: NameSuggestionContext) => string;
+};
+/**
+ * Generates a suggested name for a callback based on the event it's passed to.
+ *
+ * Uses a strategy pattern to handle different naming conventions appropriately.
+ * The first matching strategy determines the suggested name.
+ *
+ * @param ctx - The naming context with callback and event names
+ * @returns The suggested name for the callback
+ * @example
+ * getSuggestedName({ callbackName: "onClose", eventName: "onClick" })
+ * // Returns: "onClickClose"
+ *
+ * getSuggestedName({ callbackName: "onPrimary", eventName: "primaryAction" })
+ * // Returns: "onClickPrimary"
+ */
+export declare const getSuggestedName: (ctx: NameSuggestionContext) => string;
+/**
+ * Exported for testing purposes - allows testing individual strategies.
+ */
+export declare const testableStrategies: {
+    actionSuffixEventStrategy: NameSuggestionStrategy;
+    handlerSuffixEventStrategy: NameSuggestionStrategy;
+    onPrefixCallbackToClickEventStrategy: NameSuggestionStrategy;
+    onPrefixCallbackToGenericEventStrategy: NameSuggestionStrategy;
+    defaultCapitalizeStrategy: NameSuggestionStrategy;
+};