a2bei4-utils 1.0.0

package/dist/evt.js

@@ -0,0 +1,152 @@
+/**
+ * 简单、高性能的通用事件总线。
+ * - 支持命名空间事件
+ * - 支持一次性监听器
+ * - 返回唯一 flag，用于精确卸载
+ * - emit 时可选自定义 this 指向
+ */
+class MyEvent {
+    constructor() {
+        this.evtPool = new Map();
+    }
+
+    /**
+     * 注册事件监听器。
+     * @param {string} name - 事件名
+     * @param {Function} fn - 回调函数
+     * @returns {string} flag - 唯一标识，用于 off
+     */
+    on(name, fn) {
+        let flag = Date.now() + "_" + parseInt(Math.random() * 1e8);
+        const evtItem = {
+            flag,
+            fn
+        };
+        if (this.evtPool.has(name)) {
+            this.evtPool.get(name).push(evtItem);
+        } else {
+            this.evtPool.set(name, [evtItem]);
+        }
+        return flag;
+    }
+
+    /**
+     * 注册一次性监听器，触发后自动移除。
+     * @param {string} name - 事件名
+     * @param {Function} fn - 回调函数
+     * @returns {string} flag - 唯一标识
+     */
+    once(name, fn) {
+        const _this = this;
+        let wrapper;
+        wrapper = function (data) {
+            _this.off(name, wrapper);
+            fn.call(this, data);
+        };
+        return this.on(name, wrapper);
+    }
+
+    /**
+     * 移除指定事件监听器。
+     * @param {string} name - 事件名
+     * @param {Function|string} fnOrFlag - 回调函数或 flag
+     */
+    off(name, fnOrFlag) {
+        if (!this.evtPool.has(name)) return;
+        const evtItems = this.evtPool.get(name);
+        const filtered = evtItems.filter((item) => item.fn !== fnOrFlag && item.flag !== fnOrFlag);
+        if (filtered.length === 0) {
+            this.evtPool.delete(name);
+        } else {
+            this.evtPool.set(name, filtered);
+        }
+    }
+
+    /**
+     * 触发事件（同步执行）。
+     * @param {string} name - 事件名
+     * @param {*} [data] - 任意载荷
+     * @param {*} [fnThis] - 回调内部 this 指向，默认 undefined
+     */
+    emit(name, data, fnThis) {
+        if (!this.evtPool.has(name)) return;
+        const evtItems = this.evtPool.get(name);
+        evtItems.forEach((item) => {
+            try {
+                item.fn.call(fnThis, data);
+            } catch (err) {
+                console.error(`Error in event listener for "${name}":`, err);
+            }
+        });
+    }
+}
+
+/**
+ * 跨页通信插件：通过 localStorage + storage 事件将当前实例的 emit 广播到其他同源页面。
+ * 支持节流、命名空间隔离。
+ */
+const MyEvent_CrossPagePlugin = (() => {
+    const INSTALLED = new WeakSet(); // 防止重复安装
+
+    return {
+        /**
+         * 为指定 MyEvent 实例安装跨页插件。
+         * @param {MyEvent} bus - 事件总线实例
+         * @param {Options} [opts] - 配置项
+         */
+        install(bus, opts = {}) {
+            if (INSTALLED.has(bus)) return;
+            INSTALLED.add(bus);
+
+            const ns = `___my-event-cross-page-${opts.namespace || "default"}___`;
+            const delay = opts.throttle || 16;
+            let last = 0;
+
+            //  1、重写 emit
+            const rawEmit = bus.emit;
+            bus.emit = function (name, data, fnThis) {
+                rawEmit.call(bus, name, data, fnThis); // 本地先执行
+                const now = Date.now();
+                if (now - last < delay) return;
+                last = now;
+                const key = ns + name;
+                try {
+                    localStorage.setItem(key, JSON.stringify({ name, data, ts: now }));
+                    localStorage.removeItem(key); // 触发 storage 事件
+                } catch (e) {}
+            };
+
+            //  2、监听其他页广播
+            function onStorageHandler(e) {
+                if (!e.key || !e.key.startsWith(ns)) return;
+                let payload;
+                try {
+                    payload = JSON.parse(e.newValue || "{}");
+                } catch {
+                    return;
+                }
+                if (!payload.ts || payload.ts <= last) return;
+                rawEmit.call(bus, e.key.slice(ns.length), payload.data); // 仅本地
+            }
+            addEventListener("storage", onStorageHandler);
+
+            //  3、保存卸载器
+            bus._uninstallCrossPage = () => {
+                removeEventListener("storage", onStorageHandler);
+                bus.emit = rawEmit;
+                INSTALLED.delete(bus);
+            };
+        },
+
+        /**
+         * 卸载插件，恢复原始 emit 并停止监听。
+         * @param {MyEvent} bus - 事件总线实例
+         */
+        uninstall(bus) {
+            if (typeof bus._uninstallCrossPage === "function") bus._uninstallCrossPage();
+        }
+    };
+})();
+
+export { MyEvent, MyEvent_CrossPagePlugin };
+//# sourceMappingURL=evt.js.map

