@egret/engine 0.0.0-stage → 7.0.1-rc.3

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 (575) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +464 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +42 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +69 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +52 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +15 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +43 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +233 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +29 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +109 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +25 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +411 -0
  57. package/dist/cameraTypes.d.ts +114 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +33 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +42 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +34 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +31 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +50 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +134 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +119 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +49 -0
  100. package/dist/index.js +20 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +81 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +64 -0
  116. package/dist/internal/uiFactoryState.js +157 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +12 -0
  120. package/dist/keyboardInput.js +578 -0
  121. package/dist/keyboardInputTypes.d.ts +81 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +14 -0
  124. package/dist/kit.js +9 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +16 -0
  132. package/dist/manifestResourceState.js +57 -0
  133. package/dist/manifestResourceTypes.d.ts +25 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +33 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +37 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +292 -0
  145. package/dist/particleTypes.d.ts +107 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +167 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +623 -0
  157. package/dist/pointerInput.d.ts +11 -0
  158. package/dist/pointerInput.js +299 -0
  159. package/dist/pointerInputTypes.d.ts +38 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +29 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +331 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +88 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +652 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +18 -0
  178. package/dist/rendering/sharedColor2D.js +68 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +118 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +95 -0
  188. package/dist/rendering/world3d/Animation3D.js +380 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +71 -0
  192. package/dist/rendering/world3d/Batch3D.js +329 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +57 -0
  194. package/dist/rendering/world3d/Camera3D.js +129 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +123 -0
  196. package/dist/rendering/world3d/Character3D.js +303 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
  198. package/dist/rendering/world3d/Cloth3D.js +498 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +21 -0
  200. package/dist/rendering/world3d/Compression3D.js +702 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +111 -0
  202. package/dist/rendering/world3d/Curves3D.js +455 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +41 -0
  204. package/dist/rendering/world3d/Decal3D.js +241 -0
  205. package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
  206. package/dist/rendering/world3d/Geometry3D.js +326 -0
  207. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
  208. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  209. package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
  210. package/dist/rendering/world3d/Gizmo3D.js +512 -0
  211. package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
  212. package/dist/rendering/world3d/Gltf3D.js +976 -0
  213. package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
  214. package/dist/rendering/world3d/GpuParticles3D.js +400 -0
  215. package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
  216. package/dist/rendering/world3d/Hdr3D.js +190 -0
  217. package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
  218. package/dist/rendering/world3d/Jelly3D.js +266 -0
  219. package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
  220. package/dist/rendering/world3d/Ktx23D.js +112 -0
  221. package/dist/rendering/world3d/Light3D.d.ts +75 -0
  222. package/dist/rendering/world3d/Light3D.js +93 -0
  223. package/dist/rendering/world3d/Material3D.d.ts +243 -0
  224. package/dist/rendering/world3d/Material3D.js +267 -0
  225. package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
  226. package/dist/rendering/world3d/Mesh3D.js +323 -0
  227. package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
  228. package/dist/rendering/world3d/Meshopt3D.js +275 -0
  229. package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
  230. package/dist/rendering/world3d/Navigation3D.js +971 -0
  231. package/dist/rendering/world3d/Object3D.d.ts +107 -0
  232. package/dist/rendering/world3d/Object3D.js +305 -0
  233. package/dist/rendering/world3d/Particles3D.d.ts +85 -0
  234. package/dist/rendering/world3d/Particles3D.js +274 -0
  235. package/dist/rendering/world3d/Physics3D.d.ts +416 -0
  236. package/dist/rendering/world3d/Physics3D.js +2835 -0
  237. package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
  238. package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
  239. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
  240. package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
  241. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  242. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  243. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
  244. package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
  245. package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
  246. package/dist/rendering/world3d/Ragdoll3D.js +200 -0
  247. package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
  248. package/dist/rendering/world3d/Raycast3D.js +246 -0
  249. package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
  250. package/dist/rendering/world3d/RenderList3D.js +490 -0
  251. package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
  252. package/dist/rendering/world3d/Retarget3D.js +185 -0
  253. package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
  254. package/dist/rendering/world3d/Serialize3D.js +607 -0
  255. package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
  256. package/dist/rendering/world3d/StateMachine3D.js +277 -0
  257. package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
  258. package/dist/rendering/world3d/Terrain3D.js +803 -0
  259. package/dist/rendering/world3d/Text3D.d.ts +90 -0
  260. package/dist/rendering/world3d/Text3D.js +558 -0
  261. package/dist/rendering/world3d/Texture3D.d.ts +133 -0
  262. package/dist/rendering/world3d/Texture3D.js +252 -0
  263. package/dist/rendering/world3d/Trail3D.d.ts +59 -0
  264. package/dist/rendering/world3d/Trail3D.js +193 -0
  265. package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
  266. package/dist/rendering/world3d/Vehicle3D.js +226 -0
  267. package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
  268. package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
  269. package/dist/rendering/world3d/Water3D.d.ts +163 -0
  270. package/dist/rendering/world3d/Water3D.js +606 -0
  271. package/dist/rendering/world3d/core3D.d.ts +34 -0
  272. package/dist/rendering/world3d/core3D.js +99 -0
  273. package/dist/rendering/world3d/debug3D.d.ts +64 -0
  274. package/dist/rendering/world3d/debug3D.js +257 -0
  275. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  276. package/dist/rendering/world3d/decoders3D.js +133 -0
  277. package/dist/rendering/world3d/geometries3D.d.ts +99 -0
  278. package/dist/rendering/world3d/geometries3D.js +605 -0
  279. package/dist/rendering/world3d/helpers3D.d.ts +65 -0
  280. package/dist/rendering/world3d/helpers3D.js +177 -0
  281. package/dist/rendering/world3d/index.d.ts +91 -0
  282. package/dist/rendering/world3d/index.js +56 -0
  283. package/dist/rendering/world3d/math3D.d.ts +78 -0
  284. package/dist/rendering/world3d/math3D.js +640 -0
  285. package/dist/rendering/world3d/primitives3D.d.ts +60 -0
  286. package/dist/rendering/world3d/primitives3D.js +196 -0
  287. package/dist/resources.d.ts +8 -0
  288. package/dist/resources.js +6 -0
  289. package/dist/saveStore.d.ts +56 -0
  290. package/dist/saveStore.js +163 -0
  291. package/dist/semanticList.d.ts +122 -0
  292. package/dist/semanticList.js +174 -0
  293. package/dist/semanticTree.d.ts +10 -0
  294. package/dist/semanticTree.js +532 -0
  295. package/dist/semanticTypes.d.ts +167 -0
  296. package/dist/semanticTypes.js +2 -0
  297. package/dist/semantics.d.ts +6 -0
  298. package/dist/semantics.js +5 -0
  299. package/dist/sequencePlayback.d.ts +19 -0
  300. package/dist/sequencePlayback.js +391 -0
  301. package/dist/sequencePlaybackTypes.d.ts +21 -0
  302. package/dist/sequencePlaybackTypes.js +2 -0
  303. package/dist/sequenceTargetClaims.d.ts +10 -0
  304. package/dist/sequenceTargetClaims.js +31 -0
  305. package/dist/srgbBytes.d.ts +3 -0
  306. package/dist/srgbBytes.js +64 -0
  307. package/dist/startEngine.d.ts +5 -0
  308. package/dist/startEngine.js +31 -0
  309. package/dist/surfaceOwnership.d.ts +3 -0
  310. package/dist/surfaceOwnership.js +15 -0
  311. package/dist/text.d.ts +23 -0
  312. package/dist/text.js +4 -0
  313. package/dist/textField.d.ts +6 -0
  314. package/dist/textField.js +6 -0
  315. package/dist/tileMapDraw.d.ts +7 -0
  316. package/dist/tileMapDraw.js +310 -0
  317. package/dist/tiledImport.d.ts +9 -0
  318. package/dist/tiledImport.js +357 -0
  319. package/dist/tilemap.d.ts +5 -0
  320. package/dist/tilemap.js +5 -0
  321. package/dist/tilemapTypes.d.ts +169 -0
  322. package/dist/tilemapTypes.js +2 -0
  323. package/dist/tween.d.ts +15 -0
  324. package/dist/tween.js +329 -0
  325. package/dist/tweenTypes.d.ts +27 -0
  326. package/dist/tweenTypes.js +2 -0
  327. package/dist/ui/controlKeys.d.ts +109 -0
  328. package/dist/ui/controlKeys.js +249 -0
  329. package/dist/ui/controls.d.ts +52 -0
  330. package/dist/ui/controls.js +288 -0
  331. package/dist/ui/editing.d.ts +3 -0
  332. package/dist/ui/editing.js +3 -0
  333. package/dist/ui/index.d.ts +19 -0
  334. package/dist/ui/index.js +11 -0
  335. package/dist/ui/keyboardFocus.d.ts +32 -0
  336. package/dist/ui/keyboardFocus.js +146 -0
  337. package/dist/ui/layerTypes.d.ts +91 -0
  338. package/dist/ui/layerTypes.js +2 -0
  339. package/dist/ui/layers.d.ts +4 -0
  340. package/dist/ui/layers.js +586 -0
  341. package/dist/ui/leafContent.d.ts +21 -0
  342. package/dist/ui/leafContent.js +136 -0
  343. package/dist/ui/rangeControl.d.ts +50 -0
  344. package/dist/ui/rangeControl.js +167 -0
  345. package/dist/ui/scrollControl.d.ts +72 -0
  346. package/dist/ui/scrollControl.js +218 -0
  347. package/dist/ui/stateControls.d.ts +82 -0
  348. package/dist/ui/stateControls.js +328 -0
  349. package/dist/ui/textEditor.d.ts +53 -0
  350. package/dist/ui/textEditor.js +370 -0
  351. package/dist/ui/textEditorTypes.d.ts +78 -0
  352. package/dist/ui/textEditorTypes.js +2 -0
  353. package/dist/ui/textFieldControl.d.ts +96 -0
  354. package/dist/ui/textFieldControl.js +259 -0
  355. package/dist/ui/theme.d.ts +59 -0
  356. package/dist/ui/theme.js +165 -0
  357. package/dist/ui/types.d.ts +265 -0
  358. package/dist/ui/types.js +2 -0
  359. package/dist/ui/uiRoot.d.ts +4 -0
  360. package/dist/ui/uiRoot.js +1497 -0
  361. package/dist/ui/uiRootDisplay.d.ts +46 -0
  362. package/dist/ui/uiRootDisplay.js +148 -0
  363. package/dist/ui/uiRootModel.d.ts +112 -0
  364. package/dist/ui/uiRootModel.js +60 -0
  365. package/dist/ui/virtualList.d.ts +20 -0
  366. package/dist/ui/virtualList.js +105 -0
  367. package/dist/video.d.ts +4 -0
  368. package/dist/video.js +4 -0
  369. package/dist/videoPlayer.d.ts +4 -0
  370. package/dist/videoPlayer.js +215 -0
  371. package/dist/videoTypes.d.ts +74 -0
  372. package/dist/videoTypes.js +2 -0
  373. package/dist/web/BrowserAssetBundle.d.ts +39 -0
  374. package/dist/web/BrowserAssetBundle.js +136 -0
  375. package/dist/web/BrowserAudio.d.ts +41 -0
  376. package/dist/web/BrowserAudio.js +473 -0
  377. package/dist/web/BrowserFrameLoop.d.ts +65 -0
  378. package/dist/web/BrowserFrameLoop.js +125 -0
  379. package/dist/web/BrowserGame.d.ts +112 -0
  380. package/dist/web/BrowserGame.js +352 -0
  381. package/dist/web/BrowserGamepadInput.d.ts +35 -0
  382. package/dist/web/BrowserGamepadInput.js +134 -0
  383. package/dist/web/BrowserHoverInput.d.ts +24 -0
  384. package/dist/web/BrowserHoverInput.js +266 -0
  385. package/dist/web/BrowserImageTextures.d.ts +66 -0
  386. package/dist/web/BrowserImageTextures.js +169 -0
  387. package/dist/web/BrowserInputActions.d.ts +53 -0
  388. package/dist/web/BrowserInputActions.js +342 -0
  389. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  390. package/dist/web/BrowserKeyboardInput.js +223 -0
  391. package/dist/web/BrowserPlay.d.ts +289 -0
  392. package/dist/web/BrowserPlay.js +1301 -0
  393. package/dist/web/BrowserPointerInput.d.ts +4 -0
  394. package/dist/web/BrowserPointerInput.js +511 -0
  395. package/dist/web/BrowserSemantics.d.ts +34 -0
  396. package/dist/web/BrowserSemantics.js +418 -0
  397. package/dist/web/BrowserStatsPanel.d.ts +46 -0
  398. package/dist/web/BrowserStatsPanel.js +137 -0
  399. package/dist/web/BrowserStorage.d.ts +33 -0
  400. package/dist/web/BrowserStorage.js +132 -0
  401. package/dist/web/BrowserTextEditor.d.ts +49 -0
  402. package/dist/web/BrowserTextEditor.js +839 -0
  403. package/dist/web/BrowserTextInput.d.ts +83 -0
  404. package/dist/web/BrowserTextInput.js +524 -0
  405. package/dist/web/BrowserTextureProvider.d.ts +52 -0
  406. package/dist/web/BrowserTextureProvider.js +935 -0
  407. package/dist/web/BrowserVideo.d.ts +28 -0
  408. package/dist/web/BrowserVideo.js +211 -0
  409. package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
  410. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  411. package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
  412. package/dist/web/CanvasKitParagraphProvider.js +691 -0
  413. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  414. package/dist/web/CanvasTextRasterProvider.js +312 -0
  415. package/dist/web/ManifestByteSource.d.ts +147 -0
  416. package/dist/web/ManifestByteSource.js +974 -0
  417. package/dist/web/ManifestFontContentLoader.d.ts +12 -0
  418. package/dist/web/ManifestFontContentLoader.js +30 -0
  419. package/dist/web/MouseInput.d.ts +4 -0
  420. package/dist/web/MouseInput.js +218 -0
  421. package/dist/web/WebGL2Host.d.ts +5 -0
  422. package/dist/web/WebGL2Host.js +2672 -0
  423. package/dist/web/WebGPUHost.d.ts +87 -0
  424. package/dist/web/WebGPUHost.js +3349 -0
  425. package/dist/web/audio.d.ts +3 -0
  426. package/dist/web/audio.js +4 -0
  427. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  428. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  429. package/dist/web/editing.d.ts +5 -0
  430. package/dist/web/editing.js +4 -0
  431. package/dist/web/editorFonts.d.ts +50 -0
  432. package/dist/web/editorFonts.js +297 -0
  433. package/dist/web/game.d.ts +5 -0
  434. package/dist/web/game.js +6 -0
  435. package/dist/web/gamepad.d.ts +3 -0
  436. package/dist/web/gamepad.js +4 -0
  437. package/dist/web/hover.d.ts +3 -0
  438. package/dist/web/hover.js +4 -0
  439. package/dist/web/image.d.ts +4 -0
  440. package/dist/web/image.js +4 -0
  441. package/dist/web/imageProjections2D.d.ts +14 -0
  442. package/dist/web/imageProjections2D.js +2 -0
  443. package/dist/web/input.d.ts +6 -0
  444. package/dist/web/input.js +4 -0
  445. package/dist/web/keyboard.d.ts +3 -0
  446. package/dist/web/keyboard.js +3 -0
  447. package/dist/web/kit.d.ts +10 -0
  448. package/dist/web/kit.js +7 -0
  449. package/dist/web/loop.d.ts +3 -0
  450. package/dist/web/loop.js +4 -0
  451. package/dist/web/paragraph.d.ts +6 -0
  452. package/dist/web/paragraph.js +4 -0
  453. package/dist/web/play.d.ts +5 -0
  454. package/dist/web/play.js +6 -0
  455. package/dist/web/playSfx.d.ts +36 -0
  456. package/dist/web/playSfx.js +112 -0
  457. package/dist/web/pointer.d.ts +3 -0
  458. package/dist/web/pointer.js +3 -0
  459. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  460. package/dist/web/prepareSharedSubmission2D.js +57 -0
  461. package/dist/web/resources.d.ts +27 -0
  462. package/dist/web/resources.js +96 -0
  463. package/dist/web/semantics.d.ts +3 -0
  464. package/dist/web/semantics.js +4 -0
  465. package/dist/web/sharedDeviceSession.d.ts +64 -0
  466. package/dist/web/sharedDeviceSession.js +2 -0
  467. package/dist/web/sharedEffectShaders.d.ts +9 -0
  468. package/dist/web/sharedEffectShaders.js +165 -0
  469. package/dist/web/sharedFrameUpload.d.ts +25 -0
  470. package/dist/web/sharedFrameUpload.js +2 -0
  471. package/dist/web/sharedHostDeferred.d.ts +7 -0
  472. package/dist/web/sharedHostDeferred.js +12 -0
  473. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  474. package/dist/web/sharedRetentionLedger.js +391 -0
  475. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  476. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  477. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  478. package/dist/web/sharedWebGL2Arena.js +77 -0
  479. package/dist/web/sharedWebGL2Options.d.ts +30 -0
  480. package/dist/web/sharedWebGL2Options.js +96 -0
  481. package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
  482. package/dist/web/sharedWebGL2Shaders.js +314 -0
  483. package/dist/web/sharedWebGPUOptions.d.ts +37 -0
  484. package/dist/web/sharedWebGPUOptions.js +126 -0
  485. package/dist/web/text.d.ts +3 -0
  486. package/dist/web/text.js +3 -0
  487. package/dist/web/textInput.d.ts +3 -0
  488. package/dist/web/textInput.js +3 -0
  489. package/dist/web/video.d.ts +3 -0
  490. package/dist/web/video.js +4 -0
  491. package/dist/web/webgl2.d.ts +7 -0
  492. package/dist/web/webgl2.js +4 -0
  493. package/dist/web/webgl2LayerState.d.ts +50 -0
  494. package/dist/web/webgl2LayerState.js +102 -0
  495. package/dist/web/webgl2Native.d.ts +70 -0
  496. package/dist/web/webgl2Native.js +568 -0
  497. package/dist/web/webgl2Types.d.ts +132 -0
  498. package/dist/web/webgl2Types.js +2 -0
  499. package/dist/web/webgpu.d.ts +6 -0
  500. package/dist/web/webgpu.js +2 -0
  501. package/dist/web/webgpuBindingCache.d.ts +26 -0
  502. package/dist/web/webgpuBindingCache.js +223 -0
  503. package/dist/web/webgpuBufferPool.d.ts +51 -0
  504. package/dist/web/webgpuBufferPool.js +58 -0
  505. package/dist/web/webgpuImageResidency.d.ts +53 -0
  506. package/dist/web/webgpuImageResidency.js +61 -0
  507. package/dist/web/webgpuLifetime.d.ts +45 -0
  508. package/dist/web/webgpuLifetime.js +64 -0
  509. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  510. package/dist/web/webgpuRetentionPool.js +84 -0
  511. package/dist/web/webgpuSharedPass.d.ts +7 -0
  512. package/dist/web/webgpuSharedPass.js +211 -0
  513. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  514. package/dist/web/webgpuSharedResolvePass.js +29 -0
  515. package/dist/web/world3d/Audio3D.d.ts +68 -0
  516. package/dist/web/world3d/Audio3D.js +212 -0
  517. package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
  518. package/dist/web/world3d/BrowserPlay3D.js +851 -0
  519. package/dist/web/world3d/FlyControls3D.d.ts +55 -0
  520. package/dist/web/world3d/FlyControls3D.js +160 -0
  521. package/dist/web/world3d/FollowControls3D.d.ts +28 -0
  522. package/dist/web/world3d/FollowControls3D.js +117 -0
  523. package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
  524. package/dist/web/world3d/OrbitControls3D.js +187 -0
  525. package/dist/web/world3d/TransformControls3D.d.ts +34 -0
  526. package/dist/web/world3d/TransformControls3D.js +125 -0
  527. package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
  528. package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
  529. package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
  530. package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
  531. package/dist/web/world3d/World3DView.d.ts +51 -0
  532. package/dist/web/world3d/World3DView.js +77 -0
  533. package/dist/web/world3d/app3D.d.ts +136 -0
  534. package/dist/web/world3d/app3D.js +304 -0
  535. package/dist/web/world3d/assets3D.d.ts +38 -0
  536. package/dist/web/world3d/assets3D.js +112 -0
  537. package/dist/web/world3d/atmosphere3D.d.ts +47 -0
  538. package/dist/web/world3d/atmosphere3D.js +178 -0
  539. package/dist/web/world3d/frame3D.d.ts +142 -0
  540. package/dist/web/world3d/frame3D.js +388 -0
  541. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  542. package/dist/web/world3d/gpuResources3D.js +901 -0
  543. package/dist/web/world3d/host3D.d.ts +23 -0
  544. package/dist/web/world3d/host3D.js +61 -0
  545. package/dist/web/world3d/index.d.ts +38 -0
  546. package/dist/web/world3d/index.js +23 -0
  547. package/dist/web/world3d/loaders3D.d.ts +26 -0
  548. package/dist/web/world3d/loaders3D.js +138 -0
  549. package/dist/web/world3d/markers3D.d.ts +49 -0
  550. package/dist/web/world3d/markers3D.js +130 -0
  551. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  552. package/dist/web/world3d/materialWebGL23D.js +218 -0
  553. package/dist/web/world3d/overlay3D.d.ts +28 -0
  554. package/dist/web/world3d/overlay3D.js +170 -0
  555. package/dist/web/world3d/post3D.d.ts +112 -0
  556. package/dist/web/world3d/post3D.js +459 -0
  557. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  558. package/dist/web/world3d/postWebGL23D.js +237 -0
  559. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  560. package/dist/web/world3d/postWebGPU3D.js +255 -0
  561. package/dist/web/world3d/probe3D.d.ts +14 -0
  562. package/dist/web/world3d/probe3D.js +66 -0
  563. package/dist/web/world3d/shaders3D.d.ts +43 -0
  564. package/dist/web/world3d/shaders3D.js +851 -0
  565. package/dist/web/world3d/stats3D.d.ts +31 -0
  566. package/dist/web/world3d/stats3D.js +80 -0
  567. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
  568. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  569. package/dist/web/world3d/webgpu.d.ts +35 -0
  570. package/dist/web/world3d/webgpu.js +22 -0
  571. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  572. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  573. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  574. package/dist/web/world3d/wgsl3D.js +781 -0
  575. package/package.json +220 -4
