@needle-tools/engine 4.4.1 → 4.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1043) hide show
  1. package/CHANGELOG.md +3671 -3667
  2. package/LICENSE.md +10 -10
  3. package/README.md +64 -64
  4. package/components.needle.json +1 -1
  5. package/dist/needle-engine.bundle.js +333 -219
  6. package/dist/needle-engine.bundle.light.js +333 -219
  7. package/dist/needle-engine.bundle.light.min.js +4 -4
  8. package/dist/needle-engine.bundle.light.umd.cjs +4 -4
  9. package/dist/needle-engine.bundle.min.js +4 -4
  10. package/dist/needle-engine.bundle.umd.cjs +4 -4
  11. package/dist/needle-engine.d.ts +130 -129
  12. package/dist/needle-engine.light.d.ts +130 -129
  13. package/lib/asap/needle-asap.d.ts +1 -1
  14. package/lib/asap/needle-asap.js +95 -95
  15. package/lib/asap/sessiongranted.d.ts +3 -3
  16. package/lib/asap/sessiongranted.js +65 -65
  17. package/lib/asap/utils.d.ts +1 -1
  18. package/lib/asap/utils.js +3 -3
  19. package/lib/engine/analytics/index.d.ts +6 -6
  20. package/lib/engine/analytics/index.js +12 -12
  21. package/lib/engine/analytics/lcp.d.ts +3 -3
  22. package/lib/engine/analytics/lcp.js +34 -34
  23. package/lib/engine/api.d.ts +81 -81
  24. package/lib/engine/api.js +80 -80
  25. package/lib/engine/assets/index.d.ts +11 -11
  26. package/lib/engine/assets/index.js +47 -47
  27. package/lib/engine/assets/static.d.ts +1 -1
  28. package/lib/engine/assets/static.js +4 -4
  29. package/lib/engine/codegen/register_types.d.ts +1 -1
  30. package/lib/engine/codegen/register_types.js +300 -300
  31. package/lib/engine/debug/debug.d.ts +15 -15
  32. package/lib/engine/debug/debug.js +44 -44
  33. package/lib/engine/debug/debug_console.d.ts +2 -2
  34. package/lib/engine/debug/debug_console.js +307 -307
  35. package/lib/engine/debug/debug_overlay.d.ts +22 -22
  36. package/lib/engine/debug/debug_overlay.js +316 -316
  37. package/lib/engine/debug/debug_spatial_console.d.ts +2 -2
  38. package/lib/engine/debug/debug_spatial_console.js +390 -390
  39. package/lib/engine/debug/index.d.ts +2 -2
  40. package/lib/engine/debug/index.js +2 -2
  41. package/lib/engine/engine_addressables.d.ts +166 -166
  42. package/lib/engine/engine_addressables.js +608 -608
  43. package/lib/engine/engine_animation.d.ts +43 -43
  44. package/lib/engine/engine_animation.js +133 -133
  45. package/lib/engine/engine_application.d.ts +40 -40
  46. package/lib/engine/engine_application.js +104 -104
  47. package/lib/engine/engine_assetdatabase.d.ts +25 -25
  48. package/lib/engine/engine_assetdatabase.js +344 -344
  49. package/lib/engine/engine_audio.d.ts +4 -4
  50. package/lib/engine/engine_audio.js +23 -23
  51. package/lib/engine/engine_camera.d.ts +13 -13
  52. package/lib/engine/engine_camera.js +30 -30
  53. package/lib/engine/engine_components.d.ts +110 -110
  54. package/lib/engine/engine_components.js +382 -382
  55. package/lib/engine/engine_components_internal.d.ts +9 -9
  56. package/lib/engine/engine_components_internal.js +36 -36
  57. package/lib/engine/engine_constants.d.ts +10 -10
  58. package/lib/engine/engine_constants.js +41 -41
  59. package/lib/engine/engine_context.d.ts +472 -354
  60. package/lib/engine/engine_context.js +1653 -1536
  61. package/lib/engine/engine_context.js.map +1 -1
  62. package/lib/engine/engine_context_registry.d.ts +71 -71
  63. package/lib/engine/engine_context_registry.js +117 -117
  64. package/lib/engine/engine_coroutine.d.ts +35 -35
  65. package/lib/engine/engine_coroutine.js +52 -52
  66. package/lib/engine/engine_create_objects.d.ts +118 -118
  67. package/lib/engine/engine_create_objects.js +308 -308
  68. package/lib/engine/engine_default_parameters.d.ts +2 -2
  69. package/lib/engine/engine_default_parameters.js +3 -3
  70. package/lib/engine/engine_editor-sync.d.ts +21 -21
  71. package/lib/engine/engine_editor-sync.js +4 -4
  72. package/lib/engine/engine_element.d.ts +113 -113
  73. package/lib/engine/engine_element.js +832 -832
  74. package/lib/engine/engine_element_attributes.d.ts +72 -72
  75. package/lib/engine/engine_element_attributes.js +1 -1
  76. package/lib/engine/engine_element_extras.d.ts +6 -6
  77. package/lib/engine/engine_element_extras.js +13 -13
  78. package/lib/engine/engine_element_loading.d.ts +44 -44
  79. package/lib/engine/engine_element_loading.js +349 -349
  80. package/lib/engine/engine_element_overlay.d.ts +21 -21
  81. package/lib/engine/engine_element_overlay.js +166 -166
  82. package/lib/engine/engine_fileloader.d.ts +2 -2
  83. package/lib/engine/engine_fileloader.js +8 -8
  84. package/lib/engine/engine_gameobject.d.ts +68 -68
  85. package/lib/engine/engine_gameobject.js +596 -596
  86. package/lib/engine/engine_generic_utils.d.ts +1 -1
  87. package/lib/engine/engine_generic_utils.js +13 -13
  88. package/lib/engine/engine_gizmos.d.ts +149 -149
  89. package/lib/engine/engine_gizmos.js +530 -530
  90. package/lib/engine/engine_gltf.d.ts +12 -12
  91. package/lib/engine/engine_gltf.js +15 -15
  92. package/lib/engine/engine_gltf_builtin_components.d.ts +7 -7
  93. package/lib/engine/engine_gltf_builtin_components.js +341 -341
  94. package/lib/engine/engine_hot_reload.d.ts +7 -7
  95. package/lib/engine/engine_hot_reload.js +184 -184
  96. package/lib/engine/engine_input.d.ts +352 -352
  97. package/lib/engine/engine_input.js +1265 -1265
  98. package/lib/engine/engine_input_utils.d.ts +2 -2
  99. package/lib/engine/engine_input_utils.js +22 -22
  100. package/lib/engine/engine_instancing.d.ts +19 -19
  101. package/lib/engine/engine_instancing.js +39 -39
  102. package/lib/engine/engine_license.d.ts +11 -11
  103. package/lib/engine/engine_license.js +361 -361
  104. package/lib/engine/engine_lifecycle_api.d.ts +76 -76
  105. package/lib/engine/engine_lifecycle_api.js +99 -99
  106. package/lib/engine/engine_lifecycle_functions_internal.d.ts +32 -32
  107. package/lib/engine/engine_lifecycle_functions_internal.js +146 -146
  108. package/lib/engine/engine_lightdata.d.ts +23 -23
  109. package/lib/engine/engine_lightdata.js +91 -91
  110. package/lib/engine/engine_loaders.d.ts +13 -13
  111. package/lib/engine/engine_loaders.js +62 -62
  112. package/lib/engine/engine_lods.d.ts +31 -31
  113. package/lib/engine/engine_lods.js +146 -146
  114. package/lib/engine/engine_mainloop_utils.d.ts +32 -32
  115. package/lib/engine/engine_mainloop_utils.js +466 -466
  116. package/lib/engine/engine_math.d.ts +114 -114
  117. package/lib/engine/engine_math.js +247 -247
  118. package/lib/engine/engine_modules.d.ts +36 -36
  119. package/lib/engine/engine_modules.js +85 -85
  120. package/lib/engine/engine_networking.d.ts +252 -252
  121. package/lib/engine/engine_networking.js +743 -743
  122. package/lib/engine/engine_networking_auto.d.ts +24 -24
  123. package/lib/engine/engine_networking_auto.js +310 -310
  124. package/lib/engine/engine_networking_blob.d.ts +48 -48
  125. package/lib/engine/engine_networking_blob.js +228 -228
  126. package/lib/engine/engine_networking_files.d.ts +35 -35
  127. package/lib/engine/engine_networking_files.js +172 -172
  128. package/lib/engine/engine_networking_files_default_components.d.ts +6 -6
  129. package/lib/engine/engine_networking_files_default_components.js +42 -42
  130. package/lib/engine/engine_networking_instantiate.d.ts +100 -100
  131. package/lib/engine/engine_networking_instantiate.js +345 -345
  132. package/lib/engine/engine_networking_peer.d.ts +15 -15
  133. package/lib/engine/engine_networking_peer.js +132 -132
  134. package/lib/engine/engine_networking_streams.d.ts +123 -123
  135. package/lib/engine/engine_networking_streams.js +645 -645
  136. package/lib/engine/engine_networking_types.d.ts +22 -22
  137. package/lib/engine/engine_networking_types.js +7 -7
  138. package/lib/engine/engine_networking_utils.d.ts +2 -2
  139. package/lib/engine/engine_networking_utils.js +20 -20
  140. package/lib/engine/engine_networking_websocket.d.ts +1 -1
  141. package/lib/engine/engine_networking_websocket.js +2 -2
  142. package/lib/engine/engine_patcher.d.ts +10 -10
  143. package/lib/engine/engine_patcher.js +142 -142
  144. package/lib/engine/engine_physics.d.ts +152 -152
  145. package/lib/engine/engine_physics.js +645 -645
  146. package/lib/engine/engine_physics.types.d.ts +40 -40
  147. package/lib/engine/engine_physics.types.js +33 -33
  148. package/lib/engine/engine_physics_rapier.d.ts +147 -147
  149. package/lib/engine/engine_physics_rapier.js +1433 -1433
  150. package/lib/engine/engine_playerview.d.ts +26 -26
  151. package/lib/engine/engine_playerview.js +64 -64
  152. package/lib/engine/engine_scenelighting.d.ts +71 -71
  153. package/lib/engine/engine_scenelighting.js +226 -226
  154. package/lib/engine/engine_scenetools.d.ts +50 -50
  155. package/lib/engine/engine_scenetools.js +321 -321
  156. package/lib/engine/engine_serialization.d.ts +3 -3
  157. package/lib/engine/engine_serialization.js +3 -3
  158. package/lib/engine/engine_serialization_builtin_serializer.d.ts +72 -72
  159. package/lib/engine/engine_serialization_builtin_serializer.js +403 -403
  160. package/lib/engine/engine_serialization_core.d.ts +85 -85
  161. package/lib/engine/engine_serialization_core.js +606 -606
  162. package/lib/engine/engine_serialization_decorator.d.ts +23 -23
  163. package/lib/engine/engine_serialization_decorator.js +66 -66
  164. package/lib/engine/engine_setup.d.ts +1 -1
  165. package/lib/engine/engine_setup.js +2 -2
  166. package/lib/engine/engine_shaders.d.ts +53 -53
  167. package/lib/engine/engine_shaders.js +252 -252
  168. package/lib/engine/engine_shims.d.ts +4 -4
  169. package/lib/engine/engine_shims.js +24 -24
  170. package/lib/engine/engine_test_utils.d.ts +39 -39
  171. package/lib/engine/engine_test_utils.js +83 -83
  172. package/lib/engine/engine_texture.d.ts +28 -28
  173. package/lib/engine/engine_texture.js +64 -64
  174. package/lib/engine/engine_three_utils.d.ts +201 -201
  175. package/lib/engine/engine_three_utils.js +731 -731
  176. package/lib/engine/engine_time.d.ts +51 -51
  177. package/lib/engine/engine_time.js +82 -82
  178. package/lib/engine/engine_time_utils.d.ts +88 -88
  179. package/lib/engine/engine_time_utils.js +215 -215
  180. package/lib/engine/engine_tonemapping.d.ts +2 -2
  181. package/lib/engine/engine_tonemapping.js +194 -194
  182. package/lib/engine/engine_types.d.ts +572 -572
  183. package/lib/engine/engine_types.js +88 -88
  184. package/lib/engine/engine_typestore.d.ts +28 -28
  185. package/lib/engine/engine_typestore.js +55 -55
  186. package/lib/engine/engine_util_decorator.d.ts +13 -13
  187. package/lib/engine/engine_util_decorator.js +116 -116
  188. package/lib/engine/engine_utils.d.ts +266 -266
  189. package/lib/engine/engine_utils.js +878 -878
  190. package/lib/engine/engine_utils_format.d.ts +21 -21
  191. package/lib/engine/engine_utils_format.js +193 -193
  192. package/lib/engine/engine_utils_screenshot.d.ts +159 -159
  193. package/lib/engine/engine_utils_screenshot.js +513 -513
  194. package/lib/engine/engine_utils_screenshot.xr.d.ts +5 -5
  195. package/lib/engine/engine_utils_screenshot.xr.js +90 -90
  196. package/lib/engine/engine_xr.d.ts +1 -1
  197. package/lib/engine/engine_xr.js +1 -1
  198. package/lib/engine/export/gltf/Writers.d.ts +19 -19
  199. package/lib/engine/export/gltf/Writers.js +24 -24
  200. package/lib/engine/export/gltf/index.d.ts +11 -11
  201. package/lib/engine/export/gltf/index.js +123 -123
  202. package/lib/engine/export/index.d.ts +2 -2
  203. package/lib/engine/export/index.js +2 -2
  204. package/lib/engine/export/state.d.ts +7 -7
  205. package/lib/engine/export/state.js +17 -17
  206. package/lib/engine/export/utils.d.ts +2 -2
  207. package/lib/engine/export/utils.js +7 -7
  208. package/lib/engine/extensions/EXT_texture_exr.d.ts +8 -8
  209. package/lib/engine/extensions/EXT_texture_exr.js +32 -32
  210. package/lib/engine/extensions/NEEDLE_animator_controller_model.d.ts +122 -122
  211. package/lib/engine/extensions/NEEDLE_animator_controller_model.js +95 -95
  212. package/lib/engine/extensions/NEEDLE_components.d.ts +35 -35
  213. package/lib/engine/extensions/NEEDLE_components.js +220 -220
  214. package/lib/engine/extensions/NEEDLE_gameobject_data.d.ts +10 -10
  215. package/lib/engine/extensions/NEEDLE_gameobject_data.js +57 -57
  216. package/lib/engine/extensions/NEEDLE_lighting_settings.d.ts +37 -37
  217. package/lib/engine/extensions/NEEDLE_lighting_settings.js +157 -157
  218. package/lib/engine/extensions/NEEDLE_lightmaps.d.ts +18 -18
  219. package/lib/engine/extensions/NEEDLE_lightmaps.js +99 -99
  220. package/lib/engine/extensions/NEEDLE_persistent_assets.d.ts +11 -11
  221. package/lib/engine/extensions/NEEDLE_persistent_assets.js +63 -63
  222. package/lib/engine/extensions/NEEDLE_progressive.d.ts +1 -1
  223. package/lib/engine/extensions/NEEDLE_progressive.js +1 -1
  224. package/lib/engine/extensions/NEEDLE_render_objects.d.ts +13 -13
  225. package/lib/engine/extensions/NEEDLE_render_objects.js +159 -159
  226. package/lib/engine/extensions/NEEDLE_techniques_webgl.d.ts +38 -38
  227. package/lib/engine/extensions/NEEDLE_techniques_webgl.js +564 -564
  228. package/lib/engine/extensions/extension_resolver.d.ts +4 -4
  229. package/lib/engine/extensions/extension_resolver.js +1 -1
  230. package/lib/engine/extensions/extension_utils.d.ts +12 -12
  231. package/lib/engine/extensions/extension_utils.js +152 -152
  232. package/lib/engine/extensions/extensions.d.ts +31 -31
  233. package/lib/engine/extensions/extensions.js +103 -103
  234. package/lib/engine/extensions/index.d.ts +6 -6
  235. package/lib/engine/extensions/index.js +6 -6
  236. package/lib/engine/extensions/usage_tracker.d.ts +13 -13
  237. package/lib/engine/extensions/usage_tracker.js +65 -65
  238. package/lib/engine/js-extensions/Camera.d.ts +1 -1
  239. package/lib/engine/js-extensions/Camera.js +39 -39
  240. package/lib/engine/js-extensions/ExtensionUtils.d.ts +9 -9
  241. package/lib/engine/js-extensions/ExtensionUtils.js +67 -67
  242. package/lib/engine/js-extensions/Layers.d.ts +6 -6
  243. package/lib/engine/js-extensions/Layers.js +22 -22
  244. package/lib/engine/js-extensions/Object3D.d.ts +120 -120
  245. package/lib/engine/js-extensions/Object3D.js +136 -136
  246. package/lib/engine/js-extensions/RGBAColor.d.ts +23 -23
  247. package/lib/engine/js-extensions/RGBAColor.js +111 -110
  248. package/lib/engine/js-extensions/RGBAColor.js.map +1 -1
  249. package/lib/engine/js-extensions/Vector.d.ts +3 -3
  250. package/lib/engine/js-extensions/Vector.js +13 -13
  251. package/lib/engine/js-extensions/index.d.ts +5 -5
  252. package/lib/engine/js-extensions/index.js +5 -5
  253. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.d.ts +4 -4
  254. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +76 -76
  255. package/lib/engine/shaders/shaderData.d.ts +55 -55
  256. package/lib/engine/shaders/shaderData.js +58 -58
  257. package/lib/engine/tests/test_utils.d.ts +2 -2
  258. package/lib/engine/tests/test_utils.js +53 -53
  259. package/lib/engine/webcomponents/WebXRButtons.d.ts +56 -56
  260. package/lib/engine/webcomponents/WebXRButtons.js +230 -230
  261. package/lib/engine/webcomponents/api.d.ts +5 -5
  262. package/lib/engine/webcomponents/api.js +4 -4
  263. package/lib/engine/webcomponents/buttons.d.ts +39 -39
  264. package/lib/engine/webcomponents/buttons.js +237 -237
  265. package/lib/engine/webcomponents/fonts.d.ts +9 -9
  266. package/lib/engine/webcomponents/fonts.js +32 -32
  267. package/lib/engine/webcomponents/icons.d.ts +9 -9
  268. package/lib/engine/webcomponents/icons.js +52 -52
  269. package/lib/engine/webcomponents/index.d.ts +1 -1
  270. package/lib/engine/webcomponents/index.js +1 -1
  271. package/lib/engine/webcomponents/logo-element.d.ts +10 -10
  272. package/lib/engine/webcomponents/logo-element.js +67 -67
  273. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.d.ts +37 -37
  274. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.js +513 -513
  275. package/lib/engine/webcomponents/needle menu/needle-menu.d.ts +155 -155
  276. package/lib/engine/webcomponents/needle menu/needle-menu.js +1029 -1029
  277. package/lib/engine/webcomponents/needle-button.d.ts +34 -34
  278. package/lib/engine/webcomponents/needle-button.js +161 -161
  279. package/lib/engine/xr/NeedleXRController.d.ts +313 -313
  280. package/lib/engine/xr/NeedleXRController.js +1007 -1007
  281. package/lib/engine/xr/NeedleXRSession.d.ts +339 -339
  282. package/lib/engine/xr/NeedleXRSession.js +1427 -1427
  283. package/lib/engine/xr/NeedleXRSync.d.ts +22 -22
  284. package/lib/engine/xr/NeedleXRSync.js +188 -188
  285. package/lib/engine/xr/SceneTransition.d.ts +18 -18
  286. package/lib/engine/xr/SceneTransition.js +69 -69
  287. package/lib/engine/xr/TempXRContext.d.ts +34 -34
  288. package/lib/engine/xr/TempXRContext.js +187 -187
  289. package/lib/engine/xr/XRRig.d.ts +7 -7
  290. package/lib/engine/xr/XRRig.js +1 -1
  291. package/lib/engine/xr/api.d.ts +6 -6
  292. package/lib/engine/xr/api.js +6 -6
  293. package/lib/engine/xr/events.d.ts +66 -66
  294. package/lib/engine/xr/events.js +93 -93
  295. package/lib/engine/xr/internal.d.ts +12 -12
  296. package/lib/engine/xr/internal.js +25 -25
  297. package/lib/engine/xr/usdz.d.ts +12 -12
  298. package/lib/engine/xr/usdz.js +29 -29
  299. package/lib/engine/xr/utils.d.ts +11 -11
  300. package/lib/engine/xr/utils.js +34 -34
  301. package/lib/engine-components/AlignmentConstraint.d.ts +10 -10
  302. package/lib/engine-components/AlignmentConstraint.js +39 -39
  303. package/lib/engine-components/Animation.d.ts +156 -156
  304. package/lib/engine-components/Animation.js +508 -508
  305. package/lib/engine-components/AnimationCurve.d.ts +40 -40
  306. package/lib/engine-components/AnimationCurve.js +159 -159
  307. package/lib/engine-components/AnimationUtils.d.ts +8 -8
  308. package/lib/engine-components/AnimationUtils.js +27 -27
  309. package/lib/engine-components/AnimationUtilsAutoplay.d.ts +1 -1
  310. package/lib/engine-components/AnimationUtilsAutoplay.js +39 -39
  311. package/lib/engine-components/Animator.d.ts +217 -217
  312. package/lib/engine-components/Animator.js +354 -354
  313. package/lib/engine-components/AnimatorController.d.ts +227 -227
  314. package/lib/engine-components/AnimatorController.js +1152 -1152
  315. package/lib/engine-components/AudioListener.d.ts +33 -33
  316. package/lib/engine-components/AudioListener.js +86 -86
  317. package/lib/engine-components/AudioSource.d.ts +217 -217
  318. package/lib/engine-components/AudioSource.js +634 -634
  319. package/lib/engine-components/AvatarLoader.d.ts +80 -80
  320. package/lib/engine-components/AvatarLoader.js +231 -231
  321. package/lib/engine-components/AxesHelper.d.ts +32 -32
  322. package/lib/engine-components/AxesHelper.js +67 -67
  323. package/lib/engine-components/BasicIKConstraint.d.ts +9 -9
  324. package/lib/engine-components/BasicIKConstraint.js +43 -43
  325. package/lib/engine-components/BoxCollider.d.ts +2 -2
  326. package/lib/engine-components/BoxCollider.js +2 -2
  327. package/lib/engine-components/BoxHelperComponent.d.ts +47 -47
  328. package/lib/engine-components/BoxHelperComponent.js +102 -102
  329. package/lib/engine-components/Camera.d.ts +231 -231
  330. package/lib/engine-components/Camera.js +700 -700
  331. package/lib/engine-components/CameraUtils.d.ts +1 -1
  332. package/lib/engine-components/CameraUtils.js +121 -121
  333. package/lib/engine-components/CharacterController.d.ts +55 -55
  334. package/lib/engine-components/CharacterController.js +236 -236
  335. package/lib/engine-components/Collider.d.ts +188 -188
  336. package/lib/engine-components/Collider.js +369 -369
  337. package/lib/engine-components/Component.d.ts +792 -792
  338. package/lib/engine-components/Component.js +915 -915
  339. package/lib/engine-components/ContactShadows.d.ts +82 -82
  340. package/lib/engine-components/ContactShadows.js +430 -430
  341. package/lib/engine-components/DeleteBox.d.ts +19 -19
  342. package/lib/engine-components/DeleteBox.js +58 -58
  343. package/lib/engine-components/DeviceFlag.d.ts +16 -16
  344. package/lib/engine-components/DeviceFlag.js +47 -47
  345. package/lib/engine-components/DragControls.d.ts +170 -170
  346. package/lib/engine-components/DragControls.js +1421 -1421
  347. package/lib/engine-components/DropListener.d.ts +215 -215
  348. package/lib/engine-components/DropListener.js +630 -630
  349. package/lib/engine-components/Duplicatable.d.ts +35 -35
  350. package/lib/engine-components/Duplicatable.js +202 -202
  351. package/lib/engine-components/EventList.d.ts +54 -54
  352. package/lib/engine-components/EventList.js +232 -232
  353. package/lib/engine-components/EventTrigger.d.ts +33 -33
  354. package/lib/engine-components/EventTrigger.js +75 -75
  355. package/lib/engine-components/EventType.d.ts +22 -22
  356. package/lib/engine-components/EventType.js +23 -23
  357. package/lib/engine-components/Fog.d.ts +22 -22
  358. package/lib/engine-components/Fog.js +61 -61
  359. package/lib/engine-components/Gizmos.d.ts +17 -17
  360. package/lib/engine-components/Gizmos.js +64 -64
  361. package/lib/engine-components/GridHelper.d.ts +20 -20
  362. package/lib/engine-components/GridHelper.js +54 -54
  363. package/lib/engine-components/GroundProjection.d.ts +67 -67
  364. package/lib/engine-components/GroundProjection.js +343 -343
  365. package/lib/engine-components/Interactable.d.ts +12 -12
  366. package/lib/engine-components/Interactable.js +12 -12
  367. package/lib/engine-components/Joints.d.ts +19 -19
  368. package/lib/engine-components/Joints.js +51 -51
  369. package/lib/engine-components/LODGroup.d.ts +35 -35
  370. package/lib/engine-components/LODGroup.js +152 -152
  371. package/lib/engine-components/Light.d.ts +180 -180
  372. package/lib/engine-components/Light.js +535 -535
  373. package/lib/engine-components/LookAtConstraint.d.ts +19 -19
  374. package/lib/engine-components/LookAtConstraint.js +35 -35
  375. package/lib/engine-components/NeedleMenu.d.ts +50 -50
  376. package/lib/engine-components/NeedleMenu.js +92 -92
  377. package/lib/engine-components/NestedGltf.d.ts +25 -25
  378. package/lib/engine-components/NestedGltf.js +88 -88
  379. package/lib/engine-components/Networking.d.ts +54 -54
  380. package/lib/engine-components/Networking.js +112 -112
  381. package/lib/engine-components/OffsetConstraint.d.ts +14 -14
  382. package/lib/engine-components/OffsetConstraint.js +65 -65
  383. package/lib/engine-components/OrbitControls.d.ts +266 -266
  384. package/lib/engine-components/OrbitControls.js +1011 -1011
  385. package/lib/engine-components/PlayerColor.d.ts +19 -19
  386. package/lib/engine-components/PlayerColor.js +94 -94
  387. package/lib/engine-components/ReflectionProbe.d.ts +27 -27
  388. package/lib/engine-components/ReflectionProbe.js +201 -201
  389. package/lib/engine-components/Renderer.d.ts +153 -153
  390. package/lib/engine-components/Renderer.js +830 -830
  391. package/lib/engine-components/RendererInstancing.d.ts +140 -140
  392. package/lib/engine-components/RendererInstancing.js +744 -744
  393. package/lib/engine-components/RendererLightmap.d.ts +24 -24
  394. package/lib/engine-components/RendererLightmap.js +182 -182
  395. package/lib/engine-components/RigidBody.d.ts +155 -155
  396. package/lib/engine-components/RigidBody.js +517 -517
  397. package/lib/engine-components/SceneSwitcher.d.ts +263 -263
  398. package/lib/engine-components/SceneSwitcher.js +972 -972
  399. package/lib/engine-components/ScreenCapture.d.ts +144 -144
  400. package/lib/engine-components/ScreenCapture.js +547 -547
  401. package/lib/engine-components/ShadowCatcher.d.ts +33 -33
  402. package/lib/engine-components/ShadowCatcher.js +166 -166
  403. package/lib/engine-components/Skybox.d.ts +82 -82
  404. package/lib/engine-components/Skybox.js +448 -448
  405. package/lib/engine-components/SmoothFollow.d.ts +34 -34
  406. package/lib/engine-components/SmoothFollow.js +82 -82
  407. package/lib/engine-components/SpatialTrigger.d.ts +102 -102
  408. package/lib/engine-components/SpatialTrigger.js +225 -225
  409. package/lib/engine-components/SpectatorCamera.d.ts +111 -111
  410. package/lib/engine-components/SpectatorCamera.js +715 -715
  411. package/lib/engine-components/SphereCollider.d.ts +2 -2
  412. package/lib/engine-components/SphereCollider.js +2 -2
  413. package/lib/engine-components/SpriteRenderer.d.ts +132 -132
  414. package/lib/engine-components/SpriteRenderer.js +472 -472
  415. package/lib/engine-components/SyncedCamera.d.ts +41 -41
  416. package/lib/engine-components/SyncedCamera.js +199 -199
  417. package/lib/engine-components/SyncedRoom.d.ts +106 -106
  418. package/lib/engine-components/SyncedRoom.js +371 -371
  419. package/lib/engine-components/SyncedTransform.d.ts +94 -94
  420. package/lib/engine-components/SyncedTransform.js +331 -331
  421. package/lib/engine-components/TestRunner.d.ts +16 -16
  422. package/lib/engine-components/TestRunner.js +102 -102
  423. package/lib/engine-components/TransformGizmo.d.ts +75 -75
  424. package/lib/engine-components/TransformGizmo.js +209 -209
  425. package/lib/engine-components/VideoPlayer.d.ts +184 -184
  426. package/lib/engine-components/VideoPlayer.js +978 -978
  427. package/lib/engine-components/Voip.d.ts +67 -67
  428. package/lib/engine-components/Voip.js +360 -360
  429. package/lib/engine-components/api.d.ts +51 -51
  430. package/lib/engine-components/api.js +50 -50
  431. package/lib/engine-components/avatar/AvatarBlink_Simple.d.ts +11 -11
  432. package/lib/engine-components/avatar/AvatarBlink_Simple.js +76 -76
  433. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.d.ts +14 -14
  434. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.js +68 -68
  435. package/lib/engine-components/avatar/Avatar_Brain_LookAt.d.ts +29 -29
  436. package/lib/engine-components/avatar/Avatar_Brain_LookAt.js +121 -121
  437. package/lib/engine-components/avatar/Avatar_MouthShapes.d.ts +15 -15
  438. package/lib/engine-components/avatar/Avatar_MouthShapes.js +79 -79
  439. package/lib/engine-components/avatar/Avatar_MustacheShake.d.ts +9 -9
  440. package/lib/engine-components/avatar/Avatar_MustacheShake.js +29 -29
  441. package/lib/engine-components/codegen/components.d.ts +216 -216
  442. package/lib/engine-components/codegen/components.js +218 -218
  443. package/lib/engine-components/debug/LogStats.d.ts +5 -5
  444. package/lib/engine-components/debug/LogStats.js +18 -18
  445. package/lib/engine-components/export/gltf/GltfExport.d.ts +30 -30
  446. package/lib/engine-components/export/gltf/GltfExport.js +246 -246
  447. package/lib/engine-components/export/gltf/index.d.ts +1 -1
  448. package/lib/engine-components/export/gltf/index.js +1 -1
  449. package/lib/engine-components/export/index.d.ts +1 -1
  450. package/lib/engine-components/export/index.js +1 -1
  451. package/lib/engine-components/export/usdz/Extension.d.ts +22 -22
  452. package/lib/engine-components/export/usdz/Extension.js +1 -1
  453. package/lib/engine-components/export/usdz/ThreeUSDZExporter.d.ts +160 -160
  454. package/lib/engine-components/export/usdz/ThreeUSDZExporter.js +1782 -1782
  455. package/lib/engine-components/export/usdz/USDZExporter.d.ts +130 -130
  456. package/lib/engine-components/export/usdz/USDZExporter.js +663 -663
  457. package/lib/engine-components/export/usdz/extensions/Animation.d.ts +106 -106
  458. package/lib/engine-components/export/usdz/extensions/Animation.js +1071 -1071
  459. package/lib/engine-components/export/usdz/extensions/DocumentExtension.d.ts +5 -5
  460. package/lib/engine-components/export/usdz/extensions/DocumentExtension.js +6 -6
  461. package/lib/engine-components/export/usdz/extensions/USDZText.d.ts +54 -54
  462. package/lib/engine-components/export/usdz/extensions/USDZText.js +203 -203
  463. package/lib/engine-components/export/usdz/extensions/USDZUI.d.ts +8 -8
  464. package/lib/engine-components/export/usdz/extensions/USDZUI.js +158 -158
  465. package/lib/engine-components/export/usdz/extensions/behavior/Actions.d.ts +30 -30
  466. package/lib/engine-components/export/usdz/extensions/behavior/Actions.js +88 -88
  467. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.d.ts +10 -10
  468. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.js +86 -86
  469. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.d.ts +28 -28
  470. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.js +290 -290
  471. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.d.ts +190 -190
  472. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.js +1060 -1060
  473. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.d.ts +135 -135
  474. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.js +548 -548
  475. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.d.ts +7 -7
  476. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.js +115 -115
  477. package/lib/engine-components/export/usdz/index.d.ts +3 -3
  478. package/lib/engine-components/export/usdz/index.js +2 -2
  479. package/lib/engine-components/export/usdz/utils/animationutils.d.ts +7 -7
  480. package/lib/engine-components/export/usdz/utils/animationutils.js +163 -163
  481. package/lib/engine-components/export/usdz/utils/quicklook.d.ts +2 -2
  482. package/lib/engine-components/export/usdz/utils/quicklook.js +43 -43
  483. package/lib/engine-components/particlesystem/ParticleSystem.d.ts +177 -177
  484. package/lib/engine-components/particlesystem/ParticleSystem.js +1176 -1176
  485. package/lib/engine-components/particlesystem/ParticleSystemModules.d.ts +526 -526
  486. package/lib/engine-components/particlesystem/ParticleSystemModules.js +1930 -1930
  487. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.d.ts +25 -25
  488. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.js +87 -87
  489. package/lib/engine-components/particlesystem/api.d.ts +2 -2
  490. package/lib/engine-components/particlesystem/api.js +2 -2
  491. package/lib/engine-components/postprocessing/Effects/Antialiasing.d.ts +17 -17
  492. package/lib/engine-components/postprocessing/Effects/Antialiasing.js +50 -50
  493. package/lib/engine-components/postprocessing/Effects/BloomEffect.d.ts +46 -46
  494. package/lib/engine-components/postprocessing/Effects/BloomEffect.js +113 -113
  495. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.d.ts +11 -11
  496. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.js +39 -39
  497. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.d.ts +15 -15
  498. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.js +92 -92
  499. package/lib/engine-components/postprocessing/Effects/DepthOfField.d.ts +25 -25
  500. package/lib/engine-components/postprocessing/Effects/DepthOfField.js +104 -104
  501. package/lib/engine-components/postprocessing/Effects/EffectWrapper.d.ts +12 -12
  502. package/lib/engine-components/postprocessing/Effects/EffectWrapper.js +18 -18
  503. package/lib/engine-components/postprocessing/Effects/Pixelation.d.ts +11 -11
  504. package/lib/engine-components/postprocessing/Effects/Pixelation.js +32 -32
  505. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.d.ts +18 -18
  506. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.js +91 -91
  507. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.d.ts +70 -70
  508. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.js +175 -175
  509. package/lib/engine-components/postprocessing/Effects/Sharpening.d.ts +17 -17
  510. package/lib/engine-components/postprocessing/Effects/Sharpening.js +123 -123
  511. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.d.ts +17 -17
  512. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.js +70 -70
  513. package/lib/engine-components/postprocessing/Effects/Tonemapping.d.ts +26 -26
  514. package/lib/engine-components/postprocessing/Effects/Tonemapping.js +138 -138
  515. package/lib/engine-components/postprocessing/Effects/Vignette.d.ts +15 -15
  516. package/lib/engine-components/postprocessing/Effects/Vignette.js +60 -60
  517. package/lib/engine-components/postprocessing/PostProcessingEffect.d.ts +72 -72
  518. package/lib/engine-components/postprocessing/PostProcessingEffect.js +149 -149
  519. package/lib/engine-components/postprocessing/PostProcessingHandler.d.ts +25 -25
  520. package/lib/engine-components/postprocessing/PostProcessingHandler.js +350 -350
  521. package/lib/engine-components/postprocessing/Volume.d.ts +89 -89
  522. package/lib/engine-components/postprocessing/Volume.js +367 -367
  523. package/lib/engine-components/postprocessing/VolumeParameter.d.ts +26 -26
  524. package/lib/engine-components/postprocessing/VolumeParameter.js +136 -136
  525. package/lib/engine-components/postprocessing/VolumeProfile.d.ts +15 -15
  526. package/lib/engine-components/postprocessing/VolumeProfile.js +60 -60
  527. package/lib/engine-components/postprocessing/index.d.ts +5 -5
  528. package/lib/engine-components/postprocessing/index.js +5 -5
  529. package/lib/engine-components/postprocessing/utils.d.ts +11 -11
  530. package/lib/engine-components/postprocessing/utils.js +37 -37
  531. package/lib/engine-components/timeline/PlayableDirector.d.ts +163 -163
  532. package/lib/engine-components/timeline/PlayableDirector.js +686 -686
  533. package/lib/engine-components/timeline/SignalAsset.d.ts +24 -24
  534. package/lib/engine-components/timeline/SignalAsset.js +130 -130
  535. package/lib/engine-components/timeline/TimelineModels.d.ts +89 -89
  536. package/lib/engine-components/timeline/TimelineModels.js +22 -22
  537. package/lib/engine-components/timeline/TimelineTracks.d.ts +110 -110
  538. package/lib/engine-components/timeline/TimelineTracks.js +879 -879
  539. package/lib/engine-components/timeline/index.d.ts +4 -4
  540. package/lib/engine-components/timeline/index.js +3 -3
  541. package/lib/engine-components/ui/BaseUIComponent.d.ts +48 -48
  542. package/lib/engine-components/ui/BaseUIComponent.js +170 -170
  543. package/lib/engine-components/ui/Button.d.ts +64 -64
  544. package/lib/engine-components/ui/Button.js +315 -315
  545. package/lib/engine-components/ui/Canvas.d.ts +74 -74
  546. package/lib/engine-components/ui/Canvas.js +407 -407
  547. package/lib/engine-components/ui/CanvasGroup.d.ts +19 -19
  548. package/lib/engine-components/ui/CanvasGroup.js +58 -58
  549. package/lib/engine-components/ui/EventSystem.d.ts +125 -125
  550. package/lib/engine-components/ui/EventSystem.js +764 -764
  551. package/lib/engine-components/ui/Graphic.d.ts +55 -55
  552. package/lib/engine-components/ui/Graphic.js +255 -255
  553. package/lib/engine-components/ui/Image.d.ts +35 -35
  554. package/lib/engine-components/ui/Image.js +116 -116
  555. package/lib/engine-components/ui/InputField.d.ts +42 -42
  556. package/lib/engine-components/ui/InputField.js +268 -268
  557. package/lib/engine-components/ui/Interfaces.d.ts +38 -38
  558. package/lib/engine-components/ui/Interfaces.js +12 -12
  559. package/lib/engine-components/ui/Layout.d.ts +84 -84
  560. package/lib/engine-components/ui/Layout.js +330 -330
  561. package/lib/engine-components/ui/Outline.d.ts +7 -7
  562. package/lib/engine-components/ui/Outline.js +20 -20
  563. package/lib/engine-components/ui/PointerEvents.d.ts +115 -115
  564. package/lib/engine-components/ui/PointerEvents.js +145 -145
  565. package/lib/engine-components/ui/RaycastUtils.d.ts +11 -11
  566. package/lib/engine-components/ui/RaycastUtils.js +67 -67
  567. package/lib/engine-components/ui/Raycaster.d.ts +30 -30
  568. package/lib/engine-components/ui/Raycaster.js +95 -95
  569. package/lib/engine-components/ui/RectTransform.d.ts +61 -61
  570. package/lib/engine-components/ui/RectTransform.js +356 -356
  571. package/lib/engine-components/ui/SpatialHtml.d.ts +8 -8
  572. package/lib/engine-components/ui/SpatialHtml.js +79 -79
  573. package/lib/engine-components/ui/Symbols.d.ts +1 -1
  574. package/lib/engine-components/ui/Symbols.js +1 -1
  575. package/lib/engine-components/ui/Text.d.ts +78 -78
  576. package/lib/engine-components/ui/Text.js +539 -539
  577. package/lib/engine-components/ui/Utils.d.ts +24 -24
  578. package/lib/engine-components/ui/Utils.js +90 -90
  579. package/lib/engine-components/ui/index.d.ts +1 -1
  580. package/lib/engine-components/ui/index.js +1 -1
  581. package/lib/engine-components/utils/EnvironmentScene.d.ts +5 -5
  582. package/lib/engine-components/utils/EnvironmentScene.js +205 -205
  583. package/lib/engine-components/utils/LookAt.d.ts +31 -31
  584. package/lib/engine-components/utils/LookAt.js +82 -82
  585. package/lib/engine-components/utils/OpenURL.d.ts +42 -42
  586. package/lib/engine-components/utils/OpenURL.js +119 -119
  587. package/lib/engine-components/webxr/Avatar.d.ts +25 -25
  588. package/lib/engine-components/webxr/Avatar.js +255 -255
  589. package/lib/engine-components/webxr/TeleportTarget.d.ts +7 -7
  590. package/lib/engine-components/webxr/TeleportTarget.js +7 -7
  591. package/lib/engine-components/webxr/WebARCameraBackground.d.ts +30 -30
  592. package/lib/engine-components/webxr/WebARCameraBackground.js +155 -155
  593. package/lib/engine-components/webxr/WebARSessionRoot.d.ts +98 -98
  594. package/lib/engine-components/webxr/WebARSessionRoot.js +770 -770
  595. package/lib/engine-components/webxr/WebXR.d.ts +232 -232
  596. package/lib/engine-components/webxr/WebXR.js +561 -561
  597. package/lib/engine-components/webxr/WebXRAvatar.d.ts +27 -27
  598. package/lib/engine-components/webxr/WebXRAvatar.js +44 -44
  599. package/lib/engine-components/webxr/WebXRImageTracking.d.ts +86 -86
  600. package/lib/engine-components/webxr/WebXRImageTracking.js +470 -470
  601. package/lib/engine-components/webxr/WebXRPlaneTracking.d.ts +92 -92
  602. package/lib/engine-components/webxr/WebXRPlaneTracking.js +500 -500
  603. package/lib/engine-components/webxr/WebXRRig.d.ts +32 -32
  604. package/lib/engine-components/webxr/WebXRRig.js +72 -72
  605. package/lib/engine-components/webxr/XRFlag.d.ts +38 -38
  606. package/lib/engine-components/webxr/XRFlag.js +139 -139
  607. package/lib/engine-components/webxr/controllers/XRControllerFollow.d.ts +47 -47
  608. package/lib/engine-components/webxr/controllers/XRControllerFollow.js +120 -120
  609. package/lib/engine-components/webxr/controllers/XRControllerModel.d.ts +43 -43
  610. package/lib/engine-components/webxr/controllers/XRControllerModel.js +351 -351
  611. package/lib/engine-components/webxr/controllers/XRControllerMovement.d.ts +78 -78
  612. package/lib/engine-components/webxr/controllers/XRControllerMovement.js +506 -506
  613. package/lib/engine-components/webxr/index.d.ts +3 -3
  614. package/lib/engine-components/webxr/index.js +3 -3
  615. package/lib/engine-components/webxr/types.d.ts +3 -3
  616. package/lib/engine-components/webxr/types.js +1 -1
  617. package/lib/engine-components-experimental/Presentation.d.ts +6 -6
  618. package/lib/engine-components-experimental/Presentation.js +9 -9
  619. package/lib/engine-components-experimental/api.d.ts +4 -4
  620. package/lib/engine-components-experimental/api.js +4 -4
  621. package/lib/engine-components-experimental/networking/PlayerSync.d.ts +156 -156
  622. package/lib/engine-components-experimental/networking/PlayerSync.js +377 -377
  623. package/lib/engine-schemes/api.d.ts +12 -12
  624. package/lib/engine-schemes/api.js +12 -12
  625. package/lib/engine-schemes/schemes.d.ts +7 -7
  626. package/lib/engine-schemes/schemes.js +19 -19
  627. package/lib/engine-schemes/synced-camera-model.d.ts +25 -25
  628. package/lib/engine-schemes/synced-camera-model.js +67 -67
  629. package/lib/engine-schemes/synced-transform-model.d.ts +31 -31
  630. package/lib/engine-schemes/synced-transform-model.js +66 -66
  631. package/lib/engine-schemes/transform.d.ts +12 -12
  632. package/lib/engine-schemes/transform.js +39 -39
  633. package/lib/engine-schemes/vec2.d.ts +10 -10
  634. package/lib/engine-schemes/vec2.js +25 -25
  635. package/lib/engine-schemes/vec3.d.ts +11 -11
  636. package/lib/engine-schemes/vec3.js +29 -29
  637. package/lib/engine-schemes/vec4.d.ts +12 -12
  638. package/lib/engine-schemes/vec4.js +33 -33
  639. package/lib/engine-schemes/vr-user-state-buffer.d.ts +37 -37
  640. package/lib/engine-schemes/vr-user-state-buffer.js +110 -110
  641. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.d.ts +6 -6
  642. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.js +45 -45
  643. package/lib/needle-engine.d.ts +7 -7
  644. package/lib/needle-engine.js +64 -64
  645. package/package.json +1 -1
  646. package/plugins/common/buildinfo.js +64 -64
  647. package/plugins/common/cloud.js +1 -1
  648. package/plugins/common/config.cjs +31 -31
  649. package/plugins/common/config.js +35 -35
  650. package/plugins/common/files.js +31 -31
  651. package/plugins/common/generator.js +10 -10
  652. package/plugins/common/license.js +405 -365
  653. package/plugins/common/npm.js +15 -15
  654. package/plugins/common/timers.js +7 -7
  655. package/plugins/common/version.js +37 -37
  656. package/plugins/gltf-packer.mjs +1 -1
  657. package/plugins/next/alias.cjs +39 -39
  658. package/plugins/next/license.cjs +18 -18
  659. package/plugins/next/meshbvhworker.cjs +18 -18
  660. package/plugins/next/next.js +128 -128
  661. package/plugins/types/index.d.ts +2 -2
  662. package/plugins/types/license.d.ts +24 -24
  663. package/plugins/types/needleConfig.d.ts +27 -27
  664. package/plugins/types/userconfig.d.ts +113 -110
  665. package/plugins/types/webmanifest.d.ts +32 -32
  666. package/plugins/vite/alias.js +174 -174
  667. package/plugins/vite/asap.js +245 -245
  668. package/plugins/vite/build-pipeline.js +355 -355
  669. package/plugins/vite/build.js +19 -19
  670. package/plugins/vite/buildinfo.js +41 -41
  671. package/plugins/vite/config.js +106 -106
  672. package/plugins/vite/copyfiles.js +138 -138
  673. package/plugins/vite/defines.js +68 -66
  674. package/plugins/vite/dependencies.js +232 -223
  675. package/plugins/vite/dependency-watcher.js +231 -231
  676. package/plugins/vite/drop-client.js +76 -76
  677. package/plugins/vite/drop.js +87 -87
  678. package/plugins/vite/editor-connection.js +124 -124
  679. package/plugins/vite/facebook-instant-games.js +102 -102
  680. package/plugins/vite/gzip.js +5 -5
  681. package/plugins/vite/imports-logger.js +143 -143
  682. package/plugins/vite/index.js +139 -139
  683. package/plugins/vite/license.js +56 -55
  684. package/plugins/vite/meta.js +163 -163
  685. package/plugins/vite/npm.js +7 -7
  686. package/plugins/vite/peer.js +29 -29
  687. package/plugins/vite/poster-client.js +73 -73
  688. package/plugins/vite/poster.js +79 -79
  689. package/plugins/vite/pwa.js +604 -604
  690. package/plugins/vite/reload-client.js +15 -15
  691. package/plugins/vite/reload.js +363 -363
  692. package/plugins/vite/server.js +66 -66
  693. package/plugins/vite/transform-codegen.js +55 -55
  694. package/plugins/vite/transform.js +31 -31
  695. package/plugins/vite/vite-4.4-hack.js +31 -31
  696. package/src/asap/needle-asap.ts +111 -111
  697. package/src/asap/sessiongranted.ts +75 -75
  698. package/src/asap/utils.ts +4 -4
  699. package/src/engine/analytics/index.ts +10 -10
  700. package/src/engine/analytics/lcp.ts +35 -35
  701. package/src/engine/api.ts +81 -81
  702. package/src/engine/assets/index.ts +59 -59
  703. package/src/engine/assets/static.js +5 -5
  704. package/src/engine/codegen/register_types.ts +300 -300
  705. package/src/engine/debug/debug.ts +51 -51
  706. package/src/engine/debug/debug_console.ts +333 -333
  707. package/src/engine/debug/debug_overlay.ts +332 -332
  708. package/src/engine/debug/debug_spatial_console.ts +429 -429
  709. package/src/engine/debug/index.ts +1 -1
  710. package/src/engine/engine_addressables.ts +680 -680
  711. package/src/engine/engine_animation.ts +145 -145
  712. package/src/engine/engine_application.ts +113 -113
  713. package/src/engine/engine_assetdatabase.ts +387 -387
  714. package/src/engine/engine_audio.ts +24 -24
  715. package/src/engine/engine_camera.ts +39 -39
  716. package/src/engine/engine_components.ts +374 -374
  717. package/src/engine/engine_components_internal.ts +40 -40
  718. package/src/engine/engine_constants.ts +52 -52
  719. package/src/engine/engine_context.ts +1798 -1686
  720. package/src/engine/engine_context_registry.ts +129 -129
  721. package/src/engine/engine_coroutine.ts +54 -54
  722. package/src/engine/engine_create_objects.ts +398 -398
  723. package/src/engine/engine_default_parameters.ts +3 -3
  724. package/src/engine/engine_editor-sync.ts +28 -28
  725. package/src/engine/engine_element.ts +872 -872
  726. package/src/engine/engine_element_attributes.ts +85 -85
  727. package/src/engine/engine_element_extras.ts +16 -16
  728. package/src/engine/engine_element_loading.ts +381 -381
  729. package/src/engine/engine_element_overlay.ts +186 -186
  730. package/src/engine/engine_fileloader.js +9 -9
  731. package/src/engine/engine_gameobject.ts +691 -691
  732. package/src/engine/engine_generic_utils.js +13 -13
  733. package/src/engine/engine_gizmos.ts +577 -577
  734. package/src/engine/engine_gltf.ts +29 -29
  735. package/src/engine/engine_gltf_builtin_components.ts +403 -403
  736. package/src/engine/engine_hot_reload.ts +198 -198
  737. package/src/engine/engine_input.ts +1460 -1460
  738. package/src/engine/engine_input_utils.ts +23 -23
  739. package/src/engine/engine_instancing.ts +45 -45
  740. package/src/engine/engine_license.ts +378 -378
  741. package/src/engine/engine_lifecycle_api.ts +106 -106
  742. package/src/engine/engine_lifecycle_functions_internal.ts +193 -193
  743. package/src/engine/engine_lightdata.ts +117 -117
  744. package/src/engine/engine_loaders.ts +82 -82
  745. package/src/engine/engine_lods.ts +168 -168
  746. package/src/engine/engine_mainloop_utils.ts +472 -472
  747. package/src/engine/engine_math.ts +282 -282
  748. package/src/engine/engine_modules.ts +83 -83
  749. package/src/engine/engine_networking.ts +841 -841
  750. package/src/engine/engine_networking_auto.ts +352 -352
  751. package/src/engine/engine_networking_blob.ts +275 -275
  752. package/src/engine/engine_networking_files.ts +217 -217
  753. package/src/engine/engine_networking_files_default_components.ts +58 -58
  754. package/src/engine/engine_networking_instantiate.ts +419 -419
  755. package/src/engine/engine_networking_peer.ts +159 -159
  756. package/src/engine/engine_networking_streams.ts +713 -713
  757. package/src/engine/engine_networking_types.ts +24 -24
  758. package/src/engine/engine_networking_utils.ts +23 -23
  759. package/src/engine/engine_networking_websocket.ts +2 -2
  760. package/src/engine/engine_patcher.ts +199 -199
  761. package/src/engine/engine_physics.ts +783 -783
  762. package/src/engine/engine_physics.types.ts +46 -46
  763. package/src/engine/engine_physics_rapier.ts +1577 -1577
  764. package/src/engine/engine_playerview.ts +80 -80
  765. package/src/engine/engine_scenelighting.ts +294 -294
  766. package/src/engine/engine_scenetools.ts +365 -365
  767. package/src/engine/engine_serialization.ts +2 -2
  768. package/src/engine/engine_serialization_builtin_serializer.ts +473 -473
  769. package/src/engine/engine_serialization_core.ts +710 -710
  770. package/src/engine/engine_serialization_decorator.ts +80 -80
  771. package/src/engine/engine_setup.ts +1 -1
  772. package/src/engine/engine_shaders.ts +267 -267
  773. package/src/engine/engine_shims.ts +32 -32
  774. package/src/engine/engine_test_utils.ts +109 -109
  775. package/src/engine/engine_texture.ts +82 -82
  776. package/src/engine/engine_three_utils.ts +849 -849
  777. package/src/engine/engine_time.ts +94 -94
  778. package/src/engine/engine_time_utils.ts +237 -237
  779. package/src/engine/engine_tonemapping.ts +210 -210
  780. package/src/engine/engine_types.ts +714 -714
  781. package/src/engine/engine_typestore.ts +63 -63
  782. package/src/engine/engine_util_decorator.ts +136 -136
  783. package/src/engine/engine_utils.ts +972 -972
  784. package/src/engine/engine_utils_format.ts +212 -212
  785. package/src/engine/engine_utils_screenshot.ts +698 -698
  786. package/src/engine/engine_utils_screenshot.xr.ts +103 -103
  787. package/src/engine/export/gltf/Writers.ts +34 -34
  788. package/src/engine/export/gltf/index.ts +158 -158
  789. package/src/engine/export/index.ts +2 -2
  790. package/src/engine/export/state.ts +19 -19
  791. package/src/engine/export/utils.ts +9 -9
  792. package/src/engine/extensions/EXT_texture_exr.ts +50 -50
  793. package/src/engine/extensions/NEEDLE_animator_controller_model.ts +195 -195
  794. package/src/engine/extensions/NEEDLE_components.ts +268 -268
  795. package/src/engine/extensions/NEEDLE_gameobject_data.ts +81 -81
  796. package/src/engine/extensions/NEEDLE_lighting_settings.ts +185 -185
  797. package/src/engine/extensions/NEEDLE_lightmaps.ts +119 -119
  798. package/src/engine/extensions/NEEDLE_persistent_assets.ts +76 -76
  799. package/src/engine/extensions/NEEDLE_render_objects.ts +209 -209
  800. package/src/engine/extensions/NEEDLE_techniques_webgl.ts +640 -640
  801. package/src/engine/extensions/extension_resolver.ts +4 -4
  802. package/src/engine/extensions/extension_utils.ts +166 -166
  803. package/src/engine/extensions/extensions.ts +135 -135
  804. package/src/engine/extensions/index.ts +5 -5
  805. package/src/engine/extensions/usage_tracker.ts +100 -100
  806. package/src/engine/js-extensions/Camera.ts +37 -37
  807. package/src/engine/js-extensions/ExtensionUtils.ts +85 -85
  808. package/src/engine/js-extensions/Layers.ts +23 -23
  809. package/src/engine/js-extensions/Object3D.ts +296 -296
  810. package/src/engine/js-extensions/RGBAColor.ts +126 -125
  811. package/src/engine/js-extensions/Vector.ts +18 -18
  812. package/src/engine/js-extensions/index.ts +4 -4
  813. package/src/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +122 -122
  814. package/src/engine/shaders/shaderData.ts +67 -67
  815. package/src/engine/tests/test_utils.ts +63 -63
  816. package/src/engine/webcomponents/WebXRButtons.ts +260 -260
  817. package/src/engine/webcomponents/api.ts +6 -6
  818. package/src/engine/webcomponents/buttons.ts +262 -262
  819. package/src/engine/webcomponents/fonts.ts +41 -41
  820. package/src/engine/webcomponents/icons.ts +57 -57
  821. package/src/engine/webcomponents/index.ts +1 -1
  822. package/src/engine/webcomponents/logo-element.ts +78 -78
  823. package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts +573 -573
  824. package/src/engine/webcomponents/needle menu/needle-menu.ts +1118 -1118
  825. package/src/engine/webcomponents/needle-button.ts +181 -181
  826. package/src/engine/xr/NeedleXRController.ts +1125 -1125
  827. package/src/engine/xr/NeedleXRSession.ts +1585 -1585
  828. package/src/engine/xr/NeedleXRSync.ts +220 -220
  829. package/src/engine/xr/SceneTransition.ts +78 -78
  830. package/src/engine/xr/TempXRContext.ts +216 -216
  831. package/src/engine/xr/XRRig.ts +9 -9
  832. package/src/engine/xr/api.ts +5 -5
  833. package/src/engine/xr/events.ts +102 -102
  834. package/src/engine/xr/internal.ts +34 -34
  835. package/src/engine/xr/usdz.ts +30 -30
  836. package/src/engine/xr/utils.ts +39 -39
  837. package/src/engine-components/AlignmentConstraint.ts +36 -36
  838. package/src/engine-components/Animation.ts +557 -557
  839. package/src/engine-components/AnimationCurve.ts +150 -150
  840. package/src/engine-components/AnimationUtils.ts +28 -28
  841. package/src/engine-components/AnimationUtilsAutoplay.ts +43 -43
  842. package/src/engine-components/Animator.ts +397 -397
  843. package/src/engine-components/AnimatorController.ts +1293 -1293
  844. package/src/engine-components/AudioListener.ts +92 -92
  845. package/src/engine-components/AudioSource.ts +644 -644
  846. package/src/engine-components/AvatarLoader.ts +263 -263
  847. package/src/engine-components/AxesHelper.ts +59 -59
  848. package/src/engine-components/BasicIKConstraint.ts +54 -54
  849. package/src/engine-components/BoxCollider.ts +1 -1
  850. package/src/engine-components/BoxHelperComponent.ts +114 -114
  851. package/src/engine-components/Camera.ts +719 -719
  852. package/src/engine-components/CameraUtils.ts +136 -136
  853. package/src/engine-components/CharacterController.ts +253 -253
  854. package/src/engine-components/Collider.ts +374 -374
  855. package/src/engine-components/Component.ts +1294 -1294
  856. package/src/engine-components/ContactShadows.ts +482 -482
  857. package/src/engine-components/DeleteBox.ts +62 -62
  858. package/src/engine-components/DeviceFlag.ts +46 -46
  859. package/src/engine-components/DragControls.ts +1623 -1623
  860. package/src/engine-components/DropListener.ts +698 -698
  861. package/src/engine-components/Duplicatable.ts +198 -198
  862. package/src/engine-components/EventList.ts +266 -266
  863. package/src/engine-components/EventTrigger.ts +74 -74
  864. package/src/engine-components/EventType.ts +22 -22
  865. package/src/engine-components/Fog.ts +60 -60
  866. package/src/engine-components/Gizmos.ts +56 -56
  867. package/src/engine-components/GridHelper.ts +48 -48
  868. package/src/engine-components/GroundProjection.ts +356 -356
  869. package/src/engine-components/Interactable.ts +14 -14
  870. package/src/engine-components/Joints.ts +52 -52
  871. package/src/engine-components/LODGroup.ts +153 -153
  872. package/src/engine-components/Light.ts +558 -558
  873. package/src/engine-components/LookAtConstraint.ts +25 -25
  874. package/src/engine-components/NeedleMenu.ts +84 -84
  875. package/src/engine-components/NestedGltf.ts +86 -86
  876. package/src/engine-components/Networking.ts +114 -114
  877. package/src/engine-components/OffsetConstraint.ts +60 -60
  878. package/src/engine-components/OrbitControls.ts +1069 -1069
  879. package/src/engine-components/PlayerColor.ts +103 -103
  880. package/src/engine-components/ReflectionProbe.ts +216 -216
  881. package/src/engine-components/Renderer.ts +900 -900
  882. package/src/engine-components/RendererInstancing.ts +855 -855
  883. package/src/engine-components/RendererLightmap.ts +198 -198
  884. package/src/engine-components/RigidBody.ts +526 -526
  885. package/src/engine-components/SceneSwitcher.ts +1030 -1030
  886. package/src/engine-components/ScreenCapture.ts +592 -592
  887. package/src/engine-components/ShadowCatcher.ts +172 -172
  888. package/src/engine-components/Skybox.ts +455 -455
  889. package/src/engine-components/SmoothFollow.ts +76 -76
  890. package/src/engine-components/SpatialTrigger.ts +229 -229
  891. package/src/engine-components/SpectatorCamera.ts +787 -787
  892. package/src/engine-components/SphereCollider.ts +1 -1
  893. package/src/engine-components/SpriteRenderer.ts +468 -468
  894. package/src/engine-components/SyncedCamera.ts +220 -220
  895. package/src/engine-components/SyncedRoom.ts +380 -380
  896. package/src/engine-components/SyncedTransform.ts +383 -383
  897. package/src/engine-components/TestRunner.ts +118 -118
  898. package/src/engine-components/TransformGizmo.ts +219 -219
  899. package/src/engine-components/VideoPlayer.ts +1025 -1025
  900. package/src/engine-components/Voip.ts +363 -363
  901. package/src/engine-components/api.ts +60 -60
  902. package/src/engine-components/avatar/AvatarBlink_Simple.ts +69 -69
  903. package/src/engine-components/avatar/AvatarEyeLook_Rotation.ts +63 -63
  904. package/src/engine-components/avatar/Avatar_Brain_LookAt.ts +139 -139
  905. package/src/engine-components/avatar/Avatar_MouthShapes.ts +83 -83
  906. package/src/engine-components/avatar/Avatar_MustacheShake.ts +31 -31
  907. package/src/engine-components/codegen/components.ts +217 -217
  908. package/src/engine-components/debug/LogStats.ts +21 -21
  909. package/src/engine-components/export/gltf/GltfExport.ts +265 -265
  910. package/src/engine-components/export/usdz/Extension.ts +24 -24
  911. package/src/engine-components/export/usdz/ThreeUSDZExporter.ts +2413 -2413
  912. package/src/engine-components/export/usdz/USDZExporter.ts +705 -705
  913. package/src/engine-components/export/usdz/extensions/Animation.ts +1204 -1204
  914. package/src/engine-components/export/usdz/extensions/DocumentExtension.ts +9 -9
  915. package/src/engine-components/export/usdz/extensions/USDZText.ts +240 -240
  916. package/src/engine-components/export/usdz/extensions/USDZUI.ts +189 -189
  917. package/src/engine-components/export/usdz/extensions/behavior/Actions.ts +99 -99
  918. package/src/engine-components/export/usdz/extensions/behavior/AudioExtension.ts +102 -102
  919. package/src/engine-components/export/usdz/extensions/behavior/Behaviour.ts +320 -320
  920. package/src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts +1225 -1225
  921. package/src/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.ts +646 -646
  922. package/src/engine-components/export/usdz/extensions/behavior/PhysicsExtension.ts +132 -132
  923. package/src/engine-components/export/usdz/index.ts +2 -2
  924. package/src/engine-components/export/usdz/utils/animationutils.ts +191 -191
  925. package/src/engine-components/export/usdz/utils/quicklook.ts +50 -50
  926. package/src/engine-components/particlesystem/ParticleSystem.ts +1287 -1287
  927. package/src/engine-components/particlesystem/ParticleSystemModules.ts +1765 -1765
  928. package/src/engine-components/particlesystem/ParticleSystemSubEmitter.ts +111 -111
  929. package/src/engine-components/particlesystem/api.ts +1 -1
  930. package/src/engine-components/postprocessing/Effects/Antialiasing.ts +55 -55
  931. package/src/engine-components/postprocessing/Effects/BloomEffect.ts +116 -116
  932. package/src/engine-components/postprocessing/Effects/ChromaticAberration.ts +37 -37
  933. package/src/engine-components/postprocessing/Effects/ColorAdjustments.ts +95 -95
  934. package/src/engine-components/postprocessing/Effects/DepthOfField.ts +103 -103
  935. package/src/engine-components/postprocessing/Effects/EffectWrapper.ts +25 -25
  936. package/src/engine-components/postprocessing/Effects/Pixelation.ts +32 -32
  937. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.ts +90 -90
  938. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.ts +191 -191
  939. package/src/engine-components/postprocessing/Effects/Sharpening.ts +138 -138
  940. package/src/engine-components/postprocessing/Effects/TiltShiftEffect.ts +61 -61
  941. package/src/engine-components/postprocessing/Effects/Tonemapping.ts +155 -155
  942. package/src/engine-components/postprocessing/Effects/Vignette.ts +59 -59
  943. package/src/engine-components/postprocessing/PostProcessingEffect.ts +172 -172
  944. package/src/engine-components/postprocessing/PostProcessingHandler.ts +398 -398
  945. package/src/engine-components/postprocessing/Volume.ts +410 -410
  946. package/src/engine-components/postprocessing/VolumeParameter.ts +158 -158
  947. package/src/engine-components/postprocessing/VolumeProfile.ts +61 -61
  948. package/src/engine-components/postprocessing/index.ts +5 -5
  949. package/src/engine-components/postprocessing/utils.ts +52 -52
  950. package/src/engine-components/timeline/PlayableDirector.ts +722 -722
  951. package/src/engine-components/timeline/SignalAsset.ts +144 -144
  952. package/src/engine-components/timeline/TimelineModels.ts +92 -92
  953. package/src/engine-components/timeline/TimelineTracks.ts +967 -967
  954. package/src/engine-components/timeline/index.ts +3 -3
  955. package/src/engine-components/ui/BaseUIComponent.ts +203 -203
  956. package/src/engine-components/ui/Button.ts +307 -307
  957. package/src/engine-components/ui/Canvas.ts +419 -419
  958. package/src/engine-components/ui/CanvasGroup.ts +54 -54
  959. package/src/engine-components/ui/EventSystem.ts +853 -853
  960. package/src/engine-components/ui/Graphic.ts +275 -275
  961. package/src/engine-components/ui/Image.ts +112 -112
  962. package/src/engine-components/ui/InputField.ts +321 -321
  963. package/src/engine-components/ui/Interfaces.ts +57 -57
  964. package/src/engine-components/ui/Layout.ts +334 -334
  965. package/src/engine-components/ui/Outline.ts +13 -13
  966. package/src/engine-components/ui/PointerEvents.ts +206 -206
  967. package/src/engine-components/ui/RaycastUtils.ts +69 -69
  968. package/src/engine-components/ui/Raycaster.ts +102 -102
  969. package/src/engine-components/ui/RectTransform.ts +375 -375
  970. package/src/engine-components/ui/SpatialHtml.ts +79 -79
  971. package/src/engine-components/ui/Symbols.ts +1 -1
  972. package/src/engine-components/ui/Text.ts +578 -578
  973. package/src/engine-components/ui/Utils.ts +113 -113
  974. package/src/engine-components/utils/EnvironmentScene.ts +245 -245
  975. package/src/engine-components/utils/LookAt.ts +88 -88
  976. package/src/engine-components/utils/OpenURL.ts +114 -114
  977. package/src/engine-components/webxr/Avatar.ts +265 -265
  978. package/src/engine-components/webxr/TeleportTarget.ts +9 -9
  979. package/src/engine-components/webxr/WebARCameraBackground.ts +175 -175
  980. package/src/engine-components/webxr/WebARSessionRoot.ts +880 -880
  981. package/src/engine-components/webxr/WebXR.ts +585 -585
  982. package/src/engine-components/webxr/WebXRAvatar.ts +66 -66
  983. package/src/engine-components/webxr/WebXRImageTracking.ts +518 -518
  984. package/src/engine-components/webxr/WebXRPlaneTracking.ts +570 -570
  985. package/src/engine-components/webxr/WebXRRig.ts +77 -77
  986. package/src/engine-components/webxr/XRFlag.ts +147 -147
  987. package/src/engine-components/webxr/controllers/XRControllerFollow.ts +118 -118
  988. package/src/engine-components/webxr/controllers/XRControllerModel.ts +374 -374
  989. package/src/engine-components/webxr/controllers/XRControllerMovement.ts +550 -550
  990. package/src/engine-components/webxr/index.ts +2 -2
  991. package/src/engine-components/webxr/types.ts +3 -3
  992. package/src/engine-components-experimental/Presentation.ts +12 -12
  993. package/src/engine-components-experimental/api.ts +4 -4
  994. package/src/engine-components-experimental/networking/PlayerSync.ts +401 -401
  995. package/src/engine-schemes/COMPILE_SCHEMES.bat +3 -3
  996. package/src/engine-schemes/COMPILE_TS.bat +11 -11
  997. package/src/engine-schemes/README.md +1 -1
  998. package/src/engine-schemes/api.ts +12 -12
  999. package/src/engine-schemes/schemes.ts +28 -28
  1000. package/src/engine-schemes/synced-camera-model.ts +92 -92
  1001. package/src/engine-schemes/synced-transform-model.ts +90 -90
  1002. package/src/engine-schemes/syncedCamera.fbs +10 -10
  1003. package/src/engine-schemes/transform.ts +50 -50
  1004. package/src/engine-schemes/transforms.fbs +25 -25
  1005. package/src/engine-schemes/vec.fbs +19 -19
  1006. package/src/engine-schemes/vec2.ts +33 -33
  1007. package/src/engine-schemes/vec3.ts +38 -38
  1008. package/src/engine-schemes/vec4.ts +43 -43
  1009. package/src/engine-schemes/vr-user-state-buffer.ts +145 -145
  1010. package/src/engine-schemes/vrUserStateBuffer.fbs +17 -17
  1011. package/src/include/draco/draco_decoder.js +34 -34
  1012. package/src/include/ktx2/basis_transcoder.js +21 -21
  1013. package/src/include/needle/arial-msdf.json +1471 -1471
  1014. package/src/include/three/DragControls.js +231 -231
  1015. package/src/include/three/EXT_mesh_gpu_instancing_exporter.js +66 -66
  1016. package/src/needle-engine.ts +70 -70
  1017. package/lib/engine/engine.d.ts +0 -4
  1018. package/lib/engine/engine.js +0 -12
  1019. package/lib/engine/engine.js.map +0 -1
  1020. package/lib/engine/engine_web_api.d.ts +0 -12
  1021. package/lib/engine/engine_web_api.js +0 -113
  1022. package/lib/engine/engine_web_api.js.map +0 -1
  1023. package/lib/engine-components/FlyControls.d.ts +0 -10
  1024. package/lib/engine-components/FlyControls.js +0 -29
  1025. package/lib/engine-components/FlyControls.js.map +0 -1
  1026. package/src/engine-schemes/dist/api.js +0 -17
  1027. package/src/engine-schemes/dist/api.js.meta +0 -7
  1028. package/src/engine-schemes/dist/schemes.js +0 -25
  1029. package/src/engine-schemes/dist/schemes.js.meta +0 -7
  1030. package/src/engine-schemes/dist/synced-camera-model.js +0 -74
  1031. package/src/engine-schemes/dist/synced-camera-model.js.meta +0 -7
  1032. package/src/engine-schemes/dist/synced-transform-model.js +0 -73
  1033. package/src/engine-schemes/dist/synced-transform-model.js.meta +0 -7
  1034. package/src/engine-schemes/dist/transform.js +0 -46
  1035. package/src/engine-schemes/dist/transform.js.meta +0 -7
  1036. package/src/engine-schemes/dist/vec2.js +0 -32
  1037. package/src/engine-schemes/dist/vec2.js.meta +0 -7
  1038. package/src/engine-schemes/dist/vec3.js +0 -36
  1039. package/src/engine-schemes/dist/vec3.js.meta +0 -7
  1040. package/src/engine-schemes/dist/vec4.js +0 -40
  1041. package/src/engine-schemes/dist/vec4.js.meta +0 -7
  1042. package/src/engine-schemes/dist/vr-user-state-buffer.js +0 -110
  1043. package/src/engine-schemes/dist/vr-user-state-buffer.js.meta +0 -7