package/dist/evt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evt.js","sources":["../src/source/evt.js"],"sourcesContent":["/**\r\n * 简单、高性能的通用事件总线。\r\n * - 支持命名空间事件\r\n * - 支持一次性监听器\r\n * - 返回唯一 flag，用于精确卸载\r\n * - emit 时可选自定义 this 指向\r\n */\r\nexport class MyEvent {\r\n    constructor() {\r\n        this.evtPool = new Map();\r\n    }\r\n\r\n    /**\r\n     * 注册事件监听器。\r\n     * @param {string} name - 事件名\r\n     * @param {Function} fn - 回调函数\r\n     * @returns {string} flag - 唯一标识，用于 off\r\n     */\r\n    on(name, fn) {\r\n        let flag = Date.now() + \"_\" + parseInt(Math.random() * 1e8);\r\n        const evtItem = {\r\n            flag,\r\n            fn\r\n        };\r\n        if (this.evtPool.has(name)) {\r\n            this.evtPool.get(name).push(evtItem);\r\n        } else {\r\n            this.evtPool.set(name, [evtItem]);\r\n        }\r\n        return flag;\r\n    }\r\n\r\n    /**\r\n     * 注册一次性监听器，触发后自动移除。\r\n     * @param {string} name - 事件名\r\n     * @param {Function} fn - 回调函数\r\n     * @returns {string} flag - 唯一标识\r\n     */\r\n    once(name, fn) {\r\n        const _this = this;\r\n        let wrapper;\r\n        wrapper = function (data) {\r\n            _this.off(name, wrapper);\r\n            fn.call(this, data);\r\n        };\r\n        return this.on(name, wrapper);\r\n    }\r\n\r\n    /**\r\n     * 移除指定事件监听器。\r\n     * @param {string} name - 事件名\r\n     * @param {Function|string} fnOrFlag - 回调函数或 flag\r\n     */\r\n    off(name, fnOrFlag) {\r\n        if (!this.evtPool.has(name)) return;\r\n        const evtItems = this.evtPool.get(name);\r\n        const filtered = evtItems.filter((item) => item.fn !== fnOrFlag && item.flag !== fnOrFlag);\r\n        if (filtered.length === 0) {\r\n            this.evtPool.delete(name);\r\n        } else {\r\n            this.evtPool.set(name, filtered);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * 触发事件（同步执行）。\r\n     * @param {string} name - 事件名\r\n     * @param {*} [data] - 任意载荷\r\n     * @param {*} [fnThis] - 回调内部 this 指向，默认 undefined\r\n     */\r\n    emit(name, data, fnThis) {\r\n        if (!this.evtPool.has(name)) return;\r\n        const evtItems = this.evtPool.get(name);\r\n        evtItems.forEach((item) => {\r\n            try {\r\n                item.fn.call(fnThis, data);\r\n            } catch (err) {\r\n                console.error(`Error in event listener for \"${name}\":`, err);\r\n            }\r\n        });\r\n    }\r\n}\r\n\r\n/**\r\n * 跨页通信插件：通过 localStorage + storage 事件将当前实例的 emit 广播到其他同源页面。\r\n * 支持节流、命名空间隔离。\r\n */\r\nexport const MyEvent_CrossPagePlugin = (() => {\r\n    const INSTALLED = new WeakSet(); // 防止重复安装\r\n\r\n    return {\r\n        /**\r\n         * 为指定 MyEvent 实例安装跨页插件。\r\n         * @param {MyEvent} bus - 事件总线实例\r\n         * @param {Options} [opts] - 配置项\r\n         */\r\n        install(bus, opts = {}) {\r\n            if (INSTALLED.has(bus)) return;\r\n            INSTALLED.add(bus);\r\n\r\n            const ns = `___my-event-cross-page-${opts.namespace || \"default\"}___`;\r\n            const delay = opts.throttle || 16;\r\n            let last = 0;\r\n\r\n            //  1、重写 emit\r\n            const rawEmit = bus.emit;\r\n            bus.emit = function (name, data, fnThis) {\r\n                rawEmit.call(bus, name, data, fnThis); // 本地先执行\r\n                const now = Date.now();\r\n                if (now - last < delay) return;\r\n                last = now;\r\n                const key = ns + name;\r\n                try {\r\n                    localStorage.setItem(key, JSON.stringify({ name, data, ts: now }));\r\n                    localStorage.removeItem(key); // 触发 storage 事件\r\n                } catch (e) {}\r\n            };\r\n\r\n            //  2、监听其他页广播\r\n            function onStorageHandler(e) {\r\n                if (!e.key || !e.key.startsWith(ns)) return;\r\n                let payload;\r\n                try {\r\n                    payload = JSON.parse(e.newValue || \"{}\");\r\n                } catch {\r\n                    return;\r\n                }\r\n                if (!payload.ts || payload.ts <= last) return;\r\n                rawEmit.call(bus, e.key.slice(ns.length), payload.data); // 仅本地\r\n            }\r\n            addEventListener(\"storage\", onStorageHandler);\r\n\r\n            //  3、保存卸载器\r\n            bus._uninstallCrossPage = () => {\r\n                removeEventListener(\"storage\", onStorageHandler);\r\n                bus.emit = rawEmit;\r\n                INSTALLED.delete(bus);\r\n            };\r\n        },\r\n\r\n        /**\r\n         * 卸载插件，恢复原始 emit 并停止监听。\r\n         * @param {MyEvent} bus - 事件总线实例\r\n         */\r\n        uninstall(bus) {\r\n            if (typeof bus._uninstallCrossPage === \"function\") bus._uninstallCrossPage();\r\n        }\r\n    };\r\n})();\r\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,OAAO,CAAC;AACrB,IAAI,WAAW,GAAG;AAClB,QAAQ,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;AACjC,IAAI,CAAC;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE;AACjB,QAAQ,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;AACpE,QAAQ,MAAM,OAAO,GAAG;AACxB,YAAY,IAAI;AAChB,YAAY,EAAE;AACd,SAAS,CAAC;AACV,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;AACpC,YAAY,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACjD,QAAQ,CAAC,MAAM;AACf,YAAY,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9C,QAAQ,CAAC;AACT,QAAQ,OAAO,IAAI,CAAC;AACpB,IAAI,CAAC;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE;AACnB,QAAQ,MAAM,KAAK,GAAG,IAAI,CAAC;AAC3B,QAAQ,IAAI,OAAO,CAAC;AACpB,QAAQ,OAAO,GAAG,UAAU,IAAI,EAAE;AAClC,YAAY,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAChC,QAAQ,CAAC,CAAC;AACV,QAAQ,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACtC,IAAI,CAAC;AACL;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE;AACxB,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO;AAC5C,QAAQ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChD,QAAQ,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACnG,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;AACnC,YAAY,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACtC,QAAQ,CAAC,MAAM;AACf,YAAY,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7C,QAAQ,CAAC;AACT,IAAI,CAAC;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;AAC7B,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO;AAC5C,QAAQ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChD,QAAQ,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK;AACnC,YAAY,IAAI;AAChB,gBAAgB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC3C,YAAY,CAAC,CAAC,OAAO,GAAG,EAAE;AAC1B,gBAAgB,OAAO,CAAC,KAAK,CAAC,CAAC,6BAA6B,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7E,YAAY,CAAC;AACb,QAAQ,CAAC,CAAC,CAAC;AACX,IAAI,CAAC;AACL,CAAC;AACD;AACA;AACA;AACA;AACA;AACY,MAAC,uBAAuB,GAAG,CAAC,MAAM;AAC9C,IAAI,MAAM,SAAS,GAAG,IAAI,OAAO,EAAE,CAAC;AACpC;AACA,IAAI,OAAO;AACX;AACA;AACA;AACA;AACA;AACA,QAAQ,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE;AAChC,YAAY,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO;AAC3C,YAAY,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC/B;AACA,YAAY,MAAM,EAAE,GAAG,CAAC,uBAAuB,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;AAClF,YAAY,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;AAC9C,YAAY,IAAI,IAAI,GAAG,CAAC,CAAC;AACzB;AACA;AACA,YAAY,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;AACrC,YAAY,GAAG,CAAC,IAAI,GAAG,UAAU,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;AACrD,gBAAgB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACtD,gBAAgB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACvC,gBAAgB,IAAI,GAAG,GAAG,IAAI,GAAG,KAAK,EAAE,OAAO;AAC/C,gBAAgB,IAAI,GAAG,GAAG,CAAC;AAC3B,gBAAgB,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;AACtC,gBAAgB,IAAI;AACpB,oBAAoB,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AACvF,oBAAoB,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACjD,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC9B,YAAY,CAAC,CAAC;AACd;AACA;AACA,YAAY,SAAS,gBAAgB,CAAC,CAAC,EAAE;AACzC,gBAAgB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,OAAO;AAC5D,gBAAgB,IAAI,OAAO,CAAC;AAC5B,gBAAgB,IAAI;AACpB,oBAAoB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;AAC7D,gBAAgB,CAAC,CAAC,MAAM;AACxB,oBAAoB,OAAO;AAC3B,gBAAgB,CAAC;AACjB,gBAAgB,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,OAAO;AAC9D,gBAAgB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACxE,YAAY,CAAC;AACb,YAAY,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAC1D;AACA;AACA,YAAY,GAAG,CAAC,mBAAmB,GAAG,MAAM;AAC5C,gBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AACjE,gBAAgB,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;AACnC,gBAAgB,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACtC,YAAY,CAAC,CAAC;AACd,QAAQ,CAAC;AACT;AACA;AACA;AACA;AACA;AACA,QAAQ,SAAS,CAAC,GAAG,EAAE;AACvB,YAAY,IAAI,OAAO,GAAG,CAAC,mBAAmB,KAAK,UAAU,EAAE,GAAG,CAAC,mBAAmB,EAAE,CAAC;AACzF,QAAQ,CAAC;AACT,KAAK,CAAC;AACN,CAAC;;;;"}

package/dist/id.cjs

@@ -0,0 +1,75 @@
+'use strict';
+
+/**
+ * 生成 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())
+ */
+function getGUID() {
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        let r = (Math.random() * 16) | 0,
+            v = c == "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16).toUpperCase();
+    });
+}
+
+/**
+ * 分布式短 ID 生成器。
+ * 格式：`${timestamp}${flag}${serial}`，其中：
+ * - timestamp：毫秒级时间戳
+ * - flag：客户端标识串（自定义）
+ * - serial：同一毫秒内的序号，左补零到固定长度
+ */
+class MyId {
+    #ts = Date.now(); //	时间戳
+    #sn = 0; //	序号（保证同一客户端之间的唯一项）
+    #flag = ""; //	客户端标识（保证不同客户端之间的唯一项）
+    #len = 5; //	序号位长度（我的电脑测试，同一时间戳内可以for循环执行了1000次左右，没有一次超过3k，所以5位应该够用了）
+    //  测试代码
+    //  let obj = {[Date.now()]:[]}; try { for (let i = 0; i < 100000; i++) { obj[Date.now()].push(i); } } catch { console.log(obj[Object.getOwnPropertyNames(obj)[0]].length); }
+
+    /**
+     * @param {object} [option]
+     * @param {string} [option.flag] - 客户端标识，默认空串
+     * @param {number} [option.len=5] - 序号位长度（位数），安全范围 ≥0
+     */
+    constructor(option = {}) {
+        if (option) {
+            if (typeof option.flag === "string") {
+                this.#flag = option.flag;
+            }
+            if (Number.isSafeInteger(option.len) && len >= 0) {
+                this.#len = option.len;
+            }
+        }
+    }
+
+    /**
+     * 生成下一个全局唯一字符串 ID。
+     * 同一毫秒序号自动递增；序号溢出时会在控制台警告。
+     * @returns {string}
+     */
+    nextId() {
+        let ts = Date.now();
+        if (ts === this.#ts) {
+            this.#sn++;
+            if (this.#sn >= 10 ** this.#len) {
+                console.log("长度不够用了！！！");
+            }
+        } else {
+            this.#sn = 0;
+            this.#ts = ts;
+        }
+        return ts.toString() + this.#flag + this.#sn.toString().padStart(this.#len, "0");
+    }
+}
+
+exports.MyId = MyId;
+exports.getGUID = getGUID;
+//# sourceMappingURL=id.cjs.map