@@ -0,0 +1,618 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError, SequencePlayer } from '@egret/runtime';
3
+ import { requireSequenceControllerEngine } from '../internal/sequenceControllerFactoryState.js';
4
+ import { assertNotCapturing, captureInput, coordinatorSize, deliver, mustQueue, requireCoordinator } from './sequenceCoordinator.js';
5
+ import { admitRate, captureOptions, captureSeek } from './sequenceInput.js';
6
+ import { locatePosition, planEvents } from './sequenceMath.js';
7
+ const apply = Reflect.apply;
8
+ const playerApply = SequencePlayer.prototype.applyAt;
9
+ const playerDispose = SequencePlayer.prototype.dispose;
10
+ const playerConstructor = SequencePlayer;
11
+ const EMPTY_MARKERS = Object.freeze([]);
12
+ function terminal(state) {
13
+ return state === 'completed' || state === 'stopped' || state === 'faulted';
14
+ }
15
+ function codeOf(cause, fallback) {
16
+ return cause instanceof EgretError ? cause.code : fallback;
17
+ }
18
+ function remember(record, issue) {
19
+ record.lastIssue = Object.freeze({ code: issue.code, clockTickId: issue.clockTickId });
20
+ }
21
+ function originalDispose() {
22
+ apply(playerDispose, this, []);
23
+ }
24
+ /** Revoke first; every acquired borrow is then attempted independently. */
25
+ function retire(record, state, keepDelivery = false) {
26
+ if (!keepDelivery && record.delivery !== undefined)
27
+ record.delivery.active = false;
28
+ if (terminal(record.state) && record.port === undefined)
29
+ return undefined;
30
+ record.state = state;
31
+ const port = record.port, scope = record.scope, coordinator = record.coordinator;
32
+ const driver = record.driver, player = record.player, target = record.target, abort = record.abort;
33
+ const claimed = record.claimed;
34
+ record.port = undefined;
35
+ record.scope = undefined;
36
+ record.coordinator = undefined;
37
+ record.driver = undefined;
38
+ record.player = undefined;
39
+ record.clip = undefined;
40
+ record.target = undefined;
41
+ record.abort = undefined;
42
+ record.claimed = false;
43
+ record.listener = undefined;
44
+ record.markers = EMPTY_MARKERS;
45
+ record.pending = [];
46
+ let first;
47
+ for (const cleanup of [
48
+ () => {
49
+ if (abort !== undefined)
50
+ scope?.remove(abort);
51
+ },
52
+ () => {
53
+ if (claimed && target !== undefined)
54
+ port?.claims.release(target, record.claimToken);
55
+ },
56
+ () => {
57
+ if (driver !== undefined)
58
+ coordinator?.remove(driver);
59
+ },
60
+ () => {
61
+ if (player !== undefined)
62
+ apply(playerDispose, player, []);
63
+ }
64
+ ]) {
65
+ try {
66
+ cleanup();
67
+ }
68
+ catch (cause) {
69
+ first ??= { code: 'ANIMATION_CLEANUP_FAILED', clockTickId: port?.clock.tickId ?? 0, cause };
70
+ try {
71
+ port?.captureCleanup(cause);
72
+ }
73
+ catch {
74
+ /* Preserve the primary transition outcome. */
75
+ }
76
+ }
77
+ }
78
+ if (first !== undefined)
79
+ remember(record, first);
80
+ return first;
81
+ }
82
+ function assertControl(record) {
83
+ const port = record.port;
84
+ if (port === undefined || terminal(record.state))
85
+ throw new EgretError('ANIMATION_TERMINAL');
86
+ assertNotCapturing(port);
87
+ port.assertOpen();
88
+ record.scope.assertOpen();
89
+ if (record.busy)
90
+ throw new EgretError('ANIMATION_REENTRANT');
91
+ return port;
92
+ }
93
+ function snapshot(record) {
94
+ return Object.freeze({
95
+ state: record.state,
96
+ isDisposed: terminal(record.state),
97
+ elapsedSeconds: record.elapsed,
98
+ positionSeconds: record.position,
99
+ playIndex: record.play,
100
+ rate: record.rate,
101
+ totalPlays: record.totalPlays,
102
+ lastSample: record.lastSample,
103
+ pendingCommands: record.pending.length,
104
+ committedEventCount: record.eventCount,
105
+ lastIssue: record.lastIssue
106
+ });
107
+ }
108
+ function begin(record) {
109
+ return {
110
+ state: record.state,
111
+ elapsed: record.elapsed,
112
+ position: record.position,
113
+ play: record.play,
114
+ rate: record.rate,
115
+ baseline: record.baseline,
116
+ applyTarget: false,
117
+ consumed: 0,
118
+ terminalCommand: false,
119
+ events: []
120
+ };
121
+ }
122
+ function appendEvents(record, candidate, to, source, includeStart = false, includeComplete = true) {
123
+ const events = planEvents(record.duration, record.totalPlays, record.markers, candidate.elapsed, to, { includeStart, includeComplete }, 1024 - candidate.events.length);
124
+ if (!Number.isSafeInteger(record.eventCount + candidate.events.length + events.length))
125
+ throw new EgretError('ANIMATION_EVENT_SEQUENCE_LIMIT');
126
+ for (const event of events)
127
+ candidate.events.push({ event, source });
128
+ }
129
+ function move(record, candidate, to, source, replay) {
130
+ const position = locatePosition(record.duration, record.totalPlays, to);
131
+ if (replay)
132
+ appendEvents(record, candidate, to, source);
133
+ candidate.elapsed = to;
134
+ candidate.position = position.positionSeconds;
135
+ candidate.play = position.playIndex;
136
+ candidate.applyTarget = true;
137
+ if (position.complete)
138
+ candidate.state = 'completed';
139
+ }
140
+ function settle(record, candidate, now, source) {
141
+ if (now < candidate.baseline)
142
+ throw new EgretError('ANIMATION_TIME_LIMIT');
143
+ const delta = now - candidate.baseline;
144
+ candidate.baseline = now;
145
+ if (candidate.state !== 'running' || delta === 0)
146
+ return;
147
+ const distance = delta * candidate.rate;
148
+ if (!Number.isFinite(distance))
149
+ throw new EgretError('ANIMATION_TIME_LIMIT');
150
+ if (distance === 0 && candidate.rate > 0)
151
+ throw new EgretError('ANIMATION_PRECISION_LIMIT');
152
+ const end = record.totalPlays === 'infinite' ? undefined : record.duration * record.totalPlays;
153
+ const final = end !== undefined && distance >= end - candidate.elapsed;
154
+ const next = final ? end : candidate.elapsed + distance;
155
+ if (!final && distance > 0 && next <= candidate.elapsed)
156
+ throw new EgretError('ANIMATION_PRECISION_LIMIT');
157
+ move(record, candidate, next, source, true);
158
+ }
159
+ function commandCandidate(record, candidate, command, now) {
160
+ if (terminal(candidate.state))
161
+ throw new EgretError('ANIMATION_TERMINAL');
162
+ switch (command.kind) {
163
+ case 'start':
164
+ if (candidate.state !== 'idle')
165
+ throw new EgretError('ANIMATION_ALREADY_STARTED');
166
+ appendEvents(record, candidate, 0, 'start', true, false);
167
+ candidate.elapsed = 0;
168
+ candidate.position = 0;
169
+ candidate.play = 0;
170
+ candidate.baseline = now;
171
+ candidate.state = candidate.rate === 0 ? 'paused' : 'running';
172
+ candidate.applyTarget = true;
173
+ return;
174
+ case 'pause':
175
+ if (candidate.state === 'idle')
176
+ throw new EgretError('ANIMATION_NOT_STARTED');
177
+ candidate.state = 'paused';
178
+ candidate.baseline = now;
179
+ return;
180
+ case 'resume':
181
+ if (candidate.state === 'idle')
182
+ throw new EgretError('ANIMATION_NOT_STARTED');
183
+ if (candidate.state === 'running')
184
+ return;
185
+ if (candidate.rate === 0)
186
+ throw new EgretError('ANIMATION_RATE_ZERO');
187
+ candidate.state = 'running';
188
+ candidate.baseline = now;
189
+ return;
190
+ case 'rate':
191
+ candidate.rate = command.rate;
192
+ if (candidate.state === 'running' && command.rate === 0)
193
+ candidate.state = 'paused';
194
+ candidate.baseline = now;
195
+ return;
196
+ case 'seek':
197
+ if (candidate.state === 'idle')
198
+ throw new EgretError('ANIMATION_NOT_STARTED');
199
+ if (command.replay && command.time < candidate.elapsed)
200
+ throw new EgretError('ANIMATION_SEEK_BACKWARDS');
201
+ move(record, candidate, command.time, 'seek', command.replay);
202
+ candidate.baseline = now;
203
+ return;
204
+ }
205
+ }
206
+ function observeRejected(result) {
207
+ const ignore = () => { };
208
+ try {
209
+ void apply(Promise.prototype.then, result, [undefined, ignore]);
210
+ }
211
+ catch {
212
+ try {
213
+ void Promise.resolve(result).then(undefined, ignore);
214
+ }
215
+ catch {
216
+ /* Return observation cannot replace the committed callback outcome. */
217
+ }
218
+ }
219
+ }
220
+ /** Event delivery owns a short-lived borrow independent of the retired controller. */
221
+ function makeDelivery(record, port, scope, listener, events, token, initialIssue) {
222
+ let issue = initialIssue;
223
+ return {
224
+ events() {
225
+ if (listener === undefined)
226
+ return;
227
+ for (const event of events) {
228
+ if (!token.active)
229
+ break;
230
+ try {
231
+ port.assertOpen();
232
+ scope.assertOpen();
233
+ }
234
+ catch {
235
+ token.active = false;
236
+ break;
237
+ }
238
+ try {
239
+ const result = listener(event);
240
+ if (result !== undefined) {
241
+ observeRejected(result);
242
+ issue ??= { code: 'ANIMATION_CALLBACK_RETURN_INVALID', clockTickId: event.clockTickId };
243
+ }
244
+ }
245
+ catch (cause) {
246
+ issue ??= { code: 'ANIMATION_CALLBACK_FAILED', clockTickId: event.clockTickId, cause };
247
+ }
248
+ }
249
+ },
250
+ diagnostics() {
251
+ try {
252
+ if (issue === undefined)
253
+ return;
254
+ remember(record, issue);
255
+ // A prior observer can close another controller's lifetime. Keep inert
256
+ // failure evidence, but deliver ordinary profile callbacks only while live.
257
+ // Cleanup failures remain reportable during authoritative teardown.
258
+ if (issue.code !== 'ANIMATION_CLEANUP_FAILED') {
259
+ try {
260
+ port.assertOpen();
261
+ scope.assertOpen();
262
+ }
263
+ catch {
264
+ return;
265
+ }
266
+ }
267
+ port.report({ code: issue.code, phase: 'engine', severity: 'error', cause: issue.cause });
268
+ }
269
+ finally {
270
+ if (record.delivery === token)
271
+ record.delivery = undefined;
272
+ }
273
+ }
274
+ };
275
+ }
276
+ function refusal(record, port, scope, cause, tick, code) {
277
+ const issue = { code: code ?? codeOf(cause, 'ANIMATION_COMMAND_INVALID'), clockTickId: tick, cause };
278
+ remember(record, issue);
279
+ return makeDelivery(record, port, scope, undefined, [], { active: false }, issue);
280
+ }
281
+ function bindingError(cause) {
282
+ return (cause instanceof EgretError &&
283
+ [
284
+ 'SEQ_BINDING_CHANGED',
285
+ 'OBJECT_DISPOSED',
286
+ 'LEASE_RELEASED',
287
+ 'TEXTURE_DISPOSED',
288
+ 'ASSET_LEASE_RELEASED',
289
+ 'ASSET_DISPOSED',
290
+ 'BITMAP_TEXTURE_REQUIRED'
291
+ ].includes(cause.code));
292
+ }
293
+ /** Pure preparation precedes one original player apply and callback-free publication. */
294
+ function commit(record, candidate, tick, replaced) {
295
+ const port = record.port, scope = record.scope, listener = record.listener;
296
+ scope.assertOpen();
297
+ let sample = record.lastSample;
298
+ if (candidate.applyTarget) {
299
+ try {
300
+ sample = apply(playerApply, record.player, [candidate.position]);
301
+ }
302
+ catch (cause) {
303
+ const code = bindingError(cause) ? 'ANIMATION_BINDING_INVALID' : 'ANIMATION_APPLY_FAILED';
304
+ const issue = { code, clockTickId: tick, cause };
305
+ retire(record, 'faulted');
306
+ remember(record, issue);
307
+ throw new EgretError(code, { cause });
308
+ }
309
+ }
310
+ scope.assertOpen();
311
+ const events = candidate.events.map(({ event, source }, index) => Object.freeze({ ...event, source, clockTickId: tick, sequence: record.eventCount + index + 1 }));
312
+ const token = { active: true };
313
+ record.elapsed = candidate.elapsed;
314
+ record.position = candidate.position;
315
+ record.play = candidate.play;
316
+ record.rate = candidate.rate;
317
+ record.baseline = candidate.baseline;
318
+ record.state = candidate.state;
319
+ record.lastSample = sample;
320
+ record.eventCount += events.length;
321
+ if (replaced)
322
+ record.pending = [];
323
+ else
324
+ record.pending.splice(0, candidate.consumed);
325
+ record.delivery = token;
326
+ let issue;
327
+ if (candidate.terminalCommand)
328
+ issue = { code: 'ANIMATION_TERMINAL_COMMAND', clockTickId: tick };
329
+ else if (replaced)
330
+ issue = { code: 'ANIMATION_COMMANDS_REPLACED', clockTickId: tick };
331
+ if (candidate.state === 'completed') {
332
+ const cleanupIssue = retire(record, 'completed', true);
333
+ issue ??= cleanupIssue;
334
+ }
335
+ return makeDelivery(record, port, scope, listener, events, token, issue);
336
+ }
337
+ function advance(record, tick) {
338
+ if (record.port === undefined || terminal(record.state))
339
+ return undefined;
340
+ const port = record.port, scope = record.scope;
341
+ record.busy = true;
342
+ try {
343
+ scope.assertOpen();
344
+ const candidate = begin(record);
345
+ settle(record, candidate, tick.elapsedSeconds, 'clock');
346
+ if (candidate.state === 'completed')
347
+ candidate.terminalCommand = record.pending.length > 0;
348
+ else {
349
+ for (const pending of record.pending) {
350
+ if (pending.tick > tick.tickId)
351
+ break;
352
+ try {
353
+ commandCandidate(record, candidate, pending.command, tick.elapsedSeconds);
354
+ }
355
+ catch (cause) {
356
+ throw new EgretError('ANIMATION_COMMAND_INVALID', { cause });
357
+ }
358
+ candidate.consumed++;
359
+ if (terminal(candidate.state)) {
360
+ candidate.terminalCommand = record.pending.length > candidate.consumed;
361
+ break;
362
+ }
363
+ }
364
+ }
365
+ return commit(record, candidate, tick.tickId, false);
366
+ }
367
+ catch (cause) {
368
+ if (codeOf(cause, '') === 'SCOPE_CLOSED' || codeOf(cause, '') === 'ENGINE_CLOSED') {
369
+ retire(record, 'stopped');
370
+ return undefined;
371
+ }
372
+ return refusal(record, port, scope, cause, tick.tickId);
373
+ }
374
+ finally {
375
+ record.busy = false;
376
+ }
377
+ }
378
+ function execute(record, command, revision) {
379
+ const port = assertControl(record), scope = record.scope;
380
+ record.revision = revision ?? {};
381
+ const tick = port.clock.tickId;
382
+ if (mustQueue(port)) {
383
+ if (record.pending.length >= 16)
384
+ throw new EgretError('ANIMATION_COMMAND_LIMIT');
385
+ if (!Number.isSafeInteger(tick + 1))
386
+ throw new EgretError('ANIMATION_TIME_LIMIT');
387
+ record.pending.push(Object.freeze({ tick: tick + 1, command }));
388
+ return;
389
+ }
390
+ const replace = command.kind === 'seek' && !command.replay;
391
+ if (record.pending.length !== 0 && !replace)
392
+ throw new EgretError('ANIMATION_COMMANDS_PENDING');
393
+ const replaced = replace && record.pending.length !== 0;
394
+ record.busy = true;
395
+ let batch;
396
+ try {
397
+ const candidate = begin(record), now = port.clock.elapsedSeconds;
398
+ if (command.kind === 'pause' || command.kind === 'rate')
399
+ settle(record, candidate, now, 'control');
400
+ if (candidate.state === 'completed')
401
+ candidate.terminalCommand = true;
402
+ else
403
+ commandCandidate(record, candidate, command, now);
404
+ batch = commit(record, candidate, tick, replaced);
405
+ }
406
+ catch (cause) {
407
+ batch = refusal(record, port, scope, cause, tick);
408
+ record.busy = false;
409
+ deliver(port, batch);
410
+ throw cause;
411
+ }
412
+ finally {
413
+ record.busy = false;
414
+ }
415
+ deliver(port, batch);
416
+ }
417
+ function stop(record, ownedCancellation = false) {
418
+ const port = record.port, scope = record.scope;
419
+ if (port !== undefined && !ownedCancellation)
420
+ assertNotCapturing(port);
421
+ // A refused reentrant command cannot invalidate an otherwise prepared RESET.
422
+ record.revision = {};
423
+ const issue = retire(record, terminal(record.state) ? record.state : 'stopped');
424
+ if (issue !== undefined && port !== undefined && scope !== undefined)
425
+ deliver(port, makeDelivery(record, port, scope, undefined, [], { active: false }, issue));
426
+ }
427
+ function handleFor(record) {
428
+ function receiver(value) {
429
+ if (value !== handle)
430
+ throw new EgretError('ANIMATION_CONTROLLER_INVALID');
431
+ }
432
+ const handle = Object.freeze({
433
+ profile: 'egret.sequence-control/1',
434
+ start() {
435
+ receiver(this);
436
+ execute(record, Object.freeze({ kind: 'start' }));
437
+ },
438
+ pause() {
439
+ receiver(this);
440
+ execute(record, Object.freeze({ kind: 'pause' }));
441
+ },
442
+ resume() {
443
+ receiver(this);
444
+ execute(record, Object.freeze({ kind: 'resume' }));
445
+ },
446
+ setRate(rate) {
447
+ receiver(this);
448
+ const port = assertControl(record);
449
+ execute(record, captureInput(port, () => Object.freeze({ kind: 'rate', rate: admitRate(rate) })));
450
+ },
451
+ seek(request) {
452
+ receiver(this);
453
+ const port = assertControl(record);
454
+ execute(record, captureInput(port, () => captureSeek(request)));
455
+ },
456
+ stop() {
457
+ receiver(this);
458
+ stop(record);
459
+ },
460
+ dispose() {
461
+ receiver(this);
462
+ stop(record);
463
+ },
464
+ getStatus() {
465
+ receiver(this);
466
+ return snapshot(record);
467
+ }
468
+ });
469
+ resetControllers.set(handle, record);
470
+ let targets = resetTargets.get(record.target);
471
+ if (!targets) {
472
+ targets = new WeakMap();
473
+ resetTargets.set(record.target, targets);
474
+ }
475
+ targets.set(handle, record.port);
476
+ return handle;
477
+ }
478
+ const resetControllers = new WeakMap();
479
+ // Neither a terminal handle nor this registry retains its former Bitmap borrow.
480
+ const resetTargets = new WeakMap();
481
+ function requireResetRecord(value, port, bitmap) {
482
+ const record = resetControllers.get(value);
483
+ if (!record || resetTargets.get(bitmap)?.get(value) !== port)
484
+ throw new EgretError('SEQUENCE_RESET_INITIAL_INVALID');
485
+ return record;
486
+ }
487
+ /** Optional assembly only: authenticate the exact Engine, original controller and Bitmap. */
488
+ export function requireResetController(value, port, bitmap) {
489
+ const record = requireResetRecord(value, port, bitmap);
490
+ return () => record.revision;
491
+ }
492
+ /** Reserve the replacement pause revision before synchronous event delivery can reenter the slot. */
493
+ export function pauseSequenceForReplacement(value, port, bitmap, revision) {
494
+ execute(requireResetRecord(value, port, bitmap), { kind: 'pause' }, revision);
495
+ }
496
+ function requirePreserveRecord(value, port, bitmap) {
497
+ const record = requireResetRecord(value, port, bitmap);
498
+ if ((record.state !== 'running' && record.state !== 'paused') || record.pending.length !== 0) {
499
+ throw new EgretError('SEQUENCE_RESET_PRESERVE_STATE');
500
+ }
501
+ assertControl(record);
502
+ return record;
503
+ }
504
+ export function requireSequencePreserveSource(value, port, bitmap) {
505
+ const record = requirePreserveRecord(value, port, bitmap);
506
+ return { clip: record.clip, totalPlays: record.totalPlays, markers: record.markers };
507
+ }
508
+ /** Stage an event-free successor at the paused source position. The slot has checked both timelines. */
509
+ export function stageSequencePreserve(port, from, fromBitmap, to, toBitmap, running) {
510
+ const source = requirePreserveRecord(from, port, fromBitmap), next = requireResetRecord(to, port, toBitmap);
511
+ assertControl(next);
512
+ if (source.state !== 'paused' || next.state !== 'idle' || source.totalPlays !== next.totalPlays) {
513
+ throw new EgretError('SEQUENCE_RESET_PRESERVE_STATE');
514
+ }
515
+ const candidate = begin(next);
516
+ candidate.elapsed = source.elapsed;
517
+ candidate.position = source.position;
518
+ candidate.play = source.play;
519
+ candidate.rate = source.rate;
520
+ candidate.state = 'paused';
521
+ candidate.applyTarget = true;
522
+ candidate.baseline = port.clock.elapsedSeconds;
523
+ commit(next, candidate, port.clock.tickId, false).diagnostics();
524
+ next.eventCount = source.eventCount;
525
+ next.listener = source.listener;
526
+ // The final window can span clock ticks. Rebase only when the subtree publishes.
527
+ return () => {
528
+ next.baseline = port.clock.elapsedSeconds;
529
+ next.state = running ? 'running' : 'paused';
530
+ };
531
+ }
532
+ /** Opt-in sequence controls share Engine ownership but never create a second timer. */
533
+ export function createSequenceController(engine, scope, bitmap, clip, options) {
534
+ const port = requireSequenceControllerEngine(engine);
535
+ const owned = port.scope(scope);
536
+ assertNotCapturing(port);
537
+ if (coordinatorSize(port) >= 256)
538
+ throw new EgretError('ANIMATION_CONTROLLER_LIMIT');
539
+ if (port.claims.size >= 256)
540
+ throw new EgretError('ANIMATION_LIMIT');
541
+ let player, coordinator, record;
542
+ try {
543
+ // Original constructor authenticates Bitmap/clip before reading clip dimensions.
544
+ player = new playerConstructor(bitmap, clip, 'once');
545
+ Object.defineProperty(player, 'dispose', { value: originalDispose, writable: false, configurable: false });
546
+ const admitted = captureInput(port, () => captureOptions(options, clip.durationSeconds));
547
+ owned.assertOpen();
548
+ if (port.claims.has(bitmap))
549
+ throw new EgretError('ANIMATION_TARGET_BUSY');
550
+ coordinator = requireCoordinator(port);
551
+ record = {
552
+ port,
553
+ scope: owned,
554
+ coordinator,
555
+ driver: undefined,
556
+ player,
557
+ clip,
558
+ target: bitmap,
559
+ claimed: false,
560
+ claimToken: {},
561
+ abort: undefined,
562
+ duration: clip.durationSeconds,
563
+ totalPlays: admitted.totalPlays,
564
+ markers: admitted.markers,
565
+ listener: admitted.listener,
566
+ state: 'idle',
567
+ elapsed: 0,
568
+ position: 0,
569
+ play: 0,
570
+ rate: admitted.rate,
571
+ baseline: port.clock.elapsedSeconds,
572
+ lastSample: undefined,
573
+ eventCount: 0,
574
+ lastIssue: undefined,
575
+ pending: [],
576
+ busy: false,
577
+ revision: {},
578
+ delivery: undefined
579
+ };
580
+ player = undefined;
581
+ const current = record;
582
+ const handle = handleFor(current);
583
+ const driver = {
584
+ advance: (tick) => advance(current, tick),
585
+ stop: () => stop(current, true)
586
+ };
587
+ current.driver = driver;
588
+ owned.use(current.player);
589
+ owned.use(handle);
590
+ current.abort = () => stop(current, true);
591
+ owned.add(current.abort);
592
+ owned.assertOpen();
593
+ port.claims.acquire(bitmap, current.claimToken);
594
+ current.claimed = true;
595
+ coordinator.add(driver);
596
+ return handle;
597
+ }
598
+ catch (cause) {
599
+ if (record !== undefined)
600
+ retire(record, 'stopped');
601
+ else if (player !== undefined) {
602
+ try {
603
+ apply(playerDispose, player, []);
604
+ }
605
+ catch (cleanupCause) {
606
+ port.captureCleanup(cleanupCause);
607
+ }
608
+ }
609
+ try {
610
+ coordinator?.discardIfEmpty();
611
+ }
612
+ catch (cleanupCause) {
613
+ port.captureCleanup(cleanupCause);
614
+ }
615
+ throw cause;
616
+ }
617
+ }
618
+ //# sourceMappingURL=sequenceController.js.map
@@ -0,0 +1,26 @@
1
+ import type { GameClockTick } from '../gameClockTypes.js';
2
+ import type { SequenceControllerEnginePort } from '../internal/sequenceControllerFactoryState.js';
3
+ export interface SequenceDelivery {
4
+ events(): void;
5
+ diagnostics(): void;
6
+ }
7
+ export interface SequenceDriver {
8
+ advance(tick: GameClockTick): SequenceDelivery | undefined;
9
+ stop(): void;
10
+ }
11
+ export interface SequenceCoordinator {
12
+ readonly size: number;
13
+ add(driver: SequenceDriver): void;
14
+ remove(driver: SequenceDriver): void;
15
+ discardIfEmpty(): void;
16
+ }
17
+ /** User getters cannot masquerade as an ordinary callback command boundary. */
18
+ export declare function assertNotCapturing(port: SequenceControllerEnginePort): void;
19
+ export declare function captureInput<T>(port: SequenceControllerEnginePort, callback: () => T): T;
20
+ export declare function mustQueue(port: SequenceControllerEnginePort): boolean;
21
+ export declare function protectedDelivery<T>(port: SequenceControllerEnginePort, callback: () => T): T;
22
+ export declare function deliver(port: SequenceControllerEnginePort, delivery: SequenceDelivery | undefined): void;
23
+ export declare function coordinatorSize(port: SequenceControllerEnginePort): number;
24
+ /** One authentic subscription serves all live controllers, never the first caller's Scope. */
25
+ export declare function requireCoordinator(port: SequenceControllerEnginePort): SequenceCoordinator;
26
+ //# sourceMappingURL=sequenceCoordinator.d.ts.map