@needle-tools/engine 4.7.0-alpha → 4.7.0-next.da47826

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 (1063) hide show
  1. package/CHANGELOG.md +3768 -3768
  2. package/LICENSE.md +10 -10
  3. package/README.md +64 -64
  4. package/components.needle.json +1 -1
  5. package/dist/generateMeshBVH.worker-BaNp_Xtp.js +25 -0
  6. package/dist/{gltf-progressive-Bm9eEfgu.min.js → gltf-progressive-Bl4okF1b.min.js} +1 -1
  7. package/dist/{gltf-progressive-GjIqwSG3.js → gltf-progressive-DSpdn0QT.js} +2 -2
  8. package/dist/{gltf-progressive-Dn6o99rH.umd.cjs → gltf-progressive-P8b8a0qY.umd.cjs} +1 -1
  9. package/dist/{needle-engine.bundle-CK8cQ3FX.umd.cjs → needle-engine.bundle-Bu88IoKB.umd.cjs} +57 -57
  10. package/dist/{needle-engine.bundle-CXtflnL6.js → needle-engine.bundle-CO1Ub9sm.js} +638 -638
  11. package/dist/{needle-engine.bundle-BEUFTdl6.min.js → needle-engine.bundle-D95XN5pP.min.js} +62 -62
  12. package/dist/needle-engine.d.ts +130 -129
  13. package/dist/needle-engine.js +4 -4
  14. package/dist/needle-engine.min.js +1 -1
  15. package/dist/needle-engine.umd.cjs +1 -1
  16. package/dist/{postprocessing-8AQTeZsr.umd.cjs → postprocessing-CjW23fio.umd.cjs} +2 -2
  17. package/dist/{postprocessing-BkxN_08g.js → postprocessing-DYLNOL3W.js} +3 -3
  18. package/dist/{postprocessing-BDScN9yu.min.js → postprocessing-xYQWCHFu.min.js} +2 -2
  19. package/dist/{three-DMrv-4ar.umd.cjs → three-B_hneGZr.umd.cjs} +4 -4
  20. package/dist/{three-Bz6X1mrw.js → three-DrqIzZTH.js} +4198 -4198
  21. package/dist/{three-Boa-jOq-.min.js → three-DuDKwKB8.min.js} +33 -33
  22. package/dist/{three-examples-GggCDHv0.js → three-examples-B50TT3Iu.js} +5 -5
  23. package/dist/{three-examples-DuVhxqft.min.js → three-examples-DaDLBuy6.min.js} +14 -14
  24. package/dist/{three-examples-C7ryg8vN.umd.cjs → three-examples-X3OadjXB.umd.cjs} +3 -3
  25. package/dist/{three-mesh-ui-CY6Izc7C.min.js → three-mesh-ui-B3p3gyUz.min.js} +1 -1
  26. package/dist/{three-mesh-ui-CwlN0FUC.umd.cjs → three-mesh-ui-CQiIQIlA.umd.cjs} +1 -1
  27. package/dist/{three-mesh-ui-CLNOfsWn.js → three-mesh-ui-CxuWt7m-.js} +1 -1
  28. package/dist/{vendor-zxXa3Dmr.min.js → vendor-BlSxe9JJ.min.js} +3 -3
  29. package/dist/{vendor-BSD1RQIh.js → vendor-BmYIgaS1.js} +3 -3
  30. package/dist/{vendor-DHr4aqIZ.umd.cjs → vendor-Cavtu3CP.umd.cjs} +3 -3
  31. package/lib/asap/needle-asap.d.ts +1 -1
  32. package/lib/asap/needle-asap.js +95 -95
  33. package/lib/asap/sessiongranted.d.ts +3 -3
  34. package/lib/asap/sessiongranted.js +65 -65
  35. package/lib/asap/utils.d.ts +1 -1
  36. package/lib/asap/utils.js +3 -3
  37. package/lib/engine/analytics/index.d.ts +6 -6
  38. package/lib/engine/analytics/index.js +12 -12
  39. package/lib/engine/analytics/lcp.d.ts +3 -3
  40. package/lib/engine/analytics/lcp.js +34 -34
  41. package/lib/engine/api.d.ts +82 -82
  42. package/lib/engine/api.js +81 -81
  43. package/lib/engine/assets/index.d.ts +11 -11
  44. package/lib/engine/assets/index.js +47 -47
  45. package/lib/engine/assets/static.d.ts +1 -1
  46. package/lib/engine/assets/static.js +4 -4
  47. package/lib/engine/codegen/register_types.d.ts +1 -1
  48. package/lib/engine/codegen/register_types.js +300 -300
  49. package/lib/engine/debug/debug.d.ts +15 -15
  50. package/lib/engine/debug/debug.js +44 -44
  51. package/lib/engine/debug/debug_console.d.ts +2 -2
  52. package/lib/engine/debug/debug_console.js +307 -307
  53. package/lib/engine/debug/debug_overlay.d.ts +22 -22
  54. package/lib/engine/debug/debug_overlay.js +316 -316
  55. package/lib/engine/debug/debug_spatial_console.d.ts +2 -2
  56. package/lib/engine/debug/debug_spatial_console.js +390 -390
  57. package/lib/engine/debug/index.d.ts +2 -2
  58. package/lib/engine/debug/index.js +2 -2
  59. package/lib/engine/engine_addressables.d.ts +166 -166
  60. package/lib/engine/engine_addressables.js +608 -608
  61. package/lib/engine/engine_animation.d.ts +43 -43
  62. package/lib/engine/engine_animation.js +133 -133
  63. package/lib/engine/engine_application.d.ts +45 -45
  64. package/lib/engine/engine_application.js +104 -104
  65. package/lib/engine/engine_assetdatabase.d.ts +25 -25
  66. package/lib/engine/engine_assetdatabase.js +346 -346
  67. package/lib/engine/engine_audio.d.ts +4 -4
  68. package/lib/engine/engine_audio.js +23 -23
  69. package/lib/engine/engine_camera.d.ts +13 -13
  70. package/lib/engine/engine_camera.js +30 -30
  71. package/lib/engine/engine_components.d.ts +110 -110
  72. package/lib/engine/engine_components.js +374 -374
  73. package/lib/engine/engine_components_internal.d.ts +9 -9
  74. package/lib/engine/engine_components_internal.js +36 -36
  75. package/lib/engine/engine_constants.d.ts +10 -10
  76. package/lib/engine/engine_constants.js +41 -41
  77. package/lib/engine/engine_context.d.ts +475 -475
  78. package/lib/engine/engine_context.js +1672 -1672
  79. package/lib/engine/engine_context_registry.d.ts +71 -71
  80. package/lib/engine/engine_context_registry.js +117 -117
  81. package/lib/engine/engine_coroutine.d.ts +35 -35
  82. package/lib/engine/engine_coroutine.js +52 -52
  83. package/lib/engine/engine_create_objects.d.ts +119 -119
  84. package/lib/engine/engine_create_objects.js +320 -320
  85. package/lib/engine/engine_default_parameters.d.ts +2 -2
  86. package/lib/engine/engine_default_parameters.js +3 -3
  87. package/lib/engine/engine_editor-sync.d.ts +21 -21
  88. package/lib/engine/engine_editor-sync.js +4 -4
  89. package/lib/engine/engine_fileloader.d.ts +2 -2
  90. package/lib/engine/engine_fileloader.js +8 -8
  91. package/lib/engine/engine_gameobject.d.ts +68 -68
  92. package/lib/engine/engine_gameobject.js +619 -619
  93. package/lib/engine/engine_generic_utils.d.ts +1 -1
  94. package/lib/engine/engine_generic_utils.js +13 -13
  95. package/lib/engine/engine_gizmos.d.ts +149 -149
  96. package/lib/engine/engine_gizmos.js +530 -530
  97. package/lib/engine/engine_gltf.d.ts +12 -12
  98. package/lib/engine/engine_gltf.js +15 -15
  99. package/lib/engine/engine_gltf_builtin_components.d.ts +11 -11
  100. package/lib/engine/engine_gltf_builtin_components.js +341 -341
  101. package/lib/engine/engine_hot_reload.d.ts +8 -8
  102. package/lib/engine/engine_hot_reload.js +197 -197
  103. package/lib/engine/engine_input.d.ts +362 -362
  104. package/lib/engine/engine_input.js +1294 -1294
  105. package/lib/engine/engine_input_utils.d.ts +2 -2
  106. package/lib/engine/engine_input_utils.js +22 -22
  107. package/lib/engine/engine_instancing.d.ts +19 -19
  108. package/lib/engine/engine_instancing.js +39 -39
  109. package/lib/engine/engine_license.d.ts +11 -11
  110. package/lib/engine/engine_license.js +369 -369
  111. package/lib/engine/engine_lifecycle_api.d.ts +83 -83
  112. package/lib/engine/engine_lifecycle_api.js +106 -106
  113. package/lib/engine/engine_lifecycle_functions_internal.d.ts +32 -32
  114. package/lib/engine/engine_lifecycle_functions_internal.js +146 -146
  115. package/lib/engine/engine_lightdata.d.ts +23 -23
  116. package/lib/engine/engine_lightdata.js +91 -91
  117. package/lib/engine/engine_loaders.callbacks.d.ts +97 -97
  118. package/lib/engine/engine_loaders.callbacks.js +86 -86
  119. package/lib/engine/engine_loaders.d.ts +48 -48
  120. package/lib/engine/engine_loaders.gltf.d.ts +13 -13
  121. package/lib/engine/engine_loaders.gltf.js +62 -62
  122. package/lib/engine/engine_loaders.js +337 -337
  123. package/lib/engine/engine_lods.d.ts +31 -31
  124. package/lib/engine/engine_lods.js +146 -146
  125. package/lib/engine/engine_mainloop_utils.d.ts +32 -32
  126. package/lib/engine/engine_mainloop_utils.js +466 -466
  127. package/lib/engine/engine_math.d.ts +114 -114
  128. package/lib/engine/engine_math.js +247 -247
  129. package/lib/engine/engine_modules.d.ts +36 -36
  130. package/lib/engine/engine_modules.js +85 -85
  131. package/lib/engine/engine_networking.d.ts +260 -260
  132. package/lib/engine/engine_networking.js +764 -764
  133. package/lib/engine/engine_networking_auto.d.ts +24 -24
  134. package/lib/engine/engine_networking_auto.js +310 -310
  135. package/lib/engine/engine_networking_blob.d.ts +48 -48
  136. package/lib/engine/engine_networking_blob.js +228 -228
  137. package/lib/engine/engine_networking_files.d.ts +35 -35
  138. package/lib/engine/engine_networking_files.js +172 -172
  139. package/lib/engine/engine_networking_files_default_components.d.ts +6 -6
  140. package/lib/engine/engine_networking_files_default_components.js +42 -42
  141. package/lib/engine/engine_networking_instantiate.d.ts +100 -100
  142. package/lib/engine/engine_networking_instantiate.js +345 -345
  143. package/lib/engine/engine_networking_peer.d.ts +15 -15
  144. package/lib/engine/engine_networking_peer.js +132 -132
  145. package/lib/engine/engine_networking_streams.d.ts +123 -123
  146. package/lib/engine/engine_networking_streams.js +645 -645
  147. package/lib/engine/engine_networking_types.d.ts +22 -22
  148. package/lib/engine/engine_networking_types.js +7 -7
  149. package/lib/engine/engine_networking_utils.d.ts +2 -2
  150. package/lib/engine/engine_networking_utils.js +20 -20
  151. package/lib/engine/engine_networking_websocket.d.ts +1 -1
  152. package/lib/engine/engine_networking_websocket.js +2 -2
  153. package/lib/engine/engine_patcher.d.ts +10 -10
  154. package/lib/engine/engine_patcher.js +142 -142
  155. package/lib/engine/engine_physics.d.ts +152 -152
  156. package/lib/engine/engine_physics.js +645 -645
  157. package/lib/engine/engine_physics.types.d.ts +40 -40
  158. package/lib/engine/engine_physics.types.js +33 -33
  159. package/lib/engine/engine_physics_rapier.d.ts +147 -147
  160. package/lib/engine/engine_physics_rapier.js +1433 -1433
  161. package/lib/engine/engine_playerview.d.ts +26 -26
  162. package/lib/engine/engine_playerview.js +64 -64
  163. package/lib/engine/engine_scenelighting.d.ts +71 -71
  164. package/lib/engine/engine_scenelighting.js +226 -226
  165. package/lib/engine/engine_serialization.d.ts +3 -3
  166. package/lib/engine/engine_serialization.js +3 -3
  167. package/lib/engine/engine_serialization_builtin_serializer.d.ts +72 -72
  168. package/lib/engine/engine_serialization_builtin_serializer.js +403 -403
  169. package/lib/engine/engine_serialization_core.d.ts +94 -94
  170. package/lib/engine/engine_serialization_core.js +607 -607
  171. package/lib/engine/engine_serialization_decorator.d.ts +23 -23
  172. package/lib/engine/engine_serialization_decorator.js +66 -66
  173. package/lib/engine/engine_setup.d.ts +1 -1
  174. package/lib/engine/engine_setup.js +2 -2
  175. package/lib/engine/engine_shaders.d.ts +53 -53
  176. package/lib/engine/engine_shaders.js +252 -252
  177. package/lib/engine/engine_shims.d.ts +4 -4
  178. package/lib/engine/engine_shims.js +24 -24
  179. package/lib/engine/engine_test_utils.d.ts +39 -39
  180. package/lib/engine/engine_test_utils.js +83 -83
  181. package/lib/engine/engine_texture.d.ts +28 -28
  182. package/lib/engine/engine_texture.js +64 -64
  183. package/lib/engine/engine_three_utils.d.ts +204 -204
  184. package/lib/engine/engine_three_utils.js +784 -784
  185. package/lib/engine/engine_time.d.ts +51 -51
  186. package/lib/engine/engine_time.js +82 -82
  187. package/lib/engine/engine_time_utils.d.ts +88 -88
  188. package/lib/engine/engine_time_utils.js +215 -215
  189. package/lib/engine/engine_tonemapping.d.ts +6 -6
  190. package/lib/engine/engine_tonemapping.js +197 -197
  191. package/lib/engine/engine_types.d.ts +578 -578
  192. package/lib/engine/engine_types.js +95 -95
  193. package/lib/engine/engine_typestore.d.ts +28 -28
  194. package/lib/engine/engine_typestore.js +55 -55
  195. package/lib/engine/engine_util_decorator.d.ts +13 -13
  196. package/lib/engine/engine_util_decorator.js +116 -116
  197. package/lib/engine/engine_utils.d.ts +248 -248
  198. package/lib/engine/engine_utils.js +1012 -1012
  199. package/lib/engine/engine_utils_format.d.ts +24 -24
  200. package/lib/engine/engine_utils_format.js +239 -239
  201. package/lib/engine/engine_utils_screenshot.d.ts +159 -159
  202. package/lib/engine/engine_utils_screenshot.js +522 -522
  203. package/lib/engine/engine_utils_screenshot.xr.d.ts +5 -5
  204. package/lib/engine/engine_utils_screenshot.xr.js +90 -90
  205. package/lib/engine/engine_xr.d.ts +1 -1
  206. package/lib/engine/engine_xr.js +1 -1
  207. package/lib/engine/export/gltf/Writers.d.ts +19 -19
  208. package/lib/engine/export/gltf/Writers.js +24 -24
  209. package/lib/engine/export/gltf/index.d.ts +11 -11
  210. package/lib/engine/export/gltf/index.js +123 -123
  211. package/lib/engine/export/index.d.ts +2 -2
  212. package/lib/engine/export/index.js +2 -2
  213. package/lib/engine/export/state.d.ts +7 -7
  214. package/lib/engine/export/state.js +17 -17
  215. package/lib/engine/export/utils.d.ts +2 -2
  216. package/lib/engine/export/utils.js +7 -7
  217. package/lib/engine/extensions/EXT_texture_exr.d.ts +8 -8
  218. package/lib/engine/extensions/EXT_texture_exr.js +32 -32
  219. package/lib/engine/extensions/NEEDLE_animator_controller_model.d.ts +122 -122
  220. package/lib/engine/extensions/NEEDLE_animator_controller_model.js +95 -95
  221. package/lib/engine/extensions/NEEDLE_components.d.ts +35 -35
  222. package/lib/engine/extensions/NEEDLE_components.js +220 -220
  223. package/lib/engine/extensions/NEEDLE_gameobject_data.d.ts +10 -10
  224. package/lib/engine/extensions/NEEDLE_gameobject_data.js +57 -57
  225. package/lib/engine/extensions/NEEDLE_lighting_settings.d.ts +37 -37
  226. package/lib/engine/extensions/NEEDLE_lighting_settings.js +157 -157
  227. package/lib/engine/extensions/NEEDLE_lightmaps.d.ts +18 -18
  228. package/lib/engine/extensions/NEEDLE_lightmaps.js +99 -99
  229. package/lib/engine/extensions/NEEDLE_persistent_assets.d.ts +11 -11
  230. package/lib/engine/extensions/NEEDLE_persistent_assets.js +63 -63
  231. package/lib/engine/extensions/NEEDLE_progressive.d.ts +1 -1
  232. package/lib/engine/extensions/NEEDLE_progressive.js +1 -1
  233. package/lib/engine/extensions/NEEDLE_render_objects.d.ts +13 -13
  234. package/lib/engine/extensions/NEEDLE_render_objects.js +159 -159
  235. package/lib/engine/extensions/NEEDLE_techniques_webgl.d.ts +38 -38
  236. package/lib/engine/extensions/NEEDLE_techniques_webgl.js +564 -564
  237. package/lib/engine/extensions/extension_resolver.d.ts +4 -4
  238. package/lib/engine/extensions/extension_resolver.js +1 -1
  239. package/lib/engine/extensions/extension_utils.d.ts +12 -12
  240. package/lib/engine/extensions/extension_utils.js +152 -152
  241. package/lib/engine/extensions/extensions.d.ts +32 -32
  242. package/lib/engine/extensions/extensions.js +107 -107
  243. package/lib/engine/extensions/index.d.ts +6 -6
  244. package/lib/engine/extensions/index.js +6 -6
  245. package/lib/engine/extensions/usage_tracker.d.ts +13 -13
  246. package/lib/engine/extensions/usage_tracker.js +65 -65
  247. package/lib/engine/js-extensions/Camera.d.ts +1 -1
  248. package/lib/engine/js-extensions/Camera.js +39 -39
  249. package/lib/engine/js-extensions/ExtensionUtils.d.ts +9 -9
  250. package/lib/engine/js-extensions/ExtensionUtils.js +67 -67
  251. package/lib/engine/js-extensions/Layers.d.ts +6 -6
  252. package/lib/engine/js-extensions/Layers.js +22 -22
  253. package/lib/engine/js-extensions/Object3D.d.ts +120 -120
  254. package/lib/engine/js-extensions/Object3D.js +136 -136
  255. package/lib/engine/js-extensions/RGBAColor.d.ts +23 -23
  256. package/lib/engine/js-extensions/RGBAColor.js +111 -111
  257. package/lib/engine/js-extensions/Vector.d.ts +3 -3
  258. package/lib/engine/js-extensions/Vector.js +13 -13
  259. package/lib/engine/js-extensions/index.d.ts +5 -5
  260. package/lib/engine/js-extensions/index.js +5 -5
  261. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.d.ts +4 -4
  262. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +79 -79
  263. package/lib/engine/shaders/shaderData.d.ts +55 -55
  264. package/lib/engine/shaders/shaderData.js +58 -58
  265. package/lib/engine/tests/test_utils.d.ts +2 -2
  266. package/lib/engine/tests/test_utils.js +53 -53
  267. package/lib/engine/webcomponents/WebXRButtons.d.ts +56 -56
  268. package/lib/engine/webcomponents/WebXRButtons.js +230 -230
  269. package/lib/engine/webcomponents/api.d.ts +5 -5
  270. package/lib/engine/webcomponents/api.js +4 -4
  271. package/lib/engine/webcomponents/buttons.d.ts +51 -51
  272. package/lib/engine/webcomponents/buttons.js +264 -264
  273. package/lib/engine/webcomponents/fonts.d.ts +9 -9
  274. package/lib/engine/webcomponents/fonts.js +32 -32
  275. package/lib/engine/webcomponents/icons.d.ts +9 -9
  276. package/lib/engine/webcomponents/icons.js +52 -52
  277. package/lib/engine/webcomponents/index.d.ts +1 -1
  278. package/lib/engine/webcomponents/index.js +1 -1
  279. package/lib/engine/webcomponents/logo-element.d.ts +10 -10
  280. package/lib/engine/webcomponents/logo-element.js +67 -67
  281. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.d.ts +37 -37
  282. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.js +513 -513
  283. package/lib/engine/webcomponents/needle menu/needle-menu.d.ts +155 -155
  284. package/lib/engine/webcomponents/needle menu/needle-menu.js +1029 -1029
  285. package/lib/engine/webcomponents/needle-button.d.ts +34 -34
  286. package/lib/engine/webcomponents/needle-button.js +161 -161
  287. package/lib/engine/webcomponents/needle-engine.ar-overlay.d.ts +21 -21
  288. package/lib/engine/webcomponents/needle-engine.ar-overlay.js +166 -166
  289. package/lib/engine/webcomponents/needle-engine.attributes.d.ts +69 -69
  290. package/lib/engine/webcomponents/needle-engine.attributes.js +1 -1
  291. package/lib/engine/webcomponents/needle-engine.d.ts +116 -116
  292. package/lib/engine/webcomponents/needle-engine.extras.d.ts +6 -6
  293. package/lib/engine/webcomponents/needle-engine.extras.js +13 -13
  294. package/lib/engine/webcomponents/needle-engine.js +821 -821
  295. package/lib/engine/webcomponents/needle-engine.loading.d.ts +44 -44
  296. package/lib/engine/webcomponents/needle-engine.loading.js +341 -341
  297. package/lib/engine/xr/NeedleXRController.d.ts +313 -313
  298. package/lib/engine/xr/NeedleXRController.js +1007 -1007
  299. package/lib/engine/xr/NeedleXRSession.d.ts +340 -340
  300. package/lib/engine/xr/NeedleXRSession.js +1463 -1463
  301. package/lib/engine/xr/NeedleXRSync.d.ts +22 -22
  302. package/lib/engine/xr/NeedleXRSync.js +188 -188
  303. package/lib/engine/xr/SceneTransition.d.ts +18 -18
  304. package/lib/engine/xr/SceneTransition.js +69 -69
  305. package/lib/engine/xr/TempXRContext.d.ts +34 -34
  306. package/lib/engine/xr/TempXRContext.js +187 -187
  307. package/lib/engine/xr/XRRig.d.ts +7 -7
  308. package/lib/engine/xr/XRRig.js +1 -1
  309. package/lib/engine/xr/api.d.ts +6 -6
  310. package/lib/engine/xr/api.js +6 -6
  311. package/lib/engine/xr/events.d.ts +66 -66
  312. package/lib/engine/xr/events.js +93 -93
  313. package/lib/engine/xr/internal.d.ts +12 -12
  314. package/lib/engine/xr/internal.js +25 -25
  315. package/lib/engine/xr/usdz.d.ts +12 -12
  316. package/lib/engine/xr/usdz.js +29 -29
  317. package/lib/engine/xr/utils.d.ts +11 -11
  318. package/lib/engine/xr/utils.js +34 -34
  319. package/lib/engine-components/AlignmentConstraint.d.ts +10 -10
  320. package/lib/engine-components/AlignmentConstraint.js +39 -39
  321. package/lib/engine-components/Animation.d.ts +156 -156
  322. package/lib/engine-components/Animation.js +508 -508
  323. package/lib/engine-components/AnimationCurve.d.ts +40 -40
  324. package/lib/engine-components/AnimationCurve.js +159 -159
  325. package/lib/engine-components/AnimationUtils.d.ts +8 -8
  326. package/lib/engine-components/AnimationUtils.js +27 -27
  327. package/lib/engine-components/AnimationUtilsAutoplay.d.ts +1 -1
  328. package/lib/engine-components/AnimationUtilsAutoplay.js +39 -39
  329. package/lib/engine-components/Animator.d.ts +217 -217
  330. package/lib/engine-components/Animator.js +354 -354
  331. package/lib/engine-components/AnimatorController.d.ts +227 -227
  332. package/lib/engine-components/AnimatorController.js +1152 -1152
  333. package/lib/engine-components/AudioListener.d.ts +33 -33
  334. package/lib/engine-components/AudioListener.js +86 -86
  335. package/lib/engine-components/AudioSource.d.ts +217 -217
  336. package/lib/engine-components/AudioSource.js +635 -635
  337. package/lib/engine-components/AvatarLoader.d.ts +80 -80
  338. package/lib/engine-components/AvatarLoader.js +231 -231
  339. package/lib/engine-components/AxesHelper.d.ts +32 -32
  340. package/lib/engine-components/AxesHelper.js +67 -67
  341. package/lib/engine-components/BasicIKConstraint.d.ts +9 -9
  342. package/lib/engine-components/BasicIKConstraint.js +43 -43
  343. package/lib/engine-components/BoxCollider.d.ts +2 -2
  344. package/lib/engine-components/BoxCollider.js +2 -2
  345. package/lib/engine-components/BoxHelperComponent.d.ts +47 -47
  346. package/lib/engine-components/BoxHelperComponent.js +102 -102
  347. package/lib/engine-components/Camera.d.ts +231 -231
  348. package/lib/engine-components/Camera.js +700 -700
  349. package/lib/engine-components/CameraUtils.d.ts +1 -1
  350. package/lib/engine-components/CameraUtils.js +121 -121
  351. package/lib/engine-components/CharacterController.d.ts +55 -55
  352. package/lib/engine-components/CharacterController.js +236 -236
  353. package/lib/engine-components/Collider.d.ts +188 -188
  354. package/lib/engine-components/Collider.js +369 -369
  355. package/lib/engine-components/Component.d.ts +792 -792
  356. package/lib/engine-components/Component.js +920 -920
  357. package/lib/engine-components/ContactShadows.d.ts +94 -94
  358. package/lib/engine-components/ContactShadows.js +453 -453
  359. package/lib/engine-components/DeleteBox.d.ts +19 -19
  360. package/lib/engine-components/DeleteBox.js +58 -58
  361. package/lib/engine-components/DeviceFlag.d.ts +16 -16
  362. package/lib/engine-components/DeviceFlag.js +47 -47
  363. package/lib/engine-components/DragControls.d.ts +170 -170
  364. package/lib/engine-components/DragControls.js +1421 -1421
  365. package/lib/engine-components/DropListener.d.ts +215 -215
  366. package/lib/engine-components/DropListener.js +642 -642
  367. package/lib/engine-components/Duplicatable.d.ts +35 -35
  368. package/lib/engine-components/Duplicatable.js +202 -202
  369. package/lib/engine-components/EventList.d.ts +54 -54
  370. package/lib/engine-components/EventList.js +232 -232
  371. package/lib/engine-components/EventTrigger.d.ts +33 -33
  372. package/lib/engine-components/EventTrigger.js +75 -75
  373. package/lib/engine-components/EventType.d.ts +22 -22
  374. package/lib/engine-components/EventType.js +23 -23
  375. package/lib/engine-components/Fog.d.ts +22 -22
  376. package/lib/engine-components/Fog.js +61 -61
  377. package/lib/engine-components/Gizmos.d.ts +17 -17
  378. package/lib/engine-components/Gizmos.js +64 -64
  379. package/lib/engine-components/GridHelper.d.ts +20 -20
  380. package/lib/engine-components/GridHelper.js +54 -54
  381. package/lib/engine-components/GroundProjection.d.ts +67 -67
  382. package/lib/engine-components/GroundProjection.js +343 -343
  383. package/lib/engine-components/Interactable.d.ts +12 -12
  384. package/lib/engine-components/Interactable.js +12 -12
  385. package/lib/engine-components/Joints.d.ts +19 -19
  386. package/lib/engine-components/Joints.js +51 -51
  387. package/lib/engine-components/LODGroup.d.ts +35 -35
  388. package/lib/engine-components/LODGroup.js +152 -152
  389. package/lib/engine-components/Light.d.ts +180 -180
  390. package/lib/engine-components/Light.js +535 -535
  391. package/lib/engine-components/LookAtConstraint.d.ts +19 -19
  392. package/lib/engine-components/LookAtConstraint.js +35 -35
  393. package/lib/engine-components/NeedleMenu.d.ts +50 -50
  394. package/lib/engine-components/NeedleMenu.js +92 -92
  395. package/lib/engine-components/NestedGltf.d.ts +25 -25
  396. package/lib/engine-components/NestedGltf.js +88 -88
  397. package/lib/engine-components/Networking.d.ts +54 -54
  398. package/lib/engine-components/Networking.js +112 -112
  399. package/lib/engine-components/OffsetConstraint.d.ts +14 -14
  400. package/lib/engine-components/OffsetConstraint.js +65 -65
  401. package/lib/engine-components/OrbitControls.d.ts +268 -268
  402. package/lib/engine-components/OrbitControls.js +1015 -1015
  403. package/lib/engine-components/PlayerColor.d.ts +19 -19
  404. package/lib/engine-components/PlayerColor.js +94 -94
  405. package/lib/engine-components/ReflectionProbe.d.ts +28 -28
  406. package/lib/engine-components/ReflectionProbe.js +204 -204
  407. package/lib/engine-components/Renderer.d.ts +153 -153
  408. package/lib/engine-components/Renderer.js +834 -834
  409. package/lib/engine-components/RendererInstancing.d.ts +140 -140
  410. package/lib/engine-components/RendererInstancing.js +744 -744
  411. package/lib/engine-components/RendererLightmap.d.ts +24 -24
  412. package/lib/engine-components/RendererLightmap.js +182 -182
  413. package/lib/engine-components/RigidBody.d.ts +155 -155
  414. package/lib/engine-components/RigidBody.js +517 -517
  415. package/lib/engine-components/SceneSwitcher.d.ts +263 -263
  416. package/lib/engine-components/SceneSwitcher.js +971 -971
  417. package/lib/engine-components/ScreenCapture.d.ts +144 -144
  418. package/lib/engine-components/ScreenCapture.js +547 -547
  419. package/lib/engine-components/ShadowCatcher.d.ts +33 -33
  420. package/lib/engine-components/ShadowCatcher.js +166 -166
  421. package/lib/engine-components/Skybox.d.ts +88 -88
  422. package/lib/engine-components/Skybox.js +469 -469
  423. package/lib/engine-components/SmoothFollow.d.ts +34 -34
  424. package/lib/engine-components/SmoothFollow.js +82 -82
  425. package/lib/engine-components/SpatialTrigger.d.ts +102 -102
  426. package/lib/engine-components/SpatialTrigger.js +225 -225
  427. package/lib/engine-components/SpectatorCamera.d.ts +111 -111
  428. package/lib/engine-components/SpectatorCamera.js +715 -715
  429. package/lib/engine-components/SphereCollider.d.ts +2 -2
  430. package/lib/engine-components/SphereCollider.js +2 -2
  431. package/lib/engine-components/SpriteRenderer.d.ts +132 -132
  432. package/lib/engine-components/SpriteRenderer.js +472 -472
  433. package/lib/engine-components/SyncedCamera.d.ts +41 -41
  434. package/lib/engine-components/SyncedCamera.js +199 -199
  435. package/lib/engine-components/SyncedRoom.d.ts +106 -106
  436. package/lib/engine-components/SyncedRoom.js +371 -371
  437. package/lib/engine-components/SyncedTransform.d.ts +94 -94
  438. package/lib/engine-components/SyncedTransform.js +331 -331
  439. package/lib/engine-components/TestRunner.d.ts +16 -16
  440. package/lib/engine-components/TestRunner.js +102 -102
  441. package/lib/engine-components/TransformGizmo.d.ts +75 -75
  442. package/lib/engine-components/TransformGizmo.js +209 -209
  443. package/lib/engine-components/VideoPlayer.d.ts +184 -184
  444. package/lib/engine-components/VideoPlayer.js +978 -978
  445. package/lib/engine-components/Voip.d.ts +67 -67
  446. package/lib/engine-components/Voip.js +360 -360
  447. package/lib/engine-components/api.d.ts +51 -51
  448. package/lib/engine-components/api.js +50 -50
  449. package/lib/engine-components/avatar/AvatarBlink_Simple.d.ts +11 -11
  450. package/lib/engine-components/avatar/AvatarBlink_Simple.js +76 -76
  451. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.d.ts +14 -14
  452. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.js +68 -68
  453. package/lib/engine-components/avatar/Avatar_Brain_LookAt.d.ts +29 -29
  454. package/lib/engine-components/avatar/Avatar_Brain_LookAt.js +121 -121
  455. package/lib/engine-components/avatar/Avatar_MouthShapes.d.ts +15 -15
  456. package/lib/engine-components/avatar/Avatar_MouthShapes.js +79 -79
  457. package/lib/engine-components/avatar/Avatar_MustacheShake.d.ts +9 -9
  458. package/lib/engine-components/avatar/Avatar_MustacheShake.js +29 -29
  459. package/lib/engine-components/codegen/components.d.ts +216 -216
  460. package/lib/engine-components/codegen/components.js +218 -218
  461. package/lib/engine-components/debug/LogStats.d.ts +5 -5
  462. package/lib/engine-components/debug/LogStats.js +18 -18
  463. package/lib/engine-components/export/gltf/GltfExport.d.ts +30 -30
  464. package/lib/engine-components/export/gltf/GltfExport.js +246 -246
  465. package/lib/engine-components/export/gltf/index.d.ts +1 -1
  466. package/lib/engine-components/export/gltf/index.js +1 -1
  467. package/lib/engine-components/export/index.d.ts +1 -1
  468. package/lib/engine-components/export/index.js +1 -1
  469. package/lib/engine-components/export/usdz/Extension.d.ts +22 -22
  470. package/lib/engine-components/export/usdz/Extension.js +1 -1
  471. package/lib/engine-components/export/usdz/ThreeUSDZExporter.d.ts +162 -162
  472. package/lib/engine-components/export/usdz/ThreeUSDZExporter.js +1789 -1789
  473. package/lib/engine-components/export/usdz/USDZExporter.d.ts +130 -130
  474. package/lib/engine-components/export/usdz/USDZExporter.js +663 -663
  475. package/lib/engine-components/export/usdz/extensions/Animation.d.ts +106 -106
  476. package/lib/engine-components/export/usdz/extensions/Animation.js +1071 -1071
  477. package/lib/engine-components/export/usdz/extensions/DocumentExtension.d.ts +5 -5
  478. package/lib/engine-components/export/usdz/extensions/DocumentExtension.js +6 -6
  479. package/lib/engine-components/export/usdz/extensions/NodeMaterialConverter.d.ts +10 -10
  480. package/lib/engine-components/export/usdz/extensions/NodeMaterialConverter.js +451 -451
  481. package/lib/engine-components/export/usdz/extensions/USDZText.d.ts +54 -54
  482. package/lib/engine-components/export/usdz/extensions/USDZText.js +203 -203
  483. package/lib/engine-components/export/usdz/extensions/USDZUI.d.ts +8 -8
  484. package/lib/engine-components/export/usdz/extensions/USDZUI.js +158 -158
  485. package/lib/engine-components/export/usdz/extensions/behavior/Actions.d.ts +30 -30
  486. package/lib/engine-components/export/usdz/extensions/behavior/Actions.js +88 -88
  487. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.d.ts +10 -10
  488. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.js +86 -86
  489. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.d.ts +28 -28
  490. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.js +290 -290
  491. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.d.ts +190 -190
  492. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.js +1060 -1060
  493. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.d.ts +135 -135
  494. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.js +548 -548
  495. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.d.ts +7 -7
  496. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.js +115 -115
  497. package/lib/engine-components/export/usdz/index.d.ts +3 -3
  498. package/lib/engine-components/export/usdz/index.js +2 -2
  499. package/lib/engine-components/export/usdz/utils/animationutils.d.ts +7 -7
  500. package/lib/engine-components/export/usdz/utils/animationutils.js +163 -163
  501. package/lib/engine-components/export/usdz/utils/quicklook.d.ts +2 -2
  502. package/lib/engine-components/export/usdz/utils/quicklook.js +43 -43
  503. package/lib/engine-components/particlesystem/ParticleSystem.d.ts +177 -177
  504. package/lib/engine-components/particlesystem/ParticleSystem.js +1176 -1176
  505. package/lib/engine-components/particlesystem/ParticleSystemModules.d.ts +526 -526
  506. package/lib/engine-components/particlesystem/ParticleSystemModules.js +1930 -1930
  507. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.d.ts +25 -25
  508. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.js +87 -87
  509. package/lib/engine-components/particlesystem/api.d.ts +2 -2
  510. package/lib/engine-components/particlesystem/api.js +2 -2
  511. package/lib/engine-components/postprocessing/Effects/Antialiasing.d.ts +17 -17
  512. package/lib/engine-components/postprocessing/Effects/Antialiasing.js +52 -52
  513. package/lib/engine-components/postprocessing/Effects/BloomEffect.d.ts +46 -46
  514. package/lib/engine-components/postprocessing/Effects/BloomEffect.js +113 -113
  515. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.d.ts +11 -11
  516. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.js +39 -39
  517. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.d.ts +23 -23
  518. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.js +111 -111
  519. package/lib/engine-components/postprocessing/Effects/DepthOfField.d.ts +25 -25
  520. package/lib/engine-components/postprocessing/Effects/DepthOfField.js +104 -104
  521. package/lib/engine-components/postprocessing/Effects/EffectWrapper.d.ts +12 -12
  522. package/lib/engine-components/postprocessing/Effects/EffectWrapper.js +18 -18
  523. package/lib/engine-components/postprocessing/Effects/Pixelation.d.ts +11 -11
  524. package/lib/engine-components/postprocessing/Effects/Pixelation.js +32 -32
  525. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.d.ts +18 -18
  526. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.js +91 -91
  527. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.d.ts +70 -70
  528. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.js +176 -176
  529. package/lib/engine-components/postprocessing/Effects/Sharpening.d.ts +18 -18
  530. package/lib/engine-components/postprocessing/Effects/Sharpening.js +127 -127
  531. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.d.ts +17 -17
  532. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.js +70 -70
  533. package/lib/engine-components/postprocessing/Effects/Tonemapping.d.ts +19 -19
  534. package/lib/engine-components/postprocessing/Effects/Tonemapping.js +94 -94
  535. package/lib/engine-components/postprocessing/Effects/Tonemapping.utils.d.ts +13 -13
  536. package/lib/engine-components/postprocessing/Effects/Tonemapping.utils.js +51 -51
  537. package/lib/engine-components/postprocessing/Effects/Vignette.d.ts +15 -15
  538. package/lib/engine-components/postprocessing/Effects/Vignette.js +60 -60
  539. package/lib/engine-components/postprocessing/PostProcessingEffect.d.ts +90 -90
  540. package/lib/engine-components/postprocessing/PostProcessingEffect.js +168 -168
  541. package/lib/engine-components/postprocessing/PostProcessingHandler.d.ts +42 -42
  542. package/lib/engine-components/postprocessing/PostProcessingHandler.js +480 -480
  543. package/lib/engine-components/postprocessing/Volume.d.ts +90 -90
  544. package/lib/engine-components/postprocessing/Volume.js +385 -385
  545. package/lib/engine-components/postprocessing/VolumeParameter.d.ts +26 -26
  546. package/lib/engine-components/postprocessing/VolumeParameter.js +136 -136
  547. package/lib/engine-components/postprocessing/VolumeProfile.d.ts +15 -15
  548. package/lib/engine-components/postprocessing/VolumeProfile.js +60 -60
  549. package/lib/engine-components/postprocessing/index.d.ts +6 -6
  550. package/lib/engine-components/postprocessing/index.js +6 -6
  551. package/lib/engine-components/postprocessing/utils.d.ts +55 -55
  552. package/lib/engine-components/postprocessing/utils.js +119 -119
  553. package/lib/engine-components/timeline/PlayableDirector.d.ts +163 -163
  554. package/lib/engine-components/timeline/PlayableDirector.js +686 -686
  555. package/lib/engine-components/timeline/SignalAsset.d.ts +24 -24
  556. package/lib/engine-components/timeline/SignalAsset.js +130 -130
  557. package/lib/engine-components/timeline/TimelineModels.d.ts +89 -89
  558. package/lib/engine-components/timeline/TimelineModels.js +22 -22
  559. package/lib/engine-components/timeline/TimelineTracks.d.ts +110 -110
  560. package/lib/engine-components/timeline/TimelineTracks.js +879 -879
  561. package/lib/engine-components/timeline/index.d.ts +4 -4
  562. package/lib/engine-components/timeline/index.js +3 -3
  563. package/lib/engine-components/ui/BaseUIComponent.d.ts +48 -48
  564. package/lib/engine-components/ui/BaseUIComponent.js +170 -170
  565. package/lib/engine-components/ui/Button.d.ts +64 -64
  566. package/lib/engine-components/ui/Button.js +315 -315
  567. package/lib/engine-components/ui/Canvas.d.ts +74 -74
  568. package/lib/engine-components/ui/Canvas.js +407 -407
  569. package/lib/engine-components/ui/CanvasGroup.d.ts +19 -19
  570. package/lib/engine-components/ui/CanvasGroup.js +58 -58
  571. package/lib/engine-components/ui/EventSystem.d.ts +125 -125
  572. package/lib/engine-components/ui/EventSystem.js +765 -765
  573. package/lib/engine-components/ui/Graphic.d.ts +55 -55
  574. package/lib/engine-components/ui/Graphic.js +255 -255
  575. package/lib/engine-components/ui/Image.d.ts +35 -35
  576. package/lib/engine-components/ui/Image.js +116 -116
  577. package/lib/engine-components/ui/InputField.d.ts +42 -42
  578. package/lib/engine-components/ui/InputField.js +268 -268
  579. package/lib/engine-components/ui/Interfaces.d.ts +38 -38
  580. package/lib/engine-components/ui/Interfaces.js +12 -12
  581. package/lib/engine-components/ui/Layout.d.ts +84 -84
  582. package/lib/engine-components/ui/Layout.js +330 -330
  583. package/lib/engine-components/ui/Outline.d.ts +7 -7
  584. package/lib/engine-components/ui/Outline.js +20 -20
  585. package/lib/engine-components/ui/PointerEvents.d.ts +115 -115
  586. package/lib/engine-components/ui/PointerEvents.js +145 -145
  587. package/lib/engine-components/ui/RaycastUtils.d.ts +11 -11
  588. package/lib/engine-components/ui/RaycastUtils.js +67 -67
  589. package/lib/engine-components/ui/Raycaster.d.ts +30 -30
  590. package/lib/engine-components/ui/Raycaster.js +95 -95
  591. package/lib/engine-components/ui/RectTransform.d.ts +61 -61
  592. package/lib/engine-components/ui/RectTransform.js +356 -356
  593. package/lib/engine-components/ui/SpatialHtml.d.ts +8 -8
  594. package/lib/engine-components/ui/SpatialHtml.js +79 -79
  595. package/lib/engine-components/ui/Symbols.d.ts +1 -1
  596. package/lib/engine-components/ui/Symbols.js +1 -1
  597. package/lib/engine-components/ui/Text.d.ts +78 -78
  598. package/lib/engine-components/ui/Text.js +539 -539
  599. package/lib/engine-components/ui/Utils.d.ts +24 -24
  600. package/lib/engine-components/ui/Utils.js +90 -90
  601. package/lib/engine-components/ui/index.d.ts +1 -1
  602. package/lib/engine-components/ui/index.js +1 -1
  603. package/lib/engine-components/utils/EnvironmentScene.d.ts +5 -5
  604. package/lib/engine-components/utils/EnvironmentScene.js +205 -205
  605. package/lib/engine-components/utils/LookAt.d.ts +31 -31
  606. package/lib/engine-components/utils/LookAt.js +82 -82
  607. package/lib/engine-components/utils/OpenURL.d.ts +42 -42
  608. package/lib/engine-components/utils/OpenURL.js +119 -119
  609. package/lib/engine-components/webxr/Avatar.d.ts +25 -25
  610. package/lib/engine-components/webxr/Avatar.js +255 -255
  611. package/lib/engine-components/webxr/TeleportTarget.d.ts +7 -7
  612. package/lib/engine-components/webxr/TeleportTarget.js +7 -7
  613. package/lib/engine-components/webxr/WebARCameraBackground.d.ts +30 -30
  614. package/lib/engine-components/webxr/WebARCameraBackground.js +155 -155
  615. package/lib/engine-components/webxr/WebARSessionRoot.d.ts +98 -98
  616. package/lib/engine-components/webxr/WebARSessionRoot.js +770 -770
  617. package/lib/engine-components/webxr/WebXR.d.ts +232 -232
  618. package/lib/engine-components/webxr/WebXR.js +561 -561
  619. package/lib/engine-components/webxr/WebXRAvatar.d.ts +27 -27
  620. package/lib/engine-components/webxr/WebXRAvatar.js +44 -44
  621. package/lib/engine-components/webxr/WebXRImageTracking.d.ts +86 -86
  622. package/lib/engine-components/webxr/WebXRImageTracking.js +471 -471
  623. package/lib/engine-components/webxr/WebXRPlaneTracking.d.ts +92 -92
  624. package/lib/engine-components/webxr/WebXRPlaneTracking.js +500 -500
  625. package/lib/engine-components/webxr/WebXRRig.d.ts +32 -32
  626. package/lib/engine-components/webxr/WebXRRig.js +72 -72
  627. package/lib/engine-components/webxr/XRFlag.d.ts +38 -38
  628. package/lib/engine-components/webxr/XRFlag.js +139 -139
  629. package/lib/engine-components/webxr/controllers/XRControllerFollow.d.ts +47 -47
  630. package/lib/engine-components/webxr/controllers/XRControllerFollow.js +120 -120
  631. package/lib/engine-components/webxr/controllers/XRControllerModel.d.ts +43 -43
  632. package/lib/engine-components/webxr/controllers/XRControllerModel.js +352 -352
  633. package/lib/engine-components/webxr/controllers/XRControllerMovement.d.ts +78 -78
  634. package/lib/engine-components/webxr/controllers/XRControllerMovement.js +506 -506
  635. package/lib/engine-components/webxr/index.d.ts +3 -3
  636. package/lib/engine-components/webxr/index.js +3 -3
  637. package/lib/engine-components/webxr/types.d.ts +3 -3
  638. package/lib/engine-components/webxr/types.js +1 -1
  639. package/lib/engine-components-experimental/Presentation.d.ts +6 -6
  640. package/lib/engine-components-experimental/Presentation.js +9 -9
  641. package/lib/engine-components-experimental/api.d.ts +4 -4
  642. package/lib/engine-components-experimental/api.js +4 -4
  643. package/lib/engine-components-experimental/networking/PlayerSync.d.ts +156 -156
  644. package/lib/engine-components-experimental/networking/PlayerSync.js +377 -377
  645. package/lib/engine-schemes/api.d.ts +12 -12
  646. package/lib/engine-schemes/api.js +12 -12
  647. package/lib/engine-schemes/schemes.d.ts +7 -7
  648. package/lib/engine-schemes/schemes.js +19 -19
  649. package/lib/engine-schemes/synced-camera-model.d.ts +25 -25
  650. package/lib/engine-schemes/synced-camera-model.js +67 -67
  651. package/lib/engine-schemes/synced-transform-model.d.ts +31 -31
  652. package/lib/engine-schemes/synced-transform-model.js +66 -66
  653. package/lib/engine-schemes/transform.d.ts +12 -12
  654. package/lib/engine-schemes/transform.js +39 -39
  655. package/lib/engine-schemes/vec2.d.ts +10 -10
  656. package/lib/engine-schemes/vec2.js +25 -25
  657. package/lib/engine-schemes/vec3.d.ts +11 -11
  658. package/lib/engine-schemes/vec3.js +29 -29
  659. package/lib/engine-schemes/vec4.d.ts +12 -12
  660. package/lib/engine-schemes/vec4.js +33 -33
  661. package/lib/engine-schemes/vr-user-state-buffer.d.ts +37 -37
  662. package/lib/engine-schemes/vr-user-state-buffer.js +110 -110
  663. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.d.ts +6 -6
  664. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.js +45 -45
  665. package/lib/needle-engine.d.ts +7 -7
  666. package/lib/needle-engine.js +64 -64
  667. package/package.json +2 -2
  668. package/plugins/common/buildinfo.js +64 -64
  669. package/plugins/common/cloud.js +1 -1
  670. package/plugins/common/config.cjs +31 -31
  671. package/plugins/common/config.js +35 -35
  672. package/plugins/common/files.js +31 -31
  673. package/plugins/common/generator.js +10 -10
  674. package/plugins/common/license.js +452 -452
  675. package/plugins/common/npm.js +15 -15
  676. package/plugins/common/timers.js +7 -7
  677. package/plugins/common/version.js +37 -37
  678. package/plugins/gltf-packer.mjs +1 -1
  679. package/plugins/next/alias.cjs +39 -39
  680. package/plugins/next/license.cjs +24 -24
  681. package/plugins/next/meshbvhworker.cjs +18 -18
  682. package/plugins/next/next.js +141 -141
  683. package/plugins/types/index.d.ts +2 -2
  684. package/plugins/types/license.d.ts +24 -24
  685. package/plugins/types/needleConfig.d.ts +27 -27
  686. package/plugins/types/next.d.ts +2 -2
  687. package/plugins/types/userconfig.d.ts +120 -120
  688. package/plugins/types/vite.d.ts +13 -13
  689. package/plugins/types/webmanifest.d.ts +32 -32
  690. package/plugins/vite/alias.js +174 -174
  691. package/plugins/vite/asap.js +251 -251
  692. package/plugins/vite/build-pipeline.js +371 -371
  693. package/plugins/vite/build.js +19 -19
  694. package/plugins/vite/buildinfo.js +41 -41
  695. package/plugins/vite/config.js +106 -106
  696. package/plugins/vite/copyfiles.js +138 -138
  697. package/plugins/vite/defines.js +70 -70
  698. package/plugins/vite/dependencies.js +232 -232
  699. package/plugins/vite/dependency-watcher.js +237 -237
  700. package/plugins/vite/drop-client.js +76 -76
  701. package/plugins/vite/drop.js +87 -87
  702. package/plugins/vite/editor-connection.js +124 -124
  703. package/plugins/vite/facebook-instant-games.js +102 -102
  704. package/plugins/vite/gzip.js +5 -5
  705. package/plugins/vite/imports-logger.js +143 -143
  706. package/plugins/vite/index.js +143 -143
  707. package/plugins/vite/license.js +56 -56
  708. package/plugins/vite/local-files.js +440 -440
  709. package/plugins/vite/meta.js +163 -163
  710. package/plugins/vite/npm.js +7 -7
  711. package/plugins/vite/peer.js +29 -29
  712. package/plugins/vite/poster-client.js +73 -73
  713. package/plugins/vite/poster.js +79 -79
  714. package/plugins/vite/pwa.js +604 -604
  715. package/plugins/vite/reload-client.js +15 -15
  716. package/plugins/vite/reload.js +351 -351
  717. package/plugins/vite/server.js +66 -66
  718. package/plugins/vite/transform-codegen.js +55 -55
  719. package/plugins/vite/transform.js +31 -31
  720. package/plugins/vite/vite-4.4-hack.js +31 -31
  721. package/src/asap/needle-asap.ts +111 -111
  722. package/src/asap/sessiongranted.ts +75 -75
  723. package/src/asap/utils.ts +4 -4
  724. package/src/engine/analytics/index.ts +10 -10
  725. package/src/engine/analytics/lcp.ts +35 -35
  726. package/src/engine/api.ts +82 -82
  727. package/src/engine/assets/index.ts +59 -59
  728. package/src/engine/assets/static.js +5 -5
  729. package/src/engine/codegen/register_types.ts +300 -300
  730. package/src/engine/debug/debug.ts +51 -51
  731. package/src/engine/debug/debug_console.ts +333 -333
  732. package/src/engine/debug/debug_overlay.ts +332 -332
  733. package/src/engine/debug/debug_spatial_console.ts +429 -429
  734. package/src/engine/debug/index.ts +1 -1
  735. package/src/engine/engine_addressables.ts +680 -680
  736. package/src/engine/engine_animation.ts +145 -145
  737. package/src/engine/engine_application.ts +113 -113
  738. package/src/engine/engine_assetdatabase.ts +389 -389
  739. package/src/engine/engine_audio.ts +24 -24
  740. package/src/engine/engine_camera.ts +39 -39
  741. package/src/engine/engine_components.ts +366 -366
  742. package/src/engine/engine_components_internal.ts +40 -40
  743. package/src/engine/engine_constants.ts +52 -52
  744. package/src/engine/engine_context.ts +1823 -1823
  745. package/src/engine/engine_context_registry.ts +129 -129
  746. package/src/engine/engine_coroutine.ts +54 -54
  747. package/src/engine/engine_create_objects.ts +411 -411
  748. package/src/engine/engine_default_parameters.ts +3 -3
  749. package/src/engine/engine_editor-sync.ts +28 -28
  750. package/src/engine/engine_fileloader.js +9 -9
  751. package/src/engine/engine_gameobject.ts +712 -712
  752. package/src/engine/engine_generic_utils.js +13 -13
  753. package/src/engine/engine_gizmos.ts +577 -577
  754. package/src/engine/engine_gltf.ts +29 -29
  755. package/src/engine/engine_gltf_builtin_components.ts +403 -403
  756. package/src/engine/engine_hot_reload.ts +210 -210
  757. package/src/engine/engine_input.ts +1500 -1500
  758. package/src/engine/engine_input_utils.ts +23 -23
  759. package/src/engine/engine_instancing.ts +45 -45
  760. package/src/engine/engine_license.ts +386 -386
  761. package/src/engine/engine_lifecycle_api.ts +113 -113
  762. package/src/engine/engine_lifecycle_functions_internal.ts +193 -193
  763. package/src/engine/engine_lightdata.ts +117 -117
  764. package/src/engine/engine_loaders.callbacks.ts +136 -136
  765. package/src/engine/engine_loaders.gltf.ts +82 -82
  766. package/src/engine/engine_loaders.ts +378 -378
  767. package/src/engine/engine_lods.ts +168 -168
  768. package/src/engine/engine_mainloop_utils.ts +472 -472
  769. package/src/engine/engine_math.ts +282 -282
  770. package/src/engine/engine_modules.ts +83 -83
  771. package/src/engine/engine_networking.ts +862 -862
  772. package/src/engine/engine_networking_auto.ts +352 -352
  773. package/src/engine/engine_networking_blob.ts +275 -275
  774. package/src/engine/engine_networking_files.ts +217 -217
  775. package/src/engine/engine_networking_files_default_components.ts +58 -58
  776. package/src/engine/engine_networking_instantiate.ts +419 -419
  777. package/src/engine/engine_networking_peer.ts +159 -159
  778. package/src/engine/engine_networking_streams.ts +713 -713
  779. package/src/engine/engine_networking_types.ts +24 -24
  780. package/src/engine/engine_networking_utils.ts +23 -23
  781. package/src/engine/engine_networking_websocket.ts +2 -2
  782. package/src/engine/engine_patcher.ts +199 -199
  783. package/src/engine/engine_physics.ts +783 -783
  784. package/src/engine/engine_physics.types.ts +46 -46
  785. package/src/engine/engine_physics_rapier.ts +1577 -1577
  786. package/src/engine/engine_playerview.ts +80 -80
  787. package/src/engine/engine_scenelighting.ts +294 -294
  788. package/src/engine/engine_serialization.ts +2 -2
  789. package/src/engine/engine_serialization_builtin_serializer.ts +473 -473
  790. package/src/engine/engine_serialization_core.ts +720 -720
  791. package/src/engine/engine_serialization_decorator.ts +80 -80
  792. package/src/engine/engine_setup.ts +1 -1
  793. package/src/engine/engine_shaders.ts +267 -267
  794. package/src/engine/engine_shims.ts +32 -32
  795. package/src/engine/engine_test_utils.ts +109 -109
  796. package/src/engine/engine_texture.ts +82 -82
  797. package/src/engine/engine_three_utils.ts +925 -925
  798. package/src/engine/engine_time.ts +94 -94
  799. package/src/engine/engine_time_utils.ts +237 -237
  800. package/src/engine/engine_tonemapping.ts +208 -208
  801. package/src/engine/engine_types.ts +730 -730
  802. package/src/engine/engine_typestore.ts +63 -63
  803. package/src/engine/engine_util_decorator.ts +136 -136
  804. package/src/engine/engine_utils.ts +1115 -1115
  805. package/src/engine/engine_utils_format.ts +273 -273
  806. package/src/engine/engine_utils_screenshot.ts +708 -708
  807. package/src/engine/engine_utils_screenshot.xr.ts +103 -103
  808. package/src/engine/export/gltf/Writers.ts +34 -34
  809. package/src/engine/export/gltf/index.ts +158 -158
  810. package/src/engine/export/index.ts +2 -2
  811. package/src/engine/export/state.ts +19 -19
  812. package/src/engine/export/utils.ts +9 -9
  813. package/src/engine/extensions/EXT_texture_exr.ts +50 -50
  814. package/src/engine/extensions/NEEDLE_animator_controller_model.ts +195 -195
  815. package/src/engine/extensions/NEEDLE_components.ts +268 -268
  816. package/src/engine/extensions/NEEDLE_gameobject_data.ts +81 -81
  817. package/src/engine/extensions/NEEDLE_lighting_settings.ts +185 -185
  818. package/src/engine/extensions/NEEDLE_lightmaps.ts +119 -119
  819. package/src/engine/extensions/NEEDLE_persistent_assets.ts +76 -76
  820. package/src/engine/extensions/NEEDLE_render_objects.ts +209 -209
  821. package/src/engine/extensions/NEEDLE_techniques_webgl.ts +640 -640
  822. package/src/engine/extensions/extension_resolver.ts +4 -4
  823. package/src/engine/extensions/extension_utils.ts +166 -166
  824. package/src/engine/extensions/extensions.ts +140 -140
  825. package/src/engine/extensions/index.ts +5 -5
  826. package/src/engine/extensions/usage_tracker.ts +100 -100
  827. package/src/engine/js-extensions/Camera.ts +37 -37
  828. package/src/engine/js-extensions/ExtensionUtils.ts +85 -85
  829. package/src/engine/js-extensions/Layers.ts +23 -23
  830. package/src/engine/js-extensions/Object3D.ts +296 -296
  831. package/src/engine/js-extensions/RGBAColor.ts +126 -126
  832. package/src/engine/js-extensions/Vector.ts +18 -18
  833. package/src/engine/js-extensions/index.ts +4 -4
  834. package/src/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +125 -125
  835. package/src/engine/shaders/shaderData.ts +67 -67
  836. package/src/engine/tests/test_utils.ts +63 -63
  837. package/src/engine/webcomponents/WebXRButtons.ts +260 -260
  838. package/src/engine/webcomponents/api.ts +6 -6
  839. package/src/engine/webcomponents/buttons.ts +292 -292
  840. package/src/engine/webcomponents/fonts.ts +41 -41
  841. package/src/engine/webcomponents/icons.ts +57 -57
  842. package/src/engine/webcomponents/index.ts +1 -1
  843. package/src/engine/webcomponents/logo-element.ts +78 -78
  844. package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts +573 -573
  845. package/src/engine/webcomponents/needle menu/needle-menu.ts +1118 -1118
  846. package/src/engine/webcomponents/needle-button.ts +181 -181
  847. package/src/engine/webcomponents/needle-engine.ar-overlay.ts +186 -186
  848. package/src/engine/webcomponents/needle-engine.attributes.ts +82 -82
  849. package/src/engine/webcomponents/needle-engine.extras.ts +16 -16
  850. package/src/engine/webcomponents/needle-engine.loading.ts +373 -373
  851. package/src/engine/webcomponents/needle-engine.ts +860 -860
  852. package/src/engine/xr/NeedleXRController.ts +1125 -1125
  853. package/src/engine/xr/NeedleXRSession.ts +1624 -1624
  854. package/src/engine/xr/NeedleXRSync.ts +220 -220
  855. package/src/engine/xr/SceneTransition.ts +78 -78
  856. package/src/engine/xr/TempXRContext.ts +216 -216
  857. package/src/engine/xr/XRRig.ts +9 -9
  858. package/src/engine/xr/api.ts +5 -5
  859. package/src/engine/xr/events.ts +102 -102
  860. package/src/engine/xr/internal.ts +34 -34
  861. package/src/engine/xr/usdz.ts +30 -30
  862. package/src/engine/xr/utils.ts +39 -39
  863. package/src/engine-components/AlignmentConstraint.ts +36 -36
  864. package/src/engine-components/Animation.ts +557 -557
  865. package/src/engine-components/AnimationCurve.ts +150 -150
  866. package/src/engine-components/AnimationUtils.ts +28 -28
  867. package/src/engine-components/AnimationUtilsAutoplay.ts +43 -43
  868. package/src/engine-components/Animator.ts +397 -397
  869. package/src/engine-components/AnimatorController.ts +1293 -1293
  870. package/src/engine-components/AudioListener.ts +92 -92
  871. package/src/engine-components/AudioSource.ts +644 -644
  872. package/src/engine-components/AvatarLoader.ts +263 -263
  873. package/src/engine-components/AxesHelper.ts +59 -59
  874. package/src/engine-components/BasicIKConstraint.ts +54 -54
  875. package/src/engine-components/BoxCollider.ts +1 -1
  876. package/src/engine-components/BoxHelperComponent.ts +114 -114
  877. package/src/engine-components/Camera.ts +719 -719
  878. package/src/engine-components/CameraUtils.ts +136 -136
  879. package/src/engine-components/CharacterController.ts +253 -253
  880. package/src/engine-components/Collider.ts +374 -374
  881. package/src/engine-components/Component.ts +1297 -1297
  882. package/src/engine-components/ContactShadows.ts +506 -506
  883. package/src/engine-components/DeleteBox.ts +62 -62
  884. package/src/engine-components/DeviceFlag.ts +46 -46
  885. package/src/engine-components/DragControls.ts +1623 -1623
  886. package/src/engine-components/DropListener.ts +713 -713
  887. package/src/engine-components/Duplicatable.ts +198 -198
  888. package/src/engine-components/EventList.ts +266 -266
  889. package/src/engine-components/EventTrigger.ts +74 -74
  890. package/src/engine-components/EventType.ts +22 -22
  891. package/src/engine-components/Fog.ts +60 -60
  892. package/src/engine-components/Gizmos.ts +56 -56
  893. package/src/engine-components/GridHelper.ts +48 -48
  894. package/src/engine-components/GroundProjection.ts +356 -356
  895. package/src/engine-components/Interactable.ts +14 -14
  896. package/src/engine-components/Joints.ts +52 -52
  897. package/src/engine-components/LODGroup.ts +153 -153
  898. package/src/engine-components/Light.ts +558 -558
  899. package/src/engine-components/LookAtConstraint.ts +25 -25
  900. package/src/engine-components/NeedleMenu.ts +84 -84
  901. package/src/engine-components/NestedGltf.ts +86 -86
  902. package/src/engine-components/Networking.ts +114 -114
  903. package/src/engine-components/OffsetConstraint.ts +60 -60
  904. package/src/engine-components/OrbitControls.ts +1074 -1074
  905. package/src/engine-components/PlayerColor.ts +103 -103
  906. package/src/engine-components/ReflectionProbe.ts +220 -220
  907. package/src/engine-components/Renderer.ts +903 -903
  908. package/src/engine-components/RendererInstancing.ts +855 -855
  909. package/src/engine-components/RendererLightmap.ts +198 -198
  910. package/src/engine-components/RigidBody.ts +526 -526
  911. package/src/engine-components/SceneSwitcher.ts +1030 -1030
  912. package/src/engine-components/ScreenCapture.ts +592 -592
  913. package/src/engine-components/ShadowCatcher.ts +172 -172
  914. package/src/engine-components/Skybox.ts +475 -475
  915. package/src/engine-components/SmoothFollow.ts +76 -76
  916. package/src/engine-components/SpatialTrigger.ts +229 -229
  917. package/src/engine-components/SpectatorCamera.ts +787 -787
  918. package/src/engine-components/SphereCollider.ts +1 -1
  919. package/src/engine-components/SpriteRenderer.ts +468 -468
  920. package/src/engine-components/SyncedCamera.ts +220 -220
  921. package/src/engine-components/SyncedRoom.ts +380 -380
  922. package/src/engine-components/SyncedTransform.ts +383 -383
  923. package/src/engine-components/TestRunner.ts +118 -118
  924. package/src/engine-components/TransformGizmo.ts +219 -219
  925. package/src/engine-components/VideoPlayer.ts +1025 -1025
  926. package/src/engine-components/Voip.ts +363 -363
  927. package/src/engine-components/api.ts +60 -60
  928. package/src/engine-components/avatar/AvatarBlink_Simple.ts +69 -69
  929. package/src/engine-components/avatar/AvatarEyeLook_Rotation.ts +63 -63
  930. package/src/engine-components/avatar/Avatar_Brain_LookAt.ts +139 -139
  931. package/src/engine-components/avatar/Avatar_MouthShapes.ts +83 -83
  932. package/src/engine-components/avatar/Avatar_MustacheShake.ts +31 -31
  933. package/src/engine-components/codegen/components.ts +217 -217
  934. package/src/engine-components/debug/LogStats.ts +21 -21
  935. package/src/engine-components/export/gltf/GltfExport.ts +265 -265
  936. package/src/engine-components/export/usdz/Extension.ts +24 -24
  937. package/src/engine-components/export/usdz/ThreeUSDZExporter.ts +2426 -2426
  938. package/src/engine-components/export/usdz/USDZExporter.ts +705 -705
  939. package/src/engine-components/export/usdz/extensions/Animation.ts +1204 -1204
  940. package/src/engine-components/export/usdz/extensions/DocumentExtension.ts +9 -9
  941. package/src/engine-components/export/usdz/extensions/NodeMaterialConverter.ts +532 -532
  942. package/src/engine-components/export/usdz/extensions/USDZText.ts +240 -240
  943. package/src/engine-components/export/usdz/extensions/USDZUI.ts +189 -189
  944. package/src/engine-components/export/usdz/extensions/behavior/Actions.ts +99 -99
  945. package/src/engine-components/export/usdz/extensions/behavior/AudioExtension.ts +102 -102
  946. package/src/engine-components/export/usdz/extensions/behavior/Behaviour.ts +320 -320
  947. package/src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts +1225 -1225
  948. package/src/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.ts +646 -646
  949. package/src/engine-components/export/usdz/extensions/behavior/PhysicsExtension.ts +132 -132
  950. package/src/engine-components/export/usdz/index.ts +2 -2
  951. package/src/engine-components/export/usdz/utils/animationutils.ts +191 -191
  952. package/src/engine-components/export/usdz/utils/quicklook.ts +50 -50
  953. package/src/engine-components/particlesystem/ParticleSystem.ts +1287 -1287
  954. package/src/engine-components/particlesystem/ParticleSystemModules.ts +1765 -1765
  955. package/src/engine-components/particlesystem/ParticleSystemSubEmitter.ts +111 -111
  956. package/src/engine-components/particlesystem/api.ts +1 -1
  957. package/src/engine-components/postprocessing/Effects/Antialiasing.ts +57 -57
  958. package/src/engine-components/postprocessing/Effects/BloomEffect.ts +116 -116
  959. package/src/engine-components/postprocessing/Effects/ChromaticAberration.ts +37 -37
  960. package/src/engine-components/postprocessing/Effects/ColorAdjustments.ts +106 -106
  961. package/src/engine-components/postprocessing/Effects/DepthOfField.ts +103 -103
  962. package/src/engine-components/postprocessing/Effects/EffectWrapper.ts +25 -25
  963. package/src/engine-components/postprocessing/Effects/Pixelation.ts +32 -32
  964. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.ts +90 -90
  965. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.ts +192 -192
  966. package/src/engine-components/postprocessing/Effects/Sharpening.ts +143 -143
  967. package/src/engine-components/postprocessing/Effects/TiltShiftEffect.ts +61 -61
  968. package/src/engine-components/postprocessing/Effects/Tonemapping.ts +103 -103
  969. package/src/engine-components/postprocessing/Effects/Tonemapping.utils.ts +60 -60
  970. package/src/engine-components/postprocessing/Effects/Vignette.ts +59 -59
  971. package/src/engine-components/postprocessing/PostProcessingEffect.ts +192 -192
  972. package/src/engine-components/postprocessing/PostProcessingHandler.ts +560 -560
  973. package/src/engine-components/postprocessing/Volume.ts +426 -426
  974. package/src/engine-components/postprocessing/VolumeParameter.ts +158 -158
  975. package/src/engine-components/postprocessing/VolumeProfile.ts +61 -61
  976. package/src/engine-components/postprocessing/index.ts +5 -5
  977. package/src/engine-components/postprocessing/utils.ts +154 -154
  978. package/src/engine-components/timeline/PlayableDirector.ts +722 -722
  979. package/src/engine-components/timeline/SignalAsset.ts +144 -144
  980. package/src/engine-components/timeline/TimelineModels.ts +92 -92
  981. package/src/engine-components/timeline/TimelineTracks.ts +967 -967
  982. package/src/engine-components/timeline/index.ts +3 -3
  983. package/src/engine-components/ui/BaseUIComponent.ts +203 -203
  984. package/src/engine-components/ui/Button.ts +307 -307
  985. package/src/engine-components/ui/Canvas.ts +419 -419
  986. package/src/engine-components/ui/CanvasGroup.ts +54 -54
  987. package/src/engine-components/ui/EventSystem.ts +854 -854
  988. package/src/engine-components/ui/Graphic.ts +275 -275
  989. package/src/engine-components/ui/Image.ts +112 -112
  990. package/src/engine-components/ui/InputField.ts +321 -321
  991. package/src/engine-components/ui/Interfaces.ts +57 -57
  992. package/src/engine-components/ui/Layout.ts +334 -334
  993. package/src/engine-components/ui/Outline.ts +13 -13
  994. package/src/engine-components/ui/PointerEvents.ts +206 -206
  995. package/src/engine-components/ui/RaycastUtils.ts +69 -69
  996. package/src/engine-components/ui/Raycaster.ts +102 -102
  997. package/src/engine-components/ui/RectTransform.ts +375 -375
  998. package/src/engine-components/ui/SpatialHtml.ts +79 -79
  999. package/src/engine-components/ui/Symbols.ts +1 -1
  1000. package/src/engine-components/ui/Text.ts +578 -578
  1001. package/src/engine-components/ui/Utils.ts +113 -113
  1002. package/src/engine-components/utils/EnvironmentScene.ts +245 -245
  1003. package/src/engine-components/utils/LookAt.ts +88 -88
  1004. package/src/engine-components/utils/OpenURL.ts +114 -114
  1005. package/src/engine-components/webxr/Avatar.ts +265 -265
  1006. package/src/engine-components/webxr/TeleportTarget.ts +9 -9
  1007. package/src/engine-components/webxr/WebARCameraBackground.ts +175 -175
  1008. package/src/engine-components/webxr/WebARSessionRoot.ts +880 -880
  1009. package/src/engine-components/webxr/WebXR.ts +585 -585
  1010. package/src/engine-components/webxr/WebXRAvatar.ts +66 -66
  1011. package/src/engine-components/webxr/WebXRImageTracking.ts +519 -519
  1012. package/src/engine-components/webxr/WebXRPlaneTracking.ts +570 -570
  1013. package/src/engine-components/webxr/WebXRRig.ts +77 -77
  1014. package/src/engine-components/webxr/XRFlag.ts +147 -147
  1015. package/src/engine-components/webxr/controllers/XRControllerFollow.ts +118 -118
  1016. package/src/engine-components/webxr/controllers/XRControllerModel.ts +373 -373
  1017. package/src/engine-components/webxr/controllers/XRControllerMovement.ts +550 -550
  1018. package/src/engine-components/webxr/index.ts +2 -2
  1019. package/src/engine-components/webxr/types.ts +3 -3
  1020. package/src/engine-components-experimental/Presentation.ts +12 -12
  1021. package/src/engine-components-experimental/api.ts +4 -4
  1022. package/src/engine-components-experimental/networking/PlayerSync.ts +401 -401
  1023. package/src/engine-schemes/COMPILE_SCHEMES.bat +3 -3
  1024. package/src/engine-schemes/COMPILE_TS.bat +11 -11
  1025. package/src/engine-schemes/README.md +1 -1
  1026. package/src/engine-schemes/api.ts +12 -12
  1027. package/src/engine-schemes/schemes.ts +28 -28
  1028. package/src/engine-schemes/synced-camera-model.ts +92 -92
  1029. package/src/engine-schemes/synced-transform-model.ts +90 -90
  1030. package/src/engine-schemes/syncedCamera.fbs +10 -10
  1031. package/src/engine-schemes/transform.ts +50 -50
  1032. package/src/engine-schemes/transforms.fbs +25 -25
  1033. package/src/engine-schemes/vec.fbs +19 -19
  1034. package/src/engine-schemes/vec2.ts +33 -33
  1035. package/src/engine-schemes/vec3.ts +38 -38
  1036. package/src/engine-schemes/vec4.ts +43 -43
  1037. package/src/engine-schemes/vr-user-state-buffer.ts +145 -145
  1038. package/src/engine-schemes/vrUserStateBuffer.fbs +17 -17
  1039. package/src/include/draco/draco_decoder.js +34 -34
  1040. package/src/include/ktx2/basis_transcoder.js +21 -21
  1041. package/src/include/needle/arial-msdf.json +1471 -1471
  1042. package/src/include/three/DragControls.js +231 -231
  1043. package/src/include/three/EXT_mesh_gpu_instancing_exporter.js +66 -66
  1044. package/src/needle-engine.ts +70 -70
  1045. package/dist/generateMeshBVH.worker-Cdfpaq5W.js +0 -25
  1046. package/src/engine-schemes/dist/api.js +0 -17
  1047. package/src/engine-schemes/dist/api.js.meta +0 -7
  1048. package/src/engine-schemes/dist/schemes.js +0 -25
  1049. package/src/engine-schemes/dist/schemes.js.meta +0 -7
  1050. package/src/engine-schemes/dist/synced-camera-model.js +0 -74
  1051. package/src/engine-schemes/dist/synced-camera-model.js.meta +0 -7
  1052. package/src/engine-schemes/dist/synced-transform-model.js +0 -73
  1053. package/src/engine-schemes/dist/synced-transform-model.js.meta +0 -7
  1054. package/src/engine-schemes/dist/transform.js +0 -46
  1055. package/src/engine-schemes/dist/transform.js.meta +0 -7
  1056. package/src/engine-schemes/dist/vec2.js +0 -32
  1057. package/src/engine-schemes/dist/vec2.js.meta +0 -7
  1058. package/src/engine-schemes/dist/vec3.js +0 -36
  1059. package/src/engine-schemes/dist/vec3.js.meta +0 -7
  1060. package/src/engine-schemes/dist/vec4.js +0 -40
  1061. package/src/engine-schemes/dist/vec4.js.meta +0 -7
  1062. package/src/engine-schemes/dist/vr-user-state-buffer.js +0 -110
  1063. package/src/engine-schemes/dist/vr-user-state-buffer.js.meta +0 -7
