sculp-js 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,644 @@
+type AnyFunc<R = any> = (...args: any[]) => R;
+type AnyArray = any[];
+type ArrayElements<A> = A extends Array<infer R> ? R : never;
+type AnyObject = Record<string | number, any>;
+type PartialDeep<T> = {
+    [P in keyof T]?: PartialDeep<T[P]>;
+};
+declare const typeIs: (any: unknown) => string;
+declare const isString: (any: unknown) => any is string;
+declare const isBoolean: (any: unknown) => any is boolean;
+declare const isSymbol: (any: unknown) => any is symbol;
+declare const isBigInt: (any: unknown) => any is bigint;
+declare const isNumber: (any: unknown) => any is number;
+declare const isUndefined: (any: unknown) => any is undefined;
+declare const isNull: (any: unknown) => any is null;
+declare const isPrimitive: (any: unknown) => boolean;
+declare const isObject: (any: unknown) => any is Record<string, unknown>;
+declare const isArray: (any: unknown) => any is unknown[];
+declare const isFunction: (any: unknown) => any is Function;
+declare const isNaN: (any: unknown) => any is number;
+declare const isDate: (any: unknown) => any is Date;
+declare const isError: (any: unknown) => any is Error;
+declare const isRegExp: (any: unknown) => any is RegExp;
+
+type type_AnyArray = AnyArray;
+type type_AnyFunc<R = any> = AnyFunc<R>;
+type type_AnyObject = AnyObject;
+type type_ArrayElements<A> = ArrayElements<A>;
+type type_PartialDeep<T> = PartialDeep<T>;
+declare const type_isArray: typeof isArray;
+declare const type_isBigInt: typeof isBigInt;
+declare const type_isBoolean: typeof isBoolean;
+declare const type_isDate: typeof isDate;
+declare const type_isError: typeof isError;
+declare const type_isFunction: typeof isFunction;
+declare const type_isNaN: typeof isNaN;
+declare const type_isNull: typeof isNull;
+declare const type_isNumber: typeof isNumber;
+declare const type_isObject: typeof isObject;
+declare const type_isPrimitive: typeof isPrimitive;
+declare const type_isRegExp: typeof isRegExp;
+declare const type_isString: typeof isString;
+declare const type_isSymbol: typeof isSymbol;
+declare const type_isUndefined: typeof isUndefined;
+declare namespace type {
+  export { type type_AnyArray as AnyArray, type type_AnyFunc as AnyFunc, type type_AnyObject as AnyObject, type type_ArrayElements as ArrayElements, type type_PartialDeep as PartialDeep, typeIs as default, type_isArray as isArray, type_isBigInt as isBigInt, type_isBoolean as isBoolean, type_isDate as isDate, type_isError as isError, type_isFunction as isFunction, type_isNaN as isNaN, type_isNull as isNull, type_isNumber as isNumber, type_isObject as isObject, type_isPrimitive as isPrimitive, type_isRegExp as isRegExp, type_isString as isString, type_isSymbol as isSymbol, type_isUndefined as isUndefined };
+}
+
+/**
+ * 判断一个对象是否为类数组
+ * @param any
+ * @returns {boolean}
+ */
+declare const arrayLike: (any: unknown) => boolean;
+/**
+ * 遍历数组，返回 false 中断遍历
+ * @param {ArrayLike<V>} array
+ * @param {(val: V, idx: number) => any} iterator
+ * @param reverse {boolean} 是否倒序
+ */
+declare const arrayEach: <V>(array: ArrayLike<V>, iterator: (val: V, idx: number) => any, reverse?: boolean) => void;
+/**
+ * 异步遍历数组，返回 false 中断遍历
+ * @param {ArrayLike<V>} array
+ * @param {(val: V, idx: number) => Promise<any>} iterator
+ * @param {boolean} reverse
+ */
+declare function arrayEachAsync<V>(array: ArrayLike<V>, iterator: (val: V, idx: number) => Promise<any> | any, reverse?: boolean): Promise<void>;
+/**
+ * 插入到目标位置之前
+ * @param {AnyArray} array
+ * @param {number} start
+ * @param {number} to
+ */
+declare const arrayInsertBefore: (array: AnyArray, start: number, to: number) => void;
+/**
+ * 数组删除指定项目
+ * @param {V[]} array
+ * @param {(val: V, idx: number) => boolean} expect
+ * @returns {V[]}
+ */
+declare function arrayRemove<V>(array: V[], expect: (val: V, idx: number) => boolean): V[];
+/**
+ * 自定义深度优先遍历函数(支持continue和break操作)
+ * @param {array} deepList
+ * @param {function} iterator
+ * @param {array} children
+ * @param {boolean} isReverse 是否反向遍历
+ */
+declare const deepTraversal: <V>(deepList: ArrayLike<V>, iterator: (val: V, i: number, arr: ArrayLike<V>, parent: V | null, level: number) => any, children?: string, isReverse?: boolean) => void;
+type IdLike = number | string;
+interface ITreeConf {
+    id: string | number;
+    children: string;
+}
+/**
+ * 在树中找到 id 为某个值的节点，并返回上游的所有父级节点
+ * @param {ArrayLike<T>} tree
+ * @param {IdLike} nodeId
+ * @param {ITreeConf} config
+ * @return {[IdLike[], ITreeItem<V>[]]}
+ */
+declare function getTreeIds<V>(tree: ArrayLike<V>, nodeId: IdLike, config?: ITreeConf): [IdLike[], ArrayLike<V>[]];
+/**
+ * 异步ForEach函数
+ * @param {array} array
+ * @param {asyncFuntion} callback
+ * // asyncForEach 使用范例如下
+// const start = async () => {
+//   await asyncForEach(result, async (item) => {
+//     await request(item);
+//     count++;
+//   });
+
+//   console.log('发送次数', count);
+// }
+
+// for await...of 使用范例如下
+// const loadImages =  async (images) => {
+//   for await (const item of images) {
+//      await request(item);
+//      count++;
+//    }
+// }
+ * @return {*}
+ */
+declare function asyncForEach(array: any[], callback: Function): Promise<void>;
+
+declare const array_arrayEach: typeof arrayEach;
+declare const array_arrayEachAsync: typeof arrayEachAsync;
+declare const array_arrayInsertBefore: typeof arrayInsertBefore;
+declare const array_arrayLike: typeof arrayLike;
+declare const array_arrayRemove: typeof arrayRemove;
+declare const array_asyncForEach: typeof asyncForEach;
+declare const array_deepTraversal: typeof deepTraversal;
+declare const array_getTreeIds: typeof getTreeIds;
+declare namespace array {
+  export { array_arrayEach as arrayEach, array_arrayEachAsync as arrayEachAsync, array_arrayInsertBefore as arrayInsertBefore, array_arrayLike as arrayLike, array_arrayRemove as arrayRemove, array_asyncForEach as asyncForEach, array_deepTraversal as deepTraversal, array_getTreeIds as getTreeIds };
+}
+
+/**
+ * 复制文本
+ * @param {string} text
+ */
+declare const copyText: (text: string) => void;
+
+declare const clipboard_copyText: typeof copyText;
+declare namespace clipboard {
+  export { clipboard_copyText as copyText };
+}
+
+/**
+ * 获取cookie
+ * @param {string} name
+ * @returns {string}
+ */
+declare const cookieGet: (name: string) => string;
+/**
+ * 设置 cookie
+ * @param {string} name
+ * @param {string} value
+ * @param {number | Date} [maxAge]
+ */
+declare const cookieSet: (name: string, value: string, maxAge?: number | Date) => void;
+/**
+ * 删除单个 cookie
+ * @param name cookie 名称
+ */
+declare const cookieDel: (name: string) => void;
+
+declare const cookie_cookieDel: typeof cookieDel;
+declare const cookie_cookieGet: typeof cookieGet;
+declare const cookie_cookieSet: typeof cookieSet;
+declare namespace cookie {
+  export { cookie_cookieDel as cookieDel, cookie_cookieGet as cookieGet, cookie_cookieSet as cookieSet };
+}
+
+/**
+ * 格式化为日期对象(带自定义格式化模板)
+ * @param {DateValue} value 可以是数值、字符串或 Date 对象
+ * @param {string} [format] 模板，默认是 YYYY-MM-DD HH:mm:ss，模板字符：
+ * - YYYY：年
+ * - yyyy: 年
+ * - MM：月
+ * - DD：日
+ * - dd: 日
+ * - HH：时（24 小时制）
+ * - hh：时（12 小时制）
+ * - mm：分
+ * - ss：秒
+ * - SSS：毫秒
+ * - ww: 周
+ * @returns {string}
+ */
+declare const formatDate: (date?: Date, format?: string) => string;
+/**
+ * 计算向前或向后N天的具体日期
+ * @param {string} strDate 参考日期
+ * @param {number} n 正数：向后推算；负数：向前推算
+ * @param {string} sep 日期格式的分隔符
+ * @return {*} 目标日期
+ */
+declare function calculateDate(strDate: string, n: number, sep?: string): string;
+/**
+ * 计算向前或向后N天的具体时间日期
+ * @param {number} n 正数：向后推算；负数：向前推算
+ * @param {string} dateSep 日期分隔符
+ * @param {string} timeSep 时间分隔符
+ * @return {*}
+ */
+declare function calculateDateTime(n: number, dateSep?: string, timeSep?: string): string;
+
+declare const date_calculateDate: typeof calculateDate;
+declare const date_calculateDateTime: typeof calculateDateTime;
+declare const date_formatDate: typeof formatDate;
+declare namespace date {
+  export { date_calculateDate as calculateDate, date_calculateDateTime as calculateDateTime, date_formatDate as formatDate };
+}
+
+type EasingName = 'ease' | 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | string;
+
+interface Style {
+    [propName: string]: string | number;
+}
+/**
+ * 判断元素是否包含某个样式名
+ * @param {HTMLElement} el
+ * @param {string} className
+ * @returns {boolean}
+ */
+declare const hasClass: (el: HTMLElement, className: string) => boolean;
+/**
+ * 给元素增加样式名
+ * @param {HTMLElement} el
+ * @param {string} classNames
+ */
+declare const addClass: (el: HTMLElement, classNames: string) => void;
+/**
+ * 给元素移除样式名
+ * @param {HTMLElement} el
+ * @param {string} classNames
+ */
+declare const removeClass: (el: HTMLElement, classNames: string) => void;
+interface SetStyle {
+    (el: HTMLElement, key: string, val: string): void;
+    (el: HTMLElement, style: Style): void;
+}
+/**
+ * 设置元素样式
+ * @param {HTMLElement} el
+ * @param {string | Style} key
+ * @param {string} val
+ */
+declare const setStyle: SetStyle;
+/**
+ * 获取元素样式
+ * @param {HTMLElement} el
+ * @param {string} key
+ * @returns {string}
+ */
+declare const getStyle: (el: HTMLElement, key: string) => string;
+type ScrollElement = HTMLElement | Document | Window;
+interface SmoothScrollOptions {
+    el: ScrollElement;
+    to: number;
+    duration: number;
+    easing: EasingName;
+}
+declare function smoothScroll(options?: Partial<SmoothScrollOptions>): Promise<void>;
+type ReadyCallback = () => void;
+declare function isDomReady(): boolean;
+declare function onDomReady(callback: ReadyCallback): void;
+
+declare const dom_addClass: typeof addClass;
+declare const dom_getStyle: typeof getStyle;
+declare const dom_hasClass: typeof hasClass;
+declare const dom_isDomReady: typeof isDomReady;
+declare const dom_onDomReady: typeof onDomReady;
+declare const dom_removeClass: typeof removeClass;
+declare const dom_setStyle: typeof setStyle;
+declare const dom_smoothScroll: typeof smoothScroll;
+declare namespace dom {
+  export { dom_addClass as addClass, dom_getStyle as getStyle, dom_hasClass as hasClass, dom_isDomReady as isDomReady, dom_onDomReady as onDomReady, dom_removeClass as removeClass, dom_setStyle as setStyle, dom_smoothScroll as smoothScroll };
+}
+
+interface Params<T = string | number> {
+    [key: string]: T | Array<T>;
+}
+/**
+ * 解析查询参数，内部使用的是浏览器内置的 URLSearchParams 进行处理
+ * @param {string} queryString
+ * @returns {Params}
+ */
+declare const qsParse: (queryString: string) => Params;
+type LooseParamValue = string | number | boolean | Date | null | undefined;
+interface LooseParams<T = LooseParamValue> {
+    [key: string]: T | Array<T>;
+}
+type Replacer = (value: LooseParamValue) => string | null;
+/**
+ * 字符化查询对象，内部使用的是浏览器内置的 URLSearchParams 进行处理
+ * @param {LooseParams} query
+ * @param {Replacer} replacer
+ * @returns {string}
+ */
+declare const qsStringify: (query: LooseParams, replacer?: Replacer) => string;
+
+type qs_LooseParamValue = LooseParamValue;
+type qs_LooseParams<T = LooseParamValue> = LooseParams<T>;
+type qs_Params<T = string | number> = Params<T>;
+type qs_Replacer = Replacer;
+declare const qs_qsParse: typeof qsParse;
+declare const qs_qsStringify: typeof qsStringify;
+declare namespace qs {
+  export { type qs_LooseParamValue as LooseParamValue, type qs_LooseParams as LooseParams, type qs_Params as Params, type qs_Replacer as Replacer, qs_qsParse as qsParse, qs_qsStringify as qsStringify };
+}
+
+/**
+ * 通过打开新窗口的方式下载
+ * @param {string} url
+ * @param {LooseParams} params
+ */
+declare const downloadURL: (url: string, params?: LooseParams) => void;
+/**
+ * 通过 A 链接的方式下载
+ * @param {string} href
+ * @param {string} filename
+ */
+declare const downloadHref: (href: string, filename: string) => void;
+/**
+ * 将大文件对象通过 A 链接的方式下载
+ * @param {Blob} blob
+ * @param {string} filename
+ */
+declare const downloadBlob: (blob: Blob, filename: string) => void;
+type FileType = 'json' | 'csv' | 'xls' | 'xlsx';
+/**
+ * 将指定数据格式通过 A 链接的方式下载
+ * @param {AnyObject | AnyObject[]} data
+ * @param {FileType} fileType 支持 json/csv/xls/xlsx 四种格式
+ * @param {string} filename
+ * @param {string[]} [headers]
+ */
+declare const downloadData: (data: AnyObject | AnyObject[], fileType: FileType, filename: string, headers?: string[]) => void;
+
+declare const download_downloadBlob: typeof downloadBlob;
+declare const download_downloadData: typeof downloadData;
+declare const download_downloadHref: typeof downloadHref;
+declare const download_downloadURL: typeof downloadURL;
+declare namespace download {
+  export { download_downloadBlob as downloadBlob, download_downloadData as downloadData, download_downloadHref as downloadHref, download_downloadURL as downloadURL };
+}
+
+/**
+ * 判断对象是否为纯对象
+ * @param {object} obj
+ * @returns {boolean}
+ */
+declare const isPlainObject: (obj: unknown) => boolean;
+/**
+ * 判断对象内是否有该静态属性
+ * @param {object} obj
+ * @param {string} key
+ * @returns {boolean}
+ */
+declare const objectHas: <T extends AnyObject>(obj: T, key: keyof T) => boolean;
+/**
+ * 遍历对象，返回 false 中断遍历
+ * @param {O} obj
+ * @param {(val: O[keyof O], key: keyof O) => (boolean | void)} iterator
+ */
+declare const objectEach: <O extends AnyObject>(obj: O, iterator: (val: O[keyof O], key: Extract<keyof O, string>) => any) => void;
+/**
+ * 异步遍历对象，返回 false 中断遍历
+ * @param {O} obj
+ * @param {(val: O[keyof O], key: keyof O) => (boolean | void)} iterator
+ */
+declare function objectEachAsync<O extends AnyObject>(obj: O, iterator: (val: O[keyof O], key: Extract<keyof O, string>) => Promise<any> | any): Promise<void>;
+/**
+ * 对象映射
+ * @param {O} obj
+ * @param {(val: O[keyof O], key: Extract<keyof O, string>) => any} iterator
+ * @returns {Record<Extract<keyof O, string>, T>}
+ */
+declare function objectMap<O extends AnyObject, T>(obj: O, iterator: (val: O[keyof O], key: Extract<keyof O, string>) => any): Record<Extract<keyof O, string>, T>;
+/**
+ * 对象提取
+ * @param {O} obj
+ * @param {K} keys
+ * @returns {Pick<O, ArrayElements<K>>}
+ */
+declare function objectPick<O extends AnyObject, K extends Extract<keyof O, string>[]>(obj: O, keys: K): Pick<O, ArrayElements<K>>;
+/**
+ * 对象祛除
+ * @param {O} obj
+ * @param {K} keys
+ * @returns {Pick<O, ArrayElements<K>>}
+ */
+declare function objectOmit<O extends AnyObject, K extends Extract<keyof O, string>[]>(obj: O, keys: K): Omit<O, ArrayElements<K>>;
+type ObjectAssignItem = AnyObject | AnyArray;
+/**
+ * 对象合并，返回原始对象
+ * @param {ObjectAssignItem} source
+ * @param {ObjectAssignItem | undefined} targets
+ * @returns {R}
+ */
+declare const objectAssign: <R = AnyObject | AnyArray>(source: ObjectAssignItem, ...targets: (ObjectAssignItem | undefined)[]) => R;
+
+/**
+ * 对象填充
+ * @param {Partial<R>} source
+ * @param {Partial<R>} target
+ * @param {(s: Partial<R>, t: Partial<R>, key: keyof R) => boolean} fillable
+ * @returns {R}
+ */
+declare const objectFill: <R extends AnyObject = AnyObject>(source: Partial<R>, target: Partial<R>, fillable?: ((s: Partial<R>, t: Partial<R>, key: keyof R) => boolean) | undefined) => R;
+declare function objectGet(obj: AnyObject, path: string, strict?: boolean): {
+    p: any | undefined;
+    k: string | undefined;
+    v: any | undefined;
+};
+/**
+ * 深拷贝堪称完全体 即：任何类型的数据都会被深拷贝
+ * @param {AnyObject | AnyArray} obj
+ * @param {WeakMap} map
+ * @return {AnyObject | AnyArray}
+ */
+declare function cloneDeep(obj: Object, map?: WeakMap<WeakKey, any>): Object;
+
+declare const object_cloneDeep: typeof cloneDeep;
+declare const object_isPlainObject: typeof isPlainObject;
+declare const object_objectAssign: typeof objectAssign;
+declare const object_objectEach: typeof objectEach;
+declare const object_objectEachAsync: typeof objectEachAsync;
+declare const object_objectFill: typeof objectFill;
+declare const object_objectGet: typeof objectGet;
+declare const object_objectHas: typeof objectHas;
+declare const object_objectMap: typeof objectMap;
+declare const object_objectOmit: typeof objectOmit;
+declare const object_objectPick: typeof objectPick;
+declare namespace object {
+  export { object_cloneDeep as cloneDeep, object_isPlainObject as isPlainObject, object_objectAssign as objectAssign, object_objectEach as objectEach, object_objectEachAsync as objectEachAsync, object_objectFill as objectFill, object_objectGet as objectGet, object_objectHas as objectHas, object_objectMap as objectMap, objectAssign as objectMerge, object_objectOmit as objectOmit, object_objectPick as objectPick };
+}
+
+/**
+ * 标准化路径
+ * @param {string} path
+ * @returns {string}
+ */
+declare const pathNormalize: (path: string) => string;
+/**
+ * 路径合并
+ * @param {string} from
+ * @param {string} to
+ * @returns {string}
+ */
+declare const pathJoin: (from: string, ...to: string[]) => string;
+
+declare const path_pathJoin: typeof pathJoin;
+declare const path_pathNormalize: typeof pathNormalize;
+declare namespace path {
+  export { path_pathJoin as pathJoin, path_pathNormalize as pathNormalize };
+}
+
+/**
+ * 将字符串转换为驼峰格式
+ * @param {string} string
+ * @param {boolean} [bigger] 是否大写第一个字母
+ * @returns {string}
+ */
+declare const stringCamelCase: (string: string, bigger?: boolean) => string;
+/**
+ * 将字符串转换为连字格式
+ * @param {string} string
+ * @param {string} [separator] 分隔符，默认是"-"（短横线）
+ * @returns {string}
+ */
+declare const stringKebabCase: (string: string, separator?: string) => string;
+declare const STRING_ARABIC_NUMERALS = "0123456789";
+declare const STRING_LOWERCASE_ALPHA = "abcdefghijklmnopqrstuvwxyz";
+declare const STRING_UPPERCASE_ALPHA = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+/**
+ * 字符串格式化
+ * @example
+ * ```js
+ * stringFormat("My name is %s.", "zhangsan")
+ * // => "My name is zhangsan."
+ * ```
+ * @param {string} string 字符串模板，使用 %s 表示字符串，%d 表示数值，%o 表示对象，%% 表示百分号，参考 console.log
+ * @param args
+ * @returns {string}
+ */
+declare const stringFormat: (string: string, ...args: Array<unknown>) => string;
+/**
+ * 字符串赋值
+ * @example
+ * ```js
+ * stringAssign('My name is ${user}.', { user: 'zhangsan' });
+ * // => "My name is zhangsan."
+ * ```
+ * @param {string} template
+ * @param {AnyObject} data
+ * @returns {string}
+ */
+declare const stringAssign: (template: string, data: AnyObject) => string;
+/**
+ * 字符串编码 HTML
+ * @example
+ * ```js
+ * stringEscapeHtml('<b>You & Me speak "xixi"</b>')
+ * // => "&lt;b&gt;You &amp; Me speak &quot;xixi&quot;&lt;/b&gt;"
+ * ```
+ * @param {string} html
+ * @returns {string}
+ */
+declare const stringEscapeHtml: (html: string) => string;
+/**
+ * 字符串填充
+ * @param {number} length
+ * @param {string} value
+ * @returns {string}
+ */
+declare const stringFill: (length: number, value?: string) => string;
+
+declare const string_STRING_ARABIC_NUMERALS: typeof STRING_ARABIC_NUMERALS;
+declare const string_STRING_LOWERCASE_ALPHA: typeof STRING_LOWERCASE_ALPHA;
+declare const string_STRING_UPPERCASE_ALPHA: typeof STRING_UPPERCASE_ALPHA;
+declare const string_stringAssign: typeof stringAssign;
+declare const string_stringCamelCase: typeof stringCamelCase;
+declare const string_stringEscapeHtml: typeof stringEscapeHtml;
+declare const string_stringFill: typeof stringFill;
+declare const string_stringFormat: typeof stringFormat;
+declare const string_stringKebabCase: typeof stringKebabCase;
+declare namespace string {
+  export { string_STRING_ARABIC_NUMERALS as STRING_ARABIC_NUMERALS, string_STRING_LOWERCASE_ALPHA as STRING_LOWERCASE_ALPHA, string_STRING_UPPERCASE_ALPHA as STRING_UPPERCASE_ALPHA, string_stringAssign as stringAssign, string_stringCamelCase as stringCamelCase, string_stringEscapeHtml as stringEscapeHtml, string_stringFill as stringFill, string_stringFormat as stringFormat, string_stringKebabCase as stringKebabCase };
+}
+
+interface Url {
+    protocol: string;
+    auth: string;
+    username: string;
+    password: string;
+    host: string;
+    port: string;
+    hostname: string;
+    hash: string;
+    search: string;
+    searchParams: Params;
+    query: string;
+    pathname: string;
+    path: string;
+    href: string;
+}
+/**
+ * url 解析
+ * @param {string} url
+ * @returns {Url}
+ */
+declare const urlParse: (url: string) => Url;
+/**
+ * url 字符化，url 对象里的 searchParams 会覆盖 url 原有的查询参数
+ * @param {Url} url
+ * @returns {string}
+ */
+declare const urlStringify: (url: Url) => string;
+/**
+ * 设置 url 查询参数
+ * @param {string} url
+ * @param {AnyObject} setter
+ * @returns {string}
+ */
+declare const urlSetParams: (url: string, setter: AnyObject) => string;
+/**
+ * 删除 url 查询参数
+ * @param {string} url
+ * @param {string[]} removeKeys
+ * @returns {string}
+ */
+declare const urlDelParams: (url: string, removeKeys: string[]) => string;
+
+declare const url_urlDelParams: typeof urlDelParams;
+declare const url_urlParse: typeof urlParse;
+declare const url_urlSetParams: typeof urlSetParams;
+declare const url_urlStringify: typeof urlStringify;
+declare namespace url {
+  export { url_urlDelParams as urlDelParams, url_urlParse as urlParse, url_urlSetParams as urlSetParams, url_urlStringify as urlStringify };
+}
+
+/**
+ * 等待一段时间
+ * @param {number} timeout 等待时间，单位毫秒
+ * @returns {Promise<void>}
+ */
+declare function wait(timeout?: number): Promise<void>;
+/**
+ * 异步遍历
+ * @ref https://github.com/Kevnz/async-tools/blob/master/src/mapper.js
+ * @ref https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/@@iterator
+ * @param {Array<T>} list
+ * @param {(val: T, idx: number, list: ArrayLike<T>) => Promise<R>} mapper
+ * @param {number} concurrency 并发数量，默认无限
+ * @returns {Promise<R[]>}
+ */
+declare function asyncMap<T, R>(list: Array<T>, mapper: (val: T, idx: number, list: Array<T>) => Promise<R>, concurrency?: number): Promise<R[]>;
+
+declare const async_asyncMap: typeof asyncMap;
+declare const async_wait: typeof wait;
+declare namespace async {
+  export { async_asyncMap as asyncMap, async_wait as wait };
+}
+
+/**
+ * 选择本地文件
+ * @param {function} changeCb 选择文件回调
+ * @return {*}
+ */
+declare function chooseLocalFile({ accept }: {
+    accept: any;
+}, changeCb: (FileList: any) => any): HTMLInputElement;
+
+declare const file_chooseLocalFile: typeof chooseLocalFile;
+declare namespace file {
+  export { file_chooseLocalFile as chooseLocalFile };
+}
+
+interface ICanvasWM {
+    container: HTMLElement;
+    width: string;
+    height: string;
+    textAlign: CanvasTextAlign;
+    textBaseline: CanvasTextBaseline;
+    font: string;
+    fillStyle: string;
+    content: string;
+    rotate: number;
+    zIndex: number;
+}
+/**
+ * canvas 实现 watermark
+ * @param {ICanvasWM} canvasWM
+ */
+declare const genCanvasWM: (canvasWM: ICanvasWM) => void;
+
+export { array, async, clipboard, cookie, date, dom, download, file, genCanvasWM, object, path, qs, string, type, url };