@helixui/library 3.3.0 → 3.3.1-next.117

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
 };

package/dist/components/hx-color-picker/hx-color-picker.d.ts

@@ -16,6 +16,9 @@ declare const HelixColorPicker_base: typeof HelixElement & (new (...args: any[])
  * @tag hx-color-picker
  *
  * @slot trigger - Custom trigger element. Default: a color swatch button.
+ * @slot label - Visible label projected above the trigger; aggregated text contributes to the host's accessible name when no stronger naming source (aria-labelledby/aria-label/accessible-label/label) is supplied.
+ * @slot help-text - Help text rendered below the trigger and joined into the host's announced description channel.
+ * @slot error - Error message rendered below help text. When present, marks the trigger as aria-invalid and is announced via a polite live region.
  *
  * @fires {CustomEvent<{value: string}>} hx-input - Dispatched while dragging sliders or grid.
  * @fires {CustomEvent<{value: string}>} hx-change - Dispatched when a color is committed.
@@ -27,6 +30,9 @@ declare const HelixColorPicker_base: typeof HelixElement & (new (...args: any[])
  * @csspart hue-slider - The hue slider track.
  * @csspart opacity-slider - The alpha/opacity slider track.
  * @csspart input - The text input area.
+ * @csspart label - The visible label container above the trigger.
+ * @csspart help-text - The help-text container rendered below the trigger.
+ * @csspart error - The error-message container rendered below help text.
  *
  * @cssprop [--hx-color-picker-z-index=1000] - z-index of the popover panel.
  * @cssprop [--hx-color-picker-width=260px] - Width of the picker panel.
@@ -162,7 +168,34 @@ export declare class HelixColorPicker extends HelixColorPicker_base {
     /** Accessible label for the color picker dialog/panel. */
     labelPicker: string;
     /**
-     * Generates the accessible label for the trigger button.
+     * Visible label rendered above the trigger. When set this becomes the
+     * announced name of the trigger surface unless a stronger source
+     * (`aria-labelledby`, `aria-label`, or `accessible-label`) is supplied.
+     * @attr label
+     */
+    label: string | undefined;
+    /**
+     * Visually-hidden accessible name. Highest-priority self-naming source —
+     * outranks `label`, slotted label content, and the generated trigger label,
+     * but defers to consumer `aria-labelledby` (effective) and `aria-label`.
+     * @attr accessible-label
+     */
+    accessibleLabel: string | undefined;
+    /**
+     * Help text rendered below the trigger and joined into the host's
+     * announced description channel.
+     * @attr help-text
+     */
+    helpText: string | undefined;
+    /**
+     * Error message. When non-empty, marks the trigger surface as `aria-invalid`
+     * and joins the host's announced description channel via a live alert.
+     * @attr error
+     */
+    error: string | undefined;
+    /**
+     * Generates the accessible label for the trigger button when no other
+     * naming source is provided.
      * @param color - current color value string
      */
     labelTrigger: (color: string) => string;
@@ -181,6 +214,55 @@ export declare class HelixColorPicker extends HelixColorPicker_base {
      * @internal
      */
     private _inputValue;
+    /**
+     * Whether the platform supports the IDL element-references API on
+     * `ElementInternals` (`ariaLabelledByElements` / `ariaDescribedByElements`).
+     * Drives the modern (host-canonical) vs. fallback (mirror onto trigger)
+     * branches in `_syncHostAriaSemantics()`.
+     * @internal
+     */
+    private _supportsIdrefRefs;
+    /**
+     * Test seam for forcing the no-IDL-ref path in synthetic environments.
+     * Production code MUST NOT touch this. `null` = use platform detection;
+     * `true`/`false` = force the corresponding branch on connect.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
+    /** Slotted label elements (multi-node aggregation). @internal */
+    private _slottedLabelEls;
+    /** Aggregated text from slotted label, AccName-flattened. @internal */
+    private _labelSlotText;
+    /** True when the label slot carries useful text. @internal */
+    private _hasLabelSlot;
+    /** Aggregated text from slotted help-text, AccName-flattened. @internal */
+    private _helpSlotText;
+    /** Aggregated text from slotted error, AccName-flattened. @internal */
+    private _errorSlotText;
+    /** Effective error text exposed in the live region. @internal */
+    private _announcedError;
+    /** Stable IDs for inner help / error elements. @internal */
+    private readonly _instanceId;
+    /** @internal */ private readonly _helpId;
+    /** @internal */ private readonly _errorId;
+    /** Hidden host-level description span ID (synthesized aria-description channel). @internal */
+    private readonly _hostDescId;
+    /** Fallback aria-* for the trigger button when IDL refs are unsupported. @internal */
+    private _fallbackTriggerAriaLabelledBy;
+    /** @internal */ private _fallbackTriggerAriaDescribedBy;
+    /** @internal */ private _fallbackTriggerAriaLabel;
+    /** Cached resolved external description text for the synthesized host span. @internal */
+    private _externalDescText;
+    /** Handle for the shared IDREF observer. @internal */
+    private _ariaMirror;
+    /** Mutation observer over the label-slot assigned-node text. @internal */
+    private _labelSlotTextObserver;
+    /** Mutation observer over the help-slot assigned-node text. @internal */
+    private _helpSlotTextObserver;
+    /** Mutation observer over the error-slot assigned-node text. @internal */
+    private _errorSlotTextObserver;
+    /** Mutation observer over external aria-labelledby / aria-describedby targets. @internal */
+    private _externalRefsObserver;
     /** Cached reference to the gradient grid element. @internal */
     private _gridEl;
     /** Cached reference to the hue slider element. @internal */
@@ -225,8 +307,72 @@ export declare class HelixColorPicker extends HelixColorPicker_base {
     connectedCallback(): void;
     disconnectedCallback(): void;
     willUpdate(changedProperties: PropertyValues<this>): void;
+    firstUpdated(changedProperties: PropertyValues<this>): void;
+    updated(changedProperties: PropertyValues<this>): void;
     /** @internal */
     private _syncFromValue;
+    /**
+     * Synchronous slot-state seed. Mirrors the side effects of the slotchange
+     * handlers but is driven by direct `slot.assignedNodes()` reads so we can
+     * populate state BEFORE the microtask `slotchange` events fire after the
+     * first render.
+     * @internal
+     */
+    private _seedSlotStateSync;
+    /** @internal */
+    private _captureLabelSlot;
+    /** @internal */
+    private _captureHelpSlot;
+    /** @internal */
+    private _captureErrorSlot;
+    /** @internal */
+    private _handleLabelSlotChange;
+    /** @internal */
+    private _handleHelpSlotChange;
+    /** @internal */
+    private _handleErrorSlotChange;
+    /** @internal */
+    private _installLabelSlotTextObserver;
+    /** @internal */
+    private _installHelpSlotTextObserver;
+    /** @internal */
+    private _installErrorSlotTextObserver;
+    /**
+     * Watches the elements referenced by `aria-labelledby` / `aria-describedby`
+     * for in-place text mutations so the announced name/description stays
+     * accurate when consumers rewrite external label text without swapping the
+     * referenced node.
+     * @internal
+     */
+    private _installExternalRefsObserver;
+    /**
+     * Compute and apply the cross-shadow ARIA contract for the trigger surface.
+     *
+     * Naming precedence (highest first):
+     *   1. consumer `aria-labelledby` (when at least one IDREF resolves)
+     *   2. consumer `aria-label`
+     *   3. `accessible-label` property
+     *   4. `label` property
+     *   5. slotted `<slot name="label">` text
+     *   6. `labelTrigger(value)` (default)
+     *
+     * Description channel (joined, deduped):
+     *   - consumer `aria-describedby` resolved text
+     *   - `help-text` property + slotted help-text
+     *   - `error` property + slotted error (when present)
+     *
+     * Modern path (`_supportsIdrefRefs === true`): host owns the announced
+     * surface via `internals.aria*` + IDL refs. Trigger button mirrors only.
+     *
+     * Fallback path (`_supportsIdrefRefs === false`): trigger button carries
+     * the full aria contract via attribute mirrors.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
+    /** @internal */
+    private _effectiveHelpText;
+    /** @internal */
+    private _effectiveErrorText;
     /** @internal */
     protected _onFormDisabled(disabled: boolean): void;
     /** @internal */
@@ -293,6 +439,22 @@ export declare class HelixColorPicker extends HelixColorPicker_base {
     private _renderInput;
     /** @internal */
     private _renderPanel;
+    /**
+     * Builds the synthesized host-level description span text by joining the
+     * external (consumer-resolved) description text with help and error text.
+     * The hidden span lives in the shadow root so AT can resolve a single
+     * `aria-describedby` token to it without leaving the host's name surface.
+     * @internal
+     */
+    private _hostDescriptionText;
+    /** @internal */
+    private _renderHostDescriptionSpan;
+    /** @internal */
+    private _renderLabelSlot;
+    /** @internal */
+    private _renderHelpSlot;
+    /** @internal */
+    private _renderErrorSlot;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

package/dist/components/hx-color-picker/hx-color-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-color-picker.d.ts","sourceRoot":"","sources":["../../../src/components/hx-color-picker/hx-color-picker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hx-color-picker.d.ts","sourceRoot":"","sources":["../../../src/components/hx-color-picker/hx-color-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcnD,OAAO,EACL,KAAK,WAAW,EAMjB,MAAM,kBAAkB,CAAC;AAM1B,YAAY,EAAE,WAAW,EAAE,CAAC;AAI5B,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AACH,qBACa,gBAAiB,SAAQ,qBAAuB;IAC3D,OAAgB,MAAM,4BAA+C;IAErE;;;OAGG;IACH,OAAgB,cAAc,UAAQ;;IAetC;;;OAGG;IAEH,KAAK,SAAa;IAElB;;;OAGG;IAEH,MAAM,EAAE,WAAW,CAAS;IAE5B;;;OAGG;IAEH,OAAO,UAAS;IAEhB;;;;;OAKG;IAEH,QAAQ,EAAE,MAAM,EAAE,CAAM;IAExB;;;;OAIG;IAEH,YAAY,UAAS;IAErB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;OAGG;IAEH,MAAM,UAAS;IAEf;;;OAGG;IAEH,QAAQ,UAAS;IAEjB,sDAAsD;IAEtD,aAAa,SAAoB;IAEjC,2CAA2C;IAE3C,QAAQ,SAAS;IAEjB,+CAA+C;IAE/C,YAAY,SAAa;IAEzB,8DAA8D;IAE9D,aAAa,SAAmB;IAEhC,qDAAqD;IAErD,iBAAiB,SAAyB;IAE1C,kDAAkD;IAElD,eAAe,SAAiB;IAEhC,0DAA0D;IAE1D,WAAW,SAAkB;IAE7B;;;;;OAKG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;;OAKG;IAEH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAa;IAEhD;;;;OAIG;IAEH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAa;IAEzC;;;;OAIG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;OAIG;IAEH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAuC;IAI9E;;;OAGG;IACM,OAAO,CAAC,IAAI,CAAmC;IACxD;;;OAGG;IACM,OAAO,CAAC,KAAK,CAAS;IAC/B;;;OAGG;IACM,OAAO,CAAC,WAAW,CAAa;IAIzC;;;;;;OAMG;IACM,OAAO,CAAC,kBAAkB,CAAQ;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE9D,iEAAiE;IACxD,OAAO,CAAC,gBAAgB,CAAiB;IAClD,uEAAuE;IAC9D,OAAO,CAAC,cAAc,CAAc;IAC7C,8DAA8D;IACrD,OAAO,CAAC,aAAa,CAAS;IACvC,2EAA2E;IAClE,OAAO,CAAC,aAAa,CAAc;IAC5C,uEAAuE;IAC9D,OAAO,CAAC,cAAc,CAAc;IAE7C,iEAAiE;IACxD,OAAO,CAAC,eAAe,CAAc;IAE9C,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACvF,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACzF,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAE/E,sFAAsF;IAC7E,OAAO,CAAC,8BAA8B,CAAuB;IACtE,gBAAgB,CAAU,OAAO,CAAC,+BAA+B,CAAuB;IACxF,gBAAgB,CAAU,OAAO,CAAC,yBAAyB,CAAuB;IAElF,yFAAyF;IAChF,OAAO,CAAC,iBAAiB,CAAc;IAEhD,sDAAsD;IACtD,OAAO,CAAC,WAAW,CAAsC;IACzD,0EAA0E;IAC1E,OAAO,CAAC,sBAAsB,CAAiC;IAC/D,yEAAyE;IACzE,OAAO,CAAC,qBAAqB,CAAiC;IAC9D,0EAA0E;IAC1E,OAAO,CAAC,sBAAsB,CAAiC;IAC/D,4FAA4F;IAC5F,OAAO,CAAC,qBAAqB,CAAiC;IAI9D,+DAA+D;IACvC,OAAO,CAAC,OAAO,CAAsB;IAC7D,4DAA4D;IAC9B,OAAO,CAAC,YAAY,CAAsB;IACxE,gEAAgE;IAC9B,OAAO,CAAC,gBAAgB,CAAsB;IAIhF;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAS;IAC9B;;;OAGG;IACH,OAAO,CAAC,YAAY,CAAS;IAC7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAS;IAEjC;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAwB;IAGzC;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAA4B;IACrD;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAa;IACpC;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAA0B;IAI5C,iBAAiB,IAAI,IAAI;IAqBzB,oBAAoB,IAAI,IAAI;IAqB5B,UAAU,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAazD,YAAY,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAS3D,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAoB/D,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAWtB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAW1B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAiBzB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAaxB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAazB,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAK7B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,6BAA6B;IA6BrC,gBAAgB;IAChB,OAAO,CAAC,4BAA4B;IA2BpC,gBAAgB;IAChB,OAAO,CAAC,6BAA6B;IA2BrC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAuBpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,sBAAsB;IAkG9B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAI1B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAI3B,gBAAgB;cACG,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI3D,gBAAgB;cACG,YAAY,IAAI,IAAI;IAMvC,gBAAgB;cACG,mBAAmB,CACpC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtC,KAAK,EAAE,SAAS,GAAG,cAAc,GAChC,IAAI;IAMP,gBAAgB;IACP,eAAe,IAAI,IAAI;IA4BhC,gBAAgB;IAChB,OAAO,CAAC,OAAO;IAqBf,gBAAgB;IAChB,OAAO,CAAC,KAAK;IAiBb,gBAAgB;IAChB,OAAO,CAAC,KAAK;IASb,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAO5B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAS3B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAU3B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAe9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAW9B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IA+B1B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAe7B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAW7B,gBAAgB;IAChB,OAAO,CAAC,yBAAyB;IAejC,gBAAgB;IAChB,OAAO,CAAC,yBAAyB;IAWjC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAM1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAiBxB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAsBzB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAyB7B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAU1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAYxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAU1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAU1B,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAIjB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAUrB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAqCnB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IA6BxB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAiC5B,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAoBvB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA+BpB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAwBpB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAS5B,gBAAgB;IAChB,OAAO,CAAC,0BAA0B;IAalC,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAYxB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAYvB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAmBf,MAAM;CA0DhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC;KACrC;CACF"}

package/dist/components/hx-color-picker/hx-color-picker.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-color-picker.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-color-picker/hx-color-picker.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,yBA4RlC,CAAC"}
+{"version":3,"file":"hx-color-picker.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-color-picker/hx-color-picker.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,yBAqTlC,CAAC"}

package/dist/components/hx-color-picker/index.js

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-color-picker-uRc865FJ.js";
+import { H as e } from "../../shared/hx-color-picker-DVhZl88b.js";
 export {
   e as HelixColorPicker
 };