@sberbusiness/triplex-next-mcp-server 1.44.0-beta → 1.46.0-beta

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 (89) hide show
  1. package/README.md +7 -6
  2. package/bundle/components/AlertContext.md +11 -8
  3. package/bundle/components/AlertProcess.md +13 -10
  4. package/bundle/components/Badge.md +6 -3
  5. package/bundle/components/Button.md +46 -43
  6. package/bundle/components/ButtonDropdownExtended.md +3 -2
  7. package/bundle/components/ButtonIcon.md +7 -4
  8. package/bundle/components/Calendar.md +62 -59
  9. package/bundle/components/Caption.md +26 -23
  10. package/bundle/components/CardAction.md +615 -0
  11. package/bundle/components/Checkbox.md +32 -29
  12. package/bundle/components/CheckboxTreeExtended.md +9 -5
  13. package/bundle/components/Chip.md +51 -47
  14. package/bundle/components/ChipMonthYearPicker.md +344 -0
  15. package/bundle/components/ChipMultiselect.md +1251 -0
  16. package/bundle/components/ChipOptions.md +329 -0
  17. package/bundle/components/ChipSort.md +333 -0
  18. package/bundle/components/ChipSuggest.md +587 -0
  19. package/bundle/components/CodeText.md +26 -23
  20. package/bundle/components/Col.md +1 -2
  21. package/bundle/components/CollapsibleTree.md +8 -5
  22. package/bundle/components/DateField.md +222 -303
  23. package/bundle/components/DatePickerExtended.md +3 -1
  24. package/bundle/components/Dropdown.md +33 -28
  25. package/bundle/components/EmptyView.md +12 -5
  26. package/bundle/components/FooterPage.md +6 -2
  27. package/bundle/components/FormField.md +47 -42
  28. package/bundle/components/FormGroup.md +192 -52
  29. package/bundle/components/Header.md +491 -211
  30. package/bundle/components/HeaderPage.md +6 -2
  31. package/bundle/components/HelpBox.md +7 -1
  32. package/bundle/components/ImageGallery.md +33 -34
  33. package/bundle/components/ImageGalleryExtended.md +33 -34
  34. package/bundle/components/Island.md +16 -13
  35. package/bundle/components/IslandAccordion.md +443 -152
  36. package/bundle/components/IslandWidget.md +622 -157
  37. package/bundle/components/LightBox.md +14 -12
  38. package/bundle/components/Link.md +211 -96
  39. package/bundle/components/ListActionItem.md +7 -4
  40. package/bundle/components/ListItem.md +11 -8
  41. package/bundle/components/ListItemControlsButton.md +16 -13
  42. package/bundle/components/ListItemControlsButtonDropdown.md +9 -6
  43. package/bundle/components/ListItemSelectable.md +7 -4
  44. package/bundle/components/ListMasterFooter.md +8 -5
  45. package/bundle/components/ListMasterHeader.md +8 -5
  46. package/bundle/components/ListSortableItem.md +11 -8
  47. package/bundle/components/ListTableItem.md +7 -4
  48. package/bundle/components/LoaderMiddle.md +7 -4
  49. package/bundle/components/LoaderScreen.md +11 -8
  50. package/bundle/components/LoaderSmall.md +7 -4
  51. package/bundle/components/Marker.md +184 -69
  52. package/bundle/components/MarkerStatus.md +206 -88
  53. package/bundle/components/MaskedField.md +4 -5
  54. package/bundle/components/MasterTable.md +602 -0
  55. package/bundle/components/ModalWindow.md +7 -4
  56. package/bundle/components/MonthYearField.md +3 -1
  57. package/bundle/components/MultiselectField.md +2183 -132
  58. package/bundle/components/Notification.md +12 -9
  59. package/bundle/components/Overlay.md +9 -4
  60. package/bundle/components/Page.md +2 -2
  61. package/bundle/components/Pagination.md +15 -8
  62. package/bundle/components/Row.md +1 -1
  63. package/bundle/components/SelectExtendedField.md +3 -3
  64. package/bundle/components/SelectField.md +466 -148
  65. package/bundle/components/SliderExtended.md +39 -36
  66. package/bundle/components/SmallInput.md +194 -51
  67. package/bundle/components/Suggest.md +535 -99
  68. package/bundle/components/SwipeableArea.md +428 -79
  69. package/bundle/components/TableBasic.md +19 -11
  70. package/bundle/components/TabsExtended.md +24 -21
  71. package/bundle/components/Tag.md +6 -2
  72. package/bundle/components/Text.md +28 -25
  73. package/bundle/components/TextField.md +3 -4
  74. package/bundle/components/ThemeProvider.md +50 -1
  75. package/bundle/components/Title.md +26 -23
  76. package/bundle/components/Tooltip.md +24 -21
  77. package/bundle/components/TopOverlay.md +7 -4
  78. package/bundle/guides/codestyle.md +3 -0
  79. package/bundle/guides/context.md +84 -12
  80. package/bundle/guides/guidelines.md +321 -0
  81. package/bundle/guides/template.md +22 -12
  82. package/bundle/manifest.json +75 -17
  83. package/bundle/release-notes/1.45.0.mdx +117 -0
  84. package/bundle/release-notes/1.46.0.mdx +66 -0
  85. package/bundle/release-notes/1.47.0.mdx +7 -0
  86. package/bundle/tokens.json +6362 -0
  87. package/dist/index.js +177 -28
  88. package/dist/index.js.map +1 -1
  89. package/package.json +1 -1
