@xiacg/exia-event 1.0.0

package/dist/exia-event.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @Description: 事件管理器 - 支持递归保护
+ */
+/**
+ * 事件管理器 - 防止递归调用栈溢出
+ *
+ * 功能特性：
+ * - 递归深度限制防止栈溢出
+ * - 完全向后兼容现有API
+ */
+declare class EventManager {
+    /**
+     * 添加事件监听器
+     * @param name - 事件名称
+     * @param callback - 回调函数，当事件触发时执行
+     * @param target - 可选参数，指定事件监听的目标对象
+     * @returns 返回事件ID，可用于移除事件
+     */
+    add(name: string, callback: (...args: any[]) => void, target?: any): number;
+    /**
+     * 添加一个只触发一次的事件监听器
+     * @param name - 事件名称
+     * @param callback - 事件触发时要执行的回调函数
+     * @param target - 可选参数，指定事件监听器的目标对象
+     * @returns 返回事件ID，可用于移除事件
+     */
+    addOnce(name: string, callback: (...args: any[]) => void, target?: any): number;
+    /**
+     * 发送事件给所有注册的监听器（带递归保护）
+     * @param name - 事件名称
+     * @param target - 可选参数，指定目标对象，只有目标对象匹配时才会触发监听器
+     * @param args - 传递给监听器回调函数的参数
+     */
+    send(name: string, target?: any, ...args: any[]): void;
+    /**
+     * 通过事件ID移除事件
+     * @param eventId 事件ID
+     */
+    remove(eventId: number): void;
+    /**
+     * 移除指定名称的所有事件
+     * @param name 事件名称
+     */
+    removeByName(name: string): void;
+    /**
+     * 移除指定目标的所有事件
+     * @param target 目标对象
+     */
+    removeByTarget(target: any): void;
+    /**
+     * 移除指定名称和指定目标的事件
+     * @param name 事件名称
+     * @param target 绑定的目标对象
+     */
+    removeByNameAndTarget(name: string, target: any): void;
+    /**
+     * 清空所有注册的事件
+     */
+    clearAll(): void;
+}
+
+/**
+ * @Description: 全局事件
+ */
+declare class GlobalEvent {
+    /**
+     * 添加一个事件
+     * @param name 事件名称
+     * @param callback 事件回调
+     * @param target 事件目标
+     */
+    static add(name: string, callback: (...args: any[]) => void, target?: any): number;
+    /**
+     * 添加一个只触发一次的事件
+     */
+    static addOnce(name: string, callback: (...args: any[]) => void, target?: any): number;
+    /**
+     * 发送一个事件
+     * @param name 事件名称
+     * @param args 事件参数
+     */
+    static send(name: string, ...args: any[]): void;
+    /**
+     * 发送一个事件给指定目标
+     * @param name 事件名称
+     * @param target 事件目标
+     * @param args 事件参数
+     */
+    static sendToTarget(name: string, target: any, ...args: any[]): void;
+    /**
+     * 移除一个指定ID的事件
+     * @param eventId 事件ID
+     */
+    static remove(eventId: number): void;
+    static removeByName(name: string): void;
+    static removeByTarget(target: any): void;
+    /**
+     * 通过目标和事件名称批量移除事件
+     * @param name 事件名称
+     * @param target 事件目标
+     */
+    static removeByNameAndTarget(name: string, target: any): void;
+    /**
+     * 清空所有事件
+     */
+    static clearAll(): void;
+}
+
+export { EventManager, GlobalEvent };

package/dist/exia-event.min.cjs

