rsuite 5.46.1 → 5.48.0

package/esm/MaskedInput/createTextMaskInputElement.js

@@ -5,11 +5,9 @@ import isNumber from 'lodash/isNumber';
 import adjustCaretPosition from './adjustCaretPosition';
 import conformToMask from './conformToMask';
 import { convertMaskToPlaceholder, processCaretTraps, defaultPlaceholderChar } from './utilities';
+import safeSetSelection from '../utils/safeSetSelection';
 var emptyString = '';
-var strNone = 'none';
 var strObject = 'object';
-var isAndroid = typeof navigator !== 'undefined' && /Android/i.test(navigator.userAgent);
-var defer = typeof requestAnimationFrame !== 'undefined' ? requestAnimationFrame : setTimeout;
 export default function createTextMaskInputElement(config) {
   // Anything that we will need to keep between `update` calls, we will store in this `state` object.
   var state = {
@@ -141,7 +139,7 @@ export default function createTextMaskInputElement(config) {
         // indicate rejection. Or return just a string when there are no piped characters.
         // If the `pipe` returns `false` or a string, the block below turns it into an object that the rest
         // of the code can work with.
-        if (pipeResults === false) {
+        if (typeof pipeResults === 'boolean' && pipeResults === false) {
           // If the `pipe` rejects `conformedValue`, we use the `previousConformedValue`, and set `rejected` to `true`.
           pipeResults = {
             value: previousConformedValue,
@@ -186,22 +184,14 @@ export default function createTextMaskInputElement(config) {
         return;
       }
       inputElement.value = inputElementValue; // set the input value
-      safeSetSelection(inputElement, adjustedCaretPosition); // adjust caret position
+
+      if (typeof adjustedCaretPosition === 'number') {
+        safeSetSelection(inputElement, adjustedCaretPosition, adjustedCaretPosition); // adjust caret position
+      }
     }
   };
 }
 
-function safeSetSelection(element, selectionPosition) {
-  if (document.activeElement === element) {
-    if (isAndroid) {
-      defer(function () {
-        return element.setSelectionRange(selectionPosition, selectionPosition, strNone);
-      }, 0);
-    } else {
-      element.setSelectionRange(selectionPosition, selectionPosition, strNone);
-    }
-  }
-}
 function getSafeRawValue(inputValue) {
   if (isString(inputValue)) {
     return inputValue;

package/esm/Message/Message.d.ts

@@ -24,5 +24,9 @@ export interface MessageProps extends WithAsProps {
     /** Callback after the message is removed */
     onClose?: (event?: React.MouseEvent<HTMLButtonElement>) => void;
 }
+/**
+ * The `Message` component is used to display important messages to users.
+ * @see https://rsuitejs.com/components/message
+ */
 declare const Message: RsRefForwardingComponent<'div', MessageProps>;
 export default Message;

package/esm/Message/Message.js

@@ -8,6 +8,10 @@ import PropTypes from 'prop-types';
 import { useClassNames, useTimeout, MESSAGE_STATUS_ICONS, STATUS, useIsMounted } from '../utils';
 import CloseButton from '../CloseButton';
 import ToastContext from '../toaster/ToastContext';
+/**
+ * The `Message` component is used to display important messages to users.
+ * @see https://rsuitejs.com/components/message
+ */
 var Message = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _withClassPrefix;
   var _props$as = props.as,

package/esm/Modal/Modal.d.ts

@@ -35,5 +35,9 @@ interface ModalComponent extends RsRefForwardingComponent<'div', ModalProps> {
     Footer: typeof ModalFooter;
     Dialog: typeof ModalDialog;
 }
+/**
+ * The `Modal` component is used to show content in a layer above the app.
+ * @see https://rsuitejs.com/components/modal
+ */
 declare const Modal: ModalComponent;
 export default Modal;

package/esm/Modal/Modal.js

@@ -22,6 +22,10 @@ import useUniqueId from '../utils/useUniqueId';
 import deprecatePropType from '../utils/deprecatePropType';
 import DrawerContext from '../Drawer/DrawerContext';
 var modalSizes = ['xs', 'sm', 'md', 'lg', 'full'];
+/**
+ * The `Modal` component is used to show content in a layer above the app.
+ * @see https://rsuitejs.com/components/modal
+ */
 var Modal = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _prefix;
   var className = props.className,

package/esm/MultiCascader/MultiCascader.d.ts

@@ -34,5 +34,9 @@ export interface MultiCascaderProps<T = ValueType> extends FormControlPickerProp
     /** Asynchronously load the children of the tree node. */
     getChildren?: (node: ItemDataType) => ItemDataType[] | Promise<ItemDataType[]>;
 }
+/**
+ * The `MultiCascader` component is used to select multiple values from cascading options.
+ * @see https://rsuitejs.com/components/multi-cascader/
+ */
 declare const MultiCascader: PickerComponent<MultiCascaderProps>;
 export default MultiCascader;

package/esm/MultiCascader/MultiCascader.js

@@ -15,6 +15,11 @@ import { getColumnsAndPaths } from '../Cascader/utils';
 import { createChainedFunction, mergeRefs, getSafeRegExpString, useClassNames, useCustom, useUpdateEffect } from '../utils';
 import { PickerToggle, PickerOverlay, SearchBar, SelectedElement, PickerToggleTrigger, usePickerClassName, usePublicMethods, useToggleKeyDownEvent, useFocusItemValue, pickTriggerPropKeys, omitTriggerPropKeys, listPickerPropTypes } from '../Picker';
 var emptyArray = [];
+
+/**
+ * The `MultiCascader` component is used to select multiple values from cascading options.
+ * @see https://rsuitejs.com/components/multi-cascader/
+ */
 var MultiCascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _selectedPaths;
   var _props$as = props.as,

package/esm/Nav/Nav.d.ts

@@ -27,5 +27,9 @@ interface NavComponent extends RsRefForwardingComponent<'div', NavProps> {
     Item: typeof NavItem;
     Menu: typeof NavMenu;
 }
+/**
+ * The `Nav` component is used to create navigation links.
+ * @see https://rsuitejs.com/components/nav
+ */
 declare const Nav: NavComponent;
 export default Nav;

package/esm/Nav/Nav.js

@@ -20,6 +20,10 @@ import SidenavDropdownItem from '../Sidenav/SidenavDropdownItem';
 import NavbarItem from '../Navbar/NavbarItem';
 import SidenavItem from '../Sidenav/SidenavItem';
 import useInternalId from '../utils/useInternalId';
+/**
+ * The `Nav` component is used to create navigation links.
+ * @see https://rsuitejs.com/components/nav
+ */
 var Nav = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,

package/esm/Nav/NavDropdown.d.ts

@@ -60,8 +60,9 @@ export interface NavDropdownComponent extends RsRefForwardingComponent<'div', Na
 }
 /**
  * @private this component is not supposed to be used directly
- *          Instead it's rendered by a <Nav.Menu> call
+ *          Instead it's rendered by a `<Nav.Menu>` call
  *
+ * @example
  * <Nav>
  *   <Nav.Menu> -> This will render <NavDropdown> component
  *   </Nav.Menu>

package/esm/Nav/NavDropdown.js

@@ -16,8 +16,9 @@ import NavDropdownMenu from './NavDropdownMenu';
 import NavDropdownToggle from './NavDropdownToggle';
 /**
  * @private this component is not supposed to be used directly
- *          Instead it's rendered by a <Nav.Menu> call
+ *          Instead it's rendered by a `<Nav.Menu>` call
  *
+ * @example
  * <Nav>
  *   <Nav.Menu> -> This will render <NavDropdown> component
  *   </Nav.Menu>

package/esm/Nav/NavItem.d.ts

@@ -20,9 +20,12 @@ export interface NavItemProps<T = string> extends WithAsProps, Omit<React.HTMLAt
     onSelect?: (eventKey: T | undefined, event: React.SyntheticEvent) => void;
 }
 /**
- * The <Nav.Item> API
- * When used as direct child of <Nav>, render the NavItem
- * When used within a <Nav.Menu>, render the NavDropdownItem
+ * The `Nav.Item` component is used to create navigation links.
+ *
+ * - When used as direct child of `<Nav>`, render the NavItem
+ * - When used within a `<Nav.Menu>`, render the NavDropdownItem
+ * @see https://rsuitejs.com/components/nav
+ *
  */
 declare const NavItem: RsRefForwardingComponent<'a', NavItemProps>;
 export default NavItem;

package/esm/Nav/NavItem.js

@@ -9,9 +9,12 @@ import SafeAnchor from '../SafeAnchor';
 import { shallowEqual, useClassNames } from '../utils';
 import NavContext from './NavContext';
 /**
- * The <Nav.Item> API
- * When used as direct child of <Nav>, render the NavItem
- * When used within a <Nav.Menu>, render the NavDropdownItem
+ * The `Nav.Item` component is used to create navigation links.
+ *
+ * - When used as direct child of `<Nav>`, render the NavItem
+ * - When used within a `<Nav.Menu>`, render the NavDropdownItem
+ * @see https://rsuitejs.com/components/nav
+ *
  */
 var NavItem = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var nav = useContext(NavContext);

package/esm/Nav/NavMenu.d.ts

@@ -30,9 +30,12 @@ export declare type NavMenuAction = {
     };
 };
 /**
- * The <Nav.Menu> API
- * When used as direct child of <Nav>, render the NavDropdown
- * When used within another <Nav.Menu>, render the NavDropdownMenu
+ * The `Nav.Menu` component is used to create navigation menus.
+ *
+ * - When used as direct child of `<Nav>`, render the NavDropdown
+ * - When used within another `<Nav.Menu>`, render the NavDropdownMenu
+ *
+ * @see https://rsuitejs.com/components/nav
  */
 declare const NavMenu: React.ForwardRefExoticComponent<NavMenuProps & React.RefAttributes<any>>;
 export default NavMenu;

package/esm/Nav/NavMenu.js

@@ -39,9 +39,12 @@ var reducer = function reducer(state, action) {
 };
 
 /**
- * The <Nav.Menu> API
- * When used as direct child of <Nav>, render the NavDropdown
- * When used within another <Nav.Menu>, render the NavDropdownMenu
+ * The `Nav.Menu` component is used to create navigation menus.
+ *
+ * - When used as direct child of `<Nav>`, render the NavDropdown
+ * - When used within another `<Nav.Menu>`, render the NavDropdownMenu
+ *
+ * @see https://rsuitejs.com/components/nav
  */
 var NavMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var parentNavMenu = useContext(NavMenuContext);

package/esm/Navbar/Navbar.d.ts

@@ -20,5 +20,9 @@ interface NavbarComponent extends RsRefForwardingComponent<'div', NavbarProps> {
     Body: typeof NavbarBody;
     Brand: typeof NavbarBrand;
 }
+/**
+ * The `Navbar` component is used to create a navigation header.
+ * @see https://rsuitejs.com/components/navbar
+ */
 declare const Navbar: NavbarComponent;
 export default Navbar;

package/esm/Navbar/Navbar.js

@@ -7,6 +7,10 @@ import NavbarHeader from './NavbarHeader';
 import NavbarBrand from './NavbarBrand';
 import { useClassNames } from '../utils';
 export var NavbarContext = /*#__PURE__*/React.createContext(false);
+/**
+ * The `Navbar` component is used to create a navigation header.
+ * @see https://rsuitejs.com/components/navbar
+ */
 var Navbar = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var className = props.className,
     _props$as = props.as,

package/esm/Notification/Notification.d.ts

@@ -22,5 +22,10 @@ export interface NotificationProps extends WithAsProps {
     /** Callback after the message is removed */
     onClose?: (event?: React.MouseEvent<HTMLButtonElement>) => void;
 }
+/**
+ * The `Notification` component is used to display global messages and notifications.
+ *
+ * @see https://rsuitejs.com/components/notification
+ */
 declare const Notification: RsRefForwardingComponent<'div', NotificationProps>;
 export default Notification;

package/esm/Notification/Notification.js

@@ -8,6 +8,11 @@ import PropTypes from 'prop-types';
 import { useClassNames, useTimeout, MESSAGE_STATUS_ICONS, useIsMounted } from '../utils';
 import CloseButton from '../CloseButton';
 import ToastContext from '../toaster/ToastContext';
+/**
+ * The `Notification` component is used to display global messages and notifications.
+ *
+ * @see https://rsuitejs.com/components/notification
+ */
 var Notification = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,

package/esm/Overlay/Overlay.d.ts

@@ -38,5 +38,9 @@ export declare const overlayPropTypes: {
     onExiting: PropTypes.Requireable<(...args: any[]) => any>;
     onExited: PropTypes.Requireable<(...args: any[]) => any>;
 };
+/**
+ * Overlay is a powerful component that helps you create floating components.
+ * @private
+ */
 declare const Overlay: React.ForwardRefExoticComponent<OverlayProps & React.RefAttributes<unknown>>;
 export default Overlay;

package/esm/Overlay/Overlay.js

@@ -27,6 +27,11 @@ export var overlayPropTypes = {
   onExiting: PropTypes.func,
   onExited: PropTypes.func
 };
+
+/**
+ * Overlay is a powerful component that helps you create floating components.
+ * @private
+ */
 var Overlay = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _useContext = useContext(OverlayContext),
     overlayContainer = _useContext.overlayContainer;

package/esm/Overlay/OverlayTrigger.d.ts

@@ -78,5 +78,9 @@ export interface OverlayTriggerHandle {
     open: (delay?: number) => void;
     close: (delay?: number) => void;
 }
+/**
+ * OverlayTrigger is used to display floating elements on another component.
+ * @private
+ */
 declare const OverlayTrigger: React.ForwardRefExoticComponent<OverlayTriggerProps & React.RefAttributes<OverlayTriggerHandle>>;
 export default OverlayTrigger;

package/esm/Overlay/OverlayTrigger.js

@@ -52,6 +52,11 @@ function onMouseEventHandler(handler, event, delay) {
   }
 }
 var defaultTrigger = ['hover', 'focus'];
+
+/**
+ * OverlayTrigger is used to display floating elements on another component.
+ * @private
+ */
 var OverlayTrigger = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _useContext = useContext(OverlayContext),
     overlayContainer = _useContext.overlayContainer;
@@ -182,17 +187,6 @@ var OverlayTrigger = /*#__PURE__*/React.forwardRef(function (props, ref) {
       handleClose();
     }
   }, [handleClose]);
