nhanh-pure-function 4.6.1 → 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/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 起始颜色