@egret/engine 0.0.0-stage → 7.0.1-rc.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (575) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +464 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +42 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +69 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +52 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +15 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +43 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +233 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +29 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +109 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +25 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +411 -0
  57. package/dist/cameraTypes.d.ts +114 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +33 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +42 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +34 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +31 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +50 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +134 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +119 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +49 -0
  100. package/dist/index.js +20 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +81 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +64 -0
  116. package/dist/internal/uiFactoryState.js +157 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +12 -0
  120. package/dist/keyboardInput.js +578 -0
  121. package/dist/keyboardInputTypes.d.ts +81 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +14 -0
  124. package/dist/kit.js +9 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +16 -0
  132. package/dist/manifestResourceState.js +57 -0
  133. package/dist/manifestResourceTypes.d.ts +25 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +33 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +37 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +292 -0
  145. package/dist/particleTypes.d.ts +107 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +167 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +623 -0
  157. package/dist/pointerInput.d.ts +11 -0
  158. package/dist/pointerInput.js +299 -0
  159. package/dist/pointerInputTypes.d.ts +38 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +29 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +331 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +88 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +652 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +18 -0
  178. package/dist/rendering/sharedColor2D.js +68 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +118 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +95 -0
  188. package/dist/rendering/world3d/Animation3D.js +380 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +71 -0
  192. package/dist/rendering/world3d/Batch3D.js +329 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +57 -0
  194. package/dist/rendering/world3d/Camera3D.js +129 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +123 -0
  196. package/dist/rendering/world3d/Character3D.js +303 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
  198. package/dist/rendering/world3d/Cloth3D.js +498 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +21 -0
  200. package/dist/rendering/world3d/Compression3D.js +702 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +111 -0
  202. package/dist/rendering/world3d/Curves3D.js +455 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +41 -0
  204. package/dist/rendering/world3d/Decal3D.js +241 -0
  205. package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
  206. package/dist/rendering/world3d/Geometry3D.js +326 -0
  207. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
  208. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  209. package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
  210. package/dist/rendering/world3d/Gizmo3D.js +512 -0
  211. package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
  212. package/dist/rendering/world3d/Gltf3D.js +976 -0
  213. package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
  214. package/dist/rendering/world3d/GpuParticles3D.js +400 -0
  215. package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
  216. package/dist/rendering/world3d/Hdr3D.js +190 -0
  217. package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
  218. package/dist/rendering/world3d/Jelly3D.js +266 -0
  219. package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
  220. package/dist/rendering/world3d/Ktx23D.js +112 -0
  221. package/dist/rendering/world3d/Light3D.d.ts +75 -0
  222. package/dist/rendering/world3d/Light3D.js +93 -0
  223. package/dist/rendering/world3d/Material3D.d.ts +243 -0
  224. package/dist/rendering/world3d/Material3D.js +267 -0
  225. package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
  226. package/dist/rendering/world3d/Mesh3D.js +323 -0
  227. package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
  228. package/dist/rendering/world3d/Meshopt3D.js +275 -0
  229. package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
  230. package/dist/rendering/world3d/Navigation3D.js +971 -0
  231. package/dist/rendering/world3d/Object3D.d.ts +107 -0
  232. package/dist/rendering/world3d/Object3D.js +305 -0
  233. package/dist/rendering/world3d/Particles3D.d.ts +85 -0
  234. package/dist/rendering/world3d/Particles3D.js +274 -0
  235. package/dist/rendering/world3d/Physics3D.d.ts +416 -0
  236. package/dist/rendering/world3d/Physics3D.js +2835 -0
  237. package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
  238. package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
  239. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
  240. package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
  241. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  242. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  243. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
  244. package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
  245. package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
  246. package/dist/rendering/world3d/Ragdoll3D.js +200 -0
  247. package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
  248. package/dist/rendering/world3d/Raycast3D.js +246 -0
  249. package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
  250. package/dist/rendering/world3d/RenderList3D.js +490 -0
  251. package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
  252. package/dist/rendering/world3d/Retarget3D.js +185 -0
  253. package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
  254. package/dist/rendering/world3d/Serialize3D.js +607 -0
  255. package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
  256. package/dist/rendering/world3d/StateMachine3D.js +277 -0
  257. package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
  258. package/dist/rendering/world3d/Terrain3D.js +803 -0
  259. package/dist/rendering/world3d/Text3D.d.ts +90 -0
  260. package/dist/rendering/world3d/Text3D.js +558 -0
  261. package/dist/rendering/world3d/Texture3D.d.ts +133 -0
  262. package/dist/rendering/world3d/Texture3D.js +252 -0
  263. package/dist/rendering/world3d/Trail3D.d.ts +59 -0
  264. package/dist/rendering/world3d/Trail3D.js +193 -0
  265. package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
  266. package/dist/rendering/world3d/Vehicle3D.js +226 -0
  267. package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
  268. package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
  269. package/dist/rendering/world3d/Water3D.d.ts +163 -0
  270. package/dist/rendering/world3d/Water3D.js +606 -0
  271. package/dist/rendering/world3d/core3D.d.ts +34 -0
  272. package/dist/rendering/world3d/core3D.js +99 -0
  273. package/dist/rendering/world3d/debug3D.d.ts +64 -0
  274. package/dist/rendering/world3d/debug3D.js +257 -0
  275. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  276. package/dist/rendering/world3d/decoders3D.js +133 -0
  277. package/dist/rendering/world3d/geometries3D.d.ts +99 -0
  278. package/dist/rendering/world3d/geometries3D.js +605 -0
  279. package/dist/rendering/world3d/helpers3D.d.ts +65 -0
  280. package/dist/rendering/world3d/helpers3D.js +177 -0
  281. package/dist/rendering/world3d/index.d.ts +91 -0
  282. package/dist/rendering/world3d/index.js +56 -0
  283. package/dist/rendering/world3d/math3D.d.ts +78 -0
  284. package/dist/rendering/world3d/math3D.js +640 -0
  285. package/dist/rendering/world3d/primitives3D.d.ts +60 -0
  286. package/dist/rendering/world3d/primitives3D.js +196 -0
  287. package/dist/resources.d.ts +8 -0
  288. package/dist/resources.js +6 -0
  289. package/dist/saveStore.d.ts +56 -0
  290. package/dist/saveStore.js +163 -0
  291. package/dist/semanticList.d.ts +122 -0
  292. package/dist/semanticList.js +174 -0
  293. package/dist/semanticTree.d.ts +10 -0
  294. package/dist/semanticTree.js +532 -0
  295. package/dist/semanticTypes.d.ts +167 -0
  296. package/dist/semanticTypes.js +2 -0
  297. package/dist/semantics.d.ts +6 -0
  298. package/dist/semantics.js +5 -0
  299. package/dist/sequencePlayback.d.ts +19 -0
  300. package/dist/sequencePlayback.js +391 -0
  301. package/dist/sequencePlaybackTypes.d.ts +21 -0
  302. package/dist/sequencePlaybackTypes.js +2 -0
  303. package/dist/sequenceTargetClaims.d.ts +10 -0
  304. package/dist/sequenceTargetClaims.js +31 -0
  305. package/dist/srgbBytes.d.ts +3 -0
  306. package/dist/srgbBytes.js +64 -0
  307. package/dist/startEngine.d.ts +5 -0
  308. package/dist/startEngine.js +31 -0
  309. package/dist/surfaceOwnership.d.ts +3 -0
  310. package/dist/surfaceOwnership.js +15 -0
  311. package/dist/text.d.ts +23 -0
  312. package/dist/text.js +4 -0
  313. package/dist/textField.d.ts +6 -0
  314. package/dist/textField.js +6 -0
  315. package/dist/tileMapDraw.d.ts +7 -0
  316. package/dist/tileMapDraw.js +310 -0
  317. package/dist/tiledImport.d.ts +9 -0
  318. package/dist/tiledImport.js +357 -0
  319. package/dist/tilemap.d.ts +5 -0
  320. package/dist/tilemap.js +5 -0
  321. package/dist/tilemapTypes.d.ts +169 -0
  322. package/dist/tilemapTypes.js +2 -0
  323. package/dist/tween.d.ts +15 -0
  324. package/dist/tween.js +329 -0
  325. package/dist/tweenTypes.d.ts +27 -0
  326. package/dist/tweenTypes.js +2 -0
  327. package/dist/ui/controlKeys.d.ts +109 -0
  328. package/dist/ui/controlKeys.js +249 -0
  329. package/dist/ui/controls.d.ts +52 -0
  330. package/dist/ui/controls.js +288 -0
  331. package/dist/ui/editing.d.ts +3 -0
  332. package/dist/ui/editing.js +3 -0
  333. package/dist/ui/index.d.ts +19 -0
  334. package/dist/ui/index.js +11 -0
  335. package/dist/ui/keyboardFocus.d.ts +32 -0
  336. package/dist/ui/keyboardFocus.js +146 -0
  337. package/dist/ui/layerTypes.d.ts +91 -0
  338. package/dist/ui/layerTypes.js +2 -0
  339. package/dist/ui/layers.d.ts +4 -0
  340. package/dist/ui/layers.js +586 -0
  341. package/dist/ui/leafContent.d.ts +21 -0
  342. package/dist/ui/leafContent.js +136 -0
  343. package/dist/ui/rangeControl.d.ts +50 -0
  344. package/dist/ui/rangeControl.js +167 -0
  345. package/dist/ui/scrollControl.d.ts +72 -0
  346. package/dist/ui/scrollControl.js +218 -0
  347. package/dist/ui/stateControls.d.ts +82 -0
  348. package/dist/ui/stateControls.js +328 -0
  349. package/dist/ui/textEditor.d.ts +53 -0
  350. package/dist/ui/textEditor.js +370 -0
  351. package/dist/ui/textEditorTypes.d.ts +78 -0
  352. package/dist/ui/textEditorTypes.js +2 -0
  353. package/dist/ui/textFieldControl.d.ts +96 -0
  354. package/dist/ui/textFieldControl.js +259 -0
  355. package/dist/ui/theme.d.ts +59 -0
  356. package/dist/ui/theme.js +165 -0
  357. package/dist/ui/types.d.ts +265 -0
  358. package/dist/ui/types.js +2 -0
  359. package/dist/ui/uiRoot.d.ts +4 -0
  360. package/dist/ui/uiRoot.js +1497 -0
  361. package/dist/ui/uiRootDisplay.d.ts +46 -0
  362. package/dist/ui/uiRootDisplay.js +148 -0
  363. package/dist/ui/uiRootModel.d.ts +112 -0
  364. package/dist/ui/uiRootModel.js +60 -0
  365. package/dist/ui/virtualList.d.ts +20 -0
  366. package/dist/ui/virtualList.js +105 -0
  367. package/dist/video.d.ts +4 -0
  368. package/dist/video.js +4 -0
  369. package/dist/videoPlayer.d.ts +4 -0
  370. package/dist/videoPlayer.js +215 -0
  371. package/dist/videoTypes.d.ts +74 -0
  372. package/dist/videoTypes.js +2 -0
  373. package/dist/web/BrowserAssetBundle.d.ts +39 -0
  374. package/dist/web/BrowserAssetBundle.js +136 -0
  375. package/dist/web/BrowserAudio.d.ts +41 -0
  376. package/dist/web/BrowserAudio.js +473 -0
  377. package/dist/web/BrowserFrameLoop.d.ts +65 -0
  378. package/dist/web/BrowserFrameLoop.js +125 -0
  379. package/dist/web/BrowserGame.d.ts +112 -0
  380. package/dist/web/BrowserGame.js +352 -0
  381. package/dist/web/BrowserGamepadInput.d.ts +35 -0
  382. package/dist/web/BrowserGamepadInput.js +134 -0
  383. package/dist/web/BrowserHoverInput.d.ts +24 -0
  384. package/dist/web/BrowserHoverInput.js +266 -0
  385. package/dist/web/BrowserImageTextures.d.ts +66 -0
  386. package/dist/web/BrowserImageTextures.js +169 -0
  387. package/dist/web/BrowserInputActions.d.ts +53 -0
  388. package/dist/web/BrowserInputActions.js +342 -0
  389. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  390. package/dist/web/BrowserKeyboardInput.js +223 -0
  391. package/dist/web/BrowserPlay.d.ts +289 -0
  392. package/dist/web/BrowserPlay.js +1301 -0
  393. package/dist/web/BrowserPointerInput.d.ts +4 -0
  394. package/dist/web/BrowserPointerInput.js +511 -0
  395. package/dist/web/BrowserSemantics.d.ts +34 -0
  396. package/dist/web/BrowserSemantics.js +418 -0
  397. package/dist/web/BrowserStatsPanel.d.ts +46 -0
  398. package/dist/web/BrowserStatsPanel.js +137 -0
  399. package/dist/web/BrowserStorage.d.ts +33 -0
  400. package/dist/web/BrowserStorage.js +132 -0
  401. package/dist/web/BrowserTextEditor.d.ts +49 -0
  402. package/dist/web/BrowserTextEditor.js +839 -0
  403. package/dist/web/BrowserTextInput.d.ts +83 -0
  404. package/dist/web/BrowserTextInput.js +524 -0
  405. package/dist/web/BrowserTextureProvider.d.ts +52 -0
  406. package/dist/web/BrowserTextureProvider.js +935 -0
  407. package/dist/web/BrowserVideo.d.ts +28 -0
  408. package/dist/web/BrowserVideo.js +211 -0
  409. package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
  410. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  411. package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
  412. package/dist/web/CanvasKitParagraphProvider.js +691 -0
  413. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  414. package/dist/web/CanvasTextRasterProvider.js +312 -0
  415. package/dist/web/ManifestByteSource.d.ts +147 -0
  416. package/dist/web/ManifestByteSource.js +974 -0
  417. package/dist/web/ManifestFontContentLoader.d.ts +12 -0
  418. package/dist/web/ManifestFontContentLoader.js +30 -0
  419. package/dist/web/MouseInput.d.ts +4 -0
  420. package/dist/web/MouseInput.js +218 -0
  421. package/dist/web/WebGL2Host.d.ts +5 -0
  422. package/dist/web/WebGL2Host.js +2672 -0
  423. package/dist/web/WebGPUHost.d.ts +87 -0
  424. package/dist/web/WebGPUHost.js +3349 -0
  425. package/dist/web/audio.d.ts +3 -0
  426. package/dist/web/audio.js +4 -0
  427. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  428. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  429. package/dist/web/editing.d.ts +5 -0
  430. package/dist/web/editing.js +4 -0
  431. package/dist/web/editorFonts.d.ts +50 -0
  432. package/dist/web/editorFonts.js +297 -0
  433. package/dist/web/game.d.ts +5 -0
  434. package/dist/web/game.js +6 -0
  435. package/dist/web/gamepad.d.ts +3 -0
  436. package/dist/web/gamepad.js +4 -0
  437. package/dist/web/hover.d.ts +3 -0
  438. package/dist/web/hover.js +4 -0
  439. package/dist/web/image.d.ts +4 -0
  440. package/dist/web/image.js +4 -0
  441. package/dist/web/imageProjections2D.d.ts +14 -0
  442. package/dist/web/imageProjections2D.js +2 -0
  443. package/dist/web/input.d.ts +6 -0
  444. package/dist/web/input.js +4 -0
  445. package/dist/web/keyboard.d.ts +3 -0
  446. package/dist/web/keyboard.js +3 -0
  447. package/dist/web/kit.d.ts +10 -0
  448. package/dist/web/kit.js +7 -0
  449. package/dist/web/loop.d.ts +3 -0
  450. package/dist/web/loop.js +4 -0
  451. package/dist/web/paragraph.d.ts +6 -0
  452. package/dist/web/paragraph.js +4 -0
  453. package/dist/web/play.d.ts +5 -0
  454. package/dist/web/play.js +6 -0
  455. package/dist/web/playSfx.d.ts +36 -0
  456. package/dist/web/playSfx.js +112 -0
  457. package/dist/web/pointer.d.ts +3 -0
  458. package/dist/web/pointer.js +3 -0
  459. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  460. package/dist/web/prepareSharedSubmission2D.js +57 -0
  461. package/dist/web/resources.d.ts +27 -0
  462. package/dist/web/resources.js +96 -0
  463. package/dist/web/semantics.d.ts +3 -0
  464. package/dist/web/semantics.js +4 -0
  465. package/dist/web/sharedDeviceSession.d.ts +64 -0
  466. package/dist/web/sharedDeviceSession.js +2 -0
  467. package/dist/web/sharedEffectShaders.d.ts +9 -0
  468. package/dist/web/sharedEffectShaders.js +165 -0
  469. package/dist/web/sharedFrameUpload.d.ts +25 -0
  470. package/dist/web/sharedFrameUpload.js +2 -0
  471. package/dist/web/sharedHostDeferred.d.ts +7 -0
  472. package/dist/web/sharedHostDeferred.js +12 -0
  473. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  474. package/dist/web/sharedRetentionLedger.js +391 -0
  475. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  476. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  477. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  478. package/dist/web/sharedWebGL2Arena.js +77 -0
  479. package/dist/web/sharedWebGL2Options.d.ts +30 -0
  480. package/dist/web/sharedWebGL2Options.js +96 -0
  481. package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
  482. package/dist/web/sharedWebGL2Shaders.js +314 -0
  483. package/dist/web/sharedWebGPUOptions.d.ts +37 -0
  484. package/dist/web/sharedWebGPUOptions.js +126 -0
  485. package/dist/web/text.d.ts +3 -0
  486. package/dist/web/text.js +3 -0
  487. package/dist/web/textInput.d.ts +3 -0
  488. package/dist/web/textInput.js +3 -0
  489. package/dist/web/video.d.ts +3 -0
  490. package/dist/web/video.js +4 -0
  491. package/dist/web/webgl2.d.ts +7 -0
  492. package/dist/web/webgl2.js +4 -0
  493. package/dist/web/webgl2LayerState.d.ts +50 -0
  494. package/dist/web/webgl2LayerState.js +102 -0
  495. package/dist/web/webgl2Native.d.ts +70 -0
  496. package/dist/web/webgl2Native.js +568 -0
  497. package/dist/web/webgl2Types.d.ts +132 -0
  498. package/dist/web/webgl2Types.js +2 -0
  499. package/dist/web/webgpu.d.ts +6 -0
  500. package/dist/web/webgpu.js +2 -0
  501. package/dist/web/webgpuBindingCache.d.ts +26 -0
  502. package/dist/web/webgpuBindingCache.js +223 -0
  503. package/dist/web/webgpuBufferPool.d.ts +51 -0
  504. package/dist/web/webgpuBufferPool.js +58 -0
  505. package/dist/web/webgpuImageResidency.d.ts +53 -0
  506. package/dist/web/webgpuImageResidency.js +61 -0
  507. package/dist/web/webgpuLifetime.d.ts +45 -0
  508. package/dist/web/webgpuLifetime.js +64 -0
  509. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  510. package/dist/web/webgpuRetentionPool.js +84 -0
  511. package/dist/web/webgpuSharedPass.d.ts +7 -0
  512. package/dist/web/webgpuSharedPass.js +211 -0
  513. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  514. package/dist/web/webgpuSharedResolvePass.js +29 -0
  515. package/dist/web/world3d/Audio3D.d.ts +68 -0
  516. package/dist/web/world3d/Audio3D.js +212 -0
  517. package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
  518. package/dist/web/world3d/BrowserPlay3D.js +851 -0
  519. package/dist/web/world3d/FlyControls3D.d.ts +55 -0
  520. package/dist/web/world3d/FlyControls3D.js +160 -0
  521. package/dist/web/world3d/FollowControls3D.d.ts +28 -0
  522. package/dist/web/world3d/FollowControls3D.js +117 -0
  523. package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
  524. package/dist/web/world3d/OrbitControls3D.js +187 -0
  525. package/dist/web/world3d/TransformControls3D.d.ts +34 -0
  526. package/dist/web/world3d/TransformControls3D.js +125 -0
  527. package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
  528. package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
  529. package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
  530. package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
  531. package/dist/web/world3d/World3DView.d.ts +51 -0
  532. package/dist/web/world3d/World3DView.js +77 -0
  533. package/dist/web/world3d/app3D.d.ts +136 -0
  534. package/dist/web/world3d/app3D.js +304 -0
  535. package/dist/web/world3d/assets3D.d.ts +38 -0
  536. package/dist/web/world3d/assets3D.js +112 -0
  537. package/dist/web/world3d/atmosphere3D.d.ts +47 -0
  538. package/dist/web/world3d/atmosphere3D.js +178 -0
  539. package/dist/web/world3d/frame3D.d.ts +142 -0
  540. package/dist/web/world3d/frame3D.js +388 -0
  541. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  542. package/dist/web/world3d/gpuResources3D.js +901 -0
  543. package/dist/web/world3d/host3D.d.ts +23 -0
  544. package/dist/web/world3d/host3D.js +61 -0
  545. package/dist/web/world3d/index.d.ts +38 -0
  546. package/dist/web/world3d/index.js +23 -0
  547. package/dist/web/world3d/loaders3D.d.ts +26 -0
  548. package/dist/web/world3d/loaders3D.js +138 -0
  549. package/dist/web/world3d/markers3D.d.ts +49 -0
  550. package/dist/web/world3d/markers3D.js +130 -0
  551. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  552. package/dist/web/world3d/materialWebGL23D.js +218 -0
  553. package/dist/web/world3d/overlay3D.d.ts +28 -0
  554. package/dist/web/world3d/overlay3D.js +170 -0
  555. package/dist/web/world3d/post3D.d.ts +112 -0
  556. package/dist/web/world3d/post3D.js +459 -0
  557. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  558. package/dist/web/world3d/postWebGL23D.js +237 -0
  559. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  560. package/dist/web/world3d/postWebGPU3D.js +255 -0
  561. package/dist/web/world3d/probe3D.d.ts +14 -0
  562. package/dist/web/world3d/probe3D.js +66 -0
  563. package/dist/web/world3d/shaders3D.d.ts +43 -0
  564. package/dist/web/world3d/shaders3D.js +851 -0
  565. package/dist/web/world3d/stats3D.d.ts +31 -0
  566. package/dist/web/world3d/stats3D.js +80 -0
  567. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
  568. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  569. package/dist/web/world3d/webgpu.d.ts +35 -0
  570. package/dist/web/world3d/webgpu.js +22 -0
  571. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  572. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  573. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  574. package/dist/web/world3d/wgsl3D.js +781 -0
  575. package/package.json +220 -4
