a2bei4-utils 1.0.0

package/types/download.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 通过动态创建 `<a>` 标签触发浏览器下载。
+ *
+ * @param {string} url - 任意可下载地址（同源或允许跨域）
+ * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳
+ */
+declare function downloadByUrl(url: string, fileName?: string): void;
+/**
+ * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。
+ *
+ * @param {Blob} blob - 待下载的 Blob（含 File）
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+declare function downloadByBlob(blob: Blob, fileName?: string): void;
+/**
+ * 将任意数据包装成 Blob 并下载。
+ *
+ * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据
+ * @param {string} [fileName] - 保存到本地的文件名
+ * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`
+ */
+declare function downloadByData(data: string | ArrayBufferView | ArrayBuffer | Blob, fileName?: string, mimeType?: string): void;
+/**
+ * 快捷下载 Excel 文件（MIME 已固定）。
+ *
+ * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+declare function downloadExcel(data: string | ArrayBufferView | ArrayBuffer | Blob, fileName?: string): void;
+/**
+ * 快捷下载 JSON 文件（MIME 已固定）。
+ * 若传入非字符串数据，会自行 `JSON.stringify`。
+ *
+ * @param {any} data - 要序列化的 JSON 数据
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+declare function downloadJSON(data: any, fileName?: string): void;
+
+export { downloadByBlob, downloadByData, downloadByUrl, downloadExcel, downloadJSON };

package/types/evt.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 简单、高性能的通用事件总线。
+ * - 支持命名空间事件
+ * - 支持一次性监听器
+ * - 返回唯一 flag，用于精确卸载
+ * - emit 时可选自定义 this 指向
+ */
+declare class MyEvent {
+    evtPool: Map<any, any>;
+    /**
+     * 注册事件监听器。
+     * @param {string} name - 事件名
+     * @param {Function} fn - 回调函数
+     * @returns {string} flag - 唯一标识，用于 off
+     */
+    on(name: string, fn: Function): string;
+    /**
+     * 注册一次性监听器，触发后自动移除。
+     * @param {string} name - 事件名
+     * @param {Function} fn - 回调函数
+     * @returns {string} flag - 唯一标识
+     */
+    once(name: string, fn: Function): string;
+    /**
+     * 移除指定事件监听器。
+     * @param {string} name - 事件名
+     * @param {Function|string} fnOrFlag - 回调函数或 flag
+     */
+    off(name: string, fnOrFlag: Function | string): void;
+    /**
+     * 触发事件（同步执行）。
+     * @param {string} name - 事件名
+     * @param {*} [data] - 任意载荷
+     * @param {*} [fnThis] - 回调内部 this 指向，默认 undefined
+     */
+    emit(name: string, data?: any, fnThis?: any): void;
+}
+declare namespace MyEvent_CrossPagePlugin {
+    /**
+     * 为指定 MyEvent 实例安装跨页插件。
+     * @param {MyEvent} bus - 事件总线实例
+     * @param {Options} [opts] - 配置项
+     */
+    function install(bus: MyEvent, opts?: Options): void;
+    /**
+     * 卸载插件，恢复原始 emit 并停止监听。
+     * @param {MyEvent} bus - 事件总线实例
+     */
+    function uninstall(bus: MyEvent): void;
+}
+
+export { MyEvent, MyEvent_CrossPagePlugin };

package/types/id.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 生成 RFC4122 版本 4 的 GUID/UUID。
+ * 收集来源：《基于mvc的javascript web富应用开发》 书中介绍是Robert Kieffer写的，还留了网址 http://goo.gl/0b0hu ，但实际访问不了。
+ * 格式：`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`
+ *
+ * @returns {string} 36 位大写 GUID
+ *
+ * @example
+ * // A2E0F340-6C3B-4D7F-B8C1-1E4F6A8B9C0D
+ * console.log(getGUID())
+ */
+declare function getGUID(): string;
+/**
+ * 分布式短 ID 生成器。
+ * 格式：`${timestamp}${flag}${serial}`，其中：
+ * - timestamp：毫秒级时间戳
+ * - flag：客户端标识串（自定义）
+ * - serial：同一毫秒内的序号，左补零到固定长度
+ */
+declare class MyId {
+    /**
+     * @param {object} [option]
+     * @param {string} [option.flag] - 客户端标识，默认空串
+     * @param {number} [option.len=5] - 序号位长度（位数），安全范围 ≥0
+     */
+    constructor(option?: {
+        flag?: string | undefined;
+        len?: number | undefined;
+    });
+    /**
+     * 生成下一个全局唯一字符串 ID。
+     * 同一毫秒序号自动递增；序号溢出时会在控制台警告。
+     * @returns {string}
+     */
+    nextId(): string;
+    #private;
+}
+
+export { MyId, getGUID };