utils-lib-js 1.7.18 → 1.7.19

package/README.en.md

@@ -1,516 +1,534 @@
 # utils-lib-js
 
-#### 介绍
-JavaScript工具函数，封装的一些常用的js函数
+#### Introduction
+JavaScript utility functions, packaging some commonly used js functions
 
-#### 软件架构
-软件架构说明
+#### Software Architecture
+Software architecture specification
 
 
-#### 安装教程
+#### installation tutorial
 
 1.  pnpm i
 2.  pnpm build
 
-#### 使用说明
+#### Usage instructions
 
-1.  pnpm build（构建）
-2.  pnpm debug（调试源码）
+1. pnpm build
+2. pnpm debug (debug source)
 
-#### 参与贡献
+#### Contribute
 
-1.  Fork 本仓库
-2.  新建 Feat_xxx 分支
-3.  提交代码
-4.  新建 Pull Request
+1. Fork the local warehouse
+2. Create a branch of Feat_xxx
+3. Submit the code
+4. Create a Pull Request
 
-#### 功能
-接口：
+#### function
+Interface:
 
 export type IKey = string | symbol | number
 
-##### 对象类型
+##### Object type
 
 export interface IObject<T> {
-    [key: IKey]: T | IObject<any>
+[key: IKey]: T | IObject<any>
 }
 
 export interface IPromise extends IObject<any> {
-    promise: Promise<void>
-    resolve: (res: any) => unknown
-    reject: (err: any) => unknown
+promise: Promise<void>
+resolve: (res: any) => unknown
+reject: (err: any) => unknown
 }
 
 export type IInstance<T> = {
-    _instance: Function
+_instance: Function
 } & T
 
 export type IDemoteArray<T> = Array<IDemoteArray<T> | T>
 
 ##### base
 
