houseplan-card/docs/specs/052-view-dimensions.md

# ТЗ #52 — Размеры стен и площади в View

> **Закрыто 2026-09-07 решением владельца, объединено с #53.** Слой размеров
> в режиме просмотра не делается. Раздел «Площади» остаётся действующим
> контрактом и переиспользуется опцией «Отображать размеры» экспорта PDF
> (#53). Раздел «Длины» (осевые пролёты стен) на бумаге НЕ применяется:
> ТЗ #53 §7.3 печатает внутренние размеры каждой комнаты грань-в-грань и
> внешние размеры наружных граней. «Настройка» и «Collision/zoom» к экрану
> больше не относятся.

- Issue: https://github.com/Matysh/houseplan-card/issues/52 (закрыт, см. #53)
- Приоритет: P3
- Статус ТЗ: контракт измерений для #53

## Цель

Добавить read-only architectural annotation layer на основе существующей
геометрии и `cell_cm`, не создавая второй системы измерений.

## Настройка

Per-space `settings.dimensions: 'off' | 'areas' | 'full'`, default `off`.
Отдельный card/kiosk default: kiosk всегда скрывает dimensions, пока будущая
явная card option не разрешит их. Editor preview использует effective setting.

## Площади

- `areas` и `full` показывают значение чистого пола через тот же
  clean-floor/`geometryArea` resolver, что tooltip #28.
- Единицы/округление — существующий `formatArea`; metric m², imperial ft².
- Label anchor — сохранённый room label position либо interior visual point;
  annotation не перемещает пользовательское room name.
- Очень малая/узкая room скрывает annotation при отсутствии безопасного места,
  tooltip/card всё равно содержит площадь.

## Длины

- `full` аннотирует unique physical wall centreline spans из текущей
  normalized wall model. Общая стена рисуется один раз.
- Virtual/open boundary не получает physical length annotation.
- Doors/windows/gates не вычитаются из общей длины span; это размер стены по
  оси, а не чистая кладка.
- Partitions и physical segments сохранённых room drafts входят; columns не
  имеют линейного размера. Толщина не меняет длину оси.
- Collinear мусорные fragments сначала проходят существующую compaction;
  annotation не объединяет через угол/разрыв.

Label расположен параллельно span, читаемый текст никогда не upside-down;
offset выбирается со стороны вне clean floor при возможности. Значение
использует `segmentCm`/`formatLength` и space grid scale.

## Collision/zoom

Projection вычисляет candidates и детерминированно скрывает labels, чьи screen
bbox пересекаются с более приоритетными (selected room, outer wall, longer
span). Ни один label не становится меньше доступного font minimum. На малом
zoom слой постепенно скрывает wall dimensions, затем areas; stored setting не
меняется. `pointer-events:none`.

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

- rectangles, diagonal/L/nested/shared/thick/open walls, partitions/drafts;
- metric/imperial, different cell_cm, resize and optimize;
- deterministic collision at several viewports/zooms;
- View/kiosk/editor visibility and print-friendly golden;
- area совпадает с room card, length с live ruler для того же span;
- никакой config mutation от отображения слоя.