@esengine/ecs-framework 2.1.15 → 2.1.17

package/index.d.ts

@@ -1,204 +1,7 @@
 /**
- * @esengine/ecs-framework v2.1.15
+ * @esengine/ecs-framework v2.1.17
  * TypeScript definitions
  */
-/**
- * 用于包装事件的一个小类
- */
-declare class FuncPack {
-    /** 函数 */
-    func: Function;
-    /** 上下文 */
-    context: any;
-    constructor(func: Function, context: any);
-}
-/**
- * 用于事件管理
- */
-declare class Emitter<T> {
-    private _messageTable;
-    constructor();
-    /**
-     * 开始监听项
-     * @param eventType 监听类型
-     * @param handler 监听函数
-     * @param context 监听上下文
-     */
-    addObserver(eventType: T, handler: Function, context: any): void;
-    /**
-     * 移除监听项
-     * @param eventType 事件类型
-     * @param handler 事件函数
-     */
-    removeObserver(eventType: T, handler: Function): void;
-    /**
-     * 触发该事件
-     * @param eventType 事件类型
-     * @param data 事件数据
-     */
-    emit(eventType: T, ...data: any[]): void;
-    /**
-     * 判断是否存在该类型的观察者
-     * @param eventType 事件类型
-     * @param handler 事件函数
-     */
-    hasObserver(eventType: T, handler: Function): boolean;
-}
-
-/**
- * 核心事件枚举
- * 定义框架中的核心事件类型
- */
-declare enum CoreEvents {
-    /**
-     * 当场景发生变化时触发
-     */
-    sceneChanged = 0,
-    /**
-     * 每帧更新事件
-     */
-    frameUpdated = 1,
-    /**
-     * 当渲染发生时触发
-     */
-    renderChanged = 2
-}
-/**
- * ECS事件类型枚举
- * 定义实体组件系统中的所有事件类型
- */
-declare enum ECSEventType {
-    ENTITY_CREATED = "entity:created",
-    ENTITY_DESTROYED = "entity:destroyed",
-    ENTITY_ENABLED = "entity:enabled",
-    ENTITY_DISABLED = "entity:disabled",
-    ENTITY_TAG_ADDED = "entity:tag:added",
-    ENTITY_TAG_REMOVED = "entity:tag:removed",
-    ENTITY_NAME_CHANGED = "entity:name:changed",
-    COMPONENT_ADDED = "component:added",
-    COMPONENT_REMOVED = "component:removed",
-    COMPONENT_MODIFIED = "component:modified",
-    COMPONENT_ENABLED = "component:enabled",
-    COMPONENT_DISABLED = "component:disabled",
-    SYSTEM_ADDED = "system:added",
-    SYSTEM_REMOVED = "system:removed",
-    SYSTEM_ENABLED = "system:enabled",
-    SYSTEM_DISABLED = "system:disabled",
-    SYSTEM_PROCESSING_START = "system:processing:start",
-    SYSTEM_PROCESSING_END = "system:processing:end",
-    SYSTEM_ERROR = "system:error",
-    SCENE_CREATED = "scene:created",
-    SCENE_DESTROYED = "scene:destroyed",
-    SCENE_ACTIVATED = "scene:activated",
-    SCENE_DEACTIVATED = "scene:deactivated",
-    SCENE_PAUSED = "scene:paused",
-    SCENE_RESUMED = "scene:resumed",
-    QUERY_EXECUTED = "query:executed",
-    QUERY_CACHE_HIT = "query:cache:hit",
-    QUERY_CACHE_MISS = "query:cache:miss",
-    QUERY_OPTIMIZED = "query:optimized",
-    PERFORMANCE_WARNING = "performance:warning",
-    PERFORMANCE_CRITICAL = "performance:critical",
-    MEMORY_USAGE_HIGH = "memory:usage:high",
-    FRAME_RATE_DROP = "frame:rate:drop",
-    INDEX_CREATED = "index:created",
-    INDEX_UPDATED = "index:updated",
-    INDEX_OPTIMIZED = "index:optimized",
-    ARCHETYPE_CREATED = "archetype:created",
-    ARCHETYPE_ENTITY_ADDED = "archetype:entity:added",
-    ARCHETYPE_ENTITY_REMOVED = "archetype:entity:removed",
-    DIRTY_MARK_ADDED = "dirty:mark:added",
-    DIRTY_BATCH_PROCESSED = "dirty:batch:processed",
-    ERROR_OCCURRED = "error:occurred",
-    WARNING_ISSUED = "warning:issued",
-    FRAMEWORK_INITIALIZED = "framework:initialized",
-    FRAMEWORK_SHUTDOWN = "framework:shutdown",
-    DEBUG_INFO = "debug:info",
-    DEBUG_STATS_UPDATED = "debug:stats:updated"
-}
-/**
- * 事件优先级枚举
- * 定义事件处理的优先级级别
- */
-declare enum EventPriority {
-    LOWEST = 0,
-    LOW = 25,
-    NORMAL = 50,
-    HIGH = 75,
-    HIGHEST = 100,
-    CRITICAL = 200
-}
-/**
- * 预定义的事件类型常量
- * 提供类型安全的事件类型字符串
- */
-declare const EVENT_TYPES: {
-    readonly CORE: {
-        readonly SCENE_CHANGED: "core:scene:changed";
-        readonly FRAME_UPDATED: "core:frame:updated";
-        readonly RENDER_CHANGED: "core:render:changed";
-    };
-    readonly ENTITY: {
-        readonly CREATED: ECSEventType.ENTITY_CREATED;
-        readonly DESTROYED: ECSEventType.ENTITY_DESTROYED;
-        readonly ENABLED: ECSEventType.ENTITY_ENABLED;
-        readonly DISABLED: ECSEventType.ENTITY_DISABLED;
-        readonly TAG_ADDED: ECSEventType.ENTITY_TAG_ADDED;
-        readonly TAG_REMOVED: ECSEventType.ENTITY_TAG_REMOVED;
-        readonly NAME_CHANGED: ECSEventType.ENTITY_NAME_CHANGED;
-    };
-    readonly COMPONENT: {
-        readonly ADDED: ECSEventType.COMPONENT_ADDED;
-        readonly REMOVED: ECSEventType.COMPONENT_REMOVED;
-        readonly MODIFIED: ECSEventType.COMPONENT_MODIFIED;
-        readonly ENABLED: ECSEventType.COMPONENT_ENABLED;
-        readonly DISABLED: ECSEventType.COMPONENT_DISABLED;
-    };
-    readonly SYSTEM: {
-        readonly ADDED: ECSEventType.SYSTEM_ADDED;
-        readonly REMOVED: ECSEventType.SYSTEM_REMOVED;
-        readonly ENABLED: ECSEventType.SYSTEM_ENABLED;
-        readonly DISABLED: ECSEventType.SYSTEM_DISABLED;
-        readonly PROCESSING_START: ECSEventType.SYSTEM_PROCESSING_START;
-        readonly PROCESSING_END: ECSEventType.SYSTEM_PROCESSING_END;
-        readonly ERROR: ECSEventType.SYSTEM_ERROR;
-    };
-    readonly PERFORMANCE: {
-        readonly WARNING: ECSEventType.PERFORMANCE_WARNING;
-        readonly CRITICAL: ECSEventType.PERFORMANCE_CRITICAL;
-        readonly MEMORY_HIGH: ECSEventType.MEMORY_USAGE_HIGH;
-        readonly FRAME_DROP: ECSEventType.FRAME_RATE_DROP;
-    };
-};
-/**
- * 事件类型验证器
- * 验证事件类型是否有效
- */
-declare class EventTypeValidator {
-    private static validTypes;
-    /**
-     * 验证事件类型是否有效
-     * @param eventType 事件类型
-     * @returns 是否有效
-     */
-    static isValid(eventType: string): boolean;
-    /**
-     * 获取所有有效的事件类型
-     * @returns 事件类型数组
-     */
-    static getAllValidTypes(): string[];
-    /**
-     * 添加自定义事件类型
-     * @param eventType 事件类型
-     */
-    static addCustomType(eventType: string): void;
-    /**
-     * 移除自定义事件类型
-     * @param eventType 事件类型
-     */
-    static removeCustomType(eventType: string): void;
-}
-
 /**
  * 全局管理器的基类。所有全局管理器都应该从此类继承。
  */
