tilemap-parser 3.1.15__tar.gz → 3.1.16__tar.gz

{tilemap_parser-3.1.15 → tilemap_parser-3.1.16}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tilemap-parser"
-version = "3.1.15"
+version = "3.1.16"
 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.1.15 → tilemap_parser-3.1.16}/src/tilemap_parser/runtime/tile_collision.py

@@ -441,6 +441,7 @@ class CollisionRunner:
         self.gravity = 800.0
         self.max_fall_speed = 600.0
         self.jump_strength = -400.0
+        self.horizontal_speed = 200.0
 
         self.ground_snap_tolerance = 2.0
         self.step_height = 4.0
@@ -797,6 +798,7 @@ class CollisionRunner:
         dt: float,
         input_x: float = 0.0,
         jump_pressed: bool = False,
+        velocity: Optional[Vector2] = None,
     ) -> CollisionResult:
         """
         Move sprite with platformer physics (gravity, jumping).
@@ -808,8 +810,11 @@ class CollisionRunner:
             tileset_collision: Tileset collision data
             tile_map: Dictionary mapping (tile_x, tile_y) to tile_id
             dt: Delta time in seconds
-            input_x: Horizontal input (-1 to 1)
-            jump_pressed: Whether jump button is pressed
+            input_x: Horizontal input (-1 to 1) for built-in movement
+            jump_pressed: Whether jump button is pressed for built-in movement
+            velocity: Optional explicit velocity (vx, vy). When provided, the
+                runner skips built-in input/gravity/jump velocity calculation
+                and only resolves collision for that velocity.
 
         Returns:
             CollisionResult with final position and collision info
@@ -824,15 +829,19 @@ class CollisionRunner:
         result.final_x = sprite.x
         result.final_y = sprite.y
 
-        if not getattr(sprite, "on_ground", False):
-            sprite.vy += self.gravity * dt
-            if sprite.vy > self.max_fall_speed:
-                sprite.vy = self.max_fall_speed
+        if velocity is not None:
+            sprite.vx = velocity[0]
+            sprite.vy = velocity[1]
+        else:
+            if not getattr(sprite, "on_ground", False):
+                sprite.vy += self.gravity * dt
+                if sprite.vy > self.max_fall_speed:
+                    sprite.vy = self.max_fall_speed
 
-        if jump_pressed and getattr(sprite, "on_ground", False):
-            sprite.vy = self.jump_strength
+            if jump_pressed and getattr(sprite, "on_ground", False):
+                sprite.vy = self.jump_strength
 
-        sprite.vx = input_x * 200.0
+            sprite.vx = input_x * self.horizontal_speed
 
         delta_x = sprite.vx * dt
         delta_y = sprite.vy * dt
@@ -1325,6 +1334,7 @@ class CollisionRunner:
         dt: float,
         input_x: float = 0.0,
         jump_pressed: bool = False,
+        velocity: Optional[Vector2] = None,
     ) -> CollisionResult:
         """
         Slope-aware platformer movement.
@@ -1360,6 +1370,13 @@ class CollisionRunner:
             jump_pressed:
                 True if jump was pressed during this frame.
 
+            velocity:
+                Optional explicit velocity (vx, vy). When provided, the runner
+                skips built-in input/gravity/jump velocity calculation and only
+                resolves collision for that velocity. This is the preferred
+                path for dash, knockback, wind, moving-platform carry, or a
+                custom controller.
+
         Returns:
             CollisionResult describing the resolved movement and collision
             state after simulation.
@@ -1381,18 +1398,25 @@ class CollisionRunner:
         was_on_ground = getattr(sprite, "on_ground", False)
         jumped = False
 
-        if jump_pressed and was_on_ground:
-            sprite.vy = self.jump_strength
-            sprite.on_ground = False
-            jumped = True
-        elif not was_on_ground:
-            sprite.vy += self.gravity * dt
-            if sprite.vy > self.max_fall_speed:
-                sprite.vy = self.max_fall_speed
+        if velocity is not None:
+            sprite.vx = velocity[0]
+            sprite.vy = velocity[1]
+            if sprite.vy < 0.0:
+                sprite.on_ground = False
+                jumped = True
         else:
