@cloud-ru/ds-bottom-sheet 1.0.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.
Files changed (108) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/LICENSE +201 -0
  3. package/README.md +997 -0
  4. package/dist/cjs/components/BottomSheet/BottomSheet.d.ts +3 -0
  5. package/dist/cjs/components/BottomSheet/BottomSheet.js +39 -0
  6. package/dist/cjs/components/BottomSheet/index.d.ts +1 -0
  7. package/dist/cjs/components/BottomSheet/index.js +17 -0
  8. package/dist/cjs/components/BottomSheet/styles.module.css +27 -0
  9. package/dist/cjs/components/BottomSheetCustom/BottomSheetCustom.d.ts +19 -0
  10. package/dist/cjs/components/BottomSheetCustom/BottomSheetCustom.js +121 -0
  11. package/dist/cjs/components/BottomSheetCustom/constants.d.ts +30 -0
  12. package/dist/cjs/components/BottomSheetCustom/constants.js +33 -0
  13. package/dist/cjs/components/BottomSheetCustom/hooks/index.d.ts +3 -0
  14. package/dist/cjs/components/BottomSheetCustom/hooks/index.js +19 -0
  15. package/dist/cjs/components/BottomSheetCustom/hooks/useDragEngine.d.ts +44 -0
  16. package/dist/cjs/components/BottomSheetCustom/hooks/useDragEngine.js +312 -0
  17. package/dist/cjs/components/BottomSheetCustom/hooks/useFocusTrap.d.ts +7 -0
  18. package/dist/cjs/components/BottomSheetCustom/hooks/useFocusTrap.js +77 -0
  19. package/dist/cjs/components/BottomSheetCustom/hooks/useTransitionPhase.d.ts +22 -0
  20. package/dist/cjs/components/BottomSheetCustom/hooks/useTransitionPhase.js +51 -0
  21. package/dist/cjs/components/BottomSheetCustom/index.d.ts +1 -0
  22. package/dist/cjs/components/BottomSheetCustom/index.js +17 -0
  23. package/dist/cjs/components/BottomSheetCustom/styles.module.css +98 -0
  24. package/dist/cjs/components/BottomSheetCustom/utils/scroll.d.ts +17 -0
  25. package/dist/cjs/components/BottomSheetCustom/utils/scroll.js +39 -0
  26. package/dist/cjs/components/BottomSheetCustom/utils/snapPoints.d.ts +38 -0
  27. package/dist/cjs/components/BottomSheetCustom/utils/snapPoints.js +102 -0
  28. package/dist/cjs/components/index.d.ts +2 -0
  29. package/dist/cjs/components/index.js +18 -0
  30. package/dist/cjs/constants.d.ts +11 -0
  31. package/dist/cjs/constants.js +19 -0
  32. package/dist/cjs/helperComponents/Handle/Handle.d.ts +2 -0
  33. package/dist/cjs/helperComponents/Handle/Handle.js +13 -0
  34. package/dist/cjs/helperComponents/Handle/index.d.ts +1 -0
  35. package/dist/cjs/helperComponents/Handle/index.js +17 -0
  36. package/dist/cjs/helperComponents/Handle/styles.module.css +18 -0
  37. package/dist/cjs/helperComponents/index.d.ts +1 -0
  38. package/dist/cjs/helperComponents/index.js +17 -0
  39. package/dist/cjs/index.d.ts +9 -0
  40. package/dist/cjs/index.js +39 -0
  41. package/dist/cjs/package.json +3 -0
  42. package/dist/cjs/style.css +143 -0
  43. package/dist/cjs/types.d.ts +172 -0
  44. package/dist/cjs/types.js +2 -0
  45. package/dist/esm/components/BottomSheet/BottomSheet.d.ts +3 -0
  46. package/dist/esm/components/BottomSheet/BottomSheet.js +33 -0
  47. package/dist/esm/components/BottomSheet/index.d.ts +1 -0
  48. package/dist/esm/components/BottomSheet/index.js +1 -0
  49. package/dist/esm/components/BottomSheet/styles.module.css +27 -0
  50. package/dist/esm/components/BottomSheetCustom/BottomSheetCustom.d.ts +19 -0
  51. package/dist/esm/components/BottomSheetCustom/BottomSheetCustom.js +115 -0
  52. package/dist/esm/components/BottomSheetCustom/constants.d.ts +30 -0
  53. package/dist/esm/components/BottomSheetCustom/constants.js +30 -0
  54. package/dist/esm/components/BottomSheetCustom/hooks/index.d.ts +3 -0
  55. package/dist/esm/components/BottomSheetCustom/hooks/index.js +3 -0
  56. package/dist/esm/components/BottomSheetCustom/hooks/useDragEngine.d.ts +44 -0
  57. package/dist/esm/components/BottomSheetCustom/hooks/useDragEngine.js +309 -0
  58. package/dist/esm/components/BottomSheetCustom/hooks/useFocusTrap.d.ts +7 -0
  59. package/dist/esm/components/BottomSheetCustom/hooks/useFocusTrap.js +74 -0
  60. package/dist/esm/components/BottomSheetCustom/hooks/useTransitionPhase.d.ts +22 -0
  61. package/dist/esm/components/BottomSheetCustom/hooks/useTransitionPhase.js +48 -0
  62. package/dist/esm/components/BottomSheetCustom/index.d.ts +1 -0
  63. package/dist/esm/components/BottomSheetCustom/index.js +1 -0
  64. package/dist/esm/components/BottomSheetCustom/styles.module.css +98 -0
  65. package/dist/esm/components/BottomSheetCustom/utils/scroll.d.ts +17 -0
  66. package/dist/esm/components/BottomSheetCustom/utils/scroll.js +34 -0
  67. package/dist/esm/components/BottomSheetCustom/utils/snapPoints.d.ts +38 -0
  68. package/dist/esm/components/BottomSheetCustom/utils/snapPoints.js +96 -0
  69. package/dist/esm/components/index.d.ts +2 -0
  70. package/dist/esm/components/index.js +2 -0
  71. package/dist/esm/constants.d.ts +11 -0
  72. package/dist/esm/constants.js +13 -0
  73. package/dist/esm/helperComponents/Handle/Handle.d.ts +2 -0
  74. package/dist/esm/helperComponents/Handle/Handle.js +7 -0
  75. package/dist/esm/helperComponents/Handle/index.d.ts +1 -0
  76. package/dist/esm/helperComponents/Handle/index.js +1 -0
  77. package/dist/esm/helperComponents/Handle/styles.module.css +18 -0
  78. package/dist/esm/helperComponents/index.d.ts +1 -0
  79. package/dist/esm/helperComponents/index.js +1 -0
  80. package/dist/esm/index.d.ts +9 -0
  81. package/dist/esm/index.js +13 -0
  82. package/dist/esm/style.css +143 -0
  83. package/dist/esm/types.d.ts +172 -0
  84. package/dist/esm/types.js +1 -0
  85. package/dist/tsconfig.cjs.tsbuildinfo +1 -0
  86. package/dist/tsconfig.esm.tsbuildinfo +1 -0
  87. package/package.json +47 -0
  88. package/src/components/BottomSheet/BottomSheet.tsx +116 -0
  89. package/src/components/BottomSheet/index.ts +1 -0
  90. package/src/components/BottomSheet/styles.module.scss +38 -0
  91. package/src/components/BottomSheetCustom/BottomSheetCustom.tsx +221 -0
  92. package/src/components/BottomSheetCustom/constants.ts +33 -0
  93. package/src/components/BottomSheetCustom/hooks/index.ts +3 -0
  94. package/src/components/BottomSheetCustom/hooks/useDragEngine.ts +373 -0
  95. package/src/components/BottomSheetCustom/hooks/useFocusTrap.ts +80 -0
  96. package/src/components/BottomSheetCustom/hooks/useTransitionPhase.ts +52 -0
  97. package/src/components/BottomSheetCustom/index.ts +1 -0
  98. package/src/components/BottomSheetCustom/styles.module.scss +146 -0
  99. package/src/components/BottomSheetCustom/utils/scroll.ts +39 -0
  100. package/src/components/BottomSheetCustom/utils/snapPoints.ts +109 -0
  101. package/src/components/index.ts +2 -0
  102. package/src/constants.ts +14 -0
  103. package/src/helperComponents/Handle/Handle.tsx +11 -0
  104. package/src/helperComponents/Handle/index.ts +1 -0
  105. package/src/helperComponents/Handle/styles.module.scss +26 -0
  106. package/src/helperComponents/index.ts +1 -0
  107. package/src/index.ts +30 -0
  108. package/src/types.ts +185 -0