@@ -1,379 +1,379 @@
1
- import { BUILD_TIME, GENERATOR, PUBLIC_KEY, VERSION } from "./engine_constants.js";
2
- import { ContextEvent, ContextRegistry } from "./engine_context_registry.js";
3
- import { Context } from "./engine_setup.js";
4
- import type { IContext } from "./engine_types.js";
5
- import { getParam } from "./engine_utils.js";
6
-
7
- const debug = getParam("debuglicense");
8
-
9
- const _licenseCheckResultChangedCallbacks: ((result: boolean) => void)[] = [];
10
-
11
- // This is modified by a bundler (e.g. vite)
12
- // Do not edit manually
13
- let NEEDLE_ENGINE_LICENSE_TYPE: string = "basic";
14
- if (debug)
15
- console.log("License Type: " + NEEDLE_ENGINE_LICENSE_TYPE)
16
-
17
- /** @internal */
18
- export function hasProLicense() {
19
- switch (NEEDLE_ENGINE_LICENSE_TYPE) {
20
- case "pro":
21
- case "enterprise":
22
- return true;
23
- };
24
- return false;
25
- }
26
-
27
- /** @internal */
28
- export function hasIndieLicense() {
29
- switch (NEEDLE_ENGINE_LICENSE_TYPE) {
30
- case "indie":
31
- return true;
32
- }
33
- return false;
34
- }
35
-
36
- /** @internal */
37
- export function hasEduLicense() {
38
- switch (NEEDLE_ENGINE_LICENSE_TYPE) {
39
- case "edu":
40
- return true;
41
- }
42
- return false;
43
- }
44
-
45
- /** @internal */
46
- export function hasCommercialLicense() {
47
- return hasProLicense() || hasIndieLicense() || hasEduLicense();
48
- }
49
-
50
-
51
- /** @internal */
52
- export function onLicenseCheckResultChanged(cb: (result: boolean) => void) {
53
- if (hasProLicense() || hasIndieLicense() || hasEduLicense())
54
- return cb(true);
55
- _licenseCheckResultChangedCallbacks.push(cb);
56
- }
57
-
58
- function invokeLicenseCheckResultChanged(result: boolean) {
59
- for (const cb of _licenseCheckResultChangedCallbacks) {
60
- try {
61
- cb(result);
62
- }
63
- catch {
64
- // ignore
65
- }
66
- }
67
- }
68
-
69
- ContextRegistry.registerCallback(ContextEvent.ContextRegistered, evt => {
70
- showLicenseInfo(evt.context);
71
- sendUsageMessageToAnalyticsBackend();
72
- handleForbidden(evt.context);
73
- });
74
-
75
- export let runtimeLicenseCheckPromise: Promise<void> | undefined = undefined;
76
- let applicationIsForbidden = false;
77
- let applicationForbiddenText = "";
78
- async function checkLicense() {
79
- // Only perform the runtime license check once
80
- if (runtimeLicenseCheckPromise) return runtimeLicenseCheckPromise;
81
- if (NEEDLE_ENGINE_LICENSE_TYPE === "basic") {
82
- try {
83
- const licenseUrl = "https://engine.needle.tools/licensing/check?location=" + encodeURIComponent(window.location.href) + "&version=" + VERSION + "&generator=" + encodeURIComponent(GENERATOR);
84
- const res = await fetch(licenseUrl, {
85
- method: "GET",
86
- }).catch(_err => {
87
- if (debug) console.error("License check failed", _err);
88
- return undefined;
89
- });
90
- if (res?.status === 200) {
91
- applicationIsForbidden = false;
92
- if (debug) console.log("License check succeeded");
93
- NEEDLE_ENGINE_LICENSE_TYPE = "pro";
94
- invokeLicenseCheckResultChanged(true);
95
- }
96
- else if (res?.status === 403) {
97
- invokeLicenseCheckResultChanged(false);
98
- applicationIsForbidden = true;
99
- applicationForbiddenText = await res.text();
100
- }
101
- else {
102
- invokeLicenseCheckResultChanged(false);
103
- if (debug) console.log("License check failed with status " + res?.status);
104
- }
105
- }
106
- catch (err) {
107
- invokeLicenseCheckResultChanged(false);
108
- if (debug) console.error("License check failed", err);
109
- }
110
- }
111
- else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + NEEDLE_ENGINE_LICENSE_TYPE + "\"");
112
- }
113
- runtimeLicenseCheckPromise = checkLicense();
114
-
115
- async function handleForbidden(ctx: IContext) {
116
- function createForbiddenElement() {
117
- const div = document.createElement("div");
118
- div.className = "needle-forbidden";
119
- div.style.cssText = `
120
- position: fixed;
121
- top: 0;
122
- left: 0;
123
- width: 100%;
124
- height: 100%;
125
- pointer-events: all;
126
- zIndex: 2147483647;
127
- line-height: 1.5;
128
- backdrop-filter: blur(15px);
129
- -webkit-backdrop-filter: blur(15px);
130
- `;
131
- const expectedStyle = div.style.cssText;
132
-
133
- const text = document.createElement("div");
134
- div.appendChild(text);
135
- text.style.cssText = `
136
- position: absolute;
137
- left: 0;
138
- right: 0;
139
- top:0;
140
- bottom: 0;
141
- padding: 10%;
142
- color: white;
143
- font-size: 20px;
144
- font-family: sans-serif;
145
- text-align: center;
146
- pointer-events: all;
147
- display: flex;
148
- justify-content: center;
149
- align-items: center;
150
- background-color: rgba(0,0,0,.3);
151
- text-shadow: 0 0 2px black;
152
- `;
153
- const expectedTextStyle = text.style.cssText;
154
- const forbiddenText = applicationForbiddenText?.length > 1 ? applicationForbiddenText : "This web application has been paused.<br/>You might be in violation of the Needle Engine terms of use.<br/>Please contact the Needle support if you think this is a mistake.";
155
- text.innerHTML = forbiddenText;
156
- setInterval(() => {
157
- if (text.innerHTML !== forbiddenText) text.innerHTML = forbiddenText;
158
- if (text.parentNode !== div) div.appendChild(text);
159
- if (div.style.cssText !== expectedStyle) div.style.cssText = expectedStyle;
160
- if (text.style.cssText !== expectedTextStyle) text.style.cssText = expectedTextStyle;
161
- }, 500)
162
- return div;
163
- }
164
- let forbiddenElement = createForbiddenElement();
165
- const expectedCSS = forbiddenElement.style.cssText;
166
- setInterval(() => {
167
- if (applicationIsForbidden === true) {
168
- if (forbiddenElement.style.cssText !== expectedCSS) forbiddenElement = createForbiddenElement();
169
- if (ctx.domElement.shadowRoot) {
170
- if (forbiddenElement.parentNode !== ctx.domElement.shadowRoot)
171
- ctx.domElement.shadowRoot?.appendChild(forbiddenElement);
172
- }
173
- else if (forbiddenElement.parentNode != document.body) {
174
- document.body.appendChild(forbiddenElement);
175
- }
176
- }
177
- }, 500)
178
- }
179
-
180
- async function showLicenseInfo(ctx: IContext) {
181
- try {
182
- if (!hasProLicense() && !hasIndieLicense()) {
183
- return onNonCommercialVersionDetected(ctx);
184
- }
185
- }
186
- catch (err) {
187
- if (debug) console.log("License check failed", err)
188
- return onNonCommercialVersionDetected(ctx)
189
- }
190
- if (debug) onNonCommercialVersionDetected(ctx)
191
- }
192
-
193
-
194
-
195
- async function onNonCommercialVersionDetected(ctx: IContext) {
196
-
197
- // if the engine loads faster than the license check, we need to capture the ready event here
198
- let isReady = false;
199
- ctx.domElement.addEventListener("ready", () => isReady = true);
200
-
201
- await runtimeLicenseCheckPromise?.catch(() => { });
202
-
203
-
204
- if (hasProLicense() || hasIndieLicense()) return;
205
- if (hasCommercialLicense() === false) logNonCommercialUse();
206
-
207
- // check if the engine is already ready (meaning has finished loading)
208
- if (isReady) {
209
- insertNonCommercialUseHint(ctx);
210
- }
211
- else {
212
- ctx.domElement.addEventListener("ready", () => {
213
- insertNonCommercialUseHint(ctx);
214
- });
215
- }
216
- }
217
-
218
- // const licenseElementIdentifier = "needle-license-element";
219
- // const licenseDuration = 10000;
220
- // const licenseDelay = 1200;
221
- function insertNonCommercialUseHint(ctx: IContext) {
222
-
223
- const style = `
224
- position: relative;
225
- display: block;
226
- background-size: 20px;
227
- background-position: 10px 5px;
228
- background-repeat:no-repeat;
229
- background-image:url('${base64Logo}');
230
- background-max-size: 40px;
231
- padding: 10px;
232
- padding-left: 30px;
233
- `;
234
- if (NEEDLE_ENGINE_LICENSE_TYPE === "edu") {
235
- console.log("%c " + "Supported by Needle for Education – https://needle.tools", style);
236
- }
237
- else {
238
- // if the user has a basic license we already show the logo in the menu and log a license message
239
- return;
240
- }
241
-
242
- const banner = document.createElement("div");
243
- banner.className = "needle-non-commercial-use";
244
- banner.innerHTML = "Made with Needle for Education";
245
- ctx.domElement.shadowRoot?.appendChild(banner);
246
- let bannerStyle = `
247
- position: absolute;
248
- font-family: system-ui, Avenir, Helvetica, Arial, sans-serif;
249
- font-size: 12px;
250
- color: rgb(100, 100, 100);
251
- /*mix-blend-mode: difference;*/
252
- background-color: transparent;
253
- z-index: 10000;
254
-
255
- cursor: pointer;
256
- user-select: none;
257
- opacity: 0;
258
-
259
- bottom: 6px;
260
- right: 12px;
261
- transform: translateY(0px);
262
- transition: all .5s ease-in-out 1s;
263
- `;
264
- banner.style.cssText = bannerStyle;
265
- banner.addEventListener("click", () => { window.open("https://needle.tools", "_blank") });
266
- let expectedBannerStyle = banner.style.cssText;
267
- setTimeout(() => {
268
- bannerStyle = bannerStyle.replace("opacity: 0", "opacity: 1");
269
- bannerStyle = bannerStyle.replace("transform: translateY(10px)", "transform: translateY(0)");
270
- banner.style.cssText = bannerStyle;
271
- expectedBannerStyle = banner.style.cssText;
272
- }, 100);
273
-
274
- // ensure the banner is always visible
275
- const interval = setInterval(() => {
276
- const parent = ctx.domElement.shadowRoot || ctx.domElement;
277
- if (banner.parentNode !== parent) {
278
- parent.appendChild(banner);
279
- }
280
- if (expectedBannerStyle != banner.style.cssText) {
281
- banner.style.cssText = bannerStyle;
282
- expectedBannerStyle = banner.style.cssText;
283
- }
284
- }, 1000);
285
-
286
- if (hasEduLicense()) {
287
- const removeDelay = 20_000;
288
- setTimeout(() => {
289
- clearInterval(interval);
290
- banner?.remove();
291
- // show the logo every x minutes
292
- const intervalInMinutes = 5;
293
- setTimeout(() => {
294
- if (ctx.domElement.parentNode)
295
- insertNonCommercialUseHint(ctx);
296
- }, 1000 * 60 * intervalInMinutes)
297
- }, removeDelay);
298
- }
299
-
300
- }
301
-
302
-
303
- const base64Logo = "data:image/webp;base64,UklGRrABAABXRUJQVlA4WAoAAAAQAAAAHwAAHwAAQUxQSKEAAAARN6CmbSM4WR7vdARON11EBDq3fLiNbVtVzpMCPlKAEzsx0Y/x+Ovuv4dn0EFE/ydAvz6YggXzgh5sVgXM/zOC/4sii7qgGvB5N7hmuQYwkvazWAu1JPW41FXSHq6pnaQWvqYH18Fc0j1hO/BFTtIeSBlJi5w6qIIO7IOrwhFsB2Yxukif0FTRLpXswHR8MxbslKe9VZsn/Ub5C7YFOpqSTABWUDgg6AAAAFAGAJ0BKiAAIAA+7VyoTqmkpCI3+qgBMB2JbACdMt69DwMIQBLhkTO6XwY00UEDK6cNIDnuNibPf0EgAP7Y1myuiQHLDsF/0h5unrGh6WAbv7aegg2ZMd3uRKfT/3SJztcaujYfTvMXspfCTmYcoO6a+vhC3ss4M8uM58t4siiu59I4aOl59e9Sr6xoxYlHf2v+NnBNpJYeJf8jABQAId/PXuBkLEFkiCucgSGEcfhvajql/j3reCGl0M5/9gQWy7ayNPs+wlvIxFnNfSlfuND4CZOCyxOHhRqOmHN4ULHo3tCSrUNvgAA=";
304
-
305
- let lastLogTime = 0;
306
- async function logNonCommercialUse(_logo?: string) {
307
- const now = Date.now();
308
- if (now - lastLogTime < 2000) return;
309
- lastLogTime = now;
310
- const style = `
311
- position: relative;
312
- display: block;
313
- font-size: 18px;
314
- background-size: 20px;
315
- background-position: 10px 5px;
316
- background-repeat:no-repeat;
317
- background-image:url('${base64Logo}');
318
- background-max-size: 40px;
319
- margin-bottom: 5px;
320
- margin-top: .3em;
321
- margin-bottom: .5em;
322
- padding: .2em;
323
- padding-left: 25px;
324
- border-radius: .5em;
325
- border: 2px solid rgba(160,160,160,.3);
326
- `;
327
- // url must contain https for firefox to make it clickable
328
- const version = VERSION;
329
- const licenseText = `Needle Engine — No license active, commercial use is not allowed. Visit https://needle.tools/pricing for more information and licensing options! v${version}`;
330
- if (Context.Current?.xr) {
331
- console.log(licenseText);
332
- }
333
- else {
334
- console.log("%c " + licenseText, style);
335
- }
336
- }
337
-
338
-
339
- async function sendUsageMessageToAnalyticsBackend() {
340
- // We can't send beacons from cross-origin isolated pages
341
- if (window.crossOriginIsolated) return;
342
-
343
- try {
344
- const analyticsUrl = "https://needle-engine-analytics-v2-r26roub2hq-lz.a.run.app";
345
- if (analyticsUrl) {
346
- if (debug) console.log("Analytics backend url", analyticsUrl);
347
-
348
- // analyticsUrl = "http://localhost:3000/";
349
-
350
- // current url without query parameters
351
- const currentUrl = window.location.href.split("?")[0];
352
-
353
- let endpoint = "api/v2/new/request";
354
- if (!analyticsUrl.endsWith("/")) endpoint = "/" + endpoint;
355
- const license = NEEDLE_ENGINE_LICENSE_TYPE;
356
- const finalUrl = `${analyticsUrl}${endpoint}`;
357
- if (debug) console.log("Sending non-commercial usage message to analytics backend", finalUrl);
358
-
359
- const beaconData = {
360
- license,
361
- url: currentUrl,
362
- hostname: window.location.hostname,
363
- pathname: window.location.pathname,
364
- // search: window.location.search,
365
- // hash: window.location.hash,
366
- version: VERSION,
367
- generator: GENERATOR,
368
- build_time: BUILD_TIME,
369
- public_key: PUBLIC_KEY,
370
- };
371
- const res = navigator.sendBeacon?.(finalUrl, JSON.stringify(beaconData));
372
- if (debug) console.log("Send beacon result", res);
373
- }
374
- }
375
- catch (err) {
376
- if (debug)
377
- console.log("Failed to send non-commercial usage message to analytics backend", err);
378
- }
1
+ import { BUILD_TIME, GENERATOR, PUBLIC_KEY, VERSION } from "./engine_constants.js";
2
+ import { ContextEvent, ContextRegistry } from "./engine_context_registry.js";
3
+ import { Context } from "./engine_setup.js";
4
+ import type { IContext } from "./engine_types.js";
5
+ import { getParam } from "./engine_utils.js";
6
+
7
+ const debug = getParam("debuglicense");
8
+
9
+ const _licenseCheckResultChangedCallbacks: ((result: boolean) => void)[] = [];
10
+
11
+ // This is modified by a bundler (e.g. vite)
12
+ // Do not edit manually
13
+ let NEEDLE_ENGINE_LICENSE_TYPE: string = "basic";
14
+ if (debug)
15
+ console.log("License Type: " + NEEDLE_ENGINE_LICENSE_TYPE)
16
+
17
+ /** @internal */
18
+ export function hasProLicense() {
19
+ switch (NEEDLE_ENGINE_LICENSE_TYPE) {
20
+ case "pro":
21
+ case "enterprise":
22
+ return true;
23
+ };
24
+ return false;
25
+ }
26
+
27
+ /** @internal */
28
+ export function hasIndieLicense() {
29
+ switch (NEEDLE_ENGINE_LICENSE_TYPE) {
30
+ case "indie":
31
+ return true;
32
+ }
33
+ return false;
34
+ }
35
+
36
+ /** @internal */
37
+ export function hasEduLicense() {
38
+ switch (NEEDLE_ENGINE_LICENSE_TYPE) {
39
+ case "edu":
40
+ return true;
41
+ }
42
+ return false;
43
+ }
44
+
45
+ /** @internal */
46
+ export function hasCommercialLicense() {
47
+ return hasProLicense() || hasIndieLicense() || hasEduLicense();
48
+ }
49
+
50
+
51
+ /** @internal */
52
+ export function onLicenseCheckResultChanged(cb: (result: boolean) => void) {
53
+ if (hasProLicense() || hasIndieLicense() || hasEduLicense())
54
+ return cb(true);
55
+ _licenseCheckResultChangedCallbacks.push(cb);
56
+ }
57
+
58
+ function invokeLicenseCheckResultChanged(result: boolean) {
59
+ for (const cb of _licenseCheckResultChangedCallbacks) {
60
+ try {
61
+ cb(result);
62
+ }
63
+ catch {
64
+ // ignore
65
+ }
66
+ }
67
+ }
68
+
69
+ ContextRegistry.registerCallback(ContextEvent.ContextRegistered, evt => {
70
+ showLicenseInfo(evt.context);
71
+ sendUsageMessageToAnalyticsBackend();
72
+ handleForbidden(evt.context);
73
+ });
74
+
75
+ export let runtimeLicenseCheckPromise: Promise<void> | undefined = undefined;
76
+ let applicationIsForbidden = false;
77
+ let applicationForbiddenText = "";
78
+ async function checkLicense() {
79
+ // Only perform the runtime license check once
80
+ if (runtimeLicenseCheckPromise) return runtimeLicenseCheckPromise;
81
+ if (NEEDLE_ENGINE_LICENSE_TYPE === "basic") {
82
+ try {
83
+ const licenseUrl = "https://engine.needle.tools/licensing/check?location=" + encodeURIComponent(window.location.href) + "&version=" + VERSION + "&generator=" + encodeURIComponent(GENERATOR);
84
+ const res = await fetch(licenseUrl, {
85
+ method: "GET",
86
+ }).catch(_err => {
87
+ if (debug) console.error("License check failed", _err);
88
+ return undefined;
89
+ });
90
+ if (res?.status === 200) {
91
+ applicationIsForbidden = false;
92
+ if (debug) console.log("License check succeeded");
93
+ NEEDLE_ENGINE_LICENSE_TYPE = "pro";
94
+ invokeLicenseCheckResultChanged(true);
95
+ }
96
+ else if (res?.status === 403) {
97
+ invokeLicenseCheckResultChanged(false);
98
+ applicationIsForbidden = true;
99
+ applicationForbiddenText = await res.text();
100
+ }
101
+ else {
102
+ invokeLicenseCheckResultChanged(false);
103
+ if (debug) console.log("License check failed with status " + res?.status);
104
+ }
105
+ }
106
+ catch (err) {
107
+ invokeLicenseCheckResultChanged(false);
108
+ if (debug) console.error("License check failed", err);
109
+ }
110
+ }
111
+ else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + NEEDLE_ENGINE_LICENSE_TYPE + "\"");
112
+ }
113
+ runtimeLicenseCheckPromise = checkLicense();
114
+
115
+ async function handleForbidden(ctx: IContext) {
116
+ function createForbiddenElement() {
117
+ const div = document.createElement("div");
118
+ div.className = "needle-forbidden";
119
+ div.style.cssText = `
120
+ position: fixed;
121
+ top: 0;
122
+ left: 0;
123
+ width: 100%;
124
+ height: 100%;
125
+ pointer-events: all;
126
+ zIndex: 2147483647;
127
+ line-height: 1.5;
128
+ backdrop-filter: blur(15px);
129
+ -webkit-backdrop-filter: blur(15px);
130
+ `;
131
+ const expectedStyle = div.style.cssText;
132
+
133
+ const text = document.createElement("div");
134
+ div.appendChild(text);
135
+ text.style.cssText = `
136
+ position: absolute;
137
+ left: 0;
138
+ right: 0;
139
+ top:0;
140
+ bottom: 0;
141
+ padding: 10%;
142
+ color: white;
143
+ font-size: 20px;
144
+ font-family: sans-serif;
145
+ text-align: center;
146
+ pointer-events: all;
147
+ display: flex;
148
+ justify-content: center;
149
+ align-items: center;
150
+ background-color: rgba(0,0,0,.3);
151
+ text-shadow: 0 0 2px black;
152
+ `;
153
+ const expectedTextStyle = text.style.cssText;
154
+ const forbiddenText = applicationForbiddenText?.length > 1 ? applicationForbiddenText : "This web application has been paused.<br/>You might be in violation of the Needle Engine terms of use.<br/>Please contact the Needle support if you think this is a mistake.";
155
+ text.innerHTML = forbiddenText;
156
+ setInterval(() => {
157
+ if (text.innerHTML !== forbiddenText) text.innerHTML = forbiddenText;
158
+ if (text.parentNode !== div) div.appendChild(text);
159
+ if (div.style.cssText !== expectedStyle) div.style.cssText = expectedStyle;
160
+ if (text.style.cssText !== expectedTextStyle) text.style.cssText = expectedTextStyle;
161
+ }, 500)
162
+ return div;
163
+ }
164
+ let forbiddenElement = createForbiddenElement();
165
+ const expectedCSS = forbiddenElement.style.cssText;
166
+ setInterval(() => {
167
+ if (applicationIsForbidden === true) {
168
+ if (forbiddenElement.style.cssText !== expectedCSS) forbiddenElement = createForbiddenElement();
169
+ if (ctx.domElement.shadowRoot) {
170
+ if (forbiddenElement.parentNode !== ctx.domElement.shadowRoot)
171
+ ctx.domElement.shadowRoot?.appendChild(forbiddenElement);
172
+ }
173
+ else if (forbiddenElement.parentNode != document.body) {
174
+ document.body.appendChild(forbiddenElement);
175
+ }
176
+ }
177
+ }, 500)
178
+ }
179
+
180
+ async function showLicenseInfo(ctx: IContext) {
181
+ try {
182
+ if (!hasProLicense() && !hasIndieLicense()) {
183
+ return onNonCommercialVersionDetected(ctx);
184
+ }
185
+ }
186
+ catch (err) {
187
+ if (debug) console.log("License check failed", err)
188
+ return onNonCommercialVersionDetected(ctx)
189
+ }
190
+ if (debug) onNonCommercialVersionDetected(ctx)
191
+ }
192
+
193
+
194
+
195
+ async function onNonCommercialVersionDetected(ctx: IContext) {
196
+
197
+ // if the engine loads faster than the license check, we need to capture the ready event here
198
+ let isReady = false;
199
+ ctx.domElement.addEventListener("ready", () => isReady = true);
200
+
201
+ await runtimeLicenseCheckPromise?.catch(() => { });
202
+
203
+
204
+ if (hasProLicense() || hasIndieLicense()) return;
205
+ if (hasCommercialLicense() === false) logNonCommercialUse();
206
+
207
+ // check if the engine is already ready (meaning has finished loading)
208
+ if (isReady) {
209
+ insertNonCommercialUseHint(ctx);
210
+ }
211
+ else {
212
+ ctx.domElement.addEventListener("ready", () => {
213
+ insertNonCommercialUseHint(ctx);
214
+ });
215
+ }
216
+ }
217
+
218
+ // const licenseElementIdentifier = "needle-license-element";
219
+ // const licenseDuration = 10000;
220
+ // const licenseDelay = 1200;
221
+ function insertNonCommercialUseHint(ctx: IContext) {
222
+
223
+ const style = `
224
+ position: relative;
225
+ display: block;
226
+ background-size: 20px;
227
+ background-position: 10px 5px;
228
+ background-repeat:no-repeat;
229
+ background-image:url('${base64Logo}');
230
+ background-max-size: 40px;
231
+ padding: 10px;
232
+ padding-left: 30px;
233
+ `;
234
+ if (NEEDLE_ENGINE_LICENSE_TYPE === "edu") {
235
+ console.log("%c " + "Supported by Needle for Education – https://needle.tools", style);
236
+ }
237
+ else {
238
+ // if the user has a basic license we already show the logo in the menu and log a license message
239
+ return;
240
+ }
241
+
242
+ const banner = document.createElement("div");
243
+ banner.className = "needle-non-commercial-use";
244
+ banner.innerHTML = "Made with Needle for Education";
245
+ ctx.domElement.shadowRoot?.appendChild(banner);
246
+ let bannerStyle = `
247
+ position: absolute;
248
+ font-family: system-ui, Avenir, Helvetica, Arial, sans-serif;
249
+ font-size: 12px;
250
+ color: rgb(100, 100, 100);
251
+ /*mix-blend-mode: difference;*/
252
+ background-color: transparent;
253
+ z-index: 10000;
254
+
255
+ cursor: pointer;
256
+ user-select: none;
257
+ opacity: 0;
258
+
259
+ bottom: 6px;
260
+ right: 12px;
261
+ transform: translateY(0px);
262
+ transition: all .5s ease-in-out 1s;
263
+ `;
264
+ banner.style.cssText = bannerStyle;
265
+ banner.addEventListener("click", () => { window.open("https://needle.tools", "_blank") });
266
+ let expectedBannerStyle = banner.style.cssText;
267
+ setTimeout(() => {
268
+ bannerStyle = bannerStyle.replace("opacity: 0", "opacity: 1");
269
+ bannerStyle = bannerStyle.replace("transform: translateY(10px)", "transform: translateY(0)");
270
+ banner.style.cssText = bannerStyle;
271
+ expectedBannerStyle = banner.style.cssText;
272
+ }, 100);
273
+
274
+ // ensure the banner is always visible
275
+ const interval = setInterval(() => {
276
+ const parent = ctx.domElement.shadowRoot || ctx.domElement;
277
+ if (banner.parentNode !== parent) {
278
+ parent.appendChild(banner);
279
+ }
280
+ if (expectedBannerStyle != banner.style.cssText) {
281
+ banner.style.cssText = bannerStyle;
282
+ expectedBannerStyle = banner.style.cssText;
283
+ }
284
+ }, 1000);
285
+
286
+ if (hasEduLicense()) {
287
+ const removeDelay = 20_000;
288
+ setTimeout(() => {
289
+ clearInterval(interval);
290
+ banner?.remove();
291
+ // show the logo every x minutes
292
+ const intervalInMinutes = 5;
293
+ setTimeout(() => {
294
+ if (ctx.domElement.parentNode)
295
+ insertNonCommercialUseHint(ctx);
296
+ }, 1000 * 60 * intervalInMinutes)
297
+ }, removeDelay);
298
+ }
299
+
300
+ }
301
+
302
+
303
+ const base64Logo = "data:image/webp;base64,UklGRrABAABXRUJQVlA4WAoAAAAQAAAAHwAAHwAAQUxQSKEAAAARN6CmbSM4WR7vdARON11EBDq3fLiNbVtVzpMCPlKAEzsx0Y/x+Ovuv4dn0EFE/ydAvz6YggXzgh5sVgXM/zOC/4sii7qgGvB5N7hmuQYwkvazWAu1JPW41FXSHq6pnaQWvqYH18Fc0j1hO/BFTtIeSBlJi5w6qIIO7IOrwhFsB2Yxukif0FTRLpXswHR8MxbslKe9VZsn/Ub5C7YFOpqSTABWUDgg6AAAAFAGAJ0BKiAAIAA+7VyoTqmkpCI3+qgBMB2JbACdMt69DwMIQBLhkTO6XwY00UEDK6cNIDnuNibPf0EgAP7Y1myuiQHLDsF/0h5unrGh6WAbv7aegg2ZMd3uRKfT/3SJztcaujYfTvMXspfCTmYcoO6a+vhC3ss4M8uM58t4siiu59I4aOl59e9Sr6xoxYlHf2v+NnBNpJYeJf8jABQAId/PXuBkLEFkiCucgSGEcfhvajql/j3reCGl0M5/9gQWy7ayNPs+wlvIxFnNfSlfuND4CZOCyxOHhRqOmHN4ULHo3tCSrUNvgAA=";
304
+
305
+ let lastLogTime = 0;
306
+ async function logNonCommercialUse(_logo?: string) {
307
+ const now = Date.now();
308
+ if (now - lastLogTime < 2000) return;
309
+ lastLogTime = now;
310
+ const style = `
311
+ position: relative;
312
+ display: block;
313
+ font-size: 18px;
314
+ background-size: 20px;
315
+ background-position: 10px 5px;
316
+ background-repeat:no-repeat;
317
+ background-image:url('${base64Logo}');
318
+ background-max-size: 40px;
319
+ margin-bottom: 5px;
320
+ margin-top: .3em;
321
+ margin-bottom: .5em;
322
+ padding: .2em;
323
+ padding-left: 25px;
324
+ border-radius: .5em;
325
+ border: 2px solid rgba(160,160,160,.3);
326
+ `;
327
+ // url must contain https for firefox to make it clickable
328
+ const version = VERSION;
329
+ const licenseText = `Needle Engine — No license active, commercial use is not allowed. Visit https://needle.tools/pricing for more information and licensing options! v${version}`;
330
+ if (Context.Current?.xr) {
331
+ console.log(licenseText);
332
+ }
333
+ else {
334
+ console.log("%c " + licenseText, style);
335
+ }
336
+ }
337
+
338
+
339
+ async function sendUsageMessageToAnalyticsBackend() {
340
+ // We can't send beacons from cross-origin isolated pages
341
+ if (window.crossOriginIsolated) return;
342
+
343
+ try {
344
+ const analyticsUrl = "https://needle-engine-analytics-v2-r26roub2hq-lz.a.run.app";
345
+ if (analyticsUrl) {
346
+ if (debug) console.log("Analytics backend url", analyticsUrl);
347
+
348
+ // analyticsUrl = "http://localhost:3000/";
349
+
350
+ // current url without query parameters
351
+ const currentUrl = window.location.href.split("?")[0];
352
+
353
+ let endpoint = "api/v2/new/request";
354
+ if (!analyticsUrl.endsWith("/")) endpoint = "/" + endpoint;
355
+ const license = NEEDLE_ENGINE_LICENSE_TYPE;
356
+ const finalUrl = `${analyticsUrl}${endpoint}`;
357
+ if (debug) console.log("Sending non-commercial usage message to analytics backend", finalUrl);
358
+
359
+ const beaconData = {
360
+ license,
361
+ url: currentUrl,
362
+ hostname: window.location.hostname,
363
+ pathname: window.location.pathname,
364
+ // search: window.location.search,
365
+ // hash: window.location.hash,
366
+ version: VERSION,
367
+ generator: GENERATOR,
368
+ build_time: BUILD_TIME,
369
+ public_key: PUBLIC_KEY,
370
+ };
371
+ const res = navigator.sendBeacon?.(finalUrl, JSON.stringify(beaconData));
372
+ if (debug) console.log("Send beacon result", res);
373
+ }
374
+ }
375
+ catch (err) {
376
+ if (debug)
377
+ console.log("Failed to send non-commercial usage message to analytics backend", err);
378
+ }
379
379
  }