@esengine/ecs-framework 2.1.37 → 2.1.43

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @esengine/ecs-framework v2.1.37
+ * @esengine/ecs-framework v2.1.43
  * TypeScript definitions
  */
 /**
@@ -3978,7 +3978,6 @@ declare abstract class EntitySystem implements ISystemBase {
     private _initialized;
     private _matcher;
     private _trackedEntities;
-    private _lastQueryResult;
     /**
      * 获取系统处理的实体列表（动态查询）
      */
@@ -4075,7 +4074,7 @@ declare abstract class EntitySystem implements ISystemBase {
      *
      * @param entities 要处理的实体列表
      */
-    protected process(entities: Entity[]): void;
+    protected process(_entities: Entity[]): void;
     /**
      * 后期处理实体列表
      *
@@ -4083,7 +4082,7 @@ declare abstract class EntitySystem implements ISystemBase {
      *
      * @param entities 要处理的实体列表
      */
-    protected lateProcess(entities: Entity[]): void;
+    protected lateProcess(_entities: Entity[]): void;
     /**
      * 系统处理完毕后调用
      *
@@ -5361,6 +5360,24 @@ declare class Emitter<T, TContext = unknown> {
      * @param handler 事件函数
      */
     hasObserver(eventType: T, handler: Function): boolean;
+    /**
+     * 移除指定事件类型的所有监听器
+     * @param eventType 事件类型
+     */
+    removeAllObservers(eventType?: T): void;
+    /**
+     * 释放所有资源，清理所有监听器
+     */
+    dispose(): void;
+    /**
+     * 获取事件类型数量
+     */
+    getEventTypeCount(): number;
+    /**
+     * 获取指定事件类型的监听器数量
+     * @param eventType 事件类型
+     */
+    getObserverCount(eventType: T): number;
 }
 
 /**
@@ -5767,6 +5784,74 @@ declare class ComponentTypeManager {
     get registeredTypeCount(): number;
 }
 
+/**
+ * 存储组件类型名称的Symbol键
+ */
+declare const COMPONENT_TYPE_NAME: unique symbol;
+/**
+ * 存储系统类型名称的Symbol键
+ */
+declare const SYSTEM_TYPE_NAME: unique symbol;
+/**
+ * 组件类型装饰器
+ * 用于为组件类指定固定的类型名称，避免在代码混淆后失效
+ *
+ * @param typeName 组件类型名称
+ * @example
+ * ```typescript
+ * @ECSComponent('Position')
+ * class PositionComponent extends Component {
+ *     x: number = 0;
+ *     y: number = 0;
+ * }
+ * ```
+ */
+declare function ECSComponent(typeName: string): <T extends new (...args: any[]) => Component>(target: T) => T;
+/**
+ * 系统类型装饰器
+ * 用于为系统类指定固定的类型名称，避免在代码混淆后失效
+ *
+ * @param typeName 系统类型名称
+ * @example
+ * ```typescript
+ * @ECSSystem('Movement')
+ * class MovementSystem extends EntitySystem {
+ *     protected process(entities: Entity[]): void {
+ *         // 系统逻辑
+ *     }
+ * }
+ * ```
+ */
+declare function ECSSystem(typeName: string): <T extends new (...args: any[]) => EntitySystem>(target: T) => T;
+/**
+ * 获取组件类型的名称，优先使用装饰器指定的名称
+ *
+ * @param componentType 组件构造函数
+ * @returns 组件类型名称
+ */
+declare function getComponentTypeName<T extends Component>(componentType: new (...args: any[]) => T): string;
+/**
+ * 获取系统类型的名称，优先使用装饰器指定的名称
+ *
+ * @param systemType 系统构造函数
+ * @returns 系统类型名称
+ */
+declare function getSystemTypeName<T extends EntitySystem>(systemType: new (...args: any[]) => T): string;
+/**
+ * 从组件实例获取类型名称
+ *
+ * @param component 组件实例
+ * @returns 组件类型名称
+ */
+declare function getComponentInstanceTypeName(component: Component): string;
+/**
+ * 从系统实例获取类型名称
+ *
+ * @param system 系统实例
+ * @returns 系统类型名称
+ */
+declare function getSystemInstanceTypeName(system: EntitySystem): string;
+
 /**
  * 实体查询构建器
  *
@@ -6497,5 +6582,5 @@ declare class Time {
     static checkEvery(interval: number, lastTime: number): boolean;
 }
 
-export { ArchetypeSystem, AsyncEventHandler, BigIntFactory, BitmapComponentIndex, Bits, Component, ComponentDataCollector, ComponentIndexManager, ComponentPool, ComponentPoolManager, ComponentRegistry, ComponentStorage, ComponentTypeManager, ConsoleLogger, Core, DebugManager, DirtyFlag, DirtyTrackingSystem, ECSEventType, ECSFluentAPI, EVENT_TYPES, Emitter, EnableSoA, Entity, EntityDataCollector, EntityList, EntityManager, EntityProcessorList, EntityQueryBuilder, EntitySystem, EventBus, EventHandler, EventPriority, EventTypeValidator, Float32, Float64, FuncPack, GlobalEventBus, GlobalManager, HashComponentIndex, HighPrecision, IdentifierPool, IndexType, Int32, IntervalSystem, LogLevel, Logger, LoggerManager, Matcher, NumberExtension, PassiveSystem, PerformanceDataCollector, PerformanceMonitor, PerformanceWarningType, Pool, PoolManager, ProcessingSystem, QuerySystem, Scene, SceneDataCollector, SerializeMap, SoAStorage, SystemDataCollector, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, WebSocketManager, createECSAPI, createLogger, setGlobalLogLevel };
+export { ArchetypeSystem, AsyncEventHandler, BigIntFactory, BitmapComponentIndex, Bits, COMPONENT_TYPE_NAME, Component, ComponentDataCollector, ComponentIndexManager, ComponentPool, ComponentPoolManager, ComponentRegistry, ComponentStorage, ComponentTypeManager, ConsoleLogger, Core, DebugManager, DirtyFlag, DirtyTrackingSystem, ECSComponent, ECSEventType, ECSFluentAPI, ECSSystem, EVENT_TYPES, Emitter, EnableSoA, Entity, EntityDataCollector, EntityList, EntityManager, EntityProcessorList, EntityQueryBuilder, EntitySystem, EventBus, EventHandler, EventPriority, EventTypeValidator, Float32, Float64, FuncPack, GlobalEventBus, GlobalManager, HashComponentIndex, HighPrecision, IdentifierPool, IndexType, Int32, IntervalSystem, LogLevel, Logger, LoggerManager, Matcher, NumberExtension, PassiveSystem, PerformanceDataCollector, PerformanceMonitor, PerformanceWarningType, Pool, PoolManager, ProcessingSystem, QuerySystem, SYSTEM_TYPE_NAME, Scene, SceneDataCollector, SerializeMap, SoAStorage, SystemDataCollector, Time, Timer, TimerManager, TypeSafeEventSystem, TypeUtils, WebSocketManager, createECSAPI, createLogger, getComponentInstanceTypeName, getComponentTypeName, getSystemInstanceTypeName, getSystemTypeName, setGlobalLogLevel };
 export type { Archetype, ArchetypeQueryResult, ComponentType$1 as ComponentType, DirtyData, DirtyListener, EventListenerConfig, EventStats, IComponent, IComponentDebugData, IComponentEventData, ICoreConfig, IECSDebugConfig, IECSDebugData, IEntityDebugData, IEntityEventData, IEntityHierarchyNode, IEventBus, IEventData, IEventListenerConfig, IEventStats, ILogger, IPerformanceDebugData, IPerformanceEventData, IPoolable, IScene, ISceneConfig, ISceneDebugData, ISceneEventData, ISceneFactory, ISystemBase, ISystemDebugData, ISystemEventData, ITimer, LoggerConfig, PerformanceData, PerformanceStats, PerformanceThresholds, PerformanceWarning, PoolStats };