@needle-tools/engine 4.6.3 → 4.6.4

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 (1064) hide show
  1. package/CHANGELOG.md +3773 -3773
  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-Bhmc3xq0.umd.cjs → needle-engine.bundle-B0b8OtrF.umd.cjs} +59 -59
  10. package/dist/{needle-engine.bundle-DzStNbW2.min.js → needle-engine.bundle-BDUZt2gN.min.js} +78 -78
  11. package/dist/{needle-engine.bundle-B3xwa0ZL.js → needle-engine.bundle-xlXwBS9f.js} +638 -638
  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 +1673 -1673
  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 +160 -160
  472. package/lib/engine-components/export/usdz/ThreeUSDZExporter.js +1782 -1782
  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/USDZText.d.ts +54 -54
  480. package/lib/engine-components/export/usdz/extensions/USDZText.js +203 -203
  481. package/lib/engine-components/export/usdz/extensions/USDZUI.d.ts +8 -8
  482. package/lib/engine-components/export/usdz/extensions/USDZUI.js +158 -158
  483. package/lib/engine-components/export/usdz/extensions/behavior/Actions.d.ts +30 -30
  484. package/lib/engine-components/export/usdz/extensions/behavior/Actions.js +88 -88
  485. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.d.ts +10 -10
  486. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.js +86 -86
  487. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.d.ts +28 -28
  488. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.js +290 -290
  489. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.d.ts +190 -190
  490. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.js +1060 -1060
  491. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.d.ts +135 -135
  492. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.js +548 -548
  493. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.d.ts +7 -7
  494. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.js +115 -115
  495. package/lib/engine-components/export/usdz/index.d.ts +3 -3
  496. package/lib/engine-components/export/usdz/index.js +2 -2
  497. package/lib/engine-components/export/usdz/utils/animationutils.d.ts +7 -7
  498. package/lib/engine-components/export/usdz/utils/animationutils.js +163 -163
  499. package/lib/engine-components/export/usdz/utils/quicklook.d.ts +2 -2
  500. package/lib/engine-components/export/usdz/utils/quicklook.js +43 -43
  501. package/lib/engine-components/particlesystem/ParticleSystem.d.ts +177 -177
  502. package/lib/engine-components/particlesystem/ParticleSystem.js +1176 -1176
  503. package/lib/engine-components/particlesystem/ParticleSystemModules.d.ts +526 -526
  504. package/lib/engine-components/particlesystem/ParticleSystemModules.js +1930 -1930
  505. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.d.ts +25 -25
  506. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.js +87 -87
  507. package/lib/engine-components/particlesystem/api.d.ts +2 -2
  508. package/lib/engine-components/particlesystem/api.js +2 -2
  509. package/lib/engine-components/postprocessing/Effects/Antialiasing.d.ts +17 -17
  510. package/lib/engine-components/postprocessing/Effects/Antialiasing.js +59 -59
  511. package/lib/engine-components/postprocessing/Effects/BloomEffect.d.ts +46 -46
  512. package/lib/engine-components/postprocessing/Effects/BloomEffect.js +113 -113
  513. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.d.ts +11 -11
  514. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.js +39 -39
  515. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.d.ts +23 -23
  516. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.js +111 -111
  517. package/lib/engine-components/postprocessing/Effects/DepthOfField.d.ts +25 -25
  518. package/lib/engine-components/postprocessing/Effects/DepthOfField.js +104 -104
  519. package/lib/engine-components/postprocessing/Effects/EffectWrapper.d.ts +12 -12
  520. package/lib/engine-components/postprocessing/Effects/EffectWrapper.js +18 -18
  521. package/lib/engine-components/postprocessing/Effects/Pixelation.d.ts +11 -11
  522. package/lib/engine-components/postprocessing/Effects/Pixelation.js +32 -32
  523. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.d.ts +18 -18
  524. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.js +91 -91
  525. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.d.ts +70 -70
  526. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.js +176 -176
  527. package/lib/engine-components/postprocessing/Effects/Sharpening.d.ts +18 -18
  528. package/lib/engine-components/postprocessing/Effects/Sharpening.js +127 -127
  529. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.d.ts +17 -17
  530. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.js +70 -70
  531. package/lib/engine-components/postprocessing/Effects/Tonemapping.d.ts +19 -19
  532. package/lib/engine-components/postprocessing/Effects/Tonemapping.js +94 -94
  533. package/lib/engine-components/postprocessing/Effects/Tonemapping.utils.d.ts +13 -13
  534. package/lib/engine-components/postprocessing/Effects/Tonemapping.utils.js +51 -51
  535. package/lib/engine-components/postprocessing/Effects/Vignette.d.ts +15 -15
  536. package/lib/engine-components/postprocessing/Effects/Vignette.js +60 -60
  537. package/lib/engine-components/postprocessing/PostProcessingEffect.d.ts +90 -90
  538. package/lib/engine-components/postprocessing/PostProcessingEffect.js +168 -168
  539. package/lib/engine-components/postprocessing/PostProcessingHandler.d.ts +42 -42
  540. package/lib/engine-components/postprocessing/PostProcessingHandler.js +494 -495
  541. package/lib/engine-components/postprocessing/PostProcessingHandler.js.map +1 -1
  542. package/lib/engine-components/postprocessing/Volume.d.ts +90 -90
  543. package/lib/engine-components/postprocessing/Volume.js +385 -385
  544. package/lib/engine-components/postprocessing/VolumeParameter.d.ts +26 -26
  545. package/lib/engine-components/postprocessing/VolumeParameter.js +136 -136
  546. package/lib/engine-components/postprocessing/VolumeProfile.d.ts +15 -15
  547. package/lib/engine-components/postprocessing/VolumeProfile.js +60 -60
  548. package/lib/engine-components/postprocessing/index.d.ts +6 -6
  549. package/lib/engine-components/postprocessing/index.js +6 -6
  550. package/lib/engine-components/postprocessing/utils.d.ts +55 -55
  551. package/lib/engine-components/postprocessing/utils.js +119 -119
  552. package/lib/engine-components/timeline/PlayableDirector.d.ts +163 -163
  553. package/lib/engine-components/timeline/PlayableDirector.js +686 -686
  554. package/lib/engine-components/timeline/SignalAsset.d.ts +24 -24
  555. package/lib/engine-components/timeline/SignalAsset.js +130 -130
  556. package/lib/engine-components/timeline/TimelineModels.d.ts +89 -89
  557. package/lib/engine-components/timeline/TimelineModels.js +22 -22
  558. package/lib/engine-components/timeline/TimelineTracks.d.ts +110 -110
  559. package/lib/engine-components/timeline/TimelineTracks.js +879 -879
  560. package/lib/engine-components/timeline/index.d.ts +4 -4
  561. package/lib/engine-components/timeline/index.js +3 -3
  562. package/lib/engine-components/ui/BaseUIComponent.d.ts +48 -48
  563. package/lib/engine-components/ui/BaseUIComponent.js +170 -170
  564. package/lib/engine-components/ui/Button.d.ts +64 -64
  565. package/lib/engine-components/ui/Button.js +315 -315
  566. package/lib/engine-components/ui/Canvas.d.ts +74 -74
  567. package/lib/engine-components/ui/Canvas.js +407 -407
  568. package/lib/engine-components/ui/CanvasGroup.d.ts +19 -19
  569. package/lib/engine-components/ui/CanvasGroup.js +58 -58
  570. package/lib/engine-components/ui/EventSystem.d.ts +125 -125
  571. package/lib/engine-components/ui/EventSystem.js +765 -765
  572. package/lib/engine-components/ui/Graphic.d.ts +55 -55
  573. package/lib/engine-components/ui/Graphic.js +255 -255
  574. package/lib/engine-components/ui/Image.d.ts +35 -35
  575. package/lib/engine-components/ui/Image.js +116 -116
  576. package/lib/engine-components/ui/InputField.d.ts +42 -42
  577. package/lib/engine-components/ui/InputField.js +268 -268
  578. package/lib/engine-components/ui/Interfaces.d.ts +38 -38
  579. package/lib/engine-components/ui/Interfaces.js +12 -12
  580. package/lib/engine-components/ui/Layout.d.ts +84 -84
  581. package/lib/engine-components/ui/Layout.js +330 -330
  582. package/lib/engine-components/ui/Outline.d.ts +7 -7
  583. package/lib/engine-components/ui/Outline.js +20 -20
  584. package/lib/engine-components/ui/PointerEvents.d.ts +115 -115
  585. package/lib/engine-components/ui/PointerEvents.js +145 -145
  586. package/lib/engine-components/ui/RaycastUtils.d.ts +11 -11
  587. package/lib/engine-components/ui/RaycastUtils.js +67 -67
  588. package/lib/engine-components/ui/Raycaster.d.ts +30 -30
  589. package/lib/engine-components/ui/Raycaster.js +95 -95
  590. package/lib/engine-components/ui/RectTransform.d.ts +61 -61
  591. package/lib/engine-components/ui/RectTransform.js +356 -356
  592. package/lib/engine-components/ui/SpatialHtml.d.ts +8 -8
  593. package/lib/engine-components/ui/SpatialHtml.js +79 -79
  594. package/lib/engine-components/ui/Symbols.d.ts +1 -1
  595. package/lib/engine-components/ui/Symbols.js +1 -1
  596. package/lib/engine-components/ui/Text.d.ts +78 -78
  597. package/lib/engine-components/ui/Text.js +539 -539
  598. package/lib/engine-components/ui/Utils.d.ts +24 -24
  599. package/lib/engine-components/ui/Utils.js +90 -90
  600. package/lib/engine-components/ui/index.d.ts +1 -1
  601. package/lib/engine-components/ui/index.js +1 -1
  602. package/lib/engine-components/utils/EnvironmentScene.d.ts +5 -5
  603. package/lib/engine-components/utils/EnvironmentScene.js +205 -205
  604. package/lib/engine-components/utils/LookAt.d.ts +31 -31
  605. package/lib/engine-components/utils/LookAt.js +82 -82
  606. package/lib/engine-components/utils/OpenURL.d.ts +42 -42
  607. package/lib/engine-components/utils/OpenURL.js +119 -119
  608. package/lib/engine-components/webxr/Avatar.d.ts +25 -25
  609. package/lib/engine-components/webxr/Avatar.js +255 -255
  610. package/lib/engine-components/webxr/TeleportTarget.d.ts +7 -7
  611. package/lib/engine-components/webxr/TeleportTarget.js +7 -7
  612. package/lib/engine-components/webxr/WebARCameraBackground.d.ts +30 -30
  613. package/lib/engine-components/webxr/WebARCameraBackground.js +155 -155
  614. package/lib/engine-components/webxr/WebARSessionRoot.d.ts +98 -98
  615. package/lib/engine-components/webxr/WebARSessionRoot.js +770 -770
  616. package/lib/engine-components/webxr/WebXR.d.ts +232 -232
  617. package/lib/engine-components/webxr/WebXR.js +561 -561
  618. package/lib/engine-components/webxr/WebXRAvatar.d.ts +27 -27
  619. package/lib/engine-components/webxr/WebXRAvatar.js +44 -44
  620. package/lib/engine-components/webxr/WebXRImageTracking.d.ts +86 -86
  621. package/lib/engine-components/webxr/WebXRImageTracking.js +471 -471
  622. package/lib/engine-components/webxr/WebXRPlaneTracking.d.ts +92 -92
  623. package/lib/engine-components/webxr/WebXRPlaneTracking.js +500 -500
  624. package/lib/engine-components/webxr/WebXRRig.d.ts +32 -32
  625. package/lib/engine-components/webxr/WebXRRig.js +72 -72
  626. package/lib/engine-components/webxr/XRFlag.d.ts +38 -38
  627. package/lib/engine-components/webxr/XRFlag.js +139 -139
  628. package/lib/engine-components/webxr/controllers/XRControllerFollow.d.ts +47 -47
  629. package/lib/engine-components/webxr/controllers/XRControllerFollow.js +120 -120
  630. package/lib/engine-components/webxr/controllers/XRControllerModel.d.ts +43 -43
  631. package/lib/engine-components/webxr/controllers/XRControllerModel.js +352 -352
  632. package/lib/engine-components/webxr/controllers/XRControllerMovement.d.ts +78 -78
  633. package/lib/engine-components/webxr/controllers/XRControllerMovement.js +506 -506
  634. package/lib/engine-components/webxr/index.d.ts +3 -3
  635. package/lib/engine-components/webxr/index.js +3 -3
  636. package/lib/engine-components/webxr/types.d.ts +3 -3
  637. package/lib/engine-components/webxr/types.js +1 -1
  638. package/lib/engine-components-experimental/Presentation.d.ts +6 -6
  639. package/lib/engine-components-experimental/Presentation.js +9 -9
  640. package/lib/engine-components-experimental/api.d.ts +4 -4
  641. package/lib/engine-components-experimental/api.js +4 -4
  642. package/lib/engine-components-experimental/networking/PlayerSync.d.ts +156 -156
  643. package/lib/engine-components-experimental/networking/PlayerSync.js +377 -377
  644. package/lib/engine-schemes/api.d.ts +12 -12
  645. package/lib/engine-schemes/api.js +12 -12
  646. package/lib/engine-schemes/schemes.d.ts +7 -7
  647. package/lib/engine-schemes/schemes.js +19 -19
  648. package/lib/engine-schemes/synced-camera-model.d.ts +25 -25
  649. package/lib/engine-schemes/synced-camera-model.js +67 -67
  650. package/lib/engine-schemes/synced-transform-model.d.ts +31 -31
  651. package/lib/engine-schemes/synced-transform-model.js +66 -66
  652. package/lib/engine-schemes/transform.d.ts +12 -12
  653. package/lib/engine-schemes/transform.js +39 -39
  654. package/lib/engine-schemes/vec2.d.ts +10 -10
  655. package/lib/engine-schemes/vec2.js +25 -25
  656. package/lib/engine-schemes/vec3.d.ts +11 -11
  657. package/lib/engine-schemes/vec3.js +29 -29
  658. package/lib/engine-schemes/vec4.d.ts +12 -12
  659. package/lib/engine-schemes/vec4.js +33 -33
  660. package/lib/engine-schemes/vr-user-state-buffer.d.ts +37 -37
  661. package/lib/engine-schemes/vr-user-state-buffer.js +110 -110
  662. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.d.ts +6 -6
  663. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.js +45 -45
  664. package/lib/needle-engine.d.ts +7 -7
  665. package/lib/needle-engine.js +64 -64
  666. package/package.json +1 -1
  667. package/plugins/common/buildinfo.js +64 -64
  668. package/plugins/common/cloud.js +1 -1
  669. package/plugins/common/config.cjs +31 -31
  670. package/plugins/common/config.js +35 -35
  671. package/plugins/common/files.js +31 -31
  672. package/plugins/common/generator.js +10 -10
  673. package/plugins/common/license.js +452 -452
  674. package/plugins/common/npm.js +15 -15
  675. package/plugins/common/timers.js +7 -7
  676. package/plugins/common/version.js +37 -37
  677. package/plugins/gltf-packer.mjs +1 -1
  678. package/plugins/next/alias.cjs +39 -39
  679. package/plugins/next/license.cjs +24 -24
  680. package/plugins/next/meshbvhworker.cjs +18 -18
  681. package/plugins/next/next.js +141 -141
  682. package/plugins/types/index.d.ts +2 -2
  683. package/plugins/types/license.d.ts +24 -24
  684. package/plugins/types/needleConfig.d.ts +27 -27
  685. package/plugins/types/next.d.ts +2 -2
  686. package/plugins/types/userconfig.d.ts +120 -120
  687. package/plugins/types/vite.d.ts +13 -13
  688. package/plugins/types/webmanifest.d.ts +32 -32
  689. package/plugins/vite/alias.js +184 -184
  690. package/plugins/vite/asap.js +251 -251
  691. package/plugins/vite/build-pipeline.js +371 -371
  692. package/plugins/vite/build.js +19 -19
  693. package/plugins/vite/buildinfo.js +41 -41
  694. package/plugins/vite/config.js +106 -106
  695. package/plugins/vite/copyfiles.js +138 -138
  696. package/plugins/vite/defines.js +70 -70
  697. package/plugins/vite/dependencies.js +232 -232
  698. package/plugins/vite/dependency-watcher.js +237 -237
  699. package/plugins/vite/drop-client.js +76 -76
  700. package/plugins/vite/drop.js +87 -87
  701. package/plugins/vite/editor-connection.js +124 -124
  702. package/plugins/vite/facebook-instant-games.js +102 -102
  703. package/plugins/vite/gzip.js +5 -5
  704. package/plugins/vite/imports-logger.js +143 -143
  705. package/plugins/vite/index.js +143 -143
  706. package/plugins/vite/license.js +56 -56
  707. package/plugins/vite/local-files.js +440 -440
  708. package/plugins/vite/meta.js +163 -163
  709. package/plugins/vite/npm.js +7 -7
  710. package/plugins/vite/peer.js +29 -29
  711. package/plugins/vite/poster-client.js +73 -73
  712. package/plugins/vite/poster.js +79 -79
  713. package/plugins/vite/pwa.js +604 -604
  714. package/plugins/vite/reload-client.js +15 -15
  715. package/plugins/vite/reload.js +351 -351
  716. package/plugins/vite/server.js +66 -66
  717. package/plugins/vite/transform-codegen.js +55 -55
  718. package/plugins/vite/transform.js +31 -31
  719. package/plugins/vite/vite-4.4-hack.js +31 -31
  720. package/src/asap/needle-asap.ts +111 -111
  721. package/src/asap/sessiongranted.ts +75 -75
  722. package/src/asap/utils.ts +4 -4
  723. package/src/engine/analytics/index.ts +10 -10
  724. package/src/engine/analytics/lcp.ts +35 -35
  725. package/src/engine/api.ts +82 -82
  726. package/src/engine/assets/index.ts +59 -59
  727. package/src/engine/assets/static.js +5 -5
  728. package/src/engine/codegen/register_types.ts +300 -300
  729. package/src/engine/debug/debug.ts +51 -51
  730. package/src/engine/debug/debug_console.ts +333 -333
  731. package/src/engine/debug/debug_overlay.ts +332 -332
  732. package/src/engine/debug/debug_spatial_console.ts +429 -429
  733. package/src/engine/debug/index.ts +1 -1
  734. package/src/engine/engine_addressables.ts +680 -680
  735. package/src/engine/engine_animation.ts +145 -145
  736. package/src/engine/engine_application.ts +113 -113
  737. package/src/engine/engine_assetdatabase.ts +389 -389
  738. package/src/engine/engine_audio.ts +24 -24
  739. package/src/engine/engine_camera.ts +39 -39
  740. package/src/engine/engine_components.ts +366 -366
  741. package/src/engine/engine_components_internal.ts +40 -40
  742. package/src/engine/engine_constants.ts +52 -52
  743. package/src/engine/engine_context.ts +1824 -1824
  744. package/src/engine/engine_context_registry.ts +129 -129
  745. package/src/engine/engine_coroutine.ts +54 -54
  746. package/src/engine/engine_create_objects.ts +411 -411
  747. package/src/engine/engine_default_parameters.ts +3 -3
  748. package/src/engine/engine_editor-sync.ts +28 -28
  749. package/src/engine/engine_fileloader.js +9 -9
  750. package/src/engine/engine_gameobject.ts +712 -712
  751. package/src/engine/engine_generic_utils.js +13 -13
  752. package/src/engine/engine_gizmos.ts +577 -577
  753. package/src/engine/engine_gltf.ts +29 -29
  754. package/src/engine/engine_gltf_builtin_components.ts +403 -403
  755. package/src/engine/engine_hot_reload.ts +210 -210
  756. package/src/engine/engine_input.ts +1500 -1500
  757. package/src/engine/engine_input_utils.ts +23 -23
  758. package/src/engine/engine_instancing.ts +45 -45
  759. package/src/engine/engine_license.ts +386 -386
  760. package/src/engine/engine_lifecycle_api.ts +113 -113
  761. package/src/engine/engine_lifecycle_functions_internal.ts +193 -193
  762. package/src/engine/engine_lightdata.ts +117 -117
  763. package/src/engine/engine_loaders.callbacks.ts +136 -136
  764. package/src/engine/engine_loaders.gltf.ts +82 -82
  765. package/src/engine/engine_loaders.ts +378 -378
  766. package/src/engine/engine_lods.ts +168 -168
  767. package/src/engine/engine_mainloop_utils.ts +472 -472
  768. package/src/engine/engine_math.ts +282 -282
  769. package/src/engine/engine_modules.ts +83 -83
  770. package/src/engine/engine_networking.ts +862 -862
  771. package/src/engine/engine_networking_auto.ts +352 -352
  772. package/src/engine/engine_networking_blob.ts +275 -275
  773. package/src/engine/engine_networking_files.ts +217 -217
  774. package/src/engine/engine_networking_files_default_components.ts +58 -58
  775. package/src/engine/engine_networking_instantiate.ts +419 -419
  776. package/src/engine/engine_networking_peer.ts +159 -159
  777. package/src/engine/engine_networking_streams.ts +713 -713
  778. package/src/engine/engine_networking_types.ts +24 -24
  779. package/src/engine/engine_networking_utils.ts +23 -23
  780. package/src/engine/engine_networking_websocket.ts +2 -2
  781. package/src/engine/engine_patcher.ts +199 -199
  782. package/src/engine/engine_physics.ts +783 -783
  783. package/src/engine/engine_physics.types.ts +46 -46
  784. package/src/engine/engine_physics_rapier.ts +1577 -1577
  785. package/src/engine/engine_playerview.ts +80 -80
  786. package/src/engine/engine_scenelighting.ts +294 -294
  787. package/src/engine/engine_serialization.ts +2 -2
  788. package/src/engine/engine_serialization_builtin_serializer.ts +473 -473
  789. package/src/engine/engine_serialization_core.ts +720 -720
  790. package/src/engine/engine_serialization_decorator.ts +80 -80
  791. package/src/engine/engine_setup.ts +1 -1
  792. package/src/engine/engine_shaders.ts +267 -267
  793. package/src/engine/engine_shims.ts +32 -32
  794. package/src/engine/engine_test_utils.ts +109 -109
  795. package/src/engine/engine_texture.ts +82 -82
  796. package/src/engine/engine_three_utils.ts +925 -925
  797. package/src/engine/engine_time.ts +94 -94
  798. package/src/engine/engine_time_utils.ts +237 -237
  799. package/src/engine/engine_tonemapping.ts +208 -208
  800. package/src/engine/engine_types.ts +730 -730
  801. package/src/engine/engine_typestore.ts +63 -63
  802. package/src/engine/engine_util_decorator.ts +136 -136
  803. package/src/engine/engine_utils.ts +1115 -1115
  804. package/src/engine/engine_utils_format.ts +273 -273
  805. package/src/engine/engine_utils_screenshot.ts +708 -708
  806. package/src/engine/engine_utils_screenshot.xr.ts +103 -103
  807. package/src/engine/export/gltf/Writers.ts +34 -34
  808. package/src/engine/export/gltf/index.ts +158 -158
  809. package/src/engine/export/index.ts +2 -2
  810. package/src/engine/export/state.ts +19 -19
  811. package/src/engine/export/utils.ts +9 -9
  812. package/src/engine/extensions/EXT_texture_exr.ts +50 -50
  813. package/src/engine/extensions/NEEDLE_animator_controller_model.ts +195 -195
  814. package/src/engine/extensions/NEEDLE_components.ts +268 -268
  815. package/src/engine/extensions/NEEDLE_gameobject_data.ts +81 -81
  816. package/src/engine/extensions/NEEDLE_lighting_settings.ts +185 -185
  817. package/src/engine/extensions/NEEDLE_lightmaps.ts +119 -119
  818. package/src/engine/extensions/NEEDLE_persistent_assets.ts +76 -76
  819. package/src/engine/extensions/NEEDLE_render_objects.ts +209 -209
  820. package/src/engine/extensions/NEEDLE_techniques_webgl.ts +640 -640
  821. package/src/engine/extensions/extension_resolver.ts +4 -4
  822. package/src/engine/extensions/extension_utils.ts +166 -166
  823. package/src/engine/extensions/extensions.ts +140 -140
  824. package/src/engine/extensions/index.ts +5 -5
  825. package/src/engine/extensions/usage_tracker.ts +100 -100
  826. package/src/engine/js-extensions/Camera.ts +37 -37
  827. package/src/engine/js-extensions/ExtensionUtils.ts +85 -85
  828. package/src/engine/js-extensions/Layers.ts +23 -23
  829. package/src/engine/js-extensions/Object3D.ts +296 -296
  830. package/src/engine/js-extensions/RGBAColor.ts +126 -126
  831. package/src/engine/js-extensions/Vector.ts +18 -18
  832. package/src/engine/js-extensions/index.ts +4 -4
  833. package/src/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +125 -125
  834. package/src/engine/shaders/shaderData.ts +67 -67
  835. package/src/engine/tests/test_utils.ts +63 -63
  836. package/src/engine/webcomponents/WebXRButtons.ts +260 -260
  837. package/src/engine/webcomponents/api.ts +6 -6
  838. package/src/engine/webcomponents/buttons.ts +292 -292
  839. package/src/engine/webcomponents/fonts.ts +41 -41
  840. package/src/engine/webcomponents/icons.ts +57 -57
  841. package/src/engine/webcomponents/index.ts +1 -1
  842. package/src/engine/webcomponents/logo-element.ts +78 -78
  843. package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts +573 -573
  844. package/src/engine/webcomponents/needle menu/needle-menu.ts +1118 -1118
  845. package/src/engine/webcomponents/needle-button.ts +181 -181
  846. package/src/engine/webcomponents/needle-engine.ar-overlay.ts +186 -186
  847. package/src/engine/webcomponents/needle-engine.attributes.ts +82 -82
  848. package/src/engine/webcomponents/needle-engine.extras.ts +16 -16
  849. package/src/engine/webcomponents/needle-engine.loading.ts +373 -373
  850. package/src/engine/webcomponents/needle-engine.ts +860 -860
  851. package/src/engine/xr/NeedleXRController.ts +1125 -1125
  852. package/src/engine/xr/NeedleXRSession.ts +1624 -1624
  853. package/src/engine/xr/NeedleXRSync.ts +220 -220
  854. package/src/engine/xr/SceneTransition.ts +78 -78
  855. package/src/engine/xr/TempXRContext.ts +216 -216
  856. package/src/engine/xr/XRRig.ts +9 -9
  857. package/src/engine/xr/api.ts +5 -5
  858. package/src/engine/xr/events.ts +102 -102
  859. package/src/engine/xr/internal.ts +34 -34
  860. package/src/engine/xr/usdz.ts +30 -30
  861. package/src/engine/xr/utils.ts +39 -39
  862. package/src/engine-components/AlignmentConstraint.ts +36 -36
  863. package/src/engine-components/Animation.ts +557 -557
  864. package/src/engine-components/AnimationCurve.ts +150 -150
  865. package/src/engine-components/AnimationUtils.ts +28 -28
  866. package/src/engine-components/AnimationUtilsAutoplay.ts +43 -43
  867. package/src/engine-components/Animator.ts +397 -397
  868. package/src/engine-components/AnimatorController.ts +1293 -1293
  869. package/src/engine-components/AudioListener.ts +92 -92
  870. package/src/engine-components/AudioSource.ts +644 -644
  871. package/src/engine-components/AvatarLoader.ts +263 -263
  872. package/src/engine-components/AxesHelper.ts +59 -59
  873. package/src/engine-components/BasicIKConstraint.ts +54 -54
  874. package/src/engine-components/BoxCollider.ts +1 -1
  875. package/src/engine-components/BoxHelperComponent.ts +114 -114
  876. package/src/engine-components/Camera.ts +719 -719
  877. package/src/engine-components/CameraUtils.ts +136 -136
  878. package/src/engine-components/CharacterController.ts +253 -253
  879. package/src/engine-components/Collider.ts +374 -374
  880. package/src/engine-components/Component.ts +1297 -1297
  881. package/src/engine-components/ContactShadows.ts +506 -506
  882. package/src/engine-components/DeleteBox.ts +62 -62
  883. package/src/engine-components/DeviceFlag.ts +46 -46
  884. package/src/engine-components/DragControls.ts +1623 -1623
  885. package/src/engine-components/DropListener.ts +713 -713
  886. package/src/engine-components/Duplicatable.ts +198 -198
  887. package/src/engine-components/EventList.ts +266 -266
  888. package/src/engine-components/EventTrigger.ts +74 -74
  889. package/src/engine-components/EventType.ts +22 -22
  890. package/src/engine-components/Fog.ts +60 -60
  891. package/src/engine-components/Gizmos.ts +56 -56
  892. package/src/engine-components/GridHelper.ts +48 -48
  893. package/src/engine-components/GroundProjection.ts +356 -356
  894. package/src/engine-components/Interactable.ts +14 -14
  895. package/src/engine-components/Joints.ts +52 -52
  896. package/src/engine-components/LODGroup.ts +153 -153
  897. package/src/engine-components/Light.ts +558 -558
  898. package/src/engine-components/LookAtConstraint.ts +25 -25
  899. package/src/engine-components/NeedleMenu.ts +84 -84
  900. package/src/engine-components/NestedGltf.ts +86 -86
  901. package/src/engine-components/Networking.ts +114 -114
  902. package/src/engine-components/OffsetConstraint.ts +60 -60
  903. package/src/engine-components/OrbitControls.ts +1074 -1074
  904. package/src/engine-components/PlayerColor.ts +103 -103
  905. package/src/engine-components/ReflectionProbe.ts +220 -220
  906. package/src/engine-components/Renderer.ts +903 -903
  907. package/src/engine-components/RendererInstancing.ts +855 -855
  908. package/src/engine-components/RendererLightmap.ts +198 -198
  909. package/src/engine-components/RigidBody.ts +526 -526
  910. package/src/engine-components/SceneSwitcher.ts +1030 -1030
  911. package/src/engine-components/ScreenCapture.ts +592 -592
  912. package/src/engine-components/ShadowCatcher.ts +172 -172
  913. package/src/engine-components/Skybox.ts +475 -475
  914. package/src/engine-components/SmoothFollow.ts +76 -76
  915. package/src/engine-components/SpatialTrigger.ts +229 -229
  916. package/src/engine-components/SpectatorCamera.ts +787 -787
  917. package/src/engine-components/SphereCollider.ts +1 -1
  918. package/src/engine-components/SpriteRenderer.ts +468 -468
  919. package/src/engine-components/SyncedCamera.ts +220 -220
  920. package/src/engine-components/SyncedRoom.ts +380 -380
  921. package/src/engine-components/SyncedTransform.ts +383 -383
  922. package/src/engine-components/TestRunner.ts +118 -118
  923. package/src/engine-components/TransformGizmo.ts +219 -219
  924. package/src/engine-components/VideoPlayer.ts +1025 -1025
  925. package/src/engine-components/Voip.ts +363 -363
  926. package/src/engine-components/api.ts +60 -60
  927. package/src/engine-components/avatar/AvatarBlink_Simple.ts +69 -69
  928. package/src/engine-components/avatar/AvatarEyeLook_Rotation.ts +63 -63
  929. package/src/engine-components/avatar/Avatar_Brain_LookAt.ts +139 -139
  930. package/src/engine-components/avatar/Avatar_MouthShapes.ts +83 -83
  931. package/src/engine-components/avatar/Avatar_MustacheShake.ts +31 -31
  932. package/src/engine-components/codegen/components.ts +217 -217
  933. package/src/engine-components/debug/LogStats.ts +21 -21
  934. package/src/engine-components/export/gltf/GltfExport.ts +265 -265
  935. package/src/engine-components/export/usdz/Extension.ts +24 -24
  936. package/src/engine-components/export/usdz/ThreeUSDZExporter.ts +2413 -2413
  937. package/src/engine-components/export/usdz/USDZExporter.ts +705 -705
  938. package/src/engine-components/export/usdz/extensions/Animation.ts +1204 -1204
  939. package/src/engine-components/export/usdz/extensions/DocumentExtension.ts +9 -9
  940. package/src/engine-components/export/usdz/extensions/USDZText.ts +240 -240
  941. package/src/engine-components/export/usdz/extensions/USDZUI.ts +189 -189
  942. package/src/engine-components/export/usdz/extensions/behavior/Actions.ts +99 -99
  943. package/src/engine-components/export/usdz/extensions/behavior/AudioExtension.ts +102 -102
  944. package/src/engine-components/export/usdz/extensions/behavior/Behaviour.ts +320 -320
  945. package/src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts +1225 -1225
  946. package/src/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.ts +646 -646
  947. package/src/engine-components/export/usdz/extensions/behavior/PhysicsExtension.ts +132 -132
  948. package/src/engine-components/export/usdz/index.ts +2 -2
  949. package/src/engine-components/export/usdz/utils/animationutils.ts +191 -191
  950. package/src/engine-components/export/usdz/utils/quicklook.ts +50 -50
  951. package/src/engine-components/particlesystem/ParticleSystem.ts +1287 -1287
  952. package/src/engine-components/particlesystem/ParticleSystemModules.ts +1765 -1765
  953. package/src/engine-components/particlesystem/ParticleSystemSubEmitter.ts +111 -111
  954. package/src/engine-components/particlesystem/api.ts +1 -1
  955. package/src/engine-components/postprocessing/Effects/Antialiasing.ts +64 -64
  956. package/src/engine-components/postprocessing/Effects/BloomEffect.ts +116 -116
  957. package/src/engine-components/postprocessing/Effects/ChromaticAberration.ts +37 -37
  958. package/src/engine-components/postprocessing/Effects/ColorAdjustments.ts +106 -106
  959. package/src/engine-components/postprocessing/Effects/DepthOfField.ts +103 -103
  960. package/src/engine-components/postprocessing/Effects/EffectWrapper.ts +25 -25
  961. package/src/engine-components/postprocessing/Effects/Pixelation.ts +32 -32
  962. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.ts +90 -90
  963. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.ts +192 -192
  964. package/src/engine-components/postprocessing/Effects/Sharpening.ts +143 -143
  965. package/src/engine-components/postprocessing/Effects/TiltShiftEffect.ts +61 -61
  966. package/src/engine-components/postprocessing/Effects/Tonemapping.ts +103 -103
  967. package/src/engine-components/postprocessing/Effects/Tonemapping.utils.ts +60 -60
  968. package/src/engine-components/postprocessing/Effects/Vignette.ts +59 -59
  969. package/src/engine-components/postprocessing/PostProcessingEffect.ts +192 -192
  970. package/src/engine-components/postprocessing/PostProcessingHandler.ts +572 -573
  971. package/src/engine-components/postprocessing/Volume.ts +426 -426
  972. package/src/engine-components/postprocessing/VolumeParameter.ts +158 -158
  973. package/src/engine-components/postprocessing/VolumeProfile.ts +61 -61
  974. package/src/engine-components/postprocessing/index.ts +5 -5
  975. package/src/engine-components/postprocessing/utils.ts +154 -154
  976. package/src/engine-components/timeline/PlayableDirector.ts +722 -722
  977. package/src/engine-components/timeline/SignalAsset.ts +144 -144
  978. package/src/engine-components/timeline/TimelineModels.ts +92 -92
  979. package/src/engine-components/timeline/TimelineTracks.ts +967 -967
  980. package/src/engine-components/timeline/index.ts +3 -3
  981. package/src/engine-components/ui/BaseUIComponent.ts +203 -203
  982. package/src/engine-components/ui/Button.ts +307 -307
  983. package/src/engine-components/ui/Canvas.ts +419 -419
  984. package/src/engine-components/ui/CanvasGroup.ts +54 -54
  985. package/src/engine-components/ui/EventSystem.ts +854 -854
  986. package/src/engine-components/ui/Graphic.ts +275 -275
  987. package/src/engine-components/ui/Image.ts +112 -112
  988. package/src/engine-components/ui/InputField.ts +321 -321
  989. package/src/engine-components/ui/Interfaces.ts +57 -57
  990. package/src/engine-components/ui/Layout.ts +334 -334
  991. package/src/engine-components/ui/Outline.ts +13 -13
  992. package/src/engine-components/ui/PointerEvents.ts +206 -206
  993. package/src/engine-components/ui/RaycastUtils.ts +69 -69
  994. package/src/engine-components/ui/Raycaster.ts +102 -102
  995. package/src/engine-components/ui/RectTransform.ts +375 -375
  996. package/src/engine-components/ui/SpatialHtml.ts +79 -79
  997. package/src/engine-components/ui/Symbols.ts +1 -1
  998. package/src/engine-components/ui/Text.ts +578 -578
  999. package/src/engine-components/ui/Utils.ts +113 -113
  1000. package/src/engine-components/utils/EnvironmentScene.ts +245 -245
  1001. package/src/engine-components/utils/LookAt.ts +88 -88
  1002. package/src/engine-components/utils/OpenURL.ts +114 -114
  1003. package/src/engine-components/webxr/Avatar.ts +265 -265
  1004. package/src/engine-components/webxr/TeleportTarget.ts +9 -9
  1005. package/src/engine-components/webxr/WebARCameraBackground.ts +175 -175
  1006. package/src/engine-components/webxr/WebARSessionRoot.ts +880 -880
  1007. package/src/engine-components/webxr/WebXR.ts +585 -585
  1008. package/src/engine-components/webxr/WebXRAvatar.ts +66 -66
  1009. package/src/engine-components/webxr/WebXRImageTracking.ts +519 -519
  1010. package/src/engine-components/webxr/WebXRPlaneTracking.ts +570 -570
  1011. package/src/engine-components/webxr/WebXRRig.ts +77 -77
  1012. package/src/engine-components/webxr/XRFlag.ts +147 -147
  1013. package/src/engine-components/webxr/controllers/XRControllerFollow.ts +118 -118
  1014. package/src/engine-components/webxr/controllers/XRControllerModel.ts +373 -373
  1015. package/src/engine-components/webxr/controllers/XRControllerMovement.ts +550 -550
  1016. package/src/engine-components/webxr/index.ts +2 -2
  1017. package/src/engine-components/webxr/types.ts +3 -3
  1018. package/src/engine-components-experimental/Presentation.ts +12 -12
  1019. package/src/engine-components-experimental/api.ts +4 -4
  1020. package/src/engine-components-experimental/networking/PlayerSync.ts +401 -401
  1021. package/src/engine-schemes/COMPILE_SCHEMES.bat +3 -3
  1022. package/src/engine-schemes/COMPILE_TS.bat +11 -11
  1023. package/src/engine-schemes/README.md +1 -1
  1024. package/src/engine-schemes/api.ts +12 -12
  1025. package/src/engine-schemes/schemes.ts +28 -28
  1026. package/src/engine-schemes/synced-camera-model.ts +92 -92
  1027. package/src/engine-schemes/synced-transform-model.ts +90 -90
  1028. package/src/engine-schemes/syncedCamera.fbs +10 -10
  1029. package/src/engine-schemes/transform.ts +50 -50
  1030. package/src/engine-schemes/transforms.fbs +25 -25
  1031. package/src/engine-schemes/vec.fbs +19 -19
  1032. package/src/engine-schemes/vec2.ts +33 -33
  1033. package/src/engine-schemes/vec3.ts +38 -38
  1034. package/src/engine-schemes/vec4.ts +43 -43
  1035. package/src/engine-schemes/vr-user-state-buffer.ts +145 -145
  1036. package/src/engine-schemes/vrUserStateBuffer.fbs +17 -17
  1037. package/src/include/draco/draco_decoder.js +34 -34
  1038. package/src/include/ktx2/basis_transcoder.js +21 -21
  1039. package/src/include/needle/arial-msdf.json +1471 -1471
  1040. package/src/include/three/DragControls.js +231 -231
  1041. package/src/include/three/EXT_mesh_gpu_instancing_exporter.js +66 -66
  1042. package/src/needle-engine.ts +70 -70
  1043. package/dist/generateMeshBVH.worker-Cdfpaq5W.js +0 -25
  1044. package/lib/engine-components/export/usdz/extensions/NodeMaterialConverter.d.ts +0 -10
  1045. package/lib/engine-components/export/usdz/extensions/NodeMaterialConverter.js +0 -452
  1046. package/lib/engine-components/export/usdz/extensions/NodeMaterialConverter.js.map +0 -1
  1047. package/src/engine-schemes/dist/api.js +0 -17
  1048. package/src/engine-schemes/dist/api.js.meta +0 -7
  1049. package/src/engine-schemes/dist/schemes.js +0 -25
  1050. package/src/engine-schemes/dist/schemes.js.meta +0 -7
  1051. package/src/engine-schemes/dist/synced-camera-model.js +0 -74
  1052. package/src/engine-schemes/dist/synced-camera-model.js.meta +0 -7
  1053. package/src/engine-schemes/dist/synced-transform-model.js +0 -73
  1054. package/src/engine-schemes/dist/synced-transform-model.js.meta +0 -7
  1055. package/src/engine-schemes/dist/transform.js +0 -46
  1056. package/src/engine-schemes/dist/transform.js.meta +0 -7
  1057. package/src/engine-schemes/dist/vec2.js +0 -32
  1058. package/src/engine-schemes/dist/vec2.js.meta +0 -7
  1059. package/src/engine-schemes/dist/vec3.js +0 -36
  1060. package/src/engine-schemes/dist/vec3.js.meta +0 -7
  1061. package/src/engine-schemes/dist/vec4.js +0 -40
  1062. package/src/engine-schemes/dist/vec4.js.meta +0 -7
  1063. package/src/engine-schemes/dist/vr-user-state-buffer.js +0 -110
  1064. package/src/engine-schemes/dist/vr-user-state-buffer.js.meta +0 -7
