@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,3 @@
1
+ import { BottomSheetProps } from '../../types';
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,39 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.BottomSheet = BottomSheet;
7
+ const jsx_runtime_1 = require("react/jsx-runtime");
8
+ const popup_private_1 = require("@cloud-ru/ds-popup-private");
9
+ const classnames_1 = __importDefault(require("classnames"));
10
+ const react_1 = require("react");
11
+ const constants_1 = require("../../constants");
12
+ const BottomSheetCustom_1 = require("../BottomSheetCustom");
13
+ const styles_module_scss_1 = __importDefault(require('./styles.module.css'));
14
+ function isMediaProps(value) {
15
+ return typeof value === 'object' && value !== null && !(0, react_1.isValidElement)(value) && 'src' in value && 'alt' in value;
16
+ }
17
+ /** Обёртка `@cloud-ru/ds-bottom-sheet` с готовой анатомией: media + header + body + footer + safeArea + dividers. */
18
+ function BottomSheet({ title, slotAfterTitle, subtitle, slotSecondTitle, onBackButtonClick, actionButton, media, content, bodyPadding = true, approveButton, cancelButton, additionalButton, footerActionsOrientation, footer, footerTestIds, withDividers = true, swipeEnabled = true,
19
+ // safeArea уходит в `...rest` → BottomSheetCustom (env-паддинг на `.content`).
20
+ className, ...rest }) {
21
+ const hasHeader = Boolean(title || onBackButtonClick || actionButton || slotAfterTitle || subtitle || slotSecondTitle);
22
+ const hasMedia = media != null;
23
+ const hasFullWidthMediaImage = hasMedia && isMediaProps(media) && (media.kind ?? 'image') === 'image';
24
+ // aria-labelledby связывает заголовок с dialog'ом; без title имя задаёт потребитель через aria-label.
25
+ const titleId = (0, react_1.useId)();
26
+ // Footer: произвольный `footer`-ReactNode (приоритет) либо сборка из слотов кнопок через общий
27
+ // `FooterActions` (тот же, что у Modal/Drawer, для adaptive-маппинга 1:1).
28
+ const footerContent = footer ??
29
+ (approveButton || cancelButton || additionalButton ? ((0, jsx_runtime_1.jsx)(popup_private_1.FooterActions, { surface: 'bottomSheet', size: 'l', approveButton: approveButton, cancelButton: cancelButton, additionalButton: additionalButton, footerActionsOrientation: footerActionsOrientation, testIds: {
30
+ approve: footerTestIds?.approve ?? constants_1.TEST_IDS.footerApprove,
31
+ cancel: footerTestIds?.cancel ?? constants_1.TEST_IDS.footerCancel,
32
+ additional: footerTestIds?.additional ?? constants_1.TEST_IDS.footerAdditional,
33
+ } })) : null);
34
+ const hasFooter = footerContent != null;
35
+ return ((0, jsx_runtime_1.jsx)(BottomSheetCustom_1.BottomSheetCustom, { ...rest, swipeEnabled: swipeEnabled, ...(title ? { 'aria-labelledby': titleId } : {}), className: (0, classnames_1.default)(className), disableMotions: false, children: (0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.root, children: [hasMedia &&
36
+ (isMediaProps(media) ? ((0, jsx_runtime_1.jsx)(popup_private_1.PopupMedia, { ...media })) : (
37
+ // ReactNode-media: тот же data-media-kind-контракт со значением 'custom'.
38
+ (0, jsx_runtime_1.jsx)("div", { "data-test-id": constants_1.TEST_IDS.media, "data-media-kind": 'custom', children: media }))), (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)(styles_module_scss_1.default.contentBlock, hasFullWidthMediaImage && styles_module_scss_1.default.contentBlockNoTopPadding), children: [hasHeader && ((0, jsx_runtime_1.jsx)(BottomSheetCustom_1.BottomSheetCustom.Header, { title: title, titleId: titleId, slotAfterTitle: slotAfterTitle, subtitle: subtitle, slotSecondTitle: slotSecondTitle, onBackButtonClick: onBackButtonClick, actionButton: actionButton })), withDividers && hasHeader && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.divider, "data-test-id": constants_1.TEST_IDS.dividerTop, "aria-hidden": true })), (0, jsx_runtime_1.jsx)(BottomSheetCustom_1.BottomSheetCustom.Body, { bodyPadding: bodyPadding, children: content }), withDividers && hasFooter && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.divider, "data-test-id": constants_1.TEST_IDS.dividerBottom, "aria-hidden": true })), hasFooter && (0, jsx_runtime_1.jsx)(BottomSheetCustom_1.BottomSheetCustom.Footer, { children: footerContent })] })] }) }));
39
+ }
@@ -0,0 +1 @@
1
+ export * from './BottomSheet';
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./BottomSheet"), exports);
@@ -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';
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,121 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.BottomSheetCustom = BottomSheetCustom;
7
+ const jsx_runtime_1 = require("react/jsx-runtime");
8
+ const popup_private_1 = require("@cloud-ru/ds-popup-private");
9
+ const portal_context_1 = require("@cloud-ru/ds-portal-context");
10
+ const theme_1 = require("@cloud-ru/ds-theme");
11
+ const utils_1 = require("@cloud-ru/ds-utils");
12
+ const classnames_1 = __importDefault(require("classnames"));
13
+ const react_1 = require("react");
14
+ const react_dom_1 = require("react-dom");
15
+ const react_remove_scroll_1 = require("react-remove-scroll");
16
+ const constants_1 = require("../../constants");
17
+ const helperComponents_1 = require("../../helperComponents");
18
+ const constants_2 = require("./constants");
19
+ const hooks_1 = require("./hooks");
20
+ const styles_module_scss_1 = __importDefault(require('./styles.module.css'));
21
+ /** Резолв portal-target'а. Вызывается после `isMounted=true` (браузер), `document` доступен. */
22
+ function resolveContainer(container, portalContextNode) {
23
+ if (typeof container === 'string') {
24
+ // eslint-disable-next-line @cloud-ru/ssr-safe-react/domApi -- guarded by isMounted (browser only)
25
+ return document.querySelector(container);
26
+ }
27
+ if (container instanceof HTMLElement)
28
+ return container;
29
+ // eslint-disable-next-line @cloud-ru/ssr-safe-react/domApi -- guarded by isMounted (browser only)
30
+ return portalContextNode ?? document.body;
31
+ }
32
+ /**
33
+ * Низкоуровневая обёртка bottom-sheet'а: portal + backdrop + slide-up motion + focus-trap +
34
+ * Pointer-Events swipe / snap-engine. Готовая анатомия — `BottomSheet`.
35
+ */
36
+ function BottomSheetCustom(props) {
37
+ 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;
38
+ // Sheet модальный, если затемняет фон или лочит скролл. Non-modal не прячет фон от AT,
39
+ // не ловит фокус и закрывается по Esc при фокусе снаружи.
40
+ const isModal = showBackdrop || lockScroll;
41
+ (0, utils_1.useModalOpenState)(open, onClose, { closeOnPopstate });
42
+ // Возврат фокуса на триггер: запоминаем активный элемент при open=true, возвращаем при open=false.
43
+ const restoreFocusRef = (0, react_1.useRef)(null);
44
+ const wasOpenRef = (0, react_1.useRef)(false);
45
+ (0, utils_1.useLayoutEffect)(() => {
46
+ if (open && !wasOpenRef.current) {
47
+ wasOpenRef.current = true;
48
+ restoreFocusRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
49
+ }
50
+ else if (!open && wasOpenRef.current) {
51
+ wasOpenRef.current = false;
52
+ const previous = restoreFocusRef.current;
53
+ restoreFocusRef.current = null;
54
+ if (previous &&
55
+ previous !== document.body &&
56
+ previous !== document.documentElement &&
57
+ document.documentElement.contains(previous)) {
58
+ previous.focus({ preventScroll: true });
59
+ }
60
+ }
61
+ }, [open]);
62
+ const { isMounted, isActive } = (0, hooks_1.useTransitionPhase)(open, disableMotions ? 0 : constants_2.CLOSING_TIMEOUT);
63
+ const portalContextRef = (0, portal_context_1.usePortalContext)();
64
+ // Фокус-trap только для модального sheet'а: в non-modal Tab уходит на фон.
65
+ const focusTrapRef = (0, hooks_1.useFocusTrap)(isActive && isModal);
66
+ // Esc → закрытие. `useModalOpenState` закрывает через `CloseWatcher` (Chromium-only); в
67
+ // Safari/Firefox навешиваем keydown-fallback ровно когда `CloseWatcher` недоступен.
68
+ // Nested-safe для модального sheet'а: закрываем только если фокус внутри этой панели; для
69
+ // non-modal фокус снаружи — закрываем безусловно.
70
+ (0, react_1.useEffect)(() => {
71
+ if (!isActive || !(0, utils_1.isBrowser)() || 'CloseWatcher' in window)
72
+ return;
73
+ const handleKeyDown = (event) => {
74
+ if (event.key !== 'Escape')
75
+ return;
76
+ const panel = focusTrapRef.current;
77
+ const focusInside = Boolean(panel && (panel === document.activeElement || panel.contains(document.activeElement)));
78
+ if (!isModal || focusInside) {
79
+ onClose();
80
+ }
81
+ };
82
+ document.addEventListener('keydown', handleKeyDown, true);
83
+ return () => document.removeEventListener('keydown', handleKeyDown, true);
84
+ }, [isActive, isModal, onClose, focusTrapRef]);
85
+ const { setContentNode, dragHandlers, snapIndex: activeSnapIndex, isDragging, } = (0, hooks_1.useDragEngine)({
86
+ snapPoints,
87
+ defaultSnapIndex,
88
+ snapIndex,
89
+ onSnapIndexChange,
90
+ onClose,
91
+ swipeEnabled,
92
+ isActive,
93
+ });
94
+ // Верхний safe-area отступ нужен только на full-height (верх под notch); флаг — в `data-full-height`.
95
+ const activeSnap = snapPoints?.[activeSnapIndex ?? 0];
96
+ const isFullHeight = activeSnap === 1 || (typeof activeSnap === 'string' && /^100(%|dvh|svh|lvh)$/.test(activeSnap));
97
+ const mergeRefCb = (0, react_1.useCallback)((node) => {
98
+ focusTrapRef.current = node;
99
+ setContentNode(node);
100
+ }, [focusTrapRef, setContentNode]);
101
+ const handleBackdropClick = (0, react_1.useCallback)(() => {
102
+ if (showBackdrop)
103
+ onClose();
104
+ }, [showBackdrop, onClose]);
105
+ // Мобильная поверхность — comfort-плотность.
106
+ const densityClassName = (0, theme_1.useThemeClassnames)({ density: 'comfort' });
107
+ if (!isMounted)
108
+ return null;
109
+ const targetNode = resolveContainer(container, portalContextRef.current);
110
+ if (!targetNode)
111
+ return null;
112
+ const supportProps = (0, utils_1.extractSupportProps)(rest);
113
+ return (0, react_dom_1.createPortal)(
114
+ // RemoveScroll лочит фон-скролл (refcount для вложенных sheet'ов); `enabled={lockScroll}` —
115
+ // для non-modal фон остаётся прокручиваемым.
116
+ (0, jsx_runtime_1.jsx)(react_remove_scroll_1.RemoveScroll, { enabled: lockScroll, children: (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)(styles_module_scss_1.default.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.backdrop, "data-test-id": constants_1.TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: (0, jsx_runtime_1.jsxs)("div", { ref: mergeRefCb, className: (0, classnames_1.default)(styles_module_scss_1.default.content, densityClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": constants_1.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 && (0, jsx_runtime_1.jsx)(helperComponents_1.Handle, {}), (0, jsx_runtime_1.jsx)(popup_private_1.OverlaySurfaceProvider, { surface: popup_private_1.OVERLAY_SURFACE.Sheet, children: children })] }) })] }) }), targetNode);
117
+ }
118
+ BottomSheetCustom.Header = popup_private_1.PopupHeader;
119
+ BottomSheetCustom.Body = popup_private_1.PopupBody;
120
+ BottomSheetCustom.Footer = popup_private_1.PopupFooter;
121
+ BottomSheetCustom.Media = popup_private_1.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,33 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SINGLE_CLOSE_DISTANCE_RATIO = exports.SCROLL_LOCK_COOLDOWN_MS = exports.DRAG_START_THRESHOLD_PX = exports.CLOSING_TIMEOUT = void 0;
4
+ /**
5
+ * Задержка размонтирования портала после `open=false` (мс). Должна быть ≥ длительности leave-анимации
6
+ * (slide-down `.contentWrapper` + fade `.backdrop` = 0.2s = 200ms в `styles.module.scss`), чтобы DOM
7
+ * не исчезал до завершения анимации. Держим 200мс — leave симметричен enter (0.2s). При правке этих
8
+ * CSS-длительностей синхронизируй и эту константу (фиксированный таймер, не `transitionend`).
9
+ * Под `prefers-reduced-motion` анимация мгновенна, а портал всё равно живёт по таймеру (≤200мс
10
+ * невидимого scroll-lock/focus-trap — приемлемо).
11
+ */
12
+ exports.CLOSING_TIMEOUT = 200;
13
+ /**
14
+ * Минимальное вертикальное смещение указателя (px), после которого жест трактуется как drag.
15
+ * До порога касание считается тапом — это защищает клики по контенту от ложного захвата drag'ом.
16
+ */
17
+ exports.DRAG_START_THRESHOLD_PX = 6;
18
+ /**
19
+ * Cooldown (ms) после того, как вложенный скролл достиг края: в течение него повторный жест
20
+ * не превращается в drag sheet'а. Без него инерционный скролл, доехавший до верха, мгновенно
21
+ * читается как «потяни вниз → закрой». Аналог `SCROLL_LOCK_TIMEOUT` в vaul.
22
+ */
23
+ exports.SCROLL_LOCK_COOLDOWN_MS = 100;
24
+ /**
25
+ * Доля высоты sheet'а, при превышении которой медленный drag вниз всё равно закрывает
26
+ * single-snap sheet (distance-критерий, когда скорость ниже velocity-порога). Отдельная константа
27
+ * от `CLOSE_THRESHOLD_RATIO_DEFAULT` в `utils/snapPoints.ts` намеренно: это два независимых регулятора
28
+ * (single-snap-закрытие vs multi-snap close-порог), совпадение значения (0.3) — не повод их связывать.
29
+ *
30
+ * Velocity-порог быстрого флика, наоборот, единый — `VELOCITY_THRESHOLD_PX_PER_MS` из
31
+ * `utils/snapPoints.ts` (один источник и для multi-snap-навигации, и для single-snap-закрытия).
32
+ */
33
+ exports.SINGLE_CLOSE_DISTANCE_RATIO = 0.3;
@@ -0,0 +1,3 @@
1
+ export * from './useDragEngine';
2
+ export * from './useFocusTrap';
3
+ export * from './useTransitionPhase';
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./useDragEngine"), exports);
18
+ __exportStar(require("./useFocusTrap"), exports);
19
+ __exportStar(require("./useTransitionPhase"), exports);
@@ -0,0 +1,44 @@
1
+ import { PointerEvent as ReactPointerEvent } from 'react';
2
+ import { SnapPoint } from '../../../types';
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 {};