package/dist/id.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.cjs","sources":["../src/source/id.js"],"sourcesContent":["/**\r\n * 生成 RFC4122 版本 4 的 GUID/UUID。\r\n * 收集来源：《基于mvc的javascript web富应用开发》 书中介绍是Robert Kieffer写的，还留了网址 http://goo.gl/0b0hu ，但实际访问不了。\r\n * 格式：`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`\r\n *\r\n * @returns {string} 36 位大写 GUID\r\n *\r\n * @example\r\n * // A2E0F340-6C3B-4D7F-B8C1-1E4F6A8B9C0D\r\n * console.log(getGUID())\r\n */\r\nexport function getGUID() {\r\n    return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\r\n        let r = (Math.random() * 16) | 0,\r\n            v = c == \"x\" ? r : (r & 0x3) | 0x8;\r\n        return v.toString(16).toUpperCase();\r\n    });\r\n}\r\n\r\n/**\r\n * 分布式短 ID 生成器。\r\n * 格式：`${timestamp}${flag}${serial}`，其中：\r\n * - timestamp：毫秒级时间戳\r\n * - flag：客户端标识串（自定义）\r\n * - serial：同一毫秒内的序号，左补零到固定长度\r\n */\r\nexport class MyId {\r\n    #ts = Date.now(); //\t时间戳\r\n    #sn = 0; //\t序号（保证同一客户端之间的唯一项）\r\n    #flag = \"\"; //\t客户端标识（保证不同客户端之间的唯一项）\r\n    #len = 5; //\t序号位长度（我的电脑测试，同一时间戳内可以for循环执行了1000次左右，没有一次超过3k，所以5位应该够用了）\r\n    //  测试代码\r\n    //  let obj = {[Date.now()]:[]}; try { for (let i = 0; i < 100000; i++) { obj[Date.now()].push(i); } } catch { console.log(obj[Object.getOwnPropertyNames(obj)[0]].length); }\r\n\r\n    /**\r\n     * @param {object} [option]\r\n     * @param {string} [option.flag] - 客户端标识，默认空串\r\n     * @param {number} [option.len=5] - 序号位长度（位数），安全范围 ≥0\r\n     */\r\n    constructor(option = {}) {\r\n        if (option) {\r\n            if (typeof option.flag === \"string\") {\r\n                this.#flag = option.flag;\r\n            }\r\n            if (Number.isSafeInteger(option.len) && len >= 0) {\r\n                this.#len = option.len;\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * 生成下一个全局唯一字符串 ID。\r\n     * 同一毫秒序号自动递增；序号溢出时会在控制台警告。\r\n     * @returns {string}\r\n     */\r\n    nextId() {\r\n        let ts = Date.now();\r\n        if (ts === this.#ts) {\r\n            this.#sn++;\r\n            if (this.#sn >= 10 ** this.#len) {\r\n                console.log(\"长度不够用了！！！\");\r\n            }\r\n        } else {\r\n            this.#sn = 0;\r\n            this.#ts = ts;\r\n        }\r\n        return ts.toString() + this.#flag + this.#sn.toString().padStart(this.#len, \"0\");\r\n    }\r\n}\r\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,OAAO,GAAG;AAC1B,IAAI,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK;AAC1E,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;AACxC,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC;AAC/C,QAAQ,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5C,IAAI,CAAC,CAAC,CAAC;AACP,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,IAAI,CAAC;AAClB,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACrB,IAAI,GAAG,GAAG,CAAC,CAAC;AACZ,IAAI,KAAK,GAAG,EAAE,CAAC;AACf,IAAI,IAAI,GAAG,CAAC,CAAC;AACb;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE;AAC7B,QAAQ,IAAI,MAAM,EAAE;AACpB,YAAY,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE;AACjD,gBAAgB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;AACzC,YAAY,CAAC;AACb,YAAY,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE;AAC9D,gBAAgB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;AACvC,YAAY,CAAC;AACb,QAAQ,CAAC;AACT,IAAI,CAAC;AACL;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,GAAG;AACb,QAAQ,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC5B,QAAQ,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE;AAC7B,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC;AACvB,YAAY,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE;AAC7C,gBAAgB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACzC,YAAY,CAAC;AACb,QAAQ,CAAC,MAAM;AACf,YAAY,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;AACzB,YAAY,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;AAC1B,QAAQ,CAAC;AACT,QAAQ,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACzF,IAAI,CAAC;AACL;;;;;"}

