@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,38 @@
1
+ import { SnapPoint } from '../../../types.js';
2
+ /**
3
+ * Валиден ли `SnapPoint` для рантайма (формат + диапазон). TS-тип `${number}` шире регэкспа
4
+ * (принимает `'-5px'`, `'1e3px'`, `'.5px'`), а `number` — любое число; этот предикат отсеивает то,
5
+ * на чём `resolveSnapPointPx` бросил бы. Используется движком, чтобы деградировать к single-snap
6
+ * вместо необработанного throw в pointer-обработчике.
7
+ */
8
+ export declare function isValidSnapPoint(snap: SnapPoint): boolean;
9
+ /**
10
+ * Разрешает `SnapPoint` в высоту в пикселях для текущего viewport'а.
11
+ *
12
+ * - `'fit-content'` → `contentHeightPx` (высота контента — измеряется потребителем через ref).
13
+ * - `number` (0..1] → доля от `viewportHeightPx` (`0.5` → 50% viewport'а).
14
+ * - `'<n>px'` → литеральные `n` пикселей.
15
+ * - `'<n>%'` → `n%` от viewport'а.
16
+ * - `'<n>dvh'` / `'<n>svh'` / `'<n>lvh'` → `n%` от viewport'а (в JS-расчётах все эти юниты
17
+ * эквивалентны `vh` — реальное dynamic-поведение применяется CSS'ом, а в JS-снапах
18
+ * используется текущий `window.innerHeight`).
19
+ *
20
+ * Бросает на невалидной строке, чтобы расхождение spec'а ловилось рано.
21
+ */
22
+ export declare function resolveSnapPointPx(snap: SnapPoint, viewportHeightPx: number, contentHeightPx: number): number;
23
+ /**
24
+ * Порог скорости (px/ms) быстрого флик-жеста. Единый источник для обоих сценариев:
25
+ * multi-snap-навигации (`findTargetSnap`) и single-snap-закрытия (`useDragEngine`).
26
+ */
27
+ export declare const VELOCITY_THRESHOLD_PX_PER_MS = 0.5;
28
+ /**
29
+ * Определяет целевой snap-индекс по текущей высоте sheet'а и скорости drag'а.
30
+ *
31
+ * - `velocityPxPerMs < 0` — drag вверх (раскрытие): уходим на следующий snap, либо последний.
32
+ * - `velocityPxPerMs > 0` — drag вниз (схлопывание): уходим на предыдущий snap, либо ниже первого → закрытие.
33
+ * - `|velocity| < threshold` — скорость мала → выбираем ближайший snap по расстоянию.
34
+ * - Если текущая высота ниже `closeThresholdRatio * snapHeightsPx[0]` — возвращает `-1` (закрытие).
35
+ *
36
+ * @returns индекс snap'а ∈ `[0, snapHeightsPx.length)` либо `-1` (sheet хочет закрыться).
37
+ */
38
+ export declare function findTargetSnap(snapHeightsPx: number[], currentHeightPx: number, velocityPxPerMs: number, closeThresholdRatio?: number): number;
@@ -0,0 +1,96 @@
1
+ /** Формат `SnapPoint`-строки, который понимает рантайм (число с опц. дробной частью + юнит). */
2
+ const SNAP_STRING_RE = /^(\d+(?:\.\d+)?)(px|%|dvh|svh|lvh)$/;
3
+ /**
4
+ * Валиден ли `SnapPoint` для рантайма (формат + диапазон). TS-тип `${number}` шире регэкспа
5
+ * (принимает `'-5px'`, `'1e3px'`, `'.5px'`), а `number` — любое число; этот предикат отсеивает то,
6
+ * на чём `resolveSnapPointPx` бросил бы. Используется движком, чтобы деградировать к single-snap
7
+ * вместо необработанного throw в pointer-обработчике.
8
+ */
9
+ export function isValidSnapPoint(snap) {
10
+ if (snap === 'fit-content')
11
+ return true;
12
+ if (typeof snap === 'number')
13
+ return snap > 0 && snap <= 1;
14
+ const match = SNAP_STRING_RE.exec(snap);
15
+ return match !== null && Number(match[1]) > 0;
16
+ }
17
+ /**
18
+ * Разрешает `SnapPoint` в высоту в пикселях для текущего viewport'а.
19
+ *
20
+ * - `'fit-content'` → `contentHeightPx` (высота контента — измеряется потребителем через ref).
21
+ * - `number` (0..1] → доля от `viewportHeightPx` (`0.5` → 50% viewport'а).
22
+ * - `'<n>px'` → литеральные `n` пикселей.
23
+ * - `'<n>%'` → `n%` от viewport'а.
24
+ * - `'<n>dvh'` / `'<n>svh'` / `'<n>lvh'` → `n%` от viewport'а (в JS-расчётах все эти юниты
25
+ * эквивалентны `vh` — реальное dynamic-поведение применяется CSS'ом, а в JS-снапах
26
+ * используется текущий `window.innerHeight`).
27
+ *
28
+ * Бросает на невалидной строке, чтобы расхождение spec'а ловилось рано.
29
+ */
30
+ export function resolveSnapPointPx(snap, viewportHeightPx, contentHeightPx) {
31
+ if (snap === 'fit-content')
32
+ return contentHeightPx;
33
+ if (typeof snap === 'number') {
34
+ if (snap <= 0 || snap > 1) {
35
+ throw new Error(`Invalid SnapPoint fraction: ${snap} (expected (0, 1])`);
36
+ }
37
+ return Math.round(snap * viewportHeightPx);
38
+ }
39
+ const match = SNAP_STRING_RE.exec(snap);
40
+ if (!match) {
41
+ throw new Error(`Invalid SnapPoint: ${snap}`);
42
+ }
43
+ const value = Number(match[1]);
44
+ const unit = match[2];
45
+ if (value <= 0) {
46
+ throw new Error(`Invalid SnapPoint: ${snap} (must be positive)`);
47
+ }
48
+ if (unit === 'px')
49
+ return Math.round(value);
50
+ return Math.round((value / 100) * viewportHeightPx);
51
+ }
52
+ /**
53
+ * Порог скорости (px/ms) быстрого флик-жеста. Единый источник для обоих сценариев:
54
+ * multi-snap-навигации (`findTargetSnap`) и single-snap-закрытия (`useDragEngine`).
55
+ */
56
+ export const VELOCITY_THRESHOLD_PX_PER_MS = 0.5;
57
+ const CLOSE_THRESHOLD_RATIO_DEFAULT = 0.3;
58
+ /**
59
+ * Определяет целевой snap-индекс по текущей высоте sheet'а и скорости drag'а.
60
+ *
61
+ * - `velocityPxPerMs < 0` — drag вверх (раскрытие): уходим на следующий snap, либо последний.
62
+ * - `velocityPxPerMs > 0` — drag вниз (схлопывание): уходим на предыдущий snap, либо ниже первого → закрытие.
63
+ * - `|velocity| < threshold` — скорость мала → выбираем ближайший snap по расстоянию.
64
+ * - Если текущая высота ниже `closeThresholdRatio * snapHeightsPx[0]` — возвращает `-1` (закрытие).
65
+ *
66
+ * @returns индекс snap'а ∈ `[0, snapHeightsPx.length)` либо `-1` (sheet хочет закрыться).
67
+ */
68
+ export function findTargetSnap(snapHeightsPx, currentHeightPx, velocityPxPerMs, closeThresholdRatio = CLOSE_THRESHOLD_RATIO_DEFAULT) {
69
+ if (snapHeightsPx.length === 0)
70
+ return -1;
71
+ const firstSnap = snapHeightsPx[0];
72
+ if (currentHeightPx < firstSnap * (1 - closeThresholdRatio)) {
73
+ return -1;
74
+ }
75
+ if (velocityPxPerMs < -VELOCITY_THRESHOLD_PX_PER_MS) {
76
+ const nextIdx = snapHeightsPx.findIndex(h => h > currentHeightPx);
77
+ return nextIdx === -1 ? snapHeightsPx.length - 1 : nextIdx;
78
+ }
79
+ if (velocityPxPerMs > VELOCITY_THRESHOLD_PX_PER_MS) {
80
+ let prevIdx = -1;
81
+ for (let i = snapHeightsPx.length - 1; i >= 0; i--) {
82
+ if (snapHeightsPx[i] < currentHeightPx) {
83
+ prevIdx = i;
84
+ break;
85
+ }
86
+ }
87
+ return prevIdx === -1 ? -1 : prevIdx;
88
+ }
89
+ let bestIdx = 0;
90
+ for (let i = 1; i < snapHeightsPx.length; i++) {
91
+ if (Math.abs(snapHeightsPx[i] - currentHeightPx) < Math.abs(snapHeightsPx[bestIdx] - currentHeightPx)) {
92
+ bestIdx = i;
93
+ }
94
+ }
95
+ return bestIdx;
96
+ }
@@ -0,0 +1,2 @@
1
+ export * from './BottomSheet/index.js';
2
+ export * from './BottomSheetCustom/index.js';
@@ -0,0 +1,2 @@
1
+ export * from './BottomSheet/index.js';
2
+ export * from './BottomSheetCustom/index.js';
@@ -0,0 +1,11 @@
1
+ export { FOOTER_ACTIONS_ORIENTATION, MEDIA_KIND, TEST_IDS } from '@cloud-ru/ds-popup-private';
2
+ /**
3
+ * Data-атрибут escape-hatch: drag-to-dismiss bottom-sheet'а **не** начинается, если жест стартовал на
4
+ * элементе с этим атрибутом или его предке. Вешай его на собственный draggable-контент внутри sheet'а
5
+ * (слайдеры, color-picker, карты, canvas), иначе нативный drag контрола одновременно потащит sheet к
6
+ * закрытию. Аналог `touch-action`/`useSwipeable`-блокировки из легаси.
7
+ *
8
+ * @example
9
+ * <BottomSheet content={<div {...{ [NO_DRAG_ATTRIBUTE]: '' }}><ColorPicker … /></div>} />
10
+ */
11
+ export declare const NO_DRAG_ATTRIBUTE = "data-bottom-sheet-no-drag";
@@ -0,0 +1,13 @@
1
+ // Общий overlay-chrome (media / footer-ориентация / слот-`data-test-id`) вынесен в `@cloud-ru/ds-popup-private`.
2
+ // Реэкспортируем под теми же именами — внешний контракт `@cloud-ru/ds-bottom-sheet` не меняется.
3
+ export { FOOTER_ACTIONS_ORIENTATION, MEDIA_KIND, TEST_IDS } from '@cloud-ru/ds-popup-private';
4
+ /**
5
+ * Data-атрибут escape-hatch: drag-to-dismiss bottom-sheet'а **не** начинается, если жест стартовал на
6
+ * элементе с этим атрибутом или его предке. Вешай его на собственный draggable-контент внутри sheet'а
7
+ * (слайдеры, color-picker, карты, canvas), иначе нативный drag контрола одновременно потащит sheet к
8
+ * закрытию. Аналог `touch-action`/`useSwipeable`-блокировки из легаси.
9
+ *
10
+ * @example
11
+ * <BottomSheet content={<div {...{ [NO_DRAG_ATTRIBUTE]: '' }}><ColorPicker … /></div>} />
12
+ */
13
+ export const NO_DRAG_ATTRIBUTE = 'data-bottom-sheet-no-drag';
@@ -0,0 +1,2 @@
1
+ /** Drag-индикатор сверху bottom-sheet'а (32×4px). Декоративный — `aria-hidden`. */
2
+ export declare function Handle(): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,7 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { TEST_IDS } from '../../constants.js';
3
+ import styles from './styles.module.css';
4
+ /** Drag-индикатор сверху bottom-sheet'а (32×4px). Декоративный — `aria-hidden`. */
5
+ export function Handle() {
6
+ return (_jsx("div", { className: styles.wrapper, "aria-hidden": true, children: _jsx("span", { className: styles.handle, "data-test-id": TEST_IDS.handle }) }));
7
+ }
@@ -0,0 +1 @@
1
+ export * from './Handle.js';
@@ -0,0 +1 @@
1
+ export * from './Handle.js';
@@ -0,0 +1,18 @@
1
+ .wrapper{
2
+ touch-action:none;
3
+ display:flex;
4
+ flex-shrink:0;
5
+ align-items:center;
6
+ justify-content:center;
7
+ box-sizing:border-box;
8
+ width:100%;
9
+ height:var(--sn-bottomSheet-anatomy-badgeHandle-height, var(--sn-primitive-dimension-12, 12px));
10
+ }
11
+
12
+ .handle{
13
+ display:block;
14
+ width:var(--sn-bottomSheet-anatomy-badgeHandle-handle-width, var(--sn-primitive-dimension-32, 32px));
15
+ min-height:var(--sn-bottomSheet-anatomy-badgeHandle-handle-minHeight, var(--sn-primitive-dimension-4, 4px));
16
+ border-radius:var(--sn-bottomSheet-anatomy-badgeHandle-handle-borderRadius, var(--sn-primitive-dimension-full, 10000px));
17
+ background-color:var(--sn-theme-color-neutral-decor, var(--sn-brand-color-neutral-80, var(--sn-primitive-color-gray-80, #e3e5ed)));
18
+ }
@@ -0,0 +1 @@
1
+ export * from './Handle/index.js';
@@ -0,0 +1 @@
1
+ export * from './Handle/index.js';
@@ -0,0 +1,9 @@
1
+ export * from './components/index.js';
2
+ export * from './constants.js';
3
+ export { OVERLAY_SURFACE, OverlaySurfaceProvider, useOverlayBodyHeightAuto, useOverlaySurface, } from '@cloud-ru/ds-popup-private';
4
+ export type { OverlaySurface } from '@cloud-ru/ds-popup-private';
5
+ export { FooterActions } from '@cloud-ru/ds-popup-private';
6
+ export type { FooterActionsProps, FooterActionsTestIds } from '@cloud-ru/ds-popup-private';
7
+ export { PopupBody as SheetBody, PopupFooter as SheetFooter, PopupHeader as SheetHeader, PopupMedia as DialogMedia, } from '@cloud-ru/ds-popup-private';
8
+ export type { PopupBodyProps as SheetBodyProps, PopupFooterProps as SheetFooterProps, PopupHeaderProps as SheetHeaderProps, } from '@cloud-ru/ds-popup-private';
9
+ export * from './types.js';
@@ -0,0 +1,13 @@
1
+ export * from './components/index.js';
2
+ export * from './constants.js';
3
+ // Surface-context: общие слоты (`Dialog*`) ветвят визуал по нему; frame (sheet / modal / drawer)
4
+ // его проставляет. Вынесен в `@cloud-ru/ds-popup-private`, реэкспортируем для внешнего контракта.
5
+ export { OVERLAY_SURFACE, OverlaySurfaceProvider, useOverlayBodyHeightAuto, useOverlaySurface, } from '@cloud-ru/ds-popup-private';
6
+ // Публичный footer-builder — единый источник правды для футера BottomSheet / Modal / Drawer
7
+ // (типизированные кнопки approve/cancel/additional).
8
+ export { FooterActions } from '@cloud-ru/ds-popup-private';
9
+ // Sheet-слоты под собственными именами (фасад над `@cloud-ru/ds-popup-private`). Доступны и через namespace
10
+ // `BottomSheetCustom.Header/.Body/.Footer/.Media`. Modal/drawer оборачивают их своими surface-aware
11
+ // dispatcher'ами.
12
+ export { PopupBody as SheetBody, PopupFooter as SheetFooter, PopupHeader as SheetHeader, PopupMedia as DialogMedia, } from '@cloud-ru/ds-popup-private';
13
+ export * from './types.js';
@@ -0,0 +1,143 @@
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
+ }
28
+ .root{
29
+ pointer-events:none;
30
+ position:fixed;
31
+ z-index:0;
32
+ inset:0;
33
+ }
34
+
35
+ .backdrop{
36
+ pointer-events:auto;
37
+ touch-action:none;
38
+ position:absolute;
39
+ inset:0;
40
+ opacity:0;
41
+ background-color:var(--sn-theme-color-blackout, var(--sn-brand-color-overlay-forLightMode-blackout, rgba(0, 0, 0, 0.3215686275)));
42
+ transition:opacity 0.2s;
43
+ }
44
+ .root[data-active] .backdrop{
45
+ opacity:1;
46
+ }
47
+ .root:not([data-active]) .backdrop{
48
+ opacity:0;
49
+ }
50
+
51
+ .contentWrapper{
52
+ pointer-events:auto;
53
+ will-change:transform;
54
+ position:absolute;
55
+ right:0;
56
+ bottom:0;
57
+ left:0;
58
+ transform:translateY(100%);
59
+ display:flex;
60
+ flex-direction:column;
61
+ max-height:calc(100% - max(var(--sn-bottomSheet-anatomy-safeArea-paddingTop, var(--sn-primitive-dimension-32, 32px)), env(safe-area-inset-top)));
62
+ transition:transform 0.2s cubic-bezier(0.32, 0.72, 0, 1);
63
+ }
64
+ .contentWrapper[data-full-height]{
65
+ max-height:100%;
66
+ }
67
+ .contentWrapper[data-active]{
68
+ transform:translateY(0);
69
+ }
70
+ .root:not([data-active]) .contentWrapper{
71
+ transform:translateY(100%);
72
+ }
73
+
74
+ .content{
75
+ position:relative;
76
+ overflow:hidden;
77
+ display:flex;
78
+ flex:1 1 auto;
79
+ flex-direction:column;
80
+ box-sizing:border-box;
81
+ width:100%;
82
+ min-height:0;
83
+ max-height:100%;
84
+ padding-top:var(--sn-bottomSheet-anatomy-container-paddingTop, var(--sn-primitive-dimension-0, 0));
85
+ border-top-left-radius:var(--sn-bottomSheet-anatomy-container-borderTopLeftRadius, var(--sn-brand-anatomy-radius-window-m, var(--sn-primitive-dimension-4, 4px)));
86
+ border-top-right-radius:var(--sn-bottomSheet-anatomy-container-borderTopRightRadius, var(--sn-brand-anatomy-radius-window-m, var(--sn-primitive-dimension-4, 4px)));
87
+ background-color:var(--sn-theme-color-neutral-background1Level, var(--sn-brand-color-neutral-95, var(--sn-primitive-color-gray-95, #fdfdfd)));
88
+ box-shadow:var(--sn-boxShadow-elevation-level5, var(--sn-theme-effect-shadow-level5-layer1-positionX, 0) var(--sn-theme-effect-shadow-level5-layer1-positionY, 0) var(--sn-theme-effect-shadow-level5-layer1-blur, 16px) var(--sn-theme-effect-shadow-level5-layer1-speed, 0) var(--sn-theme-effect-shadow-layer1Color, rgba(0, 0, 0, 0.0784313725)), var(--sn-theme-effect-shadow-level5-layer2-positionX, 0) var(--sn-theme-effect-shadow-level5-layer2-positionY, 24px) var(--sn-theme-effect-shadow-level5-layer2-blur, 16px) var(--sn-theme-effect-shadow-level5-layer2-speed, 4px) var(--sn-theme-effect-shadow-layer2Color, rgba(0, 0, 0, 0.0784313725)));
89
+ transition:height 0.2s cubic-bezier(0.32, 0.72, 0, 1);
90
+ }
91
+ .content:focus, .content:focus-visible{
92
+ outline:none;
93
+ }
94
+ .content[data-dragging]{
95
+ cursor:grabbing;
96
+ -webkit-user-select:none;
97
+ -moz-user-select:none;
98
+ user-select:none;
99
+ }
100
+ .content[data-swipe-enabled]:not([data-dragging]){
101
+ cursor:grab;
102
+ }
103
+ .content[data-full-height]{
104
+ border-top-left-radius:0;
105
+ border-top-right-radius:0;
106
+ }
107
+ .content[data-safe-area]{
108
+ padding-bottom:env(safe-area-inset-bottom);
109
+ }
110
+ .content[data-safe-area][data-full-height]{
111
+ padding-top:env(safe-area-inset-top);
112
+ }
113
+
114
+ @media (prefers-reduced-motion: reduce){
115
+ .backdrop,
116
+ .contentWrapper,
117
+ .content{
118
+ transition-duration:0.01ms;
119
+ }
120
+ }
121
+ .root[data-disable-motions] .backdrop,
122
+ .root[data-disable-motions] .contentWrapper,
123
+ .root[data-disable-motions] .content{
124
+ transition:none;
125
+ }
126
+ .wrapper{
127
+ touch-action:none;
128
+ display:flex;
129
+ flex-shrink:0;
130
+ align-items:center;
131
+ justify-content:center;
132
+ box-sizing:border-box;
133
+ width:100%;
134
+ height:var(--sn-bottomSheet-anatomy-badgeHandle-height, var(--sn-primitive-dimension-12, 12px));
135
+ }
136
+
137
+ .handle{
138
+ display:block;
139
+ width:var(--sn-bottomSheet-anatomy-badgeHandle-handle-width, var(--sn-primitive-dimension-32, 32px));
140
+ min-height:var(--sn-bottomSheet-anatomy-badgeHandle-handle-minHeight, var(--sn-primitive-dimension-4, 4px));
141
+ border-radius:var(--sn-bottomSheet-anatomy-badgeHandle-handle-borderRadius, var(--sn-primitive-dimension-full, 10000px));
142
+ background-color:var(--sn-theme-color-neutral-decor, var(--sn-brand-color-neutral-80, var(--sn-primitive-color-gray-80, #e3e5ed)));
143
+ }
@@ -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 @@
1
+ export {};