@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/Plugins/DebugPlugin.js

@@ -0,0 +1,248 @@
+import { __decorate, __metadata } from "tslib";
+import { createLogger } from '../Utils/Logger';
+import { WorldManager } from '../ECS/WorldManager';
+import { Injectable } from '../Core/DI/Decorators';
+const logger = createLogger('DebugPlugin');
+/**
+ * ECS 调试插件
+ *
+ * 提供运行时调试功能：
+ * - 实时查看实体和组件信息
+ * - System 执行统计
+ * - 性能监控
+ * - 实体查询
+ *
+ * @example
+ * ```typescript
+ * const core = Core.create();
+ * const debugPlugin = new DebugPlugin({ autoStart: true, updateInterval: 1000 });
+ * await core.pluginManager.install(debugPlugin);
+ *
+ * // 获取调试信息
+ * const stats = debugPlugin.getStats();
+ * console.log('Total entities:', stats.totalEntities);
+ *
+ * // 查询实体
+ * const entities = debugPlugin.queryEntities({ tag: 1 });
+ * ```
+ */
+let DebugPlugin = class DebugPlugin {
+    /**
+     * 创建调试插件实例
+     *
+     * @param options - 配置选项
+     */
+    constructor(options) {
+        this.name = '@esengine/debug-plugin';
+        this.version = '1.0.0';
+        this.worldManager = null;
+        this.updateTimer = null;
+        this.autoStart = options?.autoStart ?? false;
+        this.updateInterval = options?.updateInterval ?? 1000;
+    }
+    /**
+     * 安装插件
+     */
+    async install(_core, services) {
+        this.worldManager = services.resolve(WorldManager);
+        logger.info('ECS Debug Plugin installed');
+        if (this.autoStart) {
+            this.start();
+        }
+    }
+    /**
+     * 卸载插件
+     */
+    async uninstall() {
+        this.stop();
+        this.worldManager = null;
+        logger.info('ECS Debug Plugin uninstalled');
+    }
+    /**
+     * 实现 IService 接口
+     */
+    dispose() {
+        this.stop();
+        this.worldManager = null;
+    }
+    /**
+     * 启动调试监控
+     */
+    start() {
+        if (this.updateTimer) {
+            logger.warn('Debug monitoring already started');
+            return;
+        }
+        logger.info('Starting debug monitoring');
+        this.updateTimer = setInterval(() => {
+            this.logStats();
+        }, this.updateInterval);
+    }
+    /**
+     * 停止调试监控
+     */
+    stop() {
+        if (this.updateTimer) {
+            clearInterval(this.updateTimer);
+            this.updateTimer = null;
+            logger.info('Debug monitoring stopped');
+        }
+    }
+    /**
+     * 获取当前 ECS 统计信息
+     */
+    getStats() {
+        if (!this.worldManager) {
+            throw new Error('Plugin not installed');
+        }
+        const scenes = [];
+        let totalEntities = 0;
+        let totalSystems = 0;
+        const worlds = this.worldManager.getAllWorlds();
+        for (const world of worlds) {
+            for (const scene of world.getAllScenes()) {
+                const sceneInfo = this.getSceneInfo(scene);
+                scenes.push(sceneInfo);
+                totalEntities += sceneInfo.entityCount;
+                totalSystems += sceneInfo.systems.length;
+            }
+        }
+        return {
+            scenes,
+            totalEntities,
+            totalSystems,
+            timestamp: Date.now()
+        };
+    }
+    /**
+     * 获取场景调试信息
+     */
+    getSceneInfo(scene) {
+        const entities = scene.entities.buffer;
+        const systems = scene.systems;
+        return {
+            name: scene.name,
+            entityCount: entities.length,
+            systems: systems.map((sys) => this.getSystemInfo(sys)),
+            entities: entities.map((entity) => this.getEntityInfo(entity))
+        };
+    }
+    /**
+     * 获取系统调试信息
+     */
+    getSystemInfo(system) {
+        const perfStats = system.getPerformanceStats();
+        const performance = perfStats ? {
+            avgExecutionTime: perfStats.averageTime,
+            maxExecutionTime: perfStats.maxTime,
+            totalCalls: perfStats.executionCount
+        } : undefined;
+        return {
+            name: system.constructor.name,
+            enabled: system.enabled,
+            updateOrder: system.updateOrder,
+            entityCount: system.entities.length,
+            ...(performance !== undefined && { performance })
+        };
+    }
+    /**
+     * 获取实体调试信息
+     */
+    getEntityInfo(entity) {
+        const components = entity.components;
+        return {
+            id: entity.id,
+            name: entity.name,
+            enabled: entity.enabled,
+            tag: entity.tag,
+            componentCount: components.length,
+            components: components.map((comp) => this.getComponentInfo(comp))
+        };
+    }
+    /**
+     * 获取组件调试信息
+     */
+    getComponentInfo(component) {
+        const type = component.constructor.name;
+        const data = {};
+        for (const key of Object.keys(component)) {
+            if (!key.startsWith('_')) {
+                const value = component[key];
+                if (typeof value !== 'function') {
+                    data[key] = value;
+                }
+            }
+        }
+        return { type, data };
+    }
+    /**
+     * 查询实体
+     *
+     * @param filter - 查询过滤器
+     */
+    queryEntities(filter) {
+        if (!this.worldManager) {
+            throw new Error('Plugin not installed');
+        }
+        const results = [];
+        const worlds = this.worldManager.getAllWorlds();
+        for (const world of worlds) {
+            for (const scene of world.getAllScenes()) {
+                if (filter.sceneName && scene.name !== filter.sceneName) {
+                    continue;
+                }
+                for (const entity of scene.entities.buffer) {
+                    if (filter.tag !== undefined && entity.tag !== filter.tag) {
+                        continue;
+                    }
+                    if (filter.name && !entity.name.includes(filter.name)) {
+                        continue;
+                    }
+                    if (filter.hasComponent) {
+                        const hasComp = entity.components.some((c) => c.constructor.name === filter.hasComponent);
+                        if (!hasComp) {
+                            continue;
+                        }
+                    }
+                    results.push(this.getEntityInfo(entity));
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * 打印统计信息到日志
+     */
+    logStats() {
+        const stats = this.getStats();
+        logger.info('=== ECS Debug Stats ===');
+        logger.info(`Total Entities: ${stats.totalEntities}`);
+        logger.info(`Total Systems: ${stats.totalSystems}`);
+        logger.info(`Scenes: ${stats.scenes.length}`);
+        for (const scene of stats.scenes) {
+            logger.info(`\n[Scene: ${scene.name}]`);
+            logger.info(`  Entities: ${scene.entityCount}`);
+            logger.info(`  Systems: ${scene.systems.length}`);
+            for (const system of scene.systems) {
+                const perfStr = system.performance
+                    ? ` | Avg: ${system.performance.avgExecutionTime.toFixed(2)}ms, Max: ${system.performance.maxExecutionTime.toFixed(2)}ms`
+                    : '';
+                logger.info(`    - ${system.name} (${system.enabled ? 'enabled' : 'disabled'}) | Entities: ${system.entityCount}${perfStr}`);
+            }
+        }
+        logger.info('========================\n');
+    }
+    /**
+     * 导出调试数据为 JSON
+     */
+    exportJSON() {
+        const stats = this.getStats();
+        return JSON.stringify(stats, null, 2);
+    }
+};
+DebugPlugin = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Object])
+], DebugPlugin);
+export { DebugPlugin };
+//# sourceMappingURL=DebugPlugin.js.map

