@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
@@ -0,0 +1,38 @@
1
+ import type { GamepadInput, GamepadInputOptions } from '@egret/engine/input/gamepad';
2
+ /** Browser gamepad input to make: what is called on an error. */
3
+ export interface BrowserGamepadInputOptions extends GamepadInputOptions {
4
+ /**
5
+ * Told what failed where nothing could be returned: in a listener of the page, or when a pad
6
+ * was asked to shake. Without it the failure is reported to the page.
7
+ */
8
+ readonly onError?: (cause: unknown) => void;
9
+ }
10
+ /** A rumble to play: how long, and how strong its weak and strong motors run. */
11
+ export interface GamepadRumble {
12
+ /** Milliseconds, up to 5000. Defaults to 200. */
13
+ readonly duration?: number;
14
+ /** The light, fast motor, 0 to 1. Defaults to 0.5. */
15
+ readonly weak?: number;
16
+ /** The heavy, slow motor, 0 to 1. Defaults to 0.5. */
17
+ readonly strong?: number;
18
+ }
19
+ /** Gamepads read from the browser: poll them each frame, and make one rumble. */
20
+ export interface BrowserGamepadInput {
21
+ readonly input: GamepadInput;
22
+ /**
23
+ * Looks at the pads of the page once. A game calls it once a frame. The timestamp is the frame's,
24
+ * in milliseconds; without it the clock of the page is read. A hidden page is not looked at.
25
+ */
26
+ poll(timestamp?: number): void;
27
+ /** Shakes a pad that can be shaken. Says whether the pad was asked to. */
28
+ rumble(pad: number, options?: GamepadRumble): boolean;
29
+ /** The same as disposing the input. A scope can own the pads of a game through this. */
30
+ dispose(): void;
31
+ }
32
+ /**
33
+ * The pads of a page. A browser tells nothing when a button goes down: it has to be asked, so the
34
+ * game asks once a frame through `poll`. Buttons are let go when the page is hidden or the window
35
+ * loses the person, because what happens to a pad then is not told either.
36
+ */
37
+ export declare function createBrowserGamepadInput(options?: BrowserGamepadInputOptions): BrowserGamepadInput;
38
+ //# sourceMappingURL=BrowserGamepadInput.d.ts.map
@@ -0,0 +1,134 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ import { createGamepadInput } from '@egret/engine/input/gamepad';
4
+ const within = (value, least, most) => typeof value === 'number' && value >= least && value <= most;
5
+ /**
6
+ * The pads of a page. A browser tells nothing when a button goes down: it has to be asked, so the
7
+ * game asks once a frame through `poll`. Buttons are let go when the page is hidden or the window
8
+ * loses the person, because what happens to a pad then is not told either.
9
+ */
10
+ export function createBrowserGamepadInput(options = {}) {
11
+ if (options === null || typeof options !== 'object' || Array.isArray(options))
12
+ throw new EgretError('GAMEPAD_OPTIONS_INVALID');
13
+ const { onError, ...configuration } = options;
14
+ if (onError !== undefined && typeof onError !== 'function')
15
+ throw new EgretError('GAMEPAD_OPTIONS_INVALID');
16
+ const host = globalThis.navigator, page = globalThis.document, win = globalThis.window;
17
+ if (host === undefined || typeof host.getGamepads !== 'function')
18
+ throw new EgretError('GAMEPAD_HOST_UNAVAILABLE');
19
+ const input = createGamepadInput(configuration);
20
+ const pairs = [];
21
+ let closed = false, last = 0;
22
+ function report(cause) {
23
+ if (onError !== undefined)
24
+ onError(cause);
25
+ else if (typeof globalThis.reportError === 'function')
26
+ globalThis.reportError(cause);
27
+ }
28
+ function listen(target, type, listener) {
29
+ if (target === undefined)
30
+ return;
31
+ target.addEventListener(type, listener);
32
+ pairs.push({ target, type, listener });
33
+ }
34
+ function cleanup() {
35
+ if (closed)
36
+ return;
37
+ closed = true;
38
+ for (const pair of pairs.splice(0).reverse())
39
+ try {
40
+ pair.target.removeEventListener(pair.type, pair.listener);
41
+ }
42
+ catch (cause) {
43
+ report(cause);
44
+ }
45
+ }
46
+ const letGo = () => {
47
+ if (closed)
48
+ return;
49
+ try {
50
+ input.release();
51
+ }
52
+ catch (cause) {
53
+ report(cause);
54
+ }
55
+ };
56
+ try {
57
+ listen(page, 'visibilitychange', event => {
58
+ if (page.visibilityState === 'hidden')
59
+ letGo(event);
60
+ });
61
+ listen(win, 'blur', letGo);
62
+ listen(win, 'pagehide', letGo);
63
+ }
64
+ catch (cause) {
65
+ cleanup();
66
+ input.dispose();
67
+ throw cause;
68
+ }
69
+ return Object.freeze({
70
+ input,
71
+ poll(timestamp) {
72
+ if (timestamp !== undefined && !within(timestamp, 0, Number.MAX_VALUE))
73
+ throw new EgretError('GAMEPAD_SAMPLE');
74
+ if (closed || input.state === 'closed' || page?.visibilityState === 'hidden')
75
+ return;
76
+ const samples = [];
77
+ for (const pad of host.getGamepads()) {
78
+ // A browser keeps a place for a pad that was taken away.
79
+ if (pad === null || pad === undefined || pad.connected === false)
80
+ continue;
81
+ samples.push({
82
+ index: pad.index,
83
+ id: pad.id,
84
+ mapping: pad.mapping,
85
+ buttons: Array.from(pad.buttons, button => ({
86
+ pressed: button.pressed,
87
+ value: Math.min(1, Math.max(0, button.value))
88
+ })),
89
+ axes: Array.from(pad.axes, axis => (Number.isFinite(axis) ? Math.min(1, Math.max(-1, axis)) : 0))
90
+ });
91
+ }
92
+ // A clock of the page may be coarse or handed in out of step: the input is never told that time went back.
93
+ last = Math.max(last, timestamp ?? globalThis.performance.now());
94
+ input.sample(samples, last);
95
+ },
96
+ rumble(index, rumble = {}) {
97
+ if (rumble === null || typeof rumble !== 'object')
98
+ throw new EgretError('GAMEPAD_OPTIONS_INVALID');
99
+ const { duration = 200, weak = 0.5, strong = 0.5 } = rumble;
100
+ if (!Number.isSafeInteger(index) ||
101
+ !within(index, 0, 31) ||
102
+ !within(duration, 0, 5000) ||
103
+ !within(weak, 0, 1) ||
104
+ !within(strong, 0, 1))
105
+ throw new EgretError('GAMEPAD_OPTIONS_INVALID');
106
+ if (closed || page?.visibilityState === 'hidden')
107
+ return false;
108
+ const pad = [...host.getGamepads()].find(candidate => candidate !== null && candidate !== undefined && candidate.index === index && candidate.connected !== false);
109
+ const actuator = pad?.vibrationActuator;
110
+ if (actuator === null || actuator === undefined || typeof actuator.playEffect !== 'function')
111
+ return false;
112
+ try {
113
+ const played = actuator.playEffect('dual-rumble', {
114
+ startDelay: 0,
115
+ duration,
116
+ weakMagnitude: weak,
117
+ strongMagnitude: strong
118
+ });
119
+ if (played !== undefined && typeof played.then === 'function')
120
+ played.then(undefined, report);
121
+ }
122
+ catch (cause) {
123
+ report(cause);
124
+ return false;
125
+ }
126
+ return true;
127
+ },
128
+ dispose() {
129
+ cleanup();
130
+ input.dispose();
131
+ }
132
+ });
133
+ }
134
+ //# sourceMappingURL=BrowserGamepadInput.js.map
@@ -0,0 +1,25 @@
1
+ import type { HoverInput, HoverInputOptions } from '@egret/engine/input/hover';
2
+ /**
3
+ * Whether a wheel over the canvas also scrolls the page: only when nothing consumed it, never
4
+ * (the canvas owns the wheel), or always (the listener is passive and cannot hold the page).
5
+ */
6
+ export type WheelPagePolicy = 'unconsumed' | 'never' | 'always';
7
+ /** Browser hover input to make: its canvas, how far a page of wheel scrolls, and what is called on an error. */
8
+ export interface BrowserHoverInputOptions extends HoverInputOptions {
9
+ /** The canvas the Engine draws on. Its CSS rectangle is mapped to the logical width and height. */
10
+ readonly canvas: HTMLCanvasElement;
11
+ /** Defaults to 'unconsumed'. */
12
+ readonly wheelPage?: WheelPagePolicy;
13
+ /**
14
+ * Told when the adapter has stopped because a callback or an event failed. The input is closed
15
+ * by then. Without it the failure is reported to the page as an uncaught error.
16
+ */
17
+ readonly onError?: (cause: unknown) => void;
18
+ }
19
+ /**
20
+ * Hover and wheel of the page for the canvas of a started Engine, in the same connected,
21
+ * untransformed profile as the pointer adapter. It captures no pointer and sets no style, so it
22
+ * shares the canvas with that adapter.
23
+ */
24
+ export declare function createBrowserHoverInput(options: BrowserHoverInputOptions): HoverInput;
25
+ //# sourceMappingURL=BrowserHoverInput.d.ts.map
@@ -0,0 +1,266 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ import { createHoverInput } from '@egret/engine/input/hover';
4
+ const ownedSurfaces = new WeakSet();
5
+ const units = ['pixel', 'line', 'page'];
6
+ const finite = (value) => typeof value === 'number' && Number.isFinite(value);
7
+ const same = (a, b) => a.left === b.left && a.top === b.top && a.width === b.width && a.height === b.height;
8
+ /**
9
+ * Hover and wheel of the page for the canvas of a started Engine, in the same connected,
10
+ * untransformed profile as the pointer adapter. It captures no pointer and sets no style, so it
11
+ * shares the canvas with that adapter.
12
+ */
13
+ export function createBrowserHoverInput(options) {
14
+ if (options === null || typeof options !== 'object' || Array.isArray(options))
15
+ throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
16
+ const { canvas: surface, wheelPage = 'unconsumed', onError, ...configuration } = options;
17
+ if ((wheelPage !== 'unconsumed' && wheelPage !== 'never' && wheelPage !== 'always') ||
18
+ (onError !== undefined && typeof onError !== 'function') ||
19
+ surface === null ||
20
+ typeof surface !== 'object')
21
+ throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
22
+ const input = createHoverInput(configuration);
23
+ const pairs = [];
24
+ let closed = false, owned;
25
+ /** A failure has nowhere to return to from a listener of the page. */
26
+ function report(cause) {
27
+ if (onError !== undefined)
28
+ onError(cause);
29
+ else if (typeof globalThis.reportError === 'function')
30
+ globalThis.reportError(cause);
31
+ }
32
+ function cleanup() {
33
+ if (closed)
34
+ return;
35
+ closed = true;
36
+ const failures = [];
37
+ for (const pair of pairs.splice(0).reverse())
38
+ try {
39
+ pair.target.removeEventListener(pair.type, pair.listener, pair.options);
40
+ }
41
+ catch (cause) {
42
+ failures.push(cause);
43
+ }
44
+ if (owned !== undefined) {
45
+ ownedSurfaces.delete(owned);
46
+ owned = undefined;
47
+ }
48
+ for (const cause of failures)
49
+ report(cause);
50
+ }
51
+ try {
52
+ input.onClose(cleanup);
53
+ const win = globalThis.window, page = globalThis.document;
54
+ if (win === undefined || page === undefined || typeof win.getComputedStyle !== 'function')
55
+ throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
56
+ const { width, height } = input;
57
+ /** The rectangle of the canvas on the page, refused unless one scale and one offset map it. */
58
+ function profile() {
59
+ if (typeof surface?.getBoundingClientRect !== 'function' ||
60
+ surface.ownerDocument !== page ||
61
+ surface.isConnected !== true)
62
+ throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
63
+ let current = surface, depth = 0;
64
+ // Ordinary ancestors only: a turn, a skew, a mirror or a zoom would need a mapping this adapter does not have.
65
+ while (current !== page) {
66
+ if (current === null || current.nodeType !== 1 || ++depth > 64)
67
+ throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
68
+ const style = win.getComputedStyle(current), read = (name) => style.getPropertyValue(name).trim();
69
+ // Moving and positive scaling keep the canvas an upright rectangle, which the bounding rectangle maps as it is.
70
+ const matrix = /^matrix\(([^)]*)\)$/.exec(read('transform'))?.[1]?.split(',').map(Number), scale = read('scale');
71
+ if ((read('transform') !== 'none' &&
72
+ !(matrix !== undefined &&
73
+ matrix.length === 6 &&
74
+ matrix.every(Number.isFinite) &&
75
+ matrix[0] > 0 &&
76
+ matrix[3] > 0 &&
77
+ matrix[1] === 0 &&
78
+ matrix[2] === 0)) ||
79
+ read('rotate') !== 'none' ||
80
+ read('perspective') !== 'none' ||
81
+ (scale !== 'none' && !scale.split(/\s+/).every(part => Number(part) > 0)))
82
+ throw new EgretError('HOVER_INPUT_SURFACE_INVALID', {
83
+ cause: new Error('the canvas or an element around it is rotated, skewed, mirrored or in perspective')
84
+ });
85
+ const zoom = read('zoom');
86
+ if (zoom !== 'normal' && zoom !== '1')
87
+ throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
88
+ if (current === surface) {
89
+ const edges = [
90
+ 'padding-top',
91
+ 'padding-right',
92
+ 'padding-bottom',
93
+ 'padding-left',
94
+ 'border-top-width',
95
+ 'border-right-width',
96
+ 'border-bottom-width',
97
+ 'border-left-width'
98
+ ];
99
+ if (read('object-fit') !== 'fill' ||
100
+ edges.some(name => {
101
+ const value = read(name);
102
+ return value !== '0px' && value !== '0';
103
+ }))
104
+ throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
105
+ }
106
+ current = current.parentNode;
107
+ }
108
+ return measure();
109
+ }
110
+ function measure() {
111
+ const { left, top, width: wide, height: high } = surface.getBoundingClientRect();
112
+ if (!finite(left) || !finite(top) || !finite(wide) || !finite(high) || wide <= 0 || high <= 0)
113
+ throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
114
+ return { left, top, width: wide, height: high };
115
+ }
116
+ let bounds = profile();
117
+ if (ownedSurfaces.has(surface))
118
+ throw new EgretError('HOVER_INPUT_SURFACE_BUSY');
119
+ ownedSurfaces.add(surface);
120
+ owned = surface;
121
+ function fail(cause) {
122
+ cleanup();
123
+ const failures = [cause];
124
+ try {
125
+ input.dispose();
126
+ }
127
+ catch (secondary) {
128
+ failures.push(secondary);
129
+ }
130
+ for (const failure of failures)
131
+ report(failure);
132
+ }
133
+ function guard(action) {
134
+ if (closed)
135
+ return;
136
+ try {
137
+ action();
138
+ }
139
+ catch (cause) {
140
+ // One pointer too many is told and the others go on hovering.
141
+ if (cause instanceof EgretError && cause.code === 'HOVER_INPUT_CAPACITY')
142
+ report(cause);
143
+ else
144
+ fail(cause);
145
+ }
146
+ }
147
+ /** What is hovered is told under the old mapping; the next movement uses the new one. */
148
+ function remap() {
149
+ const next = profile();
150
+ if (input.state !== 'closed')
151
+ input.setViewportRevision(input.viewportRevision + 1);
152
+ bounds = next;
153
+ }
154
+ function current() {
155
+ // A layout change without a resize or a scroll shows as a rectangle that moved.
156
+ if (!same(bounds, measure()))
157
+ remap();
158
+ return bounds;
159
+ }
160
+ let observed = 0;
161
+ // The platform orders its events; a clock that steps back is not passed on as a refused sample.
162
+ const time = (event) => (observed = Math.max(observed, finite(event.timeStamp) && event.timeStamp > 0 ? event.timeStamp : 0));
163
+ function place(event) {
164
+ const rect = current();
165
+ if (!finite(event.clientX) || !finite(event.clientY))
166
+ throw new EgretError('HOVER_INPUT_EVENT_INVALID');
167
+ const globalX = ((event.clientX - rect.left) * width) / rect.width, globalY = ((event.clientY - rect.top) * height) / rect.height;
168
+ return globalX >= 0 && globalY >= 0 && globalX < width && globalY < height ? { globalX, globalY } : undefined;
169
+ }
170
+ function identify(event) {
171
+ const { pointerId, pointerType } = event;
172
+ return Number.isSafeInteger(pointerId) && pointerId >= 0 && (pointerType === 'mouse' || pointerType === 'pen')
173
+ ? { pointerId, pointerType }
174
+ : undefined;
175
+ }
176
+ function hover(event) {
177
+ const identity = identify(event);
178
+ if (identity === undefined || input.state !== 'active')
179
+ return;
180
+ // A pressed pointer belongs to the contact that began with the press.
181
+ if (event.buttons !== 0) {
182
+ input.leave(identity.pointerId, 'contact');
183
+ return;
184
+ }
185
+ const point = page.visibilityState === 'visible' ? place(event) : undefined;
186
+ // A captured pointer is still reported after it has left the canvas.
187
+ if (point === undefined) {
188
+ input.leave(identity.pointerId, 'outside');
189
+ return;
190
+ }
191
+ input.sample({ ...identity, ...point, timestamp: time(event) });
192
+ }
193
+ function leave(event, reason) {
194
+ const identity = identify(event);
195
+ if (identity !== undefined && input.state !== 'closed')
196
+ input.leave(identity.pointerId, reason);
197
+ }
198
+ function wheel(event) {
199
+ const point = input.state === 'active' ? place(event) : undefined;
200
+ let consumed = false;
201
+ if (point !== undefined) {
202
+ const unit = units[event.deltaMode];
203
+ if (unit === undefined || !finite(event.deltaX) || !finite(event.deltaY) || !finite(event.deltaZ))
204
+ throw new EgretError('HOVER_INPUT_EVENT_INVALID');
205
+ consumed = input.wheel({
206
+ ...point,
207
+ deltaX: event.deltaX,
208
+ deltaY: event.deltaY,
209
+ deltaZ: event.deltaZ,
210
+ unit,
211
+ timestamp: time(event),
212
+ zoom: event.ctrlKey === true
213
+ });
214
+ }
215
+ if ((wheelPage === 'never' || (wheelPage === 'unconsumed' && consumed)) && event.cancelable)
216
+ event.preventDefault();
217
+ }
218
+ function listen(target, type, action, settings = {}) {
219
+ const listener = event => guard(() => {
220
+ if (event.type === type)
221
+ action(event);
222
+ });
223
+ const pair = { target, type, listener, options: settings };
224
+ pairs.push(pair);
225
+ target.addEventListener(type, listener, settings);
226
+ }
227
+ listen(surface, 'pointermove', event => hover(event));
228
+ listen(surface, 'pointerup', event => hover(event));
229
+ listen(surface, 'pointerdown', event => leave(event, 'contact'));
230
+ listen(surface, 'pointerleave', event => leave(event, 'outside'));
231
+ listen(surface, 'pointercancel', event => leave(event, 'pointercancel'));
232
+ // A passive listener lets the page scroll without waiting for this one. It cannot hold the page.
233
+ listen(surface, 'wheel', event => wheel(event), { passive: wheelPage === 'always' });
234
+ listen(win, 'blur', () => input.leaveAll('blur'));
235
+ listen(win, 'pagehide', () => input.leaveAll('pagehide'));
236
+ listen(page, 'visibilitychange', () => {
237
+ if (page.visibilityState !== 'visible')
238
+ input.leaveAll('hidden');
239
+ });
240
+ listen(win, 'resize', remap);
241
+ listen(win, 'orientationchange', remap);
242
+ listen(win, 'scroll', remap, { capture: true });
243
+ const viewport = win.visualViewport;
244
+ if (viewport !== null && viewport !== undefined) {
245
+ listen(viewport, 'resize', remap);
246
+ listen(viewport, 'scroll', remap);
247
+ }
248
+ // Resuming is the application's to do, once its rendering host is ready again.
249
+ listen(surface, 'webglcontextlost', () => input.setInteractive(false));
250
+ return input;
251
+ }
252
+ catch (cause) {
253
+ cleanup();
254
+ const cleanupErrors = [];
255
+ try {
256
+ input.dispose();
257
+ }
258
+ catch (secondary) {
259
+ cleanupErrors.push(secondary);
260
+ }
261
+ if (cause instanceof EgretError && cause.code === 'HOVER_INPUT_SURFACE_BUSY' && cleanupErrors.length === 0)
262
+ throw cause;
263
+ throw new EgretError('HOVER_INPUT_SURFACE_INVALID', { cause, cleanupErrors });
264
+ }
265
+ }
266
+ //# sourceMappingURL=BrowserHoverInput.js.map
@@ -0,0 +1,72 @@
1
+ import type { AssetLoadContext, AssetProvider, AssetRef, Texture } from '@egret/runtime';
2
+ /** What `textureFromCanvas` and `decodeBrowserImage` can read pixels from. */
3
+ export type BrowserImageSource = HTMLCanvasElement | OffscreenCanvas | HTMLImageElement | ImageBitmap | {
4
+ readonly width: number;
5
+ readonly height: number;
6
+ };
7
+ /** The picture formats the browser route recognises by their first bytes. */
8
+ export type BrowserImageFormat = 'png' | 'jpeg' | 'webp' | 'gif' | 'avif';
9
+ /** How the browser makes a canvas and decodes an image, for image textures. */
10
+ export interface BrowserImagePorts {
11
+ /** A fresh canvas of the given size with a 2D context that can be read back. */
12
+ readonly createCanvas: (width: number, height: number) => BrowserImageCanvas;
13
+ /** Decodes encoded bytes into something a 2D context can draw. */
14
+ readonly decode: (bytes: Uint8Array<ArrayBuffer>, type: string) => Promise<BrowserDecodedImage>;
15
+ }
16
+ /** A canvas to draw a decoded image into. */
17
+ export interface BrowserImageCanvas {
18
+ width: number;
19
+ height: number;
20
+ getContext(kind: '2d', options?: {
21
+ willReadFrequently?: boolean;
22
+ }): BrowserImageContext | null;
23
+ }
24
+ /** The drawing context of such a canvas: draw an image and read its pixels. */
25
+ export interface BrowserImageContext {
26
+ drawImage(source: unknown, x: number, y: number, width: number, height: number): void;
27
+ getImageData(x: number, y: number, width: number, height: number): {
28
+ readonly data: Uint8ClampedArray;
29
+ };
30
+ }
31
+ /** A decoded image: its source, size, and a call that releases it. */
32
+ export interface BrowserDecodedImage {
33
+ readonly source: unknown;
34
+ readonly width: number;
35
+ readonly height: number;
36
+ /** Frees what decoding held; called once the pixels are read. */
37
+ readonly release?: () => void;
38
+ }
39
+ /** How images are decoded: the largest size accepted, and the ports used. */
40
+ export interface BrowserImageOptions {
41
+ /** Largest area kept, in pixels; larger pictures are scaled down. At most the 2D image limit. */
42
+ readonly maxPixels?: number;
43
+ /** Longest edge kept, in pixels. At most the 2D image limit. */
44
+ readonly maxEdge?: number;
45
+ /** Replaces the browser operations, for tests or other hosts. */
46
+ readonly ports?: BrowserImagePorts;
47
+ }
48
+ /** Where an image texture provider reads the bytes of each image from. */
49
+ export interface BrowserImageTextureProviderOptions extends BrowserImageOptions {
50
+ /** Reads the encoded bytes a reference names. */
51
+ readonly readBytes: (ref: AssetRef<Texture>, context: AssetLoadContext) => Promise<Uint8Array<ArrayBuffer>>;
52
+ }
53
+ /** The picture format the bytes start with, or undefined when they start like none of them. */
54
+ export declare function sniffBrowserImageFormat(bytes: Uint8Array): BrowserImageFormat | undefined;
55
+ /** The size a picture is read at: its own, or scaled down evenly to fit both limits. */
56
+ export declare function fitBrowserImageSize(width: number, height: number, options?: Pick<BrowserImageOptions, 'maxPixels' | 'maxEdge'>): {
57
+ width: number;
58
+ height: number;
59
+ };
60
+ /**
61
+ * Reads a canvas, image or bitmap as a texture of straight RGBA bytes, scaled down when it is larger than
62
+ * the limits. The source is not changed.
63
+ */
64
+ export declare function textureFromCanvas(source: BrowserImageSource, options?: BrowserImageOptions): Texture;
65
+ /** Decodes PNG, JPEG, WebP, GIF or AVIF bytes with the browser and returns a texture of them. */
66
+ export declare function decodeBrowserImage(bytes: Uint8Array<ArrayBuffer>, options?: BrowserImageOptions): Promise<Texture>;
67
+ /**
68
+ * An asset provider that reads bytes with `readBytes` and decodes them with the browser. Register it for a
69
+ * texture asset type; disposing a texture releases it.
70
+ */
71
+ export declare function createBrowserImageTextureProvider(options: BrowserImageTextureProviderOptions): AssetProvider<Texture>;
72
+ //# sourceMappingURL=BrowserImageTextures.d.ts.map