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

package/dist/bean/EventBus.d.ts

@@ -0,0 +1,37 @@
+import { type EventType } from 'mitt';
+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');
+ */
+export 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;
+}
+export {};
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/bean/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/ts/bean/EventBus.ts"],"names":[],"mappings":"AAAA,OAAa,EAAgB,KAAK,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1D,KAAK,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAElD,SAAS;IACT,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAK/D,WAAW;IACX,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IASjE,SAAS;IACT,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAKpD,SAAS;IACT,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAKjE,SAAS;IACT,KAAK,IAAI,IAAI;CAId"}

package/dist/bean/index.d.ts

@@ -0,0 +1,2 @@
+export { EventBus } from './EventBus';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/bean/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/day/index.d.ts

@@ -0,0 +1,100 @@
+import dayjs from 'dayjs';
+import 'dayjs/locale/zh-cn';
+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相差的年数
+ */
+export 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']
+ */
+export 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']
+ */
+export 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' }
+ */
+export 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岁）
+ */
+export declare function getAgeByBirthdate(birthdate: string): {
+    age: number;
+    type: string;
+};
+/**
+ * 对外抛出 dayjs 以便全局配置
+ * @example
+ * 切换语言
+ * dayjs.locale('en'); // 切换为英文
+ * dayjs.locale('zh-cn'); // 切换为中文 (默认)
+ */
+export { dayjs };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/day/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,OAAO,oBAAoB,CAAC;AAU5B,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,UAAU,eAmB3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAe,YASpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAe,YASnE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM;;;;;;EAgB7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM;;;EAqBlD;AAED;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/index.cjs

@@ -45,18 +45,19 @@ __export(index_exports, {
   attempt: () => attempt_default,
   before: () => before_default,
   big: () => big,
-  bigAdd: () => bigAdd,
   bigCompare: () => bigCompare,
   bigDiv: () => bigDiv,
   bigEqual: () => bigEqual,
-  bigGt: () => bigGt,
-  bigGte: () => bigGte,
-  bigLt: () => bigLt,
-  bigLte: () => bigLte,
-  bigMul: () => bigMul,
+  bigFixed: () => bigFixed,
+  bigGreaterThan: () => bigGreaterThan,
+  bigGreaterThanOrEqualTo: () => bigGreaterThanOrEqualTo,
+  bigLessThan: () => bigLessThan,
+  bigLessThanOrEqual: () => bigLessThanOrEqual,
+  bigMinus: () => bigMinus,
+  bigPlus: () => bigPlus,
   bigPow: () => bigPow,
   bigRound: () => bigRound,
-  bigSub: () => bigSub,
+  bigTimes: () => bigTimes,
   bind: () => bind_default,
   bindAll: () => bindAll_default,
   bindKey: () => bindKey_default,
@@ -370,7 +371,6 @@ __export(index_exports, {
   toChineseNum: () => toChineseNum,
   toDayjs: () => toDayjs,
   toFinite: () => toFinite_default,
-  toFixed: () => toFixed,
   toInteger: () => toInteger_default,
   toIterator: () => toIterator_default,
   toJSON: () => wrapperValue_default,
@@ -506,24 +506,24 @@ var import_bignumber = __toESM(require("bignumber.js"), 1);
 function big(x) {
   return x instanceof import_bignumber.default ? x : new import_bignumber.default(x);
 }
-function bigAdd(a, ...rest2) {
-  let acc = big(a);
-  for (const x of rest2) acc = acc.plus(big(x));
+function bigPlus(...rest2) {
+  let acc = big(rest2[0]);
+  for (const x of rest2.slice(1)) acc = acc.plus(big(x));
   return acc.toNumber();
 }
-function bigSub(a, ...rest2) {
-  let acc = big(a);
-  for (const x of rest2) acc = acc.minus(big(x));
+function bigMinus(...rest2) {
+  let acc = big(rest2[0]);
+  for (const x of rest2.slice(1)) acc = acc.minus(big(x));
   return acc.toNumber();
 }
-function bigMul(a, ...rest2) {
-  let acc = big(a);
-  for (const x of rest2) acc = acc.times(big(x));
+function bigTimes(...rest2) {
+  let acc = big(rest2[0]);
+  for (const x of rest2.slice(1)) acc = acc.times(big(x));
   return acc.toNumber();
 }
-function bigDiv(a, ...rest2) {
-  let acc = big(a);
-  for (const x of rest2) acc = acc.div(big(x));
+function bigDiv(...rest2) {
+  let acc = big(rest2[0]);
+  for (const x of rest2.slice(1)) acc = acc.div(big(x));
   return acc.toNumber();
 }
 function bigPow(x, y) {
@@ -532,7 +532,7 @@ function bigPow(x, y) {
 function bigRound(x, dp = 0, rm = import_bignumber.default.ROUND_HALF_UP) {
   return big(x).decimalPlaces(dp, rm).toNumber();
 }
-function toFixed(x, dp = 2, rm = import_bignumber.default.ROUND_HALF_UP) {
+function bigFixed(x, dp = 2, rm = import_bignumber.default.ROUND_HALF_UP) {
   return big(x).toFixed(dp, rm);
 }
 function bigCompare(a, b) {
@@ -541,16 +541,16 @@ function bigCompare(a, b) {
 function bigEqual(a, b) {
   return big(a).isEqualTo(big(b));
 }
-function bigGt(a, b) {
+function bigGreaterThan(a, b) {
   return big(a).isGreaterThan(big(b));
 }
-function bigGte(a, b) {
+function bigGreaterThanOrEqualTo(a, b) {
   return big(a).isGreaterThanOrEqualTo(big(b));
 }
-function bigLt(a, b) {
+function bigLessThan(a, b) {
   return big(a).isLessThan(big(b));
 }
-function bigLte(a, b) {
+function bigLessThanOrEqual(a, b) {
   return big(a).isLessThanOrEqualTo(big(b));
 }
 
@@ -8581,18 +8581,19 @@ function isLongitude(s) {
   attempt,
   before,
   big,
-  bigAdd,
   bigCompare,
   bigDiv,
   bigEqual,
-  bigGt,
-  bigGte,
-  bigLt,
-  bigLte,
-  bigMul,
+  bigFixed,
+  bigGreaterThan,
+  bigGreaterThanOrEqualTo,
+  bigLessThan,
+  bigLessThanOrEqual,
+  bigMinus,
+  bigPlus,
   bigPow,
   bigRound,
-  bigSub,
+  bigTimes,
   bind,
   bindAll,
   bindKey,
@@ -8906,7 +8907,6 @@ function isLongitude(s) {
   toChineseNum,
   toDayjs,
   toFinite,
-  toFixed,
   toInteger,
   toIterator,
   toJSON,