@cjhd/cj-event-emitter 1.0.0

package/.cj-event-emitter.md

@@ -0,0 +1,12 @@
+# 全局事件触发器：零依赖、轻量级
+
+## 前置条件
+[游戏引擎](https://www.cocos.com/en/creator-download)
+[开发框架](https://github.com/a1076559139/cocos-creator-frame-3d)
+
+## 使用案例
+```TS
+import {} from 'db://pkg/@cjhd/cc-event-emitter';
+
+...
+```

package/assets/EventEmitter.ts

@@ -0,0 +1,129 @@
+/***********************************************************************
+ * EventEmitter.ts  ——  轻量级全局事件管理器（支持 ctx 精确解绑 & targetOff）
+ *
+ * 修复点：
+ * - on / once 阶段拦截非函数 listener，避免 emit 阶段出现 fn.apply undefined。
+ * - emit 阶段二次防御并清理脏监听，不改变合法监听的执行语义。
+ * - off(type) 支持清空该事件全部监听，兼容常见 EventEmitter 用法。
+ ***********************************************************************/
+
+type EventType = string | number | symbol;
+export type AnyListener = (...args: any[]) => unknown;
+
+/** 内部包装：记录回调与上下文 */
+interface ListenerItem {
+    fn: AnyListener;
+    ctx?: any;
+    once?: boolean;
+}
+
+function isValidListener(fn: unknown): fn is AnyListener {
+    return typeof fn === "function";
+}
+
+export class EventEmitter {
+    /** Map<事件类型, Set<ListenerItem>> */
+    private readonly _map = new Map<EventType, Set<ListenerItem>>();
+
+    /* ───────────── 监听 ───────────── */
+
+    on(type: EventType, fn: AnyListener, ctx?: any): void {
+        if (!isValidListener(fn)) {
+            console.warn("[EventEmitter] ignore invalid on listener:", type, fn);
+            return;
+        }
+
+        let set = this._map.get(type);
+        if (!set) {
+            set = new Set<ListenerItem>();
+            this._map.set(type, set);
+        }
+        set.add({ fn, ctx });
+    }
+
+    once(type: EventType, fn: AnyListener, ctx?: any): void {
+        if (!isValidListener(fn)) {
+            console.warn("[EventEmitter] ignore invalid once listener:", type, fn);
+            return;
+        }
+
+        let set = this._map.get(type);
+        if (!set) {
+            set = new Set<ListenerItem>();
+            this._map.set(type, set);
+        }
+        set.add({ fn, ctx, once: true });
+    }
+
+    /* ───────────── 取消监听 ───────────── */
+
+    /**
+     * 取消指定回调
+     * - off(type)：取消该事件全部监听
+     * - off(type, fn)：取消所有同名函数
+     * - off(type, fn, ctx)：仅取消 (fn, ctx) 组合
+     */
+    off(type: EventType, fn?: AnyListener, ctx?: any): void {
+        const set = this._map.get(type);
+        if (!set) return;
+
+        if (fn === undefined || fn === null) {
+            this._map.delete(type);
+            return;
+        }
+
+        for (const item of Array.from(set)) {
+            if (!item || item.fn !== fn) continue;
+            if (ctx !== undefined && ctx !== item.ctx) continue;
+            set.delete(item);
+        }
+        if (set.size === 0) this._map.delete(type);
+    }
+
+    /**
+     * 根据 ctx 移除当前 EventEmitter 上的所有监听
+     * 等同于 Cocos EventTarget.targetOff
+     */
+    targetOff(ctx: any): void {
+        if (ctx === undefined || ctx === null) return;
+
+        for (const [type, set] of Array.from(this._map.entries())) {
+            for (const item of Array.from(set)) {
+                if (item && item.ctx === ctx) set.delete(item);
+            }
+            if (set.size === 0) this._map.delete(type);
+        }
+    }
+
+    /**
+     * 取消某事件全部监听；不传 type ⇒ 清空所有事件
+     */
+    offAll(type?: EventType): void {
+        if (type === undefined) this._map.clear();
+        else this._map.delete(type);
+    }
+
+    /* ───────────── 触发事件 ───────────── */
+
+    emit(type: EventType, ...args: any[]): void {
+        const set = this._map.get(type);
+        if (!set) return;
+
+        // 拷贝一份，防止回调里修改集合导致遍历异常
+        const listeners = Array.from(set);
+        for (const item of listeners) {
+            if (!item || !isValidListener(item.fn)) {
+                set.delete(item as any);
+                console.warn("[EventEmitter] remove invalid listener while emitting:", type, item);
+                continue;
+            }
+
+            try {
+                item.fn.apply(item.ctx, args);
+            } finally {
+                if (item.once) set.delete(item);
+            }
+        }
+        if (set.size === 0) this._map.delete(type);
+    }
+}

package/assets/EventEmitter.ts.meta

@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "de97f5f0-a281-4cfb-9138-c4266b84f188",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}

package/assets.meta

@@ -0,0 +1,9 @@
+{
+  "ver": "1.2.0",
+  "importer": "directory",
+  "imported": true,
+  "uuid": "7927f3d6-977d-4388-afc3-e365069e9754",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}

package/index.ts

@@ -0,0 +1,2 @@
+// 负责导出assets下的模块，如: export { default } from './assets/xxx.ts'
+export { EventEmitter } from './assets/EventEmitter';

package/index.ts.meta

@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "875ad7b0-b2f1-4157-bb41-d6465bfa1a07",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+    "name": "@cjhd/cj-event-emitter",
+    "version": "1.0.0",
+    "engine": ">=3.8.0",
+    "description": "全局事件触发器：零依赖、轻量级",
+    "main": "index.ts",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://gitee.com/cocos2d-zp/cococs-creator-frame-3d"
+    },
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org"
+    },
+    "author": "超M <402879660@qq.com>",
+    "license": "MIT"
+}

package/package.json.meta

@@ -0,0 +1,11 @@
+{
+  "ver": "2.0.1",
+  "importer": "json",
+  "imported": true,
+  "uuid": "ab519119-3f49-4697-b90d-28f076d502b5",
+  "files": [
+    ".json"
+  ],
+  "subMetas": {},
+  "userData": {}
+}