@esengine/ecs-framework 2.2.20 → 2.2.21

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.2.20
+ * @esengine/ecs-framework v2.2.21
  * TypeScript definitions
  */
 /**
@@ -1323,6 +1323,13 @@ declare class ComponentRegistry {
     private static componentNameToId;
     private static maskCache;
     private static nextBitIndex;
+    /**
+     * 热更新模式标志，默认禁用
+     * Hot reload mode flag, disabled by default
+     * 编辑器环境应启用此选项以支持脚本热更新
+     * Editor environment should enable this to support script hot reload
+     */
+    private static hotReloadEnabled;
     /**
      * 注册组件类型并分配位掩码
      * @param componentType 组件类型
@@ -1402,6 +1409,23 @@ declare class ComponentRegistry {
      * 清除掩码缓存
      */
     static clearMaskCache(): void;
+    /**
+     * 启用热更新模式
+     * Enable hot reload mode
+     * 在编辑器环境中调用以支持脚本热更新
+     * Call in editor environment to support script hot reload
+     */
+    static enableHotReload(): void;
+    /**
+     * 禁用热更新模式
+     * Disable hot reload mode
+     */
+    static disableHotReload(): void;
+    /**
+     * 检查热更新模式是否启用
+     * Check if hot reload mode is enabled
+     */
+    static isHotReloadEnabled(): boolean;
     /**
      * 重置注册表（用于测试）
      */
@@ -4368,12 +4392,17 @@ declare class ComponentSerializer {
  */
 declare class HierarchySystem extends EntitySystem {
     private static readonly MAX_DEPTH;
+    /**
+     * 脏实体集合 - 只有这些实体需要在 process() 中更新缓存
+     * Dirty entity set - only these entities need cache update in process()
+     */
+    private dirtyEntities;
     constructor();
     /**
      * 系统优先级，确保在其他系统之前更新层级缓存
      */
     get updateOrder(): number;
-    protected process(): void;
+    protected process(_entities: readonly Entity[]): void;
     /**
      * 设置实体的父级
      *
@@ -4474,17 +4503,24 @@ declare class HierarchySystem extends EntitySystem {
         bIsExpanded: boolean;
     }>;
     /**
-     * 标记缓存为脏
+     * 标记缓存为脏，并添加到脏实体集合
+     * Mark cache as dirty and add to dirty entity set
      */
     private markCacheDirty;
     /**
      * 更新层级缓存
      */
     private updateHierarchyCache;
+    /**
+     * 当实体被添加到系统时，将其加入脏集合
+     * When entity is added to system, add it to dirty set
+     */
+    protected onAdded(entity: Entity): void;
     /**
      * 当实体被移除时清理层级关系
+     * When entity is removed, clean up hierarchy relationships
      */
-    protected onEntityRemoved(entity: Entity): void;
+    protected onRemoved(entity: Entity): void;
     dispose(): void;
 }
 
@@ -5137,6 +5173,28 @@ declare class Scene implements IScene {
      * 场景是否已开始运行
      */
     private _didSceneBegin;
+    /**
+     * 编辑器模式标志
+     *
+     * 当为 true 时，组件的生命周期回调（如 onAddedToEntity）会被延迟，
+     * 直到调用 begin() 开始运行场景时才会触发。
+     *
+     * Editor mode flag.
+     * When true, component lifecycle callbacks (like onAddedToEntity) are deferred
+     * until begin() is called to start running the scene.
+     */
+    isEditorMode: boolean;
+    /**
+     * 延迟的组件生命周期回调队列
+     *
+     * 在编辑器模式下，组件的 onAddedToEntity 回调会被加入此队列，
+     * 等到 begin() 调用时统一执行。
+     *
+     * Deferred component lifecycle callback queue.
+     * In editor mode, component's onAddedToEntity callbacks are queued here,
+     * and will be executed when begin() is called.
+     */
+    private _deferredComponentCallbacks;
     /**
      * 系统列表缓存
      */
@@ -5275,10 +5333,25 @@ declare class Scene implements IScene {
      * 在场景被销毁时调用，可以在此方法中执行清理工作。
      */
     unload(): void;
+    /**
+     * 添加延迟的组件生命周期回调
+     *
+     * 在编辑器模式下，组件的 onAddedToEntity 回调会通过此方法加入队列。
+     *
+     * Queue a deferred component lifecycle callback.
+     * In editor mode, component's onAddedToEntity callbacks are queued via this method.
+     *
+     * @param callback 要延迟执行的回调 | The callback to defer
+     */
+    queueDeferredComponentCallback(callback: () => void): void;
     /**
      * 开始场景，启动实体处理器等
      *
      * 这个方法会启动场景。它将启动实体处理器等，并调用onStart方法。
+     * 在编辑器模式下，此方法还会执行所有延迟的组件生命周期回调。
+     *
+     * This method starts the scene. It will start entity processors and call onStart.
+     * In editor mode, this method also executes all deferred component lifecycle callbacks.
      */
     begin(): void;
     /**
@@ -6374,6 +6447,17 @@ interface IScene {
      * 场景级别的依赖注入容器，用于管理服务的生命周期。
      */
     readonly services: ServiceContainer;
+    /**
+     * 编辑器模式标志
+     *
+     * 当为 true 时，组件的生命周期回调（如 onAddedToEntity）会被延迟，
+     * 直到调用 begin() 开始运行场景时才会触发。
+     *
+     * Editor mode flag.
+     * When true, component lifecycle callbacks (like onAddedToEntity) are deferred
+     * until begin() is called to start running the scene.
+     */
+    isEditorMode: boolean;
     /**
      * 获取系统列表
      */
@@ -6390,6 +6474,14 @@ interface IScene {
      * 场景卸载时的回调
      */
     unload(): void;
+    /**
+     * 添加延迟的组件生命周期回调
+     *
+     * Queue a deferred component lifecycle callback.
+     *
+     * @param callback 要延迟执行的回调 | The callback to defer
+     */
+    queueDeferredComponentCallback(callback: () => void): void;
     /**
      * 开始场景
      */
@@ -12946,6 +13038,22 @@ declare class PlatformDetector {
      * 检测是否为浏览器环境
      */
     private static isBrowser;
+    /**
+     * 检测是否在 Tauri 桌面环境中运行
+     * Check if running in Tauri desktop environment
+     *
+     * 同时支持 Tauri v1 (__TAURI__) 和 v2 (__TAURI_INTERNALS__)
+     * Supports both Tauri v1 (__TAURI__) and v2 (__TAURI_INTERNALS__)
+     */
+    static isTauriEnvironment(): boolean;
+    /**
+     * 检测是否在编辑器环境中运行
+     * Check if running in editor environment
+     *
+     * 包括 Tauri 桌面应用或带 __ESENGINE_EDITOR__ 标记的环境
+     * Includes Tauri desktop app or environments marked with __ESENGINE_EDITOR__
+     */
+    static isEditorEnvironment(): boolean;
     /**
      * 获取详细的环境信息（用于调试）
      */