@@ -258,6 +61,14 @@ declare class Timer implements ITimer {
     _isDone: boolean;
     _elapsedTime: number;
     getContext<T>(): T;
+    /**
+     * 定时器是否已完成
+     */
+    get isDone(): boolean;
+    /**
+     * 定时器已运行的时间
+     */
+    get elapsedTime(): number;
     reset(): void;
     stop(): void;
     tick(): boolean;
@@ -737,24 +548,6 @@ declare class PoolManager {
 /**
  * 框架核心类型定义
  */
-/** 更新顺序比较器接口 */
-interface IUpdateOrderComparable {
-    updateOrder: number;
-}
-/** 日志类型枚举 */
-declare enum LogType {
-    Error = 0,
-    Assert = 1,
-    Warning = 2,
-    Log = 3,
-    Exception = 4
-}
-/** 组件变换类型枚举 */
-declare enum ComponentTransform {
-    Position = 1,
-    Scale = 2,
-    Rotation = 4
-}
 /**
  * 组件接口
  *
@@ -781,125 +574,14 @@ interface IComponent {
     update(): void;
 }
 /**
- * 实体接口
+ * 系统基础接口
  *
- * 定义实体的基本契约，所有实体都应该实现此接口
- */
-interface IEntity {
-    /** 实体唯一标识符 */
-    readonly id: string | number;
-    /** 实体名称 */
-    name: string;
-    /** 实体激活状态 */
-    active: boolean;
-    /** 实体启用状态 */
-    enabled: boolean;
-    /** 实体是否已销毁 */
-    readonly isDestroyed: boolean;
-    /** 更新顺序 */
-    updateOrder: number;
-    /** 实体标签 */
-    tag: number;
-    /** 添加组件 */
-    addComponent<T extends IComponent>(component: T): T;
-    /** 创建并添加组件 */
-    createComponent<T extends IComponent>(componentType: ComponentType$1<T>, ...args: any[]): T;
-    /** 获取组件 */
-    getComponent<T extends IComponent>(type: ComponentType$1<T>): T | null;
-    /** 获取或创建组件 */
-    getOrCreateComponent<T extends IComponent>(type: ComponentType$1<T>, ...args: any[]): T;
-    /** 移除组件 */
-    removeComponent(component: IComponent): void;
-    /** 通过类型移除组件 */
-    removeComponentByType<T extends IComponent>(type: ComponentType$1<T>): T | null;
-    /** 检查是否有组件 */
-    hasComponent<T extends IComponent>(type: ComponentType$1<T>): boolean;
-    /** 获取所有指定类型的组件 */
-    getComponents<T extends IComponent>(type: ComponentType$1<T>): T[];
-    /** 添加子实体 */
-    addChild(child: IEntity): IEntity;
-    /** 移除子实体 */
-    removeChild(child: IEntity): boolean;
-    /** 查找子实体 */
-    findChild(name: string, recursive?: boolean): IEntity | null;
-    /** 更新实体 */
-    update(): void;
-    /** 销毁实体 */
-    destroy(): void;
-}
-/**
- * 实体基础接口（向后兼容）
- *
- * 为现有的Entity类提供更灵活的类型定义
- */
-interface IEntityBase {
-    /** 实体唯一标识符 */
-    readonly id: string | number;
-    /** 实体名称 */
-    name: string;
-    /** 实体激活状态 */
-    active: boolean;
-    /** 实体启用状态 */
-    enabled: boolean;
-    /** 实体是否已销毁 */
-    readonly isDestroyed: boolean;
-    /** 更新顺序 */
-    updateOrder: number;
-    /** 实体标签 */
-    tag: number;
-    /** 添加组件（泛型版本） */
-    addComponent<T>(component: T): T;
-    /** 获取组件（泛型版本） */
-    getComponent<T>(type: ComponentClass<T>): T | null;
-    /** 检查是否有组件（泛型版本） */
-    hasComponent<T>(type: ComponentClass<T>): boolean;
-    /** 添加子实体 */
-    addChild(child: any): any;
-    /** 移除子实体 */
-    removeChild(child: any): boolean;
-    /** 查找子实体 */
-    findChild(name: string, recursive?: boolean): any;
-    /** 更新实体 */
-    update(): void;
-    /** 销毁实体 */
-    destroy(): void;
-}
-/**
- * 系统接口
- *
- * 定义系统的基本契约，所有系统都应该实现此接口
- */
-interface ISystem {
-    /** 系统名称 */
-    readonly systemName: string;
-    /** 系统处理的实体列表 */
-    readonly entities: readonly IEntity[];
-    /** 更新顺序/优先级 */
-    updateOrder: number;
-    /** 系统启用状态 */
-    enabled: boolean;
-    /** 系统初始化 */
-    initialize(): void;
-    /** 更新系统（主要处理阶段） */
-    update(): void;
-    /** 延迟更新系统 */
-    lateUpdate?(): void;
-    /** 当实体添加到系统时的回调 */
-    onEntityAdded?(entity: IEntity): void;
-    /** 当实体从系统移除时的回调 */
-    onEntityRemoved?(entity: IEntity): void;
-    /** 当实体组件发生变化时的回调 */
-    onEntityChanged?(entity: IEntity): void;
-}
-/**
- * 系统基础接口（向后兼容）
- *
- * 为现有的EntitySystem类提供更灵活的类型定义
+ * 为现有的EntitySystem类提供类型定义
  */
 interface ISystemBase {
     /** 系统名称 */
     readonly systemName: string;
-    /** 系统处理的实体列表（泛型版本） */
+    /** 系统处理的实体列表 */
     readonly entities: readonly any[];
     /** 更新顺序/优先级 */
     updateOrder: number;
@@ -912,191 +594,12 @@ interface ISystemBase {
     /** 延迟更新系统 */
     lateUpdate?(): void;
 }
-/**
- * 场景接口
- *
- * 定义场景的基本契约
- */
-interface IScene {
-    /** 场景名称 */
-    name: string;
-    /** 场景中的实体列表 */
-    readonly entities: readonly IEntity[];
-    /** 场景中的系统列表 */
-    readonly systems: readonly ISystem[];
-    /** 创建实体 */
-    createEntity(name: string): IEntity;
-    /** 添加实体到场景 */
-    addEntity(entity: IEntity): void;
-    /** 从场景移除实体 */
-    removeEntity(entity: IEntity): void;
-    /** 查找实体 */
-    findEntity(name: string): IEntity | null;
-    /** 添加系统到场景 */
-    addSystem<T extends ISystem>(system: T): T;
-    /** 从场景移除系统 */
-    removeSystem(system: ISystem): void;
-    /** 获取系统 */
-    getSystem<T extends ISystem>(systemType: new (...args: any[]) => T): T | null;
-    /** 更新场景 */
-    update(): void;
-}
 /**
  * 组件类型定义
  *
  * 用于类型安全的组件操作
  */
 type ComponentType$1<T extends IComponent = IComponent> = new (...args: any[]) => T;
-/**
- * 原始组件类型（向后兼容）
- *
- * 用于与现有Component类的兼容
- */
-type ComponentClass<T = any> = new (...args: any[]) => T;
-/**
- * 实体查询匹配器接口
- *
- * 用于查询符合特定条件的实体
- */
-interface IMatcher {
-    /** 必须包含的组件类型 */
-    all(...componentTypes: ComponentType$1[]): IMatcher;
-    /** 至少包含其中一个组件类型 */
-    any(...componentTypes: ComponentType$1[]): IMatcher;
-    /** 不能包含的组件类型 */
-    exclude(...componentTypes: ComponentType$1[]): IMatcher;
-    /** 检查实体是否匹配 */
-    isInterestedEntity(entity: IEntity): boolean;
-}
-/**
- * 性能监控接口
- */
-interface IPerformanceData {
-    /** 执行时间（毫秒） */
-    executionTime: number;
-    /** 调用次数 */
-    callCount: number;
-    /** 平均执行时间 */
-    averageTime: number;
-    /** 最大执行时间 */
-    maxTime: number;
-    /** 最小执行时间 */
-    minTime: number;
-}
-/**
- * 生命周期管理接口
- */
-interface ILifecycle {
-    /** 初始化 */
-    initialize?(): void;
-    /** 启动 */
-    start?(): void;
-    /** 更新 */
-    update?(): void;
-    /** 延迟更新 */
-    lateUpdate?(): void;
-    /** 停止 */
-    stop?(): void;
-    /** 销毁 */
-    destroy?(): void;
-}
-/**
- * 实体管理器接口
- *
- * 提供统一的实体管理和查询机制，支持高效的实体操作
- */
-interface IEntityManager {
-    /** 所有实体数量 */
-    readonly entityCount: number;
-    /** 激活的实体数量 */
-    readonly activeEntityCount: number;
-    /** 创建实体 */
-    createEntity(name?: string): IEntity;
-    /** 销毁实体 */
-    destroyEntity(entity: IEntity | string | number): boolean;
-    /** 批量销毁实体 */
-    destroyEntities(entities: (IEntity | string | number)[]): number;
-    /** 销毁所有实体 */
-    destroyAllEntities(): number;
-    /** 根据ID获取实体 */
-    getEntity(id: string | number): IEntity | null;
-    /** 根据名称获取实体 */
-    getEntityByName(name: string): IEntity | null;
-    /** 根据名称获取所有实体 */
-    getEntitiesByName(name: string): IEntity[];
-    /** 根据标签获取实体 */
-    getEntitiesByTag(tag: number): IEntity[];
-    /** 获取所有实体 */
-    getAllEntities(): IEntity[];
-    /** 获取所有激活的实体 */
-    getActiveEntities(): IEntity[];
-    /** 获取拥有指定组件的实体 */
-    getEntitiesWithComponent<T extends IComponent>(componentType: ComponentType$1<T>): IEntity[];
-    /** 获取拥有指定组件的实体及其组件 */
-    getEntitiesWithComponentData<T extends IComponent>(componentType: ComponentType$1<T>): Array<{
-        entity: IEntity;
-        component: T;
-    }>;
-    /** 获取拥有所有指定组件的实体 */
-    getEntitiesWithComponents(...componentTypes: ComponentType$1[]): IEntity[];
-    /** 获取拥有任一指定组件的实体 */
-    getEntitiesWithAnyComponent(...componentTypes: ComponentType$1[]): IEntity[];
-    /** 获取不包含指定组件的实体 */
-    getEntitiesWithoutComponent<T extends IComponent>(componentType: ComponentType$1<T>): IEntity[];
-    /** 对所有实体执行操作 */
-    forEachEntity(action: (entity: IEntity) => void): void;
-    /** 对符合条件的实体执行操作 */
-    forEachEntityWhere(predicate: (entity: IEntity) => boolean, action: (entity: IEntity) => void): void;
-    /** 对拥有指定组件的实体执行操作 */
-    forEachEntityWithComponent<T extends IComponent>(componentType: ComponentType$1<T>, action: (entity: IEntity, component: T) => void): void;
-    /** 查找第一个符合条件的实体 */
-    findEntity(predicate: (entity: IEntity) => boolean): IEntity | null;
-    /** 查找所有符合条件的实体 */
-    findEntities(predicate: (entity: IEntity) => boolean): IEntity[];
-    /** 获取统计信息 */
-    getStatistics(): {
-        totalEntities: number;
-        activeEntities: number;
-        destroyedEntities: number;
-        entitiesByTag: Map<number, number>;
-        componentsCount: Map<string, number>;
-    };
-    /** 清理已销毁的实体 */
-    cleanup(): number;
-    /** 压缩存储空间 */
-    compact(): void;
-}
-/**
- * 实体查询构建器接口
- *
- * 提供流式API构建复杂的实体查询条件
- */
-interface IEntityQueryBuilder {
-    /** 必须包含所有指定组件 */
-    withAll(...componentTypes: ComponentType$1[]): IEntityQueryBuilder;
-    /** 必须包含任一指定组件 */
-    withAny(...componentTypes: ComponentType$1[]): IEntityQueryBuilder;
-    /** 必须不包含指定组件 */
-    without(...componentTypes: ComponentType$1[]): IEntityQueryBuilder;
-    /** 必须包含指定标签 */
-    withTag(tag: number): IEntityQueryBuilder;
-    /** 必须不包含指定标签 */
-    withoutTag(tag: number): IEntityQueryBuilder;
-    /** 必须处于激活状态 */
-    active(): IEntityQueryBuilder;
-    /** 必须处于启用状态 */
-    enabled(): IEntityQueryBuilder;
-    /** 自定义过滤条件 */
-    where(predicate: (entity: IEntity) => boolean): IEntityQueryBuilder;
-    /** 执行查询，返回所有匹配的实体 */
-    execute(): IEntity[];
-    /** 执行查询，返回第一个匹配的实体 */
-    first(): IEntity | null;
-    /** 执行查询，返回匹配实体的数量 */
-    count(): number;
-    /** 对查询结果执行操作 */
-    forEach(action: (entity: IEntity) => void): void;
-}
 /**
  * 事件总线接口
  * 提供类型安全的事件发布订阅机制
@@ -1798,8 +1301,8 @@ declare class ComponentCache {
  * // 获取组件
  * const health = entity.getComponent(HealthComponent);
  *
- * // 设置位置
- * entity.position = new Vector2(100, 200);
+ * // 添加位置组件
+ * entity.addComponent(new PositionComponent(100, 200));
  *
  * // 添加子实体
  * const weapon = new Entity("Weapon", 2);
@@ -4220,7 +3723,7 @@ declare function createECSAPI(scene: Scene, querySystem: QuerySystem, eventSyste
  * 游戏引擎核心类
  *
  * 负责管理游戏的生命周期、场景切换、全局管理器和定时器系统。
- * 提供统一的游戏循环和事件分发机制。
+ * 提供统一的游戏循环管理。
  *
  * @example
  * ```typescript
@@ -4230,6 +3733,12 @@ declare function createECSAPI(scene: Scene, querySystem: QuerySystem, eventSyste
  * // 设置场景
  * Core.scene = new MyScene();
  *
+ * // 在游戏循环中更新（Laya引擎示例）
+ * Laya.timer.frameLoop(1, this, () => {
+ *     const deltaTime = Laya.timer.delta / 1000;
+ *     Core.update(deltaTime);
+ * });
+ *
  * // 调度定时器
  * Core.schedule(1.0, false, null, (timer) => {
  *     console.log("1秒后执行");
@@ -4237,12 +3746,6 @@ declare function createECSAPI(scene: Scene, querySystem: QuerySystem, eventSyste
  * ```
  */
 declare class Core {
-    /**
-     * 核心事件发射器
-     *
-     * 用于发布和订阅核心级别的事件，如帧更新、场景切换等。
-     */
-    static emitter: Emitter<CoreEvents>;
     /**
      * 游戏暂停状态
      *
@@ -4339,10 +3842,36 @@ declare class Core {
      * 如果实例已存在，则返回现有实例。
      *
      * @param debug - 是否为调试模式，默认为true
-     * @param options - 额外的配置选项
      * @returns Core实例
      */
     static create(debug?: boolean): Core;
+    /**
+     * 更新游戏逻辑
+     *
+     * 此方法应该在游戏引擎的更新循环中调用。
+     *
+     * @param deltaTime - 外部引擎提供的帧时间间隔（秒）
+     *
+     * @example
+     * ```typescript
+     * // Laya引擎
+     * Laya.timer.frameLoop(1, this, () => {
+     *     const deltaTime = Laya.timer.delta / 1000;
+     *     Core.update(deltaTime);
+     * });
+     *
+     * // Cocos Creator
+     * update(deltaTime: number) {
+     *     Core.update(deltaTime);
+     * }
+     *
+     * // Unity (C#)
+     * void Update() {
+     *     Core.Update(Time.deltaTime);
+     * }
+     * ```
+     */
+    static update(deltaTime: number): void;
     /**
      * 注册全局管理器
      *
@@ -4397,13 +3926,185 @@ declare class Core {
      */
     protected initialize(): void;
     /**
-     * 游戏主循环更新
+     * 内部更新方法
      *
-     * 每帧调用，负责更新时间系统、全局管理器和当前场景。
-     *
-     * @param currentTime - 当前时间戳，默认为-1（使用系统时间）
+     * @param deltaTime - 帧时间间隔（秒）
+     */
+    private updateInternal;
+}
+
+/**
+ * 用于包装事件的一个小类
+ */
+declare class FuncPack {
+    /** 函数 */
+    func: Function;
+    /** 上下文 */
+    context: any;
+    constructor(func: Function, context: any);
+}
+/**
+ * 用于事件管理
+ */
+declare class Emitter<T> {
+    private _messageTable;
+    constructor();
+    /**
+     * 开始监听项
+     * @param eventType 监听类型
+     * @param handler 监听函数
+     * @param context 监听上下文
      */
-    protected update(currentTime?: number): void;
+    addObserver(eventType: T, handler: Function, context: any): void;
+    /**
+     * 移除监听项
+     * @param eventType 事件类型
+     * @param handler 事件函数
+     */
+    removeObserver(eventType: T, handler: Function): void;
+    /**
+     * 触发该事件
+     * @param eventType 事件类型
+     * @param data 事件数据
+     */
+    emit(eventType: T, ...data: any[]): void;
+    /**
+     * 判断是否存在该类型的观察者
+     * @param eventType 事件类型
+     * @param handler 事件函数
+     */
+    hasObserver(eventType: T, handler: Function): boolean;
+}
+
+/**
+ * ECS事件类型枚举
+ * 定义实体组件系统中的所有事件类型
+ */
+declare enum ECSEventType {
+    ENTITY_CREATED = "entity:created",
+    ENTITY_DESTROYED = "entity:destroyed",
+    ENTITY_ENABLED = "entity:enabled",
+    ENTITY_DISABLED = "entity:disabled",
+    ENTITY_TAG_ADDED = "entity:tag:added",
+    ENTITY_TAG_REMOVED = "entity:tag:removed",
+    ENTITY_NAME_CHANGED = "entity:name:changed",
+    COMPONENT_ADDED = "component:added",
+    COMPONENT_REMOVED = "component:removed",
+    COMPONENT_MODIFIED = "component:modified",
+    COMPONENT_ENABLED = "component:enabled",
+    COMPONENT_DISABLED = "component:disabled",
+    SYSTEM_ADDED = "system:added",
+    SYSTEM_REMOVED = "system:removed",
+    SYSTEM_ENABLED = "system:enabled",
+    SYSTEM_DISABLED = "system:disabled",
+    SYSTEM_PROCESSING_START = "system:processing:start",
+    SYSTEM_PROCESSING_END = "system:processing:end",
+    SYSTEM_ERROR = "system:error",
+    SCENE_CREATED = "scene:created",
+    SCENE_DESTROYED = "scene:destroyed",
+    SCENE_ACTIVATED = "scene:activated",
+    SCENE_DEACTIVATED = "scene:deactivated",
+    SCENE_PAUSED = "scene:paused",
+    SCENE_RESUMED = "scene:resumed",
+    QUERY_EXECUTED = "query:executed",
+    QUERY_CACHE_HIT = "query:cache:hit",
+    QUERY_CACHE_MISS = "query:cache:miss",
+    QUERY_OPTIMIZED = "query:optimized",
+    PERFORMANCE_WARNING = "performance:warning",
+    PERFORMANCE_CRITICAL = "performance:critical",
+    MEMORY_USAGE_HIGH = "memory:usage:high",
+    FRAME_RATE_DROP = "frame:rate:drop",
+    INDEX_CREATED = "index:created",
+    INDEX_UPDATED = "index:updated",
+    INDEX_OPTIMIZED = "index:optimized",
+    ARCHETYPE_CREATED = "archetype:created",
+    ARCHETYPE_ENTITY_ADDED = "archetype:entity:added",
+    ARCHETYPE_ENTITY_REMOVED = "archetype:entity:removed",
+    DIRTY_MARK_ADDED = "dirty:mark:added",
+    DIRTY_BATCH_PROCESSED = "dirty:batch:processed",
+    ERROR_OCCURRED = "error:occurred",
+    WARNING_ISSUED = "warning:issued",
+    FRAMEWORK_INITIALIZED = "framework:initialized",
+    FRAMEWORK_SHUTDOWN = "framework:shutdown",
+    DEBUG_INFO = "debug:info",
+    DEBUG_STATS_UPDATED = "debug:stats:updated"
+}
+/**
+ * 事件优先级枚举
+ * 定义事件处理的优先级级别
+ */
+declare enum EventPriority {
+    LOWEST = 0,
+    LOW = 25,
+    NORMAL = 50,
+    HIGH = 75,
+    HIGHEST = 100,
+    CRITICAL = 200
+}
+/**
+ * 预定义的事件类型常量
+ * 提供类型安全的事件类型字符串
+ */
+declare const EVENT_TYPES: {
+    readonly ENTITY: {
+        readonly CREATED: ECSEventType.ENTITY_CREATED;
+        readonly DESTROYED: ECSEventType.ENTITY_DESTROYED;
+        readonly ENABLED: ECSEventType.ENTITY_ENABLED;
+        readonly DISABLED: ECSEventType.ENTITY_DISABLED;
+        readonly TAG_ADDED: ECSEventType.ENTITY_TAG_ADDED;
+        readonly TAG_REMOVED: ECSEventType.ENTITY_TAG_REMOVED;
+        readonly NAME_CHANGED: ECSEventType.ENTITY_NAME_CHANGED;
+    };
+    readonly COMPONENT: {
+        readonly ADDED: ECSEventType.COMPONENT_ADDED;
+        readonly REMOVED: ECSEventType.COMPONENT_REMOVED;
+        readonly MODIFIED: ECSEventType.COMPONENT_MODIFIED;
+        readonly ENABLED: ECSEventType.COMPONENT_ENABLED;
+        readonly DISABLED: ECSEventType.COMPONENT_DISABLED;
+    };
+    readonly SYSTEM: {
+        readonly ADDED: ECSEventType.SYSTEM_ADDED;
+        readonly REMOVED: ECSEventType.SYSTEM_REMOVED;
+        readonly ENABLED: ECSEventType.SYSTEM_ENABLED;
+        readonly DISABLED: ECSEventType.SYSTEM_DISABLED;
+        readonly PROCESSING_START: ECSEventType.SYSTEM_PROCESSING_START;
+        readonly PROCESSING_END: ECSEventType.SYSTEM_PROCESSING_END;
+        readonly ERROR: ECSEventType.SYSTEM_ERROR;
+    };
+    readonly PERFORMANCE: {
+        readonly WARNING: ECSEventType.PERFORMANCE_WARNING;
+        readonly CRITICAL: ECSEventType.PERFORMANCE_CRITICAL;
+        readonly MEMORY_HIGH: ECSEventType.MEMORY_USAGE_HIGH;
+        readonly FRAME_DROP: ECSEventType.FRAME_RATE_DROP;
+    };
+};
+/**
+ * 事件类型验证器
+ * 验证事件类型是否有效
+ */
+declare class EventTypeValidator {
+    private static validTypes;
+    /**
+     * 验证事件类型是否有效
+     * @param eventType 事件类型
+     * @returns 是否有效
+     */
+    static isValid(eventType: string): boolean;
+    /**
+     * 获取所有有效的事件类型
+     * @returns 事件类型数组
+     */
+    static getAllValidTypes(): string[];
+    /**
+     * 添加自定义事件类型
+     * @param eventType 事件类型
+     */
+    static addCustomType(eventType: string): void;
+    /**
+     * 移除自定义事件类型
+     * @param eventType 事件类型
+     */
+    static removeCustomType(eventType: string): void;
 }
 
 /**
@@ -5343,18 +5044,10 @@ declare class Time {
      */
     static frameCount: number;
     /**
-     * 上一帧的时间戳
-     */
-    private static _lastTime;
-    /**
-     * 是否为第一次更新
-     */
-    private static _isFirstUpdate;
-    /**
-     * 更新时间信息
-     * @param currentTime 当前时间戳（毫秒）
+     * 使用外部引擎提供的deltaTime更新时间信息
+     * @param deltaTime 外部引擎提供的帧时间间隔（秒）
      */
-    static update(currentTime?: number): void;
+    static update(deltaTime: number): void;
     /**
      * 场景改变时重置时间
      */
@@ -5368,5 +5061,5 @@ declare class Time {
     static checkEvery(interval: number, lastTime: number): boolean;
 }
 
-export { ArchetypeSystem, AsyncEventHandler$1 as AsyncEventHandler, BitMaskOptimizer, BitmapComponentIndex, Bits, Component, ComponentIndexManager, ComponentPool, ComponentStorage, ComponentTransform, ComponentTypeManager, Core, CoreEvents, DirtyFlag, DirtyTrackingSystem, ECSEventType, ECSFluentAPI, EVENT_TYPES, Emitter, Entity, EntityList, EntityManager, EntityProcessorList, EntityQueryBuilder, EntitySystem, EventBus, EventHandler$1 as EventHandler, EventPriority, EventTypeValidator, FuncPack, GlobalEventBus, GlobalManager, HashComponentIndex, IdentifierPool, IndexType, IndexUpdateBatcher, IntervalSystem, LogType, Matcher, NumberExtension, PassiveSystem, PerformanceMonitor, PerformanceWarningType, Pool, PoolManager, ProcessingSystem, QuerySystem, Scene, TieredObjectPool, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, createECSAPI };
-export type { Archetype, ArchetypeQueryResult, ComponentClass, ComponentType$1 as ComponentType, DirtyData, DirtyListener, EventListenerConfig, EventStats, IComponent, IComponentEventData, IEntity, IEntityBase, IEntityEventData, IEntityManager, IEntityQueryBuilder, IEventBus, IEventData, IEventListenerConfig, IEventStats, ILifecycle, IMatcher, IPerformanceData, IPerformanceEventData, IPoolable, IScene, ISceneEventData, ISystem, ISystemBase, ISystemEventData, ITimer, IUpdateOrderComparable, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PoolStats };
+export { ArchetypeSystem, AsyncEventHandler$1 as AsyncEventHandler, BitMaskOptimizer, BitmapComponentIndex, Bits, Component, ComponentIndexManager, ComponentPool, ComponentStorage, ComponentTypeManager, Core, DirtyFlag, DirtyTrackingSystem, ECSEventType, ECSFluentAPI, EVENT_TYPES, Emitter, Entity, EntityList, EntityManager, EntityProcessorList, EntityQueryBuilder, EntitySystem, EventBus, EventHandler$1 as EventHandler, EventPriority, EventTypeValidator, FuncPack, GlobalEventBus, GlobalManager, HashComponentIndex, IdentifierPool, IndexType, IndexUpdateBatcher, IntervalSystem, Matcher, NumberExtension, PassiveSystem, PerformanceMonitor, PerformanceWarningType, Pool, PoolManager, ProcessingSystem, QuerySystem, Scene, TieredObjectPool, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, createECSAPI };
+export type { Archetype, ArchetypeQueryResult, ComponentType$1 as ComponentType, DirtyData, DirtyListener, EventListenerConfig, EventStats, IComponent, IComponentEventData, IEntityEventData, IEventBus, IEventData, IEventListenerConfig, IEventStats, IPerformanceEventData, IPoolable, ISceneEventData, ISystemBase, ISystemEventData, ITimer, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PoolStats };