package/bin/Plugins/DebugPlugin.js.map

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

package/bin/Plugins/index.d.ts

@@ -0,0 +1,2 @@
+export * from './DebugPlugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/bin/Plugins/index.js

@@ -0,0 +1,2 @@
+export * from './DebugPlugin';
+//# sourceMappingURL=index.js.map

package/bin/Plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/bin/Types/IUpdatable.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 可更新接口
+ *
+ * 实现此接口的服务将在每帧被Core自动调用update方法
+ */
+export interface IUpdatable {
+    /**
+     * 每帧更新方法
+     *
+     * @param deltaTime - 帧时间间隔（秒），可选参数
+     */
+    update(deltaTime?: number): void;
+}
+/**
+ * 检查对象是否实现了IUpdatable接口
+ */
+export declare function isUpdatable(obj: any): obj is IUpdatable;
+//# sourceMappingURL=IUpdatable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IUpdatable.d.ts","sourceRoot":"","sources":["../../src/Types/IUpdatable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACvB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,UAAU,CAEvD"}

package/bin/Types/IUpdatable.js

@@ -0,0 +1,7 @@
+/**
+ * 检查对象是否实现了IUpdatable接口
+ */
+export function isUpdatable(obj) {
+    return obj && typeof obj.update === 'function';
+}
+//# sourceMappingURL=IUpdatable.js.map