@@ -0,0 +1,25 @@
1
+ import { EgretError } from '@egret/runtime';
2
+ import { startEngine } from './startEngine.js';
3
+ import { admitGameClockOptions } from './gameClock.js';
4
+ /**
5
+ * An Engine without a render port: it captures frames and does not render them.
6
+ * Reserve the surface before startup; failed startup uses the normal close path.
7
+ */
8
+ export async function createEngine(options) {
9
+ const host = options.host;
10
+ const diagnostic = options.onDiagnostic;
11
+ const stableOptions = { host, ...(diagnostic === undefined ? {} : { onDiagnostic: diagnostic }) };
12
+ const timeoutMs = options.shutdownTimeoutMs ?? 1000;
13
+ if (!Number.isFinite(timeoutMs) || !Number.isInteger(timeoutMs) || timeoutMs <= 0)
14
+ throw new EgretError('INVALID_TIMEOUT');
15
+ let clockValue;
16
+ try {
17
+ clockValue = options.clock;
18
+ }
19
+ catch (cause) {
20
+ throw new EgretError('CLOCK_OPTIONS_INVALID', { cause });
21
+ }
22
+ const clockOptions = admitGameClockOptions(clockValue);
23
+ return startEngine(stableOptions, timeoutMs, { shared: undefined, sharedProfile: undefined }, clockOptions);
24
+ }
25
+ //# sourceMappingURL=createEngine.js.map
@@ -0,0 +1,5 @@
1
+ import type { SharedFrameProfile2D } from '@egret/contracts';
2
+ import type { Engine, EngineOptions } from './Engine.js';
3
+ /** Exact negotiation completes all successful port reads before semantics. */
4
+ export declare function createEngineForProfile(options: EngineOptions, profile: SharedFrameProfile2D): Promise<Engine>;
5
+ //# sourceMappingURL=createEngineForProfile.d.ts.map
@@ -0,0 +1,42 @@
1
+ import { SHARED_FRAME_PROFILE_2D } from '@egret/contracts';
2
+ import { EgretError } from '@egret/runtime';
3
+ import { startEngine } from './startEngine.js';
4
+ import { admitGameClockOptions } from './gameClock.js';
5
+ /** Exact negotiation completes all successful port reads before semantics. */
6
+ export async function createEngineForProfile(options, profile) {
7
+ // Unsupported profiles never inspect options, allocate an Engine or reserve a surface.
8
+ if (profile !== SHARED_FRAME_PROFILE_2D)
9
+ throw new EgretError('ENGINE_RENDER_PROFILE_UNSUPPORTED');
10
+ const host = options.host;
11
+ let advertisement, shared;
12
+ try {
13
+ const source = host;
14
+ advertisement = source.sharedFrameProfile;
15
+ shared = source.renderSharedFrame;
16
+ }
17
+ catch (cause) {
18
+ throw new EgretError('INVALID_RENDERER', { cause });
19
+ }
20
+ if (advertisement !== SHARED_FRAME_PROFILE_2D)
21
+ throw new EgretError('ENGINE_RENDER_PROFILE_UNSUPPORTED');
22
+ if (typeof shared !== 'function')
23
+ throw new EgretError('INVALID_RENDERER');
24
+ const diagnostic = options.onDiagnostic;
25
+ const stableOptions = { host, ...(diagnostic === undefined ? {} : { onDiagnostic: diagnostic }) };
26
+ const timeoutMs = options.shutdownTimeoutMs ?? 1000;
27
+ if (!Number.isFinite(timeoutMs) || !Number.isInteger(timeoutMs) || timeoutMs <= 0)
28
+ throw new EgretError('INVALID_TIMEOUT');
29
+ let clockValue;
30
+ try {
31
+ clockValue = options.clock;
32
+ }
33
+ catch (cause) {
34
+ throw new EgretError('CLOCK_OPTIONS_INVALID', { cause });
35
+ }
36
+ const clockOptions = admitGameClockOptions(clockValue);
37
+ return startEngine(stableOptions, timeoutMs, {
38
+ shared: shared,
39
+ sharedProfile: profile
40
+ }, clockOptions);
41
+ }
42
+ //# sourceMappingURL=createEngineForProfile.js.map
@@ -0,0 +1,25 @@
1
+ import { Scope } from '@egret/runtime';
2
+ import type { DisplayObject, DisplayObjectContainer, EngineContext } from '@egret/runtime';
3
+ declare const displaySubtreeTicketBrand: unique symbol;
4
+ /** Borrows all nodes/resources; disposal only revokes this candidate publication. */
5
+ export interface DisplaySubtreeTicket {
6
+ readonly [displaySubtreeTicketBrand]: true;
7
+ commit(): void;
8
+ dispose(): void;
9
+ }
10
+ type Operations = Parameters<NonNullable<EngineContext['registerPreparedDisplayOperations']>>[0];
11
+ interface Context {
12
+ assertOpen(): void;
13
+ isEngineScope(scope: unknown): scope is Scope;
14
+ isBusy(): boolean;
15
+ }
16
+ /** One Engine's authentic handles close over its genuine Stage operations. */
17
+ export declare function createDisplaySubtreeTickets(context: Context, operations: Operations): Readonly<{
18
+ prepare(scope: Scope, target: DisplayObjectContainer, candidate: DisplayObject): DisplaySubtreeTicket;
19
+ read(ticket: unknown): Readonly<{
20
+ validate(): void;
21
+ captureContent(): import("@egret/runtime").CapturedSharedContent2D;
22
+ }>;
23
+ }>;
24
+ export {};
25
+ //# sourceMappingURL=displaySubtreeTicket.d.ts.map
@@ -0,0 +1,76 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { Scope, EgretError } from '@egret/runtime';
3
+ const use = Scope.prototype.use, state = Object.getOwnPropertyDescriptor(Scope.prototype, 'state').get;
4
+ /** One Engine's authentic handles close over its genuine Stage operations. */
5
+ export function createDisplaySubtreeTickets(context, operations) {
6
+ const handles = new WeakMap();
7
+ function lifetime(scope) {
8
+ context.assertOpen();
9
+ if (!context.isEngineScope(scope))
10
+ throw new EgretError('DISPLAY_SUBTREE_SCOPE_INVALID');
11
+ if (state.call(scope) !== 'open')
12
+ throw new EgretError('SCOPE_CLOSED');
13
+ }
14
+ function available(ticket) {
15
+ context.assertOpen();
16
+ const row = handles.get(ticket);
17
+ if (!row)
18
+ throw new EgretError('DISPLAY_SUBTREE_TICKET_INVALID');
19
+ lifetime(row.scope);
20
+ if (!row.token)
21
+ throw new EgretError('DISPLAY_SUBTREE_RETIRED');
22
+ return row;
23
+ }
24
+ function idle() {
25
+ if (context.isBusy())
26
+ throw new EgretError('DISPLAY_SUBTREE_REENTRANT');
27
+ }
28
+ return Object.freeze({
29
+ prepare(scope, target, candidate) {
30
+ lifetime(scope);
31
+ idle();
32
+ const token = operations.prepare(target, candidate), row = { scope, token: token };
33
+ const handle = Object.freeze({
34
+ commit() {
35
+ if (this !== handle)
36
+ throw new EgretError('DISPLAY_SUBTREE_TICKET_INVALID');
37
+ const current = available(handle);
38
+ idle();
39
+ operations.commit(current.token);
40
+ current.token = undefined;
41
+ },
42
+ dispose() {
43
+ if (this !== handle)
44
+ throw new EgretError('DISPLAY_SUBTREE_TICKET_INVALID');
45
+ const token = row.token;
46
+ row.token = undefined;
47
+ if (token)
48
+ operations.dispose(token);
49
+ }
50
+ });
51
+ handles.set(handle, row);
52
+ try {
53
+ use.call(scope, handle);
54
+ }
55
+ catch (cause) {
56
+ handle.dispose();
57
+ throw cause;
58
+ }
59
+ return handle;
60
+ },
61
+ read(ticket) {
62
+ const row = available(ticket);
63
+ return Object.freeze({
64
+ validate() {
65
+ const current = available(ticket);
66
+ operations.validate(current.token);
67
+ },
68
+ captureContent() {
69
+ const current = available(ticket);
70
+ return operations.capture(current.token);
71
+ }
72
+ });
73
+ }
74
+ });
75
+ }
76
+ //# sourceMappingURL=displaySubtreeTicket.js.map
@@ -0,0 +1,6 @@
1
+ import type { AdmittedResourceManifest } from '@egret/contracts/resources';
2
+ import type { Engine } from './Engine.js';
3
+ import type { FontContentLoader, FontContentProviderFactory } from './fontContentTypes.js';
4
+ /** One typed font catalog over the existing manager and genuine dependency groups. */
5
+ export declare function createFontContentLoader(engine: Engine, manifest: AdmittedResourceManifest, factory: FontContentProviderFactory): FontContentLoader;
6
+ //# sourceMappingURL=fontContentLoader.d.ts.map
@@ -0,0 +1,298 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { isAdmittedResourceManifest, inspectFontArtifact } from '@egret/contracts/resources';
3
+ import { createAssetType, Scope, EgretError } from '@egret/runtime';
4
+ import { requireContentEngine } from './internal/contentFactoryState.js';
5
+ import { createManifestAssetBinding } from './manifestResourceState.js';
6
+ const apply = Reflect.apply, freeze = Object.freeze, own = Object.getOwnPropertyDescriptor;
7
+ const scopeState = own(Scope.prototype, 'state').get, use = Scope.prototype.use;
8
+ const typed = Object.getPrototypeOf(Uint8Array.prototype);
9
+ const length = own(typed, 'byteLength').get, buffer = own(typed, 'buffer').get, offset = own(typed, 'byteOffset').get;
10
+ const tag = own(typed, Symbol.toStringTag).get, set = Uint8Array.prototype.set;
11
+ const fault = (code, cause) => new EgretError('FONT_CONTENT_' + code, { cause });
12
+ function bytes(input, maximum) {
13
+ try {
14
+ if (apply(tag, input, []) !== 'Uint8Array')
15
+ throw fault('BYTES');
16
+ const size = apply(length, input, []), backing = apply(buffer, input, []), start = apply(offset, input, []);
17
+ apply(own(ArrayBuffer.prototype, 'byteLength').get, backing, []);
18
+ const resizable = own(ArrayBuffer.prototype, 'resizable')?.get;
19
+ if ((resizable && apply(resizable, backing, [])) || size > maximum)
20
+ throw fault('LIMIT');
21
+ const copy = new Uint8Array(size);
22
+ apply(set, copy, [new Uint8Array(backing, start, size)]);
23
+ return copy;
24
+ }
25
+ catch (cause) {
26
+ throw fault('BYTES', cause);
27
+ }
28
+ }
29
+ /** One typed font catalog over the existing manager and genuine dependency groups. */
30
+ export function createFontContentLoader(engine, manifest, factory) {
31
+ const owner = requireContentEngine(engine);
32
+ if (!isAdmittedResourceManifest(manifest) || typeof factory !== 'function')
33
+ throw fault('INPUT');
34
+ const type = createAssetType('egret.content.font', (v) => {
35
+ try {
36
+ return apply(tag, v, []) === 'Uint8Array';
37
+ }
38
+ catch {
39
+ return false;
40
+ }
41
+ });
42
+ const entries = new Map(), bindings = new Map(), byRef = new Map(), rows = [];
43
+ for (const e of manifest.entries) {
44
+ if (e.resourceKind !== 'font')
45
+ continue;
46
+ const options = e.settings.options;
47
+ if (e.importer.id !== 'egret.font' ||
48
+ e.importer.version !== '1.0.0' ||
49
+ e.artifactFormatVersion !== 'egret.font/1' ||
50
+ e.dependencies.length ||
51
+ e.artifact.byteLength > 33554432 ||
52
+ !options ||
53
+ typeof options.family !== 'string' ||
54
+ !options.family.length ||
55
+ options.family.length > 256 ||
56
+ /[\u0000-\u001f\u007f]/u.test(options.family) ||
57
+ !['truetype', 'opentype'].includes(options.flavor) ||
58
+ e.artifact.mediaType !== (options.flavor === 'truetype' ? 'font/ttf' : 'font/otf'))
59
+ throw fault('PROFILE');
60
+ if (rows.length === 128)
61
+ throw fault('LIMIT');
62
+ const binding = createManifestAssetBinding(manifest, e.id, type);
63
+ entries.set(e.id, e);
64
+ bindings.set(e.id, binding);
65
+ byRef.set(binding.ref, e);
66
+ rows.push(freeze({ id: e.id, family: options.family, binding }));
67
+ }
68
+ const supplied = factory(freeze(rows));
69
+ owner.assertOpen();
70
+ if (!supplied || typeof supplied !== 'object')
71
+ throw fault('PROVIDER');
72
+ const load = own(supplied, 'load'), disposeSource = own(supplied, 'dispose');
73
+ if (!load ||
74
+ !disposeSource ||
75
+ !Object.hasOwn(load, 'value') ||
76
+ !Object.hasOwn(disposeSource, 'value') ||
77
+ typeof load.value !== 'function' ||
78
+ typeof disposeSource.value !== 'function')
79
+ throw fault('PROVIDER');
80
+ let sourceBytes = 0, disposed = false, disown = () => { };
81
+ const owned = new WeakMap(), groups = new Set();
82
+ const live = () => {
83
+ owner.assertOpen();
84
+ if (disposed)
85
+ throw fault('CLOSED');
86
+ };
87
+ owner.register(type, {
88
+ async load(ref, context) {
89
+ live();
90
+ const entry = byRef.get(ref);
91
+ if (!entry)
92
+ throw fault('REF');
93
+ const original = await apply(load.value, supplied, [ref, context]);
94
+ let copy;
95
+ try {
96
+ live();
97
+ if (context.signal.aborted)
98
+ throw fault('CANCELLED', context.signal.reason);
99
+ const size = apply(length, original, []);
100
+ if (size !== entry.artifact.byteLength || sourceBytes + size > 67108864)
101
+ throw fault('LIMIT');
102
+ copy = bytes(original, 33554432);
103
+ const info = inspectFontArtifact(copy);
104
+ if (info.format !== entry.settings.options.flavor)
105
+ throw fault('FLAVOR');
106
+ live();
107
+ if (context.signal.aborted)
108
+ throw fault('CANCELLED');
109
+ }
110
+ finally {
111
+ apply(disposeSource.value, supplied, [original]);
112
+ }
113
+ // External disposal may close the owner or reenter; account only after it returns.
114
+ live();
115
+ if (context.signal.aborted)
116
+ throw fault('CANCELLED');
117
+ if (sourceBytes + copy.byteLength > 67108864)
118
+ throw fault('LIMIT');
119
+ owned.set(copy, copy.byteLength);
120
+ sourceBytes += copy.byteLength;
121
+ return copy;
122
+ },
123
+ dispose(value) {
124
+ const size = owned.get(value);
125
+ if (size !== undefined) {
126
+ owned.delete(value);
127
+ sourceBytes -= size;
128
+ }
129
+ }
130
+ });
131
+ const loader = freeze({
132
+ get isDisposed() {
133
+ if (this !== loader)
134
+ throw fault('LOADER');
135
+ return disposed;
136
+ },
137
+ getStatus() {
138
+ if (this !== loader)
139
+ throw fault('LOADER');
140
+ return freeze({ groups: groups.size, sourceBytes });
141
+ },
142
+ dispose() {
143
+ if (this !== loader)
144
+ throw fault('LOADER');
145
+ if (disposed)
146
+ return;
147
+ disposed = true;
148
+ disown();
149
+ let first;
150
+ for (const group of [...groups]) {
151
+ try {
152
+ group.dispose();
153
+ }
154
+ catch (cause) {
155
+ first ??= cause;
156
+ }
157
+ }
158
+ if (first !== undefined)
159
+ throw first;
160
+ },
161
+ load(scope, roots, options) {
162
+ if (this !== loader)
163
+ throw fault('LOADER');
164
+ live();
165
+ const check = () => {
166
+ live();
167
+ if (!owner.isScope(scope) || apply(scopeState, scope, []) !== 'open')
168
+ throw fault('SCOPE');
169
+ };
170
+ check();
171
+ if (!Array.isArray(roots) || roots.length < 1 || roots.length > 16 || groups.size >= 8)
172
+ throw fault('LIMIT');
173
+ const ids = [], families = new Set();
174
+ let total = 0;
175
+ const count = roots.length;
176
+ for (let i = 0; i < count; i++) {
177
+ const descriptor = own(roots, String(i));
178
+ check();
179
+ const id = descriptor?.value;
180
+ if (!descriptor ||
181
+ !Object.hasOwn(descriptor, 'value') ||
182
+ typeof id !== 'string' ||
183
+ ids.includes(id) ||
184
+ !entries.has(id))
185
+ throw fault('ROOTS');
186
+ const entry = entries.get(id), family = entry.settings.options.family;
187
+ total += entry.artifact.byteLength;
188
+ if (families.has(family) || total > 33554432)
189
+ throw fault('LIMIT');
190
+ families.add(family);
191
+ ids.push(id);
192
+ }
193
+ const raw = owner.group(scope, manifest, freeze(ids), ids.map(id => bindings.get(id)), options);
194
+ // Options/root access can reenter; admission is rechecked before publication.
195
+ if (groups.size >= 8) {
196
+ raw.dispose();
197
+ throw fault('LIMIT');
198
+ }
199
+ let state = 'pending', resolve, reject, finish, failClose;
200
+ const ready = new Promise((yes, no) => {
201
+ resolve = yes;
202
+ reject = no;
203
+ }), closed = new Promise((yes, no) => {
204
+ finish = yes;
205
+ failClose = no;
206
+ });
207
+ void ready.catch(() => { });
208
+ void closed.catch(() => { });
209
+ const assets = [];
210
+ const retire = (cause) => {
211
+ if (state === 'closed')
212
+ return;
213
+ const pending = state === 'pending';
214
+ state = 'closed';
215
+ assets.length = 0;
216
+ groups.delete(group);
217
+ if (pending)
218
+ reject(cause);
219
+ try {
220
+ raw.dispose();
221
+ finish();
222
+ }
223
+ catch (error) {
224
+ failClose(error);
225
+ throw error;
226
+ }
227
+ };
228
+ const group = freeze({
229
+ ready,
230
+ closed,
231
+ get isDisposed() {
232
+ if (this !== group)
233
+ throw fault('GROUP');
234
+ return state === 'closed';
235
+ },
236
+ getFonts() {
237
+ if (this !== group)
238
+ throw fault('GROUP');
239
+ check();
240
+ if (state !== 'ready')
241
+ throw fault('NOT_READY');
242
+ return freeze([...assets]);
243
+ },
244
+ dispose() {
245
+ if (this !== group)
246
+ throw fault('GROUP');
247
+ retire(fault('CANCELLED'));
248
+ }
249
+ });
250
+ groups.add(group);
251
+ try {
252
+ apply(use, scope, [group]);
253
+ check();
254
+ }
255
+ catch (cause) {
256
+ retire(cause);
257
+ throw cause;
258
+ }
259
+ void raw.ready
260
+ .then(() => {
261
+ if (state !== 'pending')
262
+ return;
263
+ try {
264
+ check();
265
+ for (const id of ids) {
266
+ const entry = entries.get(id), lease = raw.get(bindings.get(id));
267
+ const asset = freeze({
268
+ id,
269
+ family: entry.settings.options.family,
270
+ identity: entry.artifact.sha256,
271
+ byteLength: entry.artifact.byteLength,
272
+ format: entry.settings.options.flavor,
273
+ copyBytes() {
274
+ if (this !== asset)
275
+ throw fault('ASSET');
276
+ check();
277
+ if (state !== 'ready')
278
+ throw fault('NOT_READY');
279
+ return bytes(lease.value, 33554432);
280
+ }
281
+ });
282
+ assets.push(asset);
283
+ }
284
+ state = 'ready';
285
+ resolve();
286
+ }
287
+ catch (cause) {
288
+ retire(cause);
289
+ }
290
+ }, cause => retire(cause))
291
+ .catch(cause => retire(cause));
292
+ return group;
293
+ }
294
+ });
295
+ disown = owner.own(() => loader.dispose());
296
+ return loader;
297
+ }
298
+ //# sourceMappingURL=fontContentLoader.js.map
@@ -0,0 +1,34 @@
1
+ import type { AssetProvider, Scope } from '@egret/runtime';
2
+ import type { ManifestAssetBinding, ManifestGroupOptions } from './manifestResourceTypes.js';
3
+ export interface FontContentBinding {
4
+ readonly id: string;
5
+ readonly family: string;
6
+ readonly binding: ManifestAssetBinding<Uint8Array>;
7
+ }
8
+ export type FontContentProviderFactory = (bindings: readonly FontContentBinding[]) => AssetProvider<Uint8Array>;
9
+ export interface FontContentAsset {
10
+ readonly id: string;
11
+ readonly family: string;
12
+ readonly identity: string;
13
+ readonly byteLength: number;
14
+ readonly format: 'truetype' | 'opentype';
15
+ /** Returns a fresh owned copy only while the genuine source group is ready. */
16
+ copyBytes(): Uint8Array;
17
+ }
18
+ export interface FontContentGroup {
19
+ readonly ready: Promise<void>;
20
+ readonly closed: Promise<void>;
21
+ readonly isDisposed: boolean;
22
+ getFonts(): readonly FontContentAsset[];
23
+ dispose(): void;
24
+ }
25
+ export interface FontContentLoader {
26
+ readonly isDisposed: boolean;
27
+ load(scope: Scope, roots: readonly string[], options?: ManifestGroupOptions): FontContentGroup;
28
+ getStatus(): Readonly<{
29
+ groups: number;
30
+ sourceBytes: number;
31
+ }>;
32
+ dispose(): void;
33
+ }
34
+ //# sourceMappingURL=fontContentTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=fontContentTypes.js.map
@@ -0,0 +1,24 @@
1
+ import type { Diagnostic } from '@egret/contracts';
2
+ import { Scope } from '@egret/runtime';
3
+ import type { GameClock, GameClockTick } from './gameClockTypes.js';
4
+ export interface AdmittedGameClockOptions {
5
+ readonly maxDeltaSeconds: number;
6
+ }
7
+ export interface GameClockContext {
8
+ assertOpen(): void;
9
+ isEngineScope(scope: unknown): scope is Scope;
10
+ isFrameBusy(): boolean;
11
+ report(diagnostic: Diagnostic): void;
12
+ }
13
+ export interface GameClockOwner {
14
+ readonly clock: GameClock;
15
+ advance(sourceSeconds: unknown): GameClockTick | undefined;
16
+ close(): void;
17
+ isBusy(): boolean;
18
+ whenIdle(): Promise<void>;
19
+ }
20
+ /** Admission retains only a frozen scalar, never the caller's option object. */
21
+ export declare function admitGameClockOptions(value: unknown): AdmittedGameClockOptions;
22
+ /** Private owner; public facades supply observation and receiver-checked service. */
23
+ export declare function createGameClockOwner(context: GameClockContext, options: AdmittedGameClockOptions): GameClockOwner;
24
+ //# sourceMappingURL=gameClock.d.ts.map