@esengine/ecs-framework 2.2.20 → 2.3.0

package/bin/ECS/Core/EventBus.d.ts

@@ -0,0 +1,210 @@
+import { IEventBus, IEventListenerConfig, IEventStats, IEntityEventData, IComponentEventData, ISystemEventData, ISceneEventData, IPerformanceEventData } from '../../Types';
+/**
+ * 增强的事件总线实现
+ * 基于TypeSafeEventSystem，提供类型安全的事件发布订阅机制
+ */
+export declare class EventBus implements IEventBus {
+    private static readonly _logger;
+    private eventSystem;
+    private eventIdCounter;
+    private isDebugMode;
+    constructor(debugMode?: boolean);
+    /**
+     * 发射事件
+     * @param eventType 事件类型
+     * @param data 事件数据
+     * @param enhance 是否增强事件数据（添加timestamp、eventId等），默认false提升性能
+     */
+    emit<T>(eventType: string, data: T, enhance?: boolean): void;
+    /**
+     * 异步发射事件
+     * @param eventType 事件类型
+     * @param data 事件数据
+     * @param enhance 是否增强事件数据（添加timestamp、eventId等），默认false提升性能
+     */
+    emitAsync<T>(eventType: string, data: T, enhance?: boolean): Promise<void>;
+    /**
+     * 监听事件
+     * @param eventType 事件类型
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     * @returns 监听器ID
+     */
+    on<T>(eventType: string, handler: (data: T) => void, config?: IEventListenerConfig): string;
+    /**
+     * 监听事件（一次性）
+     * @param eventType 事件类型
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     * @returns 监听器ID
+     */
+    once<T>(eventType: string, handler: (data: T) => void, config?: IEventListenerConfig): string;
+    /**
+     * 异步监听事件
+     * @param eventType 事件类型
+     * @param handler 异步事件处理器
+     * @param config 监听器配置
+     * @returns 监听器ID
+     */
+    onAsync<T>(eventType: string, handler: (data: T) => Promise<void>, config?: IEventListenerConfig): string;
+    /**
+     * 移除事件监听器
+     * @param eventType 事件类型
+     * @param listenerId 监听器ID
+     */
+    off(eventType: string, listenerId: string): boolean;
+    /**
+     * 移除指定事件类型的所有监听器
+     * @param eventType 事件类型
+     */
+    offAll(eventType: string): void;
+    /**
+     * 检查是否有指定事件的监听器
+     * @param eventType 事件类型
+     */
+    hasListeners(eventType: string): boolean;
+    /**
+     * 获取事件统计信息
+     * @param eventType 事件类型（可选）
+     */
+    getStats(eventType?: string): IEventStats | Map<string, IEventStats>;
+    /**
+     * 清空所有监听器
+     */
+    clear(): void;
+    /**
+     * 启用或禁用事件系统
+     * @param enabled 是否启用
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * 设置调试模式
+     * @param debug 是否启用调试
+     */
+    setDebugMode(debug: boolean): void;
+    /**
+     * 设置最大监听器数量
+     * @param max 最大数量
+     */
+    setMaxListeners(max: number): void;
+    /**
+     * 获取监听器数量
+     * @param eventType 事件类型
+     */
+    getListenerCount(eventType: string): number;
+    /**
+     * 设置事件批处理配置
+     * @param eventType 事件类型
+     * @param batchSize 批处理大小
+     * @param delay 延迟时间（毫秒）
+     */
+    setBatchConfig(eventType: string, batchSize: number, delay: number): void;
+    /**
+     * 刷新指定事件的批处理队列
+     * @param eventType 事件类型
+     */
+    flushBatch(eventType: string): void;
+    /**
+     * 重置事件统计
+     * @param eventType 事件类型（可选）
+     */
+    resetStats(eventType?: string): void;
+    /**
+     * 发射实体创建事件
+     * @param entityData 实体事件数据
+     */
+    emitEntityCreated(entityData: IEntityEventData): void;
+    /**
+     * 发射实体销毁事件
+     * @param entityData 实体事件数据
+     */
+    emitEntityDestroyed(entityData: IEntityEventData): void;
+    /**
+     * 发射组件添加事件
+     * @param componentData 组件事件数据
+     */
+    emitComponentAdded(componentData: IComponentEventData): void;
+    /**
+     * 发射组件移除事件
+     * @param componentData 组件事件数据
+     */
+    emitComponentRemoved(componentData: IComponentEventData): void;
+    /**
+     * 发射系统添加事件
+     * @param systemData 系统事件数据
+     */
+    emitSystemAdded(systemData: ISystemEventData): void;
+    /**
+     * 发射系统移除事件
+     * @param systemData 系统事件数据
+     */
+    emitSystemRemoved(systemData: ISystemEventData): void;
+    /**
+     * 发射场景变化事件
+     * @param sceneData 场景事件数据
+     */
+    emitSceneChanged(sceneData: ISceneEventData): void;
+    /**
+     * 发射性能警告事件
+     * @param performanceData 性能事件数据
+     */
+    emitPerformanceWarning(performanceData: IPerformanceEventData): void;
+    /**
+     * 监听实体创建事件
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     */
+    onEntityCreated(handler: (data: IEntityEventData) => void, config?: IEventListenerConfig): string;
+    /**
+     * 监听组件添加事件
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     */
+    onComponentAdded(handler: (data: IComponentEventData) => void, config?: IEventListenerConfig): string;
+    /**
+     * 监听系统错误事件
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     */
+    onSystemError(handler: (data: ISystemEventData) => void, config?: IEventListenerConfig): string;
+    /**
+     * 监听性能警告事件
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     */
+    onPerformanceWarning(handler: (data: IPerformanceEventData) => void, config?: IEventListenerConfig): string;
+    /**
+     * 验证事件类型（仅在debug模式下执行，提升性能）
+     * @param eventType 事件类型
+     */
+    private validateEventType;
+    /**
+     * 增强事件数据
+     * @param eventType 事件类型
+     * @param data 原始数据
+     */
+    private enhanceEventData;
+    /**
+     * 转换EventStats为IEventStats
+     * @param stats EventStats实例
+     */
+    private convertEventStats;
+}
+/**
+ * 全局事件总线实例
+ * 提供全局访问的事件总线
+ */
+export declare class GlobalEventBus {
+    private static instance;
+    /**
+     * 获取全局事件总线实例
+     * @param debugMode 是否启用调试模式
+     */
+    static getInstance(debugMode?: boolean): EventBus;
+    /**
+     * 重置全局事件总线实例
+     * @param debugMode 是否启用调试模式
+     */
+    static reset(debugMode?: boolean): EventBus;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/bin/ECS/Core/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../../src/ECS/Core/EventBus.ts"],"names":[],"mappings":"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"}

package/bin/ECS/Core/EventBus.js

@@ -0,0 +1,370 @@
+import { createLogger } from '../../Utils/Logger';
+import { TypeSafeEventSystem } from './EventSystem';
+import { ECSEventType, EventPriority, EventTypeValidator } from '../CoreEvents';
+/**
+ * 增强的事件总线实现
+ * 基于TypeSafeEventSystem，提供类型安全的事件发布订阅机制
+ */
+export class EventBus {
+    constructor(debugMode = false) {
+        this.eventIdCounter = 0;
+        this.isDebugMode = false;
+        this.eventSystem = new TypeSafeEventSystem();
+        this.isDebugMode = debugMode;
+    }
+    /**
+     * 发射事件
+     * @param eventType 事件类型
+     * @param data 事件数据
+     * @param enhance 是否增强事件数据（添加timestamp、eventId等），默认false提升性能
+     */
+    emit(eventType, data, enhance = false) {
+        this.validateEventType(eventType);
+        const finalData = enhance ? this.enhanceEventData(eventType, data) : data;
+        if (this.isDebugMode) {
+            EventBus._logger.info(`发射事件: ${eventType}`, finalData);
+        }
+        this.eventSystem.emitSync(eventType, finalData);
+    }
+    /**
+     * 异步发射事件
+     * @param eventType 事件类型
+     * @param data 事件数据
+     * @param enhance 是否增强事件数据（添加timestamp、eventId等），默认false提升性能
+     */
+    async emitAsync(eventType, data, enhance = false) {
+        this.validateEventType(eventType);
+        const finalData = enhance ? this.enhanceEventData(eventType, data) : data;
+        if (this.isDebugMode) {
+            EventBus._logger.info(`发射异步事件: ${eventType}`, finalData);
+        }
+        await this.eventSystem.emit(eventType, finalData);
+    }
+    /**
+     * 监听事件
+     * @param eventType 事件类型
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     * @returns 监听器ID
+     */
+    on(eventType, handler, config = {}) {
+        this.validateEventType(eventType);
+        const eventConfig = {
+            once: config.once || false,
+            priority: config.priority || EventPriority.NORMAL,
+            async: config.async || false
+        };
+        if (config.thisArg) {
+            eventConfig.thisArg = config.thisArg;
+        }
+        if (this.isDebugMode) {
+            EventBus._logger.info(`添加监听器: ${eventType}`, eventConfig);
+        }
+        return this.eventSystem.on(eventType, handler, eventConfig);
+    }
+    /**
+     * 监听事件（一次性）
+     * @param eventType 事件类型
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     * @returns 监听器ID
+     */
+    once(eventType, handler, config = {}) {
+        return this.on(eventType, handler, { ...config, once: true });
+    }
+    /**
+     * 异步监听事件
+     * @param eventType 事件类型
+     * @param handler 异步事件处理器
+     * @param config 监听器配置
+     * @returns 监听器ID
+     */
+    onAsync(eventType, handler, config = {}) {
+        return this.on(eventType, handler, { ...config, async: true });
+    }
+    /**
+     * 移除事件监听器
+     * @param eventType 事件类型
+     * @param listenerId 监听器ID
+     */
+    off(eventType, listenerId) {
+        if (this.isDebugMode) {
+            EventBus._logger.info(`移除监听器: ${listenerId} 事件: ${eventType}`);
+        }
+        return this.eventSystem.off(eventType, listenerId);
+    }
+    /**
+     * 移除指定事件类型的所有监听器
+     * @param eventType 事件类型
+     */
+    offAll(eventType) {
+        if (this.isDebugMode) {
+            EventBus._logger.info(`移除所有监听器: ${eventType}`);
+        }
+        this.eventSystem.offAll(eventType);
+    }
+    /**
+     * 检查是否有指定事件的监听器
+     * @param eventType 事件类型
+     */
+    hasListeners(eventType) {
+        return this.eventSystem.hasListeners(eventType);
+    }
+    /**
+     * 获取事件统计信息
+     * @param eventType 事件类型（可选）
+     */
+    getStats(eventType) {
+        const stats = this.eventSystem.getStats(eventType);
+        if (stats instanceof Map) {
+            // 转换Map中的每个EventStats为IEventStats
+            const result = new Map();
+            stats.forEach((stat, key) => {
+                result.set(key, this.convertEventStats(stat));
+            });
+            return result;
+        }
+        else {
+            return this.convertEventStats(stats);
+        }
+    }
+    /**
+     * 清空所有监听器
+     */
+    clear() {
+        if (this.isDebugMode) {
+            EventBus._logger.info('清空所有监听器');
+        }
+        this.eventSystem.clear();
+    }
+    /**
+     * 启用或禁用事件系统
+     * @param enabled 是否启用
+     */
+    setEnabled(enabled) {
+        this.eventSystem.setEnabled(enabled);
+    }
+    /**
+     * 设置调试模式
+     * @param debug 是否启用调试
+     */
+    setDebugMode(debug) {
+        this.isDebugMode = debug;
+    }
+    /**
+     * 设置最大监听器数量
+     * @param max 最大数量
+     */
+    setMaxListeners(max) {
+        this.eventSystem.setMaxListeners(max);
+    }
+    /**
+     * 获取监听器数量
+     * @param eventType 事件类型
+     */
+    getListenerCount(eventType) {
+        return this.eventSystem.getListenerCount(eventType);
+    }
+    /**
+     * 设置事件批处理配置
+     * @param eventType 事件类型
+     * @param batchSize 批处理大小
+     * @param delay 延迟时间（毫秒）
+     */
+    setBatchConfig(eventType, batchSize, delay) {
+        this.eventSystem.setBatchConfig(eventType, {
+            batchSize,
+            delay,
+            enabled: true
+        });
+    }
+    /**
+     * 刷新指定事件的批处理队列
+     * @param eventType 事件类型
+     */
+    flushBatch(eventType) {
+        this.eventSystem.flushBatch(eventType);
+    }
+    /**
+     * 重置事件统计
+     * @param eventType 事件类型（可选）
+     */
+    resetStats(eventType) {
+        this.eventSystem.resetStats(eventType);
+    }
+    // 便捷方法：发射预定义的ECS事件
+    /**
+     * 发射实体创建事件
+     * @param entityData 实体事件数据
+     */
+    emitEntityCreated(entityData) {
+        this.emit(ECSEventType.ENTITY_CREATED, entityData);
+    }
+    /**
+     * 发射实体销毁事件
+     * @param entityData 实体事件数据
+     */
+    emitEntityDestroyed(entityData) {
+        this.emit(ECSEventType.ENTITY_DESTROYED, entityData);
+    }
+    /**
+     * 发射组件添加事件
+     * @param componentData 组件事件数据
+     */
+    emitComponentAdded(componentData) {
+        this.emit(ECSEventType.COMPONENT_ADDED, componentData);
+    }
+    /**
+     * 发射组件移除事件
+     * @param componentData 组件事件数据
+     */
+    emitComponentRemoved(componentData) {
+        this.emit(ECSEventType.COMPONENT_REMOVED, componentData);
+    }
+    /**
+     * 发射系统添加事件
+     * @param systemData 系统事件数据
+     */
+    emitSystemAdded(systemData) {
+        this.emit(ECSEventType.SYSTEM_ADDED, systemData);
+    }
+    /**
+     * 发射系统移除事件
+     * @param systemData 系统事件数据
+     */
+    emitSystemRemoved(systemData) {
+        this.emit(ECSEventType.SYSTEM_REMOVED, systemData);
+    }
+    /**
+     * 发射场景变化事件
+     * @param sceneData 场景事件数据
+     */
+    emitSceneChanged(sceneData) {
+        this.emit(ECSEventType.SCENE_ACTIVATED, sceneData);
+    }
+    /**
+     * 发射性能警告事件
+     * @param performanceData 性能事件数据
+     */
+    emitPerformanceWarning(performanceData) {
+        this.emit(ECSEventType.PERFORMANCE_WARNING, performanceData);
+    }
+    // 便捷方法：监听预定义的ECS事件
+    /**
+     * 监听实体创建事件
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     */
+    onEntityCreated(handler, config) {
+        return this.on(ECSEventType.ENTITY_CREATED, handler, config);
+    }
+    /**
+     * 监听组件添加事件
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     */
+    onComponentAdded(handler, config) {
+        return this.on(ECSEventType.COMPONENT_ADDED, handler, config);
+    }
+    /**
+     * 监听系统错误事件
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     */
+    onSystemError(handler, config) {
+        return this.on(ECSEventType.SYSTEM_ERROR, handler, config);
+    }
+    /**
+     * 监听性能警告事件
+     * @param handler 事件处理器
+     * @param config 监听器配置
+     */
+    onPerformanceWarning(handler, config) {
+        return this.on(ECSEventType.PERFORMANCE_WARNING, handler, config);
+    }
+    // 私有方法
+    /**
+     * 验证事件类型（仅在debug模式下执行，提升性能）
+     * @param eventType 事件类型
+     */
+    validateEventType(eventType) {
+        // 只在debug模式下进行验证，提升生产环境性能
+        if (this.isDebugMode) {
+            if (!EventTypeValidator.isValid(eventType)) {
+                EventBus._logger.warn(`未知事件类型: ${eventType}`);
+                // 在调试模式下添加自定义事件类型
+                EventTypeValidator.addCustomType(eventType);
+            }
+        }
+    }
+    /**
+     * 增强事件数据
+     * @param eventType 事件类型
+     * @param data 原始数据
+     */
+    enhanceEventData(eventType, data) {
+        // 处理null或undefined数据
+        if (data === null || data === undefined) {
+            return {
+                timestamp: Date.now(),
+                eventId: `${eventType}_${++this.eventIdCounter}`,
+                source: 'EventBus'
+            };
+        }
+        const enhanced = data;
+        // 如果数据还没有基础事件属性，添加它们
+        if (!enhanced.timestamp) {
+            enhanced.timestamp = Date.now();
+        }
+        if (!enhanced.eventId) {
+            enhanced.eventId = `${eventType}_${++this.eventIdCounter}`;
+        }
+        if (!enhanced.source) {
+            enhanced.source = 'EventBus';
+        }
+        return enhanced;
+    }
+    /**
+     * 转换EventStats为IEventStats
+     * @param stats EventStats实例
+     */
+    convertEventStats(stats) {
+        return {
+            eventType: stats.eventType,
+            listenerCount: stats.listenerCount,
+            triggerCount: stats.triggerCount,
+            totalExecutionTime: stats.totalExecutionTime,
+            averageExecutionTime: stats.averageExecutionTime,
+            lastTriggerTime: stats.lastTriggerTime
+        };
+    }
+}
+EventBus._logger = createLogger('EventBus');
+/**
+ * 全局事件总线实例
+ * 提供全局访问的事件总线
+ */
+export class GlobalEventBus {
+    /**
+     * 获取全局事件总线实例
+     * @param debugMode 是否启用调试模式
+     */
+    static getInstance(debugMode = false) {
+        if (!this.instance) {
+            this.instance = new EventBus(debugMode);
+        }
+        return this.instance;
+    }
+    /**
+     * 重置全局事件总线实例
+     * @param debugMode 是否启用调试模式
+     */
+    static reset(debugMode = false) {
+        if (this.instance) {
+            this.instance.clear();
+        }
+        this.instance = new EventBus(debugMode);
+        return this.instance;
+    }
+}
+//# sourceMappingURL=EventBus.js.map

package/bin/ECS/Core/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../../src/ECS/Core/EventBus.ts"],"names":[],"mappings":"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"}