@cloud-ru/ds-bottom-sheet 2.0.1-preview-a22f149a.0 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,14 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ ## 2.0.2 (2026-10-09)
7
+
8
+ **Note:** Version bump only for package @ds/bottom-sheet
9
+
10
+ ## 2.0.1 (2026-10-09)
11
+
12
+ **Note:** Version bump only for package @ds/bottom-sheet
13
+
6
14
  # 2.0.0 (2026-10-05)
7
15
 
8
16
  ### BREAKING CHANGES
package/README.md CHANGED
@@ -79,7 +79,7 @@ mobile-вьюпорте и всегда идут в столбик.
79
79
  <BottomSheet
80
80
  open={open}
81
81
  onClose={onClose}
82
- snapPoints={[0.5, 1]}
82
+ snapPoints={SNAP_POINTS_PRESET.halfFull}
83
83
  defaultSnapIndex={0}
84
84
  title='Меню'
85
85
  content={<List />}
@@ -88,6 +88,14 @@ mobile-вьюпорте и всегда идут в столбик.
88
88
 
89
89
  **Формат** — `number ∈ (0, 1] | 'Npx' | 'N%' | 'Ndvh' | 'Nsvh' | 'Nlvh' | 'fit-content'`. Порядок массива — от меньшей позиции к большей. Drag вверх → следующий snap; drag вниз ниже первого snap'а — закрытие.
90
90
 
91
+ Типовые наборы экспортируются константой `SNAP_POINTS_PRESET` (также реэкспортируется из `@cloud-ru/ds-list`, `@cloud-ru/ds-dropdown`, `@cloud-ru/ds-drawer`, `@cloud-ru/ds-modal`):
92
+
93
+ - `quarter` — `[0.25]`.
94
+ - `half` — `[0.5]`.
95
+ - `threeQuarters` — `[0.75]`.
96
+ - `full` — `[1]`, на всю высоту вьюпорта.
97
+ - `halfFull` — `[0.5, 1]`, открывается на половину, drag вверх раскрывает на всю высоту.
98
+
91
99
  - **Controlled snap** — задайте `snapIndex` + `onSnapIndexChange`. В этом режиме swipe вызывает `onSnapIndexChange`, но позицию не двигает: потребитель сам передаёт новое значение обратно.
92
100
  - **`swipeEnabled` (default `true`)** — `false` отключает swipe-жесты; переключить snap можно только программно через `snapIndex`.
93
101
  - **`closeOnPopstate` (default `true`)** — закрытие по browser-back (`popstate`). Полезно на mobile, чтобы аппаратная кнопка «назад» закрывала sheet вместо ухода со страницы.
