@trackunit/eslint-plugin-trackunit 0.0.2

package/src/lib/utils/classname-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classname-utils.js","sourceRoot":"","sources":["../../../../../../../libs/eslint/plugin-trackunit/src/lib/utils/classname-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { AST_NODE_TYPES, TSESTree } from \"@typescript-eslint/utils\";\n\n/**\n * Utility functions for finding and analyzing Tailwind CSS classnames in ESLint rules.\n *\n * This module provides a centralized way to detect classname usage patterns across:\n * - JSX `className` and `class` attributes\n * - Variables named with `...Class` or `...ClassName` suffixes\n * - Tailwind utility functions: `cvaMerge`, `twMerge`, `cva`, `tw`, `twx`, `tws`, `cn`, `clsx`, `classNames`, `twJoin`\n *\n * ## Core Concepts\n *\n * ### ClassnameLocation\n * Represents a single location where a classname string value is found.\n * Contains the string value, the AST node for reporting/fixing, and metadata.\n *\n * ### ClassnameContext\n * Describes where a classname was found (JSX attribute, function call, variable, etc.)\n *\n * ## Usage in ESLint Rules\n *\n * ```typescript\n * import { findClassnameStrings, TAILWIND_FUNCTIONS, isClassnameVariable } from \"./classname-utils\";\n *\n * // In a CallExpression handler:\n * CallExpression(node) {\n *   const locations = findClassnameStrings(node);\n *   for (const location of locations) {\n *     // Check location.value for banned patterns\n *     // Report on location.reportNode\n *     // Fix using location.fixNode\n *   }\n * }\n * ```\n */\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Context describing where a classname was found\n */\nexport type ClassnameContext =\n  | { type: \"jsx-attribute\"; attributeName: string }\n  | { type: \"function-call\"; functionName: string; argumentIndex: number }\n  | { type: \"cva-variant\"; functionName: string; variantPath: Array<string> }\n  | { type: \"variable\"; variableName: string }\n  | { type: \"array-element\"; parentContext: ClassnameContext; elementIndex: number };\n\n/**\n * Represents a location where a classname string value is found\n */\nexport type ClassnameLocation = {\n  /** The extracted string value (for template literals, only static parts) */\n  value: string;\n  /** The AST node to use when reporting errors */\n  reportNode: TSESTree.Node;\n  /** The AST node to use when creating fixes (string literal or template literal) */\n  fixNode: TSESTree.Literal | TSESTree.TemplateLiteral;\n  /** Context describing where this classname was found */\n  context: ClassnameContext;\n};\n\n/**\n * Result of extracting a string value from a node\n */\ntype StringExtractionResult = {\n  value: string;\n  node: TSESTree.Literal | TSESTree.TemplateLiteral;\n} | null;\n\n// =============================================================================\n// Constants\n// =============================================================================\n\n/**\n * Function names that accept Tailwind class strings as arguments.\n * These are commonly used for class merging and conditional class application.\n *\n * Corresponds to the `tailwindFunctions` config in .prettierrc for Prettier's\n * Tailwind CSS plugin.\n */\nexport const TAILWIND_FUNCTIONS = [\n  \"cva\",\n  \"cvaMerge\",\n  \"tw\",\n  \"twx\",\n  \"tws\",\n  \"twMerge\",\n  \"twJoin\",\n  \"cn\",\n  \"clsx\",\n  \"classNames\",\n] as const;\n\nexport type TailwindFunction = (typeof TAILWIND_FUNCTIONS)[number];\n\n/**\n * Variable name patterns that indicate a classname value.\n * Matches variables like: containerClass, buttonClassName, rootClasses\n */\nconst CLASSNAME_VARIABLE_PATTERNS = [/Class$/, /ClassName$/, /Classes$/] as const;\n\n/**\n * JSX attribute names that contain classname values\n */\nexport const CLASSNAME_ATTRIBUTES = [\"className\", \"class\"] as const;\n\n// =============================================================================\n// Detection Helpers\n// =============================================================================\n\n/**\n * Check if a function name is a known Tailwind utility function\n */\nexport const isTailwindFunction = (name: string): name is TailwindFunction => {\n  return TAILWIND_FUNCTIONS.some(fn => fn === name);\n};\n\n/**\n * Check if a variable name indicates it contains classnames\n */\nexport const isClassnameVariable = (name: string): boolean => {\n  return CLASSNAME_VARIABLE_PATTERNS.some(pattern => pattern.test(name));\n};\n\n/**\n * Check if a JSX attribute name is a classname attribute\n */\nexport const isClassnameAttribute = (name: string): boolean => {\n  return CLASSNAME_ATTRIBUTES.some(attr => attr === name);\n};\n\n/**\n * Get the function name from a CallExpression callee\n */\nexport const getCalleeName = (callee: TSESTree.CallExpression[\"callee\"]): string | null => {\n  if (callee.type === AST_NODE_TYPES.Identifier) {\n    return callee.name;\n  }\n  if (callee.type === AST_NODE_TYPES.MemberExpression && callee.property.type === AST_NODE_TYPES.Identifier) {\n    return callee.property.name;\n  }\n  return null;\n};\n\n// =============================================================================\n// String Extraction\n// =============================================================================\n\n/**\n * Extract a string value from a Literal node\n */\nconst extractFromLiteral = (node: TSESTree.Literal): StringExtractionResult => {\n  if (typeof node.value === \"string\") {\n    return { value: node.value, node };\n  }\n  return null;\n};\n\n/**\n * Extract the static parts of a TemplateLiteral as a single string.\n * Template expressions are replaced with a single space to preserve word boundaries.\n */\nconst extractFromTemplateLiteral = (node: TSESTree.TemplateLiteral): StringExtractionResult => {\n  // Join static parts with spaces (representing where expressions would be)\n  const value = node.quasis.map(quasi => quasi.value.raw).join(\" \");\n  return { value, node };\n};\n\n/**\n * Extract string value from a node that might contain a classname string.\n * Handles Literal and TemplateLiteral nodes.\n */\nconst extractStringValue = (node: TSESTree.Node): StringExtractionResult => {\n  switch (node.type) {\n    case AST_NODE_TYPES.Literal:\n      return extractFromLiteral(node);\n    case AST_NODE_TYPES.TemplateLiteral:\n      return extractFromTemplateLiteral(node);\n    default:\n      return null;\n  }\n};\n\n// =============================================================================\n// Array Traversal\n// =============================================================================\n\n/**\n * Extract classname locations from an ArrayExpression.\n * Handles arrays like: [\"flex\", \"items-center\", \"bg-primary-500\"]\n */\nconst extractFromArray = (\n  node: TSESTree.ArrayExpression,\n  parentContext: ClassnameContext\n): Array<ClassnameLocation> => {\n  const locations: Array<ClassnameLocation> = [];\n\n  node.elements.forEach((element, index) => {\n    if (!element || element.type === AST_NODE_TYPES.SpreadElement) {\n      return;\n    }\n\n    const extracted = extractStringValue(element);\n    if (extracted) {\n      locations.push({\n        value: extracted.value,\n        reportNode: element,\n        fixNode: extracted.node,\n        context: { type: \"array-element\", parentContext, elementIndex: index },\n      });\n    }\n  });\n\n  return locations;\n};\n\n// =============================================================================\n// CVA/CVAMerge Object Traversal\n// =============================================================================\n\n/**\n * Recursively extract classname locations from a CVA options object.\n *\n * CVA structure:\n * ```\n * cva(baseClasses, {\n *   variants: {\n *     variantName: {\n *       variantValue: \"classnames here\",\n *     }\n *   },\n *   compoundVariants: [\n *     { variantName: \"value\", className: \"classnames\" }\n *   ],\n *   defaultVariants: { ... }\n * })\n * ```\n */\nconst extractFromCvaObject = (\n  node: TSESTree.ObjectExpression,\n  functionName: string,\n  currentPath: Array<string> = []\n): Array<ClassnameLocation> => {\n  const locations: Array<ClassnameLocation> = [];\n\n  for (const property of node.properties) {\n    if (property.type !== AST_NODE_TYPES.Property) {\n      continue;\n    }\n\n    const keyName = getPropertyKeyName(property.key);\n    if (!keyName) {\n      continue;\n    }\n\n    const propertyPath = [...currentPath, keyName];\n\n    // Skip defaultVariants as it doesn't contain classnames\n    if (keyName === \"defaultVariants\") {\n      continue;\n    }\n\n    // Recurse into nested objects (variants, compoundVariants entries, etc.)\n    if (property.value.type === AST_NODE_TYPES.ObjectExpression) {\n      locations.push(...extractFromCvaObject(property.value, functionName, propertyPath));\n      continue;\n    }\n\n    // Handle arrays (compoundVariants array, or array of class strings)\n    if (property.value.type === AST_NODE_TYPES.ArrayExpression) {\n      // Check if this is an array of objects (like compoundVariants)\n      const hasObjectElements = property.value.elements.some(el => el?.type === AST_NODE_TYPES.ObjectExpression);\n\n      if (hasObjectElements) {\n        // Recurse into each object in the array\n        property.value.elements.forEach((element, index) => {\n          if (element?.type === AST_NODE_TYPES.ObjectExpression) {\n            locations.push(...extractFromCvaObject(element, functionName, [...propertyPath, `[${index}]`]));\n          }\n        });\n      } else {\n        // This is an array of class strings\n        const arrayContext: ClassnameContext = {\n          type: \"cva-variant\",\n          functionName,\n          variantPath: propertyPath,\n        };\n        locations.push(...extractFromArray(property.value, arrayContext));\n      }\n      continue;\n    }\n\n    // Extract string values at leaf nodes\n    const extracted = extractStringValue(property.value);\n    if (extracted) {\n      locations.push({\n        value: extracted.value,\n        reportNode: property.value,\n        fixNode: extracted.node,\n        context: {\n          type: \"cva-variant\",\n          functionName,\n          variantPath: propertyPath,\n        },\n      });\n    }\n  }\n\n  return locations;\n};\n\n/**\n * Get the name of an object property key\n */\nconst getPropertyKeyName = (key: TSESTree.Property[\"key\"]): string | null => {\n  if (key.type === AST_NODE_TYPES.Identifier) {\n    return key.name;\n  }\n  if (key.type === AST_NODE_TYPES.Literal && typeof key.value === \"string\") {\n    return key.value;\n  }\n  return null;\n};\n\n// =============================================================================\n// Function Call Extraction\n// =============================================================================\n\n/**\n * Extract classname locations from a Tailwind function call.\n *\n * Handles various argument patterns:\n * - String literals: twMerge(\"flex items-center\")\n * - Template literals: twMerge(`flex ${condition && \"hidden\"}`)\n * - Arrays: cvaMerge([\"flex\", \"items-center\"], options)\n * - CVA options objects: cva(base, { variants: { ... } })\n */\nconst extractFromFunctionCall = (node: TSESTree.CallExpression): Array<ClassnameLocation> => {\n  const calleeName = getCalleeName(node.callee);\n  if (!calleeName || !isTailwindFunction(calleeName)) {\n    return [];\n  }\n\n  const locations: Array<ClassnameLocation> = [];\n  const isCvaStyle = calleeName === \"cva\" || calleeName === \"cvaMerge\";\n\n  node.arguments.forEach((arg, argIndex) => {\n    const baseContext: ClassnameContext = {\n      type: \"function-call\",\n      functionName: calleeName,\n      argumentIndex: argIndex,\n    };\n\n    // Handle string literals\n    const extracted = extractStringValue(arg);\n    if (extracted) {\n      locations.push({\n        value: extracted.value,\n        reportNode: arg,\n        fixNode: extracted.node,\n        context: baseContext,\n      });\n      return;\n    }\n\n    // Handle array arguments\n    if (arg.type === AST_NODE_TYPES.ArrayExpression) {\n      locations.push(...extractFromArray(arg, baseContext));\n      return;\n    }\n\n    // Handle CVA options object (typically second argument)\n    if (isCvaStyle && arg.type === AST_NODE_TYPES.ObjectExpression) {\n      locations.push(...extractFromCvaObject(arg, calleeName));\n    }\n  });\n\n  return locations;\n};\n\n// =============================================================================\n// JSX Attribute Extraction\n// =============================================================================\n\n/**\n * Extract classname locations from a JSX attribute (className or class).\n *\n * Handles various value patterns:\n * - String literals: className=\"flex items-center\"\n * - Expression with string: className={\"flex items-center\"}\n * - Template literals: className={`flex ${condition && \"hidden\"}`}\n */\nconst extractFromJsxAttribute = (node: TSESTree.JSXAttribute): Array<ClassnameLocation> => {\n  if (node.name.type !== AST_NODE_TYPES.JSXIdentifier) {\n    return [];\n  }\n\n  const attrName = node.name.name;\n  if (!isClassnameAttribute(attrName)) {\n    return [];\n  }\n\n  const attrValue = node.value;\n  if (!attrValue) {\n    return [];\n  }\n\n  const context: ClassnameContext = {\n    type: \"jsx-attribute\",\n    attributeName: attrName,\n  };\n\n  // Direct string literal: className=\"flex items-center\"\n  if (attrValue.type === AST_NODE_TYPES.Literal) {\n    const extracted = extractFromLiteral(attrValue);\n    if (extracted) {\n      return [\n        {\n          value: extracted.value,\n          reportNode: node,\n          fixNode: extracted.node,\n          context,\n        },\n      ];\n    }\n  }\n\n  // JSX Expression: className={...}\n  if (attrValue.type === AST_NODE_TYPES.JSXExpressionContainer) {\n    const expression = attrValue.expression;\n\n    // Skip empty expressions\n    if (expression.type === AST_NODE_TYPES.JSXEmptyExpression) {\n      return [];\n    }\n\n    // String literal in expression: className={\"flex items-center\"}\n    const extracted = extractStringValue(expression);\n    if (extracted) {\n      return [\n        {\n          value: extracted.value,\n          reportNode: node,\n          fixNode: extracted.node,\n          context,\n        },\n      ];\n    }\n\n    // Note: We don't recurse into function calls here as they're handled\n    // separately by the CallExpression handler in the rule\n  }\n\n  return [];\n};\n\n// =============================================================================\n// Variable Declaration Extraction\n// =============================================================================\n\n/**\n * Extract classname locations from a variable declaration with a classname-like name.\n *\n * Example: const buttonClass = \"flex items-center\";\n */\nconst extractFromVariableDeclarator = (node: TSESTree.VariableDeclarator): Array<ClassnameLocation> => {\n  if (node.id.type !== AST_NODE_TYPES.Identifier) {\n    return [];\n  }\n\n  const varName = node.id.name;\n  if (!isClassnameVariable(varName)) {\n    return [];\n  }\n\n  if (!node.init) {\n    return [];\n  }\n\n  const context: ClassnameContext = {\n    type: \"variable\",\n    variableName: varName,\n  };\n\n  // Handle string literal\n  const extracted = extractStringValue(node.init);\n  if (extracted) {\n    return [\n      {\n        value: extracted.value,\n        reportNode: node.init,\n        fixNode: extracted.node,\n        context,\n      },\n    ];\n  }\n\n  // Handle array of strings\n  if (node.init.type === AST_NODE_TYPES.ArrayExpression) {\n    return extractFromArray(node.init, context);\n  }\n\n  // Note: Function calls in variable initializers are handled separately\n  // by the CallExpression handler\n\n  return [];\n};\n\n// =============================================================================\n// Unified Entry Points\n// =============================================================================\n\n/**\n * Find all classname string locations in a CallExpression node.\n *\n * Use this in your ESLint rule's CallExpression handler to process\n * Tailwind utility function calls like twMerge, cvaMerge, etc.\n *\n * @example\n * ```typescript\n * CallExpression(node) {\n *   const locations = findClassnameStringsInCall(node);\n *   for (const location of locations) {\n *     if (hasBannedPattern(location.value)) {\n *       context.report({ node: location.reportNode, ... });\n *     }\n *   }\n * }\n * ```\n */\nexport const findClassnameStringsInCall = (node: TSESTree.CallExpression): Array<ClassnameLocation> => {\n  return extractFromFunctionCall(node);\n};\n\n/**\n * Find all classname string locations in a JSXAttribute node.\n *\n * Use this in your ESLint rule's JSXAttribute handler to process\n * className and class attributes.\n *\n * @example\n * ```typescript\n * JSXAttribute(node) {\n *   const locations = findClassnameStringsInAttribute(node);\n *   for (const location of locations) {\n *     if (hasBannedPattern(location.value)) {\n *       context.report({ node: location.reportNode, ... });\n *     }\n *   }\n * }\n * ```\n */\nexport const findClassnameStringsInAttribute = (node: TSESTree.JSXAttribute): Array<ClassnameLocation> => {\n  return extractFromJsxAttribute(node);\n};\n\n/**\n * Find all classname string locations in a VariableDeclarator node.\n *\n * Use this in your ESLint rule's VariableDeclarator handler to process\n * variables with classname-like names.\n *\n * @example\n * ```typescript\n * VariableDeclarator(node) {\n *   const locations = findClassnameStringsInVariable(node);\n *   for (const location of locations) {\n *     if (hasBannedPattern(location.value)) {\n *       context.report({ node: location.reportNode, ... });\n *     }\n *   }\n * }\n * ```\n */\nconst findClassnameStringsInVariable = (node: TSESTree.VariableDeclarator): Array<ClassnameLocation> => {\n  return extractFromVariableDeclarator(node);\n};\n\n// =============================================================================\n// Utility Helpers for Fixing\n// =============================================================================\n\n/**\n * Split a classname string into individual class names.\n * Handles whitespace-separated classes.\n */\nexport const splitClasses = (value: string): Array<string> => {\n  return value.split(/\\s+/).filter(Boolean);\n};\n\n/**\n * Join class names into a single string.\n */\nexport const joinClasses = (classes: Array<string>): string => {\n  return classes.join(\" \");\n};\n\n/**\n * Create a JSON-formatted array string from an array of class names.\n * Useful for auto-fix operations.\n */\nexport const formatAsArray = (classes: Array<string>): string => {\n  return JSON.stringify(classes);\n};\n\n/**\n * Get the quote character used in a string literal.\n */\nconst getQuoteChar = (node: TSESTree.Literal): string => {\n  if (typeof node.value === \"string\" && node.raw) {\n    return node.raw.charAt(0);\n  }\n  return '\"';\n};\n\n/**\n * Create a quoted string with the same quote style as the original.\n */\nconst quoteString = (value: string, originalNode: TSESTree.Literal): string => {\n  const quote = getQuoteChar(originalNode);\n  return `${quote}${value}${quote}`;\n};\n"]}

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

