@helixui/library 3.3.1-next.118 → 3.4.0

package/dist/components/hx-tree-view/hx-tree-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tree-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-item.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA8C;IAIpE;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAIjB;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAS;IAEtC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,UAAU,CAAM;IAEjC;;;;OAIG;IACM,OAAO,CAAC,MAAM,CAAK;IAC5B;;;OAGG;IACM,OAAO,CAAC,SAAS,CAAK;IAC/B;;;OAGG;IACM,OAAO,CAAC,QAAQ,CAAK;IAC9B;;;OAGG;IACM,OAAO,CAAC,WAAW,CAAS;IAErC,gBAAgB;IACI,OAAO,CAAC,UAAU,CAAsB;IAI5D;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IASnF,iBAAiB,IAAI,IAAI;IAOlC;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAWvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAItC,iDAAiD;IACxC,KAAK,IAAI,IAAI;IAMtB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBhB,MAAM;CA0ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC"}
+{"version":3,"file":"hx-tree-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA8C;IAEpE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAI9D;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAIjB;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAS;IAEtC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,UAAU,CAAM;IAEjC;;;;OAIG;IACM,OAAO,CAAC,MAAM,CAAK;IAC5B;;;OAGG;IACM,OAAO,CAAC,SAAS,CAAK;IAC/B;;;OAGG;IACM,OAAO,CAAC,QAAQ,CAAK;IAC9B;;;OAGG;IACM,OAAO,CAAC,WAAW,CAAS;IAErC,gBAAgB;IACI,OAAO,CAAC,UAAU,CAAsB;IAI5D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,uBAAuB,CAAM;IAIrC;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IASnF,iBAAiB,IAAI,IAAI;IA0BzB,oBAAoB,IAAI,IAAI;IAQ5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAsB/D;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,sBAAsB;IA2E9B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAOjC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,WAAW;IAYnB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAWjB,gBAAgB;IAChB,OAAO,CAAC,YAAY,CAsBlB;IAEF,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAiCpB;IAIF;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKtC;;;;;OAKG;IACM,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAU5C;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBhB,MAAM;CA6EhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC"}

package/dist/components/hx-tree-view/hx-tree-view.d.ts

@@ -1,3 +1,4 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 import { HelixTreeItem } from './hx-tree-item.js';
 /** Selection mode for the tree. */
