@helixui/library 3.3.1-next.115 → 3.3.1-next.117

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

@@ -4,6 +4,41 @@ export type DropdownPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bo
 /**
  * A dropdown component — a button that opens a floating panel on click.
  *
+ * ## Architecture Note: Host-Attribute Label Mirror (group-4 round-1)
+ *
+ * The announced surface is the inner `[part="panel"]` element, which carries
+ * `role="menu"`. The host wraps a slotted trigger and the floating panel and
+ * does NOT claim a role itself (apart from the round-35-style host
+ * `aria-expanded` fallback used only when the trigger slot is empty).
+ *
+ * Because the panel lives in shadow DOM and `ElementInternals` IDL refs on
+ * the host project semantics OUTWARD (host → AT) rather than INWARD
+ * (host → shadow descendant), we use the **host-attribute mirror** pattern:
+ * resolve consumer `aria-labelledby` IDREFs against the host's composed-tree
+ * roots, text-flatten via `flattenAccName`, and write the result to the
+ * panel's `aria-label`. Host `aria-label` outranks the `label` property in
+ * the same precedence used by every host-canonical hx-* control.
+ *
+ * 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 `"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.
+ *
+ * `aria-controls` is intentionally omitted on the trigger: the panel lives
+ * in shadow DOM and IDREF values cannot be resolved across shadow
+ * boundaries by assistive technology (axe-core flags this as a critical
+ * violation if attempted). See `_setupTriggerAria` for the inline note.
+ *
  * @summary Button that opens a floating menu panel on click.
  *
  * @tag hx-dropdown
@@ -74,6 +109,31 @@ export declare class HelixDropdown extends HelixElement {
      * @internal
      */
     private _panelVisible;
+    /**
+     * Resolved accessible name for the menu panel — the value written to the
+     * inner `[part="panel"]` `aria-label`. Recomputed on every sync per
+     * AccName 1.2 §4.3.1 precedence: host `aria-labelledby` (flattened) >
+     * host `aria-label` > `label` property > literal `"Menu"`.
+     * @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`.
+     * @internal
+     */
+    private _externalRefsObserver;
     /**
      * Guards against accumulating multiple document click listeners when open state
      * changes faster than the microtask queue can process removeEventListener calls.
@@ -127,7 +187,27 @@ export declare class HelixDropdown extends HelixElement {
     firstUpdated(): void;
     /** @internal */
     private _setupTriggerAria;
