pixi-rainman-game-engine 0.3.42 → 0.3.43-b

package/dist/ComponentRegistry/ComponentRegistry.js

@@ -1,5 +1,5 @@
 import { isIncentiveComponentInterface, isSpeedAdapterInterface, SpeedLevelHandler, TimedIncentiveController } from "../application";
-import { AbstractSymbolsColumn, SpeedControlButton } from "../components";
+import { AbstractSymbolsColumn, SpeedControlButton, SpeedControlButtonMobile } from "../components";
 import { RainMan } from "../Rainman";
 import { openFullscreen } from "../utils";
 /**
@@ -60,7 +60,8 @@ export class ComponentRegistry {
         this.speedLevelHandler.nextSpeed();
         RainMan.settingsStore.setSpeedLevel(this.speedLevelHandler.currentSpeed);
         this.updateAllSpeedAdaptable(RainMan.settingsStore.currentSpeed);
-        this.get(SpeedControlButton.registryName).forceTextureUpdate();
+        this.getIfExists(SpeedControlButton.registryName)?.forceTextureUpdate();
+        this.getIfExists(SpeedControlButtonMobile.registryName)?.forceTextureUpdate();
     }
     /**
      * Getter for current speed level

package/dist/ComponentRegistry/types.d.ts

@@ -1,4 +1,4 @@
-import { AbstractColumnsContainer, AbstractFrame, AbstractInnerFrame, AutoplayButton, Background, BUTTONS, COMPONENTS, FreeSpinButton, GambleButton, InfoButton, MessageBox, MoreButton, NegButton, PlusButton, RefreshButton, SpeedControlButton, StylefulUpdatableText, TakeButton, UpdatableTextComponent, UpdatableValueComponent, VolumeButton } from "../components";
+import { AbstractColumnsContainer, AbstractFrame, AbstractInnerFrame, AutoplayButton, Background, BUTTONS, COMPONENTS, FreeSpinButton, GambleButton, InfoButton, MessageBox, MoreButton, NegButton, PlusButton, RefreshButton, SpeedControlButton, SpeedControlButtonMobile, StylefulUpdatableText, TakeButton, UpdatableTextComponent, UpdatableValueComponent, VolumeButton } from "../components";
 /**
  * RegistryMap is a map of all components that are registered in the ComponentRegistry.
  * It is used to type-check the components that are registered in the ComponentRegistry.
@@ -11,6 +11,7 @@ export interface RegistryMap {
     [MessageBox.gamePaysTextRegistryName]: UpdatableTextComponent;
     [MessageBox.registryName]: MessageBox;
     [SpeedControlButton.registryName]: SpeedControlButton;
+    [SpeedControlButtonMobile.registryName]: SpeedControlButtonMobile;
     [Background.registryName]: Background;
     [VolumeButton.registryName]: VolumeButton;
     [AutoplayButton.registryName]: AutoplayButton;

package/dist/ComponentRegistry/types.js

@@ -1 +1 @@
-import { AbstractColumnsContainer, AbstractFrame, AbstractInnerFrame, AutoplayButton, Background, BUTTONS, COMPONENTS, FreeSpinButton, InfoButton, MessageBox, MoreButton, NegButton, PlusButton, RefreshButton, SpeedControlButton, VolumeButton } from "../components";
+import { AbstractColumnsContainer, AbstractFrame, AbstractInnerFrame, AutoplayButton, Background, BUTTONS, COMPONENTS, FreeSpinButton, InfoButton, MessageBox, MoreButton, NegButton, PlusButton, RefreshButton, SpeedControlButton, SpeedControlButtonMobile, VolumeButton } from "../components";

package/dist/application/SoundManager/SoundManager.d.ts

@@ -16,8 +16,11 @@ export declare class SoundManagerInstance implements SpeedAdapterInterface<Sound
     readonly speedLevelMapper: SpeedLevelDirectory<SoundOverrides>;
     private musicCatalogue;
     private currentAmbientTrack;
-    private pausedSoundsForPageHide;
+    private currentAmbientOffset;
+    private loadedSoundAssets;
+    private audioContextRecoveryPromise;
     constructor();
+    private loadSound;
     /**
      * Function for loading sounds into pixi
      * @public
@@ -62,7 +65,19 @@ export declare class SoundManagerInstance implements SpeedAdapterInterface<Sound
     getVolumeLevel(soundName: SoundTrack): number;
     private isAmbientTrack;
     private getOppositeAmbientTrack;
+    private getCurrentAmbientTrack;
     private getSound;
+    private getAmbientPlaybackOffset;
+    private trackAmbientPlaybackProgress;
+    /**
+     * Saves active ambient position before the browser interrupts WebAudio playback.
+     * @public
+     * @returns {void}
+     */
+    captureAmbientPlaybackPositionForPageHide(): void;
+    private isIOSWebAudioRuntime;
+    private recreatePixiSoundContext;
+    private recreatePixiSoundContextOnce;
     stopAmbientMusic(): void;
     /**
      * Function for resuming all sounds in game
@@ -78,11 +93,18 @@ export declare class SoundManagerInstance implements SpeedAdapterInterface<Sound
      */
     restoreAmbientPlayback(): void;
     /**
-     * Restores sounds paused because of page visibility change.
-     * @public
+     * Recreates the active ambient WebAudio source after iOS app interruptions.
+     * Existing Pixi instances can report isPlaying=true even when the native audio pipeline is silent.
+     * @private
      * @returns {void}
      */
