@cloudcome/utils-core 1.19.0 → 1.20.0

package/dist/emitter.cjs

@@ -1,98 +1,103 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-class Emitter {
-  #events = /* @__PURE__ */ new Map();
-  /**
-   * 注册事件监听器
-   * @param event - 要监听的事件名称
-   * @param listener - 事件监听器函数
-   * @example
-   * emitter.on('click', (x, y) => {
-   *   console.log(`Clicked at (${x}, ${y})`);
-   * });
-   */
-  on(event, listener) {
-    const listeners = this.#events.get(event);
-    if (listeners) {
-      listeners.add(listener);
-    } else {
-      this.#events.set(event, /* @__PURE__ */ new Set([listener]));
-    }
-  }
-  /**
-   * 注册事件监听器，仅触发一次
-   * @param event - 要监听的事件名称
-   * @param listener - 事件监听器函数
-   * @example
-   * emitter.once('click', (x, y) => {
-   *   console.log(`Clicked at (${x}, ${y})`);
-   * });
-   */
-  once(event, listener) {
-    const onceListener = (...payloads) => {
-      const result = listener(...payloads);
-      this.off(event, onceListener);
-      return result;
-    };
-    this.on(event, onceListener);
-  }
-  /**
-   * 移除事件监听器，有三种使用方式：
-   * 1. 移除特定事件的特定监听器
-   * 2. 移除特定事件的所有监听器
-   * 3. 移除所有事件的所有监听器
-   * @param event - 要移除的事件名称（可选）
-   * @param listener - 要移除的监听器函数（可选）
-   * @example
-   * // 移除特定事件的特定监听器
-   * emitter.off('click', clickHandler);
-   *
-   * // 移除特定事件的所有监听器
-   * emitter.off('click');
-   *
-   * // 移除所有事件的所有监听器
-   * emitter.off();
-   */
-  off(event, listener) {
-    if (event && listener) {
-      this.#offListener(event, listener);
-    } else if (event) {
-      this.#offEvent(event);
-    } else {
-      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);
-    }
-  }
-  /**
-   * 触发指定事件，调用所有注册的监听器
-   * @param event - 要触发的事件名称
-   * @param payloads - 传递给监听器的参数
-   * @remarks
-   * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，
-   * 则后续监听器将不会被执行
-   * @example
-   * emitter.emit('click', 10, 20);
-   */
-  emit(event, ...payloads) {
-    const listeners = this.#events.get(event);
-    if (!listeners) return;
-    for (const listener of [...listeners]) {
-      if (listener(...payloads) === false) {
-        break;
-      }
-    }
-  }
-}
+//#region src/emitter.ts
+/**
+* 事件发射器类，用于管理事件监听和触发
+* @template E - 事件类型映射
+*
+* @example
+* type MyEvents = {
+*   'click': [x: number, y: number];
+*   'change': [value: string];
+* };
+*
+* const emitter = new Emitter<MyEvents>();
+* emitter.on('click', (x, y) => {
+*   console.log(`Clicked at (${x}, ${y})`);
+* });
+* emitter.emit('click', 10, 20);
+*/
+var Emitter = class {
+	#events = /* @__PURE__ */ new Map();
+	/**
+	* 注册事件监听器
+	* @param event - 要监听的事件名称
+	* @param listener - 事件监听器函数
+	* @example
+	* emitter.on('click', (x, y) => {
+	*   console.log(`Clicked at (${x}, ${y})`);
+	* });
+	*/
+	on(event, listener) {
+		const listeners = this.#events.get(event);
+		if (listeners) listeners.add(listener);
+		else this.#events.set(event, new Set([listener]));
+	}
+	/**
+	* 注册事件监听器，仅触发一次
+	* @param event - 要监听的事件名称
+	* @param listener - 事件监听器函数
+	* @example
+	* emitter.once('click', (x, y) => {
+	*   console.log(`Clicked at (${x}, ${y})`);
+	* });
+	*/
+	once(event, listener) {
+		const onceListener = (...payloads) => {
+			const result = listener(...payloads);
+			this.off(event, onceListener);
+			return result;
+		};
+		this.on(event, onceListener);
+	}
+	/**
+	* 移除事件监听器，有三种使用方式：
+	* 1. 移除特定事件的特定监听器
+	* 2. 移除特定事件的所有监听器
+	* 3. 移除所有事件的所有监听器
+	* @param event - 要移除的事件名称（可选）
+	* @param listener - 要移除的监听器函数（可选）
+	* @example
+	* // 移除特定事件的特定监听器
+	* emitter.off('click', clickHandler);
+	*
+	* // 移除特定事件的所有监听器
+	* emitter.off('click');
+	*
+	* // 移除所有事件的所有监听器
+	* emitter.off();
+	*/
+	off(event, listener) {
+		if (event && listener) this.#offListener(event, listener);
+		else if (event) this.#offEvent(event);
+		else 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);
+	}
+	/**
+	* 触发指定事件，调用所有注册的监听器
+	* @param event - 要触发的事件名称
+	* @param payloads - 传递给监听器的参数
+	* @remarks
+	* 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，
+	* 则后续监听器将不会被执行
+	* @example
+	* emitter.emit('click', 10, 20);
+	*/
+	emit(event, ...payloads) {
+		const listeners = this.#events.get(event);
+		if (!listeners) return;
+		for (const listener of [...listeners]) if (listener(...payloads) === false) break;
+	}
+};
+//#endregion
 exports.Emitter = Emitter;
