tilemap-parser 3.1.23__tar.gz → 4.1.0__tar.gz

{tilemap_parser-3.1.23 → tilemap_parser-4.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilemap-parser
-Version: 3.1.23
+Version: 4.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
@@ -704,7 +704,10 @@ Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and co
 ## Features
 
 - **Map parsing**: Load and query tilemaps, layers, objects, and autotile data from JSON
+- **Chunked tile rendering**: Efficient visibility culling and chunk-based rendering with `TileLayerRenderer`
+- **Camera system**: Centered/deadzone follow, lerp smoothing, screen-shake, and bounds clamping with `Camera`
 - **Animation**: Frame-based sprite animation with `AnimationPlayer`
+- **Particle system**: Configurable particle emitters with shapes, color transitions, alpha fades, gravity, and batch rendering with `ParticleSystem` + `SpriteBatchRenderer`
 - **Collision (tile-based)**: Polygon collision detection for tilemaps with slide, platformer, and RPG movement modes via `CollisionRunner`
 - **Collision (object-to-object)**: Spatial-grid mixed-shape collision detection (rect, circle, capsule, polygon) with layer filtering via `ObjectCollisionManager`
 - **Capsule support**: Full capsule collision against all shape types
@@ -713,16 +716,22 @@ Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and co
 ## Quick Start
 
 ```python
-from tilemap_parser import load_map, TileLayerRenderer
+from tilemap_parser import load_map, TileLayerRenderer, Camera
 
+# Load map and set up renderer
 game_data = load_map("path/to/map.json")
 renderer = TileLayerRenderer(game_data)
+
+# Set up camera
+camera = Camera(800, 600, mode="centered")
+camera.follow(player)
 ```
 
 ```python
 from tilemap_parser import (
     CollisionRunner, CollisionCache,
     ObjectCollisionManager, CircleShape, RectangleShape,
+    ParticleSystem, ParticleSystemConfig
 )
 
 # Tile-based collision
@@ -735,10 +744,29 @@ manager = ObjectCollisionManager()
 manager.add_object(player)
 for hit in manager.check_all_collisions():
     hit.resolve()  # separate both objects
+
+# Particle system
+particle_config = ParticleSystemConfig(
+    particle_shape="circle",
+    spawn_rate=10.0,
+    max_particles=100,
+    lifetime_min=0.5,
+    lifetime_max=2.0,
+    speed_min=50,
+    speed_max=100,
+    direction=270,
+    spread=45,
+    start_color_r=255, start_color_g=200, start_color_b=100, start_color_a=255,
+    end_color_r=255, end_color_g=100, end_color_b=50, end_color_a=0,
+    alpha_fade="fade_out",
+    gravity_x=0,
+    gravity_y=50,
+)
+particles = ParticleSystem(particle_config)
 ```
 
 ## Links
 
-- **Docs**: https://tilemap-parser.vercel.app/
+- **Docs**: [https://deepwiki.com/FluffyBrudy/tilemap-parser](https://deepwiki.com/FluffyBrudy/tilemap-parser)
 - **Editor**: https://pypi.org/project/tilemap-editor/
 - **Repository**: https://github.com/FluffyBrudy/tilemap-parser

{tilemap_parser-3.1.23 → tilemap_parser-4.1.0}/README.md

@@ -5,7 +5,10 @@ Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and co
 ## Features
 
 - **Map parsing**: Load and query tilemaps, layers, objects, and autotile data from JSON
+- **Chunked tile rendering**: Efficient visibility culling and chunk-based rendering with `TileLayerRenderer`
+- **Camera system**: Centered/deadzone follow, lerp smoothing, screen-shake, and bounds clamping with `Camera`
 - **Animation**: Frame-based sprite animation with `AnimationPlayer`
+- **Particle system**: Configurable particle emitters with shapes, color transitions, alpha fades, gravity, and batch rendering with `ParticleSystem` + `SpriteBatchRenderer`
 - **Collision (tile-based)**: Polygon collision detection for tilemaps with slide, platformer, and RPG movement modes via `CollisionRunner`
 - **Collision (object-to-object)**: Spatial-grid mixed-shape collision detection (rect, circle, capsule, polygon) with layer filtering via `ObjectCollisionManager`
 - **Capsule support**: Full capsule collision against all shape types
@@ -14,16 +17,22 @@ Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and co
 ## Quick Start
 
 ```python
-from tilemap_parser import load_map, TileLayerRenderer
+from tilemap_parser import load_map, TileLayerRenderer, Camera
 
+# Load map and set up renderer
 game_data = load_map("path/to/map.json")
 renderer = TileLayerRenderer(game_data)
+
+# Set up camera
+camera = Camera(800, 600, mode="centered")
+camera.follow(player)
 ```
 
 ```python
 from tilemap_parser import (
     CollisionRunner, CollisionCache,
     ObjectCollisionManager, CircleShape, RectangleShape,
+    ParticleSystem, ParticleSystemConfig
 )
 
 # Tile-based collision
@@ -36,10 +45,29 @@ manager = ObjectCollisionManager()
 manager.add_object(player)
 for hit in manager.check_all_collisions():
     hit.resolve()  # separate both objects
+
+# Particle system
+particle_config = ParticleSystemConfig(
+    particle_shape="circle",
+    spawn_rate=10.0,
+    max_particles=100,
+    lifetime_min=0.5,
+    lifetime_max=2.0,
+    speed_min=50,
+    speed_max=100,
+    direction=270,
+    spread=45,
+    start_color_r=255, start_color_g=200, start_color_b=100, start_color_a=255,
+    end_color_r=255, end_color_g=100, end_color_b=50, end_color_a=0,
+    alpha_fade="fade_out",
+    gravity_x=0,
+    gravity_y=50,
+)
+particles = ParticleSystem(particle_config)
 ```
 
 ## Links
 
-- **Docs**: https://tilemap-parser.vercel.app/
+- **Docs**: [https://deepwiki.com/FluffyBrudy/tilemap-parser](https://deepwiki.com/FluffyBrudy/tilemap-parser)
 - **Editor**: https://pypi.org/project/tilemap-editor/
 - **Repository**: https://github.com/FluffyBrudy/tilemap-parser

{tilemap_parser-3.1.23 → tilemap_parser-4.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tilemap-parser"
-version = "3.1.23"
+version = "4.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.1.23 → tilemap_parser-4.1.0}/src/tilemap_parser/parser/__init__.py

@@ -46,6 +46,7 @@ from .map_parse import (
     parse_map_json,
 )
 from .node_parse import ParsedNode, parse_nodes_dict, parse_nodes_file
+from .tmx_converter import TmxParseError, parse_tmx_file, parse_tsx_file
 from .particle import (
     ALPHA_FADE_MODES,
     EMISSION_SHAPES,
@@ -84,6 +85,7 @@ __all__ = [
     "TilesetAnimation",
     "TileCollisionData",
     "TilesetCollision",
+    "TmxParseError",
     "parse_animation_dict",
     "parse_animation_file",
     "parse_animation_json",
@@ -96,6 +98,8 @@ __all__ = [
     "parse_map_json",
     "parse_nodes_dict",
     "parse_nodes_file",
+    "parse_tmx_file",
+    "parse_tsx_file",
     "parse_object_collision",
     "parse_tileset_collision",
     "ALPHA_FADE_MODES",

{tilemap_parser-3.1.23 → tilemap_parser-4.1.0}/src/tilemap_parser/parser/collision.py

@@ -77,6 +77,44 @@ class TilesetCollision:
             return []
         return [shape.transform(tile_x, tile_y, scale) for shape in tile_data.shapes]
 
+    @classmethod
+    def merge(
+        cls,
+        collisions: List["TilesetCollision"],
+        firstgids: List[int],
+    ) -> "TilesetCollision":
+        """Merge multiple tileset collisions into one, offsetting keys by firstgid.
+
+        Each collision's tiles are re-keyed as ``firstgid + local_id`` so that
+        the resulting dict uses global tile IDs for lookup.
+
+        Args:
+            collisions: List of TilesetCollision objects to merge.
+            firstgids: List of firstgid offsets, one per collision, in the
+                       same order as *collisions*.  The offset is added to
+                       each tile's local ID to produce the global key.
+
+        Usage::
+
+            merged = TilesetCollision.merge([ts0, ts1], [0, 200])
+        """
+        if not collisions:
+            return cls(tileset_name="merged", tile_size=(0, 0))
+        tile_size = collisions[0].tile_size
+        merged_tiles: Dict[int, TileCollisionData] = {}
+        for coll, offset in zip(collisions, firstgids, strict=True):
+            for local_id, data in coll.tiles.items():
+                gid = offset + local_id
+                merged_tiles[gid] = TileCollisionData(
+                    tile_id=gid,
+                    shapes=data.shapes[:],
+                )
+        return cls(
+            tileset_name="merged",
+            tile_size=tile_size,
+            tiles=merged_tiles,
+        )
+
 
 @dataclass
 class RectangleShape:
@@ -211,7 +249,7 @@ def parse_tileset_collision(data: JsonDict) -> TilesetCollision:
             tiles[tile_id] = TileCollisionData(tile_id=tile_id, shapes=shapes)
 
         return TilesetCollision(
-            tileset_name=tileset_name, tile_size=tile_size, tiles=tiles
+            tileset_name=tileset_name, tile_size=tile_size, tiles=tiles,
         )
     except (KeyError, ValueError, TypeError) as e:
         raise CollisionParseError(f"Invalid tileset collision data: {e}") from e

{tilemap_parser-3.1.23 → tilemap_parser-4.1.0}/src/tilemap_parser/parser/map_parse.py

@@ -105,7 +105,12 @@ class ParsedTile:
     pos: Point
     ttype: TilesetRef
     variant: int
+    gid: Optional[int] = None
     properties: Optional[JsonDict] = None
+    flip_h: bool = False
+    flip_v: bool = False
+    flip_d: bool = False
+    rotated_hex120: bool = False
 
 
 @dataclass
@@ -138,6 +143,8 @@ class TilesetAnimation:
 class ParsedTileset:
     path: str
     type: str
+    tile_count: int = 0
+    firstgid: int = 0
     properties: JsonDict = field(default_factory=dict)
     tile_properties: Dict[str, JsonDict] = field(default_factory=dict)
     animation: Optional[TilesetAnimation] = None
@@ -213,7 +220,19 @@ def _parse_tile(tile_data: JsonDict, ctx: str) -> ParsedTile:
     else:
         ttype = _coerce_int(ttype_raw, f"{ctx}.ttype")
     props = _optional_dict(tile_data.get("properties"), f"{ctx}.properties")
-    return ParsedTile(pos=pos, ttype=ttype, variant=variant, properties=props)
+    gid_raw = tile_data.get("gid")
+    gid = _coerce_int(gid_raw, f"{ctx}.gid") if gid_raw is not None else None
+    return ParsedTile(
+        pos=pos,
+        ttype=ttype,
+        variant=variant,
+        gid=gid,
+        properties=props,
+        flip_h=tile_data.get("flip_h", False),
+        flip_v=tile_data.get("flip_v", False),
+        flip_d=tile_data.get("flip_d", False),
+        rotated_hex120=tile_data.get("rotated_hex120", False),
+    )
 
 
 def _parse_tiles(tiles_obj: JsonDict, ctx: str) -> Dict[Point, ParsedTile]:
@@ -365,6 +384,8 @@ def _parse_tilesets_list(tilesets_raw: List[Any], ctx: str) -> List[ParsedTilese
             ParsedTileset(
                 path=path, type=ts_type, properties=props, tile_properties=tile_props,
                 animation=animation,
+                tile_count=_coerce_int(ts_obj.get("tile_count", 0), f"{ctx}[{i}].tile_count"),
+                firstgid=_coerce_int(ts_obj.get("firstgid", 0), f"{ctx}[{i}].firstgid"),
             )
         )
     return out
@@ -484,8 +505,13 @@ def parse_map_file(path: Union[str, Path]) -> ParsedMap:
     p = Path(path)
     if not p.is_file():
         raise MapParseError(f"Not a file: {p}")
-    if p.suffix.lower() != ".json":
-        raise MapParseError(f"Expected .json map file, got {p.suffix!r}")
+    suffix = p.suffix.lower()
+    if suffix == ".tmx":
+        from .tmx_converter import parse_tmx_file
+
+        return parse_tmx_file(p)
+    if suffix != ".json":
+        raise MapParseError(f"Expected .json or .tmx map file, got {suffix!r}")
     try:
         text = p.read_text(encoding="utf-8")
     except OSError as e: