@base-web-kits/base-tools-ts 0.9.8 → 0.9.9

package/dist/index.d.cts

@@ -1,1216 +0,0 @@
-import { EventType } from 'mitt';
-import dayjs from 'dayjs';
-export { default as dayjs } from 'dayjs';
-export * from 'lodash-es';
-import BigNumber from 'bignumber.js';
-export { default as BigNumber } from 'bignumber.js';
-
-/**
- * 拖拽排序 (不改变原数组)
- * @param list 原始数组
- * @param fromIndex 要移动的元素的原始索引
- * @param toIndex 要移动到的目标索引
- * @returns 移动元素后的新数组
- */
-declare function arrayMove<T>(list: T[], fromIndex: number, toIndex: number): T[];
-
-/**
- * 将 Promise 包装为 [data, error] 形式, 减少 try-catch 代码量
- * @param p 要包装的 Promise
- * @returns 一个 Promise，其结果为 [data, error] 形式
- * @example
- * const [data, err] = await toAsync(fetch('https://api.example.com/data'));
- * if (err) {
- *   console.error(err);
- *   return;
- * }
- * console.log(data);
- */
-declare function toAsync<T>(p: Promise<T>): Promise<[T | null, unknown]>;
-
-type Events = Record<EventType, unknown>;
-/**
- * 总线式发布订阅
- * @example
- * const emitter = new EventBus(); // 支持链式调用
- * emitter.on('xx', fn); // 订阅事件 xx
- * emitter.once('xx', fn); // 订阅事件 xx 一次
- * emitter.emit('xx', any); // 发布事件 xx，参数任意
- * emitter.off('xx'); // 移除事件 xx 下全部监听
- * emitter.off('xx', fn); // 移除事件 xx 下指定监听
- * emitter.clear(); // 移除所有事件
- *
- * @example 类型约束
- * type T = { a: number; b: string };
- * const emitter = new EventBus<{ xx: T; yy: void }>();
- * const fn = (arg: T) => {}
- * emitter.on('xx', fn);
- * emitter.off('xx', fn);
- * emitter.emit('xx', { a: 123, b: '123' });
- * emitter.emit('yy');
- */
-declare class EventBus<T extends Events = Events> {
-    private readonly _emitter;
-    /** 订阅 */
-    on<K extends keyof T>(type: K, fn: (event: T[K]) => void): this;
-    /** 订阅一次 */
-    once<K extends keyof T>(type: K, fn: (event: T[K]) => void): this;
-    /** 发布 */
-    emit<K extends keyof T>(type: K, event?: T[K]): this;
-    /** 移除 */
-    off<K extends keyof T>(type: K, fn?: (event: T[K]) => void): this;
-    /** 清空 */
-    clear(): this;
-}
-
-type BaseTime = number | string | Date | dayjs.Dayjs | null | undefined;
-/**
- * 创建 dayjs 实例
- * 文档: https://day.js.org/zh-CN/
- * @param t 各种规范或不规范的时间
- * @returns dayjs 实例
- * @example
- * const d = toDayjs('2021-01-01'); // dayjs 实例
- * d.format('YYYY-MM-DD HH:mm:ss'); // "2025-12-10 11:33:16"
- * d.valueOf(); // 毫秒时间戳，如 1765337596913
- * d.unix(); // 秒时间戳，如 1765337596
- * d.millisecond(); // 毫秒 913
- * d.second(); // 秒 16
- * d.minute(); // 分 33
- * d.hour(); // 时 11
- * d.date(); // 日 10
- * d.day(); // 星期几 5（周日=0）
- * d.month() + 1; // 月 12
- * d.year(); // 年 2025
- * d.startOf('day').valueOf(); // 当日零点
- * d.startOf('month').format('YYYY-MM-DD HH:mm:ss'); // 月初 "2025-12-01 00:00:00"
- * d.endOf('month').format('YYYY-MM-DD HH:mm:ss'); // 月末 "2025-12-31 23:59:59"
- * d.fromNow(); // “刚刚”、“x分钟前/后”、“x小时前/后”、“x天前/后”、“x月前/后”、“x年前/后”
- * d.isSame(t, 'day'); // 是否与t在同一天
- * d.diff(); // 与当前时间相差的毫秒数
- * d.diff(t); // 与t相差的毫秒数
- * d.diff(t, 'second'); // 与t相差的秒数
- * d.diff(t, 'minute'); // 与t相差的分钟数
- * d.diff(t, 'hour'); // 与t相差的小时数
- * d.diff(t, 'day'); // 与t相差的天数
- * d.diff(t, 'week'); // 与t相差的周数
- * d.diff(t, 'month'); // 与t相差的月数
- * d.diff(t, 'quarter'); // 与t相差的季度数
- * d.diff(t, 'year'); // 与t相差的年数
- */
-declare function toDayjs(t: BaseTime, fmt?: dayjs.OptionType): dayjs.Dayjs;
-/**
- * 获取“前几天”的日期范围
- * @param offset 正整数天数
- * @param fmt 日期格式，默认 `YYYY-MM-DD`
- * @returns `[start, end]` 日期字符串数组
- * @example
- * 若今天为 2025-11-19：
- * getDateRangeBefore(1) // ['2025-11-18', '2025-11-19']
- * getDateRangeBefore(1, 'YYYY-MM-DD HH:mm:ss') // ['2025-11-18 00:00:00', '2025-11-19 23:59:59']
- */
-declare function getDateRangeBefore(offset: number, fmt?: string): string[];
-/**
- * 获取“后几天”的日期范围
- * - 起点：今天；终点：`offset` 天后
- * - 若 `fmt` 含时间令牌（如 `HH:mm:ss`），则返回整日范围：起点为当日零点，终点为当日末尾
- * @param offset 正整数天数
- * @param fmt 日期格式，默认 `YYYY-MM-DD`
- * @returns `[start, end]` 日期字符串数组
- * @example
- * 若今天为 2025-11-19：
- * getDateRangeAfter(1) // ['2025-11-19', '2025-11-20']
- * getDateRangeAfter(1, 'YYYY-MM-DD HH:mm:ss') // ['2025-11-19 00:00:00', '2025-11-20 23:59:59']
- */
-declare function getDateRangeAfter(offset: number, fmt?: string): string[];
-/**
- * 获取倒计时的时间分解（零填充字符串）
- * @param diff 毫秒差值（正数表示剩余时间，负数/0表示已到期）
- * @returns 包含天、时、分、秒、毫秒的零填充对象
- * @example
- * const diff = toDayjs(t).diff(); // 毫秒差值
- * const parts = getCountdownParts(diff); // { d: '01', h: '02', m: '03', s: '04', ms: '567' }
- */
-declare function getCountdownParts(diff: number): {
-    d: string;
-    h: string;
-    m: string;
-    s: string;
-    ms: string;
-};
-/**
- * 通过出生日期计算年龄
- * @param birthdate 生日日期，支持多种格式（会被自动解析）
- * @returns 年龄对象，包含 `age`（年龄数值）和 `type`（年龄单位，'year' 表示年，'month' 表示月）
- * @example
- * // 假设当前日期为 2025-11-19
- * getAgeByBirthdate('2025-05-10'); // { age: 6, type: 'month' }
- * getAgeByBirthdate('2020-11-19'); // { age: 5, type: 'year' }
- * getAgeByBirthdate('2020-12-01'); // { age: 4, type: 'year' }（生日还没到, 所以年龄是4岁）
- */
-declare function getAgeByBirthdate(birthdate: string): {
-    age: number;
-    type: string;
-};
-
-/**
- * 数值入参类型。
- * 支持原生 `number`、`string`（包含小数、科学计数法等）以及 `BigNumber`。
- */
-type NumLike = string | number | BigNumber;
-/**
- * 将任意 `NumLike` 统一转换为 `BigNumber` 实例。
- * @param x 任意支持的数值入参。
- * @returns `BigNumber` 实例。
- * @example
- * big('0.1'); // => BigNumber
- * big(0.2);   // => BigNumber
- */
-declare function big(x: NumLike): BigNumber;
-/**
- * 高精度加法（支持多个参数连加）。
- * @example
- * bigAdd(0.1, 0.2); // => 0.3
- * bigAdd('0.1', '0.2'); // => 0.3
- * bigAdd(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
- */
-declare function bigAdd(a: NumLike, ...rest: NumLike[]): number;
-/**
- * 高精度减法（支持多个参数连减）。
- * @example
- * bigSub(1, 0.9); // => 0.1
- * bigSub('1.1', '0.2'); // => 0.9
- * bigSub(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
- */
-declare function bigSub(a: NumLike, ...rest: NumLike[]): number;
-/**
- * 高精度乘法（支持多个参数连乘）。
- * @example
- * bigMul(0.1, 0.2); // => 0.02
- * bigMul('1.5', '3'); // => 4.5
- * bigMul(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
- */
-declare function bigMul(a: NumLike, ...rest: NumLike[]): number;
-/**
- * 高精度除法（支持多个参数连除）。
- * @example
- * bigDiv(1, 3); // => 0.333333...
- * bigDiv('10', '4'); // => 2.5
- * bigDiv(100, 5, 2); // => 10  // 多参数连除: 100/5/2
- */
-declare function bigDiv(a: NumLike, ...rest: NumLike[]): number;
-/**
- * 指数运算
- * @param x 底数。
- * @param y 指数。
- * @returns 计算结果。
- * @example
- * bigPow(2, 3); // => 8
- * bigPow('2.5', 2); // => 6.25
- */
-declare function bigPow(x: NumLike, y: NumLike): number;
-/**
- * 四舍五入到指定位数
- * @param x 需要舍入的数值。
- * @param dp 保留的小数位数，默认 `0`（取整）。
- * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
- * @returns 舍入后的数值。
- * @example
- * bigRound(1.6); // => 2
- * bigRound('1.234', 2); // => 1.23
- * bigRound('1.235', 2); // => 1.24
- * bigRound('1.299', 2, BigNumber.ROUND_DOWN); // => 1.29
- */
-declare function bigRound(x: NumLike, dp?: number, rm?: BigNumber.RoundingMode): number;
-/**
- * 将数值按指定位数格式化为字符串（保留小数位）。
- * @param x 需要格式化的数值。
- * @param dp 保留的小数位数，默认 `2`。
- * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
- * @returns 格式化后的字符串。
- * @example
- * toFixed('1'); // => '1.00'
- * +toFixed('1'); // => 1
- * toFixed(1.2345); // => '1.23'
- * toFixed(1.2345, 3); // => '1.235'
- * toFixed('1.2345', 0, BigNumber.ROUND_UP); // => '2'
- */
-declare function toFixed(x: NumLike, dp?: number, rm?: BigNumber.RoundingMode): string;
-/**
- * 比较两个数值大小。
- * @example
- * bigCompare('2', '10'); // => -1
- * bigCompare(3, 3);      // => 0
- * bigCompare('10', 2);   // => 1
- */
-declare function bigCompare(a: NumLike, b: NumLike): -1 | 0 | 1 | null;
-/**
- * 判断两个数值是否相等。
- * @example
- * bigEqual('1.0', 1); // => true
- * bigEqual(2, 1); // => false
- */
-declare function bigEqual(a: NumLike, b: NumLike): boolean;
-/**
- * 判断 a 是否大于 b。
- * @example
- * bigGt(2, 1); // => true
- * bigGt(1, 2); // => false
- */
-declare function bigGt(a: NumLike, b: NumLike): boolean;
-/**
- * 判断 a 是否大于等于 b。
- * @example
- * bigGte(2, 2); // => true
- * bigGte(1, 2); // => false
- */
-declare function bigGte(a: NumLike, b: NumLike): boolean;
-/**
- * 判断 a 是否小于 b。
- * @example
- * bigLt(1, 2); // => true
- * bigLt(2, 1); // => false
- */
-declare function bigLt(a: NumLike, b: NumLike): boolean;
-/**
- * 判断 a 是否小于等于 b。
- * @example
- * bigLte(2, 2); // => true
- * bigLte(1, 2); // => true
- * bigLte(2, 1); // => false
- */
-declare function bigLte(a: NumLike, b: NumLike): boolean;
-
-/**
- * 开头补零
- * @param n 数字
- * @param len 总长度，默认 2
- * @returns 零填充后的字符串
- * @example
- * zeroPad(1) // '01'
- * zeroPad(12) // '12'
- * zeroPad(12, 4) // '0012'
- */
-declare function zeroPad(n: number | string, len?: number): string;
-/**
- * 给数字添加指定单位 (支持数字字符串,其他非法字符返回原值)
- * @param unit 单位
- * @param num 数字
- * @example
- * withUnit(0, 'px') // "0px"
- * withUnit(1, 'px') // "1px"
- * withUnit('1', 'rpx') // "1rpx"
- * withUnit('1', '%') // "1%"
- * withUnit('auto', 'px') // "auto"
- * withUnit(null | undefined | '') // ""
- */
-declare function withUnit(num?: number | string, unit?: string): string;
-/**
- * 给数字添加px单位 (支持数字字符串,其他非法字符返回原值)
- * @example
- * withUnitPx(10) // "10px"
- * withUnitPx('10') // "10px"
- * withUnitPx('10px') // "10px"
- * withUnitPx("auto") // "auto"
- * withUnitPx("30%") // "30%"
- * withUnitPx(null | undefined | '') // ""
- * withUnitPx(0) // "0px"
- */
-declare function withUnitPx(num?: string | number): string;
-/**
- * 给数字添加距离单位：当数值大于等于 1000m 时转换为 km，否则显示 m（最多两位小数、无无意义补零）
- * @example
- * withDistance(5); // => '5m'
- * withDistance(999.456); // => '999.46m'
- * withDistance(1000); // => '1km'
- * withDistance('1500'); // => '1.5km'
- * withDistance('1728'); // => '1.73km'
- */
-declare function withDistance(m: number | string): string;
-/**
- * 数字转千分位字符串（保留小数与符号）。
- * @example
- * toThousandth(1234567); // => '1,234,567'
- * toThousandth('1234567.89'); // => '1,234,567.89'
- * toThousandth('-987654'); // => '-987,654'
- */
-declare function toThousandth(str: number | string): string;
-/**
- * 阿拉伯数字转中文整数（忽略小数；支持负数）。
- * @param num 输入的数字或数字字符串（小数部分将被丢弃）
- * @returns 中文数字字符串；非法输入返回空字符串
- * @example
- * toChineseNum(123456);   // "十二万三千四百五十六"
- * toChineseNum(-10008);   // "负一万零八"
- * `第${toChineseNum(123)}条` // "第一百二十三条"
- */
-declare function toChineseNum(num: number | string): string;
-/**
- * 金额转中文大写（支持角/分/厘，精度控制）。
- * @param amount 金额（支持 number | string），非法或非有限数返回空串
- * @param opts 配置项
- * @param opts.precision 保留小数位（0~3），对应：0无小数、1角、2角分、3角分厘；默认 2
- * @param opts.rm 舍入模式，默认 `BigNumber.ROUND_HALF_UP`（四舍五入）
- * @param opts.yuanChar 元单位字符（`'元' | '圆'`），默认 `'元'`
- * @returns 中文大写金额字符串；示例：`壹佰贰拾叁元肆角伍分`
- * @example
- * toChineseCurrency(0) // '零元整'
- * toChineseCurrency(10) // '拾元整'
- * toChineseCurrency(101) // '壹佰零壹元整'
- * toChineseCurrency(1001000) // '壹佰万零壹仟元整'
- * toChineseCurrency(1001.01) // '壹仟零壹元壹分'
- * toChineseCurrency('1234.5679', { precision: 3 }) // '壹仟贰佰叁拾肆元伍角陆分捌厘'
- * toChineseCurrency(-1.2) // '负壹元贰角'
- */
-declare function toChineseCurrency(amount: number | string, opts?: {
-    precision?: 0 | 1 | 2 | 3;
-    rm?: BigNumber.RoundingMode;
-    yuanChar?: '元' | '圆';
-}): string;
-
-/**
- * 随机生成 `a` 到 `b` 的整数（闭区间，包含两端）。
- * - 自动交换边界，按从小到大处理。
- * - 下界向上取整、上界向下取整后再取值。
- * @param a 边界值。
- * @param b 边界值。
- * @returns 闭区间内的随机整数。
- * @example
- * randomInt(0, 10); // => 0..10 之间的随机整数（含 0 与 10）
- * randomInt(10, 0); // => 0..10 之间的随机整数（含 0 与 10）
- * randomInt(5.2, 10.8); // => 6..10 之间取整随机数（含 6 与 10）
- */
-declare function randomInt(a: number, b: number): number;
-/**
- * 随机生成 `a` 到 `b` 的浮点数（半开区间，包含下界不包含上界）。
- * - 自动交换边界，按从小到大处理。
- * @param a 边界值。
- * @param b 边界值。
- * @returns 半开区间内的随机浮点数。
- * @example
- * randomFloat(0, 10); // => [0, 10) 内的随机浮点数
- * randomFloat(10, 0); // => [0, 10) 内的随机浮点数
- * randomFloat(5.2, 10.8); // => [5.2, 10.8) 内的随机浮点数
- */
-declare function randomFloat(a: number, b: number): number;
-/**
- * 随机生成一个布尔值。
- * @returns 随机布尔值。
- * @example
- * randomBoolean(); // => 随机返回 true 或 false
- */
-declare function randomBoolean(): boolean;
-
-/**
- * 获取对象键名数组（类型安全）。
- * 注：内置 `Object.keys` 与 `lodash-es` 的 `keys` 在 TS 中通常返回 `string[]`，无法精确到 `keyof T`。
- * @param obj 目标对象
- * @returns 类型精确的 `Array<keyof T>`
- * @example
- * const o = { a: 1, b: 'x' };
- * const keys = getObjectKeys(o); // type: ('a' | 'b')[], value: ['a','b']
- */
-declare function getObjectKeys<T extends object>(obj: T): Array<keyof T>;
-
-/**
- * 文本脱敏
- * @param s 原始文本
- * @param keepLeft 保留左侧字符数（默认 1）
- * @param keepRight 保留右侧字符数（默认 0）
- * @param maskChar 脱敏字符（默认 `*`）
- * @returns 脱敏文本
- * @example
- * toMaskText('王小明', 1, 0) // => '王*'
- * toMaskText('王小明', 1, 1) // => '王*明'
- * toMaskText('13800138000', 3, 4) // => '138****8000'
- */
-declare function toMaskText(s: string, keepLeft?: number, keepRight?: number, maskChar?: string): string;
-/**
- * 手机号中间打星：保留前三位与后四位，中间打 `*`。
- * @param phone 手机号字符串
- * @returns 遮蔽后的手机号
- * @example
- * toMaskPhone('13800138000') // => '138****8000'
- */
-declare function toMaskPhone(phone: string): string;
-/**
- * 姓名打星：
- * - 长度 ≤ 2：保留首字，其余打 `*`
- * - 长度 ≥ 3：保留首尾，各打星中间
- * @param name 姓名字符串
- * @returns 遮蔽后的姓名
- * @example
- * toMaskName('张三') // => '张*'
- * toMaskName('王小明') // => '王*明'
- */
-declare function toMaskName(name: string): string;
-
-/**
- * 生成UUID
- * @returns UUID字符串
- * @example
- * const uuid = createUUID() // '7982fcfe-5721-4632-bede-6000885be57d'
- */
-declare function createUUID(): string;
-/**
- * 生成随机字符串id
- * - 常用于生成元素标签的id (默认加上'id_'前缀, 避免小程序中数字开头的id导致查询节点信息失败)
- * @param prefix 前缀, 默认 'id_'
- * @returns 随机字符串
- * @example
- * const id = createRandId(); // 'id_0rjuuuqv60xi'
- * const id = createRandId('canvas_'); // 'canvas_v82a7ctm09q'
- */
-declare function createRandId(prefix?: string): string;
-/**
- * 时间+固定位数的随机数字字符串
- * @param digits 随机部分的位数，默认 6
- * @returns 时间+随机数字字符串
- * @example
- * const traceId = createTimeRandId(); // '1763002648039123456'
- * const traceId = createTimeRandId(8); // '176300264803912345678'
- */
-declare function createTimeRandId(digits?: number): string;
-
-/**
- * 计算字符串在 UTF-8 编码下的字节长度。
- * 使用场景：
- * 1) 按字节限制表单输入（避免超过后端/数据库字段上限）
- * 2) 评估网络传输、缓存（Redis/消息队列）开销
- * 3) 根据字节数截断或提示用户（而非按字符数）
- * @param str 输入的字符串
- * @returns 字符串的字节长度
- * @example
- * getStringByteLength('abc') // 3
- * getStringByteLength('中文') // 6
- * getStringByteLength('😊') // 4
- */
-declare function getStringByteLength(str: string): number;
-
-/**
- * 将指定属性设为必填（不改变其他属性）。
- * - 所有属性必填请使用内置的Required<T>
- * @example
- * type User = { id?: number; name?: string; age?: number };
- * type U1 = SetRequired<User, 'id' | 'name'>; // { id: number; name: string; age?: number }
- */
-type SetRequired<T, K extends keyof T> = {
-    [P in K]-?: T[P];
-} & Omit<T, K>;
-/**
- * 将指定属性设为可选（不改变其他属性）。
- * - 所有属性可选请使用内置的Partial<T>
- * @example
- * type User = { id: number; name: string; age: number };
- * type U2 = SetOptional<User, 'age'>; // { id: number; name: string; age?: number }
- */
-type SetOptional<T, K extends keyof T> = {
-    [P in K]+?: T[P];
-} & Omit<T, K>;
-/**
- * 深度可选（递归将所有属性设为可选）。
- * @example
- * type T = { a: { b: number }; list: Array<{ id: string }> };
- * type R = DeepPartial<T>;
- */
-type DeepPartial<T> = T extends (infer U)[] ? DeepPartial<U>[] : T extends (...args: unknown[]) => unknown ? T : T extends object ? {
-    [K in keyof T]?: DeepPartial<T[K]>;
-} : T;
-/**
- * 深度必填（递归移除所有可选标记）。
- * @example
- * type T = { a?: { b?: number } };
- * type R = DeepRequired<T>; // { a: { b: number } }
- */
-type DeepRequired<T> = T extends (infer U)[] ? DeepRequired<U>[] : T extends (...args: unknown[]) => unknown ? T : T extends object ? {
-    [K in keyof T]-?: DeepRequired<T[K]>;
-} : T;
-/**
- * 取消只读（顶层移除 `readonly`）。
- * @example
- * type R = Mutable<Readonly<{ a: number }>>; // { a: number }
- */
-type Mutable<T> = {
-    -readonly [K in keyof T]: T[K];
-};
-/**
- * 深度只读（递归添加 `readonly`）。
- * @example
- * type R = ReadonlyDeep<{ a: { b: number }; list: { id: string }[] }>;
- */
-type ReadonlyDeep<T> = T extends (infer U)[] ? ReadonlyArray<ReadonlyDeep<U>> : T extends (...args: unknown[]) => unknown ? T : T extends object ? {
-    readonly [K in keyof T]: ReadonlyDeep<T[K]>;
-} : T;
-/**
- * 对象值联合类型。
- * @example
- * type V = ValueOf<{ a: 1; b: 'x' }>; // 1 | 'x'
- */
-type ValueOf<T> = T[keyof T];
-/**
- * 根据值类型获取键名联合。
- * @example
- * type Keys = KeysOfType<{ a: string; b: number; c: string }, string>; // 'a' | 'c'
- */
-type KeysOfType<T, V> = {
-    [K in keyof T]-?: T[K] extends V ? K : never;
-}[keyof T];
-/**
- * 按值类型挑选属性。
- * @example
- * type R = PickByType<{ a: string; b: number; c: string }, string>; // { a: string; c: string }
- */
-type PickByType<T, V> = Pick<T, KeysOfType<T, V>>;
-/**
- * 可选键名联合。
- * @example
- * type K = OptionalKeys<{ a?: number; b: string }>; // 'a'
- */
-type OptionalKeys<T> = {
-    [K in keyof T]-?: Pick<T, K> extends Required<Pick<T, K>> ? never : K;
-}[keyof T];
-/**
- * 必填键名联合。
- * @example
- * type K = RequiredKeys<{ a?: number; b: string }>; // 'b'
- */
-type RequiredKeys<T> = {
-    [K in keyof T]-?: Pick<T, K> extends Required<Pick<T, K>> ? K : never;
-}[keyof T];
-/**
- * 联合类型转交叉类型。
- * @example
- * type I = UnionToIntersection<{ a: 1 } | { b: 2 }>; // { a: 1 } & { b: 2 }
- */
-type UnionToIntersection<U> = (U extends unknown ? (x: U) => unknown : never) extends (x: infer I) => unknown ? I : never;
-/**
- * 合并属性（以 `U` 覆盖 `T` 的同名属性）。
- * @example
- * type R = Merge<{ a: 1; b: 2 }, { b: 3; c: 4 }>; // { a: 1; b: 3; c: 4 }
- */
-type Merge<T, U> = Omit<T, keyof U> & U;
-/**
- * 名义类型（品牌化）。
- * @example
- * type UserId = Brand<number, 'UserId'>;
- */
-type Brand<T, B extends string> = T & {
-    readonly __brand: B;
-};
-/**
- * 可空（包含 `null | undefined`）。
- * @example
- * type R = Nullable<string>; // string | null | undefined
- */
-type Nullable<T> = T | null | undefined;
-/**
- * 可序列化为 JSON 的值类型。
- */
-type JsonPrimitive = string | number | boolean | null;
-type JsonObject = {
-    [k: string]: JsonValue;
-};
-type JsonArray = Array<JsonValue>;
-type JsonValue = JsonPrimitive | JsonObject | JsonArray;
-/**
- * 精确匹配形状（不允许多余属性）。
- * @example
- * type Shape = { a: number };
- * type OK = Exact<{ a: number }, Shape>; // { a: number }
- * type NG = Exact<{ a: number; b: 1 }, Shape>; // never
- */
-type Exact<T, Shape> = T extends Shape ? Exclude<keyof T, keyof Shape> extends never ? T : never : never;
-
-/**
- * 获取文件后缀（不含点，返回小写）。
- * 当文件名不包含点（'.'）时，返回空字符串。
- * @param fileName 文件名，例如 `avatar.PNG`
- * @returns 后缀字符串，例如 `png`
- * @example getFileSuffix('avatar.PNG') // 'png'
- * @example getFileSuffix('a.tar.gz') // 'gz'
- * @example getFileSuffix('.ignore') // ''
- * @example getFileSuffix('abc') // ''
- */
-declare function getFileSuffix(fileName: string): string;
-/**
- * 根据文件后缀判断文件类型。
- * 会将后缀转换为小写后与 `FILE_TYPE` 映射匹配；若未匹配到则返回 `'unknown'`。
- * @param fileName 文件名
- * @returns 文件类型字符串（如 'img' | 'video' | 'voice' | 'excel' | 'word' | 'zip' | 'ppt' | 'app' | 'unknown'）
- * @example getFileType('avatar.PNG') // 'img'
- * @example getFileType('archive.tar') // 'zip'
- * @example getFileType('abc') // 'unknown'
- */
-declare function getFileType(fileName: string): "zip" | "ppt" | "unknown" | "img" | "video" | "voice" | "excel" | "word" | "app";
-
-// 兼容oss后期添加的参数
-type OtherOption = Record<string, string | number | boolean | undefined>;
-
-type OSSGravity = 'nw' | 'north' | 'ne' | 'west' | 'center' | 'east' | 'sw' | 'south' | 'se';
-
-type OSSFormat = 'png' | 'jpg' | 'jpeg' | 'webp' | 'bmp' | 'gif' | 'tiff' | 'heic' | 'avif';
-
-type OSSResizeOption = {
-  p?: number;
-  w?: number;
-  h?: number;
-  m?: 'lfit' | 'mfit' | 'fill' | 'pad' | 'fixed';
-  l?: number;
-  s?: number;
-  limit?: 1 | 0;
-  color?: string;
-} & OtherOption;
-
-type OSSCropOption = {
-  w?: number;
-  h?: number;
-  x?: number;
-  y?: number;
-  g?: OSSGravity;
-  p?: number;
-} & OtherOption;
-
-type OSSIndexCropOption = {
-  x?: number;
-  y?: number;
-  i?: number;
-} & OtherOption;
-
-type OSSQualityOption = {
-  q?: number;
-  Q?: number;
-} & OtherOption;
-
-type OSSWatermarkOption = {
-  type?: string;
-  text?: string;
-  size?: number;
-  color?: string;
-  shadow?: number;
-  t?: number;
-  g?: OSSGravity;
-  x?: number;
-  y?: number;
-  voffset?: number;
-  fill?: 0 | 1;
-  padx?: number;
-  pady?: number;
-  image?: string;
-  P?: number;
-} & OtherOption;
-
-type OSSBlurOption = {
-  r: number;
-  s: number;
-  g?: 'face' | 'faces';
-  p?: number;
-} & OtherOption;
-
-type OSSRoundedCornersOption = {
-  r: number;
-} & OtherOption;
-
-type OSSCircleOption = {
-  r: number;
-} & OtherOption;
-
-type OSSImgOption = {
-  resize?: OSSResizeOption;
-  watermark?: OSSWatermarkOption;
-  flip?: 0 | 1 | 2;
-  crop?: OSSCropOption;
-  quality?: OSSQualityOption;
-  format?: OSSFormat;
-  info?: boolean;
-  'auto-orient'?: 0 | 1;
-  circle?: OSSCircleOption;
-  indexcrop?: OSSIndexCropOption;
-  'rounded-corners'?: OSSRoundedCornersOption;
-  blur?: OSSBlurOption;
-  rotate?: number;
-  interlace?: 0 | 1;
-  'average-hue'?: boolean;
-  bright?: number;
-  sharpen?: number;
-  contrast?: number;
-} & {
-  [action: string]: number | string | boolean | Record<string, unknown> | undefined;
-};
-
-type OSSVideoOption = {
-  convert?: Record<string, unknown>;
-  animation?: Record<string, unknown>;
-  sprite?: Record<string, unknown>;
-  snapshots?: Record<string, unknown>;
-  concat?: Record<string, unknown>;
-  info?: boolean;
-} & {
-  [action: string]: number | string | boolean | Record<string, unknown> | undefined;
-};
-
-type OSSAudioOption = {
-  convert?: Record<string, unknown>;
-  concat?: Record<string, unknown>;
-  info?: boolean;
-} & {
-  [action: string]: number | string | boolean | Record<string, unknown> | undefined;
-};
-
-type OSSHlsOption = {
-  m3u8?: boolean | Record<string, unknown>;
-} & {
-  [action: string]: number | string | boolean | Record<string, unknown> | undefined;
-};
-
-type OSSOption = OSSImgOption | OSSVideoOption | OSSAudioOption | OSSHlsOption;
-
-/**
- * 获取url的查询参数值
- * - 采用纯JS解析，因为小程序不支持URLSearchParams
- * @param key 参数名
- * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
- * @returns 解码后的参数值 (若不存在|"null"|"undefined"，则返回 null)
- * @example
- * const q = getUrlParam('q', 'https://a.com/?q=%E6%B5%8B%E8%AF%95'); // "测试"
- * const a = getUrlParam('a', 'a=1'); // "1"
- * const list = getUrlParam('list', 'list=[1,2]'); // "[1,2]"
- * const list = getUrlParam('list', 'list=null'); // null
- * const list = getUrlParam('list', 'list=undefined'); // null
- */
-declare function getUrlParam(key: string, url: string): string | null;
-/**
- * 获取url的查询参数值,并转为number类型
- * @param key 参数名
- * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
- * @returns 解码后的参数值 (若不存在|"非数字字符串"，则返回 null)
- * @example
- * const a = getUrlNumber('a', 'https://a.com/?a=1'); // 1
- * const a = getUrlNumber('a', 'a=1'); // 1
- * const a = getUrlNumber('a', 'a=1.2'); // 1.2
- * const a = getUrlNumber('a', 'a=abc'); // null
- */
-declare function getUrlNumber(key: string, url: string): number | null;
-/**
- * 获取url的所有查询参数值
- * - 采用纯JS解析，因为小程序不支持URLSearchParams
- * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
- * @returns 解码后的键值对象（无参数返回空对象; "null"|"undefined"的参数会被忽略）
- * @example
- * const params = getUrlParamAll('a=1&b=2'); // { a: "1", b: "2" }
- * const params = getUrlParamAll('https://a.com/?a=1&b=2'); // { a: "1", b: "2" }
- * const params = getUrlParamAll('a=1&b=null'); // { a: "1" }
- * const params = getUrlParamAll('a=1&b=undefined'); // { a: "1" }
- */
-declare function getUrlParamAll(url: string): Record<string, string>;
-/**
- * 将对象参数拼接到 URL
- * - 采用纯JS拼接，因为小程序不支持URLSearchParams
- * @param url 基础地址
- * @param param 将要追加的参数对象；`null/undefined` 值会被忽略，Object 会使用 `JSON.stringify`
- * @returns 拼接后的完整 URL（保留原有哈希片段）
- * @example
- * const url = appendUrlParam('https://a.com', { q: '测试', list: [1, 2], a: null, b: undefined }); // 'https://a.com/?q=%E6%B5%8B%E8%AF%95&list=[1,2]'
- */
-declare function appendUrlParam(url: string, param: Record<string, unknown>): string;
-
-type QnOtherOption = Record<string, string | number | boolean | undefined>;
-
-type QnImageView2Option = {
-  mode?: 0 | 1 | 2 | 3 | 4 | 5;
-  w?: number;
-  h?: number;
-  l?: number;
-  limit?: 0 | 1;
-  q?: number;
-  format?: string;
-} & QnOtherOption;
-
-type QnMogr2Option = {
-  thumbnail?: string;
-  crop?: string;
-  rotate?: number;
-  'auto-orient'?: boolean;
-  format?: string;
-  interlace?: 0 | 1;
-  background?: string;
-  q?: number;
-  blur?: string | { r: number; s: number };
-  colors?: number;
-} & QnOtherOption;
-
-type QnWatermarkOption = {
-  type?: 'image' | 'text' | number;
-  image?: string;
-  text?: string;
-  font?: string;
-  fontsize?: number;
-  fill?: string;
-  gravity?: string;
-  dx?: number;
-  dy?: number;
-  dissolve?: number;
-} & QnOtherOption;
-
-type QnImgOption = {
-  imageView2?: QnImageView2Option;
-  imageMogr2?: QnMogr2Option;
-  watermark?: QnWatermarkOption;
-  imageslim?: boolean;
-  imageInfo?: boolean;
-} & {
-  thumbnail?: string;
-  crop?: string;
-  rotate?: number;
-  'auto-orient'?: boolean;
-  format?: string;
-  interlace?: 0 | 1;
-  background?: string;
-  q?: number;
-  blur?: string | { r: number; s: number };
-  colors?: number;
-  [action: string]: number | string | boolean | Record<string, unknown> | undefined;
-};
-
-type QnAvthumbOption = {
-  format?: string;
-  s?: string;
-  vcodec?: 'libx264' | 'libx265' | 'copy' | string;
-  vb?: string; // e.g. '1.25m', '128k', support '!'
-  r?: number; // frame rate
-  acodec?: 'libmp3lame' | 'libfdk_aac' | 'copy' | string;
-  ab?: string; // e.g. '128k', support '!'
-  ar?: number; // sampling rate
-} & QnOtherOption;
-
-type QnVframeOption = {
-  format?: 'jpg' | 'png';
-  offset?: number; // seconds, support decimals
-  w?: number;
-  h?: number;
-} & QnOtherOption;
-
-type QnVideoOption = {
-  avthumb?: QnAvthumbOption;
-  vframe?: QnVframeOption;
-} & {
-  [action: string]: number | string | boolean | Record<string, unknown> | undefined;
-};
-
-type QnAudioOption = {
-  avthumb?: QnAvthumbOption;
-} & {
-  [action: string]: number | string | boolean | Record<string, unknown> | undefined;
-};
-
-type QnHlsOption = {
-  level?: number; // e.g. 3 for 720p preset
-  format?: 'm3u8';
-  segtime?: number; // 2-10 seconds
-  t?: string; // duration like '1.500s'
-  vcodec?: 'libx264' | 'libx265' | 'copy' | string;
-  vb?: string; // bitrate e.g. '1.25m', '128k', support '!'
-  r?: number; // frame rate [1,60]
-  s?: string; // resolution '1280x720'
-  acodec?: 'libmp3lame' | 'libfdk_aac' | 'copy' | string;
-  ab?: string; // audio bitrate
-  ar?: number; // audio sampling rate
-  output?: string; // m3u8 filename (url-safe base64)
-} & QnOtherOption;
-
-/**
- * 纯字母（不含空格与符号）。
- * @param s 字符串
- * @returns 是否为字母
- * @example
- * isLetter('abc') // true
- * isLetter('123') // false
- * isLetter('abc123') // false
- */
-declare function isLetter(s: string): boolean;
-/**
- * 纯中文（不含空格与符号）。
- * @param s 字符串
- * @returns 是否为纯中文
- * @example
- * isChinese('你好') // true
- */
-declare function isChinese(s: string): boolean;
-/**
- * 纯数字（非负整数,不含空格与符号）。
- * @param s 字符串
- * @returns 是否为数字
- * @example
- * isDigits('12') // true
- * isDigits('1.2') // false
- * isDigits('-12') // false
- * isDigits('a12') // false
- */
-declare function isDigits(s: string): boolean;
-/**
- * 数字字符串格式校验
- * @param value   待验证值（字符串或数字）
- * @param options 可选项
- * @param options.negative 是否允许负数，默认 false
- * @param options.decimal 小数位数，默认 2（0 表示必须整数）
- * @param options.thousands 是否允许千分位逗号，默认 false
- * @param options.leadZero 是否允许整数部分出现多余前导0 (默认false, 即禁止'007'，但允许'0.50')
- * @example
- * isNumeric('123.45'); // true
- * isNumeric('123.45', { decimal: 0 }); // false
- * isNumeric('-1,234.5', { negative: true, thousands: true }); // true
- * isNumeric('0123', { leadZero: true }); // true（现在允许）
- * isNumeric('0123'); // false（默认禁止）
- * isNumeric('0.50'); // true（始终允许）
- * isNumeric('.5'); // false（整数部分不能省）
- * isNumeric('123.'); // false（小数部分不能省）
- */
-declare function isNumeric(value: string | number, options?: {
-    negative?: boolean;
-    decimal?: number;
-    thousands?: boolean;
-    leadZero?: boolean;
-}): boolean;
-/**
- * 是否为中国大陆手机号（11 位，以 1 开头，第二位 3-9）。
- * @param s 待校验的号码
- * @returns 是否为合法手机号
- * @example
- * isMobilePhone('13800138000') // true
- * isMobilePhone('12800138000') // false
- */
-declare function isMobilePhone(s: string): boolean;
-/**
- * 是否为中国大陆座机号（区号-号码，可选分机）。
- * 格式：`0AA-BBBBBBBB(-EXT)`，其中区号 2-3 位、号码 7-8 位、分机 1-6 位。
- * @param s 待校验的号码
- * @returns 是否为合法座机号
- * @example
- * isLandline('010-88888888') // true
- * isLandline('0371-12345678-123') // true
- */
-declare function isLandline(s: string): boolean;
-/**
- * 联系电话：是否为中国大陆“手机号或座机号”。
- * @param s 待校验的号码
- * @returns 是否为合法的手机号或座机号
- * @example
- * isPhone('13800138000') // true
- * isPhone('010-88888888') // true
- */
-declare function isPhone(s: string): boolean;
-/**
- * 校验邮箱地址（基于 RFC 5322 的常用子集）。
- * @param s 待校验的邮箱字符串
- * @returns 是否为合法邮箱
- * @example
- * isEmail('user@example.com') // true
- * isEmail('invalid@') // false
- */
-declare function isEmail(s: string): boolean;
-/**
- * 中文姓名（允许中间点 `·`），长度 2-20。
- * @param s 姓名
- * @returns 是否为合法中文姓名
- * @example
- * isChineseName('张三') // true
- * isChineseName('阿·娜') // true
- */
-declare function isChineseName(s: string): boolean;
-/**
- * 身份证校验（支持中国大陆严格校验；台湾/香港/澳门做格式校验）。
- * 规则：
- * - 中国大陆（严格）：18 位校验位 + 出生日期合法性；兼容 15 位旧号（日期校验）；
- * - 台湾（格式）：`^[A-Z][12]\d{8}$`（首字母 + 性别位 1/2 + 8 位数字）；不含校验位算法；
- * - 香港（格式）：`^[A-Z]{1,2}\d{6}\(?[0-9A]\)?$`（1-2 字母 + 6 位数字 + 校验位，可带括号）；
- * - 澳门（格式）：常见为 `^[157]\d{6}\(?\d\)?$`（类别位 1/5/7 + 7 位数字 + 校验位，可带括号）。
- * @param code 身份证号码
- * @returns 是否为合法身份证号
- * @example
- * isIdentityCard('11010519491231002X') // true（大陆）
- * isIdentityCard('A123456789') // true（台湾格式）
- * isIdentityCard('A123456(3)') // true（香港格式）
- * isIdentityCard('1234567(8)') // true（澳门格式）
- */
-declare function isIdentityCard(code: string): boolean;
-/**
- * 护照号码校验（宽松通用格式，适合单输入框无法确认国家的场景）。
- * 说明：各国护照格式差异较大，此函数提供常见模式的格式校验；不做校验位算法。
- * 包含：
- * - 中国护照常见：`E/G` 开头 + 8 位数字；`D/P/S` 开头 + 7 位数字；
- * - 台湾护照常见：首字母 + 8 位数字；
- * - 通用兜底：6-9 位的字母数字组合；移除输入中的空格与 `-` 后再校验。
- * @param s 护照号码
- * @returns 是否匹配常见护照格式
- * @example
- * isPassport('E12345678') // true
- * isPassport('P1234567') // true
- * isPassport('A12345678') // true（台湾常见）
- * isPassport('AB-1234567') // true（移除分隔符后匹配）
- */
-declare function isPassport(s: string): boolean;
-/**
- * 港澳通行证（回乡证）号码校验。
- * 说明：常见为 `H/M` 开头 + 8~10 位数字；自动移除输入中的空格与 `-`。
- * @param s 证件号
- * @returns 是否为港澳通行证格式
- * @example
- * isHKMOPermit('H12345678') // true
- * isHKMOPermit('M1234567890') // true
- */
-declare function isHKMOPermit(s: string): boolean;
-/**
- * 台湾居民来往大陆通行证（台胞证）号码校验。
- * 说明：常见为 8 位纯数字；或首字母 + 8 位数字；部分场景存在 10 位数字。
- * @param s 证件号
- * @returns 是否为台胞证格式
- * @example
- * isTaiwanPermit('12345678') // true
- * isTaiwanPermit('T12345678') // true
- * isTaiwanPermit('1234567890') // true
- */
-declare function isTaiwanPermit(s: string): boolean;
-/**
- * 军官证号码校验：字母数字组合，长度 7-18。
- * @param s 证件号
- * @returns 是否为军官证宽松格式
- * @example
- * isOfficerIdLoose('JX1234567') // true
- */
-declare function isOfficerId(s: string): boolean;
-/**
- * 士兵证号码校验：字母数字组合，长度 7-18。
- * @param s 证件号
- * @returns 是否为士兵证格式
- * @example
- * isSoldierId('SB12345678') // true
- */
-declare function isSoldierId(s: string): boolean;
-/**
- * 中国军证（军官证/士兵证）组合校验。
- * @param s 证件号
- * @returns 是否为军官证或士兵证格式
- * @example
- * isCnMilitaryId('JX1234567') // true
- */
-declare function isMilitaryId(s: string): boolean;
-/**
- * 银行卡号校验（Luhn 校验）。
- * 说明：移除空格与 `-` 后进行 Luhn 校验；长度通常为 12-19 位。
- * @param s 银行卡号
- * @returns 是否通过 Luhn 校验
- * @example
- * isBankCard('6222 0201 2345 6789') // true
- */
-declare function isBankCard(s: string): boolean;
-/**
- * 中国车牌号校验（含普通与新能源）。
- * @param s 车牌号码
- * @returns 是否为合法中国车牌
- * @example
- * isLicensePlate('京A12345') // true
- * isLicensePlate('沪A12345D') // 新能源（末位 D/F）
- * isLicensePlate('粤BDF12345') // 新能源（第三位 D/F）
- */
-declare function isLicensePlate(s: string): boolean;
-/**
- * 校验统一社会信用代码（中国税号常用：18 位，含校验位）。
- * 规则：
- * - 字符集：数字与大写字母（不含 I/O/Z/S/V），即 `[0-9A-HJ-NPQRTUWXY]`；
- * - 前 17 位参与加权求和，最后一位为校验码（取值 0-9 或 大写字母）。
- * @param code 税号/统一社会信用代码
- * @returns 是否为合法税号
- * @example
- * isTaxID('91350100M000100Y43') // true/false 取决于校验位
- */
-declare function isTaxID(code: string): boolean;
-/**
- * 判断字符串是否为合法 JSON 文本。
- * 说明：传入字符串时尝试 `JSON.parse`；传入对象/数组则视为合法。
- * @param input 待判定的值或字符串
- * @returns 是否为合法 JSON
- * @example
- * isJSON('{"a":1}') // true
- * isJSON('[1,2]') // true
- * isJSON('abc') // false
- */
-declare function isJSON(input: unknown): boolean;
-/**
- * HEX 颜色值（支持 `#RGB`、`#RRGGBB`、`#RRGGBBAA`）。
- * @param s 颜色字符串
- * @returns 是否为合法 HEX 颜色
- * @example
- * isHexColor('#fff') // true
- * isHexColor('#00ff00') // true
- * isHexColor('#11223344') // true
- */
-declare function isHexColor(s: string): boolean;
-/**
- * 校验 URL（要求含协议，支持 http/https/ftp）。
- * @param s 待校验的地址
- * @returns 是否为合法 URL
- * @example
- * isURL('https://example.com/path?a=1') // true
- * isURL('example.com') // false（缺少协议）
- */
-declare function isURL(s: string): boolean;
-/**
- * 判断是否为合法 IPv6 地址（支持压缩表示与 IPv4 映射）。
- * 规则：
- * - 由 8 组 1~4 位十六进制数组成，允许一次 `::` 压缩；
- * - 允许最后一组使用 IPv4 映射（如 `::ffff:192.168.0.1`）。
- * @param s IP 字符串
- * @returns 是否为合法 IPv6
- * @example
- * isIPv6('2001:0db8:85a3:0000:0000:8a2e:0370:7334') // true
- * isIPv6('2001:db8::8a2e:370:7334') // true
- * isIPv6('2001:::370:7334') // false
- */
-declare function isIPv6(s: string): boolean;
-/**
- * 校验 IP（支持 IPv4 与 IPv6）。
- * @param s IP 字符串
- * @param version 指定版本：传 `4` 仅校验 IPv4，传 `6` 仅校验 IPv6；缺省同时校验两者
- * @returns 是否为合法 IP
- * @example
- * isIP('127.0.0.1') // true
- * isIP('::1') // true
- * isIP('127.0.0.1', 6) // false
- */
-declare function isIP(s: string, version?: 4 | 6 | '4' | '6'): boolean;
-/**
- * 校验 CIDR IP 段（支持 IPv4/IPv6），形如 `IP/前缀长度`。
- * @param s CIDR 字符串，如 `192.168.0.0/24`、`2001:db8::/32`
- * @returns 是否为合法 CIDR
- * @example
- * isIPRange('10.0.0.0/8') // true
- * isIPRange('2001:db8::/129') // false
- */
-declare function isIPRange(s: string): boolean;
-/**
- * 端口号校验（0 ~ 65535，整数）。
- * @param s 端口（字符串或数字）
- * @returns 是否为合法端口范围
- * @example
- * isPortNumber(80) // true
- * isPortNumber('65535') // true
- * isPortNumber(70000) // false
- */
-declare function isPortNumber(s: string | number): boolean;
-/**
- * 纬度校验（-90 ~ 90）。
- * @param s 纬度值（字符串或数字）
- * @returns 是否为合法纬度
- * @example
- * isLatitude('31.2304') // true
- */
-declare function isLatitude(s: string | number): boolean;
-/**
- * 经度校验（-180 ~ 180）。
- * @param s 经度值（字符串或数字）
- * @returns 是否为合法经度
- * @example
- * isLongitude('121.4737') // true
- */
-declare function isLongitude(s: string | number): boolean;
-
-export { type Brand, type DeepPartial, type DeepRequired, EventBus, type Exact, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type KeysOfType, type Merge, type Mutable, type Nullable, type NumLike, type OSSAudioOption, type OSSBlurOption, type OSSCircleOption, type OSSCropOption, type OSSFormat, type OSSGravity, type OSSHlsOption, type OSSImgOption, type OSSIndexCropOption, type OSSOption, type OSSQualityOption, type OSSResizeOption, type OSSRoundedCornersOption, type OSSVideoOption, type OSSWatermarkOption, type OptionalKeys, type PickByType, type QnAudioOption, type QnAvthumbOption, type QnHlsOption, type QnImageView2Option, type QnImgOption, type QnMogr2Option, type QnVframeOption, type QnVideoOption, type QnWatermarkOption, type ReadonlyDeep, type RequiredKeys, type SetOptional, type SetRequired, type UnionToIntersection, type ValueOf, appendUrlParam, arrayMove, big, bigAdd, bigCompare, bigDiv, bigEqual, bigGt, bigGte, bigLt, bigLte, bigMul, bigPow, bigRound, bigSub, createRandId, createTimeRandId, createUUID, getAgeByBirthdate, getCountdownParts, getDateRangeAfter, getDateRangeBefore, getFileSuffix, getFileType, getObjectKeys, getStringByteLength, getUrlNumber, getUrlParam, getUrlParamAll, isBankCard, isChinese, isChineseName, isDigits, isEmail, isHKMOPermit, isHexColor, isIP, isIPRange, isIPv6, isIdentityCard, isJSON, isLandline, isLatitude, isLetter, isLicensePlate, isLongitude, isMilitaryId, isMobilePhone, isNumeric, isOfficerId, isPassport, isPhone, isPortNumber, isSoldierId, isTaiwanPermit, isTaxID, isURL, randomBoolean, randomFloat, randomInt, toAsync, toChineseCurrency, toChineseNum, toDayjs, toFixed, toMaskName, toMaskPhone, toMaskText, toThousandth, withDistance, withUnit, withUnitPx, zeroPad };