@salesforce-ux/eslint-plugin-slds 1.0.5 → 1.0.6-internal

package/build/rules/v9/no-sldshook-fallback-for-lwctoken.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["yaml-file:rule-messages.yml", "../../../src/rules/v9/no-sldshook-fallback-for-lwctoken.ts"],
-  "sourcesContent": ["module.exports = {\n  \"no-slds-class-overrides\": {\n    \"description\": \"Create new custom CSS classes instead of overriding SLDS selectors\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-class-overrides\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"sldsClassOverride\": \"Overriding .{{className}} isn't supported. To differentiate SLDS and custom classes, create a CSS class in your namespace. Examples: myapp-input, myapp-button.\"\n    }\n  },\n  \"no-deprecated-slds-classes\": {\n    \"description\": \"Please replace the deprecated classes with a modern equivalent\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-slds-classes\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedClass\": \"The class {{className}} is deprecated and not available in SLDS2. Please update to a supported class.\"\n    }\n  },\n  \"no-deprecated-tokens-slds1\": {\n    \"description\": \"Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-tokens-slds1\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedToken\": \"Consider removing {{oldValue}} or replacing it with {{newValue}}. Set the fallback to {{oldValue}}. For more info, see Styling Hooks on lightningdesignsystem.com.\",\n      \"noReplacement\": \"Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.\"\n    }\n  },\n  \"enforce-sds-to-slds-hooks\": {\n    \"description\": \"Convert your existing --sds styling hooks to --slds styling hooks. See lightningdesignsystem.com for more info.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-sds-to-slds-hooks\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"replaceSdsWithSlds\": \"Replace {{oldValue}} with {{suggestedMatch}} styling hook.\"\n    }\n  },\n  \"enforce-bem-usage\": {\n    \"description\": \"Replace BEM double-dash syntax in class names with single underscore syntax\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-bem-usage\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"bemDoubleDash\": \"{{actual}} has been retired. Update it to the new name {{newValue}}.\",\n      \"fixBemNaming\": \"Update to correct BEM naming convention\"\n    }\n  },\n  \"modal-close-button-issue\": {\n    \"description\": \"Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#modal-close-button-issue\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"modalCloseButtonIssue\": \"Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint.\",\n      \"removeClass\": \"Remove the slds-button_icon-inverse class from the modal close button in components that use the SLDS modal blueprint.\",\n      \"changeVariant\": \"Change the variant attribute value from bare-inverse to bare in <lightning-button-icon> or <lightning-icon>.\",\n      \"removeVariant\": \"Remove the variant attribute from the <lightning-icon> component inside the <button> element.\",\n      \"ensureButtonClasses\": \"Add or move slds-button and slds-button_icon to the class attribute of the <button> element or <lightning-button-icon> component.\",\n      \"ensureSizeAttribute\": \"To size icons properly, set the size attribute \u200Cto large in the <lightning-icon> and <lightning-button-icon> components.\"\n    }\n  },\n  \"no-deprecated-classes-slds2\": {\n    \"description\": \"Replace classes that aren't available with SLDS 2 classes\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-classes-slds2\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedClass\": \"The class {{className}} isn't available in SLDS 2. Update it to a class supported in SLDS 2. See lightningdesignsystem.com for more information.\",\n      \"updateToModernClass\": \"Replace deprecated class with modern equivalent\",\n      \"checkDocumentation\": \"See lightningdesignsystem.com for SLDS 2 class alternatives\"\n    }\n  },\n  \"lwc-token-to-slds-hook\": {\n    \"description\": \"Replace the deprecated --lwc tokens with the latest --slds tokens. See lightningdesignsystem.com for more info.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#lwc-token-to-slds-hook\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"errorWithReplacement\": \"The '{{oldValue}}' design token is deprecated. Replace it with '{{newValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.\",\n      \"errorWithStyleHooks\": \"The '{{oldValue}}' design token is deprecated. Replace it with the SLDS 2 '{{newValue}}' styling hook and set the fallback to '{{oldValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.\",\n      \"errorWithNoRecommendation\": \"The '{{oldValue}}' design token is deprecated. For more info, see the New Global Styling Hook Guidance on lightningdesignsystem.com.\"\n    }\n  },\n  \"no-sldshook-fallback-for-lwctoken\": {\n    \"description\": \"Avoid using --slds styling hooks as fallback values for --lwc tokens.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-sldshook-fallback-for-lwctoken\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"unsupportedFallback\": \"Remove the {{sldsToken}} styling hook that is used as a fallback value for {{lwcToken}}.\"\n    }\n  },\n  \"no-unsupported-hooks-slds2\": {\n    \"description\": \"Identifies styling hooks that aren't present in SLDS 2. They must be replaced with styling hooks that have a similar effect, or they must be removed.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-unsupported-hooks-slds2\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecated\": \"The {{token}} styling hook isn't present in SLDS 2 and there's no equivalent replacement. Remove it or replace it with a styling hook with a similar effect.\"\n    }\n  },\n  \"no-slds-var-without-fallback\": {\n    \"description\": \"Add fallback values to SLDS styling hooks. The fallback values are used in Salesforce environments where styling hooks are unavailable.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-var-without-fallback\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"varWithoutFallback\": \"Your code uses the {{cssVar}} styling hook without a fallback value. Styling hooks are unavailable in some Salesforce environments. To render your component correctly in all environments, add this fallback value: var({{cssVar}}, {{recommendation}}). To make this fallback value brand-aware, use a branded design token instead of a static value. See Design Tokens on v1.lightningdesignsystem.com.\"\n    }\n  },\n  \"no-slds-namespace-for-custom-hooks\": {\n    \"description\": \"To differentiate custom styling hooks from SLDS styling hooks, create custom styling hooks in your namespace.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-namespace-for-custom-hooks\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"customHookNamespace\": \"Using the --slds namespace for {{token}} isn't supported. Create the custom styling hook in your namespace. Example: --myapp-{{tokenWithoutNamespace}}\"\n    }\n  },\n  \"no-slds-private-var\": {\n    \"description\": \"Some SLDS styling hooks are private and reserved only for internal Salesforce use. Private SLDS styling hooks have prefixes --_slds- and --slds-s-. For more information, look up private CSS in lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-private-var\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"privateVar\": \"This styling hook is reserved for internal Salesforce use. Remove the --_slds- or \u2013slds-s private variable within selector {{prop}}. For more information, look up private CSS in lightningdesignsystem.com.\"\n    }\n  },\n  \"enforce-component-hook-naming-convention\": {\n    \"description\": \"Replace component styling hooks that use a deprecated naming convention.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-component-hook-naming-convention\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"replace\": \"Replace the deprecated {{oldValue}} component styling hook with {{suggestedMatch}}.\"\n    }\n  },\n  \"no-hardcoded-values-slds1\": {\n    \"description\": \"Replace static values with SLDS 1 design tokens. For more information, look up design tokens on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-value\",\n    \"type\": \"suggestion\",\n    \"messages\": {\n      \"hardcodedValue\": \"Replace the {{oldValue}} static value with an SLDS 1 styling hook: {{newValue}}.\",\n      \"noReplacement\": \"There's no replacement styling hook for the {{oldValue}} static value. Remove the static value.\"\n    }\n  },\n  \"no-hardcoded-values-slds2\": {\n    \"description\": \"Replace static values with SLDS 2 styling hooks. For more information, look up design tokens on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-values-slds2\",\n    \"type\": \"suggestion\",\n    \"messages\": {\n      \"hardcodedValue\": \"Consider replacing the {{oldValue}} static value with an SLDS 2 styling hook that has a similar value: {{newValue}}.\",\n      \"noReplacement\": \"There's no replacement styling hook for the {{oldValue}} static value. Remove the static value.\"\n    }\n  },\n  \"reduce-annotations\": {\n    \"description\": \"Remove your annotations and update your code.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#reduce-annotations\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"removeAnnotation\": \"Remove this annotation and update the code to SLDS best practices. For help, file an issue at https://github.com/salesforce-ux/slds-linter/\"\n    }\n  }\n};", "import { Rule } from 'eslint';\nimport metadata from '@salesforce-ux/sds-metadata';\nimport ruleMessages from '../../config/rule-messages.yml';\n\nconst ruleConfig = ruleMessages['no-sldshook-fallback-for-lwctoken'];\nconst { type, description, url, messages } = ruleConfig;\n\nconst sldsPlusStylingHooks = metadata.sldsPlusStylingHooks;\n\n// Generate values to hooks mapping using only global hooks\n// shared hooks are private/ undocumented APIs, so they should not be recommended to customers\n// Ref this thread: https://salesforce-internal.slack.com/archives/C071J0Q3FNV/p1743010620921339?thread_ts=1743009353.385429&cid=C071J0Q3FNV\nconst allSldsHooks = [...sldsPlusStylingHooks.global, ...sldsPlusStylingHooks.component];\nconst allSldsHooksSet = new Set(allSldsHooks);\n\n/**\n * Check if using an SLDS hook as fallback for LWC token is unsupported\n */\nfunction hasUnsupportedFallback(lwcToken: string, sldsToken: string): boolean {\n  // Convert --sds- to --slds- if needed\n  const normalizedSldsToken = sldsToken.replace('--sds-', '--slds-');\n  \n  return lwcToken.startsWith('--lwc-') \n    && normalizedSldsToken.startsWith('--slds-') \n    && allSldsHooksSet.has(normalizedSldsToken);\n}\n\nexport default {\n  meta: {\n    type,\n    docs: {\n      description,\n      recommended: true,\n      url,\n    },\n    messages,\n  },\n  \n  create(context) {\n    return {\n      // Handle LWC tokens inside var() functions: var(--lwc-*, ...)\n      \"Function[name='var'] Identifier[name=/^--lwc-/]\"(node) {\n        const lwcToken = node.name;\n        \n        // Get the var() function node that contains this identifier\n        const varFunctionNode = context.sourceCode.getAncestors(node).at(-1);\n        if (!varFunctionNode) return;\n        \n        //access children to find fallback\n        const varFunctionChildren = (varFunctionNode as any).children;\n        if (!varFunctionChildren) return;\n        \n        // Find comma operator and the Raw node after it\n        let foundComma = false;\n        let fallbackRawNode = null;\n        \n        for (const child of varFunctionChildren) {\n          if (child.type === 'Operator' && child.value === ',') {\n            foundComma = true;\n            continue;\n          }\n          if (foundComma && child.type === 'Raw') {\n            fallbackRawNode = child;\n            break;\n          }\n        }\n        \n        if (!fallbackRawNode) return;\n        \n        // Extract SLDS token from the Raw node value\n        const fallbackValue = fallbackRawNode.value.trim();\n        const varMatch = fallbackValue.match(/var\\(([^,)]+)/);\n        if (!varMatch) return;\n        \n        const sldsToken = varMatch[1];\n        \n        if (hasUnsupportedFallback(lwcToken, sldsToken)) {\n          context.report({\n            node,\n            messageId: 'unsupportedFallback',\n            data: { lwcToken, sldsToken }\n          });\n        }\n      }\n    };\n  },\n} as Rule.RuleModule;\n"],
-  "mappings": "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",
+  "sourcesContent": ["module.exports = {\n  \"no-slds-class-overrides\": {\n    \"description\": \"Create new custom CSS classes instead of overriding SLDS selectors\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-class-overrides\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"sldsClassOverride\": \"Overriding .{{className}} isn't supported. To differentiate SLDS and custom classes, create a CSS class in your namespace. Examples: myapp-input, myapp-button.\"\n    }\n  },\n  \"no-deprecated-slds-classes\": {\n    \"description\": \"Please replace the deprecated classes with a modern equivalent\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-slds-classes\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedClass\": \"The class {{className}} is deprecated and not available in SLDS2. Please update to a supported class.\"\n    }\n  },\n  \"no-deprecated-tokens-slds1\": {\n    \"description\": \"Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-tokens-slds1\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedToken\": \"Consider removing {{oldValue}} or replacing it with {{newValue}}. Set the fallback to {{oldValue}}. For more info, see Styling Hooks on lightningdesignsystem.com.\",\n      \"noReplacement\": \"Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.\"\n    }\n  },\n  \"enforce-sds-to-slds-hooks\": {\n    \"description\": \"Convert your existing --sds styling hooks to --slds styling hooks. See lightningdesignsystem.com for more info.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-sds-to-slds-hooks\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"replaceSdsWithSlds\": \"Replace {{oldValue}} with {{suggestedMatch}} styling hook.\"\n    }\n  },\n  \"enforce-bem-usage\": {\n    \"description\": \"Replace BEM double-dash syntax in class names with single underscore syntax\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-bem-usage\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"bemDoubleDash\": \"{{actual}} has been retired. Update it to the new name {{newValue}}.\",\n      \"fixBemNaming\": \"Update to correct BEM naming convention\"\n    }\n  },\n  \"modal-close-button-issue\": {\n    \"description\": \"Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#modal-close-button-issue\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"modalCloseButtonIssue\": \"Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint.\",\n      \"removeClass\": \"Remove the slds-button_icon-inverse class from the modal close button in components that use the SLDS modal blueprint.\",\n      \"changeVariant\": \"Change the variant attribute value from bare-inverse to bare in <lightning-button-icon> or <lightning-icon>.\",\n      \"removeVariant\": \"Remove the variant attribute from the <lightning-icon> component inside the <button> element.\",\n      \"ensureButtonClasses\": \"Add or move slds-button and slds-button_icon to the class attribute of the <button> element or <lightning-button-icon> component.\",\n      \"ensureSizeAttribute\": \"To size icons properly, set the size attribute \u200Cto large in the <lightning-icon> and <lightning-button-icon> components.\"\n    }\n  },\n  \"no-deprecated-classes-slds2\": {\n    \"description\": \"Replace classes that aren't available with SLDS 2 classes\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-classes-slds2\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedClass\": \"The class {{className}} isn't available in SLDS 2. Update it to a class supported in SLDS 2. See lightningdesignsystem.com for more information.\",\n      \"updateToModernClass\": \"Replace deprecated class with modern equivalent\",\n      \"checkDocumentation\": \"See lightningdesignsystem.com for SLDS 2 class alternatives\"\n    }\n  },\n  \"lwc-token-to-slds-hook\": {\n    \"description\": \"Replace the deprecated --lwc tokens with the latest --slds tokens. See lightningdesignsystem.com for more info.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#lwc-token-to-slds-hook\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"errorWithReplacement\": \"The '{{oldValue}}' design token is deprecated. Replace it with '{{newValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.\",\n      \"errorWithStyleHooks\": \"The '{{oldValue}}' design token is deprecated. Replace it with the SLDS 2 '{{newValue}}' styling hook and set the fallback to '{{oldValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.\",\n      \"errorWithNoRecommendation\": \"The '{{oldValue}}' design token is deprecated. For more info, see the New Global Styling Hook Guidance on lightningdesignsystem.com.\"\n    }\n  },\n  \"no-sldshook-fallback-for-lwctoken\": {\n    \"description\": \"Avoid using --slds styling hooks as fallback values for --lwc tokens.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-sldshook-fallback-for-lwctoken\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"unsupportedFallback\": \"Remove the {{sldsToken}} styling hook that is used as a fallback value for {{lwcToken}}.\"\n    }\n  },\n  \"no-unsupported-hooks-slds2\": {\n    \"description\": \"Identifies styling hooks that aren't present in SLDS 2. They must be replaced with styling hooks that have a similar effect, or they must be removed.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-unsupported-hooks-slds2\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecated\": \"The {{token}} styling hook isn't present in SLDS 2 and there's no equivalent replacement. Remove it or replace it with a styling hook with a similar effect.\"\n    }\n  },\n  \"no-slds-var-without-fallback\": {\n    \"description\": \"Add fallback values to SLDS styling hooks. The fallback values are used in Salesforce environments where styling hooks are unavailable.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-var-without-fallback\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"varWithoutFallback\": \"Your code uses the {{cssVar}} styling hook without a fallback value. Styling hooks are unavailable in some Salesforce environments. To render your component correctly in all environments, add this fallback value: var({{cssVar}}, {{recommendation}}). To make this fallback value brand-aware, use a branded design token instead of a static value. See Design Tokens on v1.lightningdesignsystem.com.\"\n    }\n  },\n  \"no-slds-namespace-for-custom-hooks\": {\n    \"description\": \"To differentiate custom styling hooks from SLDS styling hooks, create custom styling hooks in your namespace.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-namespace-for-custom-hooks\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"customHookNamespace\": \"Using the --slds namespace for {{token}} isn't supported. Create the custom styling hook in your namespace. Example: --myapp-{{tokenWithoutNamespace}}\"\n    }\n  },\n  \"no-slds-private-var\": {\n    \"description\": \"Some SLDS styling hooks are private and reserved only for internal Salesforce use. Private SLDS styling hooks have prefixes --_slds- and --slds-s-. For more information, look up private CSS in lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-private-var\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"privateVar\": \"This styling hook is reserved for internal Salesforce use. Remove the --_slds- or \u2013slds-s private variable within selector {{prop}}. For more information, look up private CSS in lightningdesignsystem.com.\"\n    }\n  },\n  \"enforce-component-hook-naming-convention\": {\n    \"description\": \"Replace component styling hooks that use a deprecated naming convention.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-component-hook-naming-convention\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"replace\": \"Replace the deprecated {{oldValue}} component styling hook with {{suggestedMatch}}.\"\n    }\n  },\n  \"no-hardcoded-values-slds1\": {\n    \"description\": \"Replace static values with SLDS 1 design tokens. For more information, look up design tokens on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-value\",\n    \"type\": \"suggestion\",\n    \"messages\": {\n      \"hardcodedValue\": \"Replace the {{oldValue}} static value with an SLDS 1 styling hook: {{newValue}}.\",\n      \"noReplacement\": \"There's no replacement styling hook for the {{oldValue}} static value. Remove the static value.\"\n    }\n  },\n  \"no-hardcoded-values-slds2\": {\n    \"description\": \"Replace static values with SLDS 2 styling hooks. For more information, look up design tokens on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-values-slds2\",\n    \"type\": \"suggestion\",\n    \"messages\": {\n      \"hardcodedValue\": \"Consider replacing the {{oldValue}} static value with an SLDS 2 styling hook that has a similar value: {{newValue}}.\",\n      \"noReplacement\": \"There's no replacement styling hook for the {{oldValue}} static value. Remove the static value.\"\n    }\n  },\n  \"reduce-annotations\": {\n    \"description\": \"Remove your annotations and update your code.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#reduce-annotations\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"removeAnnotation\": \"Remove this annotation and update the code to SLDS best practices. For help, file an issue at https://github.com/salesforce-ux/slds-linter/\"\n    }\n  }\n};", "import { Rule } from 'eslint';\nimport metadata from '@salesforce-ux/sds-metadata/next';\nimport ruleMessages from '../../config/rule-messages.yml';\n\nconst ruleConfig = ruleMessages['no-sldshook-fallback-for-lwctoken'];\nconst { type, description, url, messages } = ruleConfig;\n\nconst sldsPlusStylingHooks = metadata.sldsPlusStylingHooks;\n\n// Generate values to hooks mapping using only global hooks\n// shared hooks are private/ undocumented APIs, so they should not be recommended to customers\n// Ref this thread: https://salesforce-internal.slack.com/archives/C071J0Q3FNV/p1743010620921339?thread_ts=1743009353.385429&cid=C071J0Q3FNV\nconst allSldsHooks = [...sldsPlusStylingHooks.global, ...sldsPlusStylingHooks.component];\nconst allSldsHooksSet = new Set(allSldsHooks);\n\n/**\n * Check if using an SLDS hook as fallback for LWC token is unsupported\n */\nfunction hasUnsupportedFallback(lwcToken: string, sldsToken: string): boolean {\n  // Convert --sds- to --slds- if needed\n  const normalizedSldsToken = sldsToken.replace('--sds-', '--slds-');\n  \n  return lwcToken.startsWith('--lwc-') \n    && normalizedSldsToken.startsWith('--slds-') \n    && allSldsHooksSet.has(normalizedSldsToken);\n}\n\nexport default {\n  meta: {\n    type,\n    docs: {\n      description,\n      recommended: true,\n      url,\n    },\n    messages,\n  },\n  \n  create(context) {\n    return {\n      // Handle LWC tokens inside var() functions: var(--lwc-*, ...)\n      \"Function[name='var'] Identifier[name=/^--lwc-/]\"(node) {\n        const lwcToken = node.name;\n        \n        // Get the var() function node that contains this identifier\n        const varFunctionNode = context.sourceCode.getAncestors(node).at(-1);\n        if (!varFunctionNode) return;\n        \n        //access children to find fallback\n        const varFunctionChildren = (varFunctionNode as any).children;\n        if (!varFunctionChildren) return;\n        \n        // Find comma operator and the Raw node after it\n        let foundComma = false;\n        let fallbackRawNode = null;\n        \n        for (const child of varFunctionChildren) {\n          if (child.type === 'Operator' && child.value === ',') {\n            foundComma = true;\n            continue;\n          }\n          if (foundComma && child.type === 'Raw') {\n            fallbackRawNode = child;\n            break;\n          }\n        }\n        \n        if (!fallbackRawNode) return;\n        \n        // Extract SLDS token from the Raw node value\n        const fallbackValue = fallbackRawNode.value.trim();\n        const varMatch = fallbackValue.match(/var\\(([^,)]+)/);\n        if (!varMatch) return;\n        \n        const sldsToken = varMatch[1];\n        \n        if (hasUnsupportedFallback(lwcToken, sldsToken)) {\n          context.report({\n            node,\n            messageId: 'unsupportedFallback',\n            data: { lwcToken, sldsToken }\n          });\n        }\n      }\n    };\n  },\n} as Rule.RuleModule;\n"],
+  "mappings": "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",
   "names": ["exports", "module", "ruleMessages", "metadata"]
 }

