@needle-tools/engine 4.4.0-beta → 4.4.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1056) hide show
  1. package/CHANGELOG.md +3607 -3604
  2. package/LICENSE.md +10 -10
  3. package/README.md +64 -64
  4. package/components.needle.json +1 -1
  5. package/dist/needle-engine.bundle.js +2256 -2254
  6. package/dist/needle-engine.bundle.light.js +2256 -2254
  7. package/dist/needle-engine.bundle.light.min.js +118 -118
  8. package/dist/needle-engine.bundle.light.umd.cjs +116 -116
  9. package/dist/needle-engine.bundle.min.js +118 -118
  10. package/dist/needle-engine.bundle.umd.cjs +116 -116
  11. package/dist/needle-engine.d.ts +130 -138
  12. package/dist/needle-engine.js +468 -467
  13. package/dist/needle-engine.light.d.ts +130 -138
  14. package/dist/needle-engine.light.js +468 -467
  15. package/dist/needle-engine.light.min.js +1 -1
  16. package/dist/needle-engine.light.umd.cjs +1 -1
  17. package/dist/needle-engine.min.js +1 -1
  18. package/dist/needle-engine.umd.cjs +1 -1
  19. package/dist/postprocessing.js +1673 -1527
  20. package/dist/postprocessing.light.js +1673 -1527
  21. package/dist/postprocessing.light.min.js +80 -66
  22. package/dist/postprocessing.light.umd.cjs +83 -69
  23. package/dist/postprocessing.min.js +80 -66
  24. package/dist/postprocessing.umd.cjs +83 -69
  25. package/dist/vendor.js +1 -1
  26. package/dist/vendor.light.js +1 -1
  27. package/lib/asap/needle-asap.d.ts +1 -1
  28. package/lib/asap/needle-asap.js +95 -95
  29. package/lib/asap/sessiongranted.d.ts +3 -3
  30. package/lib/asap/sessiongranted.js +65 -65
  31. package/lib/asap/utils.d.ts +1 -1
  32. package/lib/asap/utils.js +3 -3
  33. package/lib/engine/analytics/index.d.ts +6 -6
  34. package/lib/engine/analytics/index.js +12 -12
  35. package/lib/engine/analytics/lcp.d.ts +3 -3
  36. package/lib/engine/analytics/lcp.js +34 -34
  37. package/lib/engine/api.d.ts +81 -81
  38. package/lib/engine/api.js +80 -80
  39. package/lib/engine/assets/index.d.ts +11 -11
  40. package/lib/engine/assets/index.js +47 -47
  41. package/lib/engine/assets/static.d.ts +1 -1
  42. package/lib/engine/assets/static.js +4 -4
  43. package/lib/engine/codegen/register_types.d.ts +1 -1
  44. package/lib/engine/codegen/register_types.js +300 -298
  45. package/lib/engine/codegen/register_types.js.map +1 -1
  46. package/lib/engine/debug/debug.d.ts +15 -15
  47. package/lib/engine/debug/debug.js +44 -44
  48. package/lib/engine/debug/debug_console.d.ts +2 -2
  49. package/lib/engine/debug/debug_console.js +307 -307
  50. package/lib/engine/debug/debug_overlay.d.ts +22 -22
  51. package/lib/engine/debug/debug_overlay.js +316 -316
  52. package/lib/engine/debug/debug_spatial_console.d.ts +2 -2
  53. package/lib/engine/debug/debug_spatial_console.js +390 -390
  54. package/lib/engine/debug/index.d.ts +2 -2
  55. package/lib/engine/debug/index.js +2 -2
  56. package/lib/engine/engine_addressables.d.ts +166 -166
  57. package/lib/engine/engine_addressables.js +608 -608
  58. package/lib/engine/engine_animation.d.ts +43 -43
  59. package/lib/engine/engine_animation.js +133 -133
  60. package/lib/engine/engine_application.d.ts +40 -40
  61. package/lib/engine/engine_application.js +104 -104
  62. package/lib/engine/engine_assetdatabase.d.ts +25 -25
  63. package/lib/engine/engine_assetdatabase.js +344 -344
  64. package/lib/engine/engine_audio.d.ts +4 -4
  65. package/lib/engine/engine_audio.js +23 -23
  66. package/lib/engine/engine_camera.d.ts +13 -13
  67. package/lib/engine/engine_camera.js +30 -30
  68. package/lib/engine/engine_components.d.ts +110 -110
  69. package/lib/engine/engine_components.js +380 -380
  70. package/lib/engine/engine_components_internal.d.ts +9 -9
  71. package/lib/engine/engine_components_internal.js +36 -36
  72. package/lib/engine/engine_constants.d.ts +10 -10
  73. package/lib/engine/engine_constants.js +41 -41
  74. package/lib/engine/engine_context.d.ts +345 -345
  75. package/lib/engine/engine_context.js +1515 -1515
  76. package/lib/engine/engine_context_registry.d.ts +71 -71
  77. package/lib/engine/engine_context_registry.js +117 -117
  78. package/lib/engine/engine_coroutine.d.ts +35 -35
  79. package/lib/engine/engine_coroutine.js +52 -52
  80. package/lib/engine/engine_create_objects.d.ts +118 -118
  81. package/lib/engine/engine_create_objects.js +308 -308
  82. package/lib/engine/engine_default_parameters.d.ts +2 -2
  83. package/lib/engine/engine_default_parameters.js +3 -3
  84. package/lib/engine/engine_editor-sync.d.ts +21 -21
  85. package/lib/engine/engine_editor-sync.js +4 -4
  86. package/lib/engine/engine_element.d.ts +113 -113
  87. package/lib/engine/engine_element.js +830 -830
  88. package/lib/engine/engine_element_attributes.d.ts +72 -72
  89. package/lib/engine/engine_element_attributes.js +1 -1
  90. package/lib/engine/engine_element_extras.d.ts +6 -6
  91. package/lib/engine/engine_element_extras.js +13 -13
  92. package/lib/engine/engine_element_loading.d.ts +44 -44
  93. package/lib/engine/engine_element_loading.js +349 -349
  94. package/lib/engine/engine_element_overlay.d.ts +21 -21
  95. package/lib/engine/engine_element_overlay.js +166 -166
  96. package/lib/engine/engine_fileloader.d.ts +2 -2
  97. package/lib/engine/engine_fileloader.js +8 -8
  98. package/lib/engine/engine_gameobject.d.ts +68 -68
  99. package/lib/engine/engine_gameobject.js +591 -591
  100. package/lib/engine/engine_generic_utils.d.ts +1 -1
  101. package/lib/engine/engine_generic_utils.js +13 -13
  102. package/lib/engine/engine_gizmos.d.ts +149 -149
  103. package/lib/engine/engine_gizmos.js +530 -530
  104. package/lib/engine/engine_gltf.d.ts +12 -12
  105. package/lib/engine/engine_gltf.js +15 -15
  106. package/lib/engine/engine_gltf_builtin_components.d.ts +7 -7
  107. package/lib/engine/engine_gltf_builtin_components.js +341 -341
  108. package/lib/engine/engine_hot_reload.d.ts +7 -7
  109. package/lib/engine/engine_hot_reload.js +184 -184
  110. package/lib/engine/engine_input.d.ts +352 -352
  111. package/lib/engine/engine_input.js +1265 -1265
  112. package/lib/engine/engine_input_utils.d.ts +2 -2
  113. package/lib/engine/engine_input_utils.js +22 -22
  114. package/lib/engine/engine_instancing.d.ts +19 -19
  115. package/lib/engine/engine_instancing.js +39 -39
  116. package/lib/engine/engine_license.d.ts +9 -9
  117. package/lib/engine/engine_license.js +320 -320
  118. package/lib/engine/engine_lifecycle_api.d.ts +76 -76
  119. package/lib/engine/engine_lifecycle_api.js +99 -99
  120. package/lib/engine/engine_lifecycle_functions_internal.d.ts +32 -32
  121. package/lib/engine/engine_lifecycle_functions_internal.js +146 -146
  122. package/lib/engine/engine_lightdata.d.ts +23 -23
  123. package/lib/engine/engine_lightdata.js +91 -91
  124. package/lib/engine/engine_loaders.d.ts +13 -13
  125. package/lib/engine/engine_loaders.js +62 -62
  126. package/lib/engine/engine_lods.d.ts +31 -31
  127. package/lib/engine/engine_lods.js +146 -146
  128. package/lib/engine/engine_mainloop_utils.d.ts +32 -32
  129. package/lib/engine/engine_mainloop_utils.js +466 -466
  130. package/lib/engine/engine_math.d.ts +114 -114
  131. package/lib/engine/engine_math.js +247 -247
  132. package/lib/engine/engine_modules.d.ts +36 -36
  133. package/lib/engine/engine_modules.js +85 -85
  134. package/lib/engine/engine_networking.d.ts +252 -252
  135. package/lib/engine/engine_networking.js +743 -743
  136. package/lib/engine/engine_networking_auto.d.ts +24 -24
  137. package/lib/engine/engine_networking_auto.js +310 -310
  138. package/lib/engine/engine_networking_blob.d.ts +48 -48
  139. package/lib/engine/engine_networking_blob.js +212 -212
  140. package/lib/engine/engine_networking_files.d.ts +35 -35
  141. package/lib/engine/engine_networking_files.js +172 -172
  142. package/lib/engine/engine_networking_files_default_components.d.ts +6 -6
  143. package/lib/engine/engine_networking_files_default_components.js +42 -42
  144. package/lib/engine/engine_networking_instantiate.d.ts +100 -100
  145. package/lib/engine/engine_networking_instantiate.js +345 -345
  146. package/lib/engine/engine_networking_peer.d.ts +15 -15
  147. package/lib/engine/engine_networking_peer.js +132 -132
  148. package/lib/engine/engine_networking_streams.d.ts +123 -123
  149. package/lib/engine/engine_networking_streams.js +645 -645
  150. package/lib/engine/engine_networking_types.d.ts +22 -22
  151. package/lib/engine/engine_networking_types.js +7 -7
  152. package/lib/engine/engine_networking_utils.d.ts +2 -2
  153. package/lib/engine/engine_networking_utils.js +20 -20
  154. package/lib/engine/engine_networking_websocket.d.ts +1 -1
  155. package/lib/engine/engine_networking_websocket.js +2 -2
  156. package/lib/engine/engine_patcher.d.ts +10 -10
  157. package/lib/engine/engine_patcher.js +142 -142
  158. package/lib/engine/engine_physics.d.ts +152 -152
  159. package/lib/engine/engine_physics.js +645 -645
  160. package/lib/engine/engine_physics.types.d.ts +40 -40
  161. package/lib/engine/engine_physics.types.js +33 -33
  162. package/lib/engine/engine_physics_rapier.d.ts +147 -147
  163. package/lib/engine/engine_physics_rapier.js +1432 -1432
  164. package/lib/engine/engine_playerview.d.ts +26 -26
  165. package/lib/engine/engine_playerview.js +64 -64
  166. package/lib/engine/engine_scenelighting.d.ts +71 -71
  167. package/lib/engine/engine_scenelighting.js +226 -226
  168. package/lib/engine/engine_scenetools.d.ts +50 -50
  169. package/lib/engine/engine_scenetools.js +321 -321
  170. package/lib/engine/engine_serialization.d.ts +3 -3
  171. package/lib/engine/engine_serialization.js +3 -3
  172. package/lib/engine/engine_serialization_builtin_serializer.d.ts +72 -72
  173. package/lib/engine/engine_serialization_builtin_serializer.js +403 -403
  174. package/lib/engine/engine_serialization_core.d.ts +85 -85
  175. package/lib/engine/engine_serialization_core.js +602 -602
  176. package/lib/engine/engine_serialization_decorator.d.ts +23 -23
  177. package/lib/engine/engine_serialization_decorator.js +66 -66
  178. package/lib/engine/engine_setup.d.ts +1 -1
  179. package/lib/engine/engine_setup.js +2 -2
  180. package/lib/engine/engine_shaders.d.ts +53 -53
  181. package/lib/engine/engine_shaders.js +252 -252
  182. package/lib/engine/engine_shims.d.ts +4 -4
  183. package/lib/engine/engine_shims.js +24 -24
  184. package/lib/engine/engine_test_utils.d.ts +39 -39
  185. package/lib/engine/engine_test_utils.js +83 -83
  186. package/lib/engine/engine_texture.d.ts +28 -28
  187. package/lib/engine/engine_texture.js +64 -64
  188. package/lib/engine/engine_three_utils.d.ts +201 -201
  189. package/lib/engine/engine_three_utils.js +731 -731
  190. package/lib/engine/engine_time.d.ts +51 -51
  191. package/lib/engine/engine_time.js +82 -82
  192. package/lib/engine/engine_time_utils.d.ts +88 -88
  193. package/lib/engine/engine_time_utils.js +215 -215
  194. package/lib/engine/engine_tonemapping.d.ts +2 -2
  195. package/lib/engine/engine_tonemapping.js +194 -194
  196. package/lib/engine/engine_types.d.ts +572 -572
  197. package/lib/engine/engine_types.js +88 -88
  198. package/lib/engine/engine_typestore.d.ts +28 -28
  199. package/lib/engine/engine_typestore.js +55 -55
  200. package/lib/engine/engine_util_decorator.d.ts +13 -13
  201. package/lib/engine/engine_util_decorator.js +116 -116
  202. package/lib/engine/engine_utils.d.ts +266 -266
  203. package/lib/engine/engine_utils.js +878 -878
  204. package/lib/engine/engine_utils_format.d.ts +21 -21
  205. package/lib/engine/engine_utils_format.js +193 -193
  206. package/lib/engine/engine_utils_screenshot.d.ts +159 -159
  207. package/lib/engine/engine_utils_screenshot.js +513 -513
  208. package/lib/engine/engine_utils_screenshot.xr.d.ts +5 -5
  209. package/lib/engine/engine_utils_screenshot.xr.js +90 -90
  210. package/lib/engine/engine_xr.d.ts +1 -1
  211. package/lib/engine/engine_xr.js +1 -1
  212. package/lib/engine/export/gltf/Writers.d.ts +19 -19
  213. package/lib/engine/export/gltf/Writers.js +24 -24
  214. package/lib/engine/export/gltf/index.d.ts +11 -11
  215. package/lib/engine/export/gltf/index.js +123 -123
  216. package/lib/engine/export/index.d.ts +2 -2
  217. package/lib/engine/export/index.js +2 -2
  218. package/lib/engine/export/state.d.ts +7 -7
  219. package/lib/engine/export/state.js +17 -17
  220. package/lib/engine/export/utils.d.ts +2 -2
  221. package/lib/engine/export/utils.js +7 -7
  222. package/lib/engine/extensions/EXT_texture_exr.d.ts +8 -8
  223. package/lib/engine/extensions/EXT_texture_exr.js +32 -32
  224. package/lib/engine/extensions/NEEDLE_animator_controller_model.d.ts +122 -122
  225. package/lib/engine/extensions/NEEDLE_animator_controller_model.js +95 -95
  226. package/lib/engine/extensions/NEEDLE_components.d.ts +35 -35
  227. package/lib/engine/extensions/NEEDLE_components.js +220 -220
  228. package/lib/engine/extensions/NEEDLE_gameobject_data.d.ts +10 -10
  229. package/lib/engine/extensions/NEEDLE_gameobject_data.js +57 -57
  230. package/lib/engine/extensions/NEEDLE_lighting_settings.d.ts +37 -37
  231. package/lib/engine/extensions/NEEDLE_lighting_settings.js +157 -157
  232. package/lib/engine/extensions/NEEDLE_lightmaps.d.ts +18 -18
  233. package/lib/engine/extensions/NEEDLE_lightmaps.js +99 -99
  234. package/lib/engine/extensions/NEEDLE_persistent_assets.d.ts +11 -11
  235. package/lib/engine/extensions/NEEDLE_persistent_assets.js +63 -63
  236. package/lib/engine/extensions/NEEDLE_progressive.d.ts +1 -1
  237. package/lib/engine/extensions/NEEDLE_progressive.js +1 -1
  238. package/lib/engine/extensions/NEEDLE_render_objects.d.ts +13 -13
  239. package/lib/engine/extensions/NEEDLE_render_objects.js +159 -159
  240. package/lib/engine/extensions/NEEDLE_techniques_webgl.d.ts +38 -38
  241. package/lib/engine/extensions/NEEDLE_techniques_webgl.js +564 -564
  242. package/lib/engine/extensions/extension_resolver.d.ts +4 -4
  243. package/lib/engine/extensions/extension_resolver.js +1 -1
  244. package/lib/engine/extensions/extension_utils.d.ts +12 -12
  245. package/lib/engine/extensions/extension_utils.js +152 -152
  246. package/lib/engine/extensions/extensions.d.ts +31 -31
  247. package/lib/engine/extensions/extensions.js +103 -103
  248. package/lib/engine/extensions/index.d.ts +6 -6
  249. package/lib/engine/extensions/index.js +6 -6
  250. package/lib/engine/extensions/usage_tracker.d.ts +13 -13
  251. package/lib/engine/extensions/usage_tracker.js +65 -65
  252. package/lib/engine/js-extensions/Camera.d.ts +1 -1
  253. package/lib/engine/js-extensions/Camera.js +39 -39
  254. package/lib/engine/js-extensions/ExtensionUtils.d.ts +9 -9
  255. package/lib/engine/js-extensions/ExtensionUtils.js +67 -67
  256. package/lib/engine/js-extensions/Layers.d.ts +6 -6
  257. package/lib/engine/js-extensions/Layers.js +22 -22
  258. package/lib/engine/js-extensions/Object3D.d.ts +120 -120
  259. package/lib/engine/js-extensions/Object3D.js +136 -136
  260. package/lib/engine/js-extensions/RGBAColor.d.ts +22 -22
  261. package/lib/engine/js-extensions/RGBAColor.js +62 -62
  262. package/lib/engine/js-extensions/Vector.d.ts +3 -3
  263. package/lib/engine/js-extensions/Vector.js +13 -13
  264. package/lib/engine/js-extensions/index.d.ts +5 -5
  265. package/lib/engine/js-extensions/index.js +5 -5
  266. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.d.ts +4 -4
  267. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +75 -75
  268. package/lib/engine/shaders/shaderData.d.ts +55 -55
  269. package/lib/engine/shaders/shaderData.js +58 -58
  270. package/lib/engine/tests/test_utils.d.ts +2 -2
  271. package/lib/engine/tests/test_utils.js +53 -53
  272. package/lib/engine/webcomponents/WebXRButtons.d.ts +56 -56
  273. package/lib/engine/webcomponents/WebXRButtons.js +230 -230
  274. package/lib/engine/webcomponents/api.d.ts +5 -5
  275. package/lib/engine/webcomponents/api.js +4 -4
  276. package/lib/engine/webcomponents/buttons.d.ts +39 -39
  277. package/lib/engine/webcomponents/buttons.js +237 -237
  278. package/lib/engine/webcomponents/fonts.d.ts +9 -9
  279. package/lib/engine/webcomponents/fonts.js +32 -32
  280. package/lib/engine/webcomponents/icons.d.ts +9 -9
  281. package/lib/engine/webcomponents/icons.js +52 -52
  282. package/lib/engine/webcomponents/index.d.ts +1 -1
  283. package/lib/engine/webcomponents/index.js +1 -1
  284. package/lib/engine/webcomponents/logo-element.d.ts +10 -10
  285. package/lib/engine/webcomponents/logo-element.js +67 -67
  286. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.d.ts +37 -37
  287. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.js +513 -513
  288. package/lib/engine/webcomponents/needle menu/needle-menu.d.ts +151 -151
  289. package/lib/engine/webcomponents/needle menu/needle-menu.js +1018 -1018
  290. package/lib/engine/webcomponents/needle-button.d.ts +34 -34
  291. package/lib/engine/webcomponents/needle-button.js +161 -161
  292. package/lib/engine/xr/NeedleXRController.d.ts +313 -313
  293. package/lib/engine/xr/NeedleXRController.js +1008 -1008
  294. package/lib/engine/xr/NeedleXRSession.d.ts +339 -339
  295. package/lib/engine/xr/NeedleXRSession.js +1427 -1427
  296. package/lib/engine/xr/NeedleXRSync.d.ts +22 -22
  297. package/lib/engine/xr/NeedleXRSync.js +188 -188
  298. package/lib/engine/xr/SceneTransition.d.ts +18 -18
  299. package/lib/engine/xr/SceneTransition.js +69 -69
  300. package/lib/engine/xr/TempXRContext.d.ts +34 -34
  301. package/lib/engine/xr/TempXRContext.js +187 -187
  302. package/lib/engine/xr/XRRig.d.ts +7 -7
  303. package/lib/engine/xr/XRRig.js +1 -1
  304. package/lib/engine/xr/api.d.ts +6 -6
  305. package/lib/engine/xr/api.js +6 -6
  306. package/lib/engine/xr/events.d.ts +66 -66
  307. package/lib/engine/xr/events.js +93 -93
  308. package/lib/engine/xr/internal.d.ts +12 -12
  309. package/lib/engine/xr/internal.js +25 -25
  310. package/lib/engine/xr/usdz.d.ts +12 -12
  311. package/lib/engine/xr/usdz.js +29 -29
  312. package/lib/engine/xr/utils.d.ts +11 -11
  313. package/lib/engine/xr/utils.js +34 -34
  314. package/lib/engine-components/AlignmentConstraint.d.ts +10 -10
  315. package/lib/engine-components/AlignmentConstraint.js +39 -39
  316. package/lib/engine-components/Animation.d.ts +156 -156
  317. package/lib/engine-components/Animation.js +508 -508
  318. package/lib/engine-components/AnimationCurve.d.ts +40 -40
  319. package/lib/engine-components/AnimationCurve.js +159 -159
  320. package/lib/engine-components/AnimationUtils.d.ts +8 -8
  321. package/lib/engine-components/AnimationUtils.js +27 -27
  322. package/lib/engine-components/AnimationUtilsAutoplay.d.ts +1 -1
  323. package/lib/engine-components/AnimationUtilsAutoplay.js +39 -39
  324. package/lib/engine-components/Animator.d.ts +217 -217
  325. package/lib/engine-components/Animator.js +354 -354
  326. package/lib/engine-components/AnimatorController.d.ts +227 -227
  327. package/lib/engine-components/AnimatorController.js +1152 -1152
  328. package/lib/engine-components/AudioListener.d.ts +33 -33
  329. package/lib/engine-components/AudioListener.js +86 -86
  330. package/lib/engine-components/AudioSource.d.ts +217 -217
  331. package/lib/engine-components/AudioSource.js +627 -627
  332. package/lib/engine-components/AvatarLoader.d.ts +80 -80
  333. package/lib/engine-components/AvatarLoader.js +231 -231
  334. package/lib/engine-components/AxesHelper.d.ts +32 -32
  335. package/lib/engine-components/AxesHelper.js +67 -67
  336. package/lib/engine-components/BasicIKConstraint.d.ts +9 -9
  337. package/lib/engine-components/BasicIKConstraint.js +43 -43
  338. package/lib/engine-components/BoxCollider.d.ts +2 -2
  339. package/lib/engine-components/BoxCollider.js +2 -2
  340. package/lib/engine-components/BoxHelperComponent.d.ts +47 -47
  341. package/lib/engine-components/BoxHelperComponent.js +102 -102
  342. package/lib/engine-components/Camera.d.ts +231 -231
  343. package/lib/engine-components/Camera.js +694 -694
  344. package/lib/engine-components/CameraUtils.d.ts +1 -1
  345. package/lib/engine-components/CameraUtils.js +127 -127
  346. package/lib/engine-components/CameraUtils.js.map +1 -1
  347. package/lib/engine-components/CharacterController.d.ts +55 -55
  348. package/lib/engine-components/CharacterController.js +236 -236
  349. package/lib/engine-components/Collider.d.ts +188 -188
  350. package/lib/engine-components/Collider.js +369 -369
  351. package/lib/engine-components/Component.d.ts +792 -792
  352. package/lib/engine-components/Component.js +915 -915
  353. package/lib/engine-components/ContactShadows.d.ts +82 -82
  354. package/lib/engine-components/ContactShadows.js +430 -430
  355. package/lib/engine-components/DeleteBox.d.ts +19 -19
  356. package/lib/engine-components/DeleteBox.js +58 -58
  357. package/lib/engine-components/DeviceFlag.d.ts +16 -16
  358. package/lib/engine-components/DeviceFlag.js +47 -47
  359. package/lib/engine-components/DragControls.d.ts +170 -170
  360. package/lib/engine-components/DragControls.js +1421 -1421
  361. package/lib/engine-components/DropListener.d.ts +215 -215
  362. package/lib/engine-components/DropListener.js +630 -630
  363. package/lib/engine-components/Duplicatable.d.ts +35 -35
  364. package/lib/engine-components/Duplicatable.js +202 -202
  365. package/lib/engine-components/EventList.d.ts +54 -54
  366. package/lib/engine-components/EventList.js +232 -232
  367. package/lib/engine-components/EventTrigger.d.ts +33 -33
  368. package/lib/engine-components/EventTrigger.js +75 -75
  369. package/lib/engine-components/EventType.d.ts +22 -22
  370. package/lib/engine-components/EventType.js +23 -23
  371. package/lib/engine-components/Fog.d.ts +22 -22
  372. package/lib/engine-components/Fog.js +61 -61
  373. package/lib/engine-components/Gizmos.d.ts +17 -17
  374. package/lib/engine-components/Gizmos.js +64 -64
  375. package/lib/engine-components/GridHelper.d.ts +20 -20
  376. package/lib/engine-components/GridHelper.js +54 -54
  377. package/lib/engine-components/GroundProjection.d.ts +67 -67
  378. package/lib/engine-components/GroundProjection.js +343 -343
  379. package/lib/engine-components/Interactable.d.ts +12 -12
  380. package/lib/engine-components/Interactable.js +12 -12
  381. package/lib/engine-components/Joints.d.ts +19 -19
  382. package/lib/engine-components/Joints.js +51 -51
  383. package/lib/engine-components/LODGroup.d.ts +35 -35
  384. package/lib/engine-components/LODGroup.js +152 -152
  385. package/lib/engine-components/Light.d.ts +180 -180
  386. package/lib/engine-components/Light.js +535 -535
  387. package/lib/engine-components/LookAtConstraint.d.ts +19 -19
  388. package/lib/engine-components/LookAtConstraint.js +35 -35
  389. package/lib/engine-components/NeedleMenu.d.ts +50 -50
  390. package/lib/engine-components/NeedleMenu.js +92 -92
  391. package/lib/engine-components/NestedGltf.d.ts +25 -25
  392. package/lib/engine-components/NestedGltf.js +88 -88
  393. package/lib/engine-components/Networking.d.ts +54 -54
  394. package/lib/engine-components/Networking.js +112 -112
  395. package/lib/engine-components/OffsetConstraint.d.ts +14 -14
  396. package/lib/engine-components/OffsetConstraint.js +65 -65
  397. package/lib/engine-components/OrbitControls.d.ts +266 -266
  398. package/lib/engine-components/OrbitControls.js +1009 -1009
  399. package/lib/engine-components/PlayerColor.d.ts +19 -19
  400. package/lib/engine-components/PlayerColor.js +94 -94
  401. package/lib/engine-components/ReflectionProbe.d.ts +26 -26
  402. package/lib/engine-components/ReflectionProbe.js +194 -194
  403. package/lib/engine-components/Renderer.d.ts +153 -153
  404. package/lib/engine-components/Renderer.js +830 -830
  405. package/lib/engine-components/RendererInstancing.d.ts +140 -140
  406. package/lib/engine-components/RendererInstancing.js +744 -744
  407. package/lib/engine-components/RendererLightmap.d.ts +24 -24
  408. package/lib/engine-components/RendererLightmap.js +182 -182
  409. package/lib/engine-components/RigidBody.d.ts +155 -155
  410. package/lib/engine-components/RigidBody.js +517 -517
  411. package/lib/engine-components/SceneSwitcher.d.ts +263 -263
  412. package/lib/engine-components/SceneSwitcher.js +951 -951
  413. package/lib/engine-components/ScreenCapture.d.ts +144 -144
  414. package/lib/engine-components/ScreenCapture.js +547 -547
  415. package/lib/engine-components/ShadowCatcher.d.ts +33 -33
  416. package/lib/engine-components/ShadowCatcher.js +166 -166
  417. package/lib/engine-components/Skybox.d.ts +82 -82
  418. package/lib/engine-components/Skybox.js +448 -448
  419. package/lib/engine-components/SmoothFollow.d.ts +34 -34
  420. package/lib/engine-components/SmoothFollow.js +82 -82
  421. package/lib/engine-components/SpatialTrigger.d.ts +102 -102
  422. package/lib/engine-components/SpatialTrigger.js +225 -225
  423. package/lib/engine-components/SpectatorCamera.d.ts +111 -111
  424. package/lib/engine-components/SpectatorCamera.js +715 -715
  425. package/lib/engine-components/SphereCollider.d.ts +2 -2
  426. package/lib/engine-components/SphereCollider.js +2 -2
  427. package/lib/engine-components/SpriteRenderer.d.ts +132 -132
  428. package/lib/engine-components/SpriteRenderer.js +472 -472
  429. package/lib/engine-components/SyncedCamera.d.ts +41 -41
  430. package/lib/engine-components/SyncedCamera.js +199 -199
  431. package/lib/engine-components/SyncedRoom.d.ts +106 -106
  432. package/lib/engine-components/SyncedRoom.js +371 -371
  433. package/lib/engine-components/SyncedTransform.d.ts +88 -88
  434. package/lib/engine-components/SyncedTransform.js +326 -326
  435. package/lib/engine-components/TestRunner.d.ts +16 -16
  436. package/lib/engine-components/TestRunner.js +102 -102
  437. package/lib/engine-components/TransformGizmo.d.ts +75 -75
  438. package/lib/engine-components/TransformGizmo.js +209 -209
  439. package/lib/engine-components/VideoPlayer.d.ts +184 -184
  440. package/lib/engine-components/VideoPlayer.js +978 -978
  441. package/lib/engine-components/Voip.d.ts +67 -67
  442. package/lib/engine-components/Voip.js +360 -360
  443. package/lib/engine-components/api.d.ts +51 -51
  444. package/lib/engine-components/api.js +50 -50
  445. package/lib/engine-components/avatar/AvatarBlink_Simple.d.ts +11 -11
  446. package/lib/engine-components/avatar/AvatarBlink_Simple.js +76 -76
  447. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.d.ts +14 -14
  448. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.js +68 -68
  449. package/lib/engine-components/avatar/Avatar_Brain_LookAt.d.ts +29 -29
  450. package/lib/engine-components/avatar/Avatar_Brain_LookAt.js +121 -121
  451. package/lib/engine-components/avatar/Avatar_MouthShapes.d.ts +15 -15
  452. package/lib/engine-components/avatar/Avatar_MouthShapes.js +79 -79
  453. package/lib/engine-components/avatar/Avatar_MustacheShake.d.ts +9 -9
  454. package/lib/engine-components/avatar/Avatar_MustacheShake.js +29 -29
  455. package/lib/engine-components/codegen/components.d.ts +216 -215
  456. package/lib/engine-components/codegen/components.js +218 -217
  457. package/lib/engine-components/codegen/components.js.map +1 -1
  458. package/lib/engine-components/debug/LogStats.d.ts +5 -5
  459. package/lib/engine-components/debug/LogStats.js +18 -18
  460. package/lib/engine-components/export/gltf/GltfExport.d.ts +30 -30
  461. package/lib/engine-components/export/gltf/GltfExport.js +246 -246
  462. package/lib/engine-components/export/gltf/index.d.ts +1 -1
  463. package/lib/engine-components/export/gltf/index.js +1 -1
  464. package/lib/engine-components/export/index.d.ts +1 -1
  465. package/lib/engine-components/export/index.js +1 -1
  466. package/lib/engine-components/export/usdz/Extension.d.ts +22 -22
  467. package/lib/engine-components/export/usdz/Extension.js +1 -1
  468. package/lib/engine-components/export/usdz/ThreeUSDZExporter.d.ts +160 -160
  469. package/lib/engine-components/export/usdz/ThreeUSDZExporter.js +1782 -1782
  470. package/lib/engine-components/export/usdz/USDZExporter.d.ts +130 -130
  471. package/lib/engine-components/export/usdz/USDZExporter.js +663 -663
  472. package/lib/engine-components/export/usdz/extensions/Animation.d.ts +106 -106
  473. package/lib/engine-components/export/usdz/extensions/Animation.js +1071 -1071
  474. package/lib/engine-components/export/usdz/extensions/DocumentExtension.d.ts +5 -5
  475. package/lib/engine-components/export/usdz/extensions/DocumentExtension.js +6 -6
  476. package/lib/engine-components/export/usdz/extensions/USDZText.d.ts +54 -54
  477. package/lib/engine-components/export/usdz/extensions/USDZText.js +203 -203
  478. package/lib/engine-components/export/usdz/extensions/USDZUI.d.ts +8 -8
  479. package/lib/engine-components/export/usdz/extensions/USDZUI.js +157 -157
  480. package/lib/engine-components/export/usdz/extensions/behavior/Actions.d.ts +30 -30
  481. package/lib/engine-components/export/usdz/extensions/behavior/Actions.js +88 -88
  482. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.d.ts +10 -10
  483. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.js +86 -86
  484. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.d.ts +28 -28
  485. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.js +290 -290
  486. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.d.ts +190 -190
  487. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.js +1060 -1060
  488. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.d.ts +135 -135
  489. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.js +548 -548
  490. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.d.ts +7 -7
  491. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.js +115 -115
  492. package/lib/engine-components/export/usdz/index.d.ts +3 -3
  493. package/lib/engine-components/export/usdz/index.js +2 -2
  494. package/lib/engine-components/export/usdz/utils/animationutils.d.ts +7 -7
  495. package/lib/engine-components/export/usdz/utils/animationutils.js +163 -163
  496. package/lib/engine-components/export/usdz/utils/quicklook.d.ts +2 -2
  497. package/lib/engine-components/export/usdz/utils/quicklook.js +43 -43
  498. package/lib/engine-components/particlesystem/ParticleSystem.d.ts +177 -177
  499. package/lib/engine-components/particlesystem/ParticleSystem.js +1176 -1176
  500. package/lib/engine-components/particlesystem/ParticleSystemModules.d.ts +526 -526
  501. package/lib/engine-components/particlesystem/ParticleSystemModules.js +1930 -1930
  502. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.d.ts +25 -25
  503. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.js +87 -87
  504. package/lib/engine-components/particlesystem/api.d.ts +2 -2
  505. package/lib/engine-components/particlesystem/api.js +2 -2
  506. package/lib/engine-components/postprocessing/Effects/Antialiasing.d.ts +17 -17
  507. package/lib/engine-components/postprocessing/Effects/Antialiasing.js +50 -50
  508. package/lib/engine-components/postprocessing/Effects/BloomEffect.d.ts +46 -46
  509. package/lib/engine-components/postprocessing/Effects/BloomEffect.js +113 -113
  510. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.d.ts +11 -11
  511. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.js +39 -39
  512. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.d.ts +15 -15
  513. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.js +92 -92
  514. package/lib/engine-components/postprocessing/Effects/DepthOfField.d.ts +25 -25
  515. package/lib/engine-components/postprocessing/Effects/DepthOfField.js +104 -104
  516. package/lib/engine-components/postprocessing/Effects/EffectWrapper.d.ts +12 -12
  517. package/lib/engine-components/postprocessing/Effects/EffectWrapper.js +18 -18
  518. package/lib/engine-components/postprocessing/Effects/Pixelation.d.ts +11 -11
  519. package/lib/engine-components/postprocessing/Effects/Pixelation.js +32 -32
  520. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.d.ts +18 -18
  521. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.js +91 -91
  522. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.d.ts +70 -70
  523. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.js +175 -175
  524. package/lib/engine-components/postprocessing/Effects/Sharpening.d.ts +17 -17
  525. package/lib/engine-components/postprocessing/Effects/Sharpening.js +123 -123
  526. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.d.ts +17 -17
  527. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.js +70 -70
  528. package/lib/engine-components/postprocessing/Effects/Tonemapping.d.ts +26 -26
  529. package/lib/engine-components/postprocessing/Effects/Tonemapping.js +138 -138
  530. package/lib/engine-components/postprocessing/Effects/Vignette.d.ts +15 -15
  531. package/lib/engine-components/postprocessing/Effects/Vignette.js +60 -60
  532. package/lib/engine-components/postprocessing/PostProcessingEffect.d.ts +72 -72
  533. package/lib/engine-components/postprocessing/PostProcessingEffect.js +149 -149
  534. package/lib/engine-components/postprocessing/PostProcessingHandler.d.ts +25 -25
  535. package/lib/engine-components/postprocessing/PostProcessingHandler.js +350 -350
  536. package/lib/engine-components/postprocessing/Volume.d.ts +89 -89
  537. package/lib/engine-components/postprocessing/Volume.js +367 -367
  538. package/lib/engine-components/postprocessing/VolumeParameter.d.ts +26 -26
  539. package/lib/engine-components/postprocessing/VolumeParameter.js +136 -136
  540. package/lib/engine-components/postprocessing/VolumeProfile.d.ts +15 -15
  541. package/lib/engine-components/postprocessing/VolumeProfile.js +60 -60
  542. package/lib/engine-components/postprocessing/index.d.ts +5 -5
  543. package/lib/engine-components/postprocessing/index.js +5 -5
  544. package/lib/engine-components/postprocessing/utils.d.ts +11 -11
  545. package/lib/engine-components/postprocessing/utils.js +37 -37
  546. package/lib/engine-components/timeline/PlayableDirector.d.ts +163 -163
  547. package/lib/engine-components/timeline/PlayableDirector.js +686 -686
  548. package/lib/engine-components/timeline/SignalAsset.d.ts +24 -24
  549. package/lib/engine-components/timeline/SignalAsset.js +130 -130
  550. package/lib/engine-components/timeline/TimelineModels.d.ts +89 -89
  551. package/lib/engine-components/timeline/TimelineModels.js +22 -22
  552. package/lib/engine-components/timeline/TimelineTracks.d.ts +110 -110
  553. package/lib/engine-components/timeline/TimelineTracks.js +879 -879
  554. package/lib/engine-components/timeline/index.d.ts +4 -4
  555. package/lib/engine-components/timeline/index.js +3 -3
  556. package/lib/engine-components/ui/BaseUIComponent.d.ts +49 -49
  557. package/lib/engine-components/ui/BaseUIComponent.js +170 -170
  558. package/lib/engine-components/ui/Button.d.ts +64 -64
  559. package/lib/engine-components/ui/Button.js +315 -315
  560. package/lib/engine-components/ui/Canvas.d.ts +74 -74
  561. package/lib/engine-components/ui/Canvas.js +407 -407
  562. package/lib/engine-components/ui/CanvasGroup.d.ts +19 -19
  563. package/lib/engine-components/ui/CanvasGroup.js +58 -58
  564. package/lib/engine-components/ui/EventSystem.d.ts +125 -125
  565. package/lib/engine-components/ui/EventSystem.js +764 -764
  566. package/lib/engine-components/ui/Graphic.d.ts +55 -55
  567. package/lib/engine-components/ui/Graphic.js +254 -254
  568. package/lib/engine-components/ui/Image.d.ts +35 -35
  569. package/lib/engine-components/ui/Image.js +116 -116
  570. package/lib/engine-components/ui/InputField.d.ts +42 -42
  571. package/lib/engine-components/ui/InputField.js +268 -268
  572. package/lib/engine-components/ui/Interfaces.d.ts +38 -38
  573. package/lib/engine-components/ui/Interfaces.js +12 -12
  574. package/lib/engine-components/ui/Layout.d.ts +84 -84
  575. package/lib/engine-components/ui/Layout.js +330 -330
  576. package/lib/engine-components/ui/Outline.d.ts +7 -7
  577. package/lib/engine-components/ui/Outline.js +20 -20
  578. package/lib/engine-components/ui/PointerEvents.d.ts +115 -115
  579. package/lib/engine-components/ui/PointerEvents.js +145 -145
  580. package/lib/engine-components/ui/RaycastUtils.d.ts +11 -11
  581. package/lib/engine-components/ui/RaycastUtils.js +67 -67
  582. package/lib/engine-components/ui/Raycaster.d.ts +30 -30
  583. package/lib/engine-components/ui/Raycaster.js +95 -95
  584. package/lib/engine-components/ui/RectTransform.d.ts +61 -61
  585. package/lib/engine-components/ui/RectTransform.js +353 -353
  586. package/lib/engine-components/ui/SpatialHtml.d.ts +8 -8
  587. package/lib/engine-components/ui/SpatialHtml.js +79 -79
  588. package/lib/engine-components/ui/Text.d.ts +78 -78
  589. package/lib/engine-components/ui/Text.js +539 -539
  590. package/lib/engine-components/ui/Utils.d.ts +24 -24
  591. package/lib/engine-components/ui/Utils.js +90 -90
  592. package/lib/engine-components/ui/index.d.ts +1 -1
  593. package/lib/engine-components/ui/index.js +1 -1
  594. package/lib/engine-components/utils/EnvironmentScene.d.ts +5 -5
  595. package/lib/engine-components/utils/EnvironmentScene.js +205 -205
  596. package/lib/engine-components/utils/EnvironmentScene.js.map +1 -1
  597. package/lib/engine-components/utils/LookAt.d.ts +31 -31
  598. package/lib/engine-components/utils/LookAt.js +82 -82
  599. package/lib/engine-components/utils/OpenURL.d.ts +42 -42
  600. package/lib/engine-components/utils/OpenURL.js +119 -119
  601. package/lib/engine-components/webxr/Avatar.d.ts +25 -25
  602. package/lib/engine-components/webxr/Avatar.js +255 -255
  603. package/lib/engine-components/webxr/TeleportTarget.d.ts +7 -7
  604. package/lib/engine-components/webxr/TeleportTarget.js +7 -7
  605. package/lib/engine-components/webxr/WebARCameraBackground.d.ts +30 -30
  606. package/lib/engine-components/webxr/WebARCameraBackground.js +155 -155
  607. package/lib/engine-components/webxr/WebARSessionRoot.d.ts +98 -98
  608. package/lib/engine-components/webxr/WebARSessionRoot.js +770 -770
  609. package/lib/engine-components/webxr/WebXR.d.ts +232 -232
  610. package/lib/engine-components/webxr/WebXR.js +561 -561
  611. package/lib/engine-components/webxr/WebXRAvatar.d.ts +27 -27
  612. package/lib/engine-components/webxr/WebXRAvatar.js +44 -44
  613. package/lib/engine-components/webxr/WebXRImageTracking.d.ts +86 -86
  614. package/lib/engine-components/webxr/WebXRImageTracking.js +470 -470
  615. package/lib/engine-components/webxr/WebXRPlaneTracking.d.ts +92 -92
  616. package/lib/engine-components/webxr/WebXRPlaneTracking.js +500 -500
  617. package/lib/engine-components/webxr/WebXRRig.d.ts +32 -32
  618. package/lib/engine-components/webxr/WebXRRig.js +72 -72
  619. package/lib/engine-components/webxr/XRFlag.d.ts +38 -38
  620. package/lib/engine-components/webxr/XRFlag.js +139 -139
  621. package/lib/engine-components/webxr/controllers/XRControllerFollow.d.ts +47 -47
  622. package/lib/engine-components/webxr/controllers/XRControllerFollow.js +120 -120
  623. package/lib/engine-components/webxr/controllers/XRControllerModel.d.ts +43 -43
  624. package/lib/engine-components/webxr/controllers/XRControllerModel.js +351 -351
  625. package/lib/engine-components/webxr/controllers/XRControllerMovement.d.ts +78 -78
  626. package/lib/engine-components/webxr/controllers/XRControllerMovement.js +506 -506
  627. package/lib/engine-components/webxr/index.d.ts +3 -3
  628. package/lib/engine-components/webxr/index.js +3 -3
  629. package/lib/engine-components/webxr/types.d.ts +3 -3
  630. package/lib/engine-components/webxr/types.js +1 -1
  631. package/lib/engine-components-experimental/Presentation.d.ts +6 -6
  632. package/lib/engine-components-experimental/Presentation.js +9 -9
  633. package/lib/engine-components-experimental/api.d.ts +4 -4
  634. package/lib/engine-components-experimental/api.js +4 -4
  635. package/lib/engine-components-experimental/networking/PlayerSync.d.ts +156 -156
  636. package/lib/engine-components-experimental/networking/PlayerSync.js +377 -377
  637. package/lib/engine-schemes/api.d.ts +12 -12
  638. package/lib/engine-schemes/api.js +12 -12
  639. package/lib/engine-schemes/schemes.d.ts +7 -7
  640. package/lib/engine-schemes/schemes.js +19 -19
  641. package/lib/engine-schemes/synced-camera-model.d.ts +25 -25
  642. package/lib/engine-schemes/synced-camera-model.js +67 -67
  643. package/lib/engine-schemes/synced-transform-model.d.ts +31 -31
  644. package/lib/engine-schemes/synced-transform-model.js +66 -66
  645. package/lib/engine-schemes/transform.d.ts +12 -12
  646. package/lib/engine-schemes/transform.js +39 -39
  647. package/lib/engine-schemes/vec2.d.ts +10 -10
  648. package/lib/engine-schemes/vec2.js +25 -25
  649. package/lib/engine-schemes/vec3.d.ts +11 -11
  650. package/lib/engine-schemes/vec3.js +29 -29
  651. package/lib/engine-schemes/vec4.d.ts +12 -12
  652. package/lib/engine-schemes/vec4.js +33 -33
  653. package/lib/engine-schemes/vr-user-state-buffer.d.ts +37 -37
  654. package/lib/engine-schemes/vr-user-state-buffer.js +110 -110
  655. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.d.ts +6 -6
  656. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.js +45 -45
  657. package/lib/needle-engine.d.ts +7 -7
  658. package/lib/needle-engine.js +64 -64
  659. package/package.json +1 -1
  660. package/plugins/common/buildinfo.js +64 -63
  661. package/plugins/common/cloud.js +2 -0
  662. package/plugins/common/config.cjs +31 -31
  663. package/plugins/common/config.js +35 -35
  664. package/plugins/common/files.js +31 -31
  665. package/plugins/common/generator.js +10 -10
  666. package/plugins/common/license.js +317 -224
  667. package/plugins/common/npm.js +15 -15
  668. package/plugins/common/timers.js +7 -7
  669. package/plugins/common/version.js +37 -37
  670. package/plugins/gltf-packer.mjs +1 -1
  671. package/plugins/next/alias.cjs +39 -39
  672. package/plugins/next/license.cjs +18 -18
  673. package/plugins/next/meshbvhworker.cjs +18 -18
  674. package/plugins/next/next.js +128 -128
  675. package/plugins/types/index.d.ts +2 -2
  676. package/plugins/types/license.d.ts +24 -24
  677. package/plugins/types/needleConfig.d.ts +27 -27
  678. package/plugins/types/userconfig.d.ts +105 -105
  679. package/plugins/types/webmanifest.d.ts +32 -32
  680. package/plugins/vite/alias.js +174 -174
  681. package/plugins/vite/asap.js +245 -245
  682. package/plugins/vite/build-pipeline.js +355 -354
  683. package/plugins/vite/build.js +19 -19
  684. package/plugins/vite/buildinfo.js +41 -41
  685. package/plugins/vite/config.js +106 -106
  686. package/plugins/vite/copyfiles.js +138 -138
  687. package/plugins/vite/defines.js +66 -66
  688. package/plugins/vite/dependencies.js +213 -213
  689. package/plugins/vite/dependency-watcher.js +231 -231
  690. package/plugins/vite/drop-client.js +76 -76
  691. package/plugins/vite/drop.js +87 -87
  692. package/plugins/vite/editor-connection.js +124 -124
  693. package/plugins/vite/facebook-instant-games.js +99 -99
  694. package/plugins/vite/gzip.js +5 -5
  695. package/plugins/vite/imports-logger.js +143 -143
  696. package/plugins/vite/index.js +139 -139
  697. package/plugins/vite/license.js +55 -55
  698. package/plugins/vite/meta.js +163 -163
  699. package/plugins/vite/npm.js +7 -7
  700. package/plugins/vite/peer.js +29 -29
  701. package/plugins/vite/poster-client.js +73 -73
  702. package/plugins/vite/poster.js +79 -79
  703. package/plugins/vite/pwa.js +604 -604
  704. package/plugins/vite/reload-client.js +15 -15
  705. package/plugins/vite/reload.js +363 -363
  706. package/plugins/vite/server.js +66 -66
  707. package/plugins/vite/transform-codegen.js +55 -55
  708. package/plugins/vite/transform.js +31 -31
  709. package/plugins/vite/vite-4.4-hack.js +31 -31
  710. package/src/asap/needle-asap.ts +111 -111
  711. package/src/asap/sessiongranted.ts +75 -75
  712. package/src/asap/utils.ts +4 -4
  713. package/src/engine/analytics/index.ts +10 -10
  714. package/src/engine/analytics/lcp.ts +35 -35
  715. package/src/engine/api.ts +81 -81
  716. package/src/engine/assets/index.ts +59 -59
  717. package/src/engine/assets/static.js +5 -5
  718. package/src/engine/codegen/register_types.ts +300 -298
  719. package/src/engine/debug/debug.ts +51 -51
  720. package/src/engine/debug/debug_console.ts +333 -333
  721. package/src/engine/debug/debug_overlay.ts +332 -332
  722. package/src/engine/debug/debug_spatial_console.ts +429 -429
  723. package/src/engine/debug/index.ts +1 -1
  724. package/src/engine/engine_addressables.ts +679 -679
  725. package/src/engine/engine_animation.ts +145 -145
  726. package/src/engine/engine_application.ts +113 -113
  727. package/src/engine/engine_assetdatabase.ts +387 -387
  728. package/src/engine/engine_audio.ts +24 -24
  729. package/src/engine/engine_camera.ts +39 -39
  730. package/src/engine/engine_components.ts +373 -373
  731. package/src/engine/engine_components_internal.ts +40 -40
  732. package/src/engine/engine_constants.ts +52 -52
  733. package/src/engine/engine_context.ts +1662 -1662
  734. package/src/engine/engine_context_registry.ts +129 -129
  735. package/src/engine/engine_coroutine.ts +54 -54
  736. package/src/engine/engine_create_objects.ts +398 -398
  737. package/src/engine/engine_default_parameters.ts +3 -3
  738. package/src/engine/engine_editor-sync.ts +28 -28
  739. package/src/engine/engine_element.ts +871 -871
  740. package/src/engine/engine_element_attributes.ts +85 -85
  741. package/src/engine/engine_element_extras.ts +16 -16
  742. package/src/engine/engine_element_loading.ts +381 -381
  743. package/src/engine/engine_element_overlay.ts +186 -186
  744. package/src/engine/engine_fileloader.js +9 -9
  745. package/src/engine/engine_gameobject.ts +684 -684
  746. package/src/engine/engine_generic_utils.js +13 -13
  747. package/src/engine/engine_gizmos.ts +577 -577
  748. package/src/engine/engine_gltf.ts +29 -29
  749. package/src/engine/engine_gltf_builtin_components.ts +403 -403
  750. package/src/engine/engine_hot_reload.ts +198 -198
  751. package/src/engine/engine_input.ts +1460 -1460
  752. package/src/engine/engine_input_utils.ts +23 -23
  753. package/src/engine/engine_instancing.ts +45 -45
  754. package/src/engine/engine_license.ts +329 -329
  755. package/src/engine/engine_lifecycle_api.ts +106 -106
  756. package/src/engine/engine_lifecycle_functions_internal.ts +193 -193
  757. package/src/engine/engine_lightdata.ts +117 -117
  758. package/src/engine/engine_loaders.ts +82 -82
  759. package/src/engine/engine_lods.ts +168 -168
  760. package/src/engine/engine_mainloop_utils.ts +472 -472
  761. package/src/engine/engine_math.ts +282 -282
  762. package/src/engine/engine_modules.ts +83 -83
  763. package/src/engine/engine_networking.ts +841 -841
  764. package/src/engine/engine_networking_auto.ts +352 -352
  765. package/src/engine/engine_networking_blob.ts +254 -254
  766. package/src/engine/engine_networking_files.ts +217 -217
  767. package/src/engine/engine_networking_files_default_components.ts +58 -58
  768. package/src/engine/engine_networking_instantiate.ts +419 -419
  769. package/src/engine/engine_networking_peer.ts +159 -159
  770. package/src/engine/engine_networking_streams.ts +713 -713
  771. package/src/engine/engine_networking_types.ts +24 -24
  772. package/src/engine/engine_networking_utils.ts +23 -23
  773. package/src/engine/engine_networking_websocket.ts +2 -2
  774. package/src/engine/engine_patcher.ts +199 -199
  775. package/src/engine/engine_physics.ts +783 -783
  776. package/src/engine/engine_physics.types.ts +46 -46
  777. package/src/engine/engine_physics_rapier.ts +1579 -1579
  778. package/src/engine/engine_playerview.ts +80 -80
  779. package/src/engine/engine_scenelighting.ts +294 -294
  780. package/src/engine/engine_scenetools.ts +365 -365
  781. package/src/engine/engine_serialization.ts +2 -2
  782. package/src/engine/engine_serialization_builtin_serializer.ts +473 -473
  783. package/src/engine/engine_serialization_core.ts +705 -705
  784. package/src/engine/engine_serialization_decorator.ts +80 -80
  785. package/src/engine/engine_setup.ts +1 -1
  786. package/src/engine/engine_shaders.ts +267 -267
  787. package/src/engine/engine_shims.ts +32 -32
  788. package/src/engine/engine_test_utils.ts +109 -109
  789. package/src/engine/engine_texture.ts +82 -82
  790. package/src/engine/engine_three_utils.ts +849 -849
  791. package/src/engine/engine_time.ts +94 -94
  792. package/src/engine/engine_time_utils.ts +237 -237
  793. package/src/engine/engine_tonemapping.ts +210 -210
  794. package/src/engine/engine_types.ts +714 -714
  795. package/src/engine/engine_typestore.ts +63 -63
  796. package/src/engine/engine_util_decorator.ts +136 -136
  797. package/src/engine/engine_utils.ts +972 -972
  798. package/src/engine/engine_utils_format.ts +212 -212
  799. package/src/engine/engine_utils_screenshot.ts +698 -698
  800. package/src/engine/engine_utils_screenshot.xr.ts +103 -103
  801. package/src/engine/export/gltf/Writers.ts +34 -34
  802. package/src/engine/export/gltf/index.ts +158 -158
  803. package/src/engine/export/index.ts +2 -2
  804. package/src/engine/export/state.ts +19 -19
  805. package/src/engine/export/utils.ts +9 -9
  806. package/src/engine/extensions/EXT_texture_exr.ts +50 -50
  807. package/src/engine/extensions/NEEDLE_animator_controller_model.ts +195 -195
  808. package/src/engine/extensions/NEEDLE_components.ts +268 -268
  809. package/src/engine/extensions/NEEDLE_gameobject_data.ts +81 -81
  810. package/src/engine/extensions/NEEDLE_lighting_settings.ts +185 -185
  811. package/src/engine/extensions/NEEDLE_lightmaps.ts +119 -119
  812. package/src/engine/extensions/NEEDLE_persistent_assets.ts +76 -76
  813. package/src/engine/extensions/NEEDLE_render_objects.ts +209 -209
  814. package/src/engine/extensions/NEEDLE_techniques_webgl.ts +640 -640
  815. package/src/engine/extensions/extension_resolver.ts +4 -4
  816. package/src/engine/extensions/extension_utils.ts +166 -166
  817. package/src/engine/extensions/extensions.ts +135 -135
  818. package/src/engine/extensions/index.ts +5 -5
  819. package/src/engine/extensions/usage_tracker.ts +100 -100
  820. package/src/engine/js-extensions/Camera.ts +37 -37
  821. package/src/engine/js-extensions/ExtensionUtils.ts +85 -85
  822. package/src/engine/js-extensions/Layers.ts +23 -23
  823. package/src/engine/js-extensions/Object3D.ts +296 -296
  824. package/src/engine/js-extensions/RGBAColor.ts +75 -75
  825. package/src/engine/js-extensions/Vector.ts +18 -18
  826. package/src/engine/js-extensions/index.ts +4 -4
  827. package/src/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +122 -122
  828. package/src/engine/shaders/shaderData.ts +67 -67
  829. package/src/engine/tests/test_utils.ts +63 -63
  830. package/src/engine/webcomponents/WebXRButtons.ts +260 -260
  831. package/src/engine/webcomponents/api.ts +6 -6
  832. package/src/engine/webcomponents/buttons.ts +262 -262
  833. package/src/engine/webcomponents/fonts.ts +41 -41
  834. package/src/engine/webcomponents/icons.ts +57 -57
  835. package/src/engine/webcomponents/index.ts +1 -1
  836. package/src/engine/webcomponents/logo-element.ts +78 -78
  837. package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts +573 -573
  838. package/src/engine/webcomponents/needle menu/needle-menu.ts +1107 -1107
  839. package/src/engine/webcomponents/needle-button.ts +181 -181
  840. package/src/engine/xr/NeedleXRController.ts +1126 -1126
  841. package/src/engine/xr/NeedleXRSession.ts +1585 -1585
  842. package/src/engine/xr/NeedleXRSync.ts +220 -220
  843. package/src/engine/xr/SceneTransition.ts +78 -78
  844. package/src/engine/xr/TempXRContext.ts +216 -216
  845. package/src/engine/xr/XRRig.ts +9 -9
  846. package/src/engine/xr/api.ts +5 -5
  847. package/src/engine/xr/events.ts +102 -102
  848. package/src/engine/xr/internal.ts +34 -34
  849. package/src/engine/xr/usdz.ts +30 -30
  850. package/src/engine/xr/utils.ts +39 -39
  851. package/src/engine-components/AlignmentConstraint.ts +36 -36
  852. package/src/engine-components/Animation.ts +557 -557
  853. package/src/engine-components/AnimationCurve.ts +150 -150
  854. package/src/engine-components/AnimationUtils.ts +28 -28
  855. package/src/engine-components/AnimationUtilsAutoplay.ts +43 -43
  856. package/src/engine-components/Animator.ts +397 -397
  857. package/src/engine-components/AnimatorController.ts +1293 -1293
  858. package/src/engine-components/AudioListener.ts +92 -92
  859. package/src/engine-components/AudioSource.ts +639 -639
  860. package/src/engine-components/AvatarLoader.ts +263 -263
  861. package/src/engine-components/AxesHelper.ts +59 -59
  862. package/src/engine-components/BasicIKConstraint.ts +54 -54
  863. package/src/engine-components/BoxCollider.ts +1 -1
  864. package/src/engine-components/BoxHelperComponent.ts +114 -114
  865. package/src/engine-components/Camera.ts +707 -707
  866. package/src/engine-components/CameraUtils.ts +142 -144
  867. package/src/engine-components/CharacterController.ts +253 -253
  868. package/src/engine-components/Collider.ts +374 -374
  869. package/src/engine-components/Component.ts +1294 -1294
  870. package/src/engine-components/ContactShadows.ts +482 -482
  871. package/src/engine-components/DeleteBox.ts +62 -62
  872. package/src/engine-components/DeviceFlag.ts +46 -46
  873. package/src/engine-components/DragControls.ts +1623 -1623
  874. package/src/engine-components/DropListener.ts +698 -698
  875. package/src/engine-components/Duplicatable.ts +198 -198
  876. package/src/engine-components/EventList.ts +266 -266
  877. package/src/engine-components/EventTrigger.ts +74 -74
  878. package/src/engine-components/EventType.ts +22 -22
  879. package/src/engine-components/Fog.ts +60 -60
  880. package/src/engine-components/Gizmos.ts +56 -56
  881. package/src/engine-components/GridHelper.ts +48 -48
  882. package/src/engine-components/GroundProjection.ts +356 -356
  883. package/src/engine-components/Interactable.ts +14 -14
  884. package/src/engine-components/Joints.ts +52 -52
  885. package/src/engine-components/LODGroup.ts +153 -153
  886. package/src/engine-components/Light.ts +558 -558
  887. package/src/engine-components/LookAtConstraint.ts +25 -25
  888. package/src/engine-components/NeedleMenu.ts +84 -84
  889. package/src/engine-components/NestedGltf.ts +86 -86
  890. package/src/engine-components/Networking.ts +114 -114
  891. package/src/engine-components/OffsetConstraint.ts +60 -60
  892. package/src/engine-components/OrbitControls.ts +1068 -1068
  893. package/src/engine-components/PlayerColor.ts +103 -103
  894. package/src/engine-components/ReflectionProbe.ts +209 -209
  895. package/src/engine-components/Renderer.ts +900 -900
  896. package/src/engine-components/RendererInstancing.ts +855 -855
  897. package/src/engine-components/RendererLightmap.ts +198 -198
  898. package/src/engine-components/RigidBody.ts +526 -526
  899. package/src/engine-components/SceneSwitcher.ts +1013 -1013
  900. package/src/engine-components/ScreenCapture.ts +592 -592
  901. package/src/engine-components/ShadowCatcher.ts +172 -172
  902. package/src/engine-components/Skybox.ts +455 -455
  903. package/src/engine-components/SmoothFollow.ts +76 -76
  904. package/src/engine-components/SpatialTrigger.ts +229 -229
  905. package/src/engine-components/SpectatorCamera.ts +787 -787
  906. package/src/engine-components/SphereCollider.ts +1 -1
  907. package/src/engine-components/SpriteRenderer.ts +468 -468
  908. package/src/engine-components/SyncedCamera.ts +220 -220
  909. package/src/engine-components/SyncedRoom.ts +380 -380
  910. package/src/engine-components/SyncedTransform.ts +378 -378
  911. package/src/engine-components/TestRunner.ts +118 -118
  912. package/src/engine-components/TransformGizmo.ts +219 -219
  913. package/src/engine-components/VideoPlayer.ts +1025 -1025
  914. package/src/engine-components/Voip.ts +363 -363
  915. package/src/engine-components/api.ts +60 -60
  916. package/src/engine-components/avatar/AvatarBlink_Simple.ts +69 -69
  917. package/src/engine-components/avatar/AvatarEyeLook_Rotation.ts +63 -63
  918. package/src/engine-components/avatar/Avatar_Brain_LookAt.ts +139 -139
  919. package/src/engine-components/avatar/Avatar_MouthShapes.ts +83 -83
  920. package/src/engine-components/avatar/Avatar_MustacheShake.ts +31 -31
  921. package/src/engine-components/codegen/components.ts +217 -216
  922. package/src/engine-components/debug/LogStats.ts +21 -21
  923. package/src/engine-components/export/gltf/GltfExport.ts +265 -265
  924. package/src/engine-components/export/usdz/Extension.ts +24 -24
  925. package/src/engine-components/export/usdz/ThreeUSDZExporter.ts +2413 -2413
  926. package/src/engine-components/export/usdz/USDZExporter.ts +705 -705
  927. package/src/engine-components/export/usdz/extensions/Animation.ts +1204 -1204
  928. package/src/engine-components/export/usdz/extensions/DocumentExtension.ts +9 -9
  929. package/src/engine-components/export/usdz/extensions/USDZText.ts +240 -240
  930. package/src/engine-components/export/usdz/extensions/USDZUI.ts +189 -189
  931. package/src/engine-components/export/usdz/extensions/behavior/Actions.ts +99 -99
  932. package/src/engine-components/export/usdz/extensions/behavior/AudioExtension.ts +102 -102
  933. package/src/engine-components/export/usdz/extensions/behavior/Behaviour.ts +320 -320
  934. package/src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts +1225 -1225
  935. package/src/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.ts +646 -646
  936. package/src/engine-components/export/usdz/extensions/behavior/PhysicsExtension.ts +132 -132
  937. package/src/engine-components/export/usdz/index.ts +2 -2
  938. package/src/engine-components/export/usdz/utils/animationutils.ts +191 -191
  939. package/src/engine-components/export/usdz/utils/quicklook.ts +50 -50
  940. package/src/engine-components/particlesystem/ParticleSystem.ts +1287 -1287
  941. package/src/engine-components/particlesystem/ParticleSystemModules.ts +1765 -1765
  942. package/src/engine-components/particlesystem/ParticleSystemSubEmitter.ts +111 -111
  943. package/src/engine-components/particlesystem/api.ts +1 -1
  944. package/src/engine-components/postprocessing/Effects/Antialiasing.ts +55 -55
  945. package/src/engine-components/postprocessing/Effects/BloomEffect.ts +116 -116
  946. package/src/engine-components/postprocessing/Effects/ChromaticAberration.ts +37 -37
  947. package/src/engine-components/postprocessing/Effects/ColorAdjustments.ts +95 -95
  948. package/src/engine-components/postprocessing/Effects/DepthOfField.ts +103 -103
  949. package/src/engine-components/postprocessing/Effects/EffectWrapper.ts +25 -25
  950. package/src/engine-components/postprocessing/Effects/Pixelation.ts +32 -32
  951. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.ts +90 -90
  952. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.ts +191 -191
  953. package/src/engine-components/postprocessing/Effects/Sharpening.ts +138 -138
  954. package/src/engine-components/postprocessing/Effects/TiltShiftEffect.ts +61 -61
  955. package/src/engine-components/postprocessing/Effects/Tonemapping.ts +155 -155
  956. package/src/engine-components/postprocessing/Effects/Vignette.ts +59 -59
  957. package/src/engine-components/postprocessing/PostProcessingEffect.ts +172 -172
  958. package/src/engine-components/postprocessing/PostProcessingHandler.ts +398 -398
  959. package/src/engine-components/postprocessing/Volume.ts +410 -410
  960. package/src/engine-components/postprocessing/VolumeParameter.ts +158 -158
  961. package/src/engine-components/postprocessing/VolumeProfile.ts +61 -61
  962. package/src/engine-components/postprocessing/index.ts +5 -5
  963. package/src/engine-components/postprocessing/utils.ts +52 -52
  964. package/src/engine-components/timeline/PlayableDirector.ts +722 -722
  965. package/src/engine-components/timeline/SignalAsset.ts +144 -144
  966. package/src/engine-components/timeline/TimelineModels.ts +92 -92
  967. package/src/engine-components/timeline/TimelineTracks.ts +967 -967
  968. package/src/engine-components/timeline/index.ts +3 -3
  969. package/src/engine-components/ui/BaseUIComponent.ts +203 -203
  970. package/src/engine-components/ui/Button.ts +307 -307
  971. package/src/engine-components/ui/Canvas.ts +419 -419
  972. package/src/engine-components/ui/CanvasGroup.ts +54 -54
  973. package/src/engine-components/ui/EventSystem.ts +853 -853
  974. package/src/engine-components/ui/Graphic.ts +275 -275
  975. package/src/engine-components/ui/Image.ts +112 -112
  976. package/src/engine-components/ui/InputField.ts +321 -321
  977. package/src/engine-components/ui/Interfaces.ts +57 -57
  978. package/src/engine-components/ui/Layout.ts +334 -334
  979. package/src/engine-components/ui/Outline.ts +13 -13
  980. package/src/engine-components/ui/PointerEvents.ts +206 -206
  981. package/src/engine-components/ui/RaycastUtils.ts +69 -69
  982. package/src/engine-components/ui/Raycaster.ts +102 -102
  983. package/src/engine-components/ui/RectTransform.ts +372 -372
  984. package/src/engine-components/ui/SpatialHtml.ts +79 -79
  985. package/src/engine-components/ui/Text.ts +578 -578
  986. package/src/engine-components/ui/Utils.ts +112 -112
  987. package/src/engine-components/utils/EnvironmentScene.ts +245 -245
  988. package/src/engine-components/utils/LookAt.ts +88 -88
  989. package/src/engine-components/utils/OpenURL.ts +114 -114
  990. package/src/engine-components/webxr/Avatar.ts +265 -265
  991. package/src/engine-components/webxr/TeleportTarget.ts +9 -9
  992. package/src/engine-components/webxr/WebARCameraBackground.ts +175 -175
  993. package/src/engine-components/webxr/WebARSessionRoot.ts +880 -880
  994. package/src/engine-components/webxr/WebXR.ts +585 -585
  995. package/src/engine-components/webxr/WebXRAvatar.ts +66 -66
  996. package/src/engine-components/webxr/WebXRImageTracking.ts +518 -518
  997. package/src/engine-components/webxr/WebXRPlaneTracking.ts +570 -570
  998. package/src/engine-components/webxr/WebXRRig.ts +77 -77
  999. package/src/engine-components/webxr/XRFlag.ts +147 -147
  1000. package/src/engine-components/webxr/controllers/XRControllerFollow.ts +118 -118
  1001. package/src/engine-components/webxr/controllers/XRControllerModel.ts +374 -374
  1002. package/src/engine-components/webxr/controllers/XRControllerMovement.ts +550 -550
  1003. package/src/engine-components/webxr/index.ts +2 -2
  1004. package/src/engine-components/webxr/types.ts +3 -3
  1005. package/src/engine-components-experimental/Presentation.ts +12 -12
  1006. package/src/engine-components-experimental/api.ts +4 -4
  1007. package/src/engine-components-experimental/networking/PlayerSync.ts +401 -401
  1008. package/src/engine-schemes/COMPILE_SCHEMES.bat +3 -3
  1009. package/src/engine-schemes/COMPILE_TS.bat +11 -11
  1010. package/src/engine-schemes/README.md +1 -1
  1011. package/src/engine-schemes/api.ts +12 -12
  1012. package/src/engine-schemes/schemes.ts +28 -28
  1013. package/src/engine-schemes/synced-camera-model.ts +92 -92
  1014. package/src/engine-schemes/synced-transform-model.ts +90 -90
  1015. package/src/engine-schemes/syncedCamera.fbs +10 -10
  1016. package/src/engine-schemes/transform.ts +50 -50
  1017. package/src/engine-schemes/transforms.fbs +25 -25
  1018. package/src/engine-schemes/vec.fbs +19 -19
  1019. package/src/engine-schemes/vec2.ts +33 -33
  1020. package/src/engine-schemes/vec3.ts +38 -38
  1021. package/src/engine-schemes/vec4.ts +43 -43
  1022. package/src/engine-schemes/vr-user-state-buffer.ts +145 -145
  1023. package/src/engine-schemes/vrUserStateBuffer.fbs +17 -17
  1024. package/src/include/draco/draco_decoder.js +34 -34
  1025. package/src/include/ktx2/basis_transcoder.js +21 -21
  1026. package/src/include/needle/arial-msdf.json +1471 -1471
  1027. package/src/include/three/DragControls.js +231 -231
  1028. package/src/include/three/EXT_mesh_gpu_instancing_exporter.js +66 -66
  1029. package/src/needle-engine.ts +70 -70
  1030. package/lib/engine/engine.d.ts +0 -4
  1031. package/lib/engine/engine.js +0 -12
  1032. package/lib/engine/engine.js.map +0 -1
  1033. package/lib/engine/engine_web_api.d.ts +0 -12
  1034. package/lib/engine/engine_web_api.js +0 -113
  1035. package/lib/engine/engine_web_api.js.map +0 -1
  1036. package/lib/engine-components/FlyControls.d.ts +0 -10
  1037. package/lib/engine-components/FlyControls.js +0 -29
  1038. package/lib/engine-components/FlyControls.js.map +0 -1
  1039. package/src/engine-schemes/dist/api.js +0 -17
  1040. package/src/engine-schemes/dist/api.js.meta +0 -7
  1041. package/src/engine-schemes/dist/schemes.js +0 -25
  1042. package/src/engine-schemes/dist/schemes.js.meta +0 -7
  1043. package/src/engine-schemes/dist/synced-camera-model.js +0 -74
  1044. package/src/engine-schemes/dist/synced-camera-model.js.meta +0 -7
  1045. package/src/engine-schemes/dist/synced-transform-model.js +0 -73
  1046. package/src/engine-schemes/dist/synced-transform-model.js.meta +0 -7
  1047. package/src/engine-schemes/dist/transform.js +0 -46
  1048. package/src/engine-schemes/dist/transform.js.meta +0 -7
  1049. package/src/engine-schemes/dist/vec2.js +0 -32
  1050. package/src/engine-schemes/dist/vec2.js.meta +0 -7
  1051. package/src/engine-schemes/dist/vec3.js +0 -36
  1052. package/src/engine-schemes/dist/vec3.js.meta +0 -7
  1053. package/src/engine-schemes/dist/vec4.js +0 -40
  1054. package/src/engine-schemes/dist/vec4.js.meta +0 -7
  1055. package/src/engine-schemes/dist/vr-user-state-buffer.js +0 -110
  1056. package/src/engine-schemes/dist/vr-user-state-buffer.js.meta +0 -7
