uilint-eslint 0.2.21 → 0.2.23

package/dist/rules/no-prop-drilling-depth.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/create-rule.ts","../../src/utils/export-resolver.ts","../../src/rules/no-prop-drilling-depth.ts"],"sourcesContent":["/**\n * Rule creation helper using @typescript-eslint/utils\n */\n\nimport { ESLintUtils } from \"@typescript-eslint/utils\";\n\nexport const createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/peter-suggate/uilint/blob/main/packages/uilint-eslint/docs/rules/${name}.md`\n);\n\n/**\n * Schema for prompting user to configure a rule option in the CLI\n */\nexport interface OptionFieldSchema {\n  /** Field name in the options object */\n  key: string;\n  /** Display label for the prompt */\n  label: string;\n  /** Prompt type */\n  type: \"text\" | \"number\" | \"boolean\" | \"select\" | \"multiselect\";\n  /** Default value */\n  defaultValue: unknown;\n  /** Placeholder text (for text/number inputs) */\n  placeholder?: string;\n  /** Options for select/multiselect */\n  options?: Array<{ value: string | number; label: string }>;\n  /** Description/hint for the field */\n  description?: string;\n}\n\n/**\n * Schema describing how to prompt for rule options during installation\n */\nexport interface RuleOptionSchema {\n  /** Fields that can be configured for this rule */\n  fields: OptionFieldSchema[];\n}\n\n/**\n * Colocated rule metadata - exported alongside each rule\n *\n * This structure keeps all rule metadata in the same file as the rule implementation,\n * making it easy to maintain and extend as new rules are added.\n */\nexport interface RuleMeta {\n  /** Rule identifier (e.g., \"no-arbitrary-tailwind\") - must match filename */\n  id: string;\n\n  /** Display name for CLI (e.g., \"No Arbitrary Tailwind\") */\n  name: string;\n\n  /** Short description for CLI selection prompts (one line) */\n  description: string;\n\n  /** Default severity level */\n  defaultSeverity: \"error\" | \"warn\" | \"off\";\n\n  /** Category for grouping in CLI */\n  category: \"static\" | \"semantic\";\n\n  /** Whether this rule requires a styleguide file */\n  requiresStyleguide?: boolean;\n\n  /** Default options for the rule (passed as second element in ESLint config) */\n  defaultOptions?: unknown[];\n\n  /** Schema for prompting user to configure options during install */\n  optionSchema?: RuleOptionSchema;\n\n  /**\n   * Detailed documentation in markdown format.\n   * Should include:\n   * - What the rule does\n   * - Why it's useful\n   * - Examples of incorrect and correct code\n   * - Configuration options explained\n   */\n  docs: string;\n}\n\n/**\n * Helper to define rule metadata with type safety\n */\nexport function defineRuleMeta(meta: RuleMeta): RuleMeta {\n  return meta;\n}\n","/**\n * Export Resolver\n *\n * Resolves import paths and finds export definitions, following re-exports\n * to their original source files.\n */\n\nimport { ResolverFactory } from \"oxc-resolver\";\nimport { parse } from \"@typescript-eslint/typescript-estree\";\nimport { readFileSync, existsSync } from \"fs\";\nimport { dirname, join, extname } from \"path\";\nimport type { TSESTree } from \"@typescript-eslint/utils\";\n\n// Module-level resolver instance (reused across calls)\nlet resolverInstance: ReturnType<typeof ResolverFactory.prototype.sync> | null =\n  null;\nlet resolverFactory: ResolverFactory | null = null;\n\n/**\n * Information about a resolved export\n */\nexport interface ResolvedExport {\n  /** The name of the export (e.g., \"Button\") */\n  name: string;\n  /** Absolute path to the file containing the actual definition */\n  filePath: string;\n  /** The local name in the source file (may differ from export name) */\n  localName: string;\n  /** Whether this is a re-export (export { X } from './other') */\n  isReexport: boolean;\n}\n\n/**\n * Cache for file exports to avoid re-parsing\n */\nconst exportCache = new Map<\n  string,\n  Map<string, { localName: string; reexportSource?: string }>\n>();\n\n/**\n * Cache for parsed ASTs\n */\nconst astCache = new Map<string, TSESTree.Program>();\n\n/**\n * Cache for resolved paths\n */\nconst resolvedPathCache = new Map<string, string | null>();\n\n/**\n * Get or create the resolver factory\n */\nfunction getResolverFactory(): ResolverFactory {\n  if (!resolverFactory) {\n    resolverFactory = new ResolverFactory({\n      extensions: [\".tsx\", \".ts\", \".jsx\", \".js\"],\n      mainFields: [\"module\", \"main\"],\n      conditionNames: [\"import\", \"require\", \"node\", \"default\"],\n      // Enable TypeScript path resolution\n      tsconfig: {\n        configFile: \"tsconfig.json\",\n        references: \"auto\",\n      },\n    });\n  }\n  return resolverFactory;\n}\n\n/**\n * Resolve an import path to an absolute file path\n */\nexport function resolveImportPath(\n  importSource: string,\n  fromFile: string\n): string | null {\n  const cacheKey = `${fromFile}::${importSource}`;\n\n  if (resolvedPathCache.has(cacheKey)) {\n    return resolvedPathCache.get(cacheKey) ?? null;\n  }\n\n  // Skip node_modules\n  if (\n    importSource.startsWith(\"react\") ||\n    importSource.startsWith(\"next\") ||\n    (!importSource.startsWith(\".\") &&\n      !importSource.startsWith(\"@/\") &&\n      !importSource.startsWith(\"~/\"))\n  ) {\n    // Check if it's a known external package\n    if (\n      importSource.includes(\"@mui/\") ||\n      importSource.includes(\"@chakra-ui/\") ||\n      importSource.includes(\"antd\") ||\n      importSource.includes(\"@radix-ui/\")\n    ) {\n      // Return a marker for external packages - we don't resolve them but track them\n      resolvedPathCache.set(cacheKey, null);\n      return null;\n    }\n    resolvedPathCache.set(cacheKey, null);\n    return null;\n  }\n\n  try {\n    const factory = getResolverFactory();\n    const fromDir = dirname(fromFile);\n    const result = factory.sync(fromDir, importSource);\n\n    if (result.path) {\n      resolvedPathCache.set(cacheKey, result.path);\n      return result.path;\n    }\n  } catch {\n    // Fallback: try manual resolution for common patterns\n    const resolved = manualResolve(importSource, fromFile);\n    resolvedPathCache.set(cacheKey, resolved);\n    return resolved;\n  }\n\n  resolvedPathCache.set(cacheKey, null);\n  return null;\n}\n\n/**\n * Manual fallback resolution for common patterns\n */\nfunction manualResolve(importSource: string, fromFile: string): string | null {\n  const fromDir = dirname(fromFile);\n  const extensions = [\".tsx\", \".ts\", \".jsx\", \".js\"];\n\n  // Handle @/ alias - find tsconfig and resolve\n  if (importSource.startsWith(\"@/\")) {\n    const projectRoot = findProjectRoot(fromFile);\n    if (projectRoot) {\n      const relativePath = importSource.slice(2); // Remove @/\n      for (const ext of extensions) {\n        const candidate = join(projectRoot, relativePath + ext);\n        if (existsSync(candidate)) {\n          return candidate;\n        }\n        // Try index file\n        const indexCandidate = join(projectRoot, relativePath, `index${ext}`);\n        if (existsSync(indexCandidate)) {\n          return indexCandidate;\n        }\n      }\n    }\n  }\n\n  // Handle relative imports\n  if (importSource.startsWith(\".\")) {\n    for (const ext of extensions) {\n      const candidate = join(fromDir, importSource + ext);\n      if (existsSync(candidate)) {\n        return candidate;\n      }\n      // Try index file\n      const indexCandidate = join(fromDir, importSource, `index${ext}`);\n      if (existsSync(indexCandidate)) {\n        return indexCandidate;\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Find the project root by looking for tsconfig.json or package.json\n */\nfunction findProjectRoot(fromFile: string): string | null {\n  let dir = dirname(fromFile);\n  const root = \"/\";\n\n  while (dir !== root) {\n    if (existsSync(join(dir, \"tsconfig.json\"))) {\n      return dir;\n    }\n    if (existsSync(join(dir, \"package.json\"))) {\n      return dir;\n    }\n    dir = dirname(dir);\n  }\n\n  return null;\n}\n\n/**\n * Parse a file and cache the AST\n */\nexport function parseFile(filePath: string): TSESTree.Program | null {\n  if (astCache.has(filePath)) {\n    return astCache.get(filePath)!;\n  }\n\n  try {\n    const content = readFileSync(filePath, \"utf-8\");\n    const ast = parse(content, {\n      jsx: true,\n      loc: true,\n      range: true,\n    });\n    astCache.set(filePath, ast);\n    return ast;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Extract export information from a file\n */\nfunction extractExports(\n  filePath: string\n): Map<string, { localName: string; reexportSource?: string }> {\n  if (exportCache.has(filePath)) {\n    return exportCache.get(filePath)!;\n  }\n\n  const exports = new Map<\n    string,\n    { localName: string; reexportSource?: string }\n  >();\n  const ast = parseFile(filePath);\n\n  if (!ast) {\n    exportCache.set(filePath, exports);\n    return exports;\n  }\n\n  for (const node of ast.body) {\n    // Handle: export function Button() {}\n    if (\n      node.type === \"ExportNamedDeclaration\" &&\n      node.declaration?.type === \"FunctionDeclaration\" &&\n      node.declaration.id\n    ) {\n      exports.set(node.declaration.id.name, {\n        localName: node.declaration.id.name,\n      });\n    }\n\n    // Handle: export const Button = () => {}\n    if (\n      node.type === \"ExportNamedDeclaration\" &&\n      node.declaration?.type === \"VariableDeclaration\"\n    ) {\n      for (const decl of node.declaration.declarations) {\n        if (decl.id.type === \"Identifier\") {\n          exports.set(decl.id.name, { localName: decl.id.name });\n        }\n      }\n    }\n\n    // Handle: export { Button } or export { Button as Btn }\n    if (node.type === \"ExportNamedDeclaration\" && node.specifiers.length > 0) {\n      const source = node.source?.value as string | undefined;\n      for (const spec of node.specifiers) {\n        if (spec.type === \"ExportSpecifier\") {\n          const exportedName =\n            spec.exported.type === \"Identifier\"\n              ? spec.exported.name\n              : spec.exported.value;\n          const localName =\n            spec.local.type === \"Identifier\"\n              ? spec.local.name\n              : spec.local.value;\n\n          exports.set(exportedName, {\n            localName,\n            reexportSource: source,\n          });\n        }\n      }\n    }\n\n    // Handle: export default function Button() {}\n    if (\n      node.type === \"ExportDefaultDeclaration\" &&\n      node.declaration.type === \"FunctionDeclaration\" &&\n      node.declaration.id\n    ) {\n      exports.set(\"default\", { localName: node.declaration.id.name });\n    }\n\n    // Handle: export default Button\n    if (\n      node.type === \"ExportDefaultDeclaration\" &&\n      node.declaration.type === \"Identifier\"\n    ) {\n      exports.set(\"default\", { localName: node.declaration.name });\n    }\n  }\n\n  exportCache.set(filePath, exports);\n  return exports;\n}\n\n/**\n * Resolve an export to its original definition, following re-exports\n */\nexport function resolveExport(\n  exportName: string,\n  filePath: string,\n  visited = new Set<string>()\n): ResolvedExport | null {\n  // Cycle detection\n  const key = `${filePath}::${exportName}`;\n  if (visited.has(key)) {\n    return null;\n  }\n  visited.add(key);\n\n  const exports = extractExports(filePath);\n  const exportInfo = exports.get(exportName);\n\n  if (!exportInfo) {\n    return null;\n  }\n\n  // If it's a re-export, follow the chain\n  if (exportInfo.reexportSource) {\n    const resolvedPath = resolveImportPath(exportInfo.reexportSource, filePath);\n    if (resolvedPath) {\n      return resolveExport(exportInfo.localName, resolvedPath, visited);\n    }\n    return null;\n  }\n\n  // This is the actual definition\n  return {\n    name: exportName,\n    filePath,\n    localName: exportInfo.localName,\n    isReexport: false,\n  };\n}\n\n/**\n * Clear all caches (useful for testing or watch mode)\n */\nexport function clearResolverCaches(): void {\n  exportCache.clear();\n  astCache.clear();\n  resolvedPathCache.clear();\n}\n","/**\n * Rule: no-prop-drilling-depth\n *\n * Warns when a prop is passed through multiple intermediate components\n * without being used, indicating prop drilling that should be refactored\n * to context or state management.\n *\n * Examples:\n * - Bad: Prop passed through 3+ components without use\n * - Good: Prop used directly in receiving component\n * - Good: Using Context or Zustand instead of drilling\n */\n\nimport type { TSESTree } from \"@typescript-eslint/utils\";\nimport { createRule, defineRuleMeta } from \"../utils/create-rule.js\";\nimport {\n  resolveImportPath,\n  parseFile,\n  clearResolverCaches,\n} from \"../utils/export-resolver.js\";\n\ntype MessageIds = \"propDrilling\";\ntype Options = [\n  {\n    /** Maximum depth before warning (default: 2) */\n    maxDepth?: number;\n    /** Props to ignore (e.g., className, style, children) */\n    ignoredProps?: string[];\n    /** Component patterns to skip (regex strings) */\n    ignoreComponents?: string[];\n  }\n];\n\n/**\n * Rule metadata - colocated with implementation for maintainability\n */\nexport const meta = defineRuleMeta({\n  id: \"no-prop-drilling-depth\",\n  name: \"No Prop Drilling Depth\",\n  description: \"Warn when props are drilled through too many components\",\n  defaultSeverity: \"warn\",\n  category: \"static\",\n  defaultOptions: [\n    {\n      maxDepth: 2,\n      ignoredProps: [\"className\", \"style\", \"children\", \"key\", \"ref\", \"id\"],\n      ignoreComponents: [],\n    },\n  ],\n  optionSchema: {\n    fields: [\n      {\n        key: \"maxDepth\",\n        label: \"Maximum drilling depth\",\n        type: \"number\",\n        defaultValue: 2,\n        description:\n          \"Maximum number of components a prop can pass through without use\",\n      },\n      {\n        key: \"ignoredProps\",\n        label: \"Ignored props\",\n        type: \"array\",\n        defaultValue: [\"className\", \"style\", \"children\", \"key\", \"ref\", \"id\"],\n        description: \"Prop names to ignore (common pass-through props)\",\n      },\n    ],\n  },\n  docs: `\n## What it does\n\nDetects when props are passed through multiple intermediate components without\nbeing used (prop drilling). This is often a sign that you should use React\nContext, Zustand, or another state management solution.\n\n## Why it's useful\n\n- **Maintainability**: Deep prop drilling creates tight coupling\n- **Refactoring**: Changes require updates in many files\n- **Readability**: Hard to trace where props come from\n- **Performance**: Unnecessary re-renders in intermediate components\n\n## Examples\n\n### ❌ Incorrect\n\n\\`\\`\\`tsx\n// Grandparent passes user through Parent to Child\nfunction Grandparent({ user }) {\n  return <Parent user={user} />;\n}\n\nfunction Parent({ user }) {\n  // Parent doesn't use 'user', just passes it along\n  return <Child user={user} />;\n}\n\nfunction Child({ user }) {\n  return <div>{user.name}</div>;\n}\n\\`\\`\\`\n\n### ✅ Correct\n\n\\`\\`\\`tsx\n// Use Context instead\nconst UserContext = createContext();\n\nfunction Grandparent({ user }) {\n  return (\n    <UserContext.Provider value={user}>\n      <Parent />\n    </UserContext.Provider>\n  );\n}\n\nfunction Child() {\n  const user = useContext(UserContext);\n  return <div>{user.name}</div>;\n}\n\\`\\`\\`\n\n## Configuration\n\n\\`\\`\\`js\n// eslint.config.js\n\"uilint/no-prop-drilling-depth\": [\"warn\", {\n  maxDepth: 2,                                    // Allow passing through 2 components\n  ignoredProps: [\"className\", \"style\", \"children\"], // Common pass-through props\n  ignoreComponents: [\"^Layout\", \"^Wrapper\"]       // Skip wrapper components\n}]\n\\`\\`\\`\n`,\n});\n\n/**\n * Information about a component's prop usage\n */\ninterface ComponentPropInfo {\n  /** Props received by the component */\n  receivedProps: Set<string>;\n  /** Props passed to child components: propName -> childComponentNames[] */\n  passedProps: Map<string, string[]>;\n  /** Props actually used in the component (not just passed) */\n  usedProps: Set<string>;\n  /** Child components that receive props from this component */\n  childComponents: string[];\n}\n\n/**\n * Cache for analyzed component prop information\n */\nconst componentPropCache = new Map<string, ComponentPropInfo>();\n\n/**\n * Clear the prop analysis cache\n */\nexport function clearPropCache(): void {\n  componentPropCache.clear();\n  clearResolverCaches();\n}\n\n/**\n * Check if a name is a React component (PascalCase)\n */\nfunction isComponentName(name: string): boolean {\n  return /^[A-Z][a-zA-Z0-9]*$/.test(name);\n}\n\n/**\n * Extract props from a function parameter\n */\nfunction extractPropsFromParam(\n  param: TSESTree.Parameter\n): { propNames: Set<string>; isSpread: boolean } {\n  const propNames = new Set<string>();\n  let isSpread = false;\n\n  if (param.type === \"ObjectPattern\") {\n    for (const prop of param.properties) {\n      if (prop.type === \"RestElement\") {\n        isSpread = true;\n      } else if (\n        prop.type === \"Property\" &&\n        prop.key.type === \"Identifier\"\n      ) {\n        propNames.add(prop.key.name);\n      }\n    }\n  } else if (param.type === \"Identifier\") {\n    // Single props parameter - assume all props accessed via props.x\n    isSpread = true;\n  }\n\n  return { propNames, isSpread };\n}\n\n/**\n * Find all JSX elements in a function body and extract prop passing info\n */\nfunction analyzeJSXPropPassing(\n  body: TSESTree.Node,\n  receivedProps: Set<string>\n): { passedProps: Map<string, string[]>; usedProps: Set<string> } {\n  const passedProps = new Map<string, string[]>();\n  const usedProps = new Set<string>();\n\n  function visit(node: TSESTree.Node): void {\n    if (!node || typeof node !== \"object\") return;\n\n    // Check JSX elements for prop passing\n    if (node.type === \"JSXOpeningElement\") {\n      const elementName = getJSXElementName(node.name);\n\n      // Only care about component elements (PascalCase)\n      if (elementName && isComponentName(elementName)) {\n        for (const attr of node.attributes) {\n          if (attr.type === \"JSXAttribute\" && attr.name.type === \"JSXIdentifier\") {\n            const attrName = attr.name.name;\n            const propValue = attr.value;\n\n            // Check if the attribute value is a received prop\n            if (propValue?.type === \"JSXExpressionContainer\") {\n              const expr = propValue.expression;\n              if (expr.type === \"Identifier\" && receivedProps.has(expr.name)) {\n                // This prop is being passed to a child\n                const existing = passedProps.get(expr.name) || [];\n                existing.push(elementName);\n                passedProps.set(expr.name, existing);\n              } else if (\n                expr.type === \"MemberExpression\" &&\n                expr.object.type === \"Identifier\" &&\n                expr.object.name === \"props\" &&\n                expr.property.type === \"Identifier\"\n              ) {\n                // props.x pattern\n                const propName = expr.property.name;\n                if (receivedProps.has(propName) || receivedProps.size === 0) {\n                  const existing = passedProps.get(propName) || [];\n                  existing.push(elementName);\n                  passedProps.set(propName, existing);\n                }\n              }\n            }\n          }\n\n          // Check for spread props: {...props} or {...rest}\n          if (attr.type === \"JSXSpreadAttribute\") {\n            if (attr.argument.type === \"Identifier\") {\n              const spreadName = attr.argument.name;\n              if (spreadName === \"props\" || receivedProps.has(spreadName)) {\n                // All props are being spread\n                for (const prop of receivedProps) {\n                  const existing = passedProps.get(prop) || [];\n                  existing.push(elementName);\n                  passedProps.set(prop, existing);\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n\n    // Check for prop usage (not just passing)\n    // e.g., {user.name} or {props.user.name} or just {user}\n    if (\n      node.type === \"MemberExpression\" &&\n      node.object.type === \"Identifier\" &&\n      receivedProps.has(node.object.name)\n    ) {\n      usedProps.add(node.object.name);\n    }\n\n    if (\n      node.type === \"Identifier\" &&\n      receivedProps.has(node.name) &&\n      node.parent?.type !== \"JSXExpressionContainer\"\n    ) {\n      // Prop used in expression (but not directly passed to child)\n      usedProps.add(node.name);\n    }\n\n    // Check for props.x.something usage\n    if (\n      node.type === \"MemberExpression\" &&\n      node.object.type === \"MemberExpression\" &&\n      node.object.object.type === \"Identifier\" &&\n      node.object.object.name === \"props\" &&\n      node.object.property.type === \"Identifier\"\n    ) {\n      usedProps.add(node.object.property.name);\n    }\n\n    // Recurse into children\n    for (const key of Object.keys(node)) {\n      if (key === \"parent\" || key === \"loc\" || key === \"range\") continue;\n      const child = (node as Record<string, unknown>)[key];\n      if (Array.isArray(child)) {\n        for (const item of child) {\n          if (item && typeof item === \"object\") {\n            visit(item as TSESTree.Node);\n          }\n        }\n      } else if (child && typeof child === \"object\") {\n        visit(child as TSESTree.Node);\n      }\n    }\n  }\n\n  visit(body);\n  return { passedProps, usedProps };\n}\n\n/**\n * Get the name of a JSX element\n */\nfunction getJSXElementName(node: TSESTree.JSXTagNameExpression): string | null {\n  if (node.type === \"JSXIdentifier\") {\n    return node.name;\n  }\n  if (node.type === \"JSXMemberExpression\") {\n    // Get the root object for namespace components\n    let current = node.object;\n    while (current.type === \"JSXMemberExpression\") {\n      current = current.object;\n    }\n    return current.type === \"JSXIdentifier\" ? current.name : null;\n  }\n  return null;\n}\n\n/**\n * Track prop drilling within a single file\n */\ninterface PropDrillingInfo {\n  propName: string;\n  component: string;\n  passedTo: string[];\n  usedDirectly: boolean;\n}\n\nexport default createRule<Options, MessageIds>({\n  name: \"no-prop-drilling-depth\",\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description: \"Warn when props are drilled through too many components\",\n    },\n    messages: {\n      propDrilling:\n        \"Prop '{{propName}}' is passed through {{depth}} component(s) without being used. Consider using Context or state management. Path: {{path}}\",\n    },\n    schema: [\n      {\n        type: \"object\",\n        properties: {\n          maxDepth: {\n            type: \"number\",\n            minimum: 1,\n            description: \"Maximum drilling depth before warning\",\n          },\n          ignoredProps: {\n            type: \"array\",\n            items: { type: \"string\" },\n            description: \"Props to ignore\",\n          },\n          ignoreComponents: {\n            type: \"array\",\n            items: { type: \"string\" },\n            description: \"Component patterns to skip (regex)\",\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n  },\n  defaultOptions: [\n    {\n      maxDepth: 2,\n      ignoredProps: [\"className\", \"style\", \"children\", \"key\", \"ref\", \"id\"],\n      ignoreComponents: [],\n    },\n  ],\n  create(context) {\n    const options = context.options[0] || {};\n    const maxDepth = options.maxDepth ?? 2;\n    const ignoredProps = new Set(\n      options.ignoredProps ?? [\n        \"className\",\n        \"style\",\n        \"children\",\n        \"key\",\n        \"ref\",\n        \"id\",\n      ]\n    );\n    const ignoreComponentPatterns = (options.ignoreComponents ?? []).map(\n      (p) => new RegExp(p)\n    );\n\n    // Track components and their prop flows within the file\n    const componentProps = new Map<string, ComponentPropInfo>();\n    const imports = new Map<string, string>(); // localName -> importSource\n    const componentNodes = new Map<string, TSESTree.Node>(); // componentName -> node\n\n    function shouldIgnoreComponent(name: string): boolean {\n      return ignoreComponentPatterns.some((pattern) => pattern.test(name));\n    }\n\n    function shouldIgnoreProp(name: string): boolean {\n      return ignoredProps.has(name);\n    }\n\n    /**\n     * Analyze a component function for prop drilling\n     */\n    function analyzeComponent(\n      name: string,\n      node: TSESTree.FunctionDeclaration | TSESTree.ArrowFunctionExpression | TSESTree.FunctionExpression,\n      reportNode: TSESTree.Node\n    ): void {\n      if (shouldIgnoreComponent(name)) return;\n\n      const firstParam = node.params[0];\n      if (!firstParam) return;\n\n      const { propNames, isSpread } = extractPropsFromParam(firstParam);\n\n      // If using spread without destructuring, we can't easily track props\n      if (isSpread && propNames.size === 0) return;\n\n      const body = node.body;\n      if (!body) return;\n\n      const { passedProps, usedProps } = analyzeJSXPropPassing(body, propNames);\n\n      componentProps.set(name, {\n        receivedProps: propNames,\n        passedProps,\n        usedProps,\n        childComponents: [...new Set([...passedProps.values()].flat())],\n      });\n\n      componentNodes.set(name, reportNode);\n    }\n\n    return {\n      // Track imports for cross-file analysis\n      ImportDeclaration(node) {\n        const source = node.source.value as string;\n        for (const spec of node.specifiers) {\n          if (spec.type === \"ImportSpecifier\" || spec.type === \"ImportDefaultSpecifier\") {\n            imports.set(spec.local.name, source);\n          }\n        }\n      },\n\n      // Analyze function declarations\n      FunctionDeclaration(node) {\n        if (node.id && isComponentName(node.id.name)) {\n          analyzeComponent(node.id.name, node, node);\n        }\n      },\n\n      // Analyze arrow functions\n      VariableDeclarator(node) {\n        if (\n          node.id.type === \"Identifier\" &&\n          isComponentName(node.id.name) &&\n          node.init?.type === \"ArrowFunctionExpression\"\n        ) {\n          analyzeComponent(node.id.name, node.init, node);\n        }\n      },\n\n      // Analyze at the end of the file\n      \"Program:exit\"() {\n        // Find drilling chains within the file\n        for (const [componentName, info] of componentProps) {\n          for (const [propName, children] of info.passedProps) {\n            if (shouldIgnoreProp(propName)) continue;\n\n            // Check if prop is used directly\n            if (info.usedProps.has(propName)) continue;\n\n            // Track the drilling chain\n            const chain: string[] = [componentName];\n            let depth = 0;\n            let current = children;\n\n            while (current.length > 0 && depth < maxDepth + 1) {\n              depth++;\n              const nextChildren: string[] = [];\n\n              for (const child of current) {\n                chain.push(child);\n                const childInfo = componentProps.get(child);\n\n                if (childInfo) {\n                  // Check if child uses the prop\n                  if (childInfo.usedProps.has(propName)) {\n                    // Prop is used here, drilling stops\n                    break;\n                  }\n\n                  // Check if child passes the prop further\n                  const childPasses = childInfo.passedProps.get(propName);\n                  if (childPasses) {\n                    nextChildren.push(...childPasses);\n                  }\n                }\n              }\n\n              current = nextChildren;\n            }\n\n            // Report if depth exceeds threshold\n            if (depth > maxDepth) {\n              const reportNode = componentNodes.get(componentName);\n              if (reportNode) {\n                context.report({\n                  node: reportNode,\n                  messageId: \"propDrilling\",\n                  data: {\n                    propName,\n                    depth: String(depth),\n                    path: chain.slice(0, maxDepth + 2).join(\" → \"),\n                  },\n                });\n              }\n            }\n          }\n        }\n      },\n    };\n  },\n});\n"],"mappings":"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","names":["meta"]}
+{"version":3,"sources":["../../src/utils/create-rule.ts","../../src/rules/no-prop-drilling-depth.ts"],"sourcesContent":["/**\n * Rule creation helper using @typescript-eslint/utils\n */\n\nimport { ESLintUtils } from \"@typescript-eslint/utils\";\n\nexport const createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/peter-suggate/uilint/blob/main/packages/uilint-eslint/docs/rules/${name}.md`\n);\n\n/**\n * Schema for prompting user to configure a rule option in the CLI\n */\nexport interface OptionFieldSchema {\n  /** Field name in the options object */\n  key: string;\n  /** Display label for the prompt */\n  label: string;\n  /** Prompt type */\n  type: \"text\" | \"number\" | \"boolean\" | \"select\" | \"multiselect\";\n  /** Default value */\n  defaultValue: unknown;\n  /** Placeholder text (for text/number inputs) */\n  placeholder?: string;\n  /** Options for select/multiselect */\n  options?: Array<{ value: string | number; label: string }>;\n  /** Description/hint for the field */\n  description?: string;\n}\n\n/**\n * Schema describing how to prompt for rule options during installation\n */\nexport interface RuleOptionSchema {\n  /** Fields that can be configured for this rule */\n  fields: OptionFieldSchema[];\n}\n\n/**\n * Colocated rule metadata - exported alongside each rule\n *\n * This structure keeps all rule metadata in the same file as the rule implementation,\n * making it easy to maintain and extend as new rules are added.\n */\nexport interface RuleMeta {\n  /** Rule identifier (e.g., \"no-arbitrary-tailwind\") - must match filename */\n  id: string;\n\n  /** Display name for CLI (e.g., \"No Arbitrary Tailwind\") */\n  name: string;\n\n  /** Short description for CLI selection prompts (one line) */\n  description: string;\n\n  /** Default severity level */\n  defaultSeverity: \"error\" | \"warn\" | \"off\";\n\n  /** Category for grouping in CLI */\n  category: \"static\" | \"semantic\";\n\n  /** Whether this rule requires a styleguide file */\n  requiresStyleguide?: boolean;\n\n  /** Default options for the rule (passed as second element in ESLint config) */\n  defaultOptions?: unknown[];\n\n  /** Schema for prompting user to configure options during install */\n  optionSchema?: RuleOptionSchema;\n\n  /**\n   * Detailed documentation in markdown format.\n   * Should include:\n   * - What the rule does\n   * - Why it's useful\n   * - Examples of incorrect and correct code\n   * - Configuration options explained\n   */\n  docs: string;\n}\n\n/**\n * Helper to define rule metadata with type safety\n */\nexport function defineRuleMeta(meta: RuleMeta): RuleMeta {\n  return meta;\n}\n","/**\n * Rule: no-prop-drilling-depth\n *\n * Warns when a prop is passed through multiple intermediate components\n * without being used, indicating prop drilling that should be refactored\n * to context or state management.\n *\n * Examples:\n * - Bad: Prop passed through 3+ components without use\n * - Good: Prop used directly in receiving component\n * - Good: Using Context or Zustand instead of drilling\n */\n\nimport type { TSESTree } from \"@typescript-eslint/utils\";\nimport { createRule, defineRuleMeta } from \"../utils/create-rule.js\";\n\ntype MessageIds = \"propDrilling\";\ntype Options = [\n  {\n    /** Maximum depth before warning (default: 2) */\n    maxDepth?: number;\n    /** Props to ignore (e.g., className, style, children) */\n    ignoredProps?: string[];\n    /** Component patterns to skip (regex strings) */\n    ignoreComponents?: string[];\n  }\n];\n\n/**\n * Rule metadata - colocated with implementation for maintainability\n */\nexport const meta = defineRuleMeta({\n  id: \"no-prop-drilling-depth\",\n  name: \"No Prop Drilling Depth\",\n  description: \"Warn when props are drilled through too many components\",\n  defaultSeverity: \"warn\",\n  category: \"static\",\n  defaultOptions: [\n    {\n      maxDepth: 2,\n      ignoredProps: [\"className\", \"style\", \"children\", \"key\", \"ref\", \"id\"],\n      ignoreComponents: [],\n    },\n  ],\n  optionSchema: {\n    fields: [\n      {\n        key: \"maxDepth\",\n        label: \"Maximum drilling depth\",\n        type: \"number\",\n        defaultValue: 2,\n        description:\n          \"Maximum number of components a prop can pass through without use\",\n      },\n      {\n        key: \"ignoredProps\",\n        label: \"Ignored props\",\n        type: \"text\",\n        defaultValue: \"className, style, children, key, ref, id\",\n        description: \"Comma-separated prop names to ignore (common pass-through props)\",\n      },\n    ],\n  },\n  docs: `\n## What it does\n\nDetects when props are passed through multiple intermediate components without\nbeing used (prop drilling). This is often a sign that you should use React\nContext, Zustand, or another state management solution.\n\n## Why it's useful\n\n- **Maintainability**: Deep prop drilling creates tight coupling\n- **Refactoring**: Changes require updates in many files\n- **Readability**: Hard to trace where props come from\n- **Performance**: Unnecessary re-renders in intermediate components\n\n## Examples\n\n### ❌ Incorrect\n\n\\`\\`\\`tsx\n// Grandparent passes user through Parent to Child\nfunction Grandparent({ user }) {\n  return <Parent user={user} />;\n}\n\nfunction Parent({ user }) {\n  // Parent doesn't use 'user', just passes it along\n  return <Child user={user} />;\n}\n\nfunction Child({ user }) {\n  return <div>{user.name}</div>;\n}\n\\`\\`\\`\n\n### ✅ Correct\n\n\\`\\`\\`tsx\n// Use Context instead\nconst UserContext = createContext();\n\nfunction Grandparent({ user }) {\n  return (\n    <UserContext.Provider value={user}>\n      <Parent />\n    </UserContext.Provider>\n  );\n}\n\nfunction Child() {\n  const user = useContext(UserContext);\n  return <div>{user.name}</div>;\n}\n\\`\\`\\`\n\n## Configuration\n\n\\`\\`\\`js\n// eslint.config.js\n\"uilint/no-prop-drilling-depth\": [\"warn\", {\n  maxDepth: 2,                                    // Allow passing through 2 components\n  ignoredProps: [\"className\", \"style\", \"children\"], // Common pass-through props\n  ignoreComponents: [\"^Layout\", \"^Wrapper\"]       // Skip wrapper components\n}]\n\\`\\`\\`\n`,\n});\n\n/**\n * Information about a component's prop usage\n */\ninterface ComponentPropInfo {\n  /** Props received by the component */\n  receivedProps: Set<string>;\n  /** Props passed to child components: propName -> childComponentNames[] */\n  passedProps: Map<string, string[]>;\n  /** Props actually used in the component (not just passed) */\n  usedProps: Set<string>;\n  /** Child components that receive props from this component */\n  childComponents: string[];\n}\n\n/**\n * Cache for analyzed component prop information\n */\nconst componentPropCache = new Map<string, ComponentPropInfo>();\n\n/**\n * Clear the prop analysis cache\n */\nexport function clearPropCache(): void {\n  componentPropCache.clear();\n}\n\n/**\n * Check if a name is a React component (PascalCase)\n */\nfunction isComponentName(name: string): boolean {\n  return /^[A-Z][a-zA-Z0-9]*$/.test(name);\n}\n\n/**\n * Extract props from a function parameter\n */\nfunction extractPropsFromParam(\n  param: TSESTree.Parameter\n): { propNames: Set<string>; isSpread: boolean } {\n  const propNames = new Set<string>();\n  let isSpread = false;\n\n  if (param.type === \"ObjectPattern\") {\n    for (const prop of param.properties) {\n      if (prop.type === \"RestElement\") {\n        isSpread = true;\n      } else if (\n        prop.type === \"Property\" &&\n        prop.key.type === \"Identifier\"\n      ) {\n        propNames.add(prop.key.name);\n      }\n    }\n  } else if (param.type === \"Identifier\") {\n    // Single props parameter - assume all props accessed via props.x\n    isSpread = true;\n  }\n\n  return { propNames, isSpread };\n}\n\n/**\n * Find all JSX elements in a function body and extract prop passing info\n */\nfunction analyzeJSXPropPassing(\n  body: TSESTree.Node,\n  receivedProps: Set<string>\n): { passedProps: Map<string, string[]>; usedProps: Set<string> } {\n  const passedProps = new Map<string, string[]>();\n  const usedProps = new Set<string>();\n\n  function visit(node: TSESTree.Node): void {\n    if (!node || typeof node !== \"object\") return;\n\n    // Check JSX elements for prop passing\n    if (node.type === \"JSXOpeningElement\") {\n      const elementName = getJSXElementName(node.name);\n\n      // Only care about component elements (PascalCase)\n      if (elementName && isComponentName(elementName)) {\n        for (const attr of node.attributes) {\n          if (attr.type === \"JSXAttribute\" && attr.name.type === \"JSXIdentifier\") {\n            const attrName = attr.name.name;\n            const propValue = attr.value;\n\n            // Check if the attribute value is a received prop\n            if (propValue?.type === \"JSXExpressionContainer\") {\n              const expr = propValue.expression;\n              if (expr.type === \"Identifier\" && receivedProps.has(expr.name)) {\n                // This prop is being passed to a child\n                const existing = passedProps.get(expr.name) || [];\n                existing.push(elementName);\n                passedProps.set(expr.name, existing);\n              } else if (\n                expr.type === \"MemberExpression\" &&\n                expr.object.type === \"Identifier\" &&\n                expr.object.name === \"props\" &&\n                expr.property.type === \"Identifier\"\n              ) {\n                // props.x pattern\n                const propName = expr.property.name;\n                if (receivedProps.has(propName) || receivedProps.size === 0) {\n                  const existing = passedProps.get(propName) || [];\n                  existing.push(elementName);\n                  passedProps.set(propName, existing);\n                }\n              }\n            }\n          }\n\n          // Check for spread props: {...props} or {...rest}\n          if (attr.type === \"JSXSpreadAttribute\") {\n            if (attr.argument.type === \"Identifier\") {\n              const spreadName = attr.argument.name;\n              if (spreadName === \"props\" || receivedProps.has(spreadName)) {\n                // All props are being spread\n                for (const prop of receivedProps) {\n                  const existing = passedProps.get(prop) || [];\n                  existing.push(elementName);\n                  passedProps.set(prop, existing);\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n\n    // Check for prop usage (not just passing)\n    // e.g., {user.name} or {props.user.name} or just {user}\n    if (\n      node.type === \"MemberExpression\" &&\n      node.object.type === \"Identifier\" &&\n      receivedProps.has(node.object.name)\n    ) {\n      usedProps.add(node.object.name);\n    }\n\n    if (\n      node.type === \"Identifier\" &&\n      receivedProps.has(node.name) &&\n      node.parent?.type !== \"JSXExpressionContainer\"\n    ) {\n      // Prop used in expression (but not directly passed to child)\n      usedProps.add(node.name);\n    }\n\n    // Check for props.x.something usage\n    if (\n      node.type === \"MemberExpression\" &&\n      node.object.type === \"MemberExpression\" &&\n      node.object.object.type === \"Identifier\" &&\n      node.object.object.name === \"props\" &&\n      node.object.property.type === \"Identifier\"\n    ) {\n      usedProps.add(node.object.property.name);\n    }\n\n    // Recurse into children\n    for (const key of Object.keys(node)) {\n      if (key === \"parent\" || key === \"loc\" || key === \"range\") continue;\n      const child = (node as unknown as Record<string, unknown>)[key];\n      if (Array.isArray(child)) {\n        for (const item of child) {\n          if (item && typeof item === \"object\") {\n            visit(item as TSESTree.Node);\n          }\n        }\n      } else if (child && typeof child === \"object\") {\n        visit(child as TSESTree.Node);\n      }\n    }\n  }\n\n  visit(body);\n  return { passedProps, usedProps };\n}\n\n/**\n * Get the name of a JSX element\n */\nfunction getJSXElementName(node: TSESTree.JSXTagNameExpression): string | null {\n  if (node.type === \"JSXIdentifier\") {\n    return node.name;\n  }\n  if (node.type === \"JSXMemberExpression\") {\n    // Get the root object for namespace components\n    let current = node.object;\n    while (current.type === \"JSXMemberExpression\") {\n      current = current.object;\n    }\n    return current.type === \"JSXIdentifier\" ? current.name : null;\n  }\n  return null;\n}\n\n/**\n * Track prop drilling within a single file\n */\ninterface PropDrillingInfo {\n  propName: string;\n  component: string;\n  passedTo: string[];\n  usedDirectly: boolean;\n}\n\nexport default createRule<Options, MessageIds>({\n  name: \"no-prop-drilling-depth\",\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description: \"Warn when props are drilled through too many components\",\n    },\n    messages: {\n      propDrilling:\n        \"Prop '{{propName}}' is passed through {{depth}} component(s) without being used. Consider using Context or state management. Path: {{path}}\",\n    },\n    schema: [\n      {\n        type: \"object\",\n        properties: {\n          maxDepth: {\n            type: \"number\",\n            minimum: 1,\n            description: \"Maximum drilling depth before warning\",\n          },\n          ignoredProps: {\n            type: \"array\",\n            items: { type: \"string\" },\n            description: \"Props to ignore\",\n          },\n          ignoreComponents: {\n            type: \"array\",\n            items: { type: \"string\" },\n            description: \"Component patterns to skip (regex)\",\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n  },\n  defaultOptions: [\n    {\n      maxDepth: 2,\n      ignoredProps: [\"className\", \"style\", \"children\", \"key\", \"ref\", \"id\"],\n      ignoreComponents: [],\n    },\n  ],\n  create(context) {\n    const options = context.options[0] || {};\n    const maxDepth = options.maxDepth ?? 2;\n    const ignoredProps = new Set(\n      options.ignoredProps ?? [\n        \"className\",\n        \"style\",\n        \"children\",\n        \"key\",\n        \"ref\",\n        \"id\",\n      ]\n    );\n    const ignoreComponentPatterns = (options.ignoreComponents ?? []).map(\n      (p) => new RegExp(p)\n    );\n\n    // Track components and their prop flows within the file\n    const componentProps = new Map<string, ComponentPropInfo>();\n    const imports = new Map<string, string>(); // localName -> importSource\n    const componentNodes = new Map<string, TSESTree.Node>(); // componentName -> node\n\n    function shouldIgnoreComponent(name: string): boolean {\n      return ignoreComponentPatterns.some((pattern) => pattern.test(name));\n    }\n\n    function shouldIgnoreProp(name: string): boolean {\n      return ignoredProps.has(name);\n    }\n\n    /**\n     * Analyze a component function for prop drilling\n     */\n    function analyzeComponent(\n      name: string,\n      node: TSESTree.FunctionDeclaration | TSESTree.ArrowFunctionExpression | TSESTree.FunctionExpression,\n      reportNode: TSESTree.Node\n    ): void {\n      if (shouldIgnoreComponent(name)) return;\n\n      const firstParam = node.params[0];\n      if (!firstParam) return;\n\n      const { propNames, isSpread } = extractPropsFromParam(firstParam);\n\n      // If using spread without destructuring, we can't easily track props\n      if (isSpread && propNames.size === 0) return;\n\n      const body = node.body;\n      if (!body) return;\n\n      const { passedProps, usedProps } = analyzeJSXPropPassing(body, propNames);\n\n      componentProps.set(name, {\n        receivedProps: propNames,\n        passedProps,\n        usedProps,\n        childComponents: [...new Set([...passedProps.values()].flat())],\n      });\n\n      componentNodes.set(name, reportNode);\n    }\n\n    return {\n      // Track imports for cross-file analysis\n      ImportDeclaration(node) {\n        const source = node.source.value as string;\n        for (const spec of node.specifiers) {\n          if (spec.type === \"ImportSpecifier\" || spec.type === \"ImportDefaultSpecifier\") {\n            imports.set(spec.local.name, source);\n          }\n        }\n      },\n\n      // Analyze function declarations\n      FunctionDeclaration(node) {\n        if (node.id && isComponentName(node.id.name)) {\n          analyzeComponent(node.id.name, node, node);\n        }\n      },\n\n      // Analyze arrow functions\n      VariableDeclarator(node) {\n        if (\n          node.id.type === \"Identifier\" &&\n          isComponentName(node.id.name) &&\n          node.init?.type === \"ArrowFunctionExpression\"\n        ) {\n          analyzeComponent(node.id.name, node.init, node);\n        }\n      },\n\n      // Analyze at the end of the file\n      \"Program:exit\"() {\n        // Find drilling chains within the file\n        for (const [componentName, info] of componentProps) {\n          for (const [propName, children] of info.passedProps) {\n            if (shouldIgnoreProp(propName)) continue;\n\n            // Check if prop is used directly\n            if (info.usedProps.has(propName)) continue;\n\n            // Track the drilling chain\n            const chain: string[] = [componentName];\n            let depth = 0;\n            let current = children;\n\n            while (current.length > 0 && depth < maxDepth + 1) {\n              depth++;\n              const nextChildren: string[] = [];\n\n              for (const child of current) {\n                chain.push(child);\n                const childInfo = componentProps.get(child);\n\n                if (childInfo) {\n                  // Check if child uses the prop\n                  if (childInfo.usedProps.has(propName)) {\n                    // Prop is used here, drilling stops\n                    break;\n                  }\n\n                  // Check if child passes the prop further\n                  const childPasses = childInfo.passedProps.get(propName);\n                  if (childPasses) {\n                    nextChildren.push(...childPasses);\n                  }\n                }\n              }\n\n              current = nextChildren;\n            }\n\n            // Report if depth exceeds threshold\n            if (depth > maxDepth) {\n              const reportNode = componentNodes.get(componentName);\n              if (reportNode) {\n                context.report({\n                  node: reportNode,\n                  messageId: \"propDrilling\",\n                  data: {\n                    propName,\n                    depth: String(depth),\n                    path: chain.slice(0, maxDepth + 2).join(\" → \"),\n                  },\n                });\n              }\n            }\n          }\n        }\n      },\n    };\n  },\n});\n"],"mappings":"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","names":["meta"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uilint-eslint",
-  "version": "0.2.21",
+  "version": "0.2.23",
   "description": "ESLint plugin for UILint - AI-powered UI consistency checking",
   "author": "Peter Suggate",
   "repository": {
@@ -35,7 +35,7 @@
     "@typescript-eslint/utils": "^8.35.1",
     "oxc-resolver": "^11.0.0",
     "xxhash-wasm": "^1.1.0",
-    "uilint-core": "0.2.21"
+    "uilint-core": "0.2.23"
   },
   "devDependencies": {
     "@types/eslint": "^9.6.1",

package/src/rules/consistent-dark-mode.test.ts

@@ -238,9 +238,8 @@ ruleTester.run("consistent-dark-mode", rule, {
 
     // ============================================
     // SEMANTIC/THEMED COLORS (shadcn, etc.) - EXEMPT
-    // These tests REQUIRE the semantic color exemption.
-    // Without it, these would trigger "missingDarkMode" errors
-    // because the new aggressive detection treats unknown values as colors.
+    // CSS variable-based colors that handle dark mode automatically.
+    // These should NEVER trigger issues because they're not explicit Tailwind colors.
     // ============================================
     {
       name: "shadcn background/foreground semantic colors",
@@ -312,21 +311,33 @@ ruleTester.run("consistent-dark-mode", rule, {
     },
 
     // ============================================
-    // CUSTOM COLORS (detected by aggressive detection, need dark variants)
-    // These would NOT have been detected by the old allowlist-based approach
-    // but ARE detected by the new exclusion-based approach.
+    // CUSTOM/NON-TAILWIND COLORS - SHOULD NOT TRIGGER
+    // Any color name that is NOT a built-in Tailwind color should be exempt.
+    // These are assumed to be CSS variables or custom theme colors.
     // ============================================
     {
-      name: "custom color with dark variant - brand",
-      code: `<div className="bg-brand dark:bg-brand-dark" />`,
+      name: "custom brand color - should not trigger",
+      code: `<div className="bg-brand text-brand-foreground" />`,
+    },
+    {
+      name: "custom company colors - should not trigger",
+      code: `<div className="bg-company-primary text-company-secondary" />`,
+    },
+    {
+      name: "custom gradient colors - should not trigger",
+      code: `<div className="from-brand-start to-brand-end" />`,
+    },
+    {
+      name: "arbitrary custom color names - should not trigger",
+      code: `<div className="bg-my-custom-color text-another-custom" />`,
     },
     {
-      name: "custom color with dark variant - custom name",
-      code: `<div className="text-company-blue dark:text-company-blue-light" />`,
+      name: "custom color mixed with themed Tailwind color",
+      code: `<div className="bg-brand border-blue-500 dark:border-blue-400" />`,
     },
     {
-      name: "custom gradient colors with dark variants",
-      code: `<div className="from-brand-start dark:from-brand-start-dark to-brand-end dark:to-brand-end-dark" />`,
+      name: "custom ring and fill colors - should not trigger",
+      code: `<div className="ring-brand-accent fill-custom-icon" />`,
     },
 
     // ============================================
@@ -787,13 +798,12 @@ ruleTester.run("consistent-dark-mode", rule, {
     },
 
     // ============================================
-    // CUSTOM COLORS WITHOUT DARK MODE
-    // These tests verify the aggressive detection catches custom colors.
-    // The old allowlist approach would NOT have caught these.
+    // EXPLICIT TAILWIND COLORS - SHOULD TRIGGER
+    // These are built-in Tailwind color names that should require dark variants.
     // ============================================
     {
-      name: "custom color without dark mode - brand",
-      code: `<div className="bg-brand text-brand-foreground" />`,
+      name: "explicit Tailwind colors - white/black",
+      code: `<div className="bg-white text-black" />`,
       errors: [
         {
           messageId: "missingDarkMode",
@@ -801,8 +811,8 @@ ruleTester.run("consistent-dark-mode", rule, {
       ],
     },
     {
-      name: "custom color without dark mode - company colors",
-      code: `<div className="bg-company-primary text-company-secondary" />`,
+      name: "explicit Tailwind colors - slate scale",
+      code: `<div className="bg-slate-100 text-slate-900" />`,
       errors: [
         {
           messageId: "missingDarkMode",
@@ -810,18 +820,44 @@ ruleTester.run("consistent-dark-mode", rule, {
       ],
     },
     {
-      name: "custom color inconsistent - one themed one not",
-      code: `<div className="bg-brand dark:bg-brand-dark text-brand-accent" />`,
+      name: "explicit Tailwind colors - various palette colors",
+      code: `<div className="bg-red-500 text-blue-600 border-green-400" />`,
       errors: [
         {
-          messageId: "inconsistentDarkMode",
-          data: { unthemed: "text-brand-accent" },
+          messageId: "missingDarkMode",
         },
       ],
     },
     {
-      name: "custom gradient colors without dark mode",
-      code: `<div className="from-brand-start to-brand-end" />`,
+      name: "explicit Tailwind colors - all gray variants",
+      code: `<div className="bg-gray-50 text-zinc-900 border-neutral-200" />`,
+      errors: [
+        {
+          messageId: "missingDarkMode",
+        },
+      ],
+    },
+    {
+      name: "explicit Tailwind colors - modern palette",
+      code: `<div className="from-cyan-400 via-sky-500 to-indigo-600" />`,
+      errors: [
+        {
+          messageId: "missingDarkMode",
+        },
+      ],
+    },
+    {
+      name: "explicit Tailwind colors - warm palette",
+      code: `<div className="bg-amber-100 text-orange-800 border-yellow-300" />`,
+      errors: [
+        {
+          messageId: "missingDarkMode",
+        },
+      ],
+    },
+    {
+      name: "explicit Tailwind colors - with opacity modifier",
+      code: `<div className="bg-blue-500/50 text-gray-900/80" />`,
       errors: [
         {
           messageId: "missingDarkMode",

package/src/rules/consistent-dark-mode.ts

@@ -49,7 +49,7 @@ warns when a file uses color classes without any dark mode theming.
 
 - **Prevents broken dark mode**: Catches cases where some colors change in dark mode but others don't
 - **Encourages completeness**: Prompts you to add dark mode support where it's missing
-- **Supports semantic colors**: Automatically ignores shadcn/CSS variable colors that handle dark mode internally
+- **No false positives**: Only flags explicit Tailwind colors, not custom/CSS variable colors
 
 ## Examples
 
@@ -71,8 +71,10 @@ warns when a file uses color classes without any dark mode theming.
 // All color classes have dark variants
 <div className="bg-white dark:bg-slate-900 text-black dark:text-white">
 
-// Using semantic colors (automatically themed)
+// Using semantic/custom colors (automatically themed via CSS variables)
 <div className="bg-background text-foreground">
+<div className="bg-brand text-brand-foreground">
+<div className="bg-primary text-primary-foreground">
 
 // Consistent theming
 <button className="bg-blue-500 dark:bg-blue-600 border-gray-300 dark:border-gray-600">
@@ -89,7 +91,9 @@ warns when a file uses color classes without any dark mode theming.
 
 ## Notes
 
-- Semantic colors (like shadcn's \`background\`, \`foreground\`, \`primary\`, etc.) are exempt
+- Only explicit Tailwind colors (like \`blue-500\`, \`white\`, \`slate-900\`) require dark variants
+- Custom/semantic colors (\`background\`, \`foreground\`, \`brand\`, \`primary\`, etc.) are exempt
+- These are assumed to be CSS variables that handle dark mode automatically
 - Transparent, inherit, and current values are exempt
 - Non-color utilities (like \`text-lg\`, \`border-2\`) are correctly ignored
 `,
@@ -125,137 +129,43 @@ const COLOR_PREFIXES = [
 // Values that don't need dark variants (colorless or inherited)
 const EXEMPT_SUFFIXES = ["transparent", "inherit", "current", "auto", "none"];
 
-// Known non-color utilities that use color prefixes
-// These are utilities like text-lg (font size), text-center (alignment), etc.
-const NON_COLOR_UTILITIES = new Set([
-  // Exempt values (colorless or inherited) - don't need dark variants
-  "transparent",
-  "inherit",
-  "current",
-  "auto",
-  "none",
-  // text- utilities that aren't colors
-  "xs",
-  "sm",
-  "base",
-  "lg",
-  "xl",
-  "2xl",
-  "3xl",
-  "4xl",
-  "5xl",
-  "6xl",
-  "7xl",
-  "8xl",
-  "9xl",
-  "left",
-  "center",
-  "right",
-  "justify",
-  "start",
-  "end",
-  "wrap",
-  "nowrap",
-  "balance",
-  "pretty",
-  "ellipsis",
-  "clip",
-  // border- utilities that aren't colors
-  "0",
-  "2",
-  "4",
-  "8",
-  "solid",
-  "dashed",
-  "dotted",
-  "double",
-  "hidden",
-  "collapse",
-  "separate",
-  // shadow- utilities that aren't colors
-  // Note: "sm", "lg", "xl", "2xl" already included above
-  "md",
-  "inner",
-  // ring- utilities that aren't colors
-  // Note: "0", "2", "4", "8" already included above
-  "1",
-  "inset",
-  // outline- utilities that aren't colors
-  // Note: numeric values already included
-  "offset-0",
-  "offset-1",
-  "offset-2",
-  "offset-4",
-  "offset-8",
-  // decoration- utilities that aren't colors
-  // Note: "solid", "double", "dotted", "dashed" already included
-  "wavy",
-  "from-font",
-  "clone",
-  "slice",
-  // divide- utilities that aren't colors
-  "x",
-  "y",
-  "x-0",
-  "x-2",
-  "x-4",
-  "x-8",
-  "y-0",
-  "y-2",
-  "y-4",
-  "y-8",
-  "x-reverse",
-  "y-reverse",
-  // gradient direction utilities (from-, via-, to- prefixes)
-  "t",
-  "tr",
-  "r",
-  "br",
-  "b",
-  "bl",
-  "l",
-  "tl",
+// Built-in Tailwind CSS color palette names
+// These are the ONLY colors that should trigger dark mode warnings.
+// Custom colors (like 'brand', 'company-primary') are assumed to be
+// CSS variables that handle dark mode automatically.
+const TAILWIND_COLOR_NAMES = new Set([
+  // Special colors
+  "white",
+  "black",
+  // Gray scale palettes
+  "slate",
+  "gray",
+  "zinc",
+  "neutral",
+  "stone",
+  // Warm colors
+  "red",
+  "orange",
+  "amber",
+  "yellow",
+  // Green colors
+  "lime",
+  "green",
+  "emerald",
+  "teal",
+  // Blue colors
+  "cyan",
+  "sky",
+  "blue",
+  "indigo",
+  // Purple/Pink colors
+  "violet",
+  "purple",
+  "fuchsia",
+  "pink",
+  "rose",
 ]);
 
-// Semantic color names used by theming systems like shadcn
-// These are CSS variable-based colors that handle dark mode automatically
-const SEMANTIC_COLOR_NAMES = new Set([
-  // Core shadcn colors
-  "background",
-  "foreground",
-  // Component colors
-  "card",
-  "card-foreground",
-  "popover",
-  "popover-foreground",
-  "primary",
-  "primary-foreground",
-  "secondary",
-  "secondary-foreground",
-  "muted",
-  "muted-foreground",
-  "accent",
-  "accent-foreground",
-  "destructive",
-  "destructive-foreground",
-  // Form/UI colors
-  "border",
-  "input",
-  "ring",
-  // Sidebar colors (shadcn sidebar component)
-  "sidebar",
-  "sidebar-foreground",
-  "sidebar-border",
-  "sidebar-primary",
-  "sidebar-primary-foreground",
-  "sidebar-accent",
-  "sidebar-accent-foreground",
-  "sidebar-ring",
-]);
-
-// Pattern for semantic chart colors (chart-1, chart-2, etc.)
-const CHART_COLOR_PATTERN = /^chart-\d+$/;
-
 /**
  * Check if a class has 'dark' in its variant chain
  */
@@ -287,27 +197,57 @@ function getColorPrefix(baseClass: string): string | null {
 }
 
 /**
- * Check if the value is a semantic/themed color (e.g., shadcn)
- * These colors use CSS variables that automatically handle dark mode
+ * Check if the value is an explicit Tailwind color.
+ * Uses an allowlist approach: only built-in Tailwind color names trigger warnings.
+ * Custom colors (like 'brand', 'primary', 'company-blue') are assumed to be
+ * CSS variables that handle dark mode automatically and should NOT trigger.
+ *
+ * Matches patterns like:
+ * - white, black (standalone colors)
+ * - blue-500, slate-900 (color-scale)
+ * - blue-500/50, gray-900/80 (with opacity modifier)
  */
-function isSemanticColor(value: string): boolean {
-  // Check for exact semantic color names
-  if (SEMANTIC_COLOR_NAMES.has(value)) {
+function isTailwindColor(value: string): boolean {
+  // Remove opacity modifier if present (e.g., "blue-500/50" -> "blue-500")
+  const valueWithoutOpacity = value.split("/")[0] || value;
+
+  // Check for standalone colors (white, black)
+  if (TAILWIND_COLOR_NAMES.has(valueWithoutOpacity)) {
     return true;
   }
 
-  // Check for chart colors (chart-1, chart-2, etc.)
-  if (CHART_COLOR_PATTERN.test(value)) {
-    return true;
+  // Check for color-scale pattern (e.g., "blue-500", "slate-900")
+  // Pattern: colorName-number where number is 50, 100, 200, ..., 950
+  const match = valueWithoutOpacity.match(/^([a-z]+)-(\d+)$/);
+  if (match) {
+    const colorName = match[1];
+    const scale = match[2];
+    // Valid Tailwind scales are: 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950
+    const validScales = [
+      "50",
+      "100",
+      "200",
+      "300",
+      "400",
+      "500",
+      "600",
+      "700",
+      "800",
+      "900",
+      "950",
+    ];
+    if (colorName && TAILWIND_COLOR_NAMES.has(colorName) && validScales.includes(scale || "")) {
+      return true;
+    }
   }
 
   return false;
 }
 
 /**
- * Check if the value after the prefix looks like a color value
- * Uses an exclusion-based approach: anything that's not a known non-color utility
- * and not a semantic color is treated as a potential color.
+ * Check if the value after the prefix looks like an explicit Tailwind color.
+ * Uses allowlist approach: only built-in Tailwind colors should trigger dark mode warnings.
+ * Custom/semantic colors (brand, primary, foreground, etc.) are NOT flagged.
  */
 function isColorValue(baseClass: string, prefix: string): boolean {
   const value = baseClass.slice(prefix.length);
@@ -317,23 +257,9 @@ function isColorValue(baseClass: string, prefix: string): boolean {
     return false;
   }
 
-  // Check if it's a semantic/themed color (exempt from dark mode requirements)
-  if (isSemanticColor(value)) {
-    return false;
-  }
-
-  // Check if it's a known non-color utility
-  if (NON_COLOR_UTILITIES.has(value)) {
-    return false;
-  }
-
-  // Treat everything else as a potential color
-  // This catches:
-  // - Standard Tailwind colors: blue-500, slate-900, white, black
-  // - Custom colors defined in tailwind.config: brand, primary (non-shadcn), custom-blue
-  // - Arbitrary values: [#fff], [rgb(255,0,0)], [var(--my-color)]
-  // - Opacity modifiers: blue-500/50, white/80
-  return true;
+  // Only flag explicit Tailwind colors
+  // Custom colors, CSS variable colors, and semantic colors are exempt
+  return isTailwindColor(value);
 }
 
 /**

package/src/rules/enforce-absolute-imports.ts

@@ -11,6 +11,7 @@
  */
 
 import { createRule, defineRuleMeta } from "../utils/create-rule.js";
+import type { TSESTree } from "@typescript-eslint/utils";
 
 type MessageIds = "preferAbsoluteImport";
 type Options = [
@@ -180,7 +181,7 @@ export default createRule<Options, MessageIds>({
      */
     function checkImportSource(
       source: string,
-      node: { loc?: { start: { line: number; column: number } } }
+      node: TSESTree.StringLiteral
     ): void {
       // Skip non-relative imports (node_modules, aliases, etc.)
       if (!isRelativeImport(source)) {
@@ -196,7 +197,7 @@ export default createRule<Options, MessageIds>({
 
       if (depth > maxRelativeDepth) {
         context.report({
-          node: node as Parameters<typeof context.report>[0]["node"],
+          node,
           messageId: "preferAbsoluteImport",
           data: {
             depth: String(depth),