@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,274 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // CPU-simulated particle emitter drawn as one instanced, camera-facing quad
3
+ // batch. State lives in flat typed arrays and dead particles are swapped out
4
+ // of the active range, so a steady emitter allocates nothing per frame.
5
+ import { World3DError, requireCount3D, requireFinite3D } from './core3D.js';
6
+ import { setColor3D, createSpriteMaterial3D } from './Material3D.js';
7
+ import { mat4Invert, mat4MaxScaleOnAxis } from './math3D.js';
8
+ import { InstancedMesh3D } from './Mesh3D.js';
9
+ import { createQuadGeometry3D } from './primitives3D.js';
10
+ export const PARTICLES3D_LIMITS = Object.freeze({ maxParticles: 262144, maxStepSeconds: 0.25 });
11
+ function range(value, fallback, field) {
12
+ if (value === undefined)
13
+ return [fallback, fallback];
14
+ if (typeof value === 'number')
15
+ return [requireFinite3D(value, field), value];
16
+ if (!Array.isArray(value) || value.length !== 2)
17
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
18
+ const min = requireFinite3D(value[0], field), max = requireFinite3D(value[1], field);
19
+ if (max < min)
20
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
21
+ return [min, max];
22
+ }
23
+ const STRIDE = 8; // px, py, pz, vx, vy, vz, age, life
24
+ const scratchInverse = new Float32Array(16);
25
+ export class ParticleEmitter3D extends InstancedMesh3D {
26
+ rate;
27
+ lifetime;
28
+ speed;
29
+ direction = new Float32Array([0, 1, 0]);
30
+ spread;
31
+ gravity = new Float32Array(3);
32
+ drag;
33
+ startSize;
34
+ endSize;
35
+ startColor = new Float32Array([1, 1, 1]);
36
+ endColor = new Float32Array([1, 1, 1]);
37
+ startOpacity;
38
+ endOpacity;
39
+ shape;
40
+ radius;
41
+ extents = new Float32Array([0.5, 0.5, 0.5]);
42
+ space;
43
+ duration;
44
+ /** Emission is suspended while false; live particles keep simulating. */
45
+ emitting = true;
46
+ #state;
47
+ #alive = 0;
48
+ #debt = 0;
49
+ #elapsed = 0;
50
+ #random;
51
+ #seed;
52
+ constructor(options = {}) {
53
+ const capacity = requireCount3D(options.capacity ?? 1000, 'capacity', PARTICLES3D_LIMITS.maxParticles);
54
+ const material = createSpriteMaterial3D({
55
+ ...(options.map ? { map: options.map } : {}),
56
+ blending: options.blending ?? 'additive',
57
+ depthWrite: false
58
+ });
59
+ super(createQuadGeometry3D(), material, capacity, 4);
60
+ this.name = 'particles';
61
+ this.castShadow = false;
62
+ this.receiveShadow = false;
63
+ this.count = 0;
64
+ this.instanceColors = new Float32Array(capacity * 4);
65
+ this.#state = new Float32Array(capacity * STRIDE);
66
+ this.rate = requireFinite3D(options.rate ?? 50, 'rate');
67
+ this.lifetime = range(options.lifetime, 1, 'lifetime');
68
+ this.speed = range(options.speed, 1, 'speed');
69
+ if (this.lifetime[0] <= 0)
70
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'lifetime');
71
+ if (options.direction)
72
+ this.direction.set(options.direction);
73
+ this.spread = requireFinite3D(options.spread ?? Math.PI / 8, 'spread');
74
+ if (options.gravity)
75
+ this.gravity.set(options.gravity);
76
+ this.drag = requireFinite3D(options.drag ?? 0, 'drag');
77
+ this.startSize = requireFinite3D(options.startSize ?? 0.2, 'startSize');
78
+ this.endSize = requireFinite3D(options.endSize ?? this.startSize, 'endSize');
79
+ if (options.startColor !== undefined)
80
+ setColor3D(this.startColor, options.startColor);
81
+ this.endColor.set(this.startColor);
82
+ if (options.endColor !== undefined)
83
+ setColor3D(this.endColor, options.endColor);
84
+ this.startOpacity = requireFinite3D(options.startOpacity ?? 1, 'startOpacity');
85
+ this.endOpacity = requireFinite3D(options.endOpacity ?? 0, 'endOpacity');
86
+ this.shape = options.shape ?? 'point';
87
+ this.radius = requireFinite3D(options.radius ?? 0.5, 'radius');
88
+ if (options.extents)
89
+ this.extents.set(options.extents);
90
+ this.space = options.space ?? 'world';
91
+ this.duration = requireFinite3D(options.duration ?? 0, 'duration');
92
+ this.#seed = (options.seed ?? 0x9e3779b9) >>> 0;
93
+ this.#random = this.#seed;
94
+ }
95
+ /** Number of live particles. */
96
+ get aliveCount() {
97
+ return this.#alive;
98
+ }
99
+ /** Seconds simulated since construction or the last reset(). */
100
+ get elapsedSeconds() {
101
+ return this.#elapsed;
102
+ }
103
+ /** Uniform value in [0, 1) from a small deterministic generator (mulberry32). */
104
+ next() {
105
+ let t = (this.#random = (this.#random + 0x6d2b79f5) >>> 0);
106
+ t = Math.imul(t ^ (t >>> 15), t | 1);
107
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
108
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
109
+ }
110
+ /** Emit `count` particles immediately, limited by the remaining capacity. */
111
+ burst(count) {
112
+ const wanted = Math.min(requireCount3D(count, 'count', PARTICLES3D_LIMITS.maxParticles), this.capacity - this.#alive);
113
+ if (wanted <= 0)
114
+ return 0;
115
+ const world = this.space === 'world';
116
+ if (world)
117
+ this.updateWorldMatrix();
118
+ for (let i = 0; i < wanted; i++)
119
+ this.spawn(world);
120
+ return wanted;
121
+ }
122
+ spawn(world) {
123
+ const state = this.#state, o = this.#alive * STRIDE;
124
+ let px = 0, py = 0, pz = 0;
125
+ if (this.shape === 'sphere') {
126
+ // Uniform point inside a ball by rejection-free cube-root scaling.
127
+ const z = this.next() * 2 - 1, angle = this.next() * Math.PI * 2, r = Math.cbrt(this.next()) * this.radius, flat = Math.sqrt(1 - z * z);
128
+ px = r * flat * Math.cos(angle);
129
+ py = r * z;
130
+ pz = r * flat * Math.sin(angle);
131
+ }
132
+ else if (this.shape === 'box') {
133
+ px = (this.next() * 2 - 1) * this.extents[0];
134
+ py = (this.next() * 2 - 1) * this.extents[1];
135
+ pz = (this.next() * 2 - 1) * this.extents[2];
136
+ }
137
+ // Sample a direction uniformly inside the cone around `direction`.
138
+ const dx = this.direction[0], dy = this.direction[1], dz = this.direction[2], length = Math.hypot(dx, dy, dz) || 1;
139
+ const ax = dx / length, ay = dy / length, az = dz / length;
140
+ const cosLimit = Math.cos(Math.min(Math.max(this.spread, 0), Math.PI));
141
+ const cosTheta = 1 - this.next() * (1 - cosLimit), sinTheta = Math.sqrt(Math.max(0, 1 - cosTheta * cosTheta)), phi = this.next() * Math.PI * 2;
142
+ // Orthonormal basis (u, v, axis); pick the helper axis least aligned with `axis`.
143
+ const hx = Math.abs(ax) < 0.9 ? 1 : 0, hy = hx ? 0 : 1;
144
+ let ux = ay * 0 - az * hy, uy = az * hx - ax * 0, uz = ax * hy - ay * hx;
145
+ const ul = Math.hypot(ux, uy, uz) || 1;
146
+ ux /= ul;
147
+ uy /= ul;
148
+ uz /= ul;
149
+ const vx = ay * uz - az * uy, vy = az * ux - ax * uz, vz = ax * uy - ay * ux;
150
+ const c = Math.cos(phi) * sinTheta, s = Math.sin(phi) * sinTheta;
151
+ let rx = ux * c + vx * s + ax * cosTheta, ry = uy * c + vy * s + ay * cosTheta, rz = uz * c + vz * s + az * cosTheta;
152
+ const speed = this.speed[0] + this.next() * (this.speed[1] - this.speed[0]);
153
+ if (world) {
154
+ // Move the spawn point and direction into world space once, at birth.
155
+ const m = this.matrixWorld;
156
+ const wx = m[0] * px + m[4] * py + m[8] * pz + m[12], wy = m[1] * px + m[5] * py + m[9] * pz + m[13], wz = m[2] * px + m[6] * py + m[10] * pz + m[14];
157
+ px = wx;
158
+ py = wy;
159
+ pz = wz;
160
+ const tx = m[0] * rx + m[4] * ry + m[8] * rz, ty = m[1] * rx + m[5] * ry + m[9] * rz, tz = m[2] * rx + m[6] * ry + m[10] * rz;
161
+ const tl = Math.hypot(tx, ty, tz) || 1;
162
+ rx = tx / tl;
163
+ ry = ty / tl;
164
+ rz = tz / tl;
165
+ }
166
+ state[o] = px;
167
+ state[o + 1] = py;
168
+ state[o + 2] = pz;
169
+ state[o + 3] = rx * speed;
170
+ state[o + 4] = ry * speed;
171
+ state[o + 5] = rz * speed;
172
+ state[o + 6] = 0;
173
+ state[o + 7] = this.lifetime[0] + this.next() * (this.lifetime[1] - this.lifetime[0]);
174
+ this.#alive++;
175
+ }
176
+ /** Advance the simulation and refresh the instance buffers. */
177
+ update(deltaSeconds) {
178
+ const dt = Math.min(Math.max(requireFinite3D(deltaSeconds, 'deltaSeconds'), 0), PARTICLES3D_LIMITS.maxStepSeconds);
179
+ const state = this.#state, world = this.space === 'world';
180
+ this.updateWorldMatrix();
181
+ // Age and integrate; a dead particle is replaced by the last live one.
182
+ const gx = this.gravity[0] * dt, gy = this.gravity[1] * dt, gz = this.gravity[2] * dt, damp = Math.max(0, 1 - this.drag * dt);
183
+ for (let i = 0; i < this.#alive;) {
184
+ const o = i * STRIDE, age = state[o + 6] + dt;
185
+ if (age >= state[o + 7]) {
186
+ const last = --this.#alive * STRIDE;
187
+ if (last !== o)
188
+ state.copyWithin(o, last, last + STRIDE);
189
+ continue;
190
+ }
191
+ state[o + 6] = age;
192
+ const vx = (state[o + 3] + gx) * damp, vy = (state[o + 4] + gy) * damp, vz = (state[o + 5] + gz) * damp;
193
+ state[o + 3] = vx;
194
+ state[o + 4] = vy;
195
+ state[o + 5] = vz;
196
+ state[o] = state[o] + vx * dt;
197
+ state[o + 1] = state[o + 1] + vy * dt;
198
+ state[o + 2] = state[o + 2] + vz * dt;
199
+ i++;
200
+ }
201
+ const active = this.emitting && (this.duration <= 0 || this.#elapsed < this.duration);
202
+ this.#elapsed += dt;
203
+ if (active && this.rate > 0) {
204
+ this.#debt += this.rate * dt;
205
+ const emit = Math.min(Math.floor(this.#debt), this.capacity - this.#alive);
206
+ this.#debt -= Math.floor(this.#debt);
207
+ for (let i = 0; i < emit; i++)
208
+ this.spawn(world);
209
+ }
210
+ this.writeInstances(world);
211
+ }
212
+ writeInstances(world) {
213
+ const state = this.#state, matrices = this.instanceMatrices, colors = this.instanceColors;
214
+ let inverse, sizeScale = 1;
215
+ if (world) {
216
+ // Instance matrices are relative to this node; undo its world transform.
217
+ if (mat4Invert(scratchInverse, this.matrixWorld))
218
+ inverse = scratchInverse;
219
+ sizeScale = 1 / (mat4MaxScaleOnAxis(this.matrixWorld) || 1);
220
+ }
221
+ const sr = this.startColor[0], sg = this.startColor[1], sb = this.startColor[2];
222
+ const er = this.endColor[0] - sr, eg = this.endColor[1] - sg, eb = this.endColor[2] - sb;
223
+ for (let i = 0; i < this.#alive; i++) {
224
+ const o = i * STRIDE, m = i * 16, k = state[o + 6] / state[o + 7];
225
+ let x = state[o], y = state[o + 1], z = state[o + 2];
226
+ if (inverse) {
227
+ const ix = inverse[0] * x + inverse[4] * y + inverse[8] * z + inverse[12], iy = inverse[1] * x + inverse[5] * y + inverse[9] * z + inverse[13];
228
+ z = inverse[2] * x + inverse[6] * y + inverse[10] * z + inverse[14];
229
+ x = ix;
230
+ y = iy;
231
+ }
232
+ const size = (this.startSize + (this.endSize - this.startSize) * k) * sizeScale;
233
+ matrices[m] = size;
234
+ matrices[m + 1] = 0;
235
+ matrices[m + 2] = 0;
236
+ matrices[m + 3] = 0;
237
+ matrices[m + 4] = 0;
238
+ matrices[m + 5] = size;
239
+ matrices[m + 6] = 0;
240
+ matrices[m + 7] = 0;
241
+ matrices[m + 8] = 0;
242
+ matrices[m + 9] = 0;
243
+ matrices[m + 10] = size;
244
+ matrices[m + 11] = 0;
245
+ matrices[m + 12] = x;
246
+ matrices[m + 13] = y;
247
+ matrices[m + 14] = z;
248
+ matrices[m + 15] = 1;
249
+ const c = i * 4;
250
+ colors[c] = sr + er * k;
251
+ colors[c + 1] = sg + eg * k;
252
+ colors[c + 2] = sb + eb * k;
253
+ colors[c + 3] = this.startOpacity + (this.endOpacity - this.startOpacity) * k;
254
+ }
255
+ this.count = this.#alive;
256
+ this.instanceVersion++;
257
+ }
258
+ /** Remove every particle and restart the random sequence and the duration timer. */
259
+ reset() {
260
+ this.#alive = 0;
261
+ this.#debt = 0;
262
+ this.#elapsed = 0;
263
+ this.#random = this.#seed;
264
+ this.count = 0;
265
+ this.instanceVersion++;
266
+ }
267
+ clone() {
268
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'a particle emitter cannot be cloned; create a new one from the same options');
269
+ }
270
+ }
271
+ export function createParticleEmitter3D(options = {}) {
272
+ return new ParticleEmitter3D(options);
273
+ }
274
+ //# sourceMappingURL=Particles3D.js.map
@@ -0,0 +1,416 @@
1
+ import type { Object3D } from './Object3D.js';
2
+ import { ConvexHullShape3D } from './PhysicsHull3D.js';
3
+ import { TriangleMeshShape3D } from './PhysicsMesh3D.js';
4
+ export declare const raycastExcludingBody3D: unique symbol;
5
+ export declare const PHYSICS3D_LIMITS: Readonly<{
6
+ readonly maxBodies: 16384;
7
+ readonly maxSubSteps: 8;
8
+ readonly maxContactsPerPair: 8;
9
+ readonly maxCompoundChildren: 32;
10
+ readonly maxSolverSteps: 8;
11
+ }>;
12
+ export type BodyType3D = 'static' | 'kinematic' | 'dynamic';
13
+ export type ShapeDefinition3D = {
14
+ readonly type: 'sphere';
15
+ readonly radius: number;
16
+ } | {
17
+ readonly type: 'box';
18
+ readonly halfExtents: readonly [number, number, number];
19
+ }
20
+ /** Capsule along the local Y axis; `halfHeight` is half the distance between the two cap centers. */
21
+ | {
22
+ readonly type: 'capsule';
23
+ readonly radius: number;
24
+ readonly halfHeight: number;
25
+ }
26
+ /** Infinite plane through the body position, facing the body's local +Y axis. Static only. */
27
+ | {
28
+ readonly type: 'plane';
29
+ }
30
+ /** Convex solid given by its corner points; any body type. */
31
+ | {
32
+ readonly type: 'convex';
33
+ readonly hull: ConvexHullShape3D;
34
+ }
35
+ /** Triangle mesh for level geometry, solid on the front side of each triangle. Static, or kinematic for moving platforms. */
36
+ | {
37
+ readonly type: 'mesh';
38
+ readonly mesh: TriangleMeshShape3D;
39
+ }
40
+ /**
41
+ * Several solid shapes that move as one body, such as a table or an L-shaped block.
42
+ * The body's position is taken as its center of mass, so place the parts around the origin.
43
+ */
44
+ | {
45
+ readonly type: 'compound';
46
+ readonly children: readonly CompoundChild3D[];
47
+ };
48
+ /** One part of a compound shape, placed in the body's local frame. */
49
+ export interface CompoundChild3D {
50
+ readonly shape: Extract<ShapeDefinition3D, {
51
+ type: 'sphere' | 'box' | 'capsule' | 'convex';
52
+ }>;
53
+ readonly position?: readonly [number, number, number];
54
+ readonly quaternion?: readonly [number, number, number, number];
55
+ }
56
+ export interface RigidBodyOptions3D {
57
+ readonly type?: BodyType3D;
58
+ readonly shape: ShapeDefinition3D;
59
+ readonly mass?: number;
60
+ readonly position?: readonly [number, number, number];
61
+ readonly quaternion?: readonly [number, number, number, number];
62
+ readonly restitution?: number;
63
+ readonly friction?: number;
64
+ readonly linearDamping?: number;
65
+ readonly angularDamping?: number;
66
+ /** Report overlaps through contact events without pushing anything. */
67
+ readonly isTrigger?: boolean;
68
+ /** Collision category bits and the categories this body collides with. */
69
+ readonly layer?: number;
70
+ readonly mask?: number;
71
+ /** Stop the body from rotating, as for an upright character. */
72
+ readonly fixedRotation?: boolean;
73
+ /**
74
+ * Continuous collision for fast bodies such as projectiles: each step the
75
+ * body's travel is cut short at the first surface in its path, so it
76
+ * cannot pass through thin walls. The path is probed along the line of
77
+ * the body's center.
78
+ */
79
+ readonly continuous?: boolean;
80
+ /** Scene node placed at the body when it is added and moved with it after each step; it must not have a transformed parent. */
81
+ readonly node?: Object3D;
82
+ readonly userData?: unknown;
83
+ }
84
+ export interface PhysicsRaycastHit3D {
85
+ readonly body: RigidBody3D;
86
+ readonly point: [number, number, number];
87
+ readonly normal: [number, number, number];
88
+ readonly distance: number;
89
+ }
90
+ export interface PhysicsShapeCastHit3D {
91
+ readonly body: RigidBody3D;
92
+ /** How far the shape travelled before touching. */
93
+ readonly distance: number;
94
+ readonly point: readonly [number, number, number];
95
+ readonly normal: readonly [number, number, number];
96
+ }
97
+ /** What a pair of solid bodies did to each other in one step. The object is reused; copy what you keep. */
98
+ export interface PhysicsContact3D {
99
+ readonly a: RigidBody3D;
100
+ readonly b: RigidBody3D;
101
+ /** Where they touch, averaged over the contact points and weighted by how hard each one pushed. */
102
+ readonly point: ArrayLike<number>;
103
+ /** Direction from `a` toward `b`. */
104
+ readonly normal: ArrayLike<number>;
105
+ /** Total push along the normal this step; divide by a body's mass for the change of speed it caused. */
106
+ readonly impulse: number;
107
+ /** True in the first step the pair touches. */
108
+ readonly began: boolean;
109
+ }
110
+ export interface PhysicsWorldOptions3D {
111
+ readonly gravity?: readonly [number, number, number];
112
+ /** Length of one simulation step in seconds. */
113
+ readonly fixedStep?: number;
114
+ readonly maxSubSteps?: number;
115
+ readonly iterations?: number;
116
+ /**
117
+ * Solve each fixed step in this many smaller slices, finding contacts once. More slices
118
+ * hold tall stacks, long chains and heavy loads on light links far better than more
119
+ * iterations do, at about the same cost when `iterations` is lowered to match. Defaults to 1.
120
+ */
121
+ readonly solverSteps?: number;
122
+ readonly allowSleep?: boolean;
123
+ }
124
+ type Vec = Float64Array;
125
+ export declare class RigidBody3D {
126
+ readonly id: number;
127
+ readonly type: BodyType3D;
128
+ readonly shape: ShapeDefinition3D;
129
+ readonly position: Vec;
130
+ /** Unit quaternion, xyzw. Call wake() after writing position or orientation directly. */
131
+ readonly quaternion: Float64Array<ArrayBuffer>;
132
+ readonly linearVelocity: Vec;
133
+ readonly angularVelocity: Vec;
134
+ readonly force: Vec;
135
+ readonly torque: Vec;
136
+ readonly mass: number;
137
+ readonly inverseMass: number;
138
+ restitution: number;
139
+ friction: number;
140
+ linearDamping: number;
141
+ angularDamping: number;
142
+ isTrigger: boolean;
143
+ layer: number;
144
+ mask: number;
145
+ fixedRotation: boolean;
146
+ continuous: boolean;
147
+ node: Object3D | undefined;
148
+ userData: unknown;
149
+ isSleeping: boolean;
150
+ /** @internal */ readonly rotation: Float64Array<ArrayBuffer>;
151
+ /** @internal */ readonly inverseInertiaLocal: Vec;
152
+ /** @internal */ readonly inverseInertiaWorld: Float64Array<ArrayBuffer>;
153
+ /** @internal */ readonly aabb: Float64Array<ArrayBuffer>;
154
+ /** @internal */ sleepTime: number;
155
+ /** @internal */ slot: number;
156
+ /** @internal */ world: PhysicsWorld3D | undefined;
157
+ /** @internal Stand-in bodies for the parts of a compound shape, kept at their world poses by refresh(). */
158
+ readonly parts: RigidBody3D[];
159
+ /** @internal Local placement of each part: position, then quaternion. */
160
+ readonly partPoses: Float64Array[];
161
+ /** @internal Half extents of the box around a compound, used to weigh it. */
162
+ readonly compoundHalf: Vec;
163
+ constructor(options: RigidBodyOptions3D);
164
+ wake(): void;
165
+ setPosition(x: number, y: number, z: number): this;
166
+ setQuaternion(x: number, y: number, z: number, w: number): this;
167
+ setLinearVelocity(x: number, y: number, z: number): this;
168
+ setAngularVelocity(x: number, y: number, z: number): this;
169
+ /** Accumulate a force through the center of mass; cleared after each step. */
170
+ applyForce(x: number, y: number, z: number): void;
171
+ applyTorque(x: number, y: number, z: number): void;
172
+ /** Change velocity at once; give `point` in world space to add spin. */
173
+ applyImpulse(x: number, y: number, z: number, point?: ArrayLike<number>): void;
174
+ /** @internal Recompute the rotation matrix, world inertia and bounds from the pose. */
175
+ refresh(): void;
176
+ }
177
+ export type JointType3D = 'point' | 'hinge' | 'fixed' | 'distance' | 'slider';
178
+ export interface JointOptions3D {
179
+ readonly type: JointType3D;
180
+ readonly bodyA: RigidBody3D;
181
+ /** Second body; leave out to pin bodyA to a fixed place in the world. */
182
+ readonly bodyB?: RigidBody3D;
183
+ /**
184
+ * World-space pivot when the joint is created. Defaults to bodyA's position.
185
+ * For 'distance' this is the attachment on bodyA.
186
+ */
187
+ readonly anchor?: readonly [number, number, number];
188
+ /** 'distance' only: world-space attachment on bodyB (or in the world). Defaults to bodyB's position. */
189
+ readonly anchorB?: readonly [number, number, number];
190
+ /**
191
+ * 'hinge': world-space direction of the hinge pin. 'point': the direction
192
+ * `coneLimit` is measured around. 'slider': the direction bodyA may travel. Defaults to +Y.
193
+ */
194
+ readonly axis?: readonly [number, number, number];
195
+ /**
196
+ * 'hinge': lowest and highest angle in radians, relative to the pose at creation; both within -PI..PI.
197
+ * 'slider': lowest and highest travel of bodyA along the axis, relative to where it was created.
198
+ */
199
+ readonly limits?: readonly [number, number];
200
+ /** 'hinge': turning speed in radians per second the motor drives toward. 'slider': travel speed along the axis. */
201
+ readonly motorSpeed?: number;
202
+ /** 'hinge' only: strongest torque the motor may use. Zero, the default, turns the motor off. */
203
+ readonly maxMotorTorque?: number;
204
+ /** 'slider' only: strongest force the motor may use. Zero, the default, turns the motor off. */
205
+ readonly maxMotorForce?: number;
206
+ /**
207
+ * 'distance' only: make the link a spring. `stiffness` is how many times per second it
208
+ * swings back and forth; `damping` is 0 for no loss and 1 for settling without overshoot.
209
+ */
210
+ readonly stiffness?: number;
211
+ readonly damping?: number;
212
+ /** 'point' only: largest angle in radians bodyB may swing away from `axis`. */
213
+ readonly coneLimit?: number;
214
+ /** 'distance' only: rest length; defaults to the distance between the anchors at creation. */
215
+ readonly length?: number;
216
+ /** 'distance' only: act like a rope that goes slack when shorter than its length. */
217
+ readonly rope?: boolean;
218
+ /** Let the two bodies collide with each other. Defaults to false. */
219
+ readonly collideConnected?: boolean;
220
+ }
221
+ interface JointPoint {
222
+ localA: Vec;
223
+ localB: Vec;
224
+ ra: Vec;
225
+ rb: Vec;
226
+ bias: Vec;
227
+ inverse: Float64Array;
228
+ }
229
+ /** A constraint between two bodies, or between a body and the world. Create it with world.createJoint(). */
230
+ export declare class Joint3D {
231
+ readonly type: JointType3D;
232
+ readonly bodyA: RigidBody3D;
233
+ readonly bodyB: RigidBody3D | undefined;
234
+ readonly collideConnected: boolean;
235
+ enabled: boolean;
236
+ /** 'distance' joints: rest length, and whether it only limits stretching. */
237
+ length: number;
238
+ rope: boolean;
239
+ /** 'hinge' joints: angle range in radians, or undefined for a free hinge. */
240
+ limits: [number, number] | undefined;
241
+ /** 'hinge' joints: target speed in radians per second, and the torque available to reach it (0 = off). 'slider' joints: travel speed. */
242
+ motorSpeed: number;
243
+ maxMotorTorque: number;
244
+ /** 'slider' joints: the force available to reach `motorSpeed` (0 = off). */
245
+ maxMotorForce: number;
246
+ /** 'distance' joints: swings per second of the spring (0 = rigid), and how quickly it settles. */
247
+ stiffness: number;
248
+ damping: number;
249
+ /** @internal */ readonly slide: Vec;
250
+ /** @internal */ slideMass: number;
251
+ /** 'point' joints: largest swing angle in radians, or undefined for none. */
252
+ coneLimit: number | undefined;
253
+ /** @internal */ readonly points: JointPoint[];
254
+ /** @internal */ readonly axisA: Vec;
255
+ /** @internal */ readonly axisB: Vec;
256
+ /** @internal */ readonly sideA: Vec;
257
+ /** @internal */ readonly sideB: Vec;
258
+ /** @internal */ readonly row: Vec;
259
+ /** @internal */ rowMass: number;
260
+ /** @internal */ rowArm: number;
261
+ /** @internal */ readonly rowDirection: Vec;
262
+ /** @internal */ readonly rowA: Vec;
263
+ /** @internal */ readonly rowB: Vec;
264
+ /** @internal */ rowLow: number;
265
+ /** @internal */ rowHigh: number;
266
+ /** @internal */ limitImpulse: number;
267
+ /** @internal */ limitImpulseHigh: number;
268
+ /** @internal */ motorImpulse: number;
269
+ /** @internal */ current: number;
270
+ /** @internal */ accumulated: number;
271
+ /** @internal */ world: PhysicsWorld3D | undefined;
272
+ constructor(options: JointOptions3D);
273
+ /**
274
+ * 'hinge' joints: how far bodyA has turned about the pin since creation,
275
+ * relative to bodyB or the world, in radians. 'point' joints: how far
276
+ * the two bodies have swung apart, measured between their copies of the axis.
277
+ */
278
+ /** 'slider' joints: how far bodyA has travelled along the axis since creation, relative to bodyB or the world. */
279
+ get translation(): number;
280
+ get angle(): number;
281
+ }
282
+ export declare class PhysicsWorld3D {
283
+ #private;
284
+ readonly gravity: Vec;
285
+ fixedStep: number;
286
+ maxSubSteps: number;
287
+ iterations: number;
288
+ solverSteps: number;
289
+ allowSleep: boolean;
290
+ /** Called when two bodies start or stop touching. Triggers report here too. */
291
+ onContactBegin: ((a: RigidBody3D, b: RigidBody3D) => void) | undefined;
292
+ onContactEnd: ((a: RigidBody3D, b: RigidBody3D) => void) | undefined;
293
+ /**
294
+ * Called after every step for each pair of solid bodies that pressed on each other, with
295
+ * where, in which direction and how hard: enough to pick a sound, deal damage or squash a shape.
296
+ */
297
+ onContact: ((contact: PhysicsContact3D) => void) | undefined;
298
+ constructor(options?: PhysicsWorldOptions3D);
299
+ get bodies(): readonly RigidBody3D[];
300
+ /** @internal A static body was repositioned: its place among the others is worked out again. */
301
+ staticMoved(body: RigidBody3D): void;
302
+ /** Visit every body whose bounds meet a box: planes, bodies that can move, then static ones. */
303
+ private near;
304
+ /** Contact points solved in the last step. */
305
+ get contactCount(): number;
306
+ addBody(body: RigidBody3D): RigidBody3D;
307
+ /** Create a body from options and add it. */
308
+ createBody(options: RigidBodyOptions3D): RigidBody3D;
309
+ get joints(): readonly Joint3D[];
310
+ /** Connect two bodies, or pin one to the world. Anchors are given in world space as the bodies stand now. */
311
+ createJoint(options: JointOptions3D): Joint3D;
312
+ removeJoint(joint: Joint3D): void;
313
+ private prepareJoints;
314
+ /**
315
+ * Set up the rotational equation of a joint. Turning impulses are applied
316
+ * as a push at the point where the more mobile body would pivot freely
317
+ * about the joint (its center of percussion), which leaves the pivot
318
+ * itself undisturbed and so settles in few iterations even for a small
319
+ * weight on a long arm.
320
+ */
321
+ private prepareRow;
322
+ private solveJoint;
323
+ removeBody(body: RigidBody3D): void;
324
+ /**
325
+ * Advance by `deltaSeconds` in fixed steps, carrying the remainder to the
326
+ * next call. Returns the number of steps taken.
327
+ */
328
+ step(deltaSeconds: number): number;
329
+ private syncNodes;
330
+ private fixedUpdate;
331
+ /**
332
+ * Share of this step's travel a fast body may make before its shape meets
333
+ * a surface it is not already resting on. It stops just touching, so the
334
+ * next step finds the contact and answers it with the body's full speed.
335
+ */
336
+ private sweep;
337
+ /**
338
+ * Walk `probe` along a unit direction and return how far it gets before touching one of
339
+ * the accepted bodies, or -1. The probe is left where it touched and the body it met in
340
+ * #castBody. With `skipTouching`, whatever the probe already rests on is not counted.
341
+ */
342
+ private cast;
343
+ private findContacts;
344
+ private testPair;
345
+ private pairKey;
346
+ /**
347
+ * Work out everything one solver direction needs, so the iterations that follow are plain
348
+ * sums and products. Returns the effective mass along that direction.
349
+ */
350
+ private prepareContactRow;
351
+ /** Velocity of b relative to a at the contact, along the direction stored at `at`. */
352
+ private rowVelocity;
353
+ private applyRow;
354
+ private solve;
355
+ /** Nearest solid body hit by a ray; triggers are skipped. `direction` need not be normalized. */
356
+ raycast(origin: ArrayLike<number>, direction: ArrayLike<number>, maxDistance?: number, mask?: number): PhysicsRaycastHit3D | undefined;
357
+ /** @internal Skip one body before selecting the nearest hit. */
358
+ [raycastExcludingBody3D](origin: ArrayLike<number>, direction: ArrayLike<number>, maxDistance: number, mask: number, excluded?: RigidBody3D): PhysicsRaycastHit3D | undefined;
359
+ /** Solid bodies whose shape touches a sphere; triggers are skipped. */
360
+ overlapSphere(center: ArrayLike<number>, radius: number, mask?: number): RigidBody3D[];
361
+ /**
362
+ * Move a shape along a unit direction and report the first body it
363
+ * touches: the distance travelled, the point of contact and the surface
364
+ * normal facing the shape. The path is walked in steps no longer than the
365
+ * shape's thinnest half and the touch refined between two steps, so
366
+ * anything thinner than that step may be passed over. Triggers are ignored.
367
+ */
368
+ shapeCast(shape: ShapeDefinition3D, origin: ArrayLike<number>, direction: ArrayLike<number>, maxDistance: number, mask?: number, quaternion?: ArrayLike<number>): PhysicsShapeCastHit3D | undefined;
369
+ /** @internal Contacts of a free-standing shape against the world, for the character controller. */
370
+ probe(body: RigidBody3D, mask: number, visit: (nx: number, ny: number, nz: number, depth: number, other: RigidBody3D) => void): void;
371
+ }
372
+ export interface CharacterControllerOptions3D {
373
+ readonly radius?: number;
374
+ /** Total height including both caps. */
375
+ readonly height?: number;
376
+ readonly position?: readonly [number, number, number];
377
+ /** Steepest walkable slope in radians. */
378
+ readonly slopeLimit?: number;
379
+ /** Gap kept from surfaces so the capsule never rests exactly in contact. */
380
+ readonly skin?: number;
381
+ readonly mask?: number;
382
+ readonly node?: Object3D;
383
+ }
384
+ /**
385
+ * Kinematic capsule that slides along the world instead of being simulated.
386
+ * Call move() with the displacement you want; it resolves penetration and
387
+ * reports whether the capsule stands on walkable ground.
388
+ */
389
+ export declare class CharacterController3D {
390
+ #private;
391
+ readonly world: PhysicsWorld3D;
392
+ readonly position: Vec;
393
+ readonly radius: number;
394
+ readonly height: number;
395
+ slopeLimit: number;
396
+ skin: number;
397
+ mask: number;
398
+ node: Object3D | undefined;
399
+ /** True when the last move ended on a walkable surface. */
400
+ isGrounded: boolean;
401
+ /** Normal of the ground under the capsule after the last move. */
402
+ readonly groundNormal: Vec;
403
+ /** Body standing under the capsule, when grounded. */
404
+ groundBody: RigidBody3D | undefined;
405
+ /** True when the last move was stopped by something overhead. */
406
+ hitCeiling: boolean;
407
+ /** Called for every obstacle the capsule is pushed out of during a move; the normal points from the capsule into the obstacle. */
408
+ onContact: ((body: RigidBody3D, nx: number, ny: number, nz: number, depth: number) => void) | undefined;
409
+ constructor(world: PhysicsWorld3D, options?: CharacterControllerOptions3D);
410
+ /** Move by a world-space displacement, sliding along anything in the way. */
411
+ move(dx: number, dy: number, dz: number): void;
412
+ }
413
+ export declare function createPhysicsWorld3D(options?: PhysicsWorldOptions3D): PhysicsWorld3D;
414
+ export declare function createCharacterController3D(world: PhysicsWorld3D, options?: CharacterControllerOptions3D): CharacterController3D;
415
+ export {};
416
+ //# sourceMappingURL=Physics3D.d.ts.map