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

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

@@ -25,14 +25,24 @@ export type DropdownPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bo
  *   3. `label` property
  *   4. Hard-coded literal `"Menu"` (last-resort accessible name)
  *
- * **Group 5 boundary (intentional):** This round is **additive only** — the
- * host-label pipeline is the entire change. The panel's `role="menu"` and
- * the menuitem-roving keyboard pattern are already implemented per APG and
- * are NOT touched here. Group 5 (composite navigation: menu, menubar,
- * menuitem, tabs, tree) will own any broader refactor of the menu role and
- * roving-tabindex semantics. Codex reviewers: please scope findings to the
- * host-label pipeline; do not flag missing roving-focus / typeahead /
- * `aria-orientation` work here.
+ * **Group 4b → Group 5b boundary:** Group 4b added the host-attribute
+ * label mirror **only** — additive on top of the existing dropdown
+ * behaviour. Group 5b (this commit) adds the composite-navigation
+ * portion that 4b explicitly deferred:
+ *   - **Roving tabindex** inside the panel (`_applyRovingTabIndex` +
+ *     `_rovingIndex`). Only the focused item carries `tabindex=0`.
+ *   - **First-character typeahead** with 500ms timeout (`_handleTypeahead`)
+ *     matching `hx-menu`, `hx-overflow-menu`, `hx-split-button`.
+ *   - Submenu auto-handling is delegated to slotted `hx-menu` /
+ *     `hx-menu-item` (whose `hx-item-submenu-open` / `hx-item-submenu-close`
+ *     events are auto-handled by the parent `hx-menu` after Group 5b).
+ *
+ * The panel's inner-div `role="menu"` is intentionally NOT migrated to
+ * the host: the host wraps a slotted consumer trigger AND the panel,
+ * so it cannot canonically carry the menu role. Slotted `hx-menu-item`
+ * children carry `role="menuitem"` on their HOST after Group 5b's menu
+ * migration, which fixes the cross-shadow walk concern from the
+ * consumer's perspective.
  *
  * `aria-controls` is intentionally omitted on the trigger: the panel lives
  * in shadow DOM and IDREF values cannot be resolved across shadow
