@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/ECS/Core/Events/index.d.ts

@@ -0,0 +1,3 @@
+export { EventBus, GlobalEventBus } from '../EventBus';
+export { TypeSafeEventSystem, EventListenerConfig, EventStats } from '../EventSystem';
+//# sourceMappingURL=index.d.ts.map

package/bin/ECS/Core/Events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ECS/Core/Events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/bin/ECS/Core/Events/index.js

@@ -0,0 +1,3 @@
+export { EventBus, GlobalEventBus } from '../EventBus';
+export { TypeSafeEventSystem } from '../EventSystem';
+//# sourceMappingURL=index.js.map

package/bin/ECS/Core/Events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ECS/Core/Events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAmC,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,35 @@
+import { Component } from '../../Component';
+/**
+ * 组件构建器 - 提供流式API创建组件
+ */
+export declare class ComponentBuilder<T extends Component> {
+    private component;
+    constructor(componentClass: new (...args: unknown[]) => T, ...args: unknown[]);
+    /**
+     * 设置组件属性
+     * @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;
+}
+//# sourceMappingURL=ComponentBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentBuilder.d.ts","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/ComponentBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,qBAAa,gBAAgB,CAAC,CAAC,SAAS,SAAS;IAC7C,OAAO,CAAC,SAAS,CAAI;gBAET,cAAc,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAI7E;;;;;OAKG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAK5E;;;;OAIG;IACI,SAAS,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAK3E;;;;;;OAMG;IACI,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAOlG;;;OAGG;IACI,KAAK,IAAI,CAAC;CAGpB"}

package/bin/ECS/Core/FluentAPI/ComponentBuilder.js

@@ -0,0 +1,48 @@
+/**
+ * 组件构建器 - 提供流式API创建组件
+ */
+export class ComponentBuilder {
+    constructor(componentClass, ...args) {
+        this.component = new componentClass(...args);
+    }
+    /**
+     * 设置组件属性
+     * @param property 属性名
+     * @param value 属性值
+     * @returns 组件构建器
+     */
+    set(property, value) {
+        this.component[property] = value;
+        return this;
+    }
+    /**
+     * 使用配置函数设置组件
+     * @param configurator 配置函数
+     * @returns 组件构建器
+     */
+    configure(configurator) {
+        configurator(this.component);
+        return this;
+    }
+    /**
+     * 条件性设置属性
+     * @param condition 条件
+     * @param property 属性名
+     * @param value 属性值
+     * @returns 组件构建器
+     */
+    setIf(condition, property, value) {
+        if (condition) {
+            this.component[property] = value;
+        }
+        return this;
+    }
+    /**
+     * 构建并返回组件
+     * @returns 构建的组件
+     */
+    build() {
+        return this.component;
+    }
+}
+//# sourceMappingURL=ComponentBuilder.js.map

package/bin/ECS/Core/FluentAPI/ComponentBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentBuilder.js","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/ComponentBuilder.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAGzB,YAAY,cAA6C,EAAE,GAAG,IAAe;QACzE,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAoB,QAAW,EAAE,KAAW;QAClD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QACjC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,YAAoC;QACjD,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAoB,SAAkB,EAAE,QAAW,EAAE,KAAW;QACxE,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QACrC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACI,KAAK;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;CACJ"}

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

@@ -0,0 +1,135 @@
+import { Entity } from '../../Entity';
+import { Component } from '../../Component';
+import { IScene } from '../../IScene';
+import { ComponentType } from '../ComponentStorage';
+import { QuerySystem, QueryBuilder } from '../QuerySystem';
+import { TypeSafeEventSystem } from '../EventSystem';
+import { EntityBuilder } from './EntityBuilder';
+import { SceneBuilder } from './SceneBuilder';
+import { ComponentBuilder } from './ComponentBuilder';
+import { EntityBatchOperator } from './EntityBatchOperator';
+/**
+ * ECS流式API主入口
+ * 提供统一的流式接口
+ */
+export declare class ECSFluentAPI {
+    private scene;
+    private querySystem;
+    private eventSystem;
+    constructor(scene: IScene, querySystem: QuerySystem, eventSystem: TypeSafeEventSystem);
+    /**
+     * 创建实体构建器
+     * @returns 实体构建器
+     */
+    createEntity(): EntityBuilder;
+    /**
+     * 创建场景构建器
+     * @returns 场景构建器
+     */
+    createScene(): SceneBuilder;
+    /**
+     * 创建组件构建器
+     * @param componentClass 组件类
+     * @param args 构造参数
+     * @returns 组件构建器
+     */
+    createComponent<T extends Component>(componentClass: new (...args: unknown[]) => T, ...args: unknown[]): ComponentBuilder<T>;
+    /**
+     * 创建查询构建器
+     * @returns 查询构建器
+     */
+    query(): QueryBuilder;
+    /**
+     * 查找实体
+     * @param componentTypes 组件类型
+     * @returns 实体数组
+     */
+    find(...componentTypes: ComponentType[]): readonly 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, unknown>;
+        queryStats: unknown;
+        eventStats: Map<string, unknown>;
+    };
+}
+/**
+ * 创建ECS流式API实例
+ * @param scene 场景
+ * @param querySystem 查询系统
+ * @param eventSystem 事件系统
+ * @returns ECS流式API实例
+ */
+export declare function createECSAPI(scene: IScene, 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: IScene, querySystem: QuerySystem, eventSystem: TypeSafeEventSystem): void;
+//# sourceMappingURL=ECSFluentAPI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ECSFluentAPI.d.ts","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/ECSFluentAPI.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAsB;gBAE7B,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB;IAMrF;;;OAGG;IACI,YAAY,IAAI,aAAa;IAIpC;;;OAGG;IACI,WAAW,IAAI,YAAY;IAIlC;;;;;OAKG;IACI,eAAe,CAAC,CAAC,SAAS,SAAS,EACtC,cAAc,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC7C,GAAG,IAAI,EAAE,OAAO,EAAE,GACnB,gBAAgB,CAAC,CAAC,CAAC;IAItB;;;OAGG;IACI,KAAK,IAAI,YAAY;IAI5B;;;;OAIG;IACI,IAAI,CAAC,GAAG,cAAc,EAAE,aAAa,EAAE,GAAG,SAAS,MAAM,EAAE;IAIlE;;;;OAIG;IACI,SAAS,CAAC,GAAG,cAAc,EAAE,aAAa,EAAE,GAAG,MAAM,GAAG,IAAI;IAKnE;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI9C;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC;;;;OAIG;IACI,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIjD;;;;OAIG;IACU,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;;;;OAKG;IACI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM;IAIpE;;;;;OAKG;IACI,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM;IAItE;;;;OAIG;IACI,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAIvD;;;;OAIG;IACI,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,mBAAmB;IAIrD;;;OAGG;IACI,QAAQ,IAAI;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC;CASR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,mBAAmB,GACjC,YAAY,CAEd;AAED;;GAEG;AACH,eAAO,IAAI,GAAG,EAAE,YAAY,CAAC;AAE7B;;;;;GAKG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,mBAAmB,GACjC,IAAI,CAEN"}

