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

package/dist/lodash/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * re-export 全量 lodash-es
+ * 文档: https://www.lodashjs.com/
+ * 目的: 从工具库统一loadsh版本，避免项目多个版本冲突
+ * 注意: 需在tsup.config.ts加入noExternal: ['lodash-es'],确保打包时不被忽略
+ */
+export * from 'lodash-es';
+//# sourceMappingURL=index.d.ts.map

package/dist/lodash/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/lodash/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,WAAW,CAAC"}

package/dist/number/big.d.ts

@@ -0,0 +1,137 @@
+import BigNumber from 'bignumber.js';
+/**
+ * 数值入参类型。
+ * 支持原生 `number`、`string`（包含小数、科学计数法等）以及 `BigNumber`。
+ */
+export type NumLike = string | number | BigNumber;
+/**
+ * 将任意 `NumLike` 统一转换为 `BigNumber` 实例。
+ * @param x 任意支持的数值入参。
+ * @returns `BigNumber` 实例。
+ * @example
+ * big('0.1'); // => BigNumber
+ * big(0.2);   // => BigNumber
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export declare function bigDiv(a: NumLike, ...rest: NumLike[]): number;
+/**
+ * 指数运算
+ * @param x 底数。
+ * @param y 指数。
+ * @returns 计算结果。
+ * @example
+ * bigPow(2, 3); // => 8
+ * bigPow('2.5', 2); // => 6.25
+ */
+export 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
+ */
+export 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'
+ */
+export declare function toFixed(x: NumLike, dp?: number, rm?: BigNumber.RoundingMode): string;
+/**
+ * 比较两个数值大小。
+ * @example
+ * bigCompare('2', '10'); // => -1
+ * bigCompare(3, 3);      // => 0
+ * bigCompare('10', 2);   // => 1
+ */
+export declare function bigCompare(a: NumLike, b: NumLike): -1 | 0 | 1 | null;
+/**
+ * 判断两个数值是否相等。
+ * @example
+ * bigEqual('1.0', 1); // => true
+ * bigEqual(2, 1); // => false
+ */
+export declare function bigEqual(a: NumLike, b: NumLike): boolean;
+/**
+ * 判断 a 是否大于 b。
+ * @example
+ * bigGt(2, 1); // => true
+ * bigGt(1, 2); // => false
+ */
+export declare function bigGt(a: NumLike, b: NumLike): boolean;
+/**
+ * 判断 a 是否大于等于 b。
+ * @example
+ * bigGte(2, 2); // => true
+ * bigGte(1, 2); // => false
+ */
+export declare function bigGte(a: NumLike, b: NumLike): boolean;
+/**
+ * 判断 a 是否小于 b。
+ * @example
+ * bigLt(1, 2); // => true
+ * bigLt(2, 1); // => false
+ */
+export declare function bigLt(a: NumLike, b: NumLike): boolean;
+/**
+ * 判断 a 是否小于等于 b。
+ * @example
+ * bigLte(2, 2); // => true
+ * bigLte(1, 2); // => true
+ * bigLte(2, 1); // => false
+ */
+export declare function bigLte(a: NumLike, b: NumLike): boolean;
+/**
+ * 导出 BigNumber 类
+ * @example
+ * BigNumber.ROUND_HALF_UP; // 使用类型
+ * BigNumber.set(config); // 设置全局配置
+ * const bn = new BigNumber('123456.789'); // 创建实例
+ */
+export { BigNumber };
+//# sourceMappingURL=big.d.ts.map

