feat(ui): keyboard navigation and focus restore in album grid

- Cursor separate from selection; arrow keys move it, Space/Shift+Arrow/Enter/Esc act - Click on empty grid space clears selection back to album properties - Focus returns to the last viewed photo after closing the viewer
2026-10-11 14:51:00 +03:00
parent d99ac77587
commit 7359495a73
9 changed files with 588 additions and 5 deletions
@@ -0,0 +1,123 @@
+# Spec Delta
+
+## ADDED Requirements
+
+### Requirement: Курсор в сетке фото
+Сетка SHALL хранить курсор — текущую ячейку, отдельную от выделения. Перемещение курсора SHALL
+не менять выделение и не обновлять правую панель. Курсор SHALL отображаться контуром,
+отличимым от рамки выделения, SHALL сохраняться при снятии выделения и SHALL устанавливаться
+на фото при клике по нему мышью.
+
+#### Scenario: Синхронизация с мышью
+- **WHEN** пользователь кликает по фото в сетке
+- **THEN** фото выделено, а курсор установлен на нём
+
+#### Scenario: Перемещение не меняет выделение
+- **WHEN** фокус в сетке и пользователь нажимает стрелку
+- **THEN** курсор перемещается, а выделение и правая панель не меняются
+
+#### Scenario: Курсор переживает снятие выделения
+- **WHEN** выделение снято кликом по пустому месту или клавишей Esc
+- **THEN** курсор остаётся на прежней ячейке
+
+#### Scenario: Отображение курсора
+- **WHEN** сетка в фокусе и у курсора есть ячейка
+- **THEN** ячейка показывает контур, отличимый от рамки выделения, и он скрывается при уходе фокуса из сетки
+
+### Requirement: Клавиши сетки фото
+При фокусе в сетке клавиши SHALL управлять курсором и выделением: `←`/`→` — на соседнее фото с
+переходом на соседнюю строку, `↑`/`↓` — на строку (`density.cols`) с упором в границы.
+`Space` SHALL переключать выделение ячейки под курсором, `Shift`+стрелки — двигать курсор и
+расширять выделение от якоря, `Enter` — открывать просмотр, `Esc` — снимать выделение. Вне
+фокуса сетки клавиши SHALL не действовать.
+
+#### Scenario: Горизонтальное перемещение
+- **WHEN** курсор не в конце строки и нажато `→`
+- **THEN** курсор переходит на следующее фото
+
+#### Scenario: Перенос на соседнюю строку
+- **WHEN** курсор в конце строки и нажато `→`
+- **THEN** курсор переходит на первое фото следующей строки
+
+#### Scenario: Вертикальные границы
+- **WHEN** курсор в верхней или нижней строке и нажато `↑` или `↓`
+- **THEN** курсор остаётся на месте, без переноса
+
+#### Scenario: Переключение выделения
+- **WHEN** нажато `Space`
+- **THEN** ячейка под курсором добавляется или убирается из выделения, а правая панель обновляется
+
+#### Scenario: Расширение выделения
+- **WHEN** нажато `Shift` вместе со стрелкой
+- **THEN** курсор двигается, а выделение расширяется от якоря до курсора
+
+#### Scenario: Открытие просмотра
+- **WHEN** нажато `Enter`
+- **THEN** открывается просмотр фото под курсором
+
+#### Scenario: Снятие выделения клавишей
+- **WHEN** нажато `Esc`
+- **THEN** выделение снимается, а курсор остаётся
+
+#### Scenario: Прокрутка к курсору
+- **WHEN** курсор перемещается за пределы видимой области сетки
+- **THEN** сетка прокручивается так, чтобы ячейка под курсором стала видимой
+
+#### Scenario: Догрузка при выходе за загруженные фото
+- **WHEN** курсор на последнем загруженном фото и нажата стрелка в сторону следующих фото
+- **THEN** следующая порция фото догружается, а курсор переходит на следующее фото
+
+#### Scenario: Вне фокуса сетки
+- **WHEN** фокус находится в поле ввода или диалоге и нажаты стрелки или `Space`
+- **THEN** курсор и выделение сетки не меняются
+
+### Requirement: Снятие выделения кликом по пустому месту
+Клик по области сетки и её отступам, не по фото и не по органам управления тулбара, рейла и
+панелей, SHALL снимать выделение и возвращать в правой панели свойства альбома. Фокус SHALL
+оставаться в сетке, чтобы клавиши продолжали действовать.
+
+#### Scenario: Клик по пустому месту
+- **WHEN** есть выделение и пользователь кликает по пустому месту сетки или её отступам
+- **THEN** выделение снято, а правая панель показывает свойства альбома
+
+#### Scenario: Мультивыделение
+- **WHEN** выделено несколько фото и пользователь кликает по пустому месту
+- **THEN** выделение снимается полностью
+
+#### Scenario: Клик по фото
+- **WHEN** пользователь кликает по фото
+- **THEN** выделение устанавливается на фото, а не снимается
+
+#### Scenario: Клик по органам управления
+- **WHEN** пользователь кликает по кнопке тулбара, элементу рейла или панели
+- **THEN** выделение не снимается
+
+#### Scenario: Фокус остаётся в сетке
+- **WHEN** выделение снято кликом по пустому месту
+- **THEN** стрелки продолжают двигать курсор без дополнительного Tab
+
+### Requirement: Возврат фокуса из просмотра
+При возврате в альбом из просмотра сетка SHALL выделить последнее просмотренное фото (одиночное),
+поставить на него курсор, вернуть фокус в сетку и прокрутить к ячейке. Если фото нет среди
+загруженных, сетка SHALL догружать страницы, пока оно не появится. Восстановление SHALL
+применяться только к тому альбому, из которого был открыт просмотр.
+
+#### Scenario: Возврат из просмотра
+- **WHEN** пользователь открыл фото и закрыл просмотр
+- **THEN** в сетке это фото выделено, курсор на нём, фокус в сетке, а ячейка прокручена в видимую область
+
+#### Scenario: Последнее просмотренное фото
+- **WHEN** пользователь пролистал несколько фото в просмотре и закрыл его
+- **THEN** восстанавливается последнее просмотренное фото
+
+#### Scenario: Фото вне первой страницы
+- **WHEN** просмотренное фото отсутствует в первой загруженной странице
+- **THEN** сетка догружает страницы, пока фото не появится, и только затем ставит на него курсор
+
+#### Scenario: Возврат в другой альбом
+- **WHEN** после просмотра пользователь открывает другой альбом
+- **THEN** восстановление не применяется, выборка пуста
+
+#### Scenario: Клавиатура после возврата
+- **WHEN** фокус восстановлен после просмотра
+- **THEN** стрелки сразу двигают курсор без дополнительного Tab