-//# sourceMappingURL=emitter.cjs.map
+
+//# sourceMappingURL=emitter.cjs.map

package/dist/emitter.cjs.map

@@ -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 = Record<string | symbol, unknown[]>> {\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   * @param event - 要监听的事件名称\n   * @param listener - 事件监听器函数\n   * @example\n   * emitter.once('click', (x, y) => {\n   *   console.log(`Clicked at (${x}, ${y})`);\n   * });\n   */\n  once<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n    const onceListener = (...payloads: Parameters<EmitterListener<E, K>>) => {\n      const result = listener(...payloads);\n      this.off(event, onceListener);\n      return result;\n    };\n    this.on(event, onceListener);\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,QAAmE;AAAA,EAC9E,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,EAYF,KAAwB,OAAU,UAAiC;AAC3D,UAAA,eAAe,IAAI,aAAgD;AACjE,YAAA,SAAS,SAAS,GAAG,QAAQ;AAC9B,WAAA,IAAI,OAAO,YAAY;AACrB,aAAA;AAAA,IACT;AACK,SAAA,GAAG,OAAO,YAAY;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoB7B,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;;"}
+{"version":3,"file":"emitter.cjs","names":["#events","#offListener","#offEvent","#offAll"],"sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction } 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> = (\n  ...payloads: E[K]\n) => 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<\n  E extends EmitterMap = Record<string | symbol, unknown[]>,\n> {\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   * @param event - 要监听的事件名称\n   * @param listener - 事件监听器函数\n   * @example\n   * emitter.once('click', (x, y) => {\n   *   console.log(`Clicked at (${x}, ${y})`);\n   * });\n   */\n  once<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n    const onceListener = (...payloads: Parameters<EmitterListener<E, K>>) => {\n      const result = listener(...payloads);\n      this.off(event, onceListener);\n      return result;\n    };\n    this.on(event, onceListener);\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>(\n    event: K,\n    ...payloads: Parameters<EmitterListener<E, K>>\n  ) {\n    const listeners = this.#events.get(event) as\n      | Set<EmitterListener<E, K>>\n      | 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"],"mappings":";;;;;;;;;;;;;;;;;;AAgCA,IAAa,UAAb,MAEE;CACA,0BAA0C,IAAI,KAAK;;;;;;;;;;CAWnD,GAAsB,OAAU,UAAiC;EAC/D,MAAM,YAAY,KAAKA,QAAQ,IAAI,MAAM;EACzC,IAAI,WACF,UAAU,IAAI,SAAS;OAEvB,KAAKA,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;;;;;;;;;;;CAahD,KAAwB,OAAU,UAAiC;EACjE,MAAM,gBAAgB,GAAG,aAAgD;GACvE,MAAM,SAAS,SAAS,GAAG,SAAS;GACpC,KAAK,IAAI,OAAO,aAAa;GAC7B,OAAO;;EAET,KAAK,GAAG,OAAO,aAAa;;;;;;;;;;;;;;;;;;;CAoB9B,IAAuB,OAAW,UAAkC;EAClE,IAAI,SAAS,UACX,KAAKC,aAAa,OAAO,SAAS;OAC7B,IAAI,OACT,KAAKC,UAAU,MAAM;OAErB,KAAKC,SAAS;;CAIlB,UAAU;EACR,KAAKH,QAAQ,OAAO;;CAGtB,UAA6B,OAAU;EACrC,KAAKA,QAAQ,OAAO,MAAM;;CAG5B,aAAgC,OAAU,UAAiC;EACzE,MAAM,YAAY,KAAKA,QAAQ,IAAI,MAAM;EAEzC,IAAI,WACF,UAAU,OAAO,SAAS;;;;;;;;;;;;CAc9B,KACE,OACA,GAAG,UACH;EACA,MAAM,YAAY,KAAKA,QAAQ,IAAI,MAAM;EAIzC,IAAI,CAAC,WAAW;EAGhB,KAAK,MAAM,YAAY,CAAC,GAAG,UAAU,EACnC,IAAI,SAAS,GAAG,SAAS,KAAK,OAC5B"}

