@cloud-ru/ds-list 3.1.6-preview-3a8acaec.0 → 3.2.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 (28) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +5 -1
  3. package/dist/cjs/components/Lists/Droplist/DropList.d.ts +3 -1
  4. package/dist/cjs/components/Lists/Droplist/DropList.js +8 -5
  5. package/dist/cjs/components/Lists/Droplist/useDroplistSearch.d.ts +3 -0
  6. package/dist/cjs/components/Lists/Droplist/useDroplistSearch.js +27 -0
  7. package/dist/cjs/components/Lists/types.d.ts +4 -2
  8. package/dist/cjs/helperComponents/DesktopDroplist/DesktopDroplist.d.ts +1 -1
  9. package/dist/cjs/helperComponents/DesktopDroplist/DesktopDroplist.js +8 -6
  10. package/dist/cjs/helperComponents/MobileDroplist/MobileDroplist.d.ts +1 -1
  11. package/dist/cjs/helperComponents/MobileDroplist/MobileDroplist.js +5 -3
  12. package/dist/esm/components/Lists/Droplist/DropList.d.ts +3 -1
  13. package/dist/esm/components/Lists/Droplist/DropList.js +7 -5
  14. package/dist/esm/components/Lists/Droplist/useDroplistSearch.d.ts +3 -0
  15. package/dist/esm/components/Lists/Droplist/useDroplistSearch.js +24 -0
  16. package/dist/esm/components/Lists/types.d.ts +4 -2
  17. package/dist/esm/helperComponents/DesktopDroplist/DesktopDroplist.d.ts +1 -1
  18. package/dist/esm/helperComponents/DesktopDroplist/DesktopDroplist.js +8 -6
  19. package/dist/esm/helperComponents/MobileDroplist/MobileDroplist.d.ts +1 -1
  20. package/dist/esm/helperComponents/MobileDroplist/MobileDroplist.js +5 -3
  21. package/dist/tsconfig.cjs.tsbuildinfo +1 -1
  22. package/dist/tsconfig.esm.tsbuildinfo +1 -1
  23. package/package.json +18 -18
  24. package/src/components/Lists/Droplist/DropList.tsx +9 -6
  25. package/src/components/Lists/Droplist/useDroplistSearch.ts +39 -0
  26. package/src/components/Lists/types.ts +4 -2
  27. package/src/helperComponents/DesktopDroplist/DesktopDroplist.tsx +11 -7
  28. package/src/helperComponents/MobileDroplist/MobileDroplist.tsx +6 -2
