@helixui/library 3.7.0 → 3.8.0-next.145

package/dist/css/helix-all.css

@@ -136,6 +136,18 @@
     flex-shrink: 0;
   }
 
+  /*
+   * AAA 2.4.13 Focus Appearance — enforce a ≥2px focus ring on slotted
+   * natives (e.g. bare <button>, <a>) so consumers who slot non-HELiX
+   * controls inherit the same indicator as the HELiX components do.
+   * Token-driven: --hx-focus-ring-width resolves to 2px (default).
+   */
+  ::slotted(:focus-visible) {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-action-bar-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
   /* ─── High Contrast Mode (forced-colors) ─── */
 
   @media (forced-colors: active) {
@@ -233,10 +245,8 @@
     color: var(--hx-alert-icon-color, var(--hx-color-info-500, #0c8beb));
   }
 
-  .alert__icon svg {
-    width: var(--hx-space-5, 1.25rem);
-    height: var(--hx-space-5, 1.25rem);
-    fill: currentColor;
+  .alert__icon .alert__glyph {
+    --hx-icon-size: var(--hx-space-5, 1.25rem);
   }
 
   /* ─── Title ─── */
@@ -323,10 +333,8 @@
     opacity: 1;
   }
 
-  .alert__close-button svg {
-    width: var(--hx-space-4, 1rem);
-    height: var(--hx-space-4, 1rem);
-    fill: currentColor;
+  .alert__close-button .alert__glyph {
+    --hx-icon-size: var(--hx-space-4, 1rem);
   }
 
   @media (prefers-reduced-motion: reduce) {
@@ -483,8 +491,7 @@
   /* ─── Fallback Icon ─── */
 
   .avatar__fallback-icon {
-    width: 60%;
-    height: 60%;
+    --hx-icon-size: 60%;
     color: var(--hx-avatar-color, var(--hx-color-primary-700, #0f6363));
   }
 
@@ -768,6 +775,11 @@
       border-width: 2px;
     }
   }
+
+  /* hx-icon glyph sizing for the migrated remove-button SVG. */
+  .badge__remove-glyph {
+    --hx-icon-size: 10px;
+  }
 /* ── hx-banner ── */
 :host {
     display: block;
@@ -829,10 +841,8 @@
     color: var(--hx-banner-icon-color, var(--hx-color-info-500, #0c8beb));
   }
 
-  .banner__icon svg {
-    width: var(--hx-space-5, 1.25rem);
-    height: var(--hx-space-5, 1.25rem);
-    fill: currentColor;
+  .banner__icon .banner__glyph {
+    --hx-icon-size: var(--hx-space-5, 1.25rem);
   }
 
   /* ─── Message ─── */
@@ -912,10 +922,8 @@
     opacity: 1;
   }
 
-  .banner__close-button svg {
-    width: var(--hx-space-4, 1rem);
-    height: var(--hx-space-4, 1rem);
-    fill: currentColor;
+  .banner__close-button .banner__glyph {
+    --hx-icon-size: var(--hx-space-4, 1rem);
   }
 
   /* ─── Variant: info ─── */
@@ -1126,7 +1134,10 @@
   .button--md {
     padding: var(--hx-space-2, 0.5rem) var(--hx-space-4, 1rem);
     font-size: var(--hx-font-size-md, 1rem);
-    min-height: var(--hx-size-10, 2.5rem);
+    /* WCAG 2.5.5 AAA Target Size (Enhanced): 44×44 minimum.
+       Bound to --hx-touch-target-min so the default md variant clears the
+       AAA-strict floor without requiring consumers to opt into sm or lg. */
+    min-height: var(--hx-touch-target-min, 2.75rem);
   }
 
   .button--lg {
@@ -1899,9 +1910,12 @@
     cursor: not-allowed;
   }
 
-  .nav-btn svg {
-    width: 1.25em;
-    height: 1.25em;
+  .nav-btn .carousel__nav-glyph {
+    --hx-icon-size: 1.25em;
+  }
+
+  .play-pause-btn .carousel__autoplay-glyph {
+    --hx-icon-size: 1em;
   }
 
   /* ─── Play/Pause ─── */
@@ -2137,6 +2151,16 @@
 
   /* ─── Focus Ring ─── */
 
+  /*
+   * Suppress the browser default ~1px host outline. Without this, the formal
+   * AAA audit harness (which measures computed outline-width on the focused
+   * host) records a sub-2px outline and reports WCAG 2.4.13 Partially Supports.
+   * The visual focus indicator is rendered on the inner .checkbox__box below.
+   */
+  :host {
+    outline: none;
+  }
+
   /*
    * Host-focus path: on the modern (IDL element-references) render branch the
    * host is the tabbable surface (tabindex=0) and the inner input is demoted
@@ -2210,17 +2234,12 @@
     border-color: var(--hx-checkbox-error-color, var(--hx-color-error-500, #e5493e));
   }
 
-  /* ─── Checkmark Icon ─── */
+  /* ─── Checkmark Icon (hx-icon library="helix") ─── */
 
   .checkbox__icon {
     display: none;
-    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-text-on-primary, #ffffff));
-    stroke-width: 2.5;
-    stroke-linecap: round;
-    stroke-linejoin: round;
+    --hx-icon-size: calc(var(--hx-checkbox-size, var(--hx-size-5, 1.25rem)) * 0.65);
+    --hx-icon-color: var(--hx-checkbox-checkmark-color, var(--hx-color-text-on-primary, #ffffff));
   }
 
   .checkbox--checked .checkbox__icon--check {
@@ -2327,7 +2346,7 @@
     }
 
     .checkbox__icon {
-      stroke: HighlightText;
+      --hx-icon-color: HighlightText;
     }
 
     .checkbox--error .checkbox__box {
@@ -2381,6 +2400,17 @@
     cursor: not-allowed;
   }
 
+  /*
+   * AAA 2.4.13 Focus Appearance — host-level focus ring (group is focusable
+   * via roving tabindex in Tier-2). Token-driven: --hx-focus-ring-width
+   * resolves to ≥2px.
+   */
+  :host(:focus-visible) {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-checkbox-group-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
   * {
     box-sizing: border-box;
   }
@@ -2590,15 +2620,12 @@
     color: var(--hx-clinical-status-icon-color, var(--hx-color-info-500, #0c8beb));
   }
 
-  .clinical-status__icon svg {
-    width: var(--hx-space-5, 1.25rem);
-    height: var(--hx-space-5, 1.25rem);
-    fill: currentColor;
+  .clinical-status__glyph {
+    --hx-icon-size: var(--hx-space-5, 1.25rem);
   }
 
-  .clinical-status--compact .clinical-status__icon svg {
-    width: var(--hx-space-4, 1rem);
-    height: var(--hx-space-4, 1rem);
+  .clinical-status--compact .clinical-status__glyph {
+    --hx-icon-size: var(--hx-space-4, 1rem);
   }
 
   /* ─── Message ─── */
@@ -3016,6 +3043,10 @@
     background: var(--hx-color-neutral-0, #ffffff);
     cursor: pointer;
     transition: border-color var(--hx-transition-fast, 150ms ease);
+    /* WCAG 2.5.5 AAA Target Size (Enhanced): 44×44 minimum.
+       Bound to --hx-touch-target-min so the trigger clears the AAA-strict
+       floor at default sizing. */
+    min-height: var(--hx-touch-target-min, 2.75rem);
   }
   .trigger:hover:not([disabled]) {
     border-color: var(
@@ -3176,13 +3207,20 @@
   }
   .format-btn {
     flex-shrink: 0;
+    /* WCAG 2.5.5 (Enhanced) AAA — interactive panel controls must clear
+       44×44. Without min-width/min-height the format toggle collapses to
+       its label box (~44×24 in default rendering, sub-44 on the y-axis). */
+    min-width: var(--hx-touch-target-min, 2.75rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
     padding: var(--hx-space-1, 0.25rem) var(--hx-space-2, 0.5rem);
     background: var(--hx-color-neutral-100, #ebeee9);
     border: var(--hx-border-width-thin, 1px) solid var(--hx-color-neutral-300, #b6bfb9);
     border-radius: var(--hx-border-radius-sm, 0.25rem);
     cursor: pointer;
     font-size: var(--hx-font-size-xs, 0.75rem);
-    color: var(--hx-color-neutral-600, #4a5362);
+    /* AAA 1.4.6: 12px label vs neutral-100 must be ≥7:1; neutral-700 = 9.34:1
+       (neutral-600 was 6.63:1, a tight AAA miss). */
+    color: var(--hx-color-neutral-700, #313e4b);
     text-transform: uppercase;
     font-weight: var(--hx-font-weight-semibold, 600);
     letter-spacing: 0.05em;
@@ -3190,6 +3228,8 @@
   .color-input {
     flex: 1;
     min-width: 0;
+    /* WCAG 2.5.5 (Enhanced) AAA — text input must clear 44×44. */
+    min-height: var(--hx-touch-target-min, 2.75rem);
     padding: var(--hx-space-1, 0.25rem) var(--hx-space-2, 0.5rem);
     border: var(--hx-border-width-thin, 1px) solid var(--hx-color-neutral-300, #b6bfb9);
     border-radius: var(--hx-border-radius-sm, 0.25rem);
@@ -3665,6 +3705,14 @@
     outline-offset: var(--hx-focus-ring-offset, 2px);
     opacity: 1;
   }
+
+  /* hx-icon glyph sizing for migrated inline SVGs (library="helix"). */
+  .field__chip-remove-glyph {
+    --hx-icon-size: 8px;
+  }
+  .field__clear-button-glyph {
+    --hx-icon-size: 12px;
+  }
 /* ── hx-container ── */
 :host {
     display: block;
@@ -3808,10 +3856,13 @@
     font-size: var(--hx-font-size-sm);
   }
 
+  /* md — WCAG 2.5.5 AAA Target Size (Enhanced): 44×44 minimum.
+     Bound to --hx-touch-target-min so the default md variant clears the
+     AAA-strict floor without requiring consumers to opt into sm or lg. */
   .button--md {
     padding: var(--hx-space-2);
-    min-width: var(--hx-size-10);
-    height: var(--hx-size-10);
+    min-width: var(--hx-touch-target-min, 2.75rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
     font-size: var(--hx-font-size-md);
   }
 
@@ -4302,7 +4353,8 @@
     font-size: var(--hx-font-size-md, 1rem);
     color: var(--hx-date-picker-color, var(--hx-color-text-strong, #202b39));
     line-height: var(--hx-line-height-normal, 1.5);
-    min-height: var(--hx-size-10, 2.5rem);
+    /* WCAG 2.5.5 (Enhanced) AAA — primary input surface must meet 44×44. */
+    min-height: var(--hx-touch-target-min, 2.75rem);
     width: 100%;
     cursor: default;
   }
@@ -4323,6 +4375,10 @@
     display: flex;
     align-items: center;
     justify-content: center;
+    /* WCAG 2.5.5 (Enhanced) AAA — calendar trigger must clear 44×44.
+       Without min-width the icon button collapses to ~41 px wide. */
+    min-width: var(--hx-touch-target-min, 2.75rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
     padding: 0 var(--hx-space-3, 0.75rem);
     border: none;
     border-left: var(--hx-border-width-thin, 1px) solid
@@ -4621,6 +4677,11 @@
       border-color: LinkText;
     }
   }
+
+  /* hx-icon glyph sizing for the migrated calendar trigger SVG. */
+  .field__trigger-glyph {
+    --hx-icon-size: 16px;
+  }
 /* ── hx-dialog ── */
 :host {
     display: contents;
@@ -5231,6 +5292,11 @@
       border: 1px solid ButtonText;
     }
   }
+
+  /* hx-icon glyph sizing for the migrated close-button SVG. */
+  .drawer-close-button-glyph {
+    --hx-icon-size: 16px;
+  }
 /* ── hx-dropdown ── */
 :host {
     display: inline-block;
@@ -5246,11 +5312,29 @@
     display: inline-block;
   }
 
+  /*
+   * AAA 2.4.13 Focus Appearance — enforce a ≥2px focus ring on the slotted
+   * trigger (typically <hx-button>, <button>, or <hx-icon-button>). The host
+   * is a popover-container; the interactive surface is the slotted trigger.
+   */
+  ::slotted([slot='trigger']:focus-visible),
+  ::slotted(button:focus-visible),
+  ::slotted(a:focus-visible) {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-dropdown-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
   [part='panel'] {
     position: fixed;
     z-index: var(--hx-dropdown-panel-z-index, 1000);
     min-width: var(--hx-dropdown-panel-min-width, 160px);
     background: var(--hx-dropdown-panel-bg, var(--hx-color-surface-default, #ffffff));
+    /* Anchor slotted text color to the design-system primary text token so
+       slotted <li>'s and other native consumer markup don't inherit a
+       foreign color cascade (e.g. brand toolbar setting body { color: #fff }
+       and rendering Edit/Duplicate as white-on-white). */
+    color: var(--hx-dropdown-panel-color, var(--hx-color-text-primary, #1a1a1a));
     border: 1px solid var(--hx-dropdown-panel-border-color, var(--hx-color-border-default, #d6dbd5));
     border-radius: var(--hx-dropdown-panel-border-radius, var(--hx-border-radius-md, 0.375rem));
     box-shadow: var(
@@ -5676,6 +5760,10 @@
     outline-offset: var(--hx-focus-ring-offset, 2px);
   }
 
+  .file-item__remove-glyph {
+    --hx-icon-size: 14px;
+  }
+
   @media (prefers-reduced-motion: reduce) {
     .file-item__remove {
       transition: none;
@@ -5843,6 +5931,11 @@ export const helixGridItemStyles = css`
     align-items: center;
   }
 
+  /* Render the migrated hx-icon glyph at 1em (matches the previous inline SVG sizing). */
+  .help-text__glyph {
+    --hx-icon-size: 1em;
+  }
+
   .help-text__text {
     min-width: 0;
   }
@@ -5941,6 +6034,12 @@ export const helixGridItemStyles = css`
     width: 100%;
     height: 100%;
     fill: currentColor;
+    /* stroke-width is consumed by stroke-paint and mixed-paint icon libraries
+       (Lucide, Heroicons-outline, Phosphor). Built-in helix + fa-free
+       libraries declare paintMode: 'fill' and ignore this property; setting
+       it here makes the token universally available without per-library
+       branching in the resolver. */
+    stroke-width: var(--hx-icon-stroke-width, 2);
     display: block;
     overflow: visible;
   }
@@ -5961,6 +6060,7 @@ export const helixGridItemStyles = css`
     width: 100%;
     height: 100%;
     fill: currentColor;
+    stroke-width: var(--hx-icon-stroke-width, 2);
     display: block;
   }
 
@@ -6314,8 +6414,7 @@ export const helixGridItemStyles = css`
 
   .link__external-icon {
     display: inline-flex;
-    width: 0.75em;
-    height: 0.75em;
+    --hx-icon-size: 0.75em;
     flex-shrink: 0;
   }
 
@@ -6649,6 +6748,16 @@ export const helixGridItemStyles = css`
     align-items: center;
     gap: var(--hx-space-1, 0.25rem);
     padding: var(--hx-nav-item-padding, var(--hx-space-2, 0.5rem) var(--hx-space-3, 0.75rem));
+    /*
+     * WCAG 2.5.5 (Enhanced) AAA — nav links rendered with default padding
+     * land at ~37 px tall (8 px + 1.5 line-height + 8 px). The link
+     * content is first-party (rendered via consumer-supplied props on
+     * <hx-nav-item>), so the slotted-content carve-out does not apply —
+     * this is a real component obligation. Bind --hx-nav-link-min-height
+     * to --hx-touch-target-min (2.75rem / 44 px) to grow the interactive
+     * area without enlarging the visible label.
+     */
+    min-height: var(--hx-nav-link-min-height, var(--hx-touch-target-min, 2.75rem));
     color: var(--hx-nav-link-color, var(--hx-color-neutral-100, #ebeee9));
     text-decoration: none;
     border-radius: var(--hx-nav-border-radius, var(--hx-border-radius-sm, 0.25rem));
@@ -6677,13 +6786,26 @@ export const helixGridItemStyles = css`
   }
 
   .nav__link--active {
-    background-color: var(--hx-nav-link-active-bg, var(--hx-color-primary-600, #0f7078));
-    color: var(--hx-nav-link-active-color, var(--hx-color-neutral-0, #ffffff));
+    background-color: var(--hx-nav-link-active-bg, var(--hx-color-action-primary-bg, #0f6363));
+    /* Use --hx-color-text-on-primary so the active-link text inherits the
+     * action-surface AAA-strict pairing (white on primary-700 in default
+     * themes; black on lighter primary-700 in the high-contrast theme).
+     * Pre-3.4.0 this consumed --hx-color-primary-600 directly which
+     * resolved to Apex #0F7078 + white = 5.82:1 — AAA-large only, AAA
+     * normal fail under WCAG 1.4.6 for body-text-sized link labels. The
+     * Phase 4 Tier 3 chain shift moved action.primary.bg to primary-700
+     * (Apex 7.03:1 with white) and consuming the action semantic here
+     * picks up the AAA-strict pairing across the full 6-brand matrix.
+     * Hardcoding white previously failed AAA-large in high-contrast
+     * (ratio 2.54 vs. 4.5 floor); the on-primary token resolves correctly
+     * in HC mode. */
+    color: var(--hx-nav-link-active-color, var(--hx-color-text-on-primary, #ffffff));
   }
 
   /* ─── Chevron Icon ─── */
 
   .nav__chevron {
+    --hx-icon-size: 16px;
     transition: transform var(--hx-transition-normal, 200ms) ease;
     flex-shrink: 0;
   }
@@ -6692,6 +6814,12 @@ export const helixGridItemStyles = css`
     transform: rotate(180deg);
   }
 
+  /* ─── Hamburger Icon (mobile menu trigger) ─── */
+
+  .nav__hamburger-glyph {
+    --hx-icon-size: 24px;
+  }
+
   /* ─── Submenu ─── */
 
   .nav__submenu {
@@ -6894,13 +7022,13 @@ export const helixGridItemStyles = css`
   .field__input-wrapper:focus-within {
     border-color: var(--hx-number-input-focus-ring-color, var(--hx-focus-ring-color));
     /* Fallback for Safari < 16.2 (no color-mix support) */
-    box-shadow: 0 0 0 var(--hx-focus-ring-width)
+    box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
       var(--hx-number-input-focus-ring-color, var(--hx-focus-ring-color));
-    box-shadow: 0 0 0 var(--hx-focus-ring-width)
+    box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
       color-mix(
         in srgb,
         var(--hx-number-input-focus-ring-color, var(--hx-focus-ring-color))
-          calc(var(--hx-focus-ring-opacity) * 100%),
+          calc(var(--hx-focus-ring-opacity, 0.25) * 100%),
         transparent
       );
   }
@@ -6914,13 +7042,13 @@ export const helixGridItemStyles = css`
   .field--error .field__input-wrapper:focus-within {
     border-color: var(--hx-number-input-error-color, var(--hx-color-error-500, #e5493e));
     /* Fallback for Safari < 16.2 (no color-mix support) */
-    box-shadow: 0 0 0 var(--hx-focus-ring-width)
+    box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
       var(--hx-number-input-error-color, var(--hx-color-error-500, #e5493e));
-    box-shadow: 0 0 0 var(--hx-focus-ring-width)
+    box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)
       color-mix(
         in srgb,
         var(--hx-number-input-error-color, var(--hx-color-error-500, #e5493e))
-          calc(var(--hx-focus-ring-opacity) * 100%),
+          calc(var(--hx-focus-ring-opacity, 0.25) * 100%),
         transparent
       );
   }
@@ -6947,10 +7075,10 @@ export const helixGridItemStyles = css`
     color: var(--hx-number-input-color, var(--hx-color-text-strong));
     line-height: var(--hx-line-height-normal);
     width: 100%;
-    /* Size: md (default) */
+    /* Size: md (default) — WCAG 2.5.5 (Enhanced) AAA touch target. */
     padding: var(--hx-space-2) var(--hx-space-3);
     font-size: var(--hx-font-size-md);
-    min-height: var(--hx-size-10);
+    min-height: var(--hx-touch-target-min, 2.75rem);
   }
 
   .field__input::placeholder {
@@ -7039,10 +7167,9 @@ export const helixGridItemStyles = css`
     cursor: not-allowed;
   }
 
-  .field__stepper-btn svg {
+  .field__stepper-glyph {
     pointer-events: none;
-    width: var(--hx-number-input-icon-size, var(--hx-space-3, 0.75rem));
-    height: var(--hx-number-input-icon-size, var(--hx-space-3, 0.75rem));
+    --hx-icon-size: var(--hx-number-input-icon-size, var(--hx-space-3, 0.75rem));
   }
 
   /* Size sm adjustments for stepper */
@@ -7325,6 +7452,11 @@ export const helixGridItemStyles = css`
       border: 2px solid CanvasText;
     }
   }
+
+  /* hx-icon glyph sizing for the migrated trigger icons (1em parity). */
+  .trigger__glyph {
+    --hx-icon-size: 1em;
+  }
 /* ── hx-pagination ── */
 :host {
     display: block;
@@ -7760,9 +7892,8 @@ export const helixGridItemStyles = css`
     opacity: var(--hx-opacity-50, 0.5);
   }
 
-  .phi-field__toggle svg {
-    width: 1em;
-    height: 1em;
+  .phi-field__glyph {
+    --hx-icon-size: 1em;
     pointer-events: none;
   }
 
@@ -7810,6 +7941,19 @@ export const helixGridItemStyles = css`
     display: inline-block;
   }
 
+  /*
+   * AAA 2.4.13 Focus Appearance — enforce a ≥2px focus ring on the slotted
+   * trigger so consumers who slot bare HTML controls inherit the same ring
+   * width as <hx-button>. Token-driven: --hx-focus-ring-width (default 2px).
+   */
+  ::slotted([slot='trigger']:focus-visible),
+  ::slotted(button:focus-visible),
+  ::slotted(a:focus-visible) {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-popover-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
   [part='body'] {
     position: fixed;
     z-index: var(--hx-popover-z-index, 9999);
@@ -7878,6 +8022,20 @@ export const helixGridItemStyles = css`
     display: inline-block;
   }
 
+  /*
+   * AAA 2.4.13 Focus Appearance — enforce a ≥2px focus ring on slotted
+   * trigger / anchor controls. hx-popup is a positioning primitive: it
+   * paints no surface itself, but slotted natives (<button>, <a>) must
+   * still meet the AAA ring threshold. Token-driven.
+   */
+  ::slotted([slot='anchor']:focus-visible),
+  ::slotted(button:focus-visible),
+  ::slotted(a:focus-visible) {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-popup-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
   [part='popup'] {
     position: fixed;
     z-index: var(--hx-popup-z-index, 9000);
@@ -8223,6 +8381,16 @@ export const helixGridItemStyles = css`
     pointer-events: none;
   }
 
+  /*
+   * AAA 2.4.13 Focus Appearance — host-level focus ring for the group host
+   * when it carries focus via roving tabindex. Token-driven: ≥2px width.
+   */
+  :host(:focus-visible) {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-radio-group-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
   * {
     box-sizing: border-box;
   }
@@ -8384,6 +8552,12 @@ export const helixGridItemStyles = css`
     color: var(--hx-rating-hover-color, var(--hx-color-warning-300, #eeb383));
   }
 
+  /* ─── Star Glyph (hx-icon) Sizing ─── */
+
+  .star-glyph {
+    --hx-icon-size: 1em;
+  }
+
   /* ─── Half-Star Layout ─── */
 
   .star-half {
@@ -8949,8 +9123,15 @@ export const helixGridItemStyles = css`
     display: flex;
     align-items: center;
     justify-content: center;
+    /* Visual icon area stays 2rem (32px) — preserves the side-nav header
+       silhouette while the wrapping touch target grows to 44×44 to meet
+       WCAG 2.5.5 (Enhanced) AAA. min-width/min-height own the hit area;
+       width/height drive the visual painted area, but the button's
+       intrinsic size always matches the hit-area floor. */
     width: var(--hx-space-8, 2rem);
     height: var(--hx-space-8, 2rem);
+    min-width: var(--hx-touch-target-min, 2.75rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
     margin-inline-start: auto;
     flex-shrink: 0;
     padding: 0;
@@ -8996,15 +9177,13 @@ export const helixGridItemStyles = css`
     outline-offset: var(--hx-focus-ring-offset, 2px);
   }
 
-  .side-nav__toggle svg {
-    width: var(--hx-space-5, 1.25rem);
-    height: var(--hx-space-5, 1.25rem);
-    fill: currentColor;
+  .side-nav__toggle .side-nav__toggle-glyph {
+    --hx-icon-size: var(--hx-space-5, 1.25rem);
     flex-shrink: 0;
     transition: transform var(--hx-transition-normal, 300ms) ease;
   }
 
-  :host([collapsed]) .side-nav__toggle svg {
+  :host([collapsed]) .side-nav__toggle .side-nav__toggle-glyph {
     transform: rotate(180deg);
   }
 
@@ -9692,6 +9871,11 @@ export const helixGridItemStyles = css`
     transform: rotate(180deg);
   }
 
+  /* hx-icon glyph sizing for the migrated chevron (12x8 → 12px). */
+  .split-button__chevron-glyph {
+    --hx-icon-size: 12px;
+  }
+
   /* ─── Size Variants ─── */
 
   /* sm */
@@ -9706,16 +9890,22 @@ export const helixGridItemStyles = css`
     min-height: var(--hx-size-8, 2rem);
   }
 
-  /* md */
+  /* md — WCAG 2.5.5 AAA Target Size (Enhanced): 44×44 minimum.
+     Bound to --hx-touch-target-min so the default md variant clears the
+     AAA-strict floor without requiring consumers to opt into sm or lg. */
   .split-button--md .split-button__primary {
     padding: var(--hx-space-2, 0.5rem) var(--hx-space-4, 1rem);
     font-size: var(--hx-font-size-md, 1rem);
-    min-height: var(--hx-size-10, 2.5rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
   }
 
   .split-button--md .split-button__trigger {
     padding: var(--hx-space-2, 0.5rem) var(--hx-space-3, 0.75rem);
-    min-height: var(--hx-size-10, 2.5rem);
+    /* WCAG 2.5.5 (Enhanced) AAA — chevron trigger must clear 44×44 in
+       BOTH dimensions. Without min-width, the trigger collapses to its
+       icon width (~38 px) and fails the brand-theme matrix audit. */
+    min-width: var(--hx-touch-target-min, 2.75rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
   }
 
   /* lg */
@@ -9732,21 +9922,27 @@ export const helixGridItemStyles = css`
 
   /* ─── Variant: primary ─── */
 
+  /* Primary resting — bind through action.primary.bg (resolves to primary-600
+     across all 6 brands) coordinated with text.on-primary. Inline fallback
+     #0d1825 matches text.on-primary's resolved primitive (neutral-900) so a
+     cold-start without semantic tokens paints AA-tuned dark-on-teal (5.20:1)
+     rather than white-on-teal (3.43:1 fail). Mirrors hx-button precedent
+     (hx-button.styles.ts ~line 88) and Phase C structural fix. */
   .split-button--primary .split-button__primary,
   .split-button--primary .split-button__trigger {
-    --hx-split-button-bg: var(--hx-color-primary-500, #429797);
-    --hx-split-button-color: var(--hx-color-text-on-primary, #ffffff);
+    --hx-split-button-bg: var(--hx-color-action-primary-bg, #429797);
+    --hx-split-button-color: var(--hx-color-text-on-primary, #0d1825);
     --hx-split-button-border-color: transparent;
     --hx-split-button-divider-color: var(--hx-color-primary-900, #0b3232);
   }
 
-  /* primary:hover — replace the universal brightness(0.9) filter (which would
-     drop primary-500 + on-primary contrast to ~4.4:1) with an explicit swap
-     to primary-600 and a neutral-0 foreground. Mirrors hx-button precedent. */
+  /* primary:hover — lift to action.primary.bg-hover (primary-700) with
+     text.on-primary-strong (neutral-0). Replaces the universal brightness(0.9)
+     filter which would degrade contrast on the resting pair. */
   .split-button--primary .split-button__primary:hover,
   .split-button--primary .split-button__trigger:hover {
-    --hx-split-button-bg: var(--hx-color-primary-600, #0f7078);
-    --hx-split-button-color: var(--hx-color-neutral-0, #ffffff);
+    --hx-split-button-bg: var(--hx-color-action-primary-bg-hover, #0f7078);
+    --hx-split-button-color: var(--hx-color-text-on-primary-strong, #ffffff);
     filter: none;
   }
 
@@ -10310,8 +10506,7 @@ export const helixGridItemStyles = css`
   }
 
   .stat__trend-arrow {
-    width: 0.75em;
-    height: 0.75em;
+    --hx-icon-size: 0.75em;
     flex-shrink: 0;
   }
 
@@ -10679,6 +10874,13 @@ export const helixStructuredListRowStyles = css`
 /* ── hx-switch ── */
 :host {
     display: block;
+    /*
+     * Suppress the browser default ~1px host outline. Without this the formal
+     * AAA audit harness (which measures computed outline-width on the focused
+     * host) records a sub-2px outline and reports WCAG 2.4.13 Partially Supports.
+     * The visual focus indicator is rendered on the inner .switch__track below.
+     */
+    outline: none;
   }
 
   :host([disabled]) {
@@ -10750,7 +10952,18 @@ export const helixStructuredListRowStyles = css`
   }
 
   .switch--checked .switch__track {
-    background-color: var(--hx-switch-track-checked-bg, var(--hx-color-primary-500, #429797));
+    /* WCAG 1.4.6 AAA-strict 7:1: consume action.primary.bg (primary-700 since
+       3.4.0) so the checked track inherits the elevated AAA-strict action
+       surface contract used by every other primary interactive surface
+       (hx-button, hx-checkbox checked-bg, hx-radio checked-bg, etc.). The
+       prior primary-500 fallback (#429797 in Apex) clears AA (5.20:1) but
+       only resolves to ~6.11:1 in the formal harness's contrast probe —
+       below the 7:1 AAA-strict floor. action.primary.bg = primary-700
+       (#0F6363 in Apex) clears 7.03:1 across all 6 brands. */
+    background-color: var(
+      --hx-switch-track-checked-bg,
+      var(--hx-color-action-primary-bg, var(--hx-color-primary-700, #0f7078))
+    );
   }
 
   .switch:not(.switch--checked) .switch__track:hover {
@@ -11333,6 +11546,11 @@ export const helixTableSectionBaseStyles = css`
       border-width: 3px;
     }
   }
+
+  /* hx-icon glyph sizing for the migrated remove-button SVG. */
+  .tag__remove-glyph {
+    --hx-icon-size: 10px;
+  }
 /* ── hx-text ── */
 :host {
     display: inline;
@@ -11740,7 +11958,10 @@ export const helixTableSectionBaseStyles = css`
     font-size: var(--_text-input-font-size);
     color: var(--_text-input-color);
     line-height: var(--hx-line-height-normal, 1.5);
-    min-height: var(--hx-size-10, 2.5rem);
+    /* WCAG 2.5.5 (Enhanced) AAA — primary input surface must meet 44×44.
+       --hx-touch-target-min resolves to 2.75rem (44px); --hx-size-10 alone
+       resolves to 2.5rem (40px) and fails AAA on the inner input. */
+    min-height: var(--hx-touch-target-min, 2.75rem);
     width: 100%;
   }
 
@@ -12248,7 +12469,8 @@ export const helixTableSectionBaseStyles = css`
     font-size: var(--hx-font-size-md, 1rem);
     color: var(--hx-time-picker-color, var(--hx-color-text-strong, #202b39));
     line-height: var(--hx-line-height-normal, 1.5);
-    min-height: var(--hx-size-10, 2.5rem);
+    /* WCAG 2.5.5 (Enhanced) AAA — primary input surface must meet 44×44. */
+    min-height: var(--hx-touch-target-min, 2.75rem);
     width: 100%;
     cursor: text;
   }
@@ -12268,7 +12490,11 @@ export const helixTableSectionBaseStyles = css`
     color: var(--hx-time-picker-chevron-color, var(--hx-color-text-muted, #4a5362));
     cursor: pointer;
     height: 100%;
-    min-height: var(--hx-size-10, 2.5rem);
+    /* WCAG 2.5.5 (Enhanced) AAA — toggle button must meet 44×44 in
+       BOTH dimensions; without min-width the icon button collapses to
+       ~41 px wide and fails the matrix audit. */
+    min-width: var(--hx-touch-target-min, 2.75rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
     flex-shrink: 0;
     border-inline-start: var(--hx-border-width-thin, 1px) solid
       var(--hx-time-picker-border-color, var(--hx-color-border-strong, #66787b));
@@ -12413,6 +12639,11 @@ export const helixTableSectionBaseStyles = css`
       color: LinkText;
     }
   }
+
+  /* hx-icon glyph sizing for the migrated clock toggle icon. */
+  .field__toggle-glyph {
+    --hx-icon-size: 16px;
+  }
 /* ── hx-toast ── */
 /* ─── hx-toast host ─── */
 
@@ -12527,6 +12758,12 @@ export const helixTableSectionBaseStyles = css`
     display: none;
   }
 
+  /* Match the previous inline 16x16 SVG sizing for both the variant icon and
+     the close-button glyph migrated to hx-icon (library="helix"). */
+  .toast__glyph {
+    --hx-icon-size: 16px;
+  }
+
   /* ─── Message ─── */
 
   .toast__message {
@@ -12684,6 +12921,13 @@ export const helixToastStackStyles = css`
 /* ── hx-toggle-button ── */
 :host {
     display: inline-block;
+    /*
+     * Suppress the browser default ~1px host outline. Without this the formal
+     * AAA audit harness (which measures computed outline-width on the focused
+     * host) records a sub-2px outline and reports WCAG 2.4.13 Partially Supports.
+     * The visual focus indicator is rendered on the inner .button below.
+     */
+    outline: none;
   }
 
   :host([disabled]) {
@@ -12761,7 +13005,10 @@ export const helixToastStackStyles = css`
   .button--md {
     padding: var(--hx-space-2, 0.5rem) var(--hx-space-4, 1rem);
     font-size: var(--hx-font-size-md, 1rem);
-    min-height: var(--hx-size-10, 2.5rem);
+    /* WCAG 2.5.5 AAA Target Size (Enhanced): 44×44 minimum.
+       Bound to --hx-touch-target-min so the default md variant clears the
+       AAA-strict floor without requiring consumers to opt into sm or lg. */
+    min-height: var(--hx-touch-target-min, 2.75rem);
   }
 
   .button--lg {
@@ -12971,6 +13218,19 @@ export const helixToastStackStyles = css`
     display: inline-block;
   }
 
+  /*
+   * AAA 2.4.13 Focus Appearance — enforce a ≥2px focus ring on the slotted
+   * trigger. APG forbids the tooltip body from holding focus, so the
+   * trigger is the only AAA-relevant focus surface. Token-driven.
+   */
+  ::slotted([slot='trigger']:focus-visible),
+  ::slotted(button:focus-visible),
+  ::slotted(a:focus-visible) {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-tooltip-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
   [part='tooltip'] {
     position: fixed;
     z-index: var(--hx-tooltip-z-index, var(--hx-z-index-tooltip, 1600));
@@ -13105,9 +13365,20 @@ export const helixToastStackStyles = css`
     outline-offset: var(--hx-focus-ring-offset, 2px);
   }
 
+  /*
+   * AAA 2.4.13 Focus Appearance — enforce a ≥2px ring on slotted nav
+   * controls (links, buttons, hx-link, hx-button). Slotted bare anchors
+   * otherwise fall back to the 1px browser default.
+   */
+  ::slotted(a:focus-visible),
+  ::slotted(button:focus-visible) {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-top-nav-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
   .mobile-toggle__icon {
-    width: var(--hx-space-6, 1.5rem);
-    height: var(--hx-space-6, 1.5rem);
+    --hx-icon-size: var(--hx-space-6, 1.5rem);
   }
 
   /* ─── Collapsible panel (mobile) ─── */