minutool 1.0.24 → 1.0.26

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  * const req = abortableFetch('/api/data');
  * req.abort('canceled'); // 中止请求
  */
-export declare const abortableFetch: (url: string, fetchOption?: RequestOption) => AbortablePromise<any>;
+export declare const abortableFetch: <T = any>(url: string, fetchOption?: RequestOption) => AbortablePromise<T>;
 
 /**
  * 可中止的 Fetch 请求
@@ -46,7 +46,7 @@ export declare const arrayChunk: <T = any>(list: T[], size: number) => T[][];
  * @example
  * arrayColumn([{id: 1, name: 'A'}, {id: 2, name: 'B'}], 'name') // ['A', 'B']
  */
-export declare const arrayColumn: <T = any>(arr: T[], col_name: keyof T) => any[];
+export declare const arrayColumn: <T = any>(arr: T[], col_name: keyof T) => T[keyof T][];
 
 /**
  * 数组去重
@@ -57,7 +57,7 @@ export declare const arrayColumn: <T = any>(arr: T[], col_name: keyof T) => any[
  * arrayDistinct([1, 2, 2, 3, 3, 3]) // [1, 2, 3]
  * arrayDistinct([{id: 1}, {id: 2}, {id: 1}], (item, index) => item.id) // [{id: 1}, {id: 2}]
  */
-export declare const arrayDistinct: <T = any>(arr: T[], payload?: (item: T, index: number) => any) => T[];
+export declare const arrayDistinct: <T = any, K = any>(arr: T[], payload?: (item: T, index: number) => K) => T[];
 
 /**
  * 按指定键对数组进行分组
@@ -79,7 +79,7 @@ export declare const arrayGroup: <T extends Record<string, any>>(arr: T[], by_ke
  * @example
  * arrayIndex(['a', 'b', 'c'], 'b') // '1'
  */
-export declare const arrayIndex: <T = any>(arr: T[], val: T) => string | null;
+export declare const arrayIndex: <T = any>(arr: T[], val: T) => number | null;
 
 /**
  * 按照对象的键进行字母顺序排序
@@ -97,7 +97,7 @@ export declare const arraySortByKey: <T extends Record<string, any>>(obj: T) =>
  * @example
  * arrayTrimTail([1, 2, 0, false, null]) // [1, 2]
  */
-export declare const arrayTrimTail: (arr: any[]) => any[];
+export declare const arrayTrimTail: <T>(arr: T[]) => T[];
 
 /**
  * Base64 解码
@@ -142,7 +142,7 @@ export declare const between: (val: number, min: number, max: number, includeEqu
  * @param payload - 事件回调函数
  * @returns 解绑函数
  */
-export declare const bindClick: (element: EventTarget | string, payload: (event: Event) => void) => () => void;
+export declare const bindClick: (element: EventTarget | string, payload: (event: MouseEvent) => void) => () => void;
 
 /**
  * 绑定DOM事件，并返回一个解绑函数
@@ -159,7 +159,16 @@ export declare const bindDomEvent: <E extends Event = Event>(element: EventTarge
  * @param payload - 事件回调函数
  * @returns 解绑函数
  */
-export declare const bindDoubleClick: (element: EventTarget | string, payload: (event: Event) => void) => () => void;
+export declare const bindDoubleClick: (element: EventTarget | string, payload: (event: MouseEvent) => void) => () => void;
+
+/**
+ * 为 input/textarea 绑定支持 IME 的防抖函数
+ * @param element - DOM 元素
+ * @param callback - 回调，参数为 { value, event }
+ * @param delay - 防抖延迟（ms），默认 300
+ * @returns { destroy, cancel, flush }
+ */
+export declare const bindInputDebounce: (element: HTMLInputElement | HTMLTextAreaElement, callback: (value: string, event: InputEvent) => void, delay?: number) => (() => void);
 
 /**
  * 绑定键盘按键按下事件，并返回一个解绑函数
@@ -167,7 +176,7 @@ export declare const bindDoubleClick: (element: EventTarget | string, payload: (
  * @param payload - 事件回调函数
  * @returns 解绑函数
  */
