nhanh-pure-function 3.0.6-beta.13 → 3.0.6-beta.15

package/dist/Element/index.d.ts

@@ -58,7 +58,7 @@ export declare function _Element_IsFullscreen(element?: HTMLElement | string): b
  * @param {HTMLElement} content - 需要进入全屏的元素
  * 该函数通过检查不同浏览器的特定方法来实现全屏切换
  */
-export declare function _Element_Fullscreen(element?: HTMLElement | string): () => void;
+export declare function _Element_Fullscreen(element?: HTMLElement | string): (() => void) | undefined;
 /**
  * 元素全屏状态观察器
  * 监听元素的全屏状态变化，并通过回调函数通知状态改变
@@ -66,7 +66,7 @@ export declare function _Element_Fullscreen(element?: HTMLElement | string): ()
  * @param selectors - 要观察的元素或元素选择器，默认为document.documentElement
  * @returns 返回一个清理函数，调用后可移除所有事件监听器
  */
-export declare function _Element_FullscreenObserver(notify: (isFull: boolean) => void, selectors?: HTMLElement | string): () => void;
+export declare function _Element_FullscreenObserver(notify: (isFull: boolean) => void, selectors?: HTMLElement | string): (() => void) | undefined;
 /**
  * 单位转换 12** -> **px
  * @param {string} width

package/dist/Utility/index.d.ts

@@ -3,7 +3,7 @@
  * @param callback  需执行的方法
  * @param timeout 超时时间
  */
-export declare function _Utility_ExecuteWhenIdle(callback: Function, timeout?: number): void;
+export declare function _Utility_ExecuteWhenIdle(callback: (deadline?: IdleDeadline) => void, timeout?: number): void;
 /**
  * 等待条件满足
  * @param conditionChecker 条件检查器
@@ -74,12 +74,22 @@ export declare function _Utility_RotateList<T>(list: T[]): T[][];
  */
 export declare function _Utility_Clone<T>(val: T): T;
 /**
- * 函数装饰器，用于测量并记录另一个函数的执行时间
- * @param func 要测量执行时间的函数
- * @param level 耗时与颜色对应的数组，用于在控制台中着色显示
- * @param maxHistory 保留的最大历史记录数，默认为30
+ * 函数装饰器：精准测量并记录目标函数的执行耗时（单位：毫秒）
+ *
+ * @template T - 泛型参数，约束为任意函数类型，保证装饰器返回值类型与原函数一致
+ * @param {T} func - 待测量执行时间的目标函数
+ * @param {Object} [config] - 可选配置对象，用于自定义耗时测量规则
+ * @param {Array<[number, string]>} [config.level] - 耗时阈值（毫秒）与控制台输出颜色的映射数组
+ *                                                   规则：当函数耗时（ms）≥ level[n][0] 时，使用 level[n][1] 指定的颜色输出
+ * @param {number} [config.maxHistory=30] - 执行耗时历史记录的最大保留条数，默认值为30
+ * @param {string} [config.prefix] - 控制台输出耗时日志时的自定义前缀文本（可选）
+ * @returns {T | void} 包装后的函数（保留原函数所有功能，新增耗时测量/记录/日志输出逻辑）；若入参非法则返回 void
  */
-export declare function _Utility_TimeConsumption(func: Function, level: [number, string][], maxHistory?: number): void | ((...args: any[]) => any);
+export declare function _Utility_TimeConsumption<T extends Function>(func: T, config?: {
+    level?: [number, string][];
+    maxHistory?: number;
+    prefix?: string;
+}): T | void;
 /**
  * 暂停执行指定毫秒数的操作
  * 此函数通过 busy-wait（忙等待）的方式实现，它会持续执行一些无用的操作以消耗时间