# SDL3 vendoring

- **Source**: https://github.com/libsdl-org/SDL
- **Tag**: `release-3.4.8` (May 2026)
- **License**: Zlib (`cpp/vendor/sdl3/LICENSE.txt`)
- **Vendoring command**:
  ```
  cd cpp/vendor && git clone --depth 1 --branch release-3.4.8 \
    https://github.com/libsdl-org/SDL.git sdl3
  ```
- **Build**: SDL3 trae su propio `CMakeLists.txt`. Se incluye via `add_subdirectory(vendor/sdl3)` en apps que lo usen y se enlaza target `SDL3::SDL3` o `SDL3::SDL3-static`.
- **Tamaño en disco**: ~71 MB (incluye plataform-specifics que NO necesitamos en Linux/Web). Si crece excesivo, considerar mover a submodulo o purgar `Xcode/`, `VisualC*/`, `android-project/` cuando esten cubiertos por sus apps mobile.

## Por qué SDL3 (no SDL2 ni GLFW)

- Cubre todas las plataformas objetivo del stack gamedev: Win, Lin, Mac, Android, iOS, Emscripten.
- API oficial estable desde finales 2024.
- Touch input + virtual gamepad nativos.
- Audio integrado.
- ImGui ya tiene backend `imgui_impl_sdl3.{h,cpp}` en `cpp/vendor/imgui/backends/`.
- Compatible con sokol_gfx (manual GL context creation).

## Upgrade

Re-clonar con nuevo tag. SDL3 sigue semver, breaking changes solo entre majors.
