@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,161 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const coordinators = new WeakMap();
4
+ const captures = new WeakSet();
5
+ const deliveries = new WeakMap();
6
+ /** User getters cannot masquerade as an ordinary callback command boundary. */
7
+ export function assertNotCapturing(port) {
8
+ if (captures.has(port))
9
+ throw new EgretError('ANIMATION_REENTRANT');
10
+ }
11
+ export function captureInput(port, callback) {
12
+ assertNotCapturing(port);
13
+ captures.add(port);
14
+ try {
15
+ return callback();
16
+ }
17
+ finally {
18
+ captures.delete(port);
19
+ }
20
+ }
21
+ export function mustQueue(port) {
22
+ return port.isClockBusy() || (deliveries.get(port) ?? 0) > 0;
23
+ }
24
+ export function protectedDelivery(port, callback) {
25
+ const old = deliveries.get(port) ?? 0;
26
+ deliveries.set(port, old + 1);
27
+ try {
28
+ return callback();
29
+ }
30
+ finally {
31
+ if (old === 0)
32
+ deliveries.delete(port);
33
+ else
34
+ deliveries.set(port, old);
35
+ }
36
+ }
37
+ export function deliver(port, delivery) {
38
+ if (delivery === undefined)
39
+ return;
40
+ protectedDelivery(port, () => {
41
+ delivery.events();
42
+ delivery.diagnostics();
43
+ });
44
+ }
45
+ export function coordinatorSize(port) {
46
+ return coordinators.get(port)?.size ?? 0;
47
+ }
48
+ /** One authentic subscription serves all live controllers, never the first caller's Scope. */
49
+ export function requireCoordinator(port) {
50
+ const existing = coordinators.get(port);
51
+ if (existing !== undefined)
52
+ return existing;
53
+ const drivers = new Set();
54
+ let scope;
55
+ let subscription;
56
+ let removeClose;
57
+ let closed = false;
58
+ let lastTick = port.clock.tickId;
59
+ function release() {
60
+ if (closed)
61
+ return;
62
+ closed = true;
63
+ if (coordinators.get(port) === coordinator)
64
+ coordinators.delete(port);
65
+ const unsub = subscription, owned = scope, unregister = removeClose;
66
+ subscription = undefined;
67
+ scope = undefined;
68
+ removeClose = undefined;
69
+ let first;
70
+ let failed = false;
71
+ for (const cleanup of [
72
+ () => {
73
+ unregister?.();
74
+ },
75
+ () => {
76
+ unsub?.dispose();
77
+ },
78
+ () => {
79
+ owned?.dispose();
80
+ }
81
+ ]) {
82
+ try {
83
+ cleanup();
84
+ }
85
+ catch (cause) {
86
+ if (!failed) {
87
+ first = cause;
88
+ failed = true;
89
+ }
90
+ port.captureCleanup(cause);
91
+ }
92
+ }
93
+ if (failed)
94
+ throw first;
95
+ }
96
+ function tick(value) {
97
+ if (closed)
98
+ return undefined;
99
+ if (value.tickId <= lastTick)
100
+ throw new EgretError('ANIMATION_TICK_INVALID');
101
+ lastTick = value.tickId;
102
+ const batches = [];
103
+ // Snapshot controller identity; newly created controllers start on a later turn.
104
+ for (const driver of [...drivers]) {
105
+ if (!drivers.has(driver))
106
+ continue;
107
+ const batch = driver.advance(value);
108
+ if (batch !== undefined)
109
+ batches.push(batch);
110
+ }
111
+ protectedDelivery(port, () => {
112
+ for (const batch of batches)
113
+ batch.events();
114
+ for (const batch of batches)
115
+ batch.diagnostics();
116
+ });
117
+ return undefined;
118
+ }
119
+ const coordinator = Object.freeze({
120
+ get size() {
121
+ return drivers.size;
122
+ },
123
+ add(driver) {
124
+ if (closed)
125
+ throw new EgretError('ANIMATION_COORDINATOR_CLOSED');
126
+ if (drivers.size >= 256)
127
+ throw new EgretError('ANIMATION_CONTROLLER_LIMIT');
128
+ drivers.add(driver);
129
+ },
130
+ remove(driver) {
131
+ drivers.delete(driver);
132
+ if (drivers.size === 0)
133
+ release();
134
+ },
135
+ discardIfEmpty() {
136
+ if (drivers.size === 0)
137
+ release();
138
+ }
139
+ });
140
+ try {
141
+ scope = port.createScope();
142
+ subscription = port.clock.onTick(scope.scope, tick);
143
+ removeClose = port.onClose(() => {
144
+ for (const driver of [...drivers])
145
+ driver.stop();
146
+ release();
147
+ });
148
+ coordinators.set(port, coordinator);
149
+ return coordinator;
150
+ }
151
+ catch (cause) {
152
+ try {
153
+ release();
154
+ }
155
+ catch (cleanupCause) {
156
+ port.captureCleanup(cleanupCause);
157
+ }
158
+ throw cause;
159
+ }
160
+ }
161
+ //# sourceMappingURL=sequenceCoordinator.js.map
@@ -0,0 +1,25 @@
1
+ import type { CapturedSequenceMarker } from './sequenceMath.js';
2
+ import type { SequenceControllerEvent } from './types.js';
3
+ export interface CapturedOptions {
4
+ readonly rate: number;
5
+ readonly totalPlays: number | 'infinite';
6
+ readonly markers: readonly CapturedSequenceMarker[];
7
+ readonly listener: ((event: SequenceControllerEvent) => undefined) | undefined;
8
+ }
9
+ export type Command = Readonly<{
10
+ kind: 'start' | 'pause' | 'resume';
11
+ }> | Readonly<{
12
+ kind: 'rate';
13
+ rate: number;
14
+ }> | Readonly<{
15
+ kind: 'seek';
16
+ time: number;
17
+ replay: boolean;
18
+ }>;
19
+ export declare function admitRate(value: unknown): number;
20
+ /** Copy only bounded scalar descriptors, including one array-length observation. */
21
+ export declare function captureOptions(value: unknown, duration: number, durationKnown?: boolean): CapturedOptions;
22
+ export declare function captureSeek(value: unknown): Command & {
23
+ kind: 'seek';
24
+ };
25
+ //# sourceMappingURL=sequenceInput.d.ts.map
@@ -0,0 +1,108 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ /** Wrap only caller operations, so a deliberately thrown EgretError remains the cause. */
4
+ function external(code, read) {
5
+ try {
6
+ return read();
7
+ }
8
+ catch (cause) {
9
+ if (cause instanceof EgretError && cause.code === 'ANIMATION_REENTRANT')
10
+ throw cause;
11
+ throw new EgretError(code, { cause });
12
+ }
13
+ }
14
+ function fields(value, allowed, code) {
15
+ if (value === null || typeof value !== 'object')
16
+ throw new EgretError(code);
17
+ if (external(code, () => Array.isArray(value)))
18
+ throw new EgretError(code);
19
+ for (const key of external(code, () => Reflect.ownKeys(value))) {
20
+ if (typeof key !== 'string' || !allowed.includes(key))
21
+ throw new EgretError(code);
22
+ }
23
+ return value;
24
+ }
25
+ function own(input, key, code) {
26
+ return external(code, () => (Object.hasOwn(input, key) ? input[key] : undefined));
27
+ }
28
+ export function admitRate(value) {
29
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < 0 || value > 16)
30
+ throw new EgretError('ANIMATION_RATE_INVALID');
31
+ return value === 0 ? 0 : value;
32
+ }
33
+ /** Copy only bounded scalar descriptors, including one array-length observation. */
34
+ export function captureOptions(value, duration, durationKnown = true) {
35
+ const code = 'ANIMATION_OPTIONS_INVALID';
36
+ const input = fields(value, ['profile', 'rate', 'totalPlays', 'markers', 'onEvent'], code);
37
+ const profile = own(input, 'profile', code), rawRate = own(input, 'rate', code);
38
+ const rawPlays = own(input, 'totalPlays', code), rawMarkers = own(input, 'markers', code);
39
+ const listener = own(input, 'onEvent', code);
40
+ if (profile !== 'egret.sequence-control/1')
41
+ throw new EgretError(code);
42
+ let rate;
43
+ try {
44
+ rate = admitRate(rawRate === undefined ? 1 : rawRate);
45
+ }
46
+ catch {
47
+ throw new EgretError(code);
48
+ }
49
+ const totalPlays = rawPlays === undefined ? 1 : rawPlays;
50
+ if (totalPlays !== 'infinite' &&
51
+ (typeof totalPlays !== 'number' || !Number.isInteger(totalPlays) || totalPlays < 1 || totalPlays > 1_000_000))
52
+ throw new EgretError(code);
53
+ if (typeof duration !== 'number' ||
54
+ duration <= 0 ||
55
+ !Number.isFinite(duration) ||
56
+ duration > 2 ** 32 ||
57
+ (durationKnown &&
58
+ totalPlays !== 'infinite' &&
59
+ (!Number.isFinite(duration * totalPlays) || duration * totalPlays <= 0 || duration * totalPlays > 2 ** 32)))
60
+ throw new EgretError('ANIMATION_TIME_LIMIT');
61
+ if (listener !== undefined && typeof listener !== 'function')
62
+ throw new EgretError(code);
63
+ const markers = [], ids = new Set();
64
+ if (rawMarkers !== undefined) {
65
+ if (!external(code, () => Array.isArray(rawMarkers)))
66
+ throw new EgretError(code);
67
+ const array = rawMarkers;
68
+ const length = external(code, () => array.length);
69
+ if (typeof length !== 'number' || !Number.isInteger(length) || length < 0 || length > 64)
70
+ throw new EgretError(code);
71
+ for (let index = 0; index < length; index++) {
72
+ if (!external(code, () => Object.hasOwn(array, index)))
73
+ throw new EgretError(code);
74
+ const marker = fields(external(code, () => array[index]), ['id', 'timeSeconds'], code);
75
+ const id = own(marker, 'id', code), time = own(marker, 'timeSeconds', code);
76
+ if (typeof id !== 'string' ||
77
+ !/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/.test(id) ||
78
+ ids.has(id) ||
79
+ typeof time !== 'number' ||
80
+ !Number.isFinite(time) ||
81
+ time < 0 ||
82
+ time > 2 ** 32 ||
83
+ (durationKnown && time > duration))
84
+ throw new EgretError(code);
85
+ ids.add(id);
86
+ markers.push(Object.freeze({ id, timeSeconds: time === 0 ? 0 : time, markerIndex: index }));
87
+ }
88
+ }
89
+ markers.sort((a, b) => a.timeSeconds - b.timeSeconds || a.markerIndex - b.markerIndex);
90
+ return Object.freeze({
91
+ rate,
92
+ totalPlays,
93
+ markers: Object.freeze(markers),
94
+ listener: listener
95
+ });
96
+ }
97
+ export function captureSeek(value) {
98
+ const code = 'ANIMATION_SEEK_INVALID';
99
+ const input = fields(value, ['timeSeconds', 'replayEvents'], code);
100
+ const time = own(input, 'timeSeconds', code), replay = own(input, 'replayEvents', code);
101
+ if (typeof time !== 'number' ||
102
+ !Number.isFinite(time) ||
103
+ time < 0 ||
104
+ (replay !== undefined && typeof replay !== 'boolean'))
105
+ throw new EgretError(code);
106
+ return Object.freeze({ kind: 'seek', time: time === 0 ? 0 : time, replay: replay ?? false });
107
+ }
108
+ //# sourceMappingURL=sequenceInput.js.map
@@ -0,0 +1,35 @@
1
+ export type CapturedSequenceMarker = Readonly<{
2
+ id: string;
3
+ timeSeconds: number;
4
+ markerIndex: number;
5
+ }>;
6
+ export type SequencePosition = Readonly<{
7
+ playIndex: number;
8
+ positionSeconds: number;
9
+ complete: boolean;
10
+ }>;
11
+ export type PlannedSequenceEvent = Readonly<{
12
+ kind: 'marker';
13
+ id: string;
14
+ markerIndex: number;
15
+ playIndex: number;
16
+ timelineSeconds: number;
17
+ positionSeconds: number;
18
+ }> | Readonly<{
19
+ kind: 'complete';
20
+ totalPlays: number;
21
+ timelineSeconds: number;
22
+ }>;
23
+ export interface SequenceEventPlanOptions {
24
+ readonly includeStart?: boolean;
25
+ readonly includeComplete?: boolean;
26
+ }
27
+ /** Locate one admitted position without dividing by a possibly subnormal duration. */
28
+ export declare function locatePosition(duration: number, totalPlays: number | 'infinite', time: number): SequencePosition;
29
+ /**
30
+ * Plan a copied marker list's interval without writing a target or an event history.
31
+ * Scalar bounds are checked here; locatePosition owns the candidate's local-position
32
+ * search. Count every occurrence before expanding any event, including without a listener.
33
+ */
34
+ export declare function planEvents(duration: number, totalPlays: number | 'infinite', markers: readonly CapturedSequenceMarker[], oldElapsed: number, newElapsed: number, options: SequenceEventPlanOptions, remainingBudget: number): readonly PlannedSequenceEvent[];
35
+ //# sourceMappingURL=sequenceMath.d.ts.map
@@ -0,0 +1,164 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const MAX_TIME = 2 ** 32;
4
+ const MAX_PLAYS = 1_000_000;
5
+ const MAX_MARKERS = 64;
6
+ const MAX_EVENTS = 1_024;
7
+ const EMPTY_EVENTS = Object.freeze([]);
8
+ function boundsFor(duration, totalPlays) {
9
+ if (!Number.isFinite(duration) || duration <= 0 || duration > MAX_TIME) {
10
+ throw new EgretError('ANIMATION_TIME_LIMIT');
11
+ }
12
+ const finite = totalPlays !== 'infinite';
13
+ const plays = finite ? totalPlays : MAX_PLAYS;
14
+ if (!Number.isInteger(plays) || plays < 1 || plays > MAX_PLAYS) {
15
+ throw new EgretError('ANIMATION_TIME_LIMIT');
16
+ }
17
+ const endpoint = plays * duration;
18
+ if (!Number.isFinite(endpoint) || endpoint <= 0 || (finite && endpoint > MAX_TIME)) {
19
+ throw new EgretError('ANIMATION_TIME_LIMIT');
20
+ }
21
+ return { plays, endpoint, finite };
22
+ }
23
+ function assertTime(time, bounds) {
24
+ if (!Number.isFinite(time) ||
25
+ time < 0 ||
26
+ time > MAX_TIME ||
27
+ (bounds.finite ? time > bounds.endpoint : time >= bounds.endpoint)) {
28
+ throw new EgretError('ANIMATION_TIME_LIMIT');
29
+ }
30
+ }
31
+ /** B(k) is the shared binary64 authority for sampling and marker boundaries. */
32
+ function boundary(duration, index) {
33
+ return index === 0 ? 0 : index * duration;
34
+ }
35
+ /** Locate one admitted position without dividing by a possibly subnormal duration. */
36
+ export function locatePosition(duration, totalPlays, time) {
37
+ const bounds = boundsFor(duration, totalPlays);
38
+ assertTime(time, bounds);
39
+ if (bounds.finite && time === bounds.endpoint) {
40
+ return Object.freeze({
41
+ playIndex: bounds.plays - 1,
42
+ positionSeconds: duration,
43
+ complete: true
44
+ });
45
+ }
46
+ // The sentinel is strictly beyond time; at most 20 bisections select its play.
47
+ let low = 0;
48
+ let high = bounds.plays;
49
+ while (high - low > 1) {
50
+ const middle = Math.floor((low + high) / 2);
51
+ if (boundary(duration, middle) <= time)
52
+ low = middle;
53
+ else
54
+ high = middle;
55
+ }
56
+ const start = boundary(duration, low);
57
+ const end = boundary(duration, low + 1);
58
+ if (!(start < end))
59
+ throw new EgretError('ANIMATION_PRECISION_LIMIT');
60
+ const positionSeconds = time === start ? 0 : time - start;
61
+ if (time !== start && !(positionSeconds > 0 && positionSeconds < duration)) {
62
+ throw new EgretError('ANIMATION_PRECISION_LIMIT');
63
+ }
64
+ return Object.freeze({ playIndex: low, positionSeconds, complete: false });
65
+ }
66
+ function occurrence(duration, markerTime, playIndex) {
67
+ if (markerTime === 0)
68
+ return boundary(duration, playIndex);
69
+ if (markerTime === duration)
70
+ return boundary(duration, playIndex + 1);
71
+ return boundary(duration, playIndex) + markerTime;
72
+ }
73
+ /** Return the first actual play whose occurrence is strictly after time. */
74
+ function occurrenceUpperBound(duration, markerTime, plays, time) {
75
+ let low = 0;
76
+ let high = plays;
77
+ while (low < high) {
78
+ const middle = Math.floor((low + high) / 2);
79
+ if (occurrence(duration, markerTime, middle) <= time)
80
+ low = middle + 1;
81
+ else
82
+ high = middle;
83
+ }
84
+ return low;
85
+ }
86
+ /**
87
+ * Plan a copied marker list's interval without writing a target or an event history.
88
+ * Scalar bounds are checked here; locatePosition owns the candidate's local-position
89
+ * search. Count every occurrence before expanding any event, including without a listener.
90
+ */
91
+ export function planEvents(duration, totalPlays, markers, oldElapsed, newElapsed, options, remainingBudget) {
92
+ const bounds = boundsFor(duration, totalPlays);
93
+ assertTime(oldElapsed, bounds);
94
+ assertTime(newElapsed, bounds);
95
+ if (newElapsed < oldElapsed)
96
+ throw new EgretError('ANIMATION_TIME_LIMIT');
97
+ if (!Number.isInteger(remainingBudget) || remainingBudget < 0 || remainingBudget > MAX_EVENTS) {
98
+ throw new EgretError('ANIMATION_EVENT_LIMIT');
99
+ }
100
+ const markerCount = markers.length;
101
+ if (markerCount > MAX_MARKERS)
102
+ throw new EgretError('ANIMATION_EVENT_LIMIT');
103
+ const includeStart = options.includeStart === true && oldElapsed === 0;
104
+ const includeComplete = options.includeComplete === true && bounds.finite && newElapsed === bounds.endpoint && newElapsed > oldElapsed;
105
+ let eventCount = includeComplete ? 1 : 0;
106
+ if (eventCount > remainingBudget)
107
+ throw new EgretError('ANIMATION_EVENT_LIMIT');
108
+ const ranges = [];
109
+ for (let index = 0; index < markerCount; index += 1) {
110
+ const marker = markers[index];
111
+ const markerTime = marker.timeSeconds;
112
+ if (!Number.isFinite(markerTime) || markerTime < 0 || markerTime > duration) {
113
+ throw new EgretError('ANIMATION_TIME_LIMIT');
114
+ }
115
+ const first = includeStart && markerTime === 0 ? 0 : occurrenceUpperBound(duration, markerTime, bounds.plays, oldElapsed);
116
+ const afterLast = occurrenceUpperBound(duration, markerTime, bounds.plays, newElapsed);
117
+ eventCount += afterLast - first;
118
+ if (eventCount > remainingBudget)
119
+ throw new EgretError('ANIMATION_EVENT_LIMIT');
120
+ if (afterLast > first)
121
+ ranges.push({ marker, first, afterLast });
122
+ }
123
+ if (eventCount === 0)
124
+ return EMPTY_EVENTS;
125
+ const events = [];
126
+ for (const range of ranges) {
127
+ const marker = range.marker;
128
+ for (let playIndex = range.first; playIndex < range.afterLast; playIndex += 1) {
129
+ const start = boundary(duration, playIndex);
130
+ const end = boundary(duration, playIndex + 1);
131
+ const timelineSeconds = occurrence(duration, marker.timeSeconds, playIndex);
132
+ if (!(start < end) ||
133
+ (marker.timeSeconds !== 0 &&
134
+ marker.timeSeconds !== duration &&
135
+ !(timelineSeconds > start && timelineSeconds < end))) {
136
+ throw new EgretError('ANIMATION_PRECISION_LIMIT');
137
+ }
138
+ events.push(Object.freeze({
139
+ kind: 'marker',
140
+ id: marker.id,
141
+ markerIndex: marker.markerIndex,
142
+ playIndex,
143
+ timelineSeconds,
144
+ positionSeconds: marker.timeSeconds === 0 ? 0 : marker.timeSeconds
145
+ }));
146
+ }
147
+ }
148
+ // End-of-play markers precede the next play's zero markers at the same B(k).
149
+ // Rounded interior ties retain authored time order, then original input order.
150
+ events.sort((left, right) => left.timelineSeconds - right.timelineSeconds ||
151
+ left.playIndex - right.playIndex ||
152
+ left.positionSeconds - right.positionSeconds ||
153
+ left.markerIndex - right.markerIndex);
154
+ const result = events;
155
+ if (includeComplete) {
156
+ result.push(Object.freeze({
157
+ kind: 'complete',
158
+ totalPlays: bounds.plays,
159
+ timelineSeconds: bounds.endpoint
160
+ }));
161
+ }
162
+ return Object.freeze(result);
163
+ }
164
+ //# sourceMappingURL=sequenceMath.js.map
@@ -0,0 +1,7 @@
1
+ import { DisplayObjectContainer } from '@egret/runtime';
2
+ import type { Scope } from '@egret/runtime';
3
+ import { Engine } from '../Engine.js';
4
+ import type { SequenceResetInitial, SequenceResetSlot } from './sequenceResetTypes.js';
5
+ /** One ordinary sole-child container; all candidates use existing content and clock ownership. */
6
+ export declare function createSequenceResetSlot(engine: Engine, scope: Scope, target: DisplayObjectContainer, initial: SequenceResetInitial): SequenceResetSlot;
7
+ //# sourceMappingURL=sequenceResetSlot.d.ts.map