@cloud-ru/ds-list 2.3.5 → 2.3.7-preview-d9442369.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 (32) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/README.md +6 -0
  3. package/dist/cjs/components/Items/BaseItem/BaseItem.js +59 -8
  4. package/dist/cjs/components/Items/BaseItem/styles.module.css +9 -9
  5. package/dist/cjs/components/Lists/List/List.js +2 -2
  6. package/dist/cjs/components/Lists/contexts/NewListProvider.d.ts +87 -4
  7. package/dist/cjs/components/Lists/contexts/NewListProvider.js +34 -4
  8. package/dist/cjs/helperComponents/DesktopDroplist/DesktopDroplist.d.ts +1 -1
  9. package/dist/cjs/helperComponents/DesktopDroplist/DesktopDroplist.js +2 -2
  10. package/dist/cjs/helperComponents/MobileDroplist/MobileDroplist.js +5 -0
  11. package/dist/cjs/helperComponents/Separator/Separator.js +14 -1
  12. package/dist/cjs/style.css +9 -9
  13. package/dist/esm/components/Items/BaseItem/BaseItem.js +60 -9
  14. package/dist/esm/components/Items/BaseItem/styles.module.css +9 -9
  15. package/dist/esm/components/Lists/List/List.js +2 -2
  16. package/dist/esm/components/Lists/contexts/NewListProvider.d.ts +87 -4
  17. package/dist/esm/components/Lists/contexts/NewListProvider.js +35 -5
  18. package/dist/esm/helperComponents/DesktopDroplist/DesktopDroplist.d.ts +1 -1
  19. package/dist/esm/helperComponents/DesktopDroplist/DesktopDroplist.js +2 -2
  20. package/dist/esm/helperComponents/MobileDroplist/MobileDroplist.js +5 -0
  21. package/dist/esm/helperComponents/Separator/Separator.js +15 -2
  22. package/dist/esm/style.css +9 -9
  23. package/dist/tsconfig.cjs.tsbuildinfo +1 -1
  24. package/dist/tsconfig.esm.tsbuildinfo +1 -1
  25. package/package.json +18 -18
  26. package/src/components/Items/BaseItem/BaseItem.tsx +134 -55
  27. package/src/components/Items/BaseItem/styles.module.scss +16 -16
  28. package/src/components/Lists/List/List.tsx +4 -0
  29. package/src/components/Lists/contexts/NewListProvider.tsx +137 -6
  30. package/src/helperComponents/DesktopDroplist/DesktopDroplist.tsx +4 -0
  31. package/src/helperComponents/MobileDroplist/MobileDroplist.tsx +5 -0
  32. package/src/helperComponents/Separator/Separator.tsx +19 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cloud-ru/ds-list",
3
- "version": "2.3.5",
3
+ "version": "2.3.7-preview-d9442369.0",
4
4
  "description": "Списочный UI — компонент List для плоских/вложенных списков с выбором, группами и поиском и Droplist — тот же список в поповере.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -48,24 +48,24 @@
48
48
  "@tanstack/react-virtual": "^3.14.8",
49
49
  "classnames": "^2.5.1",
50
50
  "merge-refs": "^2.0.0",
51
- "@cloud-ru/ds-button": "^1.0.4",
52
- "@cloud-ru/ds-adaptive": "^1.0.2",
53
- "@cloud-ru/ds-divider": "^1.0.2",
54
- "@cloud-ru/ds-drag-and-drop": "^1.1.3",
55
- "@cloud-ru/ds-icons": "^1.6.0",
56
- "@cloud-ru/ds-dropdown": "^1.1.3",
57
- "@cloud-ru/ds-bottom-sheet": "^2.0.2",
58
- "@cloud-ru/ds-info-block": "^1.0.3",
59
- "@cloud-ru/ds-loader": "^1.0.3",
60
- "@cloud-ru/ds-materials": "^2.0.1",
61
- "@cloud-ru/ds-portal-context": "^1.0.2",
62
- "@cloud-ru/ds-scroll": "^1.0.5",
63
- "@cloud-ru/ds-search-private": "^1.0.16",
64
- "@cloud-ru/ds-truncate-string": "^1.0.14",
65
- "@cloud-ru/ds-toggles": "^1.1.11",
66
- "@cloud-ru/ds-utils": "^1.2.0"
51
+ "@cloud-ru/ds-bottom-sheet": "2.0.3",
52
+ "@cloud-ru/ds-adaptive": "1.0.2",
53
+ "@cloud-ru/ds-drag-and-drop": "1.1.3",
54
+ "@cloud-ru/ds-dropdown": "1.1.4",
55
+ "@cloud-ru/ds-divider": "1.0.2",
56
+ "@cloud-ru/ds-button": "1.0.4",
57
+ "@cloud-ru/ds-icons": "1.6.0",
58
+ "@cloud-ru/ds-info-block": "1.0.3",
59
+ "@cloud-ru/ds-loader": "1.0.3",
60
+ "@cloud-ru/ds-materials": "2.0.1",
61
+ "@cloud-ru/ds-portal-context": "1.0.2",
62
+ "@cloud-ru/ds-scroll": "1.0.5",
63
+ "@cloud-ru/ds-toggles": "1.1.11",
64
+ "@cloud-ru/ds-search-private": "1.0.16",
65
+ "@cloud-ru/ds-truncate-string": "1.0.14",
66
+ "@cloud-ru/ds-utils": "1.2.0"
67
67
  },
