@salesforce-ux/eslint-plugin-slds 1.0.2 → 1.0.4-internal

package/build/utils/boxShadowValueParser.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/boxShadowValueParser.ts", "../../src/utils/color-lib-utils.ts", "../../src/utils/css-functions.ts", "../../src/utils/value-utils.ts"],
-  "sourcesContent": ["import { parse, walk, generate } from '@eslint/css-tree';\nimport { isValidColor } from './color-lib-utils';\nimport { parseUnitValue, type ParsedUnitValue } from './value-utils';\nimport { isCssColorFunction } from './css-functions';\n\nexport interface BoxShadowValue {\n  offsetX?: string;\n  offsetY?: string;\n  blurRadius?: string;\n  spreadRadius?: string;\n  color?: string;\n  inset?: boolean;\n}\n\ninterface ShadowParts {\n  lengthParts: string[];\n  colorParts: string[];\n  inset: boolean;\n}\n\n/**\n * Check if a CSS tree node represents a color value\n */\nfunction isColorValue(node: any): boolean {\n  if (!node) return false;\n  \n  switch (node.type) {\n    case 'Hash':\n      return true; // #hex colors\n    case 'Identifier':\n      return isValidColor(node.name);\n    case 'Function':\n      return isCssColorFunction(node.name.toLowerCase());\n    default:\n      return false;\n  }\n}\n\n/**\n * Check if a CSS tree node represents a length value\n */\nfunction isLengthValue(node: any): boolean {\n  if (!node) return false;\n  \n  switch (node.type) {\n    case 'Dimension':\n      // Use existing unit parsing to validate the unit\n      const dimensionStr = `${node.value}${node.unit}`;\n      return parseUnitValue(dimensionStr) !== null;\n    case 'Number':\n      // Zero values without units are valid lengths\n      return Number(node.value) === 0;\n    default:\n      return false;\n  }\n}\n\n/**\n * Check if a CSS tree node represents the 'inset' keyword\n */\nfunction isInsetKeyword(node: any): boolean {\n  return node?.type === 'Identifier' && node.name.toLowerCase() === 'inset';\n}\n\n/**\n * Extract shadow parts from CSS tree nodes\n */\nfunction extractShadowParts(valueText: string): ShadowParts[] {\n  const shadows: ShadowParts[] = [];\n  let currentShadow: ShadowParts = {\n    lengthParts: [],\n    colorParts: [],\n    inset: false\n  };\n\n  try {\n    const ast = parse(valueText, { context: 'value' as const });\n    \n    walk(ast, {\n      enter(node: any) {\n        // Skip nested function content for now\n        if (node.type === 'Function') {\n          return this.skip;\n        }\n        \n        if (isInsetKeyword(node)) {\n          currentShadow.inset = true;\n        } else if (isLengthValue(node)) {\n          currentShadow.lengthParts.push(generate(node));\n        } else if (isColorValue(node)) {\n          currentShadow.colorParts.push(generate(node));\n        }\n      }\n    });\n    \n    // Add the current shadow if it has any content\n    if (currentShadow.lengthParts.length > 0 || currentShadow.colorParts.length > 0 || currentShadow.inset) {\n      shadows.push(currentShadow);\n    }\n    \n  } catch (error) {\n    return [];\n  }\n\n  return shadows;\n}\n\n/**\n * Parse box-shadow value into structured format\n * Simplified version for ESLint v9 compatibility\n */\nexport function parseBoxShadowValue(value: string): BoxShadowValue[] {\n  // Handle multiple shadows separated by commas\n  const shadowStrings = value.split(',').map(s => s.trim());\n  const allShadows: BoxShadowValue[] = [];\n  \n  for (const shadowString of shadowStrings) {\n    const shadows = extractShadowParts(shadowString);\n    \n    const parsedShadows = shadows.map((shadow) => {\n      /**\n       * Box-shadow syntax:\n       * Two, three, or four <length> values:\n       * - offset-x offset-y [blur-radius] [spread-radius]\n       * Optionally: inset keyword and color value\n       */\n      const shadowValue: BoxShadowValue = {};\n      \n      // Map length parts to shadow properties\n      const lengthProps = ['offsetX', 'offsetY', 'blurRadius', 'spreadRadius'] as const;\n      lengthProps.forEach((prop, index) => {\n        if (shadow.lengthParts.length > index) {\n          shadowValue[prop] = shadow.lengthParts[index];\n        }\n      });\n      \n      // Add color if present\n      if (shadow.colorParts.length > 0) {\n        shadowValue.color = shadow.colorParts[0];\n      }\n      \n      // Add inset flag if present\n      if (shadow.inset) {\n        shadowValue.inset = true;\n      }\n      \n      return shadowValue;\n    });\n    \n    allShadows.push(...parsedShadows);\n  }\n  \n  return allShadows;\n}\n\n/**\n * Normalize length value for comparison\n */\nfunction normalizeLengthValue(value: string | undefined): string {\n  if (!value) return '0px';\n  if (value === '0') return '0px';\n  return value;\n}\n\n/**\n * Check if two parsed box-shadow values match\n */\nexport function isBoxShadowMatch(parsedCssValue: BoxShadowValue[], parsedValueHook: BoxShadowValue[]): boolean {\n  // If the number of shadows doesn't match, they're not equal\n  if (parsedCssValue.length !== parsedValueHook.length) {\n    return false;\n  }\n\n  // Compare each shadow in the array\n  for (let i = 0; i < parsedCssValue.length; i++) {\n    const cssShadow = parsedCssValue[i];\n    const hookShadow = parsedValueHook[i];\n\n    // Compare color and inset properties\n    if (cssShadow.color !== hookShadow.color || cssShadow.inset !== hookShadow.inset) {\n      return false;\n    }\n\n    // Compare length properties\n    const lengthProps = ['offsetX', 'offsetY', 'blurRadius', 'spreadRadius'] as const;\n    for (const prop of lengthProps) {\n      if (normalizeLengthValue(cssShadow[prop]) !== normalizeLengthValue(hookShadow[prop])) {\n        return false;\n      }\n    }\n  }\n\n  return true;\n}\n", "//stylelint-sds/packages/stylelint-plugin-slds/src/utils/color-lib-utils.ts\nimport { ValueToStylingHooksMapping, ValueToStylingHookEntry } from '@salesforce-ux/sds-metadata';\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  }", "// Simplified value parsing\n\n/**\n * Checks if a value is a CSS global value.\n *\n * CSS global values are special keywords that can be used for any CSS property and have a universal meaning:\n * - initial: Resets the property to its initial value as defined by the CSS specification.\n * - inherit: Inherits the value from the parent element.\n * - unset: Acts as inherit if the property is inheritable, otherwise acts as initial.\n * - revert: Rolls back the property to the value established by the user-agent or user styles.\n * - revert-layer: Rolls back the property to the value established by the previous cascade layer.\n *\n * All CSS properties accept these global values, including but not limited to:\n *   - color\n *   - background\n *   - font-size\n *   - margin\n *   - padding\n *   - border\n *   - display\n *   - position\n *   - z-index\n *   - and many more\n *\n * These values are part of the CSS standard and are not considered violations, even if a rule would otherwise flag a value as invalid or non-design-token. They are always allowed for any property.\n *\n * @param value The CSS value to check.\n * @returns True if the value is a CSS global value, false otherwise.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/initial\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/inherit\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/unset\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert-layer\n */\nexport function isGlobalValue(value: string): boolean {\n    return value === 'initial' || value === 'inherit' || value === 'unset' || value === 'revert' || value === 'revert-layer';\n  }\n\n// Configurable list of allowed CSS units\nexport const ALLOWED_UNITS = ['px', 'em', 'rem', '%', 'ch'];\n\nexport type ParsedUnitValue = {\n  unit: 'px' | 'rem' | '%' | 'em' | 'ch' | null;\n  number: number;\n} | null;\n\nexport function parseUnitValue(value: string): ParsedUnitValue {\n  if (!value) return null;\n  \n  // Create regex pattern from allowed units\n  const unitsPattern = ALLOWED_UNITS.join('|');\n  const regex = new RegExp(`^(-?\\\\d*\\\\.?\\\\d+)(${unitsPattern})?$`);\n  const match = value.match(regex);\n  if (!match) return null;\n  \n  const number = parseFloat(match[1]);\n  const unit = match[2] ? (match[2] as 'px' | 'rem' | '%' | 'em' | 'ch') : null; // Keep unitless values as null\n  \n  if (isNaN(number)) return null;\n  \n  return { number, unit };\n}\n\nexport function toAlternateUnitValue(numberVal: number, unitType: 'px' | 'rem' | '%' | 'em' | 'ch' | null): ParsedUnitValue {\n    if (unitType === 'px') {\n      let floatValue = parseFloat(`${numberVal / 16}`);\n      if (!isNaN(floatValue)) {\n        return {\n          unit: 'rem',\n          number: parseFloat(floatValue.toFixed(4))\n        }\n      }\n    } else if (unitType === 'rem') {\n      const intValue = parseInt(`${numberVal * 16}`);\n      if (!isNaN(intValue)) {\n        return {\n          unit: 'px',\n          number: intValue\n        }\n      }\n    }\n    // For other units (%, em, ch) and unitless values, no alternate unit conversion available\n    // These units are context-dependent and don't have standard conversion ratios\n    return null;\n}"],
+  "sourcesContent": ["import { parse, walk, generate } from '@eslint/css-tree';\nimport { isValidColor } from './color-lib-utils';\nimport { parseUnitValue, type ParsedUnitValue } from './value-utils';\nimport { isCssColorFunction } from './css-functions';\n\nexport interface BoxShadowValue {\n  offsetX?: string;\n  offsetY?: string;\n  blurRadius?: string;\n  spreadRadius?: string;\n  color?: string;\n  inset?: boolean;\n}\n\ninterface ShadowParts {\n  lengthParts: string[];\n  colorParts: string[];\n  inset: boolean;\n}\n\n/**\n * Check if a CSS tree node represents a color value\n */\nfunction isColorValue(node: any): boolean {\n  if (!node) return false;\n  \n  switch (node.type) {\n    case 'Hash':\n      return true; // #hex colors\n    case 'Identifier':\n      return isValidColor(node.name);\n    case 'Function':\n      return isCssColorFunction(node.name.toLowerCase());\n    default:\n      return false;\n  }\n}\n\n/**\n * Check if a CSS tree node represents a length value\n */\nfunction isLengthValue(node: any): boolean {\n  if (!node) return false;\n  \n  switch (node.type) {\n    case 'Dimension':\n      // Use existing unit parsing to validate the unit\n      const dimensionStr = `${node.value}${node.unit}`;\n      return parseUnitValue(dimensionStr) !== null;\n    case 'Number':\n      // Zero values without units are valid lengths\n      return Number(node.value) === 0;\n    default:\n      return false;\n  }\n}\n\n/**\n * Check if a CSS tree node represents the 'inset' keyword\n */\nfunction isInsetKeyword(node: any): boolean {\n  return node?.type === 'Identifier' && node.name.toLowerCase() === 'inset';\n}\n\n/**\n * Extract shadow parts from CSS tree nodes\n */\nfunction extractShadowParts(valueText: string): ShadowParts[] {\n  const shadows: ShadowParts[] = [];\n  let currentShadow: ShadowParts = {\n    lengthParts: [],\n    colorParts: [],\n    inset: false\n  };\n\n  try {\n    const ast = parse(valueText, { context: 'value' as const });\n    \n    walk(ast, {\n      enter(node: any) {\n        // Skip nested function content for now\n        if (node.type === 'Function') {\n          return this.skip;\n        }\n        \n        if (isInsetKeyword(node)) {\n          currentShadow.inset = true;\n        } else if (isLengthValue(node)) {\n          currentShadow.lengthParts.push(generate(node));\n        } else if (isColorValue(node)) {\n          currentShadow.colorParts.push(generate(node));\n        }\n      }\n    });\n    \n    // Add the current shadow if it has any content\n    if (currentShadow.lengthParts.length > 0 || currentShadow.colorParts.length > 0 || currentShadow.inset) {\n      shadows.push(currentShadow);\n    }\n    \n  } catch (error) {\n    return [];\n  }\n\n  return shadows;\n}\n\n/**\n * Parse box-shadow value into structured format\n * Simplified version for ESLint v9 compatibility\n */\nexport function parseBoxShadowValue(value: string): BoxShadowValue[] {\n  // Handle multiple shadows separated by commas\n  const shadowStrings = value.split(',').map(s => s.trim());\n  const allShadows: BoxShadowValue[] = [];\n  \n  for (const shadowString of shadowStrings) {\n    const shadows = extractShadowParts(shadowString);\n    \n    const parsedShadows = shadows.map((shadow) => {\n      /**\n       * Box-shadow syntax:\n       * Two, three, or four <length> values:\n       * - offset-x offset-y [blur-radius] [spread-radius]\n       * Optionally: inset keyword and color value\n       */\n      const shadowValue: BoxShadowValue = {};\n      \n      // Map length parts to shadow properties\n      const lengthProps = ['offsetX', 'offsetY', 'blurRadius', 'spreadRadius'] as const;\n      lengthProps.forEach((prop, index) => {\n        if (shadow.lengthParts.length > index) {\n          shadowValue[prop] = shadow.lengthParts[index];\n        }\n      });\n      \n      // Add color if present\n      if (shadow.colorParts.length > 0) {\n        shadowValue.color = shadow.colorParts[0];\n      }\n      \n      // Add inset flag if present\n      if (shadow.inset) {\n        shadowValue.inset = true;\n      }\n      \n      return shadowValue;\n    });\n    \n    allShadows.push(...parsedShadows);\n  }\n  \n  return allShadows;\n}\n\n/**\n * Normalize length value for comparison\n */\nfunction normalizeLengthValue(value: string | undefined): string {\n  if (!value) return '0px';\n  if (value === '0') return '0px';\n  return value;\n}\n\n/**\n * Check if two parsed box-shadow values match\n */\nexport function isBoxShadowMatch(parsedCssValue: BoxShadowValue[], parsedValueHook: BoxShadowValue[]): boolean {\n  // If the number of shadows doesn't match, they're not equal\n  if (parsedCssValue.length !== parsedValueHook.length) {\n    return false;\n  }\n\n  // Compare each shadow in the array\n  for (let i = 0; i < parsedCssValue.length; i++) {\n    const cssShadow = parsedCssValue[i];\n    const hookShadow = parsedValueHook[i];\n\n    // Compare color and inset properties\n    if (cssShadow.color !== hookShadow.color || cssShadow.inset !== hookShadow.inset) {\n      return false;\n    }\n\n    // Compare length properties\n    const lengthProps = ['offsetX', 'offsetY', 'blurRadius', 'spreadRadius'] as const;\n    for (const prop of lengthProps) {\n      if (normalizeLengthValue(cssShadow[prop]) !== normalizeLengthValue(hookShadow[prop])) {\n        return false;\n      }\n    }\n  }\n\n  return true;\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  }", "// Simplified value parsing\n\n/**\n * Checks if a value is a CSS global value.\n *\n * CSS global values are special keywords that can be used for any CSS property and have a universal meaning:\n * - initial: Resets the property to its initial value as defined by the CSS specification.\n * - inherit: Inherits the value from the parent element.\n * - unset: Acts as inherit if the property is inheritable, otherwise acts as initial.\n * - revert: Rolls back the property to the value established by the user-agent or user styles.\n * - revert-layer: Rolls back the property to the value established by the previous cascade layer.\n *\n * All CSS properties accept these global values, including but not limited to:\n *   - color\n *   - background\n *   - font-size\n *   - margin\n *   - padding\n *   - border\n *   - display\n *   - position\n *   - z-index\n *   - and many more\n *\n * These values are part of the CSS standard and are not considered violations, even if a rule would otherwise flag a value as invalid or non-design-token. They are always allowed for any property.\n *\n * @param value The CSS value to check.\n * @returns True if the value is a CSS global value, false otherwise.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/initial\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/inherit\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/unset\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert-layer\n */\nexport function isGlobalValue(value: string): boolean {\n    return value === 'initial' || value === 'inherit' || value === 'unset' || value === 'revert' || value === 'revert-layer';\n  }\n\n// Configurable list of allowed CSS units\nexport const ALLOWED_UNITS = ['px', 'em', 'rem', '%', 'ch'];\n\nexport type ParsedUnitValue = {\n  unit: 'px' | 'rem' | '%' | 'em' | 'ch' | null;\n  number: number;\n} | null;\n\nexport function parseUnitValue(value: string): ParsedUnitValue {\n  if (!value) return null;\n  \n  // Create regex pattern from allowed units\n  const unitsPattern = ALLOWED_UNITS.join('|');\n  const regex = new RegExp(`^(-?\\\\d*\\\\.?\\\\d+)(${unitsPattern})?$`);\n  const match = value.match(regex);\n  if (!match) return null;\n  \n  const number = parseFloat(match[1]);\n  const unit = match[2] ? (match[2] as 'px' | 'rem' | '%' | 'em' | 'ch') : null; // Keep unitless values as null\n  \n  if (isNaN(number)) return null;\n  \n  return { number, unit };\n}\n\nexport function toAlternateUnitValue(numberVal: number, unitType: 'px' | 'rem' | '%' | 'em' | 'ch' | null): ParsedUnitValue {\n    if (unitType === 'px') {\n      let floatValue = parseFloat(`${numberVal / 16}`);\n      if (!isNaN(floatValue)) {\n        return {\n          unit: 'rem',\n          number: parseFloat(floatValue.toFixed(4))\n        }\n      }\n    } else if (unitType === 'rem') {\n      const intValue = parseInt(`${numberVal * 16}`);\n      if (!isNaN(intValue)) {\n        return {\n          unit: 'px',\n          number: intValue\n        }\n      }\n    }\n    // For other units (%, em, ch) and unitless values, no alternate unit conversion available\n    // These units are context-dependent and don't have standard conversion ratios\n    return null;\n}"],
   "mappings": "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",
   "names": ["import_css_tree", "chroma"]
 }

