@luminocity/lemonate-engine 26.4.4 → 26.4.7

package/dist/lemonate.js

@@ -87367,7 +87367,7 @@ void main() {
 	    }
 	}
 
-	var engine$1 = "26.4.4";
+	var engine$1 = "26.4.7";
 	var bullet = "3.26";
 	var lua = "5.4.3";
 	var packageVersionInfo = {
@@ -225931,222 +225931,222 @@ var<${access}> ${ name } : ${ structName };`;
 	    }
 	    async render(renderPassInfo) {
 	        this.renderPassInfo = renderPassInfo;
-	        const renderTask = this.engine.profiler.start("RenderView", "render");
-	        try {
-	            // Activate our canvas for use with canvas Lua API
-	            // ----------------------------------------------------------------------------------
-	            if (this.canvas) {
-	                this.renderer.setActiveCanvas(this.canvas);
-	                this.canvas.checkResize(renderPassInfo.resolution);
-	            }
-	            // Activate our scene graph collection
-	            // ----------------------------------------------------------------------------------
-	            const sceneGraphCollection = renderPassInfo.sceneGraphCollection;
-	            this.engine.setActiveSceneGraphCollection(sceneGraphCollection);
-	            const rootScene = sceneGraphCollection.getRootScene();
-	            let primaryScene = sceneGraphCollection.getPrimaryScene();
-	            // We do no physics particles and scripting unless we're in the main scene graph collection.
-	            // This is temporarily, until everything has been untangled properly and every sceneGraphCollection
-	            // is completely independant from all others
-	            // ----------------------------------------------------------------------------------
-	            const isMainSceneGraphCollection = this.engine.mainSceneGraphCollection === sceneGraphCollection;
-	            const doPhysics = isMainSceneGraphCollection;
-	            const doParticleSystemUpdate = isMainSceneGraphCollection;
-	            const doScripting = isMainSceneGraphCollection;
-	            // Update physics objects and call update/tick methods
-	            // ----------------------------------------------------------------------------------
-	            if (!renderPassInfo.playerIsPaused) {
-	                if (doPhysics) {
-	                    this.engine.profiler.measure("Physics", "processUpdate", async () => {
-	                        this.engine.physics.processPhysicsUpdate();
-	                    });
+	        await this.engine.profiler.measureAsync("RenderView", "render", async () => {
+	            try {
+	                // Activate our canvas for use with canvas Lua API
+	                // ----------------------------------------------------------------------------------
+	                if (this.canvas) {
+	                    this.renderer.setActiveCanvas(this.canvas);
+	                    this.canvas.checkResize(renderPassInfo.resolution);
 	                }
-	                if (doScripting) {
-	                    await this.engine.profiler.measureAsync("Scripting", "update", async () => {
-	                        return this.engine.player.update();
-	                    });
+	                // Activate our scene graph collection
+	                // ----------------------------------------------------------------------------------
+	                const sceneGraphCollection = renderPassInfo.sceneGraphCollection;
+	                this.engine.setActiveSceneGraphCollection(sceneGraphCollection);
+	                const rootScene = sceneGraphCollection.getRootScene();
+	                let primaryScene = sceneGraphCollection.getPrimaryScene();
+	                // We do no physics particles and scripting unless we're in the main scene graph collection.
+	                // This is temporarily, until everything has been untangled properly and every sceneGraphCollection
+	                // is completely independant from all others
+	                // ----------------------------------------------------------------------------------
+	                const isMainSceneGraphCollection = this.engine.mainSceneGraphCollection === sceneGraphCollection;
+	                const doPhysics = isMainSceneGraphCollection;
+	                const doParticleSystemUpdate = isMainSceneGraphCollection;
+	                const doScripting = isMainSceneGraphCollection;
+	                // Update physics objects and call update/tick methods
+	                // ----------------------------------------------------------------------------------
+	                if (!renderPassInfo.playerIsPaused) {
+	                    if (doPhysics) {
+	                        this.engine.profiler.measure("Physics", "processUpdate", async () => {
+	                            this.engine.physics.processPhysicsUpdate();
+	                        });
+	                    }
+	                    if (doScripting) {
+	                        await this.engine.profiler.measureAsync("Scripting", "update", async () => {
+	                            return this.engine.player.update();
+	                        });
+	                    }
 	                }
-	            }
-	            // Call beforeRender hook on all items
-	            // ----------------------------------------------------------------------------------
-	            const itemInstances = this.engine.loadingManager.getAllItemInstances();
-	            for (const item of itemInstances) {
-	                item.beforeRender();
-	            }
-	            // Set camera mode
-	            // ----------------------------------------------------------------------------------
-	            if (this.cameraModeOverride !== CameraMode.None) {
-	                this.cameraMode = this.cameraModeOverride;
-	            }
-	            else {
-	                const primarySceneItem = sceneGraphCollection.getPrimarySceneItem();
-	                if (primarySceneItem && typeof primarySceneItem.getCameraMode === 'function')
-	                    this.cameraMode = primarySceneItem.getCameraMode();
-	                else
-	                    this.cameraMode = CameraMode.AutomaticUserControllable;
-	            }
-	            // Set clear color
-	            // ----------------------------------------------------------------------------------
-	            if (primaryScene.userData?.customRenderSettings) {
-	                const clearColor = primaryScene.userData.customRenderSettings.clearColor;
-	                if (clearColor) {
-	                    const clearColorRGB = (clearColor.r << 16) + (clearColor.g << 8) + clearColor.b;
-	                    this.webGlRenderer.setClearColor(clearColorRGB, clearColor.a / 255);
+	                // Call beforeRender hook on all items
+	                // ----------------------------------------------------------------------------------
+	                const itemInstances = this.engine.loadingManager.getAllItemInstances();
+	                for (const item of itemInstances) {
+	                    item.beforeRender();
+	                }
+	                // Set camera mode
+	                // ----------------------------------------------------------------------------------
+	                if (this.cameraModeOverride !== CameraMode.None) {
+	                    this.cameraMode = this.cameraModeOverride;
 	                }
 	                else {
-	                    this.webGlRenderer.setClearColor(0x000000, 1);
+	                    const primarySceneItem = sceneGraphCollection.getPrimarySceneItem();
+	                    if (primarySceneItem && typeof primarySceneItem.getCameraMode === 'function')
+	                        this.cameraMode = primarySceneItem.getCameraMode();
+	                    else
+	                        this.cameraMode = CameraMode.AutomaticUserControllable;
 	                }
-	            }
-	            else {
-	                this.webGlRenderer.setClearColor(0x000000, 1);
-	            }
-	            // Set fog of the primary scene if any
-	            // ----------------------------------------------------------------------------------
-	            // @ts-ignore
-	            rootScene.fog = primaryScene.fog;
-	            // Animate scene
-	            // ----------------------------------------------------------------------------------
-	            if (!renderPassInfo.playerIsPaused) {
-	                this.engine.profiler.measure("RenderView", "animate", async () => {
-	                    this._animate(sceneGraphCollection, renderPassInfo.deltaPlayerTimeMs);
-	                });
-	            }
-	            // Init GUI
-	            // ----------------------------------------------------------------------------------
-	            const needToRenderGui = this.engine.player.needToRenderGui();
-	            if (needToRenderGui) {
-	                renderPassInfo.guiCaptureInfo = this.engine.imgui.newFrame(renderPassInfo.currentPlayerTimeMs);
-	            }
-	            if (doParticleSystemUpdate)
-	                this.renderer.renderParticleSystems(renderPassInfo);
-	            this.renderer.updateViewHelper(renderPassInfo);
-	            this.renderer.updateControls(renderPassInfo);
-	            // whenever we playback, we assume, we're moving
-	            if (this.engine.player && this.engine.player.isPlaying()) {
-	                renderPassInfo.didMove = true;
-	            }
-	            if (!renderPassInfo.cameraIsStill && renderPassInfo.currentTimeMs - renderPassInfo.lastMovementMs > 500) {
-	                renderPassInfo.cameraIsStill = true;
-	                renderPassInfo.didMove = true;
-	            }
-	            // Check if we actually need to render a frame due to movements or data updates
-	            // ----------------------------------------------------------------------------------
-	            if (renderPassInfo.didMove ||
-	                renderPassInfo.screenWasResized ||
-	                this.renderer.alwaysRender ||
-	                this.renderer.updateRender) {
-	                if (this.webGlRenderer && this.renderer.activeCamera) {
-	                    renderPassInfo.cameraDidMove = renderPassInfo.didMove || renderPassInfo.screenWasResized;
-	                    // We'll remove the scene environment, because it will be applied to anything including
-	                    // helpers and we don't want that. We'll apply it manually in the hooks and set it back after rendering
-	                    // ----------------------------------------------------------------------------------
-	                    renderPassInfo.sceneEnvironment = primaryScene.environment;
-	                    renderPassInfo.sceneEnvironmentIntensity =
-	                        primaryScene.environmentIntensity !== undefined
-	                            ? primaryScene.environmentIntensity
-	                            : 1;
-	                    // Call before render to set any overrides like visibility, material or envmap
-	                    // ----------------------------------------------------------------------------------
-	                    this.beforeRender(renderPassInfo);
-	                    // Do light, material, etc. updates
-	                    // ----------------------------------------------------------------------------------
-	                    this.setRendererSettingsFromScene();
-	                    this.renderer.updateMaterialUniforms(renderPassInfo.currentPlayerTimeMs, renderPassInfo.resolution);
-	                    // Check if we have transform controls which we need to hide
-	                    // ----------------------------------------------------------------------------------
-	                    let transformControlsWereDisabled = false;
-	                    if (rootScene.transformControls &&
-	                        rootScene.transformControls.visible &&
-	                        (!renderPassInfo.renderOptions.showHelpers || this.renderer.editorOutputOption.outputMode !== OutputMode.EditorCamera)) {
-	                        transformControlsWereDisabled = true;
-	                        rootScene.transformControls.visible = false;
-	                    }
-	                    // Check if we need to render background and transfer to root scene
-	                    // ----------------------------------------------------------------------------------
-	                    rootScene.backgroundBlurriness = primaryScene.backgroundBlurriness;
-	                    rootScene.backgroundIntensity = primaryScene.backgroundIntensity;
-	                    if (!renderPassInfo.renderOptions.showBackground) {
-	                        rootScene.background = null;
-	                        rootScene.backgroundShader = undefined;
-	                    }
-	                    else if (this.renderer.backgroundOverrideColor) {
-	                        rootScene.background = tools.hexColorToColor(this.renderer.backgroundOverrideColor);
-	                        rootScene.backgroundShader = undefined;
+	                // Set clear color
+	                // ----------------------------------------------------------------------------------
+	                if (primaryScene.userData?.customRenderSettings) {
+	                    const clearColor = primaryScene.userData.customRenderSettings.clearColor;
+	                    if (clearColor) {
+	                        const clearColorRGB = (clearColor.r << 16) + (clearColor.g << 8) + clearColor.b;
+	                        this.webGlRenderer.setClearColor(clearColorRGB, clearColor.a / 255);
 	                    }
 	                    else {
-	                        rootScene.background = primaryScene.background;
-	                        rootScene.backgroundShader = primaryScene.backgroundShader;
-	                    }
-	                    // Render any items that need to be rendered first
-	                    // ----------------------------------------------------------------------------------
-	                    for (const item of itemInstances) {
-	                        item.render(rootScene, renderPassInfo);
-	                    }
-	                    // Update physics debug geometry
-	                    // ----------------------------------------------------------------------------------
-	                    if (doPhysics) {
-	                        this.engine.profiler.measure("Physics", "renderDebugInfo", () => {
-	                            this.engine.physics.renderDebugInfo();
-	                        });
-	                    }
-	                    // Render the scene
-	                    // ----------------------------------------------------------------------------------
-	                    this._renderScene(renderPassInfo);
-	                    // Call render hook
-	                    // ----------------------------------------------------------------------------------
-	                    if (!renderPassInfo.playerIsPaused && doScripting) {
-	                        await this.engine.profiler.measureAsync("Scripting", "render", () => {
-	                            return this.engine.player.render();
-	                        });
+	                        this.webGlRenderer.setClearColor(0x000000, 1);
 	                    }
-	                    // Create GUI
-	                    // ----------------------------------------------------------------------------------
-	                    if (needToRenderGui && doScripting) {
-	                        if (!renderPassInfo.playerIsPaused) {
-	                            await this.engine.profiler.measureAsync("Scripting", "renderGui", () => {
-	                                return this.engine.player.renderGui();
+	                }
+	                else {
+	                    this.webGlRenderer.setClearColor(0x000000, 1);
+	                }
+	                // Set fog of the primary scene if any
+	                // ----------------------------------------------------------------------------------
+	                // @ts-ignore
+	                rootScene.fog = primaryScene.fog;
+	                // Animate scene
+	                // ----------------------------------------------------------------------------------
+	                if (!renderPassInfo.playerIsPaused) {
+	                    this.engine.profiler.measure("RenderView", "animate", async () => {
+	                        this._animate(sceneGraphCollection, renderPassInfo.deltaPlayerTimeMs);
+	                    });
+	                }
+	                // Init GUI
+	                // ----------------------------------------------------------------------------------
+	                const needToRenderGui = this.engine.player.needToRenderGui();
+	                if (needToRenderGui) {
+	                    renderPassInfo.guiCaptureInfo = this.engine.imgui.newFrame(renderPassInfo.currentPlayerTimeMs);
+	                }
+	                if (doParticleSystemUpdate)
+	                    this.renderer.renderParticleSystems(renderPassInfo);
+	                this.renderer.updateViewHelper(renderPassInfo);
+	                this.renderer.updateControls(renderPassInfo);
+	                // whenever we playback, we assume, we're moving
+	                if (this.engine.player && this.engine.player.isPlaying()) {
+	                    renderPassInfo.didMove = true;
+	                }
+	                if (!renderPassInfo.cameraIsStill && renderPassInfo.currentTimeMs - renderPassInfo.lastMovementMs > 500) {
+	                    renderPassInfo.cameraIsStill = true;
+	                    renderPassInfo.didMove = true;
+	                }
+	                // Check if we actually need to render a frame due to movements or data updates
+	                // ----------------------------------------------------------------------------------
+	                if (renderPassInfo.didMove ||
+	                    renderPassInfo.screenWasResized ||
+	                    this.renderer.alwaysRender ||
+	                    this.renderer.updateRender) {
+	                    if (this.webGlRenderer && this.renderer.activeCamera) {
+	                        renderPassInfo.cameraDidMove = renderPassInfo.didMove || renderPassInfo.screenWasResized;
+	                        // We'll remove the scene environment, because it will be applied to anything including
+	                        // helpers and we don't want that. We'll apply it manually in the hooks and set it back after rendering
+	                        // ----------------------------------------------------------------------------------
+	                        renderPassInfo.sceneEnvironment = primaryScene.environment;
+	                        renderPassInfo.sceneEnvironmentIntensity =
+	                            primaryScene.environmentIntensity !== undefined
+	                                ? primaryScene.environmentIntensity
+	                                : 1;
+	                        // Call before render to set any overrides like visibility, material or envmap
+	                        // ----------------------------------------------------------------------------------
+	                        this.beforeRender(renderPassInfo);
+	                        // Do light, material, etc. updates
+	                        // ----------------------------------------------------------------------------------
+	                        this.setRendererSettingsFromScene();
+	                        this.renderer.updateMaterialUniforms(renderPassInfo.currentPlayerTimeMs, renderPassInfo.resolution);
+	                        // Check if we have transform controls which we need to hide
+	                        // ----------------------------------------------------------------------------------
+	                        let transformControlsWereDisabled = false;
+	                        if (rootScene.transformControls &&
+	                            rootScene.transformControls.visible &&
+	                            (!renderPassInfo.renderOptions.showHelpers || this.renderer.editorOutputOption.outputMode !== OutputMode.EditorCamera)) {
+	                            transformControlsWereDisabled = true;
+	                            rootScene.transformControls.visible = false;
+	                        }
+	                        // Check if we need to render background and transfer to root scene
+	                        // ----------------------------------------------------------------------------------
+	                        rootScene.backgroundBlurriness = primaryScene.backgroundBlurriness;
+	                        rootScene.backgroundIntensity = primaryScene.backgroundIntensity;
+	                        if (!renderPassInfo.renderOptions.showBackground) {
+	                            rootScene.background = null;
+	                            rootScene.backgroundShader = undefined;
+	                        }
+	                        else if (this.renderer.backgroundOverrideColor) {
+	                            rootScene.background = tools.hexColorToColor(this.renderer.backgroundOverrideColor);
+	                            rootScene.backgroundShader = undefined;
+	                        }
+	                        else {
+	                            rootScene.background = primaryScene.background;
+	                            rootScene.backgroundShader = primaryScene.backgroundShader;
+	                        }
+	                        // Render any items that need to be rendered first
+	                        // ----------------------------------------------------------------------------------
+	                        for (const item of itemInstances) {
+	                            item.render(rootScene, renderPassInfo);
+	                        }
+	                        // Update physics debug geometry
+	                        // ----------------------------------------------------------------------------------
+	                        if (doPhysics) {
+	                            this.engine.profiler.measure("Physics", "renderDebugInfo", () => {
+	                                this.engine.physics.renderDebugInfo();
 	                            });
 	                        }
-	                        this.engine.imgui.endFrame();
-	                    }
-	                    // Call the after render function to revert all the overrides
-	                    // ----------------------------------------------------------------------------------
-	                    this.afterRender(renderPassInfo);
-	                    // Render the canvas
-	                    // ----------------------------------------------------------------------------------
-	                    if (this.canvas)
-	                        this.canvas.render();
-	                    // Finish rendering GUI
-	                    // ----------------------------------------------------------------------------------
-	                    if (needToRenderGui && doScripting) {
-	                        this.engine.imgui.render();
-	                    }
-	                    this.webGlRenderer.resetState();
-	                    // Emit framebuffer as event, if queued
-	                    // ----------------------------------------------------------------------------------
-	                    if (this.renderer.emitFramebuffer) {
-	                        const frame = textureTools.grabFramebufferImage(this, renderPassInfo.viewport);
-	                        this.engine.eventBus.$emit("engine:frameBufferResult", frame);
-	                        this.renderer.emitFramebuffer = false;
-	                    }
-	                    // Restore transform controls
-	                    // ----------------------------------------------------------------------------------
-	                    if (transformControlsWereDisabled) {
-	                        rootScene.transformControls.visible = true;
+	                        // Render the scene
+	                        // ----------------------------------------------------------------------------------
+	                        this._renderScene(renderPassInfo);
+	                        // Call render hook
+	                        // ----------------------------------------------------------------------------------
+	                        if (!renderPassInfo.playerIsPaused && doScripting) {
+	                            await this.engine.profiler.measureAsync("Scripting", "render", () => {
+	                                return this.engine.player.render();
+	                            });
+	                        }
+	                        // Create GUI
+	                        // ----------------------------------------------------------------------------------
+	                        if (needToRenderGui && doScripting) {
+	                            if (!renderPassInfo.playerIsPaused) {
+	                                await this.engine.profiler.measureAsync("Scripting", "renderGui", () => {
+	                                    return this.engine.player.renderGui();
+	                                });
+	                            }
+	                            this.engine.imgui.endFrame();
+	                        }
+	                        // Call the after render function to revert all the overrides
+	                        // ----------------------------------------------------------------------------------
+	                        this.afterRender(renderPassInfo);
+	                        // Render the canvas
+	                        // ----------------------------------------------------------------------------------
+	                        if (this.canvas)
+	                            this.canvas.render();
+	                        // Finish rendering GUI
+	                        // ----------------------------------------------------------------------------------
+	                        if (needToRenderGui && doScripting) {
+	                            this.engine.imgui.render();
+	                        }
+	                        this.webGlRenderer.resetState();
+	                        // Emit framebuffer as event, if queued
+	                        // ----------------------------------------------------------------------------------
+	                        if (this.renderer.emitFramebuffer) {
+	                            const frame = textureTools.grabFramebufferImage(this, renderPassInfo.viewport);
+	                            this.engine.eventBus.$emit("engine:frameBufferResult", frame);
+	                            this.renderer.emitFramebuffer = false;
+	                        }
+	                        // Restore transform controls
+	                        // ----------------------------------------------------------------------------------
+	                        if (transformControlsWereDisabled) {
+	                            rootScene.transformControls.visible = true;
+	                        }
 	                    }
 	                }
 	            }
-	        }
-	        catch (err) {
-	            console.error(err);
-	        }
-	        finally {
-	            // we keep the canvas active for now since async script operations might still access it.
-	            // needs to be properly solved later.
-	            //this.renderer.setActiveCanvas(null);
-	            this.engine.setActiveSceneGraphCollection(undefined);
-	            renderTask.done();
-	        }
+	            catch (err) {
+	                console.error(err);
+	            }
+	            finally {
+	                // we keep the canvas active for now since async script operations might still access it.
+	                // needs to be properly solved later.
+	                //this.renderer.setActiveCanvas(null);
+	                this.engine.setActiveSceneGraphCollection(undefined);
+	            }
+	        });
 	    }
 	    _animate(sceneGraphCollection, deltaTimeMs) {
 	        const deltaTimeSecs = deltaTimeMs / 1000;
@@ -226898,7 +226898,7 @@ var<${access}> ${ name } : ${ structName };`;
 	    options;
 	    renderView = null;
 	    webGlRenderer;
-	    webGpuRenderer;
+	    //webGpuRenderer: WebGPURenderer;
 	    raycaster;
 	    renderers = {};
 	    requestFrameFuncs = [];
@@ -226975,7 +226975,7 @@ var<${access}> ${ name } : ${ structName };`;
 	            this.layers.push(`Layer ${i + 1}`);
 	        }
 	        this.webGlRenderer = this._createWebGlRenderer(options);
-	        this.webGpuRenderer = this._createWebGpuRenderer();
+	        //this.webGpuRenderer = this._createWebGpuRenderer();
 	        this.setDevicePixelRatio();
 	        this.setShadowType(ShadowMode.Pcf);
 	        this.setRendererSettings();
@@ -227065,12 +227065,6 @@ var<${access}> ${ name } : ${ structName };`;
 	        return webGpuRenderer;
 	    }
 	    async init() {
-	        try {
-	            await this.webGpuRenderer.init();
-	        }
-	        catch (err) {
-	            console.error("Failed to initialize WebGPU Renderer: ", err);
-	        }
 	        try {
 	            await loadFontFace("OpenSansRegular", openSansRegularUrl);
 	        }
@@ -227082,9 +227076,9 @@ var<${access}> ${ name } : ${ structName };`;
 	    getWebGLRenderer() {
 	        return this.webGlRenderer;
 	    }
-	    getWebGPURenderer() {
+	    /*getWebGPURenderer(): WebGPURenderer {
 	        return this.webGpuRenderer;
-	    }
+	    }*/
 	    hookEvents() {
 	        if (this.renderView) {
 	            // We have to remember the pressed buttons of the pointer controller because we will only ever receive a single
@@ -229736,6 +229730,11 @@ var<${access}> ${ name } : ${ structName };`;
 	                const droppedItemIsDescendantOfThis = this.isDescendantOf(sgDroppedItem);
 	                if (!droppedItemIsDescendantOfThis) {
 	                    this.engine.moveTreeItemsToNewParent([droppedItem.id], this.getId(), undefined, destinationSubNode);
+	                    // in case the item is dropped to a subnode, its parenting needs to be updated
+	                    if (destinationSubNode) {
+	                        sgDroppedItem.updateParenting();
+	                        sgDroppedItem.updateBoxHelper();
+	                    }
 	                    return true;
 	                }
 	            }
