@cloud-ru/ds-bottom-sheet 2.1.2-preview-87834313.0 → 2.1.2-preview-b67f9a8d.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,7 +19,7 @@ Drag-индикатор 32×4px сверху — визуальная подск
19
19
  ### Backdrop (default `showBackdrop=true`)
20
20
  Полупрозрачная подложка. Click по backdrop'у вызывает `onClose`. При `showBackdrop={false}` фон не затемняется и click-outside не закрывает sheet.
21
21
 
22
- `backdropBlur` включает размытие фона под подложкой. По умолчанию выключено; при `showBackdrop={false}` не применяется.
22
+ `mode` задаёт поведение sheet: `regular` (по умолчанию) сохраняет стандартное закрытие; `aggressive` размывает фон и запрещает закрытие кликом по подложке; `forced` дополнительно отключает свайп независимо от `swipeEnabled`. Размытие применяется только при `showBackdrop={true}`.
23
23
 
24
24
  ### Non-modal (default `lockScroll=true`)
25
25
  По умолчанию sheet — модальный: фон затемнён и заблокирован для скролла. Для non-modal сценария (sheet поверх контента, с которым продолжают работать) передайте `lockScroll={false}` (страница под sheet'ом скроллится) — обычно вместе с `showBackdrop={false}`.
@@ -677,7 +677,6 @@ export function NonModal() {
677
677
  | `actionButton` | `ReactNode` | — | Action-кнопка справа в шапке (любой ReactNode — обычно `Button view='function'`). |
678
678
  | `additionalButton` | `BottomSheetActionButton` | — | Дополнительная (третья) кнопка — объект пропсов `Button` (по умолчанию `view='simple'`, <br/> `appearance='neutral'`). |
679
679
  | `approveButton` | `BottomSheetActionButton` | — | Основная кнопка действия — объект пропсов `Button` (по умолчанию `view='filled'`, <br/> `appearance='primary'`). Ширина зависит от `footerActionsOrientation` и числа кнопок. |
680
- | `backdropBlur` | `boolean` | `false` | Размытие фона под подложкой. Применяется только при `showBackdrop=true`. |
681
680
  | `bodyPadding` | `boolean` | `true` | Горизонтальные паддинги body. При `false` контент идёт во всю ширину (edge-to-edge) — для карт, <br/> изображений, списков без отступов. Соответствует Figma-оси `padding=false`. |
682
681
  | `cancelButton` | `BottomSheetActionButton` | — | Кнопка отмены — объект пропсов `Button` (по умолчанию `view='outline'`, `appearance='neutral'`). |
683
682
  | `className` | `string` | — | CSS-класс самого sheet-контейнера. |
@@ -691,6 +690,7 @@ export function NonModal() {
691
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'е. |
692
691
  | `lockScroll` | `boolean` | `true` | Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница <br/> под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с <br/> которым продолжают взаимодействовать). Обычно используется вместе с `showBackdrop={false}`. |
693
692
  | `media` | `PopupMediaProps` | — | Media-блок над шапкой: изображение / иконка либо произвольный `ReactNode`. |
693
+ | `mode` | `"aggressive"` \| `"forced"` \| `"regular"` | `'regular'` | Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона <br/> и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп. <br/> Размытие применяется только при `showBackdrop=true`. |
694
694
  | `onBackButtonClick` | `(() => void)` | — | Callback клика на back-кнопку (слева в шапке). <br/> Наличие callback'а рендерит ArrowLeft-кнопку. |
695
695
  | `onClose` | `() => void` | — | Колбэк закрытия (вызывается при click outside, Esc, swipe-down, browser-back). |
696
696
  | `onSnapIndexChange` | `((snapIndex: number) => void)` | — | Callback изменения активного snap'а (пересечение swipe-границы или click по UI). <br/> Не вызывается при программной смене controlled `snapIndex`. |
@@ -704,12 +704,14 @@ export function NonModal() {
704
704
  | `snapIndex` | `number` | — | Controlled-индекс активного snap'а. Если задан, sheet всегда находится на этом snap'е; <br/> swipe-up/down вызывают `onSnapIndexChange`, но не меняют позицию сами — consumer должен <br/> передать новое значение. |
705
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/> фиксированных позиций его «контентная» высота не определена. |
706
706
  | `subtitle` | `ReactNode` | — | Текстовая строка-подзаголовок под title. |
707
- | `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'ом. |
708
708
  | `title` | `ReactNode` | — | Заголовок в шапке. |
709
709
  | `withDividers` | `boolean` | `true` | Тонкие линии между topBar↔body и body↔footer: разграничивают закреплённые шапку и подвал <br/> от прокручиваемого под ними содержимого. Передайте `false`, чтобы убрать обе линии. |
710
710
 
711
711
  #### Related types
712
712
 
713
+ - `BottomSheetMode` = `"aggressive"` \| `"forced"` \| `"regular"`
714
+
713
715
  - `SnapPoint` = `number | "fit-content" | `${number}px` | `${number}%` | `${number}dvh` | `${number}svh` | `${number}lvh``
714
716
 
715
717
  ## Смотри также
@@ -944,7 +946,6 @@ export function CustomDisableMotions() {
944
946
 
945
947
  | Prop | Type | Default | Description |
946
948
  |------|------|---------|-------------|
947
- | `backdropBlur` | `boolean` | `false` | Размытие фона под подложкой. Применяется только при `showBackdrop=true`. |
948
949
  | `children` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | |
949
950
  | `className` | `string` | — | CSS-класс самого sheet-контейнера. |
950
951
  | `closeOnPopstate` | `boolean` | `true` | Закрывать sheet при `popstate` (browser-back на mobile). |
@@ -953,6 +954,7 @@ export function CustomDisableMotions() {
953
954
  | `defaultSnapIndex` | `number` | `0` | Индекс snap'а, на котором sheet открывается по дефолту. Игнорируется при controlled `snapIndex`. |
954
955
  | `disableMotions` | `boolean` | `false` | Отключить анимации открытия / закрытия и перехода между snap-точками. |
955
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`. |
956
958
  | `onClose` | `() => void` | — | Колбэк закрытия (вызывается при click outside, Esc, swipe-down, browser-back). |
957
959
  | `onSnapIndexChange` | `((snapIndex: number) => void)` | — | Callback изменения активного snap'а (пересечение swipe-границы или click по UI). <br/> Не вызывается при программной смене controlled `snapIndex`. |
958
960
  | `open` | `boolean` | — | Управление состоянием показан / не показан. |
@@ -962,10 +964,12 @@ export function CustomDisableMotions() {
962
964
  | `showBackdrop` | `boolean` | `true` | Отображение тёмной подложки за sheet'ом. При `false` фон не затемняется и click-outside <br/> не закрывает sheet (нет backdrop-узла, по которому ловится клик). |
963
965
  | `snapIndex` | `number` | — | Controlled-индекс активного snap'а. Если задан, sheet всегда находится на этом snap'е; <br/> swipe-up/down вызывают `onSnapIndexChange`, но не меняют позицию сами — consumer должен <br/> передать новое значение. |
964
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/> фиксированных позиций его «контентная» высота не определена. |
965
- | `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'ом. |
966
968
 
967
969
  ##### Related types
968
970
 
971
+ - `BottomSheetMode` = `"aggressive"` \| `"forced"` \| `"regular"`
972
+
969
973
  - `SnapPoint` = `number | "fit-content" | `${number}px` | `${number}%` | `${number}dvh` | `${number}svh` | `${number}lvh``
970
974
 
971
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, backdropBlur = false, 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-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": 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;
@@ -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
+ };
@@ -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'а по высоте.
@@ -24,10 +26,12 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
24
26
  */
25
27
  showBackdrop?: boolean;
26
28
  /**
27
- * Размытие фона под подложкой. Применяется только при `showBackdrop=true`.
28
- * @default false
29
+ * Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона
30
+ * и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп.
31
+ * Размытие применяется только при `showBackdrop=true`.
32
+ * @default 'regular'
29
33
  */
30
- backdropBlur?: boolean;
34
+ mode?: BottomSheetMode;
31
35
  /**
32
36
  * Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
33
37
  * под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
@@ -37,6 +41,7 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
37
41
  lockScroll?: boolean;
38
42
  /**
39
43
  * Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
44
+ * В режиме `forced` свайп отключён независимо от значения свойства.
40
45
  * При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
41
46
  * @default true
42
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, backdropBlur = false, 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-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": 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;
@@ -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
+ };
@@ -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'а по высоте.
@@ -24,10 +26,12 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
24
26
  */
25
27
  showBackdrop?: boolean;
26
28
  /**
27
- * Размытие фона под подложкой. Применяется только при `showBackdrop=true`.
28
- * @default false
29
+ * Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона
30
+ * и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп.
31
+ * Размытие применяется только при `showBackdrop=true`.
32
+ * @default 'regular'
29
33
  */
30
- backdropBlur?: boolean;
34
+ mode?: BottomSheetMode;
31
35
  /**
32
36
  * Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
33
37
  * под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
@@ -37,6 +41,7 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
37
41
  lockScroll?: boolean;
38
42
  /**
39
43
  * Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
44
+ * В режиме `forced` свайп отключён независимо от значения свойства.
40
45
  * При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
41
46
  * @default true
42
47
  */