@esengine/ecs-framework 2.1.30 → 2.1.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (288) hide show
  1. package/index.cjs +2 -0
  2. package/index.cjs.map +1 -0
  3. package/index.d.ts +6357 -0
  4. package/index.mjs +2 -0
  5. package/index.mjs.map +1 -0
  6. package/index.umd.js +2 -0
  7. package/index.umd.js.map +1 -0
  8. package/package.json +27 -50
  9. package/bin/Core.d.ts +0 -279
  10. package/bin/Core.d.ts.map +0 -1
  11. package/bin/Core.js +0 -400
  12. package/bin/Core.js.map +0 -1
  13. package/bin/ECS/Component.d.ts +0 -120
  14. package/bin/ECS/Component.d.ts.map +0 -1
  15. package/bin/ECS/Component.js +0 -129
  16. package/bin/ECS/Component.js.map +0 -1
  17. package/bin/ECS/Components/IUpdatable.d.ts +0 -22
  18. package/bin/ECS/Components/IUpdatable.d.ts.map +0 -1
  19. package/bin/ECS/Components/IUpdatable.js +0 -17
  20. package/bin/ECS/Components/IUpdatable.js.map +0 -1
  21. package/bin/ECS/Components/SceneComponent.d.ts +0 -40
  22. package/bin/ECS/Components/SceneComponent.d.ts.map +0 -1
  23. package/bin/ECS/Components/SceneComponent.js +0 -57
  24. package/bin/ECS/Components/SceneComponent.js.map +0 -1
  25. package/bin/ECS/Core/ArchetypeSystem.d.ts +0 -100
  26. package/bin/ECS/Core/ArchetypeSystem.d.ts.map +0 -1
  27. package/bin/ECS/Core/ArchetypeSystem.js +0 -193
  28. package/bin/ECS/Core/ArchetypeSystem.js.map +0 -1
  29. package/bin/ECS/Core/ComponentIndex.d.ts +0 -151
  30. package/bin/ECS/Core/ComponentIndex.d.ts.map +0 -1
  31. package/bin/ECS/Core/ComponentIndex.js +0 -405
  32. package/bin/ECS/Core/ComponentIndex.js.map +0 -1
  33. package/bin/ECS/Core/ComponentPool.d.ts +0 -88
  34. package/bin/ECS/Core/ComponentPool.d.ts.map +0 -1
  35. package/bin/ECS/Core/ComponentPool.js +0 -159
  36. package/bin/ECS/Core/ComponentPool.js.map +0 -1
  37. package/bin/ECS/Core/ComponentStorage/ComponentRegistry.d.ts +0 -92
  38. package/bin/ECS/Core/ComponentStorage/ComponentRegistry.d.ts.map +0 -1
  39. package/bin/ECS/Core/ComponentStorage/ComponentRegistry.js +0 -167
  40. package/bin/ECS/Core/ComponentStorage/ComponentRegistry.js.map +0 -1
  41. package/bin/ECS/Core/ComponentStorage.d.ts +0 -233
  42. package/bin/ECS/Core/ComponentStorage.d.ts.map +0 -1
  43. package/bin/ECS/Core/ComponentStorage.js +0 -463
  44. package/bin/ECS/Core/ComponentStorage.js.map +0 -1
  45. package/bin/ECS/Core/DirtyTrackingSystem.d.ts +0 -197
  46. package/bin/ECS/Core/DirtyTrackingSystem.d.ts.map +0 -1
  47. package/bin/ECS/Core/DirtyTrackingSystem.js +0 -297
  48. package/bin/ECS/Core/DirtyTrackingSystem.js.map +0 -1
  49. package/bin/ECS/Core/EntityManager.d.ts +0 -379
  50. package/bin/ECS/Core/EntityManager.d.ts.map +0 -1
  51. package/bin/ECS/Core/EntityManager.js +0 -686
  52. package/bin/ECS/Core/EntityManager.js.map +0 -1
  53. package/bin/ECS/Core/EventBus.d.ts +0 -218
  54. package/bin/ECS/Core/EventBus.d.ts.map +0 -1
  55. package/bin/ECS/Core/EventBus.js +0 -402
  56. package/bin/ECS/Core/EventBus.js.map +0 -1
  57. package/bin/ECS/Core/EventSystem.d.ts +0 -237
  58. package/bin/ECS/Core/EventSystem.d.ts.map +0 -1
  59. package/bin/ECS/Core/EventSystem.js +0 -478
  60. package/bin/ECS/Core/EventSystem.js.map +0 -1
  61. package/bin/ECS/Core/Events/index.d.ts +0 -3
  62. package/bin/ECS/Core/Events/index.d.ts.map +0 -1
  63. package/bin/ECS/Core/Events/index.js +0 -3
  64. package/bin/ECS/Core/Events/index.js.map +0 -1
  65. package/bin/ECS/Core/FluentAPI/ComponentBuilder.d.ts +0 -35
  66. package/bin/ECS/Core/FluentAPI/ComponentBuilder.d.ts.map +0 -1
  67. package/bin/ECS/Core/FluentAPI/ComponentBuilder.js +0 -48
  68. package/bin/ECS/Core/FluentAPI/ComponentBuilder.js.map +0 -1
  69. package/bin/ECS/Core/FluentAPI/ECSFluentAPI.d.ts +0 -135
  70. package/bin/ECS/Core/FluentAPI/ECSFluentAPI.d.ts.map +0 -1
  71. package/bin/ECS/Core/FluentAPI/ECSFluentAPI.js +0 -166
  72. package/bin/ECS/Core/FluentAPI/ECSFluentAPI.js.map +0 -1
  73. package/bin/ECS/Core/FluentAPI/EntityBatchOperator.d.ts +0 -58
  74. package/bin/ECS/Core/FluentAPI/EntityBatchOperator.d.ts.map +0 -1
  75. package/bin/ECS/Core/FluentAPI/EntityBatchOperator.js +0 -85
  76. package/bin/ECS/Core/FluentAPI/EntityBatchOperator.js.map +0 -1
  77. package/bin/ECS/Core/FluentAPI/EntityBuilder.d.ts +0 -110
  78. package/bin/ECS/Core/FluentAPI/EntityBuilder.d.ts.map +0 -1
  79. package/bin/ECS/Core/FluentAPI/EntityBuilder.js +0 -174
  80. package/bin/ECS/Core/FluentAPI/EntityBuilder.js.map +0 -1
  81. package/bin/ECS/Core/FluentAPI/SceneBuilder.d.ts +0 -53
  82. package/bin/ECS/Core/FluentAPI/SceneBuilder.d.ts.map +0 -1
  83. package/bin/ECS/Core/FluentAPI/SceneBuilder.js +0 -79
  84. package/bin/ECS/Core/FluentAPI/SceneBuilder.js.map +0 -1
  85. package/bin/ECS/Core/FluentAPI/index.d.ts +0 -6
  86. package/bin/ECS/Core/FluentAPI/index.d.ts.map +0 -1
  87. package/bin/ECS/Core/FluentAPI/index.js +0 -6
  88. package/bin/ECS/Core/FluentAPI/index.js.map +0 -1
  89. package/bin/ECS/Core/FluentAPI.d.ts +0 -2
  90. package/bin/ECS/Core/FluentAPI.d.ts.map +0 -1
  91. package/bin/ECS/Core/FluentAPI.js +0 -3
  92. package/bin/ECS/Core/FluentAPI.js.map +0 -1
  93. package/bin/ECS/Core/Performance/index.d.ts +0 -4
  94. package/bin/ECS/Core/Performance/index.d.ts.map +0 -1
  95. package/bin/ECS/Core/Performance/index.js +0 -4
  96. package/bin/ECS/Core/Performance/index.js.map +0 -1
  97. package/bin/ECS/Core/Query/index.d.ts +0 -4
  98. package/bin/ECS/Core/Query/index.d.ts.map +0 -1
  99. package/bin/ECS/Core/Query/index.js +0 -4
  100. package/bin/ECS/Core/Query/index.js.map +0 -1
  101. package/bin/ECS/Core/QuerySystem.d.ts +0 -438
  102. package/bin/ECS/Core/QuerySystem.d.ts.map +0 -1
  103. package/bin/ECS/Core/QuerySystem.js +0 -974
  104. package/bin/ECS/Core/QuerySystem.js.map +0 -1
  105. package/bin/ECS/Core/SoAStorage.d.ts +0 -97
  106. package/bin/ECS/Core/SoAStorage.d.ts.map +0 -1
  107. package/bin/ECS/Core/SoAStorage.js +0 -548
  108. package/bin/ECS/Core/SoAStorage.js.map +0 -1
  109. package/bin/ECS/Core/Storage/index.d.ts +0 -4
  110. package/bin/ECS/Core/Storage/index.d.ts.map +0 -1
  111. package/bin/ECS/Core/Storage/index.js +0 -4
  112. package/bin/ECS/Core/Storage/index.js.map +0 -1
  113. package/bin/ECS/CoreEvents.d.ts +0 -131
  114. package/bin/ECS/CoreEvents.d.ts.map +0 -1
  115. package/bin/ECS/CoreEvents.js +0 -163
  116. package/bin/ECS/CoreEvents.js.map +0 -1
  117. package/bin/ECS/Entity.d.ts +0 -455
  118. package/bin/ECS/Entity.d.ts.map +0 -1
  119. package/bin/ECS/Entity.js +0 -837
  120. package/bin/ECS/Entity.js.map +0 -1
  121. package/bin/ECS/Scene.d.ts +0 -225
  122. package/bin/ECS/Scene.d.ts.map +0 -1
  123. package/bin/ECS/Scene.js +0 -325
  124. package/bin/ECS/Scene.js.map +0 -1
  125. package/bin/ECS/Systems/EntitySystem.d.ts +0 -200
  126. package/bin/ECS/Systems/EntitySystem.d.ts.map +0 -1
  127. package/bin/ECS/Systems/EntitySystem.js +0 -431
  128. package/bin/ECS/Systems/EntitySystem.js.map +0 -1
  129. package/bin/ECS/Systems/IntervalSystem.d.ts +0 -33
  130. package/bin/ECS/Systems/IntervalSystem.d.ts.map +0 -1
  131. package/bin/ECS/Systems/IntervalSystem.js +0 -50
  132. package/bin/ECS/Systems/IntervalSystem.js.map +0 -1
  133. package/bin/ECS/Systems/PassiveSystem.d.ts +0 -17
  134. package/bin/ECS/Systems/PassiveSystem.d.ts.map +0 -1
  135. package/bin/ECS/Systems/PassiveSystem.js +0 -19
  136. package/bin/ECS/Systems/PassiveSystem.js.map +0 -1
  137. package/bin/ECS/Systems/ProcessingSystem.d.ts +0 -21
  138. package/bin/ECS/Systems/ProcessingSystem.d.ts.map +0 -1
  139. package/bin/ECS/Systems/ProcessingSystem.js +0 -20
  140. package/bin/ECS/Systems/ProcessingSystem.js.map +0 -1
  141. package/bin/ECS/Systems/index.d.ts +0 -5
  142. package/bin/ECS/Systems/index.d.ts.map +0 -1
  143. package/bin/ECS/Systems/index.js +0 -6
  144. package/bin/ECS/Systems/index.js.map +0 -1
  145. package/bin/ECS/Utils/BigIntCompatibility.d.ts +0 -164
  146. package/bin/ECS/Utils/BigIntCompatibility.d.ts.map +0 -1
  147. package/bin/ECS/Utils/BigIntCompatibility.js +0 -578
  148. package/bin/ECS/Utils/BigIntCompatibility.js.map +0 -1
  149. package/bin/ECS/Utils/Bits.d.ts +0 -163
  150. package/bin/ECS/Utils/Bits.d.ts.map +0 -1
  151. package/bin/ECS/Utils/Bits.js +0 -286
  152. package/bin/ECS/Utils/Bits.js.map +0 -1
  153. package/bin/ECS/Utils/ComponentTypeManager.d.ts +0 -50
  154. package/bin/ECS/Utils/ComponentTypeManager.d.ts.map +0 -1
  155. package/bin/ECS/Utils/ComponentTypeManager.js +0 -84
  156. package/bin/ECS/Utils/ComponentTypeManager.js.map +0 -1
  157. package/bin/ECS/Utils/EntityList.d.ts +0 -108
  158. package/bin/ECS/Utils/EntityList.d.ts.map +0 -1
  159. package/bin/ECS/Utils/EntityList.js +0 -262
  160. package/bin/ECS/Utils/EntityList.js.map +0 -1
  161. package/bin/ECS/Utils/EntityProcessorList.d.ts +0 -56
  162. package/bin/ECS/Utils/EntityProcessorList.d.ts.map +0 -1
  163. package/bin/ECS/Utils/EntityProcessorList.js +0 -102
  164. package/bin/ECS/Utils/EntityProcessorList.js.map +0 -1
  165. package/bin/ECS/Utils/IdentifierPool.d.ts +0 -203
  166. package/bin/ECS/Utils/IdentifierPool.d.ts.map +0 -1
  167. package/bin/ECS/Utils/IdentifierPool.js +0 -325
  168. package/bin/ECS/Utils/IdentifierPool.js.map +0 -1
  169. package/bin/ECS/Utils/Matcher.d.ts +0 -143
  170. package/bin/ECS/Utils/Matcher.d.ts.map +0 -1
  171. package/bin/ECS/Utils/Matcher.js +0 -249
  172. package/bin/ECS/Utils/Matcher.js.map +0 -1
  173. package/bin/ECS/Utils/index.d.ts +0 -8
  174. package/bin/ECS/Utils/index.d.ts.map +0 -1
  175. package/bin/ECS/Utils/index.js +0 -9
  176. package/bin/ECS/Utils/index.js.map +0 -1
  177. package/bin/ECS/index.d.ts +0 -12
  178. package/bin/ECS/index.d.ts.map +0 -1
  179. package/bin/ECS/index.js +0 -12
  180. package/bin/ECS/index.js.map +0 -1
  181. package/bin/Types/index.d.ts +0 -471
  182. package/bin/Types/index.d.ts.map +0 -1
  183. package/bin/Types/index.js +0 -5
  184. package/bin/Types/index.js.map +0 -1
  185. package/bin/Utils/Debug/ComponentDataCollector.d.ts +0 -28
  186. package/bin/Utils/Debug/ComponentDataCollector.d.ts.map +0 -1
  187. package/bin/Utils/Debug/ComponentDataCollector.js +0 -248
  188. package/bin/Utils/Debug/ComponentDataCollector.js.map +0 -1
  189. package/bin/Utils/Debug/DebugDataFormatter.d.ts +0 -22
  190. package/bin/Utils/Debug/DebugDataFormatter.d.ts.map +0 -1
  191. package/bin/Utils/Debug/DebugDataFormatter.js +0 -117
  192. package/bin/Utils/Debug/DebugDataFormatter.js.map +0 -1
  193. package/bin/Utils/Debug/DebugManager.d.ts +0 -104
  194. package/bin/Utils/Debug/DebugManager.d.ts.map +0 -1
  195. package/bin/Utils/Debug/DebugManager.js +0 -647
  196. package/bin/Utils/Debug/DebugManager.js.map +0 -1
  197. package/bin/Utils/Debug/EntityDataCollector.d.ts +0 -92
  198. package/bin/Utils/Debug/EntityDataCollector.d.ts.map +0 -1
  199. package/bin/Utils/Debug/EntityDataCollector.js +0 -864
  200. package/bin/Utils/Debug/EntityDataCollector.js.map +0 -1
  201. package/bin/Utils/Debug/PerformanceDataCollector.d.ts +0 -32
  202. package/bin/Utils/Debug/PerformanceDataCollector.d.ts.map +0 -1
  203. package/bin/Utils/Debug/PerformanceDataCollector.js +0 -217
  204. package/bin/Utils/Debug/PerformanceDataCollector.js.map +0 -1
  205. package/bin/Utils/Debug/SceneDataCollector.d.ts +0 -16
  206. package/bin/Utils/Debug/SceneDataCollector.d.ts.map +0 -1
  207. package/bin/Utils/Debug/SceneDataCollector.js +0 -46
  208. package/bin/Utils/Debug/SceneDataCollector.js.map +0 -1
  209. package/bin/Utils/Debug/SystemDataCollector.d.ts +0 -11
  210. package/bin/Utils/Debug/SystemDataCollector.d.ts.map +0 -1
  211. package/bin/Utils/Debug/SystemDataCollector.js +0 -59
  212. package/bin/Utils/Debug/SystemDataCollector.js.map +0 -1
  213. package/bin/Utils/Debug/WebSocketManager.d.ts +0 -59
  214. package/bin/Utils/Debug/WebSocketManager.d.ts.map +0 -1
  215. package/bin/Utils/Debug/WebSocketManager.js +0 -148
  216. package/bin/Utils/Debug/WebSocketManager.js.map +0 -1
  217. package/bin/Utils/Debug/index.d.ts +0 -8
  218. package/bin/Utils/Debug/index.d.ts.map +0 -1
  219. package/bin/Utils/Debug/index.js +0 -8
  220. package/bin/Utils/Debug/index.js.map +0 -1
  221. package/bin/Utils/Emitter.d.ts +0 -43
  222. package/bin/Utils/Emitter.d.ts.map +0 -1
  223. package/bin/Utils/Emitter.js +0 -69
  224. package/bin/Utils/Emitter.js.map +0 -1
  225. package/bin/Utils/Extensions/NumberExtension.d.ts +0 -13
  226. package/bin/Utils/Extensions/NumberExtension.d.ts.map +0 -1
  227. package/bin/Utils/Extensions/NumberExtension.js +0 -17
  228. package/bin/Utils/Extensions/NumberExtension.js.map +0 -1
  229. package/bin/Utils/Extensions/TypeUtils.d.ts +0 -13
  230. package/bin/Utils/Extensions/TypeUtils.d.ts.map +0 -1
  231. package/bin/Utils/Extensions/TypeUtils.js +0 -15
  232. package/bin/Utils/Extensions/TypeUtils.js.map +0 -1
  233. package/bin/Utils/Extensions/index.d.ts +0 -3
  234. package/bin/Utils/Extensions/index.d.ts.map +0 -1
  235. package/bin/Utils/Extensions/index.js +0 -4
  236. package/bin/Utils/Extensions/index.js.map +0 -1
  237. package/bin/Utils/GlobalManager.d.ts +0 -32
  238. package/bin/Utils/GlobalManager.d.ts.map +0 -1
  239. package/bin/Utils/GlobalManager.js +0 -53
  240. package/bin/Utils/GlobalManager.js.map +0 -1
  241. package/bin/Utils/Logger.d.ts +0 -156
  242. package/bin/Utils/Logger.d.ts.map +0 -1
  243. package/bin/Utils/Logger.js +0 -256
  244. package/bin/Utils/Logger.js.map +0 -1
  245. package/bin/Utils/PerformanceMonitor.d.ts +0 -211
  246. package/bin/Utils/PerformanceMonitor.d.ts.map +0 -1
  247. package/bin/Utils/PerformanceMonitor.js +0 -270
  248. package/bin/Utils/PerformanceMonitor.js.map +0 -1
  249. package/bin/Utils/Pool/IPoolable.d.ts +0 -29
  250. package/bin/Utils/Pool/IPoolable.d.ts.map +0 -1
  251. package/bin/Utils/Pool/IPoolable.js +0 -2
  252. package/bin/Utils/Pool/IPoolable.js.map +0 -1
  253. package/bin/Utils/Pool/Pool.d.ts +0 -109
  254. package/bin/Utils/Pool/Pool.d.ts.map +0 -1
  255. package/bin/Utils/Pool/Pool.js +0 -238
  256. package/bin/Utils/Pool/Pool.js.map +0 -1
  257. package/bin/Utils/Pool/PoolManager.d.ts +0 -91
  258. package/bin/Utils/Pool/PoolManager.d.ts.map +0 -1
  259. package/bin/Utils/Pool/PoolManager.js +0 -197
  260. package/bin/Utils/Pool/PoolManager.js.map +0 -1
  261. package/bin/Utils/Pool/index.d.ts +0 -4
  262. package/bin/Utils/Pool/index.d.ts.map +0 -1
  263. package/bin/Utils/Pool/index.js +0 -4
  264. package/bin/Utils/Pool/index.js.map +0 -1
  265. package/bin/Utils/Time.d.ts +0 -47
  266. package/bin/Utils/Time.d.ts.map +0 -1
  267. package/bin/Utils/Time.js +0 -64
  268. package/bin/Utils/Time.js.map +0 -1
  269. package/bin/Utils/Timers/ITimer.d.ts +0 -16
  270. package/bin/Utils/Timers/ITimer.d.ts.map +0 -1
  271. package/bin/Utils/Timers/ITimer.js +0 -2
  272. package/bin/Utils/Timers/ITimer.js.map +0 -1
  273. package/bin/Utils/Timers/Timer.d.ts +0 -30
  274. package/bin/Utils/Timers/Timer.d.ts.map +0 -1
  275. package/bin/Utils/Timers/Timer.js +0 -58
  276. package/bin/Utils/Timers/Timer.js.map +0 -1
  277. package/bin/Utils/Timers/TimerManager.d.ts +0 -19
  278. package/bin/Utils/Timers/TimerManager.d.ts.map +0 -1
  279. package/bin/Utils/Timers/TimerManager.js +0 -33
  280. package/bin/Utils/Timers/TimerManager.js.map +0 -1
  281. package/bin/Utils/index.d.ts +0 -9
  282. package/bin/Utils/index.d.ts.map +0 -1
  283. package/bin/Utils/index.js +0 -9
  284. package/bin/Utils/index.js.map +0 -1
  285. package/bin/index.d.ts +0 -16
  286. package/bin/index.d.ts.map +0 -1
  287. package/bin/index.js +0 -19
  288. package/bin/index.js.map +0 -1
