@tiny-codes/react-easy 1.4.16 → 1.4.18

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 # Changelog
 
+## 1.4.18
+
+2025-9-23
+
+### Features
+
+#### `FloatDrawer`
+
+- ✨ add `destroyOnClose` prop to control whether to destroy the drawer content when closed
+
+## 1.4.17
+
+2025-9-23
+
+### Features
+
+#### `useDebounce`
+
+- ✨ enhance `useDebounce` with `cancel`, `disable`, `enable`, and `isDisabled` methods
+
 ## 1.4.16
 
 2025-9-18

package/es/components/FloatDrawer/index.d.ts

@@ -60,6 +60,11 @@ export interface FloatDrawerProps {
      * - **CN:** 抽屉是否可调整大小, 默认`true`。
      */
     resizable?: boolean;
+    /**
+     * - **EN:** Whether to destroy the drawer content when closed, default is `false`.
+     * - **CN:** 抽屉关闭时是否销毁内容，默认`false`。
+     */
+    destroyOnClose?: boolean;
     /**
      * - **EN:** Cache key for storing the drawer size in localStorage. If not set, the size will not be
      *   cached.

package/es/components/FloatDrawer/index.js

@@ -44,6 +44,8 @@ var FloatDrawer = function FloatDrawer(props) {
     showToggle = _props$showToggle === void 0 ? true : _props$showToggle,
     _props$resizable = props.resizable,
     resizable = _props$resizable === void 0 ? true : _props$resizable,
+    _props$destroyOnClose = props.destroyOnClose,
+    destroyOnClose = _props$destroyOnClose === void 0 ? false : _props$destroyOnClose,
     onOpenChange = props.onOpenChange,
     onResize = props.onResize,
     onClick = props.onClick;
@@ -179,7 +181,7 @@ var FloatDrawer = function FloatDrawer(props) {
           className: classNames("".concat(prefixCls, "-card"), classNamesInProps === null || classNamesInProps === void 0 ? void 0 : classNamesInProps.card),
           style: styles === null || styles === void 0 ? void 0 : styles.card
         }, cardProps), {}, {
-          children: children
+          children: !destroyOnClose || isOpen ? children : null
         }))
       }), showToggle && /*#__PURE__*/_jsx("div", {
         className: classNames("".concat(prefixCls, "-toggle"), classNamesInProps === null || classNamesInProps === void 0 ? void 0 : classNamesInProps.toggle),

package/es/components/FloatDrawer/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useContext","useEffect","useMemo","useRef","useState","Card","ConfigProvider","classNames","DownOutlined","LeftOutlined","RightOutlined","UpOutlined","useRefFunction","useStyle","jsx","_jsx","jsxs","_jsxs","FloatDrawer","props","prefixClsInProps","prefixCls","open","_props$position","position","cardProps","children","className","classNamesInProps","style","styles","cacheKey","defaultSize","_props$minSize","minSize","_props$maxSize","maxSize","Infinity","edgeOffset","_props$showToggle","showToggle","_props$resizable","resizable","onOpenChange","onResize","onClick","_useContext","ConfigContext","getPrefixCls","_useStyle","_useStyle2","_slicedToArray","wrapCSSVar","hashId","cssVarCls","_useState","_useState2","drawerRef","setDrawerRef","_useState3","localStorage","getItem","Number","_useState4","size","setSize","sizeMap","type","_defineProperty","_useState5","_useState6","isOpen","setIsOpen","_useState7","_useState8","isDragging","setIsDragging","dragStartPos","dragStartSize","classString","concat","closeIcon","openIcon","toggleDrawer","handleResizeStart","e","current","clientY","clientX","preventDefault","handleResize","newSize","setItem","String","handleResizeEnd","undefined","rect","getBoundingClientRect","width","height","window","addEventListener","removeEventListener","_objectSpread","ref","drawer","resizeHandle","onMouseDown","content","bordered","variant","card","toggle","handleIcon"],"sources":["../../../src/components/FloatDrawer/index.tsx"],"sourcesContent":["import type { CSSProperties, FC, ReactNode } from 'react';\nimport { useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { CardProps } from 'antd';\nimport { Card, ConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport { DownOutlined, LeftOutlined, RightOutlined, UpOutlined } from '@ant-design/icons';\nimport useRefFunction from '../../hooks/useRefFunction';\nimport useStyle from './style';\n\nexport interface FloatDrawerProps {\n  prefixCls?: string;\n  /**\n   * - **EN:** Whether the drawer is open\n   * - **CN:** 抽屉是否打开\n   */\n  open?: boolean;\n  /**\n   * - **EN:** Position of the drawer\n   * - **CN:** 抽屉的位置\n   *\n   * @default 'right'\n   */\n  position?: 'left' | 'right' | 'top' | 'bottom';\n  /**\n   * - **EN:** Default size of the drawer. If the drawer is placed on the left or right, this is the\n   *   width, otherwise it is the height. If not set, the drawer will adapt to the content size.\n   * - **CN:** 抽屉的默认宽度。如果抽屉放在左侧或右侧，则为宽度，否则为高度。不设置时，抽屉会根据内容自适应大小。\n   */\n  defaultSize?: number;\n  /**\n   * - **EN:** Minimum size of the drawer\n   * - **CN:** 抽屉的最小宽度\n   *\n   * @default 0\n   */\n  minSize?: number;\n  /**\n   * - **EN:** Maximum size of the drawer\n   * - **CN:** 抽屉的最大宽度\n   *\n   * @default Infinity\n   */\n  maxSize?: number;\n  /**\n   * - **EN:** Offset of the drawer from the edge of the screen, supports all CSS length units,\n   *   default is `0`.\n   *\n   * > The drawer will be hidden outside the parent container's edge, but since the parent container\n   * > may have padding or border, the drawer may not be completely hidden. You can adjust the\n   * > `edgeOffset` to ensure the drawer is completely hidden outside the parent container.\n   *\n   * - **CN:** 抽屉距离屏幕边缘的偏移量，支持所有的CSS长度单位, 默认`0`。\n   *\n   * > 抽屉会隐藏在父容器的外边缘, 但由于父容器可能有padding或border, 导致抽屉不能完全隐藏, 因此可以通过设置 `edgeOffset` 来调整抽屉的偏移量,\n   * > 以确保抽屉完全隐藏在父容器之外。\n   *\n   * @default 0\n   */\n  edgeOffset?: CSSProperties['width'];\n  /**\n   * - **EN:** Whether to show the toggle button, default is `true`.\n   * - **CN:** 是否显示展开/收起按钮，默认`true`。\n   */\n  showToggle?: boolean;\n  /**\n   * - **EN:** Whether the drawer is resizable, default is `true`.\n   * - **CN:** 抽屉是否可调整大小, 默认`true`。\n   */\n  resizable?: boolean;\n  /**\n   * - **EN:** Cache key for storing the drawer size in localStorage. If not set, the size will not be\n   *   cached.\n   * - **CN:** 指定一个localStorage缓存键，用于记忆抽屉宽度。如果不设置，则不使用缓存。\n   */\n  cacheKey?: string;\n  /**\n   * - **EN:** Custom class name for the root element\n   * - **CN:** 根元素的自定义类名\n   */\n  className?: string;\n  /**\n   * - **EN:** Custom class names for specific elements\n   * - **CN:** 特定元素的自定义类名\n   */\n  classNames?: {\n    /**\n     * - **EN:** Class name for the drawer element\n     * - **CN:** 抽屉元素的类名\n     */\n    drawer?: string;\n    /**\n     * - **EN:** Class name for the expand handle\n     * - **CN:** 展开手柄的类名\n     */\n    toggle?: string;\n    /**\n     * - **EN:** Class name for the resize handle\n     * - **CN:** 调整大小手柄的类名\n     */\n    resizeHandle?: string;\n    /**\n     * - **EN:** Class name for the handle icon\n     * - **CN:** 手柄图标的类名\n     */\n    handleIcon?: string;\n    /**\n     * - **EN:** Class name for the content area\n     * - **CN:** 内容区域的类名\n     */\n    content?: string;\n    /**\n     * - **EN:** Class name for the card element\n     * - **CN:** 卡片元素的类名\n     */\n    card?: string;\n  };\n  /**\n   * - **EN:** Custom styles for the root element\n   * - **CN:** 根元素的自定义样式\n   */\n  style?: CSSProperties;\n  /**\n   * - **EN:** Custom styles for specific elements\n   * - **CN:** 特定元素的自定义样式\n   */\n  styles?: {\n    /**\n     * - **EN:** Styles for the drawer element\n     * - **CN:** 抽屉元素的样式\n     */\n    drawer?: CSSProperties;\n    /**\n     * - **EN:** Styles for the expand handle\n     * - **CN:** 展开手柄的样式\n     */\n    toggle?: CSSProperties;\n    /**\n     * - **EN:** Styles for the resize handle\n     * - **CN:** 调整大小手柄的样式\n     */\n    resizeHandle?: CSSProperties;\n    /**\n     * - **EN:** Styles for the handle icon\n     * - **CN:** 手柄图标的样式\n     */\n    handleIcon?: CSSProperties;\n    /**\n     * - **EN:** Styles for the content area\n     * - **CN:** 内容区域的样式\n     */\n    content?: CSSProperties;\n    /**\n     * - **EN:** Styles for the card element\n     * - **CN:** 卡片元素的样式\n     */\n    card?: CSSProperties;\n  };\n  /**\n   * - **EN:** Custom properties for the card element\n   * - **CN:** 卡片元素的自定义属性\n   */\n  cardProps?: Omit<CardProps, 'children'>;\n  /**\n   * - **EN:** Content to be rendered inside the drawer\n   * - **CN:** 抽屉内容\n   */\n  children?: ReactNode;\n  /**\n   * - **EN:** Callback function when the open state changes\n   * - **CN:** 打开状态变化时的回调函数\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * - **EN:** Callback function when the drawer is resized\n   * - **CN:** 抽屉调整大小时的回调函数\n   */\n  onResize?: (size: number) => void;\n  /**\n   * - **EN:** Event handler for click events on the drawer container and its internal elements\n   * - **CN:** 点击抽屉容器及内部元素时的事件\n   */\n  onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;\n}\n\n/**\n * - **EN:** FloatDrawer component for creating a draggable, resizable drawer\n * - **CN:** FloatDrawer组件，用于创建可拖动、可调整大小的抽屉\n */\nconst FloatDrawer: FC<FloatDrawerProps> = (props) => {\n  const {\n    prefixCls: prefixClsInProps,\n    open,\n    position = 'right',\n    cardProps,\n    children,\n    className,\n    classNames: classNamesInProps,\n    style,\n    styles,\n    cacheKey,\n    defaultSize,\n    minSize = 0,\n    maxSize = +Infinity,\n    edgeOffset,\n    showToggle = true,\n    resizable = true,\n    onOpenChange,\n    onResize,\n    onClick,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('easy-float-drawer', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const [drawerRef, setDrawerRef] = useState<HTMLDivElement | null>(null);\n  const [size, setSize] = useState(\n    cacheKey && localStorage.getItem(cacheKey) ? Number(localStorage.getItem(cacheKey)) || defaultSize : defaultSize\n  );\n  const sizeMap = useMemo(() => {\n    const type = position === 'left' || position === 'right' ? 'width' : 'height';\n    return {\n      [type]: size,\n    };\n  }, [position, size]);\n  const [isOpen, setIsOpen] = useState<boolean>();\n  const [isDragging, setIsDragging] = useState(false);\n  const dragStartPos = useRef<number>(0);\n  const dragStartSize = useRef<number>(size);\n  const classString = classNames(\n    prefixCls,\n    className,\n    {\n      [`${prefixCls}-open`]: isOpen,\n      [`${prefixCls}-closed`]: !isOpen,\n      [`${prefixCls}-${position}`]: position,\n    },\n    hashId,\n    cssVarCls\n  );\n  const closeIcon = useMemo(() => {\n    return position === 'left' ? (\n      <RightOutlined />\n    ) : position === 'top' ? (\n      <DownOutlined />\n    ) : position === 'bottom' ? (\n      <UpOutlined />\n    ) : (\n      <LeftOutlined />\n    );\n  }, [position]);\n  const openIcon = useMemo(() => {\n    return position === 'left' ? (\n      <LeftOutlined />\n    ) : position === 'top' ? (\n      <UpOutlined />\n    ) : position === 'bottom' ? (\n      <DownOutlined />\n    ) : (\n      <RightOutlined />\n    );\n  }, [position]);\n\n  // Handle drawer visibility\n  const toggleDrawer = () => {\n    setIsOpen(!isOpen);\n    onOpenChange?.(!isOpen);\n  };\n\n  // Handle resize events\n  const handleResizeStart = useRefFunction((e: React.MouseEvent) => {\n    setIsDragging(true);\n    if (position === 'top' || position === 'bottom') {\n      dragStartPos.current = e.clientY;\n    } else {\n      dragStartPos.current = e.clientX;\n    }\n    dragStartSize.current = size;\n    e.preventDefault();\n  });\n  const handleResize = useRefFunction((e: MouseEvent) => {\n    if (isDragging && dragStartSize.current) {\n      let newSize: number;\n      if (position === 'left') {\n        newSize = dragStartSize.current - (dragStartPos.current - e.clientX);\n      } else if (position === 'top') {\n        newSize = dragStartSize.current - (dragStartPos.current - e.clientY);\n      } else if (position === 'bottom') {\n        newSize = dragStartSize.current - (e.clientY - dragStartPos.current);\n      } else {\n        newSize = dragStartSize.current - (e.clientX - dragStartPos.current);\n      }\n      if (newSize >= minSize && newSize <= maxSize) {\n        setSize(newSize);\n        if (cacheKey) {\n          localStorage.setItem(cacheKey, String(newSize));\n        }\n        onResize?.(newSize);\n      }\n    }\n  });\n  const handleResizeEnd = useRefFunction(() => {\n    setIsDragging(false);\n  });\n\n  // Monitor drawer ref, calculate size if not set\n  // This is useful for initial rendering when size is not provided\n  useEffect(() => {\n    if (drawerRef && size === undefined) {\n      const rect = drawerRef.getBoundingClientRect();\n      setSize(position === 'left' || position === 'right' ? rect.width : rect.height);\n    }\n  }, [drawerRef, position, size]);\n\n  // Controlled open state\n  useEffect(() => {\n    setIsOpen(open);\n  }, [open]);\n\n  // Handle global events\n  useEffect(() => {\n    if (isDragging) {\n      window.addEventListener('mousemove', handleResize);\n      window.addEventListener('mouseup', handleResizeEnd);\n    } else {\n      window.removeEventListener('mousemove', handleResize);\n      window.removeEventListener('mouseup', handleResizeEnd);\n    }\n    return () => {\n      window.removeEventListener('mousemove', handleResize);\n      window.removeEventListener('mouseup', handleResizeEnd);\n    };\n  }, [isDragging]);\n\n  return wrapCSSVar(\n    <div\n      className={classString}\n      style={{\n        // @ts-expect-error: because of dynamic CSS variables\n        '--edge-offset': typeof edgeOffset === 'number' ? `${edgeOffset}px` : edgeOffset,\n        ...style,\n      }}\n      onClick={onClick}\n    >\n      <div\n        ref={setDrawerRef}\n        className={classNames(`${prefixCls}-drawer`, classNamesInProps?.drawer)}\n        style={{ ...sizeMap, ...styles?.drawer }}\n      >\n        {resizable && (\n          <div\n            className={classNames(\n              `${prefixCls}-resize-handle`,\n              isDragging && `${prefixCls}-resize-handle-dragging`,\n              classNamesInProps?.resizeHandle\n            )}\n            style={styles?.resizeHandle}\n            onMouseDown={handleResizeStart}\n          />\n        )}\n        <div className={classNames(`${prefixCls}-content`, classNamesInProps?.content)} style={styles?.content}>\n          <Card\n            bordered={false}\n            variant=\"borderless\"\n            className={classNames(`${prefixCls}-card`, classNamesInProps?.card)}\n            style={styles?.card}\n            {...cardProps}\n          >\n            {children}\n          </Card>\n        </div>\n        {showToggle && (\n          <div\n            className={classNames(`${prefixCls}-toggle`, classNamesInProps?.toggle)}\n            style={styles?.toggle}\n            onClick={toggleDrawer}\n          >\n            <div\n              className={classNames(`${prefixCls}-handle-icon`, classNamesInProps?.handleIcon)}\n              style={styles?.handleIcon}\n            >\n              {isOpen ? openIcon : closeIcon}\n            </div>\n          </div>\n        )}\n      </div>\n    </div>\n  );\n};\n\nexport default FloatDrawer;\n"],"mappings":";;;;;;;;;;;;AACA,SAASA,UAAU,EAAEC,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAExE,SAASC,IAAI,EAAEC,cAAc,QAAQ,MAAM;AAC3C,OAAOC,UAAU,MAAM,YAAY;AACnC,SAASC,YAAY,EAAEC,YAAY,EAAEC,aAAa,EAAEC,UAAU,QAAQ,mBAAmB;AACzF,OAAOC,cAAc;AACrB,OAAOC,QAAQ;AAAgB,SAAAC,GAAA,IAAAC,IAAA;AAAA,SAAAC,IAAA,IAAAC,KAAA;AAiL/B;AACA;AACA;AACA;AACA,IAAMC,WAAiC,GAAG,SAApCA,WAAiCA,CAAIC,KAAK,EAAK;EACnD,IACaC,gBAAgB,GAmBzBD,KAAK,CAnBPE,SAAS;IACTC,IAAI,GAkBFH,KAAK,CAlBPG,IAAI;IAAAC,eAAA,GAkBFJ,KAAK,CAjBPK,QAAQ;IAARA,QAAQ,GAAAD,eAAA,cAAG,OAAO,GAAAA,eAAA;IAClBE,SAAS,GAgBPN,KAAK,CAhBPM,SAAS;IACTC,QAAQ,GAeNP,KAAK,CAfPO,QAAQ;IACRC,SAAS,GAcPR,KAAK,CAdPQ,SAAS;IACGC,iBAAiB,GAa3BT,KAAK,CAbPZ,UAAU;IACVsB,KAAK,GAYHV,KAAK,CAZPU,KAAK;IACLC,MAAM,GAWJX,KAAK,CAXPW,MAAM;IACNC,QAAQ,GAUNZ,KAAK,CAVPY,QAAQ;IACRC,WAAW,GASTb,KAAK,CATPa,WAAW;IAAAC,cAAA,GASTd,KAAK,CARPe,OAAO;IAAPA,OAAO,GAAAD,cAAA,cAAG,CAAC,GAAAA,cAAA;IAAAE,cAAA,GAQThB,KAAK,CAPPiB,OAAO;IAAPA,OAAO,GAAAD,cAAA,cAAG,CAACE,QAAQ,GAAAF,cAAA;IACnBG,UAAU,GAMRnB,KAAK,CANPmB,UAAU;IAAAC,iBAAA,GAMRpB,KAAK,CALPqB,UAAU;IAAVA,UAAU,GAAAD,iBAAA,cAAG,IAAI,GAAAA,iBAAA;IAAAE,gBAAA,GAKftB,KAAK,CAJPuB,SAAS;IAATA,SAAS,GAAAD,gBAAA,cAAG,IAAI,GAAAA,gBAAA;IAChBE,YAAY,GAGVxB,KAAK,CAHPwB,YAAY;IACZC,QAAQ,GAENzB,KAAK,CAFPyB,QAAQ;IACRC,OAAO,GACL1B,KAAK,CADP0B,OAAO;EAET,IAAAC,WAAA,GAAyB9C,UAAU,CAACM,cAAc,CAACyC,aAAa,CAAC;IAAzDC,YAAY,GAAAF,WAAA,CAAZE,YAAY;EACpB,IAAM3B,SAAS,GAAG2B,YAAY,CAAC,mBAAmB,EAAE5B,gBAAgB,CAAC;EACrE,IAAA6B,SAAA,GAAwCpC,QAAQ,CAACQ,SAAS,CAAC;IAAA6B,UAAA,GAAAC,cAAA,CAAAF,SAAA;IAApDG,UAAU,GAAAF,UAAA;IAAEG,MAAM,GAAAH,UAAA;IAAEI,SAAS,GAAAJ,UAAA;EACpC,IAAAK,SAAA,GAAkCnD,QAAQ,CAAwB,IAAI,CAAC;IAAAoD,UAAA,GAAAL,cAAA,CAAAI,SAAA;IAAhEE,SAAS,GAAAD,UAAA;IAAEE,YAAY,GAAAF,UAAA;EAC9B,IAAAG,UAAA,GAAwBvD,QAAQ,CAC9B2B,QAAQ,IAAI6B,YAAY,CAACC,OAAO,CAAC9B,QAAQ,CAAC,GAAG+B,MAAM,CAACF,YAAY,CAACC,OAAO,CAAC9B,QAAQ,CAAC,CAAC,IAAIC,WAAW,GAAGA,WACvG,CAAC;IAAA+B,UAAA,GAAAZ,cAAA,CAAAQ,UAAA;IAFMK,IAAI,GAAAD,UAAA;IAAEE,OAAO,GAAAF,UAAA;EAGpB,IAAMG,OAAO,GAAGhE,OAAO,CAAC,YAAM;IAC5B,IAAMiE,IAAI,GAAG3C,QAAQ,KAAK,MAAM,IAAIA,QAAQ,KAAK,OAAO,GAAG,OAAO,GAAG,QAAQ;IAC7E,OAAA4C,eAAA,KACGD,IAAI,EAAGH,IAAI;EAEhB,CAAC,EAAE,CAACxC,QAAQ,EAAEwC,IAAI,CAAC,CAAC;EACpB,IAAAK,UAAA,GAA4BjE,QAAQ,CAAU,CAAC;IAAAkE,UAAA,GAAAnB,cAAA,CAAAkB,UAAA;IAAxCE,MAAM,GAAAD,UAAA;IAAEE,SAAS,GAAAF,UAAA;EACxB,IAAAG,UAAA,GAAoCrE,QAAQ,CAAC,KAAK,CAAC;IAAAsE,UAAA,GAAAvB,cAAA,CAAAsB,UAAA;IAA5CE,UAAU,GAAAD,UAAA;IAAEE,aAAa,GAAAF,UAAA;EAChC,IAAMG,YAAY,GAAG1E,MAAM,CAAS,CAAC,CAAC;EACtC,IAAM2E,aAAa,GAAG3E,MAAM,CAAS6D,IAAI,CAAC;EAC1C,IAAMe,WAAW,GAAGxE,UAAU,CAC5Bc,SAAS,EACTM,SAAS,EAAAyC,eAAA,CAAAA,eAAA,CAAAA,eAAA,QAAAY,MAAA,CAEH3D,SAAS,YAAUkD,MAAM,MAAAS,MAAA,CACzB3D,SAAS,cAAY,CAACkD,MAAM,MAAAS,MAAA,CAC5B3D,SAAS,OAAA2D,MAAA,CAAIxD,QAAQ,GAAKA,QAAQ,GAExC6B,MAAM,EACNC,SACF,CAAC;EACD,IAAM2B,SAAS,GAAG/E,OAAO,CAAC,YAAM;IAC9B,OAAOsB,QAAQ,KAAK,MAAM,gBACxBT,IAAA,CAACL,aAAa,IAAE,CAAC,GACfc,QAAQ,KAAK,KAAK,gBACpBT,IAAA,CAACP,YAAY,IAAE,CAAC,GACdgB,QAAQ,KAAK,QAAQ,gBACvBT,IAAA,CAACJ,UAAU,IAAE,CAAC,gBAEdI,IAAA,CAACN,YAAY,IAAE,CAChB;EACH,CAAC,EAAE,CAACe,QAAQ,CAAC,CAAC;EACd,IAAM0D,QAAQ,GAAGhF,OAAO,CAAC,YAAM;IAC7B,OAAOsB,QAAQ,KAAK,MAAM,gBACxBT,IAAA,CAACN,YAAY,IAAE,CAAC,GACde,QAAQ,KAAK,KAAK,gBACpBT,IAAA,CAACJ,UAAU,IAAE,CAAC,GACZa,QAAQ,KAAK,QAAQ,gBACvBT,IAAA,CAACP,YAAY,IAAE,CAAC,gBAEhBO,IAAA,CAACL,aAAa,IAAE,CACjB;EACH,CAAC,EAAE,CAACc,QAAQ,CAAC,CAAC;;EAEd;EACA,IAAM2D,YAAY,GAAG,SAAfA,YAAYA,CAAA,EAAS;IACzBX,SAAS,CAAC,CAACD,MAAM,CAAC;IAClB5B,YAAY,aAAZA,YAAY,eAAZA,YAAY,CAAG,CAAC4B,MAAM,CAAC;EACzB,CAAC;;EAED;EACA,IAAMa,iBAAiB,GAAGxE,cAAc,CAAC,UAACyE,CAAmB,EAAK;IAChET,aAAa,CAAC,IAAI,CAAC;IACnB,IAAIpD,QAAQ,KAAK,KAAK,IAAIA,QAAQ,KAAK,QAAQ,EAAE;MAC/CqD,YAAY,CAACS,OAAO,GAAGD,CAAC,CAACE,OAAO;IAClC,CAAC,MAAM;MACLV,YAAY,CAACS,OAAO,GAAGD,CAAC,CAACG,OAAO;IAClC;IACAV,aAAa,CAACQ,OAAO,GAAGtB,IAAI;IAC5BqB,CAAC,CAACI,cAAc,CAAC,CAAC;EACpB,CAAC,CAAC;EACF,IAAMC,YAAY,GAAG9E,cAAc,CAAC,UAACyE,CAAa,EAAK;IACrD,IAAIV,UAAU,IAAIG,aAAa,CAACQ,OAAO,EAAE;MACvC,IAAIK,OAAe;MACnB,IAAInE,QAAQ,KAAK,MAAM,EAAE;QACvBmE,OAAO,GAAGb,aAAa,CAACQ,OAAO,IAAIT,YAAY,CAACS,OAAO,GAAGD,CAAC,CAACG,OAAO,CAAC;MACtE,CAAC,MAAM,IAAIhE,QAAQ,KAAK,KAAK,EAAE;QAC7BmE,OAAO,GAAGb,aAAa,CAACQ,OAAO,IAAIT,YAAY,CAACS,OAAO,GAAGD,CAAC,CAACE,OAAO,CAAC;MACtE,CAAC,MAAM,IAAI/D,QAAQ,KAAK,QAAQ,EAAE;QAChCmE,OAAO,GAAGb,aAAa,CAACQ,OAAO,IAAID,CAAC,CAACE,OAAO,GAAGV,YAAY,CAACS,OAAO,CAAC;MACtE,CAAC,MAAM;QACLK,OAAO,GAAGb,aAAa,CAACQ,OAAO,IAAID,CAAC,CAACG,OAAO,GAAGX,YAAY,CAACS,OAAO,CAAC;MACtE;MACA,IAAIK,OAAO,IAAIzD,OAAO,IAAIyD,OAAO,IAAIvD,OAAO,EAAE;QAC5C6B,OAAO,CAAC0B,OAAO,CAAC;QAChB,IAAI5D,QAAQ,EAAE;UACZ6B,YAAY,CAACgC,OAAO,CAAC7D,QAAQ,EAAE8D,MAAM,CAACF,OAAO,CAAC,CAAC;QACjD;QACA/C,QAAQ,aAARA,QAAQ,eAARA,QAAQ,CAAG+C,OAAO,CAAC;MACrB;IACF;EACF,CAAC,CAAC;EACF,IAAMG,eAAe,GAAGlF,cAAc,CAAC,YAAM;IAC3CgE,aAAa,CAAC,KAAK,CAAC;EACtB,CAAC,CAAC;;EAEF;EACA;EACA3E,SAAS,CAAC,YAAM;IACd,IAAIwD,SAAS,IAAIO,IAAI,KAAK+B,SAAS,EAAE;MACnC,IAAMC,IAAI,GAAGvC,SAAS,CAACwC,qBAAqB,CAAC,CAAC;MAC9ChC,OAAO,CAACzC,QAAQ,KAAK,MAAM,IAAIA,QAAQ,KAAK,OAAO,GAAGwE,IAAI,CAACE,KAAK,GAAGF,IAAI,CAACG,MAAM,CAAC;IACjF;EACF,CAAC,EAAE,CAAC1C,SAAS,EAAEjC,QAAQ,EAAEwC,IAAI,CAAC,CAAC;;EAE/B;EACA/D,SAAS,CAAC,YAAM;IACduE,SAAS,CAAClD,IAAI,CAAC;EACjB,CAAC,EAAE,CAACA,IAAI,CAAC,CAAC;;EAEV;EACArB,SAAS,CAAC,YAAM;IACd,IAAI0E,UAAU,EAAE;MACdyB,MAAM,CAACC,gBAAgB,CAAC,WAAW,EAAEX,YAAY,CAAC;MAClDU,MAAM,CAACC,gBAAgB,CAAC,SAAS,EAAEP,eAAe,CAAC;IACrD,CAAC,MAAM;MACLM,MAAM,CAACE,mBAAmB,CAAC,WAAW,EAAEZ,YAAY,CAAC;MACrDU,MAAM,CAACE,mBAAmB,CAAC,SAAS,EAAER,eAAe,CAAC;IACxD;IACA,OAAO,YAAM;MACXM,MAAM,CAACE,mBAAmB,CAAC,WAAW,EAAEZ,YAAY,CAAC;MACrDU,MAAM,CAACE,mBAAmB,CAAC,SAAS,EAAER,eAAe,CAAC;IACxD,CAAC;EACH,CAAC,EAAE,CAACnB,UAAU,CAAC,CAAC;EAEhB,OAAOvB,UAAU,eACfrC,IAAA;IACEY,SAAS,EAAEoD,WAAY;IACvBlD,KAAK,EAAA0E,aAAA;MACH;MACA,eAAe,EAAE,OAAOjE,UAAU,KAAK,QAAQ,MAAA0C,MAAA,CAAM1C,UAAU,UAAOA;IAAU,GAC7ET,KAAK,CACR;IACFgB,OAAO,EAAEA,OAAQ;IAAAnB,QAAA,eAEjBT,KAAA;MACEuF,GAAG,EAAE9C,YAAa;MAClB/B,SAAS,EAAEpB,UAAU,IAAAyE,MAAA,CAAI3D,SAAS,cAAWO,iBAAiB,aAAjBA,iBAAiB,uBAAjBA,iBAAiB,CAAE6E,MAAM,CAAE;MACxE5E,KAAK,EAAA0E,aAAA,CAAAA,aAAA,KAAOrC,OAAO,GAAKpC,MAAM,aAANA,MAAM,uBAANA,MAAM,CAAE2E,MAAM,CAAG;MAAA/E,QAAA,GAExCgB,SAAS,iBACR3B,IAAA;QACEY,SAAS,EAAEpB,UAAU,IAAAyE,MAAA,CAChB3D,SAAS,qBACZsD,UAAU,OAAAK,MAAA,CAAO3D,SAAS,4BAAyB,EACnDO,iBAAiB,aAAjBA,iBAAiB,uBAAjBA,iBAAiB,CAAE8E,YACrB,CAAE;QACF7E,KAAK,EAAEC,MAAM,aAANA,MAAM,uBAANA,MAAM,CAAE4E,YAAa;QAC5BC,WAAW,EAAEvB;MAAkB,CAChC,CACF,eACDrE,IAAA;QAAKY,SAAS,EAAEpB,UAAU,IAAAyE,MAAA,CAAI3D,SAAS,eAAYO,iBAAiB,aAAjBA,iBAAiB,uBAAjBA,iBAAiB,CAAEgF,OAAO,CAAE;QAAC/E,KAAK,EAAEC,MAAM,aAANA,MAAM,uBAANA,MAAM,CAAE8E,OAAQ;QAAAlF,QAAA,eACrGX,IAAA,CAACV,IAAI,EAAAkG,aAAA,CAAAA,aAAA;UACHM,QAAQ,EAAE,KAAM;UAChBC,OAAO,EAAC,YAAY;UACpBnF,SAAS,EAAEpB,UAAU,IAAAyE,MAAA,CAAI3D,SAAS,YAASO,iBAAiB,aAAjBA,iBAAiB,uBAAjBA,iBAAiB,CAAEmF,IAAI,CAAE;UACpElF,KAAK,EAAEC,MAAM,aAANA,MAAM,uBAANA,MAAM,CAAEiF;QAAK,GAChBtF,SAAS;UAAAC,QAAA,EAEZA;QAAQ,EACL;MAAC,CACJ,CAAC,EACLc,UAAU,iBACTzB,IAAA;QACEY,SAAS,EAAEpB,UAAU,IAAAyE,MAAA,CAAI3D,SAAS,cAAWO,iBAAiB,aAAjBA,iBAAiB,uBAAjBA,iBAAiB,CAAEoF,MAAM,CAAE;QACxEnF,KAAK,EAAEC,MAAM,aAANA,MAAM,uBAANA,MAAM,CAAEkF,MAAO;QACtBnE,OAAO,EAAEsC,YAAa;QAAAzD,QAAA,eAEtBX,IAAA;UACEY,SAAS,EAAEpB,UAAU,IAAAyE,MAAA,CAAI3D,SAAS,mBAAgBO,iBAAiB,aAAjBA,iBAAiB,uBAAjBA,iBAAiB,CAAEqF,UAAU,CAAE;UACjFpF,KAAK,EAAEC,MAAM,aAANA,MAAM,uBAANA,MAAM,CAAEmF,UAAW;UAAAvF,QAAA,EAEzB6C,MAAM,GAAGW,QAAQ,GAAGD;QAAS,CAC3B;MAAC,CACH,CACN;IAAA,CACE;EAAC,CACH,CACP,CAAC;AACH,CAAC;AAED,eAAe/D,WAAW"}
+{"version":3,"names":["useContext","useEffect","useMemo","useRef","useState","Card","ConfigProvider","classNames","DownOutlined","LeftOutlined","RightOutlined","UpOutlined","useRefFunction","useStyle","jsx","_jsx","jsxs","_jsxs","FloatDrawer","props","prefixClsInProps","prefixCls","open","_props$position","position","cardProps","children","className","classNamesInProps","style","styles","cacheKey","defaultSize","_props$minSize","minSize","_props$maxSize","maxSize","Infinity","edgeOffset","_props$showToggle","showToggle","_props$resizable","resizable","_props$destroyOnClose","destroyOnClose","onOpenChange","onResize","onClick","_useContext","ConfigContext","getPrefixCls","_useStyle","_useStyle2","_slicedToArray","wrapCSSVar","hashId","cssVarCls","_useState","_useState2","drawerRef","setDrawerRef","_useState3","localStorage","getItem","Number","_useState4","size","setSize","sizeMap","type","_defineProperty","_useState5","_useState6","isOpen","setIsOpen","_useState7","_useState8","isDragging","setIsDragging","dragStartPos","dragStartSize","classString","concat","closeIcon","openIcon","toggleDrawer","handleResizeStart","e","current","clientY","clientX","preventDefault","handleResize","newSize","setItem","String","handleResizeEnd","undefined","rect","getBoundingClientRect","width","height","window","addEventListener","removeEventListener","_objectSpread","ref","drawer","resizeHandle","onMouseDown","content","bordered","variant","card","toggle","handleIcon"],"sources":["../../../src/components/FloatDrawer/index.tsx"],"sourcesContent":["import type { CSSProperties, FC, ReactNode } from 'react';\nimport { useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { CardProps } from 'antd';\nimport { Card, ConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport { DownOutlined, LeftOutlined, RightOutlined, UpOutlined } from '@ant-design/icons';\nimport useRefFunction from '../../hooks/useRefFunction';\nimport useStyle from './style';\n\nexport interface FloatDrawerProps {\n  prefixCls?: string;\n  /**\n   * - **EN:** Whether the drawer is open\n   * - **CN:** 抽屉是否打开\n   */\n  open?: boolean;\n  /**\n   * - **EN:** Position of the drawer\n   * - **CN:** 抽屉的位置\n   *\n   * @default 'right'\n   */\n  position?: 'left' | 'right' | 'top' | 'bottom';\n  /**\n   * - **EN:** Default size of the drawer. If the drawer is placed on the left or right, this is the\n   *   width, otherwise it is the height. If not set, the drawer will adapt to the content size.\n   * - **CN:** 抽屉的默认宽度。如果抽屉放在左侧或右侧，则为宽度，否则为高度。不设置时，抽屉会根据内容自适应大小。\n   */\n  defaultSize?: number;\n  /**\n   * - **EN:** Minimum size of the drawer\n   * - **CN:** 抽屉的最小宽度\n   *\n   * @default 0\n   */\n  minSize?: number;\n  /**\n   * - **EN:** Maximum size of the drawer\n   * - **CN:** 抽屉的最大宽度\n   *\n   * @default Infinity\n   */\n  maxSize?: number;\n  /**\n   * - **EN:** Offset of the drawer from the edge of the screen, supports all CSS length units,\n   *   default is `0`.\n   *\n   * > The drawer will be hidden outside the parent container's edge, but since the parent container\n   * > may have padding or border, the drawer may not be completely hidden. You can adjust the\n   * > `edgeOffset` to ensure the drawer is completely hidden outside the parent container.\n   *\n   * - **CN:** 抽屉距离屏幕边缘的偏移量，支持所有的CSS长度单位, 默认`0`。\n   *\n   * > 抽屉会隐藏在父容器的外边缘, 但由于父容器可能有padding或border, 导致抽屉不能完全隐藏, 因此可以通过设置 `edgeOffset` 来调整抽屉的偏移量,\n   * > 以确保抽屉完全隐藏在父容器之外。\n   *\n   * @default 0\n   */\n  edgeOffset?: CSSProperties['width'];\n  /**\n   * - **EN:** Whether to show the toggle button, default is `true`.\n   * - **CN:** 是否显示展开/收起按钮，默认`true`。\n   */\n  showToggle?: boolean;\n  /**\n   * - **EN:** Whether the drawer is resizable, default is `true`.\n   * - **CN:** 抽屉是否可调整大小, 默认`true`。\n   */\n  resizable?: boolean;\n  /**\n   * - **EN:** Whether to destroy the drawer content when closed, default is `false`.\n   * - **CN:** 抽屉关闭时是否销毁内容，默认`false`。\n   */\n  destroyOnClose?: boolean;\n  /**\n   * - **EN:** Cache key for storing the drawer size in localStorage. If not set, the size will not be\n   *   cached.\n   * - **CN:** 指定一个localStorage缓存键，用于记忆抽屉宽度。如果不设置，则不使用缓存。\n   */\n  cacheKey?: string;\n  /**\n   * - **EN:** Custom class name for the root element\n   * - **CN:** 根元素的自定义类名\n   */\n  className?: string;\n  /**\n   * - **EN:** Custom class names for specific elements\n   * - **CN:** 特定元素的自定义类名\n   */\n  classNames?: {\n    /**\n     * - **EN:** Class name for the drawer element\n     * - **CN:** 抽屉元素的类名\n     */\n    drawer?: string;\n    /**\n     * - **EN:** Class name for the expand handle\n     * - **CN:** 展开手柄的类名\n     */\n    toggle?: string;\n    /**\n     * - **EN:** Class name for the resize handle\n     * - **CN:** 调整大小手柄的类名\n     */\n    resizeHandle?: string;\n    /**\n     * - **EN:** Class name for the handle icon\n     * - **CN:** 手柄图标的类名\n     */\n    handleIcon?: string;\n    /**\n     * - **EN:** Class name for the content area\n     * - **CN:** 内容区域的类名\n     */\n    content?: string;\n    /**\n     * - **EN:** Class name for the card element\n     * - **CN:** 卡片元素的类名\n     */\n    card?: string;\n  };\n  /**\n   * - **EN:** Custom styles for the root element\n   * - **CN:** 根元素的自定义样式\n   */\n  style?: CSSProperties;\n  /**\n   * - **EN:** Custom styles for specific elements\n   * - **CN:** 特定元素的自定义样式\n   */\n  styles?: {\n    /**\n     * - **EN:** Styles for the drawer element\n     * - **CN:** 抽屉元素的样式\n     */\n    drawer?: CSSProperties;\n    /**\n     * - **EN:** Styles for the expand handle\n     * - **CN:** 展开手柄的样式\n     */\n    toggle?: CSSProperties;\n    /**\n     * - **EN:** Styles for the resize handle\n     * - **CN:** 调整大小手柄的样式\n     */\n    resizeHandle?: CSSProperties;\n    /**\n     * - **EN:** Styles for the handle icon\n     * - **CN:** 手柄图标的样式\n     */\n    handleIcon?: CSSProperties;\n    /**\n     * - **EN:** Styles for the content area\n     * - **CN:** 内容区域的样式\n     */\n    content?: CSSProperties;\n    /**\n     * - **EN:** Styles for the card element\n     * - **CN:** 卡片元素的样式\n     */\n    card?: CSSProperties;\n  };\n  /**\n   * - **EN:** Custom properties for the card element\n   * - **CN:** 卡片元素的自定义属性\n   */\n  cardProps?: Omit<CardProps, 'children'>;\n  /**\n   * - **EN:** Content to be rendered inside the drawer\n   * - **CN:** 抽屉内容\n   */\n  children?: ReactNode;\n  /**\n   * - **EN:** Callback function when the open state changes\n   * - **CN:** 打开状态变化时的回调函数\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * - **EN:** Callback function when the drawer is resized\n   * - **CN:** 抽屉调整大小时的回调函数\n   */\n  onResize?: (size: number) => void;\n  /**\n   * - **EN:** Event handler for click events on the drawer container and its internal elements\n   * - **CN:** 点击抽屉容器及内部元素时的事件\n   */\n  onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;\n}\n\n/**\n * - **EN:** FloatDrawer component for creating a draggable, resizable drawer\n * - **CN:** FloatDrawer组件，用于创建可拖动、可调整大小的抽屉\n */\nconst FloatDrawer: FC<FloatDrawerProps> = (props) => {\n  const {\n    prefixCls: prefixClsInProps,\n    open,\n    position = 'right',\n    cardProps,\n    children,\n    className,\n    classNames: classNamesInProps,\n    style,\n    styles,\n    cacheKey,\n    defaultSize,\n    minSize = 0,\n    maxSize = +Infinity,\n    edgeOffset,\n    showToggle = true,\n    resizable = true,\n    destroyOnClose = false,\n    onOpenChange,\n    onResize,\n    onClick,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('easy-float-drawer', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const [drawerRef, setDrawerRef] = useState<HTMLDivElement | null>(null);\n  const [size, setSize] = useState(\n    cacheKey && localStorage.getItem(cacheKey) ? Number(localStorage.getItem(cacheKey)) || defaultSize : defaultSize\n  );\n  const sizeMap = useMemo(() => {\n    const type = position === 'left' || position === 'right' ? 'width' : 'height';\n    return {\n      [type]: size,\n    };\n  }, [position, size]);\n  const [isOpen, setIsOpen] = useState<boolean>();\n  const [isDragging, setIsDragging] = useState(false);\n  const dragStartPos = useRef<number>(0);\n  const dragStartSize = useRef<number>(size);\n  const classString = classNames(\n    prefixCls,\n    className,\n    {\n      [`${prefixCls}-open`]: isOpen,\n      [`${prefixCls}-closed`]: !isOpen,\n      [`${prefixCls}-${position}`]: position,\n    },\n    hashId,\n    cssVarCls\n  );\n  const closeIcon = useMemo(() => {\n    return position === 'left' ? (\n      <RightOutlined />\n    ) : position === 'top' ? (\n      <DownOutlined />\n    ) : position === 'bottom' ? (\n      <UpOutlined />\n    ) : (\n      <LeftOutlined />\n    );\n  }, [position]);\n  const openIcon = useMemo(() => {\n    return position === 'left' ? (\n      <LeftOutlined />\n    ) : position === 'top' ? (\n      <UpOutlined />\n    ) : position === 'bottom' ? (\n      <DownOutlined />\n    ) : (\n      <RightOutlined />\n    );\n  }, [position]);\n\n  // Handle drawer visibility\n  const toggleDrawer = () => {\n    setIsOpen(!isOpen);\n    onOpenChange?.(!isOpen);\n  };\n\n  // Handle resize events\n  const handleResizeStart = useRefFunction((e: React.MouseEvent) => {\n    setIsDragging(true);\n    if (position === 'top' || position === 'bottom') {\n      dragStartPos.current = e.clientY;\n    } else {\n      dragStartPos.current = e.clientX;\n    }\n    dragStartSize.current = size;\n    e.preventDefault();\n  });\n  const handleResize = useRefFunction((e: MouseEvent) => {\n    if (isDragging && dragStartSize.current) {\n      let newSize: number;\n      if (position === 'left') {\n        newSize = dragStartSize.current - (dragStartPos.current - e.clientX);\n      } else if (position === 'top') {\n        newSize = dragStartSize.current - (dragStartPos.current - e.clientY);\n      } else if (position === 'bottom') {\n        newSize = dragStartSize.current - (e.clientY - dragStartPos.current);\n      } else {\n        newSize = dragStartSize.current - (e.clientX - dragStartPos.current);\n      }\n      if (newSize >= minSize && newSize <= maxSize) {\n        setSize(newSize);\n        if (cacheKey) {\n          localStorage.setItem(cacheKey, String(newSize));\n        }\n        onResize?.(newSize);\n      }\n    }\n  });\n  const handleResizeEnd = useRefFunction(() => {\n    setIsDragging(false);\n  });\n\n  // Monitor drawer ref, calculate size if not set\n  // This is useful for initial rendering when size is not provided\n  useEffect(() => {\n    if (drawerRef && size === undefined) {\n      const rect = drawerRef.getBoundingClientRect();\n      setSize(position === 'left' || position === 'right' ? rect.width : rect.height);\n    }\n  }, [drawerRef, position, size]);\n\n  // Controlled open state\n  useEffect(() => {\n    setIsOpen(open);\n  }, [open]);\n\n  // Handle global events\n  useEffect(() => {\n    if (isDragging) {\n      window.addEventListener('mousemove', handleResize);\n      window.addEventListener('mouseup', handleResizeEnd);\n    } else {\n      window.removeEventListener('mousemove', handleResize);\n      window.removeEventListener('mouseup', handleResizeEnd);\n    }\n    return () => {\n      window.removeEventListener('mousemove', handleResize);\n      window.removeEventListener('mouseup', handleResizeEnd);\n    };\n  }, [isDragging]);\n\n  return wrapCSSVar(\n    <div\n      className={classString}\n      style={{\n        // @ts-expect-error: because of dynamic CSS variables\n        '--edge-offset': typeof edgeOffset === 'number' ? `${edgeOffset}px` : edgeOffset,\n        ...style,\n      }}\n      onClick={onClick}\n    >\n      <div\n        ref={setDrawerRef}\n        className={classNames(`${prefixCls}-drawer`, classNamesInProps?.drawer)}\n        style={{ ...sizeMap, ...styles?.drawer }}\n      >\n        {resizable && (\n          <div\n            className={classNames(\n              `${prefixCls}-resize-handle`,\n              isDragging && `${prefixCls}-resize-handle-dragging`,\n              classNamesInProps?.resizeHandle\n            )}\n            style={styles?.resizeHandle}\n            onMouseDown={handleResizeStart}\n          />\n        )}\n        <div className={classNames(`${prefixCls}-content`, classNamesInProps?.content)} style={styles?.content}>\n          <Card\n            bordered={false}\n            variant=\"borderless\"\n            className={classNames(`${prefixCls}-card`, classNamesInProps?.card)}\n            style={styles?.card}\n            {...cardProps}\n          >\n            {!destroyOnClose || isOpen ? children : null}\n          </Card>\n        </div>\n        {showToggle && (\n          <div\n            className={classNames(`${prefixCls}-toggle`, classNamesInProps?.toggle)}\n            style={styles?.toggle}\n            onClick={toggleDrawer}\n          >\n            <div\n              className={classNames(`${prefixCls}-handle-icon`, classNamesInProps?.handleIcon)}\n              style={styles?.handleIcon}\n            >\n              {isOpen ? openIcon : closeIcon}\n            </div>\n          </div>\n        )}\n      </div>\n    </div>\n  );\n};\n\nexport default FloatDrawer;\n"],"mappings":"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"}

package/es/hooks/useDebounce.d.ts

@@ -1,27 +1,27 @@
 /// <reference types="react" />
 export interface UseDebounceOptions {
     /**
-     * - **EN** Whether to execute at the start of the wait period. Default is `false`.
-     * - **CN** 是否在等待周期开始时执行，默认值为 `false`
+     * - **EN:** Whether to execute at the start of the wait period. Default is `false`.
+     * - **CN:** 是否在等待周期开始时执行，默认值为 `false`
      */
     leading?: boolean;
     /**
-     * - **EN** Regular debounce interval in milliseconds. Default is `0`, meaning no debounce.
-     * - **CN** 常规防抖间隔 (ms)，默认值为 `0`, 表示不进行防抖
+     * - **EN:** Regular debounce interval in milliseconds. Default is `0`, meaning no debounce.
+     * - **CN:** 常规防抖间隔 (ms)，默认值为 `0`, 表示不进行防抖
      */
     wait?: number;
     /**
-     * - **EN** Maximum wait time in milliseconds. Default is `0`, meaning no maximum wait.
-     * - **CN** 最大等待时间 (ms)，默认值为 `0`, 表示不限制最大等待时间
+     * - **EN:** Maximum wait time in milliseconds. Default is `0`, meaning no maximum wait.
+     * - **CN:** 最大等待时间 (ms)，默认值为 `0`, 表示不限制最大等待时间
      */
     maxWait?: number;
 }
 /**
- * - **EN** Debounce Hook with dual trigger mechanisms:
+ * - **EN:** Debounce Hook with dual trigger mechanisms:
  *
  *   1. Traditional debounce: Executes after a specified interval without new calls.
  *   2. Max wait: Forces execution after exceeding a specified maximum wait time.
- * - **CN** 防抖 Hook：具有两种触发机制:
+ * - **CN:** 防抖 Hook：具有两种触发机制:
  *
  *   1. 传统防抖：等待指定时间内无新调用后执行
  *   2. 最大等待：超过指定最大等待时间后强制执行
@@ -33,5 +33,33 @@ export interface UseDebounceOptions {
  *
  * @returns The debounced function | 防抖处理后的函数
  */
-declare function useDebounce<T extends (...args: any[]) => unknown>(fn: T, deps: React.DependencyList, options?: UseDebounceOptions): (...args: Parameters<T>) => void;
+declare function useDebounce<T extends (...args: any[]) => unknown>(fn: T, deps: React.DependencyList, options?: UseDebounceOptions): DebouncedFunc<T>;
+export interface DebouncedFunc<T extends (...args: any[]) => unknown> {
+    /**
+     * - **EN:** The debounced function.
+     * - **CN:** 防抖处理后的函数
+     */
+    (...args: Parameters<T>): ReturnType<T>;
+    /**
+     * - **EN:** Cancel any pending execution of the debounced function.
+     * - **CN:** 取消防抖函数的任何待执行操作
+     */
+    cancel: () => void;
+    /**
+     * - **EN:** Disable the debounce functionality. Once disabled, subsequent calls to the function
+     *   will have no effect until re-enabled.
+     * - **CN:** 禁用此防抖函数，一旦被禁用，再次调用改函数将不会有任何效果，除非重新启用
+     */
+    disable: () => void;
+    /**
+     * - **EN:** Re-enable the debounce functionality after it has been disabled.
+     * - **CN:** 重新启用此防抖函数
+     */
+    enable: () => void;
+    /**
+     * - **EN:** Check if the debounce functionality is currently disabled.
+     * - **CN:** 检查此防抖函数当前是否被禁用
+     */
+    isDisabled(): boolean;
+}
 export default useDebounce;

package/es/hooks/useDebounce.js

@@ -5,12 +5,13 @@ function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symb
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 import { useCallback, useEffect, useRef } from 'react';
+import useRefFunction from "./useRefFunction";
 /**
- * - **EN** Debounce Hook with dual trigger mechanisms:
+ * - **EN:** Debounce Hook with dual trigger mechanisms:
  *
  *   1. Traditional debounce: Executes after a specified interval without new calls.
  *   2. Max wait: Forces execution after exceeding a specified maximum wait time.
- * - **CN** 防抖 Hook：具有两种触发机制:
+ * - **CN:** 防抖 Hook：具有两种触发机制:
  *
  *   1. 传统防抖：等待指定时间内无新调用后执行
  *   2. 最大等待：超过指定最大等待时间后强制执行
@@ -34,6 +35,7 @@ function useDebounce(fn, deps) {
   var fnRef = useRef(fn);
   var lastExecutedTimeRef = useRef(0); // The last execution timestamp
   var lastArgsRef = useRef([]); // The last call arguments
+  var isDisabledRef = useRef(false); // Whether debounce is disabled
 
   // Update the latest function reference
   useEffect(function () {
@@ -58,7 +60,10 @@ function useDebounce(fn, deps) {
   }, []);
 
   // The debounced function
-  return useCallback(function () {
+  var debouncedFunction = useRefFunction(function () {
+    if (isDisabledRef.current) {
+      return;
+    }
     var now = Date.now();
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
@@ -85,8 +90,23 @@ function useDebounce(fn, deps) {
 
     // 3. Set a new debounce timer
     timeoutRef.current = setTimeout(executeFunction, wait);
-  }, // eslint-disable-next-line @tiny-codes/react-hooks/exhaustive-deps
-  [wait, maxWait, executeFunction, leading].concat(_toConsumableArray(deps)));
+  });
+  debouncedFunction.cancel = function () {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+  };
+  debouncedFunction.disable = function () {
+    isDisabledRef.current = true;
+  };
+  debouncedFunction.enable = function () {
+    isDisabledRef.current = false;
+  };
+  debouncedFunction.isDisabled = function () {
+    return isDisabledRef.current;
+  };
+  return debouncedFunction;
 }
 export default useDebounce;
 //# sourceMappingURL=useDebounce.js.map

package/es/hooks/useDebounce.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useEffect","useRef","useDebounce","fn","deps","options","arguments","length","undefined","_options$wait","wait","_options$maxWait","maxWait","_options$leading","leading","timeoutRef","fnRef","lastExecutedTimeRef","lastArgsRef","current","clearTimeout","executeFunction","Date","now","apply","_toConsumableArray","_len","args","Array","_key","setTimeout","concat"],"sources":["../../src/hooks/useDebounce.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\n\nexport interface UseDebounceOptions {\n  /**\n   * - **EN** Whether to execute at the start of the wait period. Default is `false`.\n   * - **CN** 是否在等待周期开始时执行，默认值为 `false`\n   */\n  leading?: boolean;\n  /**\n   * - **EN** Regular debounce interval in milliseconds. Default is `0`, meaning no debounce.\n   * - **CN** 常规防抖间隔 (ms)，默认值为 `0`, 表示不进行防抖\n   */\n  wait?: number;\n  /**\n   * - **EN** Maximum wait time in milliseconds. Default is `0`, meaning no maximum wait.\n   * - **CN** 最大等待时间 (ms)，默认值为 `0`, 表示不限制最大等待时间\n   */\n  maxWait?: number;\n}\n/**\n * - **EN** Debounce Hook with dual trigger mechanisms:\n *\n *   1. Traditional debounce: Executes after a specified interval without new calls.\n *   2. Max wait: Forces execution after exceeding a specified maximum wait time.\n * - **CN** 防抖 Hook：具有两种触发机制:\n *\n *   1. 传统防抖：等待指定时间内无新调用后执行\n *   2. 最大等待：超过指定最大等待时间后强制执行\n *\n * @param fn The function to debounce | 需要防抖的函数\n * @param deps Dependency array, re-creates the debounced function when dependencies change |\n *   依赖项数组，当依赖变化时重新创建防抖函数\n * @param options Configuration options | 配置选项\n *\n * @returns The debounced function | 防抖处理后的函数\n */\nfunction useDebounce<T extends (...args: any[]) => unknown>(\n  fn: T,\n  deps: React.DependencyList,\n  options: UseDebounceOptions = {}\n): (...args: Parameters<T>) => void {\n  const { wait = 0, maxWait = 0, leading = false } = options;\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const fnRef = useRef<T>(fn);\n  const lastExecutedTimeRef = useRef<number>(0); // The last execution timestamp\n  const lastArgsRef = useRef<unknown[]>([]); // The last call arguments\n\n  // Update the latest function reference\n  useEffect(() => {\n    fnRef.current = fn;\n  }, [fn]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n        timeoutRef.current = null;\n      }\n    };\n  }, []);\n\n  // The actual execution function\n  const executeFunction = useCallback(() => {\n    timeoutRef.current = null;\n    lastExecutedTimeRef.current = Date.now();\n    fnRef.current(...lastArgsRef.current);\n  }, []);\n\n  // The debounced function\n  return useCallback(\n    (...args: Parameters<T>) => {\n      const now = Date.now();\n      lastArgsRef.current = args;\n\n      // If leading is true and it's the first call, execute immediately\n      if (leading && timeoutRef.current === null && now - lastExecutedTimeRef.current >= wait) {\n        executeFunction();\n        return;\n      }\n\n      // 1. Clear the existing timer\n      if (timeoutRef.current !== null) {\n        clearTimeout(timeoutRef.current);\n        timeoutRef.current = null;\n      }\n\n      // 2. Check if the maximum wait time has been exceeded, if so, execute immediately\n      if (maxWait > 0 && now - lastExecutedTimeRef.current >= maxWait) {\n        executeFunction();\n        return;\n      }\n\n      // 3. Set a new debounce timer\n      timeoutRef.current = setTimeout(executeFunction, wait);\n    },\n    // eslint-disable-next-line @tiny-codes/react-hooks/exhaustive-deps\n    [wait, maxWait, executeFunction, leading, ...deps]\n  );\n}\n\nexport default useDebounce;\n"],"mappings":"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"}
+{"version":3,"names":["useCallback","useEffect","useRef","useRefFunction","useDebounce","fn","deps","options","arguments","length","undefined","_options$wait","wait","_options$maxWait","maxWait","_options$leading","leading","timeoutRef","fnRef","lastExecutedTimeRef","lastArgsRef","isDisabledRef","current","clearTimeout","executeFunction","Date","now","apply","_toConsumableArray","debouncedFunction","_len","args","Array","_key","setTimeout","cancel","disable","enable","isDisabled"],"sources":["../../src/hooks/useDebounce.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport useRefFunction from './useRefFunction';\n\nexport interface UseDebounceOptions {\n  /**\n   * - **EN:** Whether to execute at the start of the wait period. Default is `false`.\n   * - **CN:** 是否在等待周期开始时执行，默认值为 `false`\n   */\n  leading?: boolean;\n  /**\n   * - **EN:** Regular debounce interval in milliseconds. Default is `0`, meaning no debounce.\n   * - **CN:** 常规防抖间隔 (ms)，默认值为 `0`, 表示不进行防抖\n   */\n  wait?: number;\n  /**\n   * - **EN:** Maximum wait time in milliseconds. Default is `0`, meaning no maximum wait.\n   * - **CN:** 最大等待时间 (ms)，默认值为 `0`, 表示不限制最大等待时间\n   */\n  maxWait?: number;\n}\n/**\n * - **EN:** Debounce Hook with dual trigger mechanisms:\n *\n *   1. Traditional debounce: Executes after a specified interval without new calls.\n *   2. Max wait: Forces execution after exceeding a specified maximum wait time.\n * - **CN:** 防抖 Hook：具有两种触发机制:\n *\n *   1. 传统防抖：等待指定时间内无新调用后执行\n *   2. 最大等待：超过指定最大等待时间后强制执行\n *\n * @param fn The function to debounce | 需要防抖的函数\n * @param deps Dependency array, re-creates the debounced function when dependencies change |\n *   依赖项数组，当依赖变化时重新创建防抖函数\n * @param options Configuration options | 配置选项\n *\n * @returns The debounced function | 防抖处理后的函数\n */\nfunction useDebounce<T extends (...args: any[]) => unknown>(\n  fn: T,\n  deps: React.DependencyList,\n  options: UseDebounceOptions = {}\n): DebouncedFunc<T> {\n  const { wait = 0, maxWait = 0, leading = false } = options;\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const fnRef = useRef<T>(fn);\n  const lastExecutedTimeRef = useRef<number>(0); // The last execution timestamp\n  const lastArgsRef = useRef<unknown[]>([]); // The last call arguments\n  const isDisabledRef = useRef<boolean>(false); // Whether debounce is disabled\n\n  // Update the latest function reference\n  useEffect(() => {\n    fnRef.current = fn;\n  }, [fn]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n        timeoutRef.current = null;\n      }\n    };\n  }, []);\n\n  // The actual execution function\n  const executeFunction = useCallback(() => {\n    timeoutRef.current = null;\n    lastExecutedTimeRef.current = Date.now();\n    fnRef.current(...lastArgsRef.current);\n  }, []);\n\n  // The debounced function\n  const debouncedFunction = useRefFunction((...args: Parameters<T>) => {\n    if (isDisabledRef.current) {\n      return;\n    }\n    const now = Date.now();\n    lastArgsRef.current = args;\n\n    // If leading is true and it's the first call, execute immediately\n    if (leading && timeoutRef.current === null && now - lastExecutedTimeRef.current >= wait) {\n      executeFunction();\n      return;\n    }\n\n    // 1. Clear the existing timer\n    if (timeoutRef.current !== null) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n    }\n\n    // 2. Check if the maximum wait time has been exceeded, if so, execute immediately\n    if (maxWait > 0 && now - lastExecutedTimeRef.current >= maxWait) {\n      executeFunction();\n      return;\n    }\n\n    // 3. Set a new debounce timer\n    timeoutRef.current = setTimeout(executeFunction, wait);\n  }) as DebouncedFunc<T>;\n  debouncedFunction.cancel = () => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n    }\n  };\n  debouncedFunction.disable = () => {\n    isDisabledRef.current = true;\n  };\n  debouncedFunction.enable = () => {\n    isDisabledRef.current = false;\n  };\n  debouncedFunction.isDisabled = () => isDisabledRef.current;\n  return debouncedFunction;\n}\n\nexport interface DebouncedFunc<T extends (...args: any[]) => unknown> {\n  /**\n   * - **EN:** The debounced function.\n   * - **CN:** 防抖处理后的函数\n   */\n  (...args: Parameters<T>): ReturnType<T>;\n  /**\n   * - **EN:** Cancel any pending execution of the debounced function.\n   * - **CN:** 取消防抖函数的任何待执行操作\n   */\n  cancel: () => void;\n  /**\n   * - **EN:** Disable the debounce functionality. Once disabled, subsequent calls to the function\n   *   will have no effect until re-enabled.\n   * - **CN:** 禁用此防抖函数，一旦被禁用，再次调用改函数将不会有任何效果，除非重新启用\n   */\n  disable: () => void;\n  /**\n   * - **EN:** Re-enable the debounce functionality after it has been disabled.\n   * - **CN:** 重新启用此防抖函数\n   */\n  enable: () => void;\n  /**\n   * - **EN:** Check if the debounce functionality is currently disabled.\n   * - **CN:** 检查此防抖函数当前是否被禁用\n   */\n  isDisabled(): boolean;\n}\n\nexport default useDebounce;\n"],"mappings":";;;;;;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACtD,OAAOC,cAAc;AAmBrB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,WAAWA,CAClBC,EAAK,EACLC,IAA0B,EAER;EAAA,IADlBC,OAA2B,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAEhC,IAAAG,aAAA,GAAmDJ,OAAO,CAAlDK,IAAI;IAAJA,IAAI,GAAAD,aAAA,cAAG,CAAC,GAAAA,aAAA;IAAAE,gBAAA,GAAmCN,OAAO,CAAxCO,OAAO;IAAPA,OAAO,GAAAD,gBAAA,cAAG,CAAC,GAAAA,gBAAA;IAAAE,gBAAA,GAAsBR,OAAO,CAA3BS,OAAO;IAAPA,OAAO,GAAAD,gBAAA,cAAG,KAAK,GAAAA,gBAAA;EAC9C,IAAME,UAAU,GAAGf,MAAM,CAAuC,IAAI,CAAC;EACrE,IAAMgB,KAAK,GAAGhB,MAAM,CAAIG,EAAE,CAAC;EAC3B,IAAMc,mBAAmB,GAAGjB,MAAM,CAAS,CAAC,CAAC,CAAC,CAAC;EAC/C,IAAMkB,WAAW,GAAGlB,MAAM,CAAY,EAAE,CAAC,CAAC,CAAC;EAC3C,IAAMmB,aAAa,GAAGnB,MAAM,CAAU,KAAK,CAAC,CAAC,CAAC;;EAE9C;EACAD,SAAS,CAAC,YAAM;IACdiB,KAAK,CAACI,OAAO,GAAGjB,EAAE;EACpB,CAAC,EAAE,CAACA,EAAE,CAAC,CAAC;;EAER;EACAJ,SAAS,CAAC,YAAM;IACd,OAAO,YAAM;MACX,IAAIgB,UAAU,CAACK,OAAO,EAAE;QACtBC,YAAY,CAACN,UAAU,CAACK,OAAO,CAAC;QAChCL,UAAU,CAACK,OAAO,GAAG,IAAI;MAC3B;IACF,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;;EAEN;EACA,IAAME,eAAe,GAAGxB,WAAW,CAAC,YAAM;IACxCiB,UAAU,CAACK,OAAO,GAAG,IAAI;IACzBH,mBAAmB,CAACG,OAAO,GAAGG,IAAI,CAACC,GAAG,CAAC,CAAC;IACxCR,KAAK,CAACI,OAAO,CAAAK,KAAA,CAAbT,KAAK,EAAAU,kBAAA,CAAYR,WAAW,CAACE,OAAO,EAAC;EACvC,CAAC,EAAE,EAAE,CAAC;;EAEN;EACA,IAAMO,iBAAiB,GAAG1B,cAAc,CAAC,YAA4B;IACnE,IAAIkB,aAAa,CAACC,OAAO,EAAE;MACzB;IACF;IACA,IAAMI,GAAG,GAAGD,IAAI,CAACC,GAAG,CAAC,CAAC;IAAC,SAAAI,IAAA,GAAAtB,SAAA,CAAAC,MAAA,EAJoBsB,IAAI,OAAAC,KAAA,CAAAF,IAAA,GAAAG,IAAA,MAAAA,IAAA,GAAAH,IAAA,EAAAG,IAAA;MAAJF,IAAI,CAAAE,IAAA,IAAAzB,SAAA,CAAAyB,IAAA;IAAA;IAK/Cb,WAAW,CAACE,OAAO,GAAGS,IAAI;;IAE1B;IACA,IAAIf,OAAO,IAAIC,UAAU,CAACK,OAAO,KAAK,IAAI,IAAII,GAAG,GAAGP,mBAAmB,CAACG,OAAO,IAAIV,IAAI,EAAE;MACvFY,eAAe,CAAC,CAAC;MACjB;IACF;;IAEA;IACA,IAAIP,UAAU,CAACK,OAAO,KAAK,IAAI,EAAE;MAC/BC,YAAY,CAACN,UAAU,CAACK,OAAO,CAAC;MAChCL,UAAU,CAACK,OAAO,GAAG,IAAI;IAC3B;;IAEA;IACA,IAAIR,OAAO,GAAG,CAAC,IAAIY,GAAG,GAAGP,mBAAmB,CAACG,OAAO,IAAIR,OAAO,EAAE;MAC/DU,eAAe,CAAC,CAAC;MACjB;IACF;;IAEA;IACAP,UAAU,CAACK,OAAO,GAAGY,UAAU,CAACV,eAAe,EAAEZ,IAAI,CAAC;EACxD,CAAC,CAAqB;EACtBiB,iBAAiB,CAACM,MAAM,GAAG,YAAM;IAC/B,IAAIlB,UAAU,CAACK,OAAO,EAAE;MACtBC,YAAY,CAACN,UAAU,CAACK,OAAO,CAAC;MAChCL,UAAU,CAACK,OAAO,GAAG,IAAI;IAC3B;EACF,CAAC;EACDO,iBAAiB,CAACO,OAAO,GAAG,YAAM;IAChCf,aAAa,CAACC,OAAO,GAAG,IAAI;EAC9B,CAAC;EACDO,iBAAiB,CAACQ,MAAM,GAAG,YAAM;IAC/BhB,aAAa,CAACC,OAAO,GAAG,KAAK;EAC/B,CAAC;EACDO,iBAAiB,CAACS,UAAU,GAAG;IAAA,OAAMjB,aAAa,CAACC,OAAO;EAAA;EAC1D,OAAOO,iBAAiB;AAC1B;AA+BA,eAAezB,WAAW"}

package/lib/components/FloatDrawer/index.d.ts

@@ -60,6 +60,11 @@ export interface FloatDrawerProps {
      * - **CN:** 抽屉是否可调整大小, 默认`true`。
      */
     resizable?: boolean;
+    /**
+     * - **EN:** Whether to destroy the drawer content when closed, default is `false`.
+     * - **CN:** 抽屉关闭时是否销毁内容，默认`false`。
+     */
+    destroyOnClose?: boolean;
     /**
      * - **EN:** Cache key for storing the drawer size in localStorage. If not set, the size will not be
      *   cached.

package/lib/components/FloatDrawer/index.js

@@ -56,6 +56,7 @@ var FloatDrawer = (props) => {
     edgeOffset,
     showToggle = true,
     resizable = true,
+    destroyOnClose = false,
     onOpenChange,
     onResize,
     onClick
@@ -194,7 +195,7 @@ var FloatDrawer = (props) => {
             style: styles == null ? void 0 : styles.card,
             ...cardProps
           },
-          children
+          !destroyOnClose || isOpen ? children : null
         )),
         showToggle && /* @__PURE__ */ React.createElement(
           "div",

package/lib/components/FloatDrawer/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/components/FloatDrawer/index.tsx"],
-  "sourcesContent": ["import type { CSSProperties, FC, ReactNode } from 'react';\nimport { useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { CardProps } from 'antd';\nimport { Card, ConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport { DownOutlined, LeftOutlined, RightOutlined, UpOutlined } from '@ant-design/icons';\nimport useRefFunction from '../../hooks/useRefFunction';\nimport useStyle from './style';\n\nexport interface FloatDrawerProps {\n  prefixCls?: string;\n  /**\n   * - **EN:** Whether the drawer is open\n   * - **CN:** 抽屉是否打开\n   */\n  open?: boolean;\n  /**\n   * - **EN:** Position of the drawer\n   * - **CN:** 抽屉的位置\n   *\n   * @default 'right'\n   */\n  position?: 'left' | 'right' | 'top' | 'bottom';\n  /**\n   * - **EN:** Default size of the drawer. If the drawer is placed on the left or right, this is the\n   *   width, otherwise it is the height. If not set, the drawer will adapt to the content size.\n   * - **CN:** 抽屉的默认宽度。如果抽屉放在左侧或右侧，则为宽度，否则为高度。不设置时，抽屉会根据内容自适应大小。\n   */\n  defaultSize?: number;\n  /**\n   * - **EN:** Minimum size of the drawer\n   * - **CN:** 抽屉的最小宽度\n   *\n   * @default 0\n   */\n  minSize?: number;\n  /**\n   * - **EN:** Maximum size of the drawer\n   * - **CN:** 抽屉的最大宽度\n   *\n   * @default Infinity\n   */\n  maxSize?: number;\n  /**\n   * - **EN:** Offset of the drawer from the edge of the screen, supports all CSS length units,\n   *   default is `0`.\n   *\n   * > The drawer will be hidden outside the parent container's edge, but since the parent container\n   * > may have padding or border, the drawer may not be completely hidden. You can adjust the\n   * > `edgeOffset` to ensure the drawer is completely hidden outside the parent container.\n   *\n   * - **CN:** 抽屉距离屏幕边缘的偏移量，支持所有的CSS长度单位, 默认`0`。\n   *\n   * > 抽屉会隐藏在父容器的外边缘, 但由于父容器可能有padding或border, 导致抽屉不能完全隐藏, 因此可以通过设置 `edgeOffset` 来调整抽屉的偏移量,\n   * > 以确保抽屉完全隐藏在父容器之外。\n   *\n   * @default 0\n   */\n  edgeOffset?: CSSProperties['width'];\n  /**\n   * - **EN:** Whether to show the toggle button, default is `true`.\n   * - **CN:** 是否显示展开/收起按钮，默认`true`。\n   */\n  showToggle?: boolean;\n  /**\n   * - **EN:** Whether the drawer is resizable, default is `true`.\n   * - **CN:** 抽屉是否可调整大小, 默认`true`。\n   */\n  resizable?: boolean;\n  /**\n   * - **EN:** Cache key for storing the drawer size in localStorage. If not set, the size will not be\n   *   cached.\n   * - **CN:** 指定一个localStorage缓存键，用于记忆抽屉宽度。如果不设置，则不使用缓存。\n   */\n  cacheKey?: string;\n  /**\n   * - **EN:** Custom class name for the root element\n   * - **CN:** 根元素的自定义类名\n   */\n  className?: string;\n  /**\n   * - **EN:** Custom class names for specific elements\n   * - **CN:** 特定元素的自定义类名\n   */\n  classNames?: {\n    /**\n     * - **EN:** Class name for the drawer element\n     * - **CN:** 抽屉元素的类名\n     */\n    drawer?: string;\n    /**\n     * - **EN:** Class name for the expand handle\n     * - **CN:** 展开手柄的类名\n     */\n    toggle?: string;\n    /**\n     * - **EN:** Class name for the resize handle\n     * - **CN:** 调整大小手柄的类名\n     */\n    resizeHandle?: string;\n    /**\n     * - **EN:** Class name for the handle icon\n     * - **CN:** 手柄图标的类名\n     */\n    handleIcon?: string;\n    /**\n     * - **EN:** Class name for the content area\n     * - **CN:** 内容区域的类名\n     */\n    content?: string;\n    /**\n     * - **EN:** Class name for the card element\n     * - **CN:** 卡片元素的类名\n     */\n    card?: string;\n  };\n  /**\n   * - **EN:** Custom styles for the root element\n   * - **CN:** 根元素的自定义样式\n   */\n  style?: CSSProperties;\n  /**\n   * - **EN:** Custom styles for specific elements\n   * - **CN:** 特定元素的自定义样式\n   */\n  styles?: {\n    /**\n     * - **EN:** Styles for the drawer element\n     * - **CN:** 抽屉元素的样式\n     */\n    drawer?: CSSProperties;\n    /**\n     * - **EN:** Styles for the expand handle\n     * - **CN:** 展开手柄的样式\n     */\n    toggle?: CSSProperties;\n    /**\n     * - **EN:** Styles for the resize handle\n     * - **CN:** 调整大小手柄的样式\n     */\n    resizeHandle?: CSSProperties;\n    /**\n     * - **EN:** Styles for the handle icon\n     * - **CN:** 手柄图标的样式\n     */\n    handleIcon?: CSSProperties;\n    /**\n     * - **EN:** Styles for the content area\n     * - **CN:** 内容区域的样式\n     */\n    content?: CSSProperties;\n    /**\n     * - **EN:** Styles for the card element\n     * - **CN:** 卡片元素的样式\n     */\n    card?: CSSProperties;\n  };\n  /**\n   * - **EN:** Custom properties for the card element\n   * - **CN:** 卡片元素的自定义属性\n   */\n  cardProps?: Omit<CardProps, 'children'>;\n  /**\n   * - **EN:** Content to be rendered inside the drawer\n   * - **CN:** 抽屉内容\n   */\n  children?: ReactNode;\n  /**\n   * - **EN:** Callback function when the open state changes\n   * - **CN:** 打开状态变化时的回调函数\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * - **EN:** Callback function when the drawer is resized\n   * - **CN:** 抽屉调整大小时的回调函数\n   */\n  onResize?: (size: number) => void;\n  /**\n   * - **EN:** Event handler for click events on the drawer container and its internal elements\n   * - **CN:** 点击抽屉容器及内部元素时的事件\n   */\n  onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;\n}\n\n/**\n * - **EN:** FloatDrawer component for creating a draggable, resizable drawer\n * - **CN:** FloatDrawer组件，用于创建可拖动、可调整大小的抽屉\n */\nconst FloatDrawer: FC<FloatDrawerProps> = (props) => {\n  const {\n    prefixCls: prefixClsInProps,\n    open,\n    position = 'right',\n    cardProps,\n    children,\n    className,\n    classNames: classNamesInProps,\n    style,\n    styles,\n    cacheKey,\n    defaultSize,\n    minSize = 0,\n    maxSize = +Infinity,\n    edgeOffset,\n    showToggle = true,\n    resizable = true,\n    onOpenChange,\n    onResize,\n    onClick,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('easy-float-drawer', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const [drawerRef, setDrawerRef] = useState<HTMLDivElement | null>(null);\n  const [size, setSize] = useState(\n    cacheKey && localStorage.getItem(cacheKey) ? Number(localStorage.getItem(cacheKey)) || defaultSize : defaultSize\n  );\n  const sizeMap = useMemo(() => {\n    const type = position === 'left' || position === 'right' ? 'width' : 'height';\n    return {\n      [type]: size,\n    };\n  }, [position, size]);\n  const [isOpen, setIsOpen] = useState<boolean>();\n  const [isDragging, setIsDragging] = useState(false);\n  const dragStartPos = useRef<number>(0);\n  const dragStartSize = useRef<number>(size);\n  const classString = classNames(\n    prefixCls,\n    className,\n    {\n      [`${prefixCls}-open`]: isOpen,\n      [`${prefixCls}-closed`]: !isOpen,\n      [`${prefixCls}-${position}`]: position,\n    },\n    hashId,\n    cssVarCls\n  );\n  const closeIcon = useMemo(() => {\n    return position === 'left' ? (\n      <RightOutlined />\n    ) : position === 'top' ? (\n      <DownOutlined />\n    ) : position === 'bottom' ? (\n      <UpOutlined />\n    ) : (\n      <LeftOutlined />\n    );\n  }, [position]);\n  const openIcon = useMemo(() => {\n    return position === 'left' ? (\n      <LeftOutlined />\n    ) : position === 'top' ? (\n      <UpOutlined />\n    ) : position === 'bottom' ? (\n      <DownOutlined />\n    ) : (\n      <RightOutlined />\n    );\n  }, [position]);\n\n  // Handle drawer visibility\n  const toggleDrawer = () => {\n    setIsOpen(!isOpen);\n    onOpenChange?.(!isOpen);\n  };\n\n  // Handle resize events\n  const handleResizeStart = useRefFunction((e: React.MouseEvent) => {\n    setIsDragging(true);\n    if (position === 'top' || position === 'bottom') {\n      dragStartPos.current = e.clientY;\n    } else {\n      dragStartPos.current = e.clientX;\n    }\n    dragStartSize.current = size;\n    e.preventDefault();\n  });\n  const handleResize = useRefFunction((e: MouseEvent) => {\n    if (isDragging && dragStartSize.current) {\n      let newSize: number;\n      if (position === 'left') {\n        newSize = dragStartSize.current - (dragStartPos.current - e.clientX);\n      } else if (position === 'top') {\n        newSize = dragStartSize.current - (dragStartPos.current - e.clientY);\n      } else if (position === 'bottom') {\n        newSize = dragStartSize.current - (e.clientY - dragStartPos.current);\n      } else {\n        newSize = dragStartSize.current - (e.clientX - dragStartPos.current);\n      }\n      if (newSize >= minSize && newSize <= maxSize) {\n        setSize(newSize);\n        if (cacheKey) {\n          localStorage.setItem(cacheKey, String(newSize));\n        }\n        onResize?.(newSize);\n      }\n    }\n  });\n  const handleResizeEnd = useRefFunction(() => {\n    setIsDragging(false);\n  });\n\n  // Monitor drawer ref, calculate size if not set\n  // This is useful for initial rendering when size is not provided\n  useEffect(() => {\n    if (drawerRef && size === undefined) {\n      const rect = drawerRef.getBoundingClientRect();\n      setSize(position === 'left' || position === 'right' ? rect.width : rect.height);\n    }\n  }, [drawerRef, position, size]);\n\n  // Controlled open state\n  useEffect(() => {\n    setIsOpen(open);\n  }, [open]);\n\n  // Handle global events\n  useEffect(() => {\n    if (isDragging) {\n      window.addEventListener('mousemove', handleResize);\n      window.addEventListener('mouseup', handleResizeEnd);\n    } else {\n      window.removeEventListener('mousemove', handleResize);\n      window.removeEventListener('mouseup', handleResizeEnd);\n    }\n    return () => {\n      window.removeEventListener('mousemove', handleResize);\n      window.removeEventListener('mouseup', handleResizeEnd);\n    };\n  }, [isDragging]);\n\n  return wrapCSSVar(\n    <div\n      className={classString}\n      style={{\n        // @ts-expect-error: because of dynamic CSS variables\n        '--edge-offset': typeof edgeOffset === 'number' ? `${edgeOffset}px` : edgeOffset,\n        ...style,\n      }}\n      onClick={onClick}\n    >\n      <div\n        ref={setDrawerRef}\n        className={classNames(`${prefixCls}-drawer`, classNamesInProps?.drawer)}\n        style={{ ...sizeMap, ...styles?.drawer }}\n      >\n        {resizable && (\n          <div\n            className={classNames(\n              `${prefixCls}-resize-handle`,\n              isDragging && `${prefixCls}-resize-handle-dragging`,\n              classNamesInProps?.resizeHandle\n            )}\n            style={styles?.resizeHandle}\n            onMouseDown={handleResizeStart}\n          />\n        )}\n        <div className={classNames(`${prefixCls}-content`, classNamesInProps?.content)} style={styles?.content}>\n          <Card\n            bordered={false}\n            variant=\"borderless\"\n            className={classNames(`${prefixCls}-card`, classNamesInProps?.card)}\n            style={styles?.card}\n            {...cardProps}\n          >\n            {children}\n          </Card>\n        </div>\n        {showToggle && (\n          <div\n            className={classNames(`${prefixCls}-toggle`, classNamesInProps?.toggle)}\n            style={styles?.toggle}\n            onClick={toggleDrawer}\n          >\n            <div\n              className={classNames(`${prefixCls}-handle-icon`, classNamesInProps?.handleIcon)}\n              style={styles?.handleIcon}\n            >\n              {isOpen ? openIcon : closeIcon}\n            </div>\n          </div>\n        )}\n      </div>\n    </div>\n  );\n};\n\nexport default FloatDrawer;\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { CSSProperties, FC, ReactNode } from 'react';\nimport { useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { CardProps } from 'antd';\nimport { Card, ConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport { DownOutlined, LeftOutlined, RightOutlined, UpOutlined } from '@ant-design/icons';\nimport useRefFunction from '../../hooks/useRefFunction';\nimport useStyle from './style';\n\nexport interface FloatDrawerProps {\n  prefixCls?: string;\n  /**\n   * - **EN:** Whether the drawer is open\n   * - **CN:** 抽屉是否打开\n   */\n  open?: boolean;\n  /**\n   * - **EN:** Position of the drawer\n   * - **CN:** 抽屉的位置\n   *\n   * @default 'right'\n   */\n  position?: 'left' | 'right' | 'top' | 'bottom';\n  /**\n   * - **EN:** Default size of the drawer. If the drawer is placed on the left or right, this is the\n   *   width, otherwise it is the height. If not set, the drawer will adapt to the content size.\n   * - **CN:** 抽屉的默认宽度。如果抽屉放在左侧或右侧，则为宽度，否则为高度。不设置时，抽屉会根据内容自适应大小。\n   */\n  defaultSize?: number;\n  /**\n   * - **EN:** Minimum size of the drawer\n   * - **CN:** 抽屉的最小宽度\n   *\n   * @default 0\n   */\n  minSize?: number;\n  /**\n   * - **EN:** Maximum size of the drawer\n   * - **CN:** 抽屉的最大宽度\n   *\n   * @default Infinity\n   */\n  maxSize?: number;\n  /**\n   * - **EN:** Offset of the drawer from the edge of the screen, supports all CSS length units,\n   *   default is `0`.\n   *\n   * > The drawer will be hidden outside the parent container's edge, but since the parent container\n   * > may have padding or border, the drawer may not be completely hidden. You can adjust the\n   * > `edgeOffset` to ensure the drawer is completely hidden outside the parent container.\n   *\n   * - **CN:** 抽屉距离屏幕边缘的偏移量，支持所有的CSS长度单位, 默认`0`。\n   *\n   * > 抽屉会隐藏在父容器的外边缘, 但由于父容器可能有padding或border, 导致抽屉不能完全隐藏, 因此可以通过设置 `edgeOffset` 来调整抽屉的偏移量,\n   * > 以确保抽屉完全隐藏在父容器之外。\n   *\n   * @default 0\n   */\n  edgeOffset?: CSSProperties['width'];\n  /**\n   * - **EN:** Whether to show the toggle button, default is `true`.\n   * - **CN:** 是否显示展开/收起按钮，默认`true`。\n   */\n  showToggle?: boolean;\n  /**\n   * - **EN:** Whether the drawer is resizable, default is `true`.\n   * - **CN:** 抽屉是否可调整大小, 默认`true`。\n   */\n  resizable?: boolean;\n  /**\n   * - **EN:** Whether to destroy the drawer content when closed, default is `false`.\n   * - **CN:** 抽屉关闭时是否销毁内容，默认`false`。\n   */\n  destroyOnClose?: boolean;\n  /**\n   * - **EN:** Cache key for storing the drawer size in localStorage. If not set, the size will not be\n   *   cached.\n   * - **CN:** 指定一个localStorage缓存键，用于记忆抽屉宽度。如果不设置，则不使用缓存。\n   */\n  cacheKey?: string;\n  /**\n   * - **EN:** Custom class name for the root element\n   * - **CN:** 根元素的自定义类名\n   */\n  className?: string;\n  /**\n   * - **EN:** Custom class names for specific elements\n   * - **CN:** 特定元素的自定义类名\n   */\n  classNames?: {\n    /**\n     * - **EN:** Class name for the drawer element\n     * - **CN:** 抽屉元素的类名\n     */\n    drawer?: string;\n    /**\n     * - **EN:** Class name for the expand handle\n     * - **CN:** 展开手柄的类名\n     */\n    toggle?: string;\n    /**\n     * - **EN:** Class name for the resize handle\n     * - **CN:** 调整大小手柄的类名\n     */\n    resizeHandle?: string;\n    /**\n     * - **EN:** Class name for the handle icon\n     * - **CN:** 手柄图标的类名\n     */\n    handleIcon?: string;\n    /**\n     * - **EN:** Class name for the content area\n     * - **CN:** 内容区域的类名\n     */\n    content?: string;\n    /**\n     * - **EN:** Class name for the card element\n     * - **CN:** 卡片元素的类名\n     */\n    card?: string;\n  };\n  /**\n   * - **EN:** Custom styles for the root element\n   * - **CN:** 根元素的自定义样式\n   */\n  style?: CSSProperties;\n  /**\n   * - **EN:** Custom styles for specific elements\n   * - **CN:** 特定元素的自定义样式\n   */\n  styles?: {\n    /**\n     * - **EN:** Styles for the drawer element\n     * - **CN:** 抽屉元素的样式\n     */\n    drawer?: CSSProperties;\n    /**\n     * - **EN:** Styles for the expand handle\n     * - **CN:** 展开手柄的样式\n     */\n    toggle?: CSSProperties;\n    /**\n     * - **EN:** Styles for the resize handle\n     * - **CN:** 调整大小手柄的样式\n     */\n    resizeHandle?: CSSProperties;\n    /**\n     * - **EN:** Styles for the handle icon\n     * - **CN:** 手柄图标的样式\n     */\n    handleIcon?: CSSProperties;\n    /**\n     * - **EN:** Styles for the content area\n     * - **CN:** 内容区域的样式\n     */\n    content?: CSSProperties;\n    /**\n     * - **EN:** Styles for the card element\n     * - **CN:** 卡片元素的样式\n     */\n    card?: CSSProperties;\n  };\n  /**\n   * - **EN:** Custom properties for the card element\n   * - **CN:** 卡片元素的自定义属性\n   */\n  cardProps?: Omit<CardProps, 'children'>;\n  /**\n   * - **EN:** Content to be rendered inside the drawer\n   * - **CN:** 抽屉内容\n   */\n  children?: ReactNode;\n  /**\n   * - **EN:** Callback function when the open state changes\n   * - **CN:** 打开状态变化时的回调函数\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * - **EN:** Callback function when the drawer is resized\n   * - **CN:** 抽屉调整大小时的回调函数\n   */\n  onResize?: (size: number) => void;\n  /**\n   * - **EN:** Event handler for click events on the drawer container and its internal elements\n   * - **CN:** 点击抽屉容器及内部元素时的事件\n   */\n  onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;\n}\n\n/**\n * - **EN:** FloatDrawer component for creating a draggable, resizable drawer\n * - **CN:** FloatDrawer组件，用于创建可拖动、可调整大小的抽屉\n */\nconst FloatDrawer: FC<FloatDrawerProps> = (props) => {\n  const {\n    prefixCls: prefixClsInProps,\n    open,\n    position = 'right',\n    cardProps,\n    children,\n    className,\n    classNames: classNamesInProps,\n    style,\n    styles,\n    cacheKey,\n    defaultSize,\n    minSize = 0,\n    maxSize = +Infinity,\n    edgeOffset,\n    showToggle = true,\n    resizable = true,\n    destroyOnClose = false,\n    onOpenChange,\n    onResize,\n    onClick,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('easy-float-drawer', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const [drawerRef, setDrawerRef] = useState<HTMLDivElement | null>(null);\n  const [size, setSize] = useState(\n    cacheKey && localStorage.getItem(cacheKey) ? Number(localStorage.getItem(cacheKey)) || defaultSize : defaultSize\n  );\n  const sizeMap = useMemo(() => {\n    const type = position === 'left' || position === 'right' ? 'width' : 'height';\n    return {\n      [type]: size,\n    };\n  }, [position, size]);\n  const [isOpen, setIsOpen] = useState<boolean>();\n  const [isDragging, setIsDragging] = useState(false);\n  const dragStartPos = useRef<number>(0);\n  const dragStartSize = useRef<number>(size);\n  const classString = classNames(\n    prefixCls,\n    className,\n    {\n      [`${prefixCls}-open`]: isOpen,\n      [`${prefixCls}-closed`]: !isOpen,\n      [`${prefixCls}-${position}`]: position,\n    },\n    hashId,\n    cssVarCls\n  );\n  const closeIcon = useMemo(() => {\n    return position === 'left' ? (\n      <RightOutlined />\n    ) : position === 'top' ? (\n      <DownOutlined />\n    ) : position === 'bottom' ? (\n      <UpOutlined />\n    ) : (\n      <LeftOutlined />\n    );\n  }, [position]);\n  const openIcon = useMemo(() => {\n    return position === 'left' ? (\n      <LeftOutlined />\n    ) : position === 'top' ? (\n      <UpOutlined />\n    ) : position === 'bottom' ? (\n      <DownOutlined />\n    ) : (\n      <RightOutlined />\n    );\n  }, [position]);\n\n  // Handle drawer visibility\n  const toggleDrawer = () => {\n    setIsOpen(!isOpen);\n    onOpenChange?.(!isOpen);\n  };\n\n  // Handle resize events\n  const handleResizeStart = useRefFunction((e: React.MouseEvent) => {\n    setIsDragging(true);\n    if (position === 'top' || position === 'bottom') {\n      dragStartPos.current = e.clientY;\n    } else {\n      dragStartPos.current = e.clientX;\n    }\n    dragStartSize.current = size;\n    e.preventDefault();\n  });\n  const handleResize = useRefFunction((e: MouseEvent) => {\n    if (isDragging && dragStartSize.current) {\n      let newSize: number;\n      if (position === 'left') {\n        newSize = dragStartSize.current - (dragStartPos.current - e.clientX);\n      } else if (position === 'top') {\n        newSize = dragStartSize.current - (dragStartPos.current - e.clientY);\n      } else if (position === 'bottom') {\n        newSize = dragStartSize.current - (e.clientY - dragStartPos.current);\n      } else {\n        newSize = dragStartSize.current - (e.clientX - dragStartPos.current);\n      }\n      if (newSize >= minSize && newSize <= maxSize) {\n        setSize(newSize);\n        if (cacheKey) {\n          localStorage.setItem(cacheKey, String(newSize));\n        }\n        onResize?.(newSize);\n      }\n    }\n  });\n  const handleResizeEnd = useRefFunction(() => {\n    setIsDragging(false);\n  });\n\n  // Monitor drawer ref, calculate size if not set\n  // This is useful for initial rendering when size is not provided\n  useEffect(() => {\n    if (drawerRef && size === undefined) {\n      const rect = drawerRef.getBoundingClientRect();\n      setSize(position === 'left' || position === 'right' ? rect.width : rect.height);\n    }\n  }, [drawerRef, position, size]);\n\n  // Controlled open state\n  useEffect(() => {\n    setIsOpen(open);\n  }, [open]);\n\n  // Handle global events\n  useEffect(() => {\n    if (isDragging) {\n      window.addEventListener('mousemove', handleResize);\n      window.addEventListener('mouseup', handleResizeEnd);\n    } else {\n      window.removeEventListener('mousemove', handleResize);\n      window.removeEventListener('mouseup', handleResizeEnd);\n    }\n    return () => {\n      window.removeEventListener('mousemove', handleResize);\n      window.removeEventListener('mouseup', handleResizeEnd);\n    };\n  }, [isDragging]);\n\n  return wrapCSSVar(\n    <div\n      className={classString}\n      style={{\n        // @ts-expect-error: because of dynamic CSS variables\n        '--edge-offset': typeof edgeOffset === 'number' ? `${edgeOffset}px` : edgeOffset,\n        ...style,\n      }}\n      onClick={onClick}\n    >\n      <div\n        ref={setDrawerRef}\n        className={classNames(`${prefixCls}-drawer`, classNamesInProps?.drawer)}\n        style={{ ...sizeMap, ...styles?.drawer }}\n      >\n        {resizable && (\n          <div\n            className={classNames(\n              `${prefixCls}-resize-handle`,\n              isDragging && `${prefixCls}-resize-handle-dragging`,\n              classNamesInProps?.resizeHandle\n            )}\n            style={styles?.resizeHandle}\n            onMouseDown={handleResizeStart}\n          />\n        )}\n        <div className={classNames(`${prefixCls}-content`, classNamesInProps?.content)} style={styles?.content}>\n          <Card\n            bordered={false}\n            variant=\"borderless\"\n            className={classNames(`${prefixCls}-card`, classNamesInProps?.card)}\n            style={styles?.card}\n            {...cardProps}\n          >\n            {!destroyOnClose || isOpen ? children : null}\n          </Card>\n        </div>\n        {showToggle && (\n          <div\n            className={classNames(`${prefixCls}-toggle`, classNamesInProps?.toggle)}\n            style={styles?.toggle}\n            onClick={toggleDrawer}\n          >\n            <div\n              className={classNames(`${prefixCls}-handle-icon`, classNamesInProps?.handleIcon)}\n              style={styles?.handleIcon}\n            >\n              {isOpen ? openIcon : closeIcon}\n            </div>\n          </div>\n        )}\n      </div>\n    </div>\n  );\n};\n\nexport default FloatDrawer;\n"],
+  "mappings": "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",
   "names": ["useStyle", "classNames", "useRefFunction"]
 }

package/lib/hooks/useDebounce.d.ts

@@ -1,27 +1,27 @@
 /// <reference types="react" />
 export interface UseDebounceOptions {
     /**
-     * - **EN** Whether to execute at the start of the wait period. Default is `false`.
-     * - **CN** 是否在等待周期开始时执行，默认值为 `false`
+     * - **EN:** Whether to execute at the start of the wait period. Default is `false`.
+     * - **CN:** 是否在等待周期开始时执行，默认值为 `false`
      */
     leading?: boolean;
     /**
-     * - **EN** Regular debounce interval in milliseconds. Default is `0`, meaning no debounce.
-     * - **CN** 常规防抖间隔 (ms)，默认值为 `0`, 表示不进行防抖
+     * - **EN:** Regular debounce interval in milliseconds. Default is `0`, meaning no debounce.
+     * - **CN:** 常规防抖间隔 (ms)，默认值为 `0`, 表示不进行防抖
      */
     wait?: number;
     /**
-     * - **EN** Maximum wait time in milliseconds. Default is `0`, meaning no maximum wait.
-     * - **CN** 最大等待时间 (ms)，默认值为 `0`, 表示不限制最大等待时间
+     * - **EN:** Maximum wait time in milliseconds. Default is `0`, meaning no maximum wait.
+     * - **CN:** 最大等待时间 (ms)，默认值为 `0`, 表示不限制最大等待时间
      */
     maxWait?: number;
 }
 /**
- * - **EN** Debounce Hook with dual trigger mechanisms:
+ * - **EN:** Debounce Hook with dual trigger mechanisms:
  *
  *   1. Traditional debounce: Executes after a specified interval without new calls.
  *   2. Max wait: Forces execution after exceeding a specified maximum wait time.
- * - **CN** 防抖 Hook：具有两种触发机制:
+ * - **CN:** 防抖 Hook：具有两种触发机制:
  *
  *   1. 传统防抖：等待指定时间内无新调用后执行
  *   2. 最大等待：超过指定最大等待时间后强制执行
@@ -33,5 +33,33 @@ export interface UseDebounceOptions {
  *
  * @returns The debounced function | 防抖处理后的函数
  */
-declare function useDebounce<T extends (...args: any[]) => unknown>(fn: T, deps: React.DependencyList, options?: UseDebounceOptions): (...args: Parameters<T>) => void;
+declare function useDebounce<T extends (...args: any[]) => unknown>(fn: T, deps: React.DependencyList, options?: UseDebounceOptions): DebouncedFunc<T>;
+export interface DebouncedFunc<T extends (...args: any[]) => unknown> {
+    /**
+     * - **EN:** The debounced function.
+     * - **CN:** 防抖处理后的函数
+     */
+    (...args: Parameters<T>): ReturnType<T>;
+    /**
+     * - **EN:** Cancel any pending execution of the debounced function.
+     * - **CN:** 取消防抖函数的任何待执行操作
+     */
+    cancel: () => void;
+    /**
+     * - **EN:** Disable the debounce functionality. Once disabled, subsequent calls to the function
+     *   will have no effect until re-enabled.
+     * - **CN:** 禁用此防抖函数，一旦被禁用，再次调用改函数将不会有任何效果，除非重新启用
+     */
+    disable: () => void;
+    /**
+     * - **EN:** Re-enable the debounce functionality after it has been disabled.
+     * - **CN:** 重新启用此防抖函数
+     */
+    enable: () => void;
+    /**
+     * - **EN:** Check if the debounce functionality is currently disabled.
+     * - **CN:** 检查此防抖函数当前是否被禁用
+     */
+    isDisabled(): boolean;
+}
 export default useDebounce;

package/lib/hooks/useDebounce.js

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -14,6 +16,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/hooks/useDebounce.ts
@@ -23,12 +33,14 @@ __export(useDebounce_exports, {
 });
 module.exports = __toCommonJS(useDebounce_exports);
 var import_react = require("react");
+var import_useRefFunction = __toESM(require("./useRefFunction"));
 function useDebounce(fn, deps, options = {}) {
   const { wait = 0, maxWait = 0, leading = false } = options;
   const timeoutRef = (0, import_react.useRef)(null);
   const fnRef = (0, import_react.useRef)(fn);
   const lastExecutedTimeRef = (0, import_react.useRef)(0);
   const lastArgsRef = (0, import_react.useRef)([]);
+  const isDisabledRef = (0, import_react.useRef)(false);
   (0, import_react.useEffect)(() => {
     fnRef.current = fn;
   }, [fn]);
@@ -45,27 +57,40 @@ function useDebounce(fn, deps, options = {}) {
     lastExecutedTimeRef.current = Date.now();
     fnRef.current(...lastArgsRef.current);
   }, []);
-  return (0, import_react.useCallback)(
-    (...args) => {
-      const now = Date.now();
-      lastArgsRef.current = args;
-      if (leading && timeoutRef.current === null && now - lastExecutedTimeRef.current >= wait) {
-        executeFunction();
-        return;
-      }
-      if (timeoutRef.current !== null) {
-        clearTimeout(timeoutRef.current);
-        timeoutRef.current = null;
-      }
-      if (maxWait > 0 && now - lastExecutedTimeRef.current >= maxWait) {
-        executeFunction();
-        return;
-      }
-      timeoutRef.current = setTimeout(executeFunction, wait);
-    },
-    // eslint-disable-next-line @tiny-codes/react-hooks/exhaustive-deps
-    [wait, maxWait, executeFunction, leading, ...deps]
-  );
+  const debouncedFunction = (0, import_useRefFunction.default)((...args) => {
+    if (isDisabledRef.current) {
+      return;
+    }
+    const now = Date.now();
+    lastArgsRef.current = args;
+    if (leading && timeoutRef.current === null && now - lastExecutedTimeRef.current >= wait) {
+      executeFunction();
+      return;
+    }
+    if (timeoutRef.current !== null) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+    if (maxWait > 0 && now - lastExecutedTimeRef.current >= maxWait) {
+      executeFunction();
+      return;
+    }
+    timeoutRef.current = setTimeout(executeFunction, wait);
+  });
+  debouncedFunction.cancel = () => {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+  };
+  debouncedFunction.disable = () => {
+    isDisabledRef.current = true;
+  };
+  debouncedFunction.enable = () => {
+    isDisabledRef.current = false;
+  };
+  debouncedFunction.isDisabled = () => isDisabledRef.current;
+  return debouncedFunction;
 }
 var useDebounce_default = useDebounce;
 //# sourceMappingURL=useDebounce.js.map

package/lib/hooks/useDebounce.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/hooks/useDebounce.ts"],
-  "sourcesContent": ["import { useCallback, useEffect, useRef } from 'react';\n\nexport interface UseDebounceOptions {\n  /**\n   * - **EN** Whether to execute at the start of the wait period. Default is `false`.\n   * - **CN** 是否在等待周期开始时执行，默认值为 `false`\n   */\n  leading?: boolean;\n  /**\n   * - **EN** Regular debounce interval in milliseconds. Default is `0`, meaning no debounce.\n   * - **CN** 常规防抖间隔 (ms)，默认值为 `0`, 表示不进行防抖\n   */\n  wait?: number;\n  /**\n   * - **EN** Maximum wait time in milliseconds. Default is `0`, meaning no maximum wait.\n   * - **CN** 最大等待时间 (ms)，默认值为 `0`, 表示不限制最大等待时间\n   */\n  maxWait?: number;\n}\n/**\n * - **EN** Debounce Hook with dual trigger mechanisms:\n *\n *   1. Traditional debounce: Executes after a specified interval without new calls.\n *   2. Max wait: Forces execution after exceeding a specified maximum wait time.\n * - **CN** 防抖 Hook：具有两种触发机制:\n *\n *   1. 传统防抖：等待指定时间内无新调用后执行\n *   2. 最大等待：超过指定最大等待时间后强制执行\n *\n * @param fn The function to debounce | 需要防抖的函数\n * @param deps Dependency array, re-creates the debounced function when dependencies change |\n *   依赖项数组，当依赖变化时重新创建防抖函数\n * @param options Configuration options | 配置选项\n *\n * @returns The debounced function | 防抖处理后的函数\n */\nfunction useDebounce<T extends (...args: any[]) => unknown>(\n  fn: T,\n  deps: React.DependencyList,\n  options: UseDebounceOptions = {}\n): (...args: Parameters<T>) => void {\n  const { wait = 0, maxWait = 0, leading = false } = options;\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const fnRef = useRef<T>(fn);\n  const lastExecutedTimeRef = useRef<number>(0); // The last execution timestamp\n  const lastArgsRef = useRef<unknown[]>([]); // The last call arguments\n\n  // Update the latest function reference\n  useEffect(() => {\n    fnRef.current = fn;\n  }, [fn]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n        timeoutRef.current = null;\n      }\n    };\n  }, []);\n\n  // The actual execution function\n  const executeFunction = useCallback(() => {\n    timeoutRef.current = null;\n    lastExecutedTimeRef.current = Date.now();\n    fnRef.current(...lastArgsRef.current);\n  }, []);\n\n  // The debounced function\n  return useCallback(\n    (...args: Parameters<T>) => {\n      const now = Date.now();\n      lastArgsRef.current = args;\n\n      // If leading is true and it's the first call, execute immediately\n      if (leading && timeoutRef.current === null && now - lastExecutedTimeRef.current >= wait) {\n        executeFunction();\n        return;\n      }\n\n      // 1. Clear the existing timer\n      if (timeoutRef.current !== null) {\n        clearTimeout(timeoutRef.current);\n        timeoutRef.current = null;\n      }\n\n      // 2. Check if the maximum wait time has been exceeded, if so, execute immediately\n      if (maxWait > 0 && now - lastExecutedTimeRef.current >= maxWait) {\n        executeFunction();\n        return;\n      }\n\n      // 3. Set a new debounce timer\n      timeoutRef.current = setTimeout(executeFunction, wait);\n    },\n    // eslint-disable-next-line @tiny-codes/react-hooks/exhaustive-deps\n    [wait, maxWait, executeFunction, leading, ...deps]\n  );\n}\n\nexport default useDebounce;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA+C;AAoC/C,SAAS,YACP,IACA,MACA,UAA8B,CAAC,GACG;AAClC,QAAM,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,MAAM,IAAI;AACnD,QAAM,iBAAa,qBAA6C,IAAI;AACpE,QAAM,YAAQ,qBAAU,EAAE;AAC1B,QAAM,0BAAsB,qBAAe,CAAC;AAC5C,QAAM,kBAAc,qBAAkB,CAAC,CAAC;AAGxC,8BAAU,MAAM;AACd,UAAM,UAAU;AAAA,EAClB,GAAG,CAAC,EAAE,CAAC;AAGP,8BAAU,MAAM;AACd,WAAO,MAAM;AACX,UAAI,WAAW,SAAS;AACtB,qBAAa,WAAW,OAAO;AAC/B,mBAAW,UAAU;AAAA,MACvB;AAAA,IACF;AAAA,EACF,GAAG,CAAC,CAAC;AAGL,QAAM,sBAAkB,0BAAY,MAAM;AACxC,eAAW,UAAU;AACrB,wBAAoB,UAAU,KAAK,IAAI;AACvC,UAAM,QAAQ,GAAG,YAAY,OAAO;AAAA,EACtC,GAAG,CAAC,CAAC;AAGL,aAAO;AAAA,IACL,IAAI,SAAwB;AAC1B,YAAM,MAAM,KAAK,IAAI;AACrB,kBAAY,UAAU;AAGtB,UAAI,WAAW,WAAW,YAAY,QAAQ,MAAM,oBAAoB,WAAW,MAAM;AACvF,wBAAgB;AAChB;AAAA,MACF;AAGA,UAAI,WAAW,YAAY,MAAM;AAC/B,qBAAa,WAAW,OAAO;AAC/B,mBAAW,UAAU;AAAA,MACvB;AAGA,UAAI,UAAU,KAAK,MAAM,oBAAoB,WAAW,SAAS;AAC/D,wBAAgB;AAChB;AAAA,MACF;AAGA,iBAAW,UAAU,WAAW,iBAAiB,IAAI;AAAA,IACvD;AAAA;AAAA,IAEA,CAAC,MAAM,SAAS,iBAAiB,SAAS,GAAG,IAAI;AAAA,EACnD;AACF;AAEA,IAAO,sBAAQ;",
-  "names": []
+  "sourcesContent": ["import { useCallback, useEffect, useRef } from 'react';\nimport useRefFunction from './useRefFunction';\n\nexport interface UseDebounceOptions {\n  /**\n   * - **EN:** Whether to execute at the start of the wait period. Default is `false`.\n   * - **CN:** 是否在等待周期开始时执行，默认值为 `false`\n   */\n  leading?: boolean;\n  /**\n   * - **EN:** Regular debounce interval in milliseconds. Default is `0`, meaning no debounce.\n   * - **CN:** 常规防抖间隔 (ms)，默认值为 `0`, 表示不进行防抖\n   */\n  wait?: number;\n  /**\n   * - **EN:** Maximum wait time in milliseconds. Default is `0`, meaning no maximum wait.\n   * - **CN:** 最大等待时间 (ms)，默认值为 `0`, 表示不限制最大等待时间\n   */\n  maxWait?: number;\n}\n/**\n * - **EN:** Debounce Hook with dual trigger mechanisms:\n *\n *   1. Traditional debounce: Executes after a specified interval without new calls.\n *   2. Max wait: Forces execution after exceeding a specified maximum wait time.\n * - **CN:** 防抖 Hook：具有两种触发机制:\n *\n *   1. 传统防抖：等待指定时间内无新调用后执行\n *   2. 最大等待：超过指定最大等待时间后强制执行\n *\n * @param fn The function to debounce | 需要防抖的函数\n * @param deps Dependency array, re-creates the debounced function when dependencies change |\n *   依赖项数组，当依赖变化时重新创建防抖函数\n * @param options Configuration options | 配置选项\n *\n * @returns The debounced function | 防抖处理后的函数\n */\nfunction useDebounce<T extends (...args: any[]) => unknown>(\n  fn: T,\n  deps: React.DependencyList,\n  options: UseDebounceOptions = {}\n): DebouncedFunc<T> {\n  const { wait = 0, maxWait = 0, leading = false } = options;\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const fnRef = useRef<T>(fn);\n  const lastExecutedTimeRef = useRef<number>(0); // The last execution timestamp\n  const lastArgsRef = useRef<unknown[]>([]); // The last call arguments\n  const isDisabledRef = useRef<boolean>(false); // Whether debounce is disabled\n\n  // Update the latest function reference\n  useEffect(() => {\n    fnRef.current = fn;\n  }, [fn]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n        timeoutRef.current = null;\n      }\n    };\n  }, []);\n\n  // The actual execution function\n  const executeFunction = useCallback(() => {\n    timeoutRef.current = null;\n    lastExecutedTimeRef.current = Date.now();\n    fnRef.current(...lastArgsRef.current);\n  }, []);\n\n  // The debounced function\n  const debouncedFunction = useRefFunction((...args: Parameters<T>) => {\n    if (isDisabledRef.current) {\n      return;\n    }\n    const now = Date.now();\n    lastArgsRef.current = args;\n\n    // If leading is true and it's the first call, execute immediately\n    if (leading && timeoutRef.current === null && now - lastExecutedTimeRef.current >= wait) {\n      executeFunction();\n      return;\n    }\n\n    // 1. Clear the existing timer\n    if (timeoutRef.current !== null) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n    }\n\n    // 2. Check if the maximum wait time has been exceeded, if so, execute immediately\n    if (maxWait > 0 && now - lastExecutedTimeRef.current >= maxWait) {\n      executeFunction();\n      return;\n    }\n\n    // 3. Set a new debounce timer\n    timeoutRef.current = setTimeout(executeFunction, wait);\n  }) as DebouncedFunc<T>;\n  debouncedFunction.cancel = () => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n    }\n  };\n  debouncedFunction.disable = () => {\n    isDisabledRef.current = true;\n  };\n  debouncedFunction.enable = () => {\n    isDisabledRef.current = false;\n  };\n  debouncedFunction.isDisabled = () => isDisabledRef.current;\n  return debouncedFunction;\n}\n\nexport interface DebouncedFunc<T extends (...args: any[]) => unknown> {\n  /**\n   * - **EN:** The debounced function.\n   * - **CN:** 防抖处理后的函数\n   */\n  (...args: Parameters<T>): ReturnType<T>;\n  /**\n   * - **EN:** Cancel any pending execution of the debounced function.\n   * - **CN:** 取消防抖函数的任何待执行操作\n   */\n  cancel: () => void;\n  /**\n   * - **EN:** Disable the debounce functionality. Once disabled, subsequent calls to the function\n   *   will have no effect until re-enabled.\n   * - **CN:** 禁用此防抖函数，一旦被禁用，再次调用改函数将不会有任何效果，除非重新启用\n   */\n  disable: () => void;\n  /**\n   * - **EN:** Re-enable the debounce functionality after it has been disabled.\n   * - **CN:** 重新启用此防抖函数\n   */\n  enable: () => void;\n  /**\n   * - **EN:** Check if the debounce functionality is currently disabled.\n   * - **CN:** 检查此防抖函数当前是否被禁用\n   */\n  isDisabled(): boolean;\n}\n\nexport default useDebounce;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA+C;AAC/C,4BAA2B;AAoC3B,SAAS,YACP,IACA,MACA,UAA8B,CAAC,GACb;AAClB,QAAM,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,MAAM,IAAI;AACnD,QAAM,iBAAa,qBAA6C,IAAI;AACpE,QAAM,YAAQ,qBAAU,EAAE;AAC1B,QAAM,0BAAsB,qBAAe,CAAC;AAC5C,QAAM,kBAAc,qBAAkB,CAAC,CAAC;AACxC,QAAM,oBAAgB,qBAAgB,KAAK;AAG3C,8BAAU,MAAM;AACd,UAAM,UAAU;AAAA,EAClB,GAAG,CAAC,EAAE,CAAC;AAGP,8BAAU,MAAM;AACd,WAAO,MAAM;AACX,UAAI,WAAW,SAAS;AACtB,qBAAa,WAAW,OAAO;AAC/B,mBAAW,UAAU;AAAA,MACvB;AAAA,IACF;AAAA,EACF,GAAG,CAAC,CAAC;AAGL,QAAM,sBAAkB,0BAAY,MAAM;AACxC,eAAW,UAAU;AACrB,wBAAoB,UAAU,KAAK,IAAI;AACvC,UAAM,QAAQ,GAAG,YAAY,OAAO;AAAA,EACtC,GAAG,CAAC,CAAC;AAGL,QAAM,wBAAoB,sBAAAA,SAAe,IAAI,SAAwB;AACnE,QAAI,cAAc,SAAS;AACzB;AAAA,IACF;AACA,UAAM,MAAM,KAAK,IAAI;AACrB,gBAAY,UAAU;AAGtB,QAAI,WAAW,WAAW,YAAY,QAAQ,MAAM,oBAAoB,WAAW,MAAM;AACvF,sBAAgB;AAChB;AAAA,IACF;AAGA,QAAI,WAAW,YAAY,MAAM;AAC/B,mBAAa,WAAW,OAAO;AAC/B,iBAAW,UAAU;AAAA,IACvB;AAGA,QAAI,UAAU,KAAK,MAAM,oBAAoB,WAAW,SAAS;AAC/D,sBAAgB;AAChB;AAAA,IACF;AAGA,eAAW,UAAU,WAAW,iBAAiB,IAAI;AAAA,EACvD,CAAC;AACD,oBAAkB,SAAS,MAAM;AAC/B,QAAI,WAAW,SAAS;AACtB,mBAAa,WAAW,OAAO;AAC/B,iBAAW,UAAU;AAAA,IACvB;AAAA,EACF;AACA,oBAAkB,UAAU,MAAM;AAChC,kBAAc,UAAU;AAAA,EAC1B;AACA,oBAAkB,SAAS,MAAM;AAC/B,kBAAc,UAAU;AAAA,EAC1B;AACA,oBAAkB,aAAa,MAAM,cAAc;AACnD,SAAO;AACT;AA+BA,IAAO,sBAAQ;",
+  "names": ["useRefFunction"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-codes/react-easy",
-  "version": "1.4.16",
+  "version": "1.4.18",
   "description": "Simplify React and AntDesign development with practical components and hooks",
   "keywords": [
     "react",