@needle-tools/engine 5.1.12 → 5.1.14

package/src/engine/engine_networking_streams.ts

@@ -8,6 +8,7 @@ import { getPeerjsInstance } from "../engine/engine_networking_peer.js";
 import { showBalloonMessage } from "./debug/index.js";
 import { Application } from "./engine_application.js";
 import { Context } from "./engine_context.js";
+import { ContextEvent, ContextRegistry } from "./engine_context_registry.js";
 import type { IModel } from "./engine_networking_types.js";
 import { type IComponent, isComponent } from "./engine_types.js";
 import { getParam } from "./engine_utils.js";
@@ -121,17 +122,31 @@ function applySdpTransform(sdp) {
 
 export class PeerHandle extends EventDispatcher<any> {
 
-    private static readonly instances: Map<string, PeerHandle> = new Map();
+    // Weak ownership prevents this cache from rooting a context and its scene indefinitely.
+    // IDs are scoped to contexts: separate engine elements may use the same stream ID.
+    private static readonly instances = new WeakMap<Context, Map<string, PeerHandle>>();
+
+    static {
+        ContextRegistry.registerCallback(ContextEvent.ContextDestroying, ({ context }) => {
+            const handles = PeerHandle.instances.get(context as Context);
+            if (!handles) return;
+            PeerHandle.instances.delete(context as Context);
+            for (const handle of handles.values()) handle.dispose();
+            handles.clear();
+        });
+    }
 
     static getOrCreate(context: Context, guid: string): PeerHandle {
-        // if (id === undefined) {
-        //     // randomId
-        //     id = Math.random().toFixed(5);
-        // }
-        if (PeerHandle.instances.has(guid))
-            return PeerHandle.instances.get(guid)!;
-        const peer = new PeerHandle(context, guid);
-        PeerHandle.instances.set(guid, peer);
+        let handles = PeerHandle.instances.get(context);
+        if (!handles) {
+            handles = new Map();
+            PeerHandle.instances.set(context, handles);
+        }
+        let peer = handles.get(guid);
+        if (!peer) {
+            peer = new PeerHandle(context, guid);
+            handles.set(guid, peer);
+        }
         return peer;
     }
 
@@ -151,6 +166,7 @@ export class PeerHandle extends EventDispatcher<any> {
     }
 
     makeCall(peerId: string, stream: MediaStream): CallHandle | undefined {
+        if (this._disposed) return undefined;
         if (!stream?.id) {
             if (debug) console.warn("Can not make a call: mediastream has no id or is undefined");
             else console.debug("Can not make a call: mediastream has no id or is undefined");
@@ -179,10 +195,8 @@ export class PeerHandle extends EventDispatcher<any> {
     }
 
     closeAll() {
-        for (const call of this._incomingCalls) {
-            call.close();
-        }
-        for (const call of this._outgoingCalls) {
+        // Closing a call synchronously removes it from the original array.
+        for (const call of [...this._incomingCalls, ...this._outgoingCalls]) {
             call.close();
         }
         this.updateCalls();
@@ -253,6 +267,23 @@ export class PeerHandle extends EventDispatcher<any> {
         }
     }
 
+    private _disposed = false;
+    private readonly _callIntervals = new Set<ReturnType<typeof setInterval>>();
+
+    private dispose() {
+        if (this._disposed) return;
+        this._disposed = true;
+        this.disable();
+        this.unsubscribePeerEvents();
+        for (const interval of this._callIntervals) clearInterval(interval);
+        this._callIntervals.clear();
+        this.closeAll();
+        this._incomingCalls.length = 0;
+        this._outgoingCalls.length = 0;
+        this._peer?.destroy();
+        this._peer = undefined;
+    }
+
     private _enabled: boolean = false;
     private _enabledPeer: boolean = false;
     private onConnectRoomFn: () => void = this.onConnectRoom.bind(this);
@@ -262,7 +293,7 @@ export class PeerHandle extends EventDispatcher<any> {
     // private _connectionPeerIdMap : Map<string, string> = new Map();
 
     enable() {
-        if (this._enabled) return;
+        if (this._disposed || this._enabled) return;
         this._enabled = true;
         this.context.connection.beginListen(RoomEvents.JoinedRoom, this.onConnectRoomFn);
         // this.context.connection.beginListen(RoomEvents.UserJoinedRoom, this.onUserJoinedOrLeftRoomFn);
@@ -287,13 +318,19 @@ export class PeerHandle extends EventDispatcher<any> {
     // };
 
     private async setupPeer() {
-        if (!this.context.connection.connectionId) return;
+        if (this._disposed || !this.context.connection.connectionId) return;
         if (this._enabledPeer) return;
         this._enabledPeer = true;
         if (!this._peer) {
             const peerId = this.getMyPeerId();
-            if (peerId)
-                this._peer = await getPeerjsInstance(peerId);
+            if (peerId) {
+                const peer = await getPeerjsInstance(peerId);
+                if (this._disposed) {
+                    peer.destroy();
+                    return;
+                }
+                this._peer = peer;
+            }
             else console.error("Failed to setup peerjs because we dont have a connection id", this.context.connection.connectionId);
         }
         if (this._enabled)
@@ -415,6 +452,7 @@ export class PeerHandle extends EventDispatcher<any> {
             });
 
             call.on("stream", () => {
+                if (this._disposed) return;
                 if (debug) console.log("Received stream for call", call.metadata);
                 // workaround for https://github.com/peers/peerjs/issues/636
                 let intervalCounter = 0;
@@ -424,9 +462,15 @@ export class PeerHandle extends EventDispatcher<any> {
                         if (debug) console.warn("Close call because stream is not active", call.metadata);
                         intervalCounter += 1;
                         clearInterval(closeInterval);
+                        this._callIntervals.delete(closeInterval);
                         handle.close();
                     }
                 }, 2000);
+                this._callIntervals.add(closeInterval);
+                call.on("close", () => {
+                    clearInterval(closeInterval);
+                    this._callIntervals.delete(closeInterval);
+                });
             });
         }
         return handle;

package/src/engine/engine_utils_qrcode.ts

@@ -4,7 +4,7 @@ import { Quaternion, Vector2, Vector3, Vector4 } from "three";
 
 import { needleLogoOnlySVG } from "./assets/index.js";
 import { isDevEnvironment } from "./debug/debug.js";
-import { $uxbFepO } from "./engine_license.js";
+import { __alnviAJA } from "./engine_license.js";
 import { InternalAttributeUtils } from "./engine_utils_attributes.js";
 import type { NeedleEngineWebComponent } from "./webcomponents/needle-engine.js";
 
@@ -135,7 +135,7 @@ async function internalRenderQRCodeOverlays(canvas: HTMLCanvasElement, args: { s
         console.debug("[QR Code] No web component found")
     }
 
-    const canUseCustomLogo = $uxbFepO();
+    const canUseCustomLogo = __alnviAJA();
 
     // Query logo src from needle-engine attribute.
     // For any supported attribute it's possible to use "falsey" values (e.g. "0" or "false" to disable the logo in the QR code)

package/src/engine/physics/workers/mesh-bvh/GenerateMeshBVHWorker.js

@@ -121,7 +121,14 @@ export class GenerateMeshBVHWorker extends WorkerBase {
 
 			}, transferable.map( arr => arr.buffer ).filter( v => ( typeof SharedArrayBuffer === 'undefined' ) || ! ( v instanceof SharedArrayBuffer ) ) );
 
-		} );
+		} ).finally( () => {
+
+            // Pooled workers outlive each job. Both handlers capture the job scope,
+            // including its geometry, even after the promise has settled.
+            worker.onmessage = null;
+            worker.onerror = null;
+
+        } );
 
 	}
 

