Removed UltraLight. Added CEF integration for 32 and 64 bits systems with cmake subsystem download

Author: Segfaultd

.cursor/memory-bank/techContext.md

@@ -61,7 +61,7 @@ lua                  - Scripting
 sdl2                 - Window management
 sentry               - Error reporting
 imgui                - GUI
-ultralight           - Web-based UI
+cef                  - Web-based UI (Chromium Embedded Framework)
 steamworks/galaxy    - Platform integration
 discord              - Discord integration
 ```

CLAUDE.md

@@ -42,7 +42,7 @@ Or use Visual Studio 2022 with CMake tools installed and open the repository fol
 2. **World Engine** (`world/engine.h`) - ECS-based world management using Flecs with streaming support
 3. **Networking** (`networking/network_peer.h`) - Client-server communication via SlikeNet
 4. **Scripting** (`scripting/`) - JavaScript/TypeScript scripting for game logic (Server: libnode, Client: V8)
-5. **GUI Manager** (`gui/manager.h`) - UI using Ultralight and Dear ImGui
+5. **GUI Manager** (`gui/manager.h`) - UI using CEF and Dear ImGui
 6. **Job System** (`jobs/job_system.h`) - Opt-in fiber-based task scheduling using FTL
 
 ### Integration Layer
@@ -87,7 +87,7 @@ Format: `Module: Brief commit description`
 - **FTL** - Fiber Tasking Library for job system (v2.1.0)
 - **libnode/V8** - JavaScript scripting (Server uses libnode for full Node.js APIs, Client uses V8 for sandboxed execution)
 - **SlikeNet** - Networking
-- **Ultralight** - Web-based UI
+- **CEF** - Web-based UI (Chromium Embedded Framework)
 - **Dear ImGui** - Immediate mode GUI
 - **spdlog** - Logging
 - **nlohmann/json** - JSON parsing

LICENSE.txt

@@ -45,7 +45,7 @@ This codebase also depends on the following third-party libraries:
     protobuf        - https://github.com/protocolbuffers/protobuf/blob/master/LICENSE
     curl            - https://curl.se/docs/copyright.html
     udis86          - https://github.com/vmt/udis86
-    ultralight      - https://ultralig.ht/
+    cef             - https://bitbucket.org/chromiumembedded/cef/
     flecs           - https://github.com/SanderMertens/flecs/
     fmt             - https://fmt.dev/latest/index.html
     cxxopts         - https://github.com/jarro2783/cxxopts

cmake/DownloadCEF.cmake

@@ -0,0 +1,105 @@
+# DownloadCEF.cmake
+#
+# Downloads and extracts a CEF binary distribution at CMake configure time.
+# Based on the official chromiumembedded/cef-project approach.
+#
+# Usage:
+#   DownloadCEF(<platform> <version> <download_dir>)
+#
+# Where:
+#   platform     - "windows32" or "windows64"
+#   version      - CEF version string (e.g. "144.0.6+g5f7e671+chromium-144.0.7559.59")
+#   download_dir - Directory to download and extract into
+#
+# Sets the following cache variable:
+#   CEF_ROOT - Path to the extracted CEF distribution directory
+
+function(DownloadCEF platform version download_dir)
+    # Use minimal distribution (no sample apps, significantly smaller download)
+    set(CEF_DISTRIBUTION "cef_binary_${version}_${platform}_minimal")
+    set(CEF_DOWNLOAD_DIR "${download_dir}")
+
+    # The location where we expect the extracted binary distribution
+    set(CEF_ROOT "${CEF_DOWNLOAD_DIR}/${CEF_DISTRIBUTION}" CACHE INTERNAL "CEF_ROOT")
+
+    # Skip if already extracted
+    if(IS_DIRECTORY "${CEF_ROOT}")
+        message(STATUS "CEF: Using existing distribution at ${CEF_ROOT}")
+        return()
+    endif()
+
+    set(CEF_DOWNLOAD_FILENAME "${CEF_DISTRIBUTION}.tar.bz2")
+    set(CEF_DOWNLOAD_PATH "${CEF_DOWNLOAD_DIR}/${CEF_DOWNLOAD_FILENAME}")
+
+    # Build URL with '+' encoded as '%2B'
+    set(CEF_DOWNLOAD_URL "https://cef-builds.spotifycdn.com/${CEF_DOWNLOAD_FILENAME}")
+    string(REPLACE "+" "%2B" CEF_DOWNLOAD_URL_ESCAPED "${CEF_DOWNLOAD_URL}")
+
+    if(NOT EXISTS "${CEF_DOWNLOAD_PATH}")
+        # Download SHA1 hash for verification
+        message(STATUS "CEF: Downloading checksum ...")
+        file(DOWNLOAD "${CEF_DOWNLOAD_URL_ESCAPED}.sha1" "${CEF_DOWNLOAD_PATH}.sha1"
+            STATUS DOWNLOAD_SHA1_STATUS
+        )
+        list(GET DOWNLOAD_SHA1_STATUS 0 SHA1_STATUS_CODE)
+        if(NOT SHA1_STATUS_CODE EQUAL 0)
+            list(GET DOWNLOAD_SHA1_STATUS 1 SHA1_ERROR_MSG)
+            file(REMOVE "${CEF_DOWNLOAD_PATH}.sha1")
+            message(FATAL_ERROR
+                "CEF: Failed to download SHA1 checksum: ${SHA1_ERROR_MSG}\n"
+                "  URL: ${CEF_DOWNLOAD_URL_ESCAPED}.sha1\n"
+                "  Check that CEF_VERSION is valid at https://cef-builds.spotifycdn.com/index.html"
+            )
+        endif()
+
+        file(READ "${CEF_DOWNLOAD_PATH}.sha1" CEF_SHA1)
+        string(STRIP "${CEF_SHA1}" CEF_SHA1)
+
+        # Validate SHA1 looks like a 40-char hex string
+        string(LENGTH "${CEF_SHA1}" SHA1_LEN)
+        if(NOT SHA1_LEN EQUAL 40)
+            file(REMOVE "${CEF_DOWNLOAD_PATH}.sha1")
+            message(FATAL_ERROR
+                "CEF: Downloaded SHA1 checksum is invalid (length ${SHA1_LEN}, expected 40).\n"
+                "  URL: ${CEF_DOWNLOAD_URL_ESCAPED}.sha1\n"
+                "  Check that CEF_VERSION is valid at https://cef-builds.spotifycdn.com/index.html"
+            )
+        endif()
+
+        # Download the binary distribution with hash verification
+        message(STATUS "CEF: Downloading ${CEF_DOWNLOAD_FILENAME} (~100MB, this may take a while) ...")
+        file(DOWNLOAD "${CEF_DOWNLOAD_URL_ESCAPED}" "${CEF_DOWNLOAD_PATH}"
+            EXPECTED_HASH SHA1=${CEF_SHA1}
+            SHOW_PROGRESS
+            STATUS DOWNLOAD_STATUS
+        )
+        list(GET DOWNLOAD_STATUS 0 STATUS_CODE)
+        if(NOT STATUS_CODE EQUAL 0)
+            list(GET DOWNLOAD_STATUS 1 ERROR_MSG)
+            file(REMOVE "${CEF_DOWNLOAD_PATH}")
+            message(FATAL_ERROR "CEF: Download failed: ${ERROR_MSG}\n  URL: ${CEF_DOWNLOAD_URL_ESCAPED}")
+        endif()
+
+        message(STATUS "CEF: Download complete.")
+    else()
+        message(STATUS "CEF: Using cached archive ${CEF_DOWNLOAD_PATH}")
+    endif()
+
+    # Extract the binary distribution
+    message(STATUS "CEF: Extracting ${CEF_DOWNLOAD_FILENAME} ...")
+    execute_process(
+        COMMAND ${CMAKE_COMMAND} -E tar xzf "${CEF_DOWNLOAD_PATH}"
+        WORKING_DIRECTORY "${CEF_DOWNLOAD_DIR}"
+        RESULT_VARIABLE EXTRACT_RESULT
+    )
+    if(NOT EXTRACT_RESULT EQUAL 0)
+        message(FATAL_ERROR "CEF: Extraction failed (exit code ${EXTRACT_RESULT})")
+    endif()
+
+    # Verify extraction succeeded
+    if(NOT IS_DIRECTORY "${CEF_ROOT}")
+        message(FATAL_ERROR "CEF: Extraction completed but expected directory not found: ${CEF_ROOT}")
+    endif()
+
+    message(STATUS "CEF: Ready at ${CEF_ROOT}")
+endfunction()

code/framework/CMakeLists.txt

@@ -82,17 +82,20 @@ set(FRAMEWORK_CLIENT_SRC
     src/integrations/client/scripting/module.cpp
 )
 
-# GUI (Ultralight) only available for 64-bit builds
-if(CMAKE_CL_64)
-    list(APPEND FRAMEWORK_CLIENT_SRC
-        src/gui/manager.cpp
-        src/gui/clipboard.cpp
-        src/gui/view.cpp
-        src/gui/sdk.cpp
-        src/gui/backend/renderer_d3d11.cpp
-        src/gui/backend/view_d3d11.cpp
-    )
-endif()
+# GUI (CEF-based)
+list(APPEND FRAMEWORK_CLIENT_SRC
+    src/gui/manager.cpp
+    src/gui/clipboard.cpp
+    src/gui/view.cpp
+    src/gui/sdk.cpp
+    src/gui/backend/view_d3d11.cpp
+    src/gui/cef/app.cpp
+    src/gui/cef/client.cpp
+    src/gui/cef/render_handler.cpp
+    src/gui/cef/life_span_handler.cpp
+    src/gui/cef/load_handler.cpp
+    src/gui/cef/display_handler.cpp
+)
 
 # Append the platform-dependent files to the related lists
 if(WIN32)
@@ -334,15 +337,27 @@ if(WIN32)
     if(NOT CMAKE_CL_64)
         target_link_options(FrameworkServer PUBLIC "-SAFESEH:NO")
     else()
-        target_link_libraries(FrameworkClient UltralightSDK JavaScriptCorePP)
         target_link_options(FrameworkClient PUBLIC "-SAFESEH:NO")
+    endif()
 
-        # Ultralight GUI includes (64-bit only)
-        target_include_directories(FrameworkClient PRIVATE
-            ${CMAKE_SOURCE_DIR}/vendors/ultralight/include
-            ${CMAKE_SOURCE_DIR}/vendors/directxtk
-            ${CMAKE_SOURCE_DIR}/vendors/javascriptcorepp/include
-        )
+    # CEF GUI integration (CEF target provides include dirs via INTERFACE)
+    target_link_libraries(FrameworkClient CEF)
+    target_include_directories(FrameworkClient PRIVATE
+        ${CMAKE_SOURCE_DIR}/vendors/directxtk
+    )
+
+    # CEF subprocess executable
+    add_executable(cef_subprocess
+        src/gui/cef/subprocess_main.cpp
+        src/gui/cef/renderer_app.cpp
+    )
+    target_link_libraries(cef_subprocess CEF)
+    set_target_properties(cef_subprocess PROPERTIES
+        RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin"
+    )
+    if(TARGET CEFCopyDlls)
+        add_dependencies(FrameworkClient CEFCopyDlls)
+        add_dependencies(cef_subprocess CEFCopyDlls)
     endif()
 
     # Ensure runtime DLLs are copied to bin directory for all client/server targets

code/framework/src/graphics/types.h

@@ -20,7 +20,7 @@ namespace Framework::Graphics {
 
     enum class RendererAPI {
         IMGUI,
-        ULTRALIGHT
+        CEF
     };
 
     enum class PlatformBackend {