@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,233 @@
1
+ /**
2
+ * Whether sound comes out. A closed mixer stays closed. A locked one waits for its host: a page
3
+ * may not start its output before the person has touched it. A suspended one was asked to be
4
+ * silent, by the game or by the host, and says by whom in its snapshot.
5
+ */
6
+ export type AudioMixerState = 'running' | 'suspended' | 'locked' | 'closed';
7
+ /**
8
+ * Why a voice is over: it reached its end; it was stopped; it gave its place to a newer voice; no
9
+ * place could be made for it; it was asked for while nothing could be heard; its sound was
10
+ * released; or the mixer was disposed.
11
+ */
12
+ export type AudioEndReason = 'finished' | 'stopped' | 'stolen' | 'limit' | 'silent' | 'released' | 'closed';
13
+ export type AudioVoiceState = 'playing' | 'paused' | 'stopping' | 'ended';
14
+ /** Decoded samples held by the host, or a file it plays as it reads it. */
15
+ export interface AudioBackendSound {
16
+ /** Seconds. */
17
+ readonly duration: number;
18
+ readonly channels: number;
19
+ readonly sampleRate: number;
20
+ /** Played as it is read: it has one place, so one voice at a time. */
21
+ readonly streamed?: boolean;
22
+ release(): void;
23
+ }
24
+ /** One gain on the way to the output. */
25
+ export interface AudioBackendBus {
26
+ /** Reaches the value in a straight line over the seconds given, from where the gain is now. */
27
+ setGain(value: number, seconds: number): void;
28
+ release(): void;
29
+ }
30
+ export interface AudioBackendStart {
31
+ readonly sound: AudioBackendSound;
32
+ readonly bus: AudioBackendBus;
33
+ /** Seconds into the sound. */
34
+ readonly offset: number;
35
+ readonly loop: boolean;
36
+ readonly rate: number;
37
+ readonly gain: number;
38
+ /** A balance: -1 is the left side alone, 1 the right side alone, 0 the sound as it is. */
39
+ readonly pan: number;
40
+ /** Seconds over which the gain rises from nothing. */
41
+ readonly fadeIn: number;
42
+ }
43
+ /** One sound being played once. */
44
+ export interface AudioBackendVoice {
45
+ setGain(value: number, seconds: number): void;
46
+ setRate(value: number): void;
47
+ setPan(value: number): void;
48
+ /** Stops after the seconds given. The end is told as any other end is. */
49
+ stop(seconds: number): void;
50
+ /** Seconds into the sound, where the host knows better than the clock of the output does. */
51
+ position?(): number;
52
+ }
53
+ /**
54
+ * What a host gives the mixer. Its clock stands still while its output is suspended or has not
55
+ * been let start, and a voice started while it stands still begins when it moves again.
56
+ */
57
+ export interface AudioBackend {
58
+ /** Seconds on the clock of the output. */
59
+ readonly time: number;
60
+ /** The bytes of one encoded file. They are the caller's and stay unchanged. */
61
+ decode(bytes: Uint8Array): Promise<AudioBackendSound>;
62
+ /** A file the host plays as it reads it, where it can. The sound it gives says `streamed`. */
63
+ openStream?(url: string): Promise<AudioBackendSound>;
64
+ /** Without a parent it feeds the output. */
65
+ createBus(parent: AudioBackendBus | undefined): AudioBackendBus;
66
+ /** `ended` is called once, later, when the voice has stopped sounding for any reason. */
67
+ start(request: AudioBackendStart, ended: () => void): AudioBackendVoice;
68
+ suspend(): void;
69
+ resume(): void;
70
+ close(): void;
71
+ }
72
+ export interface AudioBusOptions {
73
+ readonly name: string;
74
+ /** 0 to 1. Defaults to 1. */
75
+ readonly volume?: number;
76
+ readonly muted?: boolean;
77
+ }
78
+ export interface AudioMixerOptions {
79
+ readonly backend: AudioBackend;
80
+ /** Named volumes under the master one. Defaults to 'music' and 'effects'. */
81
+ readonly buses?: readonly (string | AudioBusOptions)[];
82
+ /** The master volume, 0 to 1. Defaults to 1. */
83
+ readonly volume?: number;
84
+ readonly muted?: boolean;
85
+ /** The host has not let the output start yet. */
86
+ readonly locked?: boolean;
87
+ /** Voices that are not over, 1 to 256. Defaults to 32. */
88
+ readonly maxVoices?: number;
89
+ /** Sounds that are not released, 1 to 4096. Defaults to 256. */
90
+ readonly maxSounds?: number;
91
+ /** Decoded samples held at once, as bytes of 32-bit samples. Defaults to 128 MiB. */
92
+ readonly maxDecodedBytes?: number;
93
+ }
94
+ export interface AudioFade {
95
+ /** Seconds, 0 to 60. Defaults to 0. */
96
+ readonly fade?: number;
97
+ }
98
+ export interface AudioBus {
99
+ readonly name: string;
100
+ readonly volume: number;
101
+ readonly muted: boolean;
102
+ /** Voices on this bus that are not over. */
103
+ readonly voices: number;
104
+ setVolume(value: number, options?: AudioFade): void;
105
+ setMuted(muted: boolean): void;
106
+ }
107
+ export interface AudioSound {
108
+ readonly duration: number;
109
+ readonly channels: number;
110
+ readonly sampleRate: number;
111
+ /** What the decoded samples are counted as against the budget of the mixer. Nothing for a stream. */
112
+ readonly decodedBytes: number;
113
+ /** Played as it is read. It has one place: a new voice of it ends the one before. */
114
+ readonly streamed: boolean;
115
+ readonly state: 'ready' | 'released';
116
+ /** Ends its voices and gives the samples back. A scope can own a sound through this. */
117
+ release(): void;
118
+ }
119
+ export interface AudioPlayOptions {
120
+ /** Defaults to 'effects' when the mixer has that bus, otherwise to the first bus. */
121
+ readonly bus?: string;
122
+ /** 0 to 1. Defaults to 1. */
123
+ readonly volume?: number;
124
+ /** Speed and pitch together, 0.25 to 4. Defaults to 1. */
125
+ readonly rate?: number;
126
+ /** A balance: -1 is the left side alone, 1 the right side alone. Defaults to 0, the sound as it is. */
127
+ readonly pan?: number;
128
+ readonly loop?: boolean;
129
+ /** Seconds into the sound, below its duration. Defaults to 0. */
130
+ readonly offset?: number;
131
+ /** Seconds, 0 to 60. Defaults to 0. */
132
+ readonly fadeIn?: number;
133
+ /** At most this many voices of this sound: the oldest gives its place. */
134
+ readonly maxInstances?: number;
135
+ /**
136
+ * What happens when nothing can be heard: 'drop' ends the voice at once, 'start' starts it
137
+ * so that it is heard when the output runs again. Defaults to 'drop'.
138
+ */
139
+ readonly whileSilent?: 'drop' | 'start';
140
+ }
141
+ export interface AudioMusicOptions {
142
+ /** Defaults to 'music' when the mixer has that bus, otherwise to the first bus. */
143
+ readonly bus?: string;
144
+ readonly volume?: number;
145
+ /** Seconds over which the new music rises and the old one falls. Defaults to 0. */
146
+ readonly fade?: number;
147
+ /** Defaults to true. */
148
+ readonly loop?: boolean;
149
+ readonly offset?: number;
150
+ /** Start again even when this sound is already the music. */
151
+ readonly restart?: boolean;
152
+ }
153
+ export interface AudioVoice {
154
+ readonly id: number;
155
+ readonly sound: AudioSound;
156
+ readonly bus: string;
157
+ readonly state: AudioVoiceState;
158
+ readonly endReason: AudioEndReason | undefined;
159
+ readonly volume: number;
160
+ readonly rate: number;
161
+ readonly pan: number;
162
+ readonly loop: boolean;
163
+ /** Seconds into the sound, by the clock of the output. */
164
+ readonly position: number;
165
+ /** Settles when the voice is over. It never rejects. */
166
+ readonly ended: Promise<AudioEndReason>;
167
+ setVolume(value: number, options?: AudioFade): void;
168
+ setRate(value: number): void;
169
+ setPan(value: number): void;
170
+ pause(): void;
171
+ resume(): void;
172
+ stop(options?: AudioFade): void;
173
+ }
174
+ export interface AudioBusSnapshot {
175
+ readonly name: string;
176
+ readonly volume: number;
177
+ readonly muted: boolean;
178
+ readonly voices: number;
179
+ }
180
+ export interface AudioMixerSnapshot {
181
+ readonly state: AudioMixerState;
182
+ readonly locked: boolean;
183
+ /** Who asked for silence, in the order they asked. */
184
+ readonly suspendedBy: readonly string[];
185
+ readonly master: AudioBusSnapshot;
186
+ readonly buses: readonly AudioBusSnapshot[];
187
+ readonly voices: number;
188
+ readonly sounds: number;
189
+ readonly decodedBytes: number;
190
+ /** The id of the voice that is the music. */
191
+ readonly music: number | undefined;
192
+ /** Voices started since the mixer was made, and those that were over before they sounded or gave their place. */
193
+ readonly started: number;
194
+ readonly dropped: {
195
+ readonly silent: number;
196
+ readonly limit: number;
197
+ readonly stolen: number;
198
+ };
199
+ }
200
+ export interface AudioMixer {
201
+ readonly state: AudioMixerState;
202
+ readonly master: AudioBus;
203
+ readonly buses: readonly AudioBus[];
204
+ /** The music now, while it is not being stopped. */
205
+ readonly music: AudioVoice | undefined;
206
+ bus(name: string): AudioBus;
207
+ /** Decodes one encoded file. The bytes stay the caller's. */
208
+ decode(bytes: Uint8Array | ArrayBuffer): Promise<AudioSound>;
209
+ /**
210
+ * Opens a file to be played as it is read, without its samples in memory: for long music.
211
+ * A host that cannot do this refuses.
212
+ */
213
+ stream(url: string): Promise<AudioSound>;
214
+ play(sound: AudioSound, options?: AudioPlayOptions): AudioVoice;
215
+ /** One music at a time: the one before it is stopped over the same fade. */
216
+ playMusic(sound: AudioSound, options?: AudioMusicOptions): AudioVoice;
217
+ stopMusic(options?: AudioFade): void;
218
+ /** Stops every voice, or every voice of one bus. */
219
+ stopAll(options?: AudioFade & {
220
+ readonly bus?: string;
221
+ }): void;
222
+ /** Asks for silence under a name. Every name that asked has to let go before sound returns. */
223
+ suspend(reason?: string): void;
224
+ resume(reason?: string): void;
225
+ /** For the host: whether it lets the output start. */
226
+ setLocked(locked: boolean): void;
227
+ /** Told the new state each time it changes. */
228
+ subscribe(listener: (state: AudioMixerState) => void): () => void;
229
+ snapshot(): AudioMixerSnapshot;
230
+ /** Ends every voice, releases every sound and closes the backend. A scope can own the mixer through this. */
231
+ dispose(): void;
232
+ }
233
+ //# sourceMappingURL=audioTypes.d.ts.map
@@ -0,0 +1,3 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ export {};
3
+ //# sourceMappingURL=audioTypes.js.map
@@ -0,0 +1,24 @@
1
+ import { Scope } from '@egret/runtime';
2
+ import type { AssetLease, Bitmap, CapturedSharedContent2D, EngineContext, Stage, Texture } from '@egret/runtime';
3
+ /** Publishes borrowed group members once; owns no initial or candidate lease. */
4
+ export interface BitmapBindingTicket {
5
+ prepare(members: readonly AssetLease<Texture>[]): void;
6
+ commit(): void;
7
+ dispose(): void;
8
+ }
9
+ type Operations = Parameters<NonNullable<EngineContext['registerBitmapResourceTarget']>>[1];
10
+ export interface BitmapBindingContext {
11
+ assertOpen(): void;
12
+ isEngineScope(scope: unknown): scope is Scope;
13
+ }
14
+ export interface BitmapBindingOwner {
15
+ capture(scope: unknown, targets: unknown): BitmapBindingTicket;
16
+ readPreparedForCapture(ticket: unknown): Readonly<{
17
+ validate(): void;
18
+ captureContent(stage: Stage): CapturedSharedContent2D;
19
+ }>;
20
+ close(): void;
21
+ }
22
+ export declare function createBitmapBindingOwner(context: BitmapBindingContext, targets: WeakMap<Bitmap, Operations>): BitmapBindingOwner;
23
+ export {};
24
+ //# sourceMappingURL=bitmapBindingTicket.d.ts.map
@@ -0,0 +1,215 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError, Scope } from '@egret/runtime';
3
+ const APPLY = Reflect.apply, FREEZE = Object.freeze, IS_ARRAY = Array.isArray;
4
+ const HAS_OWN = Object.prototype.hasOwnProperty;
5
+ const SCOPE_STATE = Object.getOwnPropertyDescriptor(Scope.prototype, 'state').get;
6
+ const SCOPE_USE = Scope.prototype.use;
7
+ function assertLifetime(context, scope) {
8
+ context.assertOpen();
9
+ if (!context.isEngineScope(scope))
10
+ throw new EgretError('BITMAP_BINDING_SCOPE_INVALID');
11
+ if (APPLY(SCOPE_STATE, scope, []) !== 'open')
12
+ throw new EgretError('SCOPE_CLOSED');
13
+ }
14
+ function assertAvailable(record) {
15
+ assertLifetime(record.context, record.scope);
16
+ if (record.phase === 'terminal') {
17
+ throw new EgretError(record.conflict ? 'BITMAP_RESOURCE_BINDING_CHANGED' : 'BITMAP_BINDING_DISPOSED');
18
+ }
19
+ }
20
+ function assertOperation(record, phase) {
21
+ assertAvailable(record);
22
+ if (record.reading)
23
+ throw new EgretError('BITMAP_BINDING_REENTRANT');
24
+ if (record.phase !== phase)
25
+ throw new EgretError('BITMAP_BINDING_STATE_INVALID');
26
+ }
27
+ /** This pass revokes authority only; clearing is a separate callback-free pass. */
28
+ function markTerminal(record, conflict = false) {
29
+ record.conflict = record.conflict || conflict;
30
+ record.phase = 'terminal';
31
+ record.captured = undefined;
32
+ record.prepared = undefined;
33
+ record.inventory.delete(record);
34
+ }
35
+ function clearPublication(record) {
36
+ const publication = record.publication;
37
+ record.publication = undefined;
38
+ if (publication !== undefined)
39
+ record.operations.clearBatchIfCurrent(publication);
40
+ }
41
+ function dispose(record) {
42
+ markTerminal(record);
43
+ clearPublication(record);
44
+ }
45
+ function observeRefusal(record, cause) {
46
+ if (cause instanceof EgretError && cause.code === 'BITMAP_RESOURCE_BINDING_CHANGED')
47
+ markTerminal(record, true);
48
+ else if (cause instanceof EgretError && cause.code === 'OBJECT_DISPOSED')
49
+ markTerminal(record);
50
+ }
51
+ /** Revalidate even thrown undefined before selecting a caller-read error. */
52
+ function callerRead(read, code, revalidate) {
53
+ let value, failed = false;
54
+ let cause;
55
+ try {
56
+ value = read();
57
+ }
58
+ catch (failure) {
59
+ failed = true;
60
+ cause = failure;
61
+ }
62
+ revalidate();
63
+ if (failed)
64
+ throw new EgretError(code, { cause });
65
+ return value;
66
+ }
67
+ function snapshotArray(input, code, expected, revalidate) {
68
+ if (!callerRead(() => IS_ARRAY(input), code, revalidate))
69
+ throw new EgretError(code);
70
+ const array = input;
71
+ const length = callerRead(() => array.length, code, revalidate);
72
+ if (!Number.isInteger(length) || length < 1 || length > 128 || (expected !== undefined && length !== expected))
73
+ throw new EgretError(code);
74
+ const snapshot = [];
75
+ for (let index = 0; index < length; index++) {
76
+ if (!callerRead(() => APPLY(HAS_OWN, array, [index]), code, revalidate))
77
+ throw new EgretError(code);
78
+ snapshot.push(callerRead(() => array[index], code, revalidate));
79
+ }
80
+ return FREEZE(snapshot);
81
+ }
82
+ function prepare(record, members) {
83
+ assertOperation(record, 'captured');
84
+ let snapshot;
85
+ record.reading = true;
86
+ try {
87
+ snapshot = snapshotArray(members, 'BITMAP_BINDING_MEMBERS_INVALID', record.count, () => assertAvailable(record));
88
+ }
89
+ finally {
90
+ record.reading = false;
91
+ }
92
+ try {
93
+ const prepared = record.operations.prepareBatch(record.captured, snapshot);
94
+ record.prepared = prepared;
95
+ record.phase = 'prepared';
96
+ }
97
+ catch (cause) {
98
+ observeRefusal(record, cause);
99
+ throw cause;
100
+ }
101
+ }
102
+ function commit(record) {
103
+ assertOperation(record, 'prepared');
104
+ try {
105
+ const publication = record.operations.commitBatch(record.captured, record.prepared);
106
+ // Runtime returns an already allocated publication; these writes call nobody.
107
+ record.publication = publication;
108
+ record.prepared = undefined;
109
+ record.captured = undefined;
110
+ record.phase = 'committed';
111
+ }
112
+ catch (cause) {
113
+ observeRefusal(record, cause);
114
+ throw cause;
115
+ }
116
+ }
117
+ function handleFor(record, handles) {
118
+ const receiver = (value) => {
119
+ if (value !== handle)
120
+ throw new EgretError('BITMAP_BINDING_INVALID');
121
+ };
122
+ const handle = FREEZE({
123
+ prepare(members) {
124
+ receiver(this);
125
+ prepare(record, members);
126
+ },
127
+ commit() {
128
+ receiver(this);
129
+ commit(record);
130
+ },
131
+ dispose() {
132
+ receiver(this);
133
+ dispose(record);
134
+ }
135
+ });
136
+ handles.set(handle, record);
137
+ return handle;
138
+ }
139
+ export function createBitmapBindingOwner(context, targets) {
140
+ const inventory = new Set();
141
+ // Exact handles point back to the sole existing record, including terminal records.
142
+ const handles = new WeakMap();
143
+ return FREEZE({
144
+ capture(scope, input) {
145
+ assertLifetime(context, scope);
146
+ const snapshot = snapshotArray(input, 'BITMAP_BINDING_TARGETS_INVALID', undefined, () => assertLifetime(context, scope));
147
+ const seen = new Set();
148
+ let operations;
149
+ // All caller reads finished before authenticating final current targets.
150
+ for (const target of snapshot) {
151
+ const current = targets.get(target);
152
+ if (current === undefined || seen.has(target) || (operations !== undefined && operations !== current)) {
153
+ throw new EgretError('BITMAP_BINDING_TARGETS_INVALID');
154
+ }
155
+ seen.add(target);
156
+ operations = current;
157
+ }
158
+ const captured = operations.captureBatch(snapshot);
159
+ const record = {
160
+ context,
161
+ scope,
162
+ operations: operations,
163
+ inventory,
164
+ phase: 'captured',
165
+ conflict: false,
166
+ reading: false,
167
+ captured,
168
+ prepared: undefined,
169
+ publication: undefined,
170
+ count: snapshot.length
171
+ };
172
+ const handle = handleFor(record, handles);
173
+ inventory.add(record);
174
+ try {
175
+ APPLY(SCOPE_USE, scope, [handle]);
176
+ }
177
+ catch (cause) {
178
+ dispose(record);
179
+ throw cause;
180
+ }
181
+ return handle;
182
+ },
183
+ readPreparedForCapture(ticket) {
184
+ context.assertOpen();
185
+ const record = handles.get(ticket);
186
+ if (record === undefined)
187
+ throw new EgretError('BITMAP_BINDING_INVALID');
188
+ assertOperation(record, 'prepared');
189
+ return FREEZE({
190
+ validate() {
191
+ assertOperation(record, 'prepared');
192
+ },
193
+ captureContent(stage) {
194
+ assertOperation(record, 'prepared');
195
+ try {
196
+ return record.operations.capturePreparedSharedContent(stage, record.captured, record.prepared);
197
+ }
198
+ catch (cause) {
199
+ observeRefusal(record, cause);
200
+ throw cause;
201
+ }
202
+ }
203
+ });
204
+ },
205
+ close() {
206
+ const records = [...inventory];
207
+ // Every ticket is terminal before any matching publication is cleared.
208
+ for (const record of records)
209
+ markTerminal(record);
210
+ for (const record of records)
211
+ clearPublication(record);
212
+ }
213
+ });
214
+ }
215
+ //# sourceMappingURL=bitmapBindingTicket.js.map
@@ -0,0 +1,4 @@
1
+ import type { BitmapButton, BitmapButtonOptions } from './bitmapButtonTypes.js';
2
+ /** Share a genuine input; own only the new private sheet, Bitmap and facade. */
3
+ export declare function createBitmapButton(options: BitmapButtonOptions): BitmapButton;
4
+ //# sourceMappingURL=bitmapButton.d.ts.map