@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,562 @@
1
+ import { CancellationController, EgretError, Event, Scope, createEventType } from '@egret/runtime';
2
+ import { registerMouseInputEngine, registerMouseInputInstance, registerMouseInputScope, requireMouseInputEngine } from './internal/mouseInputFactoryState.js';
3
+ export { createBitmapButton } from './bitmapButton.js';
4
+ const APPLY = Reflect.apply;
5
+ const SCOPE_STATE = Object.getOwnPropertyDescriptor(Scope.prototype, 'state').get;
6
+ const SCOPE_USE = Scope.prototype.use;
7
+ const tokens = new WeakMap();
8
+ const NATIVE_LIFETIME_ENDED = Symbol('egret.nativeInputLifetimeEnded');
9
+ /** Internal cleanup-only provenance never escapes the native delivery boundary. */
10
+ class NativeCleanupFailure {
11
+ cause;
12
+ constructor(cause) {
13
+ this.cause = cause;
14
+ }
15
+ }
16
+ /** Signal methods are captured per assembly, permitting transparent pre-assembly observation. */
17
+ export function createMouseInputOwner(engine, assembly) {
18
+ const sample = new CancellationController().signal;
19
+ const prototype = Object.getPrototypeOf(sample);
20
+ const aborted = Object.getOwnPropertyDescriptor(prototype, 'aborted').get;
21
+ const add = Object.getOwnPropertyDescriptor(prototype, 'addEventListener')
22
+ .value;
23
+ const remove = Object.getOwnPropertyDescriptor(prototype, 'removeEventListener')
24
+ .value;
25
+ const originalSignals = new WeakMap();
26
+ const records = new Set();
27
+ const shutdown = new Set();
28
+ let started = false;
29
+ const port = Object.freeze({
30
+ surface: assembly.surface,
31
+ operations: assembly.operations,
32
+ assertOpen: assembly.assertOpen,
33
+ report: assembly.report,
34
+ captureCleanup: assembly.captureCleanup,
35
+ assertReady() {
36
+ assembly.assertOpen();
37
+ if (!started)
38
+ throw new EgretError('MOUSE_INPUT_INVALID');
39
+ },
40
+ markStarted() {
41
+ started = true;
42
+ },
43
+ scope(value) {
44
+ assembly.assertOpen();
45
+ const signal = originalSignals.get(value);
46
+ if (signal === undefined)
47
+ throw new EgretError('MOUSE_INPUT_SCOPE_INVALID');
48
+ const scope = value;
49
+ const assertScopeOpen = () => {
50
+ assembly.assertOpen();
51
+ if (APPLY(SCOPE_STATE, scope, []) !== 'open' || APPLY(aborted, signal, []) === true)
52
+ throw new EgretError('SCOPE_CLOSED');
53
+ };
54
+ assertScopeOpen();
55
+ const once = Object.freeze({ once: true });
56
+ return Object.freeze({
57
+ scope,
58
+ signal,
59
+ assertOpen: assertScopeOpen,
60
+ use(value) {
61
+ APPLY(SCOPE_USE, scope, [value]);
62
+ },
63
+ add(listener) {
64
+ APPLY(add, signal, ['abort', listener, once]);
65
+ },
66
+ remove(listener) {
67
+ APPLY(remove, signal, ['abort', listener]);
68
+ }
69
+ });
70
+ },
71
+ onClose(listener) {
72
+ assembly.assertOpen();
73
+ shutdown.add(listener);
74
+ return () => {
75
+ shutdown.delete(listener);
76
+ };
77
+ },
78
+ addRecord(record) {
79
+ records.add(record);
80
+ },
81
+ removeRecord(record) {
82
+ records.delete(record);
83
+ }
84
+ });
85
+ registerMouseInputEngine(engine, port);
86
+ return Object.freeze({
87
+ registerScope(scope) {
88
+ originalSignals.set(scope, scope.signal);
89
+ registerMouseInputScope(scope, engine);
90
+ },
91
+ close() {
92
+ for (const record of [...records])
93
+ retire(record, 'owner');
94
+ const listeners = [...shutdown];
95
+ shutdown.clear();
96
+ for (const listener of listeners) {
97
+ try {
98
+ listener();
99
+ }
100
+ catch (cause) {
101
+ assembly.captureCleanup(cause);
102
+ assembly.report({ code: 'POINTER_INPUT_CLEANUP_FAILED', phase: 'engine', severity: 'error', cause });
103
+ }
104
+ }
105
+ }
106
+ });
107
+ }
108
+ /** The registry keeps a closed genuine identity without retaining Engine/Scope ports. */
109
+ function buttonInputPort(record) {
110
+ const assertOpen = () => {
111
+ if (record.state === 'closed' || record.phase !== 'ready')
112
+ throw new EgretError('BITMAP_BUTTON_INPUT_CLOSED');
113
+ record.owner.assertReady();
114
+ record.scope.assertOpen();
115
+ };
116
+ return Object.freeze({
117
+ assertOpen,
118
+ add(association) {
119
+ assertOpen();
120
+ if (record.buttons.has(association.target))
121
+ throw new EgretError('BITMAP_BUTTON_SETUP_FAILED');
122
+ record.buttons.set(association.target, association);
123
+ },
124
+ remove(association) {
125
+ if (record.buttons.get(association.target) === association)
126
+ record.buttons.delete(association.target);
127
+ }
128
+ });
129
+ }
130
+ function live(record) {
131
+ if (record.state === 'closed' || record.owner === undefined || record.scope === undefined)
132
+ return false;
133
+ try {
134
+ record.owner.assertReady();
135
+ record.scope.assertOpen();
136
+ return true;
137
+ }
138
+ catch (cause) {
139
+ if (cause instanceof EgretError && (cause.code === 'ENGINE_CLOSED' || cause.code === 'SCOPE_CLOSED')) {
140
+ retire(record, 'owner');
141
+ return false;
142
+ }
143
+ throw cause;
144
+ }
145
+ }
146
+ function removePair(record, pair) {
147
+ if (pair.inFlight || pair.removeAttempted)
148
+ return;
149
+ pair.removeAttempted = true;
150
+ try {
151
+ // MI1 control: one exact physical pair removal, independent of logical closure.
152
+ pair.remove(pair.listener);
153
+ pair.removeSucceeded = true;
154
+ }
155
+ catch (cause) {
156
+ record.cleanupErrors.push(cause);
157
+ }
158
+ }
159
+ function finishRetirement(record) {
160
+ if (record.phase !== 'retiring' || record.pairs.some(pair => pair.inFlight || !pair.removeAttempted))
161
+ return;
162
+ const owner = record.owner;
163
+ record.phase = 'closed';
164
+ record.owner = undefined;
165
+ record.scope = undefined;
166
+ record.native = undefined;
167
+ record.surface = undefined;
168
+ record.pairs = [];
169
+ if (record.retirement === 'owner' &&
170
+ !record.wasAcquiring &&
171
+ record.cleanupErrors.length !== 0 &&
172
+ owner !== undefined) {
173
+ const error = new EgretError('MOUSE_INPUT_CLEANUP_FAILED', {
174
+ cause: record.cleanupErrors[0],
175
+ cleanupErrors: record.cleanupErrors.slice(1)
176
+ });
177
+ owner.captureCleanup(error);
178
+ owner.report({ code: 'MOUSE_INPUT_CLEANUP_FAILED', phase: 'engine', severity: 'error', cause: error });
179
+ }
180
+ }
181
+ function retire(record, reason) {
182
+ if (record.state === 'closed')
183
+ return;
184
+ record.wasAcquiring = record.phase === 'acquiring';
185
+ record.state = 'closed';
186
+ record.phase = 'retiring';
187
+ record.held = undefined;
188
+ record.retirement = reason;
189
+ record.owner?.removeRecord(record);
190
+ const buttons = [...record.buttons.values()];
191
+ record.buttons.clear();
192
+ for (const button of buttons) {
193
+ try {
194
+ record.cleanupErrors.push(...button.retire());
195
+ }
196
+ catch (cause) {
197
+ record.cleanupErrors.push(cause);
198
+ }
199
+ }
200
+ if (record.surface !== undefined && tokens.get(record.surface) === record.token)
201
+ tokens.delete(record.surface);
202
+ for (let index = record.pairs.length - 1; index >= 0; index--) {
203
+ const pair = record.pairs[index];
204
+ if (pair !== undefined)
205
+ removePair(record, pair);
206
+ }
207
+ finishRetirement(record);
208
+ }
209
+ function inputEvent(type, payload) {
210
+ return Object.freeze(new Event(type, payload));
211
+ }
212
+ function payload(id, point) {
213
+ return Object.freeze({ pointerId: id, globalX: point.x, globalY: point.y, pointerType: 'mouse', button: 0 });
214
+ }
215
+ function cancelPress(record, reason) {
216
+ const held = record.held;
217
+ record.held = undefined;
218
+ record.state = 'idle';
219
+ if (held === undefined || !live(record))
220
+ return;
221
+ const operations = record.owner.operations;
222
+ held.button?.cancel();
223
+ if (!operations.isAttached(held.target, record.maximum))
224
+ return;
225
+ const data = Object.freeze({ ...payload(held.id, held.point), reason });
226
+ operations.dispatch(held.target, inputEvent(record.events.cancel, data), record.maximum);
227
+ }
228
+ function nativeOperation(record, kind, event) {
229
+ const native = record.native;
230
+ const operations = record.owner.operations;
231
+ if (kind === 'blur' || kind === 'pagehide') {
232
+ if (!native.windowEvent(event, kind) || !live(record))
233
+ return;
234
+ if (kind === 'pagehide') {
235
+ let hasFailure = false, failure;
236
+ try {
237
+ cancelPress(record, 'pagehide');
238
+ }
239
+ catch (cause) {
240
+ hasFailure = true;
241
+ failure = cause;
242
+ }
243
+ finally {
244
+ retire(record, 'native');
245
+ }
246
+ if (hasFailure)
247
+ throw failure;
248
+ if (record.retirement === 'native' && !record.failureEpisode && record.cleanupErrors.length !== 0)
249
+ throw new NativeCleanupFailure(record.cleanupErrors[0]);
250
+ }
251
+ else
252
+ cancelPress(record, 'blur');
253
+ return;
254
+ }
255
+ if ((kind === 'down' && record.held !== undefined) || (kind !== 'down' && record.held === undefined))
256
+ return;
257
+ const id = native.pointer(event, kind, record.held?.id);
258
+ if (id === undefined || !live(record))
259
+ return;
260
+ if (kind === 'cancel') {
261
+ cancelPress(record, 'pointercancel');
262
+ return;
263
+ }
264
+ const point = native.point(event);
265
+ if (!live(record))
266
+ return;
267
+ if (kind === 'down') {
268
+ const target = operations.pick(point.x, point.y, record.maximum);
269
+ if (target === undefined || !live(record))
270
+ return;
271
+ const held = { target, id, point, beginAllowed: false, token: {}, button: record.buttons.get(target) };
272
+ record.held = held;
273
+ record.state = 'pressed';
274
+ held.button?.beforeBegin(held.token);
275
+ // MI1 control: begin dispatch is a distinct genuine input operation.
276
+ const allowed = operations.dispatch(target, inputEvent(record.events.begin, payload(id, point)), record.maximum);
277
+ if (record.held === held && live(record))
278
+ held.beginAllowed = allowed;
279
+ return;
280
+ }
281
+ const held = record.held;
282
+ const first = operations.pick(point.x, point.y, record.maximum);
283
+ record.held = undefined;
284
+ record.state = 'idle';
285
+ try {
286
+ // Reset the private skin before end, even when release is outside/detached.
287
+ held.button?.beforeEnd(held.token);
288
+ if (!live(record) || !operations.isAttached(held.target, record.maximum))
289
+ return;
290
+ // MI1 control: end stays on the held target even when release selects a sibling.
291
+ const endAllowed = operations.dispatch(held.target, inputEvent(record.events.end, payload(id, point)), record.maximum);
292
+ if (!live(record) ||
293
+ first !== held.target ||
294
+ !held.beginAllowed ||
295
+ !endAllowed ||
296
+ !operations.isAttached(held.target, record.maximum))
297
+ return;
298
+ // MI1 control: re-pick the same consumed release point after end callbacks.
299
+ const second = operations.pick(point.x, point.y, record.maximum);
300
+ if (second === held.target && live(record) && operations.isAttached(held.target, record.maximum)) {
301
+ const data = payload(id, point);
302
+ operations.dispatch(held.target, inputEvent(record.events.activate, data), record.maximum);
303
+ // A control's callback is distinct from the unchanged public activate route.
304
+ // Settings/life/token checks precede this final original pick after the route.
305
+ held.button?.afterActivate(held.token, data, () => live(record) &&
306
+ operations.isAttached(held.target, record.maximum) &&
307
+ operations.pick(point.x, point.y, record.maximum) === held.target &&
308
+ live(record) &&
309
+ operations.isAttached(held.target, record.maximum));
310
+ }
311
+ }
312
+ finally {
313
+ held.button?.finish(held.token);
314
+ }
315
+ }
316
+ function callbackFailure(record, owner, cause, primaryCleanup = false) {
317
+ if (record.failureEpisode &&
318
+ (Object.is(cause, record.failureCause) || (record.failureError !== undefined && cause === record.failureError)))
319
+ return;
320
+ // Publish the episode before teardown callouts so nested native delivery cannot replay it.
321
+ record.failureEpisode = true;
322
+ record.failureCause = cause;
323
+ record.failureError = undefined;
324
+ retire(record, 'native');
325
+ const error = new EgretError('MOUSE_INPUT_CALLBACK_FAILED', {
326
+ cause,
327
+ cleanupErrors: primaryCleanup ? record.cleanupErrors.slice(1) : record.cleanupErrors
328
+ });
329
+ record.failureError = error;
330
+ owner.report({ code: 'MOUSE_INPUT_CALLBACK_FAILED', phase: 'engine', severity: 'error', cause: error });
331
+ }
332
+ function deliver(record, kind, event) {
333
+ if (record.phase !== 'ready')
334
+ return;
335
+ const owner = record.owner;
336
+ if (record.busy) {
337
+ callbackFailure(record, owner, new EgretError('MOUSE_INPUT_REENTRANT'));
338
+ return;
339
+ }
340
+ record.busy = true;
341
+ try {
342
+ if (live(record)) {
343
+ for (const button of [...record.buttons.values()])
344
+ button.syncTerminal();
345
+ if (record.phase === 'ready')
346
+ nativeOperation(record, kind, event);
347
+ }
348
+ }
349
+ catch (cause) {
350
+ if (cause === NATIVE_LIFETIME_ENDED) {
351
+ retire(record, 'owner');
352
+ return;
353
+ }
354
+ if (cause instanceof NativeCleanupFailure)
355
+ callbackFailure(record, owner, cause.cause, true);
356
+ else
357
+ callbackFailure(record, owner, cause);
358
+ }
359
+ finally {
360
+ record.busy = false;
361
+ record.failureEpisode = false;
362
+ record.failureCause = undefined;
363
+ record.failureError = undefined;
364
+ }
365
+ }
366
+ function addPair(record, add, remove, listener) {
367
+ const pair = {
368
+ add,
369
+ remove,
370
+ listener,
371
+ inFlight: true,
372
+ addSucceeded: false,
373
+ removeAttempted: false,
374
+ removeSucceeded: false
375
+ };
376
+ record.pairs.push(pair);
377
+ try {
378
+ pair.add(pair.listener);
379
+ pair.addSucceeded = true;
380
+ }
381
+ finally {
382
+ pair.inFlight = false;
383
+ if (record.state === 'closed') {
384
+ removePair(record, pair);
385
+ finishRetirement(record);
386
+ }
387
+ }
388
+ }
389
+ /** The browser entry admits options before reading any DOM capabilities or installing listeners. */
390
+ export function createMouseInputWithNative(options, nativeFactory) {
391
+ if (options === null || typeof options !== 'object')
392
+ throw new EgretError('MOUSE_INPUT_OPTIONS_INVALID');
393
+ let array;
394
+ try {
395
+ array = Array.isArray(options);
396
+ }
397
+ catch (cause) {
398
+ throw new EgretError('MOUSE_INPUT_OPTIONS_INVALID', { cause });
399
+ }
400
+ if (array)
401
+ throw new EgretError('MOUSE_INPUT_OPTIONS_INVALID');
402
+ let engine;
403
+ try {
404
+ engine = options.engine;
405
+ }
406
+ catch (cause) {
407
+ throw new EgretError('MOUSE_INPUT_OPTIONS_INVALID', { cause });
408
+ }
409
+ const owner = requireMouseInputEngine(engine);
410
+ let requestedScope;
411
+ try {
412
+ requestedScope = options.scope;
413
+ }
414
+ catch (cause) {
415
+ throw new EgretError('MOUSE_INPUT_OPTIONS_INVALID', { cause });
416
+ }
417
+ owner.assertReady();
418
+ const scope = owner.scope(requestedScope);
419
+ let width, height, requestedMaximum;
420
+ try {
421
+ width = options.width;
422
+ height = options.height;
423
+ requestedMaximum = options.maxNodes;
424
+ }
425
+ catch (cause) {
426
+ throw new EgretError('MOUSE_INPUT_OPTIONS_INVALID', { cause });
427
+ }
428
+ const assertLive = () => {
429
+ owner.assertReady();
430
+ scope.assertOpen();
431
+ };
432
+ let ready = false;
433
+ const assertNativeLive = () => {
434
+ try {
435
+ assertLive();
436
+ }
437
+ catch (cause) {
438
+ // Only this callback-free authority check may mark successful native continuation closure.
439
+ if (ready && cause instanceof EgretError && (cause.code === 'ENGINE_CLOSED' || cause.code === 'SCOPE_CLOSED'))
440
+ throw NATIVE_LIFETIME_ENDED;
441
+ throw cause;
442
+ }
443
+ };
444
+ assertLive();
445
+ const maximum = requestedMaximum === undefined ? 4096 : requestedMaximum;
446
+ if (typeof width !== 'number' ||
447
+ !Number.isFinite(width) ||
448
+ width <= 0 ||
449
+ typeof height !== 'number' ||
450
+ !Number.isFinite(height) ||
451
+ height <= 0 ||
452
+ typeof maximum !== 'number' ||
453
+ !Number.isInteger(maximum) ||
454
+ maximum < 1 ||
455
+ maximum > 65536)
456
+ throw new EgretError('MOUSE_INPUT_OPTIONS_INVALID');
457
+ const native = nativeFactory(owner.surface, width, height, assertNativeLive);
458
+ assertLive();
459
+ if (tokens.has(owner.surface))
460
+ throw new EgretError('MOUSE_INPUT_IN_USE');
461
+ const events = Object.freeze({
462
+ begin: createEventType('egret.mouse.begin', { bubbles: true, cancelable: true }),
463
+ end: createEventType('egret.mouse.end', { bubbles: true, cancelable: true }),
464
+ activate: createEventType('egret.mouse.activate', { bubbles: true, cancelable: false }),
465
+ cancel: createEventType('egret.mouse.cancel', {
466
+ bubbles: true,
467
+ cancelable: false
468
+ })
469
+ });
470
+ const record = {
471
+ state: 'idle',
472
+ phase: 'acquiring',
473
+ busy: false,
474
+ failureEpisode: false,
475
+ failureCause: undefined,
476
+ failureError: undefined,
477
+ owner,
478
+ scope,
479
+ native,
480
+ held: undefined,
481
+ events,
482
+ buttons: new Map(),
483
+ maximum,
484
+ token: {},
485
+ surface: owner.surface,
486
+ pairs: [],
487
+ cleanupErrors: [],
488
+ retirement: undefined,
489
+ wasAcquiring: false
490
+ };
491
+ const facade = Object.freeze({
492
+ get state() {
493
+ if (this !== facade)
494
+ throw new EgretError('MOUSE_INPUT_INVALID');
495
+ return record.state;
496
+ },
497
+ events,
498
+ dispose() {
499
+ if (this !== facade)
500
+ throw new EgretError('MOUSE_INPUT_INVALID');
501
+ if (record.state === 'closed')
502
+ return;
503
+ retire(record, 'explicit');
504
+ if (record.cleanupErrors.length !== 0)
505
+ throw new EgretError('MOUSE_INPUT_CLEANUP_FAILED', {
506
+ cause: record.cleanupErrors[0],
507
+ cleanupErrors: record.cleanupErrors.slice(1)
508
+ });
509
+ }
510
+ });
511
+ registerMouseInputInstance(facade, engine, buttonInputPort(record));
512
+ tokens.set(owner.surface, record.token);
513
+ owner.addRecord(record);
514
+ let hasFailure = false, failure, sourceFailure = false;
515
+ const acquire = (add, remove, listener) => {
516
+ try {
517
+ addPair(record, add, remove, listener);
518
+ }
519
+ catch (cause) {
520
+ sourceFailure = true;
521
+ throw cause;
522
+ }
523
+ };
524
+ try {
525
+ scope.use(facade);
526
+ assertLive();
527
+ acquire(scope.add, scope.remove, () => {
528
+ retire(record, 'owner');
529
+ });
530
+ assertLive();
531
+ for (const pair of native.pairs) {
532
+ // A leaked closed callback retains the scalar kind and record, not the native target/ports.
533
+ const kind = pair.kind;
534
+ acquire(pair.add, pair.remove, (event) => {
535
+ deliver(record, kind, event);
536
+ });
537
+ assertLive();
538
+ }
539
+ assertLive();
540
+ if (record.state === 'closed')
541
+ throw new EgretError('SCOPE_CLOSED');
542
+ record.phase = 'ready';
543
+ ready = true;
544
+ return facade;
545
+ }
546
+ catch (cause) {
547
+ hasFailure = true;
548
+ failure = cause;
549
+ }
550
+ retire(record, 'setup');
551
+ if (hasFailure &&
552
+ !sourceFailure &&
553
+ failure instanceof EgretError &&
554
+ (failure.code === 'ENGINE_CLOSED' || failure.code === 'SCOPE_CLOSED')) {
555
+ throw new EgretError(failure.code, {
556
+ cause: failure.cause,
557
+ cleanupErrors: [...failure.cleanupErrors, ...record.cleanupErrors]
558
+ });
559
+ }
560
+ throw new EgretError('MOUSE_INPUT_SETUP_FAILED', { cause: failure, cleanupErrors: record.cleanupErrors });
561
+ }
562
+ //# sourceMappingURL=mouseInput.js.map
@@ -0,0 +1,37 @@
1
+ import type { EventType, Scope } from '@egret/runtime';
2
+ import type { Engine } from './Engine.js';
3
+ declare const MOUSE_INPUT: unique symbol;
4
+ /** Fixed logical dimensions; browser layout scaling does not change game coordinates. */
5
+ export interface MouseInputOptions {
6
+ readonly engine: Engine;
7
+ readonly scope: Scope;
8
+ readonly width: number;
9
+ readonly height: number;
10
+ readonly maxNodes?: number;
11
+ }
12
+ export type MouseInputState = 'idle' | 'pressed' | 'closed';
13
+ export type MouseInputCancelReason = 'pointercancel' | 'blur' | 'pagehide';
14
+ export interface MouseInputPayload {
15
+ readonly pointerId: number;
16
+ readonly globalX: number;
17
+ readonly globalY: number;
18
+ readonly pointerType: 'mouse';
19
+ readonly button: 0;
20
+ }
21
+ export interface MouseInputEvents {
22
+ readonly begin: EventType<MouseInputPayload>;
23
+ readonly end: EventType<MouseInputPayload>;
24
+ readonly activate: EventType<MouseInputPayload>;
25
+ readonly cancel: EventType<MouseInputPayload & {
26
+ readonly reason: MouseInputCancelReason;
27
+ }>;
28
+ }
29
+ /** Scope-owned synchronous input. Obtain it from the optional browser entry. */
30
+ export interface MouseInput {
31
+ readonly [MOUSE_INPUT]: true;
32
+ readonly state: MouseInputState;
33
+ readonly events: MouseInputEvents;
34
+ dispose(): void;
35
+ }
36
+ export {};
37
+ //# sourceMappingURL=mouseInputTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=mouseInputTypes.js.map
@@ -0,0 +1,8 @@
1
+ import type { Scope } from '@egret/runtime';
2
+ import type { Engine } from './Engine.js';
3
+ import type { Paragraph, ParagraphCache } from '@egret/runtime/paragraph';
4
+ export { createParagraphCache } from '@egret/runtime/paragraph';
5
+ export type * from '@egret/runtime/paragraph';
6
+ /** Optional paragraph assembly authenticates Engine, Scope and exact cache profile. */
7
+ export declare function createParagraph(engine: Engine, scope: Scope, cache: ParagraphCache): Paragraph;
8
+ //# sourceMappingURL=paragraph.d.ts.map
@@ -0,0 +1,7 @@
1
+ import { requireTextFieldEngine } from './internal/textFieldFactoryState.js';
2
+ export { createParagraphCache } from '@egret/runtime/paragraph';
3
+ /** Optional paragraph assembly authenticates Engine, Scope and exact cache profile. */
4
+ export function createParagraph(engine, scope, cache) {
5
+ return requireTextFieldEngine(engine).construct(scope, cache, 'paragraph');
6
+ }
7
+ //# sourceMappingURL=paragraph.js.map
@@ -0,0 +1,4 @@
1
+ import type { ParticleEmitter, ParticleEmitterOptions } from './particleTypes.js';
2
+ /** A stream of particles over one texture, drawn as one mesh that is built again each update. */
3
+ export declare function createParticleEmitter(options: ParticleEmitterOptions): ParticleEmitter;
4
+ //# sourceMappingURL=particleEmitter.d.ts.map