@esengine/ecs-framework 2.3.0 → 2.3.2

package/bin/Plugins/DebugPlugin.js

@@ -1,248 +0,0 @@
-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

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

package/bin/Plugins/index.d.ts

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

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

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

package/bin/Plugins/index.js

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

package/bin/Plugins/index.js.map

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

package/bin/Types/IUpdatable.d.ts

@@ -1,18 +0,0 @@
-/**
- * 可更新接口
- *
- * 实现此接口的服务将在每帧被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

@@ -1 +0,0 @@
-{"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

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

package/bin/Types/IUpdatable.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,238 +0,0 @@
-/**
- * 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

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

package/bin/Types/TypeHelpers.js

@@ -1,19 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}