@helixui/library 3.1.0 → 3.2.0-next.74

package/dist/css/hx-button-group.css

@@ -22,33 +22,43 @@
   /* ─── No Double Borders: Horizontal ─── */
 
   .group--horizontal ::slotted(*:not(:first-child)) {
-    margin-inline-start: calc(-1 * var(--hx-border-width-thin, 1px));
+    margin-inline-start: var(
+      --hx-button-group-divider-offset,
+      calc(-1 * var(--hx-border-width-thin, 1px))
+    );
   }
 
   /* ─── No Double Borders: Vertical ─── */
 
   .group--vertical ::slotted(*:not(:first-child)) {
-    margin-top: calc(-1 * var(--hx-border-width-thin, 1px));
+    margin-top: var(--hx-button-group-divider-offset, calc(-1 * var(--hx-border-width-thin, 1px)));
   }
 
   /* ─── Border Radius: Horizontal — Single child keeps all corners ─── */
 
   .group--horizontal ::slotted(:only-child) {
-    --hx-button-border-radius: var(--hx-border-radius-md, 0.375rem);
+    --hx-button-border-radius: var(
+      --hx-button-group-border-radius,
+      var(--hx-border-radius-md, 0.375rem)
+    );
   }
 
   /* ─── Border Radius: Horizontal — First child keeps left corners ─── */
 
   .group--horizontal ::slotted(:first-child:not(:only-child)) {
-    --hx-button-border-radius: var(--hx-border-radius-md, 0.375rem) 0 0
-      var(--hx-border-radius-md, 0.375rem);
+    --hx-button-border-radius: var(
+        --hx-button-group-border-radius,
+        var(--hx-border-radius-md, 0.375rem)
+      )
+      0 0 var(--hx-button-group-border-radius, var(--hx-border-radius-md, 0.375rem));
   }
 
   /* ─── Border Radius: Horizontal — Last child keeps right corners ─── */
 
   .group--horizontal ::slotted(:last-child:not(:only-child)) {
-    --hx-button-border-radius: 0 var(--hx-border-radius-md, 0.375rem)
-      var(--hx-border-radius-md, 0.375rem) 0;
+    --hx-button-border-radius: 0
+      var(--hx-button-group-border-radius, var(--hx-border-radius-md, 0.375rem))
+      var(--hx-button-group-border-radius, var(--hx-border-radius-md, 0.375rem)) 0;
   }
 
   /* ─── Border Radius: Horizontal — Middle children have no radius ─── */
@@ -60,21 +70,28 @@
   /* ─── Border Radius: Vertical — Single child keeps all corners ─── */
 
   .group--vertical ::slotted(:only-child) {
-    --hx-button-border-radius: var(--hx-border-radius-md, 0.375rem);
+    --hx-button-border-radius: var(
+      --hx-button-group-border-radius,
+      var(--hx-border-radius-md, 0.375rem)
+    );
   }
 
   /* ─── Border Radius: Vertical — First child keeps top corners ─── */
 
   .group--vertical ::slotted(:first-child:not(:only-child)) {
-    --hx-button-border-radius: var(--hx-border-radius-md, 0.375rem)
-      var(--hx-border-radius-md, 0.375rem) 0 0;
+    --hx-button-border-radius: var(
+        --hx-button-group-border-radius,
+        var(--hx-border-radius-md, 0.375rem)
+      )
+      var(--hx-button-group-border-radius, var(--hx-border-radius-md, 0.375rem)) 0 0;
   }
 
   /* ─── Border Radius: Vertical — Last child keeps bottom corners ─── */
 
   .group--vertical ::slotted(:last-child:not(:only-child)) {
-    --hx-button-border-radius: 0 0 var(--hx-border-radius-md, 0.375rem)
-      var(--hx-border-radius-md, 0.375rem);
+    --hx-button-border-radius: 0 0
+      var(--hx-button-group-border-radius, var(--hx-border-radius-md, 0.375rem))
+      var(--hx-button-group-border-radius, var(--hx-border-radius-md, 0.375rem));
   }
 
   /* ─── Border Radius: Vertical — Middle children have no radius ─── */
@@ -86,7 +103,7 @@
   /* ─── Z-index: Raise focused child above siblings to show full focus ring ─── */
 
   .group ::slotted(:focus-within) {
-    z-index: 1;
+    z-index: var(--hx-button-group-focus-z-index, 1);
     position: relative;
   }
 