@@ -0,0 +1 @@
+"use strict";var e;!function(e){e[e.Add=1]="Add",e[e.RemoveById=2]="RemoveById",e[e.RemoveByName=3]="RemoveByName",e[e.RemoveByTarget=4]="RemoveByTarget",e[e.RemoveByNameAndTarget=5]="RemoveByNameAndTarget",e[e.ClearAll=6]="ClearAll"}(e||(e={}));class t{constructor(){this.type=e.Add}reset(){this.type=e.Add,this.eventId=0,this.event=null,this.name=null,this.target=null}}class s{constructor(){this.commands=[],this.index=0,this.length=0,this.clearAll=!1}addEvent(s){if(this.index==this.length){let a=new t;a.type=e.Add,a.event=s,this.commands.push(a),this.length++,this.index++}else{let t=this.commands[this.index++];t.type=e.Add,t.event=s}}add(s,a,n,i){if(s!=e.ClearAll)if(this.index==this.length){let e=new t;e.type=s,e.eventId=a,e.name=n,e.target=i,this.commands.push(e),this.length++,this.index++}else{let e=this.commands[this.index++];e.type=s,e.eventId=a,e.name=n,e.target=i}else this.clearAll=!0}forEach(t){if(this.clearAll)t({type:e.ClearAll,eventId:0,event:null,name:null,target:null,reset:null});else{for(let e=0;e<this.index;e++){let s=this.commands[e];t(s),s.reset()}this.index=0}}clear(){this.commands.length=0,this.index=0,this.clearAll=!1,this.length=0}}class a{constructor(){this.once=!1}}class n{constructor(e,t){this._id=0,this._stack=[],this._maxCapacity=64,this._maxCapacity=e,this._msgClass=t}allocate(){if(0==this._stack.length){const e=new this._msgClass;return e.id=++this._id,e}const e=this._stack.pop();return e.id=++this._id,e}recycle(e){return this._maxCapacity>0&&this._stack.length<this._maxCapacity&&(this._stack.push(e),!0)}}class i{constructor(){this.sending_depth=0,this.events=new Map,this.nameToIds=new Map,this.targetToIds=new Map,this.factory=new n(64,a),this.commandManager=new s}add(e,t,s){if(!e)throw new Error("事件名称不能为空");if(!t)throw new Error("回调函数不能为空");let a=this.factory.allocate();return a.name=e,a.callback=t,a.target=s,a.once=!1,this.sending_depth>0?(this.commandManager.addEvent(a),a.id):(this._addEvent(a),a.id)}addOnce(e,t,s){if(!e)throw new Error("事件名称不能为空");if(!t)throw new Error("回调函数不能为空");let a=this.factory.allocate();return a.name=e,a.callback=t,a.target=s,a.once=!0,this.sending_depth>0?(this.commandManager.addEvent(a),a.id):(this._addEvent(a),a.id)}_addEvent(e){this.events.set(e.id,e),this.nameToIds.has(e.name)||this.nameToIds.set(e.name,new Set);this.nameToIds.get(e.name).add(e.id);let t=e.target;t&&(this.targetToIds.has(t)||this.targetToIds.set(t,new Set),this.targetToIds.get(t).add(e.id))}send(t,s,...a){if(this.sending_depth>=20)return console.error("[EventManager] 递归深度超出限制！"),console.error(`  事件名称: "${t}"`),console.error(`  当前深度: ${this.sending_depth}`),console.error("  最大深度: 20"),void console.error("  为防止栈溢出，事件执行已被阻止");if(!this.nameToIds.has(t))return;const n=this.nameToIds.get(t);if(0===n.size)return;const i=[],r=[];this.sending_depth++;for(const e of n.values()){if(!this.events.has(e)){i.push(e);continue}let t=this.events.get(e);s&&s!==t.target||(r.push(t),t.once&&i.push(e))}for(const e of r)e.callback(...a);if(this.sending_depth--,0===this.sending_depth){if(i.length>0)for(const e of i)this.remove(e);this.commandManager.forEach(t=>{switch(t.type){case e.Add:this._addEvent(t.event);break;case e.RemoveById:this.remove(t.eventId);break;case e.RemoveByName:this.removeByName(t.name);break;case e.RemoveByTarget:this.removeByTarget(t.target);break;case e.RemoveByNameAndTarget:this.removeByNameAndTarget(t.name,t.target);break;case e.ClearAll:this.clearAll()}})}}remove(t){if(!this.events.has(t))return;if(this.sending_depth>0)return void this.commandManager.add(e.RemoveById,t,null,null);let s=this.events.get(t),a=s.name,n=s.target;this.events.delete(t),this.factory.recycle(s),this.nameToIds.has(a)&&this.nameToIds.get(a).delete(t),n&&this.targetToIds.has(n)&&this.targetToIds.get(n).delete(t)}removeByName(t){if(!this.nameToIds.has(t))return;let s=this.nameToIds.get(t);0!==s.size&&(this.sending_depth>0?this.commandManager.add(e.RemoveByName,null,t,null):(s.forEach(e=>{if(this.events.has(e)){let t=this.events.get(e);t.target&&this.targetToIds.has(t.target)&&this.targetToIds.get(t.target).delete(e),this.events.delete(e),this.factory.recycle(t)}}),this.nameToIds.delete(t)))}removeByTarget(t){if(!this.targetToIds.has(t))return;let s=this.targetToIds.get(t);0!==s.size&&(this.sending_depth>0?this.commandManager.add(e.RemoveByTarget,null,null,t):(s.forEach(e=>{if(this.events.has(e)){let t=this.events.get(e);this.nameToIds.has(t.name)&&this.nameToIds.get(t.name).delete(e),this.events.delete(e),this.factory.recycle(t)}}),this.targetToIds.delete(t)))}removeByNameAndTarget(t,s){if(!this.nameToIds.has(t))return;let a=this.nameToIds.get(t),n=this.targetToIds.get(s);if(0===a.size||!n||0===n.size)return;if(this.sending_depth>0)return void this.commandManager.add(e.RemoveByNameAndTarget,null,t,s);const i=[];if(a.size<n.size?a.forEach(e=>{this.events.get(e).target===s&&i.push(e)}):n.forEach(e=>{this.events.get(e).name===t&&i.push(e)}),i.length>0)for(const e of i)this.remove(e)}clearAll(){if(this.sending_depth>0)this.commandManager.add(e.ClearAll,null,null,null);else{for(const e of this.events.values())this.factory.recycle(e);this.events.clear(),this.nameToIds.clear(),this.targetToIds.clear(),this.commandManager.clear(),this.sending_depth=0}}}class r{static add(e,t,s){return this.event.add(e,t,s)}static addOnce(e,t,s){return this.event.addOnce(e,t,s)}static send(e,...t){this.event.send(e,null,...t)}static sendToTarget(e,t,...s){this.event.send(e,t,...s)}static remove(e){this.event.remove(e)}static removeByName(e){this.event.removeByName(e)}static removeByTarget(e){this.event.removeByTarget(e)}static removeByNameAndTarget(e,t){this.event.removeByNameAndTarget(e,t)}static clearAll(){this.event.clearAll()}}r.event=new i,exports.EventManager=i,exports.GlobalEvent=r;

