@esengine/ecs-framework 2.1.47 → 2.1.48

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.1.47
+ * @esengine/ecs-framework v2.1.48
  * TypeScript definitions
  */
 /**
@@ -1483,6 +1483,7 @@ declare class LoggerManager {
     private static _instance;
     private _loggers;
     private _defaultLogger;
+    private _defaultLevel;
     private constructor();
     /**
      * 获取日志管理器实例
@@ -3430,6 +3431,7 @@ declare abstract class EntitySystem implements ISystemBase {
     private _initialized;
     private _matcher;
     private _trackedEntities;
+    private _eventListeners;
     /**
      * 获取系统处理的实体列表（动态查询）
      */
@@ -3554,7 +3556,7 @@ declare abstract class EntitySystem implements ISystemBase {
      *
      * @param entities 要处理的实体列表
      */
-    protected process(_entities: Entity[]): void;
+    protected process(entities: Entity[]): void;
     /**
      * 后期处理实体列表
      *
@@ -3611,7 +3613,7 @@ declare abstract class EntitySystem implements ISystemBase {
      *
      * @param entity 被添加的实体
      */
-    protected onAdded(_entity: Entity): void;
+    protected onAdded(entity: Entity): void;
     /**
      * 当实体从系统中移除时调用
      *
@@ -3619,7 +3621,38 @@ declare abstract class EntitySystem implements ISystemBase {
      *
      * @param entity 被移除的实体
      */
-    protected onRemoved(_entity: Entity): void;
+    protected onRemoved(entity: Entity): void;
+    /**
+     * 添加事件监听器
+     *
+     * 推荐使用此方法而不是直接调用eventSystem.on()，
+     * 这样可以确保系统移除时自动清理监听器，避免内存泄漏。
+     *
+     * @param eventType 事件类型
+     * @param handler 事件处理函数
+     * @param config 监听器配置
+     */
+    protected addEventListener<T = any>(eventType: string, handler: EventHandler<T>, config?: EventListenerConfig): void;
+    /**
+     * 移除特定的事件监听器
+     *
+     * @param eventType 事件类型
+     * @param handler 事件处理函数
+     */
+    protected removeEventListener<T = any>(eventType: string, handler: EventHandler<T>): void;
+    /**
+     * 清理所有事件监听器
+     *
+     * 系统移除时自动调用，清理所有通过addEventListener添加的监听器。
+     */
+    private cleanupEventListeners;
+    /**
+     * 系统销毁时的回调
+     *
+     * 当系统从场景中移除时调用，子类可以重写此方法进行清理操作。
+     * 注意：事件监听器会被框架自动清理，无需手动处理。
+     */
+    protected onDestroy(): void;
 }
 
 /**
@@ -5019,8 +5052,16 @@ declare class WorldManager {
  * 实体数据收集器
  */
 declare class EntityDataCollector {
-    collectEntityData(): IEntityDebugData;
-    getRawEntityList(): Array<{
+    /**
+     * 收集实体数据
+     * @param scene 场景实例
+     */
+    collectEntityData(scene?: IScene | null): IEntityDebugData;
+    /**
+     * 获取原始实体列表
+     * @param scene 场景实例
+     */
+    getRawEntityList(scene?: IScene | null): Array<{
         id: number;
         name: string;
         active: boolean;
@@ -5034,9 +5075,18 @@ declare class EntityDataCollector {
         tag: number;
         updateOrder: number;
     }>;
-    getEntityDetails(entityId: number): any;
+    /**
+     * 获取实体详细信息
+     * @param entityId 实体ID
+     * @param scene 场景实例
+     */
+    getEntityDetails(entityId: number, scene?: IScene | null): any;
     private getSceneInfo;
-    collectEntityDataWithMemory(): IEntityDebugData;
+    /**
+     * 收集实体数据（包含内存信息）
+     * @param scene 场景实例
+     */
+    collectEntityDataWithMemory(scene?: IScene | null): IEntityDebugData;
     private collectArchetypeData;
     private getArchetypeDistributionFast;
     private getTopEntitiesByComponentsFast;
@@ -5073,8 +5123,11 @@ declare class EntityDataCollector {
     }>;
     /**
      * 获取组件的完整属性信息（仅在需要时调用）
+     * @param entityId 实体ID
+     * @param componentIndex 组件索引
+     * @param scene 场景实例
      */
-    getComponentProperties(entityId: number, componentIndex: number): Record<string, any>;
+    getComponentProperties(entityId: number, componentIndex: number, scene?: IScene | null): Record<string, any>;
     /**
      * 格式化属性值
      */
@@ -5097,8 +5150,12 @@ declare class EntityDataCollector {
     private generateObjectId;
     /**
      * 展开懒加载对象（供调试面板调用）
+     * @param entityId 实体ID
+     * @param componentIndex 组件索引
+     * @param propertyPath 属性路径
+     * @param scene 场景实例
      */
-    expandLazyObject(entityId: number, componentIndex: number, propertyPath: string): any;
+    expandLazyObject(entityId: number, componentIndex: number, propertyPath: string, scene?: IScene | null): any;
     /**
      * 根据路径获取对象
      */
@@ -5111,8 +5168,10 @@ declare class EntityDataCollector {
 declare class SystemDataCollector {
     /**
      * 收集系统数据
+     * @param performanceMonitor 性能监视器实例
+     * @param scene 场景实例
      */
-    collectSystemData(performanceMonitor: any): ISystemDebugData;
+    collectSystemData(performanceMonitor: any, scene?: IScene | null): ISystemDebugData;
 }
 
 /**
@@ -5153,8 +5212,9 @@ declare class ComponentDataCollector {
     private static componentSizeCache;
     /**
      * 收集组件数据（轻量版，不计算实际内存大小）
+     * @param scene 场景实例
      */
-    collectComponentData(): IComponentDebugData;
+    collectComponentData(scene?: IScene | null): IComponentDebugData;
     /**
      * 获取组件类型的估算内存大小（基于预设值，不进行实际计算）
      */
@@ -5163,8 +5223,10 @@ declare class ComponentDataCollector {
     /**
      * 为内存快照功能提供的详细内存计算
      * 只在用户主动请求内存快照时调用
+     * @param typeName 组件类型名称
+     * @param scene 场景实例
      */
-    calculateDetailedComponentMemory(typeName: string): number;
+    calculateDetailedComponentMemory(typeName: string, scene?: IScene | null): number;
     /**
      * 估算对象内存大小（仅用于内存快照）
      * 优化版本：减少递归深度，提高性能
@@ -5180,8 +5242,9 @@ declare class SceneDataCollector {
     private sceneStartTime;
     /**
      * 收集场景数据
+     * @param scene 场景实例
      */
-    collectSceneData(): ISceneDebugData;
+    collectSceneData(scene?: IScene | null): ISceneDebugData;
     /**
      * 设置场景开始时间
      */
@@ -5260,11 +5323,18 @@ declare class DebugManager {
     private performanceCollector;
     private componentCollector;
     private sceneCollector;
+    private sceneProvider;
+    private performanceMonitorProvider;
     private frameCounter;
     private lastSendTime;
     private sendInterval;
     private isRunning;
-    constructor(core: Core, config: IECSDebugConfig);
+    /**
+     * 构造调试管理器
+     * @param core Core实例
+     * @param config 调试配置
+     */
+    constructor(core: any, config: IECSDebugConfig);
     /**
      * 启动调试管理器
      */