@salesforce-ux/eslint-plugin-slds 1.0.7-internal → 1.0.8-internal

package/build/rules/v9/no-hardcoded-values/handlers/colorHandler.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../../../src/rules/v9/no-hardcoded-values/handlers/colorHandler.ts", "../../../../../src/utils/color-lib-utils.ts", "../../../../../src/utils/css-functions.ts", "../../../../../src/utils/property-matcher.ts", "../../../../../src/utils/hardcoded-shared-utils.ts", "../../../../../src/utils/css-utils.ts"],
-  "sourcesContent": ["import { findClosestColorHook, convertToHex, isValidColor } from '../../../../utils/color-lib-utils';\nimport { resolvePropertyToMatch } from '../../../../utils/property-matcher';\nimport { formatSuggestionHooks } from '../../../../utils/css-utils';\nimport type { HandlerContext, DeclarationHandler } from '../../../../types';\n\n// Import shared utilities for common logic\nimport { \n  handleShorthandAutoFix, \n  forEachColorValue,\n  type ReplacementInfo,\n  type PositionInfo\n} from '../../../../utils/hardcoded-shared-utils';\n\n/**\n * Handle color declarations using CSS tree parsing\n * Supports shorthand properties like background, border, etc.  \n * Uses css-tree for reliable AST-based parsing + chroma-js validation\n */\nexport const handleColorDeclaration: DeclarationHandler = (node: any, context: HandlerContext) => {\n  const cssProperty = node.property.toLowerCase();\n  const valueText = context.sourceCode.getText(node.value);\n  const replacements: ReplacementInfo[] = [];\n  \n  forEachColorValue(valueText, (colorValue, positionInfo) => {\n    if (colorValue !== 'transparent' && isValidColor(colorValue)) {\n      const replacement = createColorReplacement(colorValue, cssProperty, context, positionInfo, valueText);\n      if (replacement) {\n        replacements.push(replacement);\n      }\n    }\n  });\n  \n  // Apply shorthand auto-fix once all values are processed\n  handleShorthandAutoFix(node, context, valueText, replacements);\n};\n\n\n\n\n\n/**\n * Create color replacement info for shorthand auto-fix\n * Returns replacement data or null if no valid replacement\n */\nfunction createColorReplacement(\n  colorValue: string,\n  cssProperty: string,\n  context: HandlerContext,\n  positionInfo: PositionInfo,\n  originalValueText?: string\n): ReplacementInfo | null {\n  if (!positionInfo?.start) {\n    return null;\n  }\n\n  const hexValue = convertToHex(colorValue);\n  if (!hexValue) {\n    return null;\n  }\n\n  const propToMatch = resolvePropertyToMatch(cssProperty);\n  const closestHooks = findClosestColorHook(hexValue, context.valueToStylinghook, propToMatch);\n\n  // Use position information directly from CSS tree (already 0-based offsets)\n  const start = positionInfo.start.offset;\n  const end = positionInfo.end.offset;\n  \n  // Extract the original value from the CSS text to preserve spacing\n  const originalValue = originalValueText ? originalValueText.substring(start, end) : colorValue;\n\n  if (closestHooks.length === 1) {\n    // Has a single hook replacement - should provide autofix\n    return {\n      start,\n      end,\n      replacement: `var(${closestHooks[0]}, ${colorValue})`,\n      displayValue: closestHooks[0],\n      hasHook: true\n    };\n  } else if (closestHooks.length > 1) {\n    // Multiple hooks - format them for better readability\n    return {\n      start,\n      end,\n      replacement: originalValue,  // Use original value to preserve spacing\n      displayValue: formatSuggestionHooks(closestHooks),\n      hasHook: true\n    };\n  } else {\n    // No hooks - keep original value\n    return {\n      start,\n      end,\n      replacement: originalValue,  // Use original value to preserve spacing\n      displayValue: originalValue,\n      hasHook: false\n    };\n  }\n}\n\n\n\n\n\n", "//stylelint-sds/packages/stylelint-plugin-slds/src/utils/color-lib-utils.ts\nimport { ValueToStylingHooksMapping, ValueToStylingHookEntry } from '@salesforce-ux/sds-metadata/next';\nimport chroma from 'chroma-js';\nimport { generate } from '@eslint/css-tree';\nimport { isCssColorFunction } from './css-functions';\n\nconst LAB_THRESHOLD = 25; // Adjust this to set how strict the matching should be\n\nconst isHardCodedColor = (color: string): boolean => {\n  const colorRegex =\n    /\\b(rgb|rgba)\\((\\s*\\d{1,3}\\s*,\\s*){2,3}\\s*(0|1|0?\\.\\d+)\\s*\\)|#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})\\b|[a-zA-Z]+/g;\n  return colorRegex.test(color);\n};\n\nconst isHexCode = (color: string): boolean => {\n  const hexPattern = /^#(?:[0-9a-fA-F]{3}){1,2}$/; // Pattern for #RGB or #RRGGBB\n  return hexPattern.test(color);\n};\n\n// Convert a named color or hex code into a hex format using chroma-js\nconst convertToHex = (color: string): string | null => {\n  try {\n    // Try converting the color using chroma-js, which handles both named and hex colors\n    return chroma(color).hex();\n  } catch (e) {\n    // If chroma can't process the color, it's likely invalid\n    return null;\n  }\n};\n\n// Find the closest color hook using LAB distance\nconst findClosestColorHook = (\n  color: string,\n  supportedColors:ValueToStylingHooksMapping,\n  cssProperty: string\n): string[] => {\n  const returnStylingHooks: string[] = [];\n  const closestHooksWithSameProperty: { name: string; distance: number }[] = [];\n  const closestHooksWithoutSameProperty: { name: string; distance: number }[] =\n    [];\n  const closestHooksWithAllProperty: { name: string; distance: number }[] =\n    [];\n  const labColor = chroma(color).lab();\n\n  Object.entries(supportedColors).forEach(([sldsValue, data]) => {\n    if (sldsValue && isHexCode(sldsValue)) {\n      const hooks = data as ValueToStylingHookEntry[]; // Get the hooks for the sldsValue\n\n      hooks.forEach((hook) => {\n        const labSupportedColor = chroma(sldsValue).lab();\n        const distance = (JSON.stringify(labColor) === JSON.stringify(labSupportedColor)) ? 0\n            : chroma.distance(chroma.lab(...labColor), chroma.lab(...labSupportedColor), \"lab\");\n        // Check if the hook has the same property\n        if (hook.properties.includes(cssProperty)) {\n          // Add to same property hooks if within threshold\n          if (distance <= LAB_THRESHOLD) {\n            closestHooksWithSameProperty.push({ name: hook.name, distance });\n          }\n        } \n        // Check for the universal selector\n        else if ( hook.properties.includes(\"*\") ){\n          // Add to same property hooks if within threshold\n          if (distance <= LAB_THRESHOLD) {\n            closestHooksWithAllProperty.push({ name: hook.name, distance });\n          }\n        }\n        else {\n          // Add to different property hooks if within threshold\n          if (distance <= LAB_THRESHOLD) {\n            closestHooksWithoutSameProperty.push({ name: hook.name, distance });\n          }\n        }\n      });\n    }\n  });\n\n// Group hooks by their priority\nconst closesthookGroups = [\n  { hooks: closestHooksWithSameProperty, distance: 0 },\n  { hooks: closestHooksWithAllProperty, distance: 0 },\n  { hooks: closestHooksWithSameProperty, distance: Infinity },  // For hooks with distance > 0\n  { hooks: closestHooksWithAllProperty, distance: Infinity },\n  { hooks: closestHooksWithoutSameProperty, distance: Infinity },\n];\n\nfor (const group of closesthookGroups) {\n  // Filter hooks based on the distance condition\n  const filteredHooks = group.hooks.filter(h => \n    group.distance === 0 ? h.distance === 0 : h.distance > 0\n  );\n\n  if (returnStylingHooks.length < 1 && filteredHooks.length > 0) {\n    filteredHooks.sort((a, b) => a.distance - b.distance);\n    returnStylingHooks.push(...filteredHooks.slice(0, 5).map((h) => h.name));\n  }\n}\n\n\n  return Array.from(new Set(returnStylingHooks));\n};\n\n/**\n * This method is usefull to identify all possible css color values.\n *  - names colors\n *  - 6,8 digit hex\n *  - rgb and rgba\n *  - hsl and hsla\n */\nconst isValidColor = (val:string):boolean => chroma.valid(val);\n\n/**\n * Extract color value from CSS AST node\n */\nconst extractColorValue = (node: any): string | null => {\n  let colorValue: string | null = null;\n  \n  switch (node.type) {\n    case 'Hash':\n      colorValue = `#${node.value}`;\n      break;\n    case 'Identifier':\n      colorValue = node.name;\n      break;\n    case 'Function':\n      // Only extract color functions\n      if (isCssColorFunction(node.name)) {\n        colorValue = generate(node);\n      }\n      break;\n  }\n  \n  return colorValue && isValidColor(colorValue) ? colorValue : null;\n};\n\nexport { findClosestColorHook, convertToHex, isHexCode, isHardCodedColor, isValidColor, extractColorValue };\n", "//stylelint-sds/packages/stylelint-plugin-slds/src/utils/css-functions.ts\n/**\n * Complete list of CSS functions that should be preserved/recognized\n */\nconst CSS_FUNCTIONS = [\n    'attr',\n    'calc',\n    'color-mix',\n    'conic-gradient',\n    'counter',\n    'cubic-bezier',\n    'linear-gradient',\n    'max',\n    'min',\n    'radial-gradient',\n    'repeating-conic-gradient',\n    'repeating-linear-gradient',\n    'repeating-radial-gradient',\n    'var'\n  ];\n  \n  \n  const CSS_MATH_FUNCTIONS = ['calc', 'min', 'max'];\n  \n  \n  const RGB_COLOR_FUNCTIONS = ['rgb', 'rgba', 'hsl', 'hsla'];\n  \n  /**\n   * Regex for matching any CSS function (for general detection)\n   * Matches function names within other text\n   */\n  const cssFunctionsRegex = new RegExp(`(?:${CSS_FUNCTIONS.join('|')})`);\n  \n  \n  const cssFunctionsExactRegex = new RegExp(`^(?:${CSS_FUNCTIONS.join('|')})$`);\n  \n  \n  const cssMathFunctionsRegex = new RegExp(`^(?:${CSS_MATH_FUNCTIONS.join('|')})$`);\n  \n  export function containsCssFunction(value: string): boolean {\n    return cssFunctionsRegex.test(value);\n  }\n  \n  /**\n   * Check if a value is exactly a CSS function name\n   */\n  export function isCssFunction(value: string): boolean {\n    return cssFunctionsExactRegex.test(value);\n  }\n  \n  export function isCssMathFunction(value: string): boolean {\n    return cssMathFunctionsRegex.test(value);\n  }\n  \n  export function isCssColorFunction(value: string): boolean {\n    return RGB_COLOR_FUNCTIONS.includes(value);\n  }", "///stylelint-sds/packages/stylelint-plugin-slds/src/utils/property-matcher.ts\n/**\n * Check if any of the hook properties match the provided cssProperty using wildcard matching.\n * @param hookProperties - Array of property patterns (can contain wildcards like `*`)\n * @param cssProperty - The CSS property to be checked\n * @returns true if a match is found, otherwise false\n */\nexport function matchesCssProperty(\n  hookProperties: string[],\n  cssProperty: string\n): boolean {\n  return hookProperties.some((propertyPattern: string) => {\n    const regexPattern = new RegExp(\n      '^' + propertyPattern.replace(/\\*/g, '.*') + '$'\n    );\n    return regexPattern.test(cssProperty);\n  });\n}\n\n// Directions & Corners\nconst DIRECTION_VALUES = '(?:top|right|bottom|left|inline|block|inline-start|inline-end|start|end|block-start|block-end)';\nconst CORNER_VALUES = '(?:top-left|top-right|bottom-right|bottom-left|start-start|start-end|end-start|end-end)';\nconst INSET_VALUES = '(?:inline|block|inline-start|inline-end|block-start|block-end)';\n\n\n// Pre-compiled regex patterns for better performance\nconst BORDER_COLOR_REGEX = new RegExp(`^border(?:-${DIRECTION_VALUES})?-color$`);\nconst BORDER_WIDTH_REGEX = new RegExp(`^border(?:-${DIRECTION_VALUES})?-width$`);\nconst MARGIN_REGEX = new RegExp(`^margin(?:-${DIRECTION_VALUES})?$`);\nconst PADDING_REGEX = new RegExp(`^padding(?:-${DIRECTION_VALUES})?$`);\nconst BORDER_RADIUS_REGEX = new RegExp(`^border(?:-${CORNER_VALUES})?-radius$`);\nconst INSET_REGEX = new RegExp(`^inset(?:-${INSET_VALUES})?$`);\n\nexport function isBorderColorProperty(cssProperty: string): boolean {\n  return BORDER_COLOR_REGEX.test(cssProperty);\n}\n\nexport function isBorderWidthProperty(cssProperty: string): boolean {\n  return BORDER_WIDTH_REGEX.test(cssProperty);\n}\n\nexport function isMarginProperty(cssProperty: string): boolean {\n  return MARGIN_REGEX.test(cssProperty);\n}\n\nexport function isPaddingProperty(cssProperty: string): boolean {\n  return PADDING_REGEX.test(cssProperty);\n}\n\nexport function isBorderRadius(cssProperty: string): boolean {\n  return BORDER_RADIUS_REGEX.test(cssProperty);\n}\n\nexport function isDimensionProperty(cssProperty: string): boolean {\n  return ['width', 'height', 'min-width', 'max-width', 'min-height', 'max-height'].includes(cssProperty);\n}\n\nexport function isInsetProperty(cssProperty: string): boolean {\n  return INSET_REGEX.test(cssProperty);\n}\n\nexport const fontProperties = [\n  'font',\n  'font-size', \n  'font-weight'\n];\n\nexport const colorProperties = [\n  'color',\n  'fill',\n  'background',\n  'background-color',\n  'stroke',\n  'border',\n  'border*',\n  'border*-color',\n  'outline',\n  'outline-color',\n];\n\nexport const densificationProperties = [\n  'border*',\n  'margin*',\n  'padding*',\n  'width',\n  'height',\n  'min-width',\n  'max-width',\n  'min-height',\n  'max-height',\n  'inset',\n  'top',\n  'right',\n  'left',\n  'bottom',\n  'outline',\n  'outline-width',\n  'line-height'\n]; \n\n/**\n * Convert property patterns to CSS AST selector patterns\n * Handles wildcards (*) and creates proper ESLint CSS selector syntax\n */\nexport function toSelector(properties: string[]): string {\n  const selectorParts = properties.map(prop => {\n    if (prop.includes('*')) {\n      // Convert wildcards to regex patterns for CSS AST selectors\n      // Anchor to start of string to prevent matching CSS custom properties\n      const regexPattern = prop.replace(/\\*/g, '.*');\n      return `Declaration[property=/^${regexPattern}$/]`;\n    } else {\n      // Exact property match\n      return `Declaration[property='${prop}']`;\n    }\n  });\n  \n  return selectorParts.join(', ');\n}\n\nexport function resolvePropertyToMatch(cssProperty:string){\n  const propertyToMatch = cssProperty.toLowerCase();\n  if(propertyToMatch === 'outline' || propertyToMatch === 'outline-width' || isBorderWidthProperty(propertyToMatch)){\n    return 'border-width';\n  } else if(isMarginProperty(propertyToMatch)){\n    return 'margin';\n  } else if(isPaddingProperty(propertyToMatch)){\n    return 'padding';\n  } else if(isBorderRadius(propertyToMatch)){\n    return 'border-radius';\n  } else if(isDimensionProperty(propertyToMatch)){\n    // Stylinghooks includes only width as property to match, for all other dimensions we need to match width\n    return 'width';\n  } else if(isInsetProperty(propertyToMatch)){\n    // Stylinghooks includes only top/left/right/bottom as property to match, for all other insets we need to match top\n    return 'top';\n  } else if(cssProperty === 'background' || cssProperty === 'background-color'){\n    return 'background-color';\n  } else if(cssProperty === 'outline' || cssProperty === 'outline-color' || isBorderColorProperty(cssProperty)){\n    return 'border-color';\n  }\n  return propertyToMatch;\n}", "import { parse, walk } from '@eslint/css-tree';\nimport type { HandlerContext } from '../types';\nimport type { ParsedUnitValue } from './value-utils';\nimport { ALLOWED_UNITS } from './value-utils';\nimport { extractColorValue } from './color-lib-utils';\nimport { isCssFunction } from './css-functions';\n\n/**\n * Common replacement data structure used by both color and density handlers\n */\nexport interface ReplacementInfo {\n  start: number;\n  end: number;\n  replacement: string;        // Full CSS var: var(--hook, fallback)\n  displayValue: string;       // Just the hook: --hook\n  hasHook: boolean;\n}\n\n/**\n * Position information from CSS tree parsing\n */\nexport interface PositionInfo {\n  start?: { offset: number; line: number; column: number };\n  end?: { offset: number; line: number; column: number };\n}\n\n/**\n * Generic callback for processing values with position information\n */\nexport type ValueCallback<T> = (value: T, positionInfo?: PositionInfo) => void;\n\n/**\n * Known valid font-weight values\n */\nconst FONT_WEIGHTS = [\n  'normal',\n  'bold', \n  'bolder',\n  'lighter',\n  '100',\n  '200', \n  '300',\n  '400',\n  '500',\n  '600',\n  '700',\n  '800',\n  '900'\n];\n\n/**\n * Check if a value is a known font-weight\n */\nexport function isKnownFontWeight(value: string | number): boolean {\n  const stringValue = value.toString();\n  return FONT_WEIGHTS.includes(stringValue.toLowerCase());\n}\n\n/**\n * Generic shorthand auto-fix handler\n * Handles the common logic for reconstructing shorthand values with replacements\n */\nexport function handleShorthandAutoFix(\n  declarationNode: any,\n  context: HandlerContext,\n  valueText: string,\n  replacements: ReplacementInfo[]\n) {\n  // Sort replacements by position for proper reconstruction\n  const sortedReplacements = replacements.sort((a, b) => a.start - b.start);\n  \n  // Check if we can apply auto-fix (at least one value has a hook)\n  const hasAnyHooks = sortedReplacements.some(r => r.hasHook);\n  const canAutoFix = hasAnyHooks;\n\n  // Report each individual value\n  sortedReplacements.forEach(({ start, end, replacement, displayValue, hasHook }) => {\n    const originalValue = valueText.substring(start, end);\n    const valueStartColumn = declarationNode.value.loc.start.column;\n    const valueColumn = valueStartColumn + start;\n    \n    // Create precise error location for this value\n    const { loc: { start: locStart, end: locEnd } } = declarationNode.value;\n    const reportNode = {\n      ...declarationNode.value,\n      loc: {\n        ...declarationNode.value.loc,\n        start: {\n          ...locStart,\n          column: valueColumn\n        },\n        end: {\n          ...locEnd,\n          column: valueColumn + originalValue.length\n        }\n      }\n    };\n\n    if (hasHook) {\n      // Create auto-fix for the entire shorthand value\n      const fix = canAutoFix ? (fixer: any) => {\n        // Reconstruct the entire value with all replacements\n        let newValue = valueText;\n        \n        // Apply replacements from right to left to maintain string positions\n        for (let i = sortedReplacements.length - 1; i >= 0; i--) {\n          const { start: rStart, end: rEnd, replacement: rReplacement } = sortedReplacements[i];\n          newValue = newValue.substring(0, rStart) + rReplacement + newValue.substring(rEnd);\n        }\n        \n        return fixer.replaceText(declarationNode.value, newValue);\n      } : undefined;\n\n      context.context.report({\n        node: reportNode,\n        messageId: 'hardcodedValue',\n        data: {\n          oldValue: originalValue,\n          newValue: displayValue\n        },\n        fix\n      });\n    } else {\n      // No hook available\n      context.context.report({\n        node: reportNode,\n        messageId: 'noReplacement',\n        data: {\n          oldValue: originalValue\n        }\n      });\n    }\n  });\n}\n\n/**\n * Generic CSS tree traversal with position tracking\n * Always provides position information since both handlers need it\n */\nexport function forEachValue<T>(\n  valueText: string,\n  extractValue: (node: any) => T | null,\n  shouldSkipNode: (node: any) => boolean,\n  callback: (value: T, positionInfo: PositionInfo) => void\n): void {\n  if (!valueText || typeof valueText !== 'string') {\n    return;\n  }\n\n  try {\n    const ast = parse(valueText, { context: 'value' as const, positions: true });\n    \n    walk(ast, {\n      enter(node: any) {\n        // Skip nodes efficiently using this.skip\n        if (shouldSkipNode(node)) {\n          return this.skip;\n        }\n        \n        const value = extractValue(node);\n        if (value !== null) {\n          const positionInfo: PositionInfo = {\n            start: node.loc?.start,\n            end: node.loc?.end\n          };\n          callback(value, positionInfo);\n        }\n      }\n    });\n  } catch (error) {\n    // Silently handle parse errors\n    return;\n  }\n}\n\n/**\n * Check if color node should be skipped during traversal\n */\nfunction shouldSkipColorNode(node: any): boolean {\n  return node.type === 'Function' && isCssFunction(node.name);\n}\n\n/**\n * Check if dimension node should be skipped during traversal\n * Skip all function nodes by default\n */\nfunction shouldSkipDimensionNode(node: any): boolean {\n  return node.type === 'Function';\n}\n\n/**\n * Extract dimension value from CSS AST node\n * Returns structured data with number and unit to eliminate regex parsing\n */\nfunction extractDimensionValue(valueNode: any, cssProperty?: string): ParsedUnitValue | null {\n  if (!valueNode) return null;\n  \n  switch (valueNode.type) {\n    case 'Dimension':\n      // Dimensions: 16px, 1rem -> extract value and unit directly from AST\n      const numValue = Number(valueNode.value);\n      if (numValue === 0) return null; // Skip zero values\n      \n      const unit = valueNode.unit.toLowerCase();\n      if (!ALLOWED_UNITS.includes(unit)) return null; // Support only allowed units\n      \n      return {\n        number: numValue,\n        unit: unit as 'px' | 'rem' | '%' | 'em' | 'ch'\n      };\n      \n    case 'Number':\n      // Numbers: 400, 1.5 -> treat as unitless (font-weight, line-height, etc.)\n      const numberValue = Number(valueNode.value);\n      if (numberValue === 0) return null; // Skip zero values\n      \n      return {\n        number: numberValue,\n        unit: null\n      };\n      \n    case 'Percentage':\n      // Percentage values: 100%, 50% -> extract value and add % unit\n      const percentValue = Number(valueNode.value);\n      if (percentValue === 0) return null; // Skip zero values\n      \n      return {\n        number: percentValue,\n        unit: '%'\n      };\n      \n    case 'Value':\n      // Value wrapper - extract from first child\n      return valueNode.children?.[0] ? extractDimensionValue(valueNode.children[0], cssProperty) : null;\n  }\n  \n  return null;\n}\n\n/**\n * Specialized color value traversal\n * Handles color-specific extraction and skipping logic\n */\nexport function forEachColorValue(\n  valueText: string,\n  callback: (colorValue: string, positionInfo: PositionInfo) => void\n): void {\n  forEachValue(valueText, extractColorValue, shouldSkipColorNode, callback);\n}\n\n/**\n * Specialized density value traversal\n * Handles dimension-specific extraction and skipping logic\n */\nexport function forEachDensityValue(\n  valueText: string,\n  cssProperty: string,\n  callback: (parsedDimension: ParsedUnitValue, positionInfo: PositionInfo) => void\n): void {\n  forEachValue(\n    valueText, \n    (node) => extractDimensionValue(node, cssProperty), \n    shouldSkipDimensionNode, \n    callback\n  );\n}\n\n/**\n * Extract font-related values from CSS AST node\n * Handles font-size and font-weight values\n */\nfunction extractFontValue(node: any): ParsedUnitValue | null {\n  if (!node) return null;\n  \n  switch (node.type) {\n    case 'Dimension':\n      // Font-size: 16px, 1rem, etc.\n      const numValue = Number(node.value);\n      if (numValue <= 0) return null; // Skip zero/negative values\n      \n      const unit = node.unit.toLowerCase();\n      if (!ALLOWED_UNITS.includes(unit)) return null;\n      \n      return {\n        number: numValue,\n        unit: unit as 'px' | 'rem' | '%' | 'em' | 'ch'\n      };\n      \n    case 'Number':\n      // Font-weight: 400, 700, etc.\n      const numberValue = Number(node.value);\n      if (numberValue <= 0) {\n        return null; // Skip zero/negative values\n      }\n      \n      // Only accept known font-weight values for unitless numbers\n      if (!isKnownFontWeight(numberValue)) {\n        return null; // Skip values that aren't valid font-weights\n      }\n      \n      return {\n        number: numberValue,\n        unit: null\n      };\n      \n    case 'Identifier':\n      // Font-weight keywords: normal, bold, etc.\n      const namedValue = node.name.toLowerCase();\n      \n      // Only accept known font-weight keywords\n      if (!isKnownFontWeight(namedValue)) {\n        return null;\n      }\n      \n      // Convert known keywords to numeric values\n      if (namedValue === 'normal') {\n        return { number: 400, unit: null };\n      }\n      \n      // For other keywords (bolder, lighter), we can't determine exact numeric value\n      // but we know they're valid font-weight values\n      return { number: namedValue, unit: null };\n      \n    case 'Percentage':\n      // Percentage values for font-size\n      const percentValue = Number(node.value);\n      if (percentValue === 0) return null; // Skip zero values\n      \n      return {\n        number: percentValue,\n        unit: '%'\n      };\n      \n    case 'Value':\n      // Value wrapper - extract from first child\n      return node.children?.[0] ? extractFontValue(node.children[0]) : null;\n  }\n  \n  return null;\n}\n\n/**\n * Check if font node should be skipped during traversal\n * Skip all function nodes by default\n */\nfunction shouldSkipFontNode(node: any): boolean {\n  return node.type === 'Function';\n}\n\n/**\n * Specialized font value traversal\n * Handles font-specific extraction and skipping logic\n */\nexport function forEachFontValue(\n  valueText: string,\n  callback: (fontValue: ParsedUnitValue, positionInfo: PositionInfo) => void\n): void {\n  forEachValue(valueText, extractFontValue, shouldSkipFontNode, callback);\n}\n", "import { \n  forEachValue, \n  type PositionInfo \n} from './hardcoded-shared-utils';\n\n/**\n * Check if a CSS property should be targeted for linting based on prefixes or explicit targets\n * @param property - The CSS property name to check\n * @param propertyTargets - Array of specific properties to target (empty means target all)\n * @returns true if the property should be targeted\n */\nexport function isTargetProperty(property: string, propertyTargets: string[] = []): boolean {\n  if (typeof property !== 'string') return false;\n  return property.startsWith('--sds-')\n    || property.startsWith('--slds-')\n    || property.startsWith('--lwc-')\n    || propertyTargets.length === 0\n    || propertyTargets.includes(property);\n}\n\n/**\n * CSS Variable information for SLDS variable detection\n */\nexport interface CssVariableInfo {\n  name: string;           // Variable name: --slds-g-color-surface-1\n  hasFallback: boolean;   // Whether var() already has a fallback\n}\n\n/**\n * Generic CSS variable extractor that can be customized for different use cases\n * @param node - AST node to extract from\n * @param filter - Function to validate and extract variable information\n * @returns Extracted variable info or null\n */\nfunction extractCssVariable<T>(\n  node: any,\n  filter: (variableName: string, childrenArray: any[]) => T | null\n): T | null {\n  if (!node || node.type !== 'Function' || node.name !== 'var') {\n    return null;\n  }\n\n  if (!node.children) {\n    return null;\n  }\n\n  // Convert children to array and get the first child (variable name)\n  const childrenArray = Array.from(node.children);\n  if (childrenArray.length === 0) {\n    return null;\n  }\n  \n  const firstChild = childrenArray[0] as any;\n  if (!firstChild || firstChild.type !== 'Identifier') {\n    return null;\n  }\n\n  const variableName = firstChild.name;\n  if (!variableName) {\n    return null;\n  }\n\n  return filter(variableName, childrenArray);\n}\n\n/**\n * Specialized CSS variable traversal for SLDS variables\n * Finds var(--slds-*) functions and reports their fallback status\n */\nexport function forEachSldsVariable(\n  valueText: string,\n  callback: (variableInfo: CssVariableInfo, positionInfo: PositionInfo) => void\n): void {\n  const extractor = (node: any) => extractCssVariable(node, (variableName, childrenArray) => {\n    if (!variableName.startsWith('--slds-')) {\n      return null;\n    }\n\n    // Check if there's a fallback (comma separator)\n    const hasFallback = childrenArray.some((child: any) => \n      child.type === 'Operator' && child.value === ','\n    );\n\n    return { name: variableName, hasFallback };\n  });\n\n  forEachValue(valueText, extractor, () => false, callback);\n}\n\n/**\n * Specialized CSS variable traversal for SLDS/SDS namespace detection\n * Finds var(--slds-*) or var(--sds-*) functions in CSS values\n * Note: hasFallback is set to false as it's unused for namespace validation\n */\nexport function forEachNamespacedVariable(\n  valueText: string,\n  callback: (variableInfo: CssVariableInfo, positionInfo: PositionInfo) => void\n): void {\n  const extractor = (node: any) => extractCssVariable(node, (variableName) => {\n    // Check for SLDS or SDS namespace\n    if (variableName.startsWith('--slds-') || variableName.startsWith('--sds-')) {\n      return { name: variableName, hasFallback: false }; // hasFallback unused, but required by interface\n    }\n    return null;\n  });\n\n  forEachValue(valueText, extractor, () => false, callback);\n}\n\n/**\n * Specialized CSS variable traversal for LWC variables\n * Finds var(--lwc-*) functions in CSS values and reports their fallback status\n */\nexport function forEachLwcVariable(\n  valueText: string,\n  callback: (variableInfo: CssVariableInfo, positionInfo: PositionInfo) => void\n): void {\n  const extractor = (node: any) => extractCssVariable(node, (variableName, childrenArray) => {\n    if (!variableName.startsWith('--lwc-')) {\n      return null;\n    }\n\n    // Check if there's a fallback (comma separator)\n    const hasFallback = childrenArray.some((child: any) => \n      child.type === 'Operator' && child.value === ','\n    );\n\n    return { name: variableName, hasFallback };\n  });\n\n  forEachValue(valueText, extractor, () => false, callback);\n}\n\n/**\n * Format multiple hook suggestions for better readability\n * @param hooks - Array of hook names to format\n * @returns Formatted string with hooks\n */\nexport function formatSuggestionHooks(hooks: string[]): string {\n  if (hooks.length === 1) {\n    return `${hooks[0]}`;\n  }\n\n  // Loop through hooks and append each as a numbered list item with line breaks\n  return '\\n' + hooks.map((hook, index) => `${index + 1}. ${hook}`).join('\\n');\n}"],
-  "mappings": "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",
+  "sources": ["../../../../../src/rules/v9/no-hardcoded-values/handlers/colorHandler.ts", "../../../../../src/utils/color-lib-utils.ts", "../../../../../src/utils/css-functions.ts", "../../../../../src/utils/property-matcher.ts", "../../../../../src/utils/hardcoded-shared-utils.ts", "../../../../../src/utils/css-utils.ts", "../../../../../src/utils/custom-mapping-utils.ts"],
+  "sourcesContent": ["import { findClosestColorHook, convertToHex, isValidColor } from '../../../../utils/color-lib-utils';\nimport { resolveColorPropertyToMatch } from '../../../../utils/property-matcher';\nimport { formatSuggestionHooks } from '../../../../utils/css-utils';\nimport { getCustomMapping } from '../../../../utils/custom-mapping-utils';\nimport type { HandlerContext, DeclarationHandler } from '../../../../types';\n\n// Import shared utilities for common logic\nimport { \n  handleShorthandAutoFix, \n  forEachColorValue,\n  type ReplacementInfo,\n  type PositionInfo\n} from '../../../../utils/hardcoded-shared-utils';\n\n\n/**\n * Handle color declarations using CSS tree parsing\n * Supports shorthand properties like background, border, etc.  \n * Uses css-tree for reliable AST-based parsing + chroma-js validation\n */\nexport const handleColorDeclaration: DeclarationHandler = (node: any, context: HandlerContext) => {\n  const cssProperty = node.property.toLowerCase();\n  const valueText = context.sourceCode.getText(node.value);\n  const replacements: ReplacementInfo[] = [];\n  \n  forEachColorValue(valueText, (colorValue, positionInfo) => {\n    if (colorValue !== 'transparent' && isValidColor(colorValue)) {\n      const replacement = createColorReplacement(colorValue, cssProperty, context, positionInfo, valueText);\n      if (replacement) {\n        replacements.push(replacement);\n      }\n    }\n  });\n  \n  // Apply shorthand auto-fix once all values are processed\n  handleShorthandAutoFix(node, context, valueText, replacements);\n};\n\n\n/**\n * Create color replacement info for shorthand auto-fix\n * Returns replacement data or null if no valid replacement\n */\nfunction createColorReplacement(\n  colorValue: string,\n  cssProperty: string,\n  context: HandlerContext,\n  positionInfo: PositionInfo,\n  originalValueText?: string\n): ReplacementInfo | null {\n  if (!positionInfo?.start) {\n    return null;\n  }\n\n  const hexValue = convertToHex(colorValue);\n  if (!hexValue) {\n    return null;\n  }\n\n  // Use position information directly from CSS tree (already 0-based offsets)\n  const start = positionInfo.start.offset;\n  const end = positionInfo.end.offset;\n  \n  // Extract the original value from the CSS text to preserve spacing\n  const originalValue = originalValueText ? originalValueText.substring(start, end) : colorValue;\n\n  // Check custom mapping first\n  const customHook = getCustomMapping(cssProperty, colorValue, context.options?.customMapping);\n  let closestHooks: string[] = [];\n  \n  if (customHook) {\n    // Use custom mapping if available\n    closestHooks = [customHook];\n  } else {\n    // Otherwise, find closest hooks from metadata\n    const propToMatch = resolveColorPropertyToMatch(cssProperty);\n    closestHooks = findClosestColorHook(hexValue, context.valueToStylinghook, propToMatch);\n  }\n\n  let replacement = originalValue;\n  let paletteHook = null;\n  // Apply preferPaletteHook filter if enabled\n  if (context.options?.preferPaletteHook && closestHooks.length > 1) {\n    paletteHook = closestHooks.filter(hook => hook.includes('-palette-'))[0];\n  }\n  if(paletteHook){\n    replacement = `var(${paletteHook}, ${colorValue})`;\n  } else if(closestHooks.length === 1){\n    replacement = `var(${closestHooks[0]}, ${colorValue})`;\n  }\n\n  if (closestHooks.length > 0) {\n    // Multiple hooks - format them for better readability\n    return {\n      start,\n      end,\n      replacement,  // Use original value to preserve spacing\n      displayValue: formatSuggestionHooks(closestHooks),\n      hasHook: true      \n    };\n  } else {\n    // No hooks - keep original value\n    return {\n      start,\n      end,\n      replacement,  // Use original value to preserve spacing\n      displayValue: originalValue,\n      hasHook: false\n    };\n  }\n}\n\n\n\n\n\n", "import { ValueToStylingHooksMapping, ValueToStylingHookEntry } from '@salesforce-ux/sds-metadata/next';\nimport chroma from 'chroma-js';\nimport { generate } from '@eslint/css-tree';\nimport { isCssColorFunction } from './css-functions';\n\n/**\n * Perceptual color difference threshold (Delta E, CIEDE2000 via chroma.deltaE).\n * Lower values are stricter matches. Used to decide which hooks are \"close enough\".\n */\nconst DELTAE_THRESHOLD = 10;\n\n/**\n * Convert any valid CSS color (named, hex, rgb(a), hsl(a), etc.) to hex.\n * Returns null if the value is not a valid color.\n */\nconst convertToHex = (color: string): string | null => {\n  try {\n    // Try converting the color using chroma-js, which handles both named and hex colors\n    return chroma(color).hex();\n  } catch (e) {\n    // If chroma can't process the color, it's likely invalid\n    return null;\n  }\n};\n\nconst isHookPropertyMatch = (hook: ValueToStylingHookEntry, cssProperty: string): boolean => {\n  return hook.properties.includes(cssProperty) || hook.properties.includes(\"*\");\n}\n\nfunction getOrderByCssProp(cssProperty: string): string[] {\n  if(cssProperty === 'color' || cssProperty === 'fill') {\n      return [\"surface\", \"theme\",  \"feedback\", \"reference\"];\n  } else if(cssProperty.match(/background/)){\n     return [\"surface\", \"surface-inverse\", \"theme\",  \"feedback\", \"reference\"];\n  } else if(cssProperty.match(/border/) || cssProperty.match(/outline/) || cssProperty.match(/stroke/)) {\n      return [\"borders\", \"borders-inverse\", \"feedback\", \"theme\", \"reference\"];\n  }\n  return [\"surface\", \"surface-inverse\", \"borders\", \"borders-inverse\", \"theme\",  \"feedback\", \"reference\"];\n}\n\n\n/**\n * Given an input color and the metadata mapping of supported colors to hooks,\n * suggest up to 5 styling hook names ordered by:\n * 1) Category priority: semantic -> system -> palette\n * 2) Perceptual distance (Delta E)\n * Also prioritizes exact color matches (distance 0).\n */\nconst findClosestColorHook = (\n  color: string,\n  supportedColors:ValueToStylingHooksMapping,\n  cssProperty: string\n): string[] => {\n  const closestHooks: Array<{distance: number, group: string, name: string}> = [];\n  Object.entries(supportedColors).forEach(([sldsValue, data]) => {\n    if (sldsValue && isValidColor(sldsValue)) {\n      const hooks = data as ValueToStylingHookEntry[]; // Get the hooks for the sldsValue\n\n      hooks.forEach((hook) => {\n        // Exact match shortcut to avoid floating rounding noise\n        const distance = (sldsValue.toLowerCase() === color.toLowerCase())\n          ? 0\n          : chroma.deltaE(sldsValue, color);\n          \n        // Check if the hook has the same property or universal selector\n        if (isHookPropertyMatch(hook, cssProperty) && distance <= DELTAE_THRESHOLD) {\n          // Add to same property hooks if within threshold\n          closestHooks.push({ distance, group: hook.group, name: hook.name });\n        }\n      });\n    }\n  });\n\n  const hooksByGroupMap:Record<string, string[]> = closestHooks.sort((a, b) => a.distance - b.distance).reduce((acc, hook) => {\n    if (!acc[hook.group]) {\n      acc[hook.group] = [];\n    }\n    acc[hook.group].push(hook.name);\n    return acc;\n  }, {});\n\n  return getOrderByCssProp(cssProperty)\n    .map(group => hooksByGroupMap[group]||[])\n    .flat().slice(0, 5);\n};\n\n/**\n * Check if a value is any valid CSS color string (delegates to chroma-js).\n */\nconst isValidColor = (val:string):boolean => chroma.valid(val);\n\n/**\n * Extract a color string from a CSS AST node produced by @eslint/css-tree.\n * Supports Hash (#rrggbb), Identifier (named colors), and color Function nodes.\n * Returns null if the extracted value is not a valid color.\n */\nconst extractColorValue = (node: any): string | null => {\n  let colorValue: string | null = null;\n  \n  switch (node.type) {\n    case 'Hash':\n      colorValue = `#${node.value}`;\n      break;\n    case 'Identifier':\n      colorValue = node.name;\n      break;\n    case 'Function':\n      // Only extract color functions\n      if (isCssColorFunction(node.name)) {\n        colorValue = generate(node);\n      }\n      break;\n  }\n  \n  return colorValue && isValidColor(colorValue) ? colorValue : null;\n};\n\nexport { findClosestColorHook, convertToHex, isValidColor, extractColorValue };\n", "//stylelint-sds/packages/stylelint-plugin-slds/src/utils/css-functions.ts\n/**\n * Complete list of CSS functions that should be preserved/recognized\n */\nconst CSS_FUNCTIONS = [\n    'attr',\n    'calc',\n    'color-mix',\n    'conic-gradient',\n    'counter',\n    'cubic-bezier',\n    'linear-gradient',\n    'max',\n    'min',\n    'radial-gradient',\n    'repeating-conic-gradient',\n    'repeating-linear-gradient',\n    'repeating-radial-gradient',\n    'var'\n  ];\n  \n  \n  const CSS_MATH_FUNCTIONS = ['calc', 'min', 'max'];\n  \n  \n  const RGB_COLOR_FUNCTIONS = ['rgb', 'rgba', 'hsl', 'hsla'];\n  \n  /**\n   * Regex for matching any CSS function (for general detection)\n   * Matches function names within other text\n   */\n  const cssFunctionsRegex = new RegExp(`(?:${CSS_FUNCTIONS.join('|')})`);\n  \n  \n  const cssFunctionsExactRegex = new RegExp(`^(?:${CSS_FUNCTIONS.join('|')})$`);\n  \n  \n  const cssMathFunctionsRegex = new RegExp(`^(?:${CSS_MATH_FUNCTIONS.join('|')})$`);\n  \n  export function containsCssFunction(value: string): boolean {\n    return cssFunctionsRegex.test(value);\n  }\n  \n  /**\n   * Check if a value is exactly a CSS function name\n   */\n  export function isCssFunction(value: string): boolean {\n    return cssFunctionsExactRegex.test(value);\n  }\n  \n  export function isCssMathFunction(value: string): boolean {\n    return cssMathFunctionsRegex.test(value);\n  }\n  \n  export function isCssColorFunction(value: string): boolean {\n    return RGB_COLOR_FUNCTIONS.includes(value);\n  }", "///stylelint-sds/packages/stylelint-plugin-slds/src/utils/property-matcher.ts\n/**\n * Check if any of the hook properties match the provided cssProperty using wildcard matching.\n * @param hookProperties - Array of property patterns (can contain wildcards like `*`)\n * @param cssProperty - The CSS property to be checked\n * @returns true if a match is found, otherwise false\n */\nexport function matchesCssProperty(\n  hookProperties: string[],\n  cssProperty: string\n): boolean {\n  return hookProperties.some((propertyPattern: string) => {\n    const regexPattern = new RegExp(\n      '^' + propertyPattern.replace(/\\*/g, '.*') + '$'\n    );\n    return regexPattern.test(cssProperty);\n  });\n}\n\n// Directions & Corners\nconst DIRECTION_VALUES = '(?:top|right|bottom|left|inline|block|inline-start|inline-end|start|end|block-start|block-end)';\nconst CORNER_VALUES = '(?:top-left|top-right|bottom-right|bottom-left|start-start|start-end|end-start|end-end)';\nconst INSET_VALUES = '(?:inline|block|inline-start|inline-end|block-start|block-end)';\n\n\n// Pre-compiled regex patterns for better performance\nconst BORDER_COLOR_REGEX = new RegExp(`^border(?:-${DIRECTION_VALUES})?-color$`);\nconst BORDER_WIDTH_REGEX = new RegExp(`^border(?:-${DIRECTION_VALUES})?-width$`);\nconst MARGIN_REGEX = new RegExp(`^margin(?:-${DIRECTION_VALUES})?$`);\nconst PADDING_REGEX = new RegExp(`^padding(?:-${DIRECTION_VALUES})?$`);\nconst BORDER_RADIUS_REGEX = new RegExp(`^border(?:-${CORNER_VALUES})?-radius$`);\nconst INSET_REGEX = new RegExp(`^inset(?:-${INSET_VALUES})?$`);\n\nexport function isBorderColorProperty(cssProperty: string): boolean {\n  return BORDER_COLOR_REGEX.test(cssProperty);\n}\n\nexport function isBorderWidthProperty(cssProperty: string): boolean {\n  return BORDER_WIDTH_REGEX.test(cssProperty);\n}\n\nexport function isMarginProperty(cssProperty: string): boolean {\n  return MARGIN_REGEX.test(cssProperty);\n}\n\nexport function isPaddingProperty(cssProperty: string): boolean {\n  return PADDING_REGEX.test(cssProperty);\n}\n\nexport function isBorderRadius(cssProperty: string): boolean {\n  return BORDER_RADIUS_REGEX.test(cssProperty);\n}\n\nexport function isDimensionProperty(cssProperty: string): boolean {\n  return ['width', 'height', 'min-width', 'max-width', 'min-height', 'max-height'].includes(cssProperty);\n}\n\nexport function isInsetProperty(cssProperty: string): boolean {\n  return INSET_REGEX.test(cssProperty);\n}\n\nexport const fontProperties = [\n  'font',\n  'font-size', \n  'font-weight'\n];\n\nexport const colorProperties = [\n  'color',\n  'fill',\n  'background',\n  'background-color',\n  'stroke',\n  'border',\n  'border*',\n  'border*-color',\n  'outline',\n  'outline-color',\n];\n\nexport const densificationProperties = [\n  'border*',\n  'margin*',\n  'padding*',\n  'width',\n  'height',\n  'min-width',\n  'max-width',\n  'min-height',\n  'max-height',\n  'inset',\n  'top',\n  'right',\n  'left',\n  'bottom',\n  'outline',\n  'outline-width',\n  'line-height'\n]; \n\n/**\n * Convert property patterns to CSS AST selector patterns\n * Handles wildcards (*) and creates proper ESLint CSS selector syntax\n */\nexport function toSelector(properties: string[]): string {\n  const selectorParts = properties.map(prop => {\n    if (prop.includes('*')) {\n      // Convert wildcards to regex patterns for CSS AST selectors\n      // Anchor to start of string to prevent matching CSS custom properties\n      const regexPattern = prop.replace(/\\*/g, '.*');\n      return `Declaration[property=/^${regexPattern}$/]`;\n    } else {\n      // Exact property match\n      return `Declaration[property='${prop}']`;\n    }\n  });\n  \n  return selectorParts.join(', ');\n}\n\nexport function resolveDensityPropertyToMatch(cssProperty:string){\n  const propertyToMatch = cssProperty.toLowerCase();\n  if(isOutlineWidthProperty(propertyToMatch) || isBorderWidthProperty(propertyToMatch)){\n    return 'border-width';\n  } else if(isMarginProperty(propertyToMatch)){\n    return 'margin';\n  } else if(isPaddingProperty(propertyToMatch)){\n    return 'padding';\n  } else if(isBorderRadius(propertyToMatch)){\n    return 'border-radius';\n  } else if(isDimensionProperty(propertyToMatch)){\n    // Stylinghooks includes only width as property to match, for all other dimensions we need to match width\n    return 'width';\n  } else if(isInsetProperty(propertyToMatch)){\n    // Stylinghooks includes only top/left/right/bottom as property to match, for all other insets we need to match top\n    return 'top';\n  }\n  return propertyToMatch;\n}\n\nexport function resolveColorPropertyToMatch(cssProperty:string){\n  const propertyToMatch = cssProperty.toLowerCase();\n  if(propertyToMatch === 'outline' || propertyToMatch === 'outline-color'){\n    return 'border-color';\n  } else if(propertyToMatch === 'background' || propertyToMatch === 'background-color'){\n    return 'background-color';\n  } else if(isBorderColorProperty(propertyToMatch)){\n    return 'border-color';\n  }\n  return propertyToMatch;\n}\n\nexport function isOutlineWidthProperty(propertyToMatch:string){\n  return propertyToMatch === 'outline' || propertyToMatch === 'outline-width';\n}", "import { parse, walk } from '@eslint/css-tree';\nimport type { HandlerContext } from '../types';\nimport type { ParsedUnitValue } from './value-utils';\nimport { ALLOWED_UNITS } from './value-utils';\nimport { extractColorValue } from './color-lib-utils';\nimport { isCssFunction } from './css-functions';\n\n/**\n * Common replacement data structure used by both color and density handlers\n */\nexport interface ReplacementInfo {\n  start: number;\n  end: number;\n  replacement: string;        // Full CSS var: var(--hook, fallback)\n  displayValue: string;       // Just the hook: --hook\n  hasHook: boolean;\n  isNumeric?: boolean;        // Whether this is a numeric (dimension) value\n}\n\n/**\n * Position information from CSS tree parsing\n */\nexport interface PositionInfo {\n  start?: { offset: number; line: number; column: number };\n  end?: { offset: number; line: number; column: number };\n}\n\n/**\n * Generic callback for processing values with position information\n */\nexport type ValueCallback<T> = (value: T, positionInfo?: PositionInfo) => void;\n\n/**\n * Known valid font-weight values\n */\nconst FONT_WEIGHTS = [\n  'normal',\n  'bold', \n  'bolder',\n  'lighter',\n  '100',\n  '200', \n  '300',\n  '400',\n  '500',\n  '600',\n  '700',\n  '800',\n  '900'\n];\n\n/**\n * Check if a value is a known font-weight\n */\nexport function isKnownFontWeight(value: string | number): boolean {\n  const stringValue = value.toString();\n  return FONT_WEIGHTS.includes(stringValue.toLowerCase());\n}\n\n/**\n * Generic shorthand auto-fix handler\n * Handles the common logic for reconstructing shorthand values with replacements\n */\nexport function handleShorthandAutoFix(\n  declarationNode: any,\n  context: HandlerContext,\n  valueText: string,\n  replacements: ReplacementInfo[]\n) {\n  if(!replacements || replacements.length === 0){\n    return;\n  }\n  // Sort replacements by position for proper reconstruction\n  const sortedReplacements = replacements.sort((a,b)=> b.start-a.start);\n\n  // Get rule options\n  const reportNumericValue = context.options?.reportNumericValue || 'always';\n\n  const fixCallback = (start:number, originalValue:string, replacement:string) => {\n      // Reconstruct the entire value with all replacements\n      let newValue = valueText;\n\n      newValue = newValue.substring(0, start) + replacement + newValue.substring(start+originalValue.length);\n\n      if(newValue !== valueText){\n        return (fixer:any)=>{\n          return fixer.replaceText(declarationNode.value, newValue);\n        }\n      }\n    }\n\n  // Report each individual value\n  sortedReplacements.forEach(({ start, end, replacement, displayValue, hasHook, isNumeric }) => {\n    const originalValue = valueText.substring(start, end);\n    \n    // Check if we should skip reporting based on reportNumericValue option\n    if (isNumeric) {\n      if (reportNumericValue === 'never') {\n        return; // Skip reporting numeric values\n      }\n      if (reportNumericValue === 'hasReplacement' && !hasHook) {\n        return; // Skip reporting numeric values without replacements\n      }\n    }\n    \n    \n    const valueColumnStart = declarationNode.value.loc.start.column + start;\n    const valueColumnEnd = valueColumnStart + originalValue.length;\n    const canAutoFix = originalValue !== replacement;\n    \n    // Create precise error location for this value\n    const { loc: { start: locStart, end: locEnd } } = declarationNode.value;\n    const reportNode = {\n      ...declarationNode.value,\n      loc: {\n        ...declarationNode.value.loc,\n        start: {\n          ...locStart,\n          column: valueColumnStart\n        },\n        end: {\n          ...locEnd,\n          column: valueColumnEnd\n        }\n      }\n    };\n\n    if (hasHook) {\n      // Create auto-fix for the entire shorthand value\n      const fix = canAutoFix ? fixCallback(start, originalValue, replacement) : undefined;\n\n      context.context.report({\n        node: reportNode,\n        messageId: 'hardcodedValue',\n        data: {\n          oldValue: originalValue,\n          newValue: displayValue\n        },\n        fix\n      });\n    } else {\n      // No hook available\n      context.context.report({\n        node: reportNode,\n        messageId: 'noReplacement',\n        data: {\n          oldValue: originalValue\n        }\n      });\n    }\n  });\n}\n\n/**\n * Generic CSS tree traversal with position tracking\n * Always provides position information since both handlers need it\n */\nexport function forEachValue<T>(\n  valueText: string,\n  extractValue: (node: any) => T | null,\n  shouldSkipNode: (node: any) => boolean,\n  callback: (value: T, positionInfo: PositionInfo) => void\n): void {\n  if (!valueText || typeof valueText !== 'string') {\n    return;\n  }\n\n  try {\n    const ast = parse(valueText, { context: 'value' as const, positions: true });\n    \n    walk(ast, {\n      enter(node: any) {\n        // Skip nodes efficiently using this.skip\n        if (shouldSkipNode(node)) {\n          return this.skip;\n        }\n        \n        const value = extractValue(node);\n        if (value !== null) {\n          const positionInfo: PositionInfo = {\n            start: node.loc?.start,\n            end: node.loc?.end\n          };\n          callback(value, positionInfo);\n        }\n      }\n    });\n  } catch (error) {\n    // Silently handle parse errors\n    return;\n  }\n}\n\n/**\n * Check if color node should be skipped during traversal\n */\nfunction shouldSkipColorNode(node: any): boolean {\n  return node.type === 'Function' && isCssFunction(node.name);\n}\n\n/**\n * Check if dimension node should be skipped during traversal\n * Skip all function nodes by default\n */\nfunction shouldSkipDimensionNode(node: any): boolean {\n  return node.type === 'Function';\n}\n\n/**\n * Extract dimension value from CSS AST node\n * Returns structured data with number and unit to eliminate regex parsing\n */\nfunction extractDimensionValue(valueNode: any, cssProperty?: string): ParsedUnitValue | null {\n  if (!valueNode) return null;\n  \n  switch (valueNode.type) {\n    case 'Dimension':\n      // Dimensions: 16px, 1rem -> extract value and unit directly from AST\n      const numValue = Number(valueNode.value);\n      if (numValue === 0) return null; // Skip zero values\n      \n      const unit = valueNode.unit.toLowerCase();\n      if (!ALLOWED_UNITS.includes(unit)) return null; // Support only allowed units\n      \n      return {\n        number: numValue,\n        unit: unit as 'px' | 'rem' | '%' | 'em' | 'ch'\n      };\n      \n    case 'Number':\n      // Numbers: 400, 1.5 -> treat as unitless (font-weight, line-height, etc.)\n      const numberValue = Number(valueNode.value);\n      if (numberValue === 0) return null; // Skip zero values\n      \n      return {\n        number: numberValue,\n        unit: null\n      };\n      \n    case 'Percentage':\n      // Percentage values: 100%, 50% -> extract value and add % unit\n      const percentValue = Number(valueNode.value);\n      if (percentValue === 0) return null; // Skip zero values\n      \n      return {\n        number: percentValue,\n        unit: '%'\n      };\n      \n    case 'Value':\n      // Value wrapper - extract from first child\n      return valueNode.children?.[0] ? extractDimensionValue(valueNode.children[0], cssProperty) : null;\n  }\n  \n  return null;\n}\n\n/**\n * Specialized color value traversal\n * Handles color-specific extraction and skipping logic\n */\nexport function forEachColorValue(\n  valueText: string,\n  callback: (colorValue: string, positionInfo: PositionInfo) => void\n): void {\n  forEachValue(valueText, extractColorValue, shouldSkipColorNode, callback);\n}\n\n/**\n * Specialized density value traversal\n * Handles dimension-specific extraction and skipping logic\n */\nexport function forEachDensityValue(\n  valueText: string,\n  cssProperty: string,\n  callback: (parsedDimension: ParsedUnitValue, positionInfo: PositionInfo) => void\n): void {\n  forEachValue(\n    valueText, \n    (node) => extractDimensionValue(node, cssProperty), \n    shouldSkipDimensionNode, \n    callback\n  );\n}\n\n/**\n * Extract font-related values from CSS AST node\n * Handles font-size and font-weight values\n */\nfunction extractFontValue(node: any): ParsedUnitValue | null {\n  if (!node) return null;\n  \n  switch (node.type) {\n    case 'Dimension':\n      // Font-size: 16px, 1rem, etc.\n      const numValue = Number(node.value);\n      if (numValue <= 0) return null; // Skip zero/negative values\n      \n      const unit = node.unit.toLowerCase();\n      if (!ALLOWED_UNITS.includes(unit)) return null;\n      \n      return {\n        number: numValue,\n        unit: unit as 'px' | 'rem' | '%' | 'em' | 'ch'\n      };\n      \n    case 'Number':\n      // Font-weight: 400, 700, etc.\n      const numberValue = Number(node.value);\n      if (numberValue <= 0) {\n        return null; // Skip zero/negative values\n      }\n      \n      // Only accept known font-weight values for unitless numbers\n      if (!isKnownFontWeight(numberValue)) {\n        return null; // Skip values that aren't valid font-weights\n      }\n      \n      return {\n        number: numberValue,\n        unit: null\n      };\n      \n    case 'Identifier':\n      // Font-weight keywords: normal, bold, etc.\n      const namedValue = node.name.toLowerCase();\n      \n      // Only accept known font-weight keywords\n      if (!isKnownFontWeight(namedValue)) {\n        return null;\n      }\n      \n      // Convert known keywords to numeric values\n      if (namedValue === 'normal') {\n        return { number: 400, unit: null };\n      }\n      \n      // For other keywords (bolder, lighter), we can't determine exact numeric value\n      // but we know they're valid font-weight values\n      return { number: namedValue, unit: null };\n      \n    case 'Percentage':\n      // Percentage values for font-size\n      const percentValue = Number(node.value);\n      if (percentValue === 0) return null; // Skip zero values\n      \n      return {\n        number: percentValue,\n        unit: '%'\n      };\n      \n    case 'Value':\n      // Value wrapper - extract from first child\n      return node.children?.[0] ? extractFontValue(node.children[0]) : null;\n  }\n  \n  return null;\n}\n\n/**\n * Check if font node should be skipped during traversal\n * Skip all function nodes by default\n */\nfunction shouldSkipFontNode(node: any): boolean {\n  return node.type === 'Function';\n}\n\n/**\n * Specialized font value traversal\n * Handles font-specific extraction and skipping logic\n */\nexport function forEachFontValue(\n  valueText: string,\n  callback: (fontValue: ParsedUnitValue, positionInfo: PositionInfo) => void\n): void {\n  forEachValue(valueText, extractFontValue, shouldSkipFontNode, callback);\n}\n", "import { \n  forEachValue, \n  type PositionInfo \n} from './hardcoded-shared-utils';\n\n/**\n * Check if a CSS property should be targeted for linting based on prefixes or explicit targets\n * @param property - The CSS property name to check\n * @param propertyTargets - Array of specific properties to target (empty means target all)\n * @returns true if the property should be targeted\n */\nexport function isTargetProperty(property: string, propertyTargets: string[] = []): boolean {\n  if (typeof property !== 'string') return false;\n  return property.startsWith('--sds-')\n    || property.startsWith('--slds-')\n    || property.startsWith('--lwc-')\n    || propertyTargets.length === 0\n    || propertyTargets.includes(property);\n}\n\n/**\n * CSS Variable information for SLDS variable detection\n */\nexport interface CssVariableInfo {\n  name: string;           // Variable name: --slds-g-color-surface-1\n  hasFallback: boolean;   // Whether var() already has a fallback\n}\n\n/**\n * Generic CSS variable extractor that can be customized for different use cases\n * @param node - AST node to extract from\n * @param filter - Function to validate and extract variable information\n * @returns Extracted variable info or null\n */\nfunction extractCssVariable<T>(\n  node: any,\n  filter: (variableName: string, childrenArray: any[]) => T | null\n): T | null {\n  if (!node || node.type !== 'Function' || node.name !== 'var') {\n    return null;\n  }\n\n  if (!node.children) {\n    return null;\n  }\n\n  // Convert children to array and get the first child (variable name)\n  const childrenArray = Array.from(node.children);\n  if (childrenArray.length === 0) {\n    return null;\n  }\n  \n  const firstChild = childrenArray[0] as any;\n  if (!firstChild || firstChild.type !== 'Identifier') {\n    return null;\n  }\n\n  const variableName = firstChild.name;\n  if (!variableName) {\n    return null;\n  }\n\n  return filter(variableName, childrenArray);\n}\n\n/**\n * Specialized CSS variable traversal for SLDS variables\n * Finds var(--slds-*) functions and reports their fallback status\n */\nexport function forEachSldsVariable(\n  valueText: string,\n  callback: (variableInfo: CssVariableInfo, positionInfo: PositionInfo) => void\n): void {\n  const extractor = (node: any) => extractCssVariable(node, (variableName, childrenArray) => {\n    if (!variableName.startsWith('--slds-')) {\n      return null;\n    }\n\n    // Check if there's a fallback (comma separator)\n    const hasFallback = childrenArray.some((child: any) => \n      child.type === 'Operator' && child.value === ','\n    );\n\n    return { name: variableName, hasFallback };\n  });\n\n  forEachValue(valueText, extractor, () => false, callback);\n}\n\n/**\n * Specialized CSS variable traversal for SLDS/SDS namespace detection\n * Finds var(--slds-*) or var(--sds-*) functions in CSS values\n * Note: hasFallback is set to false as it's unused for namespace validation\n */\nexport function forEachNamespacedVariable(\n  valueText: string,\n  callback: (variableInfo: CssVariableInfo, positionInfo: PositionInfo) => void\n): void {\n  const extractor = (node: any) => extractCssVariable(node, (variableName) => {\n    // Check for SLDS or SDS namespace\n    if (variableName.startsWith('--slds-') || variableName.startsWith('--sds-')) {\n      return { name: variableName, hasFallback: false }; // hasFallback unused, but required by interface\n    }\n    return null;\n  });\n\n  forEachValue(valueText, extractor, () => false, callback);\n}\n\n/**\n * Specialized CSS variable traversal for LWC variables\n * Finds var(--lwc-*) functions in CSS values and reports their fallback status\n */\nexport function forEachLwcVariable(\n  valueText: string,\n  callback: (variableInfo: CssVariableInfo, positionInfo: PositionInfo) => void\n): void {\n  const extractor = (node: any) => extractCssVariable(node, (variableName, childrenArray) => {\n    if (!variableName.startsWith('--lwc-')) {\n      return null;\n    }\n\n    // Check if there's a fallback (comma separator)\n    const hasFallback = childrenArray.some((child: any) => \n      child.type === 'Operator' && child.value === ','\n    );\n\n    return { name: variableName, hasFallback };\n  });\n\n  forEachValue(valueText, extractor, () => false, callback);\n}\n\n/**\n * Format multiple hook suggestions for better readability\n * @param hooks - Array of hook names to format\n * @returns Formatted string with hooks\n */\nexport function formatSuggestionHooks(hooks: string[]): string {\n  if (hooks.length === 1) {\n    return `${hooks[0]}`;\n  }\n\n  // Loop through hooks and append each as a numbered list item with line breaks\n  return '\\n' + hooks.map((hook, index) => `${index + 1}. ${hook}`).join('\\n');\n}", "import type { CustomHookMapping } from '../types';\n\n/**\n * Check if a CSS property matches a pattern (supports wildcards)\n * @param cssProperty - The CSS property to check (e.g., \"background-color\")\n * @param pattern - The pattern to match against (e.g., \"background*\" or \"color\")\n * @returns true if the property matches the pattern\n */\nfunction matchesPropertyPattern(cssProperty: string, pattern: string): boolean {\n  const normalizedProperty = cssProperty.toLowerCase();\n  const normalizedPattern = pattern.toLowerCase();\n\n  // Exact match\n  if (normalizedProperty === normalizedPattern) {\n    return true;\n  }\n\n  // Wildcard match (e.g., \"background*\" matches \"background-color\", \"background-image\")\n  if (normalizedPattern.endsWith('*')) {\n    const prefix = normalizedPattern.slice(0, -1);\n    return normalizedProperty.startsWith(prefix);\n  }\n\n  return false;\n}\n\n/**\n * Get custom hook mapping for a given CSS property and value\n * @param cssProperty - The CSS property (e.g., \"background-color\", \"color\")\n * @param value - The hardcoded value (e.g., \"#fff\", \"16px\")\n * @param customMapping - The custom mapping configuration from rule options\n * @returns The hook name if a mapping is found, null otherwise\n */\nexport function getCustomMapping(\n  cssProperty: string,\n  value: string,\n  customMapping?: CustomHookMapping\n): string | null {\n  if (!customMapping) {\n    return null;\n  }\n\n  const normalizedValue = value.toLowerCase().trim();\n\n  // Iterate through all hook mappings\n  for (const [hookName, config] of Object.entries(customMapping)) {\n    // Check if any property pattern matches\n    const propertyMatches = config.properties.some((pattern) =>\n      matchesPropertyPattern(cssProperty, pattern)\n    );\n\n    if (!propertyMatches) {\n      continue;\n    }\n\n    // Check if the value matches any configured value\n    const valueMatches = config.values.some(\n      (configValue) => configValue.toLowerCase().trim() === normalizedValue\n    );\n\n    if (valueMatches) {\n      return hookName;\n    }\n  }\n\n  return null;\n}\n"],
+  "mappings": "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",
   "names": ["chroma", "import_css_tree"]
 }