package/dist/emitter.mjs

@@ -1,98 +1,102 @@
-class Emitter {
-  #events = /* @__PURE__ */ new Map();
-  /**
-   * 注册事件监听器
-   * @param event - 要监听的事件名称
-   * @param listener - 事件监听器函数
-   * @example
-   * emitter.on('click', (x, y) => {
-   *   console.log(`Clicked at (${x}, ${y})`);
-   * });
-   */
-  on(event, listener) {
-    const listeners = this.#events.get(event);
-    if (listeners) {
-      listeners.add(listener);
-    } else {
-      this.#events.set(event, /* @__PURE__ */ new Set([listener]));
-    }
-  }
-  /**
-   * 注册事件监听器，仅触发一次
-   * @param event - 要监听的事件名称
-   * @param listener - 事件监听器函数
-   * @example
-   * emitter.once('click', (x, y) => {
-   *   console.log(`Clicked at (${x}, ${y})`);
-   * });
-   */
-  once(event, listener) {
-    const onceListener = (...payloads) => {
-      const result = listener(...payloads);
-      this.off(event, onceListener);
-      return result;
-    };
-    this.on(event, onceListener);
-  }
-  /**
-   * 移除事件监听器，有三种使用方式：
-   * 1. 移除特定事件的特定监听器
-   * 2. 移除特定事件的所有监听器
-   * 3. 移除所有事件的所有监听器
-   * @param event - 要移除的事件名称（可选）
-   * @param listener - 要移除的监听器函数（可选）
-   * @example
-   * // 移除特定事件的特定监听器
-   * emitter.off('click', clickHandler);
-   *
-   * // 移除特定事件的所有监听器
-   * emitter.off('click');
-   *
-   * // 移除所有事件的所有监听器
-   * emitter.off();
-   */
-  off(event, listener) {
-    if (event && listener) {
-      this.#offListener(event, listener);
-    } else if (event) {
-      this.#offEvent(event);
-    } else {
-      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);
-    }
-  }
-  /**
-   * 触发指定事件，调用所有注册的监听器
-   * @param event - 要触发的事件名称
-   * @param payloads - 传递给监听器的参数
-   * @remarks
-   * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，
-   * 则后续监听器将不会被执行
-   * @example
-   * emitter.emit('click', 10, 20);
-   */
-  emit(event, ...payloads) {
-    const listeners = this.#events.get(event);
-    if (!listeners) return;
-    for (const listener of [...listeners]) {
-      if (listener(...payloads) === false) {
-        break;
-      }
-    }
-  }
-}
-export {
-  Emitter
+//#region src/emitter.ts
+/**
+* 事件发射器类，用于管理事件监听和触发
+* @template E - 事件类型映射
+*
+* @example
+* type MyEvents = {
+*   'click': [x: number, y: number];
+*   'change': [value: string];
+* };
+*
+* const emitter = new Emitter<MyEvents>();
+* emitter.on('click', (x, y) => {
+*   console.log(`Clicked at (${x}, ${y})`);
+* });
+* emitter.emit('click', 10, 20);
+*/
+var Emitter = class {
+	#events = /* @__PURE__ */ new Map();
+	/**
+	* 注册事件监听器
+	* @param event - 要监听的事件名称
+	* @param listener - 事件监听器函数
+	* @example
+	* emitter.on('click', (x, y) => {
+	*   console.log(`Clicked at (${x}, ${y})`);
+	* });
+	*/
+	on(event, listener) {
+		const listeners = this.#events.get(event);
+		if (listeners) listeners.add(listener);
+		else this.#events.set(event, new Set([listener]));
+	}
+	/**
+	* 注册事件监听器，仅触发一次
+	* @param event - 要监听的事件名称
+	* @param listener - 事件监听器函数
+	* @example
+	* emitter.once('click', (x, y) => {
+	*   console.log(`Clicked at (${x}, ${y})`);
+	* });
+	*/
+	once(event, listener) {
+		const onceListener = (...payloads) => {
+			const result = listener(...payloads);
+			this.off(event, onceListener);
+			return result;
+		};
+		this.on(event, onceListener);
+	}
+	/**
+	* 移除事件监听器，有三种使用方式：
+	* 1. 移除特定事件的特定监听器
+	* 2. 移除特定事件的所有监听器
+	* 3. 移除所有事件的所有监听器
+	* @param event - 要移除的事件名称（可选）
+	* @param listener - 要移除的监听器函数（可选）
+	* @example
+	* // 移除特定事件的特定监听器
+	* emitter.off('click', clickHandler);
+	*
+	* // 移除特定事件的所有监听器
+	* emitter.off('click');
+	*
+	* // 移除所有事件的所有监听器
+	* emitter.off();
+	*/
+	off(event, listener) {
+		if (event && listener) this.#offListener(event, listener);
+		else if (event) this.#offEvent(event);
+		else 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);
+	}
+	/**
+	* 触发指定事件，调用所有注册的监听器
+	* @param event - 要触发的事件名称
+	* @param payloads - 传递给监听器的参数
+	* @remarks
+	* 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，
+	* 则后续监听器将不会被执行
+	* @example
+	* emitter.emit('click', 10, 20);
+	*/
+	emit(event, ...payloads) {
+		const listeners = this.#events.get(event);
+		if (!listeners) return;
+		for (const listener of [...listeners]) if (listener(...payloads) === false) break;
+	}
 };