package/build/rules/v9/no-unsupported-hooks-slds2.js

@@ -192,11 +192,11 @@ __export(no_unsupported_hooks_slds2_exports, {
   default: () => no_unsupported_hooks_slds2_default
 });
 module.exports = __toCommonJS(no_unsupported_hooks_slds2_exports);
-var import_sds_metadata = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages = __toESM(require_rule_messages());
 var ruleConfig = import_rule_messages.default["no-unsupported-hooks-slds2"];
 var { type, description, url, messages } = ruleConfig;
-var deprecatedHooks = new Set(import_sds_metadata.default.deprecatedStylingHooks);
+var deprecatedHooks = new Set(import_next.default.deprecatedStylingHooks);
 function shouldIgnoreDetection(sldsHook) {
   return !deprecatedHooks.has(sldsHook);
 }

package/build/rules/v9/no-unsupported-hooks-slds2.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["yaml-file:rule-messages.yml", "../../../src/rules/v9/no-unsupported-hooks-slds2.ts"],
-  "sourcesContent": ["module.exports = {\n  \"no-slds-class-overrides\": {\n    \"description\": \"Create new custom CSS classes instead of overriding SLDS selectors\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-class-overrides\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"sldsClassOverride\": \"Overriding .{{className}} isn't supported. To differentiate SLDS and custom classes, create a CSS class in your namespace. Examples: myapp-input, myapp-button.\"\n    }\n  },\n  \"no-deprecated-slds-classes\": {\n    \"description\": \"Please replace the deprecated classes with a modern equivalent\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-slds-classes\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedClass\": \"The class {{className}} is deprecated and not available in SLDS2. Please update to a supported class.\"\n    }\n  },\n  \"no-deprecated-tokens-slds1\": {\n    \"description\": \"Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-tokens-slds1\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedToken\": \"Consider removing {{oldValue}} or replacing it with {{newValue}}. Set the fallback to {{oldValue}}. For more info, see Styling Hooks on lightningdesignsystem.com.\",\n      \"noReplacement\": \"Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.\"\n    }\n  },\n  \"enforce-sds-to-slds-hooks\": {\n    \"description\": \"Convert your existing --sds styling hooks to --slds styling hooks. See lightningdesignsystem.com for more info.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-sds-to-slds-hooks\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"replaceSdsWithSlds\": \"Replace {{oldValue}} with {{suggestedMatch}} styling hook.\"\n    }\n  },\n  \"enforce-bem-usage\": {\n    \"description\": \"Replace BEM double-dash syntax in class names with single underscore syntax\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-bem-usage\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"bemDoubleDash\": \"{{actual}} has been retired. Update it to the new name {{newValue}}.\",\n      \"fixBemNaming\": \"Update to correct BEM naming convention\"\n    }\n  },\n  \"modal-close-button-issue\": {\n    \"description\": \"Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#modal-close-button-issue\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"modalCloseButtonIssue\": \"Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint.\",\n      \"removeClass\": \"Remove the slds-button_icon-inverse class from the modal close button in components that use the SLDS modal blueprint.\",\n      \"changeVariant\": \"Change the variant attribute value from bare-inverse to bare in <lightning-button-icon> or <lightning-icon>.\",\n      \"removeVariant\": \"Remove the variant attribute from the <lightning-icon> component inside the <button> element.\",\n      \"ensureButtonClasses\": \"Add or move slds-button and slds-button_icon to the class attribute of the <button> element or <lightning-button-icon> component.\",\n      \"ensureSizeAttribute\": \"To size icons properly, set the size attribute \u200Cto large in the <lightning-icon> and <lightning-button-icon> components.\"\n    }\n  },\n  \"no-deprecated-classes-slds2\": {\n    \"description\": \"Replace classes that aren't available with SLDS 2 classes\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-classes-slds2\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedClass\": \"The class {{className}} isn't available in SLDS 2. Update it to a class supported in SLDS 2. See lightningdesignsystem.com for more information.\",\n      \"updateToModernClass\": \"Replace deprecated class with modern equivalent\",\n      \"checkDocumentation\": \"See lightningdesignsystem.com for SLDS 2 class alternatives\"\n    }\n  },\n  \"lwc-token-to-slds-hook\": {\n    \"description\": \"Replace the deprecated --lwc tokens with the latest --slds tokens. See lightningdesignsystem.com for more info.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#lwc-token-to-slds-hook\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"errorWithReplacement\": \"The '{{oldValue}}' design token is deprecated. Replace it with '{{newValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.\",\n      \"errorWithStyleHooks\": \"The '{{oldValue}}' design token is deprecated. Replace it with the SLDS 2 '{{newValue}}' styling hook and set the fallback to '{{oldValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.\",\n      \"errorWithNoRecommendation\": \"The '{{oldValue}}' design token is deprecated. For more info, see the New Global Styling Hook Guidance on lightningdesignsystem.com.\"\n    }\n  },\n  \"no-sldshook-fallback-for-lwctoken\": {\n    \"description\": \"Avoid using --slds styling hooks as fallback values for --lwc tokens.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-sldshook-fallback-for-lwctoken\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"unsupportedFallback\": \"Remove the {{sldsToken}} styling hook that is used as a fallback value for {{lwcToken}}.\"\n    }\n  },\n  \"no-unsupported-hooks-slds2\": {\n    \"description\": \"Identifies styling hooks that aren't present in SLDS 2. They must be replaced with styling hooks that have a similar effect, or they must be removed.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-unsupported-hooks-slds2\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecated\": \"The {{token}} styling hook isn't present in SLDS 2 and there's no equivalent replacement. Remove it or replace it with a styling hook with a similar effect.\"\n    }\n  },\n  \"no-slds-var-without-fallback\": {\n    \"description\": \"Add fallback values to SLDS styling hooks. The fallback values are used in Salesforce environments where styling hooks are unavailable.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-var-without-fallback\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"varWithoutFallback\": \"Your code uses the {{cssVar}} styling hook without a fallback value. Styling hooks are unavailable in some Salesforce environments. To render your component correctly in all environments, add this fallback value: var({{cssVar}}, {{recommendation}}). To make this fallback value brand-aware, use a branded design token instead of a static value. See Design Tokens on v1.lightningdesignsystem.com.\"\n    }\n  },\n  \"no-slds-namespace-for-custom-hooks\": {\n    \"description\": \"To differentiate custom styling hooks from SLDS styling hooks, create custom styling hooks in your namespace.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-namespace-for-custom-hooks\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"customHookNamespace\": \"Using the --slds namespace for {{token}} isn't supported. Create the custom styling hook in your namespace. Example: --myapp-{{tokenWithoutNamespace}}\"\n    }\n  },\n  \"no-slds-private-var\": {\n    \"description\": \"Some SLDS styling hooks are private and reserved only for internal Salesforce use. Private SLDS styling hooks have prefixes --_slds- and --slds-s-. For more information, look up private CSS in lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-private-var\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"privateVar\": \"This styling hook is reserved for internal Salesforce use. Remove the --_slds- or \u2013slds-s private variable within selector {{prop}}. For more information, look up private CSS in lightningdesignsystem.com.\"\n    }\n  },\n  \"enforce-component-hook-naming-convention\": {\n    \"description\": \"Replace component styling hooks that use a deprecated naming convention.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-component-hook-naming-convention\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"replace\": \"Replace the deprecated {{oldValue}} component styling hook with {{suggestedMatch}}.\"\n    }\n  },\n  \"no-hardcoded-values-slds1\": {\n    \"description\": \"Replace static values with SLDS 1 design tokens. For more information, look up design tokens on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-value\",\n    \"type\": \"suggestion\",\n    \"messages\": {\n      \"hardcodedValue\": \"Replace the {{oldValue}} static value with an SLDS 1 styling hook: {{newValue}}.\",\n      \"noReplacement\": \"There's no replacement styling hook for the {{oldValue}} static value. Remove the static value.\"\n    }\n  },\n  \"no-hardcoded-values-slds2\": {\n    \"description\": \"Replace static values with SLDS 2 styling hooks. For more information, look up design tokens on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-values-slds2\",\n    \"type\": \"suggestion\",\n    \"messages\": {\n      \"hardcodedValue\": \"Consider replacing the {{oldValue}} static value with an SLDS 2 styling hook that has a similar value: {{newValue}}.\",\n      \"noReplacement\": \"There's no replacement styling hook for the {{oldValue}} static value. Remove the static value.\"\n    }\n  },\n  \"reduce-annotations\": {\n    \"description\": \"Remove your annotations and update your code.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#reduce-annotations\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"removeAnnotation\": \"Remove this annotation and update the code to SLDS best practices. For help, file an issue at https://github.com/salesforce-ux/slds-linter/\"\n    }\n  }\n};", "import { Rule } from 'eslint';\nimport metadata from '@salesforce-ux/sds-metadata';\nimport ruleMessages from '../../config/rule-messages.yml';\n\nconst ruleConfig = ruleMessages['no-unsupported-hooks-slds2'];\nconst { type, description, url, messages } = ruleConfig;\n\nconst deprecatedHooks = new Set(metadata.deprecatedStylingHooks);\n\nfunction shouldIgnoreDetection(sldsHook: string): boolean {\n  return !deprecatedHooks.has(sldsHook);\n}\n\nexport default {\n  meta: {\n    type,\n    docs: {\n      description,\n      recommended: true,\n      url,\n    },\n    messages,\n  },\n  \n  create(context) {\n    function reportDeprecatedHook(node, token: string) {\n      context.report({\n        node,\n        messageId: 'deprecated',\n        data: { token }\n      });\n    }\n\n    return {\n      // Handle CSS custom property declarations (left-side usage): --slds-* properties\n      // Example: .THIS { --slds-g-link-color: #f73650; }\n      \"Declaration[property=/^--s(lds|ds)-/]\"(node) {\n        const property = node.property;\n        \n        if (shouldIgnoreDetection(property)) {\n          return;\n        }\n        \n        reportDeprecatedHook(node, property);\n      },\n\n      // Handle SLDS/SDS hooks inside var() functions (right-side usage): var(--slds-*)\n      // Example: .THIS .demo { border-top: 1px solid var(--slds-g-color-border-brand-1); }\n      \"Function[name='var'] Identifier[name=/^--s(lds|ds)-/]\"(node) {\n        const tokenName = node.name;\n        \n        if (shouldIgnoreDetection(tokenName)) {\n          return;\n        }\n        \n        reportDeprecatedHook(node, tokenName);\n      },\n    };\n  },\n} as Rule.RuleModule;\n"],
-  "mappings": "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",
+  "sourcesContent": ["module.exports = {\n  \"no-slds-class-overrides\": {\n    \"description\": \"Create new custom CSS classes instead of overriding SLDS selectors\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-class-overrides\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"sldsClassOverride\": \"Overriding .{{className}} isn't supported. To differentiate SLDS and custom classes, create a CSS class in your namespace. Examples: myapp-input, myapp-button.\"\n    }\n  },\n  \"no-deprecated-slds-classes\": {\n    \"description\": \"Please replace the deprecated classes with a modern equivalent\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-slds-classes\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedClass\": \"The class {{className}} is deprecated and not available in SLDS2. Please update to a supported class.\"\n    }\n  },\n  \"no-deprecated-tokens-slds1\": {\n    \"description\": \"Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-tokens-slds1\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedToken\": \"Consider removing {{oldValue}} or replacing it with {{newValue}}. Set the fallback to {{oldValue}}. For more info, see Styling Hooks on lightningdesignsystem.com.\",\n      \"noReplacement\": \"Update outdated design tokens to SLDS 2 styling hooks with similar values. For more information, see Styling Hooks on lightningdesignsystem.com.\"\n    }\n  },\n  \"enforce-sds-to-slds-hooks\": {\n    \"description\": \"Convert your existing --sds styling hooks to --slds styling hooks. See lightningdesignsystem.com for more info.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-sds-to-slds-hooks\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"replaceSdsWithSlds\": \"Replace {{oldValue}} with {{suggestedMatch}} styling hook.\"\n    }\n  },\n  \"enforce-bem-usage\": {\n    \"description\": \"Replace BEM double-dash syntax in class names with single underscore syntax\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-bem-usage\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"bemDoubleDash\": \"{{actual}} has been retired. Update it to the new name {{newValue}}.\",\n      \"fixBemNaming\": \"Update to correct BEM naming convention\"\n    }\n  },\n  \"modal-close-button-issue\": {\n    \"description\": \"Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#modal-close-button-issue\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"modalCloseButtonIssue\": \"Update component attributes or CSS classes for the modal close button to comply with the modal component blueprint.\",\n      \"removeClass\": \"Remove the slds-button_icon-inverse class from the modal close button in components that use the SLDS modal blueprint.\",\n      \"changeVariant\": \"Change the variant attribute value from bare-inverse to bare in <lightning-button-icon> or <lightning-icon>.\",\n      \"removeVariant\": \"Remove the variant attribute from the <lightning-icon> component inside the <button> element.\",\n      \"ensureButtonClasses\": \"Add or move slds-button and slds-button_icon to the class attribute of the <button> element or <lightning-button-icon> component.\",\n      \"ensureSizeAttribute\": \"To size icons properly, set the size attribute \u200Cto large in the <lightning-icon> and <lightning-button-icon> components.\"\n    }\n  },\n  \"no-deprecated-classes-slds2\": {\n    \"description\": \"Replace classes that aren't available with SLDS 2 classes\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-deprecated-classes-slds2\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecatedClass\": \"The class {{className}} isn't available in SLDS 2. Update it to a class supported in SLDS 2. See lightningdesignsystem.com for more information.\",\n      \"updateToModernClass\": \"Replace deprecated class with modern equivalent\",\n      \"checkDocumentation\": \"See lightningdesignsystem.com for SLDS 2 class alternatives\"\n    }\n  },\n  \"lwc-token-to-slds-hook\": {\n    \"description\": \"Replace the deprecated --lwc tokens with the latest --slds tokens. See lightningdesignsystem.com for more info.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#lwc-token-to-slds-hook\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"errorWithReplacement\": \"The '{{oldValue}}' design token is deprecated. Replace it with '{{newValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.\",\n      \"errorWithStyleHooks\": \"The '{{oldValue}}' design token is deprecated. Replace it with the SLDS 2 '{{newValue}}' styling hook and set the fallback to '{{oldValue}}'. For more info, see Global Styling Hooks on lightningdesignsystem.com.\",\n      \"errorWithNoRecommendation\": \"The '{{oldValue}}' design token is deprecated. For more info, see the New Global Styling Hook Guidance on lightningdesignsystem.com.\"\n    }\n  },\n  \"no-sldshook-fallback-for-lwctoken\": {\n    \"description\": \"Avoid using --slds styling hooks as fallback values for --lwc tokens.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-sldshook-fallback-for-lwctoken\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"unsupportedFallback\": \"Remove the {{sldsToken}} styling hook that is used as a fallback value for {{lwcToken}}.\"\n    }\n  },\n  \"no-unsupported-hooks-slds2\": {\n    \"description\": \"Identifies styling hooks that aren't present in SLDS 2. They must be replaced with styling hooks that have a similar effect, or they must be removed.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-unsupported-hooks-slds2\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"deprecated\": \"The {{token}} styling hook isn't present in SLDS 2 and there's no equivalent replacement. Remove it or replace it with a styling hook with a similar effect.\"\n    }\n  },\n  \"no-slds-var-without-fallback\": {\n    \"description\": \"Add fallback values to SLDS styling hooks. The fallback values are used in Salesforce environments where styling hooks are unavailable.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-var-without-fallback\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"varWithoutFallback\": \"Your code uses the {{cssVar}} styling hook without a fallback value. Styling hooks are unavailable in some Salesforce environments. To render your component correctly in all environments, add this fallback value: var({{cssVar}}, {{recommendation}}). To make this fallback value brand-aware, use a branded design token instead of a static value. See Design Tokens on v1.lightningdesignsystem.com.\"\n    }\n  },\n  \"no-slds-namespace-for-custom-hooks\": {\n    \"description\": \"To differentiate custom styling hooks from SLDS styling hooks, create custom styling hooks in your namespace.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-namespace-for-custom-hooks\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"customHookNamespace\": \"Using the --slds namespace for {{token}} isn't supported. Create the custom styling hook in your namespace. Example: --myapp-{{tokenWithoutNamespace}}\"\n    }\n  },\n  \"no-slds-private-var\": {\n    \"description\": \"Some SLDS styling hooks are private and reserved only for internal Salesforce use. Private SLDS styling hooks have prefixes --_slds- and --slds-s-. For more information, look up private CSS in lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-slds-private-var\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"privateVar\": \"This styling hook is reserved for internal Salesforce use. Remove the --_slds- or \u2013slds-s private variable within selector {{prop}}. For more information, look up private CSS in lightningdesignsystem.com.\"\n    }\n  },\n  \"enforce-component-hook-naming-convention\": {\n    \"description\": \"Replace component styling hooks that use a deprecated naming convention.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#enforce-component-hook-naming-convention\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"replace\": \"Replace the deprecated {{oldValue}} component styling hook with {{suggestedMatch}}.\"\n    }\n  },\n  \"no-hardcoded-values-slds1\": {\n    \"description\": \"Replace static values with SLDS 1 design tokens. For more information, look up design tokens on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-value\",\n    \"type\": \"suggestion\",\n    \"messages\": {\n      \"hardcodedValue\": \"Replace the {{oldValue}} static value with an SLDS 1 styling hook: {{newValue}}.\",\n      \"noReplacement\": \"There's no replacement styling hook for the {{oldValue}} static value. Remove the static value.\"\n    }\n  },\n  \"no-hardcoded-values-slds2\": {\n    \"description\": \"Replace static values with SLDS 2 styling hooks. For more information, look up design tokens on lightningdesignsystem.com.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#no-hardcoded-values-slds2\",\n    \"type\": \"suggestion\",\n    \"messages\": {\n      \"hardcodedValue\": \"Consider replacing the {{oldValue}} static value with an SLDS 2 styling hook that has a similar value: {{newValue}}.\",\n      \"noReplacement\": \"There's no replacement styling hook for the {{oldValue}} static value. Remove the static value.\"\n    }\n  },\n  \"reduce-annotations\": {\n    \"description\": \"Remove your annotations and update your code.\",\n    \"url\": \"https://developer.salesforce.com/docs/platform/slds-linter/guide/reference-rules.html#reduce-annotations\",\n    \"type\": \"problem\",\n    \"messages\": {\n      \"removeAnnotation\": \"Remove this annotation and update the code to SLDS best practices. For help, file an issue at https://github.com/salesforce-ux/slds-linter/\"\n    }\n  }\n};", "import { Rule } from 'eslint';\nimport metadata from '@salesforce-ux/sds-metadata/next';\nimport ruleMessages from '../../config/rule-messages.yml';\n\nconst ruleConfig = ruleMessages['no-unsupported-hooks-slds2'];\nconst { type, description, url, messages } = ruleConfig;\n\nconst deprecatedHooks = new Set(metadata.deprecatedStylingHooks);\n\nfunction shouldIgnoreDetection(sldsHook: string): boolean {\n  return !deprecatedHooks.has(sldsHook);\n}\n\nexport default {\n  meta: {\n    type,\n    docs: {\n      description,\n      recommended: true,\n      url,\n    },\n    messages,\n  },\n  \n  create(context) {\n    function reportDeprecatedHook(node, token: string) {\n      context.report({\n        node,\n        messageId: 'deprecated',\n        data: { token }\n      });\n    }\n\n    return {\n      // Handle CSS custom property declarations (left-side usage): --slds-* properties\n      // Example: .THIS { --slds-g-link-color: #f73650; }\n      \"Declaration[property=/^--s(lds|ds)-/]\"(node) {\n        const property = node.property;\n        \n        if (shouldIgnoreDetection(property)) {\n          return;\n        }\n        \n        reportDeprecatedHook(node, property);\n      },\n\n      // Handle SLDS/SDS hooks inside var() functions (right-side usage): var(--slds-*)\n      // Example: .THIS .demo { border-top: 1px solid var(--slds-g-color-border-brand-1); }\n      \"Function[name='var'] Identifier[name=/^--s(lds|ds)-/]\"(node) {\n        const tokenName = node.name;\n        \n        if (shouldIgnoreDetection(tokenName)) {\n          return;\n        }\n        \n        reportDeprecatedHook(node, tokenName);\n      },\n    };\n  },\n} as Rule.RuleModule;\n"],
+  "mappings": "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",
   "names": ["exports", "module", "ruleMessages", "metadata"]
 }

