@egret/engine 0.0.0-stage → 7.0.2

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 (601) 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 +469 -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 +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -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 +17 -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 +47 -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 +246 -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 +31 -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 +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -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 +419 -0
  57. package/dist/cameraTypes.d.ts +126 -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 +35 -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 +45 -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 +39 -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 +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -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 +142 -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 +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -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 +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -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 +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -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 +41 -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 +300 -0
  145. package/dist/particleTypes.d.ts +115 -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 +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -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 +379 -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 +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -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 +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -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 +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,46 @@
1
+ import type { DisplayObjectContainer } from '@egret/runtime';
2
+ import type { UiDisplayOperations, UiDisplayUpdate, UiHeightIndex, UiLayoutTree } from '@egret/runtime/ui';
3
+ import type { UiEnginePort } from '../internal/uiFactoryState.js';
4
+ import type { UiRowSnapshot } from './types.js';
5
+ import type { Binding, ScopePort, Shell, WindowState } from './uiRootModel.js';
6
+ interface DisplayDraft {
7
+ updates: UiDisplayUpdate[];
8
+ nextBindings: Map<string, Binding>;
9
+ nextShells: Map<string, Shell>;
10
+ freshShells: Shell[];
11
+ fillScopes: ScopePort[];
12
+ rows: UiRowSnapshot[];
13
+ available: Shell[];
14
+ childWrappers: DisplayObjectContainer[];
15
+ }
16
+ export declare function createUiRootDisplayDraft(pool: readonly Shell[], shells: ReadonlyMap<string, Shell>, finalKeys: readonly string[]): DisplayDraft;
17
+ interface DisplayPreparation {
18
+ w: WindowState;
19
+ finalKeys: readonly string[];
20
+ view: UiHeightIndex | ReturnType<UiHeightIndex['stageHeights']> | undefined;
21
+ shells: ReadonlyMap<string, Shell>;
22
+ port: Pick<UiEnginePort, 'scope' | 'createScope'>;
23
+ display: Pick<UiDisplayOperations, 'createWrapper'>;
24
+ tree: UiLayoutTree;
25
+ listWrapper: DisplayObjectContainer | undefined;
26
+ listId: string | undefined;
27
+ rootWrapper: DisplayObjectContainer;
28
+ layerOrigin: Readonly<{
29
+ x: number;
30
+ y: number;
31
+ }> | undefined;
32
+ position: Readonly<{
33
+ x: number;
34
+ y: number;
35
+ }>;
36
+ size: Readonly<{
37
+ width: number;
38
+ height: number;
39
+ }>;
40
+ layerVisible: boolean;
41
+ layerPointer: boolean;
42
+ }
43
+ /** Append detached display updates in the root transaction's original paint order. */
44
+ export declare function stageUiRootDisplay(draft: DisplayDraft, preparation: DisplayPreparation): void;
45
+ export {};
46
+ //# sourceMappingURL=uiRootDisplay.d.ts.map
@@ -0,0 +1,148 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { Sprite } from '@egret/runtime';
3
+ const freeze = Object.freeze;
4
+ export function createUiRootDisplayDraft(pool, shells, finalKeys) {
5
+ const updates = [], nextBindings = new Map(), nextShells = new Map(), freshShells = [], fillScopes = [], rows = [];
6
+ const available = [...pool, ...[...shells].filter(([key]) => !finalKeys.includes(key)).map(([, s]) => s)];
7
+ const childWrappers = [];
8
+ return { updates, nextBindings, nextShells, freshShells, fillScopes, rows, available, childWrappers };
9
+ }
10
+ /** Append detached display updates in the root transaction's original paint order. */
11
+ export function stageUiRootDisplay(draft, preparation) {
12
+ const { updates, nextBindings, nextShells, freshShells, fillScopes, rows, available, childWrappers } = draft;
13
+ const { w, finalKeys, view, shells, port, display, tree, listWrapper, listId, rootWrapper, layerOrigin, position, size, layerVisible, layerPointer } = preparation;
14
+ let priorIndex = -2, priorEnd = 0;
15
+ for (const key of finalKeys) {
16
+ const b = w.bindings.get(key), i = view.indexOf(key), top = i === priorIndex + 1 ? priorEnd : view.prefix(i), y = top - w.scroll, h = view.heightAt(i), visible = y + h > 0 && y < w.height;
17
+ priorIndex = i;
18
+ priorEnd = top + h;
19
+ const shell = shells.get(key) ??
20
+ available.shift() ??
21
+ (() => {
22
+ const scope = port.scope(port.createScope());
23
+ const item = {
24
+ scope,
25
+ wrapper: display.createWrapper(scope.scope)
26
+ };
27
+ freshShells.push(item);
28
+ return item;
29
+ })();
30
+ nextBindings.set(key, b);
31
+ nextShells.set(key, shell);
32
+ childWrappers.push(shell.wrapper);
33
+ updates.push({
34
+ wrapper: shell.wrapper,
35
+ x: 0,
36
+ y,
37
+ visible,
38
+ children: [b.wrapper],
39
+ touchEnabled: false,
40
+ touchChildren: true
41
+ });
42
+ updates.push({
43
+ wrapper: b.wrapper,
44
+ x: 0,
45
+ y: 0,
46
+ visible,
47
+ children: [b.content],
48
+ hitArea: {
49
+ x: 0,
50
+ y: 0,
51
+ width: w.width,
52
+ height: h
53
+ },
54
+ touchEnabled: visible,
55
+ touchChildren: false
56
+ });
57
+ rows.push(freeze({
58
+ key,
59
+ index: i,
60
+ bindingGeneration: b.generation,
61
+ contentVersion: b.version,
62
+ box: freeze({
63
+ x: w.box.innerX,
64
+ y: w.box.innerY + y,
65
+ width: w.width,
66
+ height: h
67
+ }),
68
+ visible
69
+ }));
70
+ }
71
+ const rootChildren = [], paintOrder = new Map();
72
+ for (const [paintIndex, box] of w.plan.boxes.entries()) {
73
+ const node = tree.nodes.get(box.id);
74
+ if (node.kind === 'leaf' && node.fill !== undefined) {
75
+ const scope = port.scope(port.createScope());
76
+ fillScopes.push(scope);
77
+ const shape = new Sprite();
78
+ scope.use(shape);
79
+ const color = node.fill;
80
+ shape.graphics
81
+ .beginFill(color.color, color.alpha ?? 1)
82
+ .drawRect(0, 0, box.width, box.height)
83
+ .endFill();
84
+ const wrapper = display.createWrapper(scope.scope);
85
+ updates.push({
86
+ wrapper,
87
+ x: box.x,
88
+ y: box.y,
89
+ children: [shape],
90
+ touchEnabled: false,
91
+ touchChildren: false
92
+ });
93
+ rootChildren.push(wrapper);
94
+ paintOrder.set(wrapper, paintIndex);
95
+ }
96
+ }
97
+ for (const [paintIndex, box] of w.plan.boxes.entries()) {
98
+ const binding = w.leafBindings.get(box.id);
99
+ if (binding === undefined)
100
+ continue;
101
+ updates.push({
102
+ wrapper: binding.wrapper,
103
+ x: box.innerX,
104
+ y: box.innerY,
105
+ children: [binding.content],
106
+ hitArea: { x: 0, y: 0, width: box.innerWidth, height: box.innerHeight },
107
+ touchEnabled: false,
108
+ touchChildren: true
109
+ });
110
+ rootChildren.push(binding.wrapper);
111
+ paintOrder.set(binding.wrapper, paintIndex);
112
+ }
113
+ if (w.box !== undefined && listWrapper !== undefined) {
114
+ rootChildren.push(listWrapper);
115
+ paintOrder.set(listWrapper, w.plan.boxes.findIndex(box => box.id === listId));
116
+ updates.push({
117
+ wrapper: listWrapper,
118
+ x: w.box.innerX,
119
+ y: w.box.innerY,
120
+ clipRect: {
121
+ x: 0,
122
+ y: 0,
123
+ width: w.width,
124
+ height: w.height
125
+ },
126
+ children: childWrappers,
127
+ touchEnabled: false,
128
+ touchChildren: true
129
+ });
130
+ }
131
+ updates.push({
132
+ wrapper: rootWrapper,
133
+ x: layerOrigin?.x ?? position.x,
134
+ y: layerOrigin?.y ?? position.y,
135
+ clipRect: {
136
+ x: 0,
137
+ y: 0,
138
+ width: size.width,
139
+ height: size.height
140
+ },
141
+ children: rootChildren,
142
+ visible: layerVisible,
143
+ touchEnabled: false,
144
+ touchChildren: layerPointer
145
+ });
146
+ rootChildren.sort((a, b) => paintOrder.get(a) - paintOrder.get(b));
147
+ }
148
+ //# sourceMappingURL=uiRootDisplay.js.map
@@ -0,0 +1,114 @@
1
+ import { EgretError } from '@egret/runtime';
2
+ import type { DisplayObjectContainer } from '@egret/runtime';
3
+ import type { UiHeightIndex, UiLayoutTree, UiLayoutNode, UiLayoutPlan, UiLayoutBox } from '@egret/runtime/ui';
4
+ import type { UiScopePort } from '../internal/uiFactoryState.js';
5
+ import type { CapturedLeafContent } from './leafContent.js';
6
+ import type { UiRowSnapshot, UiSnapshot, RowUnbindInfo } from './types.js';
7
+ import type { UiTheme } from './theme.js';
8
+ import type { CapturedSource } from './virtualList.js';
9
+ export type ScopePort = UiScopePort;
10
+ export interface Binding {
11
+ theme: UiTheme | undefined;
12
+ key: string;
13
+ version: number;
14
+ generation: number;
15
+ width: number;
16
+ density: number;
17
+ source: Pick<CapturedSource, 'identity' | 'bind' | 'unbind'> | undefined;
18
+ scope: ScopePort;
19
+ wrapper: DisplayObjectContainer;
20
+ content?: DisplayObjectContainer;
21
+ height?: number;
22
+ entered: boolean;
23
+ terminal: boolean;
24
+ subscriptions: (() => void)[];
25
+ }
26
+ export interface LeafBinding {
27
+ theme: UiTheme | undefined;
28
+ readonly id: string;
29
+ readonly width: number;
30
+ readonly density: number;
31
+ readonly scope: ScopePort;
32
+ readonly wrapper: DisplayObjectContainer;
33
+ source: CapturedLeafContent | undefined;
34
+ content?: DisplayObjectContainer;
35
+ height?: number;
36
+ measure?: NonNullable<UiLayoutNode['measure']>;
37
+ terminal: boolean;
38
+ }
39
+ export interface Shell {
40
+ scope: ScopePort;
41
+ wrapper: DisplayObjectContainer;
42
+ }
43
+ export interface WindowState {
44
+ theme: UiTheme | undefined;
45
+ paintOnly: boolean;
46
+ cleanupErrors: unknown[];
47
+ revision: number;
48
+ source: CapturedSource | undefined;
49
+ index: UiHeightIndex | undefined;
50
+ plan: UiLayoutPlan | undefined;
51
+ box: UiLayoutBox | undefined;
52
+ width: number;
53
+ height: number;
54
+ scroll: number;
55
+ round: number;
56
+ heights: Map<string, {
57
+ key: string;
58
+ height: number;
59
+ contentVersion: number;
60
+ }>;
61
+ bindings: Map<string, Binding>;
62
+ leafBindings: Map<string, LeafBinding>;
63
+ }
64
+ export interface Candidate {
65
+ nextPool: Shell[];
66
+ discardedShells: Shell[];
67
+ retiring: readonly {
68
+ binding: Binding;
69
+ reason: RowUnbindInfo['reason'];
70
+ }[];
71
+ oldFills: ScopePort[];
72
+ retiringLeaves: readonly LeafBinding[];
73
+ preparedWindow: WindowState;
74
+ rows: readonly UiRowSnapshot[];
75
+ bindings: Map<string, Binding>;
76
+ shells: Map<string, Shell>;
77
+ freshShells: Shell[];
78
+ fillScopes: ScopePort[];
79
+ displayToken: object;
80
+ indexJournal: ReturnType<UiHeightIndex['stageHeights']> | undefined;
81
+ snapshot: UiSnapshot;
82
+ inputGeneration: number;
83
+ layerGeneration: number;
84
+ }
85
+ export interface TokenState {
86
+ used: boolean;
87
+ retired?: boolean;
88
+ candidate?: Candidate;
89
+ }
90
+ export declare function withoutSources(tree: UiLayoutTree): UiLayoutTree;
91
+ export declare function preparationError(cause: unknown, cleanupErrors: unknown[]): EgretError;
92
+ export declare function fail(code: string, reason?: string): never;
93
+ /** Why a root is busy with its own work: a preparation that has not settled, or a commit being made. */
94
+ export declare function failBusy(preparing: boolean): never;
95
+ export declare function next(value: number): number;
96
+ export declare function number(value: number, min: number, max: number): number;
97
+ export declare function viewport(value: Readonly<{
98
+ width: number;
99
+ height: number;
100
+ }>): Readonly<{
101
+ width: number;
102
+ height: number;
103
+ }>;
104
+ export declare function origin(value: Readonly<{
105
+ x: number;
106
+ y: number;
107
+ }>, size: Readonly<{
108
+ width: number;
109
+ height: number;
110
+ }>): Readonly<{
111
+ x: number;
112
+ y: number;
113
+ }>;
114
+ //# sourceMappingURL=uiRootModel.d.ts.map
@@ -0,0 +1,66 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ import { captureUiLayout } from '@egret/runtime/ui';
4
+ const freeze = Object.freeze;
5
+ const sourceMarker = freeze({});
6
+ // Layout caches retain numeric descriptors, never historical data source snapshots.
7
+ export function withoutSources(tree) {
8
+ function copy(node) {
9
+ const result = freeze({
10
+ ...node,
11
+ ...(node.kind === 'virtualList'
12
+ ? {
13
+ source: sourceMarker
14
+ }
15
+ : {}),
16
+ ...(node.children === undefined
17
+ ? {}
18
+ : {
19
+ children: freeze(node.children.map(copy))
20
+ })
21
+ });
22
+ return result;
23
+ }
24
+ const root = copy(tree.root);
25
+ return captureUiLayout(root);
26
+ }
27
+ export function preparationError(cause, cleanupErrors) {
28
+ if (cause instanceof EgretError && cleanupErrors.length === 0)
29
+ return cause;
30
+ return new EgretError(cause instanceof EgretError ? cause.code : 'UI_PREPARE_FAILED', { cause, cleanupErrors });
31
+ }
32
+ export function fail(code, reason) {
33
+ throw new EgretError(code, reason === undefined ? {} : { cause: new Error(reason) });
34
+ }
35
+ /** Why a root is busy with its own work: a preparation that has not settled, or a commit being made. */
36
+ export function failBusy(preparing) {
37
+ fail('UI_BUSY', preparing
38
+ ? 'an earlier prepare() of this root has not settled yet: await it, then prepare again'
39
+ : 'a commit of this root is being made');
40
+ }
41
+ export function next(value) {
42
+ if (value >= Number.MAX_SAFE_INTEGER)
43
+ fail('UI_REVISION_EXHAUSTED');
44
+ return value + 1;
45
+ }
46
+ export function number(value, min, max) {
47
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max)
48
+ fail('UI_VALUE_INVALID');
49
+ return value === 0 ? 0 : value;
50
+ }
51
+ export function viewport(value) {
52
+ return freeze({
53
+ width: number(value.width, Number.MIN_VALUE, 16384),
54
+ height: number(value.height, Number.MIN_VALUE, 16384)
55
+ });
56
+ }
57
+ export function origin(value, size) {
58
+ const x = number(value.x, -1048576, 1048576), y = number(value.y, -1048576, 1048576);
59
+ if (Math.abs(x + size.width) > 1048576 || Math.abs(y + size.height) > 1048576)
60
+ fail('UI_VALUE_INVALID');
61
+ return freeze({
62
+ x,
63
+ y
64
+ });
65
+ }
66
+ //# sourceMappingURL=uiRootModel.js.map
@@ -0,0 +1,20 @@
1
+ import type { UiHeightView } from '@egret/runtime/ui';
2
+ import type { VirtualDataSource, VirtualRecord, VirtualListRevealOptions } from './types.js';
3
+ export interface CapturedSource {
4
+ readonly identity: object;
5
+ readonly revision: number;
6
+ readonly records: readonly VirtualRecord<unknown>[];
7
+ readonly byKey: ReadonlyMap<string, VirtualRecord<unknown>>;
8
+ readonly bind: VirtualDataSource<unknown>['bind'];
9
+ readonly unbind: VirtualDataSource<unknown>['unbind'];
10
+ }
11
+ export declare function captureSource(source: VirtualDataSource<unknown>): CapturedSource;
12
+ export interface RevealIntent {
13
+ readonly key: string;
14
+ readonly align: NonNullable<VirtualListRevealOptions['align']>;
15
+ }
16
+ /** Capture caller-controlled options before the owner mutates any pending intent. */
17
+ export declare function captureReveal(key: string | undefined, options?: VirtualListRevealOptions): RevealIntent | undefined;
18
+ /** Resolve against each staged height view, without a second index or hidden row retention. */
19
+ export declare function revealScroll(view: UiHeightView, intent: RevealIntent, current: number, height: number): number;
20
+ //# sourceMappingURL=virtualList.d.ts.map
@@ -0,0 +1,105 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ export function captureSource(source) {
4
+ if (source === null || typeof source !== 'object')
5
+ throw new EgretError('UI_SOURCE_INVALID');
6
+ const revision = source.revision, records = source.records, bind = source.bind, unbind = source.unbind;
7
+ if (!Number.isSafeInteger(revision) ||
8
+ revision < 0 ||
9
+ !Array.isArray(records) ||
10
+ typeof bind !== 'function' ||
11
+ typeof unbind !== 'function')
12
+ throw new EgretError('UI_SOURCE_INVALID');
13
+ // Snapshot the caller-controlled count once, before allocation or indexed reads.
14
+ const count = records.length;
15
+ if (!Number.isInteger(count) || count < 0 || count > 50000)
16
+ throw new EgretError('UI_SOURCE_INVALID');
17
+ const byKey = new Map(), copied = [];
18
+ for (let index = 0; index < count; index++) {
19
+ const record = records[index];
20
+ if (record === null || typeof record !== 'object')
21
+ throw new EgretError('UI_SOURCE_INVALID');
22
+ const key = record.key, contentVersion = record.contentVersion, estimatedHeight = record.estimatedHeight, value = record.value;
23
+ if (typeof key !== 'string' ||
24
+ key.length === 0 ||
25
+ key.length > 128 ||
26
+ byKey.has(key) ||
27
+ !Number.isSafeInteger(contentVersion) ||
28
+ contentVersion < 0 ||
29
+ !Number.isFinite(estimatedHeight) ||
30
+ estimatedHeight < 1 ||
31
+ estimatedHeight > 1048576)
32
+ throw new EgretError('UI_SOURCE_INVALID');
33
+ const item = Object.freeze({
34
+ key,
35
+ contentVersion,
36
+ estimatedHeight,
37
+ value
38
+ });
39
+ copied.push(item);
40
+ byKey.set(key, item);
41
+ }
42
+ return Object.freeze({
43
+ identity: source,
44
+ revision,
45
+ records: Object.freeze(copied),
46
+ byKey,
47
+ bind,
48
+ unbind
49
+ });
50
+ }
51
+ /** Capture caller-controlled options before the owner mutates any pending intent. */
52
+ export function captureReveal(key, options) {
53
+ if (key === undefined) {
54
+ if (options !== undefined)
55
+ throw new EgretError('UI_VALUE_INVALID');
56
+ return undefined;
57
+ }
58
+ if (typeof key !== 'string' || key.length === 0 || key.length > 128)
59
+ throw new EgretError('UI_VALUE_INVALID');
60
+ let align = 'nearest';
61
+ if (options !== undefined) {
62
+ if (options === null || typeof options !== 'object')
63
+ throw new EgretError('UI_VALUE_INVALID');
64
+ const prototype = Object.getPrototypeOf(options);
65
+ if (prototype !== Object.prototype && prototype !== null)
66
+ throw new EgretError('UI_VALUE_INVALID');
67
+ for (const name of Reflect.ownKeys(options))
68
+ if (name !== 'align')
69
+ throw new EgretError('UI_VALUE_INVALID');
70
+ const value = options.align;
71
+ if (value !== undefined) {
72
+ if (value !== 'nearest' && value !== 'start' && value !== 'center' && value !== 'end')
73
+ throw new EgretError('UI_VALUE_INVALID');
74
+ align = value;
75
+ }
76
+ }
77
+ return Object.freeze({ key, align });
78
+ }
79
+ /** Resolve against each staged height view, without a second index or hidden row retention. */
80
+ export function revealScroll(view, intent, current, height) {
81
+ const index = view.indexOf(intent.key);
82
+ if (index < 0)
83
+ throw new EgretError('UI_UNKNOWN_KEY');
84
+ const top = view.prefix(index), bottom = top + view.heightAt(index), scroll = view.clampScroll(current, height);
85
+ let target;
86
+ switch (intent.align) {
87
+ case 'start':
88
+ target = top;
89
+ break;
90
+ case 'center':
91
+ target = (top + bottom - height) / 2;
92
+ break;
93
+ case 'end':
94
+ target = bottom - height;
95
+ break;
96
+ default:
97
+ // Keep both fully visible short rows and tall rows covering the viewport stable.
98
+ if ((top >= scroll && bottom <= scroll + height) || (top <= scroll && bottom >= scroll + height))
99
+ target = scroll;
100
+ else
101
+ target = Math.abs(top - scroll) <= Math.abs(bottom - height - scroll) ? top : bottom - height;
102
+ }
103
+ return view.clampScroll(target, height);
104
+ }
105
+ //# sourceMappingURL=virtualList.js.map
@@ -0,0 +1,4 @@
1
+ /** Optional video: the pictures of a source shown as a display object, each new one leased as a texture. */
2
+ export { createVideo } from './videoPlayer.js';
3
+ export type { Video, VideoFrame, VideoOptions, VideoSnapshot, VideoSource, VideoSourceState, VideoState } from './videoTypes.js';
4
+ //# sourceMappingURL=video.d.ts.map
package/dist/video.js ADDED
@@ -0,0 +1,4 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ /** Optional video: the pictures of a source shown as a display object, each new one leased as a texture. */
3
+ export { createVideo } from './videoPlayer.js';
4
+ //# sourceMappingURL=video.js.map
@@ -0,0 +1,4 @@
1
+ import type { Video, VideoOptions } from './videoTypes.js';
2
+ /** A video as a display object: each new picture its source gives becomes, through the Engine's assets, the texture of one Bitmap. */
3
+ export declare function createVideo(options: VideoOptions): Video;
4
+ //# sourceMappingURL=videoPlayer.d.ts.map