@needle-tools/engine 6.0.0-alpha.5 → 6.0.0-alpha.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/engine",
-  "version": "6.0.0-alpha.5",
+  "version": "6.0.0-alpha.7",
   "description": "Needle Engine is a web-based runtime for 3D apps. It runs on your machine for development with great integrations into editors like Unity or Blender - and can be deployed onto any device! It is flexible, extensible and networking and XR are built-in.",
   "main": "dist/needle-engine.min.js",
   "exports": {
@@ -105,10 +105,10 @@
   ],
   "dependencies": {
     "@dimforge/rapier3d-compat": "0.19.3",
-    "@needle-tools/addressing": "0.3.4-1788969873.sulky-guglielmo-marconi.22e198e",
-    "@needle-tools/gltf-progressive": "4.0.0-alpha.4",
+    "@needle-tools/addressing": "0.4.0-1791547125.jolly-gregor-mendel.6047e58",
+    "@needle-tools/gltf-progressive": "4.0.0-alpha.6",
     "@needle-tools/materialx": "1.7.4",
-    "@needle-tools/three-animation-pointer": "1.1.2",
+    "@needle-tools/three-animation-pointer": "1.1.3",
     "@sparkjsdev/spark": "npm:@needle-tools/spark@2.1.0-needle.3",
     "@webxr-input-profiles/motion-controllers": "1.0.0",
     "flatbuffers": "2.0.4",

package/plugins/common/license.js

@@ -127,7 +127,7 @@ async function requestNeedleCloud(path, options) {
  * @param {DefaultOptions & {accessToken?:string, team:string|undefined}} opts
  */
 export async function replaceLicense(code, opts) {
-    const index = code?.indexOf("__yPOBaOUW");
+    const index = code?.indexOf("yBXL");
     if (index >= 0) {
         const licenseResult = await resolveLicense(opts);
         if (!licenseResult) {
@@ -136,18 +136,18 @@ export async function replaceLicense(code, opts) {
         const end = code.indexOf(";", index);
         if (end >= 0) {
             const line = code.substring(index, end);
-            const replaced = "__yPOBaOUW = \"" + licenseResult.type + "\"";
+            const replaced = "yBXL = \"" + licenseResult.type + "\"";
             code = code.replace(line, replaced);
         }
 
         // Also inject JWT if available
         if (licenseResult.jwt) {
-            const jwtIndex = code.indexOf("__WafDZgBF");
+            const jwtIndex = code.indexOf("VkS");
             if (jwtIndex >= 0) {
                 const jwtEnd = code.indexOf(";", jwtIndex);
                 if (jwtEnd >= 0) {
                     const jwtLine = code.substring(jwtIndex, jwtEnd);
-                    const jwtReplaced = "__WafDZgBF = \"" + licenseResult.jwt + "\"";
+                    const jwtReplaced = "VkS = \"" + licenseResult.jwt + "\"";
                     code = code.replace(jwtLine, jwtReplaced);
                 }
             }

package/plugins/license/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { generateLicenseFile } from "./index.js";
+import { needleGreenBold, needleLog, resetLastLoggedPlugin } from "../vite/logging.js";
 
 let out;
 let team;
@@ -25,19 +26,21 @@ for (let i = 0; i < args.length; i++) {
         team = arg.slice(7);
     }
     else {
-        console.error(`[needle-license] Unknown argument: ${arg}`);
+        needleLog("needle-license", `Unknown argument: ${arg}`, "error", { dimBody: false });
         process.exit(1);
     }
 }
 if (requestedOut && (!out || out.startsWith("--")) || requestedTeam && (!team || team.startsWith("--"))) {
-    console.error("[needle-license] --out and --team require a value.");
+    needleLog("needle-license", "--out and --team require a value.", "error", { dimBody: false });
     process.exit(1);
 }
 try {
     const result = await generateLicenseFile({ out, team });
-    console.log(`[needle-license] ${result.signed ? "Signed license" : "Basic fallback"} written to ${result.output}`);
+    resetLastLoggedPlugin();
+    const status = result.signed ? needleGreenBold("Signed license") : "Basic fallback";
+    needleLog("needle-license", `${status} written to ${result.output}`, "log", { dimBody: false });
 }
 catch (error) {
-    console.error("[needle-license]", error);
+    needleLog("needle-license", error instanceof Error ? error.stack ?? error.message : String(error), "error", { dimBody: false });
     process.exitCode = 1;
 }

package/plugins/vite/build-pipeline.js

@@ -557,7 +557,7 @@ async function invokeBuildPipeline(opts, options = {}) {
     else {
         // First check if the user passed in a specific version to use via the vite config
         let version = opts.buildPipeline?.version;
-        let versionSource = version ? "vite" : "";
+        let versionSource = version ? "vite" : "default";
         // If not, check env var (set by Unity/Blender integrations)
         if (!version && process.env.NEEDLE_BUILD_PIPELINE_VERSION) {
             version = process.env.NEEDLE_BUILD_PIPELINE_VERSION;
@@ -767,6 +767,11 @@ async function invokeBuildPipeline(opts, options = {}) {
             const success = code === 0;
             if (!success) {
                 log(`Process failed with exit code ${code}`);
+                if (resolvedPipelineVersion) {
+                    needleLog("needle-buildpipeline",
+                        "To override the pipeline version, set buildPipeline.version in your Vite config or NEEDLE_BUILD_PIPELINE_VERSION when running npm.",
+                        "log", { dimBody: false, showHeader: false, leadingNewline: true });
+                }
                 if (pipelineReportedUnknownOption) {
                     const pinned = resolvedPipelineVersion ? `@${resolvedPipelineVersion}` : "";
                     needleLog("needle-buildpipeline",

package/plugins/vite/license.js

@@ -49,12 +49,12 @@ export function needleLicense(command, config, userSettings) {
                 let modified = false;
 
                 // Replace license type
-                const index = src.indexOf("__yPOBaOUW");
+                const index = src.indexOf("yBXL");
                 if (index >= 0) {
                     const end = src.indexOf(";", index);
                     if (end >= 0) {
                         const line = src.substring(index, end);
-                        const replaced = "__yPOBaOUW = \"" + licenseResult.type + "\"";
+                        const replaced = "yBXL = \"" + licenseResult.type + "\"";
                         src = src.replace(line, replaced);
                         modified = true;
                     }
@@ -62,12 +62,12 @@ export function needleLicense(command, config, userSettings) {
 
                 // Replace license JWT (same pattern)
                 if (licenseResult.jwt) {
-                    const jwtIndex = src.indexOf("__WafDZgBF");
+                    const jwtIndex = src.indexOf("VkS");
                     if (jwtIndex >= 0) {
                         const jwtEnd = src.indexOf(";", jwtIndex);
                         if (jwtEnd >= 0) {
                             const jwtLine = src.substring(jwtIndex, jwtEnd);
-                            const jwtReplaced = "__WafDZgBF = \"" + licenseResult.jwt + "\"";
+                            const jwtReplaced = "VkS = \"" + licenseResult.jwt + "\"";
                             src = src.replace(jwtLine, jwtReplaced);
                             modified = true;
                         }

package/plugins/vite/logger.client.js

@@ -1,6 +1,21 @@
 // @ts-check
 
 let isStringifying = false;
+let isSocketConnected = false;
+/** @type {Array<{level: string, message: string}>} */
+const pendingLogs = [];
+
+if (import.meta.hot) {
+    import.meta.hot.on("vite:ws:connect", () => {
+        isSocketConnected = true;
+        for (const log of pendingLogs.splice(0)) {
+            import.meta.hot?.send("needle:client-log", log);
+        }
+    });
+    import.meta.hot.on("vite:ws:disconnect", () => {
+        isSocketConnected = false;
+    });
+}
 
 /**
  * Patches console methods to capture log messages and send them to the server.
@@ -17,16 +32,14 @@ function sendLogToServer(level, ...message) {
             if (msg.length > 100_000) {
                 msg = msg.slice(0, 100_000) + "... <truncated>";
             }
-            // @ts-ignore
-            import.meta.hot.send("needle:client-log", { level, message: msg });
-        } catch (/** @type {any} */ e) {
-            // silently fail but send a message
-            try {
-                import.meta.hot?.send("needle:client-log", { level: "error", message: `Error during logging: ${e?.message ?? String(e)}` });
+            if (isSocketConnected && import.meta.hot) {
+                import.meta.hot.send("needle:client-log", { level, message: msg });
             }
-            catch (/** @type {unknown} */ e2) {
-                // fallback failed as well
+            else if (pendingLogs.length < 100) {
+                pendingLogs.push({ level, message: msg });
             }
+        } catch (/** @type {any} */ e) {
+            // Logging must not break the page if serialization or HMR fails.
         }
         finally {
             isStringifying = false;

package/src/engine/api.ts

@@ -237,7 +237,7 @@ export * from "./engine_input.js";
 export { InstancingUtil } from "./engine_instancing.js";
 
 /** License checking utilities */
-export { __Pekxq, sUknx, _fncZ } from "./engine_license.js";
+export { _yActo, $TiDhB, __mor } from "./engine_license.js";
 
 
 // ============================================================================
@@ -293,6 +293,7 @@ export {
  * decorator-wrapped ("_DragControls"); document writers need the wire name */
 export { originalComponentNameKey } from "./engine_instantiate_resolve.js";
 export { enableProjectDocumentInspection, getProjectDocumentInspection, type ProjectInspectionTarget } from "./project-document/engine_project_document_inspection.js";
+export { registerDocumentExtensionProvider, type DocumentExtensionRegistration } from './project-document/engine_document_extensions.js';
 
 
 // ============================================================================

package/src/engine/engine_context.ts

@@ -35,6 +35,7 @@ import { Input } from './engine_input.js';
 import { Telemetry } from './engine_license.js';
 import { invokeLifecycleFunctions } from './engine_lifecycle_functions_internal.js';
 import { type ILightDataRegistry, LightDataRegistry } from './engine_lightdata.js';
+import { disposeGLTFLoaders } from './engine_loaders.gltf.js';
 import { LODsManager } from "./engine_lods.js";
 import * as looputils from './engine_mainloop_utils.js';
 import { NetworkConnection } from './engine_networking.js';
@@ -303,6 +304,14 @@ export class Context implements IContext {
 	}
 	private _lifecycle: ContextLifecycleMode = "running";
 
+	/** Completes queued loading/setup callbacks without rendering or stepping simulation. */
+	flushPendingSceneSetup(): void {
+		const previous = Context.Current;
+		Context.Current = this;
+		try { looputils.processPreSetupCallbacks(this); }
+		finally { Context.Current = previous; }
+	}
+
 	/**
 	 * Called when switching from "held" back to "running": while held, hierarchy active
 	 * flags keep updating but activation callbacks are gated. Components that were never
@@ -1169,6 +1178,8 @@ export class Context implements IContext {
 		// this they are never emptied: a SPA that repeatedly creates and destroys <needle-engine>
 		// elements keeps every loaded file and image alive for the lifetime of the document.
 		if (ContextRegistry.Registered.length === 0) {
+			Physics.disposeMeshBVHWorkers();
+			disposeGLTFLoaders();
 			clearAssetCaches();
 			// Progressive geometry promises strongly retain meshes and their textures
 			// through resource-user tracking. The cache is shared by all contexts.

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 { _BQhd } from "./engine_license.js";
+import { _htxWDE } 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();
-    _BQhd();
+    _htxWDE();
 
     // Must be last. customElements.define() upgrades existing <needle-engine>
     // elements synchronously, which can trigger context.create() and dispatch

package/src/engine/engine_license.ts

@@ -42,19 +42,19 @@ function setLicenseTimeout(ctx: IContext, callback: () => void, delay: number) {
     return timer;
 }
 
-const $SzX: ((result: boolean) => void)[] = [];
+const $bvy: ((result: boolean) => void)[] = [];
 
 // DO NOT EDIT MANUALLY
-let __yPOBaOUW: string = "";
+let yBXL: string = "";
 // eslint-disable-next-line prefer-const
-let __WafDZgBF: string = "";
+let VkS: string = "";
 
 if (debug) {
-    console.log("License Type: " + __yPOBaOUW);
-    if (__WafDZgBF) {
-        console.log("License JWT: " + __WafDZgBF);
+    console.log("License Type: " + yBXL);
+    if (VkS) {
+        console.log("License JWT: " + VkS);
         try {
-            const payload = JSON.parse(atob(__WafDZgBF.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
+            const payload = JSON.parse(atob(VkS.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
             console.log("License JWT payload:", payload);
         }
         catch { console.log("License JWT payload: (failed to decode)"); }
@@ -65,8 +65,8 @@ if (debug) {
 }
 
 /** @internal */
-export function _fncZ() {
-    switch (__yPOBaOUW) {
+export function __mor() {
+    switch (yBXL) {
         case "pro":
         case "enterprise":
             return true;
@@ -75,8 +75,8 @@ export function _fncZ() {
 }
 
 /** @internal */
-export function sUknx() {
-    switch (__yPOBaOUW) {
+export function $TiDhB() {
+    switch (yBXL) {
         case "indie":
             return true;
     }
@@ -84,8 +84,8 @@ export function sUknx() {
 }
 
 /** @internal */
-export function $QiwPI() {
-    switch (__yPOBaOUW) {
+export function __cshwS() {
+    switch (yBXL) {
         case "edu":
             return true;
     }
@@ -93,26 +93,26 @@ export function $QiwPI() {
 }
 
 /** @internal */
-export function __Pekxq() {
-    return _fncZ() || sUknx() || $QiwPI();
+export function _yActo() {
+    return __mor() || $TiDhB() || __cshwS();
 }
 
 
 /** @internal */
-export function _$uqE(cb: (result: boolean) => void) {
-    if (_fncZ() || sUknx() || $QiwPI()) {
+export function _PvsqpIB(cb: (result: boolean) => void) {
+    if (__mor() || $TiDhB() || __cshwS()) {
         cb(true);
         return () => {};
     }
-    $SzX.push(cb);
+    $bvy.push(cb);
     return () => {
-        const index = $SzX.indexOf(cb);
-        if (index >= 0) $SzX.splice(index, 1);
+        const index = $bvy.indexOf(cb);
+        if (index >= 0) $bvy.splice(index, 1);
     };
 }
 
-function _VnbrRHk(result: boolean) {
-    for (const cb of $SzX) {
+function GuxGgwYi(result: boolean) {
+    for (const cb of $bvy) {
         try {
             cb(result);
         }
@@ -127,7 +127,7 @@ function _VnbrRHk(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 _TkYHC = {
+const $xvChBB = {
     kty: "EC",
     crv: "P-256",
     x: "A34nyKMjhQYVgzeE4tyLUYdx34TAKogDa7v7PRaO9Lg",
@@ -151,7 +151,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 $DgqUv(jwt: string): Promise<string | null> {
+async function _yCe(jwt: string): Promise<string | null> {
     if (!jwt) return null;
     try {
         const parts = jwt.split(".");
@@ -161,7 +161,7 @@ async function $DgqUv(jwt: string): Promise<string | null> {
 
         const key = await crypto.subtle.importKey(
             "jwk",
-            _TkYHC,
+            $xvChBB,
             { name: "ECDSA", namedCurve: "P-256" },
             false,
             ["verify"]
@@ -221,16 +221,16 @@ async function $DgqUv(jwt: string): Promise<string | null> {
 }
 
 /** Verify the injected JWT and update the license type if valid.
- * The engine ONLY trusts the JWT — the plain __yPOBaOUW string is ignored. */
+ * The engine ONLY trusts the JWT — the plain yBXL string is ignored. */
 let _jwtVerificationPromise: Promise<void> | undefined = undefined;
-async function __sXiZ(): Promise<void> {
+async function uztEyYP(): Promise<void> {
     // The bundled JWT may be empty when a build supplies a signed license file.
     // Do not return early: the meta tag below may provide the JWT instead.
     // Keep the bundled binding mutable so Vite's esbuild pre-bundling does not
     // treat its initial empty value as constant and remove JWT verification.
-    let jwt = __WafDZgBF;
+    let jwt = VkS;
     // Clear the bundled JWT after reading it; this assignment keeps the binding mutable.
-    __WafDZgBF = "";
+    VkS = "";
     if (!jwt && typeof document !== "undefined") {
         const licenseFile = document.querySelector('meta[name="needle-license"]')?.getAttribute("content");
         if (licenseFile) {
@@ -247,14 +247,14 @@ async function __sXiZ(): Promise<void> {
             }
         }
     }
-    const verifiedType = await $DgqUv(jwt);
+    const verifiedType = await _yCe(jwt);
     if (verifiedType) {
-        __yPOBaOUW = verifiedType;
+        yBXL = verifiedType;
         if (debug) console.log("License type set from verified JWT: " + verifiedType);
-        _VnbrRHk(__Pekxq());
+        GuxGgwYi(_yActo());
     }
     else {
-        __yPOBaOUW = "basic";
+        yBXL = "basic";
         if (debug && jwt) console.warn("JWT verification failed — license reset to basic");
     }
 }
@@ -377,7 +377,7 @@ export namespace Telemetry {
         // NOTE: this does NOT affect license enforcement — the /check call, the "forbidden"
         // overlay and the watermark/logo run on separate, ungated code paths.
         const attribute = domElement?.getAttribute("no-telemetry");
-        if (_fncZ() && (attribute === "" || attribute === "true" || attribute === "1")) {
+        if (__mor() && (attribute === "" || attribute === "true" || attribute === "1")) {
             if (debug) console.debug("Telemetry is disabled via no-telemetry attribute");
             return false;
         }
@@ -705,21 +705,21 @@ export namespace Telemetry {
 }
 
 
-export function _BQhd() {
+export function _htxWDE() {
 
-    if(__yPOBaOUW === "") __yPOBaOUW = "basic";
+    if(yBXL === "") yBXL = "basic";
 
     // Start JWT verification — must be here (not top-level) to avoid tree-shaking
-    _jwtVerificationPromise = __sXiZ();
+    _jwtVerificationPromise = uztEyYP();
     // Start after setting the initial type. At module scope the type was still "",
     // so Basic builds skipped the runtime check entirely.
-    $SIQKzPW = __IdN();
+    eNaXOZj = __mTgB();
 
     Telemetry.init();
     ContextRegistry.registerCallback(ContextEvent.ContextRegistered, evt => {
-        __NkAi(evt.context);
-        gpJbHEa(evt.context);
-        setLicenseTimeout(evt.context, () => _$qviwgZA(evt.context), 2000);
+        __vTpQGDw(evt.context);
+        _$ygon(evt.context);
+        setLicenseTimeout(evt.context, () => NNhYdA(evt.context), 2000);
     });
     // ContextCreated fires after the renderer exists, so the canvas is available for context-loss monitoring
     ContextRegistry.registerCallback(ContextEvent.ContextCreated, evt => {
@@ -728,17 +728,17 @@ export function _BQhd() {
     });
 }
 
-export let $SIQKzPW: Promise<void> | undefined = undefined;
+export let eNaXOZj: Promise<void> | undefined = undefined;
 let applicationIsForbidden = false;
 let applicationForbiddenText = "";
-async function __IdN() {
+async function __mTgB() {
     // Only perform the runtime license check once
-    if ($SIQKzPW) return $SIQKzPW;
+    if (eNaXOZj) return eNaXOZj;
     // Wait for JWT verification to complete first (if running)
     if (_jwtVerificationPromise) {
         await _jwtVerificationPromise;
     }
-    if (__yPOBaOUW === "basic") {
+    if (yBXL === "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, {
@@ -750,27 +750,27 @@ async function __IdN() {
             if (res?.status === 200) {
                 applicationIsForbidden = false;
                 if (debug) console.log("License check succeeded");
-                __yPOBaOUW = "pro";
-                _VnbrRHk(true);
+                yBXL = "pro";
+                GuxGgwYi(true);
             }
             else if (res?.status === 403) {
-                _VnbrRHk(false);
+                GuxGgwYi(false);
                 applicationIsForbidden = true;
                 applicationForbiddenText = await res.text();
             }
             else {
-                _VnbrRHk(false);
+                GuxGgwYi(false);
                 if (debug) console.log("License check failed with status " + res?.status);
             }
         }
         catch (err) {
-            _VnbrRHk(false);
+            GuxGgwYi(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 \"" + __yPOBaOUW + "\"");
+    else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + yBXL + "\"");
 }
-async function gpJbHEa(ctx: IContext) {
+async function _$ygon(ctx: IContext) {
     function createForbiddenElement() {
         const div = document.createElement("div");
         div.className = "needle-forbidden";
@@ -835,40 +835,40 @@ async function gpJbHEa(ctx: IContext) {
     }, 500)
 }
 
-async function __NkAi(ctx: IContext) {
+async function __vTpQGDw(ctx: IContext) {
     try {
-        if (!_fncZ() && !sUknx()) {
-            return _$SggUg(ctx);
+        if (!__mor() && !$TiDhB()) {
+            return OGuHjhL(ctx);
         }
     }
     catch (err) {
         if (debug) console.log("License check failed", err)
-        return _$SggUg(ctx)
+        return OGuHjhL(ctx)
     }
-    if (debug) _$SggUg(ctx)
+    if (debug) OGuHjhL(ctx)
 }
 
 
 
-async function _$SggUg(ctx: IContext) {
+async function OGuHjhL(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 $SIQKzPW?.catch(() => { });
+    await eNaXOZj?.catch(() => { });
 
 
-    if (_fncZ() || sUknx()) return;
-    if (__Pekxq() === false) __cOTtAEOb();
+    if (__mor() || $TiDhB()) return;
+    if (_yActo() === false) $xSLUxq();
 
     // check if the engine is already ready (meaning has finished loading)
     if (isReady) {
-        _pphXrOg(ctx);
+        _$EZMmp(ctx);
     }
     else {
         ctx.domElement.addEventListener("ready", () => {
-            _pphXrOg(ctx);
+            _$EZMmp(ctx);
         });
     }
 }
@@ -876,7 +876,7 @@ async function _$SggUg(ctx: IContext) {
 // const licenseElementIdentifier = "needle-license-element";
 // const licenseDuration = 10000;
 // const licenseDelay = 1200;
-function _pphXrOg(ctx: IContext) {
+function _$EZMmp(ctx: IContext) {
 
     const style = `
         position: relative;
@@ -889,7 +889,7 @@ function _pphXrOg(ctx: IContext) {
         padding: 10px;
         padding-left: 30px;
     `;
-    if (__yPOBaOUW === "edu") {
+    if (yBXL === "edu") {
         if (navigator.webdriver) {
             console.log("This project is supported by Needle for Education – https://needle.tools");
         }
@@ -946,7 +946,7 @@ function _pphXrOg(ctx: IContext) {
         }
     }, 1000);
 
-    if ($QiwPI()) {
+    if (__cshwS()) {
         const removeDelay = 20_000;
         setLicenseTimeout(ctx, () => {
             clearInterval(interval);
@@ -955,7 +955,7 @@ function _pphXrOg(ctx: IContext) {
             const intervalInMinutes = 5;
             setLicenseTimeout(ctx, () => {
                 if (ctx.domElement.parentNode)
-                    _pphXrOg(ctx);
+                    _$EZMmp(ctx);
             }, 1000 * 60 * intervalInMinutes)
         }, removeDelay);
     }
@@ -966,7 +966,7 @@ function _pphXrOg(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 __cOTtAEOb(_logo?: string) {
+async function $xSLUxq(_logo?: string) {
     const now = Date.now();
     if (now - lastLogTime < 2000) return;
     lastLogTime = now;
@@ -999,7 +999,7 @@ async function __cOTtAEOb(_logo?: string) {
 }
 
 
-async function _$qviwgZA(context: IContext) {
+async function NNhYdA(context: IContext) {
     // isAllowed() now also covers cross-origin-isolated pages (where beacons can't be sent)
     // and Do Not Track / GPC.
     if (!Telemetry.isAllowed(context)) {
@@ -1013,7 +1013,7 @@ async function _$qviwgZA(context: IContext) {
 
             // current url without query parameters
             const currentUrl = window.location.href.split("?")[0];
-            const license = __yPOBaOUW;
+            const license = yBXL;
 
             const beaconData = {
                 license,

package/src/engine/engine_loaders.gltf.ts

@@ -1,11 +1,11 @@
 
-import { addDracoAndKTX2Loaders as addDracoAndKTX2LoadersGLTFProgressive, configureLoader, createLoaders, setDracoDecoderLocation, setKTX2TranscoderLocation } from '@needle-tools/gltf-progressive';
+import { addDracoAndKTX2Loaders as addDracoAndKTX2LoadersGLTFProgressive, configureLoader, createLoaders, disposeLoaders, setDracoDecoderLocation, setKTX2TranscoderLocation } from '@needle-tools/gltf-progressive';
 import { MeshoptDecoder } from 'three/examples/jsm/libs/meshopt_decoder.module.js';
 import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js'
 import { KTX2Loader } from 'three/examples/jsm/loaders/KTX2Loader.js';
 
-import { Context } from "./engine_setup.js"
+import type { Context } from "./engine_setup.js"
 import { getParam } from "./engine_utils.js";
 
 const debug = getParam("debugdecoders");
@@ -20,6 +20,12 @@ function ensureLoaders() {
     return loaders;
 }
 
+/** Release shared decoder workers after the last engine context is destroyed. */
+export function disposeGLTFLoaders() {
+    disposeLoaders();
+    loaders = null;
+}
+
 export function setDracoDecoderPath(path: string | undefined) {
     if (path !== undefined && typeof path === "string") {
         setDracoDecoderLocation(path);