fix: gui issues and added as.predefined

Reviewed-on: #4

.gitea/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  - push
+  - pull_request
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository (with submodules)
+        uses: actions/checkout@v4
+        with:
+          # Ensure submodules (like external/angelscript and external/raylib) are checked out.
+          submodules: true
+          # Fetch full history so submodules can be cloned properly.
+          fetch-depth: 0
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends \
+            build-essential cmake git pkg-config \
+            libx11-dev libxrandr-dev libxcursor-dev libxinerama-dev libxi-dev \
+            libgl1-mesa-dev libasound2-dev libpulse-dev libudev-dev libpng-dev
+
+      - name: Configure (CMake)
+        run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+
+      - name: Build unit tests
+        run: cmake --build build --target unit_tests -j $(nproc)
+
+      - name: Run tests
+        run: |
+          cd build
+          ctest --output-on-failure -j $(nproc)

.gitmodules

@@ -4,3 +4,12 @@
 [submodule "external/angelscript"]
 	path = external/angelscript
 	url = https://github.com/anjo76/angelscript.git
+[submodule "external/acutest"]
+	path = external/acutest
+	url = https://github.com/mity/acutest
+[submodule "external/imgui"]
+	path = external/imgui
+	url = https://github.com/ocornut/imgui.git
+[submodule "external/rlImGui"]
+	path = external/rlImGui
+	url = https://github.com/raylib-extras/rlImGui.git

.vscode/settings.json

@@ -1,6 +1,77 @@
 {
     "files.associations": {
         "*.h": "c",
-        "xstring": "cpp"
+        "xstring": "cpp",
+        "thread": "cpp",
+        "cctype": "cpp",
+        "clocale": "cpp",
+        "cmath": "cpp",
+        "cstdarg": "cpp",
+        "cstddef": "cpp",
+        "cstdio": "cpp",
+        "cstdlib": "cpp",
+        "cstring": "cpp",
+        "ctime": "cpp",
+        "cwchar": "cpp",
+        "cwctype": "cpp",
+        "array": "cpp",
+        "atomic": "cpp",
+        "bit": "cpp",
+        "bitset": "cpp",
+        "charconv": "cpp",
+        "chrono": "cpp",
+        "codecvt": "cpp",
+        "compare": "cpp",
+        "complex": "cpp",
+        "concepts": "cpp",
+        "condition_variable": "cpp",
+        "cstdint": "cpp",
+        "deque": "cpp",
+        "list": "cpp",
+        "map": "cpp",
+        "set": "cpp",
+        "string": "cpp",
+        "unordered_map": "cpp",
+        "vector": "cpp",
+        "exception": "cpp",
+        "algorithm": "cpp",
+        "functional": "cpp",
+        "iterator": "cpp",
+        "memory": "cpp",
+        "memory_resource": "cpp",
+        "numeric": "cpp",
+        "optional": "cpp",
+        "random": "cpp",
+        "ratio": "cpp",
+        "regex": "cpp",
+        "source_location": "cpp",
+        "string_view": "cpp",
+        "system_error": "cpp",
+        "tuple": "cpp",
+        "type_traits": "cpp",
+        "utility": "cpp",
+        "fstream": "cpp",
+        "initializer_list": "cpp",
+        "iomanip": "cpp",
+        "iosfwd": "cpp",
+        "iostream": "cpp",
+        "istream": "cpp",
+        "limits": "cpp",
+        "mutex": "cpp",
+        "new": "cpp",
+        "numbers": "cpp",
+        "ostream": "cpp",
+        "semaphore": "cpp",
+        "span": "cpp",
+        "sstream": "cpp",
+        "stdexcept": "cpp",
+        "stop_token": "cpp",
+        "streambuf": "cpp",
+        "cinttypes": "cpp",
+        "typeindex": "cpp",
+        "typeinfo": "cpp",
+        "variant": "cpp",
+        "format": "cpp",
+        "*.m": "cpp"
     }
 }

CMakeLists.txt

@@ -14,6 +14,38 @@ add_subdirectory(external/raylib)
 # -------------------------
 add_subdirectory(external/angelscript/sdk/angelscript/projects/cmake)
 
+# -------------------------
+# Dear ImGui (docking branch)
+# -------------------------
+# Ensure the submodule exists at external/imgui (added with git submodule)
+add_subdirectory(cmake/imgui)
+
+# -------------------------
+# rlImGui (optional - Raylib ImGui integration)
+# -------------------------
+# If you add rlImGui as a submodule under external/rlImGui, CMake will pick it up
+option(USE_RLIMGUI "Enable rlImGui integration if found in external/rlImGui" ON)
+set(RLIMGUI_ROOT "${CMAKE_SOURCE_DIR}/external/rlImGui")
+if(USE_RLIMGUI)
+    if(EXISTS "${RLIMGUI_ROOT}/CMakeLists.txt")
+        message(STATUS "rlImGui CMakeLists found at ${RLIMGUI_ROOT} - adding to build")
+        add_subdirectory(${RLIMGUI_ROOT} EXCLUDE_FROM_ALL)
+        set(HAVE_RLIMGUI TRUE)
+    elseif(EXISTS "${RLIMGUI_ROOT}")
+        message(STATUS "rlImGui sources found at ${RLIMGUI_ROOT} - using project wrapper cmake/rlImGui")
+        add_subdirectory(cmake/rlImGui)
+        set(HAVE_RLIMGUI TRUE)
+    else()
+        set(HAVE_RLIMGUI FALSE)
+    endif()
+else()
+    set(HAVE_RLIMGUI FALSE)
+endif()
+# -------------------------
+# Tests
+# -------------------------
+enable_testing()
+add_subdirectory(tests)
 # -------------------------
 # 3️⃣ scriptstdstring add-on
 # -------------------------
@@ -45,6 +77,7 @@ add_executable(simian
     src/ScriptEngine.cpp
     src/ScriptBindings.cpp
     src/HotReload.cpp
+    src/GuiManager.cpp
     src/log/log.c
 )
 
@@ -55,20 +88,32 @@ target_include_directories(simian PUBLIC
     external/angelscript/sdk/angelscript/include
     external/angelscript/sdk/add_on/scriptstdstring
     external/angelscript/sdk/add_on/scriptbuilder
+     external/imgui     
 )
 