package/dist/exia-event.min.mjs

@@ -0,0 +1 @@
+var e;!function(e){e[e.Add=1]="Add",e[e.RemoveById=2]="RemoveById",e[e.RemoveByName=3]="RemoveByName",e[e.RemoveByTarget=4]="RemoveByTarget",e[e.RemoveByNameAndTarget=5]="RemoveByNameAndTarget",e[e.ClearAll=6]="ClearAll"}(e||(e={}));class t{constructor(){this.type=e.Add}reset(){this.type=e.Add,this.eventId=0,this.event=null,this.name=null,this.target=null}}class s{constructor(){this.commands=[],this.index=0,this.length=0,this.clearAll=!1}addEvent(s){if(this.index==this.length){let a=new t;a.type=e.Add,a.event=s,this.commands.push(a),this.length++,this.index++}else{let t=this.commands[this.index++];t.type=e.Add,t.event=s}}add(s,a,n,i){if(s!=e.ClearAll)if(this.index==this.length){let e=new t;e.type=s,e.eventId=a,e.name=n,e.target=i,this.commands.push(e),this.length++,this.index++}else{let e=this.commands[this.index++];e.type=s,e.eventId=a,e.name=n,e.target=i}else this.clearAll=!0}forEach(t){if(this.clearAll)t({type:e.ClearAll,eventId:0,event:null,name:null,target:null,reset:null});else{for(let e=0;e<this.index;e++){let s=this.commands[e];t(s),s.reset()}this.index=0}}clear(){this.commands.length=0,this.index=0,this.clearAll=!1,this.length=0}}class a{constructor(){this.once=!1}}class n{constructor(e,t){this._id=0,this._stack=[],this._maxCapacity=64,this._maxCapacity=e,this._msgClass=t}allocate(){if(0==this._stack.length){const e=new this._msgClass;return e.id=++this._id,e}const e=this._stack.pop();return e.id=++this._id,e}recycle(e){return this._maxCapacity>0&&this._stack.length<this._maxCapacity&&(this._stack.push(e),!0)}}class i{constructor(){this.sending_depth=0,this.events=new Map,this.nameToIds=new Map,this.targetToIds=new Map,this.factory=new n(64,a),this.commandManager=new s}add(e,t,s){if(!e)throw new Error("事件名称不能为空");if(!t)throw new Error("回调函数不能为空");let a=this.factory.allocate();return a.name=e,a.callback=t,a.target=s,a.once=!1,this.sending_depth>0?(this.commandManager.addEvent(a),a.id):(this._addEvent(a),a.id)}addOnce(e,t,s){if(!e)throw new Error("事件名称不能为空");if(!t)throw new Error("回调函数不能为空");let a=this.factory.allocate();return a.name=e,a.callback=t,a.target=s,a.once=!0,this.sending_depth>0?(this.commandManager.addEvent(a),a.id):(this._addEvent(a),a.id)}_addEvent(e){this.events.set(e.id,e),this.nameToIds.has(e.name)||this.nameToIds.set(e.name,new Set);this.nameToIds.get(e.name).add(e.id);let t=e.target;t&&(this.targetToIds.has(t)||this.targetToIds.set(t,new Set),this.targetToIds.get(t).add(e.id))}send(t,s,...a){if(this.sending_depth>=20)return console.error("[EventManager] 递归深度超出限制！"),console.error(`  事件名称: "${t}"`),console.error(`  当前深度: ${this.sending_depth}`),console.error("  最大深度: 20"),void console.error("  为防止栈溢出，事件执行已被阻止");if(!this.nameToIds.has(t))return;const n=this.nameToIds.get(t);if(0===n.size)return;const i=[],h=[];this.sending_depth++;for(const e of n.values()){if(!this.events.has(e)){i.push(e);continue}let t=this.events.get(e);s&&s!==t.target||(h.push(t),t.once&&i.push(e))}for(const e of h)e.callback(...a);if(this.sending_depth--,0===this.sending_depth){if(i.length>0)for(const e of i)this.remove(e);this.commandManager.forEach(t=>{switch(t.type){case e.Add:this._addEvent(t.event);break;case e.RemoveById:this.remove(t.eventId);break;case e.RemoveByName:this.removeByName(t.name);break;case e.RemoveByTarget:this.removeByTarget(t.target);break;case e.RemoveByNameAndTarget:this.removeByNameAndTarget(t.name,t.target);break;case e.ClearAll:this.clearAll()}})}}remove(t){if(!this.events.has(t))return;if(this.sending_depth>0)return void this.commandManager.add(e.RemoveById,t,null,null);let s=this.events.get(t),a=s.name,n=s.target;this.events.delete(t),this.factory.recycle(s),this.nameToIds.has(a)&&this.nameToIds.get(a).delete(t),n&&this.targetToIds.has(n)&&this.targetToIds.get(n).delete(t)}removeByName(t){if(!this.nameToIds.has(t))return;let s=this.nameToIds.get(t);0!==s.size&&(this.sending_depth>0?this.commandManager.add(e.RemoveByName,null,t,null):(s.forEach(e=>{if(this.events.has(e)){let t=this.events.get(e);t.target&&this.targetToIds.has(t.target)&&this.targetToIds.get(t.target).delete(e),this.events.delete(e),this.factory.recycle(t)}}),this.nameToIds.delete(t)))}removeByTarget(t){if(!this.targetToIds.has(t))return;let s=this.targetToIds.get(t);0!==s.size&&(this.sending_depth>0?this.commandManager.add(e.RemoveByTarget,null,null,t):(s.forEach(e=>{if(this.events.has(e)){let t=this.events.get(e);this.nameToIds.has(t.name)&&this.nameToIds.get(t.name).delete(e),this.events.delete(e),this.factory.recycle(t)}}),this.targetToIds.delete(t)))}removeByNameAndTarget(t,s){if(!this.nameToIds.has(t))return;let a=this.nameToIds.get(t),n=this.targetToIds.get(s);if(0===a.size||!n||0===n.size)return;if(this.sending_depth>0)return void this.commandManager.add(e.RemoveByNameAndTarget,null,t,s);const i=[];if(a.size<n.size?a.forEach(e=>{this.events.get(e).target===s&&i.push(e)}):n.forEach(e=>{this.events.get(e).name===t&&i.push(e)}),i.length>0)for(const e of i)this.remove(e)}clearAll(){if(this.sending_depth>0)this.commandManager.add(e.ClearAll,null,null,null);else{for(const e of this.events.values())this.factory.recycle(e);this.events.clear(),this.nameToIds.clear(),this.targetToIds.clear(),this.commandManager.clear(),this.sending_depth=0}}}class h{static add(e,t,s){return this.event.add(e,t,s)}static addOnce(e,t,s){return this.event.addOnce(e,t,s)}static send(e,...t){this.event.send(e,null,...t)}static sendToTarget(e,t,...s){this.event.send(e,t,...s)}static remove(e){this.event.remove(e)}static removeByName(e){this.event.removeByName(e)}static removeByTarget(e){this.event.removeByTarget(e)}static removeByNameAndTarget(e,t){this.event.removeByNameAndTarget(e,t)}static clearAll(){this.event.clearAll()}}h.event=new i;export{i as EventManager,h as GlobalEvent};