-//# sourceMappingURL=emitter.mjs.map
+//#endregion
+export { Emitter };
+
+//# sourceMappingURL=emitter.mjs.map

package/dist/emitter.mjs.map

@@ -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 = Record<string | symbol, unknown[]>> {\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   * @param event - 要监听的事件名称\n   * @param listener - 事件监听器函数\n   * @example\n   * emitter.once('click', (x, y) => {\n   *   console.log(`Clicked at (${x}, ${y})`);\n   * });\n   */\n  once<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n    const onceListener = (...payloads: Parameters<EmitterListener<E, K>>) => {\n      const result = listener(...payloads);\n      this.off(event, onceListener);\n      return result;\n    };\n    this.on(event, onceListener);\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,QAAmE;AAAA,EAC9E,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,EAYF,KAAwB,OAAU,UAAiC;AAC3D,UAAA,eAAe,IAAI,aAAgD;AACjE,YAAA,SAAS,SAAS,GAAG,QAAQ;AAC9B,WAAA,IAAI,OAAO,YAAY;AACrB,aAAA;AAAA,IACT;AACK,SAAA,GAAG,OAAO,YAAY;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoB7B,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;"}
+{"version":3,"file":"emitter.mjs","names":["#events","#offListener","#offEvent","#offAll"],"sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction } 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> = (\n  ...payloads: E[K]\n) => 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<\n  E extends EmitterMap = Record<string | symbol, unknown[]>,\n> {\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   * @param event - 要监听的事件名称\n   * @param listener - 事件监听器函数\n   * @example\n   * emitter.once('click', (x, y) => {\n   *   console.log(`Clicked at (${x}, ${y})`);\n   * });\n   */\n  once<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n    const onceListener = (...payloads: Parameters<EmitterListener<E, K>>) => {\n      const result = listener(...payloads);\n      this.off(event, onceListener);\n      return result;\n    };\n    this.on(event, onceListener);\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>(\n    event: K,\n    ...payloads: Parameters<EmitterListener<E, K>>\n  ) {\n    const listeners = this.#events.get(event) as\n      | Set<EmitterListener<E, K>>\n      | 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"],"mappings":";;;;;;;;;;;;;;;;;AAgCA,IAAa,UAAb,MAEE;CACA,0BAA0C,IAAI,KAAK;;;;;;;;;;CAWnD,GAAsB,OAAU,UAAiC;EAC/D,MAAM,YAAY,KAAKA,QAAQ,IAAI,MAAM;EACzC,IAAI,WACF,UAAU,IAAI,SAAS;OAEvB,KAAKA,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;;;;;;;;;;;CAahD,KAAwB,OAAU,UAAiC;EACjE,MAAM,gBAAgB,GAAG,aAAgD;GACvE,MAAM,SAAS,SAAS,GAAG,SAAS;GACpC,KAAK,IAAI,OAAO,aAAa;GAC7B,OAAO;;EAET,KAAK,GAAG,OAAO,aAAa;;;;;;;;;;;;;;;;;;;CAoB9B,IAAuB,OAAW,UAAkC;EAClE,IAAI,SAAS,UACX,KAAKC,aAAa,OAAO,SAAS;OAC7B,IAAI,OACT,KAAKC,UAAU,MAAM;OAErB,KAAKC,SAAS;;CAIlB,UAAU;EACR,KAAKH,QAAQ,OAAO;;CAGtB,UAA6B,OAAU;EACrC,KAAKA,QAAQ,OAAO,MAAM;;CAG5B,aAAgC,OAAU,UAAiC;EACzE,MAAM,YAAY,KAAKA,QAAQ,IAAI,MAAM;EAEzC,IAAI,WACF,UAAU,OAAO,SAAS;;;;;;;;;;;;CAc9B,KACE,OACA,GAAG,UACH;EACA,MAAM,YAAY,KAAKA,QAAQ,IAAI,MAAM;EAIzC,IAAI,CAAC,WAAW;EAGhB,KAAK,MAAM,YAAY,CAAC,GAAG,UAAU,EACnC,IAAI,SAAS,GAAG,SAAS,KAAK,OAC5B"}