@@ -256098,9 +256097,9 @@ var<${access}> ${ name } : ${ structName };`;
 
 	var lua_api_audio = "\nlocal _internal = require('engine/_internal');\n\n--- @module audio\nlocal audio = {}\n\n---Get an FFT analysis from the audio engine. It returns an array of 256 samples\n---@function getAnalysis\nfunction audio.getAnalysis()\n  return _internal.sendMessage('audio.getAnalysis')\nend\n\nreturn audio\n";
 
-	var lua_api_behaviour = "local SceneObject = require('engine/sceneobject')\nlocal Canvas = require('engine/canvas')\nlocal JE = require('engine/json/jsonencoder')()\n\nlocal _behavioursMapByNodeId = {}\nlocal _behavioursMapByScriptId = {}\n\nlocal Behaviour = Class.new()\n\n-- Put the class in the global scope (Behaviour is the old deprecated name)\n_G.Behaviour = Behaviour\n_G.Entity = Behaviour\n\n--- Constructor hook called when a new Behaviour is created.\n---@private\nfunction Behaviour:__new()\n    self._isBehaviour = true\n    self._type = \"Behaviour\"\n    self._nodeId = nil\n    self._scriptName = \"\"\n    self._isActive = true\n    self._isInitialized = false\n\n    -- Adds a default node property\n    self:addProperty(\"node\", Property.Node)\nend\n\n--- Destructor hook called before the Behaviour is destroyed.\n---@private\nfunction Behaviour:__destroy()\n    print(\"__destroy called for: \", self._nodeId)\nend\n\n--- Get all behaviours attached to a specific node ID.\n---@param nodeId string The ID of the scene graph node\n---@return table A table containing all behaviours attached to the node\nfunction Behaviour.getByNodeId(nodeId)\n    local result = {}\n    local nodeBehaviours = _behavioursMapByNodeId[nodeId]\n    if nodeBehaviours then\n        for k,v in pairs(nodeBehaviours) do\n            table.insert(result, v.behaviour)\n        end\n    end\n    return result\nend\n\n--- Get a single behaviour attached to a node ID with a specific script name.\n---@param nodeId string The ID of the scene graph node\n---@param scriptName string The script name of the behaviour\n---@return Behaviour|nil The behaviour if found, or nil\nfunction Behaviour.getByNodeIdAndScriptName(nodeId, scriptName)\n    local nodeEntities = _behavioursMapByNodeId[nodeId]\n    if nodeEntities then\n        for k,v in pairs(nodeEntities) do\n            if v.scriptName == scriptName then\n                return v.behaviour\n            end\n        end\n    end\n    return nil\nend\n\n--- Returns the node ID this Behaviour is attached to.\n---@return string|nil Node ID of the attached scene object\nfunction Behaviour:getNodeId()\n    return self._nodeId\nend\n\n--- Returns the script name of this Behaviour.\n---@return string Script name\nfunction Behaviour:getScriptName()\n    return self._scriptName\nend\n\n--- Returns a table of all properties defined on the behaviour class.\n---@return table A table with fields: name, defaultValue, type, order\nfunction Behaviour:getProperties()\n    local props = {}\n    local class = self.getClass()\n\n    for k,v in pairs(class) do\n        if type(v) == 'table' and v._isProperty then\n            table.insert(props, { name=k, defaultValue=v.value, type=v.datatype, order=v.order, info=v.info })\n        end\n    end\n\n    for k,v in pairs(class.properties) do\n        if type(v) == 'table' and v._isProperty then\n            table.insert(props, { name=k, defaultValue=v.value, type=v.datatype, order=v.order, info=v.info })\n        end\n    end\n\n    return props\nend\n\n--- When a script is destroyed, we need to call this to clear the behaviour out of the list\n---@private\nfunction Behaviour:_disposeBehaviour()\n    local scripts = _behavioursMapByNodeId[self._nodeId]\n    if scripts then\n        scripts[self._scriptId] = nil\n    end\n\n    _behavioursMapByScriptId[self._scriptId] = nil\nend\n\n--- Internal setter for a property\n---@private\n---@param name string Property name\n---@param value any Value to set\nfunction Behaviour:_setProperty(name, value)\n    self[name] = value\nend\n\n--- Internal method to attach a scene node to this Behaviour\n---@private\n---@param msg table Contains fields: value=nodeId, scriptName, scriptId\nfunction Behaviour:_setNode(msg)\n    __assertTrace(type(msg) == 'table', \"_setNode() called with nil or a non-table.\")\n\n    if self.node then\n        error(\"Node is already set on behaviour!\")\n    end\n\n    local nodeId = msg.value\n    __assertTrace(type(nodeId) == 'string', \"_setNode() needs a nodeId of type string.\")\n\n    local node = SceneObject.findById(nodeId)\n    __assertTrace(node, \"_setNode() node not found\")\n\n    local scriptName = msg.scriptName\n    __assertTrace(scriptName, \"_setNode() needs a scriptName\")\n\n    local scriptId = msg.scriptId\n    __assertTrace(scriptId, \"_setNode() needs a scriptId\")\n\n    self.node = node\n    self._nodeId = nodeId\n    self._scriptName = msg.scriptName\n    self._scriptId = scriptId\n\n    _behavioursMapByScriptId[scriptId] = self\n\n    if not _behavioursMapByNodeId[nodeId] then\n        _behavioursMapByNodeId[nodeId] = {}\n    end\n    _behavioursMapByNodeId[nodeId][scriptId] = {\n        node = node,\n        scriptName = scriptName,\n        behaviour = self\n    }\nend\n\n--- Return the properties of this Behaviour as JSON\n---@private\n---@return string JSON string of properties\nfunction Behaviour:_getPropsJson()\n    return JE(self:getProperties())\nend\n\n--- Returns the active state of the behaviour. If the owner item is inactive, so are all attached behaviours\n---@return boolean true, if active, othersise false\nfunction Behaviour:isActive()\n    return self._isActive\nend\n\n--- Returns the initialized state of the behaviour. If true, init ran through or there is no init\n---@return boolean true, if initialized, othersise false\nfunction Behaviour:isInitialized()\n    return self._isInitialized\nend\n\n--- Clears all registered behaviours (used internally). They are expected to be empty anyway due to scripts\n--- cleaning up behind themselves. This function will assert this\n---@private\nfunction Behaviour._clearBehaviours()\n    -- Clear in-place to avoid any stale references to the _behaviours table object\n    -- preventing Lua GC from reclaiming behaviour instances.\n    for nodeId, nodeBehaviours in pairs(_behavioursMapByNodeId) do\n        -- nodeBehaviours is a keyed table (scriptId -> { ... })\n        if nodeBehaviours and next(nodeBehaviours) ~= nil then\n            -- This warning is useful when scripts forget to dispose their behaviours,\n            -- but the check previously used `#nodeBehaviours` which is incorrect for keyed tables.\n            print(\"WARNING: Some behaviours did not get cleaned properly. This is an engine bug!\")\n            -- Keep clearing anyway to enable GC.\n        end\n\n        if nodeBehaviours then\n            for scriptId in pairs(nodeBehaviours) do\n                nodeBehaviours[scriptId] = nil\n            end\n        end\n\n        _behavioursMapByNodeId[nodeId] = nil\n    end\n\n    -- Also clear the second map that has the behaviours by their script ID directly\n    _behavioursMapByScriptId = {}\nend\n\nfunction Behaviour:_init()\n    if type(self.init) == 'function' then\n        local ok, err = pcall(self.init, self)\n        if not ok then\n            print(self._scriptName .. \":init() failed:\", err)\n        end\n    end\n    self._isInitialized = true\n    self._isActive = true\nend\n\nfunction Behaviour:_ondisable()\n    self._isActive = false\n    if type(self.ondisable) == 'function' then\n        local ok, err = pcall(self.ondisable, self)\n        if not ok then\n            print(self._scriptName .. \":ondisable() failed:\", err)\n        end\n    end\nend\n\nfunction Behaviour:_onenable()\n    self._isActive = true\n    if type(self.onenable) == 'function' then\n        local ok, err = pcall(self.onenable, self)\n        if not ok then\n            print(self._scriptName .. \":onenable() failed:\", err)\n        end\n    end\nend\n\nfunction Behaviour:_ondestroy()\n    if type(self.ondestroy) == 'function' then\n        local ok, err = pcall(self.ondestroy, self)\n        if not ok then\n            print(self._scriptName .. \":ondestroy() failed:\", err)\n        end\n    end\n    self._isActive = false\n    self._isInitialized = false\nend\n\nfunction Behaviour._updateAll(deltaTime, deltaTimeSmooth)\n    local callcount = 0\n\n    for _, behaviour in pairs(_behavioursMapByScriptId) do\n        if behaviour._isActive and behaviour._isInitialized and type(behaviour.update) == 'function' then\n            callcount = callcount + 1\n            local ok, err = pcall(behaviour.update, behaviour, deltaTime, deltaTimeSmooth)\n            if not ok then\n                print(behaviour._scriptName .. \":update() failed:\", err)\n            end\n        end\n\n        -- call the deprecated prerender hook if it exists\n        if behaviour._isActive and behaviour._isInitialized and type(behaviour.prerender) == 'function' then\n            callcount = callcount + 1\n            local ok, err = pcall(behaviour.prerender, behaviour)\n            if not ok then\n                print(behaviour._scriptName .. \":prerender() failed:\", err)\n            end\n        end\n    end\n\n    return callcount\nend\n\nfunction Behaviour._renderAll()\n    local callcount = 0\n\n    for _, behaviour in pairs(_behavioursMapByScriptId) do\n        if behaviour._isActive and behaviour._isInitialized and type(behaviour.render) == 'function' then\n            callcount = callcount + 1\n            local ok, err = pcall(behaviour.render, behaviour, deltaTime, deltaTimeSmooth)\n            if not ok then\n                print(behaviour._scriptName .. \":render() failed:\", err)\n            end\n        end\n    end\n\n    Canvas.commit()\n\n    return callcount\nend\n\nfunction Behaviour._renderguiAll()\n    local callcount = 0\n\n    for _, behaviour in pairs(_behavioursMapByScriptId) do\n        if behaviour._isActive and behaviour._isInitialized and type(behaviour.rendergui) == 'function' then\n            callcount = callcount + 1\n            local ok, err = pcall(behaviour.rendergui, behaviour, deltaTime, deltaTimeSmooth)\n            if not ok then\n                print(behaviour._scriptName .. \":rendergui() failed:\", err)\n            end\n        end\n    end\n\n    return callcount\nend\n\nfunction Behaviour._setActive(nodes)\n    for scriptId, active in pairs(nodes) do\n        local node = _behavioursMapByScriptId[scriptId]\n        if node then\n            node._isActive = active\n        else\n            print(\"ERROR: Behaviour._setActive() cannot find script: \" .. scriptId)\n        end\n    end\nend\n\nfunction Behaviour._debugStats()\n    local nodeCount = 0\n    local behaviourCount = 0\n    for _, nodeBehaviours in pairs(_behavioursMapByNodeId) do\n        nodeCount = nodeCount + 1\n        if nodeBehaviours then\n            for _ in pairs(nodeBehaviours) do\n                behaviourCount = behaviourCount + 1\n            end\n        end\n    end\n\n    return {\n        nodeCount = nodeCount,\n        behaviourCount = behaviourCount\n    }\nend\n\nreturn Behaviour\n";
+	var lua_api_behaviour = "local SceneObject = require('engine/sceneobject')\nlocal Canvas = require('engine/canvas')\nlocal JE = require('engine/json/jsonencoder')()\n\nlocal _behavioursMapByNodeId = {}\nlocal _behavioursMapByScriptId = {}\nlocal _behavioursMapByExecutionOrder = {}\nlocal _executionIndex = 1\n\nlocal Behaviour = Class.new()\n\n-- Put the class in the global scope (Behaviour is the old deprecated name)\n_G.Behaviour = Behaviour\n_G.Entity = Behaviour\n\n--- Constructor hook called when a new Behaviour is created.\n---@private\nfunction Behaviour:__new()\n    self._isBehaviour = true\n    self._type = \"Behaviour\"\n    self._nodeId = nil\n    self._scriptName = \"\"\n    self._executionIndex = _executionIndex\n    self._isActive = true\n    self._isInitialized = false\n\n    _executionIndex = _executionIndex + 1\n\n    -- Adds a default node property\n    self:addProperty(\"node\", Property.Node)\nend\n\n--- Destructor hook called before the Behaviour is destroyed.\n---@private\nfunction Behaviour:__destroy()\n    print(\"__destroy called for: \", self._nodeId)\nend\n\n--- Get all behaviours attached to a specific node ID.\n---@param nodeId string The ID of the scene graph node\n---@return table A table containing all behaviours attached to the node\nfunction Behaviour.getByNodeId(nodeId)\n    local result = {}\n    local nodeBehaviours = _behavioursMapByNodeId[nodeId]\n    if nodeBehaviours then\n        for k,v in pairs(nodeBehaviours) do\n            table.insert(result, v.behaviour)\n        end\n    end\n    return result\nend\n\n--- Get a single behaviour attached to a node ID with a specific script name.\n---@param nodeId string The ID of the scene graph node\n---@param scriptName string The script name of the behaviour\n---@return Behaviour|nil The behaviour if found, or nil\nfunction Behaviour.getByNodeIdAndScriptName(nodeId, scriptName)\n    local nodeEntities = _behavioursMapByNodeId[nodeId]\n    if nodeEntities then\n        for k,v in pairs(nodeEntities) do\n            if v.scriptName == scriptName then\n                return v.behaviour\n            end\n        end\n    end\n    return nil\nend\n\n--- Returns the node ID this Behaviour is attached to.\n---@return string|nil Node ID of the attached scene object\nfunction Behaviour:getNodeId()\n    return self._nodeId\nend\n\n--- Returns the script name of this Behaviour.\n---@return string Script name\nfunction Behaviour:getScriptName()\n    return self._scriptName\nend\n\n--- Returns a table of all properties defined on the behaviour class.\n---@return table A table with fields: name, defaultValue, type, order\nfunction Behaviour:getProperties()\n    local props = {}\n    local class = self.getClass()\n\n    for k,v in pairs(class) do\n        if type(v) == 'table' and v._isProperty then\n            table.insert(props, { name=k, defaultValue=v.value, type=v.datatype, order=v.order, info=v.info })\n        end\n    end\n\n    for k,v in pairs(class.properties) do\n        if type(v) == 'table' and v._isProperty then\n            table.insert(props, { name=k, defaultValue=v.value, type=v.datatype, order=v.order, info=v.info })\n        end\n    end\n\n    return props\nend\n\n--- When a script is destroyed, we need to call this to clear the behaviour out of the list\n---@private\nfunction Behaviour:_disposeBehaviour()\n    local scripts = _behavioursMapByNodeId[self._nodeId]\n    if scripts then\n        scripts[self._scriptId] = nil\n    end\n\n    _behavioursMapByScriptId[self._scriptId] = nil\n    _behavioursMapByExecutionOrder[self._executionIndex] = nil\nend\n\n--- Internal setter for a property\n---@private\n---@param name string Property name\n---@param value any Value to set\nfunction Behaviour:_setProperty(name, value)\n    self[name] = value\nend\n\n--- Internal method to attach a scene node to this Behaviour\n---@private\n---@param msg table Contains fields: value=nodeId, scriptName, scriptId\nfunction Behaviour:_setNode(msg)\n    __assertTrace(type(msg) == 'table', \"_setNode() called with nil or a non-table.\")\n\n    if self.node then\n        error(\"Node is already set on behaviour!\")\n    end\n\n    local nodeId = msg.value\n    __assertTrace(type(nodeId) == 'string', \"_setNode() needs a nodeId of type string.\")\n\n    local node = SceneObject.findById(nodeId)\n    __assertTrace(node, \"_setNode() node not found\")\n\n    local scriptName = msg.scriptName\n    __assertTrace(scriptName, \"_setNode() needs a scriptName\")\n\n    local scriptId = msg.scriptId\n    __assertTrace(scriptId, \"_setNode() needs a scriptId\")\n\n    self.node = node\n    self._nodeId = nodeId\n    self._scriptName = msg.scriptName\n    self._scriptId = scriptId\n\n    _behavioursMapByScriptId[scriptId] = self\n    _behavioursMapByExecutionOrder[self._executionIndex] = self\n\n    if not _behavioursMapByNodeId[nodeId] then\n        _behavioursMapByNodeId[nodeId] = {}\n    end\n    _behavioursMapByNodeId[nodeId][scriptId] = {\n        node = node,\n        scriptName = scriptName,\n        behaviour = self\n    }\nend\n\n--- Return the properties of this Behaviour as JSON\n---@private\n---@return string JSON string of properties\nfunction Behaviour:_getPropsJson()\n    return JE(self:getProperties())\nend\n\n--- Returns the active state of the behaviour. If the owner item is inactive, so are all attached behaviours\n---@return boolean true, if active, othersise false\nfunction Behaviour:isActive()\n    return self._isActive\nend\n\n--- Returns the initialized state of the behaviour. If true, init ran through or there is no init\n---@return boolean true, if initialized, othersise false\nfunction Behaviour:isInitialized()\n    return self._isInitialized\nend\n\n--- Clears all registered behaviours (used internally). They are expected to be empty anyway due to scripts\n--- cleaning up behind themselves. This function will assert this\n---@private\nfunction Behaviour._clearBehaviours()\n    -- Clear in-place to avoid any stale references to the _behaviours table object\n    -- preventing Lua GC from reclaiming behaviour instances.\n    for nodeId, nodeBehaviours in pairs(_behavioursMapByNodeId) do\n        -- nodeBehaviours is a keyed table (scriptId -> { ... })\n        if nodeBehaviours and next(nodeBehaviours) ~= nil then\n            -- This warning is useful when scripts forget to dispose their behaviours,\n            -- but the check previously used `#nodeBehaviours` which is incorrect for keyed tables.\n            print(\"WARNING: Some behaviours did not get cleaned properly. This is an engine bug!\")\n            -- Keep clearing anyway to enable GC.\n        end\n\n        if nodeBehaviours then\n            for scriptId in pairs(nodeBehaviours) do\n                nodeBehaviours[scriptId] = nil\n            end\n        end\n\n        _behavioursMapByNodeId[nodeId] = nil\n    end\n\n    -- Also clear the second map that has the behaviours by their script ID directly and the execution order map\n    _behavioursMapByScriptId = {}\n    _behavioursMapByExecutionOrder = {}\n    _executionIndex = 1\nend\n\nfunction Behaviour:_init()\n    if type(self.init) == 'function' then\n        local ok, err = pcall(self.init, self)\n        if not ok then\n            print(self._scriptName .. \":init() failed:\", err)\n        end\n    end\n    self._isInitialized = true\n    self._isActive = true\nend\n\nfunction Behaviour:_ondisable()\n    self._isActive = false\n    if type(self.ondisable) == 'function' then\n        local ok, err = pcall(self.ondisable, self)\n        if not ok then\n            print(self._scriptName .. \":ondisable() failed:\", err)\n        end\n    end\nend\n\nfunction Behaviour:_onenable()\n    self._isActive = true\n    if type(self.onenable) == 'function' then\n        local ok, err = pcall(self.onenable, self)\n        if not ok then\n            print(self._scriptName .. \":onenable() failed:\", err)\n        end\n    end\nend\n\nfunction Behaviour:_ondestroy()\n    if type(self.ondestroy) == 'function' then\n        local ok, err = pcall(self.ondestroy, self)\n        if not ok then\n            print(self._scriptName .. \":ondestroy() failed:\", err)\n        end\n    end\n    self._isActive = false\n    self._isInitialized = false\nend\n\nfunction Behaviour._callHookOnAll(hookName, deltaTime, deltaTimeSmooth)\n    local callcount = 0\n\n    for _, behaviour in pairs(_behavioursMapByExecutionOrder) do\n        local hookFunc = behaviour[hookName]\n        if behaviour._isActive and behaviour._isInitialized and type(hookFunc) == 'function' then\n            callcount = callcount + 1\n            local ok, err = pcall(hookFunc, behaviour, deltaTime, deltaTimeSmooth)\n            if not ok then\n                print(behaviour._scriptName .. \":\" .. hookName .. \"() failed:\", err)\n            end\n        end\n    end\n\n    return callcount\nend\n\nfunction Behaviour._updateAll(deltaTime, deltaTimeSmooth)\n    local callcount = 0\n\n    callcount = callcount + Behaviour._callHookOnAll(\"preUpdate\", deltaTime, deltaTimeSmooth)\n    callcount = callcount + Behaviour._callHookOnAll(\"update\", deltaTime, deltaTimeSmooth)\n    callcount = callcount + Behaviour._callHookOnAll(\"lateUpdate\", deltaTime, deltaTimeSmooth)\n\n    return callcount\nend\n\nfunction Behaviour._renderAll()\n\n    if Canvas.autoClear then\n        Canvas.clear()\n    end\n\n    local callcount = 0\n\n    callcount = Behaviour._callHookOnAll(\"prerender\")\n    callcount = Behaviour._callHookOnAll(\"render\")\n\n    Canvas.commit()\n\n    return callcount\nend\n\nfunction Behaviour._renderguiAll()\n    return Behaviour._callHookOnAll(\"rendergui\")\nend\n\nfunction Behaviour._setActive(nodes)\n    for scriptId, active in pairs(nodes) do\n        local behaviour = _behavioursMapByScriptId[scriptId]\n        if behaviour then\n            behaviour._isActive = active\n        else\n            print(\"ERROR: Behaviour._setActive() cannot find script: \" .. scriptId)\n        end\n    end\nend\n\nfunction Behaviour._debugStats()\n    local nodeCount = 0\n    local behaviourCount = 0\n    for _, nodeBehaviours in pairs(_behavioursMapByNodeId) do\n        nodeCount = nodeCount + 1\n        if nodeBehaviours then\n            for _ in pairs(nodeBehaviours) do\n                behaviourCount = behaviourCount + 1\n            end\n        end\n    end\n\n    return {\n        nodeCount = nodeCount,\n        behaviourCount = behaviourCount\n    }\nend\n\nreturn Behaviour\n";
 
