mini-arcade-core 0.9.3__tar.gz → 0.9.5__tar.gz

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.5}/PKG-INFO

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

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.5}/pyproject.toml

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

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.5}/src/mini_arcade_core/__init__.py

@@ -8,6 +8,7 @@ from __future__ import annotations
 import logging
 from importlib.metadata import PackageNotFoundError, version
 
+from .autoreg import register_scene
 from .backend import Backend, Event, EventType
 from .boundaries2d import (
     RectKinematic,
@@ -78,6 +79,7 @@ __all__ = [
     "Key",
     "keymap",
     "SceneRegistry",
+    "register_scene",
 ]
 
 PACKAGE_NAME = "mini-arcade-core"  # or whatever is in your pyproject.toml

mini_arcade_core-0.9.5/src/mini_arcade_core/autoreg.py

@@ -0,0 +1,39 @@
+"""
+Autoregistration utilities for mini arcade core.
+Allows automatic registration of Scene classes via decorators.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Dict, Type
+
+if TYPE_CHECKING:
+    from .scene import Scene
+
+_AUTO: Dict[str, Type["Scene"]] = {}
+
+
+def register_scene(scene_id: str):
+    """Decorator to mark and register a Scene class under an id."""
+
+    def deco(cls: Type["Scene"]):
+        _AUTO[scene_id] = cls
+        setattr(cls, "__scene_id__", scene_id)
+        return cls
+
+    return deco
+
+
+def snapshot() -> Dict[str, Type["Scene"]]:
+    """
+    Copy of current catalog (useful for tests).
+
+    :return: A copy of the current scene catalog.
+    :rtype: Dict[str, Type["Scene"]]
+    """
+    return dict(_AUTO)
+
+
+def clear():
+    """Clear the current catalog (useful for tests)."""
+    _AUTO.clear()

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.5}/src/mini_arcade_core/registry.py

@@ -5,9 +5,13 @@ Allows registering and creating scenes by string IDs.
 
 from __future__ import annotations
 
+import importlib
+import pkgutil
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Dict, Protocol
 
+from .autoreg import snapshot
+
 if TYPE_CHECKING:
     from mini_arcade_core.game import Game
     from mini_arcade_core.scene import Scene
@@ -29,7 +33,7 @@ class SceneRegistry:
 
     _factories: Dict[str, SceneFactory]
 
-    def register(self, scene_id: str, factory: SceneFactory) -> None:
+    def register(self, scene_id: str, factory: SceneFactory):
         """
         Register a scene factory under a given scene ID.
 
@@ -41,6 +45,22 @@ class SceneRegistry:
         """
         self._factories[scene_id] = factory
 
+    def register_cls(self, scene_id: str, scene_cls: type["Scene"]):
+        """
+        Register a Scene class under a given scene ID.
+
+        :param scene_id: The string ID for the scene.
+        :type scene_id: str
+
+        :param scene_cls: The Scene class to register.
+        :type scene_cls: type["Scene"]
+        """
+
+        def return_factory(game: "Game") -> "Scene":
+            return scene_cls(game)
+
+        self.register(scene_id, return_factory)
+
     def create(self, scene_id: str, game: "Game") -> "Scene":
         """
         Create a scene instance using the registered factory for the given scene ID.
@@ -60,3 +80,33 @@ class SceneRegistry:
             return self._factories[scene_id](game)
         except KeyError as e:
             raise KeyError(f"Unknown scene_id={scene_id!r}") from e
+
+    def load_catalog(self, catalog: Dict[str, type["Scene"]]):
+        """
+        Load a catalog of Scene classes into the registry.
+
+        :param catalog: A dictionary mapping scene IDs to Scene classes.
+        :type catalog: Dict[str, type["Scene"]]
+        """
+        for scene_id, cls in catalog.items():
+            self.register_cls(scene_id, cls)
+
+    def discover(self, package: str) -> "SceneRegistry":
+        """
+        Import all modules in a package so @scene decorators run.
+
+        :param package: The package name to scan for scene modules.
+        :type package: str
+
+        :return: The SceneRegistry instance (for chaining).
+        :rtype: SceneRegistry
+        """
+        pkg = importlib.import_module(package)
+        if not hasattr(pkg, "__path__"):
+            return self  # not a package
+
+        for mod in pkgutil.walk_packages(pkg.__path__, pkg.__name__ + "."):
+            importlib.import_module(mod.name)
+
+        self.load_catalog(snapshot())
+        return self

{mini_arcade_core-0.9.3 → mini_arcade_core-0.9.5}/src/mini_arcade_core/ui/menu.py

@@ -46,6 +46,7 @@ class MenuStyle:
     line_height: int = 28
     title_color: Color = (255, 255, 255)
     title_spacing: int = 18
+    title_margin_bottom: int = 20
 
     # Scene background (solid)
     background_color: Color | None = None  # e.g. BACKGROUND
@@ -75,6 +76,11 @@ class MenuStyle:
     hint_color: Color = (200, 200, 200)
     hint_margin_bottom: int = 50
 
+    # Font sizes (not used directly here, but for reference)
+    title_font_size = 44
+    hint_font_size = 14
+    item_font_size = 24
+
 
 # pylint: enable=too-many-instance-attributes
 
@@ -165,13 +171,15 @@ class Menu:
         title_h = 0
 
         if self.title:
-            tw, th = surface.measure_text(self.title)
+            tw, th = surface.measure_text(
+                self.title, self.style.title_font_size
+            )
             max_w = max(max_w, tw)
             title_h = th
 
         # Items
         for it in self.items:
-            w, _ = surface.measure_text(it.label)
+            w, _ = surface.measure_text(it.label, self.style.item_font_size)
             max_w = max(max_w, w)
 
         items_h = len(self.items) * self.style.line_height
@@ -235,8 +243,13 @@ class Menu:
                 cursor_y,
                 self.title,
                 color=self.style.title_color,
+                font_size=self.style.title_font_size,
+            )
+            cursor_y += (
+                title_h
+                + self.style.title_spacing
+                + self.style.title_margin_bottom
             )