package/bin/Types/IUpdatable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUpdatable.js","sourceRoot":"","sources":["../../src/Types/IUpdatable.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAQ;IAChC,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC;AACnD,CAAC"}

package/bin/Types/TypeHelpers.d.ts

@@ -0,0 +1,238 @@
+/**
+ * TypeScript类型工具集
+ *
+ * 提供高级类型推断和类型安全的工具类型
+ */
+import type { IComponent } from './index';
+import { Component } from '../ECS/Component';
+/**
+ * 组件类型提取器
+ * 从组件构造函数中提取实例类型
+ */
+export type ComponentInstance<T> = T extends new (...args: any[]) => infer R ? R : never;
+/**
+ * 组件构造函数类型
+ *
+ * 与 ComponentType 保持一致，避免类型转换
+ */
+export type ComponentConstructor<T extends IComponent = IComponent> = new (...args: any[]) => T;
+/**
+ * 组件类型的通用约束
+ *
+ * 用于确保类型参数是有效的组件构造函数
+ */
+export type AnyComponentConstructor = ComponentConstructor<any>;
+/**
+ * 多组件类型提取
+ * 从组件构造函数数组中提取所有实例类型的联合
+ */
+export type ExtractComponents<T extends readonly ComponentConstructor[]> = {
+    [K in keyof T]: ComponentInstance<T[K]>;
+};
+/**
+ * 组件类型映射
+ * 将组件构造函数数组转换为实例类型的元组
+ */
+export type ComponentTypeMap<T extends readonly ComponentConstructor[]> = {
+    [K in keyof T]: T[K] extends ComponentConstructor<infer C> ? C : never;
+};
+/**
+ * 实体with组件的类型
+ * 表示一个实体确定拥有某些组件
+ */
+export interface EntityWithComponents<T extends readonly ComponentConstructor[]> {
+    readonly id: number;
+    readonly name: string;
+    /**
+     * 类型安全的组件获取
+     * 确保返回非空的组件实例
+     */
+    getComponent<C extends ComponentConstructor>(componentType: C): ComponentInstance<C>;
+    /**
+     * 检查是否拥有组件
+     */
+    hasComponent<C extends ComponentConstructor>(componentType: C): boolean;
+    /**
+     * 获取所有组件
+     */
+    readonly components: ComponentTypeMap<T>;
+}
+/**
+ * 查询结果类型
+ * 根据查询条件推断实体必定拥有的组件
+ */
+export type QueryResult<All extends readonly ComponentConstructor[] = [], Any extends readonly ComponentConstructor[] = [], None extends readonly ComponentConstructor[] = []> = {
+    /**
+     * 实体列表，确保拥有All中的所有组件
+     */
+    readonly entities: ReadonlyArray<EntityWithComponents<All>>;
+    /**
+     * 实体数量
+     */
+    readonly length: number;
+    /**
+     * 遍历实体
+     */
+    forEach(callback: (entity: EntityWithComponents<All>, index: number) => void): void;
+    /**
+     * 映射转换
+     */
+    map<R>(callback: (entity: EntityWithComponents<All>, index: number) => R): R[];
+    /**
+     * 过滤实体
+     */
+    filter(predicate: (entity: EntityWithComponents<All>, index: number) => boolean): QueryResult<All, Any, None>;
+};
+/**
+ * System处理的实体类型
+ * 根据Matcher推断System处理的实体类型
+ */
+export type SystemEntityType<M> = M extends {
+    getCondition(): {
+        all: infer All extends readonly ComponentConstructor[];
+    };
+} ? EntityWithComponents<All> : never;
+/**
+ * 组件字段类型提取
+ * 提取组件中所有可序列化的字段
+ */
+export type SerializableFields<T> = {
+    [K in keyof T]: T[K] extends Function ? never : K;
+}[keyof T];
+/**
+ * 只读组件类型
+ * 将组件的所有字段转为只读
+ */
+export type ReadonlyComponent<T extends IComponent> = {
+    readonly [K in keyof T]: T[K];
+};
+/**
+ * 部分组件类型
+ * 用于组件更新操作
+ */
+export type PartialComponent<T extends IComponent> = {
+    [K in SerializableFields<T>]?: T[K];
+};
+/**
+ * 组件类型约束
+ * 确保类型参数是有效的组件
+ */
+export type ValidComponent<T> = T extends Component ? T : never;
+/**
+ * 组件数组约束
+ * 确保数组中的所有元素都是组件构造函数
+ */
+export type ValidComponentArray<T extends readonly any[]> = T extends readonly ComponentConstructor[] ? T : never;
+/**
+ * 事件处理器类型
+ * 提供类型安全的事件处理
+ */
+export type TypedEventHandler<T> = (data: T) => void | Promise<void>;
+/**
+ * 系统生命周期钩子类型
+ */
+export interface SystemLifecycleHooks<T extends readonly ComponentConstructor[]> {
+    /**
+     * 实体添加到系统时调用
+     */
+    onAdded?: (entity: EntityWithComponents<T>) => void;
+    /**
+     * 实体从系统移除时调用
+     */
+    onRemoved?: (entity: EntityWithComponents<T>) => void;
+    /**
+     * 系统初始化时调用
+     */
+    onInitialize?: () => void;
+    /**
+     * 系统销毁时调用
+     */
+    onDestroy?: () => void;
+}
+/**
+ * Fluent API构建器类型
+ */
+export interface TypeSafeBuilder<T> {
+    /**
+     * 完成构建
+     */
+    build(): T;
+}
+/**
+ * 组件池类型
+ */
+export interface ComponentPool<T extends IComponent> {
+    /**
+     * 从池中获取组件实例
+     */
+    obtain(): T;
+    /**
+     * 归还组件到池中
+     */
+    free(component: T): void;
+    /**
+     * 清空池
+     */
+    clear(): void;
+    /**
+     * 池中可用对象数量
+     */
+    readonly available: number;
+}
+/**
+ * 实体查询条件类型
+ */
+export interface TypedQueryCondition<All extends readonly ComponentConstructor[] = [], Any extends readonly ComponentConstructor[] = [], None extends readonly ComponentConstructor[] = []> {
+    all: All;
+    any: Any;
+    none: None;
+    tag?: number;
+    name?: string;
+}
+/**
+ * 组件类型守卫
+ */
+export declare function isComponentType<T extends IComponent>(value: any): value is ComponentConstructor<T>;
+/**
+ * 类型安全的组件数组守卫
+ */
+export declare function isComponentArray(value: any[]): value is ComponentConstructor[];
+/**
+ * 提取组件类型名称（编译时）
+ */
+export type ComponentTypeName<T extends ComponentConstructor> = T extends {
+    prototype: {
+        constructor: {
+            name: infer N;
+        };
+    };
+} ? N : string;
+/**
+ * 多组件类型名称联合
+ */
+export type ComponentTypeNames<T extends readonly ComponentConstructor[]> = {
+    [K in keyof T]: ComponentTypeName<T[K]>;
+}[number];
+/**
+ * 深度只读类型
+ */
+export type DeepReadonly<T> = {
+    readonly [K in keyof T]: T[K] extends object ? DeepReadonly<T[K]> : T[K];
+};
+/**
+ * 深度可选类型
+ */
+export type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/**
+ * 排除方法的类型
+ */
+export type DataOnly<T> = {
+    [K in keyof T as T[K] extends Function ? never : K]: T[K];
+};
+/**
+ * 可序列化的组件数据
+ */
+export type SerializableComponent<T extends IComponent> = DeepPartial<DataOnly<T>>;
+//# sourceMappingURL=TypeHelpers.d.ts.map

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

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

package/bin/Types/TypeHelpers.js

@@ -0,0 +1,19 @@
+/**
+ * TypeScript类型工具集
+ *
+ * 提供高级类型推断和类型安全的工具类型
+ */
+import { Component } from '../ECS/Component';
+/**
+ * 组件类型守卫
+ */
+export function isComponentType(value) {
+    return typeof value === 'function' && value.prototype instanceof Component;
+}
+/**
+ * 类型安全的组件数组守卫
+ */
+export function isComponentArray(value) {
+    return value.every(isComponentType);
+}
+//# sourceMappingURL=TypeHelpers.js.map

package/bin/Types/TypeHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeHelpers.js","sourceRoot":"","sources":["../../src/Types/TypeHelpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAqO7C;;GAEG;AACH,MAAM,UAAU,eAAe,CAC3B,KAAU;IAEV,OAAO,OAAO,KAAK,KAAK,UAAU,IAAI,KAAK,CAAC,SAAS,YAAY,SAAS,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,KAAY;IAEZ,OAAO,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AACxC,CAAC"}