package/build/src/rules/v9/no-hardcoded-values/ruleOptionsSchema.d.ts

@@ -0,0 +1,40 @@
+/**
+ * JSON Schema for no-hardcoded-values rule options
+ * Defines validation rules for reportNumericValue, customMapping, and preferPaletteHook
+ */
+export declare const ruleOptionsSchema: {
+    type: string;
+    properties: {
+        reportNumericValue: {
+            type: string;
+            enum: string[];
+            default: string;
+        };
+        customMapping: {
+            type: string;
+            additionalProperties: {
+                type: string;
+                properties: {
+                    properties: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    values: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                };
+                required: string[];
+            };
+        };
+        preferPaletteHook: {
+            type: string;
+            default: boolean;
+        };
+    };
+    additionalProperties: boolean;
+}[];

package/build/src/types/index.d.ts

@@ -1,5 +1,35 @@
 import { Rule } from 'eslint';
 import type { ValueToStylingHooksMapping } from '@salesforce-ux/sds-metadata';
+/**
+ * Custom mapping for hook replacements
+ * Maps hook names to their applicable properties and values
+ */
+export interface CustomHookMapping {
+    [hookName: string]: {
+        properties: string[];
+        values: string[];
+    };
+}
+/**
+ * Options for the no-hardcoded-values rule
+ */
+export interface RuleOptions {
+    /**
+     * Controls when to report hardcoded numeric values
+     * - 'never': Don't report hardcoded numeric values
+     * - 'always': Always report hardcoded numeric values (default)
+     * - 'hasReplacement': Only report when a replacement hook is available
+     */
+    reportNumericValue?: 'never' | 'always' | 'hasReplacement';
+    /**
+     * Custom mapping for pre-configured hook replacements
+     */
+    customMapping?: CustomHookMapping;
+    /**
+     * Prefer palette hooks when multiple replacements are available
+     */
+    preferPaletteHook?: boolean;
+}
 /**
  * Context interface for handlers to access necessary dependencies
  */
