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

package/dist/array/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 拖拽排序 (不改变原数组)
+ * @param list 原始数组
+ * @param fromIndex 要移动的元素的原始索引
+ * @param toIndex 要移动到的目标索引
+ * @returns 移动元素后的新数组
+ */
+export declare function arrayMove<T>(list: T[], fromIndex: number, toIndex: number): T[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/array/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAKzE"}

package/dist/async/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 将 Promise 包装为 [data, error] 形式, 减少 try-catch 代码量
+ * @param p 要包装的 Promise
+ * @returns 一个 Promise，其结果为 [data, error] 形式
+ * @example
+ * const [data, err] = await toAsync(fetch('https://api.example.com/data'));
+ * if (err) {
+ *   console.error(err);
+ *   return;
+ * }
+ * console.log(data);
+ */
+export declare function toAsync<T>(p: Promise<T>): Promise<[T | null, unknown]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/async/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAO5E"}

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,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,UAAU,eAmB1D;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"}