@@ -0,0 +1,172 @@
1
+ import { BottomSheetActionButton, FooterActionsOrientation, PopupMediaProps } from '@cloud-ru/ds-popup-private';
2
+ import { WithSupportProps } from '@cloud-ru/ds-utils';
3
+ import { PropsWithChildren, ReactNode } from 'react';
4
+ export type { BottomSheetActionButton, FooterActionsOrientation, MediaKind, PopupBodyProps as BottomSheetBodyProps, PopupFooterProps as BottomSheetFooterProps, PopupHeaderProps as BottomSheetHeaderProps, PopupMediaProps as BottomSheetMediaProps, } from '@cloud-ru/ds-popup-private';
5
+ /**
6
+ * Фиксированная позиция bottom-sheet'а по высоте.
7
+ *
8
+ * - `number` ∈ (0, 1] — доля от высоты viewport'а (`0.5` = половина экрана; `1` = full-viewport).
9
+ * - `'<n>px'` — абсолютные пиксели (`'320px'`).
10
+ * - `'<n>%'` — процент от высоты viewport (`'50%'`).
11
+ * - `'<n>dvh'` / `'<n>svh'` / `'<n>lvh'` — dynamic / small / large viewport-units (`'90dvh'`).
12
+ * - `'fit-content'` — высота по контенту (auto).
13
+ */
14
+ export type SnapPoint = number | `${number}px` | `${number}%` | `${number}dvh` | `${number}svh` | `${number}lvh` | 'fit-content';
15
+ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
16
+ /** Управление состоянием показан / не показан. */
17
+ open: boolean;
18
+ /** Колбэк закрытия (вызывается при click outside, Esc, swipe-down, browser-back). */
19
+ onClose(): void;
20
+ /**
21
+ * Отображение тёмной подложки за sheet'ом. При `false` фон не затемняется и click-outside
22
+ * не закрывает sheet (нет backdrop-узла, по которому ловится клик).
23
+ * @default true
24
+ */
25
+ showBackdrop?: boolean;
26
+ /**
27
+ * Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
28
+ * под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
29
+ * которым продолжают взаимодействовать). Обычно используется вместе с `showBackdrop={false}`.
30
+ * @default true
31
+ */
32
+ lockScroll?: boolean;
33
+ /**
34
+ * Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
35
+ * При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
36
+ * @default true
37
+ */
38
+ swipeEnabled?: boolean;
39
+ /**
40
+ * Массив фиксированных позиций sheet'а от меньшей к большей. По дефолту `undefined` —
41
+ * sheet `height: auto` с одним snap'ом по высоте контента.
42
+ *
43
+ * Пример: `[0.5, 1]` — sheet открывается на половину экрана, drag вверх раскрывает
44
+ * до full-viewport; drag вниз ниже `0.5` ведёт к закрытию.
45
+ *
46
+ * Контракт массива (движок не сортирует и не дедуплицирует — порядок и различимость на
47
+ * стороне потребителя):
48
+ * - строго по возрастанию: индекс `0` — самая компактная позиция, последний — top / expanded;
49
+ * - значения должны резолвиться в различные высоты (`['50%', 0.5]` на типичном вьюпорте дадут
50
+ * одну высоту → дубль-индекс будет недостижим свайпом);
51
+ * - `'fit-content'` имеет смысл только как ЕДИНСТВЕННЫЙ snap (без `snapPoints`); внутри массива
52
+ * фиксированных позиций его «контентная» высота не определена.
53
+ */
54
+ snapPoints?: SnapPoint[];
55
+ /**
56
+ * Индекс snap'а, на котором sheet открывается по дефолту. Игнорируется при controlled `snapIndex`.
57
+ * @default 0
58
+ */
59
+ defaultSnapIndex?: number;
60
+ /**
61
+ * Controlled-индекс активного snap'а. Если задан, sheet всегда находится на этом snap'е;
62
+ * swipe-up/down вызывают `onSnapIndexChange`, но не меняют позицию сами — consumer должен
63
+ * передать новое значение.
64
+ */
65
+ snapIndex?: number;
66
+ /**
67
+ * Callback изменения активного snap'а (пересечение swipe-границы или click по UI).
68
+ * Не вызывается при программной смене controlled `snapIndex`.
69
+ */
70
+ onSnapIndexChange?(snapIndex: number): void;
71
+ /**
72
+ * Закрывать sheet при `popstate` (browser-back на mobile).
73
+ * @default true
74
+ */
75
+ closeOnPopstate?: boolean;
76
+ /**
77
+ * Резервировать ли место под iOS notch / home-indicator и Android nav-bar. Реализовано паддингом
78
+ * на `.content` через `env(safe-area-inset-*)`: на устройстве без выреза/индикатора (и на desktop)
79
+ * inset = 0, поэтому никакого «лишнего» отступа не появляется; на notched-устройстве — ровно нужный.
80
+ * Верхний отступ добавляется только когда sheet раскрыт на полный вьюпорт (его верх под notch).
81
+ * @default true
82
+ */
83
+ safeArea?: boolean;
84
+ /**
85
+ * Отключить анимации открытия / закрытия и перехода между snap-точками.
86
+ * @default false
87
+ */
88
+ disableMotions?: boolean;
89
+ /** Контейнер для портала. По дефолту — `body` либо контекст-провайдер `@cloud-ru/ds-portal-context`. */
90
+ container?: string | HTMLElement;
91
+ /** CSS-класс самого sheet-контейнера. */
92
+ className?: string;
93
+ /** CSS-класс корневого элемента portal'а. */
94
+ rootClassName?: string;
95
+ }>>;
96
+ export type BottomSheetProps = Omit<BottomSheetCustomProps, 'children' | 'disableMotions'> & {
97
+ /** Заголовок в шапке. */
98
+ title?: ReactNode;
99
+ /** Slot справа от title (внутри той же строки) — типично `QuestionTooltip`, status badge. */
100
+ slotAfterTitle?: ReactNode;
101
+ /** Текстовая строка-подзаголовок под title. */
102
+ subtitle?: ReactNode;
103
+ /** Slot под подзаголовком — типично `SearchBar`, `SegmentControl`, `Filter`. */
104
+ slotSecondTitle?: ReactNode;
105
+ /**
106
+ * Callback клика на back-кнопку (слева в шапке).
107
+ * Наличие callback'а рендерит ArrowLeft-кнопку.
108
+ */
109
+ onBackButtonClick?(): void;
110
+ /** Action-кнопка справа в шапке (любой ReactNode — обычно `Button view='function'`). */
111
+ actionButton?: ReactNode;
112
+ /** Media-блок над шапкой: изображение / иконка либо произвольный `ReactNode`. */
113
+ media?: PopupMediaProps | ReactNode;
114
+ /** Основное содержимое (рендерится в `BottomSheetCustom.Body`). */
115
+ content?: ReactNode;
116
+ /**
117
+ * Горизонтальные паддинги body. При `false` контент идёт во всю ширину (edge-to-edge) — для карт,
118
+ * изображений, списков без отступов. Соответствует Figma-оси `padding=false`.
119
+ * @default true
120
+ */
121
+ bodyPadding?: boolean;
122
+ /**
123
+ * Тонкие линии между topBar↔body и body↔footer: разграничивают закреплённые шапку и подвал
124
+ * от прокручиваемого под ними содержимого. Передайте `false`, чтобы убрать обе линии.
125
+ * @default true
126
+ */
127
+ withDividers?: boolean;
128
+ /**
129
+ * Основная кнопка действия — объект пропсов `Button` (по умолчанию `view='filled'`,
130
+ * `appearance='primary'`). Ширина зависит от `footerActionsOrientation` и числа кнопок.
131
+ */
132
+ approveButton?: BottomSheetActionButton;
133
+ /**
134
+ * Кнопка отмены — объект пропсов `Button` (по умолчанию `view='outline'`, `appearance='neutral'`).
135
+ */
136
+ cancelButton?: BottomSheetActionButton;
137
+ /**
138
+ * Дополнительная (третья) кнопка — объект пропсов `Button` (по умолчанию `view='simple'`,
139
+ * `appearance='neutral'`).
140
+ */
141
+ additionalButton?: BottomSheetActionButton;
142
+ /**
143
+ * Ориентация кнопок футера, собранных из `approveButton` / `cancelButton` / `additionalButton`.
144
+ * Применяется **только при ровно двух** кнопках (canonical cancel/confirm):
145
+ *
146
+ * - `'horizontal'` — кнопки в ряд через space-between: secondary слева, primary справа,
147
+ * ширина по контенту. Точное соответствие Figma `bottomBar.buttonGroup`.
148
+ * - `'vertical'` — кнопки в столбик, full-width (primary сверху).
149
+ *
150
+ * Одна кнопка всегда рендерится full-width (одиночный CTA); три кнопки не помещаются в ряд на
151
+ * mobile-вьюпорте и всегда идут в столбик — для них значение игнорируется.
152
+ *
153
+ * Игнорируется при заданном `footer` (произвольная разметка футера).
154
+ * @default 'horizontal'
155
+ */
156
+ footerActionsOrientation?: FooterActionsOrientation;
157
+ /**
158
+ * Произвольный футер. Если задан — имеет приоритет над
159
+ * `approveButton` / `cancelButton` / `additionalButton`.
160
+ */
161
+ footer?: ReactNode;
162
+ /**
163
+ * Переопределение `data-test-id` собранных слотов футера (approve/cancel/additional).
164
+ * По умолчанию — собственные id `BottomSheet`. Адаптивные `Modal`/`Drawer` передают сюда свои
165
+ * `TEST_IDS.footer*`, чтобы футер метился одинаково на desktop-поверхности и в mobile-sheet'е.
166
+ */
167
+ footerTestIds?: {
168
+ approve?: string;
169
+ cancel?: string;
170
+ additional?: string;
171
+ };
172
+ };
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,3 @@
1
+ import { BottomSheetProps } from '../../types.js';
2
+ /** Обёртка `@cloud-ru/ds-bottom-sheet` с готовой анатомией: media + header + body + footer + safeArea + dividers. */
3
+ export declare function BottomSheet({ title, slotAfterTitle, subtitle, slotSecondTitle, onBackButtonClick, actionButton, media, content, bodyPadding, approveButton, cancelButton, additionalButton, footerActionsOrientation, footer, footerTestIds, withDividers, swipeEnabled, className, ...rest }: BottomSheetProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,33 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { FooterActions, PopupMedia } from '@cloud-ru/ds-popup-private';
3
+ import cn from 'classnames';
4
+ import { isValidElement, useId } from 'react';
5
+ import { TEST_IDS } from '../../constants.js';
6
+ import { BottomSheetCustom } from '../BottomSheetCustom/index.js';
7
+ import styles from './styles.module.css';
8
+ function isMediaProps(value) {
9
+ return typeof value === 'object' && value !== null && !isValidElement(value) && 'src' in value && 'alt' in value;
10
+ }
11
+ /** Обёртка `@cloud-ru/ds-bottom-sheet` с готовой анатомией: media + header + body + footer + safeArea + dividers. */
12
+ export function BottomSheet({ title, slotAfterTitle, subtitle, slotSecondTitle, onBackButtonClick, actionButton, media, content, bodyPadding = true, approveButton, cancelButton, additionalButton, footerActionsOrientation, footer, footerTestIds, withDividers = true, swipeEnabled = true,
13
+ // safeArea уходит в `...rest` → BottomSheetCustom (env-паддинг на `.content`).
14
+ className, ...rest }) {
15
+ const hasHeader = Boolean(title || onBackButtonClick || actionButton || slotAfterTitle || subtitle || slotSecondTitle);
16
+ const hasMedia = media != null;
17
+ const hasFullWidthMediaImage = hasMedia && isMediaProps(media) && (media.kind ?? 'image') === 'image';
18
+ // aria-labelledby связывает заголовок с dialog'ом; без title имя задаёт потребитель через aria-label.
19
+ const titleId = useId();
20
+ // Footer: произвольный `footer`-ReactNode (приоритет) либо сборка из слотов кнопок через общий
21
+ // `FooterActions` (тот же, что у Modal/Drawer, для adaptive-маппинга 1:1).
22
+ const footerContent = footer ??
23
+ (approveButton || cancelButton || additionalButton ? (_jsx(FooterActions, { surface: 'bottomSheet', size: 'l', approveButton: approveButton, cancelButton: cancelButton, additionalButton: additionalButton, footerActionsOrientation: footerActionsOrientation, testIds: {
24
+ approve: footerTestIds?.approve ?? TEST_IDS.footerApprove,
25
+ cancel: footerTestIds?.cancel ?? TEST_IDS.footerCancel,
26
+ additional: footerTestIds?.additional ?? TEST_IDS.footerAdditional,
27
+ } })) : null);
28
+ const hasFooter = footerContent != null;
29
+ return (_jsx(BottomSheetCustom, { ...rest, swipeEnabled: swipeEnabled, ...(title ? { 'aria-labelledby': titleId } : {}), className: cn(className), disableMotions: false, children: _jsxs("div", { className: styles.root, children: [hasMedia &&
30
+ (isMediaProps(media) ? (_jsx(PopupMedia, { ...media })) : (
31
+ // ReactNode-media: тот же data-media-kind-контракт со значением 'custom'.
32
+ _jsx("div", { "data-test-id": TEST_IDS.media, "data-media-kind": 'custom', children: media }))), _jsxs("div", { className: cn(styles.contentBlock, hasFullWidthMediaImage && styles.contentBlockNoTopPadding), children: [hasHeader && (_jsx(BottomSheetCustom.Header, { title: title, titleId: titleId, slotAfterTitle: slotAfterTitle, subtitle: subtitle, slotSecondTitle: slotSecondTitle, onBackButtonClick: onBackButtonClick, actionButton: actionButton })), withDividers && hasHeader && (_jsx("div", { className: styles.divider, "data-test-id": TEST_IDS.dividerTop, "aria-hidden": true })), _jsx(BottomSheetCustom.Body, { bodyPadding: bodyPadding, children: content }), withDividers && hasFooter && (_jsx("div", { className: styles.divider, "data-test-id": TEST_IDS.dividerBottom, "aria-hidden": true })), hasFooter && _jsx(BottomSheetCustom.Footer, { children: footerContent })] })] }) }));
33
+ }
@@ -0,0 +1 @@
1
+ export * from './BottomSheet.js';
@@ -0,0 +1 @@
1
+ export * from './BottomSheet.js';
@@ -0,0 +1,27 @@
1
+ .root{
2
+ display:flex;
3
+ flex-direction:column;
4
+ flex-grow:1;
5
+ box-sizing:border-box;
6
+ height:100%;
7
+ min-height:0;
8
+ }
9
+
10
+ .divider{
11
+ flex-shrink:0;
12
+ height:var(--sn-primitive-strokeWeight-strokeRegular, 1px);
13
+ background-color:var(--sn-theme-color-available-borderColor, var(--sn-brand-color-state-neutralBorder-forLightMode-default-borderColor, rgba(159, 166, 198, 0.3019607843)));
14
+ }
15
+
16
+ .contentBlock{
17
+ display:flex;
18
+ flex:1 1 auto;
19
+ flex-direction:column;
20
+ box-sizing:border-box;
21
+ min-height:0;
22
+ padding-top:var(--sn-bottomSheet-anatomy-container-paddingTop, var(--sn-primitive-dimension-0, 0));
23
+ }
24
+
25
+ .contentBlockNoTopPadding{
26
+ padding-top:0;
27
+ }
@@ -0,0 +1,19 @@
1
+ import { PopupBody, PopupFooter, PopupHeader, PopupMedia } from '@cloud-ru/ds-popup-private';
2
+ import { BottomSheetBodyProps, BottomSheetCustomProps, BottomSheetFooterProps, BottomSheetHeaderProps, BottomSheetMediaProps } from '../../types.js';
3
+ /**
4
+ * Низкоуровневая обёртка bottom-sheet'а: portal + backdrop + slide-up motion + focus-trap +
5
+ * Pointer-Events swipe / snap-engine. Готовая анатомия — `BottomSheet`.
6
+ */
7
+ export declare function BottomSheetCustom(props: BottomSheetCustomProps): import("react").ReactPortal | null;
8
+ export declare namespace BottomSheetCustom {
9
+ var Header: typeof PopupHeader;
10
+ var Body: typeof PopupBody;
11
+ var Footer: typeof PopupFooter;
12
+ var Media: typeof PopupMedia;
13
+ }
14
+ export declare namespace BottomSheetCustom {
15
+ type HeaderProps = BottomSheetHeaderProps;
16
+ type BodyProps = BottomSheetBodyProps;
17
+ type FooterProps = BottomSheetFooterProps;
18
+ type MediaProps = BottomSheetMediaProps;
19
+ }
@@ -0,0 +1,115 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { OVERLAY_SURFACE, OverlaySurfaceProvider, PopupBody, PopupFooter, PopupHeader, PopupMedia, } from '@cloud-ru/ds-popup-private';
3
+ import { usePortalContext } from '@cloud-ru/ds-portal-context';
4
+ import { useThemeClassnames } from '@cloud-ru/ds-theme';
5
+ import { extractSupportProps, isBrowser, useLayoutEffect, useModalOpenState } from '@cloud-ru/ds-utils';
6
+ import cn from 'classnames';
7
+ import { useCallback, useEffect, useRef } from 'react';
8
+ import { createPortal } from 'react-dom';
9
+ import { RemoveScroll } from 'react-remove-scroll';
10
+ import { TEST_IDS } from '../../constants.js';
11
+ import { Handle } from '../../helperComponents/index.js';
12
+ import { CLOSING_TIMEOUT } from './constants.js';
13
+ import { useDragEngine, useFocusTrap, useTransitionPhase } from './hooks/index.js';
14
+ import styles from './styles.module.css';
15
+ /** Резолв portal-target'а. Вызывается после `isMounted=true` (браузер), `document` доступен. */
16
+ function resolveContainer(container, portalContextNode) {
17
+ if (typeof container === 'string') {
18
+ // eslint-disable-next-line @cloud-ru/ssr-safe-react/domApi -- guarded by isMounted (browser only)
19
+ return document.querySelector(container);
20
+ }
21
+ if (container instanceof HTMLElement)
22
+ return container;
23
+ // eslint-disable-next-line @cloud-ru/ssr-safe-react/domApi -- guarded by isMounted (browser only)
24
+ return portalContextNode ?? document.body;
25
+ }
26
+ /**
27
+ * Низкоуровневая обёртка bottom-sheet'а: portal + backdrop + slide-up motion + focus-trap +
28
+ * Pointer-Events swipe / snap-engine. Готовая анатомия — `BottomSheet`.
29
+ */
30
+ export function BottomSheetCustom(props) {
31
+ const { open, onClose, showBackdrop = true, lockScroll = true, swipeEnabled = true, safeArea = true, snapPoints, defaultSnapIndex, snapIndex, onSnapIndexChange, closeOnPopstate = true, disableMotions = false, container, className, rootClassName, children, ...rest } = props;
32
+ // Sheet модальный, если затемняет фон или лочит скролл. Non-modal не прячет фон от AT,
33
+ // не ловит фокус и закрывается по Esc при фокусе снаружи.
34
+ const isModal = showBackdrop || lockScroll;
35
+ useModalOpenState(open, onClose, { closeOnPopstate });
36
+ // Возврат фокуса на триггер: запоминаем активный элемент при open=true, возвращаем при open=false.
37
+ const restoreFocusRef = useRef(null);
38
+ const wasOpenRef = useRef(false);
39
+ useLayoutEffect(() => {
40
+ if (open && !wasOpenRef.current) {
41
+ wasOpenRef.current = true;
42
+ restoreFocusRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
43
+ }
44
+ else if (!open && wasOpenRef.current) {
45
+ wasOpenRef.current = false;
46
+ const previous = restoreFocusRef.current;
47
+ restoreFocusRef.current = null;
48
+ if (previous &&
49
+ previous !== document.body &&
50
+ previous !== document.documentElement &&
51
+ document.documentElement.contains(previous)) {
52
+ previous.focus({ preventScroll: true });
53
+ }
54
+ }
55
+ }, [open]);
56
+ const { isMounted, isActive } = useTransitionPhase(open, disableMotions ? 0 : CLOSING_TIMEOUT);
57
+ const portalContextRef = usePortalContext();
58
+ // Фокус-trap только для модального sheet'а: в non-modal Tab уходит на фон.
59
+ const focusTrapRef = useFocusTrap(isActive && isModal);
60
+ // Esc → закрытие. `useModalOpenState` закрывает через `CloseWatcher` (Chromium-only); в
61
+ // Safari/Firefox навешиваем keydown-fallback ровно когда `CloseWatcher` недоступен.
62
+ // Nested-safe для модального sheet'а: закрываем только если фокус внутри этой панели; для
63
+ // non-modal фокус снаружи — закрываем безусловно.
64
+ useEffect(() => {
65
+ if (!isActive || !isBrowser() || 'CloseWatcher' in window)
66
+ return;
67
+ const handleKeyDown = (event) => {
68
+ if (event.key !== 'Escape')
69
+ return;
70
+ const panel = focusTrapRef.current;
71
+ const focusInside = Boolean(panel && (panel === document.activeElement || panel.contains(document.activeElement)));
72
+ if (!isModal || focusInside) {
73
+ onClose();
74
+ }
75
+ };
76
+ document.addEventListener('keydown', handleKeyDown, true);
77
+ return () => document.removeEventListener('keydown', handleKeyDown, true);
78
+ }, [isActive, isModal, onClose, focusTrapRef]);
79
+ const { setContentNode, dragHandlers, snapIndex: activeSnapIndex, isDragging, } = useDragEngine({
80
+ snapPoints,
81
+ defaultSnapIndex,
82
+ snapIndex,
83
+ onSnapIndexChange,
84
+ onClose,
85
+ swipeEnabled,
86
+ isActive,
87
+ });
88
+ // Верхний safe-area отступ нужен только на full-height (верх под notch); флаг — в `data-full-height`.
89
+ const activeSnap = snapPoints?.[activeSnapIndex ?? 0];
90
+ const isFullHeight = activeSnap === 1 || (typeof activeSnap === 'string' && /^100(%|dvh|svh|lvh)$/.test(activeSnap));
91
+ const mergeRefCb = useCallback((node) => {
92
+ focusTrapRef.current = node;
93
+ setContentNode(node);
94
+ }, [focusTrapRef, setContentNode]);
95
+ const handleBackdropClick = useCallback(() => {
96
+ if (showBackdrop)
97
+ onClose();
98
+ }, [showBackdrop, onClose]);
99
+ // Мобильная поверхность — comfort-плотность.
100
+ const densityClassName = useThemeClassnames({ density: 'comfort' });
101
+ if (!isMounted)
102
+ return null;
103
+ const targetNode = resolveContainer(container, portalContextRef.current);
104
+ if (!targetNode)
105
+ return null;
106
+ const supportProps = extractSupportProps(rest);
107
+ return createPortal(
108
+ // RemoveScroll лочит фон-скролл (refcount для вложенных sheet'ов); `enabled={lockScroll}` —
109
+ // для 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, densityClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": TEST_IDS.root, "data-safe-area": safeArea || 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);
111
+ }
112
+ BottomSheetCustom.Header = PopupHeader;
113
+ BottomSheetCustom.Body = PopupBody;
114
+ BottomSheetCustom.Footer = PopupFooter;
115
+ BottomSheetCustom.Media = PopupMedia;
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Задержка размонтирования портала после `open=false` (мс). Должна быть ≥ длительности leave-анимации
3
+ * (slide-down `.contentWrapper` + fade `.backdrop` = 0.2s = 200ms в `styles.module.scss`), чтобы DOM
4
+ * не исчезал до завершения анимации. Держим 200мс — leave симметричен enter (0.2s). При правке этих
5
+ * CSS-длительностей синхронизируй и эту константу (фиксированный таймер, не `transitionend`).
6
+ * Под `prefers-reduced-motion` анимация мгновенна, а портал всё равно живёт по таймеру (≤200мс
7
+ * невидимого scroll-lock/focus-trap — приемлемо).
8
+ */
9
+ export declare const CLOSING_TIMEOUT = 200;
10
+ /**
11
+ * Минимальное вертикальное смещение указателя (px), после которого жест трактуется как drag.
12
+ * До порога касание считается тапом — это защищает клики по контенту от ложного захвата drag'ом.
13
+ */
14
+ export declare const DRAG_START_THRESHOLD_PX = 6;
15
+ /**
16
+ * Cooldown (ms) после того, как вложенный скролл достиг края: в течение него повторный жест
17
+ * не превращается в drag sheet'а. Без него инерционный скролл, доехавший до верха, мгновенно
18
+ * читается как «потяни вниз → закрой». Аналог `SCROLL_LOCK_TIMEOUT` в vaul.
19
+ */
20
+ export declare const SCROLL_LOCK_COOLDOWN_MS = 100;
21
+ /**
22
+ * Доля высоты sheet'а, при превышении которой медленный drag вниз всё равно закрывает
23
+ * single-snap sheet (distance-критерий, когда скорость ниже velocity-порога). Отдельная константа
24
+ * от `CLOSE_THRESHOLD_RATIO_DEFAULT` в `utils/snapPoints.ts` намеренно: это два независимых регулятора
25
+ * (single-snap-закрытие vs multi-snap close-порог), совпадение значения (0.3) — не повод их связывать.
26
+ *
27
+ * Velocity-порог быстрого флика, наоборот, единый — `VELOCITY_THRESHOLD_PX_PER_MS` из
28
+ * `utils/snapPoints.ts` (один источник и для multi-snap-навигации, и для single-snap-закрытия).
29
+ */
30
+ export declare const SINGLE_CLOSE_DISTANCE_RATIO = 0.3;
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Задержка размонтирования портала после `open=false` (мс). Должна быть ≥ длительности leave-анимации
3
+ * (slide-down `.contentWrapper` + fade `.backdrop` = 0.2s = 200ms в `styles.module.scss`), чтобы DOM
4
+ * не исчезал до завершения анимации. Держим 200мс — leave симметричен enter (0.2s). При правке этих
5
+ * CSS-длительностей синхронизируй и эту константу (фиксированный таймер, не `transitionend`).
6
+ * Под `prefers-reduced-motion` анимация мгновенна, а портал всё равно живёт по таймеру (≤200мс
7
+ * невидимого scroll-lock/focus-trap — приемлемо).
8
+ */
9
+ export const CLOSING_TIMEOUT = 200;
10
+ /**
11
+ * Минимальное вертикальное смещение указателя (px), после которого жест трактуется как drag.
12
+ * До порога касание считается тапом — это защищает клики по контенту от ложного захвата drag'ом.
13
+ */
14
+ export const DRAG_START_THRESHOLD_PX = 6;
15
+ /**
16
+ * Cooldown (ms) после того, как вложенный скролл достиг края: в течение него повторный жест
17
+ * не превращается в drag sheet'а. Без него инерционный скролл, доехавший до верха, мгновенно
18
+ * читается как «потяни вниз → закрой». Аналог `SCROLL_LOCK_TIMEOUT` в vaul.
19
+ */
20
+ export const SCROLL_LOCK_COOLDOWN_MS = 100;
21
+ /**
22
+ * Доля высоты sheet'а, при превышении которой медленный drag вниз всё равно закрывает
23
+ * single-snap sheet (distance-критерий, когда скорость ниже velocity-порога). Отдельная константа
24
+ * от `CLOSE_THRESHOLD_RATIO_DEFAULT` в `utils/snapPoints.ts` намеренно: это два независимых регулятора
25
+ * (single-snap-закрытие vs multi-snap close-порог), совпадение значения (0.3) — не повод их связывать.
26
+ *
27
+ * Velocity-порог быстрого флика, наоборот, единый — `VELOCITY_THRESHOLD_PX_PER_MS` из
28
+ * `utils/snapPoints.ts` (один источник и для multi-snap-навигации, и для single-snap-закрытия).
29
+ */
30
+ export const SINGLE_CLOSE_DISTANCE_RATIO = 0.3;
@@ -0,0 +1,3 @@
1
+ export * from './useDragEngine.js';
2
+ export * from './useFocusTrap.js';
3
+ export * from './useTransitionPhase.js';
@@ -0,0 +1,3 @@
1
+ export * from './useDragEngine.js';
2
+ export * from './useFocusTrap.js';
3
+ export * from './useTransitionPhase.js';
@@ -0,0 +1,44 @@
1
+ import { PointerEvent as ReactPointerEvent } from 'react';
2
+ import { SnapPoint } from '../../../types.js';
3
+ type UseDragEngineProps = {
4
+ snapPoints?: SnapPoint[];
5
+ defaultSnapIndex?: number;
6
+ snapIndex?: number;
7
+ onSnapIndexChange?(snapIndex: number): void;
8
+ onClose(): void;
9
+ swipeEnabled: boolean;
10
+ /** Активна ли панель (sheet раскрыт). Drag разрешён только в активной фазе. */
11
+ isActive: boolean;
12
+ };
13
+ type DragHandlers = {
14
+ onPointerDown(event: ReactPointerEvent<HTMLDivElement>): void;
15
+ };
16
+ type UseDragEngineReturn = {
17
+ /** Ref-callback для корневого `.content`-узла sheet'а (swipe-target + владелец height). */
18
+ setContentNode(node: HTMLDivElement | null): void;
19
+ /** Pointer-обработчики для `.content`. Вешать всегда — внутри есть guard по `swipeEnabled`. */
20
+ dragHandlers: DragHandlers;
21
+ /** Активный snap-индекс (для `data-snap-index`). `undefined` если snap-points не заданы. */
22
+ snapIndex: number | undefined;
23
+ /** Идёт ли drag прямо сейчас (для `data-dragging`). */
24
+ isDragging: boolean;
25
+ };
26
+ /**
27
+ * Drag-движок bottom-sheet'а на Pointer Events (единый путь для touch/mouse/pen).
28
+ *
29
+ * Модель drag'а — **изменение высоты, привязанной к низу** (а не translate): sheet растёт вверх при
30
+ * раскрытии и сжимается при сворачивании, не отрываясь от нижней кромки и не уезжая за экран.
31
+ * Высоту целиком ведёт движок императивно (React её не выставляет), чтобы не конфликтовать.
32
+ *
33
+ * Move/up слушаются на `document` (а не на `.content`): drag отслеживается, даже когда палец уходит
34
+ * за пределы sheet'а (например, тянем вверх от самой кромки). Pointer capture НЕ используется — он
35
+ * перенацеливает `click` на захватившую ноду и ломает кнопки внутри sheet'а.
36
+ *
37
+ * Ключевая мобильная механика — «drag только от края скролла» (vaul-подобная): если жест начат внутри
38
+ * прокручиваемого контента, который ещё не упёрся в нужный край, жест отдаётся нативному скроллу.
39
+ *
40
+ * - без `snapPoints` — single snap по высоте контента, swipe-down закрывает.
41
+ * - с `snapPoints` — multi-snap: drag меняет высоту → `snapIndex` или закрывает (см. `findTargetSnap`).
42
+ */
43
+ export declare function useDragEngine({ snapPoints, defaultSnapIndex, snapIndex: snapIndexProp, onSnapIndexChange, onClose, swipeEnabled, isActive, }: UseDragEngineProps): UseDragEngineReturn;
44
+ export {};