@helixui/library 2.1.2 → 3.0.0

package/dist/css/hx-switch.css

@@ -18,13 +18,17 @@
     display: flex;
     flex-direction: column;
     gap: var(--hx-space-1, 0.25rem);
-    font-family: var(--hx-font-family-sans, sans-serif);
+    font-family: var(--hx-switch-font-family, var(--hx-font-family-sans, sans-serif));
   }
 
+  /* WCAG 2.5.5 (healthcare mandate): minimum 44px touch target height.
+     The track itself is smaller visually, but the row must meet the
+     interactive touch target threshold for all size variants. */
   .switch__control-row {
     display: flex;
     align-items: center;
     gap: var(--hx-space-2, 0.5rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
   }
 
   /* --- Track --- */
@@ -37,7 +41,7 @@
     border: none;
     padding: 0;
     border-radius: var(--hx-border-radius-full, 9999px);
-    background-color: var(--hx-switch-track-bg, var(--hx-color-neutral-300, #ced4da));
+    background-color: var(--hx-switch-track-bg, var(--hx-color-neutral-300, #cbd5e1));
     cursor: pointer;
     transition: background-color var(--hx-transition-fast, 150ms ease);
     outline: none;
@@ -133,7 +137,7 @@
   .switch__label {
     font-size: var(--hx-font-size-sm, 0.875rem);
     font-weight: var(--hx-font-weight-medium, 500);
-    color: var(--hx-switch-label-color, var(--hx-color-neutral-700, #343a40));
+    color: var(--hx-switch-label-color, var(--hx-color-neutral-700, #334155));
     line-height: var(--hx-line-height-normal, 1.5);
     cursor: pointer;
     user-select: none;
@@ -149,7 +153,7 @@
 
   .switch__help-text {
     font-size: var(--hx-font-size-xs, 0.75rem);
-    color: var(--hx-switch-help-text-color, var(--hx-color-neutral-500, #6c757d));
+    color: var(--hx-switch-help-text-color, var(--hx-color-neutral-500, #64748b));
     line-height: var(--hx-line-height-normal, 1.5);
   }
 
@@ -167,3 +171,61 @@
       transition: none;
     }
   }
+
+  /* ─── High Contrast Mode (forced-colors) ─── */
+
+  @media (forced-colors: active) {
+    .switch__track {
+      forced-color-adjust: none;
+      background-color: ButtonFace;
+      border: 2px solid ButtonText;
+    }
+
+    .switch__track:focus-visible {
+      outline: 3px solid Highlight;
+      outline-offset: 2px;
+    }
+
+    .switch__thumb {
+      background-color: ButtonText;
+      box-shadow: none;
+    }
+
+    .switch--checked .switch__track {
+      background-color: Highlight;
+      border-color: Highlight;
+    }
+
+    .switch--checked .switch__thumb {
+      background-color: HighlightText;
+    }
+
+    :host([disabled]) {
+      opacity: 1;
+    }
+
+    :host([disabled]) .switch__track {
+      border-color: GrayText;
+      background-color: ButtonFace;
+    }
+
+    :host([disabled]) .switch__thumb {
+      background-color: GrayText;
+    }
+
+    :host([disabled]) .switch__label {
+      color: GrayText;
+    }
+
+    .switch__label {
+      color: CanvasText;
+    }
+
+    .switch__help-text {
+      color: GrayText;
+    }
+
+    .switch__error {
+      color: LinkText;
+    }
+  }

package/dist/css/hx-table.css

@@ -2,7 +2,7 @@
 :host {
     display: block;
     overflow-x: auto;
-    font-family: var(--hx-font-family-sans, sans-serif);
+    font-family: var(--hx-table-font-family, var(--hx-font-family-sans, sans-serif));
     font-size: var(--hx-font-size-sm, 0.875rem);
   }
 
@@ -104,6 +104,14 @@
       transition: none !important;
     }
   }
+
+  /* ─── Forced Colors (Windows High Contrast) ─── */
+
+  @media (forced-colors: active) {
+    table {
+      border: 1px solid CanvasText;
+    }
+  }
 `;
 
 /**

package/dist/css/hx-tabs.css

@@ -1,7 +1,7 @@
 /* hx-tabs — extracted from Shadow DOM styles */
 :host {
     display: block;
-    font-family: var(--hx-font-family-sans, sans-serif);
+    font-family: var(--hx-tabs-font-family, var(--hx-font-family-sans, sans-serif));
   }
 
   * {
@@ -28,7 +28,7 @@
     flex-wrap: nowrap;
     gap: 0;
     border-bottom: var(--hx-tabs-border-width, 1px) solid
-      var(--hx-tabs-border-color, var(--hx-color-neutral-200, #e9ecef));
+      var(--hx-tabs-border-color, var(--hx-color-neutral-200, #e2e8f0));
     overflow-x: auto;
     scrollbar-width: none;
   }
@@ -53,7 +53,7 @@
     flex-direction: column;
     border-bottom: none;
     border-inline-end: var(--hx-tabs-border-width, 1px) solid
-      var(--hx-tabs-border-color, var(--hx-color-neutral-200, #e9ecef));
+      var(--hx-tabs-border-color, var(--hx-color-neutral-200, #e2e8f0));
     overflow-x: visible;
     overflow-y: auto;
     min-width: var(--hx-tabs-vertical-width, 12rem);
@@ -74,3 +74,15 @@
       scroll-behavior: auto;
     }
   }
+
+  /* ─── High Contrast Mode (forced-colors) ─── */
+
+  @media (forced-colors: active) {
+    .tablist {
+      border-bottom-color: CanvasText;
+    }
+
+    :host([orientation='vertical']) .tablist {
+      border-inline-end-color: CanvasText;
+    }
+  }

package/dist/css/hx-tag.css

@@ -14,15 +14,15 @@
     align-items: center;
     gap: var(--hx-space-1, 0.25rem);
     border-radius: var(--hx-tag-border-radius, var(--hx-border-radius-sm, 0.25rem));
-    background-color: var(--hx-tag-bg, var(--hx-color-neutral-100, #f3f4f6));
-    color: var(--hx-tag-color, var(--hx-color-neutral-700, #374151));
+    background-color: var(--hx-tag-bg, var(--hx-color-neutral-100, #f1f5f9));
+    color: var(--hx-tag-color, var(--hx-color-neutral-700, #334155));
     font-family: var(--hx-tag-font-family, var(--hx-font-family-sans, sans-serif));
     font-weight: var(--hx-tag-font-weight, var(--hx-font-weight-medium, 500));
     line-height: var(--hx-line-height-tight, 1.25);
     white-space: nowrap;
     vertical-align: middle;
     border: var(--hx-border-width-thin, 1px) solid
-      var(--hx-tag-border-color, var(--hx-color-neutral-200, #e5e7eb));
+      var(--hx-tag-border-color, var(--hx-color-neutral-200, #e2e8f0));
   }
 
   /* ─── Size Variants ─── */
@@ -48,32 +48,32 @@
   /* ─── Color Variants ─── */
 
   .tag--default {
-    --hx-tag-bg: var(--hx-color-neutral-100, #f3f4f6);
-    --hx-tag-color: var(--hx-color-neutral-700, #374151);
-    --hx-tag-border-color: var(--hx-color-neutral-200, #e5e7eb);
+    --hx-tag-bg: var(--hx-color-neutral-100, #f1f5f9);
+    --hx-tag-color: var(--hx-color-neutral-700, #334155);
+    --hx-tag-border-color: var(--hx-color-neutral-200, #e2e8f0);
   }
 
   .tag--primary {
     --hx-tag-bg: var(--hx-color-primary-50, #eff6ff);
-    --hx-tag-color: var(--hx-color-primary-700, #1d4ed8);
+    --hx-tag-color: var(--hx-color-primary-700, #1e40af);
     --hx-tag-border-color: var(--hx-color-primary-200, #bfdbfe);
   }
 
   .tag--success {
     --hx-tag-bg: var(--hx-color-success-50, #f0fdf4);
-    --hx-tag-color: var(--hx-color-success-700, #15803d);
+    --hx-tag-color: var(--hx-color-success-700, #166534);
     --hx-tag-border-color: var(--hx-color-success-200, #bbf7d0);
   }
 
   .tag--warning {
     --hx-tag-bg: var(--hx-color-warning-50, #fffbeb);
-    --hx-tag-color: var(--hx-color-warning-700, #b45309);
+    --hx-tag-color: var(--hx-color-warning-700, #92400e);
     --hx-tag-border-color: var(--hx-color-warning-200, #fde68a);
   }
 
   .tag--danger {
     --hx-tag-bg: var(--hx-color-error-50, #fef2f2);
-    --hx-tag-color: var(--hx-color-error-700, #b91c1c);
+    --hx-tag-color: var(--hx-color-error-700, #991b1b);
     --hx-tag-border-color: var(--hx-color-error-200, #fecaca);
   }
 
@@ -132,7 +132,7 @@
     cursor: pointer;
     color: inherit;
     opacity: var(--hx-opacity-75, 0.75);
-    border-radius: var(--hx-border-radius-sm, 0.125rem);
+    border-radius: var(--hx-border-radius-sm, 0.25rem);
     line-height: 0;
   }
 
@@ -142,5 +142,17 @@
 
   .tag__remove-button:focus-visible {
     outline: var(--hx-focus-ring-width, 2px) solid var(--hx-focus-ring-color, currentColor);
-    outline-offset: var(--hx-focus-ring-offset, 1px);
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
+  /* ─── Forced Colors (Windows High Contrast) ─── */
+
+  @media (forced-colors: active) {
+    .tag {
+      border-color: CanvasText;
+    }
+
+    .tag__remove-button {
+      color: ButtonText;
+    }
   }

package/dist/css/hx-text-input.css

@@ -72,7 +72,7 @@
     gap: var(--hx-space-1, 0.25rem);
     font-size: var(--hx-font-size-sm, 0.875rem);
     font-weight: var(--hx-font-weight-medium, 500);
-    color: var(--hx-input-label-color, var(--hx-color-neutral-700, #343a40));
+    color: var(--hx-input-label-color, var(--hx-color-neutral-700, #334155));
     line-height: var(--hx-line-height-normal, 1.5);
   }
 
@@ -87,7 +87,7 @@
     display: flex;
     align-items: center;
     border: var(--hx-border-width-thin, 1px) solid
-      var(--hx-input-border-color, var(--hx-color-neutral-300, #ced4da));
+      var(--hx-input-border-color, var(--hx-color-neutral-300, #cbd5e1));
     border-radius: var(--hx-input-border-radius, var(--hx-border-radius-md, 0.375rem));
     background-color: var(--hx-input-bg, var(--hx-color-neutral-0, #ffffff));
     transition:
@@ -116,15 +116,15 @@
   /* ─── Error State ─── */
 
   .field--error .field__input-wrapper {
-    border-color: var(--hx-input-error-color, var(--hx-color-error-500, #dc3545));
+    border-color: var(--hx-input-error-color, var(--hx-color-error-500, #dc2626));
   }
 
   .field--error .field__input-wrapper:focus-within {
-    border-color: var(--hx-input-error-color, var(--hx-color-error-500, #dc3545));
+    border-color: var(--hx-input-error-color, var(--hx-color-error-500, #dc2626));
     box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
       color-mix(
         in srgb,
-        var(--hx-input-error-color, var(--hx-color-error-500, #dc3545))
+        var(--hx-input-error-color, var(--hx-color-error-500, #dc2626))
           calc(var(--hx-focus-ring-opacity, 0.25) * 100%),
         transparent
       );
@@ -136,7 +136,7 @@
   .field__suffix {
     display: flex;
     align-items: center;
-    color: var(--hx-color-neutral-500, #6c757d);
+    color: var(--hx-color-neutral-500, #64748b);
     flex-shrink: 0;
   }
 
@@ -159,14 +159,18 @@
     padding: var(--hx-space-2, 0.5rem) var(--hx-space-3, 0.75rem);
     font-family: inherit;
     font-size: var(--hx-font-size-md, 1rem);
-    color: var(--hx-input-color, var(--hx-color-neutral-800, #212529));
+    color: var(--hx-input-color, var(--hx-color-neutral-800, #1e293b));
     line-height: var(--hx-line-height-normal, 1.5);
     min-height: var(--hx-size-10, 2.5rem);
     width: 100%;
   }
 
   .field__input::placeholder {
-    color: var(--hx-color-neutral-400, #adb5bd);
+    color: var(--hx-color-neutral-400, #94a3b8);
+  }
+
+  .field__input:focus-visible {
+    outline: none; /* wrapper ring handles keyboard focus indication */
   }
 
   .field__input:disabled {
@@ -195,7 +199,7 @@
 
   .field__help-text {
     font-size: var(--hx-font-size-xs, 0.75rem);
-    color: var(--hx-color-neutral-500, #6c757d);
+    color: var(--hx-color-neutral-500, #64748b);
     line-height: var(--hx-line-height-normal, 1.5);
   }
 
@@ -212,3 +216,61 @@
       transition: none;
     }
   }
+
+  /* ─── High Contrast Mode (forced-colors) ─── */
+
+  @media (forced-colors: active) {
+    .field__input-wrapper {
+      forced-color-adjust: none;
+      background-color: Field;
+      color: FieldText;
+      border: 2px solid ButtonText;
+    }
+
+    .field__input {
+      color: FieldText;
+    }
+
+    .field__input::placeholder {
+      color: GrayText;
+    }
+
+    .field__input-wrapper:focus-within {
+      border-color: Highlight;
+      box-shadow: none;
+    }
+
+    .field__input:focus-visible {
+      outline: 3px solid Highlight;
+      outline-offset: -3px;
+    }
+
+    :host([disabled]) {
+      opacity: 1;
+    }
+
+    :host([disabled]) .field__input-wrapper {
+      border-color: GrayText;
+      color: GrayText;
+    }
+
+    :host([disabled]) .field__input {
+      color: GrayText;
+    }
+
+    .field--error .field__input-wrapper {
+      border-color: LinkText;
+    }
+
+    .field__label {
+      color: CanvasText;
+    }
+
+    .field__help-text {
+      color: GrayText;
+    }
+
+    .field__error {
+      color: LinkText;
+    }
+  }

package/dist/css/hx-text.css

@@ -7,7 +7,7 @@
 
   .text {
     display: inline;
-    font-family: var(--hx-font-family-sans, sans-serif);
+    font-family: var(--hx-text-font-family, var(--hx-font-family-sans, sans-serif));
     font-size: var(--hx-text-font-size);
     font-weight: var(--hx-text-font-weight);
     line-height: var(--hx-text-line-height);
@@ -73,7 +73,7 @@
     --hx-text-font-size: var(--hx-font-size-xs, 0.75rem);
     --hx-text-font-weight: var(--hx-font-weight-semibold, 600);
     --hx-text-line-height: var(--hx-line-height-tight, 1.25);
-    --hx-text-letter-spacing: var(--hx-letter-spacing-wide, 0.05em);
+    --hx-text-letter-spacing: var(--hx-letter-spacing-wide, 0.025em);
     text-transform: uppercase;
   }
 
@@ -96,15 +96,15 @@
   }
 
   .text--color-danger {
-    --hx-text-color: var(--hx-color-error-600, #dc2626);
+    --hx-text-color: var(--hx-color-error-600, #b91c1c);
   }
 
   .text--color-success {
-    --hx-text-color: var(--hx-color-success-600, #16a34a);
+    --hx-text-color: var(--hx-color-success-600, #15803d);
   }
 
   .text--color-warning {
-    --hx-text-color: var(--hx-color-warning-600, #d97706);
+    --hx-text-color: var(--hx-color-warning-600, #b45309);
   }
 
   /* ─── Weight Overrides ─── */
@@ -147,3 +147,36 @@
   :host([lines]:not([lines='0'])) {
     display: block;
   }
+
+  /* ─── High Contrast Mode (forced-colors) ─── */
+
+  @media (forced-colors: active) {
+    /*
+     * Semantic color variants (danger, success, warning) communicate state via color
+     * alone. In forced-colors mode the browser overrides custom colors, so we must
+     * use system color keywords to preserve the semantic distinction.
+     */
+    .text--color-danger {
+      color: LinkText;
+    }
+
+    .text--color-success {
+      color: CanvasText;
+    }
+
+    .text--color-warning {
+      color: CanvasText;
+    }
+
+    .text--color-disabled {
+      color: GrayText;
+    }
+
+    .text--color-inverse {
+      color: CanvasText;
+    }
+
+    .text--color-subtle {
+      color: CanvasText;
+    }
+  }

package/dist/css/hx-textarea.css

@@ -31,7 +31,7 @@
     gap: var(--hx-space-1, 0.25rem);
     font-size: var(--hx-font-size-sm, 0.875rem);
     font-weight: var(--hx-font-weight-medium, 500);
-    color: var(--hx-input-label-color, var(--hx-color-neutral-700, #343a40));
+    color: var(--hx-input-label-color, var(--hx-color-neutral-700, #334155));
     line-height: var(--hx-line-height-normal, 1.5);
   }
 
@@ -46,7 +46,7 @@
     display: flex;
     flex-direction: column;
     border: var(--hx-border-width-thin, 1px) solid
-      var(--hx-input-border-color, var(--hx-color-neutral-300, #ced4da));
+      var(--hx-input-border-color, var(--hx-color-neutral-300, #cbd5e1));
     border-radius: var(--hx-input-border-radius, var(--hx-border-radius-md, 0.375rem));
     background-color: var(--hx-input-bg, var(--hx-color-neutral-0, #ffffff));
     transition:
@@ -60,9 +60,6 @@
       --hx-input-focus-ring-color,
       var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))
     );
-    /* Solid fallback for browsers without color-mix() (Chrome < 111, Safari < 16.2) — WCAG 1.4.11 */
-    box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
-      rgba(37, 99, 235, var(--hx-focus-ring-opacity, 0.25));
     box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
       color-mix(
         in srgb,
@@ -78,18 +75,15 @@
   /* --- Error State --- */
 
   .field--error .field__textarea-wrapper {
-    border-color: var(--hx-input-error-color, var(--hx-color-error-500, #dc3545));
+    border-color: var(--hx-input-error-color, var(--hx-color-error-500, #dc2626));
   }
 
   .field--error .field__textarea-wrapper:focus-within {
-    border-color: var(--hx-input-error-color, var(--hx-color-error-500, #dc3545));
-    /* Solid fallback for browsers without color-mix() — WCAG 1.4.11 */
-    box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
-      rgba(220, 53, 69, var(--hx-focus-ring-opacity, 0.25));
+    border-color: var(--hx-input-error-color, var(--hx-color-error-500, #dc2626));
     box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
       color-mix(
         in srgb,
-        var(--hx-input-error-color, var(--hx-color-error-500, #dc3545))
+        var(--hx-input-error-color, var(--hx-color-error-500, #dc2626))
           calc(var(--hx-focus-ring-opacity, 0.25) * 100%),
         transparent
       );
@@ -104,7 +98,7 @@
     padding: var(--hx-space-2, 0.5rem) var(--hx-space-3, 0.75rem);
     font-family: inherit;
     font-size: var(--hx-font-size-md, 1rem);
-    color: var(--hx-input-color, var(--hx-color-neutral-800, #212529));
+    color: var(--hx-input-color, var(--hx-color-neutral-800, #1e293b));
     line-height: var(--hx-line-height-normal, 1.5);
     min-height: var(--hx-textarea-min-height, var(--hx-size-20, 5rem));
     width: 100%;
@@ -112,7 +106,11 @@
   }
 
   .field__textarea::placeholder {
-    color: var(--hx-color-neutral-400, #adb5bd);
+    color: var(--hx-color-neutral-400, #94a3b8);
+  }
+
+  .field__textarea:focus-visible {
+    outline: none; /* wrapper ring handles keyboard focus indication */
   }
 
   .field__textarea:disabled {
@@ -146,7 +144,7 @@
 
   .field__counter {
     font-size: var(--hx-font-size-xs, 0.75rem);
-    color: var(--hx-color-neutral-500, #6c757d);
+    color: var(--hx-color-neutral-500, #64748b);
     line-height: var(--hx-line-height-normal, 1.5);
     text-align: end;
   }
@@ -169,7 +167,7 @@
 
   .field__help-text {
     font-size: var(--hx-font-size-xs, 0.75rem);
-    color: var(--hx-color-neutral-500, #6c757d);
+    color: var(--hx-color-neutral-500, #64748b);
     line-height: var(--hx-line-height-normal, 1.5);
   }
 
@@ -178,3 +176,61 @@
     color: var(--hx-input-error-color, var(--hx-color-error-text, #b91c1c));
     line-height: var(--hx-line-height-normal, 1.5);
   }
+
+  /* ─── High Contrast Mode (forced-colors) ─── */
+
+  @media (forced-colors: active) {
+    .field__textarea-wrapper {
+      forced-color-adjust: none;
+      background-color: Field;
+      color: FieldText;
+      border: 2px solid ButtonText;
+    }
+
+    .field__textarea {
+      color: FieldText;
+    }
+
+    .field__textarea::placeholder {
+      color: GrayText;
+    }
+
+    .field__textarea-wrapper:focus-within {
+      border-color: Highlight;
+      box-shadow: none;
+    }
+
+    .field__textarea:focus-visible {
+      outline: 3px solid Highlight;
+      outline-offset: -3px;
+    }
+
+    :host([disabled]) {
+      opacity: 1;
+    }
+
+    :host([disabled]) .field__textarea-wrapper {
+      border-color: GrayText;
+      color: GrayText;
+    }
+
+    :host([disabled]) .field__textarea {
+      color: GrayText;
+    }
+
+    .field--error .field__textarea-wrapper {
+      border-color: LinkText;
+    }
+
+    .field__label {
+      color: CanvasText;
+    }
+
+    .field__help-text {
+      color: GrayText;
+    }
+
+    .field__error {
+      color: LinkText;
+    }
+  }

package/dist/css/hx-theme.css

@@ -21,3 +21,14 @@
     white-space: nowrap;
     border: 0;
   }
+
+  /* ─── High Contrast Mode (forced-colors) ─── */
+
+  /* hx-theme is a transparent wrapper that applies design tokens.
+     It has no visual output of its own. forced-color-adjust: auto (default)
+     is sufficient — theme tokens will resolve to system colors as needed. */
+  @media (forced-colors: active) {
+    :host {
+      forced-color-adjust: auto;
+    }
+  }