-            cursor_y += title_h + self.style.title_spacing
 
         if self.style.button_enabled:
             self._draw_buttons(surface, x_center, cursor_y)
@@ -251,11 +264,10 @@ class Menu:
                 vh - self.style.hint_margin_bottom,
                 self.style.hint,
                 color=self.style.hint_color,
+                font_size=self.style.hint_font_size,
             )
 
-    def _draw_text_items(
-        self, surface: Backend, x_center: int, cursor_y: int
-    ) -> None:
+    def _draw_text_items(self, surface: Backend, x_center: int, cursor_y: int):
         for i, item in enumerate(self.items):
             color = (
                 self.style.selected
@@ -268,13 +280,12 @@ class Menu:
                 cursor_y + i * self.style.line_height,
                 item.label,
                 color=color,
+                font_size=self.style.item_font_size,
             )
 
     # Justification: Local variables for layout calculations
     # pylint: disable=too-many-locals
-    def _draw_buttons(
-        self, surface: Backend, x_center: int, cursor_y: int
-    ) -> None:
+    def _draw_buttons(self, surface: Backend, x_center: int, cursor_y: int):
         # Determine button width: fixed or auto-fit
         if self.style.button_width is not None:
             bw = self.style.button_width
@@ -354,10 +365,16 @@ class Menu:
 
         content_h = items_h
         if self.title:
-            content_h += title_h + self.style.title_spacing
+            content_h += (
+                title_h
+                + self.style.title_spacing
+                + self.style.title_margin_bottom
+            )
 
         return max_w, content_h, title_h
 
+    # Justification: Many arguments for text drawing utility
+    # pylint: disable=too-many-arguments
     @staticmethod
     def _draw_text_center_x(
         surface: Backend,
@@ -366,6 +383,11 @@ class Menu:
         text: str,
         *,
         color: Color,
-    ) -> None:
-        w, _ = surface.measure_text(text)
-        surface.draw_text(x_center - (w // 2), y, text, color=color)
+        font_size: int | None = None,
+    ):
+        w, _ = surface.measure_text(text, font_size=font_size)
+        surface.draw_text(
+            x_center - (w // 2), y, text, color=color, font_size=font_size
+        )
+
+    # pylint: enable=too-many-arguments