@helixui/library 3.3.1 → 3.4.0-next.121

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

@@ -3,6 +3,46 @@ import { HelixElement } from '../../base/index.js';
 /**
  * A popover that displays rich floating content attached to a trigger element.
  *
+ * ## Architecture Note: Host-Attribute Label Mirror (group-4 round-1)
+ *
+ * Unlike modal dialogs (`hx-dialog` / `hx-drawer`) where the HOST is the
+ * announced surface and `ElementInternals` projects consumer IDREFs across
+ * the shadow boundary, `hx-popover`'s announced surface is the inner
+ * `[part="body"]` element which carries `role="dialog"`. The host does not
+ * claim a role — it is a structural wrapper around an anchor slot and a
+ * separate floating panel.
+ *
+ * IDL element references on `internals.ariaLabelledByElements` therefore
+ * cannot help: AT walks the inner body's accessibility node, and IDL refs
+ * declared on the host are not visible from a shadow-internal descendant
+ * looking up. The viable cross-shadow path is the host-attribute mirror:
+ *
+ *   1. The host observes `aria-label` / `aria-labelledby` mutations.
+ *   2. On every sync, `aria-labelledby` IDREFs are resolved via
+ *      `resolveIdrefTokens` (composed-tree walk: host root → ancestor
+ *      shadow hosts → owner document) and **text-flattened** via
+ *      `flattenAccName` (AccName 1.2 §4.3.10 hidden-aware).
+ *   3. The flattened name is written to the inner body's `aria-label`,
+ *      overriding the `label` property only when consumer naming is set.
+ *
+ * Naming precedence (W3C AccName 1.2 §4.3.1):
+ *
+ *   1. Host `aria-labelledby` (resolved IDREFs, text-flattened)
+ *   2. Host `aria-label`
+ *   3. `label` property
+ *   4. Hard-coded literal `"Popover"` (last-resort accessible name)
+ *
+ * The text-flatten approach forfeits live IDL-ref tracking (mutating a
+ * referenced element's text re-fires through the shared root observer; see
+ * `installAriaIdrefMirror`). `aria-controls` is intentionally omitted on
+ * the trigger — the body lives in shadow DOM and consumer IDREFs cannot
+ * resolve cross-root from light-DOM (axe-core flags this as a critical
+ * violation if attempted; see line documenting this exception below).
+ *
+ * Slotted label support (e.g. `<slot name="title">`) is deliberately NOT
+ * added in this round — it would expand the public API surface and is
+ * tracked as a follow-up enhancement.
+ *
  * @summary Rich floating overlay attached to a trigger element.
  *
  * @tag hx-popover
@@ -96,6 +136,35 @@ export declare class HelixPopover extends HelixElement {
      * @internal
      */
     private _visible;
+    /**
+     * Resolved accessible name for the popover body — the value written to
+     * the inner `[part="body"]` `aria-label`. Recomputed on every sync per
+     * the AccName 1.2 §4.3.1 precedence: host `aria-labelledby` (flattened)
+     * > host `aria-label` > `label` property > literal `"Popover"`.
+     *
+     * Stored as state so render reads the current resolution synchronously.
+     * @internal
+     */
+    private _resolvedLabel;
+    /**
+     * Most recently observed consumer-supplied `aria-labelledby` token list on
+     * the host. Refreshed every sync via `getAttribute()`.
+     * @internal
+     */
+    private _consumerLabelledBy;
+    /**
+     * Handle for the shared host attribute / root id observer.
+     * @internal
+     */
+    private _ariaMirror;
+    /**
+     * Watches in-place text / visibility mutations on consumer light-DOM
+     * elements resolved from the host's `aria-labelledby`. Reinstalled on
+     * every sync against the deduped resolved set so an in-place text change
+     * to `<h2 id="x">Patient</h2>` flows into the inner body's `aria-label`.
+     * @internal
+     */
+    private _externalRefsObserver;
     /**
      * The element that held focus before the popover opened, used to restore focus on close.
      * @internal
@@ -120,9 +189,31 @@ export declare class HelixPopover extends HelixElement {
      * @internal
      */
     private _hoverHideTimer;
+    connectedCallback(): void;
     disconnectedCallback(): void;
     firstUpdated(): void;