-    restorePlaybackAfterPageHide(): void;
+    private restartAmbientPlaybackAfterInterruption;
+    /**
+     * Restores ambient playback after page visibility change or iOS app interruption.
+     * @public
+     * @returns {boolean} True when audio context is ready after recovery.
+     */
+    restorePlaybackAfterPageHide(): Promise<boolean>;
     /**
      * Function for pausing all sounds in game
      * If sound is not playing, it will be skipped
@@ -128,13 +150,13 @@ export declare class SoundManagerInstance implements SpeedAdapterInterface<Sound
     /**
      * Function that resumes sounds and music when game is back in focus.
      * @public
-     * @returns {void}
+     * @returns {Promise<boolean>} True when audio context is running.
      */
     resumeAudioContext(): Promise<boolean>;
     /**
      * Function that resumes sounds and music when game is back in focus.
      * @public
-     * @returns {void}
+     * @returns {Promise<boolean>} True when audio context and ambient recovery are ready.
      */
     resumeOnFocus(): Promise<boolean>;
     /**

package/dist/application/SoundManager/SoundManager.js

@@ -31,10 +31,25 @@ export class SoundManagerInstance {
     };
     musicCatalogue = new Map();
     currentAmbientTrack = null;
-    pausedSoundsForPageHide = new Set();
+    currentAmbientOffset = 0;
+    loadedSoundAssets = {};
+    audioContextRecoveryPromise = null;
     constructor() {
         this.overrides = this.speedLevelMapper.slow;
     }
+    loadSound(soundName, url) {
+        return new Promise((resolve) => {
+            const sound = Sound.from({
+                url,
+                autoPlay: false,
+                preload: true,
+                volume: this.getVolumeLevel(soundName),
+                loaded: () => resolve()
+            });
+            sound.name = soundName;
+            this.musicCatalogue.set(soundName, sound);
+        });
+    }
     /**
      * Function for loading sounds into pixi
      * @public
@@ -42,22 +57,13 @@ export class SoundManagerInstance {
      * @returns {Promise<void>} - promise that resolves when all sounds are loaded
      */
     async loadSounds(assets) {
+        this.loadedSoundAssets = { ...assets };
         const loadingSoundsPromises = [];
         for (const [soundName, url] of Object.entries(assets)) {
             if (!url) {
                 continue;
             }
-            loadingSoundsPromises.push(new Promise((resolve) => {
-                const sound = Sound.from({
-                    url,
-                    autoPlay: false,
-                    preload: true,
-                    volume: this.getVolumeLevel(soundName),
-                    loaded: () => resolve()
-                });
-                sound.name = soundName;
-                this.musicCatalogue.set(soundName, sound);
-            }));
+            loadingSoundsPromises.push(this.loadSound(soundName, url));
         }
         await Promise.allSettled(loadingSoundsPromises);
     }
