@esengine/ecs-framework 2.2.20 → 2.3.0

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

@@ -0,0 +1,110 @@
+import { Entity } from '../../Entity';
+import { Component } from '../../Component';
+import { IScene } from '../../IScene';
+import { ComponentType, ComponentStorageManager } from '../ComponentStorage';
+/**
+ * 实体构建器 - 提供流式API创建和配置实体
+ */
+export declare class EntityBuilder {
+    private entity;
+    private scene;
+    private storageManager;
+    constructor(scene: IScene, 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;
+}
+//# sourceMappingURL=EntityBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityBuilder.d.ts","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/EntityBuilder.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,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG7E;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAA0B;gBAEpC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,uBAAuB;IAQlE;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAKzC;;;;OAIG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAKzC;;;;OAIG;IACI,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,SAAS,EAAE,CAAC,GAAG,aAAa;IAK7D;;;;OAIG;IACI,cAAc,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,aAAa;IAOhE;;;;;OAKG;IACI,MAAM,CAAC,CAAC,SAAS,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,aAAa;IAOnF;;;;OAIG;IACI,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,aAAa;IAMxE;;;;;OAKG;IACI,SAAS,CAAC,CAAC,SAAS,SAAS,EAChC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,EAC/B,YAAY,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,GACrC,aAAa;IAQhB;;;;OAIG;IACI,OAAO,CAAC,OAAO,GAAE,OAAc,GAAG,aAAa;IAKtD;;;;OAIG;IACI,MAAM,CAAC,MAAM,GAAE,OAAc,GAAG,aAAa;IAKpD;;;;OAIG;IACI,SAAS,CAAC,YAAY,EAAE,aAAa,GAAG,aAAa;IAO5D;;;;OAIG;IACI,YAAY,CAAC,GAAG,aAAa,EAAE,aAAa,EAAE,GAAG,aAAa;IASrE;;;;OAIG;IACI,gBAAgB,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,GAAG,aAAa;IAQvF;;;;;OAKG;IACI,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,GAAG,aAAa;IASlF;;;OAGG;IACI,KAAK,IAAI,MAAM;IAItB;;;OAGG;IACI,KAAK,IAAI,MAAM;IAKtB;;;OAGG;IACI,KAAK,IAAI,aAAa;CAMhC"}

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

@@ -0,0 +1,181 @@
+import { Entity } from '../../Entity';
+import { HierarchySystem } from '../../Systems/HierarchySystem';
+/**
+ * 实体构建器 - 提供流式API创建和配置实体
+ */
+export class EntityBuilder {
+    constructor(scene, storageManager) {
+        this.scene = scene;
+        this.storageManager = storageManager;
+        const id = scene.identifierPool.checkOut();
+        this.entity = new Entity('', id);
+        this.entity.scene = this.scene;
+    }
+    /**
+     * 设置实体名称
+     * @param name 实体名称
+     * @returns 实体构建器
+     */
+    named(name) {
+        this.entity.name = name;
+        return this;
+    }
+    /**
+     * 设置实体标签
+     * @param tag 标签
+     * @returns 实体构建器
+     */
+    tagged(tag) {
+        this.entity.tag = tag;
+        return this;
+    }
+    /**
+     * 添加组件
+     * @param component 组件实例
+     * @returns 实体构建器
+     */
+    with(component) {
+        this.entity.addComponent(component);
+        return this;
+    }
+    /**
+     * 添加多个组件
+     * @param components 组件数组
+     * @returns 实体构建器
+     */
+    withComponents(...components) {
+        for (const component of components) {
+            this.entity.addComponent(component);
+        }
+        return this;
+    }
+    /**
+     * 条件性添加组件
+     * @param condition 条件
+     * @param component 组件实例
+     * @returns 实体构建器
+     */
+    withIf(condition, component) {
+        if (condition) {
+            this.entity.addComponent(component);
+        }
+        return this;
+    }
+    /**
+     * 使用工厂函数创建并添加组件
+     * @param factory 组件工厂函数
+     * @returns 实体构建器
+     */
+    withFactory(factory) {
+        const component = factory();
+        this.entity.addComponent(component);
+        return this;
+    }
+    /**
+     * 配置组件属性
+     * @param componentType 组件类型
+     * @param configurator 配置函数
+     * @returns 实体构建器
+     */
+    configure(componentType, configurator) {
+        const component = this.entity.getComponent(componentType);
+        if (component) {
+            configurator(component);
+        }
+        return this;
+    }
+    /**
+     * 设置实体为启用状态
+     * @param enabled 是否启用
+     * @returns 实体构建器
+     */
+    enabled(enabled = true) {
+        this.entity.enabled = enabled;
+        return this;
+    }
+    /**
+     * 设置实体为活跃状态
+     * @param active 是否活跃
+     * @returns 实体构建器
+     */
+    active(active = true) {
+        this.entity.active = active;
+        return this;
+    }
+    /**
+     * 添加子实体
+     * @param childBuilder 子实体构建器
+     * @returns 实体构建器
+     */
+    withChild(childBuilder) {
+        const child = childBuilder.build();
+        const hierarchySystem = this.scene.getSystem(HierarchySystem);
+        hierarchySystem?.setParent(child, this.entity);
+        return this;
+    }
+    /**
+     * 批量添加子实体
+     * @param childBuilders 子实体构建器数组
+     * @returns 实体构建器
+     */
+    withChildren(...childBuilders) {
+        const hierarchySystem = this.scene.getSystem(HierarchySystem);
+        for (const childBuilder of childBuilders) {
+            const child = childBuilder.build();
+            hierarchySystem?.setParent(child, this.entity);
+        }
+        return this;
+    }
+    /**
+     * 使用工厂函数创建子实体
+     * @param childFactory 子实体工厂函数
+     * @returns 实体构建器
+     */
+    withChildFactory(childFactory) {
+        const childBuilder = childFactory(this.entity);
+        const child = childBuilder.build();
+        const hierarchySystem = this.scene.getSystem(HierarchySystem);
+        hierarchySystem?.setParent(child, this.entity);
+        return this;
+    }
+    /**
+     * 条件性添加子实体
+     * @param condition 条件
+     * @param childBuilder 子实体构建器
+     * @returns 实体构建器
+     */
+    withChildIf(condition, childBuilder) {
+        if (condition) {
+            const child = childBuilder.build();
+            const hierarchySystem = this.scene.getSystem(HierarchySystem);
+            hierarchySystem?.setParent(child, this.entity);
+        }
+        return this;
+    }
+    /**
+     * 构建并返回实体
+     * @returns 构建的实体
+     */
+    build() {
+        return this.entity;
+    }
+    /**
+     * 构建实体并添加到场景
+     * @returns 构建的实体
+     */
+    spawn() {
+        this.scene.addEntity(this.entity);
+        return this.entity;
+    }
+    /**
+     * 克隆当前构建器
+     * @returns 新的实体构建器
+     */
+    clone() {
+        const newBuilder = new EntityBuilder(this.scene, this.storageManager);
+        // 这里需要深度克隆实体，简化实现
+        newBuilder.entity = this.entity; // 实际应该是深度克隆
+        return newBuilder;
+    }
+}
+//# sourceMappingURL=EntityBuilder.js.map

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

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

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

@@ -0,0 +1,53 @@
+import { Entity } from '../../Entity';
+import { Scene } from '../../Scene';
+import { EntitySystem } from '../../Systems/EntitySystem';
+import { EntityBuilder } from './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: EntitySystem): SceneBuilder;
+    /**
+     * 批量添加系统
+     * @param systems 系统数组
+     * @returns 场景构建器
+     */
+    withSystems(...systems: EntitySystem[]): SceneBuilder;
+    /**
+     * 构建并返回场景
+     * @returns 构建的场景
+     */
+    build(): Scene;
+}
+//# sourceMappingURL=SceneBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/SceneBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAQ;;IAMrB;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAKxC;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAK/C;;;;OAIG;IACI,iBAAiB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,GAAG,YAAY;IAQ5F;;;;OAIG;IACI,YAAY,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY;IAOxD;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY;IAKrD;;;;OAIG;IACI,WAAW,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY;IAO5D;;;OAGG;IACI,KAAK,IAAI,KAAK;CAGxB"}

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

