@polyv/utils-event 3.0.0

package/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class{constructor(){this.__eventStore={}}__addOnEvent(e,t,n,r){if(!t||!n)return;let i=this.__eventStore[t];i||=[],i.push({type:e,handler:n,callbackHandler:n.bind(r)}),this.__eventStore[t]=i}on(e,t,n=this){this.__addOnEvent(`normal`,e,t,n)}once(e,t,n=this){this.__addOnEvent(`once`,e,t,n)}off(e,t){let n=this.__eventStore[e];n&&(n=n.filter(e=>e.handler!==t),this.__eventStore[e]=n)}emit(e,t,n){let r=this.__eventStore[e];r&&r.forEach(r=>{try{let{type:i,handler:a,callbackHandler:o}=r;typeof o==`function`&&o(t,n),i===`once`&&this.off(e,a)}catch(e){console.error(e)}})}destroy(){this.__eventStore={}}};exports.EventEmitter=e;

package/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 本模块提供事件触发器类。
+ * @packageDocumentation
+ */
+/**
+ * 事件类型
+ */
+export type EventType = number | string | symbol;
+/**
+ * 事件参数关系类型
+ */
+export type EventRelationsType = Record<EventType, unknown>;
+/**
+ * 事件回调后的类 response 函数
+ */
+export type EventHandlerCb = (res: unknown) => void;
+/**
+ * 事件回调函数类型
+ */
+export type EventHandler<Relations extends EventRelationsType, E extends EventType> = (params: Relations[E], cb?: EventHandlerCb) => unknown;
+export declare class EventEmitter<Relations extends EventRelationsType = EventRelationsType, Events extends EventType = string> {
+    /**
+     * 事件回调存储器
+     * @ignore
+     */
+    private __eventStore;
+    /**
+     * 添加监听事件
+     * @ignore
+     */
+    private __addOnEvent;
+    /**
+     * 监听事件
+     * @param event 事件名
+     * @param handler 回调函数
+     * @param context this 上下文
+     */
+    on<E extends Events>(event: E, handler: EventHandler<Relations, E>, context?: unknown): void;
+    /**
+     * 监听事件（一次性）
+     * @param event 事件名
+     * @param handler 回调函数
+     * @param context this 上下文
+     */
+    once<E extends Events>(event: E, handler: EventHandler<Relations, E>, context?: unknown): void;
+    /**
+     * 移除事件监听
+     * @param event 事件名
+     * @param handler 回调函数
+     */
+    off<E extends Events>(event: E, handler: unknown): void;
+    /**
+     * 触发事件
+     * @param event 事件名
+     * @param params 回调参数
+     */
+    emit<E extends Events>(event: E, params: Relations[E], cb?: EventHandlerCb): void;
+    emit<E extends Events>(event: undefined extends Relations[E] ? E : never): void;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+}

package/index.js

@@ -0,0 +1,41 @@
+//#region src/index.ts
+var e = class {
+	constructor() {
+		this.__eventStore = {};
+	}
+	__addOnEvent(e, t, n, r) {
+		if (!t || !n) return;
+		let i = this.__eventStore[t];
+		i ||= [], i.push({
+			type: e,
+			handler: n,
+			callbackHandler: n.bind(r)
+		}), this.__eventStore[t] = i;
+	}
+	on(e, t, n = this) {
+		this.__addOnEvent("normal", e, t, n);
+	}
+	once(e, t, n = this) {
+		this.__addOnEvent("once", e, t, n);
+	}
+	off(e, t) {
+		let n = this.__eventStore[e];
+		n && (n = n.filter((e) => e.handler !== t), this.__eventStore[e] = n);
+	}
+	emit(e, t, n) {
+		let r = this.__eventStore[e];
+		r && r.forEach((r) => {
+			try {
+				let { type: i, handler: a, callbackHandler: o } = r;
+				typeof o == "function" && o(t, n), i === "once" && this.off(e, a);
+			} catch (e) {
+				console.error(e);
+			}
+		});
+	}
+	destroy() {
+		this.__eventStore = {};
+	}
+};
+//#endregion
+export { e as EventEmitter };

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@polyv/utils-event",
+  "version": "3.0.0",
+  "description": "Event emitter utilities for Polyv frontend development.",
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "miniprogram": "./",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.cjs"
+    }
+  },
+  "sideEffects": false
+}