minutool 1.0.23 → 1.0.25

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,7 @@ 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;
 
 /**
  * 绑定键盘按键按下事件，并返回一个解绑函数
@@ -167,7 +167,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 +175,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 +191,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 +265,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;
 
@@ -281,13 +281,11 @@ export declare const countDown: (timeout: number, tickFunc?: (timeout: number) =
 
 /**
  * 创建 HTML 节点
- * @param {string} html - HTML 字符串
- * @param {HTMLElement|null} [parentNode=null] - 父级节点，如果提供则自动添加到父节点
- * @returns {Node|Node[]} 返回创建的节点，单个或多个
- * @example
- * createDomByHtml('<div>Hello</div>')
+ * @param html - HTML 字符串
+ * @param [parentNode=null] - 父级节点，如果提供则自动添加到父节点
+ * @returns 返回创建的元素，单个或多个
  */
-export declare const createDomByHtml: (html: string, parentNode?: HTMLElement | null) => Node | Node[];
+export declare const createDomByHtml: <T extends Element = Element>(html: string, parentNode?: HTMLElement | null) => T | T[];
 
 /**
  * CSS 选择器转义（处理特殊字符）
@@ -334,7 +332,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 标签过滤）
@@ -417,7 +415,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 }
 
 /**
@@ -445,7 +443,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 实体转字符串
@@ -519,7 +517,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[];
 
 /**
  * 通过选择器查找单个节点
@@ -544,7 +542,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 方式格式化）
@@ -807,7 +805,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（非数组的对象）
@@ -1333,7 +1331,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;
 
 /**
  * 根据映射关系替换对象的键
@@ -1381,7 +1379,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 是事件处理函数
@@ -1619,7 +1617,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 中
@@ -1685,7 +1683,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;
 
@@ -1790,7 +1788,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;
 
 /**
  * 更有效果的节流函数
@@ -1802,7 +1800,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），
@@ -1828,7 +1826,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节点事件