@cloud-ru/ds-drawer 1.1.1 → 1.1.2-preview-86f06def.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloud-ru/ds-drawer",
-  "version": "1.1.1",
+  "version": "1.1.2-preview-86f06def.0",
   "description": "Пакет выезжающих панелей — компоненты Drawer и DrawerCustom с едиными токенами позиции и ширины.",
   "repository": {
     "type": "git",
@@ -40,13 +40,13 @@
     "classnames": "^2.5.1",
     "react-remove-scroll": "^2.7.2",
     "tabbable": "^6.5.0",
-    "@cloud-ru/ds-adaptive": "^1.0.1",
-    "@cloud-ru/ds-bottom-sheet": "^1.1.1",
-    "@cloud-ru/ds-materials": "^1.0.1",
-    "@cloud-ru/ds-popup-private": "^1.1.1",
-    "@cloud-ru/ds-portal-context": "^1.0.1",
-    "@cloud-ru/ds-scroll": "^1.0.2",
-    "@cloud-ru/ds-tooltip": "^1.0.4",
-    "@cloud-ru/ds-utils": "^1.1.0"
+    "@cloud-ru/ds-adaptive": "1.0.1",
+    "@cloud-ru/ds-popup-private": "1.1.2-preview-86f06def.0",
+    "@cloud-ru/ds-scroll": "1.0.2",
+    "@cloud-ru/ds-bottom-sheet": "1.1.2-preview-86f06def.0",
+    "@cloud-ru/ds-portal-context": "1.0.1",
+    "@cloud-ru/ds-tooltip": "1.0.4",
+    "@cloud-ru/ds-utils": "1.1.0",
+    "@cloud-ru/ds-materials": "1.0.1"
   }
 }

package/src/components/Drawer/types.ts

@@ -10,7 +10,8 @@ import { DrawerCustomProps } from '../DrawerCustom';
  *
  * Только desktop: `position`, `width`, `heightAuto`, `nestedDrawer` (на mobile игнорируются).
  * Только mobile: `swipeEnabled`, `snapPoints`, `snapIndex`, `onSnapIndexChange`, `safeArea`, `withDividers`
- * (на desktop-панели игнорируются — это анатомия `BottomSheet`).
+ * (на desktop-панели игнорируются — это анатомия `BottomSheet`). `snapPoints` по умолчанию —
+ * `MOBILE_SNAP_POINTS_DEFAULT` (`[1]`): sheet открывается на весь вьюпорт.
  */
 export type DrawerProps = WithSupportProps<
   Omit<DrawerCustomProps, 'nestedDrawer' | 'push' | 'resizable'> &
