@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,366 +1,406 @@
1
- import { spawn } from "child_process";
2
- import { NEEDLE_CLOUD_CLI_NAME } from "./cloud.js";
3
- import { existsSync } from "fs";
4
-
5
- const port = 8424;
6
- const licenseServerUrl = `http://localhost:${port}/api/license`;
7
- const projectIdentifierUrl = `http://localhost:${port}/api/public_key`;
8
- const needleCloudApiEndpoint = "https://cloud.needle.tools/api";
9
-
10
- /**
11
- * Replace license string - used for webpack
12
- * @param {string} code
13
- * @param {{team:string|undefined}} opts
14
- */
15
- export async function replaceLicense(code, opts) {
16
- const index = code?.indexOf("NEEDLE_ENGINE_LICENSE_TYPE");
17
- if (index >= 0) {
18
- const licenseType = await resolveLicense(opts);
19
- if (!licenseType) {
20
- return code;
21
- }
22
- const end = code.indexOf(";", index);
23
- if (end >= 0) {
24
- const line = code.substring(index, end);
25
- const replaced = "NEEDLE_ENGINE_LICENSE_TYPE = \"" + licenseType + "\"";
26
- code = code.replace(line, replaced);
27
- return code;
28
- }
29
- }
30
- return code;
31
- }
32
-
33
- /**
34
- * Resolve the license using the needle engine licensing server
35
- * @param {{accessToken?:string, team?:string} | null} args
36
- * @returns {Promise<string | null>}
37
- */
38
- export async function resolveLicense(args = null) {
39
- let accessToken = args?.accessToken;
40
-
41
- if (!accessToken && process.env.CI) {
42
- if (process.env.NEEDLE_CLOUD_TOKEN) {
43
- console.log("[needle-license] INFO: Using Needle Cloud access token from environment variable");
44
- accessToken = process.env.NEEDLE_CLOUD_TOKEN;
45
- }
46
- else {
47
- console.warn("[needle-license] WARN: Missing NEEDLE_CLOUD_TOKEN for CI environment run");
48
- }
49
- }
50
-
51
- if (accessToken) {
52
- const timeout = AbortSignal.timeout(10_000);
53
- const url = new URL(`${needleCloudApiEndpoint}/v1/account/get/licenses`);
54
- const res = await fetch(url, {
55
- method: "GET",
56
- signal: timeout,
57
- headers: {
58
- Authorization: `Bearer ${accessToken}`,
59
- "x-needle": "cli"
60
- }
61
- }).catch(err => {
62
- return { ok: false, error: err.message };
63
- });
64
- if ("error" in res) {
65
- console.error(`[needle-license] Could not fetch license from Needle Cloud API (${res.error})`);
66
- return null;
67
- }
68
- if (res.ok) {
69
- const text = await res.text();
70
- return tryParseLicense(text);
71
- }
72
- else {
73
- console.error(`[needle-license] Could not fetch license from Needle Cloud API (${res.status})`);
74
- if (process.env.CI) {
75
- return null;
76
- }
77
- }
78
- }
79
- else if (process.env.CI) {
80
- const isGithubCI = process.env.GITHUB_ACTIONS;
81
- let message = "[needle-license] WARN: Missing NEEDLE_CLOUD_TOKEN for CI environment run.";
82
- if (isGithubCI) {
83
- const repositoryUrl = process.env.GITHUB_REPOSITORY;
84
- const url = `${repositoryUrl}/settings/secrets/actions`;
85
- message += `\nPlease add the token to your GitHub repository secrets: ${url}`;
86
- }
87
- console.warn(message);
88
- return null;
89
- }
90
- else if (isStackblitz()) {
91
- console.error("[needle-license] License server is not available in Stackblitz. Please use an access token for authorization.");
92
- return null;
93
- }
94
-
95
- // Fallback to use CLI
96
- // Wait for the server to start
97
- await waitForLicenseServer();
98
-
99
- const url = new URL(licenseServerUrl);
100
- if (args?.team)
101
- url.searchParams.append("org", args.team);
102
- if (accessToken) {
103
- url.searchParams.append("token", accessToken);
104
- }
105
-
106
- console.log(`[needle-license] INFO: Fetching license...`);
107
- const timeout = AbortSignal.timeout(10_000);
108
- const licenseResponse = await fetch(url.toString(), {
109
- method: "GET",
110
- signal: timeout
111
- }).catch(err => {
112
- if (err.cause?.code === "ECONNREFUSED") {
113
- return { error: "[needle-license] ERR: Failed to connect to license server (ECONNREFUSED)" };
114
- }
115
- else {
116
- return { error: "[needle-license] ERR: Failed to fetch license." };
117
- }
118
- });
119
-
120
- if (!licenseResponse) {
121
- console.warn("[needle-license] WARN: Failed to fetch license");
122
- return null;
123
- }
124
- else if ("error" in licenseResponse) {
125
- console.error(licenseResponse.error);
126
- return null;
127
- }
128
- else if (!licenseResponse.ok) {
129
- if (licenseResponse.status === 500)
130
- console.error(`[needle-license] ERROR: Failed to fetch license (${licenseResponse.status})`);
131
- else
132
- console.log(`[needle-license] No license found (${licenseResponse.status})`);
133
- return null;
134
- }
135
-
136
- const text = await licenseResponse.text();
137
- return tryParseLicense(text);
138
- }
139
-
140
-
141
- /**
142
- * @param {string} str License string
143
- */
144
- function tryParseLicense(str) {
145
- try {
146
- /** @type {{needle_engine_license:string}} */
147
- const licenseJson = JSON.parse(str);
148
- if (licenseJson.needle_engine_license) {
149
- console.log(`[needle-license] INFO: Successfully received \"${licenseJson.needle_engine_license?.toUpperCase()}\" license`)
150
- return licenseJson.needle_engine_license;
151
- }
152
- if ("error" in licenseJson) {
153
- console.error(`[needle-license] ERROR in license check: \"${licenseJson.error}\"`);
154
- }
155
- else if (licenseJson.needle_engine_license == null) {
156
- return null;
157
- }
158
- else {
159
- console.warn("[needle-license] WARN: Received invalid license.", licenseJson);
160
- }
161
- return null;
162
- }
163
- catch (err) {
164
- console.error("[needle-license] ERROR: Failed to parse license response");
165
- return null;
166
- }
167
- }
168
-
169
-
170
- /**
171
- * @param {string | undefined} project_id
172
- */
173
- export async function getPublicIdentifier(project_id) {
174
-
175
- let accessToken = undefined;
176
- if (process.env.CI) {
177
- if (process.env.NEEDLE_CLOUD_TOKEN) {
178
- console.log("[needle-identifier] INFO: Using Needle Cloud access token from environment variable");
179
- accessToken = process.env.NEEDLE_CLOUD_TOKEN;
180
- }
181
-
182
- const url = new URL(`${needleCloudApiEndpoint}/v1/account/public_key`);
183
- const body = {
184
- project_id: project_id || process.env.GITHUB_REPOSITORY || undefined,
185
- machine_id: process.env.GITHUB_REPOSITORY_ID || "unknown",
186
- }
187
- const timeout = AbortSignal.timeout(10_000);
188
- const res = await fetch(url, {
189
- method: "POST",
190
- signal: timeout,
191
- headers: {
192
- Authorization: `Bearer ${accessToken}`,
193
- "Content-Type": "application/json",
194
- "x-needle": "cli"
195
- },
196
- body: JSON.stringify(body),
197
- }).catch(err => {
198
- return { ok: false, error: err.message };
199
- });
200
- if ("error" in res) {
201
- console.error(`[needle-identifier] Could not fetch project identifier from Needle Cloud API (${res.error})`);
202
- return null;
203
- }
204
- if (res.ok) {
205
- const text = await res.text();
206
- try {
207
- /** @type {{public_key:string}} */
208
- const json = JSON.parse(text);
209
- console.log(`[needle-identifier] INFO: Successfully received public project identifier`);
210
- return json.public_key;
211
- }
212
- catch (err) {
213
- console.error("[needle-identifier] ERROR: Failed to parse project identifier response");
214
- return null;
215
- }
216
- }
217
- else {
218
- const message = await res.text();
219
- console.error(`[needle-identifier] Could not fetch project identifier from Needle Cloud API (${res.status}, ${res.statusText}, ${message})`);
220
- return null;
221
- }
222
- }
223
- else if (isStackblitz()) {
224
- console.error("[needle-license] License server is not available in Stackblitz. Please use an access token for authorization.");
225
- return null;
226
- }
227
-
228
-
229
-
230
- // Wait for the server to start
231
- await waitForLicenseServer();
232
-
233
- console.log(`[needle-identifier] INFO: Fetching project identifier...`);
234
- const url = new URL(projectIdentifierUrl);
235
- if (project_id) url.searchParams.append("project_id", project_id);
236
- const timeout = AbortSignal.timeout(10_000);
237
- const res = await fetch(projectIdentifierUrl, {
238
- method: "GET",
239
- signal: timeout
240
- }).catch(err => {
241
- if (err.cause?.code === "ECONNREFUSED") {
242
- return { error: "[needle-identifier] Could not connect to the license server: The connection was actively refused" };
243
- }
244
- else {
245
- return { error: "[needle-identifier] ERR: Failed to fetch project identifier." };
246
- }
247
- })
248
-
249
- if (!res) {
250
- console.warn("[needle-identifier] WARN: Failed to fetch project identifier");
251
- return null;
252
- }
253
- else if ("error" in res) {
254
- console.error(res.error);
255
- return null;
256
- }
257
- else if (!res.ok) {
258
- console.error("[needle-identifier] ERROR: Failed to fetch project identifier");
259
- return null;
260
- }
261
- const text = await res.text();
262
-
263
- try {
264
- /** @type {{public_key:string}} */
265
- const json = JSON.parse(text);
266
- return json.public_key;
267
- }
268
- catch (err) {
269
- // TODO: report error to backend
270
- return null;
271
- }
272
- };
273
-
274
-
275
-
276
- // If we run the build command without an editor and the license server is just being started
277
- // we need to to wait for the root URL to return a response
278
- async function waitForLicenseServer() {
279
- // Make sure the licensing server is running
280
- const startcmd = runCommand("npx", ["--yes", NEEDLE_CLOUD_CLI_NAME, "start-server"]);
281
- let isRunning = true;
282
- startcmd.then(() => isRunning = false);
283
-
284
- let attempts = 0;
285
- const maxAttempts = 10;
286
- do {
287
- const timeout = AbortSignal.timeout(1_000);
288
- const response = await fetch(licenseServerUrl, {
289
- method: "GET",
290
- signal: timeout
291
- }).catch(err => {
292
- if (err.cause?.code === "ECONNREFUSED") {
293
- if (!isRunning) {
294
- console.error("[needle-license] ERR: Failed to connect to license server (ECONNREFUSED)");
295
- }
296
- else {
297
- // Waiting for server to start
298
- // EConnectRefuse happen if starting the license server for the first time
299
- }
300
- }
301
- else {
302
- if (attempts === maxAttempts) {
303
- console.error("[needle-license] ERR: Failed to start license server...", err.message);
304
- }
305
- }
306
- });
307
- if (response) {
308
- return true;
309
- }
310
- if (attempts === 0) {
311
- console.log("[needle-license] INFO: Waiting for license server to start...");
312
- }
313
- attempts++;
314
- if (attempts <= maxAttempts) {
315
- await new Promise(res => setTimeout(res, 1000));
316
- }
317
- } while (attempts < maxAttempts);
318
-
319
- return false;
320
- }
321
-
322
-
323
- function isStackblitz() {
324
- return existsSync("/home/.stackblitz")
325
- }
326
-
327
- /**
328
- * @param {string} processName
329
- * @param {string[]} args
330
- */
331
- async function runCommand(processName, args) {
332
- const process = spawn(processName, [...args], { shell: true, timeout: 30_000 });
333
- return new Promise((resolve, reject) => {
334
- process.on('close', (code) => {
335
- if (code === 0) {
336
- resolve(true);
337
- } else {
338
- console.warn(`[needle-license] WARN: \"${processName}\" process exited with code ${code}\nProcess Arguments: ${args.join(" ")}`);
339
- resolve(false);
340
- }
341
- });
342
- process.on('error', (err) => {
343
- resolve(err);
344
- });
345
- });
346
- }
347
-
348
-
349
-
350
- // NODE 16 doesn't support fetch yet
351
- // function fetch(url, options) {
352
- // const module = url.startsWith("https") ? https : http;
353
- // return new Promise((resolve, reject) => {
354
- // module.get(url, options, (res) => {
355
- // let data = '';
356
- // res.on('data', (chunk) => {
357
- // data += chunk;
358
- // });
359
- // res.on('end', () => {
360
- // resolve(data);
361
- // });
362
- // }).on("error", (err) => {
363
- // reject(err);
364
- // });
365
- // });
1
+ import { spawn } from "child_process";
2
+ import { NEEDLE_CLOUD_CLI_NAME } from "./cloud.js";
3
+ import { existsSync } from "fs";
4
+
5
+ const port = 8424;
6
+ const localServerUrl = `http://localhost:${port}`;
7
+ const licenseServerUrl = `http://localhost:${port}/api/license`;
8
+ const projectIdentifierUrl = `http://localhost:${port}/api/public_key`;
9
+ const needleCloudApiEndpoint = "https://cloud.needle.tools/api";
10
+
11
+ /**
12
+ * @typedef {{loglevel?:"verbose"}} DefaultOptions
13
+ */
14
+
15
+ /**
16
+ * Replace license string - used for webpack
17
+ * @param {string} code
18
+ * @param {DefaultOptions & {accessToken?:string, team:string|undefined}} opts
19
+ */
20
+ export async function replaceLicense(code, opts) {
21
+ const index = code?.indexOf("NEEDLE_ENGINE_LICENSE_TYPE");
22
+ if (index >= 0) {
23
+ const licenseType = await resolveLicense(opts);
24
+ if (!licenseType) {
25
+ return code;
26
+ }
27
+ const end = code.indexOf(";", index);
28
+ if (end >= 0) {
29
+ const line = code.substring(index, end);
30
+ const replaced = "NEEDLE_ENGINE_LICENSE_TYPE = \"" + licenseType + "\"";
31
+ code = code.replace(line, replaced);
32
+ return code;
33
+ }
34
+ }
35
+ return code;
36
+ }
37
+
38
+ /**
39
+ * Resolve the license using the needle engine licensing server
40
+ * @param {DefaultOptions & {accessToken?:string, team?:string} | null} args
41
+ * @returns {Promise<string | null>}
42
+ */
43
+ export async function resolveLicense(args = null) {
44
+ let accessToken = args?.accessToken;
45
+
46
+ if (!accessToken && process.env.CI) {
47
+ if (process.env.NEEDLE_CLOUD_TOKEN) {
48
+ console.log("[needle-license] INFO: Using Needle Cloud access token from environment variable");
49
+ accessToken = process.env.NEEDLE_CLOUD_TOKEN;
50
+ }
51
+ else {
52
+ console.warn("[needle-license] WARN: Missing NEEDLE_CLOUD_TOKEN for CI environment run");
53
+ }
54
+ }
55
+
56
+ if (accessToken) {
57
+ const timeout = AbortSignal.timeout(10_000);
58
+ const url = new URL(`${needleCloudApiEndpoint}/v1/account/get/licenses`);
59
+ const res = await fetch(url, {
60
+ method: "GET",
61
+ signal: timeout,
62
+ headers: {
63
+ Authorization: `Bearer ${accessToken}`,
64
+ "x-needle": "cli"
65
+ }
66
+ }).catch(err => {
67
+ return { ok: false, error: err.message };
68
+ });
69
+ if ("error" in res) {
70
+ console.error(`[needle-license] Could not fetch license from Needle Cloud API (${res.error})`);
71
+ return null;
72
+ }
73
+ if (res.ok) {
74
+ const text = await res.text();
75
+ return tryParseLicense(text);
76
+ }
77
+ else {
78
+ console.error(`[needle-license] Could not fetch license from Needle Cloud API (${res.status})`);
79
+ if (process.env.CI) {
80
+ return null;
81
+ }
82
+ }
83
+ }
84
+ else if (process.env.CI) {
85
+ const isGithubCI = process.env.GITHUB_ACTIONS;
86
+ let message = "[needle-license] WARN: Missing NEEDLE_CLOUD_TOKEN for CI environment run.";
87
+ if (isGithubCI) {
88
+ const repositoryUrl = process.env.GITHUB_REPOSITORY;
89
+ const url = `${repositoryUrl}/settings/secrets/actions`;
90
+ message += `\nPlease add the token to your GitHub repository secrets: ${url}`;
91
+ }
92
+ console.warn(message);
93
+ return null;
94
+ }
95
+ else if (isStackblitz()) {
96
+ console.error("[needle-license] License server is not available in Stackblitz. Please use an access token for authorization.");
97
+ return null;
98
+ }
99
+
100
+ // Fallback to use CLI
101
+ // Wait for the server to start
102
+ if (!await waitForLicenseServer(args || undefined)) {
103
+ console.error("[needle-license] ERR: Failed to start license server...");
104
+ return null;
105
+ }
106
+
107
+ const url = new URL(licenseServerUrl);
108
+ if (args?.team)
109
+ url.searchParams.append("org", args.team);
110
+ if (accessToken) {
111
+ url.searchParams.append("token", accessToken);
112
+ }
113
+
114
+ console.log(`[needle-license] INFO: Fetching license...`);
115
+ const timeout = AbortSignal.timeout(10_000);
116
+ const licenseResponse = await fetch(url.toString(), {
117
+ method: "GET",
118
+ signal: timeout
119
+ }).catch(err => {
120
+ if (args?.loglevel === "verbose") console.error("Error fetching license", err.message);
121
+
122
+ if (err.cause?.code === "ECONNREFUSED") {
123
+ return { error: "[needle-license] ERR: Failed to connect to license server (ECONNREFUSED)" };
124
+ }
125
+ else {
126
+ return { error: "[needle-license] ERR: Failed to fetch license." };
127
+ }
128
+ });
129
+
130
+ if (!licenseResponse) {
131
+ console.warn("[needle-license] WARN: Failed to fetch license");
132
+ return null;
133
+ }
134
+ else if ("error" in licenseResponse) {
135
+ console.error(licenseResponse.error);
136
+ return null;
137
+ }
138
+ else if (!licenseResponse.ok) {
139
+ if (licenseResponse.status === 500)
140
+ console.error(`[needle-license] ERROR: Failed to fetch license (${licenseResponse.status})`);
141
+ else
142
+ console.log(`[needle-license] No license found (${licenseResponse.status})`);
143
+ return null;
144
+ }
145
+
146
+ const text = await licenseResponse.text();
147
+ return tryParseLicense(text);
148
+ }
149
+
150
+
151
+ /**
152
+ * @param {string} str License string
153
+ */
154
+ function tryParseLicense(str) {
155
+ try {
156
+ /** @type {{needle_engine_license:string}} */
157
+ const licenseJson = JSON.parse(str);
158
+ if (licenseJson.needle_engine_license) {
159
+ console.log(`[needle-license] INFO: Successfully received \"${licenseJson.needle_engine_license?.toUpperCase()}\" license`)
160
+ return licenseJson.needle_engine_license;
161
+ }
162
+ if ("error" in licenseJson) {
163
+ console.error(`[needle-license] ERROR in license check: \"${licenseJson.error}\"`);
164
+ }
165
+ else if (licenseJson.needle_engine_license == null) {
166
+ return null;
167
+ }
168
+ else {
169
+ console.warn("[needle-license] WARN: Received invalid license.", licenseJson);
170
+ }
171
+ return null;
172
+ }
173
+ catch (err) {
174
+ console.error("[needle-license] ERROR: Failed to parse license response");
175
+ return null;
176
+ }
177
+ }
178
+
179
+
180
+ /**
181
+ * @param {string | undefined} project_id
182
+ * @param {DefaultOptions | undefined} opts
183
+ */
184
+ export async function getPublicIdentifier(project_id, opts = undefined) {
185
+
186
+ let accessToken = undefined;
187
+ if (process.env.CI) {
188
+
189
+ if (opts?.loglevel === "verbose") console.debug("[needle-identifier] INFO: Running in CI environment");
190
+
191
+ if (process.env.NEEDLE_CLOUD_TOKEN) {
192
+ console.log("[needle-identifier] INFO: Using Needle Cloud access token from environment variable");
193
+ accessToken = process.env.NEEDLE_CLOUD_TOKEN;
194
+ }
195
+
196
+ const url = new URL(`${needleCloudApiEndpoint}/v1/account/public_key`);
197
+ const body = {
198
+ project_id: project_id || process.env.GITHUB_REPOSITORY || undefined,
199
+ machine_id: process.env.GITHUB_REPOSITORY_ID || "unknown",
200
+ }
201
+ const timeout = AbortSignal.timeout(10_000);
202
+ const res = await fetch(url, {
203
+ method: "POST",
204
+ signal: timeout,
205
+ headers: {
206
+ Authorization: `Bearer ${accessToken}`,
207
+ "Content-Type": "application/json",
208
+ "x-needle": "cli"
209
+ },
210
+ body: JSON.stringify(body),
211
+ }).catch(err => {
212
+ if (opts?.loglevel === "verbose") {
213
+ console.error(err);
214
+ }
215
+ return { ok: false, error: err.message };
216
+ });
217
+ if ("error" in res) {
218
+ console.error(`[needle-identifier] Could not fetch project identifier from Needle Cloud API (${res.error})`);
219
+ return null;
220
+ }
221
+ if (res.ok) {
222
+ const text = await res.text();
223
+ try {
224
+ /** @type {{public_key:string}} */
225
+ const json = JSON.parse(text);
226
+ console.log(`[needle-identifier] INFO: Successfully received public project identifier`);
227
+ return json.public_key;
228
+ }
229
+ catch (err) {
230
+ console.error("[needle-identifier] ERROR: Failed to parse project identifier response");
231
+ return null;
232
+ }
233
+ }
234
+ else {
235
+ const message = await res.text();
236
+ console.error(`[needle-identifier] Could not fetch project identifier from Needle Cloud API (${res.status}, ${res.statusText}, ${message})`);
237
+ return null;
238
+ }
239
+ }
240
+ else if (isStackblitz()) {
241
+ console.error("[needle-license] License server is not available in Stackblitz. Please use an access token for authorization.");
242
+ return null;
243
+ }
244
+
245
+
246
+
247
+ // Wait for the server to start
248
+ if (!await waitForLicenseServer(opts)) {
249
+ console.error("[needle-identifier] ERR: Failed to start license server...");
250
+ return null;
251
+ }
252
+
253
+ console.log(`[needle-identifier] INFO: Fetching project identifier...`);
254
+ const url = new URL(projectIdentifierUrl);
255
+ if (project_id) url.searchParams.append("project_id", project_id);
256
+ const timeout = AbortSignal.timeout(10_000);
257
+ const res = await fetch(projectIdentifierUrl, {
258
+ method: "GET",
259
+ signal: timeout
260
+ }).catch(err => {
261
+
262
+ if (opts?.loglevel === "verbose") {
263
+ console.error(err);
264
+ }
265
+
266
+ if (err.cause?.code === "ECONNREFUSED") {
267
+ return { error: "[needle-identifier] Could not connect to the license server: The connection was actively refused" };
268
+ }
269
+ else {
270
+ return { error: "[needle-identifier] ERR: Failed to fetch project identifier." };
271
+ }
272
+ })
273
+
274
+ if (!res) {
275
+ console.warn("[needle-identifier] WARN: Failed to fetch project identifier");
276
+ return null;
277
+ }
278
+ else if ("error" in res) {
279
+ console.error(res.error);
280
+ return null;
281
+ }
282
+ else if (!res.ok) {
283
+ console.error("[needle-identifier] ERROR: Failed to fetch project identifier");
284
+ return null;
285
+ }
286
+ const text = await res.text();
287
+
288
+ try {
289
+ /** @type {{public_key:string}} */
290
+ const json = JSON.parse(text);
291
+ return json.public_key;
292
+ }
293
+ catch (err) {
294
+ // TODO: report error to backend
295
+ if (opts?.loglevel === "verbose") console.error(err);
296
+ return null;
297
+ }
298
+ };
299
+
300
+
301
+
302
+ /**
303
+ * If we run the build command without an editor and the license server is just being started we need to to wait for the root URL to return a response
304
+ * @param {DefaultOptions | undefined} opts
305
+ * @returns {Promise<boolean>}
306
+ */
307
+ async function waitForLicenseServer(opts) {
308
+ if (opts?.loglevel === "verbose") console.log("[needle-license] INFO: Waiting for license server to start...");
309
+
310
+ // Make sure the licensing server is running
311
+ const startcmd = runCommand("npx", ["--yes", NEEDLE_CLOUD_CLI_NAME, "start-server"], opts);
312
+ let isRunning = true;
313
+ startcmd.then(() => isRunning = false);
314
+
315
+ let attempts = 0;
316
+ const maxAttempts = 5;
317
+ do {
318
+ const timeout = AbortSignal.timeout(10_000);
319
+ const response = await fetch(localServerUrl, {
320
+ method: "GET",
321
+ signal: timeout
322
+ }).catch(err => {
323
+ if (opts?.loglevel === "verbose") {
324
+ console.error("ERROR connecting to local license server url at " + localServerUrl, err.message);
325
+ }
326
+ if (err.cause?.code === "ECONNREFUSED") {
327
+ if (!isRunning) {
328
+ console.error("[needle-license] ERR: Failed to connect to license server (ECONNREFUSED)");
329
+ }
330
+ else {
331
+ // Waiting for server to start
332
+ // EConnectRefuse happen if starting the license server for the first time
333
+ }
334
+ }
335
+ else {
336
+ if (attempts === maxAttempts) {
337
+ console.error("[needle-license] ERR: Failed to start license server...", err.message);
338
+ }
339
+ }
340
+ });
341
+ if (response) {
342
+ if (opts?.loglevel === "verbose") console.log(`[needle-license] INFO: License server is running and reachable at ${localServerUrl} (Status: ${response.status})`);
343
+ return true;
344
+ }
345
+ if (attempts === 0) {
346
+ console.log("[needle-license] INFO: Waiting for license server to start...");
347
+ }
348
+ attempts++;
349
+ if (attempts <= maxAttempts) {
350
+ await new Promise(res => setTimeout(res, 1000));
351
+ }
352
+ } while (attempts < maxAttempts);
353
+
354
+ return false;
355
+ }
356
+
357
+
358
+ function isStackblitz() {
359
+ return existsSync("/home/.stackblitz")
360
+ }
361
+
362
+ /**
363
+ * @param {string} processName
364
+ * @param {string[]} args
365
+ * @param {DefaultOptions | undefined} opts
366
+ */
367
+ async function runCommand(processName, args, opts) {
368
+ if (opts?.loglevel === "verbose") console.log(`[needle-license] INFO: Running command: ${processName} ${args.join(" ")}`);
369
+ const process = spawn(processName, [...args], { shell: true, timeout: 30_000 });
370
+ return new Promise((resolve, _reject) => {
371
+ process.on('close', (code) => {
372
+ if (opts?.loglevel === "verbose")
373
+ console.log(`[needle-license] INFO: \"${processName}\" process exited with code ${code}`);
374
+ if (code === 0) {
375
+ resolve(true);
376
+ } else {
377
+ console.warn(`[needle-license] WARN: \"${processName}\" process exited with code ${code}\nProcess Arguments: ${args.join(" ")}`);
378
+ resolve(false);
379
+ }
380
+ });
381
+ process.on('error', (err) => {
382
+ if (opts?.loglevel === "verbose") console.error("Error running " + processName, err);
383
+ resolve(err);
384
+ });
385
+ });
386
+ }
387
+
388
+
389
+
390
+ // NODE 16 doesn't support fetch yet
391
+ // function fetch(url, options) {
392
+ // const module = url.startsWith("https") ? https : http;
393
+ // return new Promise((resolve, reject) => {
394
+ // module.get(url, options, (res) => {
395
+ // let data = '';
396
+ // res.on('data', (chunk) => {
397
+ // data += chunk;
398
+ // });
399
+ // res.on('end', () => {
400
+ // resolve(data);
401
+ // });
402
+ // }).on("error", (err) => {
403
+ // reject(err);
404
+ // });
405
+ // });
366
406
  // }