@luminocity/lemonate-engine 26.4.3 → 26.4.6

package/dist/lemonate.es.js

@@ -11390,7 +11390,7 @@ class Item extends EventEmitter {
     }
 }
 
-var engine$1 = "26.4.3";
+var engine$1 = "26.4.6";
 var bullet = "3.26";
 var lua = "5.4.3";
 var packageVersionInfo = {
@@ -67293,222 +67293,222 @@ class RenderView {
     }
     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);
+                        this.webGlRenderer.setClearColor(0x000000, 1);
                     }
-                    // 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();
-                        });
-                    }
-                    // 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;
@@ -68260,7 +68260,7 @@ class Renderer {
     options;
     renderView = null;
     webGlRenderer;
-    webGpuRenderer;
+    //webGpuRenderer: WebGPURenderer;
     raycaster;
     renderers = {};
     requestFrameFuncs = [];
@@ -68337,7 +68337,7 @@ class Renderer {
             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();
@@ -68427,12 +68427,6 @@ class Renderer {
         return webGpuRenderer;
     }
     async init() {
-        try {
-            await this.webGpuRenderer.init();
-        }
-        catch (err) {
-            console.error("Failed to initialize WebGPU Renderer: ", err);
-        }
         try {
             await loadFontFace("OpenSansRegular", openSansRegularUrl);
         }
@@ -68444,9 +68438,9 @@ class Renderer {
     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
@@ -70552,7 +70546,7 @@ class SgItem extends SgResourceOwner {
      * this item's container to its parent directly. But in case where this item has a subNodeId, it is not directly
      * a child of its parent but to one of its subnodes. We need to check if this subnode exists and then add
      * ourselves to it. If that subnode does not exist, we will instead add to the parent directly again.
-     * This function needs to be called whenecer the parent updates its subnodes, because this would mean
+     * This function needs to be called whenever the parent updates its subnodes, because this would mean
      * the subnode will suddenly appear/disappear and we need to update parenting again
      */
     updateParenting() {
@@ -73559,7 +73553,6 @@ class SgMesh extends SgPhysicsItem {
         this.mixer = undefined;
         this.animations = [];
         this.activeTweens = undefined;
-        this.setFieldValue("Animations", []);
     }
     isAnimated() {
         return Boolean(this.mixer);
@@ -88201,9 +88194,15 @@ class SceneGraph {
      * @param node
      * @return {boolean}
      */
-    traverse(callback, node) {
+    traverse(callback, node, depthFirst = false) {
         node = node || this.root;
         if (node) {
+            if (depthFirst) {
+                for (const child of node.children) {
+                    if (!this.traverse(callback, child, true))
+                        return false;
+                }
+            }
             const result = callback(node);
             if (result === false)
                 return false;
@@ -88212,13 +88211,15 @@ class SceneGraph {
                 if (sceneItem) {
                     const sceneGraph = sceneItem.getSceneGraph();
                     if (sceneGraph)
-                        if (!sceneGraph.traverse(callback))
+                        if (!sceneGraph.traverse(callback, undefined, depthFirst))
                             return false;
                 }
             }
-            for (const child of node.children) {
-                if (!this.traverse(callback, child))
-                    return false;
+            if (!depthFirst) {
+                for (const child of node.children) {
+                    if (!this.traverse(callback, child, false))
+                        return false;
+                }
             }
         }
         return true;
@@ -88562,7 +88563,7 @@ class SceneGraph {
                 return false;
             }
             return true;
-        });
+        }, undefined, true);
         return result;
     }
     findSelectedItems() {
@@ -97453,9 +97454,9 @@ var lua_api_internal = "\nlocal msgpack = require('engine/msgpack');\nlocal pack
 
 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";
 
@@ -115768,6 +115769,26 @@ class ProfilerTask {
     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,
@@ -115789,6 +115810,8 @@ class Profiler {
     lastRecording;
     loggedCalls = new Map();
     lastLoggedCalls = undefined;
+    performanceWaningEnabled = false;
+    performanceWarningLimitMs = 20;
     constructor(engine) {
         this.engine = engine;
         this.dummyTask = {
@@ -115828,11 +115851,21 @@ class Profiler {
         }
         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);