package/bin/Core.js DELETED
@@ -1,400 +0,0 @@
1
- import { TimerManager } from './Utils/Timers/TimerManager';
2
- import { Time } from './Utils/Time';
3
- import { PerformanceMonitor } from './Utils/PerformanceMonitor';
4
- import { PoolManager } from './Utils/Pool/PoolManager';
5
- import { createECSAPI } from './ECS/Core/FluentAPI';
6
- import { DebugManager } from './Utils/Debug';
7
- import { BigIntFactory } from './ECS/Utils/BigIntCompatibility';
8
- import { createLogger } from './Utils/Logger';
9
- /**
10
- * 游戏引擎核心类
11
- *
12
- * 负责管理游戏的生命周期、场景切换、全局管理器和定时器系统。
13
- * 提供统一的游戏循环管理。
14
- *
15
- * @example
16
- * ```typescript
17
- * // 创建核心实例
18
- * const core = Core.create(true);
19
- *
20
- * // 设置场景
21
- * Core.scene = new MyScene();
22
- *
23
- * // 在游戏循环中更新(Laya引擎示例)
24
- * Laya.timer.frameLoop(1, this, () => {
25
- * const deltaTime = Laya.timer.delta / 1000;
26
- * Core.update(deltaTime);
27
- * });
28
- *
29
- * // 调度定时器
30
- * Core.schedule(1.0, false, null, (timer) => {
31
- * Core._logger.info("1秒后执行");
32
- * });
33
- * ```
34
- */
35
- export class Core {
36
- /**
37
- * 创建核心实例
38
- *
39
- * @param config - Core配置对象
40
- */
41
- constructor(config = {}) {
42
- /**
43
- * 待切换的场景
44
- *
45
- * 存储下一帧要切换到的场景实例。
46
- */
47
- this._nextScene = null;
48
- /**
49
- * 全局管理器集合
50
- *
51
- * 存储所有注册的全局管理器实例。
52
- */
53
- this._globalManagers = [];
54
- Core._instance = this;
55
- // 保存配置
56
- this._config = {
57
- debug: true,
58
- enableEntitySystems: true,
59
- ...config
60
- };
61
- // 检测环境兼容性
62
- this._environmentInfo = BigIntFactory.getEnvironmentInfo();
63
- // 初始化管理器
64
- this._timerManager = new TimerManager();
65
- Core.registerGlobalManager(this._timerManager);
66
- // 初始化性能监控器
67
- this._performanceMonitor = PerformanceMonitor.instance;
68
- // 在调试模式下启用性能监控
69
- if (this._config.debug) {
70
- this._performanceMonitor.enable();
71
- }
72
- // 初始化对象池管理器
73
- this._poolManager = PoolManager.getInstance();
74
- Core.entitySystemsEnabled = this._config.enableEntitySystems ?? true;
75
- this.debug = this._config.debug ?? true;
76
- // 初始化调试管理器
77
- if (this._config.debugConfig?.enabled) {
78
- this._debugManager = new DebugManager(this, this._config.debugConfig);
79
- }
80
- // 在调试模式下显示兼容性信息
81
- if (this._config.debug) {
82
- this.logCompatibilityInfo();
83
- }
84
- this.initialize();
85
- }
86
- /**
87
- * 获取核心实例
88
- *
89
- * @returns 全局核心实例
90
- */
91
- static get Instance() {
92
- return this._instance;
93
- }
94
- /**
95
- * 获取当前活动的场景
96
- *
97
- * @returns 当前场景实例,如果没有则返回null
98
- */
99
- static get scene() {
100
- if (!this._instance)
101
- return null;
102
- return this._instance._scene || null;
103
- }
104
- /**
105
- * 设置当前活动的场景
106
- *
107
- * 如果当前没有场景,会立即切换;否则会在下一帧切换。
108
- *
109
- * @param value - 要设置的场景实例
110
- * @throws {Error} 当场景为空时抛出错误
111
- */
112
- static set scene(value) {
113
- if (!value)
114
- return;
115
- if (!value) {
116
- throw new Error("场景不能为空");
117
- }
118
- if (this._instance._scene == null) {
119
- this._instance._scene = value;
120
- this._instance.onSceneChanged();
121
- this._instance._scene.begin();
122
- }
123
- else {
124
- this._instance._nextScene = value;
125
- }
126
- }
127
- /**
128
- * 创建Core实例
129
- *
130
- * 如果实例已存在,则返回现有实例。
131
- *
132
- * @param config - Core配置,也可以直接传入boolean表示debug模式(向后兼容)
133
- * @returns Core实例
134
- */
135
- static create(config = true) {
136
- if (this._instance == null) {
137
- // 向后兼容:如果传入boolean,转换为配置对象
138
- const coreConfig = typeof config === 'boolean'
139
- ? { debug: config, enableEntitySystems: true }
140
- : config;
141
- this._instance = new Core(coreConfig);
142
- }
143
- return this._instance;
144
- }
145
- /**
146
- * 更新游戏逻辑
147
- *
148
- * 此方法应该在游戏引擎的更新循环中调用。
149
- *
150
- * @param deltaTime - 外部引擎提供的帧时间间隔(秒)
151
- *
152
- * @example
153
- * ```typescript
154
- * // Laya引擎
155
- * Laya.timer.frameLoop(1, this, () => {
156
- * const deltaTime = Laya.timer.delta / 1000;
157
- * Core.update(deltaTime);
158
- * });
159
- *
160
- * // Cocos Creator
161
- * update(deltaTime: number) {
162
- * Core.update(deltaTime);
163
- * }
164
- *
165
-
166
- * ```
167
- */
168
- static update(deltaTime) {
169
- if (!this._instance) {
170
- Core._logger.warn("Core实例未创建,请先调用Core.create()");
171
- return;
172
- }
173
- this._instance.updateInternal(deltaTime);
174
- }
175
- /**
176
- * 注册全局管理器
177
- *
178
- * 将管理器添加到全局管理器列表中,并启用它。
179
- *
180
- * @param manager - 要注册的全局管理器
181
- */
182
- static registerGlobalManager(manager) {
183
- this._instance._globalManagers.push(manager);
184
- manager.enabled = true;
185
- }
186
- /**
187
- * 注销全局管理器
188
- *
189
- * 从全局管理器列表中移除管理器,并禁用它。
190
- *
191
- * @param manager - 要注销的全局管理器
192
- */
193
- static unregisterGlobalManager(manager) {
194
- this._instance._globalManagers.splice(this._instance._globalManagers.indexOf(manager), 1);
195
- manager.enabled = false;
196
- }
197
- /**
198
- * 获取指定类型的全局管理器
199
- *
200
- * @param type - 管理器类型构造函数
201
- * @returns 管理器实例,如果未找到则返回null
202
- */
203
- static getGlobalManager(type) {
204
- for (const manager of this._instance._globalManagers) {
205
- if (manager instanceof type)
206
- return manager;
207
- }
208
- return null;
209
- }
210
- /**
211
- * 调度定时器
212
- *
213
- * 创建一个定时器,在指定时间后执行回调函数。
214
- *
215
- * @param timeInSeconds - 延迟时间(秒)
216
- * @param repeats - 是否重复执行,默认为false
217
- * @param context - 回调函数的上下文,默认为null
218
- * @param onTime - 定时器触发时的回调函数
219
- * @returns 创建的定时器实例
220
- */
221
- static schedule(timeInSeconds, repeats = false, context = null, onTime) {
222
- return this._instance._timerManager.schedule(timeInSeconds, repeats, context, onTime);
223
- }
224
- /**
225
- * 获取ECS流式API
226
- *
227
- * @returns ECS API实例,如果未初始化则返回null
228
- */
229
- static get ecsAPI() {
230
- return this._instance?._ecsAPI || null;
231
- }
232
- /**
233
- * 启用调试功能
234
- *
235
- * @param config 调试配置
236
- */
237
- static enableDebug(config) {
238
- if (!this._instance) {
239
- Core._logger.warn("Core实例未创建,请先调用Core.create()");
240
- return;
241
- }
242
- if (this._instance._debugManager) {
243
- this._instance._debugManager.updateConfig(config);
244
- }
245
- else {
246
- this._instance._debugManager = new DebugManager(this._instance, config);
247
- }
248
- // 更新Core配置
249
- this._instance._config.debugConfig = config;
250
- }
251
- /**
252
- * 禁用调试功能
253
- */
254
- static disableDebug() {
255
- if (!this._instance)
256
- return;
257
- if (this._instance._debugManager) {
258
- this._instance._debugManager.stop();
259
- this._instance._debugManager = undefined;
260
- }
261
- // 更新Core配置
262
- if (this._instance._config.debugConfig) {
263
- this._instance._config.debugConfig.enabled = false;
264
- }
265
- }
266
- /**
267
- * 获取调试数据
268
- *
269
- * @returns 当前调试数据,如果调试未启用则返回null
270
- */
271
- static getDebugData() {
272
- if (!this._instance?._debugManager) {
273
- return null;
274
- }
275
- return this._instance._debugManager.getDebugData();
276
- }
277
- /**
278
- * 检查调试是否启用
279
- *
280
- * @returns 调试状态
281
- */
282
- static get isDebugEnabled() {
283
- return this._instance?._config.debugConfig?.enabled || false;
284
- }
285
- /**
286
- * 获取环境兼容性信息
287
- *
288
- * @returns 环境兼容性信息
289
- */
290
- static getEnvironmentInfo() {
291
- return this._instance?._environmentInfo || null;
292
- }
293
- /**
294
- * 检查BigInt是否支持
295
- *
296
- * @returns 是否支持BigInt
297
- */
298
- static get supportsBigInt() {
299
- return this._instance?._environmentInfo.supportsBigInt || false;
300
- }
301
- /**
302
- * 场景切换回调
303
- *
304
- * 在场景切换时调用,用于重置时间系统等。
305
- */
306
- onSceneChanged() {
307
- Time.sceneChanged();
308
- // 初始化ECS API(如果场景支持)
309
- if (this._scene && typeof this._scene.querySystem !== 'undefined') {
310
- const scene = this._scene;
311
- this._ecsAPI = createECSAPI(scene, scene.querySystem, scene.eventSystem);
312
- }
313
- // 通知调试管理器场景已变更
314
- if (this._debugManager) {
315
- this._debugManager.onSceneChanged();
316
- }
317
- }
318
- /**
319
- * 初始化核心系统
320
- *
321
- * 执行核心系统的初始化逻辑。
322
- */
323
- initialize() {
324
- // 核心系统初始化
325
- }
326
- /**
327
- * 记录兼容性信息
328
- *
329
- * 在控制台输出当前环境的兼容性信息和建议。
330
- */
331
- logCompatibilityInfo() {
332
- const info = this._environmentInfo;
333
- Core._logger.info('ECS Framework 兼容性检测结果:');
334
- Core._logger.info(` 环境: ${info.environment}`);
335
- Core._logger.info(` JavaScript引擎: ${info.jsEngine}`);
336
- Core._logger.info(` BigInt支持: ${info.supportsBigInt ? '支持' : '不支持'}`);
337
- if (!info.supportsBigInt) {
338
- Core._logger.warn('BigInt兼容模式已启用');
339
- }
340
- }
341
- /**
342
- * 内部更新方法
343
- *
344
- * @param deltaTime - 帧时间间隔(秒)
345
- */
346
- updateInternal(deltaTime) {
347
- if (Core.paused)
348
- return;
349
- // 开始性能监控
350
- const frameStartTime = this._performanceMonitor.startMonitoring('Core.update');
351
- // 更新时间系统
352
- Time.update(deltaTime);
353
- // 更新FPS监控(如果性能监控器支持)
354
- if (typeof this._performanceMonitor.updateFPS === 'function') {
355
- this._performanceMonitor.updateFPS(Time.deltaTime);
356
- }
357
- // 更新全局管理器
358
- const managersStartTime = this._performanceMonitor.startMonitoring('GlobalManagers.update');
359
- for (const globalManager of this._globalManagers) {
360
- if (globalManager.enabled)
361
- globalManager.update();
362
- }
363
- this._performanceMonitor.endMonitoring('GlobalManagers.update', managersStartTime, this._globalManagers.length);
364
- // 更新对象池管理器
365
- this._poolManager.update();
366
- // 处理场景切换
367
- if (this._nextScene != null) {
368
- if (this._scene != null)
369
- this._scene.end();
370
- this._scene = this._nextScene;
371
- this._nextScene = null;
372
- this.onSceneChanged();
373
- this._scene.begin();
374
- }
375
- // 更新当前场景
376
- if (this._scene != null && this._scene.update) {
377
- const sceneStartTime = this._performanceMonitor.startMonitoring('Scene.update');
378
- this._scene.update();
379
- const entityCount = this._scene.entities?.count || 0;
380
- this._performanceMonitor.endMonitoring('Scene.update', sceneStartTime, entityCount);
381
- }
382
- // 更新调试管理器(基于FPS的数据发送)
383
- if (this._debugManager) {
384
- this._debugManager.onFrameUpdate(deltaTime);
385
- }
386
- // 结束性能监控
387
- this._performanceMonitor.endMonitoring('Core.update', frameStartTime);
388
- }
389
- }
390
- /**
391
- * 游戏暂停状态
392
- *
393
- * 当设置为true时,游戏循环将暂停执行。
394
- */
395
- Core.paused = false;
396
- /**
397
- * Core专用日志器
398
- */
399
- Core._logger = createLogger('Core');
400
- //# sourceMappingURL=Core.js.map
package/bin/Core.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"Core.js","sourceRoot":"","sources":["../src/Core.ts"],"names":[],"mappings":"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"}
@@ -1,120 +0,0 @@
1
- import type { IComponent } from '../Types';
2
- /**
3
- * 游戏组件基类
4
- *
5
- * ECS架构中的组件(Component),用于实现具体的游戏功能。
6
- * 组件包含数据和行为,可以被添加到实体上以扩展实体的功能。
7
- *
8
- * @example
9
- * ```typescript
10
- * class HealthComponent extends Component {
11
- * public health: number = 100;
12
- *
13
- * public takeDamage(damage: number): void {
14
- * this.health -= damage;
15
- * if (this.health <= 0) {
16
- * this.entity.destroy();
17
- * }
18
- * }
19
- * }
20
- * ```
21
- */
22
- export declare abstract class Component implements IComponent {
23
- /**
24
- * 组件ID生成器
25
- *
26
- * 用于为每个组件分配唯一的ID。
27
- */
28
- static _idGenerator: number;
29
- /**
30
- * 组件唯一标识符
31
- *
32
- * 在整个游戏生命周期中唯一的数字ID。
33
- */
34
- readonly id: number;
35
- /**
36
- * 组件所属的实体
37
- *
38
- * 指向拥有此组件的实体实例。
39
- */
40
- entity: Entity;
41
- /**
42
- * 组件启用状态
43
- *
44
- * 控制组件是否参与更新循环。
45
- */
46
- private _enabled;
47
- /**
48
- * 更新顺序
49
- *
50
- * 决定组件在更新循环中的执行顺序。
51
- */
52
- private _updateOrder;
53
- /**
54
- * 创建组件实例
55
- *
56
- * 自动分配唯一ID给组件。
57
- */
58
- constructor();
59
- /**
60
- * 获取组件启用状态
61
- *
62
- * 组件的实际启用状态取决于自身状态和所属实体的状态。
63
- *
64
- * @returns 如果组件和所属实体都启用则返回true
65
- */
66
- get enabled(): boolean;
67
- /**
68
- * 设置组件启用状态
69
- *
70
- * 当状态改变时会触发相应的生命周期回调。
71
- *
72
- * @param value - 新的启用状态
73
- */
74
- set enabled(value: boolean);
75
- /**
76
- * 获取更新顺序
77
- *
78
- * @returns 组件的更新顺序值
79
- */
80
- get updateOrder(): number;
81
- /**
82
- * 设置更新顺序
83
- *
84
- * @param value - 新的更新顺序值
85
- */
86
- set updateOrder(value: number);
87
- /**
88
- * 组件添加到实体时的回调
89
- *
90
- * 当组件被添加到实体时调用,可以在此方法中进行初始化操作。
91
- */
92
- onAddedToEntity(): void;
93
- /**
94
- * 组件从实体移除时的回调
95
- *
96
- * 当组件从实体中移除时调用,可以在此方法中进行清理操作。
97
- */
98
- onRemovedFromEntity(): void;
99
- /**
100
- * 组件启用时的回调
101
- *
102
- * 当组件被启用时调用。
103
- */
104
- onEnabled(): void;
105
- /**
106
- * 组件禁用时的回调
107
- *
108
- * 当组件被禁用时调用。
109
- */
110
- onDisabled(): void;
111
- /**
112
- * 更新组件
113
- *
114
- * 每帧调用,用于更新组件的逻辑。
115
- * 子类应该重写此方法来实现具体的更新逻辑。
116
- */
117
- update(): void;
118
- }
119
- import type { Entity } from './Entity';
120
- //# sourceMappingURL=Component.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"Component.d.ts","sourceRoot":"","sources":["../../src/ECS/Component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8BAAsB,SAAU,YAAW,UAAU;IACjD;;;;OAIG;IACH,OAAc,YAAY,EAAE,MAAM,CAAK;IAEvC;;;;OAIG;IACH,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACI,MAAM,EAAG,MAAM,CAAC;IAEvB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAa;IAEjC;;;;OAIG;;IAKH;;;;;;OAMG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;;;OAMG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAShC;IAED;;;;OAIG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED;;;;OAIG;IACH,IAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAEnC;IAED;;;;OAIG;IACI,eAAe,IAAI,IAAI;IAG9B;;;;OAIG;IACI,mBAAmB,IAAI,IAAI;IAGlC;;;;OAIG;IACI,SAAS,IAAI,IAAI;IAGxB;;;;OAIG;IACI,UAAU,IAAI,IAAI;IAGzB;;;;;OAKG;IACI,MAAM,IAAI,IAAI;CAGxB;AAGD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}
@@ -1,129 +0,0 @@
1
- /**
2
- * 游戏组件基类
3
- *
4
- * ECS架构中的组件(Component),用于实现具体的游戏功能。
5
- * 组件包含数据和行为,可以被添加到实体上以扩展实体的功能。
6
- *
7
- * @example
8
- * ```typescript
9
- * class HealthComponent extends Component {
10
- * public health: number = 100;
11
- *
12
- * public takeDamage(damage: number): void {
13
- * this.health -= damage;
14
- * if (this.health <= 0) {
15
- * this.entity.destroy();
16
- * }
17
- * }
18
- * }
19
- * ```
20
- */
21
- export class Component {
22
- /**
23
- * 创建组件实例
24
- *
25
- * 自动分配唯一ID给组件。
26
- */
27
- constructor() {
28
- /**
29
- * 组件启用状态
30
- *
31
- * 控制组件是否参与更新循环。
32
- */
33
- this._enabled = true;
34
- /**
35
- * 更新顺序
36
- *
37
- * 决定组件在更新循环中的执行顺序。
38
- */
39
- this._updateOrder = 0;
40
- this.id = Component._idGenerator++;
41
- }
42
- /**
43
- * 获取组件启用状态
44
- *
45
- * 组件的实际启用状态取决于自身状态和所属实体的状态。
46
- *
47
- * @returns 如果组件和所属实体都启用则返回true
48
- */
49
- get enabled() {
50
- return this.entity ? this.entity.enabled && this._enabled : this._enabled;
51
- }
52
- /**
53
- * 设置组件启用状态
54
- *
55
- * 当状态改变时会触发相应的生命周期回调。
56
- *
57
- * @param value - 新的启用状态
58
- */
59
- set enabled(value) {
60
- if (this._enabled !== value) {
61
- this._enabled = value;
62
- if (this._enabled) {
63
- this.onEnabled();
64
- }
65
- else {
66
- this.onDisabled();
67
- }
68
- }
69
- }
70
- /**
71
- * 获取更新顺序
72
- *
73
- * @returns 组件的更新顺序值
74
- */
75
- get updateOrder() {
76
- return this._updateOrder;
77
- }
78
- /**
79
- * 设置更新顺序
80
- *
81
- * @param value - 新的更新顺序值
82
- */
83
- set updateOrder(value) {
84
- this._updateOrder = value;
85
- }
86
- /**
87
- * 组件添加到实体时的回调
88
- *
89
- * 当组件被添加到实体时调用,可以在此方法中进行初始化操作。
90
- */
91
- onAddedToEntity() {
92
- }
93
- /**
94
- * 组件从实体移除时的回调
95
- *
96
- * 当组件从实体中移除时调用,可以在此方法中进行清理操作。
97
- */
98
- onRemovedFromEntity() {
99
- }
100
- /**
101
- * 组件启用时的回调
102
- *
103
- * 当组件被启用时调用。
104
- */
105
- onEnabled() {
106
- }
107
- /**
108
- * 组件禁用时的回调
109
- *
110
- * 当组件被禁用时调用。
111
- */
112
- onDisabled() {
113
- }
114
- /**
115
- * 更新组件
116
- *
117
- * 每帧调用,用于更新组件的逻辑。
118
- * 子类应该重写此方法来实现具体的更新逻辑。
119
- */
120
- update() {
121
- }
122
- }
123
- /**
124
- * 组件ID生成器
125
- *
126
- * 用于为每个组件分配唯一的ID。
127
- */
128
- Component._idGenerator = 0;
129
- //# sourceMappingURL=Component.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"Component.js","sourceRoot":"","sources":["../../src/ECS/Component.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAgB,SAAS;IAoC3B;;;;OAIG;IACH;QAnBA;;;;WAIG;QACK,aAAQ,GAAY,IAAI,CAAC;QAEjC;;;;WAIG;QACK,iBAAY,GAAW,CAAC,CAAC;QAQ7B,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACH,IAAW,OAAO,CAAC,KAAc;QAC7B,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,IAAW,WAAW,CAAC,KAAa;QAChC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACI,eAAe;IACtB,CAAC;IAED;;;;OAIG;IACI,mBAAmB;IAC1B,CAAC;IAED;;;;OAIG;IACI,SAAS;IAChB,CAAC;IAED;;;;OAIG;IACI,UAAU;IACjB,CAAC;IAED;;;;;OAKG;IACI,MAAM;IACb,CAAC;;AAlID;;;;GAIG;AACW,sBAAY,GAAW,CAAC,AAAZ,CAAa"}
@@ -1,22 +0,0 @@
1
- /**
2
- * 可更新接口
3
- * 当添加到组件时,只要组件和实体被启用,就会在每帧调用update方法
4
- */
5
- export interface IUpdatable {
6
- enabled: boolean;
7
- updateOrder: number;
8
- update(): void;
9
- }
10
- /**
11
- * 用于比较组件更新排序的比较器
12
- */
13
- export declare class IUpdatableComparer {
14
- compare(a: IUpdatable, b: IUpdatable): number;
15
- }
16
- /**
17
- * 检查对象是否实现了IUpdatable接口
18
- * @param props 要检查的对象
19
- * @returns 如果实现了IUpdatable接口返回true,否则返回false
20
- */
21
- export declare function isIUpdatable(props: any): props is IUpdatable;
22
- //# sourceMappingURL=IUpdatable.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"IUpdatable.d.ts","sourceRoot":"","sources":["../../../src/ECS/Components/IUpdatable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,IAAI,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IACpB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM;CAGvD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,UAAU,CAE5D"}