houseplan-card/docs/specs/034-frontend-decomposition.md

# ТЗ #34 — Поэтапная декомпозиция frontend

- Issue: https://github.com/Matysh/houseplan-card/issues/34
- Приоритет: P1
- Статус ТЗ: выполняется по slices
- Тип изменения: refactor-only, без пользовательского поведения

## Исходное состояние и цель

`src/houseplan-card.ts` сейчас около 14,9 тыс. строк, `styles.ts` — около 2,8
тыс. Корневой Lit-компонент должен стать composition/lifecycle shell, целевой
ориентир — менее 3500 строк после серии independently releasable slices.

## Правила slice

1. Один PR/этап переносит одну законченную ответственность вместе с types,
   pure tests и owned styles.
2. Внешний DOM, i18n keys, stored payload, command names, pointer thresholds и
   render order не меняются.
3. Существующие geometry/device/sun/vacuum pure modules остаются authority;
   вторая модель запрещена.
4. Новый product code использует `unknown` + guards; `any` допустим только в
   явно названном HA adapter boundary.
5. До/после slice проходит одинаковый test/golden/performance set.

## Целевая структура

- `app/`: card composition, normalized store, navigation/viewport;
- `editors/{plan,devices,decor}`: typed state machines и commands;
- `render/`: immutable projections для rooms/walls/openings/lighting/devices/vacuum;
- `dialogs/`: draft models, validation, serialization, render components;
- `components/`: общие dialog/confirm/color/tray primitives.

## Порядок

### Slice 1 — малые dialog models

Вынести partition/column property draft: `fromConfig`, validation,
`toPatch`, equality. Root сохраняет callbacks и geometry commands.

### Slice 2 — render-only layers

По одному: room shapes/hover, wall body, lighting, device overlay, vacuum.
Input — frozen projection; output — template + typed callbacks без store access.

### Slice 3 — крупные dialog models

Room/opening → space → device/settings. Не смешивать с IA #30.

### Slice 4 — editor controllers

Plan, Devices, Decor pointer/keyboard state machines; command stack остаётся
общим интерфейсом.

### Slice 5 — store/navigation/styles

Revision/conflict/save orchestration, warm viewport, затем scoped styles.

## Метрики и gate

- root lines и доля TS монотонно уменьшаются;
- feature module обычно <800 строк, исключение документируется;
- `any` count не растёт;
- circular import check, bundle size/perf budgets;
- no-op config roundtrip, complete smoke и reviewed golden без delta.

## Приёмка

Каждый slice может быть отдельно reverted/released, не содержит feature work и
имеет architectural note. Финал достигает целевой роли root и удаляет
временные compatibility adapters.