This module owns SDL3 window/event polling and native WebGPU surfaces (macOSMetal, Linux Wayland/X11 Vulkan)bootstrap used by native examples. The main public package isemadurandal/rhodonite_app_sdl3/sdl3.
The SDL3 session type is opaque. Callers use accessors such as gpu_context(),surface_active(), surface_width(), surface_height(), andsurface_format() instead of reading runtime fields directly.
Initialization, device creation, window-size queries, and resize handling reportstructured Sdl3AppError values. The runtime handles SDL window resize eventsand reconfigures the native WebGPU surface when the drawable pixel size changes.Runtime 0x0/minimized surfaces are propagated to Engine as suspended ratherthan as fatal errors.
The Wayland/X11 native surface C helper is active only on Linux. Other nativehosts export no-op/null ABI stubs so the macOS Metal path does not require SDL3headers while compiling Linux-only helper code.