package/dist/id.js

@@ -0,0 +1,72 @@
+/**
+ * 生成 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())
+ */
+function getGUID() {
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        let r = (Math.random() * 16) | 0,
+            v = c == "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16).toUpperCase();
+    });
+}
+
+/**
+ * 分布式短 ID 生成器。
+ * 格式：`${timestamp}${flag}${serial}`，其中：
+ * - timestamp：毫秒级时间戳
+ * - flag：客户端标识串（自定义）
+ * - serial：同一毫秒内的序号，左补零到固定长度
+ */
+class MyId {
+    #ts = Date.now(); //	时间戳
+    #sn = 0; //	序号（保证同一客户端之间的唯一项）
+    #flag = ""; //	客户端标识（保证不同客户端之间的唯一项）
+    #len = 5; //	序号位长度（我的电脑测试，同一时间戳内可以for循环执行了1000次左右，没有一次超过3k，所以5位应该够用了）
+    //  测试代码
+    //  let obj = {[Date.now()]:[]}; try { for (let i = 0; i < 100000; i++) { obj[Date.now()].push(i); } } catch { console.log(obj[Object.getOwnPropertyNames(obj)[0]].length); }
+
+    /**
+     * @param {object} [option]
+     * @param {string} [option.flag] - 客户端标识，默认空串
+     * @param {number} [option.len=5] - 序号位长度（位数），安全范围 ≥0
+     */
+    constructor(option = {}) {
+        if (option) {
+            if (typeof option.flag === "string") {
+                this.#flag = option.flag;
+            }
+            if (Number.isSafeInteger(option.len) && len >= 0) {
+                this.#len = option.len;
+            }
+        }
+    }
+
+    /**
+     * 生成下一个全局唯一字符串 ID。
+     * 同一毫秒序号自动递增；序号溢出时会在控制台警告。
+     * @returns {string}
+     */
+    nextId() {
+        let ts = Date.now();
+        if (ts === this.#ts) {
+            this.#sn++;
+            if (this.#sn >= 10 ** this.#len) {
+                console.log("长度不够用了！！！");
+            }
+        } else {
+            this.#sn = 0;
+            this.#ts = ts;
+        }
+        return ts.toString() + this.#flag + this.#sn.toString().padStart(this.#len, "0");
+    }
+}
+
+export { MyId, getGUID };
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sources":["../src/source/id.js"],"sourcesContent":["/**\r\n * 生成 RFC4122 版本 4 的 GUID/UUID。\r\n * 收集来源：《基于mvc的javascript web富应用开发》 书中介绍是Robert Kieffer写的，还留了网址 http://goo.gl/0b0hu ，但实际访问不了。\r\n * 格式：`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`\r\n *\r\n * @returns {string} 36 位大写 GUID\r\n *\r\n * @example\r\n * // A2E0F340-6C3B-4D7F-B8C1-1E4F6A8B9C0D\r\n * console.log(getGUID())\r\n */\r\nexport function getGUID() {\r\n    return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\r\n        let r = (Math.random() * 16) | 0,\r\n            v = c == \"x\" ? r : (r & 0x3) | 0x8;\r\n        return v.toString(16).toUpperCase();\r\n    });\r\n}\r\n\r\n/**\r\n * 分布式短 ID 生成器。\r\n * 格式：`${timestamp}${flag}${serial}`，其中：\r\n * - timestamp：毫秒级时间戳\r\n * - flag：客户端标识串（自定义）\r\n * - serial：同一毫秒内的序号，左补零到固定长度\r\n */\r\nexport class MyId {\r\n    #ts = Date.now(); //\t时间戳\r\n    #sn = 0; //\t序号（保证同一客户端之间的唯一项）\r\n    #flag = \"\"; //\t客户端标识（保证不同客户端之间的唯一项）\r\n    #len = 5; //\t序号位长度（我的电脑测试，同一时间戳内可以for循环执行了1000次左右，没有一次超过3k，所以5位应该够用了）\r\n    //  测试代码\r\n    //  let obj = {[Date.now()]:[]}; try { for (let i = 0; i < 100000; i++) { obj[Date.now()].push(i); } } catch { console.log(obj[Object.getOwnPropertyNames(obj)[0]].length); }\r\n\r\n    /**\r\n     * @param {object} [option]\r\n     * @param {string} [option.flag] - 客户端标识，默认空串\r\n     * @param {number} [option.len=5] - 序号位长度（位数），安全范围 ≥0\r\n     */\r\n    constructor(option = {}) {\r\n        if (option) {\r\n            if (typeof option.flag === \"string\") {\r\n                this.#flag = option.flag;\r\n            }\r\n            if (Number.isSafeInteger(option.len) && len >= 0) {\r\n                this.#len = option.len;\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * 生成下一个全局唯一字符串 ID。\r\n     * 同一毫秒序号自动递增；序号溢出时会在控制台警告。\r\n     * @returns {string}\r\n     */\r\n    nextId() {\r\n        let ts = Date.now();\r\n        if (ts === this.#ts) {\r\n            this.#sn++;\r\n            if (this.#sn >= 10 ** this.#len) {\r\n                console.log(\"长度不够用了！！！\");\r\n            }\r\n        } else {\r\n            this.#sn = 0;\r\n            this.#ts = ts;\r\n        }\r\n        return ts.toString() + this.#flag + this.#sn.toString().padStart(this.#len, \"0\");\r\n    }\r\n}\r\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,OAAO,GAAG;AAC1B,IAAI,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK;AAC1E,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;AACxC,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC;AAC/C,QAAQ,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5C,IAAI,CAAC,CAAC,CAAC;AACP,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,IAAI,CAAC;AAClB,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACrB,IAAI,GAAG,GAAG,CAAC,CAAC;AACZ,IAAI,KAAK,GAAG,EAAE,CAAC;AACf,IAAI,IAAI,GAAG,CAAC,CAAC;AACb;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE;AAC7B,QAAQ,IAAI,MAAM,EAAE;AACpB,YAAY,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE;AACjD,gBAAgB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;AACzC,YAAY,CAAC;AACb,YAAY,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE;AAC9D,gBAAgB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;AACvC,YAAY,CAAC;AACb,QAAQ,CAAC;AACT,IAAI,CAAC;AACL;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,GAAG;AACb,QAAQ,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC5B,QAAQ,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE;AAC7B,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC;AACvB,YAAY,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE;AAC7C,gBAAgB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACzC,YAAY,CAAC;AACb,QAAQ,CAAC,MAAM;AACf,YAAY,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;AACzB,YAAY,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;AAC1B,QAAQ,CAAC;AACT,QAAQ,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACzF,IAAI,CAAC;AACL;;;;"}

