@cube-dev/ui-kit 0.180.0 → 0.182.0

package/dist/components/fields/ListBoxPopover/useCompositeFocus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useCallback, useEffect, useRef } from "react";
 
 //#region src/components/fields/ListBoxPopover/useCompositeFocus.ts

package/dist/components/fields/NumberInput/NumberInput.d.ts

@@ -1,4 +1,5 @@
 
+import { FieldBaseProps } from "../../../shared/form.js";
 import { WithNullableValue } from "../../../utils/react/nullableValue.js";
 import { CubeTextInputBaseProps } from "../TextInput/TextInputBase.js";
 import "../TextInput/index.js";
@@ -6,7 +7,8 @@ import * as react from "react";
 import { AriaNumberFieldProps as AriaNumberFieldProps$1 } from "react-aria";
 
 //#region src/components/fields/NumberInput/NumberInput.d.ts
-interface CubeNumberInputProps extends Omit<CubeTextInputBaseProps, 'defaultValue' | 'value' | 'onChange'>, Omit<AriaNumberFieldProps$1, 'validate' | 'form'> {
+interface CubeNumberInputProps extends Omit<CubeTextInputBaseProps, 'defaultValue' | 'value' | 'onChange' | 'field'>, Omit<AriaNumberFieldProps$1, 'validate' | 'form' | 'name'> {
+  field?: FieldBaseProps<number | null | undefined>['field'];
   /** Whether or to hide stepper */
   hideStepper?: boolean;
 }

package/dist/components/fields/NumberInput/NumberInput.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { castNullableNumberValue } from "../../../utils/react/nullableValue.js";
 import { useFieldProps } from "../../form/Form/use-field/use-field-props.js";

package/dist/components/fields/NumberInput/NumberInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"NumberInput.js","names":["mergeProps","mergeAriaProps"],"sources":["../../../../src/components/fields/NumberInput/NumberInput.tsx"],"sourcesContent":["import { tasty } from '@tenphi/tasty';\nimport { ForwardedRef, forwardRef, RefObject, useRef } from 'react';\nimport {\n  AriaNumberFieldProps,\n  mergeProps as mergeAriaProps,\n  useLocale,\n  useNumberField,\n} from 'react-aria';\nimport { useNumberFieldState } from 'react-stately';\n\nimport { mergeProps } from '../../../utils/react';\nimport {\n  castNullableNumberValue,\n  WithNullableValue,\n} from '../../../utils/react/nullableValue';\nimport { useFieldProps } from '../../form';\nimport { CubeTextInputBaseProps, TextInputBase } from '../TextInput';\n\nimport { StepButton } from './StepButton';\n\nexport interface CubeNumberInputProps\n  extends Omit<CubeTextInputBaseProps, 'defaultValue' | 'value' | 'onChange'>,\n    Omit<AriaNumberFieldProps, 'validate' | 'form'> {\n  /** Whether or to hide stepper */\n  hideStepper?: boolean;\n}\n\nconst StyledTextInputBase = tasty(TextInputBase, {\n  inputStyles: {\n    textAlign: 'right',\n  },\n});\n\nconst StepperContainer = tasty({\n  styles: {\n    display: 'grid',\n    gridColumns: '1sf',\n    gridRows: '1sf 1sf',\n    flow: 'column',\n    placeSelf: 'stretch',\n    margin: '(.5x - 1bw) left',\n  },\n});\n\nfunction NumberInput(\n  props: WithNullableValue<CubeNumberInputProps>,\n  ref: ForwardedRef<HTMLElement>,\n) {\n  props = castNullableNumberValue(props);\n  props = useFieldProps(props);\n\n  let {\n    hideStepper,\n    suffix,\n    value,\n    defaultValue,\n    onChange,\n    inputRef,\n    labelProps: userLabelProps,\n    inputProps: userInputProps,\n    ...otherProps\n  } = props;\n  let showStepper = !hideStepper;\n  let { locale } = useLocale();\n  let state = useNumberFieldState({ ...props, locale });\n  let localInputRef = useRef<HTMLInputElement>(null);\n\n  inputRef = inputRef ?? localInputRef;\n\n  let {\n    groupProps,\n    labelProps,\n    inputProps,\n    incrementButtonProps,\n    decrementButtonProps,\n  } = useNumberField(props, state, inputRef as RefObject<HTMLInputElement>);\n\n  // Merge user-provided labelProps with aria labelProps\n  const mergedLabelProps = mergeProps(labelProps, userLabelProps);\n\n  const steppers = showStepper ? (\n    <StepperContainer>\n      <StepButton\n        isDisabled={props.isDisabled}\n        direction=\"up\"\n        {...incrementButtonProps}\n        size={otherProps.size}\n      />\n      <StepButton\n        isDisabled={props.isDisabled}\n        direction=\"down\"\n        {...decrementButtonProps}\n        size={otherProps.size}\n      />\n    </StepperContainer>\n  ) : undefined;\n\n  return (\n    <StyledTextInputBase\n      {...otherProps}\n      ref={ref}\n      labelProps={mergedLabelProps}\n      inputProps={mergeProps(\n        // `useNumberField` seeds its input id once. Merging the current id\n        // through react-aria's own `mergeProps` updates that seed, so the\n        // input, its label and the steppers' `aria-controls` follow the id\n        // when the form binding changes after mount.\n        mergeAriaProps(inputProps, { id: props.id }),\n        { 'data-input-type': 'numberinput' },\n        userInputProps,\n      )}\n      inputRef={inputRef}\n      wrapperProps={groupProps}\n      suffixPosition=\"after\"\n      suffix={\n        showStepper ? (\n          props.suffixPosition === 'before' ? (\n            <>\n              {suffix}\n              {steppers}\n            </>\n          ) : (\n            <>\n              {steppers}\n              {suffix}\n            </>\n          )\n        ) : (\n          suffix\n        )\n      }\n    />\n  );\n}\n\n/**\n * NumberFields allow users to enter a number and increment or decrement the value using stepper buttons.\n */\nconst _NumberInput = forwardRef(NumberInput);\n\n(_NumberInput as any).cubeInputType = 'Number';\n\n_NumberInput.displayName = 'NumberInput';\n\nexport { _NumberInput as NumberInput };\nexport type { AriaNumberFieldProps };\n"],"mappings":";;;;;;;;;;;;;AA2BA,MAAM,sBAAsB,MAAM,eAAe,EAC/C,aAAa,EACX,WAAW,SACZ,EACF,CAAC;AAEF,MAAM,mBAAmB,MAAM,EAC7B,QAAQ;CACN,SAAS;CACT,aAAa;CACb,UAAU;CACV,MAAM;CACN,WAAW;CACX,QAAQ;CACT,EACF,CAAC;AAEF,SAAS,YACP,OACA,KACA;AACA,SAAQ,wBAAwB,MAAM;AACtC,SAAQ,cAAc,MAAM;CAE5B,IAAI,EACF,aACA,QACA,OACA,cACA,UACA,UACA,YAAY,gBACZ,YAAY,gBACZ,GAAG,eACD;CACJ,IAAI,cAAc,CAAC;CACnB,IAAI,EAAE,WAAW,WAAW;CAC5B,IAAI,QAAQ,oBAAoB;EAAE,GAAG;EAAO;EAAQ,CAAC;CACrD,IAAI,gBAAgB,OAAyB,KAAK;AAElD,YAAW,YAAY;CAEvB,IAAI,EACF,YACA,YACA,YACA,sBACA,yBACE,eAAe,OAAO,OAAO,SAAwC;CAGzE,MAAM,mBAAmBA,aAAW,YAAY,eAAe;CAE/D,MAAM,WAAW,cACf,qBAAC,+BACC,oBAAC;EACC,YAAY,MAAM;EAClB,WAAU;EACV,GAAI;EACJ,MAAM,WAAW;GACjB,EACF,oBAAC;EACC,YAAY,MAAM;EAClB,WAAU;EACV,GAAI;EACJ,MAAM,WAAW;GACjB,IACe,GACjB;AAEJ,QACE,oBAAC;EACC,GAAI;EACC;EACL,YAAY;EACZ,YAAYA,aAKVC,WAAe,YAAY,EAAE,IAAI,MAAM,IAAI,CAAC,EAC5C,EAAE,mBAAmB,eAAe,EACpC,eACD;EACS;EACV,cAAc;EACd,gBAAe;EACf,QACE,cACE,MAAM,mBAAmB,WACvB,8CACG,QACA,YACA,GAEH,8CACG,UACA,UACA,GAGL;GAGJ;;;;;AAON,MAAM,eAAe,WAAW,YAAY;AAE5C,AAAC,aAAqB,gBAAgB;AAEtC,aAAa,cAAc"}
+{"version":3,"file":"NumberInput.js","names":["mergeProps","mergeAriaProps"],"sources":["../../../../src/components/fields/NumberInput/NumberInput.tsx"],"sourcesContent":["import { tasty } from '@tenphi/tasty';\nimport { ForwardedRef, forwardRef, RefObject, useRef } from 'react';\nimport {\n  AriaNumberFieldProps,\n  mergeProps as mergeAriaProps,\n  useLocale,\n  useNumberField,\n} from 'react-aria';\nimport { useNumberFieldState } from 'react-stately';\n\nimport { mergeProps } from '../../../utils/react';\nimport {\n  castNullableNumberValue,\n  WithNullableValue,\n} from '../../../utils/react/nullableValue';\nimport { useFieldProps } from '../../form';\nimport { CubeTextInputBaseProps, TextInputBase } from '../TextInput';\n\nimport { StepButton } from './StepButton';\n\nimport type { FieldBaseProps } from '../../../shared/form';\n\nexport interface CubeNumberInputProps\n  extends Omit<\n      CubeTextInputBaseProps,\n      'defaultValue' | 'value' | 'onChange' | 'field'\n    >,\n    Omit<AriaNumberFieldProps, 'validate' | 'form' | 'name'> {\n  field?: FieldBaseProps<number | null | undefined>['field'];\n  /** Whether or to hide stepper */\n  hideStepper?: boolean;\n}\n\nconst StyledTextInputBase = tasty(TextInputBase, {\n  inputStyles: {\n    textAlign: 'right',\n  },\n});\n\nconst StepperContainer = tasty({\n  styles: {\n    display: 'grid',\n    gridColumns: '1sf',\n    gridRows: '1sf 1sf',\n    flow: 'column',\n    placeSelf: 'stretch',\n    margin: '(.5x - 1bw) left',\n  },\n});\n\nfunction NumberInput(\n  props: WithNullableValue<CubeNumberInputProps>,\n  ref: ForwardedRef<HTMLElement>,\n) {\n  props = castNullableNumberValue(props);\n  props = useFieldProps(props);\n\n  let {\n    hideStepper,\n    suffix,\n    value,\n    defaultValue,\n    onChange,\n    inputRef,\n    labelProps: userLabelProps,\n    inputProps: userInputProps,\n    ...otherProps\n  } = props;\n  let showStepper = !hideStepper;\n  let { locale } = useLocale();\n  let state = useNumberFieldState({ ...props, locale });\n  let localInputRef = useRef<HTMLInputElement>(null);\n\n  inputRef = inputRef ?? localInputRef;\n\n  let {\n    groupProps,\n    labelProps,\n    inputProps,\n    incrementButtonProps,\n    decrementButtonProps,\n  } = useNumberField(props, state, inputRef as RefObject<HTMLInputElement>);\n\n  // Merge user-provided labelProps with aria labelProps\n  const mergedLabelProps = mergeProps(labelProps, userLabelProps);\n\n  const steppers = showStepper ? (\n    <StepperContainer>\n      <StepButton\n        isDisabled={props.isDisabled}\n        direction=\"up\"\n        {...incrementButtonProps}\n        size={otherProps.size}\n      />\n      <StepButton\n        isDisabled={props.isDisabled}\n        direction=\"down\"\n        {...decrementButtonProps}\n        size={otherProps.size}\n      />\n    </StepperContainer>\n  ) : undefined;\n\n  return (\n    <StyledTextInputBase\n      {...otherProps}\n      ref={ref}\n      labelProps={mergedLabelProps}\n      inputProps={mergeProps(\n        // `useNumberField` seeds its input id once. Merging the current id\n        // through react-aria's own `mergeProps` updates that seed, so the\n        // input, its label and the steppers' `aria-controls` follow the id\n        // when the form binding changes after mount.\n        mergeAriaProps(inputProps, { id: props.id }),\n        { 'data-input-type': 'numberinput' },\n        userInputProps,\n      )}\n      inputRef={inputRef}\n      wrapperProps={groupProps}\n      suffixPosition=\"after\"\n      suffix={\n        showStepper ? (\n          props.suffixPosition === 'before' ? (\n            <>\n              {suffix}\n              {steppers}\n            </>\n          ) : (\n            <>\n              {steppers}\n              {suffix}\n            </>\n          )\n        ) : (\n          suffix\n        )\n      }\n    />\n  );\n}\n\n/**\n * NumberFields allow users to enter a number and increment or decrement the value using stepper buttons.\n */\nconst _NumberInput = forwardRef(NumberInput);\n\n(_NumberInput as any).cubeInputType = 'Number';\n\n_NumberInput.displayName = 'NumberInput';\n\nexport { _NumberInput as NumberInput };\nexport type { AriaNumberFieldProps };\n"],"mappings":";;;;;;;;;;;;;AAiCA,MAAM,sBAAsB,MAAM,eAAe,EAC/C,aAAa,EACX,WAAW,SACZ,EACF,CAAC;AAEF,MAAM,mBAAmB,MAAM,EAC7B,QAAQ;CACN,SAAS;CACT,aAAa;CACb,UAAU;CACV,MAAM;CACN,WAAW;CACX,QAAQ;CACT,EACF,CAAC;AAEF,SAAS,YACP,OACA,KACA;AACA,SAAQ,wBAAwB,MAAM;AACtC,SAAQ,cAAc,MAAM;CAE5B,IAAI,EACF,aACA,QACA,OACA,cACA,UACA,UACA,YAAY,gBACZ,YAAY,gBACZ,GAAG,eACD;CACJ,IAAI,cAAc,CAAC;CACnB,IAAI,EAAE,WAAW,WAAW;CAC5B,IAAI,QAAQ,oBAAoB;EAAE,GAAG;EAAO;EAAQ,CAAC;CACrD,IAAI,gBAAgB,OAAyB,KAAK;AAElD,YAAW,YAAY;CAEvB,IAAI,EACF,YACA,YACA,YACA,sBACA,yBACE,eAAe,OAAO,OAAO,SAAwC;CAGzE,MAAM,mBAAmBA,aAAW,YAAY,eAAe;CAE/D,MAAM,WAAW,cACf,qBAAC,+BACC,oBAAC;EACC,YAAY,MAAM;EAClB,WAAU;EACV,GAAI;EACJ,MAAM,WAAW;GACjB,EACF,oBAAC;EACC,YAAY,MAAM;EAClB,WAAU;EACV,GAAI;EACJ,MAAM,WAAW;GACjB,IACe,GACjB;AAEJ,QACE,oBAAC;EACC,GAAI;EACC;EACL,YAAY;EACZ,YAAYA,aAKVC,WAAe,YAAY,EAAE,IAAI,MAAM,IAAI,CAAC,EAC5C,EAAE,mBAAmB,eAAe,EACpC,eACD;EACS;EACV,cAAc;EACd,gBAAe;EACf,QACE,cACE,MAAM,mBAAmB,WACvB,8CACG,QACA,YACA,GAEH,8CACG,UACA,UACA,GAGL;GAGJ;;;;;AAON,MAAM,eAAe,WAAW,YAAY;AAE5C,AAAC,aAAqB,gBAAgB;AAEtC,aAAa,cAAc"}

package/dist/components/fields/NumberInput/StepButton.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useI18n } from "../../../i18n/useI18n.js";
 import { DirectionIcon } from "../../../icons/DirectionIcon.js";
 import { Button } from "../../actions/index.js";

