feat(useSnackbarManager): imperative snackbar API

[EldarMuhamethanov]

• Unit-тесты
• e2e-тесты
• Дизайн-ревью
• Документация фичи
• Release notes

Описание

Добавлен императивный API для управления снекбарами: можно вызывать показ/закрытие уведомлений через глобальный объект snackbarManager или свой экземпляр из createSnackbarManager(), без использования хука useSnackbarManager в месте вызова.

Основное:

• snackbarManager — глобальный экземпляр; вызов snackbarManager.open({ children: '...' }) из любого места (компонент, сервис, колбэк). Контейнер для снекбаров монтируется автоматически при первом вызове open() или openCustom().
• SnackbarManagerHolder — опциональный React-компонент для кастомной конфигурации (limit, offsetY, zIndex и т.д.). Если он уже смонтирован в дереве, авто-монтирование не создаёт второй контейнер.
• createSnackbarManager(options?) — создание отдельного экземпляра менеджера (например, для своей зоны интерфейса).

Поведение хука useSnackbarManager сохранено без изменений. Логика действий (open, close, update и т.д.) вынесена в общую функцию createSnackbarActions, которую используют и хук, и императивный менеджер.

Release notes

Улучшения

• useSnackbarManager: добавлен императивный API для снекбаров — глобальный snackbarManager и createSnackbarManager() позволяют показывать уведомления из любого места без хука. Контейнер монтируется автоматически при первом вызове open().

[github-actions]

size-limit report 📦

Path	Size
JS	427.03 KB (+4.27% 🔺)
JS (gzip)	130.62 KB (+4.2% 🔺)
JS (brotli)	107.58 KB (+3.67% 🔺)
JS import Div (tree shaking)	811 B (0%)
CSS	376.05 KB (0%)
CSS (gzip)	46.26 KB (0%)
CSS (brotli)	36.62 KB (0%)

[github-actions]

e2e tests

Playwright Report

[github-actions]

📊 Найдены изменения в собранных файлах: Отчет

Commit 7bfa829

[github-actions]

👀 Docs deployed

• ✅ Website
• ✅ Playground

📦 Package ✅

yarn add @vkontakte/vkui@https://development.s3.prodcloud.vk.team/pull/9514/7bfa829ccb1a3427c01c268cacfe4d3aa8bc80e2/pkg/@vkontakte/vkui/_pkg.tgz

Commit 7bfa829

[codecov]

Codecov Report

❌ Patch coverage is 85.41667% with 28 lines in your changes missing coverage. Please review.
✅ Project coverage is 95.16%. Comparing base (ef4c213) to head (7bfa829).
⚠️ Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
...ui/src/hooks/useSnackbarManager/snackbarManager.ts	75.51%	24 Missing ⚠️
...ackbarManager/components/SnackbarManagerHolder.tsx	88.46%	3 Missing ⚠️
...c/hooks/useSnackbarManager/helpers/useIsDesktop.ts	85.71%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #9514      +/-   ##
==========================================
- Coverage   95.31%   95.16%   -0.16%     
==========================================
  Files         441      445       +4     
  Lines       12112    12245     +133     
  Branches     4405     4427      +22     
==========================================
+ Hits        11545    11653     +108     
- Misses        567      592      +25     

Flag	Coverage Δ
unittests	95.16% <85.41%> (-0.16%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.