@@ -807,14 +815,14 @@ export function CustomComposition() {
807
815
  snapPoints={[0.5, 1]} + controlled snapIndex
808
816
 
809
817
  ```tsx
810
- import { BottomSheetCustom } from '@cloud-ru/ds-bottom-sheet';
818
+ import { BottomSheetCustom, SNAP_POINTS_PRESET } from '@cloud-ru/ds-bottom-sheet';
811
819
  import { Button } from '@cloud-ru/ds-button';
812
820
  import { useState } from 'react';
813
821
 
814
822
  import { MobilePreview } from '../MobilePreview';
815
823
 
816
824
  /**
817
- * Custom-слой полностью управляет snap-движком. `snapPoints={[0.5, 1]}` открывает sheet на
825
+ * Custom-слой полностью управляет snap-движком. `SNAP_POINTS_PRESET.halfFull` (`[0.5, 1]`) открывает sheet на
818
826
  * половину экрана; drag вверх (или контролируемый `snapIndex`) раскрывает до full-viewport.
819
827
  * Активный snap отслеживается через `onSnapIndexChange`.
820
828
  */
@@ -828,7 +836,7 @@ export function CustomSnapPoints() {
828
836
  <BottomSheetCustom
829
837
  open={open}
830
838
  onClose={() => setOpen(false)}
831
- snapPoints={[0.5, 1]}
839
+ snapPoints={SNAP_POINTS_PRESET.halfFull}
832
840
  snapIndex={snapIndex}
833
841
  onSnapIndexChange={setSnapIndex}
834
842
  aria-label='Snap points sheet'
@@ -1,4 +1,3 @@
1
- import { SnapPoint } from './types';
2
1
  export { FOOTER_ACTIONS_ORIENTATION, MEDIA_KIND, TEST_IDS } from '@cloud-ru/ds-popup-private';
3
2
  /**
4
3
  * Data-атрибут escape-hatch: drag-to-dismiss bottom-sheet'а **не** начинается, если жест стартовал на
@@ -11,6 +10,13 @@ export { FOOTER_ACTIONS_ORIENTATION, MEDIA_KIND, TEST_IDS } from '@cloud-ru/ds-p
11
10
  */
12
11
  export declare const NO_DRAG_ATTRIBUTE = "data-bottom-sheet-no-drag";
13
12
  /**
14
- * Пресеты snap-points для различных сценариев использования.
13
+ * Пресеты `snapPoints` (доли высоты вьюпорта) для типовых сценариев.
15
14
  */
16
- export declare const SNAP_POINTS_PRESET: Record<string, SnapPoint[]>;
15
+ export declare const SNAP_POINTS_PRESET: {
16
+ quarter: number[];
17
+ half: number[];
18
+ threeQuarters: number[];
19
+ full: number[];
20
+ /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
21
+ halfFull: number[];
22
+ };
@@ -18,11 +18,13 @@ Object.defineProperty(exports, "TEST_IDS", { enumerable: true, get: function ()
18
18
  */
19
19
  exports.NO_DRAG_ATTRIBUTE = 'data-bottom-sheet-no-drag';
20
20
  /**
21
- * Пресеты snap-points для различных сценариев использования.
21
+ * Пресеты `snapPoints` (доли высоты вьюпорта) для типовых сценариев.
22
22
  */
23
23
  exports.SNAP_POINTS_PRESET = {
24
24
  quarter: [0.25],
25
25
  half: [0.5],
26
26
  threeQuarters: [0.75],
27
27
  full: [1],
28
+ /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
29
+ halfFull: [0.5, 1],
28
30
  };
@@ -1,4 +1,3 @@
1
- import { SnapPoint } from './types.js';
2
1
  export { FOOTER_ACTIONS_ORIENTATION, MEDIA_KIND, TEST_IDS } from '@cloud-ru/ds-popup-private';
3
2
  /**
4
3
  * Data-атрибут escape-hatch: drag-to-dismiss bottom-sheet'а **не** начинается, если жест стартовал на
@@ -11,6 +10,13 @@ export { FOOTER_ACTIONS_ORIENTATION, MEDIA_KIND, TEST_IDS } from '@cloud-ru/ds-p
11
10
  */
12
11
  export declare const NO_DRAG_ATTRIBUTE = "data-bottom-sheet-no-drag";
13
12
  /**
14
- * Пресеты snap-points для различных сценариев использования.
13
+ * Пресеты `snapPoints` (доли высоты вьюпорта) для типовых сценариев.
15
14
  */
16
- export declare const SNAP_POINTS_PRESET: Record<string, SnapPoint[]>;
15
+ export declare const SNAP_POINTS_PRESET: {
16
+ quarter: number[];
17
+ half: number[];
18
+ threeQuarters: number[];
19
+ full: number[];
20
+ /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
21
+ halfFull: number[];
22
+ };
@@ -12,11 +12,13 @@ export { FOOTER_ACTIONS_ORIENTATION, MEDIA_KIND, TEST_IDS } from '@cloud-ru/ds-p
12
12
  */
13
13
  export const NO_DRAG_ATTRIBUTE = 'data-bottom-sheet-no-drag';
14
14
  /**
15
- * Пресеты snap-points для различных сценариев использования.
15
+ * Пресеты `snapPoints` (доли высоты вьюпорта) для типовых сценариев.
16
16
  */
17
17
  export const SNAP_POINTS_PRESET = {
18
18
  quarter: [0.25],
19
19
  half: [0.5],
20
20
  threeQuarters: [0.75],
21
21
  full: [1],
22
+ /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
23
+ halfFull: [0.5, 1],
22
24
  };