-/**产生区间随机数
-* @param {number} min  最小区间
-* @param {number} max  最大区间
-* @param {boolean} bool  包含最大值
-* @return {number} 随机数
-**/
+/** Generates interval random numbers
+* @param {number} min Minimum interval
+* @param {number} max Maximum range
+* @param {boolean} bool Contains the maximum value
+* @return {number} A random number
+* * /
 
-export type IRandomNum = (min: number, max: number, bool?: boolean) => number
+export type IRandomNum = (min: number, max: number, bool? : boolean) => number
 
-/**获取url的参数
-* @param {string} url  待截取的地址
-* @return {object} 参数对象
-**/
+/** Gets the parameters of the url
+* @param {string} url Indicates the address to be intercepted
+* @return {object} Parameter object
+* * /
 
 export type IUrlSplit = (url: string) => IObject<any>
 
-/**添加url的参数
-* @param {string} url  待添加参数的地址
-* @param {object} query  待添加的参数
-* @return {string} 添加参数后的url
-**/
+/** Adds parameters for the url
+* @param {string} url Address to which the parameter is to be added
+* @param {object} query Specifies the parameter to be added
+* @return {string} The url after the parameter is added
+* * /
 
 export type IUrlJoin = (url: string, query: object) => string
 
-/**获取数据类型
-* @param {any} data  待检测数据
-* @return {string} 数据类型
-**/
+/** Gets the data type
+* @param {any} data Indicates the data to be detected
+* @return {string} Data type
+* * /
 
 export type IGetType<T> = (data: any) => typeof data | T[keyof T] | "null";
 
-/**批量判断数据类型
-* @param {any} data  待检测数据
-* @param {any} whiteList  数据类型名单
-* @return {boolean} 是否在白名单中
-**/
+/** Determine the data type in batches
+* @param {any} data Indicates the data to be detected
+* @param {any} whiteList Indicates a list of data types
+* @return {boolean} Whether it is in the whitelist
+* * /
 
 export type IGetTypeByList = (data: any, whiteList: string[]) => boolean;
 
 
 ##### object
 
-/**lodash中的 _.get()，获取对象某级属性
-* @param {IObject} object  目标对象
-* @param {string} key  对象层级
-* @param {any} defaultValue  未取得时默认值
-* @return {IObject[IKey]} 对象某个属性
-**/
+/**lodash _.get() to get a certain level attribute of the object
+* @param {IObject} object Indicates the target object
+* @param {string} key object hierarchy
+* @param {any} defaultValue Default value if not obtained
+* @return {IObject[IKey]} A property of an object
+* * /
 
-export type IGetValue = <T, U = IObject<T> | IObject<T>[IKey]>(object: U, key: string, defaultValue?: any) => U
+export type IGetValue = <T, U = IObject<T> | IObject<T>[IKey]>(object: U, key: string, defaultValue? : any) => U
 
-/**lodash中的 _.set()，赋值对象某级属性
-* @param {IObject} object  目标对象
-* @param {string} key  对象层级
-* @param {any} value  需要赋的值
-* @return {IObject} 目标对象
-**/
+/**lodash _.set(), which assigns a level attribute to the object
+* @param {IObject} object Indicates the target object
+* @param {string} key object hierarchy
+* @param {any} value Specifies the value to be assigned
+* @return {IObject} Target object
+* * /
 
-export type ISetValue = <T>(object: IObject<T>, key: string, value?: any) => IObject<T>
+export type ISetValue = <T>(object: IObject<T>, key: string, value? : any) => IObject<T>
 
-/**对象混入
-* @param {IObject} target  目标对象
-* @param {string} source  需要混入的对象集合
-* @param {boolean} overwrite  是否重写覆盖原有属性
-* @return {IObject} 目标对象
-**/
+/** Object mixed in
+* @param {IObject} target Indicates the target object
+* @param {string} source Set of objects to be mixed in
+* @param {boolean} overwrite Whether to overwrite the original attribute
+* @return {IObject} Target object
+* * /
 
-export type IMixIn = <U extends IObject<any>>(target?: U, source?: IObject<any>, overwrite?: boolean) => U
+export type IMixIn = <U extends IObject<any>>(target? : U, source? : IObject<any>, overwrite? : boolean) => U
 
-/**枚举值反向映射
-* @param {IObject<string>} target  目标对象
-* @return {IObject<string>} 目标对象
-**/
+/** Enumeration value reverse mapping
+* @param {IObject<string>} target Indicates the target object
+* @return {IObject<string>} Target object
+* * /
 
 export type IEnumInversion = (target: IObject<string>) => IObject<string>
 
-/**对象复制
-* @param {IObject<any>} target  目标对象
-* @return {IObject} 目标对象
-**/
+/** Object replication
+* @param {IObject<any>} target Indicates the target object
+* @return {IObject} Target object
+* * /
 
-export type ICloneDeep = (target?: any) => any
+export type ICloneDeep = (target? : any) => any
 
-/**生成 对象 类型的初始值
-* @param {string} type  数据类型
-* @param {any} __init  初始值
-* @return {any} 目标对象
-**/
+/** Generates the initial value of the object type
+* @param {string} type Indicates the data type
+* @param {any} __init Initial value
+* @return {any} Target object
+* * /
 
-export type ICreateObjectVariable = (type: string, source?: any) => any
+export type ICreateObjectVariable = (type: string, source? : any) => any
 
-/**Object.create 根据源对象产出新对象
-* @param {Function|Object} source  源对象
-* @return {Function|Object} 对象产物
-**/
+/** object. create generates a new Object based on the source object
+* @param {Function|Object} source Source object
+* @return {Function|Object} Object product
+* * /
 
 export type ICreateObject = <T, U extends T>(source: T) => U
 
-/**类的继承
-* @param {Function} source  源对象
-* @return {Function} 继承产物
-**/
+Inheritance of the /** class
+* @param {Function} source Source object
+* @return {Function} inheritance product
+* * /
 
-export type IInherit = <T extends Function>(source: T, target?: Function) => Function
+export type IInherit = <T extends Function>(source: T, target? : Function) => Function
 
-/**生成类的实例单例
-* @param {Function} classProto  类
-* @param {Boolean} overwrite  是否覆盖已有单例
-* @param {any[]} params  构造函数的参数
-* @return {IObject} 实例化的单例
-**/
+/** Generates an instance singleton of the class
+* @param {Function} classProto class
+* @param {Boolean} overwrite Whether to overwrite an existing singleton
+* @param {any[]} Parameter of the params constructor
+* @return {IObject} instantiated singleton
+* * /
 
-export type IGetInstance = (classProto: IInstance<FunctionConstructor>, overwrite?: boolean, ...params: any[]) => Function
+export type IGetInstance = (classProto: IInstance<FunctionConstructor>, overwrite? : boolean, ... params: any[]) => Function
 
-/**通过装饰器将属性混入类中
-* @param {IObject<any>} params  混入的属性
-* @return {ClassDecorator} 装饰器钩子函数
-**/
+/** Mixes attributes into classes via decorators
+* @param {IObject<any>} params mixed property
+* @return {ClassDecorator} Decorator hook function
+* * /
 
 export type IClassDecorator = (params: IObject<any>) => <TFunction extends Function>(target: TFunction) => void
 
-/**JSON.parse封装
-* @param {string} target  字符串
-* @return {IObject<any>} 对象
-**/
+/**JSON.parse package
+* @param {string} target string
+* @return {IObject<any>} object
+* * /
 
 export type IStringToJson = (target: string) => IObject<any>
 
-/**JSON.stringify封装
-* @param {IObject<any>} target  对象
-* @return {string} 字符串
-**/
+/**JSON.stringify encapsulation
+* @param {IObject<any>} target object
+* @return {string} A string
+* * /
 
 export type IJsonToString = (target: IObject<any>) => string
 
 ##### function
 
-/**节流(throttle):高频事件触发，但在 n 秒内只会执行一次
-* @param {Function} fn  节流处理的函数
-* @param {number} time  执行间隔/毫秒
-* @return {Function} 处理后的函数
-**/
+/** throttle: A high-frequency event is triggered, but only once in n seconds
+* @param {Function} fn Function for throttling
+* @param {number} time Execution interval/ms
+* @return {Function} Function after processing
+* * /
 
-export type IThrottle = (fn: Function, time: number) => (...args: any[]) => void
+export type IThrottle = (fn: Function, time: number) => (... args: any[]) => void
 
-/**防抖(debounce):触发高频事件后 n 秒内函数只会执行一次
-* @param {Function} fn  防抖处理的函数
-* @param {number} time  允许运行函数间隔/毫秒
-* @return {Function} 处理后的函数
-**/
+/** debounce: The function executes only once within n seconds after a high-frequency event is triggered
+* @param {Function} fn Function for anti-shake processing
+* @param {number} time Allows running function intervals/milliseconds
+* @return {Function} Function after processing
+* * /
 
-export type IDebounce = (fn: Function, time: number) => (...args: any[]) => void
+export type IDebounce = (fn: Function, time: number) => (... args: any[]) => void
 
-/**
- * Promise扁平化，避免Promise嵌套
- * @param {number} timer  超时
- * @returns {Promise,resolve,reject} 
- */
+/ * *
+* Promise flattening to avoid Promise nesting
+* @param {number} timer times out
+* @returns {Promise,resolve,reject}
+* /
 export type IDefer = (timer: number) => IPromise
 