package/dist/timer.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+/**
+ * 基于 `setTimeout` 的“间隔循环”定时器。
+ * 每次任务执行完成后才计算下一次间隔，避免任务堆积。
+ */
+class IntervalTimer {
+    
+    /**
+     * 创建定时器实例。
+     * @param {() => void} fn - 每次间隔要执行的业务函数
+     * @param {number} [ms=1000] - 间隔时间（毫秒）
+     * @throws {TypeError} 当 `fn` 不是函数时抛出
+     */
+    constructor(fn, ms = 1000) {
+        if (typeof fn !== "function") {
+            throw new TypeError("IntervalTimer: 必须传入一个函数");
+        }
+        this._fn = fn;
+        this._ms = ms;
+        this._timerId = null;
+    }
+
+    /**
+     * 启动定时器；若已启动则先停止再重新启动。
+     * 首次执行会立即触发。
+     */
+    start() {
+        this.stop();
+        const loop = () => {
+            this._fn(); // 执行业务
+            this._timerId = setTimeout(loop, this._ms);
+        };
+        loop(); // 立即执行第一次
+    }
+
+    /**
+     * 停止定时器。
+     */
+    stop() {
+        if (this._timerId !== null) {
+            clearTimeout(this._timerId);
+            this._timerId = null;
+        }
+    }
+
+    /**
+     * 查询定时器是否正在运行。
+     * @returns {boolean}
+     */
+    isRunning() {
+        return this._timerId !== null;
+    }
+}
+
+exports.IntervalTimer = IntervalTimer;
+//# sourceMappingURL=timer.cjs.map

