"""Базовая сущность fglair: DeviceInfo, значения из координатора."""
from __future__ import annotations

from typing import Optional

from homeassistant.helpers.device_registry import DeviceInfo
from homeassistant.helpers.update_coordinator import CoordinatorEntity

from pyfglair import Prop, Value

from .const import (
    CONF_DSN,
    CONF_MODEL,
    CONF_NAME,
    DOMAIN,
    entity_description,
)
from .coordinator import FglairCoordinator


class FglairEntity(CoordinatorEntity[FglairCoordinator]):
    """Общий базис: unique_id = <dsn>_<key>, device_info — один прибор."""

    _attr_has_entity_name = True

    def __init__(
        self,
        coordinator: FglairCoordinator,
        unique_suffix: str,
        translation_key: Optional[str],
        description_key: Optional[str] = None,
    ) -> None:
        super().__init__(coordinator)
        data = coordinator.client.data
        dsn = data[CONF_DSN]
        self._attr_unique_id = f"{dsn}_{unique_suffix}"
        if translation_key is not None:
            self._attr_translation_key = translation_key
        self._description_key = description_key or translation_key
        self._attr_device_info = DeviceInfo(
            identifiers={(DOMAIN, dsn)},
            name=data.get(CONF_NAME) or dsn,
            manufacturer="Fujitsu General",
            model=data.get(CONF_MODEL) or None,
        )

    @property
    def available(self) -> bool:
        return self.coordinator.data.available and super().available

    @property
    def extra_state_attributes(self) -> Optional[dict]:
        """HA не поддерживает тултипы сущностей: краткое описание видно в
        атрибутах (More info → Атрибуты)."""
        if self._description_key is None or self.hass is None:
            return None
        text = entity_description(self.hass.config.language, self._description_key)
        return {"description": text} if text else None

    def feature_enabled(self, key: str) -> bool:
        return self.coordinator.features.enabled(key)

    def value(self, prop: Prop) -> Optional[Value]:
        return self.coordinator.data.values.get(prop)

    def raw_value(self, prop: Prop) -> Optional[int]:
        value = self.value(prop)
        return value.int_value if value is not None else None

    def display_value(self, prop: Prop) -> Optional[int]:
        """Значение свойства в единицах отображения (с ручной конверсией)."""
        raw = self.raw_value(prop)
        if raw is None:
            return None
        return self.coordinator.conversions.to_display(prop, raw)