@@ -0,0 +1,79 @@
+import { Scene } from '../../Scene';
+import { EntityBuilder } from './EntityBuilder';
+/**
+ * 场景构建器 - 提供流式API创建和配置场景
+ */
+export class SceneBuilder {
+    constructor() {
+        this.scene = new Scene();
+    }
+    /**
+     * 设置场景名称
+     * @param name 场景名称
+     * @returns 场景构建器
+     */
+    named(name) {
+        this.scene.name = name;
+        return this;
+    }
+    /**
+     * 添加实体
+     * @param entity 实体
+     * @returns 场景构建器
+     */
+    withEntity(entity) {
+        this.scene.addEntity(entity);
+        return this;
+    }
+    /**
+     * 使用实体构建器添加实体
+     * @param builderFn 实体构建器函数
+     * @returns 场景构建器
+     */
+    withEntityBuilder(builderFn) {
+        const builder = new EntityBuilder(this.scene, this.scene.componentStorageManager);
+        const configuredBuilder = builderFn(builder);
+        const entity = configuredBuilder.build();
+        this.scene.addEntity(entity);
+        return this;
+    }
+    /**
+     * 批量添加实体
+     * @param entities 实体数组
+     * @returns 场景构建器
+     */
+    withEntities(...entities) {
+        for (const entity of entities) {
+            this.scene.addEntity(entity);
+        }
+        return this;
+    }
+    /**
+     * 添加系统
+     * @param system 系统实例
+     * @returns 场景构建器
+     */
+    withSystem(system) {
+        this.scene.addSystem(system);
+        return this;
+    }
+    /**
+     * 批量添加系统
+     * @param systems 系统数组
+     * @returns 场景构建器
+     */
+    withSystems(...systems) {
+        for (const system of systems) {
+            this.scene.addSystem(system);
+        }
+        return this;
+    }
+    /**
+     * 构建并返回场景
+     * @returns 构建的场景
+     */
+    build() {
+        return this.scene;
+    }
+}
+//# sourceMappingURL=SceneBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SceneBuilder.js","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/SceneBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,YAAY;IAGrB;QACI,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAY;QACrB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,MAAc;QAC5B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,iBAAiB,CAAC,SAAoD;QACzE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAClF,MAAM,iBAAiB,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,YAAY,CAAC,GAAG,QAAkB;QACrC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,MAAoB;QAClC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,GAAG,OAAuB;QACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACI,KAAK;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ"}

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

