@needle-tools/engine 5.1.0-canary.db0c38f → 5.1.0-canary.e7c2511

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 (303) hide show
  1. package/.needle/generated/needle-bindings.gen.d.ts +5 -0
  2. package/CHANGELOG.md +52 -0
  3. package/components.needle.json +1 -1
  4. package/dist/{needle-engine.bundle-B29kieh0.js → needle-engine.bundle-D-eWNCu1.js} +12287 -11802
  5. package/dist/needle-engine.bundle-D3ZUII8o.min.js +1733 -0
  6. package/dist/needle-engine.bundle-_rOpvUGL.umd.cjs +1733 -0
  7. package/dist/needle-engine.d.ts +833 -231
  8. package/dist/needle-engine.js +584 -582
  9. package/dist/needle-engine.min.js +1 -1
  10. package/dist/needle-engine.umd.cjs +1 -1
  11. package/lib/engine/api.d.ts +6 -1
  12. package/lib/engine/api.js +4 -0
  13. package/lib/engine/api.js.map +1 -1
  14. package/lib/engine/codegen/register_types.js +2 -10
  15. package/lib/engine/codegen/register_types.js.map +1 -1
  16. package/lib/engine/debug/debug_spatial_console.d.ts +2 -0
  17. package/lib/engine/debug/debug_spatial_console.js +10 -7
  18. package/lib/engine/debug/debug_spatial_console.js.map +1 -1
  19. package/lib/engine/engine_addressables.d.ts +2 -0
  20. package/lib/engine/engine_addressables.js +6 -3
  21. package/lib/engine/engine_addressables.js.map +1 -1
  22. package/lib/engine/engine_audio.d.ts +68 -0
  23. package/lib/engine/engine_audio.js +172 -0
  24. package/lib/engine/engine_audio.js.map +1 -1
  25. package/lib/engine/engine_components.js +1 -1
  26. package/lib/engine/engine_components.js.map +1 -1
  27. package/lib/engine/engine_context.d.ts +21 -20
  28. package/lib/engine/engine_context.js +27 -16
  29. package/lib/engine/engine_context.js.map +1 -1
  30. package/lib/engine/engine_disposable.d.ts +171 -0
  31. package/lib/engine/engine_disposable.js +136 -0
  32. package/lib/engine/engine_disposable.js.map +1 -0
  33. package/lib/engine/engine_gameobject.d.ts +1 -10
  34. package/lib/engine/engine_gameobject.js +22 -120
  35. package/lib/engine/engine_gameobject.js.map +1 -1
  36. package/lib/engine/engine_gltf_builtin_components.js +7 -69
  37. package/lib/engine/engine_gltf_builtin_components.js.map +1 -1
  38. package/lib/engine/engine_init.js +16 -1
  39. package/lib/engine/engine_init.js.map +1 -1
  40. package/lib/engine/engine_input.d.ts +1 -1
  41. package/lib/engine/engine_input.js +1 -1
  42. package/lib/engine/engine_input.js.map +1 -1
  43. package/lib/engine/engine_instantiate_resolve.d.ts +42 -0
  44. package/lib/engine/engine_instantiate_resolve.js +372 -0
  45. package/lib/engine/engine_instantiate_resolve.js.map +1 -0
  46. package/lib/engine/engine_license.d.ts +2 -0
  47. package/lib/engine/engine_license.js +14 -6
  48. package/lib/engine/engine_license.js.map +1 -1
  49. package/lib/engine/engine_lifecycle_functions_internal.js +5 -0
  50. package/lib/engine/engine_lifecycle_functions_internal.js.map +1 -1
  51. package/lib/engine/engine_mainloop_utils.js +5 -2
  52. package/lib/engine/engine_mainloop_utils.js.map +1 -1
  53. package/lib/engine/engine_networking.js +3 -1
  54. package/lib/engine/engine_networking.js.map +1 -1
  55. package/lib/engine/engine_networking_blob.js +1 -1
  56. package/lib/engine/engine_networking_blob.js.map +1 -1
  57. package/lib/engine/engine_physics_rapier.d.ts +11 -3
  58. package/lib/engine/engine_physics_rapier.js +88 -25
  59. package/lib/engine/engine_physics_rapier.js.map +1 -1
  60. package/lib/engine/engine_pmrem.js +2 -2
  61. package/lib/engine/engine_pmrem.js.map +1 -1
  62. package/lib/engine/engine_scenedata.d.ts +13 -17
  63. package/lib/engine/engine_scenedata.js +58 -31
  64. package/lib/engine/engine_scenedata.js.map +1 -1
  65. package/lib/engine/engine_serialization_builtin_serializer.d.ts +10 -16
  66. package/lib/engine/engine_serialization_builtin_serializer.js +56 -46
  67. package/lib/engine/engine_serialization_builtin_serializer.js.map +1 -1
  68. package/lib/engine/engine_serialization_core.d.ts +1 -0
  69. package/lib/engine/engine_serialization_core.js +7 -0
  70. package/lib/engine/engine_serialization_core.js.map +1 -1
  71. package/lib/engine/engine_ssr.d.ts +2 -0
  72. package/lib/engine/engine_ssr.js +20 -0
  73. package/lib/engine/engine_ssr.js.map +1 -1
  74. package/lib/engine/engine_types.d.ts +19 -9
  75. package/lib/engine/engine_types.js +1 -1
  76. package/lib/engine/engine_types.js.map +1 -1
  77. package/lib/engine/engine_util_decorator.js +7 -2
  78. package/lib/engine/engine_util_decorator.js.map +1 -1
  79. package/lib/engine/engine_utils.d.ts +1 -1
  80. package/lib/engine/engine_utils.js +19 -5
  81. package/lib/engine/engine_utils.js.map +1 -1
  82. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +1 -1
  83. package/lib/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js.map +1 -1
  84. package/lib/engine/webcomponents/jsx.d.ts +51 -0
  85. package/lib/engine/webcomponents/logo-element.js.map +1 -1
  86. package/lib/engine/webcomponents/needle menu/needle-menu.d.ts +3 -4
  87. package/lib/engine/webcomponents/needle menu/needle-menu.js +1 -1
  88. package/lib/engine/webcomponents/needle menu/needle-menu.js.map +1 -1
  89. package/lib/engine/webcomponents/needle-button.js.map +1 -1
  90. package/lib/engine/webcomponents/needle-engine.d.ts +10 -4
  91. package/lib/engine/webcomponents/needle-engine.js +1 -1
  92. package/lib/engine/webcomponents/needle-engine.js.map +1 -1
  93. package/lib/engine/xr/NeedleXRSession.d.ts +3 -2
  94. package/lib/engine/xr/NeedleXRSession.js +50 -14
  95. package/lib/engine/xr/NeedleXRSession.js.map +1 -1
  96. package/lib/engine/xr/events.d.ts +1 -1
  97. package/lib/engine/xr/events.js.map +1 -1
  98. package/lib/engine-components/Animation.js +17 -16
  99. package/lib/engine-components/Animation.js.map +1 -1
  100. package/lib/engine-components/Animator.d.ts +6 -0
  101. package/lib/engine-components/Animator.js +17 -12
  102. package/lib/engine-components/Animator.js.map +1 -1
  103. package/lib/engine-components/AnimatorController.builder.d.ts +113 -0
  104. package/lib/engine-components/AnimatorController.builder.js +195 -0
  105. package/lib/engine-components/AnimatorController.builder.js.map +1 -0
  106. package/lib/engine-components/AnimatorController.d.ts +4 -119
  107. package/lib/engine-components/AnimatorController.js +35 -233
  108. package/lib/engine-components/AnimatorController.js.map +1 -1
  109. package/lib/engine-components/AudioSource.d.ts +19 -3
  110. package/lib/engine-components/AudioSource.js +121 -68
  111. package/lib/engine-components/AudioSource.js.map +1 -1
  112. package/lib/engine-components/Collider.d.ts +18 -9
  113. package/lib/engine-components/Collider.js +61 -14
  114. package/lib/engine-components/Collider.js.map +1 -1
  115. package/lib/engine-components/Component.d.ts +58 -6
  116. package/lib/engine-components/Component.js +77 -0
  117. package/lib/engine-components/Component.js.map +1 -1
  118. package/lib/engine-components/DragControls.d.ts +7 -0
  119. package/lib/engine-components/DragControls.js +19 -7
  120. package/lib/engine-components/DragControls.js.map +1 -1
  121. package/lib/engine-components/EventList.d.ts +31 -9
  122. package/lib/engine-components/EventList.js +37 -76
  123. package/lib/engine-components/EventList.js.map +1 -1
  124. package/lib/engine-components/Joints.d.ts +4 -2
  125. package/lib/engine-components/Joints.js +19 -3
  126. package/lib/engine-components/Joints.js.map +1 -1
  127. package/lib/engine-components/Light.d.ts +6 -8
  128. package/lib/engine-components/Light.js +48 -27
  129. package/lib/engine-components/Light.js.map +1 -1
  130. package/lib/engine-components/Networking.d.ts +1 -1
  131. package/lib/engine-components/Networking.js +1 -1
  132. package/lib/engine-components/OrbitControls.js +16 -11
  133. package/lib/engine-components/OrbitControls.js.map +1 -1
  134. package/lib/engine-components/ReflectionProbe.js +2 -0
  135. package/lib/engine-components/ReflectionProbe.js.map +1 -1
  136. package/lib/engine-components/RigidBody.d.ts +12 -4
  137. package/lib/engine-components/RigidBody.js +18 -4
  138. package/lib/engine-components/RigidBody.js.map +1 -1
  139. package/lib/engine-components/SeeThrough.js +2 -2
  140. package/lib/engine-components/SeeThrough.js.map +1 -1
  141. package/lib/engine-components/api.d.ts +1 -1
  142. package/lib/engine-components/api.js +1 -1
  143. package/lib/engine-components/api.js.map +1 -1
  144. package/lib/engine-components/codegen/components.d.ts +3 -9
  145. package/lib/engine-components/codegen/components.js +3 -9
  146. package/lib/engine-components/codegen/components.js.map +1 -1
  147. package/lib/engine-components/postprocessing/Effects/Tonemapping.utils.d.ts +1 -1
  148. package/lib/engine-components/postprocessing/VolumeParameter.d.ts +2 -0
  149. package/lib/engine-components/postprocessing/VolumeParameter.js +4 -1
  150. package/lib/engine-components/postprocessing/VolumeParameter.js.map +1 -1
  151. package/lib/engine-components/timeline/PlayableDirector.d.ts +16 -6
  152. package/lib/engine-components/timeline/PlayableDirector.js +63 -61
  153. package/lib/engine-components/timeline/PlayableDirector.js.map +1 -1
  154. package/lib/engine-components/timeline/SignalAsset.d.ts +3 -1
  155. package/lib/engine-components/timeline/SignalAsset.js +1 -0
  156. package/lib/engine-components/timeline/SignalAsset.js.map +1 -1
  157. package/lib/engine-components/timeline/TimelineBuilder.d.ts +247 -0
  158. package/lib/engine-components/timeline/TimelineBuilder.js +400 -0
  159. package/lib/engine-components/timeline/TimelineBuilder.js.map +1 -0
  160. package/lib/engine-components/timeline/TimelineModels.d.ts +2 -1
  161. package/lib/engine-components/timeline/TimelineModels.js +3 -0
  162. package/lib/engine-components/timeline/TimelineModels.js.map +1 -1
  163. package/lib/engine-components/timeline/TimelineTracks.d.ts +23 -0
  164. package/lib/engine-components/timeline/TimelineTracks.js +71 -13
  165. package/lib/engine-components/timeline/TimelineTracks.js.map +1 -1
  166. package/lib/engine-components/timeline/index.d.ts +2 -1
  167. package/lib/engine-components/timeline/index.js +2 -0
  168. package/lib/engine-components/timeline/index.js.map +1 -1
  169. package/lib/engine-components/ui/Canvas.d.ts +1 -1
  170. package/lib/engine-components/ui/Canvas.js +2 -8
  171. package/lib/engine-components/ui/Canvas.js.map +1 -1
  172. package/lib/engine-components/ui/Text.d.ts +1 -0
  173. package/lib/engine-components/ui/Text.js +10 -7
  174. package/lib/engine-components/ui/Text.js.map +1 -1
  175. package/lib/engine-components/web/CursorFollow.js +21 -12
  176. package/lib/engine-components/web/CursorFollow.js.map +1 -1
  177. package/lib/engine-components/webxr/WebXRImageTracking.js +4 -0
  178. package/lib/engine-components/webxr/WebXRImageTracking.js.map +1 -1
  179. package/lib/needle-engine.d.ts +2 -0
  180. package/lib/needle-engine.js +2 -0
  181. package/lib/needle-engine.js.map +1 -1
  182. package/package.json +4 -84
  183. package/plugins/common/worker.js +9 -4
  184. package/plugins/dts-generator/dts.codegen.js +255 -50
  185. package/plugins/dts-generator/dts.scan.js +37 -9
  186. package/plugins/dts-generator/dts.writer.js +1 -1
  187. package/plugins/dts-generator/glb.discovery.js +140 -23
  188. package/plugins/dts-generator/glb.extractor.js +48 -8
  189. package/plugins/dts-generator/glb.reader.js +80 -27
  190. package/plugins/dts-generator/index.js +1 -1
  191. package/plugins/types/needle-bindings.d.ts +25 -14
  192. package/plugins/types/userconfig.d.ts +12 -0
  193. package/plugins/vite/asap.js +18 -9
  194. package/plugins/vite/dependencies.js +29 -0
  195. package/plugins/vite/dependency-watcher.d.ts +2 -2
  196. package/plugins/vite/dependency-watcher.js +5 -6
  197. package/plugins/vite/drop.d.ts +2 -2
  198. package/plugins/vite/drop.js +3 -4
  199. package/plugins/vite/dts-generator.d.ts +2 -2
  200. package/plugins/vite/dts-generator.js +43 -9
  201. package/plugins/vite/editor-connection.js +3 -3
  202. package/plugins/vite/index.d.ts +9 -3
  203. package/plugins/vite/index.js +23 -10
  204. package/plugins/vite/local-files-core.js +3 -3
  205. package/plugins/vite/local-files-utils.d.ts +3 -1
  206. package/plugins/vite/local-files-utils.js +29 -5
  207. package/plugins/vite/meta.js +4 -2
  208. package/plugins/vite/poster.d.ts +2 -2
  209. package/plugins/vite/poster.js +3 -5
  210. package/plugins/vite/reload.d.ts +2 -2
  211. package/plugins/vite/reload.js +23 -23
  212. package/plugins/vite/server.js +2 -1
  213. package/src/engine/api.ts +8 -1
  214. package/src/engine/codegen/register_types.ts +2 -10
  215. package/src/engine/debug/debug_spatial_console.ts +10 -7
  216. package/src/engine/engine_addressables.ts +6 -3
  217. package/src/engine/engine_audio.ts +184 -0
  218. package/src/engine/engine_components.ts +1 -1
  219. package/src/engine/engine_context.ts +36 -22
  220. package/src/engine/engine_disposable.ts +213 -0
  221. package/src/engine/engine_gameobject.ts +54 -159
  222. package/src/engine/engine_gltf_builtin_components.ts +7 -76
  223. package/src/engine/engine_init.ts +15 -1
  224. package/src/engine/engine_input.ts +1 -1
  225. package/src/engine/engine_instantiate_resolve.ts +407 -0
  226. package/src/engine/engine_license.ts +12 -10
  227. package/src/engine/engine_lifecycle_functions_internal.ts +7 -0
  228. package/src/engine/engine_mainloop_utils.ts +5 -2
  229. package/src/engine/engine_networking.ts +3 -1
  230. package/src/engine/engine_networking_blob.ts +1 -1
  231. package/src/engine/engine_physics_rapier.ts +82 -27
  232. package/src/engine/engine_pmrem.ts +3 -3
  233. package/src/engine/engine_scenedata.ts +56 -30
  234. package/src/engine/engine_serialization_builtin_serializer.ts +64 -52
  235. package/src/engine/engine_serialization_core.ts +9 -0
  236. package/src/engine/engine_ssr.ts +29 -3
  237. package/src/engine/engine_types.ts +24 -13
  238. package/src/engine/engine_util_decorator.ts +7 -2
  239. package/src/engine/engine_utils.ts +16 -5
  240. package/src/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js +1 -1
  241. package/src/engine/webcomponents/jsx.d.ts +51 -0
  242. package/src/engine/webcomponents/logo-element.ts +1 -0
  243. package/src/engine/webcomponents/needle menu/needle-menu.ts +3 -2
  244. package/src/engine/webcomponents/needle-button.ts +1 -0
  245. package/src/engine/webcomponents/needle-engine.ts +11 -4
  246. package/src/engine/xr/NeedleXRSession.ts +48 -13
  247. package/src/engine/xr/events.ts +1 -1
  248. package/src/engine-components/Animation.ts +19 -16
  249. package/src/engine-components/Animator.ts +18 -11
  250. package/src/engine-components/AnimatorController.builder.ts +261 -0
  251. package/src/engine-components/AnimatorController.ts +23 -292
  252. package/src/engine-components/AudioSource.ts +130 -79
  253. package/src/engine-components/Collider.ts +66 -18
  254. package/src/engine-components/Component.ts +79 -9
  255. package/src/engine-components/DragControls.ts +18 -11
  256. package/src/engine-components/EventList.ts +45 -83
  257. package/src/engine-components/Joints.ts +20 -4
  258. package/src/engine-components/Light.ts +49 -27
  259. package/src/engine-components/Networking.ts +1 -1
  260. package/src/engine-components/OrbitControls.ts +18 -9
  261. package/src/engine-components/ReflectionProbe.ts +2 -0
  262. package/src/engine-components/RigidBody.ts +18 -4
  263. package/src/engine-components/SeeThrough.ts +2 -2
  264. package/src/engine-components/api.ts +1 -1
  265. package/src/engine-components/codegen/components.ts +3 -9
  266. package/src/engine-components/postprocessing/VolumeParameter.ts +4 -1
  267. package/src/engine-components/timeline/PlayableDirector.ts +61 -64
  268. package/src/engine-components/timeline/SignalAsset.ts +4 -1
  269. package/src/engine-components/timeline/TimelineBuilder.ts +565 -0
  270. package/src/engine-components/timeline/TimelineModels.ts +5 -1
  271. package/src/engine-components/timeline/TimelineTracks.ts +74 -13
  272. package/src/engine-components/timeline/index.ts +2 -1
  273. package/src/engine-components/ui/Canvas.ts +2 -8
  274. package/src/engine-components/ui/Text.ts +12 -8
  275. package/src/engine-components/web/CursorFollow.ts +21 -13
  276. package/src/engine-components/webxr/WebXRImageTracking.ts +2 -0
  277. package/src/needle-engine.ts +3 -0
  278. package/dist/needle-engine.bundle-Dq0Ly8fW.umd.cjs +0 -1732
  279. package/dist/needle-engine.bundle-YnpzzOPL.min.js +0 -1732
  280. package/lib/engine-components/AvatarLoader.d.ts +0 -80
  281. package/lib/engine-components/AvatarLoader.js +0 -232
  282. package/lib/engine-components/AvatarLoader.js.map +0 -1
  283. package/lib/engine-components/avatar/AvatarBlink_Simple.d.ts +0 -11
  284. package/lib/engine-components/avatar/AvatarBlink_Simple.js +0 -77
  285. package/lib/engine-components/avatar/AvatarBlink_Simple.js.map +0 -1
  286. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.d.ts +0 -14
  287. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.js +0 -69
  288. package/lib/engine-components/avatar/AvatarEyeLook_Rotation.js.map +0 -1
  289. package/lib/engine-components/avatar/Avatar_Brain_LookAt.d.ts +0 -29
  290. package/lib/engine-components/avatar/Avatar_Brain_LookAt.js +0 -122
  291. package/lib/engine-components/avatar/Avatar_Brain_LookAt.js.map +0 -1
  292. package/lib/engine-components/avatar/Avatar_MouthShapes.d.ts +0 -15
  293. package/lib/engine-components/avatar/Avatar_MouthShapes.js +0 -80
  294. package/lib/engine-components/avatar/Avatar_MouthShapes.js.map +0 -1
  295. package/lib/engine-components/avatar/Avatar_MustacheShake.d.ts +0 -9
  296. package/lib/engine-components/avatar/Avatar_MustacheShake.js +0 -30
  297. package/lib/engine-components/avatar/Avatar_MustacheShake.js.map +0 -1
  298. package/src/engine-components/AvatarLoader.ts +0 -264
  299. package/src/engine-components/avatar/AvatarBlink_Simple.ts +0 -70
  300. package/src/engine-components/avatar/AvatarEyeLook_Rotation.ts +0 -64
  301. package/src/engine-components/avatar/Avatar_Brain_LookAt.ts +0 -140
  302. package/src/engine-components/avatar/Avatar_MouthShapes.ts +0 -84
  303. package/src/engine-components/avatar/Avatar_MustacheShake.ts +0 -32
