@helixui/library 3.3.1-next.118 → 3.4.0-next.121

package/dist/components/hx-split-button/hx-split-button.d.ts

@@ -1,9 +1,31 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * 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`.
+ *
  * @summary Primary action button with attached dropdown menu for secondary actions.
  *
  * @tag hx-split-button
@@ -112,14 +134,16 @@ export declare class HelixSplitButton extends HelixElement {
      */
     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.
+     * @deprecated Use the standard host `aria-label` attribute instead. Group
+     * 5b replaces the `accessible-label` shim with a host-attribute mirror
+     * driven by `installAriaIdrefMirror` — consumer host `aria-label` /
+     * `aria-labelledby` flow to the inner primary button's `aria-label`,
+     * which is the same composed-tree result as the legacy shim without
+     * the ARIAMixin shadowing concern.
      *
-     * Note: `mixinDelegatesAria` is not applied to this component because the
-     * `accessible-label` attribute approach avoids the ARIAMixin property conflict
-     * without requiring mixin overhead.
+     * The attribute remains observed for one minor version so existing
+     * consumers do not regress; setting it logs a devWarn pointing them to
+     * the standard `aria-label` path.
      * @attr accessible-label
      */
     accessibleLabel: string;
@@ -138,8 +162,36 @@ export declare class HelixSplitButton extends HelixElement {
      * @internal
      */
     private readonly _menuId;
+    /**
+     * Resolved accessible name for the primary action button — written to
+     * the inner primary button's `aria-label` on render. AccName 1.2 §4.3.1
+     * precedence: host `aria-labelledby` (resolved IDREFs, flattened) >
+     * host `aria-label` > deprecated `accessible-label` (with devWarn) >
+     * `label` property > slotted text content (no aria-label set when this
+     * branch is taken so AT walks the inner content for the name).
+     * @internal
+     */
+    private _resolvedPrimaryLabel;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
+    private _rovingIndex;
+    /** @internal */
+    private _typeaheadBuffer;
+    /** @internal */
+    private _typeaheadTimer;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    willUpdate(changedProperties: PropertyValues<this>): void;
+    /**
+     * Resolve the primary button's accessible name from host attributes
+     * and (deprecated) properties. See `_resolvedPrimaryLabel` jsdoc for
+     * precedence rules.
+     * @internal
+     */
+    private _syncResolvedPrimaryLabel;
+    /** @internal */
+    private _deprecatedAccessibleLabelWarned;
     /** @internal */
     private readonly _handleOutsideClick;
     /** @internal */
@@ -155,7 +207,42 @@ export declare class HelixSplitButton extends HelixElement {
     /** @internal */
     private _handleMenuKeydown;
     /** @internal */
+    private _focusMenuItem;
+    /**
+     * Roving tabindex: only the focused item carries tabindex=0; the rest
+     * are tabindex=-1. Tab from the panel exits the menu via document
+     * keydown (line ~_handleDocumentKeydown), so the closing-Tab path
+     * remains correct.
+     * @internal
+     */
+    private _applyRovingTabIndex;
+    /** @internal */
+    private _handleTypeahead;
+    /** @internal */
     private _handleMenuItemSelect;
+    /**
+     * Bubbled `hx-item-submenu-open` from a slotted `hx-menu-item` host.
+     * Codex push-gate round-9 P1: when slotted `hx-menu-item`s open / close
+     * a nested submenu inside this menu panel (no enclosing `hx-menu`), the
+     * events fly past with no handler. Match the round-4
+     * `hx-menu._handleSubmenuOpen` shape so APG behaviour holds. Defer to
+     * an inner `hx-menu` when present (it owns the toggle). Otherwise this
+     * panel is the enclosing menu surface — call `setSubmenuOpen(true)` on
+     * the dispatching item and focus its first nested child.
+     * @internal
+     */
+    private _handleMenuSubmenuOpen;
+    /**
+     * Bubbled `hx-item-submenu-close` from a slotted `hx-menu-item` host.
+     * Codex push-gate round-9 P1: when an inner `hx-menu` (a nested
+     * submenu) handles its own close, the event still bubbles through this
+     * panel — defer in that case so the panel stays open. When the
+     * dispatching item is top-level inside this panel (no enclosing
+     * `hx-menu`), there is no parent submenu to collapse, so close the
+     * composite's menu and return focus to the trigger button.
+     * @internal
+     */
+    private _handleMenuSubmenuClose;
     /** @internal */
     private _openMenu;
     /** @internal */

package/dist/components/hx-split-button/hx-split-button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-split-button.d.ts","sourceRoot":"","sources":["../../../src/components/hx-split-button/hx-split-button.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAOpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAAqD;IAI3E;;;OAGG;IAEH,OAAO,CAAC,UAAU,CAA0B;IAE5C;;;OAGG;IAEH,OAAO,CAAC,cAAc,CAAgC;IAItD;;;OAGG;IACM,OAAO,CAAC,KAAK,CAAS;IAI/B;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAa;IAE3F;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;;OAIG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;;;;;;;OAUG;IAEH,eAAe,SAAM;IAErB;;;OAGG;IAEH,YAAY,SAAkB;IAE9B;;;OAGG;IAEH,SAAS,SAAuB;IAIhC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAIjD,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAQrC,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAMlC;IAEF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAKrC;IAIF,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAoB3B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAU7B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAW3B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAU7B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IA0C1B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAwB7B,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAYjB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAIlB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAQnB;;;;;OAKG;IACH,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAcZ,MAAM;CA+EhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}
+{"version":3,"file":"hx-split-button.d.ts","sourceRoot":"","sources":["../../../src/components/hx-split-button/hx-split-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAgBpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAAqD;IAI3E;;;OAGG;IAEH,OAAO,CAAC,UAAU,CAA0B;IAE5C;;;OAGG;IAEH,OAAO,CAAC,cAAc,CAAgC;IAItD;;;OAGG;IACM,OAAO,CAAC,KAAK,CAAS;IAI/B;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAa;IAE3F;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;;OAIG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;;;;;;;;;OAYG;IAEH,eAAe,SAAM;IAErB;;;OAGG;IAEH,YAAY,SAAkB;IAE9B;;;OAGG;IAEH,SAAS,SAAuB;IAIhC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAI1D;;;;;;;;OAQG;IACM,OAAO,CAAC,qBAAqB,CAAuB;IAE7D,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAIzD,gBAAgB;IAChB,OAAO,CAAC,YAAY,CAAM;IAE1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB,CAAM;IAE9B,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAA8C;IAI5D,iBAAiB,IAAI,IAAI;IAUzB,oBAAoB,IAAI,IAAI;IAY5B,UAAU,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAOlE;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IA8CjC,gBAAgB;IAChB,OAAO,CAAC,gCAAgC,CAAS;IAIjD,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAMlC;IAEF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAKrC;IAIF,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAoB3B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAU7B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAW3B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAU7B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAiD1B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAMtB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAM5B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAwBxB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAsB7B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,sBAAsB,CAsB5B;IAEF;;;;;;;;;OASG;IACH,OAAO,CAAC,uBAAuB,CAS7B;IAIF,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAgBjB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAIlB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAQnB;;;;;OAKG;IACH,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAcZ,MAAM;CAiFhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}

package/dist/components/hx-split-button/index.js

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-split-button-Djnc5Aeg.js";
+import { H as e } from "../../shared/hx-split-button-BoABoEm5.js";
 export {
   e as HelixSplitButton
 };

package/dist/components/hx-stat/hx-stat.d.ts

@@ -5,6 +5,13 @@ export type StatTrend = 'up' | 'down' | 'neutral';
 /**
  * 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.
+ *
  * @summary Displays a labeled metric value with optional trend indicator and icon slot.
  *
  * @tag hx-stat
@@ -63,6 +70,12 @@ export type StatTrend = 'up' | 'down' | 'neutral';
  */
 export declare class HelixStat extends HelixElement {
     static styles: import('lit').CSSResult[];
+    /**
+     * Test seam (Group 7 host-canonical migration): see other Group 7 components.
+     * Production code MUST NOT touch this field.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
     /**
      * The metric label displayed below the value.
      * @attr label
@@ -90,8 +103,23 @@ export declare class HelixStat extends HelixElement {
     labelTrend: string;
     /** @internal tracks whether the "unnamed" devWarn has already fired this lifecycle */
     private _hasWarnedUnnamed;
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
+    private _resolvedAccessibleName;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Mirror group semantics onto the host. The default group label is
+     * `${value}: ${label}` (matching the prior inner-div behaviour). Consumer
+     * `aria-label` / `aria-labelledby` on the host take precedence per AccName
+     * 1.2 §4.3.1.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _hasIcon;
     /** @internal */

package/dist/components/hx-stat/hx-stat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-stat.d.ts","sourceRoot":"","sources":["../../../src/components/hx-stat/hx-stat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA0C;IAEhE;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAa;IAE7C;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IACqC,UAAU,SAAW;IAE7D,sFAAsF;IACtF,OAAO,CAAC,iBAAiB,CAAS;IAIzB,iBAAiB,IAAI,IAAI;IAWzB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAmB/D,gBAAgB;IACP,OAAO,CAAC,QAAQ,CAAS;IAElC,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAOzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAyChB,MAAM;CAsDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}
+{"version":3,"file":"hx-stat.d.ts","sourceRoot":"","sources":["../../../src/components/hx-stat/hx-stat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAWnD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA0C;IAEhE;;;;OAIG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAa;IAE7C;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IACqC,UAAU,SAAW;IAE7D,sFAAsF;IACtF,OAAO,CAAC,iBAAiB,CAAS;IAIlC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAAM;IAI5B,iBAAiB,IAAI,IAAI;IAqBzB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA0B/D;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAkE9B,gBAAgB;IACP,OAAO,CAAC,QAAQ,CAAS;IAElC,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAOzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAyChB,MAAM;CA0DhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

package/dist/components/hx-stat/index.js

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-stat-WOcNV1Ry.js";
+import { H as e } from "../../shared/hx-stat-Dtf9lz-O.js";
 export {
   e as HelixStat
 };

package/dist/components/hx-switch/index.js

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-switch-BX_8uNUs.js";
+import { H as o } from "../../shared/hx-switch-B6kr-EwE.js";
 export {
   o as HelixSwitch
 };

package/dist/components/hx-table/hx-td.d.ts

@@ -1,7 +1,13 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * 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).
+ *
  * @summary Table data cell (`<td>`) for use inside `hx-tr`.
  *
  * @tag hx-td
@@ -14,6 +20,12 @@ import { HelixElement } from '../../base/index.js';
  */
 export declare class HelixTableCell extends HelixElement {
     static styles: import('lit').CSSResult[];
+    /**
+     * Test seam (Group 7 host-canonical migration): see other Group 7 components.
+     * Production code MUST NOT touch this field.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
     /**
      * Horizontal alignment for cell content.
      * @attr align
@@ -30,12 +42,27 @@ export declare class HelixTableCell extends HelixElement {
      */
     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.
      * @attr label
      */
     label: string;
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
+    private _resolvedAccessibleName;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changed: PropertyValues<this>): void;
+    /** @internal */
+    private _syncHostAriaSemantics;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

package/dist/components/hx-table/hx-td.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-td.d.ts","sourceRoot":"","sources":["../../../src/components/hx-table/hx-td.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,qBACa,cAAe,SAAQ,YAAY;IAC9C,OAAgB,MAAM,4BAqDpB;IAEF;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAU;IAE5C;;;OAGG;IAEH,OAAO,SAAK;IAEZ;;;OAGG;IAEH,OAAO,SAAK;IAEZ;;;;;OAKG;IAEH,KAAK,SAAM;IAEF,MAAM;CAahB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,OAAO,EAAE,cAAc,CAAC;KACzB;CACF"}
+{"version":3,"file":"hx-td.d.ts","sourceRoot":"","sources":["../../../src/components/hx-table/hx-td.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,cAAe,SAAQ,YAAY;IAC9C,OAAgB,MAAM,4BAkEpB;IAEF;;;;OAIG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAU;IAE5C;;;OAGG;IAEH,OAAO,SAAK;IAEZ;;;OAGG;IAEH,OAAO,SAAK;IAEZ;;;;;;;;;OASG;IAEH,KAAK,SAAM;IAIX,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAAM;IAE5B,iBAAiB,IAAI,IAAI;IAazB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAOrD,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAgErB,MAAM;CAmBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,OAAO,EAAE,cAAc,CAAC;KACzB;CACF"}

package/dist/components/hx-table/hx-th.d.ts

@@ -1,3 +1,4 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * Detail type for `hx-sort` events dispatched from `hx-th`.
@@ -9,6 +10,12 @@ export interface HxTableSortDetail {
  * 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".
+ *
  * @summary Table header cell (`<th>`) with optional sort support.
  *
  * @tag hx-th
@@ -22,6 +29,12 @@ export interface HxTableSortDetail {
  */
 export declare class HelixTableHeader extends HelixElement {
     static styles: import('lit').CSSResult[];
+    /**
+     * Test seam (Group 7 host-canonical migration): see other Group 7 components.
+     * Production code MUST NOT touch this field.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
     /**
      * When true, the header renders a sort button and emits `hx-sort` on activation.
      * @attr sortable
@@ -48,13 +61,36 @@ export declare class HelixTableHeader extends HelixElement {
      */
     rowspan: number;
     /** @internal */
+    private _slotText;
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changed: PropertyValues<this>): void;
+    /** @internal */
+    private _onSlotChange;
+    /** @internal */
+    private _syncHostAriaSemantics;
+    /** @internal */
     private _handleSort;
     /** @internal */
-    private _renderSortIcon;
+    protected _renderSortIcon(): import('lit').TemplateResult<1>;
     /** @internal */
-    private _ariaSort;
+    private _ariaSortValue;
     /** @internal */
-    private _sortLabel;
+    private _ariaSortAttr;
+    /**
+     * Build the sort button's aria-label. Includes the slotted column text
+     * when available so a blind user pressing Tab through 5 sortable columns
+     * hears "Sort by Patient name, currently sorted ascending" instead of
+     * just "Sort. Sort. Sort." (audit B-A2-style label disambiguation).
+     * Promoted to `protected` so subclasses can override the i18n surface
+     * without re-implementing the full sort cycle.
+     * @internal
+     */
+    protected _sortLabel(): string;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

package/dist/components/hx-table/hx-th.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-th.d.ts","sourceRoot":"","sources":["../../../src/components/hx-table/hx-th.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAwGpB;IAEF;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,aAAa,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAU;IAEhD;;;OAGG;IAEH,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAS;IAEvD;;;OAGG;IAEH,OAAO,SAAK;IAEZ;;;OAGG;IAEH,OAAO,SAAK;IAIZ,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAcnB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAyBvB,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAOjB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAMT,MAAM;CAqBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,OAAO,EAAE,gBAAgB,CAAC;KAC3B;CACF"}
+{"version":3,"file":"hx-th.d.ts","sourceRoot":"","sources":["../../../src/components/hx-table/hx-th.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC9D,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BA0HpB;IAEF;;;;OAIG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,aAAa,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAU;IAEhD;;;OAGG;IAEH,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAS;IAEvD;;;OAGG;IAEH,OAAO,SAAK;IAEZ;;;OAGG;IAEH,OAAO,SAAK;IAEZ,gBAAgB;IACP,OAAO,CAAC,SAAS,CAAM;IAIhC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAIhD,iBAAiB,IAAI,IAAI;IAazB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAOrD,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAcrB,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IA+C9B,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAcnB,gBAAgB;IAChB,SAAS,CAAC,eAAe;IAyBzB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAOtB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAKrB;;;;;;;;OAQG;IACH,SAAS,CAAC,UAAU,IAAI,MAAM;IAgBrB,MAAM;CAyBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,OAAO,EAAE,gBAAgB,CAAC;KAC3B;CACF"}

package/dist/components/hx-table/hx-tr.d.ts

@@ -1,8 +1,17 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * 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.
+ *
  * @summary Table row (`<tr>`) for use inside `hx-thead`, `hx-tbody`, or `hx-tfoot`.
  *
  * @tag hx-tr
@@ -13,6 +22,12 @@ import { HelixElement } from '../../base/index.js';
  */
 export declare class HelixTableRow extends HelixElement {
     static styles: import('lit').CSSResult[];
+    /**
+     * Test seam (Group 7 host-canonical migration): see other Group 7 components.
+     * Production code MUST NOT touch this field.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
     /**
      * When true, marks the row as selected and applies selected styling.
      * @attr selected
@@ -23,6 +38,17 @@ export declare class HelixTableRow extends HelixElement {
      * @attr disabled
      */
     disabled: boolean;
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
+    private _resolvedAccessibleName;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changed: PropertyValues<this>): void;
+    /** @internal */
+    private _syncHostAriaSemantics;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

package/dist/components/hx-table/hx-tr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tr.d.ts","sourceRoot":"","sources":["../../../src/components/hx-table/hx-tr.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BA8BpB;IAEF;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAER,MAAM;CAYhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,OAAO,EAAE,aAAa,CAAC;KACxB;CACF"}
+{"version":3,"file":"hx-tr.d.ts","sourceRoot":"","sources":["../../../src/components/hx-table/hx-tr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC9D,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BA8BpB;IAEF;;;;OAIG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAIjB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAAM;IAE5B,iBAAiB,IAAI,IAAI;IAazB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAOrD,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IA6DrB,MAAM;CAgBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,OAAO,EAAE,aAAa,CAAC;KACxB;CACF"}

package/dist/components/hx-table/index.js

@@ -1,4 +1,4 @@
-import { H as l, a as H, b, c as x, d as i, e as s, f as T } from "../../shared/hx-td-DnnEMIuA.js";
+import { H as l, a as H, b, c as x, d as i, e as s, f as T } from "../../shared/hx-td-BGkFOJEK.js";
 export {
   l as HelixTable,
   H as HelixTableBody,

package/dist/components/hx-tabs/hx-tab-panel.d.ts

@@ -1,6 +1,13 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * 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.
  *
  * @summary Tab content panel shown when its corresponding tab is selected.
  *
@@ -21,7 +28,34 @@ export declare class HelixTabPanel extends HelixElement {
      * @attr name
      */
     name: string;
+    /**
+     * Element references for the controlling `<hx-tab>` host(s). Set by the
+     * parent `<hx-tabs>` via `setLabelledByTabs()` and projected onto
+     * `internals.ariaLabelledByElements` so cross-shadow naming via IDL element
+     * references resolves to the live tab host without flattening text.
+     * @internal
+     */
+    private _labelledByTabs;
+    /**
+     * Whether the platform supports IDL element references on `ElementInternals`.
+     * @internal
+     */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
     connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Set by `<hx-tabs>` whenever the tab→panel relationship is recomputed.
+     * Drives `internals.ariaLabelledByElements` so AT walks across the shadow
+     * boundary to the announcing tab host(s) by element reference rather than
+     * IDREF string. Pass an empty array to clear.
+     * @internal
+     */
+    setLabelledByTabs(tabs: Element[]): void;
+    /** @internal */
+    private _syncHostAriaSemantics;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

package/dist/components/hx-tabs/hx-tab-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tab-panel.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab-panel.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;;GAcG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAAkD;IAIxE;;;OAGG;IAEH,IAAI,SAAM;IAID,iBAAiB,IAAI,IAAI;IASzB,MAAM;CAOhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}
+{"version":3,"file":"hx-tab-panel.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA4C;IAIlE;;;OAGG;IAEH,IAAI,SAAM;IAIV;;;;;;OAMG;IACH,OAAO,CAAC,eAAe,CAAiB;IAExC;;;OAGG;IACM,OAAO,CAAC,kBAAkB,CAAQ;IAE3C,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAIhD,iBAAiB,IAAI,IAAI;IAYzB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAK/D;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKxC,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IA6CrB,MAAM;CAOhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}

package/dist/components/hx-tabs/hx-tab.d.ts

@@ -1,8 +1,19 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * 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.
+ *
  * @summary Presentational tab button that activates a corresponding panel.
  *
  * @tag hx-tab
@@ -47,12 +58,44 @@ export declare class HelixTab extends HelixElement {
      */
     disabled: boolean;
     /**
-     * The id of the panel this tab controls. Set by the parent `<hx-tabs>` to establish the
-     * aria-controls relationship on the inner button element (which carries role="tab").
+     * The id of the panel this tab controls. Set by the parent `<hx-tabs>` to
+     * establish the aria-controls relationship via element references on the
+     * host (modern path) or as a string fallback (legacy path).
      * @internal
      */
     controls: string;
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /**
+     * Element reference for the controlled `<hx-tab-panel>` host. Set by the
+     * parent `<hx-tabs>` via `setControlsPanel()` and projected onto
+     * `internals.ariaControlsElements` so cross-shadow controls resolution
+     * works via IDL element references. Falls through to the `controls`
+     * string property on the legacy path.
+     * @internal
+     */
+    private _controlledPanel;
     connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Set by `<hx-tabs>` whenever the tab→panel relationship is recomputed.
+     * Drives `internals.ariaControlsElements` (modern path) so AT walks across
+     * the shadow boundary to the controlled panel by element reference.
+     * @internal
+     */
+    setControlsPanel(panel: Element | null): void;
+    /**
+     * Mirror reactive ARIA state onto ElementInternals on the **host**. The
+     * inner `<button>` no longer carries role/aria-* on the modern path — the
+     * host is the canonical AT-announced surface. The button stays as the
+     * activation surface (Enter/Space/click) but is `tabindex=-1` and
+     * presentational from AT's perspective.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _hasPrefixSlot;
     /** @internal */

package/dist/components/hx-tabs/hx-tab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tab.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,QAAS,SAAQ,YAAY;IACxC,OAAgB,MAAM,4BAA6C;IAInE;;;;OAIG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,QAAQ,SAAM;IAIL,iBAAiB,IAAI,IAAI;IASlC,gBAAgB;IACP,OAAO,CAAC,cAAc,CAAS;IACxC,gBAAgB;IACP,OAAO,CAAC,cAAc,CAAS;IAIxC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAkBpB,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAK/B,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAOtB,MAAM;CAsBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,QAAQ,EAAE,QAAQ,CAAC;KACpB;CACF"}
+{"version":3,"file":"hx-tab.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBACa,QAAS,SAAQ,YAAY;IACxC,OAAgB,MAAM,4BAA6C;IAInE;;;;OAIG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;;OAKG;IAEH,QAAQ,SAAM;IAId,gBAAgB;IACP,OAAO,CAAC,kBAAkB,CAAQ;IAE3C,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB,CAAwB;IAIvC,iBAAiB,IAAI,IAAI;IAYzB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAY/D;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAK7C;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAmD9B,gBAAgB;IACP,OAAO,CAAC,cAAc,CAAS;IACxC,gBAAgB;IACP,OAAO,CAAC,cAAc,CAAS;IAIxC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAkBpB,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAK/B,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAOtB,MAAM;CA6EhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,QAAQ,EAAE,QAAQ,CAAC;KACpB;CACF"}

package/dist/components/hx-tabs/hx-tab.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tab.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,yBA2H1B,CAAC"}
+{"version":3,"file":"hx-tab.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,yBAsI1B,CAAC"}

package/dist/components/hx-tabs/hx-tabs.d.ts

@@ -10,6 +10,16 @@ export interface HxTabChangeDetail {
  * 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.
+ *
  * @summary Tab container that organizes content into selectable panels.
  *
  * @tag hx-tabs
@@ -58,18 +68,30 @@ export declare class HelixTabs extends HelixElement {
      * Controls how keyboard navigation activates tabs.
      * In `automatic` mode, focus also activates the tab.
      * 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.
+     *
      * @attr activation
      */
     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.
      * @attr label
      */
     label: string;
     /** @internal */
     private _activePanel;
     /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
     private _cachedTabs;
     /** @internal */
     private _cachedPanels;
@@ -101,6 +123,14 @@ export declare class HelixTabs extends HelixElement {
     disconnectedCallback(): void;
     firstUpdated(): void;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Mirror tablist semantics onto the host via ElementInternals so consumer-
+     * supplied `aria-label`, `aria-labelledby`, and the `label` property all
+     * reach the announced control. The host carries `role="tablist"` and the
+     * orientation reflects the `orientation` property reactively.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _syncTabsAndPanels;
     /** @internal */

package/dist/components/hx-tabs/hx-tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tabs.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AASpE,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA8C;IAIpE,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAiB;IAI5B;;;OAGG;IAEH,WAAW,EAAE,YAAY,GAAG,UAAU,CAAgB;IAEtD;;;;;OAKG;IAEH,UAAU,EAAE,QAAQ,GAAG,WAAW,CAAe;IAEjD;;;;OAIG;IAEH,KAAK,SAAM;IAIX,gBAAgB;IACP,OAAO,CAAC,YAAY,CAAM;IAInC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA2B;IAC9C,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAgC;IACrD,gBAAgB;IAChB,OAAO,CAAC,SAAS,CAAiC;IAClD;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAuB;IAI5C,WAAoB,kBAAkB,IAAI,MAAM,EAAE,CAEjD;IAEQ,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAqB/F;;;;;OAKG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAK9B;IAED,gBAAgB;IAChB,OAAO,CAAC,QAAQ;IAShB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IASlB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAMd,iBAAiB,IAAI,IAAI;IAkBzB,oBAAoB,IAAI,IAAI;IAQ5B,YAAY,IAAI,IAAI;IA6BpB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAS/D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IA6C1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IA6B5B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA2BpB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB,CAStB;IAEF,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IA2B/B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAgBvB;IAEF,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAiEpB;IAIO,MAAM;CAkBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;IACD,UAAU,mBAAmB;QAC3B,eAAe,EAAE,WAAW,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChE;CACF"}
+{"version":3,"file":"hx-tabs.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAgBpE,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA8C;IAIpE,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAiB;IAI5B;;;OAGG;IAEH,WAAW,EAAE,YAAY,GAAG,UAAU,CAAgB;IAEtD;;;;;;;;;;;OAWG;IAEH,UAAU,EAAE,QAAQ,GAAG,WAAW,CAAY;IAE9C;;;;;;OAMG;IAEH,KAAK,SAAM;IAIX,gBAAgB;IACP,OAAO,CAAC,YAAY,CAAM;IAEnC,gBAAgB;IACP,OAAO,CAAC,kBAAkB,CAAQ;IAI3C,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAIzD,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA2B;IAC9C,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAgC;IACrD,gBAAgB;IAChB,OAAO,CAAC,SAAS,CAAiC;IAClD;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAuB;IAI5C,WAAoB,kBAAkB,IAAI,MAAM,EAAE,CAEjD;IAEQ,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAqB/F;;;;;OAKG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAK9B;IAED,gBAAgB;IAChB,OAAO,CAAC,QAAQ;IAShB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IASlB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAMd,iBAAiB,IAAI,IAAI;IAwBzB,oBAAoB,IAAI,IAAI;IAU5B,YAAY,IAAI,IAAI;IA6BpB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAe/D;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IA4C9B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IA6D1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IA4B5B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA2BpB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB,CAStB;IAEF,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IA2B/B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAgBvB;IAEF,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAuEpB;IAIO,MAAM;CAYhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;IACD,UAAU,mBAAmB;QAC3B,eAAe,EAAE,WAAW,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChE;CACF"}