package/dist/timer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.cjs","sources":["../src/source/timer.js"],"sourcesContent":["/**\n * 基于 `setTimeout` 的“间隔循环”定时器。\n * 每次任务执行完成后才计算下一次间隔，避免任务堆积。\n */\nexport class IntervalTimer {\n    \n    /**\n     * 创建定时器实例。\n     * @param {() => void} fn - 每次间隔要执行的业务函数\n     * @param {number} [ms=1000] - 间隔时间（毫秒）\n     * @throws {TypeError} 当 `fn` 不是函数时抛出\n     */\n    constructor(fn, ms = 1000) {\n        if (typeof fn !== \"function\") {\n            throw new TypeError(\"IntervalTimer: 必须传入一个函数\");\n        }\n        this._fn = fn;\n        this._ms = ms;\n        this._timerId = null;\n    }\n\n    /**\n     * 启动定时器；若已启动则先停止再重新启动。\n     * 首次执行会立即触发。\n     */\n    start() {\n        this.stop();\n        const loop = () => {\n            this._fn(); // 执行业务\n            this._timerId = setTimeout(loop, this._ms);\n        };\n        loop(); // 立即执行第一次\n    }\n\n    /**\n     * 停止定时器。\n     */\n    stop() {\n        if (this._timerId !== null) {\n            clearTimeout(this._timerId);\n            this._timerId = null;\n        }\n    }\n\n    /**\n     * 查询定时器是否正在运行。\n     * @returns {boolean}\n     */\n    isRunning() {\n        return this._timerId !== null;\n    }\n}\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACO,MAAM,aAAa,CAAC;AAC3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE;AAC/B,QAAQ,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE;AACtC,YAAY,MAAM,IAAI,SAAS,CAAC,yBAAyB,CAAC;AAC1D,QAAQ;AACR,QAAQ,IAAI,CAAC,GAAG,GAAG,EAAE;AACrB,QAAQ,IAAI,CAAC,GAAG,GAAG,EAAE;AACrB,QAAQ,IAAI,CAAC,QAAQ,GAAG,IAAI;AAC5B,IAAI;;AAEJ;AACA;AACA;AACA;AACA,IAAI,KAAK,GAAG;AACZ,QAAQ,IAAI,CAAC,IAAI,EAAE;AACnB,QAAQ,MAAM,IAAI,GAAG,MAAM;AAC3B,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC;AACvB,YAAY,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACtD,QAAQ,CAAC;AACT,QAAQ,IAAI,EAAE,CAAC;AACf,IAAI;;AAEJ;AACA;AACA;AACA,IAAI,IAAI,GAAG;AACX,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE;AACpC,YAAY,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;AACvC,YAAY,IAAI,CAAC,QAAQ,GAAG,IAAI;AAChC,QAAQ;AACR,IAAI;;AAEJ;AACA;AACA;AACA;AACA,IAAI,SAAS,GAAG;AAChB,QAAQ,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI;AACrC,IAAI;AACJ;;;;"}

package/dist/timer.js

@@ -0,0 +1,55 @@
+/**
+ * 基于 `setTimeout` 的“间隔循环”定时器。
+ * 每次任务执行完成后才计算下一次间隔，避免任务堆积。
+ */
+class IntervalTimer {
+    
+    /**
+     * 创建定时器实例。
+     * @param {() => void} fn - 每次间隔要执行的业务函数
+     * @param {number} [ms=1000] - 间隔时间（毫秒）
+     * @throws {TypeError} 当 `fn` 不是函数时抛出
+     */
+    constructor(fn, ms = 1000) {
+        if (typeof fn !== "function") {
+            throw new TypeError("IntervalTimer: 必须传入一个函数");
+        }
+        this._fn = fn;
+        this._ms = ms;
+        this._timerId = null;
+    }
+
+    /**
+     * 启动定时器；若已启动则先停止再重新启动。
+     * 首次执行会立即触发。
+     */
+    start() {
+        this.stop();
+        const loop = () => {
+            this._fn(); // 执行业务
+            this._timerId = setTimeout(loop, this._ms);
+        };
+        loop(); // 立即执行第一次
+    }
+
+    /**
+     * 停止定时器。
+     */
+    stop() {
+        if (this._timerId !== null) {
+            clearTimeout(this._timerId);
+            this._timerId = null;
+        }
+    }
+
+    /**
+     * 查询定时器是否正在运行。
+     * @returns {boolean}
+     */
+    isRunning() {
+        return this._timerId !== null;
+    }
+}
+
+export { IntervalTimer };
+//# sourceMappingURL=timer.js.map

package/dist/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sources":["../src/source/timer.js"],"sourcesContent":["/**\n * 基于 `setTimeout` 的“间隔循环”定时器。\n * 每次任务执行完成后才计算下一次间隔，避免任务堆积。\n */\nexport class IntervalTimer {\n    \n    /**\n     * 创建定时器实例。\n     * @param {() => void} fn - 每次间隔要执行的业务函数\n     * @param {number} [ms=1000] - 间隔时间（毫秒）\n     * @throws {TypeError} 当 `fn` 不是函数时抛出\n     */\n    constructor(fn, ms = 1000) {\n        if (typeof fn !== \"function\") {\n            throw new TypeError(\"IntervalTimer: 必须传入一个函数\");\n        }\n        this._fn = fn;\n        this._ms = ms;\n        this._timerId = null;\n    }\n\n    /**\n     * 启动定时器；若已启动则先停止再重新启动。\n     * 首次执行会立即触发。\n     */\n    start() {\n        this.stop();\n        const loop = () => {\n            this._fn(); // 执行业务\n            this._timerId = setTimeout(loop, this._ms);\n        };\n        loop(); // 立即执行第一次\n    }\n\n    /**\n     * 停止定时器。\n     */\n    stop() {\n        if (this._timerId !== null) {\n            clearTimeout(this._timerId);\n            this._timerId = null;\n        }\n    }\n\n    /**\n     * 查询定时器是否正在运行。\n     * @returns {boolean}\n     */\n    isRunning() {\n        return this._timerId !== null;\n    }\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACO,MAAM,aAAa,CAAC;AAC3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE;AAC/B,QAAQ,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE;AACtC,YAAY,MAAM,IAAI,SAAS,CAAC,yBAAyB,CAAC;AAC1D,QAAQ;AACR,QAAQ,IAAI,CAAC,GAAG,GAAG,EAAE;AACrB,QAAQ,IAAI,CAAC,GAAG,GAAG,EAAE;AACrB,QAAQ,IAAI,CAAC,QAAQ,GAAG,IAAI;AAC5B,IAAI;;AAEJ;AACA;AACA;AACA;AACA,IAAI,KAAK,GAAG;AACZ,QAAQ,IAAI,CAAC,IAAI,EAAE;AACnB,QAAQ,MAAM,IAAI,GAAG,MAAM;AAC3B,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC;AACvB,YAAY,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACtD,QAAQ,CAAC;AACT,QAAQ,IAAI,EAAE,CAAC;AACf,IAAI;;AAEJ;AACA;AACA;AACA,IAAI,IAAI,GAAG;AACX,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE;AACpC,YAAY,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;AACvC,YAAY,IAAI,CAAC,QAAQ,GAAG,IAAI;AAChC,QAAQ;AACR,IAAI;;AAEJ;AACA;AACA;AACA;AACA,IAAI,SAAS,GAAG;AAChB,QAAQ,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI;AACrC,IAAI;AACJ;;;;"}

package/dist/tree.cjs

@@ -0,0 +1,99 @@
+'use strict';
+
+/**
+ * 把嵌套树拍平成 `{ [id]: node }` 映射，同时把原 `children` 置为 `null`。
+ *
+ * @template T extends Record<PropertyKey, any>
+ * @param {T[]} data - 嵌套树森林
+ * @param {string} [idKey='id'] - 主键字段
+ * @param {string} [childrenKey='children'] - 子节点字段
+ * @returns {Record<string, T & { [k in typeof childrenKey]: null }>} id→节点的映射表
+ */
+function nestedTree2IdMap(data, idKey = "id", childrenKey = "children") {
+    const retObj = {};
+    function fn(nodes) {
+        if (Array.isArray(nodes) && nodes.length > 0) {
+            nodes.forEach((node) => {
+                retObj[node[idKey]] = { ...node };
+                retObj[node[idKey]][childrenKey] = null;
+
+                fn(node[childrenKey]);
+            });
+        }
+    }
+    fn(data);
+    return retObj;
+}
+
+/**
+ * 把**已包含完整父子关系**的扁平节点列表还原成嵌套树（森林）。
+ *
+ * @template T extends Record<PropertyKey, any>
+ * @param {T[]} nodes - 扁平节点列表（必须包含 id / parentId）
+ * @param {number | string} [parentId=0] - 根节点标识值
+ * @param {Object} [opts] - 字段映射配置
+ * @param {string} [opts.idKey='id'] - 节点主键
+ * @param {string} [opts.parentKey='parentId'] - 父节点外键
+ * @param {string} [opts.childrenKey='children'] - 存放子节点的字段
+ * @returns {(T & { [k in typeof childrenKey]: T[] })[]} 嵌套树森林
+ */
+function flatCompleteTree2NestedTree(nodes, parentId = 0, { idKey = "id", parentKey = "parentId", childrenKey = "children" } = {}) {
+    const map = new Map(); // id -> node
+    const items = []; // 多根森林
+
+    // 1. 初始化：保证每个节点都有 children，并存入 map
+    for (const item of nodes) {
+        const node = { ...item, [childrenKey]: [] };
+        map.set(item[idKey], node);
+    }
+
+    // 2. 建立父子关系
+    for (const item of nodes) {
+        const node = map.get(item[idKey]);
+        const parentIdVal = item[parentKey];
+
+        if (parentIdVal === parentId) {
+            // 根层
+            items.push(node);
+        } else {
+            // 非根层：找到父节点，把自己挂上去
+            const parent = map.get(parentIdVal);
+            if (parent) parent[childrenKey].push(node);
+            // 如果 parent 不存在，说明数据不完整，可自定义处理
+        }
+    }
+
+    return items;
+}
+
+/**
+ * 在嵌套树中按 `id` 递归查找节点，并返回其指定属性值。
+ *
+ * @template T extends Record<PropertyKey, any>
+ * @param {string | number} id - 要查找的 id
+ * @param {T[]} arr - 嵌套树森林
+ * @param {string} [resultKey='name'] - 需要返回的字段
+ * @param {string} [idKey='id'] - 主键字段
+ * @param {string} [childrenKey='children'] - 子节点字段
+ * @returns {any} 找到的值；未找到返回 `undefined`
+ */
+const findObjAttrValueById = function findObjAttrValueByIdFn(id, arr, resultKey = "name", idKey = "id", childrenKey = "children") {
+    if (Array.isArray(arr) && arr.length > 0) {
+        for (let i = 0; i < arr.length; i++) {
+            const item = arr[i];
+            if (item[idKey]?.toString() === id?.toString()) {
+                return item[resultKey];
+            } else if (Array.isArray(item[childrenKey]) && item[childrenKey].length > 0) {
+                const result = findObjAttrValueByIdFn(id, item[childrenKey], resultKey, idKey, childrenKey);
+                if (result) {
+                    return result;
+                }
+            }
+        }
+    }
+};
+
+exports.findObjAttrValueById = findObjAttrValueById;
+exports.flatCompleteTree2NestedTree = flatCompleteTree2NestedTree;
+exports.nestedTree2IdMap = nestedTree2IdMap;
+//# sourceMappingURL=tree.cjs.map

package/dist/tree.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.cjs","sources":["../src/source/tree.js"],"sourcesContent":["/**\n * 把嵌套树拍平成 `{ [id]: node }` 映射，同时把原 `children` 置为 `null`。\n *\n * @template T extends Record<PropertyKey, any>\n * @param {T[]} data - 嵌套树森林\n * @param {string} [idKey='id'] - 主键字段\n * @param {string} [childrenKey='children'] - 子节点字段\n * @returns {Record<string, T & { [k in typeof childrenKey]: null }>} id→节点的映射表\n */\nexport function nestedTree2IdMap(data, idKey = \"id\", childrenKey = \"children\") {\n    const retObj = {};\n    function fn(nodes) {\n        if (Array.isArray(nodes) && nodes.length > 0) {\n            nodes.forEach((node) => {\n                retObj[node[idKey]] = { ...node };\n                retObj[node[idKey]][childrenKey] = null;\n\n                fn(node[childrenKey]);\n            });\n        }\n    }\n    fn(data);\n    return retObj;\n}\n\n/**\n * 把**已包含完整父子关系**的扁平节点列表还原成嵌套树（森林）。\n *\n * @template T extends Record<PropertyKey, any>\n * @param {T[]} nodes - 扁平节点列表（必须包含 id / parentId）\n * @param {number | string} [parentId=0] - 根节点标识值\n * @param {Object} [opts] - 字段映射配置\n * @param {string} [opts.idKey='id'] - 节点主键\n * @param {string} [opts.parentKey='parentId'] - 父节点外键\n * @param {string} [opts.childrenKey='children'] - 存放子节点的字段\n * @returns {(T & { [k in typeof childrenKey]: T[] })[]} 嵌套树森林\n */\nexport function flatCompleteTree2NestedTree(nodes, parentId = 0, { idKey = \"id\", parentKey = \"parentId\", childrenKey = \"children\" } = {}) {\n    const map = new Map(); // id -> node\n    const items = []; // 多根森林\n\n    // 1. 初始化：保证每个节点都有 children，并存入 map\n    for (const item of nodes) {\n        const node = { ...item, [childrenKey]: [] };\n        map.set(item[idKey], node);\n    }\n\n    // 2. 建立父子关系\n    for (const item of nodes) {\n        const node = map.get(item[idKey]);\n        const parentIdVal = item[parentKey];\n\n        if (parentIdVal === parentId) {\n            // 根层\n            items.push(node);\n        } else {\n            // 非根层：找到父节点，把自己挂上去\n            const parent = map.get(parentIdVal);\n            if (parent) parent[childrenKey].push(node);\n            // 如果 parent 不存在，说明数据不完整，可自定义处理\n        }\n    }\n\n    return items;\n}\n\n/**\n * 在嵌套树中按 `id` 递归查找节点，并返回其指定属性值。\n *\n * @template T extends Record<PropertyKey, any>\n * @param {string | number} id - 要查找的 id\n * @param {T[]} arr - 嵌套树森林\n * @param {string} [resultKey='name'] - 需要返回的字段\n * @param {string} [idKey='id'] - 主键字段\n * @param {string} [childrenKey='children'] - 子节点字段\n * @returns {any} 找到的值；未找到返回 `undefined`\n */\nexport const findObjAttrValueById = function findObjAttrValueByIdFn(id, arr, resultKey = \"name\", idKey = \"id\", childrenKey = \"children\") {\n    if (Array.isArray(arr) && arr.length > 0) {\n        for (let i = 0; i < arr.length; i++) {\n            const item = arr[i];\n            if (item[idKey]?.toString() === id?.toString()) {\n                return item[resultKey];\n            } else if (Array.isArray(item[childrenKey]) && item[childrenKey].length > 0) {\n                const result = findObjAttrValueByIdFn(id, item[childrenKey], resultKey, idKey, childrenKey);\n                if (result) {\n                    return result;\n                }\n            }\n        }\n    }\n};\n"],"names":[],"mappings":"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"}