@helixui/library 3.3.1 → 3.4.0-next.121

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

@@ -1,4 +1,4 @@
-import { H as i } from "../../shared/hx-spinner-DL5AYr16.js";
+import { H as i } from "../../shared/hx-spinner-BB0h2hKZ.js";
 export {
   i as HelixSpinner
 };

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/hx-switch.d.ts

@@ -136,7 +136,69 @@ export declare class HelixSwitch extends HelixSwitch_base {
      * @attr required-message
      */
     requiredMessage: string;
+    /**
+     * Handle for the shared IDREF observer. Installed in `connectedCallback()`
+     * so late-mutated `aria-labelledby`/`aria-describedby` and late-inserted
+     * IDREF targets are picked up. See `installAriaIdrefMirror()`.
+     * @internal
+     */
+    private _ariaMirror;
+    /**
+     * No-IDL-ref fallback tokens applied to the inner button so consumer
+     * labelling resolves through the shadow root. Tracked as reactive state
+     * so values flow through the next `render()`.
+     * @internal
+     */
+    private _fallbackAriaLabelledBy;
+    /** @internal */
+    private _fallbackAriaDescribedBy;
+    /** @internal */
+    private _fallbackAriaLabel;
+    /**
+     * Whether the platform supports IDL element references on `ElementInternals`.
+     * Drives the render-time branch between the modern path (host is the
+     * announced surface, inner button is `aria-hidden + tabindex=-1`) and the
+     * fallback path (inner button is the announced surface, host is demoted).
+     * Codex round-2 finding #2.
+     * @internal
+     */
+    private _supportsIdrefRefs;
+    /**
+     * Tracks whether the host's `tabindex` is managed by the component itself
+     * (vs. set explicitly by a consumer). Codex round-14 P2: a consumer-supplied
+     * `tabindex` (e.g. roving-tabindex toolbar pattern with `tabindex="-1"`)
+     * must survive disabled flips and re-renders. Only re-assert tabindex in
+     * `updated()` when the component originally claimed it.
+     * @internal
+     */
+    private _internalTabindexManaged;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Host-level keydown handler. Active only on the modern path; on the
+     * no-IDL-ref fallback the inner `<button>` owns native activation.
+     * Codex round-2 finding #2.
+     * @internal
+     */
+    private _handleHostKeyDown;
+    /**
+     * Host-level click handler. Active only on the modern path; on the
+     * fallback path AT activation flows directly to the inner button.
+     * Codex round-2 finding #2.
+     * @internal
+     */
+    private _handleHostClick;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Mirrors switch semantics onto the host via ElementInternals so that
+     * consumer-supplied `aria-label`, `aria-labelledby`, and `aria-describedby`
+     * on `<hx-switch>` reach the announced control. The codex aria-group-2
+     * finding identified that the inner shadow `<button role=switch>` was the
+     * only carrier of switch semantics, leaving host-level IDREF tokens stranded
+     * on the wrong side of the shadow boundary.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** Recalculates and sets the validity state based on required and checked. */
     /** @internal */
     _updateValidity(): void;
@@ -152,12 +214,18 @@ export declare class HelixSwitch extends HelixSwitch_base {
     /** Whether the default slot has assigned content (slotted label). */
     /** @internal */
     private _hasDefaultSlot;
+    /** Whether the help-text slot has assigned content. */
+    /** @internal */
+    private _hasHelpTextSlot;
     /** Updates _hasErrorSlot when error slot content changes. */
     /** @internal */
     private _handleErrorSlotChange;
     /** Updates _hasDefaultSlot when default slot content changes. */
     /** @internal */
     private _handleDefaultSlotChange;
+    /** Updates _hasHelpTextSlot when help-text slot content changes. */
+    /** @internal */
+    private _handleHelpTextSlotChange;
     /** Toggles checked state and dispatches hx-change event. */
     /** @internal */
     private _toggle;
@@ -167,7 +235,16 @@ export declare class HelixSwitch extends HelixSwitch_base {
     /** Handles keydown events — Space toggles the switch per ARIA APG. */
     /** @internal */
     private _handleKeyDown;
-    /** Moves focus to the switch track element. */
+    /**
+     * Moves focus to the announced switch surface. Codex round-1 finding #1
+     * relocated the focus target to the host so AT announces a single widget;
+     * the host carries the canonical role/state on modern engines. Round-7
+     * finding #7 extends that contract to the no-IDL-ref fallback: when the
+     * host is demoted (`tabindex=-1`, role/state cleared on `internals`) the
+     * inner `<button role=switch>` owns the announced semantics and tab order,
+     * so programmatic `focus()` must redirect there — otherwise scripted focus
+     * and error recovery land on the demoted host on unsupported engines.
+     */
     focus(options?: FocusOptions): void;
     /** Unique ID for this switch instance, used for ARIA associations. */
     /** @internal */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-switch.d.ts","sourceRoot":"","sources":["../../../src/components/hx-switch/hx-switch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAOpE,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,qBACa,WAAY,SAAQ,gBAAuB;IACtD,OAAgB,MAAM,4BAA0C;IAIhE,gBAAgB;IAChB,OAAgB,cAAc,UAAQ;IAItC;;;OAGG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;OAGG;IAEH,KAAK,SAAQ;IAEb;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,SAAM;IAEd;;;OAGG;IAEH,eAAe,SAA6B;IAInC,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAS/D,8EAA8E;IAC9E,gBAAgB;IACP,eAAe,IAAI,IAAI;cAYb,YAAY,IAAI,IAAI;cAMpB,mBAAmB,CACpC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,EACtC,KAAK,EAAE,SAAS,GAAG,cAAc,GAChC,IAAI;cAMY,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI3D;OACG;IAEH,OAAO,CAAC,QAAQ,CAAuC;IAEvD,mDAAmD;IACnD,gBAAgB;IACP,OAAO,CAAC,aAAa,CAAS;IAEvC,qEAAqE;IACrE,gBAAgB;IACP,OAAO,CAAC,eAAe,CAAS;IAIzC,6DAA6D;IAC7D,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,iEAAiE;IACjE,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAOhC,4DAA4D;IAC5D,gBAAgB;IAChB,OAAO,CAAC,OAAO;IAcf,yCAAyC;IACzC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAIpB,sEAAsE;IACtE,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAStB,+CAA+C;IACtC,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAM5C,sEAAsE;IACtE,gBAAgB;IAChB,OAAO,CAAC,SAAS,CAAmB;IACpC,+DAA+D;IAC/D,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,oEAAoE;IACpE,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA4B;IAC/C,gEAAgE;IAChE,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAA6B;IAEpC,MAAM;CAmEhB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,WAAW,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF;AAED,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC"}
+{"version":3,"file":"hx-switch.d.ts","sourceRoot":"","sources":["../../../src/components/hx-switch/hx-switch.ts"],"names":[],"mappings":"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"}

package/dist/components/hx-switch/hx-switch.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-switch.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-switch/hx-switch.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,yBA4O7B,CAAC"}
+{"version":3,"file":"hx-switch.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-switch/hx-switch.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,yBA6P7B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-switch-BrZFaRue.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"}