@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,153 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Independently authored runtime admission of the finite first-party producer schemas.
3
+ import { EgretError } from '@egret/runtime';
4
+ export function contentFault(stage, id, cause) {
5
+ return new EgretError('CONTENT_' + stage + '_FAILED', { cause: Object.freeze({ assetId: id, stage, cause }) });
6
+ }
7
+ function invalid(id) {
8
+ throw contentFault('ARTIFACT', id);
9
+ }
10
+ function object(value, keys, id) {
11
+ if (value === null || typeof value !== 'object' || Array.isArray(value))
12
+ invalid(id);
13
+ const found = Object.keys(value);
14
+ if (found.length !== keys.length || found.some(key => !keys.includes(key)))
15
+ invalid(id);
16
+ return value;
17
+ }
18
+ function integer(value, min, max) {
19
+ return (typeof value === 'number' && Number.isSafeInteger(value) && !Object.is(value, -0) && value >= min && value <= max);
20
+ }
21
+ function canonical(value) {
22
+ if (value === null || typeof value !== 'object')
23
+ return JSON.stringify(value);
24
+ if (Array.isArray(value))
25
+ return '[' + value.map(canonical).join(',') + ']';
26
+ const record = value;
27
+ return ('{' +
28
+ Object.keys(record)
29
+ .sort()
30
+ .map(key => JSON.stringify(key) + ':' + canonical(record[key]))
31
+ .join(',') +
32
+ '}');
33
+ }
34
+ function parse(text, id) {
35
+ if (typeof text !== 'string' || text.length > 4194304 || /\p{Surrogate}/u.test(text))
36
+ invalid(id);
37
+ let bytes = 0;
38
+ for (const char of text) {
39
+ const code = char.codePointAt(0);
40
+ bytes += code < 128 ? 1 : code < 2048 ? 2 : code < 65536 ? 3 : 4;
41
+ }
42
+ if (bytes > 4194304)
43
+ invalid(id);
44
+ try {
45
+ return JSON.parse(text);
46
+ }
47
+ catch (cause) {
48
+ throw contentFault('JSON', id, cause);
49
+ }
50
+ }
51
+ function frame(value, width, height, sequence, id) {
52
+ const f = object(value, sequence
53
+ ? ['x', 'y', 'width', 'height', 'durationSeconds', 'layout']
54
+ : ['name', 'x', 'y', 'width', 'height', 'layout'], id);
55
+ if (!integer(f.x, 0, width) ||
56
+ !integer(f.y, 0, height) ||
57
+ !integer(f.width, 1, width) ||
58
+ !integer(f.height, 1, height) ||
59
+ f.x + f.width > width ||
60
+ f.y + f.height > height)
61
+ invalid(id);
62
+ const layout = object(f.layout, ['sourceWidth', 'sourceHeight', 'trimX', 'trimY', 'packedRotation'], id);
63
+ if (!integer(layout.sourceWidth, 1, 65535) ||
64
+ !integer(layout.sourceHeight, 1, 65535) ||
65
+ !integer(layout.trimX, 0, 65535) ||
66
+ !integer(layout.trimY, 0, 65535) ||
67
+ layout.trimX + f.width > layout.sourceWidth ||
68
+ layout.trimY + f.height > layout.sourceHeight ||
69
+ layout.packedRotation !== 0)
70
+ invalid(id);
71
+ Object.freeze(layout);
72
+ return Object.freeze(f);
73
+ }
74
+ function sequence(value, id) {
75
+ const input = object(value, ['atlasWidth', 'atlasHeight', 'frames'], id);
76
+ if (!integer(input.atlasWidth, 1, 4096) ||
77
+ !integer(input.atlasHeight, 1, 4096) ||
78
+ input.atlasWidth * input.atlasHeight > 4194304 ||
79
+ !Array.isArray(input.frames) ||
80
+ input.frames.length < 1 ||
81
+ input.frames.length > 1024)
82
+ invalid(id);
83
+ let total = 0;
84
+ const frames = input.frames.map(value => {
85
+ const f = frame(value, input.atlasWidth, input.atlasHeight, true, id), duration = f.durationSeconds;
86
+ if (typeof duration !== 'number' || !Number.isFinite(duration))
87
+ invalid(id);
88
+ const ms = Math.round(duration * 1000), next = total + duration;
89
+ if (!integer(ms, 1, 65535) || duration !== ms / 1000 || !Number.isFinite(next) || next <= total)
90
+ invalid(id);
91
+ total = next;
92
+ return f;
93
+ });
94
+ return Object.freeze({
95
+ atlasWidth: input.atlasWidth,
96
+ atlasHeight: input.atlasHeight,
97
+ frames: Object.freeze(frames)
98
+ });
99
+ }
100
+ export function parseAtlasArtifact(text, id) {
101
+ const value = object(parse(text, id), ['format', 'pageDependency', 'width', 'height', 'frames', 'sequenceInput'], id);
102
+ if (value.format !== 'egret.atlas/1' ||
103
+ value.pageDependency !== 0 ||
104
+ !integer(value.width, 1, 4096) ||
105
+ !integer(value.height, 1, 4096) ||
106
+ value.width * value.height > 4194304 ||
107
+ !Array.isArray(value.frames) ||
108
+ value.frames.length < 1 ||
109
+ value.frames.length > 1024)
110
+ invalid(id);
111
+ const input = sequence(value.sequenceInput, id);
112
+ if (input.atlasWidth !== value.width ||
113
+ input.atlasHeight !== value.height ||
114
+ input.frames.length !== value.frames.length)
115
+ invalid(id);
116
+ const names = new Set();
117
+ let units = 0;
118
+ const frames = value.frames.map((v, index) => {
119
+ const f = frame(v, value.width, value.height, false, id), other = input.frames[index];
120
+ if (typeof f.name !== 'string' || !f.name || f.name.length > 128 || names.has(f.name))
121
+ invalid(id);
122
+ names.add(f.name);
123
+ units += f.name.length;
124
+ if (units > 32768 ||
125
+ ['x', 'y', 'width', 'height'].some(key => f[key] !== other[key]) ||
126
+ canonical(f.layout) !== canonical(other.layout))
127
+ invalid(id);
128
+ const first = value.frames[0].layout;
129
+ const layout = f.layout;
130
+ if (layout.sourceWidth !== first.sourceWidth || layout.sourceHeight !== first.sourceHeight)
131
+ invalid(id);
132
+ return f;
133
+ });
134
+ // Reject duplicate keys, noncanonical numeric aliases and unknown producer bytes.
135
+ if (canonical(value) !== text)
136
+ invalid(id);
137
+ return Object.freeze({
138
+ width: value.width,
139
+ height: value.height,
140
+ frames: Object.freeze(frames),
141
+ sequenceInput: input
142
+ });
143
+ }
144
+ export function parseSequenceArtifact(text, id, atlas) {
145
+ const value = object(parse(text, id), ['format', 'atlasDependency', 'sequenceInput'], id);
146
+ if (value.format !== 'egret.sequence/1' || value.atlasDependency !== 0)
147
+ invalid(id);
148
+ const input = sequence(value.sequenceInput, id);
149
+ if (canonical(value) !== text || canonical(input) !== canonical(atlas.sequenceInput))
150
+ invalid(id);
151
+ return input;
152
+ }
153
+ //# sourceMappingURL=contentArtifacts.js.map
@@ -0,0 +1,13 @@
1
+ import type { SpriteSheetFrameInput } from '@egret/runtime';
2
+ export interface ContentAtlasPageArtifact {
3
+ readonly name: string;
4
+ readonly width: number;
5
+ readonly height: number;
6
+ readonly frames: readonly SpriteSheetFrameInput[];
7
+ }
8
+ export interface ContentAtlasPagesArtifact {
9
+ readonly pages: readonly ContentAtlasPageArtifact[];
10
+ }
11
+ /** Artifact pages bind by dependency ordinal, never by a path or ambient name. */
12
+ export declare function parseAtlasPagesArtifact(text: string, id: string, dependencyCount: number): ContentAtlasPagesArtifact;
13
+ //# sourceMappingURL=contentAtlasPages.d.ts.map
@@ -0,0 +1,117 @@
1
+ import { contentFault } from './contentArtifacts.js';
2
+ function fail(id) {
3
+ throw contentFault('ARTIFACT', id);
4
+ }
5
+ function object(value, keys, id) {
6
+ if (!value || typeof value !== 'object' || Array.isArray(value))
7
+ return fail(id);
8
+ const names = Object.keys(value);
9
+ if (names.length !== keys.length || names.some(name => !keys.includes(name)))
10
+ return fail(id);
11
+ return value;
12
+ }
13
+ function integer(value, min, max) {
14
+ return (typeof value === 'number' && Number.isSafeInteger(value) && !Object.is(value, -0) && value >= min && value <= max);
15
+ }
16
+ function name(value, id) {
17
+ if (typeof value !== 'string' ||
18
+ !value.length ||
19
+ value.length > 128 ||
20
+ /[\p{Surrogate}\u0000-\u001f\u007f]/u.test(value))
21
+ return fail(id);
22
+ return value;
23
+ }
24
+ function canonical(value) {
25
+ if (value === null || typeof value !== 'object')
26
+ return JSON.stringify(value);
27
+ if (Array.isArray(value))
28
+ return '[' + value.map(canonical).join(',') + ']';
29
+ const record = value;
30
+ return ('{' +
31
+ Object.keys(record)
32
+ .sort()
33
+ .map(key => JSON.stringify(key) + ':' + canonical(record[key]))
34
+ .join(',') +
35
+ '}');
36
+ }
37
+ /** Artifact pages bind by dependency ordinal, never by a path or ambient name. */
38
+ export function parseAtlasPagesArtifact(text, id, dependencyCount) {
39
+ if (typeof text !== 'string' || text.length > 4194304 || !integer(dependencyCount, 1, 16))
40
+ return fail(id);
41
+ let decoded;
42
+ try {
43
+ decoded = JSON.parse(text);
44
+ }
45
+ catch {
46
+ return fail(id);
47
+ }
48
+ const value = object(decoded, ['format', 'pages'], id);
49
+ if (value.format !== 'egret.atlas-pages/1' || !Array.isArray(value.pages) || value.pages.length !== dependencyCount)
50
+ return fail(id);
51
+ const pages = [], pageNames = new Set();
52
+ let frameCount = 0, nameUnits = 0;
53
+ for (let index = 0; index < dependencyCount; index++) {
54
+ const page = object(value.pages[index], ['name', 'pageDependency', 'width', 'height', 'frames'], id), pageName = name(page.name, id);
55
+ if (pageNames.has(pageName) ||
56
+ page.pageDependency !== index ||
57
+ !integer(page.width, 1, 4096) ||
58
+ !integer(page.height, 1, 4096) ||
59
+ page.width * page.height > 4194304 ||
60
+ !Array.isArray(page.frames) ||
61
+ !integer(page.frames.length, 1, 1024))
62
+ return fail(id);
63
+ pageNames.add(pageName);
64
+ nameUnits += pageName.length;
65
+ frameCount += page.frames.length;
66
+ if (frameCount > 8192)
67
+ return fail(id);
68
+ const names = new Set(), frames = [];
69
+ let pageNameUnits = 0;
70
+ for (const raw of page.frames) {
71
+ const frame = object(raw, ['name', 'x', 'y', 'width', 'height', 'layout'], id), frameName = name(frame.name, id);
72
+ if (names.has(frameName) ||
73
+ !integer(frame.x, 0, page.width) ||
74
+ !integer(frame.y, 0, page.height) ||
75
+ !integer(frame.width, 1, page.width) ||
76
+ !integer(frame.height, 1, page.height) ||
77
+ frame.x + frame.width > page.width ||
78
+ frame.y + frame.height > page.height)
79
+ return fail(id);
80
+ names.add(frameName);
81
+ nameUnits += frameName.length;
82
+ pageNameUnits += frameName.length;
83
+ if (nameUnits > 262144 || pageNameUnits > 32768)
84
+ return fail(id);
85
+ const layout = object(frame.layout, ['sourceWidth', 'sourceHeight', 'trimX', 'trimY', 'packedRotation'], id);
86
+ if (!integer(layout.sourceWidth, 1, 65535) ||
87
+ !integer(layout.sourceHeight, 1, 65535) ||
88
+ !integer(layout.trimX, 0, 65535) ||
89
+ !integer(layout.trimY, 0, 65535) ||
90
+ (layout.packedRotation !== 0 && layout.packedRotation !== 90))
91
+ return fail(id);
92
+ const logicalWidth = layout.packedRotation === 90 ? frame.height : frame.width, logicalHeight = layout.packedRotation === 90 ? frame.width : frame.height;
93
+ if (layout.trimX + logicalWidth > layout.sourceWidth || layout.trimY + logicalHeight > layout.sourceHeight)
94
+ return fail(id);
95
+ frames.push(Object.freeze({
96
+ name: frameName,
97
+ x: frame.x,
98
+ y: frame.y,
99
+ width: frame.width,
100
+ height: frame.height,
101
+ layout: Object.freeze({
102
+ sourceWidth: layout.sourceWidth,
103
+ sourceHeight: layout.sourceHeight,
104
+ trimX: layout.trimX,
105
+ trimY: layout.trimY,
106
+ packedRotation: layout.packedRotation
107
+ })
108
+ }));
109
+ }
110
+ pages.push(Object.freeze({ name: pageName, width: page.width, height: page.height, frames: Object.freeze(frames) }));
111
+ }
112
+ // Canonical producer output rejects duplicate JSON keys and numeric aliases.
113
+ if (canonical(value) !== text)
114
+ return fail(id);
115
+ return Object.freeze({ pages: Object.freeze(pages) });
116
+ }
117
+ //# sourceMappingURL=contentAtlasPages.js.map
@@ -0,0 +1,6 @@
1
+ import type { AdmittedResourceManifest } from '@egret/contracts/resources';
2
+ import type { Engine } from './Engine.js';
3
+ import type { ContentLoader, ContentProviderFactory } from './contentTypes.js';
4
+ /** One manifest/source catalog, independent of global IDs and of other loaders. */
5
+ export declare function createContentLoader(engine: Engine, manifest: AdmittedResourceManifest, factory: ContentProviderFactory): ContentLoader;
6
+ //# sourceMappingURL=contentLoader.d.ts.map
@@ -0,0 +1,327 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { isAdmittedResourceManifest } from '@egret/contracts/resources';
3
+ import { createAssetType, createSequenceClip, createSpriteSheet, isTexture, Scope, EgretError } from '@egret/runtime';
4
+ import { createManifestAssetBinding } from './manifestResourceState.js';
5
+ import { registerContentLoader, registerSequenceTimeline, requireContentEngine } from './internal/contentFactoryState.js';
6
+ import { contentFault, parseAtlasArtifact, parseSequenceArtifact } from './contentArtifacts.js';
7
+ import { parseAtlasPagesArtifact } from './contentAtlasPages.js';
8
+ const SCOPE_STATE = Object.getOwnPropertyDescriptor(Scope.prototype, 'state').get;
9
+ const SCOPE_USE = Scope.prototype.use;
10
+ const APPLY = Reflect.apply;
11
+ const FREEZE = Object.freeze;
12
+ function provider(value) {
13
+ if (typeof value !== 'object' || value === null)
14
+ throw new EgretError('CONTENT_PROVIDERS_INVALID');
15
+ const load = Object.getOwnPropertyDescriptor(value, 'load'), dispose = Object.getOwnPropertyDescriptor(value, 'dispose');
16
+ if (!load ||
17
+ !dispose ||
18
+ !Object.hasOwn(load, 'value') ||
19
+ !Object.hasOwn(dispose, 'value') ||
20
+ typeof load.value !== 'function' ||
21
+ typeof dispose.value !== 'function')
22
+ throw new EgretError('CONTENT_PROVIDERS_INVALID');
23
+ return FREEZE({
24
+ load: (...args) => APPLY(load.value, value, args),
25
+ dispose: (asset) => {
26
+ APPLY(dispose.value, value, [asset]);
27
+ }
28
+ });
29
+ }
30
+ /** One manifest/source catalog, independent of global IDs and of other loaders. */
31
+ export function createContentLoader(engine, manifest, factory) {
32
+ const owner = requireContentEngine(engine);
33
+ if (!isAdmittedResourceManifest(manifest))
34
+ throw new EgretError('CONTENT_MANIFEST_INVALID');
35
+ if (typeof factory !== 'function')
36
+ throw new EgretError('CONTENT_PROVIDERS_INVALID');
37
+ const entries = new Map(manifest.entries.map(e => [e.id, e]));
38
+ const imageType = createAssetType('egret.content.image', isTexture);
39
+ const metadataType = createAssetType('egret.content.metadata', v => typeof v === 'string');
40
+ const bindings = new Map();
41
+ const descriptions = [];
42
+ for (const e of entries.values()) {
43
+ const multi = e.resourceKind === 'atlas' && e.importer.id === 'egret.atlas-pages';
44
+ const profile = multi
45
+ ? ['egret.atlas-pages', 'egret.atlas-pages/1', 'application/json', e.dependencies.length]
46
+ : e.resourceKind === 'image'
47
+ ? ['egret.png', 'png/1', 'image/png', 0]
48
+ : e.resourceKind === 'atlas'
49
+ ? ['egret.aseprite-atlas', 'egret.atlas/1', 'application/json', 1]
50
+ : e.resourceKind === 'sequence'
51
+ ? ['egret.sequence', 'egret.sequence/1', 'application/json', 1]
52
+ : undefined;
53
+ if ((multi && (e.dependencies.length < 1 || e.dependencies.length > 16)) ||
54
+ !profile ||
55
+ e.importer.id !== profile[0] ||
56
+ e.importer.version !== '1.0.0' ||
57
+ e.artifactFormatVersion !== profile[1] ||
58
+ e.artifact.mediaType !== profile[2] ||
59
+ e.dependencies.length !== profile[3] ||
60
+ e.artifact.byteLength > (e.resourceKind === 'image' ? 8388608 : 4194304))
61
+ throw contentFault('PROFILE', e.id);
62
+ const dependency = entries.get(e.dependencies[0] ?? '');
63
+ if (multi && e.dependencies.some(id => entries.get(id)?.resourceKind !== 'image'))
64
+ throw contentFault('DEPENDENCY', e.id);
65
+ if ((e.resourceKind === 'atlas' && dependency?.resourceKind !== 'image') ||
66
+ (e.resourceKind === 'sequence' && dependency?.resourceKind !== 'atlas'))
67
+ throw contentFault('DEPENDENCY', e.id);
68
+ if (e.resourceKind === 'sequence' &&
69
+ (e.source.id !== dependency.source.id ||
70
+ e.source.sha256 !== dependency.source.sha256 ||
71
+ e.source.byteLength !== dependency.source.byteLength))
72
+ throw contentFault('SOURCE', e.id);
73
+ const binding = e.resourceKind === 'image'
74
+ ? createManifestAssetBinding(manifest, e.id, imageType)
75
+ : createManifestAssetBinding(manifest, e.id, metadataType);
76
+ bindings.set(e.id, binding);
77
+ descriptions.push(FREEZE({ id: e.id, kind: e.resourceKind, binding }));
78
+ }
79
+ const ports = APPLY(factory, undefined, [FREEZE(descriptions)]);
80
+ owner.assertOpen();
81
+ if (ports === null || typeof ports !== 'object' || Reflect.ownKeys(ports).length !== 2)
82
+ throw new EgretError('CONTENT_PROVIDERS_INVALID');
83
+ const texturePort = Object.getOwnPropertyDescriptor(ports, 'textures'), metadataPort = Object.getOwnPropertyDescriptor(ports, 'metadata');
84
+ if (!texturePort || !metadataPort || !Object.hasOwn(texturePort, 'value') || !Object.hasOwn(metadataPort, 'value'))
85
+ throw new EgretError('CONTENT_PROVIDERS_INVALID');
86
+ const providers = {
87
+ textures: provider(texturePort.value),
88
+ metadata: provider(metadataPort.value)
89
+ };
90
+ owner.assertOpen();
91
+ owner.register(imageType, providers.textures);
92
+ owner.register(metadataType, providers.metadata);
93
+ owner.assertOpen();
94
+ let disposed = false;
95
+ const groups = new Set();
96
+ let disown = () => { };
97
+ function assertOpen() {
98
+ owner.assertOpen();
99
+ if (disposed)
100
+ throw new EgretError('CONTENT_LOADER_DISPOSED');
101
+ }
102
+ function assertScope(scope) {
103
+ assertOpen();
104
+ if (!owner.isScope(scope))
105
+ throw new EgretError('CONTENT_SCOPE_INVALID');
106
+ if (APPLY(SCOPE_STATE, scope, []) !== 'open')
107
+ throw new EgretError('SCOPE_CLOSED');
108
+ }
109
+ function dispose() {
110
+ if (disposed)
111
+ return;
112
+ disposed = true;
113
+ disown();
114
+ for (const group of [...groups])
115
+ group.dispose();
116
+ groups.clear();
117
+ }
118
+ const loader = FREEZE({
119
+ get isDisposed() {
120
+ if (this !== loader)
121
+ throw new EgretError('CONTENT_LOADER_INVALID');
122
+ return disposed;
123
+ },
124
+ dispose() {
125
+ if (this !== loader)
126
+ throw new EgretError('CONTENT_LOADER_INVALID');
127
+ dispose();
128
+ },
129
+ load(scope, roots, options) {
130
+ if (this !== loader)
131
+ throw new EgretError('CONTENT_LOADER_INVALID');
132
+ assertScope(scope);
133
+ // Capture roots once; recheck lifetime after every caller-controlled read.
134
+ if (!Array.isArray(roots))
135
+ throw new EgretError('CONTENT_ROOTS_INVALID');
136
+ const count = roots.length;
137
+ assertScope(scope);
138
+ if (!Number.isInteger(count) || count < 0 || count > 128)
139
+ throw new EgretError('CONTENT_ROOTS_INVALID');
140
+ const selected = new Set(), ordered = [], captured = [];
141
+ function visit(id) {
142
+ if (selected.has(id))
143
+ return;
144
+ const entry = entries.get(id);
145
+ if (!entry)
146
+ throw contentFault('ROOT', id);
147
+ if (selected.size === 128)
148
+ throw new EgretError('CONTENT_GROUP_LIMIT');
149
+ selected.add(id);
150
+ for (const dependency of entry.dependencies)
151
+ visit(dependency);
152
+ ordered.push(entry);
153
+ }
154
+ for (let i = 0; i < count; i++) {
155
+ const descriptor = Object.getOwnPropertyDescriptor(roots, String(i));
156
+ assertScope(scope);
157
+ if (!descriptor ||
158
+ !Object.hasOwn(descriptor, 'value') ||
159
+ typeof descriptor.value !== 'string' ||
160
+ captured.includes(descriptor.value))
161
+ throw new EgretError('CONTENT_ROOTS_INVALID');
162
+ captured.push(descriptor.value);
163
+ visit(descriptor.value);
164
+ }
165
+ const raw = owner.group(scope, manifest, FREEZE(captured), ordered.map(e => bindings.get(e.id)), options);
166
+ const images = new Map(), sheets = new Map(), clips = new Map();
167
+ const atlasPages = new Map(), atlasPageNames = new Map();
168
+ let state = 'pending';
169
+ let resolve, reject;
170
+ const ready = new Promise((yes, no) => {
171
+ resolve = yes;
172
+ reject = no;
173
+ });
174
+ void ready.catch(() => { });
175
+ function retire(next, cause) {
176
+ if (state === 'disposed' || state === 'failed')
177
+ return;
178
+ const pending = state === 'pending';
179
+ state = next;
180
+ groups.delete(group);
181
+ if (pending)
182
+ reject(cause ?? new EgretError('CONTENT_GROUP_DISPOSED'));
183
+ // Sheets borrow raw group leases; revoke the wrappers before releasing leases.
184
+ for (const sheet of sheets.values())
185
+ sheet.dispose();
186
+ for (const pages of atlasPages.values())
187
+ for (const page of pages.values())
188
+ page.dispose();
189
+ sheets.clear();
190
+ atlasPages.clear();
191
+ atlasPageNames.clear();
192
+ images.clear();
193
+ clips.clear();
194
+ raw.dispose();
195
+ }
196
+ function read(map, id) {
197
+ assertScope(scope);
198
+ if (state !== 'ready')
199
+ throw new EgretError('CONTENT_GROUP_NOT_READY');
200
+ if (typeof id !== 'string' || !map.has(id))
201
+ throw new EgretError('CONTENT_RESOURCE_INVALID');
202
+ return map.get(id);
203
+ }
204
+ const group = FREEZE({
205
+ get ready() {
206
+ if (this !== group)
207
+ throw new EgretError('CONTENT_GROUP_INVALID');
208
+ return ready;
209
+ },
210
+ get isDisposed() {
211
+ if (this !== group)
212
+ throw new EgretError('CONTENT_GROUP_INVALID');
213
+ return state === 'disposed' || state === 'failed';
214
+ },
215
+ getImage(id) {
216
+ if (this !== group)
217
+ throw new EgretError('CONTENT_GROUP_INVALID');
218
+ return read(images, id);
219
+ },
220
+ getAtlas(id) {
221
+ if (this !== group)
222
+ throw new EgretError('CONTENT_GROUP_INVALID');
223
+ return read(sheets, id);
224
+ },
225
+ getAtlasPages(id) {
226
+ if (this !== group)
227
+ throw new EgretError('CONTENT_GROUP_INVALID');
228
+ return read(atlasPageNames, id);
229
+ },
230
+ getAtlasPage(id, page) {
231
+ if (this !== group)
232
+ throw new EgretError('CONTENT_GROUP_INVALID');
233
+ const pages = read(atlasPages, id);
234
+ if (typeof page !== 'string' || !pages.has(page))
235
+ throw new EgretError('CONTENT_RESOURCE_INVALID');
236
+ return pages.get(page);
237
+ },
238
+ getSequence(id) {
239
+ if (this !== group)
240
+ throw new EgretError('CONTENT_GROUP_INVALID');
241
+ return read(clips, id);
242
+ },
243
+ dispose() {
244
+ if (this !== group)
245
+ throw new EgretError('CONTENT_GROUP_INVALID');
246
+ retire('disposed');
247
+ }
248
+ });
249
+ groups.add(group);
250
+ try {
251
+ APPLY(SCOPE_USE, scope, [group]);
252
+ assertScope(scope);
253
+ }
254
+ catch (cause) {
255
+ retire('disposed', cause);
256
+ throw cause;
257
+ }
258
+ void raw.ready.then(() => {
259
+ if (state !== 'pending')
260
+ return;
261
+ try {
262
+ assertScope(scope);
263
+ const atlases = new Map();
264
+ for (const e of ordered) {
265
+ if (e.resourceKind === 'image') {
266
+ const lease = raw.get(bindings.get(e.id)), value = lease.value;
267
+ if (value.width > 4096 || value.height > 4096 || value.width * value.height > 4194304)
268
+ throw contentFault('IMAGE', e.id);
269
+ images.set(e.id, lease);
270
+ }
271
+ else {
272
+ const text = raw.get(bindings.get(e.id)).value;
273
+ if (e.resourceKind === 'atlas' && e.importer.id === 'egret.atlas-pages') {
274
+ const artifact = parseAtlasPagesArtifact(text, e.id, e.dependencies.length), pages = new Map();
275
+ // Register page wrappers before construction so partial failure
276
+ // revokes every successful borrow before raw leases are released.
277
+ atlasPages.set(e.id, pages);
278
+ for (let index = 0; index < artifact.pages.length; index++) {
279
+ const page = artifact.pages[index], lease = images.get(e.dependencies[index]);
280
+ if (lease.value.width !== page.width || lease.value.height !== page.height)
281
+ throw contentFault('DIMENSIONS', e.id);
282
+ pages.set(page.name, createSpriteSheet(lease, page.frames, 'trim-rotation-v1'));
283
+ }
284
+ atlasPageNames.set(e.id, FREEZE(artifact.pages.map(p => p.name)));
285
+ }
286
+ else if (e.resourceKind === 'atlas') {
287
+ const atlas = parseAtlasArtifact(text, e.id), page = images.get(e.dependencies[0]);
288
+ if (page.value.width !== atlas.width || page.value.height !== atlas.height)
289
+ throw contentFault('DIMENSIONS', e.id);
290
+ atlases.set(e.id, atlas);
291
+ sheets.set(e.id, createSpriteSheet(page, atlas.frames, 'trim-rotation-v1'));
292
+ }
293
+ else {
294
+ const atlas = atlases.get(e.dependencies[0]);
295
+ if (!atlas)
296
+ throw contentFault('DEPENDENCY', e.id);
297
+ const input = parseSequenceArtifact(text, e.id, atlas), clip = createSequenceClip(input, 'trim-rotation-v1');
298
+ registerSequenceTimeline(clip, input.frames);
299
+ clips.set(e.id, clip);
300
+ }
301
+ }
302
+ }
303
+ assertScope(scope);
304
+ state = 'ready';
305
+ resolve();
306
+ }
307
+ catch (cause) {
308
+ retire('failed', cause);
309
+ }
310
+ }, cause => retire('failed', contentFault('LOAD', captured.join(','), cause)));
311
+ return group;
312
+ }
313
+ });
314
+ registerContentLoader(loader, (scope, imageId, sequenceId) => {
315
+ assertScope(scope);
316
+ const sequence = entries.get(sequenceId), atlas = entries.get(sequence?.dependencies[0] ?? '');
317
+ if (sequence?.resourceKind !== 'sequence' ||
318
+ atlas?.resourceKind !== 'atlas' ||
319
+ atlas.dependencies.length !== 1 ||
320
+ atlas.dependencies[0] !== imageId ||
321
+ entries.get(imageId)?.resourceKind !== 'image')
322
+ throw new EgretError('SEQUENCE_RESET_RESOURCE_MISMATCH');
323
+ });
324
+ disown = owner.own(dispose);
325
+ return loader;
326
+ }
327
+ //# sourceMappingURL=contentLoader.js.map
@@ -0,0 +1,35 @@
1
+ import type { AssetLease, AssetProvider, Scope, SequenceClip, SpriteSheet, Texture } from '@egret/runtime';
2
+ import type { ManifestBinding, ManifestGroupOptions } from './manifestResourceTypes.js';
3
+ /** One resource a content loader binds: its id, its kind and its manifest binding. */
4
+ export interface ContentBinding {
5
+ readonly id: string;
6
+ readonly kind: 'image' | 'atlas' | 'sequence';
7
+ readonly binding: ManifestBinding;
8
+ }
9
+ /** Host providers own byte integrity/UTF-8 decoding; the core validates artifact semantics. */
10
+ export interface ContentProviders {
11
+ readonly textures: AssetProvider<Texture>;
12
+ readonly metadata: AssetProvider<string>;
13
+ }
14
+ /** Makes the providers that load a content loader's resources, given what they bind. */
15
+ export type ContentProviderFactory = (bindings: readonly ContentBinding[]) => ContentProviders;
16
+ /** All returned values are borrowed until this group or its owning Scope retires. */
17
+ export interface ContentGroup {
18
+ readonly ready: Promise<void>;
19
+ readonly isDisposed: boolean;
20
+ getImage(id: string): AssetLease<Texture>;
21
+ getAtlas(id: string): SpriteSheet;
22
+ /** Exact logical page names of an admitted multipage atlas; borrowed metadata. */
23
+ getAtlasPages(id: string): readonly string[];
24
+ /** The page borrows the same resource-group lifetime as legacy single sheets. */
25
+ getAtlasPage(id: string, page: string): SpriteSheet;
26
+ getSequence(id: string): SequenceClip;
27
+ dispose(): void;
28
+ }
29
+ /** One manifest/source identity; multiple groups share the existing asset manager. */
30
+ export interface ContentLoader {
31
+ readonly isDisposed: boolean;
32
+ load(scope: Scope, roots: readonly string[], options?: ManifestGroupOptions): ContentGroup;
33
+ dispose(): void;
34
+ }
35
+ //# sourceMappingURL=contentTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=contentTypes.js.map
@@ -0,0 +1,7 @@
1
+ import type { Engine, EngineOptions } from './Engine.js';
2
+ /**
3
+ * An Engine without a render port: it captures frames and does not render them.
4
+ * Reserve the surface before startup; failed startup uses the normal close path.
5
+ */
6
+ export declare function createEngine(options: EngineOptions): Promise<Engine>;
7
+ //# sourceMappingURL=createEngine.d.ts.map