@sberbusiness/triplex-next-mcp-server 0.24.0-beta1 → 0.36.0-beta0

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 (66) hide show
  1. package/README.md +10 -0
  2. package/bundle/components/Alert.md +272 -0
  3. package/bundle/components/Amount.md +138 -0
  4. package/bundle/components/AmountField.md +174 -0
  5. package/bundle/components/Avatar.md +72 -0
  6. package/bundle/components/Badge.md +203 -0
  7. package/bundle/components/BodyPage.md +186 -0
  8. package/bundle/components/Button.md +370 -85
  9. package/bundle/components/ButtonDropdown.md +328 -70
  10. package/bundle/components/ButtonIcon.md +98 -42
  11. package/bundle/components/Calendar.md +58 -0
  12. package/bundle/components/Checkbox.md +77 -44
  13. package/bundle/components/CheckboxTree.md +61 -0
  14. package/bundle/components/CheckboxTreeExtended.md +114 -0
  15. package/bundle/components/CheckboxXGroup.md +120 -16
  16. package/bundle/components/CheckboxYGroup.md +88 -15
  17. package/bundle/components/CollapsibleTree.md +581 -0
  18. package/bundle/components/CollapsibleTreeExtended.md +418 -0
  19. package/bundle/components/EmptyView.md +133 -15
  20. package/bundle/components/FooterPage.md +203 -0
  21. package/bundle/components/Gap.md +115 -57
  22. package/bundle/components/HeaderPage.md +226 -0
  23. package/bundle/components/HelpBox.md +231 -72
  24. package/bundle/components/ImageGallery.md +423 -0
  25. package/bundle/components/ImageGalleryExtended.md +606 -0
  26. package/bundle/components/List.md +194 -186
  27. package/bundle/components/ListItem.md +251 -0
  28. package/bundle/components/ListItemControlsButton.md +103 -0
  29. package/bundle/components/ListItemControlsButtonDropdown.md +107 -0
  30. package/bundle/components/ListItemSelectable.md +99 -0
  31. package/bundle/components/ListItemTable.md +390 -0
  32. package/bundle/components/ListMaster.md +877 -156
  33. package/bundle/components/ListMasterFooter.md +80 -0
  34. package/bundle/components/ListMasterHeader.md +86 -0
  35. package/bundle/components/ListSortable.md +153 -0
  36. package/bundle/components/ListSortableItem.md +175 -0
  37. package/bundle/components/ModalWindow.md +427 -237
  38. package/bundle/components/MonthYearField.md +145 -109
  39. package/bundle/components/Notification.md +625 -155
  40. package/bundle/components/Overlay.md +271 -170
  41. package/bundle/components/Page.md +283 -186
  42. package/bundle/components/Pagination.md +206 -229
  43. package/bundle/components/SliderExtended.md +285 -0
  44. package/bundle/guides/codestyle.md +38 -11
  45. package/bundle/guides/commits.md +1 -2
  46. package/bundle/guides/context.md +34 -30
  47. package/bundle/guides/stories.md +110 -40
  48. package/bundle/guides/template.md +3 -7
  49. package/bundle/guides/tests.md +6 -2
  50. package/bundle/manifest.json +194 -24
  51. package/bundle/release-notes/1.26.0.mdx +33 -2
  52. package/bundle/release-notes/1.27.0.mdx +43 -0
  53. package/bundle/release-notes/1.28.0.mdx +25 -0
  54. package/bundle/release-notes/1.29.0.mdx +47 -0
  55. package/bundle/release-notes/1.30.0.mdx +56 -0
  56. package/bundle/release-notes/1.31.0.mdx +52 -0
  57. package/bundle/release-notes/1.32.0.mdx +35 -0
  58. package/bundle/release-notes/1.33.0.mdx +61 -0
  59. package/bundle/release-notes/1.34.0.mdx +35 -0
  60. package/bundle/release-notes/1.35.0.mdx +21 -0
  61. package/bundle/release-notes/1.35.1.mdx +11 -0
  62. package/bundle/release-notes/1.36.0.mdx +21 -0
  63. package/bundle/release-notes/1.37.0.mdx +30 -0
  64. package/dist/index.js +2 -0
  65. package/dist/index.js.map +1 -1
  66. package/package.json +1 -1
@@ -1,67 +1,140 @@
1
1
  ---
2
2
  component: CheckboxYGroup
3
3
  category: Inputs
4
- figma-node: ""
5
- figma-file: ""
6
4
  related: [Checkbox, CheckboxXGroup]
7
5
  tokens: []
8
- stories: stories/Checkbox/Checkbox.stories.tsx
6
+ stories: stories/CheckboxYGroup/CheckboxYGroup.stories.tsx
9
7
  version: "1.0"
10
8
  ---
11
9
 
12
10
  # CheckboxYGroup
13
11
 
14
12
  ## Назначение
15
- Компонент-группа для компоновки чекбоксов с направлением по оси `Y`.
16
- Используется как контейнер для нескольких `Checkbox`, когда нужно разложить их вертикально.
13
+
14
+ Компонент-группа для компоновки чекбоксов с направлением по оси `Y`. Используется как контейнер для нескольких `Checkbox`, когда нужно разложить их вертикально.
15
+
16
+ Используй когда: несколько связанных чекбоксов нужно разместить вертикально.
17
+ Не используй когда: чекбоксы должны идти в строку — используй `CheckboxXGroup`.
17
18
 
18
19
  ---
19
20
 
20
21
  ## Варианты и props