@@ -0,0 +1,14 @@
+/**
+ * Find the nearest file with a given name by walking up the directory tree.
+ *
+ * @param filePath - The starting file path
+ * @param fileName - The file name to search for (e.g., "package.json", "project.json")
+ * @returns Absolute path to the file or null if not found
+ * @example
+ * const pkgPath = findNearestFile("/workspace/libs/my-lib/src/index.ts", "package.json");
+ * // Returns: "/workspace/libs/my-lib/package.json"
+ * @example
+ * const projectPath = findNearestFile("/workspace/libs/my-lib/src/index.ts", "project.json");
+ * // Returns: "/workspace/libs/my-lib/project.json"
+ */
+export declare const findNearestFile: (filePath: string, fileName: string) => string | null;

package/src/lib/utils/file-utils.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findNearestFile = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+/**
+ * Utility functions for working with files in ESLint rules.
+ *
+ * ## Main Functions
+ * - `isTestFile()` - Check if a file is a test file
+ * - `isStoryFile()` - Check if a file is a Storybook story file
+ * - `matchesFilePattern()` - Check if a file matches a glob pattern
+ * - `findNearestFile()` - Find the nearest file by walking up the directory tree
+ */
+/**
+ * Convert a glob pattern to a regular expression.
+ * Supports common glob patterns used in ESLint configurations.
+ *
+ * @param pattern - Glob pattern (e.g., "**\/*.spec.ts", "**\/*.{ts,tsx}")
+ * @returns Regular expression that matches the pattern
+ * @example
+ * globToRegex("**\/*.spec.ts") // Matches any .spec.ts file
+ * globToRegex("**\/*.{ts,tsx}") // Matches any .ts or .tsx file
+ */
+const globToRegex = (pattern) => {
+    // Escape special regex characters except glob special chars
+    let regexPattern = pattern
+        .replace(/\./g, "\\.") // Escape dots
+        .replace(/\*\*/g, "@@DOUBLESTAR@@") // Temporarily replace **
+        .replace(/\*/g, "[^/]*") // Single * matches anything except /
+        .replace(/@@DOUBLESTAR@@/g, ".*") // ** matches anything including /
+        .replace(/\?/g, "."); // ? matches single character
+    // Handle brace expansion: {ts,tsx} → (ts|tsx)
+    regexPattern = regexPattern.replace(/\{([^}]+)\}/g, (_, group) => {
+        return `(${group.replace(/,/g, "|")})`;
+    });
+    return new RegExp(`^${regexPattern}$`);
+};
+/**
+ * Check if a file path matches a glob pattern.
+ *
+ * @param filePath - The file path to check
+ * @param pattern - Glob pattern (e.g., "**\/*.spec.ts")
+ * @returns True if the file matches the pattern
+ * @example
+ * matchesFilePattern("src/component.spec.ts", "**\/*.spec.ts") // → true
+ * matchesFilePattern("src/component.ts", "**\/*.spec.ts") // → false
+ */
+const matchesFilePattern = (filePath, pattern) => {
+    const regex = globToRegex(pattern);
+    return regex.test(filePath);
+};
+/**
+ * Check if a file path is a test file based on naming conventions.
+ *
+ * @param filePath - The file path to check
+ * @returns True if the file is a test file
+ * @example
+ * isTestFile("src/component.spec.ts") // → true
+ * isTestFile("src/component.test.tsx") // → true
+ * isTestFile("src/component.ts") // → false
+ */
+const isTestFile = (filePath) => {
+    return /\.(spec|test)\.(ts|tsx|js|jsx)$/.test(filePath);
+};
+/**
+ * Check if a file path is a Storybook story file.
+ *
+ * @param filePath - The file path to check
+ * @returns True if the file is a story file
+ * @example
+ * isStoryFile("src/component.stories.ts") // → true
+ * isStoryFile("src/component.stories.tsx") // → true
+ * isStoryFile("src/component.ts") // → false
+ */
+const isStoryFile = (filePath) => {
+    return /\.stories\.(ts|tsx|js|jsx)$/.test(filePath);
+};
+/**
+ * Find the nearest file with a given name by walking up the directory tree.
+ *
+ * @param filePath - The starting file path
+ * @param fileName - The file name to search for (e.g., "package.json", "project.json")
+ * @returns Absolute path to the file or null if not found
+ * @example
+ * const pkgPath = findNearestFile("/workspace/libs/my-lib/src/index.ts", "package.json");
+ * // Returns: "/workspace/libs/my-lib/package.json"
+ * @example
+ * const projectPath = findNearestFile("/workspace/libs/my-lib/src/index.ts", "project.json");
+ * // Returns: "/workspace/libs/my-lib/project.json"
+ */
+const findNearestFile = (filePath, fileName) => {
+    let currentDir = path.dirname(filePath);
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const targetPath = path.join(currentDir, fileName);
+        if (fs.existsSync(targetPath)) {
+            return targetPath;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return null;
+};
+exports.findNearestFile = findNearestFile;
+//# sourceMappingURL=file-utils.js.map

package/src/lib/utils/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../../../../../../libs/eslint/plugin-trackunit/src/lib/utils/file-utils.ts"],"names":[],"mappings":";;;;AAAA,+CAAyB;AACzB,mDAA6B;AAE7B;;;;;;;;GAQG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,GAAG,CAAC,OAAe,EAAU,EAAE;IAC9C,4DAA4D;IAC5D,IAAI,YAAY,GAAG,OAAO;SACvB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,cAAc;SACpC,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,yBAAyB;SAC5D,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,qCAAqC;SAC7D,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,kCAAkC;SACnE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,6BAA6B;IAErD,8CAA8C;IAC9C,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QAC/D,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,kBAAkB,GAAG,CAAC,QAAgB,EAAE,OAAe,EAAW,EAAE;IACxE,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAW,EAAE;IAC/C,OAAO,iCAAiC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAW,EAAE;IAChD,OAAO,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAiB,EAAE;IACnF,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEnD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAfW,QAAA,eAAe,mBAe1B","sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\n\n/**\n * Utility functions for working with files in ESLint rules.\n *\n * ## Main Functions\n * - `isTestFile()` - Check if a file is a test file\n * - `isStoryFile()` - Check if a file is a Storybook story file\n * - `matchesFilePattern()` - Check if a file matches a glob pattern\n * - `findNearestFile()` - Find the nearest file by walking up the directory tree\n */\n\n/**\n * Convert a glob pattern to a regular expression.\n * Supports common glob patterns used in ESLint configurations.\n *\n * @param pattern - Glob pattern (e.g., \"**\\/*.spec.ts\", \"**\\/*.{ts,tsx}\")\n * @returns Regular expression that matches the pattern\n * @example\n * globToRegex(\"**\\/*.spec.ts\") // Matches any .spec.ts file\n * globToRegex(\"**\\/*.{ts,tsx}\") // Matches any .ts or .tsx file\n */\nconst globToRegex = (pattern: string): RegExp => {\n  // Escape special regex characters except glob special chars\n  let regexPattern = pattern\n    .replace(/\\./g, \"\\\\.\") // Escape dots\n    .replace(/\\*\\*/g, \"@@DOUBLESTAR@@\") // Temporarily replace **\n    .replace(/\\*/g, \"[^/]*\") // Single * matches anything except /\n    .replace(/@@DOUBLESTAR@@/g, \".*\") // ** matches anything including /\n    .replace(/\\?/g, \".\"); // ? matches single character\n\n  // Handle brace expansion: {ts,tsx} → (ts|tsx)\n  regexPattern = regexPattern.replace(/\\{([^}]+)\\}/g, (_, group) => {\n    return `(${group.replace(/,/g, \"|\")})`;\n  });\n\n  return new RegExp(`^${regexPattern}$`);\n};\n\n/**\n * Check if a file path matches a glob pattern.\n *\n * @param filePath - The file path to check\n * @param pattern - Glob pattern (e.g., \"**\\/*.spec.ts\")\n * @returns True if the file matches the pattern\n * @example\n * matchesFilePattern(\"src/component.spec.ts\", \"**\\/*.spec.ts\") // → true\n * matchesFilePattern(\"src/component.ts\", \"**\\/*.spec.ts\") // → false\n */\nconst matchesFilePattern = (filePath: string, pattern: string): boolean => {\n  const regex = globToRegex(pattern);\n  return regex.test(filePath);\n};\n\n/**\n * Check if a file path is a test file based on naming conventions.\n *\n * @param filePath - The file path to check\n * @returns True if the file is a test file\n * @example\n * isTestFile(\"src/component.spec.ts\") // → true\n * isTestFile(\"src/component.test.tsx\") // → true\n * isTestFile(\"src/component.ts\") // → false\n */\nconst isTestFile = (filePath: string): boolean => {\n  return /\\.(spec|test)\\.(ts|tsx|js|jsx)$/.test(filePath);\n};\n\n/**\n * Check if a file path is a Storybook story file.\n *\n * @param filePath - The file path to check\n * @returns True if the file is a story file\n * @example\n * isStoryFile(\"src/component.stories.ts\") // → true\n * isStoryFile(\"src/component.stories.tsx\") // → true\n * isStoryFile(\"src/component.ts\") // → false\n */\nconst isStoryFile = (filePath: string): boolean => {\n  return /\\.stories\\.(ts|tsx|js|jsx)$/.test(filePath);\n};\n\n/**\n * Find the nearest file with a given name by walking up the directory tree.\n *\n * @param filePath - The starting file path\n * @param fileName - The file name to search for (e.g., \"package.json\", \"project.json\")\n * @returns Absolute path to the file or null if not found\n * @example\n * const pkgPath = findNearestFile(\"/workspace/libs/my-lib/src/index.ts\", \"package.json\");\n * // Returns: \"/workspace/libs/my-lib/package.json\"\n * @example\n * const projectPath = findNearestFile(\"/workspace/libs/my-lib/src/index.ts\", \"project.json\");\n * // Returns: \"/workspace/libs/my-lib/project.json\"\n */\nexport const findNearestFile = (filePath: string, fileName: string): string | null => {\n  let currentDir = path.dirname(filePath);\n  const root = path.parse(currentDir).root;\n\n  while (currentDir !== root) {\n    const targetPath = path.join(currentDir, fileName);\n\n    if (fs.existsSync(targetPath)) {\n      return targetPath;\n    }\n\n    currentDir = path.dirname(currentDir);\n  }\n\n  return null;\n};\n"]}

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

@@ -0,0 +1,85 @@
+import { TSESLint, TSESTree } from "@typescript-eslint/utils";
+/**
+ * Find an existing import declaration for a given package.
+ *
+ * @example
+ * // Returns the import node if it exists:
+ * // import { useState } from "react";
+ * const reactImport = findImportDeclaration(sourceCode, "react");
+ */
+export declare const findImportDeclaration: (sourceCode: Readonly<TSESLint.SourceCode>, packageName: string) => TSESTree.ImportDeclaration | undefined;
+/**
+ * Get existing import specifiers from an import declaration.
+ *
+ * @example
+ * // Given: import { useState, useEffect } from "react";
+ * getImportSpecifiers(importNode)  // → Set(["useState", "useEffect"])
+ */
+export declare const getImportSpecifiers: (importNode: TSESTree.ImportDeclaration) => Set<string>;
+interface AddImportSpecifiersOptions {
+    sourceCode: Readonly<TSESLint.SourceCode>;
+    fixer: TSESLint.RuleFixer;
+    packageName: string;
+    /** Specifiers to add (e.g., ["useState", "useEffect"]) */
+    specifiers: Array<string>;
+    /** Optional: Existing import to merge into. If not provided, creates a new import statement */
+    existingImport?: TSESTree.ImportDeclaration;
+}
+/**
+ * Add import specifiers to an existing import or create a new import statement.
+ * Automatically handles merging, semicolons, newlines, alphabetical sorting, and formatting.
+ *
+ * @example
+ * // Case 1: No existing import - creates new
+ * // Before: (no imports)
+ * // After:  import { useEffect, useState } from "react";
+ * @example
+ * // Case 2: Merge with existing import
+ * // Before: import { useState } from "react";
+ * // After:  import { useEffect, useState } from "react";
+ */
+export declare const addImportSpecifiers: (options: AddImportSpecifiersOptions) => Array<TSESLint.RuleFix>;
+interface ReplaceNamespaceWithDestructuredOptions {
+    sourceCode: Readonly<TSESLint.SourceCode>;
+    fixer: TSESLint.RuleFixer;
+    packageName: string;
+    /** The namespace/default import statement to be replaced (e.g., `import React from "react"`) */
+    namespaceImportToReplace: TSESTree.ImportDeclaration;
+    /** Specifiers to add to the destructured import (e.g., ["useState", "useEffect"]) */
+    specifiersToAdd: Iterable<string>;
+    /** Optional: A separate destructured import to merge everything into (e.g., `import { FC } from "react"`) */
+    mergeIntoImport?: TSESTree.ImportDeclaration;
+}
+/**
+ * Replace a namespace/default import with destructured imports.
+ * Automatically handles merging, semicolons, sorting, and formatting.
+ *
+ * ## Example 1: Replace in-place (no other import)
+ * ```typescript
+ * // Before:
+ * import React from "react";
+ * React.useEffect(() => {}, []);
+ *
+ * // After:
+ * import { useEffect } from "react";
+ * useEffect(() => {}, []);
+ * ```
+ *
+ * ## Example 2: Merge with existing destructured import
+ * ```typescript
+ * // Before:
+ * import React from "react";        // ← namespaceImportToReplace
+ * import { useState } from "react"; // ← mergeIntoImport
+ * React.useEffect(() => {}, []);
+ *
+ * // After:
+ * import { useEffect, useState } from "react"; // ← Merged!
+ * useEffect(() => {}, []);
+ * ```
+ *
+ * @param namespaceImportToReplace - The namespace import to remove/replace
+ * @param specifiersToAdd - New specifiers to add
+ * @param mergeIntoImport - Optional separate destructured import to merge everything into
+ */
+export declare const replaceNamespaceWithDestructured: (options: ReplaceNamespaceWithDestructuredOptions) => Array<TSESLint.RuleFix>;
+export {};

package/src/lib/utils/import-utils.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceNamespaceWithDestructured = exports.addImportSpecifiers = exports.getImportSpecifiers = exports.findImportDeclaration = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+/**
+ * Utility functions for manipulating import statements in TypeScript ESLint rules.
+ *
+ * ## Design Philosophy
+ * Rules should focus on WHAT to do, not HOW to do it. This utility handles all the
+ * implementation details: semicolons, newlines, alphabetical sorting, merging, etc.
+ *
+ * ## Main Functions
+ * - `addImportSpecifiers()` - Add new imports or merge with existing ones
+ * - `replaceNamespaceWithDestructured()` - Replace namespace imports (e.g., `import React from "react"`)
+ * - `addSingleImportSpecifier()` - Convenience for adding a single import
+ *
+ * ## Helper Functions
+ * - `findImportDeclaration()` - Find existing import for a package
+ * - `hasImportSpecifier()` - Check if specific import already exists
+ * - `getImportSpecifiers()` - Extract specifiers from an import
+ */
+/**
+ * Internal helper to check if an import statement ends with a semicolon
+ */
+const hasSemicolon = (sourceCode, node) => {
+    const nodeText = sourceCode.getText(node);
+    return nodeText.trimEnd().endsWith(";");
+};
+/**
+ * Find an existing import declaration for a given package.
+ *
+ * @example
+ * // Returns the import node if it exists:
+ * // import { useState } from "react";
+ * const reactImport = findImportDeclaration(sourceCode, "react");
+ */
+const findImportDeclaration = (sourceCode, packageName) => {
+    const found = sourceCode.ast.body.find((node) => node.type === utils_1.AST_NODE_TYPES.ImportDeclaration && node.source.value === packageName);
+    return found;
+};
+exports.findImportDeclaration = findImportDeclaration;
+/**
+ * Check if a specific specifier is already imported from a package.
+ *
+ * @example
+ * // File has: import { useState, useEffect } from "react";
+ * hasImportSpecifier(sourceCode, "react", "useState")  // → true
+ * hasImportSpecifier(sourceCode, "react", "useRef")    // → false
+ */
+const hasImportSpecifier = (sourceCode, packageName, specifierName) => {
+    return sourceCode.ast.body.some(node => node.type === utils_1.AST_NODE_TYPES.ImportDeclaration &&
+        node.source.value === packageName &&
+        node.specifiers.some(specifier => specifier.type === utils_1.AST_NODE_TYPES.ImportSpecifier &&
+            specifier.imported.type === utils_1.AST_NODE_TYPES.Identifier &&
+            specifier.imported.name === specifierName));
+};
+/**
+ * Get existing import specifiers from an import declaration.
+ *
+ * @example
+ * // Given: import { useState, useEffect } from "react";
+ * getImportSpecifiers(importNode)  // → Set(["useState", "useEffect"])
+ */
+const getImportSpecifiers = (importNode) => {
+    return new Set(importNode.specifiers
+        .filter((s) => s.type === utils_1.AST_NODE_TYPES.ImportSpecifier)
+        .map(s => (s.imported.type === utils_1.AST_NODE_TYPES.Identifier ? s.imported.name : ""))
+        .filter(Boolean));
+};
+exports.getImportSpecifiers = getImportSpecifiers;
+/**
+ * Internal helper to build a properly formatted import statement with sorted specifiers
+ */
+const buildImportStatement = (sourceCode, packageName, specifiers, referenceNode) => {
+    const sortedSpecifiers = Array.from(specifiers).sort().join(", ");
+    const semicolon = referenceNode && hasSemicolon(sourceCode, referenceNode) ? ";" : ";";
+    return `import { ${sortedSpecifiers} } from "${packageName}"${semicolon}`;
+};
+/**
+ * Add import specifiers to an existing import or create a new import statement.
+ * Automatically handles merging, semicolons, newlines, alphabetical sorting, and formatting.
+ *
+ * @example
+ * // Case 1: No existing import - creates new
+ * // Before: (no imports)
+ * // After:  import { useEffect, useState } from "react";
+ * @example
+ * // Case 2: Merge with existing import
+ * // Before: import { useState } from "react";
+ * // After:  import { useEffect, useState } from "react";
+ */
+const addImportSpecifiers = (options) => {
+    const { sourceCode, fixer, packageName, specifiers, existingImport } = options;
+    const fixes = [];
+    if (existingImport) {
+        // Merge with existing import
+        const existingSpecifiers = (0, exports.getImportSpecifiers)(existingImport);
+        const combinedSpecifiers = new Set([...existingSpecifiers, ...specifiers]);
+        const importStatement = buildImportStatement(sourceCode, packageName, combinedSpecifiers, existingImport);
+        fixes.push(fixer.replaceText(existingImport, importStatement));
+    }
+    else {
+        // Create new import statement
+        const lastImport = sourceCode.ast.body.find((node) => node.type === utils_1.AST_NODE_TYPES.ImportDeclaration);
+        if (lastImport) {
+            // Add after existing imports with leading newline
+            const importStatement = "\n" + buildImportStatement(sourceCode, packageName, specifiers, lastImport);
+            fixes.push(fixer.insertTextAfter(lastImport, importStatement));
+        }
+        else {
+            // No imports exist - add at the beginning with trailing newlines
+            const firstNode = sourceCode.ast.body[0];
+            if (firstNode) {
+                const importStatement = buildImportStatement(sourceCode, packageName, specifiers) + "\n\n";
+                fixes.push(fixer.insertTextBefore(firstNode, importStatement));
+            }
+        }
+    }
+    return fixes;
+};
+exports.addImportSpecifiers = addImportSpecifiers;
+/**
+ * Add a single import specifier - convenience wrapper around addImportSpecifiers.
+ * Automatically finds and merges with existing imports from the same package.
+ *
+ * @example
+ * // Before: import { useState } from "react";
+ * // After:  import { useEffect, useState } from "react";
+ * addSingleImportSpecifier({ sourceCode, fixer, packageName: "react", specifier: "useEffect" })
+ */
+const addSingleImportSpecifier = (options) => {
+    const { sourceCode, packageName, specifier } = options;
+    const existingImport = (0, exports.findImportDeclaration)(sourceCode, packageName);
+    return (0, exports.addImportSpecifiers)({
+        ...options,
+        specifiers: [specifier],
+        existingImport,
+    });
+};
+/**
+ * Replace a namespace/default import with destructured imports.
+ * Automatically handles merging, semicolons, sorting, and formatting.
+ *
+ * ## Example 1: Replace in-place (no other import)
+ * ```typescript
+ * // Before:
+ * import React from "react";
+ * React.useEffect(() => {}, []);
+ *
+ * // After:
+ * import { useEffect } from "react";
+ * useEffect(() => {}, []);
+ * ```
+ *
+ * ## Example 2: Merge with existing destructured import
+ * ```typescript
+ * // Before:
+ * import React from "react";        // ← namespaceImportToReplace
+ * import { useState } from "react"; // ← mergeIntoImport
+ * React.useEffect(() => {}, []);
+ *
+ * // After:
+ * import { useEffect, useState } from "react"; // ← Merged!
+ * useEffect(() => {}, []);
+ * ```
+ *
+ * @param namespaceImportToReplace - The namespace import to remove/replace
+ * @param specifiersToAdd - New specifiers to add
+ * @param mergeIntoImport - Optional separate destructured import to merge everything into
+ */
+const replaceNamespaceWithDestructured = (options) => {
+    const { sourceCode, fixer, packageName, namespaceImportToReplace, specifiersToAdd, mergeIntoImport } = options;
+    const fixes = [];
+    // Get any existing destructured specifiers from the namespace import itself
+    const existingSpecifiersInNamespace = (0, exports.getImportSpecifiers)(namespaceImportToReplace);
+    const allNewSpecifiers = new Set([...existingSpecifiersInNamespace, ...specifiersToAdd]);
+    if (mergeIntoImport && mergeIntoImport !== namespaceImportToReplace) {
+        // Scenario: We have TWO imports - merge everything into the destructured one and remove the namespace one
+        const existingSpecifiers = (0, exports.getImportSpecifiers)(mergeIntoImport);
+        const combinedSpecifiers = new Set([...existingSpecifiers, ...allNewSpecifiers]);
+        const importStatement = buildImportStatement(sourceCode, packageName, combinedSpecifiers, mergeIntoImport);
+        fixes.push(fixer.replaceText(mergeIntoImport, importStatement));
+        fixes.push(fixer.remove(namespaceImportToReplace));
+    }
+    else {
+        // Scenario: Only ONE import - replace the namespace import in-place
+        const importStatement = buildImportStatement(sourceCode, packageName, allNewSpecifiers, namespaceImportToReplace);
+        fixes.push(fixer.replaceText(namespaceImportToReplace, importStatement));
+    }
+    return fixes;
+};
+exports.replaceNamespaceWithDestructured = replaceNamespaceWithDestructured;
+//# sourceMappingURL=import-utils.js.map

package/src/lib/utils/import-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-utils.js","sourceRoot":"","sources":["../../../../../../../libs/eslint/plugin-trackunit/src/lib/utils/import-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { AST_NODE_TYPES, TSESLint, TSESTree } from \"@typescript-eslint/utils\";\n\n/**\n * Utility functions for manipulating import statements in TypeScript ESLint rules.\n *\n * ## Design Philosophy\n * Rules should focus on WHAT to do, not HOW to do it. This utility handles all the\n * implementation details: semicolons, newlines, alphabetical sorting, merging, etc.\n *\n * ## Main Functions\n * - `addImportSpecifiers()` - Add new imports or merge with existing ones\n * - `replaceNamespaceWithDestructured()` - Replace namespace imports (e.g., `import React from \"react\"`)\n * - `addSingleImportSpecifier()` - Convenience for adding a single import\n *\n * ## Helper Functions\n * - `findImportDeclaration()` - Find existing import for a package\n * - `hasImportSpecifier()` - Check if specific import already exists\n * - `getImportSpecifiers()` - Extract specifiers from an import\n */\n\n/**\n * Internal helper to check if an import statement ends with a semicolon\n */\nconst hasSemicolon = (sourceCode: Readonly<TSESLint.SourceCode>, node: TSESTree.ImportDeclaration): boolean => {\n  const nodeText = sourceCode.getText(node);\n  return nodeText.trimEnd().endsWith(\";\");\n};\n\n/**\n * Find an existing import declaration for a given package.\n *\n * @example\n * // Returns the import node if it exists:\n * // import { useState } from \"react\";\n * const reactImport = findImportDeclaration(sourceCode, \"react\");\n */\nexport const findImportDeclaration = (\n  sourceCode: Readonly<TSESLint.SourceCode>,\n  packageName: string\n): TSESTree.ImportDeclaration | undefined => {\n  const found = sourceCode.ast.body.find(\n    (node): node is TSESTree.ImportDeclaration =>\n      node.type === AST_NODE_TYPES.ImportDeclaration && node.source.value === packageName\n  );\n  return found;\n};\n\n/**\n * Check if a specific specifier is already imported from a package.\n *\n * @example\n * // File has: import { useState, useEffect } from \"react\";\n * hasImportSpecifier(sourceCode, \"react\", \"useState\")  // → true\n * hasImportSpecifier(sourceCode, \"react\", \"useRef\")    // → false\n */\nconst hasImportSpecifier = (\n  sourceCode: Readonly<TSESLint.SourceCode>,\n  packageName: string,\n  specifierName: string\n): boolean => {\n  return sourceCode.ast.body.some(\n    node =>\n      node.type === AST_NODE_TYPES.ImportDeclaration &&\n      node.source.value === packageName &&\n      node.specifiers.some(\n        specifier =>\n          specifier.type === AST_NODE_TYPES.ImportSpecifier &&\n          specifier.imported.type === AST_NODE_TYPES.Identifier &&\n          specifier.imported.name === specifierName\n      )\n  );\n};\n\n/**\n * Get existing import specifiers from an import declaration.\n *\n * @example\n * // Given: import { useState, useEffect } from \"react\";\n * getImportSpecifiers(importNode)  // → Set([\"useState\", \"useEffect\"])\n */\nexport const getImportSpecifiers = (importNode: TSESTree.ImportDeclaration): Set<string> => {\n  return new Set(\n    importNode.specifiers\n      .filter((s): s is TSESTree.ImportSpecifier => s.type === AST_NODE_TYPES.ImportSpecifier)\n      .map(s => (s.imported.type === AST_NODE_TYPES.Identifier ? s.imported.name : \"\"))\n      .filter(Boolean)\n  );\n};\n\ninterface AddImportSpecifiersOptions {\n  sourceCode: Readonly<TSESLint.SourceCode>;\n  fixer: TSESLint.RuleFixer;\n  packageName: string;\n  /** Specifiers to add (e.g., [\"useState\", \"useEffect\"]) */\n  specifiers: Array<string>;\n  /** Optional: Existing import to merge into. If not provided, creates a new import statement */\n  existingImport?: TSESTree.ImportDeclaration;\n}\n\n/**\n * Internal helper to build a properly formatted import statement with sorted specifiers\n */\nconst buildImportStatement = (\n  sourceCode: Readonly<TSESLint.SourceCode>,\n  packageName: string,\n  specifiers: Iterable<string>,\n  referenceNode?: TSESTree.ImportDeclaration\n): string => {\n  const sortedSpecifiers = Array.from(specifiers).sort().join(\", \");\n  const semicolon = referenceNode && hasSemicolon(sourceCode, referenceNode) ? \";\" : \";\";\n  return `import { ${sortedSpecifiers} } from \"${packageName}\"${semicolon}`;\n};\n\n/**\n * Add import specifiers to an existing import or create a new import statement.\n * Automatically handles merging, semicolons, newlines, alphabetical sorting, and formatting.\n *\n * @example\n * // Case 1: No existing import - creates new\n * // Before: (no imports)\n * // After:  import { useEffect, useState } from \"react\";\n * @example\n * // Case 2: Merge with existing import\n * // Before: import { useState } from \"react\";\n * // After:  import { useEffect, useState } from \"react\";\n */\nexport const addImportSpecifiers = (options: AddImportSpecifiersOptions): Array<TSESLint.RuleFix> => {\n  const { sourceCode, fixer, packageName, specifiers, existingImport } = options;\n  const fixes: Array<TSESLint.RuleFix> = [];\n\n  if (existingImport) {\n    // Merge with existing import\n    const existingSpecifiers = getImportSpecifiers(existingImport);\n    const combinedSpecifiers = new Set([...existingSpecifiers, ...specifiers]);\n    const importStatement = buildImportStatement(sourceCode, packageName, combinedSpecifiers, existingImport);\n\n    fixes.push(fixer.replaceText(existingImport, importStatement));\n  } else {\n    // Create new import statement\n    const lastImport = sourceCode.ast.body.find(\n      (node): node is TSESTree.ImportDeclaration => node.type === AST_NODE_TYPES.ImportDeclaration\n    );\n\n    if (lastImport) {\n      // Add after existing imports with leading newline\n      const importStatement = \"\\n\" + buildImportStatement(sourceCode, packageName, specifiers, lastImport);\n      fixes.push(fixer.insertTextAfter(lastImport, importStatement));\n    } else {\n      // No imports exist - add at the beginning with trailing newlines\n      const firstNode = sourceCode.ast.body[0];\n      if (firstNode) {\n        const importStatement = buildImportStatement(sourceCode, packageName, specifiers) + \"\\n\\n\";\n        fixes.push(fixer.insertTextBefore(firstNode, importStatement));\n      }\n    }\n  }\n\n  return fixes;\n};\n\ninterface AddSingleImportSpecifierOptions {\n  sourceCode: Readonly<TSESLint.SourceCode>;\n  fixer: TSESLint.RuleFixer;\n  packageName: string;\n  /** The specifier to add (e.g., \"useState\") */\n  specifier: string;\n}\n\n/**\n * Add a single import specifier - convenience wrapper around addImportSpecifiers.\n * Automatically finds and merges with existing imports from the same package.\n *\n * @example\n * // Before: import { useState } from \"react\";\n * // After:  import { useEffect, useState } from \"react\";\n * addSingleImportSpecifier({ sourceCode, fixer, packageName: \"react\", specifier: \"useEffect\" })\n */\nconst addSingleImportSpecifier = (options: AddSingleImportSpecifierOptions): Array<TSESLint.RuleFix> => {\n  const { sourceCode, packageName, specifier } = options;\n  const existingImport = findImportDeclaration(sourceCode, packageName);\n\n  return addImportSpecifiers({\n    ...options,\n    specifiers: [specifier],\n    existingImport,\n  });\n};\n\ninterface ReplaceNamespaceWithDestructuredOptions {\n  sourceCode: Readonly<TSESLint.SourceCode>;\n  fixer: TSESLint.RuleFixer;\n  packageName: string;\n  /** The namespace/default import statement to be replaced (e.g., `import React from \"react\"`) */\n  namespaceImportToReplace: TSESTree.ImportDeclaration;\n  /** Specifiers to add to the destructured import (e.g., [\"useState\", \"useEffect\"]) */\n  specifiersToAdd: Iterable<string>;\n  /** Optional: A separate destructured import to merge everything into (e.g., `import { FC } from \"react\"`) */\n  mergeIntoImport?: TSESTree.ImportDeclaration;\n}\n\n/**\n * Replace a namespace/default import with destructured imports.\n * Automatically handles merging, semicolons, sorting, and formatting.\n *\n * ## Example 1: Replace in-place (no other import)\n * ```typescript\n * // Before:\n * import React from \"react\";\n * React.useEffect(() => {}, []);\n *\n * // After:\n * import { useEffect } from \"react\";\n * useEffect(() => {}, []);\n * ```\n *\n * ## Example 2: Merge with existing destructured import\n * ```typescript\n * // Before:\n * import React from \"react\";        // ← namespaceImportToReplace\n * import { useState } from \"react\"; // ← mergeIntoImport\n * React.useEffect(() => {}, []);\n *\n * // After:\n * import { useEffect, useState } from \"react\"; // ← Merged!\n * useEffect(() => {}, []);\n * ```\n *\n * @param namespaceImportToReplace - The namespace import to remove/replace\n * @param specifiersToAdd - New specifiers to add\n * @param mergeIntoImport - Optional separate destructured import to merge everything into\n */\nexport const replaceNamespaceWithDestructured = (\n  options: ReplaceNamespaceWithDestructuredOptions\n): Array<TSESLint.RuleFix> => {\n  const { sourceCode, fixer, packageName, namespaceImportToReplace, specifiersToAdd, mergeIntoImport } = options;\n  const fixes: Array<TSESLint.RuleFix> = [];\n\n  // Get any existing destructured specifiers from the namespace import itself\n  const existingSpecifiersInNamespace = getImportSpecifiers(namespaceImportToReplace);\n  const allNewSpecifiers = new Set([...existingSpecifiersInNamespace, ...specifiersToAdd]);\n\n  if (mergeIntoImport && mergeIntoImport !== namespaceImportToReplace) {\n    // Scenario: We have TWO imports - merge everything into the destructured one and remove the namespace one\n    const existingSpecifiers = getImportSpecifiers(mergeIntoImport);\n    const combinedSpecifiers = new Set([...existingSpecifiers, ...allNewSpecifiers]);\n    const importStatement = buildImportStatement(sourceCode, packageName, combinedSpecifiers, mergeIntoImport);\n\n    fixes.push(fixer.replaceText(mergeIntoImport, importStatement));\n    fixes.push(fixer.remove(namespaceImportToReplace));\n  } else {\n    // Scenario: Only ONE import - replace the namespace import in-place\n    const importStatement = buildImportStatement(sourceCode, packageName, allNewSpecifiers, namespaceImportToReplace);\n    fixes.push(fixer.replaceText(namespaceImportToReplace, importStatement));\n  }\n\n  return fixes;\n};\n"]}

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

