ha(ux): мастер из трёх страниц, feature-модель и capabilities-фильтрация

- config flow: template (A/B/F с пояснениями, значения с устройства,
  определение по oem_model; для неизвестных моделей — пробинг A/B/F тремя
  короткими сессиями) -> capabilities (23 тумблера с описаниями, дефолты
  из device_capabilities/num_dir/ответов) -> limits (диапазон/шаг, ручная
  конверсия); каждая страница с пометкой «значения определены
  автоматически, можно пропустить»
- features.py: FeatureSet/LiveValues/device_default/resolve_features;
  entry.data["features"] хранит выбор пользователя; reconfigure
  предзаполняет; YAML-import получает дефолты
- сущности создаются только для включённых фич: climate (режимы/скорости/
  swing/пресеты), switch, select заслонок (caps+num_dir), датчик комнаты;
  исправлено появление select без ламелей
- trial: caps/num_dir и presence-зонды (необязательные свойства), answered;
  координатор ждёт первые свойства перед созданием сущностей (feature-
  дефолты без гонки)
- атрибут description у сущностей (HA не поддерживает тултипы) + описания
  фич в мастере (en/ru)
- тесты: features, probing, обновлённые flow/entities/repairs; 57 components

custom_components/fglair/features.py

@@ -0,0 +1,118 @@
+"""Feature-модель: какие возможности реально есть у прибора.
+
+Дефолты берутся из `device_capabilities` и фактических ответов устройства,
+пользователь может переопределить их в мастере (и в reconfigure); результат
+хранится в entry.data[CONF_FEATURES] и фильтрует создание сущностей.
+"""
+from __future__ import annotations
+
+from typing import Any, Mapping, Optional
+
+from pyfglair import Prop, Value
+
+from .const import FEATURES
+
+DIRECTION_KEYS = {
+    "af_vertical_direction": ("af_vertical_num_dir", Prop.AF_VERTICAL_NUM_DIR),
+    "af_horizontal_direction": (
+        "af_horizontal_num_dir",
+        Prop.AF_HORIZONTAL_NUM_DIR,
+    ),
+}
+
+
+def _int_value(values: Mapping[Prop, Value], prop: Prop) -> Optional[int]:
+    value = values.get(prop)
+    return value.int_value if value is not None else None
+
+
+def _caps(values: Mapping[Prop, Value]) -> Optional[int]:
+    raw = _int_value(values, Prop.DEVICE_CAPABILITIES)
+    return raw if raw else None
+
+
+def device_default(
+    key: str,
+    values: Mapping[Prop, Value],
+    answered: Optional[set[Prop]] = None,
+) -> bool:
+    """Дефолт фичи по данным устройства (без пользовательских override)."""
+    bit, prop = FEATURES[key]
+    if bit is not None:
+        caps = _caps(values)
+        if caps is None:
+            return True  # возможностей не сообщили — не режем
+        return bool(caps & (1 << bit))
+    if key in DIRECTION_KEYS:
+        num = _int_value(values, DIRECTION_KEYS[key][1])
+        return bool(num and num > 1)
+    if prop is not None:
+        if answered is not None:
+            return prop in answered
+        return prop in values
+    return True
+
+
+def resolve_features(
+    values: Mapping[Prop, Value],
+    answered: Optional[set[Prop]] = None,
+    explicit: Optional[Mapping[str, Any]] = None,
+) -> dict[str, bool]:
+    """Полный набор фич: дефолт с устройства + пользовательские значения."""
+    resolved = {
+        key: bool(value)
+        for key, value in (
+            explicit or {}
+        ).items()
+        if key in FEATURES
+    }
+    for key in FEATURES:
+        resolved.setdefault(key, device_default(key, values, answered))
+    return resolved
+
+
+class LiveValues(Mapping):
+    """Mapping поверх client.cached(prop) — значения кэша ядра «на сейчас».
+
+    Используется вместо снимка coordinator.data, чтобы фильтрация сущностей
+    не зависела от гонки с обработкой push-событий в loop.
+    """
+
+    def __init__(self, getter) -> None:
+        self._getter = getter
+
+    def __getitem__(self, prop: Prop) -> Value:
+        value = self._getter(prop)
+        if value is None:
+            raise KeyError(prop)
+        return value
+
+    def __iter__(self):
+        return iter(())
+
+    def __len__(self) -> int:
+        return 0
+
+
+class FeatureSet:
+    """Фильтр создания сущностей для runtime (entry + live-значения ядра)."""
+
+    def __init__(
+        self,
+        explicit: Optional[Mapping[str, Any]],
+        values: Mapping[Prop, Value],
+    ) -> None:
+        self._explicit = {
+            key: bool(value)
+            for key, value in (explicit or {}).items()
+            if key in FEATURES
+        }
+        self._values = values
+
+    def enabled(self, key: str) -> bool:
+        if key in self._explicit:
+            return self._explicit[key]
+        return device_default(key, self._values)
+
+    def as_dict(self) -> dict[str, bool]:
+        return dict(self._explicit)