minutool 1.0.31 → 1.0.34

package/dist/index.d.ts

@@ -190,8 +190,24 @@ export declare const bindKeyUp: (element: EventTarget | string, payload: (event:
  * 绑定对象移动事件
  * @param element - 要移动的元素
  * @param handle - 拖动句柄，默认为元素本身
+ * @param options - 移动选项
+ * @param options.lockInView - 是否限制元素四边不超出视口，默认 false
+ * @param options.onStart - 开始拖动时的回调，返回 false 可阻止拖动
+ * @param options.onEnd - 结束拖动时的回调，参数为元素的最终 left 和 top 值
+ * @param options.onMove - 拖动过程中触发的回调，参数为元素的当前 left 和 top 值
+ * @returns 一个函数，用于解绑移动事件并恢复元素的初始样式
  */
-export declare const bindNodeMove: (element: HTMLElement | string, handle?: HTMLElement | string | null) => () => void;
+export declare const bindNodeMove: (element: HTMLElement | string, handle?: HTMLElement | string | null, { lockInView, onStart, onEnd, onMove: onMoving, }?: BindNodeMoveOptions) => () => void;
+
+/**
+ * 移动元素的选项接口
+ */
+declare interface BindNodeMoveOptions {
+    lockInView?: boolean;
+    onStart?: () => void | false;
+    onEnd?: (left: number, top: number) => void;
+    onMove?: (left: number, top: number) => void;
+}
 
 /**
  * 为指定的 localStorage key 绑定变化事件
@@ -302,6 +318,18 @@ export declare const cleanNull: <T>(obj: T, recursive?: boolean) => T;
 
 export declare const COMMON_DPI = 96;
 
+/**
+ * 组合多个清理函数为一个清理函数
+ * @param cleanups - 要组合的清理函数数组
+ * @returns 一个函数，调用时会依次执行所有传入的清理函数
+ * @example
+ * const cleanup1 = () => console.log('cleanup1');
+ * const cleanup2 = () => console.log('cleanup2');
+ * const combinedCleanup = composeCleanups(cleanup1, cleanup2);
+ * combinedCleanup(); // 会依次执行 cleanup1 和 cleanup2
+ */
+export declare const composeCleanups: (...cleanups: Array<() => void>) => (() => void);
+
 export declare const convertMinutesToTimezoneOffsetStr: (offsetMinutes: number) => string;
 
 /**