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

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,6 @@
 /**
  * 获取对象键名数组（类型安全）。
- * 注：内置 `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

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';