@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,323 @@
1
+ /**
2
+ * Bodies that never move, kept in a hierarchy of boxes so that a moving body, a ray or a
3
+ * sweep only looks at the ones nearby. It is rebuilt when a static body is added, removed or moved.
4
+ */
5
+ export class StaticTree {
6
+ bodies = [];
7
+ #boxes = new Float64Array(0);
8
+ /** Two numbers per node: an inner node holds its children; a leaf holds -(first body + 1) and a count. */
9
+ #links = new Int32Array(0);
10
+ #count = 0;
11
+ #dirty = false;
12
+ #stack = new Int32Array(64);
13
+ #busy = false;
14
+ add(body) {
15
+ this.bodies.push(body);
16
+ this.#dirty = true;
17
+ }
18
+ remove(body) {
19
+ const at = this.bodies.indexOf(body);
20
+ if (at >= 0) {
21
+ this.bodies.splice(at, 1);
22
+ this.#dirty = true;
23
+ }
24
+ }
25
+ touch() {
26
+ this.#dirty = true;
27
+ }
28
+ build() {
29
+ this.#dirty = false;
30
+ this.#count = 0;
31
+ const bodies = this.bodies, most = Math.max(2 * bodies.length, 1);
32
+ if (this.#links.length < most * 2) {
33
+ this.#boxes = new Float64Array(most * 6);
34
+ this.#links = new Int32Array(most * 2);
35
+ }
36
+ if (bodies.length > 0)
37
+ this.split(0, bodies.length);
38
+ }
39
+ split(first, end) {
40
+ const bodies = this.bodies, node = this.#count++, box = this.#boxes, at = node * 6;
41
+ let lx = Infinity, ly = Infinity, lz = Infinity, hx = -Infinity, hy = -Infinity, hz = -Infinity;
42
+ let cx0 = Infinity, cy0 = Infinity, cz0 = Infinity, cx1 = -Infinity, cy1 = -Infinity, cz1 = -Infinity;
43
+ for (let i = first; i < end; i++) {
44
+ const b = bodies[i].aabb, cx = b[0] + b[3], cy = b[1] + b[4], cz = b[2] + b[5];
45
+ lx = Math.min(lx, b[0]);
46
+ ly = Math.min(ly, b[1]);
47
+ lz = Math.min(lz, b[2]);
48
+ hx = Math.max(hx, b[3]);
49
+ hy = Math.max(hy, b[4]);
50
+ hz = Math.max(hz, b[5]);
51
+ cx0 = Math.min(cx0, cx);
52
+ cy0 = Math.min(cy0, cy);
53
+ cz0 = Math.min(cz0, cz);
54
+ cx1 = Math.max(cx1, cx);
55
+ cy1 = Math.max(cy1, cy);
56
+ cz1 = Math.max(cz1, cz);
57
+ }
58
+ box[at] = lx;
59
+ box[at + 1] = ly;
60
+ box[at + 2] = lz;
61
+ box[at + 3] = hx;
62
+ box[at + 4] = hy;
63
+ box[at + 5] = hz;
64
+ const count = end - first, sx = cx1 - cx0, sy = cy1 - cy0, sz = cz1 - cz0, axis = sx >= sy && sx >= sz ? 0 : sy >= sz ? 1 : 2;
65
+ // A handful of bodies, or bodies stacked at one place, stay together in a leaf.
66
+ if (count <= 4 || !(Math.max(sx, sy, sz) > 0)) {
67
+ this.#links[node * 2] = -(first + 1);
68
+ this.#links[node * 2 + 1] = count;
69
+ return node;
70
+ }
71
+ const part = bodies
72
+ .slice(first, end)
73
+ .sort((a, b) => a.aabb[axis] + a.aabb[axis + 3] - b.aabb[axis] - b.aabb[axis + 3]);
74
+ for (let i = 0; i < count; i++)
75
+ bodies[first + i] = part[i];
76
+ const middle = first + (count >> 1);
77
+ const left = this.split(first, middle), right = this.split(middle, end);
78
+ this.#links[node * 2] = left;
79
+ this.#links[node * 2 + 1] = right;
80
+ return node;
81
+ }
82
+ /** Call `visit` for every static body whose bounds meet the box. */
83
+ query(lx, ly, lz, hx, hy, hz, visit) {
84
+ if (this.#dirty)
85
+ this.build();
86
+ if (this.#count === 0)
87
+ return;
88
+ const box = this.#boxes, links = this.#links, bodies = this.bodies, shared = !this.#busy;
89
+ // A visitor may ask again while this walk is under way; it then gets a list of its own.
90
+ let stack = shared ? this.#stack : new Int32Array(64), top = 0;
91
+ if (shared)
92
+ this.#busy = true;
93
+ stack[top++] = 0;
94
+ try {
95
+ while (top > 0) {
96
+ const node = stack[--top], at = node * 6;
97
+ if (box[at] > hx ||
98
+ box[at + 3] < lx ||
99
+ box[at + 1] > hy ||
100
+ box[at + 4] < ly ||
101
+ box[at + 2] > hz ||
102
+ box[at + 5] < lz)
103
+ continue;
104
+ const link = links[node * 2];
105
+ if (link < 0) {
106
+ for (let i = -link - 1, end = i + links[node * 2 + 1]; i < end; i++) {
107
+ const b = bodies[i].aabb;
108
+ if (b[0] > hx || b[3] < lx || b[1] > hy || b[4] < ly || b[2] > hz || b[5] < lz)
109
+ continue;
110
+ visit(bodies[i]);
111
+ }
112
+ continue;
113
+ }
114
+ if (top + 2 > stack.length) {
115
+ const grown = new Int32Array(stack.length * 2);
116
+ grown.set(stack);
117
+ stack = grown;
118
+ }
119
+ stack[top++] = link;
120
+ stack[top++] = links[node * 2 + 1];
121
+ }
122
+ }
123
+ finally {
124
+ if (shared)
125
+ this.#busy = false;
126
+ }
127
+ }
128
+ /** Call `visit` for static bodies whose bounds the ray crosses within the distance `visit` returns. */
129
+ ray(o, d, limit, visit) {
130
+ if (this.#dirty)
131
+ this.build();
132
+ if (this.#count === 0)
133
+ return;
134
+ const box = this.#boxes, links = this.#links, bodies = this.bodies, stack = [0];
135
+ const reaches = (b, at) => {
136
+ let near = 0, far = limit;
137
+ for (let i = 0; i < 3; i++) {
138
+ const low = b[at + i], high = b[at + i + 3], from = o[i], way = d[i];
139
+ if (Math.abs(way) < 1e-12) {
140
+ if (from < low || from > high)
141
+ return false;
142
+ continue;
143
+ }
144
+ let t1 = (low - from) / way, t2 = (high - from) / way;
145
+ if (t1 > t2) {
146
+ const swap = t1;
147
+ t1 = t2;
148
+ t2 = swap;
149
+ }
150
+ if (t1 > near)
151
+ near = t1;
152
+ if (t2 < far)
153
+ far = t2;
154
+ if (near > far)
155
+ return false;
156
+ }
157
+ return true;
158
+ };
159
+ while (stack.length > 0) {
160
+ const node = stack.pop();
161
+ if (!reaches(box, node * 6))
162
+ continue;
163
+ const link = links[node * 2];
164
+ if (link < 0) {
165
+ for (let i = -link - 1, end = i + links[node * 2 + 1]; i < end; i++)
166
+ if (reaches(bodies[i].aabb, 0))
167
+ limit = visit(bodies[i], limit);
168
+ }
169
+ else
170
+ stack.push(link, links[node * 2 + 1]);
171
+ }
172
+ }
173
+ }
174
+ /**
175
+ * Distance along a unit ray to a body, or -1. Writes the surface normal at the hit.
176
+ * The caller supplies the existing mesh-normal scratch, also reused by compound parts.
177
+ */
178
+ export function rayShape(body, o, d, limit, normal, meshNormal) {
179
+ const shape = body.shape, p = body.position, r = body.rotation;
180
+ if (shape.type === 'compound') {
181
+ let best = -1, bx = 0, by = 0, bz = 0;
182
+ for (const part of body.parts) {
183
+ const distance = rayShape(part, o, d, best < 0 ? limit : best, normal, meshNormal);
184
+ if (distance < 0 || (best >= 0 && distance >= best))
185
+ continue;
186
+ best = distance;
187
+ bx = normal[0];
188
+ by = normal[1];
189
+ bz = normal[2];
190
+ }
191
+ normal[0] = bx;
192
+ normal[1] = by;
193
+ normal[2] = bz;
194
+ return best;
195
+ }
196
+ const raySphere = (cx, cy, cz, radius) => {
197
+ const mx = o[0] - cx, my = o[1] - cy, mz = o[2] - cz, b = mx * d[0] + my * d[1] + mz * d[2], c = mx * mx + my * my + mz * mz - radius * radius;
198
+ if (c > 0 && b > 0)
199
+ return -1;
200
+ const discriminant = b * b - c;
201
+ if (discriminant < 0)
202
+ return -1;
203
+ const t = Math.max(-b - Math.sqrt(discriminant), 0);
204
+ normal[0] = (mx + d[0] * t) / radius;
205
+ normal[1] = (my + d[1] * t) / radius;
206
+ normal[2] = (mz + d[2] * t) / radius;
207
+ return t;
208
+ };
209
+ if (shape.type === 'sphere')
210
+ return raySphere(p[0], p[1], p[2], shape.radius);
211
+ if (shape.type === 'plane') {
212
+ const nx = r[1], ny = r[4], nz = r[7], denominator = d[0] * nx + d[1] * ny + d[2] * nz;
213
+ if (denominator >= -1e-9)
214
+ return -1;
215
+ const t = ((p[0] - o[0]) * nx + (p[1] - o[1]) * ny + (p[2] - o[2]) * nz) / denominator;
216
+ if (t < 0)
217
+ return -1;
218
+ normal[0] = nx;
219
+ normal[1] = ny;
220
+ normal[2] = nz;
221
+ return t;
222
+ }
223
+ // Work in the body's local frame for boxes and capsules.
224
+ const dx = o[0] - p[0], dy = o[1] - p[1], dz = o[2] - p[2];
225
+ const lo = [
226
+ r[0] * dx + r[3] * dy + r[6] * dz,
227
+ r[1] * dx + r[4] * dy + r[7] * dz,
228
+ r[2] * dx + r[5] * dy + r[8] * dz
229
+ ];
230
+ const ld = [
231
+ r[0] * d[0] + r[3] * d[1] + r[6] * d[2],
232
+ r[1] * d[0] + r[4] * d[1] + r[7] * d[2],
233
+ r[2] * d[0] + r[5] * d[1] + r[8] * d[2]
234
+ ];
235
+ let t = -1, lx = 0, ly = 0, lz = 0;
236
+ if (shape.type === 'convex') {
237
+ t = shape.hull.raycast(lo[0], lo[1], lo[2], ld[0], ld[1], ld[2], limit, meshNormal);
238
+ if (t < 0)
239
+ return -1;
240
+ lx = meshNormal[0];
241
+ ly = meshNormal[1];
242
+ lz = meshNormal[2];
243
+ }
244
+ else if (shape.type === 'mesh') {
245
+ t = shape.mesh.raycast(lo[0], lo[1], lo[2], ld[0], ld[1], ld[2], limit, meshNormal);
246
+ if (t < 0)
247
+ return -1;
248
+ lx = meshNormal[0];
249
+ ly = meshNormal[1];
250
+ lz = meshNormal[2];
251
+ }
252
+ else if (shape.type === 'box') {
253
+ let near = 0, far = limit, axis = -1, sign = 0;
254
+ for (let i = 0; i < 3; i++) {
255
+ const h = shape.halfExtents[i];
256
+ if (Math.abs(ld[i]) < 1e-12) {
257
+ if (Math.abs(lo[i]) > h)
258
+ return -1;
259
+ continue;
260
+ }
261
+ let t1 = (-h - lo[i]) / ld[i], t2 = (h - lo[i]) / ld[i], s = -1;
262
+ if (t1 > t2) {
263
+ const swap = t1;
264
+ t1 = t2;
265
+ t2 = swap;
266
+ s = 1;
267
+ }
268
+ if (t1 > near) {
269
+ near = t1;
270
+ axis = i;
271
+ sign = s;
272
+ }
273
+ far = Math.min(far, t2);
274
+ if (near > far)
275
+ return -1;
276
+ }
277
+ if (axis < 0)
278
+ return -1; // Origin inside the box.
279
+ t = near;
280
+ lx = axis === 0 ? sign : 0;
281
+ ly = axis === 1 ? sign : 0;
282
+ lz = axis === 2 ? sign : 0;
283
+ }
284
+ else {
285
+ const capsule = shape, radius = capsule.radius, h = capsule.halfHeight;
286
+ // Side: an infinite cylinder around local Y, clipped to the segment.
287
+ const a = ld[0] * ld[0] + ld[2] * ld[2], b = lo[0] * ld[0] + lo[2] * ld[2], c = lo[0] * lo[0] + lo[2] * lo[2] - radius * radius;
288
+ if (a > 1e-12) {
289
+ const discriminant = b * b - a * c;
290
+ if (discriminant >= 0) {
291
+ const hit = (-b - Math.sqrt(discriminant)) / a, y = lo[1] + ld[1] * hit;
292
+ if (hit >= 0 && Math.abs(y) <= h) {
293
+ t = hit;
294
+ lx = (lo[0] + ld[0] * hit) / radius;
295
+ ly = 0;
296
+ lz = (lo[2] + ld[2] * hit) / radius;
297
+ }
298
+ }
299
+ }
300
+ if (t < 0) {
301
+ // Caps: the nearer of the two end spheres, tested in world space.
302
+ let bestCap = -1, bx = 0, by = 0, bz = 0;
303
+ for (const side of [-h, h]) {
304
+ const hit = raySphere(p[0] + r[1] * side, p[1] + r[4] * side, p[2] + r[7] * side, radius);
305
+ if (hit >= 0 && (bestCap < 0 || hit < bestCap)) {
306
+ bestCap = hit;
307
+ bx = normal[0];
308
+ by = normal[1];
309
+ bz = normal[2];
310
+ }
311
+ }
312
+ normal[0] = bx;
313
+ normal[1] = by;
314
+ normal[2] = bz;
315
+ return bestCap;
316
+ }
317
+ }
318
+ normal[0] = r[0] * lx + r[1] * ly + r[2] * lz;
319
+ normal[1] = r[3] * lx + r[4] * ly + r[5] * lz;
320
+ normal[2] = r[6] * lx + r[7] * ly + r[8] * lz;
321
+ return t;
322
+ }
323
+ //# sourceMappingURL=PhysicsQueries3D.js.map
@@ -0,0 +1,174 @@
1
+ import type { Object3D } from './Object3D.js';
2
+ import { PhysicsWorld3D, type BodyType3D, type JointType3D, type PhysicsWorldOptions3D } from './Physics3D.js';
3
+ /** A Worker, a worker's global scope, a MessagePort: anything that posts and receives messages. */
4
+ export interface PhysicsPort3D {
5
+ postMessage(message: unknown, transfer?: never): void;
6
+ addEventListener(type: 'message', listener: (event: {
7
+ readonly data: unknown;
8
+ }) => void): void;
9
+ removeEventListener(type: 'message', listener: (event: {
10
+ readonly data: unknown;
11
+ }) => void): void;
12
+ /** A MessagePort delivers nothing until it is started; workers have no such step. */
13
+ start?(): void;
14
+ }
15
+ /** Shapes that can be described in a message. A convex hull is given by its corner points. */
16
+ export type RemoteShape3D = {
17
+ readonly type: 'sphere';
18
+ readonly radius: number;
19
+ } | {
20
+ readonly type: 'box';
21
+ readonly halfExtents: readonly [number, number, number];
22
+ } | {
23
+ readonly type: 'capsule';
24
+ readonly radius: number;
25
+ readonly halfHeight: number;
26
+ } | {
27
+ readonly type: 'plane';
28
+ } | {
29
+ readonly type: 'convex';
30
+ readonly points: readonly number[];
31
+ } | {
32
+ readonly type: 'compound';
33
+ readonly children: readonly {
34
+ readonly shape: Exclude<RemoteShape3D, {
35
+ type: 'plane' | 'compound';
36
+ }>;
37
+ readonly position?: readonly [number, number, number];
38
+ readonly quaternion?: readonly [number, number, number, number];
39
+ }[];
40
+ };
41
+ export interface RemoteBodyOptions3D {
42
+ readonly type?: BodyType3D;
43
+ readonly shape: RemoteShape3D;
44
+ readonly mass?: number;
45
+ readonly position?: readonly [number, number, number];
46
+ readonly quaternion?: readonly [number, number, number, number];
47
+ readonly restitution?: number;
48
+ readonly friction?: number;
49
+ readonly linearDamping?: number;
50
+ readonly angularDamping?: number;
51
+ readonly isTrigger?: boolean;
52
+ readonly layer?: number;
53
+ readonly mask?: number;
54
+ readonly fixedRotation?: boolean;
55
+ readonly continuous?: boolean;
56
+ /** Scene node moved to the body by update(). It stays on this side; it is not sent. */
57
+ readonly node?: Object3D;
58
+ readonly userData?: unknown;
59
+ }
60
+ export interface RemoteJointOptions3D {
61
+ readonly type: JointType3D;
62
+ readonly bodyA: RemoteBody3D;
63
+ readonly bodyB?: RemoteBody3D;
64
+ readonly anchor?: readonly [number, number, number];
65
+ readonly anchorB?: readonly [number, number, number];
66
+ readonly axis?: readonly [number, number, number];
67
+ readonly limits?: readonly [number, number];
68
+ readonly motorSpeed?: number;
69
+ readonly maxMotorTorque?: number;
70
+ readonly maxMotorForce?: number;
71
+ readonly coneLimit?: number;
72
+ readonly length?: number;
73
+ readonly rope?: boolean;
74
+ readonly stiffness?: number;
75
+ readonly damping?: number;
76
+ readonly collideConnected?: boolean;
77
+ }
78
+ export interface RemoteRaycastHit3D {
79
+ readonly body: RemoteBody3D;
80
+ readonly distance: number;
81
+ readonly point: readonly [number, number, number];
82
+ readonly normal: readonly [number, number, number];
83
+ }
84
+ declare const ownsBody: unique symbol;
85
+ /**
86
+ * Run a physics world on this end of a port and answer the messages of a
87
+ * PhysicsClient3D. In a worker this is the whole script:
88
+ * import {servePhysics3D} from '@egret/engine/world3d';
89
+ * servePhysics3D(self);
90
+ * Returns the world, for a host that wants to add to it directly.
91
+ */
92
+ export declare function servePhysics3D(port: PhysicsPort3D, options?: PhysicsWorldOptions3D): PhysicsWorld3D;
93
+ /** The page's stand-in for a body that lives behind the port. */
94
+ export declare class RemoteBody3D {
95
+ #private;
96
+ readonly id: number;
97
+ readonly type: BodyType3D;
98
+ /** Where the body was after the latest step this side has heard of. */
99
+ readonly position: Float32Array<ArrayBuffer>;
100
+ readonly quaternion: Float32Array<ArrayBuffer>;
101
+ /** @internal Where it was the step before, for blending between the two. */
102
+ readonly previous: Float32Array<ArrayBuffer>;
103
+ isSleeping: boolean;
104
+ node: Object3D | undefined;
105
+ userData: unknown;
106
+ /** @internal */
107
+ constructor(client: PhysicsClient3D, id: number, options: RemoteBodyOptions3D);
108
+ get removed(): boolean;
109
+ private send;
110
+ /** Move the body there at once; this side shows it there straight away. */
111
+ setPosition(x: number, y: number, z: number): this;
112
+ setQuaternion(x: number, y: number, z: number, w: number): this;
113
+ setLinearVelocity(x: number, y: number, z: number): this;
114
+ setAngularVelocity(x: number, y: number, z: number): this;
115
+ applyImpulse(x: number, y: number, z: number, point?: ArrayLike<number>): void;
116
+ /** A force for the next step only, as with a local body. */
117
+ applyForce(x: number, y: number, z: number): void;
118
+ remove(): void;
119
+ }
120
+ export declare class RemoteJoint3D {
121
+ #private;
122
+ readonly id: number;
123
+ /** @internal */
124
+ constructor(client: PhysicsClient3D, id: number);
125
+ remove(): void;
126
+ }
127
+ /**
128
+ * The page's end of a remote physics world. Create bodies and joints as with a
129
+ * local world, call step() once per frame, and update() to place the nodes.
130
+ * Positions arrive a moment after they are asked for, so what is shown trails
131
+ * the simulation by about one step; update(alpha) blends the last two steps
132
+ * to hide the difference between the step rate and the frame rate.
133
+ */
134
+ export declare class PhysicsClient3D {
135
+ #private;
136
+ /** Steps asked for and not yet answered. */
137
+ get pending(): number;
138
+ /** Number of the latest step whose result has arrived. */
139
+ get frame(): number;
140
+ onContactBegin: ((a: RemoteBody3D, b: RemoteBody3D) => void) | undefined;
141
+ onContactEnd: ((a: RemoteBody3D, b: RemoteBody3D) => void) | undefined;
142
+ /** Called when the other end could not carry out a request. */
143
+ onError: ((message: string, about: string) => void) | undefined;
144
+ /** Called after the result of a step has been taken in. */
145
+ onStep: ((frame: number) => void) | undefined;
146
+ constructor(port: PhysicsPort3D, options?: PhysicsWorldOptions3D);
147
+ get bodies(): IterableIterator<RemoteBody3D>;
148
+ /** @internal */ post(message: Record<string, unknown>): void;
149
+ [ownsBody](body: unknown): body is RemoteBody3D;
150
+ /** @internal */ forget(body: RemoteBody3D): void;
151
+ createBody(options: RemoteBodyOptions3D): RemoteBody3D;
152
+ createJoint(options: RemoteJointOptions3D): RemoteJoint3D;
153
+ setGravity(x: number, y: number, z: number): void;
154
+ /**
155
+ * Ask for the world to advance. If `maxPending` earlier steps are still
156
+ * unanswered the request is not sent and false is returned, so a slow
157
+ * worker falls behind in time instead of piling up work.
158
+ */
159
+ step(deltaSeconds: number, maxPending?: number): boolean;
160
+ /** The nearest solid body on a ray, as the world stands when the request arrives. */
161
+ raycast(origin: ArrayLike<number>, direction: ArrayLike<number>, maxDistance?: number, mask?: number): Promise<RemoteRaycastHit3D | undefined>;
162
+ private receive;
163
+ /**
164
+ * Place every body's node. `alpha` runs from 0, the step before last, to 1,
165
+ * the latest step; pass how far the frame is between two steps to smooth
166
+ * motion when frames and steps do not line up.
167
+ */
168
+ update(alpha?: number): void;
169
+ /** Stop listening and answer every waiting ray with nothing. The worker itself is the caller's to end. */
170
+ dispose(): void;
171
+ }
172
+ export declare function connectPhysics3D(port: PhysicsPort3D, options?: PhysicsWorldOptions3D): PhysicsClient3D;
173
+ export {};
174
+ //# sourceMappingURL=PhysicsRemote3D.d.ts.map