@@ -96,7 +102,6 @@ export class SoundManagerInstance {
         }
     }
     pauseSoundsForPageHide() {
-        this.pausedSoundsForPageHide.clear();
         this.musicCatalogue.forEach((sound, soundName) => {
             if (!sound.isPlaying || sound.paused) {
                 return;
@@ -104,9 +109,8 @@ export class SoundManagerInstance {
             if (soundName === SoundTracks.freeSpinsMusic || soundName === SoundTracks.music) {
                 this.currentAmbientTrack = soundName;
             }
-            this.pausedSoundsForPageHide.add(soundName);
-            sound.pause();
         });
+        sound.pauseAll();
     }
     /**
      * Function for resuming and pausing sound in game
@@ -150,12 +154,15 @@ export class SoundManagerInstance {
                 return;
             }
         }
-        sound.play({
+        const instance = sound.play({
             singleInstance: true,
             loop: soundsToLoop.includes(soundName),
             volume: this.getVolumeLevel(soundName),
             speed: soundName === "cardDrawing" ? 0.8 : 1
         });
+        if (this.isAmbientTrack(soundName) && !(instance instanceof Promise)) {
+            this.trackAmbientPlaybackProgress(soundName, sound, instance);
+        }
     }
     /**
      * Returns the volume level for a given sound track.
@@ -178,10 +185,86 @@ export class SoundManagerInstance {
     getOppositeAmbientTrack(soundName) {
         return soundName === SoundTracks.freeSpinsMusic ? SoundTracks.music : SoundTracks.freeSpinsMusic;
     }
+    getCurrentAmbientTrack() {
+        return (this.currentAmbientTrack ??
+            (RainMan.settingsStore.isFreeSpinsStarted ? SoundTracks.freeSpinsMusic : SoundTracks.music));
+    }
     getSound(soundName) {
         const overrideSoundName = this.overrides[soundName];
         return this.musicCatalogue.get(overrideSoundName ?? soundName);
     }
+    getAmbientPlaybackOffset(sound) {
+        if (!sound.isPlayable || !Number.isFinite(sound.duration) || sound.duration <= 0) {
+            return 0;
+        }
+        return this.currentAmbientOffset % sound.duration;
+    }
+    trackAmbientPlaybackProgress(soundName, sound, instance) {
+        if (!sound.isPlayable || sound.duration <= 0) {
+            return;
+        }
+        instance.on("progress", (progress) => {
+            if (this.currentAmbientTrack !== soundName || !Number.isFinite(progress)) {
+                return;
+            }
+            this.currentAmbientOffset = (progress * sound.duration) % sound.duration;
+        });
+    }
+    /**
+     * Saves active ambient position before the browser interrupts WebAudio playback.
+     * @public
+     * @returns {void}
+     */
+    captureAmbientPlaybackPositionForPageHide() {
+        if (!RainMan.settingsStore.isSoundStarted || !RainMan.settingsStore.shouldPlayAmbientMusic) {
+            return;
+        }
+        const ambientTrack = this.getCurrentAmbientTrack();
+        const ambientSound = this.getSound(ambientTrack);
+        const ambientInstance = ambientSound?.instances.find((instance) => Number.isFinite(instance.progress) && instance.progress > 0);
+        if (!ambientSound || !ambientInstance || !ambientSound.isPlayable || ambientSound.duration <= 0) {
+            return;
+        }
+        this.currentAmbientTrack = ambientTrack;
+        this.currentAmbientOffset = (ambientInstance.progress * ambientSound.duration) % ambientSound.duration;
+    }
+    isIOSWebAudioRuntime() {
+        const userAgent = navigator.userAgent;
+        const platform = navigator.platform;
+        return /iPad|iPhone|iPod/.test(userAgent) || (platform === "MacIntel" && navigator.maxTouchPoints > 1);
+    }
+    async recreatePixiSoundContext() {
+        if (this.audioContextRecoveryPromise) {
+            return this.audioContextRecoveryPromise;
+        }
+        this.audioContextRecoveryPromise = this.recreatePixiSoundContextOnce().finally(() => {
+            this.audioContextRecoveryPromise = null;
+        });
+        return this.audioContextRecoveryPromise;
+    }
+    async recreatePixiSoundContextOnce() {
+        if (!Object.keys(this.loadedSoundAssets).length) {
+            return;
+        }
+        this.musicCatalogue.forEach((sound) => sound.destroy());
+        this.musicCatalogue.clear();
+        try {
+            sound.context.destroy();
+        }
+        catch (error) {
+            console.error("Could not destroy Pixi sound context", error);
+        }
+        sound.init();
+        sound.disableAutoPause = false;
+        const loadingSoundsPromises = [];
+        for (const [soundName, url] of Object.entries(this.loadedSoundAssets)) {
+            if (!url) {
+                continue;
+            }
+            loadingSoundsPromises.push(this.loadSound(soundName, url));
+        }
+        await Promise.allSettled(loadingSoundsPromises);
+    }
     stopAmbientMusic() {
         this.stop(SoundTracks.music);
         this.stop(SoundTracks.freeSpinsMusic);
@@ -196,23 +279,8 @@ export class SoundManagerInstance {
         if (!RainMan.settingsStore.isSoundStarted) {
             return;
         }
-        this.musicCatalogue.forEach((sound, soundName) => {
-            if (sound.paused && sound.isPlaying && sound) {
-                sound.resume();
-            }
-            if (RainMan.settingsStore.shouldPlayAmbientMusic &&
-                !RainMan.settingsStore.isFreeSpinsPlayEnabled &&
-                soundName === SoundTracks.music &&
-                sound.paused) {
-                sound.resume();
-            }
-            if (RainMan.settingsStore.shouldPlayAmbientMusic &&
-                RainMan.settingsStore.isFreeSpinsPlayEnabled &&
-                soundName === SoundTracks.freeSpinsMusic &&
-                sound.paused) {
-                sound.resume();
-            }
-        });
+        sound.resumeAll();
+        this.restoreAmbientPlayback();
     }
     /**
      * Restores currently active ambient loop if browser dropped it while page was inactive.
@@ -227,35 +295,61 @@ export class SoundManagerInstance {
             this.stopAmbientMusic();
             return;
         }
-        const ambientTrack = this.currentAmbientTrack ??
-            (RainMan.settingsStore.isFreeSpinsStarted ? SoundTracks.freeSpinsMusic : SoundTracks.music);
+        const ambientTrack = this.getCurrentAmbientTrack();
         this.play(ambientTrack);
     }
     /**
-     * Restores sounds paused because of page visibility change.
-     * @public
+     * Recreates the active ambient WebAudio source after iOS app interruptions.
+     * Existing Pixi instances can report isPlaying=true even when the native audio pipeline is silent.
+     * @private
      * @returns {void}
      */
-    restorePlaybackAfterPageHide() {
+    restartAmbientPlaybackAfterInterruption() {
         if (!RainMan.settingsStore.isSoundStarted) {
-            this.pausedSoundsForPageHide.clear();
             return;
         }
-        if (!this.pausedSoundsForPageHide.size) {
-            this.restoreAmbientPlayback();
+        if (!RainMan.settingsStore.shouldPlayAmbientMusic) {
+            this.stopAmbientMusic();
             return;
         }
-        const pausedSounds = [...this.pausedSoundsForPageHide];
-        this.pausedSoundsForPageHide.clear();
-        pausedSounds.forEach((soundName) => {
-            if (this.isAmbientTrack(soundName) && !RainMan.settingsStore.shouldPlayAmbientMusic) {
-                return;
-            }
-            if (!this.isAmbientTrack(soundName) && !RainMan.settingsStore.shouldPlayFxSounds) {
-                return;
-            }
-            this.resume(soundName);
+        const ambientTrack = this.getCurrentAmbientTrack();
+        const ambientSound = this.getSound(ambientTrack);
+        if (!ambientSound) {
+            return;
+        }
+        this.stop(this.getOppositeAmbientTrack(ambientTrack));
+        ambientSound.stop();
+        this.currentAmbientTrack = ambientTrack;
+        const instance = ambientSound.play({
+            singleInstance: true,
+            loop: soundsToLoop.includes(ambientTrack),
+            start: this.getAmbientPlaybackOffset(ambientSound),
+            volume: this.getVolumeLevel(ambientTrack),
+            speed: 1
         });
+        if (!(instance instanceof Promise)) {
+            this.trackAmbientPlaybackProgress(ambientTrack, ambientSound, instance);
+        }
+    }
+    /**
+     * Restores ambient playback after page visibility change or iOS app interruption.
+     * @public
+     * @returns {boolean} True when audio context is ready after recovery.
+     */
+    async restorePlaybackAfterPageHide() {
+        if (!RainMan.settingsStore.isSoundStarted) {
+            return false;
+        }
+        sound.resumeAll();
+        if (this.isIOSWebAudioRuntime()) {
+            await this.recreatePixiSoundContext();
+        }
+        const isAudioContextRunning = await this.resumeAudioContext();
+        if (!isAudioContextRunning) {
+            return false;
+        }
+        this.restartAmbientPlaybackAfterInterruption();
+        return true;
     }
     /**
      * Function for pausing all sounds in game
@@ -264,7 +358,7 @@ export class SoundManagerInstance {
      * @returns {void}
      */
     pauseAll() {
-        this.musicCatalogue.forEach((sound) => sound.pause());
+        sound.pauseAll();
     }
     /**
      * Function for stopping all sounds in game
@@ -314,7 +408,7 @@ export class SoundManagerInstance {
     /**
      * Function that resumes sounds and music when game is back in focus.
      * @public
-     * @returns {void}
+     * @returns {Promise<boolean>} True when audio context is running.
      */
     async resumeAudioContext() {
         const pixiSoundContext = sound.context;
@@ -333,7 +427,7 @@ export class SoundManagerInstance {
     /**
      * Function that resumes sounds and music when game is back in focus.
      * @public
-     * @returns {void}
+     * @returns {Promise<boolean>} True when audio context and ambient recovery are ready.
      */
     async resumeOnFocus() {
         if (!RainMan.settingsStore.isSoundStarted) {
@@ -343,8 +437,7 @@ export class SoundManagerInstance {
         if (!isAudioContextRunning) {
             return false;
         }
-        this.restorePlaybackAfterPageHide();
-        return true;
+        return this.restorePlaybackAfterPageHide();
     }
     /**
      * Returns information if audio context is ready to play sounds.

package/dist/components/AbstractMainContainer/AbstractMainContainer.d.ts

@@ -6,7 +6,7 @@ import { RainMan } from "../../Rainman";
 import { Nullable, PromiseResolverType } from "../../utils";
 import { BigWinContainer, MysteryWinContainer, UpdatableSpineContainer } from "../../winComponents";
 import { AbstractFreeSpinContainer } from "../AbstractFreeSpinContainer";
-import { LeftButtons, LeftButtonsLandscape, LeftButtonsMobile, MiddleButtons, RightButtons, RightButtonsLandscape, RightButtonsMobile } from "../buttons";
+import { LeftButtons, LeftButtonsLandscape, LeftButtonsMobile, MiddleButtons, RightButtons, RightButtonsLandscape, RightButtonsMobile, SpeedControlButtonMobile } from "../buttons";
 import { FreeSpinButton, Logo, ResponsiveContainer } from "../common";
 import { IResizableContainer } from "../common/IResizableContainer";
 import { AbstractFrame } from "../frame";
@@ -34,6 +34,7 @@ export declare abstract class AbstractMainContainer extends Container {
     static readonly registryName = "mainContainer";
     messageBox: MessageBox;
     protected bigWinContainer: Nullable<UpdatableSpineContainer> | BigWinContainer;
+    protected readonly mobileSpeedButton: SpeedControlButtonMobile;
     protected mysteryWinContainer: Nullable<UpdatableSpineContainer> | MysteryWinContainer;
     protected bonusWinContainer: Nullable<UpdatableSpineContainer>;
     protected superBonusWinContainer: Nullable<UpdatableSpineContainer>;
@@ -75,6 +76,7 @@ export declare abstract class AbstractMainContainer extends Container {
      * @returns {Promise<void>} - A promise that resolves when the animation is complete.
      */
     invokeMysteryWinPlate(_animationName: string, _popupAnimation: string, _winType: WinTypeId, _amount: number, _isAdditionalFreeSpins: boolean): Promise<void>;
+    protected attachMobileSpeedButton(parent: Container): void;
     /**
      * This function initializes the spines that should be paused when the battery saver is on
      * @protected

package/dist/components/AbstractMainContainer/AbstractMainContainer.js

@@ -3,7 +3,7 @@ import { ButtonsEventManager, SoundManager, SoundTracks } from "../../applicatio
 import { AnimationLayer, BackgroundLayer, FrameLayer, UXLayer } from "../../layers";
 import { RainMan } from "../../Rainman";
 import { getDeviceOrientation, globalMinRatio } from "../../utils";
-import { BUTTONS, LeftButtons, LeftButtonsLandscape, LeftButtonsMobile, MiddleButtons, RefreshButton, RightButtons, RightButtonsLandscape, RightButtonsMobile } from "../buttons";
+import { BUTTONS, LeftButtons, LeftButtonsLandscape, LeftButtonsMobile, MiddleButtons, RefreshButton, RightButtons, RightButtonsLandscape, RightButtonsMobile, SpeedControlButtonMobile } from "../buttons";
 import { GambleGame } from "../GambleGame";
 import { MessageBox } from "../messageBox";
 /**
@@ -29,6 +29,7 @@ export class AbstractMainContainer extends Container {
     static registryName = "mainContainer";
     messageBox;
     bigWinContainer = null;
+    mobileSpeedButton = new SpeedControlButtonMobile();
     mysteryWinContainer = null;
     bonusWinContainer = null;
     superBonusWinContainer = null;
@@ -59,6 +60,9 @@ export class AbstractMainContainer extends Container {
         this.name = AbstractMainContainer.registryName;
         this.buttonsEventManager = new ButtonsEventManager();
         this.messageBox = new MessageBox();
+        if (!RainMan.componentRegistry.has(SpeedControlButtonMobile.registryName)) {
+            RainMan.componentRegistry.add(this.mobileSpeedButton);
+        }
         SoundManager.setPlayStatus(SoundTracks.music, RainMan.settingsStore.shouldPlayAmbientMusic);
         RainMan.settingsStore.setHandleInvokeFreeSpinPlate(this.invokeFreeSpinPlate.bind(this));
         RainMan.settingsStore.setHandleBuyFreeSpinPopupActivatio(this.invokeBuyFreeSpinPlate.bind(this));
@@ -75,6 +79,13 @@ export class AbstractMainContainer extends Container {
      * @returns {Promise<void>} - A promise that resolves when the animation is complete.
      */
     async invokeMysteryWinPlate(_animationName, _popupAnimation, _winType, _amount, _isAdditionalFreeSpins) { }
+    attachMobileSpeedButton(parent) {
+        if (this.mobileSpeedButton.parent) {
+            this.mobileSpeedButton.parent.removeChild(this.mobileSpeedButton);
+        }
+        parent.addChild(this.mobileSpeedButton);
+        this.mobileSpeedButton.adaptToSpeed(RainMan.componentRegistry.getSpeedLevel());
+    }
     /**
      * This function initializes the spines that should be paused when the battery saver is on
      * @protected
@@ -771,7 +782,7 @@ export class AbstractMainContainer extends Container {
      * @returns {RightButtonsMobile} - Returns a new instance of RightButtonsMobile for mobile portrait orientation.
      */
     createRightButtonsMobile() {
-        return new RightButtonsMobile();
+        return new RightButtonsMobile(this.mobileSpeedButton);
     }
     /**
      * Function for creating the left buttons for landscape orientation
@@ -795,7 +806,7 @@ export class AbstractMainContainer extends Container {
      * @returns {MiddleButtons} - Returns a new instance of MiddleButtons for portrait orientation.
      */
     createPortraitPlayButtons() {
-        return new MiddleButtons();
+        return new MiddleButtons(false);
     }
     /**
      * Function for creating the landscape play buttons
@@ -803,7 +814,7 @@ export class AbstractMainContainer extends Container {
      * @returns {MiddleButtons} - Returns a new instance of MiddleButtons for landscape orientation.
      */
     createLandscapePlayButtons() {
-        return new MiddleButtons(true);
+        return new MiddleButtons(true, this.mobileSpeedButton);
     }
     /**
      * This method initializes the components for the current screen ratio.

package/dist/components/buttons/buttonGroups/MiddleButtons.d.ts

@@ -1,6 +1,6 @@
 import { Graphics } from "pixi.js";
 import { ResponsiveContainer } from "../../common";
-import { AutoplayButton, GambleButton, PlusButton, RefreshButton, TakeButton } from "../default";
+import { AutoplayButton, GambleButton, PlusButton, RefreshButton, SpeedControlButtonMobile, TakeButton } from "../default";
 /**
  * Class for managing middle buttons in game (MOBILE ONLY).
  * The class uses {@link AutoplayButton}, {@link PlusButton}, {@link RefreshButton}.
@@ -8,13 +8,14 @@ import { AutoplayButton, GambleButton, PlusButton, RefreshButton, TakeButton } f
  */
 export declare class MiddleButtons extends ResponsiveContainer {
     private landscape;
+    private readonly speedButtonMobile?;
     protected readonly autoplayButton: AutoplayButton;
     protected readonly betButton: PlusButton;
     protected readonly refreshButton: RefreshButton;
     protected readonly positioningFrame: Graphics;
     protected readonly gambleButton: GambleButton;
     protected readonly takeButton: TakeButton;
-    constructor(landscape?: boolean);
+    constructor(landscape?: boolean, speedButtonMobile?: SpeedControlButtonMobile | undefined);
     /**
      * Function for removing children from the registry
      * @public

package/dist/components/buttons/buttonGroups/MiddleButtons.js

@@ -11,26 +11,37 @@ import { REGISTRY } from "../registrynames";
  */
 export class MiddleButtons extends ResponsiveContainer {
     landscape;
+    speedButtonMobile;
     autoplayButton = new AutoplayButton(true);
     betButton = new PlusButton(true);
     refreshButton = new RefreshButton(true);
     positioningFrame = new Graphics();
     gambleButton = new GambleButton(true);
     takeButton = new TakeButton(true);
-    constructor(landscape = false) {
+    constructor(landscape = false, speedButtonMobile) {
         super();
         this.landscape = landscape;
+        this.speedButtonMobile = speedButtonMobile;
         this.name = REGISTRY.middleButtons;
         this.parentLayer = UXLayer;
         const buttons = [this.autoplayButton, this.betButton, this.refreshButton];
         this.addChild(...buttons);
         RainMan.componentRegistry.addMany(buttons);
+        if (this.speedButtonMobile) {
+            this.speedButtonMobile.visible = true;
+            this.speedButtonMobile.scale.set(1);
+            this.speedButtonMobile.adaptToSpeed(RainMan.componentRegistry.getSpeedLevel());
+            this.addChild(this.speedButtonMobile);
+        }
         this.addGambleAndTakeButtons();
         this.positioningFrame.beginFill(0x000000, 0);
         this.positioningFrame.drawRect(0, 0, 800, 250);
         this.addChild(this.positioningFrame);
         this.refreshButton.scale.set(0.75);
         this.autoplayButton.scale.set(0.75);
+        if (this.speedButtonMobile) {
+            this.speedButtonMobile.scale.set(1);
+        }
         this.betButton.scale.set(0.75);
         this.takeButton.scale.set(0.75);
         this.gambleButton.scale.set(0.75);
@@ -63,7 +74,6 @@ export class MiddleButtons extends ResponsiveContainer {
             this.refreshButton,
             this.autoplayButton,
             this.betButton,
-            this.positioningFrame,
             ...(this.gambleButton && RainMan.config.gambleGameEnabled ? [this.gambleButton] : []),
             ...(this.takeButton ? [this.takeButton] : [])
         ]);
@@ -92,15 +102,19 @@ export class MiddleButtons extends ResponsiveContainer {
         const { width, height } = this.positioningFrame;
         this.refreshButton.x = width / 2;
         this.refreshButton.y = height / 2;
+        if (this.speedButtonMobile) {
+            this.speedButtonMobile.x = width / 2;
+            this.speedButtonMobile.y = 150;
+        }
         if (this.landscape) {
             this.betButton.x = width / 2;
-            this.betButton.y = 0;
+            this.betButton.y = -20;
             this.autoplayButton.x = width / 2;
-            this.autoplayButton.y = height;
+            this.autoplayButton.y = height + 30;
         }
         else {
             this.autoplayButton.x = -width;
-            this.autoplayButton.y = 0;
+            this.autoplayButton.y = 50;
             this.betButton.x = width;
             this.betButton.y = height;
         }

package/dist/components/buttons/buttonGroups/RightButtonsMobile.d.ts

@@ -1,17 +1,17 @@
 import { ITextStyle } from "pixi.js";
 import { ResponsiveContainer } from "../../common";
 import { UpdatableTextComponent } from "../../updatable";
-import { InfoButton, NegButton, SpeedControlButton } from "../default";
+import { InfoButton, NegButton, SpeedControlButtonMobile } from "../default";
 /**
  * Buttons for mobile version. It has a current bet and game information button.
  * @augments {ResponsiveContainer}
  */
 export declare class RightButtonsMobile extends ResponsiveContainer {
+    private readonly speedButtonMobile;
     protected readonly infoButton: InfoButton;
     protected readonly negButton: NegButton;
-    protected readonly speedControlButton: SpeedControlButton;
     protected bet: UpdatableTextComponent;
-    constructor();
+    constructor(speedButtonMobile: SpeedControlButtonMobile);
     /**
      * Function for removing children from the registry.
      * @public

package/dist/components/buttons/buttonGroups/RightButtonsMobile.js

@@ -3,7 +3,7 @@ import { UXLayer } from "../../../layers";
 import { RainMan } from "../../../Rainman";
 import { ResponsiveContainer } from "../../common";
 import { UPDATABLE_MODES, UpdatableTextComponent } from "../../updatable";
-import { InfoButton, NegButton, SpeedControlButton } from "../default";
+import { InfoButton, NegButton } from "../default";
 import { COMPONENTS, REGISTRY } from "../registrynames";
 import { MOBILE_BUTTONS_GAP, MOBILE_PANEL_BUTTON_SCALE, MOBILE_X_OFFSET, MOBILE_Y_BOTTOM_OFFSET } from "./constants";
 /**
@@ -11,22 +11,25 @@ import { MOBILE_BUTTONS_GAP, MOBILE_PANEL_BUTTON_SCALE, MOBILE_X_OFFSET, MOBILE_
  * @augments {ResponsiveContainer}
  */
 export class RightButtonsMobile extends ResponsiveContainer {
+    speedButtonMobile;
     infoButton = new InfoButton(true);
     negButton = new NegButton();
-    speedControlButton = new SpeedControlButton();
     bet = new UpdatableTextComponent(COMPONENTS.betText, i18next.t("bet"), UPDATABLE_MODES.money, RainMan.config.mobileFontSize);
-    constructor() {
+    constructor(speedButtonMobile) {
         super(-1);
+        this.speedButtonMobile = speedButtonMobile;
         this.name = REGISTRY.rightButtons;
         this.parentLayer = UXLayer;
         this.negButton.visible = false;
-        this.speedControlButton.visible = false;
         this.infoButton.anchor.set(1, 0.5);
         this.infoButton.scale.set(-MOBILE_PANEL_BUTTON_SCALE);
         this.bet.pivot.set(this.bet.width, this.bet.height / 2);
         this.bet.scale.set(-1);
-        this.addChild(this.infoButton, this.bet);
-        RainMan.componentRegistry.addMany([this.infoButton, this.bet, this.negButton, this.speedControlButton]);
+        this.speedButtonMobile.scale.set(-1);
+        this.speedButtonMobile.x = 100;
+        this.speedButtonMobile.y = 200;
+        this.addChild(this.infoButton, this.bet, this.speedButtonMobile);
+        RainMan.componentRegistry.addMany([this.infoButton, this.bet, this.negButton]);
         this.resize();
     }
     /**
@@ -35,7 +38,7 @@ export class RightButtonsMobile extends ResponsiveContainer {
      * @returns {void}
      */
     removeChildrenFromRegistry() {
-        RainMan.componentRegistry.removeMany([this.infoButton, this.bet, this.negButton, this.speedControlButton]);
+        RainMan.componentRegistry.removeMany([this.infoButton, this.bet, this.negButton]);
     }
     /**
      * Function for repositioning components on mobile screens.

package/dist/components/buttons/default/SpeedControlButtonMobile.d.ts

@@ -0,0 +1,22 @@
+import { SpeedAdapterInterface, SpeedLevel, SpeedLevelDirectory } from "../../../application";
+import { BaseButton, TextureMap } from "../BaseButton";
+/**
+ * Button for speed control {@link SpeedLevel}
+ * It needs following textures:
+ * - turtle - `speed-turtle.png`
+ * - rabbit - `speed-rabbit.png`
+ * - cheetah - `speed-cheetah.png`
+ * @class
+ */
+export declare class SpeedControlButtonMobile extends BaseButton implements SpeedAdapterInterface<TextureMap> {
+    static readonly registryName = "speedControlButtonMobile";
+    readonly speedLevelMapper: SpeedLevelDirectory<TextureMap>;
+    constructor();
+    /**
+     * Change button's texture according to speed level
+     * @public
+     * @param {SpeedLevel} speedLevel - new speed level
+     * @returns {void}
+     */
+    adaptToSpeed(speedLevel: SpeedLevel): void;
+}

package/dist/components/buttons/default/SpeedControlButtonMobile.js

@@ -0,0 +1,51 @@
+import { RainMan } from "../../../Rainman";
+import { getTexture } from "../../../utils";
+import { BaseButton, ButtonStates } from "../BaseButton";
+const createTextureMap = (speedLevel) => {
+    return {
+        [ButtonStates.NORMAL]: getTexture(`${speedLevel}.png`),
+        [ButtonStates.CLICKED]: getTexture(`${speedLevel}-c.png`)
+    };
+};
+const createTextureMapForSpeed = (speedLevel) => {
+    const speedLevelMapper = {
+        slow: createTextureMap("turtle"),
+        normal: createTextureMap("rabbit"),
+        fast: createTextureMap("cheetah")
+    };
+    return speedLevelMapper[speedLevel];
+};
+/**
+ * Button for speed control {@link SpeedLevel}
+ * It needs following textures:
+ * - turtle - `speed-turtle.png`
+ * - rabbit - `speed-rabbit.png`
+ * - cheetah - `speed-cheetah.png`
+ * @class
+ */
+export class SpeedControlButtonMobile extends BaseButton {
+    static registryName = "speedControlButtonMobile";
+    speedLevelMapper;
+    constructor() {
+        super(SpeedControlButtonMobile.registryName, createTextureMapForSpeed(RainMan.settingsStore.currentSpeed));
+        this.speedLevelMapper = {
+            slow: createTextureMap("turtle"),
+            normal: createTextureMap("rabbit"),
+            fast: createTextureMap("cheetah")
+        };
+    }
+    /**
+     * Change button's texture according to speed level
+     * @public
+     * @param {SpeedLevel} speedLevel - new speed level
+     * @returns {void}
+     */
+    adaptToSpeed(speedLevel) {
+        if (RainMan.settingsStore.isTemporarySpeed) {
+            return;
+        }
+        const textureMap = this.speedLevelMapper[speedLevel];
+        this.setTextureMap(textureMap);
+        this.texture = textureMap[ButtonStates.NORMAL];
+    }
+}

package/dist/components/buttons/default/index.d.ts

@@ -9,6 +9,7 @@ export * from "./PlusButton";
 export * from "./RedButton";
 export * from "./RefreshButton";
 export * from "./SpeedControlButton";
+export * from "./SpeedControlButtonMobile";
 export * from "./SpinConfirmationButton";
 export * from "./TakeButton";
 export * from "./VolumeButton";

package/dist/components/buttons/default/index.js

@@ -9,6 +9,7 @@ export * from "./PlusButton";
 export * from "./RedButton";
 export * from "./RefreshButton";
 export * from "./SpeedControlButton";
+export * from "./SpeedControlButtonMobile";
 export * from "./SpinConfirmationButton";
 export * from "./TakeButton";
 export * from "./VolumeButton";

package/dist/connectivity/ConnectionWrapper.d.ts

@@ -11,6 +11,7 @@ export declare class ConnectionWrapper implements SubscribableConnectionWrapper
     private fetchInProgress;
     private lastFetchResponse;
     private lastGambleResponse;
+    private pendingSpinEndPromise;
     private subscribers;
     /**
      * Mapper function for data that comes from the server

package/dist/connectivity/ConnectionWrapper.js

@@ -17,6 +17,7 @@ export class ConnectionWrapper {
     fetchInProgress = false;
     lastFetchResponse = new Map();
     lastGambleResponse = null;
+    pendingSpinEndPromise = null;
     subscribers = [];
     /**
      * Mapper function for data that comes from the server
@@ -83,6 +84,7 @@ export class ConnectionWrapper {
      * @memberof ConnectionWrapper
      */
     async fetchInitData() {
+        this.pendingSpinEndPromise = null;
         this._initData = (await this.fetch({
             action: "init",
             reference: RainMan.config.gameInitReference,
@@ -177,6 +179,9 @@ export class ConnectionWrapper {
         if (typeof this.config?.token === "undefined") {
             throw new Error("Token was not defined");
         }
+        if (this.pendingSpinEndPromise !== null) {
+            await this.pendingSpinEndPromise;
+        }
         const data = await this.fetch({
             action: "spin",
             reference: RainMan.config.gameInitReference,
@@ -186,7 +191,14 @@ export class ConnectionWrapper {
             extra_data
         });
         this._messageHistory.push(data);
-        this.sendEndOfRoundData(data.round_number);
+        const endPromise = this.sendEndOfRoundData(data.round_number);
+        let trackedEndPromise = null;
+        trackedEndPromise = endPromise.finally(() => {
+            if (this.pendingSpinEndPromise === trackedEndPromise) {
+                this.pendingSpinEndPromise = null;
+            }
+        });
+        this.pendingSpinEndPromise = trackedEndPromise;
         return new SpinData(this.config, data);
     }
     /**

package/dist/controllers/AbstractController.js

@@ -1,7 +1,7 @@
 import i18next from "i18next";
 import { sample } from "lodash";
 import { ApiConfig, SoundManager, SoundTracks, SPEED_LEVELS } from "../application";
-import { AbstractFrame, AutoplayButton, BUTTONS, COMPONENTS, FreeSpinButton, MessageBox, RefreshButton, SpeedControlButton } from "../components";
+import { AbstractFrame, AutoplayButton, BUTTONS, COMPONENTS, FreeSpinButton, MessageBox, RefreshButton, SpeedControlButton, SpeedControlButtonMobile } from "../components";
 import { SpinData } from "../connectivity";
 import { gamePhases, PossibleWins } from "../constants";
 import { RainMan } from "../Rainman";
@@ -256,7 +256,10 @@ export class AbstractController {
      * @returns {void}
      */
     disableSpeedButton(shouldBeDisabled) {
-        RainMan.componentRegistry.get(SpeedControlButton.registryName).flipDisabledFlag(shouldBeDisabled);
+        RainMan.componentRegistry.getIfExists(SpeedControlButton.registryName)?.flipDisabledFlag(shouldBeDisabled);
+        RainMan.componentRegistry
+            .getIfExists(SpeedControlButtonMobile.registryName)
+            ?.flipDisabledFlag(shouldBeDisabled);
     }
     /**
      * Function for disabling information buttons
@@ -289,14 +292,11 @@ export class AbstractController {
      */
     handleDisablingButtons(disabled) {
         this.disableBetButtons(disabled ?? this.shouldBetButtonsBeDisabled);
-        if (RainMan.settingsStore.isFreeSpinsPlayEnabled ||
-            RainMan.globals.isSuperBonusGameEnabled ||
-            RainMan.settingsStore.isAutoplayEnabled) {
-            this.disableSpeedButton(false);
-        }
-        else {
-            this.disableSpeedButton(disabled ?? this.shouldButtonsBeDisabled);
-        }
+        const shouldSpeedBeDisabled = !RainMan.settingsStore.isFreeSpinsPlayEnabled &&
+            !RainMan.globals.isSuperBonusGameEnabled &&
+            !RainMan.settingsStore.isAutoplayEnabled &&
+            this.shouldButtonsBeDisabled;
+        this.disableSpeedButton(shouldSpeedBeDisabled);
     }
     /**
      * Function for initializing buttons
@@ -339,10 +339,12 @@ export class AbstractController {
                 this.gamePhase === gamePhases.SPINNING ||
                 this.gamePhase === gamePhases.GAME_SUMMARY);
         }
-        RainMan.componentRegistry.get(SpeedControlButton.registryName).setOnClick(() => {
+        RainMan.componentRegistry.getIfExists(SpeedControlButton.registryName)?.setOnClick(() => {
             RainMan.settingsStore.closeCurrentlyOpenModal?.();
             RainMan.componentRegistry.nextSpeedLevel();
-            this.uiController.messageBox.updateIncentiveText(sample(i18next.t("idleMessages", { returnObjects: true })[RainMan.componentRegistry.getSpeedLevel()]));
+            const speedLevel = RainMan.componentRegistry.getSpeedLevel();
+            this.uiController.updateShownSpeedLevel(speedLevel);
+            this.uiController.messageBox.updateIncentiveText(sample(i18next.t("idleMessages", { returnObjects: true })[speedLevel]));
         });
     }
     /**
@@ -365,6 +367,13 @@ export class AbstractController {
                 }
                 RainMan.settingsStore.handleModalInvocation?.(UI_ITEMS.bet);
             });
+            if (RainMan.componentRegistry.has(SpeedControlButtonMobile.registryName)) {
+                RainMan.componentRegistry.get(SpeedControlButtonMobile.registryName).setOnClick(() => {
+                    RainMan.settingsStore.closeCurrentlyOpenModal?.();
+                    RainMan.componentRegistry.nextSpeedLevel();
+                    this.uiController.messageBox.updateIncentiveText(sample(i18next.t("idleMessages", { returnObjects: true })[RainMan.componentRegistry.getSpeedLevel()]));
+                });
+            }
             return;
         }
         RainMan.componentRegistry.get(BUTTONS.plus).setOnClick(() => {

package/dist/controllers/UiController.d.ts

@@ -149,7 +149,6 @@ export declare class UiController {
     updateShownPossibleWin(): void;
     /**
      * Shows game pays in a bottom panel, if exists
-     * @param amount
      * @public
      * @returns {void}
      */

package/dist/controllers/UiController.js

@@ -1,5 +1,5 @@
 import { round } from "lodash";
-import { COMPONENTS, MessageBox, SpeedControlButton } from "../components";
+import { COMPONENTS, MessageBox, SpeedControlButton, SpeedControlButtonMobile } from "../components";
 import { RainMan } from "../Rainman";
 import { ceilToDecimal } from "../utils";
 /**
@@ -181,8 +181,12 @@ export class UiController {
      * @returns {void}
      */
     updateShownSpeedLevel(currentSpeed) {
-        RainMan.componentRegistry.get(SpeedControlButton.registryName).adaptToSpeed(currentSpeed);
-        RainMan.componentRegistry.get(SpeedControlButton.registryName).forceTextureUpdate();
+        const speedButton = RainMan.componentRegistry.getIfExists(SpeedControlButton.registryName);
+        const mobileSpeedButton = RainMan.componentRegistry.getIfExists(SpeedControlButtonMobile.registryName);
+        speedButton?.adaptToSpeed(currentSpeed);
+        speedButton?.forceTextureUpdate();
+        mobileSpeedButton?.adaptToSpeed(currentSpeed);
+        mobileSpeedButton?.forceTextureUpdate();
     }
     /**
      * Function for updating shown balance
@@ -216,7 +220,6 @@ export class UiController {
     }
     /**
      * Shows game pays in a bottom panel, if exists
-     * @param amount
      * @public
      * @returns {void}
      */

package/dist/utils/common/sound.js

@@ -16,15 +16,16 @@ const interruptedAudioResume = () => {
     window.addEventListener("touchend", resumeAudioOnInterruption, { once: true, passive: true });
 };
 /**
- * Pauses audio when the page goes to the background.
+ * Clears pending foreground recovery when the page goes to the background.
+ * Pixi handles the actual pause state through its WebAudio auto-pause flow.
  * @returns {void}
  */
-const pauseAudio = () => {
+const prepareAudioForPageHide = () => {
     isResumingAudio = false;
     shouldResumeAudioOnInterruption = false;
     removeInterruptedAudioResumeListeners();
     if (RainMan.settingsStore.isSoundEnabled()) {
-        SoundManager.pauseSoundsForPageHide();
+        SoundManager.captureAmbientPlaybackPositionForPageHide();
     }
 };
 /**
@@ -71,19 +72,19 @@ function resumeAudioOnInterruption() {
  */
 const handleVisibilityChange = () => {
     if (document.hidden) {
-        pauseAudio();
+        prepareAudioForPageHide();
         return;
     }
-    interruptedAudioResume();
+    resumeAudio();
 };
 /**
  * Sets up audio states for tab switches and iOS app interruptions.
  * @returns {void}
  */
 export const loadSoundsOnTabChange = () => {
-    sound.disableAutoPause = true;
+    sound.disableAutoPause = false;
     document.addEventListener("visibilitychange", handleVisibilityChange);
-    window.addEventListener("pagehide", () => pauseAudio());
+    window.addEventListener("pagehide", () => prepareAudioForPageHide());
     window.addEventListener("pageshow", () => resumeAudio());
     window.addEventListener("focus", () => resumeAudio());
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pixi-rainman-game-engine",
-    "version": "0.3.42",
+    "version": "0.3.43b",
     "description": "This repository contains all of the mechanics that used in rainman games.",
     "main": "./dist/index.js",
     "module": "./dist/index.js",