jz-toolkit 1.1.9 → 1.2.0

package/README.md

@@ -1,152 +1,183 @@
-# jz-toolkit
-
-🚀 一个轻量级、功能丰富的 JavaScript/TypeScript 工具库。
-
-#### 🆕 最近更新
-
-##### v1.1.9
-- 新增 `renderTemplate()` - 字符串模板替换函数，支持灵活的变量替换
-
-```typescript
-import { renderTemplate } from "jz-toolkit";
-
-const result = renderTemplate(
-  { name: "张三", money: 100.50 },
-  "你好, {{name}}! 你的余额是 {{money}} 元。"
-);
-// 返回: "你好, 张三! 你的余额是 100.50 元。"
-```
-
-##### v1.1.8
-- 新增 `toThousandsIntl()` - 国际化数字千分位格式化函数，支持多地区格式
-- 新增 `toThousands()` - 常规数字千分位格式化函数
-
-```typescript
-import { toThousandsIntl, toThousands } from "jz-toolkit";
-
-toThousandsIntl(1234567.89, "zh-CN"); // '1,234,567.89'
-toThousandsIntl(1234567.89, "de-DE"); // '1.234.567,89'
-toThousands(1234567.89); // '1,234,567.89'
-```
-
-## 特点
-
-✨ **类型安全** - 使用 TypeScript 编写，提供完整的类型定义
-
-📦 **模块化** - 支持按需导入，减少打包体积
-
-⚡ **高性能** - 精心优化的实现
-
-🔧 **易于扩展** - 清晰的项目结构，易于添加新功能
-
-📚 **良好文档** - 每个函数都有详细的文档和示例
-
-## 安装
-
-```bash
-  npm i jz-toolkit
-```
-
-## 官方文档地址 - 更多Api在文档查阅
-
-http://172.81.245.148:8098/api/utils.html
-
-## 快速开始
-
-## 聊天群
-
-<img src="./assets/2871763863632_.pic.jpg" alt="聊天群" width="200">
-
-### 完整导入
-
-```typescript
-import * as _ from "jz-toolkit";
-
-_.chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
-_.capitalize("hello"); // 'Hello'
-```
-
-### 按需导入
-
-```typescript
-import { chunk, capitalize } from "jz-toolkit";
-
-chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
-capitalize("hello"); // 'Hello'
-```
-
-### 模块导入
-
-```typescript
-import * as array from "jz-toolkit/array";
-import * as object from "jz-toolkit/object";
-import * as string from "jz-toolkit/string";
-
-array.chunk([1, 2, 3, 4], 2);
-object.pick({ a: 1, b: 2 }, ["a"]);
-string.capitalize("world");
-```
-
-## 开发
-
-### 安装依赖
-
-```bash
-npm install
-```
-
-### 构建
-
-```bash
-npm run build
-```
-
-### 开发模式（监视文件变化）
-
-```bash
-npm run dev
-```
-
-### 运行测试
-
-```bash
-npm test
-```
-
-### 查看测试覆盖率
-
-```bash
-npm run test:coverage
-```
-
-### 代码格式化
-
-```bash
-npm run format
-```
-
-### Linting
-
-```bash
-npm run lint
-```
-
-## 项目结构
-
-```
-src/
-├── index.ts           # 主入口
-├── types/             # 类型定义
-├── array/             # 数组模块
-├── object/            # 对象模块
-├── string/            # 字符串模块
-└── utility/           # 工具函数模块
-```
-
-## 许可证
-
-MIT
-
-## 贡献
-
-欢迎贡献！请提交 PR 或 Issue。
+# jz-toolkit
+
+🚀 一个轻量级、功能丰富的 JavaScript/TypeScript 工具库。
+
+#### 🆕 最近更新
+
+##### v1.2.0
+
+- 新增 `color` 模块 - 颜色工具函数集合
+- 新增 `generateColors()` - 生成指定数量的随机十六进制颜色
+- 新增 `generateRandomColor()` - 生成单个随机十六进制颜色
+- 新增 `generateHarmoniousColors()` - 生成基于HSL的和谐色彩组合
+- 新增 `generateGradientColors()` - 生成渐变色彩组合
+- 新增 `hexToRgb()` - 将十六进制颜色转换为RGB格式
+- 新增 `rgbToHex()` - 将RGB颜色转换为十六进制格式
+- 新增 `hslToHex()` - 将HSL颜色转换为十六进制格式
+- 新增 `hexToHsl()` - 将十六进制颜色转换为HSL格式
+- 新增颜色验证函数：`isValidHex()`, `isValidRgb()`, `isValidHsl()`
+
+```typescript
+import { generateColors, hexToRgb, generateHarmoniousColors } from "jz-toolkit";
+
+// 生成8个随机颜色
+const colors = generateColors(8);
+// 返回: ['#FF5733', '#33FF57', '#5733FF', ...]
+
+// 十六进制转RGB
+const rgb = hexToRgb("#FF5733");
+// 返回: { r: 255, g: 87, b: 51 }
+
+// 生成和谐色彩组合
+const harmoniousColors = generateHarmoniousColors(120, 6, 70, 50);
+// 返回: ['#26D926', '#26D9D9', '#2626D9', ...]
+```
+
+##### v1.1.9
+
+- 新增 `renderTemplate()` - 字符串模板替换函数，支持灵活的变量替换
+
+```typescript
+import { renderTemplate } from "jz-toolkit";
+
+const result = renderTemplate(
+  { name: "张三", money: 100.5 },
+  "你好, {{name}}! 你的余额是 {{money}} 元。",
+);
+// 返回: "你好, 张三! 你的余额是 100.50 元。"
+```
+
+##### v1.1.8
+
+- 新增 `toThousandsIntl()` - 国际化数字千分位格式化函数，支持多地区格式
+- 新增 `toThousands()` - 常规数字千分位格式化函数
+
+```typescript
+import { toThousandsIntl, toThousands } from "jz-toolkit";
+
+toThousandsIntl(1234567.89, "zh-CN"); // '1,234,567.89'
+toThousandsIntl(1234567.89, "de-DE"); // '1.234.567,89'
+toThousands(1234567.89); // '1,234,567.89'
+```
+
+## 特点
+
+✨ **类型安全** - 使用 TypeScript 编写，提供完整的类型定义
+
+📦 **模块化** - 支持按需导入，减少打包体积
+
+⚡ **高性能** - 精心优化的实现
+
+🔧 **易于扩展** - 清晰的项目结构，易于添加新功能
+
+📚 **良好文档** - 每个函数都有详细的文档和示例
+
+## 安装
+
+```bash
+  npm i jz-toolkit
+```
+
+## 官方文档地址 - 更多Api在文档查阅
+
+http://172.81.245.148:8098/api/utils.html
+
+## 快速开始
+
+## 聊天群
+
+<img src="./assets/2871763863632_.pic.jpg" alt="聊天群" width="200">
+
+### 完整导入
+
+```typescript
+import * as _ from "jz-toolkit";
+
+_.chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+_.capitalize("hello"); // 'Hello'
+```
+
+### 按需导入
+
+```typescript
+import { chunk, capitalize } from "jz-toolkit";
+
+chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+capitalize("hello"); // 'Hello'
+```
+
+### 模块导入
+
+```typescript
+import * as array from "jz-toolkit/array";
+import * as object from "jz-toolkit/object";
+import * as string from "jz-toolkit/string";
+
+array.chunk([1, 2, 3, 4], 2);
+object.pick({ a: 1, b: 2 }, ["a"]);
+string.capitalize("world");
+```
+
+## 开发
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 构建
+
+```bash
+npm run build
+```
+
+### 开发模式（监视文件变化）
+
+```bash
+npm run dev
+```
+
+### 运行测试
+
+```bash
+npm test
+```
+
+### 查看测试覆盖率
+
+```bash
+npm run test:coverage
+```
+
+### 代码格式化
+
+```bash
+npm run format
+```
+
+### Linting
+
+```bash
+npm run lint
+```
+
+## 项目结构
+
+```
+src/
+├── index.ts           # 主入口
+├── types/             # 类型定义
+├── array/             # 数组模块
+├── object/            # 对象模块
+├── string/            # 字符串模块
+└── utility/           # 工具函数模块
+```
+
+## 许可证
+
+MIT
+
+## 贡献
+
+欢迎贡献！请提交 PR 或 Issue。

