@esengine/ecs-framework 2.1.23 → 2.1.25

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.1.23
+ * @esengine/ecs-framework v2.1.25
  * TypeScript definitions
  */
 /**
@@ -4000,37 +4000,38 @@ declare function createECSAPI(scene: Scene, querySystem: QuerySystem, eventSyste
  * 实体数据收集器
  */
 declare class EntityDataCollector {
-    /**
-     * 收集实体数据
-     */
     collectEntityData(): IEntityDebugData;
-    /**
-     * 获取空的实体数据
-     */
-    private getEmptyEntityDebugData;
-    /**
-     * 计算实体统计信息
-     */
-    private calculateFallbackEntityStats;
-    /**
-     * 收集原型数据
-     */
+    getRawEntityList(): Array<{
+        id: number;
+        name: string;
+        active: boolean;
+        enabled: boolean;
+        activeInHierarchy: boolean;
+        componentCount: number;
+        componentTypes: string[];
+        parentId: number | null;
+        childIds: number[];
+        depth: number;
+        tag: number;
+        updateOrder: number;
+    }>;
+    getEntityDetails(entityId: number): any;
+    private getSceneInfo;
+    collectEntityDataWithMemory(): IEntityDebugData;
     private collectArchetypeData;
-    /**
-     * 提取原型统计信息
-     */
+    private getArchetypeDistributionFast;
+    private getTopEntitiesByComponentsFast;
+    private collectArchetypeDataWithMemory;
     private extractArchetypeStatistics;
-    /**
-     * 计算实体内存使用量
-     */
+    private extractArchetypeStatisticsWithMemory;
+    private getArchetypeDistribution;
+    private getArchetypeDistributionWithMemory;
+    private getTopEntitiesByComponents;
+    private getTopEntitiesByComponentsWithMemory;
+    private getEmptyEntityDebugData;
+    private calculateFallbackEntityStats;
     estimateEntityMemoryUsage(entity: any): number;
-    /**
-     * 计算对象大小
-     */
     calculateObjectSize(obj: any, excludeKeys?: string[]): number;
-    /**
-     * 构建实体层次结构树
-     */
     private buildEntityHierarchyTree;
     /**
      * 构建实体层次结构节点
@@ -4047,39 +4048,42 @@ declare class EntityDataCollector {
     /**
      * 提取组件详细信息
      */
-    private extractComponentDetails;
+    extractComponentDetails(components: Component[]): Array<{
+        typeName: string;
+        properties: Record<string, any>;
+    }>;
+    /**
+     * 获取组件的完整属性信息（仅在需要时调用）
+     */
+    getComponentProperties(entityId: number, componentIndex: number): Record<string, any>;
     /**
      * 格式化属性值
      */
     private formatPropertyValue;
     /**
-     * 获取Archetype分布
+     * 格式化对象第一层
      */
-    private getArchetypeDistribution;
-    /**
-     * 获取组件数量最多的实体
-     */
-    private getTopEntitiesByComponents;
+    private formatObjectFirstLevel;
     /**
-     * 提取实体详细信息
+     * 创建懒加载占位符
      */
-    private extractEntityDetails;
+    private createLazyLoadPlaceholder;
     /**
-     * 生成组件掩码的可读描述
+     * 获取对象摘要信息
      */
-    private generateComponentMaskDescription;
+    private getObjectSummary;
     /**
-     * 生成实体状态描述
+     * 生成对象ID
      */
-    private generateEntityStatusDescription;
+    private generateObjectId;
     /**
-     * 提取变换信息
+     * 展开懒加载对象（供调试面板调用）
      */
-    private extractTransformInfo;
+    expandLazyObject(entityId: number, componentIndex: number, propertyPath: string): any;
     /**
-     * 格式化Vector3对象
+     * 根据路径获取对象
      */
-    private formatVector3;
+    private getObjectByPath;
 }
 
 /**
@@ -4127,18 +4131,27 @@ declare class PerformanceDataCollector {
  * 组件数据收集器
  */
 declare class ComponentDataCollector {
+    private static componentSizeCache;
     /**
-     * 收集组件数据
+     * 收集组件数据（轻量版，不计算实际内存大小）
      */
     collectComponentData(): IComponentDebugData;
     /**
-     * 计算组件实际内存大小
+     * 获取组件类型的估算内存大小（基于预设值，不进行实际计算）
      */
-    private calculateComponentMemorySize;
+    private getEstimatedComponentSize;
+    private calculateQuickObjectSize;
     /**
-     * 估算对象内存大小
+     * 为内存快照功能提供的详细内存计算
+     * 只在用户主动请求内存快照时调用
+     */
+    calculateDetailedComponentMemory(typeName: string): number;
+    /**
+     * 估算对象内存大小（仅用于内存快照）
+     * 优化版本：减少递归深度，提高性能
      */
     private estimateObjectSize;
+    static clearCache(): void;
 }
 
 /**
@@ -4257,6 +4270,22 @@ declare class DebugManager {
      * 处理来自调试面板的消息
      */
     private handleMessage;
+    /**
+     * 处理展开懒加载对象请求
+     */
+    private handleExpandLazyObjectRequest;
+    /**
+     * 处理获取组件属性请求
+     */
+    private handleGetComponentPropertiesRequest;
+    /**
+     * 处理获取原始实体列表请求
+     */
+    private handleGetRawEntityListRequest;
+    /**
+     * 处理获取实体详情请求
+     */
+    private handleGetEntityDetailsRequest;
     /**
      * 处理内存快照请求
      */
@@ -4270,17 +4299,11 @@ declare class DebugManager {
      */
     private collectBaseMemoryInfo;
     /**
-     * 收集实体内存统计
-     */
-    private collectEntityMemoryStats;
-    /**
-     * 收集组件内存统计
+     * 收集组件内存统计（仅用于内存快照）
      */
     private collectComponentMemoryStats;
-    /**
-     * 收集系统内存统计
-     */
     private collectSystemMemoryStats;
+    private calculateQuickSystemSize;
     /**
      * 收集对象池内存统计
      */