feat(core/audio): music-ended callback (CONV-03)

Ja::Engine exposa setOnMusicEnded(std::function<void()>). Quan
updateCurrentMusic detecta que la pista actual ha acabat de drenar
(times == 0 && stream buit) s'atura primer via stopMusic i després
s'invoca el callback — així un eventual playMusic des del callback pot
començar amb l'engine en estat net.

Audio proxeia amb setOnMusicEnded. Contracte documentat: s'executa al
mateix thread que Audio::update (render loop); no fer operacions
blocants.

Cap consumidor actualment; només exposa l'API per quan calgui.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

source/core/audio/jail_audio.hpp

@@ -4,6 +4,7 @@
 #include <SDL3/SDL.h>
 
 #include <cstdint>
+#include <functional>
 #include <memory>
 #include <string>
 #include <vector>
@@ -133,6 +134,12 @@ namespace Ja {
         void crossfadeMusic(Music* music, int crossfade_ms, int loop = -1);
         [[nodiscard]] auto getMusicState() const -> MusicState;
         auto setMusicVolume(float volume) -> float;
+        // Registra un callback que es disparà quan la música actual acabi de
+        // drenar naturalment (times == 0 + stream buit). Es crida DESPRÉS de
+        // stopMusic, així que el callback pot invocar playMusic sense córrer.
+        // S'executa al mateix thread que Engine::update (render loop); no fer
+        // operacions blocants.
+        void setOnMusicEnded(std::function<void()> callback);
         // Notifica al motor que un Music s'està destruint: si és el current_music
         // s'atura abans que els seus recursos (stream/vorbis) deixin de ser vàlids.
         void onMusicDeleted(const Music* music);
@@ -166,6 +173,7 @@ namespace Ja {
         SDL_AudioDeviceID sdl_audio_device_{0};
         OutgoingMusic outgoing_music_;
         FadeState incoming_fade_;
+        std::function<void()> on_music_ended_;
 
         // NOLINTNEXTLINE(readability-identifier-naming) — convenció projecte: private static amb sufix _
         static Engine* active_;