package/bin/ECS/Core/FluentAPI/ECSFluentAPI.js

@@ -0,0 +1,166 @@
+import { QueryBuilder } from '../QuerySystem';
+import { EntityBuilder } from './EntityBuilder';
+import { SceneBuilder } from './SceneBuilder';
+import { ComponentBuilder } from './ComponentBuilder';
+import { EntityBatchOperator } from './EntityBatchOperator';
+/**
+ * ECS流式API主入口
+ * 提供统一的流式接口
+ */
+export class ECSFluentAPI {
+    constructor(scene, querySystem, eventSystem) {
+        this.scene = scene;
+        this.querySystem = querySystem;
+        this.eventSystem = eventSystem;
+    }
+    /**
+     * 创建实体构建器
+     * @returns 实体构建器
+     */
+    createEntity() {
+        return new EntityBuilder(this.scene, this.scene.componentStorageManager);
+    }
+    /**
+     * 创建场景构建器
+     * @returns 场景构建器
+     */
+    createScene() {
+        return new SceneBuilder();
+    }
+    /**
+     * 创建组件构建器
+     * @param componentClass 组件类
+     * @param args 构造参数
+     * @returns 组件构建器
+     */
+    createComponent(componentClass, ...args) {
+        return new ComponentBuilder(componentClass, ...args);
+    }
+    /**
+     * 创建查询构建器
+     * @returns 查询构建器
+     */
+    query() {
+        return new QueryBuilder(this.querySystem);
+    }
+    /**
+     * 查找实体
+     * @param componentTypes 组件类型
+     * @returns 实体数组
+     */
+    find(...componentTypes) {
+        return this.querySystem.queryAll(...componentTypes).entities;
+    }
+    /**
+     * 查找第一个匹配的实体
+     * @param componentTypes 组件类型
+     * @returns 实体或null
+     */
+    findFirst(...componentTypes) {
+        const result = this.querySystem.queryAll(...componentTypes);
+        return result.entities.length > 0 ? result.entities[0] : null;
+    }
+    /**
+     * 按名称查找实体
+     * @param name 实体名称
+     * @returns 实体或null
+     */
+    findByName(name) {
+        return this.scene.findEntity(name);
+    }
+    /**
+     * 按标签查找实体
+     * @param tag 标签
+     * @returns 实体数组
+     */
+    findByTag(tag) {
+        return this.scene.findEntitiesByTag(tag);
+    }
+    /**
+     * 触发事件
+     * @param eventType 事件类型
+     * @param event 事件数据
+     */
+    emit(eventType, event) {
+        this.eventSystem.emitSync(eventType, event);
+    }
+    /**
+     * 异步触发事件
+     * @param eventType 事件类型
+     * @param event 事件数据
+     */
+    async emitAsync(eventType, event) {
+        await this.eventSystem.emit(eventType, event);
+    }
+    /**
+     * 监听事件
+     * @param eventType 事件类型
+     * @param handler 事件处理器
+     * @returns 监听器ID
+     */
+    on(eventType, handler) {
+        return this.eventSystem.on(eventType, handler);
+    }
+    /**
+     * 一次性监听事件
+     * @param eventType 事件类型
+     * @param handler 事件处理器
+     * @returns 监听器ID
+     */
+    once(eventType, handler) {
+        return this.eventSystem.once(eventType, handler);
+    }
+    /**
+     * 移除事件监听器
+     * @param eventType 事件类型
+     * @param listenerId 监听器ID
+     */
+    off(eventType, listenerId) {
+        this.eventSystem.off(eventType, listenerId);
+    }
+    /**
+     * 批量操作实体
+     * @param entities 实体数组
+     * @returns 批量操作器
+     */
+    batch(entities) {
+        return new EntityBatchOperator(entities);
+    }
+    /**
+     * 获取场景统计信息
+     * @returns 统计信息
+     */
+    getStats() {
+        return {
+            entityCount: this.scene.entities.count,
+            systemCount: this.scene.systems.length,
+            componentStats: this.scene.componentStorageManager.getAllStats(),
+            queryStats: this.querySystem.getStats(),
+            eventStats: this.eventSystem.getStats()
+        };
+    }
+}
+/**
+ * 创建ECS流式API实例
+ * @param scene 场景
+ * @param querySystem 查询系统
+ * @param eventSystem 事件系统
+ * @returns ECS流式API实例
+ */
+export function createECSAPI(scene, querySystem, eventSystem) {
+    return new ECSFluentAPI(scene, querySystem, eventSystem);
+}
+/**
+ * 全局ECS流式API实例（需要在使用前初始化）
+ */
+export let ECS;
+/**
+ * 初始化全局ECS API
+ * @param scene 场景
+ * @param querySystem 查询系统
+ * @param eventSystem 事件系统
+ */
+export function initializeECS(scene, querySystem, eventSystem) {
+    ECS = createECSAPI(scene, querySystem, eventSystem);
+}
+//# sourceMappingURL=ECSFluentAPI.js.map