22
+
23
+ ### Обязательные props
24
+
25
+ Обязательных custom-props нет.
26
+
21
27
  ### Опциональные props
28
+
22
29
  | Prop | Тип | По умолчанию | Описание |
23
30
  |---|---|---|---|
24
31
  | `children` | `React.ReactNode` | — | Внутри обычно рендерятся `Checkbox` (или компоненты, использующие `Checkbox`). |
25
32
  | `...divAttributes` | `React.HTMLAttributes<HTMLDivElement>` | — | Все стандартные HTML-атрибуты для корневого элемента. |
26
33
 
27
- ---
34
+ ### Ограничения использования
28
35
 
29
- ## Ключевые особенности реализации
30
- - Корневой элемент: `<div role="group">`.
31
- - Разметка: `inline-flex` и `flex-flow: column wrap`.
36
+ - Корневой элемент — `<div role="group">`, разметка построена на `inline-flex` и `flex-flow: column wrap`.
32
37
 
33
38
  ---
34
39
 
35
- ## Accessibility
36
- - `role="group"` описывает группу взаимосвязанных контролов.
37
- - Семантика чекбоксов остается нативной на уровне `Checkbox` внутри группы.
40
+ ## Дизайн-токены
41
+
42
+ Компонент не использует собственных CSS-переменных. Все визуальные стили наследуются от `Checkbox`.
38
43
 
39
44
  ---
40
45
 
41
46
  ## Инварианты
47
+
42
48
  - `forwardRef` обязателен и должен указывать на корневой `<div>`.
43
49
  - Корневой DOM-элемент компонента — `<div>`, роль зафиксирована как `role="group"`.
44
50
 
45
51
  ---
46
52
 
53
+ ## Accessibility
54
+
55
+ - `role="group"` описывает группу взаимосвязанных контролов.
56
+ - Семантика чекбоксов остаётся нативной на уровне `Checkbox` внутри группы.
57
+
58
+ ---
59
+
47
60
  ## Связанные компоненты
61
+
48
62
  - `Checkbox` — базовый чекбокс, обычно используется внутри `CheckboxYGroup`.
49
63
  - `CheckboxXGroup` — аналогичная группа, но с направлением по оси `X`.
50
64
 
51
65
  ---
52
66
 
53
67
  ## Stories
54
- `stories/Checkbox/Checkbox.stories.tsx`
55
- Файлы примеров: `stories/Checkbox/examples/`
68
+
69
+ Основные истории: `stories/CheckboxYGroup/CheckboxYGroup.stories.tsx`
70
+ Файлы примеров: `stories/CheckboxYGroup/examples/`
56
71
 
57
72
  | Story | Example file | Что демонстрирует |
58
73
  |---|---|---|
59
- | `YGroup` | `YGroupExample.tsx` | Группа по оси Y |
74
+ | `Default` | `DefaultExample.tsx` | Группа по оси Y |
75
+ | `CheckboxSizes` | `SizesExample.tsx` | Группа чекбоксов разных размеров |
60
76
 
61
77
  ---
62
78
 
63
79
  ## История изменений
80
+
64
81
  | Дата | Изменение |
65
82
  |---|---|
66
83
  | 2026-04-16 | Приведение `CheckboxYGroup` к AI-ready: добавлен `forwardRef`, типизирован `children`, созданы AI-документ и инварианты. |
84
+ | 2026-04-27 | Приведён в соответствие с `docs/ai/template-ai.md`: убрана секция «Ключевые особенности реализации» (содержимое перенесено в `Ограничения использования`), переставлены секции, добавлена колонка `Example file` и пустой раздел `Дизайн-токены`. |
85
+
86
+ ---
87
+
88
+ ## Примеры использования
89
+
90
+ ### Default
91
+
92
+ `stories/CheckboxYGroup/examples/DefaultExample.tsx`
93
+
94
+ ```tsx
95
+ import React from "react";
96
+ import { Checkbox, CheckboxYGroup } from "@sberbusiness/triplex-next";
97
+
98
+ export const DefaultExample = () => (
99
+ <CheckboxYGroup>
100
+ {[1, 2, 3].map((value) => (
101
+ <Checkbox key={value} name="checkbox-y-group" value={value}>
102
+ Checkbox text
103
+ </Checkbox>
104
+ ))}
105
+ </CheckboxYGroup>
106
+ );
107
+ ```
108
+
109
+ ### CheckboxSizes
110
+
111
+ `stories/CheckboxYGroup/examples/SizesExample.tsx`
112
+
113
+ ```tsx
114
+ import React from "react";
115
+ import { Checkbox, CheckboxYGroup, EComponentSize } from "@sberbusiness/triplex-next";
116
+
117
+ const sizes = [
118
+ { label: "SM", size: EComponentSize.SM },
119
+ { label: "MD", size: EComponentSize.MD },
120
+ { label: "LG", size: EComponentSize.LG },
121
+ ] as const;
122
+
123
+ export const SizesExample = () => (
124
+ <div style={{ display: "flex", flexDirection: "column", gap: "24px" }}>
125
+ {sizes.map(({ label, size }) => (
126
+ <div key={label}>
127
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>{label}</div>
128
+ <CheckboxYGroup aria-labelledby="checkbox-y-group-label">
129
+ {[1, 2, 3].map((value) => (
130
+ <Checkbox key={value} name={`checkbox-y-group-${label}`} value={value} size={size}>
131
+ Checkbox text
132
+ </Checkbox>
133
+ ))}
134
+ </CheckboxYGroup>
135
+ </div>
136
+ ))}
137
+ </div>
138
+ );
139
+ ```
67
140