@@ -13,10 +14,20 @@ export interface HxSelectDetail {
  * A hierarchical tree component for navigating nested data structures.
  * Used in healthcare applications for org charts, ICD-10 code hierarchies, and department navigation.
  *
- * Implements WAI-ARIA tree view pattern with `role="tree"` on the container
- * and `role="treeitem"` on each item. Supports `aria-label` via the `label` property
- * for screen reader identification. Full keyboard navigation: Arrow keys for movement,
- * Enter/Space for selection, Home/End for first/last item.
+ * Group 5c host-canonical: `role="tree"` lives on the **host** via
+ * `_internals.role` on the modern path. The host carries the announced
+ * surface so AT walks `<hx-tree-view>` (role=tree) → slotted
+ * `<hx-tree-item>` (role=treeitem on host) directly without two layers of
+ * indirection. Consumer-supplied `aria-label` / `aria-labelledby` on the
+ * host are resolved via the shared IDREF mirror; cross-shadow naming uses
+ * `ariaLabelledByElements` (modern) with a flattened-string fallback
+ * (legacy). On the legacy fallback path the inner `[role="tree"]` carries
+ * the role + accessible name and the host role is suppressed so AT only
+ * sees one tree per logical surface (mirrors `hx-menu` round-8).
+ *
+ * Full keyboard navigation: Arrow keys for movement, Enter/Space for
+ * selection, Home/End for first/last item, ArrowRight/Left for
+ * expand/collapse + parent/child traversal, typeahead.
  *
  * ## Scale Limits
  *
@@ -35,7 +46,7 @@ export interface HxSelectDetail {
  *
  * @fires {CustomEvent<HxSelectDetail>} hx-select - Dispatched when a tree item is selected or deselected.
  *
- * @csspart tree - The tree container element with role="tree".
+ * @csspart tree - The tree container element with role="tree" (legacy fallback path) or the inner shadow surface (modern path; role lives on the host).
  *
  * @cssprop [--hx-tree-font-family=var(--hx-font-family-sans)] - Tree font family.
  * @cssprop [--hx-font-family-sans] - Font family.
@@ -48,8 +59,11 @@ export interface HxSelectDetail {
 export declare class HelixTreeView extends HelixElement {
     static styles: import('lit').CSSResult[];
     /**
-     * Accessible label for the tree. Applied as `aria-label` on the tree container.
-     * Provides context to screen readers about the tree's purpose.
+     * Accessible label for the tree. Used as a fallback when no
+     * consumer-supplied `aria-label` / `aria-labelledby` is present on the
+     * host. On the modern host-canonical path this projects onto
+     * `internals.ariaLabel`; on the legacy fallback path it appears as
+     * `aria-label` on the inner `[role="tree"]` element.
      * @attr label
      */
     label: string;
@@ -66,6 +80,32 @@ export declare class HelixTreeView extends HelixElement {
     /** Tracks whether the tree has any visible items, to decide the container tabindex. */
     /** @internal */
     private _hasVisibleItems;
+    /**
+     * Test seam (codex push-gate round-1 lift from group 5b): when set to
+     * `true` or `false`, overrides the platform `supportsIdrefElementReferences`
+     * probe before `connectedCallback` seeds `_supportsIdrefRefs`. Mirrors the
+     * hx-menu / hx-menu-item / hx-select seam — required so tests can
+     * deterministically exercise the legacy fallback render branch.
+     *
+     * Production code MUST NOT touch this field. It is `static` so the test
+     * stub cleanup is global and obvious.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /**
+     * Resolved accessible name for the tree — the single source of truth read
+     * by `_syncHostAriaSemantics()` (modern path: writes to
+     * `internals.ariaLabel`) and the fallback `render()` branch (legacy path:
+     * writes to inner `div[role="tree"]` `aria-label`). AccName 1.2 §4.3.1
+     * precedence: consumer host `aria-labelledby` (resolved + flattened) >
+     * consumer host `aria-label` > `label` property > literal "Tree".
+     * @internal
+     */
+    private _resolvedAccessibleName;
     /**
      * Cached flat list of visible items (depth-first, respects collapsed nodes).
      * Set to null to invalidate; rebuilt on next access.
@@ -98,8 +138,28 @@ export declare class HelixTreeView extends HelixElement {
     private _focusItem;
     /** @internal */
     private _handleTreeItemSelect;
+    /**
+     * Codex push-gate round-1 lift (mirrors hx-menu round-7 finding 2):
+     * `hx-tree-item-select` bubbles composed through every enclosing
+     * `hx-tree-view`. The outer tree would otherwise corrupt `_currentIndex`
+     * to `-1` (the bubbled item is not in its top-level list) and re-emit a
+     * duplicate `hx-select`. Only act when THIS tree is the closest
+     * enclosing tree of the dispatching item.
+     * @internal
+     */
+    private _handleItemSelectHost;
     /** @internal */
     private _handleKeyDown;
+    /**
+     * Codex push-gate round-1 lift (mirrors hx-menu round-7 finding 1):
+     * keydown bound on the host receives events bubbled out of nested
+     * tree-views. Without this guard the outer tree would run `_focusItem`
+     * over its own top-level items and steal focus back out of the inner
+     * tree. Only act when THIS tree is the closest enclosing tree of the
+     * keydown target.
+     * @internal
+     */
+    private _handleHostKeyDown;
     /**
      * Finds the next visible item (starting after `currentIndex`, wrapping around) whose
      * label text begins with the given lowercase character. Returns -1 if no match.
@@ -124,7 +184,27 @@ export declare class HelixTreeView extends HelixElement {
      */
     /** @internal */
     private _handleSlotChange;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProperties: PropertyValues<this>): void;
     firstUpdated(): void;
+    /**
+     * Mirror tree semantics onto the host via ElementInternals so consumer-
+     * supplied `aria-label`, `aria-labelledby`, and the `label` property all
+     * reach the announced control. Falls back to a flattened-string label on
+     * engines that do not implement `ariaLabelledByElements`.
+     *
+     * Codex push-gate round-1 lift (mirrors hx-menu round-8 finding 1): on
+     * the legacy fallback path the inner `<div role="tree" aria-label="…">`
+     * is the announced surface. If we ALSO write `internals.role = 'tree'`
+     * onto the host, AT sees TWO trees for one logical surface — the
+     * duplicate-surface problem host-canonical migration is meant to
+     * eliminate. Suppress host role + label writes on the fallback path; the
+     * inner element is the canonical announced surface there. Modern path
+     * keeps the host as the canonical surface and clears the inner role.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

package/dist/components/hx-tree-view/hx-tree-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tree-view.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-view.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,mBAAmB,CAAC;AAG/E,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA8C;IAIpE;;;;OAIG;IAEH,KAAK,SAAM;IAEX;;;;;;OAMG;IAEH,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAU;IAInD,gBAAgB;IACP,OAAO,CAAC,aAAa,CAAK;IAEnC,uFAAuF;IACvF,gBAAgB;IACP,OAAO,CAAC,gBAAgB,CAAS;IAI1C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAgC;IAE3D;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAMpC;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAOxB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAgB5B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAM7B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAWlB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IA0B7B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IA0FtB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAa3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAYtB;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;IAavC;;;;;;OAMG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAehB,YAAY,IAAI,IAAI;IAWpB,MAAM;CA2BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC"}
+{"version":3,"file":"hx-tree-view.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,mBAAmB,CAAC;AAW/E,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA8C;IAIpE;;;;;;;OAOG;IAEH,KAAK,SAAM;IAEX;;;;;;OAMG;IAEH,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAU;IAInD,gBAAgB;IACP,OAAO,CAAC,aAAa,CAAK;IAEnC,uFAAuF;IACvF,gBAAgB;IACP,OAAO,CAAC,gBAAgB,CAAS;IAI1C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB,CAAM;IAIrC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAgC;IAE3D;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAMpC;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAOxB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAgB5B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAM7B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAWlB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IA0B7B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB,CAQ3B;IAEF,gBAAgB;IAChB,OAAO,CAAC,cAAc;IA4FtB;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB,CAMxB;IAEF;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAa3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAYtB;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;IAavC;;;;;;OAMG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAehB,iBAAiB,IAAI,IAAI;IAyBzB,oBAAoB,IAAI,IAAI;IAQ5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAiBtD,YAAY,IAAI,IAAI;IAa7B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,sBAAsB;IAqErB,MAAM;CA0ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC"}

package/dist/components/hx-tree-view/index.js

@@ -1,4 +1,4 @@
-import { H as a, a as i } from "../../shared/hx-tree-item-C2CiWuDE.js";
+import { H as a, a as i } from "../../shared/hx-tree-item-CHrUhuZL.js";
 export {
   a as HelixTreeItem,
   i as HelixTreeView

package/dist/css/helix-all.css

@@ -258,6 +258,15 @@
     min-width: 0;
   }
 
+  /* (group-6 5.1) Wrapper around the default slot. Carries aria-hidden=true
+     so the visible message text is not double-announced alongside the
+     sr-only announcer. display:contents keeps the wrapper visually
+     transparent so children participate in the parent flex layout as if
+     the wrapper were not there. */
+  .alert__default-slot {
+    display: contents;
+  }
+
   /* ─── Actions ─── */
   /* Hidden by default; shown via JS slotchange detection to avoid invisible  */
   /* margin-top spacing when no actions are slotted.                          */
@@ -721,6 +730,9 @@
   @media (forced-colors: active) {
     .badge {
       border: 1px solid CanvasText;
+      forced-color-adjust: none;
+      background-color: Canvas;
+      color: CanvasText;
     }
 
     .badge--pulse {
@@ -730,6 +742,31 @@
     .badge__remove-button {
       color: ButtonText;
     }
+
+    /* Per-semantic-variant forced-colors fallbacks. The visually-hidden
+       semantic variant label (.badge__variant-label) keeps AT users
+       informed; these blocks restore visual semantic distinction for
+       sighted users in HCM where bg/color collapse to system defaults.
+       Pattern: distinct border-style per variant. */
+    .badge--success {
+      border-style: solid;
+      border-width: 2px;
+    }
+
+    .badge--warning {
+      border-style: dashed;
+      border-width: 2px;
+    }
+
+    .badge--error {
+      border-style: double;
+      border-width: 3px;
+    }
+
+    .badge--info {
+      border-style: dotted;
+      border-width: 2px;
+    }
   }
 /* ── hx-banner ── */
 :host {
@@ -5106,6 +5143,23 @@
     margin: 0;
   }
 
+  /* ─── Synthesized consumer-description span ─── */
+  /* Visually hidden mirror of consumer-resolved aria-describedby text used by */
+  /* the host-canonical ARIA pipeline. Always present in the shadow tree so AT */
+  /* can resolve the same-root id even when the description is currently empty. */
+
+  .drawer-sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
+
   /* ─── Body ─── */
 
   .drawer-body {
@@ -6041,12 +6095,37 @@ export const helixGridItemStyles = css`
        multiplicative stacking (0.5 * 0.5 = 0.25). Do not add opacity here. */
   }
 
+  /* ─── Loading State ─── */
+
+  .button--loading {
+    position: relative;
+    cursor: wait;
+  }
+
+  .button__spinner {
+    width: 1em;
+    height: 1em;
+    flex-shrink: 0;
+    animation: hx-icon-button-spin var(--hx-duration-spinner, 750ms) linear infinite;
+  }
+
+  @keyframes hx-icon-button-spin {
+    to {
+      transform: rotate(360deg);
+    }
+  }
+
   /* ─── Reduced Motion ─── */
 
   @media (prefers-reduced-motion: reduce) {
     .button {
       transition: none;
     }
+
+    .button__spinner {
+      animation: none;
+      opacity: var(--hx-opacity-muted, 0.6);
+    }
   }
 
   /* ─── High Contrast Mode (forced-colors) ─── */
@@ -6074,6 +6153,11 @@ export const helixGridItemStyles = css`
     :host([disabled]) {
       opacity: 1;
     }
+
+    .button--loading .button__spinner {
+      stroke: ButtonText;
+      forced-color-adjust: none;
+    }
   }
 /* ── hx-image ── */
 :host {
@@ -6451,6 +6535,11 @@ export const helixGridItemStyles = css`
   /* ─── Forced Colors (Windows High Contrast) ─── */
 
   @media (forced-colors: active) {
+    .meter:focus-visible {
+      outline: 2px solid Highlight;
+      outline-offset: var(--hx-focus-ring-offset, 2px);
+    }
+
     .meter__track {
       border: 1px solid CanvasText;
     }
@@ -11184,11 +11273,34 @@ export const helixTableSectionBaseStyles = css`
   @media (forced-colors: active) {
     .tag {
       border-color: CanvasText;
+      forced-color-adjust: none;
+      background-color: Canvas;
+      color: CanvasText;
     }
 
     .tag__remove-button {
       color: ButtonText;
     }
+
+    /* Per-semantic-variant forced-colors fallbacks. The visually-hidden
+       semantic variant label (.tag__variant-label) keeps AT users
+       informed; these blocks restore visual semantic distinction for
+       sighted users in HCM where bg/color collapse to system defaults.
+       Pattern: distinct border-style per variant (matches hx-badge). */
+    .tag--success {
+      border-style: solid;
+      border-width: 2px;
+    }
+
+    .tag--warning {
+      border-style: dashed;
+      border-width: 2px;
+    }
+
+    .tag--danger {
+      border-style: double;
+      border-width: 3px;
+    }
   }
 /* ── hx-text ── */
 :host {
@@ -12218,6 +12330,17 @@ export const helixTableSectionBaseStyles = css`
   .field__error {
     color: var(--hx-time-picker-error-color, var(--hx-color-error-text, #c92a2a));
   }
+  .field__sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
   @media (forced-colors: active) {
     .field__combobox {
       border-color: ButtonText;

package/dist/css/helix-core.css

@@ -337,6 +337,9 @@
   @media (forced-colors: active) {
     .badge {
       border: 1px solid CanvasText;
+      forced-color-adjust: none;
+      background-color: Canvas;
+      color: CanvasText;
     }
 
     .badge--pulse {
@@ -346,6 +349,31 @@
     .badge__remove-button {
       color: ButtonText;
     }
+
+    /* Per-semantic-variant forced-colors fallbacks. The visually-hidden
+       semantic variant label (.badge__variant-label) keeps AT users
+       informed; these blocks restore visual semantic distinction for
+       sighted users in HCM where bg/color collapse to system defaults.
+       Pattern: distinct border-style per variant. */
+    .badge--success {
+      border-style: solid;
+      border-width: 2px;
+    }
+
+    .badge--warning {
+      border-style: dashed;
+      border-width: 2px;
+    }
+
+    .badge--error {
+      border-style: double;
+      border-width: 3px;
+    }
+
+    .badge--info {
+      border-style: dotted;
+      border-width: 2px;
+    }
   }
 /* ── hx-button ── */
 :host {
@@ -1430,12 +1458,37 @@
        multiplicative stacking (0.5 * 0.5 = 0.25). Do not add opacity here. */
   }
 
+  /* ─── Loading State ─── */
+
+  .button--loading {
+    position: relative;
+    cursor: wait;
+  }
+
+  .button__spinner {
+    width: 1em;
+    height: 1em;
+    flex-shrink: 0;
+    animation: hx-icon-button-spin var(--hx-duration-spinner, 750ms) linear infinite;
+  }
+
+  @keyframes hx-icon-button-spin {
+    to {
+      transform: rotate(360deg);
+    }
+  }
+
   /* ─── Reduced Motion ─── */
 
   @media (prefers-reduced-motion: reduce) {
     .button {
       transition: none;
     }
+
+    .button__spinner {
+      animation: none;
+      opacity: var(--hx-opacity-muted, 0.6);
+    }
   }
 
   /* ─── High Contrast Mode (forced-colors) ─── */
@@ -1463,6 +1516,11 @@
     :host([disabled]) {
       opacity: 1;
     }
+
+    .button--loading .button__spinner {
+      stroke: ButtonText;
+      forced-color-adjust: none;
+    }
   }
 /* ── hx-image ── */
 :host {
@@ -2007,11 +2065,34 @@
   @media (forced-colors: active) {
     .tag {
       border-color: CanvasText;
+      forced-color-adjust: none;
+      background-color: Canvas;
+      color: CanvasText;
     }
 
     .tag__remove-button {
       color: ButtonText;
     }
+
+    /* Per-semantic-variant forced-colors fallbacks. The visually-hidden
+       semantic variant label (.tag__variant-label) keeps AT users
+       informed; these blocks restore visual semantic distinction for
+       sighted users in HCM where bg/color collapse to system defaults.
+       Pattern: distinct border-style per variant (matches hx-badge). */
+    .tag--success {
+      border-style: solid;
+      border-width: 2px;
+    }
+
+    .tag--warning {
+      border-style: dashed;
+      border-width: 2px;
+    }
+
+    .tag--danger {
+      border-style: double;
+      border-width: 3px;
+    }
   }
 /* ── hx-text ── */
 :host {

package/dist/css/helix-feedback.css

@@ -109,6 +109,15 @@
     min-width: 0;
   }
 
+  /* (group-6 5.1) Wrapper around the default slot. Carries aria-hidden=true
+     so the visible message text is not double-announced alongside the
+     sr-only announcer. display:contents keeps the wrapper visually
+     transparent so children participate in the parent flex layout as if
+     the wrapper were not there. */
+  .alert__default-slot {
+    display: contents;
+  }
+
   /* ─── Actions ─── */
   /* Hidden by default; shown via JS slotchange detection to avoid invisible  */
   /* margin-top spacing when no actions are slotted.                          */
@@ -574,6 +583,11 @@
   /* ─── Forced Colors (Windows High Contrast) ─── */
 
   @media (forced-colors: active) {
+    .meter:focus-visible {
+      outline: 2px solid Highlight;
+      outline-offset: var(--hx-focus-ring-offset, 2px);
+    }
+
     .meter__track {
       border: 1px solid CanvasText;
     }

package/dist/css/helix-forms.css

@@ -4403,6 +4403,17 @@
   .field__error {
     color: var(--hx-time-picker-error-color, var(--hx-color-error-text, #c92a2a));
   }
+  .field__sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
   @media (forced-colors: active) {
     .field__combobox {
       border-color: ButtonText;

package/dist/css/helix-overlay.css

@@ -456,6 +456,23 @@
     margin: 0;
   }
 
+  /* ─── Synthesized consumer-description span ─── */
+  /* Visually hidden mirror of consumer-resolved aria-describedby text used by */
+  /* the host-canonical ARIA pipeline. Always present in the shadow tree so AT */
+  /* can resolve the same-root id even when the description is currently empty. */
+
+  .drawer-sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
+
   /* ─── Body ─── */
 
   .drawer-body {

package/dist/css/hx-alert.css

@@ -107,6 +107,15 @@
     min-width: 0;
   }
 
+  /* (group-6 5.1) Wrapper around the default slot. Carries aria-hidden=true
+     so the visible message text is not double-announced alongside the
+     sr-only announcer. display:contents keeps the wrapper visually
+     transparent so children participate in the parent flex layout as if
+     the wrapper were not there. */
+  .alert__default-slot {
+    display: contents;
+  }
+
   /* ─── Actions ─── */
   /* Hidden by default; shown via JS slotchange detection to avoid invisible  */
   /* margin-top spacing when no actions are slotted.                          */

package/dist/css/hx-badge.css

@@ -201,6 +201,9 @@
   @media (forced-colors: active) {
     .badge {
       border: 1px solid CanvasText;
+      forced-color-adjust: none;
+      background-color: Canvas;
+      color: CanvasText;
     }
 
     .badge--pulse {
@@ -210,4 +213,29 @@
     .badge__remove-button {
       color: ButtonText;
     }
+
+    /* Per-semantic-variant forced-colors fallbacks. The visually-hidden
+       semantic variant label (.badge__variant-label) keeps AT users
+       informed; these blocks restore visual semantic distinction for
+       sighted users in HCM where bg/color collapse to system defaults.
+       Pattern: distinct border-style per variant. */
+    .badge--success {
+      border-style: solid;
+      border-width: 2px;
+    }
+
+    .badge--warning {
+      border-style: dashed;
+      border-width: 2px;
+    }
+
+    .badge--error {
+      border-style: double;
+      border-width: 3px;
+    }
+
+    .badge--info {
+      border-style: dotted;
+      border-width: 2px;
+    }
   }

package/dist/css/hx-drawer.css

@@ -239,6 +239,23 @@
     margin: 0;
   }
 
+  /* ─── Synthesized consumer-description span ─── */
+  /* Visually hidden mirror of consumer-resolved aria-describedby text used by */
+  /* the host-canonical ARIA pipeline. Always present in the shadow tree so AT */
+  /* can resolve the same-root id even when the description is currently empty. */
+
+  .drawer-sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
+
   /* ─── Body ─── */
 
   .drawer-body {

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

@@ -151,12 +151,37 @@
        multiplicative stacking (0.5 * 0.5 = 0.25). Do not add opacity here. */
   }
 
+  /* ─── Loading State ─── */
+
+  .button--loading {
+    position: relative;
+    cursor: wait;
+  }
+
+  .button__spinner {
+    width: 1em;
+    height: 1em;
+    flex-shrink: 0;
+    animation: hx-icon-button-spin var(--hx-duration-spinner, 750ms) linear infinite;
+  }
+
+  @keyframes hx-icon-button-spin {
+    to {
+      transform: rotate(360deg);
+    }
+  }
+
   /* ─── Reduced Motion ─── */
 
   @media (prefers-reduced-motion: reduce) {
     .button {
       transition: none;
     }
+
+    .button__spinner {
+      animation: none;
+      opacity: var(--hx-opacity-muted, 0.6);
+    }
   }
 
   /* ─── High Contrast Mode (forced-colors) ─── */
@@ -184,4 +209,9 @@
     :host([disabled]) {
       opacity: 1;
     }
+
+    .button--loading .button__spinner {
+      stroke: ButtonText;
+      forced-color-adjust: none;
+    }
   }