@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
package/dist/Engine.js ADDED
@@ -0,0 +1,464 @@
1
+ import { createDisplaySubtreeTickets } from './displaySubtreeTicket.js';
2
+ import { SHARED_FRAME_PROFILE_2D } from '@egret/contracts';
3
+ import { collectSharedFrameContent } from '@egret/runtime';
4
+ import { EgretError, createScope, createStage, createAssetManager, reportDiagnostic, createDisplayInputOperations } from '@egret/runtime';
5
+ import { createBitmapResourceSlotOwner } from './bitmapResourceSlot.js';
6
+ import { createBitmapBindingOwner } from './bitmapBindingTicket.js';
7
+ import { closeHost } from './closeHost.js';
8
+ import { registerSharedFrame } from './internal/texturedFrameState.js';
9
+ import { createGameClockOwner } from './gameClock.js';
10
+ import { createTweenOwner } from './tween.js';
11
+ import { registerTextFieldEngine } from './internal/textFieldFactoryState.js';
12
+ import { createAssetGroupOwner } from './assetGroup.js';
13
+ import { createManifestAssetGroupOwner } from './manifestAssetGroup.js';
14
+ import { createMouseInputOwner } from './mouseInput.js';
15
+ import { createSequencePlaybackOwner } from './sequencePlayback.js';
16
+ import { registerUiEngine } from './internal/uiFactoryState.js';
17
+ import { createSequenceTargetClaims } from './sequenceTargetClaims.js';
18
+ import { registerSequenceControllerEngine } from './internal/sequenceControllerFactoryState.js';
19
+ import { registerContentEngine } from './internal/contentFactoryState.js';
20
+ export let constructEngine;
21
+ const freezeSharedFrame = Object.freeze;
22
+ const CREATION_TOKEN = Symbol('egret.engineFactory');
23
+ /** Observation does not accept asynchronous submission or prove host completion. */
24
+ function observeRejectedRenderResult(result) {
25
+ const ignoreRejection = () => { };
26
+ try {
27
+ // Intrinsic brand checking recognizes native Promises from other realms and
28
+ // avoids consulting an overridden .then property on a native Promise.
29
+ void Reflect.apply(Promise.prototype.then, result, [undefined, ignoreRejection]);
30
+ }
31
+ catch {
32
+ // Ordinary thenables (including throwing then getters) are assimilated into
33
+ // a handled Promise. Observation must not replace the invalid-port cause.
34
+ try {
35
+ void Promise.resolve(result).then(undefined, ignoreRejection);
36
+ }
37
+ catch {
38
+ /* A hostile constructor cannot make this return type acceptable. */
39
+ }
40
+ }
41
+ }
42
+ /** One headless run. Construct with createEngine(), not directly. */
43
+ export class Engine {
44
+ #displaySubtreeTickets;
45
+ #contentLoaders = new Set();
46
+ #gameClockOwner;
47
+ #tweenOwner;
48
+ #sequencePlaybackOwner;
49
+ #sequenceControllerOwner;
50
+ #assetGroupOwner;
51
+ #manifestAssetGroupOwner;
52
+ #bitmapResourceSlotOwner;
53
+ #bitmapBindingOwner;
54
+ #bitmapResourceTargets = new WeakMap();
55
+ #mouseInputOwner;
56
+ #uiOwner;
57
+ #engineScopes = new WeakSet();
58
+ frameBusy = false;
59
+ nextFrameId = 1;
60
+ frameIdle;
61
+ releaseFrame;
62
+ sharedRenderer;
63
+ #currentState = 'open';
64
+ scopes = new Set();
65
+ cleanupErrors = [];
66
+ closePromise;
67
+ host;
68
+ timeoutMs;
69
+ onDiagnostic;
70
+ releaseSurface;
71
+ #context;
72
+ stage;
73
+ assets;
74
+ sharedFrameProfile;
75
+ clock;
76
+ constructor(options, timeoutMs, surface, releaseSurface, ports, clockOptions, token) {
77
+ if (token !== CREATION_TOKEN)
78
+ throw new EgretError('ENGINE_FACTORY_REQUIRED');
79
+ this.host = options.host;
80
+ this.sharedRenderer = ports.shared;
81
+ this.sharedFrameProfile = ports.sharedProfile;
82
+ this.timeoutMs = timeoutMs;
83
+ this.onDiagnostic = options.onDiagnostic;
84
+ this.releaseSurface = releaseSurface;
85
+ const assertOpen = () => {
86
+ if (this.#currentState !== 'open')
87
+ throw new EgretError('ENGINE_CLOSED');
88
+ };
89
+ const textFields = registerTextFieldEngine(this, assertOpen, (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope));
90
+ let preparedDisplayOperations;
91
+ let assetGroupOperations;
92
+ // The context is never retained in a named public property by its consumers.
93
+ this.#context = Object.freeze({
94
+ assertOpen: () => {
95
+ if (this.#currentState !== 'open')
96
+ throw new EgretError('ENGINE_CLOSED');
97
+ },
98
+ report: (diagnostic) => reportDiagnostic(this.onDiagnostic, diagnostic),
99
+ captureCleanup: (cause) => {
100
+ if (this.#currentState === 'closing')
101
+ this.cleanupErrors.push(cause);
102
+ },
103
+ registerTextFieldCache: textFields.registerCache,
104
+ registerPreparedDisplayOperations: (operations) => {
105
+ preparedDisplayOperations = operations;
106
+ },
107
+ registerBitmapResourceTarget: (bitmap, operations) => {
108
+ this.#bitmapResourceTargets.set(bitmap, operations);
109
+ },
110
+ registerAssetGroupOperations: (operations) => {
111
+ assetGroupOperations = operations;
112
+ }
113
+ });
114
+ // The inert owner precedes publication and uses private Scope membership.
115
+ this.#gameClockOwner = createGameClockOwner({
116
+ assertOpen: this.#context.assertOpen,
117
+ isEngineScope: (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope),
118
+ isFrameBusy: () => this.frameBusy,
119
+ report: this.#context.report
120
+ }, clockOptions);
121
+ // Tween assembly receives the authentic private clock before publication.
122
+ this.#tweenOwner = createTweenOwner({
123
+ assertOpen: this.#context.assertOpen,
124
+ isEngineScope: (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope),
125
+ clock: this.#gameClockOwner.clock
126
+ });
127
+ const sequenceClaims = createSequenceTargetClaims();
128
+ // Sequence playback borrows the private clock and authentic Scope authority.
129
+ this.#sequencePlaybackOwner = createSequencePlaybackOwner({
130
+ assertOpen: this.#context.assertOpen,
131
+ isEngineScope: (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope),
132
+ clock: this.#gameClockOwner.clock,
133
+ claims: sequenceClaims,
134
+ captureCleanup: this.#context.captureCleanup
135
+ });
136
+ this.#sequenceControllerOwner = registerSequenceControllerEngine(this, {
137
+ assertOpen: this.#context.assertOpen,
138
+ createScope: () => this.#createScope(),
139
+ clock: this.#gameClockOwner.clock,
140
+ isClockBusy: this.#gameClockOwner.isBusy,
141
+ claims: sequenceClaims,
142
+ report: this.#context.report,
143
+ captureCleanup: this.#context.captureCleanup
144
+ });
145
+ this.clock = this.#gameClockOwner.clock;
146
+ const stage = createStage(this.#context);
147
+ this.#uiOwner = registerUiEngine(this, {
148
+ stage,
149
+ assertOpen: this.#context.assertOpen,
150
+ isFrameBusy: () => this.frameBusy,
151
+ createScope: () => this.#createScope(),
152
+ report: this.#context.report,
153
+ captureCleanup: this.#context.captureCleanup
154
+ });
155
+ const rawInput = createDisplayInputOperations(stage);
156
+ const deliverInput = this.#uiOwner.deliver;
157
+ const inputOperations = Object.freeze({
158
+ pick: rawInput.pick,
159
+ isAttached: rawInput.isAttached,
160
+ dispatch: (...args) => deliverInput(() => rawInput.dispatch(...args))
161
+ });
162
+ // Capture original startup and Stage authority before publishing replaceable readonly fields.
163
+ this.#mouseInputOwner = createMouseInputOwner(this, {
164
+ surface,
165
+ operations: inputOperations,
166
+ assertOpen: this.#context.assertOpen,
167
+ report: this.#context.report,
168
+ captureCleanup: this.#context.captureCleanup
169
+ });
170
+ this.stage = stage;
171
+ this.#displaySubtreeTickets = createDisplaySubtreeTickets({
172
+ assertOpen: this.#context.assertOpen,
173
+ isEngineScope: (scope) => this.#engineScopes.has(scope),
174
+ isBusy: () => this.frameBusy || this.#gameClockOwner.isBusy()
175
+ }, preparedDisplayOperations);
176
+ this.assets = createAssetManager(this.#context);
177
+ this.#bitmapBindingOwner = createBitmapBindingOwner({
178
+ assertOpen: this.#context.assertOpen,
179
+ isEngineScope: (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope)
180
+ }, this.#bitmapResourceTargets);
181
+ // Authentic manager construction captured the operations before publication.
182
+ this.#bitmapResourceSlotOwner = createBitmapResourceSlotOwner({
183
+ assertOpen: this.#context.assertOpen,
184
+ isEngineScope: (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope),
185
+ report: this.#context.report,
186
+ captureCleanup: this.#context.captureCleanup
187
+ }, assetGroupOperations, this.#bitmapResourceTargets);
188
+ this.#assetGroupOwner = createAssetGroupOwner({
189
+ assertOpen: this.#context.assertOpen,
190
+ isEngineScope: (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope),
191
+ report: this.#context.report,
192
+ captureCleanup: this.#context.captureCleanup
193
+ }, assetGroupOperations);
194
+ this.#manifestAssetGroupOwner = createManifestAssetGroupOwner({
195
+ assertOpen: this.#context.assertOpen,
196
+ isEngineScope: (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope),
197
+ report: this.#context.report,
198
+ captureCleanup: this.#context.captureCleanup
199
+ }, assetGroupOperations);
200
+ const assets = this.assets;
201
+ const register = assets.register;
202
+ registerContentEngine(this, {
203
+ assertOpen,
204
+ isScope: (scope) => typeof scope === 'object' && scope !== null && this.#engineScopes.has(scope),
205
+ register: (type, provider) => {
206
+ Reflect.apply(register, assets, [type, provider]);
207
+ },
208
+ group: (scope, manifest, roots, bindings, options) => this.#manifestAssetGroupOwner.create(scope, manifest, roots, bindings, options),
209
+ own: (dispose) => {
210
+ assertOpen();
211
+ this.#contentLoaders.add(dispose);
212
+ return () => {
213
+ this.#contentLoaders.delete(dispose);
214
+ };
215
+ }
216
+ });
217
+ }
218
+ static {
219
+ constructEngine = (options, timeoutMs, surface, releaseSurface, ports, clockOptions) => new Engine(options, timeoutMs, surface, releaseSurface, ports, clockOptions, CREATION_TOKEN);
220
+ }
221
+ advanceTime(sourceSeconds) {
222
+ return this.#gameClockOwner.advance(sourceSeconds);
223
+ }
224
+ captureSharedFrame(options) {
225
+ return this.executeSharedFrame(options, false);
226
+ }
227
+ /** Capture a prepared binding view without publishing it to the live scene. */
228
+ capturePreparedSharedFrame(ticket, options) {
229
+ return this.executeSharedFrame(options, false, [ticket]);
230
+ }
231
+ /**
232
+ * Prepare one borrowed detached root as the target container's new sole child.
233
+ * Uses authenticated already-bound private state, not fresh subclass hooks/getters.
234
+ * Run application semantic guards before preparation; Scope ownership is not their approval.
235
+ */
236
+ prepareDisplaySubtree(scope, target, candidate) {
237
+ return this.#displaySubtreeTickets.prepare(scope, target, candidate);
238
+ }
239
+ /** Immutable candidate snapshot; the live Stage remains unchanged. */
240
+ capturePreparedDisplaySharedFrame(ticket, options) {
241
+ return this.executeSharedFrame(options, false, undefined, [ticket]);
242
+ }
243
+ renderSharedFrame(options) {
244
+ return this.executeSharedFrame(options, true);
245
+ }
246
+ /** Busy precedes all external reads; cleanup waits for the finally barrier. */
247
+ executeSharedFrame(options, render, candidate, displayCandidate) {
248
+ this.#context.assertOpen();
249
+ if (this.frameBusy)
250
+ throw new EgretError('FRAME_REENTRANT');
251
+ if (this.#gameClockOwner.isBusy())
252
+ throw new EgretError('CLOCK_REENTRANT');
253
+ this.frameBusy = true;
254
+ this.frameIdle = new Promise(resolve => {
255
+ this.releaseFrame = resolve;
256
+ });
257
+ try {
258
+ const renderer = this.sharedRenderer;
259
+ if (render && renderer === undefined)
260
+ throw new EgretError('RENDERER_REQUIRED');
261
+ const prepared = displayCandidate !== undefined
262
+ ? this.#displaySubtreeTickets.read(displayCandidate[0])
263
+ : candidate === undefined
264
+ ? undefined
265
+ : this.#bitmapBindingOwner.readPreparedForCapture(candidate[0]);
266
+ let width, height, colorInput, alphaInput, outputInput;
267
+ let optionsFailed = false, optionsCause;
268
+ try {
269
+ width = options.width;
270
+ height = options.height;
271
+ colorInput = options.clearColor;
272
+ alphaInput = options.clearAlpha;
273
+ outputInput = options.outputAlpha;
274
+ }
275
+ catch (cause) {
276
+ // Even a caller-thrown EgretError is an external read failure here.
277
+ if (prepared === undefined)
278
+ throw new EgretError('INVALID_FRAME_OPTIONS', { cause });
279
+ optionsFailed = true;
280
+ optionsCause = cause;
281
+ }
282
+ // Candidate lifetime/phase wins even when an option getter threw undefined.
283
+ // Binding, target and entitlement preflight waits for valid options below.
284
+ prepared?.validate();
285
+ if (optionsFailed)
286
+ throw new EgretError('INVALID_FRAME_OPTIONS', { cause: optionsCause });
287
+ const outputAlpha = outputInput === undefined ? 'premultiplied' : outputInput;
288
+ const clearColor = colorInput === undefined ? 0 : colorInput;
289
+ const clearAlpha = alphaInput === undefined ? (outputAlpha === 'opaque' ? 1 : 0) : alphaInput;
290
+ if (typeof width !== 'number' ||
291
+ !Number.isFinite(width) ||
292
+ width <= 0 ||
293
+ typeof height !== 'number' ||
294
+ !Number.isFinite(height) ||
295
+ height <= 0 ||
296
+ typeof clearColor !== 'number' ||
297
+ !Number.isInteger(clearColor) ||
298
+ clearColor < 0 ||
299
+ clearColor > 0xffffff ||
300
+ typeof clearAlpha !== 'number' ||
301
+ !Number.isFinite(clearAlpha) ||
302
+ clearAlpha < 0 ||
303
+ clearAlpha > 1 ||
304
+ (outputAlpha !== 'opaque' && outputAlpha !== 'premultiplied') ||
305
+ (outputAlpha === 'opaque' && clearAlpha !== 1))
306
+ throw new EgretError('INVALID_FRAME_OPTIONS');
307
+ this.#context.assertOpen();
308
+ const content = prepared === undefined ? collectSharedFrameContent(this.stage) : prepared.captureContent(this.stage);
309
+ this.#context.assertOpen();
310
+ prepared?.validate();
311
+ if (!Number.isSafeInteger(this.nextFrameId) || this.nextFrameId <= 0)
312
+ throw new EgretError('FRAME_ID_EXHAUSTED');
313
+ const frame = freezeSharedFrame({
314
+ profile: SHARED_FRAME_PROFILE_2D,
315
+ colorRecipe: 'egret.linear-srgb-pma/1',
316
+ targetRepresentation: 'egret.srgb-pma8-target/1',
317
+ outputRepresentation: outputAlpha === 'opaque' ? 'egret.srgb-opaque-unorm8/1' : 'egret.srgb-premultiplied-unorm8/1',
318
+ frameId: this.nextFrameId,
319
+ width,
320
+ height,
321
+ clearColor,
322
+ clearAlpha,
323
+ outputAlpha,
324
+ ...content
325
+ });
326
+ registerSharedFrame(frame);
327
+ this.nextFrameId++;
328
+ if (render) {
329
+ try {
330
+ const result = Reflect.apply(renderer, this.host, [frame]);
331
+ if (result !== undefined) {
332
+ observeRejectedRenderResult(result);
333
+ throw new EgretError('INVALID_RENDERER');
334
+ }
335
+ }
336
+ catch (cause) {
337
+ this.#context.report({ code: 'FRAME_RENDER_FAILED', phase: 'graphics', severity: 'error', cause });
338
+ throw new EgretError('FRAME_RENDER_FAILED', { cause });
339
+ }
340
+ }
341
+ return frame;
342
+ }
343
+ finally {
344
+ this.frameBusy = false;
345
+ const release = this.releaseFrame;
346
+ this.releaseFrame = undefined;
347
+ this.frameIdle = undefined;
348
+ release?.();
349
+ }
350
+ }
351
+ createScope() {
352
+ return this.#createScope();
353
+ }
354
+ #createScope() {
355
+ this.#context.assertOpen();
356
+ const scope = createScope(this.#context, (closed) => {
357
+ this.scopes.delete(closed);
358
+ });
359
+ this.scopes.add(scope);
360
+ this.#engineScopes.add(scope);
361
+ this.#sequenceControllerOwner.registerScope(scope);
362
+ this.#mouseInputOwner.registerScope(scope);
363
+ this.#uiOwner.registerScope(scope);
364
+ return scope;
365
+ }
366
+ createTween(scope, options) {
367
+ return this.#tweenOwner.create(scope, options);
368
+ }
369
+ /** Create an idle, Scope-owned sequence controller without rendering or ticking. */
370
+ createSequencePlayback(scope, bitmap, clip, options) {
371
+ return this.#sequencePlaybackOwner.create(scope, bitmap, clip, options);
372
+ }
373
+ /** Preserve the current image while an explicitly requested replacement loads. */
374
+ createBitmapResourceSlot(scope, bitmap) {
375
+ return this.#bitmapResourceSlotOwner.create(scope, bitmap);
376
+ }
377
+ /** Capture exact Bitmap bindings before asynchronously preparing a borrowed group. */
378
+ captureBitmapBindings(scope, targets) {
379
+ return this.#bitmapBindingOwner.capture(scope, targets);
380
+ }
381
+ createAssetGroup(scope, refs, options) {
382
+ return this.#assetGroupOwner.create(scope, refs, options);
383
+ }
384
+ /** Acquire an admitted dependency closure with independent group-owned leases. */
385
+ createManifestGroup(scope, manifest, roots, bindings, options) {
386
+ return this.#manifestAssetGroupOwner.create(scope, manifest, roots, bindings, options);
387
+ }
388
+ /** Every caller shares one close promise, including reentrant cleanup callbacks. */
389
+ dispose() {
390
+ if (this.closePromise !== undefined)
391
+ return this.closePromise;
392
+ let resolveClose = () => { };
393
+ let rejectClose = () => { };
394
+ this.closePromise = new Promise((resolve, reject) => {
395
+ resolveClose = resolve;
396
+ rejectClose = reject;
397
+ });
398
+ // Cache the result before abort/cleanup/diagnostic callbacks can reenter.
399
+ this.#currentState = 'closing';
400
+ // Revoke content wrappers before manifest leases and callback-capable cleanup.
401
+ for (const dispose of [...this.#contentLoaders])
402
+ dispose();
403
+ // Detach managed UI before input and ordinary Scope/Stage cleanup.
404
+ this.#uiOwner.close();
405
+ // Revoke every manifest group before cleanup callbacks can reenter.
406
+ this.#manifestAssetGroupOwner.close();
407
+ this.#bitmapBindingOwner.close();
408
+ this.#bitmapResourceSlotOwner.close();
409
+ // Retire browser input before the remaining callback-capable owners or idle wait.
410
+ this.#mouseInputOwner.close();
411
+ // Terminal observations change now, before the existing idle barriers wait.
412
+ this.#assetGroupOwner.close();
413
+ this.#tweenOwner.close();
414
+ this.#sequenceControllerOwner.close();
415
+ this.#sequencePlaybackOwner.close();
416
+ this.#gameClockOwner.close();
417
+ void this.runClose().then(resolveClose, rejectClose);
418
+ return this.closePromise;
419
+ }
420
+ // Scope and Stage cleanup precede CPU assets, stop and asynchronous host close.
421
+ async runClose() {
422
+ try {
423
+ if (this.frameIdle !== undefined)
424
+ await this.frameIdle;
425
+ if (this.#gameClockOwner.isBusy())
426
+ await this.#gameClockOwner.whenIdle();
427
+ for (const scope of [...this.scopes].reverse()) {
428
+ try {
429
+ scope.dispose();
430
+ }
431
+ catch (cause) {
432
+ this.cleanupErrors.push(cause);
433
+ this.#context.report({ code: 'ENGINE_SCOPE_CLEANUP_FAILED', phase: 'engine', severity: 'error', cause });
434
+ }
435
+ }
436
+ try {
437
+ this.stage.dispose();
438
+ }
439
+ catch (cause) {
440
+ this.cleanupErrors.push(cause);
441
+ this.#context.report({ code: 'ENGINE_STAGE_CLEANUP_FAILED', phase: 'engine', severity: 'error', cause });
442
+ }
443
+ try {
444
+ this.assets.dispose();
445
+ }
446
+ catch (cause) {
447
+ this.cleanupErrors.push(cause);
448
+ this.#context.report({ code: 'ENGINE_ASSETS_CLEANUP_FAILED', phase: 'assets', severity: 'error', cause });
449
+ }
450
+ try {
451
+ this.host.stop?.();
452
+ }
453
+ catch (cause) {
454
+ this.cleanupErrors.push(cause);
455
+ this.#context.report({ code: 'HOST_STOP_FAILED', phase: 'engine', severity: 'error', cause });
456
+ }
457
+ await closeHost(this.host, this.timeoutMs, this.releaseSurface, this.cleanupErrors, this.onDiagnostic);
458
+ }
459
+ finally {
460
+ this.#currentState = 'closed';
461
+ }
462
+ }
463
+ }
464
+ //# sourceMappingURL=Engine.js.map
@@ -0,0 +1,6 @@
1
+ /** Optional owned sequence controls share the Engine clock without loading into the default entry. */
2
+ export { createSequenceController } from './sequenceController.js';
3
+ export type { SequenceMarker, SequenceControllerOptions, SequenceControllerState, SequenceEventSource, SequenceControllerEvent, SequenceSeekRequest, SequenceControllerStatus, SequenceController } from './types.js';
4
+ export { createSequenceResetSlot } from './sequenceResetSlot.js';
5
+ export type { SequenceResetInitial, SequenceResetActive, SequenceResetRequest, SequenceResetState, SequenceResetTicket, SequenceResetSlot } from './sequenceResetTypes.js';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,5 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ /** Optional owned sequence controls share the Engine clock without loading into the default entry. */
3
+ export { createSequenceController } from './sequenceController.js';
4
+ export { createSequenceResetSlot } from './sequenceResetSlot.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,22 @@
1
+ import type { Bitmap, Scope, SequenceClip } from '@egret/runtime';
2
+ import type { Engine } from '../Engine.js';
3
+ import type { SequenceControllerEnginePort } from '../internal/sequenceControllerFactoryState.js';
4
+ import type { SequenceController, SequenceControllerOptions } from './types.js';
5
+ /** Optional assembly only: authenticate the exact Engine, original controller and Bitmap. */
6
+ export declare function requireResetController(value: unknown, port: SequenceControllerEnginePort, bitmap: Bitmap): () => object;
7
+ /** Reserve the replacement pause revision before synchronous event delivery can reenter the slot. */
8
+ export declare function pauseSequenceForReplacement(value: SequenceController, port: SequenceControllerEnginePort, bitmap: Bitmap, revision: object): void;
9
+ export declare function requireSequencePreserveSource(value: SequenceController, port: SequenceControllerEnginePort, bitmap: Bitmap): {
10
+ clip: SequenceClip;
11
+ totalPlays: number | 'infinite';
12
+ markers: readonly {
13
+ readonly id: string;
14
+ readonly timeSeconds: number;
15
+ readonly markerIndex: number;
16
+ }[];
17
+ };
18
+ /** Stage an event-free successor at the paused source position. The slot has checked both timelines. */
19
+ export declare function stageSequencePreserve(port: SequenceControllerEnginePort, from: SequenceController, fromBitmap: Bitmap, to: SequenceController, toBitmap: Bitmap, running: boolean): () => void;
20
+ /** Opt-in sequence controls share Engine ownership but never create a second timer. */
21
+ export declare function createSequenceController(engine: Engine, scope: Scope, bitmap: Bitmap, clip: SequenceClip, options: SequenceControllerOptions): SequenceController;
22
+ //# sourceMappingURL=sequenceController.d.ts.map