@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,299 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { DisplayObject, DisplayObjectContainer, EgretError, Event, createEventType } from '@egret/runtime';
3
+ import { createPointerRouter } from '@egret/runtime/input';
4
+ import { requireMouseInputEngine } from './internal/mouseInputFactoryState.js';
5
+ import { captureUiInputDelivery, registerUiPointerInput } from './internal/uiFactoryState.js';
6
+ const getter = (prototype, key) => Object.getOwnPropertyDescriptor(prototype, key).get;
7
+ const parent = getter(DisplayObject.prototype, 'parent'), visible = getter(DisplayObject.prototype, 'visible');
8
+ const touch = getter(DisplayObject.prototype, 'touchEnabled'), children = getter(DisplayObjectContainer.prototype, 'touchChildren');
9
+ const bindings = new WeakMap();
10
+ // Keep browser-only references in a separate closure, released with its binding.
11
+ function surfaceBinding(surface, report, onClose) {
12
+ return Object.freeze({
13
+ surface,
14
+ onClose,
15
+ report: (cause) => report({ code: 'POINTER_INPUT_HOST_FAILED', phase: 'engine', severity: 'error', cause })
16
+ });
17
+ }
18
+ /** Private browser assembly authority; never exported by the optional public entry. */
19
+ export function bindPointerSurface(input) {
20
+ const binding = bindings.get(input);
21
+ if (binding === undefined || input.state === 'closed')
22
+ throw new EgretError('POINTER_INPUT_CLOSED');
23
+ return binding;
24
+ }
25
+ /** How far, in stage units, a contact may end from where it began and still be a tap. */
26
+ const TAP_SLOP = 12;
27
+ export function createPointerInput(options) {
28
+ if (options === null || typeof options !== 'object' || Array.isArray(options))
29
+ throw new EgretError('POINTER_INPUT_OPTIONS_INVALID');
30
+ const engine = options.engine;
31
+ let owner = requireMouseInputEngine(engine);
32
+ const deliver = captureUiInputDelivery(engine);
33
+ let scope = owner.scope(options.scope);
34
+ const width = options.width, height = options.height, maxNodes = options.maxNodes ?? 4096;
35
+ let observer = options.onContact;
36
+ // Late subscribers to the same stream; the creation-time observer keeps its single slot.
37
+ const listeners = new Set();
38
+ if (!Number.isFinite(width) ||
39
+ width <= 0 ||
40
+ !Number.isFinite(height) ||
41
+ height <= 0 ||
42
+ !Number.isInteger(maxNodes) ||
43
+ maxNodes < 1 ||
44
+ maxNodes > 65536 ||
45
+ (observer !== undefined && typeof observer !== 'function'))
46
+ throw new EgretError('POINTER_INPUT_OPTIONS_INVALID');
47
+ owner.assertReady();
48
+ scope.assertOpen();
49
+ let operations = owner.operations;
50
+ const events = Object.freeze({
51
+ begin: createEventType('egret.pointer.begin', { bubbles: true, cancelable: true }),
52
+ move: createEventType('egret.pointer.move', { bubbles: true, cancelable: true }),
53
+ end: createEventType('egret.pointer.end', { bubbles: true, cancelable: true }),
54
+ cancel: createEventType('egret.pointer.cancel', {
55
+ bubbles: true,
56
+ cancelable: false
57
+ }),
58
+ tap: createEventType('egret.pointer.tap', { bubbles: true, cancelable: false })
59
+ });
60
+ const closers = new Set();
61
+ const activeEvents = new Map();
62
+ let router, input, closed = false;
63
+ let releaseEngine;
64
+ let calls = 0;
65
+ const eligible = (target) => {
66
+ if (owner === undefined || scope === undefined || operations === undefined)
67
+ return false;
68
+ try {
69
+ owner.assertReady();
70
+ scope.assertOpen();
71
+ }
72
+ catch {
73
+ return false;
74
+ }
75
+ if (!operations.isAttached(target, maxNodes) || Reflect.apply(touch, target, []) !== true)
76
+ return false;
77
+ let node = target, count = 0;
78
+ while (node !== undefined) {
79
+ if (++count > maxNodes)
80
+ throw new EgretError('HIT_TEST_TREE_LIMIT');
81
+ if (Reflect.apply(visible, node, []) !== true)
82
+ return false;
83
+ if (node !== target && Reflect.apply(children, node, []) !== true)
84
+ return false;
85
+ node = Reflect.apply(parent, node, []);
86
+ }
87
+ return true;
88
+ };
89
+ function closeNative() {
90
+ if (closed)
91
+ return;
92
+ closed = true;
93
+ releaseEngine?.();
94
+ releaseEngine = undefined;
95
+ scope?.remove(retire);
96
+ bindings.delete(input);
97
+ const callbacks = [...closers];
98
+ closers.clear();
99
+ let first, failed = false;
100
+ const cleanup = [];
101
+ for (const callback of callbacks)
102
+ try {
103
+ callback();
104
+ }
105
+ catch (cause) {
106
+ if (!failed) {
107
+ first = cause;
108
+ failed = true;
109
+ }
110
+ else
111
+ cleanup.push(cause);
112
+ }
113
+ owner = undefined;
114
+ scope = undefined;
115
+ operations = undefined;
116
+ observer = undefined;
117
+ listeners.clear();
118
+ if (failed)
119
+ throw new EgretError('POINTER_INPUT_CLEANUP_FAILED', { cause: first, cleanupErrors: cleanup });
120
+ }
121
+ function invoke(operation) {
122
+ let value, first, failed = false;
123
+ calls++;
124
+ try {
125
+ value = operation();
126
+ }
127
+ catch (cause) {
128
+ failed = true;
129
+ first = cause;
130
+ }
131
+ finally {
132
+ calls--;
133
+ }
134
+ if (calls === 0 && router.state === 'closed')
135
+ try {
136
+ closeNative();
137
+ }
138
+ catch (cause) {
139
+ if (failed)
140
+ throw new EgretError('POINTER_INPUT_CALLBACK_FAILED', { cause: first, cleanupErrors: [cause] });
141
+ throw cause;
142
+ }
143
+ if (failed)
144
+ throw first;
145
+ return value;
146
+ }
147
+ function retire() {
148
+ invoke(() => router.dispose());
149
+ }
150
+ // Where each contact began and on what, for a tap: an end on the same target within TAP_SLOP units of its begin.
151
+ const begun = new Map();
152
+ router = createPointerRouter({
153
+ ...(options.capacity === undefined ? {} : { capacity: options.capacity }),
154
+ pick: (x, y) => {
155
+ owner.assertReady();
156
+ scope.assertOpen();
157
+ return operations.pick(x, y, maxNodes);
158
+ },
159
+ eligible,
160
+ dispatch: (kind, contact, target, reason) => deliver(() => {
161
+ // Termination during capture/target callbacks must stop the older route.
162
+ if (kind === 'cancel')
163
+ activeEvents.get(contact.session)?.stopImmediatePropagation();
164
+ // Observer receives terminal cleanup even when its display target no longer exists.
165
+ const notification = Object.freeze({ kind, contact, target, ...(reason === undefined ? {} : { reason }) });
166
+ // Presence of a throw is tracked separately from its value: `throw undefined` is still a
167
+ // throw, and swallowing it would leave the channel active and allow an activation.
168
+ let threw = false, thrown;
169
+ try {
170
+ observer?.(notification);
171
+ }
172
+ catch (cause) {
173
+ threw = true;
174
+ thrown = cause;
175
+ }
176
+ // begin/move/cancel keep the original pre-dispatch observation order, including reentry that
177
+ // cancels from inside a listener. Only `end` is reported after its dispatch attempt.
178
+ if (kind !== 'end')
179
+ for (const listener of [...listeners])
180
+ try {
181
+ listener(notification);
182
+ }
183
+ catch {
184
+ /* isolated */
185
+ }
186
+ let delivered = false;
187
+ try {
188
+ if (threw)
189
+ throw thrown;
190
+ if (target === undefined || !eligible(target))
191
+ return;
192
+ // A callback may synchronously cancel or close the session before target delivery.
193
+ if ((kind === 'begin' || kind === 'move') &&
194
+ !router.contacts.some(value => value.session === contact.session))
195
+ return;
196
+ delivered = true;
197
+ if (kind === 'begin')
198
+ begun.set(contact.session, { target, x: contact.globalX, y: contact.globalY });
199
+ if (kind === 'cancel')
200
+ operations.dispatch(target, Object.freeze(new Event(events.cancel, Object.freeze({ ...contact, reason: reason }))), maxNodes);
201
+ else {
202
+ const event = Object.freeze(new Event(events[kind], contact));
203
+ if (kind === 'begin' || kind === 'move')
204
+ activeEvents.set(contact.session, event);
205
+ try {
206
+ operations.dispatch(target, event, maxNodes);
207
+ }
208
+ finally {
209
+ if (activeEvents.get(contact.session) === event)
210
+ activeEvents.delete(contact.session);
211
+ }
212
+ // A tap follows the end it completes, on the target both were on, unless a listener closed the input.
213
+ const start = kind === 'end' ? begun.get(contact.session) : undefined;
214
+ if (start !== undefined &&
215
+ start.target === target &&
216
+ Math.hypot(contact.globalX - start.x, contact.globalY - start.y) <= TAP_SLOP &&
217
+ router.state !== 'closed' &&
218
+ eligible(target))
219
+ operations.dispatch(target, Object.freeze(new Event(events.tap, contact)), maxNodes);
220
+ }
221
+ }
222
+ finally {
223
+ if (kind === 'end' || kind === 'cancel')
224
+ begun.delete(contact.session);
225
+ // `delivered` records that a target path was attempted, not that a particular control ran.
226
+ if (kind === 'end') {
227
+ const observed = Object.freeze({ ...notification, delivered });
228
+ for (const listener of [...listeners])
229
+ try {
230
+ listener(observed);
231
+ }
232
+ catch {
233
+ /* isolated */
234
+ }
235
+ }
236
+ }
237
+ })
238
+ });
239
+ input = Object.freeze({
240
+ get state() {
241
+ return router.state;
242
+ },
243
+ get contacts() {
244
+ return router.contacts;
245
+ },
246
+ get viewportRevision() {
247
+ return router.viewportRevision;
248
+ },
249
+ events,
250
+ begin: (sample) => invoke(() => router.begin(sample)),
251
+ move: (session, sample) => invoke(() => router.move(session, sample)),
252
+ end: (session, sample) => invoke(() => router.end(session, sample)),
253
+ cancel: (session, reason) => invoke(() => router.cancel(session, reason)),
254
+ cancelAll: (reason) => invoke(() => router.cancelAll(reason)),
255
+ capture: (session, target) => invoke(() => router.capture(session, target)),
256
+ releaseCapture: (session) => invoke(() => router.releaseCapture(session)),
257
+ sync: () => invoke(() => router.sync()),
258
+ setViewportRevision: (revision) => invoke(() => router.setViewportRevision(revision)),
259
+ setInteractive: (value) => invoke(() => router.setInteractive(value)),
260
+ dispose: retire,
261
+ observe: (listener) => {
262
+ if (typeof listener !== 'function')
263
+ throw new EgretError('POINTER_INPUT_OPTIONS_INVALID');
264
+ listeners.add(listener);
265
+ return () => {
266
+ listeners.delete(listener);
267
+ };
268
+ }
269
+ });
270
+ registerUiPointerInput(input, engine, Object.freeze({ events, state: () => router.state, activeContacts: () => router.contacts.length, sync: input.sync }));
271
+ try {
272
+ releaseEngine = owner.onClose(retire);
273
+ scope.add(retire);
274
+ scope.use(input);
275
+ bindings.set(input, surfaceBinding(owner.surface, owner.report, (callback) => {
276
+ if (closed) {
277
+ callback();
278
+ return () => { };
279
+ }
280
+ closers.add(callback);
281
+ return () => {
282
+ closers.delete(callback);
283
+ };
284
+ }));
285
+ owner.assertReady();
286
+ scope.assertOpen();
287
+ return input;
288
+ }
289
+ catch (cause) {
290
+ try {
291
+ retire();
292
+ }
293
+ catch (cleanup) {
294
+ throw new EgretError('POINTER_INPUT_SETUP_FAILED', { cause, cleanupErrors: [cleanup] });
295
+ }
296
+ throw cause;
297
+ }
298
+ }
299
+ //# sourceMappingURL=pointerInput.js.map
@@ -0,0 +1,38 @@
1
+ import type { DisplayObject, EventType, Scope } from '@egret/runtime';
2
+ import type { PointerCancelReason, PointerContact, PointerEventKind, PointerRouter } from '@egret/runtime/input';
3
+ import type { Engine } from './Engine.js';
4
+ export type { PointerCancelReason, PointerContact, PointerEventKind, PointerSample, PointerSession, PointerType, PointerUpdate, PointerRouterState } from '@egret/runtime/input';
5
+ export interface PointerNotification {
6
+ readonly kind: PointerEventKind;
7
+ readonly contact: PointerContact;
8
+ readonly target: DisplayObject | undefined;
9
+ readonly reason?: PointerCancelReason;
10
+ /** Present on a terminal `end`: whether the event was actually dispatched to a target path. */
11
+ readonly delivered?: boolean;
12
+ }
13
+ export interface PointerInputOptions {
14
+ readonly engine: Engine;
15
+ readonly scope: Scope;
16
+ readonly width: number;
17
+ readonly height: number;
18
+ readonly maxNodes?: number;
19
+ readonly capacity?: number;
20
+ readonly onContact?: (notification: PointerNotification) => void;
21
+ }
22
+ export interface PointerInputEvents {
23
+ readonly begin: EventType<PointerContact>;
24
+ readonly move: EventType<PointerContact>;
25
+ readonly end: EventType<PointerContact>;
26
+ readonly cancel: EventType<PointerContact & {
27
+ readonly reason: PointerCancelReason;
28
+ }>;
29
+ /** After an `end` on the target its contact began on, no more than 12 stage units from where it began. */
30
+ readonly tap: EventType<PointerContact>;
31
+ }
32
+ /** Scope-owned input for an explicitly supplied logical host stream. */
33
+ export interface PointerInput extends PointerRouter<DisplayObject> {
34
+ readonly events: PointerInputEvents;
35
+ /** Terminal and contact observations after creation, without adding a host input path. */
36
+ observe(listener: (notification: PointerNotification) => void): () => void;
37
+ }
38
+ //# sourceMappingURL=pointerInputTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=pointerInputTypes.js.map
@@ -0,0 +1,29 @@
1
+ export interface Random {
2
+ /** A number in [0, 1). */
3
+ next(): number;
4
+ /** A number in [min, max). */
5
+ range(min: number, max: number): number;
6
+ /** A whole number from min to max, both included. */
7
+ int(min: number, max: number): number;
8
+ /** True with probability `chance`, 0.5 by default. */
9
+ chance(chance?: number): boolean;
10
+ /** One item of a non-empty list. */
11
+ pick<T>(items: readonly T[]): T;
12
+ /** One item of a list, each as likely as its weight. */
13
+ weighted<T>(items: readonly T[], weights: readonly number[]): T;
14
+ /** The list in a new random order; the list itself is not changed. */
15
+ shuffle<T>(items: readonly T[]): T[];
16
+ /** A number around `mean` with the given spread, from a normal distribution. */
17
+ normal(mean?: number, deviation?: number): number;
18
+ /** A new generator seeded from this one, so one part of the game cannot change another's numbers. */
19
+ fork(): Random;
20
+ /** The state, to save and give to `createRandom` later. */
21
+ state(): RandomState;
22
+ }
23
+ /** Four 32-bit words. */
24
+ export type RandomState = readonly [number, number, number, number];
25
+ /** Turns a string or number into a 32-bit seed. */
26
+ export declare function hashSeed(seed: string | number): number;
27
+ /** A generator from a seed (a number or string) or a saved state. */
28
+ export declare function createRandom(seed?: number | string | RandomState): Random;
29
+ //# sourceMappingURL=random.d.ts.map
package/dist/random.js ADDED
@@ -0,0 +1,131 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Repeatable random numbers for game rules. The same seed gives the same run,
3
+ // so a bug report can name a seed, a test can play a whole level, and a replay
4
+ // can be checked. The generator is sfc32: small, fast and good enough for
5
+ // games; it is not for secrets. Its state can be saved and restored.
6
+ import { EgretError } from '@egret/runtime';
7
+ /** Turns a string or number into a 32-bit seed. */
8
+ export function hashSeed(seed) {
9
+ const text = String(seed);
10
+ let h = 0x811c9dc5;
11
+ for (let i = 0; i < text.length; i++) {
12
+ h ^= text.charCodeAt(i);
13
+ h = Math.imul(h, 0x01000193);
14
+ }
15
+ return h >>> 0;
16
+ }
17
+ /** A generator from a seed (a number or string) or a saved state. */
18
+ export function createRandom(seed = Date.now()) {
19
+ let a, b, c, d;
20
+ if (Array.isArray(seed)) {
21
+ if (seed.length !== 4 || !seed.every(word => Number.isInteger(word)))
22
+ throw new EgretError('RANDOM_SEED_INVALID');
23
+ [a, b, c, d] = seed.map(word => word >>> 0);
24
+ }
25
+ else {
26
+ if (typeof seed !== 'string' && !(typeof seed === 'number' && Number.isFinite(seed)))
27
+ throw new EgretError('RANDOM_SEED_INVALID');
28
+ const h = hashSeed(seed);
29
+ a = 0x9e3779b9;
30
+ b = 0x243f6a88;
31
+ c = 0xb7e15162;
32
+ d = h;
33
+ // Mix the seed in before the first number is drawn.
34
+ for (let i = 0; i < 12; i++)
35
+ step();
36
+ }
37
+ function step() {
38
+ a >>>= 0;
39
+ b >>>= 0;
40
+ c >>>= 0;
41
+ d >>>= 0;
42
+ let t = (a + b) | 0;
43
+ a = b ^ (b >>> 9);
44
+ b = (c + (c << 3)) | 0;
45
+ c = (c << 21) | (c >>> 11);
46
+ d = (d + 1) | 0;
47
+ t = (t + d) | 0;
48
+ c = (c + t) | 0;
49
+ return (t >>> 0) / 4294967296;
50
+ }
51
+ let spare;
52
+ const random = {
53
+ next: step,
54
+ range(min, max) {
55
+ if (!Number.isFinite(min) || !Number.isFinite(max) || max < min)
56
+ throw new EgretError('RANDOM_RANGE_INVALID');
57
+ return min + (max - min) * step();
58
+ },
59
+ int(min, max) {
60
+ if (!Number.isSafeInteger(min) || !Number.isSafeInteger(max) || max < min)
61
+ throw new EgretError('RANDOM_RANGE_INVALID');
62
+ return min + Math.floor(step() * (max - min + 1));
63
+ },
64
+ chance(p = 0.5) {
65
+ if (!(p >= 0 && p <= 1))
66
+ throw new EgretError('RANDOM_RANGE_INVALID');
67
+ return step() < p;
68
+ },
69
+ pick(items) {
70
+ if (!Array.isArray(items) || items.length === 0)
71
+ throw new EgretError('RANDOM_RANGE_INVALID');
72
+ return items[Math.floor(step() * items.length)];
73
+ },
74
+ weighted(items, weights) {
75
+ if (!Array.isArray(items) || !Array.isArray(weights) || items.length === 0 || items.length !== weights.length)
76
+ throw new EgretError('RANDOM_RANGE_INVALID');
77
+ let total = 0;
78
+ for (const weight of weights) {
79
+ if (!(weight >= 0) || !Number.isFinite(weight))
80
+ throw new EgretError('RANDOM_RANGE_INVALID');
81
+ total += weight;
82
+ }
83
+ if (!(total > 0))
84
+ throw new EgretError('RANDOM_RANGE_INVALID');
85
+ let roll = step() * total;
86
+ for (let i = 0; i < items.length; i++) {
87
+ roll -= weights[i];
88
+ if (roll < 0)
89
+ return items[i];
90
+ }
91
+ return items[items.length - 1];
92
+ },
93
+ shuffle(items) {
94
+ const out = [...items];
95
+ for (let i = out.length - 1; i > 0; i--) {
96
+ const j = Math.floor(step() * (i + 1));
97
+ [out[i], out[j]] = [out[j], out[i]];
98
+ }
99
+ return out;
100
+ },
101
+ normal(mean = 0, deviation = 1) {
102
+ if (spare !== undefined) {
103
+ const value = spare;
104
+ spare = undefined;
105
+ return mean + deviation * value;
106
+ }
107
+ let u = 0, v = 0, s = 0;
108
+ do {
109
+ u = step() * 2 - 1;
110
+ v = step() * 2 - 1;
111
+ s = u * u + v * v;
112
+ } while (s >= 1 || s === 0);
113
+ const factor = Math.sqrt((-2 * Math.log(s)) / s);
114
+ spare = v * factor;
115
+ return mean + deviation * u * factor;
116
+ },
117
+ fork() {
118
+ return createRandom([
119
+ (step() * 4294967296) >>> 0,
120
+ (step() * 4294967296) >>> 0,
121
+ (step() * 4294967296) >>> 0,
122
+ (step() * 4294967296) >>> 0
123
+ ]);
124
+ },
125
+ state() {
126
+ return Object.freeze([a >>> 0, b >>> 0, c >>> 0, d >>> 0]);
127
+ }
128
+ };
129
+ return Object.freeze(random);
130
+ }
131
+ //# sourceMappingURL=random.js.map
@@ -0,0 +1,5 @@
1
+ /** Note only a fresh deliberate first-party failure at its creation site. */
2
+ export declare function noteOwnedPreparationFailure<T extends object>(error: T): T;
3
+ /** Report the exact escaping object created under this invocation; preserve all throws. */
4
+ export declare function runOwnedPreparationScope<T>(operation: () => T, privateObserver: (error: object) => void): T;
5
+ //# sourceMappingURL=ownedPreparationFailure2D.d.ts.map
@@ -0,0 +1,33 @@
1
+ // Synchronous, module-owned provenance. Error spelling or constructor is never authority.
2
+ let current;
3
+ const origins = new WeakMap();
4
+ /** Note only a fresh deliberate first-party failure at its creation site. */
5
+ export function noteOwnedPreparationFailure(error) {
6
+ if (current !== undefined && !origins.has(error))
7
+ origins.set(error, current);
8
+ return error;
9
+ }
10
+ /** Report the exact escaping object created under this invocation; preserve all throws. */
11
+ export function runOwnedPreparationScope(operation, privateObserver) {
12
+ const parent = current, token = {};
13
+ current = token;
14
+ try {
15
+ return operation();
16
+ }
17
+ catch (failure) {
18
+ if (((typeof failure === 'object' && failure !== null) || typeof failure === 'function') &&
19
+ origins.get(failure) === token) {
20
+ try {
21
+ privateObserver(failure);
22
+ }
23
+ finally {
24
+ throw failure;
25
+ }
26
+ }
27
+ throw failure;
28
+ }
29
+ finally {
30
+ current = parent;
31
+ }
32
+ }
33
+ //# sourceMappingURL=ownedPreparationFailure2D.js.map
@@ -0,0 +1,50 @@
1
+ import type { PreparedSharedDraw2D, PreparedSharedFrame2D } from './prepareSharedDraws2D.js';
2
+ /**
3
+ * `regionWindow` is the window of the region table this draw's region is in, or -1 for a draw without a region.
4
+ * `pages` are the pages of the frame the draw samples, in the order of the texture units that hold them: the
5
+ * one page of a draw as it is packed, up to eight for a batch, none for a draw without a region.
6
+ * Nothing of a record is written once it is given, except the rows of a batch a Host keeps between frames:
7
+ * see `prepareSharedBatches2D`. Draws next to each other may share one `uniform`, and one `pages`.
8
+ */
9
+ export interface PackedSharedDraw2D {
10
+ readonly prepared: PreparedSharedDraw2D;
11
+ readonly data: Float32Array<ArrayBuffer>;
12
+ readonly vertexCount: number;
13
+ readonly uniform: Uint8Array<ArrayBuffer>;
14
+ readonly regionWindow: number;
15
+ readonly pages: readonly number[];
16
+ }
17
+ export type PackedSharedEntry2D = PackedSharedDraw2D | {
18
+ readonly barrier: true;
19
+ readonly ordinal: number;
20
+ };
21
+ /**
22
+ * One vertex is thirteen f32 values: x y u v r g b a dr dg db slot opacity. `slot` is the place of the
23
+ * draw's region in its window of the region table, and `opacity` the opacity of the draw; both are the
24
+ * same at every vertex of a draw, so that draws which differ only in them share a batch.
25
+ */
26
+ export declare const SHARED_VERTEX_BYTES_2D = 52;
27
+ /**
28
+ * The region table holds twelve u32 values for every region of a frame, in frame order: logical width and
29
+ * height, trim x and y; content width and height, packed x and y; quarter turn, the index of the region's
30
+ * page in the frame, and the width and height of that page. A draw reads it through a window of 341
31
+ * consecutive regions, the most that fit the 16,384 bytes every WebGL2 context gives one uniform block.
32
+ */
33
+ export declare const SHARED_REGION_WINDOW_2D = 341, SHARED_REGION_WINDOW_BYTES_2D = 16368;
34
+ /**
35
+ * A batch samples at most this many pages. Words 12 to 19 of its block name them: the word of a texture
36
+ * unit is the index in the frame of the page that unit holds, and 0xffffffff for a unit that holds none.
37
+ * A vertex finds its page's unit by the page index in its region's row of the region table.
38
+ */
39
+ export declare const SHARED_BATCH_PAGES_2D = 8, SHARED_NO_PAGE_2D = 4294967295;
40
+ /** The region table of one frame. Every region is written, whether or not a draw of the frame uses it. */
41
+ export declare function packSharedRegions2D(frame: PreparedSharedFrame2D['frame']): Uint32Array<ArrayBuffer>;
42
+ /**
43
+ * Backing coordinates stay backing coordinates until the fixed vertex shader. A draw whose geometry was kept
44
+ * from the last frame takes the rows kept with it, once the charges recorded with those rows fit: the rows of
45
+ * a draw depend on its geometry alone, except the place of its region and its opacity, which are written anew.
46
+ * A kept draw that rested, whose record preparation gave again, is packed once and its packed record kept:
47
+ * the next frame is given that record, while the draw goes on resting, for the charges alone.
48
+ */
49
+ export declare function packSharedDraws2D(prepared: PreparedSharedFrame2D): PackedSharedEntry2D[];
50
+ //# sourceMappingURL=packSharedDraws2D.d.ts.map