@@ -109,6 +119,24 @@ export declare class HelixDropdown extends HelixElement {
      * @internal
      */
     private _panelVisible;
+    /**
+     * Index within the panel's focusable menu items of the item currently
+     * holding the roving tabindex (and thus visual focus). −1 means the
+     * panel has not been keyboard-focused yet.
+     * @internal
+     */
+    private _rovingIndex;
+    /**
+     * Accumulated character buffer for typeahead search within the panel's
+     * menu items. Cleared after 500ms of inactivity.
+     * @internal
+     */
+    private _typeaheadBuffer;
+    /**
+     * Timer handle that clears the typeahead buffer after a period of inactivity.
+     * @internal
+     */
+    private _typeaheadTimer;
     /**
      * Resolved accessible name for the menu panel — the value written to the
      * inner `[part="panel"]` `aria-label`. Recomputed on every sync per
@@ -171,6 +199,30 @@ export declare class HelixDropdown extends HelixElement {
     private _handleKeydown;
     /** @internal */
     private _handleMenuNavigation;
+    /**
+     * Roving tabindex inside the panel: only the focused item carries
+     * tabindex=0; the rest are tabindex=-1. APG-compliant for the menu
+     * button pattern. Closing-Tab semantics are preserved by the
+     * `_handleKeydown` Tab branch above (which lets focus advance
+     * naturally and closes the panel).
+     *
+     * Group 5b: introduced to align hx-dropdown's panel keyboard contract
+     * with hx-menu / hx-overflow-menu / hx-split-button. Group 4b only
+     * added the host-attribute label mirror (additive); this is the
+     * keyboard portion deferred until Group 5.
+     *
+     * Codex push-gate round-8 finding 2: route through
+     * `writeMenuItemRovingTabIndex` so host-canonical `hx-menu-item` items
+     * land their roving tabindex on the correct surface (host on the
+     * modern path, inner `.menu-item` on the fallback path). A direct
+     * `item.tabIndex = value` write on the host fails on the fallback
+     * path because the host is forced to `tabindex=-1` to keep exactly
+     * one focusable surface per item.
+     * @internal
+     */
+    private _applyRovingTabIndex;
+    /** @internal */
+    private _handleTypeahead;
     /** @internal */
     private _getFocusableMenuItems;
     /** @internal */
@@ -179,6 +231,42 @@ export declare class HelixDropdown extends HelixElement {
     private _handleOutsideClick;
     /** @internal */
     private _handlePanelClick;
+    /**
+     * Bubbled `hx-item-select` from a slotted `hx-menu-item` host. Forwards
+     * the activation through the composite's `hx-select` contract using the
+     * item's `value` property and label text. Disabled items never emit
+     * `hx-item-select`, so no disabled-guard is needed here.
+     * @internal
+     */
+    private _handlePanelItemSelect;
+    /**
+     * 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 composite's panel (no enclosing
+     * `hx-menu`), the events fly past with no handler. Match the round-4
+     * `hx-menu._handleSubmenuOpen` shape so APG behaviour holds.
+     *
+     * If the dispatching item is enclosed by an inner `hx-menu` (a true
+     * nested submenu inside the panel), that menu owns the toggle — defer.
+     * Otherwise this composite's panel is the enclosing menu surface, so
+     * call `setSubmenuOpen(true)` on the item and focus the first child.
+     * @internal
+     */
+    private _handlePanelSubmenuOpen;
+    /**
+     * Bubbled `hx-item-submenu-close` from a slotted `hx-menu-item` host.
+     * Codex push-gate round-9 P1: routes the close to the right surface.
+     *
+     * - Nested submenu close (the dispatching item lives inside an inner
+     *   `hx-menu` slotted into a parent's `slot="submenu"`): defer to that
+     *   inner menu's own handler. The composite's panel must NOT close.
+     * - Top-level item ArrowLeft (no enclosing `hx-menu` between the item
+     *   and this composite): there is no parent submenu to close, so
+     *   collapse the composite's panel and return focus to the trigger,
+     *   matching APG menu-button behaviour.
+     * @internal
+     */
+    private _handlePanelSubmenuClose;
     render(): import('lit').TemplateResult<1>;
     /** @internal */
     private _onPanelSlotChange;

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

@@ -1 +1 @@
-{"version":3,"file":"hx-dropdown.d.ts","sourceRoot":"","sources":["../../../src/components/hx-dropdown/hx-dropdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAanD,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,OAAO,GACP,KAAK,CAAC;AAIV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAAkD;IAIxE;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,SAAS,EACL,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,OAAO,GACP,KAAK,CAAkB;IAE3B;;;OAGG;IACS,KAAK,SAAU;IAE3B;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,SAAK;IAIb;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;;;;OAMG;IACM,OAAO,CAAC,cAAc,CAAM;IAErC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;OAIG;IACH,OAAO,CAAC,qBAAqB,CAAiC;IAE9D;;;;OAIG;IACH,OAAO,CAAC,yBAAyB,CAAS;IAG1C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAgC;IAEhD;;;OAGG;IACsB,OAAO,CAAC,MAAM,CAA0B;IACjE;;;OAGG;IACwB,OAAO,CAAC,eAAe,CAA0B;IAInE,iBAAiB,IAAI,IAAI;IAWzB,oBAAoB,IAAI,IAAI;IAerC,gBAAgB;YACF,KAAK;IAwBnB,gBAAgB;IAChB,OAAO,CAAC,KAAK;IAkBb,gBAAgB;YACF,eAAe;IAyB7B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAS3B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAepB;IAGF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAkB7B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAkB9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAgB9B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB,CAKzB;IAEF,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAsBhB,MAAM;IA0Bf,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAInB,YAAY,IAAI,IAAI;IAI7B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAkBhB,UAAU,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAUzD,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAiB/D;;;;;;;OAOG;IACH,OAAO,CAAC,4BAA4B;IAsBpC;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;CAkC3B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,aAAa,EAAE,aAAa,CAAC;KAC9B;IACD,UAAU,mBAAmB;QAC3B,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7B,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7B,WAAW,EAAE,WAAW,CAAC;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnE;CACF"}
+{"version":3,"file":"hx-dropdown.d.ts","sourceRoot":"","sources":["../../../src/components/hx-dropdown/hx-dropdown.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-dropdown-DJWlF94E.js";
+import { H as e } from "../../shared/hx-dropdown-DiLd40Lm.js";
 export {
   e as HelixDropdown
 };

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

@@ -1,5 +1,6 @@
-import { nothing } from 'lit';
+import { nothing, TemplateResult } from 'lit';
 import { HelixElement } from '../../base/index.js';
+declare const HelixIconButton_base: typeof HelixElement;
 /**
  * An icon-only button component for compact, accessible actions.
  * Renders a square button or anchor element containing a single icon.
@@ -16,6 +17,7 @@ import { HelixElement } from '../../base/index.js';
  *
  * @csspart button - The native button or anchor element.
  * @csspart icon - The icon container span wrapping the default slot.
+ * @csspart spinner - The loading spinner SVG element shown when `loading` is true.
  *
  * @cssprop [--hx-icon-button-bg=transparent] - Button background color.
  * @cssprop [--hx-icon-button-color=var(--hx-color-primary-500)] - Icon color.
@@ -51,7 +53,7 @@ import { HelixElement } from '../../base/index.js';
  * @cssprop [--hx-color-error-500] - Color.
  * @cssprop [--hx-color-error-600] - Color.
  */
-export declare class HelixIconButton extends HelixElement {
+export declare class HelixIconButton extends HelixIconButton_base {
     static styles: import('lit').CSSResult[];
     /**
      * Accessible name for the button. Required. Rendered as `aria-label` and
@@ -81,6 +83,14 @@ export declare class HelixIconButton extends HelixElement {
      * @attr disabled
      */
     disabled: boolean;
+    /**
+     * Whether the button is in a loading state. Shows the spinner, prevents
+     * activation, and sets `aria-busy="true"` on the inner element. Does NOT
+     * set the native `disabled` attribute (loading is transient; disabled is
+     * persistent, and AT announces them differently).
+     * @attr loading
+     */
+    loading: boolean;
     /**
      * When set, renders an `<a>` element instead of a `<button>`.
      * @attr href
@@ -107,7 +117,9 @@ export declare class HelixIconButton extends HelixElement {
     private _classes;
     /** @internal */
     private _iconSlot;
-    render(): typeof nothing | import('lit').TemplateResult<1>;
+    /** @internal */
+    private _renderSpinner;
+    render(): typeof nothing | TemplateResult<1>;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -119,4 +131,5 @@ declare global {
         }>;
     }
 }
+export {};
 //# sourceMappingURL=hx-icon-button.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hx-icon-button.d.ts","sourceRoot":"","sources":["../../../src/components/hx-icon-button/hx-icon-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,OAAgB,MAAM,4BAAoD;IAE1E;;;;;OAKG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAW;IAE7E;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;;OAIG;IAEH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAY;IAE/C;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAItC,oFAAoF;IACpF,OAAgB,cAAc,UAAQ;cAEnB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAM3D,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA+BpB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAIxB,gBAAgB;IAChB,OAAO,CAAC,QAAQ;IAQhB,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAMR,MAAM;CAsDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;IACD,UAAU,mBAAmB;QAC3B,UAAU,EAAE,WAAW,CAAC;YAAE,aAAa,EAAE,UAAU,CAAA;SAAE,CAAC,CAAC;KACxD;CACF"}
+{"version":3,"file":"hx-icon-button.d.ts","sourceRoot":"","sources":["../../../src/components/hx-icon-button/hx-icon-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;;AAMnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBACa,eAAgB,SAAQ,oBAAgC;IACnE,OAAgB,MAAM,4BAAoD;IAE1E;;;;;OAKG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAW;IAE7E;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;;OAIG;IAEH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAY;IAE/C;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;;;OAMG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAItC,oFAAoF;IACpF,OAAgB,cAAc,UAAQ;cAEnB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAM3D,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA+BpB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAIxB,gBAAgB;IAChB,OAAO,CAAC,QAAQ;IAShB,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAIjB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IA+Bb,MAAM;CAgFhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;IACD,UAAU,mBAAmB;QAC3B,UAAU,EAAE,WAAW,CAAC;YAAE,aAAa,EAAE,UAAU,CAAA;SAAE,CAAC,CAAC;KACxD;CACF"}

package/dist/components/hx-icon-button/hx-icon-button.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-icon-button.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-icon-button/hx-icon-button.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,yBA2LjC,CAAC"}
+{"version":3,"file":"hx-icon-button.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-icon-button/hx-icon-button.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,yBAyNjC,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-icon-button-CGNdQSFM.js";
+import { H as e } from "../../shared/hx-icon-button-a6OpeQz5.js";
 export {
   e as HelixIconButton
 };

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

@@ -3,6 +3,7 @@ import { HelixElement } from '../../base/index.js';
  * Variant options for the link component.
  */
 export type LinkVariant = 'default' | 'subtle' | 'danger';
+declare const HelixLink_base: typeof HelixElement;
 /**
  * A semantic hyperlink component with accessibility-first design.
  * Renders a native `<a>` element for enabled state and a `<span>` for
@@ -52,7 +53,7 @@ export type LinkVariant = 'default' | 'subtle' | 'danger';
  * @cssprop [--hx-color-error-700] - Color.
  * @cssprop [--hx-color-neutral-400] - Color.
  */
-export declare class HelixLink extends HelixElement {
+export declare class HelixLink extends HelixLink_base {
     static styles: import('lit').CSSResult[];
     /**
      * The URL the link points to.
@@ -90,6 +91,13 @@ export declare class HelixLink extends HelixElement {
      * @attr rel
      */
     rel: string | undefined;
+    /**
+     * Localised announcement text appended (visually hidden) to the link's
+     * accessible name when `target="_blank"`. Defaults to English. Override
+     * for i18n contexts so AT users hear the new-tab notice in their locale.
+     * @attr external-label
+     */
+    externalLabel: string;
     /** @internal Blocks Enter and Space activation on disabled span. */
     private _handleDisabledKeydown;
     /** @internal */
@@ -105,4 +113,5 @@ declare global {
         'hx-link': HelixLink;
     }
 }
+export {};
 //# sourceMappingURL=hx-link.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hx-link.d.ts","sourceRoot":"","sources":["../../../src/components/hx-link/hx-link.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAAuC;IAE7D;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;;;OAKG;IAEH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAa;IAEvC;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAa;IAErD;;;;;OAKG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAa;IAEzC;;;;OAIG;IAEH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAIpC,oEAAoE;IACpE,OAAO,CAAC,sBAAsB;IAM9B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAkBpB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAMnB,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAuBlB,MAAM;CAsChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}
+{"version":3,"file":"hx-link.d.ts","sourceRoot":"","sources":["../../../src/components/hx-link/hx-link.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,qBACa,SAAU,SAAQ,cAAgC;IAC7D,OAAgB,MAAM,4BAAuC;IAE7D;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;;;OAKG;IAEH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAa;IAEvC;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAa;IAErD;;;;;OAKG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAa;IAEzC;;;;OAIG;IAEH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAEpC;;;;;OAKG;IAEH,aAAa,EAAE,MAAM,CAAwB;IAI7C,oEAAoE;IACpE,OAAO,CAAC,sBAAsB;IAM9B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAkBpB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAMnB,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAuBlB,MAAM;CAuDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-link-C-O6vq0Q.js";
+import { H as o } from "../../shared/hx-link-CMnZRUtQ.js";
 export {
   o as HelixLink
 };

package/dist/components/hx-list/hx-list-item.d.ts

@@ -3,6 +3,14 @@ import { HelixElement } from '../../base/index.js';
 /**
  * A rich list item for use inside `hx-list`.
  *
+ * Group 7 host-canonical: `role="option"` (interactive listbox mode) is
+ * mirrored onto the **host** via `_internals.role` AND the legacy
+ * setAttribute('role',...) path. The dual-surface pattern preserves the
+ * existing imperative host-attribute behaviour (so consumers querying
+ * `host.getAttribute('role')` still work) while adding cross-shadow IDREF
+ * wiring through `internals.ariaLabelledByElements` for engines that
+ * support it.
+ *
  * @summary Individual list item with optional prefix, suffix, description, link, and disabled/selected states.
  *
  * @tag hx-list-item
@@ -30,6 +38,12 @@ import { HelixElement } from '../../base/index.js';
  */
 export declare class HelixListItem 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;
     /**
      * Whether the item is disabled. Prevents interaction.
      * @attr disabled
@@ -61,10 +75,22 @@ export declare class HelixListItem extends HelixElement {
      * @attr type
      */
     type: 'default' | 'term' | 'definition';
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
+    private _resolvedAccessibleName;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     updated(changedProps: PropertyValues<this>): void;
     /**
      * Syncs ARIA attributes to the host element when in interactive (listbox option) mode.
-     * This ensures correct ARIA ownership: ul[role=listbox] > hx-list-item[role=option].
+     * Preserves the prior imperative `setAttribute('role', 'option')` path so existing
+     * consumer queries and tests continue to pass. ALSO mirrors the same surface onto
+     * `internals.role` / `internals.ariaSelected` (modern path) so cross-shadow IDREF
+     * resolution through `internals.ariaLabelledByElements` works on engines that
+     * support it.
      */
     /** @internal */
     private _syncHostAria;

package/dist/components/hx-list/hx-list-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-list-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-list/hx-list-item.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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA8C;IAEpE;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;OAIG;IAEH,WAAW,UAAS;IAEpB;;;OAGG;IAEH,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,CAAa;IAE3C,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAW1D;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAsBrB,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAU9B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAUpB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAmBb,MAAM;IAmFf,gBAAgB;IAChB,OAAO,CAAC,cAAc;CAQvB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}
+{"version":3,"file":"hx-list-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-list/hx-list-item.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAA8C;IAEpE;;;;OAIG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;OAIG;IAEH,WAAW,UAAS;IAEpB;;;OAGG;IAEH,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,CAAa;IAIpD,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,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAW1D;;;;;;;OAOG;IACH,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAgFrB,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAU9B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAUpB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAmBb,MAAM;IAmFf,gBAAgB;IAChB,OAAO,CAAC,cAAc;CAQvB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}

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

@@ -3,6 +3,12 @@ import { HelixElement } from '../../base/index.js';
 /**
  * A styled list container supporting plain, bulleted, numbered, description, and interactive variants.
  *
+ * Group 7 host-canonical: `role="list"` (or `role="listbox"` in interactive
+ * mode) lives on the **host** via `_internals.role`, harmonizing with
+ * `hx-structured-list` (the gold-standard exemplar for Group 7). The `<dl>`
+ * description variant keeps native semantics — no host role assigned, since
+ * `<dl>` IS the semantic surface and AT walks it directly.
+ *
  * @summary Container for list items with optional dividers and interactive selection.
  *
  * @tag hx-list
@@ -22,6 +28,12 @@ import { HelixElement } from '../../base/index.js';
  */
 export declare class HelixList 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;
     /**
      * Visual variant of the list.
      * @attr variant
@@ -37,6 +49,12 @@ export declare class HelixList extends HelixElement {
      * @attr label
      */
     label: string | undefined;
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
+    private _resolvedAccessibleName;
     connectedCallback(): void;
     disconnectedCallback(): void;
     updated(changedProps: PropertyValues<this>): void;
@@ -46,6 +64,16 @@ export declare class HelixList extends HelixElement {
      */
     /** @internal */
     private _updateItemStates;
+    /**
+     * Resolve the host's role for the current variant. Description variant
+     * uses native `<dl>` semantics (returns `null` so the host carries no
+     * explicit role). Interactive variant becomes `listbox`. All other
+     * variants are `list`.
+     * @internal
+     */
+    private _hostRole;
+    /** @internal */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _handleSlotChange;
     /** @internal */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-list.d.ts","sourceRoot":"","sources":["../../../src/components/hx-list/hx-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA0C;IAEhE;;;OAGG;IAEH,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,CAAW;IAErF;;;OAGG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAE7B,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAc1D;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAQzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAiC7B;IAEF,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAgBf,MAAM;CA+ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}
+{"version":3,"file":"hx-list.d.ts","sourceRoot":"","sources":["../../../src/components/hx-list/hx-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAanD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA0C;IAEhE;;;;OAIG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,CAAW;IAErF;;;OAGG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAItC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAAM;IAE5B,iBAAiB,IAAI,IAAI;IAczB,oBAAoB,IAAI,IAAI;IAO5B,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB1D;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAQzB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAMjB,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAwE9B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAiC7B;IAEF,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAgBf,MAAM;CAmDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as s, a as t } from "../../shared/hx-list-MyEhh8c7.js";
+import { H as s, a as t } from "../../shared/hx-list-De66EtAP.js";
 export {
   s as HelixList,
   t as HelixListItem

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

@@ -2,6 +2,13 @@ import { HelixElement } from '../../base/index.js';
 /**
  * A visual separator for grouping items within an `hx-menu`.
  *
+ * Group 5b host-canonical: `role="separator"` lives on the **host** via
+ * `_internals.role` so the parent `<hx-menu>` (`role="menu"`) sees the
+ * separator as a direct child. `aria-orientation` is mirrored onto the host
+ * via `internals.ariaOrientation`. The inner div is presentational on the
+ * modern path and stripped of its role; the legacy fallback keeps the
+ * inner role for engines without ElementInternals IDL accessors.
+ *
  * @summary Horizontal divider between menu sections.
  *
  * @tag hx-menu-divider
@@ -12,6 +19,9 @@ import { HelixElement } from '../../base/index.js';
  */
 export declare class HelixMenuDivider extends HelixElement {
     static styles: import('lit').CSSResult[];
+    /** @internal */
+    private _supportsIdrefRefs;
+    connectedCallback(): void;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

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

@@ -1 +1 @@
-{"version":3,"file":"hx-menu-divider.d.ts","sourceRoot":"","sources":["../../../src/components/hx-menu/hx-menu-divider.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;GAUG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAAqD;IAElE,MAAM;CAQhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}
+{"version":3,"file":"hx-menu-divider.d.ts","sourceRoot":"","sources":["../../../src/components/hx-menu/hx-menu-divider.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAAqD;IAE3E,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAEzB,iBAAiB,IAAI,IAAI;IAQzB,MAAM;CAehB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}

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

@@ -1,8 +1,23 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * A single interactive item for use inside `hx-menu`. Supports normal, checkbox,
  * and radio types, loading state, prefix/suffix slots, and submenu nesting.
- * Use `aria-label` on the parent `hx-menu` to provide an accessible name.
+ *
+ * Group 5b host-canonical: `role="menuitem"` (or `menuitemcheckbox` /
+ * `menuitemradio` based on `type`) lives on the **host** via
+ * `_internals.role`. The roving tabindex is written to the host, so the host
+ * is the focusable surface and lands directly under the parent `<hx-menu>`
+ * (which carries `role="menu"`) in the AT walked tree. The inner element is
+ * presentational on the modern path — no role, no aria-* attributes — and
+ * carries only click/keyboard event handlers. Keyboard activation
+ * (Enter/Space) is owned by the host's `keydown` handler.
+ *
+ * Cross-shadow naming: consumer-supplied `aria-label` / `aria-labelledby` on
+ * the host project to `internals.ariaLabel` / `internals.ariaLabelledByElements`
+ * via the shared IDREF mirror. The slotted text content is used as the default
+ * accessible name when no override is set (AT walks slotted children
+ * automatically through the host's role).
  *
  * @summary Interactive item within an hx-menu.
  *
@@ -29,6 +44,19 @@ import { HelixElement } from '../../base/index.js';
  */
 export declare class HelixMenuItem extends HelixElement {
     static styles: import('lit').CSSResult[];
+    /**
+     * Test seam (codex push-gate round-1 finding 3 mirror of hx-select
+     * pattern): when set to `true` or `false`, overrides the platform
+     * `supportsIdrefElementReferences` probe before `connectedCallback`
+     * seeds `_supportsIdrefRefs`. Tests that need to exercise the fallback
+     * path must select it BEFORE the host connects so tabindex / role
+     * placement matches a legacy engine for the entire lifecycle.
+     *
+     * 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 Managed by parent hx-menu for roving tabindex.
      * Only the active item in the menu has tabindex=0; all others have -1.
@@ -70,13 +98,82 @@ export declare class HelixMenuItem extends HelixElement {
     private _submenuOpen;
     /** @internal */
     private _menuItemEl;
-    /** Focus the inner interactive element. */
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /**
+     * Resolved accessible name for the menu item — read by both
+     * `_syncHostAriaSemantics()` (modern path: host `internals.ariaLabel`)
+     * and the fallback `render()` branch (legacy path: inner
+     * `div[role="menuitem*"]` `aria-label`). Empty string means "no
+     * override" — slotted text content provides the implicit name through
+     * the announced surface (host on modern; inner div on fallback). AccName
+     * 1.2 §4.3.1 precedence: consumer host `aria-labelledby` (flattened) >
+     * consumer host `aria-label` > implicit slotted text.
+     * @internal
+     */
+    private _resolvedAccessibleName;
+    /**
+     * Focus the menu item. On the modern host-canonical path, focus lands on
+     * the host (which carries the roving tabindex and announced role). On the
+     * legacy fallback path, focus delegates to the inner element which still
+     * carries the role.
+     */
     focus(options?: FocusOptions): void;
     connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Apply the roving tabindex to the host (modern path) so the host is the
+     * Tab stop. Disabled items are non-tabbable.
+     *
+     * Codex push-gate round-1 finding 3: on the fallback path
+     * (`_supportsIdrefRefs === false`), the inner `.menu-item` element
+     * carries `role="menuitem"` and the roving tabindex via the template
+     * (see `render()`'s legacy branch). If we ALSO assign a non-negative
+     * tabindex to the host, the user gets two focusable surfaces per item —
+     * Tab can land on the host even though the AT-announced role/aria-* live
+     * on the inner element. The host MUST be removed from the tab order on
+     * the fallback path; the inner element is the canonical Tab stop.
+     * @internal
+     */
+    private _applyHostTabIndex;
+    /**
+     * Mirror menuitem semantics onto the host via ElementInternals. Role is
+     * derived from `type` (normal → menuitem, checkbox → menuitemcheckbox,
+     * radio → menuitemradio). aria-disabled, aria-checked, aria-haspopup,
+     * aria-expanded, and aria-busy reactively follow component state.
+     * Consumer-supplied `aria-label` / `aria-labelledby` on the host project
+     * onto `internals.ariaLabel` / `internals.ariaLabelledByElements`.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _handleSubmenuSlotChange;
     /** @internal */
     private _activate;
+    /**
+     * Origin guard for host-bound click/keydown handlers. Returns `true` only
+     * when the event originated on THIS host (its shadow tree) and not on a
+     * nested `hx-menu-item` projected into the `submenu` slot.
+     *
+     * Codex push-gate round-5 P1: nested submenu items are slotted descendants
+     * in the parent's light DOM. Click/keydown events from a Child item bubble
+     * through the parent host's listeners — without this guard, selecting Child
+     * also activates Parent (double `hx-item-select`) and Enter/Space/ArrowRight
+     * on Child re-trigger Parent's handlers (wrong-level activation, second
+     * submenu reopen).
+     *
+     * Walks `composedPath()` and returns the closest `hx-menu-item` ancestor of
+     * the original target; the event is "ours" iff that ancestor is `this`.
+     * Mirrors the inner-vs-host origin discipline used by `hx-checkbox`,
+     * `hx-switch`, and `hx-toggle-button`'s host handlers (`path[0] !== this`)
+     * but adapts for hx-menu-item's nested-host case where path[0] is the
+     * deepest inner element of a slotted child's own shadow tree.
+     * @internal
+     */
+    private _isOwnEvent;
     /** @internal */
     private _handleClick;
     /** @internal */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-menu-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-menu/hx-menu-item.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAAkD;IAExE;;;OAGG;IAEH,OAAO,CAAC,eAAe,CAAM;IAE7B,yEAAyE;IACzE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,mGAAmG;IACnG,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAInC;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,OAAO,UAAS;IAEhB;;;;OAIG;IAEH,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAY;IAEjD;;;OAGG;IAEH,OAAO,UAAS;IAEhB,gBAAgB;IAEhB,OAAO,CAAC,WAAW,CAAS;IAE5B,qEAAqE;IAErE,OAAO,CAAC,YAAY,CAAS;IAE7B,gBAAgB;IACK,OAAO,CAAC,WAAW,CAAsB;IAE9D,2CAA2C;IAClC,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAInC,iBAAiB,IAAI,IAAI;IAclC,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAKhC,gBAAgB;IAChB,OAAO,CAAC,SAAS;IA2BjB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IASpB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IA+BtB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAmB1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAmB1B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IActB,gBAAgB;IAChB,OAAO,CAAC,QAAQ;IAWP,MAAM;CAsChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}
+{"version":3,"file":"hx-menu-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-menu/hx-menu-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAAkD;IAExE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,OAAO,CAAC,eAAe,CAAM;IAE7B,yEAAyE;IACzE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKtC,mGAAmG;IACnG,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAInC;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,OAAO,UAAS;IAEhB;;;;OAIG;IAEH,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAY;IAEjD;;;OAGG;IAEH,OAAO,UAAS;IAEhB,gBAAgB;IAEhB,OAAO,CAAC,WAAW,CAAS;IAE5B,qEAAqE;IAErE,OAAO,CAAC,YAAY,CAAS;IAE7B,gBAAgB;IACK,OAAO,CAAC,WAAW,CAAsB;IAI9D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,uBAAuB,CAAM;IAErC;;;;;OAKG;IACM,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IASnC,iBAAiB,IAAI,IAAI;IAmCzB,oBAAoB,IAAI,IAAI;IAQ5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAoB/D;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IAqG9B,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAKhC,gBAAgB;IAChB,OAAO,CAAC,SAAS;IA2BjB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,WAAW;IAWnB,gBAAgB;IAChB,OAAO,CAAC,YAAY,CAWlB;IAEF,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAyCpB;IAEF,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAmB1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAmB1B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IActB,gBAAgB;IAChB,OAAO,CAAC,QAAQ;IAWP,MAAM;CA8EhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-menu-item.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-menu/hx-menu-item.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,yBA8H/B,CAAC"}
+{"version":3,"file":"hx-menu-item.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-menu/hx-menu-item.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,yBAsJ/B,CAAC"}