@egret/engine 0.0.0-stage → 7.0.2

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 (601) 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 +469 -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 +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -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 +17 -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 +47 -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 +246 -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 +31 -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 +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -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 +419 -0
  57. package/dist/cameraTypes.d.ts +126 -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 +35 -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 +45 -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 +39 -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 +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -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 +142 -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 +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -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 +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -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 +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -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 +41 -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 +300 -0
  145. package/dist/particleTypes.d.ts +115 -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 +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -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 +379 -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 +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -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 +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -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 +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
package/dist/timer.js ADDED
@@ -0,0 +1,119 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Timers on the Engine's clock, for code that used Egret's Timer and setTimeout. They count the clock's seconds, so
3
+ // they stop while the clock is paused and keep pace with a game run by hand. A timer ends with its scope.
4
+ import { EgretError } from '@egret/runtime';
5
+ const invalid = () => new EgretError('TIMER_OPTIONS_INVALID');
6
+ /** The shortest delay: shorter ones would call more times in a frame than a frame should hold. */
7
+ const SHORTEST = 0.001;
8
+ const seconds = (value) => {
9
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < SHORTEST)
10
+ throw invalid();
11
+ return value;
12
+ };
13
+ const count = (value) => {
14
+ if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0)
15
+ throw invalid();
16
+ return value;
17
+ };
18
+ /**
19
+ * A timer: `createTimer(engine, scope, 1, 5).onTimer(n => …).onComplete(() => …).start()`. A frame longer than the
20
+ * delay makes as many calls as the delay fits into it, so a count of seconds stays right however the frames fall.
21
+ */
22
+ export function createTimer(engine, scope, delay, repeatCount = 0) {
23
+ let every = seconds(delay), limit = count(repeatCount), done = 0, owed = 0, subscription;
24
+ const ticks = [], ends = [];
25
+ const halt = () => {
26
+ subscription?.dispose();
27
+ subscription = undefined;
28
+ };
29
+ const timer = {
30
+ get delay() {
31
+ return every;
32
+ },
33
+ set delay(value) {
34
+ every = seconds(value);
35
+ },
36
+ get repeatCount() {
37
+ return limit;
38
+ },
39
+ set repeatCount(value) {
40
+ limit = count(value);
41
+ },
42
+ get currentCount() {
43
+ return done;
44
+ },
45
+ get running() {
46
+ return subscription !== undefined && !subscription.isDisposed;
47
+ },
48
+ onTimer(callback) {
49
+ if (typeof callback !== 'function')
50
+ throw invalid();
51
+ ticks.push(callback);
52
+ return timer;
53
+ },
54
+ onComplete(callback) {
55
+ if (typeof callback !== 'function')
56
+ throw invalid();
57
+ ends.push(callback);
58
+ return timer;
59
+ },
60
+ start() {
61
+ if (timer.running || (limit > 0 && done >= limit))
62
+ return timer;
63
+ subscription = engine.clock.onTick(scope, tick => {
64
+ owed += tick.deltaSeconds;
65
+ // A callback may stop, reset or restart the timer, or change its delay.
66
+ while (owed >= every && timer.running) {
67
+ owed -= every;
68
+ done++;
69
+ for (const callback of [...ticks])
70
+ callback(done);
71
+ if (limit > 0 && done >= limit && timer.running) {
72
+ halt();
73
+ owed = 0;
74
+ for (const callback of [...ends])
75
+ callback();
76
+ }
77
+ }
78
+ return undefined;
79
+ });
80
+ return timer;
81
+ },
82
+ stop() {
83
+ halt();
84
+ owed = 0;
85
+ return timer;
86
+ },
87
+ reset() {
88
+ halt();
89
+ done = 0;
90
+ owed = 0;
91
+ return timer;
92
+ }
93
+ };
94
+ return timer;
95
+ }
96
+ /** Calls a function once, `seconds` from now on the Engine's clock, as Egret's setTimeout. */
97
+ export function after(engine, scope, seconds, callback) {
98
+ if (typeof callback !== 'function')
99
+ throw invalid();
100
+ let done = false;
101
+ const timer = createTimer(engine, scope, seconds, 1)
102
+ .onComplete(() => {
103
+ done = true;
104
+ callback();
105
+ })
106
+ .start();
107
+ return {
108
+ get done() {
109
+ return done;
110
+ },
111
+ cancel() {
112
+ if (!done) {
113
+ done = true;
114
+ timer.stop();
115
+ }
116
+ }
117
+ };
118
+ }
119
+ //# sourceMappingURL=timer.js.map
@@ -0,0 +1,15 @@
1
+ import { Scope } from '@egret/runtime';
2
+ import type { GameClock } from './gameClockTypes.js';
3
+ import type { Tween } from './tweenTypes.js';
4
+ export interface TweenContext {
5
+ assertOpen(): void;
6
+ isEngineScope(scope: unknown): scope is Scope;
7
+ readonly clock: GameClock;
8
+ }
9
+ export interface TweenOwner {
10
+ create(scope: unknown, options: unknown): Tween;
11
+ close(): void;
12
+ }
13
+ /** Private Engine assembly; live records alone belong to the owner inventory. */
14
+ export declare function createTweenOwner(context: TweenContext): TweenOwner;
15
+ //# sourceMappingURL=tween.d.ts.map
package/dist/tween.js ADDED
@@ -0,0 +1,329 @@
1
+ import { EgretError, Scope } from '@egret/runtime';
2
+ const scopeState = Object.getOwnPropertyDescriptor(Scope.prototype, 'state').get;
3
+ const scopeUse = Scope.prototype.use;
4
+ /** Engine identity and captured Scope operations outrank public field overrides. */
5
+ function assertLifetime(context, scope) {
6
+ context.assertOpen();
7
+ if (!context.isEngineScope(scope))
8
+ throw new EgretError('TWEEN_SCOPE_INVALID');
9
+ if (Reflect.apply(scopeState, scope, []) !== 'open')
10
+ throw new EgretError('SCOPE_CLOSED');
11
+ }
12
+ function readOption(options, key, context, scope) {
13
+ let value;
14
+ try {
15
+ value = options[key];
16
+ }
17
+ catch (cause) {
18
+ throw new EgretError('TWEEN_OPTIONS_INVALID', { cause });
19
+ }
20
+ // A throwing getter keeps its own cause; only successful reads recheck lives.
21
+ assertLifetime(context, scope);
22
+ return value;
23
+ }
24
+ /** Admission snapshots six fields once; the caller's object never enters a record. */
25
+ function admitOptions(context, scope, options) {
26
+ if (options === null || typeof options !== 'object')
27
+ throw new EgretError('TWEEN_OPTIONS_INVALID');
28
+ let isArray;
29
+ try {
30
+ isArray = Array.isArray(options);
31
+ }
32
+ catch (cause) {
33
+ throw new EgretError('TWEEN_OPTIONS_INVALID', { cause });
34
+ }
35
+ if (isArray)
36
+ throw new EgretError('TWEEN_OPTIONS_INVALID');
37
+ const from = readOption(options, 'from', context, scope);
38
+ const to = readOption(options, 'to', context, scope);
39
+ const durationSeconds = readOption(options, 'durationSeconds', context, scope);
40
+ const easingValue = readOption(options, 'easing', context, scope);
41
+ const onUpdate = readOption(options, 'onUpdate', context, scope);
42
+ const onComplete = readOption(options, 'onComplete', context, scope);
43
+ if (typeof from !== 'number' || !Number.isFinite(from) || typeof to !== 'number' || !Number.isFinite(to))
44
+ throw new EgretError('TWEEN_OPTIONS_INVALID');
45
+ const normalizedFrom = from === 0 ? 0 : from;
46
+ const normalizedTo = to === 0 ? 0 : to;
47
+ const difference = normalizedTo - normalizedFrom;
48
+ if (!Number.isFinite(difference))
49
+ throw new EgretError('TWEEN_RANGE_INVALID');
50
+ if (typeof durationSeconds !== 'number' || !Number.isFinite(durationSeconds) || durationSeconds <= 0)
51
+ throw new EgretError('TWEEN_OPTIONS_INVALID');
52
+ const easing = easingValue === undefined ? 'linear' : easingValue;
53
+ if (easing !== 'linear' && easing !== 'quadIn' && easing !== 'quadOut' && easing !== 'quadInOut')
54
+ throw new EgretError('TWEEN_OPTIONS_INVALID');
55
+ if (typeof onUpdate !== 'function' || (onComplete !== undefined && typeof onComplete !== 'function'))
56
+ throw new EgretError('TWEEN_OPTIONS_INVALID');
57
+ // Frozen scalars contain no callback borrows. The temporary admission object
58
+ // is copied into mutable record fields, never captured by a handle or handler.
59
+ return {
60
+ scalars: Object.freeze({ from: normalizedFrom, to: normalizedTo, difference, durationSeconds, easing }),
61
+ onUpdate: onUpdate,
62
+ onComplete: onComplete
63
+ };
64
+ }
65
+ function makeRecord(context, scope, admitted) {
66
+ return {
67
+ context,
68
+ scalars: admitted.scalars,
69
+ scope,
70
+ owner: undefined,
71
+ subscription: undefined,
72
+ onUpdate: admitted.onUpdate,
73
+ onComplete: admitted.onComplete,
74
+ state: 'idle',
75
+ elapsedSeconds: 0,
76
+ progress: 0,
77
+ value: admitted.scalars.from,
78
+ anchor: 0,
79
+ runBase: 0,
80
+ callbackBusy: false
81
+ };
82
+ }
83
+ function isTerminal(state) {
84
+ return state === 'completed' || state === 'stopped' || state === 'failed';
85
+ }
86
+ /** Retire once; stop/close always wins over a later failure of the active writer. */
87
+ function retire(record, terminal) {
88
+ if (isTerminal(record.state))
89
+ return;
90
+ record.state = terminal;
91
+ record.onUpdate = undefined;
92
+ record.onComplete = undefined;
93
+ record.scope = undefined;
94
+ const subscription = record.subscription;
95
+ record.subscription = undefined;
96
+ const owner = record.owner;
97
+ record.owner = undefined;
98
+ owner?.delete(record);
99
+ // Genuine frozen subscriptions release only their own clock registration.
100
+ subscription?.dispose();
101
+ }
102
+ function scopeIsOpen(record) {
103
+ const scope = record.scope;
104
+ return scope !== undefined && record.context.isEngineScope(scope) && Reflect.apply(scopeState, scope, []) === 'open';
105
+ }
106
+ /** Forbidden asynchronous results are observed without becoming an idle barrier. */
107
+ function observeRejectedResult(result) {
108
+ const ignoreRejection = () => { };
109
+ try {
110
+ void Reflect.apply(Promise.prototype.then, result, [undefined, ignoreRejection]);
111
+ }
112
+ catch {
113
+ try {
114
+ void Promise.resolve(result).then(undefined, ignoreRejection);
115
+ }
116
+ catch {
117
+ /* Observation cannot replace TWEEN_CALLBACK_RETURN_INVALID. */
118
+ }
119
+ }
120
+ }
121
+ function invokeCallback(callback, args, code) {
122
+ try {
123
+ const result = Reflect.apply(callback, undefined, args);
124
+ if (result !== undefined) {
125
+ // Choose the primary cause before any hostile thenable observation runs.
126
+ const cause = new EgretError('TWEEN_CALLBACK_RETURN_INVALID');
127
+ observeRejectedResult(result);
128
+ throw cause;
129
+ }
130
+ }
131
+ catch (cause) {
132
+ // The existing clock alone adds its diagnostic and CLOCK_CALLBACK_FAILED.
133
+ throw new EgretError(code, { cause });
134
+ }
135
+ }
136
+ function easedProgress(progress, easing) {
137
+ switch (easing) {
138
+ case 'linear':
139
+ return progress;
140
+ case 'quadIn':
141
+ return progress * progress;
142
+ case 'quadOut':
143
+ return progress * (2 - progress);
144
+ case 'quadInOut':
145
+ return progress < 0.5 ? 2 * progress * progress : 1 - 2 * (1 - progress) * (1 - progress);
146
+ }
147
+ }
148
+ function advanceTween(record, tick) {
149
+ if (record.state !== 'running')
150
+ return undefined;
151
+ try {
152
+ record.context.assertOpen();
153
+ // Scope cancellation enters closing before reverse cleanup. An abort
154
+ // listener may reach a new tick in that interval; it must not call a writer.
155
+ if (!scopeIsOpen(record)) {
156
+ retire(record, 'stopped');
157
+ return undefined;
158
+ }
159
+ const delta = tick.elapsedSeconds - record.anchor;
160
+ if (delta <= 0)
161
+ return undefined; // A fresh same-tick anchor offers nothing.
162
+ if (!Number.isFinite(delta))
163
+ throw new EgretError('TWEEN_TIME_RANGE');
164
+ const { from, to, difference, durationSeconds, easing } = record.scalars;
165
+ // The run base stays fixed until resume. Add the whole anchored interval,
166
+ // never that interval to a prior offer, and cap before an overflowing sum.
167
+ const remaining = durationSeconds - record.runBase;
168
+ const final = delta >= remaining;
169
+ const elapsed = final ? durationSeconds : record.runBase + delta;
170
+ if (!final && (!Number.isFinite(elapsed) || elapsed <= record.elapsedSeconds))
171
+ throw new EgretError('TWEEN_TIME_RANGE');
172
+ const progress = final ? 1 : elapsed / durationSeconds;
173
+ const value = final ? to : from + difference * easedProgress(progress, easing);
174
+ if (!Number.isFinite(value))
175
+ throw new EgretError('TWEEN_RANGE_INVALID');
176
+ // Offers are observations, not proof of setter success. Failures preserve
177
+ // these committed scalars and any application side effects without replay.
178
+ record.elapsedSeconds = elapsed;
179
+ record.progress = progress;
180
+ record.value = value;
181
+ const writer = record.onUpdate;
182
+ record.callbackBusy = true;
183
+ invokeCallback(writer, [value], 'TWEEN_UPDATE_FAILED');
184
+ if (record.state !== 'running')
185
+ return undefined;
186
+ record.context.assertOpen();
187
+ if (!scopeIsOpen(record)) {
188
+ retire(record, 'stopped');
189
+ return undefined;
190
+ }
191
+ if (final) {
192
+ // Release record-held writer/completion/subscription borrows before the
193
+ // local completion invocation. Its busy flag still refuses own controls.
194
+ const completion = record.onComplete;
195
+ retire(record, 'completed');
196
+ if (completion !== undefined)
197
+ invokeCallback(completion, [], 'TWEEN_COMPLETE_FAILED');
198
+ }
199
+ return undefined;
200
+ }
201
+ catch (cause) {
202
+ retire(record, 'failed');
203
+ throw cause;
204
+ }
205
+ finally {
206
+ record.callbackBusy = false;
207
+ }
208
+ }
209
+ /** This closure captures only the mutable record, never an admission snapshot. */
210
+ function makeTickHandler(record) {
211
+ return (tick) => advanceTween(record, tick);
212
+ }
213
+ function assertControl(record) {
214
+ record.context.assertOpen();
215
+ if (record.callbackBusy)
216
+ throw new EgretError('TWEEN_REENTRANT');
217
+ if (isTerminal(record.state))
218
+ throw new EgretError('TWEEN_TERMINAL');
219
+ }
220
+ function startTween(record) {
221
+ assertControl(record);
222
+ if (record.state !== 'idle')
223
+ throw new EgretError('TWEEN_ALREADY_STARTED');
224
+ // Capacity and genuine Scope adoption happen before running/anchor commit.
225
+ // Refusal retains an idle handle, which can retry after a slot is released.
226
+ const subscription = record.context.clock.onTick(record.scope, makeTickHandler(record));
227
+ record.subscription = subscription;
228
+ record.runBase = 0;
229
+ record.anchor = record.context.clock.elapsedSeconds;
230
+ record.state = 'running';
231
+ }
232
+ function pauseTween(record) {
233
+ assertControl(record);
234
+ if (record.state === 'idle')
235
+ throw new EgretError('TWEEN_NOT_STARTED');
236
+ if (record.state === 'running')
237
+ record.state = 'paused';
238
+ }
239
+ function resumeTween(record) {
240
+ assertControl(record);
241
+ if (record.state === 'idle')
242
+ throw new EgretError('TWEEN_NOT_STARTED');
243
+ if (record.state === 'paused') {
244
+ record.runBase = record.elapsedSeconds;
245
+ record.anchor = record.context.clock.elapsedSeconds;
246
+ record.state = 'running';
247
+ }
248
+ }
249
+ /** Frozen own facades keep cached observations and check every receiver. */
250
+ function makeHandle(record) {
251
+ function assertReceiver(receiver) {
252
+ if (receiver !== tween)
253
+ throw new EgretError('TWEEN_INVALID');
254
+ }
255
+ const tween = Object.freeze({
256
+ get state() {
257
+ assertReceiver(this);
258
+ return record.state;
259
+ },
260
+ get isDisposed() {
261
+ assertReceiver(this);
262
+ return isTerminal(record.state);
263
+ },
264
+ get elapsedSeconds() {
265
+ assertReceiver(this);
266
+ return record.elapsedSeconds;
267
+ },
268
+ get progress() {
269
+ assertReceiver(this);
270
+ return record.progress;
271
+ },
272
+ get value() {
273
+ assertReceiver(this);
274
+ return record.value;
275
+ },
276
+ start() {
277
+ assertReceiver(this);
278
+ startTween(record);
279
+ },
280
+ pause() {
281
+ assertReceiver(this);
282
+ pauseTween(record);
283
+ },
284
+ resume() {
285
+ assertReceiver(this);
286
+ resumeTween(record);
287
+ },
288
+ stop() {
289
+ assertReceiver(this);
290
+ retire(record, 'stopped');
291
+ },
292
+ dispose() {
293
+ assertReceiver(this);
294
+ retire(record, 'stopped');
295
+ }
296
+ });
297
+ return tween;
298
+ }
299
+ /** Private Engine assembly; live records alone belong to the owner inventory. */
300
+ export function createTweenOwner(context) {
301
+ const records = new Set();
302
+ return Object.freeze({
303
+ create(scope, options) {
304
+ assertLifetime(context, scope);
305
+ const admitted = admitOptions(context, scope, options);
306
+ const record = makeRecord(context, scope, admitted);
307
+ const tween = makeHandle(record);
308
+ try {
309
+ Reflect.apply(scopeUse, scope, [tween]);
310
+ }
311
+ catch (cause) {
312
+ retire(record, 'stopped');
313
+ throw cause;
314
+ }
315
+ // The frozen idle handle is intrinsically owned before owner publication;
316
+ // no callback/subscription or caller work intervenes in this commit.
317
+ record.owner = records;
318
+ records.add(record);
319
+ return tween;
320
+ },
321
+ close() {
322
+ // Engine closing synchronously terminalizes idle, running and paused
323
+ // handles. Its existing clock/frame barriers own later resource cleanup.
324
+ for (const record of records)
325
+ retire(record, 'stopped');
326
+ }
327
+ });
328
+ }
329
+ //# sourceMappingURL=tween.js.map
@@ -0,0 +1,31 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ /** The easing a tween uses. */
3
+ export type TweenEasing = 'linear' | 'quadIn' | 'quadOut' | 'quadInOut';
4
+ /** Whether a tween is idle, running, paused, completed, stopped or failed. */
5
+ export type TweenState = 'idle' | 'running' | 'paused' | 'completed' | 'stopped' | 'failed';
6
+ /** A tween to make: from and to which number, for how long, with which easing, and what it calls. */
7
+ export interface TweenOptions {
8
+ readonly from: number;
9
+ readonly to: number;
10
+ readonly durationSeconds: number;
11
+ readonly easing?: TweenEasing;
12
+ readonly onUpdate: (value: number) => undefined;
13
+ readonly onComplete?: () => undefined;
14
+ }
15
+ declare const tweenBrand: unique symbol;
16
+ /** A number tweened on the game clock: start, pause, resume and stop it, and read its value. */
17
+ export interface Tween extends Disposable {
18
+ readonly [tweenBrand]: true;
19
+ readonly state: TweenState;
20
+ readonly isDisposed: boolean;
21
+ readonly elapsedSeconds: number;
22
+ readonly progress: number;
23
+ readonly value: number;
24
+ start(): void;
25
+ pause(): void;
26
+ resume(): void;
27
+ stop(): void;
28
+ dispose(): void;
29
+ }
30
+ export {};
31
+ //# sourceMappingURL=tweenTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=tweenTypes.js.map
@@ -0,0 +1,113 @@
1
+ import type { DisplayObject, EventType } from '@egret/runtime';
2
+ import type { KeyboardCancelPayload, KeyboardKeyPayload } from '../keyboardInputTypes.js';
3
+ /**
4
+ * The usual keys of the controls an application draws itself.
5
+ *
6
+ * A binding listens for the keys the keyboard input delivers to one display object and calls the
7
+ * control a pointer already reaches. It adds no host listener and moves no focus. A key that a
8
+ * display object below has taken, and a key held with Alt, Control or the platform key, is left
9
+ * alone.
10
+ */
11
+ /** The keyboard input, or anything that delivers its three key events. */
12
+ export interface ControlKeysSource {
13
+ readonly events: {
14
+ readonly keyDown: EventType<KeyboardKeyPayload>;
15
+ readonly keyUp: EventType<KeyboardKeyPayload>;
16
+ readonly cancel: EventType<KeyboardCancelPayload>;
17
+ };
18
+ }
19
+ interface ControlKeysTarget {
20
+ readonly keyboard: ControlKeysSource;
21
+ /** The display object that takes the focus, or one above it: keys rise through the tree. */
22
+ readonly target: DisplayObject;
23
+ }
24
+ /** Space or Enter, released, activates. A hold that loses the focus activates nothing. */
25
+ export interface ActionKeysOptions extends ControlKeysTarget {
26
+ readonly kind: 'action';
27
+ readonly control: {
28
+ readonly enabled: boolean;
29
+ press(): void;
30
+ release(): void;
31
+ };
32
+ readonly onPressChange?: (pressed: boolean) => void;
33
+ }
34
+ /** Keys for a toggle: which kind of toggle, the control, and what is called when its press changes. */
35
+ export interface ToggleKeysOptions extends ControlKeysTarget {
36
+ readonly kind: 'toggle';
37
+ readonly control: {
38
+ readonly enabled: boolean;
39
+ toggle(): void;
40
+ };
41
+ readonly onPressChange?: (pressed: boolean) => void;
42
+ }
43
+ /** The field opens when the key is released, so that the key types nothing into it. */
44
+ export interface TextFieldKeysOptions extends ControlKeysTarget {
45
+ readonly kind: 'textField';
46
+ readonly control: {
47
+ readonly enabled: boolean;
48
+ edit(): boolean;
49
+ };
50
+ readonly onPressChange?: (pressed: boolean) => void;
51
+ }
52
+ /** Arrow keys move the selection, Home and End go to its ends. A held key repeats. */
53
+ export interface SelectionKeysOptions extends ControlKeysTarget {
54
+ readonly kind: 'selection';
55
+ readonly control: {
56
+ readonly enabled: boolean;
57
+ next(): boolean;
58
+ previous(): boolean;
59
+ first(): boolean;
60
+ last(): boolean;
61
+ };
62
+ /** Which arrow keys move it. Defaults to 'both'. */
63
+ readonly orientation?: 'horizontal' | 'vertical' | 'both';
64
+ }
65
+ /** The arrow keys of its axis, Page Up, Page Down, Home and End. A key that moved nothing is left to whatever is outside. */
66
+ export interface ScrollKeysOptions extends ControlKeysTarget {
67
+ readonly kind: 'scroll';
68
+ readonly control: {
69
+ readonly enabled: boolean;
70
+ readonly axis: 'x' | 'y';
71
+ line(direction: 1 | -1): boolean;
72
+ page(direction: 1 | -1): boolean;
73
+ toStart(): boolean;
74
+ toEnd(): boolean;
75
+ };
76
+ }
77
+ /** Arrow keys move the value by one step, Page Up and Page Down by a page of steps, Home and End go to its ends. A held key repeats. */
78
+ export interface RangeKeysOptions extends ControlKeysTarget {
79
+ readonly kind: 'range';
80
+ readonly control: {
81
+ readonly enabled: boolean;
82
+ stepBy(steps: number): boolean;
83
+ toMin(): boolean;
84
+ toMax(): boolean;
85
+ };
86
+ /** Which arrow keys move it: Right and Left, Up and Down, or all four. Defaults to 'both'. Right and Up raise the value. */
87
+ readonly orientation?: 'horizontal' | 'vertical' | 'both';
88
+ /** How many steps Page Up and Page Down move. Defaults to 10. */
89
+ readonly page?: number;
90
+ }
91
+ /** The keys that are down give the direction; opposite keys cancel each other. */
92
+ export interface MovementKeysOptions extends ControlKeysTarget {
93
+ readonly kind: 'movement';
94
+ readonly control: {
95
+ readonly enabled: boolean;
96
+ setDirection(x: number, y: number): void;
97
+ };
98
+ /** Arrow keys, the W A S D positions of the keyboard, or both. Defaults to 'both'. */
99
+ readonly keys?: 'arrows' | 'wasd' | 'both';
100
+ readonly onPressChange?: (pressed: boolean) => void;
101
+ }
102
+ /** Keys for one control: an action, a toggle, a text field or a selection group. */
103
+ export type ControlKeysOptions = ActionKeysOptions | ToggleKeysOptions | TextFieldKeysOptions | SelectionKeysOptions | ScrollKeysOptions | RangeKeysOptions | MovementKeysOptions;
104
+ /** Keys bound to a control: which are pressed now; dispose of it to unbind them. */
105
+ export interface ControlKeys {
106
+ /** Whether a key of this binding is held: an activation that waits for its release, or a direction. */
107
+ readonly pressed: boolean;
108
+ dispose(): void;
109
+ }
110
+ /** Binds the keyboard to a control: Space and Enter press an action or a toggle, arrows move a selection. */
111
+ export declare function createControlKeys(options: ControlKeysOptions): ControlKeys;
112
+ export {};
113
+ //# sourceMappingURL=controlKeys.d.ts.map