valetudo-map-parser 0.1.9b75__py3-none-any.whl → 0.1.10__py3-none-any.whl

valetudo_map_parser/config/status_text/status_text.py

@@ -0,0 +1,96 @@
+"""
+Version: 0.1.10
+Status text of the vacuum cleaners.
+Class to handle the status text of the vacuum cleaners.
+"""
+
+from __future__ import annotations
+
+from ..types import LOGGER, PilPNG
+from .translations import translations
+
+
+LOGGER.propagate = True
+
+
+class StatusText:
+    """
+    Status text of the vacuum cleaners.
+    """
+
+    def __init__(self, camera_shared):
+        self._shared = camera_shared
+        self.file_name = self._shared.file_name
+
+    @staticmethod
+    async def get_vacuum_status_translation(
+        language: str = "en",
+    ) -> dict[str, str] | None:
+        """
+        Get the vacuum status translation.
+        @param language: Language code, default 'en'.
+        @return: Mapping for the given language or None.
+        """
+        return translations.get((language or "en").lower())
+
+    async def translate_vacuum_status(self) -> str:
+        """Return the translated status with EN fallback and safe default."""
+        status = self._shared.vacuum_state or "unknown"
+        language = (self._shared.user_language or "en").lower()
+        translation = await self.get_vacuum_status_translation(language)
+        if not translation:
+            translation = translations.get("en", {})
+        return translation.get(status, str(status).capitalize())
+
+    async def get_status_text(self, text_img: PilPNG) -> tuple[list[str], int]:
+        """
+        Compose the image status text.
+        :param text_img: Image to draw the text on.
+        :return status_text, text_size: List of the status text and the text size.
+        """
+        status_text = ["If you read me, something really went wrong.."]  # default text
+        text_size_coverage = 1.5  # resize factor for the text
+        text_size = self._shared.vacuum_status_size  # default text size
+        charge_level = "\u03de"  # unicode Koppa symbol
+        charging = "\u2211"  # unicode Charging symbol
+        vacuum_state = await self.translate_vacuum_status()
+        if self._shared.show_vacuum_state:
+            status_text = [f"{self.file_name}: {vacuum_state}"]
+            language = (self._shared.user_language or "en").lower()
+            lang_map = translations.get(language) or translations.get("en", {})
+            if not self._shared.vacuum_connection:
+                mqtt_disc = lang_map.get(
+                    "mqtt_disconnected",
+                    translations.get("en", {}).get(
+                        "mqtt_disconnected", "Disconnected from MQTT?"
+                    ),
+                )
+                status_text = [f"{self.file_name}: {mqtt_disc}"]
+            else:
+                if self._shared.current_room:
+                    in_room = self._shared.current_room.get("in_room")
+                    if in_room:
+                        status_text.append(f" ({in_room})")
+                if self._shared.vacuum_state == "docked":
+                    if self._shared.vacuum_bat_charged():
+                        status_text.append(" \u00b7 ")
+                        status_text.append(f"{charging}{charge_level} ")
+                        status_text.append(f"{self._shared.vacuum_battery}%")
+                    else:
+                        status_text.append(" \u00b7 ")
+                        status_text.append(f"{charge_level} ")
+                        ready_txt = lang_map.get(
+                            "ready",
+                            translations.get("en", {}).get("ready", "Ready."),
+                        )
+                        status_text.append(ready_txt)
+                else:
+                    status_text.append(" \u00b7 ")
+                    status_text.append(f"{charge_level}")
+                    status_text.append(f" {self._shared.vacuum_battery}%")
+                if text_size >= 50 and getattr(text_img, "width", None):
+                    text_pixels = max(1, sum(len(text) for text in status_text))
+                    text_size = int(
+                        (text_size_coverage * text_img.width) // text_pixels
+                    )
+        return status_text, text_size

valetudo_map_parser/config/status_text/translations.py