package/src/engine/webcomponents/fonts.ts

@@ -22,7 +22,7 @@ export function loadFont(url: string, opts?: LoadFontOptions) {
         // crossorigin must match the HTML <link> attribute (set by asap.js) so the browser
         // can reuse the cached CORS response instead of making a separate non-CORS request
         fontLink.crossOrigin = "";
-        fontLink.onload = () => { fontLink.rel = "stylesheet"; };
+        fontLink.onload = activateFontStylesheet;
         element.appendChild(fontLink);
         elements.push(fontLink);
     }
@@ -35,9 +35,24 @@ export function loadFont(url: string, opts?: LoadFontOptions) {
             }
         }
     }
+    // The link lives in document.head and can outlive the component using this callback.
+    return () => {
+        if (opts?.loadedCallback) {
+            for (const link of elements) link.removeEventListener("load", opts.loadedCallback);
+        }
+    };
 }
 
 
+// Keep this outside loadFont: its scope includes consumer callbacks and their contexts.
+function activateFontStylesheet(event: Event) {
+    const link = event.currentTarget;
+    if (link instanceof HTMLLinkElement) {
+        link.rel = "stylesheet";
+        link.onload = null;
+    }
+}
+
 /** Ensure the fonts that needle engine uses are loaded */
 export function ensureFonts() {
     loadFont(robotoFlexFontUrl);

package/src/engine/webcomponents/icons.ts

@@ -19,7 +19,15 @@ export function getIconElement(str: string): HTMLElement {
     span.setAttribute("role", "img");
     span.setAttribute("aria-label", str + " icon");
     span.setAttribute("aria-hidden", "true");
+    updateIconWhenFontReady(new WeakRef(span), str);
+    return span;
+}
+
+// Pending font loads must not retain detached menu trees.
+function updateIconWhenFontReady(reference: WeakRef<HTMLSpanElement>, str: string) {
     fontReady(fontname).then(res => {
+        const span = reference.deref();
+        if (!span) return;
         if (res) {
             span.style.visibility = "";
             span.innerText = str; // re-assign, otherise more_vert doesnt show up. Maybe because of layout restructuring on mobile
@@ -34,7 +42,6 @@ export function getIconElement(str: string): HTMLElement {
             }
         }
     });
-    return span;
 }
 
 /**@returns true if the element is an needle engine icon element */

package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts

@@ -2,7 +2,7 @@ import { Mesh, Object3D, TextureLoader, Vector4 } from "three";
 import ThreeMeshUI from "three-mesh-ui";
 
 import { addNewComponent } from "../../engine_components.js";
-import { $uxbFepO } from "../../engine_license.js";
+import { __alnviAJA } from "../../engine_license.js";
 import { OneEuroFilterXYZ } from "../../engine_math.js";
 import type { Context } from "../../engine_setup.js";
 import { lookAtObject } from "../../engine_three_utils.js";
@@ -321,7 +321,7 @@ export class NeedleSpatialMenu {
         }
         if (this.menu) {
             const index = this.menu.children.indexOf(this._poweredByNeedleElement as any);
-            if (!this._showNeedleLogo && $uxbFepO()) {
+            if (!this._showNeedleLogo && __alnviAJA()) {
                 if (index >= 0) {
                     this._poweredByNeedleElement.removeFromParent();
                     this.markDirty();

package/src/engine/webcomponents/needle menu/needle-menu.ts

@@ -1,10 +1,10 @@
 import { showBalloonMessage } from "../../debug/debug.js";
 import type { Context } from "../../engine_context.js";
-import { $uxbFepO, OLF, Telemetry } from "../../engine_license.js";
+import { __alnviAJA, dRcEhn, Telemetry } from "../../engine_license.js";
 import { isLocalNetwork } from "../../engine_networking_utils.js";
 import { HTMLElementBase } from "../../engine_ssr.js";
 import { DeviceUtilities, getParam } from "../../engine_utils.js";
-import { onXRSessionStart, XRSessionEventArgs } from "../../xr/events.js";
+import { offXRSessionStart, onXRSessionStart, XRSessionEventArgs } from "../../xr/events.js";
 import { ButtonsFactory } from "../buttons.js";
 import { ensureFonts, iconFontUrl, loadFont } from "../fonts.js";
 import { getIconElement } from "../icons.js";
@@ -136,7 +136,9 @@ export class NeedleMenu {
 
     /** @ignore internal method */
     onDestroy() {
+        offXRSessionStart(this.onStartXR);
         window.removeEventListener("message", this.onPostMessage);
+        this._menu.dispose();
         this._menu.remove();
         this._spatialMenu.onDestroy();
     }
@@ -345,6 +347,19 @@ export class NeedleMenuElement extends HTMLElementBase {
 
     private _domElement: HTMLElement | null = null;
     private _context: Context | null = null;
+    private _unsubscribeFont?: () => void;
+    private _licenseFrame?: number;
+    private _unsubscribeLicense?: () => void;
+
+    /** @internal Release font and license subscriptions when the owning context is destroyed. */
+    dispose() {
+        this._unsubscribeFont?.();
+        this._unsubscribeFont = undefined;
+        if (this._licenseFrame !== undefined) window.cancelAnimationFrame(this._licenseFrame);
+        this._licenseFrame = undefined;
+        this._unsubscribeLicense?.();
+        this._unsubscribeLicense = undefined;
+    }
     private _didInitialize = false;
 
     constructor() {
@@ -755,7 +770,7 @@ export class NeedleMenuElement extends HTMLElementBase {
         // we need to add the icons to both the shadow dom as well as the HEAD to work 
         // https://github.com/google/material-design-icons/issues/1165
         ensureFonts();
-        loadFont(iconFontUrl, { loadedCallback: () => { this.handleSizeChange() } });
+        this._unsubscribeFont = loadFont(iconFontUrl, { loadedCallback: () => { this.handleSizeChange() } });
         loadFont(iconFontUrl, { element: shadow });
 
         const content = template.content.cloneNode(true) as DocumentFragment;
@@ -784,16 +799,19 @@ export class NeedleMenuElement extends HTMLElementBase {
         try {
             // if the user has a license then we CAN hide the needle logo
             // calling this method immediately will cause an issue with vite bundling tho
-            window.requestAnimationFrame(() => OLF(res => {
-                if (res == true && $uxbFepO() && !debugNonCommercial) {
-                    let visible = this._userRequestedLogoVisible;
-                    if (visible === undefined) visible = false;
-                    this.___onSetLogoVisible(visible);
-                }
-                else {
-                    this.___onSetLogoVisible(true);
-                }
-            }));
+            this._licenseFrame = window.requestAnimationFrame(() => {
+                this._licenseFrame = undefined;
+                this._unsubscribeLicense = dRcEhn(res => {
+                    if (res == true && __alnviAJA() && !debugNonCommercial) {
+                        let visible = this._userRequestedLogoVisible;
+                        if (visible === undefined) visible = false;
+                        this.___onSetLogoVisible(visible);
+                    }
+                    else {
+                        this.___onSetLogoVisible(true);
+                    }
+                });
+            });
         } catch (e) {
             console.error("[Needle Menu] License check failed.", e);
         }
@@ -836,7 +854,7 @@ export class NeedleMenuElement extends HTMLElementBase {
                 // ensure the menu is not hidden or removed
                 const requiredParent = this?.parentNode;
                 if (this.style.display != "flex" || this.style.visibility != "visible" || this.style.opacity != "1" || requiredParent != this._domElement?.shadowRoot) {
-                    if (!$uxbFepO()) {
+                    if (!__alnviAJA()) {
                         const change = changeEventCounter++;
                         // if a user doesn't have a local pro license *but* for development the menu is hidden then we show a warning
                         if (isLocalNetwork() && this._userRequestedMenuVisible === false) {
@@ -932,7 +950,7 @@ export class NeedleMenuElement extends HTMLElementBase {
     showNeedleLogo(visible: boolean) {
         this._userRequestedLogoVisible = visible;
         if (!visible) {
-            if (!$uxbFepO() || debugNonCommercial) {
+            if (!__alnviAJA() || debugNonCommercial) {
                 console.warn("[Needle Engine] You need a commercial license to hide the Needle Engine logo in production.");
                 const localNetwork = isLocalNetwork()
                 if (!localNetwork) return;

package/src/engine/webcomponents/needle-engine.loading.ts

@@ -1,6 +1,6 @@
 import { needleLogoOnlySVG } from "../assets/index.js"
 import { isDevEnvironment, showBalloonWarning } from "../debug/index.js";
-import { $uxbFepO, _$VfAckLjB, UxRDt } from "../engine_license.js";
+import { __alnviAJA, _$xBhfh, _$bDVSQf } from "../engine_license.js";
 import { Mathf } from "../engine_math.js";
 import { LoadingProgressArgs } from "../engine_setup.js";
 import { getParam } from "../engine_utils.js";
@@ -19,6 +19,7 @@ export class LoadingElementOptions {
 
 /** @internal */
 export interface ILoadingViewHandler {
+    dispose?(): void;
     onLoadingBegin(message?: string)
     onLoadingUpdate(progress: LoadingProgressArgs | number, message?: string);
     onLoadingFinished(message?: string);
@@ -79,6 +80,17 @@ export class EngineLoadingView implements ILoadingViewHandler {
         this._loadingElementOptions = opts;
     }
 
+    dispose() {
+        // Removal can happen before ready stops the progress interval.
+        clearInterval(this._progressLoop);
+        this._progressLoop = null;
+        this._loadingElement?.remove();
+        this._loadingElement = undefined;
+        this._loadingTextContainer = null;
+        this._loadingBar = null;
+        this._messageContainer = null;
+    }
+
     async onLoadingBegin(message?: string) {
         const _element = this._element.shadowRoot || this._element;
         if (debug) console.warn("Begin Loading")
@@ -205,7 +217,7 @@ export class EngineLoadingView implements ILoadingViewHandler {
         }
 
 
-        const hasLicense = _$VfAckLjB();
+        const hasLicense = _$xBhfh();
         if (!existing) {
             this._loadingElement.style.position = "absolute";
             this._loadingElement.style.width = "100%";
@@ -373,7 +385,7 @@ export class EngineLoadingView implements ILoadingViewHandler {
 
     // private async handleRuntimeLicense(loadingElement: HTMLElement) {
     //     // First check if we have a commercial license
-    //     let commercialLicense = $uxbFepO();
+    //     let commercialLicense = __alnviAJA();
     //     // if it's the case then we don't need to perform a runtime check
     //     if (commercialLicense) return;
 
@@ -393,13 +405,13 @@ export class EngineLoadingView implements ILoadingViewHandler {
     //     loadingElement.appendChild(nonCommercialContainer);
 
     //     // Use the runtime license check
-    //     if (!isDevEnvironment() && UxRDt) {
+    //     if (!isDevEnvironment() && _$bDVSQf) {
     //         if (debugLicense) console.log("Waiting for runtime license check");
-    //         await UxRDt;
-    //         commercialLicense = $uxbFepO();
+    //         await _$bDVSQf;
+    //         commercialLicense = __alnviAJA();
     //     }
     //     if (commercialLicense) return;
     //     nonCommercialContainer.style.transition = "opacity .5s ease-in-out";
     //     nonCommercialContainer.style.opacity = "1";
     // }
-}
+}

package/src/engine/webcomponents/needle-engine.ts

@@ -3,7 +3,7 @@ import type { Texture } from "three";
 import { isDevEnvironment, showBalloonWarning } from "../debug/index.js";
 import { PUBLIC_KEY, VERSION } from "../engine_constants.js";
 import { ContextEvent, ContextRegistry } from "../engine_context_registry.js";
-import { $uxbFepO, Telemetry } from "../engine_license.js";
+import { __alnviAJA, Telemetry } from "../engine_license.js";
 import { onStart } from "../engine_lifecycle_api.js";
 import { setDracoDecoderPath, setDracoDecoderType, setKtx2TranscoderPath } from "../engine_loaders.gltf.js";
 import { Context, ContextCreateArgs } from "../engine_setup.js";
@@ -248,6 +248,7 @@ export class NeedleEngineWebComponent extends HTMLElementBase implements INeedle
     private _overlay_ar!: AROverlayHandler;
     private _loadingProgress01: number = 0;
     private _loadingView?: ILoadingViewHandler;
+    private _cancelLoadingBlur?: () => void;
     private _previousSrc: string | null | string[] = null;
     /** @private set to true after <needle-engine> did load completely at least once. Set to false when < to false when <needle-engine> is removed from the document removed from the document */
     private _didFullyLoad: boolean = false;
@@ -419,6 +420,9 @@ export class NeedleEngineWebComponent extends HTMLElementBase implements INeedle
         const dispose = keepAlive == undefined || (keepAlive?.length > 0 && keepAlive !== "true" && keepAlive !== "1");
         if (debug) console.warn("<needle-engine> disconnected, keep-alive: \"" + keepAlive + "\"", typeof keepAlive, "Dispose=", dispose);
         if (dispose) {
+            this._cancelLoadingBlur?.();
+            this._cancelLoadingBlur = undefined;
+            this._loadingView?.dispose?.();
             if (debug)
                 console.warn("<needle-engine> dispose");
             this._context?.dispose();
@@ -579,7 +583,7 @@ export class NeedleEngineWebComponent extends HTMLElementBase implements INeedle
 
 
         // Loading start events
-        const allowOverridingDefaultLoading = $uxbFepO();
+        const allowOverridingDefaultLoading = __alnviAJA();
         // default loading can be overriden by calling preventDefault in the onload start event
         this.ensureLoadStartIsRegistered();
         let useDefaultLoading = this.dispatchEvent(new CustomEvent("loadstart", {
@@ -670,7 +674,8 @@ export class NeedleEngineWebComponent extends HTMLElementBase implements INeedle
 
 
         // Experimental loading blur
-        handleLoadingBlur(this);
+        this._cancelLoadingBlur?.();
+        this._cancelLoadingBlur = handleLoadingBlur(this);
 
         const currentHash = this.getAttribute("hash");
         if (currentHash !== null && currentHash !== undefined)
@@ -1205,8 +1210,12 @@ function getDisplayName(str: string) {
 
 
 function handleLoadingBlur(needleEngineElement: NeedleEngineWebComponent) {
-    onStart((ctx) => {
-        const userBlurSetting = needleEngineElement.getAttribute("loading-blur");
+    const userBlurSetting = needleEngineElement.getAttribute("loading-blur");
+    if (userBlurSetting === null || userBlurSetting === "0") return undefined;
+    const unregister = onStart((ctx) => {
+        // A different context starting must not consume this element's callback.
+        if (ctx.domElement !== needleEngineElement) return;
+        unregister();
         if (userBlurSetting !== null && userBlurSetting !== "0") {
             if (ctx.domElement === needleEngineElement) {
 
@@ -1259,5 +1268,6 @@ function handleLoadingBlur(needleEngineElement: NeedleEngineWebComponent) {
                 }
             }
         }
-    }, { once: true });
+    });
+    return unregister;
 }

package/src/engine/xr/NeedleXRSession.ts

@@ -111,19 +111,20 @@ async function handleSessionGranted() {
         // wasn't granted it), XR can't run here — skip the probe so we don't log a
         // Permissions-Policy violation on load.
         if (!isXrSpatialTrackingAllowed()) return;
-        // In app clips we default to AR
+        // An App Clip has already granted AR. Register its sessiongranted listener
+        // synchronously: awaiting a support probe here can miss the native event.
         if (DeviceUtilities.isNeedleAppClip()) {
             defaultMode = "immersive-ar";
         }
-        // Check if VR is even supported, otherwise try AR
-        else if (!(await navigator.xr?.isSessionSupported("immersive-vr"))) {
-            defaultMode = "immersive-ar";
-        }
-        // Check if AR is supported, otherwise we can't do anything
-        if (!(await navigator.xr?.isSessionSupported("immersive-ar")) && defaultMode === "immersive-ar") {
-            // console.warn("[NeedleXRSession:granted] Neither VR nor AR supported, aborting session start.");
-            // showBalloonMessage("NeidleXRSession: Neither VR nor AR supported, aborting session start.");
-            return;
+        else {
+            // Check if VR is even supported, otherwise try AR.
+            if (!(await navigator.xr?.isSessionSupported("immersive-vr"))) {
+                defaultMode = "immersive-ar";
+            }
+            // Check if AR is supported, otherwise we can't do anything.
+            if (defaultMode === "immersive-ar" && !(await navigator.xr?.isSessionSupported("immersive-ar"))) {
+                return;
+            }
         }
     } catch (e) {
         console.debug("[NeedleXRSession:granted] Error while checking XR support:", e);

package/src/engine/xr/TempXRContext.ts

@@ -3,7 +3,7 @@ import { ArrayCamera, AxesHelper, Camera, Color, DirectionalLight, Fog, GridHelp
 import { needleLogoOnlySVG } from "../assets/index.js";
 import { isDevEnvironment } from "../debug/index.js";
 import { ObjectUtils, PrimitiveType } from "../engine_create_objects.js";
-import { $uxbFepO } from "../engine_license.js";
+import { __alnviAJA } from "../engine_license.js";
 import { Mathf } from "../engine_math.js";
 import { delay, DeviceUtilities } from "../engine_utils.js";
 
@@ -215,7 +215,7 @@ export class TemporaryXRContext {
         this._scene.background = new Color(0x000000);
 
         let logoSrc = needleLogoOnlySVG;
-        if ($uxbFepO()) {
+        if (__alnviAJA()) {
             const htmlComponent = document.querySelector("needle-engine");
             if (htmlComponent) {
                 const licenseLogo = htmlComponent.getAttribute("logo-src");

package/src/engine-components/AnimationBuilder.ts

@@ -1,8 +1,8 @@
+import type { Camera, InterpolationModes, Light, Material, PerspectiveCamera } from "three";
 import { AnimationClip, BooleanKeyframeTrack, Color, ColorKeyframeTrack, Euler,
     InterpolateDiscrete, InterpolateLinear, InterpolateSmooth, KeyframeTrack,
     NumberKeyframeTrack, Object3D, Quaternion, QuaternionKeyframeTrack,
     Vector3, VectorKeyframeTrack } from "three";
-import type { Camera, InterpolationModes, Light, Material, PerspectiveCamera } from "three";
 
 import { isDevEnvironment } from "../engine/debug/index.js";
 

package/src/engine-components/AnimatorController.builder.ts

@@ -1,11 +1,11 @@
-import { AnimationClip, Object3D } from "three";
 import type { Light, Material, PerspectiveCamera } from "three";
+import { AnimationClip, Object3D } from "three";
 
-import { AnimatorConditionMode, AnimatorControllerParameterType } from "../engine/extensions/NEEDLE_animator_controller_model.js";
-import type { AnimatorControllerModel, Condition, Parameter, State, Transition } from "../engine/extensions/NEEDLE_animator_controller_model.js";
 import { InstantiateIdProvider } from "../engine/engine_networking_instantiate.js";
+import type { AnimatorControllerModel, Condition, Parameter, State, Transition } from "../engine/extensions/NEEDLE_animator_controller_model.js";
+import { AnimatorConditionMode, AnimatorControllerParameterType } from "../engine/extensions/NEEDLE_animator_controller_model.js";
+import { type AnimationKeyframe, type ColorValue,type EulerValue, type QuatValue, resolveClipSource, track as trackFn, type TrackDescriptor, type TrackOptions, type Tween, type Vec3Value } from "./AnimationBuilder.js";
 import { AnimatorController } from "./AnimatorController.js";
-import { resolveClipSource, track as trackFn, type TrackDescriptor, type TrackOptions, type AnimationKeyframe, type Tween, type Vec3Value, type QuatValue, type EulerValue, type ColorValue } from "./AnimationBuilder.js";
 
 /** Keyframe array or tween shorthand */
 type KF<V> = AnimationKeyframe<V>[] | Tween<V>;

package/src/engine-components/Component.ts

@@ -4,6 +4,7 @@ import { isDevEnvironment } from "../engine/debug/index.js";
 import { type AssetReference } from "../engine/engine_addressables.js";
 import { addComponent, destroyComponentInstance, findObjectOfType, findObjectsOfType, getComponent, getComponentInChildren, getComponentInParent, getComponents, getComponentsInChildren, getComponentsInParent, getOrAddComponent, removeComponent } from "../engine/engine_components.js";
 import { activeInHierarchyFieldName } from "../engine/engine_constants.js";
+import { DisposableStore, type DisposeFn,type IDisposable } from "../engine/engine_disposable.js";
 import { destroy, findByGuid, foreachComponent, type IInstantiateOptions, instantiate, isActiveInHierarchy, isActiveSelf, isDestroyed, isUsingInstancing, markAsInstancedRendered, setActive } from "../engine/engine_gameobject.js";
 import { isHotReloadEnabled, registerHotReloadType, unregisterHotReloadType } from "../engine/engine_hot_reload.js";
 import * as main from "../engine/engine_mainloop_utils.js";
@@ -13,7 +14,6 @@ import * as threeutils from "../engine/engine_three_utils.js";
 import { $componentName, type Collision, type ComponentInit, type Constructor, type ConstructorConcrete, type ICollider, type IComponent, type IGameObject, type SourceIdentifier } from "../engine/engine_types.js";
 import { TypeStore } from "../engine/engine_typestore.js";
 import type { INeedleXRSessionEventReceiver, NeedleXRControllerEventArgs, NeedleXREventArgs } from "../engine/engine_xr.js";
-import { DisposableStore, type IDisposable, type DisposeFn } from "../engine/engine_disposable.js";
 import { type IPointerEventHandler, PointerEventData } from "./ui/PointerEvents.js";
 
 

package/src/engine-components/DragControls.ts

@@ -1,9 +1,7 @@
 import { AxesHelper, Box3, Euler, Matrix4, Object3D, Plane, Quaternion, Ray, Vector3 } from "three";
 
 export type { IDragConstraint, IDragConstraintContext } from "./DragControlsConstraints.js";
-export { AxisRotationConstraint, GridSnapConstraint, GrabPointPlaneConstraint, KeepRotationConstraint, KeepScaleConstraint, ScaleLimitConstraint, RotationAxis, FixedRotationAxesConstraint, PlaneHeightLockConstraint, SnapToSurfaceConstraint, applyFollowObjectConstraints } from "./DragControlsConstraints.js";
-import { IDragConstraint, IDragConstraintContext, AxisRotationConstraint, GridSnapConstraint, GrabPointPlaneConstraint, KeepRotationConstraint, ScaleLimitConstraint, FixedRotationAxesConstraint, PlaneHeightLockConstraint, SnapToSurfaceConstraint, applyFollowObjectConstraints } from "./DragControlsConstraints.js";
-
+export { applyFollowObjectConstraints,AxisRotationConstraint, FixedRotationAxesConstraint, GrabPointPlaneConstraint, GridSnapConstraint, KeepRotationConstraint, KeepScaleConstraint, PlaneHeightLockConstraint, RotationAxis, ScaleLimitConstraint, SnapToSurfaceConstraint } from "./DragControlsConstraints.js";
 import { Gizmos } from "../engine/engine_gizmos.js";
 import { InstancingUtil } from "../engine/engine_instancing.js";
 import { Mathf } from "../engine/engine_math.js";
@@ -14,6 +12,7 @@ import { type IGameObject } from "../engine/engine_types.js";
 import { getParam } from "../engine/engine_utils.js";
 import { NeedleXRSession } from "../engine/engine_xr.js";
 import { Behaviour, GameObject } from "./Component.js";
+import { applyFollowObjectConstraints,AxisRotationConstraint, FixedRotationAxesConstraint, GrabPointPlaneConstraint, GridSnapConstraint, IDragConstraint, IDragConstraintContext, KeepRotationConstraint, PlaneHeightLockConstraint, ScaleLimitConstraint, SnapToSurfaceConstraint } from "./DragControlsConstraints.js";
 import { EventList } from "./EventList.js";
 import { UsageMarker } from "./Interactable.js";
 import { Rigidbody } from "./RigidBody.js";

package/src/engine-components/DragControlsConstraints.ts

@@ -1,9 +1,8 @@
 import { Box3, Euler, Object3D, Plane, Quaternion, Ray, Vector3 } from "three";
 
 import type { Context } from "../engine/engine_setup.js";
-
-import { GameObject } from "./Component.js";
 import type { IGameObject } from "../engine/engine_types.js";
+import { GameObject } from "./Component.js";
 
 // #region Interfaces
 /**

package/src/engine-components/Light.ts

@@ -1,12 +1,12 @@
 import { CameraHelper, Color, DirectionalLight, DirectionalLightHelper, Light as ThreeLight, OrthographicCamera, PointLight, SpotLight, Vector3 } from "three";
 
+import { isDevEnvironment } from "../engine/debug/index.js";
 import { serializable } from "../engine/engine_serialization_decorator.js";
 import { setWorldPositionXYZ } from "../engine/engine_three_utils.js";
 import type { ILight } from "../engine/engine_types.js";
 import { getParam } from "../engine/engine_utils.js";
 import type { NeedleXREventArgs } from "../engine/xr/api.js";
 import { Behaviour, GameObject } from "./Component.js";
-import { isDevEnvironment } from "../engine/debug/index.js";
 
 // https://threejs.org/examples/webgl_shadowmap_csm.html