-export declare const bindKeyDown: (element: EventTarget | string, payload: (event: Event) => void) => () => void;
+export declare const bindKeyDown: (element: EventTarget | string, payload: (event: KeyboardEvent) => void) => () => void;
 
 /**
  * 绑定键盘按键抬起事件，并返回一个解绑函数
@@ -175,7 +184,7 @@ export declare const bindKeyDown: (element: EventTarget | string, payload: (even
  * @param payload - 事件回调函数
  * @returns 解绑函数
  */
-export declare const bindKeyUp: (element: EventTarget | string, payload: (event: Event) => void) => () => void;
+export declare const bindKeyUp: (element: EventTarget | string, payload: (event: KeyboardEvent) => void) => () => void;
 
 /**
  * 绑定对象移动事件
@@ -191,7 +200,7 @@ export declare function bindNodeMove(element: HTMLElement | string, handle?: HTM
  * @example
  * blobToBase64(blob).then(base64 => console.log(base64))
  */
-export declare const blobToBase64: (blob: Blob) => Promise<unknown>;
+export declare const blobToBase64: (blob: Blob) => Promise<string>;
 
 /**
  * 将 Blob 转换为 Data URI
@@ -265,7 +274,7 @@ export declare function capitalize(str: string): string;
  * @example
  * cleanNull({a: 1, b: null, c: {d: null}}, true) // {a: 1, c: {}}
  */
-export declare const cleanNull: (obj: any, recursive?: boolean) => any;
+export declare const cleanNull: <T>(obj: T, recursive?: boolean) => T;
 
 export declare const COMMON_DPI = 96;
 
@@ -332,7 +341,7 @@ export declare const DAY_WEDNESDAY = 3;
  * @example
  * const debounced = debounce(() => console.log('called'), 1000)
  */
-export declare const debounce: (fn: Function, intervalMiSec: number) => Function;
+export declare const debounce: <T extends (...args: any[]) => any>(fn: T, intervalMiSec: number) => T;
 
 /**
  * 解码 HTML 实体（包括 script 和 HTML 标签过滤）
@@ -415,7 +424,7 @@ export declare const disabled: (el: HTMLElement | string, disabledClass?: string
  * @param event 事件名称
  * @param detail 事件详情
  */
-declare const dispatchEvent_2: (event: string | symbol, detail?: any) => void;
+declare const dispatchEvent_2: <T = any>(event: string | symbol, detail?: T) => void;
 export { dispatchEvent_2 as dispatchEvent }
 
 /**
@@ -443,7 +452,7 @@ export declare const enabled: (el: HTMLElement | string, disabledClass?: string)
  * @example
  * enterFullScreen(document.body)
  */
-export declare const enterFullScreen: (element: any) => Promise<void>;
+export declare const enterFullScreen: (element: HTMLElement) => Promise<void>;
 
 /**
  * HTML 实体转字符串
@@ -517,7 +526,7 @@ export declare const fileToBase64DataUri: (file: File | Blob | string) => Promis
  * @example
  * findAll('.item', container)
  */
-export declare const findAll: (selector: string | Element | Element[], parent?: Document | DocumentFragment | Element) => Element[];
+export declare const findAll: (selector: string | Element | Element[] | NodeList | HTMLCollection, parent?: Document | DocumentFragment | Element) => Element[];
 
 /**
  * 通过选择器查找单个节点
@@ -542,7 +551,7 @@ export declare const fixBaseUrl: (url: string, baseUrl: string) => string;
  * @param {number} [defaultVal=0] - 转换失败时的默认值
  * @returns {number} 返回转换后的浮点数，如果转换失败则返回默认值
  */