68
68
  "peerDependencies": {
69
- "@cloud-ru/ds-locale": "^1.0.0"
69
+ "@cloud-ru/ds-locale": "1.0.0"
70
70
  }
71
71
  }
@@ -1,9 +1,9 @@
1
1
  import { Checkbox, Switch } from '@cloud-ru/ds-toggles';
2
- import { extractSupportProps } from '@cloud-ru/ds-utils';
2
+ import { extractSupportProps, ValueOf } from '@cloud-ru/ds-utils';
3
3
  import cn from 'classnames';
4
4
  import { FocusEvent, KeyboardEvent, MouseEvent, ReactNode, RefObject } from 'react';
5
5
 
6
- import { DEFAULT_SIZE, TEST_IDS } from '../../../constants';
6
+ import { DEFAULT_SIZE, MODE, TEST_IDS } from '../../../constants';
7
7
  import { ItemContent } from '../../../helperComponents';
8
8
  import {
9
9
  useCollapseLevelContext,
@@ -74,7 +74,14 @@ export function BaseItem({
74
74
  }: AllBaseItemProps) {
75
75
  const interactive = !inactive;
76
76
 
77
- const { size = DEFAULT_SIZE, marker, contentRender, firstItemId, focusFlattenItems } = useNewListContext();
77
+ const {
78
+ size = DEFAULT_SIZE,
79
+ marker,
80
+ contentRender,
81
+ itemRender,
82
+ firstItemId,
83
+ focusFlattenItems,
84
+ } = useNewListContext();
78
85
  const { level = 0 } = useCollapseLevelContext();
79
86
  const { closeDroplist, closeDroplistOnItemClick } = useOpenListContext();
80
87
  const { value, onChange, mode, isSelectionSingle, isSelectionMultiple } = useSelectionContext();
@@ -178,14 +185,20 @@ export function BaseItem({
178
185
  const props = extractSupportProps(rest);
179
186
 
180
187
  let contentNode: ReactNode;
188
+ let contentFromRender = Boolean(contentRender);
181
189
  if (content && isContentItem(content)) {
182
190
  contentNode = contentRender?.({ id, content, disabled }) ?? <ItemContent disabled={disabled} {...content} />;
183
191
  } else if (isPrimitiveContent(content)) {
184
192
  // Примитивный content — шорткат `{ label: content }`: рендерим через ItemContent,
185
193
  // чтобы строка получила размерную высоту, а не схлопывалась до высоты текста.
186
- contentNode = <ItemContent disabled={disabled} label={content} />;
194
+ const primitiveContent = { label: content };
195
+ contentNode = contentRender?.({ id, content: primitiveContent, disabled }) ?? (
196
+ <ItemContent disabled={disabled} label={content} />
197
+ );
187
198
  } else {
188
- contentNode = <div className={styles.content}> {content} </div>;
199
+ contentNode = contentRender?.({ id, content, disabled }) ?? <div className={styles.content}> {content} </div>;
200
+ // Неструктурный content оболочка не разберёт на label/caption — отдаём готовый узел.
201
+ contentFromRender = true;
189
202
  }
190
203
 
191
204
  const stateLayerState =
@@ -193,7 +206,112 @@ export function BaseItem({
193
206
  ? 'activatedOnBackground'
194
207
  : 'emptyNeutralOnBackground';
195
208
 
196
- const itemJSX = (
209
+ const dataTestId =
210
+ (typeof props['data-test-id'] === 'string' ? props['data-test-id'] : undefined) || `${TEST_IDS.baseItem}_${id}`;
211
+ const tabIndex = firstItemId && id === focusFlattenItems[firstItemId]?.originalId ? 0 : -1;
212
+
213
+ const dragHandleNode = dragHandle ? <div className={styles.dragHandle}>{dragHandle}</div> : undefined;
214
+
215
+ // Маркер/чекбокс/шеврон-обёртка нужны только дефолтной разметке; при `itemRender`
216
+ // оболочка рисует индикаторы сама по `selectionMode`.
217
+ const markerNode =
218
+ !itemRender && !switchProp && isSelectionSingle && marker && !isParentNode && interactive ? (
219
+ <div
220
+ className={styles.markerContainer}
221
+ data-test-id={TEST_IDS.baseItemMarker}
222
+ data-checked={isChecked || undefined}
223
+ data-disabled={disabled || undefined}
224
+ />
225
+ ) : undefined;
226
+
227
+ const checkboxNode =
228
+ !itemRender && !switchProp && isSelectionMultiple && interactive ? (
229
+ <div className={styles.checkbox}>
230
+ <Checkbox
231
+ size={TOGGLE_SIZE_MAP[size]}
232
+ disabled={disabled}
233
+ tabIndex={-1}
234
+ onChange={isParentNode ? handleCheckboxChange : undefined}
235
+ checked={isChecked}
236
+ data-test-id={TEST_IDS.baseItemCheckbox}
237
+ onClick={handleCheckboxClick}
238
+ indeterminate={indeterminate}
239
+ />
240
+ </div>
241
+ ) : undefined;
242
+
243
+ const switchControlNode =
244
+ switchProp && interactive ? (
245
+ <span className={styles.switchWrapper}>
246
+ <Switch
247
+ size={TOGGLE_SIZE_MAP[size]}
248
+ disabled={disabled}
249
+ checked={isChecked}
250
+ data-test-id={TEST_IDS.baseItemSwitch}
251
+ showIcon={showSwitchIcon}
252
+ />
253
+ </span>
254
+ ) : undefined;
255
+
256
+ const expandIconNode =
257
+ !itemRender && !switchProp && expandIcon ? (
258
+ // Интерактивный шеврон не получает роль и фокус намеренно: клавиатурный путь идёт
259
+ // через строку, у неё же живёт `aria-expanded`. Лишний таб-стоп сломал бы порядок
260
+ // фокуса списка, а озвучивать AT недостижимый с клавиатуры элемент незачем.
261
+ <span
262
+ className={styles.groupIndicator}
263
+ data-open={open || undefined}
264
+ data-interactive={Boolean(onExpandIconClick) || undefined}
265
+ data-test-id={TEST_IDS.groupIndicator}
266
+ onClick={onExpandIconClick && handleExpandIconClick}
267
+ aria-hidden
268
+ >
269
+ {expandIcon}
270
+ </span>
271
+ ) : undefined;
272
+
273
+ const isRowChecked = Boolean((isParentNode && (indeterminate || isChecked)) || (isChecked && !switchProp));
274
+
275
+ let selectionMode: ValueOf<typeof MODE> = MODE.None;
276
+ if (isSelectionMultiple) {
277
+ selectionMode = MODE.Multiple;
278
+ } else if (isSelectionSingle) {
279
+ selectionMode = MODE.Single;
280
+ }
281
+
282
+ const itemJSX = itemRender ? (
283
+ itemRender({
284
+ id,
285
+ content,
286
+ contentNode,
287
+ contentFromRender,
288
+ beforeContent,
289
+ afterContent,
290
+ dragHandle: dragHandleNode,
291
+ switchControl: switchControlNode,
292
+ // Сырой слот: обёртку centeredWrapper/groupIndicator рисует кастомная оболочка.
293
+ expandIcon: !switchProp && expandIcon ? expandIcon : undefined,
294
+ selectionMode,
295
+ disabled,
296
+ inactive,
297
+ checked: isRowChecked,
298
+ open,
299
+ isParentNode,
300
+ size,
301
+ level,
302
+ className,
303
+ itemRef: itemRef as RefObject<HTMLElement>,
304
+ tabIndex,
305
+ 'data-test-id': dataTestId,
306
+ style: { '--level': level },
307
+ onClick: handleItemClick,
308
+ onMouseDown: handleItemMouseDown,
309
+ onKeyDown: handleItemKeyDown,
310
+ onFocus: handleItemFocus,
311
+ onExpandIconClick: onExpandIconClick ? handleExpandIconClick : undefined,
312
+ expandIconInteractive: Boolean(onExpandIconClick),
313
+ })
314
+ ) : (
197
315
  <div
198
316
  className={cn(commonStyles.itemWrapper, styles.innerWrapper, className)}
199
317
  data-size={size}
@@ -206,13 +324,13 @@ export function BaseItem({
206
324
  <li
207
325
  data-type='outside'
208
326
  role={'menuitem'}
209
- data-test-id={props['data-test-id'] || `${TEST_IDS.baseItem}_${id}`}
327
+ data-test-id={dataTestId}
210
328
  ref={itemRef as RefObject<HTMLLIElement>}
211
329
  className={cn(commonStyles.listItem, styles.droplistItem)}
212
330
  data-size={size}
213
331
  onClick={handleItemClick}
214
332
  onMouseDown={handleItemMouseDown}
215
- tabIndex={firstItemId && id === focusFlattenItems[firstItemId]?.originalId ? 0 : -1}
333
+ tabIndex={tabIndex}
216
334
  data-non-pointer={(inactive && !onClick) || undefined}
217
335
  data-variant={mode || undefined}
218
336
  data-open={open || undefined}
@@ -224,26 +342,11 @@ export function BaseItem({
224
342
  data-level-more-one={level > 1 || undefined}
225
343
  data-checked={(isParentNode && (indeterminate || isChecked)) || (isChecked && !switchProp) || undefined}
226
344
  >
227
- {dragHandle && <div className={styles.dragHandle}>{dragHandle}</div>}
228
-
229
- {!switchProp && isSelectionSingle && marker && !isParentNode && interactive && (
230
- <div className={styles.markerContainer} data-test-id={TEST_IDS.baseItemMarker} />
231
- )}
232
-
233
- {!switchProp && isSelectionMultiple && interactive && (
234
- <div className={styles.checkbox}>
235
- <Checkbox
236
- size={TOGGLE_SIZE_MAP[size]}
237
- disabled={disabled}
238
- tabIndex={-1}
239
- onChange={isParentNode ? handleCheckboxChange : undefined}
240
- checked={isChecked}
241
- data-test-id={TEST_IDS.baseItemCheckbox}
242
- onClick={handleCheckboxClick}
243
- indeterminate={indeterminate}
244
- />
245
- </div>
246
- )}
345
+ {dragHandleNode}
346
+
347
+ {markerNode}
348
+
349
+ {checkboxNode}
247
350
 
248
351
  {/* contentWrapper мастера: иконочные слоты и текст лежат в одном узле без gap —
249
352
  их разделяют только горизонтальные поля textContent. */}
@@ -253,33 +356,9 @@ export function BaseItem({
253
356
  {afterContent && <div className={styles.afterContent}>{afterContent}</div>}
254
357
  </div>
255
358
 
256
- {switchProp && interactive && (
257
- <span className={styles.switchWrapper}>
258
- <Switch
259
- size={TOGGLE_SIZE_MAP[size]}
260
- disabled={disabled}
261
- checked={isChecked}
262
- data-test-id={TEST_IDS.baseItemSwitch}
263
- showIcon={showSwitchIcon}
264
- />
265
- </span>
266
- )}
267
-
268
- {!switchProp && expandIcon && (
269
- // Интерактивный шеврон не получает роль и фокус намеренно: клавиатурный путь идёт
270
- // через строку, у неё же живёт `aria-expanded`. Лишний таб-стоп сломал бы порядок
271
- // фокуса списка, а озвучивать AT недостижимый с клавиатуры элемент незачем.
272
- <span
273
- className={styles.groupIndicator}
274
- data-open={open || undefined}
275
- data-interactive={Boolean(onExpandIconClick) || undefined}
276
- data-test-id={TEST_IDS.groupIndicator}
277
- onClick={onExpandIconClick && handleExpandIconClick}
278
- aria-hidden
279
- >
280
- {expandIcon}
281
- </span>
282
- )}
359
+ {switchControlNode}
360
+
361
+ {expandIconNode}
283
362
  </li>
284
363
  </div>
285
364
  );
@@ -129,6 +129,22 @@ $sizes: 's', 'm', 'l';
129
129
  width: 100%;
130
130
  height: 100%;
131
131
  }
132
+
133
+ // Цвет маркера на самом узле (а не через `.innerWrapper[data-checked]`), чтобы слот
134
+ // работал и внутри кастомной оболочки `itemRender`.
135
+ &[data-checked]::before {
136
+ background-color: base.$sn-theme-color-primary-accent;
137
+ }
138
+
139
+ &[data-checked][data-disabled] {
140
+ opacity: base.$sn-theme-effect-opacity-disabled;
141
+
142
+ &::before {
143
+ // В мастере выключенный маркер — сплошной `neutral/accent`, а не полупрозрачный
144
+ // текстовый токен: полоса остаётся читаемой на любом фоне.
145
+ background-color: base.$sn-theme-color-neutral-accent;
146
+ }
147
+ }
132
148
  }
133
149
 
134
150
  $level: var(--level, 0);
@@ -277,27 +293,11 @@ $level: var(--level, 0);
277
293
 
278
294
  &[data-has-checked],
279
295
  &[data-checked] {
280
- .markerContainer::before {
281
- background-color: base.$sn-theme-color-primary-accent;
282
- }
283
-
284
296
  // В макете фокус выбранной строки красится в `primary/accent` в обоих режимах выбора,
285
297
  // а не только в одиночном.
286
298
  .droplistItem:focus-visible {
287
299
  outline-color: base.$sn-theme-color-primary-accent;
288
300
  }
289
-
290
- &[data-disabled] {
291
- .markerContainer {
292
- opacity: base.$sn-theme-effect-opacity-disabled;
293
-
294
- &::before {
295
- // В мастере выключенный маркер — сплошной `neutral/accent`, а не полупрозрачный
296
- // текстовый токен: полоса остаётся читаемой на любом фоне.
297
- background-color: base.$sn-theme-color-neutral-accent;
298
- }
299
- }
300
- }
301
301
  }
302
302
  }
303
303
 
@@ -28,6 +28,8 @@ const ListImpl = forwardRef(
28
28
  collapse = {},
29
29
  selection,
30
30
  contentRender,
31
+ itemRender,
32
+ groupItemRender,
31
33
  size = DEFAULT_SIZE,
32
34
  marker = true,
33
35
  keyboardNavigationRef,
@@ -104,6 +106,8 @@ const ListImpl = forwardRef(
104
106
  flattenItems={flattenItems}
105
107
  focusFlattenItems={focusFlattenItems}
106
108
  contentRender={contentRender}
109
+ itemRender={itemRender}
110
+ groupItemRender={groupItemRender}
107
111
  size={size}
108
112
  marker={marker}
109
113
  firstItemId={firstItemId}
@@ -1,16 +1,102 @@
1
- import { createContext, ReactNode, useContext, useMemo } from 'react';
1
+ import { TruncateStringProps } from '@cloud-ru/ds-truncate-string';
2
+ import {
3
+ createContext,
4
+ CSSProperties,
5
+ FocusEvent,
6
+ ForwardedRef,
7
+ KeyboardEvent,
8
+ MouseEvent,
9
+ ReactNode,
10
+ RefObject,
11
+ useContext,
12
+ useMemo,
13
+ } from 'react';
2
14
 
3
15
  import { ITEM_PREFIXES } from '../../../constants';
4
16
  import { ItemContentProps } from '../../../helperComponents';
5
- import { Size } from '../../../types';
17
+ import { Mode, Size } from '../../../types';
6
18
  import { FlattenItem, FocusFlattenItem, ItemId } from '../../Items';
7
19
 
8
- type ContentRenderProps = {
20
+ export type ContentRenderProps = {
9
21
  id?: ItemId;
10
22
  content?: ItemContentProps | ReactNode;
11
23
  disabled?: boolean;
12
24
  };
13
25
 
26
+ /**
27
+ * Данные строки для кастомной оболочки (`itemRender`).
28
+ * Логика клика/выбора остаётся в `BaseItem`. Индикаторы выбора (маркер/чекбокс)
29
+ * оболочка рисует сама по `selectionMode` / `checked` / `disabled`.
30
+ */
31
+ export type ItemRenderProps = {
32
+ id?: ItemId;
33
+ /** Исходный `content` айтема (пропсы `ItemContent` или произвольный узел) */
34
+ content?: ItemContentProps | ReactNode;
35
+ /**
36
+ * Уже собранный контент: результат `contentRender`, либо дефолтный `ItemContent`,
37
+ * либо обёртка над произвольным `content`. Кастомная оболочка может использовать его
38
+ * как есть или пересобрать разметку из `content`.
39
+ */
40
+ contentNode: ReactNode;
41
+ /**
42
+ * `true`, если `contentNode` собран через `contentRender` (или это неструктурный
43
+ * `content`). Тогда оболочка должна вставить `contentNode` как есть, а не
44
+ * пересобирать текст из полей `content`.
45
+ */
46
+ contentFromRender?: boolean;
47
+ beforeContent?: ReactNode;
48
+ afterContent?: ReactNode;
49
+ dragHandle?: ReactNode;
50
+ switchControl?: ReactNode;
51
+ /** Сырая иконка шеврона — обёртку рисует оболочка */
52
+ expandIcon?: ReactNode;
53
+ /** Режим выбора списка (`none` / `single` / `multiple`) */
54
+ selectionMode: Mode;
55
+ disabled?: boolean;
56
+ inactive?: boolean;
57
+ checked?: boolean;
58
+ open?: boolean;
59
+ isParentNode?: boolean;
60
+ size: Size;
61
+ level: number;
62
+ className?: string;
63
+ itemRef?: RefObject<HTMLElement>;
64
+ tabIndex: number;
65
+ 'data-test-id'?: string;
66
+ /** CSS-переменная `--level` и прочие инлайн-стили корня строки */
67
+ style?: CSSProperties;
68
+ onClick?(e: MouseEvent<HTMLElement>): void;
69
+ onMouseDown?(e: MouseEvent<HTMLElement>): void;
70
+ onKeyDown?(e: KeyboardEvent<HTMLElement>): void;
71
+ onFocus?(e: FocusEvent<HTMLElement>): void;
72
+ onExpandIconClick?(e: MouseEvent<HTMLElement>): void;
73
+ expandIconInteractive?: boolean;
74
+ };
75
+
76
+ /**
77
+ * Данные заголовка группы для кастомной оболочки (`groupItemRender`).
78
+ * `selectButtonNode` — уже собранная кнопка массового выбора (если есть).
79
+ */
80
+ export type GroupItemRenderProps = {
81
+ label?: string;
82
+ beforeContent?: ReactNode;
83
+ truncate?: {
84
+ variant?: TruncateStringProps['variant'];
85
+ };
86
+ groupVariant?: 'subtitle' | 'subtitleTertiary';
87
+ divider?: boolean;
88
+ selectButtonNode?: ReactNode;
89
+ selectButton?: {
90
+ onClick?(e: MouseEvent<HTMLElement>): void;
91
+ indeterminate?: boolean;
92
+ checked?: boolean;
93
+ itemRef?: ForwardedRef<HTMLElement>;
94
+ label?: string;
95
+ };
96
+ size: Size;
97
+ level: number;
98
+ };
99
+
14
100
  export type PublicListContextType = {
15
101
  /** Размер списка */
16
102
  size?: Size;
@@ -20,6 +106,16 @@ export type PublicListContextType = {
20
106
  * Рендер функция основного контента айтема
21
107
  */
22
108
  contentRender?(props: ContentRenderProps): ReactNode;
109
+ /**
110
+ * Рендер-функция оболочки строки вместо дефолтной разметки `BaseItem`.
111
+ * Не задана — строка рисуется как раньше. `itemWrapRender` по-прежнему оборачивает результат.
112
+ */
113
+ itemRender?(props: ItemRenderProps): ReactNode;
114
+ /**
115
+ * Рендер-функция заголовка группы вместо дефолтной разметки `Separator`.
116
+ * Не задана — заголовок/разделитель рисуются как раньше.
117
+ */
118
+ groupItemRender?(props: GroupItemRenderProps): ReactNode;
23
119
  virtualized?: boolean;
24
120
  };
25
121
 
@@ -51,10 +147,22 @@ function extractListProps<T extends ListContextType>({
51
147
  flattenItems,
52
148
  focusFlattenItems,
53
149
  contentRender,
150
+ itemRender,
151
+ groupItemRender,
54
152
  firstItemId,
55
153
  virtualized,
56
154
  }: T) {
57
- return { size, marker, contentRender, flattenItems, focusFlattenItems, firstItemId, virtualized };
155
+ return {
156
+ size,
157
+ marker,
158
+ contentRender,
159
+ itemRender,
160
+ groupItemRender,
161
+ flattenItems,
162
+ focusFlattenItems,
163
+ firstItemId,
164
+ virtualized,
165
+ };
58
166
  }
59
167
 
60
168
  export function NewListContextProvider({
@@ -64,12 +172,35 @@ export function NewListContextProvider({
64
172
  flattenItems,
65
173
  focusFlattenItems,
66
174
  contentRender,
175
+ itemRender,
176
+ groupItemRender,
67
177
  firstItemId,
68
178
  virtualized,
69
179
  }: ListContextType & Child) {
70
180
  const value = useMemo(
71
- () => extractListProps({ size, marker, flattenItems, focusFlattenItems, contentRender, firstItemId, virtualized }),
72
- [size, marker, flattenItems, focusFlattenItems, contentRender, firstItemId, virtualized],
181
+ () =>
182
+ extractListProps({
183
+ size,
184
+ marker,
185
+ flattenItems,
186
+ focusFlattenItems,
187
+ contentRender,
188
+ itemRender,
189
+ groupItemRender,
190
+ firstItemId,
191
+ virtualized,
192
+ }),
193
+ [
194
+ size,
195
+ marker,
196
+ flattenItems,
197
+ focusFlattenItems,
198
+ contentRender,
199
+ itemRender,
200
+ groupItemRender,
201
+ firstItemId,
202
+ virtualized,
203
+ ],
73
204
  );
74
205
 
75
206
  return <ListContext.Provider value={value}>{children}</ListContext.Provider>;
@@ -46,6 +46,8 @@ export function DesktopDroplist({
46
46
  disableSpanWrapper,
47
47
  selection,
48
48
  contentRender,
49
+ itemRender,
50
+ groupItemRender,
49
51
  size = DEFAULT_SIZE,
50
52
  marker = true,
51
53
  closeDroplistOnItemClick = false,
@@ -247,6 +249,8 @@ export function DesktopDroplist({
247
249
  flattenItems={flattenItems}
248
250
  focusFlattenItems={focusFlattenItems}
249
251
  contentRender={contentRender}
252
+ itemRender={itemRender}
253
+ groupItemRender={groupItemRender}
250
254
  size={size}
251
255
  marker={marker}
252
256
  firstItemId={firstItemId}
@@ -180,6 +180,11 @@ export function MobileDroplist({
180
180
  noDataState: rest.noDataState,
181
181
  noResultsState: rest.noResultsState,
182
182
  errorDataState: rest.errorDataState,
183
+ // Оболочки строк/групп и contentRender нужны на каждом уровне drill-down, не только на корне.
184
+ contentRender: rest.contentRender,
185
+ itemRender: rest.itemRender,
186
+ groupItemRender: rest.groupItemRender,
187
+ marker: rest.marker,
183
188
  ...(isRoot ? rest : null),
184
189
  // Контролируемые scroll-пропсы идут после `...rest`, чтобы их не перебило значениями
185
190
  // с десктопа. В sheet'е список заполняет body и скроллится внутри себя (`sheetScroll`,
@@ -35,7 +35,7 @@ export function Separator({
35
35
  groupVariant = 'subtitleTertiary',
36
36
  selectButton,
37
37
  }: SeparatorProps) {
38
- const { size = 'm' } = useNewListContext();
38
+ const { size = 'm', groupItemRender } = useNewListContext();
39
39
  const { level = 0 } = useCollapseLevelContext();
40
40
 
41
41
  const { t } = listLocale.useTranslations();
@@ -68,6 +68,24 @@ export function Separator({
68
68
  );
69
69
  }, [selectButton, size, t]);
70
70
 
71
+ if (groupItemRender && (label || divider)) {
72
+ return (
73
+ <>
74
+ {groupItemRender({
75
+ label,
76
+ beforeContent,
77
+ truncate,
78
+ groupVariant,
79
+ divider,
80
+ selectButton,
81
+ selectButtonNode: selectButtonJSX,
82
+ size,
83
+ level,
84
+ })}
85
+ </>
86
+ );
87
+ }
88
+
71
89
  if (label) {
72
90
  return (
73
91
  <div