@@ -7,6 +37,7 @@ export interface HandlerContext {
     valueToStylinghook: ValueToStylingHooksMapping;
     context: Rule.RuleContext;
     sourceCode: any;
+    options?: RuleOptions;
 }
 /**
  * Configuration for creating the rule

package/build/src/utils/color-lib-utils.d.ts

@@ -1,18 +1,25 @@
 import { ValueToStylingHooksMapping } from '@salesforce-ux/sds-metadata';
-declare const isHardCodedColor: (color: string) => boolean;
-declare const isHexCode: (color: string) => boolean;
+/**
+ * Convert any valid CSS color (named, hex, rgb(a), hsl(a), etc.) to hex.
+ * Returns null if the value is not a valid color.
+ */
 declare const convertToHex: (color: string) => string | null;
+/**
+ * Given an input color and the metadata mapping of supported colors to hooks,
+ * suggest up to 5 styling hook names ordered by:
+ * 1) Category priority: semantic -> system -> palette
+ * 2) Perceptual distance (Delta E)
+ * Also prioritizes exact color matches (distance 0).
+ */
 declare const findClosestColorHook: (color: string, supportedColors: ValueToStylingHooksMapping, cssProperty: string) => string[];
 /**
- * This method is usefull to identify all possible css color values.
- *  - names colors
- *  - 6,8 digit hex
- *  - rgb and rgba
- *  - hsl and hsla
+ * Check if a value is any valid CSS color string (delegates to chroma-js).
  */
 declare const isValidColor: (val: string) => boolean;
 /**
- * Extract color value from CSS AST node
+ * Extract a color string from a CSS AST node produced by @eslint/css-tree.
+ * Supports Hash (#rrggbb), Identifier (named colors), and color Function nodes.
+ * Returns null if the extracted value is not a valid color.
  */
 declare const extractColorValue: (node: any) => string | null;