@@ -0,0 +1,280 @@
+"""Translations for vacuum status and status text snippets."""
+
+translations = {
+    "en": {
+        "connected": "Connected",
+        "disconnected": "Disconnected",
+        "charging": "Charging",
+        "cleaning": "Cleaning",
+        "docked": "Docked",
+        "idle": "Idle",
+        "paused": "Paused",
+        "returning": "Returning",
+        "ready": "Ready.",
+        "mqtt_disconnected": "Disconnected from MQTT?",
+    },
+    "de": {
+        "connected": "Verbunden",
+        "disconnected": "Nicht verbunden",
+        "charging": "Laden",
+        "cleaning": "Reinigen",
+        "docked": "Angefahren",
+        "idle": "Inaktiv",
+        "paused": "Pausiert",
+        "returning": "Zurückkehren",
+        "ready": "Bereit.",
+        "mqtt_disconnected": "Von MQTT getrennt?",
+    },
+    "fr": {
+        "connected": "Connecté",
+        "disconnected": "Déconnecté",
+        "charging": "En charge",
+        "cleaning": "Nettoyage",
+        "docked": "Ancré",
+        "idle": "Inactif",
+        "paused": "En pause",
+        "returning": "Retour",
+        "ready": "Prêt.",
+        "mqtt_disconnected": "Déconnecté de MQTT ?",
+    },
+    "it": {
+        "connected": "Connesso",
+        "disconnected": "Disconnesso",
+        "charging": "Caricamento",
+        "cleaning": "Pulizia",
+        "docked": "Ancorato",
+        "idle": "Inattivo",
+        "paused": "In pausa",
+        "returning": "Ritorno",
+        "ready": "Pronto.",
+        "mqtt_disconnected": "Disconnesso da MQTT?",
+    },
+    "pl": {
+        "connected": "Połączony",
+        "disconnected": "Rozłączony",
+        "charging": "Ładowanie",
+        "cleaning": "Czyszczenie",
+        "docked": "Zaparkowany",
+        "idle": "Nieaktywny",
+        "paused": "Wstrzymany",
+        "returning": "Powrót",
+        "ready": "Gotowy.",
+        "mqtt_disconnected": "Odłączono od MQTT?",
+    },
+    "pt": {
+        "connected": "Conectado",
+        "disconnected": "Desconectado",
+        "charging": "Carregando",
+        "cleaning": "Limpando",
+        "docked": "Anclado",
+        "idle": "Inativo",
+        "paused": "Pausado",
+        "returning": "Retornando",
+        "ready": "Pronto.",
+        "mqtt_disconnected": "Desconectado do MQTT?",
+    },
+    "ru": {
+        "connected": "Подключен",
+        "disconnected": "Отключен",
+        "charging": "Заряжается",
+        "cleaning": "Очищается",
+        "docked": "Закреплен",
+        "idle": "Неактивен",
+        "paused": "Приостановлен",
+        "returning": "Возвращается",
+        "ready": "Готово.",
+        "mqtt_disconnected": "Отключено от MQTT?",
+    },
+    "tr": {
+        "connected": "Bağlandı",
+        "disconnected": "Bağlantı kesildi",
+        "charging": "Şarj ediliyor",
+        "cleaning": "Temizleniyor",
+        "docked": "Dokundu",
+        "idle": "Boşta",
+        "paused": "Duraklatıldı",
+        "returning": "Geri dönüyor",
+        "ready": "Hazır.",
+        "mqtt_disconnected": "MQTT bağlantısı kesildi mi?",
+    },
+    "zh": {
+        "connected": "已连接",
+        "disconnected": "未连接",
+        "charging": "充电中",
+        "cleaning": "清扫中",
+        "docked": "已停靠",
+        "idle": "空闲",
+        "paused": "已暂停",
+        "returning": "返回中",
+        "ready": "已就绪。",
+        "mqtt_disconnected": "MQTT 已断开？",
+    },
+    "ja": {
+        "connected": "接続済み",
+        "disconnected": "切断されました",
+        "charging": "充電中",
+        "cleaning": "掃除中",
+        "docked": "停泊中",
+        "idle": "アイドル",
+        "paused": "一時停止中",
+        "returning": "戻り中",
+        "ready": "準備完了。",
+        "mqtt_disconnected": "MQTT から切断されていますか？",
+    },
+    "ko": {
+        "connected": "연결됨",
+        "disconnected": "연결 해제됨",
+        "charging": "충전 중",
+        "cleaning": "청소 중",
+        "docked": "도킹됨",
+        "idle": "대기 중",
+        "paused": "일시 중지됨",
+        "returning": "돌아오는 중",
+        "ready": "준비 완료.",
+        "mqtt_disconnected": "MQTT에서 연결이 끊겼나요?",
+    },
+    "ar": {
+        "connected": "متصل",
+        "disconnected": "غير متصل",
+        "charging": "جار الت충ّد",
+        "cleaning": "washering",
+        "docked": "anchored",
+        "idle": "iddle",
+        "paused": "paused",
+        "returning": "returning",
+        "ready": "جاهز.",
+        "mqtt_disconnected": "هل تم قطع الاتصال بـ MQTT؟",
+    },
+    "hi": {
+        "connected": "संयुक्त",
+        "disconnected": "असंयुक्त",
+        "charging": "चार्जिंग",
+        "cleaning": "साफ़ कर रहा है",
+        "docked": "डॉक में",
+        "idle": "रूक गया है",
+        "paused": "रूक गया है",
+        "returning": "वापस आ रहा है",
+        "ready": "तैयार.",
+        "mqtt_disconnected": "MQTT से डिसकनेक्ट?",
+    },
+    "bn": {
+        "connected": "যোগাযোগ করা হয়েছে",
+        "disconnected": "বিরাজিত",
+        "charging": "চার্জিং",
+        "cleaning": "সাফ করা হচ্ছে",
+        "docked": "ডকেড",
+        "idle": "বিনা কর্মে",
+        "paused": "বিরত",
+        "returning": "পুনরায় আসছে",
+        "ready": "প্রস্তুত।",
+        "mqtt_disconnected": "MQTT থেকে সংযোগ বিচ্ছিন্ন?",
+    },
+    "sv": {
+        "connected": "Ansluten",
+        "disconnected": "Frånkopplad",
+        "charging": "Laddar",
+        "cleaning": "Rensar",
+        "docked": "Anknyttad",
+        "idle": "Väntande",
+        "paused": "Paus",
+        "returning": "Återvänder",
+        "ready": "Klar.",
+        "mqtt_disconnected": "Frånkopplad från MQTT?",
+    },
+    "fn": {
+        "connected": "Konektado",
+        "disconnected": "Hindi konektado",
+        "charging": "Kinakarga",
+        "cleaning": "Binabagay",
+        "docked": "Ankore",
+        "idle": "Idle",
+        "paused": "Napupaua",
+        "returning": "Nagbabalik",
+        "ready": "Handa.",
+        "mqtt_disconnected": "Na-disconnect sa MQTT?",
+    },
+    "no": {
+        "connected": "Tilkoblet",
+        "disconnected": "Frakoblet",
+        "charging": "Lader",
+        "cleaning": "Renser",
+        "docked": "Ankoblet",
+        "idle": "Inaktiv",
+        "paused": "Pause",
+        "returning": "Gir tilbake",
+        "ready": "Klar.",
+        "mqtt_disconnected": "Frakoblet fra MQTT?",
+    },
+    "cz": {
+        "connected": "Připojeno",
+        "disconnected": "Odpojeno",
+        "charging": "Nabíjení",
+        "cleaning": "Čištění",
+        "docked": "Zaparkováno",
+        "idle": "Nečinný",
+        "paused": "Pozastaveno",
+        "returning": "Vrací se",
+        "ready": "Připraven.",
+        "mqtt_disconnected": "Odpojeno od MQTT?",
+    },
+    "da": {
+        "connected": "Tilsluttet",
+        "disconnected": "Afvist",
+        "charging": "Oplader",
+        "cleaning": "Renser",
+        "docked": "Ankeret",
+        "idle": "Inaktiv",
+        "paused": "Pause",
+        "returning": "Returnerer",
+        "ready": "Klar.",
+        "mqtt_disconnected": "Afbrudt fra MQTT?",
+    },
+    "fi": {
+        "connected": "Yhdistetty",
+        "disconnected": "Yhteys katkaistu",
+        "charging": "Lataa",
+        "cleaning": "Siivous",
+        "docked": "Ankeroitu",
+        "idle": "Lähes",
+        "paused": "Tauko",
+        "returning": "Palauttaa",
+        "ready": "Valmis.",
+        "mqtt_disconnected": "Yhteys katkennut MQTT:stä?",
+    },
+    "el": {
+        "connected": "Συνδεδεμένος",
+        "disconnected": "Αποσυνδεδεμένος",
+        "charging": "Φορτώνει",
+        "cleaning": "Καθαρισμός",
+        "docked": "Ανκερώθηκε",
+        "idle": "Αδρανής",
+        "paused": "Παύση",
+        "returning": "Επιστρέφει",
+        "ready": "Έτοιμο.",
+        "mqtt_disconnected": "Αποσυνδεδεμένο από MQTT;",
+    },
+    "es": {
+        "connected": "Conectado",
+        "disconnected": "Desconectado",
+        "charging": "Cargando",
+        "cleaning": "Limpiando",
+        "docked": "Anclado",
+        "idle": "Inactivo",
+        "paused": "Pausado",
+        "returning": "Regresando",
+        "ready": "Listo.",
+        "mqtt_disconnected": "¿Desconectado de MQTT?",
+    },
+    "nl": {
+        "connected": "Verbonden",
+        "disconnected": "Niet verbonden",
+        "charging": "Laden",
+        "cleaning": "Schoonmaken",
+        "docked": "Aangeschoten",
+        "idle": "Inactief",
+        "paused": "Gepauzeerd",
+        "returning": "Terugkeren",
+        "ready": "Klaar.",
+        "mqtt_disconnected": "Verbinding met MQTT verbroken?",
+    },
+}

