rsuite 5.49.0 → 5.51.0

package/esm/Picker/PickerToggle.js

@@ -1,23 +1,19 @@
 'use client';
-import _taggedTemplateLiteralLoose from "@babel/runtime/helpers/esm/taggedTemplateLiteralLoose";
 import _extends from "@babel/runtime/helpers/esm/extends";
+import _taggedTemplateLiteralLoose from "@babel/runtime/helpers/esm/taggedTemplateLiteralLoose";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-var _templateObject, _templateObject2;
-import React, { useState, useCallback, useEffect, useRef } from 'react';
-import PropTypes from 'prop-types';
-import debounce from 'lodash/debounce';
+var _templateObject;
+import React, { useRef, useMemo } from 'react';
 import ToggleButton from './ToggleButton';
-import CloseButton from '../CloseButton';
-import { useClassNames, useCustom, KEY_VALUES, mergeRefs } from '../utils';
+import { useClassNames, mergeRefs, useEventCallback } from '../utils';
 import Plaintext from '../Plaintext';
 import useToggleCaret from '../utils/useToggleCaret';
-import TextMask from '../MaskedInput/TextMask';
-import deprecatePropType from '../utils/deprecatePropType';
-import Loader from '../Loader';
 import Stack from '../Stack';
-var defaultInputMask = [];
+import PickerIndicator from './PickerIndicator';
+import PickerLabel from './PickerLabel';
+import useCombobox from './hooks/useCombobox';
 var PickerToggle = /*#__PURE__*/React.forwardRef(function (props, ref) {
-  var activeProp = props.active,
+  var active = props.active,
     _props$as = props.as,
     Component = _props$as === void 0 ? ToggleButton : _props$as,
     _props$classPrefix = props.classPrefix,
@@ -30,26 +26,14 @@ var PickerToggle = /*#__PURE__*/React.forwardRef(function (props, ref) {
     readOnly = props.readOnly,
     plaintext = props.plaintext,
     hasValue = props.hasValue,
-    editable = props.editable,
     _props$loading = props.loading,
     loading = _props$loading === void 0 ? false : _props$loading,
-    cleanableProp = props.cleanable,
+    cleanable = props.cleanable,
     _props$tabIndex = props.tabIndex,
-    tabIndexProp = _props$tabIndex === void 0 ? editable ? -1 : 0 : _props$tabIndex,
-    id = props.id,
-    value = props.value,
-    inputPlaceholder = props.inputPlaceholder,
+    tabIndex = _props$tabIndex === void 0 ? 0 : _props$tabIndex,
     inputValueProp = props.inputValue,
-    _props$inputMask = props.inputMask,
-    inputMask = _props$inputMask === void 0 ? defaultInputMask : _props$inputMask,
-    onInputChange = props.onInputChange,
-    onInputPressEnter = props.onInputPressEnter,
-    onInputBackspace = props.onInputBackspace,
-    onInputBlur = props.onInputBlur,
-    onInputFocus = props.onInputFocus,
+    focusItemValue = props.focusItemValue,
     onClean = props.onClean,
-    onFocus = props.onFocus,
-    onBlur = props.onBlur,
     _props$placement = props.placement,
     placement = _props$placement === void 0 ? 'bottomStart' : _props$placement,
     caretComponent = props.caretComponent,
@@ -57,102 +41,33 @@ var PickerToggle = /*#__PURE__*/React.forwardRef(function (props, ref) {
     caretAs = _props$caretAs === void 0 ? caretComponent : _props$caretAs,
     label = props.label,
     name = props.name,
-    rest = _objectWithoutPropertiesLoose(props, ["active", "as", "classPrefix", "children", "caret", "className", "disabled", "readOnly", "plaintext", "hasValue", "editable", "loading", "cleanable", "tabIndex", "id", "value", "inputPlaceholder", "inputValue", "inputMask", "onInputChange", "onInputPressEnter", "onInputBackspace", "onInputBlur", "onInputFocus", "onClean", "onFocus", "onBlur", "placement", "caretComponent", "caretAs", "label", "name"]);
-  var _useCustom = useCustom(),
-    locale = _useCustom.locale;
-  var inputRef = useRef(null);
-  var comboboxRef = useRef(null);
-  var _useState = useState(false),
-    activeState = _useState[0],
-    setActive = _useState[1];
+    rest = _objectWithoutPropertiesLoose(props, ["active", "as", "classPrefix", "children", "caret", "className", "disabled", "readOnly", "plaintext", "hasValue", "loading", "cleanable", "tabIndex", "inputValue", "focusItemValue", "onClean", "placement", "caretComponent", "caretAs", "label", "name"]);
+  var combobox = useRef(null);
   var _useClassNames = useClassNames(classPrefix),
     withClassPrefix = _useClassNames.withClassPrefix,
     merge = _useClassNames.merge,
     prefix = _useClassNames.prefix;
-  var getInputValue = useCallback(function () {
-    return typeof inputValueProp === 'undefined' ? Array.isArray(value) ? value.join(',') : value : inputValueProp;
-  }, [inputValueProp, value]);
-  var _useState2 = useState(getInputValue),
-    inputValue = _useState2[0],
-    setInputValue = _useState2[1];
-  useEffect(function () {
-    if (comboboxRef.current) {
-      var _value = getInputValue();
-      setInputValue(_value);
+  var _useCombobox = useCombobox(),
+    id = _useCombobox.id,
+    labelId = _useCombobox.labelId,
+    popupType = _useCombobox.popupType;
+  var inputValue = useMemo(function () {
+    if (typeof inputValueProp === 'number' || typeof inputValueProp === 'string') {
+      return inputValueProp;
+    } else if (Array.isArray(inputValueProp)) {
+      return inputValueProp.join(',');
     }
-  }, [getInputValue]);
+    return '';
+  }, [inputValueProp]);
   var classes = merge(className, withClassPrefix({
-    active: activeProp || activeState
+    active: active
   }));
-  var handleFocus = useCallback(function (event) {
-    if (!loading) {
-      setActive(true);
-    }
-    if (editable) {
-      // Avoid firing the onFocus event twice when DatePicker and DateRangePicker allow keyboard input.
-      if (event.target === inputRef.current) {
-        onFocus === null || onFocus === void 0 ? void 0 : onFocus(event);
-      }
-
-      // Force the input to be focused and editable.
-      if (document.activeElement === comboboxRef.current) {
-        var _inputRef$current;
-        (_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 ? void 0 : _inputRef$current.focus();
-      }
-    } else {
-      onFocus === null || onFocus === void 0 ? void 0 : onFocus(event);
-    }
-  }, [editable, loading, onFocus]);
-  var handleBlur = useCallback(function (event) {
-    if (inputRef.current && !editable) {
-      setActive(false);
-    }
-
-    // When activeElement is an input, it remains active.
-    if (editable && inputRef.current && document.activeElement !== inputRef.current) {
-      setActive(false);
-    }
-    onBlur === null || onBlur === void 0 ? void 0 : onBlur(event);
-  }, [editable, onBlur]);
-  var handleInputBlur = function handleInputBlur(event) {
-    setInputValue(getInputValue());
-    onInputBlur === null || onInputBlur === void 0 ? void 0 : onInputBlur(event);
-  };
-  var handleClean = useCallback(function (event) {
-    var _inputRef$current2, _comboboxRef$current;
+  var handleClean = useEventCallback(function (event) {
+    var _combobox$current;
     event.stopPropagation();
     onClean === null || onClean === void 0 ? void 0 : onClean(event);
-
-    // When the value is cleared, the current component is still in focus.
-    editable ? (_inputRef$current2 = inputRef.current) === null || _inputRef$current2 === void 0 ? void 0 : _inputRef$current2.focus() : (_comboboxRef$current = comboboxRef.current) === null || _comboboxRef$current === void 0 ? void 0 : _comboboxRef$current.focus();
-  }, [editable, onClean]);
-  var handleInputChange = useCallback(function (event) {
-    var _event$target;
-    var value = (_event$target = event.target) === null || _event$target === void 0 ? void 0 : _event$target.value;
-    setInputValue(value);
-    onInputChange === null || onInputChange === void 0 ? void 0 : onInputChange(value, event);
-  }, [onInputChange]);
-  var handleInputKeyDown = useCallback(function (event) {
-    if (editable) {
-      if (event.key === KEY_VALUES.ENTER) {
-        onInputPressEnter === null || onInputPressEnter === void 0 ? void 0 : onInputPressEnter(event);
-      }
-      if (event.key === KEY_VALUES.BACKSPACE) {
-        onInputBackspace === null || onInputBackspace === void 0 ? void 0 : onInputBackspace(event);
-      }
-    }
-  }, [editable, onInputPressEnter, onInputBackspace]);
-  var renderInput = useCallback(function (ref, props) {
-    return /*#__PURE__*/React.createElement("input", _extends({
-      type: "text",
-      autoComplete: "off",
-      ref: mergeRefs(inputRef, ref),
-      name: name,
-      style: {
-        pointerEvents: editable ? undefined : 'none'
-      }
-    }, props));
-  }, [editable, name]);
+    (_combobox$current = combobox.current) === null || _combobox$current === void 0 ? void 0 : _combobox$current.focus();
+  });
   var ToggleCaret = useToggleCaret(placement);
   var Caret = caretAs !== null && caretAs !== void 0 ? caretAs : ToggleCaret;
   if (plaintext) {
@@ -161,88 +76,55 @@ var PickerToggle = /*#__PURE__*/React.forwardRef(function (props, ref) {
       localeKey: "notSelected"
     }, hasValue ? children : null);
   }
-  var showCleanButton = cleanableProp && hasValue && !readOnly;
-
-  // When the component is read-only or disabled, the input is not interactive.
-  var inputFocused = readOnly || disabled ? false : editable && activeState;
-  var tabIndex = disabled ? undefined : tabIndexProp;
+  var showCleanButton = cleanable && hasValue && !readOnly;
   return /*#__PURE__*/React.createElement(Component, _extends({
     role: "combobox",
-    "aria-haspopup": "listbox",
-    "aria-expanded": activeProp,
+    id: id,
+    "aria-haspopup": popupType,
+    "aria-expanded": active,
     "aria-disabled": disabled,
-    "aria-owns": id ? id + "-listbox" : undefined
+    "aria-controls": id + "-" + popupType,
+    "aria-labelledby": labelId,
+    "aria-describedby": id + "-describe",
+    "aria-activedescendant": active && focusItemValue ? id + "-opt-" + focusItemValue : undefined
   }, rest, {
-    ref: mergeRefs(comboboxRef, ref),
+    ref: mergeRefs(combobox, ref),
     disabled: disabled,
-    tabIndex: tabIndex,
-    className: classes,
-    onFocus: !disabled ? handleFocus : null
-    // The debounce is set to 200 to solve the flicker caused by the switch between input and div.
-    ,
-    onBlur: !disabled ? debounce(handleBlur, 200) : null
-  }), /*#__PURE__*/React.createElement(Stack, null, label && /*#__PURE__*/React.createElement(Stack.Item, null, /*#__PURE__*/React.createElement("span", {
-    className: prefix('label')
+    tabIndex: disabled ? undefined : tabIndex,
+    className: classes
+  }), /*#__PURE__*/React.createElement(Stack, null, label && /*#__PURE__*/React.createElement(Stack.Item, null, /*#__PURE__*/React.createElement(PickerLabel, {
+    as: "span",
+    className: prefix('label'),
+    id: labelId
   }, label)), /*#__PURE__*/React.createElement(Stack.Item, {
     grow: 1,
     style: {
       overflow: 'hidden'
     }
-  }, loading ? /*#__PURE__*/React.createElement(Loader, {
+  }, /*#__PURE__*/React.createElement("input", {
+    readOnly: true,
+    "aria-hidden": true,
+    tabIndex: -1,
+    "data-testid": "picker-toggle-input",
+    name: name,
+    value: inputValue,
+    className: prefix('textbox', 'read-only'),
     style: {
-      display: 'block',
-      padding: '1px 0'
-    },
-    "data-testid": "spinner"
-  }) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(TextMask, {
-    keepCharPositions: true,
-    mask: inputMask,
-    value: Array.isArray(inputValue) ? inputValue.toString() : inputValue,
-    onBlur: handleInputBlur,
-    onFocus: onInputFocus,
-    onChange: handleInputChange,
-    onKeyDown: handleInputKeyDown,
-    id: id,
-    "aria-hidden": !inputFocused,
-    readOnly: !inputFocused,
-    disabled: disabled,
-    "aria-controls": id ? id + "-listbox" : undefined,
-    tabIndex: editable ? 0 : -1,
-    className: prefix('textbox', {
-      'read-only': !inputFocused
-    }),
-    placeholder: inputPlaceholder,
-    render: renderInput,
-    "data-testid": "picker-toggle-input"
+      pointerEvents: 'none'
+    }
   }), children ? /*#__PURE__*/React.createElement("span", {
     className: prefix(hasValue ? 'value' : 'placeholder'),
-    "aria-placeholder": typeof children === 'string' ? children : undefined
-  }, children) : null)), showCleanButton && /*#__PURE__*/React.createElement(CloseButton, {
-    className: prefix(_templateObject || (_templateObject = _taggedTemplateLiteralLoose(["clean"]))),
-    tabIndex: -1,
-    locale: {
-      closeLabel: locale === null || locale === void 0 ? void 0 : locale.clear
-    },
-    onClick: handleClean
-  }), caret && !showCleanButton && /*#__PURE__*/React.createElement(Caret, {
-    className: prefix(_templateObject2 || (_templateObject2 = _taggedTemplateLiteralLoose(["caret"])))
-  })));
+    id: id + "-describe",
+    "data-testid": "picker-describe"
+  }, children) : null), /*#__PURE__*/React.createElement(Stack.Item, {
+    className: prefix(_templateObject || (_templateObject = _taggedTemplateLiteralLoose(["indicator"])))
+  }, /*#__PURE__*/React.createElement(PickerIndicator, {
+    as: React.Fragment,
+    loading: loading,
+    caretAs: caret ? Caret : null,
+    onClose: handleClean,
+    showCleanButton: showCleanButton
+  }))));
 });
 PickerToggle.displayName = 'PickerToggle';
-PickerToggle.propTypes = {
-  classPrefix: PropTypes.string,
-  hasValue: PropTypes.bool,
-  cleanable: PropTypes.bool,
-  className: PropTypes.string,
-  children: PropTypes.node,
-  caret: PropTypes.bool,
-  as: PropTypes.elementType,
-  onClean: PropTypes.func,
-  active: PropTypes.bool,
-  readOnly: PropTypes.bool,
-  disabled: PropTypes.bool,
-  plaintext: PropTypes.bool,
-  caretComponent: deprecatePropType(PropTypes.elementType, 'Use `caretAs` instead.'),
-  caretAs: PropTypes.elementType
-};
 export default PickerToggle;

package/esm/Picker/PickerToggleTrigger.d.ts

@@ -4,6 +4,14 @@ import { PositionChildProps } from '../Overlay/Position';
 import { TypeAttributes, AnimationEventProps } from '../@types/common';
 export type { OverlayTriggerHandle, PositionChildProps };
 export interface PickerToggleTriggerProps extends Omit<AnimationEventProps, 'onEntering' | 'onExiting'>, Pick<OverlayTriggerProps, 'speaker' | 'onClose'> {
+    id?: string;
+    /**
+     * Identifies the combobox has having a popout, and indicates the type.
+     *
+     * @see MDN https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup
+     */
+    popupType?: 'listbox' | 'tree' | 'grid' | 'dialog' | 'menu';
+    multiple?: boolean;
     placement?: TypeAttributes.Placement;
     pickerProps: any;
     open?: boolean;
@@ -12,5 +20,12 @@ export interface PickerToggleTriggerProps extends Omit<AnimationEventProps, 'onE
 }
 export declare const omitTriggerPropKeys: string[];
 export declare const pickTriggerPropKeys: string[];
+export interface ComboboxContextProps {
+    id?: string;
+    multiple?: boolean;
+    hasLabel?: boolean;
+    popupType?: 'listbox' | 'tree' | 'grid' | 'dialog' | 'menu';
+}
+export declare const ComboboxContextContext: React.Context<ComboboxContextProps>;
 declare const PickerToggleTrigger: React.ForwardRefExoticComponent<PickerToggleTriggerProps & React.RefAttributes<any>>;
 export default PickerToggleTrigger;

package/esm/Picker/PickerToggleTrigger.js

@@ -4,26 +4,41 @@ import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWith
 import React from 'react';
 import pick from 'lodash/pick';
 import OverlayTrigger from '../Overlay/OverlayTrigger';
-import { placementPolyfill, useCustom } from '../utils';
+import { placementPolyfill, useCustom, useUniqueId } from '../utils';
 export var omitTriggerPropKeys = ['onEntered', 'onExited', 'onEnter', 'onEntering', 'onExit', 'onExiting', 'open', 'defaultOpen', 'container', 'containerPadding', 'preventOverflow'];
-export var pickTriggerPropKeys = [].concat(omitTriggerPropKeys, ['disabled', 'plaintext', 'readOnly', 'loading']);
+export var pickTriggerPropKeys = [].concat(omitTriggerPropKeys, ['disabled', 'plaintext', 'readOnly', 'loading', 'label']);
+export var ComboboxContextContext = /*#__PURE__*/React.createContext({
+  popupType: 'listbox'
+});
 var PickerToggleTrigger = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var pickerProps = props.pickerProps,
     speaker = props.speaker,
     placement = props.placement,
     _props$trigger = props.trigger,
     trigger = _props$trigger === void 0 ? 'click' : _props$trigger,
-    rest = _objectWithoutPropertiesLoose(props, ["pickerProps", "speaker", "placement", "trigger"]);
+    id = props.id,
+    multiple = props.multiple,
+    _props$popupType = props.popupType,
+    popupType = _props$popupType === void 0 ? 'listbox' : _props$popupType,
+    rest = _objectWithoutPropertiesLoose(props, ["pickerProps", "speaker", "placement", "trigger", "id", "multiple", "popupType"]);
   var pickerTriggerProps = pick(pickerProps, pickTriggerPropKeys);
+  var pickerId = useUniqueId('rs-', id);
   var _useCustom = useCustom(),
     rtl = _useCustom.rtl;
-  return /*#__PURE__*/React.createElement(OverlayTrigger, _extends({}, pickerTriggerProps, rest, {
+  return /*#__PURE__*/React.createElement(ComboboxContextContext.Provider, {
+    value: {
+      id: pickerId,
+      hasLabel: typeof pickerTriggerProps.label !== 'undefined',
+      multiple: multiple,
+      popupType: popupType
+    }
+  }, /*#__PURE__*/React.createElement(OverlayTrigger, _extends({}, pickerTriggerProps, rest, {
     disabled: pickerTriggerProps.disabled || pickerTriggerProps.loading,
     ref: ref,
     trigger: trigger,
     placement: placementPolyfill(placement, rtl),
     speaker: speaker
-  }));
+  })));
 });
 PickerToggleTrigger.displayName = 'PickerToggleTrigger';
 export default PickerToggleTrigger;