package/dist/components/fields/PasswordInput/PasswordInput.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { chain } from "../../../utils/react/chain.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useBufferedValue } from "../../../utils/react/useBufferedValue.js";

package/dist/components/fields/Picker/Picker.d.ts

@@ -12,7 +12,7 @@ import { ForwardedRef, MutableRefObject, ReactElement, ReactNode } from "react";
 import { ListState, Section } from "react-stately";
 
 //#region src/components/fields/Picker/Picker.d.ts
-interface CubePickerProps<T> extends Omit<CubeListBoxProps<T>, 'size' | 'tooltip' | 'shape' | 'emptyLabel'>, Omit<CubeItemProps, 'children' | 'size'>, BasePropsWithoutChildren, BaseStyleProps, OuterStyleProps, ColorStyleProps, Omit<FieldBaseProps, 'tooltip'>, Pick<CubeItemButtonProps, 'type' | 'theme' | 'icon' | 'rightIcon' | 'prefix' | 'suffix' | 'hotkeys' | 'shape'> {
+interface CubePickerProps<T> extends Omit<CubeListBoxProps<T>, 'size' | 'tooltip' | 'shape' | 'emptyLabel'>, Omit<CubeItemProps, 'children' | 'size'>, BasePropsWithoutChildren, BaseStyleProps, OuterStyleProps, ColorStyleProps, Omit<FieldBaseProps<string | number | readonly (string | number)[] | null | undefined>, 'tooltip'>, Pick<CubeItemButtonProps, 'type' | 'theme' | 'icon' | 'rightIcon' | 'prefix' | 'suffix' | 'hotkeys' | 'shape'> {
   /** Placeholder text when no selection is made */
   placeholder?: string;
   /** Size of the picker component */
@@ -60,6 +60,8 @@ interface CubePickerProps<T> extends Omit<CubeListBoxProps<T>, 'size' | 'tooltip
   mods?: Record<string, boolean>;
   /** Whether the picker is clearable using a clear button in the rightIcon slot */
   isClearable?: boolean;
+  /** Accessible name for the built-in clear button. Defaults to a localized "Clear value". */
+  clearLabel?: string;
   /** Callback called when the clear button is pressed */
   onClear?: () => void;
   /**

package/dist/components/fields/Picker/Picker.js

@@ -1,9 +1,9 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { _Text } from "../../content/Text.js";
-import { LoadingIcon } from "../../../icons/LoadingIcon.js";
 import { useWarn } from "../../../_internal/hooks/use-warn.js";
+import { LoadingIcon } from "../../../icons/LoadingIcon.js";
 import { ItemAction } from "../../actions/ItemAction/ItemAction.js";
 import { useI18n } from "../../../i18n/useI18n.js";
 import { DirectionIcon } from "../../../icons/DirectionIcon.js";
@@ -16,13 +16,14 @@ import { getValidationIcon } from "../../form/validation/ValidationIndicator.js"
 import { useFieldProps } from "../../form/Form/use-field/use-field-props.js";
 import { wrapWithField } from "../../form/wrapper.js";
 import { DialogTrigger } from "../../overlays/Dialog/DialogTrigger.js";
+import { allowEscapeToPropagate } from "../../../utils/react/escapePropagation.js";
 import { ListBox } from "../ListBox/ListBox.js";
 import { TriggerActions } from "../TriggerActions.js";
 import { processSelectionArray } from "../../../utils/selection.js";
 import { BASE_STYLES, COLOR_STYLES, OUTER_STYLES, filterBaseProps, tasty } from "@tenphi/tasty";
 import { forwardRef, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
-import { FocusScope, useKeyboard } from "react-aria";
+import { FocusScope } from "react-aria";
 import { Section, useListState } from "react-stately";
 
 //#region src/components/fields/Picker/Picker.tsx
@@ -54,7 +55,7 @@ const Picker = forwardRef(function Picker(props, ref) {
 		};
 		return fieldProps;
 	} });
-	let { id, qa, label, extra, icon, rightIcon, prefix, suffix, actions, hotkeys, triggerTooltip, triggerDescription, labelStyles, isRequired, necessityIndicator, isInvalid, isValid, isDisabled, isLoading, message, mods: externalMods, description, descriptionPlacement, placeholder, size = "medium", styles, listBoxStyles, popoverStyles, type = "outline", theme = "default", shape, labelSuffix, shouldFocusWrap, children, shouldFlip = true, containerPadding = 8, selectedKey, defaultSelectedKey, selectedKeys, defaultSelectedKeys, disabledKeys, onSelectionChange, selectionMode = "single", listStateRef, focusOnHover, showSelectAll, selectAllLabel = t("picker.all", "All"), items, header, footer, headerStyles, footerStyles, triggerStyles, renderSummary, isCheckable, allValueProps, listStyles, optionStyles, sectionStyles, headingStyles, listRef, disallowEmptySelection, shouldUseVirtualFocus, onEscape, onOptionClick, isClearable, onClear, sortSelectedToTop, onOpenChange, listStateRef: externalListStateRef, ...otherProps } = props;
+	let { id, qa, label, extra, icon, rightIcon, prefix, suffix, actions, hotkeys, triggerTooltip, triggerDescription, labelStyles, isRequired, necessityIndicator, isInvalid, isValid, isDisabled, isLoading, message, mods: externalMods, description, descriptionPlacement, placeholder, size = "medium", styles, listBoxStyles, popoverStyles, type = "outline", theme = "default", shape, labelSuffix, shouldFocusWrap, children, shouldFlip = true, containerPadding = 8, selectedKey, defaultSelectedKey, selectedKeys, defaultSelectedKeys, disabledKeys, onSelectionChange, selectionMode = "single", listStateRef, focusOnHover, showSelectAll, selectAllLabel = t("picker.all", "All"), items, header, footer, headerStyles, footerStyles, triggerStyles, renderSummary, isCheckable, allValueProps, listStyles, optionStyles, sectionStyles, headingStyles, listRef, disallowEmptySelection, shouldUseVirtualFocus, onEscape, onOptionClick, isClearable, clearLabel, onClear, sortSelectedToTop, onOpenChange, listStateRef: externalListStateRef, ...otherProps } = props;
 	styles = extractStyles(otherProps, PROP_STYLES, styles);
 	useWarn(isCheckable === false && selectionMode === "single", {
 		key: ["picker-checkable-single-mode"],
@@ -172,12 +173,14 @@ const Picker = forwardRef(function Picker(props, ref) {
 		}
 		onOpenChange?.(isOpen);
 	});
-	const { keyboardProps } = useKeyboard({ onKeyDown: (e) => {
+	const keyboardProps = { onKeyDown: (e) => {
+		allowEscapeToPropagate(e);
 		if ((e.key === "ArrowUp" || e.key === "ArrowDown") && !isPopoverOpen) {
 			e.preventDefault();
 			handleOpenChange(true);
+			return;
 		}
-	} });
+	} };
 	const clearValue = useEvent(() => {
 		if (selectionMode === "multiple") {
 			if (!isControlledMultiple) setInternalSelectedKeys([]);
@@ -239,6 +242,7 @@ const Picker = forwardRef(function Picker(props, ref) {
 			icon: /* @__PURE__ */ jsx(CloseIcon, {}),
 			size,
 			qa: "PickerClearButton",
+			"aria-label": clearLabel ?? t("picker.clearValue", "Clear value"),
 			mods: { pressed: false },
 			onPress: clearValue
 		}) : /* @__PURE__ */ jsx(ItemActionIcon, { children: /* @__PURE__ */ jsx(DirectionIcon, { to: isPopoverOpen ? "top" : "bottom" }) })

package/dist/components/fields/Picker/Picker.js.map