-
-  /**
-   * Toggle open and closed state.
-   */
-  var handleOpenState = useCallback(function () {
-    if (open) {
-      handleCloseWhenLeave();
-    } else {
-      handleOpen();
-    }
-  }, [open, handleCloseWhenLeave, handleOpen]);
   var handleDelayedOpen = useCallback(function () {
     mouseEnter.current = true;
     if (!enterable) {
@@ -209,6 +203,17 @@ var OverlayTrigger = /*#__PURE__*/React.forwardRef(function (props, ref) {
     }
     handleOpen();
   }, [enterable, open, handleOpen]);
+
+  /**
+   * Toggle open and closed state.
+   */
+  var handleOpenState = useCallback(function () {
+    if (open) {
+      handleCloseWhenLeave();
+    } else {
+      handleDelayedOpen();
+    }
+  }, [open, handleCloseWhenLeave, handleDelayedOpen]);
   var handleDelayedClose = useCallback(function () {
     mouseEnter.current = false;
     if (!enterable) {

package/esm/Overlay/Position.d.ts

@@ -22,5 +22,9 @@ export interface PositionInstance {
     updatePosition?: () => void;
     child?: Element;
 }
+/**
+ * The `Position` component calculates the position of the child element.
+ * @private
+ */
 declare const Position: React.ForwardRefExoticComponent<PositionProps & React.RefAttributes<unknown>>;
 export default Position;

package/esm/Overlay/Position.js

@@ -121,6 +121,10 @@ var usePosition = function usePosition(props, ref) {
   }, [updatePosition, placement]);
   return [position, updatePosition];
 };
+/**
+ * The `Position` component calculates the position of the child element.
+ * @private
+ */
 var Position = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var children = props.children,
     className = props.className,

package/esm/Pagination/Pagination.d.ts

@@ -33,5 +33,10 @@ export interface PaginationProps extends WithAsProps {
     /** callback function for pagination clicked */
     onSelect?: (eventKey: string | number, event: React.MouseEvent) => void;
 }
+/**
+ * Pagination component for displaying page numbers.
+ *
+ * @see https://rsuitejs.com/components/pagination
+ */
 declare const Pagination: RsRefForwardingComponent<'div', PaginationProps>;
 export default Pagination;

package/esm/Pagination/Pagination.js

@@ -19,6 +19,11 @@ var PAGINATION_ICONS = {
   first: /*#__PURE__*/React.createElement(PageTop, null),
   last: /*#__PURE__*/React.createElement(PageEnd, null)
 };
+/**
+ * Pagination component for displaying page numbers.
+ *
+ * @see https://rsuitejs.com/components/pagination
+ */
 var Pagination = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,

package/esm/Panel/Panel.d.ts

@@ -26,5 +26,9 @@ export interface PanelProps<T = string | number> extends WithAsProps, AnimationE
     /** callback function for the panel clicked */
     onSelect?: (eventKey: T | undefined, event: React.SyntheticEvent) => void;
 }
+/**
+ * The `Panel` component is used to display content that can be collapsed.
+ * @see https://rsuitejs.com/components/panel
+ */
 declare const Panel: RsRefForwardingComponent<'div', PanelProps>;
 export default Panel;

package/esm/Panel/Panel.js

@@ -8,6 +8,10 @@ import AngleDownIcon from '@rsuite/icons/legacy/AngleDown';
 import Collapse from '../Animation/Collapse';
 import { useClassNames, useControlled } from '../utils';
 import { PanelGroupContext } from '../PanelGroup';
+/**
+ * The `Panel` component is used to display content that can be collapsed.
+ * @see https://rsuitejs.com/components/panel
+ */
 var Panel = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,

package/esm/PanelGroup/PanelGroup.d.ts

@@ -21,5 +21,9 @@ interface PanelGroupContext {
     onGroupSelect?: (activeKey: KeyType | undefined, event: React.MouseEvent) => void;
 }
 export declare const PanelGroupContext: React.Context<PanelGroupContext>;
+/**
+ * The `PanelGroup` component is used to display content that can be collapsed.
+ * @see https://rsuitejs.com/components/panel
+ */
 declare const PanelGroup: React.ForwardRefExoticComponent<PanelGroupProps<KeyType> & React.RefAttributes<unknown>>;
 export default PanelGroup;

package/esm/PanelGroup/PanelGroup.js

@@ -5,6 +5,11 @@ import React, { useCallback, useMemo } from 'react';
 import PropTypes from 'prop-types';
 import { useClassNames, useControlled } from '../utils';
 export var PanelGroupContext = /*#__PURE__*/React.createContext({});
+
+/**
+ * The `PanelGroup` component is used to display content that can be collapsed.
+ * @see https://rsuitejs.com/components/panel
+ */
 var PanelGroup = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,

package/esm/Picker/DropdownMenu.d.ts

@@ -17,6 +17,7 @@ export interface DropdownMenuProps<Multiple = false> extends StandardProps, Omit
     style?: React.CSSProperties;
     dropdownMenuItemAs: React.ElementType | string;
     dropdownMenuItemClassPrefix?: string;
+    dropdownMenuItemProps?: any;
     rowHeight?: number;
     rowGroupHeight?: number;
     virtualized?: boolean;

package/esm/Picker/DropdownMenu.js

@@ -9,6 +9,7 @@ import isUndefined from 'lodash/isUndefined';
 import isString from 'lodash/isString';
 import isNumber from 'lodash/isNumber';
 import findIndex from 'lodash/findIndex';
+import pickBy from 'lodash/pickBy';
 import getPosition from 'dom-lib/getPosition';
 import scrollTop from 'dom-lib/scrollTop';
 import getHeight from 'dom-lib/getHeight';
@@ -43,6 +44,7 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
     focusItemValue = props.focusItemValue,
     dropdownMenuItemClassPrefix = props.dropdownMenuItemClassPrefix,
     DropdownMenuItem = props.dropdownMenuItemAs,
+    dropdownMenuItemProps = props.dropdownMenuItemProps,
     _props$rowHeight = props.rowHeight,
     rowHeight = _props$rowHeight === void 0 ? 36 : _props$rowHeight,
     _props$rowGroupHeight = props.rowGroupHeight,
@@ -51,7 +53,7 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
     renderMenuItem = props.renderMenuItem,
     onGroupTitleClick = props.onGroupTitleClick,
     onSelect = props.onSelect,
-    rest = _objectWithoutPropertiesLoose(props, ["data", "group", "groupBy", "maxHeight", "activeItemValues", "disabledItemValues", "classPrefix", "valueKey", "labelKey", "virtualized", "listProps", "listRef", "className", "style", "focusItemValue", "dropdownMenuItemClassPrefix", "dropdownMenuItemAs", "rowHeight", "rowGroupHeight", "renderMenuGroup", "renderMenuItem", "onGroupTitleClick", "onSelect"]);
+    rest = _objectWithoutPropertiesLoose(props, ["data", "group", "groupBy", "maxHeight", "activeItemValues", "disabledItemValues", "classPrefix", "valueKey", "labelKey", "virtualized", "listProps", "listRef", "className", "style", "focusItemValue", "dropdownMenuItemClassPrefix", "dropdownMenuItemAs", "dropdownMenuItemProps", "rowHeight", "rowGroupHeight", "renderMenuGroup", "renderMenuItem", "onGroupTitleClick", "onSelect"]);
   var _useClassNames = useClassNames(classPrefix),
     withClassPrefix = _useClassNames.withClassPrefix,
     prefix = _useClassNames.prefix,
@@ -149,7 +151,7 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
       return shallowEqual(v, value);
     });
     var focus = !isUndefined(focusItemValue) && shallowEqual(focusItemValue, value);
