nhanh-pure-function 4.6.0 → 4.6.2

package/dist/Format/index.d.ts

@@ -108,4 +108,12 @@ export declare function _Format_MillisecondToReadable(ms: number, maxUnit?: Unit
  * @throws 当size小于1时抛出错误
  */
 export declare function _Format_ChunkArray<T>(arr: T[], size: number): T[][];
+/**
+ * 截断字符串，超出最大长度时追加后缀
+ * @param str 原始字符串
+ * @param max 最大长度
+ * @param suffix 超出时追加的后缀，默认为 "..."
+ * @returns 截断后的字符串
+ */
+export declare function _Format_Truncate(str: string, max: number, suffix?: string): string;
 export {};

package/dist/Types/index.d.ts

@@ -37,12 +37,3 @@ export type _Type_DeepPartial<T> = {
 export type _Type_Mutable<T> = {
     -readonly [P in keyof T]: T[P];
 };
-/**
- * 递归地将类型中的所有只读（readonly）属性转换为可写（writable）属性
- * @template T - 要处理的基础类型
- * @description 与TypeScript内置的Writable不同，DeepWritable会对嵌套对象进行递归处理，
- *              使所有层级的属性都变为可写。适用于需要修改对象属性的场景，但需要确保对象不会被其他地方引用。
- */
-export type _Type_DeepWritable<T> = {
-    -readonly [P in keyof T]: _Type_DeepWritable<T[P]>;
-};

package/dist/Utility/index.d.ts

@@ -1,4 +1,3 @@
-import { _Type_DeepWritable } from '../Types';
 export * from './modules';
 /**
  * 寻找空闲时机执行传入方法
@@ -74,7 +73,7 @@ export declare function _Utility_RotateList<T>(list: T[]): T[][];
  * @param {any} val - 需要克隆的值
  * @returns {any} - 克隆后的值
  */
-export declare function _Utility_Clone<T>(val: T): _Type_DeepWritable<T>;
+export declare function _Utility_Clone<T>(val: T): T;
 /**
  * 函数装饰器：精准测量并记录目标函数的执行耗时（单位：毫秒）
  *

package/dist/Utility/modules/colorConverter.d.ts

@@ -1,3 +1,13 @@
+/**
+ * RGBA 颜色分量对象。
+ * r/g/b 范围 0-255，a 范围 0-1
+ */
+export interface _Utility_RGBA {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
 /**
  * 颜色转换工具。
  * 支持输入：hex/rgb/hsl/hsv，统一解析后输出指定格式。
@@ -92,14 +102,20 @@ export declare class _Utility_ColorConverter {
         a: number;
     };
     /**
-     * 判断两个颜色是否在允许的色差范围内（基于 RGB 欧几里得距离）。
-     * @param colorA 第一个颜色字符串
-     * @param colorB 第二个颜色字符串
-     * @param threshold 允许的最大色差值，范围约 0（完全相同）到 442（黑白最大距离），含 alpha 时上限约 510
-     * @param includeAlpha 是否将 alpha 差值纳入计算，默认 true；启用时 alpha 差值会缩放到 0-255 参与距离
+     * 将颜色输入统一解析为 RGBA 对象。
+     * 字符串走 parseColor，已是对象则直接返回。
+     */
+    private static resolveColorInput;
+    /**
+     * 判断两个颜色是否在允许的色差范围内（基于 RGBA 欧几里得距离）。
+     * 颜色参数支持任意颜色字符串或 { r, g, b, a } 对象。
+     * @param colorA 第一个颜色（字符串或 RGBA 对象）
+     * @param colorB 第二个颜色（字符串或 RGBA 对象）
+     * @param threshold 允许的最大色差值，范围约 0（完全相同）到 510（含 alpha 最大距离）
+     * @param includeAlpha 是否将 alpha 差值纳入计算，默认 true
      * @returns true 表示在允许色差内
      */
-    static isWithinColorDifference(colorA: string, colorB: string, threshold: number, includeAlpha?: boolean): boolean;
+    static isWithinColorDifference(colorA: string | _Utility_RGBA, colorB: string | _Utility_RGBA, threshold: number, includeAlpha?: boolean): boolean;
     /**
      * 混合两个颜色（在 RGBA 空间线性插值）。
      * @param colorA 起始颜色