+    willUpdate(changedProperties: PropertyValues<this>): void;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * (Re-)installs a `MutationObserver` over the deduped union of
+     * consumer-resolved label elements. Watches `characterData`, `childList`,
+     * `subtree`, and `aria-hidden` / `hidden` attributes so any in-place
+     * mutation on referenced light-DOM nodes triggers a fresh sync — keeping
+     * the flattened `aria-label` aligned with the live consumer text.
+     * @internal
+     */
+    private _installExternalRefsObserver;
+    /**
+     * Resolves the popover body's accessible name from host attributes and
+     * the `label` property, applying AccName 1.2 §4.3.1 precedence. Writes
+     * the result to `_resolvedLabel` (state) so `render()` projects it onto
+     * the inner body's `aria-label` on the next paint. The text-flatten
+     * filters out top-level `aria-hidden="true"` / `[hidden]` subtrees per
+     * AccName 1.2 §4.3.10 — matching the `flattenAccName` contract used by
+     * every other host-canonical hx-* component.
+     * @internal
+     */
+    private _syncResolvedLabel;
     /** @internal */
     private _setAnchorAriaAttributes;
     /** Return all keyboard-focusable elements inside the popover body's slotted content. */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-popover.d.ts","sourceRoot":"","sources":["../../../src/components/hx-popover/hx-popover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,qBACa,YAAa,SAAQ,YAAY;IAC5C,OAAgB,MAAM,4BAA6C;IAEnE;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,SAAS,EACL,KAAK,GACL,WAAW,GACX,SAAS,GACT,OAAO,GACP,aAAa,GACb,WAAW,GACX,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,CAAY;IAE1B;;;OAGG;IAEH,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAW;IAE1D;;;OAGG;IAEH,QAAQ,SAAK;IAEb;;;OAGG;IAEH,QAAQ,SAAK;IAEb;;;OAGG;IAEH,KAAK,UAAS;IAEd;;;OAGG;IAEH,KAAK,SAAa;IAElB;;;OAGG;IACM,OAAO,CAAC,QAAQ,CAAS;IAElC;;;OAGG;IACH,OAAO,CAAC,cAAc,CAA4B;IAElD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAA8C;IAEhE;;;;;;OAMG;IACH,OAAO,CAAC,eAAe,CAA8C;IAI5D,oBAAoB,IAAI,IAAI;IAc5B,YAAY,IAAI,IAAI;IAUpB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAa/D,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAgBhC,wFAAwF;IACxF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAyB7B,gBAAgB;YACF,KAAK;IAwCnB,gBAAgB;YACF,KAAK;IAmBnB,gBAAgB;YACF,eAAe;IA+E7B;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAiC5B;IAGF;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAO1B;IAEF;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAOxB;IAEF;;;OAGG;IACH,OAAO,CAAC,uBAAuB,CAG7B;IAEF;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB,CAG7B;IAIF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB,CAI3B;IAEF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB,CAG3B;IAEF;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAOxB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB,CAI1B;IAEF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB,CAQ3B;IAEF,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAMtB,MAAM;CA6BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,YAAY,CAAC;KAC5B;CACF"}
+{"version":3,"file":"hx-popover.d.ts","sourceRoot":"","sources":["../../../src/components/hx-popover/hx-popover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAYpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AAEH,qBACa,YAAa,SAAQ,YAAY;IAC5C,OAAgB,MAAM,4BAA6C;IAEnE;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,SAAS,EACL,KAAK,GACL,WAAW,GACX,SAAS,GACT,OAAO,GACP,aAAa,GACb,WAAW,GACX,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,CAAY;IAE1B;;;OAGG;IAEH,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAW;IAE1D;;;OAGG;IAEH,QAAQ,SAAK;IAEb;;;OAGG;IAEH,QAAQ,SAAK;IAEb;;;OAGG;IAEH,KAAK,UAAS;IAEd;;;OAGG;IAEH,KAAK,SAAa;IAElB;;;OAGG;IACM,OAAO,CAAC,QAAQ,CAAS;IAElC;;;;;;;;OAQG;IACM,OAAO,CAAC,cAAc,CAAM;IAErC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB,CAAiC;IAE9D;;;OAGG;IACH,OAAO,CAAC,cAAc,CAA4B;IAElD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAA8C;IAEhE;;;;;;OAMG;IACH,OAAO,CAAC,eAAe,CAA8C;IAI5D,iBAAiB,IAAI,IAAI;IAYzB,oBAAoB,IAAI,IAAI;IAkB5B,YAAY,IAAI,IAAI;IAUpB,UAAU,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAYzD,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAY/D;;;;;;;OAOG;IACH,OAAO,CAAC,4BAA4B;IAsBpC;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IA0C1B,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAgBhC,wFAAwF;IACxF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAyB7B,gBAAgB;YACF,KAAK;IAwCnB,gBAAgB;YACF,KAAK;IAmBnB,gBAAgB;YACF,eAAe;IA+E7B;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAiC5B;IAGF;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAO1B;IAEF;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAOxB;IAEF;;;OAGG;IACH,OAAO,CAAC,uBAAuB,CAG7B;IAEF;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB,CAG7B;IAIF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB,CAI3B;IAEF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB,CAG3B;IAEF;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAOxB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB,CAI1B;IAEF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB,CAQ3B;IAEF,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAMtB,MAAM;CA6BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,YAAY,CAAC;KAC5B;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as r } from "../../shared/hx-popover-B-FP3-wW.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
 };