package/esm/Picker/SearchBar.js

@@ -1,11 +1,10 @@
 'use client';
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-import React, { useCallback } from 'react';
-import get from 'lodash/get';
+import React from 'react';
 import PropTypes from 'prop-types';
 import Search from '@rsuite/icons/legacy/Search';
-import { useClassNames } from '../utils';
+import { useClassNames, useEventCallback } from '../utils';
 var SearchBar = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,
@@ -23,15 +22,15 @@ var SearchBar = /*#__PURE__*/React.forwardRef(function (props, ref) {
     merge = _useClassNames.merge,
     prefix = _useClassNames.prefix;
   var classes = merge(className, withClassPrefix());
-  var handleChange = useCallback(function (event) {
-    onChange === null || onChange === void 0 ? void 0 : onChange(get(event, 'target.value'), event);
-  }, [onChange]);
-  return /*#__PURE__*/React.createElement(Component, _extends({
-    role: "searchbox"
-  }, rest, {
+  var handleChange = useEventCallback(function (event) {
+    var _event$target;
+    onChange === null || onChange === void 0 ? void 0 : onChange((_event$target = event.target) === null || _event$target === void 0 ? void 0 : _event$target.value, event);
+  });
+  return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
     ref: ref,
     className: classes
   }), /*#__PURE__*/React.createElement("input", {
+    role: "searchbox",
     className: prefix('input'),
     value: value,
     onChange: handleChange,

package/esm/Picker/TreeView.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+interface TreeViewProps extends React.HTMLAttributes<HTMLDivElement> {
+    treeRootClassName: string;
+    multiselectable?: boolean;
+}
+declare const TreeView: React.ForwardRefExoticComponent<TreeViewProps & React.RefAttributes<HTMLDivElement>>;
+export default TreeView;

package/esm/Picker/TreeView.js

@@ -0,0 +1,25 @@
+'use client';
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import React from 'react';
+import useCombobox from './hooks/useCombobox';
+var TreeView = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var children = props.children,
+    treeRootClassName = props.treeRootClassName,
+    multiselectable = props.multiselectable,
+    rest = _objectWithoutPropertiesLoose(props, ["children", "treeRootClassName", "multiselectable"]);
+  var _useCombobox = useCombobox(),
+    id = _useCombobox.id,
+    labelId = _useCombobox.labelId,
+    popupType = _useCombobox.popupType;
+  return /*#__PURE__*/React.createElement("div", _extends({
+    role: "tree",
+    id: id + "-" + popupType,
+    "aria-multiselectable": multiselectable,
+    "aria-labelledby": labelId,
+    ref: ref
+  }, rest), /*#__PURE__*/React.createElement("div", {
+    className: treeRootClassName
+  }, children));
+});
+export default TreeView;

package/esm/Picker/hooks/index.d.ts

@@ -0,0 +1,6 @@
+export { default as usePickerRef } from './usePickerRef';
+export { default as useCombobox } from './useCombobox';
+export { default as useFocusItemValue } from './useFocusItemValue';
+export { default as useToggleKeyDownEvent } from './useToggleKeyDownEvent';
+export { default as useSearch } from './useSearch';
+export { default as usePickerClassName } from './usePickerClassName';

package/esm/Picker/hooks/index.js

@@ -0,0 +1,7 @@
+'use client';
+export { default as usePickerRef } from './usePickerRef';
+export { default as useCombobox } from './useCombobox';
+export { default as useFocusItemValue } from './useFocusItemValue';
+export { default as useToggleKeyDownEvent } from './useToggleKeyDownEvent';
+export { default as useSearch } from './useSearch';
+export { default as usePickerClassName } from './usePickerClassName';

package/esm/Picker/hooks/useCombobox.d.ts

@@ -0,0 +1,7 @@
+declare function useCombobox(): {
+    id: string | undefined;
+    popupType: "dialog" | "menu" | "grid" | "listbox" | "tree" | undefined;
+    multiple: boolean | undefined;
+    labelId: string | undefined;
+};
+export default useCombobox;

package/esm/Picker/hooks/useCombobox.js

@@ -0,0 +1,17 @@
+'use client';
+import { useContext } from 'react';
+import { ComboboxContextContext } from '../PickerToggleTrigger';
+function useCombobox() {
+  var _useContext = useContext(ComboboxContextContext),
+    id = _useContext.id,
+    hasLabel = _useContext.hasLabel,
+    popupType = _useContext.popupType,
+    multiple = _useContext.multiple;
+  return {
+    id: id,
+    popupType: popupType,
+    multiple: multiple,
+    labelId: hasLabel ? id + "-label" : undefined
+  };
+}
+export default useCombobox;

package/esm/Picker/hooks/useFocusItemValue.d.ts

@@ -0,0 +1,30 @@
+/// <reference types="react" />
+interface FocusItemValueProps<T = unknown> {
+    target: HTMLElement | null | (() => HTMLElement | null);
+    data?: T[];
+    /**
+     *  When the down arrow key is pressed, whether to automatically focus on the option
+     */
+    focusToOption?: boolean;
+    valueKey?: string;
+    focusableQueryKey?: string;
+    defaultLayer?: number;
+    rtl?: boolean;
+    callback?: (value: any, event: React.KeyboardEvent) => void;
+    getParent?: (node: T) => T | undefined;
+}
+/**
+ * A hook that manages the focus state of the option.
+ * @param defaultFocusItemValue
+ * @param props
+ */
+declare const useFocusItemValue: <T, D>(defaultFocusItemValue: T | null | undefined, props: FocusItemValueProps<D>) => {
+    focusItemValue: T | null | undefined;
+    setFocusItemValue: import("react").Dispatch<import("react").SetStateAction<T | null | undefined>>;
+    layer: number;
+    setLayer: import("react").Dispatch<import("react").SetStateAction<number>>;
+    keys: any[];
+    setKeys: import("react").Dispatch<import("react").SetStateAction<any[]>>;
+    onKeyDown: (...args: any[]) => any;
+};
+export default useFocusItemValue;