-export { findClosestColorHook, convertToHex, isHexCode, isHardCodedColor, isValidColor, extractColorValue };
+export { findClosestColorHook, convertToHex, isValidColor, extractColorValue };

package/build/src/utils/custom-mapping-utils.d.ts

@@ -0,0 +1,9 @@
+import type { CustomHookMapping } from '../types';
+/**
+ * Get custom hook mapping for a given CSS property and value
+ * @param cssProperty - The CSS property (e.g., "background-color", "color")
+ * @param value - The hardcoded value (e.g., "#fff", "16px")
+ * @param customMapping - The custom mapping configuration from rule options
+ * @returns The hook name if a mapping is found, null otherwise
+ */
+export declare function getCustomMapping(cssProperty: string, value: string, customMapping?: CustomHookMapping): string | null;

package/build/src/utils/hardcoded-shared-utils.d.ts

@@ -9,6 +9,7 @@ export interface ReplacementInfo {
     replacement: string;
     displayValue: string;
     hasHook: boolean;
+    isNumeric?: boolean;
 }
 /**
  * Position information from CSS tree parsing

package/build/src/utils/property-matcher.d.ts

@@ -20,4 +20,6 @@ export declare const densificationProperties: string[];
  * Handles wildcards (*) and creates proper ESLint CSS selector syntax
  */
 export declare function toSelector(properties: string[]): string;
