@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,503 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { DisplayObject, DisplayObjectContainer, EgretError, Event, createEventType } from '@egret/runtime';
3
+ import { requireMouseInputEngine } from './internal/mouseInputFactoryState.js';
4
+ import { captureUiInputDelivery } from './internal/uiFactoryState.js';
5
+ const getter = (prototype, key) => Object.getOwnPropertyDescriptor(prototype, key).get;
6
+ const parent = getter(DisplayObject.prototype, 'parent'), visible = getter(DisplayObject.prototype, 'visible');
7
+ const touch = getter(DisplayObject.prototype, 'touchEnabled'), children = getter(DisplayObjectContainer.prototype, 'touchChildren');
8
+ const reasons = Object.freeze([
9
+ 'target',
10
+ 'outside',
11
+ 'contact',
12
+ 'pointercancel',
13
+ 'owner',
14
+ 'viewport',
15
+ 'blur',
16
+ 'hidden',
17
+ 'pagehide',
18
+ 'suspended',
19
+ 'dispose',
20
+ 'error'
21
+ ]);
22
+ const finite = (value) => typeof value === 'number' && Number.isFinite(value);
23
+ const count = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
24
+ /**
25
+ * Hover and wheel routing over the display tree of a started Engine. It holds no contact: a press
26
+ * belongs to the pointer input, and a pointer that presses stops hovering until it is released.
27
+ */
28
+ export function createHoverInput(options) {
29
+ if (options === null || typeof options !== 'object' || Array.isArray(options))
30
+ throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
31
+ const engine = options.engine;
32
+ let owner = requireMouseInputEngine(engine);
33
+ const deliver = captureUiInputDelivery(engine);
34
+ let scope = owner.scope(options.scope);
35
+ const width = options.width, height = options.height, maxNodes = options.maxNodes ?? 4096, capacity = options.capacity ?? 4;
36
+ let onHover = options.onHover, onWheel = options.onWheel;
37
+ if (!finite(width) ||
38
+ width <= 0 ||
39
+ !finite(height) ||
40
+ height <= 0 ||
41
+ !Number.isInteger(maxNodes) ||
42
+ maxNodes < 1 ||
43
+ maxNodes > 65536 ||
44
+ !Number.isInteger(capacity) ||
45
+ capacity < 1 ||
46
+ capacity > 16 ||
47
+ (onHover !== undefined && typeof onHover !== 'function') ||
48
+ (onWheel !== undefined && typeof onWheel !== 'function'))
49
+ throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
50
+ owner.assertReady();
51
+ scope.assertOpen();
52
+ let operations = owner.operations;
53
+ const events = Object.freeze({
54
+ enter: createEventType('egret.pointer.enter', { bubbles: true, cancelable: false }),
55
+ move: createEventType('egret.pointer.hover', { bubbles: true, cancelable: false }),
56
+ leave: createEventType('egret.pointer.leave', {
57
+ bubbles: true,
58
+ cancelable: false
59
+ }),
60
+ wheel: createEventType('egret.pointer.wheel', { bubbles: true, cancelable: true })
61
+ });
62
+ const entries = new Map();
63
+ const closers = new Set();
64
+ // Late subscribers to the same stream. They see what happened; they cannot fail it.
65
+ const listeners = new Set();
66
+ let input, state = 'active', closed = false, releaseEngine;
67
+ let revision = 0, sequence = 0, observedTime = 0, sampling = 0, calls = 0, failure;
68
+ const eligible = (target) => {
69
+ if (owner === undefined || scope === undefined || operations === undefined)
70
+ return false;
71
+ try {
72
+ owner.assertReady();
73
+ scope.assertOpen();
74
+ }
75
+ catch {
76
+ return false;
77
+ }
78
+ if (!operations.isAttached(target, maxNodes) || Reflect.apply(touch, target, []) !== true)
79
+ return false;
80
+ let node = target, visited = 0;
81
+ while (node !== undefined) {
82
+ if (++visited > maxNodes)
83
+ throw new EgretError('HIT_TEST_TREE_LIMIT');
84
+ if (Reflect.apply(visible, node, []) !== true)
85
+ return false;
86
+ if (node !== target && Reflect.apply(children, node, []) !== true)
87
+ return false;
88
+ node = Reflect.apply(parent, node, []);
89
+ }
90
+ return true;
91
+ };
92
+ function closeNative() {
93
+ if (closed)
94
+ return;
95
+ closed = true;
96
+ releaseEngine?.();
97
+ releaseEngine = undefined;
98
+ scope?.remove(retire);
99
+ const callbacks = [...closers];
100
+ closers.clear();
101
+ let first, failed = false;
102
+ const cleanup = [];
103
+ for (const callback of callbacks)
104
+ try {
105
+ callback();
106
+ }
107
+ catch (cause) {
108
+ if (!failed) {
109
+ first = cause;
110
+ failed = true;
111
+ }
112
+ else
113
+ cleanup.push(cause);
114
+ }
115
+ owner = undefined;
116
+ scope = undefined;
117
+ operations = undefined;
118
+ onHover = undefined;
119
+ onWheel = undefined;
120
+ listeners.clear();
121
+ if (failed)
122
+ throw new EgretError('HOVER_INPUT_CLEANUP_FAILED', { cause: first, cleanupErrors: cleanup });
123
+ }
124
+ /** Every public operation: the first failure of a callback is kept, and a closed input lets go of the Engine. */
125
+ function invoke(operation) {
126
+ let value, first, failed = false;
127
+ calls++;
128
+ try {
129
+ value = operation();
130
+ }
131
+ catch (cause) {
132
+ failed = true;
133
+ first = cause;
134
+ }
135
+ finally {
136
+ calls--;
137
+ }
138
+ if (calls === 0) {
139
+ failure = undefined;
140
+ if (state === 'closed')
141
+ try {
142
+ closeNative();
143
+ }
144
+ catch (cause) {
145
+ if (failed)
146
+ throw new EgretError('HOVER_INPUT_CALLBACK_FAILED', { cause: first, cleanupErrors: [cause] });
147
+ throw cause;
148
+ }
149
+ }
150
+ if (failed)
151
+ throw first;
152
+ return value;
153
+ }
154
+ function stamp(value) {
155
+ if (!Number.isSafeInteger(sequence + 1))
156
+ throw new EgretError('HOVER_INPUT_EXHAUSTED');
157
+ return Object.freeze({ ...value, sequence: ++sequence, viewportRevision: revision });
158
+ }
159
+ /** One observation: the observer first, then the target path while the target can still be reached. */
160
+ function publish(kind, point, target, reason, related) {
161
+ deliver(() => {
162
+ const notification = Object.freeze({
163
+ kind,
164
+ point,
165
+ target,
166
+ ...(reason === undefined ? {} : { reason }),
167
+ ...(related === undefined ? {} : { related })
168
+ });
169
+ try {
170
+ onHover?.(notification);
171
+ if (operations === undefined || !eligible(target))
172
+ return;
173
+ const other = related === undefined ? {} : { related };
174
+ if (kind === 'leave')
175
+ operations.dispatch(target, Object.freeze(new Event(events.leave, Object.freeze({ ...point, reason: reason, ...other }))), maxNodes);
176
+ else if (kind === 'enter')
177
+ operations.dispatch(target, Object.freeze(new Event(events.enter, related === undefined ? point : Object.freeze({ ...point, ...other }))), maxNodes);
178
+ else
179
+ operations.dispatch(target, Object.freeze(new Event(events.move, point)), maxNodes);
180
+ }
181
+ finally {
182
+ // Told whatever the target path did, so that a subscriber never keeps a hover the input has dropped.
183
+ for (const listener of [...listeners])
184
+ try {
185
+ listener(notification);
186
+ }
187
+ catch {
188
+ /* isolated */
189
+ }
190
+ }
191
+ });
192
+ }
193
+ // A failed callback closes the input. What was hovered is told once, with every later failure kept apart.
194
+ function fail(cause) {
195
+ if (failure !== undefined)
196
+ throw failure;
197
+ state = 'closed';
198
+ const pending = [...entries.values()];
199
+ entries.clear();
200
+ const cleanupErrors = [];
201
+ for (const entry of pending) {
202
+ if (entry.target === undefined)
203
+ continue;
204
+ try {
205
+ publish('leave', stamp({ ...entry.point }), entry.target, 'error');
206
+ }
207
+ catch (error) {
208
+ cleanupErrors.push(error);
209
+ }
210
+ }
211
+ failure = new EgretError('HOVER_INPUT_CALLBACK_FAILED', { cause, cleanupErrors });
212
+ throw failure;
213
+ }
214
+ function guarded(action) {
215
+ try {
216
+ const value = action();
217
+ if (failure !== undefined)
218
+ throw failure;
219
+ return value;
220
+ }
221
+ catch (cause) {
222
+ return fail(cause);
223
+ }
224
+ }
225
+ function pick(x, y) {
226
+ return guarded(() => {
227
+ owner.assertReady();
228
+ scope.assertOpen();
229
+ const target = operations.pick(x, y, maxNodes);
230
+ return target === undefined || !eligible(target) ? undefined : target;
231
+ });
232
+ }
233
+ /** Moves one pointer from what it was over to what it is over now. */
234
+ function settle(id, entry, point, next, reason) {
235
+ const previous = entry.target;
236
+ entry.point = point;
237
+ if (previous === next) {
238
+ if (next !== undefined)
239
+ guarded(() => publish('move', point, next));
240
+ return;
241
+ }
242
+ // Over nothing while the old target is told: a listener that ends this hover must not leave a target that was never entered.
243
+ entry.target = undefined;
244
+ if (previous !== undefined)
245
+ guarded(() => publish('leave', point, previous, reason, next));
246
+ // A leave listener may have removed this pointer or closed the input.
247
+ if (next === undefined || state !== 'active' || entries.get(id) !== entry || entry.point !== point)
248
+ return;
249
+ entry.target = next;
250
+ guarded(() => publish('enter', point, next, undefined, previous));
251
+ }
252
+ function drop(id, reason) {
253
+ const entry = entries.get(id);
254
+ if (entry === undefined)
255
+ return false;
256
+ entries.delete(id);
257
+ if (entry.target !== undefined) {
258
+ const target = entry.target;
259
+ guarded(() => publish('leave', stamp({ ...entry.point }), target, reason));
260
+ }
261
+ return true;
262
+ }
263
+ function dropAll(reason) {
264
+ for (const id of [...entries.keys()])
265
+ if (state !== 'closed' || reason === 'dispose')
266
+ drop(id, reason);
267
+ }
268
+ // A callback run by an operation may close the input behind a check made before it.
269
+ function isClosed() {
270
+ return state === 'closed';
271
+ }
272
+ function checkReason(reason) {
273
+ if (!reasons.includes(reason))
274
+ throw new EgretError('HOVER_INPUT_REASON');
275
+ }
276
+ /** A sample may not arrive while another sample or wheel is being routed. */
277
+ function exclusive(action) {
278
+ if (sampling !== 0)
279
+ throw new EgretError('HOVER_INPUT_REENTRANT');
280
+ sampling++;
281
+ try {
282
+ return action();
283
+ }
284
+ finally {
285
+ sampling--;
286
+ }
287
+ }
288
+ function retire() {
289
+ invoke(() => {
290
+ if (state === 'closed')
291
+ return;
292
+ state = 'closed';
293
+ try {
294
+ dropAll('dispose');
295
+ }
296
+ finally {
297
+ entries.clear();
298
+ }
299
+ });
300
+ }
301
+ input = Object.freeze({
302
+ get state() {
303
+ return state;
304
+ },
305
+ events,
306
+ width,
307
+ height,
308
+ get viewportRevision() {
309
+ return revision;
310
+ },
311
+ get hovers() {
312
+ return Object.freeze([...entries.values()].map(entry => Object.freeze({ point: entry.point, target: entry.target })));
313
+ },
314
+ sample: (sample) => invoke(() => exclusive(() => {
315
+ let pointerId, pointerType, globalX, globalY, timestamp;
316
+ try {
317
+ if (sample === null || typeof sample !== 'object')
318
+ throw new EgretError('HOVER_INPUT_SAMPLE');
319
+ ({ pointerId, pointerType, globalX, globalY, timestamp } = sample);
320
+ }
321
+ catch (cause) {
322
+ if (cause instanceof EgretError)
323
+ throw cause;
324
+ throw new EgretError('HOVER_INPUT_SAMPLE', { cause });
325
+ }
326
+ if (!count(pointerId) ||
327
+ (pointerType !== 'mouse' && pointerType !== 'pen') ||
328
+ !finite(globalX) ||
329
+ !finite(globalY) ||
330
+ !finite(timestamp) ||
331
+ timestamp < 0 ||
332
+ timestamp < observedTime)
333
+ throw new EgretError('HOVER_INPUT_SAMPLE');
334
+ if (state !== 'active')
335
+ return undefined;
336
+ let entry = entries.get(pointerId);
337
+ if (entry !== undefined && entry.point.pointerType !== pointerType)
338
+ throw new EgretError('HOVER_INPUT_SAMPLE');
339
+ if (entry === undefined && entries.size >= capacity)
340
+ throw new EgretError('HOVER_INPUT_CAPACITY');
341
+ const next = pick(globalX, globalY);
342
+ if (state !== 'active')
343
+ return undefined;
344
+ const point = stamp({ pointerId, pointerType, globalX, globalY, timestamp });
345
+ observedTime = timestamp;
346
+ // The pick may have run a callback that removed this pointer; it then arrives afresh.
347
+ entry = entries.get(pointerId);
348
+ if (entry === undefined) {
349
+ entry = { point, target: undefined };
350
+ entries.set(pointerId, entry);
351
+ }
352
+ // What it was over may have left the stage since: that is the owner's doing, not the pointer's.
353
+ const reason = entry.target !== undefined && entry.target !== next && !guarded(() => eligible(entry.target))
354
+ ? 'owner'
355
+ : 'target';
356
+ settle(pointerId, entry, point, next, reason);
357
+ return state === 'active' && entries.get(pointerId) === entry ? entry.target : undefined;
358
+ })),
359
+ leave: (pointerId, reason) => invoke(() => {
360
+ checkReason(reason);
361
+ return state === 'closed' ? false : drop(pointerId, reason);
362
+ }),
363
+ leaveAll: (reason) => invoke(() => {
364
+ checkReason(reason);
365
+ if (state !== 'closed')
366
+ dropAll(reason);
367
+ }),
368
+ wheel: (sample) => invoke(() => exclusive(() => {
369
+ let globalX, globalY, deltaX, deltaY, deltaZ, unit, timestamp, zoom;
370
+ try {
371
+ if (sample === null || typeof sample !== 'object')
372
+ throw new EgretError('HOVER_INPUT_SAMPLE');
373
+ ({ globalX, globalY, deltaX, deltaY, deltaZ, unit, timestamp, zoom } = sample);
374
+ }
375
+ catch (cause) {
376
+ if (cause instanceof EgretError)
377
+ throw cause;
378
+ throw new EgretError('HOVER_INPUT_SAMPLE', { cause });
379
+ }
380
+ if (!finite(globalX) ||
381
+ !finite(globalY) ||
382
+ !finite(deltaX) ||
383
+ !finite(deltaY) ||
384
+ (deltaZ !== undefined && !finite(deltaZ)) ||
385
+ (unit !== 'pixel' && unit !== 'line' && unit !== 'page') ||
386
+ !finite(timestamp) ||
387
+ timestamp < 0 ||
388
+ timestamp < observedTime ||
389
+ (zoom !== undefined && typeof zoom !== 'boolean'))
390
+ throw new EgretError('HOVER_INPUT_SAMPLE');
391
+ if (state !== 'active')
392
+ return false;
393
+ const target = pick(globalX, globalY);
394
+ if (state !== 'active')
395
+ return false;
396
+ const point = stamp({
397
+ globalX,
398
+ globalY,
399
+ deltaX,
400
+ deltaY,
401
+ ...(deltaZ === undefined ? {} : { deltaZ }),
402
+ unit,
403
+ timestamp,
404
+ ...(zoom === undefined ? {} : { zoom })
405
+ });
406
+ observedTime = timestamp;
407
+ return guarded(() => {
408
+ let consumed = false;
409
+ deliver(() => {
410
+ if (target !== undefined && eligible(target))
411
+ consumed = !operations.dispatch(target, Object.freeze(new Event(events.wheel, point)), maxNodes);
412
+ if (onWheel?.(Object.freeze({ point, target, consumed })) === true)
413
+ consumed = true;
414
+ });
415
+ return consumed;
416
+ });
417
+ })),
418
+ sync: () => invoke(() => exclusive(() => {
419
+ if (state !== 'active')
420
+ return;
421
+ for (const [id, entry] of [...entries]) {
422
+ if (state !== 'active')
423
+ return;
424
+ if (entries.get(id) !== entry)
425
+ continue;
426
+ const next = pick(entry.point.globalX, entry.point.globalY);
427
+ if (state !== 'active' || entries.get(id) !== entry || next === entry.target)
428
+ continue;
429
+ const reason = entry.target !== undefined && !guarded(() => eligible(entry.target)) ? 'owner' : 'target';
430
+ settle(id, entry, stamp({
431
+ pointerId: id,
432
+ pointerType: entry.point.pointerType,
433
+ globalX: entry.point.globalX,
434
+ globalY: entry.point.globalY,
435
+ timestamp: entry.point.timestamp
436
+ }), next, reason);
437
+ }
438
+ })),
439
+ setViewportRevision: (next) => invoke(() => {
440
+ if (!count(next) || next <= revision)
441
+ throw new EgretError('HOVER_INPUT_VIEWPORT');
442
+ if (state === 'closed')
443
+ return;
444
+ // What was hovered is told under the old mapping; only later samples use the new one.
445
+ dropAll('viewport');
446
+ if (!isClosed())
447
+ revision = next;
448
+ }),
449
+ setInteractive: (interactive) => invoke(() => {
450
+ if (typeof interactive !== 'boolean')
451
+ throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
452
+ if (state === 'closed')
453
+ return;
454
+ if (interactive)
455
+ state = 'active';
456
+ else {
457
+ state = 'suspended';
458
+ dropAll('suspended');
459
+ }
460
+ }),
461
+ observe: (listener) => {
462
+ if (typeof listener !== 'function')
463
+ throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
464
+ if (closed)
465
+ return () => { };
466
+ listeners.add(listener);
467
+ return () => {
468
+ listeners.delete(listener);
469
+ };
470
+ },
471
+ onClose: (listener) => {
472
+ if (typeof listener !== 'function')
473
+ throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
474
+ if (closed) {
475
+ listener();
476
+ return () => { };
477
+ }
478
+ closers.add(listener);
479
+ return () => {
480
+ closers.delete(listener);
481
+ };
482
+ },
483
+ dispose: retire
484
+ });
485
+ try {
486
+ releaseEngine = owner.onClose(retire);
487
+ scope.add(retire);
488
+ scope.use(input);
489
+ owner.assertReady();
490
+ scope.assertOpen();
491
+ return input;
492
+ }
493
+ catch (cause) {
494
+ try {
495
+ retire();
496
+ }
497
+ catch (cleanup) {
498
+ throw new EgretError('HOVER_INPUT_SETUP_FAILED', { cause, cleanupErrors: [cleanup] });
499
+ }
500
+ throw cause;
501
+ }
502
+ }
503
+ //# sourceMappingURL=hoverInput.js.map
@@ -0,0 +1,119 @@
1
+ import type { DisplayObject, EventType, Scope } from '@egret/runtime';
2
+ import type { Engine } from './Engine.js';
3
+ /** Pointers that can be over the scene without pressing it. A finger cannot. */
4
+ export type HoverPointerType = 'mouse' | 'pen';
5
+ export type HoverInputState = 'active' | 'suspended' | 'closed';
6
+ /**
7
+ * Why a target stopped being hovered: the pointer went to another target or to none, left the
8
+ * surface, pressed, or was cancelled by the platform; the target stopped being a possible target;
9
+ * the mapping of the surface changed; the window or the page went away; or the input was
10
+ * suspended, disposed or failed.
11
+ */
12
+ export type HoverLeaveReason = 'target' | 'outside' | 'contact' | 'pointercancel' | 'owner' | 'viewport' | 'blur' | 'hidden' | 'pagehide' | 'suspended' | 'dispose' | 'error';
13
+ export type WheelUnit = 'pixel' | 'line' | 'page';
14
+ export interface HoverSample {
15
+ readonly pointerId: number;
16
+ readonly pointerType: HoverPointerType;
17
+ readonly globalX: number;
18
+ readonly globalY: number;
19
+ readonly timestamp: number;
20
+ }
21
+ /** A retained value: sequence orders every hover and wheel observation of this input. */
22
+ export interface HoverPoint extends HoverSample {
23
+ readonly sequence: number;
24
+ readonly viewportRevision: number;
25
+ }
26
+ /** A point of an enter or a leave, with the other end of the movement when there is one. */
27
+ export interface HoverTransition extends HoverPoint {
28
+ /** On an enter, what the pointer left in the same movement. On a leave, what it is going to. */
29
+ readonly related?: DisplayObject;
30
+ }
31
+ export interface WheelSample {
32
+ readonly globalX: number;
33
+ readonly globalY: number;
34
+ readonly deltaX: number;
35
+ readonly deltaY: number;
36
+ readonly deltaZ?: number;
37
+ /** What one unit of the deltas is. The host reports it; nothing is converted. */
38
+ readonly unit: WheelUnit;
39
+ readonly timestamp: number;
40
+ /** The platform's zoom modifier was held, as a pinch on a trackpad also reports. */
41
+ readonly zoom?: boolean;
42
+ }
43
+ export interface WheelPoint extends WheelSample {
44
+ readonly sequence: number;
45
+ readonly viewportRevision: number;
46
+ }
47
+ export interface HoverNotification {
48
+ readonly kind: 'enter' | 'move' | 'leave';
49
+ readonly point: HoverPoint;
50
+ /** On a leave, the object that is no longer hovered, even when it has left the stage. */
51
+ readonly target: DisplayObject;
52
+ readonly reason?: HoverLeaveReason;
53
+ /** On an enter, what the pointer left in the same movement. On a leave, what it is going to. */
54
+ readonly related?: DisplayObject;
55
+ }
56
+ export interface WheelNotification {
57
+ readonly point: WheelPoint;
58
+ readonly target: DisplayObject | undefined;
59
+ /** A listener on the target path prevented the default. */
60
+ readonly consumed: boolean;
61
+ }
62
+ export interface HoverInputOptions {
63
+ readonly engine: Engine;
64
+ readonly scope: Scope;
65
+ readonly width: number;
66
+ readonly height: number;
67
+ readonly maxNodes?: number;
68
+ /** Pointers that may hover at once. Defaults to 4. */
69
+ readonly capacity?: number;
70
+ /** Runs before the target path of each enter, move and leave. */
71
+ readonly onHover?: (notification: HoverNotification) => void;
72
+ /** Runs after the target path of a wheel. Returning true consumes a wheel nothing else consumed. */
73
+ readonly onWheel?: (notification: WheelNotification) => boolean | void;
74
+ }
75
+ export interface HoverInputEvents {
76
+ readonly enter: EventType<HoverTransition>;
77
+ readonly move: EventType<HoverPoint>;
78
+ readonly leave: EventType<HoverTransition & {
79
+ readonly reason: HoverLeaveReason;
80
+ }>;
81
+ readonly wheel: EventType<WheelPoint>;
82
+ }
83
+ export interface HoverState {
84
+ readonly point: HoverPoint;
85
+ readonly target: DisplayObject | undefined;
86
+ }
87
+ /** Scope-owned hover and wheel routing for an explicitly supplied logical host stream. */
88
+ export interface HoverInput {
89
+ readonly state: HoverInputState;
90
+ readonly events: HoverInputEvents;
91
+ readonly width: number;
92
+ readonly height: number;
93
+ readonly viewportRevision: number;
94
+ /** One entry for each pointer that is over the surface, in order of arrival. */
95
+ readonly hovers: readonly HoverState[];
96
+ /** Where an unpressed pointer is. Returns what it is over now. */
97
+ sample(sample: HoverSample): DisplayObject | undefined;
98
+ leave(pointerId: number, reason: HoverLeaveReason): boolean;
99
+ leaveAll(reason: HoverLeaveReason): void;
100
+ /** Routes one wheel step. Returns whether it was consumed. */
101
+ wheel(sample: WheelSample): boolean;
102
+ /** Picks again where each pointer rests, after the scene changed under it. */
103
+ sync(): void;
104
+ setViewportRevision(revision: number): void;
105
+ setInteractive(interactive: boolean): void;
106
+ /**
107
+ * Every enter, move and leave from now on, each after its target path has run. A failure of
108
+ * the listener is kept from the input and from the other listeners. Returns a function that
109
+ * removes it.
110
+ */
111
+ observe(listener: (notification: HoverNotification) => void): () => void;
112
+ /**
113
+ * Runs the listener once when the input has closed, after what was hovered has been left. A
114
+ * listener added later runs at once. Returns a function that removes it.
115
+ */
116
+ onClose(listener: () => void): () => void;
117
+ dispose(): void;
118
+ }
119
+ //# sourceMappingURL=hoverInputTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=hoverInputTypes.js.map
@@ -0,0 +1,49 @@
1
+ export { Engine } from './Engine.js';
2
+ export type { EngineOptions } from './Engine.js';
3
+ export type { GameClockOptions, GameClockState, GameClockTick, GameClockHandler, GameClock, GameClockSubscription } from './gameClockTypes.js';
4
+ export type { Tween, TweenState, TweenOptions, TweenEasing } from './tweenTypes.js';
5
+ export type { AssetGroup, AssetGroupState, AssetGroupOptions } from './assetGroupTypes.js';
6
+ export { createEngine } from './createEngine.js';
7
+ export { createEngineForProfile } from './createEngineForProfile.js';
8
+ export { animate } from './motion.js';
9
+ export type { Motion, MotionEasing, MotionEasingName, MotionState } from './motion.js';
10
+ export { describeErrorCode, setErrorLanguage, getErrorLanguage } from '@egret/runtime';
11
+ export type { ErrorLanguage } from '@egret/runtime';
12
+ export { CancellationController, EgretError, Event, createEventType, EventDispatcher, DisplayObject, DisplayObjectContainer, Scope, Stage } from '@egret/runtime';
13
+ export type { EgretErrorOptions, EventType, EventTypeOptions, EventPhase, EventListenerOptions, ScopeState } from '@egret/runtime';
14
+ export type { CoordinateQueryOptions } from '@egret/runtime';
15
+ export type { BoundsQueryOptions } from '@egret/runtime';
16
+ export type { HitTestOptions } from '@egret/runtime';
17
+ export type { Point2D } from '@egret/contracts';
18
+ export type { CancellationListener, CancellationSignal, Disposable, Releasable, ScopeValue, Diagnostic, DiagnosticHandler, HostAdapter } from '@egret/contracts';
19
+ export { AssetManager, AssetLease, createAssetType, createAssetRef } from '@egret/runtime';
20
+ export type { AssetProvider, AssetAcquireOptions, AssetLoadContext, AssetType, AssetRef } from '@egret/runtime';
21
+ export { Sprite, Graphics } from '@egret/runtime';
22
+ export type { Matrix2D, Rectangle2D, ClipRectangle2D } from '@egret/contracts';
23
+ export { IMAGE_LIMITS_2D, createImageData2D, isImageData2D, copyImageData2DPixels } from '@egret/contracts';
24
+ export type { ImageData2DInput, ImageData2D, TextureRegion2D } from '@egret/contracts';
25
+ export { createTexturedGeometry2D, isTexturedGeometry2D } from '@egret/contracts';
26
+ export type { TexturedFloatArray2D, TexturedIndexArray2D, TexturedGeometry2DInput, TexturedGeometry2D } from '@egret/contracts';
27
+ export { createSharedMaterial2D, createSharedGeometry2D } from '@egret/contracts';
28
+ export type { SharedMaterialInput2D, SharedMaterial2D, SharedFloatArray2D, SharedIndexArray2D, SharedGeometryInput2D, SharedGeometry2D, TextureViewRegionInput2D, TextureViewRegion2D } from '@egret/contracts';
29
+ export { SHARED_FRAME_PROFILE_2D } from '@egret/contracts';
30
+ export type { SharedFrameProfile2D, SharedOutputAlpha2D, SharedFrameOptions2D, SharedPage2D, SharedRegion2D, SharedDrawState2D, SharedRectangleCommand2D, SharedImageCommand2D, SharedMeshCommand2D, SharedBarrierCommand2D, SharedEffect2D, SharedGlow2D, SharedRenderCommand2D, SharedRenderFrame2D, SharedRenderHostAdapter } from '@egret/contracts';
31
+ export { Texture, createTexture, createTextureView, isTexture, Bitmap, Mesh2D } from '@egret/runtime';
32
+ export { createSequenceClip, SequencePlayer } from '@egret/runtime';
33
+ export type { SequenceFrameInput, SequenceClipInput, SequenceClip, SequenceRegion, SequenceSample, SequencePlaybackMode } from '@egret/runtime';
34
+ export { ByteReader, BYTE_READER_LIMITS } from '@egret/runtime';
35
+ export type { ByteOrder } from '@egret/runtime';
36
+ export { ByteWriter, BYTE_WRITER_LIMITS } from '@egret/runtime';
37
+ export { createNineSliceGeometry2D } from '@egret/runtime';
38
+ export type { NineSliceInsets2D, NineSliceGeometry2DOptions } from '@egret/runtime';
39
+ export { NineSliceBitmap } from '@egret/runtime';
40
+ export type { NineSliceBitmapOptions } from '@egret/runtime';
41
+ export type { SequencePlayback, SequencePlaybackState, SequencePlaybackOptions } from './sequencePlaybackTypes.js';
42
+ export { createSpriteSheet } from '@egret/runtime';
43
+ export type { SpriteSheet, SpriteSheetFrameInput } from '@egret/runtime';
44
+ export type { BitmapResourceSlot, BitmapResourceSlotState } from './bitmapResourceSlot.js';
45
+ export type { BitmapBindingTicket } from './bitmapBindingTicket.js';
46
+ export type { AtlasFrameLayout } from '@egret/runtime';
47
+ export type { DisplaySubtreeTicket } from './displaySubtreeTicket.js';
48
+ export type { RenderEffect2D, RenderGlow2D, RenderOutline2D } from '@egret/runtime';
49
+ //# sourceMappingURL=index.d.ts.map