@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,586 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError, Sprite } from '@egret/runtime';
3
+ import { requireUiEngine } from '../internal/uiFactoryState.js';
4
+ import { requireUiRoot } from '../internal/uiRootState.js';
5
+ const managers = new WeakMap();
6
+ let nextManager = 0;
7
+ function fail(code) {
8
+ throw new EgretError(code);
9
+ }
10
+ function object(value) {
11
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
12
+ }
13
+ function number(value, min, max) {
14
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max)
15
+ fail('UI_VALUE_INVALID');
16
+ return value;
17
+ }
18
+ function id(value) {
19
+ if (typeof value !== 'string' || value.length < 1 || value.length > 80 || value.includes('\0'))
20
+ fail('UI_LAYER_ID_INVALID');
21
+ return value;
22
+ }
23
+ function rect(value) {
24
+ if (!object(value))
25
+ fail('UI_VALUE_INVALID');
26
+ const x = number(value.x, -1e7, 1e7), y = number(value.y, -1e7, 1e7), width = number(value.width, 1, 1e7), height = number(value.height, 1, 1e7);
27
+ if (Math.abs(x + width) > 1e7 || Math.abs(y + height) > 1e7)
28
+ fail('UI_VALUE_INVALID');
29
+ return Object.freeze({ x, y, width, height });
30
+ }
31
+ /** Optional Root composition. Intent changes never publish during routed application callbacks. */
32
+ export function createUiLayerManager(options) {
33
+ if (!object(options))
34
+ fail('UI_VALUE_INVALID');
35
+ const engine = options.engine, owner = {}, port = requireUiEngine(engine), scope = port.scope(options.scope);
36
+ const input = options.input, inputPort = port.requireInput(input), keyboardIdentity = options.keyboard, keyboard = keyboardIdentity === undefined ? undefined : port.requireKeyboard(keyboardIdentity);
37
+ const limit = number(options.maxLayers ?? 16, 1, 32), policy = options.editorPolicy ?? 'commit', invalidate = options.onInvalidate;
38
+ let viewport = rect(options.viewport);
39
+ if (!Number.isInteger(limit) ||
40
+ !['commit', 'cancel'].includes(policy) ||
41
+ (invalidate !== undefined && typeof invalidate !== 'function'))
42
+ fail('UI_VALUE_INVALID');
43
+ port.assertIdle();
44
+ scope.assertOpen();
45
+ if (managers.has(engine))
46
+ fail('UI_LAYER_MANAGER_OWNED');
47
+ const keyboardScope = keyboard === undefined ? undefined : port.keyboardScope(keyboard, owner), sequence = ++nextManager;
48
+ const entries = new Map(), errors = [];
49
+ let desired = [], stack = [], poses = [], revision = 0, wanted = 1, closed = false, admitting = false, syncing = false, notifying = false;
50
+ let removeEngine = () => { }, removeEscape = () => { };
51
+ const attempt = (action, out = errors) => {
52
+ try {
53
+ action();
54
+ }
55
+ catch (cause) {
56
+ out.push(cause);
57
+ }
58
+ };
59
+ function open() {
60
+ if (closed)
61
+ fail('UI_LAYER_CLOSED');
62
+ port.assertOpen();
63
+ scope.assertOpen();
64
+ }
65
+ function admission() {
66
+ open();
67
+ if (admitting || syncing)
68
+ fail('UI_BUSY');
69
+ }
70
+ function request() {
71
+ wanted++;
72
+ if (!Number.isSafeInteger(wanted))
73
+ fail('UI_LIMIT');
74
+ // An observer failure cannot roll back a staged intent, or hide the original thrown value.
75
+ if (invalidate !== undefined && !notifying) {
76
+ notifying = true;
77
+ try {
78
+ invalidate();
79
+ }
80
+ catch (cause) {
81
+ if (errors.length < 64)
82
+ errors.push(cause);
83
+ }
84
+ finally {
85
+ notifying = false;
86
+ }
87
+ }
88
+ }
89
+ function resolve(name) {
90
+ const entry = entries.get(name);
91
+ return entry ?? fail('UI_LAYER_UNKNOWN');
92
+ }
93
+ function closeEntry(entry) {
94
+ const index = desired.indexOf(entry);
95
+ if (index < 0)
96
+ return;
97
+ desired = desired.slice(0, index);
98
+ request();
99
+ }
100
+ function dismiss(entry) {
101
+ if (closed || !entry.escape || desired.at(-1) !== entry)
102
+ return false;
103
+ closeEntry(entry);
104
+ return true;
105
+ }
106
+ function retire(entry, restore) {
107
+ if (entries.get(entry.id) !== entry)
108
+ return;
109
+ entries.delete(entry.id);
110
+ const at = desired.indexOf(entry);
111
+ if (at >= 0)
112
+ desired = desired.slice(0, at);
113
+ // Anchors hold registration identity, so reusing an id cannot revive an old popup.
114
+ desired = desired.filter((value, index, all) => value.anchor === undefined ||
115
+ (entries.get(value.anchor.parent.id) === value.anchor.parent &&
116
+ (value.anchor.parent.kind === 'base' || all.indexOf(value.anchor.parent) < index)));
117
+ for (const listener of entry.listeners)
118
+ attempt(listener);
119
+ attempt(entry.unsubscribe);
120
+ attempt(entry.release);
121
+ attempt(() => entry.keyboardRegistration?.dispose());
122
+ if (restore && entry.port.state() === 'open') {
123
+ attempt(() => entry.port.releaseLayer(entry.kind === 'base'));
124
+ attempt(() => {
125
+ errors.push(...entry.port.notifyInteraction(policy));
126
+ });
127
+ }
128
+ attempt(() => entry.scope?.dispose());
129
+ // Unregister publishes lifetime revocation immediately; held contacts cannot wait for another sync.
130
+ if (!port.terminal() && inputPort.state() === 'active')
131
+ attempt(() => inputPort.sync());
132
+ if (!closed)
133
+ request();
134
+ }
135
+ function plan() {
136
+ const active = [];
137
+ // Missing/recycled anchors retire their popup and the complete descendant stack.
138
+ for (const entry of desired) {
139
+ if (entries.get(entry.id) !== entry || entry.port.state() !== 'open')
140
+ break;
141
+ if (entry.anchor !== undefined) {
142
+ const parent = entry.anchor.parent;
143
+ if (entries.get(parent.id) !== parent ||
144
+ (parent.kind !== 'base' && !active.includes(parent)) ||
145
+ parent.port.anchor(entry.anchor.target) === undefined)
146
+ break;
147
+ }
148
+ active.push(entry);
149
+ }
150
+ // sync is already the publication request; automatic retirement has no observer callout.
151
+ if (active.length !== desired.length) {
152
+ desired = active;
153
+ wanted++;
154
+ }
155
+ const top = active.at(-1);
156
+ let modal = -1;
157
+ for (let index = 0; index < active.length; index++)
158
+ if (active[index].kind === 'modal')
159
+ modal = index;
160
+ const values = [], byEntry = new Map();
161
+ const ordered = [...entries.values()]
162
+ .filter(e => e.kind === 'base')
163
+ .concat(active, [...entries.values()].filter(e => e.kind !== 'base' && !active.includes(e)));
164
+ for (const entry of ordered) {
165
+ const state = entry.port.layerState();
166
+ if (state.input !== input || state.keyboard !== keyboard)
167
+ fail('UI_LAYER_INPUT_MISMATCH');
168
+ const visible = entry.kind === 'base' || active.includes(entry);
169
+ if (!state.mutable || (visible && entry.kind !== 'base' && !stack.includes(entry) && !state.ready))
170
+ return undefined;
171
+ const size = state.snapshot.viewport;
172
+ let x = state.snapshot.origin.x, y = state.snapshot.origin.y;
173
+ if (visible && entry.kind !== 'base') {
174
+ if (size.width > viewport.width || size.height > viewport.height)
175
+ fail('UI_LAYER_VIEWPORT_TOO_SMALL');
176
+ if (entry.anchor !== undefined) {
177
+ const parent = byEntry.get(entry.anchor.parent), box = entry.anchor.parent.port.anchor(entry.anchor.target);
178
+ if (parent === undefined || !parent.visible || box === undefined)
179
+ return undefined;
180
+ x =
181
+ parent.x +
182
+ box.x +
183
+ (entry.anchor.align === 'start' ? 0 : (box.width - size.width) / (entry.anchor.align === 'end' ? 1 : 2));
184
+ const below = parent.y + box.y + box.height + entry.anchor.gap, above = parent.y + box.y - size.height - entry.anchor.gap;
185
+ y = entry.anchor.placement === 'below' ? below : above;
186
+ if (y + size.height > viewport.y + viewport.height && above >= viewport.y)
187
+ y = above;
188
+ else if (y < viewport.y && below + size.height <= viewport.y + viewport.height)
189
+ y = below;
190
+ }
191
+ else {
192
+ x = viewport.x + (viewport.width - size.width) / 2;
193
+ y = viewport.y + (viewport.height - size.height) / 2;
194
+ }
195
+ x = Math.max(viewport.x, Math.min(x, viewport.x + viewport.width - size.width));
196
+ y = Math.max(viewport.y, Math.min(y, viewport.y + viewport.height - size.height));
197
+ }
198
+ const index = active.indexOf(entry), pointer = visible && (modal < 0 || index >= modal), key = visible && (top === undefined || entry === top);
199
+ const value = { entry, x, y, visible, pointer, keyboard: key, content: state };
200
+ values.push(value);
201
+ byEntry.set(entry, value);
202
+ }
203
+ return values;
204
+ }
205
+ function same(a, b) {
206
+ return (a.length === b.length &&
207
+ a.every((x, i) => {
208
+ const y = b[i];
209
+ return (x.entry === y.entry &&
210
+ x.x === y.x &&
211
+ x.y === y.y &&
212
+ x.visible === y.visible &&
213
+ x.pointer === y.pointer &&
214
+ x.keyboard === y.keyboard);
215
+ }));
216
+ }
217
+ function order(values) {
218
+ return values
219
+ .filter(value => value.visible)
220
+ .flatMap(value => value.entry.backdrop === undefined
221
+ ? [value.entry.port.wrapper]
222
+ : [value.entry.backdrop, value.entry.port.wrapper]);
223
+ }
224
+ function ordered(nodes) {
225
+ const start = port.stage.numChildren - nodes.length;
226
+ return start >= 0 && nodes.every((node, index) => port.stage.getChildAt(start + index) === node);
227
+ }
228
+ function focus(top, restore, out) {
229
+ if (keyboard === undefined || keyboard.getSnapshot().state !== 'active')
230
+ return;
231
+ function accept(action) {
232
+ try {
233
+ action();
234
+ return true;
235
+ }
236
+ catch (cause) {
237
+ if (!(cause instanceof EgretError &&
238
+ (cause.code === 'KEYBOARD_TARGET_INELIGIBLE' || cause.code === 'UI_ROW_NOT_REALIZED')))
239
+ out.push(cause);
240
+ return false;
241
+ }
242
+ }
243
+ if (restore?.id !== undefined && accept(() => keyboard.focus(restore.id, { visible: restore.visible })))
244
+ return;
245
+ if (top?.initialFocus !== undefined &&
246
+ accept(() => top.root.list(top.initialFocus.listId).focus(top.initialFocus.key, { visible: true })))
247
+ return;
248
+ if (keyboard.getSnapshot().focusedId !== undefined)
249
+ return;
250
+ accept(() => {
251
+ keyboardScope.focusFirst();
252
+ });
253
+ if (keyboard.getSnapshot().focusedId === undefined && top?.sentinel !== undefined)
254
+ accept(() => keyboard.focus(top.sentinel));
255
+ }
256
+ function sync() {
257
+ if (closed)
258
+ return Object.freeze({ kind: 'closed', revision, postCommitErrors: Object.freeze([]) });
259
+ admission();
260
+ port.assertIdle();
261
+ syncing = true;
262
+ const out = errors.splice(0);
263
+ const result = (kind) => Object.freeze({ kind, revision, postCommitErrors: Object.freeze(out.concat(errors.splice(0))) });
264
+ try {
265
+ let next = plan();
266
+ if (closed)
267
+ return result('closed');
268
+ if (next === undefined)
269
+ return result('pending');
270
+ let reorder = !ordered(order(next));
271
+ const topology = stack.length !== desired.length || stack.some((entry, index) => entry !== desired[index]);
272
+ if (!topology && !reorder && same(poses, next) && revision === wanted)
273
+ return result('unchanged');
274
+ const epoch = wanted, roots = next.map(value => [value.entry, value.content.snapshot.committedRevision, value.content.snapshot.desiredRevision]);
275
+ const previousFocus = keyboard?.getSnapshot();
276
+ if (inputPort.activeContacts() !== 0)
277
+ attempt(() => input.cancelAll('suspended'), out);
278
+ if (closed)
279
+ return result('closed');
280
+ // Cancellation is a user-code boundary. Reject a stale continuation, never overwrite its intent.
281
+ if (epoch !== wanted ||
282
+ roots.some(([entry, committed, pending]) => entries.get(entry.id) !== entry ||
283
+ entry.port.state() !== 'open' ||
284
+ entry.port.layerState().snapshot.committedRevision !== committed ||
285
+ entry.port.layerState().snapshot.desiredRevision !== pending))
286
+ return result('pending');
287
+ next = plan();
288
+ if (closed)
289
+ return result('closed');
290
+ if (next === undefined || epoch !== wanted)
291
+ return result('pending');
292
+ reorder = !ordered(order(next));
293
+ let common = 0;
294
+ while (common < stack.length && common < desired.length && stack[common] === desired[common])
295
+ common++;
296
+ const restore = stack[common]?.savedFocus;
297
+ for (const entry of desired.slice(common))
298
+ entry.savedFocus = Object.freeze({
299
+ id: previousFocus?.focusedId,
300
+ visible: previousFocus?.focusVisible ?? false
301
+ });
302
+ const top = desired.at(-1);
303
+ // From here through publication there are no application callbacks or resource acquisitions.
304
+ for (const value of next) {
305
+ const { entry } = value;
306
+ if (entry.backdrop !== undefined) {
307
+ entry.backdrop.x = viewport.x;
308
+ entry.backdrop.y = viewport.y;
309
+ entry.backdrop.visible = value.visible;
310
+ entry.backdrop.touchEnabled = value.visible;
311
+ entry.backdrop.touchChildren = false;
312
+ entry.backdrop.scaleX = viewport.width;
313
+ entry.backdrop.scaleY = viewport.height;
314
+ entry.backdrop.hitArea = { x: 0, y: 0, width: 1, height: 1 };
315
+ if (value.visible && reorder)
316
+ port.stage.setChildIndex(entry.backdrop, port.stage.numChildren - 1);
317
+ }
318
+ if (value.content.visible !== value.visible ||
319
+ value.content.pointerEnabled !== value.pointer ||
320
+ value.content.keyboardEnabled !== value.keyboard ||
321
+ value.entry.root.snapshot().origin.x !== value.x ||
322
+ value.entry.root.snapshot().origin.y !== value.y ||
323
+ (value.visible && reorder)) {
324
+ entry.port.presentLayer({
325
+ x: value.x,
326
+ y: value.y,
327
+ visible: value.visible,
328
+ pointerEnabled: value.pointer,
329
+ keyboardEnabled: value.keyboard,
330
+ ...(value.visible && reorder ? { index: port.stage.numChildren - 1 } : {})
331
+ });
332
+ }
333
+ }
334
+ poses = next;
335
+ stack = [...desired];
336
+ revision = epoch;
337
+ // Native sessions retire against the new eligibility before logical focus can move.
338
+ for (const value of next) {
339
+ if (closed)
340
+ break;
341
+ if (entries.get(value.entry.id) === value.entry && value.entry.port.state() === 'open')
342
+ out.push(...value.entry.port.notifyInteraction(policy));
343
+ }
344
+ if (!closed) {
345
+ attempt(() => keyboardScope?.setRoots(top === undefined ? undefined : [top.port.wrapper, top.backdrop]), out);
346
+ if (topology)
347
+ focus(top, restore, out);
348
+ attempt(() => inputPort.sync(), out);
349
+ }
350
+ return result(closed ? 'closed' : 'committed');
351
+ }
352
+ finally {
353
+ syncing = false;
354
+ }
355
+ }
356
+ const api = Object.freeze({
357
+ register(configuration) {
358
+ admission();
359
+ port.assertIdle();
360
+ admitting = true;
361
+ let entry, ownScope, release = () => { }, unsubscribe = () => { }, registration;
362
+ const listeners = [];
363
+ try {
364
+ if (!object(configuration))
365
+ fail('UI_VALUE_INVALID');
366
+ const name = id(configuration.id), root = configuration.root, kind = configuration.kind, rawAnchor = configuration.anchor, rawFocus = configuration.initialFocus;
367
+ const escape = configuration.closeOnEscape ?? true, outside = configuration.closeOnOutside ?? kind === 'popup';
368
+ const color = number(configuration.backdropColor ?? 0x0b1320, 0, 0xffffff), alpha = number(configuration.backdropAlpha ?? (kind === 'modal' ? 0.45 : 0), 0, 1);
369
+ if (!['base', 'popup', 'modal'].includes(kind) ||
370
+ typeof escape !== 'boolean' ||
371
+ typeof outside !== 'boolean' ||
372
+ !Number.isInteger(color) ||
373
+ (kind === 'base' && rawAnchor !== undefined))
374
+ fail('UI_VALUE_INVALID');
375
+ if (entries.has(name))
376
+ fail('UI_LAYER_ID_DUPLICATE');
377
+ if (entries.size >= limit)
378
+ fail('UI_LIMIT');
379
+ const access = requireUiRoot(root, engine), state = access.layerState();
380
+ if (state.input !== input || state.keyboard !== keyboard)
381
+ fail('UI_LAYER_INPUT_MISMATCH');
382
+ let anchor;
383
+ if (rawAnchor !== undefined) {
384
+ if (!object(rawAnchor) || !object(rawAnchor.target))
385
+ fail('UI_VALUE_INVALID');
386
+ const parentRoot = rawAnchor.root, placement = rawAnchor.placement ?? 'below', align = rawAnchor.align ?? 'start', gap = number(rawAnchor.gap ?? 4, 0, 4096), target = rawAnchor.target;
387
+ const parent = [...entries.values()].find(value => value.root === parentRoot);
388
+ if (parent === undefined ||
389
+ !['above', 'below'].includes(placement) ||
390
+ !['start', 'center', 'end'].includes(align))
391
+ fail('UI_LAYER_ANCHOR_INVALID');
392
+ const captured = target.kind === 'leaf'
393
+ ? Object.freeze({ kind: 'leaf', id: id(target.id) })
394
+ : target.kind === 'row'
395
+ ? Object.freeze({ kind: 'row', listId: id(target.listId), key: id(target.key) })
396
+ : fail('UI_LAYER_ANCHOR_INVALID');
397
+ anchor = Object.freeze({ parent, target: captured, placement, align, gap });
398
+ }
399
+ const initialFocus = rawFocus === undefined ? undefined : Object.freeze({ listId: id(rawFocus.listId), key: id(rawFocus.key) });
400
+ open();
401
+ port.assertIdle();
402
+ if (entries.has(name) || entries.size >= limit)
403
+ fail('UI_LIMIT');
404
+ release = access.claimLayer(owner, () => entry !== undefined && dismiss(entry));
405
+ let backdrop, sentinel;
406
+ if (kind !== 'base') {
407
+ ownScope = port.createScope();
408
+ backdrop = ownScope.use(new Sprite());
409
+ backdrop.graphics.beginFill(color, alpha).drawRect(0, 0, 1, 1).endFill();
410
+ backdrop.visible = false;
411
+ backdrop.touchEnabled = false;
412
+ port.stage.addChild(backdrop);
413
+ sentinel = 'egret.layer.' + sequence + '.' + name;
414
+ registration = keyboard?.registerTarget({ id: sentinel, target: backdrop, tabIndex: -1 });
415
+ const bg = backdrop;
416
+ listeners.push(bg.on(input.events.begin, event => {
417
+ event.stopPropagation();
418
+ event.preventDefault();
419
+ input.capture(event.payload.session, bg);
420
+ }));
421
+ listeners.push(bg.on(input.events.end, event => {
422
+ event.stopPropagation();
423
+ event.preventDefault();
424
+ if (entry !== undefined && entry.outside && stack.at(-1) === entry)
425
+ closeEntry(entry);
426
+ }));
427
+ listeners.push(bg.on(input.events.cancel, event => {
428
+ event.stopPropagation();
429
+ }));
430
+ }
431
+ unsubscribe = access.onClose(() => {
432
+ if (entry !== undefined)
433
+ retire(entry, false);
434
+ });
435
+ entry = {
436
+ id: name,
437
+ kind,
438
+ root,
439
+ port: access,
440
+ anchor,
441
+ initialFocus,
442
+ escape,
443
+ outside,
444
+ scope: ownScope,
445
+ backdrop,
446
+ sentinel,
447
+ keyboardRegistration: registration,
448
+ release,
449
+ unsubscribe,
450
+ listeners: Object.freeze(listeners),
451
+ savedFocus: undefined
452
+ };
453
+ entries.set(name, entry);
454
+ request();
455
+ return Object.freeze({
456
+ id: name,
457
+ dispose() {
458
+ if (entry !== undefined)
459
+ retire(entry, true);
460
+ }
461
+ });
462
+ }
463
+ catch (cause) {
464
+ for (const listener of listeners)
465
+ attempt(listener);
466
+ attempt(unsubscribe);
467
+ attempt(release);
468
+ attempt(() => registration?.dispose());
469
+ attempt(() => ownScope?.dispose());
470
+ throw cause;
471
+ }
472
+ finally {
473
+ admitting = false;
474
+ }
475
+ },
476
+ open(name) {
477
+ open();
478
+ const entry = resolve(id(name));
479
+ if (entry.kind === 'base')
480
+ fail('UI_LAYER_BASE');
481
+ if (desired.includes(entry))
482
+ return;
483
+ if (entry.anchor !== undefined && entry.anchor.parent.kind !== 'base' && !desired.includes(entry.anchor.parent))
484
+ fail('UI_LAYER_ANCHOR_INVALID');
485
+ desired = [...desired, entry];
486
+ request();
487
+ },
488
+ close(name) {
489
+ open();
490
+ const entry = resolve(id(name));
491
+ if (entry.kind === 'base')
492
+ fail('UI_LAYER_BASE');
493
+ closeEntry(entry);
494
+ },
495
+ setViewport(value) {
496
+ admission();
497
+ const next = rect(value);
498
+ open();
499
+ if (next.x === viewport.x &&
500
+ next.y === viewport.y &&
501
+ next.width === viewport.width &&
502
+ next.height === viewport.height)
503
+ return;
504
+ viewport = next;
505
+ request();
506
+ },
507
+ sync,
508
+ snapshot() {
509
+ return Object.freeze({
510
+ state: closed ? 'closed' : 'open',
511
+ committedRevision: revision,
512
+ desiredRevision: wanted,
513
+ viewport,
514
+ openStack: Object.freeze(stack.map(entry => entry.id)),
515
+ desiredStack: Object.freeze(desired.map(entry => entry.id)),
516
+ layers: Object.freeze([...entries.values()].map(entry => {
517
+ const pose = poses.find(value => value.entry === entry);
518
+ return Object.freeze({
519
+ id: entry.id,
520
+ kind: entry.kind,
521
+ visible: pose?.visible ?? false,
522
+ pointerEnabled: pose?.pointer ?? false,
523
+ keyboardEnabled: pose?.keyboard ?? false,
524
+ origin: Object.freeze({ x: pose?.x ?? 0, y: pose?.y ?? 0 })
525
+ });
526
+ })),
527
+ counters: Object.freeze({
528
+ registered: entries.size,
529
+ open: stack.length,
530
+ backdrops: [...entries.values()].filter(entry => entry.backdrop !== undefined).length
531
+ })
532
+ });
533
+ },
534
+ dispose() {
535
+ if (closed)
536
+ return;
537
+ closed = true;
538
+ scope.remove(onAbort);
539
+ attempt(removeEngine);
540
+ attempt(removeEscape);
541
+ attempt(() => keyboardScope?.release());
542
+ if (!port.terminal() && inputPort.state() === 'active')
543
+ attempt(() => input.cancelAll('owner'));
544
+ for (const entry of [...entries.values()])
545
+ retire(entry, true);
546
+ entries.clear();
547
+ desired = [];
548
+ stack = [];
549
+ poses = [];
550
+ if (managers.get(engine) === owner)
551
+ managers.delete(engine);
552
+ const failure = errors.splice(0);
553
+ if (failure.length !== 0)
554
+ throw new EgretError('UI_LAYER_CLEANUP_FAILED', { cause: failure[0], cleanupErrors: failure.slice(1) });
555
+ }
556
+ });
557
+ function onAbort() {
558
+ api.dispose();
559
+ }
560
+ try {
561
+ managers.set(engine, owner);
562
+ removeEngine = port.onClose(onAbort);
563
+ scope.add(onAbort);
564
+ scope.use(api);
565
+ if (keyboard !== undefined)
566
+ removeEscape = port.stage.on(keyboard.events.keyDown, event => {
567
+ const top = stack.at(-1);
568
+ if (top !== undefined && event.payload.key === 'Escape' && !event.payload.repeat && dismiss(top)) {
569
+ event.preventDefault();
570
+ event.stopPropagation();
571
+ }
572
+ }, { capture: true });
573
+ scope.assertOpen();
574
+ return api;
575
+ }
576
+ catch (cause) {
577
+ try {
578
+ api.dispose();
579
+ }
580
+ catch {
581
+ /* Preserve the setup failure. */
582
+ }
583
+ throw cause;
584
+ }
585
+ }
586
+ //# sourceMappingURL=layers.js.map
@@ -0,0 +1,21 @@
1
+ import type { UiThemeNode } from './theme.js';
2
+ import type { UiLayoutNode, UiLayoutTree } from '@egret/runtime/ui';
3
+ import type { LayoutNode, UiLeafContent } from './types.js';
4
+ export interface CapturedLeafContent {
5
+ readonly identity: UiLeafContent;
6
+ readonly revision: number;
7
+ readonly prepare: UiLeafContent['prepare'];
8
+ }
9
+ export interface CapturedUiTree {
10
+ readonly themes: ReadonlyMap<string, UiThemeNode>;
11
+ readonly tree: UiLayoutTree;
12
+ readonly contents: ReadonlyMap<string, CapturedLeafContent>;
13
+ }
14
+ /** Content authority remains in Engine; the runtime tree contains numbers and callbacks only. */
15
+ export declare function captureUiTree(input: LayoutNode): CapturedUiTree;
16
+ /** Constraint discovery never invokes an authored measure or publishes provisional geometry. */
17
+ export declare function leafConstraintTree(tree: UiLayoutTree, contents: ReadonlyMap<string, CapturedLeafContent>, widths: Map<string, number>): UiLayoutTree;
18
+ /** The callback captures only frozen numeric metrics, never a Scope, source or display node. */
19
+ export declare function fixedLeafMeasurement(width: number, height: number, revision: number): NonNullable<UiLayoutNode['measure']>;
20
+ export declare function leafMeasuredTree(tree: UiLayoutTree, measures: ReadonlyMap<string, NonNullable<UiLayoutNode['measure']>>): UiLayoutTree;
21
+ //# sourceMappingURL=leafContent.d.ts.map