@@ -1 +1 @@
-{"version":3,"file":"Picker.js","names":["Text","TriggerIcon","ItemButton","BaseSection"],"sources":["../../../../src/components/fields/Picker/Picker.tsx"],"sourcesContent":["import { CollectionChildren, FocusableRefValue } from '@react-types/shared';\nimport {\n  BASE_STYLES,\n  BasePropsWithoutChildren,\n  BaseStyleProps,\n  COLOR_STYLES,\n  ColorStyleProps,\n  filterBaseProps,\n  OUTER_STYLES,\n  OuterStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport {\n  ForwardedRef,\n  forwardRef,\n  MutableRefObject,\n  ReactElement,\n  ReactNode,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { FocusScope, Key, useKeyboard } from 'react-aria';\nimport { Section as BaseSection, ListState, useListState } from 'react-stately';\n\nimport { useEvent } from '../../../_internal';\nimport { useWarn } from '../../../_internal/hooks/use-warn';\nimport { useI18n } from '../../../i18n';\nimport { CloseIcon } from '../../../icons/CloseIcon';\nimport { DirectionIcon } from '../../../icons/DirectionIcon';\nimport { LoadingIcon } from '../../../icons/LoadingIcon';\nimport { processSelectionArray } from '../../../utils/selection';\nimport { extractStyles } from '../../../utils/styles';\nimport { CubeItemButtonProps, ItemAction, ItemButton } from '../../actions';\nimport { CubeItemProps } from '../../content/Item';\nimport { Text } from '../../content/Text';\nimport {\n  getValidationIcon,\n  getValidationTheme,\n  useFieldProps,\n  wrapWithField,\n} from '../../form';\nimport { Dialog, DialogTrigger } from '../../overlays/Dialog';\nimport { CubeListBoxProps, ListBox } from '../ListBox/ListBox';\nimport { TriggerActions, TriggerIcon } from '../TriggerActions';\n\nimport type { FieldBaseProps } from '../../../shared';\n\nexport interface CubePickerProps<T>\n  extends Omit<\n      CubeListBoxProps<T>,\n      'size' | 'tooltip' | 'shape' | 'emptyLabel'\n    >,\n    Omit<CubeItemProps, 'children' | 'size'>,\n    BasePropsWithoutChildren,\n    BaseStyleProps,\n    OuterStyleProps,\n    ColorStyleProps,\n    Omit<FieldBaseProps, 'tooltip'>,\n    Pick<\n      CubeItemButtonProps,\n      | 'type'\n      | 'theme'\n      | 'icon'\n      | 'rightIcon'\n      | 'prefix'\n      | 'suffix'\n      | 'hotkeys'\n      | 'shape'\n    > {\n  /** Placeholder text when no selection is made */\n  placeholder?: string;\n  /** Size of the picker component */\n  size?: 'small' | 'medium' | 'large';\n  /** Custom styles for the list box popover */\n  listBoxStyles?: Styles;\n  /** Custom styles for the popover container */\n  popoverStyles?: Styles;\n  /** Custom styles for the trigger button */\n  triggerStyles?: Styles;\n  /** Whether to show checkboxes for multiple selection mode */\n  isCheckable?: boolean;\n  /** Whether to flip the popover placement */\n  shouldFlip?: boolean;\n  /** Minimum padding in pixels between the popover and viewport edges */\n  containerPadding?: number;\n  /** Tooltip for the trigger button (separate from field tooltip) */\n  triggerTooltip?: CubeItemProps['tooltip'];\n  /** Description for the trigger button (separate from field description) */\n  triggerDescription?: CubeItemProps['description'];\n\n  /**\n   * Custom renderer for the summary shown inside the trigger when there is a selection.\n   *\n   * For `selectionMode=\"multiple\"` the function receives:\n   *  - `selectedLabels`: array of labels of the selected items.\n   *  - `selectedKeys`: array of keys of the selected items or \"all\".\n   *\n   * For `selectionMode=\"single\"` the function receives:\n   *  - `selectedLabel`: label of the selected item.\n   *  - `selectedKey`: key of the selected item.\n   *\n   * The function should return a `ReactNode` that will be rendered inside the trigger.\n   * Set to `false` to hide the summary text completely.\n   */\n  renderSummary?:\n    | ((args: {\n        selectedLabels?: string[];\n        selectedKeys?: 'all' | (string | number)[];\n        selectedLabel?: string;\n        selectedKey?: string | number | null;\n        selectionMode?: 'single' | 'multiple';\n      }) => ReactNode)\n    | false;\n\n  /** Ref to access internal ListBox state */\n  listStateRef?: MutableRefObject<ListState<T>>;\n  /** Additional modifiers for styling the Picker */\n  mods?: Record<string, boolean>;\n  /** Whether the picker is clearable using a clear button in the rightIcon slot */\n  isClearable?: boolean;\n  /** Callback called when the clear button is pressed */\n  onClear?: () => void;\n  /**\n   * Custom actions rendered inside the trigger, to the left of the built-in\n   * clear button and dropdown caret. Use `Picker.Action` so they match the\n   * trigger's size and theme.\n   *\n   * Pressing one runs its handler without opening or closing the popover —\n   * including while the popover is open. Actions follow the trigger's disabled\n   * state but NOT `isReadOnly`, since a read-only field can still host an\n   * action that does not change the value; pass `isDisabled` yourself for one\n   * that does.\n   */\n  actions?: ReactNode;\n  /**\n   * Sort selected item(s) to the top when the popover opens.\n   * Only works when using the `items` prop (data-driven mode).\n   * Supports both single and multiple selection modes.\n   * @default true when items are provided, false when using JSX children\n   */\n  sortSelectedToTop?: boolean;\n  /** Callback called when the popover open state changes */\n  onOpenChange?: (isOpen: boolean) => void;\n}\n\nconst PROP_STYLES = [...BASE_STYLES, ...OUTER_STYLES, ...COLOR_STYLES];\n\nconst PickerWrapper = tasty({\n  qa: 'PickerWrapper',\n  styles: {\n    display: 'inline-grid',\n    flow: 'column',\n    gridRows: '1sf',\n    placeContent: 'stretch',\n    placeItems: 'stretch',\n  },\n});\n\nexport const Picker = forwardRef(function Picker<T extends object>(\n  props: CubePickerProps<T>,\n  ref: ForwardedRef<HTMLElement>,\n) {\n  const { t } = useI18n();\n\n  props = useFieldProps(props, {\n    valuePropsMapper: ({ value, onChange }) => {\n      const fieldProps: Record<string, unknown> = {};\n\n      if (props.selectionMode === 'multiple') {\n        fieldProps.selectedKeys = value || [];\n      } else {\n        fieldProps.selectedKey = value ?? null;\n      }\n\n      fieldProps.onSelectionChange = (key: Key | null | 'all' | Key[]) => {\n        if (props.selectionMode === 'multiple') {\n          // Handle \"all\" selection and array selections\n          if (key === 'all') {\n            onChange('all');\n          } else {\n            onChange(key ? (Array.isArray(key) ? key : [key]) : []);\n          }\n        } else {\n          onChange(Array.isArray(key) ? key[0] : key);\n        }\n      };\n\n      return fieldProps;\n    },\n  });\n\n  let {\n    id,\n    qa,\n    label,\n    extra,\n    icon,\n    rightIcon,\n    prefix,\n    suffix,\n    actions,\n    hotkeys,\n    triggerTooltip,\n    triggerDescription,\n    labelStyles,\n    isRequired,\n    necessityIndicator,\n    isInvalid,\n    isValid,\n    isDisabled,\n    isLoading,\n    message,\n    mods: externalMods,\n    description,\n    descriptionPlacement,\n    placeholder,\n    size = 'medium',\n    styles,\n    listBoxStyles,\n    popoverStyles,\n    type = 'outline',\n    theme = 'default',\n    shape,\n    labelSuffix,\n    shouldFocusWrap,\n    children,\n    shouldFlip = true,\n    containerPadding = 8,\n    selectedKey,\n    defaultSelectedKey,\n    selectedKeys,\n    defaultSelectedKeys,\n    disabledKeys,\n    onSelectionChange,\n    selectionMode = 'single',\n    listStateRef,\n    focusOnHover,\n    showSelectAll,\n    selectAllLabel = t('picker.all', 'All'),\n    items,\n    header,\n    footer,\n    headerStyles,\n    footerStyles,\n    triggerStyles,\n    renderSummary,\n    isCheckable,\n    allValueProps,\n    listStyles,\n    optionStyles,\n    sectionStyles,\n    headingStyles,\n    listRef,\n    disallowEmptySelection,\n    shouldUseVirtualFocus,\n    onEscape,\n    onOptionClick,\n    isClearable,\n    onClear,\n    sortSelectedToTop,\n    onOpenChange,\n    listStateRef: externalListStateRef,\n    ...otherProps\n  } = props;\n\n  styles = extractStyles(otherProps, PROP_STYLES, styles);\n\n  // Warn if isCheckable is false in single selection mode\n  useWarn(isCheckable === false && selectionMode === 'single', {\n    key: ['picker-checkable-single-mode'],\n    args: [\n      'CubeUIKit: isCheckable=false is not recommended in single selection mode as it may confuse users about selection behavior.',\n    ],\n  });\n\n  // Internal selection state (uncontrolled scenario)\n  const [internalSelectedKey, setInternalSelectedKey] = useState<Key | null>(\n    defaultSelectedKey ?? null,\n  );\n  const [internalSelectedKeys, setInternalSelectedKeys] = useState<\n    'all' | Key[]\n  >(defaultSelectedKeys ?? []);\n\n  // Popover state — used as controlled prop for DialogTrigger\n  const [isPopoverOpen, setIsPopoverOpen] = useState(false);\n  const triggerRef = useRef<FocusableRefValue<HTMLButtonElement>>(null);\n  // Measured lazily on popover open instead of on every render\n  const triggerWidthRef = useRef<number | undefined>(undefined);\n\n  const isControlledSingle = selectedKey !== undefined;\n  const isControlledMultiple = selectedKeys !== undefined;\n\n  const effectiveSelectedKey = isControlledSingle\n    ? selectedKey\n    : internalSelectedKey;\n  const effectiveSelectedKeys = isControlledMultiple\n    ? selectedKeys\n    : internalSelectedKeys;\n\n  // Ref to access internal ListBox state for collection API\n  const internalListStateRef = useRef<ListState<T>>(null);\n\n  // Sync internal ref with external ref if provided\n  useEffect(() => {\n    if (externalListStateRef && internalListStateRef.current) {\n      externalListStateRef.current = internalListStateRef.current;\n    }\n  }, [externalListStateRef]);\n\n  // Cache for sorted items array when using `items` prop\n  const cachedItemsOrder = useRef<T[] | null>(null);\n\n  const latestSelectionRef = useRef<{\n    single: string | null;\n    multiple: string[];\n  }>({\n    single: effectiveSelectedKey != null ? String(effectiveSelectedKey) : null,\n    multiple:\n      selectionMode === 'multiple' && effectiveSelectedKeys !== 'all'\n        ? (effectiveSelectedKeys || []).map(String)\n        : [],\n  });\n\n  useEffect(() => {\n    latestSelectionRef.current = {\n      single:\n        effectiveSelectedKey != null ? String(effectiveSelectedKey) : null,\n      multiple:\n        selectionMode === 'multiple' && effectiveSelectedKeys !== 'all'\n          ? (effectiveSelectedKeys || []).map(String)\n          : [],\n    };\n  }, [effectiveSelectedKey, effectiveSelectedKeys, selectionMode]);\n\n  const selectionWhenClosed = useRef<{\n    single: string | null;\n    multiple: string[];\n  }>({ single: null, multiple: [] });\n\n  const sortSelectedToTopExplicit = sortSelectedToTop !== undefined;\n  const shouldSortSelectedToTop = sortSelectedToTop ?? (items ? true : false);\n\n  useWarn(sortSelectedToTopExplicit && shouldSortSelectedToTop && !items, {\n    key: ['picker-sort-selected-to-top-children'],\n    args: [\n      'Picker: sortSelectedToTop only works with the items prop. Sorting will be skipped when using JSX children.',\n    ],\n  });\n\n  useEffect(() => {\n    cachedItemsOrder.current = null;\n  }, [items]);\n\n  useEffect(() => {\n    if (!isPopoverOpen) {\n      selectionWhenClosed.current = {\n        single:\n          effectiveSelectedKey != null ? String(effectiveSelectedKey) : null,\n        multiple:\n          selectionMode === 'multiple' && effectiveSelectedKeys !== 'all'\n            ? (effectiveSelectedKeys || []).map(String)\n            : [],\n      };\n    }\n  }, [\n    effectiveSelectedKey,\n    effectiveSelectedKeys,\n    isPopoverOpen,\n    selectionMode,\n  ]);\n\n  const finalItems = useMemo(() => {\n    if (!items || !shouldSortSelectedToTop) return items;\n    if (!isPopoverOpen) return items;\n    if (cachedItemsOrder.current) return cachedItemsOrder.current;\n\n    const selectedKeySet = new Set<string>();\n\n    if (selectionMode === 'multiple') {\n      if (\n        selectionWhenClosed.current.multiple.length === 0 ||\n        effectiveSelectedKeys === 'all'\n      ) {\n        return items;\n      }\n      selectionWhenClosed.current.multiple.forEach((k) =>\n        selectedKeySet.add(k),\n      );\n    } else if (selectionWhenClosed.current.single) {\n      selectedKeySet.add(selectionWhenClosed.current.single);\n    }\n\n    if (selectedKeySet.size === 0) return items;\n\n    const itemsArray = Array.isArray(items) ? items : Array.from(items);\n    const selectedItems: T[] = [];\n    const unselectedItems: T[] = [];\n\n    itemsArray.forEach((item) => {\n      const key = (item as any)?.key ?? (item as any)?.id;\n      if (key != null && selectedKeySet.has(String(key))) {\n        selectedItems.push(item);\n      } else {\n        unselectedItems.push(item);\n      }\n    });\n\n    const sorted = [...selectedItems, ...unselectedItems];\n\n    cachedItemsOrder.current = sorted;\n\n    return sorted;\n  }, [items, shouldSortSelectedToTop, selectionMode, isPopoverOpen]);\n\n  // Create local collection state for reading item data (labels, etc.)\n  // This allows us to read item labels even before the popover opens\n  const localCollectionState = useListState({\n    children,\n    items: finalItems, // Use sorted items to match what's shown in popover\n    selectionMode: 'none', // Don't manage selection in this state\n  });\n\n  const selectedLabels = useMemo(() => {\n    const collection = localCollectionState?.collection;\n\n    if (selectionMode === 'multiple' && effectiveSelectedKeys === 'all') {\n      if (!collection) return [];\n      const labels: string[] = [];\n      for (const item of collection) {\n        if (item.type === 'item') {\n          labels.push(item.textValue || String(item.key));\n        }\n      }\n      return labels;\n    }\n\n    const keysToGet =\n      selectionMode === 'multiple' && effectiveSelectedKeys !== 'all'\n        ? effectiveSelectedKeys || []\n        : effectiveSelectedKey != null\n          ? [effectiveSelectedKey]\n          : [];\n\n    return keysToGet\n      .map((key) => {\n        const item = collection?.getItem(key);\n        return item?.textValue || String(key);\n      })\n      .filter(Boolean);\n  }, [\n    selectionMode,\n    effectiveSelectedKeys,\n    effectiveSelectedKey,\n    localCollectionState?.collection,\n  ]);\n\n  const hasSelection = selectedLabels.length > 0;\n\n  // ---------------------------------------------------------------------------\n  // Popover lifecycle — all effects moved out of the inline renderTrigger\n  // function so they have a stable component identity and don't tear\n  // down/setup on every parent re-render.\n  // DialogTrigger is controlled via isOpen/onOpenChange.\n  // ---------------------------------------------------------------------------\n\n  const handleOpenChange = useEvent((isOpen: boolean) => {\n    if (isOpen === isPopoverOpen) return;\n\n    if (isOpen) {\n      triggerWidthRef.current =\n        triggerRef?.current?.UNSAFE_getDOMNode()?.offsetWidth;\n    }\n    setIsPopoverOpen(isOpen);\n    if (!isOpen) {\n      selectionWhenClosed.current = { ...latestSelectionRef.current };\n      cachedItemsOrder.current = null;\n    }\n    onOpenChange?.(isOpen);\n  });\n\n  // Popover sync is handled by the inner `DialogTrigger` (type=\"popover\").\n\n  // Keyboard handler for arrow keys to open popover\n  const { keyboardProps } = useKeyboard({\n    onKeyDown: (e) => {\n      if ((e.key === 'ArrowUp' || e.key === 'ArrowDown') && !isPopoverOpen) {\n        e.preventDefault();\n        handleOpenChange(true);\n      }\n    },\n  });\n\n  // Clear handler\n  const clearValue = useEvent(() => {\n    if (selectionMode === 'multiple') {\n      if (!isControlledMultiple) {\n        setInternalSelectedKeys([]);\n      }\n      onSelectionChange?.([]);\n    } else {\n      if (!isControlledSingle) {\n        setInternalSelectedKey(null);\n      }\n      onSelectionChange?.(null);\n    }\n\n    handleOpenChange(false);\n    triggerRef?.current?.focus?.();\n    onClear?.();\n\n    return false;\n  });\n\n  // ---------------------------------------------------------------------------\n  // Trigger content\n  // ---------------------------------------------------------------------------\n\n  const triggerContent = useMemo((): ReactNode => {\n    if (typeof renderSummary === 'function') {\n      if (selectionMode === 'single') {\n        return renderSummary({\n          selectedLabel: selectedLabels[0],\n          selectedKey: effectiveSelectedKey ?? null,\n          selectedLabels,\n          selectedKeys: effectiveSelectedKeys,\n          selectionMode: 'single',\n        });\n      }\n\n      return renderSummary({\n        selectedLabels,\n        selectedKeys: effectiveSelectedKeys,\n        selectionMode: 'multiple',\n      });\n    } else if (renderSummary === false) {\n      return null;\n    }\n\n    if (!hasSelection) {\n      return <Text.Placeholder>{placeholder}</Text.Placeholder>;\n    } else if (selectionMode === 'single') {\n      return selectedLabels[0] || null;\n    } else if (effectiveSelectedKeys === 'all') {\n      return selectAllLabel;\n    } else {\n      return selectedLabels.join(', ') || null;\n    }\n  }, [\n    renderSummary,\n    selectionMode,\n    selectedLabels,\n    effectiveSelectedKey,\n    effectiveSelectedKeys,\n    hasSelection,\n    placeholder,\n    selectAllLabel,\n  ]);\n\n  const showClearButton =\n    isClearable && hasSelection && !isDisabled && !props.isReadOnly;\n\n  const validationIcon = getValidationIcon({ isInvalid, isValid });\n\n  // Must be the SAME expression the trigger is painted with, not the raw\n  // `theme`: this tells an action which surface it sits on, and validation\n  // overrides the theme. With `theme=\"special\"` on an invalid field the trigger\n  // renders `danger` — a light surface — so forwarding `special` would hand the\n  // action the strong dark-purple alpha ramp and make hover/press read far too\n  // heavy.\n  const paintedTheme = getValidationTheme(theme, { isInvalid, isValid });\n  //\n  // It reaches the trailing actions through `ItemButton`'s wrapper, which is\n  // what provides `ItemActionContext` for a run rendered outside the button —\n  // so passing it as the trigger's `theme` is all that is needed.\n\n  if (validationIcon) {\n    suffix = (\n      <>\n        {suffix}\n        {validationIcon}\n      </>\n    );\n  }\n\n  // A caller's `rightIcon` keeps the `rightIcon` slot: it accepts a render\n  // function resolved against the trigger's mods, which only that slot does, and\n  // it is also what a caller's `RightIcon` styles target. It replaces the\n  // built-in control, exactly as before — including under `isLoading`, where the\n  // spinner replaces it in turn.\n  const hasCustomRightIcon = rightIcon !== undefined;\n  const triggerRightIcon = hasCustomRightIcon ? (\n    isLoading ? (\n      <LoadingIcon />\n    ) : (\n      rightIcon\n    )\n  ) : undefined;\n\n  // With a caller's own `rightIcon` the built-in control moves into that slot,\n  // leaving the run with whatever the caller passed — possibly nothing. `null`\n  // rather than nothing at all: the run stays in the markup, so the trigger does\n  // not restructure if actions arrive later, but the row stops counting it as\n  // end content. That is what keeps an icon-only trigger with `rightIcon={null}`\n  // square, as it was before the run existed.\n  const hasTriggerActions = !hasCustomRightIcon || !!actions;\n\n  // Everything trailing that is NOT the caller's own icon goes into the actions\n  // run — a sibling of the `<button>`, so the clear button is no longer nested\n  // inside one. See `TriggerActions`.\n  const triggerActions = (\n    <TriggerActions\n      actions={actions}\n      builtIn={\n        hasCustomRightIcon ? null : isLoading ? (\n          <TriggerIcon>\n            <LoadingIcon />\n          </TriggerIcon>\n        ) : showClearButton ? (\n          <ItemAction\n            icon={<CloseIcon />}\n            size={size}\n            qa=\"PickerClearButton\"\n            // No explicit `type`/`theme` — the default `current` type inherits\n            // the trigger's own text color, which already carries validation\n            // state here, so this renders exactly as the explicit theme did\n            // while also following a custom theme.\n            mods={{ pressed: false }}\n            onPress={clearValue}\n          />\n        ) : (\n          <TriggerIcon>\n            <DirectionIcon to={isPopoverOpen ? 'top' : 'bottom'} />\n          </TriggerIcon>\n        )\n      }\n    />\n  );\n\n  // Trigger element — plain JSX with no hooks.\n  const triggerElement = (\n    <ItemButton\n      ref={triggerRef as any}\n      data-popover-trigger\n      id={id}\n      qa={qa || 'PickerTrigger'}\n      type={type}\n      theme={paintedTheme}\n      size={size}\n      shape={shape}\n      isDisabled={isDisabled || isLoading}\n      data-input-type=\"picker\"\n      mods={{\n        placeholder: !hasSelection,\n        ...externalMods,\n      }}\n      icon={icon}\n      rightIcon={triggerRightIcon}\n      actions={hasTriggerActions ? triggerActions : null}\n      prefix={prefix}\n      suffix={suffix}\n      hotkeys={hotkeys}\n      tooltip={triggerTooltip}\n      description={triggerDescription}\n      descriptionPlacement={descriptionPlacement}\n      styles={triggerStyles}\n      {...keyboardProps}\n      aria-label={`${props['aria-label'] ?? props.label ?? ''}`}\n    >\n      {triggerContent}\n    </ItemButton>\n  );\n\n  // ---------------------------------------------------------------------------\n  // Selection change handler\n  // ---------------------------------------------------------------------------\n\n  const handleSelectionChange = useEvent((selection: any) => {\n    if (selectionMode === 'single') {\n      // With `disallowEmptySelection`, re-selecting the current item emits a\n      // duplicate event (see `allowDuplicateSelectionEvents` below). Close the\n      // popover but don't propagate the unchanged selection.\n      if (\n        disallowEmptySelection &&\n        selection != null &&\n        effectiveSelectedKey != null &&\n        String(selection) === String(effectiveSelectedKey)\n      ) {\n        handleOpenChange(false);\n        return;\n      }\n\n      if (!isControlledSingle) {\n        setInternalSelectedKey(selection as Key | null);\n      }\n    } else {\n      if (!isControlledMultiple) {\n        let normalized: 'all' | Key[] = selection;\n\n        if (selection === 'all') {\n          normalized = 'all';\n        } else if (Array.isArray(selection)) {\n          normalized = processSelectionArray(selection);\n        } else if (\n          selection &&\n          typeof selection === 'object' &&\n          selection instanceof Set\n        ) {\n          normalized = processSelectionArray(selection as Set<Key>);\n        }\n\n        setInternalSelectedKeys(normalized);\n      }\n    }\n\n    if (selectionMode === 'single') {\n      latestSelectionRef.current.single =\n        selection != null ? String(selection) : null;\n    } else {\n      if (selection === 'all') {\n        latestSelectionRef.current.multiple = [];\n      } else if (Array.isArray(selection)) {\n        latestSelectionRef.current.multiple = processSelectionArray(selection);\n      } else if (\n        selection &&\n        typeof selection === 'object' &&\n        selection instanceof Set\n      ) {\n        latestSelectionRef.current.multiple = processSelectionArray(\n          selection as Set<Key>,\n        );\n      } else {\n        latestSelectionRef.current.multiple = [];\n      }\n    }\n\n    onSelectionChange?.(selection);\n\n    if (selectionMode === 'single') {\n      handleOpenChange(false);\n    }\n  });\n\n  const handleEscape = useEvent(() => {\n    handleOpenChange(false);\n  });\n\n  const handleOptionClick = useEvent((key: Key) => {\n    if ((selectionMode === 'multiple' && isCheckable) || key === '__ALL__') {\n      handleOpenChange(false);\n    }\n  });\n\n  const pickerField = (\n    <PickerWrapper\n      styles={styles}\n      {...(filterBaseProps(otherProps, { eventProps: true }) as Record<\n        string,\n        unknown\n      >)}\n    >\n      <DialogTrigger\n        type=\"popover\"\n        placement=\"bottom start\"\n        isOpen={isPopoverOpen}\n        containerPadding={containerPadding}\n        shouldFlip={shouldFlip}\n        onOpenChange={handleOpenChange}\n      >\n        {triggerElement}\n        {() => (\n          <Dialog\n            qa=\"PickerOverlay\"\n            display=\"grid\"\n            styles={{\n              gridRows: '1sf',\n              width: 'max($overlay-min-width, 30x) max-content 50vw',\n              '$overlay-min-width': '30x',\n              ...popoverStyles,\n            }}\n            style={\n              triggerWidthRef.current\n                ? ({\n                    '--overlay-min-width': `${triggerWidthRef.current}px`,\n                  } as any)\n                : undefined\n            }\n          >\n            <FocusScope restoreFocus>\n              <ListBox\n                autoFocus\n                items={items ? (finalItems as typeof props.items) : undefined}\n                aria-label={`${props['aria-label'] ?? props.label ?? ''} ${t(\n                  'picker.pickerAriaLabel',\n                  'Picker',\n                )}`}\n                selectedKey={\n                  selectionMode === 'single' ? effectiveSelectedKey : undefined\n                }\n                selectedKeys={\n                  selectionMode === 'multiple'\n                    ? effectiveSelectedKeys\n                    : undefined\n                }\n                listStyles={listStyles}\n                optionStyles={optionStyles}\n                sectionStyles={sectionStyles}\n                headingStyles={headingStyles}\n                listRef={listRef}\n                disallowEmptySelection={disallowEmptySelection}\n                allowDuplicateSelectionEvents={\n                  selectionMode === 'single' && !!disallowEmptySelection\n                }\n                disabledKeys={disabledKeys}\n                focusOnHover={focusOnHover}\n                shouldFocusWrap={shouldFocusWrap}\n                selectionMode={selectionMode}\n                isInvalid={isInvalid}\n                isValid={isValid}\n                isDisabled={isDisabled}\n                isLoading={isLoading}\n                stateRef={internalListStateRef}\n                isCheckable={isCheckable}\n                shape=\"popover\"\n                showSelectAll={showSelectAll}\n                selectAllLabel={selectAllLabel}\n                header={header}\n                footer={footer}\n                headerStyles={headerStyles}\n                footerStyles={footerStyles}\n                qa={`${props.qa || 'Picker'}ListBox`}\n                allValueProps={allValueProps}\n                onEscape={handleEscape}\n                onOptionClick={handleOptionClick}\n                onSelectionChange={handleSelectionChange}\n              >\n                {children as CollectionChildren<T>}\n              </ListBox>\n            </FocusScope>\n          </Dialog>\n        )}\n      </DialogTrigger>\n    </PickerWrapper>\n  );\n\n  return wrapWithField<Omit<CubePickerProps<T>, 'children' | 'tooltip'>>(\n    pickerField,\n    ref as any,\n    props,\n  );\n}) as unknown as (<T>(\n  props: CubePickerProps<T> & { ref?: ForwardedRef<HTMLElement> },\n) => ReactElement) & {\n  Item: typeof ListBox.Item;\n  Section: typeof BaseSection;\n  Action: typeof ItemAction;\n};\n\nPicker.Item = ListBox.Item;\n\nPicker.Section = BaseSection;\n\nPicker.Action = ItemAction;\n\nObject.defineProperty(Picker, 'cubeInputType', {\n  value: 'Picker',\n  enumerable: false,\n  configurable: false,\n});\n"],"mappings":"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"}
+{"version":3,"file":"Picker.js","names":["Text","TriggerIcon","ItemButton","BaseSection"],"sources":["../../../../src/components/fields/Picker/Picker.tsx"],"sourcesContent":["import { CollectionChildren, FocusableRefValue } from '@react-types/shared';\nimport {\n  BASE_STYLES,\n  BasePropsWithoutChildren,\n  BaseStyleProps,\n  COLOR_STYLES,\n  ColorStyleProps,\n  filterBaseProps,\n  OUTER_STYLES,\n  OuterStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport {\n  ForwardedRef,\n  forwardRef,\n  MutableRefObject,\n  ReactElement,\n  ReactNode,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { FocusScope, Key } from 'react-aria';\nimport { Section as BaseSection, ListState, useListState } from 'react-stately';\n\nimport { useEvent } from '../../../_internal';\nimport { useWarn } from '../../../_internal/hooks/use-warn';\nimport { useI18n } from '../../../i18n';\nimport { CloseIcon } from '../../../icons/CloseIcon';\nimport { DirectionIcon } from '../../../icons/DirectionIcon';\nimport { LoadingIcon } from '../../../icons/LoadingIcon';\nimport { allowEscapeToPropagate } from '../../../utils/react/escapePropagation';\nimport { processSelectionArray } from '../../../utils/selection';\nimport { extractStyles } from '../../../utils/styles';\nimport { CubeItemButtonProps, ItemAction, ItemButton } from '../../actions';\nimport { CubeItemProps } from '../../content/Item';\nimport { Text } from '../../content/Text';\nimport {\n  getValidationIcon,\n  getValidationTheme,\n  useFieldProps,\n  wrapWithField,\n} from '../../form';\nimport { Dialog, DialogTrigger } from '../../overlays/Dialog';\nimport { CubeListBoxProps, ListBox } from '../ListBox/ListBox';\nimport { TriggerActions, TriggerIcon } from '../TriggerActions';\n\nimport type { KeyboardEvent as RAKeyboardEvent } from '@react-types/shared';\nimport type { FieldBaseProps } from '../../../shared';\n\nexport interface CubePickerProps<T>\n  extends Omit<\n      CubeListBoxProps<T>,\n      'size' | 'tooltip' | 'shape' | 'emptyLabel'\n    >,\n    Omit<CubeItemProps, 'children' | 'size'>,\n    BasePropsWithoutChildren,\n    BaseStyleProps,\n    OuterStyleProps,\n    ColorStyleProps,\n    Omit<\n      FieldBaseProps<\n        string | number | readonly (string | number)[] | null | undefined\n      >,\n      'tooltip'\n    >,\n    Pick<\n      CubeItemButtonProps,\n      | 'type'\n      | 'theme'\n      | 'icon'\n      | 'rightIcon'\n      | 'prefix'\n      | 'suffix'\n      | 'hotkeys'\n      | 'shape'\n    > {\n  /** Placeholder text when no selection is made */\n  placeholder?: string;\n  /** Size of the picker component */\n  size?: 'small' | 'medium' | 'large';\n  /** Custom styles for the list box popover */\n  listBoxStyles?: Styles;\n  /** Custom styles for the popover container */\n  popoverStyles?: Styles;\n  /** Custom styles for the trigger button */\n  triggerStyles?: Styles;\n  /** Whether to show checkboxes for multiple selection mode */\n  isCheckable?: boolean;\n  /** Whether to flip the popover placement */\n  shouldFlip?: boolean;\n  /** Minimum padding in pixels between the popover and viewport edges */\n  containerPadding?: number;\n  /** Tooltip for the trigger button (separate from field tooltip) */\n  triggerTooltip?: CubeItemProps['tooltip'];\n  /** Description for the trigger button (separate from field description) */\n  triggerDescription?: CubeItemProps['description'];\n\n  /**\n   * Custom renderer for the summary shown inside the trigger when there is a selection.\n   *\n   * For `selectionMode=\"multiple\"` the function receives:\n   *  - `selectedLabels`: array of labels of the selected items.\n   *  - `selectedKeys`: array of keys of the selected items or \"all\".\n   *\n   * For `selectionMode=\"single\"` the function receives:\n   *  - `selectedLabel`: label of the selected item.\n   *  - `selectedKey`: key of the selected item.\n   *\n   * The function should return a `ReactNode` that will be rendered inside the trigger.\n   * Set to `false` to hide the summary text completely.\n   */\n  renderSummary?:\n    | ((args: {\n        selectedLabels?: string[];\n        selectedKeys?: 'all' | (string | number)[];\n        selectedLabel?: string;\n        selectedKey?: string | number | null;\n        selectionMode?: 'single' | 'multiple';\n      }) => ReactNode)\n    | false;\n\n  /** Ref to access internal ListBox state */\n  listStateRef?: MutableRefObject<ListState<T>>;\n  /** Additional modifiers for styling the Picker */\n  mods?: Record<string, boolean>;\n  /** Whether the picker is clearable using a clear button in the rightIcon slot */\n  isClearable?: boolean;\n  /** Accessible name for the built-in clear button. Defaults to a localized \"Clear value\". */\n  clearLabel?: string;\n  /** Callback called when the clear button is pressed */\n  onClear?: () => void;\n  /**\n   * Custom actions rendered inside the trigger, to the left of the built-in\n   * clear button and dropdown caret. Use `Picker.Action` so they match the\n   * trigger's size and theme.\n   *\n   * Pressing one runs its handler without opening or closing the popover —\n   * including while the popover is open. Actions follow the trigger's disabled\n   * state but NOT `isReadOnly`, since a read-only field can still host an\n   * action that does not change the value; pass `isDisabled` yourself for one\n   * that does.\n   */\n  actions?: ReactNode;\n  /**\n   * Sort selected item(s) to the top when the popover opens.\n   * Only works when using the `items` prop (data-driven mode).\n   * Supports both single and multiple selection modes.\n   * @default true when items are provided, false when using JSX children\n   */\n  sortSelectedToTop?: boolean;\n  /** Callback called when the popover open state changes */\n  onOpenChange?: (isOpen: boolean) => void;\n}\n\nconst PROP_STYLES = [...BASE_STYLES, ...OUTER_STYLES, ...COLOR_STYLES];\n\nconst PickerWrapper = tasty({\n  qa: 'PickerWrapper',\n  styles: {\n    display: 'inline-grid',\n    flow: 'column',\n    gridRows: '1sf',\n    placeContent: 'stretch',\n    placeItems: 'stretch',\n  },\n});\n\nexport const Picker = forwardRef(function Picker<T extends object>(\n  props: CubePickerProps<T>,\n  ref: ForwardedRef<HTMLElement>,\n) {\n  const { t } = useI18n();\n\n  props = useFieldProps(props, {\n    valuePropsMapper: ({ value, onChange }) => {\n      const fieldProps: Record<string, unknown> = {};\n\n      if (props.selectionMode === 'multiple') {\n        fieldProps.selectedKeys = value || [];\n      } else {\n        fieldProps.selectedKey = value ?? null;\n      }\n\n      fieldProps.onSelectionChange = (key: Key | null | 'all' | Key[]) => {\n        if (props.selectionMode === 'multiple') {\n          // Handle \"all\" selection and array selections\n          if (key === 'all') {\n            onChange('all');\n          } else {\n            onChange(key ? (Array.isArray(key) ? key : [key]) : []);\n          }\n        } else {\n          onChange(Array.isArray(key) ? key[0] : key);\n        }\n      };\n\n      return fieldProps;\n    },\n  });\n\n  let {\n    id,\n    qa,\n    label,\n    extra,\n    icon,\n    rightIcon,\n    prefix,\n    suffix,\n    actions,\n    hotkeys,\n    triggerTooltip,\n    triggerDescription,\n    labelStyles,\n    isRequired,\n    necessityIndicator,\n    isInvalid,\n    isValid,\n    isDisabled,\n    isLoading,\n    message,\n    mods: externalMods,\n    description,\n    descriptionPlacement,\n    placeholder,\n    size = 'medium',\n    styles,\n    listBoxStyles,\n    popoverStyles,\n    type = 'outline',\n    theme = 'default',\n    shape,\n    labelSuffix,\n    shouldFocusWrap,\n    children,\n    shouldFlip = true,\n    containerPadding = 8,\n    selectedKey,\n    defaultSelectedKey,\n    selectedKeys,\n    defaultSelectedKeys,\n    disabledKeys,\n    onSelectionChange,\n    selectionMode = 'single',\n    listStateRef,\n    focusOnHover,\n    showSelectAll,\n    selectAllLabel = t('picker.all', 'All'),\n    items,\n    header,\n    footer,\n    headerStyles,\n    footerStyles,\n    triggerStyles,\n    renderSummary,\n    isCheckable,\n    allValueProps,\n    listStyles,\n    optionStyles,\n    sectionStyles,\n    headingStyles,\n    listRef,\n    disallowEmptySelection,\n    shouldUseVirtualFocus,\n    onEscape,\n    onOptionClick,\n    isClearable,\n    clearLabel,\n    onClear,\n    sortSelectedToTop,\n    onOpenChange,\n    listStateRef: externalListStateRef,\n    ...otherProps\n  } = props;\n\n  styles = extractStyles(otherProps, PROP_STYLES, styles);\n\n  // Warn if isCheckable is false in single selection mode\n  useWarn(isCheckable === false && selectionMode === 'single', {\n    key: ['picker-checkable-single-mode'],\n    args: [\n      'CubeUIKit: isCheckable=false is not recommended in single selection mode as it may confuse users about selection behavior.',\n    ],\n  });\n\n  // Internal selection state (uncontrolled scenario)\n  const [internalSelectedKey, setInternalSelectedKey] = useState<Key | null>(\n    defaultSelectedKey ?? null,\n  );\n  const [internalSelectedKeys, setInternalSelectedKeys] = useState<\n    'all' | Key[]\n  >(defaultSelectedKeys ?? []);\n\n  // Popover state — used as controlled prop for DialogTrigger\n  const [isPopoverOpen, setIsPopoverOpen] = useState(false);\n  const triggerRef = useRef<FocusableRefValue<HTMLButtonElement>>(null);\n  // Measured lazily on popover open instead of on every render\n  const triggerWidthRef = useRef<number | undefined>(undefined);\n\n  const isControlledSingle = selectedKey !== undefined;\n  const isControlledMultiple = selectedKeys !== undefined;\n\n  const effectiveSelectedKey = isControlledSingle\n    ? selectedKey\n    : internalSelectedKey;\n  const effectiveSelectedKeys = isControlledMultiple\n    ? selectedKeys\n    : internalSelectedKeys;\n\n  // Ref to access internal ListBox state for collection API\n  const internalListStateRef = useRef<ListState<T>>(null);\n\n  // Sync internal ref with external ref if provided\n  useEffect(() => {\n    if (externalListStateRef && internalListStateRef.current) {\n      externalListStateRef.current = internalListStateRef.current;\n    }\n  }, [externalListStateRef]);\n\n  // Cache for sorted items array when using `items` prop\n  const cachedItemsOrder = useRef<T[] | null>(null);\n\n  const latestSelectionRef = useRef<{\n    single: string | null;\n    multiple: string[];\n  }>({\n    single: effectiveSelectedKey != null ? String(effectiveSelectedKey) : null,\n    multiple:\n      selectionMode === 'multiple' && effectiveSelectedKeys !== 'all'\n        ? (effectiveSelectedKeys || []).map(String)\n        : [],\n  });\n\n  useEffect(() => {\n    latestSelectionRef.current = {\n      single:\n        effectiveSelectedKey != null ? String(effectiveSelectedKey) : null,\n      multiple:\n        selectionMode === 'multiple' && effectiveSelectedKeys !== 'all'\n          ? (effectiveSelectedKeys || []).map(String)\n          : [],\n    };\n  }, [effectiveSelectedKey, effectiveSelectedKeys, selectionMode]);\n\n  const selectionWhenClosed = useRef<{\n    single: string | null;\n    multiple: string[];\n  }>({ single: null, multiple: [] });\n\n  const sortSelectedToTopExplicit = sortSelectedToTop !== undefined;\n  const shouldSortSelectedToTop = sortSelectedToTop ?? (items ? true : false);\n\n  useWarn(sortSelectedToTopExplicit && shouldSortSelectedToTop && !items, {\n    key: ['picker-sort-selected-to-top-children'],\n    args: [\n      'Picker: sortSelectedToTop only works with the items prop. Sorting will be skipped when using JSX children.',\n    ],\n  });\n\n  useEffect(() => {\n    cachedItemsOrder.current = null;\n  }, [items]);\n\n  useEffect(() => {\n    if (!isPopoverOpen) {\n      selectionWhenClosed.current = {\n        single:\n          effectiveSelectedKey != null ? String(effectiveSelectedKey) : null,\n        multiple:\n          selectionMode === 'multiple' && effectiveSelectedKeys !== 'all'\n            ? (effectiveSelectedKeys || []).map(String)\n            : [],\n      };\n    }\n  }, [\n    effectiveSelectedKey,\n    effectiveSelectedKeys,\n    isPopoverOpen,\n    selectionMode,\n  ]);\n\n  const finalItems = useMemo(() => {\n    if (!items || !shouldSortSelectedToTop) return items;\n    if (!isPopoverOpen) return items;\n    if (cachedItemsOrder.current) return cachedItemsOrder.current;\n\n    const selectedKeySet = new Set<string>();\n\n    if (selectionMode === 'multiple') {\n      if (\n        selectionWhenClosed.current.multiple.length === 0 ||\n        effectiveSelectedKeys === 'all'\n      ) {\n        return items;\n      }\n      selectionWhenClosed.current.multiple.forEach((k) =>\n        selectedKeySet.add(k),\n      );\n    } else if (selectionWhenClosed.current.single) {\n      selectedKeySet.add(selectionWhenClosed.current.single);\n    }\n\n    if (selectedKeySet.size === 0) return items;\n\n    const itemsArray = Array.isArray(items) ? items : Array.from(items);\n    const selectedItems: T[] = [];\n    const unselectedItems: T[] = [];\n\n    itemsArray.forEach((item) => {\n      const key = (item as any)?.key ?? (item as any)?.id;\n      if (key != null && selectedKeySet.has(String(key))) {\n        selectedItems.push(item);\n      } else {\n        unselectedItems.push(item);\n      }\n    });\n\n    const sorted = [...selectedItems, ...unselectedItems];\n\n    cachedItemsOrder.current = sorted;\n\n    return sorted;\n  }, [items, shouldSortSelectedToTop, selectionMode, isPopoverOpen]);\n\n  // Create local collection state for reading item data (labels, etc.)\n  // This allows us to read item labels even before the popover opens\n  const localCollectionState = useListState({\n    children,\n    items: finalItems, // Use sorted items to match what's shown in popover\n    selectionMode: 'none', // Don't manage selection in this state\n  });\n\n  const selectedLabels = useMemo(() => {\n    const collection = localCollectionState?.collection;\n\n    if (selectionMode === 'multiple' && effectiveSelectedKeys === 'all') {\n      if (!collection) return [];\n      const labels: string[] = [];\n      for (const item of collection) {\n        if (item.type === 'item') {\n          labels.push(item.textValue || String(item.key));\n        }\n      }\n      return labels;\n    }\n\n    const keysToGet =\n      selectionMode === 'multiple' && effectiveSelectedKeys !== 'all'\n        ? effectiveSelectedKeys || []\n        : effectiveSelectedKey != null\n          ? [effectiveSelectedKey]\n          : [];\n\n    return keysToGet\n      .map((key) => {\n        const item = collection?.getItem(key);\n        return item?.textValue || String(key);\n      })\n      .filter(Boolean);\n  }, [\n    selectionMode,\n    effectiveSelectedKeys,\n    effectiveSelectedKey,\n    localCollectionState?.collection,\n  ]);\n\n  const hasSelection = selectedLabels.length > 0;\n\n  // ---------------------------------------------------------------------------\n  // Popover lifecycle — all effects moved out of the inline renderTrigger\n  // function so they have a stable component identity and don't tear\n  // down/setup on every parent re-render.\n  // DialogTrigger is controlled via isOpen/onOpenChange.\n  // ---------------------------------------------------------------------------\n\n  const handleOpenChange = useEvent((isOpen: boolean) => {\n    if (isOpen === isPopoverOpen) return;\n\n    if (isOpen) {\n      triggerWidthRef.current =\n        triggerRef?.current?.UNSAFE_getDOMNode()?.offsetWidth;\n    }\n    setIsPopoverOpen(isOpen);\n    if (!isOpen) {\n      selectionWhenClosed.current = { ...latestSelectionRef.current };\n      cachedItemsOrder.current = null;\n    }\n    onOpenChange?.(isOpen);\n  });\n\n  // Popover sync is handled by the inner `DialogTrigger` (type=\"popover\").\n\n  // Keyboard handler for arrow keys to open popover\n  // Deliberately NOT `useKeyboard`. `ItemButton` already runs whatever\n  // `onKeyDown` it is given through `useFocusable`'s own `useKeyboard`, and a\n  // second wrapper here would leave `continuePropagation()` releasing only the\n  // inner one while the outer still stopped the event — `Escape` reached the\n  // trigger and died there (CUB-4839). Handed over plain, this IS the outer\n  // wrapper's handler, so the opt-out applies to the event that travels.\n  const keyboardProps = {\n    onKeyDown: (e: RAKeyboardEvent) => {\n      allowEscapeToPropagate(e);\n\n      if ((e.key === 'ArrowUp' || e.key === 'ArrowDown') && !isPopoverOpen) {\n        e.preventDefault();\n        handleOpenChange(true);\n\n        return;\n      }\n    },\n  };\n\n  // Clear handler\n  const clearValue = useEvent(() => {\n    if (selectionMode === 'multiple') {\n      if (!isControlledMultiple) {\n        setInternalSelectedKeys([]);\n      }\n      onSelectionChange?.([]);\n    } else {\n      if (!isControlledSingle) {\n        setInternalSelectedKey(null);\n      }\n      onSelectionChange?.(null);\n    }\n\n    handleOpenChange(false);\n    triggerRef?.current?.focus?.();\n    onClear?.();\n\n    return false;\n  });\n\n  // ---------------------------------------------------------------------------\n  // Trigger content\n  // ---------------------------------------------------------------------------\n\n  const triggerContent = useMemo((): ReactNode => {\n    if (typeof renderSummary === 'function') {\n      if (selectionMode === 'single') {\n        return renderSummary({\n          selectedLabel: selectedLabels[0],\n          selectedKey: effectiveSelectedKey ?? null,\n          selectedLabels,\n          selectedKeys: effectiveSelectedKeys,\n          selectionMode: 'single',\n        });\n      }\n\n      return renderSummary({\n        selectedLabels,\n        selectedKeys: effectiveSelectedKeys,\n        selectionMode: 'multiple',\n      });\n    } else if (renderSummary === false) {\n      return null;\n    }\n\n    if (!hasSelection) {\n      return <Text.Placeholder>{placeholder}</Text.Placeholder>;\n    } else if (selectionMode === 'single') {\n      return selectedLabels[0] || null;\n    } else if (effectiveSelectedKeys === 'all') {\n      return selectAllLabel;\n    } else {\n      return selectedLabels.join(', ') || null;\n    }\n  }, [\n    renderSummary,\n    selectionMode,\n    selectedLabels,\n    effectiveSelectedKey,\n    effectiveSelectedKeys,\n    hasSelection,\n    placeholder,\n    selectAllLabel,\n  ]);\n\n  const showClearButton =\n    isClearable && hasSelection && !isDisabled && !props.isReadOnly;\n\n  const validationIcon = getValidationIcon({ isInvalid, isValid });\n\n  // Must be the SAME expression the trigger is painted with, not the raw\n  // `theme`: this tells an action which surface it sits on, and validation\n  // overrides the theme. With `theme=\"special\"` on an invalid field the trigger\n  // renders `danger` — a light surface — so forwarding `special` would hand the\n  // action the strong dark-purple alpha ramp and make hover/press read far too\n  // heavy.\n  const paintedTheme = getValidationTheme(theme, { isInvalid, isValid });\n  //\n  // It reaches the trailing actions through `ItemButton`'s wrapper, which is\n  // what provides `ItemActionContext` for a run rendered outside the button —\n  // so passing it as the trigger's `theme` is all that is needed.\n\n  if (validationIcon) {\n    suffix = (\n      <>\n        {suffix}\n        {validationIcon}\n      </>\n    );\n  }\n\n  // A caller's `rightIcon` keeps the `rightIcon` slot: it accepts a render\n  // function resolved against the trigger's mods, which only that slot does, and\n  // it is also what a caller's `RightIcon` styles target. It replaces the\n  // built-in control, exactly as before — including under `isLoading`, where the\n  // spinner replaces it in turn.\n  const hasCustomRightIcon = rightIcon !== undefined;\n  const triggerRightIcon = hasCustomRightIcon ? (\n    isLoading ? (\n      <LoadingIcon />\n    ) : (\n      rightIcon\n    )\n  ) : undefined;\n\n  // With a caller's own `rightIcon` the built-in control moves into that slot,\n  // leaving the run with whatever the caller passed — possibly nothing. `null`\n  // rather than nothing at all: the run stays in the markup, so the trigger does\n  // not restructure if actions arrive later, but the row stops counting it as\n  // end content. That is what keeps an icon-only trigger with `rightIcon={null}`\n  // square, as it was before the run existed.\n  const hasTriggerActions = !hasCustomRightIcon || !!actions;\n\n  // Everything trailing that is NOT the caller's own icon goes into the actions\n  // run — a sibling of the `<button>`, so the clear button is no longer nested\n  // inside one. See `TriggerActions`.\n  const triggerActions = (\n    <TriggerActions\n      actions={actions}\n      builtIn={\n        hasCustomRightIcon ? null : isLoading ? (\n          <TriggerIcon>\n            <LoadingIcon />\n          </TriggerIcon>\n        ) : showClearButton ? (\n          <ItemAction\n            icon={<CloseIcon />}\n            size={size}\n            qa=\"PickerClearButton\"\n            // See `Select`: `ItemAction` names itself from `aria-label` or a\n            // string `tooltip`, and warns for neither.\n            aria-label={clearLabel ?? t('picker.clearValue', 'Clear value')}\n            // No explicit `type`/`theme` — the default `current` type inherits\n            // the trigger's own text color, which already carries validation\n            // state here, so this renders exactly as the explicit theme did\n            // while also following a custom theme.\n            mods={{ pressed: false }}\n            onPress={clearValue}\n          />\n        ) : (\n          <TriggerIcon>\n            <DirectionIcon to={isPopoverOpen ? 'top' : 'bottom'} />\n          </TriggerIcon>\n        )\n      }\n    />\n  );\n\n  // Trigger element — plain JSX with no hooks.\n  const triggerElement = (\n    <ItemButton\n      ref={triggerRef as any}\n      data-popover-trigger\n      id={id}\n      qa={qa || 'PickerTrigger'}\n      type={type}\n      theme={paintedTheme}\n      size={size}\n      shape={shape}\n      isDisabled={isDisabled || isLoading}\n      data-input-type=\"picker\"\n      mods={{\n        placeholder: !hasSelection,\n        ...externalMods,\n      }}\n      icon={icon}\n      rightIcon={triggerRightIcon}\n      actions={hasTriggerActions ? triggerActions : null}\n      prefix={prefix}\n      suffix={suffix}\n      hotkeys={hotkeys}\n      tooltip={triggerTooltip}\n      description={triggerDescription}\n      descriptionPlacement={descriptionPlacement}\n      styles={triggerStyles}\n      {...keyboardProps}\n      aria-label={`${props['aria-label'] ?? props.label ?? ''}`}\n    >\n      {triggerContent}\n    </ItemButton>\n  );\n\n  // ---------------------------------------------------------------------------\n  // Selection change handler\n  // ---------------------------------------------------------------------------\n\n  const handleSelectionChange = useEvent((selection: any) => {\n    if (selectionMode === 'single') {\n      // With `disallowEmptySelection`, re-selecting the current item emits a\n      // duplicate event (see `allowDuplicateSelectionEvents` below). Close the\n      // popover but don't propagate the unchanged selection.\n      if (\n        disallowEmptySelection &&\n        selection != null &&\n        effectiveSelectedKey != null &&\n        String(selection) === String(effectiveSelectedKey)\n      ) {\n        handleOpenChange(false);\n        return;\n      }\n\n      if (!isControlledSingle) {\n        setInternalSelectedKey(selection as Key | null);\n      }\n    } else {\n      if (!isControlledMultiple) {\n        let normalized: 'all' | Key[] = selection;\n\n        if (selection === 'all') {\n          normalized = 'all';\n        } else if (Array.isArray(selection)) {\n          normalized = processSelectionArray(selection);\n        } else if (\n          selection &&\n          typeof selection === 'object' &&\n          selection instanceof Set\n        ) {\n          normalized = processSelectionArray(selection as Set<Key>);\n        }\n\n        setInternalSelectedKeys(normalized);\n      }\n    }\n\n    if (selectionMode === 'single') {\n      latestSelectionRef.current.single =\n        selection != null ? String(selection) : null;\n    } else {\n      if (selection === 'all') {\n        latestSelectionRef.current.multiple = [];\n      } else if (Array.isArray(selection)) {\n        latestSelectionRef.current.multiple = processSelectionArray(selection);\n      } else if (\n        selection &&\n        typeof selection === 'object' &&\n        selection instanceof Set\n      ) {\n        latestSelectionRef.current.multiple = processSelectionArray(\n          selection as Set<Key>,\n        );\n      } else {\n        latestSelectionRef.current.multiple = [];\n      }\n    }\n\n    onSelectionChange?.(selection);\n\n    if (selectionMode === 'single') {\n      handleOpenChange(false);\n    }\n  });\n\n  const handleEscape = useEvent(() => {\n    handleOpenChange(false);\n  });\n\n  const handleOptionClick = useEvent((key: Key) => {\n    if ((selectionMode === 'multiple' && isCheckable) || key === '__ALL__') {\n      handleOpenChange(false);\n    }\n  });\n\n  const pickerField = (\n    <PickerWrapper\n      styles={styles}\n      {...(filterBaseProps(otherProps, { eventProps: true }) as Record<\n        string,\n        unknown\n      >)}\n    >\n      <DialogTrigger\n        type=\"popover\"\n        placement=\"bottom start\"\n        isOpen={isPopoverOpen}\n        containerPadding={containerPadding}\n        shouldFlip={shouldFlip}\n        onOpenChange={handleOpenChange}\n      >\n        {triggerElement}\n        {() => (\n          <Dialog\n            qa=\"PickerOverlay\"\n            display=\"grid\"\n            styles={{\n              gridRows: '1sf',\n              width: 'max($overlay-min-width, 30x) max-content 50vw',\n              '$overlay-min-width': '30x',\n              ...popoverStyles,\n            }}\n            style={\n              triggerWidthRef.current\n                ? ({\n                    '--overlay-min-width': `${triggerWidthRef.current}px`,\n                  } as any)\n                : undefined\n            }\n          >\n            <FocusScope restoreFocus>\n              <ListBox\n                autoFocus\n                items={items ? (finalItems as typeof props.items) : undefined}\n                aria-label={`${props['aria-label'] ?? props.label ?? ''} ${t(\n                  'picker.pickerAriaLabel',\n                  'Picker',\n                )}`}\n                selectedKey={\n                  selectionMode === 'single' ? effectiveSelectedKey : undefined\n                }\n                selectedKeys={\n                  selectionMode === 'multiple'\n                    ? effectiveSelectedKeys\n                    : undefined\n                }\n                listStyles={listStyles}\n                optionStyles={optionStyles}\n                sectionStyles={sectionStyles}\n                headingStyles={headingStyles}\n                listRef={listRef}\n                disallowEmptySelection={disallowEmptySelection}\n                allowDuplicateSelectionEvents={\n                  selectionMode === 'single' && !!disallowEmptySelection\n                }\n                disabledKeys={disabledKeys}\n                focusOnHover={focusOnHover}\n                shouldFocusWrap={shouldFocusWrap}\n                selectionMode={selectionMode}\n                isInvalid={isInvalid}\n                isValid={isValid}\n                isDisabled={isDisabled}\n                isLoading={isLoading}\n                stateRef={internalListStateRef}\n                isCheckable={isCheckable}\n                shape=\"popover\"\n                showSelectAll={showSelectAll}\n                selectAllLabel={selectAllLabel}\n                header={header}\n                footer={footer}\n                headerStyles={headerStyles}\n                footerStyles={footerStyles}\n                qa={`${props.qa || 'Picker'}ListBox`}\n                allValueProps={allValueProps}\n                onEscape={handleEscape}\n                onOptionClick={handleOptionClick}\n                onSelectionChange={handleSelectionChange}\n              >\n                {children as CollectionChildren<T>}\n              </ListBox>\n            </FocusScope>\n          </Dialog>\n        )}\n      </DialogTrigger>\n    </PickerWrapper>\n  );\n\n  return wrapWithField<Omit<CubePickerProps<T>, 'children' | 'tooltip'>>(\n    pickerField,\n    ref as any,\n    props,\n  );\n}) as unknown as (<T>(\n  props: CubePickerProps<T> & { ref?: ForwardedRef<HTMLElement> },\n) => ReactElement) & {\n  Item: typeof ListBox.Item;\n  Section: typeof BaseSection;\n  Action: typeof ItemAction;\n};\n\nPicker.Item = ListBox.Item;\n\nPicker.Section = BaseSection;\n\nPicker.Action = ItemAction;\n\nObject.defineProperty(Picker, 'cubeInputType', {\n  value: 'Picker',\n  enumerable: false,\n  configurable: false,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6JA,MAAM,cAAc;CAAC,GAAG;CAAa,GAAG;CAAc,GAAG;CAAa;AAEtE,MAAM,gBAAgB,MAAM;CAC1B,IAAI;CACJ,QAAQ;EACN,SAAS;EACT,MAAM;EACN,UAAU;EACV,cAAc;EACd,YAAY;EACb;CACF,CAAC;AAEF,MAAa,SAAS,WAAW,SAAS,OACxC,OACA,KACA;CACA,MAAM,EAAE,MAAM,SAAS;AAEvB,SAAQ,cAAc,OAAO,EAC3B,mBAAmB,EAAE,OAAO,eAAe;EACzC,MAAM,aAAsC,EAAE;AAE9C,MAAI,MAAM,kBAAkB,WAC1B,YAAW,eAAe,SAAS,EAAE;MAErC,YAAW,cAAc,SAAS;AAGpC,aAAW,qBAAqB,QAAoC;AAClE,OAAI,MAAM,kBAAkB,WAE1B,KAAI,QAAQ,MACV,UAAS,MAAM;OAEf,UAAS,MAAO,MAAM,QAAQ,IAAI,GAAG,MAAM,CAAC,IAAI,GAAI,EAAE,CAAC;OAGzD,UAAS,MAAM,QAAQ,IAAI,GAAG,IAAI,KAAK,IAAI;;AAI/C,SAAO;IAEV,CAAC;CAEF,IAAI,EACF,IACA,IACA,OACA,OACA,MACA,WACA,QACA,QACA,SACA,SACA,gBACA,oBACA,aACA,YACA,oBACA,WACA,SACA,YACA,WACA,SACA,MAAM,cACN,aACA,sBACA,aACA,OAAO,UACP,QACA,eACA,eACA,OAAO,WACP,QAAQ,WACR,OACA,aACA,iBACA,UACA,aAAa,MACb,mBAAmB,GACnB,aACA,oBACA,cACA,qBACA,cACA,mBACA,gBAAgB,UAChB,cACA,cACA,eACA,iBAAiB,EAAE,cAAc,MAAM,EACvC,OACA,QACA,QACA,cACA,cACA,eACA,eACA,aACA,eACA,YACA,cACA,eACA,eACA,SACA,wBACA,uBACA,UACA,eACA,aACA,YACA,SACA,mBACA,cACA,cAAc,sBACd,GAAG,eACD;AAEJ,UAAS,cAAc,YAAY,aAAa,OAAO;AAGvD,SAAQ,gBAAgB,SAAS,kBAAkB,UAAU;EAC3D,KAAK,CAAC,+BAA+B;EACrC,MAAM,CACJ,6HACD;EACF,CAAC;CAGF,MAAM,CAAC,qBAAqB,0BAA0B,SACpD,sBAAsB,KACvB;CACD,MAAM,CAAC,sBAAsB,2BAA2B,SAEtD,uBAAuB,EAAE,CAAC;CAG5B,MAAM,CAAC,eAAe,oBAAoB,SAAS,MAAM;CACzD,MAAM,aAAa,OAA6C,KAAK;CAErE,MAAM,kBAAkB,OAA2B,OAAU;CAE7D,MAAM,qBAAqB,gBAAgB;CAC3C,MAAM,uBAAuB,iBAAiB;CAE9C,MAAM,uBAAuB,qBACzB,cACA;CACJ,MAAM,wBAAwB,uBAC1B,eACA;CAGJ,MAAM,uBAAuB,OAAqB,KAAK;AAGvD,iBAAgB;AACd,MAAI,wBAAwB,qBAAqB,QAC/C,sBAAqB,UAAU,qBAAqB;IAErD,CAAC,qBAAqB,CAAC;CAG1B,MAAM,mBAAmB,OAAmB,KAAK;CAEjD,MAAM,qBAAqB,OAGxB;EACD,QAAQ,wBAAwB,OAAO,OAAO,qBAAqB,GAAG;EACtE,UACE,kBAAkB,cAAc,0BAA0B,SACrD,yBAAyB,EAAE,EAAE,IAAI,OAAO,GACzC,EAAE;EACT,CAAC;AAEF,iBAAgB;AACd,qBAAmB,UAAU;GAC3B,QACE,wBAAwB,OAAO,OAAO,qBAAqB,GAAG;GAChE,UACE,kBAAkB,cAAc,0BAA0B,SACrD,yBAAyB,EAAE,EAAE,IAAI,OAAO,GACzC,EAAE;GACT;IACA;EAAC;EAAsB;EAAuB;EAAc,CAAC;CAEhE,MAAM,sBAAsB,OAGzB;EAAE,QAAQ;EAAM,UAAU,EAAE;EAAE,CAAC;CAElC,MAAM,4BAA4B,sBAAsB;CACxD,MAAM,0BAA0B,sBAAsB,QAAQ,OAAO;AAErE,SAAQ,6BAA6B,2BAA2B,CAAC,OAAO;EACtE,KAAK,CAAC,uCAAuC;EAC7C,MAAM,CACJ,6GACD;EACF,CAAC;AAEF,iBAAgB;AACd,mBAAiB,UAAU;IAC1B,CAAC,MAAM,CAAC;AAEX,iBAAgB;AACd,MAAI,CAAC,cACH,qBAAoB,UAAU;GAC5B,QACE,wBAAwB,OAAO,OAAO,qBAAqB,GAAG;GAChE,UACE,kBAAkB,cAAc,0BAA0B,SACrD,yBAAyB,EAAE,EAAE,IAAI,OAAO,GACzC,EAAE;GACT;IAEF;EACD;EACA;EACA;EACA;EACD,CAAC;CAEF,MAAM,aAAa,cAAc;AAC/B,MAAI,CAAC,SAAS,CAAC,wBAAyB,QAAO;AAC/C,MAAI,CAAC,cAAe,QAAO;AAC3B,MAAI,iBAAiB,QAAS,QAAO,iBAAiB;EAEtD,MAAM,iCAAiB,IAAI,KAAa;AAExC,MAAI,kBAAkB,YAAY;AAChC,OACE,oBAAoB,QAAQ,SAAS,WAAW,KAChD,0BAA0B,MAE1B,QAAO;AAET,uBAAoB,QAAQ,SAAS,SAAS,MAC5C,eAAe,IAAI,EAAE,CACtB;aACQ,oBAAoB,QAAQ,OACrC,gBAAe,IAAI,oBAAoB,QAAQ,OAAO;AAGxD,MAAI,eAAe,SAAS,EAAG,QAAO;EAEtC,MAAM,aAAa,MAAM,QAAQ,MAAM,GAAG,QAAQ,MAAM,KAAK,MAAM;EACnE,MAAM,gBAAqB,EAAE;EAC7B,MAAM,kBAAuB,EAAE;AAE/B,aAAW,SAAS,SAAS;GAC3B,MAAM,MAAO,MAAc,OAAQ,MAAc;AACjD,OAAI,OAAO,QAAQ,eAAe,IAAI,OAAO,IAAI,CAAC,CAChD,eAAc,KAAK,KAAK;OAExB,iBAAgB,KAAK,KAAK;IAE5B;EAEF,MAAM,SAAS,CAAC,GAAG,eAAe,GAAG,gBAAgB;AAErD,mBAAiB,UAAU;AAE3B,SAAO;IACN;EAAC;EAAO;EAAyB;EAAe;EAAc,CAAC;CAIlE,MAAM,uBAAuB,aAAa;EACxC;EACA,OAAO;EACP,eAAe;EAChB,CAAC;CAEF,MAAM,iBAAiB,cAAc;EACnC,MAAM,aAAa,sBAAsB;AAEzC,MAAI,kBAAkB,cAAc,0BAA0B,OAAO;AACnE,OAAI,CAAC,WAAY,QAAO,EAAE;GAC1B,MAAM,SAAmB,EAAE;AAC3B,QAAK,MAAM,QAAQ,WACjB,KAAI,KAAK,SAAS,OAChB,QAAO,KAAK,KAAK,aAAa,OAAO,KAAK,IAAI,CAAC;AAGnD,UAAO;;AAUT,UANE,kBAAkB,cAAc,0BAA0B,QACtD,yBAAyB,EAAE,GAC3B,wBAAwB,OACtB,CAAC,qBAAqB,GACtB,EAAE,EAGP,KAAK,QAAQ;AAEZ,WADa,YAAY,QAAQ,IAAI,GACxB,aAAa,OAAO,IAAI;IACrC,CACD,OAAO,QAAQ;IACjB;EACD;EACA;EACA;EACA,sBAAsB;EACvB,CAAC;CAEF,MAAM,eAAe,eAAe,SAAS;CAS7C,MAAM,mBAAmB,UAAU,WAAoB;AACrD,MAAI,WAAW,cAAe;AAE9B,MAAI,OACF,iBAAgB,UACd,YAAY,SAAS,mBAAmB,EAAE;AAE9C,mBAAiB,OAAO;AACxB,MAAI,CAAC,QAAQ;AACX,uBAAoB,UAAU,EAAE,GAAG,mBAAmB,SAAS;AAC/D,oBAAiB,UAAU;;AAE7B,iBAAe,OAAO;GACtB;CAWF,MAAM,gBAAgB,EACpB,YAAY,MAAuB;AACjC,yBAAuB,EAAE;AAEzB,OAAK,EAAE,QAAQ,aAAa,EAAE,QAAQ,gBAAgB,CAAC,eAAe;AACpE,KAAE,gBAAgB;AAClB,oBAAiB,KAAK;AAEtB;;IAGL;CAGD,MAAM,aAAa,eAAe;AAChC,MAAI,kBAAkB,YAAY;AAChC,OAAI,CAAC,qBACH,yBAAwB,EAAE,CAAC;AAE7B,uBAAoB,EAAE,CAAC;SAClB;AACL,OAAI,CAAC,mBACH,wBAAuB,KAAK;AAE9B,uBAAoB,KAAK;;AAG3B,mBAAiB,MAAM;AACvB,cAAY,SAAS,SAAS;AAC9B,aAAW;AAEX,SAAO;GACP;CAMF,MAAM,iBAAiB,cAAyB;AAC9C,MAAI,OAAO,kBAAkB,YAAY;AACvC,OAAI,kBAAkB,SACpB,QAAO,cAAc;IACnB,eAAe,eAAe;IAC9B,aAAa,wBAAwB;IACrC;IACA,cAAc;IACd,eAAe;IAChB,CAAC;AAGJ,UAAO,cAAc;IACnB;IACA,cAAc;IACd,eAAe;IAChB,CAAC;aACO,kBAAkB,MAC3B,QAAO;AAGT,MAAI,CAAC,aACH,QAAO,oBAACA,MAAK,yBAAa,cAA+B;WAChD,kBAAkB,SAC3B,QAAO,eAAe,MAAM;WACnB,0BAA0B,MACnC,QAAO;MAEP,QAAO,eAAe,KAAK,KAAK,IAAI;IAErC;EACD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;CAEF,MAAM,kBACJ,eAAe,gBAAgB,CAAC,cAAc,CAAC,MAAM;CAEvD,MAAM,iBAAiB,kBAAkB;EAAE;EAAW;EAAS,CAAC;CAQhE,MAAM,eAAe,mBAAmB,OAAO;EAAE;EAAW;EAAS,CAAC;AAMtE,KAAI,eACF,UACE,8CACG,QACA,kBACA;CASP,MAAM,qBAAqB,cAAc;CACzC,MAAM,mBAAmB,qBACvB,YACE,oBAAC,gBAAc,GAEf,YAEA;CAQJ,MAAM,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;CAKnD,MAAM,iBACJ,oBAAC;EACU;EACT,SACE,qBAAqB,OAAO,YAC1B,oBAACC,4BACC,oBAAC,gBAAc,GACH,GACZ,kBACF,oBAAC;GACC,MAAM,oBAAC,cAAY;GACb;GACN,IAAG;GAGH,cAAY,cAAc,EAAE,qBAAqB,cAAc;GAK/D,MAAM,EAAE,SAAS,OAAO;GACxB,SAAS;IACT,GAEF,oBAACA,4BACC,oBAAC,iBAAc,IAAI,gBAAgB,QAAQ,WAAY,GAC3C;GAGlB;CAIJ,MAAM,iBACJ,oBAACC;EACC,KAAK;EACL;EACI;EACJ,IAAI,MAAM;EACJ;EACN,OAAO;EACD;EACC;EACP,YAAY,cAAc;EAC1B,mBAAgB;EAChB,MAAM;GACJ,aAAa,CAAC;GACd,GAAG;GACJ;EACK;EACN,WAAW;EACX,SAAS,oBAAoB,iBAAiB;EACtC;EACA;EACC;EACT,SAAS;EACT,aAAa;EACS;EACtB,QAAQ;EACR,GAAI;EACJ,cAAY,GAAG,MAAM,iBAAiB,MAAM,SAAS;YAEpD;GACU;CAOf,MAAM,wBAAwB,UAAU,cAAmB;AACzD,MAAI,kBAAkB,UAAU;AAI9B,OACE,0BACA,aAAa,QACb,wBAAwB,QACxB,OAAO,UAAU,KAAK,OAAO,qBAAqB,EAClD;AACA,qBAAiB,MAAM;AACvB;;AAGF,OAAI,CAAC,mBACH,wBAAuB,UAAwB;aAG7C,CAAC,sBAAsB;GACzB,IAAI,aAA4B;AAEhC,OAAI,cAAc,MAChB,cAAa;YACJ,MAAM,QAAQ,UAAU,CACjC,cAAa,sBAAsB,UAAU;YAE7C,aACA,OAAO,cAAc,YACrB,qBAAqB,IAErB,cAAa,sBAAsB,UAAsB;AAG3D,2BAAwB,WAAW;;AAIvC,MAAI,kBAAkB,SACpB,oBAAmB,QAAQ,SACzB,aAAa,OAAO,OAAO,UAAU,GAAG;WAEtC,cAAc,MAChB,oBAAmB,QAAQ,WAAW,EAAE;WAC/B,MAAM,QAAQ,UAAU,CACjC,oBAAmB,QAAQ,WAAW,sBAAsB,UAAU;WAEtE,aACA,OAAO,cAAc,YACrB,qBAAqB,IAErB,oBAAmB,QAAQ,WAAW,sBACpC,UACD;MAED,oBAAmB,QAAQ,WAAW,EAAE;AAI5C,sBAAoB,UAAU;AAE9B,MAAI,kBAAkB,SACpB,kBAAiB,MAAM;GAEzB;CAEF,MAAM,eAAe,eAAe;AAClC,mBAAiB,MAAM;GACvB;CAEF,MAAM,oBAAoB,UAAU,QAAa;AAC/C,MAAK,kBAAkB,cAAc,eAAgB,QAAQ,UAC3D,kBAAiB,MAAM;GAEzB;AA8FF,QAAO,cA3FL,oBAAC;EACS;EACR,GAAK,gBAAgB,YAAY,EAAE,YAAY,MAAM,CAAC;YAKtD,qBAAC;GACC,MAAK;GACL,WAAU;GACV,QAAQ;GACU;GACN;GACZ,cAAc;cAEb,sBAEC,oBAAC;IACC,IAAG;IACH,SAAQ;IACR,QAAQ;KACN,UAAU;KACV,OAAO;KACP,sBAAsB;KACtB,GAAG;KACJ;IACD,OACE,gBAAgB,UACX,EACC,uBAAuB,GAAG,gBAAgB,QAAQ,KACnD,GACD;cAGN,oBAAC;KAAW;eACV,oBAAC;MACC;MACA,OAAO,QAAS,aAAoC;MACpD,cAAY,GAAG,MAAM,iBAAiB,MAAM,SAAS,GAAG,GAAG,EACzD,0BACA,SACD;MACD,aACE,kBAAkB,WAAW,uBAAuB;MAEtD,cACE,kBAAkB,aACd,wBACA;MAEM;MACE;MACC;MACA;MACN;MACe;MACxB,+BACE,kBAAkB,YAAY,CAAC,CAAC;MAEpB;MACA;MACG;MACF;MACJ;MACF;MACG;MACD;MACX,UAAU;MACG;MACb,OAAM;MACS;MACC;MACR;MACA;MACM;MACA;MACd,IAAI,GAAG,MAAM,MAAM,SAAS;MACb;MACf,UAAU;MACV,eAAe;MACf,mBAAmB;MAElB;OACO;MACC;KACN;IAEG;GACF,EAKhB,KACA,MACD;EACD;AAQF,OAAO,OAAO,QAAQ;AAEtB,OAAO,UAAUC;AAEjB,OAAO,SAAS;AAEhB,OAAO,eAAe,QAAQ,iBAAiB;CAC7C,OAAO;CACP,YAAY;CACZ,cAAc;CACf,CAAC"}

package/dist/components/fields/RadioGroup/Radio.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useFocus as useFocus$1 } from "../../../utils/react/interactions.js";