-            sprite.vy = min(sprite.vy, 0.0)
+            if jump_pressed and was_on_ground:
+                sprite.vy = self.jump_strength
+                sprite.on_ground = False
+                jumped = True
+            elif not was_on_ground:
+                sprite.vy += self.gravity * dt
+                if sprite.vy > self.max_fall_speed:
+                    sprite.vy = self.max_fall_speed
+            else:
+                sprite.vy = min(sprite.vy, 0.0)
 
-        sprite.vx = input_x * 200.0
+            sprite.vx = input_x * self.horizontal_speed
         delta_x = sprite.vx * dt
         delta_y = sprite.vy * dt
         bottom_offset = old_bottom - old_y
@@ -1662,6 +1686,7 @@ class CollisionRunner:
                 dt,
                 input_x=kwargs.get("input_x", 0.0),
                 jump_pressed=kwargs.get("jump_pressed", False),
+                velocity=kwargs.get("velocity"),
             )
         elif self.mode == MovementMode.RPG:
             return self.move_rpg(sprite, tileset_collision, tile_map, delta_x, delta_y)
@@ -1736,6 +1761,7 @@ class CollisionRunner:
             runner.gravity = 800.0
             runner.max_fall_speed = 600.0
             runner.jump_strength = -400.0
+            runner.horizontal_speed = 200.0
             runner.slide_friction = 0.1
             runner._game_type = "platformer"
             runner._strict = strict

{tilemap_parser-3.1.15 → tilemap_parser-3.1.16}/src/tilemap_parser.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilemap-parser
-Version: 3.1.15
+Version: 3.1.16
 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.1.15 → tilemap_parser-3.1.16}/tests/test_tile_collision.py

@@ -267,6 +267,43 @@ class TestMovePlatformer:
         assert sprite.x > 137
         assert result.hit_wall_x is False
 
+    def test_explicit_velocity_controls_horizontal_movement(self):
+        tile_map = {}
+        sprite = MockSprite(x=100, y=100)
+        sprite.vx = 0
+        sprite.vy = 0
+        sprite.on_ground = True
+
+        result = self.runner.move_platformer(
+            sprite,
+            self.tileset,
+            tile_map,
+            dt=0.016,
+            input_x=0,
+            velocity=(600.0, 0.0),
+        )
+
+        assert result.final_x == pytest.approx(109.6)
+        assert sprite.vx == pytest.approx(600.0)
+
+    def test_move_convenience_forwards_explicit_velocity(self):
+        sprite = MockSprite(x=100, y=100)
+        sprite.vx = 0
+        sprite.vy = 0
+        sprite.on_ground = True
+
+        result = self.runner.move(
+            sprite,
+            self.tileset,
+            {},
+            dt=0.016,
+            input_x=0,
+            velocity=(600.0, 0.0),
+        )
+
+        assert result.final_x == pytest.approx(109.6)
+        assert sprite.vx == pytest.approx(600.0)
+
 
 class TestMovePlatformerWithSlide:
     def setup_method(self):
@@ -334,6 +371,24 @@ class TestMovePlatformerWithSlide:
         assert sprite.x == 103
         assert result.hit_wall_x is True
 
+    def test_explicit_velocity_controls_dash_without_input_scaling(self):
+        sprite = MockSprite(x=100, y=100)
+        sprite.vx = 0
+        sprite.vy = 0
+        sprite.on_ground = True
+
+        result = self.runner.move_platformer_with_slide(
+            sprite,
+            self.tileset,
+            {},
+            dt=0.016,
+            input_x=0,
+            velocity=(600.0, 0.0),
+        )
+
+        assert result.final_x == pytest.approx(109.6)
+        assert sprite.vx == pytest.approx(600.0)
+
 
 class TestMoveRpg:
     def setup_method(self):