valetudo_map_parser/config/types.py

@@ -8,7 +8,7 @@ import json
 import logging
 import threading
 from dataclasses import asdict, dataclass
-from typing import Any, Dict, Optional, Tuple, TypedDict, Union
+from typing import Any, Dict, List, NotRequired, Optional, Tuple, TypedDict, Union
 
 import numpy as np
 from PIL import Image
@@ -19,6 +19,29 @@ DEFAULT_ROOMS = 1
 LOGGER = logging.getLogger(__package__)
 
 
+class Spot(TypedDict):
+    name: str
+    coordinates: List[int]  # [x, y]
+
+
+class Zone(TypedDict):
+    name: str
+    coordinates: List[List[int]]  # [[x1, y1, x2, y2, repeats], ...]
+
+
+class Room(TypedDict):
+    name: str
+    id: int
+
+
+# list[dict[str, str | list[int]]] | list[dict[str, str | list[list[int]]]] | list[dict[str, str | int]] | int]'
+class Destinations(TypedDict, total=False):
+    spots: NotRequired[Optional[List[Spot]]]
+    zones: NotRequired[Optional[List[Zone]]]
+    rooms: NotRequired[Optional[List[Room]]]
+    updated: NotRequired[Optional[float]]
+
+
 class RoomProperty(TypedDict):
     number: int
     outline: list[tuple[int, int]]
@@ -81,6 +104,8 @@ class RoomStore:
                 instance = super(RoomStore, cls).__new__(cls)
                 instance.vacuum_id = vacuum_id
                 instance.vacuums_data = rooms_data or {}
+                instance.rooms_count = instance.get_rooms_count()
+                instance.floor = None
                 cls._instances[vacuum_id] = instance
             else:
                 if rooms_data is not None:
@@ -126,10 +151,10 @@ class UserLanguageStore:
         async with self._lock:
             self.user_languages[user_id] = language
 
-    async def get_user_language(self, user_id: str) -> str or None:
+    async def get_user_language(self, user_id: str) -> str:
         """Get the user language."""
         async with self._lock:
-            return self.user_languages.get(user_id, None)
+            return self.user_languages.get(user_id, "")
 
     async def get_all_languages(self):
         """Get all the user languages."""
@@ -197,20 +222,24 @@ class SnapshotStore:
 Color = Union[Tuple[int, int, int], Tuple[int, int, int, int]]
 Colors = Dict[str, Color]
 CalibrationPoints = list[dict[str, Any]]
-RobotPosition = dict[str, int | float]
+RobotPosition: type[tuple[Any, Any, dict[str, int | float] | None]] = tuple[
+    Any, Any, dict[str, int | float] | None
+]
 ChargerPosition = dict[str, Any]
 RoomsProperties = dict[str, RoomProperty]
 ImageSize = dict[str, int | list[int]]
+Size = dict[str, int]
 JsonType = Any  # json.loads() return type is Any
 PilPNG = Image.Image  # Keep for backward compatibility
-WebPBytes = bytes  # WebP image as bytes
 NumpyArray = np.ndarray
 Point = Tuple[int, int]
 
 CAMERA_STORAGE = "valetudo_camera"
+ATTR_IMAGE_LAST_UPDATED = "image_last_updated"
 ATTR_ROTATE = "rotate_image"
 ATTR_CROP = "crop_image"
 ATTR_MARGINS = "margins"
+ATTR_CONTENT_TYPE = "content_type"
 CONF_OFFSET_TOP = "offset_top"
 CONF_OFFSET_BOTTOM = "offset_bottom"
 CONF_OFFSET_LEFT = "offset_left"
@@ -283,7 +312,7 @@ DEFAULT_VALUES = {
     "auto_zoom": False,
     "zoom_lock_ratio": True,
     "show_vac_status": False,
-    "vac_status_font": "custom_components/mqtt_vacuum_camera/utils/fonts/FiraSans.ttf",
+    "vac_status_font": "SCR/valetudo_map_parser/config/fonts/FiraSans.ttf",
     "vac_status_size": 50,
     "vac_status_position": True,
     "get_svg_file": False,
@@ -443,31 +472,31 @@ RATIO_VALUES = [
 FONTS_AVAILABLE = [
     {
         "label": "Fira Sans",
-        "value": "custom_components/mqtt_vacuum_camera/utils/fonts/FiraSans.ttf",
+        "value": "config/fonts/FiraSans.ttf",
     },
     {
         "label": "Inter",
-        "value": "custom_components/mqtt_vacuum_camera/utils/fonts/Inter-VF.ttf",
+        "value": "config/fonts/Inter-VF.ttf",
     },
     {
         "label": "M Plus Regular",
-        "value": "custom_components/mqtt_vacuum_camera/utils/fonts/MPLUSRegular.ttf",
+        "value": "config/fonts/MPLUSRegular.ttf",
     },
     {
         "label": "Noto Sans CJKhk",
-        "value": "custom_components/mqtt_vacuum_camera/utils/fonts/NotoSansCJKhk-VF.ttf",
+        "value": "config/fonts/NotoSansCJKhk-VF.ttf",
     },
     {
         "label": "Noto Kufi Arabic",
-        "value": "custom_components/mqtt_vacuum_camera/utils/fonts/NotoKufiArabic-VF.ttf",
+        "value": "config/fonts/NotoKufiArabic-VF.ttf",
     },
     {
         "label": "Noto Sans Khojki",
-        "value": "custom_components/mqtt_vacuum_camera/utils/fonts/NotoSansKhojki.ttf",
+        "value": "config/fonts/NotoSansKhojki.ttf",
     },
     {
         "label": "Lato Regular",
-        "value": "custom_components/mqtt_vacuum_camera/utils/fonts/Lato-Regular.ttf",
+        "value": "config/fonts/Lato-Regular.ttf",
     },
 ]