@esengine/ecs-framework 2.1.29 → 2.1.30

package/bin/Types/index.d.ts

@@ -0,0 +1,471 @@
+/**
+ * 框架核心类型定义
+ */
+/**
+ * 组件接口
+ *
+ * 定义组件的基本契约，所有组件都应该实现此接口
+ */
+export interface IComponent {
+    /** 组件唯一标识符 */
+    readonly id: number;
+    /** 组件所属的实体ID */
+    entityId?: string | number;
+    /** 组件启用状态 */
+    enabled: boolean;
+    /** 更新顺序 */
+    updateOrder: number;
+    /** 组件添加到实体时的回调 */
+    onAddedToEntity(): void;
+    /** 组件从实体移除时的回调 */
+    onRemovedFromEntity(): void;
+    /** 组件启用时的回调 */
+    onEnabled(): void;
+    /** 组件禁用时的回调 */
+    onDisabled(): void;
+    /** 更新组件 */
+    update(): void;
+}
+/**
+ * 系统基础接口
+ *
+ * 为现有的EntitySystem类提供类型定义
+ */
+export interface ISystemBase {
+    /** 系统名称 */
+    readonly systemName: string;
+    /** 更新顺序/优先级 */
+    updateOrder: number;
+    /** 系统启用状态 */
+    enabled: boolean;
+    /** 系统初始化 */
+    initialize(): void;
+    /** 更新系统（主要处理阶段） */
+    update(): void;
+    /** 延迟更新系统 */
+    lateUpdate?(): void;
+}
+/**
+ * 组件类型定义
+ *
+ * 用于类型安全的组件操作
+ */
+export type ComponentType<T extends IComponent = IComponent> = new (...args: unknown[]) => T;
+/**
+ * 事件总线接口
+ * 提供类型安全的事件发布订阅机制
+ */
+export interface IEventBus {
+    /**
+     * 发射事件
+     * @param eventType 事件类型
+     * @param data 事件数据
+     */
+    emit<T>(eventType: string, data: T): void;
+    /**
+     * 异步发射事件
+     * @param eventType 事件类型
+     * @param data 事件数据
+     */
+    emitAsync<T>(eventType: string, data: T): 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;
+}
+/**
+ * 事件监听器配置接口
+ */
+export interface IEventListenerConfig {
+    /** 是否只执行一次 */
+    once?: boolean;
+    /** 优先级（数字越大优先级越高） */
+    priority?: number;
+    /** 是否异步执行 */
+    async?: boolean;
+    /** 执行上下文 */
+    context?: unknown;
+}
+/**
+ * 事件统计信息接口
+ */
+export interface IEventStats {
+    /** 事件类型 */
+    eventType: string;
+    /** 监听器数量 */
+    listenerCount: number;
+    /** 触发次数 */
+    triggerCount: number;
+    /** 总执行时间（毫秒） */
+    totalExecutionTime: number;
+    /** 平均执行时间（毫秒） */
+    averageExecutionTime: number;
+    /** 最后触发时间 */
+    lastTriggerTime: number;
+}
+/**
+ * 事件数据基类接口
+ */
+export interface IEventData {
+    /** 事件时间戳 */
+    timestamp: number;
+    /** 事件来源 */
+    source?: string;
+    /** 事件ID */
+    eventId?: string;
+}
+/**
+ * 实体事件数据接口
+ */
+export interface IEntityEventData extends IEventData {
+    /** 实体ID */
+    entityId: number;
+    /** 实体名称 */
+    entityName?: string;
+    /** 实体标签 */
+    entityTag?: string;
+}
+/**
+ * 组件事件数据接口
+ */
+export interface IComponentEventData extends IEntityEventData {
+    /** 组件类型名称 */
+    componentType: string;
+    /** 组件实例 */
+    component?: IComponent;
+}
+/**
+ * 系统事件数据接口
+ */
+export interface ISystemEventData extends IEventData {
+    /** 系统名称 */
+    systemName: string;
+    /** 系统类型 */
+    systemType: string;
+}
+/**
+ * 场景事件数据接口
+ */
+export interface ISceneEventData extends IEventData {
+    /** 场景名称 */
+    sceneName: string;
+    /** 前一个场景名称 */
+    previousSceneName?: string;
+}
+/**
+ * 性能事件数据接口
+ */
+export interface IPerformanceEventData extends IEventData {
+    /** 操作类型 */
+    operation: string;
+    /** 执行时间（毫秒） */
+    executionTime: number;
+    /** 内存使用量 */
+    memoryUsage?: number;
+    /** 额外数据 */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * ECS调试配置接口
+ */
+export interface IECSDebugConfig {
+    /** 是否启用调试 */
+    enabled: boolean;
+    /** WebSocket服务器URL */
+    websocketUrl: string;
+    /** 是否自动重连 */
+    autoReconnect?: boolean;
+    /** 数据更新间隔（毫秒）- 已弃用，使用debugFrameRate替代 */
+    updateInterval?: number;
+    /** 调试数据发送帧率 (60fps, 30fps, 15fps) */
+    debugFrameRate?: 60 | 30 | 15;
+    /** 数据通道配置 */
+    channels: {
+        entities: boolean;
+        systems: boolean;
+        performance: boolean;
+        components: boolean;
+        scenes: boolean;
+    };
+}
+/**
+ * Core配置接口
+ */
+export interface ICoreConfig {
+    /** 是否启用调试模式 */
+    debug?: boolean;
+    /** 是否启用实体系统 */
+    enableEntitySystems?: boolean;
+    /** 调试配置 */
+    debugConfig?: IECSDebugConfig;
+}
+/**
+ * ECS调试数据接口
+ */
+export interface IECSDebugData {
+    /** 时间戳 */
+    timestamp: number;
+    /** 框架版本 */
+    frameworkVersion?: string;
+    /** 是否正在运行 */
+    isRunning: boolean;
+    /** 框架是否已加载 */
+    frameworkLoaded: boolean;
+    /** 当前场景名称 */
+    currentScene: string;
+    /** 实体数据 */
+    entities?: IEntityDebugData;
+    /** 系统数据 */
+    systems?: ISystemDebugData;
+    /** 性能数据 */
+    performance?: IPerformanceDebugData;
+    /** 组件数据 */
+    components?: IComponentDebugData;
+    /** 场景数据 */
+    scenes?: ISceneDebugData;
+}
+/**
+ * 实体层次结构节点接口
+ */
+export interface IEntityHierarchyNode {
+    id: number;
+    name: string;
+    active: boolean;
+    enabled: boolean;
+    activeInHierarchy: boolean;
+    componentCount: number;
+    componentTypes: string[];
+    parentId: number | null;
+    children: IEntityHierarchyNode[];
+    depth: number;
+    tag: number;
+    updateOrder: number;
+}
+/**
+ * 实体调试数据接口
+ */
+export interface IEntityDebugData {
+    /** 总实体数 */
+    totalEntities: number;
+    /** 激活实体数 */
+    activeEntities: number;
+    /** 待添加实体数 */
+    pendingAdd: number;
+    /** 待移除实体数 */
+    pendingRemove: number;
+    /** 按Archetype分组的实体分布 */
+    entitiesPerArchetype: Array<{
+        signature: string;
+        count: number;
+        memory: number;
+    }>;
+    /** 组件数量最多的前几个实体 */
+    topEntitiesByComponents: Array<{
+        id: string;
+        name: string;
+        componentCount: number;
+        memory: number;
+    }>;
+    /** 实体详情列表 */
+    entityDetails?: Array<{
+        id: string | number;
+        name?: string;
+        tag?: string;
+        enabled: boolean;
+        componentCount: number;
+        components: string[];
+    }>;
+    /** 实体层次结构（根实体） */
+    entityHierarchy?: Array<{
+        id: number;
+        name: string;
+        active: boolean;
+        enabled: boolean;
+        activeInHierarchy: boolean;
+        componentCount: number;
+        componentTypes: string[];
+        parentId: number | null;
+        children: IEntityHierarchyNode[];
+        depth: number;
+        tag: number;
+        updateOrder: number;
+    }>;
+    /** 实体详细信息映射 */
+    entityDetailsMap?: Record<number, {
+        id: number;
+        name: string;
+        active: boolean;
+        enabled: boolean;
+        activeInHierarchy: boolean;
+        destroyed: boolean;
+        tag: number;
+        updateOrder: number;
+        componentMask: string;
+        parentId: number | null;
+        parentName: string | null;
+        childCount: number;
+        childIds: number[];
+        depth: number;
+        components: Array<{
+            typeName: string;
+            properties: Record<string, unknown>;
+        }>;
+        componentCount: number;
+        componentTypes: string[];
+    }>;
+}
+/**
+ * 系统调试数据接口
+ */
+export interface ISystemDebugData {
+    /** 总系统数 */
+    totalSystems: number;
+    /** 系统信息列表 */
+    systemsInfo: Array<{
+        name: string;
+        type: string;
+        entityCount: number;
+        executionTime?: number;
+        averageExecutionTime?: number;
+        minExecutionTime?: number;
+        maxExecutionTime?: number;
+        executionTimeHistory?: number[];
+        memoryUsage?: number;
+        updateOrder: number;
+        enabled: boolean;
+        lastUpdateTime?: number;
+    }>;
+}
+/**
+ * 性能调试数据接口
+ */
+export interface IPerformanceDebugData {
+    /** ECS框架执行时间（毫秒） */
+    frameTime: number;
+    /** 引擎总帧时间（毫秒） */
+    engineFrameTime?: number;
+    /** ECS占总帧时间百分比 */
+    ecsPercentage?: number;
+    /** 内存使用量（MB） */
+    memoryUsage: number;
+    /** FPS */
+    fps: number;
+    /** 平均ECS执行时间（毫秒） */
+    averageFrameTime: number;
+    /** 最小ECS执行时间（毫秒） */
+    minFrameTime: number;
+    /** 最大ECS执行时间（毫秒） */
+    maxFrameTime: number;
+    /** ECS执行时间历史记录 */
+    frameTimeHistory: number[];
+    /** 系统性能详情 */
+    systemPerformance: Array<{
+        systemName: string;
+        averageTime: number;
+        maxTime: number;
+        minTime: number;
+        samples: number;
+        percentage?: number;
+    }>;
+    /** 系统占比分析数据 */
+    systemBreakdown?: Array<{
+        systemName: string;
+        executionTime: number;
+        percentage: number;
+    }>;
+    /** 内存分配详情 */
+    memoryDetails?: {
+        entities: number;
+        components: number;
+        systems: number;
+        pooled: number;
+        totalMemory: number;
+        usedMemory: number;
+        freeMemory: number;
+        gcCollections: number;
+    };
+}
+/**
+ * 组件调试数据接口
+ */
+export interface IComponentDebugData {
+    /** 组件类型数 */
+    componentTypes: number;
+    /** 组件实例总数 */
+    componentInstances: number;
+    /** 组件分布统计 */
+    componentStats: Array<{
+        typeName: string;
+        instanceCount: number;
+        memoryPerInstance: number;
+        totalMemory: number;
+        poolSize: number;
+        poolUtilization: number;
+        averagePerEntity?: number;
+    }>;
+}
+/**
+ * 场景调试数据接口
+ */
+export interface ISceneDebugData {
+    /** 当前场景名称 */
+    currentSceneName: string;
+    /** 场景是否已初始化 */
+    isInitialized: boolean;
+    /** 场景运行时间（秒） */
+    sceneRunTime: number;
+    /** 场景实体数 */
+    sceneEntityCount: number;
+    /** 场景系统数 */
+    sceneSystemCount: number;
+    /** 场景内存使用量 */
+    sceneMemory: number;
+    /** 场景启动时间 */
+    sceneUptime: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/bin/Types/index.d.ts.map

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

package/bin/Types/index.js

@@ -0,0 +1,5 @@
+/**
+ * 框架核心类型定义
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/bin/Types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/bin/Utils/Debug/ComponentDataCollector.d.ts

@@ -0,0 +1,28 @@
+import { IComponentDebugData } from '../../Types';
+/**
+ * 组件数据收集器
+ */
+export declare class ComponentDataCollector {
+    private static componentSizeCache;
+    /**
+     * 收集组件数据（轻量版，不计算实际内存大小）
+     */
+    collectComponentData(): IComponentDebugData;
+    /**
+     * 获取组件类型的估算内存大小（基于预设值，不进行实际计算）
+     */
+    private getEstimatedComponentSize;
+    private calculateQuickObjectSize;
+    /**
+     * 为内存快照功能提供的详细内存计算
+     * 只在用户主动请求内存快照时调用
+     */
+    calculateDetailedComponentMemory(typeName: string): number;
+    /**
+     * 估算对象内存大小（仅用于内存快照）
+     * 优化版本：减少递归深度，提高性能
+     */
+    private estimateObjectSize;
+    static clearCache(): void;
+}
+//# sourceMappingURL=ComponentDataCollector.d.ts.map

package/bin/Utils/Debug/ComponentDataCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentDataCollector.d.ts","sourceRoot":"","sources":["../../../src/Utils/Debug/ComponentDataCollector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD;;GAEG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA6B;IAE9D;;OAEG;IACI,oBAAoB,IAAI,mBAAmB;IA6ElD;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,wBAAwB;IA4ChC;;;OAGG;IACI,gCAAgC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAwBjE;;;OAGG;IACH,OAAO,CAAC,kBAAkB;WAoEZ,UAAU,IAAI,IAAI;CAGnC"}