@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,342 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Feeds named input actions from the page: keys, mouse buttons and gamepads,
3
+ // and on-screen sticks and buttons for touch screens. Every listener is taken
4
+ // off by `dispose`. A lost focus or a hidden page lets every control go, so a
5
+ // key held while the player switched windows does not stay down.
6
+ import { EgretError } from '@egret/runtime';
7
+ // The standard gamepad layout, by button number.
8
+ const PAD_BUTTONS = [
9
+ 'a',
10
+ 'b',
11
+ 'x',
12
+ 'y',
13
+ 'leftShoulder',
14
+ 'rightShoulder',
15
+ 'leftTrigger',
16
+ 'rightTrigger',
17
+ 'select',
18
+ 'start',
19
+ 'leftStickButton',
20
+ 'rightStickButton',
21
+ 'up',
22
+ 'down',
23
+ 'left',
24
+ 'right',
25
+ 'home'
26
+ ];
27
+ const PAD_DEAD_ZONE = 0.12;
28
+ // PointerEvent.button order: primary, middle, secondary, back, forward, pen eraser.
29
+ const POINTER_BUTTON_MASKS = [1, 4, 2, 8, 16, 32];
30
+ function bound(actions, binding) {
31
+ for (const name of actions.names)
32
+ for (const slot of ['bindings', 'negative', 'positive', 'up', 'down', 'left', 'right', 'sticks']) {
33
+ let list;
34
+ try {
35
+ list = actions.bindingsOf(name, slot);
36
+ }
37
+ catch {
38
+ continue;
39
+ }
40
+ if (list.includes(binding))
41
+ return true;
42
+ }
43
+ return false;
44
+ }
45
+ /** Listens to the page for the controls of `actions`. */
46
+ export function bindBrowserInputActions(actions, options = {}) {
47
+ if (!actions || typeof actions.press !== 'function')
48
+ throw new EgretError('INPUT_ACTIONS_INVALID');
49
+ const win = globalThis;
50
+ const keyTarget = options.keyTarget ?? win;
51
+ if (!keyTarget || typeof keyTarget.addEventListener !== 'function')
52
+ throw new EgretError('INPUT_ACTIONS_INVALID');
53
+ const prevent = options.preventDefault ?? true;
54
+ const pass = new Set(options.passKeys ?? ['F5', 'F11', 'F12']);
55
+ const removers = [];
56
+ const listen = (target, type, handler, opts) => {
57
+ target.addEventListener(type, handler, opts);
58
+ removers.push(() => target.removeEventListener(type, handler, opts));
59
+ };
60
+ const typing = (event) => {
61
+ const element = event.target;
62
+ return (!!element &&
63
+ (element.isContentEditable === true || ['INPUT', 'TEXTAREA', 'SELECT'].includes(element.tagName ?? '')));
64
+ };
65
+ listen(keyTarget, 'keydown', event => {
66
+ const e = event;
67
+ if (typing(e) || !e.code)
68
+ return;
69
+ const binding = 'Key:' + e.code;
70
+ if (prevent && !pass.has(e.code) && bound(actions, binding))
71
+ e.preventDefault();
72
+ if (!e.repeat)
73
+ actions.press(binding);
74
+ });
75
+ listen(keyTarget, 'keyup', event => {
76
+ const e = event;
77
+ if (e.code)
78
+ actions.release('Key:' + e.code);
79
+ });
80
+ const letGo = () => actions.releaseAll();
81
+ if (typeof win.addEventListener === 'function') {
82
+ listen(win, 'blur', letGo);
83
+ listen(win, 'pagehide', letGo);
84
+ }
85
+ const doc = globalThis.document;
86
+ if (doc && typeof doc.addEventListener === 'function')
87
+ listen(doc, 'visibilitychange', () => {
88
+ if (doc.visibilityState === 'hidden')
89
+ letGo();
90
+ });
91
+ if (options.pointerTarget) {
92
+ const target = options.pointerTarget;
93
+ const mouseButton = (event, pressed) => {
94
+ const e = event;
95
+ if (e.pointerType === 'touch')
96
+ return;
97
+ if (e.type === 'pointermove') {
98
+ // A chord changes one button on pointermove. Ordinary motion reports button -1.
99
+ const mask = POINTER_BUTTON_MASKS[e.button];
100
+ if (mask === undefined || Boolean(e.buttons & mask) !== pressed)
101
+ return;
102
+ }
103
+ const binding = 'Mouse:' + e.button;
104
+ if (pressed)
105
+ actions.press(binding);
106
+ else
107
+ actions.release(binding);
108
+ };
109
+ const pressMouse = (event) => mouseButton(event, true);
110
+ const releaseMouse = (event) => mouseButton(event, false);
111
+ listen(target, 'pointerdown', pressMouse);
112
+ listen(target, 'pointermove', pressMouse);
113
+ listen(win, 'pointermove', releaseMouse);
114
+ listen(win, 'pointerup', releaseMouse);
115
+ listen(target, 'contextmenu', event => {
116
+ if (bound(actions, 'Mouse:2'))
117
+ event.preventDefault();
118
+ });
119
+ }
120
+ const padsHeld = new Set();
121
+ const padSticks = new Set();
122
+ const readPads = options.gamepads ?? true;
123
+ return {
124
+ poll() {
125
+ if (!readPads)
126
+ return;
127
+ const nav = globalThis.navigator;
128
+ const pads = typeof nav?.getGamepads === 'function' ? nav.getGamepads() : [];
129
+ const now = new Set();
130
+ // Pads are merged: any pad presses a button, and the strongest stick wins.
131
+ const sticks = new Map();
132
+ for (const pad of pads) {
133
+ if (!pad?.connected)
134
+ continue;
135
+ pad.buttons.forEach((button, index) => {
136
+ const value = button.value ?? (button.pressed ? 1 : 0);
137
+ if (!(button.pressed || value > 0.05))
138
+ return;
139
+ for (const name of [String(index), pad.mapping === 'standard' ? PAD_BUTTONS[index] : undefined]) {
140
+ if (!name)
141
+ continue;
142
+ const binding = 'Pad:' + name;
143
+ now.add(binding);
144
+ actions.press(binding, Math.min(1, Math.max(value, button.pressed ? 1 : 0)));
145
+ }
146
+ });
147
+ const pairs = [
148
+ ['leftStick', pad.axes[0] ?? 0, pad.axes[1] ?? 0],
149
+ ['rightStick', pad.axes[2] ?? 0, pad.axes[3] ?? 0]
150
+ ];
151
+ for (const [name, x, y] of pairs) {
152
+ const length = Math.hypot(x, y);
153
+ if (length < PAD_DEAD_ZONE)
154
+ continue;
155
+ const held = sticks.get(name);
156
+ if (!held || length > Math.hypot(held[0], held[1]))
157
+ sticks.set(name, [x, y]);
158
+ }
159
+ }
160
+ for (const binding of padsHeld)
161
+ if (!now.has(binding))
162
+ actions.release(binding);
163
+ padsHeld.clear();
164
+ for (const binding of now)
165
+ padsHeld.add(binding);
166
+ for (const name of ['leftStick', 'rightStick']) {
167
+ const value = sticks.get(name);
168
+ const binding = 'Pad:' + name;
169
+ if (value) {
170
+ actions.setStick(binding, value[0], value[1]);
171
+ padSticks.add(binding);
172
+ }
173
+ else if (padSticks.delete(binding))
174
+ actions.setStick(binding, 0, 0);
175
+ }
176
+ },
177
+ dispose() {
178
+ for (const remove of removers.splice(0))
179
+ remove();
180
+ actions.releaseAll();
181
+ }
182
+ };
183
+ }
184
+ /**
185
+ * A stick that appears where a finger lands in its zone of `element` and follows it. The element should cover
186
+ * the screen area the stick works in, with `touch-action: none`.
187
+ */
188
+ export function createTouchStick(element, actions, options = {}) {
189
+ if (!element || typeof element.addEventListener !== 'function' || !actions)
190
+ throw new EgretError('INPUT_ACTIONS_INVALID');
191
+ const binding = options.binding ?? 'Touch:stick', radius = options.radius ?? 56, zone = options.zone ?? 'left', name = options.className ?? 'egret-touch-stick';
192
+ if (!(radius > 0))
193
+ throw new EgretError('INPUT_ACTIONS_INVALID');
194
+ const doc = element.ownerDocument;
195
+ const base = doc.createElement('div'), knob = doc.createElement('div');
196
+ base.className = name;
197
+ knob.className = name + '-knob';
198
+ base.style.cssText =
199
+ `position:absolute;left:0;top:0;width:${radius * 2}px;height:${radius * 2}px;margin:${-radius}px 0 0 ${-radius}px;` +
200
+ 'border-radius:50%;background:rgba(255,255,255,0.12);border:2px solid rgba(255,255,255,0.35);pointer-events:none';
201
+ knob.style.cssText =
202
+ `position:absolute;left:${radius - 22}px;top:${radius - 22}px;width:44px;height:44px;border-radius:50%;` +
203
+ 'background:rgba(255,255,255,0.45)';
204
+ base.hidden = true;
205
+ base.appendChild(knob);
206
+ element.appendChild(base);
207
+ let finger, cx = 0, cy = 0;
208
+ const local = (event) => {
209
+ const box = element.getBoundingClientRect();
210
+ return [event.clientX - box.left, event.clientY - box.top];
211
+ };
212
+ const move = (event) => {
213
+ const [x, y] = local(event);
214
+ let dx = (x - cx) / radius, dy = (y - cy) / radius;
215
+ const length = Math.hypot(dx, dy);
216
+ if (length > 1) {
217
+ dx /= length;
218
+ dy /= length;
219
+ }
220
+ knob.style.transform = `translate(${(dx * radius).toFixed(1)}px, ${(dy * radius).toFixed(1)}px)`;
221
+ actions.setStick(binding, dx, dy);
222
+ };
223
+ const down = (event) => {
224
+ const e = event;
225
+ if (finger !== undefined || e.pointerType === 'mouse')
226
+ return;
227
+ const [x, y] = local(e);
228
+ const width = element.getBoundingClientRect().width;
229
+ if ((zone === 'left' && x > width / 2) || (zone === 'right' && x < width / 2))
230
+ return;
231
+ finger = e.pointerId;
232
+ cx = x;
233
+ cy = y;
234
+ base.style.transform = `translate(${x}px, ${y}px)`;
235
+ base.hidden = false;
236
+ element.setPointerCapture?.(e.pointerId);
237
+ e.preventDefault();
238
+ move(e);
239
+ };
240
+ const moved = (event) => {
241
+ const e = event;
242
+ if (e.pointerId === finger)
243
+ move(e);
244
+ };
245
+ const up = (event) => {
246
+ const e = event;
247
+ if (e.pointerId !== finger)
248
+ return;
249
+ finger = undefined;
250
+ base.hidden = true;
251
+ knob.style.transform = '';
252
+ actions.setStick(binding, 0, 0);
253
+ };
254
+ element.addEventListener('pointerdown', down);
255
+ element.addEventListener('pointermove', moved);
256
+ element.addEventListener('pointerup', up);
257
+ element.addEventListener('pointercancel', up);
258
+ return {
259
+ elements: [base, knob],
260
+ dispose() {
261
+ element.removeEventListener('pointerdown', down);
262
+ element.removeEventListener('pointermove', moved);
263
+ element.removeEventListener('pointerup', up);
264
+ element.removeEventListener('pointercancel', up);
265
+ base.remove();
266
+ if (finger !== undefined)
267
+ actions.setStick(binding, 0, 0);
268
+ }
269
+ };
270
+ }
271
+ /** Makes `element` an on-screen button that holds `binding` (such as `Touch:jump`) while a finger is on it. */
272
+ export function createTouchButton(element, actions, binding) {
273
+ if (!element || typeof element.addEventListener !== 'function' || !actions || typeof binding !== 'string')
274
+ throw new EgretError('INPUT_ACTIONS_INVALID');
275
+ const fingers = new Set();
276
+ const down = (event) => {
277
+ const e = event;
278
+ fingers.add(e.pointerId);
279
+ element.setPointerCapture?.(e.pointerId);
280
+ element.dataset['pressed'] = '';
281
+ e.preventDefault();
282
+ actions.press(binding);
283
+ };
284
+ const up = (event) => {
285
+ const e = event;
286
+ if (!fingers.delete(e.pointerId) || fingers.size > 0)
287
+ return;
288
+ delete element.dataset['pressed'];
289
+ actions.release(binding);
290
+ };
291
+ element.addEventListener('pointerdown', down);
292
+ element.addEventListener('pointerup', up);
293
+ element.addEventListener('pointercancel', up);
294
+ return {
295
+ elements: [element],
296
+ dispose() {
297
+ element.removeEventListener('pointerdown', down);
298
+ element.removeEventListener('pointerup', up);
299
+ element.removeEventListener('pointercancel', up);
300
+ if (fingers.size)
301
+ actions.release(binding);
302
+ fingers.clear();
303
+ }
304
+ };
305
+ }
306
+ /**
307
+ * The page's local storage as a save storage, or a memory stand-in where the page has none (a private window, a
308
+ * blocked site): every call is guarded, so a save never throws for want of storage.
309
+ */
310
+ export function browserSaveStorage() {
311
+ let storage;
312
+ try {
313
+ storage = globalThis.localStorage;
314
+ const probe = '__egret_probe__';
315
+ storage?.setItem(probe, probe);
316
+ storage?.removeItem(probe);
317
+ }
318
+ catch {
319
+ storage = undefined;
320
+ }
321
+ const memory = new Map();
322
+ return {
323
+ persistent: storage !== undefined,
324
+ getItem(key) {
325
+ if (!storage)
326
+ return memory.get(key) ?? null;
327
+ return storage.getItem(key);
328
+ },
329
+ setItem(key, value) {
330
+ if (!storage)
331
+ return void memory.set(key, value);
332
+ // Thrown when the storage is full; the save store reports it.
333
+ storage.setItem(key, value);
334
+ },
335
+ removeItem(key) {
336
+ if (!storage)
337
+ return void memory.delete(key);
338
+ storage.removeItem(key);
339
+ }
340
+ };
341
+ }
342
+ //# sourceMappingURL=BrowserInputActions.js.map
@@ -0,0 +1,4 @@
1
+ import type { KeyboardInput, KeyboardInputOptions } from '#egret-keyboard-input';
2
+ /** Canvas-local native keyboard bridge. Canvas focus remains application-owned. */
3
+ export declare function createBrowserKeyboardInput(options: KeyboardInputOptions): KeyboardInput;
4
+ //# sourceMappingURL=BrowserKeyboardInput.d.ts.map
@@ -0,0 +1,223 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ import { bindKeyboardSurface, createKeyboardInput } from '#egret-keyboard-input';
4
+ const apply = Reflect.apply, owned = new WeakSet();
5
+ function getter(prototype, name) {
6
+ const value = prototype === undefined ? undefined : Object.getOwnPropertyDescriptor(prototype, name)?.get;
7
+ if (typeof value !== 'function')
8
+ throw new EgretError('KEYBOARD_INPUT_SURFACE_INVALID');
9
+ return value;
10
+ }
11
+ function method(prototype, name) {
12
+ const value = prototype === undefined ? undefined : Object.getOwnPropertyDescriptor(prototype, name)?.value;
13
+ if (typeof value !== 'function')
14
+ throw new EgretError('KEYBOARD_INPUT_SURFACE_INVALID');
15
+ return value;
16
+ }
17
+ /** Canvas-local native keyboard bridge. Canvas focus remains application-owned. */
18
+ export function createBrowserKeyboardInput(options) {
19
+ const input = createKeyboardInput(options), bridge = bindKeyboardSurface(input), surface = bridge.surface;
20
+ const pairs = [];
21
+ let closed = false, paused = false, busy = false, claimed = false;
22
+ let removeClose = () => { }, removeInteractive = () => { }, restore = () => { };
23
+ let remove = () => { }, add = () => { };
24
+ function removePair(pair) {
25
+ if (pair.adding || pair.removed)
26
+ return;
27
+ pair.removed = true;
28
+ apply(remove, pair.target, [pair.type, pair.listener, false]);
29
+ }
30
+ function detach() {
31
+ let failure, failed = false;
32
+ for (const pair of pairs.slice().reverse())
33
+ try {
34
+ removePair(pair);
35
+ }
36
+ catch (cause) {
37
+ if (!failed) {
38
+ failed = true;
39
+ failure = cause;
40
+ }
41
+ }
42
+ if (failed)
43
+ throw failure;
44
+ }
45
+ function cleanup() {
46
+ if (closed)
47
+ return;
48
+ closed = true;
49
+ const failures = [];
50
+ for (const action of [detach, restore, removeClose, removeInteractive])
51
+ try {
52
+ action();
53
+ }
54
+ catch (cause) {
55
+ failures.push(cause);
56
+ }
57
+ if (claimed && !pairs.some(pair => pair.adding)) {
58
+ owned.delete(surface);
59
+ claimed = false;
60
+ }
61
+ for (const cause of failures)
62
+ bridge.report(cause);
63
+ }
64
+ function fail(cause) {
65
+ try {
66
+ input.dispose();
67
+ }
68
+ catch (secondary) {
69
+ bridge.report(secondary);
70
+ }
71
+ finally {
72
+ cleanup();
73
+ }
74
+ bridge.report(cause);
75
+ }
76
+ try {
77
+ removeClose = bridge.onClose(cleanup);
78
+ const win = globalThis.window, document = globalThis.document;
79
+ if (win === undefined || document === undefined)
80
+ throw new EgretError('KEYBOARD_INPUT_SURFACE_INVALID');
81
+ const canvasBrand = getter(globalThis.HTMLCanvasElement?.prototype, 'width'), ownerDocument = getter(globalThis.Node?.prototype, 'ownerDocument'), connected = getter(globalThis.Node?.prototype, 'isConnected');
82
+ const defaultView = getter(globalThis.Document?.prototype, 'defaultView'), active = getter(globalThis.Document?.prototype, 'activeElement'), visibility = getter(globalThis.Document?.prototype, 'visibilityState');
83
+ const target = getter(globalThis.Event?.prototype, 'target'), type = getter(globalThis.Event?.prototype, 'type'), prevent = method(globalThis.Event?.prototype, 'preventDefault');
84
+ const code = getter(globalThis.KeyboardEvent?.prototype, 'code'), key = getter(globalThis.KeyboardEvent?.prototype, 'key'), repeat = getter(globalThis.KeyboardEvent?.prototype, 'repeat'), composing = getter(globalThis.KeyboardEvent?.prototype, 'isComposing');
85
+ const alt = getter(globalThis.KeyboardEvent?.prototype, 'altKey'), ctrl = getter(globalThis.KeyboardEvent?.prototype, 'ctrlKey'), meta = getter(globalThis.KeyboardEvent?.prototype, 'metaKey'), shift = getter(globalThis.KeyboardEvent?.prototype, 'shiftKey');
86
+ const getAttribute = method(globalThis.Element?.prototype, 'getAttribute'), setAttribute = method(globalThis.Element?.prototype, 'setAttribute'), removeAttribute = method(globalThis.Element?.prototype, 'removeAttribute');
87
+ add = method(globalThis.EventTarget?.prototype, 'addEventListener');
88
+ remove = method(globalThis.EventTarget?.prototype, 'removeEventListener');
89
+ function authentic() {
90
+ apply(canvasBrand, surface, []);
91
+ if (apply(ownerDocument, surface, []) !== document ||
92
+ apply(defaultView, document, []) !== win ||
93
+ apply(connected, surface, []) !== true)
94
+ throw new EgretError('KEYBOARD_INPUT_SURFACE_INVALID');
95
+ }
96
+ authentic();
97
+ if (owned.has(surface))
98
+ throw new EgretError('KEYBOARD_INPUT_IN_USE');
99
+ owned.add(surface);
100
+ claimed = true;
101
+ if (apply(getAttribute, surface, ['tabindex']) === null) {
102
+ // Restore only the exact value still owned by this bridge.
103
+ restore = () => {
104
+ if (apply(getAttribute, surface, ['tabindex']) === '0')
105
+ apply(removeAttribute, surface, ['tabindex']);
106
+ };
107
+ apply(setAttribute, surface, ['tabindex', '0']);
108
+ }
109
+ function cancel(reason) {
110
+ input.cancel(reason);
111
+ }
112
+ function keyboard(event, down) {
113
+ authentic();
114
+ if (apply(active, document, []) !== surface ||
115
+ apply(target, event, []) !== surface ||
116
+ apply(visibility, document, []) !== 'visible')
117
+ return;
118
+ const physical = apply(code, event, []), logical = apply(key, event, []);
119
+ if (apply(composing, event, []) === true || logical === 'Process' || logical === 'Dead' || physical === '')
120
+ return;
121
+ const sample = {
122
+ code: physical,
123
+ key: logical,
124
+ repeat: apply(repeat, event, []),
125
+ altKey: apply(alt, event, []),
126
+ ctrlKey: apply(ctrl, event, []),
127
+ metaKey: apply(meta, event, []),
128
+ shiftKey: apply(shift, event, [])
129
+ };
130
+ const prevented = down ? input.keyDown(sample) : input.keyUp(sample);
131
+ // Prevention belongs to this original native event even if its genuine
132
+ // handler synchronously suspended, closed, or handed focus to an editor.
133
+ if (prevented)
134
+ apply(prevent, event, []);
135
+ if (closed || paused)
136
+ return;
137
+ if (apply(active, document, []) !== surface)
138
+ return;
139
+ if (!prevented && down && logical === 'Tab' && !sample.altKey && !sample.ctrlKey && !sample.metaKey) {
140
+ const next = input.moveFocus(sample.shiftKey ? 'previous' : 'next');
141
+ if (next !== undefined)
142
+ apply(prevent, event, []);
143
+ }
144
+ }
145
+ function listen(eventTarget, eventType, action) {
146
+ const listener = event => {
147
+ if (closed || paused)
148
+ return;
149
+ if (busy && (eventType === 'keydown' || eventType === 'keyup')) {
150
+ fail(new EgretError('KEYBOARD_INPUT_REENTRANT'));
151
+ return;
152
+ }
153
+ const wasBusy = busy;
154
+ busy = true;
155
+ try {
156
+ if (apply(type, event, []) === eventType)
157
+ action(event);
158
+ }
159
+ catch (cause) {
160
+ fail(cause);
161
+ }
162
+ finally {
163
+ busy = wasBusy;
164
+ }
165
+ };
166
+ pairs.push({ target: eventTarget, type: eventType, listener, adding: false, removed: true });
167
+ }
168
+ function attach() {
169
+ authentic();
170
+ for (const pair of pairs) {
171
+ if (closed || paused)
172
+ break;
173
+ if (!pair.removed)
174
+ continue;
175
+ pair.removed = false;
176
+ pair.adding = true;
177
+ try {
178
+ apply(add, pair.target, [pair.type, pair.listener, false]);
179
+ }
180
+ finally {
181
+ pair.adding = false;
182
+ if (closed || paused)
183
+ removePair(pair);
184
+ }
185
+ }
186
+ if (closed && claimed) {
187
+ owned.delete(surface);
188
+ claimed = false;
189
+ }
190
+ }
191
+ listen(surface, 'keydown', event => keyboard(event, true));
192
+ listen(win, 'keyup', event => keyboard(event, false));
193
+ listen(surface, 'blur', () => cancel('blur'));
194
+ listen(win, 'blur', () => cancel('blur'));
195
+ listen(win, 'pagehide', () => cancel('pagehide'));
196
+ listen(document, 'visibilitychange', () => {
197
+ if (apply(visibility, document, []) !== 'visible')
198
+ cancel('hidden');
199
+ });
200
+ removeInteractive = bridge.onInteractive(value => {
201
+ paused = !value;
202
+ if (paused)
203
+ detach();
204
+ else
205
+ attach();
206
+ });
207
+ attach();
208
+ if (closed || input.getSnapshot().state === 'closed')
209
+ throw new EgretError('KEYBOARD_INPUT_CLOSED');
210
+ return input;
211
+ }
212
+ catch (cause) {
213
+ cleanup();
214
+ try {
215
+ input.dispose();
216
+ }
217
+ catch (secondary) {
218
+ bridge.report(secondary);
219
+ }
220
+ throw cause;
221
+ }
222
+ }
223
+ //# sourceMappingURL=BrowserKeyboardInput.js.map