npm - @cloudcome/utils-core - Versions diffs - 1.8.0 → 1.9.0 - Mend

@cloudcome/utils-core 1.8.0 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (28) hide show

package/dist/emitter.cjs CHANGED Viewed

@@ -1,18 +1,7 @@
 "use strict";
-var __typeError = (msg) => {
-  throw TypeError(msg);
-};
-var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
-var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
-var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
-var _events, _Emitter_instances, offAll_fn, offEvent_fn, offListener_fn;
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 class Emitter {
-  constructor() {
-    __privateAdd(this, _Emitter_instances);
-    __privateAdd(this, _events, /* @__PURE__ */ new Map());
-  }
+  #events = /* @__PURE__ */ new Map();
   /**
    * 注册事件监听器
    * @param event - 要监听的事件名称
@@ -23,11 +12,11 @@ class Emitter {
    * });
    */
   on(event, listener) {
-    const listeners = __privateGet(this, _events).get(event);
+    const listeners = this.#events.get(event);
     if (listeners) {
       listeners.add(listener);
     } else {
-      __privateGet(this, _events).set(event, /* @__PURE__ */ new Set([listener]));
+      this.#events.set(event, /* @__PURE__ */ new Set([listener]));
     }
   }
   /**
@@ -49,11 +38,23 @@ class Emitter {
    */
   off(event, listener) {
     if (event && listener) {
-      __privateMethod(this, _Emitter_instances, offListener_fn).call(this, event, listener);
+      this.#offListener(event, listener);
     } else if (event) {
-      __privateMethod(this, _Emitter_instances, offEvent_fn).call(this, event);
+      this.#offEvent(event);
     } else {
-      __privateMethod(this, _Emitter_instances, offAll_fn).call(this);
+      this.#offAll();
+    }
+  }
+  #offAll() {
+    this.#events.clear();
+  }
+  #offEvent(event) {
+    this.#events.delete(event);
+  }
+  #offListener(event, listener) {
+    const listeners = this.#events.get(event);
+    if (listeners) {
+      listeners.delete(listener);
     }
   }
   /**
@@ -67,7 +68,7 @@ class Emitter {
    * emitter.emit('click', 10, 20);
    */
   emit(event, ...payloads) {
-    const listeners = __privateGet(this, _events).get(event);
+    const listeners = this.#events.get(event);
     if (!listeners) return;
     for (const listener of [...listeners]) {
       if (listener(...payloads) === false) {
@@ -76,19 +77,5 @@ class Emitter {
     }
   }
 }
-_events = new WeakMap();
-_Emitter_instances = new WeakSet();
-offAll_fn = function() {
-  __privateGet(this, _events).clear();
-};
-offEvent_fn = function(event) {
-  __privateGet(this, _events).delete(event);
-};
-offListener_fn = function(event, listener) {
-  const listeners = __privateGet(this, _events).get(event);
-  if (listeners) {
-    listeners.delete(listener);
-  }
-};
 exports.Emitter = Emitter;
 //# sourceMappingURL=emitter.cjs.map

package/dist/emitter.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"emitter.cjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/*\n 事件类型映射，key 为事件名称，value 为事件参数类型数组\n /\nexport type EmitterMap = Record<string, unknown[]>;\n\n/\n 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n /\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false \| unknown;\n\n/\n 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n \n @example\n * type MyEvents = {\n * 'click': [x: number, y: number];\n * 'change': [value: string];\n * };\n \n const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n /\nexport class Emitter<E extends EmitterMap> {\n #events: Map<keyof E, Set<AnyFunction>> = new Map();\n\n /\n 注册事件监听器\n * @param event - 要监听的事件名称\n * @param listener - 事件监听器函数\n * @example\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n /\n on<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n if (listeners) {\n listeners.add(listener);\n } else {\n this.#events.set(event, new Set([listener]));\n }\n }\n\n /\n 移除事件监听器，有三种使用方式：\n * 1. 移除特定事件的特定监听器\n * 2. 移除特定事件的所有监听器\n * 3. 移除所有事件的所有监听器\n * @param event - 要移除的事件名称（可选）\n * @param listener - 要移除的监听器函数（可选）\n * @example\n * // 移除特定事件的特定监听器\n * emitter.off('click', clickHandler);\n \n // 移除特定事件的所有监听器\n * emitter.off('click');\n \n // 移除所有事件的所有监听器\n * emitter.off();\n /\n off<K extends keyof E>(event?: K, listener?: EmitterListener<E, K>) {\n if (event && listener) {\n this.#offListener(event, listener);\n } else if (event) {\n this.#offEvent(event);\n } else {\n this.#offAll();\n }\n }\n\n #offAll() {\n this.#events.clear();\n }\n\n #offEvent<K extends keyof E>(event: K) {\n this.#events.delete(event);\n }\n\n #offListener<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n\n if (listeners) {\n listeners.delete(listener);\n }\n }\n\n /\n 触发指定事件，调用所有注册的监听器\n * @param event - 要触发的事件名称\n * @param payloads - 传递给监听器的参数\n * @remarks\n * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，\n * 则后续监听器将不会被执行\n * @example\n * emitter.emit('click', 10, 20);\n */\n emit<K extends keyof E>(event: K, ...payloads: Parameters<EmitterListener<E, K>>) {\n const listeners = this.#events.get(event) as Set<EmitterListener<E, K>> \| undefined;\n\n if (!listeners) return;\n\n // 避免在 emit、on 的过程中改变 listeners 从而影响本次 emit\n for (const listener of [...listeners]) {\n if (listener(...payloads) === false) {\n break;\n }\n }\n }\n}\n"],"names":[],"mappings":"~~;;;;;;;;;;~~AA8BO,MAAM,QAA8B;AAAA,~~EAApC;AAAA;AACL~~,~~oDAA8C~~,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA~~;AAAA~~,EAWlD,GAAsB,OAAU,UAAiC;AAC/D,UAAM,YAAY,~~mBAAK~~,~~SAAQ~~,IAAI,KAAK;AACxC,QAAI,WAAW;AACb,gBAAU,IAAI,QAAQ;AAAA,IAAA,OACjB;AACA,~~yBAAA~~,~~SAAQ~~,IAAI,OAAO,oBAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBF,IAAuB,OAAW,UAAkC;AAClE,QAAI,SAAS,UAAU;AAChB,~~4BAAA~~,~~oCAAA~~,~~WAAa~~,~~OAAO~~;AAAA,~~eAChB~~,OAAO;AAChB,~~4BAAK~~,~~iCAAL~~,~~WAAe~~;AAAA,~~IAAK~~,OACf;AACL,~~4BAAK,+BAAL~~;AAAA,~~IAAa~~;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,~~EA6BF~~,KAAwB,UAAa,UAA6C;AAChF,UAAM,YAAY,~~mBAAK~~,~~SAAQ~~,IAAI,KAAK;AAExC,QAAI,CAAC,UAAW;AAGhB,eAAW,YAAY,CAAC,GAAG,SAAS,GAAG;AACrC,UAAI,SAAS,GAAG,QAAQ,MAAM,OAAO;AACnC;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;AArFE;AADK;AAgDL,YAAU,WAAA;AACR,qBAAK,SAAQ,MAAM;AAAA;AAGrB,uBAA6B,OAAU;AAChC,qBAAA,SAAQ,OAAO,KAAK;AAAA;AAG3B,iBAAA,SAAgC,OAAU,UAAiC;AACzE,QAAM,YAAY,mBAAK,SAAQ,IAAI,KAAK;AAExC,MAAI,WAAW;AACb,cAAU,OAAO,QAAQ;AAAA,EAAA;AAC3B;;"}
1	+ {"version":3,"file":"emitter.cjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/*\n 事件类型映射，key 为事件名称，value 为事件参数类型数组\n /\nexport type EmitterMap = Record<string, unknown[]>;\n\n/\n 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n /\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false \| unknown;\n\n/\n 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n \n @example\n * type MyEvents = {\n * 'click': [x: number, y: number];\n * 'change': [value: string];\n * };\n \n const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n /\nexport class Emitter<E extends EmitterMap> {\n #events: Map<keyof E, Set<AnyFunction>> = new Map();\n\n /\n 注册事件监听器\n * @param event - 要监听的事件名称\n * @param listener - 事件监听器函数\n * @example\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n /\n on<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n if (listeners) {\n listeners.add(listener);\n } else {\n this.#events.set(event, new Set([listener]));\n }\n }\n\n /\n 移除事件监听器，有三种使用方式：\n * 1. 移除特定事件的特定监听器\n * 2. 移除特定事件的所有监听器\n * 3. 移除所有事件的所有监听器\n * @param event - 要移除的事件名称（可选）\n * @param listener - 要移除的监听器函数（可选）\n * @example\n * // 移除特定事件的特定监听器\n * emitter.off('click', clickHandler);\n \n // 移除特定事件的所有监听器\n * emitter.off('click');\n \n // 移除所有事件的所有监听器\n * emitter.off();\n /\n off<K extends keyof E>(event?: K, listener?: EmitterListener<E, K>) {\n if (event && listener) {\n this.#offListener(event, listener);\n } else if (event) {\n this.#offEvent(event);\n } else {\n this.#offAll();\n }\n }\n\n #offAll() {\n this.#events.clear();\n }\n\n #offEvent<K extends keyof E>(event: K) {\n this.#events.delete(event);\n }\n\n #offListener<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n\n if (listeners) {\n listeners.delete(listener);\n }\n }\n\n /\n 触发指定事件，调用所有注册的监听器\n * @param event - 要触发的事件名称\n * @param payloads - 传递给监听器的参数\n * @remarks\n * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，\n * 则后续监听器将不会被执行\n * @example\n * emitter.emit('click', 10, 20);\n */\n emit<K extends keyof E>(event: K, ...payloads: Parameters<EmitterListener<E, K>>) {\n const listeners = this.#events.get(event) as Set<EmitterListener<E, K>> \| undefined;\n\n if (!listeners) return;\n\n // 避免在 emit、on 的过程中改变 listeners 从而影响本次 emit\n for (const listener of [...listeners]) {\n if (listener(...payloads) === false) {\n break;\n }\n }\n }\n}\n"],"names":[],"mappings":";;AA8BO,MAAM,QAA8B;AAAA,EACzC,8BAA8C,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWlD,GAAsB,OAAU,UAAiC;AAC/D,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AACxC,QAAI,WAAW;AACb,gBAAU,IAAI,QAAQ;AAAA,IAAA,OACjB;AACA,WAAA,QAAQ,IAAI,OAAO,oBAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBF,IAAuB,OAAW,UAAkC;AAClE,QAAI,SAAS,UAAU;AAChB,WAAA,aAAa,OAAO,QAAQ;AAAA,eACxB,OAAO;AAChB,WAAK,UAAU,KAAK;AAAA,IAAA,OACf;AACL,WAAK,QAAQ;AAAA,IAAA;AAAA,EACf;AAAA,EAGF,UAAU;AACR,SAAK,QAAQ,MAAM;AAAA,EAAA;AAAA,EAGrB,UAA6B,OAAU;AAChC,SAAA,QAAQ,OAAO,KAAK;AAAA,EAAA;AAAA,EAG3B,aAAgC,OAAU,UAAiC;AACzE,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AAExC,QAAI,WAAW;AACb,gBAAU,OAAO,QAAQ;AAAA,IAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaF,KAAwB,UAAa,UAA6C;AAChF,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AAExC,QAAI,CAAC,UAAW;AAGhB,eAAW,YAAY,CAAC,GAAG,SAAS,GAAG;AACrC,UAAI,SAAS,GAAG,QAAQ,MAAM,OAAO;AACnC;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;;"}

