@helixui/library 3.3.1-next.118 → 3.4.0

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

@@ -1,8 +1,24 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * A menu container that manages keyboard navigation over a list of menu items.
  * Use with `hx-menu-item` and `hx-menu-divider`.
  *
+ * Group 5b host-canonical: `role="menu"` lives on the **host** via
+ * `_internals.role`. The host carries the announced surface so AT walks
+ * `<hx-menu>` (role=menu) → slotted `<hx-menu-item>` (role=menuitem 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).
+ *
+ * Submenu coordination: when an `hx-menu-item` emits `hx-item-submenu-open`
+ * or `hx-item-submenu-close`, the parent menu auto-handles the toggle by
+ * calling `setSubmenuOpen()` on the item — UNLESS the consumer has called
+ * `event.preventDefault()` on the bubbled event, signaling that they own the
+ * submenu lifecycle. This matches APG-mandated behaviour while leaving an
+ * opt-out for advanced consumers.
+ *
  * @summary Context/action menu with keyboard-navigable items.
  *
  * @tag hx-menu
@@ -30,8 +46,10 @@ import { HelixElement } from '../../base/index.js';
 export declare class HelixMenu extends HelixElement {
     static styles: import('lit').CSSResult[];
     /**
-     * Accessible label for the menu. Rendered as `aria-label` on the inner
-     * `role="menu"` element when set.
+     * Accessible label for the menu. 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 div.
      * @attr label
      */
     label: string;
@@ -50,7 +68,50 @@ export declare class HelixMenu extends HelixElement {
      * @internal
      */
     private _typeaheadTimer;
+    /**
+     * Test seam (codex push-gate round-2 finding 1): when set to `true` or
+     * `false`, overrides the platform `supportsIdrefElementReferences` probe
+     * before `connectedCallback` seeds `_supportsIdrefRefs`. Mirrors the
+     * hx-select / hx-menu-item seam — required so tests can deterministically
+     * exercise the legacy fallback render branch (where the inner
+     * `div[role="menu"]` is the announced surface and must mirror the
+     * resolved accessible name).
+     *
+     * Production code MUST NOT touch this field. It is `static` so the test
+     * stub cleanup is global and obvious.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
+    /** @internal */
+    private _supportsIdrefRefs;
     /** @internal */
+    private _ariaMirror;
+    /**
+     * Resolved accessible name for the menu — the single source of truth that
+     * both `_syncHostAriaSemantics()` (modern path: writes to
+     * `internals.ariaLabel`) and the fallback `render()` branch (legacy path:
+     * writes to inner `div[role="menu"]` `aria-label`) read. Recomputed by
+     * `_syncHostAriaSemantics()` whenever host aria-* or `label` changes via
+     * the shared IDREF mirror. AccName 1.2 §4.3.1 precedence: consumer host
+     * `aria-labelledby` (flattened) > consumer host `aria-label` > `label`
+     * property > literal "Menu".
+     * @internal
+     */
+    private _resolvedAccessibleName;
+    /**
+     * Return the menu's enabled, top-level `hx-menu-item` children.
+     *
+     * Codex push-gate round-6 finding 3: `querySelectorAll('hx-menu-item')`
+     * walks the entire descendant tree, which on a parent menuitem
+     * includes the slotted nested `<hx-menu>` and ITS items. Treating
+     * those as top-level options corrupts roving tabindex, ArrowUp/Down
+     * navigation, and typeahead matching (typing the first letter of a
+     * grandchild item lands focus there instead of on the next sibling).
+     * Restrict to direct children of `this` so each menu owns only its
+     * own items.
+     *
+     * @internal
+     */
     private _getItems;
     /**
      * Synchronize roving tabindex across all enabled items.
@@ -70,12 +131,66 @@ export declare class HelixMenu extends HelixElement {
     private _handleKeyDown;
     /** @internal */
     private _handleTypeahead;
+    /**
+     * Read the typeahead label for an item — delegates to the shared
+     * `getMenuItemTypeaheadLabel` util so all four menu-bearing components
+     * (`hx-menu`, `hx-dropdown`, `hx-overflow-menu`, `hx-split-button`)
+     * share one submenu-aware extractor. Codex push-gate round-7 finding 3
+     * extracted this helper from its original home here in `hx-menu.ts`.
+     *
+     * @internal
+     */
+    private _getTypeaheadLabel;
     /** @internal */
     private _handleSlotChange;
     /** @internal */
     private _handleItemSelect;
+    /**
+     * Auto-handle submenu open/close events emitted by child `hx-menu-item`
+     * children. APG-mandated behaviour: ArrowRight on a parent item opens the
+     * nested submenu and focuses its first item; ArrowLeft closes the submenu
+     * and returns focus to the parent item. Consumers that own submenu
+     * lifecycle themselves can `event.preventDefault()` to opt out.
+     * @internal
+     */
+    private _handleSubmenuOpen;
+    /** @internal */
+    private _handleSubmenuClose;
+    connectedCallback(): void;
     disconnectedCallback(): void;
+    /**
+     * Codex push-gate round-7 finding 1: keydown bound on the HOST receives
+     * events that bubble out of nested submenus. When a child submenu is
+     * open and focus lives inside it, ArrowUp/Down/Home/End/Escape on the
+     * inner item bubbles to EVERY enclosing `hx-menu`. Without this guard
+     * the outer menu would run `_focusItem(...)` against its OWN top-level
+     * items and steal focus back out of the child submenu, and Escape would
+     * dispatch one `hx-close` per enclosing menu. Mirrors the
+     * `findClosestMenuAncestor` pattern already used by the submenu
+     * open/close handlers.
+     * @internal
+     */
+    private _handleHostKeyDown;
+    /**
+     * Codex push-gate round-7 finding 2: `hx-item-select` bubbles composed
+     * through every enclosing `hx-menu`. The outer menu would otherwise
+     * (a) corrupt `_focusedIndex` to `-1` because the bubbled item is not
+     * a member of the outer menu's items, and (b) re-emit a duplicate
+     * `hx-select`. Only act when THIS menu is the closest enclosing menu
+     * of the dispatching item.
+     * @internal
+     */
+    private _handleItemSelectHost;
+    updated(changedProperties: PropertyValues<this>): void;
     firstUpdated(): void;
+    /**
+     * Mirror menu semantics onto the host via ElementInternals so consumer-
+     * supplied `aria-label`, `aria-labelledby`, and the `label` property all
+     * reach the announced control. Falls back to a flattened-string label on
+     * engines that do not implement `ariaLabelledByElements`.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

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

@@ -1 +1 @@
-{"version":3,"file":"hx-menu.d.ts","sourceRoot":"","sources":["../../../src/components/hx-menu/hx-menu.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA8C;IAEpE;;;;OAIG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAM;IAE3B;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAM;IAE9B;;;OAGG;IACH,OAAO,CAAC,eAAe,CAA8C;IAErE,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAMjB;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAQ3B,iCAAiC;IACjC,UAAU,IAAI,IAAI;IAUlB,gCAAgC;IAChC,SAAS,IAAI,IAAI;IAUjB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IASlB,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAQ3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAkCtB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAqBxB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAiBzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAehB,oBAAoB,IAAI,IAAI;IAQ5B,YAAY,IAAI,IAAI;IASpB,MAAM;CAchB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}
+{"version":3,"file":"hx-menu.d.ts","sourceRoot":"","sources":["../../../src/components/hx-menu/hx-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA2CnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA8C;IAEpE;;;;;;OAMG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAM;IAE3B;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAM;IAE9B;;;OAGG;IACH,OAAO,CAAC,eAAe,CAA8C;IAIrE;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,uBAAuB,CAAM;IAErC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,SAAS;IASjB;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAQ3B,iCAAiC;IACjC,UAAU,IAAI,IAAI;IAUlB,gCAAgC;IAChC,SAAS,IAAI,IAAI;IAUjB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IASlB,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAQ3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAkCtB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAqBxB;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAI1B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAiBzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAezB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB,CAyBxB;IAEF,gBAAgB;IAChB,OAAO,CAAC,mBAAmB,CA6BzB;IAIO,iBAAiB,IAAI,IAAI;IA0BzB,oBAAoB,IAAI,IAAI;IAcrC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,kBAAkB,CAMxB;IAEF;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB,CAQ3B;IAEO,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAOtD,YAAY,IAAI,IAAI;IAa7B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgFrB,MAAM;CAgChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as a, a as x, b as H } from "../../shared/hx-menu-divider-C2omnPtj.js";
+import { H as a, a as x, b as H } from "../../shared/hx-menu-divider-BjiRIWKq.js";
 export {
   a as HelixMenu,
   x as HelixMenuDivider,

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

@@ -5,6 +5,16 @@ import { HelixElement } from '../../base/index.js';
  * or any numeric value with defined min/max bounds. Supports low/high/optimum
  * threshold markers for semantic color feedback.
  *
+ * Group 7 host-canonical: `role="meter"` is mirrored onto the **host** via
+ * `_internals.role` AND kept on the inner `[role="meter"]` element. The dual
+ * surface is the hx-progress-ring pattern (Group 7 gold-standard exemplar):
+ * the host carries the cross-shadow IDREF wiring (`ariaLabelledByElements`
+ * resolves through the shared mirror) while the inner element keeps its
+ * existing role/state surface so legacy AT and consumer queries continue to
+ * work. AccName 1.2 §4.3.1 precedence is implemented uniformly: consumer
+ * host `aria-labelledby` (flattened) > consumer host `aria-label` >
+ * `label` property / slotted label > derived value-text fallback.
+ *
  * @summary Scalar measurement gauge within a defined range.
  *
  * @tag hx-meter
@@ -54,6 +64,17 @@ import { HelixElement } from '../../base/index.js';
  */
 export declare class HelixMeter extends HelixElement {
     static styles: import('lit').CSSResult[];
+    /**
+     * Test seam (Group 7 host-canonical migration): when set to `true` or
+     * `false`, overrides the platform `supportsIdrefElementReferences` probe
+     * before `connectedCallback` seeds `_supportsIdrefRefs`. Tests that need
+     * to verify the legacy fallback path may opt in by setting this static
+     * to `false` before fixture creation.
+     *
+     * Production code MUST NOT touch this field.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
     /** @internal */
     private _uid;
     /**
@@ -96,6 +117,12 @@ export declare class HelixMeter extends HelixElement {
     /** @internal */
     private _hasSlotContent;
     /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
+    private _resolvedAccessibleName;
+    /** @internal */
     private _clampedValue;
     /** @internal */
     private _percentage;
@@ -103,7 +130,19 @@ export declare class HelixMeter extends HelixElement {
     private _resolveState;
     /** @internal */
     private _onLabelSlotChange;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Mirror meter semantics onto the host via ElementInternals. The inner
+     * `[role="meter"]` keeps its existing surface — this method ADDS a host-
+     * level surface via internals.* so consumer-supplied `aria-labelledby` /
+     * `aria-describedby` on the host project through `ariaLabelledByElements`
+     * (cross-shadow IDREF) on engines that support it. Mirrors hx-progress-ring's
+     * dual-surface pattern (Group 7 gold-standard exemplar).
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private static readonly _STATE_LABELS;
     render(): import('lit').TemplateResult<1>;

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

@@ -1 +1 @@
-{"version":3,"file":"hx-meter.d.ts","sourceRoot":"","sources":["../../../src/components/hx-meter/hx-meter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAQpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAA2C;IAEjE,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAAkB;IAE9B;;;OAGG;IAEH,KAAK,SAAK;IAEV;;;OAGG;IAEH,GAAG,SAAK;IAER;;;OAGG;IAEH,GAAG,SAAO;IAEV;;;OAGG;IAEH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IAEH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IAEH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IAEH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gBAAgB;IAEhB,OAAO,CAAC,eAAe,CAAS;IAEhC,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAIrB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAMnB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAyCrB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAKjB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAe/D,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAInC;IAEO,MAAM;CAmDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}
+{"version":3,"file":"hx-meter.d.ts","sourceRoot":"","sources":["../../../src/components/hx-meter/hx-meter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAepE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAA2C;IAEjE;;;;;;;;;OASG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAAkB;IAE9B;;;OAGG;IAEH,KAAK,SAAK;IAEV;;;OAGG;IAEH,GAAG,SAAK;IAER;;;OAGG;IAEH,GAAG,SAAO;IAEV;;;OAGG;IAEH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IAEH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IAEH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IAEH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gBAAgB;IAEhB,OAAO,CAAC,eAAe,CAAS;IAIhC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAAM;IAErC,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAIrB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAMnB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAuCrB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQjB,iBAAiB,IAAI,IAAI;IAazB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB/D;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IA4E9B,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAInC;IAEO,MAAM;CAsDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-meter.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-meter/hx-meter.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBA+H5B,CAAC"}
+{"version":3,"file":"hx-meter.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-meter/hx-meter.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBAoI5B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-meter-BPscsw5t.js";
+import { H as o } from "../../shared/hx-meter-BJdh6nrF.js";
 export {
   o as HelixMeter
 };

package/dist/components/hx-overflow-menu/hx-overflow-menu.d.ts

@@ -1,8 +1,28 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * An overflow menu (kebab/meatball menu) that reveals hidden actions via a
  * floating panel. Composed from a trigger button and a slotted menu panel.
  *
+ * ## Architecture Note: Host-Attribute Trigger Label Mirror (group-5b)
+ *
+ * The composite has TWO ARIA-bearing surfaces inside its shadow DOM: the
+ * trigger button (`role` defaulted from `<button>`, with `aria-haspopup`,
+ * `aria-expanded`, `aria-controls`) and the panel (`role="menu"` on the
+ * inner div). The host wraps both — it cannot carry either canonical role
+ * itself, so role placement remains on the inner elements.
+ *
+ * What Group 5b adds:
+ * - **Roving tabindex** on slotted menu items (only the focused item has
+ *   tabindex=0; arrow keys move focus and rewrite tabindex). Closing-Tab
+ *   path is preserved (Tab moves focus past the menu and closes it).
+ * - **First-character typeahead** with 500ms timeout matching `hx-menu`.
+ * - **Host-attribute label mirror**: consumer-supplied `aria-label` /
+ *   `aria-labelledby` on the host flow to the trigger button's
+ *   `aria-label` (the trigger is the announced surface of the disclosure
+ *   pattern; consumer override wins over the `label` property). The panel
+ *   continues to use `labelMenu` for its own slot label.
+ *
  * @summary "..." or kebab icon button that reveals hidden actions.
  *
  * @tag hx-overflow-menu
@@ -83,7 +103,9 @@ export declare class HelixOverflowMenu extends HelixElement {
      */
     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.
      * @attr label
      */
     label: string;
@@ -97,6 +119,36 @@ export declare class HelixOverflowMenu extends HelixElement {
      * @internal
      */
     private _open;
+    /**
+     * Resolved accessible name for the trigger button — written to the inner
+     * button's `aria-label`. Recomputed via the host-attribute mirror on
+     * every aria-* mutation. AccName 1.2 §4.3.1 precedence: host
+     * `aria-labelledby` (flattened) > host `aria-label` > `label` property.
+     * @internal
+     */
+    private _resolvedTriggerLabel;
+    /**
+     * Index within `_getMenuItems()` of the item currently holding the
+     * roving tabindex (and thus visual focus). −1 means the panel has not
+     * been keyboard-focused yet (first key press lands on item 0).
+     * @internal
+     */
+    private _rovingIndex;
+    /**
+     * Accumulated character buffer for typeahead search within menu items.
+     * @internal
+     */
+    private _typeaheadBuffer;
+    /**
+     * Timer handle that clears the typeahead buffer after a period of inactivity.
+     * @internal
+     */
+    private _typeaheadTimer;
+    /**
+     * Handle for the shared host attribute / root id observer.
+     * @internal
+     */
+    private _ariaMirror;
     /**
      * Unique ID for the floating panel element, used to wire aria-controls on the trigger button.
      * @internal
@@ -108,6 +160,7 @@ export declare class HelixOverflowMenu extends HelixElement {
     private _panelEl;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    willUpdate(changedProperties: PropertyValues<this>): void;
     /** @internal */
     private _show;
     /** @internal */
@@ -118,6 +171,39 @@ export declare class HelixOverflowMenu extends HelixElement {
     private _updatePosition;
     /** @internal */
     private _focusFirstItem;
+    /**
+     * Codex push-gate round-2 finding 3: write the roving tabindex through
+     * the right surface for each item shape. Implementation moved to the
+     * shared `writeMenuItemRovingTabIndex` util (round-8 finding 2) so
+     * `hx-dropdown` and any future host-canonical menu shape route through
+     * one source of truth instead of duplicating the host-vs-inner-element
+     * branch per component.
+     *
+     * - `hx-menu-item` is host-canonical: on the modern path the roving
+     *   tabindex must land on the host (it carries the announced role +
+     *   IDL ARIA), and on the fallback path it must land on the inner
+     *   `.menu-item` (the host is forced to `tabindex=-1` so there is
+     *   exactly one focusable surface per item). The util's
+     *   `setRovingTabIndex(value)` route handles both paths internally.
+     * - Plain slotted `[role="menuitem"]` elements (legacy `<button>`-style
+     *   children) keep the direct `item.tabIndex = value` write.
+     *
+     * Without this routing, host-canonical items on the fallback path stay
+     * at `tabindex=-1` because the host write never reaches the inner
+     * focusable surface — Tab would land on a non-focusable host and arrow
+     * navigation would fail to advance the announced item.
+     * @internal
+     */
+    /**
+     * Initialize roving tabindex on all enabled menu items: only the first
+     * receives tabindex=0; the rest are tabindex=-1. Maintains the closing-
+     * Tab semantics required by APG (tabbing past the menu closes it via
+     * the keydown handler below).
+     * @internal
+     */
+    private _initRovingTabIndex;
+    /** @internal */
+    private _applyRovingTabIndex;
     /** @internal */
     private _getMenuItems;
     /** @internal */
@@ -127,7 +213,52 @@ export declare class HelixOverflowMenu extends HelixElement {
     /** @internal */
     private readonly _handleKeydown;
     /** @internal */
+    private _handleTypeahead;
+    /** @internal */
     private readonly _handleSlotClick;
+    /**
+     * Handle `hx-item-select` bubbling from slotted `hx-menu-item` children.
+     * The host-canonical shape owns its own activation (click + Enter/Space),
+     * so route its event through to the composite's `hx-select` contract and
+     * close the panel. Disabled items never emit `hx-item-select`, so no
+     * disabled-guard is needed here.
+     * @internal
+     */
+    private readonly _handleSlotItemSelect;
+    /**
+     * 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 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 readonly _handleSlotSubmenuOpen;
+    /**
+     * 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 panel and return focus to the trigger.
+     * @internal
+     */
+    private readonly _handleSlotSubmenuClose;
+    /** @internal */
+    private readonly _handleSlotChange;
+    /**
+     * Resolves the trigger button's accessible name from host attributes and
+     * the `label` property. AccName 1.2 §4.3.1 precedence:
+     *   1. Host `aria-labelledby` (resolved IDREFs, flattened)
+     *   2. Host `aria-label`
+     *   3. `label` property
+     * @internal
+     */
+    private _syncResolvedTriggerLabel;
     /** @internal */
     private _renderIcon;
     render(): import('lit').TemplateResult<1>;

package/dist/components/hx-overflow-menu/hx-overflow-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-overflow-menu.d.ts","sourceRoot":"","sources":["../../../src/components/hx-overflow-menu/hx-overflow-menu.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACjD,OAAgB,MAAM,4BAAsD;IAE5E;;;OAGG;IAEH,SAAS,EACL,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAgB;IAE/B;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,UAAU,GAAG,YAAY,CAAc;IAE7C;;;OAGG;IAEH,KAAK,SAAkB;IAEvB;;;OAGG;IAEH,SAAS,SAAa;IAEtB;;;OAGG;IACM,OAAO,CAAC,KAAK,CAAS;IAE/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D,gBAAgB;IACW,OAAO,CAAC,SAAS,CAA4B;IAExE,gBAAgB;IACU,OAAO,CAAC,QAAQ,CAAsB;IAIvD,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAQrC,gBAAgB;YACF,KAAK;IASnB,gBAAgB;IAChB,OAAO,CAAC,KAAK;IAMb,gBAAgB;IAChB,OAAO,CAAC,OAAO;IAUf,gBAAgB;YACF,eAAe;IAoB7B,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAKvB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAoBrB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGlC;IAEF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAMnC;IAEF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,cAAc,CA8B7B;IAEF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAgB/B;IAIF,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAmCV,MAAM;CAqChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,iBAAiB,CAAC;KACvC;CACF"}
+{"version":3,"file":"hx-overflow-menu.d.ts","sourceRoot":"","sources":["../../../src/components/hx-overflow-menu/hx-overflow-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAepE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACjD,OAAgB,MAAM,4BAAsD;IAE5E;;;OAGG;IAEH,SAAS,EACL,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAgB;IAE/B;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,UAAU,GAAG,YAAY,CAAc;IAE7C;;;;;OAKG;IAEH,KAAK,SAAkB;IAEvB;;;OAGG;IAEH,SAAS,SAAa;IAEtB;;;OAGG;IACM,OAAO,CAAC,KAAK,CAAS;IAE/B;;;;;;OAMG;IACM,OAAO,CAAC,qBAAqB,CAAM;IAE5C;;;;;OAKG;IACH,OAAO,CAAC,YAAY,CAAM;IAE1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAM;IAE9B;;;OAGG;IACH,OAAO,CAAC,eAAe,CAA8C;IAErE;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D,gBAAgB;IACW,OAAO,CAAC,SAAS,CAA4B;IAExE,gBAAgB;IACU,OAAO,CAAC,QAAQ,CAAsB;IAIvD,iBAAiB,IAAI,IAAI;IAUzB,oBAAoB,IAAI,IAAI;IAY5B,UAAU,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IASlE,gBAAgB;YACF,KAAK;IAUnB,gBAAgB;IAChB,OAAO,CAAC,KAAK;IAOb,gBAAgB;IAChB,OAAO,CAAC,OAAO;IAUf,gBAAgB;YACF,eAAe;IAoB7B,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAEH;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAQ3B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAO5B,gBAAgB;IAChB,OAAO,CAAC,aAAa;IA4BrB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGlC;IAEF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAMnC;IAEF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAuC7B;IAEF,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAyBxB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAwB/B;IAEF;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAWpC;IAEF;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CA8BrC;IAEF;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAatC;IAEF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAIhC;IAIF;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IAiCjC,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAmCV,MAAM;CAwChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,iBAAiB,CAAC;KACvC;CACF"}

package/dist/components/hx-overflow-menu/index.js

@@ -1,4 +1,4 @@
-import { H as r } from "../../shared/hx-overflow-menu-DCLsdIBy.js";
+import { H as r } from "../../shared/hx-overflow-menu-BQ4fiMYu.js";
 export {
   r as HelixOverflowMenu
 };

package/dist/components/hx-phi-field/hx-phi-field.d.ts

@@ -48,7 +48,6 @@ import { HelixElement } from '../../base/index.js';
  * @cssprop [--hx-phi-field-toggle-color=var(--hx-color-primary-500,#429797)] - Toggle button color.
  * @cssprop [--hx-phi-field-focus-ring-color=var(--hx-focus-ring-color,var(--hx-color-primary-500,#429797))] - Focus ring color.
  * @cssprop [--hx-phi-field-disabled-opacity=var(--hx-opacity-50,0.5)] - Opacity applied when the field is disabled.
- * @cssprop [--hx-phi-field-auto-hide-warning-color=var(--hx-color-warning-500,#C2711C)] - Color for auto-hide countdown warning (future use).
  * @cssprop [--hx-space-2] - Spacing token.
  * @cssprop [--hx-font-family-mono] - Font family.
  * @cssprop [--hx-color-neutral-500] - Color.

package/dist/components/hx-phi-field/hx-phi-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-phi-field.d.ts","sourceRoot":"","sources":["../../../src/components/hx-phi-field/hx-phi-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAEhD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA4C;IAIlE;;;;OAIG;IAEH,IAAI,EAAE,MAAM,CAAM;IAElB;;;OAGG;IAEH,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAS;IAEvD;;;OAGG;IAEH,OAAO,EAAE,MAAM,CAAM;IAErB;;;;OAIG;IAEH,gBAAgB,EAAE,MAAM,CAAS;IAEjC;;;;OAIG;IAEH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;;;OAKG;IAEH,aAAa,EAAE,MAAM,CAAM;IAE3B;;;;OAIG;IAEH,QAAQ,EAAE,OAAO,CAAS;IAI1B,gBAAgB;IACP,OAAO,CAAC,OAAO,CAAQ;IAEhC,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAA8C;IAErE,wDAAwD;IACxD,OAAO,CAAC,cAAc,CAA8C;IAIpE,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAQ3C;IAEF,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAEvC;IAEO,iBAAiB,IAAI,IAAI;IA4BzB,oBAAoB,IAAI,IAAI;IASrC,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B,uDAAuD;IACvD,OAAO,CAAC,oBAAoB;IAQ5B,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB;IAWzB,+DAA+D;IAC/D,OAAO,CAAC,mBAAmB;IAK3B,wDAAwD;IACxD,OAAO,CAAC,SAAS;IAwBjB,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAM1C;IAEX,oEAAoE;IACpE,OAAO,CAAC,gCAAgC;IAMxC,8CAA8C;IAC9C,OAAO,CAAC,mCAAmC;IAM3C,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAO/B,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAqFvB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAuDvB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAkCrB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAMnB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAQpB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAkBtB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAqBhB,MAAM;CAyChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,GAAG,wBAAwB,CAAC;IACvF,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;CAChD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}
+{"version":3,"file":"hx-phi-field.d.ts","sourceRoot":"","sources":["../../../src/components/hx-phi-field/hx-phi-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAEhD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA4C;IAIlE;;;;OAIG;IAEH,IAAI,EAAE,MAAM,CAAM;IAElB;;;OAGG;IAEH,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAS;IAEvD;;;OAGG;IAEH,OAAO,EAAE,MAAM,CAAM;IAErB;;;;OAIG;IAEH,gBAAgB,EAAE,MAAM,CAAS;IAEjC;;;;OAIG;IAEH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;;;OAKG;IAEH,aAAa,EAAE,MAAM,CAAM;IAE3B;;;;OAIG;IAEH,QAAQ,EAAE,OAAO,CAAS;IAI1B,gBAAgB;IACP,OAAO,CAAC,OAAO,CAAQ;IAEhC,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAA8C;IAErE,wDAAwD;IACxD,OAAO,CAAC,cAAc,CAA8C;IAIpE,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAQ3C;IAEF,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAEvC;IAEO,iBAAiB,IAAI,IAAI;IA4BzB,oBAAoB,IAAI,IAAI;IASrC,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B,uDAAuD;IACvD,OAAO,CAAC,oBAAoB;IAQ5B,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB;IAWzB,+DAA+D;IAC/D,OAAO,CAAC,mBAAmB;IAK3B,wDAAwD;IACxD,OAAO,CAAC,SAAS;IAwBjB,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAM1C;IAEX,oEAAoE;IACpE,OAAO,CAAC,gCAAgC;IAMxC,8CAA8C;IAC9C,OAAO,CAAC,mCAAmC;IAM3C,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAO/B,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAqFvB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAuDvB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAkCrB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAMnB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAQpB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAkBtB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAqBhB,MAAM;CAyChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,GAAG,wBAAwB,CAAC;IACvF,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;CAChD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as r } from "../../shared/hx-popover-CHxWY_cd.js";
+import { H as r } from "../../shared/hx-popover-B9W8-tC0.js";
 export {
   r as HelixPopover
 };

package/dist/components/hx-progress-bar/hx-progress-bar.d.ts

@@ -3,6 +3,18 @@ import { HelixElement } from '../../base/index.js';
 /**
  * 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).
+ *
  * @summary Displays task completion progress or an indeterminate loading state.
  *
  * @tag hx-progress-bar
@@ -45,6 +57,12 @@ import { HelixElement } from '../../base/index.js';
  */
 export declare class HelixProgressBar 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;
     /**
      * Current progress value (min–max). Set to null for indeterminate state.
      * @attr value
@@ -94,14 +112,29 @@ export declare class HelixProgressBar extends HelixElement {
     /** @internal */
     private _uid;
     /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
+    private _resolvedAccessibleName;
+    /** @internal */
     private get _isIndeterminate();
     /** @internal */
     private get _percentage();
     /** @internal */
     private get _isComplete();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     updated(changedProps: PropertyValues<this>): void;
     /** @internal */
     private _onLabelSlotChange;
+    /**
+     * Mirror progressbar semantics onto the host. Dual-surface: inner track
+     * keeps role + value-state, host adds the cross-shadow IDREF wiring via
+     * internals.* (the hx-progress-ring exemplar pattern).
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private static readonly _VARIANT_LABELS;
     /** @internal */

package/dist/components/hx-progress-bar/hx-progress-bar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-progress-bar.d.ts","sourceRoot":"","sources":["../../../src/components/hx-progress-bar/hx-progress-bar.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAAiD;IAEvE;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5B;;;OAGG;IAEH,GAAG,SAAK;IAER;;;OAGG;IAEH,GAAG,SAAO;IAEV;;;OAGG;IAEH,aAAa,UAAS;IAEtB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,WAAW,SAAM;IAEjB;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAElE,gBAAgB;IACP,OAAO,CAAC,YAAY,CAAM;IACnC,gBAAgB;IACP,OAAO,CAAC,oBAAoB,CAAS;IAC9C,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAAS;IAElC,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAAwB;IAEpC,gBAAgB;IAChB,OAAO,KAAK,gBAAgB,GAE3B;IAED,gBAAgB;IAChB,OAAO,KAAK,WAAW,GAUtB;IAED,gBAAgB;IAChB,OAAO,KAAK,WAAW,GAEtB;IAEQ,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA4B1D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAU1B,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAIrC;IAEF,gBAAgB;IAChB,OAAO,KAAK,aAAa,GAExB;IAEQ,MAAM;CAqDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}
+{"version":3,"file":"hx-progress-bar.d.ts","sourceRoot":"","sources":["../../../src/components/hx-progress-bar/hx-progress-bar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAcpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAAiD;IAEvE;;;;OAIG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5B;;;OAGG;IAEH,GAAG,SAAK;IAER;;;OAGG;IAEH,GAAG,SAAO;IAEV;;;OAGG;IAEH,aAAa,UAAS;IAEtB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,WAAW,SAAM;IAEjB;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAElE,gBAAgB;IACP,OAAO,CAAC,YAAY,CAAM;IACnC,gBAAgB;IACP,OAAO,CAAC,oBAAoB,CAAS;IAC9C,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAAS;IAElC,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAAwB;IAIpC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAAM;IAErC,gBAAgB;IAChB,OAAO,KAAK,gBAAgB,GAE3B;IAED,gBAAgB;IAChB,OAAO,KAAK,WAAW,GAUtB;IAED,gBAAgB;IAChB,OAAO,KAAK,WAAW,GAEtB;IAEQ,iBAAiB,IAAI,IAAI;IAazB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAwC1D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAM1B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAsF9B,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAIrC;IAEF,gBAAgB;IAChB,OAAO,KAAK,aAAa,GAExB;IAEQ,MAAM;CAmDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}

package/dist/components/hx-progress-bar/index.js

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-progress-bar-Bn3JEPUf.js";
+import { H as o } from "../../shared/hx-progress-bar-C8nDMdYa.js";
 export {
   o as HelixProgressBar
 };

package/dist/components/hx-radio-group/index.js

@@ -1,4 +1,4 @@
-import { H as i, a as e } from "../../shared/hx-radio-CeGzARNk.js";
+import { H as i, a as e } from "../../shared/hx-radio-Z1lV1zTO.js";
 export {
   i as HelixRadio,
   e as HelixRadioGroup

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

@@ -32,6 +32,7 @@ declare const HelixSelect_base: typeof HelixElement & (new (...args: any[]) => i
  * @slot help-text - Custom help text content (overrides the helpText property).
  *
  * @fires {CustomEvent<{value: string}>} hx-change - Dispatched when the selected option changes.
+ * @fires {Event} invalid - Platform constraint-validation event fired when checkValidity() / reportValidity() determine the value is invalid (form-associated component contract via ElementInternals.setValidity).
  *
  * @csspart field - The outer field container.
  * @csspart label - The label element.

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

@@ -1 +1 @@
-{"version":3,"file":"hx-select.d.ts","sourceRoot":"","sources":["../../../src/components/hx-select/hx-select.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hx-select.d.ts","sourceRoot":"","sources":["../../../src/components/hx-select/hx-select.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-select-DrcS-YRJ.js";
+import { H as o } from "../../shared/hx-select-D18CnJ0e.js";
 export {
   o as HelixSelect
 };

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

@@ -1,3 +1,4 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * Token size values for the spinner. Use these for standard sizing.
@@ -77,6 +78,19 @@ export declare class HelixSpinner extends HelixElement {
      */
     decorative: boolean;
     connectedCallback(): void;
+    updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Group 9 host-canonical migration: mirror `role="status"` / `"presentation"`
+     * and `aria-label` onto the host via `ElementInternals` so AT walks the host
+     * surface as the canonical loading indicator. The inner `<div>` keeps the
+     * legacy role + aria-label so consumer queries and pre-host-canonical AT
+     * still resolve. Modern path: host is canonical; legacy path: dual-surface.
+     *
+     * Also fires a devWarn when the spinner is non-decorative AND the label is
+     * empty (silent unnamed `role="status"` is a WCAG 4.1.2 failure).
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _isTokenSize;
     render(): import('lit').TemplateResult<1>;

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

@@ -1 +1 @@
-{"version":3,"file":"hx-spinner.d.ts","sourceRoot":"","sources":["../../../src/components/hx-spinner/hx-spinner.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAKpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,OAAgB,MAAM,4BAA6C;IAEnE;;;;;;;;OAQG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAQ;IAElE;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAa;IAExD;;;;OAIG;IAEH,KAAK,SAAa;IAElB;;;;;OAKG;IAEH,UAAU,UAAS;IAIV,iBAAiB,IAAI,IAAI;IAWlC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAIX,MAAM;CAqChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,YAAY,CAAC;KAC5B;CACF"}
+{"version":3,"file":"hx-spinner.d.ts","sourceRoot":"","sources":["../../../src/components/hx-spinner/hx-spinner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAKpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,OAAgB,MAAM,4BAA6C;IAEnE;;;;;;;;OAQG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAQ;IAElE;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAa;IAExD;;;;OAIG;IAEH,KAAK,SAAa;IAElB;;;;;OAKG;IAEH,UAAU,UAAS;IAIV,iBAAiB,IAAI,IAAI;IAYzB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAO/D;;;;;;;;;;OAUG;IACH,OAAO,CAAC,sBAAsB;IAoB9B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAIX,MAAM;CAqChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,YAAY,CAAC;KAC5B;CACF"}

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
 };