tilemap-parser 4.2.2__tar.gz → 4.2.3__tar.gz

{tilemap_parser-4.2.2 → tilemap_parser-4.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilemap-parser
-Version: 4.2.2
+Version: 4.2.3
 Summary: Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and collision detection runtime.
 Author: tilemap parser contributors
 License:                     GNU GENERAL PUBLIC LICENSE

{tilemap_parser-4.2.2 → tilemap_parser-4.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tilemap-parser"
-version = "4.2.2"
+version = "4.2.3"
 description = "Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and collision detection runtime."
 readme = "README.md"
 requires-python = ">=3.10"

{tilemap_parser-4.2.2 → tilemap_parser-4.2.3}/src/tilemap_parser/__init__.py

@@ -20,6 +20,7 @@ __all__ = [
     "CollisionPolygon",
     "CollisionResult",
     "CollisionRunner",
+    "ICollidable",
     "ICollidableObject",
     "ICollidableSprite",
     "LayerRenderStats",

{tilemap_parser-4.2.2 → tilemap_parser-4.2.3}/src/tilemap_parser/runtime/__init__.py

@@ -18,6 +18,7 @@ from .tile_collision import (
     MovementMode,
     rect_vs_tilemap,
 )
+from .protocols import ICollidable
 from .map_loader import TilemapData, load_map
 from .object_collision import (
     CollisionHit,
@@ -45,6 +46,7 @@ __all__ = [
     "CollisionHit",
     "CollisionResult",
     "CollisionRunner",
+    "ICollidable",
     "ICollidableObject",
     "ICollidableSprite",
     "LayerRenderStats",

{tilemap_parser-4.2.2 → tilemap_parser-4.2.3}/src/tilemap_parser/runtime/object_collision.py

@@ -33,27 +33,20 @@ from ..utils.geometry import (
     rect_vs_circle,
     rect_vs_rect,
 )
+from .protocols import ICollidable
 
 
-class ICollidableObject(Protocol):
+class ICollidableObject(ICollidable, Protocol):
     """
     Protocol for objects that can collide.
 
-    Required attributes:
-        x: World X position
-        y: World Y position
-        collision_shape: Shape for collision
-            (RectangleShape, CircleShape, CapsuleShape, or CollisionPolygon)
+    All required attributes (x, y, collision_shape) are inherited from ICollidable.
 
     Optional attributes (with defaults):
         collision_layer: Layer this object is on (default: 1)
         collision_mask: Layers to collide with (default: 0xFFFFFFFF)
     """
 
-    x: float
-    y: float
-    collision_shape: Union[RectangleShape, CircleShape, CapsuleShape, CollisionPolygon]
-
 
 @dataclass(slots=True)
 class CollisionHit:

tilemap_parser-4.2.3/src/tilemap_parser/runtime/protocols.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from typing import Protocol, Union
+
+from ..parser.collision import (
+    CapsuleShape,
+    CircleShape,
+    CollisionPolygon,
+    RectangleShape,
+)
+
+
+class ICollidable(Protocol):
+    """Base protocol for anything with a world position and collision shape.
+
+    This is the minimal interface for participating in collision detection.
+    All collidable protocols (ICollidableSprite, ICollidableObject) extend this.
+
+    Required attributes:
+        x (float): World X position
+        y (float): World Y position
+        collision_shape: Shape used for collision detection
+            (RectangleShape, CircleShape, CapsuleShape, or CollisionPolygon)
+    """
+
+    x: float
+    y: float
+    collision_shape: Union[RectangleShape, CircleShape, CapsuleShape, CollisionPolygon]

{tilemap_parser-4.2.2 → tilemap_parser-4.2.3}/src/tilemap_parser/runtime/tile_collision.py

@@ -23,12 +23,13 @@ from ..parser.collision import (
     RectangleShape,
     TilesetCollision,
 )
+from .protocols import ICollidable
 
 Point = Tuple[float, float]
 Vector2 = Tuple[float, float]
 
 
-class ICollidableSprite(Protocol):
+class ICollidableSprite(ICollidable, Protocol):
     """
     Interface that any sprite/character class must implement to use collision runners.
 
@@ -303,7 +304,7 @@ def _circle_polygon_collision_offset(
     return False
 
 
-def get_shape_bounds(sprite: ICollidableSprite) -> Tuple[float, float, float, float]:
+def get_shape_bounds(sprite: ICollidable) -> Tuple[float, float, float, float]:
     """Get AABB bounds for sprite (left, top, right, bottom)"""
     shape = sprite.collision_shape
     if isinstance(shape, RectangleShape):
@@ -328,7 +329,7 @@ def get_shape_bounds(sprite: ICollidableSprite) -> Tuple[float, float, float, fl
 
 
 def check_sprite_polygon_collision(
-    sprite: ICollidableSprite, polygon: CollisionPolygon
+    sprite: ICollidable, polygon: CollisionPolygon
 ) -> bool:
     """Check if sprite collides with a world-space polygon (legacy / public API)."""
     shape = sprite.collision_shape
@@ -349,7 +350,7 @@ def check_sprite_polygon_collision(
 
 
 def _check_sprite_polygon_offset(
-    sprite: ICollidableSprite,
+    sprite: ICollidable,
     polygon: CollisionPolygon,
     ox: float,
     oy: float,
@@ -489,7 +490,7 @@ class CollisionRunner:
         self,
         tileset_collision: TilesetCollision,
         tile_map: dict,
-        sprite: ICollidableSprite,
+        sprite: ICollidable,
         margin: int = 1,
     ) -> List[CollisionPolygon]:
         """
@@ -529,7 +530,7 @@ class CollisionRunner:
 
     def _collides_at(
         self,
-        sprite: ICollidableSprite,
+        sprite: ICollidable,
         tileset_collision: TilesetCollision,
         tile_map: dict,
         margin: int = 1,
@@ -567,7 +568,7 @@ class CollisionRunner:
 
     def _first_colliding_shape(
         self,
-        sprite: ICollidableSprite,
+        sprite: ICollidable,
         tileset_collision: TilesetCollision,
         tile_map: dict,
         margin: int = 1,
@@ -603,7 +604,7 @@ class CollisionRunner:
 
     def move_and_slide(
         self,
-        sprite: ICollidableSprite,
+        sprite: ICollidable,
         tileset_collision: TilesetCollision,
         tile_map: dict,
         delta_x: float,
@@ -729,7 +730,7 @@ class CollisionRunner:
 
     def _get_collision_normal_from_motion(
         self,
-        sprite: ICollidableSprite,
+        sprite: ICollidable,
         polygon: CollisionPolygon,
         ox: float,
         oy: float,
@@ -1745,7 +1746,7 @@ class CollisionRunner:
 
     def move_rpg(
         self,
-        sprite: ICollidableSprite,
+        sprite: ICollidable,
         tileset_collision: TilesetCollision,
         tile_map: dict,
         delta_x: float,
@@ -1814,7 +1815,7 @@ class CollisionRunner:
 
     def move(
         self,
-        sprite: ICollidableSprite,
+        sprite: ICollidable,
         tileset_collision: TilesetCollision,
         tile_map: dict,
         delta_x: float = 0.0,

{tilemap_parser-4.2.2 → tilemap_parser-4.2.3}/src/tilemap_parser.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilemap-parser
-Version: 4.2.2
+Version: 4.2.3
 Summary: Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and collision detection runtime.
 Author: tilemap parser contributors
 License:                     GNU GENERAL PUBLIC LICENSE

{tilemap_parser-4.2.2 → tilemap_parser-4.2.3}/src/tilemap_parser.egg-info/SOURCES.txt

@@ -24,6 +24,7 @@ src/tilemap_parser/runtime/map_loader.py
 src/tilemap_parser/runtime/map_object.py
 src/tilemap_parser/runtime/object_collision.py
 src/tilemap_parser/runtime/particles.py
+src/tilemap_parser/runtime/protocols.py
 src/tilemap_parser/runtime/renderer.py
 src/tilemap_parser/runtime/tile_collision.py
 src/tilemap_parser/utils/__init__.py