@@ -5,7 +5,6 @@ import { type GLTF as THREE_GLTF } from "three/examples/jsm/loaders/GLTFLoader.j
5
5
 
6
6
  import type { Camera as CameraComponent } from "../engine-components/api.js";
7
7
  import type { Context } from "./engine_context.js";
8
- import { InstantiateContext } from "./engine_gameobject.js";
9
8
  import { CollisionDetectionMode, type PhysicsMaterial, RigidbodyConstraints } from "./engine_physics.types.js";
10
9
  import { CircularBuffer } from "./engine_utils.js";
11
10
  import type { NeedleXRSession } from "./engine_xr.js";
@@ -201,8 +200,6 @@ export interface IComponent extends IHasGuid {
201
200
  __internalDisable(isAddingOrRemovingFromScene?: boolean);
202
201
  /** @internal */
203
202
  __internalDestroy();
204
- /** @internal */
205
- resolveGuids?(guidsMap: GuidsMap): void;
206
203
 
207
204
  /** experimental, called when the script is registered for the first time, this is called even if the component is not enabled. */
208
205
  registering?();
@@ -240,14 +237,14 @@ export interface IComponent extends IHasGuid {
240
237
  }
241
238
 
242
239
  export function isComponent(obj: any): obj is IComponent {
243
- return obj && obj.isComponent;
240
+ return obj && typeof obj === "object" && obj.isComponent;
244
241
  }
245
242
 
246
243
  export type ICamera = CameraComponent;
247
244
 
248
245
  export type IAnimationComponent = Pick<IComponent, "gameObject"> & {
249
246
  isAnimationComponent: boolean;
250
- addClip?(clip: AnimationClip);
247
+ addClip?(clip: AnimationClip): void;
251
248
  }
252
249
 
253
250
  /** Interface for a camera controller component that can be attached to a camera to control it */
@@ -258,6 +255,8 @@ export declare interface ICameraController {
258
255
  export declare interface ILight extends IComponent {
259
256
  intensity: number;
260
257
  color: Color;
258
+ /** The type of light as a lowercase string: `"directional"`, `"point"`, `"spot"` */
259
+ readonly type: "directional" | "point" | "spot";
261
260
  }
262
261
 
263
262
  export declare interface ISharedMaterials {
@@ -272,7 +271,10 @@ export declare interface IRenderer extends IComponent {
272
271
 
273
272
  export declare interface IEventList {
274
273
  readonly isEventList: true;
275
- __internalOnInstantiate(map: InstantiateContext): IEventList;
274
+ }
275
+
276
+ export declare interface ISignalReceiver {
277
+ readonly isSignalReceiver: true;
276
278
  }
277
279
 
278
280
  // export declare interface IPhysicsComponent extends IComponent {
@@ -300,12 +302,18 @@ export declare interface ICollider extends IComponent {
300
302
  * Default: [0]
301
303
  */
302
304
  membership?: number[];
303
- /** The collider filter indicates what groups the collider can interact with (e.g. group 3 and 4)
304
- * An `undefined` array indicates that the collider can interact with all groups
305
- * Note: Make sure to call updateProperties after having changed this property
305
+ /** The collider filter indicates what groups the collider can interact with (e.g. group 3 and 4)
306
+ * An `undefined` array indicates that the collider can interact with all groups
307
+ * Note: Make sure to call updateProperties after having changed this property
306
308
  * Default: undefined
307
309
  */
308
310
  filter?: number[];
311
+ /** The density of the collider used for automatic mass calculation.
312
+ * When the attached Rigidbody has `autoMass` enabled, the mass is computed as `density × volume`.
313
+ * Note: Make sure to call updateProperties after having changed this property
314
+ * Default: undefined (uses physics engine default of 1.0)
315
+ */
316
+ density?: number;
309
317
  }
310
318
 
311
319
  export declare interface ISphereCollider extends ICollider {
@@ -473,8 +481,10 @@ export interface IPhysicsEngine {
473
481
  postStep();
474
482
  /** Indicates whether the physics engine is currently updating */
475
483
  get isUpdating(): boolean;
476
- /** Clears all cached data (e.g., mesh data when creating scaled mesh colliders) */
477
- clearCaches();
484
+ /** Tears down the physics world and frees all resources. The world will be re-created on next use. */
485
+ dispose(): void;
486
+ /** @deprecated Use {@link dispose} instead. */
487
+ clearCaches(): void;
478
488
 
479
489
  /** Enables or disables the physics engine */
480
490
  enabled: boolean;
@@ -736,8 +746,9 @@ export interface IPhysicsEngine {
736
746
  getBody(obj: ICollider | IRigidbody): null | any;
737
747
 
738
748
  // Joints
739
- addFixedJoint(body1: IRigidbody, body2: IRigidbody);
740
- addHingeJoint(body1: IRigidbody, body2: IRigidbody, anchor: Vec3, axis: Vec3);
749
+ addFixedJoint(body1: IRigidbody, body2: IRigidbody): Promise<any> | any;
750
+ addHingeJoint(body1: IRigidbody, body2: IRigidbody, anchor: Vec3, axis: Vec3): Promise<any> | any;
751
+ removeJoint(joint: any): void;
741
752
 
742
753
  /** Enable to render collider shapes */
743
754
  debugRenderColliders: boolean;
@@ -79,8 +79,12 @@ function createPropertyWrapper(target: IComponent | any, _propertyKey: string |
79
79
  return;
80
80
  }
81
81
 
82
- // only build wrapper once per type
83
- if (this[$prop] === undefined) {
82
+ // Only install the getter/setter once per instance.
83
+ // processStart may call __internalAwake again for components that were inactive
84
+ // during processNewScripts — the base Component.__internalAwake has a __didAwake guard
85
+ // but this decorator wrapper runs before reaching it, so we need our own idempotency check.
86
+ const desc = Object.getOwnPropertyDescriptor(this, propertyKey);
87
+ if (!desc || !desc.get) {
84
88
 
85
89
  // make sure the field is initialized in a hidden property
86
90
  this[$prop] = this[propertyKey];
@@ -99,6 +103,7 @@ function createPropertyWrapper(target: IComponent | any, _propertyKey: string |
99
103
  }
100
104
 
101
105
  Object.defineProperty(this, propertyKey, {
106
+ configurable: true,
102
107
  set: function (v) {
103
108
  if (this[$isAssigningProperties] === true) {
104
109
  this[$prop] = v;
@@ -279,24 +279,35 @@ declare type deepClonePredicate = (owner: any, propertyName: string, current: an
279
279
  * return true;
280
280
  * });
281
281
  * */
282
- export function deepClone(obj: any, predicate?: deepClonePredicate): any {
282
+ export function deepClone(obj: any, predicate?: deepClonePredicate, _visited?: WeakSet<object>): any {
283
283
  if (obj !== null && obj !== undefined && typeof obj === "object") {
284
+ if (!_visited) _visited = new WeakSet();
285
+ if (_visited.has(obj)) return obj;
286
+ _visited.add(obj);
287
+
284
288
  let clone;
285
289
  if (Array.isArray(obj)) clone = [];
286
290
  else {
287
- clone = Object.create(obj);
288
- Object.assign(clone, obj);
291
+ clone = Object.create(Object.getPrototypeOf(obj));
292
+ // Copy own properties, skipping getter-only properties that can't be set
293
+ const descriptors = Object.getOwnPropertyDescriptors(obj);
294
+ for (const key in descriptors) {
295
+ const desc = descriptors[key];
296
+ if (desc.set || desc.writable !== false) {
297
+ try { clone[key] = obj[key]; }
298
+ catch { /* skip read-only properties */ }
299
+ }
300
+ }
289
301
  }
290
302
  for (const key of Object.keys(obj)) {
291
303
  const val = obj[key];
292
304
  if (predicate && !predicate(obj, key, val)) {
293
- // console.log("SKIP", val);
294
305
  clone[key] = val;
295
306
  }
296
307
  else if (val?.clone !== undefined && typeof val.clone === "function")
297
308
  clone[key] = val.clone();
298
309
  else
299
- clone[key] = deepClone(val, predicate);
310
+ clone[key] = deepClone(val, predicate, _visited);
300
311
  }
301
312
  return clone;
302
313
  }
@@ -35,7 +35,7 @@ export class GenerateMeshBVHWorker extends WorkerBase {
35
35
 
36
36
  worker.onerror = e => {
37
37
 
38
- reject(new Error(`[GenerateMeshBVHWorker] ${e.message || "Unknown error. Please check the server console. If you're using vite try adding 'three-mesh-bvh' to 'optimizeDeps.exclude' in your vite.config.js"}`));
38
+ reject(new Error(`[GenerateMeshBVHWorker] ${e.message || "Could not load worker."}`));
39
39
 
40
40
  };
41
41
 
@@ -0,0 +1,51 @@
1
+ /**
2
+ * JSX IntrinsicElements declarations for Needle Engine web components.
3
+ *
4
+ * Covers both the global JSX namespace (Preact, SolidJS, Svelte, vanilla TS)
5
+ * and React's module-scoped JSX namespace (react-jsx / react-jsxdev transform).
6
+ *
7
+ * IMPORTANT: This file must be a module (has a top-level import/export) so that
8
+ * `declare module "react"` is treated as a *module augmentation* (merging into
9
+ * the existing React types) rather than an *ambient module declaration* (which
10
+ * would shadow/replace @types/react).
11
+ */
12
+
13
+ import type { NeedleEngineAttributes } from "./needle-engine.js";
14
+
15
+ interface NeedleButtonJSXAttributes extends Partial<Omit<HTMLElement, "style" | "children">> {
16
+ style?: Partial<CSSStyleDeclaration>;
17
+ ar?: boolean | string;
18
+ vr?: boolean | string;
19
+ quicklook?: boolean | string;
20
+ qrcode?: boolean | string;
21
+ unstyled?: boolean | string;
22
+ }
23
+
24
+ interface NeedleMenuJSXAttributes extends Partial<Omit<HTMLElement, "style" | "children">> {
25
+ style?: Partial<CSSStyleDeclaration>;
26
+ }
27
+
28
+ interface NeedleLogoElementJSXAttributes extends Partial<Omit<HTMLElement, "style" | "children">> {
29
+ style?: Partial<CSSStyleDeclaration>;
30
+ }
31
+
32
+ interface NeedleElements {
33
+ "needle-engine": Partial<NeedleEngineAttributes>;
34
+ "needle-button": NeedleButtonJSXAttributes;
35
+ "needle-menu": NeedleMenuJSXAttributes;
36
+ "needle-logo-element": NeedleLogoElementJSXAttributes;
37
+ }
38
+
39
+ // Global JSX namespace — Preact, SolidJS, Svelte, vanilla TS
40
+ declare global {
41
+ namespace JSX {
42
+ interface IntrinsicElements extends NeedleElements {}
43
+ }
44
+ }
45
+
46
+ // React module-scoped JSX namespace (module augmentation, not ambient declaration)
47
+ declare module "react" {
48
+ namespace JSX {
49
+ interface IntrinsicElements extends NeedleElements {}
50
+ }
51
+ }
@@ -3,6 +3,7 @@ import { HTMLElementBase } from "../engine_ssr.js";
3
3
 
4
4
  const elementName = "needle-logo-element";
5
5
 
6
+ // NOTE: keep JSX attributes in sync with ./jsx.d.ts
6
7
  declare global {
7
8
  interface HTMLElementTagNameMap {
8
9
  "needle-logo-element": NeedleLogoElement;
@@ -1,8 +1,8 @@
1
1
  import { showBalloonMessage } from "../../debug/debug.js";
2
- import { HTMLElementBase } from "../../engine_ssr.js";
3
2
  import type { Context } from "../../engine_context.js";
4
3
  import { hasCommercialLicense, onLicenseCheckResultChanged, Telemetry } from "../../engine_license.js";
5
4
  import { isLocalNetwork } from "../../engine_networking_utils.js";
5
+ import { HTMLElementBase } from "../../engine_ssr.js";
6
6
  import { DeviceUtilities, getParam } from "../../engine_utils.js";
7
7
  import { onXRSessionStart, XRSessionEventArgs } from "../../xr/events.js";
8
8
  import { ButtonsFactory } from "../buttons.js";
@@ -12,9 +12,10 @@ import { NeedleLogoElement } from "../logo-element.js";
12
12
  import { getElementPriority, setElementPriority as _setElementPriority } from "./menu-priority.js";
13
13
  import { NeedleSpatialMenu } from "./needle-menu-spatial.js";
14
14
 
15
+ // NOTE: keep JSX attributes in sync with ../jsx.d.ts
15
16
  declare global {
16
17
  interface HTMLElementTagNameMap {
17
- "needle-logo-element": NeedleLogoElement;
18
+ "needle-menu": NeedleMenuElement;
18
19
  }
19
20
  }
20
21
 
@@ -4,6 +4,7 @@ import { ButtonsFactory } from "./buttons.js";
4
4
  import { iconFontUrl, loadFont } from "./fonts.js";
5
5
  import { WebXRButtonFactory } from "./WebXRButtons.js";
6
6
 
7
+ // NOTE: keep JSX attributes in sync with ./jsx.d.ts
7
8
  declare global {
8
9
  interface HTMLElementTagNameMap {
9
10
  "needle-button": NeedleButtonElement;
@@ -1,11 +1,11 @@
1
1
  import { isDevEnvironment, showBalloonWarning } from "../debug/index.js";
2
- import { HTMLElementBase } from "../engine_ssr.js";
3
2
  import { PUBLIC_KEY, VERSION } from "../engine_constants.js";
4
3
  import { ContextEvent, ContextRegistry } from "../engine_context_registry.js";
5
4
  import { hasCommercialLicense } from "../engine_license.js";
6
5
  import { onStart } from "../engine_lifecycle_api.js";
7
6
  import { setDracoDecoderPath, setDracoDecoderType, setKtx2TranscoderPath } from "../engine_loaders.gltf.js";
8
7
  import { Context, ContextCreateArgs } from "../engine_setup.js";
8
+ import { HTMLElementBase } from "../engine_ssr.js";
9
9
  import { nameToThreeTonemapping } from "../engine_tonemapping.js";
10
10
  import { type INeedleEngineComponent, type LoadedModel } from "../engine_types.js";
11
11
  import type { addAttributeChangeCallback } from "../engine_utils.js";
@@ -17,6 +17,7 @@ import { arContainerClassName, AROverlayHandler } from "./needle-engine.ar-overl
17
17
  import type { registerObservableAttribute } from "./needle-engine.extras.js";
18
18
  import { calculateProgress01, EngineLoadingView, type ILoadingViewHandler } from "./needle-engine.loading.js";
19
19
 
20
+ // NOTE: keep JSX attributes in sync with ./jsx.d.ts
20
21
  declare global {
21
22
  interface HTMLElementTagNameMap {
22
23
  "needle-engine": NeedleEngineWebComponent;
@@ -41,11 +42,17 @@ export interface NeedleEngineAttributes {
41
42
  'hash': string;
42
43
  /** Set to automatically add OrbitControls to the loaded scene. */
43
44
  'camera-controls': string;
44
- /** Override the default draco decoder path location. */
45
+ /** Override the default Draco decoder/decompressor path. Can be a URL or a local path to a directory containing the Draco decoder files.
46
+ * @default "https://www.gstatic.com/draco/versioned/decoders/1.5.7/"
47
+ * @example <needle-engine dracoDecoderPath="./decoders/draco/"></needle-engine>
48
+ */
45
49
  'dracoDecoderPath': string;
46
- /** Override the default draco library type. */
50
+ /** Override the default Draco decoder type. */
47
51
  'dracoDecoderType': 'wasm' | 'js';
48
- /** Override the default KTX2 transcoder/decoder path. */
52
+ /** Override the default KTX2 transcoder/decoder path. Can be a URL or a local path to a directory containing the KTX2 transcoder files.
53
+ * @default "https://cdn.needle.tools/static/three/0.179.1/basis2/"
54
+ * @example <needle-engine ktx2DecoderPath="./decoders/ktx2/"></needle-engine>
55
+ */
49
56
  'ktx2DecoderPath': string;
50
57
  /** Prevent context from being disposed when element is removed from DOM. */
51
58
  'keep-alive': 'true' | 'false';
@@ -840,15 +840,16 @@ export class NeedleXRSession implements INeedleXRSession {
840
840
  get viewerPose(): XRViewerPose | undefined { return this._viewerPose; }
841
841
 
842
842
 
843
- /** @returns `true` if any image is currently being tracked */
844
- /** returns true if images are currently being tracked */
843
+ /** @returns `true` if any image is currently being tracked or emulated */
845
844
  get isTrackingImages() {
846
845
  if (this.frame && "getImageTrackingResults" in this.frame && typeof this.frame.getImageTrackingResults === "function") {
847
846
  try {
848
847
  const trackingResult = this.frame.getImageTrackingResults();
849
848
  for (const result of trackingResult) {
850
849
  const state = result.trackingState;
851
- if (state === "tracked") return true;
850
+ if (state === "tracked" || state === "emulated") {
851
+ return true;
852
+ }
852
853
  }
853
854
  }
854
855
  catch {
@@ -1053,6 +1054,8 @@ export class NeedleXRSession implements INeedleXRSession {
1053
1054
  private readonly _xr_update_scripts: INeedleXRSessionEventReceiver[] = [];
1054
1055
  /** scripts that are in the scene but inactive (e.g. disabled parent gameObject) */
1055
1056
  private readonly _inactive_scripts: INeedleXRSessionEventReceiver[] = [];
1057
+ /** tracks scripts that have received onEnterXR — prevents spurious onLeaveXR calls */
1058
+ private readonly _scripts_in_xr = new Set<INeedleXRSessionEventReceiver>();
1056
1059
  private readonly _controllerAdded: ControllerChangedEvt[];
1057
1060
  private readonly _controllerRemoved: ControllerChangedEvt[];
1058
1061
  private readonly _originalCameraWorldPosition?: Vector3 | null;
@@ -1163,7 +1166,18 @@ export class NeedleXRSession implements INeedleXRSession {
1163
1166
  // we set the session on the webxr manager at the end because we want to receive inputsource events first
1164
1167
  // e.g. in case there's a bug in the threejs codebase
1165
1168
  this.context.xr = this;
1166
- this.context.renderer.xr.setSession(this.session).then(this.onRendererSessionSet);
1169
+ this.context.renderer.xr.setSession(this.session).then(this.onRendererSessionSet)
1170
+ .catch(err => {
1171
+ // Workaround for WebXR emulators on localhost: the polyfilled XRSession fails the
1172
+ // native XRWebGLBinding constructor's instanceof check. Retry with layers disabled.
1173
+ // See https://github.com/meta-quest/immersive-web-emulator/issues/80
1174
+ if (isDevEnvironment() && err instanceof TypeError && typeof XRWebGLBinding !== "undefined") {
1175
+ console.error(`XRWebGLBinding failed (${err.message}).\nSee https://github.com/meta-quest/immersive-web-emulator/issues/80`);
1176
+ }
1177
+ else {
1178
+ console.error("renderer.xr.setSession failed:", err);
1179
+ }
1180
+ });
1167
1181
  // disable three.js renderer controller autoUpdate (added in ac67b31e3548386f8a93e23a4176554c92bbd0d9)
1168
1182
  if ("controllerAutoUpdate" in this.context.renderer.xr) {
1169
1183
  console.debug("Disabling three.js controllerAutoUpdate");
@@ -1331,8 +1345,10 @@ export class NeedleXRSession implements INeedleXRSession {
1331
1345
  // even if they might already be destroyed e.g. by the WebXR component (it destroys the default controller scripts)
1332
1346
  // they should still receive this callback to be properly cleaned up
1333
1347
  for (const listener of this._xr_scripts) {
1348
+ this._scripts_in_xr.delete(listener);
1334
1349
  listener?.onLeaveXR?.({ xr: this });
1335
1350
  }
1351
+ this._scripts_in_xr.clear();
1336
1352
 
1337
1353
  this.sync?.onExitXR(this);
1338
1354
 
@@ -1399,10 +1415,17 @@ export class NeedleXRSession implements INeedleXRSession {
1399
1415
  }
1400
1416
 
1401
1417
  // make sure the camera is parented to the active rig
1402
- if (this.rig && this._mainCamera?.gameObject) {
1403
- const currentParent = this._mainCamera?.gameObject?.parent;
1404
- if (currentParent !== this.rig.gameObject) {
1405
- this.rig.gameObject.add(this._mainCamera?.gameObject);
1418
+ // Note: applyCustomForward() inserts _cameraRenderParent between rig and camera,
1419
+ // so the hierarchy is: rig → _cameraRenderParent → camera. We check the effective parent.
1420
+ if (this.rig) {
1421
+ const cameraObject = this._mainCamera?.gameObject ?? this.context.mainCamera;
1422
+ if (cameraObject) {
1423
+ const effectiveParent = cameraObject.parent === this._cameraRenderParent
1424
+ ? this._cameraRenderParent.parent
1425
+ : cameraObject.parent;
1426
+ if (effectiveParent !== this.rig.gameObject) {
1427
+ this.rig.gameObject.add(cameraObject);
1428
+ }
1406
1429
  }
1407
1430
  }
1408
1431
 
@@ -1534,8 +1557,12 @@ export class NeedleXRSession implements INeedleXRSession {
1534
1557
  }
1535
1558
 
1536
1559
  //performance.mark('NeedleXRSession update scripts start');
1537
- // invoke update on all scripts
1538
- for (const script of this._xr_update_scripts) {
1560
+ // check all XR scripts for destroyed or inactive state
1561
+ // this must cover _xr_scripts (not just _xr_update_scripts) so that scripts
1562
+ // without onUpdateXR are also detected as inactive when removed from the scene
1563
+ // iterate backwards since markInactive/removeScript modifies the array
1564
+ for (let i = this._xr_scripts.length - 1; i >= 0; i--) {
1565
+ const script = this._xr_scripts[i];
1539
1566
  if (script.destroyed === true) {
1540
1567
  this._script_to_remove.push(script);
1541
1568
  continue;
@@ -1544,6 +1571,10 @@ export class NeedleXRSession implements INeedleXRSession {
1544
1571
  this.markInactive(script);
1545
1572
  continue;
1546
1573
  }
1574
+ }
1575
+ // invoke update on scripts that have onUpdateXR
1576
+ for (const script of this._xr_update_scripts) {
1577
+ if (script.destroyed || script.activeAndEnabled === false) continue;
1547
1578
  if (script.onUpdateXR) script.onUpdateXR(args);
1548
1579
  }
1549
1580
  //performance.mark('NeedleXRSession update scripts end');
@@ -1666,9 +1697,11 @@ export class NeedleXRSession implements INeedleXRSession {
1666
1697
  const script = this._inactive_scripts[i];
1667
1698
  if (script.activeAndEnabled) {
1668
1699
  this._inactive_scripts.splice(i, 1);
1669
- this.addScript(script);
1670
- this.invokeCallback_EnterXR(script);
1671
- for (const ctrl of this.controllers) this.invokeCallback_ControllerAdded(script, ctrl);
1700
+ // addScript returns false if already re-added (e.g. via new_scripts_xr processing)
1701
+ if (this.addScript(script)) {
1702
+ this.invokeCallback_EnterXR(script);
1703
+ for (const ctrl of this.controllers) this.invokeCallback_ControllerAdded(script, ctrl);
1704
+ }
1672
1705
  }
1673
1706
  }
1674
1707
  }
@@ -1689,6 +1722,7 @@ export class NeedleXRSession implements INeedleXRSession {
1689
1722
  }
1690
1723
 
1691
1724
  private invokeCallback_EnterXR(script: INeedleXRSessionEventReceiver) {
1725
+ this._scripts_in_xr.add(script);
1692
1726
  if (script.onEnterXR) {
1693
1727
  script.onEnterXR({ xr: this });
1694
1728
  }
@@ -1704,6 +1738,7 @@ export class NeedleXRSession implements INeedleXRSession {
1704
1738
  }
1705
1739
  }
1706
1740
  private invokeCallback_LeaveXR(script: INeedleXRSessionEventReceiver) {
1741
+ if (!this._scripts_in_xr.delete(script)) return;
1707
1742
  if (script.onLeaveXR && !script.destroyed) {
1708
1743
  script.onLeaveXR({ xr: this });
1709
1744
  }
@@ -1,5 +1,5 @@
1
- import { NeedleXRSession } from "./NeedleXRSession.js";
2
1
  import type { Context } from "../engine_context.js";
2
+ import { NeedleXRSession } from "./NeedleXRSession.js";
3
3
 
4
4
  export declare type XRSessionEventArgs = { session: NeedleXRSession };
5
5
 
@@ -447,25 +447,13 @@ export class Animation extends Behaviour implements IAnimationComponent {
447
447
 
448
448
  private internalOnPlay(action: AnimationAction, options: PlayOptions): Promise<AnimationAction> {
449
449
  var existing = this.actions.find(a => a === action);
450
- if (existing === action && existing.isRunning() && existing.time < existing.getClip().duration) {
451
- const handle = this.tryFindHandle(action);
452
- if (existing.paused) {
453
- existing.paused = false;
454
- }
455
- if (handle) return handle.waitForFinish();
456
- }
457
450
 
458
- // Assign defaults
459
- if (options.loop === undefined) options.loop = this.loop;
460
- if (options.clampWhenFinished === undefined) options.clampWhenFinished = this.clampWhenFinished;
461
- if (options.minMaxOffsetNormalized === undefined && this.randomStartTime) options.minMaxOffsetNormalized = this.minMaxOffsetNormalized;
462
- if (options.minMaxSpeed === undefined) options.minMaxSpeed = this.minMaxSpeed;
463
-
464
- // Reset currently running animations
451
+ // Stop other animations before the early-return check so exclusive always applies,
452
+ // even when the target animation is already running.
465
453
  const stopOther = options?.exclusive ?? true;
466
454
  if (stopOther) {
467
455
  for (const act of this.actions) {
468
- if (act != existing) {
456
+ if (act !== action) {
469
457
  if (options.fadeDuration) {
470
458
  act.fadeOut(options.fadeDuration);
471
459
  }
@@ -475,6 +463,20 @@ export class Animation extends Behaviour implements IAnimationComponent {
475
463
  }
476
464
  }
477
465
  }
466
+
467
+ if (existing === action && existing.isRunning() && existing.time < existing.getClip().duration) {
468
+ const handle = this.tryFindHandle(action);
469
+ if (existing.paused) {
470
+ existing.paused = false;
471
+ }
472
+ if (handle) return handle.waitForFinish();
473
+ }
474
+
475
+ // Assign defaults
476
+ if (options.loop === undefined) options.loop = this.loop;
477
+ if (options.clampWhenFinished === undefined) options.clampWhenFinished = this.clampWhenFinished;
478
+ if (options.minMaxOffsetNormalized === undefined && this.randomStartTime) options.minMaxOffsetNormalized = this.minMaxOffsetNormalized;
479
+ if (options.minMaxSpeed === undefined) options.minMaxSpeed = this.minMaxSpeed;
478
480
  if (options?.fadeDuration) {
479
481
  action.fadeIn(options.fadeDuration);
480
482
  }
@@ -515,10 +517,11 @@ export class Animation extends Behaviour implements IAnimationComponent {
515
517
 
516
518
  action.paused = false;
517
519
  action.play();
520
+ if (debug) console.log("[Animation] Now Playing", action.getClip().name, action)
521
+
518
522
 
519
523
  window.requestAnimationFrame(() => AnimationUtils.testIfRootCanAnimate(action));
520
524
 
521
- if (debug) console.log("PLAY", action.getClip().name, action)
522
525
  const handle = new AnimationHandle(action, this.mixer!, options, _ => {
523
526
  this._handles.splice(this._handles.indexOf(handle), 1);
524
527
  });
@@ -89,6 +89,15 @@ export class Animator extends Behaviour implements IAnimationComponent {
89
89
  return true;
90
90
  }
91
91
 
92
+ /**
93
+ * The current animator mixer, used for low-level control of animations. Owned by the AnimatorController
94
+ * @returns The current AnimationMixer, or null if no controller is assigned
95
+ * @see AnimatorController.mixer
96
+ */
97
+ get mixer() {
98
+ return this._animatorController?.mixer || null;
99
+ }
100
+
92
101
  /**
93
102
  * When enabled, animation will affect the root transform position and rotation
94
103
  */
@@ -401,17 +410,15 @@ export class Animator extends Behaviour implements IAnimationComponent {
401
410
  initializeRuntimeAnimatorController(force: boolean = false) {
402
411
  const shouldRun = (force || this.runtimeAnimatorController !== this._initializeWithRuntimeAnimatorController);
403
412
  if (this.runtimeAnimatorController && shouldRun) {
404
- const clone = this.runtimeAnimatorController.clone();
405
- this._initializeWithRuntimeAnimatorController = clone;
406
- if (clone) {
407
- console.assert(this.runtimeAnimatorController !== clone);
408
- this.runtimeAnimatorController = clone;
409
- console.assert(this.runtimeAnimatorController === clone);
410
- this.runtimeAnimatorController.bind(this);
411
- this.runtimeAnimatorController.setSpeed(this._speed);
412
- this.runtimeAnimatorController.normalizedStartOffset = this._normalizedStartOffset;
413
- }
414
- else console.warn("Could not clone animator controller", this.runtimeAnimatorController);
413
+ // Create a fresh controller from the (possibly remapped) model.
414
+ // The constructor deep-clones the model, preserving Object3D refs that
415
+ // the resolve system has already remapped to cloned objects.
416
+ const controller = new AnimatorController(this.runtimeAnimatorController.model);
417
+ this.runtimeAnimatorController = controller;
418
+ this._initializeWithRuntimeAnimatorController = controller;
419
+ controller.bind(this);
420
+ controller.setSpeed(this._speed);
421
+ controller.normalizedStartOffset = this._normalizedStartOffset;
415
422
  }
416
423
  }
417
424