@@ -99,6 +116,6 @@
      * outline from hx-button's own forced-colors block is fully visible.
      */
     .group ::slotted(:focus-within) {
-      z-index: 2;
+      z-index: var(--hx-button-group-focus-z-index-hc, 2);
     }
   }

package/dist/css/hx-button.css

@@ -27,7 +27,7 @@
     gap: var(--hx-space-2, 0.5rem);
     border: var(--hx-border-width-thin, 1px) solid var(--hx-button-border-color, transparent);
     border-radius: var(--hx-button-border-radius, var(--hx-border-radius-md, 0.375rem));
-    background-color: var(--hx-button-bg, var(--hx-color-primary-500, #2563eb));
+    background-color: var(--hx-button-bg, var(--hx-color-primary-500, #429797));
     color: var(--hx-button-color, var(--hx-color-neutral-0, #ffffff));
     font-family: var(--hx-button-font-family, var(--hx-font-family-sans, sans-serif));
     font-weight: var(--hx-button-font-weight, var(--hx-font-weight-semibold, 600));
@@ -46,7 +46,10 @@
 
   .button:focus-visible {
     outline: var(--hx-focus-ring-width, 2px) solid
-      var(--hx-button-focus-ring-color, var(--hx-focus-ring-color, var(--hx-color-primary-500)));
+      var(
+        --hx-button-focus-ring-color,
+        var(--hx-focus-ring-color, var(--hx-color-primary-500, #429797))
+      );
     outline-offset: var(--hx-focus-ring-offset, 2px);
   }
 
@@ -84,63 +87,77 @@
   /* ─── Style Variants ─── */
 
   .button--primary {
-    --hx-button-bg: var(--hx-color-primary-500);
-    --hx-button-color: var(--hx-color-neutral-0);
+    --hx-button-bg: var(--hx-color-primary-500, #429797);
+    --hx-button-color: var(--hx-color-text-on-primary, #ffffff);
     --hx-button-border-color: transparent;
   }
 
   .button--secondary {
     --hx-button-bg: transparent;
-    --hx-button-color: var(--hx-color-primary-500);
-    --hx-button-border-color: var(--hx-color-primary-500);
+    /* primary-500 (#429797) text on white surface = 3.43:1 — fails AA.
+       primary-600 (#0F7078) on white = 6.06:1 — AA pass. */
+    --hx-button-color: var(--hx-color-primary-600, #0f7078);
+    --hx-button-border-color: var(--hx-color-primary-600, #0f7078);
   }
 
   .button--secondary:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-50));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-surface-raised, #f5f8f3));
   }
 
   .button--tertiary {
-    --hx-button-bg: var(--hx-color-neutral-100);
-    --hx-button-color: var(--hx-color-neutral-900);
+    --hx-button-bg: var(--hx-color-surface-sunken, #ebeee9);
+    --hx-button-color: var(--hx-color-text-primary, #0d1825);
     --hx-button-border-color: transparent;
   }
 
   .button--tertiary:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-200));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-surface-raised, #f5f8f3));
   }
 
   .button--danger {
-    --hx-button-bg: var(--hx-color-error-500);
-    --hx-button-color: var(--hx-color-neutral-0);
+    --hx-button-bg: var(--hx-color-error-500, #e5493e);
+    --hx-button-color: var(--hx-color-text-on-error, #ffffff);
     --hx-button-border-color: transparent;
   }
 
+  /* on-error tokens are tuned for error-500 (neutral-900 on #E5493E ≈ 4.59:1).
+     error-600 (#C92A2A) drops that to 2.25:1 — AA fail. Hold fg at neutral-0
+     directly so darker hover fills stay legible. Mirrors hx-toast precedent
+     (commit 300e21ab0). */
   .button--danger:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-error-600));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-error-600, #c92a2a));
+    --hx-button-color: var(--hx-color-neutral-0, #ffffff);
   }
 
   .button--ghost {
     --hx-button-bg: transparent;
-    --hx-button-color: var(--hx-color-primary-500);
+    /* primary-500 (#429797) text on white surface = 3.43:1 — fails AA.
+       primary-600 (#0F7078) on white = 6.06:1 — AA pass. */
+    --hx-button-color: var(--hx-color-primary-600, #0f7078);
     --hx-button-border-color: transparent;
   }
 
   .button--ghost:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-100));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-surface-raised, #f5f8f3));
   }
 
   .button--outline {
     --hx-button-bg: transparent;
-    --hx-button-color: var(--hx-color-neutral-900);
-    --hx-button-border-color: var(--hx-color-neutral-300);
+    --hx-button-color: var(--hx-color-text-primary, #0d1825);
+    --hx-button-border-color: var(--hx-color-border-strong, #8e9c98);
   }
 
   .button--outline:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-50));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-surface-raised, #f5f8f3));
   }
 
+  /* on-primary token resolves to neutral-900 (#0D1825) — tuned for primary-500.
+     primary-600 (#0F7078) drops the pair to 3.07:1 — AA fail. Pin fg at
+     neutral-0 for the darker hover fill. Mirrors hx-toast precedent
+     (commit 300e21ab0). */
   .button--primary:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-600));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-600, #0f7078));
+    --hx-button-color: var(--hx-color-neutral-0, #ffffff);
   }
 
   /* ─── Disabled ─── */
@@ -186,7 +203,7 @@
 
   /* Override text color and filter-based hover/active for all variants */
   :host([inverted]) .button {
-    color: var(--hx-button-inverted-color, var(--hx-color-neutral-0));
+    color: var(--hx-button-inverted-color, var(--hx-color-neutral-0, #ffffff));
     filter: none;
   }
 
@@ -207,7 +224,7 @@
 
   /* Primary inverted — slight transparent white overlay on hover */
   :host([inverted]) .button--primary:hover {
-    --hx-button-bg: var(--hx-color-primary-400, #60a5fa);
+    --hx-button-bg: var(--hx-color-primary-400, #6ab1b1);
   }
 
   /* Secondary inverted — white border and text */

package/dist/css/hx-card.css

@@ -2,17 +2,17 @@
 :host {
     display: block;
     color: var(--hx-card-color, inherit);
-    background-color: var(--hx-card-bg, var(--hx-color-neutral-0, #ffffff));
+    background-color: var(--hx-card-bg, var(--hx-color-surface-default, #ffffff));
   }
 
   .card {
     display: flex;
     flex-direction: column;
     gap: var(--hx-card-gap, var(--hx-space-4, 1rem));
-    background-color: var(--hx-card-bg, var(--hx-color-neutral-0, #ffffff));
-    color: var(--hx-card-color, var(--hx-color-neutral-800, #1e293b));
+    background-color: var(--hx-card-bg, var(--hx-color-surface-default, #ffffff));
+    color: var(--hx-card-color, var(--hx-color-text-strong, #202b39));
     border: var(--hx-border-width-thin, 1px) solid
-      var(--hx-card-border-color, var(--hx-color-neutral-200, #e2e8f0));
+      var(--hx-card-border-color, var(--hx-color-border-default, #d6dbd5));
     border-radius: var(--hx-card-border-radius, var(--hx-border-radius-lg, 0.5rem));
     overflow: hidden;
     font-family: var(--hx-card-font-family, var(--hx-font-family-sans, sans-serif));
@@ -28,11 +28,14 @@
   }
 
   .card--raised {
-    box-shadow: var(--hx-shadow-md, 0 4px 6px -1px rgb(0 0 0 / 0.1));
+    box-shadow: var(--hx-card-shadow, var(--hx-shadow-md, 0 4px 6px -1px rgb(0 0 0 / 0.1)));
   }
 
   .card--floating {
-    box-shadow: var(--hx-shadow-xl, 0 20px 25px -5px rgb(0 0 0 / 0.1));
+    box-shadow: var(
+      --hx-card-shadow-floating,
+      var(--hx-shadow-xl, 0 20px 25px -5px rgb(0 0 0 / 0.1))
+    );
   }
 
   /* ─── Style Variants ─── */
@@ -42,8 +45,8 @@
   }
 
   .card--featured {
-    border-color: var(--hx-color-primary-500, #2563eb);
-    border-width: var(--hx-border-width-medium, 2px);
+    border-color: var(--hx-card-featured-border-color, var(--hx-color-primary-500, #429797));
+    border-width: var(--hx-card-featured-border-width, var(--hx-border-width-medium, 2px));
   }
 
   .card--compact .card__body {
@@ -75,13 +78,16 @@
   }
 
   .card--interactive:hover {
-    box-shadow: var(--hx-shadow-lg, 0 10px 15px -3px rgb(0 0 0 / 0.1));
+    box-shadow: var(--hx-card-shadow-hover, var(--hx-shadow-lg, 0 10px 15px -3px rgb(0 0 0 / 0.1)));
     transform: translateY(var(--hx-transform-lift-md, -2px));
   }
 
   .card--interactive:focus-visible {
     outline: var(--hx-focus-ring-width, 2px) solid
-      var(--hx-card-focus-ring-color, var(--hx-focus-ring-color, var(--hx-color-primary-500)));
+      var(
+        --hx-card-focus-ring-color,
+        var(--hx-focus-ring-color, var(--hx-color-primary-500, #429797))
+      );
     outline-offset: var(--hx-focus-ring-offset, 2px);
   }
 
@@ -138,7 +144,14 @@
     flex: 1;
     font-size: var(--hx-font-size-md, 1rem);
     line-height: var(--hx-line-height-normal, 1.5);
-    color: var(--hx-card-color, var(--hx-color-neutral-600, #475569));
+    /*
+     * Body color cascades: component-tier --hx-card-body-color overrides
+     * the host-tier --hx-card-color, which falls back to text-secondary.
+     * Preserves the propagation contract: setting --hx-card-color on the
+     * host flows into the body slot (and through to slotted light-DOM
+     * descendants via flat-tree inheritance).
+     */
+    color: var(--hx-card-body-color, var(--hx-card-color, var(--hx-color-text-secondary, #313e4b)));
   }
 
   .card__footer {
@@ -156,11 +169,12 @@
     padding-bottom: var(--hx-card-padding, var(--hx-space-6, 1.5rem));
     padding-inline-start: var(--hx-card-padding, var(--hx-space-6, 1.5rem));
     border-top: var(--hx-border-width-thin, 1px) solid
-      var(--hx-card-border-color, var(--hx-color-neutral-200, #e2e8f0));
+      var(--hx-card-border-color, var(--hx-color-border-default, #d6dbd5));
     margin-top: auto;
   }
 
   /* ─── Forced Colors (Windows High Contrast) ─── */
+  /* Belt-and-suspenders: rich per-class HC overrides PLUS the forcedColorsSurface mixin. */
 
   @media (forced-colors: active) {
     .card {

package/dist/css/hx-carousel.css

@@ -38,10 +38,11 @@
     /* WCAG 2.5.5 (healthcare mandate): minimum 44x44px touch target */
     min-width: var(--hx-touch-target-min, 2.75rem);
     min-height: var(--hx-touch-target-min, 2.75rem);
-    border: var(--hx-border-width-thin, 1px) solid var(--hx-color-neutral-200, #e2e8f0);
+    border: var(--hx-border-width-thin, 1px) solid
+      var(--hx-carousel-nav-btn-border-color, var(--hx-color-neutral-200, #d6dbd5));
     border-radius: var(--hx-border-radius-full, 9999px);
-    background: var(--hx-color-neutral-0, #ffffff);
-    color: var(--hx-color-neutral-700, #334155);
+    background: var(--hx-carousel-nav-btn-bg, var(--hx-color-neutral-0, #ffffff));
+    color: var(--hx-carousel-nav-btn-color, var(--hx-color-neutral-700, #313e4b));
     cursor: pointer;
     padding: 0;
     transition:
@@ -52,8 +53,11 @@
   }
 
   .nav-btn:hover:not([disabled]) {
-    background: var(--hx-color-neutral-50, #f8fafc);
-    border-color: var(--hx-color-neutral-400, #94a3b8);
+    background: var(--hx-carousel-nav-btn-hover-bg, var(--hx-color-neutral-50, #f5f8f3));
+    border-color: var(
+      --hx-carousel-nav-btn-hover-border-color,
+      var(--hx-color-neutral-400, #8e9c98)
+    );
   }
 
   .nav-btn:focus-visible {
@@ -86,7 +90,7 @@
     border: var(--hx-border-width-thin, 1px) solid transparent;
     border-radius: var(--hx-border-radius-md, 0.375rem);
     background: transparent;
-    color: var(--hx-color-neutral-500, #64748b);
+    color: var(--hx-carousel-play-pause-color, var(--hx-color-neutral-500, #66787b));
     cursor: pointer;
     padding: 0;
     font-size: var(--hx-font-size-sm, 0.875rem);
@@ -95,7 +99,7 @@
   }
 
   .play-pause-btn:hover {
-    background: var(--hx-color-neutral-100, #f1f5f9);
+    background: var(--hx-carousel-play-pause-hover-bg, var(--hx-color-neutral-100, #ebeee9));
   }
 
   .play-pause-btn:focus-visible {
@@ -158,7 +162,7 @@
     width: var(--hx-carousel-pagination-dot-size, 0.5rem);
     height: var(--hx-carousel-pagination-dot-size, 0.5rem);
     border-radius: var(--hx-border-radius-full, 9999px);
-    background: var(--hx-color-neutral-300, #cbd5e1);
+    background: var(--hx-carousel-pagination-dot-bg, var(--hx-color-neutral-300, #b6bfb9));
     transition:
       background-color var(--hx-transition-fast, 150ms ease),
       transform var(--hx-transition-fast, 150ms ease);
@@ -166,7 +170,7 @@
 
   .pagination-item[aria-current='true'] .pagination-dot,
   .pagination-item.is-active .pagination-dot {
-    background: var(--hx-color-primary-600, #1d4ed8);
+    background: var(--hx-carousel-pagination-dot-active-bg, var(--hx-color-primary-600, #0f7078));
     transform: scale(1.25);
   }
 

package/dist/css/hx-checkbox-group.css

@@ -32,14 +32,14 @@
     gap: var(--hx-space-1);
     font-size: var(--hx-font-size-sm);
     font-weight: var(--hx-font-weight-medium);
-    color: var(--hx-checkbox-group-label-color, var(--hx-color-neutral-700));
+    color: var(--hx-checkbox-group-label-color, var(--hx-color-text-strong));
     line-height: var(--hx-line-height-normal);
     padding: 0;
     margin-bottom: var(--hx-space-1);
   }
 
   .fieldset__required-marker {
-    color: var(--hx-checkbox-group-error-color, var(--hx-color-error-text, #b91c1c));
+    color: var(--hx-checkbox-group-error-color, var(--hx-color-error-text, #c92a2a));
     font-weight: var(--hx-font-weight-bold);
   }
 
@@ -59,20 +59,20 @@
   /* ─── Error State ─── */
 
   .fieldset--error .fieldset__legend {
-    color: var(--hx-checkbox-group-error-color, var(--hx-color-error-text, #b91c1c));
+    color: var(--hx-checkbox-group-error-color, var(--hx-color-error-text, #c92a2a));
   }
 
   /* ─── Help Text & Error Messages ─── */
 
   .fieldset__help-text {
     font-size: var(--hx-font-size-xs);
-    color: var(--hx-checkbox-group-help-text-color, var(--hx-color-neutral-500));
+    color: var(--hx-checkbox-group-help-text-color, var(--hx-color-text-muted));
     line-height: var(--hx-line-height-normal);
   }
 
   .fieldset__error {
     font-size: var(--hx-font-size-xs);
-    color: var(--hx-checkbox-group-error-color, var(--hx-color-error-text, #b91c1c));
+    color: var(--hx-checkbox-group-error-color, var(--hx-color-error-text, #c92a2a));
     line-height: var(--hx-line-height-normal);
   }
 

package/dist/css/hx-checkbox.css

@@ -58,9 +58,9 @@
     width: var(--hx-checkbox-size, var(--hx-size-5, 1.25rem));
     height: var(--hx-checkbox-size, var(--hx-size-5, 1.25rem));
     border: var(--hx-border-width-medium, 2px) solid
-      var(--hx-checkbox-border-color, var(--hx-color-neutral-300, #cbd5e1));
+      var(--hx-checkbox-border-color, var(--hx-color-border-strong, #8e9c98));
     border-radius: var(--hx-checkbox-border-radius, var(--hx-border-radius-sm, 0.25rem));
-    background-color: var(--hx-checkbox-bg, var(--hx-color-neutral-0, #ffffff));
+    background-color: var(--hx-checkbox-bg, var(--hx-color-surface-default, #ffffff));
     transition:
       background-color var(--hx-transition-fast, 150ms ease),
       border-color var(--hx-transition-fast, 150ms ease),
@@ -71,38 +71,38 @@
   /* ─── Focus Ring ─── */
 
   .checkbox__input:focus-visible ~ .checkbox__box {
-    outline: var(--hx-focus-ring-width, 2px) solid
+    outline: var(--hx-checkbox-focus-ring-width, var(--hx-focus-ring-width, 2px)) solid
       var(
         --hx-checkbox-focus-ring-color,
-        var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))
+        var(--hx-focus-ring-color, var(--hx-color-primary-400, #6ab1b1))
       );
-    outline-offset: var(--hx-focus-ring-offset, 2px);
+    outline-offset: var(--hx-checkbox-focus-ring-offset, var(--hx-focus-ring-offset, 2px));
   }
 
   /* ─── Checked State ─── */
 
   .checkbox--checked .checkbox__box {
-    background-color: var(--hx-checkbox-checked-bg, var(--hx-color-primary-500, #2563eb));
-    border-color: var(--hx-checkbox-checked-border-color, var(--hx-color-primary-500, #2563eb));
+    background-color: var(--hx-checkbox-checked-bg, var(--hx-color-primary-500, #429797));
+    border-color: var(--hx-checkbox-checked-border-color, var(--hx-color-primary-500, #429797));
   }
 
   /* ─── Indeterminate State ─── */
 
   .checkbox--indeterminate .checkbox__box {
-    background-color: var(--hx-checkbox-checked-bg, var(--hx-color-primary-500, #2563eb));
-    border-color: var(--hx-checkbox-checked-border-color, var(--hx-color-primary-500, #2563eb));
+    background-color: var(--hx-checkbox-checked-bg, var(--hx-color-primary-500, #429797));
+    border-color: var(--hx-checkbox-checked-border-color, var(--hx-color-primary-500, #429797));
   }
 
   /* ─── Error State ─── */
 
   .checkbox--error .checkbox__box {
-    border-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #dc2626));
+    border-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #e5493e));
   }
 
   .checkbox--error.checkbox--checked .checkbox__box,
   .checkbox--error.checkbox--indeterminate .checkbox__box {
-    background-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #dc2626));
-    border-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #dc2626));
+    background-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #e5493e));
+    border-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #e5493e));
   }
 
   /* ─── Hover ─── */
@@ -111,7 +111,7 @@
   .checkbox__control:hover .checkbox__box {
     border-color: var(
       --hx-checkbox-hover-border-color,
-      var(--hx-checkbox-border-color, var(--hx-color-primary-500, #2563eb))
+      var(--hx-checkbox-border-color, var(--hx-color-primary-500, #429797))
     );
   }
 
@@ -120,7 +120,7 @@
   }
 
   .checkbox--error .checkbox__control:hover .checkbox__box {
-    border-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #dc2626));
+    border-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #e5493e));
   }
 
   /* ─── Checkmark Icon ─── */
@@ -130,7 +130,7 @@
     width: calc(var(--hx-checkbox-size, var(--hx-size-5, 1.25rem)) * 0.65);
     height: calc(var(--hx-checkbox-size, var(--hx-size-5, 1.25rem)) * 0.65);
     fill: none;
-    stroke: var(--hx-checkbox-checkmark-color, var(--hx-color-neutral-0, #ffffff));
+    stroke: var(--hx-checkbox-checkmark-color, var(--hx-color-text-on-primary, #ffffff));
     stroke-width: 2.5;
     stroke-linecap: round;
     stroke-linejoin: round;
@@ -149,14 +149,14 @@
   .checkbox__label {
     font-size: var(--hx-font-size-sm, 0.875rem);
     font-weight: var(--hx-font-weight-medium, 500);
-    color: var(--hx-checkbox-label-color, var(--hx-color-neutral-700, #334155));
+    color: var(--hx-checkbox-label-color, var(--hx-color-text-strong, #202b39));
     line-height: var(--hx-line-height-normal, 1.5);
     user-select: none;
     -webkit-user-select: none;
   }
 
   .checkbox__required-marker {
-    color: var(--hx-checkbox-error-color, var(--hx-color-error-text, #b91c1c));
+    color: var(--hx-checkbox-error-color, var(--hx-color-error-text, #c92a2a));
     font-weight: var(--hx-font-weight-bold, 700);
   }
 
@@ -164,7 +164,7 @@
 
   .checkbox__help-text {
     font-size: var(--hx-font-size-xs, 0.75rem);
-    color: var(--hx-checkbox-help-text-color, var(--hx-color-neutral-500, #64748b));
+    color: var(--hx-checkbox-help-text-color, var(--hx-color-text-muted, #4a5362));
     line-height: var(--hx-line-height-normal, 1.5);
     padding-inline-start: calc(
       var(--hx-checkbox-size, var(--hx-size-5, 1.25rem)) + var(--hx-space-2, 0.5rem)
@@ -173,7 +173,7 @@
 
   .checkbox__error {
     font-size: var(--hx-font-size-xs, 0.75rem);
-    color: var(--hx-checkbox-error-color, var(--hx-color-error-text, #b91c1c));
+    color: var(--hx-checkbox-error-color, var(--hx-color-error-text, #c92a2a));
     line-height: var(--hx-line-height-normal, 1.5);
     padding-inline-start: calc(
       var(--hx-checkbox-size, var(--hx-size-5, 1.25rem)) + var(--hx-space-2, 0.5rem)