@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,536 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Physics on another thread. The world lives behind a message port - in a worker,
3
+ // say - and the page keeps light stand-ins for its bodies: it sends what it wants
4
+ // done, asks for a step, and receives where everything is. Nothing here names a
5
+ // worker or the DOM; both ends only need something that can post and receive
6
+ // messages, so the same code runs over a Worker, a MessagePort or a test loopback.
7
+ import { World3DError, requireFinite3D } from './core3D.js';
8
+ import { createConvexHullShape3D } from './PhysicsHull3D.js';
9
+ import { PhysicsWorld3D } from './Physics3D.js';
10
+ const ownsBody = Symbol('remote physics body ownership');
11
+ const triple = (value, field) => {
12
+ const list = value;
13
+ if (!list || list.length !== 3)
14
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
15
+ return [requireFinite3D(list[0], field), requireFinite3D(list[1], field), requireFinite3D(list[2], field)];
16
+ };
17
+ function localShape(shape) {
18
+ if (shape?.type === 'convex')
19
+ return { type: 'convex', hull: createConvexHullShape3D(shape.points) };
20
+ if (shape?.type === 'compound')
21
+ return {
22
+ type: 'compound',
23
+ children: shape.children.map(child => ({ ...child, shape: localShape(child.shape) }))
24
+ };
25
+ return shape;
26
+ }
27
+ /**
28
+ * Run a physics world on this end of a port and answer the messages of a
29
+ * PhysicsClient3D. In a worker this is the whole script:
30
+ * import {servePhysics3D} from '@egret/engine/world3d';
31
+ * servePhysics3D(self);
32
+ * Returns the world, for a host that wants to add to it directly.
33
+ */
34
+ export function servePhysics3D(port, options = {}) {
35
+ if (!port || typeof port.postMessage !== 'function')
36
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'port');
37
+ const world = new PhysicsWorld3D(options);
38
+ const bodies = new Map(), ids = new Map(), joints = new Map();
39
+ let began = [], ended = [], startup = true;
40
+ world.onContactBegin = (a, b) => {
41
+ const x = ids.get(a), y = ids.get(b);
42
+ if (x !== undefined && y !== undefined)
43
+ began.push(x, y);
44
+ };
45
+ world.onContactEnd = (a, b) => {
46
+ const x = ids.get(a), y = ids.get(b);
47
+ if (x !== undefined && y !== undefined)
48
+ ended.push(x, y);
49
+ };
50
+ const body = (id) => {
51
+ const found = bodies.get(id);
52
+ if (!found)
53
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'unknown body ' + String(id));
54
+ return found;
55
+ };
56
+ const handle = (m) => {
57
+ if (m.t === 'world') {
58
+ if (!startup)
59
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'world options are only accepted at startup');
60
+ const requested = m['options'];
61
+ if (!requested ||
62
+ typeof requested !== 'object' ||
63
+ (requested.allowSleep !== undefined && typeof requested.allowSleep !== 'boolean')) {
64
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'world options');
65
+ }
66
+ const gravity = requested.gravity === undefined ? undefined : triple(requested.gravity, 'gravity');
67
+ // Validate the configuration as a unit and keep the host's world and objects in place.
68
+ const config = new PhysicsWorld3D(requested);
69
+ if (!Number.isFinite(config.maxSubSteps) ||
70
+ !Number.isFinite(config.iterations) ||
71
+ !Number.isFinite(config.solverSteps)) {
72
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'world solver options');
73
+ }
74
+ if (requested.fixedStep !== undefined)
75
+ world.fixedStep = config.fixedStep;
76
+ if (requested.maxSubSteps !== undefined)
77
+ world.maxSubSteps = config.maxSubSteps;
78
+ if (requested.iterations !== undefined)
79
+ world.iterations = config.iterations;
80
+ if (requested.solverSteps !== undefined)
81
+ world.solverSteps = config.solverSteps;
82
+ if (requested.allowSleep !== undefined)
83
+ world.allowSleep = config.allowSleep;
84
+ if (gravity) {
85
+ world.gravity.set(gravity);
86
+ for (const one of world.bodies)
87
+ one.wake();
88
+ }
89
+ startup = false;
90
+ return;
91
+ }
92
+ startup = false;
93
+ switch (m.t) {
94
+ case 'body': {
95
+ const o = m['options'], made = world.createBody({ ...o, shape: localShape(o.shape) });
96
+ bodies.set(m['id'], made);
97
+ ids.set(made, m['id']);
98
+ break;
99
+ }
100
+ case 'remove': {
101
+ const found = bodies.get(m['id']);
102
+ if (found) {
103
+ world.removeBody(found);
104
+ bodies.delete(m['id']);
105
+ ids.delete(found);
106
+ }
107
+ break;
108
+ }
109
+ case 'joint': {
110
+ const o = m['options'];
111
+ joints.set(m['id'], world.createJoint({
112
+ ...o,
113
+ bodyA: body(o['bodyA']),
114
+ ...(o['bodyB'] === undefined ? {} : { bodyB: body(o['bodyB']) })
115
+ }));
116
+ break;
117
+ }
118
+ case 'unjoint': {
119
+ const found = joints.get(m['id']);
120
+ if (found) {
121
+ world.removeJoint(found);
122
+ joints.delete(m['id']);
123
+ }
124
+ break;
125
+ }
126
+ case 'set': {
127
+ const target = body(m['id']);
128
+ if (m['position']) {
129
+ const p = triple(m['position'], 'position');
130
+ target.setPosition(p[0], p[1], p[2]);
131
+ }
132
+ if (m['quaternion']) {
133
+ const q = m['quaternion'];
134
+ target.setQuaternion(q[0], q[1], q[2], q[3]);
135
+ }
136
+ if (m['linearVelocity']) {
137
+ const v = triple(m['linearVelocity'], 'linearVelocity');
138
+ target.setLinearVelocity(v[0], v[1], v[2]);
139
+ }
140
+ if (m['angularVelocity']) {
141
+ const w = triple(m['angularVelocity'], 'angularVelocity');
142
+ target.setAngularVelocity(w[0], w[1], w[2]);
143
+ }
144
+ break;
145
+ }
146
+ case 'impulse': {
147
+ const i = triple(m['impulse'], 'impulse');
148
+ body(m['id']).applyImpulse(i[0], i[1], i[2], m['point']);
149
+ break;
150
+ }
151
+ case 'force': {
152
+ const f = triple(m['force'], 'force');
153
+ body(m['id']).applyForce(f[0], f[1], f[2]);
154
+ break;
155
+ }
156
+ // A change of gravity is felt by everything, including what had come to rest.
157
+ case 'gravity':
158
+ world.gravity.set(triple(m['value'], 'gravity'));
159
+ for (const one of bodies.values())
160
+ one.wake();
161
+ break;
162
+ case 'step': {
163
+ world.step(requireFinite3D(m['dt'], 'dt'));
164
+ // Everything that can move, in one block: an id, then position and orientation, for each body.
165
+ let count = 0;
166
+ for (const one of bodies.values())
167
+ if (one.type !== 'static')
168
+ count++;
169
+ const who = new Int32Array(count), poses = new Float32Array(count * 7), asleep = new Uint8Array(count);
170
+ let at = 0;
171
+ for (const [id, one] of bodies) {
172
+ if (one.type === 'static')
173
+ continue;
174
+ who[at] = id;
175
+ poses.set(one.position, at * 7);
176
+ poses.set(one.quaternion, at * 7 + 3);
177
+ asleep[at] = one.isSleeping ? 1 : 0;
178
+ at++;
179
+ }
180
+ const state = { t: 'state', frame: m['frame'], ids: who, poses, asleep, began, ended };
181
+ began = [];
182
+ ended = [];
183
+ port.postMessage(state, [who.buffer, poses.buffer, asleep.buffer]);
184
+ break;
185
+ }
186
+ case 'raycast': {
187
+ const hit = world.raycast(triple(m['origin'], 'origin'), triple(m['direction'], 'direction'), m['maxDistance'] ?? Infinity, m['mask'] ?? -1);
188
+ port.postMessage({
189
+ t: 'ray',
190
+ request: m['request'],
191
+ hit: hit && ids.has(hit.body)
192
+ ? { id: ids.get(hit.body), distance: hit.distance, point: hit.point, normal: hit.normal }
193
+ : null
194
+ });
195
+ break;
196
+ }
197
+ default:
198
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'unknown physics message ' + String(m.t));
199
+ }
200
+ };
201
+ port.addEventListener('message', event => {
202
+ const message = event.data;
203
+ // A request that cannot be carried out is reported back rather than left to stop the worker.
204
+ try {
205
+ handle(message);
206
+ }
207
+ catch (error) {
208
+ const text = error instanceof Error ? error.message : String(error);
209
+ if (message?.t !== 'raycast') {
210
+ port.postMessage({ t: 'error', about: message?.t, message: text });
211
+ return;
212
+ }
213
+ const invalid = error instanceof World3DError && error.code === 'WORLD3D_INPUT_INVALID';
214
+ port.postMessage({
215
+ t: 'error',
216
+ about: 'raycast',
217
+ message: text,
218
+ request: message['request'],
219
+ code: invalid ? error.code : 'WORLD3D_RESOURCE_FAILED',
220
+ detail: invalid ? error.detail : text
221
+ });
222
+ }
223
+ });
224
+ port.start?.();
225
+ return world;
226
+ }
227
+ /** The page's stand-in for a body that lives behind the port. */
228
+ export class RemoteBody3D {
229
+ id;
230
+ type;
231
+ /** Where the body was after the latest step this side has heard of. */
232
+ position = new Float32Array(3);
233
+ quaternion = new Float32Array([0, 0, 0, 1]);
234
+ /** @internal Where it was the step before, for blending between the two. */
235
+ previous = new Float32Array([0, 0, 0, 0, 0, 0, 1]);
236
+ isSleeping = false;
237
+ node;
238
+ userData;
239
+ #client;
240
+ #alive = true;
241
+ /** @internal */
242
+ constructor(client, id, options) {
243
+ this.#client = client;
244
+ this.id = id;
245
+ this.type = options.type ?? (options.shape.type === 'plane' ? 'static' : 'dynamic');
246
+ if (options.position)
247
+ this.position.set(options.position);
248
+ if (options.quaternion)
249
+ this.quaternion.set(options.quaternion);
250
+ this.previous.set(this.position);
251
+ this.previous.set(this.quaternion, 3);
252
+ this.node = options.node;
253
+ this.userData = options.userData;
254
+ }
255
+ get removed() {
256
+ return !this.#alive;
257
+ }
258
+ send(message) {
259
+ if (this.#alive && this.#client[ownsBody](this))
260
+ this.#client.post({ ...message, id: this.id });
261
+ }
262
+ /** Move the body there at once; this side shows it there straight away. */
263
+ setPosition(x, y, z) {
264
+ this.position[0] = requireFinite3D(x, 'x');
265
+ this.position[1] = requireFinite3D(y, 'y');
266
+ this.position[2] = requireFinite3D(z, 'z');
267
+ this.previous.set(this.position);
268
+ this.send({ t: 'set', position: [x, y, z] });
269
+ return this;
270
+ }
271
+ setQuaternion(x, y, z, w) {
272
+ this.quaternion[0] = x;
273
+ this.quaternion[1] = y;
274
+ this.quaternion[2] = z;
275
+ this.quaternion[3] = w;
276
+ this.previous.set(this.quaternion, 3);
277
+ this.send({ t: 'set', quaternion: [x, y, z, w] });
278
+ return this;
279
+ }
280
+ setLinearVelocity(x, y, z) {
281
+ this.send({
282
+ t: 'set',
283
+ linearVelocity: [requireFinite3D(x, 'x'), requireFinite3D(y, 'y'), requireFinite3D(z, 'z')]
284
+ });
285
+ return this;
286
+ }
287
+ setAngularVelocity(x, y, z) {
288
+ this.send({
289
+ t: 'set',
290
+ angularVelocity: [requireFinite3D(x, 'x'), requireFinite3D(y, 'y'), requireFinite3D(z, 'z')]
291
+ });
292
+ return this;
293
+ }
294
+ applyImpulse(x, y, z, point) {
295
+ this.send({ t: 'impulse', impulse: [x, y, z], ...(point ? { point: [point[0], point[1], point[2]] } : {}) });
296
+ }
297
+ /** A force for the next step only, as with a local body. */
298
+ applyForce(x, y, z) {
299
+ this.send({ t: 'force', force: [x, y, z] });
300
+ }
301
+ remove() {
302
+ if (!this.#alive)
303
+ return;
304
+ this.send({ t: 'remove' });
305
+ this.#alive = false;
306
+ this.#client.forget(this);
307
+ }
308
+ }
309
+ /** A joint of a physics world in a worker; remove it to take it out. */
310
+ export class RemoteJoint3D {
311
+ id;
312
+ #client;
313
+ #alive = true;
314
+ /** @internal */
315
+ constructor(client, id) {
316
+ this.#client = client;
317
+ this.id = id;
318
+ }
319
+ remove() {
320
+ if (this.#alive) {
321
+ this.#alive = false;
322
+ this.#client.post({ t: 'unjoint', id: this.id });
323
+ }
324
+ }
325
+ }
326
+ /**
327
+ * The page's end of a remote physics world. Create bodies and joints as with a
328
+ * local world, call step() once per frame, and update() to place the nodes.
329
+ * Positions arrive a moment after they are asked for, so what is shown trails
330
+ * the simulation by about one step; update(alpha) blends the last two steps
331
+ * to hide the difference between the step rate and the frame rate.
332
+ */
333
+ export class PhysicsClient3D {
334
+ #port;
335
+ #bodies = new Map();
336
+ #rays = new Map();
337
+ #next = 1;
338
+ #frame = 0;
339
+ #answered = 0;
340
+ #closed = false;
341
+ #listener = (event) => this.receive(event.data);
342
+ /** Steps asked for and not yet answered. */
343
+ get pending() {
344
+ return this.#frame - this.#answered;
345
+ }
346
+ /** Number of the latest step whose result has arrived. */
347
+ get frame() {
348
+ return this.#answered;
349
+ }
350
+ onContactBegin;
351
+ onContactEnd;
352
+ /** Called when the other end could not carry out a request. */
353
+ onError;
354
+ /** Called after the result of a step has been taken in. */
355
+ onStep;
356
+ constructor(port, options) {
357
+ if (!port || typeof port.postMessage !== 'function')
358
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'port');
359
+ this.#port = port;
360
+ port.addEventListener('message', this.#listener);
361
+ port.start?.();
362
+ if (options)
363
+ this.post({ t: 'world', options });
364
+ }
365
+ get bodies() {
366
+ return this.#bodies.values();
367
+ }
368
+ /** @internal */ post(message) {
369
+ if (!this.#closed)
370
+ this.#port.postMessage(message);
371
+ }
372
+ [ownsBody](body) {
373
+ return body instanceof RemoteBody3D && this.#bodies.get(body.id) === body;
374
+ }
375
+ /** @internal */ forget(body) {
376
+ if (this[ownsBody](body))
377
+ this.#bodies.delete(body.id);
378
+ }
379
+ createBody(options) {
380
+ if (!options?.shape)
381
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'shape');
382
+ const { node, userData, ...sent } = options, body = new RemoteBody3D(this, this.#next++, options);
383
+ void node;
384
+ void userData;
385
+ this.#bodies.set(body.id, body);
386
+ this.post({ t: 'body', id: body.id, options: sent });
387
+ if (body.node) {
388
+ body.node.position.set(body.position);
389
+ body.node.quaternion.set(body.quaternion);
390
+ body.node.markTransformDirty();
391
+ }
392
+ return body;
393
+ }
394
+ createJoint(options) {
395
+ if (!options)
396
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'joint bodies');
397
+ const { bodyA, bodyB, ...rest } = options;
398
+ if (!this[ownsBody](bodyA) || (bodyB !== undefined && !this[ownsBody](bodyB)))
399
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'joint bodies');
400
+ const joint = new RemoteJoint3D(this, this.#next++);
401
+ this.post({
402
+ t: 'joint',
403
+ id: joint.id,
404
+ options: { ...rest, bodyA: bodyA.id, ...(bodyB ? { bodyB: bodyB.id } : {}) }
405
+ });
406
+ return joint;
407
+ }
408
+ setGravity(x, y, z) {
409
+ this.post({ t: 'gravity', value: [requireFinite3D(x, 'x'), requireFinite3D(y, 'y'), requireFinite3D(z, 'z')] });
410
+ }
411
+ /**
412
+ * Ask for the world to advance. If `maxPending` earlier steps are still
413
+ * unanswered the request is not sent and false is returned, so a slow
414
+ * worker falls behind in time instead of piling up work.
415
+ */
416
+ step(deltaSeconds, maxPending = 2) {
417
+ requireFinite3D(deltaSeconds, 'deltaSeconds');
418
+ if (this.#closed || this.pending >= maxPending)
419
+ return false;
420
+ this.post({ t: 'step', dt: deltaSeconds, frame: ++this.#frame });
421
+ return true;
422
+ }
423
+ /** The nearest solid body on a ray, as the world stands when the request arrives. */
424
+ raycast(origin, direction, maxDistance, mask) {
425
+ const request = this.#next++;
426
+ return new Promise((resolve, reject) => {
427
+ if (this.#closed) {
428
+ resolve(undefined);
429
+ return;
430
+ }
431
+ this.#rays.set(request, { resolve, reject });
432
+ try {
433
+ this.post({
434
+ t: 'raycast',
435
+ request,
436
+ origin: [origin[0], origin[1], origin[2]],
437
+ direction: [direction[0], direction[1], direction[2]],
438
+ ...(maxDistance === undefined ? {} : { maxDistance }),
439
+ ...(mask === undefined ? {} : { mask })
440
+ });
441
+ }
442
+ catch (error) {
443
+ this.#rays.delete(request);
444
+ reject(error);
445
+ }
446
+ });
447
+ }
448
+ receive(m) {
449
+ if (m?.t === 'state') {
450
+ const who = m['ids'], poses = m['poses'], asleep = m['asleep'];
451
+ for (let i = 0; i < who.length; i++) {
452
+ const body = this.#bodies.get(who[i]);
453
+ if (!body)
454
+ continue;
455
+ body.previous.set(body.position);
456
+ body.previous.set(body.quaternion, 3);
457
+ body.position[0] = poses[i * 7];
458
+ body.position[1] = poses[i * 7 + 1];
459
+ body.position[2] = poses[i * 7 + 2];
460
+ body.quaternion[0] = poses[i * 7 + 3];
461
+ body.quaternion[1] = poses[i * 7 + 4];
462
+ body.quaternion[2] = poses[i * 7 + 5];
463
+ body.quaternion[3] = poses[i * 7 + 6];
464
+ body.isSleeping = asleep[i] === 1;
465
+ }
466
+ this.#answered = Math.max(this.#answered, m['frame']);
467
+ const pairs = (list, call) => {
468
+ if (!call)
469
+ return;
470
+ for (let i = 0; i + 1 < list.length; i += 2) {
471
+ const a = this.#bodies.get(list[i]), b = this.#bodies.get(list[i + 1]);
472
+ if (a && b)
473
+ call(a, b);
474
+ }
475
+ };
476
+ pairs(m['began'], this.onContactBegin);
477
+ pairs(m['ended'], this.onContactEnd);
478
+ this.onStep?.(this.#answered);
479
+ }
480
+ else if (m?.t === 'ray') {
481
+ const ray = this.#rays.get(m['request']), hit = m['hit'];
482
+ this.#rays.delete(m['request']);
483
+ const body = hit ? this.#bodies.get(hit.id) : undefined;
484
+ ray?.resolve(hit && body ? { body, distance: hit.distance, point: hit.point, normal: hit.normal } : undefined);
485
+ }
486
+ else if (m?.t === 'error') {
487
+ if (m['about'] === 'raycast') {
488
+ const request = m['request'], ray = this.#rays.get(request);
489
+ this.#rays.delete(request);
490
+ const detail = typeof m['detail'] === 'string' ? m['detail'] : undefined;
491
+ ray?.reject(new World3DError(m['code'] === 'WORLD3D_INPUT_INVALID' ? 'WORLD3D_INPUT_INVALID' : 'WORLD3D_RESOURCE_FAILED', detail));
492
+ }
493
+ this.onError?.(String(m['message']), String(m['about']));
494
+ }
495
+ }
496
+ /**
497
+ * Place every body's node. `alpha` runs from 0, the step before last, to 1,
498
+ * the latest step; pass how far the frame is between two steps to smooth
499
+ * motion when frames and steps do not line up.
500
+ */
501
+ update(alpha = 1) {
502
+ const t = alpha < 0 ? 0 : alpha > 1 ? 1 : alpha;
503
+ for (const body of this.#bodies.values()) {
504
+ const node = body.node;
505
+ if (!node || body.type === 'static')
506
+ continue;
507
+ const from = body.previous, p = body.position, q = body.quaternion;
508
+ node.position[0] = from[0] + (p[0] - from[0]) * t;
509
+ node.position[1] = from[1] + (p[1] - from[1]) * t;
510
+ node.position[2] = from[2] + (p[2] - from[2]) * t;
511
+ // Blend the orientations along the shorter way round and bring the result back to unit length.
512
+ const facing = from[3] * q[0] + from[4] * q[1] + from[5] * q[2] + from[6] * q[3] < 0 ? -1 : 1;
513
+ const x = from[3] + (q[0] * facing - from[3]) * t, y = from[4] + (q[1] * facing - from[4]) * t, z = from[5] + (q[2] * facing - from[5]) * t, w = from[6] + (q[3] * facing - from[6]) * t;
514
+ const size = Math.hypot(x, y, z, w) || 1;
515
+ node.quaternion[0] = x / size;
516
+ node.quaternion[1] = y / size;
517
+ node.quaternion[2] = z / size;
518
+ node.quaternion[3] = w / size;
519
+ node.markTransformDirty();
520
+ }
521
+ }
522
+ /** Stop listening and answer every waiting ray with nothing. The worker itself is the caller's to end. */
523
+ dispose() {
524
+ this.#closed = true;
525
+ this.#port.removeEventListener('message', this.#listener);
526
+ for (const ray of this.#rays.values())
527
+ ray.resolve(undefined);
528
+ this.#rays.clear();
529
+ this.#bodies.clear();
530
+ }
531
+ }
532
+ /** Connects to a physics world run in a worker, through a message port. */
533
+ export function connectPhysics3D(port, options) {
534
+ return new PhysicsClient3D(port, options);
535
+ }
536
+ //# sourceMappingURL=PhysicsRemote3D.js.map
@@ -0,0 +1,74 @@
1
+ import type { Object3D } from './Object3D.js';
2
+ import type { Joint3D, PhysicsWorld3D, RigidBody3D, ShapeDefinition3D } from './Physics3D.js';
3
+ /** The most parts a ragdoll has. */
4
+ export declare const RAGDOLL3D_LIMITS: Readonly<{
5
+ readonly maxParts: 64;
6
+ }>;
7
+ /** How a ragdoll part is joined to its parent: the joint's kind, axis and limits. */
8
+ export interface RagdollJoint3D {
9
+ /** 'point' swings freely like a shoulder; 'hinge' bends one way like a knee. Defaults to 'point'. */
10
+ readonly type?: 'point' | 'hinge';
11
+ /** Direction in the bone's own frame: the hinge pin, or the direction a cone limit is measured around. Defaults to +Y. */
12
+ readonly axis?: readonly [number, number, number];
13
+ /** 'hinge': lowest and highest angle in radians from the pose at activation. */
14
+ readonly limits?: readonly [number, number];
15
+ /** 'point': the widest swing in radians from the pose at activation. */
16
+ readonly coneLimit?: number;
17
+ }
18
+ /** One part of a ragdoll: its bone, shape and mass, its offset, its parent and its joint. */
19
+ export interface RagdollPart3D {
20
+ /** The bone this part moves, or its name under the ragdoll's root. */
21
+ readonly bone: Object3D | string;
22
+ /** A sphere, capsule or box in world units. A capsule runs along the bone's local Y axis. */
23
+ readonly shape: Extract<ShapeDefinition3D, {
24
+ type: 'sphere' | 'capsule' | 'box';
25
+ }>;
26
+ readonly mass?: number;
27
+ /** Center of the shape in the bone's local frame, in the bone's own units. Defaults to the bone's origin. */
28
+ readonly offset?: readonly [number, number, number];
29
+ /** Index of the part this one hangs from. Leave out for the part everything else hangs from; a parent comes before its children. */
30
+ readonly parent?: number;
31
+ /** How this part is attached to its parent, at this part's bone. */
32
+ readonly joint?: RagdollJoint3D;
33
+ }
34
+ /** A ragdoll to make: its layers, friction, bounce and damping. */
35
+ export interface RagdollOptions3D {
36
+ readonly layer?: number;
37
+ readonly mask?: number;
38
+ readonly friction?: number;
39
+ readonly restitution?: number;
40
+ readonly linearDamping?: number;
41
+ readonly angularDamping?: number;
42
+ }
43
+ /**
44
+ * Bodies and joints for a skeleton, created from the current pose by activate()
45
+ * and removed again by deactivate(). While active, call update() after each
46
+ * world.step() to move the bones with the bodies; bones that no part names
47
+ * keep whatever pose they had, carried along by their parents.
48
+ */
49
+ export declare class Ragdoll3D {
50
+ #private;
51
+ readonly world: PhysicsWorld3D;
52
+ readonly root: Object3D;
53
+ readonly options: RagdollOptions3D;
54
+ /** One body per part while active, in the order the parts were given. */
55
+ readonly bodies: RigidBody3D[];
56
+ readonly joints: Joint3D[];
57
+ constructor(physics: PhysicsWorld3D, root: Object3D, parts: readonly RagdollPart3D[], options?: RagdollOptions3D);
58
+ get active(): boolean;
59
+ get bones(): readonly Object3D[];
60
+ /**
61
+ * Go limp from the pose the skeleton is in now. `velocity` is the speed
62
+ * every part starts with, such as the character's own; `spin` adds a turn
63
+ * about the root part.
64
+ */
65
+ activate(velocity?: ArrayLike<number>, spin?: ArrayLike<number>): void;
66
+ /** Remove the bodies and joints; the bones stay where the bodies left them. */
67
+ deactivate(): void;
68
+ /** Move each bone to its body. Call after world.step() while active. */
69
+ update(): void;
70
+ dispose(): void;
71
+ }
72
+ /** Makes a ragdoll of physics bodies that a skeleton follows. */
73
+ export declare function createRagdoll3D(world: PhysicsWorld3D, root: Object3D, parts: readonly RagdollPart3D[], options?: RagdollOptions3D): Ragdoll3D;
74
+ //# sourceMappingURL=Ragdoll3D.d.ts.map