fix(freeplay): prevent song previews from cutting, when navigating through the menus to quickly

Author: AnimatingLegend

source/funkin/ui/freeplay/FreeplayState.hx

@@ -401,7 +401,7 @@ class FreeplayState extends MusicBeatSubState
         // Set rememberedSongId to last played song if accessed from the RANDOM option
         rememberedSongId = fromResultsParams.songId;
       }
-    
+
       @:privateAccess
       this._parentState._constructor = () ->
       {
@@ -1397,7 +1397,7 @@ class FreeplayState extends MusicBeatSubState
     new FlxTimer().start(0.5, _ ->
     {
       dispatchEvent(new CapsuleScriptEvent(FREEPLAY_CAPSULE_SLAM, currentCapsule, currentDifficulty, currentVariation, fromResultsParams?.newRank));
-      
+
       // Capsule slam vibration.
       HapticUtil.vibrate(Constants.DEFAULT_VIBRATION_PERIOD, Constants.DEFAULT_VIBRATION_DURATION, Constants.MAX_VIBRATION_AMPLITUDE);
 
@@ -3257,11 +3257,16 @@ class FreeplayState extends MusicBeatSubState
 
     if (grpCapsules.countLiving() > 0 && !prepForNewRank && uiStateMachine.canInteract())
     {
-      FlxG.sound.music?.pause();
-      FlxTimer.wait(FADE_IN_DELAY, playCurSongPreview.bind(currentCapsule));
-      currentCapsule.selected = true;
+      clearPreviews();
+
+      // Create a timer to delay the song preview to prevent overlapping or cutting out.
+      var previewTransition = new FlxTimer().start(FADE_IN_DELAY, function(_)
+      {
+        if (FlxG.sound.music != null) FlxG.sound.music.stop();
+        playCurSongPreview(currentCapsule);
+      });
 
-      // switchBackingImage(currentCapsule.freeplayData);
+      previewTimers.push(previewTransition);
     }
 
     // Small vibrations every selection change.