@@ -19,7 +20,7 @@ export type DrawerProps = WithSupportProps<
     Pick<DialogBodyProps, 'content'> & {
       /** Ссылка на скроллируемый контейнер контента (например, для дозагрузки по скроллу). */
       contentRef?: Ref<HTMLElement>;
-      /** Только mobile: разделители между шапкой/контентом/футером sheet'а. @default false */
+      /** Только mobile: разделители между шапкой/контентом/футером sheet'а. @default true */
       withDividers?: boolean;
       /** Текстовая строка-подзаголовок под title. */
       subtitle?: ReactNode;
@@ -34,7 +35,8 @@ export type DrawerProps = WithSupportProps<
       /** Дополнительная (третья) кнопка — пропсы `Button` (дефолт `view='simple'`, `appearance='neutral'`). */
       additionalButton?: BottomSheetActionButton;
       /**
-       * Ориентация кнопок футера. Применяется только при двух кнопках; игнорируется при заданном `footer`.
+       * Ориентация кнопок футера. Игнорируется при заданном `footer`. Без значения раскладку
+       * выбирает поверхность: два действия — в строку, три — стопкой.
        * @default 'horizontal'
        */
       footerActionsOrientation?: FooterActionsOrientation;

package/src/components/DrawerCustom/DrawerCustom.tsx

@@ -8,7 +8,7 @@ import cn from 'classnames';
 import { ComponentType, CSSProperties, useMemo } from 'react';
 import { RemoveScroll } from 'react-remove-scroll';
 
-import { TEST_IDS, WIDTH_AS_VALUES } from '../../constants';
+import { MOBILE_SNAP_POINTS_DEFAULT, TEST_IDS, WIDTH_AS_VALUES } from '../../constants';
 import {
   DialogBody,
   DialogBodyProps,
@@ -157,8 +157,9 @@ function DrawerFrame(props: DrawerCustomProps) {
 }
 
 /**
- * Адаптивный low-level `DrawerCustom`: на `mobile` — `BottomSheetCustom`, иначе — `DrawerFrame`.
- * Композиция одна (surface-aware слоты `.Header/.Body/.Footer`). Форс — `withLayoutType`.
+ * Адаптивный low-level `DrawerCustom`: на `mobile` — `BottomSheetCustom` (по умолчанию —
+ * full-screen, см. `MOBILE_SNAP_POINTS_DEFAULT`), иначе — `DrawerFrame`. Композиция одна
+ * (surface-aware слоты `.Header/.Body/.Footer`). Форс — `withLayoutType`.
  */
 export function DrawerCustom(props: DrawerCustomProps) {
   const { layoutType } = useAdaptiveLayout();
@@ -173,7 +174,7 @@ export function DrawerCustom(props: DrawerCustomProps) {
       container,
       closeOnPopstate,
       showBlackout,
-      snapPoints,
+      snapPoints = MOBILE_SNAP_POINTS_DEFAULT,
       swipeEnabled,
       safeArea,
       disableMotions,

package/src/components/DrawerCustom/types.ts

@@ -73,5 +73,6 @@ export type DrawerCustomProps = WithSupportProps<
     };
   }>
 > &
-  // Только mobile: управляют sheet-поверхностью (на desktop игнорируются).
+  // Только mobile: управляют sheet-поверхностью (на desktop игнорируются). `snapPoints` по
+  // умолчанию — `MOBILE_SNAP_POINTS_DEFAULT` (`[1]`): sheet открывается на весь вьюпорт.
   Pick<BottomSheetCustomProps, 'snapPoints' | 'swipeEnabled' | 'safeArea'>;

package/src/constants.ts

@@ -1,3 +1,5 @@
+import { SnapPoint } from '@cloud-ru/ds-bottom-sheet';
+
 export const TEST_IDS = {
   closeButton: 'drawer__close-button',
   header: 'drawer__header',
@@ -29,3 +31,9 @@ export const POSITION = {
   Top: 'top',
   Bottom: 'bottom',
 } as const;
+
+/**
+ * Snap-точки мобильной поверхности дровера по умолчанию: одна позиция на весь вьюпорт.
+ * Дровер на mobile открывается сразу full-screen; swipe-down закрывает его.
+ */
+export const MOBILE_SNAP_POINTS_DEFAULT: SnapPoint[] = [1];

package/src/helperComponents/DialogSlots.tsx

@@ -27,7 +27,7 @@ export type DialogFooterProps = SheetFooterProps & {
   cancelButton?: BottomSheetActionButton;
   /** Дополнительная (третья) кнопка. */
   additionalButton?: BottomSheetActionButton;
-  /** Ориентация кнопок при ровно двух действиях. */
+  /** Ориентация кнопок; без значения — по числу действий (два в строку, три стопкой). */
   footerActionsOrientation?: FooterActionsOrientation;
 };
 

package/src/helperComponents/MobileDrawer/MobileDrawer.tsx

@@ -2,7 +2,7 @@ import { BottomSheet } from '@cloud-ru/ds-bottom-sheet';
 import { extractSupportProps } from '@cloud-ru/ds-utils';
 
 import { DrawerProps } from '../../components/Drawer/types';
-import { TEST_IDS } from '../../constants';
+import { MOBILE_SNAP_POINTS_DEFAULT, TEST_IDS } from '../../constants';
 
 /**
  * Mobile-поверхность Drawer'а: контент в `BottomSheet`, слоты маппятся на API sheet'а
@@ -30,17 +30,16 @@ export function MobileDrawer({
   container,
   closeOnPopstate,
   swipeEnabled,
-  snapPoints,
+  snapPoints = MOBILE_SNAP_POINTS_DEFAULT,
   snapIndex,
   onSnapIndexChange,
   safeArea,
-  withDividers = false,
+  withDividers,
   ...rest
 }: DrawerProps) {
   // Футер собирает сам `BottomSheet`.
   return (
     <BottomSheet
-      // Дефолт `withDividers` в sheet'е — `true`; у Drawer'а вид исторически без разделителей.
       withDividers={withDividers}
       open={open}
       onClose={onClose}