@needle-tools/engine 5.1.0-alpha.8 → 5.1.0-beta

package/src/engine/engine_audio.ts

@@ -1,25 +1,78 @@
 import { AudioContext } from "three";
 
 import { Application } from "./engine_application.js";
+import { getParam } from "./engine_utils.js";
 
-/** 
- * @internal 
- * Ensure the audio context is resumed if it gets suspended or interrupted */
+/** Verbose audio logging, opt-in via `?debugaudio` (same flag AudioSource uses). */
+const debug = getParam("debugaudio");
+
+/**
+ * iOS Safari exposes a non-standard `"interrupted"` state in addition to the
+ * spec'd `AudioContextState`s when the audio session is taken away (e.g. the
+ * device is locked or another app starts playing audio).
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/BaseAudioContext/state#resuming_interrupted_play_states_in_ios_safari
+ */
+export type InterruptibleAudioContextState = AudioContextState | "interrupted";
+
+/**
+ * @internal
+ * Pure policy deciding whether `AudioContext.resume()` should be attempted right now.
+ *
+ * The context needs resuming when it is `"suspended"` or (on iOS) `"interrupted"`.
+ * But resuming is only allowed while the document is **visible**: on iOS Safari,
+ * calling `resume()` while the page is backgrounded or the device is locked fails
+ * with `InvalidStateError: Failed to start the audio device`, because the audio
+ * hardware cannot be started in the background. In that case the resume must be
+ * deferred until the page becomes visible again.
+ *
+ * @param state The current (possibly iOS-interrupted) audio context state.
+ * @param visibility The current `document.visibilityState`.
+ * @returns `true` if `resume()` should be called now, `false` if it should be deferred.
+ */
+export function shouldResumeAudioContext(
+    state: InterruptibleAudioContextState,
+    visibility: DocumentVisibilityState,
+): boolean {
+    // Resuming while hidden throws InvalidStateError on iOS — defer until visible.
+    if (visibility !== "visible") return false;
+    return state === "suspended" || state === "interrupted";
+}
+
+/** Resume the shared AudioContext if it is suspended/interrupted and the page is visible. */
+function recoverAudioContext() {
+    const ctx = AudioContext.getContext();
+    const state = ctx.state as InterruptibleAudioContextState;
+    const visibility = typeof document !== "undefined" ? document.visibilityState : "visible";
+    if (!shouldResumeAudioContext(state, visibility)) return;
+    ctx.resume()
+        .then(() => { if (debug) console.log("AudioContext resumed successfully"); })
+        .catch(e => { if (debug) console.warn("Failed to resume AudioContext: " + e); });
+}
+
+/**
+ * @internal
+ * Keep the shared AudioContext alive across suspends/interruptions (tab switch, device lock, audio
+ * session interruption). On returning to the foreground we simply resume() the EXISTING context —
+ * the same approach three.js uses, which recovers cleanly because AudioSource plays clips through a
+ * MediaElementAudioSourceNode (an <audio> element), whose media session iOS keeps alive across a
+ * lock. We deliberately do NOT close/recreate the context: on-device testing showed that makes iOS
+ * worse (a recreated context's output stays dead) and it is unnecessary.
+ */
 export function ensureAudioContextIsResumed() {
     Application.registerWaitForInteraction(() => {
-        // this is a fix for https://github.com/mrdoob/three.js/issues/27779 & https://linear.app/needle/issue/NE-4257
+        // https://github.com/mrdoob/three.js/issues/27779 & https://linear.app/needle/issue/NE-4257
         const ctx = AudioContext.getContext();
-        ctx.addEventListener("statechange", () => {
-            setTimeout(() => {
-                // on iOS the audiocontext can be interrupted: https://developer.mozilla.org/en-US/docs/Web/API/BaseAudioContext/state#resuming_interrupted_play_states_in_ios_safari
-                const state = ctx.state as AudioContextState | "interrupted";
-                if (state === "suspended" || state === "interrupted") {
-                    ctx.resume()
-                        .then(() => { console.log("AudioContext resumed successfully"); })
-                        .catch((e) => { console.log("Failed to resume AudioContext: " + e); });
-                }
-            }, 500);
-        });
+        ctx.addEventListener("statechange", () => setTimeout(recoverAudioContext, 300));
+
+        // iOS frequently rejects the first resume() right after foregrounding with InvalidStateError,
+        // then accepts one a few hundred ms later with no follow-up statechange — so retry with a
+        // short backoff. Each attempt is a no-op once running.
+        if (typeof document !== "undefined") {
+            document.addEventListener("visibilitychange", () => {
+                if (document.visibilityState !== "visible") return;
+                for (const delay of [0, 250, 600, 1200, 2000]) setTimeout(recoverAudioContext, delay);
+            });
+        }
     });
 }
 

