@cloud-ru/ds-bottom-sheet 2.1.1 → 2.1.2-preview-de7dadcf.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -19,6 +19,8 @@ Drag-индикатор 32×4px сверху — визуальная подск
19
19
  ### Backdrop (default `showBackdrop=true`)
20
20
  Полупрозрачная подложка. Click по backdrop'у вызывает `onClose`. При `showBackdrop={false}` фон не затемняется и click-outside не закрывает sheet.
21
21
 
22
+ `mode` задаёт поведение sheet: `regular` (по умолчанию) сохраняет стандартное закрытие; `aggressive` размывает фон и запрещает закрытие кликом по подложке; `forced` дополнительно отключает свайп независимо от `swipeEnabled`. Размытие применяется только при `showBackdrop={true}`.
23
+
22
24
  ### Non-modal (default `lockScroll=true`)
23
25
  По умолчанию sheet — модальный: фон затемнён и заблокирован для скролла. Для non-modal сценария (sheet поверх контента, с которым продолжают работать) передайте `lockScroll={false}` (страница под sheet'ом скроллится) — обычно вместе с `showBackdrop={false}`.
24
26
 
@@ -688,6 +690,7 @@ export function NonModal() {
688
690
  | `footerTestIds` | `{ approve?: string; cancel?: string; additional?: string \| undefined; } \| undefined` | — | Переопределение `data-test-id` собранных слотов футера (approve/cancel/additional). <br/> По умолчанию — собственные id `BottomSheet`. Адаптивные `Modal`/`Drawer` передают сюда свои <br/> `TEST_IDS.footer*`, чтобы футер метился одинаково на desktop-поверхности и в mobile-sheet'е. |
689
691
  | `lockScroll` | `boolean` | `true` | Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница <br/> под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с <br/> которым продолжают взаимодействовать). Обычно используется вместе с `showBackdrop={false}`. |
690
692
  | `media` | `PopupMediaProps` | — | Media-блок над шапкой: изображение / иконка либо произвольный `ReactNode`. |
693
+ | `mode` | `"aggressive"` \| `"forced"` \| `"regular"` | `'regular'` | Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона <br/> и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп. <br/> Размытие применяется только при `showBackdrop=true`. |
691
694
  | `onBackButtonClick` | `(() => void)` | — | Callback клика на back-кнопку (слева в шапке). <br/> Наличие callback'а рендерит ArrowLeft-кнопку. |
692
695
  | `onClose` | `() => void` | — | Колбэк закрытия (вызывается при click outside, Esc, swipe-down, browser-back). |
693
696
  | `onSnapIndexChange` | `((snapIndex: number) => void)` | — | Callback изменения активного snap'а (пересечение swipe-границы или click по UI). <br/> Не вызывается при программной смене controlled `snapIndex`. |
@@ -701,12 +704,14 @@ export function NonModal() {
701
704
  | `snapIndex` | `number` | — | Controlled-индекс активного snap'а. Если задан, sheet всегда находится на этом snap'е; <br/> swipe-up/down вызывают `onSnapIndexChange`, но не меняют позицию сами — consumer должен <br/> передать новое значение. |
702
705
  | `snapPoints` | `SnapPoint` | — | Массив фиксированных позиций sheet'а от меньшей к большей. По дефолту `undefined` — <br/> sheet `height: auto` с одним snap'ом по высоте контента. <br/> Пример: `[0.5, 1]` — sheet открывается на половину экрана, drag вверх раскрывает <br/> до full-viewport; drag вниз ниже `0.5` ведёт к закрытию. <br/> Контракт массива (движок не сортирует и не дедуплицирует — порядок и различимость на <br/> стороне потребителя): <br/> - строго по возрастанию: индекс `0` — самая компактная позиция, последний — top / expanded; <br/> - значения должны резолвиться в различные высоты (`['50%', 0.5]` на типичном вьюпорте дадут <br/> одну высоту → дубль-индекс будет недостижим свайпом); <br/> - `'fit-content'` имеет смысл только как ЕДИНСТВЕННЫЙ snap (без `snapPoints`); внутри массива <br/> фиксированных позиций его «контентная» высота не определена. |
703
706
  | `subtitle` | `ReactNode` | — | Текстовая строка-подзаголовок под title. |
704
- | `swipeEnabled` | `boolean` | `true` | Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point. <br/> При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом. |
707
+ | `swipeEnabled` | `boolean` | `true` | Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point. <br/> В режиме `forced` свайп отключён независимо от значения свойства. <br/> При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом. |
705
708
  | `title` | `ReactNode` | — | Заголовок в шапке. |
706
709
  | `withDividers` | `boolean` | `true` | Тонкие линии между topBar↔body и body↔footer: разграничивают закреплённые шапку и подвал <br/> от прокручиваемого под ними содержимого. Передайте `false`, чтобы убрать обе линии. |
707
710
 
708
711
  #### Related types
709
712
 
713
+ - `BottomSheetMode` = `"aggressive"` \| `"forced"` \| `"regular"`
714
+
710
715
  - `SnapPoint` = `number | "fit-content" | `${number}px` | `${number}%` | `${number}dvh` | `${number}svh` | `${number}lvh``
711
716
 
712
717
  ## Смотри также
@@ -949,6 +954,7 @@ export function CustomDisableMotions() {
949
954
  | `defaultSnapIndex` | `number` | `0` | Индекс snap'а, на котором sheet открывается по дефолту. Игнорируется при controlled `snapIndex`. |
950
955
  | `disableMotions` | `boolean` | `false` | Отключить анимации открытия / закрытия и перехода между snap-точками. |
951
956
  | `lockScroll` | `boolean` | `true` | Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница <br/> под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с <br/> которым продолжают взаимодействовать). Обычно используется вместе с `showBackdrop={false}`. |
957
+ | `mode` | `"aggressive"` \| `"forced"` \| `"regular"` | `'regular'` | Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона <br/> и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп. <br/> Размытие применяется только при `showBackdrop=true`. |
952
958
  | `onClose` | `() => void` | — | Колбэк закрытия (вызывается при click outside, Esc, swipe-down, browser-back). |
953
959
  | `onSnapIndexChange` | `((snapIndex: number) => void)` | — | Callback изменения активного snap'а (пересечение swipe-границы или click по UI). <br/> Не вызывается при программной смене controlled `snapIndex`. |
954
960
  | `open` | `boolean` | — | Управление состоянием показан / не показан. |
@@ -958,10 +964,12 @@ export function CustomDisableMotions() {
958
964
  | `showBackdrop` | `boolean` | `true` | Отображение тёмной подложки за sheet'ом. При `false` фон не затемняется и click-outside <br/> не закрывает sheet (нет backdrop-узла, по которому ловится клик). |
959
965
  | `snapIndex` | `number` | — | Controlled-индекс активного snap'а. Если задан, sheet всегда находится на этом snap'е; <br/> swipe-up/down вызывают `onSnapIndexChange`, но не меняют позицию сами — consumer должен <br/> передать новое значение. |
960
966
  | `snapPoints` | `SnapPoint` | — | Массив фиксированных позиций sheet'а от меньшей к большей. По дефолту `undefined` — <br/> sheet `height: auto` с одним snap'ом по высоте контента. <br/> Пример: `[0.5, 1]` — sheet открывается на половину экрана, drag вверх раскрывает <br/> до full-viewport; drag вниз ниже `0.5` ведёт к закрытию. <br/> Контракт массива (движок не сортирует и не дедуплицирует — порядок и различимость на <br/> стороне потребителя): <br/> - строго по возрастанию: индекс `0` — самая компактная позиция, последний — top / expanded; <br/> - значения должны резолвиться в различные высоты (`['50%', 0.5]` на типичном вьюпорте дадут <br/> одну высоту → дубль-индекс будет недостижим свайпом); <br/> - `'fit-content'` имеет смысл только как ЕДИНСТВЕННЫЙ snap (без `snapPoints`); внутри массива <br/> фиксированных позиций его «контентная» высота не определена. |
961
- | `swipeEnabled` | `boolean` | `true` | Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point. <br/> При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом. |
967
+ | `swipeEnabled` | `boolean` | `true` | Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point. <br/> В режиме `forced` свайп отключён независимо от значения свойства. <br/> При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом. |
962
968
 
963
969
  ##### Related types
964
970
 
971
+ - `BottomSheetMode` = `"aggressive"` \| `"forced"` \| `"regular"`
972
+
965
973
  - `SnapPoint` = `number | "fit-content" | `${number}px` | `${number}%` | `${number}dvh` | `${number}svh` | `${number}lvh``
966
974
 
967
975
  ### Смотри также
@@ -34,10 +34,12 @@ function resolveContainer(container, portalContextNode) {
34
34
  * Pointer-Events swipe / snap-engine. Готовая анатомия — `BottomSheet`.
35
35
  */
36
36
  function BottomSheetCustom(props) {
37
- const { open, onClose, showBackdrop = true, lockScroll = true, swipeEnabled = true, safeAreaTop = true, safeAreaBottom = true, snapPoints, defaultSnapIndex, snapIndex, onSnapIndexChange, closeOnPopstate = true, disableMotions = false, container, className, rootClassName, children, ...rest } = props;
37
+ const { open, onClose, showBackdrop = true, mode = constants_1.MODE.Regular, lockScroll = true, swipeEnabled = true, safeAreaTop = true, safeAreaBottom = true, snapPoints, defaultSnapIndex, snapIndex, onSnapIndexChange, closeOnPopstate = true, disableMotions = false, container, className, rootClassName, children, ...rest } = props;
38
38
  // Sheet модальный, если затемняет фон или лочит скролл. Non-modal не прячет фон от AT,
39
39
  // не ловит фокус и закрывается по Esc при фокусе снаружи.
40
40
  const isModal = showBackdrop || lockScroll;
41
+ const backdropBlur = mode !== constants_1.MODE.Regular;
42
+ const isSwipeEnabled = swipeEnabled && mode !== constants_1.MODE.Forced;
41
43
  (0, utils_1.useModalOpenState)(open, onClose, { closeOnPopstate });
42
44
  // Возврат фокуса на триггер: запоминаем активный элемент при open=true, возвращаем при open=false.
43
45
  const restoreFocusRef = (0, react_1.useRef)(null);
@@ -88,7 +90,7 @@ function BottomSheetCustom(props) {
88
90
  snapIndex,
89
91
  onSnapIndexChange,
90
92
  onClose,
91
- swipeEnabled,
93
+ swipeEnabled: isSwipeEnabled,
92
94
  isActive,
93
95
  });
94
96
  // Верхний safe-area отступ нужен только на full-height (верх под notch); флаг — в `data-full-height`.
@@ -99,9 +101,9 @@ function BottomSheetCustom(props) {
99
101
  setContentNode(node);
100
102
  }, [focusTrapRef, setContentNode]);
101
103
  const handleBackdropClick = (0, react_1.useCallback)(() => {
102
- if (showBackdrop)
104
+ if (showBackdrop && mode === constants_1.MODE.Regular)
103
105
  onClose();
104
- }, [showBackdrop, onClose]);
106
+ }, [showBackdrop, mode, onClose]);
105
107
  // Мобильная поверхность фиксирует только платформу webMobile, плотность наследуется от приложения.
106
108
  const themeClassName = (0, theme_1.useThemeClassnames)({ platform: theme_1.PLATFORM.WebMobile });
107
109
  if (!isMounted)
@@ -113,7 +115,7 @@ function BottomSheetCustom(props) {
113
115
  return (0, react_dom_1.createPortal)(
114
116
  // RemoveScroll лочит фон-скролл (refcount для вложенных sheet'ов); `enabled={lockScroll}` —
115
117
  // для non-modal фон остаётся прокручиваемым.
116
- (0, jsx_runtime_1.jsx)(react_remove_scroll_1.RemoveScroll, { enabled: lockScroll, children: (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)(styles_module_scss_1.default.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.backdrop, "data-test-id": constants_1.TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: (0, jsx_runtime_1.jsxs)("div", { ref: mergeRefCb, className: (0, classnames_1.default)(styles_module_scss_1.default.content, themeClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": constants_1.TEST_IDS.root, "data-safe-area-top": (safeAreaTop && isFullHeight) || undefined, "data-safe-area-bottom": safeAreaBottom || undefined, "data-snap-index": activeSnapIndex, "data-snap-points": snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined, "data-swipe-enabled": swipeEnabled || undefined, "data-dragging": isDragging || undefined, "data-full-height": isFullHeight || undefined, ...supportProps, ...(swipeEnabled ? dragHandlers : {}), children: [swipeEnabled && (0, jsx_runtime_1.jsx)(helperComponents_1.Handle, {}), (0, jsx_runtime_1.jsx)(popup_private_1.OverlaySurfaceProvider, { surface: popup_private_1.OVERLAY_SURFACE.Sheet, children: children })] }) })] }) }), targetNode);
118
+ (0, jsx_runtime_1.jsx)(react_remove_scroll_1.RemoveScroll, { enabled: lockScroll, children: (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)(styles_module_scss_1.default.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.backdrop, "data-backdrop-blur": backdropBlur || undefined, "data-test-id": constants_1.TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: (0, jsx_runtime_1.jsxs)("div", { ref: mergeRefCb, className: (0, classnames_1.default)(styles_module_scss_1.default.content, themeClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": constants_1.TEST_IDS.root, "data-safe-area-top": (safeAreaTop && isFullHeight) || undefined, "data-safe-area-bottom": safeAreaBottom || undefined, "data-snap-index": activeSnapIndex, "data-snap-points": snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined, "data-swipe-enabled": isSwipeEnabled || undefined, "data-dragging": isDragging || undefined, "data-full-height": isFullHeight || undefined, ...supportProps, ...(isSwipeEnabled ? dragHandlers : {}), children: [isSwipeEnabled && (0, jsx_runtime_1.jsx)(helperComponents_1.Handle, {}), (0, jsx_runtime_1.jsx)(popup_private_1.OverlaySurfaceProvider, { surface: popup_private_1.OVERLAY_SURFACE.Sheet, children: children })] }) })] }) }), targetNode);
117
119
  }
118
120
  BottomSheetCustom.Header = popup_private_1.PopupHeader;
119
121
  BottomSheetCustom.Body = popup_private_1.PopupBody;
@@ -14,6 +14,9 @@
14
14
  background-color:var(--sn-theme-color-blackout, var(--sn-brand-color-overlay-forLightMode-blackout, rgba(0, 0, 0, 0.3215686275)));
15
15
  transition:opacity 0.2s;
16
16
  }
17
+ .backdrop[data-backdrop-blur]{
18
+ backdrop-filter:blur(var(--sn-theme-effect-backgroundBlur, var(--sn-brand-effect-blur-overlay-backgroundBlur, 10px)));
19
+ }
17
20
  .root[data-active] .backdrop{
18
21
  opacity:1;
19
22
  }
@@ -20,3 +20,8 @@ export declare const SNAP_POINTS_PRESET: {
20
20
  /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
21
21
  halfFull: number[];
22
22
  };
23
+ export declare const MODE: {
24
+ readonly Regular: "regular";
25
+ readonly Aggressive: "aggressive";
26
+ readonly Forced: "forced";
27
+ };
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  // Общий overlay-chrome (media / footer-ориентация / слот-`data-test-id`) вынесен в `@cloud-ru/ds-popup-private`.
3
3
  Object.defineProperty(exports, "__esModule", { value: true });
4
- exports.SNAP_POINTS_PRESET = exports.NO_DRAG_ATTRIBUTE = exports.TEST_IDS = exports.MEDIA_KIND = exports.FOOTER_ACTIONS_ORIENTATION = void 0;
4
+ exports.MODE = exports.SNAP_POINTS_PRESET = exports.NO_DRAG_ATTRIBUTE = exports.TEST_IDS = exports.MEDIA_KIND = exports.FOOTER_ACTIONS_ORIENTATION = void 0;
5
5
  // Реэкспортируем под теми же именами — внешний контракт `@cloud-ru/ds-bottom-sheet` не меняется.
6
6
  var popup_private_1 = require("@cloud-ru/ds-popup-private");
7
7
  Object.defineProperty(exports, "FOOTER_ACTIONS_ORIENTATION", { enumerable: true, get: function () { return popup_private_1.FOOTER_ACTIONS_ORIENTATION; } });
@@ -28,3 +28,8 @@ exports.SNAP_POINTS_PRESET = {
28
28
  /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
29
29
  halfFull: [0.5, 1],
30
30
  };
31
+ exports.MODE = {
32
+ Regular: 'regular',
33
+ Aggressive: 'aggressive',
34
+ Forced: 'forced',
35
+ };
@@ -36,6 +36,9 @@
36
36
  background-color:var(--sn-theme-color-blackout, var(--sn-brand-color-overlay-forLightMode-blackout, rgba(0, 0, 0, 0.3215686275)));
37
37
  transition:opacity 0.2s;
38
38
  }
39
+ .backdrop[data-backdrop-blur]{
40
+ backdrop-filter:blur(var(--sn-theme-effect-backgroundBlur, var(--sn-brand-effect-blur-overlay-backgroundBlur, 10px)));
41
+ }
39
42
  .root[data-active] .backdrop{
40
43
  opacity:1;
41
44
  }
@@ -1,6 +1,8 @@
1
1
  import { BottomSheetActionButton, FooterActionsOrientation, PopupMediaProps } from '@cloud-ru/ds-popup-private';
2
- import { WithSupportProps } from '@cloud-ru/ds-utils';
2
+ import { ValueOf, WithSupportProps } from '@cloud-ru/ds-utils';
3
3
  import { PropsWithChildren, ReactNode } from 'react';
4
+ import { MODE } from './constants';
5
+ export type BottomSheetMode = ValueOf<typeof MODE>;
4
6
  export type { BottomSheetActionButton, FooterActionsOrientation, MediaKind, PopupBodyProps as BottomSheetBodyProps, PopupFooterProps as BottomSheetFooterProps, PopupHeaderProps as BottomSheetHeaderProps, PopupMediaProps as BottomSheetMediaProps, } from '@cloud-ru/ds-popup-private';
5
7
  /**
6
8
  * Фиксированная позиция bottom-sheet'а по высоте.
@@ -23,6 +25,13 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
23
25
  * @default true
24
26
  */
25
27
  showBackdrop?: boolean;
28
+ /**
29
+ * Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона
30
+ * и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп.
31
+ * Размытие применяется только при `showBackdrop=true`.
32
+ * @default 'regular'
33
+ */
34
+ mode?: BottomSheetMode;
26
35
  /**
27
36
  * Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
28
37
  * под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
@@ -32,6 +41,7 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
32
41
  lockScroll?: boolean;
33
42
  /**
34
43
  * Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
44
+ * В режиме `forced` свайп отключён независимо от значения свойства.
35
45
  * При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
36
46
  * @default true
37
47
  */
@@ -7,7 +7,7 @@ import cn from 'classnames';
7
7
  import { useCallback, useEffect, useRef } from 'react';
8
8
  import { createPortal } from 'react-dom';
9
9
  import { RemoveScroll } from 'react-remove-scroll';
10
- import { TEST_IDS } from '../../constants.js';
10
+ import { MODE, TEST_IDS } from '../../constants.js';
11
11
  import { Handle } from '../../helperComponents/index.js';
12
12
  import { CLOSING_TIMEOUT } from './constants.js';
13
13
  import { useDragEngine, useFocusTrap, useTransitionPhase } from './hooks/index.js';
@@ -28,10 +28,12 @@ function resolveContainer(container, portalContextNode) {
28
28
  * Pointer-Events swipe / snap-engine. Готовая анатомия — `BottomSheet`.
29
29
  */
30
30
  export function BottomSheetCustom(props) {
31
- const { open, onClose, showBackdrop = true, lockScroll = true, swipeEnabled = true, safeAreaTop = true, safeAreaBottom = true, snapPoints, defaultSnapIndex, snapIndex, onSnapIndexChange, closeOnPopstate = true, disableMotions = false, container, className, rootClassName, children, ...rest } = props;
31
+ const { open, onClose, showBackdrop = true, mode = MODE.Regular, lockScroll = true, swipeEnabled = true, safeAreaTop = true, safeAreaBottom = true, snapPoints, defaultSnapIndex, snapIndex, onSnapIndexChange, closeOnPopstate = true, disableMotions = false, container, className, rootClassName, children, ...rest } = props;
32
32
  // Sheet модальный, если затемняет фон или лочит скролл. Non-modal не прячет фон от AT,
33
33
  // не ловит фокус и закрывается по Esc при фокусе снаружи.
34
34
  const isModal = showBackdrop || lockScroll;
35
+ const backdropBlur = mode !== MODE.Regular;
36
+ const isSwipeEnabled = swipeEnabled && mode !== MODE.Forced;
35
37
  useModalOpenState(open, onClose, { closeOnPopstate });
36
38
  // Возврат фокуса на триггер: запоминаем активный элемент при open=true, возвращаем при open=false.
37
39
  const restoreFocusRef = useRef(null);
@@ -82,7 +84,7 @@ export function BottomSheetCustom(props) {
82
84
  snapIndex,
83
85
  onSnapIndexChange,
84
86
  onClose,
85
- swipeEnabled,
87
+ swipeEnabled: isSwipeEnabled,
86
88
  isActive,
87
89
  });
88
90
  // Верхний safe-area отступ нужен только на full-height (верх под notch); флаг — в `data-full-height`.
@@ -93,9 +95,9 @@ export function BottomSheetCustom(props) {
93
95
  setContentNode(node);
94
96
  }, [focusTrapRef, setContentNode]);
95
97
  const handleBackdropClick = useCallback(() => {
96
- if (showBackdrop)
98
+ if (showBackdrop && mode === MODE.Regular)
97
99
  onClose();
98
- }, [showBackdrop, onClose]);
100
+ }, [showBackdrop, mode, onClose]);
99
101
  // Мобильная поверхность фиксирует только платформу webMobile, плотность наследуется от приложения.
100
102
  const themeClassName = useThemeClassnames({ platform: PLATFORM.WebMobile });
101
103
  if (!isMounted)
@@ -107,7 +109,7 @@ export function BottomSheetCustom(props) {
107
109
  return createPortal(
108
110
  // RemoveScroll лочит фон-скролл (refcount для вложенных sheet'ов); `enabled={lockScroll}` —
109
111
  // для non-modal фон остаётся прокручиваемым.
110
- _jsx(RemoveScroll, { enabled: lockScroll, children: _jsxs("div", { className: cn(styles.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && (_jsx("div", { className: styles.backdrop, "data-test-id": TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), _jsx("div", { className: styles.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: _jsxs("div", { ref: mergeRefCb, className: cn(styles.content, themeClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": TEST_IDS.root, "data-safe-area-top": (safeAreaTop && isFullHeight) || undefined, "data-safe-area-bottom": safeAreaBottom || undefined, "data-snap-index": activeSnapIndex, "data-snap-points": snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined, "data-swipe-enabled": swipeEnabled || undefined, "data-dragging": isDragging || undefined, "data-full-height": isFullHeight || undefined, ...supportProps, ...(swipeEnabled ? dragHandlers : {}), children: [swipeEnabled && _jsx(Handle, {}), _jsx(OverlaySurfaceProvider, { surface: OVERLAY_SURFACE.Sheet, children: children })] }) })] }) }), targetNode);
112
+ _jsx(RemoveScroll, { enabled: lockScroll, children: _jsxs("div", { className: cn(styles.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && (_jsx("div", { className: styles.backdrop, "data-backdrop-blur": backdropBlur || undefined, "data-test-id": TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), _jsx("div", { className: styles.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: _jsxs("div", { ref: mergeRefCb, className: cn(styles.content, themeClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": TEST_IDS.root, "data-safe-area-top": (safeAreaTop && isFullHeight) || undefined, "data-safe-area-bottom": safeAreaBottom || undefined, "data-snap-index": activeSnapIndex, "data-snap-points": snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined, "data-swipe-enabled": isSwipeEnabled || undefined, "data-dragging": isDragging || undefined, "data-full-height": isFullHeight || undefined, ...supportProps, ...(isSwipeEnabled ? dragHandlers : {}), children: [isSwipeEnabled && _jsx(Handle, {}), _jsx(OverlaySurfaceProvider, { surface: OVERLAY_SURFACE.Sheet, children: children })] }) })] }) }), targetNode);
111
113
  }
112
114
  BottomSheetCustom.Header = PopupHeader;
113
115
  BottomSheetCustom.Body = PopupBody;
@@ -14,6 +14,9 @@
14
14
  background-color:var(--sn-theme-color-blackout, var(--sn-brand-color-overlay-forLightMode-blackout, rgba(0, 0, 0, 0.3215686275)));
15
15
  transition:opacity 0.2s;
16
16
  }
17
+ .backdrop[data-backdrop-blur]{
18
+ backdrop-filter:blur(var(--sn-theme-effect-backgroundBlur, var(--sn-brand-effect-blur-overlay-backgroundBlur, 10px)));
19
+ }
17
20
  .root[data-active] .backdrop{
18
21
  opacity:1;
19
22
  }
@@ -20,3 +20,8 @@ export declare const SNAP_POINTS_PRESET: {
20
20
  /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
21
21
  halfFull: number[];
22
22
  };
23
+ export declare const MODE: {
24
+ readonly Regular: "regular";
25
+ readonly Aggressive: "aggressive";
26
+ readonly Forced: "forced";
27
+ };
@@ -22,3 +22,8 @@ export const SNAP_POINTS_PRESET = {
22
22
  /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
23
23
  halfFull: [0.5, 1],
24
24
  };
25
+ export const MODE = {
26
+ Regular: 'regular',
27
+ Aggressive: 'aggressive',
28
+ Forced: 'forced',
29
+ };
@@ -36,6 +36,9 @@
36
36
  background-color:var(--sn-theme-color-blackout, var(--sn-brand-color-overlay-forLightMode-blackout, rgba(0, 0, 0, 0.3215686275)));
37
37
  transition:opacity 0.2s;
38
38
  }
39
+ .backdrop[data-backdrop-blur]{
40
+ backdrop-filter:blur(var(--sn-theme-effect-backgroundBlur, var(--sn-brand-effect-blur-overlay-backgroundBlur, 10px)));
41
+ }
39
42
  .root[data-active] .backdrop{
40
43
  opacity:1;
41
44
  }
@@ -1,6 +1,8 @@
1
1
  import { BottomSheetActionButton, FooterActionsOrientation, PopupMediaProps } from '@cloud-ru/ds-popup-private';
2
- import { WithSupportProps } from '@cloud-ru/ds-utils';
2
+ import { ValueOf, WithSupportProps } from '@cloud-ru/ds-utils';
3
3
  import { PropsWithChildren, ReactNode } from 'react';
4
+ import { MODE } from './constants.js';
5
+ export type BottomSheetMode = ValueOf<typeof MODE>;
4
6
  export type { BottomSheetActionButton, FooterActionsOrientation, MediaKind, PopupBodyProps as BottomSheetBodyProps, PopupFooterProps as BottomSheetFooterProps, PopupHeaderProps as BottomSheetHeaderProps, PopupMediaProps as BottomSheetMediaProps, } from '@cloud-ru/ds-popup-private';
5
7
  /**
6
8
  * Фиксированная позиция bottom-sheet'а по высоте.
@@ -23,6 +25,13 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
23
25
  * @default true
24
26
  */
25
27
  showBackdrop?: boolean;
28
+ /**
29
+ * Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона
30
+ * и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп.
31
+ * Размытие применяется только при `showBackdrop=true`.
32
+ * @default 'regular'
33
+ */
34
+ mode?: BottomSheetMode;
26
35
  /**
27
36
  * Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
28
37
  * под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
@@ -32,6 +41,7 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
32
41
  lockScroll?: boolean;
33
42
  /**
34
43
  * Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
44
+ * В режиме `forced` свайп отключён независимо от значения свойства.
35
45
  * При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
36
46
  * @default true
37
47
  */