@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,4 @@
1
+ import type { PointerInput, PointerInputOptions } from '#egret-pointer-input';
2
+ /** Pointer Events adapter for the explicit connected, untransformed Canvas profile. */
3
+ export declare function createBrowserPointerInput(options: PointerInputOptions): PointerInput;
4
+ //# sourceMappingURL=BrowserPointerInput.d.ts.map
@@ -0,0 +1,511 @@
1
+ import { EgretError } from '@egret/runtime';
2
+ import { bindPointerSurface, createPointerInput } from '#egret-pointer-input';
3
+ const APPLY = Reflect.apply;
4
+ const ownedSurfaces = new WeakSet();
5
+ function getter(prototype, name) {
6
+ const operation = prototype === undefined ? undefined : Object.getOwnPropertyDescriptor(prototype, name)?.get;
7
+ if (typeof operation !== 'function')
8
+ throw new EgretError('POINTER_INPUT_SURFACE_INVALID');
9
+ return operation;
10
+ }
11
+ function method(prototype, name) {
12
+ const operation = prototype === undefined ? undefined : Object.getOwnPropertyDescriptor(prototype, name)?.value;
13
+ if (typeof operation !== 'function')
14
+ throw new EgretError('POINTER_INPUT_SURFACE_INVALID');
15
+ return operation;
16
+ }
17
+ function finite(value) {
18
+ return typeof value === 'number' && Number.isFinite(value);
19
+ }
20
+ function sameRectangle(a, b) {
21
+ return a.left === b.left && a.top === b.top && a.width === b.width && a.height === b.height;
22
+ }
23
+ /** Pointer Events adapter for the explicit connected, untransformed Canvas profile. */
24
+ export function createBrowserPointerInput(options) {
25
+ if (options === null || typeof options !== 'object' || Array.isArray(options))
26
+ throw new EgretError('POINTER_INPUT_OPTIONS_INVALID');
27
+ const configuration = { ...options };
28
+ const { width, height, onContact } = configuration;
29
+ if (onContact !== undefined && typeof onContact !== 'function')
30
+ throw new EgretError('POINTER_INPUT_OPTIONS_INVALID');
31
+ const sessions = new Map();
32
+ let ownedSurface;
33
+ const pairs = [];
34
+ let closed = false;
35
+ let capturesInFlight = 0;
36
+ let releaseNative = (_id) => { };
37
+ let removePair = (_pair) => { };
38
+ let restoreStyle = () => { };
39
+ let removeClose = () => { };
40
+ let report = (_cause) => { };
41
+ function finalizeCleanup() {
42
+ if (!closed || capturesInFlight !== 0 || pairs.some(pair => pair.adding))
43
+ return;
44
+ if (ownedSurface !== undefined) {
45
+ ownedSurfaces.delete(ownedSurface);
46
+ ownedSurface = undefined;
47
+ }
48
+ pairs.length = 0;
49
+ releaseNative = () => { };
50
+ removePair = () => { };
51
+ restoreStyle = () => { };
52
+ removeClose = () => { };
53
+ report = () => { };
54
+ }
55
+ function cleanup() {
56
+ if (closed)
57
+ return;
58
+ closed = true;
59
+ const failures = [];
60
+ for (const pair of pairs.slice().reverse())
61
+ try {
62
+ removePair(pair);
63
+ }
64
+ catch (cause) {
65
+ failures.push(cause);
66
+ }
67
+ // Clear logical native ownership before release can synchronously emit lostcapture.
68
+ const ids = [...sessions.keys()];
69
+ sessions.clear();
70
+ for (const id of ids)
71
+ try {
72
+ releaseNative(id);
73
+ }
74
+ catch (cause) {
75
+ failures.push(cause);
76
+ }
77
+ try {
78
+ restoreStyle();
79
+ }
80
+ catch (cause) {
81
+ failures.push(cause);
82
+ }
83
+ try {
84
+ removeClose();
85
+ }
86
+ catch (cause) {
87
+ failures.push(cause);
88
+ }
89
+ try {
90
+ for (const cause of failures)
91
+ report(cause);
92
+ }
93
+ finally {
94
+ finalizeCleanup();
95
+ }
96
+ }
97
+ const input = createPointerInput({
98
+ ...configuration,
99
+ onContact(notification) {
100
+ const failures = [];
101
+ if (notification.kind === 'end' || notification.kind === 'cancel') {
102
+ const { session } = notification.contact;
103
+ if (sessions.get(session.pointerId) === session) {
104
+ sessions.delete(session.pointerId);
105
+ try {
106
+ releaseNative(session.pointerId);
107
+ }
108
+ catch (cause) {
109
+ failures.push(cause);
110
+ }
111
+ }
112
+ }
113
+ // Application terminal cleanup still runs if a native release operation fails.
114
+ try {
115
+ onContact?.(notification);
116
+ }
117
+ catch (cause) {
118
+ failures.push(cause);
119
+ }
120
+ if (failures.length === 1)
121
+ throw failures[0];
122
+ if (failures.length > 1)
123
+ throw new AggregateError(failures, 'Pointer notification failed');
124
+ }
125
+ });
126
+ try {
127
+ const bridge = bindPointerSurface(input);
128
+ const diagnose = bridge.report;
129
+ report = diagnose;
130
+ removeClose = bridge.onClose(cleanup);
131
+ const surface = bridge.surface;
132
+ const win = globalThis.window, document = globalThis.document;
133
+ if (win === undefined || document === undefined)
134
+ throw new EgretError('POINTER_INPUT_SURFACE_INVALID');
135
+ const canvasBrand = getter(globalThis.HTMLCanvasElement?.prototype, 'width');
136
+ const ownerDocument = getter(globalThis.Node?.prototype, 'ownerDocument');
137
+ const parentNode = getter(globalThis.Node?.prototype, 'parentNode');
138
+ const nodeType = getter(globalThis.Node?.prototype, 'nodeType');
139
+ const connected = getter(globalThis.Node?.prototype, 'isConnected');
140
+ const defaultView = getter(globalThis.Document?.prototype, 'defaultView');
141
+ const visibility = getter(globalThis.Document?.prototype, 'visibilityState');
142
+ const inlineStyle = getter(globalThis.HTMLElement?.prototype, 'style');
143
+ const styleValue = method(globalThis.CSSStyleDeclaration?.prototype, 'getPropertyValue');
144
+ const stylePriority = method(globalThis.CSSStyleDeclaration?.prototype, 'getPropertyPriority');
145
+ const styleSet = method(globalThis.CSSStyleDeclaration?.prototype, 'setProperty');
146
+ const styleRemove = method(globalThis.CSSStyleDeclaration?.prototype, 'removeProperty');
147
+ const rectangle = method(globalThis.Element?.prototype, 'getBoundingClientRect');
148
+ const rectLeft = getter(globalThis.DOMRectReadOnly?.prototype, 'left');
149
+ const rectTop = getter(globalThis.DOMRectReadOnly?.prototype, 'top');
150
+ const rectWidth = getter(globalThis.DOMRectReadOnly?.prototype, 'width');
151
+ const rectHeight = getter(globalThis.DOMRectReadOnly?.prototype, 'height');
152
+ const setCapture = method(globalThis.Element?.prototype, 'setPointerCapture');
153
+ const hasCapture = method(globalThis.Element?.prototype, 'hasPointerCapture');
154
+ const releaseCapture = method(globalThis.Element?.prototype, 'releasePointerCapture');
155
+ const add = method(globalThis.EventTarget?.prototype, 'addEventListener');
156
+ const remove = method(globalThis.EventTarget?.prototype, 'removeEventListener');
157
+ const eventType = getter(globalThis.Event?.prototype, 'type');
158
+ const timestamp = getter(globalThis.Event?.prototype, 'timeStamp');
159
+ const pointerId = getter(globalThis.PointerEvent?.prototype, 'pointerId');
160
+ const pointerType = getter(globalThis.PointerEvent?.prototype, 'pointerType');
161
+ const pressure = getter(globalThis.PointerEvent?.prototype, 'pressure');
162
+ const contactWidth = getter(globalThis.PointerEvent?.prototype, 'width');
163
+ const contactHeight = getter(globalThis.PointerEvent?.prototype, 'height');
164
+ const clientX = getter(globalThis.MouseEvent?.prototype, 'clientX');
165
+ const clientY = getter(globalThis.MouseEvent?.prototype, 'clientY');
166
+ const buttons = getter(globalThis.MouseEvent?.prototype, 'buttons');
167
+ const computedStyle = win.getComputedStyle;
168
+ if (typeof computedStyle !== 'function')
169
+ throw new EgretError('POINTER_INPUT_SURFACE_INVALID');
170
+ function assertOpen() {
171
+ if (closed || input.state === 'closed')
172
+ throw new EgretError('POINTER_INPUT_CLOSED');
173
+ }
174
+ function dom(operation, receiver, args = []) {
175
+ assertOpen();
176
+ const value = APPLY(operation, receiver, args);
177
+ assertOpen();
178
+ return value;
179
+ }
180
+ function css(style, name) {
181
+ const value = dom(styleValue, style, [name]);
182
+ if (typeof value !== 'string')
183
+ throw new EgretError('POINTER_INPUT_SURFACE_INVALID');
184
+ return value.trim();
185
+ }
186
+ // A refusal says which rule of the page's layout was broken, since the code alone cannot.
187
+ const refused = (why) => new EgretError('POINTER_INPUT_SURFACE_INVALID', { cause: new Error(why) });
188
+ /**
189
+ * Whether a computed `transform` keeps the element an upright rectangle: none, or a matrix that only moves and
190
+ * scales it by positive amounts. The bounding rectangle then still maps the pointer straight onto the canvas.
191
+ */
192
+ function upright(transform) {
193
+ if (transform === 'none')
194
+ return true;
195
+ const match = /^matrix\(([^)]*)\)$/.exec(transform);
196
+ if (!match)
197
+ return false;
198
+ const m = match[1].split(',').map(Number);
199
+ return m.length === 6 && m.every(Number.isFinite) && m[0] > 0 && m[3] > 0 && m[1] === 0 && m[2] === 0;
200
+ }
201
+ function profile() {
202
+ dom(canvasBrand, surface);
203
+ if (dom(ownerDocument, surface) !== document ||
204
+ dom(defaultView, document) !== win ||
205
+ dom(connected, surface) !== true)
206
+ throw refused('the canvas is not in this page: add it to the document before starting input');
207
+ let current = surface;
208
+ const seen = new Set();
209
+ // Ordinary ancestors only: shadow roots and anything that turns, skews or mirrors the canvas are refused.
210
+ while (current !== document) {
211
+ if (current === null ||
212
+ current === undefined ||
213
+ seen.has(current) ||
214
+ seen.size >= 64 ||
215
+ dom(nodeType, current) !== 1)
216
+ throw refused('the canvas must be inside ordinary elements of the page, at most 64 deep and not in a shadow root');
217
+ seen.add(current);
218
+ const style = dom(computedStyle, win, [current]);
219
+ const where = current === surface ? 'the canvas' : 'an element around the canvas';
220
+ if (!upright(css(style, 'transform')))
221
+ throw refused(where +
222
+ ' has a CSS transform that rotates, skews or mirrors it; only moving and positive scaling are supported');
223
+ if (css(style, 'rotate') !== 'none')
224
+ throw refused(where + ' has a CSS rotate');
225
+ if (css(style, 'perspective') !== 'none')
226
+ throw refused(where + ' has a CSS perspective');
227
+ const scale = css(style, 'scale');
228
+ if (scale !== 'none' && !scale.split(/\s+/).every(part => Number(part) > 0))
229
+ throw refused(where + ' has a CSS scale that is not positive');
230
+ const zoom = css(style, 'zoom');
231
+ if (zoom !== 'normal' && zoom !== '1')
232
+ throw refused(where + ' has a CSS zoom other than 1');
233
+ if (current === surface) {
234
+ const edges = [
235
+ 'padding-top',
236
+ 'padding-right',
237
+ 'padding-bottom',
238
+ 'padding-left',
239
+ 'border-top-width',
240
+ 'border-right-width',
241
+ 'border-bottom-width',
242
+ 'border-left-width'
243
+ ];
244
+ if (css(style, 'object-fit') !== 'fill')
245
+ throw refused('the canvas has a CSS object-fit other than fill');
246
+ if (edges.some(name => {
247
+ const value = css(style, name);
248
+ return value !== '0px' && value !== '0';
249
+ }))
250
+ throw refused('the canvas has a CSS border or padding; put them on an element around it instead');
251
+ }
252
+ current = dom(parentNode, current);
253
+ }
254
+ const value = dom(rectangle, surface);
255
+ const left = dom(rectLeft, value), top = dom(rectTop, value), width = dom(rectWidth, value), height = dom(rectHeight, value);
256
+ if (!finite(left) || !finite(top) || !finite(width) || !finite(height) || width <= 0 || height <= 0)
257
+ throw refused('the canvas has no size on the page: give it or the element around it a width and a height');
258
+ return { left, top, width, height };
259
+ }
260
+ let bounds = profile();
261
+ if (ownedSurfaces.has(surface))
262
+ throw new EgretError('POINTER_INPUT_SURFACE_BUSY');
263
+ ownedSurfaces.add(surface);
264
+ ownedSurface = surface;
265
+ releaseNative = (id) => {
266
+ if (APPLY(hasCapture, surface, [id]) === true)
267
+ APPLY(releaseCapture, surface, [id]);
268
+ };
269
+ removePair = pair => {
270
+ if (pair.adding || pair.removed)
271
+ return;
272
+ pair.removed = true;
273
+ APPLY(remove, pair.target, [pair.type, pair.listener, pair.capture]);
274
+ };
275
+ const style = dom(inlineStyle, surface);
276
+ const previousValue = dom(styleValue, style, ['touch-action']);
277
+ const previousPriority = dom(stylePriority, style, ['touch-action']);
278
+ if (typeof previousValue !== 'string' || typeof previousPriority !== 'string')
279
+ throw new EgretError('POINTER_INPUT_SURFACE_INVALID');
280
+ let styleChanged = true;
281
+ restoreStyle = () => {
282
+ if (!styleChanged)
283
+ return;
284
+ styleChanged = false;
285
+ if (previousValue === '')
286
+ APPLY(styleRemove, style, ['touch-action']);
287
+ else
288
+ APPLY(styleSet, style, ['touch-action', previousValue, previousPriority]);
289
+ };
290
+ // Set before the first pointerdown: changing touch-action during a gesture is too late.
291
+ dom(styleSet, style, ['touch-action', 'none', 'important']);
292
+ function fail(cause) {
293
+ cleanup();
294
+ try {
295
+ if (input.state !== 'closed')
296
+ input.cancelAll('error');
297
+ }
298
+ catch (secondary) {
299
+ diagnose(secondary);
300
+ }
301
+ finally {
302
+ try {
303
+ input.dispose();
304
+ }
305
+ catch (secondary) {
306
+ diagnose(secondary);
307
+ }
308
+ }
309
+ diagnose(cause);
310
+ }
311
+ function guard(action) {
312
+ if (closed)
313
+ return;
314
+ try {
315
+ action();
316
+ }
317
+ catch (cause) {
318
+ if (cause instanceof EgretError && cause.code === 'POINTER_INPUT_CAPACITY')
319
+ diagnose(cause);
320
+ else
321
+ fail(cause);
322
+ }
323
+ }
324
+ function cancel(reason) {
325
+ input.cancelAll(reason);
326
+ }
327
+ function refresh(force) {
328
+ const next = profile();
329
+ if (force || !sameRectangle(bounds, next)) {
330
+ // Cancellation uses the old revision; only fresh downs use the new mapping.
331
+ cancel('viewport');
332
+ assertOpen();
333
+ // A terminal observer may itself commit another CSS layout change.
334
+ const committed = profile();
335
+ input.setViewportRevision(input.viewportRevision + 1);
336
+ bounds = committed;
337
+ }
338
+ return bounds;
339
+ }
340
+ function identify(event) {
341
+ let id;
342
+ try {
343
+ id = APPLY(pointerId, event, []);
344
+ }
345
+ catch {
346
+ return undefined;
347
+ }
348
+ const type = APPLY(pointerType, event, []);
349
+ if (!finite(id) ||
350
+ !Number.isSafeInteger(id) ||
351
+ id < 0 ||
352
+ (type !== 'mouse' && type !== 'touch' && type !== 'pen'))
353
+ return undefined;
354
+ return { id, type };
355
+ }
356
+ function update(event, rect) {
357
+ const x = APPLY(clientX, event, []), y = APPLY(clientY, event, []);
358
+ const heldButtons = APPLY(buttons, event, []), time = APPLY(timestamp, event, []);
359
+ const p = APPLY(pressure, event, []), w = APPLY(contactWidth, event, []), h = APPLY(contactHeight, event, []);
360
+ if (!finite(x) || !finite(y) || !finite(heldButtons) || !finite(time) || !finite(p) || !finite(w) || !finite(h))
361
+ throw new EgretError('POINTER_INPUT_EVENT_INVALID');
362
+ // Map CSS coordinates once. Device pixel ratio belongs to rendering only.
363
+ return {
364
+ globalX: ((x - rect.left) * width) / rect.width,
365
+ globalY: ((y - rect.top) * height) / rect.height,
366
+ buttons: heldButtons,
367
+ timestamp: time,
368
+ pressure: p,
369
+ width: w,
370
+ height: h
371
+ };
372
+ }
373
+ function acquireNative(id, session) {
374
+ capturesInFlight++;
375
+ let failed = false, failure;
376
+ try {
377
+ dom(setCapture, surface, [id]);
378
+ }
379
+ catch (cause) {
380
+ failed = true;
381
+ failure = cause;
382
+ throw cause;
383
+ }
384
+ finally {
385
+ try {
386
+ // A controlled native operation may close/cancel before completing capture.
387
+ // Compensate after it returns, while retaining this surface's ownership.
388
+ if (closed || sessions.get(id) !== session) {
389
+ try {
390
+ if (APPLY(hasCapture, surface, [id]) === true)
391
+ APPLY(releaseCapture, surface, [id]);
392
+ }
393
+ catch (cause) {
394
+ if (failed)
395
+ throw new EgretError('POINTER_INPUT_NATIVE_FAILED', { cause: failure, cleanupErrors: [cause] });
396
+ throw cause;
397
+ }
398
+ }
399
+ }
400
+ finally {
401
+ capturesInFlight--;
402
+ finalizeCleanup();
403
+ }
404
+ }
405
+ }
406
+ function pointer(event, kind) {
407
+ const identity = identify(event);
408
+ if (identity === undefined || (kind !== 'down' && !sessions.has(identity.id)))
409
+ return;
410
+ const rect = refresh(false);
411
+ if (kind === 'down') {
412
+ if (sessions.has(identity.id) || input.state !== 'active' || dom(visibility, document) !== 'visible')
413
+ return;
414
+ const session = input.begin({ pointerId: identity.id, pointerType: identity.type, ...update(event, rect) });
415
+ // A begin observer may synchronously cancel, suspend or close the input.
416
+ if (session === undefined || closed || !input.contacts.some(contact => contact.session === session))
417
+ return;
418
+ sessions.set(identity.id, session);
419
+ acquireNative(identity.id, session);
420
+ return;
421
+ }
422
+ const session = sessions.get(identity.id);
423
+ if (session === undefined || session.pointerType !== identity.type)
424
+ return;
425
+ if (kind === 'move')
426
+ input.move(session, update(event, rect));
427
+ else if (kind === 'up')
428
+ input.end(session, update(event, rect));
429
+ else
430
+ input.cancel(session, kind === 'cancel' ? 'pointercancel' : 'lostcapture');
431
+ }
432
+ function listen(target, type, capture, action) {
433
+ assertOpen();
434
+ const listener = event => guard(() => {
435
+ if (APPLY(eventType, event, []) === type)
436
+ action(event);
437
+ });
438
+ const pair = { target, type, listener, capture, adding: true, removed: false };
439
+ pairs.push(pair);
440
+ let failed = false, failure;
441
+ try {
442
+ APPLY(add, target, [type, listener, capture]);
443
+ }
444
+ catch (cause) {
445
+ failed = true;
446
+ failure = cause;
447
+ throw cause;
448
+ }
449
+ finally {
450
+ pair.adding = false;
451
+ if (closed) {
452
+ try {
453
+ removePair(pair);
454
+ }
455
+ catch (cause) {
456
+ if (failed)
457
+ throw new EgretError('POINTER_INPUT_NATIVE_FAILED', { cause: failure, cleanupErrors: [cause] });
458
+ throw cause;
459
+ }
460
+ finally {
461
+ finalizeCleanup();
462
+ }
463
+ }
464
+ }
465
+ assertOpen();
466
+ }
467
+ listen(surface, 'pointerdown', false, event => pointer(event, 'down'));
468
+ listen(win, 'pointermove', true, event => pointer(event, 'move'));
469
+ listen(win, 'pointerup', true, event => pointer(event, 'up'));
470
+ listen(win, 'pointercancel', true, event => pointer(event, 'cancel'));
471
+ listen(surface, 'lostpointercapture', false, event => pointer(event, 'lost'));
472
+ listen(win, 'blur', false, () => cancel('blur'));
473
+ listen(win, 'pagehide', false, () => cancel('pagehide'));
474
+ listen(document, 'visibilitychange', false, () => {
475
+ if (dom(visibility, document) !== 'visible')
476
+ cancel('hidden');
477
+ });
478
+ listen(win, 'resize', false, () => {
479
+ refresh(true);
480
+ });
481
+ listen(win, 'orientationchange', false, () => {
482
+ refresh(true);
483
+ });
484
+ listen(win, 'scroll', true, () => {
485
+ refresh(true);
486
+ });
487
+ const viewport = win.visualViewport;
488
+ if (viewport !== null && viewport !== undefined) {
489
+ listen(viewport, 'resize', false, () => {
490
+ refresh(true);
491
+ });
492
+ listen(viewport, 'scroll', false, () => {
493
+ refresh(true);
494
+ });
495
+ }
496
+ // Restoration is intentionally application-owned: host readiness must precede resume.
497
+ listen(surface, 'webglcontextlost', false, () => input.setInteractive(false));
498
+ return input;
499
+ }
500
+ catch (cause) {
501
+ cleanup();
502
+ try {
503
+ input.dispose();
504
+ }
505
+ catch (secondary) {
506
+ report(secondary);
507
+ }
508
+ throw new EgretError('POINTER_INPUT_SURFACE_INVALID', { cause });
509
+ }
510
+ }
511
+ //# sourceMappingURL=BrowserPointerInput.js.map
@@ -0,0 +1,34 @@
1
+ import type { UiSemantics } from '@egret/engine/ui/semantics';
2
+ export interface BrowserSemanticsOptions {
3
+ readonly semantics: UiSemantics;
4
+ /** The canvas the Engine draws on. Its CSS rectangle is mapped to the logical width and height. */
5
+ readonly canvas: HTMLCanvasElement;
6
+ /** The logical size the bounds of the nodes are given in. */
7
+ readonly width: number;
8
+ readonly height: number;
9
+ /** The accessible name of the canvas, set only when it has none. */
10
+ readonly label?: string;
11
+ /**
12
+ * Told when an action a node performed failed, and when the adapter has stopped because the
13
+ * page refused it. Without it the failure is reported to the page as an uncaught error.
14
+ */
15
+ readonly onError?: (cause: unknown) => void;
16
+ }
17
+ export interface BrowserSemantics {
18
+ readonly state: 'active' | 'closed';
19
+ /** The element that holds the projection. It is invisible and takes no pointer. */
20
+ readonly container: HTMLElement;
21
+ /** The element a published node is projected to. */
22
+ elementOf(id: string): HTMLElement | undefined;
23
+ /** Measures the canvas again, for a layout change that came without a resize or a scroll. */
24
+ sync(): void;
25
+ dispose(): void;
26
+ }
27
+ /**
28
+ * Projects a semantic tree to the page, for assistive technology. The canvas stays the one element
29
+ * with the keyboard: it owns an invisible container of elements laid over it, one for each
30
+ * published node, and names the focused one as its active descendant. Nothing here draws, and a
31
+ * pointer goes through to the canvas.
32
+ */
33
+ export declare function createBrowserSemantics(options: BrowserSemanticsOptions): BrowserSemantics;
34
+ //# sourceMappingURL=BrowserSemantics.d.ts.map