package/src/engine/engine_gameobject.ts

@@ -746,4 +746,4 @@ function resolveAndBindSkinnedMeshBones(
 
 // }
 
-// Reference resolution is now handled by the unified module: engine_instantiate_resolve.ts
+// Reference resolution is now handled by the unified module: engine_instantiate_resolve.ts

package/src/engine/engine_init.ts

@@ -8,7 +8,7 @@ import { initBuiltinTypes } from "./codegen/register_types.js";
 import { initSpatialConsole } from "./debug/debug_spatial_console.js";
 import { initAddressableSerializers } from "./engine_addressables.js";
 import { ensureAudioContextIsResumed } from "./engine_audio.js";
-import { $cLf } from "./engine_license.js";
+import { $lySygz } from "./engine_license.js";
 import { initNeedleLoader } from "./engine_loaders.js";
 import { initPhysics } from "./engine_physics_rapier.js";
 import { initBuiltinSerializers } from "./engine_serialization_builtin_serializer.js";
@@ -59,7 +59,7 @@ export function initEngine() {
     initPhysics();
     initXR();
     initSpatialConsole();
-    $cLf();
+    $lySygz();
 
     // Must be last. customElements.define() upgrades existing <needle-engine>
     // elements synchronously, which can trigger context.create() and dispatch

package/src/engine/engine_license.ts

@@ -9,19 +9,19 @@ import { getParam } from "./engine_utils.js";
 
 const debug = getParam("__debuglic__");
 
-const _$zbtJJVy: ((result: boolean) => void)[] = [];
+const _jmbVzxw: ((result: boolean) => void)[] = [];
 
 // DO NOT EDIT MANUALLY
-let miOmwPp: string = "";
+let $rJboqN: string = "";
 // eslint-disable-next-line prefer-const
-let _$ALiqbpo: string = "";
+let _$RRhFut: string = "";
 
 if (debug) {
-    console.log("License Type: " + miOmwPp);
-    if (_$ALiqbpo) {
-        console.log("License JWT: " + _$ALiqbpo);
+    console.log("License Type: " + $rJboqN);
+    if (_$RRhFut) {
+        console.log("License JWT: " + _$RRhFut);
         try {
-            const payload = JSON.parse(atob(_$ALiqbpo.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
+            const payload = JSON.parse(atob(_$RRhFut.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
             console.log("License JWT payload:", payload);
         }
         catch { console.log("License JWT payload: (failed to decode)"); }
@@ -32,8 +32,8 @@ if (debug) {
 }
 
 /** @internal */
-export function _$QyV() {
-    switch (miOmwPp) {
+export function _XtEQ() {
+    switch ($rJboqN) {
         case "pro":
         case "enterprise":
             return true;
@@ -42,8 +42,8 @@ export function _$QyV() {
 }
 
 /** @internal */
-export function __Carg() {
-    switch (miOmwPp) {
+export function _$qWUhYZU() {
+    switch ($rJboqN) {
         case "indie":
             return true;
     }
@@ -51,8 +51,8 @@ export function __Carg() {
 }
 
 /** @internal */
-export function NVzibd() {
-    switch (miOmwPp) {
+export function _BxFwJ() {
+    switch ($rJboqN) {
         case "edu":
             return true;
     }
@@ -60,20 +60,20 @@ export function NVzibd() {
 }
 
 /** @internal */
-export function bLW() {
-    return _$QyV() || __Carg() || NVzibd();
+export function $fwGZrGe() {
+    return _XtEQ() || _$qWUhYZU() || _BxFwJ();
 }
 
 
 /** @internal */
-export function $bxGE(cb: (result: boolean) => void) {
-    if (_$QyV() || __Carg() || NVzibd())
+export function $BWnhWzrW(cb: (result: boolean) => void) {
+    if (_XtEQ() || _$qWUhYZU() || _BxFwJ())
         return cb(true);
-    _$zbtJJVy.push(cb);
+    _jmbVzxw.push(cb);
 }
 
-function __JogRhlxZ(result: boolean) {
-    for (const cb of _$zbtJJVy) {
+function $bjsviJ(result: boolean) {
+    for (const cb of _jmbVzxw) {
         try {
             cb(result);
         }
@@ -88,7 +88,7 @@ function __JogRhlxZ(result: boolean) {
 
 // ECDSA P-256 public key for verifying license JWTs (verification-only, safe to ship)
 /* eslint-disable no-secrets/no-secrets -- public key, not a secret */
-const CcFRcciC = {
+const _$cibPFcX = {
     kty: "EC",
     crv: "P-256",
     x: "A34nyKMjhQYVgzeE4tyLUYdx34TAKogDa7v7PRaO9Lg",
@@ -112,7 +112,7 @@ function base64urlDecode(str: string): Uint8Array {
  * Verify a JWT license token and return the `type` claim if valid.
  * Returns null if the JWT is missing, malformed, or has an invalid signature.
  */
-async function ZhJ(jwt: string): Promise<string | null> {
+async function $JcYsyq(jwt: string): Promise<string | null> {
     if (!jwt) return null;
     try {
         const parts = jwt.split(".");
@@ -122,7 +122,7 @@ async function ZhJ(jwt: string): Promise<string | null> {
 
         const key = await crypto.subtle.importKey(
             "jwk",
-            CcFRcciC,
+            _$cibPFcX,
             { name: "ECDSA", namedCurve: "P-256" },
             false,
             ["verify"]
@@ -182,24 +182,24 @@ async function ZhJ(jwt: string): Promise<string | null> {
 }
 
 /** Verify the injected JWT and update the license type if valid.
- * The engine ONLY trusts the JWT — the plain miOmwPp string is ignored. */
+ * The engine ONLY trusts the JWT — the plain $rJboqN string is ignored. */
 let _jwtVerificationPromise: Promise<void> | undefined = undefined;
-async function $ESIFccD(): Promise<void> {
-    // NOTE: do NOT add an `if (!_$ALiqbpo) return` guard here.
+async function _$qeTBLq(): Promise<void> {
+    // NOTE: do NOT add an `if (!_$RRhFut) return` guard here.
     // esbuild (Vite dependency pre-bundling) would see the variable as constant ""
     // and tree-shake the entire JWT verification code path.
-    const jwt = _$ALiqbpo;
+    const jwt = _$RRhFut;
     // Clear after reading — this reassignment also prevents esbuild from
     // constant-folding the variable (it now has multiple assignment sites).
-    _$ALiqbpo = "";
-    const verifiedType = await ZhJ(jwt);
+    _$RRhFut = "";
+    const verifiedType = await $JcYsyq(jwt);
     if (verifiedType) {
-        miOmwPp = verifiedType;
+        $rJboqN = verifiedType;
         if (debug) console.log("License type set from verified JWT: " + verifiedType);
-        __JogRhlxZ(bLW());
+        $bjsviJ($fwGZrGe());
     }
     else {
-        miOmwPp = "basic";
+        $rJboqN = "basic";
         if (debug && jwt) console.warn("JWT verification failed — license reset to basic");
     }
 }
@@ -271,7 +271,7 @@ export namespace Telemetry {
 
         const attribute = domElement?.getAttribute("no-telemetry");
         if (attribute === "" || attribute === "true" || attribute === "1") {
-            if (miOmwPp === "pro" || miOmwPp === "enterprise") {
+            if ($rJboqN === "pro" || $rJboqN === "enterprise") {
                 if (debug) console.debug("Telemetry is disabled via no-telemetry attribute");
                 return false;
             }
@@ -378,32 +378,32 @@ export namespace Telemetry {
 }
 
 
-export function $cLf() {
+export function $lySygz() {
 
-    if(miOmwPp === "") miOmwPp = "basic";
+    if($rJboqN === "") $rJboqN = "basic";
 
     // Start JWT verification — must be here (not top-level) to avoid tree-shaking
-    _jwtVerificationPromise = $ESIFccD();
+    _jwtVerificationPromise = _$qeTBLq();
 
     Telemetry.init();
     ContextRegistry.registerCallback(ContextEvent.ContextRegistered, evt => {
-        _JTSOMz(evt.context);
-        __rlGEVK(evt.context);
-        setTimeout(() => __OmIq(evt.context), 2000);
+        __HewJRdQ(evt.context);
+        __jSWGURd(evt.context);
+        setTimeout(() => _$wmvwSlSB(evt.context), 2000);
     });
 }
 
-export let _MHgSj: Promise<void> | undefined = undefined;
+export let ICD: Promise<void> | undefined = undefined;
 let applicationIsForbidden = false;
 let applicationForbiddenText = "";
-async function $pek() {
+async function _EiMi() {
     // Only perform the runtime license check once
-    if (_MHgSj) return _MHgSj;
+    if (ICD) return ICD;
     // Wait for JWT verification to complete first (if running)
     if (_jwtVerificationPromise) {
         await _jwtVerificationPromise;
     }
-    if (miOmwPp === "basic") {
+    if ($rJboqN === "basic") {
         try {
             const licenseUrl = "https://needle.tools/api/v1/needle-engine/check?location=" + encodeURIComponent(window.location.href) + "&version=" + VERSION + "&generator=" + encodeURIComponent(GENERATOR);
             const res = await fetch(licenseUrl, {
@@ -415,29 +415,29 @@ async function $pek() {
             if (res?.status === 200) {
                 applicationIsForbidden = false;
                 if (debug) console.log("License check succeeded");
-                miOmwPp = "pro";
-                __JogRhlxZ(true);
+                $rJboqN = "pro";
+                $bjsviJ(true);
             }
             else if (res?.status === 403) {
-                __JogRhlxZ(false);
+                $bjsviJ(false);
                 applicationIsForbidden = true;
                 applicationForbiddenText = await res.text();
             }
             else {
-                __JogRhlxZ(false);
+                $bjsviJ(false);
                 if (debug) console.log("License check failed with status " + res?.status);
             }
         }
         catch (err) {
-            __JogRhlxZ(false);
+            $bjsviJ(false);
             if (debug) console.error("License check failed", err);
         }
     }
-    else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + miOmwPp + "\"");
+    else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + $rJboqN + "\"");
 }
-_MHgSj = $pek();
+ICD = _EiMi();
 
-async function __rlGEVK(ctx: IContext) {
+async function __jSWGURd(ctx: IContext) {
     function createForbiddenElement() {
         const div = document.createElement("div");
         div.className = "needle-forbidden";
@@ -502,40 +502,40 @@ async function __rlGEVK(ctx: IContext) {
     }, 500)
 }
 
-async function _JTSOMz(ctx: IContext) {
+async function __HewJRdQ(ctx: IContext) {
     try {
-        if (!_$QyV() && !__Carg()) {
-            return dtvHGhBg(ctx);
+        if (!_XtEQ() && !_$qWUhYZU()) {
+            return __ujmxoKP(ctx);
         }
     }
     catch (err) {
         if (debug) console.log("License check failed", err)
-        return dtvHGhBg(ctx)
+        return __ujmxoKP(ctx)
     }
-    if (debug) dtvHGhBg(ctx)
+    if (debug) __ujmxoKP(ctx)
 }
 
 
 
-async function dtvHGhBg(ctx: IContext) {
+async function __ujmxoKP(ctx: IContext) {
 
     // if the engine loads faster than the license check, we need to capture the ready event here
     let isReady = false;
     ctx.domElement.addEventListener("ready", () => isReady = true);
 
-    await _MHgSj?.catch(() => { });
+    await ICD?.catch(() => { });
 
 
-    if (_$QyV() || __Carg()) return;
-    if (bLW() === false) __PJeisZrd();
+    if (_XtEQ() || _$qWUhYZU()) return;
+    if ($fwGZrGe() === false) _rIQtT();
 
     // check if the engine is already ready (meaning has finished loading)
     if (isReady) {
-        __CRBs(ctx);
+        ZzOMzy(ctx);
     }
     else {
         ctx.domElement.addEventListener("ready", () => {
-            __CRBs(ctx);
+            ZzOMzy(ctx);
         });
     }
 }
@@ -543,7 +543,7 @@ async function dtvHGhBg(ctx: IContext) {
 // const licenseElementIdentifier = "needle-license-element";
 // const licenseDuration = 10000;
 // const licenseDelay = 1200;
-function __CRBs(ctx: IContext) {
+function ZzOMzy(ctx: IContext) {
 
     const style = `
         position: relative;
@@ -556,7 +556,7 @@ function __CRBs(ctx: IContext) {
         padding: 10px;
         padding-left: 30px;
     `;
-    if (miOmwPp === "edu") {
+    if ($rJboqN === "edu") {
         if (navigator.webdriver) {
             console.log("This project is supported by Needle for Education – https://needle.tools");
         }
@@ -613,7 +613,7 @@ function __CRBs(ctx: IContext) {
         }
     }, 1000);
 
-    if (NVzibd()) {
+    if (_BxFwJ()) {
         const removeDelay = 20_000;
         setTimeout(() => {
             clearInterval(interval);
@@ -622,7 +622,7 @@ function __CRBs(ctx: IContext) {
             const intervalInMinutes = 5;
             setTimeout(() => {
                 if (ctx.domElement.parentNode)
-                    __CRBs(ctx);
+                    ZzOMzy(ctx);
             }, 1000 * 60 * intervalInMinutes)
         }, removeDelay);
     }
@@ -633,7 +633,7 @@ function __CRBs(ctx: IContext) {
 const base64Logo = "data:image/webp;base64,UklGRrABAABXRUJQVlA4WAoAAAAQAAAAHwAAHwAAQUxQSKEAAAARN6CmbSM4WR7vdARON11EBDq3fLiNbVtVzpMCPlKAEzsx0Y/x+Ovuv4dn0EFE/ydAvz6YggXzgh5sVgXM/zOC/4sii7qgGvB5N7hmuQYwkvazWAu1JPW41FXSHq6pnaQWvqYH18Fc0j1hO/BFTtIeSBlJi5w6qIIO7IOrwhFsB2Yxukif0FTRLpXswHR8MxbslKe9VZsn/Ub5C7YFOpqSTABWUDgg6AAAAFAGAJ0BKiAAIAA+7VyoTqmkpCI3+qgBMB2JbACdMt69DwMIQBLhkTO6XwY00UEDK6cNIDnuNibPf0EgAP7Y1myuiQHLDsF/0h5unrGh6WAbv7aegg2ZMd3uRKfT/3SJztcaujYfTvMXspfCTmYcoO6a+vhC3ss4M8uM58t4siiu59I4aOl59e9Sr6xoxYlHf2v+NnBNpJYeJf8jABQAId/PXuBkLEFkiCucgSGEcfhvajql/j3reCGl0M5/9gQWy7ayNPs+wlvIxFnNfSlfuND4CZOCyxOHhRqOmHN4ULHo3tCSrUNvgAA=";
 
 let lastLogTime = 0;
-async function __PJeisZrd(_logo?: string) {
+async function _rIQtT(_logo?: string) {
     const now = Date.now();
     if (now - lastLogTime < 2000) return;
     lastLogTime = now;
@@ -666,7 +666,7 @@ async function __PJeisZrd(_logo?: string) {
 }
 
 
-async function __OmIq(context: IContext) {
+async function _$wmvwSlSB(context: IContext) {
     // We can't send beacons from cross-origin isolated pages
     if (window.crossOriginIsolated) return;
 
@@ -681,7 +681,7 @@ async function __OmIq(context: IContext) {
 
             // current url without query parameters
             const currentUrl = window.location.href.split("?")[0];
-            const license = miOmwPp;
+            const license = $rJboqN;
 
             const beaconData = {
                 license,

package/src/engine/engine_math.ts

@@ -247,9 +247,11 @@ class LowPassFilter {
         return this.y;
     }
 
-    reset(value: number) {
-        this.y = value;
-        this.s = value;
+    reset(value?: number) {
+        // undefined clears the sample (y/s become null) so the next filter() call
+        // is treated as the first sample again, i.e. a passthrough.
+        this.y = value ?? null;
+        this.s = value ?? null;
     }
 }
 
@@ -358,7 +360,12 @@ export class OneEuroFilter {
     }
 
     reset(x?: number) {
-        if (x != undefined) this.x.reset(x);
+        // Always clear the filtered sample (seeded with x when provided) AND the
+        // derivative filter, so the next filter() call is treated as the first
+        // sample again. Previously a bare reset() (no argument) left the old sample
+        // in place, so the next filter() kept smoothing against stale state.
+        this.x.reset(x);
+        this.dx.reset();
         this.x.alpha = this.alpha(this.minCutOff);
         this.dx.alpha = this.alpha(this.dCutOff);
         this.lasttime = null;

package/src/engine/engine_networking_blob.ts

@@ -1,7 +1,7 @@
 import { FileLoader } from "three";
 
 import { showBalloonWarning } from "./debug/index.js";
-import { bLW } from "./engine_license.js";
+import { $fwGZrGe } from "./engine_license.js";
 import { delay } from "./engine_utils.js";
 import { md5AsBytes, md5Hex, sha256Base64 } from "./engine_utils_hash.js";
 
@@ -45,7 +45,7 @@ export namespace BlobStorage {
      */
     export function canUpload(info: { filesize: number }) {
         const sizeInMB = info.filesize / 1024 / 1024;
-        if (bLW()) {
+        if ($fwGZrGe()) {
             return sizeInMB < maxSizeInMB;
         }
         return sizeInMB < maxFreeSizeInMB;
@@ -100,7 +100,7 @@ export namespace BlobStorage {
             console.warn(`Your file is too large for uploading (${filesizeInMB.toFixed(1)}MB). Max allowed size is ${maxSizeInMB}MB`);
             return null;
         }
-        else if (!bLW() && filesizeInMB > maxFreeSizeInMB) {
+        else if (!$fwGZrGe() && filesizeInMB > maxFreeSizeInMB) {
             if (opts?.silent !== true) showBalloonWarning(`File is too large for uploading. Please get a <a href=\"https://needle.tools/pricing\" target=\"_blank\">commercial license</a> to upload files larger than 5MB`);
             console.warn(`Your file is too large for uploading (${filesizeInMB.toFixed(1)}MB). Max size is 5MB for non-commercial users. Please get a commercial license at https://needle.tools/pricing for larger files (up to 50MB)`);
             return null;

package/src/engine/engine_scenedata.ts

@@ -54,13 +54,18 @@ const cache = new WeakMap<IContext, SceneData>();
  */
 function makeErrorProxy(message: string): object {
     const handler: ProxyHandler<object> = {
-        get(_t, prop: string) {
+        get(_t, prop: string | symbol) {
             if (prop === "then") return undefined; // not a Promise
+            // Symbol-keyed access (Symbol.toPrimitive, Symbol.toStringTag, Symbol.iterator, …)
+            // must return undefined — returning another proxy causes a TypeError when JS tries
+            // to coerce the value (e.g. in template literals calling .toString()).
+            if (typeof prop === "symbol") return undefined;
             const fn = isDevEnvironment() ? console.error : console.warn;
             fn(`[SceneData] ${message}`);
             return makeErrorProxy(message);
         },
-        set(_t, prop: string) {
+        set(_t, prop: string | symbol) {
+            if (typeof prop === "symbol") return true;
             const fn = isDevEnvironment() ? console.error : console.warn;
             fn(`[SceneData] ${message} (tried to set "${prop}")`);
             return true; // suppress TypeError

package/src/engine/engine_serialization_core.ts

@@ -227,8 +227,13 @@ export function serializeObject(obj: ISerializable, context: SerializationContex
         // if the object bein serialized is some type of object check if we have special handling registered for it
         if (val !== undefined && val !== null && typeof val === "object") {
             // get type name
-            // get registered serialization handler
-            const ser = helper.getSerializerForConstructor(val);
+            // get registered serialization handler.
+            // Pass the constructor (not the instance): getSerializerForConstructor
+            // looks types up in a constructor-keyed map and walks the constructor's
+            // prototype chain — mirroring the deserialize path. Passing the instance
+            // here previously missed every lookup, so e.g. a Color was never converted
+            // to { r, g, b } and an Euler / Object3D reference was emitted raw.
+            const ser = helper.getSerializerForConstructor(val.constructor);
             if (ser) {
                 // serialize data using that handler
                 res[key] = ser.onSerialize(val, context);

package/src/engine/engine_time_utils.ts

@@ -62,11 +62,14 @@ export class Progress {
      * Progress.end("export-usdz");
      * 
      * // Auto step with weights:
+     * // A numeric weight applies to the NEXT step — it sets how many steps the
+     * // following auto-step advances. The call it is passed on advances by the
+     * // previously-set weight (1 by default).
      * Progress.start("export-usdz", undefined, (progress) => console.log("Progress: " + progress));
-     * Progress.report("export-usdz", { message: "Exporting objects", autoStep: true, totalSteps: 10 });
-     * Progress.report("export-usdz", { message: "Exporting object 1", autoStep: 8 }); // will advance to 80% progress
-     * Progress.report("export-usdz", "Exporting object 2"); // 90%
-     * Progress.report("export-usdz", "Exporting object 3"); // 100%
+     * Progress.report("export-usdz", { message: "Exporting objects", autoStep: true, totalSteps: 10 }); // step 1/10 (10%)
+     * Progress.report("export-usdz", { message: "Heavy step", autoStep: 8 });                           // step 2/10 (20%); weight 8 applies to the next step
+     * Progress.report("export-usdz", "Exporting object 2");                                              // advances by 8 -> step 10/10 (100%)
+     * Progress.report("export-usdz", "Exporting object 3");                                              // stays at 100%
      * 
      * // Child scopes:
      * Progress.start("export-usdz", undefined, (progress) => console.log("Progress: " + progress));
@@ -103,8 +106,9 @@ export class Progress {
      * Progress.report("export-usdz", { totalSteps: 20, autoStep: true });
      * // show the progress as 50%
      * Progress.report("export-usdz", { progress: 0.5 });
-     * // give this step a weight of 20, which changes how progress is calculated. Useful for steps that take longer and/or have child scopes.
-     * Progress.report("export-usdz", { message. "Long process", autoStep: 20 });
+     * // give a weight of 20 to the NEXT step (useful for steps that take longer
+     * // and/or have child scopes); the following auto-step will advance by 20.
+     * Progress.report("export-usdz", { message: "Long process", autoStep: 20 });
      * // show the current step and total steps and implicitly calculate progress as 10%
      * Progress.report("export-usdz", { currentStep: 1, totalSteps: 10 });
      */

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 { bLW } from "./engine_license.js";
+import { $fwGZrGe } 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 = bLW();
+    const canUseCustomLogo = $fwGZrGe();
 
     // 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/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 { _$QyV } from "../../engine_license.js";
+import { _XtEQ } 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 && _$QyV()) {
+            if (!this._showNeedleLogo && _XtEQ()) {
                 if (index >= 0) {
                     this._poweredByNeedleElement.removeFromParent();
                     this.markDirty();