houseplan-card/docs/specs/041-keyboard-object-editing.md

# ТЗ #41 — Клавиатурное редактирование выбранных объектов

- Issue: https://github.com/Matysh/houseplan-card/issues/41
- Приоритет: P2
- Статус ТЗ: prototype-first draft
- Scope: desktop editors; touch editing остаётся best-effort

## Цель Stage 1

Выбирать существующие объекты, открывать свойства, удалять и точно сдвигать их
по сетке без мыши. Полное рисование arbitrary polygon клавиатурой не входит.

## Focus model

Каждый editor предоставляет один `EditorObjectNavigator` с roving tabindex по
объектам текущего editable layer и стабильным spatial order: top→bottom,
left→right, затем id. Tab входит/выходит из navigator один раз; стрелки при
навигации выбирают соседний объект, а не прокручивают page.

Режимы:

- `navigate`: стрелки меняют selection;
- `move` после Space или явной tray action: стрелки двигают selected object;
  Escape отменяет gesture до command commit, Enter завершает.

Так устраняется конфликт «стрелка выбирает или двигает». Pointer selection
синхронизирует active descendant.

## Команды

- Enter — свойства выбранного объекта;
- Delete/Backspace — только delete выбранного через #32 там, где требуется;
- Space — начать/закончить keyboard move;
- arrows move = один grid node; Shift+arrow = 10 nodes;
- Escape — отмена move, затем selection/tool по существующему приоритету;
- Ctrl+Z/Ctrl+Shift+Z — общий named command stack.

Команды запрещены при focus в input/textarea/select/contenteditable/dialog.
Browser scroll/pan shortcuts остаются вне navigator.

## Geometry semantics

Move применяет существующие snap/validation/command APIs объекта. Room vertices
и wall resize не входят в Stage 1; целиком movable markers, openings вдоль
wall, partitions, columns и decor входят по мере наличия безопасной команды.
Невалидный move не commit-ится и объявляет причину.

## Announcements

`aria-live=polite`: выбран тип/имя; move start; координаты/длина/угол после
шага; invalid reason; Undo/Redo command name. Частые key repeats throttled, но
финальное значение всегда объявляется.

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

- prototype доказывает отсутствие scroll/pan/form conflicts;
- navigator order после add/delete/space change;
- move every supported object, invalid/opening constraints, command undo;
- focus restore после property/confirm dialog;
- NVDA/Chrome manual checklist и browser keyboard smoke;
- unsupported object имеет свойства/delete, но не ложно доступный Move.