@@ -0,0 +1,6 @@
+export { EntityBuilder } from './EntityBuilder';
+export { SceneBuilder } from './SceneBuilder';
+export { ComponentBuilder } from './ComponentBuilder';
+export { EntityBatchOperator } from './EntityBatchOperator';
+export { ECSFluentAPI, createECSAPI, initializeECS, ECS } from './ECSFluentAPI';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/index.ts"],"names":[],"mappings":"AAAA,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;AAC5D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,6 @@
+export { EntityBuilder } from './EntityBuilder';
+export { SceneBuilder } from './SceneBuilder';
+export { ComponentBuilder } from './ComponentBuilder';
+export { EntityBatchOperator } from './EntityBatchOperator';
+export { ECSFluentAPI, createECSAPI, initializeECS, ECS } from './ECSFluentAPI';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ECS/Core/FluentAPI/index.ts"],"names":[],"mappings":"AAAA,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;AAC5D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { EntityBuilder, SceneBuilder, ComponentBuilder, EntityBatchOperator, ECSFluentAPI, createECSAPI, initializeECS, ECS } from './FluentAPI/index';
+//# 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":"AACA,OAAO,EACH,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,GAAG,EACN,MAAM,mBAAmB,CAAC"}

package/bin/ECS/Core/FluentAPI.js

@@ -0,0 +1,3 @@
+// 重新导出拆分后的模块以保持向后兼容性
+export { EntityBuilder, SceneBuilder, ComponentBuilder, EntityBatchOperator, ECSFluentAPI, createECSAPI, initializeECS, ECS } from './FluentAPI/index';
+//# sourceMappingURL=FluentAPI.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FluentAPI.js","sourceRoot":"","sources":["../../../src/ECS/Core/FluentAPI.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EACH,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,GAAG,EACN,MAAM,mBAAmB,CAAC"}