+    willUpdate(changedProperties: PropertyValues<this>): void;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * (Re-)installs a `MutationObserver` over the deduped union of
+     * consumer-resolved label elements, watching for in-place text /
+     * visibility mutations so the panel's `aria-label` tracks live consumer
+     * text. See `hx-popover._installExternalRefsObserver` for the matching
+     * shape used across the host-attribute-mirror family.
+     * @internal
+     */
+    private _installExternalRefsObserver;
+    /**
+     * Resolves the menu panel'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
+     *   4. Literal `"Menu"` (last-resort)
+     * @internal
+     */
+    private _syncResolvedLabel;
 }
 declare global {
     interface HTMLElementTagNameMap {

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;AAOnD,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,OAAO,GACP,KAAK,CAAC;AAIV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;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;;;;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;IAKzB,oBAAoB,IAAI,IAAI;IAWrC,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,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;CAchE;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":"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"}

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

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

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

@@ -13,6 +13,26 @@ import { HelixElement } from '../../base/index.js';
  * `disconnectedCallback`. This is an intentional, documented accessibility
  * mechanism.
  *
+ * **`aria-label` ownership model:** When `label` is set and no shadow `<label>`
+ * is rendered, hx-field writes `aria-label` to the slotted control and stamps
+ * a `data-hx-owns-label="true"` ownership marker.
+ *
+ * Consumers have two ways to keep their value safe from hx-field's writes:
+ *   (a) **Suspend** all ARIA bridging by setting `data-aria-managed` on the
+ *       control. While present, hx-field skips every aria-* mutation and
+ *       leaves any existing marker/snapshot in place — removing
+ *       `data-aria-managed` later may resume host ownership of an `aria-label`
+ *       value that still matches the snapshot.
+ *   (b) **Release** ownership permanently by overwriting `aria-label` to a
+ *       different value than the one hx-field last wrote. The mismatch
+ *       triggers `_releaseHostOwnedAriaLabel`, which strips the marker and
+ *       clears the snapshot, transferring ownership to the consumer.
+ *
+ * **Limitation:** because release detection is snapshot-based, a consumer
+ * rewrite to the *exact same value* hx-field last wrote is invisible. To
+ * genuinely take ownership in that case the consumer must write a different
+ * value (even briefly), or remove the `data-hx-owns-label` marker themselves.
+ *
  * @summary Layout wrapper for label, control, help text, and error message.
  *
  * @tag hx-field
@@ -150,6 +170,42 @@ export declare class HelixField extends HelixElement {
      * @internal
      */
     private _a11yDescEl;
+    /**
+     * Marker attribute placed on the slotted control whenever hx-field writes
+     * `aria-label` to it. Presence of this marker indicates host ownership of
+     * the attribute; absence means the value belongs to the consumer.
+     *
+     * Ownership is recomputed from the live DOM on every `_syncSlottedControl()`
+     * call rather than cached in a flag — this keeps post-mount mutations
+     * (consumer adds/removes `aria-label`, toggles `data-aria-managed`)
+     * authoritative instead of letting a stale snapshot win.
+     *
+     * See round-13 F2 for context on the precedence hazard.
+     * @internal
+     */
+    private static readonly _ARIA_LABEL_OWNED_ATTR;
+    /**
+     * Last `aria-label` value written by hx-field to the currently adopted
+     * control. Used in combination with the ownership marker to detect a
+     * consumer overwrite: if the marker is present but the live value no
+     * longer matches what we last wrote, the consumer has taken over and we
+     * release the marker so subsequent syncs treat the value as consumer-
+     * owned.
+     * @internal
+     */
+    private _lastWrittenAriaLabel;
+    /**
+     * Tracks whether the dev-time competing-label warning has already been
+     * emitted for the currently adopted slotted control.
+     *
+     * Latch semantics: this fires **once per adopted control**. The latch is
+     * only reset on adoption (`_resolveSlottedControl()`) or disconnection.
+     * Toggling `data-aria-managed` on/off on the same control after the
+     * warning has fired does NOT re-arm the latch — by design, to avoid
+     * console spam from consumers who toggle the attribute repeatedly.
+     * @internal
+     */
+    private _competingLabelWarned;
     connectedCallback(): void;
     disconnectedCallback(): void;
     updated(changedProps: PropertyValues<this>): void;
@@ -162,6 +218,52 @@ export declare class HelixField extends HelixElement {
     /** Tracks the first form control assigned to the default slot. */
     /** @internal */
     private _handleDefaultSlotChange;
+    /**
+     * Adopts a new slotted control and re-syncs ARIA wiring.
+     *
+     * Ownership of `aria-label` is tracked via the
+     * `data-hx-owns-label` marker attribute on the control itself, recomputed
+     * on every `_syncSlottedControl()` call — there is no cached ownership
+     * flag, so post-mount mutations of `aria-label` and `data-aria-managed`
+     * by the consumer are always honored.
+     * @internal
+     */
+    private _resolveSlottedControl;
+    /**
+     * Returns true if hx-field owns the `aria-label` on the given control —
+     * i.e. the host wrote it, the marker attribute is still present, AND the
+     * live value still matches the value the host last wrote.
+     *
+     * Side effect: when the marker is present but the value no longer matches
+     * `_lastWrittenAriaLabel`, the consumer has overwritten the host value
+     * directly. We release the marker (and reset the snapshot) so subsequent
+     * syncs treat the value as consumer-owned. This keeps the marker honest
+     * without a MutationObserver.
+     *
+     * Cross-host migration / pre-mounted marker: if the marker is present but
+     * `_lastWrittenAriaLabel === null`, this host has never written to the
+     * control. Either (a) the control was migrated from a prior hx-field that
+     * stamped the marker, or (b) a consumer pre-mounted the marker themselves.
+     * In both cases this host has no ownership claim, so we strip the orphan
+     * marker and treat the value as consumer-owned. Without this, a fresh host
+     * with `label=""` would silently strip the inherited aria-label.
+     *
+     * Note (snapshot limitation): if the consumer rewrites `aria-label` to the
+     * exact same value we last wrote, we cannot detect the overwrite — to
+     * genuinely take ownership in that case the consumer must either write a
+     * different value or remove the `data-hx-owns-label` marker themselves.
+     *
+     * Absence of the marker (or presence of `data-aria-managed`) means the
+     * consumer owns the value and hx-field must not touch it.
+     * @internal
+     */
+    private _hostOwnsAriaLabel;
+    /**
+     * Removes the host-owned `aria-label` and its ownership marker if (and only
+     * if) hx-field still owns them. Consumer-set values are left untouched.
+     * @internal
+     */
+    private _releaseHostOwnedAriaLabel;
     /**
      * Focuses the slotted form control when the shadow DOM label is clicked.
      * The shadow `<label>` cannot use `for`/`id` to link to a slotted input
@@ -182,6 +284,13 @@ export declare class HelixField extends HelixElement {
      * - `HX-*` elements manage their own ARIA attributes; bridging is skipped.
      * - Elements with `data-aria-managed` attribute opt out of ARIA mutation;
      *   bridging is skipped entirely for those elements.
+     *
+     * **Round-13 F2 ownership model:** `aria-label` ownership is recomputed
+     * from the live DOM on every call. If the marker attribute
+     * `data-hx-owns-label` is present, hx-field owns the value and may
+     * overwrite or remove it. Otherwise the consumer owns it, and hx-field
+     * leaves it alone. This makes post-mount consumer mutations
+     * (add/remove/replace) authoritative without relying on a stale flag.
      */
     /** @internal */
     private _syncSlottedControl;

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

@@ -1 +1 @@
-{"version":3,"file":"hx-field.d.ts","sourceRoot":"","sources":["../../../src/components/hx-field/hx-field.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAAsB;IAI5C;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,SAAM;IAEd;;;;OAIG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAY;IAIvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAS;IAEtC,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAkB;IAElC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAE9C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA4B;IAE5C;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAI9C;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAA4B;IAEnD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,WAAW,CAA4B;IAEtC,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAc5B,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB1D,uFAAuF;IACvF,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAazB,qFAAqF;IACrF,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAYvB,kEAAkE;IAClE,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAOhC;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB;;;;;;;;;;;;;OAaG;IACH,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IA4ClB,MAAM;CAwEhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}
+{"version":3,"file":"hx-field.d.ts","sourceRoot":"","sources":["../../../src/components/hx-field/hx-field.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAAsB;IAI5C;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,SAAM;IAEd;;;;OAIG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAY;IAIvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAS;IAEtC,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAkB;IAElC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAE9C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA4B;IAE5C;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAI9C;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAA4B;IAEnD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,WAAW,CAA4B;IAE/C;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAwB;IAEtE;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB,CAAuB;IAEpD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,qBAAqB,CAAS;IAE7B,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAiB5B,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB1D,uFAAuF;IACvF,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAazB,qFAAqF;IACrF,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAYvB,kEAAkE;IAClE,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAOhC;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAQlC;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IA2ElB,MAAM;CAwEhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as l } from "../../shared/hx-field-B3Qo8OLS.js";
+import { H as l } from "../../shared/hx-field-zw0U1KVi.js";
 export {
   l as HelixField
 };

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-CHxWY_cd.js";
 export {
   r as HelixPopover
 };

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

@@ -102,6 +102,19 @@ export declare class HelixRadioGroup extends HelixRadioGroup_base {
      * @internal
      */
     private _hasErrorSlot;
+    /**
+     * Tracks whether the help-text slot has assigned content.
+     * @internal
+     */
+    private _hasHelpSlot;
+    /**
+     * Whether the platform supports IDL element references on `ElementInternals`.
+     * Drives the render-time branch between modern (host-canonical via
+     * internals) and fallback (inner fieldset is the announced surface).
+     * Codex round-17 P1.
+     * @internal
+     */
+    private _supportsIdrefRefs;
     /**
      * Unique identifier for this radio group instance used in ARIA attributes.
      * @internal
@@ -122,9 +135,104 @@ export declare class HelixRadioGroup extends HelixRadioGroup_base {
      * @internal
      */
     private _handleErrorSlotChange;
+    /**
+     * Handles slotchange events on the help-text slot to detect assigned content.
+     * Codex aria-group-2 finding: slot-only help text was not contributing to
+     * `aria-describedby` because the wrapper was conditionally rendered on the
+     * `helpText` property alone.
+     * @internal
+     */
+    private _handleHelpSlotChange;
+    /**
+     * Watches assigned `<slot name="help-text">` nodes for in-place text
+     * mutations so the no-IDL-ref fallback `internals.ariaDescription` stays in
+     * sync when a framework rewrites `textContent` of an already-assigned node
+     * without replacing it. `slotchange` does NOT fire for those mutations, so
+     * a separate observer is required. Codex round-23 P2 (Finding C).
+     * @internal
+     */
+    private _helpSlotTextObserver;
+    /**
+     * Watches assigned `<slot name="error">` nodes for in-place text mutations
+     * so the no-IDL-ref fallback `internals.ariaDescription` stays in sync when
+     * a framework rewrites `textContent` of an already-assigned node without
+     * replacing it. Codex round-23 P2 (Finding C).
+     * @internal
+     */
+    private _errorSlotTextObserver;
+    /**
+     * (Re-)installs the mutation observer over the current set of assigned
+     * help-text-slot nodes. Codex round-23 P2 (Finding C).
+     * @internal
+     */
+    private _installHelpSlotTextObserver;
+    /**
+     * (Re-)installs the mutation observer over the current set of assigned
+     * error-slot nodes. Codex round-23 P2 (Finding C).
+     * @internal
+     */
+    private _installErrorSlotTextObserver;
+    /**
+     * Handle for the shared IDREF observer. See `installAriaIdrefMirror()`.
+     * @internal
+     */
+    private _ariaMirror;
+    /**
+     * Deferred copy of `error` driven through reactive state so the persistent
+     * live region can re-announce on transitions without direct DOM mutation.
+     * Codex round-1 finding #10.
+     * @internal
+     */
+    private _announcedError;
+    /**
+     * Tracks group-suppressed child radios so detached children can have the
+     * flag cleared. Defense-in-depth symmetry with `hx-checkbox-group` —
+     * `hx-radio` is not form-associated today, so the flag is inert, but the
+     * parity keeps the contract identical between the two group/child families
+     * for any future form-association on `hx-radio`. Codex round-3 finding #1.
+     * @internal
+     */
+    private _suppressedChildren;
+    /**
+     * Snapshot of children captured before each `slotchange` so removed
+     * children can be released from suppression (WeakSet is non-enumerable).
+     * @internal
+     */
+    private _previousRadios;
+    /**
+     * Last value of `aria-labelledby` we wrote to the host. Used to distinguish
+     * external (consumer) attribute mutations from our own internal augmentation
+     * writes when refreshing the host-attribute fallback. Codex round-10 P2:
+     * without this guard, an internal mutation observer fire would re-read the
+     * already-augmented host attribute as if it were consumer-supplied, causing
+     * legend/help/error ids to leak forward as "consumer tokens" forever.
+     * @internal
+     */
+    private _lastWrittenLabelledBy;
+    /** @internal — see `_lastWrittenLabelledBy`. */
+    private _lastWrittenDescribedBy;
+    /**
+     * Most recently observed *consumer-supplied* `aria-labelledby` baseline (the
+     * set of tokens the consumer themselves wrote on the host). Refreshed only
+     * when the host attribute changes via an external write — internal writes
+     * leave the baseline untouched.
+     * @internal
+     */
+    private _consumerLabelledBy;
+    /** @internal — see `_consumerLabelledBy`. */
+    private _consumerDescribedBy;
     connectedCallback(): void;
     disconnectedCallback(): void;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Mirrors radiogroup semantics onto the host via ElementInternals so that
+     * consumer-supplied `aria-label`, `aria-labelledby`, and `aria-describedby`
+     * on `<hx-radio-group>` reach the announced control. The codex aria-group-2
+     * finding identified that the inner `<fieldset>` was the announced node and
+     * the host's external IDREF tokens could not cross the shadow boundary.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     firstUpdated(changedProperties: PropertyValues<this>): void;
     /**
      * Cached list of child hx-radio elements; invalidated on slot change.
@@ -162,10 +270,53 @@ export declare class HelixRadioGroup extends HelixRadioGroup_base {
      */
     private _handleKeydown;
     /**
-     * Handles slotchange events on the default slot to refresh the radio cache.
+     * Handles slotchange events on the default slot. Refreshes the cached
+     * radio list, reconciles `value`/`setFormValue`/validity against the new
+     * children, then re-tunes the per-child disabled observer so in-place
+     * `radio.disabled = true` mutations trigger the same reconcile pass.
+     *
+     * Codex round-2 finding #3: previously this handler only invalidated the
+     * cache and re-synced child state, so removing the currently-selected
+     * radio (or disabling it, or adding a new `checked` radio) left
+     * `this.value` and the submitted form value pointing at stale state and
+     * `_updateValidity` was never re-run.
+     *
+     * Codex round-7 finding #6: an in-place `selectedRadio.disabled = true`
+     * never re-entered this reconciler (the radio remained slotted), so the
+     * group could keep submitting a disabled value and stay valid until some
+     * unrelated slot mutation kicked things over. The per-child observer
+     * installed at the end of this method re-runs the same reconcile logic on
+     * every `disabled` attribute mutation.
      * @internal
      */
     private _handleSlotChange;
+    /**
+     * Per-child `disabled` attribute observer. Mirrors the slotchange
+     * reconcile pipeline so an in-place `radio.disabled = true` collapses the
+     * group's `value`/form participation/validity. Round-7 finding #6.
+     *
+     * One observer is shared across all currently-slotted radios; it is
+     * disconnected and re-attached on every slotchange so children that have
+     * left the group stop firing reconcile passes.
+     * @internal
+     */
+    private _childDisabledObserver;
+    /**
+     * Re-runs the slotchange reconcile pass without touching the disabled
+     * observer wiring. Called from the slotchange handler and from the
+     * per-child disabled observer; factored out so both entry points share
+     * the same value/formValue/validity reconciliation path. Round-7 #6.
+     * @internal
+     */
+    private _reconcileChildren;
+    /**
+     * Installs (or re-installs) a single MutationObserver across the current
+     * set of slotted `<hx-radio>` children, listening for `disabled` attribute
+     * mutations. Round-7 finding #6: in-place `disabled = true` never reaches
+     * the slotchange-driven reconciler otherwise.
+     * @internal
+     */
+    private _installChildDisabledObservers;
     /**
      * Updates the ElementInternals validity state based on the required constraint and current value.
      * @internal

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

@@ -1 +1 @@
-{"version":3,"file":"hx-radio-group.d.ts","sourceRoot":"","sources":["../../../src/components/hx-radio-group/hx-radio-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAQpE,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBACa,eAAgB,SAAQ,oBAAuB;IAC1D,OAAgB,MAAM,4BAA8C;IAIpE;;;OAGG;IACH,OAAgB,cAAc,UAAQ;IAItC;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,SAAM;IAEd;;;OAGG;IAEH,WAAW,EAAE,UAAU,GAAG,YAAY,CAAc;IAEpD;;;OAGG;IACH,OAAO,KAAK,QAAQ,GAEnB;IAED;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAIvC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAuB;IACvC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAC9C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA4B;IAI5C;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAOrB,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAwBtD,YAAY,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAgBpE;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA6B;IAClD;;;OAGG;IACH,OAAO,CAAC,yBAAyB,CAAsC;IAEvE;;;OAGG;IACH,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA0CnB;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAwBxB;IAEF;;;OAGG;IACH,OAAO,CAAC,cAAc,CA+DpB;IAEF;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;IACM,eAAe,IAAI,IAAI;IAYhC,gBAAgB;cACG,YAAY,IAAI,IAAI;IAOvC,gBAAgB;cACG,mBAAmB,CACpC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,EACtC,KAAK,EAAE,SAAS,GAAG,cAAc,GAChC,IAAI;IAMP,gBAAgB;cACG,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAMlD,MAAM;CAmEhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF;AAED,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC"}
+{"version":3,"file":"hx-radio-group.d.ts","sourceRoot":"","sources":["../../../src/components/hx-radio-group/hx-radio-group.ts"],"names":[],"mappings":"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"}

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

@@ -42,6 +42,20 @@ export declare class HelixRadio extends HelixElement {
      * @attr checked
      */
     checked: boolean;
+    /**
+     * Set by `hx-radio-group` to mark this child as group-managed. `hx-radio` is
+     * not form-associated (the group is the sole form participant), so this
+     * flag is currently inert on this element. It exists for symmetry with
+     * `hx-checkbox._groupedSuppress` so the group/child contract is identical
+     * across both selection-control families and any future form-association
+     * change on `hx-radio` is automatically suppressed inside a group. Codex
+     * round-3 finding #1 (defense-in-depth).
+     * @internal
+     */
+    set _groupedSuppress(value: boolean);
+    get _groupedSuppress(): boolean;
+    /** @internal */
+    private __groupedSuppress;
     connectedCallback(): void;
     updated(changedProperties: PropertyValues<this>): void;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"hx-radio.d.ts","sourceRoot":"","sources":["../../../src/components/hx-radio-group/hx-radio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAAyC;IAI/D;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,OAAO,UAAS;IAIP,iBAAiB,IAAI,IAAI;IAWzB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAW/D;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,cAAc;IAQtB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAkB;IAIlC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAqBX,MAAM;CA2BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF;AAED,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC"}
+{"version":3,"file":"hx-radio.d.ts","sourceRoot":"","sources":["../../../src/components/hx-radio-group/hx-radio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAAyC;IAI/D;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,OAAO,UAAS;IAEhB;;;;;;;;;OASG;IACH,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAElC;IACD,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IACD,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAAS;IAIzB,iBAAiB,IAAI,IAAI;IAWzB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAW/D;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,cAAc;IAQtB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAkB;IAIlC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAqBX,MAAM;CA2BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF;AAED,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC"}

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

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