-	var lua_api_canvas = "\nlocal _internal = require('engine/_internal');\n\n---@module canvas\nlocal canvas = {}\n\n-- Lua-side command buffer for canvas calls.\nlocal _cmds = {}\n\nlocal function _captureSendMessage(target, payload, buffers)\n  table.insert(_cmds, {\n    target = target,\n    payload = payload,\n    buffers = buffers\n  })\n  return nil\nend\n\nlocal function _runWithCapturedSend(fn, ...)\n  local oldSendMessage = _internal.sendMessage\n  _internal.sendMessage = _captureSendMessage\n\n  local result = { pcall(fn, ...) }\n\n  _internal.sendMessage = oldSendMessage\n\n  if not result[1] then\n    error(result[2])\n  end\n\n  return table.unpack(result, 2)\nend\n\nlocal function _commitIfNeeded()\n  if #_cmds == 0 then\n    return { committed = 0 }\n  end\n\n  local result = _internal.sendMessage('canvas.commit', { cmds = _cmds })\n  _cmds = {}\n  return result\nend\n\n---Commit all pending buffered canvas commands.\n---@return table|nil result Optional engine-side debug info.\nfunction canvas.commit()\n  return _commitIfNeeded()\nend\n\n---Debug helper: returns count of pending buffered commands in Lua.\n---@return number\nfunction canvas.getPendingCommandCount()\n  return #_cmds\nend\n\n---Debug helper: returns current pending buffered commands in Lua.\n---@return table\nfunction canvas.getPendingCommands()\n  return _cmds\nend\n\n---Debug helper: returns most recently committed command list on engine side.\n---@return table\nfunction canvas.getLastCommittedCommands()\n  _commitIfNeeded()\n  return _internal.sendMessage('canvas.getLastCommittedCommands')\nend\n\n---Clear the canvas.\n---@function\nfunction canvas.clear()\n  _internal.sendMessage('canvas.clear')\nend\n\n---Returns the width of the canvas in pixels.\n---@function\nfunction canvas.getWidth()\n  return _internal.sendMessage('canvas.getWidth')\nend\n\n---Returns the height of the canvas in pixels.\n---@function\nfunction canvas.getHeight()\n  return _internal.sendMessage('canvas.getHeight')\nend\n\n---Sets the width of lines in the canvas.\n---@param w number the width to set the lines to.\nfunction canvas.setLineWidth(w)\n  _internal.sendMessage('canvas.setLineWidth', { w=w })\nend\n\n---Sets the type of endings applied to the ends of a line.\n---@param cap string the type of corner to create on a line. One of \"butt\", \"round\", \"square\".\nfunction canvas.setLineCap(cap)\n  _internal.sendMessage('canvas.setLineCap', { cap=cap })\nend\n\n---Sets the type of corner created when two lines meet.\n---@param join string the type of connection to create between two lines. One of \"bevel\", \"round\", or \"miter\".\nfunction canvas.setLineJoin(join)\n  _internal.sendMessage('canvas.setLineJoin', { join=join })\nend\n\n---Sets the maximum miter length. Miter length is the distance between the inner corner and the outer corner of the join.\n---@param limit number the maximum miter length. When the miter length exceeds this value, the corner is trimmed.\nfunction canvas.setMiterLimit(limit)\n  _internal.sendMessage('canvas.setMiterLimit', { limit=limit })\nend\n\n---Sets the color of the stroke (outline) for shapes drawn on the canvas.\n---@param r number Red channel value (0–255)\n---@param g number Green channel value (0–255)\n---@param b number Blue channel value (0–255)\n---@param a number Alpha channel value (0–1)\nfunction canvas.setStrokeColor(r, g, b, a)\n  _internal.sendMessage('canvas.setStrokeColor', { r=r, g=g, b=b, a=a })\nend\n\n---Sets the color that is used to fill in shapes and text when they are drawn on the canvas.\n---@param r number Red channel value (0–255)\n---@param g number Green channel value (0–255)\n---@param b number Blue channel value (0–255)\n---@param a number Alpha channel value (0–1)\nfunction canvas.setFillColor(r, g, b, a)\n  _internal.sendMessage('canvas.setFillColor', { r=r, g=g, b=b, a=a })\nend\n\n---Sets the color to use for shadows.\n---@param r number Red channel value (0–255)\n---@param g number Green channel value (0–255)\n---@param b number Blue channel value (0–255)\n---@param a number Alpha channel value (0–1)\nfunction canvas.setShadowColor(r, g, b, a)\n  _internal.sendMessage('canvas.setShadowColor', { r=r, g=g, b=b, a=a })\nend\n\n---Sets the blur level for shadows.\n---@param level number the level of blur to be applied to shadows (in pixels).\nfunction canvas.setShadowBlurLevel(level)\n  _internal.sendMessage('canvas.setShadowBlurLevel', { level=level })\nend\n\n---Sets the blur level for shadows.\n---@param x number the vertical offset of the shadow in pixels.\n---@param y number the horizontal offset of the shadow in pixels.\nfunction canvas.setShadowOffset(x, y)\n  _internal.sendMessage('canvas.setShadowOffset', { x=x, y=y })\nend\n\n---Begins a new path.\n---@function\nfunction canvas.beginPath()\n  _internal.sendMessage('canvas.beginPath')\nend\n\n---Close the current path by connecting the last and first point in the path, creating a loop.\n---@function\nfunction canvas.closePath()\n  _internal.sendMessage('canvas.closePath')\nend\n\n---Determines if the specified point is in the current path.\n---@param x number x-coordinate of the point to check.\n---@param y number y-coordinate of the point to check.\n---@return boolean indicating if the point is in the path or not.\nfunction canvas.isPointInPath(x, y)\n  return _internal.sendMessage('canvas.isPointInPath', { x=x, y=y })\nend\n\n---Sets the clipping path to the current drawing path.\n---@function\nfunction canvas.clip()\n  _internal.sendMessage('canvas.clip')\nend\n\n---Draws the outline of a shape or path using the current stroke style, line width and styles.\n---@function\nfunction canvas.stroke()\n  _internal.sendMessage('canvas.stroke')\nend\n\n---Fills a shape or path with the current fill style.\n---@function\nfunction canvas.fill()\n  _internal.sendMessage('canvas.fill')\nend\n\n---Moves the current drawing position to the specified coordinates.\n---@param x number x-coordinate of the new current drawing position.\n---@param y number y-coordinate of the new current drawing position.\nfunction canvas.moveTo(x, y)\n  _internal.sendMessage('canvas.moveTo', { x=x, y=y })\nend\n\n---Draws a straight line from the current position to the specified coordinates.\n---@param x number the x-coordinate to draw the line to.\n---@param y number the y-coordinate to draw the line to.\nfunction canvas.lineTo(x, y)\n  _internal.sendMessage('canvas.lineTo', { x=x, y=y })\nend\n\n---Sets the type of compositing operation to apply when drawing new shapes.\n---@param operation string the compositing operation to use, possible values are:\n---\"source-over\", \"source-in\", \"source-out\", \"source-atop\", \"destination-over\",\n---\"destination-in\", \"destination-out\", \"destination-atop\", \"lighter\", \"copy\", \"xor\".\nfunction canvas.setCompositeOperation(operation)\n  _internal.sendMessage('canvas.setCompositeOperation', { operation=operation })\nend\n\n---Sets the transparency value that is applied to all rendering operations.\n---@param value number a value between 0.0 (fully transparent) and 1.0 (fully opaque).\nfunction canvas.setGlobalAlpha(value)\n  _internal.sendMessage('canvas.setGlobalAlpha', { value=value })\nend\n\n---Creates a rectangle path which is only drawn after calling stroke() or fill().\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\nfunction canvas.pathRect(x, y, w, h)\n  _internal.sendMessage('canvas.pathRect', { x=x, y=y, w=w, h=h })\nend\n\n---Adds a rounded rectangle to the current path. Must be followed by stroke() or fill().\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\n---@param radius number|table corner radius applied to all four corners (uniform), or a table\n---of 1–4 values to set individual corner radius in the order [top-left, top-right,\n---bottom-right, bottom-left], following the HTML Canvas API specification.\nfunction canvas.roundRect(x, y, w, h, radius)\n  _internal.sendMessage('canvas.roundRect', { x=x, y=y, w=w, h=h, radius=radius })\nend\n\n---Draw a rectangle outline using the current stroke style.\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\nfunction canvas.strokeRect(x, y, w, h)\n  _internal.sendMessage('canvas.strokeRect', { x=x, y=y, w=w, h=h })\nend\n\n---Draw  a rectangle with a filled interior using the current fill style,\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\nfunction canvas.fillRect(x, y, w, h)\n  _internal.sendMessage('canvas.fillRect', { x=x, y=y, w=w, h=h })\nend\n\n---Clears the specified rectangle by setting its pixels to transparent.\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\nfunction canvas.clearRect(x, y, w, h)\n  _internal.sendMessage('canvas.clearRect', { x=x, y=y, w=w, h=h })\nend\n\n---Draws a circle with given parameters. Must be followed by stroke() or fill().\n---@param x number x-coordinates of the center of the circle.\n---@param y number y-coordinates of the center of the circle.\n---@param r number the radius of the circle\nfunction canvas.circle(x, y, r)\n  _internal.sendMessage('canvas.circle', { x=x, y=y, r=r })\nend\n\n---Draws an arc with given parameters. Must be followed by stroke() or fill().\n---@param x number x-coordinates of the center of the circle.\n---@param y number y-coordinates of the center of the circle.\n---@param r number the radius of the circle.\n---@param startAngle number the starting angle in radians.\n---@param endAngle number the ending angle, in radians.\n---@param anticlockwise boolean a flag which specifies whether the drawing should be counterclockwise or clockwise.\nfunction canvas.arc(x, y, r, startAngle, endAngle, anticlockwise)\n  _internal.sendMessage('canvas.arc', { x=x, y=y, r=r, startAngle=startAngle,\n                              endAngle=endAngle, anticlockwise=anticlockwise })\nend\n\n---Adds a quadratic Bézier curve to the path with given control point and end point.\n---@param cpx number x-coordinate of the control point.\n---@param cpy number y-coordinate of the control point.\n---@param x number x-coordinate of the end point.\n---@param y number y-coordinate of the end point.\nfunction canvas.quadraticCurve(cpx, cpy, x, y)\n  _internal.sendMessage('canvas.quadraticCurve', { cpx=cpx, cpy=cpy, x=x, y=y })\nend\n\n---Draws a bezier curve from the current position to the specified point, using the specified control points.\n---@param cp1x number x-coordinate of the first control point.\n---@param cp1y number y-coordinate of the first control point.\n---@param cp2x number x-coordinate of the second control point.\n---@param cp2y number y-coordinate of the second control point.\n---@param x number x-coordinate of the end point.\n---@param y number y-coordinate of the end point.\nfunction canvas.bezierCurve(cp1x, cp1y, cp2x, cp2y, x, y)\n  _internal.sendMessage('canvas.bezierCurve', { cp1x=cp1x, cp1y=cp1y,\n                                  cp2x=cp2x, cp2y=cp2y,\n                                  x=x, y=y })\nend\n\n---@class Gradient\n---A class to internally link gradient objects from the Lua environment to Lumino codebase.\n---A Gradient object can be create using @{createLinearGradient} or @{createRadialGradient}\n---@private\nlocal Gradient = {}\n\n---Creates a new gradient object with the given index\n---@param idx number index of the gradient object\n---@private\nfunction Gradient:new(idx)\n  -- Store the gradient object in a field of the class instance metatable\n  local obj = { idx = idx}\n  Class.__setmetatable(obj, self)\n  self.__index = self\n  -- Return the instance\n  return obj\nend\n\n---Hook that runs before an object is deleted by the garbage collector.\n---It calls a function to delete the gradient object in JS\n---@private\nfunction Gradient:__gc()\n  -- Keep deletion ordering deterministic when gradient operations are buffered.\n  _commitIfNeeded()\n  _internal.sendMessage('canvas.deleteGradient', { gradientIdx = self.idx })\nend\n-- Add the Gradient class to the Canvas namespace\ncanvas.Gradient = Gradient\n\n---Sets a gradient object to active.\n---@param gradient Gradient a gradient object\nfunction canvas.setGradientActive(gradient)\n  if gradient.idx >= 0 then\n    _internal.sendMessage('canvas.setGradientActive', { gradientIdx = gradient.idx })\n  end\nend\n\n---Adds a new stop, defined by an offset and a color, to a gradient object.\n---@param gradient Gradient a gradient object\n---@param offset number a value between 0.0 and 1.0 where the new color stop is positioned.\n---@param r number Red channel value (0–255)\n---@param g number Green channel value (0–255)\n---@param b number Blue channel value (0–255)\n---@param a number Alpha channel value (0–1)\nfunction canvas.colorStop(gradient, offset, r, g, b, a)\n  _internal.sendMessage('canvas.colorStop', { gradientIdx=gradient.idx, offset=offset, r=r, g=g, b=b, a=a })\nend\n\n---Creates a linear gradient object.\n---@param x1 number the x-coordinate of the start point of the gradient\n---@param y1 number the y-coordinate of the start point of the gradient\n---@param x2 number the x-coordinate of the end point of the gradient\n---@param y2 number the y-coordinate of the end point of the gradient\n---@return Gradient a new gradient object\n---@usage local gradient = Canvas.createLinearGradient(0, 0, 50, 0)\nfunction canvas.createLinearGradient(x1, y1, x2, y2)\n  local idx = _internal.sendMessage('canvas.createLinearGradient', { x1=x1, y1=y1,\n                                  x2=x2, y2=y2 })\n  local gradient = Gradient:new(idx)\n  return gradient\nend\n\n---Creates a radial gradient object.\n---@param x1 number x-coordinate of the start circle\n---@param y1 number y-coordinate of the start circle\n---@param r1 number radius of the start circle\n---@param x2 number x-coordinate of the end circle\n---@param y2 number y-coordinate of the end circle\n---@param r2 number radius of the end circle\n---@return Gradient a new gradient object\nfunction canvas.createRadialGradient(x1, y1, r1, x2, y2, r2)\n  local idx = _internal.sendMessage('canvas.createRadialGradient', { x1=x1, y1=y1, r1=r1,\n                                  x2=x2, y2=y2, r2=r2})\n  local gradient = Gradient:new(idx)\n  return gradient\nend\n\n---Returns an array with strings of all available fonts. This will list all custom loaded fonts through Loader.loadFont and\n---fonts registered in Canvas Fonts in your project. It will also probe for common system fonts although the list might not be complete.\n---It is strongly recommended to use only custom uploaded fonts to have reliable results on all platforms.\n---@return table an array with all the available fonts as strings\nfunction canvas.getAvailableFonts()\n  return _internal.sendMessage('canvas.getAvailableFonts')\nend\n\n---Sets a font style.\n---@param font string The font style to be set, in the format of 'font-style font-size font-family'. Example: 'italic 20px Arial'.\nfunction canvas.setFont(font)\n  _internal.sendMessage('canvas.setFont', { font=font })\nend\n\n---Sets the current text alignment\n---@param align string The new text alignment to be set. One of 'start', 'end', 'left', 'right', or 'center'.\nfunction canvas.setTextAlign(align)\n  _internal.sendMessage('canvas.setTextAlign', { align=align })\nend\n\n---Sets the text baseline used when drawing text.\n---@param baseline string The text baseline to set. One of 'alphabetic', 'top', 'hanging', 'middle', 'ideographic', or 'bottom'.\nfunction canvas.setTextBaseline(baseline)\n  _internal.sendMessage('canvas.setTextBaseline', { baseline=baseline })\nend\n\n---Measures the width of the specified text in pixels.\n---@param text string The text to measure.\nfunction canvas.measureTextWidth(text)\n  return _internal.sendMessage('canvas.measureTextWidth', { text=text })\nend\n\n---Draws and fills a given text string at the specified coordinates.\n---@param text string The text string to be drawn and filled.\n---@param x number The x-coordinate where the text will be drawn.\n---@param y number The y-coordinate where the text will be drawn.\nfunction canvas.fillText(text, x, y)\n  _internal.sendMessage('canvas.fillText', { text=text, x=x, y=y })\nend\n\n---Draws the outline of the given text at the specified coordinates.\n---@param text string The text string to be drawn.\n---@param x number The x-coordinate where the text will be drawn.\n---@param y number The y-coordinate where the text will be drawn.\nfunction canvas.strokeText(text, x, y)\n  _internal.sendMessage('canvas.strokeText', { text=text, x=x, y=y })\nend\n\n-- -TODO: ImageData is not yet ready for deployment because using it for pixel manipulation would be\n-- -inefficient and slow due to the need for JSON communication with JavaScript. While JSON\n-- -communication is necessary for the security of the application, it is not well-suited for tasks\n-- -that require frequent or high-volume data transfer. It is better to use ImageData for low\n-- -frequency tasks such as updating UI and handling events, rather than trying to use it for more\n-- -demanding tasks that may be slowed down by the use of JSON objects.\n\n-- --- Image class to link imageData objects in the canvas to Lua\n-- ---@class imageData\n-- local Image = {}\n\n-- --- Creates a new Image object with the given index\n-- ---@param idx number index of the imageData object in the canvas\n-- function Image:new(idx)\n--   local obj = {}\n--   Class.__setmetatable(obj, self)\n--   self.__index = self\n--   self.idx = idx\n--   return obj\n-- end\n-- canvas.Image = Image\n\n-- ---Creates a new, blank Image object with the specified dimensions.\n-- ---All of the pixels in the new object are transparent black.\n-- ---@param width number the width of the Image object\n-- ---@param height number the height of the Image object\n-- ---@return Image a new Image object\n-- function canvas.createImage(width, height)\n--   local idx = _internal.sendMessage('canvas.createImage', { width=width, height=height })\n--   local image = Image:new(idx)\n--   return image\n-- end\n\n-- ---Write the RGBA channels of an Image object\n-- ---@param r number the r channel of the Image object\n-- ---@param g number the g channel of the Image object\n-- ---@param b number the b channel of the Image object\n-- ---@param a number the a channel of the Image object\n-- function canvas.writeImageChannels(image, r, g, b, a)\n--   _internal.sendMessage('canvas.writeImageChannels', { imageIdx=image.idx, r=r, g=g, b=b, a=a })\n-- end\n\n-- ---Draws an image given by an url at the specified position and dimensions.\n-- ---@param url string\n-- ---@param x number\n-- ---@param y number\n-- ---@param width number\n-- ---@param height number\n-- function canvas.drawImageFromUrl(url, x, y, width, height)\n--   _internal.sendMessage('canvas.drawImageFromUrl', { url=url, x=x, y=y, width=width, height=height })\n-- end\n\n-- ---Repeats a given image on the canvas with a given pattern.\n-- ---@param image imageSource an image object\n-- ---@param repeat string one of repeat, repeat-x, repeat-y, no-repeat\n-- function canvas.imagePattern(image, repeatPattern)\n--   _internal.sendMessage('canvas.pattern', { image=image, repeatPattern=repeatPattern })\n-- end\n\n---Draws the image data at the given coordinates.\n---@param image Texture the image data to paint\n---@param x number x-coordinate of the top left corner where the image data will be painted\n---@param y number y-coordinate of the top left corner where the image data will be painted\n---@param width number width of the image on screen (optional)\n---@param height number height of the image on screen (optional)\n---@param mode number mode to use for stretching. possible values are 0 = stretch, 1 = fit, 2 = cover\nfunction canvas.drawImage(image, x, y, width, height, mode)\n  __assertTrace(image and image._isTexture, \"image is not a Texture object\")\n  _internal.sendMessage('canvas.drawImage', { image= image._handle, x=x, y=y, width=width, height=height, mode=mode })\nend\n\n---Draws the image data at the given coordinates.\n---@param image Texture the image data to paint\n---@param x number x-coordinate of the top left corner where the image data will be painted\n---@param y number y-coordinate of the top left corner where the image data will be painted\n---@param width number width of the image on screen (optional)\n---@param height number height of the image on screen (optional)\nfunction canvas.drawSubImage(image, x, y, width, height, sourceX, sourceY, sourceWidth, sourceHeight)\n  __assertTrace(image and image._isTexture, \"image is not a Texture object\")\n  _internal.sendMessage('canvas.drawSubImage', { image= image._handle,\n                                                 x=x, y=y, width=width, height=height,\n                                                 sourceX=sourceX, sourceY=sourceY, sourceWidth=sourceWidth, sourceHeight=sourceHeight })\nend\n\n--- Scales the canvas by the specified factors along the x and y axes.\n--- Transformations are applied relative to the canvas origin (0,0).\n--- To scale around a different point, use `translate()` to move the origin before scaling.\n---@param x number Scale factor along the x-axis.\n---@param y number Scale factor along the y-axis.\nfunction canvas.scale(x, y)\n  _internal.sendMessage('canvas.scale', { x=x, y=y })\nend\n\n--- Rotates the canvas by the specified angle in radians.\n--- Rotation is performed around the canvas origin (0,0).\n--- To rotate around a different point, translate the canvas to that point before calling rotate().\n---@param a number Angle in radians.\nfunction canvas.rotate(a)\n  _internal.sendMessage('canvas.rotate', { a=a })\nend\n\n\n--- Moves (translates) the canvas origin by the specified amounts.\n--- All subsequent drawing and transformations (scale, rotate, etc.) are relative to the new origin.\n---@param x number Amount to translate along the x-axis.\n---@param y number Amount to translate along the y-axis.\nfunction canvas.translate(x, y)\n  _internal.sendMessage('canvas.translate', { x=x, y=y })\nend\n\n---Applies a 2D transformation matrix to the canvas.\n---@param horizontal_scale number The amount to scale horizontally.\n---@param horizontal_skew number The amount of horizontal skew.\n---@param vertical_skew number The amount of vertical skew.\n---@param vertical_scale number The amount to scale vertically.\n---@param horizontal_translation number The amount of horizontal translation.\n---@param vertical_translation number The amount of vertical translation.\nfunction canvas.transform(horizontal_scale, horizontal_skew, vertical_skew,\n                          vertical_scale, horizontal_translation, vertical_translation)\n  _internal.sendMessage('canvas.transform', { a=horizontal_scale, b=horizontal_skew,\n                                      c=vertical_skew, d=vertical_scale,\n                                      e=horizontal_translation, f=vertical_translation })\nend\n\n---Resets the current canvas transform to the identity matrix and then invokes the transform() function with the given parameters.\n---@param horizontal_scale number The amount to scale horizontally.\n---@param horizontal_skew number The amount of horizontal skew.\n---@param vertical_skew number The amount of vertical skew.\n---@param vertical_scale number The amount to scale vertically.\n---@param horizontal_translation number The amount of horizontal translation.\n---@param vertical_translation number The amount of vertical translation.\nfunction canvas.resetAndSetTransform(horizontal_scale, horizontal_skew, vertical_skew,\n                                    vertical_scale, horizontal_translation, vertical_translation)\n  _internal.sendMessage('canvas.resetAndSetTransform', { a=horizontal_scale, b=horizontal_skew,\n                                                  c=vertical_skew, d=vertical_scale,\n                                                  e=horizontal_translation, f=vertical_translation })\nend\n\n---Reset the transformation matrix to the identity matrix.\n---@function\nfunction canvas.resetTransform()\n  _internal.sendMessage('canvas.resetTransform')\nend\n\n---Pushes the current canvas state to a stack so that you can restore it.\n---This can be useful for performing multiple transformations or styles on the canvas, and\n---then restoring it to its original state. The canvas state in fact includes current transformation matrix\n---stroke and fill styles, shadow styles, and other attributes. To restore the canvas state you call\n---the restoreState() function.\n---@function\nfunction canvas.saveState()\n  _internal.sendMessage('canvas.saveState')\nend\n\n---Pops the the most recently saved canvas from the saved state stack and restores it.\n---@function\nfunction canvas.restoreState()\n  _internal.sendMessage('canvas.restoreState')\nend\n\n--- Resets the canvas to its default state, clearing the canvas and restoring all\n--- context -properties (transforms, styles, clipping region, etc.) to their\n--- defaults. Reset() is more thorough than -calling clear() alone, which only\n--- erases pixels but leaves context state intact.\n---@function\nfunction canvas.reset()\n  _internal.sendMessage('canvas.reset')\nend\n\n-- Automatically wrap canvas methods for buffering, so non-query calls are queued\n-- and query/result-producing calls force an immediate commit first.\nlocal _passthroughMethods = {\n  commit = true,\n  getPendingCommandCount = true,\n  getPendingCommands = true,\n}\n\nlocal _immediateMethods = {\n  getLastCommittedCommands = true,\n  getWidth = true,\n  getHeight = true,\n  isPointInPath = true,\n  createLinearGradient = true,\n  createRadialGradient = true,\n  getAvailableFonts = true,\n  measureTextWidth = true,\n}\n\nfor name, fn in pairs(canvas) do\n  if type(fn) == \"function\" and name ~= \"Gradient\" then\n    if _passthroughMethods[name] then\n      -- keep as-is\n    elseif _immediateMethods[name] then\n      canvas[name] = function(...)\n        _commitIfNeeded()\n        return fn(...)\n      end\n    else\n      canvas[name] = function(...)\n        return _runWithCapturedSend(fn, ...)\n      end\n    end\n  end\nend\n\nreturn canvas\n";
+	var lua_api_canvas = "\nlocal _internal = require('engine/_internal');\n\n---@module canvas\nlocal canvas = {\n    autoClear = false\n}\n\n-- Lua-side command buffer for canvas calls.\nlocal _cmds = {}\n\nlocal function _captureSendMessage(target, payload, buffers)\n  table.insert(_cmds, {\n    target = target,\n    payload = payload,\n    buffers = buffers\n  })\n  return nil\nend\n\nlocal function _runWithCapturedSend(fn, ...)\n  local oldSendMessage = _internal.sendMessage\n  _internal.sendMessage = _captureSendMessage\n\n  local result = { pcall(fn, ...) }\n\n  _internal.sendMessage = oldSendMessage\n\n  if not result[1] then\n    error(result[2])\n  end\n\n  return table.unpack(result, 2)\nend\n\nlocal function _commitIfNeeded()\n  if #_cmds == 0 then\n    return { committed = 0 }\n  end\n\n  local result = _internal.sendMessage('canvas.commit', { cmds = _cmds })\n  _cmds = {}\n  return result\nend\n\n---If set to true, the canvas will automatically clear once before the render hook is called\n---@param value boolean the flag value\nfunction canvas.setAutoClear(value)\n    self.autoClear = value\nend\n\n---Returns the value of the auto clear flag\n---@return boolean the flag value\nfunction canvas.getAutoClear()\n    return self.autoClear\nend\n\n---Commit all pending buffered canvas commands.\n---@return table|nil result Optional engine-side debug info.\nfunction canvas.commit()\n  return _commitIfNeeded()\nend\n\n---Debug helper: returns count of pending buffered commands in Lua.\n---@return number\nfunction canvas.getPendingCommandCount()\n  return #_cmds\nend\n\n---Debug helper: returns current pending buffered commands in Lua.\n---@return table\nfunction canvas.getPendingCommands()\n  return _cmds\nend\n\n---Debug helper: returns most recently committed command list on engine side.\n---@return table\nfunction canvas.getLastCommittedCommands()\n  _commitIfNeeded()\n  return _internal.sendMessage('canvas.getLastCommittedCommands')\nend\n\n---Clear the canvas.\n---@function\nfunction canvas.clear()\n  _internal.sendMessage('canvas.clear')\nend\n\n---Returns the width of the canvas in pixels.\n---@function\nfunction canvas.getWidth()\n  return _internal.sendMessage('canvas.getWidth')\nend\n\n---Returns the height of the canvas in pixels.\n---@function\nfunction canvas.getHeight()\n  return _internal.sendMessage('canvas.getHeight')\nend\n\n---Sets the width of lines in the canvas.\n---@param w number the width to set the lines to.\nfunction canvas.setLineWidth(w)\n  _internal.sendMessage('canvas.setLineWidth', { w=w })\nend\n\n---Sets the type of endings applied to the ends of a line.\n---@param cap string the type of corner to create on a line. One of \"butt\", \"round\", \"square\".\nfunction canvas.setLineCap(cap)\n  _internal.sendMessage('canvas.setLineCap', { cap=cap })\nend\n\n---Sets the type of corner created when two lines meet.\n---@param join string the type of connection to create between two lines. One of \"bevel\", \"round\", or \"miter\".\nfunction canvas.setLineJoin(join)\n  _internal.sendMessage('canvas.setLineJoin', { join=join })\nend\n\n---Sets the maximum miter length. Miter length is the distance between the inner corner and the outer corner of the join.\n---@param limit number the maximum miter length. When the miter length exceeds this value, the corner is trimmed.\nfunction canvas.setMiterLimit(limit)\n  _internal.sendMessage('canvas.setMiterLimit', { limit=limit })\nend\n\n---Sets the color of the stroke (outline) for shapes drawn on the canvas.\n---@param r number Red channel value (0–255)\n---@param g number Green channel value (0–255)\n---@param b number Blue channel value (0–255)\n---@param a number Alpha channel value (0–1)\nfunction canvas.setStrokeColor(r, g, b, a)\n  _internal.sendMessage('canvas.setStrokeColor', { r=r, g=g, b=b, a=a })\nend\n\n---Sets the color that is used to fill in shapes and text when they are drawn on the canvas.\n---@param r number Red channel value (0–255)\n---@param g number Green channel value (0–255)\n---@param b number Blue channel value (0–255)\n---@param a number Alpha channel value (0–1)\nfunction canvas.setFillColor(r, g, b, a)\n  _internal.sendMessage('canvas.setFillColor', { r=r, g=g, b=b, a=a })\nend\n\n---Sets the color to use for shadows.\n---@param r number Red channel value (0–255)\n---@param g number Green channel value (0–255)\n---@param b number Blue channel value (0–255)\n---@param a number Alpha channel value (0–1)\nfunction canvas.setShadowColor(r, g, b, a)\n  _internal.sendMessage('canvas.setShadowColor', { r=r, g=g, b=b, a=a })\nend\n\n---Sets the blur level for shadows.\n---@param level number the level of blur to be applied to shadows (in pixels).\nfunction canvas.setShadowBlurLevel(level)\n  _internal.sendMessage('canvas.setShadowBlurLevel', { level=level })\nend\n\n---Sets the blur level for shadows.\n---@param x number the vertical offset of the shadow in pixels.\n---@param y number the horizontal offset of the shadow in pixels.\nfunction canvas.setShadowOffset(x, y)\n  _internal.sendMessage('canvas.setShadowOffset', { x=x, y=y })\nend\n\n---Begins a new path.\n---@function\nfunction canvas.beginPath()\n  _internal.sendMessage('canvas.beginPath')\nend\n\n---Close the current path by connecting the last and first point in the path, creating a loop.\n---@function\nfunction canvas.closePath()\n  _internal.sendMessage('canvas.closePath')\nend\n\n---Determines if the specified point is in the current path.\n---@param x number x-coordinate of the point to check.\n---@param y number y-coordinate of the point to check.\n---@return boolean indicating if the point is in the path or not.\nfunction canvas.isPointInPath(x, y)\n  return _internal.sendMessage('canvas.isPointInPath', { x=x, y=y })\nend\n\n---Sets the clipping path to the current drawing path.\n---@function\nfunction canvas.clip()\n  _internal.sendMessage('canvas.clip')\nend\n\n---Draws the outline of a shape or path using the current stroke style, line width and styles.\n---@function\nfunction canvas.stroke()\n  _internal.sendMessage('canvas.stroke')\nend\n\n---Fills a shape or path with the current fill style.\n---@function\nfunction canvas.fill()\n  _internal.sendMessage('canvas.fill')\nend\n\n---Moves the current drawing position to the specified coordinates.\n---@param x number x-coordinate of the new current drawing position.\n---@param y number y-coordinate of the new current drawing position.\nfunction canvas.moveTo(x, y)\n  _internal.sendMessage('canvas.moveTo', { x=x, y=y })\nend\n\n---Draws a straight line from the current position to the specified coordinates.\n---@param x number the x-coordinate to draw the line to.\n---@param y number the y-coordinate to draw the line to.\nfunction canvas.lineTo(x, y)\n  _internal.sendMessage('canvas.lineTo', { x=x, y=y })\nend\n\n---Sets the type of compositing operation to apply when drawing new shapes.\n---@param operation string the compositing operation to use, possible values are:\n---\"source-over\", \"source-in\", \"source-out\", \"source-atop\", \"destination-over\",\n---\"destination-in\", \"destination-out\", \"destination-atop\", \"lighter\", \"copy\", \"xor\".\nfunction canvas.setCompositeOperation(operation)\n  _internal.sendMessage('canvas.setCompositeOperation', { operation=operation })\nend\n\n---Sets the transparency value that is applied to all rendering operations.\n---@param value number a value between 0.0 (fully transparent) and 1.0 (fully opaque).\nfunction canvas.setGlobalAlpha(value)\n  _internal.sendMessage('canvas.setGlobalAlpha', { value=value })\nend\n\n---Creates a rectangle path which is only drawn after calling stroke() or fill().\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\nfunction canvas.pathRect(x, y, w, h)\n  _internal.sendMessage('canvas.pathRect', { x=x, y=y, w=w, h=h })\nend\n\n---Adds a rounded rectangle to the current path. Must be followed by stroke() or fill().\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\n---@param radius number|table corner radius applied to all four corners (uniform), or a table\n---of 1–4 values to set individual corner radius in the order [top-left, top-right,\n---bottom-right, bottom-left], following the HTML Canvas API specification.\nfunction canvas.roundRect(x, y, w, h, radius)\n  _internal.sendMessage('canvas.roundRect', { x=x, y=y, w=w, h=h, radius=radius })\nend\n\n---Draw a rectangle outline using the current stroke style.\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\nfunction canvas.strokeRect(x, y, w, h)\n  _internal.sendMessage('canvas.strokeRect', { x=x, y=y, w=w, h=h })\nend\n\n---Draw  a rectangle with a filled interior using the current fill style,\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\nfunction canvas.fillRect(x, y, w, h)\n  _internal.sendMessage('canvas.fillRect', { x=x, y=y, w=w, h=h })\nend\n\n---Clears the specified rectangle by setting its pixels to transparent.\n---@param x number x-coordinate of the rectangle upper-left corner.\n---@param y number y-coordinate of the rectangle upper-left corner.\n---@param w number width of the rectangle.\n---@param h number height of the rectangle.\nfunction canvas.clearRect(x, y, w, h)\n  _internal.sendMessage('canvas.clearRect', { x=x, y=y, w=w, h=h })\nend\n\n---Draws a circle with given parameters. Must be followed by stroke() or fill().\n---@param x number x-coordinates of the center of the circle.\n---@param y number y-coordinates of the center of the circle.\n---@param r number the radius of the circle\nfunction canvas.circle(x, y, r)\n  _internal.sendMessage('canvas.circle', { x=x, y=y, r=r })\nend\n\n---Draws an arc with given parameters. Must be followed by stroke() or fill().\n---@param x number x-coordinates of the center of the circle.\n---@param y number y-coordinates of the center of the circle.\n---@param r number the radius of the circle.\n---@param startAngle number the starting angle in radians.\n---@param endAngle number the ending angle, in radians.\n---@param anticlockwise boolean a flag which specifies whether the drawing should be counterclockwise or clockwise.\nfunction canvas.arc(x, y, r, startAngle, endAngle, anticlockwise)\n  _internal.sendMessage('canvas.arc', { x=x, y=y, r=r, startAngle=startAngle,\n                              endAngle=endAngle, anticlockwise=anticlockwise })\nend\n\n---Adds a quadratic Bézier curve to the path with given control point and end point.\n---@param cpx number x-coordinate of the control point.\n---@param cpy number y-coordinate of the control point.\n---@param x number x-coordinate of the end point.\n---@param y number y-coordinate of the end point.\nfunction canvas.quadraticCurve(cpx, cpy, x, y)\n  _internal.sendMessage('canvas.quadraticCurve', { cpx=cpx, cpy=cpy, x=x, y=y })\nend\n\n---Draws a bezier curve from the current position to the specified point, using the specified control points.\n---@param cp1x number x-coordinate of the first control point.\n---@param cp1y number y-coordinate of the first control point.\n---@param cp2x number x-coordinate of the second control point.\n---@param cp2y number y-coordinate of the second control point.\n---@param x number x-coordinate of the end point.\n---@param y number y-coordinate of the end point.\nfunction canvas.bezierCurve(cp1x, cp1y, cp2x, cp2y, x, y)\n  _internal.sendMessage('canvas.bezierCurve', { cp1x=cp1x, cp1y=cp1y,\n                                  cp2x=cp2x, cp2y=cp2y,\n                                  x=x, y=y })\nend\n\n---@class Gradient\n---A class to internally link gradient objects from the Lua environment to Lumino codebase.\n---A Gradient object can be create using @{createLinearGradient} or @{createRadialGradient}\n---@private\nlocal Gradient = {}\n\n---Creates a new gradient object with the given index\n---@param idx number index of the gradient object\n---@private\nfunction Gradient:new(idx)\n  -- Store the gradient object in a field of the class instance metatable\n  local obj = { idx = idx}\n  Class.__setmetatable(obj, self)\n  self.__index = self\n  -- Return the instance\n  return obj\nend\n\n---Hook that runs before an object is deleted by the garbage collector.\n---It calls a function to delete the gradient object in JS\n---@private\nfunction Gradient:__gc()\n  -- Keep deletion ordering deterministic when gradient operations are buffered.\n  _commitIfNeeded()\n  _internal.sendMessage('canvas.deleteGradient', { gradientIdx = self.idx })\nend\n-- Add the Gradient class to the Canvas namespace\ncanvas.Gradient = Gradient\n\n---Sets a gradient object to active.\n---@param gradient Gradient a gradient object\nfunction canvas.setGradientActive(gradient)\n  if gradient.idx >= 0 then\n    _internal.sendMessage('canvas.setGradientActive', { gradientIdx = gradient.idx })\n  end\nend\n\n---Adds a new stop, defined by an offset and a color, to a gradient object.\n---@param gradient Gradient a gradient object\n---@param offset number a value between 0.0 and 1.0 where the new color stop is positioned.\n---@param r number Red channel value (0–255)\n---@param g number Green channel value (0–255)\n---@param b number Blue channel value (0–255)\n---@param a number Alpha channel value (0–1)\nfunction canvas.colorStop(gradient, offset, r, g, b, a)\n  _internal.sendMessage('canvas.colorStop', { gradientIdx=gradient.idx, offset=offset, r=r, g=g, b=b, a=a })\nend\n\n---Creates a linear gradient object.\n---@param x1 number the x-coordinate of the start point of the gradient\n---@param y1 number the y-coordinate of the start point of the gradient\n---@param x2 number the x-coordinate of the end point of the gradient\n---@param y2 number the y-coordinate of the end point of the gradient\n---@return Gradient a new gradient object\n---@usage local gradient = Canvas.createLinearGradient(0, 0, 50, 0)\nfunction canvas.createLinearGradient(x1, y1, x2, y2)\n  local idx = _internal.sendMessage('canvas.createLinearGradient', { x1=x1, y1=y1,\n                                  x2=x2, y2=y2 })\n  local gradient = Gradient:new(idx)\n  return gradient\nend\n\n---Creates a radial gradient object.\n---@param x1 number x-coordinate of the start circle\n---@param y1 number y-coordinate of the start circle\n---@param r1 number radius of the start circle\n---@param x2 number x-coordinate of the end circle\n---@param y2 number y-coordinate of the end circle\n---@param r2 number radius of the end circle\n---@return Gradient a new gradient object\nfunction canvas.createRadialGradient(x1, y1, r1, x2, y2, r2)\n  local idx = _internal.sendMessage('canvas.createRadialGradient', { x1=x1, y1=y1, r1=r1,\n                                  x2=x2, y2=y2, r2=r2})\n  local gradient = Gradient:new(idx)\n  return gradient\nend\n\n---Returns an array with strings of all available fonts. This will list all custom loaded fonts through Loader.loadFont and\n---fonts registered in Canvas Fonts in your project. It will also probe for common system fonts although the list might not be complete.\n---It is strongly recommended to use only custom uploaded fonts to have reliable results on all platforms.\n---@return table an array with all the available fonts as strings\nfunction canvas.getAvailableFonts()\n  return _internal.sendMessage('canvas.getAvailableFonts')\nend\n\n---Sets a font style.\n---@param font string The font style to be set, in the format of 'font-style font-size font-family'. Example: 'italic 20px Arial'.\nfunction canvas.setFont(font)\n  _internal.sendMessage('canvas.setFont', { font=font })\nend\n\n---Sets the current text alignment\n---@param align string The new text alignment to be set. One of 'start', 'end', 'left', 'right', or 'center'.\nfunction canvas.setTextAlign(align)\n  _internal.sendMessage('canvas.setTextAlign', { align=align })\nend\n\n---Sets the text baseline used when drawing text.\n---@param baseline string The text baseline to set. One of 'alphabetic', 'top', 'hanging', 'middle', 'ideographic', or 'bottom'.\nfunction canvas.setTextBaseline(baseline)\n  _internal.sendMessage('canvas.setTextBaseline', { baseline=baseline })\nend\n\n---Measures the width of the specified text in pixels.\n---@param text string The text to measure.\nfunction canvas.measureTextWidth(text)\n  return _internal.sendMessage('canvas.measureTextWidth', { text=text })\nend\n\n---Draws and fills a given text string at the specified coordinates.\n---@param text string The text string to be drawn and filled.\n---@param x number The x-coordinate where the text will be drawn.\n---@param y number The y-coordinate where the text will be drawn.\nfunction canvas.fillText(text, x, y)\n  _internal.sendMessage('canvas.fillText', { text=text, x=x, y=y })\nend\n\n---Draws the outline of the given text at the specified coordinates.\n---@param text string The text string to be drawn.\n---@param x number The x-coordinate where the text will be drawn.\n---@param y number The y-coordinate where the text will be drawn.\nfunction canvas.strokeText(text, x, y)\n  _internal.sendMessage('canvas.strokeText', { text=text, x=x, y=y })\nend\n\n-- -TODO: ImageData is not yet ready for deployment because using it for pixel manipulation would be\n-- -inefficient and slow due to the need for JSON communication with JavaScript. While JSON\n-- -communication is necessary for the security of the application, it is not well-suited for tasks\n-- -that require frequent or high-volume data transfer. It is better to use ImageData for low\n-- -frequency tasks such as updating UI and handling events, rather than trying to use it for more\n-- -demanding tasks that may be slowed down by the use of JSON objects.\n\n-- --- Image class to link imageData objects in the canvas to Lua\n-- ---@class imageData\n-- local Image = {}\n\n-- --- Creates a new Image object with the given index\n-- ---@param idx number index of the imageData object in the canvas\n-- function Image:new(idx)\n--   local obj = {}\n--   Class.__setmetatable(obj, self)\n--   self.__index = self\n--   self.idx = idx\n--   return obj\n-- end\n-- canvas.Image = Image\n\n-- ---Creates a new, blank Image object with the specified dimensions.\n-- ---All of the pixels in the new object are transparent black.\n-- ---@param width number the width of the Image object\n-- ---@param height number the height of the Image object\n-- ---@return Image a new Image object\n-- function canvas.createImage(width, height)\n--   local idx = _internal.sendMessage('canvas.createImage', { width=width, height=height })\n--   local image = Image:new(idx)\n--   return image\n-- end\n\n-- ---Write the RGBA channels of an Image object\n-- ---@param r number the r channel of the Image object\n-- ---@param g number the g channel of the Image object\n-- ---@param b number the b channel of the Image object\n-- ---@param a number the a channel of the Image object\n-- function canvas.writeImageChannels(image, r, g, b, a)\n--   _internal.sendMessage('canvas.writeImageChannels', { imageIdx=image.idx, r=r, g=g, b=b, a=a })\n-- end\n\n-- ---Draws an image given by an url at the specified position and dimensions.\n-- ---@param url string\n-- ---@param x number\n-- ---@param y number\n-- ---@param width number\n-- ---@param height number\n-- function canvas.drawImageFromUrl(url, x, y, width, height)\n--   _internal.sendMessage('canvas.drawImageFromUrl', { url=url, x=x, y=y, width=width, height=height })\n-- end\n\n-- ---Repeats a given image on the canvas with a given pattern.\n-- ---@param image imageSource an image object\n-- ---@param repeat string one of repeat, repeat-x, repeat-y, no-repeat\n-- function canvas.imagePattern(image, repeatPattern)\n--   _internal.sendMessage('canvas.pattern', { image=image, repeatPattern=repeatPattern })\n-- end\n\n---Draws the image data at the given coordinates.\n---@param image Texture the image data to paint\n---@param x number x-coordinate of the top left corner where the image data will be painted\n---@param y number y-coordinate of the top left corner where the image data will be painted\n---@param width number width of the image on screen (optional)\n---@param height number height of the image on screen (optional)\n---@param mode number mode to use for stretching. possible values are 0 = stretch, 1 = fit, 2 = cover\nfunction canvas.drawImage(image, x, y, width, height, mode)\n  __assertTrace(image and image._isTexture, \"image is not a Texture object\")\n  _internal.sendMessage('canvas.drawImage', { image= image._handle, x=x, y=y, width=width, height=height, mode=mode })\nend\n\n---Draws the image data at the given coordinates.\n---@param image Texture the image data to paint\n---@param x number x-coordinate of the top left corner where the image data will be painted\n---@param y number y-coordinate of the top left corner where the image data will be painted\n---@param width number width of the image on screen (optional)\n---@param height number height of the image on screen (optional)\nfunction canvas.drawSubImage(image, x, y, width, height, sourceX, sourceY, sourceWidth, sourceHeight)\n  __assertTrace(image and image._isTexture, \"image is not a Texture object\")\n  _internal.sendMessage('canvas.drawSubImage', { image= image._handle,\n                                                 x=x, y=y, width=width, height=height,\n                                                 sourceX=sourceX, sourceY=sourceY, sourceWidth=sourceWidth, sourceHeight=sourceHeight })\nend\n\n--- Scales the canvas by the specified factors along the x and y axes.\n--- Transformations are applied relative to the canvas origin (0,0).\n--- To scale around a different point, use `translate()` to move the origin before scaling.\n---@param x number Scale factor along the x-axis.\n---@param y number Scale factor along the y-axis.\nfunction canvas.scale(x, y)\n  _internal.sendMessage('canvas.scale', { x=x, y=y })\nend\n\n--- Rotates the canvas by the specified angle in radians.\n--- Rotation is performed around the canvas origin (0,0).\n--- To rotate around a different point, translate the canvas to that point before calling rotate().\n---@param a number Angle in radians.\nfunction canvas.rotate(a)\n  _internal.sendMessage('canvas.rotate', { a=a })\nend\n\n\n--- Moves (translates) the canvas origin by the specified amounts.\n--- All subsequent drawing and transformations (scale, rotate, etc.) are relative to the new origin.\n---@param x number Amount to translate along the x-axis.\n---@param y number Amount to translate along the y-axis.\nfunction canvas.translate(x, y)\n  _internal.sendMessage('canvas.translate', { x=x, y=y })\nend\n\n---Applies a 2D transformation matrix to the canvas.\n---@param horizontal_scale number The amount to scale horizontally.\n---@param horizontal_skew number The amount of horizontal skew.\n---@param vertical_skew number The amount of vertical skew.\n---@param vertical_scale number The amount to scale vertically.\n---@param horizontal_translation number The amount of horizontal translation.\n---@param vertical_translation number The amount of vertical translation.\nfunction canvas.transform(horizontal_scale, horizontal_skew, vertical_skew,\n                          vertical_scale, horizontal_translation, vertical_translation)\n  _internal.sendMessage('canvas.transform', { a=horizontal_scale, b=horizontal_skew,\n                                      c=vertical_skew, d=vertical_scale,\n                                      e=horizontal_translation, f=vertical_translation })\nend\n\n---Resets the current canvas transform to the identity matrix and then invokes the transform() function with the given parameters.\n---@param horizontal_scale number The amount to scale horizontally.\n---@param horizontal_skew number The amount of horizontal skew.\n---@param vertical_skew number The amount of vertical skew.\n---@param vertical_scale number The amount to scale vertically.\n---@param horizontal_translation number The amount of horizontal translation.\n---@param vertical_translation number The amount of vertical translation.\nfunction canvas.resetAndSetTransform(horizontal_scale, horizontal_skew, vertical_skew,\n                                    vertical_scale, horizontal_translation, vertical_translation)\n  _internal.sendMessage('canvas.resetAndSetTransform', { a=horizontal_scale, b=horizontal_skew,\n                                                  c=vertical_skew, d=vertical_scale,\n                                                  e=horizontal_translation, f=vertical_translation })\nend\n\n---Reset the transformation matrix to the identity matrix.\n---@function\nfunction canvas.resetTransform()\n  _internal.sendMessage('canvas.resetTransform')\nend\n\n---Pushes the current canvas state to a stack so that you can restore it.\n---This can be useful for performing multiple transformations or styles on the canvas, and\n---then restoring it to its original state. The canvas state in fact includes current transformation matrix\n---stroke and fill styles, shadow styles, and other attributes. To restore the canvas state you call\n---the restoreState() function.\n---@function\nfunction canvas.saveState()\n  _internal.sendMessage('canvas.saveState')\nend\n\n---Pops the the most recently saved canvas from the saved state stack and restores it.\n---@function\nfunction canvas.restoreState()\n  _internal.sendMessage('canvas.restoreState')\nend\n\n--- Resets the canvas to its default state, clearing the canvas and restoring all\n--- context -properties (transforms, styles, clipping region, etc.) to their\n--- defaults. Reset() is more thorough than -calling clear() alone, which only\n--- erases pixels but leaves context state intact.\n---@function\nfunction canvas.reset()\n  _internal.sendMessage('canvas.reset')\nend\n\n-- Automatically wrap canvas methods for buffering, so non-query calls are queued\n-- and query/result-producing calls force an immediate commit first.\nlocal _passthroughMethods = {\n  commit = true,\n  getPendingCommandCount = true,\n  getPendingCommands = true,\n}\n\nlocal _immediateMethods = {\n  getLastCommittedCommands = true,\n  getWidth = true,\n  getHeight = true,\n  isPointInPath = true,\n  createLinearGradient = true,\n  createRadialGradient = true,\n  getAvailableFonts = true,\n  measureTextWidth = true,\n}\n\nfor name, fn in pairs(canvas) do\n  if type(fn) == \"function\" and name ~= \"Gradient\" then\n    if _passthroughMethods[name] then\n      -- keep as-is\n    elseif _immediateMethods[name] then\n      canvas[name] = function(...)\n        _commitIfNeeded()\n        return fn(...)\n      end\n    else\n      canvas[name] = function(...)\n        return _runWithCapturedSend(fn, ...)\n      end\n    end\n  end\nend\n\nreturn canvas\n";
 
 	var lua_api_class = "\nlocal Class = {}\n\nClass.__setmetatable = setmetatable\n_G.setmetatable = function()\n    error(\"Do not use setmetatable. Use Class.new() instead!\")\nend\n\n-- Put the class in the global scope\n_G.Class = Class\n\nfunction Class.new(self, super)\n    if self ~= Class then\n        -- new was called with dot syntax, so we need to move self to super.\n        super = self\n    end\n\n    local class, metatable, properties = {}, {}, {}\n    class.metatable = metatable\n    class.properties = properties\n\n    function metatable:__index(key)\n        local prop = properties[key]\n        if prop then\n            return prop:get()\n        elseif class[key] ~= nil then\n            return class[key]\n        elseif class.__customIndex then\n            return class.__customIndex(self, key)\n        elseif super then\n            return super.metatable.__index(self, key)\n        else\n            return nil\n        end\n    end\n\n    function metatable:__newindex(key, value)\n        local prop = properties[key]\n        if prop then\n            prop:set(value)\n        elseif class.__customNewIndex then\n            class.__customNewIndex(self, key, value)\n        else\n            if (super and super.metatable.__customnewindex(self, key, value)) then\n                return\n            end\n            rawset(self, key, value)\n        end\n    end\n\n    function metatable:__customnewindex(key, value)\n        if class.__customNewIndex then\n            class.__customNewIndex(self, key, value)\n            return true\n        elseif super then\n            return super.metatable.__customnewindex(self, key, value)\n        end\n        return false\n    end\n\n    function class:getClass()\n        return class\n    end\n\n    function class.new(self, ...)\n        local obj = Class.__setmetatable({}, class.metatable)\n\n        if obj.__new then\n            if self ~= class then\n                -- new was called with dot syntax\n                obj:__new(self, ...)\n            else\n                obj:__new(...)\n            end\n        end\n\n        return obj\n    end\n\n    function tableLength(T)\n        local count = 0\n        for _ in pairs(T) do\n            count = count + 1\n        end\n        return count\n    end\n\n    function class:addProperty(key, propType, defaultValue, options)\n        options = options or {}\n        if type(options) == 'string' then\n            options = { info=options }\n        end\n\n        if class.properties[key] then\n            error(\"A property with the name '\" .. key .. \"' already exists!\");\n            return;\n        end\n        class.properties[key] = Property.new(propType, defaultValue, tableLength(class.properties), options);\n    end\n\n    return class\nend\n\nreturn Class\n";
 