-/**await与try catch 捕获异常处理方法
- * @param {Promise<any>} defer  延迟函数
- * @returns {Promise<any>} [error, result]
- */
-
+/**await and try catch catch exception handling methods
+* @param {Promise<any>} defer the delay function
+* @returns {Promise<any>} [error, result]
+* /
 export type ICatchAwait<T extends Promise<any>> = (defer: T) => T
-
 ##### array
 
-/**数组乱序
- * @param {Array<any>} arr  目标数组
- * @returns {Array<any>} 乱序后的数组
- */
- 
+/** The array is out of order
+* @param {Array<any>} arr target array
+* @returns {Array<any>} The array is out of order
+* /
+
 export type IArrayRandom<T extends any[]> = (arr: T) => T
 
-/**数组数组去重
- * @param {Array<any>} arr  目标数组
- * @returns {Array<any>} 去重后的数组
- */
+/** array array weight removal
+* @param {Array<any>} arr target array
+* @returns {Array<any>} Specifies the array after deduplication
+* /
 
 export type IArrayUniq<T extends any[]> = (arr: T) => T
 
-/**数组扁平化
- * @param {Array<any>} arr  目标数组
- * @returns {Array<any>} 扁平化的数组
- */
+/** Array flattens
+* @param {Array<any>} arr target array
+* @returns {Array<any>} A flat array
+* /
 
-export type IArrayDemote<T extends IDemoteArray<any>> = (arr: T, result?: T) => T
+export type IArrayDemote<T extends IDemoteArray<any>> = (arr: T, result? : T) => T
 
 ##### element
 
 /**IElementParams
- * @param {string} ele 标签类型
- * @param {CSSStyleDeclaration} style 样式
- * @param {Attr} attr 属性
- * @param {object} parent 父元素
- */
+* @param {string} ele Label type
+* @param {CSSStyleDeclaration} style
+* @param {Attr} attr attribute
+* @param {object} parent Parent element
+* /
 
 interface IElementParams<T> {
-    ele: T | string
-    style: CSSStyleDeclaration
-    attr: Attr
-    parent: T
+ele: T | string
+style: CSSStyleDeclaration
+attr: Attr
+parent: T
 }
 
