@helixui/react 3.3.1 → 3.4.0

package/dist/components/HxOverflowMenu/types.d.ts

@@ -14,7 +14,9 @@ export interface HxOverflowMenuProps {
     disabled?: boolean;
     /** Icon orientation: vertical (kebab ⋮) or horizontal (meatball ···). */
     icon?: 'vertical' | 'horizontal';
-    /** Accessible label for the trigger button. */
+    /** Accessible label for the trigger button. Used as a fallback when no
+  consumer-supplied `aria-label` / `aria-labelledby` is present on the
+  host. Consumer host attributes win in the AccName 1.2 §4.3.1 cascade. */
     label?: string;
     /** Accessible label for the menu panel. Reflected as `label-menu`. */
     labelMenu?: string;

package/dist/components/HxOverflowMenu/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxOverflowMenu/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,yEAAyE;IACzE,SAAS,CAAC,EACN,MAAM,GACN,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;IAChB,kCAAkC;IAClC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACjC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxOverflowMenu/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,yEAAyE;IACzE,SAAS,CAAC,EACN,MAAM,GACN,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;IAChB,kCAAkC;IAClC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACjC;;0EAEsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}

package/dist/components/HxPopover/HxPopover.d.ts

@@ -3,6 +3,46 @@ import { HxPopoverProps } from './types.js';
 export type { HxPopoverProps };
 /**
  * A popover that displays rich floating content attached to a trigger element.
+
+## Architecture Note: Host-Attribute Label Mirror (group-4 round-1)
+
+Unlike modal dialogs (`hx-dialog` / `hx-drawer`) where the HOST is the
+announced surface and `ElementInternals` projects consumer IDREFs across
+the shadow boundary, `hx-popover`'s announced surface is the inner
+`[part="body"]` element which carries `role="dialog"`. The host does not
+claim a role — it is a structural wrapper around an anchor slot and a
+separate floating panel.
+
+IDL element references on `internals.ariaLabelledByElements` therefore
+cannot help: AT walks the inner body's accessibility node, and IDL refs
+declared on the host are not visible from a shadow-internal descendant
+looking up. The viable cross-shadow path is the host-attribute mirror:
+
+  1. The host observes `aria-label` / `aria-labelledby` mutations.
+  2. On every sync, `aria-labelledby` IDREFs are resolved via
+     `resolveIdrefTokens` (composed-tree walk: host root → ancestor
+     shadow hosts → owner document) and **text-flattened** via
+     `flattenAccName` (AccName 1.2 §4.3.10 hidden-aware).
+  3. The flattened name is written to the inner body's `aria-label`,
+     overriding the `label` property only when consumer naming is set.
+
+Naming precedence (W3C AccName 1.2 §4.3.1):
+
+  1. Host `aria-labelledby` (resolved IDREFs, text-flattened)
+  2. Host `aria-label`
+  3. `label` property
+  4. Hard-coded literal `"Popover"` (last-resort accessible name)
+
+The text-flatten approach forfeits live IDL-ref tracking (mutating a
+referenced element's text re-fires through the shared root observer; see
+`installAriaIdrefMirror`). `aria-controls` is intentionally omitted on
+the trigger — the body lives in shadow DOM and consumer IDREFs cannot
+resolve cross-root from light-DOM (axe-core flags this as a critical
+violation if attempted; see line documenting this exception below).
+
+Slotted label support (e.g. `<slot name="title">`) is deliberately NOT
+added in this round — it would expand the public API surface and is
+tracked as a follow-up enhancement.
  *
  * @example
  * ```tsx

package/dist/components/HxPopover/HxPopover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxPopover.d.ts","sourceRoot":"","sources":["../../../src/components/HxPopover/HxPopover.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;;;;;EAWpB,CAAC;AAEH,eAAe,SAAS,CAAC"}
+{"version":3,"file":"HxPopover.d.ts","sourceRoot":"","sources":["../../../src/components/HxPopover/HxPopover.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,SAAS;;;;;EAWpB,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/dist/components/HxProgressBar/HxProgressBar.d.ts

@@ -3,6 +3,18 @@ import { HxProgressBarProps } from './types.js';
 export type { HxProgressBarProps };
 /**
  * A linear progress indicator for determinate and indeterminate states.
+
+Group 7 host-canonical: `role="progressbar"` is mirrored onto the **host**
+via `_internals.role` (cross-shadow IDREF wiring) AND kept on the inner
+`[role="progressbar"]` track for legacy AT and consumer queries. This is
+the hx-progress-ring dual-surface pattern (Group 7 gold-standard).
+Consumer-supplied `aria-labelledby` / `aria-describedby` on the host
+resolves through the shared IDREF mirror so cross-shadow naming reaches
+the announced surface even when the labels live in another shadow tree.
+
+The internal `aria-live="polite"` announcer for the "Complete" milestone
+is preserved (`role="progressbar"` does NOT imply a live region — an
+explicit live announcer is required for value-update announcements).
  *
  * @example
  * ```tsx

package/dist/components/HxProgressBar/HxProgressBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxProgressBar.d.ts","sourceRoot":"","sources":["../../../src/components/HxProgressBar/HxProgressBar.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa;;EAQxB,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"HxProgressBar.d.ts","sourceRoot":"","sources":["../../../src/components/HxProgressBar/HxProgressBar.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa;;EAQxB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/components/HxSelect/HxSelect.d.ts

@@ -17,6 +17,7 @@ cross-browser styling.
  */
 export declare const HxSelect: import('@lit/react').ReactWebComponent<HelixSelect, {
     onHxChange: string;
+    onInvalid: string;
 }>;
 export default HxSelect;
 //# sourceMappingURL=HxSelect.d.ts.map

