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

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-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-BdgoUeWi.js";
 export {
   x as HelixCheckbox
 };

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

@@ -38,7 +38,8 @@ declare const HelixCheckboxGroup_base: typeof HelixElement & (new (...args: any[
  *   {% endfor %}
  * </hx-checkbox-group>
  * ```
- * The `name` attribute propagates automatically to child checkboxes — no Drupal behavior required.
+ * The group is the sole form participant — children are suppressed via
+ * `_groupedSuppress`. Setting `name` on a child has no effect inside a group.
  * @cssprop [--hx-opacity-disabled] - Opacity.
  * @cssprop [--hx-space-2] - Spacing token.
  * @cssprop [--hx-checkbox-group-font-family=var(--hx-font-family-sans)] - CSS custom property.
@@ -100,6 +101,16 @@ export declare class HelixCheckboxGroup extends HelixCheckboxGroup_base {
     private _hasErrorSlot;
     /** Whether the named help-text slot contains projected content. @internal */
     private _hasHelpSlot;
+    /** Whether the named label slot contains projected content. @internal */
+    private _hasLabelSlot;
+    /**
+     * 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;
     /** @internal */
     private _groupId;
     /** @internal */
@@ -107,12 +118,106 @@ export declare class HelixCheckboxGroup extends HelixCheckboxGroup_base {
     /** @internal */
     private _errorId;
     /** @internal */
+    private _labelId;
+    /** @internal */
     private _handleErrorSlotChange;
     /** @internal */
     private _handleHelpSlotChange;
+    /** @internal */
+    private _handleLabelSlotChange;
+    /**
+     * Watches assigned `<slot name="label">` nodes for in-place text mutations
+     * so the no-IDL-ref fallback `internals.ariaLabel` 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-21 P3 (mirrors the
+     * `hx-toggle-button` pattern from round-13 P2).
+     * @internal
+     */
+    private _labelSlotTextObserver;
+    /**
+     * (Re-)installs the mutation observer over the current set of assigned
+     * label-slot nodes. Disconnects any prior observer first so detached nodes
+     * stop firing into a torn-down host. Codex round-21 P3.
+     * @internal
+     */
+    private _installLabelSlotTextObserver;
+    /**
+     * 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 B) — mirrors
+     * the round-21 P3 label-slot observer pattern.
+     * @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 B).
+     * @internal
+     */
+    private _errorSlotTextObserver;
+    /**
+     * (Re-)installs the mutation observer over the current set of assigned
+     * help-text-slot nodes. Codex round-23 P2 (Finding B).
+     * @internal
+     */
+    private _installHelpSlotTextObserver;
+    /**
+     * (Re-)installs the mutation observer over the current set of assigned
+     * error-slot nodes. Codex round-23 P2 (Finding B).
+     * @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;
+    /**
+     * 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 group semantics onto the host via ElementInternals so that
+     * consumer-supplied `aria-label`, `aria-labelledby`, and `aria-describedby`
+     * on `<hx-checkbox-group>` reach the announced control. Without host-level
+     * semantics, the announced node is the shadow `<fieldset>`, which is
+     * unreachable from light-DOM IDREFs.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     firstUpdated(changedProperties: PropertyValues<this>): void;
     /** @internal */
     private _getCheckboxes;
@@ -120,8 +225,52 @@ export declare class HelixCheckboxGroup extends HelixCheckboxGroup_base {
     private _getCheckedValues;
     /** @internal */
     private _syncCheckboxes;
-    /** @internal */
+    /**
+     * Tracks the set of checkboxes most recently flagged with
+     * `_groupedSuppress = true` so a child removed from the group can have its
+     * suppression cleared and regain stand-alone form participation. Codex
+     * round-3 finding #1.
+     * @internal
+     */
+    private _suppressedChildren;
+    /**
+     * Centralizes form participation on the group: when an `hx-checkbox` is
+     * grouped, the group is the sole form participant. Without this, both the
+     * group AND each child would call `setFormValue` for the same name, causing
+     * every checked value to submit twice.
+     *
+     * Codex round-2 finding #1 used `cb.name = ''` as the suppression signal.
+     * Codex round-3 finding #1 hardened that: a consumer (or framework binding)
+     * that re-set `cb.name = 'foo'` after attach regained form participation
+     * because the child's `name` setter re-armed `_updateFormValue()` while no
+     * `slotchange` re-fired to re-null the name.
+     *
+     * The fix is a durable, name-independent kill switch — `_groupedSuppress` —
+     * on each child. While the flag is set the child's `_updateFormValue()`
+     * short-circuits to `setFormValue(null)` regardless of its `name` value.
+     * Children removed from the group have the flag cleared so they regain
+     * stand-alone form participation.
+     * @internal
+     */
     private _syncCheckboxNames;
+    /**
+     * Clears `_groupedSuppress` on any checkbox that was previously in this
+     * group but has since been removed (re-parented or detached). Called from
+     * `_handleSlotChange()` after `_syncCheckboxNames()` re-applies the flag
+     * to current children.
+     *
+     * `previousChildren` is a snapshot captured before slot mutation; any child
+     * in that set but not in the current set has left the group and must have
+     * its suppression cleared so stand-alone use restores form participation.
+     * @internal
+     */
+    private _clearSuppressionForRemoved;
+    /**
+     * Snapshot of children captured before each `slotchange` so removed children
+     * can be detected (WeakSet is non-enumerable).
+     * @internal
+     */
+    private _previousChildren;
     /** @internal */
     private _handleCheckboxChange;
     /** @internal */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-checkbox-group.d.ts","sourceRoot":"","sources":["../../../src/components/hx-checkbox-group/hx-checkbox-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AASpE,sEAAsE;AACtE,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,qBACa,kBAAmB,SAAQ,uBAAuB;IAC7D,OAAgB,MAAM,4BAAiD;IAIvE,oFAAoF;IACpF,OAAgB,cAAc,UAAQ;IAItC;;;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;IACH,IACI,WAAW,IAAI,UAAU,GAAG,YAAY,CAE3C;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,EAM5B;IACD,gBAAgB;IAChB,OAAO,CAAC,YAAY,CAAyC;IAE7D,yEAAyE;IAChE,OAAO,CAAC,aAAa,CAAS;IACvC,6EAA6E;IACpE,OAAO,CAAC,YAAY,CAAS;IAItC,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAA0B;IAC1C,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA2B;IAC9C,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAA4B;IAI5C,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAOpB,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAuBtD,YAAY,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAWpE,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAItB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAMzB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAOvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAU1B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB,CAuB3B;IAEF,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAUzB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB,gBAAgB;IACP,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAcjD,gBAAgB;cACG,YAAY,IAAI,IAAI;IAUvC,gBAAgB;cACG,mBAAmB,CACpC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,EACtC,KAAK,EAAE,SAAS,GAAG,cAAc,GAChC,IAAI;IAWP,gBAAgB;cACG,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAMlD,MAAM;CA+ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,kBAAkB,CAAC;KACzC;CACF"}
+{"version":3,"file":"hx-checkbox-group.d.ts","sourceRoot":"","sources":["../../../src/components/hx-checkbox-group/hx-checkbox-group.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { H as r } from "../../shared/hx-checkbox-group-C9n315Ju.js";
+import { H as r } from "../../shared/hx-checkbox-group-LWezHrvS.js";
 export {
   r as HelixCheckboxGroup
 };