-export declare const floatVal: (str: any, defaultVal?: number) => number;
+export declare const floatVal: (str: unknown, defaultVal?: number) => number;
 
 /**
  * 格式化日期（以 PHP 方式格式化）
@@ -805,7 +814,7 @@ export declare const isLandscape: () => boolean;
  * isNumberic('-123') // true
  * isNumberic('210mm') // false
  */
-export declare const isNumberic: (val: any) => boolean;
+export declare const isNumberic: (val: unknown) => boolean;
 
 /**
  * 检测目标是否为 Object（非数组的对象）
@@ -1331,7 +1340,7 @@ export declare const objectFromEntries: <T extends Record<string | number | symb
  * get({ a: { b: { c: 1 } } }, 'a.b.c') // 1
  * get({ a: { b: 1 } }, 'a.b.c', 0) // 0
  */
-export declare function objectGet<T = any>(obj: any, path: string, defaultValue?: T): T;
+export declare function objectGet<T = any>(obj: object, path: string, defaultValue?: T): T;
 
 /**
  * 根据映射关系替换对象的键
@@ -1379,7 +1388,7 @@ export declare const objectSwitchKV: (obj: object) => any;
  * @example
  * objToQuery({name: 'John', age: 30}) // 'name=John&age=30'
  */
-export declare const objToQuery: (data: Record<string, any>) => string;
+export declare const objToQuery: (data: any) => string;
 
 /**
  * 取消订阅事件，event 可以是字符串或 Symbol，handler 是事件处理函数
@@ -1617,7 +1626,7 @@ export declare const remove: (dom: HTMLElement | string) => Node | null;
  * @example
  * request('/api/data', null, {method: 'GET'})
  */
-export declare const request: (url: string, data: (BodyInit | null) | undefined, requestOption: RequestOption) => AbortablePromise<Response>;
+export declare const request: (url: string, data?: any, requestOption?: RequestOption) => AbortablePromise<Response>;
 
 /**
  * 扩展 RequestInit，添加 timeout 和其他自定义属性，timeout 用于设置请求超时时间，其他自定义属性可以直接添加到 headers 中
@@ -1683,7 +1692,7 @@ export declare const show: (dom: HTMLElement | string) => void;
  * @example
  * srcToBase64('https://example.com/image.png').then(base64 => console.log(base64))
  */
-export declare const srcToBase64: (url: string, cache?: boolean) => Promise<unknown>;
+export declare const srcToBase64: (url: string, cache?: boolean) => Promise<string>;
 
 export declare const STAND_DPI = 96;
 
@@ -1788,7 +1797,7 @@ export declare const text2Html: (text: string) => string;
  * @example
  * const throttled = throttle(() => console.log('called'), 1000)
  */
-export declare const throttle: (fn: Function, intervalMiSec: number) => Function;
+export declare const throttle: <T extends (...args: any[]) => any>(fn: T, intervalMiSec: number) => T;
 
 /**
  * 更有效果的节流函数
@@ -1800,7 +1809,7 @@ export declare const throttle: (fn: Function, intervalMiSec: number) => Function
  * @example
  * const throttled = throttleEffect(() => console.log('called'), 1000)
  */
-export declare const throttleEffect: (fn: Function, intervalMiSec: number) => Function;
+export declare const throttleEffect: <T extends (...args: any[]) => any>(fn: T, intervalMiSec: number) => T;
 
 /**
  * 将时间戳转换为本地时间的日期时间字符串（YYYY-MM-DDTHH:mm），
@@ -1826,7 +1835,7 @@ export declare const toggleDisabled: (el: HTMLElement | string, disabledClass?:
  * @example
  * toggleFullScreen(document.body)
  */
-export declare const toggleFullScreen: (element: any) => Promise<unknown>;
+export declare const toggleFullScreen: (element: HTMLElement) => Promise<unknown>;
 
 /**
  * 触发HTML节点事件