-/**新增标签，设置属性及样式
- * @param {IElementParams} params 配置
- * @return {ElementObject} 生成的标签
- */
+/** Add labels, set properties and styles
+* @param {IElementParams} params configuration
+* @return {ElementObject} Generated label
+* /
 
 export type ICreateElement<T = HTMLElement> = (params: IElementParams<T>) => T
 
 ##### event
 
-/**浏览器事件
- * @param {Document} ele 标签
- * @param {string} type 事件类型
- * @param {(e: Event) => void} handler 事件回调
- * @return {void}
- */
+/** Browser events
+* @param {Document} ele tag
+* @param {string} type Event type
+* @param {(e: Event) => void} handler Event callback
+* @return {void}
+* /
 
 export type IAddHandler = <T extends Document>(ele: T, type: string, handler: (e: Event) => void) => void
 
-/**取消事件冒泡
- * @param {Event} e 浏览器事件对象
- * @return {void}
- */
+/** Cancel event bubbling
+* @param {Event} e Browser event object
+* @return {void}
+* /
 
 export type IStopBubble = (e: Event) => void
 
-/**取消默认事件
- * @param {Event} e 浏览器事件对象
- * @return {void}
- */
+/** Cancels the default event
+* @param {Event} e Browser event object
+* @return {void}
+* /
 
 export type IStopDefault = (e: Event) => void
 
-/**取消浏览器事件
- * @param {Document} ele 标签
- * @param {string} type 事件类型
- * @param {(e: Event) => void} handler 事件回调
- * @return {void}
- */
+/** Cancels browser events
+* @param {Document} ele tag
+* @param {string} type Event type
+* @param {(e: Event) => void} handler Event callback
+* @return {void}
+* /
 
 export type IRemoveHandler = <T extends Document>(ele: T, type: string, handler: (e: Event) => void) => void
 
-/**取消默认事件
- * @param {Event} e 浏览器事件对象
- * @return {void}
- */
+/** Cancels the default event
+* @param {Event} e Browser event object
+* @return {void}
+* /
 
 export type IDispatchEvent = <T extends Document>(ele: T, data: any) => void
 
 
 ##### log
 
-/** 单行输出
- * @param {string} str 输出字符
- * @param {boolean} overwrite 覆盖前面的输出
- * @param {boolean} warp 最后一行换行
- * @return {void}
- */
-export type ILogOneLine = (str: string, overwrite?: boolean, warp?: boolean) => void
-
-/** 循环输出某个队列
- * @param {string[]} loopList 输出的字符队列
- * @param {number} index 第几个字符
- * @param {boolean} isStop 控制暂停循环
- * @param {number} timer 两个相隔时间间隔
- */
+/** Single line output
+* @param {string} str Output character
+* @param {boolean} overwrite overwrites the previous output
+* @param {boolean} warp Wrap the last line
+* @return {void}
+* /
+export type ILogOneLine = (str: string, overwrite? : boolean, warp? : boolean) => void
+
+/** Loops out a queue
+* @param {string[]} loopList Indicates the output character queue
+* @param {number} index The number of characters
+* @param {boolean} isStop Control pause loop
+* @param {number} timer Indicates two interval times
+* /
 export type ILogLoopParams = {
-    loopList?: string[]
-    index?: number
-    isStop?: boolean
-    timer?: number
+loopList? : string[]
+index? : number
+isStop? : boolean
+timer? : number
 }
-export type ILogLoop = (opts?: ILogLoopParams) => ILogLoopParams | void
+export type ILogLoop = (opts? : ILogLoopParams) => ILogLoopParams | void
 
 ##### request
 
 export type IRequestParams<T> = T | IObject<any> | null
 
-// 请求路径
+// Request path
 
 export type IUrl = string
 
-// 环境判断
+// Environmental judgment
 
 export type IEnv = 'Window' | 'Node'
 
-// fetch返回取值方式
+// fetch Returns the value
 
 export type IDataType = "text" | "json" | "blob" | "formData" | "arrayBuffer"
 
-// 请求方式
+// Request mode
 
 export type IRequestMethods = "GET" | "POST" | "DELETE" | "PUT" | "OPTION"
 
-// body结构
+// body structure
 
 export type IRequestBody = IRequestParams<BodyInit>
 
-// heads结构
+// heads structure
 
 export type IRequestHeaders = IRequestParams<HeadersInit>
 
-// 请求基础函数
+// Request the base function
 
 export type IRequestBaseFn = (url: IUrl, opts: IRequestOptions) => Promise<any>
 
-// 请求函数体
+// Request function body
 
-export type IRequestFn = (url?: IUrl, query?: IObject<any>, body?: IRequestBody, opts?: IRequestOptions) => Promise<any>
+export type IRequestFn = (url? : IUrl, query? : IObject<any>, body? : IRequestBody, opts? : IRequestOptions) => Promise<any>
 
-// 请求参数
+// Request parameters
 
 export type IRequestOptions = {
-    method?: IRequestMethods
-    query?: IRequestParams<IObject<any>>
-    body?: IRequestBody
-    headers?: IRequestHeaders
-    controller?: AbortController
-    timeout?: number
-    timer?: number | unknown | null
-    [key: string]: any
+method? : IRequestMethods
+query? : IRequestParams<IObject<any>>
+body? : IRequestBody
+headers? : IRequestHeaders
+controller? : AbortController
+timeout? : number
+timer? : number | unknown | null
+[key: string]: any
 }
 
-// 拦截器
+// Interceptor
 
 export type IInterceptors = {
-    use(type: "request" | "response" | "error", fn: Function): void
-    get reqFn(): Function
-    get resFn(): Function
-    get errFn(): Function
+use(type: "request" | "response" | "error", fn: Function): void
+get reqFn(): Function
+get resFn(): Function
+get errFn(): Function
 }
 
-// 公共函数
+// Public function
 
 export type IRequestBase = {
-    readonly origin: string
-    chackUrl: (url: IUrl) => boolean
-    envDesc: () => IEnv
-    errorFn: <Err = any, R = Function>(reject: R) => (err: Err) => R
-    clearTimer: (opts: IRequestOptions) => void
-    initAbort: <T = IRequestOptions>(opts: T) => T
-    requestType: () => IRequestBaseFn
-    fixOrigin: (fixStr: string) => string
-    fetch: IRequestBaseFn
-    http: IRequestBaseFn
-    getDataByType: (type: IDataType, response: Response) => Promise<any>
+readonly origin: string
+chackUrl: (url: IUrl) => boolean
+envDesc: () => IEnv
+errorFn: <Err = any, R = Function>(reject: R) => (err: Err) => R
+clearTimer: (opts: IRequestOptions) => void
+initAbort: <T = IRequestOptions>(opts: T) => T
+requestType: () => IRequestBaseFn
+fixOrigin: (fixStr: string) => string
+fetch: IRequestBaseFn
+http: IRequestBaseFn
+getDataByType: (type: IDataType, response: Response) => Promise<any>
 }
 
-// 初始化参数
+// Initialize parameters
 
 export type IRequestInit = {
-    initDefaultParams: (url: IUrl, opts: IRequestOptions) => any
-    initFetchParams: (url: IUrl, opts: IRequestOptions) => any
-    initHttpParams: (url: IUrl, opts: IRequestOptions) => any
+initDefaultParams: (url: IUrl, opts: IRequestOptions) => any
+initFetchParams: (url: IUrl, opts: IRequestOptions) => any
+initHttpParams: (url: IUrl, opts: IRequestOptions) => any
 }
 
-// 请求主体类
+// Request principal class
 
 export type IRequest = {
-    GET: IRequestFn
-    POST: IRequestFn
-    DELETE: IRequestFn
-    PUT: IRequestFn
-    OPTIONS: IRequestFn
-    HEAD: IRequestFn
-    PATCH: IRequestFn
+GET: IRequestFn
+POST: IRequestFn
+DELETE: IRequestFn
+PUT: IRequestFn
+OPTIONS: IRequestFn
+HEAD: IRequestFn
+PATCH: IRequestFn
 } & IRequestBase
-
-
-<!-- 消息中心 -->
-// 消息中心
+<! -- News Center -->
+// Message Center
 export declare interface Handlers {
-    [key: string]: Array<Function>
+[key: string]: Array<Function>
 }
 export declare interface IMessageCenter {
-    events: Handlers
-    _instance?: IMessageCenter
-    on: (type: string, handler: Function) => this
-    emit: (type: string, data?: any) => this
-    un: (type: string, handler?: Function) => this
-    once: (type: string, handler: Function) => this
-    clear: () => this
-    has: (type: string) => boolean
-    handlerLength: (type: string) => number
-    watch: (type: string, handler: Function) => this
-    invoke: (type: string, data?: any) => Promise<void>
+events: Handlers
+_instance? : IMessageCenter
+on: (type: string, handler: Function) => this
+emit: (type: string, data? : any) => this
+un: (type: string, handler? : Function) => this
+once: (type: string, handler: Function) => this
+clear: () => this
+has: (type: string) => boolean
+handlerLength: (type: string) => number
+watch: (type: string, handler: Function) => this
+invoke: (type: string, data? : any) => Promise<void>
 }
 
 https://gitee.com/DieHunter/message-center
 
-<!-- 任务队列 -->
+<! -- Task Queue -->
 
-/**
- * 单条队列
- * defer: 待运行的异步函数
- * params?: defer的参数，也可以用bind直接传递
- * 
- */
+/ * *
+* Single queue
+* defer: asynchronous function to be run
+* params? The: defer parameter can also be passed directly using bind
+*
+* /
 export interface IQueue {
-    defer: Function
-    name?: string
+defer: Function
+name? : string
 }
