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

package/build/index.js

@@ -203,13 +203,13 @@ var require_rule_messages = __commonJS({
 });
 
 // src/rules/v9/enforce-bem-usage.ts
-var import_sds_metadata, import_rule_messages, type, description, url, messages, bemMapping, enforce_bem_usage_default;
+var import_next, import_rule_messages, type, description, url, messages, bemMapping, enforce_bem_usage_default;
 var init_enforce_bem_usage = __esm({
   "src/rules/v9/enforce-bem-usage.ts"() {
-    import_sds_metadata = __toESM(require("@salesforce-ux/sds-metadata"));
+    import_next = __toESM(require("@salesforce-ux/sds-metadata/next"));
     import_rule_messages = __toESM(require_rule_messages());
     ({ type, description, url, messages } = import_rule_messages.default["enforce-bem-usage"]);
-    bemMapping = import_sds_metadata.default.bemNaming;
+    bemMapping = import_next.default.bemNaming;
     enforce_bem_usage_default = {
       meta: {
         type,
@@ -254,11 +254,11 @@ var init_enforce_bem_usage = __esm({
 var require_enforce_bem_usage = __commonJS({
   "src/rules/enforce-bem-usage.ts"(exports2, module2) {
     init_node();
-    var import_sds_metadata14 = __toESM(require("@salesforce-ux/sds-metadata"));
+    var import_next14 = __toESM(require("@salesforce-ux/sds-metadata/next"));
     var import_rule_messages16 = __toESM(require_rule_messages());
     init_enforce_bem_usage();
-    var bemMapping2 = import_sds_metadata14.default.bemNaming;
-    var deprecatedClasses2 = import_sds_metadata14.default.deprecatedClasses;
+    var bemMapping2 = import_next14.default.bemNaming;
+    var deprecatedClasses2 = import_next14.default.deprecatedClasses;
     var ruleConfig14 = import_rule_messages16.default["enforce-bem-usage"];
     var { type: type15, description: description15, url: url15, messages: messages15 } = ruleConfig14;
     var isDeprecatedClass = (className) => {
@@ -349,9 +349,9 @@ var require_enforce_bem_usage = __commonJS({
 var require_no_deprecated_classes_slds2 = __commonJS({
   "src/rules/no-deprecated-classes-slds2.ts"(exports2, module2) {
     init_node();
-    var import_sds_metadata14 = __toESM(require("@salesforce-ux/sds-metadata"));
+    var import_next14 = __toESM(require("@salesforce-ux/sds-metadata/next"));
     var import_rule_messages16 = __toESM(require_rule_messages());
-    var deprecatedClasses2 = import_sds_metadata14.default.deprecatedClasses;
+    var deprecatedClasses2 = import_next14.default.deprecatedClasses;
     var ruleConfig14 = import_rule_messages16.default["no-deprecated-classes-slds2"];
     module2.exports = {
       meta: {
@@ -555,10 +555,10 @@ var import_no_deprecated_classes_slds2 = __toESM(require_no_deprecated_classes_s
 var import_modal_close_button_issue = __toESM(require_modal_close_button_issue());
 
 // src/rules/v9/no-slds-class-overrides.ts
-var import_sds_metadata2 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next2 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages2 = __toESM(require_rule_messages());
 var ruleConfig = import_rule_messages2.default["no-slds-class-overrides"];
-var sldsClasses = import_sds_metadata2.default.sldsPlusClasses;
+var sldsClasses = import_next2.default.sldsPlusClasses;
 var sldsClassesSet = new Set(sldsClasses);
 var no_slds_class_overrides_default = {
   meta: {
@@ -595,10 +595,10 @@ var no_slds_class_overrides_default = {
 };
 
 // src/rules/v9/no-deprecated-slds-classes.ts
-var import_sds_metadata3 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next3 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages3 = __toESM(require_rule_messages());
 var { type: type2, description: description2, url: url2, messages: messages2 } = import_rule_messages3.default["no-deprecated-slds-classes"];
-var deprecatedClasses = import_sds_metadata3.default.deprecatedClasses;
+var deprecatedClasses = import_next3.default.deprecatedClasses;
 var deprecatedClassesSet = new Set(deprecatedClasses);
 var no_deprecated_slds_classes_default = {
   meta: {
@@ -629,11 +629,11 @@ var no_deprecated_slds_classes_default = {
 };
 
 // src/rules/v9/no-deprecated-tokens-slds1.ts
-var import_sds_metadata4 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next4 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages4 = __toESM(require_rule_messages());
 var ruleConfig2 = import_rule_messages4.default["no-deprecated-tokens-slds1"];
 var { type: type3, description: description3, url: url3, messages: messages3 } = ruleConfig2;
-var tokenMapping = import_sds_metadata4.default.auraToLwcTokensMapping;
+var tokenMapping = import_next4.default.auraToLwcTokensMapping;
 var no_deprecated_tokens_slds1_default = {
   meta: {
     type: type3,
@@ -706,7 +706,7 @@ var no_deprecated_tokens_slds1_default = {
 };
 
 // src/rules/v9/lwc-token-to-slds-hook.ts
-var import_sds_metadata5 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next5 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages5 = __toESM(require_rule_messages());
 
 // src/utils/hardcoded-shared-utils.ts
@@ -780,11 +780,7 @@ function isCssColorFunction(value) {
 }
 
 // src/utils/color-lib-utils.ts
-var LAB_THRESHOLD = 25;
-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();
@@ -792,52 +788,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) => {
@@ -879,13 +863,33 @@ function isKnownFontWeight(value) {
   return FONT_WEIGHTS.includes(stringValue.toLowerCase());
 }
 function handleShorthandAutoFix(declarationNode, context, valueText, replacements) {
-  const sortedReplacements = replacements.sort((a, b) => a.start - b.start);
-  const hasAnyHooks = sortedReplacements.some((r) => r.hasHook);
-  const canAutoFix = hasAnyHooks;
-  sortedReplacements.forEach(({ start, end, replacement, displayValue, hasHook }) => {
+  if (!replacements || replacements.length === 0) {
+    return;
+  }
+  const sortedReplacements = replacements.sort((a, b) => b.start - a.start);
+  const reportNumericValue = context.options?.reportNumericValue || "always";
+  const fixCallback = (start, originalValue, replacement) => {
+    let newValue = valueText;
+    newValue = newValue.substring(0, start) + replacement + newValue.substring(start + originalValue.length);
+    if (newValue !== valueText) {
+      return (fixer) => {
+        return fixer.replaceText(declarationNode.value, newValue);
+      };
+    }
+  };
+  sortedReplacements.forEach(({ start, end, replacement, displayValue, hasHook, isNumeric }) => {
     const originalValue = valueText.substring(start, end);
-    const valueStartColumn = declarationNode.value.loc.start.column;
-    const valueColumn = valueStartColumn + start;
+    if (isNumeric) {
+      if (reportNumericValue === "never") {
+        return;
+      }
+      if (reportNumericValue === "hasReplacement" && !hasHook) {
+        return;
+      }
+    }
+    const valueColumnStart = declarationNode.value.loc.start.column + start;
+    const valueColumnEnd = valueColumnStart + originalValue.length;
+    const canAutoFix = originalValue !== replacement;
     const { loc: { start: locStart, end: locEnd } } = declarationNode.value;
     const reportNode = {
       ...declarationNode.value,
@@ -893,23 +897,16 @@ function handleShorthandAutoFix(declarationNode, context, valueText, replacement
         ...declarationNode.value.loc,
         start: {
           ...locStart,
-          column: valueColumn
+          column: valueColumnStart
         },
         end: {
           ...locEnd,
-          column: valueColumn + originalValue.length
+          column: valueColumnEnd
         }
       }
     };
     if (hasHook) {
-      const fix = canAutoFix ? (fixer) => {
-        let newValue = valueText;
-        for (let i = sortedReplacements.length - 1; i >= 0; i--) {
-          const { start: rStart, end: rEnd, replacement: rReplacement } = sortedReplacements[i];
-          newValue = newValue.substring(0, rStart) + rReplacement + newValue.substring(rEnd);
-        }
-        return fixer.replaceText(declarationNode.value, newValue);
-      } : void 0;
+      const fix = canAutoFix ? fixCallback(start, originalValue, replacement) : void 0;
       context.context.report({
         node: reportNode,
         messageId: "hardcodedValue",
@@ -1120,7 +1117,7 @@ function formatSuggestionHooks(hooks) {
 // src/rules/v9/lwc-token-to-slds-hook.ts
 var ruleConfig3 = import_rule_messages5.default["lwc-token-to-slds-hook"];
 var { type: type4, description: description4, url: url4, messages: messages4 } = ruleConfig3;
-var lwcToSlds = import_sds_metadata5.default.lwcToSlds;
+var lwcToSlds = import_next5.default.lwcToSlds;
 function shouldIgnoreDetection(lwcToken) {
   return !lwcToken.startsWith("--lwc-") || !(lwcToken in lwcToSlds) || lwcToSlds[lwcToken].continueToUse;
 }
@@ -1251,11 +1248,11 @@ var lwc_token_to_slds_hook_default = {
 };
 
 // src/rules/v9/enforce-sds-to-slds-hooks.ts
-var import_sds_metadata6 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next6 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages6 = __toESM(require_rule_messages());
 var ruleConfig4 = import_rule_messages6.default["enforce-sds-to-slds-hooks"];
 var { type: type5, description: description5, url: url5, messages: messages5 } = ruleConfig4;
-var sldsPlusStylingHooks = import_sds_metadata6.default.sldsPlusStylingHooks;
+var sldsPlusStylingHooks = import_next6.default.sldsPlusStylingHooks;
 var allSldsHooks = [...sldsPlusStylingHooks.global, ...sldsPlusStylingHooks.component];
 var toSldsToken = (sdsToken) => sdsToken.replace("--sds-", "--slds-");
 function shouldIgnoreDetection2(sdsToken) {
@@ -1318,11 +1315,11 @@ var enforce_sds_to_slds_hooks_default = {
 };
 
 // src/rules/v9/no-sldshook-fallback-for-lwctoken.ts
-var import_sds_metadata7 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next7 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages7 = __toESM(require_rule_messages());
 var ruleConfig5 = import_rule_messages7.default["no-sldshook-fallback-for-lwctoken"];
 var { type: type6, description: description6, url: url6, messages: messages6 } = ruleConfig5;
-var sldsPlusStylingHooks2 = import_sds_metadata7.default.sldsPlusStylingHooks;
+var sldsPlusStylingHooks2 = import_next7.default.sldsPlusStylingHooks;
 var allSldsHooks2 = [...sldsPlusStylingHooks2.global, ...sldsPlusStylingHooks2.component];
 var allSldsHooksSet = new Set(allSldsHooks2);
 function hasUnsupportedFallback(lwcToken, sldsToken) {
@@ -1378,11 +1375,11 @@ var no_sldshook_fallback_for_lwctoken_default = {
 };
 
 // src/rules/v9/no-unsupported-hooks-slds2.ts
-var import_sds_metadata8 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next8 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages8 = __toESM(require_rule_messages());
 var ruleConfig6 = import_rule_messages8.default["no-unsupported-hooks-slds2"];
 var { type: type7, description: description7, url: url7, messages: messages7 } = ruleConfig6;
-var deprecatedHooks = new Set(import_sds_metadata8.default.deprecatedStylingHooks);
+var deprecatedHooks = new Set(import_next8.default.deprecatedStylingHooks);
 function shouldIgnoreDetection3(sldsHook) {
   return !deprecatedHooks.has(sldsHook);
 }
@@ -1428,11 +1425,11 @@ var no_unsupported_hooks_slds2_default = {
 };
 
 // src/rules/v9/no-slds-var-without-fallback.ts
-var import_sds_metadata9 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next9 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages9 = __toESM(require_rule_messages());
 var ruleConfig7 = import_rule_messages9.default["no-slds-var-without-fallback"];
 var { type: type8, description: description8, url: url8, messages: messages8 } = ruleConfig7;
-var sldsVariables = import_sds_metadata9.default.slds1ExcludedVars || {};
+var sldsVariables = import_next9.default.slds1ExcludedVars || {};
 var no_slds_var_without_fallback_default = {
   meta: {
     type: type8,
@@ -1484,11 +1481,11 @@ var no_slds_var_without_fallback_default = {
 };
 
 // src/rules/v9/no-slds-namespace-for-custom-hooks.ts
-var import_sds_metadata10 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next10 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages10 = __toESM(require_rule_messages());
 var ruleConfig8 = import_rule_messages10.default["no-slds-namespace-for-custom-hooks"];
 var { type: type9, description: description9, url: url9, messages: messages9 } = ruleConfig8;
-var sldsPlusStylingHooks3 = import_sds_metadata10.default.sldsPlusStylingHooks;
+var sldsPlusStylingHooks3 = import_next10.default.sldsPlusStylingHooks;
 var allSldsHooks3 = [...sldsPlusStylingHooks3.global, ...sldsPlusStylingHooks3.component, ...sldsPlusStylingHooks3.shared];
 var toSldsToken2 = (sdsToken) => sdsToken.replace("--sds-", "--slds-");
 function shouldIgnoreDetection4(sdsToken) {
@@ -1562,11 +1559,11 @@ var no_slds_namespace_for_custom_hooks_default = {
 };
 
 // src/rules/v9/enforce-component-hook-naming-convention.ts
-var import_sds_metadata11 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next11 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages11 = __toESM(require_rule_messages());
 var ruleConfig9 = import_rule_messages11.default["enforce-component-hook-naming-convention"];
 var { type: type10, description: description10, url: url10, messages: messages10 } = ruleConfig9;
-var slds1DeprecatedComponentHooks = import_sds_metadata11.default.slds1DeprecatedComponentHooks;
+var slds1DeprecatedComponentHooks = import_next11.default.slds1DeprecatedComponentHooks;
 function shouldIgnoreDetection5(hook) {
   return !hook.startsWith("--slds-c-") || !(hook in slds1DeprecatedComponentHooks);
 }
@@ -1709,7 +1706,7 @@ var no_slds_private_var_default = {
 };
 
 // src/rules/v9/no-hardcoded-values/no-hardcoded-values-slds1.ts
-var import_sds_metadata12 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next12 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages14 = __toESM(require_rule_messages());
 
 // src/utils/property-matcher.ts
@@ -1790,9 +1787,9 @@ function toSelector(properties) {
   });
   return selectorParts.join(", ");
 }
-function resolvePropertyToMatch(cssProperty) {
+function resolveDensityPropertyToMatch(cssProperty) {
   const propertyToMatch = cssProperty.toLowerCase();
-  if (propertyToMatch === "outline" || propertyToMatch === "outline-width" || isBorderWidthProperty(propertyToMatch)) {
+  if (isOutlineWidthProperty(propertyToMatch) || isBorderWidthProperty(propertyToMatch)) {
     return "border-width";
   } else if (isMarginProperty(propertyToMatch)) {
     return "margin";
@@ -1804,13 +1801,58 @@ function resolvePropertyToMatch(cssProperty) {
     return "width";
   } else if (isInsetProperty(propertyToMatch)) {
     return "top";
-  } else if (cssProperty === "background" || cssProperty === "background-color") {
+  }
+  return propertyToMatch;
+}
+function resolveColorPropertyToMatch(cssProperty) {
+  const propertyToMatch = cssProperty.toLowerCase();
+  if (propertyToMatch === "outline" || propertyToMatch === "outline-color") {
+    return "border-color";
+  } else if (propertyToMatch === "background" || propertyToMatch === "background-color") {
     return "background-color";
-  } else if (cssProperty === "outline" || cssProperty === "outline-color" || isBorderColorProperty(cssProperty)) {
+  } else if (isBorderColorProperty(propertyToMatch)) {
     return "border-color";
   }
   return propertyToMatch;
 }
+function isOutlineWidthProperty(propertyToMatch) {
+  return propertyToMatch === "outline" || propertyToMatch === "outline-width";
+}
+
+// src/utils/custom-mapping-utils.ts
+function matchesPropertyPattern(cssProperty, pattern) {
+  const normalizedProperty = cssProperty.toLowerCase();
+  const normalizedPattern = pattern.toLowerCase();
+  if (normalizedProperty === normalizedPattern) {
+    return true;
+  }
+  if (normalizedPattern.endsWith("*")) {
+    const prefix = normalizedPattern.slice(0, -1);
+    return normalizedProperty.startsWith(prefix);
+  }
+  return false;
+}
+function getCustomMapping(cssProperty, value, customMapping) {
+  if (!customMapping) {
+    return null;
+  }
+  const normalizedValue = value.toLowerCase().trim();
+  for (const [hookName, config] of Object.entries(customMapping)) {
+    const propertyMatches = config.properties.some(
+      (pattern) => matchesPropertyPattern(cssProperty, pattern)
+    );
+    if (!propertyMatches) {
+      continue;
+    }
+    const valueMatches = config.values.some(
+      (configValue) => configValue.toLowerCase().trim() === normalizedValue
+    );
+    if (valueMatches) {
+      return hookName;
+    }
+  }
+  return null;
+}
 
 // src/rules/v9/no-hardcoded-values/handlers/colorHandler.ts
 var handleColorDeclaration = (node, context) => {
@@ -1835,24 +1877,32 @@ function createColorReplacement(colorValue, cssProperty, context, positionInfo,
   if (!hexValue) {
     return null;
   }
-  const propToMatch = resolvePropertyToMatch(cssProperty);
-  const closestHooks = findClosestColorHook(hexValue, context.valueToStylinghook, propToMatch);
   const start = positionInfo.start.offset;
   const end = positionInfo.end.offset;
   const originalValue = originalValueText ? originalValueText.substring(start, end) : colorValue;
-  if (closestHooks.length === 1) {
-    return {
-      start,
-      end,
-      replacement: `var(${closestHooks[0]}, ${colorValue})`,
-      displayValue: closestHooks[0],
-      hasHook: true
-    };
-  } else if (closestHooks.length > 1) {
+  const customHook = getCustomMapping(cssProperty, colorValue, context.options?.customMapping);
+  let closestHooks = [];
+  if (customHook) {
+    closestHooks = [customHook];
+  } else {
+    const propToMatch = resolveColorPropertyToMatch(cssProperty);
+    closestHooks = findClosestColorHook(hexValue, context.valueToStylinghook, propToMatch);
+  }
+  let replacement = originalValue;
+  let paletteHook = null;
+  if (context.options?.preferPaletteHook && closestHooks.length > 1) {
+    paletteHook = closestHooks.filter((hook) => hook.includes("-palette-"))[0];
+  }
+  if (paletteHook) {
+    replacement = `var(${paletteHook}, ${colorValue})`;
+  } else if (closestHooks.length === 1) {
+    replacement = `var(${closestHooks[0]}, ${colorValue})`;
+  }
+  if (closestHooks.length > 0) {
     return {
       start,
       end,
-      replacement: originalValue,
+      replacement,
       // Use original value to preserve spacing
       displayValue: formatSuggestionHooks(closestHooks),
       hasHook: true
@@ -1861,7 +1911,7 @@ function createColorReplacement(colorValue, cssProperty, context, positionInfo,
     return {
       start,
       end,
-      replacement: originalValue,
+      replacement,
       // Use original value to preserve spacing
       displayValue: originalValue,
       hasHook: false
@@ -1909,8 +1959,14 @@ function createDimensionReplacement(parsedDimension, cssProperty, context, posit
     return null;
   }
   const rawValue = parsedDimension.unit ? `${parsedDimension.number}${parsedDimension.unit}` : parsedDimension.number.toString();
-  const propToMatch = resolvePropertyToMatch(cssProperty);
-  const closestHooks = getStylingHooksForDensityValue(parsedDimension, context.valueToStylinghook, propToMatch);
+  const customHook = getCustomMapping(cssProperty, rawValue, context.options?.customMapping);
+  let closestHooks = [];
+  if (customHook) {
+    closestHooks = [customHook];
+  } else {
+    const propToMatch = resolveDensityPropertyToMatch(cssProperty);
+    closestHooks = getStylingHooksForDensityValue(parsedDimension, context.valueToStylinghook, propToMatch);
+  }
   const start = positionInfo.start.offset;
   const end = positionInfo.end.offset;
   if (closestHooks.length === 1) {
@@ -1919,7 +1975,8 @@ function createDimensionReplacement(parsedDimension, cssProperty, context, posit
       end,
       replacement: `var(${closestHooks[0]}, ${rawValue})`,
       displayValue: closestHooks[0],
-      hasHook: true
+      hasHook: true,
+      isNumeric: true
     };
   } else if (closestHooks.length > 1) {
     return {
@@ -1927,7 +1984,8 @@ function createDimensionReplacement(parsedDimension, cssProperty, context, posit
       end,
       replacement: rawValue,
       displayValue: formatSuggestionHooks(closestHooks),
-      hasHook: true
+      hasHook: true,
+      isNumeric: true
     };
   } else {
     return {
@@ -1935,7 +1993,8 @@ function createDimensionReplacement(parsedDimension, cssProperty, context, posit
       end,
       replacement: rawValue,
       displayValue: rawValue,
-      hasHook: false
+      hasHook: false,
+      isNumeric: true
     };
   }
 }
@@ -1976,8 +2035,14 @@ function createFontReplacement(fontValue, cssProperty, context, positionInfo) {
     return null;
   }
   const rawValue = fontValue.unit ? `${fontValue.number}${fontValue.unit}` : fontValue.number.toString();
-  const propToMatch = !fontValue.unit && isKnownFontWeight(fontValue.number) ? resolvePropertyToMatch("font-weight") : resolvePropertyToMatch("font-size");
-  const closestHooks = getStylingHooksForDensityValue(fontValue, context.valueToStylinghook, propToMatch);
+  const propToMatch = !fontValue.unit && isKnownFontWeight(fontValue.number) ? "font-weight" : "font-size";
+  const customHook = getCustomMapping(propToMatch, rawValue, context.options?.customMapping);
+  let closestHooks = [];
+  if (customHook) {
+    closestHooks = [customHook];
+  } else {
+    closestHooks = getStylingHooksForDensityValue(fontValue, context.valueToStylinghook, propToMatch);
+  }
   const start = positionInfo.start.offset;
   const end = positionInfo.end.offset;
   if (closestHooks.length === 1) {
@@ -1986,7 +2051,8 @@ function createFontReplacement(fontValue, cssProperty, context, positionInfo) {
       end,
       replacement: `var(${closestHooks[0]}, ${rawValue})`,
       displayValue: closestHooks[0],
-      hasHook: true
+      hasHook: true,
+      isNumeric: true
     };
   } else if (closestHooks.length > 1) {
     return {
@@ -1994,7 +2060,8 @@ function createFontReplacement(fontValue, cssProperty, context, positionInfo) {
       end,
       replacement: rawValue,
       displayValue: formatSuggestionHooks(closestHooks),
-      hasHook: true
+      hasHook: true,
+      isNumeric: true
     };
   } else {
     return {
@@ -2002,7 +2069,8 @@ function createFontReplacement(fontValue, cssProperty, context, positionInfo) {
       end,
       replacement: rawValue,
       displayValue: rawValue,
-      hasHook: false
+      hasHook: false,
+      isNumeric: true
     };
   }
 }
@@ -2134,9 +2202,30 @@ function shadowValueToHookEntries(supportedStylinghooks) {
     return [key, value.map((hook) => hook.name)];
   });
 }
+function reportBoxShadowViolation(node, context, valueText, hooks) {
+  const positionInfo = {
+    start: { offset: 0, line: 1, column: 1 },
+    end: { offset: valueText.length, line: 1, column: valueText.length + 1 }
+  };
+  const replacement = createBoxShadowReplacement(
+    valueText,
+    hooks,
+    context,
+    positionInfo
+  );
+  if (replacement) {
+    const replacements = [replacement];
+    handleShorthandAutoFix(node, context, valueText, replacements);
+  }
+}
 var handleBoxShadowDeclaration = (node, context) => {
   const cssProperty = node.property.toLowerCase();
   const valueText = context.sourceCode.getText(node.value);
+  const customHook = getCustomMapping(cssProperty, valueText, context.options?.customMapping);
+  if (customHook) {
+    reportBoxShadowViolation(node, context, valueText, [customHook]);
+    return;
+  }
   const shadowHooks = shadowValueToHookEntries(context.valueToStylinghook);
   const parsedCssValue = toBoxShadowValue(valueText);
   if (!parsedCssValue) {
@@ -2146,20 +2235,7 @@ var handleBoxShadowDeclaration = (node, context) => {
     const parsedValueHook = toBoxShadowValue(shadow);
     if (parsedValueHook && isBoxShadowMatch(parsedCssValue, parsedValueHook)) {
       if (closestHooks.length > 0) {
-        const positionInfo = {
-          start: { offset: 0, line: 1, column: 1 },
-          end: { offset: valueText.length, line: 1, column: valueText.length + 1 }
-        };
-        const replacement = createBoxShadowReplacement(
-          valueText,
-          closestHooks,
-          context,
-          positionInfo
-        );
-        if (replacement) {
-          const replacements = [replacement];
-          handleShorthandAutoFix(node, context, valueText, replacements);
-        }
+        reportBoxShadowViolation(node, context, valueText, closestHooks);
       }
       return;
     }
@@ -2209,6 +2285,42 @@ function isRuleEnabled(context, ruleName3) {
   }
 }
 
+// src/rules/v9/no-hardcoded-values/ruleOptionsSchema.ts
+var ruleOptionsSchema = [
+  {
+    type: "object",
+    properties: {
+      reportNumericValue: {
+        type: "string",
+        enum: ["never", "always", "hasReplacement"],
+        default: "always"
+      },
+      customMapping: {
+        type: "object",
+        additionalProperties: {
+          type: "object",
+          properties: {
+            properties: {
+              type: "array",
+              items: { type: "string" }
+            },
+            values: {
+              type: "array",
+              items: { type: "string" }
+            }
+          },
+          required: ["properties", "values"]
+        }
+      },
+      preferPaletteHook: {
+        type: "boolean",
+        default: false
+      }
+    },
+    additionalProperties: false
+  }
+];
+
 // src/rules/v9/no-hardcoded-values/noHardcodedValueRule.ts
 function defineNoHardcodedValueRule(config) {
   const { ruleConfig: ruleConfig14, ruleName: ruleName3 } = config;
@@ -2222,16 +2334,24 @@ function defineNoHardcodedValueRule(config) {
         url: url15
       },
       fixable: "code",
-      messages: messages15
+      messages: messages15,
+      schema: ruleOptionsSchema
     },
     create(context) {
       if (ruleName3 === "no-hardcoded-values-slds1" && isRuleEnabled(context, "@salesforce-ux/slds/no-hardcoded-values-slds2")) {
         return {};
       }
+      const options = context.options[0] || {};
+      const ruleOptions = {
+        reportNumericValue: options.reportNumericValue || "always",
+        customMapping: options.customMapping || {},
+        preferPaletteHook: options.preferPaletteHook || false
+      };
       const handlerContext = {
         valueToStylinghook: config.valueToStylinghook,
         context,
-        sourceCode: context.sourceCode
+        sourceCode: context.sourceCode,
+        options: ruleOptions
       };
       const colorOnlySelector = toSelector(colorProperties);
       const densityOnlySelector = toSelector(densificationProperties);
@@ -2286,7 +2406,7 @@ function defineNoHardcodedValueRule(config) {
 var ruleName = "no-hardcoded-values-slds1";
 var ruleConfig12 = import_rule_messages14.default[ruleName];
 var { type: type13, description: description13, url: url13, messages: messages13 } = ruleConfig12;
-var valueToStylinghook = import_sds_metadata12.default.valueToStylingHooksSlds;
+var valueToStylinghook = import_next12.default.valueToStylingHooksSlds;
 var no_hardcoded_values_slds1_default = defineNoHardcodedValueRule({
   ruleConfig: ruleConfig12,
   valueToStylinghook,
@@ -2294,12 +2414,12 @@ var no_hardcoded_values_slds1_default = defineNoHardcodedValueRule({
 });
 
 // src/rules/v9/no-hardcoded-values/no-hardcoded-values-slds2.ts
-var import_sds_metadata13 = __toESM(require("@salesforce-ux/sds-metadata"));
+var import_next13 = __toESM(require("@salesforce-ux/sds-metadata/next"));
 var import_rule_messages15 = __toESM(require_rule_messages());
 var ruleName2 = "no-hardcoded-values-slds2";
 var ruleConfig13 = import_rule_messages15.default[ruleName2];
 var { type: type14, description: description14, url: url14, messages: messages14 } = ruleConfig13;
-var valueToStylinghook2 = import_sds_metadata13.default.valueToStylingHooksCosmos;
+var valueToStylinghook2 = import_next13.default.valueToStylingHooksCosmos;
 var no_hardcoded_values_slds2_default = defineNoHardcodedValueRule({
   ruleConfig: ruleConfig13,
   valueToStylinghook: valueToStylinghook2,
@@ -2309,11 +2429,13 @@ var no_hardcoded_values_slds2_default = defineNoHardcodedValueRule({
 // src/index.ts
 var import_parser2 = __toESM(require("@html-eslint/parser"));
 
-// eslint.rules.json
-var eslint_rules_default = {
+// eslint.rules.internal.json
+var eslint_rules_internal_default = {
   css: {
+    "@salesforce-ux/slds/enforce-bem-usage": "warn",
     "@salesforce-ux/slds/no-slds-class-overrides": "warn",
     "@salesforce-ux/slds/no-deprecated-slds-classes": "warn",
+    "@salesforce-ux/slds/no-deprecated-tokens-slds1": "error",
     "@salesforce-ux/slds/lwc-token-to-slds-hook": "error",
     "@salesforce-ux/slds/enforce-sds-to-slds-hooks": "warn",
     "@salesforce-ux/slds/no-sldshook-fallback-for-lwctoken": "warn",
@@ -2322,7 +2444,24 @@ var eslint_rules_default = {
     "@salesforce-ux/slds/no-slds-namespace-for-custom-hooks": "warn",
     "@salesforce-ux/slds/enforce-component-hook-naming-convention": "error",
     "@salesforce-ux/slds/no-slds-private-var": "warn",
-    "@salesforce-ux/slds/no-hardcoded-values-slds2": "warn",
+    "@salesforce-ux/slds/no-hardcoded-values-slds2": ["warn", {
+      reportNumericValue: "hasReplacement",
+      preferPaletteHook: true,
+      customMapping: {
+        "--slds-g-font-line-height-4": {
+          properties: ["line-height"],
+          values: ["1.5"]
+        },
+        "--slds-g-sizing-5": {
+          properties: ["width", "height", "max-width", "max-height", "border*"],
+          values: ["1rem", "16px"]
+        },
+        "--slds-g-sizing-content-1": {
+          properties: ["width", "height", "max-width", "max-height", "border*"],
+          values: ["20ch"]
+        }
+      }
+    }],
     "@salesforce-ux/slds/reduce-annotations": "warn"
   },
   html: {
@@ -2355,7 +2494,7 @@ var rules = {
 var plugin = {
   meta: {
     name: "@salesforce-ux/eslint-plugin-slds",
-    version: "1.0.5"
+    version: "1.0.6-internal"
   },
   rules,
   configs: {}
@@ -2372,10 +2511,10 @@ var cssConfigArray = [
     plugins: {
       "@salesforce-ux/slds": plugin
     },
-    rules: eslint_rules_default.css,
+    rules: eslint_rules_internal_default.css,
     settings: {
       // Pass rules configuration to context for runtime access
-      sldsRules: { ...eslint_rules_default.css }
+      sldsRules: { ...eslint_rules_internal_default.css }
     }
   }
 ];
@@ -2391,7 +2530,7 @@ var htmlConfigArray = [
     plugins: {
       "@salesforce-ux/slds": plugin
     },
-    rules: eslint_rules_default.html
+    rules: eslint_rules_internal_default.html
   }
 ];
 Object.assign(plugin.configs, {
@@ -2402,7 +2541,7 @@ Object.assign(plugin.configs, {
   // legacy config for ESLint v8-
   recommended: {
     plugins: ["@salesforce-ux/slds"],
-    rules: eslint_rules_default.html,
+    rules: eslint_rules_internal_default.html,
     parser: import_parser2.default,
     parserOptions: {
       ecmaVersion: 2021,