@helixui/library 3.3.1 → 3.4.0-next.121

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-Z1lV1zTO.js";
 export {
   i as HelixRadio,
   e as HelixRadioGroup

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

@@ -32,6 +32,7 @@ declare const HelixSelect_base: typeof HelixElement & (new (...args: any[]) => i
  * @slot help-text - Custom help text content (overrides the helpText property).
  *
  * @fires {CustomEvent<{value: string}>} hx-change - Dispatched when the selected option changes.
+ * @fires {Event} invalid - Platform constraint-validation event fired when checkValidity() / reportValidity() determine the value is invalid (form-associated component contract via ElementInternals.setValidity).
  *
  * @csspart field - The outer field container.
  * @csspart label - The label element.
@@ -102,9 +103,22 @@ declare const HelixSelect_base: typeof HelixElement & (new (...args: any[]) => i
  * @cssprop [--hx-font-size-xs] - Font size.
  */
 export declare class HelixSelect extends HelixSelect_base {
-    static styles: import('lit').CSSResult[];
+    static styles: import('lit').CSSResult;
     /** Marks this element as form-associated for ElementInternals support. @internal */
     static formAssociated: boolean;
+    /**
+     * Test seam (round-3 finding 4): when set to `true` or `false`, overrides
+     * the platform `supportsIdrefElementReferences` probe before
+     * `connectedCallback` seeds `_supportsIdrefRefs`. Mid-life flag flips on a
+     * connected instance allowed stale modern internals (set during connect)
+     * to leak into the fallback branch — tests must select the path BEFORE
+     * the host connects so the synthetic environment matches a legacy engine.
+     *
+     * Production code MUST NOT touch this field. It is a `static` so the test
+     * stub cleanup is global and obvious.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
     /** @internal */
     private _selectId;
     /** @internal */
@@ -192,16 +206,258 @@ export declare class HelixSelect extends HelixSelect_base {
     private _options;
     /** Whether the named error slot contains projected content. @internal */
     private _hasErrorSlot;
+    /**
+     * Whether the named label slot contributes a useful name. Round-3 finding 3:
+     * the previous boolean tracked `assignedNodes().length > 0`, which is `true`
+     * for whitespace-only slot content. That suppressed the unlabeled devWarn
+     * even when the slot only carried a stray newline. This flag now requires
+     * either a labellable element OR non-empty trimmed text content.
+     * @internal
+     */
+    private _hasLabelSlot;
+    /**
+     * Source of the accessible name. Round-3 finding 8 replaces the magic
+     * sentinel `'*slotted*'` with a discriminated union so a future caller
+     * setting `label="*slotted*"` literally cannot be confused with a slotted
+     * label.
+     * @internal
+     */
+    private _labelSource;
+    /**
+     * Flattened, trimmed text content of any text nodes in the label slot —
+     * used to drive `internals.ariaLabel` when the consumer projects only a
+     * text node (no element to add to `labelEls`). Round-3 finding 3.
+     * @internal
+     */
+    private _labelSlotText;
+    /** Whether the help-text slot contains projected content. @internal */
+    private _hasHelpSlot;
+    /**
+     * Direct reference to the first labellable element projected into the
+     * `<slot name="label">`. Round-3 finding 5 replaces the previous round-trip
+     * through `document.getElementById(this._slottedLabelId)` so we no longer
+     * mutate consumer light-DOM (assigning ids) and the lookup is robust under
+     * nested shadow roots (round-3 finding 6).
+     * @internal
+     */
+    private _slottedLabelEl;
     /** Zero-based index of the keyboard-focused option in the listbox; -1 means none. @internal */
     private _focusedOptionIndex;
+    /**
+     * Whether the platform supports IDL element references on `ElementInternals`.
+     * Drives the cross-shadow naming strategy: modern path uses
+     * `internals.ariaLabelledByElements` / `internals.ariaDescribedByElements`
+     * to bridge consumer light-DOM IDREFs into the host accessible node;
+     * fallback path mirrors the consumer's `aria-labelledby` / `aria-describedby`
+     * tokens onto host attributes and text-mirrors shadow help/error wrappers
+     * via `internals.ariaDescription`.
+     *
+     * ARCHITECTURE — Round-3 host-canonical (overturns scope doc Path A).
+     * Codex round-2 finding 1 demonstrated that the dual-channel approach
+     * (host roleless on modern, host-announced on fallback) creates a "named
+     * surface ≠ focused surface" gap on legacy engines. Round-3 commits to a
+     * single canonical surface — the HOST — on BOTH paths:
+     *
+     * - `internals.role = 'combobox'` on both paths (and `role="combobox"`
+     *   attribute mirror so CSS / `getAttribute` / AT inspecting the DOM see it).
+     * - `tabindex="0"` on the host (so it is the focusable surface).
+     * - Click + keydown listeners on the host (so user input lands on the
+     *   announced surface).
+     * - `focus()` routes to the host (so programmatic focus matches AT focus).
+     * - `setValidity()` anchor = host (so UA validation UI routes to the
+     *   focusable announced surface).
+     * - Inner trigger drops `role`, `tabindex`, and the combobox ARIA mirror
+     *   on both paths so AT does not see a doubled accessible.
+     *
+     * This matches Group 2's host-canonical pattern (PR #1625, validated for
+     * `hx-radio-group` and `hx-checkbox-group`). The scope doc's APG concern
+     * about doubled comboboxes is moot once the inner role is dropped.
+     * @internal
+     */
+    private _supportsIdrefRefs;
+    /**
+     * Deferred copy of `error` driven through reactive state so the persistent
+     * live region can re-announce on transitions without direct DOM mutation.
+     * Aligned with Group 2 round-1 finding #10.
+     * @internal
+     */
+    private _announcedError;
+    /**
+     * Cached invalidity flag derived from `internals.validity.valid` after the
+     * latest `setValidity()` call. Both the modern (`internals.ariaInvalid`)
+     * and fallback (host attribute) writes read from the same source so they
+     * cannot disagree. Round-2 finding 2.
+     * @internal
+     */
+    private _invalid;
     /** Reference to the hidden native select element used for form participation. @internal */
     private _select;
     /** Reference to the visible combobox trigger element that receives keyboard focus. @internal */
     private _trigger;
     /** @internal */
     private get _displayValue();
+    /**
+     * Handle for the shared IDREF observer. See `installAriaIdrefMirror()`.
+     * @internal
+     */
+    private _ariaMirror;
+    /**
+     * Watches assigned `<slot name="help-text">` nodes for in-place text
+     * mutations so the no-IDL-ref fallback `internals.ariaDescription` stays in
+     * sync. Aligned with Group 2 round-23 P2 (Finding C).
+     * @internal
+     */
+    private _helpSlotTextObserver;
+    /**
+     * Watches assigned `<slot name="error">` nodes for in-place text mutations.
+     * Aligned with Group 2 round-23 P2 (Finding C).
+     * @internal
+     */
+    private _errorSlotTextObserver;
+    /**
+     * Round-10 finding 1 (supersedes round-8 counter): dedicated host observer
+     * scoped to `aria-describedby` with `attributeOldValue: true`. The fallback
+     * path strips the host `aria-describedby` attribute on every sync (per
+     * round-6 single-channel design). Once stripped, a subsequent consumer
+     * `removeAttribute('aria-describedby')` causes NO DOM mutation (the
+     * attribute is already absent), so the post-sync `getAttribute()` baseline
+     * diff at the top of `_syncHostAriaSemantics` cannot detect the retraction
+     * — `_consumerDescribedBy` would remain pinned to the originally-cached
+     * string forever and the consumer's external help text would keep
+     * concatenating into `internals.ariaDescription` indefinitely.
+     *
+     * Round-10 architectural lockdown (`.reports/aria-group-3-architecture-
+     * decision-r10.md` section 7.1): the observer is governed by the
+     * **disconnect-during-strip** discipline. Before the fallback strip
+     * `removeAttribute('aria-describedby')` runs, this observer is
+     * `disconnect()`ed; immediately after the strip, it is re-`observe()`d.
+     * Self-mutations are therefore never delivered to the callback, so the
+     * observer only sees consumer-driven mutations. This eliminates the
+     * round-8 pending-strip counter / discriminator entirely and the lockstep
+     * invariant it depended on.
+     *
+     * The observer detects `oldValue !== null && newValue === null`
+     * (consumer authentically retracted the attribute) and clears
+     * `_consumerDescribedBy`. Framework-batched attach-then-detach (Vue /
+     * React / Lit reconciliation flipping `aria-describedby` from a string to
+     * null in one render commit) produces two records in the same callback
+     * batch — the second record's `oldValue` is observable. The bare
+     * `removeAttribute` no-op on an already-absent attribute is unobservable
+     * by design (a null → null DOM operation is not a mutation); see
+     * `hx-select.test.ts` round-10 contract block for the three documented
+     * retraction sequences.
+     *
+     * @internal
+     */
+    private _hostDescribedByObserver;
+    /**
+     * Last value of `aria-labelledby` we wrote to the host. Used to distinguish
+     * external (consumer) attribute mutations from our own internal augmentation
+     * writes. Aligned with Group 2 round-10 P2.
+     * @internal
+     */
+    private _lastWrittenLabelledBy;
+    /** @internal — see `_lastWrittenLabelledBy`. */
+    private _lastWrittenDescribedBy;
+    /**
+     * Last value of `aria-label` we wrote to the host. Used to distinguish
+     * external (consumer) attribute mutations from our own internal mirror
+     * writes on the fallback path. Round-5 finding 1: without this snapshot
+     * the round-3 fallback `aria-label` mirror was self-sealing — sync N
+     * wrote `aria-label="Country"`, sync N+1 read that same string back via
+     * `getAttribute('aria-label')` and treated it as a consumer override,
+     * caching it into `internals.ariaLabel` and short-circuiting
+     * `_writeHostAttributeMirror`. Subsequent label/accessibleLabel/slot
+     * mutations never propagated.
+     * @internal
+     */
+    private _lastWrittenAriaLabel;
+    /**
+     * Most recently observed *consumer-supplied* `aria-labelledby` baseline.
+     * Refreshed only when the host attribute changes via an external write —
+     * internal writes leave the baseline untouched. Cached so consumer tokens
+     * can replay if their target element later attaches to the DOM.
+     * @internal
+     */
+    private _consumerLabelledBy;
+    /** @internal — see `_consumerLabelledBy`. */
+    private _consumerDescribedBy;
+    connectedCallback(): void;
     disconnectedCallback(): void;
     updated(changedProperties: PropertyValues<this>): void;
+    firstUpdated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Reads the label slot's assigned nodes and computes the discriminated
+     * naming state. Round-3 finding 3 + 5 + 8: an empty whitespace-only slot
+     * does NOT count as a useful name; the first labellable element is
+     * captured by reference (no consumer-DOM mutation); the result drives a
+     * discriminated `_labelSource` rather than a magic `'*slotted*'` string.
+     * @internal
+     */
+    private _readLabelSlotState;
+    /**
+     * Mirrors combobox semantics onto the host via ElementInternals so that the
+     * host IS the canonical announced surface on BOTH the modern (IDL element
+     * references) and fallback paths. Round-3 finding 1: codex round-2
+     * demonstrated that putting `role="combobox"` on the host on fallback while
+     * leaving focus/click/keyboard/validity anchored to the inner trigger
+     * created a "named surface ≠ focused surface" gap. Round-3 collapses both
+     * paths to the host-canonical model used by Group 2's `hx-radio-group` /
+     * `hx-checkbox-group` (PR #1625):
+     *
+     * - `internals.role = 'combobox'` so AT advertises the combobox role.
+     * - Host attribute `role="combobox"` mirror so legacy engines, axe-core,
+     *   and `getAttribute('role')` agree with the internals default.
+     * - Host attribute `tabindex="0"` so the host is the focusable surface.
+     * - Host attributes `aria-expanded`, `aria-haspopup`, `aria-controls`,
+     *   `aria-activedescendant`, `aria-required`, `aria-invalid`,
+     *   `aria-disabled` so AT walking the host's attribute graph sees the
+     *   combobox state without depending on internals defaults.
+     * - Modern path additionally sets `internals.ariaLabelledByElements` /
+     *   `internals.ariaDescribedByElements` so consumer light-DOM IDREFs cross
+     *   the shadow boundary into the host's accessible node.
+     * - Fallback path mirrors consumer label/desc tokens onto the host
+     *   attribute and text-mirrors shadow help/error wrappers via
+     *   `internals.ariaDescription`.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
+    /**
+     * Writes host `role="combobox"` and `tabindex` so the host is the
+     * focusable, AT-visible canonical surface. Round-3 finding 1.
+     * @internal
+     */
+    private _writeHostRoleAndTabindex;
+    /**
+     * Writes the host's combobox state attributes (`aria-expanded`,
+     * `aria-haspopup`, `aria-controls`, `aria-activedescendant`,
+     * `aria-required`, `aria-invalid`, `aria-disabled`) on every sync. CSS
+     * selectors and AT inspecting the live attribute graph read these — the
+     * `internals.aria*` defaults are invisible. Round-3 finding 1.
+     * @internal
+     */
+    private _writeHostComboboxStateAttributes;
+    /**
+     * Writes a host `aria-label` attribute mirror on the fallback path so AT
+     * inspecting the live attribute graph sees the resolved name even when
+     * the platform lacks IDL element references. Skip when an effective
+     * `aria-labelledby` is already set on the host (labelledby > label by
+     * ARIA priority). Round-3 finding 1 + round-2 finding 5.
+     * @internal
+     */
+    private _writeHostAttributeMirror;
+    /**
+     * (Re-)installs the mutation observer over the current set of assigned
+     * help-text-slot nodes. Aligned with Group 2 round-23 P2 (Finding C).
+     * @internal
+     */
+    private _installHelpSlotTextObserver;
+    /**
+     * (Re-)installs the mutation observer over the current set of assigned
+     * error-slot nodes. Aligned with Group 2 round-23 P2 (Finding C).
+     * @internal
+     */
+    private _installErrorSlotTextObserver;
     /** @internal */
     private _updateFormValue;
     /** @internal */
@@ -220,10 +476,51 @@ export declare class HelixSelect extends HelixSelect_base {
      */
     /** @internal */
     private _handleSlotChange;
+    /**
+     * Tracks the slotted label so projected `<span slot="label">` content joins
+     * the accessible-name chain without forcing the consumer to also pass the
+     * `label` property.
+     *
+     * Round-3 findings 3, 5, 6, 8:
+     * - 3: count whitespace-only text as "no useful name" (devWarn must fire).
+     * - 5: hold the slotted element by direct reference instead of mutating
+     *   consumer light DOM with a tracked id.
+     * - 6: lookup is by reference, so it survives nested shadow roots without
+     *   the fragile `getElementById` chain.
+     * - 8: discriminated `_labelSource` replaces the magic `'*slotted*'`
+     *   sentinel string.
+     * @internal
+     */
+    private _handleLabelSlotChange;
+    /**
+     * Recomputes the discriminated label source. Round-3 finding 8.
+     *
+     * CodeRabbit F2: slotted label wins over the `label` prop. When a
+     * consumer provides BOTH a `<span slot="label">` AND a `label="..."`
+     * attribute the visible label is the slotted node (rendered by the
+     * named slot's default content branch never firing). Preferring the
+     * string form here would route the accessible name through the prop
+     * and diverge from the rendered text. The slot is the canonical
+     * source whenever it has useful content.
+     * @internal
+     */
+    private _refreshLabelSource;
     /** @internal */
     private _handleErrorSlotChange;
     /** @internal */
+    private _handleHelpSlotChange;
+    /** @internal */
     private _toggleDropdown;
+    /**
+     * Click handler attached to the host. Round-3 finding 1: the host is the
+     * canonical combobox surface, so user input listeners live here. Clicks
+     * inside the open listbox are handled by the per-option `@click` binding
+     * in `_renderOptions()` and stop here only if `composedPath` indicates
+     * the original click target was the open listbox panel (so option clicks
+     * don't double-toggle the dropdown).
+     * @internal
+     */
+    private _handleHostClick;
     /** @internal */
     private _handleKeydown;
     /** @internal */
@@ -234,7 +531,12 @@ export declare class HelixSelect extends HelixSelect_base {
     private _handleNativeChange;
     /** @internal */
     private _handleOutsideClick;
-    /** Moves focus to the visible trigger button. */
+    /**
+     * Moves focus to the host. Round-3 finding 1: the host is the canonical
+     * combobox surface (`role="combobox"`, `tabindex="0"`), so programmatic
+     * focus must land there to match where AT routes focus and where
+     * `setValidity()` anchors recovery.
+     */
     focus(options?: FocusOptions): void;
     /** @internal */
     private _optionId;

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"hx-select.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-select/hx-select.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,yBAsX7B,CAAC"}
+{"version":3,"file":"hx-select.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-select/hx-select.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,yBAyY7B,CAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"hx-nav-item.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-side-nav/hx-nav-item.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,yBA6S9B,CAAC"}
+{"version":3,"file":"hx-nav-item.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-side-nav/hx-nav-item.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,yBAiT9B,CAAC"}

package/dist/components/hx-side-nav/index.js

@@ -1,4 +1,4 @@
-import { H as i, a as x } from "../../shared/hx-nav-item-xqRPOCWX.js";
+import { H as i, a as x } from "../../shared/hx-nav-item-CODtUlew.js";
 export {
   i as HelixNavItem,
   x as HelixSideNav

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

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

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

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