@esengine/ecs-framework 2.2.2 → 2.2.4

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.2.2
+ * @esengine/ecs-framework v2.2.4
  * TypeScript definitions
  */
 /**
@@ -2517,7 +2517,7 @@ declare class PerformanceMonitor implements IService {
 /**
  * 查询条件类型
  */
-interface QueryCondition {
+interface QueryCondition$1 {
     all: ComponentType[];
     any: ComponentType[];
     none: ComponentType[];
@@ -2636,7 +2636,7 @@ declare class Matcher {
     /**
      * 获取查询条件（只读）
      */
-    getCondition(): Readonly<QueryCondition>;
+    getCondition(): Readonly<QueryCondition$1>;
     /**
      * 检查是否为空条件
      */
@@ -2863,55 +2863,6 @@ declare class Bits {
     getLowestBitIndex(): number;
 }
 
-/**
- * 组件类型管理器
- * 负责管理组件类型的注册和ID分配
- * 支持无限数量的组件类型（通过自动扩展 BitMask）
- */
-declare class ComponentTypeManager {
-    private static _instance;
-    private _componentTypes;
-    private _typeNames;
-    private _nextTypeId;
-    /**
-     * 获取单例实例
-     */
-    static get instance(): ComponentTypeManager;
-    private constructor();
-    /**
-     * 获取组件类型的ID
-     * @param componentType 组件类型构造函数
-     * @returns 组件类型ID
-     */
-    getTypeId(componentType: ComponentType$1): number;
-    /**
-     * 获取组件类型名称
-     * @param typeId 组件类型ID
-     * @returns 组件类型名称
-     */
-    getTypeName(typeId: number): string;
-    /**
-     * 创建包含指定组件类型的Bits对象
-     * @param componentTypes 组件类型构造函数数组
-     * @returns Bits对象
-     */
-    createBits(...componentTypes: ComponentType$1[]): Bits;
-    /**
-     * 获取实体的组件位掩码
-     * @param components 组件数组
-     * @returns Bits对象
-     */
-    getEntityBits(components: ComponentType$1[]): Bits;
-    /**
-     * 重置管理器（主要用于测试）
-     */
-    reset(): void;
-    /**
-     * 获取已注册的组件类型数量
-     */
-    get registeredTypeCount(): number;
-}
-
 /**
  * 稀疏集合实现
  *
@@ -3238,6 +3189,25 @@ interface Archetype {
     entities: Set<Entity>;
 }
 
+/**
+ * 查询条件类型
+ */
+declare enum QueryConditionType {
+    /** 必须包含所有指定组件 */
+    ALL = "all",
+    /** 必须包含任意一个指定组件 */
+    ANY = "any",
+    /** 不能包含任何指定组件 */
+    NONE = "none"
+}
+/**
+ * 查询条件接口
+ */
+interface QueryCondition {
+    type: QueryConditionType;
+    componentTypes: ComponentType[];
+    mask: BitMask64Data;
+}
 /**
  * 实体查询结果接口
  */
@@ -3249,6 +3219,202 @@ interface QueryResult {
     /** 是否来自缓存 */
     fromCache: boolean;
 }
+
+/**
+ * 响应式查询变化类型
+ */
+declare enum ReactiveQueryChangeType {
+    /** 实体添加到查询结果 */
+    ADDED = "added",
+    /** 实体从查询结果移除 */
+    REMOVED = "removed",
+    /** 查询结果批量更新 */
+    BATCH_UPDATE = "batch_update"
+}
+/**
+ * 响应式查询变化事件
+ */
+interface ReactiveQueryChange {
+    /** 变化类型 */
+    type: ReactiveQueryChangeType;
+    /** 变化的实体 */
+    entity?: Entity;
+    /** 批量变化的实体 */
+    entities?: readonly Entity[];
+    /** 新增的实体列表(仅batch_update时有效) */
+    added?: readonly Entity[];
+    /** 移除的实体列表(仅batch_update时有效) */
+    removed?: readonly Entity[];
+}
+/**
+ * 响应式查询监听器
+ */
+type ReactiveQueryListener = (change: ReactiveQueryChange) => void;
+/**
+ * 响应式查询配置
+ */
+interface ReactiveQueryConfig {
+    /** 是否启用批量模式(减少通知频率) */
+    enableBatchMode?: boolean;
+    /** 批量模式的延迟时间(毫秒) */
+    batchDelay?: number;
+    /** 调试模式 */
+    debug?: boolean;
+}
+/**
+ * 响应式查询类
+ *
+ * 提供基于事件驱动的实体查询机制,只在实体/组件真正变化时触发通知。
+ *
+ * 核心特性:
+ * - Event-driven: 基于事件的增量更新
+ * - 精确通知: 只通知真正匹配的变化
+ * - 性能优化: 避免每帧重复查询
+ *
+ * @example
+ * ```typescript
+ * // 创建响应式查询
+ * const query = new ReactiveQuery(querySystem, {
+ *     type: QueryConditionType.ALL,
+ *     componentTypes: [Position, Velocity],
+ *     mask: createMask([Position, Velocity])
+ * });
+ *
+ * // 订阅变化
+ * query.subscribe((change) => {
+ *     if (change.type === ReactiveQueryChangeType.ADDED) {
+ *         console.log('新实体:', change.entity);
+ *     }
+ * });
+ *
+ * // 获取当前结果
+ * const entities = query.getEntities();
+ * ```
+ */
+declare class ReactiveQuery {
+    /** 当前查询结果 */
+    private _entities;
+    /** 实体ID集合,用于快速查找 */
+    private _entityIdSet;
+    /** 查询条件 */
+    private readonly _condition;
+    /** 监听器列表 */
+    private _listeners;
+    /** 配置 */
+    private readonly _config;
+    /** 批量变化缓存 */
+    private _batchChanges;
+    /** 查询ID(用于调试) */
+    private readonly _id;
+    /** 是否已激活 */
+    private _active;
+    constructor(condition: QueryCondition, config?: ReactiveQueryConfig);
+    /**
+     * 生成查询ID
+     */
+    private generateQueryId;
+    /**
+     * 订阅查询变化
+     *
+     * @param listener 监听器函数
+     * @returns 取消订阅的函数
+     */
+    subscribe(listener: ReactiveQueryListener): () => void;
+    /**
+     * 取消所有订阅
+     */
+    unsubscribeAll(): void;
+    /**
+     * 获取当前查询结果
+     */
+    getEntities(): readonly Entity[];
+    /**
+     * 获取查询结果数量
+     */
+    get count(): number;
+    /**
+     * 检查实体是否匹配查询条件
+     *
+     * @param entity 要检查的实体
+     * @returns 是否匹配
+     */
+    matches(entity: Entity): boolean;
+    /**
+     * 通知实体添加
+     *
+     * 当Scene中添加实体时调用
+     *
+     * @param entity 添加的实体
+     */
+    notifyEntityAdded(entity: Entity): void;
+    /**
+     * 通知实体移除
+     *
+     * 当Scene中移除实体时调用
+     *
+     * @param entity 移除的实体
+     */
+    notifyEntityRemoved(entity: Entity): void;
+    /**
+     * 通知实体组件变化
+     *
+     * 当实体的组件发生变化时调用
+     *
+     * @param entity 变化的实体
+     */
+    notifyEntityChanged(entity: Entity): void;
+    /**
+     * 批量初始化查询结果
+     *
+     * @param entities 初始实体列表
+     */
+    initializeWith(entities: readonly Entity[]): void;
+    /**
+     * 添加到批量变化缓存
+     */
+    private addToBatch;
+    /**
+     * 刷新批量变化
+     */
+    private flushBatchChanges;
+    /**
+     * 通知所有监听器
+     */
+    private notifyListeners;
+    /**
+     * 暂停响应式查询
+     *
+     * 暂停后不再响应实体变化,但可以继续获取当前结果
+     */
+    pause(): void;
+    /**
+     * 恢复响应式查询
+     */
+    resume(): void;
+    /**
+     * 销毁响应式查询
+     *
+     * 释放所有资源,清空监听器和结果集
+     */
+    dispose(): void;
+    /**
+     * 获取查询条件
+     */
+    get condition(): QueryCondition;
+    /**
+     * 获取查询ID
+     */
+    get id(): string;
+    /**
+     * 检查是否激活
+     */
+    get active(): boolean;
+    /**
+     * 获取监听器数量
+     */
+    get listenerCount(): number;
+}
+
 /**
  * 高性能实体查询系统
  *
@@ -3353,7 +3519,7 @@ declare class QuerySystem {
      * 查询包含所有指定组件的实体
      *
      * 返回同时包含所有指定组件类型的实体列表。
-     * 系统会自动选择最高效的查询策略，包括索引查找和缓存机制。
+     * 内部使用响应式查询作为智能缓存,自动跟踪实体变化,性能更优。
      *
      * @param componentTypes 要查询的组件类型列表
      * @returns 查询结果，包含匹配的实体和性能信息
@@ -3380,7 +3546,7 @@ declare class QuerySystem {
      * 查询包含任意指定组件的实体
      *
      * 返回包含任意一个指定组件类型的实体列表。
-     * 使用集合合并算法确保高效的查询性能。
+     * 内部使用响应式查询作为智能缓存,自动跟踪实体变化,性能更优。
      *
      * @param componentTypes 要查询的组件类型列表
      * @returns 查询结果，包含匹配的实体和性能信息
@@ -3397,7 +3563,7 @@ declare class QuerySystem {
      * 查询不包含任何指定组件的实体
      *
      * 返回不包含任何指定组件类型的实体列表。
-     * 适用于排除特定类型实体的查询场景。
+     * 内部使用响应式查询作为智能缓存,自动跟踪实体变化,性能更优。
      *
      * @param componentTypes 要排除的组件类型列表
      * @returns 查询结果，包含匹配的实体和性能信息
@@ -3474,6 +3640,13 @@ declare class QuerySystem {
      * 清除所有查询缓存
      */
     private clearQueryCache;
+    /**
+     * 清除所有响应式查询
+     *
+     * 销毁所有响应式查询实例并清理索引
+     * 通常在setEntities时调用以确保缓存一致性
+     */
+    private clearReactiveQueries;
     /**
      * 高效的缓存键生成
      */
@@ -3482,13 +3655,56 @@ declare class QuerySystem {
      * 清理查询缓存
      *
      * 用于外部调用清理缓存，通常在批量操作后使用。
+     * 注意:此方法也会清理响应式查询缓存
      */
     clearCache(): void;
+    /**
+     * 创建响应式查询
+     *
+     * 响应式查询会自动跟踪实体/组件的变化,并通过事件通知订阅者。
+     * 适合需要实时响应实体变化的场景(如UI更新、AI系统等)。
+     *
+     * @param componentTypes 查询的组件类型列表
+     * @param config 可选的查询配置
+     * @returns 响应式查询实例
+     *
+     * @example
+     * ```typescript
+     * const query = querySystem.createReactiveQuery([Position, Velocity], {
+     *     enableBatchMode: true,
+     *     batchDelay: 16
+     * });
+     *
+     * query.subscribe((change) => {
+     *     if (change.type === ReactiveQueryChangeType.ADDED) {
+     *         console.log('新实体:', change.entity);
+     *     }
+     * });
+     * ```
+     */
+    createReactiveQuery(componentTypes: ComponentType[], config?: ReactiveQueryConfig): ReactiveQuery;
+    /**
+     * 销毁响应式查询
+     *
+     * 清理查询占用的资源,包括监听器和实体引用。
+     * 销毁后的查询不应再被使用。
+     *
+     * @param query 要销毁的响应式查询
+     *
+     * @example
+     * ```typescript
+     * const query = querySystem.createReactiveQuery([Position, Velocity]);
+     * // ... 使用查询
+     * querySystem.destroyReactiveQuery(query);
+     * ```
+     */
+    destroyReactiveQuery(query: ReactiveQuery): void;
     /**
      * 创建组件掩码
      *
      * 根据组件类型列表生成对应的位掩码。
      * 使用缓存避免重复计算。
+     * 注意:必须使用ComponentRegistry来确保与Entity.componentMask使用相同的bitIndex
      *
      * @param componentTypes 组件类型列表
      * @returns 生成的位掩码
@@ -3540,6 +3756,67 @@ declare class QuerySystem {
      * @param entity 要查询的实体
      */
     getEntityArchetype(entity: Entity): Archetype | undefined;
+    /**
+     * 响应式查询集合(内部使用,作为智能缓存)
+     * 传统查询API(queryAll/queryAny/queryNone)内部自动使用响应式查询优化性能
+     */
+    private _reactiveQueries;
+    /**
+     * 按组件类型索引的响应式查询
+     * 用于快速定位哪些查询关心某个组件类型
+     */
+    private _reactiveQueriesByComponent;
+    /**
+     * 获取或创建内部响应式查询(作为智能缓存)
+     *
+     * @param queryType 查询类型
+     * @param componentTypes 组件类型列表
+     * @returns 响应式查询实例
+     */
+    private getOrCreateReactiveQuery;
+    /**
+     * 执行传统查询(内部使用,用于响应式查询初始化)
+     *
+     * @param queryType 查询类型
+     * @param componentTypes 组件类型列表
+     * @returns 匹配的实体列表
+     */
+    private executeTraditionalQuery;
+    /**
+     * 通知所有响应式查询实体已添加
+     *
+     * 使用组件类型索引,只通知关心该实体组件的查询
+     *
+     * @param entity 添加的实体
+     */
+    private notifyReactiveQueriesEntityAdded;
+    /**
+     * 通知响应式查询实体已移除
+     *
+     * 使用组件类型索引,只通知关心该实体组件的查询
+     *
+     * @param entity 移除的实体
+     * @param componentTypes 实体移除前的组件类型列表
+     */
+    private notifyReactiveQueriesEntityRemoved;
+    /**
+     * 通知响应式查询实体已移除(后备方案)
+     *
+     * 当实体已经清空组件时使用,通知所有查询
+     *
+     * @param entity 移除的实体
+     */
+    private notifyReactiveQueriesEntityRemovedFallback;
+    /**
+     * 通知响应式查询实体已变化
+     *
+     * 使用混合策略:
+     * 1. 首先通知关心实体当前组件的查询
+     * 2. 然后通知所有其他查询(包括那些可能因为组件移除而不再匹配的查询)
+     *
+     * @param entity 变化的实体
+     */
+    private notifyReactiveQueriesEntityChanged;
 }
 /**
  * 查询构建器
@@ -4100,7 +4377,7 @@ declare class TypedQueryBuilder<TAll extends readonly ComponentConstructor[] = [
      *
      * @returns 查询条件对象
      */
-    getCondition(): QueryCondition;
+    getCondition(): QueryCondition$1;
     /**
      * 获取required组件类型（用于类型推断）
      */
@@ -5082,7 +5359,7 @@ declare class Scene implements IScene {
      * @Injectable()
      * class PhysicsSystem extends EntitySystem {
      *     constructor(@Inject(CollisionSystem) private collision: CollisionSystem) {
-     *         super(Matcher.of(Transform));
+     *         super(Matcher.empty().all(Transform));
      *     }
      * }
      * scene.addEntityProcessor(PhysicsSystem);
@@ -5107,7 +5384,7 @@ declare class Scene implements IScene {
      * @Injectable()
      * @ECSSystem('Collision', { updateOrder: 5 })
      * class CollisionSystem extends EntitySystem implements IService {
-     *     constructor() { super(Matcher.of(Collider)); }
+     *     constructor() { super(Matcher.empty().all(Collider)); }
      *     dispose() {}
      * }
      *
@@ -5115,7 +5392,7 @@ declare class Scene implements IScene {
      * @ECSSystem('Physics', { updateOrder: 10 })
      * class PhysicsSystem extends EntitySystem implements IService {
      *     constructor(@Inject(CollisionSystem) private collision: CollisionSystem) {
-     *         super(Matcher.of(Transform, RigidBody));
+     *         super(Matcher.empty().all(Transform, RigidBody));
      *     }
      *     dispose() {}
      * }
@@ -5358,7 +5635,7 @@ declare class Scene implements IScene {
  * // 传统方式
  * class MovementSystem extends EntitySystem {
  *     constructor() {
- *         super(Matcher.of(Transform, Velocity));
+ *         super(Matcher.empty().all(Transform, Velocity));
  *     }
  *
  *     protected process(entities: readonly Entity[]): void {
@@ -5373,7 +5650,7 @@ declare class Scene implements IScene {
  * // 类型安全方式
  * class MovementSystem extends EntitySystem<[typeof Transform, typeof Velocity]> {
  *     constructor() {
- *         super(Matcher.of(Transform, Velocity));
+ *         super(Matcher.empty().all(Transform, Velocity));
  *     }
  *
  *     protected process(entities: readonly Entity[]): void {
@@ -6974,7 +7251,7 @@ interface SystemMetadata {
  * @ECSSystem('Physics', { updateOrder: 10 })
  * class PhysicsSystem extends EntitySystem {
  *     constructor(@Inject(CollisionSystem) private collision: CollisionSystem) {
- *         super(Matcher.of(Transform, RigidBody));
+ *         super(Matcher.empty().all(Transform, RigidBody));
  *     }
  * }
  * ```
@@ -7418,51 +7695,229 @@ declare class ECSFluentAPI {
 declare function createECSAPI(scene: IScene, querySystem: QuerySystem, eventSystem: TypeSafeEventSystem): ECSFluentAPI;
 
 /**
- * 全局系统接口
- * 全局系统是在World级别运行的系统，不依赖特定Scene
+ * 单场景管理器
+ *
+ * 适用场景：
+ * - 单人游戏
+ * - 简单场景切换
+ * - 不需要多World隔离的项目
+ *
+ * 特点：
+ * - 轻量级，零额外开销
+ * - 简单直观的API
+ * - 支持延迟场景切换
+ * - 自动管理ECS API
+ *
+ * @example
+ * ```typescript
+ * // 初始化Core
+ * Core.create({ debug: true });
+ *
+ * // 创建场景管理器
+ * const sceneManager = new SceneManager();
+ *
+ * // 设置场景
+ * class GameScene extends Scene {
+ *     initialize() {
+ *         const player = this.createEntity('Player');
+ *         player.addComponent(new Transform(100, 100));
+ *     }
+ * }
+ *
+ * sceneManager.setScene(new GameScene());
+ *
+ * // 游戏循环
+ * function gameLoop(deltaTime: number) {
+ *     Core.update(deltaTime);      // 更新全局服务
+ *     sceneManager.update();       // 更新场景
+ * }
+ *
+ * // 延迟切换场景（下一帧生效）
+ * sceneManager.loadScene(new MenuScene());
+ * ```
  */
-interface IGlobalSystem {
-    /**
-     * 系统名称
-     */
-    readonly name: string;
+declare class SceneManager implements IService {
     /**
-     * 初始化系统
+     * 内部默认World
      */
-    initialize?(): void;
+    private _defaultWorld;
     /**
-     * 更新系统
+     * 待切换的下一个场景（延迟切换用）
      */
-    update(deltaTime?: number): void;
+    private _nextScene;
     /**
-     * 重置系统
+     * ECS流式API
      */
-    reset?(): void;
+    private _ecsAPI;
     /**
-     * 销毁系统
+     * 日志器
      */
-    destroy?(): void;
-}
-/**
- * World配置接口
- */
-interface IWorldConfig {
+    private _logger;
     /**
-     * World名称
+     * 场景切换回调函数
      */
-    name?: string;
+    private _onSceneChangedCallback?;
     /**
-     * 是否启用调试模式
+     * 默认场景ID
      */
-    debug?: boolean;
+    private static readonly DEFAULT_SCENE_ID;
+    constructor();
     /**
-     * 最大Scene数量限制
+     * 设置场景切换回调
+     *
+     * @param callback 场景切换时的回调函数
+     * @internal
      */
-    maxScenes?: number;
+    setSceneChangedCallback(callback: () => void): void;
     /**
-     * 是否自动清理空Scene
-     */
-    autoCleanup?: boolean;
+     * 设置当前场景（立即切换）
+     *
+     * 会自动处理旧场景的结束和新场景的初始化。
+     *
+     * @param scene - 要设置的场景实例
+     * @returns 返回设置的场景实例，便于链式调用
+     *
+     * @example
+     * ```typescript
+     * const gameScene = sceneManager.setScene(new GameScene());
+     * console.log(gameScene.name); // 可以立即使用返回的场景
+     * ```
+     */
+    setScene<T extends IScene>(scene: T): T;
+    /**
+     * 延迟加载场景（下一帧切换）
+     *
+     * 场景不会立即切换，而是在下一次调用 update() 时切换。
+     * 这对于避免在当前帧的中途切换场景很有用。
+     *
+     * @param scene - 要加载的场景实例
+     *
+     * @example
+     * ```typescript
+     * // 在某个System中触发场景切换
+     * class GameOverSystem extends EntitySystem {
+     *     process(entities: readonly Entity[]) {
+     *         if (playerHealth <= 0) {
+     *             sceneManager.loadScene(new GameOverScene());
+     *             // 当前帧继续执行，场景将在下一帧切换
+     *         }
+     *     }
+     * }
+     * ```
+     */
+    loadScene<T extends IScene>(scene: T): void;
+    /**
+     * 获取当前活跃的场景
+     *
+     * @returns 当前场景实例，如果没有场景则返回null
+     */
+    get currentScene(): IScene | null;
+    /**
+     * 获取ECS流式API
+     *
+     * 提供便捷的实体查询、事件发射等功能。
+     *
+     * @returns ECS API实例，如果当前没有场景则返回null
+     *
+     * @example
+     * ```typescript
+     * const api = sceneManager.api;
+     * if (api) {
+     *     // 查询所有敌人
+     *     const enemies = api.find(Enemy, Transform);
+     *
+     *     // 发射事件
+     *     api.emit('game:start', { level: 1 });
+     * }
+     * ```
+     */
+    get api(): ECSFluentAPI | null;
+    /**
+     * 更新场景
+     *
+     * 应该在每帧的游戏循环中调用。
+     * 会自动处理延迟场景切换。
+     *
+     * @example
+     * ```typescript
+     * function gameLoop(deltaTime: number) {
+     *     Core.update(deltaTime);
+     *     sceneManager.update();  // 每帧调用
+     * }
+     * ```
+     */
+    update(): void;
+    /**
+     * 销毁场景管理器
+     *
+     * 会自动结束当前场景并清理所有资源。
+     * 通常在应用程序关闭时调用。
+     */
+    destroy(): void;
+    /**
+     * 检查是否有活跃场景
+     *
+     * @returns 如果有活跃场景返回true，否则返回false
+     */
+    get hasScene(): boolean;
+    /**
+     * 检查是否有待切换的场景
+     *
+     * @returns 如果有待切换场景返回true，否则返回false
+     */
+    get hasPendingScene(): boolean;
+    /**
+     * 释放资源（IService接口）
+     */
+    dispose(): void;
+}
+
+/**
+ * 全局系统接口
+ * 全局系统是在World级别运行的系统，不依赖特定Scene
+ */
+interface IGlobalSystem {
+    /**
+     * 系统名称
+     */
+    readonly name: string;
+    /**
+     * 初始化系统
+     */
+    initialize?(): void;
+    /**
+     * 更新系统
+     */
+    update(deltaTime?: number): void;
+    /**
+     * 重置系统
+     */
+    reset?(): void;
+    /**
+     * 销毁系统
+     */
+    destroy?(): void;
+}
+/**
+ * World配置接口
+ */
+interface IWorldConfig {
+    /**
+     * World名称
+     */
+    name?: string;
+    /**
+     * 是否启用调试模式
+     */
+    debug?: boolean;
+    /**
+     * 最大Scene数量限制
+     */
+    maxScenes?: number;
+    /**
+     * 是否自动清理空Scene
+     */
+    autoCleanup?: boolean;
 }
 /**
  * World类 - ECS世界管理器
@@ -7654,12 +8109,6 @@ interface IWorldManagerConfig {
      * 是否启用调试模式
      */
     debug?: boolean;
-    /**
-     * 是否创建默认World(默认true)
-     *
-     * 当通过Core使用时应该为true,直接使用WorldManager时可设为false
-     */
-    createDefaultWorld?: boolean;
 }
 /**
  * World管理器 - 管理所有World实例
@@ -7689,38 +8138,24 @@ interface IWorldManagerConfig {
  *
  * // 游戏循环
  * function gameLoop(deltaTime: number) {
- *     Core.update(deltaTime);  // 自动更新所有@Updatable服务(包括WorldManager)
+ *     Core.update(deltaTime);
+ *     worldManager.updateAll();  // 更新所有活跃World
  * }
  * ```
  */
-declare class WorldManager implements IService, IUpdatable {
-    /**
-     * 默认World的ID
-     */
-    static readonly DEFAULT_WORLD_ID = "__default__";
+declare class WorldManager implements IService {
     private readonly _config;
     private readonly _worlds;
     private readonly _activeWorlds;
     private _cleanupTimer;
     private _isRunning;
     constructor(config?: IWorldManagerConfig);
-    /**
-     * 获取默认World
-     *
-     * 默认World由WorldManager自动创建，供SceneManager使用。
-     * 此方法主要供SceneManager内部使用。
-     *
-     * @returns 默认World实例
-     */
-    getDefaultWorld(): World;
     /**
      * 创建新World
      */
     createWorld(worldId: string, config?: IWorldConfig): World;
     /**
      * 移除World
-     *
-     * 注意:默认World不能被删除
      */
     removeWorld(worldId: string): boolean;
     /**
@@ -7746,12 +8181,18 @@ declare class WorldManager implements IService, IUpdatable {
     /**
      * 更新所有活跃的World
      *
-     * 此方法由ServiceContainer自动调用(@Updatable装饰器)
+     * 应该在每帧的游戏循环中调用。
      * 会自动更新所有活跃World的全局系统和场景。
      *
-     * @param deltaTime 帧时间间隔(未使用,保留用于接口兼容)
+     * @example
+     * ```typescript
+     * function gameLoop(deltaTime: number) {
+     *     Core.update(deltaTime);      // 更新全局服务
+     *     worldManager.updateAll();    // 更新所有World
+     * }
+     * ```
      */
-    update(deltaTime?: number): void;
+    updateAll(): void;
     /**
      * 获取所有激活的World
      */
@@ -7800,12 +8241,6 @@ declare class WorldManager implements IService, IUpdatable {
              * 是否启用调试模式
              */
             debug?: boolean;
-            /**
-             * 是否创建默认World(默认true)
-             *
-             * 当通过Core使用时应该为true,直接使用WorldManager时可设为false
-             */
-            createDefaultWorld?: boolean;
         };
         worlds: any[];
     };
@@ -7860,12 +8295,6 @@ declare class WorldManager implements IService, IUpdatable {
              * 是否启用调试模式
              */
             debug?: boolean;
-            /**
-             * 是否创建默认World(默认true)
-             *
-             * 当通过Core使用时应该为true,直接使用WorldManager时可设为false
-             */
-            createDefaultWorld?: boolean;
         };
     };
     /**
@@ -7911,188 +8340,6 @@ declare class WorldManager implements IService, IUpdatable {
     get config(): IWorldManagerConfig;
 }
 
-/**
- * 单场景管理器
- *
- * 适用场景：
- * - 单人游戏
- * - 简单场景切换
- * - 不需要多World隔离的项目
- *
- * 特点：
- * - 轻量级，零额外开销
- * - 简单直观的API
- * - 支持延迟场景切换
- * - 自动管理ECS API
- * - 通过依赖注入获取WorldManager的默认World
- *
- * @example
- * ```typescript
- * // 初始化Core
- * Core.create({ debug: true });
- *
- * // 设置场景
- * class GameScene extends Scene {
- *     initialize() {
- *         const player = this.createEntity('Player');
- *         player.addComponent(new Transform(100, 100));
- *     }
- * }
- *
- * Core.setScene(new GameScene());
- *
- * // 游戏循环
- * function gameLoop(deltaTime: number) {
- *     Core.update(deltaTime);  // 自动更新所有服务(包括SceneManager)
- * }
- *
- * // 延迟切换场景（下一帧生效）
- * Core.loadScene(new MenuScene());
- * ```
- */
-declare class SceneManager implements IService, IUpdatable {
-    /**
-     * 内部默认World(从WorldManager获取)
-     */
-    private _defaultWorld;
-    /**
-     * 待切换的下一个场景（延迟切换用）
-     */
-    private _nextScene;
-    /**
-     * ECS流式API
-     */
-    private _ecsAPI;
-    /**
-     * 日志器
-     */
-    private _logger;
-    /**
-     * 场景切换回调函数
-     */
-    private _onSceneChangedCallback?;
-    /**
-     * 默认场景ID
-     */
-    private static readonly DEFAULT_SCENE_ID;
-    /**
-     * 构造函数
-     *
-     * WorldManager通过依赖注入自动传入
-     *
-     * @param worldManager WorldManager实例,用于获取默认World
-     */
-    constructor(worldManager: WorldManager);
-    /**
-     * 设置场景切换回调
-     *
-     * @param callback 场景切换时的回调函数
-     * @internal
-     */
-    setSceneChangedCallback(callback: () => void): void;
-    /**
-     * 设置当前场景（立即切换）
-     *
-     * 会自动处理旧场景的结束和新场景的初始化。
-     *
-     * @param scene - 要设置的场景实例
-     * @returns 返回设置的场景实例，便于链式调用
-     *
-     * @example
-     * ```typescript
-     * const gameScene = sceneManager.setScene(new GameScene());
-     * console.log(gameScene.name); // 可以立即使用返回的场景
-     * ```
-     */
-    setScene<T extends IScene>(scene: T): T;
-    /**
-     * 延迟加载场景（下一帧切换）
-     *
-     * 场景不会立即切换，而是在下一次调用 update() 时切换。
-     * 这对于避免在当前帧的中途切换场景很有用。
-     *
-     * @param scene - 要加载的场景实例
-     *
-     * @example
-     * ```typescript
-     * // 在某个System中触发场景切换
-     * class GameOverSystem extends EntitySystem {
-     *     process(entities: readonly Entity[]) {
-     *         if (playerHealth <= 0) {
-     *             sceneManager.loadScene(new GameOverScene());
-     *             // 当前帧继续执行，场景将在下一帧切换
-     *         }
-     *     }
-     * }
-     * ```
-     */
-    loadScene<T extends IScene>(scene: T): void;
-    /**
-     * 获取当前活跃的场景
-     *
-     * @returns 当前场景实例，如果没有场景则返回null
-     */
-    get currentScene(): IScene | null;
-    /**
-     * 获取ECS流式API
-     *
-     * 提供便捷的实体查询、事件发射等功能。
-     *
-     * @returns ECS API实例，如果当前没有场景则返回null
-     *
-     * @example
-     * ```typescript
-     * const api = sceneManager.api;
-     * if (api) {
-     *     // 查询所有敌人
-     *     const enemies = api.find(Enemy, Transform);
-     *
-     *     // 发射事件
-     *     api.emit('game:start', { level: 1 });
-     * }
-     * ```
-     */
-    get api(): ECSFluentAPI | null;
-    /**
-     * 更新场景
-     *
-     * 应该在每帧的游戏循环中调用。
-     * 会自动处理延迟场景切换。
-     *
-     * @example
-     * ```typescript
-     * function gameLoop(deltaTime: number) {
-     *     Core.update(deltaTime);
-     *     sceneManager.update();  // 每帧调用
-     * }
-     * ```
-     */
-    update(): void;
-    /**
-     * 销毁场景管理器
-     *
-     * 会自动结束当前场景并清理所有资源。
-     * 通常在应用程序关闭时调用。
-     */
-    destroy(): void;
-    /**
-     * 检查是否有活跃场景
-     *
-     * @returns 如果有活跃场景返回true，否则返回false
-     */
-    get hasScene(): boolean;
-    /**
-     * 检查是否有待切换的场景
-     *
-     * @returns 如果有待切换场景返回true，否则返回false
-     */
-    get hasPendingScene(): boolean;
-    /**
-     * 释放资源（IService接口）
-     */
-    dispose(): void;
-}
-
 /**
  * 组件对象池，用于复用组件实例以减少内存分配
  */
@@ -9069,14 +9316,26 @@ declare class WebSocketManager {
     private handleConnectionFailure;
 }
 
+/**
+ * 调试配置服务
+ *
+ * 管理调试系统的配置信息
+ */
+declare class DebugConfigService implements IService {
+    private _config;
+    constructor();
+    setConfig(config: IECSDebugConfig): void;
+    getConfig(): IECSDebugConfig;
+    isEnabled(): boolean;
+    dispose(): void;
+}
+
 /**
  * 调试管理器
  *
  * 整合所有调试数据收集器，负责收集和发送调试数据
- *
- * 通过构造函数接收SceneManager和PerformanceMonitor，避免直接依赖Core实例
  */
-declare class DebugManager implements IService {
+declare class DebugManager implements IService, IUpdatable {
     private config;
     private webSocketManager;
     private entityCollector;
@@ -9090,13 +9349,7 @@ declare class DebugManager implements IService {
     private lastSendTime;
     private sendInterval;
     private isRunning;
-    /**
-     * 构造调试管理器
-     * @param sceneManager 场景管理器
-     * @param performanceMonitor 性能监控器
-     * @param config 调试配置
-     */
-    constructor(sceneManager: SceneManager, performanceMonitor: PerformanceMonitor, config: IECSDebugConfig);
+    constructor(sceneManager: SceneManager, performanceMonitor: PerformanceMonitor, configService: DebugConfigService);
     /**
      * 启动调试管理器
      */
@@ -9109,10 +9362,7 @@ declare class DebugManager implements IService {
      * 更新配置
      */
     updateConfig(config: IECSDebugConfig): void;
-    /**
-     * 帧更新回调
-     */
-    onFrameUpdate(deltaTime: number): void;
+    update(deltaTime?: number): void;
     /**
      * 场景变更回调
      */
@@ -9815,6 +10065,11 @@ interface InjectableMetadata {
      * 依赖列表
      */
     dependencies: Array<ServiceType<any> | string | symbol>;
+    /**
+     * 属性注入映射
+     * key: 属性名, value: 服务类型
+     */
+    properties?: Map<string | symbol, ServiceType<any>>;
 }
 /**
  * 可更新元数据接口
@@ -9888,20 +10143,7 @@ declare function Updatable(priority?: number): ClassDecorator;
  *
  * 标记构造函数参数需要注入的服务类型
  *
- * @param serviceType 服务类型标识符（类、字符串或Symbol）
- *
- * @example
- * ```typescript
- * @Injectable()
- * class MySystem extends EntitySystem {
- *     constructor(
- *         @Inject(TimeService) private timeService: TimeService,
- *         @Inject(PhysicsService) private physics: PhysicsService
- *     ) {
- *         super();
- *     }
- * }
- * ```
+ * @param serviceType 服务类型标识符
  */
 declare function Inject(serviceType: ServiceType<any> | string | symbol): ParameterDecorator;
 /**
@@ -10582,5 +10824,5 @@ declare function getFullPlatformConfig(): Promise<any>;
 declare function supportsFeature(feature: 'worker' | 'shared-array-buffer' | 'transferable-objects' | 'module-worker'): boolean;
 declare function hasAdapter(): boolean;
 
-export { AutoTyped, BitMask64Utils, Bits, COMPONENT_TYPE_NAME, ChangeOperation, Colors, Component, ComponentDataCollector, ComponentPool, ComponentPoolManager, ComponentRegistry, ComponentSerializer, ComponentSparseSet, ComponentStorage, ComponentTypeManager, ConsoleLogger, Core, DebugManager, DeepCopy, ECSComponent, ECSEventType, ECSFluentAPI, ECSSystem, ENTITY_REF_METADATA, EVENT_TYPES, Emitter, EnableSoA, Entity, EntityDataCollector, EntityList, EntityProcessorList, EntityRef, EntitySerializer, EntitySystem, EventBus, EventPriority, EventTypeValidator, Float32, Float64, FuncPack, GlobalEventBus, GlobalManager, HighPrecision, IdentifierPool, IgnoreSerialization, IncrementalSerializer, Inject, Injectable, Int16, Int32, Int8, IntervalSystem, LogLevel, Logger, LoggerManager, Matcher, MigrationBuilder, NumberExtension, PassiveSystem, PerformanceDataCollector, PerformanceMonitor, PerformanceWarningType, PlatformDetector, PlatformManager, PluginManager, PluginState, Pool, PoolManager, ProcessingSystem, QuerySystem, ReferenceTracker, SERIALIZABLE_METADATA, SERIALIZE_FIELD, SERIALIZE_OPTIONS, SYSTEM_TYPE_NAME, Scene, SceneDataCollector, SceneManager, SceneSerializer, Serializable, Serialize, SerializeArray, SerializeAsMap, SerializeAsSet, SerializeMap, SerializeSet, ServiceContainer, ServiceLifetime, SoAStorage, SparseSet, SystemDataCollector, Time, Timer, TimerManager, TypeInference, TypeSafeEventSystem, TypeUtils, TypedEntityBuilder, TypedQueryBuilder, TypedQueryResult, Uint16, Uint32, Uint8, Uint8Clamped, Updatable, VersionMigrationManager, WebSocketManager, WorkerEntitySystem, World, WorldManager, addAndConfigure, buildEntity, createECSAPI, createInstance, createLogger, createQuery, getBasicWorkerConfig, getComponentInstanceTypeName, getComponentTypeName, getComponents, getCurrentAdapter, getEntityRefMetadata, getFullPlatformConfig, getOrAddComponent, getSceneByEntityId, getSerializationMetadata, getSystemInstanceTypeName, getSystemMetadata, getSystemTypeName, getUpdatableMetadata, hasAdapter, hasAnyComponent, hasComponents, hasEntityRef, isComponentArray, isComponentType, isSerializable, isUpdatable, queryFor, queryForAll, registerInjectable, registerPlatformAdapter, requireComponent, resetLoggerColors, setGlobalLogLevel, setLoggerColors, supportsFeature, tryGetComponent, updateComponent };
-export type { AnyComponentConstructor, BitMask64Data, ComponentChange, ComponentConstructor, ComponentInstance, ComponentMigrationFunction, ComponentType$1 as ComponentType, ComponentTypeMap, ComponentTypeName, ComponentTypeNames, DataOnly, DeepPartial, DeepReadonly, DeserializationStrategy, EntityChange, EntityRefMetadata, EntityRefRecord, EntityWithComponents, EventListenerConfig, EventStats, ExtractComponents, FieldSerializeOptions, IComponent, IComponentDebugData, IComponentEventData, ICoreConfig, IECSDebugConfig, IECSDebugData, IEntityDebugData, IEntityEventData, IEntityHierarchyNode, IEventBus, IEventData, IEventListenerConfig, IEventStats, ILogger, IPerformanceDebugData, IPerformanceEventData, IPlatformAdapter, IPlugin, IPluginMetadata, IPoolable, IScene, ISceneConfig, ISceneDebugData, ISceneEventData, ISceneFactory, IService, ISystemBase, ISystemDebugData, ISystemEventData, ITimer, IUpdatable, IWorldConfig, IWorldManagerConfig, IncrementalSerializationFormat, IncrementalSerializationOptions, IncrementalSnapshot, InjectableMetadata, LoggerColorConfig, LoggerConfig, MigrationFunction, PartialComponent, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PlatformConfig, PlatformDetectionResult, PlatformWorker, PoolStats, QueryResult$1 as QueryResult, ReadonlyComponent, SceneDataChange, SceneDeserializationOptions, SceneMigrationFunction, SceneSerializationOptions, SerializableComponent, SerializableFields, SerializableOptions, SerializationFormat, SerializationMetadata, SerializedComponent, SerializedEntity, SerializedScene, ServiceType, SharedArrayBufferProcessFunction, SupportedTypedArray, SystemEntityType, SystemLifecycleHooks, SystemMetadata, TypeSafeBuilder, TypedEventHandler, TypedQueryCondition, UpdatableMetadata, ValidComponent, ValidComponentArray, WorkerCreationOptions, WorkerProcessFunction, WorkerSystemConfig };
+export { AutoTyped, BitMask64Utils, Bits, COMPONENT_TYPE_NAME, ChangeOperation, Colors, Component, ComponentDataCollector, ComponentPool, ComponentPoolManager, ComponentRegistry, ComponentSerializer, ComponentSparseSet, ComponentStorage, ConsoleLogger, Core, DebugConfigService, DebugManager, DeepCopy, ECSComponent, ECSEventType, ECSFluentAPI, ECSSystem, ENTITY_REF_METADATA, EVENT_TYPES, Emitter, EnableSoA, Entity, EntityDataCollector, EntityList, EntityProcessorList, EntityRef, EntitySerializer, EntitySystem, EventBus, EventPriority, EventTypeValidator, Float32, Float64, FuncPack, GlobalEventBus, GlobalManager, HighPrecision, IdentifierPool, IgnoreSerialization, IncrementalSerializer, Inject, Injectable, Int16, Int32, Int8, IntervalSystem, LogLevel, Logger, LoggerManager, Matcher, MigrationBuilder, NumberExtension, PassiveSystem, PerformanceDataCollector, PerformanceMonitor, PerformanceWarningType, PlatformDetector, PlatformManager, PluginManager, PluginState, Pool, PoolManager, ProcessingSystem, QuerySystem, ReactiveQuery, ReactiveQueryChangeType, ReferenceTracker, SERIALIZABLE_METADATA, SERIALIZE_FIELD, SERIALIZE_OPTIONS, SYSTEM_TYPE_NAME, Scene, SceneDataCollector, SceneManager, SceneSerializer, Serializable, Serialize, SerializeArray, SerializeAsMap, SerializeAsSet, SerializeMap, SerializeSet, ServiceContainer, ServiceLifetime, SoAStorage, SparseSet, SystemDataCollector, Time, Timer, TimerManager, TypeInference, TypeSafeEventSystem, TypeUtils, TypedEntityBuilder, TypedQueryBuilder, TypedQueryResult, Uint16, Uint32, Uint8, Uint8Clamped, Updatable, VersionMigrationManager, WebSocketManager, WorkerEntitySystem, World, WorldManager, addAndConfigure, buildEntity, createECSAPI, createInstance, createLogger, createQuery, getBasicWorkerConfig, getComponentInstanceTypeName, getComponentTypeName, getComponents, getCurrentAdapter, getEntityRefMetadata, getFullPlatformConfig, getOrAddComponent, getSceneByEntityId, getSerializationMetadata, getSystemInstanceTypeName, getSystemMetadata, getSystemTypeName, getUpdatableMetadata, hasAdapter, hasAnyComponent, hasComponents, hasEntityRef, isComponentArray, isComponentType, isSerializable, isUpdatable, queryFor, queryForAll, registerInjectable, registerPlatformAdapter, requireComponent, resetLoggerColors, setGlobalLogLevel, setLoggerColors, supportsFeature, tryGetComponent, updateComponent };
+export type { AnyComponentConstructor, BitMask64Data, ComponentChange, ComponentConstructor, ComponentInstance, ComponentMigrationFunction, ComponentType$1 as ComponentType, ComponentTypeMap, ComponentTypeName, ComponentTypeNames, DataOnly, DeepPartial, DeepReadonly, DeserializationStrategy, EntityChange, EntityRefMetadata, EntityRefRecord, EntityWithComponents, EventListenerConfig, EventStats, ExtractComponents, FieldSerializeOptions, IComponent, IComponentDebugData, IComponentEventData, ICoreConfig, IECSDebugConfig, IECSDebugData, IEntityDebugData, IEntityEventData, IEntityHierarchyNode, IEventBus, IEventData, IEventListenerConfig, IEventStats, ILogger, IPerformanceDebugData, IPerformanceEventData, IPlatformAdapter, IPlugin, IPluginMetadata, IPoolable, IScene, ISceneConfig, ISceneDebugData, ISceneEventData, ISceneFactory, IService, ISystemBase, ISystemDebugData, ISystemEventData, ITimer, IUpdatable, IWorldConfig, IWorldManagerConfig, IncrementalSerializationFormat, IncrementalSerializationOptions, IncrementalSnapshot, InjectableMetadata, LoggerColorConfig, LoggerConfig, MigrationFunction, PartialComponent, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PlatformConfig, PlatformDetectionResult, PlatformWorker, PoolStats, QueryResult$1 as QueryResult, ReactiveQueryChange, ReactiveQueryConfig, ReactiveQueryListener, ReadonlyComponent, SceneDataChange, SceneDeserializationOptions, SceneMigrationFunction, SceneSerializationOptions, SerializableComponent, SerializableFields, SerializableOptions, SerializationFormat, SerializationMetadata, SerializedComponent, SerializedEntity, SerializedScene, ServiceType, SharedArrayBufferProcessFunction, SupportedTypedArray, SystemEntityType, SystemLifecycleHooks, SystemMetadata, TypeSafeBuilder, TypedEventHandler, TypedQueryCondition, UpdatableMetadata, ValidComponent, ValidComponentArray, WorkerCreationOptions, WorkerProcessFunction, WorkerSystemConfig };