@helixui/library 3.3.1 → 3.4.0-next.123

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

@@ -7,6 +7,41 @@ export interface HxAccordionToggleDetail {
 /**
  * An individual accordion item with collapsible content.
  *
+ * ## Architecture Note: Slot Projection vs. Host-Canonical (group-4 round-1)
+ *
+ * `hx-accordion-item` deliberately does NOT participate in the
+ * host-canonical / `internals.ariaLabelledByElements` pattern used by every
+ * other group-2/3/4 component. Rationale:
+ *
+ *   1. The trigger label comes from `<slot name="trigger">` — consumer
+ *      light-DOM projected directly into the `<summary>` element. AT reads
+ *      the slot-projected text natively because slot projection preserves
+ *      accessible name (the `<summary>` IS the heading and consumes the
+ *      slotted text in its own accessible name computation).
+ *   2. `aria-labelledby="${_uid}-trigger"` on the inner content region and
+ *      `aria-controls="${_uid}-content"` on the summary BOTH resolve
+ *      same-shadow-root, which works correctly across every AT — these
+ *      IDREFs never cross a shadow boundary.
+ *   3. Pushing these ids through `internals.ariaLabelledByElements` would
+ *      either duplicate the wiring (heading announced twice) or break the
+ *      native `<details>/<summary>` toggle semantics (the host carrying
+ *      `role="heading"` would shadow the summary's own heading projection).
+ *
+ * `role="heading"` on `<summary>` (with `aria-level=N`) is the APG-canonical
+ * Accordion pattern. Per the APG note, `<summary>` MUST be a direct child
+ * of `<details>` for the native toggle to function — wrapping it in an
+ * `<h3>` would forfeit native disclosure. The role-on-summary approach is
+ * the authoritative compromise. NVDA, JAWS, and VoiceOver all announce the
+ * summary as a heading at the configured level when this pattern is used.
+ *
+ * `aria-controls` on the summary points at the shadow-internal content
+ * region; APG marks the relationship as implicit via the heading + region
+ * structure, so AT not following the IDREF still announces correctly. The
+ * IDREF is a hint, not a requirement — and because both ids are in the
+ * same shadow root, it resolves cleanly when AT does follow it. This
+ * matches the popover/dropdown intentional `aria-controls` omission for
+ * the cross-shadow case (see those components' code comments).
+ *
  * @summary Collapsible panel that can be expanded or collapsed.
  *
  * @tag hx-accordion-item

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

@@ -1 +1 @@
-{"version":3,"file":"hx-accordion-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-accordion/hx-accordion-item.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAwBpE,mFAAmF;AACnF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBACa,kBAAmB,SAAQ,YAAY;IAClD,OAAgB,MAAM,4BAAuD;IAE7E,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAA0B;IAEtC;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;;OAKG;IAEH,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAK;IAIxB,iBAAiB,IAAI,IAAI;IAYlC,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAahC;;;;;;;OAOG;IACH,gBAAgB;IAChB,OAAO,KAAK,aAAa,GAExB;IAID,gBAAgB;IAChB,OAAO,CAAC,OAAO;IASf,gBAAgB;IAChB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAiB7C,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAK3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IASb,MAAM;CA0ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,kBAAkB,CAAC;KACzC;CACF"}
+{"version":3,"file":"hx-accordion-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-accordion/hx-accordion-item.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAwBpE,mFAAmF;AACnF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,qBACa,kBAAmB,SAAQ,YAAY;IAClD,OAAgB,MAAM,4BAAuD;IAE7E,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAA0B;IAEtC;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;;OAKG;IAEH,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAK;IAIxB,iBAAiB,IAAI,IAAI;IAYlC,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAahC;;;;;;;OAOG;IACH,gBAAgB;IAChB,OAAO,KAAK,aAAa,GAExB;IAID,gBAAgB;IAChB,OAAO,CAAC,OAAO;IASf,gBAAgB;IAChB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAiB7C,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAK3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IASb,MAAM;CA0ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,kBAAkB,CAAC;KACzC;CACF"}

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

@@ -141,6 +141,17 @@ export declare class HelixAlert extends HelixElement {
     private _actionsSlotChangeHandler;
     /** @internal */
     private _titleSlotChangeHandler;
+    /**
+     * (group-6 §5.4) Race-guard counter for the sr-only announcer microtask
+     * dance. Each open=false→true transition increments this; the deferred
+     * text-clear + re-inject only writes to the announcer when the counter
+     * matches the value captured at scheduling time. Rapid open/close cycles
+     * therefore collapse to a single announcement on the final settled state
+     * rather than leaking stale text from earlier cycles.
+     *
+     * @internal
+     */
+    private _announcerCycle;
     /** @internal */
     private _defaultSeverityLabel;
     /** @internal */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-alert.d.ts","sourceRoot":"","sources":["../../../src/components/hx-alert/hx-alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAA2C;IAIjE;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAU;IAE3D;;;OAGG;IAEH,WAAW,UAAS;IAEpB;;;;;OAKG;IAEH,OAAO,SAAM;IAEb;;;OAGG;IACqC,UAAU,SAAiB;IAEnE;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,MAAM,UAAS;IAEf;;;;OAIG;IAEH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC;;;;;OAKG;IAEH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAIpC,gBAAgB;IAEhB,OAAO,CAAC,WAAW,CAAS;IAE5B,gBAAgB;IAEhB,OAAO,CAAC,SAAS,CAAS;IAI1B,gBAAgB;IAChB,OAAO,CAAC,yBAAyB,CAA6B;IAC9D,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAA6B;IAI5D,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAU7B,gBAAgB;IAChB,OAAO,KAAK,uBAAuB,GAElC;IAED,qEAAqE;IACrE,gBAAgB;IAChB,OAAO,KAAK,YAAY,GAEvB;IAED;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAIQ,iBAAiB,IAAI,IAAI;IAWzB,oBAAoB,IAAI,IAAI;IAY5B,YAAY,IAAI,IAAI;cAoBV,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA6CzE,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAQxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAqCb,MAAM;CAuDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF;AAED,YAAY,EAAE,UAAU,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"hx-alert.d.ts","sourceRoot":"","sources":["../../../src/components/hx-alert/hx-alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAA2C;IAIjE;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAU;IAE3D;;;OAGG;IAEH,WAAW,UAAS;IAEpB;;;;;OAKG;IAEH,OAAO,SAAM;IAEb;;;OAGG;IACqC,UAAU,SAAiB;IAEnE;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,MAAM,UAAS;IAEf;;;;OAIG;IAEH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC;;;;;OAKG;IAEH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAIpC,gBAAgB;IAEhB,OAAO,CAAC,WAAW,CAAS;IAE5B,gBAAgB;IAEhB,OAAO,CAAC,SAAS,CAAS;IAI1B,gBAAgB;IAChB,OAAO,CAAC,yBAAyB,CAA6B;IAC9D,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAA6B;IAE5D;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe,CAAK;IAI5B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAU7B,gBAAgB;IAChB,OAAO,KAAK,uBAAuB,GAElC;IAED,qEAAqE;IACrE,gBAAgB;IAChB,OAAO,KAAK,YAAY,GAEvB;IAED;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAIQ,iBAAiB,IAAI,IAAI;IAmBzB,oBAAoB,IAAI,IAAI;IAY5B,YAAY,IAAI,IAAI;cAoBV,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAyDzE,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAQxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAqCb,MAAM;CA+EhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF;AAED,YAAY,EAAE,UAAU,IAAI,OAAO,EAAE,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-alert.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-alert/hx-alert.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,yBA2O5B,CAAC"}
+{"version":3,"file":"hx-alert.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-alert/hx-alert.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,yBAoP5B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as l } from "../../shared/hx-alert-CLn7CstP.js";
+import { H as l } from "../../shared/hx-alert-Bto8-TIi.js";
 export {
   l as HelixAlert
 };

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

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

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

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-badge-CQXgOXJM.js";
+import { H as o } from "../../shared/hx-badge-JlFtAdxS.js";
 export {
   o as HelixBadge
 };

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

@@ -120,7 +120,15 @@ export declare class HelixBanner extends HelixElement {
     private _defaultSeverityLabel;
     /** Returns the effective severity label, using the override if provided. */
     private get _effectiveSeverityLabel();
-    /** Returns true when the variant requires assertive announcement. */
+    /**
+     * Returns true when the variant requires assertive announcement.
+     *
+     * (group-6) Harmonized with `hx-alert` and `hx-toast`: only `error` is
+     * assertive. Previous behavior also escalated `warning` to assertive on
+     * `hx-banner`, which diverged from the rest of the live-region surface.
+     * Warnings are non-urgent and use a polite live region (role="status").
+     * Critical/error messages remain assertive (role="alert").
+     */
     /** @internal */
     private get _isAssertive();
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"hx-banner.d.ts","sourceRoot":"","sources":["../../../src/components/hx-banner/hx-banner.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,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,qBACa,WAAY,SAAQ,YAAY;IAC3C,OAAgB,MAAM,4BAA4C;IAIlE;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAU;IAE3D;;;OAGG;IAEH,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAY;IAExC;;;OAGG;IAEH,WAAW,UAAS;IAEpB;;;;OAIG;IAEH,OAAO,SAAM;IAEb;;;OAGG;IAEH,WAAW,SAAM;IAEjB;;;OAGG;IAEH,UAAU,SAAM;IAEhB;;;OAGG;IAEH,IAAI,UAAQ;IAEZ,4EAA4E;IAE5E,UAAU,SAAoB;IAE9B;;;;OAIG;IAEH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAIlC,0EAA0E;IAC1E,OAAO,CAAC,qBAAqB;IAU7B,4EAA4E;IAC5E,OAAO,KAAK,uBAAuB,GAElC;IAED,qEAAqE;IACrE,gBAAgB;IAChB,OAAO,KAAK,YAAY,GAEvB;IAED;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAIQ,iBAAiB,IAAI,IAAI;cAWf,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAoBzE,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAQxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAkBb,MAAM;CAkDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF;AAED,YAAY,EAAE,WAAW,IAAI,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"hx-banner.d.ts","sourceRoot":"","sources":["../../../src/components/hx-banner/hx-banner.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,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAoBhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,qBACa,WAAY,SAAQ,YAAY;IAC3C,OAAgB,MAAM,4BAA4C;IAIlE;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAU;IAE3D;;;OAGG;IAEH,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAY;IAExC;;;OAGG;IAEH,WAAW,UAAS;IAEpB;;;;OAIG;IAEH,OAAO,SAAM;IAEb;;;OAGG;IAEH,WAAW,SAAM;IAEjB;;;OAGG;IAEH,UAAU,SAAM;IAEhB;;;OAGG;IAEH,IAAI,UAAQ;IAEZ,4EAA4E;IAE5E,UAAU,SAAoB;IAE9B;;;;OAIG;IAEH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAIlC,0EAA0E;IAC1E,OAAO,CAAC,qBAAqB;IAU7B,4EAA4E;IAC5E,OAAO,KAAK,uBAAuB,GAElC;IAED;;;;;;;;OAQG;IACH,gBAAgB;IAChB,OAAO,KAAK,YAAY,GAEvB;IAED;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAIQ,iBAAiB,IAAI,IAAI;cAkBf,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAqBzE,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAQxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAkBb,MAAM;CAkDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF;AAED,YAAY,EAAE,WAAW,IAAI,QAAQ,EAAE,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as a } from "../../shared/hx-banner-D3DzpfcP.js";
+import { H as a } from "../../shared/hx-banner-fpRnciIO.js";
 export {
   a as HelixBanner
 };

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

@@ -153,7 +153,17 @@ export declare class HelixButton extends HelixButton_base {
     accessibleLabel: string;
     /**
      * Returns the effective label for the button, checking accessible-label first,
-     * then the aria-label attribute, falling back to empty string.
+     * then the consumer-set aria-label attribute (read via data-aria-label which
+     * mixinDelegatesAria writes when consumers set the host's `aria-label`),
+     * then the still-pending `aria-label` attribute (in case the mixin has not
+     * yet processed it), falling back to empty string.
+     *
+     * HX-015 migration: never read `this.ariaLabel` (the native HTMLElement IDL
+     * property). The mixin overrides `ariaLabel` to read `data-aria-label` in
+     * modern browsers, but the IDL fallback path breaks in fallback browsers and
+     * confuses consumers who follow the v3 upgrade guide. Read the attribute
+     * storage directly so the source-of-truth is unambiguous.
+     *
      * @internal
      */
     private get _effectiveLabel();

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

@@ -1 +1 @@
-{"version":3,"file":"hx-button.d.ts","sourceRoot":"","sources":["../../../src/components/hx-button/hx-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC9E,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,UAAU,CAAC;CAC3B;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,qBACa,WAAY,SAAQ,gBAAgC;IAM/D,OAAgB,MAAM,4BAAuB;IAI7C,gBAAgB;IAChB,OAAgB,cAAc,UAAQ;IAItC;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAa;IAE3F;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAY;IAE/C;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAa;IAEvC;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;OAIG;IAEH,IAAI,UAAS;IAEb;;;;;;;;;;;;;;OAcG;IAEH,QAAQ,UAAS;IAEjB;;;;;;;;OAQG;IAEH,eAAe,EAAE,MAAM,CAAM;IAE7B;;;;OAIG;IACH,OAAO,KAAK,eAAe,GAE1B;cAIkB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAM3D,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAO5B;IAGX,OAAO,CAAC,qBAAqB,CAAS;IAE7B,YAAY,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAe3D,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAgB/D,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAoBhC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAgCpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA6BtB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAiBX,MAAM;CAyChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;IACD,UAAU,mBAAmB;QAC3B,UAAU,EAAE,WAAW,CAAC;YAAE,aAAa,EAAE,UAAU,CAAA;SAAE,CAAC,CAAC;KACxD;CACF"}
+{"version":3,"file":"hx-button.d.ts","sourceRoot":"","sources":["../../../src/components/hx-button/hx-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC9E,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,UAAU,CAAC;CAC3B;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,qBACa,WAAY,SAAQ,gBAAgC;IAM/D,OAAgB,MAAM,4BAAuB;IAI7C,gBAAgB;IAChB,OAAgB,cAAc,UAAQ;IAItC;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAa;IAE3F;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAY;IAE/C;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAa;IAEvC;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;OAIG;IAEH,IAAI,UAAS;IAEb;;;;;;;;;;;;;;OAcG;IAEH,QAAQ,UAAS;IAEjB;;;;;;;;OAQG;IAEH,eAAe,EAAE,MAAM,CAAM;IAE7B;;;;;;;;;;;;;;OAcG;IACH,OAAO,KAAK,eAAe,GAO1B;cAIkB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAM3D,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAO5B;IAGX,OAAO,CAAC,qBAAqB,CAAS;IAE7B,YAAY,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAe3D,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAgB/D,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAoBhC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAgCpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA6BtB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAiBX,MAAM;CAoEhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;IACD,UAAU,mBAAmB;QAC3B,UAAU,EAAE,WAAW,CAAC;YAAE,aAAa,EAAE,UAAU,CAAA;SAAE,CAAC,CAAC;KACxD;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-button-DPY6SPVT.js";
+import { H as e } from "../../shared/hx-button-BOwAEcF1.js";
 export {
   e as HelixButton
 };

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

@@ -47,6 +47,28 @@ export declare class HelixButtonGroup extends HelixElement {
      * @attr label
      */
     label: string;
+    /**
+     * Tracks whether the consumer set `aria-label` directly as an HTML attribute
+     * BEFORE the `label` property fired. Used to avoid clobbering consumer-set
+     * aria-label when `label` is empty.
+     * @internal
+     */
+    private _consumerAriaLabel;
+    /**
+     * Snapshot of the consumer-set `role` attribute taken at connect time.
+     * When non-null, the consumer has explicitly set a role (e.g. `toolbar`,
+     * `radiogroup`) and the host-canonical mirror MUST defer to that role
+     * rather than overwriting `internals.role` with the default `"group"`.
+     * Mirrors the `_consumerAriaLabel` snapshot pattern above.
+     * @internal
+     */
+    private _consumerRole;
+    /**
+     * Tracks whether the no-label devWarn has already fired for this instance,
+     * so disconnect/reconnect cycles do not spam the console.
+     * @internal
+     */
+    private _emptyLabelWarnEmitted;
     updated(changedProperties: PropertyValues<this>): void;
     connectedCallback(): void;
     render(): import('lit').TemplateResult<1>;

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

@@ -1 +1 @@
-{"version":3,"file":"hx-button-group.d.ts","sourceRoot":"","sources":["../../../src/components/hx-button-group/hx-button-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAAqD;IAE3E;;;OAGG;IACH,IACI,WAAW,IAAI,YAAY,GAAG,UAAU,CAE3C;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,EAM5B;IACD;;;OAGG;IACH,OAAO,CAAC,YAAY,CAA2C;IAE/D;;;;OAIG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;;;;OAMG;IAEH,KAAK,EAAE,MAAM,CAAM;IAIV,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAgBtD,iBAAiB,IAAI,IAAI;IAgBzB,MAAM;CAchB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}
+{"version":3,"file":"hx-button-group.d.ts","sourceRoot":"","sources":["../../../src/components/hx-button-group/hx-button-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,OAAgB,MAAM,4BAAqD;IAE3E;;;OAGG;IACH,IACI,WAAW,IAAI,YAAY,GAAG,UAAU,CAE3C;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,EAM5B;IACD;;;OAGG;IACH,OAAO,CAAC,YAAY,CAA2C;IAE/D;;;;OAIG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;;;;OAMG;IAEH,KAAK,EAAE,MAAM,CAAM;IAInB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAAuB;IAEjD;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa,CAAuB;IAE5C;;;;OAIG;IACH,OAAO,CAAC,sBAAsB,CAAS;IAE9B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAsBtD,iBAAiB,IAAI,IAAI;IA0CzB,MAAM;CAchB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as t } from "../../shared/hx-button-group-BI-QBqmO.js";
+import { H as t } from "../../shared/hx-button-group-4NUBpkyC.js";
 export {
   t as HelixButtonGroup
 };

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

@@ -7,6 +7,25 @@ import { HelixElement } from '../../base/index.js';
  *
  * @tag hx-card
  *
+ * Group 10 host-canonical: when a card carries an accessible name (consumer
+ * `aria-label` / `aria-labelledby`, the `hx-label` property, or slotted
+ * heading text on the interactive variant) the announced role is written
+ * to the host via `_internals.role`. The mapping is:
+ *   - `hx-href` set         -> host role="link" + tabindex="0"
+ *   - non-interactive named -> host role="region"
+ *   - non-interactive plain -> no host role (generic container)
+ *
+ * `delegatesFocus: true` is preserved so that focusable descendants
+ * slotted inside the card still receive Tab focus first; the host itself
+ * is only focusable when it carries `role="link"`.
+ *
+ * On the legacy fallback path (engines without IDL element-references on
+ * `ElementInternals`) the inner `[part="card"]` element keeps the role +
+ * tabindex + aria-label so a single announced surface remains, and the
+ * host writes are suppressed to avoid a duplicate-treeitem-style
+ * problem. The resolved accessible name is mirrored onto the inner
+ * element via `aria-label` for parity with the modern path.
+ *
  * @slot image - Optional image or media content at the top of the card.
  * @slot heading - The card heading/title content. Use a semantic heading element (h2, h3, etc.) for proper accessibility.
  * @slot - Default slot for the card body content.
@@ -69,6 +88,18 @@ export declare class HelixCard extends HelixElement {
         slotAssignment?: SlotAssignmentMode;
     };
     static styles: import('lit').CSSResult[];
+    /**
+     * Test seam (codex push-gate round-1 lift): when set to `true` or
+     * `false`, overrides the platform `supportsIdrefElementReferences`
+     * probe before `connectedCallback` seeds `_supportsIdrefRefs`. Mirrors
+     * the hx-menu-item / hx-tree-item / hx-select seam — required so tests
+     * can deterministically exercise the legacy fallback render branch.
+     *
+     * Production code MUST NOT touch this field. It is `static` so the
+     * test stub cleanup is global and obvious.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
     /**
      * Visual style variant of the card.
      * @attr variant
@@ -130,6 +161,25 @@ export declare class HelixCard extends HelixElement {
      */
     private _headingId;
     /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /**
+     * Resolved accessible name for the card — read by both
+     * `_syncHostAriaSemantics()` (modern path: host `internals.ariaLabel`)
+     * and the fallback `render()` branch (legacy path: inner
+     * `[part="card"]` `aria-label`). Empty string means "no override" —
+     * for the interactive variant slotted heading text 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` > component `hx-label`
+     * property > implicit slotted heading text.
+     * @internal
+     */
+    private _resolvedAccessibleName;
+    /** @internal */
     private _onImageSlotChange;
     /** @internal */
     private _onHeadingSlotChange;
@@ -137,7 +187,25 @@ export declare class HelixCard extends HelixElement {
     private _onFooterSlotChange;
     /** @internal */
     private _onActionsSlotChange;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Mirror card semantics onto the host via ElementInternals so
+     * consumer-supplied `aria-label` / `aria-labelledby` reaches the
+     * announced surface and the role honours the link / region / generic
+     * mapping.
+     *
+     * Suppression rule: on the legacy fallback path the inner
+     * `[part="card"]` element already exposes role + aria-label via the
+     * template. Writing the same fields on the host's ElementInternals
+     * would surface TWO announced controls for one logical card, so all
+     * host writes are cleared on the fallback path; the inner element is
+     * the canonical announced surface and `_resolvedAccessibleName` is
+     * mirrored onto it via the render branch.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _dispatchCardClick;
     /** @internal */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-card.d.ts","sourceRoot":"","sources":["../../../src/components/hx-card/hx-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAOpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,gBAAgB;IAChB,OAAgB,iBAAiB;;;;;;;MAG/B;IAEF,OAAgB,MAAM,4BAA0C;IAEhE;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAa;IAExD;;;OAGG;IAEH,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAU;IAEnD;;;;;OAKG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;;;OAKG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAItC;;;OAGG;IACM,OAAO,CAAC,SAAS,CAAS;IAEnC;;;OAGG;IACM,OAAO,CAAC,WAAW,CAAS;IAErC;;;OAGG;IACM,OAAO,CAAC,UAAU,CAAS;IAEpC;;;OAGG;IACM,OAAO,CAAC,WAAW,CAAS;IAErC;;;;OAIG;IACM,OAAO,CAAC,YAAY,CAAM;IAEnC;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,UAAU,CAA6B;IAE/C,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAK1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAU5B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAK3B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAanB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB/D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAiB1B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAIpB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAab,MAAM;CAgDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}
+{"version":3,"file":"hx-card.d.ts","sourceRoot":"","sources":["../../../src/components/hx-card/hx-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAcpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,gBAAgB;IAChB,OAAgB,iBAAiB;;;;;;;MAG/B;IAEF,OAAgB,MAAM,4BAA0C;IAEhE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAa;IAExD;;;OAGG;IAEH,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAU;IAEnD;;;;;OAKG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;;;OAKG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAItC;;;OAGG;IACM,OAAO,CAAC,SAAS,CAAS;IAEnC;;;OAGG;IACM,OAAO,CAAC,WAAW,CAAS;IAErC;;;OAGG;IACM,OAAO,CAAC,UAAU,CAAS;IAEpC;;;OAGG;IACM,OAAO,CAAC,WAAW,CAAS;IAErC;;;;OAIG;IACM,OAAO,CAAC,YAAY,CAAM;IAEnC;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,UAAU,CAA6B;IAI/C,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAQ;IAElC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,uBAAuB,CAAM;IAErC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAK1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAc5B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAK3B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAenB,iBAAiB,IAAI,IAAI;IA6BzB,oBAAoB,IAAI,IAAI;IAQ5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAmB/D;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,sBAAsB;IA2H9B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAiB1B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAIpB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAab,MAAM;CA4EhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-card.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-card/hx-card.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,yBAwL3B,CAAC"}
+{"version":3,"file":"hx-card.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-card/hx-card.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,yBAqM3B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-card-qNAM2QNV.js";
+import { H as e } from "../../shared/hx-card-CswtnYvj.js";
 export {
   e as HelixCard
 };

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

@@ -151,6 +151,28 @@ export declare class HelixCheckbox extends HelixCheckbox_base {
     private _inputEl;
     /** @internal */
     private _hasErrorSlot;
+    /** @internal */
+    private _hasHelpTextSlot;
+    /** @internal */
+    private _hasLabelSlot;
+    /**
+     * Set by `hx-checkbox-group` to mark this child as group-managed. While
+     * truthy, `_updateFormValue()` short-circuits to `setFormValue(null)`
+     * regardless of `name`, so the child does NOT participate in form submission
+     * — only the group does. This is durable against post-attach mutations to
+     * `cb.name` by consumers/frameworks (which would otherwise re-arm
+     * `_updateFormValue()` via the `name` setter and cause double-submission).
+     * Codex round-3 finding #1.
+     *
+     * Public via accessor for the group's exclusive use; the underscore prefix
+     * marks it as group-internal (not consumer API). The group sets it during
+     * `slotchange` and clears it (via the same setter) when a child is removed.
+     * @internal
+     */
+    set _groupedSuppress(value: boolean);
+    get _groupedSuppress(): boolean;
+    /** @internal */
+    private __groupedSuppress;
     /**
      * Deferred copy of this.error used inside the live region. Injected after
      * the region is visible (via requestAnimationFrame) so screen readers
@@ -161,8 +183,38 @@ export declare class HelixCheckbox extends HelixCheckbox_base {
     private _announcedError;
     /** @internal */
     private _hasWarnedLabelConflict;
+    /**
+     * Handle for the shared IDREF observer. Installed in `connectedCallback()`
+     * so late-mutated `aria-labelledby`/`aria-describedby` and late-inserted
+     * IDREF targets are picked up. See `installAriaIdrefMirror()`.
+     * @internal
+     */
+    private _ariaMirror;
     /** @internal */
     private _handleErrorSlotChange;
+    /** @internal */
+    private _handleHelpTextSlotChange;
+    /** @internal */
+    private _handleLabelSlotChange;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Host-level keydown handler. Space toggles per ARIA APG checkbox pattern
+     * — but only on the modern path where the host is the announced focus
+     * surface. On the no-IDL-ref fallback (round-2 finding #2), the inner
+     * `<input>` owns focus + native Space activation, so the host stays out
+     * of the activation pipeline to avoid double-toggle.
+     * @internal
+     */
+    private _handleHostKeyDown;
+    /**
+     * Host-level click handler. Routes clicks on the host (e.g. via assistive
+     * tech activation) to the change handler — only on the modern path. On the
+     * fallback path the inner input is the announced surface and natively
+     * receives clicks/AT activation.
+     * @internal
+     */
+    private _handleHostClick;
     updated(changedProperties: PropertyValues<this>): void;
     /** Returns the associated form element, if any. */
     get form(): HTMLFormElement | null;
@@ -175,12 +227,112 @@ export declare class HelixCheckbox extends HelixCheckbox_base {
     protected _onFormReset(): void;
     protected _onFormStateRestore(state: File | string | FormData | null, _mode: 'restore' | 'autocomplete'): void;
     protected _onFormDisabled(disabled: boolean): void;
+    /**
+     * Writes the checkbox value to ElementInternals' form value. Suppressed when
+     * the checkbox is grouped — `hx-checkbox-group` flips `_groupedSuppress` on
+     * children so the group is the sole form participant.
+     *
+     * Codex round-3 finding #1: round-2 used `cb.name = ''` as the suppression
+     * signal, but a consumer (or framework binding) that re-set `cb.name = 'foo'`
+     * after attach regained form participation through the `name` setter. The
+     * `_groupedSuppress` flag is a durable, name-independent kill switch.
+     * Stand-alone checkboxes (no parent group) are unaffected.
+     * @internal
+     */
+    private _updateFormValue;
     /** @internal */
     private _handleChange;
+    /**
+     * Handles native `change` events from the inner `<input type=checkbox>` on
+     * the no-IDL-ref fallback path. On that path the inner input is the
+     * announced surface (no `aria-hidden`, `tabindex=0`) and AT activates it
+     * directly — pointer/keyboard activation flips `input.checked` natively.
+     * We mirror the input's state onto the host, dispatch `hx-change`, and
+     * update form participation.
+     *
+     * Codex round-3 finding #2: round-2 left the inner input click suppressed
+     * on both paths, so on no-IDL-ref browsers AT activation could not toggle
+     * the control. The fix is to NOT suppress click on the fallback path and
+     * to honor the resulting `change` event here.
+     * @internal
+     */
+    private _handleInternalChange;
     /** @internal */
     private _handleKeyDown;
-    /** Moves focus to the checkbox input element. */
+    /**
+     * Stable inner-input click suppressor for the modern (announced-host) path.
+     * Hoisted to a class field so Lit sees a stable listener identity across
+     * renders; previously inline arrows were re-allocated each render and
+     * caused listener detach/re-attach churn (codex round-4 F3 — performance).
+     * @internal
+     */
+    private _suppressInnerClick;
+    /**
+     * Stable inner-input change suppressor for the modern (announced-host) path.
+     * Mirrors the click suppressor above — stable identity across renders so
+     * Lit's event-listener cache keeps a single registration (codex round-4 F3).
+     * @internal
+     */
+    private _suppressInnerChange;
+    /**
+     * Moves focus to the announced checkbox surface. Codex round-1 finding #1
+     * relocated the focus target from the inner `<input>` to the host on
+     * modern engines so AT only sees one announced widget. Round-7 finding #3
+     * extends that contract to the no-IDL-ref fallback: when the host is
+     * demoted (`tabindex=-1`, role/state cleared on `internals`) the inner
+     * `<input>` owns the announced semantics and tab order, so programmatic
+     * `focus()` must redirect there — otherwise scripted focus and error
+     * recovery land on the demoted host on unsupported engines.
+     */
     focus(options?: FocusOptions): void;
+    /**
+     * Mirrors checkbox semantics onto the host via ElementInternals so that
+     * consumer-supplied `aria-label`, `aria-labelledby`, and `aria-describedby`
+     * on `<hx-checkbox>` reach the announced control. Without this, those
+     * attributes — intercepted by `mixinDelegatesAria` and stored on the host —
+     * would not propagate through to the inner shadow `<input>`.
+     *
+     * Codex finding (aria-delegation, severity high): the announced semantic
+     * node was the inner `<input>` and the host's labelled-by tokens could not
+     * cross the shadow boundary.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
+    /**
+     * Fallback `aria-labelledby` token list applied to the inner input on
+     * browsers that lack IDL element references. Tracked as a reactive state
+     * so the value flows through the next `render()` call.
+     * @internal
+     */
+    private _fallbackAriaLabelledBy;
+    /**
+     * Fallback `aria-describedby` token list applied to the inner input on
+     * browsers that lack IDL element references.
+     * @internal
+     */
+    private _fallbackAriaDescribedBy;
+    /**
+     * Whether the platform supports IDL element references on `ElementInternals`.
+     * Drives the render-time branch between the modern path (host is the
+     * announced surface, inner input is `aria-hidden + tabindex=-1`) and the
+     * fallback path (inner input is the announced surface, host is demoted).
+     *
+     * Round-2 finding #2: the previous fallback mirrored `aria-labelledby` /
+     * `aria-describedby` onto an `aria-hidden` inner input, leaving older
+     * browsers with no accessible name. The fallback now keeps the inner input
+     * in the a11y tree so AT can name and activate it natively.
+     * @internal
+     */
+    private _supportsIdrefRefs;
+    /**
+     * Tracks whether the host's `tabindex` is managed by the component itself
+     * (vs. set explicitly by a consumer). Codex round-14 P2: a consumer-supplied
+     * `tabindex` (e.g. roving-tabindex toolbar pattern with `tabindex="-1"`)
+     * must survive disabled flips and re-renders. Only re-assert tabindex in
+     * `updated()` when the component originally claimed it.
+     * @internal
+     */
+    private _internalTabindexManaged;
     /** @internal */
     private _id;
     /** @internal */

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { H as x } from "../../shared/hx-checkbox-D7xma9YH.js";
+import { H as x } from "../../shared/hx-checkbox-CYd0YV_u.js";
 export {
   x as HelixCheckbox
 };