@@ -1,507 +1,507 @@
1
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
6
- };
7
- import { AdditiveBlending, DoubleSide, Line3, Mesh, MeshBasicMaterial, Plane, SphereGeometry, Vector3 } from "three";
8
- import { Line2 } from "three/examples/jsm/lines/Line2.js";
9
- import { LineGeometry } from "three/examples/jsm/lines/LineGeometry.js";
10
- import { LineMaterial } from "three/examples/jsm/lines/LineMaterial.js";
11
- import { GroundedSkybox } from "three/examples/jsm/objects/GroundedSkybox.js";
12
- import { Gizmos } from "../../../engine/engine_gizmos.js";
13
- import { Mathf } from "../../../engine/engine_math.js";
14
- import { serializable } from "../../../engine/engine_serialization.js";
15
- import { getTempVector, getWorldPosition, getWorldQuaternion, getWorldScale } from "../../../engine/engine_three_utils.js";
16
- import { getParam } from "../../../engine/engine_utils.js";
17
- import { Behaviour, GameObject } from "../../Component.js";
18
- import { hasPointerEventComponent } from "../../ui/PointerEvents.js";
19
- import { TeleportTarget } from "../TeleportTarget.js";
20
- const debug = getParam("debugwebxr");
21
- /**
22
- * XRControllerMovement is a component that allows to move the XR rig using the XR controller input.
23
- * @category XR
24
- * @group Components
25
- */
26
- export class XRControllerMovement extends Behaviour {
27
- /** Movement speed in meters per second
28
- * @default 1.5
29
- */
30
- movementSpeed = 1.5;
31
- /** How many degrees to rotate the XR rig when using the rotation trigger
32
- * @default 30
33
- */
34
- rotationStep = 30;
35
- /** When enabled you can teleport using the right XR controller's thumbstick by pressing forward
36
- * @default true
37
- */
38
- useTeleport = true;
39
- /**
40
- * When enabled you can teleport by pinching the right XR controller's index finger tip in front of the hand
41
- * @default true
42
- */
43
- usePinchToTeleport = true;
44
- /** Enable to only allow teleporting on objects with a teleport target component
45
- * @default false
46
- */
47
- useTeleportTarget = false;
48
- /** Enable to fade out the scene when teleporting
49
- * @default false
50
- */
51
- useTeleportFade = false;
52
- /** enable to visualize controller rays in the 3D scene
53
- * @default true
54
- */
55
- showRays = true;
56
- /** enable to visualize pointer targets in the 3D scene
57
- * @default false
58
- */
59
- showHits = true;
60
- isXRMovementHandler = true;
61
- xrSessionMode = "immersive-vr";
62
- _didApplyRotation = false;
63
- _didTeleport = false;
64
- onUpdateXR(args) {
65
- const rig = args.xr.rig;
66
- if (!rig?.gameObject)
67
- return;
68
- // in AR pass through mode we dont want to move the rig
69
- if (args.xr.isPassThrough) {
70
- return;
71
- }
72
- const movementController = args.xr.leftController;
73
- const teleportController = args.xr.rightController;
74
- if (movementController)
75
- this.onHandleMovement(movementController, rig.gameObject);
76
- if (teleportController) {
77
- this.onHandleRotation(teleportController, rig.gameObject);
78
- if (this.useTeleport)
79
- this.onHandleTeleport(teleportController, rig.gameObject);
80
- }
81
- }
82
- onLeaveXR(_) {
83
- for (const line of this._lines) {
84
- line.removeFromParent();
85
- }
86
- for (const disc of this._hitDiscs) {
87
- disc?.removeFromParent();
88
- }
89
- }
90
- onBeforeRender() {
91
- if (this.context.xr?.running) {
92
- if (this.showRays)
93
- this.renderRays(this.context.xr);
94
- if (this.showHits)
95
- this.renderHits(this.context.xr);
96
- }
97
- }
98
- onHandleMovement(controller, rig) {
99
- const stick = controller.getStick("xr-standard-thumbstick");
100
- if (stick.x != 0 || stick.y != 0) {
101
- const vec = getTempVector(stick.x, 0, stick.y);
102
- vec.multiplyScalar(this.context.time.deltaTimeUnscaled * this.movementSpeed);
103
- const scale = getWorldScale(rig);
104
- vec.multiplyScalar(scale.x);
105
- vec.applyQuaternion(controller.xr.poseOrientation);
106
- vec.y = 0;
107
- vec.applyQuaternion(rig.worldQuaternion);
108
- rig.position.add(vec);
109
- // if we dont do this here the XRControllerModel will be frame-delayed
110
- // maybe we need to introduce a priority order for XR components
111
- // TODO: would be better if this script would just run at the beginning of the frame
112
- rig.updateWorldMatrix(false, false);
113
- for (const ch of rig.children)
114
- ch.updateWorldMatrix(false, false);
115
- }
116
- }
117
- onHandleRotation(controller, rig) {
118
- // WORKAROUND for QuestOS v69 and less where data from MX Ink comes as thumbstick motion
119
- if (controller["_isMxInk"])
120
- return;
121
- const stick = controller.getStick("xr-standard-thumbstick");
122
- const rotationInput = stick.x;
123
- if (this._didApplyRotation) {
124
- if (Math.abs(rotationInput) < .3) {
125
- this._didApplyRotation = false;
126
- }
127
- }
128
- else if (Math.abs(rotationInput) > .5) {
129
- this._didApplyRotation = true;
130
- const dir = rotationInput > 0 ? 1 : -1;
131
- // store user worldpos
132
- const start_worldpos = getWorldPosition(this.context.mainCamera).clone();
133
- rig.rotateY(dir * Mathf.toRadians(this.rotationStep));
134
- // apply user offset so we rotate around the user
135
- const end_worldpos = getWorldPosition(this.context.mainCamera).clone();
136
- const diff = end_worldpos.sub(start_worldpos);
137
- diff.y = 0;
138
- rig.position.sub(diff);
139
- }
140
- }
141
- _teleportBuffer = new Array();
142
- onHandleTeleport(controller, rig) {
143
- let teleportInput = 0;
144
- if (controller.hand && this.usePinchToTeleport && controller.isTeleportGesture) {
145
- // prevent pinch teleport while the primary input is in use
146
- const pointerId = controller.getPointerId("primary");
147
- if (pointerId != undefined && this.context.input.getIsPointerIdInUse(pointerId)) {
148
- return;
149
- }
150
- const pinch = controller.getGesture("pinch");
151
- if (pinch) {
152
- teleportInput = pinch.value;
153
- }
154
- }
155
- else {
156
- teleportInput = controller.getStick("xr-standard-thumbstick")?.y;
157
- }
158
- if (this._didTeleport) {
159
- if (teleportInput >= 0 && teleportInput < .4) {
160
- this._didTeleport = false;
161
- }
162
- else if (teleportInput < 0 && teleportInput > -.4) {
163
- this._didTeleport = false;
164
- }
165
- }
166
- else if (teleportInput > .8) {
167
- this._didTeleport = true;
168
- const hit = this.context.physics.raycastFromRay(controller.ray)[0];
169
- if (hit && hit.object instanceof GroundedSkybox) {
170
- const dot_up = hit.normal?.dot(getTempVector(0, 1, 0));
171
- // Make sure we can only teleport on the ground / floor plane
172
- if (dot_up !== undefined && dot_up < 0.4) {
173
- return;
174
- }
175
- }
176
- let point = hit?.point;
177
- // If we didnt hit an object in the scene use the ground plane
178
- if (!point && !this.useTeleportTarget) {
179
- if (!this._plane) {
180
- this._plane = new Plane(new Vector3(0, 1, 0), 0);
181
- }
182
- const currentPosition = rig.worldPosition;
183
- this._plane.setFromNormalAndCoplanarPoint(new Vector3(0, 1, 0), currentPosition);
184
- const ray = controller.ray;
185
- point = currentPosition.clone();
186
- this._plane.intersectLine(new Line3(ray.origin, getTempVector(ray.direction).multiplyScalar(10000).add(ray.origin)), point);
187
- if (point.distanceTo(currentPosition) > rig.scale.x * 10) {
188
- point = null;
189
- }
190
- }
191
- if (point) {
192
- if (this.useTeleportTarget) {
193
- const teleportTarget = GameObject.getComponentInParent(hit.object, TeleportTarget);
194
- if (!teleportTarget)
195
- return;
196
- }
197
- const cloned = point.clone();
198
- if (debug)
199
- Gizmos.DrawSphere(point, .025, 0xff0000, 5);
200
- // remove user XR rig position
201
- const positionInRig = this.context.mainCamera?.position;
202
- if (positionInRig) {
203
- const vec = this.context.xr?.getUserOffsetInRig();
204
- if (vec) {
205
- vec.y = 0;
206
- cloned.sub(vec);
207
- if (debug)
208
- Gizmos.DrawWireSphere(vec.add(cloned), .025, 0x00ff00, 5);
209
- }
210
- }
211
- this._teleportBuffer.push(rig.matrix.clone());
212
- if (this._teleportBuffer.length > 10) {
213
- this._teleportBuffer.shift();
214
- }
215
- if (this.useTeleportFade) {
216
- controller.xr.fadeTransition()?.then(() => {
217
- rig.worldPosition = cloned;
218
- });
219
- }
220
- else {
221
- rig.worldPosition = cloned;
222
- }
223
- }
224
- }
225
- else if (teleportInput < -.8) {
226
- this._didTeleport = true;
227
- if (this._teleportBuffer.length > 0) {
228
- // get latest teleport position
229
- const prev = this._teleportBuffer.pop();
230
- if (prev) {
231
- prev.decompose(rig.position, rig.quaternion, rig.scale);
232
- }
233
- }
234
- }
235
- }
236
- _plane = null;
237
- _lines = [];
238
- _hitDiscs = [];
239
- _hitDistances = [];
240
- _lastHitDistances = [];
241
- renderRays(session) {
242
- for (let i = 0; i < this._lines.length; i++) {
243
- const line = this._lines[i];
244
- if (line)
245
- line.visible = false;
246
- }
247
- for (let i = 0; i < session.controllers.length; i++) {
248
- const ctrl = session.controllers[i];
249
- let line = this._lines[i];
250
- if (!ctrl.connected || !ctrl.isTracking ||
251
- !ctrl.ray || ctrl.targetRayMode === "transient-pointer" ||
252
- !ctrl.hasSelectEvent) {
253
- if (line)
254
- line.visible = false;
255
- continue;
256
- }
257
- if (!line) {
258
- line = this.createRayLineObject();
259
- line.scale.z = .5;
260
- this._lines[i] = line;
261
- }
262
- ctrl.updateRayWorldPosition();
263
- ctrl.updateRayWorldQuaternion();
264
- const pos = ctrl.rayWorldPosition;
265
- const rot = ctrl.rayWorldQuaternion;
266
- line.position.copy(pos);
267
- line.quaternion.copy(rot);
268
- const scale = session.rigScale;
269
- const forceShowRay = this.usePinchToTeleport && ctrl.isTeleportGesture;
270
- const distance = this._lastHitDistances[i];
271
- const hasHit = this._hitDistances[i] != null;
272
- const dist = distance != null ? distance : scale;
273
- line.scale.set(scale, scale, dist);
274
- line.visible = true;
275
- line.layers.disableAll();
276
- line.layers.enable(2);
277
- let targetOpacity = line.material.opacity;
278
- if (forceShowRay) {
279
- targetOpacity = 1;
280
- }
281
- else if (this.showHits && dist < session.rigScale * 0.5) {
282
- targetOpacity = 0;
283
- }
284
- else if (ctrl.getButton("primary")?.pressed) {
285
- targetOpacity = .5;
286
- }
287
- else {
288
- targetOpacity = hasHit ? .2 : .1;
289
- }
290
- line.material.opacity = Mathf.lerp(line.material.opacity, targetOpacity, this.context.time.deltaTimeUnscaled / .1);
291
- if (line.parent !== this.context.scene)
292
- this.context.scene.add(line);
293
- }
294
- }
295
- renderHits(session) {
296
- for (const disc of this._hitDiscs) {
297
- if (!disc)
298
- continue;
299
- const ctrl = disc["controller"];
300
- if (!ctrl || !ctrl.connected || !ctrl.isTracking) {
301
- disc.visible = false;
302
- continue;
303
- }
304
- }
305
- for (let i = 0; i < session.controllers.length; i++) {
306
- const ctrl = session.controllers[i];
307
- if (!ctrl.connected || !ctrl.isTracking || !ctrl.ray || !ctrl.hasSelectEvent)
308
- continue;
309
- let disc = this._hitDiscs[i];
310
- let runRaycast = true;
311
- // Check if the primary input button is in use
312
- const pointerId = ctrl.getPointerId("primary");
313
- if (pointerId != undefined) {
314
- const isCurrentlyUsed = this.context.input.getIsPointerIdInUse(pointerId);
315
- // if the input is being used then we hide the ray
316
- if (isCurrentlyUsed) {
317
- if (disc)
318
- disc.visible = false;
319
- this._hitDistances[i] = null;
320
- this._lastHitDistances[i] = 0;
321
- runRaycast = false;
322
- }
323
- }
324
- // save performance by only raycasting every nth frame
325
- const interval = this.context.time.smoothedFps >= 59 ? 1 : 10;
326
- if ((this.context.time.frame + ctrl.index) % interval !== 0) {
327
- runRaycast = false;
328
- }
329
- if (!runRaycast) {
330
- const disc = this._hitDiscs[i];
331
- // if the disc had a hit last frame, we can update it here
332
- if (disc && disc.visible && disc["hit"]) {
333
- this.updateHitPointerPosition(ctrl, disc, disc["hit"].distance);
334
- }
335
- continue;
336
- }
337
- const hits = this.context.physics.raycastFromRay(ctrl.ray, { testObject: this.hitPointRaycastFilter, precise: false });
338
- let hit = hits.find(hit => {
339
- if (this.usePinchToTeleport && ctrl.isTeleportGesture)
340
- return true;
341
- // Only render hits on interactable objects
342
- return this.isObjectWithInteractiveComponent(hit.object);
343
- });
344
- // Fallback to use the first hit
345
- if (!hit) {
346
- hit = hits[0];
347
- }
348
- if (disc) // save the hit object on the disc
349
- {
350
- disc["controller"] = ctrl;
351
- disc["hit"] = hit;
352
- }
353
- this._hitDistances[i] = hit?.distance || null;
354
- if (hit) {
355
- this._lastHitDistances[i] = hit.distance;
356
- const rigScale = (session.rigScale ?? 1);
357
- if (debug) {
358
- Gizmos.DrawWireSphere(hit.point, .025 * rigScale, 0xff0000);
359
- Gizmos.DrawLabel(getTempVector(0, .2, 0).add(hit.point), hit.object.name, .02, 0);
360
- }
361
- if (!disc) {
362
- disc = this.createHitPointObject();
363
- this._hitDiscs[i] = disc;
364
- }
365
- disc["hit"] = hit;
366
- // hide the disc if the hit point is too close
367
- disc.visible = hit.distance > rigScale * 0.05;
368
- let size = (.01 * (rigScale + hit.distance));
369
- const primaryPressed = ctrl.getButton("primary")?.pressed;
370
- if (primaryPressed)
371
- size *= 1.1;
372
- disc.scale.set(size, size, size);
373
- disc.layers.set(2);
374
- let targetOpacity = disc.material.opacity;
375
- if (primaryPressed) {
376
- targetOpacity = 1;
377
- }
378
- else {
379
- targetOpacity = hit.distance < .15 * rigScale ? .2 : .6;
380
- }
381
- disc.material.opacity = Mathf.lerp(disc.material.opacity, targetOpacity, this.context.time.deltaTimeUnscaled / .1);
382
- if (disc.visible) {
383
- if (hit.normal) {
384
- this.updateHitPointerPosition(ctrl, disc, hit.distance);
385
- const worldNormal = hit.normal.applyQuaternion(getWorldQuaternion(hit.object));
386
- disc.quaternion.setFromUnitVectors(up, worldNormal);
387
- }
388
- else {
389
- this.updateHitPointerPosition(ctrl, disc, hit.distance);
390
- }
391
- if (disc.parent !== this.context.scene) {
392
- this.context.scene.add(disc);
393
- }
394
- }
395
- }
396
- else {
397
- if (this._hitDiscs[i]) {
398
- this._hitDiscs[i].visible = false;
399
- }
400
- }
401
- }
402
- }
403
- isObjectWithInteractiveComponent(object, level = 0) {
404
- if (hasPointerEventComponent(object) || (object["isUI"] === true))
405
- return true;
406
- if (object.isScene)
407
- return false;
408
- if (object.parent)
409
- return this.isObjectWithInteractiveComponent(object.parent, level + 1);
410
- return false;
411
- }
412
- updateHitPointerPosition(ctrl, pt, distance) {
413
- const targetPos = getTempVector(ctrl.rayWorldPosition);
414
- targetPos.add(getTempVector(0, 0, distance - .01).applyQuaternion(ctrl.rayWorldQuaternion));
415
- pt.position.lerp(targetPos, this.context.time.deltaTimeUnscaled / .05);
416
- }
417
- hitPointRaycastFilter = (obj) => {
418
- // by default dont raycast ont skinned meshes using the hit point raycast (because it is a big performance hit and only a visual indicator)
419
- if (obj.type === "SkinnedMesh")
420
- return "continue in children";
421
- return true;
422
- };
423
- /** create an object to visualize hit points in the scene */
424
- createHitPointObject() {
425
- // var container = new Object3D();
426
- const mesh = new Mesh(new SphereGeometry(.3, 6, 6), // new RingGeometry(.3, 0.5, 32).rotateX(- Math.PI / 2),
427
- new MeshBasicMaterial({
428
- color: 0xeeeeee,
429
- opacity: .7,
430
- transparent: true,
431
- depthTest: false,
432
- depthWrite: false,
433
- side: DoubleSide,
434
- }));
435
- mesh.layers.disableAll();
436
- mesh.layers.enable(2);
437
- // container.add(disc);
438
- // const disc2 = new Mesh(
439
- // new RingGeometry(.43, 0.5, 32).rotateX(- Math.PI / 2),
440
- // new MeshBasicMaterial({
441
- // color: 0x000000,
442
- // opacity: .2,
443
- // transparent: true,
444
- // side: DoubleSide,
445
- // })
446
- // );
447
- // disc2.layers.disableAll();
448
- // disc2.layers.enable(2);
449
- // disc2.position.y = .01;
450
- // container.add(disc2);
451
- return mesh;
452
- }
453
- /** create an object to visualize controller rays */
454
- createRayLineObject() {
455
- const line = new Line2();
456
- line.layers.disableAll();
457
- line.layers.enable(2);
458
- const geometry = new LineGeometry();
459
- line.geometry = geometry;
460
- const positions = new Float32Array(9);
461
- positions.set([0, 0, .02, 0, 0, .4, 0, 0, 1]);
462
- geometry.setPositions(positions);
463
- const colors = new Float32Array(9);
464
- colors.set([1, 1, 1, .1, .1, .1, 0, 0, 0]);
465
- geometry.setColors(colors);
466
- const mat = new LineMaterial({
467
- color: 0xffffff,
468
- vertexColors: true,
469
- worldUnits: true,
470
- linewidth: .004,
471
- transparent: true,
472
- depthWrite: false,
473
- // TODO: this doesnt work with passthrough
474
- blending: AdditiveBlending,
475
- dashed: false,
476
- // alphaToCoverage: true,
477
- });
478
- line.material = mat;
479
- return line;
480
- }
481
- }
482
- __decorate([
483
- serializable()
484
- ], XRControllerMovement.prototype, "movementSpeed", void 0);
485
- __decorate([
486
- serializable()
487
- ], XRControllerMovement.prototype, "rotationStep", void 0);
488
- __decorate([
489
- serializable()
490
- ], XRControllerMovement.prototype, "useTeleport", void 0);
491
- __decorate([
492
- serializable()
493
- ], XRControllerMovement.prototype, "usePinchToTeleport", void 0);
494
- __decorate([
495
- serializable()
496
- ], XRControllerMovement.prototype, "useTeleportTarget", void 0);
497
- __decorate([
498
- serializable()
499
- ], XRControllerMovement.prototype, "useTeleportFade", void 0);
500
- __decorate([
501
- serializable()
502
- ], XRControllerMovement.prototype, "showRays", void 0);
503
- __decorate([
504
- serializable()
505
- ], XRControllerMovement.prototype, "showHits", void 0);
506
- const up = new Vector3(0, 1, 0);
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ import { AdditiveBlending, DoubleSide, Line3, Mesh, MeshBasicMaterial, Plane, SphereGeometry, Vector3 } from "three";
8
+ import { Line2 } from "three/examples/jsm/lines/Line2.js";
9
+ import { LineGeometry } from "three/examples/jsm/lines/LineGeometry.js";
10
+ import { LineMaterial } from "three/examples/jsm/lines/LineMaterial.js";
11
+ import { GroundedSkybox } from "three/examples/jsm/objects/GroundedSkybox.js";
12
+ import { Gizmos } from "../../../engine/engine_gizmos.js";
13
+ import { Mathf } from "../../../engine/engine_math.js";
14
+ import { serializable } from "../../../engine/engine_serialization.js";
15
+ import { getTempVector, getWorldPosition, getWorldQuaternion, getWorldScale } from "../../../engine/engine_three_utils.js";
16
+ import { getParam } from "../../../engine/engine_utils.js";
17
+ import { Behaviour, GameObject } from "../../Component.js";
18
+ import { hasPointerEventComponent } from "../../ui/PointerEvents.js";
19
+ import { TeleportTarget } from "../TeleportTarget.js";
20
+ const debug = getParam("debugwebxr");
21
+ /**
22
+ * XRControllerMovement is a component that allows to move the XR rig using the XR controller input.
23
+ * @category XR
24
+ * @group Components
25
+ */
26
+ export class XRControllerMovement extends Behaviour {
27
+ /** Movement speed in meters per second
28
+ * @default 1.5
29
+ */
30
+ movementSpeed = 1.5;
31
+ /** How many degrees to rotate the XR rig when using the rotation trigger
32
+ * @default 30
33
+ */
34
+ rotationStep = 30;
35
+ /** When enabled you can teleport using the right XR controller's thumbstick by pressing forward
36
+ * @default true
37
+ */
38
+ useTeleport = true;
39
+ /**
40
+ * When enabled you can teleport by pinching the right XR controller's index finger tip in front of the hand
41
+ * @default true
42
+ */
43
+ usePinchToTeleport = true;
44
+ /** Enable to only allow teleporting on objects with a teleport target component
45
+ * @default false
46
+ */
47
+ useTeleportTarget = false;
48
+ /** Enable to fade out the scene when teleporting
49
+ * @default false
50
+ */
51
+ useTeleportFade = false;
52
+ /** enable to visualize controller rays in the 3D scene
53
+ * @default true
54
+ */
55
+ showRays = true;
56
+ /** enable to visualize pointer targets in the 3D scene
57
+ * @default false
58
+ */
59
+ showHits = true;
60
+ isXRMovementHandler = true;
61
+ xrSessionMode = "immersive-vr";
62
+ _didApplyRotation = false;
63
+ _didTeleport = false;
64
+ onUpdateXR(args) {
65
+ const rig = args.xr.rig;
66
+ if (!rig?.gameObject)
67
+ return;
68
+ // in AR pass through mode we dont want to move the rig
69
+ if (args.xr.isPassThrough) {
70
+ return;
71
+ }
72
+ const movementController = args.xr.leftController;
73
+ const teleportController = args.xr.rightController;
74
+ if (movementController)
75
+ this.onHandleMovement(movementController, rig.gameObject);
76
+ if (teleportController) {
77
+ this.onHandleRotation(teleportController, rig.gameObject);
78
+ if (this.useTeleport)
79
+ this.onHandleTeleport(teleportController, rig.gameObject);
80
+ }
81
+ }
82
+ onLeaveXR(_) {
83
+ for (const line of this._lines) {
84
+ line.removeFromParent();
85
+ }
86
+ for (const disc of this._hitDiscs) {
87
+ disc?.removeFromParent();
88
+ }
89
+ }
90
+ onBeforeRender() {
91
+ if (this.context.xr?.running) {
92
+ if (this.showRays)
93
+ this.renderRays(this.context.xr);
94
+ if (this.showHits)
95
+ this.renderHits(this.context.xr);
96
+ }
97
+ }
98
+ onHandleMovement(controller, rig) {
99
+ const stick = controller.getStick("xr-standard-thumbstick");
100
+ if (stick.x != 0 || stick.y != 0) {
101
+ const vec = getTempVector(stick.x, 0, stick.y);
102
+ vec.multiplyScalar(this.context.time.deltaTimeUnscaled * this.movementSpeed);
103
+ const scale = getWorldScale(rig);
104
+ vec.multiplyScalar(scale.x);
105
+ vec.applyQuaternion(controller.xr.poseOrientation);
106
+ vec.y = 0;
107
+ vec.applyQuaternion(rig.worldQuaternion);
108
+ rig.position.add(vec);
109
+ // if we dont do this here the XRControllerModel will be frame-delayed
110
+ // maybe we need to introduce a priority order for XR components
111
+ // TODO: would be better if this script would just run at the beginning of the frame
112
+ rig.updateWorldMatrix(false, false);
113
+ for (const ch of rig.children)
114
+ ch.updateWorldMatrix(false, false);
115
+ }
116
+ }
117
+ onHandleRotation(controller, rig) {
118
+ // WORKAROUND for QuestOS v69 and less where data from MX Ink comes as thumbstick motion
119
+ if (controller["_isMxInk"])
120
+ return;
121
+ const stick = controller.getStick("xr-standard-thumbstick");
122
+ const rotationInput = stick.x;
123
+ if (this._didApplyRotation) {
124
+ if (Math.abs(rotationInput) < .3) {
125
+ this._didApplyRotation = false;
126
+ }
127
+ }
128
+ else if (Math.abs(rotationInput) > .5) {
129
+ this._didApplyRotation = true;
130
+ const dir = rotationInput > 0 ? 1 : -1;
131
+ // store user worldpos
132
+ const start_worldpos = getWorldPosition(this.context.mainCamera).clone();
133
+ rig.rotateY(dir * Mathf.toRadians(this.rotationStep));
134
+ // apply user offset so we rotate around the user
135
+ const end_worldpos = getWorldPosition(this.context.mainCamera).clone();
136
+ const diff = end_worldpos.sub(start_worldpos);
137
+ diff.y = 0;
138
+ rig.position.sub(diff);
139
+ }
140
+ }
141
+ _teleportBuffer = new Array();
142
+ onHandleTeleport(controller, rig) {
143
+ let teleportInput = 0;
144
+ if (controller.hand && this.usePinchToTeleport && controller.isTeleportGesture) {
145
+ // prevent pinch teleport while the primary input is in use
146
+ const pointerId = controller.getPointerId("primary");
147
+ if (pointerId != undefined && this.context.input.getIsPointerIdInUse(pointerId)) {
148
+ return;
149
+ }
150
+ const pinch = controller.getGesture("pinch");
151
+ if (pinch) {
152
+ teleportInput = pinch.value;
153
+ }
154
+ }
155
+ else {
156
+ teleportInput = controller.getStick("xr-standard-thumbstick")?.y;
157
+ }
158
+ if (this._didTeleport) {
159
+ if (teleportInput >= 0 && teleportInput < .4) {
160
+ this._didTeleport = false;
161
+ }
162
+ else if (teleportInput < 0 && teleportInput > -.4) {
163
+ this._didTeleport = false;
164
+ }
165
+ }
166
+ else if (teleportInput > .8) {
167
+ this._didTeleport = true;
168
+ const hit = this.context.physics.raycastFromRay(controller.ray)[0];
169
+ if (hit && hit.object instanceof GroundedSkybox) {
170
+ const dot_up = hit.normal?.dot(getTempVector(0, 1, 0));
171
+ // Make sure we can only teleport on the ground / floor plane
172
+ if (dot_up !== undefined && dot_up < 0.4) {
173
+ return;
174
+ }
175
+ }
176
+ let point = hit?.point;
177
+ // If we didnt hit an object in the scene use the ground plane
178
+ if (!point && !this.useTeleportTarget) {
179
+ if (!this._plane) {
180
+ this._plane = new Plane(new Vector3(0, 1, 0), 0);
181
+ }
182
+ const currentPosition = rig.worldPosition;
183
+ this._plane.setFromNormalAndCoplanarPoint(new Vector3(0, 1, 0), currentPosition);
184
+ const ray = controller.ray;
185
+ point = currentPosition.clone();
186
+ this._plane.intersectLine(new Line3(ray.origin, getTempVector(ray.direction).multiplyScalar(10000).add(ray.origin)), point);
187
+ if (point.distanceTo(currentPosition) > rig.scale.x * 10) {
188
+ point = null;
189
+ }
190
+ }
191
+ if (point) {
192
+ if (this.useTeleportTarget) {
193
+ const teleportTarget = GameObject.getComponentInParent(hit.object, TeleportTarget);
194
+ if (!teleportTarget)
195
+ return;
196
+ }
197
+ const cloned = point.clone();
198
+ if (debug)
199
+ Gizmos.DrawSphere(point, .025, 0xff0000, 5);
200
+ // remove user XR rig position
201
+ const positionInRig = this.context.mainCamera?.position;
202
+ if (positionInRig) {
203
+ const vec = this.context.xr?.getUserOffsetInRig();
204
+ if (vec) {
205
+ vec.y = 0;
206
+ cloned.sub(vec);
207
+ if (debug)
208
+ Gizmos.DrawWireSphere(vec.add(cloned), .025, 0x00ff00, 5);
209
+ }
210
+ }
211
+ this._teleportBuffer.push(rig.matrix.clone());
212
+ if (this._teleportBuffer.length > 10) {
213
+ this._teleportBuffer.shift();
214
+ }
215
+ if (this.useTeleportFade) {
216
+ controller.xr.fadeTransition()?.then(() => {
217
+ rig.worldPosition = cloned;
218
+ });
219
+ }
220
+ else {
221
+ rig.worldPosition = cloned;
222
+ }
223
+ }
224
+ }
225
+ else if (teleportInput < -.8) {
226
+ this._didTeleport = true;
227
+ if (this._teleportBuffer.length > 0) {
228
+ // get latest teleport position
229
+ const prev = this._teleportBuffer.pop();
230
+ if (prev) {
231
+ prev.decompose(rig.position, rig.quaternion, rig.scale);
232
+ }
233
+ }
234
+ }
235
+ }
236
+ _plane = null;
237
+ _lines = [];
238
+ _hitDiscs = [];
239
+ _hitDistances = [];
240
+ _lastHitDistances = [];
241
+ renderRays(session) {
242
+ for (let i = 0; i < this._lines.length; i++) {
243
+ const line = this._lines[i];
244
+ if (line)
245
+ line.visible = false;
246
+ }
247
+ for (let i = 0; i < session.controllers.length; i++) {
248
+ const ctrl = session.controllers[i];
249
+ let line = this._lines[i];
250
+ if (!ctrl.connected || !ctrl.isTracking ||
251
+ !ctrl.ray || ctrl.targetRayMode === "transient-pointer" ||
252
+ !ctrl.hasSelectEvent) {
253
+ if (line)
254
+ line.visible = false;
255
+ continue;
256
+ }
257
+ if (!line) {
258
+ line = this.createRayLineObject();
259
+ line.scale.z = .5;
260
+ this._lines[i] = line;
261
+ }
262
+ ctrl.updateRayWorldPosition();
263
+ ctrl.updateRayWorldQuaternion();
264
+ const pos = ctrl.rayWorldPosition;
265
+ const rot = ctrl.rayWorldQuaternion;
266
+ line.position.copy(pos);
267
+ line.quaternion.copy(rot);
268
+ const scale = session.rigScale;
269
+ const forceShowRay = this.usePinchToTeleport && ctrl.isTeleportGesture;
270
+ const distance = this._lastHitDistances[i];
271
+ const hasHit = this._hitDistances[i] != null;
272
+ const dist = distance != null ? distance : scale;
273
+ line.scale.set(scale, scale, dist);
274
+ line.visible = true;
275
+ line.layers.disableAll();
276
+ line.layers.enable(2);
277
+ let targetOpacity = line.material.opacity;
278
+ if (forceShowRay) {
279
+ targetOpacity = 1;
280
+ }
281
+ else if (this.showHits && dist < session.rigScale * 0.5) {
282
+ targetOpacity = 0;
283
+ }
284
+ else if (ctrl.getButton("primary")?.pressed) {
285
+ targetOpacity = .5;
286
+ }
287
+ else {
288
+ targetOpacity = hasHit ? .2 : .1;
289
+ }
290
+ line.material.opacity = Mathf.lerp(line.material.opacity, targetOpacity, this.context.time.deltaTimeUnscaled / .1);
291
+ if (line.parent !== this.context.scene)
292
+ this.context.scene.add(line);
293
+ }
294
+ }
295
+ renderHits(session) {
296
+ for (const disc of this._hitDiscs) {
297
+ if (!disc)
298
+ continue;
299
+ const ctrl = disc["controller"];
300
+ if (!ctrl || !ctrl.connected || !ctrl.isTracking) {
301
+ disc.visible = false;
302
+ continue;
303
+ }
304
+ }
305
+ for (let i = 0; i < session.controllers.length; i++) {
306
+ const ctrl = session.controllers[i];
307
+ if (!ctrl.connected || !ctrl.isTracking || !ctrl.ray || !ctrl.hasSelectEvent)
308
+ continue;
309
+ let disc = this._hitDiscs[i];
310
+ let runRaycast = true;
311
+ // Check if the primary input button is in use
312
+ const pointerId = ctrl.getPointerId("primary");
313
+ if (pointerId != undefined) {
314
+ const isCurrentlyUsed = this.context.input.getIsPointerIdInUse(pointerId);
315
+ // if the input is being used then we hide the ray
316
+ if (isCurrentlyUsed) {
317
+ if (disc)
318
+ disc.visible = false;
319
+ this._hitDistances[i] = null;
320
+ this._lastHitDistances[i] = 0;
321
+ runRaycast = false;
322
+ }
323
+ }
324
+ // save performance by only raycasting every nth frame
325
+ const interval = this.context.time.smoothedFps >= 59 ? 1 : 10;
326
+ if ((this.context.time.frame + ctrl.index) % interval !== 0) {
327
+ runRaycast = false;
328
+ }
329
+ if (!runRaycast) {
330
+ const disc = this._hitDiscs[i];
331
+ // if the disc had a hit last frame, we can update it here
332
+ if (disc && disc.visible && disc["hit"]) {
333
+ this.updateHitPointerPosition(ctrl, disc, disc["hit"].distance);
334
+ }
335
+ continue;
336
+ }
337
+ const hits = this.context.physics.raycastFromRay(ctrl.ray, { testObject: this.hitPointRaycastFilter, precise: false });
338
+ let hit = hits.find(hit => {
339
+ if (this.usePinchToTeleport && ctrl.isTeleportGesture)
340
+ return true;
341
+ // Only render hits on interactable objects
342
+ return this.isObjectWithInteractiveComponent(hit.object);
343
+ });
344
+ // Fallback to use the first hit
345
+ if (!hit) {
346
+ hit = hits[0];
347
+ }
348
+ if (disc) // save the hit object on the disc
349
+ {
350
+ disc["controller"] = ctrl;
351
+ disc["hit"] = hit;
352
+ }
353
+ this._hitDistances[i] = hit?.distance || null;
354
+ if (hit) {
355
+ this._lastHitDistances[i] = hit.distance;
356
+ const rigScale = (session.rigScale ?? 1);
357
+ if (debug) {
358
+ Gizmos.DrawWireSphere(hit.point, .025 * rigScale, 0xff0000);
359
+ Gizmos.DrawLabel(getTempVector(0, .2, 0).add(hit.point), hit.object.name, .02, 0);
360
+ }
361
+ if (!disc) {
362
+ disc = this.createHitPointObject();
363
+ this._hitDiscs[i] = disc;
364
+ }
365
+ disc["hit"] = hit;
366
+ // hide the disc if the hit point is too close
367
+ disc.visible = hit.distance > rigScale * 0.05;
368
+ let size = (.01 * (rigScale + hit.distance));
369
+ const primaryPressed = ctrl.getButton("primary")?.pressed;
370
+ if (primaryPressed)
371
+ size *= 1.1;
372
+ disc.scale.set(size, size, size);
373
+ disc.layers.set(2);
374
+ let targetOpacity = disc.material.opacity;
375
+ if (primaryPressed) {
376
+ targetOpacity = 1;
377
+ }
378
+ else {
379
+ targetOpacity = hit.distance < .15 * rigScale ? .2 : .6;
380
+ }
381
+ disc.material.opacity = Mathf.lerp(disc.material.opacity, targetOpacity, this.context.time.deltaTimeUnscaled / .1);
382
+ if (disc.visible) {
383
+ if (hit.normal) {
384
+ this.updateHitPointerPosition(ctrl, disc, hit.distance);
385
+ const worldNormal = hit.normal.applyQuaternion(getWorldQuaternion(hit.object));
386
+ disc.quaternion.setFromUnitVectors(up, worldNormal);
387
+ }
388
+ else {
389
+ this.updateHitPointerPosition(ctrl, disc, hit.distance);
390
+ }
391
+ if (disc.parent !== this.context.scene) {
392
+ this.context.scene.add(disc);
393
+ }
394
+ }
395
+ }
396
+ else {
397
+ if (this._hitDiscs[i]) {
398
+ this._hitDiscs[i].visible = false;
399
+ }
400
+ }
401
+ }
402
+ }
403
+ isObjectWithInteractiveComponent(object, level = 0) {
404
+ if (hasPointerEventComponent(object) || (object["isUI"] === true))
405
+ return true;
406
+ if (object.isScene)
407
+ return false;
408
+ if (object.parent)
409
+ return this.isObjectWithInteractiveComponent(object.parent, level + 1);
410
+ return false;
411
+ }
412
+ updateHitPointerPosition(ctrl, pt, distance) {
413
+ const targetPos = getTempVector(ctrl.rayWorldPosition);
414
+ targetPos.add(getTempVector(0, 0, distance - .01).applyQuaternion(ctrl.rayWorldQuaternion));
415
+ pt.position.lerp(targetPos, this.context.time.deltaTimeUnscaled / .05);
416
+ }
417
+ hitPointRaycastFilter = (obj) => {
418
+ // by default dont raycast ont skinned meshes using the hit point raycast (because it is a big performance hit and only a visual indicator)
419
+ if (obj.type === "SkinnedMesh")
420
+ return "continue in children";
421
+ return true;
422
+ };
423
+ /** create an object to visualize hit points in the scene */
424
+ createHitPointObject() {
425
+ // var container = new Object3D();
426
+ const mesh = new Mesh(new SphereGeometry(.3, 6, 6), // new RingGeometry(.3, 0.5, 32).rotateX(- Math.PI / 2),
427
+ new MeshBasicMaterial({
428
+ color: 0xeeeeee,
429
+ opacity: .7,
430
+ transparent: true,
431
+ depthTest: false,
432
+ depthWrite: false,
433
+ side: DoubleSide,
434
+ }));
435
+ mesh.layers.disableAll();
436
+ mesh.layers.enable(2);
437
+ // container.add(disc);
438
+ // const disc2 = new Mesh(
439
+ // new RingGeometry(.43, 0.5, 32).rotateX(- Math.PI / 2),
440
+ // new MeshBasicMaterial({
441
+ // color: 0x000000,
442
+ // opacity: .2,
443
+ // transparent: true,
444
+ // side: DoubleSide,
445
+ // })
446
+ // );
447
+ // disc2.layers.disableAll();
448
+ // disc2.layers.enable(2);
449
+ // disc2.position.y = .01;
450
+ // container.add(disc2);
451
+ return mesh;
452
+ }
453
+ /** create an object to visualize controller rays */
454
+ createRayLineObject() {
455
+ const line = new Line2();
456
+ line.layers.disableAll();
457
+ line.layers.enable(2);
458
+ const geometry = new LineGeometry();
459
+ line.geometry = geometry;
460
+ const positions = new Float32Array(9);
461
+ positions.set([0, 0, .02, 0, 0, .4, 0, 0, 1]);
462
+ geometry.setPositions(positions);
463
+ const colors = new Float32Array(9);
464
+ colors.set([1, 1, 1, .1, .1, .1, 0, 0, 0]);
465
+ geometry.setColors(colors);
466
+ const mat = new LineMaterial({
467
+ color: 0xffffff,
468
+ vertexColors: true,
469
+ worldUnits: true,
470
+ linewidth: .004,
471
+ transparent: true,
472
+ depthWrite: false,
473
+ // TODO: this doesnt work with passthrough
474
+ blending: AdditiveBlending,
475
+ dashed: false,
476
+ // alphaToCoverage: true,
477
+ });
478
+ line.material = mat;
479
+ return line;
480
+ }
481
+ }
482
+ __decorate([
483
+ serializable()
484
+ ], XRControllerMovement.prototype, "movementSpeed", void 0);
485
+ __decorate([
486
+ serializable()
487
+ ], XRControllerMovement.prototype, "rotationStep", void 0);
488
+ __decorate([
489
+ serializable()
490
+ ], XRControllerMovement.prototype, "useTeleport", void 0);
491
+ __decorate([
492
+ serializable()
493
+ ], XRControllerMovement.prototype, "usePinchToTeleport", void 0);
494
+ __decorate([
495
+ serializable()
496
+ ], XRControllerMovement.prototype, "useTeleportTarget", void 0);
497
+ __decorate([
498
+ serializable()
499
+ ], XRControllerMovement.prototype, "useTeleportFade", void 0);
500
+ __decorate([
501
+ serializable()
502
+ ], XRControllerMovement.prototype, "showRays", void 0);
503
+ __decorate([
504
+ serializable()
505
+ ], XRControllerMovement.prototype, "showHits", void 0);
506
+ const up = new Vector3(0, 1, 0);
507
507
  //# sourceMappingURL=XRControllerMovement.js.map