package/dist/components/fields/RadioGroup/RadioGroup.d.ts

@@ -8,7 +8,7 @@ import * as react from "react";
 import { AriaRadioGroupProps } from "react-aria";
 
 //#region src/components/fields/RadioGroup/RadioGroup.d.ts
-interface CubeRadioGroupProps extends BaseProps, Omit<AriaRadioGroupProps, 'errorMessage' | 'form'>, ContainerStyleProps, FieldBaseProps {
+interface CubeRadioGroupProps extends BaseProps, Omit<AriaRadioGroupProps, 'errorMessage' | 'form' | 'name'>, ContainerStyleProps, FieldBaseProps<string | null | undefined> {
   groupStyles?: Styles;
   orientation?: 'horizontal' | 'vertical';
   value?: string;

package/dist/components/fields/RadioGroup/RadioGroup.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { castNullableStringValue } from "../../../utils/react/nullableValue.js";

package/dist/components/fields/RadioGroup/RadioGroup.js.map

@@ -1 +1 @@
-{"version":3,"file":"RadioGroup.js","names":["mergeProps"],"sources":["../../../../src/components/fields/RadioGroup/RadioGroup.tsx"],"sourcesContent":["import { useObjectRef } from '@react-aria/utils';\nimport {\n  BaseProps,\n  CONTAINER_STYLES,\n  ContainerStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport { forwardRef } from 'react';\nimport { AriaRadioGroupProps, useFocusRing, useRadioGroup } from 'react-aria';\nimport { useRadioGroupState } from 'react-stately';\n\nimport { FieldBaseProps } from '../../../shared';\nimport { mergeProps } from '../../../utils/react';\nimport {\n  castNullableStringValue,\n  WithNullableValue,\n} from '../../../utils/react/nullableValue';\nimport { extractStyles } from '../../../utils/styles';\nimport { CubeItemProps } from '../../content/Item/Item';\nimport { FormScopeMask, useFieldProps, wrapWithField } from '../../form';\n\nimport { RadioContext } from './context';\n\nexport interface CubeRadioGroupProps\n  extends BaseProps,\n    Omit<AriaRadioGroupProps, 'errorMessage' | 'form'>,\n    ContainerStyleProps,\n    FieldBaseProps {\n  groupStyles?: Styles;\n  orientation?: 'horizontal' | 'vertical';\n  value?: string;\n  defaultValue?: string;\n  onChange?: (value: string) => void;\n  /* Size for all radio buttons in the group */\n  size?: Omit<CubeItemProps['size'], 'inline'>;\n  /* Button type for all button-style radios (ignored in tabs mode). When set to 'primary', selected buttons use 'primary' and non-selected use 'outline' with isSelected appearance */\n  buttonType?: CubeItemProps['type'];\n  /* Visual type for all radios in the group: radio (default), button, or tabs */\n  type?: 'radio' | 'button' | 'tabs';\n}\n\nconst RadioGroupElement = tasty({\n  qa: 'RadioGroup',\n  styles: {\n    display: 'flex',\n    placeItems: 'stretch',\n    placeContent: 'stretch',\n    flow: {\n      '': 'column',\n      horizontal: 'row wrap',\n      'horizontal & tabs': 'row',\n    },\n    padding: {\n      '': '0',\n      tabs: '.5x',\n    },\n    // The tabs layout is the only one with padding, and a caller that gives the\n    // group an explicit width (`width: 100%` inside a popover, say) means the\n    // box it can see. Without this the padding is added on top and the group\n    // overhangs its container by `1x`.\n    boxSizing: 'border-box',\n    radius: true,\n    fill: {\n      '': '#clear',\n      'tabs | disabled': '#surface-4',\n    },\n    width: 'max-content max-content initial',\n    flexShrink: 0,\n    gap: {\n      '': '1x',\n      button: 0,\n      tabs: '.5x',\n    },\n    whiteSpace: 'nowrap',\n    // Keyboard focus ring on the group, shown only for button/tabs layouts\n    // where individual items are visually merged (button-group) or share a\n    // single chrome (tabs) — the classic vertical radio list already shows\n    // a per-item focus ring on the radio circle.\n    outline: {\n      '': '1bw #primary-text.0 / 1bw',\n      'focused & (button | tabs)': '1bw #primary-text / 1bw',\n    },\n  },\n});\n\nfunction RadioGroup(props: WithNullableValue<CubeRadioGroupProps>, ref) {\n  let orientation = props.orientation;\n\n  props = castNullableStringValue(props);\n  props = useFieldProps(props, { defaultValidationTrigger: 'onChange' });\n\n  let {\n    qa,\n    id,\n    isDisabled,\n    isRequired,\n    labelPosition = 'top',\n    isInvalid,\n    isValid,\n    children,\n    styles,\n    groupStyles,\n    insideForm,\n    // orientation, // ignore orientation since it came from the form context\n    labelProps: baseLabelProps,\n    size,\n    buttonType,\n    type,\n    form,\n    ...otherProps\n  } = props;\n  let domRef = useObjectRef(ref);\n\n  styles = extractStyles(otherProps, CONTAINER_STYLES, styles);\n\n  let state = useRadioGroupState(props);\n\n  // Set default orientation based on type\n  if (orientation == null) {\n    orientation =\n      type === 'button' || type === 'tabs' ? 'horizontal' : 'vertical';\n  }\n\n  let { radioGroupProps: fieldProps, labelProps } = useRadioGroup(\n    { ...props, orientation },\n    state,\n  );\n\n  // Keyboard-only focus ring on the group container (button/tabs layouts).\n  // `within: true` tracks focus on any descendant radio. We read\n  // `isFocusVisible` (not `isFocused`), which is keyboard-gated — mouse\n  // clicks on a radio focus the input but leave `isFocusVisible` false.\n  let { isFocusVisible: isFocusWithinVisible, focusProps: groupFocusProps } =\n    useFocusRing({ within: true });\n\n  let radioGroup = (\n    <RadioGroupElement\n      id={id}\n      qa={qa || 'RadioGroup'}\n      styles={styles}\n      data-input-type=\"radiogroup\"\n      data-radio-button-group={type === 'button' ? '' : undefined}\n      mods={{\n        horizontal: orientation === 'horizontal',\n        'inside-form': insideForm,\n        'side-label': labelPosition === 'side',\n        button: type === 'button',\n        tabs: type === 'tabs',\n        focused: isFocusWithinVisible,\n      }}\n      {...groupFocusProps}\n    >\n      <FormScopeMask\n        value={{\n          isRequired,\n          isInvalid,\n          isValid,\n          isDisabled,\n        }}\n      >\n        <RadioContext.Provider\n          value={{\n            state,\n            name: props.name,\n            size,\n            buttonType,\n            type,\n            isDisabled,\n          }}\n        >\n          {children}\n        </RadioContext.Provider>\n      </FormScopeMask>\n    </RadioGroupElement>\n  );\n\n  return wrapWithField(radioGroup, domRef, {\n    ...props,\n    fieldProps,\n    labelProps: mergeProps(baseLabelProps, labelProps),\n  });\n}\n\n/**\n * Radio groups allow users to select a single option from a list of mutually exclusive options.\n * All possible options are exposed up front for users to compare.\n */\nconst _RadioGroup = forwardRef(RadioGroup);\n\n(_RadioGroup as any).cubeInputType = 'RadioGroup';\n_RadioGroup.displayName = 'RadioGroup';\n\nexport { _RadioGroup as RadioGroup };\n"],"mappings":";;;;;;;;;;;;;;;;AA0CA,MAAM,oBAAoB,MAAM;CAC9B,IAAI;CACJ,QAAQ;EACN,SAAS;EACT,YAAY;EACZ,cAAc;EACd,MAAM;GACJ,IAAI;GACJ,YAAY;GACZ,qBAAqB;GACtB;EACD,SAAS;GACP,IAAI;GACJ,MAAM;GACP;EAKD,WAAW;EACX,QAAQ;EACR,MAAM;GACJ,IAAI;GACJ,mBAAmB;GACpB;EACD,OAAO;EACP,YAAY;EACZ,KAAK;GACH,IAAI;GACJ,QAAQ;GACR,MAAM;GACP;EACD,YAAY;EAKZ,SAAS;GACP,IAAI;GACJ,6BAA6B;GAC9B;EACF;CACF,CAAC;AAEF,SAAS,WAAW,OAA+C,KAAK;CACtE,IAAI,cAAc,MAAM;AAExB,SAAQ,wBAAwB,MAAM;AACtC,SAAQ,cAAc,OAAO,EAAE,0BAA0B,YAAY,CAAC;CAEtE,IAAI,EACF,IACA,IACA,YACA,YACA,gBAAgB,OAChB,WACA,SACA,UACA,QACA,aACA,YAEA,YAAY,gBACZ,MACA,YACA,MACA,MACA,GAAG,eACD;CACJ,IAAI,SAAS,aAAa,IAAI;AAE9B,UAAS,cAAc,YAAY,kBAAkB,OAAO;CAE5D,IAAI,QAAQ,mBAAmB,MAAM;AAGrC,KAAI,eAAe,KACjB,eACE,SAAS,YAAY,SAAS,SAAS,eAAe;CAG1D,IAAI,EAAE,iBAAiB,YAAY,eAAe,cAChD;EAAE,GAAG;EAAO;EAAa,EACzB,MACD;CAMD,IAAI,EAAE,gBAAgB,sBAAsB,YAAY,oBACtD,aAAa,EAAE,QAAQ,MAAM,CAAC;AA2ChC,QAAO,cAxCL,oBAAC;EACK;EACJ,IAAI,MAAM;EACF;EACR,mBAAgB;EAChB,2BAAyB,SAAS,WAAW,KAAK;EAClD,MAAM;GACJ,YAAY,gBAAgB;GAC5B,eAAe;GACf,cAAc,kBAAkB;GAChC,QAAQ,SAAS;GACjB,MAAM,SAAS;GACf,SAAS;GACV;EACD,GAAI;YAEJ,oBAAC;GACC,OAAO;IACL;IACA;IACA;IACA;IACD;aAED,oBAAC,aAAa;IACZ,OAAO;KACL;KACA,MAAM,MAAM;KACZ;KACA;KACA;KACA;KACD;IAEA;KACqB;IACV;GACE,EAGW,QAAQ;EACvC,GAAG;EACH;EACA,YAAYA,aAAW,gBAAgB,WAAW;EACnD,CAAC;;;;;;AAOJ,MAAM,cAAc,WAAW,WAAW;AAE1C,AAAC,YAAoB,gBAAgB;AACrC,YAAY,cAAc"}
+{"version":3,"file":"RadioGroup.js","names":["mergeProps"],"sources":["../../../../src/components/fields/RadioGroup/RadioGroup.tsx"],"sourcesContent":["import { useObjectRef } from '@react-aria/utils';\nimport {\n  BaseProps,\n  CONTAINER_STYLES,\n  ContainerStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport { forwardRef } from 'react';\nimport { AriaRadioGroupProps, useFocusRing, useRadioGroup } from 'react-aria';\nimport { useRadioGroupState } from 'react-stately';\n\nimport { FieldBaseProps } from '../../../shared';\nimport { mergeProps } from '../../../utils/react';\nimport {\n  castNullableStringValue,\n  WithNullableValue,\n} from '../../../utils/react/nullableValue';\nimport { extractStyles } from '../../../utils/styles';\nimport { CubeItemProps } from '../../content/Item/Item';\nimport { FormScopeMask, useFieldProps, wrapWithField } from '../../form';\n\nimport { RadioContext } from './context';\n\nexport interface CubeRadioGroupProps\n  extends BaseProps,\n    Omit<AriaRadioGroupProps, 'errorMessage' | 'form' | 'name'>,\n    ContainerStyleProps,\n    FieldBaseProps<string | null | undefined> {\n  groupStyles?: Styles;\n  orientation?: 'horizontal' | 'vertical';\n  value?: string;\n  defaultValue?: string;\n  onChange?: (value: string) => void;\n  /* Size for all radio buttons in the group */\n  size?: Omit<CubeItemProps['size'], 'inline'>;\n  /* Button type for all button-style radios (ignored in tabs mode). When set to 'primary', selected buttons use 'primary' and non-selected use 'outline' with isSelected appearance */\n  buttonType?: CubeItemProps['type'];\n  /* Visual type for all radios in the group: radio (default), button, or tabs */\n  type?: 'radio' | 'button' | 'tabs';\n}\n\nconst RadioGroupElement = tasty({\n  qa: 'RadioGroup',\n  styles: {\n    display: 'flex',\n    placeItems: 'stretch',\n    placeContent: 'stretch',\n    flow: {\n      '': 'column',\n      horizontal: 'row wrap',\n      'horizontal & tabs': 'row',\n    },\n    padding: {\n      '': '0',\n      tabs: '.5x',\n    },\n    // The tabs layout is the only one with padding, and a caller that gives the\n    // group an explicit width (`width: 100%` inside a popover, say) means the\n    // box it can see. Without this the padding is added on top and the group\n    // overhangs its container by `1x`.\n    boxSizing: 'border-box',\n    radius: true,\n    fill: {\n      '': '#clear',\n      'tabs | disabled': '#surface-4',\n    },\n    width: 'max-content max-content initial',\n    flexShrink: 0,\n    gap: {\n      '': '1x',\n      button: 0,\n      tabs: '.5x',\n    },\n    whiteSpace: 'nowrap',\n    // Keyboard focus ring on the group, shown only for button/tabs layouts\n    // where individual items are visually merged (button-group) or share a\n    // single chrome (tabs) — the classic vertical radio list already shows\n    // a per-item focus ring on the radio circle.\n    outline: {\n      '': '1bw #primary-text.0 / 1bw',\n      'focused & (button | tabs)': '1bw #primary-text / 1bw',\n    },\n  },\n});\n\nfunction RadioGroup(props: WithNullableValue<CubeRadioGroupProps>, ref) {\n  let orientation = props.orientation;\n\n  props = castNullableStringValue(props);\n  props = useFieldProps(props, { defaultValidationTrigger: 'onChange' });\n\n  let {\n    qa,\n    id,\n    isDisabled,\n    isRequired,\n    labelPosition = 'top',\n    isInvalid,\n    isValid,\n    children,\n    styles,\n    groupStyles,\n    insideForm,\n    // orientation, // ignore orientation since it came from the form context\n    labelProps: baseLabelProps,\n    size,\n    buttonType,\n    type,\n    form,\n    ...otherProps\n  } = props;\n  let domRef = useObjectRef(ref);\n\n  styles = extractStyles(otherProps, CONTAINER_STYLES, styles);\n\n  let state = useRadioGroupState(props);\n\n  // Set default orientation based on type\n  if (orientation == null) {\n    orientation =\n      type === 'button' || type === 'tabs' ? 'horizontal' : 'vertical';\n  }\n\n  let { radioGroupProps: fieldProps, labelProps } = useRadioGroup(\n    { ...props, orientation },\n    state,\n  );\n\n  // Keyboard-only focus ring on the group container (button/tabs layouts).\n  // `within: true` tracks focus on any descendant radio. We read\n  // `isFocusVisible` (not `isFocused`), which is keyboard-gated — mouse\n  // clicks on a radio focus the input but leave `isFocusVisible` false.\n  let { isFocusVisible: isFocusWithinVisible, focusProps: groupFocusProps } =\n    useFocusRing({ within: true });\n\n  let radioGroup = (\n    <RadioGroupElement\n      id={id}\n      qa={qa || 'RadioGroup'}\n      styles={styles}\n      data-input-type=\"radiogroup\"\n      data-radio-button-group={type === 'button' ? '' : undefined}\n      mods={{\n        horizontal: orientation === 'horizontal',\n        'inside-form': insideForm,\n        'side-label': labelPosition === 'side',\n        button: type === 'button',\n        tabs: type === 'tabs',\n        focused: isFocusWithinVisible,\n      }}\n      {...groupFocusProps}\n    >\n      <FormScopeMask\n        value={{\n          isRequired,\n          isInvalid,\n          isValid,\n          isDisabled,\n        }}\n      >\n        <RadioContext.Provider\n          value={{\n            state,\n            name: props.name,\n            size,\n            buttonType,\n            type,\n            isDisabled,\n          }}\n        >\n          {children}\n        </RadioContext.Provider>\n      </FormScopeMask>\n    </RadioGroupElement>\n  );\n\n  return wrapWithField(radioGroup, domRef, {\n    ...props,\n    fieldProps,\n    labelProps: mergeProps(baseLabelProps, labelProps),\n  });\n}\n\n/**\n * Radio groups allow users to select a single option from a list of mutually exclusive options.\n * All possible options are exposed up front for users to compare.\n */\nconst _RadioGroup = forwardRef(RadioGroup);\n\n(_RadioGroup as any).cubeInputType = 'RadioGroup';\n_RadioGroup.displayName = 'RadioGroup';\n\nexport { _RadioGroup as RadioGroup };\n"],"mappings":";;;;;;;;;;;;;;;;AA0CA,MAAM,oBAAoB,MAAM;CAC9B,IAAI;CACJ,QAAQ;EACN,SAAS;EACT,YAAY;EACZ,cAAc;EACd,MAAM;GACJ,IAAI;GACJ,YAAY;GACZ,qBAAqB;GACtB;EACD,SAAS;GACP,IAAI;GACJ,MAAM;GACP;EAKD,WAAW;EACX,QAAQ;EACR,MAAM;GACJ,IAAI;GACJ,mBAAmB;GACpB;EACD,OAAO;EACP,YAAY;EACZ,KAAK;GACH,IAAI;GACJ,QAAQ;GACR,MAAM;GACP;EACD,YAAY;EAKZ,SAAS;GACP,IAAI;GACJ,6BAA6B;GAC9B;EACF;CACF,CAAC;AAEF,SAAS,WAAW,OAA+C,KAAK;CACtE,IAAI,cAAc,MAAM;AAExB,SAAQ,wBAAwB,MAAM;AACtC,SAAQ,cAAc,OAAO,EAAE,0BAA0B,YAAY,CAAC;CAEtE,IAAI,EACF,IACA,IACA,YACA,YACA,gBAAgB,OAChB,WACA,SACA,UACA,QACA,aACA,YAEA,YAAY,gBACZ,MACA,YACA,MACA,MACA,GAAG,eACD;CACJ,IAAI,SAAS,aAAa,IAAI;AAE9B,UAAS,cAAc,YAAY,kBAAkB,OAAO;CAE5D,IAAI,QAAQ,mBAAmB,MAAM;AAGrC,KAAI,eAAe,KACjB,eACE,SAAS,YAAY,SAAS,SAAS,eAAe;CAG1D,IAAI,EAAE,iBAAiB,YAAY,eAAe,cAChD;EAAE,GAAG;EAAO;EAAa,EACzB,MACD;CAMD,IAAI,EAAE,gBAAgB,sBAAsB,YAAY,oBACtD,aAAa,EAAE,QAAQ,MAAM,CAAC;AA2ChC,QAAO,cAxCL,oBAAC;EACK;EACJ,IAAI,MAAM;EACF;EACR,mBAAgB;EAChB,2BAAyB,SAAS,WAAW,KAAK;EAClD,MAAM;GACJ,YAAY,gBAAgB;GAC5B,eAAe;GACf,cAAc,kBAAkB;GAChC,QAAQ,SAAS;GACjB,MAAM,SAAS;GACf,SAAS;GACV;EACD,GAAI;YAEJ,oBAAC;GACC,OAAO;IACL;IACA;IACA;IACA;IACD;aAED,oBAAC,aAAa;IACZ,OAAO;KACL;KACA,MAAM,MAAM;KACZ;KACA;KACA;KACA;KACD;IAEA;KACqB;IACV;GACE,EAGW,QAAQ;EACvC,GAAG;EACH;EACA,YAAYA,aAAW,gBAAgB,WAAW;EACnD,CAAC;;;;;;AAOJ,MAAM,cAAc,WAAW,WAAW;AAE1C,AAAC,YAAoB,gBAAgB;AACrC,YAAY,cAAc"}

package/dist/components/fields/RadioGroup/context.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { createContext, useContext } from "react";
 
 //#region src/components/fields/RadioGroup/context.ts

package/dist/components/fields/SearchComboBox/SearchComboBox.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { useCombinedRefs } from "../../../utils/react/useCombinedRefs.js";
 import { usePopoverSync } from "../../../utils/react/usePopoverSync.js";

package/dist/components/fields/SearchInput/SearchInput.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { chain } from "../../../utils/react/chain.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useBufferedValue } from "../../../utils/react/useBufferedValue.js";

package/dist/components/fields/Select/Select.d.ts

@@ -21,7 +21,7 @@ import { AriaLabelingProps, CollectionBase, DOMRef, Key as Key$2 } from "@react-
 declare const ListBoxElement: _tenphi_tasty0.TastyPolymorphicComponent<"ul", readonly (keyof _tenphi_tasty0.StylesInterface)[], _tenphi_tasty0.VariantMap, readonly never[], readonly never[]> & {
   [x: string]: React.ForwardRefExoticComponent<Omit<_tenphi_tasty0.SubElementProps<never>, "ref"> & React.RefAttributes<never>>;
 };
-interface CubeSelectBaseProps<T> extends BasePropsWithoutChildren, AriaLabelingProps, BaseStyleProps, OuterStyleProps, ColorStyleProps, Omit<FieldBaseProps, 'tooltip'>, CollectionBase<T>, Omit<AriaSelectProps<T>, 'errorMessage' | 'selectedKey' | 'defaultSelectedKey' | 'onSelectionChange'> {
+interface CubeSelectBaseProps<T> extends BasePropsWithoutChildren, AriaLabelingProps, BaseStyleProps, OuterStyleProps, ColorStyleProps, Omit<FieldBaseProps<Key$2 | null | undefined>, 'tooltip'>, CollectionBase<T>, Omit<AriaSelectProps<T>, 'errorMessage' | 'name' | 'selectedKey' | 'defaultSelectedKey' | 'onSelectionChange'> {
   /** The currently selected key in the collection (controlled). */
   selectedKey?: Key$2 | null;
   /** The initial selected key in the collection (uncontrolled). */
@@ -78,6 +78,8 @@ interface CubeSelectBaseProps<T> extends BasePropsWithoutChildren, AriaLabelingP
   theme?: 'default' | 'special';
   /** Whether the select is clearable using a clear button in the rightIcon slot */
   isClearable?: boolean;
+  /** Accessible name for the built-in clear button. Defaults to a localized "Clear value". */
+  clearLabel?: string;
   /** Callback called when the clear button is pressed */
   onClear?: () => void;
   /**

package/dist/components/fields/Select/Select.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { forwardRefWithGenerics } from "../../../utils/react/forwardRefWithGenerics.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
@@ -6,6 +6,7 @@ import { useCombinedRefs } from "../../../utils/react/useCombinedRefs.js";
 import { usePopoverSync } from "../../../utils/react/usePopoverSync.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { _Text } from "../../content/Text.js";
+import { focusProgrammatically } from "../../../utils/react/programmaticFocus.js";
 import { useFocus as useFocus$1 } from "../../../utils/react/interactions.js";
 import { DisplayTransition } from "../../helpers/DisplayTransition/DisplayTransition.js";
 import { Portal } from "../../portal/Portal.js";
@@ -13,9 +14,11 @@ import { LoadingIcon } from "../../../icons/LoadingIcon.js";
 import { ItemAction } from "../../actions/ItemAction/ItemAction.js";
 import { _CollectionItem, filterCollectionItemProps } from "../../CollectionItem.js";
 import { _Item } from "../../content/Item/Item.js";
+import { useI18n } from "../../../i18n/useI18n.js";
 import { DirectionIcon } from "../../../icons/DirectionIcon.js";
 import { StyledDivider, StyledSection, StyledSectionHeading } from "../../actions/Menu/styled.js";
 import { generateRandomId } from "../../../utils/random.js";
+import { useOverlayEscapeGuard } from "../../../utils/react/useOverlayEscapeGuard.js";
 import { isOwnActionsPress } from "../../actions/actions-run.js";
 import { ItemActionIcon, ItemActionsWrapper } from "../../actions/ItemActionsWrapper.js";
 import { CloseIcon } from "../../../icons/CloseIcon.js";
@@ -126,7 +129,8 @@ function Select(props, ref) {
 			onSelectionChange: onChange
 		})
 	});
-	let { qa, label, extra, icon, rightIcon, labelStyles, isRequired, necessityIndicator, isInvalid, isValid, prefix, isDisabled = props.isLoading || false, autoFocus, inputProps, triggerRef, popoverRef, listBoxRef, isLoading, loadingIndicator, overlayOffset = 8, inputStyles, triggerStyles, optionStyles, listBoxStyles, overlayStyles, suffix, actions, message, triggerDescription, descriptionPlacement, hotkeys, direction = "bottom", shouldFlip = true, containerPadding = 8, placeholder, tooltip, size = "medium", shape, styles, type = "outline", theme = "default", labelSuffix, suffixPosition = "before", isClearable, onOpenChange, form, ...otherProps } = props;
+	let { qa, label, extra, icon, rightIcon, labelStyles, isRequired, necessityIndicator, isInvalid, isValid, prefix, isDisabled = props.isLoading || false, autoFocus, inputProps, triggerRef, popoverRef, listBoxRef, isLoading, loadingIndicator, overlayOffset = 8, inputStyles, triggerStyles, optionStyles, listBoxStyles, overlayStyles, suffix, actions, message, triggerDescription, descriptionPlacement, hotkeys, direction = "bottom", shouldFlip = true, containerPadding = 8, placeholder, tooltip, size = "medium", shape, styles, type = "outline", theme = "default", labelSuffix, suffixPosition = "before", isClearable, clearLabel, onOpenChange, form, ...otherProps } = props;
+	const { t } = useI18n();
 	let state = useSelectState(props);
 	const selectId = useMemo(() => generateRandomId(), []);
 	useEffect(() => {
@@ -144,6 +148,17 @@ function Select(props, ref) {
 		triggerRef,
 		containerRef: popoverRef
 	});
+	useEffect(() => {
+		if (state.isOpen) return;
+		const popover = popoverRef.current;
+		const active = document.activeElement;
+		if (!popover || !active || !popover.contains(active)) return;
+		focusProgrammatically(triggerRef.current, { preventScroll: true });
+	}, [
+		state.isOpen,
+		popoverRef,
+		triggerRef
+	]);
 	let { labelProps, triggerProps, valueProps, menuProps } = useSelect(props, state, triggerRef);
 	let { overlayProps, placement } = useOverlayPosition({
 		targetRef: triggerRef,
@@ -209,6 +224,7 @@ function Select(props, ref) {
 			icon: /* @__PURE__ */ jsx(CloseIcon, {}),
 			size,
 			qa: "SelectClearButton",
+			"aria-label": clearLabel ?? t("select.clearValue", "Clear value"),
 			mods: { pressed: false },
 			onPress: clearValue
 		}) : isLoading ? /* @__PURE__ */ jsx(ItemActionIcon, { children: /* @__PURE__ */ jsx(LoadingIcon, {}) }) : /* @__PURE__ */ jsx(ItemActionIcon, { children: /* @__PURE__ */ jsx(DirectionIcon, { to: state.isOpen ? "up" : "down" }) })
@@ -289,7 +305,7 @@ function ListBoxPopup({ state, popoverRef, listBoxRef, listBoxStyles, overlaySty
 		shouldUseVirtualFocus,
 		...otherProps
 	}, state, listBoxRef);
-	let { overlayProps } = useOverlay({
+	let { overlayProps: rawOverlayProps } = useOverlay({
 		onClose: () => state.close(),
 		shouldCloseOnBlur: true,
 		isOpen: state.isOpen,
@@ -309,6 +325,7 @@ function ListBoxPopup({ state, popoverRef, listBoxRef, listBoxStyles, overlaySty
 			return false;
 		}
 	}, popoverRef);
+	const overlayProps = useOverlayEscapeGuard(rawOverlayProps, state.isOpen);
 	const placementDirection = placement?.split(" ")[0] || "bottom";
 	return /* @__PURE__ */ jsx(Portal, { children: /* @__PURE__ */ jsx(DisplayTransition, {
 		isShown: state.isOpen && !isDisabled,