@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,373 @@
1
+ import { isBrowser, useLayoutEffect, useValueControl } from '@cloud-ru/ds-utils';
2
+ import { PointerEvent as ReactPointerEvent, useCallback, useEffect, useMemo, useRef, useState } from 'react';
3
+
4
+ import { NO_DRAG_ATTRIBUTE } from '../../../constants';
5
+ import { SnapPoint } from '../../../types';
6
+ import { DRAG_START_THRESHOLD_PX, SCROLL_LOCK_COOLDOWN_MS, SINGLE_CLOSE_DISTANCE_RATIO } from '../constants';
7
+ import { findScrollableAncestor, isScrolledToBottom, isScrolledToTop } from '../utils/scroll';
8
+ import {
9
+ findTargetSnap,
10
+ isValidSnapPoint,
11
+ resolveSnapPointPx,
12
+ VELOCITY_THRESHOLD_PX_PER_MS,
13
+ } from '../utils/snapPoints';
14
+
15
+ /** Атрибут-флаг на интерактивном предке, отключающий захват drag'ом (слайдеры, карты и т.п.). */
16
+ const NO_DRAG_SELECTOR = `[${NO_DRAG_ATTRIBUTE}]`;
17
+ /** Длительность settle-анимации height (мс) — для отложенного восстановления `auto` у fit-content. */
18
+ const SETTLE_TIMEOUT_MS = 260;
19
+
20
+ type UseDragEngineProps = {
21
+ snapPoints?: SnapPoint[];
22
+ defaultSnapIndex?: number;
23
+ snapIndex?: number;
24
+ onSnapIndexChange?(snapIndex: number): void;
25
+ onClose(): void;
26
+ swipeEnabled: boolean;
27
+ /** Активна ли панель (sheet раскрыт). Drag разрешён только в активной фазе. */
28
+ isActive: boolean;
29
+ };
30
+
31
+ type DragHandlers = {
32
+ onPointerDown(event: ReactPointerEvent<HTMLDivElement>): void;
33
+ };
34
+
35
+ type UseDragEngineReturn = {
36
+ /** Ref-callback для корневого `.content`-узла sheet'а (swipe-target + владелец height). */
37
+ setContentNode(node: HTMLDivElement | null): void;
38
+ /** Pointer-обработчики для `.content`. Вешать всегда — внутри есть guard по `swipeEnabled`. */
39
+ dragHandlers: DragHandlers;
40
+ /** Активный snap-индекс (для `data-snap-index`). `undefined` если snap-points не заданы. */
41
+ snapIndex: number | undefined;
42
+ /** Идёт ли drag прямо сейчас (для `data-dragging`). */
43
+ isDragging: boolean;
44
+ };
45
+
46
+ /** CSS-высота для snap'а: `fit-content` → auto, доля → dvh, литералы px/%/dvh/svh/lvh — как есть. */
47
+ function resolveSnapCss(snap: SnapPoint): string {
48
+ if (snap === 'fit-content') return 'auto';
49
+ if (typeof snap === 'number') return `${snap * 100}dvh`;
50
+ if (snap.endsWith('px')) return snap;
51
+ if (snap.endsWith('%')) return `${parseFloat(snap)}dvh`;
52
+ return snap;
53
+ }
54
+
55
+ /**
56
+ * Drag-движок bottom-sheet'а на Pointer Events (единый путь для touch/mouse/pen).
57
+ *
58
+ * Модель drag'а — **изменение высоты, привязанной к низу** (а не translate): sheet растёт вверх при
59
+ * раскрытии и сжимается при сворачивании, не отрываясь от нижней кромки и не уезжая за экран.
60
+ * Высоту целиком ведёт движок императивно (React её не выставляет), чтобы не конфликтовать.
61
+ *
62
+ * Move/up слушаются на `document` (а не на `.content`): drag отслеживается, даже когда палец уходит
63
+ * за пределы sheet'а (например, тянем вверх от самой кромки). Pointer capture НЕ используется — он
64
+ * перенацеливает `click` на захватившую ноду и ломает кнопки внутри sheet'а.
65
+ *
66
+ * Ключевая мобильная механика — «drag только от края скролла» (vaul-подобная): если жест начат внутри
67
+ * прокручиваемого контента, который ещё не упёрся в нужный край, жест отдаётся нативному скроллу.
68
+ *
69
+ * - без `snapPoints` — single snap по высоте контента, swipe-down закрывает.
70
+ * - с `snapPoints` — multi-snap: drag меняет высоту → `snapIndex` или закрывает (см. `findTargetSnap`).
71
+ */
72
+ export function useDragEngine({
73
+ snapPoints,
74
+ defaultSnapIndex = 0,
75
+ snapIndex: snapIndexProp,
76
+ onSnapIndexChange,
77
+ onClose,
78
+ swipeEnabled,
79
+ isActive,
80
+ }: UseDragEngineProps): UseDragEngineReturn {
81
+ const safeSnapPoints = useMemo(() => snapPoints ?? [], [snapPoints]);
82
+ // Type-valid, но рантайм-невалидные snapPoints (например, `[50]` вместо `[0.5]`, или `'-5px'`)
83
+ // деградируют к single-snap, а не бросают необработанно в pointer-обработчике на первом свайпе.
84
+ const snapsValid = useMemo(() => safeSnapPoints.every(isValidSnapPoint), [safeSnapPoints]);
85
+ const hasSnapPoints = safeSnapPoints.length > 0 && snapsValid;
86
+ const lastIndex = safeSnapPoints.length - 1;
87
+ // Нецелочисленный / NaN индекс (например, вычисленный потребителем) приводим к 0, иначе он утёк бы
88
+ // в `data-snap-index` строкой 'NaN' и в `safeSnapPoints[NaN]` → undefined.
89
+ const clampIndex = (index: number) => (Number.isInteger(index) ? Math.max(0, Math.min(index, lastIndex)) : 0);
90
+ const clampedDefault = hasSnapPoints ? clampIndex(defaultSnapIndex) : 0;
91
+
92
+ const [snapIndex, setSnapIndex] = useValueControl<number>({
93
+ value: snapIndexProp,
94
+ defaultValue: clampedDefault,
95
+ onChange: onSnapIndexChange,
96
+ });
97
+
98
+ const resolvedIndex = snapIndex ?? clampedDefault;
99
+ const safeIndex = hasSnapPoints ? clampIndex(resolvedIndex) : 0;
100
+ const currentSnap: SnapPoint = hasSnapPoints ? safeSnapPoints[safeIndex] : 'fit-content';
101
+
102
+ // Зеркало snap-производных значений для чтения в pointer-обработчиках. Pointer-события синхронны
103
+ // и могут прийти между сменой snapPoints и ре-рендером React — ref всегда актуален, в отличие от
104
+ // значений, захваченных в closure обработчика.
105
+ const snapStateRef = useRef({ hasSnapPoints, safeIndex, lastIndex, safeSnapPoints, currentSnap });
106
+ snapStateRef.current = { hasSnapPoints, safeIndex, lastIndex, safeSnapPoints, currentSnap };
107
+
108
+ const contentRef = useRef<HTMLDivElement | null>(null);
109
+ const pointerId = useRef<number | null>(null);
110
+ const startTarget = useRef<EventTarget | null>(null);
111
+ const startY = useRef(0);
112
+ const startTime = useRef(0);
113
+ const startHeight = useRef(0);
114
+ const snapHeightsPx = useRef<number[]>([]);
115
+ const maxSnapHeightPx = useRef(0);
116
+ const lastDelta = useRef(0);
117
+ const committed = useRef(false);
118
+ const scrollPreventedAt = useRef(0);
119
+ const heightMounted = useRef(false);
120
+ const docListeners = useRef<{
121
+ move(event: PointerEvent): void;
122
+ up(event: PointerEvent): void;
123
+ cancel(event: PointerEvent): void;
124
+ } | null>(null);
125
+ // Отложенная async-работа жеста — храним хэндлы, чтобы отменять на reset/unmount (иначе осиротевший
126
+ // settle-таймер / veto-rAF может сработать по уже закрытому/переоткрытому sheet'у).
127
+ const settleTimer = useRef(0);
128
+ const vetoRaf = useRef(0);
129
+ // Прокручиваемый предок резолвим один раз за жест (а не на каждом pointermove): getComputedStyle —
130
+ // дорогой style-recalc на самом горячем пути (инерционный скролл body даёт десятки move-событий).
131
+ const scrollableAncestor = useRef<HTMLElement | null>(null);
132
+
133
+ const [isDragging, setIsDragging] = useState(false);
134
+
135
+ /** Выставить height на `.content`: `animate=false` → мгновенно (transition none), иначе CSS-transition. */
136
+ const applyHeight = useCallback((value: string, animate: boolean) => {
137
+ const node = contentRef.current;
138
+ if (!node) return;
139
+ node.style.transition = animate ? '' : 'none';
140
+ node.style.height = value;
141
+ }, []);
142
+
143
+ const setContentNode = useCallback(
144
+ (node: HTMLDivElement | null) => {
145
+ contentRef.current = node;
146
+ // height живёт на движке (не на React-style) — выставляем стартовую высоту сразу при mount'е.
147
+ if (node) applyHeight(resolveSnapCss(snapStateRef.current.currentSnap), false);
148
+ },
149
+ [applyHeight],
150
+ );
151
+
152
+ // Анимируем height при смене snap'а через controlled `snapIndex` (drag-смену движок анимирует сам).
153
+ useLayoutEffect(() => {
154
+ if (committed.current) return;
155
+ applyHeight(resolveSnapCss(currentSnap), heightMounted.current);
156
+ heightMounted.current = true;
157
+ }, [currentSnap, applyHeight]);
158
+
159
+ const detachDocListeners = useCallback(() => {
160
+ const listeners = docListeners.current;
161
+ if (!listeners) return;
162
+ if (isBrowser()) {
163
+ document.removeEventListener('pointermove', listeners.move);
164
+ document.removeEventListener('pointerup', listeners.up);
165
+ document.removeEventListener('pointercancel', listeners.cancel);
166
+ }
167
+ docListeners.current = null;
168
+ }, []);
169
+
170
+ /**
171
+ * Полный обрыв жеста: снимаем document-listener'ы, отменяем отложенную работу и сбрасываем refs.
172
+ * Вызывается при unmount'е И при закрытии sheet'а (isActive=false) — иначе in-flight drag продолжал
173
+ * бы тянуть закрывающийся sheet ещё CLOSING_TIMEOUT мс, а `finish` мог повторно вызвать `onClose`.
174
+ */
175
+ const resetGesture = useCallback(() => {
176
+ detachDocListeners();
177
+ if (settleTimer.current) {
178
+ window.clearTimeout(settleTimer.current);
179
+ settleTimer.current = 0;
180
+ }
181
+ if (vetoRaf.current && isBrowser()) {
182
+ cancelAnimationFrame(vetoRaf.current);
183
+ vetoRaf.current = 0;
184
+ }
185
+ pointerId.current = null;
186
+ committed.current = false;
187
+ startTarget.current = null;
188
+ lastDelta.current = 0;
189
+ scrollPreventedAt.current = 0;
190
+ scrollableAncestor.current = null;
191
+ setIsDragging(false);
192
+ }, [detachDocListeners]);
193
+
194
+ const onPointerDown = useCallback(
195
+ (event: ReactPointerEvent<HTMLDivElement>) => {
196
+ if (!swipeEnabled || !isActive) return;
197
+ if (!event.isPrimary || pointerId.current !== null) return;
198
+ if (event.pointerType === 'mouse' && event.button !== 0) return;
199
+ if (event.target instanceof Element && event.target.closest(NO_DRAG_SELECTOR)) return;
200
+
201
+ const node = contentRef.current;
202
+ pointerId.current = event.pointerId;
203
+ startTarget.current = event.target;
204
+ startY.current = event.clientY;
205
+ startTime.current = Date.now();
206
+ startHeight.current = node?.offsetHeight ?? 0;
207
+ lastDelta.current = 0;
208
+ committed.current = false;
209
+ scrollPreventedAt.current = 0;
210
+ scrollableAncestor.current = findScrollableAncestor(event.target, node);
211
+
212
+ const { hasSnapPoints: snapsOn, safeSnapPoints: snaps } = snapStateRef.current;
213
+ if (snapsOn) {
214
+ // eslint-disable-next-line @cloud-ru/ssr-safe-react/domApi -- pointer-событие всегда из браузера
215
+ const viewportHeightPx = window.innerHeight;
216
+ snapHeightsPx.current = snaps.map(s => resolveSnapPointPx(s, viewportHeightPx, startHeight.current));
217
+ // Потолок drag'а — не ниже фактической высоты sheet'а: на mobile dvh/svh/lvh (CSS) и innerHeight
218
+ // (JS) расходятся на высоту URL-бара, и без клампа первый кадр lvh-snap'а скачком сжимался бы.
219
+ maxSnapHeightPx.current = Math.max(Math.max(...snapHeightsPx.current), startHeight.current);
220
+ } else {
221
+ snapHeightsPx.current = [];
222
+ maxSnapHeightPx.current = startHeight.current;
223
+ }
224
+
225
+ const move = (e: PointerEvent) => {
226
+ if (e.pointerId !== pointerId.current) return;
227
+
228
+ const delta = e.clientY - startY.current; // вниз — положительная
229
+ lastDelta.current = delta;
230
+ const { hasSnapPoints: on, safeIndex: idx, lastIndex: last } = snapStateRef.current;
231
+
232
+ if (!committed.current) {
233
+ if (Math.abs(delta) < DRAG_START_THRESHOLD_PX) return;
234
+
235
+ const isDown = delta > 0;
236
+ // Прокручиваемый предок зафиксирован в onPointerDown (от точки старта жеста); читаем из ref'а,
237
+ // а свежий край-скролл (scrollTop) проверяем ниже через isScrolledToTop/Bottom.
238
+ const scrollable = scrollableAncestor.current;
239
+
240
+ if (isDown) {
241
+ // Тянем вниз: пока вложенный скролл не на самом верху — отдаём жест ему.
242
+ if (scrollable && !isScrolledToTop(scrollable)) {
243
+ scrollPreventedAt.current = Date.now();
244
+ return;
245
+ }
246
+ } else {
247
+ // Тянем вверх: пока есть куда скроллить вниз — скроллим контент.
248
+ if (scrollable && !isScrolledToBottom(scrollable)) {
249
+ scrollPreventedAt.current = Date.now();
250
+ return;
251
+ }
252
+ // Вверх осмыслен только как expand на следующий snap.
253
+ if (!on || idx >= last) {
254
+ scrollPreventedAt.current = Date.now();
255
+ return;
256
+ }
257
+ }
258
+
259
+ // Cooldown после край-скролла — чтобы инерционный долёт до края не закрывал/раскрывал sheet.
260
+ if (Date.now() - scrollPreventedAt.current < SCROLL_LOCK_COOLDOWN_MS) return;
261
+
262
+ committed.current = true;
263
+ setIsDragging(true);
264
+ }
265
+
266
+ // Высота, привязанная к низу: вниз (delta>0) → меньше, вверх (delta<0) → больше.
267
+ const nextHeight = Math.max(0, Math.min(startHeight.current - delta, maxSnapHeightPx.current));
268
+ applyHeight(`${nextHeight}px`, false);
269
+ };
270
+
271
+ const finish = (cancelled: boolean) => (e: PointerEvent) => {
272
+ if (e.pointerId !== pointerId.current) return;
273
+ detachDocListeners();
274
+
275
+ const wasCommitted = committed.current;
276
+ const delta = lastDelta.current;
277
+ const startH = startHeight.current;
278
+ const maxH = maxSnapHeightPx.current;
279
+ const elapsed = Math.max(1, Date.now() - startTime.current);
280
+ const { hasSnapPoints: on, safeSnapPoints: snaps2 } = snapStateRef.current;
281
+
282
+ pointerId.current = null;
283
+ committed.current = false;
284
+ lastDelta.current = 0;
285
+ scrollPreventedAt.current = 0;
286
+ startTarget.current = null;
287
+
288
+ if (!wasCommitted) return;
289
+ setIsDragging(false);
290
+
291
+ if (cancelled) {
292
+ applyHeight(resolveSnapCss(snapStateRef.current.currentSnap), true);
293
+ return;
294
+ }
295
+
296
+ const velocity = delta / elapsed; // px/ms, вниз — положительная
297
+ const currentHeightPx = Math.max(0, Math.min(startH - delta, maxH));
298
+
299
+ if (on) {
300
+ const target = findTargetSnap(snapHeightsPx.current, currentHeightPx, velocity);
301
+ if (target === -1) {
302
+ // Закрытие: высоту не трогаем (sheet уже сжат), уезжает leave-анимацией `.contentWrapper`.
303
+ onClose();
304
+ } else {
305
+ setSnapIndex(target);
306
+ if (snapIndexProp === undefined) {
307
+ // Uncontrolled: state обновится синхронно (вето невозможно) — анимируем к target сразу.
308
+ applyHeight(resolveSnapCss(snaps2[target]), true);
309
+ } else {
310
+ // Controlled: высоту ведёт проп. На следующем кадре выравниваем по фактическому
311
+ // `currentSnap`: потребитель вернул target → анимируем к target; проигнорировал
312
+ // `onSnapIndexChange` (вето) → возвращаем к исходному snap'у, а не «залипаем» на
313
+ // release-позиции драга.
314
+ if (isBrowser()) {
315
+ vetoRaf.current = requestAnimationFrame(() => {
316
+ vetoRaf.current = 0;
317
+ if (!committed.current) applyHeight(resolveSnapCss(snapStateRef.current.currentSnap), true);
318
+ });
319
+ }
320
+ }
321
+ }
322
+ return;
323
+ }
324
+
325
+ if (velocity > VELOCITY_THRESHOLD_PX_PER_MS || delta > startH * SINGLE_CLOSE_DISTANCE_RATIO) {
326
+ onClose();
327
+ return;
328
+ }
329
+
330
+ // Single fit-content: возврат к контентной высоте. Анимируем к px старта, затем отдаём auto.
331
+ applyHeight(`${startH}px`, true);
332
+ settleTimer.current = window.setTimeout(() => {
333
+ settleTimer.current = 0;
334
+ if (!committed.current) applyHeight('auto', false);
335
+ }, SETTLE_TIMEOUT_MS);
336
+ };
337
+
338
+ detachDocListeners(); // safety: снять возможные висящие listener'ы прошлого жеста
339
+ docListeners.current = { move, up: finish(false), cancel: finish(true) };
340
+ if (isBrowser()) {
341
+ document.addEventListener('pointermove', docListeners.current.move);
342
+ document.addEventListener('pointerup', docListeners.current.up);
343
+ document.addEventListener('pointercancel', docListeners.current.cancel);
344
+ }
345
+ },
346
+ [swipeEnabled, isActive, applyHeight, onClose, setSnapIndex, detachDocListeners, snapIndexProp],
347
+ );
348
+
349
+ // Реакция на смену фазы sheet'а:
350
+ // - закрытие (isActive=false) → обрываем in-flight жест (иначе тянул бы закрывающийся sheet ещё
351
+ // CLOSING_TIMEOUT мс и `finish` мог бы повторно вызвать onClose); снап-индекс/высоту не трогаем,
352
+ // чтобы не мешать leave-анимации;
353
+ // - открытие (isActive=true) → выставляем чистую стартовую высоту по текущему snap'у: при быстром
354
+ // close→reopen в пределах CLOSING_TIMEOUT `.content` не перемонтируется, и без этого осталась бы
355
+ // inline-высота от прошлого жеста.
356
+ useLayoutEffect(() => {
357
+ if (isActive) {
358
+ applyHeight(resolveSnapCss(snapStateRef.current.currentSnap), false);
359
+ } else {
360
+ resetGesture();
361
+ }
362
+ }, [isActive, applyHeight, resetGesture]);
363
+
364
+ // Финальная очистка при размонтировании (onClose посреди drag'а и т.п.).
365
+ useEffect(() => resetGesture, [resetGesture]);
366
+
367
+ return {
368
+ setContentNode,
369
+ dragHandlers: { onPointerDown },
370
+ snapIndex: hasSnapPoints ? safeIndex : undefined,
371
+ isDragging,
372
+ };
373
+ }
@@ -0,0 +1,80 @@
1
+ import { useLayoutEffect } from '@cloud-ru/ds-utils';
2
+ import { useEffect, useRef } from 'react';
3
+ import { tabbable } from 'tabbable';
4
+
5
+ /**
6
+ * Focus scope для bottom-sheet-панели: фокус внутрь при открытии + цикличный Tab/Shift+Tab.
7
+ * Возврат фокуса на триггер делает сам `BottomSheetCustom`. Nested-safe: Tab-обработчик трогает
8
+ * фокус только когда тот уже внутри панели, поэтому вложенные sheet'ы не конфликтуют.
9
+ * Возвращает ref на корневой DOM-узел панели.
10
+ */
11
+ export function useFocusTrap(active: boolean) {
12
+ const containerRef = useRef<HTMLDivElement>(null);
13
+
14
+ useLayoutEffect(() => {
15
+ if (!active) return;
16
+
17
+ const container = containerRef.current;
18
+ if (!container) return;
19
+
20
+ // Контейнер всегда фокусируемый (tabindex=-1): если focusable-дети удалятся в рантайме,
21
+ // Tab-обработчик вернёт фокус на root и удержит trap.
22
+ if (!container.hasAttribute('tabindex')) {
23
+ container.setAttribute('tabindex', '-1');
24
+ }
25
+ // Фокус при открытии — на панель, не на первый focusable: скринридер озвучивает заголовок,
26
+ // на touch не всплывает лишняя focus-рамка и виртуальная клавиатура.
27
+ container.focus({ preventScroll: true });
28
+ }, [active]);
29
+
30
+ useEffect(() => {
31
+ if (!active) return;
32
+
33
+ const handleKeyDown = (event: KeyboardEvent) => {
34
+ if (event.key !== 'Tab') return;
35
+ const container = containerRef.current;
36
+ if (!container) return;
37
+
38
+ const activeElement = document.activeElement;
39
+ if (!(activeElement instanceof HTMLElement)) return;
40
+
41
+ // Вложенный sheet живёт в отдельном portal'е — если фокус не внутри контейнера, не трогаем.
42
+ const focusInsideDialog = activeElement === container || container.contains(activeElement);
43
+ if (!focusInsideDialog) return;
44
+
45
+ // preventScroll везде: перевод фокуса в fixed-overlay не должен скроллить фон-страницу.
46
+ const nodes = tabbable(container);
47
+ if (nodes.length === 0) {
48
+ event.preventDefault();
49
+ container.focus({ preventScroll: true });
50
+ return;
51
+ }
52
+
53
+ const first = nodes[0];
54
+ const last = nodes[nodes.length - 1];
55
+
56
+ if (activeElement === container) {
57
+ event.preventDefault();
58
+ if (event.shiftKey) last?.focus({ preventScroll: true });
59
+ else first?.focus({ preventScroll: true });
60
+ return;
61
+ }
62
+
63
+ if (event.shiftKey && activeElement === first) {
64
+ event.preventDefault();
65
+ last?.focus({ preventScroll: true });
66
+ return;
67
+ }
68
+
69
+ if (!event.shiftKey && activeElement === last) {
70
+ event.preventDefault();
71
+ first?.focus({ preventScroll: true });
72
+ }
73
+ };
74
+
75
+ document.addEventListener('keydown', handleKeyDown, true);
76
+ return () => document.removeEventListener('keydown', handleKeyDown, true);
77
+ }, [active]);
78
+
79
+ return containerRef;
80
+ }
@@ -0,0 +1,52 @@
1
+ import { useEffect, useState } from 'react';
2
+
3
+ /**
4
+ * Mount/unmount transition phase для портал-компонента.
5
+ *
6
+ * Возвращает два независимых флага:
7
+ * - `isMounted` — нужно ли рендерить DOM. `false` после `open=false` + завершения leave-анимации.
8
+ * - `isActive` — поднят ли state «активен» (для CSS-перехода). `true` после первого frame'а
9
+ * после mount'а; `false` сразу при `open=false` (запускает leave-анимацию).
10
+ *
11
+ * Связка `isMounted=true, isActive=false` ставится при первом рендере: элемент в DOM, но
12
+ * в начальной позиции. Через double-rAF переключается на `isActive=true`, что инициирует
13
+ * CSS-transition на конечную позицию.
14
+ *
15
+ * На `open=false`: `isActive` сразу сбрасывается (CSS-transition в обратку), `isMounted`
16
+ * остаётся `true` ещё `exitDurationMs` ms, после чего размонтируем.
17
+ *
18
+ * `exitDurationMs === 0` — мгновенный цикл (для `disableMotions`): `isActive` поднимается
19
+ * сразу при mount, `isMounted` сбрасывается сразу при close без таймера и без double-rAF.
20
+ */
21
+ export function useTransitionPhase(open: boolean, exitDurationMs: number) {
22
+ const [isMounted, setIsMounted] = useState(false);
23
+ const [isActive, setIsActive] = useState(false);
24
+
25
+ useEffect(() => {
26
+ if (open) {
27
+ setIsMounted(true);
28
+ if (exitDurationMs === 0) {
29
+ setIsActive(true);
30
+ return;
31
+ }
32
+ let raf2Id = 0;
33
+ const raf1Id = requestAnimationFrame(() => {
34
+ raf2Id = requestAnimationFrame(() => setIsActive(true));
35
+ });
36
+ return () => {
37
+ cancelAnimationFrame(raf1Id);
38
+ cancelAnimationFrame(raf2Id);
39
+ };
40
+ }
41
+
42
+ setIsActive(false);
43
+ if (exitDurationMs === 0) {
44
+ setIsMounted(false);
45
+ return;
46
+ }
47
+ const timeoutId = window.setTimeout(() => setIsMounted(false), exitDurationMs);
48
+ return () => window.clearTimeout(timeoutId);
49
+ }, [open, exitDurationMs]);
50
+
51
+ return { isMounted, isActive };
52
+ }
@@ -0,0 +1 @@
1
+ export * from './BottomSheetCustom';
@@ -0,0 +1,146 @@
1
+ @use '@cloud-ru/ds-figma-variables/build/scss/styles/styles.module' as base;
2
+ @use '@cloud-ru/ds-figma-variables/build/scss/components/bottomSheet.module' as bottomSheet;
3
+
4
+ .root {
5
+ pointer-events: none;
6
+ // z-index=0: `position: fixed` создаёт stacking context, а порталы из sheet'а (Tooltip/Search/
7
+ // Dropdown) перекрывают его по DOM-порядку. Высокий z-index ломал это.
8
+ position: fixed;
9
+ z-index: 0;
10
+ inset: 0;
11
+ }
12
+
13
+ .backdrop {
14
+ pointer-events: auto;
15
+ // Гасим нативные жесты на подложке (pull-to-refresh / scroll фона).
16
+ touch-action: none;
17
+
18
+ position: absolute;
19
+ inset: 0;
20
+
21
+ opacity: 0;
22
+ background-color: base.$sn-theme-color-blackout;
23
+
24
+ transition: opacity 0.2s;
25
+
26
+ .root[data-active] & {
27
+ opacity: 1;
28
+ }
29
+
30
+ .root:not([data-active]) & {
31
+ opacity: 0;
32
+ }
33
+ }
34
+
35
+ .contentWrapper {
36
+ pointer-events: auto;
37
+ will-change: transform;
38
+
39
+ position: absolute;
40
+ right: 0;
41
+ bottom: 0;
42
+ left: 0;
43
+ transform: translateY(100%);
44
+
45
+ display: flex;
46
+ flex-direction: column;
47
+
48
+ // Верхний зазор для не-full snap'ов: видна подложка (tap-to-dismiss) + уважение notch (min 32px).
49
+ max-height: calc(
50
+ 100% - max(
51
+ #{base.simple-var(bottomSheet.$bottomSheet, 'anatomy', 'safeArea', 'padding-top')},
52
+ env(safe-area-inset-top)
53
+ )
54
+ );
55
+
56
+ transition: transform 0.2s cubic-bezier(0.32, 0.72, 0, 1);
57
+
58
+ // Full-height (snap = 1 / 100dvh): весь вьюпорт без верхнего зазора. Notch уважается
59
+ // padding-top'ом на `.content[data-full-height]`, поэтому здесь env не вычитаем.
60
+ &[data-full-height] {
61
+ max-height: 100%;
62
+ }
63
+
64
+ &[data-active] {
65
+ transform: translateY(0);
66
+ }
67
+
68
+ .root:not([data-active]) & {
69
+ transform: translateY(100%);
70
+ }
71
+ }
72
+
73
+ .content {
74
+ position: relative;
75
+
76
+ overflow: hidden;
77
+ display: flex;
78
+ flex: 1 1 auto;
79
+ flex-direction: column;
80
+ // Без `touch-action: none`: `.content` — предок прокручиваемого `.body`. Жесты гасятся на
81
+ // листовых drag-зонах (handle/headline/footer/media/safeArea), а `.body` оставлен `pan-y`.
82
+ box-sizing: border-box;
83
+ width: 100%;
84
+ min-height: 0;
85
+ max-height: 100%;
86
+ padding-top: base.simple-var(bottomSheet.$bottomSheet, 'anatomy', 'container', 'padding-top');
87
+ border-top-left-radius: base.simple-var(bottomSheet.$bottomSheet, 'anatomy', 'container', 'border-top-left-radius');
88
+ border-top-right-radius: base.simple-var(bottomSheet.$bottomSheet, 'anatomy', 'container', 'border-top-right-radius');
89
+
90
+ background-color: base.$sn-theme-color-neutral-background1Level;
91
+ box-shadow: base.$sn-boxShadow-elevation-level5;
92
+
93
+ // Drag меняет высоту, привязанную к низу. Во время drag'а движок ставит inline `transition: none`
94
+ // (покадрово), на отпускании возвращает этот transition; управление императивное.
95
+ transition: height 0.2s cubic-bezier(0.32, 0.72, 0, 1);
96
+
97
+ // `.content` (role=dialog) фокусируется при открытии (контейнер, не контрол) — гасим нативную
98
+ // focus-рамку; её показывают focusable-дети при клавиатурной навигации.
99
+ &:focus,
100
+ &:focus-visible {
101
+ outline: none;
102
+ }
103
+
104
+ &[data-dragging] {
105
+ cursor: grabbing;
106
+ user-select: none;
107
+ }
108
+
109
+ &[data-swipe-enabled]:not([data-dragging]) {
110
+ cursor: grab;
111
+ }
112
+
113
+ // На full-height верхние углы квадратные (скругление осмысленно, только когда над sheet'ом виден фон).
114
+ &[data-full-height] {
115
+ border-top-left-radius: 0;
116
+ border-top-right-radius: 0;
117
+ }
118
+
119
+ // Safe-area: env-паддинг прямо на `.content`. Нижний — всегда (home-indicator), верхний —
120
+ // только при full-height (верх уходит под notch). Без выреза `env(...)` = 0.
121
+ &[data-safe-area] {
122
+ padding-bottom: env(safe-area-inset-bottom);
123
+ }
124
+
125
+ &[data-safe-area][data-full-height] {
126
+ padding-top: env(safe-area-inset-top);
127
+ }
128
+ }
129
+
130
+ // prefers-reduced-motion: гасим анимации (WCAG 2.3.3). Длительность сводим почти к нулю, а не `none`,
131
+ // чтобы mount/unmount по `CLOSING_TIMEOUT` и settle-логика drag-движка не ломались.
132
+ @media (prefers-reduced-motion: reduce) {
133
+ .backdrop,
134
+ .contentWrapper,
135
+ .content {
136
+ transition-duration: 0.01ms;
137
+ }
138
+ }
139
+
140
+ .root[data-disable-motions] {
141
+ .backdrop,
142
+ .contentWrapper,
143
+ .content {
144
+ transition: none;
145
+ }
146
+ }