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

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 (1045) hide show
  1. package/CHANGELOG.md +3604 -3604
  2. package/LICENSE.md +10 -10
  3. package/README.md +64 -64
  4. package/components.needle.json +1 -1
  5. package/dist/needle-engine.bundle.js +8 -8
  6. package/dist/needle-engine.bundle.light.js +8 -8
  7. package/dist/needle-engine.bundle.light.min.js +2 -2
  8. package/dist/needle-engine.bundle.light.umd.cjs +2 -2
  9. package/dist/needle-engine.bundle.min.js +2 -2
  10. package/dist/needle-engine.bundle.umd.cjs +2 -2
  11. package/dist/needle-engine.d.ts +130 -138
  12. package/dist/needle-engine.light.d.ts +130 -138
  13. package/dist/postprocessing.js +1673 -1527
  14. package/dist/postprocessing.light.js +1673 -1527
  15. package/dist/postprocessing.light.min.js +80 -66
  16. package/dist/postprocessing.light.umd.cjs +83 -69
  17. package/dist/postprocessing.min.js +80 -66
  18. package/dist/postprocessing.umd.cjs +83 -69
  19. package/dist/vendor.js +1 -1
  20. package/dist/vendor.light.js +1 -1
  21. package/lib/asap/needle-asap.d.ts +1 -1
  22. package/lib/asap/needle-asap.js +95 -95
  23. package/lib/asap/sessiongranted.d.ts +3 -3
  24. package/lib/asap/sessiongranted.js +65 -65
  25. package/lib/asap/utils.d.ts +1 -1
  26. package/lib/asap/utils.js +3 -3
  27. package/lib/engine/analytics/index.d.ts +6 -6
  28. package/lib/engine/analytics/index.js +12 -12
  29. package/lib/engine/analytics/lcp.d.ts +3 -3
  30. package/lib/engine/analytics/lcp.js +34 -34
  31. package/lib/engine/api.d.ts +81 -81
  32. package/lib/engine/api.js +80 -80
  33. package/lib/engine/assets/index.d.ts +11 -11
  34. package/lib/engine/assets/index.js +47 -47
  35. package/lib/engine/assets/static.d.ts +1 -1
  36. package/lib/engine/assets/static.js +4 -4
  37. package/lib/engine/codegen/register_types.d.ts +1 -1
  38. package/lib/engine/codegen/register_types.js +298 -298
  39. package/lib/engine/debug/debug.d.ts +15 -15
  40. package/lib/engine/debug/debug.js +44 -44
  41. package/lib/engine/debug/debug_console.d.ts +2 -2
  42. package/lib/engine/debug/debug_console.js +307 -307
  43. package/lib/engine/debug/debug_overlay.d.ts +22 -22
  44. package/lib/engine/debug/debug_overlay.js +316 -316
  45. package/lib/engine/debug/debug_spatial_console.d.ts +2 -2
  46. package/lib/engine/debug/debug_spatial_console.js +390 -390
  47. package/lib/engine/debug/index.d.ts +2 -2
  48. package/lib/engine/debug/index.js +2 -2
  49. package/lib/engine/engine_addressables.d.ts +166 -166
  50. package/lib/engine/engine_addressables.js +608 -608
  51. package/lib/engine/engine_animation.d.ts +43 -43
  52. package/lib/engine/engine_animation.js +133 -133
  53. package/lib/engine/engine_application.d.ts +40 -40
  54. package/lib/engine/engine_application.js +104 -104
  55. package/lib/engine/engine_assetdatabase.d.ts +25 -25
  56. package/lib/engine/engine_assetdatabase.js +344 -344
  57. package/lib/engine/engine_audio.d.ts +4 -4
  58. package/lib/engine/engine_audio.js +23 -23
  59. package/lib/engine/engine_camera.d.ts +13 -13
  60. package/lib/engine/engine_camera.js +30 -30
  61. package/lib/engine/engine_components.d.ts +110 -110
  62. package/lib/engine/engine_components.js +380 -380
  63. package/lib/engine/engine_components_internal.d.ts +9 -9
  64. package/lib/engine/engine_components_internal.js +36 -36
  65. package/lib/engine/engine_constants.d.ts +10 -10
  66. package/lib/engine/engine_constants.js +41 -41
  67. package/lib/engine/engine_context.d.ts +345 -345
  68. package/lib/engine/engine_context.js +1515 -1515
  69. package/lib/engine/engine_context_registry.d.ts +71 -71
  70. package/lib/engine/engine_context_registry.js +117 -117
  71. package/lib/engine/engine_coroutine.d.ts +35 -35
  72. package/lib/engine/engine_coroutine.js +52 -52
  73. package/lib/engine/engine_create_objects.d.ts +118 -118
  74. package/lib/engine/engine_create_objects.js +308 -308
  75. package/lib/engine/engine_default_parameters.d.ts +2 -2
  76. package/lib/engine/engine_default_parameters.js +3 -3
  77. package/lib/engine/engine_editor-sync.d.ts +21 -21
  78. package/lib/engine/engine_editor-sync.js +4 -4
  79. package/lib/engine/engine_element.d.ts +113 -113
  80. package/lib/engine/engine_element.js +830 -830
  81. package/lib/engine/engine_element_attributes.d.ts +72 -72
  82. package/lib/engine/engine_element_attributes.js +1 -1
  83. package/lib/engine/engine_element_extras.d.ts +6 -6
  84. package/lib/engine/engine_element_extras.js +13 -13
  85. package/lib/engine/engine_element_loading.d.ts +44 -44
  86. package/lib/engine/engine_element_loading.js +349 -349
  87. package/lib/engine/engine_element_overlay.d.ts +21 -21
  88. package/lib/engine/engine_element_overlay.js +166 -166
  89. package/lib/engine/engine_fileloader.d.ts +2 -2
  90. package/lib/engine/engine_fileloader.js +8 -8
  91. package/lib/engine/engine_gameobject.d.ts +68 -68
  92. package/lib/engine/engine_gameobject.js +591 -591
  93. package/lib/engine/engine_generic_utils.d.ts +1 -1
  94. package/lib/engine/engine_generic_utils.js +13 -13
  95. package/lib/engine/engine_gizmos.d.ts +149 -149
  96. package/lib/engine/engine_gizmos.js +530 -530
  97. package/lib/engine/engine_gltf.d.ts +12 -12
  98. package/lib/engine/engine_gltf.js +15 -15
  99. package/lib/engine/engine_gltf_builtin_components.d.ts +7 -7
  100. package/lib/engine/engine_gltf_builtin_components.js +341 -341
  101. package/lib/engine/engine_hot_reload.d.ts +7 -7
  102. package/lib/engine/engine_hot_reload.js +184 -184
  103. package/lib/engine/engine_input.d.ts +352 -352
  104. package/lib/engine/engine_input.js +1265 -1265
  105. package/lib/engine/engine_input_utils.d.ts +2 -2
  106. package/lib/engine/engine_input_utils.js +22 -22
  107. package/lib/engine/engine_instancing.d.ts +19 -19
  108. package/lib/engine/engine_instancing.js +39 -39
  109. package/lib/engine/engine_license.d.ts +9 -9
  110. package/lib/engine/engine_license.js +320 -320
  111. package/lib/engine/engine_lifecycle_api.d.ts +76 -76
  112. package/lib/engine/engine_lifecycle_api.js +99 -99
  113. package/lib/engine/engine_lifecycle_functions_internal.d.ts +32 -32
  114. package/lib/engine/engine_lifecycle_functions_internal.js +146 -146
  115. package/lib/engine/engine_lightdata.d.ts +23 -23
  116. package/lib/engine/engine_lightdata.js +91 -91
  117. package/lib/engine/engine_loaders.d.ts +13 -13
  118. package/lib/engine/engine_loaders.js +62 -62
  119. package/lib/engine/engine_lods.d.ts +31 -31
  120. package/lib/engine/engine_lods.js +146 -146
  121. package/lib/engine/engine_mainloop_utils.d.ts +32 -32
  122. package/lib/engine/engine_mainloop_utils.js +466 -466
  123. package/lib/engine/engine_math.d.ts +114 -114
  124. package/lib/engine/engine_math.js +247 -247
  125. package/lib/engine/engine_modules.d.ts +36 -36
  126. package/lib/engine/engine_modules.js +85 -85
  127. package/lib/engine/engine_networking.d.ts +252 -252
  128. package/lib/engine/engine_networking.js +743 -743
  129. package/lib/engine/engine_networking_auto.d.ts +24 -24
  130. package/lib/engine/engine_networking_auto.js +310 -310
  131. package/lib/engine/engine_networking_blob.d.ts +48 -48
  132. package/lib/engine/engine_networking_blob.js +212 -212
  133. package/lib/engine/engine_networking_files.d.ts +35 -35
  134. package/lib/engine/engine_networking_files.js +172 -172
  135. package/lib/engine/engine_networking_files_default_components.d.ts +6 -6
  136. package/lib/engine/engine_networking_files_default_components.js +42 -42
  137. package/lib/engine/engine_networking_instantiate.d.ts +100 -100
  138. package/lib/engine/engine_networking_instantiate.js +345 -345
  139. package/lib/engine/engine_networking_peer.d.ts +15 -15
  140. package/lib/engine/engine_networking_peer.js +132 -132
  141. package/lib/engine/engine_networking_streams.d.ts +123 -123
  142. package/lib/engine/engine_networking_streams.js +645 -645
  143. package/lib/engine/engine_networking_types.d.ts +22 -22
  144. package/lib/engine/engine_networking_types.js +7 -7
  145. package/lib/engine/engine_networking_utils.d.ts +2 -2
  146. package/lib/engine/engine_networking_utils.js +20 -20
  147. package/lib/engine/engine_networking_websocket.d.ts +1 -1
  148. package/lib/engine/engine_networking_websocket.js +2 -2
  149. package/lib/engine/engine_patcher.d.ts +10 -10
  150. package/lib/engine/engine_patcher.js +142 -142
  151. package/lib/engine/engine_physics.d.ts +152 -152
  152. package/lib/engine/engine_physics.js +645 -645
  153. package/lib/engine/engine_physics.types.d.ts +40 -40
  154. package/lib/engine/engine_physics.types.js +33 -33
  155. package/lib/engine/engine_physics_rapier.d.ts +147 -147
  156. package/lib/engine/engine_physics_rapier.js +1432 -1432
  157. package/lib/engine/engine_playerview.d.ts +26 -26
  158. package/lib/engine/engine_playerview.js +64 -64
  159. package/lib/engine/engine_scenelighting.d.ts +71 -71
  160. package/lib/engine/engine_scenelighting.js +226 -226
  161. package/lib/engine/engine_scenetools.d.ts +50 -50
  162. package/lib/engine/engine_scenetools.js +321 -321
  163. package/lib/engine/engine_serialization.d.ts +3 -3
  164. package/lib/engine/engine_serialization.js +3 -3
  165. package/lib/engine/engine_serialization_builtin_serializer.d.ts +72 -72
  166. package/lib/engine/engine_serialization_builtin_serializer.js +403 -403
  167. package/lib/engine/engine_serialization_core.d.ts +85 -85
  168. package/lib/engine/engine_serialization_core.js +602 -602
  169. package/lib/engine/engine_serialization_decorator.d.ts +23 -23
  170. package/lib/engine/engine_serialization_decorator.js +66 -66
  171. package/lib/engine/engine_setup.d.ts +1 -1
  172. package/lib/engine/engine_setup.js +2 -2
  173. package/lib/engine/engine_shaders.d.ts +53 -53
  174. package/lib/engine/engine_shaders.js +252 -252
  175. package/lib/engine/engine_shims.d.ts +4 -4
  176. package/lib/engine/engine_shims.js +24 -24
  177. package/lib/engine/engine_test_utils.d.ts +39 -39
  178. package/lib/engine/engine_test_utils.js +83 -83
  179. package/lib/engine/engine_texture.d.ts +28 -28
  180. package/lib/engine/engine_texture.js +64 -64
  181. package/lib/engine/engine_three_utils.d.ts +201 -201
  182. package/lib/engine/engine_three_utils.js +731 -731
  183. package/lib/engine/engine_time.d.ts +51 -51
  184. package/lib/engine/engine_time.js +82 -82
  185. package/lib/engine/engine_time_utils.d.ts +88 -88
  186. package/lib/engine/engine_time_utils.js +215 -215
  187. package/lib/engine/engine_tonemapping.d.ts +2 -2
  188. package/lib/engine/engine_tonemapping.js +194 -194
  189. package/lib/engine/engine_types.d.ts +572 -572
  190. package/lib/engine/engine_types.js +88 -88
  191. package/lib/engine/engine_typestore.d.ts +28 -28
  192. package/lib/engine/engine_typestore.js +55 -55
  193. package/lib/engine/engine_util_decorator.d.ts +13 -13
  194. package/lib/engine/engine_util_decorator.js +116 -116
  195. package/lib/engine/engine_utils.d.ts +266 -266
  196. package/lib/engine/engine_utils.js +878 -878
  197. package/lib/engine/engine_utils_format.d.ts +21 -21
  198. package/lib/engine/engine_utils_format.js +193 -193
  199. package/lib/engine/engine_utils_screenshot.d.ts +159 -159
  200. package/lib/engine/engine_utils_screenshot.js +513 -513
  201. package/lib/engine/engine_utils_screenshot.xr.d.ts +5 -5
  202. package/lib/engine/engine_utils_screenshot.xr.js +90 -90
  203. package/lib/engine/engine_xr.d.ts +1 -1
  204. package/lib/engine/engine_xr.js +1 -1
  205. package/lib/engine/export/gltf/Writers.d.ts +19 -19
  206. package/lib/engine/export/gltf/Writers.js +24 -24
  207. package/lib/engine/export/gltf/index.d.ts +11 -11
  208. package/lib/engine/export/gltf/index.js +123 -123
  209. package/lib/engine/export/index.d.ts +2 -2
  210. package/lib/engine/export/index.js +2 -2
  211. package/lib/engine/export/state.d.ts +7 -7
  212. package/lib/engine/export/state.js +17 -17
  213. package/lib/engine/export/utils.d.ts +2 -2
  214. package/lib/engine/export/utils.js +7 -7
  215. package/lib/engine/extensions/EXT_texture_exr.d.ts +8 -8
  216. package/lib/engine/extensions/EXT_texture_exr.js +32 -32
  217. package/lib/engine/extensions/NEEDLE_animator_controller_model.d.ts +122 -122
  218. package/lib/engine/extensions/NEEDLE_animator_controller_model.js +95 -95
  219. package/lib/engine/extensions/NEEDLE_components.d.ts +35 -35
  220. package/lib/engine/extensions/NEEDLE_components.js +220 -220
  221. package/lib/engine/extensions/NEEDLE_gameobject_data.d.ts +10 -10
  222. package/lib/engine/extensions/NEEDLE_gameobject_data.js +57 -57
  223. package/lib/engine/extensions/NEEDLE_lighting_settings.d.ts +37 -37
  224. package/lib/engine/extensions/NEEDLE_lighting_settings.js +157 -157
  225. package/lib/engine/extensions/NEEDLE_lightmaps.d.ts +18 -18
  226. package/lib/engine/extensions/NEEDLE_lightmaps.js +99 -99
  227. package/lib/engine/extensions/NEEDLE_persistent_assets.d.ts +11 -11
  228. package/lib/engine/extensions/NEEDLE_persistent_assets.js +63 -63
  229. package/lib/engine/extensions/NEEDLE_progressive.d.ts +1 -1
  230. package/lib/engine/extensions/NEEDLE_progressive.js +1 -1
  231. package/lib/engine/extensions/NEEDLE_render_objects.d.ts +13 -13
  232. package/lib/engine/extensions/NEEDLE_render_objects.js +159 -159
  233. package/lib/engine/extensions/NEEDLE_techniques_webgl.d.ts +38 -38
  234. package/lib/engine/extensions/NEEDLE_techniques_webgl.js +564 -564
  235. package/lib/engine/extensions/extension_resolver.d.ts +4 -4
  236. package/lib/engine/extensions/extension_resolver.js +1 -1
  237. package/lib/engine/extensions/extension_utils.d.ts +12 -12
  238. package/lib/engine/extensions/extension_utils.js +152 -152
  239. package/lib/engine/extensions/extensions.d.ts +31 -31
  240. package/lib/engine/extensions/extensions.js +103 -103
  241. package/lib/engine/extensions/index.d.ts +6 -6
  242. package/lib/engine/extensions/index.js +6 -6
  243. package/lib/engine/extensions/usage_tracker.d.ts +13 -13
  244. package/lib/engine/extensions/usage_tracker.js +65 -65
  245. package/lib/engine/js-extensions/Camera.d.ts +1 -1
  246. package/lib/engine/js-extensions/Camera.js +39 -39
  247. package/lib/engine/js-extensions/ExtensionUtils.d.ts +9 -9
  248. package/lib/engine/js-extensions/ExtensionUtils.js +67 -67
  249. package/lib/engine/js-extensions/Layers.d.ts +6 -6
  250. package/lib/engine/js-extensions/Layers.js +22 -22
  251. package/lib/engine/js-extensions/Object3D.d.ts +120 -120
  252. package/lib/engine/js-extensions/Object3D.js +136 -136
  253. package/lib/engine/js-extensions/RGBAColor.d.ts +22 -22
  254. package/lib/engine/js-extensions/RGBAColor.js +62 -62
  255. package/lib/engine/js-extensions/Vector.d.ts +3 -3
  256. package/lib/engine/js-extensions/Vector.js +13 -13
  257. package/lib/engine/js-extensions/index.d.ts +5 -5
  258. package/lib/engine/js-extensions/index.js +5 -5
  259. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.d.ts +4 -4
  260. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +75 -75
  261. package/lib/engine/shaders/shaderData.d.ts +55 -55
  262. package/lib/engine/shaders/shaderData.js +58 -58
  263. package/lib/engine/tests/test_utils.d.ts +2 -2
  264. package/lib/engine/tests/test_utils.js +53 -53
  265. package/lib/engine/webcomponents/WebXRButtons.d.ts +56 -56
  266. package/lib/engine/webcomponents/WebXRButtons.js +230 -230
  267. package/lib/engine/webcomponents/api.d.ts +5 -5
  268. package/lib/engine/webcomponents/api.js +4 -4
  269. package/lib/engine/webcomponents/buttons.d.ts +39 -39
  270. package/lib/engine/webcomponents/buttons.js +237 -237
  271. package/lib/engine/webcomponents/fonts.d.ts +9 -9
  272. package/lib/engine/webcomponents/fonts.js +32 -32
  273. package/lib/engine/webcomponents/icons.d.ts +9 -9
  274. package/lib/engine/webcomponents/icons.js +52 -52
  275. package/lib/engine/webcomponents/index.d.ts +1 -1
  276. package/lib/engine/webcomponents/index.js +1 -1
  277. package/lib/engine/webcomponents/logo-element.d.ts +10 -10
  278. package/lib/engine/webcomponents/logo-element.js +67 -67
  279. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.d.ts +37 -37
  280. package/lib/engine/webcomponents/needle menu/needle-menu-spatial.js +513 -513
  281. package/lib/engine/webcomponents/needle menu/needle-menu.d.ts +151 -151
  282. package/lib/engine/webcomponents/needle menu/needle-menu.js +1018 -1018
  283. package/lib/engine/webcomponents/needle-button.d.ts +34 -34
  284. package/lib/engine/webcomponents/needle-button.js +161 -161
  285. package/lib/engine/xr/NeedleXRController.d.ts +313 -313
  286. package/lib/engine/xr/NeedleXRController.js +1008 -1008
  287. package/lib/engine/xr/NeedleXRSession.d.ts +339 -339
  288. package/lib/engine/xr/NeedleXRSession.js +1427 -1427
  289. package/lib/engine/xr/NeedleXRSync.d.ts +22 -22
  290. package/lib/engine/xr/NeedleXRSync.js +188 -188
  291. package/lib/engine/xr/SceneTransition.d.ts +18 -18
  292. package/lib/engine/xr/SceneTransition.js +69 -69
  293. package/lib/engine/xr/TempXRContext.d.ts +34 -34
  294. package/lib/engine/xr/TempXRContext.js +187 -187
  295. package/lib/engine/xr/XRRig.d.ts +7 -7
  296. package/lib/engine/xr/XRRig.js +1 -1
  297. package/lib/engine/xr/api.d.ts +6 -6
  298. package/lib/engine/xr/api.js +6 -6
  299. package/lib/engine/xr/events.d.ts +66 -66
  300. package/lib/engine/xr/events.js +93 -93
  301. package/lib/engine/xr/internal.d.ts +12 -12
  302. package/lib/engine/xr/internal.js +25 -25
  303. package/lib/engine/xr/usdz.d.ts +12 -12
  304. package/lib/engine/xr/usdz.js +29 -29
  305. package/lib/engine/xr/utils.d.ts +11 -11
  306. package/lib/engine/xr/utils.js +34 -34
  307. package/lib/engine-components/AlignmentConstraint.d.ts +10 -10
  308. package/lib/engine-components/AlignmentConstraint.js +39 -39
  309. package/lib/engine-components/Animation.d.ts +156 -156
  310. package/lib/engine-components/Animation.js +508 -508
  311. package/lib/engine-components/AnimationCurve.d.ts +40 -40
  312. package/lib/engine-components/AnimationCurve.js +159 -159
  313. package/lib/engine-components/AnimationUtils.d.ts +8 -8
  314. package/lib/engine-components/AnimationUtils.js +27 -27
  315. package/lib/engine-components/AnimationUtilsAutoplay.d.ts +1 -1
  316. package/lib/engine-components/AnimationUtilsAutoplay.js +39 -39
  317. package/lib/engine-components/Animator.d.ts +217 -217
  318. package/lib/engine-components/Animator.js +354 -354
  319. package/lib/engine-components/AnimatorController.d.ts +227 -227
  320. package/lib/engine-components/AnimatorController.js +1152 -1152
  321. package/lib/engine-components/AudioListener.d.ts +33 -33
  322. package/lib/engine-components/AudioListener.js +86 -86
  323. package/lib/engine-components/AudioSource.d.ts +217 -217
  324. package/lib/engine-components/AudioSource.js +627 -627
  325. package/lib/engine-components/AvatarLoader.d.ts +80 -80
  326. package/lib/engine-components/AvatarLoader.js +231 -231
  327. package/lib/engine-components/AxesHelper.d.ts +32 -32
  328. package/lib/engine-components/AxesHelper.js +67 -67
  329. package/lib/engine-components/BasicIKConstraint.d.ts +9 -9
  330. package/lib/engine-components/BasicIKConstraint.js +43 -43
  331. package/lib/engine-components/BoxCollider.d.ts +2 -2
  332. package/lib/engine-components/BoxCollider.js +2 -2
  333. package/lib/engine-components/BoxHelperComponent.d.ts +47 -47
  334. package/lib/engine-components/BoxHelperComponent.js +102 -102
  335. package/lib/engine-components/Camera.d.ts +231 -231
  336. package/lib/engine-components/Camera.js +694 -694
  337. package/lib/engine-components/CameraUtils.d.ts +1 -1
  338. package/lib/engine-components/CameraUtils.js +127 -127
  339. package/lib/engine-components/CharacterController.d.ts +55 -55
  340. package/lib/engine-components/CharacterController.js +236 -236
  341. package/lib/engine-components/Collider.d.ts +188 -188
  342. package/lib/engine-components/Collider.js +369 -369
  343. package/lib/engine-components/Component.d.ts +792 -792
  344. package/lib/engine-components/Component.js +915 -915
  345. package/lib/engine-components/ContactShadows.d.ts +82 -82
  346. package/lib/engine-components/ContactShadows.js +430 -430
  347. package/lib/engine-components/DeleteBox.d.ts +19 -19
  348. package/lib/engine-components/DeleteBox.js +58 -58
  349. package/lib/engine-components/DeviceFlag.d.ts +16 -16
  350. package/lib/engine-components/DeviceFlag.js +47 -47
  351. package/lib/engine-components/DragControls.d.ts +170 -170
  352. package/lib/engine-components/DragControls.js +1421 -1421
  353. package/lib/engine-components/DropListener.d.ts +215 -215
  354. package/lib/engine-components/DropListener.js +630 -630
  355. package/lib/engine-components/Duplicatable.d.ts +35 -35
  356. package/lib/engine-components/Duplicatable.js +202 -202
  357. package/lib/engine-components/EventList.d.ts +54 -54
  358. package/lib/engine-components/EventList.js +232 -232
  359. package/lib/engine-components/EventTrigger.d.ts +33 -33
  360. package/lib/engine-components/EventTrigger.js +75 -75
  361. package/lib/engine-components/EventType.d.ts +22 -22
  362. package/lib/engine-components/EventType.js +23 -23
  363. package/lib/engine-components/Fog.d.ts +22 -22
  364. package/lib/engine-components/Fog.js +61 -61
  365. package/lib/engine-components/Gizmos.d.ts +17 -17
  366. package/lib/engine-components/Gizmos.js +64 -64
  367. package/lib/engine-components/GridHelper.d.ts +20 -20
  368. package/lib/engine-components/GridHelper.js +54 -54
  369. package/lib/engine-components/GroundProjection.d.ts +67 -67
  370. package/lib/engine-components/GroundProjection.js +343 -343
  371. package/lib/engine-components/Interactable.d.ts +12 -12
  372. package/lib/engine-components/Interactable.js +12 -12
  373. package/lib/engine-components/Joints.d.ts +19 -19
  374. package/lib/engine-components/Joints.js +51 -51
  375. package/lib/engine-components/LODGroup.d.ts +35 -35
  376. package/lib/engine-components/LODGroup.js +152 -152
  377. package/lib/engine-components/Light.d.ts +180 -180
  378. package/lib/engine-components/Light.js +535 -535
  379. package/lib/engine-components/LookAtConstraint.d.ts +19 -19
  380. package/lib/engine-components/LookAtConstraint.js +35 -35
  381. package/lib/engine-components/NeedleMenu.d.ts +50 -50
  382. package/lib/engine-components/NeedleMenu.js +92 -92
  383. package/lib/engine-components/NestedGltf.d.ts +25 -25
  384. package/lib/engine-components/NestedGltf.js +88 -88
  385. package/lib/engine-components/Networking.d.ts +54 -54
  386. package/lib/engine-components/Networking.js +112 -112
  387. package/lib/engine-components/OffsetConstraint.d.ts +14 -14
  388. package/lib/engine-components/OffsetConstraint.js +65 -65
  389. package/lib/engine-components/OrbitControls.d.ts +266 -266
  390. package/lib/engine-components/OrbitControls.js +1009 -1009
  391. package/lib/engine-components/PlayerColor.d.ts +19 -19
  392. package/lib/engine-components/PlayerColor.js +94 -94
  393. package/lib/engine-components/ReflectionProbe.d.ts +26 -26
  394. package/lib/engine-components/ReflectionProbe.js +194 -194
  395. package/lib/engine-components/Renderer.d.ts +153 -153
  396. package/lib/engine-components/Renderer.js +830 -830
  397. package/lib/engine-components/RendererInstancing.d.ts +140 -140
  398. package/lib/engine-components/RendererInstancing.js +744 -744
  399. package/lib/engine-components/RendererLightmap.d.ts +24 -24
  400. package/lib/engine-components/RendererLightmap.js +182 -182
  401. package/lib/engine-components/RigidBody.d.ts +155 -155
  402. package/lib/engine-components/RigidBody.js +517 -517
  403. package/lib/engine-components/SceneSwitcher.d.ts +263 -263
  404. package/lib/engine-components/SceneSwitcher.js +951 -951
  405. package/lib/engine-components/ScreenCapture.d.ts +144 -144
  406. package/lib/engine-components/ScreenCapture.js +547 -547
  407. package/lib/engine-components/ShadowCatcher.d.ts +33 -33
  408. package/lib/engine-components/ShadowCatcher.js +166 -166
  409. package/lib/engine-components/Skybox.d.ts +82 -82
  410. package/lib/engine-components/Skybox.js +448 -448
  411. package/lib/engine-components/SmoothFollow.d.ts +34 -34
  412. package/lib/engine-components/SmoothFollow.js +82 -82
  413. package/lib/engine-components/SpatialTrigger.d.ts +102 -102
  414. package/lib/engine-components/SpatialTrigger.js +225 -225
  415. package/lib/engine-components/SpectatorCamera.d.ts +111 -111
  416. package/lib/engine-components/SpectatorCamera.js +715 -715
  417. package/lib/engine-components/SphereCollider.d.ts +2 -2
  418. package/lib/engine-components/SphereCollider.js +2 -2
  419. package/lib/engine-components/SpriteRenderer.d.ts +132 -132
  420. package/lib/engine-components/SpriteRenderer.js +472 -472
  421. package/lib/engine-components/SyncedCamera.d.ts +41 -41
  422. package/lib/engine-components/SyncedCamera.js +199 -199
  423. package/lib/engine-components/SyncedRoom.d.ts +106 -106
  424. package/lib/engine-components/SyncedRoom.js +371 -371
  425. package/lib/engine-components/SyncedTransform.d.ts +88 -88
  426. package/lib/engine-components/SyncedTransform.js +326 -326
  427. package/lib/engine-components/TestRunner.d.ts +16 -16
  428. package/lib/engine-components/TestRunner.js +102 -102
  429. package/lib/engine-components/TransformGizmo.d.ts +75 -75
  430. package/lib/engine-components/TransformGizmo.js +209 -209
  431. package/lib/engine-components/VideoPlayer.d.ts +184 -184
  432. package/lib/engine-components/VideoPlayer.js +978 -978
  433. package/lib/engine-components/Voip.d.ts +67 -67
  434. package/lib/engine-components/Voip.js +360 -360
  435. package/lib/engine-components/api.d.ts +51 -51
  436. package/lib/engine-components/api.js +50 -50
  437. package/lib/engine-components/avatar/AvatarBlink_Simple.d.ts +11 -11
  438. package/lib/engine-components/avatar/AvatarBlink_Simple.js +76 -76
  439. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.d.ts +14 -14
  440. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.js +68 -68
  441. package/lib/engine-components/avatar/Avatar_Brain_LookAt.d.ts +29 -29
  442. package/lib/engine-components/avatar/Avatar_Brain_LookAt.js +121 -121
  443. package/lib/engine-components/avatar/Avatar_MouthShapes.d.ts +15 -15
  444. package/lib/engine-components/avatar/Avatar_MouthShapes.js +79 -79
  445. package/lib/engine-components/avatar/Avatar_MustacheShake.d.ts +9 -9
  446. package/lib/engine-components/avatar/Avatar_MustacheShake.js +29 -29
  447. package/lib/engine-components/codegen/components.d.ts +215 -215
  448. package/lib/engine-components/codegen/components.js +217 -217
  449. package/lib/engine-components/debug/LogStats.d.ts +5 -5
  450. package/lib/engine-components/debug/LogStats.js +18 -18
  451. package/lib/engine-components/export/gltf/GltfExport.d.ts +30 -30
  452. package/lib/engine-components/export/gltf/GltfExport.js +246 -246
  453. package/lib/engine-components/export/gltf/index.d.ts +1 -1
  454. package/lib/engine-components/export/gltf/index.js +1 -1
  455. package/lib/engine-components/export/index.d.ts +1 -1
  456. package/lib/engine-components/export/index.js +1 -1
  457. package/lib/engine-components/export/usdz/Extension.d.ts +22 -22
  458. package/lib/engine-components/export/usdz/Extension.js +1 -1
  459. package/lib/engine-components/export/usdz/ThreeUSDZExporter.d.ts +160 -160
  460. package/lib/engine-components/export/usdz/ThreeUSDZExporter.js +1782 -1782
  461. package/lib/engine-components/export/usdz/USDZExporter.d.ts +130 -130
  462. package/lib/engine-components/export/usdz/USDZExporter.js +663 -663
  463. package/lib/engine-components/export/usdz/extensions/Animation.d.ts +106 -106
  464. package/lib/engine-components/export/usdz/extensions/Animation.js +1071 -1071
  465. package/lib/engine-components/export/usdz/extensions/DocumentExtension.d.ts +5 -5
  466. package/lib/engine-components/export/usdz/extensions/DocumentExtension.js +6 -6
  467. package/lib/engine-components/export/usdz/extensions/USDZText.d.ts +54 -54
  468. package/lib/engine-components/export/usdz/extensions/USDZText.js +203 -203
  469. package/lib/engine-components/export/usdz/extensions/USDZUI.d.ts +8 -8
  470. package/lib/engine-components/export/usdz/extensions/USDZUI.js +157 -157
  471. package/lib/engine-components/export/usdz/extensions/behavior/Actions.d.ts +30 -30
  472. package/lib/engine-components/export/usdz/extensions/behavior/Actions.js +88 -88
  473. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.d.ts +10 -10
  474. package/lib/engine-components/export/usdz/extensions/behavior/AudioExtension.js +86 -86
  475. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.d.ts +28 -28
  476. package/lib/engine-components/export/usdz/extensions/behavior/Behaviour.js +290 -290
  477. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.d.ts +190 -190
  478. package/lib/engine-components/export/usdz/extensions/behavior/BehaviourComponents.js +1060 -1060
  479. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.d.ts +135 -135
  480. package/lib/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.js +548 -548
  481. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.d.ts +7 -7
  482. package/lib/engine-components/export/usdz/extensions/behavior/PhysicsExtension.js +115 -115
  483. package/lib/engine-components/export/usdz/index.d.ts +3 -3
  484. package/lib/engine-components/export/usdz/index.js +2 -2
  485. package/lib/engine-components/export/usdz/utils/animationutils.d.ts +7 -7
  486. package/lib/engine-components/export/usdz/utils/animationutils.js +163 -163
  487. package/lib/engine-components/export/usdz/utils/quicklook.d.ts +2 -2
  488. package/lib/engine-components/export/usdz/utils/quicklook.js +43 -43
  489. package/lib/engine-components/particlesystem/ParticleSystem.d.ts +177 -177
  490. package/lib/engine-components/particlesystem/ParticleSystem.js +1176 -1176
  491. package/lib/engine-components/particlesystem/ParticleSystemModules.d.ts +526 -526
  492. package/lib/engine-components/particlesystem/ParticleSystemModules.js +1930 -1930
  493. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.d.ts +25 -25
  494. package/lib/engine-components/particlesystem/ParticleSystemSubEmitter.js +87 -87
  495. package/lib/engine-components/particlesystem/api.d.ts +2 -2
  496. package/lib/engine-components/particlesystem/api.js +2 -2
  497. package/lib/engine-components/postprocessing/Effects/Antialiasing.d.ts +17 -17
  498. package/lib/engine-components/postprocessing/Effects/Antialiasing.js +50 -50
  499. package/lib/engine-components/postprocessing/Effects/BloomEffect.d.ts +46 -46
  500. package/lib/engine-components/postprocessing/Effects/BloomEffect.js +113 -113
  501. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.d.ts +11 -11
  502. package/lib/engine-components/postprocessing/Effects/ChromaticAberration.js +39 -39
  503. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.d.ts +15 -15
  504. package/lib/engine-components/postprocessing/Effects/ColorAdjustments.js +92 -92
  505. package/lib/engine-components/postprocessing/Effects/DepthOfField.d.ts +25 -25
  506. package/lib/engine-components/postprocessing/Effects/DepthOfField.js +104 -104
  507. package/lib/engine-components/postprocessing/Effects/EffectWrapper.d.ts +12 -12
  508. package/lib/engine-components/postprocessing/Effects/EffectWrapper.js +18 -18
  509. package/lib/engine-components/postprocessing/Effects/Pixelation.d.ts +11 -11
  510. package/lib/engine-components/postprocessing/Effects/Pixelation.js +32 -32
  511. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.d.ts +18 -18
  512. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.js +91 -91
  513. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.d.ts +70 -70
  514. package/lib/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.js +175 -175
  515. package/lib/engine-components/postprocessing/Effects/Sharpening.d.ts +17 -17
  516. package/lib/engine-components/postprocessing/Effects/Sharpening.js +123 -123
  517. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.d.ts +17 -17
  518. package/lib/engine-components/postprocessing/Effects/TiltShiftEffect.js +70 -70
  519. package/lib/engine-components/postprocessing/Effects/Tonemapping.d.ts +26 -26
  520. package/lib/engine-components/postprocessing/Effects/Tonemapping.js +138 -138
  521. package/lib/engine-components/postprocessing/Effects/Vignette.d.ts +15 -15
  522. package/lib/engine-components/postprocessing/Effects/Vignette.js +60 -60
  523. package/lib/engine-components/postprocessing/PostProcessingEffect.d.ts +72 -72
  524. package/lib/engine-components/postprocessing/PostProcessingEffect.js +149 -149
  525. package/lib/engine-components/postprocessing/PostProcessingHandler.d.ts +25 -25
  526. package/lib/engine-components/postprocessing/PostProcessingHandler.js +350 -350
  527. package/lib/engine-components/postprocessing/Volume.d.ts +89 -89
  528. package/lib/engine-components/postprocessing/Volume.js +367 -367
  529. package/lib/engine-components/postprocessing/VolumeParameter.d.ts +26 -26
  530. package/lib/engine-components/postprocessing/VolumeParameter.js +136 -136
  531. package/lib/engine-components/postprocessing/VolumeProfile.d.ts +15 -15
  532. package/lib/engine-components/postprocessing/VolumeProfile.js +60 -60
  533. package/lib/engine-components/postprocessing/index.d.ts +5 -5
  534. package/lib/engine-components/postprocessing/index.js +5 -5
  535. package/lib/engine-components/postprocessing/utils.d.ts +11 -11
  536. package/lib/engine-components/postprocessing/utils.js +37 -37
  537. package/lib/engine-components/timeline/PlayableDirector.d.ts +163 -163
  538. package/lib/engine-components/timeline/PlayableDirector.js +686 -686
  539. package/lib/engine-components/timeline/SignalAsset.d.ts +24 -24
  540. package/lib/engine-components/timeline/SignalAsset.js +130 -130
  541. package/lib/engine-components/timeline/TimelineModels.d.ts +89 -89
  542. package/lib/engine-components/timeline/TimelineModels.js +22 -22
  543. package/lib/engine-components/timeline/TimelineTracks.d.ts +110 -110
  544. package/lib/engine-components/timeline/TimelineTracks.js +879 -879
  545. package/lib/engine-components/timeline/index.d.ts +4 -4
  546. package/lib/engine-components/timeline/index.js +3 -3
  547. package/lib/engine-components/ui/BaseUIComponent.d.ts +49 -49
  548. package/lib/engine-components/ui/BaseUIComponent.js +170 -170
  549. package/lib/engine-components/ui/Button.d.ts +64 -64
  550. package/lib/engine-components/ui/Button.js +315 -315
  551. package/lib/engine-components/ui/Canvas.d.ts +74 -74
  552. package/lib/engine-components/ui/Canvas.js +407 -407
  553. package/lib/engine-components/ui/CanvasGroup.d.ts +19 -19
  554. package/lib/engine-components/ui/CanvasGroup.js +58 -58
  555. package/lib/engine-components/ui/EventSystem.d.ts +125 -125
  556. package/lib/engine-components/ui/EventSystem.js +764 -764
  557. package/lib/engine-components/ui/Graphic.d.ts +55 -55
  558. package/lib/engine-components/ui/Graphic.js +254 -254
  559. package/lib/engine-components/ui/Image.d.ts +35 -35
  560. package/lib/engine-components/ui/Image.js +116 -116
  561. package/lib/engine-components/ui/InputField.d.ts +42 -42
  562. package/lib/engine-components/ui/InputField.js +268 -268
  563. package/lib/engine-components/ui/Interfaces.d.ts +38 -38
  564. package/lib/engine-components/ui/Interfaces.js +12 -12
  565. package/lib/engine-components/ui/Layout.d.ts +84 -84
  566. package/lib/engine-components/ui/Layout.js +330 -330
  567. package/lib/engine-components/ui/Outline.d.ts +7 -7
  568. package/lib/engine-components/ui/Outline.js +20 -20
  569. package/lib/engine-components/ui/PointerEvents.d.ts +115 -115
  570. package/lib/engine-components/ui/PointerEvents.js +145 -145
  571. package/lib/engine-components/ui/RaycastUtils.d.ts +11 -11
  572. package/lib/engine-components/ui/RaycastUtils.js +67 -67
  573. package/lib/engine-components/ui/Raycaster.d.ts +30 -30
  574. package/lib/engine-components/ui/Raycaster.js +95 -95
  575. package/lib/engine-components/ui/RectTransform.d.ts +61 -61
  576. package/lib/engine-components/ui/RectTransform.js +353 -353
  577. package/lib/engine-components/ui/SpatialHtml.d.ts +8 -8
  578. package/lib/engine-components/ui/SpatialHtml.js +79 -79
  579. package/lib/engine-components/ui/Text.d.ts +78 -78
  580. package/lib/engine-components/ui/Text.js +539 -539
  581. package/lib/engine-components/ui/Utils.d.ts +24 -24
  582. package/lib/engine-components/ui/Utils.js +90 -90
  583. package/lib/engine-components/ui/index.d.ts +1 -1
  584. package/lib/engine-components/ui/index.js +1 -1
  585. package/lib/engine-components/utils/EnvironmentScene.d.ts +5 -5
  586. package/lib/engine-components/utils/EnvironmentScene.js +205 -205
  587. package/lib/engine-components/utils/LookAt.d.ts +31 -31
  588. package/lib/engine-components/utils/LookAt.js +82 -82
  589. package/lib/engine-components/utils/OpenURL.d.ts +42 -42
  590. package/lib/engine-components/utils/OpenURL.js +119 -119
  591. package/lib/engine-components/webxr/Avatar.d.ts +25 -25
  592. package/lib/engine-components/webxr/Avatar.js +255 -255
  593. package/lib/engine-components/webxr/TeleportTarget.d.ts +7 -7
  594. package/lib/engine-components/webxr/TeleportTarget.js +7 -7
  595. package/lib/engine-components/webxr/WebARCameraBackground.d.ts +30 -30
  596. package/lib/engine-components/webxr/WebARCameraBackground.js +155 -155
  597. package/lib/engine-components/webxr/WebARSessionRoot.d.ts +98 -98
  598. package/lib/engine-components/webxr/WebARSessionRoot.js +770 -770
  599. package/lib/engine-components/webxr/WebXR.d.ts +232 -232
  600. package/lib/engine-components/webxr/WebXR.js +561 -561
  601. package/lib/engine-components/webxr/WebXRAvatar.d.ts +27 -27
  602. package/lib/engine-components/webxr/WebXRAvatar.js +44 -44
  603. package/lib/engine-components/webxr/WebXRImageTracking.d.ts +86 -86
  604. package/lib/engine-components/webxr/WebXRImageTracking.js +470 -470
  605. package/lib/engine-components/webxr/WebXRPlaneTracking.d.ts +92 -92
  606. package/lib/engine-components/webxr/WebXRPlaneTracking.js +500 -500
  607. package/lib/engine-components/webxr/WebXRRig.d.ts +32 -32
  608. package/lib/engine-components/webxr/WebXRRig.js +72 -72
  609. package/lib/engine-components/webxr/XRFlag.d.ts +38 -38
  610. package/lib/engine-components/webxr/XRFlag.js +139 -139
  611. package/lib/engine-components/webxr/controllers/XRControllerFollow.d.ts +47 -47
  612. package/lib/engine-components/webxr/controllers/XRControllerFollow.js +120 -120
  613. package/lib/engine-components/webxr/controllers/XRControllerModel.d.ts +43 -43
  614. package/lib/engine-components/webxr/controllers/XRControllerModel.js +351 -351
  615. package/lib/engine-components/webxr/controllers/XRControllerMovement.d.ts +78 -78
  616. package/lib/engine-components/webxr/controllers/XRControllerMovement.js +506 -506
  617. package/lib/engine-components/webxr/index.d.ts +3 -3
  618. package/lib/engine-components/webxr/index.js +3 -3
  619. package/lib/engine-components/webxr/types.d.ts +3 -3
  620. package/lib/engine-components/webxr/types.js +1 -1
  621. package/lib/engine-components-experimental/Presentation.d.ts +6 -6
  622. package/lib/engine-components-experimental/Presentation.js +9 -9
  623. package/lib/engine-components-experimental/api.d.ts +4 -4
  624. package/lib/engine-components-experimental/api.js +4 -4
  625. package/lib/engine-components-experimental/networking/PlayerSync.d.ts +156 -156
  626. package/lib/engine-components-experimental/networking/PlayerSync.js +377 -377
  627. package/lib/engine-schemes/api.d.ts +12 -12
  628. package/lib/engine-schemes/api.js +12 -12
  629. package/lib/engine-schemes/schemes.d.ts +7 -7
  630. package/lib/engine-schemes/schemes.js +19 -19
  631. package/lib/engine-schemes/synced-camera-model.d.ts +25 -25
  632. package/lib/engine-schemes/synced-camera-model.js +67 -67
  633. package/lib/engine-schemes/synced-transform-model.d.ts +31 -31
  634. package/lib/engine-schemes/synced-transform-model.js +66 -66
  635. package/lib/engine-schemes/transform.d.ts +12 -12
  636. package/lib/engine-schemes/transform.js +39 -39
  637. package/lib/engine-schemes/vec2.d.ts +10 -10
  638. package/lib/engine-schemes/vec2.js +25 -25
  639. package/lib/engine-schemes/vec3.d.ts +11 -11
  640. package/lib/engine-schemes/vec3.js +29 -29
  641. package/lib/engine-schemes/vec4.d.ts +12 -12
  642. package/lib/engine-schemes/vec4.js +33 -33
  643. package/lib/engine-schemes/vr-user-state-buffer.d.ts +37 -37
  644. package/lib/engine-schemes/vr-user-state-buffer.js +110 -110
  645. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.d.ts +6 -6
  646. package/lib/include/three/EXT_mesh_gpu_instancing_exporter.js +45 -45
  647. package/lib/needle-engine.d.ts +7 -7
  648. package/lib/needle-engine.js +64 -64
  649. package/package.json +1 -1
  650. package/plugins/common/buildinfo.js +64 -63
  651. package/plugins/common/config.cjs +31 -31
  652. package/plugins/common/config.js +35 -35
  653. package/plugins/common/files.js +31 -31
  654. package/plugins/common/generator.js +10 -10
  655. package/plugins/common/license.js +249 -224
  656. package/plugins/common/npm.js +15 -15
  657. package/plugins/common/timers.js +7 -7
  658. package/plugins/common/version.js +37 -37
  659. package/plugins/gltf-packer.mjs +1 -1
  660. package/plugins/next/alias.cjs +39 -39
  661. package/plugins/next/license.cjs +18 -18
  662. package/plugins/next/meshbvhworker.cjs +18 -18
  663. package/plugins/next/next.js +128 -128
  664. package/plugins/types/index.d.ts +2 -2
  665. package/plugins/types/license.d.ts +24 -24
  666. package/plugins/types/needleConfig.d.ts +27 -27
  667. package/plugins/types/userconfig.d.ts +105 -105
  668. package/plugins/types/webmanifest.d.ts +32 -32
  669. package/plugins/vite/alias.js +174 -174
  670. package/plugins/vite/asap.js +245 -245
  671. package/plugins/vite/build-pipeline.js +354 -354
  672. package/plugins/vite/build.js +19 -19
  673. package/plugins/vite/buildinfo.js +41 -41
  674. package/plugins/vite/config.js +106 -106
  675. package/plugins/vite/copyfiles.js +138 -138
  676. package/plugins/vite/defines.js +66 -66
  677. package/plugins/vite/dependencies.js +213 -213
  678. package/plugins/vite/dependency-watcher.js +231 -231
  679. package/plugins/vite/drop-client.js +76 -76
  680. package/plugins/vite/drop.js +87 -87
  681. package/plugins/vite/editor-connection.js +124 -124
  682. package/plugins/vite/facebook-instant-games.js +99 -99
  683. package/plugins/vite/gzip.js +5 -5
  684. package/plugins/vite/imports-logger.js +143 -143
  685. package/plugins/vite/index.js +139 -139
  686. package/plugins/vite/license.js +55 -55
  687. package/plugins/vite/meta.js +163 -163
  688. package/plugins/vite/npm.js +7 -7
  689. package/plugins/vite/peer.js +29 -29
  690. package/plugins/vite/poster-client.js +73 -73
  691. package/plugins/vite/poster.js +79 -79
  692. package/plugins/vite/pwa.js +604 -604
  693. package/plugins/vite/reload-client.js +15 -15
  694. package/plugins/vite/reload.js +363 -363
  695. package/plugins/vite/server.js +66 -66
  696. package/plugins/vite/transform-codegen.js +55 -55
  697. package/plugins/vite/transform.js +31 -31
  698. package/plugins/vite/vite-4.4-hack.js +31 -31
  699. package/src/asap/needle-asap.ts +111 -111
  700. package/src/asap/sessiongranted.ts +75 -75
  701. package/src/asap/utils.ts +4 -4
  702. package/src/engine/analytics/index.ts +10 -10
  703. package/src/engine/analytics/lcp.ts +35 -35
  704. package/src/engine/api.ts +81 -81
  705. package/src/engine/assets/index.ts +59 -59
  706. package/src/engine/assets/static.js +5 -5
  707. package/src/engine/codegen/register_types.ts +298 -298
  708. package/src/engine/debug/debug.ts +51 -51
  709. package/src/engine/debug/debug_console.ts +333 -333
  710. package/src/engine/debug/debug_overlay.ts +332 -332
  711. package/src/engine/debug/debug_spatial_console.ts +429 -429
  712. package/src/engine/debug/index.ts +1 -1
  713. package/src/engine/engine_addressables.ts +679 -679
  714. package/src/engine/engine_animation.ts +145 -145
  715. package/src/engine/engine_application.ts +113 -113
  716. package/src/engine/engine_assetdatabase.ts +387 -387
  717. package/src/engine/engine_audio.ts +24 -24
  718. package/src/engine/engine_camera.ts +39 -39
  719. package/src/engine/engine_components.ts +373 -373
  720. package/src/engine/engine_components_internal.ts +40 -40
  721. package/src/engine/engine_constants.ts +52 -52
  722. package/src/engine/engine_context.ts +1662 -1662
  723. package/src/engine/engine_context_registry.ts +129 -129
  724. package/src/engine/engine_coroutine.ts +54 -54
  725. package/src/engine/engine_create_objects.ts +398 -398
  726. package/src/engine/engine_default_parameters.ts +3 -3
  727. package/src/engine/engine_editor-sync.ts +28 -28
  728. package/src/engine/engine_element.ts +871 -871
  729. package/src/engine/engine_element_attributes.ts +85 -85
  730. package/src/engine/engine_element_extras.ts +16 -16
  731. package/src/engine/engine_element_loading.ts +381 -381
  732. package/src/engine/engine_element_overlay.ts +186 -186
  733. package/src/engine/engine_fileloader.js +9 -9
  734. package/src/engine/engine_gameobject.ts +684 -684
  735. package/src/engine/engine_generic_utils.js +13 -13
  736. package/src/engine/engine_gizmos.ts +577 -577
  737. package/src/engine/engine_gltf.ts +29 -29
  738. package/src/engine/engine_gltf_builtin_components.ts +403 -403
  739. package/src/engine/engine_hot_reload.ts +198 -198
  740. package/src/engine/engine_input.ts +1460 -1460
  741. package/src/engine/engine_input_utils.ts +23 -23
  742. package/src/engine/engine_instancing.ts +45 -45
  743. package/src/engine/engine_license.ts +329 -329
  744. package/src/engine/engine_lifecycle_api.ts +106 -106
  745. package/src/engine/engine_lifecycle_functions_internal.ts +193 -193
  746. package/src/engine/engine_lightdata.ts +117 -117
  747. package/src/engine/engine_loaders.ts +82 -82
  748. package/src/engine/engine_lods.ts +168 -168
  749. package/src/engine/engine_mainloop_utils.ts +472 -472
  750. package/src/engine/engine_math.ts +282 -282
  751. package/src/engine/engine_modules.ts +83 -83
  752. package/src/engine/engine_networking.ts +841 -841
  753. package/src/engine/engine_networking_auto.ts +352 -352
  754. package/src/engine/engine_networking_blob.ts +254 -254
  755. package/src/engine/engine_networking_files.ts +217 -217
  756. package/src/engine/engine_networking_files_default_components.ts +58 -58
  757. package/src/engine/engine_networking_instantiate.ts +419 -419
  758. package/src/engine/engine_networking_peer.ts +159 -159
  759. package/src/engine/engine_networking_streams.ts +713 -713
  760. package/src/engine/engine_networking_types.ts +24 -24
  761. package/src/engine/engine_networking_utils.ts +23 -23
  762. package/src/engine/engine_networking_websocket.ts +2 -2
  763. package/src/engine/engine_patcher.ts +199 -199
  764. package/src/engine/engine_physics.ts +783 -783
  765. package/src/engine/engine_physics.types.ts +46 -46
  766. package/src/engine/engine_physics_rapier.ts +1579 -1579
  767. package/src/engine/engine_playerview.ts +80 -80
  768. package/src/engine/engine_scenelighting.ts +294 -294
  769. package/src/engine/engine_scenetools.ts +365 -365
  770. package/src/engine/engine_serialization.ts +2 -2
  771. package/src/engine/engine_serialization_builtin_serializer.ts +473 -473
  772. package/src/engine/engine_serialization_core.ts +705 -705
  773. package/src/engine/engine_serialization_decorator.ts +80 -80
  774. package/src/engine/engine_setup.ts +1 -1
  775. package/src/engine/engine_shaders.ts +267 -267
  776. package/src/engine/engine_shims.ts +32 -32
  777. package/src/engine/engine_test_utils.ts +109 -109
  778. package/src/engine/engine_texture.ts +82 -82
  779. package/src/engine/engine_three_utils.ts +849 -849
  780. package/src/engine/engine_time.ts +94 -94
  781. package/src/engine/engine_time_utils.ts +237 -237
  782. package/src/engine/engine_tonemapping.ts +210 -210
  783. package/src/engine/engine_types.ts +714 -714
  784. package/src/engine/engine_typestore.ts +63 -63
  785. package/src/engine/engine_util_decorator.ts +136 -136
  786. package/src/engine/engine_utils.ts +972 -972
  787. package/src/engine/engine_utils_format.ts +212 -212
  788. package/src/engine/engine_utils_screenshot.ts +698 -698
  789. package/src/engine/engine_utils_screenshot.xr.ts +103 -103
  790. package/src/engine/export/gltf/Writers.ts +34 -34
  791. package/src/engine/export/gltf/index.ts +158 -158
  792. package/src/engine/export/index.ts +2 -2
  793. package/src/engine/export/state.ts +19 -19
  794. package/src/engine/export/utils.ts +9 -9
  795. package/src/engine/extensions/EXT_texture_exr.ts +50 -50
  796. package/src/engine/extensions/NEEDLE_animator_controller_model.ts +195 -195
  797. package/src/engine/extensions/NEEDLE_components.ts +268 -268
  798. package/src/engine/extensions/NEEDLE_gameobject_data.ts +81 -81
  799. package/src/engine/extensions/NEEDLE_lighting_settings.ts +185 -185
  800. package/src/engine/extensions/NEEDLE_lightmaps.ts +119 -119
  801. package/src/engine/extensions/NEEDLE_persistent_assets.ts +76 -76
  802. package/src/engine/extensions/NEEDLE_render_objects.ts +209 -209
  803. package/src/engine/extensions/NEEDLE_techniques_webgl.ts +640 -640
  804. package/src/engine/extensions/extension_resolver.ts +4 -4
  805. package/src/engine/extensions/extension_utils.ts +166 -166
  806. package/src/engine/extensions/extensions.ts +135 -135
  807. package/src/engine/extensions/index.ts +5 -5
  808. package/src/engine/extensions/usage_tracker.ts +100 -100
  809. package/src/engine/js-extensions/Camera.ts +37 -37
  810. package/src/engine/js-extensions/ExtensionUtils.ts +85 -85
  811. package/src/engine/js-extensions/Layers.ts +23 -23
  812. package/src/engine/js-extensions/Object3D.ts +296 -296
  813. package/src/engine/js-extensions/RGBAColor.ts +75 -75
  814. package/src/engine/js-extensions/Vector.ts +18 -18
  815. package/src/engine/js-extensions/index.ts +4 -4
  816. package/src/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +122 -122
  817. package/src/engine/shaders/shaderData.ts +67 -67
  818. package/src/engine/tests/test_utils.ts +63 -63
  819. package/src/engine/webcomponents/WebXRButtons.ts +260 -260
  820. package/src/engine/webcomponents/api.ts +6 -6
  821. package/src/engine/webcomponents/buttons.ts +262 -262
  822. package/src/engine/webcomponents/fonts.ts +41 -41
  823. package/src/engine/webcomponents/icons.ts +57 -57
  824. package/src/engine/webcomponents/index.ts +1 -1
  825. package/src/engine/webcomponents/logo-element.ts +78 -78
  826. package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts +573 -573
  827. package/src/engine/webcomponents/needle menu/needle-menu.ts +1107 -1107
  828. package/src/engine/webcomponents/needle-button.ts +181 -181
  829. package/src/engine/xr/NeedleXRController.ts +1126 -1126
  830. package/src/engine/xr/NeedleXRSession.ts +1585 -1585
  831. package/src/engine/xr/NeedleXRSync.ts +220 -220
  832. package/src/engine/xr/SceneTransition.ts +78 -78
  833. package/src/engine/xr/TempXRContext.ts +216 -216
  834. package/src/engine/xr/XRRig.ts +9 -9
  835. package/src/engine/xr/api.ts +5 -5
  836. package/src/engine/xr/events.ts +102 -102
  837. package/src/engine/xr/internal.ts +34 -34
  838. package/src/engine/xr/usdz.ts +30 -30
  839. package/src/engine/xr/utils.ts +39 -39
  840. package/src/engine-components/AlignmentConstraint.ts +36 -36
  841. package/src/engine-components/Animation.ts +557 -557
  842. package/src/engine-components/AnimationCurve.ts +150 -150
  843. package/src/engine-components/AnimationUtils.ts +28 -28
  844. package/src/engine-components/AnimationUtilsAutoplay.ts +43 -43
  845. package/src/engine-components/Animator.ts +397 -397
  846. package/src/engine-components/AnimatorController.ts +1293 -1293
  847. package/src/engine-components/AudioListener.ts +92 -92
  848. package/src/engine-components/AudioSource.ts +639 -639
  849. package/src/engine-components/AvatarLoader.ts +263 -263
  850. package/src/engine-components/AxesHelper.ts +59 -59
  851. package/src/engine-components/BasicIKConstraint.ts +54 -54
  852. package/src/engine-components/BoxCollider.ts +1 -1
  853. package/src/engine-components/BoxHelperComponent.ts +114 -114
  854. package/src/engine-components/Camera.ts +707 -707
  855. package/src/engine-components/CameraUtils.ts +144 -144
  856. package/src/engine-components/CharacterController.ts +253 -253
  857. package/src/engine-components/Collider.ts +374 -374
  858. package/src/engine-components/Component.ts +1294 -1294
  859. package/src/engine-components/ContactShadows.ts +482 -482
  860. package/src/engine-components/DeleteBox.ts +62 -62
  861. package/src/engine-components/DeviceFlag.ts +46 -46
  862. package/src/engine-components/DragControls.ts +1623 -1623
  863. package/src/engine-components/DropListener.ts +698 -698
  864. package/src/engine-components/Duplicatable.ts +198 -198
  865. package/src/engine-components/EventList.ts +266 -266
  866. package/src/engine-components/EventTrigger.ts +74 -74
  867. package/src/engine-components/EventType.ts +22 -22
  868. package/src/engine-components/Fog.ts +60 -60
  869. package/src/engine-components/Gizmos.ts +56 -56
  870. package/src/engine-components/GridHelper.ts +48 -48
  871. package/src/engine-components/GroundProjection.ts +356 -356
  872. package/src/engine-components/Interactable.ts +14 -14
  873. package/src/engine-components/Joints.ts +52 -52
  874. package/src/engine-components/LODGroup.ts +153 -153
  875. package/src/engine-components/Light.ts +558 -558
  876. package/src/engine-components/LookAtConstraint.ts +25 -25
  877. package/src/engine-components/NeedleMenu.ts +84 -84
  878. package/src/engine-components/NestedGltf.ts +86 -86
  879. package/src/engine-components/Networking.ts +114 -114
  880. package/src/engine-components/OffsetConstraint.ts +60 -60
  881. package/src/engine-components/OrbitControls.ts +1068 -1068
  882. package/src/engine-components/PlayerColor.ts +103 -103
  883. package/src/engine-components/ReflectionProbe.ts +209 -209
  884. package/src/engine-components/Renderer.ts +900 -900
  885. package/src/engine-components/RendererInstancing.ts +855 -855
  886. package/src/engine-components/RendererLightmap.ts +198 -198
  887. package/src/engine-components/RigidBody.ts +526 -526
  888. package/src/engine-components/SceneSwitcher.ts +1013 -1013
  889. package/src/engine-components/ScreenCapture.ts +592 -592
  890. package/src/engine-components/ShadowCatcher.ts +172 -172
  891. package/src/engine-components/Skybox.ts +455 -455
  892. package/src/engine-components/SmoothFollow.ts +76 -76
  893. package/src/engine-components/SpatialTrigger.ts +229 -229
  894. package/src/engine-components/SpectatorCamera.ts +787 -787
  895. package/src/engine-components/SphereCollider.ts +1 -1
  896. package/src/engine-components/SpriteRenderer.ts +468 -468
  897. package/src/engine-components/SyncedCamera.ts +220 -220
  898. package/src/engine-components/SyncedRoom.ts +380 -380
  899. package/src/engine-components/SyncedTransform.ts +378 -378
  900. package/src/engine-components/TestRunner.ts +118 -118
  901. package/src/engine-components/TransformGizmo.ts +219 -219
  902. package/src/engine-components/VideoPlayer.ts +1025 -1025
  903. package/src/engine-components/Voip.ts +363 -363
  904. package/src/engine-components/api.ts +60 -60
  905. package/src/engine-components/avatar/AvatarBlink_Simple.ts +69 -69
  906. package/src/engine-components/avatar/AvatarEyeLook_Rotation.ts +63 -63
  907. package/src/engine-components/avatar/Avatar_Brain_LookAt.ts +139 -139
  908. package/src/engine-components/avatar/Avatar_MouthShapes.ts +83 -83
  909. package/src/engine-components/avatar/Avatar_MustacheShake.ts +31 -31
  910. package/src/engine-components/codegen/components.ts +216 -216
  911. package/src/engine-components/debug/LogStats.ts +21 -21
  912. package/src/engine-components/export/gltf/GltfExport.ts +265 -265
  913. package/src/engine-components/export/usdz/Extension.ts +24 -24
  914. package/src/engine-components/export/usdz/ThreeUSDZExporter.ts +2413 -2413
  915. package/src/engine-components/export/usdz/USDZExporter.ts +705 -705
  916. package/src/engine-components/export/usdz/extensions/Animation.ts +1204 -1204
  917. package/src/engine-components/export/usdz/extensions/DocumentExtension.ts +9 -9
  918. package/src/engine-components/export/usdz/extensions/USDZText.ts +240 -240
  919. package/src/engine-components/export/usdz/extensions/USDZUI.ts +189 -189
  920. package/src/engine-components/export/usdz/extensions/behavior/Actions.ts +99 -99
  921. package/src/engine-components/export/usdz/extensions/behavior/AudioExtension.ts +102 -102
  922. package/src/engine-components/export/usdz/extensions/behavior/Behaviour.ts +320 -320
  923. package/src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts +1225 -1225
  924. package/src/engine-components/export/usdz/extensions/behavior/BehavioursBuilder.ts +646 -646
  925. package/src/engine-components/export/usdz/extensions/behavior/PhysicsExtension.ts +132 -132
  926. package/src/engine-components/export/usdz/index.ts +2 -2
  927. package/src/engine-components/export/usdz/utils/animationutils.ts +191 -191
  928. package/src/engine-components/export/usdz/utils/quicklook.ts +50 -50
  929. package/src/engine-components/particlesystem/ParticleSystem.ts +1287 -1287
  930. package/src/engine-components/particlesystem/ParticleSystemModules.ts +1765 -1765
  931. package/src/engine-components/particlesystem/ParticleSystemSubEmitter.ts +111 -111
  932. package/src/engine-components/particlesystem/api.ts +1 -1
  933. package/src/engine-components/postprocessing/Effects/Antialiasing.ts +55 -55
  934. package/src/engine-components/postprocessing/Effects/BloomEffect.ts +116 -116
  935. package/src/engine-components/postprocessing/Effects/ChromaticAberration.ts +37 -37
  936. package/src/engine-components/postprocessing/Effects/ColorAdjustments.ts +95 -95
  937. package/src/engine-components/postprocessing/Effects/DepthOfField.ts +103 -103
  938. package/src/engine-components/postprocessing/Effects/EffectWrapper.ts +25 -25
  939. package/src/engine-components/postprocessing/Effects/Pixelation.ts +32 -32
  940. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion.ts +90 -90
  941. package/src/engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusionN8.ts +191 -191
  942. package/src/engine-components/postprocessing/Effects/Sharpening.ts +138 -138
  943. package/src/engine-components/postprocessing/Effects/TiltShiftEffect.ts +61 -61
  944. package/src/engine-components/postprocessing/Effects/Tonemapping.ts +155 -155
  945. package/src/engine-components/postprocessing/Effects/Vignette.ts +59 -59
  946. package/src/engine-components/postprocessing/PostProcessingEffect.ts +172 -172
  947. package/src/engine-components/postprocessing/PostProcessingHandler.ts +398 -398
  948. package/src/engine-components/postprocessing/Volume.ts +410 -410
  949. package/src/engine-components/postprocessing/VolumeParameter.ts +158 -158
  950. package/src/engine-components/postprocessing/VolumeProfile.ts +61 -61
  951. package/src/engine-components/postprocessing/index.ts +5 -5
  952. package/src/engine-components/postprocessing/utils.ts +52 -52
  953. package/src/engine-components/timeline/PlayableDirector.ts +722 -722
  954. package/src/engine-components/timeline/SignalAsset.ts +144 -144
  955. package/src/engine-components/timeline/TimelineModels.ts +92 -92
  956. package/src/engine-components/timeline/TimelineTracks.ts +967 -967
  957. package/src/engine-components/timeline/index.ts +3 -3
  958. package/src/engine-components/ui/BaseUIComponent.ts +203 -203
  959. package/src/engine-components/ui/Button.ts +307 -307
  960. package/src/engine-components/ui/Canvas.ts +419 -419
  961. package/src/engine-components/ui/CanvasGroup.ts +54 -54
  962. package/src/engine-components/ui/EventSystem.ts +853 -853
  963. package/src/engine-components/ui/Graphic.ts +275 -275
  964. package/src/engine-components/ui/Image.ts +112 -112
  965. package/src/engine-components/ui/InputField.ts +321 -321
  966. package/src/engine-components/ui/Interfaces.ts +57 -57
  967. package/src/engine-components/ui/Layout.ts +334 -334
  968. package/src/engine-components/ui/Outline.ts +13 -13
  969. package/src/engine-components/ui/PointerEvents.ts +206 -206
  970. package/src/engine-components/ui/RaycastUtils.ts +69 -69
  971. package/src/engine-components/ui/Raycaster.ts +102 -102
  972. package/src/engine-components/ui/RectTransform.ts +372 -372
  973. package/src/engine-components/ui/SpatialHtml.ts +79 -79
  974. package/src/engine-components/ui/Text.ts +578 -578
  975. package/src/engine-components/ui/Utils.ts +112 -112
  976. package/src/engine-components/utils/EnvironmentScene.ts +245 -245
  977. package/src/engine-components/utils/LookAt.ts +88 -88
  978. package/src/engine-components/utils/OpenURL.ts +114 -114
  979. package/src/engine-components/webxr/Avatar.ts +265 -265
  980. package/src/engine-components/webxr/TeleportTarget.ts +9 -9
  981. package/src/engine-components/webxr/WebARCameraBackground.ts +175 -175
  982. package/src/engine-components/webxr/WebARSessionRoot.ts +880 -880
  983. package/src/engine-components/webxr/WebXR.ts +585 -585
  984. package/src/engine-components/webxr/WebXRAvatar.ts +66 -66
  985. package/src/engine-components/webxr/WebXRImageTracking.ts +518 -518
  986. package/src/engine-components/webxr/WebXRPlaneTracking.ts +570 -570
  987. package/src/engine-components/webxr/WebXRRig.ts +77 -77
  988. package/src/engine-components/webxr/XRFlag.ts +147 -147
  989. package/src/engine-components/webxr/controllers/XRControllerFollow.ts +118 -118
  990. package/src/engine-components/webxr/controllers/XRControllerModel.ts +374 -374
  991. package/src/engine-components/webxr/controllers/XRControllerMovement.ts +550 -550
  992. package/src/engine-components/webxr/index.ts +2 -2
  993. package/src/engine-components/webxr/types.ts +3 -3
  994. package/src/engine-components-experimental/Presentation.ts +12 -12
  995. package/src/engine-components-experimental/api.ts +4 -4
  996. package/src/engine-components-experimental/networking/PlayerSync.ts +401 -401
  997. package/src/engine-schemes/COMPILE_SCHEMES.bat +3 -3
  998. package/src/engine-schemes/COMPILE_TS.bat +11 -11
  999. package/src/engine-schemes/README.md +1 -1
  1000. package/src/engine-schemes/api.ts +12 -12
  1001. package/src/engine-schemes/schemes.ts +28 -28
  1002. package/src/engine-schemes/synced-camera-model.ts +92 -92
  1003. package/src/engine-schemes/synced-transform-model.ts +90 -90
  1004. package/src/engine-schemes/syncedCamera.fbs +10 -10
  1005. package/src/engine-schemes/transform.ts +50 -50
  1006. package/src/engine-schemes/transforms.fbs +25 -25
  1007. package/src/engine-schemes/vec.fbs +19 -19
  1008. package/src/engine-schemes/vec2.ts +33 -33
  1009. package/src/engine-schemes/vec3.ts +38 -38
  1010. package/src/engine-schemes/vec4.ts +43 -43
  1011. package/src/engine-schemes/vr-user-state-buffer.ts +145 -145
  1012. package/src/engine-schemes/vrUserStateBuffer.fbs +17 -17
  1013. package/src/include/draco/draco_decoder.js +34 -34
  1014. package/src/include/ktx2/basis_transcoder.js +21 -21
  1015. package/src/include/needle/arial-msdf.json +1471 -1471
  1016. package/src/include/three/DragControls.js +231 -231
  1017. package/src/include/three/EXT_mesh_gpu_instancing_exporter.js +66 -66
  1018. package/src/needle-engine.ts +70 -70
  1019. package/lib/engine/engine.d.ts +0 -4
  1020. package/lib/engine/engine.js +0 -12
  1021. package/lib/engine/engine.js.map +0 -1
  1022. package/lib/engine/engine_web_api.d.ts +0 -12
  1023. package/lib/engine/engine_web_api.js +0 -113
  1024. package/lib/engine/engine_web_api.js.map +0 -1
  1025. package/lib/engine-components/FlyControls.d.ts +0 -10
  1026. package/lib/engine-components/FlyControls.js +0 -29
  1027. package/lib/engine-components/FlyControls.js.map +0 -1
  1028. package/src/engine-schemes/dist/api.js +0 -17
  1029. package/src/engine-schemes/dist/api.js.meta +0 -7
  1030. package/src/engine-schemes/dist/schemes.js +0 -25
  1031. package/src/engine-schemes/dist/schemes.js.meta +0 -7
  1032. package/src/engine-schemes/dist/synced-camera-model.js +0 -74
  1033. package/src/engine-schemes/dist/synced-camera-model.js.meta +0 -7
  1034. package/src/engine-schemes/dist/synced-transform-model.js +0 -73
  1035. package/src/engine-schemes/dist/synced-transform-model.js.meta +0 -7
  1036. package/src/engine-schemes/dist/transform.js +0 -46
  1037. package/src/engine-schemes/dist/transform.js.meta +0 -7
  1038. package/src/engine-schemes/dist/vec2.js +0 -32
  1039. package/src/engine-schemes/dist/vec2.js.meta +0 -7
  1040. package/src/engine-schemes/dist/vec3.js +0 -36
  1041. package/src/engine-schemes/dist/vec3.js.meta +0 -7
  1042. package/src/engine-schemes/dist/vec4.js +0 -40
  1043. package/src/engine-schemes/dist/vec4.js.meta +0 -7
  1044. package/src/engine-schemes/dist/vr-user-state-buffer.js +0 -110
  1045. package/src/engine-schemes/dist/vr-user-state-buffer.js.meta +0 -7
