mini-arcade-core 0.7.1__py3-none-any.whl → 0.7.2__py3-none-any.whl

mini_arcade_core/scene.py

@@ -5,9 +5,14 @@ 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)."""
@@ -18,6 +23,24 @@ class Scene(ABC):
         :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):
@@ -38,3 +61,9 @@ class Scene(ABC):
     @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.dist-info → mini_arcade_core-0.7.2.dist-info}/METADATA

@@ -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.dist-info → mini_arcade_core-0.7.2.dist-info}/RECORD

@@ -2,8 +2,8 @@ mini_arcade_core/__init__.py,sha256=0PFa04KRSY3kT8YoD24zfFt92HYfrk6QrH8IlHbmeo4,
 mini_arcade_core/backend.py,sha256=DZUEO4zMlXIk3ctD9ZNqvgOo7n_ZKpC6x--hIede_YY,2946
 mini_arcade_core/entity.py,sha256=mAkedH0j14giBQFRpQjaym46uczbQDln6nbxy0WFAqU,1077
 mini_arcade_core/game.py,sha256=yRMy0IJVB_yuF9P_SKjcxJG0YVMs52khVFLomSUeVw8,3935
-mini_arcade_core/scene.py,sha256=FEtywrnOBU8p0-t8oWGDELYBRRXOs4-Phe0dF7iSjKI,927
-mini_arcade_core-0.7.1.dist-info/METADATA,sha256=KNIe3xKd_vY9eKTYdg6CujZL93-uznlqVXQaU3jl9M4,8296
-mini_arcade_core-0.7.1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mini_arcade_core-0.7.1.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
-mini_arcade_core-0.7.1.dist-info/RECORD,,
+mini_arcade_core/scene.py,sha256=i8lmcTZ1IPcM-NDwVvKrvjCMcFVq1aD5nacOvU0ZONU,1883
+mini_arcade_core-0.7.2.dist-info/METADATA,sha256=UNpZCJ0APedKmetmYqtENHGlSIgW2uDjsvr2eYxlidI,8296
+mini_arcade_core-0.7.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mini_arcade_core-0.7.2.dist-info/licenses/LICENSE,sha256=3lHAuV0584cVS5vAqi2uC6GcsVgxUijvwvtZckyvaZ4,1096
+mini_arcade_core-0.7.2.dist-info/RECORD,,