package/CHANGELOG.md CHANGED
@@ -3,6 +3,13 @@
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
+ # 3.2.0 (2026-11-19)
7
+
8
+ ### Features
9
+
10
+ - **FF-9301:** add adaptive list size presets ([565730a](https://github.com/cloud-ru-tech/snack-v2/commit/565730a4812c4255aa5c16e8ec61df51c69e9eb9))
11
+ - **FF-9337:** adapt droplist search to list size ([bc21940](https://github.com/cloud-ru-tech/snack-v2/commit/bc21940e310360380432af900fa8d0173635fa7a))
12
+
6
13
  ## 3.1.5 (2026-11-18)
7
14
 
8
15
  **Note:** Version bump only for package @ds/list
package/README.md CHANGED
@@ -941,6 +941,7 @@ export function DroplistWithHeader() {
941
941
  | Prop | Type | Default | Description |
942
942
  |------|------|---------|-------------|
943
943
  | `actionButton` | `ReactNode` | — | Только mobile (`BottomSheet`): action-кнопка справа в шапке. |
944
+ | `alwaysShowSearch` | `boolean` | — | Показывать включённый поиск при любом количестве пунктов. |
944
945
  | `barHideStrategy` | `"leave"` \| `"move"` \| `"never"` \| `"scroll"` | — | Управление скрытием скролл баров: <br/> <br> - `Never` - показывать всегда <br/> <br> - `Leave` - скрывать когда курсор покидает компонент <br/> <br> - `Scroll` - показывать только когда происходит скроллинг <br/> <br> - `Move` - показывать при движении курсора над компонентом |
945
946
  | `children` | `ReactNode \| ({onKeyDown}) => ReactNode * Рендер функция принимает аргументы `onKeyDown` - хендлер ввода, для поддержки управления с клавиатуры` | — | Триггер для дроплиста |
946
947
  | `className` | `string` | — | CSS-класс |
@@ -963,7 +964,7 @@ export function DroplistWithHeader() {
963
964
  | `itemRender` | `((props: ItemRenderProps) => ReactNode)` | — | Рендер-функция оболочки строки вместо дефолтной разметки `BaseItem`. <br/> Не задана — строка рисуется как раньше. `itemWrapRender` по-прежнему оборачивает результат. |
964
965
  | `items` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `Item` \| `ScrollProps` | — | Основные элементы списка |
965
966
  | `label` | `string` | — | Только mobile (`BottomSheet`): заголовок шапки. |
966
- | `layoutPresets` | `DroplistLayoutDefaults` \| `LayoutPresets` | — | Переопределение размера списка по раскладке. На mobile по умолчанию `l`. |
967
+ | `layoutPresets` | `DroplistLayoutDefaults` \| `LayoutPresets` | — | Переопределение размера списка и видимости поиска по раскладке. На mobile по умолчанию `l`. |
967
968
  | `limitedScrollHeight` | `boolean` | — | Ограничить максимальную высоту скролл-контейнера в зависимости от `size` |
968
969
  | `listRef` | `RefObject<HTMLElement>` | — | Ссылка на элемент выпадающего списка |
969
970
  | `loading` | `boolean` | — | Флаг, отвечающий за состояние загрузки списка |
@@ -1045,6 +1046,7 @@ export function DroplistWithHeader() {
1045
1046
 
1046
1047
  | Prop | Type | Default | Description |
1047
1048
  |------|------|---------|-------------|
1049
+ | `alwaysShowSearch` | `boolean \| undefined` | — | Показывать включённый поиск при любом количестве пунктов. |
1048
1050
  | `size` | `"l"` \| `"m"` \| `"s"` | — | Размер списка |
1049
1051
 
1050
1052
  **EmptyStateProps**
@@ -1207,6 +1209,8 @@ export function DroplistWithHeader() {
1207
1209
  | `open`, `onOpenChange`, `closeOnPopstate` | используется | используется |
1208
1210
  | `size`, `layoutPresets` | размер определяется с учётом пресетов | размер определяется с учётом пресетов |
1209
1211
 
1212
+ На desktop поиск по умолчанию виден при любом количестве пунктов (`alwaysShowSearch` равен `true`). На мобильных устройствах поиск появляется при 10 и более пунктах, включая вложенные и закреплённые. При фильтрации поле остаётся доступным до закрытия списка. Для серверного поиска задайте `layoutPresets={{ mobile: { alwaysShowSearch: true } }}`, чтобы можно было ввести запрос даже при пустом списке.
1213
+
1210
1214
  #### Mobile — BottomSheet
1211
1215
 
1212
1216
  Раскладка форсирована в mobile: по клику триггера список открывается в BottomSheet.
@@ -1,4 +1,6 @@
1
- import { DroplistProps, ReorderableDroplistProps } from '../types';
1
+ import { LayoutPresets } from '@cloud-ru/ds-adaptive';
2
+ import { DroplistLayoutDefaults, DroplistProps, ReorderableDroplistProps } from '../types';
3
+ export declare const DROPLIST_LAYOUT_PRESETS: LayoutPresets<DroplistLayoutDefaults>;
2
4
  /**
3
5
  * Адаптивный `Droplist`: раскладку берёт из `AdaptiveProvider` (контекст). На `mobile` рендерит
4
6
  * список (по умолчанию размера `l`) в `BottomSheet` (`MobileDroplist`), иначе — анкорный popover (`DesktopDroplist`).
@@ -1,20 +1,23 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DROPLIST_LAYOUT_PRESETS = void 0;
3
4
  exports.Droplist = Droplist;
4
5
  exports.ReorderableDroplist = ReorderableDroplist;
5
6
  const jsx_runtime_1 = require("react/jsx-runtime");
6
7
  const adaptive_1 = require("@cloud-ru/ds-adaptive");
7
8
  const DesktopDroplist_1 = require("../../../helperComponents/DesktopDroplist");
8
9
  const MobileDroplist_1 = require("../../../helperComponents/MobileDroplist");
9
- const DROPLIST_LAYOUT_PRESETS = { mobile: { size: 'l' } };
10
+ exports.DROPLIST_LAYOUT_PRESETS = {
11
+ mobile: { size: 'l', alwaysShowSearch: false },
12
+ };
10
13
  /** @internal Общая реализация `Droplist`/`ReorderableDroplist`: свап поверхности по раскладке. */
11
- function DroplistImpl({ children, size, layoutPresets, label, actionButton, slotAfterTitle, onBackButtonClick, ...rest }) {
14
+ function DroplistImpl({ children, alwaysShowSearch, size, layoutPresets, label, actionButton, slotAfterTitle, onBackButtonClick, ...rest }) {
12
15
  const { layoutType } = (0, adaptive_1.useAdaptiveLayout)();
13
- const { size: resolvedSize } = (0, adaptive_1.useLayoutDefaults)({ size: 'm' }, (0, adaptive_1.mergePresets)(DROPLIST_LAYOUT_PRESETS, layoutPresets), { size });
16
+ const resolvedProps = (0, adaptive_1.useLayoutDefaults)({ size: 'm', alwaysShowSearch: true }, (0, adaptive_1.mergePresets)(exports.DROPLIST_LAYOUT_PRESETS, layoutPresets), { size, alwaysShowSearch });
14
17
  if ((0, adaptive_1.isMobileLayout)(layoutType)) {
15
- return ((0, jsx_runtime_1.jsx)(MobileDroplist_1.MobileDroplist, { ...rest, size: resolvedSize, label: label, actionButton: actionButton, slotAfterTitle: slotAfterTitle, onBackButtonClick: onBackButtonClick, children: children }));
18
+ return ((0, jsx_runtime_1.jsx)(MobileDroplist_1.MobileDroplist, { ...rest, ...resolvedProps, label: label, actionButton: actionButton, slotAfterTitle: slotAfterTitle, onBackButtonClick: onBackButtonClick, children: children }));
16
19
  }
17
- return ((0, jsx_runtime_1.jsx)(DesktopDroplist_1.DesktopDroplist, { ...rest, size: resolvedSize, children: children }));
20
+ return ((0, jsx_runtime_1.jsx)(DesktopDroplist_1.DesktopDroplist, { ...rest, ...resolvedProps, children: children }));
18
21
  }
19
22
  /**
20
23
  * Адаптивный `Droplist`: раскладку берёт из `AdaptiveProvider` (контекст). На `mobile` рендерит
@@ -0,0 +1,3 @@
1
+ import { SearchState } from '../../../types';
2
+ import { Item } from '../../Items';
3
+ export declare function useDroplistSearch(search: SearchState | undefined, alwaysShowSearch: boolean | undefined, open: boolean, items: Item[], pinTop?: Item[], pinBottom?: Item[]): SearchState | undefined;
@@ -0,0 +1,27 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.useDroplistSearch = useDroplistSearch;
4
+ const react_1 = require("react");
5
+ const MIN_SEARCH_OPTIONS = 10;
6
+ function countSearchOptions(items = []) {
7
+ return items.reduce((count, item) => {
8
+ if (item.hidden)
9
+ return count;
10
+ return count + ('items' in item ? countSearchOptions(item.items) : 1);
11
+ }, 0);
12
+ }
13
+ function useDroplistSearch(search, alwaysShowSearch, open, items, pinTop, pinBottom) {
14
+ const enabled = Boolean(search);
15
+ const eligible = (0, react_1.useMemo)(() => enabled &&
16
+ (alwaysShowSearch ||
17
+ countSearchOptions(items) + countSearchOptions(pinTop) + countSearchOptions(pinBottom) >= MIN_SEARCH_OPTIONS), [enabled, alwaysShowSearch, items, pinTop, pinBottom]);
18
+ // Сохраняем поле до закрытия списка, даже когда фильтрация оставила ноль совпадений.
19
+ const [keepSearchOpen, setKeepSearchOpen] = (0, react_1.useState)(false);
20
+ (0, react_1.useEffect)(() => {
21
+ if (!open || !enabled)
22
+ setKeepSearchOpen(false);
23
+ else if (eligible)
24
+ setKeepSearchOpen(true);
25
+ }, [open, enabled, eligible]);
26
+ return eligible || keepSearchOpen || search?.value ? search : undefined;
27
+ }
@@ -109,6 +109,8 @@ export type ListImplProps = ListPropsCommon & {
109
109
  };
110
110
  /** Собственные props дроплиста — всё, что не приходит из `List`. */
111
111
  type DroplistOwnProps = {
112
+ /** Показывать включённый поиск при любом количестве пунктов. */
113
+ alwaysShowSearch?: boolean;
112
114
  /** Ссылка на элемент-триггер для дроплиста */
113
115
  triggerElemRef?: RefObject<HTMLElement>;
114
116
  /**
@@ -146,9 +148,9 @@ export type ReorderableBaseDroplistProps = DroplistOwnProps & DroplistListProps<
146
148
  * модели айтемов. Публичные `DroplistProps`/`ReorderableDroplistProps` плоские, см. `ListImplProps`.
147
149
  */
148
150
  export type DesktopDroplistProps = DroplistOwnProps & DroplistListProps<ListImplProps>;
149
- export type DroplistLayoutDefaults = Pick<ListProps, 'size'>;
151
+ export type DroplistLayoutDefaults = Pick<BaseDroplistProps, 'size' | 'alwaysShowSearch'>;
150
152
  type DroplistAdaptiveProps = {
151
- /** Переопределение размера списка по раскладке. На mobile по умолчанию `l`. */
153
+ /** Переопределение размера списка и видимости поиска по раскладке. На mobile по умолчанию `l`. */
152
154
  layoutPresets?: LayoutPresets<DroplistLayoutDefaults>;
153
155
  };
154
156
  /** Только mobile (`BottomSheet`)-слоты адаптивного `Droplist`. */
@@ -4,4 +4,4 @@ import { DesktopDroplistProps } from '../../components/Lists/types';
4
4
  * не реэкспортится; рендерится адаптивным `Droplist` на не-mobile раскладке. Так как вызывается
5
5
  * только на desktop-раскладке, внутренний адаптивный `Dropdown` всегда рендерит popover.
6
6
  */
7
- export declare function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp, pinTop: pinTopProp, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse, triggerClassName, disableSpanWrapper, selection, contentRender, itemRender, groupItemRender, size, marker, closeDroplistOnItemClick, className, listRef: listRefProp, untouchableScrollbars, virtualized, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }: DesktopDroplistProps): import("react/jsx-runtime").JSX.Element;
7
+ export declare function DesktopDroplist({ items: itemsProp, search: searchProp, pinBottom: pinBottomProp, pinTop: pinTopProp, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, alwaysShowSearch, open: openProp, onOpenChange, collapse, triggerClassName, disableSpanWrapper, selection, contentRender, itemRender, groupItemRender, size, marker, closeDroplistOnItemClick, className, listRef: listRefProp, untouchableScrollbars, virtualized, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }: DesktopDroplistProps): import("react/jsx-runtime").JSX.Element;
@@ -13,6 +13,7 @@ const react_1 = require("react");
13
13
  const Items_1 = require("../../components/Items");
14
14
  const contexts_1 = require("../../components/Lists/contexts");
15
15
  const constants_1 = require("../../components/Lists/Droplist/constants");
16
+ const useDroplistSearch_1 = require("../../components/Lists/Droplist/useDroplistSearch");
16
17
  const hooks_1 = require("../../components/Lists/hooks");
17
18
  const ListPrivate_1 = require("../../components/Lists/ListPrivate");
18
19
  const styles_module_scss_1 = __importDefault(require('../../components/Lists/styles.module.css'));
@@ -22,7 +23,13 @@ const NO_ITEMS = [];
22
23
  * не реэкспортится; рендерится адаптивным `Droplist` на не-mobile раскладке. Так как вызывается
23
24
  * только на desktop-раскладке, внутренний адаптивный `Dropdown` всегда рендерит popover.
24
25
  */
25
- function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp = NO_ITEMS, pinTop: pinTopProp = NO_ITEMS, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse = {}, triggerClassName, disableSpanWrapper, selection, contentRender, itemRender, groupItemRender, size = constants_1.DEFAULT_SIZE, marker = true, closeDroplistOnItemClick = false, className, listRef: listRefProp, untouchableScrollbars = false, virtualized = false, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }) {
26
+ function DesktopDroplist({ items: itemsProp, search: searchProp, pinBottom: pinBottomProp = NO_ITEMS, pinTop: pinTopProp = NO_ITEMS, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, alwaysShowSearch, open: openProp, onOpenChange, collapse = {}, triggerClassName, disableSpanWrapper, selection, contentRender, itemRender, groupItemRender, size = constants_1.DEFAULT_SIZE, marker = true, closeDroplistOnItemClick = false, className, listRef: listRefProp, untouchableScrollbars = false, virtualized = false, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }) {
27
+ const [open = false, setOpen] = (0, utils_1.useValueControl)({
28
+ value: openProp,
29
+ defaultValue: false,
30
+ onChange: onOpenChange,
31
+ });
32
+ const search = (0, useDroplistSearch_1.useDroplistSearch)(searchProp, alwaysShowSearch, open, itemsProp, pinTopProp, pinBottomProp);
26
33
  const { hasSearch, openCollapseItems, toggleOpenCollapseItem, searchItem, flattenItems, focusFlattenItems, memorizedItems, ids, expandedIds, firstItemId, onDragEnd, sortableIds, } = (0, hooks_1.useListItemsModel)({
27
34
  items: itemsProp,
28
35
  pinTop: pinTopProp,
@@ -33,11 +40,6 @@ function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp =
33
40
  footerActiveElementsRefs,
34
41
  onItemsReorder,
35
42
  });
36
- const [open = false, setOpen] = (0, utils_1.useValueControl)({
37
- value: openProp,
38
- defaultValue: false,
39
- onChange: onOpenChange,
40
- });
41
43
  const triggerElemRef = (0, react_1.useRef)(null);
42
44
  const listRef = (0, react_1.useRef)(null);
43
45
  const { handleListKeyDownFactory, resetActiveItemId, activeItemId, forceUpdateActiveItemId } = (0, hooks_1.useNewKeyboardNavigation)({
@@ -6,4 +6,4 @@ import { MobileDroplistProps } from '../../components/Lists/types';
6
6
  * вложенного списка, в шапке появляется его заголовок и кнопка «назад». Internal — наружу не реэкспортится;
7
7
  * рендерится адаптивным `Droplist` на `layoutType='mobile'`.
8
8
  */
9
- export declare function MobileDroplist({ items, selection, open: openProp, onOpenChange, children, search, label, actionButton, slotAfterTitle, onBackButtonClick, virtualized, closeDroplistOnItemClick, scroll, container, closeOnPopstate, size, snapPoints, footer, onItemsReorder, withDividers, listRef, ...rest }: MobileDroplistProps): import("react/jsx-runtime").JSX.Element;
9
+ export declare function MobileDroplist({ items, selection, alwaysShowSearch, open: openProp, onOpenChange, children, search, label, actionButton, slotAfterTitle, onBackButtonClick, virtualized, closeDroplistOnItemClick, scroll, container, closeOnPopstate, size, snapPoints, footer, onItemsReorder, withDividers, listRef, ...rest }: MobileDroplistProps): import("react/jsx-runtime").JSX.Element;
@@ -9,6 +9,7 @@ const bottom_sheet_1 = require("@cloud-ru/ds-bottom-sheet");
9
9
  const portal_context_1 = require("@cloud-ru/ds-portal-context");
10
10
  const utils_1 = require("@cloud-ru/ds-utils");
11
11
  const react_1 = require("react");
12
+ const useDroplistSearch_1 = require("../../components/Lists/Droplist/useDroplistSearch");
12
13
  const List_1 = require("../../components/Lists/List");
13
14
  const constants_1 = require("../../constants");
14
15
  const MobileDroplist_module_scss_1 = __importDefault(require('./MobileDroplist.module.css'));
@@ -20,7 +21,7 @@ const utils_2 = require("./utils");
20
21
  * вложенного списка, в шапке появляется его заголовок и кнопка «назад». Internal — наружу не реэкспортится;
21
22
  * рендерится адаптивным `Droplist` на `layoutType='mobile'`.
22
23
  */
23
- function MobileDroplist({ items, selection, open: openProp, onOpenChange, children, search, label, actionButton, slotAfterTitle, onBackButtonClick, virtualized, closeDroplistOnItemClick, scroll, container, closeOnPopstate, size, snapPoints,
24
+ function MobileDroplist({ items, selection, alwaysShowSearch, open: openProp, onOpenChange, children, search, label, actionButton, slotAfterTitle, onBackButtonClick, virtualized, closeDroplistOnItemClick, scroll, container, closeOnPopstate, size, snapPoints,
24
25
  // `footer` уводим в sticky-футер `BottomSheet` (кнопки действия прилипают к низу sheet'а, а не
25
26
  // скроллятся вместе со списком). `header` + `headerDivider` / `footerDivider` НЕ деструктурируем —
26
27
  // они уходят в `...rest` на корневой `List` (он рендерит шапку и её divider).
@@ -29,6 +30,7 @@ footer, onItemsReorder, withDividers, listRef, ...rest }) {
29
30
  const portalContext = (0, portal_context_1.usePortalContext)();
30
31
  const scrollRef = (0, react_1.useRef)(null);
31
32
  const [open = false, setIsOpen] = (0, utils_1.useValueControl)({ value: openProp, onChange: onOpenChange });
33
+ const visibleSearch = (0, useDroplistSearch_1.useDroplistSearch)(search, alwaysShowSearch, open, items, rest.pinTop, rest.pinBottom);
32
34
  // Стек заходов во вложенные next-list'ы: индексный путь от корня на каждый уровень.
33
35
  // Пустой — корневой уровень. Хранится путь, а не сам айтем: айтемы пересобираются на каждом
34
36
  // рендере, и сохранённая копия оставила бы открытый sheet в устаревшем состоянии.
@@ -107,13 +109,13 @@ footer, onItemsReorder, withDividers, listRef, ...rest }) {
107
109
  ? undefined
108
110
  : (0, utils_2.buildLevelItems)(source, relativePath => setPath(prev => [...prev.slice(0, levelIndex), [...(prev[levelIndex - 1] ?? []), ...relativePath]]), handleClose, closeOnClick);
109
111
  // Поиск/виртуализация/footer/actions — только на корне; sublists всегда статичны по контенту.
110
- const searchable = isRoot && Boolean(search);
112
+ const searchable = isRoot && Boolean(visibleSearch);
111
113
  const expanded = searchable || (isRoot && virtualized);
112
114
  const scrollable = isRoot && (virtualized || scroll);
113
115
  const listCommonProps = {
114
116
  selection: listSelection,
115
117
  size,
116
- search: searchable ? search : undefined,
118
+ search: isRoot ? visibleSearch : undefined,
117
119
  loading: isRoot ? undefined : item?.loading,
118
120
  dataError: isRoot ? undefined : item?.dataError,
119
121
  dataFiltered: isRoot ? undefined : item?.dataFiltered,
@@ -1,4 +1,6 @@
1
- import { DroplistProps, ReorderableDroplistProps } from '../types.js';
1
+ import { LayoutPresets } from '@cloud-ru/ds-adaptive';
2
+ import { DroplistLayoutDefaults, DroplistProps, ReorderableDroplistProps } from '../types.js';
3
+ export declare const DROPLIST_LAYOUT_PRESETS: LayoutPresets<DroplistLayoutDefaults>;
2
4
  /**
3
5
  * Адаптивный `Droplist`: раскладку берёт из `AdaptiveProvider` (контекст). На `mobile` рендерит
4
6
  * список (по умолчанию размера `l`) в `BottomSheet` (`MobileDroplist`), иначе — анкорный popover (`DesktopDroplist`).
@@ -2,15 +2,17 @@ import { jsx as _jsx } from "react/jsx-runtime";
2
2
  import { isMobileLayout, mergePresets, useAdaptiveLayout, useLayoutDefaults } from '@cloud-ru/ds-adaptive';
3
3
  import { DesktopDroplist } from '../../../helperComponents/DesktopDroplist/index.js';
4
4
  import { MobileDroplist } from '../../../helperComponents/MobileDroplist/index.js';
5
- const DROPLIST_LAYOUT_PRESETS = { mobile: { size: 'l' } };
5
+ export const DROPLIST_LAYOUT_PRESETS = {
6
+ mobile: { size: 'l', alwaysShowSearch: false },
7
+ };
6
8
  /** @internal Общая реализация `Droplist`/`ReorderableDroplist`: свап поверхности по раскладке. */
7
- function DroplistImpl({ children, size, layoutPresets, label, actionButton, slotAfterTitle, onBackButtonClick, ...rest }) {
9
+ function DroplistImpl({ children, alwaysShowSearch, size, layoutPresets, label, actionButton, slotAfterTitle, onBackButtonClick, ...rest }) {
8
10
  const { layoutType } = useAdaptiveLayout();
9
- const { size: resolvedSize } = useLayoutDefaults({ size: 'm' }, mergePresets(DROPLIST_LAYOUT_PRESETS, layoutPresets), { size });
11
+ const resolvedProps = useLayoutDefaults({ size: 'm', alwaysShowSearch: true }, mergePresets(DROPLIST_LAYOUT_PRESETS, layoutPresets), { size, alwaysShowSearch });
10
12
  if (isMobileLayout(layoutType)) {
11
- return (_jsx(MobileDroplist, { ...rest, size: resolvedSize, label: label, actionButton: actionButton, slotAfterTitle: slotAfterTitle, onBackButtonClick: onBackButtonClick, children: children }));
13
+ return (_jsx(MobileDroplist, { ...rest, ...resolvedProps, label: label, actionButton: actionButton, slotAfterTitle: slotAfterTitle, onBackButtonClick: onBackButtonClick, children: children }));
12
14
  }
13
- return (_jsx(DesktopDroplist, { ...rest, size: resolvedSize, children: children }));
15
+ return (_jsx(DesktopDroplist, { ...rest, ...resolvedProps, children: children }));
14
16
  }
15
17
  /**
16
18
  * Адаптивный `Droplist`: раскладку берёт из `AdaptiveProvider` (контекст). На `mobile` рендерит
@@ -0,0 +1,3 @@
1
+ import { SearchState } from '../../../types.js';
2
+ import { Item } from '../../Items/index.js';
3
+ export declare function useDroplistSearch(search: SearchState | undefined, alwaysShowSearch: boolean | undefined, open: boolean, items: Item[], pinTop?: Item[], pinBottom?: Item[]): SearchState | undefined;
@@ -0,0 +1,24 @@
1
+ import { useEffect, useMemo, useState } from 'react';
2
+ const MIN_SEARCH_OPTIONS = 10;
3
+ function countSearchOptions(items = []) {
4
+ return items.reduce((count, item) => {
5
+ if (item.hidden)
6
+ return count;
7
+ return count + ('items' in item ? countSearchOptions(item.items) : 1);
8
+ }, 0);
9
+ }
10
+ export function useDroplistSearch(search, alwaysShowSearch, open, items, pinTop, pinBottom) {
11
+ const enabled = Boolean(search);
12
+ const eligible = useMemo(() => enabled &&
13
+ (alwaysShowSearch ||
14
+ countSearchOptions(items) + countSearchOptions(pinTop) + countSearchOptions(pinBottom) >= MIN_SEARCH_OPTIONS), [enabled, alwaysShowSearch, items, pinTop, pinBottom]);
15
+ // Сохраняем поле до закрытия списка, даже когда фильтрация оставила ноль совпадений.
16
+ const [keepSearchOpen, setKeepSearchOpen] = useState(false);
17
+ useEffect(() => {
18
+ if (!open || !enabled)
19
+ setKeepSearchOpen(false);
20
+ else if (eligible)
21
+ setKeepSearchOpen(true);
22
+ }, [open, enabled, eligible]);
23
+ return eligible || keepSearchOpen || search?.value ? search : undefined;
24
+ }
@@ -109,6 +109,8 @@ export type ListImplProps = ListPropsCommon & {
109
109
  };
110
110
  /** Собственные props дроплиста — всё, что не приходит из `List`. */
111
111
  type DroplistOwnProps = {
112
+ /** Показывать включённый поиск при любом количестве пунктов. */
113
+ alwaysShowSearch?: boolean;
112
114
  /** Ссылка на элемент-триггер для дроплиста */
113
115
  triggerElemRef?: RefObject<HTMLElement>;
114
116
  /**
@@ -146,9 +148,9 @@ export type ReorderableBaseDroplistProps = DroplistOwnProps & DroplistListProps<
146
148
  * модели айтемов. Публичные `DroplistProps`/`ReorderableDroplistProps` плоские, см. `ListImplProps`.
147
149
  */
148
150
  export type DesktopDroplistProps = DroplistOwnProps & DroplistListProps<ListImplProps>;
149
- export type DroplistLayoutDefaults = Pick<ListProps, 'size'>;
151
+ export type DroplistLayoutDefaults = Pick<BaseDroplistProps, 'size' | 'alwaysShowSearch'>;
150
152
  type DroplistAdaptiveProps = {
151
- /** Переопределение размера списка по раскладке. На mobile по умолчанию `l`. */
153
+ /** Переопределение размера списка и видимости поиска по раскладке. На mobile по умолчанию `l`. */
152
154
  layoutPresets?: LayoutPresets<DroplistLayoutDefaults>;
153
155
  };
154
156
  /** Только mobile (`BottomSheet`)-слоты адаптивного `Droplist`. */
@@ -4,4 +4,4 @@ import { DesktopDroplistProps } from '../../components/Lists/types.js';
4
4
  * не реэкспортится; рендерится адаптивным `Droplist` на не-mobile раскладке. Так как вызывается
5
5
  * только на desktop-раскладке, внутренний адаптивный `Dropdown` всегда рендерит popover.
6
6
  */
7
- export declare function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp, pinTop: pinTopProp, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse, triggerClassName, disableSpanWrapper, selection, contentRender, itemRender, groupItemRender, size, marker, closeDroplistOnItemClick, className, listRef: listRefProp, untouchableScrollbars, virtualized, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }: DesktopDroplistProps): import("react/jsx-runtime").JSX.Element;
7
+ export declare function DesktopDroplist({ items: itemsProp, search: searchProp, pinBottom: pinBottomProp, pinTop: pinTopProp, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, alwaysShowSearch, open: openProp, onOpenChange, collapse, triggerClassName, disableSpanWrapper, selection, contentRender, itemRender, groupItemRender, size, marker, closeDroplistOnItemClick, className, listRef: listRefProp, untouchableScrollbars, virtualized, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }: DesktopDroplistProps): import("react/jsx-runtime").JSX.Element;
@@ -7,6 +7,7 @@ import { cloneElement, isValidElement, useCallback, useEffect, useMemo, useRef }
7
7
  import { SearchItem } from '../../components/Items/index.js';
8
8
  import { CollapseContext, FocusListContext, NewListContextProvider, OpenListContext, SelectionProvider, } from '../../components/Lists/contexts/index.js';
9
9
  import { DEFAULT_FALLBACK_PLACEMENTS, DEFAULT_SIZE, FOCUS_DEFERRAL_TIMEOUT, } from '../../components/Lists/Droplist/constants.js';
10
+ import { useDroplistSearch } from '../../components/Lists/Droplist/useDroplistSearch.js';
10
11
  import { useListItemsModel, useNewKeyboardNavigation } from '../../components/Lists/hooks.js';
11
12
  import { ListPrivate } from '../../components/Lists/ListPrivate/index.js';
12
13
  import styles from '../../components/Lists/styles.module.css';
@@ -16,7 +17,13 @@ const NO_ITEMS = [];
16
17
  * не реэкспортится; рендерится адаптивным `Droplist` на не-mobile раскладке. Так как вызывается
17
18
  * только на desktop-раскладке, внутренний адаптивный `Dropdown` всегда рендерит popover.
18
19
  */
19
- export function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp = NO_ITEMS, pinTop: pinTopProp = NO_ITEMS, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse = {}, triggerClassName, disableSpanWrapper, selection, contentRender, itemRender, groupItemRender, size = DEFAULT_SIZE, marker = true, closeDroplistOnItemClick = false, className, listRef: listRefProp, untouchableScrollbars = false, virtualized = false, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }) {
20
+ export function DesktopDroplist({ items: itemsProp, search: searchProp, pinBottom: pinBottomProp = NO_ITEMS, pinTop: pinTopProp = NO_ITEMS, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, alwaysShowSearch, open: openProp, onOpenChange, collapse = {}, triggerClassName, disableSpanWrapper, selection, contentRender, itemRender, groupItemRender, size = DEFAULT_SIZE, marker = true, closeDroplistOnItemClick = false, className, listRef: listRefProp, untouchableScrollbars = false, virtualized = false, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }) {
21
+ const [open = false, setOpen] = useValueControl({
22
+ value: openProp,
23
+ defaultValue: false,
24
+ onChange: onOpenChange,
25
+ });
26
+ const search = useDroplistSearch(searchProp, alwaysShowSearch, open, itemsProp, pinTopProp, pinBottomProp);
20
27
  const { hasSearch, openCollapseItems, toggleOpenCollapseItem, searchItem, flattenItems, focusFlattenItems, memorizedItems, ids, expandedIds, firstItemId, onDragEnd, sortableIds, } = useListItemsModel({
21
28
  items: itemsProp,
22
29
  pinTop: pinTopProp,
@@ -27,11 +34,6 @@ export function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottom
27
34
  footerActiveElementsRefs,
28
35
  onItemsReorder,
29
36
  });
30
- const [open = false, setOpen] = useValueControl({
31
- value: openProp,
32
- defaultValue: false,
33
- onChange: onOpenChange,
34
- });
35
37
  const triggerElemRef = useRef(null);
36
38
  const listRef = useRef(null);
37
39
  const { handleListKeyDownFactory, resetActiveItemId, activeItemId, forceUpdateActiveItemId } = useNewKeyboardNavigation({
@@ -6,4 +6,4 @@ import { MobileDroplistProps } from '../../components/Lists/types.js';
6
6
  * вложенного списка, в шапке появляется его заголовок и кнопка «назад». Internal — наружу не реэкспортится;
7
7
  * рендерится адаптивным `Droplist` на `layoutType='mobile'`.
8
8
  */
9
- export declare function MobileDroplist({ items, selection, open: openProp, onOpenChange, children, search, label, actionButton, slotAfterTitle, onBackButtonClick, virtualized, closeDroplistOnItemClick, scroll, container, closeOnPopstate, size, snapPoints, footer, onItemsReorder, withDividers, listRef, ...rest }: MobileDroplistProps): import("react/jsx-runtime").JSX.Element;
9
+ export declare function MobileDroplist({ items, selection, alwaysShowSearch, open: openProp, onOpenChange, children, search, label, actionButton, slotAfterTitle, onBackButtonClick, virtualized, closeDroplistOnItemClick, scroll, container, closeOnPopstate, size, snapPoints, footer, onItemsReorder, withDividers, listRef, ...rest }: MobileDroplistProps): import("react/jsx-runtime").JSX.Element;
@@ -3,6 +3,7 @@ import { BottomSheet, SNAP_POINTS_PRESET } from '@cloud-ru/ds-bottom-sheet';
3
3
  import { usePortalContext } from '@cloud-ru/ds-portal-context';
4
4
  import { useValueControl } from '@cloud-ru/ds-utils';
5
5
  import { cloneElement, isValidElement, useMemo, useRef, useState } from 'react';
6
+ import { useDroplistSearch } from '../../components/Lists/Droplist/useDroplistSearch.js';
6
7
  import { List, ReorderableList } from '../../components/Lists/List/index.js';
7
8
  import { TEST_IDS } from '../../constants.js';
8
9
  import styles from './MobileDroplist.module.css';
@@ -14,7 +15,7 @@ import { buildLevelItems, nextListOption, resolveItemByPath } from './utils.js';
14
15
  * вложенного списка, в шапке появляется его заголовок и кнопка «назад». Internal — наружу не реэкспортится;
15
16
  * рендерится адаптивным `Droplist` на `layoutType='mobile'`.
16
17
  */
17
- export function MobileDroplist({ items, selection, open: openProp, onOpenChange, children, search, label, actionButton, slotAfterTitle, onBackButtonClick, virtualized, closeDroplistOnItemClick, scroll, container, closeOnPopstate, size, snapPoints,
18
+ export function MobileDroplist({ items, selection, alwaysShowSearch, open: openProp, onOpenChange, children, search, label, actionButton, slotAfterTitle, onBackButtonClick, virtualized, closeDroplistOnItemClick, scroll, container, closeOnPopstate, size, snapPoints,
18
19
  // `footer` уводим в sticky-футер `BottomSheet` (кнопки действия прилипают к низу sheet'а, а не
19
20
  // скроллятся вместе со списком). `header` + `headerDivider` / `footerDivider` НЕ деструктурируем —
20
21
  // они уходят в `...rest` на корневой `List` (он рендерит шапку и её divider).
@@ -23,6 +24,7 @@ footer, onItemsReorder, withDividers, listRef, ...rest }) {
23
24
  const portalContext = usePortalContext();
24
25
  const scrollRef = useRef(null);
25
26
  const [open = false, setIsOpen] = useValueControl({ value: openProp, onChange: onOpenChange });
27
+ const visibleSearch = useDroplistSearch(search, alwaysShowSearch, open, items, rest.pinTop, rest.pinBottom);
26
28
  // Стек заходов во вложенные next-list'ы: индексный путь от корня на каждый уровень.
27
29
  // Пустой — корневой уровень. Хранится путь, а не сам айтем: айтемы пересобираются на каждом
28
30
  // рендере, и сохранённая копия оставила бы открытый sheet в устаревшем состоянии.
@@ -101,13 +103,13 @@ footer, onItemsReorder, withDividers, listRef, ...rest }) {
101
103
  ? undefined
102
104
  : buildLevelItems(source, relativePath => setPath(prev => [...prev.slice(0, levelIndex), [...(prev[levelIndex - 1] ?? []), ...relativePath]]), handleClose, closeOnClick);
103
105
  // Поиск/виртуализация/footer/actions — только на корне; sublists всегда статичны по контенту.
104
- const searchable = isRoot && Boolean(search);
106
+ const searchable = isRoot && Boolean(visibleSearch);
105
107
  const expanded = searchable || (isRoot && virtualized);
106
108
  const scrollable = isRoot && (virtualized || scroll);
107
109
  const listCommonProps = {
108
110
  selection: listSelection,
109
111
  size,
110
- search: searchable ? search : undefined,
112
+ search: isRoot ? visibleSearch : undefined,
111
113
  loading: isRoot ? undefined : item?.loading,
112
114
  dataError: isRoot ? undefined : item?.dataError,
113
115
  dataFiltered: isRoot ? undefined : item?.dataFiltered,