-/**
- * 队列参数
- * children: 队列列表
- * name: 队列唯一标识
- * result: 运行完成后的结果
- * 
- */
+/ * *
+* Queue parameter
+* children: Queue list
+* name: indicates the unique identifier of the queue
+* result: indicates the result after the run is complete
+*
+* /
 export interface IQueues {
-    children: Array<Function>
-    name: string
-    result?: any[]
+children: Array<Function>
+name: string
+result? : any[]
 }
-/**
- * 队列缓存
- */
+/ * *
+* queue cache
+* /
 export type IQueueTemp = {
-    [key: string]: IQueues
+[key: string]: IQueues
 }
-/**
- * 系统队列
- */
+/ * *
+* System queue
+* /
 export type IQueueList = Array<IQueue>
-/**
- * 队列状态 idle:空闲 pending:等待 fulfilled:完成 rejected:失败
- */
+/ * *
+* The queue status idle: idle pending: waiting fulfilled: completed rejected: failed
+* /
 export type IState = "idle" | "pending" | "fulfilled" | "rejected"
-/**
- * 任务队列参数
- */
+/ * *
+* Task queue parameters
+* /
 export type ITaskQueueProps = {
-    maxLen: number
+maxLen: number
 }
-/**
- * 任务队列
- */
+/ * *
+* Task queue
+* /
 export type ITaskQueue = {
-    readonly fix: string
-    props: ITaskQueueProps
-    queueTemp: IQueueTemp
-    queues: IQueueList
-    state: IState
-    push: (queue: IQueues) => Promise<void>
-    unshift: (length: number) => IQueueList
-    run: (reject: any) => unknown
-    clear: () => void
+readonly fix: string
+props: ITaskQueueProps
+queueTemp: IQueueTemp
+queues: IQueueList
+state: IState
+push: (queue: IQueues) => Promise<void>
+unshift: (length: number) => IQueueList
+run: (reject: any) => unknown
+clear: () => void
 }
 
 https://gitee.com/DieHunter/task-queue
 
