rsuite 5.2.1 → 5.3.0

package/esm/@types/common.d.ts

@@ -22,23 +22,23 @@ export interface RsRefForwardingComponent<T extends React.ElementType, P = unkno
 }
 export interface AnimationEventProps {
     /** Callback fired before the Modal transitions in */
-    onEnter?: (node?: null | Element | Text) => void;
+    onEnter?: (node: HTMLElement) => void;
     /** Callback fired as the Modal begins to transition in */
-    onEntering?: (node?: null | Element | Text) => void;
+    onEntering?: (node: HTMLElement) => void;
     /** Callback fired after the Modal finishes transitioning in */
-    onEntered?: (node?: null | Element | Text) => void;
+    onEntered?: (node: HTMLElement) => void;
     /** Callback fired right before the Modal transitions out */
-    onExit?: (node?: null | Element | Text) => void;
+    onExit?: (node: HTMLElement) => void;
     /** Callback fired as the Modal begins to transition out */
-    onExiting?: (node?: null | Element | Text) => void;
+    onExiting?: (node: HTMLElement) => void;
     /** Callback fired after the Modal finishes transitioning out */
-    onExited?: (node?: null | Element | Text) => void;
+    onExited?: (node: HTMLElement) => void;
 }
 export declare type PickerAppearance = 'default' | 'subtle';
 export interface PickerBaseProps<LocaleType = any> extends WithAsProps, AnimationEventProps {
     id?: string;
     /** Custom locale */
-    locale?: LocaleType;
+    locale?: Partial<LocaleType>;
     /** A picker can have different appearances. */
     appearance?: PickerAppearance;
     /** Format picker to appear inside a content block */
@@ -111,7 +111,7 @@ export interface FormControlPickerProps<ValueType = any, LocaleType = any, DataT
     /** Set children key in data */
     childrenKey?: string;
     /** Disabled items */
-    disabledItemValues?: ToArray<ValueType>;
+    disabledItemValues?: ToArray<NonNullable<ValueType>>;
     /** Initial value */
     defaultValue?: ValueType;
     /** Current value of the component. Creates a controlled component */
@@ -148,4 +148,5 @@ export interface Offset {
     width?: number;
     height?: number;
 }
+export declare type OnChangeCallback<T, E = React.SyntheticEvent> = (value: T, event: E) => void;
 export {};

package/esm/@types/utils.d.ts

@@ -9,3 +9,15 @@ export declare type Pick<T, K extends keyof T> = {
 export declare type Exclude<T, U> = T extends U ? never : T;
 export declare type Omit<T, U> = Pick<T, Exclude<keyof T, keyof U>>;
 export declare type ReplaceProps<Inner extends React.ElementType, P> = Omit<React.ComponentPropsWithRef<Inner>, P> & P;
+/**
+ * Prepend arguments to function
+ * Useful for prepend `newValue` arg to native `onChange` callbacks
+ *
+ * @see https://stackoverflow.com/a/69668215
+ * @example
+ *
+ * type SomeFunc = (a: string, b: number, c: someCustomType) => number;
+ * type SomeFuncAltered = PrependParameters<SomeFunc, [d: number]>;
+ * // SomeFuncAltered = (d: number, a:string, b:number, c:someCustomType) => number;
+ */
+export declare type PrependParameters<TFunction extends (...args: any) => any, TParameters extends [...args: any]> = (...args: [...TParameters, ...Parameters<TFunction>]) => ReturnType<TFunction>;

package/esm/Affix/Affix.js

@@ -64,11 +64,11 @@ function useFixed(offset, containerOffset, props) {
 
     var scrollY = window.scrollY || window.pageYOffset; // When the scroll distance exceeds the element's top value, it is fixed.
 
-    var nextFixed = scrollY - (offset.top - top) >= 0; // If the current element is specified in the container,
+    var nextFixed = scrollY - (Number(offset.top) - Number(top)) >= 0; // If the current element is specified in the container,
     // add to determine whether the current container is in the window range.
 
     if (containerOffset) {
-      nextFixed = nextFixed && scrollY < containerOffset.top + containerOffset.height;
+      nextFixed = nextFixed && scrollY < Number(containerOffset.top) + Number(containerOffset.height);
     }
 
     if (nextFixed !== fixed) {
@@ -110,8 +110,8 @@ var Affix = /*#__PURE__*/React.forwardRef(function (props, ref) {
 
   var classes = merge(className, (_merge = {}, _merge[withClassPrefix()] = fixed, _merge));
   var placeholderStyles = fixed ? {
-    width: offset.width,
-    height: offset.height
+    width: offset === null || offset === void 0 ? void 0 : offset.width,
+    height: offset === null || offset === void 0 ? void 0 : offset.height
   } : undefined;
   var fixedStyles = {
     position: 'fixed',
@@ -120,7 +120,7 @@ var Affix = /*#__PURE__*/React.forwardRef(function (props, ref) {
     width: offset === null || offset === void 0 ? void 0 : offset.width,
     zIndex: 10
   };
-  var affixStyles = fixed ? fixedStyles : null;
+  var affixStyles = fixed ? fixedStyles : undefined;
   return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
     ref: mergeRefs(mountRef, ref)
   }), /*#__PURE__*/React.createElement("div", {

package/esm/Animation/Transition.d.ts

@@ -36,7 +36,7 @@ interface TransitionState {
 }
 export declare const transitionPropTypes: {
     animation: PropTypes.Requireable<boolean>;
-    children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+    children: PropTypes.Requireable<string | number | boolean | {} | PropTypes.ReactElementLike | PropTypes.ReactNodeArray>;
     className: PropTypes.Requireable<string>;
     in: PropTypes.Requireable<boolean>;
     unmountOnExit: PropTypes.Requireable<boolean>;
@@ -53,10 +53,13 @@ export declare const transitionPropTypes: {
     onExiting: PropTypes.Requireable<(...args: any[]) => any>;
     onExited: PropTypes.Requireable<(...args: any[]) => any>;
 };
+declare type EventToken = {
+    off: () => void;
+};
 declare class Transition extends React.Component<TransitionProps, TransitionState> {
     static propTypes: {
         animation: PropTypes.Requireable<boolean>;
-        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        children: PropTypes.Requireable<string | number | boolean | {} | PropTypes.ReactElementLike | PropTypes.ReactNodeArray>;
         className: PropTypes.Requireable<string>;
         in: PropTypes.Requireable<boolean>;
         unmountOnExit: PropTypes.Requireable<boolean>;
@@ -77,26 +80,32 @@ declare class Transition extends React.Component<TransitionProps, TransitionStat
     static defaultProps: {
         timeout: number;
     };
-    animationEventListener: any;
-    instanceElement: any;
-    nextCallback: any;
-    needsUpdate: any;
+    animationEventListener: EventToken | null;
+    instanceElement: HTMLElement | null;
+    nextCallback: {
+        (event?: React.AnimationEvent): void;
+        cancel: () => any;
+    } | null;
+    needsUpdate: boolean | null;
     childRef: React.RefObject<any>;
     constructor(props: TransitionProps);
     static getDerivedStateFromProps(nextProps: TransitionProps, prevState: TransitionState): {
         status: STATUS;
-    };
-    getSnapshotBeforeUpdate(): any;
+    } | null;
+    getSnapshotBeforeUpdate(): null;
     componentDidMount(): void;
     componentDidUpdate(): void;
     componentWillUnmount(): void;
-    onTransitionEnd(node: HTMLElement, handler: React.AnimationEventHandler): void;
-    setNextCallback(callback: React.AnimationEventHandler): any;
-    getChildElement(): any;
+    onTransitionEnd(node: HTMLElement, handler: (event?: React.AnimationEvent) => void): void;
+    setNextCallback(callback: (event?: React.AnimationEvent) => void): {
+        (event?: React.AnimationEvent<Element> | undefined): void;
+        cancel: () => any;
+    };
+    getChildElement(): HTMLElement;
     performEnter(props: TransitionProps): void;
     performExit(props: TransitionProps): void;
     cancelNextCallback(): void;
-    safeSetState(nextState: TransitionState, callback: React.AnimationEventHandler): void;
+    safeSetState(nextState: TransitionState, callback: (event?: React.AnimationEvent) => void): void;
     render(): React.ReactNode;
 }
 export default Transition;

package/esm/Animation/Transition.js

@@ -250,7 +250,10 @@ var Transition = /*#__PURE__*/function (_React$Component) {
 
   _proto.safeSetState = function safeSetState(nextState, callback) {
     if (this.instanceElement) {
-      this.setState(nextState, this.setNextCallback(callback));
+      var nextCallback = this.setNextCallback(callback);
+      this.setState(nextState, function () {
+        return nextCallback();
+      });
     }
   };
 

package/esm/AutoComplete/AutoComplete.js

@@ -154,7 +154,7 @@ var AutoComplete = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var classes = merge(className, withClassPrefix({
     disabled: disabled
   }));
-  var triggerRef = useRef();
+  var triggerRef = useRef(null);
   usePublicMethods(ref, {
     triggerRef: triggerRef,
     overlayRef: overlayRef

package/esm/AutoComplete/utils.d.ts

@@ -1,3 +1,3 @@
 import { ItemDataType } from '../@types/common';
 export declare function transformData(data: any[]): any[];
-export declare const shouldDisplay: (filterBy: (value: string, item: ItemDataType) => boolean, value: any) => (item: any) => boolean;
+export declare const shouldDisplay: (filterBy: ((value: string, item: ItemDataType) => boolean) | undefined, value: any) => (item: any) => boolean;

package/esm/Avatar/Avatar.js

@@ -4,15 +4,16 @@ import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWith
 
 var _templateObject;
 
-import React from 'react';
+import React, { useContext } from 'react';
 import PropTypes from 'prop-types';
 import { useClassNames } from '../utils';
+import { AvatarGroupContext } from '../AvatarGroup/AvatarGroup';
 var Avatar = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$classPrefix = props.classPrefix,
       classPrefix = _props$classPrefix === void 0 ? 'avatar' : _props$classPrefix,
       _props$as = props.as,
       Component = _props$as === void 0 ? 'div' : _props$as,
-      size = props.size,
+      sizeProp = props.size,
       className = props.className,
       children = props.children,
       src = props.src,
@@ -23,12 +24,15 @@ var Avatar = /*#__PURE__*/React.forwardRef(function (props, ref) {
       alt = props.alt,
       rest = _objectWithoutPropertiesLoose(props, ["classPrefix", "as", "size", "className", "children", "src", "srcSet", "sizes", "imgProps", "circle", "alt"]);
 
+  var _useContext = useContext(AvatarGroupContext),
+      size = _useContext.size;
+
   var _useClassNames = useClassNames(classPrefix),
       withClassPrefix = _useClassNames.withClassPrefix,
       prefix = _useClassNames.prefix,
       merge = _useClassNames.merge;
 
-  var classes = merge(className, withClassPrefix(size, {
+  var classes = merge(className, withClassPrefix(sizeProp || size, {
     circle: circle
   }));
   return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {

package/esm/AvatarGroup/AvatarGroup.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import { TypeAttributes, WithAsProps, RsRefForwardingComponent } from '../@types/common';
+export interface AvatarGroupProps extends WithAsProps {
+    /** Render all avatars as stacks */
+    stack?: boolean;
+    /** Set the spacing of the avatar */
+    spacing?: number;
+    /** Set the size of all avatars. */
+    size?: TypeAttributes.Size;
+}
+export declare const AvatarGroupContext: React.Context<{
+    size?: TypeAttributes.Size | undefined;
+}>;
+declare const AvatarGroup: RsRefForwardingComponent<'div', AvatarGroupProps>;
+export default AvatarGroup;

package/esm/AvatarGroup/AvatarGroup.js

@@ -0,0 +1,54 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import React from 'react';
+import PropTypes from 'prop-types';
+import { useClassNames, useCustom } from '../utils';
+export var AvatarGroupContext = /*#__PURE__*/React.createContext({});
+var AvatarGroup = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var _props$as = props.as,
+      Component = _props$as === void 0 ? 'div' : _props$as,
+      _props$classPrefix = props.classPrefix,
+      classPrefix = _props$classPrefix === void 0 ? 'avatar-group' : _props$classPrefix,
+      spacing = props.spacing,
+      className = props.className,
+      children = props.children,
+      stack = props.stack,
+      size = props.size,
+      rest = _objectWithoutPropertiesLoose(props, ["as", "classPrefix", "spacing", "className", "children", "stack", "size"]);
+
+  var _useCustom = useCustom('AvatarGroup'),
+      rtl = _useCustom.rtl;
+
+  var _useClassNames = useClassNames(classPrefix),
+      withClassPrefix = _useClassNames.withClassPrefix,
+      merge = _useClassNames.merge;
+
+  var classes = merge(className, withClassPrefix({
+    stack: stack
+  }));
+  return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
+    ref: ref,
+    className: classes
+  }), /*#__PURE__*/React.createElement(AvatarGroupContext.Provider, {
+    value: {
+      size: size
+    }
+  }, spacing ? React.Children.map(children, function (child) {
+    var _extends2;
+
+    return /*#__PURE__*/React.cloneElement(child, {
+      style: _extends((_extends2 = {}, _extends2[rtl ? 'marginLeft' : 'marginRight'] = spacing, _extends2), child.props.style)
+    });
+  }) : children));
+});
+AvatarGroup.displayName = 'AvatarGroup';
+AvatarGroup.propTypes = {
+  as: PropTypes.elementType,
+  classPrefix: PropTypes.string,
+  className: PropTypes.string,
+  children: PropTypes.node,
+  stack: PropTypes.bool,
+  spacing: PropTypes.number,
+  size: PropTypes.oneOf(['lg', 'md', 'sm', 'xs'])
+};
+export default AvatarGroup;

package/esm/AvatarGroup/index.d.ts

@@ -0,0 +1,3 @@
+import AvatarGroup from './AvatarGroup';
+export type { AvatarGroupProps } from './AvatarGroup';
+export default AvatarGroup;

package/esm/AvatarGroup/index.js

@@ -0,0 +1,2 @@
+import AvatarGroup from './AvatarGroup';
+export default AvatarGroup;

package/esm/Breadcrumb/Breadcrumb.js

@@ -37,7 +37,7 @@ var Breadcrumb = /*#__PURE__*/React.forwardRef(function (props, ref) {
 
   var renderSeparator = function renderSeparator(key) {
     return /*#__PURE__*/React.createElement("span", {
-      key: key,
+      key: "breadcrumb-separator-" + key,
       "aria-hidden": true,
       className: prefix(_templateObject || (_templateObject = _taggedTemplateLiteralLoose(["separator"])))
     }, separator);

package/esm/Button/Button.js

@@ -4,8 +4,9 @@ import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWith
 
 var _templateObject;
 
-import React from 'react';
+import React, { useContext } from 'react';
 import PropTypes from 'prop-types';
+import { ButtonGroupContext } from '../ButtonGroup';
 import SafeAnchor from '../SafeAnchor';
 import Ripple from '../Ripple';
 import { isOneOf, useClassNames } from '../utils';
@@ -24,10 +25,13 @@ var Button = /*#__PURE__*/React.forwardRef(function (props, ref) {
       loading = props.loading,
       _props$ripple = props.ripple,
       ripple = _props$ripple === void 0 ? true : _props$ripple,
-      size = props.size,
+      sizeProp = props.size,
       typeProp = props.type,
       rest = _objectWithoutPropertiesLoose(props, ["as", "active", "appearance", "block", "className", "children", "classPrefix", "color", "disabled", "loading", "ripple", "size", "type"]);
 
+  var buttonGroup = useContext(ButtonGroupContext);
+  var size = sizeProp !== null && sizeProp !== void 0 ? sizeProp : buttonGroup === null || buttonGroup === void 0 ? void 0 : buttonGroup.size;
+
   var _useClassNames = useClassNames(classPrefix),
       withClassPrefix = _useClassNames.withClassPrefix,
       prefix = _useClassNames.prefix,

package/esm/ButtonGroup/ButtonGroup.js

@@ -3,6 +3,7 @@ import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWith
 import React from 'react';
 import PropTypes from 'prop-types';
 import { useClassNames } from '../utils';
+import ButtonGroupContext from './ButtonGroupContext';
 var ButtonGroup = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
       Component = _props$as === void 0 ? 'div' : _props$as,
@@ -27,11 +28,15 @@ var ButtonGroup = /*#__PURE__*/React.forwardRef(function (props, ref) {
     vertical: vertical,
     justified: justified
   }));
-  return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
+  return /*#__PURE__*/React.createElement(ButtonGroupContext.Provider, {
+    value: {
+      size: size
+    }
+  }, /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
     role: role,
     ref: ref,
     className: classes
-  }), children);
+  }), children));
 });
 ButtonGroup.displayName = 'ButtonGroup';
 ButtonGroup.propTypes = {

package/esm/ButtonGroup/ButtonGroupContext.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { TypeAttributes } from '../@types/common';
+export interface ButtonGroupContextProps {
+    size?: TypeAttributes.Size;
+}
+declare const ButtonGroupContext: React.Context<ButtonGroupContextProps | null>;
+export default ButtonGroupContext;

package/esm/ButtonGroup/ButtonGroupContext.js

@@ -0,0 +1,3 @@
+import React from 'react';
+var ButtonGroupContext = /*#__PURE__*/React.createContext(null);
+export default ButtonGroupContext;

package/esm/ButtonGroup/index.d.ts

@@ -1,3 +1,5 @@
 import ButtonGroup from './ButtonGroup';
+import ButtonGroupContext from './ButtonGroupContext';
 export type { ButtonGroupProps } from './ButtonGroup';
+export { ButtonGroupContext };
 export default ButtonGroup;

package/esm/ButtonGroup/index.js

@@ -1,2 +1,4 @@
 import ButtonGroup from './ButtonGroup';
+import ButtonGroupContext from './ButtonGroupContext';
+export { ButtonGroupContext };
 export default ButtonGroup;

package/esm/Calendar/Calendar.d.ts

@@ -20,7 +20,7 @@ export interface CalendarProps extends WithAsProps, Omit<HTMLAttributes<HTMLDivE
     /** Hidden seconds */
     disabledSeconds?: (second: number, date: Date) => boolean;
     /** Format str */
-    format?: string;
+    format: string;
     /** Hidden hours */
     hideHours?: (hour: number, date: Date) => boolean;
     /** Hidden minutes */
@@ -28,7 +28,7 @@ export interface CalendarProps extends WithAsProps, Omit<HTMLAttributes<HTMLDivE
     /** Hidden seconds */
     hideSeconds?: (second: number, date: Date) => boolean;
     /** The value that mouse hover on in range selection */
-    hoverRangeValue?: Date[];
+    hoverRangeValue?: [Date, Date];
     /** Is it in the same month as today */
     inSameMonth?: (date: Date) => boolean;
     /** ISO 8601 standard, each calendar week begins on Monday and Sunday on the seventh day */
@@ -36,7 +36,7 @@ export interface CalendarProps extends WithAsProps, Omit<HTMLAttributes<HTMLDivE
     /** Limit showing how many years in the future */
     limitEndYear?: number;
     /** Custom locale */
-    locale?: CalendarLocale;
+    locale: CalendarLocale;
     /** Callback after the date has changed */
     onChangePageDate?: (nextPageDate: Date, event: React.MouseEvent) => void;
     /** Callback after the time has changed */
@@ -48,7 +48,7 @@ export interface CalendarProps extends WithAsProps, Omit<HTMLAttributes<HTMLDivE
     /** Switch to the callback triggered after the next month. */
     onMoveForward?: (nextPageDate: Date) => void;
     /** Callback fired before the date selected */
-    onSelect?: (date: Date, event: React.MouseEvent<HTMLDivElement>) => void;
+    onSelect?: (date: Date, event: React.MouseEvent) => void;
     /** Date displayed on the current page */
     calendarDate: Date;
     /** Custom rendering cell*/

package/esm/Calendar/Calendar.js

@@ -30,7 +30,8 @@ var Calendar = /*#__PURE__*/React.forwardRef(function (props, ref) {
       format = props.format,
       hoverRangeValue = props.hoverRangeValue,
       inSameMonth = props.inSameMonth,
-      isoWeek = props.isoWeek,
+      _props$isoWeek = props.isoWeek,
+      isoWeek = _props$isoWeek === void 0 ? false : _props$isoWeek,
       limitEndYear = props.limitEndYear,
       locale = props.locale,
       onChangePageDate = props.onChangePageDate,
@@ -56,7 +57,9 @@ var Calendar = /*#__PURE__*/React.forwardRef(function (props, ref) {
       merge = _useClassNames.merge;
 
   var isDisabledDate = function isDisabledDate(date) {
-    return disabledDate === null || disabledDate === void 0 ? void 0 : disabledDate(date);
+    var _disabledDate;
+
+    return (_disabledDate = disabledDate === null || disabledDate === void 0 ? void 0 : disabledDate(date)) !== null && _disabledDate !== void 0 ? _disabledDate : false;
   };
 
   var isTimeDisabled = function isTimeDisabled(date) {

package/esm/Calendar/CalendarContext.js

@@ -1,5 +1,5 @@
 import React, { useContext } from 'react';
-var CalendarContext = /*#__PURE__*/React.createContext(null);
+var CalendarContext = /*#__PURE__*/React.createContext({});
 export default CalendarContext;
 export var CalendarProvider = CalendarContext.Provider;
 export var useCalendarContext = function useCalendarContext() {

package/esm/Calendar/TableRow.js

@@ -50,7 +50,7 @@ var TableRow = /*#__PURE__*/React.forwardRef(function (props, ref) {
         selectedStartDate = _ref[0],
         selectedEndDate = _ref[1];
 
-    var _ref2 = hoverRangeValue || [],
+    var _ref2 = hoverRangeValue !== null && hoverRangeValue !== void 0 ? hoverRangeValue : [],
         hoverStartDate = _ref2[0],
         hoverEndDate = _ref2[1];
 

package/esm/Calendar/TimeDropdown.js

@@ -78,8 +78,8 @@ var scrollTo = function scrollTo(time, row) {
     var node = container === null || container === void 0 ? void 0 : container.querySelector("[data-key=\"" + type + "-" + value + "\"]");
 
     if (node && container) {
-      var _getPosition = getPosition(node, container),
-          top = _getPosition.top;
+      var _ref2 = getPosition(node, container),
+          top = _ref2.top;
 
       scrollTopAnimation(container, top, scrollTop(container) !== 0);
     }
@@ -93,7 +93,8 @@ var TimeDropdown = /*#__PURE__*/React.forwardRef(function (props, ref) {
       _props$classPrefix = props.classPrefix,
       classPrefix = _props$classPrefix === void 0 ? 'calendar-time-dropdown' : _props$classPrefix,
       show = props.show,
-      showMeridian = props.showMeridian,
+      _props$showMeridian = props.showMeridian,
+      showMeridian = _props$showMeridian === void 0 ? false : _props$showMeridian,
       rest = _objectWithoutPropertiesLoose(props, ["as", "className", "classPrefix", "show", "showMeridian"]);
 
   var _useCalendarContext = useCalendarContext(),
@@ -165,7 +166,7 @@ var TimeDropdown = /*#__PURE__*/React.forwardRef(function (props, ref) {
           className: itemClasses,
           tabIndex: -1,
           "data-key": type + "-" + i,
-          onClick: !disabled ? partial(handleClick, type, i) : null
+          onClick: !disabled ? partial(handleClick, type, i) : undefined
         }, showMeridian && type === 'hours' && i === 0 ? '12' : i)));
       }
     }

package/esm/Calendar/types.d.ts

@@ -5,9 +5,9 @@ export interface CalendarInnerContextValue {
     dateRange?: Date[];
     disabledDate?: (date: Date, selectRangeValue?: Date[], type?: string) => boolean;
     format?: string;
-    hoverRangeValue?: Date[];
+    hoverRangeValue?: [Date, Date];
     inSameMonth?: (date: Date) => boolean;
-    isoWeek?: boolean;
+    isoWeek: boolean;
     onChangePageDate?: (nextPageDate: Date, event: React.MouseEvent) => void;
     onChangePageTime?: (nextPageTime: Date, event: React.MouseEvent) => void;
     onMouseMove?: (date: Date) => void;

package/esm/Calendar/useCalendarDate.d.ts

@@ -1,5 +1,5 @@
-declare const useCalendarDate: (value: Date, defaultDate: Date) => {
+declare const useCalendarDate: (value: Date | undefined, defaultDate: Date | undefined) => {
     calendarDate: Date;
-    setCalendarDate: (date: Date) => void;
+    setCalendarDate: (date: Date | undefined) => void;
 };
 export default useCalendarDate;

package/esm/Carousel/Carousel.d.ts

@@ -10,9 +10,9 @@ export interface CarouselProps extends WithAsProps {
     /** Button shape */
     shape?: 'dot' | 'bar';
     /** Callback fired when the active item changes */
-    onSelect: (index: number, event: React.ChangeEvent<HTMLInputElement>) => void;
+    onSelect?: (index: number, event: React.ChangeEvent<HTMLInputElement>) => void;
     /** Callback fired when a slide transition starts */
-    onSlideStart?: (index: number, event: React.ChangeEvent<HTMLInputElement>) => void;
+    onSlideStart?: (index: number, event?: React.ChangeEvent<HTMLInputElement>) => void;
     /** Callback fired when a slide transition ends */
     onSlideEnd?: (index: number, event: React.TransitionEvent<HTMLDivElement>) => void;
 }

package/esm/Carousel/Carousel.js

@@ -59,7 +59,7 @@ var Carousel = /*#__PURE__*/React.forwardRef(function (props, ref) {
 
   var handleChange = function handleChange(event) {
     var activeIndex = +event.target.value;
-    handleSlide(activeIndex);
+    handleSlide(activeIndex, event);
     onSelect === null || onSelect === void 0 ? void 0 : onSelect(activeIndex, event);
   };
 

package/esm/Cascader/Cascader.d.ts

@@ -3,7 +3,7 @@ import { PickerLocale } from '../locales';
 import { PickerComponent } from '../Picker';
 import { ItemDataType, FormControlPickerProps } from '../@types/common';
 export declare type ValueType = number | string;
-export interface CascaderProps<T = ValueType> extends FormControlPickerProps<T, PickerLocale, ItemDataType> {
+export interface CascaderProps<T = ValueType> extends FormControlPickerProps<T | null, PickerLocale, ItemDataType> {
     /** Sets the width of the menu */
     menuWidth?: number;
     /** Sets the height of the menu */

package/esm/Cascader/Cascader.js

@@ -74,10 +74,10 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       flattenData = _useState2[0],
       setFlattenData = _useState2[1];
 
-  var triggerRef = useRef();
-  var overlayRef = useRef();
-  var targetRef = useRef();
-  var searchInputRef = useRef();
+  var triggerRef = useRef(null);
+  var overlayRef = useRef(null);
+  var targetRef = useRef(null);
+  var searchInputRef = useRef(null);
 
   var _useControlled = useControlled(valueProp, defaultValue),
       value = _useControlled[0],
@@ -181,12 +181,12 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
     setSearchKeyword(value);
     onSearch === null || onSearch === void 0 ? void 0 : onSearch(value, event);
 
-    if (items !== null && items !== void 0 && items[0]) {
-      setFocusItemValue(items === null || items === void 0 ? void 0 : items[0]);
+    if (items.length > 0) {
+      setFocusItemValue(items[0][valueKey]);
       setLayer(0);
       setKeys([]);
     }
-  }, [getSearchResult, onSearch, setFocusItemValue, setKeys, setLayer]);
+  }, [getSearchResult, onSearch, setFocusItemValue, setKeys, setLayer, valueKey]);
   var handleEntered = useCallback(function () {
     onOpen === null || onOpen === void 0 ? void 0 : onOpen();
     setActive(true);
@@ -227,7 +227,7 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       }
 
       if (!shallowEqual(value, focusItemValue)) {
-        onChange === null || onChange === void 0 ? void 0 : onChange(focusItemValue, event);
+        onChange === null || onChange === void 0 ? void 0 : onChange(focusItemValue !== null && focusItemValue !== void 0 ? focusItemValue : null, event);
       }
 
       handleClose();
@@ -309,7 +309,7 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
     setValue(nextValue);
     setValueToPaths(nodes);
     enforceUpdate(nextValue);
-    onSelect === null || onSelect === void 0 ? void 0 : onSelect(node, null, event);
+    onSelect === null || onSelect === void 0 ? void 0 : onSelect(node, nodes, event);
     onChange === null || onChange === void 0 ? void 0 : onChange(nextValue, event);
   };
 
@@ -486,7 +486,7 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
     hasValue: hasValue,
     active: active,
     placement: placement,
-    inputValue: value
+    inputValue: value !== null && value !== void 0 ? value : ''
   }), selectedElement || (locale === null || locale === void 0 ? void 0 : locale.placeholder))));
 });
 Cascader.displayName = 'Cascader';