@@ -1,404 +1,404 @@
1
- import { Color, CompressedTexture, Euler, LinearSRGBColorSpace, Object3D, RGBAFormat, Texture, WebGLRenderTarget } from "three";
2
- import { isDevEnvironment, showBalloonWarning } from "../engine/debug/index.js";
3
- import { Behaviour, Component, GameObject } from "../engine-components/Component.js";
4
- import { CallInfo, EventList } from "../engine-components/EventList.js";
5
- import { AssetReference } from "./engine_addressables.js";
6
- import { debugExtension } from "./engine_default_parameters.js";
7
- import { TypeSerializer } from "./engine_serialization_core.js";
8
- import { RenderTexture } from "./engine_texture.js";
9
- import { resolveUrl } from "./engine_utils.js";
10
- import { RGBAColor } from "./js-extensions/index.js";
11
- // export class SourcePath {
12
- // src?:string
13
- // };
14
- // class SourcePathSerializer extends TypeSerializer{
15
- // constructor(){
16
- // super(SourcePath);
17
- // }
18
- // onDeserialize(data: any, _context: SerializationContext) {
19
- // if(data.src && typeof data.src === "string"){
20
- // return data.src;
21
- // }
22
- // }
23
- // onSerialize(_data: any, _context: SerializationContext) {
24
- // }
25
- // }
26
- // new SourcePathSerializer();
27
- class ColorSerializer extends TypeSerializer {
28
- constructor() {
29
- super([Color, RGBAColor], "ColorSerializer");
30
- }
31
- onDeserialize(data) {
32
- if (data === undefined || data === null)
33
- return;
34
- if (data.a !== undefined) {
35
- return new RGBAColor(data.r, data.g, data.b, data.a);
36
- }
37
- else if (data.alpha !== undefined) {
38
- return new RGBAColor(data.r, data.g, data.b, data.alpha);
39
- }
40
- return new Color(data.r, data.g, data.b);
41
- }
42
- onSerialize(data) {
43
- if (data === undefined || data === null)
44
- return;
45
- if (data.a !== undefined)
46
- return { r: data.r, g: data.g, b: data.b, a: data.a };
47
- else
48
- return { r: data.r, g: data.g, b: data.b };
49
- }
50
- }
51
- export const colorSerializer = new ColorSerializer();
52
- class EulerSerializer extends TypeSerializer {
53
- constructor() {
54
- super([Euler], "EulerSerializer");
55
- }
56
- onDeserialize(data, _context) {
57
- if (data === undefined || data === null)
58
- return undefined;
59
- if (data.order) {
60
- return new Euler(data.x, data.y, data.z, data.order);
61
- }
62
- else if (data.x != undefined) {
63
- return new Euler(data.x, data.y, data.z);
64
- }
65
- return undefined;
66
- }
67
- onSerialize(data, _context) {
68
- return { x: data.x, y: data.y, z: data.z, order: data.order };
69
- }
70
- }
71
- export const euler = new EulerSerializer();
72
- class ObjectSerializer extends TypeSerializer {
73
- constructor() {
74
- super(Object3D, "ObjectSerializer");
75
- }
76
- onSerialize(data, context) {
77
- if (context.objectToNode !== undefined && data.uuid) {
78
- const node = context.objectToNode[data.uuid];
79
- if (debugExtension)
80
- console.log(node, data.name, data.uuid);
81
- return { node: node };
82
- }
83
- return undefined;
84
- }
85
- onDeserialize(data, context) {
86
- if (typeof data === "string") {
87
- if (data.endsWith(".glb") || data.endsWith(".gltf")) {
88
- // If the @serializable([Object3D, AssetReference]) looks like this we don't need to warn here. This is the case e.g. with SyncedCamera referencing a scene
89
- if (context.serializable instanceof Array) {
90
- if (context.serializable.includes(AssetReference))
91
- return undefined;
92
- }
93
- if (isDevEnvironment())
94
- showBalloonWarning("Detected wrong usage of @serializable with Object3D or GameObject. Instead you should use AssetReference here! Please see the console for details.");
95
- const scriptname = context.target?.constructor?.name;
96
- console.warn(`Wrong usage of @serializable detected in your script \"${scriptname}\"\n\nIt looks like you used @serializable(Object3D) or @serializable(GameObject) for a prefab or scene reference which is exported to a separate glTF file.\n\nTo fix this please change your code to:\n\n@serializable(AssetReference)\n${context.path}! : AssetReference;\n\0`);
97
- }
98
- // ACTUALLY: this is already handled by the extension_utils where we resolve json pointers recursively
99
- // if(data.startsWith("/nodes/")){
100
- // const node = parseInt(data.substring("/nodes/".length));
101
- // if (context.nodeToObject) {
102
- // const res = context.nodeToObject[node];
103
- // if (debugExtension)
104
- // console.log("Deserialized object reference?", data, res, context?.nodeToObject);
105
- // if (!res) console.warn("Did not find node: " + data, context.nodeToObject, context.object);
106
- // return res;
107
- // }
108
- // }
109
- return undefined;
110
- }
111
- if (data) {
112
- if (data.node !== undefined && context.nodeToObject) {
113
- const res = context.nodeToObject[data.node];
114
- if (debugExtension)
115
- console.log("Deserialized object reference?", data, res, context?.nodeToObject);
116
- if (!res)
117
- console.warn("Did not find node: " + data.node, context.nodeToObject, context.object);
118
- return res;
119
- }
120
- else if (data.guid) {
121
- if (!context.context) {
122
- console.error("Missing context");
123
- return undefined;
124
- }
125
- // it is possible that the object is not yet loaded
126
- // e.g. if we have a scene with multiple gltf files and the first gltf references something in the second gltf
127
- // we need a way to wait for all components to be created before we can resolve those references
128
- // independent of order of loading
129
- let res = undefined;
130
- // first try to search in the current gltf scene (if any)
131
- const gltfScene = context.gltf?.scene;
132
- if (gltfScene) {
133
- res = GameObject.findByGuid(data.guid, gltfScene);
134
- }
135
- // if not found, search in the whole scene
136
- if (!res) {
137
- res = GameObject.findByGuid(data.guid, context.context.scene);
138
- }
139
- if (!res) {
140
- if (isDevEnvironment() || debugExtension)
141
- console.warn("Could not resolve object reference", context.path, data, context.target, context.context.scene);
142
- data["could_not_resolve"] = true;
143
- }
144
- else {
145
- if (res && res.isComponent === true) {
146
- if (debugExtension)
147
- console.warn("Deserialized object reference is a component");
148
- res = res.gameObject;
149
- }
150
- if (debugExtension)
151
- console.log("Deserialized object reference?", data, res, context?.nodeToObject);
152
- }
153
- return res;
154
- }
155
- }
156
- return undefined;
157
- }
158
- }
159
- export const objectSerializer = new ObjectSerializer();
160
- class ComponentSerializer extends TypeSerializer {
161
- constructor() {
162
- super([Component, Behaviour], "ComponentSerializer");
163
- }
164
- onSerialize(data, _context) {
165
- if (data?.guid) {
166
- return { guid: data.guid };
167
- }
168
- return undefined;
169
- }
170
- onDeserialize(data, context) {
171
- if (data?.guid) {
172
- // it's a workaround for VolumeParameter having a guid as well. Generally we will probably never have to resolve a component in the scene when it's coming from the persistent asset extension (like in the case for postprocessing volume parameters)
173
- if (data.___persistentAsset) {
174
- if (debugExtension)
175
- console.log("Skipping component deserialization because it's a persistent asset", data);
176
- return undefined;
177
- }
178
- const currentPath = context.path;
179
- // TODO: need to serialize some identifier for referenced components as well, maybe just guid?
180
- // because here the components are created but dont have their former guid assigned
181
- // and will later in the stack just get a newly generated guid
182
- if (debugExtension)
183
- console.log(data.guid, context.root, context.object, context.target);
184
- // first search within the gltf (e.g. necessary when using AssetReference and loading a gltf without adding it to the scene)
185
- // if we would search JUST the scene those references would NEVER be resolved
186
- let res = this.findObjectForGuid(data.guid, context.root);
187
- if (res) {
188
- return res;
189
- }
190
- if (context.context) {
191
- // if not found within the gltf use the provided context scene
192
- // to find references outside
193
- res = this.findObjectForGuid(data.guid, context.context?.scene);
194
- if (res)
195
- return res;
196
- }
197
- if (isDevEnvironment() || debugExtension) {
198
- console.warn("Could not resolve component reference: \"" + currentPath + "\" using guid " + data.guid, context.target);
199
- }
200
- data["could_not_resolve"] = true;
201
- return undefined;
202
- }
203
- // if (data?.node !== undefined && context.nodeToObject) {
204
- // return context.nodeToObject[data.node];
205
- // }
206
- return undefined;
207
- }
208
- findObjectForGuid(guid, root) {
209
- // recursively search root
210
- // need to check the root object too
211
- if (root["guid"] === guid)
212
- return root;
213
- const res = GameObject.foreachComponent(root, (c) => {
214
- if (c.guid === guid)
215
- return c;
216
- return undefined;
217
- }, false);
218
- if (res !== undefined)
219
- return res;
220
- // if not found, search in children
221
- for (let i = 0; i < root.children.length; i++) {
222
- const child = root.children[i];
223
- const res = this.findObjectForGuid(guid, child);
224
- if (res)
225
- return res;
226
- }
227
- }
228
- }
229
- export const componentSerializer = new ComponentSerializer();
230
- const $eventListDebugInfo = Symbol("eventListDebugInfo");
231
- class EventListSerializer extends TypeSerializer {
232
- constructor() {
233
- super([EventList]);
234
- }
235
- onSerialize(_data, _context) {
236
- console.log("TODO: SERIALIZE EVENT");
237
- return undefined;
238
- }
239
- onDeserialize(data, context) {
240
- // TODO: check that we dont accidentally deserialize methods to EventList objects. This is here to make is easy for react-three-fiber to just add props as { () => { } }
241
- if (typeof data === "function") {
242
- const evtList = new EventList([new CallInfo(data, null, [], true)]);
243
- return evtList;
244
- }
245
- else if (data && data.type === "EventList") {
246
- if (debugExtension)
247
- console.log("DESERIALIZE EVENT", data);
248
- const fns = new Array();
249
- if (data.calls && Array.isArray(data.calls)) {
250
- for (const call of data.calls) {
251
- if (debugExtension)
252
- console.log(call);
253
- let target = componentSerializer.findObjectForGuid(call.target, context.root);
254
- // if the object is not found in the current glb try find it in the whole scene
255
- if (!target && context.context?.scene) {
256
- target = componentSerializer.findObjectForGuid(call.target, context.context?.scene);
257
- }
258
- const hasMethod = call.method?.length > 0;
259
- if (target && hasMethod) {
260
- const printWarningMethodNotFound = () => {
261
- const uppercaseMethodName = call.method[0].toUpperCase() + call.method.slice(1);
262
- if (typeof target[uppercaseMethodName] === "function") {
263
- console.warn(`EventList method:\nCould not find method ${call.method} on object ${target.name}. Please rename ${call.method} to ${uppercaseMethodName}?\n`, target[uppercaseMethodName], "\n in script: ", target);
264
- showBalloonWarning("EventList methods must start with lowercase letter, see console for details");
265
- return;
266
- }
267
- else {
268
- console.warn(`EventList method:\nCould not find method ${call.method} on object ${target.name}`, target, typeof target[call.method]);
269
- }
270
- };
271
- const method = target[call.method];
272
- if (typeof method !== "function") {
273
- let foundMethod = false;
274
- let currentPrototype = target;
275
- // test if the target method is actually a property setter
276
- while (currentPrototype) {
277
- const desc = Object.getOwnPropertyDescriptor(currentPrototype, call.method);
278
- if (desc && (desc.writable === true || desc.set)) {
279
- foundMethod = true;
280
- break;
281
- }
282
- currentPrototype = Object.getPrototypeOf(currentPrototype);
283
- }
284
- if (!foundMethod && (isDevEnvironment() || debugExtension))
285
- printWarningMethodNotFound();
286
- }
287
- }
288
- function deserializeArgument(arg) {
289
- if (typeof arg === "object") {
290
- // Try to deserialize the call argument to either a object or a component reference
291
- let argRes = objectSerializer.onDeserialize(arg, context);
292
- if (!argRes)
293
- argRes = componentSerializer.onDeserialize(arg, context);
294
- if (argRes)
295
- return argRes;
296
- }
297
- return arg;
298
- }
299
- if (target) {
300
- let args = call.argument;
301
- if (args !== undefined) {
302
- args = deserializeArgument(args);
303
- }
304
- else if (call.arguments !== undefined) {
305
- args = call.arguments.map(deserializeArgument);
306
- }
307
- const method = target[call.method];
308
- if (!method) {
309
- console.warn(`EventList method not found: \"${call.method}\" on ${target?.name}`);
310
- }
311
- else {
312
- if (args !== undefined && !Array.isArray(args)) {
313
- args = [args];
314
- }
315
- // This is the final method we pass to the call info (or undefined if the method couldnt be resolved)
316
- // const eventMethod = hasMethod ? this.createEventMethod(target, call.method, args) : undefined;
317
- const fn = new CallInfo(target, call.method, args, call.enabled);
318
- fns.push(fn);
319
- }
320
- }
321
- else if (isDevEnvironment()) {
322
- console.warn("[Debug] EventList: Could not find event listener in scene", call, context.object, data);
323
- }
324
- }
325
- }
326
- const evt = new EventList(fns);
327
- if (debugExtension)
328
- console.log(evt);
329
- const eventListOwner = context.target;
330
- if (eventListOwner !== undefined && context.path !== undefined) {
331
- evt.setEventTarget(context.path, eventListOwner);
332
- }
333
- return evt;
334
- }
335
- return undefined;
336
- }
337
- }
338
- export const eventListSerializer = new EventListSerializer();
339
- /** Map<Clone, Original> texture. This is used for compressed textures (or when the GLTFLoader is cloning RenderTextures)
340
- * It's a weak map so we don't have to worry about memory leaks
341
- */
342
- const cloneOriginalMap = new WeakMap();
343
- const textureClone = Texture.prototype.clone;
344
- Texture.prototype.clone = function () {
345
- const clone = textureClone.call(this);
346
- if (!cloneOriginalMap.has(clone)) {
347
- cloneOriginalMap.set(clone, this);
348
- }
349
- return clone;
350
- };
351
- export class RenderTextureSerializer extends TypeSerializer {
352
- constructor() {
353
- super([RenderTexture, WebGLRenderTarget]);
354
- }
355
- onSerialize(_data, _context) {
356
- }
357
- onDeserialize(data, context) {
358
- if (data instanceof Texture && context.type === RenderTexture) {
359
- let tex = data;
360
- // If this is a cloned render texture we want to map it back to the original texture
361
- // See https://linear.app/needle/issue/NE-5530
362
- if (cloneOriginalMap.has(tex)) {
363
- const original = cloneOriginalMap.get(tex);
364
- tex = original;
365
- }
366
- tex.isRenderTargetTexture = true;
367
- tex.flipY = true;
368
- tex.offset.y = 1;
369
- tex.repeat.y = -1;
370
- tex.needsUpdate = true;
371
- // when we have a compressed texture using mipmaps causes error in threejs because the bindframebuffer call will then try to set an array of framebuffers https://linear.app/needle/issue/NE-4294
372
- tex.mipmaps = [];
373
- if (tex instanceof CompressedTexture) {
374
- //@ts-ignore
375
- tex["isCompressedTexture"] = false;
376
- //@ts-ignore
377
- tex.format = RGBAFormat;
378
- }
379
- const rt = new RenderTexture(tex.image.width, tex.image.height, {
380
- colorSpace: LinearSRGBColorSpace,
381
- });
382
- rt.texture = tex;
383
- return rt;
384
- }
385
- return undefined;
386
- }
387
- }
388
- new RenderTextureSerializer();
389
- export class UriSerializer extends TypeSerializer {
390
- constructor() {
391
- super([URL]);
392
- }
393
- onSerialize(_data, _context) {
394
- return null;
395
- }
396
- onDeserialize(data, _context) {
397
- if (typeof data === "string" && data.length > 0) {
398
- return resolveUrl(_context.gltfId, data);
399
- }
400
- return undefined;
401
- }
402
- }
403
- new UriSerializer();
1
+ import { Color, CompressedTexture, Euler, LinearSRGBColorSpace, Object3D, RGBAFormat, Texture, WebGLRenderTarget } from "three";
2
+ import { isDevEnvironment, showBalloonWarning } from "../engine/debug/index.js";
3
+ import { Behaviour, Component, GameObject } from "../engine-components/Component.js";
4
+ import { CallInfo, EventList } from "../engine-components/EventList.js";
5
+ import { AssetReference } from "./engine_addressables.js";
6
+ import { debugExtension } from "./engine_default_parameters.js";
7
+ import { TypeSerializer } from "./engine_serialization_core.js";
8
+ import { RenderTexture } from "./engine_texture.js";
9
+ import { resolveUrl } from "./engine_utils.js";
10
+ import { RGBAColor } from "./js-extensions/index.js";
11
+ // export class SourcePath {
12
+ // src?:string
13
+ // };
14
+ // class SourcePathSerializer extends TypeSerializer{
15
+ // constructor(){
16
+ // super(SourcePath);
17
+ // }
18
+ // onDeserialize(data: any, _context: SerializationContext) {
19
+ // if(data.src && typeof data.src === "string"){
20
+ // return data.src;
21
+ // }
22
+ // }
23
+ // onSerialize(_data: any, _context: SerializationContext) {
24
+ // }
25
+ // }
26
+ // new SourcePathSerializer();
27
+ class ColorSerializer extends TypeSerializer {
28
+ constructor() {
29
+ super([Color, RGBAColor], "ColorSerializer");
30
+ }
31
+ onDeserialize(data) {
32
+ if (data === undefined || data === null)
33
+ return;
34
+ if (data.a !== undefined) {
35
+ return new RGBAColor(data.r, data.g, data.b, data.a);
36
+ }
37
+ else if (data.alpha !== undefined) {
38
+ return new RGBAColor(data.r, data.g, data.b, data.alpha);
39
+ }
40
+ return new Color(data.r, data.g, data.b);
41
+ }
42
+ onSerialize(data) {
43
+ if (data === undefined || data === null)
44
+ return;
45
+ if (data.a !== undefined)
46
+ return { r: data.r, g: data.g, b: data.b, a: data.a };
47
+ else
48
+ return { r: data.r, g: data.g, b: data.b };
49
+ }
50
+ }
51
+ export const colorSerializer = new ColorSerializer();
52
+ class EulerSerializer extends TypeSerializer {
53
+ constructor() {
54
+ super([Euler], "EulerSerializer");
55
+ }
56
+ onDeserialize(data, _context) {
57
+ if (data === undefined || data === null)
58
+ return undefined;
59
+ if (data.order) {
60
+ return new Euler(data.x, data.y, data.z, data.order);
61
+ }
62
+ else if (data.x != undefined) {
63
+ return new Euler(data.x, data.y, data.z);
64
+ }
65
+ return undefined;
66
+ }
67
+ onSerialize(data, _context) {
68
+ return { x: data.x, y: data.y, z: data.z, order: data.order };
69
+ }
70
+ }
71
+ export const euler = new EulerSerializer();
72
+ class ObjectSerializer extends TypeSerializer {
73
+ constructor() {
74
+ super(Object3D, "ObjectSerializer");
75
+ }
76
+ onSerialize(data, context) {
77
+ if (context.objectToNode !== undefined && data.uuid) {
78
+ const node = context.objectToNode[data.uuid];
79
+ if (debugExtension)
80
+ console.log(node, data.name, data.uuid);
81
+ return { node: node };
82
+ }
83
+ return undefined;
84
+ }
85
+ onDeserialize(data, context) {
86
+ if (typeof data === "string") {
87
+ if (data.endsWith(".glb") || data.endsWith(".gltf")) {
88
+ // If the @serializable([Object3D, AssetReference]) looks like this we don't need to warn here. This is the case e.g. with SyncedCamera referencing a scene
89
+ if (context.serializable instanceof Array) {
90
+ if (context.serializable.includes(AssetReference))
91
+ return undefined;
92
+ }
93
+ if (isDevEnvironment())
94
+ showBalloonWarning("Detected wrong usage of @serializable with Object3D or GameObject. Instead you should use AssetReference here! Please see the console for details.");
95
+ const scriptname = context.target?.constructor?.name;
96
+ console.warn(`Wrong usage of @serializable detected in your script \"${scriptname}\"\n\nIt looks like you used @serializable(Object3D) or @serializable(GameObject) for a prefab or scene reference which is exported to a separate glTF file.\n\nTo fix this please change your code to:\n\n@serializable(AssetReference)\n${context.path}! : AssetReference;\n\0`);
97
+ }
98
+ // ACTUALLY: this is already handled by the extension_utils where we resolve json pointers recursively
99
+ // if(data.startsWith("/nodes/")){
100
+ // const node = parseInt(data.substring("/nodes/".length));
101
+ // if (context.nodeToObject) {
102
+ // const res = context.nodeToObject[node];
103
+ // if (debugExtension)
104
+ // console.log("Deserialized object reference?", data, res, context?.nodeToObject);
105
+ // if (!res) console.warn("Did not find node: " + data, context.nodeToObject, context.object);
106
+ // return res;
107
+ // }
108
+ // }
109
+ return undefined;
110
+ }
111
+ if (data) {
112
+ if (data.node !== undefined && context.nodeToObject) {
113
+ const res = context.nodeToObject[data.node];
114
+ if (debugExtension)
115
+ console.log("Deserialized object reference?", data, res, context?.nodeToObject);
116
+ if (!res)
117
+ console.warn("Did not find node: " + data.node, context.nodeToObject, context.object);
118
+ return res;
119
+ }
120
+ else if (data.guid) {
121
+ if (!context.context) {
122
+ console.error("Missing context");
123
+ return undefined;
124
+ }
125
+ // it is possible that the object is not yet loaded
126
+ // e.g. if we have a scene with multiple gltf files and the first gltf references something in the second gltf
127
+ // we need a way to wait for all components to be created before we can resolve those references
128
+ // independent of order of loading
129
+ let res = undefined;
130
+ // first try to search in the current gltf scene (if any)
131
+ const gltfScene = context.gltf?.scene;
132
+ if (gltfScene) {
133
+ res = GameObject.findByGuid(data.guid, gltfScene);
134
+ }
135
+ // if not found, search in the whole scene
136
+ if (!res) {
137
+ res = GameObject.findByGuid(data.guid, context.context.scene);
138
+ }
139
+ if (!res) {
140
+ if (isDevEnvironment() || debugExtension)
141
+ console.warn("Could not resolve object reference", context.path, data, context.target, context.context.scene);
142
+ data["could_not_resolve"] = true;
143
+ }
144
+ else {
145
+ if (res && res.isComponent === true) {
146
+ if (debugExtension)
147
+ console.warn("Deserialized object reference is a component");
148
+ res = res.gameObject;
149
+ }
150
+ if (debugExtension)
151
+ console.log("Deserialized object reference?", data, res, context?.nodeToObject);
152
+ }
153
+ return res;
154
+ }
155
+ }
156
+ return undefined;
157
+ }
158
+ }
159
+ export const objectSerializer = new ObjectSerializer();
160
+ class ComponentSerializer extends TypeSerializer {
161
+ constructor() {
162
+ super([Component, Behaviour], "ComponentSerializer");
163
+ }
164
+ onSerialize(data, _context) {
165
+ if (data?.guid) {
166
+ return { guid: data.guid };
167
+ }
168
+ return undefined;
169
+ }
170
+ onDeserialize(data, context) {
171
+ if (data?.guid) {
172
+ // it's a workaround for VolumeParameter having a guid as well. Generally we will probably never have to resolve a component in the scene when it's coming from the persistent asset extension (like in the case for postprocessing volume parameters)
173
+ if (data.___persistentAsset) {
174
+ if (debugExtension)
175
+ console.log("Skipping component deserialization because it's a persistent asset", data);
176
+ return undefined;
177
+ }
178
+ const currentPath = context.path;
179
+ // TODO: need to serialize some identifier for referenced components as well, maybe just guid?
180
+ // because here the components are created but dont have their former guid assigned
181
+ // and will later in the stack just get a newly generated guid
182
+ if (debugExtension)
183
+ console.log(data.guid, context.root, context.object, context.target);
184
+ // first search within the gltf (e.g. necessary when using AssetReference and loading a gltf without adding it to the scene)
185
+ // if we would search JUST the scene those references would NEVER be resolved
186
+ let res = this.findObjectForGuid(data.guid, context.root);
187
+ if (res) {
188
+ return res;
189
+ }
190
+ if (context.context) {
191
+ // if not found within the gltf use the provided context scene
192
+ // to find references outside
193
+ res = this.findObjectForGuid(data.guid, context.context?.scene);
194
+ if (res)
195
+ return res;
196
+ }
197
+ if (isDevEnvironment() || debugExtension) {
198
+ console.warn("Could not resolve component reference: \"" + currentPath + "\" using guid " + data.guid, context.target);
199
+ }
200
+ data["could_not_resolve"] = true;
201
+ return undefined;
202
+ }
203
+ // if (data?.node !== undefined && context.nodeToObject) {
204
+ // return context.nodeToObject[data.node];
205
+ // }
206
+ return undefined;
207
+ }
208
+ findObjectForGuid(guid, root) {
209
+ // recursively search root
210
+ // need to check the root object too
211
+ if (root["guid"] === guid)
212
+ return root;
213
+ const res = GameObject.foreachComponent(root, (c) => {
214
+ if (c.guid === guid)
215
+ return c;
216
+ return undefined;
217
+ }, false);
218
+ if (res !== undefined)
219
+ return res;
220
+ // if not found, search in children
221
+ for (let i = 0; i < root.children.length; i++) {
222
+ const child = root.children[i];
223
+ const res = this.findObjectForGuid(guid, child);
224
+ if (res)
225
+ return res;
226
+ }
227
+ }
228
+ }
229
+ export const componentSerializer = new ComponentSerializer();
230
+ const $eventListDebugInfo = Symbol("eventListDebugInfo");
231
+ class EventListSerializer extends TypeSerializer {
232
+ constructor() {
233
+ super([EventList]);
234
+ }
235
+ onSerialize(_data, _context) {
236
+ console.log("TODO: SERIALIZE EVENT");
237
+ return undefined;
238
+ }
239
+ onDeserialize(data, context) {
240
+ // TODO: check that we dont accidentally deserialize methods to EventList objects. This is here to make is easy for react-three-fiber to just add props as { () => { } }
241
+ if (typeof data === "function") {
242
+ const evtList = new EventList([new CallInfo(data, null, [], true)]);
243
+ return evtList;
244
+ }
245
+ else if (data && data.type === "EventList") {
246
+ if (debugExtension)
247
+ console.log("DESERIALIZE EVENT", data);
248
+ const fns = new Array();
249
+ if (data.calls && Array.isArray(data.calls)) {
250
+ for (const call of data.calls) {
251
+ if (debugExtension)
252
+ console.log(call);
253
+ let target = componentSerializer.findObjectForGuid(call.target, context.root);
254
+ // if the object is not found in the current glb try find it in the whole scene
255
+ if (!target && context.context?.scene) {
256
+ target = componentSerializer.findObjectForGuid(call.target, context.context?.scene);
257
+ }
258
+ const hasMethod = call.method?.length > 0;
259
+ if (target && hasMethod) {
260
+ const printWarningMethodNotFound = () => {
261
+ const uppercaseMethodName = call.method[0].toUpperCase() + call.method.slice(1);
262
+ if (typeof target[uppercaseMethodName] === "function") {
263
+ console.warn(`EventList method:\nCould not find method ${call.method} on object ${target.name}. Please rename ${call.method} to ${uppercaseMethodName}?\n`, target[uppercaseMethodName], "\n in script: ", target);
264
+ showBalloonWarning("EventList methods must start with lowercase letter, see console for details");
265
+ return;
266
+ }
267
+ else {
268
+ console.warn(`EventList method:\nCould not find method ${call.method} on object ${target.name}`, target, typeof target[call.method]);
269
+ }
270
+ };
271
+ const method = target[call.method];
272
+ if (typeof method !== "function") {
273
+ let foundMethod = false;
274
+ let currentPrototype = target;
275
+ // test if the target method is actually a property setter
276
+ while (currentPrototype) {
277
+ const desc = Object.getOwnPropertyDescriptor(currentPrototype, call.method);
278
+ if (desc && (desc.writable === true || desc.set)) {
279
+ foundMethod = true;
280
+ break;
281
+ }
282
+ currentPrototype = Object.getPrototypeOf(currentPrototype);
283
+ }
284
+ if (!foundMethod && (isDevEnvironment() || debugExtension))
285
+ printWarningMethodNotFound();
286
+ }
287
+ }
288
+ function deserializeArgument(arg) {
289
+ if (typeof arg === "object") {
290
+ // Try to deserialize the call argument to either a object or a component reference
291
+ let argRes = objectSerializer.onDeserialize(arg, context);
292
+ if (!argRes)
293
+ argRes = componentSerializer.onDeserialize(arg, context);
294
+ if (argRes)
295
+ return argRes;
296
+ }
297
+ return arg;
298
+ }
299
+ if (target) {
300
+ let args = call.argument;
301
+ if (args !== undefined) {
302
+ args = deserializeArgument(args);
303
+ }
304
+ else if (call.arguments !== undefined) {
305
+ args = call.arguments.map(deserializeArgument);
306
+ }
307
+ const method = target[call.method];
308
+ if (!method) {
309
+ console.warn(`EventList method not found: \"${call.method}\" on ${target?.name}`);
310
+ }
311
+ else {
312
+ if (args !== undefined && !Array.isArray(args)) {
313
+ args = [args];
314
+ }
315
+ // This is the final method we pass to the call info (or undefined if the method couldnt be resolved)
316
+ // const eventMethod = hasMethod ? this.createEventMethod(target, call.method, args) : undefined;
317
+ const fn = new CallInfo(target, call.method, args, call.enabled);
318
+ fns.push(fn);
319
+ }
320
+ }
321
+ else if (isDevEnvironment()) {
322
+ console.warn("[Debug] EventList: Could not find event listener in scene", call, context.object, data);
323
+ }
324
+ }
325
+ }
326
+ const evt = new EventList(fns);
327
+ if (debugExtension)
328
+ console.log(evt);
329
+ const eventListOwner = context.target;
330
+ if (eventListOwner !== undefined && context.path !== undefined) {
331
+ evt.setEventTarget(context.path, eventListOwner);
332
+ }
333
+ return evt;
334
+ }
335
+ return undefined;
336
+ }
337
+ }
338
+ export const eventListSerializer = new EventListSerializer();
339
+ /** Map<Clone, Original> texture. This is used for compressed textures (or when the GLTFLoader is cloning RenderTextures)
340
+ * It's a weak map so we don't have to worry about memory leaks
341
+ */
342
+ const cloneOriginalMap = new WeakMap();
343
+ const textureClone = Texture.prototype.clone;
344
+ Texture.prototype.clone = function () {
345
+ const clone = textureClone.call(this);
346
+ if (!cloneOriginalMap.has(clone)) {
347
+ cloneOriginalMap.set(clone, this);
348
+ }
349
+ return clone;
350
+ };
351
+ export class RenderTextureSerializer extends TypeSerializer {
352
+ constructor() {
353
+ super([RenderTexture, WebGLRenderTarget]);
354
+ }
355
+ onSerialize(_data, _context) {
356
+ }
357
+ onDeserialize(data, context) {
358
+ if (data instanceof Texture && context.type === RenderTexture) {
359
+ let tex = data;
360
+ // If this is a cloned render texture we want to map it back to the original texture
361
+ // See https://linear.app/needle/issue/NE-5530
362
+ if (cloneOriginalMap.has(tex)) {
363
+ const original = cloneOriginalMap.get(tex);
364
+ tex = original;
365
+ }
366
+ tex.isRenderTargetTexture = true;
367
+ tex.flipY = true;
368
+ tex.offset.y = 1;
369
+ tex.repeat.y = -1;
370
+ tex.needsUpdate = true;
371
+ // when we have a compressed texture using mipmaps causes error in threejs because the bindframebuffer call will then try to set an array of framebuffers https://linear.app/needle/issue/NE-4294
372
+ tex.mipmaps = [];
373
+ if (tex instanceof CompressedTexture) {
374
+ //@ts-ignore
375
+ tex["isCompressedTexture"] = false;
376
+ //@ts-ignore
377
+ tex.format = RGBAFormat;
378
+ }
379
+ const rt = new RenderTexture(tex.image.width, tex.image.height, {
380
+ colorSpace: LinearSRGBColorSpace,
381
+ });
382
+ rt.texture = tex;
383
+ return rt;
384
+ }
385
+ return undefined;
386
+ }
387
+ }
388
+ new RenderTextureSerializer();
389
+ export class UriSerializer extends TypeSerializer {
390
+ constructor() {
391
+ super([URL]);
392
+ }
393
+ onSerialize(_data, _context) {
394
+ return null;
395
+ }
396
+ onDeserialize(data, _context) {
397
+ if (typeof data === "string" && data.length > 0) {
398
+ return resolveUrl(_context.gltfId, data);
399
+ }
400
+ return undefined;
401
+ }
402
+ }
403
+ new UriSerializer();
404
404
  //# sourceMappingURL=engine_serialization_builtin_serializer.js.map