@ibiz-template/core 0.6.1-dev.2 → 0.6.2

package/out/utils/recursive/find-recursive-child.d.ts

@@ -5,6 +5,29 @@ declare const IterateOpts: {
 };
 /**
  * 递归遍历子元素
+ *
+ * @description 递归遍历子元素 用法：传入数组和回调函数 无返回值
+ * @example
+ * ```
+ * const parent = {
+ *       name: 'parent',
+ *       children: [
+ *           {
+ *               name: 'child1',
+ *               children: [{ name: 'grandchild1' }, { name: 'grandchild2' }],
+ *           },
+ *           { name: 'child2', children: [{ name: 'grandchild3' }] },
+ *       ],
+ *    };
+ *
+ * const result: string[] = [];
+ *
+ * recursiveIterate(parent, item => {
+ *     result.push(item.name);
+ * });
+ *
+ * result // => ['child1', 'grandchild1', 'grandchild2', 'child2', 'grandchild3']
+ * ```
  * @author lxm
  * @date 2023-04-23 09:07:06
  * @export
@@ -30,6 +53,25 @@ type ICompareOpts = Partial<typeof CompareOpts> & {
 };
 /**
  * 递归查找子元素
+ *
+ * @description 递归查找子元素 用法：传入数组和查找条件 返回值匹配的子元素或undefined
+ * @example
+ * ```
+ *  const parent = {
+ *      name: 'parent',
+ *      children: [
+ *          {
+ *              name: 'child1',
+ *              children: [{ name: 'grandchild1' }, { name: 'grandchild2' }],
+ *          },
+ *          { name: 'child2', children: [{ name: 'grandchild3' }] },
+ *      ],
+ *  };
+ *
+ *  const result = findRecursiveChild(parent, 'child1');
+ *
+ *  result // => { name: 'child1', children: [{ name: 'grandchild1' }, { name: 'grandchild2' }] }
+ * ```
  * @author lxm
  * @date 2023-04-20 08:53:35
  * @export

package/out/utils/recursive/find-recursive-child.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-recursive-child.d.ts","sourceRoot":"","sources":["../../../src/utils/recursive/find-recursive-child.ts"],"names":[],"mappings":"AAGA,aAAa;AACb,QAAA,MAAM,WAAW;IACf,cAAc;;CAEf,CAAC;AA0CF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,GAAG,IAAI,EACvC,IAAI,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,GACjC,IAAI,CAQN;AAED,aAAa;AACb,QAAA,MAAM,WAAW;IAEf,YAAY;;IAtEZ,cAAc;;CAwEf,CAAC;AAEF,KAAK,YAAY,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,GAAG;IAChD;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC;CACd,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,EACb,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,YAAY,GAClB,KAAK,GAAG,SAAS,CA0BnB"}
+{"version":3,"file":"find-recursive-child.d.ts","sourceRoot":"","sources":["../../../src/utils/recursive/find-recursive-child.ts"],"names":[],"mappings":"AAGA,aAAa;AACb,QAAA,MAAM,WAAW;IACf,cAAc;;CAEf,CAAC;AA0CF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,GAAG,IAAI,EACvC,IAAI,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,GACjC,IAAI,CAQN;AAED,aAAa;AACb,QAAA,MAAM,WAAW;IAEf,YAAY;;IA7FZ,cAAc;;CA+Ff,CAAC;AAEF,KAAK,YAAY,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,GAAG;IAChD;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,EACb,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,YAAY,GAClB,KAAK,GAAG,SAAS,CA0BnB"}

package/out/utils/recursive/find-recursive-child.js

@@ -40,6 +40,29 @@ function _recursiveIterate(parent, callback, opts) {
 }
 /**
  * 递归遍历子元素
+ *
+ * @description 递归遍历子元素 用法：传入数组和回调函数 无返回值
+ * @example
+ * ```
+ * const parent = {
+ *       name: 'parent',
+ *       children: [
+ *           {
+ *               name: 'child1',
+ *               children: [{ name: 'grandchild1' }, { name: 'grandchild2' }],
+ *           },
+ *           { name: 'child2', children: [{ name: 'grandchild3' }] },
+ *       ],
+ *    };
+ *
+ * const result: string[] = [];
+ *
+ * recursiveIterate(parent, item => {
+ *     result.push(item.name);
+ * });
+ *
+ * result // => ['child1', 'grandchild1', 'grandchild2', 'child2', 'grandchild3']
+ * ```
  * @author lxm
  * @date 2023-04-23 09:07:06
  * @export
@@ -63,6 +86,25 @@ const CompareOpts = Object.assign(Object.assign({}, IterateOpts), {
     compareField: 'name' });
 /**
  * 递归查找子元素
+ *
+ * @description 递归查找子元素 用法：传入数组和查找条件 返回值匹配的子元素或undefined
+ * @example
+ * ```
+ *  const parent = {
+ *      name: 'parent',
+ *      children: [
+ *          {
+ *              name: 'child1',
+ *              children: [{ name: 'grandchild1' }, { name: 'grandchild2' }],
+ *          },
+ *          { name: 'child2', children: [{ name: 'grandchild3' }] },
+ *      ],
+ *  };
+ *
+ *  const result = findRecursiveChild(parent, 'child1');
+ *
+ *  result // => { name: 'child1', children: [{ name: 'grandchild1' }, { name: 'grandchild2' }] }
+ * ```
  * @author lxm
  * @date 2023-04-20 08:53:35
  * @export

package/out/utils/string-util/string-util.d.ts

@@ -26,6 +26,12 @@ export declare class StringUtil {
     /**
      * 填充字符串中的数据
      *
+     * @description 填充字符串中的数据 用法：传入需要替换的字符串和对象 返回值是string类型
+     * @example
+     * ```
+     * StringUtil.fill('姓名:${context.name},年龄:${data.age}', { name: '张三', age: 10 }, { name: '李四', age: 25 }); // => '姓名:张三,年龄:25'
+     * StringUtil.fill('', { name: '张三', age: 10 }, { name: '李四', age: 25 }); // => ''
+     * ```
      * @author chitanda
      * @date 2021-04-23 20:04:17
      * @static

package/out/utils/string-util/string-util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-util.d.ts","sourceRoot":"","sources":["../../../src/utils/string-util/string-util.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,SAAgD;IAEjE;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,SAA6C;IAE3D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM;CAmBnE"}
+{"version":3,"file":"string-util.d.ts","sourceRoot":"","sources":["../../../src/utils/string-util/string-util.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,SAAgD;IAEjE;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,SAA6C;IAE3D;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM;CAmBnE"}

package/out/utils/string-util/string-util.js

@@ -11,6 +11,12 @@ export class StringUtil {
     /**
      * 填充字符串中的数据
      *
+     * @description 填充字符串中的数据 用法：传入需要替换的字符串和对象 返回值是string类型
+     * @example
+     * ```
+     * StringUtil.fill('姓名:${context.name},年龄:${data.age}', { name: '张三', age: 10 }, { name: '李四', age: 25 }); // => '姓名:张三,年龄:25'
+     * StringUtil.fill('', { name: '张三', age: 10 }, { name: '李四', age: 25 }); // => ''
+     * ```
      * @author chitanda
      * @date 2021-04-23 20:04:17
      * @static

package/out/utils/sync/await-timeout.d.ts

@@ -1,6 +1,12 @@
 /**
  * 设置延迟wait毫米后执行fun方法，返回fun的返回值
  *
+ * @description 设置延迟wait毫米后执行fun方法 用法：传入等待时间，函数和参数 返回fun的返回值
+ * @example
+ * ```
+ * awaitTimeout(100, () => 'Hello, World!'); // => 'Hello, World!'
+ * awaitTimeout(100, (name: string) => `Hello, ${name}!`, ['John']); // => 'Hello, John!'
+ * ```
  * @author lxm
  * @date 2023-03-06 08:20:57
  * @export

package/out/utils/sync/await-timeout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"await-timeout.d.ts","sourceRoot":"","sources":["../../../src/utils/sync/await-timeout.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,EAChE,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,CAAC,EACP,MAAM,CAAC,EAAE,GAAG,EAAE,GACb,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CASpC"}
+{"version":3,"file":"await-timeout.d.ts","sourceRoot":"","sources":["../../../src/utils/sync/await-timeout.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,EAChE,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,CAAC,EACP,MAAM,CAAC,EAAE,GAAG,EAAE,GACb,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CASpC"}

package/out/utils/sync/await-timeout.js

@@ -2,6 +2,12 @@
 /**
  * 设置延迟wait毫米后执行fun方法，返回fun的返回值
  *
+ * @description 设置延迟wait毫米后执行fun方法 用法：传入等待时间，函数和参数 返回fun的返回值
+ * @example
+ * ```
+ * awaitTimeout(100, () => 'Hello, World!'); // => 'Hello, World!'
+ * awaitTimeout(100, (name: string) => `Hello, ${name}!`, ['John']); // => 'Hello, John!'
+ * ```
  * @author lxm
  * @date 2023-03-06 08:20:57
  * @export

package/out/utils/types/types.d.ts

@@ -13,7 +13,9 @@ export type PartialWithObject<T, U> = {
 /**
  * 从T里面只获取索引类型为string的键
  */
