Add signal for last Ayah reached in navigation

Introduced a lastAyahReached signal in NavigationManager and connected it to QuranInterface to handle actions when the last Ayah is reached. This enables automatic progression and play/pause toggling when the end of a range is encountered.

Author: QaisAlrefai

ui/quran_interface.py

@@ -66,6 +66,7 @@ def __init__(self, title):
         Globals.effects_manager = SoundEffectPlayer("Audio/sounds")
 
         self.toolbar = AudioToolBar(self)
+        self.toolbar.navigation.lastAyahReached.connect(self.on_last_ayah_reached)
         self.menu_bar = MenuBar(self)
         self.setMenuBar(self.menu_bar)
         self.addToolBar(self.toolbar)
@@ -659,3 +660,8 @@ def OnRandomMessages(self, event):
         logger.debug("Random message dialog opened.")
         info_dialog.exec()
         logger.debug("Random message dialog closed.")
+
+    def on_last_ayah_reached(self):
+        logger.debug("Last Ayah reached signal received in QuranInterface.")
+        self.OnNext()
+        self.toolbar.toggle_play_pause()

ui/widgets/toolbar.py

@@ -1,7 +1,7 @@
 import time
 from typing import Optional
 from PyQt6.QtWidgets import QToolBar, QPushButton, QSlider, QMessageBox
-from PyQt6.QtCore import Qt, QThread, pyqtSignal, QTimer
+from PyQt6.QtCore import Qt, QThread, pyqtSignal, QTimer, QObject
 from core_functions.quran.quran_manager import QuranManager
 from core_functions.Reciters import AyahReciter
 from utils.audio_player import AyahPlayer
@@ -72,8 +72,10 @@ def set_audio_url(self, url: str, send_error_signal: bool = True):
         self.wait()        
 
 
-class NavigationManager:
+class NavigationManager(QObject):
+    lastAyahReached = pyqtSignal()
     def __init__(self, parent, quran_manager: QuranManager):
+        super().__init__(parent)
         logger.debug("Initializing NavigationManager.")
         self.parent = parent
         self.quran_manager = quran_manager
@@ -121,6 +123,7 @@ def navigate(self, direction: str) -> bool:
             else:
                 self.current_ayah = self.ayah_range[self.current_surah]["max_ayah"]
                 logger.debug("Reached the last Ayah in the page.")
+                self.lastAyahReached.emit()
                 return False
         elif direction == "previous" and self.current_ayah < self.ayah_range[self.current_surah]["min_ayah"]:
             if self.current_surah - 1 in self.ayah_range: