@sberbusiness/triplex-next-mcp-server 1.50.0-beta → 1.53.1

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 (74) hide show
  1. package/README.md +1 -0
  2. package/bundle/components/AlertProcess.md +6 -3
  3. package/bundle/components/AlertProcessSpoiler.md +216 -0
  4. package/bundle/components/Badge.md +4 -3
  5. package/bundle/components/ButtonDropdown.md +5 -3
  6. package/bundle/components/Carousel.md +671 -0
  7. package/bundle/components/CarouselExtended.md +7 -5
  8. package/bundle/components/CarouselIndicators.md +666 -0
  9. package/bundle/components/CarouselItem.md +579 -0
  10. package/bundle/components/CarouselNextButton.md +633 -0
  11. package/bundle/components/CarouselPrevButton.md +633 -0
  12. package/bundle/components/CarouselViewport.md +631 -0
  13. package/bundle/components/CheckboxTreeExtended.md +21 -7
  14. package/bundle/components/CheckboxTreeExtendedCheckbox.md +591 -0
  15. package/bundle/components/CheckboxTreeExtendedNode.md +577 -0
  16. package/bundle/components/Chip.md +1 -0
  17. package/bundle/components/ChipDatePicker.md +332 -0
  18. package/bundle/components/ChipDatePickerTarget.md +316 -0
  19. package/bundle/components/ChipMonthYearPicker.md +4 -3
  20. package/bundle/components/ChipMonthYearPickerTarget.md +318 -0
  21. package/bundle/components/ChipMultiselect.md +63 -73
  22. package/bundle/components/ChipSelect.md +385 -0
  23. package/bundle/components/ChipSelectTarget.md +388 -0
  24. package/bundle/components/ChipSuggest.md +10 -16
  25. package/bundle/components/ChipSuggestTarget.md +506 -0
  26. package/bundle/components/CollapsibleTree.md +2 -1
  27. package/bundle/components/CollapsibleTreeExtended.md +2 -1
  28. package/bundle/components/DateField.md +4 -2
  29. package/bundle/components/DatePickerExtended.md +16 -14
  30. package/bundle/components/DateRange.md +17 -10
  31. package/bundle/components/Dropdown.md +36 -63
  32. package/bundle/components/EmptyView.md +9 -4
  33. package/bundle/components/ExpandAnimation.md +9 -5
  34. package/bundle/components/FormField.md +1 -1
  35. package/bundle/components/ImageGallery.md +19 -52
  36. package/bundle/components/ImageGalleryExtended.md +123 -139
  37. package/bundle/components/ListItemControlsButtonDropdown.md +3 -2
  38. package/bundle/components/LoaderSmall.md +5 -4
  39. package/bundle/components/MonthYearRange.md +334 -0
  40. package/bundle/components/MultiselectField.md +81 -143
  41. package/bundle/components/Notification.md +2 -1
  42. package/bundle/components/NotificationGrouped.md +174 -0
  43. package/bundle/components/NumberField.md +259 -116
  44. package/bundle/components/OrderedList.md +149 -112
  45. package/bundle/components/Overlay.md +3 -2
  46. package/bundle/components/PageIndicators.md +306 -0
  47. package/bundle/components/Pagination.md +81 -3
  48. package/bundle/components/PaginationExtended.md +160 -0
  49. package/bundle/components/Portal.md +5 -2
  50. package/bundle/components/Puller.md +375 -0
  51. package/bundle/components/SMSField.md +277 -102
  52. package/bundle/components/SelectExtendedField.md +11 -7
  53. package/bundle/components/SelectField.md +7 -4
  54. package/bundle/components/SmartSpot.md +259 -0
  55. package/bundle/components/Step.md +2 -1
  56. package/bundle/components/Stepper.md +7 -7
  57. package/bundle/components/Suggest.md +7 -6
  58. package/bundle/components/SuggestField.md +8 -6
  59. package/bundle/components/TableBasic.md +12 -14
  60. package/bundle/components/Tooltip.md +9 -8
  61. package/bundle/guides/commits.md +4 -1
  62. package/bundle/guides/context.md +5 -5
  63. package/bundle/guides/stories.md +29 -21
  64. package/bundle/manifest.json +145 -13
  65. package/bundle/release-notes/1.50.0.mdx +4 -0
  66. package/bundle/release-notes/1.51.0.mdx +57 -0
  67. package/bundle/release-notes/1.52.0.mdx +55 -0
  68. package/bundle/release-notes/1.53.0.mdx +60 -0
  69. package/bundle/release-notes/1.54.0.mdx +45 -0
  70. package/bundle/release-notes/1.55.0.mdx +7 -0
  71. package/bundle/tokens.json +377 -222
  72. package/dist/index.js +39 -1
  73. package/dist/index.js.map +1 -1
  74. package/package.json +1 -1
