TrussC-org · tettou771 · Jul 16, 2026 · Jul 3, 2026 · Jul 3, 2026 · Jul 3, 2026
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -11,6 +11,13 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  # Uses of [[deprecated]] TrussC API in the repo's own sources
+  # (core/examples/tests, all jobs incl. web/android) fail the build
+  # (GCC/Clang only; see core/CMakeLists.txt + trussc_app.cmake).
+  # User projects never set this.
+  TC_DEPRECATED_ERRORS: 1
+
 jobs:
   # Path-based change detector. Emits docs_only=true when EVERY file in the diff
   # is documentation (any *.md, or anything under docs/ — prose + doc tooling).

diff --git a/addons/tcxBox2d/example-collision/src/tcApp.cpp b/addons/tcxBox2d/example-collision/src/tcApp.cpp
@@ -54,15 +54,14 @@ void tcApp::addBall(float x, float y) {
     // Add collision callback to ball
     auto* collider = ball->getCollider();
     if (collider) {
-        ballListeners.emplace_back();
-        collider->onCollisionEnter.listen(ballListeners.back(), [this](box2d::CollisionEvent& e) {
+        ballListeners.push_back(collider->onCollisionEnter.listen([this](box2d::CollisionEvent& e) {
             enterCount++;
             collisionMarkers.push_back({
                 e.contactPoint,
                 0.3f,
                 Color(0.2f, 0.8f, 1.0f)  // cyan for ball collisions
             });
-        });
+        }));
     }
 
     addChild(ball);

diff --git a/addons/tcxCurl/src/tcxCurl_android.cpp b/addons/tcxCurl/src/tcxCurl_android.cpp
@@ -22,7 +22,7 @@
 
 #include <jni.h>
 #include <android/native_activity.h>
-#include "sokol_app.h"
+#include "sokol_app_tc.h"
 
 #include <cstring>
 

diff --git a/addons/tcxDepthRecord/src/tcxDepthPlayback.h b/addons/tcxDepthRecord/src/tcxDepthPlayback.h
@@ -63,8 +63,8 @@ class PlaybackDepthCamera : public DepthCamera {
 
 protected:
     bool openDevice() override {
-        std::filesystem::path p(path_);
-        std::string resolved = p.is_relative() ? getDataPath(path_) : path_;
+        // getDataPath passes absolute paths through unchanged
+        std::filesystem::path resolved = getDataPath(path_);
         file_.open(resolved, std::ios::binary);
         if (!file_) {
             logError("tcxDepthRecord") << "PlaybackDepthCamera: cannot open " << resolved;

diff --git a/addons/tcxDepthRecord/src/tcxDepthRecorder.h b/addons/tcxDepthRecord/src/tcxDepthRecorder.h
@@ -44,16 +44,15 @@ class DepthRecorder {
                std::uint32_t streams = REC_ALL,
                DepthCodecId depthCodec = DepthCodecId::HiloLZ4,
                ColorCodecId colorCodec = ColorCodecId::LZ4) {
-        std::filesystem::path p(path);
-        std::string resolved = p.is_relative() ? getDataPath(path) : path;
-        std::filesystem::path rp(resolved);
+        // getDataPath passes absolute paths through unchanged
+        std::filesystem::path rp = getDataPath(path);
         if (rp.has_parent_path()) {
             std::error_code ec;
             std::filesystem::create_directories(rp.parent_path(), ec);
         }
         file_.open(rp, std::ios::binary | std::ios::trunc);
         if (!file_) {
-            logError("tcxDepthRecord") << "DepthRecorder: cannot open " << resolved;
+            logError("tcxDepthRecord") << "DepthRecorder: cannot open " << rp;
             return false;
         }
         streams_ = streams;

diff --git a/addons/tcxGltf/src/tcxGltf.cpp b/addons/tcxGltf/src/tcxGltf.cpp
@@ -226,7 +226,7 @@ bool GltfModel::load(const string& path) {
     textures_.clear();
     loaded_ = false;
 
-    string resolved = getDataPath(path);
+    string resolved = getDataPath(path).string();
 
     // Parse with cgltf
     cgltf_options options = {};

diff --git a/addons/tcxHap/CMakeLists.txt b/addons/tcxHap/CMakeLists.txt
@@ -24,6 +24,13 @@ set(SNAPPY_BUILD_TESTS OFF CACHE BOOL "" FORCE)
 set(SNAPPY_BUILD_BENCHMARKS OFF CACHE BOOL "" FORCE)
 set(SNAPPY_INSTALL OFF CACHE BOOL "" FORCE)
 FetchContent_MakeAvailable(snappy)
+if(EMSCRIPTEN)
+    # snappy compiles itself with -Werror on Clang; its '#pragma clang loop'
+    # vectorization hints cannot be honored under wasm, and the resulting
+    # -Wpass-failed diagnostic would fail the build. Silence it on the
+    # dependency target only.
+    target_compile_options(snappy PRIVATE -Wno-pass-failed)
+endif()
 
 # Snappy adds -Werror for Clang builds; its `#pragma clang loop` hints can fail
 # on backends that can't vectorize them (e.g. wasm/em++), turning the

diff --git a/addons/tcxHap/example-hap/src/tcApp.cpp b/addons/tcxHap/example-hap/src/tcApp.cpp
@@ -11,7 +11,7 @@ void tcApp::setup() {
         .bind([this](const json& args) -> json {
             string path = args.at("path").get<string>();
             logNotice("tcApp") << "MCP: Loading " << path;
-            bool success = player_.load(path);
+            bool success = player_.load(path).ok();
             if (success) {
                 player_.play();
                 statusText_ = "Loaded: " + path;

diff --git a/addons/tcxHap/src/tcxHapPlayer.h b/addons/tcxHap/src/tcxHapPlayer.h
@@ -74,16 +74,23 @@ class HapPlayer : public tc::VideoPlayerBase {
     // Load / Close
     // =========================================================================
 
-    bool load(const std::string& path) override {
+    tc::LoadResult load(const tc::fs::path& path) override {
         if (initialized_) {
             close();
         }
         resetStats();
 
+        std::error_code ec;
+        if (!tc::fs::exists(path, ec)) {
+            return tc::LoadResult::fail(tc::LoadError::FileNotFound,
+                "file not found: " + tc::internal::pathToUtf8(path));
+        }
+
         // Parse MOV file
         if (!movParser_.open(path)) {
             tc::logError("HapPlayer") << "Failed to open: " << path;
-            return false;
+            return tc::LoadResult::fail(tc::LoadError::DecodeFailed,
+                "failed to parse MOV: " + tc::internal::pathToUtf8(path));
         }
 
         const auto& info = movParser_.getInfo();
@@ -92,14 +99,17 @@ class HapPlayer : public tc::VideoPlayerBase {
         if (!videoTrack) {
             tc::logError("HapPlayer") << "No video track found";
             movParser_.close();
-            return false;
+            return tc::LoadResult::fail(tc::LoadError::DecodeFailed,
+                "no video track found");
         }
 
         if (!videoTrack->isHap()) {
             tc::logError("HapPlayer") << "Not a HAP codec (FourCC: "
                 << MovParser::fourccToString(videoTrack->codecFourCC) << ")";
             movParser_.close();
-            return false;
+            return tc::LoadResult::fail(tc::LoadError::UnsupportedFormat,
+                "not a HAP codec (FourCC: " +
+                MovParser::fourccToString(videoTrack->codecFourCC) + ")");
         }
 
         // Store video info
@@ -120,7 +130,8 @@ class HapPlayer : public tc::VideoPlayerBase {
         if (hapFormat_ == HapFormat::Unknown) {
             tc::logError("HapPlayer") << "Could not determine HAP format";
             movParser_.close();
-            return false;
+            return tc::LoadResult::fail(tc::LoadError::DecodeFailed,
+                "could not determine HAP format");
         }
 
         // Allocate frame buffer for decoded DXT data
@@ -131,7 +142,8 @@ class HapPlayer : public tc::VideoPlayerBase {
         if (!createCompressedTexture()) {
             tc::logError("HapPlayer") << "Failed to create compressed texture";
             movParser_.close();
-            return false;
+            return tc::LoadResult::fail(tc::LoadError::Unknown,
+                "failed to create compressed texture");
         }
 
         // Load audio track if available
@@ -147,7 +159,7 @@ class HapPlayer : public tc::VideoPlayerBase {
 
         initialized_ = true;
         currentFrame_ = 0;
-        return true;
+        return tc::LoadResult::success();
     }
 
     void close() override {

diff --git a/addons/tcxHap/src/tcxMovParser.h b/addons/tcxHap/src/tcxMovParser.h
@@ -185,7 +185,7 @@ class MovParser {
         return *this;
     }
 
-    bool open(const std::string& path) {
+    bool open(const tc::fs::path& path) {
         close();
 
         // Create a completely fresh fstream object (not reusing old one)

diff --git a/addons/tcxImGui/README.md b/addons/tcxImGui/README.md
@@ -96,10 +96,10 @@ void tcApp::setup() {
 
 | Tool | Arguments | Description |
 |------|-----------|-------------|
-| `imgui_get_widgets` | `window` (optional) | List all widgets with labels, types, and positions |
-| `imgui_click` | `label`, `window` (optional) | Click a widget by label |
-| `imgui_input` | `label`, `text`, `window` (optional) | Set a widget's value: replaces text in input widgets, and enters numeric values directly into slider/drag widgets (Ctrl+Click temp input) |
-| `imgui_checkbox` | `label`, `value` (optional), `window` (optional) | Toggle or set a checkbox |
+| `tcx_imgui_get_widgets` | `window` (optional) | List all widgets with labels, types, and positions |
+| `tcx_imgui_click` | `label`, `window` (optional) | Click a widget by label |
+| `tcx_imgui_input` | `label`, `text`, `window` (optional) | Set a widget's value: replaces text in input widgets, and enters numeric values directly into slider/drag widgets (Ctrl+Click temp input) |
+| `tcx_imgui_checkbox` | `label`, `value` (optional), `window` (optional) | Toggle or set a checkbox |
 
 These tools use ImGui's Test Engine hooks to collect widget info each frame.
 

diff --git a/addons/tcxImGui/src/platform/imgui_impl_android.cpp b/addons/tcxImGui/src/platform/imgui_impl_android.cpp
@@ -5,7 +5,7 @@
 #ifdef __ANDROID__
 
 // sokol headers (must come before sokol_imgui.h)
-#include "sokol/sokol_app.h"
+#include "sokol/sokol_app_tc.h"
 #include "sokol/sokol_gfx.h"
 #include "sokol/sokol_log.h"
 

diff --git a/addons/tcxImGui/src/platform/imgui_impl_ios.mm b/addons/tcxImGui/src/platform/imgui_impl_ios.mm
@@ -3,7 +3,7 @@
 // =============================================================================
 
 // sokol headers (required before sokol_imgui.h)
-#include "sokol/sokol_app.h"
+#include "sokol/sokol_app_tc.h"
 #include "sokol/sokol_gfx.h"
 #include "sokol/sokol_log.h"
 

diff --git a/addons/tcxImGui/src/platform/imgui_impl_linux.cpp b/addons/tcxImGui/src/platform/imgui_impl_linux.cpp
@@ -3,7 +3,7 @@
 // =============================================================================
 
 // sokol ヘッダー（sokol_imgui.h より先に必要）
-#include "sokol/sokol_app.h"
+#include "sokol/sokol_app_tc.h"
 #include "sokol/sokol_gfx.h"
 #include "sokol/sokol_log.h"
 

diff --git a/addons/tcxImGui/src/platform/imgui_impl_mac.mm b/addons/tcxImGui/src/platform/imgui_impl_mac.mm
@@ -3,7 +3,7 @@
 // =============================================================================
 
 // sokol ヘッダー（sokol_imgui.h より先に必要）
-#include "sokol/sokol_app.h"
+#include "sokol/sokol_app_tc.h"
 #include "sokol/sokol_gfx.h"
 #include "sokol/sokol_log.h"
 

diff --git a/addons/tcxImGui/src/platform/imgui_impl_web.cpp b/addons/tcxImGui/src/platform/imgui_impl_web.cpp
@@ -3,7 +3,7 @@
 // =============================================================================
 
 // sokol ヘッダー（sokol_imgui.h より先に必要）
-#include "sokol/sokol_app.h"
+#include "sokol/sokol_app_tc.h"
 #include "sokol/sokol_gfx.h"
 #include "sokol/sokol_log.h"
 

diff --git a/addons/tcxImGui/src/platform/imgui_impl_win.cpp b/addons/tcxImGui/src/platform/imgui_impl_win.cpp
@@ -3,7 +3,7 @@
 // =============================================================================
 
 // sokol ヘッダー（sokol_imgui.h より先に必要）
-#include "sokol/sokol_app.h"
+#include "sokol/sokol_app_tc.h"
 #include "sokol/sokol_gfx.h"
 #include "sokol/sokol_log.h"
 

diff --git a/addons/tcxImGui/src/sokol_imgui.h b/addons/tcxImGui/src/sokol_imgui.h
@@ -561,6 +561,18 @@ SOKOL_IMGUI_API_DECL void simgui_shutdown(void);
 inline void simgui_setup(const simgui_desc_t& desc) { return simgui_setup(&desc); }
 inline void simgui_new_frame(const simgui_frame_desc_t& desc) { return simgui_new_frame(&desc); }
 
+/* [TrussC] multi-context API (multi-window support). Each context is a full,
+   independent sokol_imgui instance (own ImGui context, font atlas, buffers,
+   pipeline). simgui_tc_set_context() selects which instance the classic
+   simgui_* calls (and ImGui::GetCurrentContext) operate on. The context
+   handle from simgui_tc_get_context() before any make/set is the default
+   instance (what plain simgui_setup initialized). */
+typedef struct simgui_tc_context { void* ptr; } simgui_tc_context;
+SOKOL_IMGUI_API_DECL simgui_tc_context simgui_tc_make_context(const simgui_desc_t* desc);
+SOKOL_IMGUI_API_DECL void simgui_tc_set_context(simgui_tc_context ctx);
+SOKOL_IMGUI_API_DECL simgui_tc_context simgui_tc_get_context(void);
+SOKOL_IMGUI_API_DECL void simgui_tc_destroy_context(simgui_tc_context ctx);
+
 #endif
 #endif /* SOKOL_IMGUI_INCLUDED */
 
@@ -646,8 +658,17 @@ typedef struct {
     sg_range vertices;
     sg_range indices;
     bool is_osx;
+    void* imgui_ctx;    // [TrussC] the ImGuiContext* owned by this instance
 } _simgui_state_t;
-static _simgui_state_t _simgui;
+
+// [TrussC] Multi-context support (multi-window): _simgui becomes a reference
+// to the ACTIVE instance so the whole implementation below compiles
+// unchanged. simgui_setup()/simgui_* operate on the instance selected via
+// simgui_tc_set_context(); the default instance preserves classic
+// single-window behavior.
+static _simgui_state_t _simgui_default_instance;
+static _simgui_state_t* _simgui_cur = &_simgui_default_instance;
+#define _simgui (*_simgui_cur)
 
 //>#shdgen
 #if defined(SOKOL_GLCORE)
@@ -2127,10 +2148,19 @@ static void _simgui_imgui_newframe(void) {
 }
 
 static void _simgui_imgui_create_context(void) {
+    // [TrussC] Since Dear ImGui 1.90, CreateContext() RESTORES the previously
+    // current context before returning (it is deliberately not
+    // context-switching). Capture the RETURN VALUE and make the new context
+    // current explicitly -- the rest of simgui_setup() configures "the
+    // current context" and must target the newly created one.
     #if defined(__cplusplus)
-        ImGui::CreateContext();
+        ImGuiContext* ctx = ImGui::CreateContext();
+        ImGui::SetCurrentContext(ctx);
+        _simgui.imgui_ctx = (void*)ctx;
     #else
-        _SIMGUI_CFUNC(CreateContext)(0);
+        ImGuiContext* ctx = _SIMGUI_CFUNC(CreateContext)(0);
+        _SIMGUI_CFUNC(SetCurrentContext)(ctx);
+        _simgui.imgui_ctx = (void*)ctx;
     #endif
 }
 
@@ -3170,4 +3200,71 @@ SOKOL_API_IMPL bool simgui_handle_event(const sapp_event* ev) {
 }
 #endif // SOKOL_IMGUI_NO_SOKOL_APP
 
+/* [TrussC] multi-context API implementation */
+SOKOL_API_IMPL simgui_tc_context simgui_tc_get_context(void) {
+    simgui_tc_context c; c.ptr = (void*)_simgui_cur; return c;
+}
+
+SOKOL_API_IMPL void simgui_tc_set_context(simgui_tc_context ctx) {
+    SOKOL_ASSERT(ctx.ptr);
+    _simgui_cur = (_simgui_state_t*)ctx.ptr;
+    if (_simgui.imgui_ctx) {
+        #if defined(__cplusplus)
+            ImGui::SetCurrentContext((ImGuiContext*)_simgui.imgui_ctx);
+        #else
+            _SIMGUI_CFUNC(SetCurrentContext)((ImGuiContext*)_simgui.imgui_ctx);
+        #endif
+    }
+}
+
+SOKOL_API_IMPL simgui_tc_context simgui_tc_make_context(const simgui_desc_t* desc) {
+    SOKOL_ASSERT(desc);
+    /* plain malloc: instance lifetime is independent of any per-instance
+       custom allocator (custom allocators across tc contexts unsupported) */
+    _simgui_state_t* inst = (_simgui_state_t*)malloc(sizeof(_simgui_state_t));
+    SOKOL_ASSERT(inst);
+    memset(inst, 0, sizeof(_simgui_state_t));
+    _simgui_state_t* prev = _simgui_cur;
+    #if defined(__cplusplus)
+        ImGuiContext* prev_im = ImGui::GetCurrentContext();
+    #else
+        ImGuiContext* prev_im = _SIMGUI_CFUNC(GetCurrentContext)();
+    #endif
+    _simgui_cur = inst;
+    simgui_setup(desc);      /* fills the new instance, creates its ImGui context */
+    _simgui_cur = prev;
+    #if defined(__cplusplus)
+        ImGui::SetCurrentContext(prev_im);
+    #else
+        _SIMGUI_CFUNC(SetCurrentContext)(prev_im);
+    #endif
+    simgui_tc_context c; c.ptr = (void*)inst; return c;
+}
+
+SOKOL_API_IMPL void simgui_tc_destroy_context(simgui_tc_context ctx) {
+    if (!ctx.ptr || ctx.ptr == (void*)&_simgui_default_instance) {
+        return;   /* the default instance is torn down by plain simgui_shutdown() */
+    }
+    _simgui_state_t* inst = (_simgui_state_t*)ctx.ptr;
+    _simgui_state_t* prev = _simgui_cur;
+    #if defined(__cplusplus)
+        ImGuiContext* prev_im = ImGui::GetCurrentContext();
+    #else
+        ImGuiContext* prev_im = _SIMGUI_CFUNC(GetCurrentContext)();
+    #endif
+    if (prev == inst) { prev = &_simgui_default_instance; prev_im = 0; }
+    simgui_tc_context sel; sel.ptr = (void*)inst;
+    simgui_tc_set_context(sel);
+    simgui_shutdown();
+    _simgui_cur = prev;
+    if (prev_im) {
+        #if defined(__cplusplus)
+            ImGui::SetCurrentContext(prev_im);
+        #else
+            _SIMGUI_CFUNC(SetCurrentContext)(prev_im);
+        #endif
+    }
+    free(inst);
+}
+
 #endif // SOKOL_IMPL