package/build/utils/color-lib-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/color-lib-utils.ts", "../../src/utils/css-functions.ts"],
-  "sourcesContent": ["//stylelint-sds/packages/stylelint-plugin-slds/src/utils/color-lib-utils.ts\nimport { ValueToStylingHooksMapping, ValueToStylingHookEntry } from '@salesforce-ux/sds-metadata';\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  }"],
+  "sourcesContent": ["//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  }"],
   "mappings": "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",
   "names": ["chroma"]
 }

package/build/utils/css-utils.js

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/utils/css-utils.ts
 var css_utils_exports = {};
 __export(css_utils_exports, {
+  forEachNamespacedVariable: () => forEachNamespacedVariable,
   forEachSldsVariable: () => forEachSldsVariable,
   formatSuggestionHooks: () => formatSuggestionHooks,
   isTargetProperty: () => isTargetProperty
@@ -96,7 +97,7 @@ function isTargetProperty(property, propertyTargets = []) {
   if (typeof property !== "string") return false;
   return property.startsWith("--sds-") || property.startsWith("--slds-") || property.startsWith("--lwc-") || propertyTargets.length === 0 || propertyTargets.includes(property);
 }
-function extractSldsVariable(node) {
+function extractCssVariable(node, filter) {
   if (!node || node.type !== "Function" || node.name !== "var") {
     return null;
   }
@@ -112,19 +113,31 @@ function extractSldsVariable(node) {
     return null;
   }
   const variableName = firstChild.name;
-  if (!variableName || !variableName.startsWith("--slds-")) {
+  if (!variableName) {
     return null;
   }
-  const hasFallback = childrenArray.some(
-    (child) => child.type === "Operator" && child.value === ","
-  );
-  return {
-    name: variableName,
-    hasFallback
-  };
+  return filter(variableName, childrenArray);
 }
 function forEachSldsVariable(valueText, callback) {
-  forEachValue(valueText, extractSldsVariable, () => false, callback);
+  const extractor = (node) => extractCssVariable(node, (variableName, childrenArray) => {
+    if (!variableName.startsWith("--slds-")) {
+      return null;
+    }
+    const hasFallback = childrenArray.some(
+      (child) => child.type === "Operator" && child.value === ","
+    );
+    return { name: variableName, hasFallback };
+  });
+  forEachValue(valueText, extractor, () => false, callback);
+}
+function forEachNamespacedVariable(valueText, callback) {
+  const extractor = (node) => extractCssVariable(node, (variableName) => {
+    if (variableName.startsWith("--slds-") || variableName.startsWith("--sds-")) {
+      return { name: variableName, hasFallback: false };
+    }
+    return null;
+  });
+  forEachValue(valueText, extractor, () => false, callback);
 }
 function formatSuggestionHooks(hooks) {
   if (hooks.length === 1) {
@@ -134,6 +147,7 @@ function formatSuggestionHooks(hooks) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  forEachNamespacedVariable,
   forEachSldsVariable,
   formatSuggestionHooks,
   isTargetProperty

package/build/utils/css-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/css-utils.ts", "../../src/utils/hardcoded-shared-utils.ts", "../../src/utils/color-lib-utils.ts", "../../src/utils/css-functions.ts"],
-  "sourcesContent": ["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 * Extract CSS variable information from var() function nodes\n * Used specifically for SLDS variable fallback detection\n */\nfunction extractSldsVariable(node: any): CssVariableInfo | 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 || !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 {\n    name: variableName,\n    hasFallback\n  };\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  forEachValue(valueText, extractSldsVariable, () => 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 { 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", "//stylelint-sds/packages/stylelint-plugin-slds/src/utils/color-lib-utils.ts\nimport { ValueToStylingHooksMapping, ValueToStylingHookEntry } from '@salesforce-ux/sds-metadata';\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  }"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,mBAA4B;;;ACE5B,uBAAmB;AACnB,sBAAyB;;;ACCzB,IAAM,gBAAgB;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,IAAM,qBAAqB,CAAC,QAAQ,OAAO,KAAK;AAShD,IAAM,oBAAoB,IAAI,OAAO,MAAM,cAAc,KAAK,GAAG,CAAC,GAAG;AAGrE,IAAM,yBAAyB,IAAI,OAAO,OAAO,cAAc,KAAK,GAAG,CAAC,IAAI;AAG5E,IAAM,wBAAwB,IAAI,OAAO,OAAO,mBAAmB,KAAK,GAAG,CAAC,IAAI;;;AFsG3E,SAAS,aACd,WACA,cACA,gBACA,UACM;AACN,MAAI,CAAC,aAAa,OAAO,cAAc,UAAU;AAC/C;AAAA,EACF;AAEA,MAAI;AACF,UAAM,UAAM,wBAAM,WAAW,EAAE,SAAS,SAAkB,WAAW,KAAK,CAAC;AAE3E,+BAAK,KAAK;AAAA,MACR,MAAM,MAAW;AAEf,YAAI,eAAe,IAAI,GAAG;AACxB,iBAAO,KAAK;AAAA,QACd;AAEA,cAAM,QAAQ,aAAa,IAAI;AAC/B,YAAI,UAAU,MAAM;AAClB,gBAAM,eAA6B;AAAA,YACjC,OAAO,KAAK,KAAK;AAAA,YACjB,KAAK,KAAK,KAAK;AAAA,UACjB;AACA,mBAAS,OAAO,YAAY;AAAA,QAC9B;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH,SAAS,OAAO;AAEd;AAAA,EACF;AACF;;;ADlKO,SAAS,iBAAiB,UAAkB,kBAA4B,CAAC,GAAY;AAC1F,MAAI,OAAO,aAAa,SAAU,QAAO;AACzC,SAAO,SAAS,WAAW,QAAQ,KAC9B,SAAS,WAAW,SAAS,KAC7B,SAAS,WAAW,QAAQ,KAC5B,gBAAgB,WAAW,KAC3B,gBAAgB,SAAS,QAAQ;AACxC;AAcA,SAAS,oBAAoB,MAAmC;AAC9D,MAAI,CAAC,QAAQ,KAAK,SAAS,cAAc,KAAK,SAAS,OAAO;AAC5D,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,KAAK,UAAU;AAClB,WAAO;AAAA,EACT;AAGA,QAAM,gBAAgB,MAAM,KAAK,KAAK,QAAQ;AAC9C,MAAI,cAAc,WAAW,GAAG;AAC9B,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,cAAc,CAAC;AAClC,MAAI,CAAC,cAAc,WAAW,SAAS,cAAc;AACnD,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,WAAW;AAChC,MAAI,CAAC,gBAAgB,CAAC,aAAa,WAAW,SAAS,GAAG;AACxD,WAAO;AAAA,EACT;AAGA,QAAM,cAAc,cAAc;AAAA,IAAK,CAAC,UACtC,MAAM,SAAS,cAAc,MAAM,UAAU;AAAA,EAC/C;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EACF;AACF;AAMO,SAAS,oBACd,WACA,UACM;AACN,eAAa,WAAW,qBAAqB,MAAM,OAAO,QAAQ;AACpE;AAOO,SAAS,sBAAsB,OAAyB;AAC7D,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO,GAAG,MAAM,CAAC,CAAC;AAAA,EACpB;AAGA,SAAO,OAAO,MAAM,IAAI,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,KAAK,IAAI;AAC7E;",
+  "sourcesContent": ["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 * 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 { 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", "//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  }"],
+  "mappings": "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",
   "names": ["import_css_tree"]
 }

package/build/utils/hardcoded-shared-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/hardcoded-shared-utils.ts", "../../src/utils/value-utils.ts", "../../src/utils/color-lib-utils.ts", "../../src/utils/css-functions.ts"],
-  "sourcesContent": ["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", "// Simplified value parsing\n\n/**\n * Checks if a value is a CSS global value.\n *\n * CSS global values are special keywords that can be used for any CSS property and have a universal meaning:\n * - initial: Resets the property to its initial value as defined by the CSS specification.\n * - inherit: Inherits the value from the parent element.\n * - unset: Acts as inherit if the property is inheritable, otherwise acts as initial.\n * - revert: Rolls back the property to the value established by the user-agent or user styles.\n * - revert-layer: Rolls back the property to the value established by the previous cascade layer.\n *\n * All CSS properties accept these global values, including but not limited to:\n *   - color\n *   - background\n *   - font-size\n *   - margin\n *   - padding\n *   - border\n *   - display\n *   - position\n *   - z-index\n *   - and many more\n *\n * These values are part of the CSS standard and are not considered violations, even if a rule would otherwise flag a value as invalid or non-design-token. They are always allowed for any property.\n *\n * @param value The CSS value to check.\n * @returns True if the value is a CSS global value, false otherwise.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/initial\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/inherit\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/unset\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert-layer\n */\nexport function isGlobalValue(value: string): boolean {\n    return value === 'initial' || value === 'inherit' || value === 'unset' || value === 'revert' || value === 'revert-layer';\n  }\n\n// Configurable list of allowed CSS units\nexport const ALLOWED_UNITS = ['px', 'em', 'rem', '%', 'ch'];\n\nexport type ParsedUnitValue = {\n  unit: 'px' | 'rem' | '%' | 'em' | 'ch' | null;\n  number: number;\n} | null;\n\nexport function parseUnitValue(value: string): ParsedUnitValue {\n  if (!value) return null;\n  \n  // Create regex pattern from allowed units\n  const unitsPattern = ALLOWED_UNITS.join('|');\n  const regex = new RegExp(`^(-?\\\\d*\\\\.?\\\\d+)(${unitsPattern})?$`);\n  const match = value.match(regex);\n  if (!match) return null;\n  \n  const number = parseFloat(match[1]);\n  const unit = match[2] ? (match[2] as 'px' | 'rem' | '%' | 'em' | 'ch') : null; // Keep unitless values as null\n  \n  if (isNaN(number)) return null;\n  \n  return { number, unit };\n}\n\nexport function toAlternateUnitValue(numberVal: number, unitType: 'px' | 'rem' | '%' | 'em' | 'ch' | null): ParsedUnitValue {\n    if (unitType === 'px') {\n      let floatValue = parseFloat(`${numberVal / 16}`);\n      if (!isNaN(floatValue)) {\n        return {\n          unit: 'rem',\n          number: parseFloat(floatValue.toFixed(4))\n        }\n      }\n    } else if (unitType === 'rem') {\n      const intValue = parseInt(`${numberVal * 16}`);\n      if (!isNaN(intValue)) {\n        return {\n          unit: 'px',\n          number: intValue\n        }\n      }\n    }\n    // For other units (%, em, ch) and unitless values, no alternate unit conversion available\n    // These units are context-dependent and don't have standard conversion ratios\n    return null;\n}", "//stylelint-sds/packages/stylelint-plugin-slds/src/utils/color-lib-utils.ts\nimport { ValueToStylingHooksMapping, ValueToStylingHookEntry } from '@salesforce-ux/sds-metadata';\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  }"],
+  "sourcesContent": ["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", "// Simplified value parsing\n\n/**\n * Checks if a value is a CSS global value.\n *\n * CSS global values are special keywords that can be used for any CSS property and have a universal meaning:\n * - initial: Resets the property to its initial value as defined by the CSS specification.\n * - inherit: Inherits the value from the parent element.\n * - unset: Acts as inherit if the property is inheritable, otherwise acts as initial.\n * - revert: Rolls back the property to the value established by the user-agent or user styles.\n * - revert-layer: Rolls back the property to the value established by the previous cascade layer.\n *\n * All CSS properties accept these global values, including but not limited to:\n *   - color\n *   - background\n *   - font-size\n *   - margin\n *   - padding\n *   - border\n *   - display\n *   - position\n *   - z-index\n *   - and many more\n *\n * These values are part of the CSS standard and are not considered violations, even if a rule would otherwise flag a value as invalid or non-design-token. They are always allowed for any property.\n *\n * @param value The CSS value to check.\n * @returns True if the value is a CSS global value, false otherwise.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/initial\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/inherit\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/unset\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert-layer\n */\nexport function isGlobalValue(value: string): boolean {\n    return value === 'initial' || value === 'inherit' || value === 'unset' || value === 'revert' || value === 'revert-layer';\n  }\n\n// Configurable list of allowed CSS units\nexport const ALLOWED_UNITS = ['px', 'em', 'rem', '%', 'ch'];\n\nexport type ParsedUnitValue = {\n  unit: 'px' | 'rem' | '%' | 'em' | 'ch' | null;\n  number: number;\n} | null;\n\nexport function parseUnitValue(value: string): ParsedUnitValue {\n  if (!value) return null;\n  \n  // Create regex pattern from allowed units\n  const unitsPattern = ALLOWED_UNITS.join('|');\n  const regex = new RegExp(`^(-?\\\\d*\\\\.?\\\\d+)(${unitsPattern})?$`);\n  const match = value.match(regex);\n  if (!match) return null;\n  \n  const number = parseFloat(match[1]);\n  const unit = match[2] ? (match[2] as 'px' | 'rem' | '%' | 'em' | 'ch') : null; // Keep unitless values as null\n  \n  if (isNaN(number)) return null;\n  \n  return { number, unit };\n}\n\nexport function toAlternateUnitValue(numberVal: number, unitType: 'px' | 'rem' | '%' | 'em' | 'ch' | null): ParsedUnitValue {\n    if (unitType === 'px') {\n      let floatValue = parseFloat(`${numberVal / 16}`);\n      if (!isNaN(floatValue)) {\n        return {\n          unit: 'rem',\n          number: parseFloat(floatValue.toFixed(4))\n        }\n      }\n    } else if (unitType === 'rem') {\n      const intValue = parseInt(`${numberVal * 16}`);\n      if (!isNaN(intValue)) {\n        return {\n          unit: 'px',\n          number: intValue\n        }\n      }\n    }\n    // For other units (%, em, ch) and unitless values, no alternate unit conversion available\n    // These units are context-dependent and don't have standard conversion ratios\n    return null;\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  }"],
   "mappings": "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",
   "names": ["import_css_tree", "chroma"]
 }

package/build/utils/styling-hook-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/styling-hook-utils.ts", "../../src/utils/value-utils.ts"],
-  "sourcesContent": ["import type { ValueToStylingHookEntry, ValueToStylingHooksMapping } from '@salesforce-ux/sds-metadata';\nimport { ParsedUnitValue, parseUnitValue, toAlternateUnitValue } from './value-utils';\n\nfunction isValueMatch(valueToMatch: ParsedUnitValue, sldsValue: ParsedUnitValue): boolean {\n  if (!valueToMatch || !sldsValue) {\n    return false;\n  }\n  return valueToMatch.unit == sldsValue.unit && valueToMatch.number === sldsValue.number;\n}\n\n/**\n * Get styling hooks for a density value using structured data from CSS AST\n * Eliminates regex parsing by accepting pre-parsed dimension data\n */\nexport function getStylingHooksForDensityValue(\n  parsedValue: ParsedUnitValue,\n  supportedStylinghooks: ValueToStylingHooksMapping,\n  cssProperty: string\n): string[] {\n  if (!parsedValue) return [];\n  \n  const alternateValue = toAlternateUnitValue(parsedValue.number, parsedValue.unit);\n  const matchedHooks = [];\n\n  for (const [sldsValue, hooks] of Object.entries(supportedStylinghooks)) {\n    // parsing SLDS metadata values\n    const parsedSldsValue = parseUnitValue(sldsValue);\n    if (isValueMatch(parsedValue, parsedSldsValue) || (alternateValue && isValueMatch(alternateValue, parsedSldsValue))) {\n      hooks\n        .filter((hook: ValueToStylingHookEntry) => hook.properties.includes(cssProperty))\n        .forEach((hook) => matchedHooks.push(hook.name));\n    }\n  }\n  return matchedHooks;\n}", "// Simplified value parsing\n\n/**\n * Checks if a value is a CSS global value.\n *\n * CSS global values are special keywords that can be used for any CSS property and have a universal meaning:\n * - initial: Resets the property to its initial value as defined by the CSS specification.\n * - inherit: Inherits the value from the parent element.\n * - unset: Acts as inherit if the property is inheritable, otherwise acts as initial.\n * - revert: Rolls back the property to the value established by the user-agent or user styles.\n * - revert-layer: Rolls back the property to the value established by the previous cascade layer.\n *\n * All CSS properties accept these global values, including but not limited to:\n *   - color\n *   - background\n *   - font-size\n *   - margin\n *   - padding\n *   - border\n *   - display\n *   - position\n *   - z-index\n *   - and many more\n *\n * These values are part of the CSS standard and are not considered violations, even if a rule would otherwise flag a value as invalid or non-design-token. They are always allowed for any property.\n *\n * @param value The CSS value to check.\n * @returns True if the value is a CSS global value, false otherwise.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/initial\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/inherit\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/unset\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert-layer\n */\nexport function isGlobalValue(value: string): boolean {\n    return value === 'initial' || value === 'inherit' || value === 'unset' || value === 'revert' || value === 'revert-layer';\n  }\n\n// Configurable list of allowed CSS units\nexport const ALLOWED_UNITS = ['px', 'em', 'rem', '%', 'ch'];\n\nexport type ParsedUnitValue = {\n  unit: 'px' | 'rem' | '%' | 'em' | 'ch' | null;\n  number: number;\n} | null;\n\nexport function parseUnitValue(value: string): ParsedUnitValue {\n  if (!value) return null;\n  \n  // Create regex pattern from allowed units\n  const unitsPattern = ALLOWED_UNITS.join('|');\n  const regex = new RegExp(`^(-?\\\\d*\\\\.?\\\\d+)(${unitsPattern})?$`);\n  const match = value.match(regex);\n  if (!match) return null;\n  \n  const number = parseFloat(match[1]);\n  const unit = match[2] ? (match[2] as 'px' | 'rem' | '%' | 'em' | 'ch') : null; // Keep unitless values as null\n  \n  if (isNaN(number)) return null;\n  \n  return { number, unit };\n}\n\nexport function toAlternateUnitValue(numberVal: number, unitType: 'px' | 'rem' | '%' | 'em' | 'ch' | null): ParsedUnitValue {\n    if (unitType === 'px') {\n      let floatValue = parseFloat(`${numberVal / 16}`);\n      if (!isNaN(floatValue)) {\n        return {\n          unit: 'rem',\n          number: parseFloat(floatValue.toFixed(4))\n        }\n      }\n    } else if (unitType === 'rem') {\n      const intValue = parseInt(`${numberVal * 16}`);\n      if (!isNaN(intValue)) {\n        return {\n          unit: 'px',\n          number: intValue\n        }\n      }\n    }\n    // For other units (%, em, ch) and unitless values, no alternate unit conversion available\n    // These units are context-dependent and don't have standard conversion ratios\n    return null;\n}"],
+  "sourcesContent": ["import type { ValueToStylingHookEntry, ValueToStylingHooksMapping } from '@salesforce-ux/sds-metadata/next';\nimport { ParsedUnitValue, parseUnitValue, toAlternateUnitValue } from './value-utils';\n\nfunction isValueMatch(valueToMatch: ParsedUnitValue, sldsValue: ParsedUnitValue): boolean {\n  if (!valueToMatch || !sldsValue) {\n    return false;\n  }\n  return valueToMatch.unit == sldsValue.unit && valueToMatch.number === sldsValue.number;\n}\n\n/**\n * Get styling hooks for a density value using structured data from CSS AST\n * Eliminates regex parsing by accepting pre-parsed dimension data\n */\nexport function getStylingHooksForDensityValue(\n  parsedValue: ParsedUnitValue,\n  supportedStylinghooks: ValueToStylingHooksMapping,\n  cssProperty: string\n): string[] {\n  if (!parsedValue) return [];\n  \n  const alternateValue = toAlternateUnitValue(parsedValue.number, parsedValue.unit);\n  const matchedHooks = [];\n\n  for (const [sldsValue, hooks] of Object.entries(supportedStylinghooks)) {\n    // parsing SLDS metadata values\n    const parsedSldsValue = parseUnitValue(sldsValue);\n    if (isValueMatch(parsedValue, parsedSldsValue) || (alternateValue && isValueMatch(alternateValue, parsedSldsValue))) {\n      hooks\n        .filter((hook: ValueToStylingHookEntry) => hook.properties.includes(cssProperty))\n        .forEach((hook) => matchedHooks.push(hook.name));\n    }\n  }\n  return matchedHooks;\n}", "// Simplified value parsing\n\n/**\n * Checks if a value is a CSS global value.\n *\n * CSS global values are special keywords that can be used for any CSS property and have a universal meaning:\n * - initial: Resets the property to its initial value as defined by the CSS specification.\n * - inherit: Inherits the value from the parent element.\n * - unset: Acts as inherit if the property is inheritable, otherwise acts as initial.\n * - revert: Rolls back the property to the value established by the user-agent or user styles.\n * - revert-layer: Rolls back the property to the value established by the previous cascade layer.\n *\n * All CSS properties accept these global values, including but not limited to:\n *   - color\n *   - background\n *   - font-size\n *   - margin\n *   - padding\n *   - border\n *   - display\n *   - position\n *   - z-index\n *   - and many more\n *\n * These values are part of the CSS standard and are not considered violations, even if a rule would otherwise flag a value as invalid or non-design-token. They are always allowed for any property.\n *\n * @param value The CSS value to check.\n * @returns True if the value is a CSS global value, false otherwise.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/initial\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/inherit\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/unset\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/revert-layer\n */\nexport function isGlobalValue(value: string): boolean {\n    return value === 'initial' || value === 'inherit' || value === 'unset' || value === 'revert' || value === 'revert-layer';\n  }\n\n// Configurable list of allowed CSS units\nexport const ALLOWED_UNITS = ['px', 'em', 'rem', '%', 'ch'];\n\nexport type ParsedUnitValue = {\n  unit: 'px' | 'rem' | '%' | 'em' | 'ch' | null;\n  number: number;\n} | null;\n\nexport function parseUnitValue(value: string): ParsedUnitValue {\n  if (!value) return null;\n  \n  // Create regex pattern from allowed units\n  const unitsPattern = ALLOWED_UNITS.join('|');\n  const regex = new RegExp(`^(-?\\\\d*\\\\.?\\\\d+)(${unitsPattern})?$`);\n  const match = value.match(regex);\n  if (!match) return null;\n  \n  const number = parseFloat(match[1]);\n  const unit = match[2] ? (match[2] as 'px' | 'rem' | '%' | 'em' | 'ch') : null; // Keep unitless values as null\n  \n  if (isNaN(number)) return null;\n  \n  return { number, unit };\n}\n\nexport function toAlternateUnitValue(numberVal: number, unitType: 'px' | 'rem' | '%' | 'em' | 'ch' | null): ParsedUnitValue {\n    if (unitType === 'px') {\n      let floatValue = parseFloat(`${numberVal / 16}`);\n      if (!isNaN(floatValue)) {\n        return {\n          unit: 'rem',\n          number: parseFloat(floatValue.toFixed(4))\n        }\n      }\n    } else if (unitType === 'rem') {\n      const intValue = parseInt(`${numberVal * 16}`);\n      if (!isNaN(intValue)) {\n        return {\n          unit: 'px',\n          number: intValue\n        }\n      }\n    }\n    // For other units (%, em, ch) and unitless values, no alternate unit conversion available\n    // These units are context-dependent and don't have standard conversion ratios\n    return null;\n}"],
   "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACwCO,IAAM,gBAAgB,CAAC,MAAM,MAAM,OAAO,KAAK,IAAI;AAOnD,SAAS,eAAe,OAAgC;AAC7D,MAAI,CAAC,MAAO,QAAO;AAGnB,QAAM,eAAe,cAAc,KAAK,GAAG;AAC3C,QAAM,QAAQ,IAAI,OAAO,qBAAqB,YAAY,KAAK;AAC/D,QAAM,QAAQ,MAAM,MAAM,KAAK;AAC/B,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,SAAS,WAAW,MAAM,CAAC,CAAC;AAClC,QAAM,OAAO,MAAM,CAAC,IAAK,MAAM,CAAC,IAAyC;AAEzE,MAAI,MAAM,MAAM,EAAG,QAAO;AAE1B,SAAO,EAAE,QAAQ,KAAK;AACxB;AAEO,SAAS,qBAAqB,WAAmB,UAAoE;AACxH,MAAI,aAAa,MAAM;AACrB,QAAI,aAAa,WAAW,GAAG,YAAY,EAAE,EAAE;AAC/C,QAAI,CAAC,MAAM,UAAU,GAAG;AACtB,aAAO;AAAA,QACL,MAAM;AAAA,QACN,QAAQ,WAAW,WAAW,QAAQ,CAAC,CAAC;AAAA,MAC1C;AAAA,IACF;AAAA,EACF,WAAW,aAAa,OAAO;AAC7B,UAAM,WAAW,SAAS,GAAG,YAAY,EAAE,EAAE;AAC7C,QAAI,CAAC,MAAM,QAAQ,GAAG;AACpB,aAAO;AAAA,QACL,MAAM;AAAA,QACN,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAGA,SAAO;AACX;;;ADlFA,SAAS,aAAa,cAA+B,WAAqC;AACxF,MAAI,CAAC,gBAAgB,CAAC,WAAW;AAC/B,WAAO;AAAA,EACT;AACA,SAAO,aAAa,QAAQ,UAAU,QAAQ,aAAa,WAAW,UAAU;AAClF;AAMO,SAAS,+BACd,aACA,uBACA,aACU;AACV,MAAI,CAAC,YAAa,QAAO,CAAC;AAE1B,QAAM,iBAAiB,qBAAqB,YAAY,QAAQ,YAAY,IAAI;AAChF,QAAM,eAAe,CAAC;AAEtB,aAAW,CAAC,WAAW,KAAK,KAAK,OAAO,QAAQ,qBAAqB,GAAG;AAEtE,UAAM,kBAAkB,eAAe,SAAS;AAChD,QAAI,aAAa,aAAa,eAAe,KAAM,kBAAkB,aAAa,gBAAgB,eAAe,GAAI;AACnH,YACG,OAAO,CAAC,SAAkC,KAAK,WAAW,SAAS,WAAW,CAAC,EAC/E,QAAQ,CAAC,SAAS,aAAa,KAAK,KAAK,IAAI,CAAC;AAAA,IACnD;AAAA,EACF;AACA,SAAO;AACT;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce-ux/eslint-plugin-slds",
-  "version": "1.0.2",
+  "version": "1.0.4-internal",
   "main": "build/index.js",
   "exports": {
     ".": {
@@ -38,7 +38,7 @@
     "@eslint/css-tree": "^3.6.5",
     "@html-eslint/eslint-plugin": "^0.34.0",
     "@html-eslint/parser": "^0.34.0",
-    "@salesforce-ux/sds-metadata": "^0.4.0",
+    "@salesforce-ux/sds-metadata": "^1.1.0",
     "chroma-js": "^3.1.2"
   },
   "peerDependencies": {