package/dist/env.cjs

@@ -1,28 +1,62 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const type = require("./type.cjs");
+const require_type = require("./type.cjs");
+//#region src/env.ts
+/**
+* 判断当前环境是否为浏览器环境
+* @returns 如果是浏览器环境返回 true，否则返回 false
+*/
 function isBrowser() {
-  return typeof window !== "undefined" && typeof document !== "undefined";
+	return typeof window !== "undefined" && typeof document !== "undefined";
 }
+/**
+* 判断当前环境是否为 Node.js 环境
+* @returns 如果是 Node.js 环境返回 true，否则返回 false
+*/
 function isNode() {
-  return typeof process !== "undefined" && !type.isNullish(process.versions) && !type.isNullish(process.versions.node);
+	return typeof process !== "undefined" && !require_type.isNullish(process.versions) && !require_type.isNullish(process.versions.node);
 }
+/**
+* 判断当前环境是否为 Web Worker 环境
+* @returns 如果是 Web Worker 环境返回 true，否则返回 false
+* @remarks
+* 使用 @ts-expect-error 忽略 self 的类型检查，因为 self 在 Web Worker 中可用但在其他环境中可能未定义
+*/
 function isWorker() {
-  return typeof self !== "undefined" && self.importScripts != null;
+	return typeof self !== "undefined" && self.importScripts != null;
 }
+/**
+* 判断当前操作系统是否为 macOS
+* @returns 如果是 macOS 返回 true，否则返回 false
+* @remarks
+* 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测
+*/
 function isMacOS() {
-  return isBrowser() ? /^mac/i.test(navigator.platform) : isNode() ? /^darwin/i.test(process.platform) : false;
+	return isBrowser() ? /^mac/i.test(navigator.platform) : isNode() ? /^darwin/i.test(process.platform) : false;
 }
