feat(useSnackbar): add snackbar manager

[EldarMuhamethanov]

• Unit-тесты
• e2e-тесты
• Документация фичи
• Release notes

Описание

Добавлен новый хук useSnackbarManager для централизованного управления снекбарами в приложении. Хук предоставляет удобный API для открытия, закрытия и обновления снекбаров, поддерживает очередь снекбаров с настраиваемым лимитом и стратегией переполнения, а также позволяет создавать кастомные снекбары.

В рамках этой работы также переименовано свойство onClose в onClosed в компоненте Snackbar для улучшения семантики (обработчик теперь вызывается после окончания анимации закрытия, а не в момент начала закрытия). Для автоматической миграции добавлен codemod.

Изменения

Новый хук useSnackbarManager

• Добавлен хук useSnackbarManager с полным API для управления снекбарами:

  • open(config) - открытие снекбара с конфигурацией
  • openCustom(payload) - открытие кастомного снекбара с произвольным компонентом
  • update(id, config) - обновление свойств существующего снекбара
  • close(id) - закрытие снекбара по ID
  • closeAll() - закрытие всех снекбаров
  • Методы для настройки: setLimit, setQueueStrategy, setVerticalOffsetYStart, setVerticalOffsetYEnd, setZIndex

• Реализована система управления состоянием снекбаров через store с подписками

• Добавлена поддержка очереди снекбаров с двумя стратегиями: queue (ожидание места) и shift (закрытие старых)

• Реализована поддержка кастомных снекбаров через openCustom

• Добавлены компоненты SnackbarsContainer и SnackbarAnimatedWrapper для отображения снекбаров

• Добавлен контекст SnackbarsContainerContext для интеграции снекбаров с менеджером

Изменения в компоненте Snackbar

• Переименовано свойство onClose в onClosed (breaking change)
• onClosed теперь вызывается после окончания анимации закрытия (ранее onClose вызывался в момент начала закрытия)
• Добавлена поддержка работы внутри SnackbarsContainer через контекст
• Обновлены стили для поддержки как фиксированного позиционирования (standalone), так и работы внутри контейнера

Codemod для миграции

• Добавлен codemod snackbar для автоматического переименования onClose в onClosed во всех использованиях компонента Snackbar

Документация

• Добавлена документация для хука useSnackbarManager с примерами использования
• Добавлены примеры работы с кастомными снекбарами
• Обновлена документация компонента Snackbar с упоминанием нового хука

Вспомогательные изменения

• Обновлен хук useCSSKeyframesAnimationController для поддержки stopPropagation
• Добавлена зависимость uuid для генерации уникальных ID снекбаров
• Обновлены все использования Snackbar в кодовой базе для использования нового API

Release notes

Новые компоненты

• useSnackbarManager: хук для централизованного управления снекбарами в приложении

  Хук предоставляет удобный API для работы со снекбарами: открытие, закрытие, обновление, поддержка очереди с настраиваемым лимитом и стратегией переполнения. Также поддерживает создание кастомных снекбаров с произвольным компонентом.

BREAKING CHANGE

• Snackbar: переименовано свойство onClose в onClosed

  Свойство onClose переименовано в onClosed для улучшения семантики. Обработчик onClosed вызывается после окончания анимации закрытия снекбара, а не в момент начала закрытия.
  Пример миграции:

  - <Snackbar onClose={() => setSnackbar(null)}>
  + <Snackbar onClosed={() => setSnackbar(null)}>
    Message
  </Snackbar>

[inomdzhon]

ну-с, с Богом 🫡