package/dist/array/access.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.takeRight = exports.take = exports.last = exports.first = void 0;
+exports.first = first;
+exports.last = last;
+exports.take = take;
+exports.takeRight = takeRight;
 /**
  * 获取数组的第一个元素
  * @param array 输入数组
@@ -13,7 +16,6 @@ exports.takeRight = exports.take = exports.last = exports.first = void 0;
 function first(array) {
     return array[0];
 }
-exports.first = first;
 /**
  * 获取数组的最后一个元素
  * @param array 输入数组
@@ -26,7 +28,6 @@ exports.first = first;
 function last(array) {
     return array[array.length - 1];
 }
-exports.last = last;
 /**
  * 获取数组的前n个元素
  * @param array 输入数组
@@ -39,7 +40,6 @@ exports.last = last;
 function take(array, n = 1) {
     return array.slice(0, n);
 }
-exports.take = take;
 /**
  * 获取数组的后n个元素
  * @param array 输入数组
@@ -52,4 +52,3 @@ exports.take = take;
 function takeRight(array, n = 1) {
     return n === 0 ? [] : array.slice(-n);
 }
-exports.takeRight = takeRight;

package/dist/array/chunk.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.chunk = void 0;
+exports.chunk = chunk;
 /**
  * 将数组分成指定大小的块
  * @param array 输入数组
@@ -21,4 +21,3 @@ function chunk(array, size) {
     }
     return result;
 }
-exports.chunk = chunk;

package/dist/array/compact.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compact = void 0;
+exports.compact = compact;
 /**
  * 移除数组中的虚值（false、null、0、""、undefined 和 NaN）
  * @param array 输入数组
@@ -13,4 +13,3 @@ exports.compact = void 0;
 function compact(array) {
     return array.filter((item) => Boolean(item));
 }
-exports.compact = compact;

package/dist/array/filterDuplicateValues.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterArrayAttr = exports.filterDuplicateValues = void 0;
+exports.filterDuplicateValues = filterDuplicateValues;
+exports.filterArrayAttr = filterArrayAttr;
 /**
  * Filters duplicate values from an array, keeping only unique items.
  * For objects, duplicates are determined by the key returned by the iteratee function.
@@ -33,7 +34,6 @@ function filterDuplicateValues(array, iteratee) {
     }
     return result;
 }
-exports.filterDuplicateValues = filterDuplicateValues;
 /**
  *
  * @param array - The array to filter.
@@ -46,4 +46,3 @@ function filterArrayAttr(array, extendParams) {
     const res = array.filter((item) => item[extendParams.key] === extendParams.value);
     return res;
 }
-exports.filterArrayAttr = filterArrayAttr;

package/dist/array/flatten.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.flattenDeep = exports.flatten = void 0;
+exports.flatten = flatten;
+exports.flattenDeep = flattenDeep;
 /**
  * 数组扁平化
  * @param array 输入数组
@@ -26,7 +27,6 @@ function flatten(array, depth = 1) {
         return acc;
     }, []);
 }
-exports.flatten = flatten;
 /**
  * 深度扁平化数组（扁平化所有层级）
  * @param array 输入数组
@@ -38,4 +38,3 @@ exports.flatten = flatten;
 function flattenDeep(array) {
     return flatten(array, Infinity);
 }
-exports.flattenDeep = flattenDeep;

package/dist/array/groupBy.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.groupBy = void 0;
+exports.groupBy = groupBy;
 /**
  * 按指定属性或函数对数组进行分组
  * @param array 输入数组
@@ -26,4 +26,3 @@ function groupBy(array, iteratee) {
         return result;
     }, {});
 }
-exports.groupBy = groupBy;

package/dist/array/set-operations.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.union = exports.difference = exports.intersection = void 0;
+exports.intersection = intersection;
+exports.difference = difference;
+exports.union = union;
 /**
  * 返回两个数组的交集
  * @param arr1 第一个数组
@@ -14,7 +16,6 @@ function intersection(arr1, arr2) {
     const set2 = new Set(arr2);
     return arr1.filter((item) => set2.has(item));
 }
-exports.intersection = intersection;
 /**
  * 返回第一个数组与第二个数组的差集
  * @param arr1 第一个数组
@@ -28,7 +29,6 @@ function difference(arr1, arr2) {
     const set2 = new Set(arr2);
     return arr1.filter((item) => !set2.has(item));
 }
-exports.difference = difference;
 /**
  * 返回多个数组的并集
  * @param arrays 多个数组
@@ -40,4 +40,3 @@ exports.difference = difference;
 function union(...arrays) {
     return Array.from(new Set(arrays.flat()));
 }
-exports.union = union;

package/dist/array/sortBy.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sortBy = void 0;
+exports.sortBy = sortBy;
 /**
  * 按指定属性或函数对数组进行排序
  * @param array 输入数组
@@ -25,4 +25,3 @@ function sortBy(array, iteratee) {
         return 0;
     });
 }
-exports.sortBy = sortBy;

package/dist/array/uniq.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uniqBy = exports.uniq = void 0;
+exports.uniq = uniq;
+exports.uniqBy = uniqBy;
 /**
  * 数组去重
  * @param array 输入数组
@@ -13,7 +14,6 @@ exports.uniqBy = exports.uniq = void 0;
 function uniq(array) {
     return Array.from(new Set(array));
 }
-exports.uniq = uniq;
 /**
  * 根据迭代器函数进行去重
  * @param array 输入数组
@@ -34,4 +34,3 @@ function uniqBy(array, iteratee) {
         return true;
     });
 }
-exports.uniqBy = uniqBy;

package/dist/async/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.promiseAllWithLimit = exports.timeout = exports.retry = void 0;
+exports.retry = retry;
+exports.timeout = timeout;
+exports.promiseAllWithLimit = promiseAllWithLimit;
 /**
  * 重试执行异步函数
  * @param fn 要重试的异步函数
@@ -26,7 +28,6 @@ async function retry(fn, times = 3, interval = 1000) {
     }
     throw lastError || new Error("Retry failed");
 }
-exports.retry = retry;
 /**
  * 超时控制
  * @param promise 要执行的Promise
@@ -53,7 +54,6 @@ function timeout(promise, ms, errorMessage = "Operation timed out") {
         });
     });
 }
-exports.timeout = timeout;
 /**
  * 并发控制的Promise.all
  * @param tasks 任务函数数组
@@ -89,4 +89,3 @@ async function promiseAllWithLimit(tasks, limit) {
     await Promise.all(executing);
     return results;
 }
-exports.promiseAllWithLimit = promiseAllWithLimit;

package/dist/color/colorConvert.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 颜色格式转换工具
+ */
+/**
+ * 十六进制转RGB
+ * @param hex 十六进制颜色字符串，如 "#FF5733" 或 "FF5733"
+ * @returns RGB对象 {r, g, b} 或 null
+ */
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * RGB转十六进制
+ * @param r 红色值 (0-255)
+ * @param g 绿色值 (0-255)
+ * @param b 蓝色值 (0-255)
+ * @returns 十六进制颜色字符串
+ */
+export declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * 十六进制转HSL
+ * @param hex 十六进制颜色字符串
+ * @returns HSL对象 {h, s, l} 或 null
+ */
+export declare function hexToHsl(hex: string): {
+    h: number;
+    s: number;
+    l: number;
+} | null;
+/**
+ * HSL转十六进制
+ * @param h 色相 (0-360)
+ * @param s 饱和度 (0-100)
+ * @param l 亮度 (0-100)
+ * @returns 十六进制颜色字符串
+ */
+export declare function hslToHex(h: number, s: number, l: number): string;
+/**
+ * RGB转HSL
+ * @param r 红色值 (0-255)
+ * @param g 绿色值 (0-255)
+ * @param b 蓝色值 (0-255)
+ * @returns HSL对象 {h, s, l}
+ */
+export declare function rgbToHsl(r: number, g: number, b: number): {
+    h: number;
+    s: number;
+    l: number;
+};
+/**
+ * HSL转RGB
+ * @param h 色相 (0-360)
+ * @param s 饱和度 (0-100)
+ * @param l 亮度 (0-100)
+ * @returns RGB对象 {r, g, b}
+ */
+export declare function hslToRgb(h: number, s: number, l: number): {
+    r: number;
+    g: number;
+    b: number;
+};
+//# sourceMappingURL=colorConvert.d.ts.map

package/dist/color/colorConvert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorConvert.d.ts","sourceRoot":"","sources":["../../src/color/colorConvert.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAchF;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKhF;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CA4B7F;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CA+B7F"}