@cube-dev/ui-kit 0.163.0 → 0.164.0

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

@@ -1 +1 @@
-{"version":3,"file":"ColorPicker.js","names":["Text","ItemButton"],"sources":["../../../../src/components/fields/ColorPicker/ColorPicker.tsx"],"sourcesContent":["import {\n  BaseProps,\n  BLOCK_STYLES,\n  BlockStyleProps,\n  OUTER_STYLES,\n  OuterStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport {\n  ForwardedRef,\n  forwardRef,\n  ReactNode,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { FieldBaseProps } from '../../../shared';\nimport { extractStyles } from '../../../utils/styles';\nimport { 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 { ColorSpace } from '../color/channels';\nimport {\n  ColorFormat,\n  ColorValue,\n  formatColor,\n  parseColor,\n} from '../color/color';\nimport { ColorPanel } from '../color/ColorPanel';\nimport { ColorSwatch } from '../color/ColorSwatch';\nimport { ColorPopoverContext } from '../color/context';\nimport { ColorInput } from '../ColorInput';\nimport { ColorSwatchGroup, CubeColorSwatchItem } from '../ColorSwatchGroup';\n\n/**\n * A popover caps its height at half the viewport. The panel can exceed that on\n * a short screen, and would otherwise spill outside the popover's own border.\n */\nconst POPOVER_STYLES: Styles = { overflow: 'auto' };\n\n/**\n * The rule separating the palette from the editor. `Divider` is not used: it\n * places itself on named grid lines meant for menu layouts, which this panel\n * does not define, so it lands in the wrong row and spawns a stray column.\n */\nconst PALETTE_STYLES: Styles = {\n  border: 'top',\n  padding: '1x top',\n  width: '100%',\n};\n\n/** What the popover starts from when there is no color to edit yet. */\nconst FALLBACK_COLOR: ColorValue = { h: 264, s: 0.8, l: 0.6 };\n\nconst ColorPickerWrapper = tasty({\n  qa: 'ColorPickerWrapper',\n  styles: {\n    display: 'inline-grid',\n    flow: 'column',\n    gridRows: '1sf',\n    placeContent: 'stretch',\n    placeItems: 'stretch',\n  },\n});\n\nexport interface CubeColorPickerProps\n  extends BaseProps,\n    OuterStyleProps,\n    BlockStyleProps,\n    FieldBaseProps {\n  /** The selected color, as a color string. */\n  value?: string | null;\n  /** The initial color of an uncontrolled picker. */\n  defaultValue?: string | null;\n  /** Called with the color string, or `null` when there is no color. */\n  onChange?: (value: string | null) => void;\n  /** Notation the value is written in. */\n  format?: ColorFormat;\n  /** Color concept the popover opens with. */\n  defaultSpace?: ColorSpace;\n  /** Whether the popover is open. Makes the disclosure controlled. */\n  isOpen?: boolean;\n  /** Whether the popover is open initially. */\n  defaultOpen?: boolean;\n  /** Called when the popover opens or closes. */\n  onOpenChange?: (isOpen: boolean) => void;\n  /** Whether the popover may flip to the other side of the trigger. */\n  shouldFlip?: boolean;\n  /** Replaces the color shown on the trigger. Pass `null` for a swatch on its own. */\n  children?: ReactNode;\n  /** Shown on the trigger while there is no color. */\n  placeholder?: ReactNode;\n  /** The size of the trigger. */\n  size?: CubeItemProps['size'];\n  /** The visual type of the trigger. */\n  type?: CubeItemProps['type'];\n  theme?: CubeItemProps['theme'];\n  /** Tooltip for the trigger, separate from the field tooltip. */\n  triggerTooltip?: CubeItemProps['tooltip'];\n  /** Colors to offer under the editor, for picking without dialing one in. */\n  swatches?: CubeColorSwatchItem[];\n  /** How many swatches per row. Defaults to a single row. */\n  swatchColumns?: number;\n  styles?: Styles;\n  /** Styles of the trigger button. */\n  triggerStyles?: Styles;\n  /** Styles of the color swatch. */\n  swatchStyles?: Styles;\n  'aria-label'?: string;\n}\n\n/**\n * A color swatch that opens the color popover — the same one `ColorInput`\n * uses, without the text field. Reach for it when a color is chosen but never\n * typed: a toolbar, a chart legend, a cell in a dense table.\n */\nexport const ColorPicker = forwardRef(function ColorPicker(\n  allProps: CubeColorPickerProps,\n  ref: ForwardedRef<HTMLElement>,\n) {\n  const props = useFieldProps(allProps, {\n    defaultValidationTrigger: 'onChange',\n    valuePropsMapper: ({ value, onChange }) => ({\n      value: value as string | null | undefined,\n      onChange,\n    }),\n  });\n\n  const {\n    qa,\n    id,\n    value,\n    defaultValue,\n    onChange,\n    format = 'hex',\n    defaultSpace = 'hst',\n    isOpen: controlledOpen,\n    defaultOpen,\n    onOpenChange,\n    shouldFlip,\n    children,\n    placeholder = 'Pick a color',\n    size,\n    type = 'outline',\n    theme = 'default',\n    triggerTooltip,\n    swatches,\n    swatchColumns,\n    triggerStyles,\n    swatchStyles,\n    isDisabled,\n    isReadOnly,\n    isLoading,\n    isInvalid,\n    isValid,\n    autoFocus,\n    'aria-label': ariaLabel,\n  } = props;\n\n  const styles = extractStyles(props, [...OUTER_STYLES, ...BLOCK_STYLES]);\n\n  /**\n   * Loading locks the trigger, but the popover can outlive that — it may be\n   * controlled, or opened before the load began — so the editor inside has to\n   * refuse edits on the same terms.\n   */\n  const isEditingDisabled = isDisabled || isLoading;\n\n  const [color, setColor] = useState(() =>\n    parseColor((value ?? defaultValue ?? '').toString()),\n  );\n  const [space, setSpace] = useState<ColorSpace>(defaultSpace);\n  const [isOpen, setOpen] = useState(defaultOpen ?? false);\n\n  /** What was last published, to tell our own updates from outside ones. */\n  const emitted = useRef<string | null | undefined>(value);\n\n  // Adopt values that did not come from here — a form reset, or a parent that\n  // overrides what the user picked.\n  useEffect(() => {\n    if (value === undefined || value === emitted.current) return;\n\n    emitted.current = value;\n    setColor(parseColor((value ?? '').toString()));\n  }, [value]);\n\n  const handleColorChange = useEvent((next: ColorValue) => {\n    const text = formatColor(next, format);\n\n    emitted.current = text;\n    setColor(next);\n    onChange?.(text);\n  });\n\n  const colorText = color ? formatColor(color, format) : null;\n\n  /**\n   * The palette and the value field both speak in strings, and the field can\n   * hand back `null` when it is cleared — which has to reach the picker, or the\n   * text empties while the preview and trigger keep the old color.\n   */\n  const handleValueChange = useEvent((next: string | null) => {\n    emitted.current = next;\n    setColor(next ? parseColor(next) : null);\n    onChange?.(next);\n  });\n\n  const handleOpenChange = useEvent((next: boolean) => {\n    setOpen(next);\n    onOpenChange?.(next);\n  });\n\n  // The swatch carries the color and the label spells it out. `children`\n  // replaces that label, and `null` leaves the swatch on its own.\n  const label =\n    children !== undefined ? (\n      children\n    ) : color ? (\n      formatColor(color, format)\n    ) : (\n      // Muted, so an unset picker never reads like one holding a value —\n      // the same treatment `Picker` and `Select` give their placeholders.\n      <Text.Placeholder>{placeholder}</Text.Placeholder>\n    );\n\n  const pickerField = (\n    <ColorPickerWrapper styles={styles}>\n      <DialogTrigger\n        hideArrow\n        type=\"popover\"\n        mobileType=\"tray\"\n        placement=\"bottom start\"\n        isOpen={controlledOpen ?? isOpen}\n        shouldFlip={shouldFlip}\n        onOpenChange={handleOpenChange}\n      >\n        <ItemButton\n          data-popover-trigger\n          id={id}\n          qa={qa || 'ColorPickerTrigger'}\n          data-input-type=\"colorpicker\"\n          type={type}\n          theme={getValidationTheme(theme, { isInvalid, isValid })}\n          size={size}\n          icon={<ColorSwatch color={color} styles={swatchStyles} />}\n          rightIcon={getValidationIcon({ isInvalid, isValid })}\n          tooltip={triggerTooltip}\n          isDisabled={isEditingDisabled || isReadOnly}\n          autoFocus={autoFocus}\n          aria-label={ariaLabel}\n          mods={{ placeholder: !color }}\n          styles={triggerStyles}\n        >\n          {label}\n        </ItemButton>\n        <Dialog\n          aria-label=\"Color picker\"\n          width=\"max-content\"\n          styles={POPOVER_STYLES}\n        >\n          {/* Marks the subtree so a nested swatch group drops its custom-color\n              escape hatch, which is a picker and would recurse forever. */}\n          <ColorPopoverContext.Provider value={true}>\n            <ColorPanel\n              color={color ?? FALLBACK_COLOR}\n              space={space}\n              isDisabled={isEditingDisabled || isReadOnly}\n              previewFormat={format}\n              input={\n                <ColorInput\n                  aria-label=\"Color value\"\n                  format={format}\n                  value={colorText}\n                  isDisabled={isEditingDisabled}\n                  isReadOnly={isReadOnly}\n                  onChange={handleValueChange}\n                />\n              }\n              swatches={\n                swatches?.length ? (\n                  <ColorSwatchGroup\n                    aria-label=\"Palette\"\n                    styles={PALETTE_STYLES}\n                    colors={swatches}\n                    columns={swatchColumns}\n                    format={format}\n                    value={colorText}\n                    isDisabled={isEditingDisabled || isReadOnly}\n                    onChange={handleValueChange}\n                  />\n                ) : null\n              }\n              onChange={handleColorChange}\n              onSpaceChange={setSpace}\n            />\n          </ColorPopoverContext.Provider>\n        </Dialog>\n      </DialogTrigger>\n    </ColorPickerWrapper>\n  );\n\n  return wrapWithField(pickerField, ref as any, props);\n});\n\n/**\n * Drives the legacy `<Field>` wiring: `Picker` validates on change and passes\n * the value through untouched, where `Text` would default to `onBlur` and\n * coerce `null` into an empty string.\n */\n(ColorPicker as any).cubeInputType = 'Picker';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,MAAM,iBAAyB,EAAE,UAAU,QAAQ;;;;;;AAOnD,MAAM,iBAAyB;CAC7B,QAAQ;CACR,SAAS;CACT,OAAO;CACR;;AAGD,MAAM,iBAA6B;CAAE,GAAG;CAAK,GAAG;CAAK,GAAG;CAAK;AAE7D,MAAM,qBAAqB,MAAM;CAC/B,IAAI;CACJ,QAAQ;EACN,SAAS;EACT,MAAM;EACN,UAAU;EACV,cAAc;EACd,YAAY;EACb;CACF,CAAC;;;;;;AAqDF,MAAa,cAAc,WAAW,SAAS,YAC7C,UACA,KACA;CACA,MAAM,QAAQ,cAAc,UAAU;EACpC,0BAA0B;EAC1B,mBAAmB,EAAE,OAAO,gBAAgB;GACnC;GACP;GACD;EACF,CAAC;CAEF,MAAM,EACJ,IACA,IACA,OACA,cACA,UACA,SAAS,OACT,eAAe,OACf,QAAQ,gBACR,aACA,cACA,YACA,UACA,cAAc,gBACd,MACA,OAAO,WACP,QAAQ,WACR,gBACA,UACA,eACA,eACA,cACA,YACA,YACA,WACA,WACA,SACA,WACA,cAAc,cACZ;CAEJ,MAAM,SAAS,cAAc,OAAO,CAAC,GAAG,cAAc,GAAG,aAAa,CAAC;;;;;;CAOvE,MAAM,oBAAoB,cAAc;CAExC,MAAM,CAAC,OAAO,YAAY,eACxB,YAAY,SAAS,gBAAgB,IAAI,UAAU,CAAC,CACrD;CACD,MAAM,CAAC,OAAO,YAAY,SAAqB,aAAa;CAC5D,MAAM,CAAC,QAAQ,WAAW,SAAS,eAAe,MAAM;;CAGxD,MAAM,UAAU,OAAkC,MAAM;AAIxD,iBAAgB;AACd,MAAI,UAAU,UAAa,UAAU,QAAQ,QAAS;AAEtD,UAAQ,UAAU;AAClB,WAAS,YAAY,SAAS,IAAI,UAAU,CAAC,CAAC;IAC7C,CAAC,MAAM,CAAC;CAEX,MAAM,oBAAoB,UAAU,SAAqB;EACvD,MAAM,OAAO,YAAY,MAAM,OAAO;AAEtC,UAAQ,UAAU;AAClB,WAAS,KAAK;AACd,aAAW,KAAK;GAChB;CAEF,MAAM,YAAY,QAAQ,YAAY,OAAO,OAAO,GAAG;;;;;;CAOvD,MAAM,oBAAoB,UAAU,SAAwB;AAC1D,UAAQ,UAAU;AAClB,WAAS,OAAO,WAAW,KAAK,GAAG,KAAK;AACxC,aAAW,KAAK;GAChB;CAEF,MAAM,mBAAmB,UAAU,SAAkB;AACnD,UAAQ,KAAK;AACb,iBAAe,KAAK;GACpB;CAIF,MAAM,QACJ,aAAa,SACX,WACE,QACF,YAAY,OAAO,OAAO,GAI1B,oBAACA,MAAK,yBAAa,cAA+B;AA+EtD,QAAO,cA3EL,oBAAC;EAA2B;YAC1B,qBAAC;GACC;GACA,MAAK;GACL,YAAW;GACX,WAAU;GACV,QAAQ,kBAAkB;GACd;GACZ,cAAc;cAEd,oBAACC;IACC;IACI;IACJ,IAAI,MAAM;IACV,mBAAgB;IACV;IACN,OAAO,mBAAmB,OAAO;KAAE;KAAW;KAAS,CAAC;IAClD;IACN,MAAM,oBAAC;KAAmB;KAAO,QAAQ;MAAgB;IACzD,WAAW,kBAAkB;KAAE;KAAW;KAAS,CAAC;IACpD,SAAS;IACT,YAAY,qBAAqB;IACtB;IACX,cAAY;IACZ,MAAM,EAAE,aAAa,CAAC,OAAO;IAC7B,QAAQ;cAEP;KACU,EACb,oBAAC;IACC,cAAW;IACX,OAAM;IACN,QAAQ;cAIR,oBAAC,oBAAoB;KAAS,OAAO;eACnC,oBAAC;MACC,OAAO,SAAS;MACT;MACP,YAAY,qBAAqB;MACjC,eAAe;MACf,OACE,oBAAC;OACC,cAAW;OACH;OACR,OAAO;OACP,YAAY;OACA;OACZ,UAAU;QACV;MAEJ,UACE,UAAU,SACR,oBAAC;OACC,cAAW;OACX,QAAQ;OACR,QAAQ;OACR,SAAS;OACD;OACR,OAAO;OACP,YAAY,qBAAqB;OACjC,UAAU;QACV,GACA;MAEN,UAAU;MACV,eAAe;OACf;MAC2B;KACxB;IACK;GACG,EAGW,KAAY,MAAM;EACpD;;;;;;AAOF,AAAC,YAAoB,gBAAgB"}
+{"version":3,"file":"ColorPicker.js","names":["Text","ItemButton"],"sources":["../../../../src/components/fields/ColorPicker/ColorPicker.tsx"],"sourcesContent":["import {\n  BaseProps,\n  BLOCK_STYLES,\n  BlockStyleProps,\n  OUTER_STYLES,\n  OuterStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport {\n  ForwardedRef,\n  forwardRef,\n  ReactNode,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { FieldBaseProps } from '../../../shared';\nimport { extractStyles } from '../../../utils/styles';\nimport { 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 { ColorSpace } from '../color/channels';\nimport {\n  ColorFormat,\n  ColorValue,\n  formatColor,\n  parseColor,\n} from '../color/color';\nimport { ColorPanel } from '../color/ColorPanel';\nimport { ColorPopoverContext } from '../color/context';\nimport { ColorInput } from '../ColorInput';\nimport { ColorSwatch } from '../ColorSwatch';\nimport { ColorSwatchGroup, CubeColorSwatchItem } from '../ColorSwatchGroup';\n\n/**\n * A popover caps its height at half the viewport. The panel can exceed that on\n * a short screen, and would otherwise spill outside the popover's own border.\n */\nconst POPOVER_STYLES: Styles = { overflow: 'auto' };\n\n/**\n * The rule separating the palette from the editor. `Divider` is not used: it\n * places itself on named grid lines meant for menu layouts, which this panel\n * does not define, so it lands in the wrong row and spawns a stray column.\n */\nconst PALETTE_STYLES: Styles = {\n  border: 'top',\n  padding: '1x top',\n  width: '100%',\n};\n\n/** What the popover starts from when there is no color to edit yet. */\nconst FALLBACK_COLOR: ColorValue = { h: 264, s: 0.8, l: 0.6 };\n\nconst ColorPickerWrapper = tasty({\n  qa: 'ColorPickerWrapper',\n  styles: {\n    display: 'inline-grid',\n    flow: 'column',\n    gridRows: '1sf',\n    placeContent: 'stretch',\n    placeItems: 'stretch',\n  },\n});\n\nexport interface CubeColorPickerProps\n  extends BaseProps,\n    OuterStyleProps,\n    BlockStyleProps,\n    FieldBaseProps {\n  /** The selected color, as a color string. */\n  value?: string | null;\n  /** The initial color of an uncontrolled picker. */\n  defaultValue?: string | null;\n  /** Called with the color string, or `null` when there is no color. */\n  onChange?: (value: string | null) => void;\n  /** Notation the value is written in. */\n  format?: ColorFormat;\n  /** Color concept the popover opens with. */\n  defaultSpace?: ColorSpace;\n  /** Whether the popover is open. Makes the disclosure controlled. */\n  isOpen?: boolean;\n  /** Whether the popover is open initially. */\n  defaultOpen?: boolean;\n  /** Called when the popover opens or closes. */\n  onOpenChange?: (isOpen: boolean) => void;\n  /** Whether the popover may flip to the other side of the trigger. */\n  shouldFlip?: boolean;\n  /** Replaces the color shown on the trigger. Pass `null` for a swatch on its own. */\n  children?: ReactNode;\n  /** Shown on the trigger while there is no color. */\n  placeholder?: ReactNode;\n  /** The size of the trigger. */\n  size?: CubeItemProps['size'];\n  /** The visual type of the trigger. */\n  type?: CubeItemProps['type'];\n  theme?: CubeItemProps['theme'];\n  /** Tooltip for the trigger, separate from the field tooltip. */\n  triggerTooltip?: CubeItemProps['tooltip'];\n  /** Colors to offer under the editor, for picking without dialing one in. */\n  swatches?: CubeColorSwatchItem[];\n  /** How many swatches per row. Defaults to a single row. */\n  swatchColumns?: number;\n  styles?: Styles;\n  /** Styles of the trigger button. */\n  triggerStyles?: Styles;\n  /** Styles of the color swatch. */\n  swatchStyles?: Styles;\n  'aria-label'?: string;\n}\n\n/**\n * A color swatch that opens the color popover — the same one `ColorInput`\n * uses, without the text field. Reach for it when a color is chosen but never\n * typed: a toolbar, a chart legend, a cell in a dense table.\n */\nexport const ColorPicker = forwardRef(function ColorPicker(\n  allProps: CubeColorPickerProps,\n  ref: ForwardedRef<HTMLElement>,\n) {\n  const props = useFieldProps(allProps, {\n    defaultValidationTrigger: 'onChange',\n    valuePropsMapper: ({ value, onChange }) => ({\n      value: value as string | null | undefined,\n      onChange,\n    }),\n  });\n\n  const {\n    qa,\n    id,\n    value,\n    defaultValue,\n    onChange,\n    format = 'hex',\n    defaultSpace = 'hst',\n    isOpen: controlledOpen,\n    defaultOpen,\n    onOpenChange,\n    shouldFlip,\n    children,\n    placeholder = 'Pick a color',\n    size,\n    type = 'outline',\n    theme = 'default',\n    triggerTooltip,\n    swatches,\n    swatchColumns,\n    triggerStyles,\n    swatchStyles,\n    isDisabled,\n    isReadOnly,\n    isLoading,\n    isInvalid,\n    isValid,\n    autoFocus,\n    'aria-label': ariaLabel,\n  } = props;\n\n  const styles = extractStyles(props, [...OUTER_STYLES, ...BLOCK_STYLES]);\n\n  /**\n   * Loading locks the trigger, but the popover can outlive that — it may be\n   * controlled, or opened before the load began — so the editor inside has to\n   * refuse edits on the same terms.\n   */\n  const isEditingDisabled = isDisabled || isLoading;\n\n  const [color, setColor] = useState(() =>\n    parseColor((value ?? defaultValue ?? '').toString()),\n  );\n  const [space, setSpace] = useState<ColorSpace>(defaultSpace);\n  const [isOpen, setOpen] = useState(defaultOpen ?? false);\n\n  /** What was last published, to tell our own updates from outside ones. */\n  const emitted = useRef<string | null | undefined>(value);\n\n  // Adopt values that did not come from here — a form reset, or a parent that\n  // overrides what the user picked.\n  useEffect(() => {\n    if (value === undefined || value === emitted.current) return;\n\n    emitted.current = value;\n    setColor(parseColor((value ?? '').toString()));\n  }, [value]);\n\n  const handleColorChange = useEvent((next: ColorValue) => {\n    const text = formatColor(next, format);\n\n    emitted.current = text;\n    setColor(next);\n    onChange?.(text);\n  });\n\n  const colorText = color ? formatColor(color, format) : null;\n\n  /**\n   * The palette and the value field both speak in strings, and the field can\n   * hand back `null` when it is cleared — which has to reach the picker, or the\n   * text empties while the preview and trigger keep the old color.\n   */\n  const handleValueChange = useEvent((next: string | null) => {\n    emitted.current = next;\n    setColor(next ? parseColor(next) : null);\n    onChange?.(next);\n  });\n\n  const handleOpenChange = useEvent((next: boolean) => {\n    setOpen(next);\n    onOpenChange?.(next);\n  });\n\n  // The swatch carries the color and the label spells it out. `children`\n  // replaces that label, and `null` leaves the swatch on its own.\n  const label =\n    children !== undefined ? (\n      children\n    ) : color ? (\n      formatColor(color, format)\n    ) : (\n      // Muted, so an unset picker never reads like one holding a value —\n      // the same treatment `Picker` and `Select` give their placeholders.\n      <Text.Placeholder>{placeholder}</Text.Placeholder>\n    );\n\n  const pickerField = (\n    <ColorPickerWrapper styles={styles}>\n      <DialogTrigger\n        hideArrow\n        type=\"popover\"\n        mobileType=\"tray\"\n        placement=\"bottom start\"\n        isOpen={controlledOpen ?? isOpen}\n        shouldFlip={shouldFlip}\n        onOpenChange={handleOpenChange}\n      >\n        <ItemButton\n          data-popover-trigger\n          id={id}\n          qa={qa || 'ColorPickerTrigger'}\n          data-input-type=\"colorpicker\"\n          type={type}\n          theme={getValidationTheme(theme, { isInvalid, isValid })}\n          size={size}\n          // Fixed 20px rather than tracking the trigger, same as `ColorInput`\n          // and same as this has always rendered.\n          icon={\n            <ColorSwatch size=\"small\" color={color} styles={swatchStyles} />\n          }\n          rightIcon={getValidationIcon({ isInvalid, isValid })}\n          tooltip={triggerTooltip}\n          isDisabled={isEditingDisabled || isReadOnly}\n          autoFocus={autoFocus}\n          aria-label={ariaLabel}\n          mods={{ placeholder: !color }}\n          styles={triggerStyles}\n        >\n          {label}\n        </ItemButton>\n        <Dialog\n          aria-label=\"Color picker\"\n          width=\"max-content\"\n          styles={POPOVER_STYLES}\n        >\n          {/* Marks the subtree so a nested swatch group drops its custom-color\n              escape hatch, which is a picker and would recurse forever. */}\n          <ColorPopoverContext.Provider value={true}>\n            <ColorPanel\n              color={color ?? FALLBACK_COLOR}\n              space={space}\n              isDisabled={isEditingDisabled || isReadOnly}\n              previewFormat={format}\n              input={\n                <ColorInput\n                  aria-label=\"Color value\"\n                  format={format}\n                  value={colorText}\n                  isDisabled={isEditingDisabled}\n                  isReadOnly={isReadOnly}\n                  onChange={handleValueChange}\n                />\n              }\n              swatches={\n                swatches?.length ? (\n                  <ColorSwatchGroup\n                    aria-label=\"Palette\"\n                    styles={PALETTE_STYLES}\n                    colors={swatches}\n                    columns={swatchColumns}\n                    format={format}\n                    value={colorText}\n                    isDisabled={isEditingDisabled || isReadOnly}\n                    onChange={handleValueChange}\n                  />\n                ) : null\n              }\n              onChange={handleColorChange}\n              onSpaceChange={setSpace}\n            />\n          </ColorPopoverContext.Provider>\n        </Dialog>\n      </DialogTrigger>\n    </ColorPickerWrapper>\n  );\n\n  return wrapWithField(pickerField, ref as any, props);\n});\n\n/**\n * Drives the legacy `<Field>` wiring: `Picker` validates on change and passes\n * the value through untouched, where `Text` would default to `onBlur` and\n * coerce `null` into an empty string.\n */\n(ColorPicker as any).cubeInputType = 'Picker';\n"],"mappings":"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"}

package/dist/components/fields/{color → ColorSwatch}/ColorSwatch.d.ts

@@ -1,12 +1,18 @@
 
-import { ColorValue } from "./color.js";
+import { ColorValue } from "../color/color.js";
 import { BaseProps, BaseStyleProps, BlockStyleProps, DimensionStyleProps, OuterStyleProps, Styles } from "@tenphi/tasty";
 import * as react from "react";
 
-//#region src/components/fields/color/ColorSwatch.d.ts
+//#region src/components/fields/ColorSwatch/ColorSwatch.d.ts
 interface CubeColorSwatchProps extends BaseProps, BaseStyleProps, OuterStyleProps, BlockStyleProps, DimensionStyleProps {
   /** The color to show. Anything the color inputs accept; `null` shows the empty state. */
   color?: string | ColorValue | null;
+  /**
+   * The edge of the swatch: 20px, 24px or 28px. Left unset, the swatch tracks
+   * the control around it — `1x` inside its height — and falls back to `medium`
+   * where there is no control.
+   */
+  size?: 'small' | 'medium' | 'large' | (string & {});
   styles?: Styles;
 }
 /**

package/dist/components/fields/{color → ColorSwatch}/ColorSwatch.js

@@ -1,11 +1,11 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
-import { parseColor, toHex } from "./color.js";
+import { parseColor, toHex } from "../color/color.js";
 import { BASE_STYLES, BLOCK_STYLES, DIMENSION_STYLES, OUTER_STYLES, tasty } from "@tenphi/tasty";
 import { forwardRef } from "react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/components/fields/color/ColorSwatch.tsx
+//#region src/components/fields/ColorSwatch/ColorSwatch.tsx
 const STYLE_PROPS = [
 	...BASE_STYLES,
 	...OUTER_STYLES,
@@ -16,8 +16,15 @@ const SwatchElement = tasty({
 	qa: "ColorSwatch",
 	styles: {
 		display: "block",
-		width: "2.5x",
-		height: "2.5x",
+		"$swatch-host": {
+			"": "($size, 4x)",
+			"size=small": "3.5x",
+			"size=medium": "4x",
+			"size=large": "4.5x"
+		},
+		"$swatch-size": "($swatch-host - 1x)",
+		width: "$swatch-size $swatch-size",
+		height: "$swatch-size $swatch-size",
 		radius: "1r",
 		fill: {
 			"": "(#color-picker, #clear)",
@@ -38,12 +45,13 @@ const SwatchElement = tasty({
 * so the swatch keeps a single cached style rule however often it changes.
 */
 const ColorSwatch = forwardRef(function ColorSwatch(props, ref) {
-	const { color, mods, qa } = props;
+	const { color, mods, qa, size } = props;
 	const styles = extractStyles(props, STYLE_PROPS);
 	const resolved = typeof color === "string" ? parseColor(color) : color ?? null;
 	return /* @__PURE__ */ jsx(SwatchElement, {
 		ref,
 		qa,
+		"data-size": size,
 		mods: {
 			empty: !resolved,
 			...mods

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorSwatch.js","names":[],"sources":["../../../../src/components/fields/ColorSwatch/ColorSwatch.tsx"],"sourcesContent":["import {\n  BASE_STYLES,\n  BaseProps,\n  BaseStyleProps,\n  BLOCK_STYLES,\n  BlockStyleProps,\n  DIMENSION_STYLES,\n  DimensionStyleProps,\n  OUTER_STYLES,\n  OuterStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport { ForwardedRef, forwardRef } from 'react';\n\nimport { extractStyles } from '../../../utils/styles';\nimport { ColorValue, parseColor, toHex } from '../color/color';\n\nconst STYLE_PROPS = [\n  ...BASE_STYLES,\n  ...OUTER_STYLES,\n  ...BLOCK_STYLES,\n  ...DIMENSION_STYLES,\n];\n\nconst SwatchElement = tasty({\n  qa: 'ColorSwatch',\n  styles: {\n    display: 'block',\n\n    /**\n     * The control the swatch sits in, when there is one.\n     *\n     * `Item`, `Button` and `TextInputBase` all publish their own height as\n     * `$size`, and a custom property reaches any descendant — so a swatch in an\n     * icon, prefix or suffix slot reads the host's height without either side\n     * knowing about the other. `$swatch-host` is the fallback chain: an explicit\n     * `size` pins it, and outside a control the medium default stands in.\n     *\n     * The named sizes are stated as the *host* they would fit, not as the swatch\n     * itself, so the `- 1x` below is the single place the inset is expressed.\n     */\n    '$swatch-host': {\n      // `var(--size, 4x)` — a host wins, and 32px is a medium control.\n      '': '($size, 4x)',\n      // An explicit size ignores the host: these are 28/32/36, one `1x` above\n      // the 20/24/28 the swatch ends up at.\n      'size=small': '3.5x',\n      'size=medium': '4x',\n      'size=large': '4.5x',\n    },\n    '$swatch-size': '($swatch-host - 1x)',\n\n    width: '$swatch-size $swatch-size',\n    height: '$swatch-size $swatch-size',\n    radius: '1r',\n    fill: {\n      '': '(#color-picker, #clear)',\n      empty: '#clear',\n    },\n    shadow: 'inset 0 0 0 1bw #dark.15',\n    // A single diagonal stroke is the conventional \"no color\" swatch.\n    image: {\n      '': false,\n      empty:\n        'linear-gradient(to bottom right, #clear 46%, #danger 46%, #danger 54%, #clear 54%)',\n    },\n  },\n});\n\nexport interface CubeColorSwatchProps\n  extends BaseProps,\n    BaseStyleProps,\n    OuterStyleProps,\n    BlockStyleProps,\n    DimensionStyleProps {\n  /** The color to show. Anything the color inputs accept; `null` shows the empty state. */\n  color?: string | ColorValue | null;\n  /**\n   * The edge of the swatch: 20px, 24px or 28px. Left unset, the swatch tracks\n   * the control around it — `1x` inside its height — and falls back to `medium`\n   * where there is no control.\n   */\n  size?: 'small' | 'medium' | 'large' | (string & {});\n  styles?: Styles;\n}\n\n/**\n * A square of color. Decorative on its own — pair it with the value as text, or\n * with a control that names it.\n *\n * The color travels as an inline custom property rather than through `styles`,\n * so the swatch keeps a single cached style rule however often it changes.\n */\nexport const ColorSwatch = forwardRef(function ColorSwatch(\n  props: CubeColorSwatchProps,\n  ref: ForwardedRef<HTMLDivElement>,\n) {\n  const { color, mods, qa, size } = props;\n  const styles = extractStyles(props, STYLE_PROPS);\n\n  const resolved =\n    typeof color === 'string' ? parseColor(color) : color ?? null;\n\n  return (\n    <SwatchElement\n      ref={ref}\n      qa={qa}\n      data-size={size}\n      mods={{ empty: !resolved, ...mods }}\n      styles={styles}\n      style={resolved ? { '--color-picker-color': toHex(resolved) } : undefined}\n    />\n  );\n});\n"],"mappings":";;;;;;;;AAkBA,MAAM,cAAc;CAClB,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,gBAAgB,MAAM;CAC1B,IAAI;CACJ,QAAQ;EACN,SAAS;EAcT,gBAAgB;GAEd,IAAI;GAGJ,cAAc;GACd,eAAe;GACf,cAAc;GACf;EACD,gBAAgB;EAEhB,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,MAAM;GACJ,IAAI;GACJ,OAAO;GACR;EACD,QAAQ;EAER,OAAO;GACL,IAAI;GACJ,OACE;GACH;EACF;CACF,CAAC;;;;;;;;AA0BF,MAAa,cAAc,WAAW,SAAS,YAC7C,OACA,KACA;CACA,MAAM,EAAE,OAAO,MAAM,IAAI,SAAS;CAClC,MAAM,SAAS,cAAc,OAAO,YAAY;CAEhD,MAAM,WACJ,OAAO,UAAU,WAAW,WAAW,MAAM,GAAG,SAAS;AAE3D,QACE,oBAAC;EACM;EACD;EACJ,aAAW;EACX,MAAM;GAAE,OAAO,CAAC;GAAU,GAAG;GAAM;EAC3B;EACR,OAAO,WAAW,EAAE,wBAAwB,MAAM,SAAS,EAAE,GAAG;GAChE;EAEJ"}

package/dist/components/fields/ColorSwatch/index.d.ts

@@ -0,0 +1,2 @@
+
+import { ColorSwatch, CubeColorSwatchProps } from "./ColorSwatch.js";

package/dist/components/fields/ColorSwatchGroup/ColorSwatchGroup.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";

package/dist/components/fields/ComboBox/ComboBox.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { useLayoutEffect as useLayoutEffect$1 } from "../../../utils/react/useLayoutEffect.js";
 import { useCombinedRefs } from "../../../utils/react/useCombinedRefs.js";
@@ -11,7 +11,7 @@ import { useI18n } from "../../../i18n/useI18n.js";
 import { CloseIcon } from "../../../icons/CloseIcon.js";
 import { DirectionIcon } from "../../../icons/DirectionIcon.js";
 import { generateRandomId } from "../../../utils/random.js";
-import { getValidationMods, getValidationTheme } from "../../form/validation/resolve-validation-props.js";
+import { getValidationMods } from "../../form/validation/resolve-validation-props.js";
 import { getValidationIcon } from "../../form/validation/ValidationIndicator.js";
 import { useFieldProps } from "../../form/Form/use-field/use-field-props.js";
 import { wrapWithField } from "../../form/wrapper.js";
@@ -612,10 +612,6 @@ const ComboBox = forwardRef(function ComboBox(props, ref) {
 					showClearButton && /* @__PURE__ */ jsx(_CollectionItem.Action, {
 						icon: /* @__PURE__ */ jsx(CloseIcon, {}),
 						size,
-						theme: getValidationTheme(void 0, {
-							isInvalid,
-							isValid
-						}),
 						qa: "ComboBoxClearButton",
 						"data-no-trigger": hideTrigger ? "" : void 0,
 						"data-popover-dismiss": "",

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

@@ -1 +1 @@
-{"version":3,"file":"ComboBox.js","names":["useFocus","Item","BaseSection"],"sources":["../../../../src/components/fields/ComboBox/ComboBox.tsx"],"sourcesContent":["import { FocusableRef, Key } from '@react-types/shared';\nimport {\n  BASE_STYLES,\n  BasePropsWithoutChildren,\n  BaseStyleProps,\n  COLOR_STYLES,\n  ColorStyleProps,\n  OUTER_STYLES,\n  OuterStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport React, {\n  ForwardedRef,\n  forwardRef,\n  ReactElement,\n  ReactNode,\n  RefObject,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { useFilter, useKeyboard } from 'react-aria';\nimport { Section as BaseSection, useListState } from 'react-stately';\n\nimport { useEvent } from '../../../_internal';\nimport { useI18n } from '../../../i18n';\nimport { CloseIcon, DirectionIcon, LoadingIcon } from '../../../icons';\nimport { FieldBaseProps } from '../../../shared';\nimport { generateRandomId } from '../../../utils/random';\nimport { useCombinedRefs, useLayoutEffect } from '../../../utils/react';\nimport { useFocus } from '../../../utils/react/interactions';\nimport { usePopoverSync } from '../../../utils/react/usePopoverSync';\nimport { extractStyles } from '../../../utils/styles';\nimport { CollectionItem as Item } from '../../CollectionItem';\nimport {\n  getValidationIcon,\n  getValidationMods,\n  getValidationTheme,\n  useFieldProps,\n  wrapWithField,\n} from '../../form';\nimport {\n  filterCollectionNodes,\n  getEdgeVisibleKey,\n  getNextVisibleKey,\n  ListBoxPopover,\n  markKeyboardFocus,\n  useCompositeFocus,\n} from '../ListBoxPopover';\nimport {\n  DEFAULT_INPUT_STYLES,\n  INPUT_WRAPPER_STYLES,\n} from '../TextInput/TextInputBase';\n\ntype FilterFn = (textValue: string, inputValue: string) => boolean;\n\nexport type PopoverTriggerAction = 'focus' | 'input' | 'manual';\n\nconst ComboBoxWrapperElement = tasty({\n  qa: 'ComboBoxWrapper',\n  styles: INPUT_WRAPPER_STYLES,\n});\n\nconst InputElement = tasty({\n  as: 'input',\n  styles: DEFAULT_INPUT_STYLES,\n});\n\nexport interface CubeComboBoxProps<T>\n  extends BasePropsWithoutChildren,\n    BaseStyleProps,\n    OuterStyleProps,\n    ColorStyleProps,\n    FieldBaseProps {\n  /** The selected key in controlled mode */\n  selectedKey?: string | null;\n  /** The default selected key in uncontrolled mode */\n  defaultSelectedKey?: string | null;\n  /** Callback fired when selection changes */\n  onSelectionChange?: (key: string | null) => void;\n\n  /** The input value in controlled mode */\n  inputValue?: string;\n  /** The default input value in uncontrolled mode */\n  defaultInputValue?: string;\n  /** Callback fired when input value changes */\n  onInputChange?: (value: string) => void;\n  /** Placeholder text for the input */\n  placeholder?: string;\n  /** Whether the input should have autofocus */\n  autoFocus?: boolean;\n  /** HTML autocomplete attribute for the input */\n  autoComplete?: string;\n  /** Callback fired when focus enters the component (input, trigger, or popover). Does not receive event object. */\n  onFocus?: () => void;\n  /** Callback fired when focus leaves the component entirely. Does not receive event object. */\n  onBlur?: () => void;\n  /** Callback fired when a key is pressed on the input */\n  onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;\n\n  /** Popover trigger behavior: 'focus', 'input', or 'manual'. Defaults to 'input' */\n  popoverTrigger?: PopoverTriggerAction;\n\n  /** Items for the listbox (alternative to children) */\n  items?: Iterable<T>;\n  /** Children for the listbox (static items or render function) */\n  children?: ReactNode | ((item: T) => ReactElement);\n\n  /**\n   * Custom filter function for determining if an option should be included.\n   * Pass `false` to disable internal filtering completely.\n   */\n  filter?: FilterFn | false;\n\n  /** Whether to allow entering custom values that are not in the predefined options */\n  allowsCustomValue?: boolean;\n  /** Whether to commit custom value on blur in allowsCustomValue mode (default: true) */\n  shouldCommitOnBlur?: boolean;\n  /** Whether to clear selection and input on blur (default: false, only applies to non-custom-value mode) */\n  clearOnBlur?: boolean;\n  /** Whether the combobox is clearable using ESC key or clear button */\n  isClearable?: boolean;\n  /** Callback called when the clear button is pressed */\n  onClear?: () => void;\n\n  /** Left input icon */\n  icon?: ReactElement;\n  /** Input decoration before the main input */\n  prefix?: ReactNode;\n  /** Input decoration after the main input */\n  suffix?: ReactNode;\n  /** Whether to hide the trigger button */\n  hideTrigger?: boolean;\n  /** Size of the combobox */\n  size?: 'small' | 'medium' | 'large' | (string & {});\n\n  /** Ref for accessing the input element */\n  inputRef?: RefObject<HTMLInputElement>;\n  /** Ref for accessing the wrapper element */\n  wrapperRef?: RefObject<HTMLDivElement>;\n  /** Ref for accessing the listbox element */\n  listBoxRef?: RefObject<HTMLDivElement>;\n  /** Ref for accessing the popover element */\n  popoverRef?: RefObject<HTMLDivElement>;\n  /** Ref for accessing the trigger button element */\n  triggerRef?: FocusableRef<HTMLButtonElement>;\n\n  /** Custom styles for the input */\n  inputStyles?: Styles;\n  /** Custom styles for the trigger button */\n  triggerStyles?: Styles;\n  /** Custom styles for the listbox */\n  listBoxStyles?: Styles;\n  /** Custom styles for the popover overlay */\n  overlayStyles?: Styles;\n  /** Custom styles for individual options */\n  optionStyles?: Styles;\n  /** Custom styles for sections */\n  sectionStyles?: Styles;\n  /** Custom styles for section headings */\n  headingStyles?: Styles;\n\n  /** Whether the combobox is disabled */\n  isDisabled?: boolean;\n  /** Whether the combobox is in loading state */\n  isLoading?: boolean;\n  /** Keys of disabled items */\n  disabledKeys?: Iterable<Key>;\n  /** Whether to flip the popover placement */\n  shouldFlip?: boolean;\n  /** Placement direction for the popover */\n  direction?: 'bottom' | 'top';\n  /** Offset for the popover */\n  overlayOffset?: number;\n  /** Minimum padding in pixels between the popover and viewport edges */\n  containerPadding?: number;\n  /** Whether the combobox is read-only */\n  isReadOnly?: boolean;\n  /** Suffix position goes before or after the validation and loading statuses */\n  suffixPosition?: 'before' | 'after';\n  /**\n   * Sort selected item to the top when the popover opens.\n   * Only works when using the `items` prop (data-driven mode).\n   * Ignored when using JSX children.\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\n// ============================================================================\n// Hook: useComboBoxState\n// ============================================================================\ninterface UseComboBoxStateProps {\n  selectedKey?: string | null;\n  defaultSelectedKey?: string | null;\n  inputValue?: string;\n  defaultInputValue?: string;\n  comboBoxId: string;\n  triggerRef?: RefObject<HTMLElement | null>;\n  popoverRef?: RefObject<HTMLElement | null>;\n}\n\ninterface UseComboBoxStateReturn {\n  effectiveSelectedKey: Key | null;\n  effectiveInputValue: string;\n  isPopoverOpen: boolean;\n  setIsPopoverOpen: (open: boolean) => void;\n  setInternalSelectedKey: (key: Key | null) => void;\n  setInternalInputValue: (value: string) => void;\n  isControlledKey: boolean;\n  isControlledInput: boolean;\n}\n\nfunction useComboBoxState({\n  selectedKey,\n  defaultSelectedKey,\n  inputValue,\n  defaultInputValue,\n  comboBoxId,\n  triggerRef,\n  popoverRef,\n}: UseComboBoxStateProps): UseComboBoxStateReturn {\n  // Internal state for uncontrolled mode\n  const [internalSelectedKey, setInternalSelectedKey] = useState<Key | null>(\n    defaultSelectedKey ?? null,\n  );\n  const [internalInputValue, setInternalInputValue] = useState(\n    defaultInputValue ?? '',\n  );\n\n  const isControlledKey = selectedKey !== undefined;\n  const isControlledInput = inputValue !== undefined;\n\n  const effectiveSelectedKey = isControlledKey\n    ? selectedKey\n    : internalSelectedKey;\n  const effectiveInputValue = isControlledInput\n    ? inputValue\n    : internalInputValue;\n\n  // Popover state\n  const [isPopoverOpen, setIsPopoverOpen] = useState(false);\n\n  usePopoverSync({\n    menuId: comboBoxId,\n    isOpen: isPopoverOpen,\n    onClose: () => setIsPopoverOpen(false),\n    triggerRef,\n    containerRef: popoverRef,\n  });\n\n  return {\n    effectiveSelectedKey,\n    effectiveInputValue,\n    isPopoverOpen,\n    setIsPopoverOpen,\n    setInternalSelectedKey,\n    setInternalInputValue,\n    isControlledKey,\n    isControlledInput,\n  };\n}\n\n// ============================================================================\n// Hook: useComboBoxFiltering\n// ============================================================================\ninterface UseComboBoxFilteringProps {\n  effectiveInputValue: string;\n  filter: FilterFn | false | undefined;\n}\n\ninterface UseComboBoxFilteringReturn {\n  filterFn: (nodes: Iterable<any>) => Iterable<any>;\n  isFilterActive: boolean;\n  setIsFilterActive: (active: boolean) => void;\n}\n\nfunction useComboBoxFiltering({\n  effectiveInputValue,\n  filter,\n}: UseComboBoxFilteringProps): UseComboBoxFilteringReturn {\n  const [isFilterActive, setIsFilterActive] = useState(false);\n\n  const { contains } = useFilter({ sensitivity: 'base' });\n\n  const textFilterFn = useMemo<FilterFn>(\n    () => (filter === false ? () => true : filter || contains),\n    [filter, contains],\n  );\n\n  // Create a filter function for collection nodes\n  const filterFn = useCallback(\n    (nodes: Iterable<any>) => {\n      const term = effectiveInputValue.trim();\n\n      // Don't filter if not active or no search term\n      if (!isFilterActive || !term) {\n        return nodes;\n      }\n\n      return filterCollectionNodes(nodes, term, textFilterFn);\n    },\n    [isFilterActive, effectiveInputValue, textFilterFn],\n  );\n\n  return {\n    filterFn,\n    isFilterActive,\n    setIsFilterActive,\n  };\n}\n\n// ============================================================================\n// Hook: useComboBoxKeyboard\n// ============================================================================\ninterface UseComboBoxKeyboardProps {\n  isPopoverOpen: boolean;\n  listStateRef: RefObject<any>;\n  hasResults: boolean;\n  allowsCustomValue?: boolean;\n  effectiveInputValue: string;\n  isClearable?: boolean;\n  onSelectionChange: (selection: Key | Key[] | null) => void;\n  onClearValue: () => void;\n  onOpenPopover: () => void;\n  onClosePopover: () => void;\n  inputRef: RefObject<HTMLInputElement>;\n  setIsFilterActive: (active: boolean) => void;\n  onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;\n}\n\nfunction useComboBoxKeyboard({\n  isPopoverOpen,\n  listStateRef,\n  hasResults,\n  allowsCustomValue,\n  effectiveInputValue,\n  isClearable,\n  onSelectionChange,\n  onClearValue,\n  onOpenPopover,\n  onClosePopover,\n  inputRef,\n  setIsFilterActive,\n  onKeyDown,\n}: UseComboBoxKeyboardProps) {\n  const { keyboardProps } = useKeyboard({\n    onKeyDown: (e) => {\n      // Call user's handler first\n      onKeyDown?.(e as React.KeyboardEvent<HTMLInputElement>);\n\n      if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {\n        e.preventDefault();\n\n        // Open popover if closed\n        if (!isPopoverOpen) {\n          // If opening with no filtered results, disable filter to show all items\n          if (!hasResults) {\n            setIsFilterActive(false);\n          }\n          onOpenPopover();\n          return;\n        }\n\n        const listState = listStateRef.current;\n        if (!listState) return;\n\n        const isArrowDown = e.key === 'ArrowDown';\n        const nextKey = getNextVisibleKey(listState, isArrowDown ? 1 : -1);\n\n        if (nextKey != null) {\n          markKeyboardFocus(listState);\n          listState.selectionManager.setFocusedKey(nextKey);\n        }\n      } else if (e.key === 'Enter') {\n        // If popover is open, try to select the focused item first\n        if (isPopoverOpen) {\n          const listState = listStateRef.current;\n          if (listState) {\n            const keyToSelect = listState.selectionManager.focusedKey;\n\n            if (keyToSelect != null) {\n              e.preventDefault();\n              listState.selectionManager.select(keyToSelect, e);\n              // Ensure the popover closes even if selection stays the same\n              onClosePopover();\n              inputRef.current?.focus();\n              return;\n            }\n          }\n        }\n\n        // If no results, handle empty input or custom values\n        if (!hasResults) {\n          if (allowsCustomValue) {\n            const value = effectiveInputValue.trim();\n\n            // Commit the custom value\n            onSelectionChange(\n              (value as unknown as Key) ?? (null as unknown as Key),\n            );\n\n            // If popover is closed and we have a value, allow Enter to propagate for form submission\n            // If popover is open OR value is empty, prevent default to avoid premature submission\n            if (isPopoverOpen || !value) {\n              e.preventDefault();\n            }\n          } else {\n            e.preventDefault();\n            onSelectionChange(null);\n          }\n\n          return;\n        }\n\n        // Clear selection if input is empty and popover is closed (or no focused item)\n        const trimmed = (effectiveInputValue || '').trim();\n        if (trimmed === '') {\n          e.preventDefault();\n          onSelectionChange(null);\n          return;\n        }\n      } else if (e.key === 'Escape') {\n        if (isPopoverOpen) {\n          e.preventDefault();\n          onClosePopover();\n          inputRef.current?.focus();\n        } else if (effectiveInputValue && isClearable) {\n          e.preventDefault();\n          onClearValue();\n        }\n      } else if (e.key === 'Home' || e.key === 'End') {\n        if (isPopoverOpen) {\n          e.preventDefault();\n\n          const listState = listStateRef.current;\n          if (!listState) return;\n\n          const targetKey = getEdgeVisibleKey(\n            listState,\n            e.key === 'Home' ? 'first' : 'last',\n          );\n\n          if (targetKey != null) {\n            markKeyboardFocus(listState);\n            listState.selectionManager.setFocusedKey(targetKey);\n          }\n        }\n      }\n    },\n  });\n\n  return { keyboardProps };\n}\n\n// ============================================================================\n// Component: ComboBoxInput\n// ============================================================================\ninterface ComboBoxInputProps {\n  qa?: string;\n  inputRef: RefObject<HTMLInputElement>;\n  id?: string;\n  value: string;\n  placeholder?: string;\n  isDisabled?: boolean;\n  isReadOnly?: boolean;\n  autoFocus?: boolean;\n  autoComplete?: string;\n  size: string;\n  mods: Record<string, any>;\n  inputStyles?: Styles;\n  keyboardProps: any;\n  focusProps: any;\n  onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;\n  onFocus: (e: React.FocusEvent<HTMLInputElement>) => void;\n  isPopoverOpen: boolean;\n  hasResults: boolean;\n  comboBoxId: string;\n  listStateRef: RefObject<any>;\n}\n\nconst ComboBoxInput = forwardRef<HTMLInputElement, ComboBoxInputProps>(\n  function ComboBoxInput(\n    {\n      qa,\n      inputRef,\n      id,\n      value,\n      placeholder,\n      isDisabled,\n      isReadOnly,\n      autoFocus,\n      autoComplete,\n      size,\n      mods,\n      inputStyles,\n      keyboardProps,\n      focusProps,\n      onChange,\n      onFocus,\n      isPopoverOpen,\n      hasResults,\n      comboBoxId,\n      listStateRef,\n    },\n    ref,\n  ) {\n    const combinedRef = useCombinedRefs(ref, inputRef);\n\n    return (\n      <InputElement\n        ref={combinedRef}\n        qa={qa}\n        id={id}\n        type=\"text\"\n        value={value}\n        placeholder={placeholder}\n        isDisabled={isDisabled}\n        readOnly={isReadOnly}\n        autoFocus={autoFocus}\n        autoComplete={autoComplete}\n        data-autofocus={autoFocus ? '' : undefined}\n        onChange={onChange}\n        onFocus={onFocus}\n        onBlur={focusProps.onBlur}\n        {...keyboardProps}\n        styles={inputStyles}\n        mods={mods}\n        data-size={size}\n        data-input-type=\"combobox\"\n        role=\"combobox\"\n        aria-expanded={isPopoverOpen && hasResults}\n        aria-haspopup=\"listbox\"\n        aria-controls={\n          isPopoverOpen && hasResults\n            ? `ComboBoxListBox-${comboBoxId}`\n            : undefined\n        }\n        aria-activedescendant={\n          isPopoverOpen &&\n          hasResults &&\n          listStateRef.current?.selectionManager.focusedKey != null\n            ? `ListBoxItem-${listStateRef.current?.selectionManager.focusedKey}`\n            : undefined\n        }\n      />\n    );\n  },\n);\n\n// ============================================================================\n// Main Component: ComboBox\n// ============================================================================\nexport const ComboBox = forwardRef(function ComboBox<T extends object>(\n  props: CubeComboBoxProps<T>,\n  ref: ForwardedRef<HTMLDivElement>,\n) {\n  props = useFieldProps(props, {\n    valuePropsMapper: ({ value, onChange }) => {\n      return {\n        // Form value maps to selectedKey (the committed value) in both modes\n        selectedKey: value ?? null,\n        onSelectionChange(val: string | null) {\n          // Commit selection changes to the form\n          onChange(val);\n        },\n      };\n    },\n  });\n\n  const { t } = useI18n();\n\n  let {\n    qa,\n    label,\n    extra,\n    labelStyles,\n    isRequired,\n    necessityIndicator,\n    isInvalid,\n    isValid,\n    id,\n    icon,\n    prefix,\n    isDisabled,\n    autoFocus,\n    autoComplete = 'off',\n    wrapperRef,\n    inputRef,\n    triggerRef,\n    popoverRef,\n    listBoxRef,\n    isLoading,\n    inputStyles,\n    optionStyles,\n    triggerStyles,\n    listBoxStyles,\n    overlayStyles,\n    suffix,\n    hideTrigger,\n    message,\n    description,\n    size = 'medium',\n    direction = 'bottom',\n    shouldFlip = true,\n    popoverTrigger = 'input',\n    suffixPosition = 'before',\n    filter,\n    styles,\n    labelSuffix,\n    selectedKey,\n    defaultSelectedKey,\n    inputValue,\n    defaultInputValue,\n    onInputChange,\n    isClearable,\n    onClear,\n    placeholder,\n    allowsCustomValue,\n    shouldCommitOnBlur = true,\n    clearOnBlur,\n    items,\n    children: renderChildren,\n    sectionStyles,\n    headingStyles,\n    isReadOnly,\n    overlayOffset = 8,\n    containerPadding = 8,\n    onSelectionChange: externalOnSelectionChange,\n    sortSelectedToTop: sortSelectedToTopProp,\n    onOpenChange,\n    onFocus,\n    onBlur,\n    onKeyDown,\n    form,\n    ...otherProps\n  } = props;\n\n  // Generate a unique ID for this combobox instance\n  const comboBoxId = useMemo(() => generateRandomId(), []);\n\n  // Hoist the wrapper/popover ref normalization above `useComboBoxState` so\n  // the popover-sync inside it sees stable, attached refs. Other ref combines\n  // happen below alongside the legacy ordering.\n  wrapperRef = useCombinedRefs(wrapperRef);\n  popoverRef = useCombinedRefs(popoverRef);\n\n  // State management hook\n  const {\n    effectiveSelectedKey,\n    effectiveInputValue,\n    isPopoverOpen,\n    setIsPopoverOpen,\n    setInternalSelectedKey,\n    setInternalInputValue,\n    isControlledKey,\n    isControlledInput,\n  } = useComboBoxState({\n    selectedKey,\n    defaultSelectedKey,\n    inputValue,\n    defaultInputValue,\n    comboBoxId,\n    triggerRef: wrapperRef as RefObject<HTMLElement | null>,\n    popoverRef: popoverRef as RefObject<HTMLElement | null>,\n  });\n\n  // Track if sortSelectedToTop was explicitly provided\n  const sortSelectedToTopExplicit = sortSelectedToTopProp !== undefined;\n  // Default to true if items are provided, false otherwise\n  const sortSelectedToTop = sortSelectedToTopProp ?? (items ? true : false);\n\n  // Cache for sorted items array when using `items` prop\n  const cachedItemsOrder = useRef<T[] | null>(null);\n  const selectionWhenClosed = useRef<string | null>(null);\n\n  styles = extractStyles(otherProps, PROP_STYLES, styles);\n\n  ref = useCombinedRefs(ref);\n  inputRef = useCombinedRefs(inputRef);\n  triggerRef = useCombinedRefs(triggerRef);\n  listBoxRef = useCombinedRefs(listBoxRef);\n\n  // Sort items with selected on top if enabled\n  const getSortedItems = useCallback((): typeof items => {\n    if (!items) return items;\n\n    if (!sortSelectedToTop) return items;\n\n    // Reuse cached order if available\n    if (cachedItemsOrder.current) {\n      return cachedItemsOrder.current;\n    }\n\n    // Warn if explicitly requested but not supported\n    if (sortSelectedToTopExplicit && !items) {\n      console.warn(\n        'ComboBox: sortSelectedToTop only works with the items prop. ' +\n          'Sorting will be skipped when using JSX children.',\n      );\n      return items;\n    }\n\n    const selectedKey = isPopoverOpen\n      ? effectiveSelectedKey\n      : selectionWhenClosed.current;\n\n    if (!selectedKey) return items;\n\n    const itemsArray = Array.isArray(items) ? items : Array.from(items);\n    const selectedItem = itemsArray.find((item) => {\n      const key = (item as any)?.key ?? (item as any)?.id;\n      return key != null && String(key) === String(selectedKey);\n    });\n\n    if (!selectedItem) return items;\n\n    const sorted = [\n      selectedItem,\n      ...itemsArray.filter((item) => {\n        const key = (item as any)?.key ?? (item as any)?.id;\n        return key == null || String(key) !== String(selectedKey);\n      }),\n    ] as T[];\n\n    if (isPopoverOpen) {\n      cachedItemsOrder.current = sorted;\n    }\n\n    return sorted;\n  }, [\n    items,\n    sortSelectedToTop,\n    sortSelectedToTopExplicit,\n    effectiveSelectedKey,\n    isPopoverOpen,\n  ]);\n\n  const sortedItems = getSortedItems();\n\n  // Preserve the original `children` (may be a render function) before we\n  // potentially overwrite it.\n  let children: ReactNode = renderChildren as ReactNode;\n\n  const renderFn = renderChildren as unknown;\n\n  if (sortedItems && typeof renderFn === 'function') {\n    try {\n      const itemsArray = Array.from(sortedItems as Iterable<any>);\n      children = itemsArray.map((item, idx) => {\n        const rendered = (renderFn as (it: any) => ReactNode)(item);\n        if (\n          React.isValidElement(rendered) &&\n          (rendered as ReactElement).key == null\n        ) {\n          return React.cloneElement(rendered as ReactElement, {\n            key: (rendered as any)?.key ?? item?.key ?? idx,\n          });\n        }\n\n        return rendered as ReactNode;\n      });\n    } catch {\n      // If conversion fails, proceed with the original children\n    }\n  }\n\n  // Invalidate cached sorting whenever items change\n  useEffect(() => {\n    cachedItemsOrder.current = null;\n  }, [items]);\n\n  // Capture selection when popover closes\n  useEffect(() => {\n    if (!isPopoverOpen) {\n      selectionWhenClosed.current =\n        effectiveSelectedKey != null ? String(effectiveSelectedKey) : null;\n      cachedItemsOrder.current = null;\n    }\n  }, [isPopoverOpen, effectiveSelectedKey]);\n\n  // Call onOpenChange when popover state changes\n  useEffect(() => {\n    onOpenChange?.(isPopoverOpen);\n  }, [isPopoverOpen]);\n\n  // Filtering hook\n  const { filterFn, isFilterActive, setIsFilterActive } = useComboBoxFiltering({\n    effectiveInputValue,\n    filter,\n  });\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: sortedItems,\n    selectionMode: 'none', // Don't manage selection in this state\n  });\n\n  const { isFocused, focusProps } = useFocus({ isDisabled });\n\n  // Helper to check if current input value is valid\n  const checkInputValidity = useCallback(() => {\n    if (!effectiveInputValue.trim()) {\n      return { isInputValid: false, singleMatchKey: null, filteredCount: 0 };\n    }\n\n    // Get filtered collection based on current input\n    const filteredNodes = filterFn(localCollectionState.collection);\n    const filteredItems: Array<{ key: Key; textValue: string }> = [];\n\n    // Flatten filtered nodes (handle sections)\n    for (const node of filteredNodes) {\n      if (node.type === 'section' && node.childNodes) {\n        for (const child of node.childNodes) {\n          if (child.type === 'item') {\n            filteredItems.push({\n              key: child.key,\n              textValue: child.textValue || '',\n            });\n          }\n        }\n      } else if (node.type === 'item') {\n        filteredItems.push({\n          key: node.key,\n          textValue: node.textValue || '',\n        });\n      }\n    }\n\n    const filteredCount = filteredItems.length;\n\n    // Check for exact match\n    const exactMatch = filteredItems.find(\n      (item) =>\n        item.textValue.toLowerCase() ===\n        effectiveInputValue.trim().toLowerCase(),\n    );\n\n    if (exactMatch) {\n      return {\n        isInputValid: true,\n        singleMatchKey: exactMatch.key,\n        filteredCount,\n      };\n    }\n\n    // If exactly one filtered result, consider it valid\n    if (filteredCount === 1) {\n      return {\n        isInputValid: true,\n        singleMatchKey: filteredItems[0].key,\n        filteredCount,\n      };\n    }\n\n    return { isInputValid: false, singleMatchKey: null, filteredCount };\n  }, [effectiveInputValue, filterFn, localCollectionState.collection]);\n\n  // Composite blur handler - fires when focus leaves the entire component\n  const handleCompositeBlur = useEvent(() => {\n    // NOTE: Do NOT disable filter yet; we need it active for validity check\n\n    // In allowsCustomValue mode\n    if (allowsCustomValue) {\n      // Commit the input value if it's non-empty and nothing is selected\n      if (\n        shouldCommitOnBlur &&\n        effectiveInputValue &&\n        effectiveSelectedKey == null\n      ) {\n        externalOnSelectionChange?.(effectiveInputValue as string);\n        if (!isControlledKey) {\n          setInternalSelectedKey(effectiveInputValue as Key);\n        }\n        onBlur?.();\n        setIsFilterActive(false);\n        return;\n      }\n\n      // Clear selection if input is empty\n      if (!String(effectiveInputValue).trim()) {\n        externalOnSelectionChange?.(null);\n        if (!isControlledKey) {\n          setInternalSelectedKey(null);\n        }\n        if (!isControlledInput) {\n          setInternalInputValue('');\n        }\n        onInputChange?.('');\n        onBlur?.();\n        setIsFilterActive(false);\n        return;\n      }\n    }\n\n    // In non-custom-value mode, validate input and handle accordingly\n    if (!allowsCustomValue) {\n      const { isInputValid, singleMatchKey } = checkInputValidity();\n\n      // If there's exactly one filtered result, auto-select it\n      if (\n        isInputValid &&\n        singleMatchKey != null &&\n        singleMatchKey !== effectiveSelectedKey\n      ) {\n        const label = getItemLabel(singleMatchKey);\n\n        if (!isControlledKey) {\n          setInternalSelectedKey(singleMatchKey);\n        }\n        if (!isControlledInput) {\n          setInternalInputValue(label);\n        }\n        onInputChange?.(label);\n        externalOnSelectionChange?.(singleMatchKey as string | null);\n        onBlur?.();\n        setIsFilterActive(false);\n        return;\n      }\n\n      // If input is invalid (no exact match, not a single result)\n      if (!isInputValid) {\n        const trimmedInput = effectiveInputValue.trim();\n\n        // Clear if clearOnBlur is set or input is empty\n        if (clearOnBlur || !trimmedInput) {\n          externalOnSelectionChange?.(null);\n          if (!isControlledKey) {\n            setInternalSelectedKey(null);\n          }\n          if (!isControlledInput) {\n            setInternalInputValue('');\n          }\n          onInputChange?.('');\n          onBlur?.();\n          setIsFilterActive(false);\n          return;\n        }\n\n        // Reset input to current selected value (or empty if none)\n        const nextValue =\n          effectiveSelectedKey != null\n            ? getItemLabel(effectiveSelectedKey)\n            : '';\n\n        if (!isControlledInput) {\n          setInternalInputValue(nextValue);\n        }\n        onInputChange?.(nextValue);\n        onBlur?.();\n        setIsFilterActive(false);\n        return;\n      }\n    }\n\n    // Fallback: Reset input to show current selection (or empty if none)\n    const nextValue =\n      effectiveSelectedKey != null ? getItemLabel(effectiveSelectedKey) : '';\n\n    if (!isControlledInput) {\n      setInternalInputValue(nextValue);\n    }\n    onInputChange?.(nextValue);\n    onBlur?.();\n    setIsFilterActive(false);\n  });\n\n  // Composite focus hook - handles focus tracking across wrapper and portaled popover\n  const { compositeFocusProps } = useCompositeFocus({\n    wrapperRef,\n    popoverRef,\n    onFocus,\n    onBlur: handleCompositeBlur,\n    isDisabled,\n  });\n\n  let validationIcon = getValidationIcon({ isInvalid, isValid });\n\n  // Ref to access internal ListBox state\n  const listStateRef = useRef<any>(null);\n  const focusInitAttemptsRef = useRef(0);\n\n  // Helper to get label from local collection\n  const getItemLabel = useCallback(\n    (key: Key): string => {\n      const item = localCollectionState?.collection?.getItem(key);\n      return item?.textValue || String(key);\n    },\n    [localCollectionState?.collection],\n  );\n\n  // Selection change handler\n  const handleSelectionChange = useEvent((selection: Key | Key[] | null) => {\n    // Extract single key from selection (we only support single selection)\n    const key = Array.isArray(selection) ? selection[0] : selection;\n\n    // Update selected key\n    if (!isControlledKey) {\n      setInternalSelectedKey(key ?? null);\n    }\n\n    // Update input value to show selected item label\n    if (key != null) {\n      setIsFilterActive(false);\n\n      const label = getItemLabel(key);\n\n      if (!isControlledInput) {\n        setInternalInputValue(label);\n      }\n      onInputChange?.(label);\n    } else {\n      // Clear input when selection is cleared\n      if (!isControlledInput) {\n        setInternalInputValue('');\n      }\n      onInputChange?.('');\n      setIsFilterActive(false);\n    }\n\n    externalOnSelectionChange?.(key as string | null);\n\n    // Close popover after selection\n    setIsPopoverOpen(false);\n\n    // Focus input\n    setTimeout(() => {\n      inputRef.current?.focus();\n    }, 0);\n  });\n\n  // Input change handler\n  const handleInputChange = useEvent(\n    (e: React.ChangeEvent<HTMLInputElement>) => {\n      const value = e.target.value;\n\n      // Update input value\n      if (!isControlledInput) {\n        setInternalInputValue(value);\n      }\n      onInputChange?.(value);\n\n      const trimmed = value.trim();\n      setIsFilterActive(trimmed.length > 0);\n\n      // Only clear selection in allowsCustomValue mode\n      // In normal mode, typing just filters - selection stays until explicitly changed\n      if (allowsCustomValue && effectiveSelectedKey != null) {\n        if (!isControlledKey) {\n          setInternalSelectedKey(null);\n        }\n        externalOnSelectionChange?.(null);\n      }\n\n      // Open popover based on trigger\n      if (popoverTrigger !== 'manual' && value && !isPopoverOpen) {\n        setIsPopoverOpen(true);\n      }\n    },\n  );\n\n  // Initialize input value from defaultInputValue or defaultSelectedKey (uncontrolled mode only, one-time)\n  const [hasInitialized, setHasInitialized] = useState(false);\n\n  useEffect(() => {\n    // Only initialize once, in uncontrolled input mode\n    if (hasInitialized || isControlledInput) return;\n\n    // Priority 1: defaultInputValue takes precedence\n    if (defaultInputValue !== undefined) {\n      setInternalInputValue(defaultInputValue);\n      setHasInitialized(true);\n      return;\n    }\n\n    // Priority 2: fall back to defaultSelectedKey's label\n    if (defaultSelectedKey) {\n      const label = getItemLabel(defaultSelectedKey);\n\n      setInternalInputValue(label);\n      setHasInitialized(true);\n    }\n  }, [\n    hasInitialized,\n    isControlledInput,\n    defaultInputValue,\n    defaultSelectedKey,\n    getItemLabel,\n    children,\n  ]);\n\n  // Sync input value with controlled selectedKey\n  const lastSyncedSelectedKey = useRef<Key | null | undefined>(undefined);\n\n  useEffect(() => {\n    // Only run when selectedKey is controlled but inputValue is uncontrolled\n    if (!isControlledKey || isControlledInput) return;\n\n    // Skip if the key hasn't actually changed (prevents unnecessary resets when collection rebuilds)\n    if (\n      lastSyncedSelectedKey.current !== undefined &&\n      lastSyncedSelectedKey.current === effectiveSelectedKey\n    ) {\n      return;\n    }\n\n    lastSyncedSelectedKey.current = effectiveSelectedKey;\n\n    // Get the expected label for the current selection\n    const expectedLabel =\n      effectiveSelectedKey != null ? getItemLabel(effectiveSelectedKey) : '';\n\n    // Update the input value to match the selected key's label\n    setInternalInputValue(expectedLabel);\n  }, [isControlledKey, isControlledInput, effectiveSelectedKey, getItemLabel]);\n\n  // Input focus handler\n  const handleInputFocus = useEvent((e: React.FocusEvent<HTMLInputElement>) => {\n    // Call focus props handler if it exists\n    focusProps.onFocus?.(e as any);\n\n    if (popoverTrigger === 'focus' && !isPopoverOpen) {\n      setIsPopoverOpen(true);\n    }\n  });\n\n  // Input blur handler - just handles internal focus props\n  const handleInputBlur = useEvent((e: React.FocusEvent<HTMLInputElement>) => {\n    focusProps.onBlur?.(e as any);\n  });\n\n  // Clear button logic\n  let hasValue = allowsCustomValue\n    ? effectiveInputValue !== ''\n    : effectiveSelectedKey != null;\n  let showClearButton = isClearable && hasValue && !isDisabled && !isReadOnly;\n\n  // Check if there are any results after filtering\n  const hasResults = useMemo(() => {\n    if (!children) return false;\n    if (!Array.isArray(children) && children === null) return false;\n\n    // If we have a collection, check if filtering will produce any results\n    if (localCollectionState?.collection) {\n      const filteredNodes = filterFn(localCollectionState.collection);\n      const resultArray = Array.from(filteredNodes).flatMap((node: any) => {\n        if (node.type === 'section' && node.childNodes) {\n          return [...node.childNodes];\n        }\n\n        return [node];\n      });\n      return resultArray.length > 0;\n    }\n\n    // Fallback: check if children exists\n    return Array.isArray(children) ? children.length > 0 : true;\n  }, [children, localCollectionState?.collection, filterFn]);\n\n  // Clear function\n  let clearValue = useEvent(() => {\n    // Clear input\n    if (!isControlledInput) {\n      setInternalInputValue('');\n    }\n    onInputChange?.('');\n\n    // Clear selection\n    if (!isControlledKey) {\n      setInternalSelectedKey(null);\n    }\n    externalOnSelectionChange?.(null);\n\n    // Close popover\n    if (isPopoverOpen) {\n      setIsPopoverOpen(false);\n    }\n\n    // Focus input\n    inputRef.current?.focus();\n\n    onClear?.();\n  });\n\n  // Keyboard navigation hook\n  const { keyboardProps } = useComboBoxKeyboard({\n    isPopoverOpen,\n    listStateRef,\n    hasResults,\n    allowsCustomValue,\n    effectiveInputValue,\n    isClearable,\n    onSelectionChange: handleSelectionChange,\n    onClearValue: clearValue,\n    onOpenPopover: () => setIsPopoverOpen(true),\n    onClosePopover: () => setIsPopoverOpen(false),\n    inputRef,\n    setIsFilterActive,\n    onKeyDown,\n  });\n\n  if (icon) {\n    icon = <div data-element=\"InputIcon\">{icon}</div>;\n\n    if (prefix) {\n      prefix = (\n        <>\n          {icon}\n          {prefix}\n        </>\n      );\n    } else {\n      prefix = icon;\n    }\n  }\n\n  let mods = useMemo(\n    () => ({\n      ...getValidationMods({ isInvalid, isValid }),\n      disabled: isDisabled,\n      hovered: false,\n      focused: isFocused,\n      loading: isLoading,\n      prefix: !!prefix,\n      suffix: true,\n      clearable: showClearButton,\n    }),\n    [\n      isInvalid,\n      isValid,\n      isDisabled,\n      isFocused,\n      isLoading,\n      prefix,\n      showClearButton,\n    ],\n  );\n\n  const comboBoxWidth = wrapperRef?.current?.offsetWidth;\n\n  const shouldShowPopover = Boolean(isPopoverOpen && hasResults);\n\n  // Close popover if no results\n  useEffect(() => {\n    if (isPopoverOpen && !hasResults) {\n      setIsPopoverOpen(false);\n    }\n  }, [isPopoverOpen, hasResults]);\n\n  const ensureInitialFocus = useCallback(() => {\n    if (!shouldShowPopover) return;\n\n    const listState = listStateRef.current;\n    if (!listState) return;\n\n    const { selectionManager, collection, disabledKeys, lastFocusSourceRef } =\n      listState;\n    if (!selectionManager || !collection) return;\n\n    const collectFirstKey = (): Key | null => {\n      for (const node of collection) {\n        if (node.type === 'item') {\n          if (!disabledKeys?.has(node.key)) return node.key;\n        } else if (node.childNodes) {\n          for (const child of node.childNodes) {\n            if (child.type === 'item' && !disabledKeys?.has(child.key)) {\n              return child.key;\n            }\n          }\n        }\n      }\n      return null;\n    };\n\n    if (lastFocusSourceRef) lastFocusSourceRef.current = 'keyboard';\n\n    // Check if we need to set or update focus\n    const currentFocusedKey = selectionManager.focusedKey;\n    let needsRefocus = false;\n\n    if (currentFocusedKey == null) {\n      // No focus at all - need to set initial focus\n      needsRefocus = true;\n    } else {\n      // Check if currently focused key still exists in the collection\n      const focusedItemExists = collection.getItem(currentFocusedKey) != null;\n      if (!focusedItemExists) {\n        // Focused item was filtered out - need to refocus\n        needsRefocus = true;\n      }\n    }\n\n    if (needsRefocus) {\n      let keyToFocus: Key | null = null;\n\n      // First try to focus on the selected key if it exists in the collection\n      if (\n        effectiveSelectedKey != null &&\n        collection.getItem(effectiveSelectedKey) != null\n      ) {\n        keyToFocus = effectiveSelectedKey;\n      } else {\n        // Fall back to the first key in the collection\n        keyToFocus = collectFirstKey();\n      }\n\n      if (keyToFocus != null) {\n        selectionManager.setFocusedKey(keyToFocus);\n      }\n    }\n  }, [shouldShowPopover, effectiveSelectedKey]);\n\n  useLayoutEffect(() => {\n    if (!shouldShowPopover) return;\n    focusInitAttemptsRef.current = 0;\n\n    const tick = () => {\n      if (!shouldShowPopover) return;\n      ensureInitialFocus();\n      focusInitAttemptsRef.current += 1;\n      // Try a few frames to wait for collection to mount\n      if (\n        focusInitAttemptsRef.current < 8 &&\n        listStateRef.current?.selectionManager?.focusedKey == null\n      ) {\n        requestAnimationFrame(tick);\n      }\n    };\n\n    requestAnimationFrame(() => requestAnimationFrame(tick));\n  }, [shouldShowPopover, ensureInitialFocus]);\n\n  const comboBoxField = (\n    <ComboBoxWrapperElement\n      ref={wrapperRef}\n      mods={mods}\n      styles={styles}\n      style={{\n        zIndex: isFocused ? 1 : 'initial',\n      }}\n      data-size={size}\n      {...compositeFocusProps}\n    >\n      {prefix ? <div data-element=\"Prefix\">{prefix}</div> : null}\n      <ComboBoxInput\n        qa={qa || 'ComboBox'}\n        inputRef={inputRef}\n        id={id}\n        value={effectiveInputValue}\n        placeholder={placeholder}\n        isDisabled={isDisabled}\n        isReadOnly={isReadOnly}\n        autoFocus={autoFocus}\n        autoComplete={autoComplete}\n        size={size}\n        mods={mods}\n        inputStyles={inputStyles}\n        keyboardProps={keyboardProps}\n        focusProps={{ ...focusProps, onBlur: handleInputBlur }}\n        isPopoverOpen={isPopoverOpen}\n        hasResults={hasResults}\n        comboBoxId={comboBoxId}\n        listStateRef={listStateRef}\n        onChange={handleInputChange}\n        onFocus={handleInputFocus}\n      />\n      <div data-element=\"Suffix\">\n        {suffixPosition === 'before' ? suffix : null}\n        {isLoading ? <LoadingIcon data-element=\"InputIcon\" /> : validationIcon}\n        {suffixPosition === 'after' ? suffix : null}\n        {showClearButton && (\n          <Item.Action\n            icon={<CloseIcon />}\n            size={size}\n            theme={getValidationTheme(undefined, { isInvalid, isValid })}\n            qa=\"ComboBoxClearButton\"\n            data-no-trigger={hideTrigger ? '' : undefined}\n            data-popover-dismiss=\"\"\n            aria-label={t('comboBox.clearValue', 'Clear value')}\n            onPress={clearValue}\n          />\n        )}\n        {!hideTrigger ? (\n          <Item.Action\n            ref={triggerRef}\n            data-popover-trigger\n            icon={<DirectionIcon to={isPopoverOpen ? 'up' : 'down'} />}\n            qa=\"ComboBoxTrigger\"\n            mods={{\n              pressed: isPopoverOpen,\n              disabled: isDisabled,\n              loading: isLoading,\n            }}\n            data-size={size}\n            isDisabled={isDisabled}\n            styles={triggerStyles}\n            aria-expanded={isPopoverOpen}\n            aria-haspopup=\"listbox\"\n            aria-label={t('comboBox.showOptions', 'Show options')}\n            onPress={() => {\n              if (!isDisabled) {\n                const willOpen = !isPopoverOpen;\n                setIsPopoverOpen(willOpen);\n                if (willOpen) {\n                  inputRef.current?.focus();\n                  // If opening with no filtered results, disable filter to show all items\n                  if (!hasResults) {\n                    setIsFilterActive(false);\n                  }\n                }\n              }\n            }}\n          />\n        ) : null}\n      </div>\n      <ListBoxPopover\n        isOpen={shouldShowPopover}\n        triggerRef={wrapperRef as RefObject<HTMLElement>}\n        popoverRef={popoverRef}\n        listBoxRef={listBoxRef}\n        direction={direction}\n        shouldFlip={shouldFlip}\n        overlayOffset={overlayOffset}\n        containerPadding={containerPadding}\n        comboBoxWidth={comboBoxWidth}\n        listBoxId={`ComboBoxListBox-${comboBoxId}`}\n        overlayStyles={overlayStyles}\n        listBoxStyles={listBoxStyles}\n        optionStyles={optionStyles}\n        sectionStyles={sectionStyles}\n        headingStyles={headingStyles}\n        selectedKey={effectiveSelectedKey}\n        isDisabled={isDisabled}\n        disabledKeys={props.disabledKeys}\n        items={sortedItems}\n        listStateRef={listStateRef}\n        label={label}\n        ariaLabel={(props as any)['aria-label']}\n        compositeFocusProps={compositeFocusProps}\n        filter={filterFn}\n        size={size}\n        onSelectionChange={handleSelectionChange}\n        onClose={() => setIsPopoverOpen(false)}\n      >\n        {children}\n      </ListBoxPopover>\n    </ComboBoxWrapperElement>\n  );\n\n  const { children: _, ...propsWithoutChildren } = props;\n\n  return wrapWithField<Omit<CubeComboBoxProps<T>, 'children'>>(\n    comboBoxField,\n    ref,\n    propsWithoutChildren,\n  );\n}) as unknown as (<T>(\n  props: CubeComboBoxProps<T> & { ref?: ForwardedRef<HTMLDivElement> },\n) => ReactElement) & { Item: typeof Item; Section: typeof BaseSection };\n\nComboBox.Item = Item;\n\nComboBox.Section = BaseSection;\n\nObject.defineProperty(ComboBox, 'cubeInputType', {\n  value: 'ComboBox',\n  enumerable: false,\n  configurable: false,\n});\n"],"mappings":"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CA,MACA,aACA,eACA,YACA,UACA,SACA,eACA,YACA,YACA,gBAEF,KACA;AAGA,QACE,oBAAC;EACC,KAJgB,gBAAgB,KAAK,SAAS;EAK1C;EACA;EACJ,MAAK;EACE;EACM;EACD;EACZ,UAAU;EACC;EACG;EACd,kBAAgB,YAAY,KAAK;EACvB;EACD;EACT,QAAQ,WAAW;EACnB,GAAI;EACJ,QAAQ;EACF;EACN,aAAW;EACX,mBAAgB;EAChB,MAAK;EACL,iBAAe,iBAAiB;EAChC,iBAAc;EACd,iBACE,iBAAiB,aACb,mBAAmB,eACnB;EAEN,yBACE,iBACA,cACA,aAAa,SAAS,iBAAiB,cAAc,OACjD,eAAe,aAAa,SAAS,iBAAiB,eACtD;GAEN;EAGP;AAKD,MAAa,WAAW,WAAW,SAAS,SAC1C,OACA,KACA;AACA,SAAQ,cAAc,OAAO,EAC3B,mBAAmB,EAAE,OAAO,eAAe;AACzC,SAAO;GAEL,aAAa,SAAS;GACtB,kBAAkB,KAAoB;AAEpC,aAAS,IAAI;;GAEhB;IAEJ,CAAC;CAEF,MAAM,EAAE,MAAM,SAAS;CAEvB,IAAI,EACF,IACA,OACA,OACA,aACA,YACA,oBACA,WACA,SACA,IACA,MACA,QACA,YACA,WACA,eAAe,OACf,YACA,UACA,YACA,YACA,YACA,WACA,aACA,cACA,eACA,eACA,eACA,QACA,aACA,SACA,aACA,OAAO,UACP,YAAY,UACZ,aAAa,MACb,iBAAiB,SACjB,iBAAiB,UACjB,QACA,QACA,aACA,aACA,oBACA,YACA,mBACA,eACA,aACA,SACA,aACA,mBACA,qBAAqB,MACrB,aACA,OACA,UAAU,gBACV,eACA,eACA,YACA,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,2BACnB,mBAAmB,uBACnB,cACA,SACA,QACA,WACA,MACA,GAAG,eACD;CAGJ,MAAM,aAAa,cAAc,kBAAkB,EAAE,EAAE,CAAC;AAKxD,cAAa,gBAAgB,WAAW;AACxC,cAAa,gBAAgB,WAAW;CAGxC,MAAM,EACJ,sBACA,qBACA,eACA,kBACA,wBACA,uBACA,iBACA,sBACE,iBAAiB;EACnB;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"}
+{"version":3,"file":"ComboBox.js","names":["useFocus","Item","BaseSection"],"sources":["../../../../src/components/fields/ComboBox/ComboBox.tsx"],"sourcesContent":["import { FocusableRef, Key } from '@react-types/shared';\nimport {\n  BASE_STYLES,\n  BasePropsWithoutChildren,\n  BaseStyleProps,\n  COLOR_STYLES,\n  ColorStyleProps,\n  OUTER_STYLES,\n  OuterStyleProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport React, {\n  ForwardedRef,\n  forwardRef,\n  ReactElement,\n  ReactNode,\n  RefObject,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { useFilter, useKeyboard } from 'react-aria';\nimport { Section as BaseSection, useListState } from 'react-stately';\n\nimport { useEvent } from '../../../_internal';\nimport { useI18n } from '../../../i18n';\nimport { CloseIcon, DirectionIcon, LoadingIcon } from '../../../icons';\nimport { FieldBaseProps } from '../../../shared';\nimport { generateRandomId } from '../../../utils/random';\nimport { useCombinedRefs, useLayoutEffect } from '../../../utils/react';\nimport { useFocus } from '../../../utils/react/interactions';\nimport { usePopoverSync } from '../../../utils/react/usePopoverSync';\nimport { extractStyles } from '../../../utils/styles';\nimport { CollectionItem as Item } from '../../CollectionItem';\nimport {\n  getValidationIcon,\n  getValidationMods,\n  useFieldProps,\n  wrapWithField,\n} from '../../form';\nimport {\n  filterCollectionNodes,\n  getEdgeVisibleKey,\n  getNextVisibleKey,\n  ListBoxPopover,\n  markKeyboardFocus,\n  useCompositeFocus,\n} from '../ListBoxPopover';\nimport {\n  DEFAULT_INPUT_STYLES,\n  INPUT_WRAPPER_STYLES,\n} from '../TextInput/TextInputBase';\n\ntype FilterFn = (textValue: string, inputValue: string) => boolean;\n\nexport type PopoverTriggerAction = 'focus' | 'input' | 'manual';\n\nconst ComboBoxWrapperElement = tasty({\n  qa: 'ComboBoxWrapper',\n  styles: INPUT_WRAPPER_STYLES,\n});\n\nconst InputElement = tasty({\n  as: 'input',\n  styles: DEFAULT_INPUT_STYLES,\n});\n\nexport interface CubeComboBoxProps<T>\n  extends BasePropsWithoutChildren,\n    BaseStyleProps,\n    OuterStyleProps,\n    ColorStyleProps,\n    FieldBaseProps {\n  /** The selected key in controlled mode */\n  selectedKey?: string | null;\n  /** The default selected key in uncontrolled mode */\n  defaultSelectedKey?: string | null;\n  /** Callback fired when selection changes */\n  onSelectionChange?: (key: string | null) => void;\n\n  /** The input value in controlled mode */\n  inputValue?: string;\n  /** The default input value in uncontrolled mode */\n  defaultInputValue?: string;\n  /** Callback fired when input value changes */\n  onInputChange?: (value: string) => void;\n  /** Placeholder text for the input */\n  placeholder?: string;\n  /** Whether the input should have autofocus */\n  autoFocus?: boolean;\n  /** HTML autocomplete attribute for the input */\n  autoComplete?: string;\n  /** Callback fired when focus enters the component (input, trigger, or popover). Does not receive event object. */\n  onFocus?: () => void;\n  /** Callback fired when focus leaves the component entirely. Does not receive event object. */\n  onBlur?: () => void;\n  /** Callback fired when a key is pressed on the input */\n  onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;\n\n  /** Popover trigger behavior: 'focus', 'input', or 'manual'. Defaults to 'input' */\n  popoverTrigger?: PopoverTriggerAction;\n\n  /** Items for the listbox (alternative to children) */\n  items?: Iterable<T>;\n  /** Children for the listbox (static items or render function) */\n  children?: ReactNode | ((item: T) => ReactElement);\n\n  /**\n   * Custom filter function for determining if an option should be included.\n   * Pass `false` to disable internal filtering completely.\n   */\n  filter?: FilterFn | false;\n\n  /** Whether to allow entering custom values that are not in the predefined options */\n  allowsCustomValue?: boolean;\n  /** Whether to commit custom value on blur in allowsCustomValue mode (default: true) */\n  shouldCommitOnBlur?: boolean;\n  /** Whether to clear selection and input on blur (default: false, only applies to non-custom-value mode) */\n  clearOnBlur?: boolean;\n  /** Whether the combobox is clearable using ESC key or clear button */\n  isClearable?: boolean;\n  /** Callback called when the clear button is pressed */\n  onClear?: () => void;\n\n  /** Left input icon */\n  icon?: ReactElement;\n  /** Input decoration before the main input */\n  prefix?: ReactNode;\n  /** Input decoration after the main input */\n  suffix?: ReactNode;\n  /** Whether to hide the trigger button */\n  hideTrigger?: boolean;\n  /** Size of the combobox */\n  size?: 'small' | 'medium' | 'large' | (string & {});\n\n  /** Ref for accessing the input element */\n  inputRef?: RefObject<HTMLInputElement>;\n  /** Ref for accessing the wrapper element */\n  wrapperRef?: RefObject<HTMLDivElement>;\n  /** Ref for accessing the listbox element */\n  listBoxRef?: RefObject<HTMLDivElement>;\n  /** Ref for accessing the popover element */\n  popoverRef?: RefObject<HTMLDivElement>;\n  /** Ref for accessing the trigger button element */\n  triggerRef?: FocusableRef<HTMLButtonElement>;\n\n  /** Custom styles for the input */\n  inputStyles?: Styles;\n  /** Custom styles for the trigger button */\n  triggerStyles?: Styles;\n  /** Custom styles for the listbox */\n  listBoxStyles?: Styles;\n  /** Custom styles for the popover overlay */\n  overlayStyles?: Styles;\n  /** Custom styles for individual options */\n  optionStyles?: Styles;\n  /** Custom styles for sections */\n  sectionStyles?: Styles;\n  /** Custom styles for section headings */\n  headingStyles?: Styles;\n\n  /** Whether the combobox is disabled */\n  isDisabled?: boolean;\n  /** Whether the combobox is in loading state */\n  isLoading?: boolean;\n  /** Keys of disabled items */\n  disabledKeys?: Iterable<Key>;\n  /** Whether to flip the popover placement */\n  shouldFlip?: boolean;\n  /** Placement direction for the popover */\n  direction?: 'bottom' | 'top';\n  /** Offset for the popover */\n  overlayOffset?: number;\n  /** Minimum padding in pixels between the popover and viewport edges */\n  containerPadding?: number;\n  /** Whether the combobox is read-only */\n  isReadOnly?: boolean;\n  /** Suffix position goes before or after the validation and loading statuses */\n  suffixPosition?: 'before' | 'after';\n  /**\n   * Sort selected item to the top when the popover opens.\n   * Only works when using the `items` prop (data-driven mode).\n   * Ignored when using JSX children.\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\n// ============================================================================\n// Hook: useComboBoxState\n// ============================================================================\ninterface UseComboBoxStateProps {\n  selectedKey?: string | null;\n  defaultSelectedKey?: string | null;\n  inputValue?: string;\n  defaultInputValue?: string;\n  comboBoxId: string;\n  triggerRef?: RefObject<HTMLElement | null>;\n  popoverRef?: RefObject<HTMLElement | null>;\n}\n\ninterface UseComboBoxStateReturn {\n  effectiveSelectedKey: Key | null;\n  effectiveInputValue: string;\n  isPopoverOpen: boolean;\n  setIsPopoverOpen: (open: boolean) => void;\n  setInternalSelectedKey: (key: Key | null) => void;\n  setInternalInputValue: (value: string) => void;\n  isControlledKey: boolean;\n  isControlledInput: boolean;\n}\n\nfunction useComboBoxState({\n  selectedKey,\n  defaultSelectedKey,\n  inputValue,\n  defaultInputValue,\n  comboBoxId,\n  triggerRef,\n  popoverRef,\n}: UseComboBoxStateProps): UseComboBoxStateReturn {\n  // Internal state for uncontrolled mode\n  const [internalSelectedKey, setInternalSelectedKey] = useState<Key | null>(\n    defaultSelectedKey ?? null,\n  );\n  const [internalInputValue, setInternalInputValue] = useState(\n    defaultInputValue ?? '',\n  );\n\n  const isControlledKey = selectedKey !== undefined;\n  const isControlledInput = inputValue !== undefined;\n\n  const effectiveSelectedKey = isControlledKey\n    ? selectedKey\n    : internalSelectedKey;\n  const effectiveInputValue = isControlledInput\n    ? inputValue\n    : internalInputValue;\n\n  // Popover state\n  const [isPopoverOpen, setIsPopoverOpen] = useState(false);\n\n  usePopoverSync({\n    menuId: comboBoxId,\n    isOpen: isPopoverOpen,\n    onClose: () => setIsPopoverOpen(false),\n    triggerRef,\n    containerRef: popoverRef,\n  });\n\n  return {\n    effectiveSelectedKey,\n    effectiveInputValue,\n    isPopoverOpen,\n    setIsPopoverOpen,\n    setInternalSelectedKey,\n    setInternalInputValue,\n    isControlledKey,\n    isControlledInput,\n  };\n}\n\n// ============================================================================\n// Hook: useComboBoxFiltering\n// ============================================================================\ninterface UseComboBoxFilteringProps {\n  effectiveInputValue: string;\n  filter: FilterFn | false | undefined;\n}\n\ninterface UseComboBoxFilteringReturn {\n  filterFn: (nodes: Iterable<any>) => Iterable<any>;\n  isFilterActive: boolean;\n  setIsFilterActive: (active: boolean) => void;\n}\n\nfunction useComboBoxFiltering({\n  effectiveInputValue,\n  filter,\n}: UseComboBoxFilteringProps): UseComboBoxFilteringReturn {\n  const [isFilterActive, setIsFilterActive] = useState(false);\n\n  const { contains } = useFilter({ sensitivity: 'base' });\n\n  const textFilterFn = useMemo<FilterFn>(\n    () => (filter === false ? () => true : filter || contains),\n    [filter, contains],\n  );\n\n  // Create a filter function for collection nodes\n  const filterFn = useCallback(\n    (nodes: Iterable<any>) => {\n      const term = effectiveInputValue.trim();\n\n      // Don't filter if not active or no search term\n      if (!isFilterActive || !term) {\n        return nodes;\n      }\n\n      return filterCollectionNodes(nodes, term, textFilterFn);\n    },\n    [isFilterActive, effectiveInputValue, textFilterFn],\n  );\n\n  return {\n    filterFn,\n    isFilterActive,\n    setIsFilterActive,\n  };\n}\n\n// ============================================================================\n// Hook: useComboBoxKeyboard\n// ============================================================================\ninterface UseComboBoxKeyboardProps {\n  isPopoverOpen: boolean;\n  listStateRef: RefObject<any>;\n  hasResults: boolean;\n  allowsCustomValue?: boolean;\n  effectiveInputValue: string;\n  isClearable?: boolean;\n  onSelectionChange: (selection: Key | Key[] | null) => void;\n  onClearValue: () => void;\n  onOpenPopover: () => void;\n  onClosePopover: () => void;\n  inputRef: RefObject<HTMLInputElement>;\n  setIsFilterActive: (active: boolean) => void;\n  onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;\n}\n\nfunction useComboBoxKeyboard({\n  isPopoverOpen,\n  listStateRef,\n  hasResults,\n  allowsCustomValue,\n  effectiveInputValue,\n  isClearable,\n  onSelectionChange,\n  onClearValue,\n  onOpenPopover,\n  onClosePopover,\n  inputRef,\n  setIsFilterActive,\n  onKeyDown,\n}: UseComboBoxKeyboardProps) {\n  const { keyboardProps } = useKeyboard({\n    onKeyDown: (e) => {\n      // Call user's handler first\n      onKeyDown?.(e as React.KeyboardEvent<HTMLInputElement>);\n\n      if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {\n        e.preventDefault();\n\n        // Open popover if closed\n        if (!isPopoverOpen) {\n          // If opening with no filtered results, disable filter to show all items\n          if (!hasResults) {\n            setIsFilterActive(false);\n          }\n          onOpenPopover();\n          return;\n        }\n\n        const listState = listStateRef.current;\n        if (!listState) return;\n\n        const isArrowDown = e.key === 'ArrowDown';\n        const nextKey = getNextVisibleKey(listState, isArrowDown ? 1 : -1);\n\n        if (nextKey != null) {\n          markKeyboardFocus(listState);\n          listState.selectionManager.setFocusedKey(nextKey);\n        }\n      } else if (e.key === 'Enter') {\n        // If popover is open, try to select the focused item first\n        if (isPopoverOpen) {\n          const listState = listStateRef.current;\n          if (listState) {\n            const keyToSelect = listState.selectionManager.focusedKey;\n\n            if (keyToSelect != null) {\n              e.preventDefault();\n              listState.selectionManager.select(keyToSelect, e);\n              // Ensure the popover closes even if selection stays the same\n              onClosePopover();\n              inputRef.current?.focus();\n              return;\n            }\n          }\n        }\n\n        // If no results, handle empty input or custom values\n        if (!hasResults) {\n          if (allowsCustomValue) {\n            const value = effectiveInputValue.trim();\n\n            // Commit the custom value\n            onSelectionChange(\n              (value as unknown as Key) ?? (null as unknown as Key),\n            );\n\n            // If popover is closed and we have a value, allow Enter to propagate for form submission\n            // If popover is open OR value is empty, prevent default to avoid premature submission\n            if (isPopoverOpen || !value) {\n              e.preventDefault();\n            }\n          } else {\n            e.preventDefault();\n            onSelectionChange(null);\n          }\n\n          return;\n        }\n\n        // Clear selection if input is empty and popover is closed (or no focused item)\n        const trimmed = (effectiveInputValue || '').trim();\n        if (trimmed === '') {\n          e.preventDefault();\n          onSelectionChange(null);\n          return;\n        }\n      } else if (e.key === 'Escape') {\n        if (isPopoverOpen) {\n          e.preventDefault();\n          onClosePopover();\n          inputRef.current?.focus();\n        } else if (effectiveInputValue && isClearable) {\n          e.preventDefault();\n          onClearValue();\n        }\n      } else if (e.key === 'Home' || e.key === 'End') {\n        if (isPopoverOpen) {\n          e.preventDefault();\n\n          const listState = listStateRef.current;\n          if (!listState) return;\n\n          const targetKey = getEdgeVisibleKey(\n            listState,\n            e.key === 'Home' ? 'first' : 'last',\n          );\n\n          if (targetKey != null) {\n            markKeyboardFocus(listState);\n            listState.selectionManager.setFocusedKey(targetKey);\n          }\n        }\n      }\n    },\n  });\n\n  return { keyboardProps };\n}\n\n// ============================================================================\n// Component: ComboBoxInput\n// ============================================================================\ninterface ComboBoxInputProps {\n  qa?: string;\n  inputRef: RefObject<HTMLInputElement>;\n  id?: string;\n  value: string;\n  placeholder?: string;\n  isDisabled?: boolean;\n  isReadOnly?: boolean;\n  autoFocus?: boolean;\n  autoComplete?: string;\n  size: string;\n  mods: Record<string, any>;\n  inputStyles?: Styles;\n  keyboardProps: any;\n  focusProps: any;\n  onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;\n  onFocus: (e: React.FocusEvent<HTMLInputElement>) => void;\n  isPopoverOpen: boolean;\n  hasResults: boolean;\n  comboBoxId: string;\n  listStateRef: RefObject<any>;\n}\n\nconst ComboBoxInput = forwardRef<HTMLInputElement, ComboBoxInputProps>(\n  function ComboBoxInput(\n    {\n      qa,\n      inputRef,\n      id,\n      value,\n      placeholder,\n      isDisabled,\n      isReadOnly,\n      autoFocus,\n      autoComplete,\n      size,\n      mods,\n      inputStyles,\n      keyboardProps,\n      focusProps,\n      onChange,\n      onFocus,\n      isPopoverOpen,\n      hasResults,\n      comboBoxId,\n      listStateRef,\n    },\n    ref,\n  ) {\n    const combinedRef = useCombinedRefs(ref, inputRef);\n\n    return (\n      <InputElement\n        ref={combinedRef}\n        qa={qa}\n        id={id}\n        type=\"text\"\n        value={value}\n        placeholder={placeholder}\n        isDisabled={isDisabled}\n        readOnly={isReadOnly}\n        autoFocus={autoFocus}\n        autoComplete={autoComplete}\n        data-autofocus={autoFocus ? '' : undefined}\n        onChange={onChange}\n        onFocus={onFocus}\n        onBlur={focusProps.onBlur}\n        {...keyboardProps}\n        styles={inputStyles}\n        mods={mods}\n        data-size={size}\n        data-input-type=\"combobox\"\n        role=\"combobox\"\n        aria-expanded={isPopoverOpen && hasResults}\n        aria-haspopup=\"listbox\"\n        aria-controls={\n          isPopoverOpen && hasResults\n            ? `ComboBoxListBox-${comboBoxId}`\n            : undefined\n        }\n        aria-activedescendant={\n          isPopoverOpen &&\n          hasResults &&\n          listStateRef.current?.selectionManager.focusedKey != null\n            ? `ListBoxItem-${listStateRef.current?.selectionManager.focusedKey}`\n            : undefined\n        }\n      />\n    );\n  },\n);\n\n// ============================================================================\n// Main Component: ComboBox\n// ============================================================================\nexport const ComboBox = forwardRef(function ComboBox<T extends object>(\n  props: CubeComboBoxProps<T>,\n  ref: ForwardedRef<HTMLDivElement>,\n) {\n  props = useFieldProps(props, {\n    valuePropsMapper: ({ value, onChange }) => {\n      return {\n        // Form value maps to selectedKey (the committed value) in both modes\n        selectedKey: value ?? null,\n        onSelectionChange(val: string | null) {\n          // Commit selection changes to the form\n          onChange(val);\n        },\n      };\n    },\n  });\n\n  const { t } = useI18n();\n\n  let {\n    qa,\n    label,\n    extra,\n    labelStyles,\n    isRequired,\n    necessityIndicator,\n    isInvalid,\n    isValid,\n    id,\n    icon,\n    prefix,\n    isDisabled,\n    autoFocus,\n    autoComplete = 'off',\n    wrapperRef,\n    inputRef,\n    triggerRef,\n    popoverRef,\n    listBoxRef,\n    isLoading,\n    inputStyles,\n    optionStyles,\n    triggerStyles,\n    listBoxStyles,\n    overlayStyles,\n    suffix,\n    hideTrigger,\n    message,\n    description,\n    size = 'medium',\n    direction = 'bottom',\n    shouldFlip = true,\n    popoverTrigger = 'input',\n    suffixPosition = 'before',\n    filter,\n    styles,\n    labelSuffix,\n    selectedKey,\n    defaultSelectedKey,\n    inputValue,\n    defaultInputValue,\n    onInputChange,\n    isClearable,\n    onClear,\n    placeholder,\n    allowsCustomValue,\n    shouldCommitOnBlur = true,\n    clearOnBlur,\n    items,\n    children: renderChildren,\n    sectionStyles,\n    headingStyles,\n    isReadOnly,\n    overlayOffset = 8,\n    containerPadding = 8,\n    onSelectionChange: externalOnSelectionChange,\n    sortSelectedToTop: sortSelectedToTopProp,\n    onOpenChange,\n    onFocus,\n    onBlur,\n    onKeyDown,\n    form,\n    ...otherProps\n  } = props;\n\n  // Generate a unique ID for this combobox instance\n  const comboBoxId = useMemo(() => generateRandomId(), []);\n\n  // Hoist the wrapper/popover ref normalization above `useComboBoxState` so\n  // the popover-sync inside it sees stable, attached refs. Other ref combines\n  // happen below alongside the legacy ordering.\n  wrapperRef = useCombinedRefs(wrapperRef);\n  popoverRef = useCombinedRefs(popoverRef);\n\n  // State management hook\n  const {\n    effectiveSelectedKey,\n    effectiveInputValue,\n    isPopoverOpen,\n    setIsPopoverOpen,\n    setInternalSelectedKey,\n    setInternalInputValue,\n    isControlledKey,\n    isControlledInput,\n  } = useComboBoxState({\n    selectedKey,\n    defaultSelectedKey,\n    inputValue,\n    defaultInputValue,\n    comboBoxId,\n    triggerRef: wrapperRef as RefObject<HTMLElement | null>,\n    popoverRef: popoverRef as RefObject<HTMLElement | null>,\n  });\n\n  // Track if sortSelectedToTop was explicitly provided\n  const sortSelectedToTopExplicit = sortSelectedToTopProp !== undefined;\n  // Default to true if items are provided, false otherwise\n  const sortSelectedToTop = sortSelectedToTopProp ?? (items ? true : false);\n\n  // Cache for sorted items array when using `items` prop\n  const cachedItemsOrder = useRef<T[] | null>(null);\n  const selectionWhenClosed = useRef<string | null>(null);\n\n  styles = extractStyles(otherProps, PROP_STYLES, styles);\n\n  ref = useCombinedRefs(ref);\n  inputRef = useCombinedRefs(inputRef);\n  triggerRef = useCombinedRefs(triggerRef);\n  listBoxRef = useCombinedRefs(listBoxRef);\n\n  // Sort items with selected on top if enabled\n  const getSortedItems = useCallback((): typeof items => {\n    if (!items) return items;\n\n    if (!sortSelectedToTop) return items;\n\n    // Reuse cached order if available\n    if (cachedItemsOrder.current) {\n      return cachedItemsOrder.current;\n    }\n\n    // Warn if explicitly requested but not supported\n    if (sortSelectedToTopExplicit && !items) {\n      console.warn(\n        'ComboBox: sortSelectedToTop only works with the items prop. ' +\n          'Sorting will be skipped when using JSX children.',\n      );\n      return items;\n    }\n\n    const selectedKey = isPopoverOpen\n      ? effectiveSelectedKey\n      : selectionWhenClosed.current;\n\n    if (!selectedKey) return items;\n\n    const itemsArray = Array.isArray(items) ? items : Array.from(items);\n    const selectedItem = itemsArray.find((item) => {\n      const key = (item as any)?.key ?? (item as any)?.id;\n      return key != null && String(key) === String(selectedKey);\n    });\n\n    if (!selectedItem) return items;\n\n    const sorted = [\n      selectedItem,\n      ...itemsArray.filter((item) => {\n        const key = (item as any)?.key ?? (item as any)?.id;\n        return key == null || String(key) !== String(selectedKey);\n      }),\n    ] as T[];\n\n    if (isPopoverOpen) {\n      cachedItemsOrder.current = sorted;\n    }\n\n    return sorted;\n  }, [\n    items,\n    sortSelectedToTop,\n    sortSelectedToTopExplicit,\n    effectiveSelectedKey,\n    isPopoverOpen,\n  ]);\n\n  const sortedItems = getSortedItems();\n\n  // Preserve the original `children` (may be a render function) before we\n  // potentially overwrite it.\n  let children: ReactNode = renderChildren as ReactNode;\n\n  const renderFn = renderChildren as unknown;\n\n  if (sortedItems && typeof renderFn === 'function') {\n    try {\n      const itemsArray = Array.from(sortedItems as Iterable<any>);\n      children = itemsArray.map((item, idx) => {\n        const rendered = (renderFn as (it: any) => ReactNode)(item);\n        if (\n          React.isValidElement(rendered) &&\n          (rendered as ReactElement).key == null\n        ) {\n          return React.cloneElement(rendered as ReactElement, {\n            key: (rendered as any)?.key ?? item?.key ?? idx,\n          });\n        }\n\n        return rendered as ReactNode;\n      });\n    } catch {\n      // If conversion fails, proceed with the original children\n    }\n  }\n\n  // Invalidate cached sorting whenever items change\n  useEffect(() => {\n    cachedItemsOrder.current = null;\n  }, [items]);\n\n  // Capture selection when popover closes\n  useEffect(() => {\n    if (!isPopoverOpen) {\n      selectionWhenClosed.current =\n        effectiveSelectedKey != null ? String(effectiveSelectedKey) : null;\n      cachedItemsOrder.current = null;\n    }\n  }, [isPopoverOpen, effectiveSelectedKey]);\n\n  // Call onOpenChange when popover state changes\n  useEffect(() => {\n    onOpenChange?.(isPopoverOpen);\n  }, [isPopoverOpen]);\n\n  // Filtering hook\n  const { filterFn, isFilterActive, setIsFilterActive } = useComboBoxFiltering({\n    effectiveInputValue,\n    filter,\n  });\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: sortedItems,\n    selectionMode: 'none', // Don't manage selection in this state\n  });\n\n  const { isFocused, focusProps } = useFocus({ isDisabled });\n\n  // Helper to check if current input value is valid\n  const checkInputValidity = useCallback(() => {\n    if (!effectiveInputValue.trim()) {\n      return { isInputValid: false, singleMatchKey: null, filteredCount: 0 };\n    }\n\n    // Get filtered collection based on current input\n    const filteredNodes = filterFn(localCollectionState.collection);\n    const filteredItems: Array<{ key: Key; textValue: string }> = [];\n\n    // Flatten filtered nodes (handle sections)\n    for (const node of filteredNodes) {\n      if (node.type === 'section' && node.childNodes) {\n        for (const child of node.childNodes) {\n          if (child.type === 'item') {\n            filteredItems.push({\n              key: child.key,\n              textValue: child.textValue || '',\n            });\n          }\n        }\n      } else if (node.type === 'item') {\n        filteredItems.push({\n          key: node.key,\n          textValue: node.textValue || '',\n        });\n      }\n    }\n\n    const filteredCount = filteredItems.length;\n\n    // Check for exact match\n    const exactMatch = filteredItems.find(\n      (item) =>\n        item.textValue.toLowerCase() ===\n        effectiveInputValue.trim().toLowerCase(),\n    );\n\n    if (exactMatch) {\n      return {\n        isInputValid: true,\n        singleMatchKey: exactMatch.key,\n        filteredCount,\n      };\n    }\n\n    // If exactly one filtered result, consider it valid\n    if (filteredCount === 1) {\n      return {\n        isInputValid: true,\n        singleMatchKey: filteredItems[0].key,\n        filteredCount,\n      };\n    }\n\n    return { isInputValid: false, singleMatchKey: null, filteredCount };\n  }, [effectiveInputValue, filterFn, localCollectionState.collection]);\n\n  // Composite blur handler - fires when focus leaves the entire component\n  const handleCompositeBlur = useEvent(() => {\n    // NOTE: Do NOT disable filter yet; we need it active for validity check\n\n    // In allowsCustomValue mode\n    if (allowsCustomValue) {\n      // Commit the input value if it's non-empty and nothing is selected\n      if (\n        shouldCommitOnBlur &&\n        effectiveInputValue &&\n        effectiveSelectedKey == null\n      ) {\n        externalOnSelectionChange?.(effectiveInputValue as string);\n        if (!isControlledKey) {\n          setInternalSelectedKey(effectiveInputValue as Key);\n        }\n        onBlur?.();\n        setIsFilterActive(false);\n        return;\n      }\n\n      // Clear selection if input is empty\n      if (!String(effectiveInputValue).trim()) {\n        externalOnSelectionChange?.(null);\n        if (!isControlledKey) {\n          setInternalSelectedKey(null);\n        }\n        if (!isControlledInput) {\n          setInternalInputValue('');\n        }\n        onInputChange?.('');\n        onBlur?.();\n        setIsFilterActive(false);\n        return;\n      }\n    }\n\n    // In non-custom-value mode, validate input and handle accordingly\n    if (!allowsCustomValue) {\n      const { isInputValid, singleMatchKey } = checkInputValidity();\n\n      // If there's exactly one filtered result, auto-select it\n      if (\n        isInputValid &&\n        singleMatchKey != null &&\n        singleMatchKey !== effectiveSelectedKey\n      ) {\n        const label = getItemLabel(singleMatchKey);\n\n        if (!isControlledKey) {\n          setInternalSelectedKey(singleMatchKey);\n        }\n        if (!isControlledInput) {\n          setInternalInputValue(label);\n        }\n        onInputChange?.(label);\n        externalOnSelectionChange?.(singleMatchKey as string | null);\n        onBlur?.();\n        setIsFilterActive(false);\n        return;\n      }\n\n      // If input is invalid (no exact match, not a single result)\n      if (!isInputValid) {\n        const trimmedInput = effectiveInputValue.trim();\n\n        // Clear if clearOnBlur is set or input is empty\n        if (clearOnBlur || !trimmedInput) {\n          externalOnSelectionChange?.(null);\n          if (!isControlledKey) {\n            setInternalSelectedKey(null);\n          }\n          if (!isControlledInput) {\n            setInternalInputValue('');\n          }\n          onInputChange?.('');\n          onBlur?.();\n          setIsFilterActive(false);\n          return;\n        }\n\n        // Reset input to current selected value (or empty if none)\n        const nextValue =\n          effectiveSelectedKey != null\n            ? getItemLabel(effectiveSelectedKey)\n            : '';\n\n        if (!isControlledInput) {\n          setInternalInputValue(nextValue);\n        }\n        onInputChange?.(nextValue);\n        onBlur?.();\n        setIsFilterActive(false);\n        return;\n      }\n    }\n\n    // Fallback: Reset input to show current selection (or empty if none)\n    const nextValue =\n      effectiveSelectedKey != null ? getItemLabel(effectiveSelectedKey) : '';\n\n    if (!isControlledInput) {\n      setInternalInputValue(nextValue);\n    }\n    onInputChange?.(nextValue);\n    onBlur?.();\n    setIsFilterActive(false);\n  });\n\n  // Composite focus hook - handles focus tracking across wrapper and portaled popover\n  const { compositeFocusProps } = useCompositeFocus({\n    wrapperRef,\n    popoverRef,\n    onFocus,\n    onBlur: handleCompositeBlur,\n    isDisabled,\n  });\n\n  let validationIcon = getValidationIcon({ isInvalid, isValid });\n\n  // Ref to access internal ListBox state\n  const listStateRef = useRef<any>(null);\n  const focusInitAttemptsRef = useRef(0);\n\n  // Helper to get label from local collection\n  const getItemLabel = useCallback(\n    (key: Key): string => {\n      const item = localCollectionState?.collection?.getItem(key);\n      return item?.textValue || String(key);\n    },\n    [localCollectionState?.collection],\n  );\n\n  // Selection change handler\n  const handleSelectionChange = useEvent((selection: Key | Key[] | null) => {\n    // Extract single key from selection (we only support single selection)\n    const key = Array.isArray(selection) ? selection[0] : selection;\n\n    // Update selected key\n    if (!isControlledKey) {\n      setInternalSelectedKey(key ?? null);\n    }\n\n    // Update input value to show selected item label\n    if (key != null) {\n      setIsFilterActive(false);\n\n      const label = getItemLabel(key);\n\n      if (!isControlledInput) {\n        setInternalInputValue(label);\n      }\n      onInputChange?.(label);\n    } else {\n      // Clear input when selection is cleared\n      if (!isControlledInput) {\n        setInternalInputValue('');\n      }\n      onInputChange?.('');\n      setIsFilterActive(false);\n    }\n\n    externalOnSelectionChange?.(key as string | null);\n\n    // Close popover after selection\n    setIsPopoverOpen(false);\n\n    // Focus input\n    setTimeout(() => {\n      inputRef.current?.focus();\n    }, 0);\n  });\n\n  // Input change handler\n  const handleInputChange = useEvent(\n    (e: React.ChangeEvent<HTMLInputElement>) => {\n      const value = e.target.value;\n\n      // Update input value\n      if (!isControlledInput) {\n        setInternalInputValue(value);\n      }\n      onInputChange?.(value);\n\n      const trimmed = value.trim();\n      setIsFilterActive(trimmed.length > 0);\n\n      // Only clear selection in allowsCustomValue mode\n      // In normal mode, typing just filters - selection stays until explicitly changed\n      if (allowsCustomValue && effectiveSelectedKey != null) {\n        if (!isControlledKey) {\n          setInternalSelectedKey(null);\n        }\n        externalOnSelectionChange?.(null);\n      }\n\n      // Open popover based on trigger\n      if (popoverTrigger !== 'manual' && value && !isPopoverOpen) {\n        setIsPopoverOpen(true);\n      }\n    },\n  );\n\n  // Initialize input value from defaultInputValue or defaultSelectedKey (uncontrolled mode only, one-time)\n  const [hasInitialized, setHasInitialized] = useState(false);\n\n  useEffect(() => {\n    // Only initialize once, in uncontrolled input mode\n    if (hasInitialized || isControlledInput) return;\n\n    // Priority 1: defaultInputValue takes precedence\n    if (defaultInputValue !== undefined) {\n      setInternalInputValue(defaultInputValue);\n      setHasInitialized(true);\n      return;\n    }\n\n    // Priority 2: fall back to defaultSelectedKey's label\n    if (defaultSelectedKey) {\n      const label = getItemLabel(defaultSelectedKey);\n\n      setInternalInputValue(label);\n      setHasInitialized(true);\n    }\n  }, [\n    hasInitialized,\n    isControlledInput,\n    defaultInputValue,\n    defaultSelectedKey,\n    getItemLabel,\n    children,\n  ]);\n\n  // Sync input value with controlled selectedKey\n  const lastSyncedSelectedKey = useRef<Key | null | undefined>(undefined);\n\n  useEffect(() => {\n    // Only run when selectedKey is controlled but inputValue is uncontrolled\n    if (!isControlledKey || isControlledInput) return;\n\n    // Skip if the key hasn't actually changed (prevents unnecessary resets when collection rebuilds)\n    if (\n      lastSyncedSelectedKey.current !== undefined &&\n      lastSyncedSelectedKey.current === effectiveSelectedKey\n    ) {\n      return;\n    }\n\n    lastSyncedSelectedKey.current = effectiveSelectedKey;\n\n    // Get the expected label for the current selection\n    const expectedLabel =\n      effectiveSelectedKey != null ? getItemLabel(effectiveSelectedKey) : '';\n\n    // Update the input value to match the selected key's label\n    setInternalInputValue(expectedLabel);\n  }, [isControlledKey, isControlledInput, effectiveSelectedKey, getItemLabel]);\n\n  // Input focus handler\n  const handleInputFocus = useEvent((e: React.FocusEvent<HTMLInputElement>) => {\n    // Call focus props handler if it exists\n    focusProps.onFocus?.(e as any);\n\n    if (popoverTrigger === 'focus' && !isPopoverOpen) {\n      setIsPopoverOpen(true);\n    }\n  });\n\n  // Input blur handler - just handles internal focus props\n  const handleInputBlur = useEvent((e: React.FocusEvent<HTMLInputElement>) => {\n    focusProps.onBlur?.(e as any);\n  });\n\n  // Clear button logic\n  let hasValue = allowsCustomValue\n    ? effectiveInputValue !== ''\n    : effectiveSelectedKey != null;\n  let showClearButton = isClearable && hasValue && !isDisabled && !isReadOnly;\n\n  // Check if there are any results after filtering\n  const hasResults = useMemo(() => {\n    if (!children) return false;\n    if (!Array.isArray(children) && children === null) return false;\n\n    // If we have a collection, check if filtering will produce any results\n    if (localCollectionState?.collection) {\n      const filteredNodes = filterFn(localCollectionState.collection);\n      const resultArray = Array.from(filteredNodes).flatMap((node: any) => {\n        if (node.type === 'section' && node.childNodes) {\n          return [...node.childNodes];\n        }\n\n        return [node];\n      });\n      return resultArray.length > 0;\n    }\n\n    // Fallback: check if children exists\n    return Array.isArray(children) ? children.length > 0 : true;\n  }, [children, localCollectionState?.collection, filterFn]);\n\n  // Clear function\n  let clearValue = useEvent(() => {\n    // Clear input\n    if (!isControlledInput) {\n      setInternalInputValue('');\n    }\n    onInputChange?.('');\n\n    // Clear selection\n    if (!isControlledKey) {\n      setInternalSelectedKey(null);\n    }\n    externalOnSelectionChange?.(null);\n\n    // Close popover\n    if (isPopoverOpen) {\n      setIsPopoverOpen(false);\n    }\n\n    // Focus input\n    inputRef.current?.focus();\n\n    onClear?.();\n  });\n\n  // Keyboard navigation hook\n  const { keyboardProps } = useComboBoxKeyboard({\n    isPopoverOpen,\n    listStateRef,\n    hasResults,\n    allowsCustomValue,\n    effectiveInputValue,\n    isClearable,\n    onSelectionChange: handleSelectionChange,\n    onClearValue: clearValue,\n    onOpenPopover: () => setIsPopoverOpen(true),\n    onClosePopover: () => setIsPopoverOpen(false),\n    inputRef,\n    setIsFilterActive,\n    onKeyDown,\n  });\n\n  if (icon) {\n    icon = <div data-element=\"InputIcon\">{icon}</div>;\n\n    if (prefix) {\n      prefix = (\n        <>\n          {icon}\n          {prefix}\n        </>\n      );\n    } else {\n      prefix = icon;\n    }\n  }\n\n  let mods = useMemo(\n    () => ({\n      ...getValidationMods({ isInvalid, isValid }),\n      disabled: isDisabled,\n      hovered: false,\n      focused: isFocused,\n      loading: isLoading,\n      prefix: !!prefix,\n      suffix: true,\n      clearable: showClearButton,\n    }),\n    [\n      isInvalid,\n      isValid,\n      isDisabled,\n      isFocused,\n      isLoading,\n      prefix,\n      showClearButton,\n    ],\n  );\n\n  const comboBoxWidth = wrapperRef?.current?.offsetWidth;\n\n  const shouldShowPopover = Boolean(isPopoverOpen && hasResults);\n\n  // Close popover if no results\n  useEffect(() => {\n    if (isPopoverOpen && !hasResults) {\n      setIsPopoverOpen(false);\n    }\n  }, [isPopoverOpen, hasResults]);\n\n  const ensureInitialFocus = useCallback(() => {\n    if (!shouldShowPopover) return;\n\n    const listState = listStateRef.current;\n    if (!listState) return;\n\n    const { selectionManager, collection, disabledKeys, lastFocusSourceRef } =\n      listState;\n    if (!selectionManager || !collection) return;\n\n    const collectFirstKey = (): Key | null => {\n      for (const node of collection) {\n        if (node.type === 'item') {\n          if (!disabledKeys?.has(node.key)) return node.key;\n        } else if (node.childNodes) {\n          for (const child of node.childNodes) {\n            if (child.type === 'item' && !disabledKeys?.has(child.key)) {\n              return child.key;\n            }\n          }\n        }\n      }\n      return null;\n    };\n\n    if (lastFocusSourceRef) lastFocusSourceRef.current = 'keyboard';\n\n    // Check if we need to set or update focus\n    const currentFocusedKey = selectionManager.focusedKey;\n    let needsRefocus = false;\n\n    if (currentFocusedKey == null) {\n      // No focus at all - need to set initial focus\n      needsRefocus = true;\n    } else {\n      // Check if currently focused key still exists in the collection\n      const focusedItemExists = collection.getItem(currentFocusedKey) != null;\n      if (!focusedItemExists) {\n        // Focused item was filtered out - need to refocus\n        needsRefocus = true;\n      }\n    }\n\n    if (needsRefocus) {\n      let keyToFocus: Key | null = null;\n\n      // First try to focus on the selected key if it exists in the collection\n      if (\n        effectiveSelectedKey != null &&\n        collection.getItem(effectiveSelectedKey) != null\n      ) {\n        keyToFocus = effectiveSelectedKey;\n      } else {\n        // Fall back to the first key in the collection\n        keyToFocus = collectFirstKey();\n      }\n\n      if (keyToFocus != null) {\n        selectionManager.setFocusedKey(keyToFocus);\n      }\n    }\n  }, [shouldShowPopover, effectiveSelectedKey]);\n\n  useLayoutEffect(() => {\n    if (!shouldShowPopover) return;\n    focusInitAttemptsRef.current = 0;\n\n    const tick = () => {\n      if (!shouldShowPopover) return;\n      ensureInitialFocus();\n      focusInitAttemptsRef.current += 1;\n      // Try a few frames to wait for collection to mount\n      if (\n        focusInitAttemptsRef.current < 8 &&\n        listStateRef.current?.selectionManager?.focusedKey == null\n      ) {\n        requestAnimationFrame(tick);\n      }\n    };\n\n    requestAnimationFrame(() => requestAnimationFrame(tick));\n  }, [shouldShowPopover, ensureInitialFocus]);\n\n  const comboBoxField = (\n    <ComboBoxWrapperElement\n      ref={wrapperRef}\n      mods={mods}\n      styles={styles}\n      style={{\n        zIndex: isFocused ? 1 : 'initial',\n      }}\n      data-size={size}\n      {...compositeFocusProps}\n    >\n      {prefix ? <div data-element=\"Prefix\">{prefix}</div> : null}\n      <ComboBoxInput\n        qa={qa || 'ComboBox'}\n        inputRef={inputRef}\n        id={id}\n        value={effectiveInputValue}\n        placeholder={placeholder}\n        isDisabled={isDisabled}\n        isReadOnly={isReadOnly}\n        autoFocus={autoFocus}\n        autoComplete={autoComplete}\n        size={size}\n        mods={mods}\n        inputStyles={inputStyles}\n        keyboardProps={keyboardProps}\n        focusProps={{ ...focusProps, onBlur: handleInputBlur }}\n        isPopoverOpen={isPopoverOpen}\n        hasResults={hasResults}\n        comboBoxId={comboBoxId}\n        listStateRef={listStateRef}\n        onChange={handleInputChange}\n        onFocus={handleInputFocus}\n      />\n      <div data-element=\"Suffix\">\n        {suffixPosition === 'before' ? suffix : null}\n        {isLoading ? <LoadingIcon data-element=\"InputIcon\" /> : validationIcon}\n        {suffixPosition === 'after' ? suffix : null}\n        {showClearButton && (\n          <Item.Action\n            icon={<CloseIcon />}\n            size={size}\n            // No `theme` — the default `current` type inherits the input's own\n            // text color, which is already validation-tinted, so the button\n            // matches the text beside it exactly instead of using the fixed\n            // `danger.clear` palette.\n            qa=\"ComboBoxClearButton\"\n            data-no-trigger={hideTrigger ? '' : undefined}\n            data-popover-dismiss=\"\"\n            aria-label={t('comboBox.clearValue', 'Clear value')}\n            onPress={clearValue}\n          />\n        )}\n        {!hideTrigger ? (\n          <Item.Action\n            ref={triggerRef}\n            data-popover-trigger\n            icon={<DirectionIcon to={isPopoverOpen ? 'up' : 'down'} />}\n            qa=\"ComboBoxTrigger\"\n            mods={{\n              pressed: isPopoverOpen,\n              disabled: isDisabled,\n              loading: isLoading,\n            }}\n            data-size={size}\n            isDisabled={isDisabled}\n            styles={triggerStyles}\n            aria-expanded={isPopoverOpen}\n            aria-haspopup=\"listbox\"\n            aria-label={t('comboBox.showOptions', 'Show options')}\n            onPress={() => {\n              if (!isDisabled) {\n                const willOpen = !isPopoverOpen;\n                setIsPopoverOpen(willOpen);\n                if (willOpen) {\n                  inputRef.current?.focus();\n                  // If opening with no filtered results, disable filter to show all items\n                  if (!hasResults) {\n                    setIsFilterActive(false);\n                  }\n                }\n              }\n            }}\n          />\n        ) : null}\n      </div>\n      <ListBoxPopover\n        isOpen={shouldShowPopover}\n        triggerRef={wrapperRef as RefObject<HTMLElement>}\n        popoverRef={popoverRef}\n        listBoxRef={listBoxRef}\n        direction={direction}\n        shouldFlip={shouldFlip}\n        overlayOffset={overlayOffset}\n        containerPadding={containerPadding}\n        comboBoxWidth={comboBoxWidth}\n        listBoxId={`ComboBoxListBox-${comboBoxId}`}\n        overlayStyles={overlayStyles}\n        listBoxStyles={listBoxStyles}\n        optionStyles={optionStyles}\n        sectionStyles={sectionStyles}\n        headingStyles={headingStyles}\n        selectedKey={effectiveSelectedKey}\n        isDisabled={isDisabled}\n        disabledKeys={props.disabledKeys}\n        items={sortedItems}\n        listStateRef={listStateRef}\n        label={label}\n        ariaLabel={(props as any)['aria-label']}\n        compositeFocusProps={compositeFocusProps}\n        filter={filterFn}\n        size={size}\n        onSelectionChange={handleSelectionChange}\n        onClose={() => setIsPopoverOpen(false)}\n      >\n        {children}\n      </ListBoxPopover>\n    </ComboBoxWrapperElement>\n  );\n\n  const { children: _, ...propsWithoutChildren } = props;\n\n  return wrapWithField<Omit<CubeComboBoxProps<T>, 'children'>>(\n    comboBoxField,\n    ref,\n    propsWithoutChildren,\n  );\n}) as unknown as (<T>(\n  props: CubeComboBoxProps<T> & { ref?: ForwardedRef<HTMLDivElement> },\n) => ReactElement) & { Item: typeof Item; Section: typeof BaseSection };\n\nComboBox.Item = Item;\n\nComboBox.Section = BaseSection;\n\nObject.defineProperty(ComboBox, 'cubeInputType', {\n  value: 'ComboBox',\n  enumerable: false,\n  configurable: false,\n});\n"],"mappings":"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CA,MACA,aACA,eACA,YACA,UACA,SACA,eACA,YACA,YACA,gBAEF,KACA;AAGA,QACE,oBAAC;EACC,KAJgB,gBAAgB,KAAK,SAAS;EAK1C;EACA;EACJ,MAAK;EACE;EACM;EACD;EACZ,UAAU;EACC;EACG;EACd,kBAAgB,YAAY,KAAK;EACvB;EACD;EACT,QAAQ,WAAW;EACnB,GAAI;EACJ,QAAQ;EACF;EACN,aAAW;EACX,mBAAgB;EAChB,MAAK;EACL,iBAAe,iBAAiB;EAChC,iBAAc;EACd,iBACE,iBAAiB,aACb,mBAAmB,eACnB;EAEN,yBACE,iBACA,cACA,aAAa,SAAS,iBAAiB,cAAc,OACjD,eAAe,aAAa,SAAS,iBAAiB,eACtD;GAEN;EAGP;AAKD,MAAa,WAAW,WAAW,SAAS,SAC1C,OACA,KACA;AACA,SAAQ,cAAc,OAAO,EAC3B,mBAAmB,EAAE,OAAO,eAAe;AACzC,SAAO;GAEL,aAAa,SAAS;GACtB,kBAAkB,KAAoB;AAEpC,aAAS,IAAI;;GAEhB;IAEJ,CAAC;CAEF,MAAM,EAAE,MAAM,SAAS;CAEvB,IAAI,EACF,IACA,OACA,OACA,aACA,YACA,oBACA,WACA,SACA,IACA,MACA,QACA,YACA,WACA,eAAe,OACf,YACA,UACA,YACA,YACA,YACA,WACA,aACA,cACA,eACA,eACA,eACA,QACA,aACA,SACA,aACA,OAAO,UACP,YAAY,UACZ,aAAa,MACb,iBAAiB,SACjB,iBAAiB,UACjB,QACA,QACA,aACA,aACA,oBACA,YACA,mBACA,eACA,aACA,SACA,aACA,mBACA,qBAAqB,MACrB,aACA,OACA,UAAU,gBACV,eACA,eACA,YACA,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,2BACnB,mBAAmB,uBACnB,cACA,SACA,QACA,WACA,MACA,GAAG,eACD;CAGJ,MAAM,aAAa,cAAc,kBAAkB,EAAE,EAAE,CAAC;AAKxD,cAAa,gBAAgB,WAAW;AACxC,cAAa,gBAAgB,WAAW;CAGxC,MAAM,EACJ,sBACA,qBACA,eACA,kBACA,wBACA,uBACA,iBACA,sBACE,iBAAiB;EACnB;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"}

package/dist/components/fields/CommandTextArea/CommandTextArea.js

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

package/dist/components/fields/CommandTextArea/caretPosition.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 //#region src/components/fields/CommandTextArea/caretPosition.ts
 const MIRROR_STYLES = [
 	"boxSizing",

package/dist/components/fields/CommandTextArea/useCaretAnchor.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { getCaretRect } from "./caretPosition.js";
 import { useEffect, useLayoutEffect, useRef } from "react";
 

package/dist/components/fields/DatePicker/DateInput.js

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

package/dist/components/fields/DatePicker/DateInputBase.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { getValidationMods } from "../../form/validation/resolve-validation-props.js";

package/dist/components/fields/DatePicker/DatePicker.js

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

package/dist/components/fields/DatePicker/DatePickerButton.js

@@ -1,11 +1,41 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
+import { ItemActionProvider } from "../../actions/ItemActionContext.js";
 import { ItemAction } from "../../actions/ItemAction/ItemAction.js";
 import { CalendarIcon } from "../../../icons/CalendarIcon.js";
 import { tasty } from "@tenphi/tasty";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/fields/DatePicker/DatePickerButton.tsx
-const DatePickerButton = tasty(ItemAction, { icon: /* @__PURE__ */ jsx(CalendarIcon, {}) });
+const StyledDatePickerButton = tasty(ItemAction, { icon: /* @__PURE__ */ jsx(CalendarIcon, {}) });
+/**
+* The calendar button every date field renders in its suffix.
+*
+* The two reasons it can be disabled travel through different channels, and the
+* split matters because the default `current` type paints from the colour it
+* inherits:
+*
+* - A disabled FIELD goes through `ItemActionProvider`, which marks the state
+*   inherited. The field has already faded its text to a translucent `#dark.30`,
+*   so the button must NOT fade again — doing both multiplied down to `.12`, all
+*   but invisible.
+* - READ-ONLY leaves the field's text fully opaque, so nothing has faded yet and
+*   the button really is disabled on its own. It stays a prop and fades itself;
+*   routed as inherited it would render at full strength and look enabled while
+*   no longer responding.
+*
+* Handled here rather than at the five call sites so the distinction cannot be
+* dropped by the next one. No `type` is passed to the provider, so the `context`
+* mod stays off and the button keeps its margins.
+*/
+function DatePickerButton({ isDisabled, isReadOnly, ...props }) {
+	return /* @__PURE__ */ jsx(ItemActionProvider, {
+		isDisabled,
+		children: /* @__PURE__ */ jsx(StyledDatePickerButton, {
+			...props,
+			isDisabled: isReadOnly && !isDisabled ? true : void 0
+		})
+	});
+}
 
 //#endregion
 export { DatePickerButton };

package/dist/components/fields/DatePicker/DatePickerButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"DatePickerButton.js","names":[],"sources":["../../../../src/components/fields/DatePicker/DatePickerButton.tsx"],"sourcesContent":["import { tasty } from '@tenphi/tasty';\n\nimport { CalendarIcon } from '../../../icons';\nimport { ItemAction } from '../../actions';\n\nexport const DatePickerButton = tasty(ItemAction, {\n  icon: <CalendarIcon />,\n});\n"],"mappings":";;;;;;;AAKA,MAAa,mBAAmB,MAAM,YAAY,EAChD,MAAM,oBAAC,iBAAe,EACvB,CAAC"}
+{"version":3,"file":"DatePickerButton.js","names":[],"sources":["../../../../src/components/fields/DatePicker/DatePickerButton.tsx"],"sourcesContent":["import { tasty } from '@tenphi/tasty';\n\nimport { CalendarIcon } from '../../../icons';\nimport {\n  CubeItemActionProps,\n  ItemAction,\n  ItemActionProvider,\n} from '../../actions';\n\nconst StyledDatePickerButton = tasty(ItemAction, {\n  icon: <CalendarIcon />,\n});\n\nexport interface CubeDatePickerButtonProps extends CubeItemActionProps {\n  /** Whether the surrounding field is read-only. Disables the button on its own. */\n  isReadOnly?: boolean;\n}\n\n/**\n * The calendar button every date field renders in its suffix.\n *\n * The two reasons it can be disabled travel through different channels, and the\n * split matters because the default `current` type paints from the colour it\n * inherits:\n *\n * - A disabled FIELD goes through `ItemActionProvider`, which marks the state\n *   inherited. The field has already faded its text to a translucent `#dark.30`,\n *   so the button must NOT fade again — doing both multiplied down to `.12`, all\n *   but invisible.\n * - READ-ONLY leaves the field's text fully opaque, so nothing has faded yet and\n *   the button really is disabled on its own. It stays a prop and fades itself;\n *   routed as inherited it would render at full strength and look enabled while\n *   no longer responding.\n *\n * Handled here rather than at the five call sites so the distinction cannot be\n * dropped by the next one. No `type` is passed to the provider, so the `context`\n * mod stays off and the button keeps its margins.\n */\nexport function DatePickerButton({\n  isDisabled,\n  isReadOnly,\n  ...props\n}: CubeDatePickerButtonProps) {\n  return (\n    <ItemActionProvider isDisabled={isDisabled}>\n      <StyledDatePickerButton\n        {...props}\n        isDisabled={isReadOnly && !isDisabled ? true : undefined}\n      />\n    </ItemActionProvider>\n  );\n}\n"],"mappings":";;;;;;;;AASA,MAAM,yBAAyB,MAAM,YAAY,EAC/C,MAAM,oBAAC,iBAAe,EACvB,CAAC;;;;;;;;;;;;;;;;;;;;;AA2BF,SAAgB,iBAAiB,EAC/B,YACA,YACA,GAAG,SACyB;AAC5B,QACE,oBAAC;EAA+B;YAC9B,oBAAC;GACC,GAAI;GACJ,YAAY,cAAc,CAAC,aAAa,OAAO;IAC/C;GACiB"}

package/dist/components/fields/DatePicker/DatePickerElement.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { Space } from "../../layout/Space.js";
 import { tasty } from "@tenphi/tasty";
 

package/dist/components/fields/DatePicker/DatePickerInput.js

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

package/dist/components/fields/DatePicker/DatePickerSegment.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { tasty } from "@tenphi/tasty";
 import { useRef } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/components/fields/DatePicker/DateRangePicker.js

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