@esengine/ecs-framework 2.0.3

package/bin/ECS/Core/FluentAPI.d.ts

@@ -0,0 +1,392 @@
+import { Entity } from '../Entity';
+import { Component } from '../Component';
+import { Scene } from '../Scene';
+import { ComponentType, ComponentStorageManager } from './ComponentStorage';
+import { QuerySystem, QueryBuilder } from './QuerySystem';
+import { TypeSafeEventSystem } from './EventSystem';
+/**
+ * 实体构建器 - 提供流式API创建和配置实体
+ */
+export declare class EntityBuilder {
+    private entity;
+    private scene;
+    private storageManager;
+    constructor(scene: Scene, storageManager: ComponentStorageManager);
+    /**
+     * 设置实体名称
+     * @param name 实体名称
+     * @returns 实体构建器
+     */
+    named(name: string): EntityBuilder;
+    /**
+     * 设置实体标签
+     * @param tag 标签
+     * @returns 实体构建器
+     */
+    tagged(tag: number): EntityBuilder;
+    /**
+     * 添加组件
+     * @param component 组件实例
+     * @returns 实体构建器
+     */
+    with<T extends Component>(component: T): EntityBuilder;
+    /**
+     * 添加多个组件
+     * @param components 组件数组
+     * @returns 实体构建器
+     */
+    withComponents(...components: Component[]): EntityBuilder;
+    /**
+     * 条件性添加组件
+     * @param condition 条件
+     * @param component 组件实例
+     * @returns 实体构建器
+     */
+    withIf<T extends Component>(condition: boolean, component: T): EntityBuilder;
+    /**
+     * 使用工厂函数创建并添加组件
+     * @param factory 组件工厂函数
+     * @returns 实体构建器
+     */
+    withFactory<T extends Component>(factory: () => T): EntityBuilder;
+    /**
+     * 配置组件属性
+     * @param componentType 组件类型
+     * @param configurator 配置函数
+     * @returns 实体构建器
+     */
+    configure<T extends Component>(componentType: ComponentType<T>, configurator: (component: T) => void): EntityBuilder;
+    /**
+     * 设置实体位置（如果有Transform组件）
+     * @param x X坐标
+     * @param y Y坐标
+     * @param z Z坐标（可选）
+     * @returns 实体构建器
+     */
+    at(x: number, y: number, z?: number): EntityBuilder;
+    /**
+     * 设置实体旋转（如果有Transform组件）
+     * @param rotation 旋转角度
+     * @returns 实体构建器
+     */
+    rotated(rotation: number): EntityBuilder;
+    /**
+     * 设置实体缩放（如果有Transform组件）
+     * @param scaleX X轴缩放
+     * @param scaleY Y轴缩放（可选，默认与X轴相同）
+     * @returns 实体构建器
+     */
+    scaled(scaleX: number, scaleY?: number): EntityBuilder;
+    /**
+     * 设置实体为启用状态
+     * @param enabled 是否启用
+     * @returns 实体构建器
+     */
+    enabled(enabled?: boolean): EntityBuilder;
+    /**
+     * 设置实体为活跃状态
+     * @param active 是否活跃
+     * @returns 实体构建器
+     */
+    active(active?: boolean): EntityBuilder;
+    /**
+     * 添加子实体
+     * @param childBuilder 子实体构建器
+     * @returns 实体构建器
+     */
+    withChild(childBuilder: EntityBuilder): EntityBuilder;
+    /**
+     * 批量添加子实体
+     * @param childBuilders 子实体构建器数组
+     * @returns 实体构建器
+     */
+    withChildren(...childBuilders: EntityBuilder[]): EntityBuilder;
+    /**
+     * 使用工厂函数创建子实体
+     * @param childFactory 子实体工厂函数
+     * @returns 实体构建器
+     */
+    withChildFactory(childFactory: (parent: Entity) => EntityBuilder): EntityBuilder;
+    /**
+     * 条件性添加子实体
+     * @param condition 条件
+     * @param childBuilder 子实体构建器
+     * @returns 实体构建器
+     */
+    withChildIf(condition: boolean, childBuilder: EntityBuilder): EntityBuilder;
+    /**
+     * 构建并返回实体
+     * @returns 构建的实体
+     */
+    build(): Entity;
+    /**
+     * 构建实体并添加到场景
+     * @returns 构建的实体
+     */
+    spawn(): Entity;
+    /**
+     * 克隆当前构建器
+     * @returns 新的实体构建器
+     */
+    clone(): EntityBuilder;
+}
+/**
+ * 场景构建器 - 提供流式API创建和配置场景
+ */
+export declare class SceneBuilder {
+    private scene;
+    constructor();
+    /**
+     * 设置场景名称
+     * @param name 场景名称
+     * @returns 场景构建器
+     */
+    named(name: string): SceneBuilder;
+    /**
+     * 添加实体
+     * @param entity 实体
+     * @returns 场景构建器
+     */
+    withEntity(entity: Entity): SceneBuilder;
+    /**
+     * 使用实体构建器添加实体
+     * @param builderFn 实体构建器函数
+     * @returns 场景构建器
+     */
+    withEntityBuilder(builderFn: (builder: EntityBuilder) => EntityBuilder): SceneBuilder;
+    /**
+     * 批量添加实体
+     * @param entities 实体数组
+     * @returns 场景构建器
+     */
+    withEntities(...entities: Entity[]): SceneBuilder;
+    /**
+     * 添加系统
+     * @param system 系统实例
+     * @returns 场景构建器
+     */
+    withSystem(system: any): SceneBuilder;
+    /**
+     * 批量添加系统
+     * @param systems 系统数组
+     * @returns 场景构建器
+     */
+    withSystems(...systems: any[]): SceneBuilder;
+    /**
+     * 构建并返回场景
+     * @returns 构建的场景
+     */
+    build(): Scene;
+}
+/**
+ * 组件构建器 - 提供流式API创建组件
+ */
+export declare class ComponentBuilder<T extends Component> {
+    private component;
+    constructor(componentClass: new (...args: any[]) => T, ...args: any[]);
+    /**
+     * 设置组件属性
+     * @param property 属性名
+     * @param value 属性值
+     * @returns 组件构建器
+     */
+    set<K extends keyof T>(property: K, value: T[K]): ComponentBuilder<T>;
+    /**
+     * 使用配置函数设置组件
+     * @param configurator 配置函数
+     * @returns 组件构建器
+     */
+    configure(configurator: (component: T) => void): ComponentBuilder<T>;
+    /**
+     * 条件性设置属性
+     * @param condition 条件
+     * @param property 属性名
+     * @param value 属性值
+     * @returns 组件构建器
+     */
+    setIf<K extends keyof T>(condition: boolean, property: K, value: T[K]): ComponentBuilder<T>;
+    /**
+     * 构建并返回组件
+     * @returns 构建的组件
+     */
+    build(): T;
+}
+/**
+ * ECS流式API主入口
+ * 提供统一的流式接口
+ */
+export declare class ECSFluentAPI {
+    private scene;
+    private querySystem;
+    private eventSystem;
+    constructor(scene: Scene, querySystem: QuerySystem, eventSystem: TypeSafeEventSystem);
+    /**
+     * 创建实体构建器
+     * @returns 实体构建器
+     */
+    createEntity(): EntityBuilder;
+    /**
+     * 创建场景构建器
+     * @returns 场景构建器
+     */
+    createScene(): SceneBuilder;
+    /**
+     * 创建组件构建器
+     * @param componentClass 组件类
+     * @param args 构造参数
+     * @returns 组件构建器
+     */
+    createComponent<T extends Component>(componentClass: new (...args: any[]) => T, ...args: any[]): ComponentBuilder<T>;
+    /**
+     * 创建查询构建器
+     * @returns 查询构建器
+     */
+    query(): QueryBuilder;
+    /**
+     * 查找实体（简化版）
+     * @param componentTypes 组件类型
+     * @returns 实体数组
+     */
+    find(...componentTypes: ComponentType[]): Entity[];
+    /**
+     * 查找第一个匹配的实体
+     * @param componentTypes 组件类型
+     * @returns 实体或null
+     */
+    findFirst(...componentTypes: ComponentType[]): Entity | null;
+    /**
+     * 按名称查找实体
+     * @param name 实体名称
+     * @returns 实体或null
+     */
+    findByName(name: string): Entity | null;
+    /**
+     * 按标签查找实体
+     * @param tag 标签
+     * @returns 实体数组
+     */
+    findByTag(tag: number): Entity[];
+    /**
+     * 触发事件
+     * @param eventType 事件类型
+     * @param event 事件数据
+     */
+    emit<T>(eventType: string, event: T): void;
+    /**
+     * 异步触发事件
+     * @param eventType 事件类型
+     * @param event 事件数据
+     */
+    emitAsync<T>(eventType: string, event: T): Promise<void>;
+    /**
+     * 监听事件
+     * @param eventType 事件类型
+     * @param handler 事件处理器
+     * @returns 监听器ID
+     */
+    on<T>(eventType: string, handler: (event: T) => void): string;
+    /**
+     * 一次性监听事件
+     * @param eventType 事件类型
+     * @param handler 事件处理器
+     * @returns 监听器ID
+     */
+    once<T>(eventType: string, handler: (event: T) => void): string;
+    /**
+     * 移除事件监听器
+     * @param eventType 事件类型
+     * @param listenerId 监听器ID
+     */
+    off(eventType: string, listenerId: string): void;
+    /**
+     * 批量操作实体
+     * @param entities 实体数组
+     * @returns 批量操作器
+     */
+    batch(entities: Entity[]): EntityBatchOperator;
+    /**
+     * 获取场景统计信息
+     * @returns 统计信息
+     */
+    getStats(): {
+        entityCount: number;
+        systemCount: number;
+        componentStats: Map<string, any>;
+        queryStats: any;
+        eventStats: Map<string, any>;
+    };
+}
+/**
+ * 实体批量操作器
+ * 提供对多个实体的批量操作
+ */
+export declare class EntityBatchOperator {
+    private entities;
+    constructor(entities: Entity[]);
+    /**
+     * 批量添加组件
+     * @param component 组件实例
+     * @returns 批量操作器
+     */
+    addComponent<T extends Component>(component: T): EntityBatchOperator;
+    /**
+     * 批量移除组件
+     * @param componentType 组件类型
+     * @returns 批量操作器
+     */
+    removeComponent<T extends Component>(componentType: ComponentType<T>): EntityBatchOperator;
+    /**
+     * 批量设置活跃状态
+     * @param active 是否活跃
+     * @returns 批量操作器
+     */
+    setActive(active: boolean): EntityBatchOperator;
+    /**
+     * 批量设置标签
+     * @param tag 标签
+     * @returns 批量操作器
+     */
+    setTag(tag: number): EntityBatchOperator;
+    /**
+     * 批量执行操作
+     * @param operation 操作函数
+     * @returns 批量操作器
+     */
+    forEach(operation: (entity: Entity, index: number) => void): EntityBatchOperator;
+    /**
+     * 过滤实体
+     * @param predicate 过滤条件
+     * @returns 新的批量操作器
+     */
+    filter(predicate: (entity: Entity) => boolean): EntityBatchOperator;
+    /**
+     * 获取实体数组
+     * @returns 实体数组
+     */
+    toArray(): Entity[];
+    /**
+     * 获取实体数量
+     * @returns 实体数量
+     */
+    count(): number;
+}
+/**
+ * 创建ECS流式API实例
+ * @param scene 场景
+ * @param querySystem 查询系统
+ * @param eventSystem 事件系统
+ * @returns ECS流式API实例
+ */
+export declare function createECSAPI(scene: Scene, querySystem: QuerySystem, eventSystem: TypeSafeEventSystem): ECSFluentAPI;
+/**
+ * 全局ECS流式API实例（需要在使用前初始化）
+ */
+export declare let ECS: ECSFluentAPI;
+/**
+ * 初始化全局ECS API
+ * @param scene 场景
+ * @param querySystem 查询系统
+ * @param eventSystem 事件系统
+ */
+export declare function initializeECS(scene: Scene, querySystem: QuerySystem, eventSystem: TypeSafeEventSystem): void;
+//# sourceMappingURL=FluentAPI.d.ts.map

package/bin/ECS/Core/FluentAPI.d.ts.map

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