-export type StrKeyOf<T> = Extract<keyof T, string>;
+export type StrKeyOf<T> = {
+    [K in keyof T]: T[K] extends string ? K : never;
+}[keyof T];
 /**
  * 构造函数接口，声明一个返回对象是T的构造函数，不传则返回类型是any
  */

package/out/utils/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types/types.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,IAAI;KACnC,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACpC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types/types.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,IAAI;KACnC,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACpC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK;CAChD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC"}

package/out/utils/util/util.d.ts

@@ -10,6 +10,12 @@ export declare function getToken(): string | null;
 /**
  * 判断两个数组是否有相同的元素
  *
+ * @description 判断两个数组是否有相同的元素, 用法: 传入两个数组 返回值为boolean类型
+ * @example
+ * ```
+ * isOverlap([1, 2, 3], [3, 4, 5]) // => true
+ * isOverlap([1, 2, 3], [4, 5, 6]) // => false
+ * ```
  * @author lxm
  * @date 2022-09-20 19:09:29
  * @export
@@ -20,6 +26,11 @@ export declare function getToken(): string | null;
 export declare function isOverlap(arr1: any[], arr2: any[]): boolean;
 /**
  * 是否元素相同
+ *
+ * @description 判断两个数组是否元素相同, 用法：传入需要判断的数组 返回值是boolean类型
+ * @example
+ * isOverlap([1, 2, 3], [1, 2, 3]) // => true
+ * isOverlap([{ test1: 1, test2: 2, test3: 3 }, { test1: 2, test2: 2, test3: 3 }], [{ test1: 1, test2: 2, test3: 3 }, { test1: 2, test2: 2, test3: 3 }], 'test1') // => true
  * @author lxm
  * @date 2023-05-22 12:50:53
  * @export
@@ -33,6 +44,30 @@ export declare function isElementSame(arr1: any[], arr2: any[], field?: string):
  * 防抖并合并每次的参数，
  * 最后一次才会执行
  *
+ * @description 防抖并合并每次的参数，最后一次才会执行 用法：传入要防抖的函数和合并参数函数 有需要又可以传入时间 返回防抖函数执行值
+ * @example
+ * ```
+ * // 定义测试函数
+ * function testFunc(a, b) {
+ *   console.log(`testFunc called with (${a}, ${b})`);
+ * }
+ *
+ * function testMerge(oldParams, newParams) {
+ *   // 将相邻的重复函数调用合并为一个函数调用，只取第一个参数 a，第二个参数 b 取最后一次调用时的值
+ *   const [a] = oldParams;
+ *   const [, b] = newParams;
+ *   return [a, b];
+ * }
+ *
+ * // 创建一个节流后的函数
+ * const debouncedTestFunc = debounceAndMerge(testFunc, testMerge, 1000);
+ *
+ * // 连续调用多次，但只会在最后一次调用时输出
+ * debouncedTestFunc(1, 2);
+ * debouncedTestFunc(2, 3);
+ * debouncedTestFunc(3, 4);
+ * debouncedTestFunc(4, 5); // testFunc called with (1, 5)
+ * ```
  * @author lxm
  * @date 2022-09-20 21:09:53
  * @export
@@ -50,6 +85,44 @@ export declare function debounceAndMerge<T extends (...args: any[]) => any>(func
  * 防抖并合并每次的参数，最后一次才会执行
  * 绑定方法为异步方法，给每次调用返回最终执行那次的结果
  *
+ * @description 防抖并合并每次的参数，最后一次才会执行,绑定方法为异步方法，给每次调用返回最终执行那次的结果 用法：传入要防抖的函数和合并参数函数 返回Promise
+ * @example
+ * ```
+ * // 定义一个异步函数
+ * async function logData(params) {
+ *   return new Promise(resolve => {
+ *     setTimeout(() => {
+ *       resolve(params);
+ *     }, 1000);
+ *   });
+ * }
+ *
+ * // 定义合并参数的函数，每次只保留最后一次的参数
+ * function mergeParams(oldParams, newParams) {
+ *   return newParams;
+ * }
+ *
+ * // 创建防抖函数
+ * const debouncedLogData = debounceAndAsyncMerge(logData, mergeParams, 500);
+ *
+ * // 模拟连续3次调用
+ * debouncedLogData('a').then(result => {
+ *   console.log('Result of first call:', result); // => Result of first call: c
+ * });
+ * debouncedLogData('b').then(result => {
+ *   console.log('Result of second call:', result); // => Result of first call: c
+ * });
+ * debouncedLogData('c').then(result => {
+ *   console.log('Result of third call:', result); // => Result of first call: c
+ * });
+ *
+ * // 等待 2000 毫秒后再次调用，会再次输出
+ * setTimeout(() => {
+ *   debouncedLogData('d').then(result => {
+ *     console.log('Result of fourth call:', result); // => Result of fourth call: d
+ *   });
+ * }, 2000);
+ * ```
  * @author lxm
  * @date 2022-09-20 21:09:53
  * @export
@@ -65,6 +138,13 @@ export declare function debounceAndMerge<T extends (...args: any[]) => any>(func
 export declare function debounceAndAsyncMerge<T extends (...args: any[]) => Promise<any>>(func: T, mergeFunc: (oldParams: Parameters<T>, newParams: Parameters<T>) => Parameters<T>, wait?: number): T;
 /**
  * 把右侧的对象里非空的属性合并到左侧对象里
+ *
+ * @description 把右侧的对象里非空的属性合并到左侧对象里， 用法：传入需要合并的数组 无返回值
+ * @example
+ * ```
+ * obj1 = { a: 1, b: 2 }; obj2 = { c: null, d: false, e: undefined, f: 0, g: {} }; mergeInLeft(obj1, obj2); // => obj1 修改为 { a: 1, b: 2, d: false, f: 0, g: {} }
+ * obj1 = { a: 1, b: 2 }; obj2 = { a: 2, b: 3, c: null, d: false, e: undefined, f: 0, g: {} }; // => obj1 修改为 { a: 2, b: 3, d: false, f: 0, g: {} }
+ * ```
  * @author lxm
  * @date 2023-05-16 02:23:39
  * @param {IData} l
@@ -74,6 +154,12 @@ export declare function mergeInLeft(l: IData, r: IData): void;
 /**
  * 把右侧的对象里非空的属性合并到左侧对象属性为空里
  *
+ * @description 把右侧的对象里非空的属性合并到左侧对象属性为空里, 用法：传入需要合并的数组 无返回值
+ * @example
+ * ```
+ * obj1 = { a: 1, b: 2 }; obj2 = { c: null, d: false, e: undefined, f: 0, g: {} }; mergeInLeft(obj1, obj2); // => obj1 修改为 { a: 1, b: 2, d: false, f: 0, g: {} }
+ * obj1 = { a: 1, b: 2 }; obj2 = { a: 2, b: 3, c: null, d: false, e: undefined, f: 0, g: {} }; // => obj1 修改为 { a: 1, b: 2, d: false, f: 0, g: {} }
+ * ```
  * @author zk
  * @date 2023-06-01 02:06:36
  * @export
@@ -83,6 +169,15 @@ export declare function mergeInLeft(l: IData, r: IData): void;
 export declare function mergeDefaultInLeft(l: IData, r: IData): void;
 /**
  * 比较两个数组集合，找出相同和不同的元素
+ *
+ * @description 比较两个数组集合，找出相同和不同的元素 用法：传入需要比较的两个数组  返回值是{more: IData[], less: IData[], same: IData[]}
+ * @example
+ * ```
+ * 数组中没有引用对象
+ * compareArr([1, 2, false, true, undefined, null],  [1, false, undefined]); // => {more: [2, true, null], less: [], same: [1, false, undefined]}
+ * 数组中有引用对象
+ * compareArr([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }], [{ id: 2, name: 'Jane' }, { id: 3, name: 'Bob' }], 'id') // => {more: [{ id: 1, name: 'John' }],  less: [{ id: 3, name: 'Bob' }], same: [{ id: 2, name: 'Jane' }, { id: 2, name: 'Jane' }]}
+ * ```
  * @author lxm
  * @date 2023-05-29 12:33:55
  * @export
@@ -104,6 +199,13 @@ export declare function compareArr(arr1: IData[], arr2: IData[], keyField?: stri
  * 转换为数字或undefined
  * - 如果是undefined或null 返回undefined
  * - 其他情况转成数字，能转成数字的返回数字，NaN的返回undefined
+ *
+ * @description 转换为数字或undefined,如果是undefined或null 返回undefined,其他情况转成数字，能转成数字的返回数字，NaN的返回undefined 用法：传入任意值 返回值为number或undefined类型
+ * @example
+ * ```
+ * toNumberOrNil(5); // => 5
+ * toNumberOrNil(undefined); // => undefined
+ * ```
  * @author lxm
  * @date 2023-06-08 06:30:57
  * @param {unknown} value 值
@@ -112,6 +214,13 @@ export declare function compareArr(arr1: IData[], arr2: IData[], keyField?: stri
 export declare function toNumberOrNil(value: unknown): number | undefined;
 /**
  * 判断字符串是否是svg的格式
+ *
+ * @description 判断字符串是否是svg的格式 用法：传入svg字符串 返回值为Boolean类型
+ * @example
+ * ```
+ * isSvg('<svg xmlns="http://www.w3.org/2000/svg"><rect x="10" y="10" width="100" height="100" fill="red" /></svg>'); // => true
+ * isSvg('<svg1 xmlns="http://www.w3.org/2000/svg"><rect x="10" y="10" width="100" height="100" fill="red" /></svg1>'); // => false
+ * ```
  * @author lxm
  * @date 2023-10-17 02:04:28
  * @export
@@ -121,6 +230,13 @@ export declare function toNumberOrNil(value: unknown): number | undefined;
 export declare function isSvg(str: string): boolean;
 /**
  * 处理浮点数相加
+ *
+ * @description 处理浮点数相加 用法：传入需要相加的数值 返回值为number类型
+ * @example
+ * ```
+ * plus(10, 10); // => 20
+ * plus(99.99, -99.999); // => -0.009
+ * ```
  * @param {number} a
  * @param {number} b
  * @return {*}
@@ -131,6 +247,13 @@ export declare function plus(a: number, b: number): number;
 /**
  * 根据给定的属性名称集合，
  * 查看目标对象是否具有该属性，如果没有设置undefined的定义
+ *
+ * @description 根据给定的属性名称集合，查看目标对象是否具有该属性，如果没有设置undefined的定义 ，用法：传入对象和字符串 无返回值
+ * @example
+ * ```
+ * obj = { a: '' }; updateKeyDefine(obj, ['b']);  // =>  obj 修改为 {a: '', b: undefined}
+ * obj = { a: '' }; updateKeyDefine(obj, ['a', 'b']) // => obj 修改为 {a: '', b: undefined}
+ * ```
  * @author lxm
  * @date 2023-12-20 05:21:47
  * @export
@@ -140,6 +263,13 @@ export declare function plus(a: number, b: number): number;
 export declare function updateKeyDefine(target: IParams, keys: (string | symbol)[]): void;
 /**
  * 判断字符串是否为Base64图片格式
+ *
+ * @description 判断字符串是否为Base64图片格式, 用法传入字符串 返回值为boolean类型
+ * @example
+ * ```
+ * isBase64Image('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAmklEQVQ4T2NkoBAwUqifYt4q8ogcCQ3NjY2BgYGBgZmBgY9oRk5Ojy8vLz8+PjQ2NjYGBgYGBhZmBggcCQ3NjY2BgYGhnb4FlDyECYAw6fQGp7QUhYGAQ0AC8Dtdu4AxsAAAAAElFTkSuQmCC'); // => true
+ * isBase64Image('data:image/png;,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAmklEQVQ4T2NkoBAwUqifYt4q8ogcCQ3NjY2BgYGBgZmBgY9oRk5Ojy8vLz8+PjQ2NjYGBgYGBhZmBggcCQ3NjY2BgYGhnb4FlDyECYAw6fQGp7QUhYGAQ0AC8Dtdu4AxsAAAAAElFTkSuQmCC'); // => false
+ * ```
  * @param {string} str
  * @return {*}
  * @author: zhujiamin
@@ -148,6 +278,13 @@ export declare function updateKeyDefine(target: IParams, keys: (string | symbol)
 export declare function isBase64Image(str: string): boolean;
 /**
  * 计算各种视图打开方式的样式
+ *
+ * @description 用于计算各种视图打开方式的样式， 用法：传入数值和视图类型 返回值为number或string类型
+ * @example
+ * ```
+ * calcOpenModeStyle(0, 'drawer'); // => '0%'
+ * calcOpenModeStyle(150, 'drawer'); // => 150
+ * ```
  * @param {number} value
  * @return {*}
  * @author: zhujiamin

package/out/utils/util/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/utils/util/util.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAExC;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAG3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,GAAG,EAAE,EACX,IAAI,EAAE,GAAG,EAAE,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAUT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChE,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,CACT,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,KACrB,UAAU,CAAC,CAAC,CAAC,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAiBjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAE1C,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,CACT,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,KACrB,UAAU,CAAC,CAAC,CAAC,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,CAAC,CAoCH;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAMpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAM3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,KAAK,EAAE,EACb,IAAI,EAAE,KAAK,EAAE,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB;IACD,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,IAAI,EAAE,KAAK,EAAE,CAAC;CACf,CAuCA;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAShE;AAID;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAejD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACxB,IAAI,CAWN;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GACnC,MAAM,GAAG,MAAM,CAUjB"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/utils/util/util.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAExC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAG3D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,GAAG,EAAE,EACX,IAAI,EAAE,GAAG,EAAE,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAUT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChE,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,CACT,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,KACrB,UAAU,CAAC,CAAC,CAAC,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAiBjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAE1C,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,CACT,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,KACrB,UAAU,CAAC,CAAC,CAAC,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,CAAC,CAoCH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAMpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAM3D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,KAAK,EAAE,EACb,IAAI,EAAE,KAAK,EAAE,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB;IACD,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,IAAI,EAAE,KAAK,EAAE,CAAC;CACf,CAuCA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAShE;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAejD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACxB,IAAI,CAWN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GACnC,MAAM,GAAG,MAAM,CAUjB"}

package/out/utils/util/util.js

@@ -17,6 +17,12 @@ export function getToken() {
 /**
  * 判断两个数组是否有相同的元素
  *
+ * @description 判断两个数组是否有相同的元素, 用法: 传入两个数组 返回值为boolean类型
+ * @example
+ * ```
+ * isOverlap([1, 2, 3], [3, 4, 5]) // => true
+ * isOverlap([1, 2, 3], [4, 5, 6]) // => false
+ * ```
  * @author lxm
  * @date 2022-09-20 19:09:29
  * @export
@@ -30,6 +36,11 @@ export function isOverlap(arr1, arr2) {
 }
 /**
  * 是否元素相同
+ *
+ * @description 判断两个数组是否元素相同, 用法：传入需要判断的数组 返回值是boolean类型
+ * @example
+ * isOverlap([1, 2, 3], [1, 2, 3]) // => true
+ * isOverlap([{ test1: 1, test2: 2, test3: 3 }, { test1: 2, test2: 2, test3: 3 }], [{ test1: 1, test2: 2, test3: 3 }, { test1: 2, test2: 2, test3: 3 }], 'test1') // => true
  * @author lxm
  * @date 2023-05-22 12:50:53
  * @export
@@ -52,6 +63,30 @@ export function isElementSame(arr1, arr2, field) {
  * 防抖并合并每次的参数，
  * 最后一次才会执行
  *
+ * @description 防抖并合并每次的参数，最后一次才会执行 用法：传入要防抖的函数和合并参数函数 有需要又可以传入时间 返回防抖函数执行值
+ * @example
+ * ```
+ * // 定义测试函数
+ * function testFunc(a, b) {
+ *   console.log(`testFunc called with (${a}, ${b})`);
+ * }
+ *
+ * function testMerge(oldParams, newParams) {
+ *   // 将相邻的重复函数调用合并为一个函数调用，只取第一个参数 a，第二个参数 b 取最后一次调用时的值
+ *   const [a] = oldParams;
+ *   const [, b] = newParams;
+ *   return [a, b];
+ * }
+ *
+ * // 创建一个节流后的函数
+ * const debouncedTestFunc = debounceAndMerge(testFunc, testMerge, 1000);
+ *
+ * // 连续调用多次，但只会在最后一次调用时输出
+ * debouncedTestFunc(1, 2);
+ * debouncedTestFunc(2, 3);
+ * debouncedTestFunc(3, 4);
+ * debouncedTestFunc(4, 5); // testFunc called with (1, 5)
+ * ```
  * @author lxm
  * @date 2022-09-20 21:09:53
  * @export
@@ -86,6 +121,44 @@ export function debounceAndMerge(func, mergeFunc, wait) {
  * 防抖并合并每次的参数，最后一次才会执行
  * 绑定方法为异步方法，给每次调用返回最终执行那次的结果
  *
+ * @description 防抖并合并每次的参数，最后一次才会执行,绑定方法为异步方法，给每次调用返回最终执行那次的结果 用法：传入要防抖的函数和合并参数函数 返回Promise
+ * @example
+ * ```
+ * // 定义一个异步函数
+ * async function logData(params) {
+ *   return new Promise(resolve => {
+ *     setTimeout(() => {
+ *       resolve(params);
+ *     }, 1000);
+ *   });
+ * }
+ *
+ * // 定义合并参数的函数，每次只保留最后一次的参数
+ * function mergeParams(oldParams, newParams) {
+ *   return newParams;
+ * }
+ *
+ * // 创建防抖函数
+ * const debouncedLogData = debounceAndAsyncMerge(logData, mergeParams, 500);
+ *
+ * // 模拟连续3次调用
+ * debouncedLogData('a').then(result => {
+ *   console.log('Result of first call:', result); // => Result of first call: c
+ * });
+ * debouncedLogData('b').then(result => {
+ *   console.log('Result of second call:', result); // => Result of first call: c
+ * });
+ * debouncedLogData('c').then(result => {
+ *   console.log('Result of third call:', result); // => Result of first call: c
+ * });
+ *
+ * // 等待 2000 毫秒后再次调用，会再次输出
+ * setTimeout(() => {
+ *   debouncedLogData('d').then(result => {
+ *     console.log('Result of fourth call:', result); // => Result of fourth call: d
+ *   });
+ * }, 2000);
+ * ```
  * @author lxm
  * @date 2022-09-20 21:09:53
  * @export
@@ -138,6 +211,13 @@ export function debounceAndAsyncMerge(func, mergeFunc, wait) {
 }
 /**
  * 把右侧的对象里非空的属性合并到左侧对象里
+ *
+ * @description 把右侧的对象里非空的属性合并到左侧对象里， 用法：传入需要合并的数组 无返回值
+ * @example
+ * ```
+ * obj1 = { a: 1, b: 2 }; obj2 = { c: null, d: false, e: undefined, f: 0, g: {} }; mergeInLeft(obj1, obj2); // => obj1 修改为 { a: 1, b: 2, d: false, f: 0, g: {} }
+ * obj1 = { a: 1, b: 2 }; obj2 = { a: 2, b: 3, c: null, d: false, e: undefined, f: 0, g: {} }; // => obj1 修改为 { a: 2, b: 3, d: false, f: 0, g: {} }
+ * ```
  * @author lxm
  * @date 2023-05-16 02:23:39
  * @param {IData} l
@@ -153,6 +233,12 @@ export function mergeInLeft(l, r) {
 /**
  * 把右侧的对象里非空的属性合并到左侧对象属性为空里
  *
+ * @description 把右侧的对象里非空的属性合并到左侧对象属性为空里, 用法：传入需要合并的数组 无返回值
+ * @example
+ * ```
+ * obj1 = { a: 1, b: 2 }; obj2 = { c: null, d: false, e: undefined, f: 0, g: {} }; mergeInLeft(obj1, obj2); // => obj1 修改为 { a: 1, b: 2, d: false, f: 0, g: {} }
+ * obj1 = { a: 1, b: 2 }; obj2 = { a: 2, b: 3, c: null, d: false, e: undefined, f: 0, g: {} }; // => obj1 修改为 { a: 1, b: 2, d: false, f: 0, g: {} }
+ * ```
  * @author zk
  * @date 2023-06-01 02:06:36
  * @export
@@ -168,6 +254,15 @@ export function mergeDefaultInLeft(l, r) {
 }
 /**
  * 比较两个数组集合，找出相同和不同的元素
+ *
+ * @description 比较两个数组集合，找出相同和不同的元素 用法：传入需要比较的两个数组  返回值是{more: IData[], less: IData[], same: IData[]}
+ * @example
+ * ```
+ * 数组中没有引用对象
+ * compareArr([1, 2, false, true, undefined, null],  [1, false, undefined]); // => {more: [2, true, null], less: [], same: [1, false, undefined]}
+ * 数组中有引用对象
+ * compareArr([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }], [{ id: 2, name: 'Jane' }, { id: 3, name: 'Bob' }], 'id') // => {more: [{ id: 1, name: 'John' }],  less: [{ id: 3, name: 'Bob' }], same: [{ id: 2, name: 'Jane' }, { id: 2, name: 'Jane' }]}
+ * ```
  * @author lxm
  * @date 2023-05-29 12:33:55
  * @export
@@ -223,6 +318,13 @@ export function compareArr(arr1, arr2, keyField) {
  * 转换为数字或undefined
  * - 如果是undefined或null 返回undefined
  * - 其他情况转成数字，能转成数字的返回数字，NaN的返回undefined
+ *
+ * @description 转换为数字或undefined,如果是undefined或null 返回undefined,其他情况转成数字，能转成数字的返回数字，NaN的返回undefined 用法：传入任意值 返回值为number或undefined类型
+ * @example
+ * ```
+ * toNumberOrNil(5); // => 5
+ * toNumberOrNil(undefined); // => undefined
+ * ```
  * @author lxm
  * @date 2023-06-08 06:30:57
  * @param {unknown} value 值
@@ -241,6 +343,13 @@ export function toNumberOrNil(value) {
 const SvgPattern = /<svg\b[^>]*>[\s\S]*?<\/svg>/;
 /**
  * 判断字符串是否是svg的格式
+ *
+ * @description 判断字符串是否是svg的格式 用法：传入svg字符串 返回值为Boolean类型
+ * @example
+ * ```
+ * isSvg('<svg xmlns="http://www.w3.org/2000/svg"><rect x="10" y="10" width="100" height="100" fill="red" /></svg>'); // => true
+ * isSvg('<svg1 xmlns="http://www.w3.org/2000/svg"><rect x="10" y="10" width="100" height="100" fill="red" /></svg1>'); // => false
+ * ```
  * @author lxm
  * @date 2023-10-17 02:04:28
  * @export
@@ -252,6 +361,13 @@ export function isSvg(str) {
 }
 /**
  * 处理浮点数相加
+ *
+ * @description 处理浮点数相加 用法：传入需要相加的数值 返回值为number类型
+ * @example
+ * ```
+ * plus(10, 10); // => 20
+ * plus(99.99, -99.999); // => -0.009
+ * ```
  * @param {number} a
  * @param {number} b
  * @return {*}
@@ -279,6 +395,13 @@ export function plus(a, b) {
 /**
  * 根据给定的属性名称集合，
  * 查看目标对象是否具有该属性，如果没有设置undefined的定义
+ *
+ * @description 根据给定的属性名称集合，查看目标对象是否具有该属性，如果没有设置undefined的定义 ，用法：传入对象和字符串 无返回值
+ * @example
+ * ```
+ * obj = { a: '' }; updateKeyDefine(obj, ['b']);  // =>  obj 修改为 {a: '', b: undefined}
+ * obj = { a: '' }; updateKeyDefine(obj, ['a', 'b']) // => obj 修改为 {a: '', b: undefined}
+ * ```
  * @author lxm
  * @date 2023-12-20 05:21:47
  * @export
@@ -299,6 +422,13 @@ export function updateKeyDefine(target, keys) {
 }
 /**
  * 判断字符串是否为Base64图片格式
+ *
+ * @description 判断字符串是否为Base64图片格式, 用法传入字符串 返回值为boolean类型
+ * @example
+ * ```
+ * isBase64Image('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAmklEQVQ4T2NkoBAwUqifYt4q8ogcCQ3NjY2BgYGBgZmBgY9oRk5Ojy8vLz8+PjQ2NjYGBgYGBhZmBggcCQ3NjY2BgYGhnb4FlDyECYAw6fQGp7QUhYGAQ0AC8Dtdu4AxsAAAAAElFTkSuQmCC'); // => true
+ * isBase64Image('data:image/png;,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAmklEQVQ4T2NkoBAwUqifYt4q8ogcCQ3NjY2BgYGBgZmBgY9oRk5Ojy8vLz8+PjQ2NjYGBgYGBhZmBggcCQ3NjY2BgYGhnb4FlDyECYAw6fQGp7QUhYGAQ0AC8Dtdu4AxsAAAAAElFTkSuQmCC'); // => false
+ * ```
  * @param {string} str
  * @return {*}
  * @author: zhujiamin
@@ -310,6 +440,13 @@ export function isBase64Image(str) {
 }
 /**
  * 计算各种视图打开方式的样式
+ *
+ * @description 用于计算各种视图打开方式的样式， 用法：传入数值和视图类型 返回值为number或string类型
+ * @example
+ * ```
+ * calcOpenModeStyle(0, 'drawer'); // => '0%'
+ * calcOpenModeStyle(150, 'drawer'); // => 150
+ * ```
  * @param {number} value
  * @return {*}
  * @author: zhujiamin