feat: add Conga vacuum support (0.3.0b1)

- Add CongaMapImageHandler subclassing HypferMapImageHandler with
  JSON coordinate scaling (pixelSize=1 → 5) via async_get_conga_from_json
- Add CongaImageDraw subclassing HypferImageDraw as Conga draw engine
- Add is_conga: bool = False to CameraShared for vacuum type detection
- Route Conga in BaseHandler._generate_new_image via hasattr duck-typing
- Remove is_conga_map() from ImageData and detect_vacuum_type() from
  BaseHandler — detection is mqtt_vacuum_camera's responsibility
- Export CongaMapImageHandler and ImageData from public API

Author: sca075

SCR/valetudo_map_parser/config/shared.py

@@ -71,6 +71,7 @@ def __init__(self, file_name):
         self.rand256_active_zone: list = []
         self.rand256_zone_coordinates: list = []
         self.is_rand: bool = False
+        self.is_conga: bool = False
         self._new_mqtt_message = False
         self.last_image = Image.new("RGBA", (250, 150), (128, 128, 128, 255))
         self.new_image: PilPNG | None = None

SCR/valetudo_map_parser/config/utils.py

@@ -11,7 +11,7 @@
 import numpy as np
 from PIL import Image, ImageOps
 
-from ..map_data import HyperMapData, ImageData
+from ..map_data import HyperMapData
 from .async_utils import AsyncNumPy
 from .colors import ColorIndex
 from .drawable import Drawable
@@ -80,23 +80,6 @@ def __init__(self):
         self.drawing_config: Optional[DrawingConfig] = None
         self.draw: Optional[Drawable] = None
 
-    @staticmethod
-    def detect_vacuum_type(json_data: dict) -> str:
-        """Detect the vacuum type from the raw JSON map data.
-
-        Returns:
-            'conga'   — Conga vacuum (congaPixels present in layers)
-            'hypfer'  — Standard Hypfer/Valetudo vacuum
-            'rand256' — Rand256 / Valetudo Re vacuum (rrm key present)
-        """
-        if not isinstance(json_data, dict):
-            return "hypfer"
-        if "rrm" in json_data or json_data.get("__class") == "RRMap":
-            return "rand256"
-        if ImageData.is_conga_map(json_data):
-            return "conga"
-        return "hypfer"
-
     def get_frame_number(self) -> int:
         """Return the frame number of the image."""
         return self.frame_number
@@ -168,6 +151,9 @@ async def _generate_new_image(
                 m_json=m_json,
                 destinations=destinations,
             )
+        
+        if hasattr(self, "async_get_conga_from_json"):
+            return await self.async_get_conga_from_json(m_json=m_json)
 
         if hasattr(self, "async_get_image_from_json"):
             self.json_data = await HyperMapData.async_from_valetudo_json(m_json)

SCR/valetudo_map_parser/conga_handler.py

@@ -56,7 +56,7 @@ def _scale_conga_json(m_json: JsonType, scale: int) -> JsonType:
                 entity["points"] = [v * scale for v in pts]
         return scaled
 
-    async def async_get_image_from_json(
+    async def async_get_conga_from_json(
         self, m_json: JsonType | None
     ) -> Image.Image | None:
         """Scale Conga JSON to pixel_size=CONGA_SCALE, then render normally."""

SCR/valetudo_map_parser/map_data.py

@@ -273,18 +273,6 @@ def _extract_segment_metadata(
         if segment_id and material:
             materials_dict[segment_id] = material
 
-    @staticmethod
-    def is_conga_map(json_data: Any) -> bool:
-        """Detect whether the JSON data originates from a Conga vacuum.
-
-        Conga maps are identified by the presence of a 'congaPixels' field
-        in at least one layer entry.
-        """
-        layers = json_data.get("layers", []) if isinstance(json_data, dict) else []
-        return any(
-            "congaPixels" in layer for layer in layers if isinstance(layer, dict)
-        )
-
     @staticmethod
     def _process_map_layer(
         json_obj: dict,