+/**
+* 判断当前操作系统是否为 Linux
+* @returns 如果是 Linux 返回 true，否则返回 false
+* @remarks
+* 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测
+*/
 function isLinux() {
-  return isBrowser() ? /^linux/i.test(navigator.platform) : isNode() ? /^linux/i.test(process.platform) : false;
+	return isBrowser() ? /^linux/i.test(navigator.platform) : isNode() ? /^linux/i.test(process.platform) : false;
 }
+/**
+* 判断当前操作系统是否为 Windows
+* @returns 如果是 Windows 返回 true，否则返回 false
+* @remarks
+* 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测
+*/
 function isWindows() {
-  return isBrowser() ? /^win/i.test(navigator.platform) : isNode() ? /^win/i.test(process.platform) : false;
+	return isBrowser() ? /^win/i.test(navigator.platform) : isNode() ? /^win/i.test(process.platform) : false;
 }
+//#endregion
 exports.isBrowser = isBrowser;
 exports.isLinux = isLinux;
 exports.isMacOS = isMacOS;
 exports.isNode = isNode;
 exports.isWindows = isWindows;
 exports.isWorker = isWorker;
-//# sourceMappingURL=env.cjs.map
+
+//# sourceMappingURL=env.cjs.map

package/dist/env.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["import { isNullish } from './type';\n\n/**\n * 判断当前环境是否为浏览器环境\n * @returns 如果是浏览器环境返回 true，否则返回 false\n */\nexport function isBrowser() {\n  if (IS_TEST) return TEST_MOCK.IS_BROWSER || false;\n\n  return typeof window !== 'undefined' && typeof document !== 'undefined';\n}\n\n/**\n * 判断当前环境是否为 Node.js 环境\n * @returns 如果是 Node.js 环境返回 true，否则返回 false\n */\nexport function isNode() {\n  if (IS_TEST) return TEST_MOCK.IS_NODE || false;\n\n  return typeof process !== 'undefined' && !isNullish(process.versions) && !isNullish(process.versions.node);\n}\n\n/**\n * 判断当前环境是否为 Web Worker 环境\n * @returns 如果是 Web Worker 环境返回 true，否则返回 false\n * @remarks\n * 使用 @ts-ignore 忽略 self 的类型检查，因为 self 在 Web Worker 中可用但在其他环境中可能未定义\n */\nexport function isWorker() {\n  // @ts-ignore\n  return typeof self !== 'undefined' && self.importScripts != null;\n}\n\n/**\n * 判断当前操作系统是否为 macOS\n * @returns 如果是 macOS 返回 true，否则返回 false\n * @remarks\n * 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测\n */\nexport function isMacOS() {\n  return isBrowser() ? /^mac/i.test(navigator.platform) : isNode() ? /^darwin/i.test(process.platform) : false;\n}\n\n/**\n * 判断当前操作系统是否为 Linux\n * @returns 如果是 Linux 返回 true，否则返回 false\n * @remarks\n * 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测\n */\nexport function isLinux() {\n  return isBrowser() ? /^linux/i.test(navigator.platform) : isNode() ? /^linux/i.test(process.platform) : false;\n}\n\n/**\n * 判断当前操作系统是否为 Windows\n * @returns 如果是 Windows 返回 true，否则返回 false\n * @remarks\n * 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测\n */\nexport function isWindows() {\n  return isBrowser() ? /^win/i.test(navigator.platform) : isNode() ? /^win/i.test(process.platform) : false;\n}\n"],"names":["isNullish"],"mappings":";;;AAMO,SAAS,YAAY;AAG1B,SAAO,OAAO,WAAW,eAAe,OAAO,aAAa;AAC9D;AAMO,SAAS,SAAS;AAGvB,SAAO,OAAO,YAAY,eAAe,CAACA,KAAU,UAAA,QAAQ,QAAQ,KAAK,CAACA,KAAA,UAAU,QAAQ,SAAS,IAAI;AAC3G;AAQO,SAAS,WAAW;AAEzB,SAAO,OAAO,SAAS,eAAe,KAAK,iBAAiB;AAC9D;AAQO,SAAS,UAAU;AACxB,SAAO,UAAU,IAAI,QAAQ,KAAK,UAAU,QAAQ,IAAI,OAAA,IAAW,WAAW,KAAK,QAAQ,QAAQ,IAAI;AACzG;AAQO,SAAS,UAAU;AACxB,SAAO,UAAU,IAAI,UAAU,KAAK,UAAU,QAAQ,IAAI,OAAA,IAAW,UAAU,KAAK,QAAQ,QAAQ,IAAI;AAC1G;AAQO,SAAS,YAAY;AAC1B,SAAO,UAAU,IAAI,QAAQ,KAAK,UAAU,QAAQ,IAAI,OAAA,IAAW,QAAQ,KAAK,QAAQ,QAAQ,IAAI;AACtG;;;;;;;"}
+{"version":3,"file":"env.cjs","names":[],"sources":["../src/env.ts"],"sourcesContent":["import { isNullish } from './type';\n\n/**\n * 判断当前环境是否为浏览器环境\n * @returns 如果是浏览器环境返回 true，否则返回 false\n */\nexport function isBrowser() {\n  if (IS_TEST) return TEST_MOCK.IS_BROWSER || false;\n\n  return typeof window !== 'undefined' && typeof document !== 'undefined';\n}\n\n/**\n * 判断当前环境是否为 Node.js 环境\n * @returns 如果是 Node.js 环境返回 true，否则返回 false\n */\nexport function isNode() {\n  if (IS_TEST) return TEST_MOCK.IS_NODE || false;\n\n  return (\n    typeof process !== 'undefined' &&\n    !isNullish(process.versions) &&\n    !isNullish(process.versions.node)\n  );\n}\n\n/**\n * 判断当前环境是否为 Web Worker 环境\n * @returns 如果是 Web Worker 环境返回 true，否则返回 false\n * @remarks\n * 使用 @ts-expect-error 忽略 self 的类型检查，因为 self 在 Web Worker 中可用但在其他环境中可能未定义\n */\nexport function isWorker() {\n  // @ts-expect-error\n  return typeof self !== 'undefined' && self.importScripts != null;\n}\n\n/**\n * 判断当前操作系统是否为 macOS\n * @returns 如果是 macOS 返回 true，否则返回 false\n * @remarks\n * 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测\n */\nexport function isMacOS() {\n  return isBrowser()\n    ? /^mac/i.test(navigator.platform)\n    : isNode()\n      ? /^darwin/i.test(process.platform)\n      : false;\n}\n\n/**\n * 判断当前操作系统是否为 Linux\n * @returns 如果是 Linux 返回 true，否则返回 false\n * @remarks\n * 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测\n */\nexport function isLinux() {\n  return isBrowser()\n    ? /^linux/i.test(navigator.platform)\n    : isNode()\n      ? /^linux/i.test(process.platform)\n      : false;\n}\n\n/**\n * 判断当前操作系统是否为 Windows\n * @returns 如果是 Windows 返回 true，否则返回 false\n * @remarks\n * 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测\n */\nexport function isWindows() {\n  return isBrowser()\n    ? /^win/i.test(navigator.platform)\n    : isNode()\n      ? /^win/i.test(process.platform)\n      : false;\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,YAAY;CAG1B,OAAO,OAAO,WAAW,eAAe,OAAO,aAAa;;;;;;AAO9D,SAAgB,SAAS;CAGvB,OACE,OAAO,YAAY,eACnB,CAAC,aAAA,UAAU,QAAQ,SAAS,IAC5B,CAAC,aAAA,UAAU,QAAQ,SAAS,KAAK;;;;;;;;AAUrC,SAAgB,WAAW;CAEzB,OAAO,OAAO,SAAS,eAAe,KAAK,iBAAiB;;;;;;;;AAS9D,SAAgB,UAAU;CACxB,OAAO,WAAW,GACd,QAAQ,KAAK,UAAU,SAAS,GAChC,QAAQ,GACN,WAAW,KAAK,QAAQ,SAAS,GACjC;;;;;;;;AASR,SAAgB,UAAU;CACxB,OAAO,WAAW,GACd,UAAU,KAAK,UAAU,SAAS,GAClC,QAAQ,GACN,UAAU,KAAK,QAAQ,SAAS,GAChC;;;;;;;;AASR,SAAgB,YAAY;CAC1B,OAAO,WAAW,GACd,QAAQ,KAAK,UAAU,SAAS,GAChC,QAAQ,GACN,QAAQ,KAAK,QAAQ,SAAS,GAC9B"}

package/dist/env.d.ts

@@ -12,7 +12,7 @@ export declare function isNode(): boolean;
  * 判断当前环境是否为 Web Worker 环境
  * @returns 如果是 Web Worker 环境返回 true，否则返回 false
  * @remarks
- * 使用 @ts-ignore 忽略 self 的类型检查，因为 self 在 Web Worker 中可用但在其他环境中可能未定义
+ * 使用 @ts-expect-error 忽略 self 的类型检查，因为 self 在 Web Worker 中可用但在其他环境中可能未定义
  */
 export declare function isWorker(): boolean;
 /**

package/dist/env.mjs

@@ -1,28 +1,56 @@
 import { isNullish } from "./type.mjs";
+//#region src/env.ts
+/**
+* 判断当前环境是否为浏览器环境
+* @returns 如果是浏览器环境返回 true，否则返回 false
+*/
 function isBrowser() {
-  return typeof window !== "undefined" && typeof document !== "undefined";
+	return typeof window !== "undefined" && typeof document !== "undefined";
 }
+/**
+* 判断当前环境是否为 Node.js 环境
+* @returns 如果是 Node.js 环境返回 true，否则返回 false
+*/
 function isNode() {
-  return typeof process !== "undefined" && !isNullish(process.versions) && !isNullish(process.versions.node);
+	return typeof process !== "undefined" && !isNullish(process.versions) && !isNullish(process.versions.node);
 }
+/**
+* 判断当前环境是否为 Web Worker 环境
+* @returns 如果是 Web Worker 环境返回 true，否则返回 false
+* @remarks
+* 使用 @ts-expect-error 忽略 self 的类型检查，因为 self 在 Web Worker 中可用但在其他环境中可能未定义
+*/
 function isWorker() {
-  return typeof self !== "undefined" && self.importScripts != null;
+	return typeof self !== "undefined" && self.importScripts != null;
 }
+/**
+* 判断当前操作系统是否为 macOS
+* @returns 如果是 macOS 返回 true，否则返回 false
+* @remarks
+* 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测
+*/
 function isMacOS() {
-  return isBrowser() ? /^mac/i.test(navigator.platform) : isNode() ? /^darwin/i.test(process.platform) : false;
+	return isBrowser() ? /^mac/i.test(navigator.platform) : isNode() ? /^darwin/i.test(process.platform) : false;
 }
+/**
+* 判断当前操作系统是否为 Linux
+* @returns 如果是 Linux 返回 true，否则返回 false
+* @remarks
+* 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测
+*/
 function isLinux() {
-  return isBrowser() ? /^linux/i.test(navigator.platform) : isNode() ? /^linux/i.test(process.platform) : false;
+	return isBrowser() ? /^linux/i.test(navigator.platform) : isNode() ? /^linux/i.test(process.platform) : false;
 }
+/**
+* 判断当前操作系统是否为 Windows
+* @returns 如果是 Windows 返回 true，否则返回 false
+* @remarks
+* 在浏览器环境中通过 navigator.platform 检测，在 Node.js 环境中通过 process.platform 检测
+*/
 function isWindows() {
-  return isBrowser() ? /^win/i.test(navigator.platform) : isNode() ? /^win/i.test(process.platform) : false;
+	return isBrowser() ? /^win/i.test(navigator.platform) : isNode() ? /^win/i.test(process.platform) : false;
 }
-export {
-  isBrowser,
-  isLinux,
-  isMacOS,
-  isNode,
-  isWindows,
-  isWorker
-};
-//# sourceMappingURL=env.mjs.map
+//#endregion
+export { isBrowser, isLinux, isMacOS, isNode, isWindows, isWorker };
+
+//# sourceMappingURL=env.mjs.map