package/dist/emitter.mjs CHANGED Viewed

@@ -1,16 +1,5 @@
-var __typeError = (msg) => {
-  throw TypeError(msg);
-};
-var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
-var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
-var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
-var _events, _Emitter_instances, offAll_fn, offEvent_fn, offListener_fn;
 class Emitter {
-  constructor() {
-    __privateAdd(this, _Emitter_instances);
-    __privateAdd(this, _events, /* @__PURE__ */ new Map());
-  }
+  #events = /* @__PURE__ */ new Map();
   /**
    * 注册事件监听器
    * @param event - 要监听的事件名称
@@ -21,11 +10,11 @@ class Emitter {
    * });
    */
   on(event, listener) {
-    const listeners = __privateGet(this, _events).get(event);
+    const listeners = this.#events.get(event);
     if (listeners) {
       listeners.add(listener);
     } else {
-      __privateGet(this, _events).set(event, /* @__PURE__ */ new Set([listener]));
+      this.#events.set(event, /* @__PURE__ */ new Set([listener]));
     }
   }
   /**
@@ -47,11 +36,23 @@ class Emitter {
    */
   off(event, listener) {
     if (event && listener) {
-      __privateMethod(this, _Emitter_instances, offListener_fn).call(this, event, listener);
+      this.#offListener(event, listener);
     } else if (event) {
-      __privateMethod(this, _Emitter_instances, offEvent_fn).call(this, event);
+      this.#offEvent(event);
     } else {
-      __privateMethod(this, _Emitter_instances, offAll_fn).call(this);
+      this.#offAll();
+    }
+  }
+  #offAll() {
+    this.#events.clear();
+  }
+  #offEvent(event) {
+    this.#events.delete(event);
+  }
+  #offListener(event, listener) {
+    const listeners = this.#events.get(event);
+    if (listeners) {
+      listeners.delete(listener);
     }
   }
   /**
@@ -65,7 +66,7 @@ class Emitter {
    * emitter.emit('click', 10, 20);
    */
   emit(event, ...payloads) {
-    const listeners = __privateGet(this, _events).get(event);
+    const listeners = this.#events.get(event);
     if (!listeners) return;
     for (const listener of [...listeners]) {
       if (listener(...payloads) === false) {
@@ -74,20 +75,6 @@ class Emitter {
     }
   }
 }
-_events = new WeakMap();
-_Emitter_instances = new WeakSet();
-offAll_fn = function() {
-  __privateGet(this, _events).clear();
-};
-offEvent_fn = function(event) {
-  __privateGet(this, _events).delete(event);
-};
-offListener_fn = function(event, listener) {
-  const listeners = __privateGet(this, _events).get(event);
-  if (listeners) {
-    listeners.delete(listener);
-  }
-};
 export {
   Emitter
 };

package/dist/emitter.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"emitter.mjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/*\n 事件类型映射，key 为事件名称，value 为事件参数类型数组\n /\nexport type EmitterMap = Record<string, unknown[]>;\n\n/\n 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n /\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false \| unknown;\n\n/\n 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n \n @example\n * type MyEvents = {\n * 'click': [x: number, y: number];\n * 'change': [value: string];\n * };\n \n const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n /\nexport class Emitter<E extends EmitterMap> {\n #events: Map<keyof E, Set<AnyFunction>> = new Map();\n\n /\n 注册事件监听器\n * @param event - 要监听的事件名称\n * @param listener - 事件监听器函数\n * @example\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n /\n on<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n if (listeners) {\n listeners.add(listener);\n } else {\n this.#events.set(event, new Set([listener]));\n }\n }\n\n /\n 移除事件监听器，有三种使用方式：\n * 1. 移除特定事件的特定监听器\n * 2. 移除特定事件的所有监听器\n * 3. 移除所有事件的所有监听器\n * @param event - 要移除的事件名称（可选）\n * @param listener - 要移除的监听器函数（可选）\n * @example\n * // 移除特定事件的特定监听器\n * emitter.off('click', clickHandler);\n \n // 移除特定事件的所有监听器\n * emitter.off('click');\n \n // 移除所有事件的所有监听器\n * emitter.off();\n /\n off<K extends keyof E>(event?: K, listener?: EmitterListener<E, K>) {\n if (event && listener) {\n this.#offListener(event, listener);\n } else if (event) {\n this.#offEvent(event);\n } else {\n this.#offAll();\n }\n }\n\n #offAll() {\n this.#events.clear();\n }\n\n #offEvent<K extends keyof E>(event: K) {\n this.#events.delete(event);\n }\n\n #offListener<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n\n if (listeners) {\n listeners.delete(listener);\n }\n }\n\n /\n 触发指定事件，调用所有注册的监听器\n * @param event - 要触发的事件名称\n * @param payloads - 传递给监听器的参数\n * @remarks\n * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，\n * 则后续监听器将不会被执行\n * @example\n * emitter.emit('click', 10, 20);\n */\n emit<K extends keyof E>(event: K, ...payloads: Parameters<EmitterListener<E, K>>) {\n const listeners = this.#events.get(event) as Set<EmitterListener<E, K>> \| undefined;\n\n if (!listeners) return;\n\n // 避免在 emit、on 的过程中改变 listeners 从而影响本次 emit\n for (const listener of [...listeners]) {\n if (listener(...payloads) === false) {\n break;\n }\n }\n }\n}\n"],"names":[],"mappings":"~~;;;;;;;~~AA8BO~~;AAAA~~,MAAM,QAA8B;AAAA,~~EAApC;AAAA;AACL~~,~~oDAA8C~~,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA~~;AAAA~~,EAWlD,GAAsB,OAAU,UAAiC;AAC/D,UAAM,YAAY,~~mBAAK~~,~~SAAQ~~,IAAI,KAAK;AACxC,QAAI,WAAW;AACb,gBAAU,IAAI,QAAQ;AAAA,IAAA,OACjB;AACA,~~yBAAA~~,~~SAAQ~~,IAAI,OAAO,oBAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBF,IAAuB,OAAW,UAAkC;AAClE,QAAI,SAAS,UAAU;AAChB,~~4BAAA~~,~~oCAAA~~,~~WAAa~~,~~OAAO~~;AAAA,~~eAChB~~,OAAO;AAChB,~~4BAAK~~,~~iCAAL~~,~~WAAe~~;AAAA,~~IAAK~~,OACf;AACL,~~4BAAK,+BAAL~~;AAAA,~~IAAa~~;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,~~EA6BF~~,KAAwB,UAAa,UAA6C;AAChF,UAAM,YAAY,~~mBAAK~~,~~SAAQ~~,IAAI,KAAK;AAExC,QAAI,CAAC,UAAW;AAGhB,eAAW,YAAY,CAAC,GAAG,SAAS,GAAG;AACrC,UAAI,SAAS,GAAG,QAAQ,MAAM,OAAO;AACnC;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;AArFE;AADK;AAgDL,YAAU,WAAA;AACR,qBAAK,SAAQ,MAAM;AAAA;AAGrB,uBAA6B,OAAU;AAChC,qBAAA,SAAQ,OAAO,KAAK;AAAA;AAG3B,iBAAA,SAAgC,OAAU,UAAiC;AACzE,QAAM,YAAY,mBAAK,SAAQ,IAAI,KAAK;AAExC,MAAI,WAAW;AACb,cAAU,OAAO,QAAQ;AAAA,EAAA;AAC3B;"}
1	+ {"version":3,"file":"emitter.mjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/*\n 事件类型映射，key 为事件名称，value 为事件参数类型数组\n /\nexport type EmitterMap = Record<string, unknown[]>;\n\n/\n 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n /\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false \| unknown;\n\n/\n 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n \n @example\n * type MyEvents = {\n * 'click': [x: number, y: number];\n * 'change': [value: string];\n * };\n \n const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n /\nexport class Emitter<E extends EmitterMap> {\n #events: Map<keyof E, Set<AnyFunction>> = new Map();\n\n /\n 注册事件监听器\n * @param event - 要监听的事件名称\n * @param listener - 事件监听器函数\n * @example\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n /\n on<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n if (listeners) {\n listeners.add(listener);\n } else {\n this.#events.set(event, new Set([listener]));\n }\n }\n\n /\n 移除事件监听器，有三种使用方式：\n * 1. 移除特定事件的特定监听器\n * 2. 移除特定事件的所有监听器\n * 3. 移除所有事件的所有监听器\n * @param event - 要移除的事件名称（可选）\n * @param listener - 要移除的监听器函数（可选）\n * @example\n * // 移除特定事件的特定监听器\n * emitter.off('click', clickHandler);\n \n // 移除特定事件的所有监听器\n * emitter.off('click');\n \n // 移除所有事件的所有监听器\n * emitter.off();\n /\n off<K extends keyof E>(event?: K, listener?: EmitterListener<E, K>) {\n if (event && listener) {\n this.#offListener(event, listener);\n } else if (event) {\n this.#offEvent(event);\n } else {\n this.#offAll();\n }\n }\n\n #offAll() {\n this.#events.clear();\n }\n\n #offEvent<K extends keyof E>(event: K) {\n this.#events.delete(event);\n }\n\n #offListener<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n\n if (listeners) {\n listeners.delete(listener);\n }\n }\n\n /\n 触发指定事件，调用所有注册的监听器\n * @param event - 要触发的事件名称\n * @param payloads - 传递给监听器的参数\n * @remarks\n * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，\n * 则后续监听器将不会被执行\n * @example\n * emitter.emit('click', 10, 20);\n */\n emit<K extends keyof E>(event: K, ...payloads: Parameters<EmitterListener<E, K>>) {\n const listeners = this.#events.get(event) as Set<EmitterListener<E, K>> \| undefined;\n\n if (!listeners) return;\n\n // 避免在 emit、on 的过程中改变 listeners 从而影响本次 emit\n for (const listener of [...listeners]) {\n if (listener(...payloads) === false) {\n break;\n }\n }\n }\n}\n"],"names":[],"mappings":"AA8BO,MAAM,QAA8B;AAAA,EACzC,8BAA8C,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWlD,GAAsB,OAAU,UAAiC;AAC/D,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AACxC,QAAI,WAAW;AACb,gBAAU,IAAI,QAAQ;AAAA,IAAA,OACjB;AACA,WAAA,QAAQ,IAAI,OAAO,oBAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBF,IAAuB,OAAW,UAAkC;AAClE,QAAI,SAAS,UAAU;AAChB,WAAA,aAAa,OAAO,QAAQ;AAAA,eACxB,OAAO;AAChB,WAAK,UAAU,KAAK;AAAA,IAAA,OACf;AACL,WAAK,QAAQ;AAAA,IAAA;AAAA,EACf;AAAA,EAGF,UAAU;AACR,SAAK,QAAQ,MAAM;AAAA,EAAA;AAAA,EAGrB,UAA6B,OAAU;AAChC,SAAA,QAAQ,OAAO,KAAK;AAAA,EAAA;AAAA,EAG3B,aAAgC,OAAU,UAAiC;AACzE,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AAExC,QAAI,WAAW;AACb,gBAAU,OAAO,QAAQ;AAAA,IAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaF,KAAwB,UAAa,UAA6C;AAChF,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AAExC,QAAI,CAAC,UAAW;AAGhB,eAAW,YAAY,CAAC,GAAG,SAAS,GAAG;AACrC,UAAI,SAAS,GAAG,QAAQ,MAAM,OAAO;AACnC;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;"}

