amos-apptool 1.1.0 → 1.2.1

package/index.d.ts

@@ -11,12 +11,12 @@ export class Base64 {
   constructor();
   /**
    * 加密字符串
-   * @param input
+   * @param input 待加密的字符串
    */
   encode(input: string): string;
   /**
    * 解密字符串
-   * @param input
+   * @param input 待解密的字符串
    */
   decode(input: string): string;
 }
@@ -28,7 +28,7 @@ export class Base64 {
 declare namespace DES {
   /**
    * 加密字符串
-   * @param data
+   * @param data 待加密字符串
    * @param secretKey 秘钥，支持单秘钥以及二级和三级秘钥 `abcde` 和 `a,b` 和 `a,b,c` 等
    * @example
    *   DES.encode('hello', 'test'); // DES.DesCore.encode(data, 'test');
@@ -39,70 +39,97 @@ declare namespace DES {
   export function encode(data: string, secretKey: string): string;
   /**
    * 解密字符串
-   * @param data
-   * @param secretKey
+   * @param data 待解密字符串
+   * @param secretKey 解密秘钥
    */
   export function decode(data: string, secretKey: string): string;
 }
 
-
-export function simpleClone(o: object | Array<any>): object | Array<any>;
-export function clone(o: any): object | Array<any>;
-export function cloneAll(o: any): any;
-
+export function simpleClone<T extends object | any[]>(o: T): T;
+export function clone<T>(o: T): T extends object | any[] ? T : T;
+export function cloneAll<T>(o: T): T;
 
 declare namespace UUID {
   /**
-   *
+   * 生成UUID
    * @param len uuid 的字符长度
    * @param radix 位数，默认为 62
    * @example
    *  UUID.uuid(); // 7ED03492-919F-40D0-89D2-C53194F4A83D
    */
-  export function uuid(len: number, radix: number): string;
+  export function uuid(len?: number, radix?: number): string;
   /**
+   * 快速生成UUID
    * @example
    * UUID.uuidFast(); // E581CCDD-189C-482D-BE21-620863F423F9
    */
   export function uuidFast(): string;
   /**
+   * 生成紧凑格式UUID
    * @example
    * UUID.uuidCompact(); // 090c3e83-ea67-45c4-b7dc-47c20eaea91e
    */
   export function uuidCompact(): string;
   /**
    * 获取 uid，以 Date.now() 为随机参照值
-   * @param flag 是否显示短杠，为 true 则去掉单杠
+   * @param flag 是否显示短杠，为 true 则去掉短杠
    * @example
    * UUID.uuidTime(); // 6fcac0c8-e7de-44e4-ada7-c1de03a45ad5
    * UUID.uuidTime(true); // 5eb47f42a03c48e6ae6804a2517a1db4
    */
-  export function uuidTime(flag: boolean): string;
+  export function uuidTime(flag?: boolean): string;
   /**
-   * @param prefix
+   * 生成带时间戳的UUID
+   * @param prefix 前缀
    * @example
    * UUID.timeUUID(); // amos-timeuuid-1663831567208-1
    */
-  export function timeUUID(prefix: string): string;
+  export function timeUUID(prefix?: string): string;
   /**
-   * @param prefix
+   * 生成长格式带时间戳的UUID
+   * @param prefix 前缀
    * @example
    * UUID.longTimeUUID(); // longtime-202209221526-1
    */
-  export function longTimeUUID(prefix: string): string;
+  export function longTimeUUID(prefix?: string): string;
   /**
-   *
-   * @param tpl
+   * 生成自定义格式UUID
+   * @param tpl 模板字符串
    * @example
    * UUID.otherUUID(); // 6afe5aaf614eb8b00bf4bcd11a
    */
-  export function otherUUID(tpl: string): string;
+  export function otherUUID(tpl?: string): string;
 }
 
 declare namespace pwdPolicy {
-  export function normalPolicy(password: string): object;
-  export function advancePolicy(password: string, secretKey: string): object;
-  export function useMd5Policy(password: string, secretKey: string): object;
+  export interface PasswordPolicyResult {
+    password: string;
+    secretKey: string;
+  }
+
+  /**
+   * 普通密码生成策略
+   * @param password
+   */
+  export function normalPolicy(password: string): PasswordPolicyResult;
+  /**
+   * 密码生成策略
+   * @param password 密码
+   * @param secretKey 秘钥
+   */
+  export function advancePolicy(password: string, secretKey: string): PasswordPolicyResult;
+  /**
+   * 采用MD5生成密码
+   * @param password
+   * @param secretKey
+   */
+  export function useMd5Policy(password: string, secretKey: string): PasswordPolicyResult;
+  /**
+   * 采用MD5生成密码
+   * @param password
+   * @param secretKey
+   */
+  export function useMd5Policy2(password: string, secretKey: string): PasswordPolicyResult;
 }
 
 declare namespace random {
@@ -110,145 +137,177 @@ declare namespace random {
   export function randomInt(min: number, max: number): number;
 }
 
-
 declare namespace strUtils {
   /**
    * 首字母大写
-   * @param str
+   * @param str 目标字符串
    */
   export function toCapitalStr(str: string): string;
+
   /**
    * 驼峰化, 仅支持首字母大写、或者采用中杠连接的两个字母首字母大写
    * 如果要支持其它输入，将正则改为： /(-|(\s+)|_)(\w)/g
-   *
-   * @param {String} name
-   * @returns {String}
+   * @param name 目标字符串
+   * @returns 驼峰化后的字符串
    */
   export function camelCase(name: string): string;
+
   /**
-   * 将中缸连接的字符串 驼峰化
-   *
+   * 将中杠连接的字符串 驼峰化
+   * @example
    * hello-world => hellWorld
    * Hello-world => hellWorld
    * Hello-World => hellWorld
-   *
-   * @param {any} name
-   * @returns {String}
+   * @param name 目标字符串
+   * @returns 驼峰化后的字符串
    */
   export function transCamel(name: string): string;
+
   /**
    * 字符串首字母大写
-   * @param {String} str
-   * @returns {String}
+   * @param str 目标字符串
+   * @returns 首字母大写后的字符串
    */
-  export function capFirst(name: string): string;
+  export function capFirst(str: string): string;
+
   /**
    * 获取字符串的hashCode码
-   * @param {String} str
-   * @returns {String} string | null
+   * @param str 目标字符串
+   * @returns hashCode值或null
    */
-  export function hashCode(name: string): string;
+  export function hashCode(str: string): string | null;
+
   /**
    * 进制与单位处理
-   * @param {String | Number} value 要处理的值
-   * @param {Object} fmtOpt
-   * @param {String} fmtOpt.prefix 前缀
-   * @param {String} fmtOpt.suffix 后缀
-   * @param {Boolean} fmtOpt.selfenable 自定义进制是否启用
-   * @param {String} fmtOpt.selfscale 进制
-   * @param {String} fmtOpt.selfunit 单位
-   * @param {Number} fmtOpt.fixnumber 小数位数
-   * @param {Boolean} fmtOpt.fillzero 空位补0
-   * @param {Boolean} fmtOpt.thousandsplitchar 千分位分隔符
-   */
-  export function dealScaleAndUnit(value: string, fmtOpt: Object): string;
-  /**
-   * 转化为 utf8
-   * @param str
+   *
+   * fmtOpt 参数 字段说明
+   * - fmtOpt.prefix 前缀
+   * - fmtOpt.suffix 后缀
+   * - fmtOpt.selfenable 自定义进制是否启用
+   * - fmtOpt.selfscale 进制
+   * - fmtOpt.selfunit 单位
+   * - fmtOpt.fixnumber 小数位数
+   * - fmtOpt.fillzero 空位补0
+   * - fmtOpt.thousandsplitchar 千分位分隔符
+   * @param value 要处理的值
+   * @param fmtOpt 格式化选项
+   */
+  export function dealScaleAndUnit(
+    value: string | number,
+    fmtOpt: {
+      prefix?: string;
+      suffix?: string;
+      selfenable?: boolean;
+      selfscale?: string;
+      selfunit?: string;
+      fixnumber?: number;
+      fillzero?: boolean;
+      thousandsplitchar?: string;
+    }
+  ): string;
+
+  /**
+   * 转化为 utf8 编码
+   * @param str 目标字符串
    */
   export function toUTF8(str: string): string;
 }
 
-
 declare namespace colorUtil {
   /**
    * RGB颜色转换为16进制
-   * @param stringRgb
+   * @param stringRgb RGB/RGBA颜色字符串
    * @example
    *  toStringHexColor('rgba(241,112,19,1)'); // #f17013
    *  toStringHexColor('rgba(241,112,19, 0.1)'); // #f1701319
    */
   export function toStringHexColor(stringRgb: string): string;
+
   /**
-   * - 转化为hex颜色 （仅支持 RGB），如果是 rgba 时，则舍去 a。
-   * - 如果传入的是 key color 则直接转化为与之对应的 hex 值
-   * @param {string} stringRgb
+   * 转化为hex颜色 （仅支持 RGB），如果是 rgba 时，则舍去 a。
+   * 如果传入的是 key color 则直接转化为与之对应的 hex 值
+   * @param stringRgb RGB/RGBA颜色字符串或颜色关键字
    * @example
    *  toHexColor('rgba(241,112,19)'); // #f17013
    *  toHexColor('rgba(241,112,19, 1)'); // #f17013
    *  toHexColor('rgba(241,112,19, 0.1)'); // #f17013
    *  toHexColor('red'); // #ff0000
-   *  toHexColor(); // ''
    *  toHexColor(null); // ''
    *  toHexColor(123456); // ''
    *  toHexColor(0x123456123456); // ''
    */
-  export function toHexColor(stringRgb: string): string;
+  export function toHexColor(stringRgb?: string): string;
+
   /**
    * 16进制颜色转为RGB格式
-   * @param hexColor
+   * @param hexColor 16进制颜色字符串
    * @example
    *  toRGBcolor('#AABBCC'); // rgb(170,187,204)
    */
-  export function toRGBcolor(hexColor): string;
+  export function toRGBcolor(hexColor: string): string;
+
   /**
    * 将16进制的颜色转换为rgb
-   * @param hexColor
+   * @param hexColor 16进制颜色字符串
    * @example
    *  transformColor('#AABBCC'); // rgb(170,187,204)
    */
   export function transformColor(hexColor: string): string;
+
+  /**
+   * 判断是否是16进制颜色
+   * @param color 颜色字符串
+   */
   export function isHexColor(color: string): boolean;
+
   /**
    * 判断是否是内置 英文 color
-   * @param color
+   * @param color 颜色字符串
    * @example
    *  isKeyColor('red'); // true
-   *  isKeyColor('yellow'); // true
    *  isKeyColor('asdfasdfa'); // false
    */
   export function isKeyColor(color: string): boolean;
+
+  /**
+   * 判断是否是RGB/RGBA颜色
+   * @param color 颜色字符串
+   */
   export function isRgbColor(color: string): boolean;
+
   /**
    * 将rgb颜色转化成object
-   * @param color
+   * @param color RGB/RGBA颜色字符串
    * @example
    *  '12,12,12,12' => {r:12,g:12,b:12,a:12}
    *  'rgba(12,12,12,12)' => {r:12,g:12,b:12,a:12}
    */
   export function rgb2object(color: string): RGBA;
+
   /**
    * 将object的rgb转化成string
-   * @param color
+   * @param color RGBA对象
    * @example
    * objRGB2str({ r:1, g:1, b:1, a:1 }); // 'rgba(1,1,1,1)'
    * objRGB2str({ r:1, g:1, b:1, a:0 }); // 'rgba(1,1,1,0)'
    * objRGB2str({ r:1, g:1, b:1 }); // 'rgba(1,1,1)'
    */
-  export function objRGB2str(color: object): string;
+  export function objRGB2str(color: Partial<RGBA>): string;
+
   /**
    * key color 转化为 hex color。
    * 如果不是 key color 则直接返回 color 自身
-   * @param color
+   * @param color 颜色关键字
    */
   export function keyColorToHex(color: string): string;
+
   /**
    * 产生渐变色函数
-   * @param color
-   * @param minValue
-   * @param maxValue
+   * @param color 基础颜色
+   * @param minValue 最小值
+   * @param maxValue 最大值
    */
-  export function gradientColor(color: Object, minValue: number, maxValue: number): any;
+  export function gradientColor(color: Record<string, any>, minValue: number, maxValue: number): string | RGBA;
 }
 
 declare namespace randomColor {
@@ -257,7 +316,6 @@ declare namespace randomColor {
   export function randomHexColorStr(): string;
 }
 
-
 /**
  * 转码URL中的特殊字符
  *
@@ -271,8 +329,8 @@ declare namespace randomColor {
  * 7. '&' URL 中指定的参数间的分隔符 %26
  * 8. '=' URL 中指定参数的值 %3D
  *
- * @param url
- * @return new url
+ * @param url 原始URL
+ * @return 转码后的URL
  * @example
  *  encodeUrl('http://localhost:3000/login?user=123&pwd=123'); // http://localhost:3000/login?user%3D123%26pwd%3D123
  */
@@ -280,23 +338,77 @@ export function encodeUrl(url: string): string;
 
 /**
  * restful风格路径参数替换
- *
- * @param url
- * @param options
- * @param regexps
- *
+ * @param url 模板URL
+ * @param options 参数对象
+ * @param regexps 匹配正则
  * @example
  *  const _url = 'a/b/{id}'
  *  const url = restfulUrl(_url, { id: '123' }, [regex]); => 'a/b/123'
  */
-export function restfulUrl(url: string, options: {}, regexps: RegExp): string;
+export function restfulUrl(url: string, options: Record<string, any>, regexps: RegExp): string;
 
 /**
+ * 替换 url 参数。如果url中无指定的参数，则自动追加。
+ *
+ * 自动将对象中的 undefined 值，转化为 ''。null 值则直接返回 null 字符串。
  *
- * @param str
- * @param key
- * @param raw
- * @returns md5 value
+ * params 参数中的数据格式，建议调用处统一处理为 string 格式。内部仅统一处理 undefined 和 {} 格式。
+ * @param href 需要替换参数的 url。为空字符串则直接返回 href
+ * @param params 参数对象。为空对象，则直接返回 href。
+ * @example
+ *  // 无参数，自动追加
+ * changeParam('a/b/d/g', { a: 1, b: 2, c: 3 }); // 'a/b/d/g?a=1&b=2&c=3'
+ *  // 更新已有参数的值
+ *  changeParam('a/b/d/g?a=aa&b=bb&c=cc', { a: 1, b: 2, c: 3 }); // 'a/b/d/g?a=1&b=2&c=3'
+ *  // url 中无参数 d，自动追加参数
+ *  changeParam('a/b/d/g?a=aa&b=bb&c=cc', { a: 1, b: 2, c: 3, d: 5 }); // 'a/b/d/g?a=1&b=2&c=3&d=5'
+ *  // undefined 值转化为 ''
+ *  changeParam('a/b/d/g', { a: 1, b: 2, c: undefined }); // 'a/b/d/g?a=1&b=2&c='
+ *  // null 值转化为 'null'
+ *  changeParam('a/b/d/g', { a: 1, b: null, c: undefined }); // 'a/b/d/g?a=1&b=null&c='
+ *  // [] 和 {} 值。最好不要给参数中传入 {} 值
+ *  changeParam('a/b/d/g', { a: { m: 3 }, b: [1,2] }); // a/b/d/g?a={"m":3}&b=1,2
+ *  // 更换 token={token} 值，注意 原理并不是替换 {token} 值，而是更新 `token=xxx` 值，也就是目标是 `=` 左边的 `key` 与 params 中的 key 匹配
+ *  changeParam('a/b/d/g?token={token}', { a: 'file', b: [1,2], token: 'mytoken' }); // a/b/d/g?token=mytoken&a=file&b=1,2
+ */
+export function changeParam(href: string, params: Record<string, any>): string;
+
+/**
+ * 格式化url
+ * @param targetStr 模板字符串
+ * @param dataObj 数据对象
+ * @param regexps 匹配正则，默认: /\{(.*)\}/g
+ * @example
+  *  formatUrl('a/{b}/{c}/d',{a: 1, b:2}) // 返回: 'a/1/2/d'
+  *  formatUrl('a/{{b}}/{{c}}/d',{a: 1, b:2}, /\{\{(.*)\}\}/g) // 返回: 'a/1/2/d'
+  */
+export function formatUrl(
+  targetStr: string,
+  dataObj: Record<string, any>,
+  regexps?: string | RegExp
+): string;
+
+/**
+ * 补全 url 前缀
+ * @param left 左边通用前缀
+ * @param right 右边具体的 url
+ * @return 补全后的URL
+ * @example
+ *  completePrefix('/aa/', 'b/c/d'); // '/aa/b/c/d'
+ *  completePrefix('/aa /', ' b/c/d'); // '/aa/b/c/d'
+ *  completePrefix('aa ', ' b c/d'); // 'aa/b c/d'
+ *  completePrefix(' aa ', ' b c/d '); // 'aa/b c/d'
+ *  // 注意，不会自动去除 url 内部的空格，会自动将 url 内部多余的 `/` 去掉
+ *  completePrefix('// aa /', '/ b c///d /'); // '/ aa/b c/d /'
+ */
+export function completePrefix(left = '', right = ''): string;
+
+/**
+ * 计算MD5哈希值
+ * @param str 目标字符串
+ * @param key HMAC密钥（可选）
+ * @param raw 是否返回原始二进制数据
+ * @returns md5值
  * @example
  * // calc the (hex-encoded) MD5 hash of a given string value:
  *    var hash = md5("value"); // "2063c1608d6e0baf80249c42e2be5804"
@@ -307,28 +419,33 @@ export function restfulUrl(url: string, options: {}, regexps: RegExp): string;
  * // calc the raw HMAC-MD5 hash of a given string value and key:
  *    var hash = md5("value", "key", true);
  */
-export function MD5(str: string, key: string, raw: boolean): string;
+export function MD5(str: string, key?: string, raw?: boolean): string;
 
 /**
- * deep copy
+ * 深拷贝
+ * @param source 源对象
  *  1. obj 中包含方法，则直接赋值
- * @param source
  */
-export function deepCopy(source: any): any;
+export function deepCopy<T>(source: T): T;
+
 /**
- * deep equal use stringfy
- * @param valA
- * @param valB
+ * 通过序列化实现深比较
+ * @param valA 比较值A
+ * @param valB 比较值B
  */
 export function deepEqual(valA: any, valB: any): boolean;
 
 /**
- * deep equal
+ * 快速深比较
+ * @param a 比较值A
+ * @param b 比较值B
  * support: Object/Array/String/Number/RegExp/
- * @param valA
- * @param valB
  */
 export function fastDeepEqual(a: any, b: any): boolean;
+
+/**
+ * 判断是否在Node.js环境中
+ */
 export function isNode(): boolean;
 
 /**
@@ -338,62 +455,94 @@ export function isNode(): boolean;
  * @example
  *  omit({ name: 'ilex', age: 16 }, ['age']); // { name: 'ilex' }
  */
-export function omit(obj: object, keys: string | Array<String>): any;
+export function omit<T extends object, K extends keyof T>(
+  obj: T,
+  keys: K | K[]
+): Omit<T, K>;
 
 /**
  * 从指定的 obj 中获取 指定的key组成新的对象
- * @param obj
- * @param keys
+ * @param obj 目标对象
+ * @param keys 需要提取的键
  * @example
  *  pick({ name: 'ilex', age: 16 }, ['age']); // { age: 16 }
  *  pick({ name: 'ilex', age: 16 }, ['']); // {}
  *  pick({ name: 'ilex', age: 16 }, ['you']); // {}，如果指定对象中无指定的 key，则不拾取
  */
-export function pick(obj: Object | Function, keys: string | Array<String>): Object;
+export function pick<T extends object, K extends keyof T>(
+  obj: T | Function,
+  keys: K | K[]
+): Partial<Pick<T, K>>;
+
 /**
  * 从指定的 obj 中获取 满足 judge(key, value) 组成新的对象
- *
- * @param obj
- * @param judge
+ * @param obj 目标对象
+ * @param judge 判断函数
  * @example
  *  pickBy({ a: 1, b: 2, c: 'ray' }, (key, value) => typeof value === 'number')
  */
-export function pickBy(obj: Object | Function, judge: (key, value) => Boolean): Object;
+export function pickBy<T extends object>(
+  obj: T | Function,
+  judge: (key: keyof T, value: T[keyof T]) => boolean
+): Partial<T>;
+
 /**
  * 将数据转化为json
- * @param data
+ * @param data 原始数据
  */
-export function parseJson(data: any): any;
+export function parseJson(data: string): any;
 
 /**
- * 将object等 类型的数据转化为string
- * @param json
+ * 将object等类型的数据转化为string
+ * @param json 原始数据
  */
-export function stringify(json: any): any;
+export function stringify(json: any): string;
 
+/**
+ * 去除字符串两端空白
+ * @param str 目标字符串
+ */
 export function trim(str: string | null | undefined): string;
 
-
-export class objectPath {
+export const objectPath: {
   /**
    * tests path existence
-   * @param obj
-   * @param path
+   * @param obj 目标对象
+   * @param path 属性路径
    * @example
    * objectPath.has(obj, "a.b"); // true
    * objectPath.has(obj, ["a","d"]); // false
    */
-  has(obj: Object, path: number | string): boolean;
-  ensureExists(obj: Object, path: number | string, value: any): boolean;
-  set(obj: Object, path: number | string, value: any, doNotReplace: boolean): void;
-  empty(obj: Object, path: number | string): void;
-  push(obj: Object, path: number | string, values?: any): void;
-  coalesce(obj: Object, paths: Array<Number|String>, defaultValue: any): void;
+  has(obj: object, path: number | string | (number | string)[]): boolean;
+
+  ensureExists(obj: object, path: number | string | (number | string)[], value: any): boolean;
+
+  set(
+    obj: object,
+    path: number | string | (number | string)[],
+    value: any,
+    doNotReplace?: boolean
+  ): void;
+
+  empty(obj: object, path: number | string | (number | string)[]): void;
+
+  push(
+    obj: object,
+    path: number | string | (number | string)[],
+    ...values: any[]
+  ): void;
+
+  coalesce(
+    obj: object,
+    paths: Array<number | string | (number | string)[]>,
+    defaultValue: any
+  ): any;
+
   /**
    * 获取指定路径节点
-   * @param obj
-   * @param path
-   * @param defaultValue
+   * @param obj 目标对象
+   * @param path 属性路径
+   * @param defaultValue 默认值
    * @example
    * // bind object
       var model = objectPath({
@@ -406,72 +555,112 @@ export class objectPath {
       //now any method from above is supported directly w/o passing an object
       model.get("a.b");  //returns "d"
    */
-  get(obj: Object, path: Number|String, defaultValue: any): any;
+  get(
+    obj: object,
+    path: number | string | (number | string)[],
+    defaultValue?: any
+  ): any;
+
   /**
    * 删除指定路径节点
-   * @param obj
-   * @param path
+   * @param obj 目标对象
+   * @param path 属性路径
    * @example
    * model.del("a.b"); // obj.a.b is now undefined
    */
-  del(obj: Object, path: Number|String): string;
-  create(options: Object): Function;
-  withInheritedProps: Function;
+  del(obj: object, path: number | string | (number | string)[]): void;
+
+  /**
+   * 创建一个新的 objectPath
+   * @param options
+   */
+  create(options?: Record<string, any>): typeof objectPath;
+
+  /**
+   *includeInheritedProps 为 true 的 objectPath
+   */
+  withInheritedProps: typeof objectPath;
 }
 
 /**
- * 解析数据
- * @param text
- * @param dataObj
- * @param regexps 可选
- * @returns returns a new str
+ * 解析数据并替换模板中的占位符
+ * @param text 模板文本
+ * @param dataObj 数据对象
+ * @param regexps 匹配正则（可选）
+ * @returns 替换后的字符串
  * @example
  *  demo: parseText('a/{b}/{c}/d',{a: 1, b:2}) 返回: 'a/1/2/d'
  *  demo: parseText('a/b?name={name}&pwd={pwd}',{name: 'ilex', pwd:122}) 返回: 'a/b?name=ilex&pwd=123'
  */
-export function parseText(text: string, dataObj: object, regexps?: string | RegExp): string;
+export function parseText(
+  text: string,
+  dataObj: Record<string, any>,
+  regexps?: string | RegExp
+): string;
 
-export function shallowEqual(objA, objB): boolean;
+/**
+ * 浅比较
+ * @param objA 比较对象A
+ * @param objB 比较对象B
+ */
+export function shallowEqual(objA: any, objB: any): boolean;
 
+/**
+ * 加法运算（解决精度问题）
+ * @param arg1 加数
+ * @param arg2 被加数
+ */
+export function addition(arg1: number, arg2: number): number;
+
+/**
+ * 减法运算（解决精度问题）
+ * @param arg1 减数
+ * @param arg2 被减数
+ */
+export function subtraction(arg1: number, arg2: number): number;
 
-export function addition(arg1, arg2): number;
-export function subtraction(arg1, arg2): number;
 /**
  * 小数乘法
  * @param arg1 被乘数（接受小数和整数）
  * @param arg2 乘数（接受小数和整数）
  * @param fix 乘积保留几位（接受正负整数以及0），默认值为 0
- * @returns {Number}
+ * @returns 乘积结果
  * @example
  *  accMul(0.56, 100); // 56
  *  accMul(0.5679, 100); // 57
  *  accMul(0.5679, 100.2); // 57
-*/
-export function accMul(arg1: Number, arg2: Number, fix?: Number): number;
+ */
+export function accMul(arg1: number, arg2: number, fix?: number): number;
+
 /**
  * 小数除法
- * @param arg1 被乘数（接受小数和整数）
- * @param arg2 乘数（接受小数和整数）
+ * @param arg1 被除数
+ * @param arg2 除数
  * @param fix 除法保留几位（接受正负整数以及0）,默认值为 0
- * @returns {Number}
+ * @returns 除法结果
  * @example
  *  accDivide(56, 100); // 0.56
  *  accDivide(5679, 100, 2); // 56.79
  *  accDivide(5679, 100.2, 2); // 56.68
  */
-export function accDivide(arg1: Number, arg2: Number, fix?: Number): number;
+export function accDivide(arg1: number, arg2: number, fix?: number): number;
 
 /**
  * 将数值格式化成金额形式
- *
  * @param num 数值(Number或者String)
- * @param precision 精度，默认不变. 传 null or undefined
+ * @param precision 精度，默认不变
  * @param separator 分隔符，默认为逗号
  * @param sign 前缀，默认为$
  * @param unit 单位,默认为空
  * @return 金额格式的字符串,如'1,234,567'，默认返回 ''
  */
-export function coinFormat(num: number, precision: number, separator: string, sign: string, unit: string): string | '';
+export function coinFormat(
+  num: number | string,
+  precision?: number,
+  separator?: string,
+  sign?: string,
+  unit?: string
+): string;
 
 // --- 日历工具类
 /**
@@ -556,7 +745,12 @@ interface DateHelper {
    * @param firstDayOfWeek 一周的第一天（0表示周日，默认0）
    * @return {number} 周数
    */
-  getMonthWeek(year: number | string, month: number | string, date: number | string, firstDayOfWeek?: number): number;
+  getMonthWeek(
+    year: number | string,
+    month: number | string,
+    date: number | string,
+    firstDayOfWeek?: number
+  ): number;
 
   /**
    * 获取指定日期在当年的周数
@@ -566,7 +760,12 @@ interface DateHelper {
    * @param firstDayOfWeek 一周的第一天（0表示周日，默认0）
    * @return {number} 周数
    */
-  getYearWeek(year: number | string, month: number | string, date: number | string, firstDayOfWeek?: number): number;
+  getYearWeek(
+    year: number | string,
+    month: number | string,
+    date: number | string,
+    firstDayOfWeek?: number
+  ): number;
 
   /**
    * 获取指定日期所在周的起止日期
@@ -576,7 +775,12 @@ interface DateHelper {
    * @param firstDayOfWeek 一周的第一天（0表示周日，默认0）
    * @return {[string, string]} 周起始日期和结束日期组成的数组
    */
-  getWeekDate(year: number | string, month: number | string, date: number | string, firstDayOfWeek?: number): [string, string];
+  getWeekDate(
+    year: number | string,
+    month: number | string,
+    date: number | string,
+    firstDayOfWeek?: number
+  ): [string, string];
 
   /**
    * 格式化日期结果
@@ -622,7 +826,11 @@ interface PanelDate {
  * @param month 月
  * @returns [年, 两位数字的月, 该月天数]
  */
-declare function getCurrMonthData(type: string, year: number, month: number): [number, string, number];
+declare function getCurrMonthData(
+  type: string,
+  year: number,
+  month: number
+): [number, string, number];
 
 /**
  * 获取日期状态
@@ -631,7 +839,11 @@ declare function getCurrMonthData(type: string, year: number, month: number): [n
  * @param month 月
  * @returns 日期状态数组
  */
-declare function getDaysStatus(type: string, year: number, month: number): DayStatus[];
+declare function getDaysStatus(
+  type: string,
+  year: number,
+  month: number
+): DayStatus[];
 
 /**
  * 获取上一个月的最后一周天数，填充当月空白
@@ -641,7 +853,12 @@ declare function getDaysStatus(type: string, year: number, month: number): DaySt
  * @param firstDayOfWeek 一周的第一天（0表示周日）
  * @returns 上月填充日期数组
  */
-declare function getPreMonthDates(type: string, year: number, month: number, firstDayOfWeek: number): DayStatus[];
+declare function getPreMonthDates(
+  type: string,
+  year: number,
+  month: number,
+  firstDayOfWeek: number
+): DayStatus[];
 
 /**
  * 将日期对象转换为年、月、日结构
@@ -664,7 +881,11 @@ declare function convertDayToDate(day: DayObject | null): Date | null;
  * @param firstDayOfWeek 一周的第一天（0表示周日）
  * @returns 上月面板日期数组
  */
-declare function getPrevMonthDays(year: number, month: number, firstDayOfWeek: number): PanelDate[];
+declare function getPrevMonthDays(
+  year: number,
+  month: number,
+  firstDayOfWeek: number
+): PanelDate[];
 
 /**
  * 获取当前月的日期数据
@@ -672,7 +893,10 @@ declare function getPrevMonthDays(year: number, month: number, firstDayOfWeek: n
  * @param month 月
  * @returns 当月面板日期数组
  */
-declare function getCurrentMonthDays(year: number, month: number): PanelDate[];
+declare function getCurrentMonthDays(
+  year: number,
+  month: number
+): PanelDate[];
 
 /**
  * 根据日期获取当前周的起始日期
@@ -680,7 +904,17 @@ declare function getCurrentMonthDays(year: number, month: number): PanelDate[];
  * @param firstDayOfWeek 一周的第一天（0表示周日）
  * @returns [周起始日期, 周结束日期]
  */
-declare function getCurrentWeekDays(day: DayObject, firstDayOfWeek: number): [DayObject, DayObject];
+declare function getCurrentWeekDays(
+  day: DayObject,
+  firstDayOfWeek: number
+): [DayObject, DayObject];
+
+/**
+ * 检测传入的日期是 今天
+ * @param dayObj PanelDate 对象
+ * @returns boolean
+ */
+declare function checkIsToday(dayObj: PanelDate | null): boolean;
 
 /**
  * 日历工具类
@@ -695,86 +929,98 @@ declare const CalendarUtils: {
   getPrevMonthDays: typeof getPrevMonthDays;
   getCurrentMonthDays: typeof getCurrentMonthDays;
   getCurrentWeekDays: typeof getCurrentWeekDays;
+  checkIsToday: typeof checkIsToday;
 };
 
 export { CalendarUtils };
 export type { DayObject, DayStatus, PanelDate, DateHelper };
 
 /**
- * dateTime
+ * 日期时间工具
  */
 declare namespace dateTime {
   /**
    * 将日期时间戳格式化成指定格式
-   * @param date
-   * @param fmt 默认 yyyy-MM-dd HH:mm:ss
+   * @param date 日期对象或时间戳
+   * @param fmt 格式化模板，默认 yyyy-MM-dd HH:mm:ss
    * @example
    *   formatDate(); // 2016-09-02 13:17:13
    *   formatDate(new Date(), 'yyyy-MM-dd'); // 2016-09-02
    *   formatDate(new Date(), 'yyyy-MM-dd 第q季度 www HH:mm:ss:SSS');// 2016-09-02 第3季度 星期五 13:19:15:792
    *   formatDate(1472793615764); // 2016-09-02 13:20:15
    */
-  export function formatDate(date: Date | number, fmt: string): string;
+  export function formatDate(date?: Date | number, fmt?: string): string;
+
   /**
-   * 时间戳转时间,这是另一种方式 2018-07-09 11:04:51
-   *
-   * @param date
-   * @returns string
+   * 时间戳转时间字符串
+   * @param date 日期对象或时间戳
+   * @returns 格式化后的时间字符串
+   * @example
+   * timetrans(1472793615764); // 2016-09-02 13:20:15
    */
   export function timetrans(date: Date | number): string;
+
   /**
-   *将一个日期格式化成友好格式，比如，1分钟以内的返回“刚刚”，当天的返回时分，当年的返回月日，否则，返回年月日
-   *
-   * @param date
-   * @returns string
+   * 将一个日期格式化成友好格式
+   * @param date 日期对象或时间戳
+   * @returns 友好格式的时间字符串
+   * @example
+   * formatDateToFriendly(new Date()); // "刚刚" 或 "1分钟前" 等
    */
   export function formatDateToFriendly(date: Date | number): string;
+
   /**
    * 将一段时长转换成友好格式
-   * @param time
-   * @returns string
+   * @param time 时间戳（毫秒）
+   * @returns 友好格式的时长字符串
    * @example
-   *  var str = friendlyDate('1311111119999'); //  6年前（括号里的字符串值为1970年距字符串值表示的时间的毫秒数）
-   *  var str2 = friendlyDate('1503190042273'); // 1天前
+   *  friendlyDate('1503190042273'); // 1天前
    */
   export function friendlyDate(time: number): string;
+
   /**
-   * 将一段时长转换成友好格式
-   * @param second
-   * @returns string
+   * 将秒数转换成友好格式的时长
+   * @param second 秒数
+   * @returns 友好格式的时长字符串
    * @example
+   *  formatDurationToFriendly(147); // "2分27秒"
    *  147->“2分27秒”
    *  1581->“26分21秒”
    *  15818->“4小时24分”
    */
   export function formatDurationToFriendly(second: number): string;
+
   /**
-   * 将时间转换成MM:SS形式
-   * @param second
+   * 将秒数转换成MM:SS形式
+   * @param second 秒数
    */
   export function formatTimeToFriendly(second: number): string;
+
   /**
-   * 判断某一年是否是闰年 可以是一个date类型，也可以是一个int类型的年份，不传默认当前时间
-   * @param year
+   * 判断某一年是否是闰年
+   * @param year 年份或日期对象
    */
-  export function isLeapYear(year: number): string;
+  export function isLeapYear(year: number | Date): boolean;
+
   /**
-   * 获取某一年某一月的总天数，没有任何参数时获取当前月份的
-   * @param date
-   * @param month
+   * 获取某一年某一月的总天数
+   * @param date 年份或日期对象
+   * @param month 月份（可选）
    * @example
-   * 方式一：$.getMonthDays();
-   * 方式二：$.getMonthDays(new Date());
-   * 方式三：$.getMonthDays(2013, 12);
+   *  getMonthDays(); // 当前月天数
+   *  getMonthDays(new Date());
+   *  getMonthDays(2013, 12); // 2013年12月天数
    */
-  export function getMonthDays(date: Date | number, month: number): string;
+  export function getMonthDays(date?: Date | number, month?: number): number;
+
   /**
    * 计算两个日期之间的天数，用的是比较毫秒数的方法
    * 传进来的日期要么是Date类型，要么是yyyy-MM-dd格式的字符串日期
    * @param date1 日期一
    * @param date2 日期二
    */
-  export function countDays(date1: Date | number, date2: Date | number): string;
+  export function countDays(date1: Date | string, date2: Date | string): number;
+
   /**
    * 将字符串解析成日期
    * @param str 输入的日期字符串，如'2014-09-13'
@@ -784,93 +1030,167 @@ declare namespace dateTime {
    * parseDate('2016-08-11'); // Thu Aug 11 2016 00:00:00 GMT+0800
    * parseDate('2016-08-11 13:28:43', 'yyyy-MM-dd HH:mm:ss') // Thu Aug 11 2016 13:28:43 GMT+0800
    */
-  export function parseDate(str: string, fmt: string): string;
+  export function parseDate(str: string, fmt?: string): Date;
+
   /**
    * 到某一个时间的倒计时
-   * @param endTime
+   * @param endTime 结束时间
+   * @returns 倒计时对象
    * @example
-   *  getEndTime('2017/7/22 16:0:0') // result："剩余时间6天 2小时 28 分钟20 秒"
+   *  getEndTime('2017/7/22 16:0:0') // {d:6, h:2, m:28, s:20}
    */
-  export function getEndTime(endTime: string | number): object;
+  export function getEndTime(endTime: string | number): {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    [key: string]: number;
+  };
+
   /**
-   * 到某一个时间的倒计时
-   * @param endTime
+   * 到某一个时间的倒计时字符串
+   * @param endTime 结束时间
+   * @returns 倒计时字符串
    * @example
    * getEndTimeStr('2017/7/22 16:0:0') // "剩余时间6天 2小时 28 分钟20 秒"
    */
   export function getEndTimeStr(endTime: string | number): string;
+
   /**
    * 获取某月有多少天
-   * @param time
+   * @param time 日期字符串或时间戳
    */
-  export function getMonthOfDay(time: string | number): string;
+  export function getMonthOfDay(time: string | number): number;
+
   /**
    * 获取某年有多少天
-   * @param time
+   * @param time 日期字符串或时间戳
    */
-  export function getYearOfDay(time: string | number): string;
+  export function getYearOfDay(time: string | number): number;
+
   /**
    * 获取某年的第一天
-   * @param time
+   * @param time 日期字符串或时间戳
    */
   export function getFirstDayOfYear(time: string | number): string;
+
   /**
    * 获取某年最后一天
-   * @param time
+   * @param time 日期字符串或时间戳
    */
   export function getLastDayOfYear(time: string | number): string;
+
   /**
    * 获取某个日期是当年中的第几天
-   * @param time
+   * @param time 日期字符串或时间戳
    */
-  export function getDayOfYear(time: string | number): string;
+  export function getDayOfYear(time: string | number): number;
+
   /**
    * 获取某个日期在这一年的第几周
-   * @param time
+   * @param time 日期字符串或时间戳
    */
-  export function getDayOfYearWeek(time: string | number): string;
+  export function getDayOfYearWeek(time: string | number): number;
+
   /**
    * 获取两个时间段差多久
-   * @param time
-   * @param fmt
+   * @param str 时间字符串
+   * @param fmt 格式模板
    */
   export function timeFn(str: string, fmt: string): string;
 }
 
 /**
- * amostool
+ * amostool 命名空间
  */
 declare namespace amostool {}
 
 /**
- * amostool utils
+ * 通用工具函数命名空间
  */
 declare namespace utils {
-  export function isString(value: any): boolean;
-  export function isArray(value: any): boolean;
-  export function isObject(value: any): boolean;
-  export function isBoolean(value: any): boolean;
-  export function isFunction(value: any): boolean;
   /**
-   * 判断 number，采用正则表达式进行判断
+   * 判断是否为字符串
+   * @param value 待检测值
+   */
+  export function isString(value: any): value is string;
+
+  /**
+   * 判断是否为数组
+   * @param value 待检测值
+   */
+  export function isArray(value: any): value is any[];
+
+  /**
+   * 判断是否为对象（排除数组、null）
+   * @param value 待检测值
+   */
+  export function isObject(value: any): value is object;
+
+  /**
+   * 判断是否为布尔值
+   * @param value 待检测值
+   */
+  export function isBoolean(value: any): value is boolean;
+
+  /**
+   * 判断是否为函数
+   * @param value 待检测值
+   */
+  export function isFunction(value: any): value is Function;
+
+  /**
+   * 判断是否为数字，采用正则表达式进行判断
+   * @param value 待检测值
    * 正则表达式：/^(\-|\+)?([0-9]+(\.[0-9]+)?|Infinity)$/
-   * @param {*} value
    */
-  export function isNumber(value: any): boolean;
+  export function isNumber(value: any): value is number;
+
   /**
-   * 支持 string 类型的科学计数 number 校验
-   * @param value
+   * 支持科学计数法的数字校验
+   * @param value 待检测值
    */
   export function isENumber(value: any): boolean;
+
+  /**
+   * 判断是否为浮点数
+   * @param value 待检测值
+   */
   export function isFloat(value: any): boolean;
+
+  /**
+   * 判断是否为透明度值（0-1之间）
+   * @param value 待检测值
+   */
   export function isOpacity(value: any): boolean;
+
+  /**
+   * 转换为浮点数
+   * @param value 待转换值
+   */
   export function toFloat(value: any): number;
-  export function isNull(value: any): boolean;
-  export function isUndefined(value: any): boolean;
-  export function isNil(value: any): boolean;
+
+  /**
+   * 判断是否为null
+   * @param value 待检测值
+   */
+  export function isNull(value: any): value is null;
+
   /**
-   * 空（null、undefined、''）
-   * @param value
+   * 判断是否为undefined
+   * @param value 待检测值
+   */
+  export function isUndefined(value: any): value is undefined;
+
+  /**
+   * 判断是否为null或undefined
+   * @param value 待检测值
+   */
+  export function isNil(value: any): value is null | undefined;
+
+  /**
+   * 判断是否为空值（null、undefined、''）
+   * @param value 待检测值
    * @example
    *  isBlank(); // true
    *  isBlank(void 0); // true
@@ -883,22 +1203,67 @@ declare namespace utils {
    *  isBlank(true); // false
    */
   export function isBlank(value: any): boolean;
-  export function has(obj: object | Array<any>, path: Array<any> | string): boolean;
+
   /**
-   * Retrieve the values of an object's properties.
-   * @param obj
+   * 检查对象是否存在指定路径
+   * @param obj 目标对象
+   * @param path 属性路径
+   */
+  export function has(
+    obj: object | any[],
+    path: string | number | (string | number)[]
+  ): boolean;
+
+  /**
+   * 获取对象的所有值
+   * @param obj 目标对象
+   */
+  export function values<T extends object>(obj: T): Array<T[keyof T]>;
+
+  /**
+   * 空函数
    */
-  export function values(obj: object): Array<any>;
   export function noop(): void;
+
+  /**
+   * 判断是否为空（空数组、空对象、空字符串等）
+   * @param value 待检测值
+   */
   export function isEmpty(value: any): boolean;
+
+  /**
+   * 判断是否为空对象
+   * @param value 待检测值
+   */
   export function isEmptyObject(value: any): boolean;
+
+  /**
+   * 判断是否为DOM元素
+   * @param value 待检测值
+   */
   export function isElement(value: any): boolean;
-  export function isHTMLElement(value: any): boolean;
+
+  /**
+   * 判断是否为HTML元素
+   * @param value 待检测值
+   */
+  export function isHTMLElement(value: any): value is HTMLElement;
+
+  /**
+   * 判断是否为SVG元素
+   * @param value 待检测值
+   */
   export function isSVGElement(value: any): boolean;
+
+  /**
+   * 判断是否为DOM节点
+   * @param value 待检测值
+   */
   export function isDom(value: any): boolean;
+
   /**
-   * check value is url
-   * @param value
+   * 检查是否为合法URL
+   * @param value 待检测值
    * @example
    * isUrl('http://www.baidu.com') // true
    * isUrl('https://www.baidu.com') // true
@@ -910,49 +1275,76 @@ declare namespace utils {
    * isUrl('http://localhost:8080/aaa') // true
    */
   export function isUrl(value: string): boolean;
+
+  /**
+   * 判断是否为内置对象
+   * @param value 待检测值
+   */
   export function isBuiltInObject(value: any): boolean;
+
+  /**
+   * null值转换为默认值
+   * @param str 待转换值
+   */
   export function null2default(str: any): any;
+
   /**
    * 判断对象是不是Json
    * Object 对象，typeof === object && toString === '[object Object]'
-   * @param obj
-   * @returns boolean true 是 false不是
+   * @param obj 待检测值
    */
   export function isJson(obj: any): boolean;
 
-  export function isSymbol(obj: any): boolean;
-  export function isNullOrUndefined(obj: any): boolean;
-  export function isDate(obj: any): boolean;
+  /**
+   * 判断是否为Symbol类型
+   * @param obj 待检测值
+   */
+  export function isSymbol(obj: any): obj is symbol;
+
+  /**
+   * 判断是否为null或undefined
+   * @param obj 待检测值
+   */
+  export function isNullOrUndefined(obj: any): obj is null | undefined;
+
+  /**
+   * 判断是否为Date对象
+   * @param obj 待检测值
+   */
+  export function isDate(obj: any): obj is Date;
 
   /**
    * 判断string能否被转成json
    *  参数 str 如果不是 string 则直接返回 false
-   * @param str
-   * @returns boolean
+   * @param value 待检测值
    */
   export function stringIsJson(value: any): boolean;
+
   /**
    * 判断key是否在object内
    * （采用 in 判断，继承属性均会判断）
-   * @param keys
-   * @param obj 如果 obj 是 null or undefined, 或者 非 object，则直接 返回 false
+   * @param keys 键名或键名数组
+   * @param obj 目标对象 如果 obj 是 null or undefined, 或者 非 object，则直接 返回 false
    */
   export function isKeyInObject(keys: string | string[], obj: any): boolean;
+
   /**
    * 判断key是否在object内
    * （采用 hasOwnProperty 判断，继承属性不会判断）
-   * @param keys
-   * @param obj 如果 obj 是 null or undefined, 或者 非 object，则直接 返回 false
+   * @param keys 键名或键名数组
+   * @param obj 目标对象 如果 obj 是 null or undefined, 或者 非 object，则直接 返回 false
    */
   export function isOwnKeyInObject(keys: string | string[], obj: any): boolean;
+
   /**
-   * 判断是否是 promise
-   * @param value
+   * 判断是否为Promise对象
+   * @param value 待检测值
    */
-  export function isPromise(value: any): boolean;
+  export function isPromise(value: any): value is Promise<any>;
+
   /**
-   * 判断是否是正则对象
-   * @param value
+   * 判断是否为正则表达式
+   * @param value 待检测值
    * @example
    *  isRegExp(undefined); // false
    *  isRegExp(''); // false
@@ -963,10 +1355,17 @@ declare namespace utils {
    *  isRegExp(new RegExp('aa')); // true
    *  isRegExp({ test(){} }); // false
    */
-  export function isRegExp(value: any): boolean;
+  export function isRegExp(value: any): value is RegExp;
+
+  /**
+   * 简单对象比较
+   * @param objA 比较对象A
+   * @param objB 比较对象B
+   */
   export function simpleEqual(objA: object, objB: object): boolean;
+
   /**
-   * 判断是一个 image 的路径
+   * 判断是否为图片路径
    * `/a/a/a.png|jpe?g|gif...`
    * `http://a.b/a.png|jpe?g|gif...`
    * `data:image/png|jpe?g|gif;base64,`
@@ -976,37 +1375,43 @@ declare namespace utils {
    *  isImageSrc('http://a.b/a.png'); // true
    *  isImageSrc('data:image/png|jpe?g|gif;base64,'); // true
    */
-  export function isImageSrc(url: String): boolean;
+  export function isImageSrc(url: string): boolean;
+
   /**
-   * 判断图片是 gif
-   * @param url 支持的格式
+   * 判断是否为GIF图片
+   * @param url 待检测URL
    * @example
    *  isGIF('a.gif'); // true
    *  isGIF('data:image/;base64,'); // true
    */
-  export function isGIF(url: String): boolean;
+  export function isGIF(url: string): boolean;
+
   /**
    * 将数字部分内容转化为 *
-   * @param number 目标 Number
+   * @param number 目标数字
    * @param start 起始位置 默认3
    * @param len 转换位数 默认4
    * @param sign 替换的字符 默认*
    */
-  export function encodeNumber(number: Number, start?: number, len?: number, sign?: string): String;
+  export function encodeNumber(
+    number: number,
+    start?: number,
+    len?: number,
+    sign?: string
+  ): string;
 
   /**
-   * 获取扩展名
+   * 获取文件扩展名
    *
    * 可快速使用 `filePath.split('.').pop();` 获取扩展名
-   * @param filePath
-   * @return {String} ext
+   * @param filePath 文件路径
    * @example
    *  getFileExtension('a.png'); // png
    *  getFileExtension('a/a/a.png'); // png
    *  getFileExtension('a.a.a.png.jpg'); // jpg
    *  getFileExtension('a'); // ''
    */
-  export function getFileExtension(filePath: string): String;
+  export function getFileExtension(filePath: string): string;
 
   /**
    * 将指定 size 中的数据，转化为 byte
@@ -1014,7 +1419,6 @@ declare namespace utils {
    *  - 默认去除内部所有空格， 1024 MB -> 1024mb
    *  - 无单位或者 number 类型，将直接转化为 number值，默认当 byte 处理
    * @param size 带有单位的 size，不带单位时，直接返回该值
-   * @returns byte
    * @example
    *  fileSizeToByte('1kb'); // 1024
    *  fileSizeToByte('1mb'); // 1048576
@@ -1024,15 +1428,33 @@ declare namespace utils {
    *  fileSizeToByte('123'); // 123
    *  fileSizeToByte(123); // 123
    */
-  export function fileSizeToByte(size: string): String;
+  export function fileSizeToByte(size: string | number): number;
+
+  /**
+   * 数组some方法兼容实现
+   * @param arr 目标数组
+   * @param fun 回调函数
+   */
+  export function some(
+    arr: any[],
+    fun: (value: any, index: number, array: any[]) => boolean,
+    thisArg?: any
+  ): boolean;
+
+  /**
+   * 数组every方法兼容实现
+   * @param arr 目标数组
+   * @param callbackfn 回调函数
+   * @param thisArg this指向
+   */
+  export function every(
+    arr: any[],
+    callbackfn: (value: any, index: number, array: any[]) => boolean,
+    thisArg?: any
+  ): boolean;
 
-  export function some(arr: Array<any>, fun: Function /*, thisArg */): boolean;
-  export function every(arr: Array<any>, callbackfn: Function, thisArg): boolean;
-  export function reduce(arr: Array<any>, callback: Function /*, initialValue*/);
-  export function parse2string(obj: object | Array<any>): string;
-  export function parse2object(str: string): object | Array<any>;
-  export function dataToArray(vars: any): Array<any>;
   /**
+   * 数组reduce方法兼容实现
    * Those data types can be cloned:
    *     Plain object, Array, TypedArray, number, string, null, undefined.
    * Those data types will be assgined using the orginal data:
@@ -1045,35 +1467,85 @@ declare namespace utils {
    * (There might be a large number of date in `series.data`).
    * So date should not be modified in and out of echarts.
    *
-   * @param source
-   * @return new
+   * @param arr 目标数组
+   * @param callback 回调函数
+   * @param initialValue 初始值
+   */
+  export function reduce<T, U = T>(
+    arr: T[],
+    callback: (
+      accumulator: U,
+      currentValue: T,
+      currentIndex: number,
+      array: T[]
+    ) => U,
+    initialValue?: U
+  ): U;
+
+  /**
+   * 转换为字符串
+   * @param obj 目标对象/数组
    */
-  export function clone(source: any): object | Array<any>;
+  export function parse2string(obj: object | any[]): string;
+
+  /**
+   * 解析为对象/数组
+   * @param str JSON字符串
+   */
+  export function parse2object(str: string): object | any[];
+
+  /**
+   * 转换为数组
+   * @param vars 目标值
+   */
+  export function dataToArray(vars: any): any[];
+
   /**
-   * @param target
-   * @param source
-   * @param [overwrite=false]
-   * @return target
+   * 克隆对象/数组
+   * @param source 源对象
    */
-  export function merge(target: object | Array<any>, source: object | Array<any>, overwrite?: boolean): object | Array<any>;
+  export function clone<T>(source: T): T;
+
   /**
-   * @param targetAndSources The first item is target, and the rests are source.
-   * @param [overwrite=false]
-   * @return target
+   * 合并对象
+   * @param target 目标对象
+   * @param source 源对象
+   * @param overwrite 是否覆盖已有属性
    */
-  export function mergeAll(targetAndSources: Array<any>, overwrite?: boolean): object | Array<any>;
+  export function merge<T extends object>(
+    target: T,
+    source: Partial<T>,
+    overwrite?: boolean
+  ): T;
+
   /**
+   * 合并多个对象
+   * @param targetAndSources 目标对象和源对象数组 he first item is target, and the rests are source.
+   * @param overwrite 是否覆盖已有属性
+   */
+  export function mergeAll<T extends object>(
+    targetAndSources: [T, ...Partial<T>[]],
+    overwrite?: boolean
+  ): T;
+
+  /**
+   * 比较子对象属性是否相等
+   * 
    * 比较 objTarget 中的所有属性值，是否在 objSource 中相等
-   * @param objSource
-   * @param objTarget
+   * @param objSource 源对象
+   * @param objTarget 目标对象
    */
-  export function subObjectEqual(objSource: {}, objTarget: {}): Boolean;
+  export function subObjectEqual(
+    objSource: Record<string, any>,
+    objTarget: Record<string, any>
+  ): boolean;
+
   /**
-   * 校验给定的 string 是否是 文件名
-   *
+   * 校验文件名合法性
+   * 
    * 校验中使用的正则表达式： `/[\\/:\*\?"<>\|]/g`
-   * @param str
-   * @param maxLen
+   * @param str 文件名
+   * @param maxLen 最大长度，默认259
    * @example
    *  checkFileName('example.txt'); // true
    *  checkFileName('con\\example.txt'); // false
@@ -1083,6 +1555,6 @@ declare namespace utils {
    *  checkFileName('example.txt.'); // true
    *  checkFileName('example..............txt'); // true
    */
-  export function checkFileName(str: String | Number, maxLen?: 259): Boolean;
+  export function checkFileName(str: string | number, maxLen?: number): boolean;
 }