QuickJS

.github/workflows/build-macos.yml

@@ -19,6 +19,10 @@ on:
         required: false
         type: string
         default: macos-latest
+      js-engine:
+        required: false
+        type: string
+        default: ''
 
 env:
   UBSAN_OPTIONS: halt_on_error=1:print_stacktrace=1:symbolize=1
@@ -41,6 +45,7 @@ jobs:
       - name: Generate macOS solution
         run: |
           cmake -G "${{ inputs.generator }}" -B build/macOS \
+            ${{ inputs.js-engine != '' && format('-D NAPI_JAVASCRIPT_ENGINE={0}', inputs.js-engine) || '' }} \
             -D BABYLON_DEBUG_TRACE=ON \
             -D ENABLE_SANITIZERS=${{ inputs.enable-sanitizers && 'ON' || 'OFF' }} \
             -D BABYLON_NATIVE_TESTS_USE_NOOP_METAL_DEVICE=ON
@@ -74,7 +79,7 @@ jobs:
         if: failure()
         uses: actions/upload-artifact@v6
         with:
-          name: macos-${{ inputs.generator }}${{ inputs.enable-sanitizers && '-sanitizer' || '' }}-core-dumps
+          name: macos-${{ inputs.generator }}-${{ inputs.js-engine != '' && inputs.js-engine || 'default' }}${{ inputs.enable-sanitizers && '-sanitizer' || '' }}-core-dumps
           path: |
             build/macOS/Apps/UnitTests/RelWithDebInfo/UnitTests
             build/macOS/Apps/UnitTests/RelWithDebInfo/*.core.*

.github/workflows/build-win32.yml

@@ -47,6 +47,9 @@ jobs:
           elif [ "${{ inputs.napi-type }}" = "Hermes" ]; then
             SUFFIX="_Hermes"
             JS_DEFINE="-DNAPI_JAVASCRIPT_ENGINE=Hermes -DHERMES_ALLOW_BOOST_CONTEXT=0"
+          elif [ "${{ inputs.napi-type }}" = "QuickJS" ]; then
+            SUFFIX="_QuickJS"
+            JS_DEFINE="-DNAPI_JAVASCRIPT_ENGINE=QuickJS"
           fi
           echo "suffix=$SUFFIX" >> "$GITHUB_OUTPUT"
           echo "js_define=$JS_DEFINE" >> "$GITHUB_OUTPUT"

.github/workflows/ci.yml

@@ -42,6 +42,13 @@ jobs:
       xcode-version: "26.4"
       runs-on: macos-26
 
+  MacOS_QuickJS:
+    uses: ./.github/workflows/build-macos.yml
+    with:
+      xcode-version: "26.4"
+      runs-on: macos-26
+      js-engine: QuickJS
+
   # ── Win32─────────────────────────────────────────────────────
   Win32_x64_D3D11:
     uses: ./.github/workflows/build-win32.yml
@@ -66,6 +73,13 @@ jobs:
       platform: x64
       napi-type: Hermes
 
+  Win32_x64_QuickJS_D3D11:
+    uses: ./.github/workflows/build-win32.yml
+    with:
+      platform: x64
+      napi-type: QuickJS
+      graphics-api: D3D11
+
   Win32_x64_D3D11_Sanitizers:
     uses: ./.github/workflows/build-win32.yml
     with:
@@ -120,6 +134,13 @@ jobs:
       cxx: g++
       js-engine: JavaScriptCore
 
+  Ubuntu_Clang_QuickJS:
+    uses: ./.github/workflows/build-linux.yml
+    with:
+      cc: clang
+      cxx: clang++
+      js-engine: QuickJS
+
   # ── Android ───────────────────────────────────────────────────
   Android_Ubuntu_JSC:
     uses: ./.github/workflows/build-android.yml
@@ -139,6 +160,12 @@ jobs:
       runs-on: ubuntu-latest
       js-engine: Hermes
 
+  Android_Ubuntu_QuickJS:
+    uses: ./.github/workflows/build-android.yml
+    with:
+      runs-on: ubuntu-latest
+      js-engine: QuickJS
+
   Android_MacOS_JSC:
     uses: ./.github/workflows/build-android.yml
     with:
@@ -151,6 +178,12 @@ jobs:
       runs-on: macos-26
       js-engine: V8
 
+  Android_MacOS_QuickJS:
+    uses: ./.github/workflows/build-android.yml
+    with:
+      runs-on: macos-26
+      js-engine: QuickJS
+
   # ── Installation Tests ────────────────────────────────────────
   iOS_Installation:
     uses: ./.github/workflows/test-install-ios.yml

Apps/ModuleLoadTest/Source/App.Apple.mm

@@ -4,6 +4,8 @@
 #include <Babylon/DebugTrace.h>
 #include <Babylon/Graphics/Device.h>
 
+#import <Foundation/Foundation.h>
+
 #import <Metal/Metal.hpp>
 
 #include <sys/sysctl.h>

Apps/Playground/Scripts/validation_native.js

@@ -371,21 +371,36 @@
                                 }
                             }
 
-                            currentScene = eval(code + "\r\ncreateScene(engine)");
-
-                            if (currentScene.then) {
-                                // Handle if createScene returns a promise
-                                currentScene.then(function (scene) {
-                                    currentScene = scene;
-                                    processCurrentScene(test, referenceImage, done, compareFunction);
-                                }).catch(function (e) {
-                                    console.error(e);
+                            const pgCode = code + "\r\ncreateScene(engine)";
+                            // Defer scene construction to a fresh macrotask so
+                            // eval()/createScene() run at a shallow native-stack
+                            // depth instead of nested inside the native snippet
+                            // load callback. Deep scenes otherwise pile onto the
+                            // native XHR dispatch frames and can overflow engines
+                            // with a small C stack (e.g. QuickJS).
+                            setTimeout(function () {
+                                try {
+                                    currentScene = eval(pgCode);
+
+                                    if (currentScene.then) {
+                                        // Handle if createScene returns a promise
+                                        currentScene.then(function (scene) {
+                                            currentScene = scene;
+                                            processCurrentScene(test, referenceImage, done, compareFunction);
+                                        }).catch(function (e) {
+                                            console.error(e);
+                                            failTest(done);
+                                        });
+                                    } else {
+                                        // Handle if createScene returns a scene
+                                        processCurrentScene(test, referenceImage, done, compareFunction);
+                                    }
+                                }
+                                catch (e) {
+                                    console.error("Failed to evaluate playground snippet " + test.playgroundId + ": " + e);
                                     failTest(done);
-                                });
-                            } else {
-                                // Handle if createScene returns a scene
-                                processCurrentScene(test, referenceImage, done, compareFunction);
-                            }
+                                }
+                            }, 0);
                         }
                         catch (e) {
                             console.error("Failed to evaluate playground snippet " + test.playgroundId + ": " + e);
@@ -442,8 +457,23 @@
                             }
                         }
 
-                        currentScene = eval(scriptToRun + test.functionToCall + "(engine)");
-                        processCurrentScene(test, renderImage, done, compareFunction);
+                        const scriptCode = scriptToRun + test.functionToCall + "(engine)";
+                        // Defer scene construction to a fresh macrotask so
+                        // eval()/<functionToCall>() run at a shallow native-stack
+                        // depth instead of nested inside the native XHR
+                        // completion callback. Deep scenes otherwise pile onto
+                        // the native XHR dispatch frames and can overflow engines
+                        // with a small C stack (e.g. QuickJS).
+                        setTimeout(function () {
+                            try {
+                                currentScene = eval(scriptCode);
+                                processCurrentScene(test, renderImage, done, compareFunction);
+                            }
+                            catch (e) {
+                                console.error(e);
+                                failTest(done);
+                            }
+                        }, 0);
                     }
                     catch (e) {
                         console.error(e);

Apps/UnitTests/Source/App.Apple.mm

@@ -1,6 +1,8 @@
 #include "App.h"
 #include <Babylon/DebugTrace.h>
 
+#import <Foundation/Foundation.h>
+
 #include <mach-o/dyld.h>
 
 std::filesystem::path GetExecutableDirectory()

CMakeLists.txt

@@ -23,7 +23,7 @@ FetchContent_Declare(AndroidExtensions
     EXCLUDE_FROM_ALL)
 FetchContent_Declare(arcana.cpp
     GIT_REPOSITORY https://github.com/microsoft/arcana.cpp.git
-    GIT_TAG b9bf9d85fce37d5fc9dbfc4a4dc5e1531bee215a
+    GIT_TAG fe41b17dedea47b5dead98f0271ca284e94ac6a8
     EXCLUDE_FROM_ALL)
 FetchContent_Declare(arcore-android-sdk
     GIT_REPOSITORY https://github.com/google-ar/arcore-android-sdk.git
@@ -54,7 +54,7 @@ FetchContent_Declare(ios-cmake
     EXCLUDE_FROM_ALL)
 FetchContent_Declare(JsRuntimeHost
     GIT_REPOSITORY https://github.com/BabylonJS/JsRuntimeHost.git
-    GIT_TAG f07d99119887131a89a3580ada9c2a8dbc7782f7)
+    GIT_TAG 8cd142951018de07c89c23f726fb7dc9c8374599)
 FetchContent_Declare(metal-cpp
     GIT_REPOSITORY https://github.com/bkaradzic/metal-cpp.git
     GIT_TAG metal-cpp_26

Polyfills/Canvas/Source/Gradient.cpp

@@ -88,8 +88,10 @@ namespace Babylon::Polyfills::Internal
 
     Napi::Object CanvasGradient::CreateLinear(Napi::Env env, const std::shared_ptr<NVGcontext*>& context, float x0, float y0, float x1, float y1)
     {
-        Napi::HandleScope scope{ env };
-
+        // NOTE: Do not open a Napi::HandleScope here. The gradient object created below is
+        // returned to the caller, and a plain (non-escapable) HandleScope would release the
+        // handle on close. Under the reference-counted QuickJS Node-API port that frees the
+        // object's only reference, yielding a dangling value (typeof "unknown", no prototype).
         auto func = JsRuntime::NativeObject::GetFromJavaScript(env).Get(JS_CANVAS_GRADIENT_CONSTRUCTOR_NAME).As<Napi::Function>();
         auto gradientValue = func.New({ Napi::Value::From(env, x0), Napi::Value::From(env, y0), Napi::Value::From(env, x1), Napi::Value::From(env, y1) });
         CanvasGradient::Unwrap(gradientValue)->context = context;
@@ -98,8 +100,7 @@ namespace Babylon::Polyfills::Internal
 
     Napi::Object CanvasGradient::CreateRadial(Napi::Env env, const std::shared_ptr<NVGcontext*>& context, float x0, float y0, float r0, float x1, float y1, float r1)
     {
-        Napi::HandleScope scope{ env };
-
+        // See CreateLinear: no HandleScope here so the returned gradient handle is not freed on scope close.
         auto func = JsRuntime::NativeObject::GetFromJavaScript(env).Get(JS_CANVAS_GRADIENT_CONSTRUCTOR_NAME).As<Napi::Function>();
         auto gradientValue = func.New({ Napi::Value::From(env, x0), Napi::Value::From(env, y0), Napi::Value::From(env, x1), Napi::Value::From(env, y1), Napi::Value::From(env, r0), Napi::Value::From(env, r1) });
         CanvasGradient::Unwrap(gradientValue)->context = context;

Polyfills/Canvas/Source/ImageData.cpp

@@ -21,7 +21,9 @@ namespace Babylon::Polyfills::Internal
 
     Napi::Value ImageData::CreateInstance(Napi::Env env, Context* context, uint32_t width, uint32_t height)
     {
-        Napi::HandleScope scope{env};
+        // No Napi::HandleScope here: the object created by func.New() is returned to the caller.
+        // A plain HandleScope would free the handle on close, which under the reference-counted
+        // QuickJS Node-API port leaves the caller with a dangling value.
         Napi::Function func = DefineClass(
             env,
             JS_IMAGEDATA_CONSTRUCTOR_NAME,