@@ -0,0 +1,506 @@
1
+ ---
2
+ component: ChipSuggestTarget
3
+ category: Chips
4
+ related: [ChipSuggest, ChipSelectTarget, Chip, Suggest]
5
+ tokens: []
6
+ stories: stories/Chips/ChipSuggest.stories.tsx
7
+ version: "1.0"
8
+ ---
9
+
10
+ # ChipSuggestTarget
11
+
12
+ ## Назначение
13
+
14
+ Публичный target для `ChipSuggest`: рендерит `Chip` с подписью и стрелкой либо
15
+ очисткой, открывает и закрывает список через `SuggestContext`.
16
+ Выбранное значение и открытость берёт из ближайшего `Suggest`.
17
+
18
+ Используй когда: собираешь свою композицию `Suggest` с чипсом вместо поля.
19
+ Для готового поиска со списком используй `ChipSuggest`; для target с открытостью
20
+ через props вместо контекста — `ChipSelectTarget`.
21
+
22
+ Публичные импорты:
23
+
24
+ ```tsx
25
+ import { ChipSuggestTarget, type IChipSuggestTargetProps, type ISuggestOption } from "@sberbusiness/triplex-next";
26
+ ```
27
+
28
+ Компонент и интерфейс сохраняют generic-параметр `<T extends ISuggestOption>`.
29
+ Рендери target внутри `Suggest<T>`: вне provider он получает пустое значение,
30
+ закрытый список и setter-заглушку; самостоятельной работы со списком нет.
31
+
32
+ ---
33
+
34
+ ## Варианты и props
35
+
36
+ `IChipSuggestTargetProps<T>` наследует `IChipProps` без `prefix` / `postfix`
37
+ и добавляет опциональный `clearSelected`. Обязательных custom-props нет.
38
+
39
+ | Prop | По умолчанию | Назначение и ограничения |
40
+ |---|---|---|
41
+ | `children` | — | Подпись. Target не подставляет `value.label`: это делает `ChipSuggest` либо потребитель своей композиции |
42
+ | `clearSelected` | — | Вызывается без аргументов встроенной очисткой. Значение `Suggest.value` обновляет потребитель; без callback кнопка остаётся без действия |
43
+ | `onClick` | — | Получает React mouse event после `setDropdownOpen(!dropdownOpen)` |
44
+ | `onKeyDown` | — | Получает все дошедшие до target события клавиатуры, кроме Enter / Space на встроенной очистке; Enter / Space — после переключения |
45
+ | `size` | `EComponentSize.MD` | SM / MD / LG; передаётся в `Chip`, стрелку и очистку |
46
+ | `type` | `EChipType.TYPE_1` | Визуальный тип `Chip`; при использовании через `ChipSuggest` задаётся на родителе |
47
+ | `disabled` | `false` | Отключает target и встроенную очистку; ограничения — в Accessibility |
48
+ | `showNotificationIcon` | `false` | Значок `Badge.Dot` через `Chip` |
49
+ | `className`, `style`, `id`, `data-*`, `aria-*`, прочие span-атрибуты | — | Передаются в корневой `<span>`; `className` объединяется с классами `Chip` |
50
+ | `ref` | — | Указывает на `HTMLSpanElement` чипса, а не на корень `Suggest` или dropdown |
51
+
52
+ ### Состояние из контекста
53
+
54
+ - При `value === undefined` отображается стрелка с `rotated={dropdownOpen}`.
55
+ Любое выбранное значение включает очистку и исходное `selected`-оформление.
56
+ - Клик, Enter и Space переключают открытость в обе стороны. В отличие от
57
+ `ChipSelectTarget`, уже открытый список по Enter / Space закрывается.
58
+ - Переключение target вызывает именно `setDropdownOpen`, а не `closeDropdown`:
59
+ дополнительный сброс строки фильтрации принадлежит другим частям `Suggest`.
60
+
61
+ Spread унаследованных props находится после внутренних `selected` и
62
+ `aria-expanded`: они могут быть переопределены потребителем. Выбор автоматического
63
+ postfix при этом зависит только от `value` в контексте.
64
+ `prefix` / `postfix` исключены из TypeScript API target.
65
+
66
+ ---
67
+
68
+ ## Дизайн-токены
69
+
70
+ Собственных стилей и токенов у target нет, поэтому `tokens: []`.
71
+ Внешний вид наследуется от `Chip`: см. [Chip-ai.md](Chip-ai.md#дизайн-токены).
72
+
73
+ ---
74
+
75
+ ## Инварианты
76
+
77
+ - Сохраняются именованные экспорты `ChipSuggestTarget` и `IChipSuggestTargetProps`
78
+ через `Chip/ChipSuggest/index.ts` и `Chip/index.ts`, generic-сигнатура и тип ref.
79
+ - `forwardRef` обязателен. Ref-target и корневой элемент — `<span>` `Chip`.
80
+ `displayName` — `"ChipSuggestTarget"`.
81
+ - `ChipSuggestTargetWithRef` сохраняет React forwardRef-объект, а assertion
82
+ восстанавливает generic-вызов: не убирать параметр `T` из публичной сигнатуры.
83
+ - `value`, `dropdownOpen` и setter читаются из `useSuggestContext<T>`;
84
+ не добавлять параллельный локальный state.
85
+ - Сначала переключается открытость, затем вызывается пользовательский callback.
86
+ `preventDefault()` в нём не отменяет уже вызванный setter.
87
+ - Клик и Enter / Space встроенной очистки не всплывают в target;
88
+ `clearSelected` вызывается без DOM-события.
89
+ - Сохраняются порядок spread, внешний вид, размеры, типы, имена токенов и story IDs.
90
+ Код остаётся совместимым с React 17.
91
+
92
+ ---
93
+
94
+ ## Accessibility
95
+
96
+ - По умолчанию корень — `<span role="button" tabIndex={0}>` с `aria-expanded`,
97
+ не combobox. Имя задают `children` или ARIA-атрибуты потребителя.
98
+ - Enter / Space переключают список; Space не прокручивает страницу благодаря
99
+ `preventDefault()` в `Chip`. Синтетический click на самом span не создаётся.
100
+ - Escape, клик вне компонента и состояние фильтра обрабатывает `Suggest`.
101
+ Сам target не переносит фокус: поле ввода, `FocusTrap` и возврат фокуса
102
+ принадлежат dropdown-композиции `ChipSuggest`.
103
+ - Встроенная очистка — нативная кнопка: Enter / Space активируют её нативный
104
+ click и вызывают `clearSelected`.
105
+ - У встроенной очистки нет доступного имени и отдельного prop для него
106
+ (TRI-139). ARIA-имя самого target на вложенную кнопку не передаётся.
107
+ - `disabled` означает CSS `pointer-events: none` и `tabIndex=-1` у `Chip`
108
+ и нативный `disabled` у встроенной очистки. В обработчиках target флаг
109
+ не проверяется: программно отправленные события не защищены.
110
+ Не передавай `tabIndex`: он перекрывает `-1`, target снова получит фокус,
111
+ и Enter / Space переключат список.
112
+ - `aria-controls`, `aria-haspopup` и `aria-pressed` автоматически не создаются.
113
+ Фокус оформляется через `Chip.Shadow_Focus`.
114
+
115
+ ---
116
+
117
+ ## Связанные компоненты
118
+
119
+ - [ChipSuggest](ChipSuggest-ai.md) — готовый родитель, формирует подпись,
120
+ передаёт `targetProps` и рендерит target внутри `Suggest`.
121
+ - [ChipSelectTarget](ChipSelectTarget-ai.md) — альтернатива с `opened` /
122
+ `setOpened` через props и другими правилами Enter / Space / Tab.
123
+ - [Chip](Chip-ai.md) — непосредственно рендерится внутри; источник унаследованных
124
+ props, span-семантики и визуальных состояний.
125
+ - [Suggest](../Suggest/Suggest-ai.md) — источник значения, открытости и setter
126
+ через контекст; его provider обязателен для рабочей композиции.
127
+ - `ChipClearButton` и `ChipDropdownArrow` — автоматические варианты postfix;
128
+ собственного AI.md для этих обёрток нет.
129
+
130
+ ---
131
+
132
+ ## Stories
133
+
134
+ Основные истории: `stories/Chips/ChipSuggest.stories.tsx`
135
+ Файлы примеров: `stories/Chips/examples/ChipSuggest/`
136
+
137
+ Используются истории родителя: отдельный stories-файл атому не нужен.
138
+
139
+ | Story | Example file | Что демонстрирует |
140
+ |---|---|---|
141
+ | `Playground` | `PlaygroundExample.tsx` | Тип, размер, подпись и targetProps |
142
+ | `Default` | `DefaultExample.tsx` | Target в готовой композиции поиска и очистки |
143
+ | `Types` | `TypesExample.tsx` | TYPE_1 / TYPE_2 target |
144
+ | `Sizes` | `SizesExample.tsx` | SM / MD / LG |
145
+ | `States` | `StatesExample.tsx` | Выбор с очисткой и disabled target без выбора |
146
+ | `WithNotificationIcon` | `WithNotificationIconExample.tsx` | Значок у опции списка, не у target; скриншот-прогон пропущен |
147
+ | `VisualTests` | `VisualTestsExample.tsx` | Три размера и открытые списки; раскрытие выполняет useLayoutEffect примера |
148
+
149
+ `Default`, `Types`, `Sizes`, `States` и `VisualTests` имеют Linux/CI baseline
150
+ на `xs` / `xl` в `__screenshots__/`. Фокус базового чипса проверяет
151
+ `VisualTests` в stories `Chip`.
152
+
153
+ Контракт target покрывает `src/components/Chip/__tests__/ChipSuggestTarget.test.tsx`,
154
+ интеграцию со списком — `ChipSuggest.test.tsx`.
155
+
156
+ ---
157
+
158
+ ## История изменений
159
+
160
+ | Дата | Изменение |
161
+ |---|---|
162
+ | 2026-10-29 | Создан документ. |
163
+
164
+ ---
165
+
166
+ ## Примеры использования
167
+
168
+ ### Default
169
+
170
+ `stories/Chips/examples/ChipSuggest/DefaultExample.tsx`
171
+
172
+ ```tsx
173
+ import React, { useRef, useState } from "react";
174
+ import { ChipSuggest, EComponentSize, type ISuggestFieldOption } from "@sberbusiness/triplex-next";
175
+ import { mapFruitsToSuggestOptions, SUGGEST_STORY_FRUITS } from "./storyConstants";
176
+
177
+ export const DefaultExample = () => {
178
+ const initialOptions = mapFruitsToSuggestOptions([...SUGGEST_STORY_FRUITS]);
179
+
180
+ const [value, setValue] = useState<ISuggestFieldOption>();
181
+ const [options, setOptions] = useState<ISuggestFieldOption[]>([]);
182
+ const [tooltipOpen, setTooltipOpen] = useState(false);
183
+ const initialOptionsRef = useRef<ISuggestFieldOption[]>(initialOptions);
184
+
185
+ const handleDropdownOpen = () => {
186
+ setOptions(initialOptionsRef.current);
187
+ setTooltipOpen(false);
188
+ };
189
+
190
+ const handleFilter = (inputValue: string) => {
191
+ if (inputValue.length === 0) {
192
+ setOptions(initialOptionsRef.current);
193
+ setTooltipOpen(false);
194
+ return;
195
+ }
196
+
197
+ const filteredOptions = initialOptionsRef.current.filter(({ label }) =>
198
+ String(label).toLowerCase().includes(inputValue.toLowerCase()),
199
+ );
200
+
201
+ setOptions(filteredOptions);
202
+ setTooltipOpen(filteredOptions.length === 0);
203
+ };
204
+
205
+ return (
206
+ <ChipSuggest
207
+ value={value}
208
+ options={options}
209
+ tooltipOpen={tooltipOpen}
210
+ onSelect={setValue}
211
+ onFilter={handleFilter}
212
+ targetProps={{ clearSelected: () => setValue(undefined) }}
213
+ dropdownProps={{ onOpen: handleDropdownOpen }}
214
+ label="Suggest label"
215
+ placeholder="Type to proceed"
216
+ noOptionsText="No matches found."
217
+ size={EComponentSize.MD}
218
+ />
219
+ );
220
+ };
221
+ ```
222
+
223
+ ### Types
224
+
225
+ `stories/Chips/examples/ChipSuggest/TypesExample.tsx`
226
+
227
+ ```tsx
228
+ import React, { useRef, useState } from "react";
229
+ import { ChipSuggest, EChipType, EComponentSize, type ISuggestFieldOption } from "@sberbusiness/triplex-next";
230
+ import { mapFruitsToSuggestOptions, SUGGEST_STORY_FRUITS } from "./storyConstants";
231
+
232
+ type TypeItemProps = {
233
+ type: EChipType;
234
+ label: string;
235
+ };
236
+
237
+ const initialOptions = mapFruitsToSuggestOptions([...SUGGEST_STORY_FRUITS]);
238
+
239
+ const TypeItem = ({ type, label }: TypeItemProps) => {
240
+ const [value, setValue] = useState<ISuggestFieldOption>();
241
+ const [options, setOptions] = useState<ISuggestFieldOption[]>([]);
242
+ const [tooltipOpen, setTooltipOpen] = useState(false);
243
+ const initialOptionsRef = useRef<ISuggestFieldOption[]>(initialOptions);
244
+
245
+ const handleDropdownOpen = () => {
246
+ setOptions(initialOptionsRef.current);
247
+ setTooltipOpen(false);
248
+ };
249
+
250
+ const handleFilter = (inputValue: string) => {
251
+ if (inputValue.length === 0) {
252
+ setOptions(initialOptionsRef.current);
253
+ setTooltipOpen(false);
254
+ return;
255
+ }
256
+
257
+ const filteredOptions = initialOptionsRef.current.filter(({ label }) =>
258
+ String(label).toLowerCase().includes(inputValue.toLowerCase()),
259
+ );
260
+
261
+ setOptions(filteredOptions);
262
+ setTooltipOpen(filteredOptions.length === 0);
263
+ };
264
+
265
+ const handleClearSelected = () => setValue(undefined);
266
+
267
+ return (
268
+ <div>
269
+ <div style={{ marginBottom: 8, fontSize: 16, fontWeight: 700 }}>{label}</div>
270
+ <ChipSuggest
271
+ type={type}
272
+ size={EComponentSize.MD}
273
+ label="Suggest label"
274
+ placeholder="Type to proceed"
275
+ noOptionsText="No matches found."
276
+ value={value}
277
+ options={options}
278
+ tooltipOpen={tooltipOpen}
279
+ onSelect={setValue}
280
+ onFilter={handleFilter}
281
+ targetProps={{ clearSelected: handleClearSelected }}
282
+ dropdownProps={{ onOpen: handleDropdownOpen }}
283
+ />
284
+ </div>
285
+ );
286
+ };
287
+
288
+ const typeOptions = Object.values(EChipType).map((type) => ({
289
+ value: type,
290
+ label: type.toUpperCase(),
291
+ }));
292
+
293
+ export const TypesExample = () => (
294
+ <div style={{ display: "flex", flexDirection: "column", gap: 12 }}>
295
+ {typeOptions.map(({ value, label }) => (
296
+ <TypeItem key={value} type={value} label={label} />
297
+ ))}
298
+ </div>
299
+ );
300
+ ```
301
+
302
+ ### Sizes
303
+
304
+ `stories/Chips/examples/ChipSuggest/SizesExample.tsx`
305
+
306
+ ```tsx
307
+ import React, { useRef, useState } from "react";
308
+ import { ChipSuggest, EComponentSize, type ISuggestFieldOption } from "@sberbusiness/triplex-next";
309
+ import { mapFruitsToSuggestOptions, SUGGEST_STORY_FRUITS } from "./storyConstants";
310
+
311
+ type SizeItemProps = {
312
+ size: EComponentSize;
313
+ label: string;
314
+ };
315
+
316
+ const initialOptions = mapFruitsToSuggestOptions([...SUGGEST_STORY_FRUITS]);
317
+
318
+ const SizeItem = ({ size, label }: SizeItemProps) => {
319
+ const [value, setValue] = useState<ISuggestFieldOption>();
320
+ const [options, setOptions] = useState<ISuggestFieldOption[]>([]);
321
+ const [tooltipOpen, setTooltipOpen] = useState(false);
322
+ const initialOptionsRef = useRef<ISuggestFieldOption[]>(initialOptions);
323
+
324
+ const handleDropdownOpen = () => {
325
+ setOptions(initialOptionsRef.current);
326
+ setTooltipOpen(false);
327
+ };
328
+
329
+ const handleFilter = (inputValue: string) => {
330
+ if (inputValue.length === 0) {
331
+ setOptions(initialOptionsRef.current);
332
+ setTooltipOpen(false);
333
+ return;
334
+ }
335
+
336
+ const filteredOptions = initialOptionsRef.current.filter(({ label }) =>
337
+ String(label).toLowerCase().includes(inputValue.toLowerCase()),
338
+ );
339
+
340
+ setOptions(filteredOptions);
341
+ setTooltipOpen(filteredOptions.length === 0);
342
+ };
343
+
344
+ const handleClearSelected = () => setValue(undefined);
345
+
346
+ return (
347
+ <div>
348
+ <div style={{ marginBottom: 8, fontSize: 16, fontWeight: 700 }}>{label}</div>
349
+ <ChipSuggest
350
+ size={size}
351
+ label="Suggest label"
352
+ placeholder="Type to proceed"
353
+ noOptionsText="No matches found."
354
+ value={value}
355
+ options={options}
356
+ tooltipOpen={tooltipOpen}
357
+ onSelect={setValue}
358
+ onFilter={handleFilter}
359
+ targetProps={{ clearSelected: handleClearSelected }}
360
+ dropdownProps={{ onOpen: handleDropdownOpen }}
361
+ />
362
+ </div>
363
+ );
364
+ };
365
+
366
+ const sizeOptions = Object.values(EComponentSize).map((size) => ({
367
+ value: size,
368
+ label: size.toUpperCase(),
369
+ }));
370
+
371
+ export const SizesExample = () => (
372
+ <div style={{ display: "flex", flexDirection: "column", gap: 12 }}>
373
+ {sizeOptions.map(({ value, label }) => (
374
+ <SizeItem key={value} size={value} label={label} />
375
+ ))}
376
+ </div>
377
+ );
378
+ ```
379
+
380
+ ### States
381
+
382
+ `stories/Chips/examples/ChipSuggest/StatesExample.tsx`
383
+
384
+ ```tsx
385
+ import React, { useRef, useState } from "react";
386
+ import { ChipSuggest, EComponentSize, type ISuggestFieldOption } from "@sberbusiness/triplex-next";
387
+ import { mapFruitsToSuggestOptions, SUGGEST_STORY_FRUITS } from "./storyConstants";
388
+
389
+ const states = [
390
+ { id: "selected", label: "SELECTED" },
391
+ { id: "disabled", label: "DISABLED", targetProps: { disabled: true } },
392
+ ];
393
+
394
+ export const StatesExample = () => {
395
+ const initialOptions = mapFruitsToSuggestOptions([...SUGGEST_STORY_FRUITS]);
396
+
397
+ const [valueSelected, setValueSelected] = useState<ISuggestFieldOption | undefined>(initialOptions[0]);
398
+ const [valueDisabled, setValueDisabled] = useState<ISuggestFieldOption>();
399
+ const [options, setOptions] = useState<ISuggestFieldOption[]>([]);
400
+ const [tooltipOpen, setTooltipOpen] = useState(false);
401
+ const initialOptionsRef = useRef<ISuggestFieldOption[]>(initialOptions);
402
+
403
+ const handleDropdownOpen = () => {
404
+ setOptions(initialOptionsRef.current);
405
+ setTooltipOpen(false);
406
+ };
407
+
408
+ const handleFilter = (inputValue: string) => {
409
+ if (inputValue.length === 0) {
410
+ setOptions(initialOptionsRef.current);
411
+ setTooltipOpen(false);
412
+ return;
413
+ }
414
+
415
+ const filteredOptions = initialOptionsRef.current.filter(({ label }) =>
416
+ String(label).toLowerCase().includes(inputValue.toLowerCase()),
417
+ );
418
+
419
+ setOptions(filteredOptions);
420
+ setTooltipOpen(filteredOptions.length === 0);
421
+ };
422
+
423
+ return (
424
+ <div style={{ display: "flex", flexDirection: "column", gap: 12 }}>
425
+ {states.map((state) => (
426
+ <div key={state.id}>
427
+ <div style={{ marginBottom: 8, fontSize: 16, fontWeight: 700 }}>{state.label}</div>
428
+ <ChipSuggest
429
+ label="Suggest label"
430
+ size={EComponentSize.MD}
431
+ placeholder="Type to proceed"
432
+ noOptionsText="No matches found."
433
+ value={state.id === "selected" ? valueSelected : valueDisabled}
434
+ options={options}
435
+ tooltipOpen={tooltipOpen}
436
+ onSelect={state.id === "selected" ? setValueSelected : setValueDisabled}
437
+ onFilter={handleFilter}
438
+ targetProps={{
439
+ clearSelected: () =>
440
+ state.id === "selected" ? setValueSelected(undefined) : setValueDisabled(undefined),
441
+ ...state.targetProps,
442
+ }}
443
+ dropdownProps={{ onOpen: handleDropdownOpen }}
444
+ />
445
+ </div>
446
+ ))}
447
+ </div>
448
+ );
449
+ };
450
+ ```
451
+
452
+ ### WithNotificationIcon
453
+
454
+ `stories/Chips/examples/ChipSuggest/WithNotificationIconExample.tsx`
455
+
456
+ ```tsx
457
+ import React, { useRef, useState } from "react";
458
+ import { ChipSuggest, EComponentSize, type ISuggestFieldOption } from "@sberbusiness/triplex-next";
459
+ import { mapFruitsToOptionsWithNotification, SUGGEST_STORY_FRUITS_SHORT } from "./storyConstants";
460
+
461
+ export const WithNotificationIconExample = () => {
462
+ const initialOptions = mapFruitsToOptionsWithNotification([...SUGGEST_STORY_FRUITS_SHORT], 2);
463
+
464
+ const [value, setValue] = useState<ISuggestFieldOption>();
465
+ const [options, setOptions] = useState<ISuggestFieldOption[]>([]);
466
+ const [tooltipOpen, setTooltipOpen] = useState(false);
467
+ const initialOptionsRef = useRef<ISuggestFieldOption[]>(initialOptions);
468
+
469
+ const handleDropdownOpen = () => {
470
+ setOptions(initialOptionsRef.current);
471
+ setTooltipOpen(false);
472
+ };
473
+
474
+ const handleFilter = (inputValue: string) => {
475
+ if (inputValue.length === 0) {
476
+ setOptions(initialOptionsRef.current);
477
+ setTooltipOpen(false);
478
+ return;
479
+ }
480
+
481
+ const filteredOptions = initialOptionsRef.current.filter(({ label }) =>
482
+ String(label).toLowerCase().includes(inputValue.toLowerCase()),
483
+ );
484
+
485
+ setOptions(filteredOptions);
486
+ setTooltipOpen(filteredOptions.length === 0);
487
+ };
488
+
489
+ return (
490
+ <ChipSuggest
491
+ value={value}
492
+ options={options}
493
+ tooltipOpen={tooltipOpen}
494
+ onSelect={setValue}
495
+ onFilter={handleFilter}
496
+ targetProps={{ clearSelected: () => setValue(undefined) }}
497
+ dropdownProps={{ onOpen: handleDropdownOpen }}
498
+ label="Suggest label"
499
+ placeholder="Type to proceed"
500
+ noOptionsText="No matches found."
501
+ size={EComponentSize.MD}
502
+ />
503
+ );
504
+ };
505
+ ```
506
+
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  component: CollapsibleTree
3
3
  category: CollapsibleTree
4
- related: [CollapsibleTreeExtended, TreeView, AccordionBase]
4
+ related: [CollapsibleTreeExtended, TreeView]
5
5
  tokens:
6
6
  - CollapsibleTree.Header_Background_Hover
7
7
  - CollapsibleTree.Header_Shadow_Focus
@@ -232,6 +232,7 @@ CollapsibleTree.Header_Shadow_Focus
232
232
  | 2026-07-14 | Глобальный класс `hoverable` (icons-next) на кнопке заголовка теперь стоит всегда, а не только при `disabled` — для корректной окраски шеврона. Добавлен класс `active` на раскрытый узел с детьми (по паттерну `IconWrapper`/`Button`) |
233
233
  | 2026-09-17 | TRI-22: инвариант про отсутствие `forwardRef` переформулирован — `CollapsibleTreeExtended` и `TreeView` под ним теперь пробрасывают `ref` на корневой `<ul>`, поэтому прежнее обоснование не действует, а `CollapsibleTree` остаётся долгом |
234
234
  | 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`CollapsibleTreeNodeHeader`, `CollapsibleTreeNodeLabel`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
235
+ | 2026-10-16 | При сверке ROADMAP с публичными экспортами внутренний `AccordionBase` исключён из `related`; описание зависимости сохранено в «Связанные компоненты». |
235
236
 
236
237
  ---
237
238
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  component: CollapsibleTreeExtended
3
3
  category: CollapsibleTree
4
- related: [CollapsibleTree, TreeView, TreeViewNode, AccordionBase]
4
+ related: [CollapsibleTree, TreeView, TreeViewNode]
5
5
  tokens: []
6
6
  stories: stories/CollapsibleTreeExtended/CollapsibleTreeExtended.stories.tsx
7
7
  version: "1.0"
@@ -194,6 +194,7 @@ controlled/uncontrolled-состояние) через `CollapsibleTreeExtended.
194
194
  | 2026-07-14 | В story-примерах на кнопку заголовка добавлены глобальные классы icons-next: `hoverable` всегда и `active` при `opened` — цвет иконки раскрытия, синхронно с `CollapsibleTreeNodeHeader` |
195
195
  | 2026-08-26 | В `related` добавлен `TreeViewNode` — у узла появился собственный AI.md, и он точный адресат наследования `ICollapsibleTreeExtendedNodeProps` |
196
196
  | 2026-09-17 | TRI-22: `CollapsibleTreeExtended` обёрнут `forwardRef` — `ref` отдаёт корневой `<ul>`; тип переименован в `ICollapsibleTreeExtendedFC`, старое имя оставлено deprecated-алиасом |
197
+ | 2026-10-16 | При сверке ROADMAP с публичными экспортами внутренний `AccordionBase` исключён из `related`; описание зависимости сохранено в «Связанные компоненты». |
197
198
 
198
199
  ---
199
200
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  component: DateField
3
3
  category: Date components
4
- related: [DatePickerExtended, MonthYearField, ChipDatePicker, MaskedField, Calendar, Tooltip, FormField]
4
+ related: [DatePickerExtended, MonthYearField, ChipDatePicker, MaskedField, Calendar, Puller, Tooltip, FormField]
5
5
  tokens: []
6
6
  stories: stories/DateField/DateField.stories.tsx
7
7
  version: "1.0"
@@ -85,7 +85,7 @@ version: "1.0"
85
85
  - Триггер — поле ввода с маской. Открытие/закрытие календаря по клику (`mousedown`), по клавише `Enter` и по `Space` (с `preventDefault` для `Space`, чтобы не вводить пробел и не скроллить страницу). Обработчики в `DateFieldTarget`.
86
86
  - `aria-label` и `aria-labelledby` пробрасываются потребителем на элемент input через одноимённые props `DateField`. Компонент не хардкодит текст — библиотека мультиязычная.
87
87
  - Состояние `disabled` (`status === EFormFieldStatus.DISABLED`) блокирует и поле, и кнопку календаря.
88
- - Тултип с `invalidDateHint` показывается только в desktop-ветке (`MobileView.fallback`); в мобильном представлении ввод идёт через `DropdownMobileMaskedInput` в заголовке дропдауна.
88
+ - Тултип с `invalidDateHint` показывается только в desktop-ветке (`MobileView.fallback`); в мобильном представлении ввод идёт через `PullerMaskedInput` в заголовке дропдауна.
89
89
  - ARIA-роль выпадающего календаря (`dialog`) и навигация по нему — на стороне `DatePickerExtended` / `Calendar`.
90
90
  - **Известный пробел:** кнопка-иконка календаря (`ButtonIcon` в `DateFieldTarget`) фокусируема и не имеет `aria-label` — скринридер объявит её без имени. В `MonthYearFieldTarget` аналогичная кнопка выведена из таб-обхода (`role="presentation"`, `tabIndex={-1}`). Приведение к общему поведению требует изменения публичного API (новый prop для локализованного лейбла) и вынесено за рамки AI-рефакторинга.
91
91
 
@@ -98,6 +98,7 @@ version: "1.0"
98
98
  - `ChipDatePicker` — выбор даты в виде чипа-фильтра, а не поля формы; альтернатива, когда дата задаётся в панели фильтров. Одновременно единственный потребитель, опирающийся на приватные детали `DateField` — импортирует `DateFieldUtils` и `inputDateFormat` (см. «Инварианты»), поэтому правки этих символов проверяй и на нём.
99
99
  - `MaskedField` — внутреннее поле-триггер; его props частично входят в публичный API (`size`, `status`, `label`, `targetProps`).
100
100
  - `Calendar` — календарь внутри дропдауна; его props (`limitRange`, `disabledDays`, `markedDays`, `format`) входят в публичный API через `DatePickerExtended`.
101
+ - `Puller` — мобильная шторка календаря; дата вводится через `PullerMaskedInput` в её шапке.
101
102
  - `Tooltip` — показывает `invalidDateHint` при вводе недоступной даты (только desktop-ветка).
102
103
  - `FormField` — семейство строительных блоков поля, на котором собран `MaskedField`: оттуда
103
104
  в публичный API `DateField` приходят `size` и `status` (через
@@ -132,6 +133,7 @@ version: "1.0"
132
133
  |---|---|
133
134
  | 2026-09-08 | Создан документ. AI-рефакторинг (JSDoc-фиксы, `displayName` у `DateFieldTarget`), unit-тесты для `utils.ts`, поведения поля (ввод, blur, клавиатура, колбэки дропдауна) и `DateFieldTarget` (фокус, mousedown, клавиатура, проброс обработчиков) |
134
135
  | 2026-09-29 | Аудит симметрии `related` (TRI-156): добавлены обратные ссылки (`FormField`). Публичный API и поведение не затронуты. |
136
+ | 2026-10-21 | Переход на `Puller` (TRIPLEX-961): мобильный ввод даты — `PullerMaskedInput` (бывший `DropdownMobileMaskedInput`). |
135
137
 
136
138
  ---
137
139