minutool 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1178 @@
+/**
+ * 数组分块
+ * @param {Array} list 数据
+ * @param {Number} size 每块大小
+ * @return {Array[]}
+ */
+export declare const arrayChunk: <T = any>(list: T[], size: number) => T[][];
+
+/**
+ * array_column
+ * @param arr
+ * @param col_name
+ * @returns {Array}
+ */
+export declare const arrayColumn: <T = any>(arr: T[], col_name: keyof T) => any[];
+
+/**
+ * 数组去重
+ * @param {Array} arr
+ * @returns {*}
+ */
+export declare const arrayDistinct: <T = any>(arr: T[]) => T[];
+
+/**
+ * array group
+ * @param arr
+ * @param by_key
+ * @param limit limit one child
+ * @returns {*}
+ */
+export declare const arrayGroup: <T extends Record<string, any>>(arr: T[], by_key: keyof T, limit?: boolean) => Record<string, T[]> | Record<string, T>;
+
+/**
+ * @param arr
+ * @param val
+ * @return {string|null}
+ */
+export declare const arrayIndex: <T = any>(arr: T[], val: T) => string | null;
+
+/**
+ * 按照对象 KEY 排序
+ * @param {Object} obj
+ * @return {{}}
+ */
+export declare const arraySortByKey: <T extends Record<string, any>>(obj: T) => T;
+
+/**
+ * 从数组末尾开始移除值为 falsy 的元素，直到遇到第一个 truthy 元素
+ * @param arr 要处理的数组
+ * @returns 处理后的数组
+ */
+export declare const arrayTrimTail: (arr: any[]) => any[];
+
+/**
+ * base64 解码
+ * @param {string} text
+ * @returns {string}
+ */
+export declare const base64Decode: (text: string) => string;
+
+/**
+ * text 转 base64
+ * @param {String} text
+ * @return {string}
+ * @constructor
+ */
+export declare const Base64Encode: (text: string) => string;
+
+/**
+ * URL 安全模式进行 base64 编码
+ * @param {String} text
+ * @return {string}
+ */
+export declare const base64UrlSafeEncode: (text: string) => string;
+
+/**
+ * 检测指定值是否在指定区间内
+ * @param {Number} val
+ * @param {Number} min
+ * @param {Number} max
+ * @param {Boolean} includeEqual 是否包含等于判断
+ * @returns {boolean}
+ */
+export declare const between: (val: number, min: number, max: number, includeEqual?: boolean) => boolean;
+
+/**
+ * 转换blob数据到base64
+ * @param {Blob} blob
+ * @returns {Promise<unknown>}
+ */
+export declare const blobToBase64: (blob: Blob) => Promise<unknown>;
+
+export declare const blobToDataUri: (blob: Blob) => Promise<string>;
+
+/**
+ * 块元素
+ * 用大写定义，方便直接匹配 node.tagName
+ * @type {string[]}
+ */
+export declare const BLOCK_TAGS: string[];
+
+/**
+ * 构建 HTML Input:hidden 标签
+ * @param {Object} maps {key:value}
+ * @return {string}
+ */
+export declare const buildHtmlHidden: (maps: Record<string, any>) => string;
+
+export declare const buildStyleVars: (vars: Record<string, number | string | undefined>) => Record<string, string>;
+
+/**
+ * 驼峰命名转换
+ * @param str - 输入字符串
+ * @returns 驼峰命名的字符串
+ * @example
+ * camelCase('hello-world') // 'helloWorld'
+ * camelCase('hello_world') // 'helloWorld'
+ */
+export declare function camelCase(str: string): string;
+
+/**
+ * 首字母大写
+ * @param str - 输入字符串
+ * @returns 首字母大写的字符串
+ * @example
+ * capitalize('hello') // 'Hello'
+ */
+export declare function capitalize(str: string): string;
+
+/**
+ * 清理对象中的 null 值
+ */
+export declare const cleanNull: (obj: any, recursive?: boolean) => any;
+
+/**
+ * 计时（该方法采用timeout方式，不够精准
+ * @param {Number} timeout
+ * @param {Function} tickFunc
+ * @param {Function} onFinish
+ */
+export declare const countDown: (timeout: number, tickFunc?: (timeout: number) => void, onFinish?: () => void) => void;
+
+/**
+ * 创建HTML节点
+ * @param {String} html
+ * @param {HTMLElement|null} parentNode 父级节点
+ * @returns {HTMLElement|HTMLElement[]}
+ */
+export declare const createDomByHtml: (html: string, parentNode?: HTMLElement | null) => Node | Node[];
+
+/**
+ * CSS 选择器转义
+ * @param {String} str
+ * @returns {String}
+ */
+export declare const cssSelectorEscape: (str: string) => string;
+
+/**
+ * 中英文字符串截取（中文按照2个字符长度计算）
+ * @param str
+ * @param len
+ * @param eclipse_text
+ * @returns {*}
+ */
+export declare const cutString: (str: string, len: number, eclipse_text?: string) => string;
+
+export declare const DATE_NOW: number;
+
+export declare const DAY_FRIDAY = 5;
+
+export declare const DAY_MONDAY = 1;
+
+export declare const DAY_SATURDAY = 6;
+
+export declare const DAY_SUNDAY = 0;
+
+export declare const DAY_THURSDAY = 4;
+
+export declare const DAY_TUESDAY = 2;
+
+export declare const DAY_WEDNESDAY = 3;
+
+/**
+ * 在事件被触发n秒后再执行回调，如果在这n秒内又被触发，则重新计时。
+ * @param {Function} fn
+ * @param {Number} intervalMiSec
+ * @return {(function(): void)|*}
+ */
+export declare const debounce: (fn: Function, intervalMiSec: number) => Function;
+
+export declare const decodeHTMLEntities: (str: string) => string;
+
+/**
+ * 深拷贝对象
+ * @param obj - 要拷贝的对象
+ * @returns 拷贝后的新对象
+ * @example
+ * deepClone({ a: 1, b: { c: 2 } })
+ */
+export declare function deepClone<T>(obj: T): T;
+
+/**
+ * 删除cookie
+ * @param name
+ */
+export declare const deleteCookie: (name: string) => void;
+
+/**
+ * 检测数值最大精度
+ * @param  {...any} numbers 待检测数值
+ * @returns
+ */
+export declare const detectedPrecision: (...numbers: number[]) => number;
+
+export declare const detectLanguage: (supportedLngs: string[]) => any;
+
+/**
+ * 计算数字位数
+ * @param {Number} n
+ * @returns
+ */
+export declare const digitCount: (n: number) => number;
+
+declare interface Dimension {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+
+/**
+ * 禁用元素（禁止交互，设置disabled）
+ * @param {String|Node} el
+ * @param {String} disabledClass
+ */
+export declare const disabled: (el: HTMLElement | string, disabledClass?: string) => void;
+
+/**
+ * 下载文件
+ * @param {String} uri
+ * @param {String} fileName
+ */
+export declare const downloadFile: (uri: string, fileName: string) => void;
+
+/**
+ * 启用元素（允许交互，移除disabled）
+ * @param {String|Node} el
+ * @param {String} disabledClass
+ */
+export declare const enabled: (el: HTMLElement | string, disabledClass?: string) => void;
+
+/**
+ * 进入全屏模式
+ * @param {HTMLElement} element
+ */
+export declare const enterFullScreen: (element: any) => Promise<void>;
+
+/**
+ * HTML实例转字符串
+ * @param {string} entity
+ * @returns {string}
+ */
+export declare const entityToString: (entity: string) => string;
+
+/**
+ * 转义HTML到属性值
+ * @param {String} s
+ * @param preserveCR
+ * @returns {string}
+ */
+export declare const escapeAttr: (s: string, preserveCR?: string) => string;
+
+/**
+ * 转义HTML
+ * @param {string} str
+ * @param {Number} tabSize tab宽度，如果设置为0，表示去除tab
+ * @param {Boolean} allowLineBreaker 是否允许换行
+ * @returns {string}
+ */
+export declare const escapeHtml: (str: string, tabSize?: number, allowLineBreaker?: boolean) => string;
+
+/**
+ * 退出全屏
+ * @returns {Promise<void>}
+ */
+export declare const exitFullScreen: () => Promise<void>;
+
+/**
+ * 混合ES6模板字符串
+ * @example extract("hello ${user_name}", {user_name:"Jack"});
+ * @param {String} es_template 模板
+ * @param {Object} params 数据对象
+ * @return {String}
+ */
+export declare const extract: (es_template: string, params: Record<string, any>) => string;
+
+/**
+ * 将文件转换为 Base64 data URL
+ * 支持 File/Blob 对象，或字符串 URL（http(s)/相对/blob:）
+ * @param {File|Blob|String} file
+ * @returns {Promise<String|null>} 返回 data URL 字符串，失败返回 null
+ */
+export declare const fileToBase64DataUri: (file: File | Blob | string) => Promise<string | null>;
+
+/**
+ * 通过选择器查找子节点（强制添加 :scope来约束必须是子节点）
+ * @param {String} selector
+ * @param {Node} parent
+ * @return {Node[]}
+ */
+export declare const findAll: (selector: string | HTMLElement | HTMLElement[] | NodeList | HTMLCollection, parent?: Document | HTMLElement) => HTMLElement[];
+
+/**
+ * @param {String|Object} selector 选择器，如果是Object，则直接返回Object
+ * @param {Node} parent
+ * @return {Node}
+ */
+export declare const findOne: (selector: string | HTMLElement, parent?: Document | HTMLElement) => HTMLElement;
+
+export declare const fixBaseUrl: (url: string, baseUrl: string) => string;
+
+/**
+ * 格式化日期（以PHP方式格式化）
+ * @param {String} format
+ * @param {Object,Number,String} date 日期，可以是日期对象、毫秒数或者日期字符串，缺省为今天
+ * @return {String}
+ */
+export declare const formatDate: (format: string, date?: Date | number | string | null) => string;
+
+/**
+ * 获取元素的位置(相对于视口)
+ * @param {HTMLElement} el
+ * @returns
+ */
+export declare const getBoundingClientRect: (el: HTMLElement, autoFixInvisible?: boolean) => RectObject;
+
+/**
+ * 获取cookie
+ * @param {String} name
+ * @returns {string|null}
+ */
+export declare const getCookie: (name: string) => string | null;
+
+/**
+ * 获取对象宽、高
+ * 通过设置 visibility 方式进行获取
+ * @param {HTMLElement} dom
+ * @return {{width: number, height: number}}
+ */
+export declare const getDomDimension: (dom: HTMLElement) => {
+    width: number;
+    height: number;
+};
+
+/**
+ * get node xpath
+ * @param el
+ * @return {String}
+ */
+export declare const getNodeXPath: (el: HTMLElement | null) => string | null;
+
+/**
+ * 获取u8字符串长度(一个中文字按照3个字数计算)
+ * @param str
+ * @returns {number}
+ */
+export declare const getUTF8StrLen: (str: string) => number;
+
+/** 黄金分割比 0.618 **/
+export declare const GOLDEN_RATIO: number;
+
+export declare const guid: (prefix?: string) => string;
+
+/**
+ * 隐藏节点（通过设置display:none方式）
+ * @param {Node|String} dom
+ */
+export declare const hide: (dom: HTMLElement | string) => void;
+
+/**
+ * 高亮文本
+ * @param {String} text 文本
+ * @param {String} kw 关键字
+ * @param {String} replaceTpl 替换模板
+ * @returns {void|string|*}
+ */
+export declare const highlightText: (text: string, kw: string, replaceTpl?: string) => string;
+
+/**
+ * Convert html to plain text
+ * @param {String} html
+ * @returns {string}
+ */
+export declare const html2Text: (html: string) => string;
+
+/**
+ * 通过 Image 获取base64数据
+ * @param img
+ * @returns {string|string|*|string|null}
+ */
+export declare const imgToBase64: (img: HTMLImageElement) => string | null;
+
+/**
+ * 在头部插入样式
+ * @param {String} styleSheetStr 样式代码
+ * @param {String} id 样式ID，如果提供ID，将会检测是否已经插入，可以避免重复插入
+ * @param {Document} doc 文档上下文
+ * @return {HTMLStyleElement}
+ */
+export declare const insertStyleSheet: (styleSheetStr: string, id?: string, doc?: Document) => HTMLStyleElement | null;
+
+/**
+ * 判断对象是否为空
+ * @param obj - 要判断的对象
+ * @returns 是否为空对象
+ * @example
+ * isEmptyObject({}) // true
+ * isEmptyObject({ a: 1 }) // false
+ */
+export declare function isEmptyObject(obj: object): boolean;
+
+export declare const isFocusable: (el: HTMLElement) => boolean;
+
+export declare const isFunction: (value: any) => boolean;
+
+/**
+ * 检测是否正在全屏
+ * @returns {boolean}
+ */
+export declare const isInFullScreen: () => boolean;
+
+/**
+ * 判断字符串是否符合 JSON 标准
+ * @param {String} json
+ * @returns {boolean}
+ */
+export declare const isJSON: (json: string) => boolean;
+
+export declare const isJson: (json: string) => boolean;
+
+/**
+ * 检测目标是否为 Object
+ * @param {*} item
+ * @returns {boolean}
+ */
+export declare const isObject: (item: any) => boolean;
+
+/**
+ * 检测对象是否为Promise对象
+ * @param {*} obj
+ * @returns {boolean}
+ */
+export declare const isPromise: (obj: any) => boolean;
+
+/**
+ * 检测是否为 URL（不包含 blob: data: file: 等协议）
+ */
+export declare const isUrl: (str: string) => boolean;
+
+/**
+ * 短横线命名转换
+ * @param str - 输入字符串
+ * @returns 短横线命名的字符串
+ * @example
+ * kebabCase('helloWorld') // 'hello-world'
+ * kebabCase('HelloWorld') // 'hello-world'
+ */
+export declare function kebabCase(str: string): string;
+
+/**
+ * 保持对象尽量在容器内部，优先保证上边、左边显示
+ * @param {Object} objDim
+ * @param {Number} objDim.left
+ * @param {Number} objDim.top
+ * @param {Number} objDim.width
+ * @param {Number} objDim.height
+ * @param {Object} ctnDim
+ * @param {Number} ctnDim.left
+ * @param {Number} ctnDim.top
+ * @param {Number} ctnDim.width
+ * @param {Number} ctnDim.height
+ * {Array} dimension [dimension.left, dimension.top]
+ */
+export declare const keepRectInContainer: (objDim: Dimension, ctnDim?: Dimension) => {
+    left: number;
+    top: number;
+};
+
+/**
+ * 挂载css文件
+ * @param {String} file
+ * @param {Boolean} forceReload 是否强制重新挂载，缺省不重复挂载
+ */
+export declare const loadCss: (file: string, forceReload?: boolean) => Promise<void>;
+
+/**
+ * 加载script脚本
+ * @param {String} src 脚本地址
+ * @param {Boolean} forceReload 是否强制重新加载，缺省为去重加载
+ * @return {Promise}
+ */
+export declare const loadScript: (src: string, forceReload?: boolean) => Promise<void>;
+
+/**
+ * 绑定元素，禁止交互
+ * @param {Node} el
+ * @param {Function} payload 处理函数，参数为 reset
+ */
+export declare const lockElementInteraction: (el: HTMLElement | string, payload: (reset: () => void) => void) => void;
+
+export declare const md5: (string: string, key?: string, raw?: boolean) => string;
+
+/**
+ * 缺省二进制文件MIME
+ * @see https://datatracker.ietf.org/doc/html/rfc2046
+ * @type {String}
+ */
+export declare const MIME_BINARY_DEFAULT = "application/octet-stream";
+
+/**
+ * MIME常见扩展名映射表
+ * @type {Object}
+ */
+export declare const MIME_EXTENSION_MAP: {
+    "323": string;
+    accdb: string;
+    accde: string;
+    accdt: string;
+    acx: string;
+    ai: string;
+    aif: string;
+    aifc: string;
+    aiff: string;
+    application: string;
+    art: string;
+    asf: string;
+    asm: string;
+    asr: string;
+    asx: string;
+    atom: string;
+    au: string;
+    avi: string;
+    axs: string;
+    bas: string;
+    bcpio: string;
+    bmp: string;
+    c: string;
+    calx: string;
+    cat: string;
+    cdf: string;
+    class: string;
+    clp: string;
+    cmx: string;
+    cnf: string;
+    cod: string;
+    cpio: string;
+    cpp: string;
+    crd: string;
+    crl: string;
+    crt: string;
+    csh: string;
+    css: string;
+    dcr: string;
+    der: string;
+    dib: string;
+    dir: string;
+    disco: string;
+    dll: string;
+    "dll.config": string;
+    dlm: string;
+    doc: string;
+    docm: string;
+    docx: string;
+    dot: string;
+    dotm: string;
+    dotx: string;
+    dtd: string;
+    dvi: string;
+    dwf: string;
+    dxr: string;
+    eml: string;
+    eps: string;
+    etx: string;
+    evy: string;
+    "exe.config": string;
+    fdf: string;
+    fif: string;
+    flr: string;
+    flv: string;
+    gif: string;
+    gtar: string;
+    gz: string;
+    h: string;
+    hdf: string;
+    hdml: string;
+    hhc: string;
+    hlp: string;
+    hqx: string;
+    hta: string;
+    htc: string;
+    htm: string;
+    html: string;
+    htt: string;
+    hxt: string;
+    ico: string;
+    ief: string;
+    iii: string;
+    ins: string;
+    isp: string;
+    IVF: string;
+    jar: string;
+    jck: string;
+    jcz: string;
+    jfif: string;
+    jpe: string;
+    jpeg: string;
+    jpg: string;
+    js: string;
+    jsx: string;
+    latex: string;
+    lit: string;
+    lsf: string;
+    lsx: string;
+    m13: string;
+    m14: string;
+    m1v: string;
+    m3u: string;
+    man: string;
+    manifest: string;
+    map: string;
+    mdb: string;
+    me: string;
+    mht: string;
+    mhtml: string;
+    mid: string;
+    midi: string;
+    mmf: string;
+    mno: string;
+    mny: string;
+    mov: string;
+    movie: string;
+    mp2: string;
+    mp3: string;
+    mpa: string;
+    mpe: string;
+    mpeg: string;
+    mpg: string;
+    mpp: string;
+    mpv2: string;
+    ms: string;
+    mvb: string;
+    mvc: string;
+    nc: string;
+    nsc: string;
+    nws: string;
+    oda: string;
+    odc: string;
+    ods: string;
+    one: string;
+    onea: string;
+    onetoc: string;
+    onetoc2: string;
+    onetmp: string;
+    onepkg: string;
+    osdx: string;
+    p10: string;
+    p12: string;
+    p7b: string;
+    p7c: string;
+    p7m: string;
+    p7r: string;
+    p7s: string;
+    pbm: string;
+    pdf: string;
+    pfx: string;
+    pgm: string;
+    pko: string;
+    pma: string;
+    pmc: string;
+    pml: string;
+    pmr: string;
+    pmw: string;
+    png: string;
+    pnm: string;
+    pnz: string;
+    pot: string;
+    potm: string;
+    potx: string;
+    ppam: string;
+    ppm: string;
+    pps: string;
+    ppsm: string;
+    ppsx: string;
+    ppt: string;
+    pptm: string;
+    pptx: string;
+    prf: string;
+    ps: string;
+    pub: string;
+    qt: string;
+    qtl: string;
+    ra: string;
+    ram: string;
+    ras: string;
+    rf: string;
+    rgb: string;
+    rm: string;
+    rmi: string;
+    roff: string;
+    rpm: string;
+    rtf: string;
+    rtx: string;
+    scd: string;
+    sct: string;
+    setpay: string;
+    setreg: string;
+    sgml: string;
+    sh: string;
+    shar: string;
+    sit: string;
+    sldm: string;
+    sldx: string;
+    smd: string;
+    smx: string;
+    smz: string;
+    snd: string;
+    spc: string;
+    spl: string;
+    src: string;
+    ssm: string;
+    sst: string;
+    stl: string;
+    sv4cpio: string;
+    sv4crc: string;
+    svg: string;
+    swf: string;
+    t: string;
+    tar: string;
+    tcl: string;
+    tex: string;
+    texi: string;
+    texinfo: string;
+    tgz: string;
+    thmx: string;
+    tif: string;
+    tiff: string;
+    tr: string;
+    trm: string;
+    tsv: string;
+    txt: string;
+    uls: string;
+    ustar: string;
+    vbs: string;
+    vcf: string;
+    vcs: string;
+    vdx: string;
+    vml: string;
+    vsd: string;
+    vss: string;
+    vst: string;
+    vsto: string;
+    vsw: string;
+    vsx: string;
+    vtx: string;
+    wav: string;
+    wax: string;
+    wbmp: string;
+    wcm: string;
+    wdb: string;
+    wks: string;
+    wm: string;
+    wma: string;
+    wmd: string;
+    wmf: string;
+    wml: string;
+    wmlc: string;
+    wmls: string;
+    wmlsc: string;
+    wmp: string;
+    wmv: string;
+    wmx: string;
+    wmz: string;
+    wps: string;
+    wri: string;
+    wrl: string;
+    wrz: string;
+    wsdl: string;
+    wvx: string;
+    x: string;
+    xaf: string;
+    xaml: string;
+    xap: string;
+    xbap: string;
+    xbm: string;
+    xdr: string;
+    xht: string;
+    xhtml: string;
+    xla: string;
+    xlam: string;
+    xlc: string;
+    xlm: string;
+    xls: string;
+    xlsb: string;
+    xlsm: string;
+    xlsx: string;
+    xlt: string;
+    xltm: string;
+    xltx: string;
+    xlw: string;
+    xml: string;
+    xof: string;
+    xpm: string;
+    xps: string;
+    xsd: string;
+    xsf: string;
+    xsl: string;
+    xslt: string;
+    xwd: string;
+    z: string;
+    zip: string;
+};
+
+/**
+ * 毫米转换成像素
+ * @param {float} dimension
+ * @param {int} dpi
+ * @returns int
+ */
+export declare const mmToPx: (dimension: number, dpi?: number) => number;
+
+export declare const MONTH_NAMES_CN: string[];
+
+export declare const MONTH_NAMES_SHORT_CN: string[];
+
+export declare const MONTH_NOW: number;
+
+export declare const msToHMS: (ms: number) => string;
+
+/**
+ * 更低占用执行mutation监听，支持指定最小间隔时间执行回调
+ * @param {Node} dom
+ * @param {Object} option
+ * @param {Boolean} option.attributes
+ * @param {Boolean} option.subtree
+ * @param {Boolean} option.childList
+ * @param {Function} payload
+ * @param {Number} minInterval 执行回调最小间隔时间（毫秒）
+ */
+export declare const mutationEffective: (dom: HTMLElement, option: MutationObserverInit, payload: (obs: MutationObserver) => void, minInterval?: number) => void;
+
+/**
+ * 获取当前节点在父结点中的索引号
+ * @param node
+ * @return {number}
+ */
+export declare const nodeIndex: (node: HTMLElement) => number;
+
+/**
+ * 获取对象指定路径的值
+ * @param obj - 对象
+ * @param path - 路径，例如 'a.b.c'
+ * @param defaultValue - 默认值
+ * @returns 获取到的值或默认值
+ * @example
+ * get({ a: { b: { c: 1 } } }, 'a.b.c') // 1
+ * get({ a: { b: 1 } }, 'a.b.c', 0) // 0
+ */
+export declare function objectGet<T = any>(obj: any, path: string, defaultValue?: T): T;
+
+/**
+ * 对象属性名转换
+ * @param {Object} obj
+ * @param {Object} mapping
+ * @return {{}}
+ */
+export declare const objectKeyMapping: (obj: Record<string, any>, mapping: Record<string, string>) => Record<string, any>;
+
+/**
+ * 合并对象
+ * @param target - 目标对象
+ * @param sources - 源对象
+ * @returns 合并后的对象
+ * @example
+ * merge({ a: 1 }, { b: 2 }, { c: 3 }) // { a: 1, b: 2, c: 3 }
+ */
+export declare function objectMerge<T extends object>(target: T, ...sources: Partial<T>[]): T;
+
+/**
+ * 设置对象指定路径的值
+ * @param obj - 对象
+ * @param path - 路径，例如 'a.b.c'
+ * @param value - 要设置的值
+ * @example
+ * set({}, 'a.b.c', 1) // { a: { b: { c: 1 } } }
+ */
+export declare function objectSet(obj: any, path: string, value: any): void;
+
+/**
+ * 监听节点树变更
+ * @param {Node} dom
+ * @param {Function} callback
+ * @param {Boolean} includeElementChanged 是否包含表单元素的值变更
+ */
+export declare const onDomTreeChange: (dom: HTMLElement, callback: () => void, includeElementChanged?: boolean) => void;
+
+export declare const ONE_DAY: number;
+
+export declare const ONE_HOUR: number;
+
+export declare const ONE_MINUTE: number;
+
+export declare const ONE_MONTH30: number;
+
+export declare const ONE_MONTH31: number;
+
+export declare const ONE_WEEK: number;
+
+export declare const ONE_YEAR365: number;
+
+export declare const ONE_YEAR366: number;
+
+/**
+ * 非自关闭标签
+ * https://www.w3schools.com/html/html_blocks.asp
+ * @type {*[]}
+ */
+export declare const PAIR_TAGS: string[];
+
+/**
+ * 精度位数转小数表示法
+ * @param {Number} precision 精度位数
+ * @returns {Float} 精度小数表示法，如 0.01
+ */
+export declare const precisionToStep: (precision: number) => number;
+
+/**
+ * 打印调用堆栈
+ */
+export declare const printStack: () => void;
+
+/**
+ * 随机整数
+ * @param {Number} min
+ * @param {Number} max
+ * @return {Number}
+ */
+export declare const randomInt: (min: number, max: number) => number;
+
+/**
+ * 产生随机字符串
+ * @param {Number} length
+ * @param {String} sourceStr
+ * @returns {String}
+ */
+export declare const randomString: (length?: number, sourceStr?: string) => string;
+
+/**
+ * 产生随机单词
+ * @param {Number} count 单词数量
+ * @param {Number} letterMax 每个单词最大字符数量
+ * @return {String[]} 单词列表
+ */
+export declare const randomWords: (count?: number, letterMax?: number) => string[];
+
+/**
+ * 矩形相交（包括边重叠情况）
+ * @param {Object} rect1
+ * @param {Object} rect2
+ * @returns {boolean}
+ */
+export declare const rectAssoc: (rect1: Dimension, rect2: Dimension) => boolean;
+
+/**
+ * 检测矩形是否在指定布局内部
+ * @param rect
+ * @param layout
+ * @returns {*}
+ */
+export declare const rectInLayout: (rect: Dimension, layout: Dimension) => boolean;
+
+declare interface RectObject {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+
+/**
+ * 正则表达式转义
+ * @param str
+ * @returns {string}
+ */
+export declare const regQuote: (str: string) => string;
+
+/**
+ * 非内容可清理标签
+ * @type {string[]}
+ */
+export declare const REMOVABLE_TAGS: string[];
+
+export declare const remove: (dom: HTMLElement | string) => Node | null;
+
+/**
+ * 取整
+ * @param {Number} num
+ * @param {Number} precision 精度，默认为两位小数
+ * @returns {number}
+ */
+export declare const round: (num: number, precision?: number) => number;
+
+/**
+ * 过滤字符串为合法文件名
+ * 替换 Windows/Unix 不允许的字符为下划线
+ * 包括：\ / : * ? " < > | 以及控制字符
+ * @param {string} name
+ * @returns {string}
+ */
+export declare const sanitizeFileName: (name: string) => string;
+
+/**
+ * 自关闭标签
+ * @type {string[]}
+ */
+export declare const SELF_CLOSING_TAGS: string[];
+
+/**
+ * 设置cookie
+ * @param {String} name
+ * @param {String} value
+ * @param {Number} days
+ * @param {String} path
+ */
+export declare const setCookie: (name: string, value: string, days: number, path?: string) => void;
+
+/**
+ * 显示节点（通过设置display为空方式）
+ * @param {HTMLElement} dom
+ * @param dom
+ */
+export declare const show: (dom: HTMLElement | string) => void;
+
+/**
+ * 通过ImageSrc获取base64（网络请求模式）
+ * @param src
+ * @returns {Promise<unknown>}
+ */
+export declare const srcToBase64: (src: string, cache?: boolean) => Promise<unknown>;
+
+export declare const STAND_DPI = 96;
+
+export declare const stringToEntity: (str: string, radix?: number) => string;
+
+/**
+ * 反转义字符串
+ * @param str
+ * @returns {string}
+ * @description:
+ *       discuss at: https://locutus.io/php/stripslashes/
+ *      original by: Kevin van Zonneveld (https://kvz.io)
+ *      improved by: Ates Goral (https://magnetiq.com)
+ *      improved by: marrtins
+ *      improved by: rezna
+ *         fixed by: Mick@el
+ *      bugfixed by: Onno Marsman (https://twitter.com/onnomarsman)
+ *      bugfixed by: Brett Zamir (https://brett-zamir.me)
+ *         input by: Rick Waldron
+ *         input by: Brant Messenger (https://www.brantmessenger.com/)
+ * reimplemented by: Brett Zamir (https://brett-zamir.me)
+ *        example 1: stripslashes('Kevin\'s code')
+ *        returns 1: "Kevin's code"
+ *        example 2: stripslashes('Kevin\\\'s code')
+ *        returns 2: "Kevin\'s code"
+ */
+export declare const stripSlashes: (str: string) => string;
+
+/**
+ * 字符串转成首字母大写
+ * @param {String} str
+ * @param {Boolean} capitalize_first 是否将第一个单词首字母大写
+ * @return {string}
+ */
+export declare const strToPascalCase: (str: string, capitalize_first?: boolean) => string;
+
+/**
+ * 节流
+ * 规定在一个单位时间内，只能触发一次函数。如果这个函数单位时间内触发多次函数，只有一次生效。
+ * @param {Function} fn
+ * @param {Number} intervalMiSec
+ * @return {(function(): void)|*}
+ */
+export declare const throttle: (fn: Function, intervalMiSec: number) => Function;
+
+/**
+ * 更有效果的节流函数
+ * 区别：如果函数执行间隔还没到期，放入下一个时间周期执行，如果已经有下一周期未执行，当前触发作废。
+ * 这种效果在 **Change 类型函数场景中更有效果，可以确保最后一次变更能够有效执行
+ * @param {Function} fn
+ * @param {Number} intervalMiSec
+ */
+export declare const throttleEffect: (fn: Function, intervalMiSec: number) => Function;
+
+/**
+ * 禁用启用元素切换
+ * @param {String|Node} el
+ * @param {String} disabledClass
+ * @param {Boolean|Null} forceEnabled 强制启用、禁用，为空表示自动切换
+ */
+export declare const toggleDisabled: (el: HTMLElement | string, disabledClass?: string, forceEnabled?: boolean | null) => void;
+
+/**
+ * 切换全屏
+ * @param element
+ * @returns {Promise<unknown>}
+ */
+export declare const toggleFullScreen: (element: any) => Promise<unknown>;
+
+/**
+ * 去除字符串首尾指定字符或空白
+ * @param {String} str 源字符串
+ * @param {String} chars 指定字符，默认为空白
+ * @param {Number} dir 方向
+ * @returns {*|boolean}
+ */
+export declare const trim: (str: string, chars?: string, dir?: number) => string;
+
+export declare const TRIM_BOTH = 0;
+
+export declare const TRIM_LEFT = 1;
+
+export declare const TRIM_RIGHT = 2;
+
+/**
+ * 截断字符串
+ * @param str - 输入字符串
+ * @param length - 最大长度
+ * @param suffix - 后缀，默认为 '...'
+ * @returns 截断后的字符串
+ * @example
+ * truncate('hello world', 5) // 'hello...'
+ */
+export declare function truncate(str: string, length: number, suffix?: string): string;
+
+/**
+ * 反转义HTML
+ * @param {String} html
+ * @returns {string}
+ */
+export declare const unescapeHtml: (html: string) => string;
+
+/**
+ * url 转 Base64Data 数据缓存
+ * @param {String} url
+ * @param {String|Null} b64Data base64 数据，传入 null 则为读取缓存，这里不是不是base64，而是 base64 data URL
+ * @returns {String|Null} 读取缓存时返回 base64 data URL 字符串，未命中返回 null
+ */
+export declare const urlB64DataCache: (url: string, b64Data?: string | null) => string | null;
+
+/**
+ * @param {String} srcStr
+ * @return {string}
+ */
+export declare const utf8Decode: (srcStr: string) => string;
+
+/**
+ * @param {String} srcStr
+ * @returns {string}
+ */
+export declare const utf8Encode: (srcStr: string) => string;
+
+export declare const WEEK_DAY_NAMES_CN: string[];
+
+export declare const WEEK_DAY_NAMES_SHORT_CN: string[];
+
+export declare const YEAR_NOW: number;
+
+export { }