-export declare function resolvePropertyToMatch(cssProperty: string): string;
+export declare function resolveDensityPropertyToMatch(cssProperty: string): string;
+export declare function resolveColorPropertyToMatch(cssProperty: string): string;
+export declare function isOutlineWidthProperty(propertyToMatch: string): propertyToMatch is "outline" | "outline-width";

package/build/types/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/types/index.ts"],
-  "sourcesContent": ["import { Rule } from 'eslint';\nimport type { ValueToStylingHooksMapping } from '@salesforce-ux/sds-metadata';\n\n/**\n * Context interface for handlers to access necessary dependencies\n */\nexport interface HandlerContext {\n  valueToStylinghook: ValueToStylingHooksMapping;\n  context: Rule.RuleContext;\n  sourceCode: any;\n}\n\n\n\n/**\n * Configuration for creating the rule\n */\nexport interface RuleConfig {\n  ruleConfig: {\n    type: 'problem' | 'suggestion' | 'layout';\n    description: string;\n    url?: string;\n    messages: Record<string, string>;\n  };\n  valueToStylinghook: ValueToStylingHooksMapping;\n}\n\n/**\n * Handler function signature for CSS declarations\n */\nexport type DeclarationHandler = (node: any, context: HandlerContext) => void;"],
+  "sourcesContent": ["import { Rule } from 'eslint';\nimport type { ValueToStylingHooksMapping } from '@salesforce-ux/sds-metadata/next';\n\n/**\n * Custom mapping for hook replacements\n * Maps hook names to their applicable properties and values\n */\nexport interface CustomHookMapping {\n  [hookName: string]: {\n    properties: string[];\n    values: string[];\n  };\n}\n\n/**\n * Options for the no-hardcoded-values rule\n */\nexport interface RuleOptions {\n  /**\n   * Controls when to report hardcoded numeric values\n   * - 'never': Don't report hardcoded numeric values\n   * - 'always': Always report hardcoded numeric values (default)\n   * - 'hasReplacement': Only report when a replacement hook is available\n   */\n  reportNumericValue?: 'never' | 'always' | 'hasReplacement';\n  \n  /**\n   * Custom mapping for pre-configured hook replacements\n   */\n  customMapping?: CustomHookMapping;\n  \n  /**\n   * Prefer palette hooks when multiple replacements are available\n   */\n  preferPaletteHook?: boolean;\n}\n\n/**\n * Context interface for handlers to access necessary dependencies\n */\nexport interface HandlerContext {\n  valueToStylinghook: ValueToStylingHooksMapping;\n  context: Rule.RuleContext;\n  sourceCode: any;\n  options?: RuleOptions;\n}\n\n\n\n/**\n * Configuration for creating the rule\n */\nexport interface RuleConfig {\n  ruleConfig: {\n    type: 'problem' | 'suggestion' | 'layout';\n    description: string;\n    url?: string;\n    messages: Record<string, string>;\n  };\n  valueToStylinghook: ValueToStylingHooksMapping;\n}\n\n/**\n * Handler function signature for CSS declarations\n */\nexport type DeclarationHandler = (node: any, context: HandlerContext) => void;"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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}"],
-  "mappings": "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",
+  "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", "import { ValueToStylingHooksMapping, ValueToStylingHookEntry } from '@salesforce-ux/sds-metadata/next';\nimport chroma from 'chroma-js';\nimport { generate } from '@eslint/css-tree';\nimport { isCssColorFunction } from './css-functions';\n\n/**\n * Perceptual color difference threshold (Delta E, CIEDE2000 via chroma.deltaE).\n * Lower values are stricter matches. Used to decide which hooks are \"close enough\".\n */\nconst DELTAE_THRESHOLD = 10;\n\n/**\n * Convert any valid CSS color (named, hex, rgb(a), hsl(a), etc.) to hex.\n * Returns null if the value is not a valid color.\n */\nconst convertToHex = (color: string): string | null => {\n  try {\n    // Try converting the color using chroma-js, which handles both named and hex colors\n    return chroma(color).hex();\n  } catch (e) {\n    // If chroma can't process the color, it's likely invalid\n    return null;\n  }\n};\n\nconst isHookPropertyMatch = (hook: ValueToStylingHookEntry, cssProperty: string): boolean => {\n  return hook.properties.includes(cssProperty) || hook.properties.includes(\"*\");\n}\n\nfunction getOrderByCssProp(cssProperty: string): string[] {\n  if(cssProperty === 'color' || cssProperty === 'fill') {\n      return [\"surface\", \"theme\",  \"feedback\", \"reference\"];\n  } else if(cssProperty.match(/background/)){\n     return [\"surface\", \"surface-inverse\", \"theme\",  \"feedback\", \"reference\"];\n  } else if(cssProperty.match(/border/) || cssProperty.match(/outline/) || cssProperty.match(/stroke/)) {\n      return [\"borders\", \"borders-inverse\", \"feedback\", \"theme\", \"reference\"];\n  }\n  return [\"surface\", \"surface-inverse\", \"borders\", \"borders-inverse\", \"theme\",  \"feedback\", \"reference\"];\n}\n\n\n/**\n * Given an input color and the metadata mapping of supported colors to hooks,\n * suggest up to 5 styling hook names ordered by:\n * 1) Category priority: semantic -> system -> palette\n * 2) Perceptual distance (Delta E)\n * Also prioritizes exact color matches (distance 0).\n */\nconst findClosestColorHook = (\n  color: string,\n  supportedColors:ValueToStylingHooksMapping,\n  cssProperty: string\n): string[] => {\n  const closestHooks: Array<{distance: number, group: string, name: string}> = [];\n  Object.entries(supportedColors).forEach(([sldsValue, data]) => {\n    if (sldsValue && isValidColor(sldsValue)) {\n      const hooks = data as ValueToStylingHookEntry[]; // Get the hooks for the sldsValue\n\n      hooks.forEach((hook) => {\n        // Exact match shortcut to avoid floating rounding noise\n        const distance = (sldsValue.toLowerCase() === color.toLowerCase())\n          ? 0\n          : chroma.deltaE(sldsValue, color);\n          \n        // Check if the hook has the same property or universal selector\n        if (isHookPropertyMatch(hook, cssProperty) && distance <= DELTAE_THRESHOLD) {\n          // Add to same property hooks if within threshold\n          closestHooks.push({ distance, group: hook.group, name: hook.name });\n        }\n      });\n    }\n  });\n\n  const hooksByGroupMap:Record<string, string[]> = closestHooks.sort((a, b) => a.distance - b.distance).reduce((acc, hook) => {\n    if (!acc[hook.group]) {\n      acc[hook.group] = [];\n    }\n    acc[hook.group].push(hook.name);\n    return acc;\n  }, {});\n\n  return getOrderByCssProp(cssProperty)\n    .map(group => hooksByGroupMap[group]||[])\n    .flat().slice(0, 5);\n};\n\n/**\n * Check if a value is any valid CSS color string (delegates to chroma-js).\n */\nconst isValidColor = (val:string):boolean => chroma.valid(val);\n\n/**\n * Extract a color string from a CSS AST node produced by @eslint/css-tree.\n * Supports Hash (#rrggbb), Identifier (named colors), and color Function nodes.\n * Returns null if the extracted value is not a valid color.\n */\nconst extractColorValue = (node: any): string | null => {\n  let colorValue: string | null = null;\n  \n  switch (node.type) {\n    case 'Hash':\n      colorValue = `#${node.value}`;\n      break;\n    case 'Identifier':\n      colorValue = node.name;\n      break;\n    case 'Function':\n      // Only extract color functions\n      if (isCssColorFunction(node.name)) {\n        colorValue = generate(node);\n      }\n      break;\n  }\n  \n  return colorValue && isValidColor(colorValue) ? colorValue : null;\n};\n\nexport { findClosestColorHook, convertToHex, isValidColor, extractColorValue };\n", "//stylelint-sds/packages/stylelint-plugin-slds/src/utils/css-functions.ts\n/**\n * Complete list of CSS functions that should be preserved/recognized\n */\nconst CSS_FUNCTIONS = [\n    'attr',\n    'calc',\n    'color-mix',\n    'conic-gradient',\n    'counter',\n    'cubic-bezier',\n    'linear-gradient',\n    'max',\n    'min',\n    'radial-gradient',\n    'repeating-conic-gradient',\n    'repeating-linear-gradient',\n    'repeating-radial-gradient',\n    'var'\n  ];\n  \n  \n  const CSS_MATH_FUNCTIONS = ['calc', 'min', 'max'];\n  \n  \n  const RGB_COLOR_FUNCTIONS = ['rgb', 'rgba', 'hsl', 'hsla'];\n  \n  /**\n   * Regex for matching any CSS function (for general detection)\n   * Matches function names within other text\n   */\n  const cssFunctionsRegex = new RegExp(`(?:${CSS_FUNCTIONS.join('|')})`);\n  \n  \n  const cssFunctionsExactRegex = new RegExp(`^(?:${CSS_FUNCTIONS.join('|')})$`);\n  \n  \n  const cssMathFunctionsRegex = new RegExp(`^(?:${CSS_MATH_FUNCTIONS.join('|')})$`);\n  \n  export function containsCssFunction(value: string): boolean {\n    return cssFunctionsRegex.test(value);\n  }\n  \n  /**\n   * Check if a value is exactly a CSS function name\n   */\n  export function isCssFunction(value: string): boolean {\n    return cssFunctionsExactRegex.test(value);\n  }\n  \n  export function isCssMathFunction(value: string): boolean {\n    return cssMathFunctionsRegex.test(value);\n  }\n  \n  export function isCssColorFunction(value: string): boolean {\n    return RGB_COLOR_FUNCTIONS.includes(value);\n  }", "// 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