package/build/rules/v9/no-hardcoded-values/handlers/densityHandler.js

@@ -97,9 +97,6 @@ var MARGIN_REGEX = new RegExp(`^margin(?:-${DIRECTION_VALUES})?$`);
 var PADDING_REGEX = new RegExp(`^padding(?:-${DIRECTION_VALUES})?$`);
 var BORDER_RADIUS_REGEX = new RegExp(`^border(?:-${CORNER_VALUES})?-radius$`);
 var INSET_REGEX = new RegExp(`^inset(?:-${INSET_VALUES})?$`);
-function isBorderColorProperty(cssProperty) {
-  return BORDER_COLOR_REGEX.test(cssProperty);
-}
 function isBorderWidthProperty(cssProperty) {
   return BORDER_WIDTH_REGEX.test(cssProperty);
 }
@@ -118,9 +115,9 @@ function isDimensionProperty(cssProperty) {
 function isInsetProperty(cssProperty) {
   return INSET_REGEX.test(cssProperty);
 }
-function resolvePropertyToMatch(cssProperty) {
+function resolveDensityPropertyToMatch(cssProperty) {
   const propertyToMatch = cssProperty.toLowerCase();
-  if (propertyToMatch === "outline" || propertyToMatch === "outline-width" || isBorderWidthProperty(propertyToMatch)) {
+  if (isOutlineWidthProperty(propertyToMatch) || isBorderWidthProperty(propertyToMatch)) {
     return "border-width";
   } else if (isMarginProperty(propertyToMatch)) {
     return "margin";
@@ -132,13 +129,12 @@ function resolvePropertyToMatch(cssProperty) {
     return "width";
   } else if (isInsetProperty(propertyToMatch)) {
     return "top";
-  } else if (cssProperty === "background" || cssProperty === "background-color") {
-    return "background-color";
-  } else if (cssProperty === "outline" || cssProperty === "outline-color" || isBorderColorProperty(cssProperty)) {
-    return "border-color";
   }
   return propertyToMatch;
 }
+function isOutlineWidthProperty(propertyToMatch) {
+  return propertyToMatch === "outline" || propertyToMatch === "outline-width";
+}
 
 // src/utils/hardcoded-shared-utils.ts
 var import_css_tree2 = require("@eslint/css-tree");
@@ -171,13 +167,33 @@ var cssMathFunctionsRegex = new RegExp(`^(?:${CSS_MATH_FUNCTIONS.join("|")})$`);
 
 // src/utils/hardcoded-shared-utils.ts
 function handleShorthandAutoFix(declarationNode, context, valueText, replacements) {
-  const sortedReplacements = replacements.sort((a, b) => a.start - b.start);
-  const hasAnyHooks = sortedReplacements.some((r) => r.hasHook);
-  const canAutoFix = hasAnyHooks;
-  sortedReplacements.forEach(({ start, end, replacement, displayValue, hasHook }) => {
+  if (!replacements || replacements.length === 0) {
+    return;
+  }
+  const sortedReplacements = replacements.sort((a, b) => b.start - a.start);
+  const reportNumericValue = context.options?.reportNumericValue || "always";
+  const fixCallback = (start, originalValue, replacement) => {
+    let newValue = valueText;
+    newValue = newValue.substring(0, start) + replacement + newValue.substring(start + originalValue.length);
+    if (newValue !== valueText) {
+      return (fixer) => {
+        return fixer.replaceText(declarationNode.value, newValue);
+      };
+    }
+  };
+  sortedReplacements.forEach(({ start, end, replacement, displayValue, hasHook, isNumeric }) => {
     const originalValue = valueText.substring(start, end);
-    const valueStartColumn = declarationNode.value.loc.start.column;
-    const valueColumn = valueStartColumn + start;
+    if (isNumeric) {
+      if (reportNumericValue === "never") {
+        return;
+      }
+      if (reportNumericValue === "hasReplacement" && !hasHook) {
+        return;
+      }
+    }
+    const valueColumnStart = declarationNode.value.loc.start.column + start;
+    const valueColumnEnd = valueColumnStart + originalValue.length;
+    const canAutoFix = originalValue !== replacement;
     const { loc: { start: locStart, end: locEnd } } = declarationNode.value;
     const reportNode = {
       ...declarationNode.value,
@@ -185,23 +201,16 @@ function handleShorthandAutoFix(declarationNode, context, valueText, replacement
         ...declarationNode.value.loc,
         start: {
           ...locStart,
-          column: valueColumn
+          column: valueColumnStart
         },
         end: {
           ...locEnd,
-          column: valueColumn + originalValue.length
+          column: valueColumnEnd
         }
       }
     };
     if (hasHook) {
-      const fix = canAutoFix ? (fixer) => {
-        let newValue = valueText;
-        for (let i = sortedReplacements.length - 1; i >= 0; i--) {
-          const { start: rStart, end: rEnd, replacement: rReplacement } = sortedReplacements[i];
-          newValue = newValue.substring(0, rStart) + rReplacement + newValue.substring(rEnd);
-        }
-        return fixer.replaceText(declarationNode.value, newValue);
-      } : void 0;
+      const fix = canAutoFix ? fixCallback(start, originalValue, replacement) : void 0;
       context.context.report({
         node: reportNode,
         messageId: "hardcodedValue",
@@ -298,6 +307,41 @@ function formatSuggestionHooks(hooks) {
   return "\n" + hooks.map((hook, index) => `${index + 1}. ${hook}`).join("\n");
 }
 
+// src/utils/custom-mapping-utils.ts
+function matchesPropertyPattern(cssProperty, pattern) {
+  const normalizedProperty = cssProperty.toLowerCase();
+  const normalizedPattern = pattern.toLowerCase();
+  if (normalizedProperty === normalizedPattern) {
+    return true;
+  }
+  if (normalizedPattern.endsWith("*")) {
+    const prefix = normalizedPattern.slice(0, -1);
+    return normalizedProperty.startsWith(prefix);
+  }
+  return false;
+}
+function getCustomMapping(cssProperty, value, customMapping) {
+  if (!customMapping) {
+    return null;
+  }
+  const normalizedValue = value.toLowerCase().trim();
+  for (const [hookName, config] of Object.entries(customMapping)) {
+    const propertyMatches = config.properties.some(
+      (pattern) => matchesPropertyPattern(cssProperty, pattern)
+    );
+    if (!propertyMatches) {
+      continue;
+    }
+    const valueMatches = config.values.some(
+      (configValue) => configValue.toLowerCase().trim() === normalizedValue
+    );
+    if (valueMatches) {
+      return hookName;
+    }
+  }
+  return null;
+}
+
 // src/rules/v9/no-hardcoded-values/handlers/densityHandler.ts
 var handleDensityDeclaration = (node, context) => {
   const cssProperty = node.property.toLowerCase();
@@ -318,8 +362,14 @@ function createDimensionReplacement(parsedDimension, cssProperty, context, posit
     return null;
   }
   const rawValue = parsedDimension.unit ? `${parsedDimension.number}${parsedDimension.unit}` : parsedDimension.number.toString();
-  const propToMatch = resolvePropertyToMatch(cssProperty);
-  const closestHooks = getStylingHooksForDensityValue(parsedDimension, context.valueToStylinghook, propToMatch);
+  const customHook = getCustomMapping(cssProperty, rawValue, context.options?.customMapping);
+  let closestHooks = [];
+  if (customHook) {
+    closestHooks = [customHook];
+  } else {
+    const propToMatch = resolveDensityPropertyToMatch(cssProperty);
+    closestHooks = getStylingHooksForDensityValue(parsedDimension, context.valueToStylinghook, propToMatch);
+  }
   const start = positionInfo.start.offset;
   const end = positionInfo.end.offset;
   if (closestHooks.length === 1) {
@@ -328,7 +378,8 @@ function createDimensionReplacement(parsedDimension, cssProperty, context, posit
       end,
       replacement: `var(${closestHooks[0]}, ${rawValue})`,
       displayValue: closestHooks[0],
-      hasHook: true
+      hasHook: true,
+      isNumeric: true
     };
   } else if (closestHooks.length > 1) {
     return {
@@ -336,7 +387,8 @@ function createDimensionReplacement(parsedDimension, cssProperty, context, posit
       end,
       replacement: rawValue,
       displayValue: formatSuggestionHooks(closestHooks),
-      hasHook: true
+      hasHook: true,
+      isNumeric: true
     };
   } else {
     return {
@@ -344,7 +396,8 @@ function createDimensionReplacement(parsedDimension, cssProperty, context, posit
       end,
       replacement: rawValue,
       displayValue: rawValue,
-      hasHook: false
+      hasHook: false,
+      isNumeric: true
     };
   }
 }