package/dist/number/big.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"big.d.ts","sourceRoot":"","sources":["../../src/ts/number/big.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAIpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,UAE5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,SAAI,EAAE,EAAE,GAAE,SAAS,CAAC,YAAsC,UAEhG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACrB,CAAC,EAAE,OAAO,EACV,EAAE,SAAI,EACN,EAAE,GAAE,SAAS,CAAC,YAAsC,GACnD,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/number/format.d.ts

@@ -0,0 +1,88 @@
+import { BigNumber } from './big';
+/**
+ * 开头补零
+ * @param n 数字
+ * @param len 总长度，默认 2
+ * @returns 零填充后的字符串
+ * @example
+ * zeroPad(1) // '01'
+ * zeroPad(12) // '12'
+ * zeroPad(12, 4) // '0012'
+ */
+export 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 | '') // ""
+ */
+export 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"
+ */
+export 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'
+ */
+export declare function withDistance(m: number | string): string;
+/**
+ * 数字转千分位字符串（保留小数与符号）。
+ * @example
+ * toThousandth(1234567); // => '1,234,567'
+ * toThousandth('1234567.89'); // => '1,234,567.89'
+ * toThousandth('-987654'); // => '-987,654'
+ */
+export declare function toThousandth(str: number | string): string;
+/**
+ * 阿拉伯数字转中文整数（忽略小数；支持负数）。
+ * @param num 输入的数字或数字字符串（小数部分将被丢弃）
+ * @returns 中文数字字符串；非法输入返回空字符串
+ * @example
+ * toChineseNum(123456);   // "十二万三千四百五十六"
+ * toChineseNum(-10008);   // "负一万零八"
+ * `第${toChineseNum(123)}条` // "第一百二十三条"
+ */
+export 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) // '负壹元贰角'
+ */
+export declare function toChineseCurrency(amount: number | string, opts?: {
+    precision?: 0 | 1 | 2 | 3;
+    rm?: BigNumber.RoundingMode;
+    yuanChar?: '元' | '圆';
+}): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/number/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/ts/number/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAI,UAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,SAAK,UAUxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,UAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAIvD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAqBzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,UA4ChD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,EAAE,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;CACjB,GACL,MAAM,CAyER"}

package/dist/number/index.d.ts

@@ -0,0 +1,4 @@
+export * from './big';
+export * from './format';
+export * from './random';
+//# sourceMappingURL=index.d.ts.map

package/dist/number/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/number/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/number/random.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 随机生成 `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）
+ */
+export 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) 内的随机浮点数
+ */
+export declare function randomFloat(a: number, b: number): number;
+/**
+ * 随机生成一个布尔值。
+ * @returns 随机布尔值。
+ * @example
+ * randomBoolean(); // => 随机返回 true 或 false
+ */
+export declare function randomBoolean(): boolean;
+//# sourceMappingURL=random.d.ts.map

package/dist/number/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/ts/number/random.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAWxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/object/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 获取对象键名数组（类型安全）。
+ * 注：内置 `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']
+ */
+export declare function getObjectKeys<T extends object>(obj: T): Array<keyof T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/object/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAEtE"}

package/dist/string/format.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 文本脱敏
+ * @param s 原始文本
+ * @param keepLeft 保留左侧字符数（默认 1）
+ * @param keepRight 保留右侧字符数（默认 0）
+ * @param maskChar 脱敏字符（默认 `*`）
+ * @returns 脱敏文本
+ * @example
+ * toMaskText('王小明', 1, 0) // => '王*'
+ * toMaskText('王小明', 1, 1) // => '王*明'
+ * toMaskText('13800138000', 3, 4) // => '138****8000'
+ */
+export declare function toMaskText(s: string, keepLeft?: number, keepRight?: number, maskChar?: string): string;
+/**
+ * 手机号中间打星：保留前三位与后四位，中间打 `*`。
+ * @param phone 手机号字符串
+ * @returns 遮蔽后的手机号
+ * @example
+ * toMaskPhone('13800138000') // => '138****8000'
+ */
+export declare function toMaskPhone(phone: string): string;
+/**
+ * 姓名打星：
+ * - 长度 ≤ 2：保留首字，其余打 `*`
+ * - 长度 ≥ 3：保留首尾，各打星中间
+ * @param name 姓名字符串
+ * @returns 遮蔽后的姓名
+ * @example
+ * toMaskName('张三') // => '张*'
+ * toMaskName('王小明') // => '王*明'
+ */
+export declare function toMaskName(name: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/string/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/ts/string/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,SAAS,SAAI,EAAE,QAAQ,SAAM,UAYhF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,UAExC;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,UAItC"}

package/dist/string/index.d.ts

@@ -0,0 +1,4 @@
+export * from './format';
+export * from './random';
+export * from './other';
+//# sourceMappingURL=index.d.ts.map

package/dist/string/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/string/other.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 计算字符串在 UTF-8 编码下的字节长度。
+ * 使用场景：
+ * 1) 按字节限制表单输入（避免超过后端/数据库字段上限）
+ * 2) 评估网络传输、缓存（Redis/消息队列）开销
+ * 3) 根据字节数截断或提示用户（而非按字符数）
+ * @param str 输入的字符串
+ * @returns 字符串的字节长度
+ * @example
+ * getStringByteLength('abc') // 3
+ * getStringByteLength('中文') // 6
+ * getStringByteLength('😊') // 4
+ */
+export declare function getStringByteLength(str: string): number;
+//# sourceMappingURL=other.d.ts.map

package/dist/string/other.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"other.d.ts","sourceRoot":"","sources":["../../src/ts/string/other.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBvD"}