@@ -32,8 +32,6 @@ __export(color_lib_utils_exports, {
   convertToHex: () => convertToHex,
   extractColorValue: () => extractColorValue,
   findClosestColorHook: () => findClosestColorHook,
-  isHardCodedColor: () => isHardCodedColor,
-  isHexCode: () => isHexCode,
   isValidColor: () => isValidColor
 });
 module.exports = __toCommonJS(color_lib_utils_exports);
@@ -67,15 +65,7 @@ function isCssColorFunction(value) {
 }
 
 // src/utils/color-lib-utils.ts
-var LAB_THRESHOLD = 25;
-var isHardCodedColor = (color) => {
-  const colorRegex = /\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;
-  return colorRegex.test(color);
-};
-var isHexCode = (color) => {
-  const hexPattern = /^#(?:[0-9a-fA-F]{3}){1,2}$/;
-  return hexPattern.test(color);
-};
+var DELTAE_THRESHOLD = 10;
 var convertToHex = (color) => {
   try {
     return (0, import_chroma_js.default)(color).hex();
@@ -83,52 +73,40 @@ var convertToHex = (color) => {
     return null;
   }
 };
+var isHookPropertyMatch = (hook, cssProperty) => {
+  return hook.properties.includes(cssProperty) || hook.properties.includes("*");
+};
+function getOrderByCssProp(cssProperty) {
+  if (cssProperty === "color" || cssProperty === "fill") {
+    return ["surface", "theme", "feedback", "reference"];
+  } else if (cssProperty.match(/background/)) {
+    return ["surface", "surface-inverse", "theme", "feedback", "reference"];
+  } else if (cssProperty.match(/border/) || cssProperty.match(/outline/) || cssProperty.match(/stroke/)) {
+    return ["borders", "borders-inverse", "feedback", "theme", "reference"];
+  }
+  return ["surface", "surface-inverse", "borders", "borders-inverse", "theme", "feedback", "reference"];
+}
 var findClosestColorHook = (color, supportedColors, cssProperty) => {
-  const returnStylingHooks = [];
-  const closestHooksWithSameProperty = [];
-  const closestHooksWithoutSameProperty = [];
-  const closestHooksWithAllProperty = [];
-  const labColor = (0, import_chroma_js.default)(color).lab();
+  const closestHooks = [];
   Object.entries(supportedColors).forEach(([sldsValue, data]) => {
-    if (sldsValue && isHexCode(sldsValue)) {
+    if (sldsValue && isValidColor(sldsValue)) {
       const hooks = data;
       hooks.forEach((hook) => {
-        const labSupportedColor = (0, import_chroma_js.default)(sldsValue).lab();
-        const distance = JSON.stringify(labColor) === JSON.stringify(labSupportedColor) ? 0 : import_chroma_js.default.distance(import_chroma_js.default.lab(...labColor), import_chroma_js.default.lab(...labSupportedColor), "lab");
-        if (hook.properties.includes(cssProperty)) {
-          if (distance <= LAB_THRESHOLD) {
-            closestHooksWithSameProperty.push({ name: hook.name, distance });
-          }
-        } else if (hook.properties.includes("*")) {
-          if (distance <= LAB_THRESHOLD) {
-            closestHooksWithAllProperty.push({ name: hook.name, distance });
-          }
-        } else {
-          if (distance <= LAB_THRESHOLD) {
-            closestHooksWithoutSameProperty.push({ name: hook.name, distance });
-          }
+        const distance = sldsValue.toLowerCase() === color.toLowerCase() ? 0 : import_chroma_js.default.deltaE(sldsValue, color);
+        if (isHookPropertyMatch(hook, cssProperty) && distance <= DELTAE_THRESHOLD) {
+          closestHooks.push({ distance, group: hook.group, name: hook.name });
         }
       });
     }
   });
-  const closesthookGroups = [
-    { hooks: closestHooksWithSameProperty, distance: 0 },
-    { hooks: closestHooksWithAllProperty, distance: 0 },
-    { hooks: closestHooksWithSameProperty, distance: Infinity },
-    // For hooks with distance > 0
-    { hooks: closestHooksWithAllProperty, distance: Infinity },
-    { hooks: closestHooksWithoutSameProperty, distance: Infinity }
-  ];
-  for (const group of closesthookGroups) {
-    const filteredHooks = group.hooks.filter(
-      (h) => group.distance === 0 ? h.distance === 0 : h.distance > 0
-    );
-    if (returnStylingHooks.length < 1 && filteredHooks.length > 0) {
-      filteredHooks.sort((a, b) => a.distance - b.distance);
-      returnStylingHooks.push(...filteredHooks.slice(0, 5).map((h) => h.name));
+  const hooksByGroupMap = closestHooks.sort((a, b) => a.distance - b.distance).reduce((acc, hook) => {
+    if (!acc[hook.group]) {
+      acc[hook.group] = [];
     }
-  }
-  return Array.from(new Set(returnStylingHooks));
+    acc[hook.group].push(hook.name);
+    return acc;
+  }, {});
+  return getOrderByCssProp(cssProperty).map((group) => hooksByGroupMap[group] || []).flat().slice(0, 5);
 };
 var isValidColor = (val) => import_chroma_js.default.valid(val);
 var extractColorValue = (node) => {
@@ -153,8 +131,6 @@ var extractColorValue = (node) => {
   convertToHex,
   extractColorValue,
   findClosestColorHook,
-  isHardCodedColor,
-  isHexCode,
   isValidColor
 });
 //# sourceMappingURL=color-lib-utils.js.map