-target_link_libraries(simian
+target_link_libraries(simian PRIVATE
     raylib
     angelscript
     scriptstdstring
     scriptbuilder
+    imgui
 )
 
+if(HAVE_RLIMGUI)
+    target_include_directories(simian PUBLIC ${RLIMGUI_ROOT}/include)
+    target_link_libraries(simian PRIVATE rlImGui)
+    # Expose HAVE_RLIMGUI to the C++ compiler so source can guard ImGui calls
+    target_compile_definitions(simian PRIVATE HAVE_RLIMGUI=1)
+    message(STATUS "Linking rlImGui into simian")
+else()
+    message(STATUS "rlImGui not found - building without rlImGui integration")
+endif()
+
 # -------------------------
 # 5️⃣ Platform-specific linking
 # -------------------------
 if(WIN32)
-    target_link_libraries(simian winmm gdi32)
+    target_link_libraries(simian PRIVATE winmm gdi32)
 elseif(UNIX)
     # Linux / macOS: Raylib handles system libs automatically
 endif()

Justfile

@@ -0,0 +1,76 @@
+# Justfile for Simian project
+# Usage: just <recipe>
+
+# Default configuration
+set shell := ["powershell", "-Command"]
+
+# Variables
+BUILD_DIR := "build"
+CMAKE_CONFIG := "Release"
+CMAKE_GENERATOR := "Visual Studio 17 2022"
+CMAKE_ARCH := "x64"
+
+# Initialize and update submodules
+submodules:
+    @echo "Updating submodules..."
+    git submodule update --init --recursive
+
+# Configure the project (out-of-source)
+configure:
+    @echo "Configuring CMake (generator: {{CMAKE_GENERATOR}}, arch: {{CMAKE_ARCH}})"
+    cmake -G "{{CMAKE_GENERATOR}}" -A {{CMAKE_ARCH}} -S . -B {{BUILD_DIR}}
+
+# Configure for Debug
+configure-debug:
+    @echo "Configuring Debug"
+    cmake -G "{{CMAKE_GENERATOR}}" -A {{CMAKE_ARCH}} -S . -B {{BUILD_DIR}} -DCMAKE_BUILD_TYPE=Debug
+
+# Build (Release by default)
+build:
+    @echo "Building (config: {{CMAKE_CONFIG}})"
+    cmake --build {{BUILD_DIR}} --config {{CMAKE_CONFIG}}
+
+# Build Debug
+build-debug:
+    @echo "Building Debug"
+    cmake --build {{BUILD_DIR}} --config Debug
+
+# Run the built executable (defaults to Debug for development)
+run:
+    @echo "Running simian (Release)..."
+    {{BUILD_DIR}}\Release\simian.exe
+
+# Run Debug build
+run-debug:
+    @echo "Running simian (Debug)..."
+    {{BUILD_DIR}}\Debug\simian.exe
+
+# Run Release build
+run-release:
+    @echo "Running simian (Release)..."
+    {{BUILD_DIR}}\Release\simian.exe
+
+# Clean build folder
+clean:
+    @echo "Removing {{BUILD_DIR}} folder"
+    Remove-Item -Recurse -Force {{BUILD_DIR}} -ErrorAction SilentlyContinue
+
+# Reconfigure, build and run (convenience)
+rebuild-run: submodules configure build run
+
+# Lint / formatting (placeholder)
+format:
+    @echo "No formatter configured. Add commands here."
+
+# Tests (placeholder - uses CTest if configured)
+test:
+    @echo "Running tests (if configured)"
+    cmake --build {{BUILD_DIR}} --config {{CMAKE_CONFIG}} --target RUN_TESTS
+
+# Provide a help recipe
+help:
+    @echo "Available recipes: submodules, configure, configure-debug, build, build-debug, run, clean, rebuild-run, format, test"
+
+# Notes for non-Windows shells
+# If you're running on Git Bash or WSL, set shell and generator accordingly, e.g.:
+# just -s --shell "bash -lc" configure

README.md

@@ -1,200 +1,130 @@
-# Simian
+## Simian
 
-**Simian** is a Raylib + AngelScript test project on Windows and Linux.  
-It demonstrates how to integrate **Raylib** for graphics and **AngelScript** for scripting, including the `scriptstdstring` add-on.
+Simian is a small Raylib + AngelScript test project, refactored to be easy to extend and to show a safe hot-reload workflow for AngelScript.
 
-## Refactored Architecture
+This README was updated to reflect the current layout, build paths, and the small CMake wrapper approach used to optionally build ImGui / rlImGui when those folders are present.
 
-The project has been refactored from a single `main.cpp` file into a more maintainable modular structure:
+## What changed
 
-### Core Components
-- **Application** (`Application.h/cpp`) - Main application lifecycle and game loop
-- **ScriptEngine** (`ScriptEngine.h/cpp`) - AngelScript engine management and script compilation
-- **ScriptBindings** (`ScriptBindings.h/cpp`) - C++ to AngelScript function bindings
-- **HotReload** (`HotReload.h/cpp`) - File monitoring for automatic script reloading
-- **main.cpp** - Minimal entry point
+- The original single-file demo was split into modules: Application, ScriptEngine, ScriptBindings and HotReload.
+- Hot-reloads are performed safely: scripts compile into a temporary module first and only replace the running module on successful compilation. Compilation errors will no longer crash the running app.
+- CMake wrappers live in `cmake/` to build third-party projects that don't ship a CMakeLists.txt (example: ImGui, rlImGui). This keeps submodules untouched.
+- A `Justfile` was added with convenient recipes for configure, build, run and cleaning.
 
-### Directory Structure
-```
-Simian/
-├─ include/             # Header files
-│  ├─ Application.h
-│  ├─ ScriptEngine.h
-│  ├─ ScriptBindings.h
-│  └─ HotReload.h
-├─ src/                 # Source files
-│  ├─ Application.cpp
-│  ├─ ScriptEngine.cpp
-│  ├─ ScriptBindings.cpp
-│  └─ HotReload.cpp
-├─ external/            # Dependencies
-├─ scripts/             # AngelScript files
-├─ main.cpp             # Entry point
-└─ CMakeLists.txt       # Build configuration
-```
+## Quick start (Windows)
 
----
+Open a developer prompt for Visual Studio or use PowerShell / cmd configured for MSVC.
 
-## Requirements
+Clone with submodules:
 
-### Windows
-- Windows 10/11 (tested)
-- [Visual Studio 2022](https://visualstudio.microsoft.com/) with **Desktop development with C++** workload
-- [CMake 3.25+](https://cmake.org/download/)
-- Git
-- Optional: VSCode for editing
-
-### Linux
-- Ubuntu 20.04+ or equivalent Linux distribution
-- GCC 9+ or Clang 10+
-- [CMake 3.25+](https://cmake.org/download/)
-- Git
-- Development libraries: `sudo apt install build-essential cmake git`
-
----
-
-## Getting Started
-
-### 1. Clone the repository with submodules
-
-```bash
-git clone --recurse-submodules <your-repo-url>
+```powershell
+git clone --recurse-submodules <repo-url>
 cd Simian
 ```
 
-If you forgot `--recurse-submodules`, run:
+Using the included `Justfile` (optional):
 
-```bash
-git submodule update --init --recursive
+```powershell
+# from project root
+just configure       # runs cmake -S . -B build -G "Visual Studio 17 2022" -A x64
+just build           # builds Debug by default (uses cmake --build)
+just run             # runs the built executable (Debug)
 ```
 
-This will pull **Raylib** and **AngelScript** into `external/`.
+Or use raw CMake commands:
 
----
-
-### 2. Build with CMake
-
-#### Windows (Visual Studio)
-
-```bash
-# Create build folder
-mkdir build
-cd build
-
-# Generate Visual Studio solution (64-bit)
+```powershell
+mkdir build; cd build
 cmake -G "Visual Studio 17 2022" -A x64 ..
-
-# Build Release version
 cmake --build . --config Release
-```
-
-After building, the executable will be at:
-
-```
+# run:
 build\Release\simian.exe
 ```
 
-#### Linux (Unix Makefiles)
+If you are using cmd.exe, the same commands apply (adjust quotes for generator if needed).
+
+## Linux / Unix
 
 ```bash
-# Create build folder
-mkdir build
-cd build
-
-# Generate Unix Makefiles
+git clone --recurse-submodules <repo-url>
+cd Simian
+mkdir build && cd build
 cmake -G "Unix Makefiles" ..
-
-# Build
 cmake --build .
+./simian
 ```
 
-After building, the executable will be at:
-
-```
-build/simian
-```
-
----
-
-### 3. Run the project
-
-#### Windows
-```bash
-build\Release\simian.exe
-```
-
-#### Linux
-```bash
-./build/simian
-```
-
-You should see a **Raylib window** open and the console will output:
-
-```
-[Script] Hello from AngelScript!
-```
-
----
-
-## Project Structure
+## Project layout (important files)
 
 ```
 Simian/
-├─ external/
-│  ├─ raylib/           # Git submodule
-│  └─ angelscript/      # Git submodule (includes scriptstdstring add-on)
-├─ scripts/             # Optional: .as scripts to be loaded at runtime
-├─ main.cpp             # Entry point (Raylib + AngelScript)
-├─ CMakeLists.txt       # Build configuration
-└─ README.md
+├─ CMakeLists.txt            # top level CMake
+├─ Justfile                  # convenience tasks (configure/build/run/clean)
+├─ include/                  # public headers (Application, ScriptEngine, ScriptBindings, HotReload)
+├─ src/                      # implementation
+├─ scripts/                  # AngelScript source files loaded at runtime
+├─ external/                 # git submodules (raylib, angelscript, optional imgui/rlImGui)
+└─ cmake/                    # local CMake wrappers (imgui, rlImGui)
 ```
 
----
+## Hot-reload notes
+
+- The app watches `scripts/` for changes. When a script is updated it is compiled into a temporary AngelScript module.
+- If compilation succeeds, the temp module replaces the live `main` module and new functions are used. If compilation fails, the running module is left intact and a single-line error is shown on-screen.
+- This avoids crashes that happen when a script with compilation errors would otherwise replace/break function pointers while the engine is executing.
+
+## ImGui / rlImGui (optional)
+
+The repository prefers to keep upstream code as submodules. Some upstream projects (like certain ImGui tags or rlImGui) don't provide a CMakeLists.txt. To support those without editing submodules, the project includes small wrappers in `cmake/`:
+
+- `cmake/imgui/` builds ImGui core (and optionally backends) when `external/imgui` is present.
+- `cmake/rlImGui/` builds the rlImGui integration and links it to the `imgui` target if available.
+
+If you prefer to use the upstream CMake (when present), the top-level `CMakeLists.txt` will prefer `external/rlImGui`'s CMake if it detects one; otherwise it falls back to the wrapper.
+
+To add ImGui/rlImGui as submodules:
+
+```powershell
+# from repo root
+git submodule add https://github.com/ocornut/imgui.git external/imgui
+git submodule add https://github.com/NeoSpark314/rlImGui.git external/rlImGui
+git submodule update --init --recursive
+```
+
+Then re-run CMake from a clean build directory.
+
+Troubleshooting: if Git warns about "embedded git repository" when adding files, convert the folder to a submodule (remove cached tracked files, then add as submodule) — this README intentionally avoids modifying submodule contents.
+
+## Tests / Verification
+
+Quick smoke test after building:
+
+```powershell
+# run the Debug build
+build\Debug\simian.exe
+```
+
+You should see the Raylib window. The running console prints from script when the default script executes (e.g. "[Script] Hello from AngelScript!").
+
+If a script has a compilation error, the app will continue running and a brief error message is presented on the top-left of the window.
+
+## Updating submodules
+
+Keep submodules pinned for reproducible builds. To update them safely:
+
+```powershell
+cd external/raylib && git fetch && git checkout <commit-or-branch>
+cd ../angelscript && git fetch && git checkout <commit-or-branch>
+cd ../.. && git add external/raylib external/angelscript && git commit -m "Update submodules"
+```
 
 ## Notes
 
-* **AngelScript `string` support** is enabled via `scriptstdstring` add-on.
-* **Hot-reloading scripts** can be implemented by loading `.as` files from the `scripts/` folder.
-* Update submodules with:
-
-```bash
-cd external/raylib
-git pull origin master
-cd ../angelscript
-git pull origin master
-cd ../..
-git add external/raylib external/angelscript
-git commit -m "Update submodules"
-```
-
----
-
-## CMake Targets
-
-* `simian` — main executable
-* `raylib` — static library submodule
-* `angelscript` — static library submodule
-* `scriptstdstring` — static library add-on for AngelScript
-
----
-
-## Tips
-
-#### Windows
-* Always use **VS2022 Developer Command Prompt** or VSCode terminal configured for MSVC.
-
-#### Linux
-* Make sure you have the required development packages installed.
-* On some distributions you may need additional X11 development libraries.
-
-#### General
-* Pin submodules to specific commits for reproducible builds.
-* To clean build: delete the `build/` folder and regenerate with CMake.
-
----
+- The project was developed and tested on Windows with Visual Studio; Linux builds are supported but may need X11 / audio dev packages installed depending on your environment.
+- The codebase avoids changing tracked submodule contents; use the `cmake/` wrappers when a submodule doesn't include a CMake build.
 
 ## License
 
-* Raylib: [Zlib License](https://github.com/raysan5/raylib#license)
-* AngelScript: [MIT License](https://github.com/angelcode/angelscript/blob/master/license.txt)
-* Simian: Not open source (Yet)
+* Raylib: Zlib License (see https://github.com/raysan5/raylib#license)
+* AngelScript: MIT License (see https://github.com/angelcode/angelscript/blob/master/license.txt)
+* Simian: Not open source (yet)

cmake/imgui/CMakeLists.txt

@@ -0,0 +1,63 @@
+cmake_minimum_required(VERSION 3.10)
+project(imgui_wrapper NONE)
+
+# Root of the imgui submodule (expected to live at external/imgui)
+set(IMGUI_ROOT "${CMAKE_SOURCE_DIR}/external/imgui")
+
+if(NOT EXISTS "${IMGUI_ROOT}/imgui.h")
+    message(FATAL_ERROR "ImGui not found in ${IMGUI_ROOT}. Run: git submodule update --init --recursive")
+endif()
+
+# Options: build demo and/or backends. By default we only build the core library which
+# avoids pulling in platform deps (SDL/Android/etc) from the backends and examples.
+option(IMGUI_BUILD_DEMO "Include imgui_demo.cpp in the build" OFF)
+option(IMGUI_BUILD_BACKENDS "Include selected backend implementations from backends/" OFF)
+
+# Core sources (explicit list - avoids accidentally including examples)
+set(IMGUI_CORE_SRC
+    "${IMGUI_ROOT}/imgui.cpp"
+    "${IMGUI_ROOT}/imgui_draw.cpp"
+    "${IMGUI_ROOT}/imgui_tables.cpp"
+    "${IMGUI_ROOT}/imgui_widgets.cpp"
+)
+
+if(IMGUI_BUILD_DEMO)
+    list(APPEND IMGUI_CORE_SRC "${IMGUI_ROOT}/imgui_demo.cpp")
+endif()
+
+add_library(imgui STATIC ${IMGUI_CORE_SRC})
+
+target_include_directories(imgui PUBLIC
+    ${IMGUI_ROOT}
+)
+
+# Optionally include a small, safe set of backends (desktop common ones) when requested.
+if(IMGUI_BUILD_BACKENDS)
+    # Gather backend sources and whitelist a few common desktop backends
+    file(GLOB IMGUI_BACKEND_SRCS "${IMGUI_ROOT}/backends/*.cpp")
+
+    set(IMGUI_BACKEND_WHITELIST
+        "imgui_impl_glfw.cpp"
+        "imgui_impl_opengl3.cpp"
+        "imgui_impl_win32.cpp"
+        "imgui_impl_sdl2.cpp"
+    )
+
+    set(IMGUI_SELECTED_BACKENDS)
+    foreach(_f IN LISTS IMGUI_BACKEND_SRCS)
+        get_filename_component(_name ${_f} NAME)
+        foreach(_allowed IN LISTS IMGUI_BACKEND_WHITELIST)
+            if(_name STREQUAL _allowed)
+                list(APPEND IMGUI_SELECTED_BACKENDS ${_f})
+            endif()
+        endforeach()
+    endforeach()
+
+    if(IMGUI_SELECTED_BACKENDS)
+        target_sources(imgui PRIVATE ${IMGUI_SELECTED_BACKENDS})
+        target_include_directories(imgui PUBLIC "${IMGUI_ROOT}/backends")
+    endif()
+endif()
+
+# Build position independent code to make static lib usable in shared contexts
+set_target_properties(imgui PROPERTIES POSITION_INDEPENDENT_CODE ON)

cmake/rlImGui/CMakeLists.txt

@@ -0,0 +1,51 @@
+cmake_minimum_required(VERSION 3.10)
+project(rlImGui_wrapper NONE)
+
+# Path to the rlImGui sources (submodule should be under external/rlImGui)
+set(RLIMGUI_ROOT "${CMAKE_SOURCE_DIR}/external/rlImGui")
+
+if(NOT EXISTS "${RLIMGUI_ROOT}/README.md")
+    message(FATAL_ERROR "rlImGui not found in ${RLIMGUI_ROOT}. Add it as a submodule: git submodule add <url> external/rlImGui")
+endif()
+
+# Collect sources - rlImGui has sources under src/ and maybe example/backends
+
+# Look for sources either under src/ or at the project root
+file(GLOB RLIMGUI_ROOT_SRCS "${RLIMGUI_ROOT}/*.c" "${RLIMGUI_ROOT}/*.cpp")
+file(GLOB RLIMGUI_SRC_DIR_SRCS "${RLIMGUI_ROOT}/src/*.c" "${RLIMGUI_ROOT}/src/*.cpp")
+
+set(RLIMGUI_SOURCES ${RLIMGUI_ROOT_SRCS} ${RLIMGUI_SRC_DIR_SRCS})
+
+# Exclude examples/tests if present
+list(FILTER RLIMGUI_SOURCES EXCLUDE REGEX ".*example.*|.*test.*")
+
+if(RLIMGUI_SOURCES)
+    add_library(rlImGui STATIC ${RLIMGUI_SOURCES})
+
+    # Add includes: rlImGui root and src if present
+    target_include_directories(rlImGui PUBLIC
+        ${RLIMGUI_ROOT}
+        ${RLIMGUI_ROOT}/src
+    )
+
+    # Ensure ImGui's headers are available (imgui submodule expected at external/imgui)
+    set(IMGUI_ROOT "${CMAKE_SOURCE_DIR}/external/imgui")
+    if(EXISTS "${IMGUI_ROOT}/imgui.h")
+        target_include_directories(rlImGui PUBLIC ${IMGUI_ROOT})
+    endif()
+
+    # If the imgui target exists (from cmake/imgui wrapper), link it so we reuse the same lib
+    if(TARGET imgui)
+        target_link_libraries(rlImGui PRIVATE imgui)
+    endif()
+else()
+    message(FATAL_ERROR "No rlImGui sources found under ${RLIMGUI_ROOT}. Expected rlImGui.cpp or src/*.cpp")
+endif()
+
+# Provide a property so consumers can check availability
+set_target_properties(rlImGui PROPERTIES EXPORT_NAME rlImGui)
+
+# Try to link to raylib if available in the parent project
+if(TARGET raylib)
+    target_link_libraries(rlImGui PRIVATE raylib)
+endif()

imgui.ini

@@ -0,0 +1,78 @@
+[Window][Debug##Default]
+Pos=60,60
+Size=400,400
+Collapsed=0
+
+[Window][Simian ImGui Demo]
+Pos=141,224
+Size=516,224
+Collapsed=0
+
+[Window][DockSpaceHost]
+Pos=0,0
+Size=1280,720
+Collapsed=0
+
+[Window][Left Panel]
+Pos=292,567
+Size=980,145
+Collapsed=0
+DockId=0x00000002,0
+
+[Window][Right Panel]
+Pos=8,27
+Size=282,685
+Collapsed=0
+DockId=0x00000003,0
+
+[Window][##TOAST2]
+Pos=548,314
+Size=232,82
+Collapsed=0
+
+[Window][##TOAST1]
+Pos=548,406
+Size=232,82
+Collapsed=0
+
+[Window][##TOAST0]
+Pos=548,498
+Size=232,82
+Collapsed=0
+
+[Window][##TOAST4]
+Pos=548,130
+Size=232,82
+Collapsed=0
+
+[Window][##TOAST3]
+Pos=548,222
+Size=232,82
+Collapsed=0
+
+[Window][##TOAST5]
+Pos=548,38
+Size=232,82
+Collapsed=0
+
+[Window][Log Viewer]
+Pos=8,580
+Size=1264,132
+Collapsed=0
+DockId=0x00000006,0
+
+[Window][Game Window]
+Pos=8,27
+Size=1264,551
+Collapsed=0
+DockId=0x00000001,0
+
+[Docking][Data]
+DockSpace       ID=0x9076BACA Window=0x34F970D7 Pos=8,27 Size=1264,685 Split=Y Selected=0x6D1308E5
+  DockNode      ID=0x00000005 Parent=0x9076BACA SizeRef=1264,551 Split=X
+    DockNode    ID=0x00000003 Parent=0x00000005 SizeRef=282,685 Selected=0x6D1308E5
+    DockNode    ID=0x00000004 Parent=0x00000005 SizeRef=980,685 Split=Y
+      DockNode  ID=0x00000001 Parent=0x00000004 SizeRef=1264,538 CentralNode=1 Selected=0x27A02DAA
+      DockNode  ID=0x00000002 Parent=0x00000004 SizeRef=1264,145 Selected=0x995FC207
+  DockNode      ID=0x00000006 Parent=0x9076BACA SizeRef=1264,132 Selected=0xBEDDA0C1
+

include/Application.h

@@ -1,13 +1,15 @@
 #pragma once
 #include "ScriptEngine.h"
 #include "HotReload.h"
+#include "GuiManager.h"
+#include "raylib.h"
 
 class Application {
 public:
     Application();
     ~Application();
 
-    bool Initialize();
+    bool Initialize(int argc, char* argv[]);
     void Run();
     void Shutdown();
 
@@ -16,9 +18,12 @@ private:
     HotReload* hotReload;
     bool scriptCompilationError;
     FILE* logFile;
+    GuiManager guiManager;
+    bool enableEditor;
+    RenderTexture2D renderTexture; // Declare renderTexture for Raylib rendering
     
-    static const int WINDOW_WIDTH = 800;
-    static const int WINDOW_HEIGHT = 600;
+    static const int WINDOW_WIDTH = 1280;
+    static const int WINDOW_HEIGHT = 720;
     static const int TARGET_FPS = 60;
     static const char* WINDOW_TITLE;
     static const char* SCRIPT_FILE;

include/GuiManager.h

@@ -0,0 +1,20 @@
+#pragma once
+#include "rlImGui.h"
+#include "imgui.h"
+#include "extras/IconsFontAwesome6.h"
+#include "gui/fa-solid-900.h"
+#include "gui/ImGuiNotify.hpp"
+
+class GuiManager {
+public:
+    GuiManager();
+    ~GuiManager();
+
+    void Initialize();
+    void Render(RenderTexture2D& renderTexture);
+    void Shutdown();
+
+private:
+    void SetupDockspace(RenderTexture2D& renderTexture);
+    void RenderNotifications();
+};

include/ScriptEngine.h

@@ -2,6 +2,7 @@
 #include "angelscript.h"
 #include "scriptbuilder.h"
 #include <string>
+#include <vector>
 
 class ScriptEngine {
 public:
@@ -13,6 +14,14 @@ public:
     bool CompileScript(const std::string& filename);
     void CallScriptFunction(asIScriptFunction* func, float dt = 0.0f);
     void GarbageCollect();
+    
+    // Add a path used to resolve #include directives in scripts
+    void AddIncludePath(const std::string& path);
+
+    // Try to preserve script state across hot-reloads by calling optional
+    // __SerializeState()/__DeserializeState() hooks in the script module.
+    std::string CaptureScriptState();
+    void RestoreScriptState(const std::string &state);
 
     asIScriptEngine* GetEngine() const { return engine; }
     asIScriptFunction* GetUpdateFunction() const { return updateFunc; }
@@ -24,6 +33,7 @@ private:
     asIScriptFunction* drawFunc;
     asIScriptModule* currentModule;
     bool hasValidScript;
+    std::vector<std::string> includePaths;
 
     static void MessageCallback(const asSMessageInfo* msg, void* param);
     static int IncludeCallback(const char* include, const char* from, CScriptBuilder* builder, void* userParam);

main.cpp

@@ -1,10 +1,10 @@
 #include "Application.h"
 #include "src/log/log.h"
 
-int main() {
+int main(int argc, char* argv[]) {
     Application app;
     
-    if (!app.Initialize()) {
+    if (!app.Initialize(argc, argv)) {
         log_error("Failed to initialize application");
         return -1;
     }
@@ -13,4 +13,4 @@ int main() {
     app.Shutdown();
     
     return 0;
-}
+}

scripts/as.predefined

@@ -0,0 +1,11 @@
+
+typedef void string;
+void Print(const string &in);
+void Log(int level, const string &in);
+void DrawText(const string &in, int x, int y, int fontSize, int color);
+int LOG_TRACE;
+int LOG_DEBUG;
+int LOG_INFO;
+int LOG_WARN;
+int LOG_ERROR;
+int LOG_FATAL;

scripts/update.as

@@ -2,12 +2,10 @@ float x = 50;
 float y = 100;
 
 void Update(float dt) {
-    x += 500 * dt;
+    x += 50 * dt;
     if (x > 800) {
         x = 0;
         Print("X position reset!");
         Log(LOG_INFO, "Log INFO: reset happened");
-        Log(LOG_WARNING, "Log WARNING: reset happened");
-        Log(LOG_ERROR, "Log ERROR: reset happened");
     }
-}//
+}

src/Application.cpp

@@ -2,29 +2,67 @@
 #include "raylib.h"
 #include <chrono>
 #include <thread>
+#include <cstring>
 #include <filesystem>
 #include "log/log.h"
-const char* Application::WINDOW_TITLE = "Raylib + AngelScript";
-const char* Application::SCRIPT_FILE = "scripts/test.as";
 
-Application::Application() : hotReload(nullptr), scriptCompilationError(false), logFile(nullptr) {
+#include "rlImGui.h"
+#include "imgui.h"
+#include "extras/IconsFontAwesome6.h"
+#include "gui/ImGuiNotify.hpp"
+#include "GuiManager.h"
+
+#ifdef _WIN32
+// On Windows, fopen_s is already available, so no need to define it.
+#else
+// On non-Windows platforms, define fopen_s as a macro for fopen.
+#define fopen_s(pFile, filename, mode) ((*(pFile) = fopen((filename), (mode))) == NULL)
+#endif
+const char *Application::WINDOW_TITLE = "Simian";
+const char *Application::SCRIPT_FILE = "scripts/test.as";
+
+Application::Application() : hotReload(nullptr), scriptCompilationError(false), logFile(nullptr), renderTexture{} // Initialize renderTexture
+{
 }
 
-Application::~Application() {
-    Shutdown();
+Application::~Application()
+{
+    // Reminder in case the change main.cpp, but we do not want to close the
+    // window more than once
+    // Shutdown();
 }
 
-bool Application::Initialize() {
-    logFile = fopen("log.txt", "w");
-    log_add_fp(logFile, LOG_TRACE);
+bool Application::Initialize(int argc, char *argv[])
+{
+    if (fopen_s(&logFile, "log.txt", "w") != 0)
+    {
+        logFile = nullptr;
+        log_error("Failed to open log file");
+    }
+    else
+    {
+        log_add_fp(logFile, LOG_TRACE);
+    }
 
     SetTraceLogCallback(raylib_log);
+
+    enableEditor = false;
+
+    // Parse command-line arguments
+    for (int i = 1; i < argc; ++i)
+    {
+        if (std::strcmp(argv[i], "--editor") == 0)
+        {
+            enableEditor = true;
+        }
+    }
     // Initialize Raylib
     InitWindow(WINDOW_WIDTH, WINDOW_HEIGHT, WINDOW_TITLE);
     SetTargetFPS(TARGET_FPS);
 
     // Initialize AngelScript
-    if (!scriptEngine.Initialize()) {
+    if (!scriptEngine.Initialize())
+    {
         log_error("Failed to initialize script engine");
         return false;
     }
@@ -34,34 +72,49 @@ bool Application::Initialize() {
     {
         std::filesystem::path p(SCRIPT_FILE);
         std::string watchPath = p.parent_path().string();
-        if (watchPath.empty()) watchPath = ".";
+        if (watchPath.empty())
+            watchPath = ".";
         hotReload = new HotReload(watchPath);
     }
 
     // Compile initial script
     scriptCompilationError = !scriptEngine.CompileScript(SCRIPT_FILE);
 
+    if (enableEditor)
+    {
+
+        guiManager.Initialize();
+
+        renderTexture = LoadRenderTexture(WINDOW_WIDTH, WINDOW_HEIGHT);
+    }
+
     return true;
 }
 
-void Application::Run() {
-    while (!WindowShouldClose()) {
+void Application::Run()
+{
+
+    while (!WindowShouldClose())
+    {
         float deltaTime = GetFrameTime();
-        
+
         Update(deltaTime);
         Draw();
-        
+
         // Small sleep to prevent excessive CPU usage
         std::this_thread::sleep_for(std::chrono::milliseconds(10));
     }
 }
 
-void Application::Update(float deltaTime) {
+void Application::Update(float deltaTime)
+{
     // Check for hot reload
-    if (hotReload && hotReload->CheckForChanges()) {
+    if (hotReload && hotReload->CheckForChanges())
+    {
         bool success = scriptEngine.CompileScript(SCRIPT_FILE);
         scriptCompilationError = !success;
-        if (!success) {
+        if (!success)
+        {
             log_warn("Script compilation failed - keeping previous version");
         }
     }
@@ -70,35 +123,89 @@ void Application::Update(float deltaTime) {
     scriptEngine.CallScriptFunction(scriptEngine.GetUpdateFunction(), deltaTime);
 }
 
-void Application::Draw() {
-    BeginDrawing();
-    ClearBackground(RAYWHITE);
+void Application::Draw()
+{
+    if (enableEditor)
+    {
+        int screenWidth = GetScreenWidth();
+        int screenHeight = GetScreenHeight();
 
-    // Show script error status in top left if there's an error, otherwise show normal message
-    if (scriptCompilationError) {
-        DrawText("SCRIPT ERROR - Check console for details", 10, 10, 16, RED);
+        // Fallback to default values if screen dimensions are invalid
+        if (screenWidth <= 0 || screenHeight <= 0)
+        {
+            log_warn("Invalid screen dimensions: %d x %d. Using default values.", screenWidth, screenHeight);
+            screenWidth = 800;
+            screenHeight = 600;
+        }
+
+        ImGuiIO &io = ImGui::GetIO();
+        io.DisplaySize = ImVec2((float)screenWidth, (float)screenHeight); // Set DisplaySize
+
+        BeginTextureMode(renderTexture);
+        ClearBackground(RAYWHITE);
+
+        // Show script error status in top left if there's an error, otherwise show normal message
+        if (scriptCompilationError)
+        {
+            DrawText("SCRIPT ERROR - Check console for details", 10, 10, 16, RED);
+        }
+
+        // Call script Draw function
+        scriptEngine.CallScriptFunction(scriptEngine.GetDrawFunction());
+
+        EndTextureMode();
+        BeginDrawing();
+        ClearBackground(RAYWHITE);
+
+        guiManager.Render(renderTexture); // Render the GUI
+
+        EndDrawing();
     }
+    else
+    {
+        BeginDrawing();
+        ClearBackground(RAYWHITE);
 
-    // Call script Draw function
-    scriptEngine.CallScriptFunction(scriptEngine.GetDrawFunction());
+        // Show script error status in top left if there's an error, otherwise show normal message
+        if (scriptCompilationError)
+        {
+            DrawText("SCRIPT ERROR - Check console for details", 10, 10, 16, RED);
+        }
 
-    EndDrawing();
+        // Call script Draw function
+        scriptEngine.CallScriptFunction(scriptEngine.GetDrawFunction());
+
+        EndDrawing();
+    }
 }
 
-void Application::Shutdown() {
-    if (hotReload) {
+void Application::Shutdown()
+{
+    if (hotReload)
+    {
         delete hotReload;
         hotReload = nullptr;
     }
-    
+
     scriptEngine.Shutdown();
-    
+    if (enableEditor)
+    {
+        guiManager.Shutdown();
+    }
+
+    // Shutdown rlImGui first while the GL context and window are still valid
+    rlImGuiShutdown();
+
+    // Shutdown script engine
+    scriptEngine.Shutdown();
+
     // Clear the trace log callback before closing window to prevent logging after cleanup
     SetTraceLogCallback(nullptr);
     CloseWindow();
-    
+
     // Close log file after everything else is cleaned up
-    if (logFile) {
+    if (logFile)
+    {
         fclose(logFile);
         logFile = nullptr;
     }

src/GuiManager.cpp

@@ -0,0 +1,122 @@
+#include "GuiManager.h"
+#include "raylib.h"
+#include <fstream> // Add this to fix the incomplete type error
+#include <string>
+#include <iostream>
+#include "log.h"
+GuiManager::GuiManager() {}
+
+GuiManager::~GuiManager() {}
+
+void GuiManager::Initialize()
+{
+    rlImGuiSetup(true);
+    ImGuiIO &io = ImGui::GetIO();
+    io.ConfigFlags |= ImGuiConfigFlags_DockingEnable;
+    io.ConfigFlags |= ImGuiConfigFlags_ViewportsEnable;
+    io.Fonts->AddFontDefault();
+
+    float baseFontSize = 16.0f;
+    float iconFontSize = baseFontSize * 2.0f / 3.0f;
+
+    static constexpr ImWchar iconsRanges[] = {ICON_MIN_FA, ICON_MAX_16_FA, 0};
+    ImFontConfig iconsConfig;
+    iconsConfig.MergeMode = true;
+    iconsConfig.PixelSnapH = true;
+    iconsConfig.GlyphMinAdvanceX = iconFontSize;
+    io.Fonts->AddFontFromMemoryCompressedTTF(fa_solid_900_compressed_data, fa_solid_900_compressed_size, iconFontSize, &iconsConfig, iconsRanges);
+    log_trace("GuiManager::Initialize - Started");
+}
+
+void GuiManager::Render(RenderTexture2D &renderTexture)
+{
+    rlImGuiBegin();
+    SetupDockspace(renderTexture); // Pass the renderTexture parameter
+    RenderNotifications();
+    rlImGuiEnd();
+
+    ImGui::UpdatePlatformWindows();
+    ImGui::RenderPlatformWindowsDefault();
+}
+
+void GuiManager::Shutdown()
+{
+    rlImGuiShutdown();
+}
+
+void GuiManager::SetupDockspace(RenderTexture2D &renderTexture)
+{
+    static bool dockspaceOpen = true;
+    static bool opt_fullscreen = true;
+    static ImGuiDockNodeFlags dockspace_flags = ImGuiDockNodeFlags_None;
+
+    ImGuiWindowFlags window_flags = ImGuiWindowFlags_MenuBar | ImGuiWindowFlags_NoDocking;
+    if (opt_fullscreen)
+    {
+        ImGuiViewport *viewport = ImGui::GetMainViewport();
+        ImGui::SetNextWindowPos(viewport->WorkPos);
+        ImGui::SetNextWindowSize(viewport->WorkSize);
+        ImGui::SetNextWindowViewport(viewport->ID);
+        ImGui::PushStyleVar(ImGuiStyleVar_WindowRounding, 0.0f);
+        ImGui::PushStyleVar(ImGuiStyleVar_WindowBorderSize, 0.0f);
+        window_flags |= ImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_NoResize | ImGuiWindowFlags_NoMove;
+        window_flags |= ImGuiWindowFlags_NoBringToFrontOnFocus | ImGuiWindowFlags_NoNavFocus;
+    }
+
+    ImGui::Begin("DockSpaceHost", &dockspaceOpen, window_flags);
+    if (opt_fullscreen)
+        ImGui::PopStyleVar(2);
+
+    ImGuiID dockspace_id = ImGui::GetID("MyDockSpace");
+    ImGui::DockSpace(dockspace_id, ImVec2(0.0f, 0.0f), dockspace_flags);
+
+    // Add a Game Window
+    ImGui::Begin("Game Window");
+
+    // Render Raylib content to the Game Window
+    rlImGuiImageRenderTexture(&renderTexture);
+
+    ImGui::End();
+
+    // Log Viewer Window
+    ImGui::Begin("Log Viewer");
+    static std::string logContent;
+    static size_t lastFileSize = 0;
+
+    // Read the log file if it has changed
+    std::ifstream logFile("log.txt", std::ios::ate); // Open at the end to get the file size
+    if (logFile.is_open())
+    {
+        size_t fileSize = logFile.tellg();
+        if (fileSize != lastFileSize)
+        {
+            lastFileSize = fileSize;
+            logFile.seekg(0, std::ios::beg); // Go back to the beginning
+            logContent.assign((std::istreambuf_iterator<char>(logFile)),
+                              std::istreambuf_iterator<char>());
+        }
+        logFile.close();
+    }
+
+    // Display the log content in a scrollable text area
+    ImGui::BeginChild("LogText", ImVec2(0, 0), true, ImGuiWindowFlags_HorizontalScrollbar);
+    ImGui::TextUnformatted(logContent.c_str());
+    if (ImGui::GetScrollY() >= ImGui::GetScrollMaxY())
+        ImGui::SetScrollHereY(1.0f); // Auto-scroll to the bottom
+    ImGui::EndChild();
+    ImGui::End();
+
+    ImGui::End();
+}
+
+void GuiManager::RenderNotifications()
+{
+    ImGui::PushStyleVar(ImGuiStyleVar_WindowRounding, 0.f);
+    ImGui::PushStyleVar(ImGuiStyleVar_WindowBorderSize, 0.f);
+    ImGui::PushStyleColor(ImGuiCol_WindowBg, ImVec4(0.10f, 0.10f, 0.10f, 1.00f));
+
+    ImGui::RenderNotifications();
+
+    ImGui::PopStyleVar(2);
+    ImGui::PopStyleColor(1);
+}

src/ScriptEngine.cpp

@@ -8,6 +8,9 @@
 #include <assert.h>
 #include "log/log.h"
 
+#include <vector>
+#include <mutex>
+
 ScriptEngine::ScriptEngine() : engine(nullptr), updateFunc(nullptr), drawFunc(nullptr), currentModule(nullptr), hasValidScript(false) {
 }
 
@@ -38,6 +41,55 @@ bool ScriptEngine::Initialize() {
     return true;
 }
 
+void ScriptEngine::AddIncludePath(const std::string& path) {
+    // thread-safe append
+    static std::mutex m;
+    std::lock_guard<std::mutex> lock(m);
+    includePaths.push_back(path);
+}
+
+std::string ScriptEngine::CaptureScriptState() {
+    if (!currentModule || !engine) return std::string();
+    asIScriptFunction* ser = currentModule->GetFunctionByDecl("string __SerializeState()");
+    if (!ser) return std::string();
+
+    asIScriptContext* ctx = engine->CreateContext();
+    if (ctx->Prepare(ser) < 0) { ctx->Release(); return std::string(); }
+    int r = ctx->Execute();
+    std::string ret;
+    if (r == asEXECUTION_FINISHED) {
+        // Get return value (script std::string registered as value type)
+        void* obj = ctx->GetReturnObject();
+        if (obj) {
+            try {
+                std::string* s = reinterpret_cast<std::string*>(obj);
+                ret = *s;
+            } catch (...) {
+                // fallback: leave ret empty
+            }
+        }
+    }
+    ctx->Release();
+    return ret;
+}
+
+void ScriptEngine::RestoreScriptState(const std::string &state) {
+    if (!currentModule || !engine || state.empty()) return;
+    asIScriptFunction* des = currentModule->GetFunctionByDecl("void __DeserializeState(const string &in)");
+    if (!des) return;
+
+    asIScriptContext* ctx = engine->CreateContext();
+    if (ctx->Prepare(des) < 0) { ctx->Release(); return; }
+    // SetArgObject expects pointer to the script string object; AngelScript's
+    // std::string binding uses C++ std::string, so we pass the pointer.
+    ctx->SetArgObject(0, (void*)&state);
+    int r = ctx->Execute();
+    if (r != asEXECUTION_FINISHED) {
+        log_error("Failed to restore script state");
+    }
+    ctx->Release();
+}
+
 void ScriptEngine::Shutdown() {
     ClearCachedFunctions();
     if (engine) {
@@ -178,36 +230,36 @@ int ScriptEngine::IncludeCallback(const char* include, const char* from, CScript
     // Log the include request with clean filenames
     log_info("Including: %s (from: %s)", include, fromFile ? fromFile : "main");
     
-    // Build the full path relative to the including file's directory
-    std::string fullPath;
-    
+    // Build the full path candidates: relative to 'from' and any include paths
+    std::vector<std::string> candidates;
+
     if (from && strlen(from) > 0) {
-        // Extract directory from the 'from' path
         std::string fromPath(from);
         size_t lastSlash = fromPath.find_last_of("/\\");
-        
         if (lastSlash != std::string::npos) {
-            // Get the directory part
             std::string directory = fromPath.substr(0, lastSlash + 1);
-            fullPath = directory + include;
-        } else {
-            // No directory in from path, use include as-is
-            fullPath = include;
+            candidates.push_back(directory + include);
         }
-    } else {
-        fullPath = include;
     }
-    
-    // Try to add the included file
-    int r = builder->AddSectionFromFile(fullPath.c_str());
-    
-    if (r < 0) {
-        log_error("Failed to include file: %s (tried path: %s)", include, fullPath.c_str());
-    } else {
-        log_info("Successfully included: %s", include);
+
+    // Add user-specified include search paths
+    // Note: includePaths is a member of the ScriptEngine instance, but this
+    // callback is static. For now we look for an environment variable or the
+    // include as-is. If you want dynamic include paths, expose a global pointer
+    // or userParam to pass the instance to the callback.
+    candidates.push_back(include);
+
+    int result = -1;
+    for (auto &cand : candidates) {
+        result = builder->AddSectionFromFile(cand.c_str());
+        if (result >= 0) {
+            log_info("Successfully included: %s", cand.c_str());
+            return result;
+        }
     }
-    
-    return r;
+
+    log_error("Failed to include file: %s (tried %zu paths)", include, candidates.size());
+    return result;
 }
 
 std::string ScriptEngine::ReadFile(const std::string& filename) {

tests/CMakeLists.txt

@@ -0,0 +1,30 @@
+cmake_minimum_required(VERSION 3.16)
+
+# Simple unit test executable that compiles acutest.c directly
+add_executable(unit_tests
+    unit_tests.cpp
+    ${CMAKE_SOURCE_DIR}/src/HotReload.cpp
+    ${CMAKE_SOURCE_DIR}/src/ScriptEngine.cpp
+    ${CMAKE_SOURCE_DIR}/src/ScriptBindings.cpp
+    ${CMAKE_SOURCE_DIR}/src/log/log.c
+)
+
+target_include_directories(unit_tests PRIVATE
+    ${CMAKE_SOURCE_DIR}/external/acutest/include
+    ${CMAKE_SOURCE_DIR}/include
+    ${CMAKE_SOURCE_DIR}/src/log
+    ${CMAKE_SOURCE_DIR}/external/angelscript/sdk/angelscript/include
+    ${CMAKE_SOURCE_DIR}/external/angelscript/sdk/add_on/scriptstdstring
+    ${CMAKE_SOURCE_DIR}/external/angelscript/sdk/add_on/scriptbuilder
+    ${CMAKE_SOURCE_DIR}/external/raylib/src
+)
+
+# Link AngelScript and its add-ons needed by ScriptEngine
+target_link_libraries(unit_tests PRIVATE
+    angelscript
+    scriptstdstring
+    scriptbuilder
+    raylib
+)
+
+add_test(NAME unit_tests COMMAND unit_tests)

tests/acutest_main.c

@@ -0,0 +1,3 @@
+#include "../external/acutest/include/acutest.h"
+
+// This translation unit provides the single main() for Acutest.

tests/unit_tests.cpp

@@ -0,0 +1,103 @@
+#include "../external/acutest/include/acutest.h"
+#include <string.h>
+#include <filesystem>
+#include <fstream>
+#include <thread>
+#include <chrono>
+#include "../include/HotReload.h"
+#include "../include/ScriptEngine.h"
+
+using namespace std::chrono_literals;
+
+/* simple sanity test */
+void test_one(void) {
+    TEST_CHECK(1 + 1 == 2);
+}
+
+void test_str(void) {
+    TEST_CHECK(strcmp("foo","foo") == 0);
+}
+
+void test_hotreload_directory_watch(void) {
+    std::filesystem::path tmpDir = std::filesystem::current_path() / "tmp_watch";
+    std::filesystem::create_directories(tmpDir);
+
+    std::filesystem::path f = tmpDir / "a.as";
+    std::ofstream ofs(f);
+    ofs << "// test" << std::endl;
+    ofs.close();
+
+    HotReload hr(tmpDir.string());
+    TEST_CHECK(hr.CheckForChanges() == false);
+
+    std::this_thread::sleep_for(1s);
+    std::ofstream ofs2(f, std::ios::app);
+    ofs2 << "// changed" << std::endl;
+    ofs2.close();
+
+    TEST_CHECK(hr.CheckForChanges() == true);
+
+    std::filesystem::remove(f);
+    std::filesystem::remove(tmpDir);
+}
+
+void test_scriptengine_compile_and_call(void) {
+    // Create a simple script file that defines Update(float) and a global
+    std::filesystem::path tmpDir = std::filesystem::current_path() / "tmp_script";
+    std::filesystem::create_directories(tmpDir);
+    std::filesystem::path script = tmpDir / "simple.as";
+    std::ofstream ofs(script);
+    ofs << "float g_x = 0;\n";
+    ofs << "void Update(float dt) { g_x += dt * 10.0f; }\n";
+    ofs.close();
+
+    ScriptEngine se;
+    TEST_CHECK(se.Initialize() == true);
+    bool ok = se.CompileScript(script.string());
+    TEST_CHECK(ok == true);
+    asIScriptFunction* upd = se.GetUpdateFunction();
+    TEST_CHECK(upd != nullptr);
+
+    // Call Update with dt=0.1
+    se.CallScriptFunction(upd, 0.1f);
+
+    se.Shutdown();
+
+    std::filesystem::remove(script);
+    std::filesystem::remove(tmpDir);
+}
+
+void test_scriptengine_include(void) {
+    std::filesystem::path tmpDir = std::filesystem::current_path() / "tmp_include";
+    std::filesystem::create_directories(tmpDir);
+    std::filesystem::path inc = tmpDir / "inc.as";
+    std::ofstream ofsinc(inc);
+    ofsinc << "void Included() { Print(\"Included called\"); }\n";
+    ofsinc.close();
+
+    std::filesystem::path main = tmpDir / "main.as";
+    std::ofstream ofsmain(main);
+    ofsmain << "#include \"inc.as\"\n";
+    ofsmain << "void Update(float dt) { Included(); }\n";
+    ofsmain.close();
+
+    ScriptEngine se;
+    TEST_CHECK(se.Initialize() == true);
+    // Compile should succeed and include callback should resolve inc.as
+    bool ok = se.CompileScript(main.string());
+    TEST_CHECK(ok == true);
+    se.Shutdown();
+
+    std::filesystem::remove(inc);
+    std::filesystem::remove(main);
+    std::filesystem::remove(tmpDir);
+}
+
+TEST_LIST = {
+    { "one", test_one },
+    { "str", test_str },
+    { "hotreload_dir", test_hotreload_directory_watch },
+    { "script_compile", test_scriptengine_compile_and_call },
+    { "script_include", test_scriptengine_include },
+    { NULL, NULL }
+};