houseplan-card/docs/specs/028-room-view-card.md

ТЗ #28 — Карточка комнаты в режиме View

• Issue: https://github.com/Matysh/houseplan-card/issues/28
• Приоритет: P1
• Статус ТЗ: draft, требуется UX-утверждение
• Зависимости: #31 использует карточку как основную доступную точку комнаты

Цель

Сделать информацию о комнате одинаково доступной мышью, touch и клавиатурой, не заменяя быстрый desktop hover и не меняя модель комнаты.

Нормативное поведение

1. В View tap/click по свободной части чистого пола открывает компактный hp-dialog «Комната».
2. Диалог показывает:
   • отображаемое имя либо локализованное «Без названия»;
   • чистую площадь через существующий _roomArea()/clean-floor geometry;
   • только доступные temperature, humidity, LQI и light stats;
   • подписанную кнопку «Открыть зону в Home Assistant» только при room.area.
3. Источники метрик и форматирование ровно те же, что у hover и room label: _roomTemp, _roomHum, _roomLqi, resolvedLightSources/Stats.
4. Hover tooltip остаётся без клика; открытый dialog убирает hover tooltip.
5. Комната без area открывает карточку, но не показывает навигационное действие.
6. События устройства, проёма, room label/link, vacuum puck, control, tooltip и других интерактивных слоёв обязаны остановить propagation.

Gesture arbitration

• Решение принимается на pointerup, только если pointerdown начался на той же room hit-shape и движение не превысило существующий click threshold.
• Pan, pinch, long press, drag и _suppressClick отменяют room activation.
• Glow, sun rays, tunnel fills и hover outline остаются pointer-events:none.
• Для вложенных комнат выигрывает верхняя/самая внутренняя реальная hit-shape; отверстие пола родителя не является его hit-area.
• Один жест может открыть только один dialog.

Доступность

• Доступный trigger получает локализованное имя комнаты; Enter/Space открывают тот же dialog через модель навигации #31.
• Dialog наследует trap, initial/restore focus и Escape у hp-dialog.
• Метрики представлены текстом, не только иконками/цветом.

Эдж-кейсы

Толстые/скрытые стены, отверстия, перегородки и колонны используют уже вычисленную clean-floor path. Общая стена не принадлежит hit-area комнаты. Изменение HA state обновляет метрики открытой карточки. Удаление/смена пространства закрывает карточку без навигации.

Проверки и приёмка

• unit: единая projection модели карточки из room + aggregates;
• browser desktop/touch/keyboard: open/close, pan suppression, nested room;
• browser: click по device/opening/link не проваливается в room;
• площадь байт-в-байт совпадает с tooltip formatter;
• mobile golden: длинное имя, все/нет метрик, стабильный footer.