package/dist/string/random.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 生成UUID
+ * @returns UUID字符串
+ * @example
+ * const uuid = createUUID() // '7982fcfe-5721-4632-bede-6000885be57d'
+ */
+export declare function createUUID(): string;
+/**
+ * 生成随机字符串id
+ * - 常用于生成元素标签的id (默认加上'id_'前缀, 避免小程序中数字开头的id导致查询节点信息失败)
+ * @param prefix 前缀, 默认 'id_'
+ * @returns 随机字符串
+ * @example
+ * const id = createRandId(); // 'id_0rjuuuqv60xi'
+ * const id = createRandId('canvas_'); // 'canvas_v82a7ctm09q'
+ */
+export declare function createRandId(prefix?: string): string;
+/**
+ * 时间+固定位数的随机数字字符串
+ * @param digits 随机部分的位数，默认 6
+ * @returns 时间+随机数字字符串
+ * @example
+ * const traceId = createTimeRandId(); // '1763002648039123456'
+ * const traceId = createTimeRandId(8); // '176300264803912345678'
+ */
+export declare function createTimeRandId(digits?: number): string;
+//# sourceMappingURL=random.d.ts.map

package/dist/string/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/ts/string/random.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,WAMzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAQ,UAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,MAAU,UAMlD"}

package/dist/typing/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * 将指定属性设为必填（不改变其他属性）。
+ * - 所有属性必填请使用内置的Required<T>
+ * @example
+ * type User = { id?: number; name?: string; age?: number };
+ * type U1 = SetRequired<User, 'id' | 'name'>; // { id: number; name: string; age?: number }
+ */
+export 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 }
+ */
+export 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>;
+ */
+export 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 } }
+ */
+export 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 }
+ */
+export type Mutable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+/**
+ * 深度只读（递归添加 `readonly`）。
+ * @example
+ * type R = ReadonlyDeep<{ a: { b: number }; list: { id: string }[] }>;
+ */
+export 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'
+ */
+export type ValueOf<T> = T[keyof T];
+/**
+ * 根据值类型获取键名联合。
+ * @example
+ * type Keys = KeysOfType<{ a: string; b: number; c: string }, string>; // 'a' | 'c'
+ */
+export 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 }
+ */
+export type PickByType<T, V> = Pick<T, KeysOfType<T, V>>;
+/**
+ * 可选键名联合。
+ * @example
+ * type K = OptionalKeys<{ a?: number; b: string }>; // 'a'
+ */
+export 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'
+ */
+export 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 }
+ */
+export 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 }
+ */
+export type Merge<T, U> = Omit<T, keyof U> & U;
+/**
+ * 名义类型（品牌化）。
+ * @example
+ * type UserId = Brand<number, 'UserId'>;
+ */
+export type Brand<T, B extends string> = T & {
+    readonly __brand: B;
+};
+/**
+ * 可空（包含 `null | undefined`）。
+ * @example
+ * type R = Nullable<string>; // string | null | undefined
+ */
+export type Nullable<T> = T | null | undefined;
+/**
+ * 可序列化为 JSON 的值类型。
+ */
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonObject = {
+    [k: string]: JsonValue;
+};
+export type JsonArray = Array<JsonValue>;
+export 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
+ */
+export type Exact<T, Shape> = T extends Shape ? Exclude<keyof T, keyof Shape> extends never ? T : never : never;
+//# sourceMappingURL=index.d.ts.map

package/dist/typing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/typing/index.ts"],"names":[],"mappings":"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"}

package/dist/url/file/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 获取文件后缀（不含点，返回小写）。
+ * 当文件名不包含点（'.'）时，返回空字符串。
+ * @param fileName 文件名，例如 `avatar.PNG`
+ * @returns 后缀字符串，例如 `png`
+ * @example getFileSuffix('avatar.PNG') // 'png'
+ * @example getFileSuffix('a.tar.gz') // 'gz'
+ * @example getFileSuffix('.ignore') // ''
+ * @example getFileSuffix('abc') // ''
+ */
+export 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'
+ */
+export declare function getFileType(fileName: string): "img" | "video" | "zip" | "ppt" | "unknown" | "voice" | "excel" | "word" | "app";
+//# sourceMappingURL=index.d.ts.map

package/dist/url/file/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ts/url/file/index.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,UAK7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,oFAY3C"}

package/dist/url/index.d.ts

@@ -0,0 +1,5 @@
+export * from './file';
+export * from './oss';
+export * from './param';
+export * from './qn';
+//# sourceMappingURL=index.d.ts.map

package/dist/url/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/url/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC"}