@cloud-ru/ds-dropdown 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 (72) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/LICENSE +201 -0
  3. package/README.md +218 -0
  4. package/dist/cjs/Dropdown.d.ts +7 -0
  5. package/dist/cjs/Dropdown.js +16 -0
  6. package/dist/cjs/constants.d.ts +10 -0
  7. package/dist/cjs/constants.js +13 -0
  8. package/dist/cjs/helperComponents/DesktopDropdown/DesktopDropdown.d.ts +6 -0
  9. package/dist/cjs/helperComponents/DesktopDropdown/DesktopDropdown.js +24 -0
  10. package/dist/cjs/helperComponents/DesktopDropdown/index.d.ts +1 -0
  11. package/dist/cjs/helperComponents/DesktopDropdown/index.js +17 -0
  12. package/dist/cjs/helperComponents/DropdownBody/DropdownBody.d.ts +6 -0
  13. package/dist/cjs/helperComponents/DropdownBody/DropdownBody.js +54 -0
  14. package/dist/cjs/helperComponents/DropdownBody/index.d.ts +1 -0
  15. package/dist/cjs/helperComponents/DropdownBody/index.js +17 -0
  16. package/dist/cjs/helperComponents/MobileDropdown/MobileDropdown.d.ts +7 -0
  17. package/dist/cjs/helperComponents/MobileDropdown/MobileDropdown.js +38 -0
  18. package/dist/cjs/helperComponents/MobileDropdown/index.d.ts +1 -0
  19. package/dist/cjs/helperComponents/MobileDropdown/index.js +17 -0
  20. package/dist/cjs/helperComponents/index.d.ts +3 -0
  21. package/dist/cjs/helperComponents/index.js +19 -0
  22. package/dist/cjs/index.d.ts +4 -0
  23. package/dist/cjs/index.js +20 -0
  24. package/dist/cjs/locale/index.d.ts +71 -0
  25. package/dist/cjs/locale/index.js +40 -0
  26. package/dist/cjs/package.json +3 -0
  27. package/dist/cjs/style.css +274 -0
  28. package/dist/cjs/styles.module.css +274 -0
  29. package/dist/cjs/types.d.ts +68 -0
  30. package/dist/cjs/types.js +2 -0
  31. package/dist/esm/Dropdown.d.ts +7 -0
  32. package/dist/esm/Dropdown.js +13 -0
  33. package/dist/esm/constants.d.ts +10 -0
  34. package/dist/esm/constants.js +10 -0
  35. package/dist/esm/helperComponents/DesktopDropdown/DesktopDropdown.d.ts +6 -0
  36. package/dist/esm/helperComponents/DesktopDropdown/DesktopDropdown.js +18 -0
  37. package/dist/esm/helperComponents/DesktopDropdown/index.d.ts +1 -0
  38. package/dist/esm/helperComponents/DesktopDropdown/index.js +1 -0
  39. package/dist/esm/helperComponents/DropdownBody/DropdownBody.d.ts +6 -0
  40. package/dist/esm/helperComponents/DropdownBody/DropdownBody.js +48 -0
  41. package/dist/esm/helperComponents/DropdownBody/index.d.ts +1 -0
  42. package/dist/esm/helperComponents/DropdownBody/index.js +1 -0
  43. package/dist/esm/helperComponents/MobileDropdown/MobileDropdown.d.ts +7 -0
  44. package/dist/esm/helperComponents/MobileDropdown/MobileDropdown.js +35 -0
  45. package/dist/esm/helperComponents/MobileDropdown/index.d.ts +1 -0
  46. package/dist/esm/helperComponents/MobileDropdown/index.js +1 -0
  47. package/dist/esm/helperComponents/index.d.ts +3 -0
  48. package/dist/esm/helperComponents/index.js +3 -0
  49. package/dist/esm/index.d.ts +4 -0
  50. package/dist/esm/index.js +4 -0
  51. package/dist/esm/locale/index.d.ts +71 -0
  52. package/dist/esm/locale/index.js +37 -0
  53. package/dist/esm/style.css +274 -0
  54. package/dist/esm/styles.module.css +274 -0
  55. package/dist/esm/types.d.ts +68 -0
  56. package/dist/esm/types.js +1 -0
  57. package/dist/tsconfig.cjs.tsbuildinfo +1 -0
  58. package/dist/tsconfig.esm.tsbuildinfo +1 -0
  59. package/package.json +60 -0
  60. package/src/Dropdown.tsx +16 -0
  61. package/src/constants.ts +11 -0
  62. package/src/helperComponents/DesktopDropdown/DesktopDropdown.tsx +81 -0
  63. package/src/helperComponents/DesktopDropdown/index.ts +1 -0
  64. package/src/helperComponents/DropdownBody/DropdownBody.tsx +107 -0
  65. package/src/helperComponents/DropdownBody/index.ts +1 -0
  66. package/src/helperComponents/MobileDropdown/MobileDropdown.tsx +91 -0
  67. package/src/helperComponents/MobileDropdown/index.ts +1 -0
  68. package/src/helperComponents/index.ts +3 -0
  69. package/src/index.ts +4 -0
  70. package/src/locale/index.ts +41 -0
  71. package/src/styles.module.scss +92 -0
  72. package/src/types.ts +90 -0