package/dist/index.cjs CHANGED Viewed

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const VERSION = "1.7.0";
+const VERSION = "1.8.0";
 exports.VERSION = VERSION;
 //# sourceMappingURL=index.cjs.map

package/dist/index.mjs CHANGED Viewed

@@ -1,4 +1,4 @@
-const VERSION = "1.7.0";
+const VERSION = "1.8.0";
 export {
   VERSION
 };

package/dist/timer.cjs CHANGED Viewed

@@ -86,7 +86,7 @@ function timeInterval(callback, interval, options) {
   return {
     start() {
       if (!canStart()) return;
-      if (options == null ? void 0 : options.leading) {
+      if (options?.leading) {
         start();
       } else {
         timeId = setTimeout(start, interval);
@@ -94,19 +94,19 @@ function timeInterval(callback, interval, options) {
     },
     stop() {
       if (!canStop()) return;
-      if (options == null ? void 0 : options.trailing) execute();
+      if (options?.trailing) execute();
       clearTimeout(timeId);
       stop();
     },
     pause() {
       if (!canPause()) return;
-      if (options == null ? void 0 : options.trailing) execute();
+      if (options?.trailing) execute();
       clearTimeout(timeId);
       pause();
     },
     resume(immediate) {
       if (!canResume()) return;
-      if (immediate || (options == null ? void 0 : options.leading)) {
+      if (immediate || options?.leading) {
         resume();
       } else {
         timeId = setTimeout(resume, interval);

package/dist/timer.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"timer.cjs","sources":["../src/timer.ts"],"sourcesContent":["/*\n 定时器状态接口\n /\nexport type TimerState = {\n /\n 执行次数\n /\n times: number;\n /\n 开始时间戳\n /\n startAt: number;\n /\n 停止时间戳\n /\n stopAt: number;\n /\n 暂停时间戳\n /\n pauseAt: number;\n /\n 恢复时间戳\n /\n resumeAt: number;\n /\n 当前时间戳\n /\n currentAt: number;\n /\n 总耗时（包括暂停时间）\n /\n elapsedTime: number;\n /\n 实际运行时间（不包括暂停时间）\n /\n runningTime: number;\n /\n 当前间隔时间\n /\n intervalTime: number;\n};\n\nexport type TimerHandler = {\n /\n 开始\n /\n start: () => void;\n /\n 暂停\n /\n pause: () => void;\n /\n 恢复\n /\n resume: (immediate?: boolean) => void;\n /\n 停止\n /\n stop: () => void;\n};\n\nconst STATUS_READY = 0;\nconst STATUS_START = 1;\nconst STATUS_PAUSE = 2;\nconst STATUS_STOP = 3;\n\n/\n 创建间隔定时器核心函数\n \n @param nextTime - 用于安排下一次执行的函数\n * @param effect - 每次执行的回调函数，接收定时器状态和可选的next函数\n * @returns 返回包含控制方法的对象\n /\nexport function makeInterval(\n nextTime: (call: () => void) => void,\n effect: (timer: TimerState, next?: () => void) => unknown,\n) {\n let startAt = 0;\n let lastAt = 0;\n let stopAt = 0;\n let pauseAt = 0;\n let resumeAt = 0;\n let times = 0;\n let status = STATUS_READY;\n let runningTime = 0;\n\n const execute = () => {\n if (status >= STATUS_PAUSE) return;\n\n const now = Date.now();\n const intervalTime = lastAt > 0 ? now - lastAt : 0;\n runningTime += intervalTime;\n lastAt = now;\n const state: TimerState = {\n times: ++times,\n startAt,\n stopAt,\n pauseAt,\n resumeAt,\n currentAt: now,\n elapsedTime: startAt > 0 ? now - startAt : 0,\n runningTime,\n intervalTime,\n };\n\n if (effect.length === 2) {\n effect(state, () => {\n nextTime(execute);\n });\n } else {\n effect(state);\n nextTime(execute);\n }\n };\n\n const canStart = () => status === STATUS_READY;\n const start = () => {\n if (!canStart()) return;\n status = STATUS_START;\n startAt = Date.now();\n execute();\n };\n\n const canStop = () => status === STATUS_START;\n const stop = () => {\n if (!canStop()) return;\n status = STATUS_STOP;\n stopAt = Date.now();\n };\n\n const canPause = () => status === STATUS_START;\n const pause = () => {\n if (!canPause()) return;\n status = STATUS_PAUSE;\n pauseAt = Date.now();\n };\n\n const canResume = () => status === STATUS_PAUSE;\n const resume = () => {\n if (!canResume()) return;\n status = STATUS_START;\n resumeAt = Date.now();\n lastAt = resumeAt;\n execute();\n };\n\n return {\n canStart,\n canStop,\n canPause,\n canResume,\n start,\n stop,\n pause,\n resume,\n execute,\n };\n}\n\nexport type TimerOptions = {\n /\n 是否在定时器开始时立即执行回调\n /\n leading?: boolean;\n /\n 是否在定时器停止时执行最后一次回调\n /\n trailing?: boolean;\n};\n\n/\n 创建一个基于 `setTimeout` 的间隔定时器\n \n @param callback - 每次间隔执行的回调函数，接收定时器状态和可选的 `next` 函数\n * @param interval - 间隔时间，单位为毫秒\n * @param options - 配置选项\n * @returns {TimerHandler}\n */\nexport function timeInterval(\n callback: (state: TimerState, next?: () => void) => unknown,\n interval: number,\n options?: TimerOptions,\n): TimerHandler {\n let timeId: number \| NodeJS.Timeout;\n const { canStart, canStop, canPause, canResume, start, stop, pause, resume, execute } = makeInterval((call) => {\n timeId = setTimeout(call, interval);\n }, callback);\n\n return {\n start() {\n if (!canStart()) return;\n\n if (options?.leading) {\n start();\n } else {\n timeId = setTimeout(start, interval);\n }\n },\n\n stop() {\n if (!canStop()) return;\n if (options?.trailing) execute();\n\n clearTimeout(timeId);\n stop();\n },\n\n pause() {\n if (!canPause()) return;\n if (options?.trailing) execute();\n\n clearTimeout(timeId);\n pause();\n },\n\n resume(immediate?: boolean) {\n if (!canResume()) return;\n\n if (immediate \|\| options?.leading) {\n resume();\n } else {\n timeId = setTimeout(resume, interval);\n }\n },\n };\n}\n"],"names":[],"mappings":";;AA6DA,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,cAAc;AASJ,SAAA,aACd,UACA,QACA;AACA,MAAI,UAAU;AACd,MAAI,SAAS;AACb,MAAI,SAAS;AACb,MAAI,UAAU;AACd,MAAI,WAAW;AACf,MAAI,QAAQ;AACZ,MAAI,SAAS;AACb,MAAI,cAAc;AAElB,QAAM,UAAU,MAAM;AACpB,QAAI,UAAU,aAAc;AAEtB,UAAA,MAAM,KAAK,IAAI;AACrB,UAAM,eAAe,SAAS,IAAI,MAAM,SAAS;AAClC,mBAAA;AACN,aAAA;AACT,UAAM,QAAoB;AAAA,MACxB,OAAO,EAAE;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,aAAa,UAAU,IAAI,MAAM,UAAU;AAAA,MAC3C;AAAA,MACA;AAAA,IACF;AAEI,QAAA,OAAO,WAAW,GAAG;AACvB,aAAO,OAAO,MAAM;AAClB,iBAAS,OAAO;AAAA,MAAA,CACjB;AAAA,IAAA,OACI;AACL,aAAO,KAAK;AACZ,eAAS,OAAO;AAAA,IAAA;AAAA,EAEpB;AAEM,QAAA,WAAW,MAAM,WAAW;AAClC,QAAM,QAAQ,MAAM;AACd,QAAA,CAAC,WAAY;AACR,aAAA;AACT,cAAU,KAAK,IAAI;AACX,YAAA;AAAA,EACV;AAEM,QAAA,UAAU,MAAM,WAAW;AACjC,QAAM,OAAO,MAAM;AACb,QAAA,CAAC,UAAW;AACP,aAAA;AACT,aAAS,KAAK,IAAI;AAAA,EACpB;AAEM,QAAA,WAAW,MAAM,WAAW;AAClC,QAAM,QAAQ,MAAM;AACd,QAAA,CAAC,WAAY;AACR,aAAA;AACT,cAAU,KAAK,IAAI;AAAA,EACrB;AAEM,QAAA,YAAY,MAAM,WAAW;AACnC,QAAM,SAAS,MAAM;AACf,QAAA,CAAC,YAAa;AACT,aAAA;AACT,eAAW,KAAK,IAAI;AACX,aAAA;AACD,YAAA;AAAA,EACV;AAEO,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAqBgB,SAAA,aACd,UACA,UACA,SACc;AACV,MAAA;AACJ,QAAM,EAAE,UAAU,SAAS,UAAU,WAAW,OAAO,MAAM,OAAO,QAAQ,QAAY,IAAA,aAAa,CAAC,SAAS;AACpG,aAAA,WAAW,MAAM,QAAQ;AAAA,KACjC,QAAQ;AAEJ,SAAA;AAAA,IACL,QAAQ;AACF,UAAA,CAAC,WAAY;AAEjB,UAAI,~~mCAAS~~,SAAS;AACd,cAAA;AAAA,MAAA,OACD;AACI,iBAAA,WAAW,OAAO,QAAQ;AAAA,MAAA;AAAA,IAEvC;AAAA,IAEA,OAAO;AACD,UAAA,CAAC,UAAW;AACZ,UAAA,~~mCAAS~~,SAAkB,SAAA;AAE/B,mBAAa,MAAM;AACd,WAAA;AAAA,IACP;AAAA,IAEA,QAAQ;AACF,UAAA,CAAC,WAAY;AACb,UAAA,~~mCAAS~~,SAAkB,SAAA;AAE/B,mBAAa,MAAM;AACb,YAAA;AAAA,IACR;AAAA,IAEA,OAAO,WAAqB;AACtB,UAAA,CAAC,YAAa;AAEd,UAAA,~~cAAa~~,~~mCAAS~~,~~UAAS~~;AAC1B,eAAA;AAAA,MAAA,OACF;AACI,iBAAA,WAAW,QAAQ,QAAQ;AAAA,MAAA;AAAA,IACtC;AAAA,EAEJ;AACF;;;"}
1	+ {"version":3,"file":"timer.cjs","sources":["../src/timer.ts"],"sourcesContent":["/*\n 定时器状态接口\n /\nexport type TimerState = {\n /\n 执行次数\n /\n times: number;\n /\n 开始时间戳\n /\n startAt: number;\n /\n 停止时间戳\n /\n stopAt: number;\n /\n 暂停时间戳\n /\n pauseAt: number;\n /\n 恢复时间戳\n /\n resumeAt: number;\n /\n 当前时间戳\n /\n currentAt: number;\n /\n 总耗时（包括暂停时间）\n /\n elapsedTime: number;\n /\n 实际运行时间（不包括暂停时间）\n /\n runningTime: number;\n /\n 当前间隔时间\n /\n intervalTime: number;\n};\n\nexport type TimerHandler = {\n /\n 开始\n /\n start: () => void;\n /\n 暂停\n /\n pause: () => void;\n /\n 恢复\n /\n resume: (immediate?: boolean) => void;\n /\n 停止\n /\n stop: () => void;\n};\n\nconst STATUS_READY = 0;\nconst STATUS_START = 1;\nconst STATUS_PAUSE = 2;\nconst STATUS_STOP = 3;\n\n/\n 创建间隔定时器核心函数\n \n @param nextTime - 用于安排下一次执行的函数\n * @param effect - 每次执行的回调函数，接收定时器状态和可选的next函数\n * @returns 返回包含控制方法的对象\n /\nexport function makeInterval(\n nextTime: (call: () => void) => void,\n effect: (timer: TimerState, next?: () => void) => unknown,\n) {\n let startAt = 0;\n let lastAt = 0;\n let stopAt = 0;\n let pauseAt = 0;\n let resumeAt = 0;\n let times = 0;\n let status = STATUS_READY;\n let runningTime = 0;\n\n const execute = () => {\n if (status >= STATUS_PAUSE) return;\n\n const now = Date.now();\n const intervalTime = lastAt > 0 ? now - lastAt : 0;\n runningTime += intervalTime;\n lastAt = now;\n const state: TimerState = {\n times: ++times,\n startAt,\n stopAt,\n pauseAt,\n resumeAt,\n currentAt: now,\n elapsedTime: startAt > 0 ? now - startAt : 0,\n runningTime,\n intervalTime,\n };\n\n if (effect.length === 2) {\n effect(state, () => {\n nextTime(execute);\n });\n } else {\n effect(state);\n nextTime(execute);\n }\n };\n\n const canStart = () => status === STATUS_READY;\n const start = () => {\n if (!canStart()) return;\n status = STATUS_START;\n startAt = Date.now();\n execute();\n };\n\n const canStop = () => status === STATUS_START;\n const stop = () => {\n if (!canStop()) return;\n status = STATUS_STOP;\n stopAt = Date.now();\n };\n\n const canPause = () => status === STATUS_START;\n const pause = () => {\n if (!canPause()) return;\n status = STATUS_PAUSE;\n pauseAt = Date.now();\n };\n\n const canResume = () => status === STATUS_PAUSE;\n const resume = () => {\n if (!canResume()) return;\n status = STATUS_START;\n resumeAt = Date.now();\n lastAt = resumeAt;\n execute();\n };\n\n return {\n canStart,\n canStop,\n canPause,\n canResume,\n start,\n stop,\n pause,\n resume,\n execute,\n };\n}\n\nexport type TimerOptions = {\n /\n 是否在定时器开始时立即执行回调\n /\n leading?: boolean;\n /\n 是否在定时器停止时执行最后一次回调\n /\n trailing?: boolean;\n};\n\n/\n 创建一个基于 `setTimeout` 的间隔定时器\n \n @param callback - 每次间隔执行的回调函数，接收定时器状态和可选的 `next` 函数\n * @param interval - 间隔时间，单位为毫秒\n * @param options - 配置选项\n * @returns {TimerHandler}\n */\nexport function timeInterval(\n callback: (state: TimerState, next?: () => void) => unknown,\n interval: number,\n options?: TimerOptions,\n): TimerHandler {\n let timeId: number \| NodeJS.Timeout;\n const { canStart, canStop, canPause, canResume, start, stop, pause, resume, execute } = makeInterval((call) => {\n timeId = setTimeout(call, interval);\n }, callback);\n\n return {\n start() {\n if (!canStart()) return;\n\n if (options?.leading) {\n start();\n } else {\n timeId = setTimeout(start, interval);\n }\n },\n\n stop() {\n if (!canStop()) return;\n if (options?.trailing) execute();\n\n clearTimeout(timeId);\n stop();\n },\n\n pause() {\n if (!canPause()) return;\n if (options?.trailing) execute();\n\n clearTimeout(timeId);\n pause();\n },\n\n resume(immediate?: boolean) {\n if (!canResume()) return;\n\n if (immediate \|\| options?.leading) {\n resume();\n } else {\n timeId = setTimeout(resume, interval);\n }\n },\n };\n}\n"],"names":[],"mappings":";;AA6DA,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,cAAc;AASJ,SAAA,aACd,UACA,QACA;AACA,MAAI,UAAU;AACd,MAAI,SAAS;AACb,MAAI,SAAS;AACb,MAAI,UAAU;AACd,MAAI,WAAW;AACf,MAAI,QAAQ;AACZ,MAAI,SAAS;AACb,MAAI,cAAc;AAElB,QAAM,UAAU,MAAM;AACpB,QAAI,UAAU,aAAc;AAEtB,UAAA,MAAM,KAAK,IAAI;AACrB,UAAM,eAAe,SAAS,IAAI,MAAM,SAAS;AAClC,mBAAA;AACN,aAAA;AACT,UAAM,QAAoB;AAAA,MACxB,OAAO,EAAE;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,aAAa,UAAU,IAAI,MAAM,UAAU;AAAA,MAC3C;AAAA,MACA;AAAA,IACF;AAEI,QAAA,OAAO,WAAW,GAAG;AACvB,aAAO,OAAO,MAAM;AAClB,iBAAS,OAAO;AAAA,MAAA,CACjB;AAAA,IAAA,OACI;AACL,aAAO,KAAK;AACZ,eAAS,OAAO;AAAA,IAAA;AAAA,EAEpB;AAEM,QAAA,WAAW,MAAM,WAAW;AAClC,QAAM,QAAQ,MAAM;AACd,QAAA,CAAC,WAAY;AACR,aAAA;AACT,cAAU,KAAK,IAAI;AACX,YAAA;AAAA,EACV;AAEM,QAAA,UAAU,MAAM,WAAW;AACjC,QAAM,OAAO,MAAM;AACb,QAAA,CAAC,UAAW;AACP,aAAA;AACT,aAAS,KAAK,IAAI;AAAA,EACpB;AAEM,QAAA,WAAW,MAAM,WAAW;AAClC,QAAM,QAAQ,MAAM;AACd,QAAA,CAAC,WAAY;AACR,aAAA;AACT,cAAU,KAAK,IAAI;AAAA,EACrB;AAEM,QAAA,YAAY,MAAM,WAAW;AACnC,QAAM,SAAS,MAAM;AACf,QAAA,CAAC,YAAa;AACT,aAAA;AACT,eAAW,KAAK,IAAI;AACX,aAAA;AACD,YAAA;AAAA,EACV;AAEO,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAqBgB,SAAA,aACd,UACA,UACA,SACc;AACV,MAAA;AACJ,QAAM,EAAE,UAAU,SAAS,UAAU,WAAW,OAAO,MAAM,OAAO,QAAQ,QAAY,IAAA,aAAa,CAAC,SAAS;AACpG,aAAA,WAAW,MAAM,QAAQ;AAAA,KACjC,QAAQ;AAEJ,SAAA;AAAA,IACL,QAAQ;AACF,UAAA,CAAC,WAAY;AAEjB,UAAI,SAAS,SAAS;AACd,cAAA;AAAA,MAAA,OACD;AACI,iBAAA,WAAW,OAAO,QAAQ;AAAA,MAAA;AAAA,IAEvC;AAAA,IAEA,OAAO;AACD,UAAA,CAAC,UAAW;AACZ,UAAA,SAAS,SAAkB,SAAA;AAE/B,mBAAa,MAAM;AACd,WAAA;AAAA,IACP;AAAA,IAEA,QAAQ;AACF,UAAA,CAAC,WAAY;AACb,UAAA,SAAS,SAAkB,SAAA;AAE/B,mBAAa,MAAM;AACb,YAAA;AAAA,IACR;AAAA,IAEA,OAAO,WAAqB;AACtB,UAAA,CAAC,YAAa;AAEd,UAAA,aAAa,SAAS,SAAS;AAC1B,eAAA;AAAA,MAAA,OACF;AACI,iBAAA,WAAW,QAAQ,QAAQ;AAAA,MAAA;AAAA,IACtC;AAAA,EAEJ;AACF;;;"}

package/dist/timer.mjs CHANGED Viewed

@@ -84,7 +84,7 @@ function timeInterval(callback, interval, options) {
   return {
     start() {
       if (!canStart()) return;
-      if (options == null ? void 0 : options.leading) {
+      if (options?.leading) {
         start();
       } else {
         timeId = setTimeout(start, interval);
@@ -92,19 +92,19 @@ function timeInterval(callback, interval, options) {
     },
     stop() {
       if (!canStop()) return;
-      if (options == null ? void 0 : options.trailing) execute();
+      if (options?.trailing) execute();
       clearTimeout(timeId);
       stop();
     },
     pause() {
       if (!canPause()) return;
-      if (options == null ? void 0 : options.trailing) execute();
+      if (options?.trailing) execute();
       clearTimeout(timeId);
       pause();
     },
     resume(immediate) {
       if (!canResume()) return;
-      if (immediate || (options == null ? void 0 : options.leading)) {
+      if (immediate || options?.leading) {
         resume();
       } else {
         timeId = setTimeout(resume, interval);

package/dist/timer.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"timer.mjs","sources":["../src/timer.ts"],"sourcesContent":["/*\n 定时器状态接口\n /\nexport type TimerState = {\n /\n 执行次数\n /\n times: number;\n /\n 开始时间戳\n /\n startAt: number;\n /\n 停止时间戳\n /\n stopAt: number;\n /\n 暂停时间戳\n /\n pauseAt: number;\n /\n 恢复时间戳\n /\n resumeAt: number;\n /\n 当前时间戳\n /\n currentAt: number;\n /\n 总耗时（包括暂停时间）\n /\n elapsedTime: number;\n /\n 实际运行时间（不包括暂停时间）\n /\n runningTime: number;\n /\n 当前间隔时间\n /\n intervalTime: number;\n};\n\nexport type TimerHandler = {\n /\n 开始\n /\n start: () => void;\n /\n 暂停\n /\n pause: () => void;\n /\n 恢复\n /\n resume: (immediate?: boolean) => void;\n /\n 停止\n /\n stop: () => void;\n};\n\nconst STATUS_READY = 0;\nconst STATUS_START = 1;\nconst STATUS_PAUSE = 2;\nconst STATUS_STOP = 3;\n\n/\n 创建间隔定时器核心函数\n \n @param nextTime - 用于安排下一次执行的函数\n * @param effect - 每次执行的回调函数，接收定时器状态和可选的next函数\n * @returns 返回包含控制方法的对象\n /\nexport function makeInterval(\n nextTime: (call: () => void) => void,\n effect: (timer: TimerState, next?: () => void) => unknown,\n) {\n let startAt = 0;\n let lastAt = 0;\n let stopAt = 0;\n let pauseAt = 0;\n let resumeAt = 0;\n let times = 0;\n let status = STATUS_READY;\n let runningTime = 0;\n\n const execute = () => {\n if (status >= STATUS_PAUSE) return;\n\n const now = Date.now();\n const intervalTime = lastAt > 0 ? now - lastAt : 0;\n runningTime += intervalTime;\n lastAt = now;\n const state: TimerState = {\n times: ++times,\n startAt,\n stopAt,\n pauseAt,\n resumeAt,\n currentAt: now,\n elapsedTime: startAt > 0 ? now - startAt : 0,\n runningTime,\n intervalTime,\n };\n\n if (effect.length === 2) {\n effect(state, () => {\n nextTime(execute);\n });\n } else {\n effect(state);\n nextTime(execute);\n }\n };\n\n const canStart = () => status === STATUS_READY;\n const start = () => {\n if (!canStart()) return;\n status = STATUS_START;\n startAt = Date.now();\n execute();\n };\n\n const canStop = () => status === STATUS_START;\n const stop = () => {\n if (!canStop()) return;\n status = STATUS_STOP;\n stopAt = Date.now();\n };\n\n const canPause = () => status === STATUS_START;\n const pause = () => {\n if (!canPause()) return;\n status = STATUS_PAUSE;\n pauseAt = Date.now();\n };\n\n const canResume = () => status === STATUS_PAUSE;\n const resume = () => {\n if (!canResume()) return;\n status = STATUS_START;\n resumeAt = Date.now();\n lastAt = resumeAt;\n execute();\n };\n\n return {\n canStart,\n canStop,\n canPause,\n canResume,\n start,\n stop,\n pause,\n resume,\n execute,\n };\n}\n\nexport type TimerOptions = {\n /\n 是否在定时器开始时立即执行回调\n /\n leading?: boolean;\n /\n 是否在定时器停止时执行最后一次回调\n /\n trailing?: boolean;\n};\n\n/\n 创建一个基于 `setTimeout` 的间隔定时器\n \n @param callback - 每次间隔执行的回调函数，接收定时器状态和可选的 `next` 函数\n * @param interval - 间隔时间，单位为毫秒\n * @param options - 配置选项\n * @returns {TimerHandler}\n */\nexport function timeInterval(\n callback: (state: TimerState, next?: () => void) => unknown,\n interval: number,\n options?: TimerOptions,\n): TimerHandler {\n let timeId: number \| NodeJS.Timeout;\n const { canStart, canStop, canPause, canResume, start, stop, pause, resume, execute } = makeInterval((call) => {\n timeId = setTimeout(call, interval);\n }, callback);\n\n return {\n start() {\n if (!canStart()) return;\n\n if (options?.leading) {\n start();\n } else {\n timeId = setTimeout(start, interval);\n }\n },\n\n stop() {\n if (!canStop()) return;\n if (options?.trailing) execute();\n\n clearTimeout(timeId);\n stop();\n },\n\n pause() {\n if (!canPause()) return;\n if (options?.trailing) execute();\n\n clearTimeout(timeId);\n pause();\n },\n\n resume(immediate?: boolean) {\n if (!canResume()) return;\n\n if (immediate \|\| options?.leading) {\n resume();\n } else {\n timeId = setTimeout(resume, interval);\n }\n },\n };\n}\n"],"names":[],"mappings":"AA6DA,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,cAAc;AASJ,SAAA,aACd,UACA,QACA;AACA,MAAI,UAAU;AACd,MAAI,SAAS;AACb,MAAI,SAAS;AACb,MAAI,UAAU;AACd,MAAI,WAAW;AACf,MAAI,QAAQ;AACZ,MAAI,SAAS;AACb,MAAI,cAAc;AAElB,QAAM,UAAU,MAAM;AACpB,QAAI,UAAU,aAAc;AAEtB,UAAA,MAAM,KAAK,IAAI;AACrB,UAAM,eAAe,SAAS,IAAI,MAAM,SAAS;AAClC,mBAAA;AACN,aAAA;AACT,UAAM,QAAoB;AAAA,MACxB,OAAO,EAAE;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,aAAa,UAAU,IAAI,MAAM,UAAU;AAAA,MAC3C;AAAA,MACA;AAAA,IACF;AAEI,QAAA,OAAO,WAAW,GAAG;AACvB,aAAO,OAAO,MAAM;AAClB,iBAAS,OAAO;AAAA,MAAA,CACjB;AAAA,IAAA,OACI;AACL,aAAO,KAAK;AACZ,eAAS,OAAO;AAAA,IAAA;AAAA,EAEpB;AAEM,QAAA,WAAW,MAAM,WAAW;AAClC,QAAM,QAAQ,MAAM;AACd,QAAA,CAAC,WAAY;AACR,aAAA;AACT,cAAU,KAAK,IAAI;AACX,YAAA;AAAA,EACV;AAEM,QAAA,UAAU,MAAM,WAAW;AACjC,QAAM,OAAO,MAAM;AACb,QAAA,CAAC,UAAW;AACP,aAAA;AACT,aAAS,KAAK,IAAI;AAAA,EACpB;AAEM,QAAA,WAAW,MAAM,WAAW;AAClC,QAAM,QAAQ,MAAM;AACd,QAAA,CAAC,WAAY;AACR,aAAA;AACT,cAAU,KAAK,IAAI;AAAA,EACrB;AAEM,QAAA,YAAY,MAAM,WAAW;AACnC,QAAM,SAAS,MAAM;AACf,QAAA,CAAC,YAAa;AACT,aAAA;AACT,eAAW,KAAK,IAAI;AACX,aAAA;AACD,YAAA;AAAA,EACV;AAEO,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAqBgB,SAAA,aACd,UACA,UACA,SACc;AACV,MAAA;AACJ,QAAM,EAAE,UAAU,SAAS,UAAU,WAAW,OAAO,MAAM,OAAO,QAAQ,QAAY,IAAA,aAAa,CAAC,SAAS;AACpG,aAAA,WAAW,MAAM,QAAQ;AAAA,KACjC,QAAQ;AAEJ,SAAA;AAAA,IACL,QAAQ;AACF,UAAA,CAAC,WAAY;AAEjB,UAAI,~~mCAAS~~,SAAS;AACd,cAAA;AAAA,MAAA,OACD;AACI,iBAAA,WAAW,OAAO,QAAQ;AAAA,MAAA;AAAA,IAEvC;AAAA,IAEA,OAAO;AACD,UAAA,CAAC,UAAW;AACZ,UAAA,~~mCAAS~~,SAAkB,SAAA;AAE/B,mBAAa,MAAM;AACd,WAAA;AAAA,IACP;AAAA,IAEA,QAAQ;AACF,UAAA,CAAC,WAAY;AACb,UAAA,~~mCAAS~~,SAAkB,SAAA;AAE/B,mBAAa,MAAM;AACb,YAAA;AAAA,IACR;AAAA,IAEA,OAAO,WAAqB;AACtB,UAAA,CAAC,YAAa;AAEd,UAAA,~~cAAa~~,~~mCAAS~~,~~UAAS~~;AAC1B,eAAA;AAAA,MAAA,OACF;AACI,iBAAA,WAAW,QAAQ,QAAQ;AAAA,MAAA;AAAA,IACtC;AAAA,EAEJ;AACF;"}
1	+ {"version":3,"file":"timer.mjs","sources":["../src/timer.ts"],"sourcesContent":["/*\n 定时器状态接口\n /\nexport type TimerState = {\n /\n 执行次数\n /\n times: number;\n /\n 开始时间戳\n /\n startAt: number;\n /\n 停止时间戳\n /\n stopAt: number;\n /\n 暂停时间戳\n /\n pauseAt: number;\n /\n 恢复时间戳\n /\n resumeAt: number;\n /\n 当前时间戳\n /\n currentAt: number;\n /\n 总耗时（包括暂停时间）\n /\n elapsedTime: number;\n /\n 实际运行时间（不包括暂停时间）\n /\n runningTime: number;\n /\n 当前间隔时间\n /\n intervalTime: number;\n};\n\nexport type TimerHandler = {\n /\n 开始\n /\n start: () => void;\n /\n 暂停\n /\n pause: () => void;\n /\n 恢复\n /\n resume: (immediate?: boolean) => void;\n /\n 停止\n /\n stop: () => void;\n};\n\nconst STATUS_READY = 0;\nconst STATUS_START = 1;\nconst STATUS_PAUSE = 2;\nconst STATUS_STOP = 3;\n\n/\n 创建间隔定时器核心函数\n \n @param nextTime - 用于安排下一次执行的函数\n * @param effect - 每次执行的回调函数，接收定时器状态和可选的next函数\n * @returns 返回包含控制方法的对象\n /\nexport function makeInterval(\n nextTime: (call: () => void) => void,\n effect: (timer: TimerState, next?: () => void) => unknown,\n) {\n let startAt = 0;\n let lastAt = 0;\n let stopAt = 0;\n let pauseAt = 0;\n let resumeAt = 0;\n let times = 0;\n let status = STATUS_READY;\n let runningTime = 0;\n\n const execute = () => {\n if (status >= STATUS_PAUSE) return;\n\n const now = Date.now();\n const intervalTime = lastAt > 0 ? now - lastAt : 0;\n runningTime += intervalTime;\n lastAt = now;\n const state: TimerState = {\n times: ++times,\n startAt,\n stopAt,\n pauseAt,\n resumeAt,\n currentAt: now,\n elapsedTime: startAt > 0 ? now - startAt : 0,\n runningTime,\n intervalTime,\n };\n\n if (effect.length === 2) {\n effect(state, () => {\n nextTime(execute);\n });\n } else {\n effect(state);\n nextTime(execute);\n }\n };\n\n const canStart = () => status === STATUS_READY;\n const start = () => {\n if (!canStart()) return;\n status = STATUS_START;\n startAt = Date.now();\n execute();\n };\n\n const canStop = () => status === STATUS_START;\n const stop = () => {\n if (!canStop()) return;\n status = STATUS_STOP;\n stopAt = Date.now();\n };\n\n const canPause = () => status === STATUS_START;\n const pause = () => {\n if (!canPause()) return;\n status = STATUS_PAUSE;\n pauseAt = Date.now();\n };\n\n const canResume = () => status === STATUS_PAUSE;\n const resume = () => {\n if (!canResume()) return;\n status = STATUS_START;\n resumeAt = Date.now();\n lastAt = resumeAt;\n execute();\n };\n\n return {\n canStart,\n canStop,\n canPause,\n canResume,\n start,\n stop,\n pause,\n resume,\n execute,\n };\n}\n\nexport type TimerOptions = {\n /\n 是否在定时器开始时立即执行回调\n /\n leading?: boolean;\n /\n 是否在定时器停止时执行最后一次回调\n /\n trailing?: boolean;\n};\n\n/\n 创建一个基于 `setTimeout` 的间隔定时器\n \n @param callback - 每次间隔执行的回调函数，接收定时器状态和可选的 `next` 函数\n * @param interval - 间隔时间，单位为毫秒\n * @param options - 配置选项\n * @returns {TimerHandler}\n */\nexport function timeInterval(\n callback: (state: TimerState, next?: () => void) => unknown,\n interval: number,\n options?: TimerOptions,\n): TimerHandler {\n let timeId: number \| NodeJS.Timeout;\n const { canStart, canStop, canPause, canResume, start, stop, pause, resume, execute } = makeInterval((call) => {\n timeId = setTimeout(call, interval);\n }, callback);\n\n return {\n start() {\n if (!canStart()) return;\n\n if (options?.leading) {\n start();\n } else {\n timeId = setTimeout(start, interval);\n }\n },\n\n stop() {\n if (!canStop()) return;\n if (options?.trailing) execute();\n\n clearTimeout(timeId);\n stop();\n },\n\n pause() {\n if (!canPause()) return;\n if (options?.trailing) execute();\n\n clearTimeout(timeId);\n pause();\n },\n\n resume(immediate?: boolean) {\n if (!canResume()) return;\n\n if (immediate \|\| options?.leading) {\n resume();\n } else {\n timeId = setTimeout(resume, interval);\n }\n },\n };\n}\n"],"names":[],"mappings":"AA6DA,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,cAAc;AASJ,SAAA,aACd,UACA,QACA;AACA,MAAI,UAAU;AACd,MAAI,SAAS;AACb,MAAI,SAAS;AACb,MAAI,UAAU;AACd,MAAI,WAAW;AACf,MAAI,QAAQ;AACZ,MAAI,SAAS;AACb,MAAI,cAAc;AAElB,QAAM,UAAU,MAAM;AACpB,QAAI,UAAU,aAAc;AAEtB,UAAA,MAAM,KAAK,IAAI;AACrB,UAAM,eAAe,SAAS,IAAI,MAAM,SAAS;AAClC,mBAAA;AACN,aAAA;AACT,UAAM,QAAoB;AAAA,MACxB,OAAO,EAAE;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,aAAa,UAAU,IAAI,MAAM,UAAU;AAAA,MAC3C;AAAA,MACA;AAAA,IACF;AAEI,QAAA,OAAO,WAAW,GAAG;AACvB,aAAO,OAAO,MAAM;AAClB,iBAAS,OAAO;AAAA,MAAA,CACjB;AAAA,IAAA,OACI;AACL,aAAO,KAAK;AACZ,eAAS,OAAO;AAAA,IAAA;AAAA,EAEpB;AAEM,QAAA,WAAW,MAAM,WAAW;AAClC,QAAM,QAAQ,MAAM;AACd,QAAA,CAAC,WAAY;AACR,aAAA;AACT,cAAU,KAAK,IAAI;AACX,YAAA;AAAA,EACV;AAEM,QAAA,UAAU,MAAM,WAAW;AACjC,QAAM,OAAO,MAAM;AACb,QAAA,CAAC,UAAW;AACP,aAAA;AACT,aAAS,KAAK,IAAI;AAAA,EACpB;AAEM,QAAA,WAAW,MAAM,WAAW;AAClC,QAAM,QAAQ,MAAM;AACd,QAAA,CAAC,WAAY;AACR,aAAA;AACT,cAAU,KAAK,IAAI;AAAA,EACrB;AAEM,QAAA,YAAY,MAAM,WAAW;AACnC,QAAM,SAAS,MAAM;AACf,QAAA,CAAC,YAAa;AACT,aAAA;AACT,eAAW,KAAK,IAAI;AACX,aAAA;AACD,YAAA;AAAA,EACV;AAEO,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAqBgB,SAAA,aACd,UACA,UACA,SACc;AACV,MAAA;AACJ,QAAM,EAAE,UAAU,SAAS,UAAU,WAAW,OAAO,MAAM,OAAO,QAAQ,QAAY,IAAA,aAAa,CAAC,SAAS;AACpG,aAAA,WAAW,MAAM,QAAQ;AAAA,KACjC,QAAQ;AAEJ,SAAA;AAAA,IACL,QAAQ;AACF,UAAA,CAAC,WAAY;AAEjB,UAAI,SAAS,SAAS;AACd,cAAA;AAAA,MAAA,OACD;AACI,iBAAA,WAAW,OAAO,QAAQ;AAAA,MAAA;AAAA,IAEvC;AAAA,IAEA,OAAO;AACD,UAAA,CAAC,UAAW;AACZ,UAAA,SAAS,SAAkB,SAAA;AAE/B,mBAAa,MAAM;AACd,WAAA;AAAA,IACP;AAAA,IAEA,QAAQ;AACF,UAAA,CAAC,WAAY;AACb,UAAA,SAAS,SAAkB,SAAA;AAE/B,mBAAa,MAAM;AACb,YAAA;AAAA,IACR;AAAA,IAEA,OAAO,WAAqB;AACtB,UAAA,CAAC,YAAa;AAEd,UAAA,aAAa,SAAS,SAAS;AAC1B,eAAA;AAAA,MAAA,OACF;AACI,iBAAA,WAAW,QAAQ,QAAQ;AAAA,MAAA;AAAA,IACtC;AAAA,EAEJ;AACF;"}

package/dist/types.d.ts CHANGED Viewed

@@ -62,4 +62,31 @@ export type LowercaseStartString = `${'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' |
  * 以大写字母开头的字符串类型
  */
 export type UppercaseStartString = `${'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z'}${string}`;
+/**
+ * 判断是否是空对象
+ * @example
+ * ```typescript
+ * type Result = IsEmptyObject<{}>; // true
+ * type Result2 = IsEmptyObject<{ a: 1 }>; // false
+ * ```
+ */
+export type IsEmptyObject<T> = keyof T extends never ? true : false;
+/**
+ * 判断对象是否只有一个属性
+ * @example
+ * ```typescript
+ * type Result = IsOnlyProperty<{ a: 1 }, 'a'>; // true
+ * type Result2 = IsOnlyProperty<{ a: 1, b: 2 }, 'a'>; // false
+ * ```
+ */
+export type IsOnlyProperty<T, P> = keyof T extends P ? true : false;
+/**
+ * 判断对象是否具有指定属性
+ * @example
+ * ```typescript
+ * type Result = HasProperty<{ a: 1, b: 2 }, 'a'>; // true
+ * type Result2 = HasProperty<{ a: 1, b: 2 }, 'c'>; // false
+ * ```
+ */
+export type HasProperty<T, K> = K extends keyof T ? true : false;
 export {};

package/dist/url.cjs CHANGED Viewed

@@ -6,18 +6,18 @@ function urlParse(url) {
     result = new globalThis.URL(url);
   } catch (e) {
   }
-  const protocol = (result == null ? void 0 : result.protocol) || "";
-  const host = (result == null ? void 0 : result.host) || "";
+  const protocol = result?.protocol || "";
+  const host = result?.host || "";
   return {
     protocol,
     host,
-    hostname: (result == null ? void 0 : result.hostname) || "",
-    port: (result == null ? void 0 : result.port) || "",
-    pathname: (result == null ? void 0 : result.pathname) || "",
-    search: (result == null ? void 0 : result.search) || "",
-    hash: (result == null ? void 0 : result.hash) || "",
-    username: (result == null ? void 0 : result.username) || "",
-    password: (result == null ? void 0 : result.password) || ""
+    hostname: result?.hostname || "",
+    port: result?.port || "",
+    pathname: result?.pathname || "",
+    search: result?.search || "",
+    hash: result?.hash || "",
+    username: result?.username || "",
+    password: result?.password || ""
   };
 }
 function urlStringify(url) {

package/dist/url.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"url.cjs","sources":["../src/url.ts"],"sourcesContent":["/*\n URL 元信息\n /\nexport type UrlMeta = {\n /\n 协议部分，包含冒号，例如 \"https:\"。\n /\n protocol: string;\n /\n 主机部分，包括主机名和端口。\n /\n host: string;\n /\n 主机名部分。\n /\n hostname: string;\n /\n 端口部分。\n /\n port: string;\n /\n 路径部分。\n /\n pathname: string;\n /\n 查询字符串部分。\n /\n search: string;\n /\n 哈希部分。\n /\n hash: string;\n /\n 用户名部分。\n /\n username: string;\n /\n 密码部分。\n /\n password: string;\n};\n\n/\n 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n /\nexport function urlParse(url: string): UrlMeta {\n let result: URL \| null = null;\n\n try {\n // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n // 例如在 uni-app、微信小程序等运行环境。\n result = new globalThis.URL(url);\n } catch (e) {\n // ignore\n }\n\n const protocol = result?.protocol \|\| '';\n const host = result?.host \|\| '';\n\n return {\n protocol,\n host,\n hostname: result?.hostname \|\| '',\n port: result?.port \|\| '',\n pathname: result?.pathname \|\| '',\n search: result?.search \|\| '',\n hash: result?.hash \|\| '',\n username: result?.username \|\| '',\n password: result?.password \|\| '',\n };\n}\n\n/\n 将 UrlMeta 对象转换回 URL 字符串。\n * @param url - 需要转换的 UrlMeta 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: UrlMeta) {\n const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n return [\n protocol ? `${protocol}//` : '',\n username && password ? `${username}:${password}@` : '',\n hostname,\n port ? `:${port}` : '',\n pathname,\n search,\n hash,\n ]\n .filter(Boolean)\n .join('');\n}\n"],"names":[],"mappings":";;AA+CO,SAAS,SAAS,KAAsB;AAC7C,MAAI,SAAqB;AAErB,MAAA;AAGO,aAAA,IAAI,WAAW,IAAI,GAAG;AAAA,WACxB,GAAG;AAAA,EAAA;AAIN,QAAA,~~YAAW~~,~~iCAAQ~~,~~aAAY~~;AAC/B,QAAA,~~QAAO~~,~~iCAAQ~~,~~SAAQ~~;AAEtB,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA,~~WAAU~~,~~iCAAQ~~,~~aAAY~~;AAAA,IAC9B,~~OAAM~~,~~iCAAQ~~,~~SAAQ~~;AAAA,IACtB,~~WAAU~~,~~iCAAQ~~,~~aAAY~~;AAAA,IAC9B,~~SAAQ~~,~~iCAAQ~~,~~WAAU~~;AAAA,IAC1B,~~OAAM~~,~~iCAAQ~~,~~SAAQ~~;AAAA,IACtB,~~WAAU~~,~~iCAAQ~~,~~aAAY~~;AAAA,IAC9B,~~WAAU~~,~~iCAAQ~~,~~aAAY~~;AAAA,EAChC;AACF;AAOO,SAAS,aAAa,KAAc;AACnC,QAAA,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,SAAA,IAAa;AAC1E,SAAA;AAAA,IACL,WAAW,GAAG,QAAQ,OAAO;AAAA,IAC7B,YAAY,WAAW,GAAG,QAAQ,IAAI,QAAQ,MAAM;AAAA,IACpD;AAAA,IACA,OAAO,IAAI,IAAI,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,EAEC,EAAA,OAAO,OAAO,EACd,KAAK,EAAE;AACZ;;;"}
1	+ {"version":3,"file":"url.cjs","sources":["../src/url.ts"],"sourcesContent":["/*\n URL 元信息\n /\nexport type UrlMeta = {\n /\n 协议部分，包含冒号，例如 \"https:\"。\n /\n protocol: string;\n /\n 主机部分，包括主机名和端口。\n /\n host: string;\n /\n 主机名部分。\n /\n hostname: string;\n /\n 端口部分。\n /\n port: string;\n /\n 路径部分。\n /\n pathname: string;\n /\n 查询字符串部分。\n /\n search: string;\n /\n 哈希部分。\n /\n hash: string;\n /\n 用户名部分。\n /\n username: string;\n /\n 密码部分。\n /\n password: string;\n};\n\n/\n 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n /\nexport function urlParse(url: string): UrlMeta {\n let result: URL \| null = null;\n\n try {\n // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n // 例如在 uni-app、微信小程序等运行环境。\n result = new globalThis.URL(url);\n } catch (e) {\n // ignore\n }\n\n const protocol = result?.protocol \|\| '';\n const host = result?.host \|\| '';\n\n return {\n protocol,\n host,\n hostname: result?.hostname \|\| '',\n port: result?.port \|\| '',\n pathname: result?.pathname \|\| '',\n search: result?.search \|\| '',\n hash: result?.hash \|\| '',\n username: result?.username \|\| '',\n password: result?.password \|\| '',\n };\n}\n\n/\n 将 UrlMeta 对象转换回 URL 字符串。\n * @param url - 需要转换的 UrlMeta 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: UrlMeta) {\n const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n return [\n protocol ? `${protocol}//` : '',\n username && password ? `${username}:${password}@` : '',\n hostname,\n port ? `:${port}` : '',\n pathname,\n search,\n hash,\n ]\n .filter(Boolean)\n .join('');\n}\n"],"names":[],"mappings":";;AA+CO,SAAS,SAAS,KAAsB;AAC7C,MAAI,SAAqB;AAErB,MAAA;AAGO,aAAA,IAAI,WAAW,IAAI,GAAG;AAAA,WACxB,GAAG;AAAA,EAAA;AAIN,QAAA,WAAW,QAAQ,YAAY;AAC/B,QAAA,OAAO,QAAQ,QAAQ;AAEtB,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,QAAQ,YAAY;AAAA,IAC9B,MAAM,QAAQ,QAAQ;AAAA,IACtB,UAAU,QAAQ,YAAY;AAAA,IAC9B,QAAQ,QAAQ,UAAU;AAAA,IAC1B,MAAM,QAAQ,QAAQ;AAAA,IACtB,UAAU,QAAQ,YAAY;AAAA,IAC9B,UAAU,QAAQ,YAAY;AAAA,EAChC;AACF;AAOO,SAAS,aAAa,KAAc;AACnC,QAAA,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,SAAA,IAAa;AAC1E,SAAA;AAAA,IACL,WAAW,GAAG,QAAQ,OAAO;AAAA,IAC7B,YAAY,WAAW,GAAG,QAAQ,IAAI,QAAQ,MAAM;AAAA,IACpD;AAAA,IACA,OAAO,IAAI,IAAI,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,EAEC,EAAA,OAAO,OAAO,EACd,KAAK,EAAE;AACZ;;;"}

package/dist/url.mjs CHANGED Viewed

@@ -4,18 +4,18 @@ function urlParse(url) {
     result = new globalThis.URL(url);
   } catch (e) {
   }
-  const protocol = (result == null ? void 0 : result.protocol) || "";
-  const host = (result == null ? void 0 : result.host) || "";
+  const protocol = result?.protocol || "";
+  const host = result?.host || "";
   return {
     protocol,
     host,
-    hostname: (result == null ? void 0 : result.hostname) || "",
-    port: (result == null ? void 0 : result.port) || "",
-    pathname: (result == null ? void 0 : result.pathname) || "",
-    search: (result == null ? void 0 : result.search) || "",
-    hash: (result == null ? void 0 : result.hash) || "",
-    username: (result == null ? void 0 : result.username) || "",
-    password: (result == null ? void 0 : result.password) || ""
+    hostname: result?.hostname || "",
+    port: result?.port || "",
+    pathname: result?.pathname || "",
+    search: result?.search || "",
+    hash: result?.hash || "",
+    username: result?.username || "",
+    password: result?.password || ""
   };
 }
 function urlStringify(url) {

package/dist/url.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"url.mjs","sources":["../src/url.ts"],"sourcesContent":["/*\n URL 元信息\n /\nexport type UrlMeta = {\n /\n 协议部分，包含冒号，例如 \"https:\"。\n /\n protocol: string;\n /\n 主机部分，包括主机名和端口。\n /\n host: string;\n /\n 主机名部分。\n /\n hostname: string;\n /\n 端口部分。\n /\n port: string;\n /\n 路径部分。\n /\n pathname: string;\n /\n 查询字符串部分。\n /\n search: string;\n /\n 哈希部分。\n /\n hash: string;\n /\n 用户名部分。\n /\n username: string;\n /\n 密码部分。\n /\n password: string;\n};\n\n/\n 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n /\nexport function urlParse(url: string): UrlMeta {\n let result: URL \| null = null;\n\n try {\n // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n // 例如在 uni-app、微信小程序等运行环境。\n result = new globalThis.URL(url);\n } catch (e) {\n // ignore\n }\n\n const protocol = result?.protocol \|\| '';\n const host = result?.host \|\| '';\n\n return {\n protocol,\n host,\n hostname: result?.hostname \|\| '',\n port: result?.port \|\| '',\n pathname: result?.pathname \|\| '',\n search: result?.search \|\| '',\n hash: result?.hash \|\| '',\n username: result?.username \|\| '',\n password: result?.password \|\| '',\n };\n}\n\n/\n 将 UrlMeta 对象转换回 URL 字符串。\n * @param url - 需要转换的 UrlMeta 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: UrlMeta) {\n const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n return [\n protocol ? `${protocol}//` : '',\n username && password ? `${username}:${password}@` : '',\n hostname,\n port ? `:${port}` : '',\n pathname,\n search,\n hash,\n ]\n .filter(Boolean)\n .join('');\n}\n"],"names":[],"mappings":"AA+CO,SAAS,SAAS,KAAsB;AAC7C,MAAI,SAAqB;AAErB,MAAA;AAGO,aAAA,IAAI,WAAW,IAAI,GAAG;AAAA,WACxB,GAAG;AAAA,EAAA;AAIN,QAAA,~~YAAW~~,~~iCAAQ~~,~~aAAY~~;AAC/B,QAAA,~~QAAO~~,~~iCAAQ~~,~~SAAQ~~;AAEtB,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA,~~WAAU~~,~~iCAAQ~~,~~aAAY~~;AAAA,IAC9B,~~OAAM~~,~~iCAAQ~~,~~SAAQ~~;AAAA,IACtB,~~WAAU~~,~~iCAAQ~~,~~aAAY~~;AAAA,IAC9B,~~SAAQ~~,~~iCAAQ~~,~~WAAU~~;AAAA,IAC1B,~~OAAM~~,~~iCAAQ~~,~~SAAQ~~;AAAA,IACtB,~~WAAU~~,~~iCAAQ~~,~~aAAY~~;AAAA,IAC9B,~~WAAU~~,~~iCAAQ~~,~~aAAY~~;AAAA,EAChC;AACF;AAOO,SAAS,aAAa,KAAc;AACnC,QAAA,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,SAAA,IAAa;AAC1E,SAAA;AAAA,IACL,WAAW,GAAG,QAAQ,OAAO;AAAA,IAC7B,YAAY,WAAW,GAAG,QAAQ,IAAI,QAAQ,MAAM;AAAA,IACpD;AAAA,IACA,OAAO,IAAI,IAAI,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,EAEC,EAAA,OAAO,OAAO,EACd,KAAK,EAAE;AACZ;"}
1	+ {"version":3,"file":"url.mjs","sources":["../src/url.ts"],"sourcesContent":["/*\n URL 元信息\n /\nexport type UrlMeta = {\n /\n 协议部分，包含冒号，例如 \"https:\"。\n /\n protocol: string;\n /\n 主机部分，包括主机名和端口。\n /\n host: string;\n /\n 主机名部分。\n /\n hostname: string;\n /\n 端口部分。\n /\n port: string;\n /\n 路径部分。\n /\n pathname: string;\n /\n 查询字符串部分。\n /\n search: string;\n /\n 哈希部分。\n /\n hash: string;\n /\n 用户名部分。\n /\n username: string;\n /\n 密码部分。\n /\n password: string;\n};\n\n/\n 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n /\nexport function urlParse(url: string): UrlMeta {\n let result: URL \| null = null;\n\n try {\n // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n // 例如在 uni-app、微信小程序等运行环境。\n result = new globalThis.URL(url);\n } catch (e) {\n // ignore\n }\n\n const protocol = result?.protocol \|\| '';\n const host = result?.host \|\| '';\n\n return {\n protocol,\n host,\n hostname: result?.hostname \|\| '',\n port: result?.port \|\| '',\n pathname: result?.pathname \|\| '',\n search: result?.search \|\| '',\n hash: result?.hash \|\| '',\n username: result?.username \|\| '',\n password: result?.password \|\| '',\n };\n}\n\n/\n 将 UrlMeta 对象转换回 URL 字符串。\n * @param url - 需要转换的 UrlMeta 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: UrlMeta) {\n const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n return [\n protocol ? `${protocol}//` : '',\n username && password ? `${username}:${password}@` : '',\n hostname,\n port ? `:${port}` : '',\n pathname,\n search,\n hash,\n ]\n .filter(Boolean)\n .join('');\n}\n"],"names":[],"mappings":"AA+CO,SAAS,SAAS,KAAsB;AAC7C,MAAI,SAAqB;AAErB,MAAA;AAGO,aAAA,IAAI,WAAW,IAAI,GAAG;AAAA,WACxB,GAAG;AAAA,EAAA;AAIN,QAAA,WAAW,QAAQ,YAAY;AAC/B,QAAA,OAAO,QAAQ,QAAQ;AAEtB,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,QAAQ,YAAY;AAAA,IAC9B,MAAM,QAAQ,QAAQ;AAAA,IACtB,UAAU,QAAQ,YAAY;AAAA,IAC9B,QAAQ,QAAQ,UAAU;AAAA,IAC1B,MAAM,QAAQ,QAAQ;AAAA,IACtB,UAAU,QAAQ,YAAY;AAAA,IAC9B,UAAU,QAAQ,YAAY;AAAA,EAChC;AACF;AAOO,SAAS,aAAa,KAAc;AACnC,QAAA,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,SAAA,IAAa;AAC1E,SAAA;AAAA,IACL,WAAW,GAAG,QAAQ,OAAO;AAAA,IAC7B,YAAY,WAAW,GAAG,QAAQ,IAAI,QAAQ,MAAM;AAAA,IACpD;AAAA,IACA,OAAO,IAAI,IAAI,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,EAEC,EAAA,OAAO,OAAO,EACd,KAAK,EAAE;AACZ;"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-core",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "cloudcome core utils",
   "engines": {
     "node": ">=22"