-/** 单行输出
- * @param {string} str 输出字符
- * @param {boolean} overwrite 覆盖前面的输出
- * @param {boolean} warp 最后一行换行
- * @return {void}
- */
+/** Single line output
+* @param {string} str Output character
+* @param {boolean} overwrite overwrites the previous output
+* @param {boolean} warp Wrap the last line
+* @return {void}
+* /
 export function logOneLine(str: string): void
-export function logOneLine(str: string, overwrite?: boolean): void
-export function logOneLine(str: string, overwrite?: boolean, warp?: boolean): void
+export function logOneLine(str: string, overwrite? : boolean): void
+export function logOneLine(str: string, overwrite? : boolean, warp? : boolean): void
+
+
+// animate
+
+/ * *
+* Animation
+* reference: https://gitee.com/DieHunter/myCode/tree/master/%E5%89%8D%E7%AB%AF%E5%8A%A8%E7%94%BB/js
+*
+* /
+export type IAnimateFrame = {
+id: number | null // Animation index
+duration: number // Frame number control
+isActive: boolean// Activate control
+fn(timer: number): void
+start(duration: number): void
+stop(): void
+animate(timer: number): void
+}
+declare var IAnimateFrame: {
+new(fn: (timer: number) => void): IAnimateFrame
+prototype: IAnimateFrame
+}