@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,974 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { isAdmittedResourceManifest } from '@egret/contracts/resources';
3
+ import { CancellationController, EgretError } from '@egret/runtime';
4
+ import { requireManifestBinding, requireManifestAssetRef } from '#egret-manifest-resources';
5
+ const apply = Reflect.apply;
6
+ const freeze = Object.freeze;
7
+ const own = Object.getOwnPropertyDescriptor;
8
+ const proto = Object.getPrototypeOf;
9
+ const keys = Reflect.ownKeys;
10
+ const Bytes = Uint8Array;
11
+ const promise = Promise.resolve.bind(Promise);
12
+ const byteProto = proto(Bytes.prototype);
13
+ const byteTag = own(byteProto, Symbol.toStringTag).get;
14
+ const byteBuffer = own(byteProto, 'buffer').get;
15
+ const byteOffset = own(byteProto, 'byteOffset').get;
16
+ const byteLength = own(byteProto, 'byteLength').get;
17
+ const bufferLength = own(ArrayBuffer.prototype, 'byteLength').get;
18
+ const resizable = own(ArrayBuffer.prototype, 'resizable')?.get;
19
+ const detached = own(ArrayBuffer.prototype, 'detached')?.get;
20
+ const set = byteProto.set;
21
+ const owners = new WeakMap();
22
+ const MAX_INPUT = 8_388_608, MAX_BYTES = 33_554_432, MAX_NETWORK = 4, MAX_DECODE = 2, MAX_QUEUE = 128, MAX_RECORDS = 132;
23
+ const retryStatus = new Set([408, 429, 500, 502, 503, 504]);
24
+ const statusFields = [
25
+ 'jobs',
26
+ 'queuedNetwork',
27
+ 'queuedDecode',
28
+ 'retryWaiting',
29
+ 'activeNetwork',
30
+ 'activeDecode',
31
+ 'encodedCreditBytes',
32
+ 'ownedEncodedBytes',
33
+ 'borrowedChunkBytes',
34
+ 'quarantinedJobs'
35
+ ];
36
+ function deferred() {
37
+ let resolve, reject;
38
+ const result = new Promise((yes, no) => {
39
+ resolve = yes;
40
+ reject = no;
41
+ });
42
+ return { promise: result, resolve, reject };
43
+ }
44
+ function fault(code, cause) {
45
+ return new EgretError('WEB_RESOURCE_' + code, { cause });
46
+ }
47
+ function record(value) {
48
+ return typeof value === 'object' && value !== null;
49
+ }
50
+ function method(value) {
51
+ if (typeof value !== 'function')
52
+ throw new TypeError('Required operation unavailable');
53
+ return value;
54
+ }
55
+ function strict(value, allowed) {
56
+ if (!record(value) || (proto(value) !== Object.prototype && proto(value) !== null))
57
+ throw fault('OPTIONS_INVALID');
58
+ const result = Object.create(null);
59
+ for (const key of keys(value)) {
60
+ if (typeof key !== 'string' || !allowed.includes(key))
61
+ throw fault('OPTIONS_INVALID');
62
+ const property = own(value, key);
63
+ if (!property || !Object.hasOwn(property, 'value') || property.value === undefined)
64
+ throw fault('OPTIONS_INVALID');
65
+ result[key] = property.value;
66
+ }
67
+ return result;
68
+ }
69
+ function chunk(value) {
70
+ if (apply(byteTag, value, []) !== 'Uint8Array')
71
+ throw new TypeError('Intrinsic Uint8Array required');
72
+ const backing = apply(byteBuffer, value, []);
73
+ apply(bufferLength, backing, []);
74
+ if (resizable && apply(resizable, backing, []))
75
+ throw new TypeError('Resizable byte backing refused');
76
+ if (detached ? apply(detached, backing, []) : false)
77
+ throw new TypeError('Detached byte backing refused');
78
+ if (!detached)
79
+ new Bytes(backing, 0, 0);
80
+ return { backing, offset: apply(byteOffset, value, []), length: apply(byteLength, value, []) };
81
+ }
82
+ function spelling(value) {
83
+ return !/[\\\u0000-\u001f\u007f?#]/.test(value) && !/%(?:2e|2f|5c|25)/i.test(value);
84
+ }
85
+ function capture() {
86
+ try {
87
+ const global = globalThis;
88
+ const fetch = method(global.fetch), crypto = global.crypto, subtle = crypto.subtle;
89
+ const digest = method(subtle.digest), Abort = global.AbortController, URL = global.URL;
90
+ if (typeof Abort !== 'function' || typeof URL !== 'function')
91
+ throw new TypeError('Native browser capabilities unavailable');
92
+ const clock = global.performance;
93
+ return {
94
+ global,
95
+ fetch,
96
+ digest,
97
+ subtle,
98
+ Abort,
99
+ abort: method(Abort.prototype.abort),
100
+ signal: method(own(Abort.prototype, 'signal')?.get),
101
+ URL,
102
+ clock,
103
+ now: method(clock.now),
104
+ timer: method(global.setTimeout),
105
+ clear: method(global.clearTimeout)
106
+ };
107
+ }
108
+ catch (cause) {
109
+ throw fault('UNAVAILABLE', cause);
110
+ }
111
+ }
112
+ /** Private concrete token. Only its owning source can create/admit it. */
113
+ export class ManifestPngJob {
114
+ owner;
115
+ entry;
116
+ url;
117
+ end;
118
+ context;
119
+ publication = deferred();
120
+ cleanup = [];
121
+ aborter;
122
+ nativeSignal;
123
+ combined = new CancellationController();
124
+ abortCombined;
125
+ terminal;
126
+ actual;
127
+ timer;
128
+ signal;
129
+ remove;
130
+ listener;
131
+ installing = true;
132
+ listening = false;
133
+ finished = false;
134
+ reserved = 0;
135
+ network = false;
136
+ networkUnsafe = false;
137
+ decode = false;
138
+ queuedNetwork;
139
+ queuedDecode;
140
+ waitingRetry = false;
141
+ transport;
142
+ bytes;
143
+ borrowedChunkBytes = 0;
144
+ delay;
145
+ constructor(owner, entry, url, signal, remove, end, generation, taskId) {
146
+ this.owner = owner;
147
+ this.entry = entry;
148
+ this.url = url;
149
+ this.end = end;
150
+ this.signal = signal;
151
+ this.remove = remove;
152
+ this.listener = () => undefined;
153
+ const native = owner.controller();
154
+ this.aborter = native.controller;
155
+ this.nativeSignal = native.signal;
156
+ this.abortCombined = method(this.combined.abort);
157
+ this.context = freeze({ signal: this.combined.signal, resourceGeneration: generation, taskId });
158
+ // Rejections are publication state, never an unobserved background task.
159
+ void this.publication.promise.catch(() => undefined);
160
+ }
161
+ }
162
+ /** Concrete fixed owner; not exported from any public SDK entry. */
163
+ export class ManifestPngOwner {
164
+ native;
165
+ base;
166
+ selected = new Map();
167
+ jobs = new Set();
168
+ networkQueue = [];
169
+ decodeQueue = [];
170
+ networkCount = 0;
171
+ decodeCount = 0;
172
+ retryCount = 0;
173
+ byteCount = 0;
174
+ admissions = 0;
175
+ closed = false;
176
+ pumping = false;
177
+ closeResult;
178
+ inputLimit;
179
+ byteLimit;
180
+ deadlineMs;
181
+ retries;
182
+ highWater = {
183
+ jobs: 0,
184
+ queuedNetwork: 0,
185
+ queuedDecode: 0,
186
+ retryWaiting: 0,
187
+ activeNetwork: 0,
188
+ activeDecode: 0,
189
+ encodedCreditBytes: 0,
190
+ ownedEncodedBytes: 0,
191
+ borrowedChunkBytes: 0,
192
+ quarantinedJobs: 0
193
+ };
194
+ saturated = false;
195
+ constructor(manifest, bindings, options) {
196
+ if (!isAdmittedResourceManifest(manifest))
197
+ throw fault('MANIFEST_INVALID');
198
+ const admitted = [];
199
+ try {
200
+ if (!Array.isArray(bindings))
201
+ throw new TypeError('Bounded binding array required');
202
+ const length = bindings.length;
203
+ if (!Number.isSafeInteger(length) || length < 0 || length > 4096)
204
+ throw new TypeError('Bounded binding array required');
205
+ const ids = new Set();
206
+ for (let index = 0; index < length; index++) {
207
+ const property = own(bindings, String(index));
208
+ if (!property || !Object.hasOwn(property, 'value'))
209
+ throw new TypeError('Dense binding values required');
210
+ const item = requireManifestBinding(property.value);
211
+ if (item.manifest !== manifest || ids.has(item.entry.id))
212
+ throw new TypeError('Exact manifest and unique logical bindings required');
213
+ ids.add(item.entry.id);
214
+ admitted.push(item);
215
+ }
216
+ }
217
+ catch (cause) {
218
+ throw fault('BINDINGS_INVALID', cause);
219
+ }
220
+ const input = strict(options, ['baseUrl', 'deadlineMs', 'networkRetries', 'profile']);
221
+ if (input.profile !== undefined && input.profile !== 'font-sfnt/1')
222
+ throw fault('OPTIONS_INVALID');
223
+ if (input.profile === 'font-sfnt/1' &&
224
+ admitted.some(item => item.entry.resourceKind !== 'font' || item.entry.artifactFormatVersion !== 'egret.font/1'))
225
+ throw fault('BINDINGS_INVALID');
226
+ this.inputLimit = input.profile === 'font-sfnt/1' ? 33_554_432 : MAX_INPUT;
227
+ this.byteLimit = input.profile === 'font-sfnt/1' ? 67_108_864 : MAX_BYTES;
228
+ const deadline = input.deadlineMs ?? 10_000, retries = input.networkRetries ?? 0;
229
+ if (typeof input.baseUrl !== 'string' ||
230
+ typeof deadline !== 'number' ||
231
+ !Number.isSafeInteger(deadline) ||
232
+ deadline < 1 ||
233
+ deadline > 30_000 ||
234
+ (retries !== 0 && retries !== 1))
235
+ throw fault('OPTIONS_INVALID');
236
+ this.deadlineMs = deadline;
237
+ this.retries = retries;
238
+ this.native = capture();
239
+ try {
240
+ const text = input.baseUrl;
241
+ if (!spelling(text) || !text.endsWith('/'))
242
+ throw new TypeError('Explicit plain directory URL required');
243
+ const base = new this.native.URL(text);
244
+ if (!['http:', 'https:'].includes(base.protocol) ||
245
+ base.username ||
246
+ base.password ||
247
+ base.search ||
248
+ base.hash ||
249
+ base.href !== text)
250
+ throw new TypeError('Canonical http/https directory base required');
251
+ this.base = base;
252
+ for (const item of admitted) {
253
+ const path = item.entry.artifact.path;
254
+ if (!spelling(path) ||
255
+ path.trim() !== path ||
256
+ path.startsWith('/') ||
257
+ path.includes(':') ||
258
+ path.split('/').some(part => part === '.' || part === '..'))
259
+ throw new TypeError('Relative canonical artifact path required');
260
+ const resolved = new this.native.URL(path, base);
261
+ if (!this.contained(resolved))
262
+ throw new TypeError('Artifact URL outside allowed base');
263
+ this.selected.set(item.entry.runtimeIdentity, { entry: item.entry, type: item.ref.type, url: resolved.href });
264
+ }
265
+ }
266
+ catch (cause) {
267
+ throw fault('URL_INVALID', cause);
268
+ }
269
+ }
270
+ contained(value) {
271
+ return (value.origin === this.base.origin &&
272
+ value.pathname.startsWith(this.base.pathname) &&
273
+ !value.username &&
274
+ !value.password &&
275
+ !value.search &&
276
+ !value.hash);
277
+ }
278
+ now() {
279
+ return apply(this.native.now, this.native.clock, []);
280
+ }
281
+ controller() {
282
+ const controller = new this.native.Abort();
283
+ return { controller, signal: apply(this.native.signal, controller, []) };
284
+ }
285
+ get isClosed() {
286
+ return this.closed;
287
+ }
288
+ currentStatus() {
289
+ let ownedEncodedBytes = 0, borrowedChunkBytes = 0, quarantinedJobs = 0;
290
+ for (const job of this.jobs) {
291
+ // The original output allocation has exactly this admitted length.
292
+ // Reading status never inspects a caller/native byte view.
293
+ if (job.bytes !== undefined)
294
+ ownedEncodedBytes += job.entry.artifact.byteLength;
295
+ borrowedChunkBytes += job.borrowedChunkBytes;
296
+ if (job.finished)
297
+ quarantinedJobs++;
298
+ }
299
+ return {
300
+ jobs: this.jobs.size,
301
+ queuedNetwork: this.networkQueue.length,
302
+ queuedDecode: this.decodeQueue.length,
303
+ retryWaiting: this.retryCount,
304
+ activeNetwork: this.networkCount,
305
+ activeDecode: this.decodeCount,
306
+ encodedCreditBytes: this.byteCount,
307
+ ownedEncodedBytes,
308
+ borrowedChunkBytes,
309
+ quarantinedJobs
310
+ };
311
+ }
312
+ sampleStatus() {
313
+ const current = this.currentStatus();
314
+ for (const key of statusFields) {
315
+ const value = current[key];
316
+ if (value > Number.MAX_SAFE_INTEGER) {
317
+ this.highWater[key] = Number.MAX_SAFE_INTEGER;
318
+ this.saturated = true;
319
+ }
320
+ else if (value > this.highWater[key])
321
+ this.highWater[key] = value;
322
+ }
323
+ }
324
+ getStatus() {
325
+ return freeze({
326
+ current: freeze(this.currentStatus()),
327
+ highWater: freeze({ ...this.highWater }),
328
+ saturated: this.saturated
329
+ });
330
+ }
331
+ begin(ref, context) {
332
+ if (this.closed)
333
+ throw fault('SOURCE_CLOSED');
334
+ const started = this.now();
335
+ let selected;
336
+ try {
337
+ const state = requireManifestAssetRef(ref);
338
+ selected = this.selected.get(state.entry.runtimeIdentity);
339
+ if (!selected || selected.type !== state.ref.type)
340
+ throw new TypeError('Selected genuine ref required');
341
+ }
342
+ catch (cause) {
343
+ throw fault('REF_INVALID', cause);
344
+ }
345
+ if (selected.entry.artifact.byteLength > this.inputLimit)
346
+ throw fault('INPUT_LIMIT');
347
+ if (this.jobs.size + this.admissions >= MAX_RECORDS || this.waitingCount() >= MAX_QUEUE)
348
+ throw fault('QUEUE_LIMIT');
349
+ let signal, add, remove, generation, taskId;
350
+ try {
351
+ if (!record(context))
352
+ throw new TypeError('Load context required');
353
+ signal = context.signal;
354
+ generation = context.resourceGeneration;
355
+ taskId = context.taskId;
356
+ if (!record(signal) ||
357
+ !Number.isSafeInteger(generation) ||
358
+ generation < 1 ||
359
+ !Number.isSafeInteger(taskId) ||
360
+ taskId < 1)
361
+ throw new TypeError('Signal and positive local IDs required');
362
+ add = method(signal.addEventListener);
363
+ remove = method(signal.removeEventListener);
364
+ }
365
+ catch (cause) {
366
+ throw fault('CONTEXT_INVALID', cause);
367
+ }
368
+ if (this.closed)
369
+ throw fault('SOURCE_CLOSED');
370
+ // Caller context/signal getters may synchronously admit other work.
371
+ // Reserve only after that external phase, with a fresh finite-cap check.
372
+ if (this.jobs.size + this.admissions >= MAX_RECORDS || this.waitingCount() >= MAX_QUEUE)
373
+ throw fault('QUEUE_LIMIT');
374
+ const end = started + this.deadlineMs;
375
+ let job;
376
+ this.admissions++;
377
+ try {
378
+ job = new ManifestPngJob(this, selected.entry, selected.url, signal, remove, end, generation, taskId);
379
+ }
380
+ catch (cause) {
381
+ this.admissions--;
382
+ this.settleClose();
383
+ throw fault('UNAVAILABLE', cause);
384
+ }
385
+ this.admissions--;
386
+ this.jobs.add(job);
387
+ this.sampleStatus();
388
+ job.listener = () => {
389
+ if (job.terminal)
390
+ return;
391
+ try {
392
+ this.cancel(job, fault('CANCELLED', signal.reason));
393
+ }
394
+ catch (cause) {
395
+ this.cancel(job, fault('CONTEXT_INVALID', cause));
396
+ }
397
+ };
398
+ try {
399
+ if (this.closed)
400
+ this.cancel(job, fault('SOURCE_CLOSED'));
401
+ job.timer = apply(this.native.timer, this.native.global, [
402
+ () => this.cancel(job, fault('DEADLINE_EXCEEDED')),
403
+ Math.max(0, end - this.now())
404
+ ]);
405
+ if (!job.terminal) {
406
+ const aborted = signal.aborted;
407
+ if (typeof aborted !== 'boolean')
408
+ throw new TypeError('Boolean cancellation state required');
409
+ if (aborted)
410
+ job.listener();
411
+ else {
412
+ job.listening = true;
413
+ apply(add, signal, ['abort', job.listener, { once: true }]);
414
+ }
415
+ }
416
+ job.installing = false;
417
+ if (!job.terminal) {
418
+ const after = signal.aborted;
419
+ if (typeof after !== 'boolean')
420
+ throw new TypeError('Boolean cancellation state required');
421
+ if (after)
422
+ job.listener();
423
+ }
424
+ if (job.terminal)
425
+ this.detach(job);
426
+ }
427
+ catch (cause) {
428
+ job.installing = false;
429
+ this.cancel(job, fault('CONTEXT_INVALID', cause));
430
+ this.detach(job);
431
+ }
432
+ return job;
433
+ }
434
+ authentic(job) {
435
+ if (job.owner !== this || !this.jobs.has(job) || job.finished)
436
+ throw fault('CONTEXT_INVALID');
437
+ }
438
+ checkpoint(job) {
439
+ if (!job.terminal && this.now() >= job.end)
440
+ this.cancel(job, fault('DEADLINE_EXCEEDED'));
441
+ if (job.terminal)
442
+ throw job.terminal;
443
+ }
444
+ detach(job) {
445
+ if (!job.listening || job.installing)
446
+ return;
447
+ job.listening = false;
448
+ try {
449
+ apply(job.remove, job.signal, ['abort', job.listener]);
450
+ }
451
+ catch (cause) {
452
+ job.cleanup.push(cause);
453
+ }
454
+ }
455
+ cancel(job, error) {
456
+ if (job.owner !== this || job.finished || job.terminal)
457
+ return;
458
+ job.terminal = error;
459
+ job.publication.reject(error);
460
+ this.detach(job);
461
+ try {
462
+ apply(job.abortCombined, job.combined, [error]);
463
+ }
464
+ catch (cause) {
465
+ job.cleanup.push(cause);
466
+ }
467
+ // Cancel a readable native stream before fetch abort can error it.
468
+ // Its original cancellation still owns settlement and any cleanup failure.
469
+ this.cancelBody(job);
470
+ try {
471
+ apply(this.native.abort, job.aborter, [error]);
472
+ }
473
+ catch (cause) {
474
+ job.cleanup.push(cause);
475
+ job.networkUnsafe = true;
476
+ }
477
+ for (const [queue, property] of [
478
+ [this.networkQueue, 'queuedNetwork'],
479
+ [this.decodeQueue, 'queuedDecode']
480
+ ]) {
481
+ const at = queue.indexOf(job);
482
+ if (at >= 0) {
483
+ queue.splice(at, 1);
484
+ const waiting = job[property];
485
+ job[property] = undefined;
486
+ waiting?.reject(error);
487
+ }
488
+ }
489
+ if (job.waitingRetry) {
490
+ job.waitingRetry = false;
491
+ this.retryCount--;
492
+ }
493
+ this.sampleStatus();
494
+ if (job.delay) {
495
+ const delay = job.delay;
496
+ job.delay = undefined;
497
+ try {
498
+ apply(this.native.clear, this.native.global, [delay.handle]);
499
+ }
500
+ catch (cause) {
501
+ job.cleanup.push(cause);
502
+ }
503
+ delay.finish();
504
+ }
505
+ this.pump();
506
+ }
507
+ cancelBody(job) {
508
+ const transport = job.transport;
509
+ if (!transport || transport.cancellation || !transport.cancel || !transport.receiver)
510
+ return;
511
+ // Claim cancellation before caller-owned code can re-enter close/abort.
512
+ const cancellation = deferred();
513
+ transport.cancellation = cancellation.promise;
514
+ void transport.cancellation.catch(() => undefined);
515
+ try {
516
+ cancellation.resolve(promise(apply(transport.cancel, transport.receiver, [job.terminal])));
517
+ }
518
+ catch (cause) {
519
+ cancellation.reject(cause);
520
+ }
521
+ }
522
+ pump() {
523
+ if (this.pumping)
524
+ return;
525
+ this.pumping = true;
526
+ try {
527
+ while (this.networkQueue.length && this.networkCount < MAX_NETWORK) {
528
+ const job = this.networkQueue[0];
529
+ if (job.terminal) {
530
+ this.networkQueue.shift();
531
+ job.queuedNetwork?.reject(job.terminal);
532
+ job.queuedNetwork = undefined;
533
+ continue;
534
+ }
535
+ const credit = job.reserved === 0 ? job.entry.artifact.byteLength * 2 : 0;
536
+ if (this.byteCount + credit > this.byteLimit)
537
+ break;
538
+ this.networkQueue.shift();
539
+ this.networkCount++;
540
+ job.network = true;
541
+ if (credit) {
542
+ job.reserved = credit;
543
+ this.byteCount += credit;
544
+ }
545
+ const waiting = job.queuedNetwork;
546
+ job.queuedNetwork = undefined;
547
+ this.sampleStatus();
548
+ waiting.resolve();
549
+ }
550
+ while (this.decodeQueue.length && this.decodeCount < MAX_DECODE) {
551
+ const job = this.decodeQueue.shift();
552
+ const waiting = job.queuedDecode;
553
+ job.queuedDecode = undefined;
554
+ if (job.terminal) {
555
+ waiting.reject(job.terminal);
556
+ continue;
557
+ }
558
+ this.decodeCount++;
559
+ job.decode = true;
560
+ this.sampleStatus();
561
+ waiting.resolve();
562
+ }
563
+ }
564
+ finally {
565
+ this.pumping = false;
566
+ this.sampleStatus();
567
+ }
568
+ }
569
+ waitingCount() {
570
+ return this.networkQueue.length + this.decodeQueue.length + this.retryCount;
571
+ }
572
+ networkPermit(job) {
573
+ this.checkpoint(job);
574
+ if (job.waitingRetry) {
575
+ job.waitingRetry = false;
576
+ this.retryCount--;
577
+ }
578
+ else if (this.waitingCount() >= MAX_QUEUE)
579
+ return Promise.reject(fault('QUEUE_LIMIT'));
580
+ const waiting = deferred();
581
+ job.queuedNetwork = waiting;
582
+ this.networkQueue.push(job);
583
+ this.sampleStatus();
584
+ this.pump();
585
+ return waiting.promise;
586
+ }
587
+ async decode(job) {
588
+ this.authentic(job);
589
+ this.checkpoint(job);
590
+ if (this.waitingCount() >= MAX_QUEUE)
591
+ throw fault('QUEUE_LIMIT');
592
+ const waiting = deferred();
593
+ job.queuedDecode = waiting;
594
+ this.decodeQueue.push(job);
595
+ this.sampleStatus();
596
+ this.pump();
597
+ await waiting.promise;
598
+ try {
599
+ this.checkpoint(job);
600
+ }
601
+ catch (cause) {
602
+ this.decoded(job);
603
+ throw cause;
604
+ }
605
+ }
606
+ decoded(job) {
607
+ if (job.decode) {
608
+ job.decode = false;
609
+ this.decodeCount--;
610
+ this.sampleStatus();
611
+ this.pump();
612
+ }
613
+ }
614
+ async transport(job) {
615
+ await this.networkPermit(job);
616
+ let result;
617
+ let transport;
618
+ try {
619
+ this.checkpoint(job);
620
+ let response;
621
+ try {
622
+ response = await promise(apply(this.native.fetch, this.native.global, [
623
+ job.url,
624
+ { method: 'GET', credentials: 'omit', redirect: 'error', cache: 'no-store', signal: job.nativeSignal }
625
+ ]));
626
+ }
627
+ catch (cause) {
628
+ return {
629
+ retry: cause instanceof TypeError && !job.terminal,
630
+ error: job.terminal ?? fault('FETCH_FAILED', cause)
631
+ };
632
+ }
633
+ if (!record(response))
634
+ throw fault('RESPONSE_INVALID');
635
+ const value = response;
636
+ let body;
637
+ try {
638
+ body = value.body;
639
+ }
640
+ catch (cause) {
641
+ job.cleanup.push(cause);
642
+ job.networkUnsafe = true;
643
+ throw fault('RESPONSE_INVALID', cause);
644
+ }
645
+ if (!record(body))
646
+ throw fault('RESPONSE_INVALID', new TypeError('Streamed body required'));
647
+ let bodyCancel;
648
+ try {
649
+ bodyCancel = method(body.cancel);
650
+ }
651
+ catch (cause) {
652
+ job.cleanup.push(cause);
653
+ job.networkUnsafe = true;
654
+ throw fault('RESPONSE_INVALID', cause);
655
+ }
656
+ transport = { cancel: bodyCancel, receiver: body, cancellation: undefined, release: undefined, released: false };
657
+ job.transport = transport;
658
+ if (job.terminal) {
659
+ this.cancelBody(job);
660
+ throw job.terminal;
661
+ }
662
+ const status = value.status, url = value.url, redirected = value.redirected;
663
+ if (typeof status !== 'number' || !Number.isInteger(status) || typeof url !== 'string' || redirected !== false)
664
+ throw fault('RESPONSE_INVALID');
665
+ const finalUrl = new this.native.URL(url);
666
+ if (!spelling(url) || finalUrl.href !== url || !this.contained(finalUrl))
667
+ throw fault('URL_INVALID');
668
+ if (status !== 200) {
669
+ this.cancelBody(job);
670
+ return { retry: retryStatus.has(status), error: fault('HTTP_STATUS', status) };
671
+ }
672
+ const getReader = method(body.getReader);
673
+ const reader = apply(getReader, body, []);
674
+ if (!record(reader))
675
+ throw fault('RESPONSE_INVALID');
676
+ // The reader now owns an acquired lock. Capture retirement before
677
+ // other reader methods, but still attempt cancellation capture if
678
+ // retirement is unavailable. Neither absence proves clean release.
679
+ transport.receiver = reader;
680
+ transport.cancel = undefined;
681
+ let captureFailed = false, captureCause;
682
+ try {
683
+ transport.release = method(reader.releaseLock);
684
+ }
685
+ catch (cause) {
686
+ captureFailed = true;
687
+ captureCause = cause;
688
+ job.cleanup.push(cause);
689
+ job.networkUnsafe = true;
690
+ }
691
+ try {
692
+ transport.cancel = method(reader.cancel);
693
+ }
694
+ catch (cause) {
695
+ if (!captureFailed)
696
+ captureCause = cause;
697
+ captureFailed = true;
698
+ job.cleanup.push(cause);
699
+ job.networkUnsafe = true;
700
+ }
701
+ if (captureFailed)
702
+ throw fault('RESPONSE_INVALID', captureCause);
703
+ const read = method(reader.read);
704
+ this.checkpoint(job);
705
+ const expected = job.entry.artifact.byteLength;
706
+ const output = new Bytes(expected);
707
+ job.bytes = output;
708
+ this.sampleStatus();
709
+ let count = 0;
710
+ for (;;) {
711
+ this.checkpoint(job);
712
+ let part;
713
+ try {
714
+ part = await promise(apply(read, reader, []));
715
+ }
716
+ catch (cause) {
717
+ throw fault('BODY_FAILED', cause);
718
+ }
719
+ this.checkpoint(job);
720
+ if (!record(part))
721
+ throw fault('BODY_FAILED', new TypeError('Reader result required'));
722
+ const done = part.done;
723
+ if (typeof done !== 'boolean')
724
+ throw fault('BODY_FAILED');
725
+ if (done)
726
+ break;
727
+ let item;
728
+ try {
729
+ item = chunk(part.value);
730
+ }
731
+ catch (cause) {
732
+ throw fault('BODY_FAILED', cause);
733
+ }
734
+ if (item.length > expected - count || item.length > this.inputLimit - count)
735
+ throw fault('INPUT_LIMIT');
736
+ job.borrowedChunkBytes = item.length;
737
+ this.sampleStatus();
738
+ try {
739
+ apply(set, output, [new Bytes(item.backing, item.offset, item.length), count]);
740
+ count += item.length;
741
+ }
742
+ finally {
743
+ job.borrowedChunkBytes = 0;
744
+ this.sampleStatus();
745
+ }
746
+ }
747
+ if (count !== expected)
748
+ throw fault('LENGTH_MISMATCH');
749
+ result = { bytes: output };
750
+ }
751
+ catch (cause) {
752
+ if (transport)
753
+ this.cancelBody(job);
754
+ result = { error: job.terminal ?? (cause instanceof EgretError ? cause : fault('RESPONSE_INVALID', cause)) };
755
+ }
756
+ finally {
757
+ let awaitedCancellation;
758
+ if (transport?.cancellation) {
759
+ awaitedCancellation = transport.cancellation;
760
+ try {
761
+ await awaitedCancellation;
762
+ }
763
+ catch (cause) {
764
+ job.cleanup.push(cause);
765
+ job.networkUnsafe = true;
766
+ }
767
+ }
768
+ if (transport?.release && !transport.released) {
769
+ transport.released = true;
770
+ try {
771
+ apply(transport.release, transport.receiver, []);
772
+ }
773
+ catch (cause) {
774
+ job.cleanup.push(cause);
775
+ job.networkUnsafe = true;
776
+ }
777
+ }
778
+ // releaseLock is caller-owned and can synchronously initiate abort.
779
+ // Its newly started cancellation remains part of this original run.
780
+ if (transport?.cancellation && transport.cancellation !== awaitedCancellation) {
781
+ try {
782
+ await transport.cancellation;
783
+ }
784
+ catch (cause) {
785
+ job.cleanup.push(cause);
786
+ job.networkUnsafe = true;
787
+ }
788
+ }
789
+ job.transport = undefined;
790
+ if (job.network && !job.networkUnsafe) {
791
+ job.network = false;
792
+ this.networkCount--;
793
+ this.sampleStatus();
794
+ this.pump();
795
+ }
796
+ }
797
+ return result;
798
+ }
799
+ async waitRetry(job) {
800
+ this.checkpoint(job);
801
+ if (job.end - this.now() < 100) {
802
+ this.cancel(job, fault('DEADLINE_EXCEEDED'));
803
+ throw job.terminal;
804
+ }
805
+ if (this.waitingCount() >= MAX_QUEUE)
806
+ throw fault('QUEUE_LIMIT');
807
+ job.waitingRetry = true;
808
+ this.retryCount++;
809
+ this.sampleStatus();
810
+ await new Promise(resolve => {
811
+ const handle = apply(this.native.timer, this.native.global, [
812
+ () => {
813
+ job.delay = undefined;
814
+ resolve();
815
+ },
816
+ 100
817
+ ]);
818
+ job.delay = { handle, finish: resolve };
819
+ });
820
+ // Keep this single waiting reservation until networkPermit transfers it
821
+ // synchronously to the network queue, or cancellation releases it.
822
+ this.checkpoint(job);
823
+ }
824
+ readActual(job) {
825
+ this.authentic(job);
826
+ if (job.actual)
827
+ return job.actual;
828
+ job.actual = (async () => {
829
+ for (let attempt = 0;; attempt++) {
830
+ const result = await this.transport(job);
831
+ if (job.networkUnsafe)
832
+ throw fault('CLOSE_INCOMPLETE', job.cleanup[0]);
833
+ this.checkpoint(job);
834
+ if (result.error) {
835
+ if (result.retry && attempt < this.retries) {
836
+ job.bytes = undefined;
837
+ this.sampleStatus();
838
+ await this.waitRetry(job);
839
+ continue;
840
+ }
841
+ throw result.error;
842
+ }
843
+ const data = result.bytes;
844
+ let hash;
845
+ try {
846
+ hash = await promise(apply(this.native.digest, this.native.subtle, ['SHA-256', data]));
847
+ }
848
+ catch (cause) {
849
+ throw fault('INTEGRITY_MISMATCH', cause);
850
+ }
851
+ this.checkpoint(job);
852
+ const digest = new Bytes(hash);
853
+ if (digest.byteLength !== 32 ||
854
+ Array.from(digest, value => value.toString(16).padStart(2, '0')).join('') !== job.entry.artifact.sha256)
855
+ throw fault('INTEGRITY_MISMATCH');
856
+ return data;
857
+ }
858
+ })().catch(cause => {
859
+ const error = cause instanceof EgretError ? cause : fault('BODY_FAILED', cause);
860
+ this.cancel(job, error);
861
+ throw error;
862
+ });
863
+ void job.actual.catch(() => undefined);
864
+ return job.actual;
865
+ }
866
+ publish(job, value) {
867
+ try {
868
+ this.checkpoint(job);
869
+ }
870
+ catch {
871
+ return false;
872
+ }
873
+ job.publication.resolve(value);
874
+ return true;
875
+ }
876
+ reject(job, cause) {
877
+ this.cancel(job, cause instanceof EgretError ? cause : fault('BODY_FAILED', cause));
878
+ }
879
+ publication(job) {
880
+ return job.publication.promise;
881
+ }
882
+ finish(job) {
883
+ if (job.finished)
884
+ return;
885
+ this.detach(job);
886
+ if (job.timer !== undefined) {
887
+ try {
888
+ apply(this.native.clear, this.native.global, [job.timer]);
889
+ }
890
+ catch (cause) {
891
+ job.cleanup.push(cause);
892
+ }
893
+ job.timer = undefined;
894
+ }
895
+ job.finished = true;
896
+ if (job.cleanup.length === 0) {
897
+ this.byteCount -= job.reserved;
898
+ job.reserved = 0;
899
+ job.bytes = undefined;
900
+ this.jobs.delete(job);
901
+ }
902
+ this.sampleStatus();
903
+ this.pump();
904
+ this.settleClose();
905
+ }
906
+ settleClose() {
907
+ if (!this.closeResult || this.admissions !== 0 || [...this.jobs].some(job => !job.finished))
908
+ return;
909
+ const cleanup = [...this.jobs].flatMap(job => job.cleanup);
910
+ if (cleanup.length)
911
+ this.closeResult.reject(new EgretError('WEB_RESOURCE_CLOSE_INCOMPLETE', { cause: cleanup[0], cleanupErrors: cleanup }));
912
+ else
913
+ this.closeResult.resolve();
914
+ }
915
+ close() {
916
+ if (!this.closeResult) {
917
+ this.closed = true;
918
+ this.closeResult = deferred();
919
+ for (const job of this.jobs)
920
+ this.cancel(job, fault('SOURCE_CLOSED'));
921
+ this.settleClose();
922
+ }
923
+ return this.closeResult.promise;
924
+ }
925
+ }
926
+ export function requireManifestByteSource(source) {
927
+ const owner = owners.get(source);
928
+ if (!owner)
929
+ throw fault('SOURCE_INVALID');
930
+ return owner;
931
+ }
932
+ export function createManifestByteSource(manifest, bindings, options) {
933
+ const owner = new ManifestPngOwner(manifest, bindings, options);
934
+ const source = freeze({
935
+ profile: 'manifest-sha256-browser-v1',
936
+ get isClosed() {
937
+ if (this !== source)
938
+ throw fault('SOURCE_INVALID');
939
+ return owner.isClosed;
940
+ },
941
+ readBytes(ref, context) {
942
+ if (this !== source)
943
+ return Promise.reject(fault('SOURCE_INVALID'));
944
+ let job;
945
+ try {
946
+ job = owner.begin(ref, context);
947
+ }
948
+ catch (cause) {
949
+ return Promise.reject(cause);
950
+ }
951
+ void owner.readActual(job).then(value => {
952
+ owner.publish(job, value);
953
+ owner.finish(job);
954
+ }, cause => {
955
+ owner.reject(job, cause);
956
+ owner.finish(job);
957
+ });
958
+ return owner.publication(job);
959
+ },
960
+ close() {
961
+ if (this !== source)
962
+ throw fault('SOURCE_INVALID');
963
+ return owner.close();
964
+ },
965
+ getStatus() {
966
+ if (this !== source)
967
+ throw fault('SOURCE_INVALID');
968
+ return owner.getStatus();
969
+ }
970
+ });
971
+ owners.set(source, owner);
972
+ return source;
973
+ }
974
+ //# sourceMappingURL=ManifestByteSource.js.map