mini-arcade-core 0.7.1__tar.gz → 0.7.2__tar.gz

{mini_arcade_core-0.7.1 → mini_arcade_core-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-arcade-core
-Version: 0.7.1
+Version: 0.7.2
 Summary: Tiny scene-based game loop core for small arcade games.
 License: Copyright (c) 2025 Santiago Rincón
            

{mini_arcade_core-0.7.1 → mini_arcade_core-0.7.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "mini-arcade-core"
-version = "0.7.1"
+version = "0.7.2"
 description = "Tiny scene-based game loop core for small arcade games."
 authors = [
     { name = "Santiago Rincon", email = "rincores@gmail.com" },

mini_arcade_core-0.7.2/src/mini_arcade_core/scene.py

@@ -0,0 +1,69 @@
+"""
+Base class for game scenes (states/screens).
+"""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Callable, List
+
+from mini_arcade_core.backend import Backend
+
+from .game import Game
+
+OverlayFunc = Callable[[Backend], None]
+
+
+class Scene(ABC):
+    """Base class for game scenes (states/screens)."""
+
+    def __init__(self, game: Game):
+        """
+        :param game: Reference to the main Game object.
+        :type game: Game
+        """
+        self.game = game
+        # overlays drawn on top of the scene
+        self._overlays: List[OverlayFunc] = []
+
+    def add_overlay(self, overlay: OverlayFunc) -> None:
+        """Register an overlay (drawn every frame, after entities)."""
+        self._overlays.append(overlay)
+
+    def remove_overlay(self, overlay: OverlayFunc) -> None:
+        if overlay in self._overlays:
+            self._overlays.remove(overlay)
+
+    def clear_overlays(self) -> None:
+        self._overlays.clear()
+
+    def draw_overlays(self, surface: Backend) -> None:
+        """Call all overlays. Scenes should call this at the end of draw()."""
+        for overlay in self._overlays:
+            overlay(surface)
+
+    @abstractmethod
+    def on_enter(self):
+        """Called when the scene becomes active."""
+
+    @abstractmethod
+    def on_exit(self):
+        """Called when the scene is replaced."""
+
+    @abstractmethod
+    def handle_event(self, event: object):
+        """Handle input / events (e.g. pygame.Event)."""
+
+    @abstractmethod
+    def update(self, dt: float):
+        """Update game logic. ``dt`` is the delta time in seconds."""
+
+    @abstractmethod
+    def draw(self, surface: object):
+        """Render to the main surface."""
+
+    def draw(self, surface: object):
+        """Render to the main surface."""
+
+    def draw(self, surface: object):
+        """Render to the main surface."""

mini_arcade_core-0.7.1/src/mini_arcade_core/scene.py

@@ -1,40 +0,0 @@
-"""
-Base class for game scenes (states/screens).
-"""
-
-from __future__ import annotations
-
-from abc import ABC, abstractmethod
-
-from .game import Game
-
-
-class Scene(ABC):
-    """Base class for game scenes (states/screens)."""
-
-    def __init__(self, game: Game):
-        """
-        :param game: Reference to the main Game object.
-        :type game: Game
-        """
-        self.game = game
-
-    @abstractmethod
-    def on_enter(self):
-        """Called when the scene becomes active."""
-
-    @abstractmethod
-    def on_exit(self):
-        """Called when the scene is replaced."""
-
-    @abstractmethod
-    def handle_event(self, event: object):
-        """Handle input / events (e.g. pygame.Event)."""
-
-    @abstractmethod
-    def update(self, dt: float):
-        """Update game logic. ``dt`` is the delta time in seconds."""
-
-    @abstractmethod
-    def draw(self, surface: object):
-        """Render to the main surface."""