@esengine/ecs-framework 2.1.4 → 2.1.6

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

@@ -1,371 +0,0 @@
-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;
-    /**
-     * 设置实体为启用状态
-     * @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

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