@@ -286557,6 +286556,26 @@ var<${access}> ${ name } : ${ structName };`;
 	    pushChildTask(task) {
 	        this.childTasks.push(task);
 	    }
+	    findPerformanceIssuePath(limit) {
+	        limit = limit || this.profiler.performanceWarningLimitMs;
+	        let path = "";
+	        if (this.duration > limit) {
+	            path += ` -> ${this.subsystem}/${this.taskname} (${Math.ceil(this.duration)}ms)`;
+	        }
+	        let worstChild = undefined;
+	        for (const child of this.childTasks) {
+	            if (!worstChild || child.duration > worstChild.duration) {
+	                worstChild = child;
+	            }
+	        }
+	        if (worstChild) {
+	            const subPath = worstChild.findPerformanceIssuePath(limit);
+	            if (subPath) {
+	                path += subPath;
+	            }
+	        }
+	        return path;
+	    }
 	    toData() {
 	        return {
 	            subsystem: this.subsystem,
@@ -286578,6 +286597,8 @@ var<${access}> ${ name } : ${ structName };`;
 	    lastRecording;
 	    loggedCalls = new Map();
 	    lastLoggedCalls = undefined;
+	    performanceWaningEnabled = false;
+	    performanceWarningLimitMs = 20;
 	    constructor(engine) {
 	        this.engine = engine;
 	        this.dummyTask = {
@@ -286617,11 +286638,21 @@ var<${access}> ${ name } : ${ structName };`;
 	        }
 	        return null;
 	    }
+	    testPerformanceWarning(task, limit) {
+	        limit = limit || this.performanceWarningLimitMs;
+	        if (task.duration > limit) {
+	            const path = task.findPerformanceIssuePath(limit);
+	            console.warn(`Profiler performance warning! Task took ${Math.ceil(task.duration)}ms! Path: ${path}`);
+	        }
+	    }
 	    endRecord() {
 	        try {
 	            if (!this.root)
 	                return null;
 	            this.root.done();
+	            if (this.performanceWaningEnabled) {
+	                this.testPerformanceWarning(this.root);
+	            }
 	            this.lastRecording = this.root.toData();
 	            this.lastLoggedCalls = Array.from(this.loggedCalls.values());
 	            this.engine.eventBus.$emit("profiler:update", this.lastRecording, this.lastLoggedCalls);
@@ -288328,10 +288359,16 @@ var<${access}> ${ name } : ${ structName };`;
 	            .map(result => {
 	            const item = result.item;
 	            const container = item.getContainer();
-	            container.updateWorldMatrix(true, false);
-	            item.block.moveData = {
-	                oldWorldMatrix: container.matrixWorld.clone(),
-	            };
+	            // in case we are moving to a new non-subnode parent, we want to remember the old
+	            // world matrix to compensate for the reparenting so the object stays in its position
+	            // in case we move between subnodes, we want to keep the local transform, so the object
+	            // actually moves
+	            if (!destinationSubNode) {
+	                container.updateWorldMatrix(true, false);
+	                item.block.moveData = {
+	                    oldWorldMatrix: container.matrixWorld.clone(),
+	                };
+	            }
 	            return item.block;
 	        });
 	        let i = index;