@@ -3,10 +3,10 @@ component: Notification
3
3
  category: Feedback
4
4
  related: [NotificationGrouped, Button, AlertContext, UnorderedList]
5
5
  tokens:
6
- - --triplex-next-Notification-Background
7
- - --triplex-next-Notification-Color
8
- - --triplex-next-Notification-Shadow
9
- - --triplex-next-Notification-TimeColor
6
+ - Notification.Background
7
+ - Notification.Color
8
+ - Notification.Shadow
9
+ - Notification.TimeColor
10
10
  stories: stories/Notification/Notification.stories.tsx
11
11
  version: "1.0"
12
12
  ---
@@ -91,11 +91,14 @@ Notification
91
91
 
92
92
  ## Дизайн-токены
93
93
 
94
- ```
95
- --triplex-next-Notification-Background (фон уведомления)
96
- --triplex-next-Notification-Color (цвет текста)
97
- --triplex-next-Notification-Shadow (тень карточки)
98
- --triplex-next-Notification-TimeColor (цвет времени)
94
+ Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
95
+ «Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Notification.ts`.
96
+
97
+ ```text
98
+ Notification.Background (фон уведомления)
99
+ Notification.Color (цвет текста)
100
+ Notification.Shadow (тень карточки)
101
+ Notification.TimeColor (цвет времени)
99
102
  ```
100
103
 
101
104
  ---
@@ -2,7 +2,9 @@
2
2
  component: Overlay
3
3
  category: Overlay
4
4
  related: [OverlayBase, OverlayMask, OverlayPanel, LightBox, TopOverlay, ModalWindow, DropdownMobile]
5
- tokens: [--triplex-next-Overlay-Background, --triplex-next-Overlay-Panel_Background]
5
+ tokens:
6
+ - Overlay.Background
7
+ - Overlay.Panel_Background
6
8
  stories: stories/Overlay/Overlay.stories.tsx
7
9
  version: "1.34.0"
8
10
  ---
@@ -90,9 +92,12 @@ off-canvas) над контейнером или страницей.
90
92
 
91
93
  ## Дизайн-токены
92
94
 
93
- ```
94
- --triplex-next-Overlay-Background // фон маски (OverlayMask)
95
- --triplex-next-Overlay-Panel_Background // фон панели (OverlayPanel)
95
+ Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
96
+ «Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Overlay.ts`.
97
+
98
+ ```text
99
+ Overlay.Background // фон маски (OverlayMask)
100
+ Overlay.Panel_Background // фон панели (OverlayPanel)
96
101
  ```
97
102
 
98
103
  Box-shadow панели и тайминги transition (`0.3s ease-in-out`) заданы константами в
@@ -62,8 +62,8 @@ version: "1.0"
62
62
  LESS-переменными в `styles/Page.module.less` (`@page-padding-*`, `@screen-sm-max`). Sticky-стили
63
63
  для прилипающих Header/Footer (классы `.headerPageTypeFirst.sticky`, `.footerPageTypeFirst.sticky`)
64
64
  применяются при ширине viewport от 992px (`@screen-lg`) и высоте от 801px и
65
- используют токены соответствующих компонентов (`--triplex-next-HeaderPage-StickyShadow`,
66
- `--triplex-next-FooterPage-StickyShadow`) — они описаны в AI.md этих компонентов.
65
+ используют токены соответствующих компонентов (`HeaderPage.StickyShadow`,
66
+ `FooterPage.StickyShadow`) — они описаны в AI.md этих компонентов.
67
67
 
68
68
  ---
69
69
 
@@ -15,10 +15,10 @@ related:
15
15
  - ButtonBase
16
16
  - MasterTable
17
17
  tokens:
18
- - --triplex-next-Pagination-PageButton_Background_Hover
19
- - --triplex-next-Pagination-PageButton_Background_Active
20
- - --triplex-next-Pagination-PageButton_Background_Selected
21
- - --triplex-next-Pagination-PageButton_BorderColor_Focus
18
+ - Pagination.PageButton_Background_Hover
19
+ - Pagination.PageButton_Background_Active
20
+ - Pagination.PageButton_Background_Selected
21
+ - Pagination.PageButton_BorderColor_Focus
22
22
  stories: stories/Pagination/Pagination.stories.tsx
23
23
  version: "1.0"
24
24
  ---
@@ -64,6 +64,8 @@ version: "1.0"
64
64
 
65
65
  Расширяет `ISelectFieldProps` (без `size`, с обязательным `value`) и добавляет `paginationLabel: React.ReactNode` — текст лейбла перед селектом. Размер селекта зафиксирован как `EComponentSize.SM`. `value`, `options`, `onChange` — управляются потребителем.
66
66
 
67
+ Распределение свойств по DOM: `className` идёт на корневой `<div>` (он задаёт раскладку лейбла и селекта), все остальные свойства (`data`-атрибуты, `id`, `aria`-атрибуты, `targetProps`, `dropdownProps`, `mobileTitle`, `placeholder` и прочие свойства `SelectField`) прокидываются в `SelectField`. `mobileTitle` по умолчанию равен `paginationLabel`, `targetProps` мержится с внутренним `fieldLabel: ""`, `aria-labelledby` по умолчанию указывает на лейбл, но переопределяется потребителем.
68
+
67
69
  ### Состояние загрузки внутри `MasterTable`
68
70
 
69
71
  Собственного prop загрузки у пагинации нет. Внутри `MasterTable` с `loading` элементы пагинации
@@ -87,13 +89,16 @@ version: "1.0"
87
89
 
88
90
  ## Дизайн-токены
89
91
 
92
+ Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
93
+ «Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Pagination.ts`.
94
+
90
95
  Собственные токены использует только `PaginationPageButton`:
91
96
 
92
97
  ```text
93
- --triplex-next-Pagination-PageButton_Background_Hover
94
- --triplex-next-Pagination-PageButton_Background_Active
95
- --triplex-next-Pagination-PageButton_Background_Selected
96
- --triplex-next-Pagination-PageButton_BorderColor_Focus
98
+ Pagination.PageButton_Background_Hover
99
+ Pagination.PageButton_Background_Active
100
+ Pagination.PageButton_Background_Selected
101
+ Pagination.PageButton_BorderColor_Focus
97
102
  ```
98
103
 
99
104
  Остальные части наследуют визуал от переиспользуемых компонентов: кнопки навигации — от `ButtonIcon`, кнопка-страница — от `ButtonBase`, селект — от `SelectField`, текст — от `Typography` (`Text`).
@@ -109,6 +114,7 @@ version: "1.0"
109
114
  - Логику `PaginationUtils.createPagesArray` / `generatePageRanges` / `generateRange` не менять без перегенерации `__tests__/paginationUtils.test.tsx` — там зафиксированы граничные случаи раскладки.
110
115
  - `PAGINATION_ELLIPSIS_VALUE = -1` — sentinel в массиве страниц, на него завязан рендер многоточия.
111
116
  - Блокировка по `MasterTableContext.loading` перекрывает `disabled`, пришедший из props: в состоянии загрузки кнопка заблокирована независимо от того, что передал потребитель. Обратное неверно — вне загрузки решает prop.
117
+ - `PaginationSelect` не должен терять свойства: его публичный тип — свойства `SelectField`, поэтому всё, что не разобрано явно, обязано уходить в `SelectField`. Точечные перечисления props вместо `...rest` здесь уже приводили к молчаливой потере `status`, `targetProps` и `data`-атрибутов.
112
118
  - Импорт `MasterTableContext` в частях пагинации — абсолютный (`@sberbusiness/triplex-next/components/Table/MasterTableContext`), как в самом `Table`. Относительный путь сюда не ставить.
113
119
 
114
120
  ---
@@ -156,6 +162,7 @@ version: "1.0"
156
162
  | Дата | Изменение |
157
163
  |---|---|
158
164
  | 2026-06-22 | Создан документ |
165
+ | 2026-08-26 | `PaginationSelect` прокидывает в `SelectField` все свойства, которые не разбирает сам: `data`-атрибуты, `id`, `aria`-атрибуты, `targetProps`, `dropdownProps`, `mobileTitle` и т.д. Публичный API не изменился. |
159
166
  | 2026-08-12 | В состоянии загрузки `MasterTable` элементы пагинации становятся `disabled` — читается из `MasterTableContext.loading`. Публичный API не изменился. Заодно `PaginationSelect` перестал молча терять переданный `status`. |
160
167
  | 2026-08-27 | Навигация больше не скрывается при `totalPages <= 1`: отрисовывается одна страница с заблокированными стрелками, высота панели пагинации не схлопывается. Публичный API не изменился. |
161
168
 
@@ -45,7 +45,7 @@ version: "1.0"
45
45
 
46
46
  ## Дизайн-токены
47
47
 
48
- Компонент не использует CSS-переменных `--triplex-next-*`. Размеры берутся из LESS-переменных сетки в `src/styles/components/grid.less`:
48
+ Компонент не использует дизайн-токенов. Размеры берутся из LESS-переменных сетки в `src/styles/components/grid.less`:
49
49
 
50
50
  ```less
51
51
  @row-bottom-padding: 16px
@@ -105,9 +105,9 @@ version: "1.0"
105
105
  каретки и блокировку указателя в `disabled`. Цвета, фон, границы и тени приходят из
106
106
  компонентов, на которых построено поле:
107
107
 
108
- - `FormField` и его части (`FormFieldLabel`, `FormFieldTarget`, `FormFieldPrefix`, `FormFieldPostfix`, `FormFieldClear`) — `--triplex-next-FormField-*`;
109
- - `Dropdown` и `DropdownList` — `--triplex-next-Dropdown-*`, `--triplex-next-DropdownList-*`;
110
- - `IconWrapper` вокруг каретки — `--triplex-next-IconWrapper-*`;
108
+ - `FormField` и его части (`FormFieldLabel`, `FormFieldTarget`, `FormFieldPrefix`, `FormFieldPostfix`, `FormFieldClear`) — группа `FormField`;
109
+ - `Dropdown` и `DropdownList` — группы `Dropdown` и `DropdownList`;
110
+ - `IconWrapper` вокруг каретки — группа `IconWrapper`;
111
111
  - `LoaderSmall` в состоянии загрузки — токены лоадера.
112
112
 
113
113
  Если понадобится собственное визуальное состояние поля выбора — токен заводится