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

package/dist/number/big.d.ts

@@ -16,27 +16,27 @@ 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
+ * bigPlus(0.1, 0.2); // => 0.3
+ * bigPlus('0.1', '0.2'); // => 0.3
+ * bigPlus(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
  */
-export declare function bigAdd(a: NumLike, ...rest: NumLike[]): number;
+export declare function bigPlus(...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
+ * bigMinus(1, 0.9); // => 0.1
+ * bigMinus('1.1', '0.2'); // => 0.9
+ * bigMinus(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
  */
-export declare function bigSub(a: NumLike, ...rest: NumLike[]): number;
+export declare function bigMinus(...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
+ * bigTimes(0.1, 0.2); // => 0.02
+ * bigTimes('1.5', '3'); // => 4.5
+ * bigTimes(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
  */
-export declare function bigMul(a: NumLike, ...rest: NumLike[]): number;
+export declare function bigTimes(...rest: NumLike[]): number;
 /**
  * 高精度除法（支持多个参数连除）。
  * @example
@@ -44,7 +44,7 @@ export declare function bigMul(a: NumLike, ...rest: NumLike[]): number;
  * bigDiv('10', '4'); // => 2.5
  * bigDiv(100, 5, 2); // => 10  // 多参数连除: 100/5/2
  */
-export declare function bigDiv(a: NumLike, ...rest: NumLike[]): number;
+export declare function bigDiv(...rest: NumLike[]): number;
 /**
  * 指数运算
  * @param x 底数。
@@ -56,7 +56,7 @@ export declare function bigDiv(a: NumLike, ...rest: NumLike[]): number;
  */
 export declare function bigPow(x: NumLike, y: NumLike): number;
 /**
- * 四舍五入到指定位数
+ * 四舍五入到指定小数位数
  * @param x 需要舍入的数值。
  * @param dp 保留的小数位数，默认 `0`（取整）。
  * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
@@ -75,13 +75,13 @@ export declare function bigRound(x: NumLike, dp?: number, rm?: BigNumber.Roundin
  * @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'
+ * bigFixed('1'); // => '1.00'
+ * +bigFixed('1'); // => 1
+ * bigFixed(1.2345); // => '1.23'
+ * bigFixed(1.2345, 3); // => '1.235'
+ * bigFixed('1.2345', 0, BigNumber.ROUND_UP); // => '2'
  */
-export declare function toFixed(x: NumLike, dp?: number, rm?: BigNumber.RoundingMode): string;
+export declare function bigFixed(x: NumLike, dp?: number, rm?: BigNumber.RoundingMode): string;
 /**
  * 比较两个数值大小。
  * @example
@@ -100,32 +100,32 @@ export declare function bigEqual(a: NumLike, b: NumLike): boolean;
 /**
  * 判断 a 是否大于 b。
  * @example
- * bigGt(2, 1); // => true
- * bigGt(1, 2); // => false
+ * bigGreaterThan(2, 1); // => true
+ * bigGreaterThan(1, 2); // => false
  */
-export declare function bigGt(a: NumLike, b: NumLike): boolean;
+export declare function bigGreaterThan(a: NumLike, b: NumLike): boolean;
 /**
  * 判断 a 是否大于等于 b。
  * @example
- * bigGte(2, 2); // => true
- * bigGte(1, 2); // => false
+ * bigGreaterThanOrEqual(2, 2); // => true
+ * bigGreaterThanOrEqual(1, 2); // => false
  */
-export declare function bigGte(a: NumLike, b: NumLike): boolean;
+export declare function bigGreaterThanOrEqualTo(a: NumLike, b: NumLike): boolean;
 /**
  * 判断 a 是否小于 b。
  * @example
- * bigLt(1, 2); // => true
- * bigLt(2, 1); // => false
+ * bigLessThan(1, 2); // => true
+ * bigLessThan(2, 1); // => false
  */
-export declare function bigLt(a: NumLike, b: NumLike): boolean;
+export declare function bigLessThan(a: NumLike, b: NumLike): boolean;
 /**
  * 判断 a 是否小于等于 b。
  * @example
- * bigLte(2, 2); // => true
- * bigLte(1, 2); // => true
- * bigLte(2, 1); // => false
+ * bigLessThanOrEqual(2, 2); // => true
+ * bigLessThanOrEqual(1, 2); // => true
+ * bigLessThanOrEqual(2, 1); // => false
  */
-export declare function bigLte(a: NumLike, b: NumLike): boolean;
+export declare function bigLessThanOrEqual(a: NumLike, b: NumLike): boolean;
 /**
  * 导出 BigNumber 类
  * @example

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

@@ -1 +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"}
+{"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,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAIzC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAI1C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAI1C;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAIxC;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,QAAQ,CACtB,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,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAElE;AAED;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/string/other.d.ts

@@ -1,15 +1,17 @@
 /**
- * 计算字符串在 UTF-8 编码下的字节长度。
- * 使用场景：
- * 1) 按字节限制表单输入（避免超过后端/数据库字段上限）
- * 2) 评估网络传输、缓存（Redis/消息队列）开销
- * 3) 根据字节数截断或提示用户（而非按字符数）
- * @param str 输入的字符串
- * @returns 字符串的字节长度
+ * 获取字节长度 (支持字符串、Buffer/Uint8Array、File/Blob 等类型)
+ * - 字符串按 UTF-8 编码计算字节长度（每个字符 1-4 字节）
+ * - Buffer/Uint8Array 直接返回字节长度（每个元素 1 字节）
+ * - File/Blob 返回文件/Blob 大小（字节数）
+ * @param data 输入的数据
+ * @returns 数据的字节长度
  * @example
- * getStringByteLength('abc') // 3
- * getStringByteLength('中文') // 6
- * getStringByteLength('😊') // 4
+ * getByteLength('abc') // 3
+ * getByteLength('中文') // 6
+ * getByteLength('😊') // 4
+ * getByteLength(new Uint8Array([0x41, 0x42, 0x43])) // 3
+ * getByteLength(new File(['abc'], 'test.txt')) // 3
+ * getByteLength(new Blob(['中文'], { type: 'text/plain' })) // 6
  */
-export declare function getStringByteLength(str: string): number;
+export declare function getByteLength(data: string | ArrayBuffer | ArrayBufferView | File | Blob): number;
 //# sourceMappingURL=other.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"other.d.ts","sourceRoot":"","sources":["../../src/ts/string/other.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CA6BhG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base-web-kits/base-tools-ts",
-  "version": "0.9.9",
+  "version": "0.9.12",
   "sideEffects": false,
   "description": "Independent TS utilities package built from src/ts.",
   "keywords": [

package/src/ts/day/index.ts

@@ -22,7 +22,7 @@ type BaseTime = number | string | Date | dayjs.Dayjs | null | undefined;
  * @param t 各种规范或不规范的时间
  * @returns dayjs 实例
  * @example
- * const d = toDayjs('2021-01-01'); // dayjs 实例
+ * 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
@@ -50,7 +50,7 @@ type BaseTime = number | string | Date | dayjs.Dayjs | null | undefined;
  * d.diff(t, 'quarter'); // 与t相差的季度数
  * d.diff(t, 'year'); // 与t相差的年数
  */
-export function toDayjs(t: BaseTime, fmt?: dayjs.OptionType) {
+export function toDayjs(t?: BaseTime, fmt?: dayjs.OptionType) {
   if (t === null || t === undefined) return dayjs();
   if (typeof t === 'number') {
     const s = String(Math.trunc(t));
@@ -121,7 +121,7 @@ export function getDateRangeAfter(offset: number, fmt = 'YYYY-MM-DD') {
  * @returns 包含天、时、分、秒、毫秒的零填充对象
  * @example
  * const diff = toDayjs(t).diff(); // 毫秒差值
- * const parts = getCountdownParts(diff); // { d: '01', h: '02', m: '03', s: '04', ms: '567' }
+ * const parts = getCountdownParts(diff); // { d: '00', h: '00', m: '00', s: '00', ms: '000' }
  */
 export function getCountdownParts(diff: number) {
   if (diff <= 0) return { d: '00', h: '00', m: '00', s: '00', ms: '000' };

package/src/ts/number/big.ts

@@ -21,39 +21,39 @@ export 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
+ * bigPlus(0.1, 0.2); // => 0.3
+ * bigPlus('0.1', '0.2'); // => 0.3
+ * bigPlus(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
  */
-export function bigAdd(a: NumLike, ...rest: NumLike[]) {
-  let acc = big(a);
-  for (const x of rest) acc = acc.plus(big(x));
+export function bigPlus(...rest: NumLike[]) {
+  let acc = big(rest[0]);
+  for (const x of rest.slice(1)) acc = acc.plus(big(x));
   return acc.toNumber();
 }
 
 /**
  * 高精度减法（支持多个参数连减）。
  * @example
- * bigSub(1, 0.9); // => 0.1
- * bigSub('1.1', '0.2'); // => 0.9
- * bigSub(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
+ * bigMinus(1, 0.9); // => 0.1
+ * bigMinus('1.1', '0.2'); // => 0.9
+ * bigMinus(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
  */
-export function bigSub(a: NumLike, ...rest: NumLike[]) {
-  let acc = big(a);
-  for (const x of rest) acc = acc.minus(big(x));
+export function bigMinus(...rest: NumLike[]) {
+  let acc = big(rest[0]);
+  for (const x of rest.slice(1)) acc = acc.minus(big(x));
   return acc.toNumber();
 }
 
 /**
  * 高精度乘法（支持多个参数连乘）。
  * @example
- * bigMul(0.1, 0.2); // => 0.02
- * bigMul('1.5', '3'); // => 4.5
- * bigMul(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
+ * bigTimes(0.1, 0.2); // => 0.02
+ * bigTimes('1.5', '3'); // => 4.5
+ * bigTimes(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
  */
-export function bigMul(a: NumLike, ...rest: NumLike[]) {
-  let acc = big(a);
-  for (const x of rest) acc = acc.times(big(x));
+export function bigTimes(...rest: NumLike[]) {
+  let acc = big(rest[0]);
+  for (const x of rest.slice(1)) acc = acc.times(big(x));
   return acc.toNumber();
 }
 
@@ -64,9 +64,9 @@ export function bigMul(a: NumLike, ...rest: NumLike[]) {
  * bigDiv('10', '4'); // => 2.5
  * bigDiv(100, 5, 2); // => 10  // 多参数连除: 100/5/2
  */
-export function bigDiv(a: NumLike, ...rest: NumLike[]) {
-  let acc = big(a);
-  for (const x of rest) acc = acc.div(big(x));
+export function bigDiv(...rest: NumLike[]) {
+  let acc = big(rest[0]);
+  for (const x of rest.slice(1)) acc = acc.div(big(x));
   return acc.toNumber();
 }
 
@@ -84,7 +84,7 @@ export function bigPow(x: NumLike, y: NumLike) {
 }
 
 /**
- * 四舍五入到指定位数
+ * 四舍五入到指定小数位数
  * @param x 需要舍入的数值。
  * @param dp 保留的小数位数，默认 `0`（取整）。
  * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
@@ -106,13 +106,13 @@ export function bigRound(x: NumLike, dp = 0, rm: BigNumber.RoundingMode = BigNum
  * @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'
+ * bigFixed('1'); // => '1.00'
+ * +bigFixed('1'); // => 1
+ * bigFixed(1.2345); // => '1.23'
+ * bigFixed(1.2345, 3); // => '1.235'
+ * bigFixed('1.2345', 0, BigNumber.ROUND_UP); // => '2'
  */
-export function toFixed(
+export function bigFixed(
   x: NumLike,
   dp = 2,
   rm: BigNumber.RoundingMode = BigNumber.ROUND_HALF_UP,
@@ -144,41 +144,41 @@ export function bigEqual(a: NumLike, b: NumLike): boolean {
 /**
  * 判断 a 是否大于 b。
  * @example
- * bigGt(2, 1); // => true
- * bigGt(1, 2); // => false
+ * bigGreaterThan(2, 1); // => true
+ * bigGreaterThan(1, 2); // => false
  */
-export function bigGt(a: NumLike, b: NumLike): boolean {
+export function bigGreaterThan(a: NumLike, b: NumLike): boolean {
   return big(a).isGreaterThan(big(b));
 }
 
 /**
  * 判断 a 是否大于等于 b。
  * @example
- * bigGte(2, 2); // => true
- * bigGte(1, 2); // => false
+ * bigGreaterThanOrEqual(2, 2); // => true
+ * bigGreaterThanOrEqual(1, 2); // => false
  */
-export function bigGte(a: NumLike, b: NumLike): boolean {
+export function bigGreaterThanOrEqualTo(a: NumLike, b: NumLike): boolean {
   return big(a).isGreaterThanOrEqualTo(big(b));
 }
 
 /**
  * 判断 a 是否小于 b。
  * @example
- * bigLt(1, 2); // => true
- * bigLt(2, 1); // => false
+ * bigLessThan(1, 2); // => true
+ * bigLessThan(2, 1); // => false
  */
-export function bigLt(a: NumLike, b: NumLike): boolean {
+export function bigLessThan(a: NumLike, b: NumLike): boolean {
   return big(a).isLessThan(big(b));
 }
 
 /**
  * 判断 a 是否小于等于 b。
  * @example
- * bigLte(2, 2); // => true
- * bigLte(1, 2); // => true
- * bigLte(2, 1); // => false
+ * bigLessThanOrEqual(2, 2); // => true
+ * bigLessThanOrEqual(1, 2); // => true
+ * bigLessThanOrEqual(2, 1); // => false
  */
-export function bigLte(a: NumLike, b: NumLike): boolean {
+export function bigLessThanOrEqual(a: NumLike, b: NumLike): boolean {
   return big(a).isLessThanOrEqualTo(big(b));
 }
 

package/src/ts/string/other.ts

@@ -1,33 +1,45 @@
 /**
- * 计算字符串在 UTF-8 编码下的字节长度。
- * 使用场景：
- * 1) 按字节限制表单输入（避免超过后端/数据库字段上限）
- * 2) 评估网络传输、缓存（Redis/消息队列）开销
- * 3) 根据字节数截断或提示用户（而非按字符数）
- * @param str 输入的字符串
- * @returns 字符串的字节长度
+ * 获取字节长度 (支持字符串、Buffer/Uint8Array、File/Blob 等类型)
+ * - 字符串按 UTF-8 编码计算字节长度（每个字符 1-4 字节）
+ * - Buffer/Uint8Array 直接返回字节长度（每个元素 1 字节）
+ * - File/Blob 返回文件/Blob 大小（字节数）
+ * @param data 输入的数据
+ * @returns 数据的字节长度
  * @example
- * getStringByteLength('abc') // 3
- * getStringByteLength('中文') // 6
- * getStringByteLength('😊') // 4
+ * getByteLength('abc') // 3
+ * getByteLength('中文') // 6
+ * getByteLength('😊') // 4
+ * getByteLength(new Uint8Array([0x41, 0x42, 0x43])) // 3
+ * getByteLength(new File(['abc'], 'test.txt')) // 3
+ * getByteLength(new Blob(['中文'], { type: 'text/plain' })) // 6
  */
-export function getStringByteLength(str: string): number {
-  let byteLen = 0;
+export function getByteLength(data: string | ArrayBuffer | ArrayBufferView | File | Blob): number {
+  if (typeof data === 'string') {
+    let byteLen = 0;
 
-  for (let i = 0; i < str.length; i++) {
-    const code = str.charCodeAt(i);
+    for (let i = 0; i < data.length; i++) {
+      const code = data.charCodeAt(i);
 
-    if (code <= 0x7f) {
-      byteLen += 1; // （ASCII 基本拉丁）→ 包含数字 0-9、英文字母 A-Z/a-z、常见符号
-    } else if (code <= 0x7ff) {
-      byteLen += 2; // （拉丁扩展）→ 包含拉丁字母（含变音符）、希腊文、俄文/西里尔文、希伯来文、阿拉伯文等
-    } else if (code >= 0xd800 && code <= 0xdbff) {
-      byteLen += 4; // （UTF-16 代理项）→ 包含 emoji、稀有汉字（扩展区）、音乐符号等
-      i++;
-    } else {
-      byteLen += 3; // （BMP 绝大部分）→ 包含中文/日文/韩文的大多数字符（CJK 统一汉字）、以及大量其它脚本
+      if (code <= 0x7f) {
+        byteLen += 1; // （ASCII 基本拉丁）→ 包含数字 0-9、英文字母 A-Z/a-z、常见符号
+      } else if (code <= 0x7ff) {
+        byteLen += 2; // （拉丁扩展）→ 包含拉丁字母（含变音符）、希腊文、俄文/西里尔文、希伯来文、阿拉伯文等
+      } else if (code >= 0xd800 && code <= 0xdbff) {
+        byteLen += 4; // （UTF-16 代理项）→ 包含 emoji、稀有汉字（扩展区）、音乐符号等
+        i++;
+      } else {
+        byteLen += 3; // （BMP 绝大部分）→ 包含中文/日文/韩文的大多数字符（CJK 统一汉字）、以及大量其它脚本
+      }
     }
+
+    return byteLen;
   }
 
-  return byteLen;
+  // Buffer/Uint8Array
+  if ('byteLength' in data) return data.byteLength;
+
+  // File/Blob
+  if ('size' in data) return data.size;
+
+  throw new TypeError('getByteLength: Unsupported type');
 }