Files
glchat/web/src/lib/unsavedChanges.ts
T
grendervill 085454d555 feat(web): палитра команд Ctrl/Cmd+K и подтверждение выхода с несохранёнными правками
Два требования desktop-клиента (docs/client-tauri.md §5), которые живут в
веб-слое — том же, что и в браузере:

- **Палитра команд.** Ctrl/Cmd+K (на документе или сообщением `openPalette` от
  обёртки) открывает быстрый переход: серверы (в первую доступную комнату),
  комнаты выбранного сервера с группировкой по категориям, личные беседы из уже
  загруженного снапшота, действия (настройки профиля/безопасности/внешнего вида,
  настройки сервера, создание сервера, друзья, микрофон и «не слышу» при
  активной голосовой сессии). Новых запросов палитра не делает; поиск по
  подстроке без учёта регистра, 8 пунктов на раздел, стрелки со
  `scrollIntoView`, `role=listbox/option` и `aria-activedescendant`;

- **Подтверждение выхода.** Формы с локальным черновиком регистрируются в общем
  реестре (`stores/unsaved.ts` + хук `useUnsavedChanges`): платформа получает
  один `setDirty` на переход «есть правки / нет правок», а на сообщение обёртки
  `closeRequested` клиент отвечает тряской контента и диалогом «Сохранить /
  Выйти без сохранения». При `prefers-reduced-motion: reduce` тряску заменяет
  подсветка рамки; в браузере вместо сообщения обёртки работает штатный
  `beforeunload`. Хук добавлен в формы с явной кнопкой «Сохранить»:
  профиль, общие настройки сервера, ник, эмодзи, звуки, оформление, вебхуки,
  лимиты инстанса, переименование сервера (автосохраняемые переключатели
  намеренно не помечаются);

- Deep link `glchat://dm/<channelId>` (личная беседа без сервера) — его
  присылает обёртка при клике по уведомлению о личном сообщении.

Тесты: 525 passed (501 база + 24 новых) — палитра, реестр правок, диалог
закрытия, `beforeunload`, разбор ссылок; `npm run check` и `npm run lint` зелёные.
2026-09-22 23:17:32 +03:00

38 lines
1.7 KiB
TypeScript

import { useEffect, useId, useRef } from 'react';
import { useUnsavedStore, type SaveHandler } from '@/stores/unsaved';
export interface UnsavedChangesOptions {
/** Есть ли в форме несохранённый черновик. */
dirty: boolean;
/** Сохранение формы — та же операция, что и у кнопки «Сохранить». */
save: SaveHandler;
}
/**
* Регистрирует форму в реестре несохранённых изменений, пока `dirty === true`
* (docs/client-tauri.md §5). Запись снимается при размонтировании формы и при
* возврате `dirty` в `false` — например, сразу после успешного сохранения.
*
* `save` хранится в ref: формы пересобирают обработчик на каждом рендере
* (он замкнут на текущее состояние полей), а регистрация должна оставаться
* одной — иначе реестр «мигал» бы на каждый введённый символ.
*/
export function useUnsavedChanges({ dirty, save }: UnsavedChangesOptions): void {
// id компонента вместо счётчика: уникален и не зависит от порядка рендера.
const id = useId();
const register = useUnsavedStore((state) => state.register);
const saveRef = useRef(save);
useEffect(() => {
saveRef.current = save;
});
useEffect(() => {
if (!dirty) {
return;
}
return register(id, () => saveRef.current());
}, [dirty, id, register]);
}