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

package/src/ts/number/big.ts

@@ -14,18 +14,18 @@ export type NumLike = string | number | BigNumber;
  * big('0.1'); // => BigNumber
  * big(0.2);   // => BigNumber
  */
-export function big(x: NumLike): BigNumber {
+function big(x: NumLike): BigNumber {
   return x instanceof BigNumber ? x : new BigNumber(x);
 }
 
 /**
  * 高精度加法（支持多个参数连加）。
  * @example
- * bigPlus(0.1, 0.2); // => 0.3
- * bigPlus('0.1', '0.2'); // => 0.3
- * bigPlus(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
+ * mathPlus(0.1, 0.2); // => 0.3
+ * mathPlus('0.1', '0.2'); // => 0.3
+ * mathPlus(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
  */
-export function bigPlus(...rest: NumLike[]) {
+export function mathPlus(...rest: NumLike[]) {
   let acc = big(rest[0]);
   for (const x of rest.slice(1)) acc = acc.plus(big(x));
   return acc.toNumber();
@@ -34,11 +34,11 @@ export function bigPlus(...rest: NumLike[]) {
 /**
  * 高精度减法（支持多个参数连减）。
  * @example
- * bigMinus(1, 0.9); // => 0.1
- * bigMinus('1.1', '0.2'); // => 0.9
- * bigMinus(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
+ * mathMinus(1, 0.9); // => 0.1
+ * mathMinus('1.1', '0.2'); // => 0.9
+ * mathMinus(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
  */
-export function bigMinus(...rest: NumLike[]) {
+export function mathMinus(...rest: NumLike[]) {
   let acc = big(rest[0]);
   for (const x of rest.slice(1)) acc = acc.minus(big(x));
   return acc.toNumber();
@@ -47,11 +47,11 @@ export function bigMinus(...rest: NumLike[]) {
 /**
  * 高精度乘法（支持多个参数连乘）。
  * @example
- * bigTimes(0.1, 0.2); // => 0.02
- * bigTimes('1.5', '3'); // => 4.5
- * bigTimes(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
+ * mathTimes(0.1, 0.2); // => 0.02
+ * mathTimes('1.5', '3'); // => 4.5
+ * mathTimes(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
  */
-export function bigTimes(...rest: NumLike[]) {
+export function mathTimes(...rest: NumLike[]) {
   let acc = big(rest[0]);
   for (const x of rest.slice(1)) acc = acc.times(big(x));
   return acc.toNumber();
@@ -60,11 +60,11 @@ export function bigTimes(...rest: NumLike[]) {
 /**
  * 高精度除法（支持多个参数连除）。
  * @example
- * bigDiv(1, 3); // => 0.333333...
- * bigDiv('10', '4'); // => 2.5
- * bigDiv(100, 5, 2); // => 10  // 多参数连除: 100/5/2
+ * mathDiv(1, 3); // => 0.333333...
+ * mathDiv('10', '4'); // => 2.5
+ * mathDiv(100, 5, 2); // => 10  // 多参数连除: 100/5/2
  */
-export function bigDiv(...rest: NumLike[]) {
+export function mathDiv(...rest: NumLike[]) {
   let acc = big(rest[0]);
   for (const x of rest.slice(1)) acc = acc.div(big(x));
   return acc.toNumber();
@@ -76,10 +76,10 @@ export function bigDiv(...rest: NumLike[]) {
  * @param y 指数。
  * @returns 计算结果。
  * @example
- * bigPow(2, 3); // => 8
- * bigPow('2.5', 2); // => 6.25
+ * mathPow(2, 3); // => 8
+ * mathPow('2.5', 2); // => 6.25
  */
-export function bigPow(x: NumLike, y: NumLike) {
+export function mathPow(x: NumLike, y: NumLike) {
   return big(x).pow(big(y)).toNumber();
 }
 
@@ -90,12 +90,16 @@ export function bigPow(x: NumLike, y: NumLike) {
  * @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
+ * mathRound(1.6); // => 2
+ * mathRound('1.234', 2); // => 1.23
+ * mathRound('1.235', 2); // => 1.24
+ * mathRound('1.299', 2, BigNumber.ROUND_DOWN); // => 1.29
  */
-export function bigRound(x: NumLike, dp = 0, rm: BigNumber.RoundingMode = BigNumber.ROUND_HALF_UP) {
+export function mathRound(
+  x: NumLike,
+  dp = 0,
+  rm: BigNumber.RoundingMode = BigNumber.ROUND_HALF_UP,
+) {
   return big(x).decimalPlaces(dp, rm).toNumber();
 }
 
@@ -106,13 +110,13 @@ export function bigRound(x: NumLike, dp = 0, rm: BigNumber.RoundingMode = BigNum
  * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
  * @returns 格式化后的字符串。
  * @example
- * 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'
+ * mathFixed('1'); // => '1.00'
+ * +mathFixed('1'); // => 1
+ * mathFixed(1.2345); // => '1.23'
+ * mathFixed(1.2345, 3); // => '1.235'
+ * mathFixed('1.2345', 0, BigNumber.ROUND_UP); // => '2'
  */
-export function bigFixed(
+export function mathFixed(
   x: NumLike,
   dp = 2,
   rm: BigNumber.RoundingMode = BigNumber.ROUND_HALF_UP,
@@ -123,62 +127,62 @@ export function bigFixed(
 /**
  * 比较两个数值大小。
  * @example
- * bigCompare('2', '10'); // => -1
- * bigCompare(3, 3);      // => 0
- * bigCompare('10', 2);   // => 1
+ * mathCompare('2', '10'); // => -1
+ * mathCompare(3, 3);      // => 0
+ * mathCompare('10', 2);   // => 1
  */
-export function bigCompare(a: NumLike, b: NumLike): -1 | 0 | 1 | null {
+export function mathCompare(a: NumLike, b: NumLike): -1 | 0 | 1 | null {
   return big(a).comparedTo(big(b));
 }
 
 /**
  * 判断两个数值是否相等。
  * @example
- * bigEqual('1.0', 1); // => true
- * bigEqual(2, 1); // => false
+ * mathEqual('1.0', 1); // => true
+ * mathEqual(2, 1); // => false
  */
-export function bigEqual(a: NumLike, b: NumLike): boolean {
+export function mathEqual(a: NumLike, b: NumLike): boolean {
   return big(a).isEqualTo(big(b));
 }
 
 /**
  * 判断 a 是否大于 b。
  * @example
- * bigGreaterThan(2, 1); // => true
- * bigGreaterThan(1, 2); // => false
+ * mathGreaterThan(2, 1); // => true
+ * mathGreaterThan(1, 2); // => false
  */
-export function bigGreaterThan(a: NumLike, b: NumLike): boolean {
+export function mathGreaterThan(a: NumLike, b: NumLike): boolean {
   return big(a).isGreaterThan(big(b));
 }
 
 /**
  * 判断 a 是否大于等于 b。
  * @example
- * bigGreaterThanOrEqual(2, 2); // => true
- * bigGreaterThanOrEqual(1, 2); // => false
+ * mathGreaterThanOrEqual(2, 2); // => true
+ * mathGreaterThanOrEqual(1, 2); // => false
  */
-export function bigGreaterThanOrEqualTo(a: NumLike, b: NumLike): boolean {
+export function mathGreaterThanOrEqual(a: NumLike, b: NumLike): boolean {
   return big(a).isGreaterThanOrEqualTo(big(b));
 }
 
 /**
  * 判断 a 是否小于 b。
  * @example
- * bigLessThan(1, 2); // => true
- * bigLessThan(2, 1); // => false
+ * mathLessThan(1, 2); // => true
+ * mathLessThan(2, 1); // => false
  */
-export function bigLessThan(a: NumLike, b: NumLike): boolean {
+export function mathLessThan(a: NumLike, b: NumLike): boolean {
   return big(a).isLessThan(big(b));
 }
 
 /**
  * 判断 a 是否小于等于 b。
  * @example
- * bigLessThanOrEqual(2, 2); // => true
- * bigLessThanOrEqual(1, 2); // => true
- * bigLessThanOrEqual(2, 1); // => false
+ * mathLessThanOrEqual(2, 2); // => true
+ * mathLessThanOrEqual(1, 2); // => true
+ * mathLessThanOrEqual(2, 1); // => false
  */
-export function bigLessThanOrEqual(a: NumLike, b: NumLike): boolean {
+export function mathLessThanOrEqual(a: NumLike, b: NumLike): boolean {
   return big(a).isLessThanOrEqualTo(big(b));
 }
 

package/src/ts/number/random.ts

@@ -1,59 +1,3 @@
-/**
- * 随机生成 `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 function randomInt(a: number, b: number): number {
-  if (!Number.isFinite(a) || !Number.isFinite(b)) {
-    throw new TypeError('min 和 max 必须是有限数值');
-  }
-
-  const low = Math.min(a, b);
-  const high = Math.max(a, b);
-
-  const minInt = Math.ceil(low);
-  const maxInt = Math.floor(high);
-
-  if (maxInt < minInt) {
-    throw new RangeError('取整后区间为空');
-  }
-
-  if (maxInt === minInt) return minInt;
-
-  return Math.floor(Math.random() * (maxInt - minInt + 1)) + minInt;
-}
-
-/**
- * 随机生成 `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 function randomFloat(a: number, b: number): number {
-  if (!Number.isFinite(a) || !Number.isFinite(b)) {
-    throw new TypeError('min 和 max 必须是有限数值');
-  }
-
-  const low = Math.min(a, b);
-  const high = Math.max(a, b);
-
-  if (high === low) return low;
-
-  return Math.random() * (high - low) + low;
-}
-
 /**
  * 随机生成一个布尔值。
  * @returns 随机布尔值。

package/src/ts/object/index.ts

@@ -1,6 +1,8 @@
+import { get, set } from 'es-toolkit/compat';
+
 /**
  * 获取对象键名数组（类型安全）。
- * 注：内置 `Object.keys` 与 `lodash-es` 的 `keys` 在 TS 中通常返回 `string[]`，无法精确到 `keyof T`。
+ * 注：内置 `Object.keys` 与 `es-toolkit` 的 `keys` 在 TS 中通常返回 `string[]`，无法精确到 `keyof T`。
  * @param obj 目标对象
  * @returns 类型精确的 `Array<keyof T>`
  * @example
@@ -10,3 +12,28 @@
 export function getObjectKeys<T extends object>(obj: T): Array<keyof T> {
   return Object.keys(obj) as (keyof T)[];
 }
+
+/**
+ * 获取对象值。
+ * @param obj 目标对象
+ * @param path 路径。(点路径：'a.b'、'a[0].b'；数组路径：['a',0,'b'])
+ * @returns 值
+ * @example
+ * const o = { b: { c: 'x' }, users: [{ name: 'john' }, { name: 'jane' }] };
+ * const c = getObjectValue(o, 'b.c'); // 点路径: 'x'
+ * const name0 = getObjectValue(o, 'users[0].name'); // 数组字符: 'john'
+ * const name1 = getObjectValue(o, ['users', 1, 'name']); // 数组路径: 'jane'
+ */
+export const getObjectValue = get;
+
+/**
+ * 设置对象值。
+ * @param obj 目标对象
+ * @param path 路径。(点路径：'a.b'、'a[0].b'；数组路径：['a',0,'b'])
+ * @param value 值
+ * @example
+ * const o = { b: { c: 'x' }, users: [{ name: 'john' }, { name: 'jane' }] };
+ * setObjectValue(o, 'b.c', 'y'); // 点路径
+ * setObjectValue(o, ['users', 1, 'name'], 'jane-doe'); // 数组路径
+ */
+export const setObjectValue = set;

package/src/ts/string/random.ts

@@ -36,7 +36,7 @@ export function createRandId(prefix = 'id_') {
 export function createTimeRandId(digits: number = 6) {
   const base = 10 ** (digits - 1);
   const range = 9 * base;
-  const randomInt = Math.floor(Math.random() * range) + base;
+  const int = Math.floor(Math.random() * range) + base;
 
-  return `${Date.now()}${randomInt}`;
+  return `${Date.now()}${int}`;
 }

package/src/ts/url/param/index.ts

@@ -1,94 +1,3 @@
-/**
- * 获取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
- */
-export function getUrlParam(key: string, url: string) {
-  const raw = url.includes('?') ? url.slice(url.indexOf('?') + 1) : url.includes('=') ? url : '';
-  const qs = raw.split('#')[0];
-  if (!qs) return null;
-  const pairs = qs.split('&').filter(Boolean);
-  const decode = (s: string) => {
-    try {
-      return decodeURIComponent(s.replace(/\+/g, ' '));
-    } catch {
-      return s;
-    }
-  };
-  for (const pair of pairs) {
-    const i = pair.indexOf('=');
-    const k = i >= 0 ? pair.slice(0, i) : pair;
-    if (decode(k) === key) {
-      const v = i >= 0 ? decode(pair.slice(i + 1)) : '';
-      return v !== 'null' && v !== 'undefined' ? v : null;
-    }
-  }
-  return 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
- */
-export function getUrlNumber(key: string, url: string) {
-  const str = getUrlParam(key, url);
-  if (!str) return null;
-
-  const num = Number(str);
-  return isNaN(num) ? null : num;
-}
-
-/**
- * 获取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" }
- */
-export function getUrlParamAll(url: string) {
-  const raw = url.includes('?') ? url.slice(url.indexOf('?') + 1) : url.includes('=') ? url : '';
-  const qs = raw.split('#')[0];
-  const result: Record<string, string> = {};
-  if (!qs) return result;
-  const decode = (s: string) => {
-    try {
-      return decodeURIComponent(s.replace(/\+/g, ' '));
-    } catch {
-      return s;
-    }
-  };
-  for (const seg of qs.split('&')) {
-    if (!seg) continue;
-    const i = seg.indexOf('=');
-    const k = i >= 0 ? seg.slice(0, i) : seg;
-    const v = i >= 0 ? seg.slice(i + 1) : '';
-    const dv = decode(v);
-    if (dv !== 'null' && dv !== 'undefined') {
-      result[decode(k)] = dv;
-    }
-  }
-  return result;
-}
-
 /**
  * 将对象参数拼接到 URL
  * - 采用纯JS拼接，因为小程序不支持URLSearchParams

package/src/ts/validator/index.ts

@@ -393,31 +393,6 @@ export function isTaxID(code: string) {
   return v[17] === expected;
 }
 
-/**
- * 判断字符串是否为合法 JSON 文本。
- * 说明：传入字符串时尝试 `JSON.parse`；传入对象/数组则视为合法。
- * @param input 待判定的值或字符串
- * @returns 是否为合法 JSON
- * @example
- * isJSON('{"a":1}') // true
- * isJSON('[1,2]') // true
- * isJSON('abc') // false
- */
-export function isJSON(input: unknown) {
-  if (typeof input === 'string') {
-    const s = input.trim();
-    if (s === '') return false;
-    try {
-      JSON.parse(s);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-  if (input !== null && typeof input === 'object') return true;
-  return false;
-}
-
 /**
  * HEX 颜色值（支持 `#RGB`、`#RRGGBB`、`#RRGGBBAA`）。
  * @param s 颜色字符串

package/dist/lodash/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * 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

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

package/src/ts/lodash/index.ts

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