package/dist/exia-event.mjs

@@ -0,0 +1,562 @@
+/**
+ * @Description: 命令
+ */
+var CommandType;
+(function (CommandType) {
+    CommandType[CommandType["Add"] = 1] = "Add";
+    CommandType[CommandType["RemoveById"] = 2] = "RemoveById";
+    CommandType[CommandType["RemoveByName"] = 3] = "RemoveByName";
+    CommandType[CommandType["RemoveByTarget"] = 4] = "RemoveByTarget";
+    CommandType[CommandType["RemoveByNameAndTarget"] = 5] = "RemoveByNameAndTarget";
+    CommandType[CommandType["ClearAll"] = 6] = "ClearAll";
+})(CommandType || (CommandType = {}));
+/**
+ * 命令
+ * @internal
+ */
+class Command {
+    constructor() {
+        this.type = CommandType.Add;
+    }
+    reset() {
+        this.type = CommandType.Add;
+        this.eventId = 0;
+        this.event = null;
+        this.name = null;
+        this.target = null;
+    }
+}
+/**
+ * 命令管理器
+ * @internal
+ */
+class CommandManager {
+    constructor() {
+        this.commands = [];
+        this.index = 0;
+        this.length = 0;
+        this.clearAll = false;
+    }
+    /**
+     * 添加一个添加事件的命令
+     * @param event 事件
+     */
+    addEvent(event) {
+        if (this.index == this.length) {
+            let command = new Command();
+            command.type = CommandType.Add;
+            command.event = event;
+            this.commands.push(command);
+            this.length++;
+            this.index++;
+        }
+        else {
+            let command = this.commands[this.index++];
+            command.type = CommandType.Add;
+            command.event = event;
+        }
+    }
+    /**
+     * 添加一个删除事件或者清理所有的命令
+     */
+    add(type, eventId, name, target) {
+        if (type == CommandType.ClearAll) {
+            this.clearAll = true;
+            return;
+        }
+        if (this.index == this.length) {
+            let command = new Command();
+            command.type = type;
+            command.eventId = eventId;
+            command.name = name;
+            command.target = target;
+            this.commands.push(command);
+            this.length++;
+            this.index++;
+        }
+        else {
+            let command = this.commands[this.index++];
+            command.type = type;
+            command.eventId = eventId;
+            command.name = name;
+            command.target = target;
+        }
+    }
+    forEach(callback) {
+        if (this.clearAll) {
+            callback({
+                type: CommandType.ClearAll,
+                eventId: 0,
+                event: null,
+                name: null,
+                target: null,
+                reset: null,
+            });
+            return;
+        }
+        for (let i = 0; i < this.index; i++) {
+            let command = this.commands[i];
+            callback(command);
+            command.reset();
+        }
+        this.index = 0;
+    }
+    clear() {
+        this.commands.length = 0;
+        this.index = 0;
+        this.clearAll = false;
+        this.length = 0;
+    }
+}
+
+/** @internal */
+class Event {
+    constructor() {
+        this.once = false;
+    }
+}
+
+/** @internal */
+class EventFactory {
+    constructor(capacity, objectClass) {
+        this._id = 0;
+        this._stack = [];
+        this._maxCapacity = 64;
+        this._maxCapacity = capacity;
+        this._msgClass = objectClass;
+    }
+    allocate() {
+        if (this._stack.length == 0) {
+            const ret = new this._msgClass();
+            ret.id = ++this._id;
+            return ret;
+        }
+        const ret = this._stack.pop();
+        // 分配新ID，避免ID重用导致误删
+        ret.id = ++this._id;
+        return ret;
+    }
+    recycle(ret) {
+        if (this._maxCapacity > 0 && this._stack.length < this._maxCapacity) {
+            this._stack.push(ret);
+            return true;
+        }
+        return false;
+    }
+}
+
+/**
+ * @Description: 事件管理器 - 支持递归保护
+ */
+/**
+ * 最大递归深度常量
+ */
+const MAX_RECURSION_DEPTH = 20;
+/**
+ * 事件管理器 - 防止递归调用栈溢出
+ *
+ * 功能特性：
+ * - 递归深度限制防止栈溢出
+ * - 完全向后兼容现有API
+ */
+class EventManager {
+    constructor() {
+        /**
+         * 当前递归发送深度
+         * 0 表示没有在发送，> 0 表示正在发送事件
+         * @internal
+         */
+        this.sending_depth = 0;
+        /**
+         * 注册的所有事件 事件ID -> 事件
+         * @internal
+         */
+        this.events = new Map();
+        /**
+         * 事件名称 -> 事件ID集合
+         * @internal
+         */
+        this.nameToIds = new Map();
+        /**
+         * 事件目标 -> 事件ID集合
+         * @internal
+         */
+        this.targetToIds = new Map();
+        /**
+         * 事件工厂
+         * @internal
+         */
+        this.factory = new EventFactory(64, Event);
+        /**
+         * 命令管理器
+         * @internal
+         */
+        this.commandManager = new CommandManager();
+    }
+    /**
+     * 添加事件监听器
+     * @param name - 事件名称
+     * @param callback - 回调函数，当事件触发时执行
+     * @param target - 可选参数，指定事件监听的目标对象
+     * @returns 返回事件ID，可用于移除事件
+     */
+    add(name, callback, target) {
+        if (!name) {
+            throw new Error("事件名称不能为空");
+        }
+        if (!callback) {
+            throw new Error("回调函数不能为空");
+        }
+        let event = this.factory.allocate();
+        event.name = name;
+        event.callback = callback;
+        event.target = target;
+        event.once = false;
+        if (this.sending_depth > 0) {
+            this.commandManager.addEvent(event);
+            return event.id;
+        }
+        this._addEvent(event);
+        return event.id;
+    }
+    /**
+     * 添加一个只触发一次的事件监听器
+     * @param name - 事件名称
+     * @param callback - 事件触发时要执行的回调函数
+     * @param target - 可选参数，指定事件监听器的目标对象
+     * @returns 返回事件ID，可用于移除事件
+     */
+    addOnce(name, callback, target) {
+        if (!name) {
+            throw new Error("事件名称不能为空");
+        }
+        if (!callback) {
+            throw new Error("回调函数不能为空");
+        }
+        let event = this.factory.allocate();
+        event.name = name;
+        event.callback = callback;
+        event.target = target;
+        event.once = true;
+        if (this.sending_depth > 0) {
+            this.commandManager.addEvent(event);
+            return event.id;
+        }
+        this._addEvent(event);
+        return event.id;
+    }
+    /**
+     * 添加事件内部方法
+     * @param event 事件对象
+     * @internal
+     */
+    _addEvent(event) {
+        this.events.set(event.id, event);
+        if (!this.nameToIds.has(event.name)) {
+            this.nameToIds.set(event.name, new Set());
+        }
+        const ids = this.nameToIds.get(event.name);
+        ids.add(event.id);
+        let target = event.target;
+        if (target) {
+            if (!this.targetToIds.has(target)) {
+                this.targetToIds.set(target, new Set());
+            }
+            this.targetToIds.get(target).add(event.id);
+        }
+    }
+    /**
+     * 发送事件给所有注册的监听器（带递归保护）
+     * @param name - 事件名称
+     * @param target - 可选参数，指定目标对象，只有目标对象匹配时才会触发监听器
+     * @param args - 传递给监听器回调函数的参数
+     */
+    send(name, target, ...args) {
+        // 递归深度保护：阻止超过限制的执行并报告错误
+        if (this.sending_depth >= MAX_RECURSION_DEPTH) {
+            console.error(`[EventManager] 递归深度超出限制！`);
+            console.error(`  事件名称: "${name}"`);
+            console.error(`  当前深度: ${this.sending_depth}`);
+            console.error(`  最大深度: ${MAX_RECURSION_DEPTH}`);
+            console.error(`  为防止栈溢出，事件执行已被阻止`);
+            return;
+        }
+        if (!this.nameToIds.has(name)) {
+            return;
+        }
+        const eventIds = this.nameToIds.get(name);
+        if (eventIds.size === 0) {
+            return;
+        }
+        // 使用局部变量，避免嵌套调用时互相污染
+        const needRemoveIds = [];
+        const triggerList = [];
+        // 增加递归深度
+        this.sending_depth++;
+        // 构建触发列表
+        for (const eventId of eventIds.values()) {
+            if (!this.events.has(eventId)) {
+                needRemoveIds.push(eventId);
+                continue;
+            }
+            let event = this.events.get(eventId);
+            if (!target || target === event.target) {
+                triggerList.push(event);
+                if (event.once) {
+                    needRemoveIds.push(eventId);
+                }
+            }
+        }
+        // 同步触发事件
+        for (const event of triggerList) {
+            event.callback(...args);
+        }
+        // 减少递归深度
+        this.sending_depth--;
+        // 只在最外层执行清理工作
+        if (this.sending_depth === 0) {
+            // 清理 once 事件
+            if (needRemoveIds.length > 0) {
+                for (const id of needRemoveIds) {
+                    this.remove(id);
+                }
+            }
+            // 处理命令队列
+            this.commandManager.forEach((command) => {
+                switch (command.type) {
+                    case CommandType.Add:
+                        this._addEvent(command.event);
+                        break;
+                    case CommandType.RemoveById:
+                        this.remove(command.eventId);
+                        break;
+                    case CommandType.RemoveByName:
+                        this.removeByName(command.name);
+                        break;
+                    case CommandType.RemoveByTarget:
+                        this.removeByTarget(command.target);
+                        break;
+                    case CommandType.RemoveByNameAndTarget:
+                        this.removeByNameAndTarget(command.name, command.target);
+                        break;
+                    case CommandType.ClearAll:
+                        this.clearAll();
+                        break;
+                }
+            });
+        }
+    }
+    /**
+     * 通过事件ID移除事件
+     * @param eventId 事件ID
+     */
+    remove(eventId) {
+        if (!this.events.has(eventId)) {
+            return;
+        }
+        if (this.sending_depth > 0) {
+            this.commandManager.add(CommandType.RemoveById, eventId, null, null);
+            return;
+        }
+        let event = this.events.get(eventId);
+        let name = event.name;
+        let target = event.target;
+        this.events.delete(eventId);
+        this.factory.recycle(event);
+        if (this.nameToIds.has(name)) {
+            this.nameToIds.get(name).delete(eventId);
+        }
+        if (target && this.targetToIds.has(target)) {
+            this.targetToIds.get(target).delete(eventId);
+        }
+    }
+    /**
+     * 移除指定名称的所有事件
+     * @param name 事件名称
+     */
+    removeByName(name) {
+        if (!this.nameToIds.has(name)) {
+            return;
+        }
+        let eventIds = this.nameToIds.get(name);
+        if (eventIds.size === 0) {
+            return;
+        }
+        if (this.sending_depth > 0) {
+            this.commandManager.add(CommandType.RemoveByName, null, name, null);
+            return;
+        }
+        eventIds.forEach((eventId) => {
+            if (this.events.has(eventId)) {
+                let event = this.events.get(eventId);
+                if (event.target && this.targetToIds.has(event.target)) {
+                    this.targetToIds.get(event.target).delete(eventId);
+                }
+                this.events.delete(eventId);
+                this.factory.recycle(event);
+            }
+        });
+        this.nameToIds.delete(name);
+    }
+    /**
+     * 移除指定目标的所有事件
+     * @param target 目标对象
+     */
+    removeByTarget(target) {
+        if (!this.targetToIds.has(target)) {
+            return;
+        }
+        let eventIds = this.targetToIds.get(target);
+        if (eventIds.size === 0) {
+            return;
+        }
+        if (this.sending_depth > 0) {
+            this.commandManager.add(CommandType.RemoveByTarget, null, null, target);
+            return;
+        }
+        eventIds.forEach((eventId) => {
+            if (this.events.has(eventId)) {
+                let event = this.events.get(eventId);
+                if (this.nameToIds.has(event.name)) {
+                    this.nameToIds.get(event.name).delete(eventId);
+                }
+                this.events.delete(eventId);
+                this.factory.recycle(event);
+            }
+        });
+        this.targetToIds.delete(target);
+    }
+    /**
+     * 移除指定名称和指定目标的事件
+     * @param name 事件名称
+     * @param target 绑定的目标对象
+     */
+    removeByNameAndTarget(name, target) {
+        if (!this.nameToIds.has(name)) {
+            return;
+        }
+        let nameIds = this.nameToIds.get(name);
+        let targetIds = this.targetToIds.get(target);
+        // 检查targetIds是否存在，避免NPE
+        if (nameIds.size === 0 || !targetIds || targetIds.size === 0) {
+            return;
+        }
+        if (this.sending_depth > 0) {
+            this.commandManager.add(CommandType.RemoveByNameAndTarget, null, name, target);
+            return;
+        }
+        // 使用局部变量
+        const needRemoveIds = [];
+        if (nameIds.size < targetIds.size) {
+            nameIds.forEach((eventId) => {
+                let event = this.events.get(eventId);
+                if (event.target === target) {
+                    needRemoveIds.push(eventId);
+                }
+            });
+        }
+        else {
+            targetIds.forEach((eventId) => {
+                let event = this.events.get(eventId);
+                if (event.name === name) {
+                    needRemoveIds.push(eventId);
+                }
+            });
+        }
+        if (needRemoveIds.length > 0) {
+            for (const id of needRemoveIds) {
+                this.remove(id);
+            }
+        }
+    }
+    /**
+     * 清空所有注册的事件
+     */
+    clearAll() {
+        if (this.sending_depth > 0) {
+            this.commandManager.add(CommandType.ClearAll, null, null, null);
+            return;
+        }
+        for (const event of this.events.values()) {
+            this.factory.recycle(event);
+        }
+        this.events.clear();
+        this.nameToIds.clear();
+        this.targetToIds.clear();
+        this.commandManager.clear();
+        // 清理递归保护相关状态
+        this.sending_depth = 0;
+    }
+}
+
+/**
+ * @Description: 全局事件
+ */
+class GlobalEvent {
+    /**
+     * 添加一个事件
+     * @param name 事件名称
+     * @param callback 事件回调
+     * @param target 事件目标
+     */
+    static add(name, callback, target) {
+        return this.event.add(name, callback, target);
+    }
+    /**
+     * 添加一个只触发一次的事件
+     */
+    static addOnce(name, callback, target) {
+        return this.event.addOnce(name, callback, target);
+    }
+    /**
+     * 发送一个事件
+     * @param name 事件名称
+     * @param args 事件参数
+     */
+    static send(name, ...args) {
+        this.event.send(name, null, ...args);
+    }
+    /**
+     * 发送一个事件给指定目标
+     * @param name 事件名称
+     * @param target 事件目标
+     * @param args 事件参数
+     */
+    static sendToTarget(name, target, ...args) {
+        this.event.send(name, target, ...args);
+    }
+    /**
+     * 移除一个指定ID的事件
+     * @param eventId 事件ID
+     */
+    static remove(eventId) {
+        this.event.remove(eventId);
+    }
+    static removeByName(name) {
+        this.event.removeByName(name);
+    }
+    static removeByTarget(target) {
+        this.event.removeByTarget(target);
+    }
+    /**
+     * 通过目标和事件名称批量移除事件
+     * @param name 事件名称
+     * @param target 事件目标
+     */
+    static removeByNameAndTarget(name, target) {
+        this.event.removeByNameAndTarget(name, target);
+    }
+    /**
+     * 清空所有事件
+     */
+    static clearAll() {
+        this.event.clearAll();
+    }
+}
+/**
+ * 事件管理器
+ * @internal
+ */
+GlobalEvent.event = new EventManager();
+
+export { EventManager, GlobalEvent };