tilemap-parser 3.0.0__tar.gz → 3.1.0__tar.gz

{tilemap_parser-3.0.0 → tilemap_parser-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilemap-parser
-Version: 3.0.0
+Version: 3.1.0
 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-3.0.0 → tilemap_parser-3.1.0}/pyproject.toml

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

{tilemap_parser-3.0.0 → tilemap_parser-3.1.0}/src/tilemap_parser/runtime/object_collision.py

@@ -2,7 +2,7 @@
 Object-to-object collision detection runtime.
 
 Provides a protocol-based interface, shape dispatch, layer filtering,
-a multi-object manager, and collision hit helpers for separation/resolve.
+a multi-object manager, and collision hit helpers for separation/resolve/slide.
 """
 
 from __future__ import annotations
@@ -72,6 +72,30 @@ class CollisionHit:
         self.object_b.x += sep_x
         self.object_b.y += sep_y
 
+    def slide_velocity(self, vx: float, vy: float) -> tuple[float, float]:
+        """Project velocity along the collision surface (slide response).
+
+        Removes the component of (vx, vy) that is along *self.normal*,
+        leaving only the tangential component.  Intended for the moving
+        object passed as *object_a* — when that object moves into
+        *object_b* the approach component is stripped so the object slides
+        along the surface instead of penetrating.
+
+        If the velocity is already parallel to the surface or points away
+        from *object_b* the original velocity is returned unchanged.
+
+        Args:
+            vx: X component of velocity (object_a's velocity)
+            vy: Y component of velocity
+
+        Returns:
+            (slide_x, slide_y) — velocity projected onto the surface
+        """
+        dot = vx * self.normal[0] + vy * self.normal[1]
+        if dot > 0:
+            return (vx - self.normal[0] * dot, vy - self.normal[1] * dot)
+        return (vx, vy)
+
     def involves(self, obj: ICollidableObject) -> bool:
         """Check if this hit involves the given object."""
         return self.object_a is obj or self.object_b is obj

{tilemap_parser-3.0.0 → tilemap_parser-3.1.0}/src/tilemap_parser.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilemap-parser
-Version: 3.0.0
+Version: 3.1.0
 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-3.0.0 → tilemap_parser-3.1.0}/tests/test_object_collision.py

@@ -338,6 +338,73 @@ class TestCollisionHitHelpers:
         with pytest.raises(ValueError, match="not part"):
             hit.other(c)
 
+    # ------------------------------------------------------------------
+    # slide_velocity
+    # ------------------------------------------------------------------
+    def test_slide_head_on(self):
+        """Directly into surface → zero tangential motion."""
+        hit = CollisionHit(
+            object_a=None, object_b=None,
+            normal=(1.0, 0.0), depth=5.0,
+        )
+        sx, sy = hit.slide_velocity(10.0, 0.0)
+        assert sx == 0.0
+        assert sy == 0.0
+
+    def test_slide_angled(self):
+        """Diagonal into surface → only perpendicular component removed."""
+        hit = CollisionHit(
+            object_a=None, object_b=None,
+            normal=(1.0, 0.0), depth=5.0,
+        )
+        sx, sy = hit.slide_velocity(10.0, 5.0)
+        assert sx == 0.0  # x component fully removed
+        assert sy == 5.0  # y component preserved (tangential)
+
+    def test_slide_parallel(self):
+        """Velocity along the surface → unchanged."""
+        hit = CollisionHit(
+            object_a=None, object_b=None,
+            normal=(0.0, 1.0), depth=5.0,
+        )
+        sx, sy = hit.slide_velocity(10.0, 0.0)
+        assert sx == 10.0
+        assert sy == 0.0
+
+    def test_slide_away(self):
+        """Velocity pointing away from surface → unchanged."""
+        hit = CollisionHit(
+            object_a=None, object_b=None,
+            normal=(1.0, 0.0), depth=5.0,
+        )
+        sx, sy = hit.slide_velocity(-10.0, 0.0)
+        assert sx == -10.0
+        assert sy == 0.0
+
+    def test_slide_zero(self):
+        """Zero velocity → zero."""
+        hit = CollisionHit(
+            object_a=None, object_b=None,
+            normal=(1.0, 0.0), depth=5.0,
+        )
+        sx, sy = hit.slide_velocity(0.0, 0.0)
+        assert sx == 0.0
+        assert sy == 0.0
+
+    def test_slide_diagonal_normal(self):
+        """Normal at 45°, velocity into surface → slide along surface."""
+        import math
+        n = (1.0 / math.sqrt(2), 1.0 / math.sqrt(2))
+        hit = CollisionHit(
+            object_a=None, object_b=None,
+            normal=n, depth=5.0,
+        )
+        sx, sy = hit.slide_velocity(1.0, 0.0)
+        # Dot = 1/sqrt(2) ≈ 0.707
+        # slide = (1, 0) - (0.707, 0.707) * 0.707 = (1 - 0.5, -0.5)
+        assert sx == pytest.approx(0.5)
+        assert sy == pytest.approx(-0.5)
+
 
 # ---------------------------------------------------------------------------
 # Capsule collision