@@ -1,514 +1,514 @@
1
- import { Mesh, Object3D, TextureLoader, Vector4 } from "three";
2
- import ThreeMeshUI from "three-mesh-ui";
3
- import { addNewComponent } from "../../engine_components.js";
4
- import { hasProLicense } from "../../engine_license.js";
5
- import { OneEuroFilterXYZ } from "../../engine_math.js";
6
- import { lookAtObject } from "../../engine_three_utils.js";
7
- import { TypeStore } from "../../engine_typestore.js";
8
- import { DeviceUtilities, getParam } from "../../engine_utils.js";
9
- import { getIconTexture, isIconElement } from "../icons.js";
10
- const debug = getParam("debugspatialmenu");
11
- export class NeedleSpatialMenu {
12
- _context;
13
- needleMenu;
14
- htmlButtonsMap = new Map();
15
- enabled = true;
16
- constructor(context, menu) {
17
- this._context = context;
18
- this._context.pre_render_callbacks.push(this.preRender);
19
- this.needleMenu = menu;
20
- const optionsContainer = this.needleMenu.shadowRoot?.querySelector(".options");
21
- if (!optionsContainer) {
22
- console.error("Could not find options container in needle menu");
23
- }
24
- else {
25
- const watcher = new MutationObserver((mutations) => {
26
- if (!this.enabled)
27
- return;
28
- if (this._context.isInXR == false && !debug)
29
- return;
30
- for (const mutation of mutations) {
31
- if (mutation.type === "childList") {
32
- mutation.addedNodes.forEach((node) => {
33
- this.createButtonFromHTMLNode(node);
34
- });
35
- mutation.removedNodes.forEach((node) => {
36
- const button = node;
37
- const spatialButton = this.htmlButtonsMap.get(button);
38
- if (spatialButton) {
39
- this.htmlButtonsMap.delete(button);
40
- spatialButton.remove();
41
- ThreeMeshUI.update();
42
- }
43
- });
44
- }
45
- }
46
- });
47
- watcher.observe(optionsContainer, { childList: true });
48
- }
49
- }
50
- setEnabled(enabled) {
51
- this.enabled = enabled;
52
- if (!enabled)
53
- this.menu?.removeFromParent();
54
- }
55
- userRequestedMenu = false;
56
- /** Bring up the spatial menu. This is typically invoked from a button click.
57
- * The menu will show at a lower height to be easily accessible.
58
- * @returns true if the menu was shown, false if it can't be shown because the menu has been disabled.
59
- */
60
- setDisplay(display) {
61
- if (!this.enabled)
62
- return false;
63
- this.userRequestedMenu = display;
64
- return true;
65
- }
66
- onDestroy() {
67
- const index = this._context.pre_render_callbacks.indexOf(this.preRender);
68
- if (index > -1) {
69
- this._context.pre_render_callbacks.splice(index, 1);
70
- }
71
- }
72
- uiisDirty = false;
73
- markDirty() {
74
- this.uiisDirty = true;
75
- }
76
- _showNeedleLogo;
77
- showNeedleLogo(show) {
78
- this._showNeedleLogo = show;
79
- }
80
- _wasInXR = false;
81
- preRender = () => {
82
- if (!this.enabled) {
83
- this.menu?.removeFromParent();
84
- return;
85
- }
86
- if (debug && DeviceUtilities.isDesktop()) {
87
- this.updateMenu();
88
- }
89
- const xr = this._context.xr;
90
- if (!xr?.running) {
91
- if (this._wasInXR) {
92
- this._wasInXR = false;
93
- this.onExitXR();
94
- }
95
- return;
96
- }
97
- if (!this._wasInXR) {
98
- this._wasInXR = true;
99
- this.onEnterXR();
100
- }
101
- this.updateMenu();
102
- };
103
- onEnterXR() {
104
- const nodes = this.needleMenu.shadowRoot?.querySelector(".options");
105
- if (nodes) {
106
- nodes.childNodes.forEach((node) => {
107
- this.createButtonFromHTMLNode(node);
108
- });
109
- }
110
- }
111
- onExitXR() {
112
- this.menu?.removeFromParent();
113
- }
114
- createButtonFromHTMLNode(node) {
115
- const menu = this.getMenu();
116
- const existing = this.htmlButtonsMap.get(node);
117
- if (existing) {
118
- existing.add();
119
- return;
120
- }
121
- if (node instanceof HTMLButtonElement) {
122
- const spatialButton = this.createButton(menu, node);
123
- this.htmlButtonsMap.set(node, spatialButton);
124
- spatialButton.add();
125
- }
126
- else if (node instanceof HTMLSlotElement) {
127
- node.assignedNodes().forEach((node) => {
128
- this.createButtonFromHTMLNode(node);
129
- });
130
- }
131
- }
132
- _menuTarget = new Object3D();
133
- positionFilter = new OneEuroFilterXYZ(90, .5);
134
- updateMenu() {
135
- //performance.mark('NeedleSpatialMenu updateMenu start');
136
- const menu = this.getMenu();
137
- this.handleNeedleWatermark();
138
- this._context.scene.add(menu);
139
- const camera = this._context.mainCamera;
140
- const xr = this._context.xr;
141
- const rigScale = xr?.rigScale || 1;
142
- if (camera) {
143
- const menuTargetPosition = camera.worldPosition;
144
- const fwd = camera.worldForward.multiplyScalar(-1);
145
- const showMenuThreshold = fwd.y > .6;
146
- const hideMenuThreshold = fwd.y > .4;
147
- const newVisibleState = (menu.visible ? hideMenuThreshold : showMenuThreshold) || this.userRequestedMenu;
148
- const becomesVisible = !menu.visible && newVisibleState;
149
- menu.visible = newVisibleState || (DeviceUtilities.isDesktop() && debug);
150
- fwd.multiplyScalar(3 * rigScale);
151
- menuTargetPosition.add(fwd);
152
- const testBecomesVisible = false; // this._context.time.frame % 200 == 0;
153
- if (becomesVisible || testBecomesVisible) {
154
- menu.position.copy(this._menuTarget.position);
155
- menu.position.y += 0.25;
156
- this._menuTarget.position.copy(menu.position);
157
- this.positionFilter.reset(menu.position);
158
- menu.quaternion.copy(this._menuTarget.quaternion);
159
- this.markDirty();
160
- }
161
- const distFromForwardView = this._menuTarget.position.distanceTo(menuTargetPosition);
162
- if (becomesVisible || distFromForwardView > 1.5 * rigScale) {
163
- this.ensureRenderOnTop(this.menu);
164
- this._menuTarget.position.copy(menuTargetPosition);
165
- this._context.scene.add(this._menuTarget);
166
- lookAtObject(this._menuTarget, this._context.mainCamera, true, true);
167
- this._menuTarget.removeFromParent();
168
- }
169
- this.positionFilter.filter(this._menuTarget.position, menu.position, this._context.time.time);
170
- const step = 5;
171
- this.menu?.quaternion.slerp(this._menuTarget.quaternion, this._context.time.deltaTime * step);
172
- this.menu?.scale.setScalar(rigScale);
173
- }
174
- if (this.uiisDirty) {
175
- //performance.mark('SpatialMenu.update.uiisDirty.start');
176
- this.uiisDirty = false;
177
- ThreeMeshUI.update();
178
- //performance.mark('SpatialMenu.update.uiisDirty.end');
179
- //performance.measure('SpatialMenu.update.uiisDirty', 'SpatialMenu.update.uiisDirty.start', 'SpatialMenu.update.uiisDirty.end');
180
- }
181
- //performance.mark('NeedleSpatialMenu updateMenu end');
182
- //performance.measure('SpatialMenu.update', 'NeedleSpatialMenu updateMenu start', 'NeedleSpatialMenu updateMenu end');
183
- }
184
- ensureRenderOnTop(obj, level = 0) {
185
- if (obj instanceof Mesh) {
186
- obj.material.depthTest = false;
187
- obj.material.depthWrite = false;
188
- }
189
- obj.renderOrder = 1000 + level * 2;
190
- for (const child of obj.children) {
191
- this.ensureRenderOnTop(child, level + 1);
192
- }
193
- }
194
- familyName = "Needle Spatial Menu";
195
- menu;
196
- get isVisible() {
197
- return this.menu?.visible;
198
- }
199
- getMenu() {
200
- if (this.menu) {
201
- return this.menu;
202
- }
203
- this.ensureFont();
204
- this.menu = new ThreeMeshUI.Block({
205
- boxSizing: 'border-box',
206
- fontFamily: this.familyName,
207
- height: "auto",
208
- fontSize: .1,
209
- color: 0x000000,
210
- lineHeight: 1,
211
- backgroundColor: 0xffffff,
212
- backgroundOpacity: .55,
213
- borderRadius: 1.0,
214
- whiteSpace: 'pre-wrap',
215
- flexDirection: 'row',
216
- alignItems: 'center',
217
- padding: new Vector4(.0, .05, .0, .05),
218
- borderColor: 0x000000,
219
- borderOpacity: .05,
220
- borderWidth: .005
221
- });
222
- // ensure the menu has a raycaster
223
- const raycaster = TypeStore.get("ObjectRaycaster");
224
- if (raycaster)
225
- addNewComponent(this.menu, new raycaster());
226
- return this.menu;
227
- }
228
- _poweredByNeedleElement;
229
- handleNeedleWatermark() {
230
- if (!this._poweredByNeedleElement) {
231
- this._poweredByNeedleElement = new ThreeMeshUI.Block({
232
- width: "auto",
233
- height: "auto",
234
- fontSize: .05,
235
- whiteSpace: 'pre-wrap',
236
- flexDirection: 'row',
237
- flexWrap: 'wrap',
238
- justifyContent: 'center',
239
- margin: 0.02,
240
- borderRadius: .02,
241
- padding: .02,
242
- backgroundColor: 0xffffff,
243
- backgroundOpacity: 1,
244
- });
245
- this._poweredByNeedleElement["needle:use_eventsystem"] = true;
246
- const onClick = new OnClick(this._context, () => globalThis.open("https://needle.tools", "_self"));
247
- addNewComponent(this._poweredByNeedleElement, onClick);
248
- const firstLabel = new ThreeMeshUI.Text({
249
- textContent: "Powered by",
250
- width: "auto",
251
- height: "auto",
252
- });
253
- const secondLabel = new ThreeMeshUI.Text({
254
- textContent: "needle",
255
- width: "auto",
256
- height: "auto",
257
- fontSize: .07,
258
- margin: new Vector4(0, 0, 0, .02),
259
- });
260
- this._poweredByNeedleElement.add(firstLabel);
261
- this._poweredByNeedleElement.add(secondLabel);
262
- this.menu?.add(this._poweredByNeedleElement);
263
- this.markDirty();
264
- // const logoObject = needleLogoAsSVGObject();
265
- // logoObject.position.y = 1;
266
- // this._context.scene.add(logoObject);
267
- const textureLoader = new TextureLoader();
268
- textureLoader.load("./include/needle/poweredbyneedle.webp", (texture) => {
269
- onClick.allowModifyUI = false;
270
- firstLabel.removeFromParent();
271
- secondLabel.removeFromParent();
272
- const aspect = texture.image.width / texture.image.height;
273
- this._poweredByNeedleElement?.set({
274
- backgroundImage: texture,
275
- backgroundOpacity: 1,
276
- width: .1 * aspect,
277
- height: .1
278
- });
279
- this.markDirty();
280
- });
281
- }
282
- if (this.menu) {
283
- const index = this.menu.children.indexOf(this._poweredByNeedleElement);
284
- if (!this._showNeedleLogo && hasProLicense()) {
285
- if (index >= 0) {
286
- this._poweredByNeedleElement.removeFromParent();
287
- this.markDirty();
288
- }
289
- }
290
- else {
291
- this._poweredByNeedleElement.visible = true;
292
- this.menu.add(this._poweredByNeedleElement);
293
- const newIndex = this.menu.children.indexOf(this._poweredByNeedleElement);
294
- if (index !== newIndex) {
295
- this.markDirty();
296
- }
297
- }
298
- }
299
- }
300
- ensureFont() {
301
- let fontFamily = ThreeMeshUI.FontLibrary.getFontFamily(this.familyName);
302
- if (!fontFamily) {
303
- fontFamily = ThreeMeshUI.FontLibrary.addFontFamily(this.familyName);
304
- const normal = fontFamily.addVariant("normal", "normal", "./include/needle/arial-msdf.json", "./include/needle/arial.png");
305
- /** @ts-ignore */
306
- normal?.addEventListener('ready', () => {
307
- this.markDirty();
308
- });
309
- }
310
- }
311
- createButton(menu, htmlButton) {
312
- const buttonParent = new ThreeMeshUI.Block({
313
- width: "auto",
314
- height: "auto",
315
- whiteSpace: 'pre-wrap',
316
- flexDirection: 'row',
317
- flexWrap: 'wrap',
318
- justifyContent: 'center',
319
- backgroundColor: 0xffffff,
320
- backgroundOpacity: 0,
321
- padding: 0.02,
322
- margin: 0.01,
323
- borderRadius: 0.02,
324
- cursor: 'pointer',
325
- fontSize: 0.05,
326
- });
327
- const text = new ThreeMeshUI.Text({
328
- textContent: "",
329
- width: "auto",
330
- justifyContent: 'center',
331
- alignItems: 'center',
332
- backgroundOpacity: 0,
333
- backgroundColor: 0xffffff,
334
- fontFamily: this.familyName,
335
- color: 0x000000,
336
- borderRadius: 0.02,
337
- padding: .01,
338
- });
339
- buttonParent.add(text);
340
- buttonParent["needle:use_eventsystem"] = true;
341
- const onClick = new OnClick(this._context, () => htmlButton.click());
342
- addNewComponent(buttonParent, onClick);
343
- const spatialButton = new SpatialButton(this, menu, htmlButton, buttonParent, text);
344
- return spatialButton;
345
- }
346
- }
347
- class SpatialButton {
348
- menu;
349
- root;
350
- htmlbutton;
351
- spatialContainer;
352
- spatialText;
353
- spatialIcon;
354
- constructor(menu, root, htmlbutton, buttonContainer, buttonText) {
355
- this.menu = menu;
356
- this.root = root;
357
- this.htmlbutton = htmlbutton;
358
- this.spatialContainer = buttonContainer;
359
- this.spatialText = buttonText;
360
- const styleObserver = new MutationObserver((mutations) => {
361
- for (const mutation of mutations) {
362
- if (mutation.type === "attributes") {
363
- if (mutation.attributeName === "style") {
364
- this.updateVisible();
365
- }
366
- }
367
- else if (mutation.type === "childList") {
368
- this.updateText();
369
- }
370
- }
371
- });
372
- // watch attributes and content
373
- styleObserver.observe(htmlbutton, { attributes: true, childList: true });
374
- this.updateText();
375
- }
376
- add() {
377
- if (this.spatialContainer.parent != this.root) {
378
- this.root.add(this.spatialContainer);
379
- this.menu.markDirty();
380
- this.updateVisible();
381
- this.updateText();
382
- }
383
- }
384
- remove() {
385
- if (this.spatialContainer.parent) {
386
- this.spatialContainer.removeFromParent();
387
- this.menu.markDirty();
388
- }
389
- }
390
- updateVisible() {
391
- const wasVisible = this.spatialContainer.visible;
392
- this.spatialContainer.visible = this.htmlbutton.style.display !== "none";
393
- if (wasVisible !== this.spatialContainer.visible) {
394
- this.menu.markDirty();
395
- }
396
- }
397
- _lastText = "";
398
- updateText() {
399
- let newText = "";
400
- let iconToCreate = "";
401
- this.htmlbutton.childNodes.forEach((child) => {
402
- if (child.nodeType === Node.TEXT_NODE) {
403
- newText += child.textContent;
404
- }
405
- else if (child instanceof HTMLElement && isIconElement(child) && child.textContent) {
406
- iconToCreate = child.textContent;
407
- }
408
- });
409
- if (this._lastText !== newText) {
410
- this._lastText = newText;
411
- this.spatialText.name = newText;
412
- this.spatialText.set({ textContent: newText });
413
- this.menu.markDirty();
414
- }
415
- if (newText.length <= 0) {
416
- if (this.spatialText.parent) {
417
- this.spatialText.removeFromParent();
418
- this.menu.markDirty();
419
- }
420
- }
421
- else {
422
- if (!this.spatialText.parent) {
423
- this.spatialContainer.add(this.spatialText);
424
- this.menu.markDirty();
425
- }
426
- }
427
- if (iconToCreate) {
428
- this.createIcon(iconToCreate);
429
- }
430
- }
431
- _lastTexture;
432
- async createIcon(str) {
433
- if (!this.spatialIcon) {
434
- const texture = await getIconTexture(str);
435
- if (texture && !this.spatialIcon) {
436
- const size = 0.08;
437
- const icon = new ThreeMeshUI.Block({
438
- width: size,
439
- height: size,
440
- backgroundColor: 0xffffff,
441
- backgroundImage: texture,
442
- backgroundOpacity: 1,
443
- margin: new Vector4(0, .005, 0, 0),
444
- });
445
- this.spatialIcon = icon;
446
- this.spatialContainer.add(icon);
447
- this.menu.markDirty();
448
- }
449
- }
450
- if (str != this._lastTexture) {
451
- this._lastTexture = str;
452
- const texture = await getIconTexture(str);
453
- if (texture) {
454
- this.spatialIcon?.set({ backgroundImage: texture });
455
- this.menu.markDirty();
456
- }
457
- }
458
- // make sure the icon is at the first index
459
- const index = this.spatialContainer.children.indexOf(this.spatialIcon);
460
- if (index > 0) {
461
- this.spatialContainer.children.splice(index, 1);
462
- this.spatialContainer.children.unshift(this.spatialIcon);
463
- this.menu.markDirty();
464
- }
465
- }
466
- }
467
- // TODO: perhaps we should have a basic IComponent implementation in the engine folder to be able to write this more easily. OR possibly reduce the IComponent interface to the minimum
468
- class OnClick {
469
- isComponent = true;
470
- enabled = true;
471
- get activeAndEnabled() { return true; }
472
- __internalAwake() { }
473
- __internalEnable() { }
474
- __internalDisable() { }
475
- __internalStart() { }
476
- onEnable() { }
477
- onDisable() { }
478
- gameObject;
479
- allowModifyUI = true;
480
- get element() {
481
- return this.gameObject;
482
- }
483
- context;
484
- onclick;
485
- constructor(context, onclick) {
486
- this.context = context;
487
- this.onclick = onclick;
488
- }
489
- onPointerEnter() {
490
- this.context.input.setCursor("pointer");
491
- if (this.allowModifyUI) {
492
- this.element.set({ backgroundOpacity: 1 });
493
- ThreeMeshUI.update();
494
- }
495
- }
496
- onPointerExit() {
497
- this.context.input.unsetCursor("pointer");
498
- if (this.allowModifyUI) {
499
- this.element.set({ backgroundOpacity: 0 });
500
- ThreeMeshUI.update();
501
- }
502
- }
503
- onPointerDown(e) {
504
- e.use();
505
- }
506
- onPointerUp(e) {
507
- e.use();
508
- }
509
- onPointerClick(e) {
510
- e.use();
511
- this.onclick();
512
- }
513
- }
1
+ import { Mesh, Object3D, TextureLoader, Vector4 } from "three";
2
+ import ThreeMeshUI from "three-mesh-ui";
3
+ import { addNewComponent } from "../../engine_components.js";
4
+ import { hasProLicense } from "../../engine_license.js";
5
+ import { OneEuroFilterXYZ } from "../../engine_math.js";
6
+ import { lookAtObject } from "../../engine_three_utils.js";
7
+ import { TypeStore } from "../../engine_typestore.js";
8
+ import { DeviceUtilities, getParam } from "../../engine_utils.js";
9
+ import { getIconTexture, isIconElement } from "../icons.js";
10
+ const debug = getParam("debugspatialmenu");
11
+ export class NeedleSpatialMenu {
12
+ _context;
13
+ needleMenu;
14
+ htmlButtonsMap = new Map();
15
+ enabled = true;
16
+ constructor(context, menu) {
17
+ this._context = context;
18
+ this._context.pre_render_callbacks.push(this.preRender);
19
+ this.needleMenu = menu;
20
+ const optionsContainer = this.needleMenu.shadowRoot?.querySelector(".options");
21
+ if (!optionsContainer) {
22
+ console.error("Could not find options container in needle menu");
23
+ }
24
+ else {
25
+ const watcher = new MutationObserver((mutations) => {
26
+ if (!this.enabled)
27
+ return;
28
+ if (this._context.isInXR == false && !debug)
29
+ return;
30
+ for (const mutation of mutations) {
31
+ if (mutation.type === "childList") {
32
+ mutation.addedNodes.forEach((node) => {
33
+ this.createButtonFromHTMLNode(node);
34
+ });
35
+ mutation.removedNodes.forEach((node) => {
36
+ const button = node;
37
+ const spatialButton = this.htmlButtonsMap.get(button);
38
+ if (spatialButton) {
39
+ this.htmlButtonsMap.delete(button);
40
+ spatialButton.remove();
41
+ ThreeMeshUI.update();
42
+ }
43
+ });
44
+ }
45
+ }
46
+ });
47
+ watcher.observe(optionsContainer, { childList: true });
48
+ }
49
+ }
50
+ setEnabled(enabled) {
51
+ this.enabled = enabled;
52
+ if (!enabled)
53
+ this.menu?.removeFromParent();
54
+ }
55
+ userRequestedMenu = false;
56
+ /** Bring up the spatial menu. This is typically invoked from a button click.
57
+ * The menu will show at a lower height to be easily accessible.
58
+ * @returns true if the menu was shown, false if it can't be shown because the menu has been disabled.
59
+ */
60
+ setDisplay(display) {
61
+ if (!this.enabled)
62
+ return false;
63
+ this.userRequestedMenu = display;
64
+ return true;
65
+ }
66
+ onDestroy() {
67
+ const index = this._context.pre_render_callbacks.indexOf(this.preRender);
68
+ if (index > -1) {
69
+ this._context.pre_render_callbacks.splice(index, 1);
70
+ }
71
+ }
72
+ uiisDirty = false;
73
+ markDirty() {
74
+ this.uiisDirty = true;
75
+ }
76
+ _showNeedleLogo;
77
+ showNeedleLogo(show) {
78
+ this._showNeedleLogo = show;
79
+ }
80
+ _wasInXR = false;
81
+ preRender = () => {
82
+ if (!this.enabled) {
83
+ this.menu?.removeFromParent();
84
+ return;
85
+ }
86
+ if (debug && DeviceUtilities.isDesktop()) {
87
+ this.updateMenu();
88
+ }
89
+ const xr = this._context.xr;
90
+ if (!xr?.running) {
91
+ if (this._wasInXR) {
92
+ this._wasInXR = false;
93
+ this.onExitXR();
94
+ }
95
+ return;
96
+ }
97
+ if (!this._wasInXR) {
98
+ this._wasInXR = true;
99
+ this.onEnterXR();
100
+ }
101
+ this.updateMenu();
102
+ };
103
+ onEnterXR() {
104
+ const nodes = this.needleMenu.shadowRoot?.querySelector(".options");
105
+ if (nodes) {
106
+ nodes.childNodes.forEach((node) => {
107
+ this.createButtonFromHTMLNode(node);
108
+ });
109
+ }
110
+ }
111
+ onExitXR() {
112
+ this.menu?.removeFromParent();
113
+ }
114
+ createButtonFromHTMLNode(node) {
115
+ const menu = this.getMenu();
116
+ const existing = this.htmlButtonsMap.get(node);
117
+ if (existing) {
118
+ existing.add();
119
+ return;
120
+ }
121
+ if (node instanceof HTMLButtonElement) {
122
+ const spatialButton = this.createButton(menu, node);
123
+ this.htmlButtonsMap.set(node, spatialButton);
124
+ spatialButton.add();
125
+ }
126
+ else if (node instanceof HTMLSlotElement) {
127
+ node.assignedNodes().forEach((node) => {
128
+ this.createButtonFromHTMLNode(node);
129
+ });
130
+ }
131
+ }
132
+ _menuTarget = new Object3D();
133
+ positionFilter = new OneEuroFilterXYZ(90, .5);
134
+ updateMenu() {
135
+ //performance.mark('NeedleSpatialMenu updateMenu start');
136
+ const menu = this.getMenu();
137
+ this.handleNeedleWatermark();
138
+ this._context.scene.add(menu);
139
+ const camera = this._context.mainCamera;
140
+ const xr = this._context.xr;
141
+ const rigScale = xr?.rigScale || 1;
142
+ if (camera) {
143
+ const menuTargetPosition = camera.worldPosition;
144
+ const fwd = camera.worldForward.multiplyScalar(-1);
145
+ const showMenuThreshold = fwd.y > .6;
146
+ const hideMenuThreshold = fwd.y > .4;
147
+ const newVisibleState = (menu.visible ? hideMenuThreshold : showMenuThreshold) || this.userRequestedMenu;
148
+ const becomesVisible = !menu.visible && newVisibleState;
149
+ menu.visible = newVisibleState || (DeviceUtilities.isDesktop() && debug);
150
+ fwd.multiplyScalar(3 * rigScale);
151
+ menuTargetPosition.add(fwd);
152
+ const testBecomesVisible = false; // this._context.time.frame % 200 == 0;
153
+ if (becomesVisible || testBecomesVisible) {
154
+ menu.position.copy(this._menuTarget.position);
155
+ menu.position.y += 0.25;
156
+ this._menuTarget.position.copy(menu.position);
157
+ this.positionFilter.reset(menu.position);
158
+ menu.quaternion.copy(this._menuTarget.quaternion);
159
+ this.markDirty();
160
+ }
161
+ const distFromForwardView = this._menuTarget.position.distanceTo(menuTargetPosition);
162
+ if (becomesVisible || distFromForwardView > 1.5 * rigScale) {
163
+ this.ensureRenderOnTop(this.menu);
164
+ this._menuTarget.position.copy(menuTargetPosition);
165
+ this._context.scene.add(this._menuTarget);
166
+ lookAtObject(this._menuTarget, this._context.mainCamera, true, true);
167
+ this._menuTarget.removeFromParent();
168
+ }
169
+ this.positionFilter.filter(this._menuTarget.position, menu.position, this._context.time.time);
170
+ const step = 5;
171
+ this.menu?.quaternion.slerp(this._menuTarget.quaternion, this._context.time.deltaTime * step);
172
+ this.menu?.scale.setScalar(rigScale);
173
+ }
174
+ if (this.uiisDirty) {
175
+ //performance.mark('SpatialMenu.update.uiisDirty.start');
176
+ this.uiisDirty = false;
177
+ ThreeMeshUI.update();
178
+ //performance.mark('SpatialMenu.update.uiisDirty.end');
179
+ //performance.measure('SpatialMenu.update.uiisDirty', 'SpatialMenu.update.uiisDirty.start', 'SpatialMenu.update.uiisDirty.end');
180
+ }
181
+ //performance.mark('NeedleSpatialMenu updateMenu end');
182
+ //performance.measure('SpatialMenu.update', 'NeedleSpatialMenu updateMenu start', 'NeedleSpatialMenu updateMenu end');
183
+ }
184
+ ensureRenderOnTop(obj, level = 0) {
185
+ if (obj instanceof Mesh) {
186
+ obj.material.depthTest = false;
187
+ obj.material.depthWrite = false;
188
+ }
189
+ obj.renderOrder = 1000 + level * 2;
190
+ for (const child of obj.children) {
191
+ this.ensureRenderOnTop(child, level + 1);
192
+ }
193
+ }
194
+ familyName = "Needle Spatial Menu";
195
+ menu;
196
+ get isVisible() {
197
+ return this.menu?.visible;
198
+ }
199
+ getMenu() {
200
+ if (this.menu) {
201
+ return this.menu;
202
+ }
203
+ this.ensureFont();
204
+ this.menu = new ThreeMeshUI.Block({
205
+ boxSizing: 'border-box',
206
+ fontFamily: this.familyName,
207
+ height: "auto",
208
+ fontSize: .1,
209
+ color: 0x000000,
210
+ lineHeight: 1,
211
+ backgroundColor: 0xffffff,
212
+ backgroundOpacity: .55,
213
+ borderRadius: 1.0,
214
+ whiteSpace: 'pre-wrap',
215
+ flexDirection: 'row',
216
+ alignItems: 'center',
217
+ padding: new Vector4(.0, .05, .0, .05),
218
+ borderColor: 0x000000,
219
+ borderOpacity: .05,
220
+ borderWidth: .005
221
+ });
222
+ // ensure the menu has a raycaster
223
+ const raycaster = TypeStore.get("ObjectRaycaster");
224
+ if (raycaster)
225
+ addNewComponent(this.menu, new raycaster());
226
+ return this.menu;
227
+ }
228
+ _poweredByNeedleElement;
229
+ handleNeedleWatermark() {
230
+ if (!this._poweredByNeedleElement) {
231
+ this._poweredByNeedleElement = new ThreeMeshUI.Block({
232
+ width: "auto",
233
+ height: "auto",
234
+ fontSize: .05,
235
+ whiteSpace: 'pre-wrap',
236
+ flexDirection: 'row',
237
+ flexWrap: 'wrap',
238
+ justifyContent: 'center',
239
+ margin: 0.02,
240
+ borderRadius: .02,
241
+ padding: .02,
242
+ backgroundColor: 0xffffff,
243
+ backgroundOpacity: 1,
244
+ });
245
+ this._poweredByNeedleElement["needle:use_eventsystem"] = true;
246
+ const onClick = new OnClick(this._context, () => globalThis.open("https://needle.tools", "_self"));
247
+ addNewComponent(this._poweredByNeedleElement, onClick);
248
+ const firstLabel = new ThreeMeshUI.Text({
249
+ textContent: "Powered by",
250
+ width: "auto",
251
+ height: "auto",
252
+ });
253
+ const secondLabel = new ThreeMeshUI.Text({
254
+ textContent: "needle",
255
+ width: "auto",
256
+ height: "auto",
257
+ fontSize: .07,
258
+ margin: new Vector4(0, 0, 0, .02),
259
+ });
260
+ this._poweredByNeedleElement.add(firstLabel);
261
+ this._poweredByNeedleElement.add(secondLabel);
262
+ this.menu?.add(this._poweredByNeedleElement);
263
+ this.markDirty();
264
+ // const logoObject = needleLogoAsSVGObject();
265
+ // logoObject.position.y = 1;
266
+ // this._context.scene.add(logoObject);
267
+ const textureLoader = new TextureLoader();
268
+ textureLoader.load("./include/needle/poweredbyneedle.webp", (texture) => {
269
+ onClick.allowModifyUI = false;
270
+ firstLabel.removeFromParent();
271
+ secondLabel.removeFromParent();
272
+ const aspect = texture.image.width / texture.image.height;
273
+ this._poweredByNeedleElement?.set({
274
+ backgroundImage: texture,
275
+ backgroundOpacity: 1,
276
+ width: .1 * aspect,
277
+ height: .1
278
+ });
279
+ this.markDirty();
280
+ });
281
+ }
282
+ if (this.menu) {
283
+ const index = this.menu.children.indexOf(this._poweredByNeedleElement);
284
+ if (!this._showNeedleLogo && hasProLicense()) {
285
+ if (index >= 0) {
286
+ this._poweredByNeedleElement.removeFromParent();
287
+ this.markDirty();
288
+ }
289
+ }
290
+ else {
291
+ this._poweredByNeedleElement.visible = true;
292
+ this.menu.add(this._poweredByNeedleElement);
293
+ const newIndex = this.menu.children.indexOf(this._poweredByNeedleElement);
294
+ if (index !== newIndex) {
295
+ this.markDirty();
296
+ }
297
+ }
298
+ }
299
+ }
300
+ ensureFont() {
301
+ let fontFamily = ThreeMeshUI.FontLibrary.getFontFamily(this.familyName);
302
+ if (!fontFamily) {
303
+ fontFamily = ThreeMeshUI.FontLibrary.addFontFamily(this.familyName);
304
+ const normal = fontFamily.addVariant("normal", "normal", "./include/needle/arial-msdf.json", "./include/needle/arial.png");
305
+ /** @ts-ignore */
306
+ normal?.addEventListener('ready', () => {
307
+ this.markDirty();
308
+ });
309
+ }
310
+ }
311
+ createButton(menu, htmlButton) {
312
+ const buttonParent = new ThreeMeshUI.Block({
313
+ width: "auto",
314
+ height: "auto",
315
+ whiteSpace: 'pre-wrap',
316
+ flexDirection: 'row',
317
+ flexWrap: 'wrap',
318
+ justifyContent: 'center',
319
+ backgroundColor: 0xffffff,
320
+ backgroundOpacity: 0,
321
+ padding: 0.02,
322
+ margin: 0.01,
323
+ borderRadius: 0.02,
324
+ cursor: 'pointer',
325
+ fontSize: 0.05,
326
+ });
327
+ const text = new ThreeMeshUI.Text({
328
+ textContent: "",
329
+ width: "auto",
330
+ justifyContent: 'center',
331
+ alignItems: 'center',
332
+ backgroundOpacity: 0,
333
+ backgroundColor: 0xffffff,
334
+ fontFamily: this.familyName,
335
+ color: 0x000000,
336
+ borderRadius: 0.02,
337
+ padding: .01,
338
+ });
339
+ buttonParent.add(text);
340
+ buttonParent["needle:use_eventsystem"] = true;
341
+ const onClick = new OnClick(this._context, () => htmlButton.click());
342
+ addNewComponent(buttonParent, onClick);
343
+ const spatialButton = new SpatialButton(this, menu, htmlButton, buttonParent, text);
344
+ return spatialButton;
345
+ }
346
+ }
347
+ class SpatialButton {
348
+ menu;
349
+ root;
350
+ htmlbutton;
351
+ spatialContainer;
352
+ spatialText;
353
+ spatialIcon;
354
+ constructor(menu, root, htmlbutton, buttonContainer, buttonText) {
355
+ this.menu = menu;
356
+ this.root = root;
357
+ this.htmlbutton = htmlbutton;
358
+ this.spatialContainer = buttonContainer;
359
+ this.spatialText = buttonText;
360
+ const styleObserver = new MutationObserver((mutations) => {
361
+ for (const mutation of mutations) {
362
+ if (mutation.type === "attributes") {
363
+ if (mutation.attributeName === "style") {
364
+ this.updateVisible();
365
+ }
366
+ }
367
+ else if (mutation.type === "childList") {
368
+ this.updateText();
369
+ }
370
+ }
371
+ });
372
+ // watch attributes and content
373
+ styleObserver.observe(htmlbutton, { attributes: true, childList: true });
374
+ this.updateText();
375
+ }
376
+ add() {
377
+ if (this.spatialContainer.parent != this.root) {
378
+ this.root.add(this.spatialContainer);
379
+ this.menu.markDirty();
380
+ this.updateVisible();
381
+ this.updateText();
382
+ }
383
+ }
384
+ remove() {
385
+ if (this.spatialContainer.parent) {
386
+ this.spatialContainer.removeFromParent();
387
+ this.menu.markDirty();
388
+ }
389
+ }
390
+ updateVisible() {
391
+ const wasVisible = this.spatialContainer.visible;
392
+ this.spatialContainer.visible = this.htmlbutton.style.display !== "none";
393
+ if (wasVisible !== this.spatialContainer.visible) {
394
+ this.menu.markDirty();
395
+ }
396
+ }
397
+ _lastText = "";
398
+ updateText() {
399
+ let newText = "";
400
+ let iconToCreate = "";
401
+ this.htmlbutton.childNodes.forEach((child) => {
402
+ if (child.nodeType === Node.TEXT_NODE) {
403
+ newText += child.textContent;
404
+ }
405
+ else if (child instanceof HTMLElement && isIconElement(child) && child.textContent) {
406
+ iconToCreate = child.textContent;
407
+ }
408
+ });
409
+ if (this._lastText !== newText) {
410
+ this._lastText = newText;
411
+ this.spatialText.name = newText;
412
+ this.spatialText.set({ textContent: newText });
413
+ this.menu.markDirty();
414
+ }
415
+ if (newText.length <= 0) {
416
+ if (this.spatialText.parent) {
417
+ this.spatialText.removeFromParent();
418
+ this.menu.markDirty();
419
+ }
420
+ }
421
+ else {
422
+ if (!this.spatialText.parent) {
423
+ this.spatialContainer.add(this.spatialText);
424
+ this.menu.markDirty();
425
+ }
426
+ }
427
+ if (iconToCreate) {
428
+ this.createIcon(iconToCreate);
429
+ }
430
+ }
431
+ _lastTexture;
432
+ async createIcon(str) {
433
+ if (!this.spatialIcon) {
434
+ const texture = await getIconTexture(str);
435
+ if (texture && !this.spatialIcon) {
436
+ const size = 0.08;
437
+ const icon = new ThreeMeshUI.Block({
438
+ width: size,
439
+ height: size,
440
+ backgroundColor: 0xffffff,
441
+ backgroundImage: texture,
442
+ backgroundOpacity: 1,
443
+ margin: new Vector4(0, .005, 0, 0),
444
+ });
445
+ this.spatialIcon = icon;
446
+ this.spatialContainer.add(icon);
447
+ this.menu.markDirty();
448
+ }
449
+ }
450
+ if (str != this._lastTexture) {
451
+ this._lastTexture = str;
452
+ const texture = await getIconTexture(str);
453
+ if (texture) {
454
+ this.spatialIcon?.set({ backgroundImage: texture });
455
+ this.menu.markDirty();
456
+ }
457
+ }
458
+ // make sure the icon is at the first index
459
+ const index = this.spatialContainer.children.indexOf(this.spatialIcon);
460
+ if (index > 0) {
461
+ this.spatialContainer.children.splice(index, 1);
462
+ this.spatialContainer.children.unshift(this.spatialIcon);
463
+ this.menu.markDirty();
464
+ }
465
+ }
466
+ }
467
+ // TODO: perhaps we should have a basic IComponent implementation in the engine folder to be able to write this more easily. OR possibly reduce the IComponent interface to the minimum
468
+ class OnClick {
469
+ isComponent = true;
470
+ enabled = true;
471
+ get activeAndEnabled() { return true; }
472
+ __internalAwake() { }
473
+ __internalEnable() { }
474
+ __internalDisable() { }
475
+ __internalStart() { }
476
+ onEnable() { }
477
+ onDisable() { }
478
+ gameObject;
479
+ allowModifyUI = true;
480
+ get element() {
481
+ return this.gameObject;
482
+ }
483
+ context;
484
+ onclick;
485
+ constructor(context, onclick) {
486
+ this.context = context;
487
+ this.onclick = onclick;
488
+ }
489
+ onPointerEnter() {
490
+ this.context.input.setCursor("pointer");
491
+ if (this.allowModifyUI) {
492
+ this.element.set({ backgroundOpacity: 1 });
493
+ ThreeMeshUI.update();
494
+ }
495
+ }
496
+ onPointerExit() {
497
+ this.context.input.unsetCursor("pointer");
498
+ if (this.allowModifyUI) {
499
+ this.element.set({ backgroundOpacity: 0 });
500
+ ThreeMeshUI.update();
501
+ }
502
+ }
503
+ onPointerDown(e) {
504
+ e.use();
505
+ }
506
+ onPointerUp(e) {
507
+ e.use();
508
+ }
509
+ onPointerClick(e) {
510
+ e.use();
511
+ this.onclick();
512
+ }
513
+ }
514
514
  //# sourceMappingURL=needle-menu-spatial.js.map