package/dist/components/HxSelect/HxSelect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxSelect.d.ts","sourceRoot":"","sources":["../../../src/components/HxSelect/HxSelect.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ;;EAQnB,CAAC;AAEH,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"HxSelect.d.ts","sourceRoot":"","sources":["../../../src/components/HxSelect/HxSelect.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ;;;EASnB,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/dist/components/HxSelect/index.js

@@ -1,4 +1,4 @@
-import { H, H as H2 } from "../../shared/HxSelect-BEm8srcF.js";
+import { H, H as H2 } from "../../shared/HxSelect-BAt_veRr.js";
 export {
   H as HxSelect,
   H2 as default

package/dist/components/HxSelect/types.d.ts

@@ -42,5 +42,7 @@ export interface HxSelectProps {
     labelNoOptions?: string;
     /** Dispatched when the selected option changes. */
     onHxChange?: (event: Event) => void;
+    /** Platform constraint-validation event fired when checkValidity() / reportValidity() determine the value is invalid (form-associated component contract via ElementInternals.setValidity). */
+    onInvalid?: (event: Event) => void;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/components/HxSelect/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxSelect/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;;;;;;;;4CAQwC;IACxC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,mDAAmD;IACnD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxSelect/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;;;;;;;;4CAQwC;IACxC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,mDAAmD;IACnD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,+LAA+L;IAC/L,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpC"}

package/dist/components/HxSplitButton/HxSplitButton.d.ts

@@ -5,6 +5,27 @@ export type { HxSplitButtonProps };
  * A split button combining a primary action button with an attached dropdown
 menu for secondary actions. Implements the ARIA menu button pattern for
 full keyboard and screen reader support.
+
+## Architecture Note: Composite host with two interactive children (Group 5b)
+
+The host wraps a primary `<button>`, a dropdown trigger `<button>`, and a
+panel `<div role="menu">` — three ARIA-bearing surfaces that cannot all
+collapse onto the host. Group 5b keeps role placement on the inner
+elements (consistent with `hx-overflow-menu`). The host carries no role.
+
+What Group 5b adds:
+- **Host-attribute label mirror** via `installAriaIdrefMirror`: consumer
+  `aria-label` / `aria-labelledby` on the host flow to the inner primary
+  button's `aria-label`. Replaces the legacy `accessible-label` shim,
+  which was a workaround for ARIAMixin shadowing on the host. The shim
+  is preserved with a one-time devWarn for one minor version of back-
+  compat; new code should use the standard `aria-label` attribute.
+- **Roving tabindex** on slotted `hx-menu-item` children inside the
+  panel. Only the focused item carries `tabindex=0`; arrow key
+  navigation rewrites the tabindex map via `_applyRovingTabIndex()`.
+  `setRovingTabIndex` is the same setter used by `hx-menu` for cross-
+  family pattern alignment.
+- **First-character typeahead** with 500ms timeout matching `hx-menu`.
  *
  * @example
  * ```tsx

package/dist/components/HxSplitButton/HxSplitButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxSplitButton.d.ts","sourceRoot":"","sources":["../../../src/components/HxSplitButton/HxSplitButton.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa;;;EASxB,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"HxSplitButton.d.ts","sourceRoot":"","sources":["../../../src/components/HxSplitButton/HxSplitButton.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,aAAa;;;EASxB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/components/HxSplitButton/types.d.ts

@@ -15,14 +15,6 @@ export interface HxSplitButtonProps {
     disabled?: boolean;
     /** Primary button label text. When set, overrides the default slot content. */
     label?: string | undefined;
-    /** Accessible label for the primary action button. Required for icon-only usage
-  or when the button label alone is insufficient context.
-  Uses `accessible-label` attribute instead of `aria-label` to avoid
-  ARIAMixin shadowing on the host element.
-  
-  Note: `mixinDelegatesAria` is not applied to this component because the
-  `accessible-label` attribute approach avoids the ARIAMixin property conflict
-  without requiring mixin overhead. */
     accessibleLabel?: string;
     /** Accessible label for the dropdown trigger button. Override for localization. */
     labelTrigger?: string;

package/dist/components/HxSplitButton/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxSplitButton/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,gDAAgD;IAChD,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAChF,gCAAgC;IAChC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;4CACwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;;;;sCAOkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnC,iEAAiE;IACjE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxSplitButton/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,gDAAgD;IAChD,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAChF,gCAAgC;IAChC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;4CACwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnC,iEAAiE;IACjE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}

package/dist/components/HxStat/HxStat.d.ts

@@ -3,6 +3,13 @@ import { HxStatProps } from './types.js';
 export type { HxStatProps };
 /**
  * A static stat display component for presenting key metrics in a healthcare dashboard.
+
+Group 7 host-canonical: `role="group"` lives on the **host** via
+`_internals.role`. The host carries the resolved accessible name so AT
+walks `<hx-stat>` (role=group, label="value: label") directly. The
+internal `aria-live="polite"` announcer remains in the shadow tree —
+`role="group"` does NOT imply a live region, so the announcer is required
+for value/label/trend update announcements.
  *
  * @example
  * ```tsx

package/dist/components/HxStat/HxStat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxStat.d.ts","sourceRoot":"","sources":["../../../src/components/HxStat/HxStat.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,uDAMjB,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"HxStat.d.ts","sourceRoot":"","sources":["../../../src/components/HxStat/HxStat.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM,uDAMjB,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/components/HxTab/HxTab.d.ts

@@ -4,6 +4,16 @@ export type { HxTabProps };
 /**
  * An individual tab button, designed to be used inside an `<hx-tabs>` container.
 Must be placed in the `tab` named slot of `<hx-tabs>`.
+
+Group 5a host-canonical: `role="tab"` lives on the **host** via
+`_internals.role`. The host is the focusable surface (carries the roving
+tabindex); the inner `<button>` retains click activation semantics
+(Enter/Space and pointer events) but is no longer the AT-announced surface
+— its role and ARIA state are stripped on the modern path so the host's
+canonical surface wins. `internals.ariaSelected`, `ariaDisabled`, and
+`ariaControlsElements` mirror reactive state. The host `aria-label` /
+`aria-labelledby` resolved via the shared IDREF mirror name the tab
+cross-shadow.
  *
  * @example
  * ```tsx

package/dist/components/HxTab/HxTab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTab.d.ts","sourceRoot":"","sources":["../../../src/components/HxTab/HxTab.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,sDAMhB,CAAC;AAEH,eAAe,KAAK,CAAC"}
+{"version":3,"file":"HxTab.d.ts","sourceRoot":"","sources":["../../../src/components/HxTab/HxTab.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,KAAK,sDAMhB,CAAC;AAEH,eAAe,KAAK,CAAC"}

package/dist/components/HxTabPanel/HxTabPanel.d.ts

@@ -3,6 +3,12 @@ import { HxTabPanelProps } from './types.js';
 export type { HxTabPanelProps };
 /**
  * A content panel associated with an `<hx-tab>`, managed by a parent `<hx-tabs>`.
+Group 5a host-canonical: `role="tabpanel"` lives on the host via
+`_internals.role`. The host carries the canonical AT surface — consumer
+`aria-labelledby` / `aria-describedby` on the host resolve through the
+shared IDREF mirror. The parent `hx-tabs` writes `internals.ariaLabelledByElements`
+referencing the corresponding `<hx-tab>` host so cross-shadow naming works
+via IDL element references (the modern path) without serializing tab text.
  *
  * @example
  * ```tsx

package/dist/components/HxTabPanel/HxTabPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTabPanel.d.ts","sourceRoot":"","sources":["../../../src/components/HxTabPanel/HxTabPanel.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,2DAMrB,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"HxTabPanel.d.ts","sourceRoot":"","sources":["../../../src/components/HxTabPanel/HxTabPanel.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,2DAMrB,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/dist/components/HxTabs/HxTabs.d.ts

@@ -5,6 +5,16 @@ export type { HxTabsProps };
  * A tabbed content organizer that manages a set of `<hx-tab>` and `<hx-tab-panel>` children.
 Supports horizontal and vertical orientations, automatic and manual activation modes,
 and full keyboard navigation per the ARIA Authoring Practices Guide.
+
+Group 5a host-canonical: `role="tablist"` lives on the host via
+`_internals.role`. `aria-orientation`, `aria-label`, and consumer
+`aria-labelledby` resolve through the host. Per-tab `role="tab"` and
+per-panel `role="tabpanel"` likewise live on their respective hosts.
+
+Activation defaults to **manual** per healthcare patterns — keyboard arrow
+keys move focus only; Enter/Space activates. APG explicitly allows both
+automatic and manual activation; manual is safer when panels are heavy or
+announce changes via live regions.
  *
  * @example
  * ```tsx

package/dist/components/HxTabs/HxTabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTabs.d.ts","sourceRoot":"","sources":["../../../src/components/HxTabs/HxTabs.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM;;EAQjB,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"HxTabs.d.ts","sourceRoot":"","sources":["../../../src/components/HxTabs/HxTabs.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,MAAM;;EAQjB,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/components/HxTabs/types.d.ts

@@ -10,10 +10,17 @@ export interface HxTabsProps {
     orientation?: 'horizontal' | 'vertical';
     /** Controls how keyboard navigation activates tabs.
   In `automatic` mode, focus also activates the tab.
-  In `manual` mode, focus moves independently; Space or Enter activates. */
+  In `manual` mode, focus moves independently; Space or Enter activates.
+  
+  Group 5a default: `manual` — safer for healthcare patterns where panel
+  content may be heavy or announce updates via live regions. APG explicitly
+  allows both modes; manual avoids disorienting auto-activation when users
+  scan tabs with arrow keys. */
     activation?: 'manual' | 'automatic';
-    /** Accessible label for the tablist. Rendered as `aria-label` on the tablist container.
-  Provide a brief description of what the tabs represent (e.g., "Patient record sections"). */
+    /** Accessible label for the tablist. Drives the host `internals.ariaLabel`.
+  Provide a brief description of what the tabs represent (e.g., "Patient
+  record sections"). Consumer `aria-label` / `aria-labelledby` on the host
+  override this property when present. */
     label?: string;
     /** Gets or sets the zero-based index of the currently selected tab.
   Setting this programmatically activates the tab at the given index.

package/dist/components/HxTabs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTabs/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC;;2EAEuE;IACvE,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IACpC;8FAC0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;gDAG4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTabs/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC;;;;;;;+BAO2B;IAC3B,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IACpC;;;yCAGqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;gDAG4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC"}

package/dist/components/HxTd/HxTd.d.ts

@@ -3,6 +3,11 @@ import { HxTdProps } from './types.js';
 export type { HxTdProps };
 /**
  * Semantic table data cell. Must be a child of `hx-tr`.
+
+Group 7 host-canonical: `role="cell"` lives on the **host** via
+`_internals.role`. The host carries the cell's accessible name (resolved
+from the `label` property — fixing audit B-A1, where mobile screen reader
+users lost column context because `data-label` was visual-only).
  *
  * @example
  * ```tsx

package/dist/components/HxTd/HxTd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTd.d.ts","sourceRoot":"","sources":["../../../src/components/HxTd/HxTd.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,4DAMf,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"HxTd.d.ts","sourceRoot":"","sources":["../../../src/components/HxTd/HxTd.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI,4DAMf,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/components/HxTd/types.d.ts

@@ -12,9 +12,13 @@ export interface HxTdProps {
     colspan?: number;
     /** Number of rows this cell spans. */
     rowspan?: number;
-    /** Column header label for this cell. Forwarded as `data-label` on the native `<td>` for
-  the mobile card layout (`td::before { content: attr(data-label) }`) and as `aria-label`
-  so screen readers identify the column when the header row is hidden. */
+    /** Column header label for this cell. Forwarded as `data-label` on the native
+  `<td>` for the mobile card layout (`td::before { content: attr(data-label) }`)
+  AND projected to `aria-label` so screen readers identify the column when
+  the header row is hidden via the mobile breakpoint. Group 7 audit B-A1
+  fix: prior to migration, the JSDoc claimed aria-label projection but the
+  implementation only set `data-label` — `::before { content: attr(...) }`
+  is not reliably announced by VoiceOver / NVDA across versions. */
     label?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/components/HxTd/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTd/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;yEAEqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTd/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;mEAM+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/components/HxTh/HxTh.d.ts

@@ -4,6 +4,12 @@ export type { HxThProps };
 /**
  * Semantic table header cell. Must be a child of `hx-tr`.
 Supports sortable columns with accessible sort state.
+
+Group 7 host-canonical: `role="columnheader"` lives on the **host** via
+`_internals.role`. The host carries `aria-sort` reflecting the current
+sort direction (when `sortable` is true). The sort `<button>` aria-label
+incorporates the slotted column text so AT users hear "Sort by Patient
+name, currently sorted ascending" rather than just "Sort ascending".
  *
  * @example
  * ```tsx

package/dist/components/HxTh/HxTh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTh.d.ts","sourceRoot":"","sources":["../../../src/components/HxTh/HxTh.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI;;EAQf,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"HxTh.d.ts","sourceRoot":"","sources":["../../../src/components/HxTh/HxTh.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI;;EAQf,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/components/HxTimePicker/types.d.ts

@@ -26,6 +26,10 @@ export interface HxTimePickerProps {
     error?: string;
     /** Display format for the time input. '12h' shows AM/PM; '24h' is bare HH:MM. */
     format?: '12h' | '24h';
+    /** Accessible name for screen readers, if different from the visible label.
+  Uses `accessible-label` attribute instead of `aria-label` to avoid
+  ARIAMixin shadowing on the host element. Highest-precedence naming source. */
+    accessibleLabel?: string | null;
     /** Dispatched when the selected time changes. Detail value is HH:MM (24h). */
     onHxChange?: (event: Event) => void;
 }

package/dist/components/HxTimePicker/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTimePicker/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAGvB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTimePicker/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB;;+EAE2E;IAC3E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}

package/dist/components/HxTooltip/HxTooltip.d.ts

@@ -3,6 +3,37 @@ import { HxTooltipProps } from './types.js';
 export type { HxTooltipProps };
 /**
  * A tooltip that displays contextual help text on hover or focus.
+
+## Architecture Note: Light-DOM Description Shim (group-4 round-1)
+
+`aria-describedby` IDREFs cannot resolve across the Shadow DOM boundary —
+the trigger lives in the consumer's light DOM and references a tooltip
+whose body is in this component's shadow root. The tooltip text must
+therefore be exposed in DOCUMENT scope.
+
+The shim is a single visually-hidden `<span>` appended to `document.body`
+with the `_tooltipId` as its `id`. The trigger's `aria-describedby` points
+at this span. The text content is mirrored from the slotted `content`
+slot on every relevant signal:
+
+  1. `firstUpdated` (initial wiring)
+  2. `slotchange` on the default slot AND the `content` slot (the slotted
+     element list changes)
+  3. **Text-content mutations on the assigned `content` slot elements**
+     (round-23 P2 pattern). Without this observer a framework that
+     rewrites the slotted `<span slot="content">` `textContent` IN PLACE
+     (Vue / React keyed text rerender) would leave the shim stale.
+
+Cleanup: `disconnectedCallback` removes the shim from `document.body`,
+disconnects the slot-text observer, and clears the timers. SSR is
+sidestepped by guarding `document` access — the shim is created lazily
+the first time `_setupTriggerAria()` runs in a browser environment.
+
+`role="tooltip"` is the correct APG role and is NEVER promoted to
+`role="dialog"` — APG explicitly forbids tooltips from holding focus and
+the tooltip body is not a focus target. No host-canonical `_internals`
+work is owed: the trigger is the announced surface, and it correctly
+references the tooltip via `aria-describedby`.
  *
  * @example
  * ```tsx

package/dist/components/HxTooltip/HxTooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTooltip.d.ts","sourceRoot":"","sources":["../../../src/components/HxTooltip/HxTooltip.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,0DAMpB,CAAC;AAEH,eAAe,SAAS,CAAC"}
+{"version":3,"file":"HxTooltip.d.ts","sourceRoot":"","sources":["../../../src/components/HxTooltip/HxTooltip.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,SAAS,0DAMpB,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/dist/components/HxTr/HxTr.d.ts

@@ -4,6 +4,14 @@ export type { HxTrProps };
 /**
  * Semantic table row. Must be a child of `hx-thead`, `hx-tbody`, or `hx-tfoot`.
 Contains `hx-th` or `hx-td` cells.
+
+Group 7 host-canonical: `role="row"` lives on the **host** via
+`_internals.role`. The host carries `aria-selected` / `aria-disabled`
+mirroring `selected` / `disabled` reflected attributes. Consumer-supplied
+`aria-label` / `aria-labelledby` on the host project to the host's
+announced surface so AT walks `<hx-tr>` (role=row) directly. Fallback
+path keeps the inner `<tr role="row">` as the announced surface for
+engines without IDL element references.
  *
  * @example
  * ```tsx

package/dist/components/HxTr/HxTr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTr.d.ts","sourceRoot":"","sources":["../../../src/components/HxTr/HxTr.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,2DAMf,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"HxTr.d.ts","sourceRoot":"","sources":["../../../src/components/HxTr/HxTr.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI,2DAMf,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/components/HxTreeItem/HxTreeItem.d.ts

@@ -4,6 +4,27 @@ export type { HxTreeItemProps };
 /**
  * A tree item used within an hx-tree-view component.
 Supports expand/collapse, selection, keyboard navigation, and icon/children slots.
+
+Group 5c host-canonical: `role="treeitem"` lives on the **host** via
+`_internals.role`. The roving tabindex is written to the host on the
+modern path so the host is the focusable surface and lands directly
+under the parent `<hx-tree-view>` (which carries `role="tree"`) in the
+AT-walked tree. The inner `.item-row` is presentational on the modern
+path — no role, no aria-* attributes — and carries only click/keyboard
+event handlers. Keyboard activation (Enter/Space) and expand/collapse
+(ArrowLeft/Right at the leaf level) are owned by the host's `keydown`
+handler; ArrowUp/Down/Home/End and typeahead bubble to the parent
+`<hx-tree-view>` for navigation.
+
+The nested `[role="group"]` element that wraps the `slot="children"`
+stays in the inner shadow DOM regardless of path — that group is a
+separate sub-surface for the children, not a duplicate of the
+treeitem role.
+
+On the legacy fallback path the inner `.item-row` carries
+`role="treeitem"` + aria-* state, the host role is suppressed, and the
+roving tabindex is written to the inner element so there is only ONE
+focusable surface per item (mirrors hx-menu-item round-8).
  *
  * @example
  * ```tsx

package/dist/components/HxTreeItem/HxTreeItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTreeItem.d.ts","sourceRoot":"","sources":["../../../src/components/HxTreeItem/HxTreeItem.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;EAQrB,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"HxTreeItem.d.ts","sourceRoot":"","sources":["../../../src/components/HxTreeItem/HxTreeItem.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,UAAU;;EAQrB,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/dist/components/HxTreeView/HxTreeView.d.ts

@@ -5,10 +5,20 @@ export type { HxTreeViewProps };
  * 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
 

package/dist/components/HxTreeView/HxTreeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxTreeView.d.ts","sourceRoot":"","sources":["../../../src/components/HxTreeView/HxTreeView.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,UAAU;;EAQrB,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"HxTreeView.d.ts","sourceRoot":"","sources":["../../../src/components/HxTreeView/HxTreeView.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,UAAU;;EAQrB,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/dist/components/HxTreeView/types.d.ts

@@ -6,8 +6,11 @@ export interface HxTreeViewProps {
     className?: string;
     /** Inline styles */
     style?: React.CSSProperties;
-    /** 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. */
     label?: string;
     /** Selection mode for the tree.
   - `none` — items cannot be selected

package/dist/components/HxTreeView/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTreeView/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;iEAC6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;kDAG8C;IAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAG3C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTreeView/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;;;uDAImD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;kDAG8C;IAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAG3C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}

package/dist/index.js

@@ -60,7 +60,7 @@ import { H as H59 } from "./shared/HxProse-CVNyZuax.js";
 import { H as H60 } from "./shared/HxRadio-YLIQfNL9.js";
 import { H as H61 } from "./shared/HxRadioGroup-D0xVuMDM.js";
 import { H as H62 } from "./shared/HxRating-Ba5zWXvJ.js";
-import { H as H63 } from "./shared/HxSelect-BEm8srcF.js";
+import { H as H63 } from "./shared/HxSelect-BAt_veRr.js";
 import { H as H64 } from "./shared/HxSideNav-Bsna09yU.js";
 import { H as H65 } from "./shared/HxSkeleton-CCMzx9TK.js";
 import { H as H66 } from "./shared/HxSlider-BC8SGKvf.js";

package/dist/shared/HxAccordionItem-C26EIvJG.js.map

@@ -1 +1 @@
-{"version":3,"file":"HxAccordionItem-C26EIvJG.js","sources":["../../src/components/HxAccordionItem/HxAccordionItem.ts"],"sourcesContent":["'use client';\n/**\n * React wrapper for <hx-accordion-item> web component.\n * Auto-generated by scripts/generate-react-wrappers.ts — DO NOT EDIT MANUALLY.\n * Re-run: pnpm --filter=@helixui/react run generate\n */\n\nimport React from 'react';\nimport { createComponent } from '@lit/react';\nimport { HelixAccordionItem } from '@helixui/library/components/hx-accordion';\n\nimport type { HxAccordionItemProps } from './types.js';\n\nexport type { HxAccordionItemProps };\n\n/**\n * An individual accordion item with collapsible content.\n *\n * @example\n * ```tsx\n * import { HxAccordionItem } from '@helixui/react';\n *\n * <HxAccordionItem />\n * ```\n */\nexport const HxAccordionItem = createComponent({\n  tagName: 'hx-accordion-item',\n  elementClass: HelixAccordionItem,\n  react: React,\n  events: {\n    onHxExpand: 'hx-expand',\n    onHxCollapse: 'hx-collapse',\n  },\n  displayName: 'HxAccordionItem',\n});\n\nexport default HxAccordionItem;\n"],"names":[],"mappings":";;;AAyBO,MAAM,kBAAkB,gBAAgB;AAAA,EAC7C,SAAS;AAAA,EACT,cAAc;AAAA,EACd,OAAO;AAAA,EACP,QAAQ;AAAA,IACN,YAAY;AAAA,IACZ,cAAc;AAAA,EAAA;AAAA,EAEhB,aAAa;AACf,CAAC;"}
+{"version":3,"file":"HxAccordionItem-C26EIvJG.js","sources":["../../src/components/HxAccordionItem/HxAccordionItem.ts"],"sourcesContent":["'use client';\n/**\n * React wrapper for <hx-accordion-item> web component.\n * Auto-generated by scripts/generate-react-wrappers.ts — DO NOT EDIT MANUALLY.\n * Re-run: pnpm --filter=@helixui/react run generate\n */\n\nimport React from 'react';\nimport { createComponent } from '@lit/react';\nimport { HelixAccordionItem } from '@helixui/library/components/hx-accordion';\n\nimport type { HxAccordionItemProps } from './types.js';\n\nexport type { HxAccordionItemProps };\n\n/**\n * An individual accordion item with collapsible content.\n\n## Architecture Note: Slot Projection vs. Host-Canonical (group-4 round-1)\n\n`hx-accordion-item` deliberately does NOT participate in the\nhost-canonical / `internals.ariaLabelledByElements` pattern used by every\nother group-2/3/4 component. Rationale:\n\n  1. The trigger label comes from `<slot name=\"trigger\">` — consumer\n     light-DOM projected directly into the `<summary>` element. AT reads\n     the slot-projected text natively because slot projection preserves\n     accessible name (the `<summary>` IS the heading and consumes the\n     slotted text in its own accessible name computation).\n  2. `aria-labelledby=\"${_uid}-trigger\"` on the inner content region and\n     `aria-controls=\"${_uid}-content\"` on the summary BOTH resolve\n     same-shadow-root, which works correctly across every AT — these\n     IDREFs never cross a shadow boundary.\n  3. Pushing these ids through `internals.ariaLabelledByElements` would\n     either duplicate the wiring (heading announced twice) or break the\n     native `<details>/<summary>` toggle semantics (the host carrying\n     `role=\"heading\"` would shadow the summary's own heading projection).\n\n`role=\"heading\"` on `<summary>` (with `aria-level=N`) is the APG-canonical\nAccordion pattern. Per the APG note, `<summary>` MUST be a direct child\nof `<details>` for the native toggle to function — wrapping it in an\n`<h3>` would forfeit native disclosure. The role-on-summary approach is\nthe authoritative compromise. NVDA, JAWS, and VoiceOver all announce the\nsummary as a heading at the configured level when this pattern is used.\n\n`aria-controls` on the summary points at the shadow-internal content\nregion; APG marks the relationship as implicit via the heading + region\nstructure, so AT not following the IDREF still announces correctly. The\nIDREF is a hint, not a requirement — and because both ids are in the\nsame shadow root, it resolves cleanly when AT does follow it. This\nmatches the popover/dropdown intentional `aria-controls` omission for\nthe cross-shadow case (see those components' code comments).\n *\n * @example\n * ```tsx\n * import { HxAccordionItem } from '@helixui/react';\n *\n * <HxAccordionItem />\n * ```\n */\nexport const HxAccordionItem = createComponent({\n  tagName: 'hx-accordion-item',\n  elementClass: HelixAccordionItem,\n  react: React,\n  events: {\n    onHxExpand: 'hx-expand',\n    onHxCollapse: 'hx-collapse',\n  },\n  displayName: 'HxAccordionItem',\n});\n\nexport default HxAccordionItem;\n"],"names":[],"mappings":";;;AA4DO,MAAM,kBAAkB,gBAAgB;AAAA,EAC7C,SAAS;AAAA,EACT,cAAc;AAAA,EACd,OAAO;AAAA,EACP,QAAQ;AAAA,IACN,YAAY;AAAA,IACZ,cAAc;AAAA,EAAA;AAAA,EAEhB,aAAa;AACf,CAAC;"}

package/dist/shared/HxDialog-DMF3crTa.js.map

@@ -1 +1 @@
-{"version":3,"file":"HxDialog-DMF3crTa.js","sources":["../../src/components/HxDialog/HxDialog.ts"],"sourcesContent":["'use client';\n/**\n * React wrapper for <hx-dialog> web component.\n * Auto-generated by scripts/generate-react-wrappers.ts — DO NOT EDIT MANUALLY.\n * Re-run: pnpm --filter=@helixui/react run generate\n */\n\nimport React from 'react';\nimport { createComponent } from '@lit/react';\nimport { HelixDialog } from '@helixui/library/components/hx-dialog';\n\nimport type { HxDialogProps } from './types.js';\n\nexport type { HxDialogProps };\n\n/**\n * A modal and non-modal dialog component built on the native HTML `<dialog>` element.\nProvides focus trapping, backdrop interaction, keyboard navigation, and full\nARIA labelling for enterprise healthcare accessibility requirements.\n *\n * @example\n * ```tsx\n * import { HxDialog } from '@helixui/react';\n *\n * <HxDialog />\n * ```\n */\nexport const HxDialog = createComponent({\n  tagName: 'hx-dialog',\n  elementClass: HelixDialog,\n  react: React,\n  events: {\n    onHxOpen: 'hx-open',\n    onHxClose: 'hx-close',\n    onHxCancel: 'hx-cancel',\n  },\n  displayName: 'HxDialog',\n});\n\nexport default HxDialog;\n"],"names":[],"mappings":";;;AA2BO,MAAM,WAAW,gBAAgB;AAAA,EACtC,SAAS;AAAA,EACT,cAAc;AAAA,EACd,OAAO;AAAA,EACP,QAAQ;AAAA,IACN,UAAU;AAAA,IACV,WAAW;AAAA,IACX,YAAY;AAAA,EAAA;AAAA,EAEd,aAAa;AACf,CAAC;"}
+{"version":3,"file":"HxDialog-DMF3crTa.js","sources":["../../src/components/HxDialog/HxDialog.ts"],"sourcesContent":["'use client';\n/**\n * React wrapper for <hx-dialog> web component.\n * Auto-generated by scripts/generate-react-wrappers.ts — DO NOT EDIT MANUALLY.\n * Re-run: pnpm --filter=@helixui/react run generate\n */\n\nimport React from 'react';\nimport { createComponent } from '@lit/react';\nimport { HelixDialog } from '@helixui/library/components/hx-dialog';\n\nimport type { HxDialogProps } from './types.js';\n\nexport type { HxDialogProps };\n\n/**\n * A modal and non-modal dialog component built on the native HTML `<dialog>` element.\nProvides focus trapping, backdrop interaction, keyboard navigation, and full\nARIA labelling for enterprise healthcare accessibility requirements.\n\n## Architecture Note: Host-Canonical ARIA (group-4a round-1, Path A — native-dialog adaptation)\n\nUnlike `hx-drawer` (which uses an inner `<div role=\"dialog\">` and can fully\nhost-canonicalize the role), `hx-dialog` is built on the native\n`<dialog>` HTMLDialogElement. The native element has an **implicit\n`role=\"dialog\"`** baked in by the browser that **cannot be stripped**, so\nfull host-canonical role takeover would create nested-dialog announcements.\n\n**Path A (adopted):** the host owns label / description projection via\n`ElementInternals` (`internals.ariaLabelledByElements`,\n`internals.ariaDescribedByElements`, `internals.ariaLabel`) but **does NOT**\nset `internals.role`. The native inner `<dialog>` continues to be the\nannounced surface. Consumer light-DOM IDREFs project across the shadow\nboundary via `internals.aria*Elements` on the host.\n\n**Hybrid fallback (always-on belt-and-suspenders):** because some assistive\ntechnologies may walk the native `<dialog>` first and ignore host\n`internals.aria*Elements`, the resolved label / description text is **also**\nserialized into `aria-label` / `aria-describedby` on the inner native\n`<dialog>` element. Consumers therefore get name/description on every AT,\nwith the IDL-ref path providing live DOM-text-update tracking when the AT\nhonours it. This forfeits live-text tracking on the inner-dialog fallback\n(the serialized text is recomputed on every sync, which is good enough since\nmutation observers re-fire `_syncHostAriaSemantics` on consumer text edits).\n\nWhy we do NOT set `internals.role = 'alertdialog'` either: setting role on\nthe host while the native `<dialog>` keeps `role=\"dialog\"` would announce\nBOTH a host alertdialog AND an inner dialog. Instead, the alertdialog\nvariant continues to write `role=\"alertdialog\"` directly on the inner\n`<dialog>` element (the platform allows overriding the implicit `dialog`\nrole with the more specific `alertdialog`).\n\nNaming precedence (W3C AccName 1.2 §4.3.1):\n\n  1. Consumer `aria-labelledby` on the host — IDREFs resolved across the\n     shadow boundary via `resolveIdrefTokens` (closest scope first, then\n     ancestor shadow hosts, then owner document).\n  2. Consumer `aria-label` on the host.\n  3. `<slot name=\"header\">` text content (multi-node aggregation per\n     AccName 1.2 §4.3.10 — decorative `aria-hidden` / `[hidden]` subtrees\n     contribute zero to the name).\n  4. `heading` property — explicit author-provided heading text.\n  5. Hard-coded literal `\"Dialog\"` (last-resort accessible name).\n\nDescription channel: the host's `internals.ariaDescribedByElements` carries\nthe resolved IDREF chain on the modern path. The inner native `<dialog>` ALSO\nreceives a serialized `aria-describedby` chain — when a consumer description\nresolves, a synthesized in-shadow `<span id=\"${id}-consumer-desc\">` is\nappended to the existing `description` span (if any) and the inner\n`<dialog>`'s `aria-describedby` references both same-root ids. `aria-description`\nis intentionally NEVER written — W3C AccName ignores it whenever\n`aria-describedby` is also present.\n\nSlot mutation observers track:\n  1. The header slot's text content (in-place i18n re-renders).\n  2. Consumer-resolved external IDREF targets (so a consumer mutating\n     `<label id=\"x\">Patient</label>` in place re-flows the name).\n  3. Host attribute mutations (delegated to `installAriaIdrefMirror`,\n     which also catches late-inserted IDREF targets and id renames in\n     every relevant root).\n  4. Authentic consumer `aria-describedby` retraction (oldValue !== null &&\n     newValue === null) via a dedicated `attributeOldValue: true` observer.\n\n**First-paint slot state seeding intentionally omitted:** seeding\n`_hasHeaderSlot` / `_headerSlotText` from `firstUpdated()` would schedule an\nextra Lit re-render that subtly reorders the open-dialog promise chain\n(`updateComplete.then(...) → showModal() → updateComplete.then(...) →\nfocus first focusable`). On Chromium, that reordering interleaves the\nnative dialog's modal activation with the focus-restore step and causes\nfocus-trap test failures. The slotchange handler runs one microtask later\nand `_syncHostAriaSemantics()` from `updated()` picks up the resolved state\non the next paint — close enough that AT never observes the unnamed window.\nMirrors the same intentional decision documented in hx-drawer round-1.\n\nFocus trap, ESC dismiss with `hx-cancel` BEFORE `hx-close`, focus-restore\nvia `_triggerElement`, and native `showModal()` semantics are unchanged\nfrom the pre-host-canonical implementation.\n *\n * @example\n * ```tsx\n * import { HxDialog } from '@helixui/react';\n *\n * <HxDialog />\n * ```\n */\nexport const HxDialog = createComponent({\n  tagName: 'hx-dialog',\n  elementClass: HelixDialog,\n  react: React,\n  events: {\n    onHxOpen: 'hx-open',\n    onHxClose: 'hx-close',\n    onHxCancel: 'hx-cancel',\n  },\n  displayName: 'HxDialog',\n});\n\nexport default HxDialog;\n"],"names":[],"mappings":";;;AAyGO,MAAM,WAAW,gBAAgB;AAAA,EACtC,SAAS;AAAA,EACT,cAAc;AAAA,EACd,OAAO;AAAA,EACP,QAAQ;AAAA,IACN,UAAU;AAAA,IACV,WAAW;AAAA,IACX,YAAY;AAAA,EAAA;AAAA,EAEd,aAAa;AACf,CAAC;"}