-    return /*#__PURE__*/React.createElement(DropdownMenuItem, {
+    return /*#__PURE__*/React.createElement(DropdownMenuItem, _extends({
       style: style,
       key: itemKey,
       disabled: disabled,
@@ -158,7 +160,9 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
       value: value,
       classPrefix: dropdownMenuItemClassPrefix,
       onSelect: handleSelect.bind(null, item)
-    }, renderMenuItem ? renderMenuItem(label, item) : label);
+    }, pickBy(dropdownMenuItemProps, function (v) {
+      return v !== undefined;
+    })), renderMenuItem ? renderMenuItem(label, item) : label);
   };
   var filteredItems = group ? data.filter(function (item) {
     var _item$parent;

package/esm/Picker/DropdownMenuCheckItem.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { CheckboxProps } from '../Checkbox';
 import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
 export interface DropdownMenuCheckItemProps extends WithAsProps {
     active?: boolean;
@@ -16,6 +17,7 @@ export interface DropdownMenuCheckItemProps extends WithAsProps {
     onCheck?: (value: any, event: React.SyntheticEvent, checked: boolean) => void;
     onSelectItem?: (value: any, event: React.SyntheticEvent, checked: boolean) => void;
     onKeyDown?: (event: React.KeyboardEvent) => void;
+    renderMenuItemCheckbox?: (checkboxProps: CheckboxProps) => React.ReactNode;
 }
 declare const DropdownMenuCheckItem: RsRefForwardingComponent<'div', DropdownMenuCheckItemProps>;
 export default DropdownMenuCheckItem;

package/esm/Picker/DropdownMenuCheckItem.js

@@ -26,7 +26,8 @@ var DropdownMenuCheckItem = /*#__PURE__*/React.forwardRef(function (props, ref)
     onSelect = props.onSelect,
     onCheck = props.onCheck,
     onSelectItem = props.onSelectItem,
-    rest = _objectWithoutPropertiesLoose(props, ["active", "as", "checkboxAs", "classPrefix", "checkable", "disabled", "value", "focus", "children", "className", "indeterminate", "onKeyDown", "onSelect", "onCheck", "onSelectItem"]);
+    renderMenuItemCheckbox = props.renderMenuItemCheckbox,
+    rest = _objectWithoutPropertiesLoose(props, ["active", "as", "checkboxAs", "classPrefix", "checkable", "disabled", "value", "focus", "children", "className", "indeterminate", "onKeyDown", "onSelect", "onCheck", "onSelectItem", "renderMenuItemCheckbox"]);
   var handleChange = useCallback(function (value, checked, event) {
     onSelect === null || onSelect === void 0 ? void 0 : onSelect(value, event, checked);
   }, [onSelect]);
@@ -45,6 +46,19 @@ var DropdownMenuCheckItem = /*#__PURE__*/React.forwardRef(function (props, ref)
   var checkboxItemClasses = withClassPrefix({
     focus: focus
   });
+  var checkboxProps = {
+    value: value,
+    disabled: disabled,
+    indeterminate: indeterminate,
+    checkable: checkable,
+    children: children,
+    checked: active,
+    className: checkboxItemClasses,
+    onKeyDown: disabled ? undefined : onKeyDown,
+    onChange: handleChange,
+    onClick: handleSelectItem,
+    onCheckboxClick: handleCheck
+  };
   return /*#__PURE__*/React.createElement(Component, _extends({
     role: "option",
     "aria-selected": active,
@@ -54,19 +68,9 @@ var DropdownMenuCheckItem = /*#__PURE__*/React.forwardRef(function (props, ref)
     ref: ref,
     className: className,
     tabIndex: -1
-  }), /*#__PURE__*/React.createElement(CheckboxItem, {
-    value: value,
-    role: "checkbox",
-    disabled: disabled,
-    checked: active,
-    checkable: checkable,
-    indeterminate: indeterminate,
-    className: checkboxItemClasses,
-    onKeyDown: disabled ? null : onKeyDown,
-    onChange: handleChange,
-    onClick: handleSelectItem,
-    onCheckboxClick: handleCheck
-  }, children));
+  }), renderMenuItemCheckbox ? renderMenuItemCheckbox(checkboxProps) : /*#__PURE__*/React.createElement(CheckboxItem, _extends({
+    role: "checkbox"
+  }, checkboxProps)));
 });
 DropdownMenuCheckItem.displayName = 'DropdownMenuCheckItem';
 DropdownMenuCheckItem.propTypes = {

package/esm/Picker/PickerToggle.js

@@ -8,7 +8,7 @@ import PropTypes from 'prop-types';
 import debounce from 'lodash/debounce';
 import ToggleButton from './ToggleButton';
 import CloseButton from '../CloseButton';
-import { useClassNames, KEY_VALUES, mergeRefs } from '../utils';
+import { useClassNames, useCustom, KEY_VALUES, mergeRefs } from '../utils';
 import Plaintext from '../Plaintext';
 import useToggleCaret from '../utils/useToggleCaret';
 import TextMask from '../MaskedInput/TextMask';
@@ -58,6 +58,8 @@ var PickerToggle = /*#__PURE__*/React.forwardRef(function (props, ref) {
     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),
@@ -218,7 +220,7 @@ var PickerToggle = /*#__PURE__*/React.forwardRef(function (props, ref) {
     className: prefix(_templateObject || (_templateObject = _taggedTemplateLiteralLoose(["clean"]))),
     tabIndex: -1,
     locale: {
-      closeLabel: 'Clear'
+      closeLabel: locale === null || locale === void 0 ? void 0 : locale.clear
     },
     onClick: handleClean
   }), caret && !showCleanButton && /*#__PURE__*/React.createElement(Caret, {

package/esm/Placeholder/Placeholder.d.ts

@@ -7,5 +7,9 @@ export interface Placeholder extends RsRefForwardingComponent<'div', Placeholder
     Grid: typeof PlaceholderGrid;
     Graph: typeof PlaceholderGraph;
 }
+/**
+ * The `Placeholder` component is used to display the loading state of the block.
+ * @see https://rsuitejs.com/components/placeholder
+ */
 declare const Placeholder: Placeholder;
 export default Placeholder;

package/esm/Placeholder/Placeholder.js

@@ -2,6 +2,10 @@
 import PlaceholderGraph from './PlaceholderGraph';
 import PlaceholderGrid from './PlaceholderGrid';
 import PlaceholderParagraph from './PlaceholderParagraph';
+/**
+ * The `Placeholder` component is used to display the loading state of the block.
+ * @see https://rsuitejs.com/components/placeholder
+ */
 var Placeholder = PlaceholderParagraph;
 Placeholder.Paragraph = PlaceholderParagraph;
 Placeholder.Grid = PlaceholderGrid;