@@ -0,0 +1,59 @@
+/**
+ * Utility functions for working with NX project metadata in ESLint rules.
+ *
+ * ## Main Functions
+ * - `getProjectMetadata()` - Get NX project metadata from project.json
+ * - `projectMatchesCriteria()` - Check if project matches given criteria
+ */
+export type ProjectMetadata = {
+    name: string;
+    tags: Array<string>;
+    targets: Array<string>;
+    projectJsonPath: string;
+};
+export type MatchCriteria = {
+    tags?: Array<string>;
+    targets?: Array<string>;
+    tagsMatchMode?: "some" | "every";
+    targetsMatchMode?: "some" | "every";
+};
+/**
+ * Get NX project metadata from the nearest project.json file.
+ *
+ * @param filePath - Absolute path to a file in the project
+ * @returns Project metadata or null if no project.json found
+ * @example
+ * const metadata = getProjectMetadata("/workspace/libs/my-lib/src/index.ts");
+ * // Returns: { name: "my-lib", tags: ["type:react"], targets: ["build", "test"], ... }
+ */
+export declare const getProjectMetadata: (filePath: string) => ProjectMetadata | null;
+/**
+ * Check if project metadata matches the given criteria.
+ *
+ * @param metadata - Project metadata to check
+ * @param criteria - Criteria to match against
+ * @returns True if metadata matches all criteria
+ * @example
+ * // Check if project has the "scope:tool" tag
+ * projectMatchesCriteria(metadata, { tags: ["scope:tool"] })
+ * @example
+ * // Check if project has ALL specified tags
+ * projectMatchesCriteria(metadata, {
+ *   tags: ["scope:tool", "type:vanilla"],
+ *   tagsMatchMode: "every"
+ * })
+ * @example
+ * // Check if project has ANY of the specified tags
+ * projectMatchesCriteria(metadata, {
+ *   tags: ["scope:tool", "scope:client"],
+ *   tagsMatchMode: "some"
+ * })
+ * @example
+ * // Check if project has specific targets
+ * projectMatchesCriteria(metadata, { targets: ["build", "test"] })
+ */
+export declare const projectMatchesCriteria: (metadata: ProjectMetadata, criteria: MatchCriteria) => boolean;
+/**
+ * Clear the metadata cache. Useful for testing.
+ */
+export declare const clearMetadataCache: () => void;