@@ -0,0 +1,91 @@
1
+ import { BottomSheet } from '@cloud-ru/ds-bottom-sheet';
2
+ import { extractSupportProps, useValueControl } from '@cloud-ru/ds-utils';
3
+ import { cloneElement, isValidElement, KeyboardEvent, MouseEvent } from 'react';
4
+
5
+ import { DropdownProps } from '../../types';
6
+ import { DropdownBody } from '../DropdownBody';
7
+
8
+ type TriggerProps = { onClick?(event: MouseEvent<HTMLElement>): void };
9
+
10
+ /**
11
+ * Mobile-поверхность Dropdown'а: контент уезжает в `BottomSheet` из `@cloud-ru/ds-bottom-sheet`.
12
+ * Триггер (`children`) клонируется для открытия sheet'а; `open`/`onOpenChange` поддерживают
13
+ * controlled-режим. Internal — наружу не реэкспортится; рендерится адаптивным `Dropdown` по контексту.
14
+ */
15
+ export function MobileDropdown({
16
+ children,
17
+ content,
18
+ title,
19
+ slotAfterTitle,
20
+ search,
21
+ footer,
22
+ headerDivider,
23
+ footerDivider,
24
+ state,
25
+ bodyPadding,
26
+ className,
27
+ closeOnPopstate,
28
+ snapPoints,
29
+ defaultSnapIndex,
30
+ open: openProp,
31
+ onOpenChange,
32
+ ...rest
33
+ }: DropdownProps) {
34
+ const [open, setOpen] = useValueControl<boolean>({ value: openProp, defaultValue: false, onChange: onOpenChange });
35
+
36
+ const handleOpen = () => setOpen(true);
37
+ const handleClose = () => setOpen(false);
38
+
39
+ let trigger = null;
40
+ if (isValidElement<TriggerProps>(children)) {
41
+ trigger = cloneElement(children, {
42
+ onClick: (event: MouseEvent<HTMLElement>) => {
43
+ children.props.onClick?.(event);
44
+ handleOpen();
45
+ },
46
+ });
47
+ } else if (children != null) {
48
+ trigger = (
49
+ <span
50
+ role='button'
51
+ tabIndex={0}
52
+ onClick={handleOpen}
53
+ onKeyDown={(event: KeyboardEvent<HTMLSpanElement>) => {
54
+ if (event.key === 'Enter' || event.key === ' ') {
55
+ event.preventDefault();
56
+ handleOpen();
57
+ }
58
+ }}
59
+ >
60
+ {children}
61
+ </span>
62
+ );
63
+ }
64
+
65
+ return (
66
+ <>
67
+ {trigger}
68
+ <BottomSheet
69
+ open={open ?? false}
70
+ onClose={handleClose}
71
+ title={title}
72
+ slotAfterTitle={slotAfterTitle}
73
+ slotSecondTitle={search}
74
+ withDividers={Boolean(headerDivider || footerDivider)}
75
+ footer={footer}
76
+ className={className}
77
+ closeOnPopstate={closeOnPopstate}
78
+ bodyPadding={bodyPadding}
79
+ snapPoints={snapPoints}
80
+ defaultSnapIndex={defaultSnapIndex}
81
+ content={
82
+ // Body-инсет даёт BottomSheet — внутренний bodyWrapper его не дублирует.
83
+ <DropdownBody state={state} bodyPadding={false}>
84
+ {content}
85
+ </DropdownBody>
86
+ }
87
+ {...extractSupportProps(rest)}
88
+ />
89
+ </>
90
+ );
91
+ }
@@ -0,0 +1 @@
1
+ export * from './MobileDropdown';
@@ -0,0 +1,3 @@
1
+ export * from './DesktopDropdown';
2
+ export * from './MobileDropdown';
3
+ export * from './DropdownBody';
package/src/index.ts ADDED
@@ -0,0 +1,4 @@
1
+ export * from './constants';
2
+ export * from './Dropdown';
3
+ export * from './types';
4
+ export * from './locale';
@@ -0,0 +1,41 @@
1
+ import { defineLocale, defineMessages } from '@cloud-ru/ds-locale';
2
+
3
+ const DROPDOWN_MESSAGES = defineMessages({
4
+ 'en-GB': {
5
+ states: {
6
+ notFound: {
7
+ title: 'Not Found',
8
+ action: 'Update',
9
+ },
10
+ noData: {
11
+ title: 'No data',
12
+ action: 'Update',
13
+ },
14
+ dataError: {
15
+ title: 'Data error',
16
+ action: 'Update',
17
+ },
18
+ },
19
+ },
20
+ 'ru-RU': {
21
+ states: {
22
+ notFound: {
23
+ title: 'Не найдено',
24
+ action: 'Перезагрузить',
25
+ },
26
+ noData: {
27
+ title: 'Нет данных',
28
+ action: 'Перезагрузить',
29
+ },
30
+ dataError: {
31
+ title: 'Ошибка',
32
+ action: 'Перезагрузить',
33
+ },
34
+ },
35
+ },
36
+ });
37
+
38
+ export type DropdownMessages = (typeof DROPDOWN_MESSAGES)['en-GB'];
39
+
40
+ /** locale компонента Dropdown: `dropdownLocale.useTranslations()` в коде, `dropdownLocale.extend(...)` в сервисе. */
41
+ export const dropdownLocale = defineLocale('@cloud-ru/ds-dropdown', DROPDOWN_MESSAGES);
@@ -0,0 +1,92 @@
1
+ @use '@cloud-ru/ds-figma-variables/build/scss/styles/styles.module' as base;
2
+ @use '@cloud-ru/ds-figma-variables/build/scss/components/dropdown.module' as dropdown;
3
+ @use '@cloud-ru/ds-figma-variables/build/scss/components/popupPrivate.module' as popupPrivate;
4
+ @use '@cloud-ru/ds-figma-variables/build/scss/components/popover.module' as popover;
5
+ @use '@cloud-ru/ds-materials' as m;
6
+
7
+ .acrylic {
8
+ pointer-events: none;
9
+ position: absolute;
10
+ inset: 0;
11
+ border-radius: inherit;
12
+ }
13
+
14
+ .root {
15
+ @include base.composite-var(dropdown.$dropdown, 'anatomy', 'container');
16
+
17
+ position: relative;
18
+
19
+ display: flex;
20
+ flex-direction: column;
21
+
22
+ box-sizing: border-box;
23
+
24
+ box-shadow: base.$sn-boxShadow-elevation-level2;
25
+
26
+ @include m.with-material('acrylic', #{acrylic});
27
+ }
28
+
29
+ .defaultTriggerClassName {
30
+ --offset: #{popover.$sn-popover-anatomy-privatePopover-offset};
31
+ }
32
+
33
+ .infoBlock {
34
+ @include base.composite-var(dropdown.$dropdown, 'anatomy', 'container', 'dropdownInfoBlock');
35
+
36
+ box-sizing: border-box;
37
+ }
38
+
39
+ .loaderWrapper {
40
+ @include base.composite-var(dropdown.$dropdown, 'anatomy', 'container', 'dropdownInfoBlock');
41
+
42
+ display: flex;
43
+ flex-direction: column;
44
+ align-items: center;
45
+ align-self: stretch;
46
+ justify-content: center;
47
+
48
+ box-sizing: border-box;
49
+ }
50
+
51
+ .dropdownContent {
52
+ position: relative;
53
+ }
54
+
55
+ .bodyWrapper {
56
+ box-sizing: border-box;
57
+ padding: base.simple-var(dropdown.$dropdown, 'anatomy', 'container', 'bodyWrapper', 'padding');
58
+ }
59
+
60
+ // padding=false: body без паддинга (список задаёт паддинги айтемов сам).
61
+ .bodyWrapper[data-no-padding] {
62
+ padding: 0;
63
+ }
64
+
65
+ .topBar {
66
+ display: flex;
67
+ flex-direction: column;
68
+ gap: base.simple-var(popupPrivate.$popupPrivate, 'anatomy', 'dropdown', 'header', 'gap');
69
+ }
70
+
71
+ // Горизонтальный паддинг — это паддинг headlineWrapper'а (по имени токена), а не всего topBar.
72
+ // Поэтому держим его здесь: заголовок получает отступ, а слот поиска (прямой ребёнок topBar)
73
+ // растягивается на всю ширину — как айтемы списка (Figma listItemSearch — full-bleed строка).
74
+ .headlineWrapper {
75
+ display: flex;
76
+ gap: base.simple-var(popupPrivate.$popupPrivate, 'anatomy', 'dropdown', 'header', 'headlineWrapper', 'gap');
77
+ align-items: center;
78
+
79
+ box-sizing: border-box;
80
+ padding:
81
+ 0 base.simple-var(popupPrivate.$popupPrivate, 'anatomy', 'dropdown', 'header', 'headlineWrapper', 'padding-right') 0
82
+ base.simple-var(popupPrivate.$popupPrivate, 'anatomy', 'dropdown', 'header', 'headlineWrapper', 'padding-left');
83
+ }
84
+
85
+ .bottomBar {
86
+ box-sizing: border-box;
87
+ padding:
88
+ base.simple-var(popupPrivate.$popupPrivate, 'anatomy', 'dropdown', 'footer', 'padding-top')
89
+ base.simple-var(popupPrivate.$popupPrivate, 'anatomy', 'dropdown', 'footer', 'padding-right')
90
+ base.simple-var(popupPrivate.$popupPrivate, 'anatomy', 'dropdown', 'footer', 'padding-bottom')
91
+ base.simple-var(popupPrivate.$popupPrivate, 'anatomy', 'dropdown', 'footer', 'padding-left');
92
+ }
package/src/types.ts ADDED
@@ -0,0 +1,90 @@
1
+ import { SnapPoint } from '@cloud-ru/ds-bottom-sheet';
2
+ import { InfoBlockProps } from '@cloud-ru/ds-info-block';
3
+ import { PopoverPrivateProps } from '@cloud-ru/ds-popover-private';
4
+ import { WithSupportProps } from '@cloud-ru/ds-utils';
5
+ import { PropsWithChildren, ReactNode } from 'react';
6
+
7
+ import { STATE } from './constants';
8
+
9
+ type ActionButtonProps = {
10
+ /** Лейбл кнопки-действия */
11
+ actionLabel?: string;
12
+ /** Действие при клике по кнопке */
13
+ onActionClick?(): void;
14
+ };
15
+
16
+ type BlockProps = Pick<InfoBlockProps, 'content'>;
17
+ type BlockPropsWithIcon = Pick<InfoBlockProps, 'content' | 'icon'>;
18
+
19
+ export type DropdownState =
20
+ | { type: typeof STATE.Loading }
21
+ | ({ type: typeof STATE.NotFound } & ActionButtonProps & BlockProps)
22
+ | ({ type: typeof STATE.NoData } & ActionButtonProps & BlockPropsWithIcon)
23
+ | ({ type: typeof STATE.DataError } & ActionButtonProps & BlockPropsWithIcon);
24
+
25
+ /**
26
+ * Адаптивный Dropdown: на desktop рендерит popover, на `mobile` (по `AdaptiveProvider`) — `BottomSheet`
27
+ * из `@cloud-ru/ds-bottom-sheet`. Публичный API единый для обеих поверхностей.
28
+ *
29
+ * Только desktop: пропы позиционирования/поведения popover'а ниже работают только на desktop-поверхности
30
+ * и молча игнорируются на mobile (у `BottomSheet` своё позиционирование снизу):
31
+ * `placement`, `widthStrategy`, `offset`, `fallbackPlacements`, `hoverDelayOpen`, `hoverDelayClose`,
32
+ * `closeOnEscapeKey`, `triggerClickByKeys`, `outsideClick`, `disableSpanWrapper`, `triggerClassName`,
33
+ * `triggerRef`, `container` (на mobile портал берётся из `@cloud-ru/ds-portal-context`), `stopPropagation`.
34
+ * Кросс-платформенные: `content`, `title`, `slotAfterTitle`, `search`, `footer`, `headerDivider`,
35
+ * `footerDivider`, `state`, `open`, `onOpenChange`, `closeOnPopstate`, `className`, `bodyPadding`.
36
+ */
37
+ export type DropdownProps = WithSupportProps<
38
+ PropsWithChildren<{
39
+ /** Содержимое внутри поповера (body) */
40
+ content: ReactNode;
41
+ /** Заголовок в шапке (topBar) */
42
+ title?: ReactNode;
43
+ /** Подсказка-иконка рядом с заголовком (потребитель собирает, напр. `<QuestionTooltip />`) */
44
+ slotAfterTitle?: ReactNode;
45
+ /** Слот поиска в шапке (topBar) */
46
+ search?: ReactNode;
47
+ /** Слот футера (bottomBar) */
48
+ footer?: ReactNode;
49
+ /** Divider между шапкой и body */
50
+ headerDivider?: boolean;
51
+ /** Divider между body и футером */
52
+ footerDivider?: boolean;
53
+ /** Состояние */
54
+ state?: DropdownState;
55
+ /** CSS-класс */
56
+ className?: string;
57
+ /**
58
+ * Паддинги body. `false` — убрать (контент во всю ширину; на mobile прокидывается в `BottomSheet`).
59
+ * @default true
60
+ */
61
+ bodyPadding?: boolean;
62
+ /**
63
+ * Только mobile: snap-точки `BottomSheet`'а (высота листа). На desktop игнорируется.
64
+ * @default ['fit-content']
65
+ */
66
+ snapPoints?: SnapPoint[];
67
+ /** Только mobile: индекс snap'а по умолчанию (см. `BottomSheet`). */
68
+ defaultSnapIndex?: number;
69
+ }> &
70
+ Pick<
71
+ PopoverPrivateProps,
72
+ | 'triggerClassName'
73
+ | 'open'
74
+ | 'onOpenChange'
75
+ | 'hoverDelayOpen'
76
+ | 'hoverDelayClose'
77
+ | 'widthStrategy'
78
+ | 'offset'
79
+ | 'closeOnEscapeKey'
80
+ | 'triggerClickByKeys'
81
+ | 'triggerRef'
82
+ | 'outsideClick'
83
+ | 'fallbackPlacements'
84
+ | 'disableSpanWrapper'
85
+ | 'closeOnPopstate'
86
+ | 'container'
87
+ | 'stopPropagation'
88
+ > &
89
+ Partial<Pick<PopoverPrivateProps, 'trigger' | 'placement'>>
90
+ >;