package/bin/ECS/Core/FluentAPI/ECSFluentAPI.js.map

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

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

@@ -0,0 +1,58 @@
+import { Entity } from '../../Entity';
+import { Component } from '../../Component';
+import { ComponentType } from '../ComponentStorage';
+/**
+ * 实体批量操作器
+ * 提供对多个实体的批量操作
+ */
+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;
+}
+//# sourceMappingURL=EntityBatchOperator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityBatchOperator.d.ts","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/EntityBatchOperator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,EAAE,MAAM,EAAE;IAI9B;;;;OAIG;IACI,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,SAAS,EAAE,CAAC,GAAG,mBAAmB;IAO3E;;;;OAIG;IACI,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,mBAAmB;IAOjG;;;;OAIG;IACI,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB;IAOtD;;;;OAIG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAO/C;;;;OAIG;IACI,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,mBAAmB;IAKvF;;;;OAIG;IACI,MAAM,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,mBAAmB;IAI1E;;;OAGG;IACI,OAAO,IAAI,MAAM,EAAE;IAI1B;;;OAGG;IACI,KAAK,IAAI,MAAM;CAGzB"}

package/bin/ECS/Core/FluentAPI/EntityBatchOperator.js

@@ -0,0 +1,85 @@
+/**
+ * 实体批量操作器
+ * 提供对多个实体的批量操作
+ */
+export class EntityBatchOperator {
+    constructor(entities) {
+        this.entities = entities;
+    }
+    /**
+     * 批量添加组件
+     * @param component 组件实例
+     * @returns 批量操作器
+     */
+    addComponent(component) {
+        for (const entity of this.entities) {
+            entity.addComponent(component);
+        }
+        return this;
+    }
+    /**
+     * 批量移除组件
+     * @param componentType 组件类型
+     * @returns 批量操作器
+     */
+    removeComponent(componentType) {
+        for (const entity of this.entities) {
+            entity.removeComponentByType(componentType);
+        }
+        return this;
+    }
+    /**
+     * 批量设置活跃状态
+     * @param active 是否活跃
+     * @returns 批量操作器
+     */
+    setActive(active) {
+        for (const entity of this.entities) {
+            entity.active = active;
+        }
+        return this;
+    }
+    /**
+     * 批量设置标签
+     * @param tag 标签
+     * @returns 批量操作器
+     */
+    setTag(tag) {
+        for (const entity of this.entities) {
+            entity.tag = tag;
+        }
+        return this;
+    }
+    /**
+     * 批量执行操作
+     * @param operation 操作函数
+     * @returns 批量操作器
+     */
+    forEach(operation) {
+        this.entities.forEach(operation);
+        return this;
+    }
+    /**
+     * 过滤实体
+     * @param predicate 过滤条件
+     * @returns 新的批量操作器
+     */
+    filter(predicate) {
+        return new EntityBatchOperator(this.entities.filter(predicate));
+    }
+    /**
+     * 获取实体数组
+     * @returns 实体数组
+     */
+    toArray() {
+        return this.entities.slice();
+    }
+    /**
+     * 获取实体数量
+     * @returns 实体数量
+     */
+    count() {
+        return this.entities.length;
+    }
+}
+//# sourceMappingURL=EntityBatchOperator.js.map

package/bin/ECS/Core/FluentAPI/EntityBatchOperator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityBatchOperator.js","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/EntityBatchOperator.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAG5B,YAAY,QAAkB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,YAAY,CAAsB,SAAY;QACjD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAsB,aAA+B;QACvE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,MAAe;QAC5B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,GAAW;QACrB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,SAAkD;QAC7D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAsC;QAChD,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACI,OAAO;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,KAAK;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAChC,CAAC;CACJ"}