@esengine/ecs-framework 2.2.18 → 2.2.19

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.2.18
+ * @esengine/ecs-framework v2.2.19
  * TypeScript definitions
  */
 /**
@@ -5159,6 +5159,13 @@ declare class Scene implements IScene {
      * 系统错误次数超过此阈值后将被自动禁用
      */
     private _maxErrorCount;
+    /**
+     * 系统添加计数器
+     *
+     * 用于为每个添加的系统分配唯一的添加顺序，保证排序稳定性
+     * Counter for assigning unique add order to each system for stable sorting
+     */
+    private _systemAddCounter;
     /**
      * 获取场景中所有已注册的EntitySystem
      *
@@ -5178,7 +5185,8 @@ declare class Scene implements IScene {
      */
     private _filterEntitySystems;
     /**
-     * 按updateOrder排序系统
+     * 按 updateOrder 排序系统，相同时按 addOrder 保证稳定性
+     * Sort systems by updateOrder, use addOrder as secondary key for stability
      */
     private _sortSystemsByUpdateOrder;
     /**
@@ -5740,6 +5748,12 @@ declare class Scene implements IScene {
  */
 declare abstract class EntitySystem implements ISystemBase, IService {
     private _updateOrder;
+    /**
+     * 添加顺序，用于 updateOrder 相同时的稳定排序
+     * Add order for stable sorting when updateOrder is the same
+     * @internal
+     */
+    private _addOrder;
     private _enabled;
     private _performanceMonitor;
     private _systemName;
@@ -5767,6 +5781,18 @@ declare abstract class EntitySystem implements ISystemBase, IService {
      */
     get updateOrder(): number;
     set updateOrder(value: number);
+    /**
+     * 获取系统的添加顺序
+     * Get the add order of the system
+     * @internal
+     */
+    get addOrder(): number;
+    /**
+     * 设置系统的添加顺序（由 Scene 在添加时设置）
+     * Set the add order of the system (set by Scene when adding)
+     * @internal
+     */
+    set addOrder(value: number);
     /**
      * 获取系统的启用状态
      */