@@ -1,368 +1,368 @@
1
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
6
- };
7
- import { isDevEnvironment, showBalloonMessage } from "../../engine/debug/index.js";
8
- import { serializeable } from "../../engine/engine_serialization_decorator.js";
9
- import { DeviceUtilities, getParam } from "../../engine/engine_utils.js";
10
- import { Behaviour } from "../Component.js";
11
- import { EffectWrapper } from "./Effects/EffectWrapper.js";
12
- import { PostProcessingEffect } from "./PostProcessingEffect.js";
13
- import { PostProcessingHandler } from "./PostProcessingHandler.js";
14
- import { setPostprocessingManagerType } from "./utils.js";
15
- import { VolumeParameter } from "./VolumeParameter.js";
16
- import { VolumeProfile } from "./VolumeProfile.js";
17
- const debug = getParam("debugpost");
18
- /** The Volume/PostprocessingManager component is responsible for managing post processing effects.
19
- * Add this component to any object in your scene to enable post processing effects.
20
- *
21
- * @example Add bloom
22
- * ```ts
23
- * const volume = new Volume();
24
- * volume.addEffect(new BloomEffect({
25
- * intensity: 3,
26
- * luminanceThreshold: .2
27
- * }));
28
- * gameObject.addComponent(volume);
29
- * ```
30
- *
31
- * @example Remove bloom
32
- * ```ts
33
- * volume.removeEffect(bloom);
34
- * ```
35
- *
36
- * @example Add pixelation
37
- * ```ts
38
- * const pixelation = new PixelationEffect();
39
- * pixelation.granularity.value = 10;
40
- * volume.addEffect(pixelation);
41
- * ```
42
- *
43
- * @category Rendering
44
- * @category Effects
45
- * @group Components
46
- */
47
- export class Volume extends Behaviour {
48
- get isPostProcessingManager() {
49
- return true;
50
- }
51
- /** Currently active postprocessing effects */
52
- get effects() {
53
- return this._activeEffects;
54
- }
55
- sharedProfile;
56
- /**
57
- * Set multisampling to "auto" to automatically adjust the multisampling level based on performance.
58
- * Set to a number to manually set the multisampling level.
59
- * @default "auto"
60
- * @min 0
61
- * @max renderer.capabilities.maxSamples
62
- */
63
- multisampling = "auto";
64
- /**
65
- * Add a post processing effect to the stack and schedules the effect stack to be re-created.
66
- */
67
- addEffect(effect) {
68
- let entry = effect;
69
- if (!(entry instanceof PostProcessingEffect)) {
70
- entry = new EffectWrapper(entry);
71
- }
72
- if (entry.gameObject === undefined)
73
- this.gameObject.addComponent(entry);
74
- if (this._effects.includes(entry))
75
- return effect;
76
- this._effects.push(entry);
77
- this._isDirty = true;
78
- return effect;
79
- }
80
- /**
81
- * Remove a post processing effect from the stack and schedules the effect stack to be re-created.
82
- */
83
- removeEffect(effect) {
84
- let index = -1;
85
- if (!(effect instanceof PostProcessingEffect)) {
86
- index = this._effects.findIndex(e => e instanceof EffectWrapper && e.effect === effect);
87
- }
88
- else {
89
- index = this._effects.indexOf(effect);
90
- }
91
- if (index !== -1) {
92
- this._effects.splice(index, 1);
93
- this._isDirty = true;
94
- return effect;
95
- }
96
- else if (effect instanceof PostProcessingEffect) {
97
- // if the effect is part of the shared profile remove it from there
98
- const si = this.sharedProfile?.components?.indexOf(effect);
99
- if (si !== undefined && si !== -1) {
100
- this._isDirty = true;
101
- this.sharedProfile?.components?.splice(si, 1);
102
- }
103
- }
104
- return effect;
105
- }
106
- _postprocessing;
107
- _activeEffects = [];
108
- _effects = [];
109
- /**
110
- * When dirty the post processing effects will be re-applied
111
- */
112
- markDirty() {
113
- this._isDirty = true;
114
- }
115
- /** @internal */
116
- awake() {
117
- if (debug) {
118
- console.log("PostprocessingManager Awake", this);
119
- console.log("Press P to toggle post processing");
120
- window.addEventListener("keydown", (e) => {
121
- if (e.key === "p") {
122
- this.enabled = !this.enabled;
123
- showBalloonMessage("Toggle PostProcessing " + this.name + ": Enabled=" + this.enabled);
124
- this.markDirty();
125
- }
126
- });
127
- }
128
- // ensure the profile is initialized
129
- this.sharedProfile?.__init(this);
130
- }
131
- _componentEnabledTime = -1;
132
- _multisampleAutoChangeTime = 0;
133
- _multisampleAutoDecreaseTime = 0;
134
- /** @internal */
135
- onEnable() {
136
- this._componentEnabledTime = this.context.time.realtimeSinceStartup;
137
- this._isDirty = true;
138
- }
139
- /** @internal */
140
- onDisable() {
141
- this._postprocessing?.unapply();
142
- this._isDirty = false;
143
- }
144
- /** @internal */
145
- onBeforeRender() {
146
- if (!this.context.isInXR) {
147
- // TODO: not sure when this was/could be the case? Maybe when using the default three composer?
148
- // if (this.context.composer && (this.context.composer instanceof EffectComposer) === false) {
149
- // if (debug) console.warn("PostProcessing: The current composer is not an EffectComposer - this is not supported");
150
- // return;
151
- // }
152
- // Wait for the first frame to be rendered before creating because then we know we have a camera (issue 135)
153
- if (this.context.mainCamera) {
154
- if (this._isDirty) {
155
- this.apply();
156
- }
157
- }
158
- if (this.context.composer && this._postprocessing && this._postprocessing.composer === this.context.composer) {
159
- if (this.context.renderer.getContext().isContextLost()) {
160
- this.context.renderer.forceContextRestore();
161
- }
162
- if (this.context.composer.getRenderer() !== this.context.renderer)
163
- this.context.composer.setRenderer(this.context.renderer);
164
- this.context.composer.setMainScene(this.context.scene);
165
- const composer = this.context.composer;
166
- if (this.multisampling === "auto") {
167
- const timeSinceLastChange = this.context.time.realtimeSinceStartup - this._multisampleAutoChangeTime;
168
- if (this.context.time.realtimeSinceStartup - this._componentEnabledTime > 2
169
- && timeSinceLastChange > .5) {
170
- const prev = composer.multisampling;
171
- if (composer.multisampling > 0 && this.context.time.smoothedFps <= 50) {
172
- this._multisampleAutoChangeTime = this.context.time.realtimeSinceStartup;
173
- this._multisampleAutoDecreaseTime = this.context.time.realtimeSinceStartup;
174
- composer.multisampling *= .5;
175
- composer.multisampling = Math.floor(composer.multisampling);
176
- if (debug)
177
- console.debug(`[PostProcessing] Reduced multisampling from ${prev} to ${composer.multisampling}`);
178
- }
179
- // if performance is good for a while try increasing multisampling again
180
- else if (timeSinceLastChange > 1
181
- && this.context.time.smoothedFps >= 59
182
- && composer.multisampling < this.context.renderer.capabilities.maxSamples
183
- && this.context.time.realtimeSinceStartup - this._multisampleAutoDecreaseTime > 10) {
184
- this._multisampleAutoChangeTime = this.context.time.realtimeSinceStartup;
185
- composer.multisampling = composer.multisampling <= 0 ? 1 : composer.multisampling * 2;
186
- composer.multisampling = Math.floor(composer.multisampling);
187
- if (debug)
188
- console.debug(`[PostProcessing] Increased multisampling from ${prev} to ${composer.multisampling}`);
189
- }
190
- }
191
- }
192
- else {
193
- composer.multisampling = Math.max(0, Math.min(this.multisampling, this.context.renderer.capabilities.maxSamples));
194
- }
195
- // only set the main camera if any pass has a different camera
196
- // trying to avoid doing this regularly since it involves doing potentially unnecessary work
197
- // https://github.com/pmndrs/postprocessing/blob/3d3df0576b6d49aec9e763262d5a1ff7429fd91a/src/core/EffectComposer.js#L406
198
- if (this.context.mainCamera) {
199
- const passes = this.context.composer.passes;
200
- for (const pass of passes) {
201
- if (pass.mainCamera && pass.mainCamera !== this.context.mainCamera) {
202
- this.context.composer.setMainCamera(this.context.mainCamera);
203
- break;
204
- }
205
- }
206
- }
207
- }
208
- }
209
- }
210
- /** @internal */
211
- onDestroy() {
212
- this._postprocessing?.dispose();
213
- }
214
- _lastApplyTime;
215
- _rapidApplyCount = 0;
216
- _isDirty = false;
217
- apply() {
218
- if (debug)
219
- console.log(`Apply PostProcessing "${this.name}"`);
220
- if (isDevEnvironment()) {
221
- if (this._lastApplyTime !== undefined && Date.now() - this._lastApplyTime < 100) {
222
- this._rapidApplyCount++;
223
- if (this._rapidApplyCount === 5)
224
- console.warn("Detected rapid post processing modifications - this might be a bug", this);
225
- }
226
- this._lastApplyTime = Date.now();
227
- }
228
- this._isDirty = false;
229
- this.unapply();
230
- this._activeEffects.length = 0;
231
- // get from profile
232
- if (this.sharedProfile?.components) {
233
- const comps = this.sharedProfile.components;
234
- for (const effect of comps) {
235
- if (effect.active && effect.enabled && !this._activeEffects.includes(effect))
236
- this._activeEffects.push(effect);
237
- }
238
- }
239
- // add effects registered via code
240
- for (const effect of this._effects) {
241
- if (effect.active && effect.enabled && !this._activeEffects.includes(effect))
242
- this._activeEffects.push(effect);
243
- }
244
- if (this._activeEffects.length > 0) {
245
- if (!this._postprocessing)
246
- this._postprocessing = new PostProcessingHandler(this.context);
247
- this._postprocessing.apply(this._activeEffects)
248
- ?.then(() => {
249
- if (!this.activeAndEnabled)
250
- return;
251
- this._applyPostQueue();
252
- const composer = this._postprocessing?.composer;
253
- if (composer) {
254
- if (this.multisampling === "auto") {
255
- composer.multisampling = DeviceUtilities.isMobileDevice()
256
- ? 2
257
- : 4;
258
- }
259
- else {
260
- composer.multisampling = Math.max(0, Math.min(this.multisampling, this.context.renderer.capabilities.maxSamples));
261
- }
262
- if (debug)
263
- console.debug(`[PostProcessing] Set multisampling to ${composer.multisampling} (Is Mobile: ${DeviceUtilities.isMobileDevice()})`);
264
- }
265
- else if (debug) {
266
- console.warn(`[PostProcessing] No composer found`);
267
- }
268
- });
269
- }
270
- }
271
- unapply() {
272
- this._postprocessing?.unapply();
273
- }
274
- _applyPostQueue() {
275
- if (this._modificationQueue) {
276
- for (const entry of this._modificationQueue.values())
277
- this.onEditorModification(entry);
278
- this._modificationQueue.clear();
279
- }
280
- }
281
- /** called from needle editor sync package if its active */
282
- onEditorModification(modification) {
283
- if (modification.propertyName.startsWith("postprocessing.")) {
284
- if (!this._postprocessing) {
285
- if (!this._modificationQueue)
286
- this._modificationQueue = new Map();
287
- this._modificationQueue.set(modification.propertyName, modification);
288
- return true;
289
- }
290
- if (!this._activeEffects?.length)
291
- return;
292
- const path = modification.propertyName.split(".");
293
- if (path.length === 3 || path.length === 4) {
294
- const componentName = path[1];
295
- const propertyName = path[2];
296
- for (const comp of this._activeEffects) {
297
- if (comp.typeName?.toLowerCase() === componentName.toLowerCase()) {
298
- if (propertyName === "active") {
299
- comp.active = modification.value;
300
- this.scheduleRecreate();
301
- return;
302
- }
303
- // cache the volume parameters
304
- if (!effectVolumeProperties.has(componentName)) {
305
- const volumeParameterKeys = new Array();
306
- effectVolumeProperties.set(componentName, volumeParameterKeys);
307
- const keys = Object.keys(comp);
308
- for (const key of keys) {
309
- const prop = comp[key];
310
- if (prop instanceof VolumeParameter) {
311
- volumeParameterKeys.push(key);
312
- }
313
- }
314
- }
315
- if (effectVolumeProperties.has(componentName)) {
316
- const paramName = propertyName.toLowerCase();
317
- const volumeParameterKeys = effectVolumeProperties.get(componentName);
318
- for (const key of volumeParameterKeys) {
319
- if (key.toLowerCase() === paramName) {
320
- const prop = comp[key];
321
- if (prop instanceof VolumeParameter) {
322
- const isActiveStateChange = path.length === 4 && path[3] === "active";
323
- if (isActiveStateChange) {
324
- prop.overrideState = modification.value;
325
- this.scheduleRecreate();
326
- }
327
- else if (prop && prop.value !== undefined) {
328
- prop.value = modification.value;
329
- }
330
- }
331
- return;
332
- }
333
- }
334
- }
335
- console.warn("Unknown modification", propertyName);
336
- return;
337
- }
338
- }
339
- }
340
- return true;
341
- }
342
- return false;
343
- }
344
- _modificationQueue;
345
- _recreateId = -1;
346
- scheduleRecreate() {
347
- // When the editor modifications come in with changed active effects we want/need to re-create the effects
348
- // We defer it slightly because multiple active changes could be made and we dont want to recreate the full effect stack multiple times
349
- const id = ++this._recreateId;
350
- setTimeout(() => {
351
- if (id !== this._recreateId)
352
- return;
353
- this.onDisable();
354
- this.onEnable();
355
- }, 200);
356
- }
357
- }
358
- __decorate([
359
- serializeable(VolumeProfile)
360
- ], Volume.prototype, "sharedProfile", void 0);
361
- __decorate([
362
- serializeable()
363
- ], Volume.prototype, "multisampling", void 0);
364
- /** cached VolumeParameter keys per object */
365
- const effectVolumeProperties = new Map();
366
- setPostprocessingManagerType(Volume);
367
- export { Volume as PostProcessingManager };
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ import { isDevEnvironment, showBalloonMessage } from "../../engine/debug/index.js";
8
+ import { serializeable } from "../../engine/engine_serialization_decorator.js";
9
+ import { DeviceUtilities, getParam } from "../../engine/engine_utils.js";
10
+ import { Behaviour } from "../Component.js";
11
+ import { EffectWrapper } from "./Effects/EffectWrapper.js";
12
+ import { PostProcessingEffect } from "./PostProcessingEffect.js";
13
+ import { PostProcessingHandler } from "./PostProcessingHandler.js";
14
+ import { setPostprocessingManagerType } from "./utils.js";
15
+ import { VolumeParameter } from "./VolumeParameter.js";
16
+ import { VolumeProfile } from "./VolumeProfile.js";
17
+ const debug = getParam("debugpost");
18
+ /** The Volume/PostprocessingManager component is responsible for managing post processing effects.
19
+ * Add this component to any object in your scene to enable post processing effects.
20
+ *
21
+ * @example Add bloom
22
+ * ```ts
23
+ * const volume = new Volume();
24
+ * volume.addEffect(new BloomEffect({
25
+ * intensity: 3,
26
+ * luminanceThreshold: .2
27
+ * }));
28
+ * gameObject.addComponent(volume);
29
+ * ```
30
+ *
31
+ * @example Remove bloom
32
+ * ```ts
33
+ * volume.removeEffect(bloom);
34
+ * ```
35
+ *
36
+ * @example Add pixelation
37
+ * ```ts
38
+ * const pixelation = new PixelationEffect();
39
+ * pixelation.granularity.value = 10;
40
+ * volume.addEffect(pixelation);
41
+ * ```
42
+ *
43
+ * @category Rendering
44
+ * @category Effects
45
+ * @group Components
46
+ */
47
+ export class Volume extends Behaviour {
48
+ get isPostProcessingManager() {
49
+ return true;
50
+ }
51
+ /** Currently active postprocessing effects */
52
+ get effects() {
53
+ return this._activeEffects;
54
+ }
55
+ sharedProfile;
56
+ /**
57
+ * Set multisampling to "auto" to automatically adjust the multisampling level based on performance.
58
+ * Set to a number to manually set the multisampling level.
59
+ * @default "auto"
60
+ * @min 0
61
+ * @max renderer.capabilities.maxSamples
62
+ */
63
+ multisampling = "auto";
64
+ /**
65
+ * Add a post processing effect to the stack and schedules the effect stack to be re-created.
66
+ */
67
+ addEffect(effect) {
68
+ let entry = effect;
69
+ if (!(entry instanceof PostProcessingEffect)) {
70
+ entry = new EffectWrapper(entry);
71
+ }
72
+ if (entry.gameObject === undefined)
73
+ this.gameObject.addComponent(entry);
74
+ if (this._effects.includes(entry))
75
+ return effect;
76
+ this._effects.push(entry);
77
+ this._isDirty = true;
78
+ return effect;
79
+ }
80
+ /**
81
+ * Remove a post processing effect from the stack and schedules the effect stack to be re-created.
82
+ */
83
+ removeEffect(effect) {
84
+ let index = -1;
85
+ if (!(effect instanceof PostProcessingEffect)) {
86
+ index = this._effects.findIndex(e => e instanceof EffectWrapper && e.effect === effect);
87
+ }
88
+ else {
89
+ index = this._effects.indexOf(effect);
90
+ }
91
+ if (index !== -1) {
92
+ this._effects.splice(index, 1);
93
+ this._isDirty = true;
94
+ return effect;
95
+ }
96
+ else if (effect instanceof PostProcessingEffect) {
97
+ // if the effect is part of the shared profile remove it from there
98
+ const si = this.sharedProfile?.components?.indexOf(effect);
99
+ if (si !== undefined && si !== -1) {
100
+ this._isDirty = true;
101
+ this.sharedProfile?.components?.splice(si, 1);
102
+ }
103
+ }
104
+ return effect;
105
+ }
106
+ _postprocessing;
107
+ _activeEffects = [];
108
+ _effects = [];
109
+ /**
110
+ * When dirty the post processing effects will be re-applied
111
+ */
112
+ markDirty() {
113
+ this._isDirty = true;
114
+ }
115
+ /** @internal */
116
+ awake() {
117
+ if (debug) {
118
+ console.log("PostprocessingManager Awake", this);
119
+ console.log("Press P to toggle post processing");
120
+ window.addEventListener("keydown", (e) => {
121
+ if (e.key === "p") {
122
+ this.enabled = !this.enabled;
123
+ showBalloonMessage("Toggle PostProcessing " + this.name + ": Enabled=" + this.enabled);
124
+ this.markDirty();
125
+ }
126
+ });
127
+ }
128
+ // ensure the profile is initialized
129
+ this.sharedProfile?.__init(this);
130
+ }
131
+ _componentEnabledTime = -1;
132
+ _multisampleAutoChangeTime = 0;
133
+ _multisampleAutoDecreaseTime = 0;
134
+ /** @internal */
135
+ onEnable() {
136
+ this._componentEnabledTime = this.context.time.realtimeSinceStartup;
137
+ this._isDirty = true;
138
+ }
139
+ /** @internal */
140
+ onDisable() {
141
+ this._postprocessing?.unapply();
142
+ this._isDirty = false;
143
+ }
144
+ /** @internal */
145
+ onBeforeRender() {
146
+ if (!this.context.isInXR) {
147
+ // TODO: not sure when this was/could be the case? Maybe when using the default three composer?
148
+ // if (this.context.composer && (this.context.composer instanceof EffectComposer) === false) {
149
+ // if (debug) console.warn("PostProcessing: The current composer is not an EffectComposer - this is not supported");
150
+ // return;
151
+ // }
152
+ // Wait for the first frame to be rendered before creating because then we know we have a camera (issue 135)
153
+ if (this.context.mainCamera) {
154
+ if (this._isDirty) {
155
+ this.apply();
156
+ }
157
+ }
158
+ if (this.context.composer && this._postprocessing && this._postprocessing.composer === this.context.composer) {
159
+ if (this.context.renderer.getContext().isContextLost()) {
160
+ this.context.renderer.forceContextRestore();
161
+ }
162
+ if (this.context.composer.getRenderer() !== this.context.renderer)
163
+ this.context.composer.setRenderer(this.context.renderer);
164
+ this.context.composer.setMainScene(this.context.scene);
165
+ const composer = this.context.composer;
166
+ if (this.multisampling === "auto") {
167
+ const timeSinceLastChange = this.context.time.realtimeSinceStartup - this._multisampleAutoChangeTime;
168
+ if (this.context.time.realtimeSinceStartup - this._componentEnabledTime > 2
169
+ && timeSinceLastChange > .5) {
170
+ const prev = composer.multisampling;
171
+ if (composer.multisampling > 0 && this.context.time.smoothedFps <= 50) {
172
+ this._multisampleAutoChangeTime = this.context.time.realtimeSinceStartup;
173
+ this._multisampleAutoDecreaseTime = this.context.time.realtimeSinceStartup;
174
+ composer.multisampling *= .5;
175
+ composer.multisampling = Math.floor(composer.multisampling);
176
+ if (debug)
177
+ console.debug(`[PostProcessing] Reduced multisampling from ${prev} to ${composer.multisampling}`);
178
+ }
179
+ // if performance is good for a while try increasing multisampling again
180
+ else if (timeSinceLastChange > 1
181
+ && this.context.time.smoothedFps >= 59
182
+ && composer.multisampling < this.context.renderer.capabilities.maxSamples
183
+ && this.context.time.realtimeSinceStartup - this._multisampleAutoDecreaseTime > 10) {
184
+ this._multisampleAutoChangeTime = this.context.time.realtimeSinceStartup;
185
+ composer.multisampling = composer.multisampling <= 0 ? 1 : composer.multisampling * 2;
186
+ composer.multisampling = Math.floor(composer.multisampling);
187
+ if (debug)
188
+ console.debug(`[PostProcessing] Increased multisampling from ${prev} to ${composer.multisampling}`);
189
+ }
190
+ }
191
+ }
192
+ else {
193
+ composer.multisampling = Math.max(0, Math.min(this.multisampling, this.context.renderer.capabilities.maxSamples));
194
+ }
195
+ // only set the main camera if any pass has a different camera
196
+ // trying to avoid doing this regularly since it involves doing potentially unnecessary work
197
+ // https://github.com/pmndrs/postprocessing/blob/3d3df0576b6d49aec9e763262d5a1ff7429fd91a/src/core/EffectComposer.js#L406
198
+ if (this.context.mainCamera) {
199
+ const passes = this.context.composer.passes;
200
+ for (const pass of passes) {
201
+ if (pass.mainCamera && pass.mainCamera !== this.context.mainCamera) {
202
+ this.context.composer.setMainCamera(this.context.mainCamera);
203
+ break;
204
+ }
205
+ }
206
+ }
207
+ }
208
+ }
209
+ }
210
+ /** @internal */
211
+ onDestroy() {
212
+ this._postprocessing?.dispose();
213
+ }
214
+ _lastApplyTime;
215
+ _rapidApplyCount = 0;
216
+ _isDirty = false;
217
+ apply() {
218
+ if (debug)
219
+ console.log(`Apply PostProcessing "${this.name}"`);
220
+ if (isDevEnvironment()) {
221
+ if (this._lastApplyTime !== undefined && Date.now() - this._lastApplyTime < 100) {
222
+ this._rapidApplyCount++;
223
+ if (this._rapidApplyCount === 5)
224
+ console.warn("Detected rapid post processing modifications - this might be a bug", this);
225
+ }
226
+ this._lastApplyTime = Date.now();
227
+ }
228
+ this._isDirty = false;
229
+ this.unapply();
230
+ this._activeEffects.length = 0;
231
+ // get from profile
232
+ if (this.sharedProfile?.components) {
233
+ const comps = this.sharedProfile.components;
234
+ for (const effect of comps) {
235
+ if (effect.active && effect.enabled && !this._activeEffects.includes(effect))
236
+ this._activeEffects.push(effect);
237
+ }
238
+ }
239
+ // add effects registered via code
240
+ for (const effect of this._effects) {
241
+ if (effect.active && effect.enabled && !this._activeEffects.includes(effect))
242
+ this._activeEffects.push(effect);
243
+ }
244
+ if (this._activeEffects.length > 0) {
245
+ if (!this._postprocessing)
246
+ this._postprocessing = new PostProcessingHandler(this.context);
247
+ this._postprocessing.apply(this._activeEffects)
248
+ ?.then(() => {
249
+ if (!this.activeAndEnabled)
250
+ return;
251
+ this._applyPostQueue();
252
+ const composer = this._postprocessing?.composer;
253
+ if (composer) {
254
+ if (this.multisampling === "auto") {
255
+ composer.multisampling = DeviceUtilities.isMobileDevice()
256
+ ? 2
257
+ : 4;
258
+ }
259
+ else {
260
+ composer.multisampling = Math.max(0, Math.min(this.multisampling, this.context.renderer.capabilities.maxSamples));
261
+ }
262
+ if (debug)
263
+ console.debug(`[PostProcessing] Set multisampling to ${composer.multisampling} (Is Mobile: ${DeviceUtilities.isMobileDevice()})`);
264
+ }
265
+ else if (debug) {
266
+ console.warn(`[PostProcessing] No composer found`);
267
+ }
268
+ });
269
+ }
270
+ }
271
+ unapply() {
272
+ this._postprocessing?.unapply();
273
+ }
274
+ _applyPostQueue() {
275
+ if (this._modificationQueue) {
276
+ for (const entry of this._modificationQueue.values())
277
+ this.onEditorModification(entry);
278
+ this._modificationQueue.clear();
279
+ }
280
+ }
281
+ /** called from needle editor sync package if its active */
282
+ onEditorModification(modification) {
283
+ if (modification.propertyName.startsWith("postprocessing.")) {
284
+ if (!this._postprocessing) {
285
+ if (!this._modificationQueue)
286
+ this._modificationQueue = new Map();
287
+ this._modificationQueue.set(modification.propertyName, modification);
288
+ return true;
289
+ }
290
+ if (!this._activeEffects?.length)
291
+ return;
292
+ const path = modification.propertyName.split(".");
293
+ if (path.length === 3 || path.length === 4) {
294
+ const componentName = path[1];
295
+ const propertyName = path[2];
296
+ for (const comp of this._activeEffects) {
297
+ if (comp.typeName?.toLowerCase() === componentName.toLowerCase()) {
298
+ if (propertyName === "active") {
299
+ comp.active = modification.value;
300
+ this.scheduleRecreate();
301
+ return;
302
+ }
303
+ // cache the volume parameters
304
+ if (!effectVolumeProperties.has(componentName)) {
305
+ const volumeParameterKeys = new Array();
306
+ effectVolumeProperties.set(componentName, volumeParameterKeys);
307
+ const keys = Object.keys(comp);
308
+ for (const key of keys) {
309
+ const prop = comp[key];
310
+ if (prop instanceof VolumeParameter) {
311
+ volumeParameterKeys.push(key);
312
+ }
313
+ }
314
+ }
315
+ if (effectVolumeProperties.has(componentName)) {
316
+ const paramName = propertyName.toLowerCase();
317
+ const volumeParameterKeys = effectVolumeProperties.get(componentName);
318
+ for (const key of volumeParameterKeys) {
319
+ if (key.toLowerCase() === paramName) {
320
+ const prop = comp[key];
321
+ if (prop instanceof VolumeParameter) {
322
+ const isActiveStateChange = path.length === 4 && path[3] === "active";
323
+ if (isActiveStateChange) {
324
+ prop.overrideState = modification.value;
325
+ this.scheduleRecreate();
326
+ }
327
+ else if (prop && prop.value !== undefined) {
328
+ prop.value = modification.value;
329
+ }
330
+ }
331
+ return;
332
+ }
333
+ }
334
+ }
335
+ console.warn("Unknown modification", propertyName);
336
+ return;
337
+ }
338
+ }
339
+ }
340
+ return true;
341
+ }
342
+ return false;
343
+ }
344
+ _modificationQueue;
345
+ _recreateId = -1;
346
+ scheduleRecreate() {
347
+ // When the editor modifications come in with changed active effects we want/need to re-create the effects
348
+ // We defer it slightly because multiple active changes could be made and we dont want to recreate the full effect stack multiple times
349
+ const id = ++this._recreateId;
350
+ setTimeout(() => {
351
+ if (id !== this._recreateId)
352
+ return;
353
+ this.onDisable();
354
+ this.onEnable();
355
+ }, 200);
356
+ }
357
+ }
358
+ __decorate([
359
+ serializeable(VolumeProfile)
360
+ ], Volume.prototype, "sharedProfile", void 0);
361
+ __decorate([
362
+ serializeable()
363
+ ], Volume.prototype, "multisampling", void 0);
364
+ /** cached VolumeParameter keys per object */
365
+ const effectVolumeProperties = new Map();
366
+ setPostprocessingManagerType(Volume);
367
+ export { Volume as PostProcessingManager };
368
368
  //# sourceMappingURL=Volume.js.map