@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
@@ -443,3 +443,61 @@ weekday на английском.
443
443
  | Дата | Изменение |
444
444
  |---|---|
445
445
  | 2026-04-18 | Создан документ |
446
+
447
+ ---
448
+
449
+ ## Примеры использования
450
+
451
+ ### Default
452
+
453
+ `stories/Calendar/examples/DefaultExample.tsx`
454
+
455
+ ```tsx
456
+ import moment from "moment";
457
+ import React, { useState } from "react";
458
+ import { Calendar } from "@sberbusiness/triplex-next";
459
+
460
+ export const DefaultExample = () => {
461
+ const [pickedDate, setPickedDate] = useState(moment());
462
+
463
+ return <Calendar pickedDate={pickedDate} onDateChange={setPickedDate} />;
464
+ };
465
+ ```
466
+
467
+ ### PickTypes
468
+
469
+ `stories/Calendar/examples/PickTypesExample.tsx`
470
+
471
+ ```tsx
472
+ import moment from "moment";
473
+ import React, { useState } from "react";
474
+ import { Calendar, ECalendarPickType } from "@sberbusiness/triplex-next";
475
+
476
+ export const PickTypesExample = () => {
477
+ const initialDate = moment("2024-01-15");
478
+ const [pickedDateDatePick, setPickedDateDatePick] = useState(initialDate);
479
+ const [pickedDateMonthYearPick, setPickedDateMonthYearPick] = useState(initialDate);
480
+
481
+ return (
482
+ <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
483
+ <div>
484
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>DATEPICK</div>
485
+ <Calendar
486
+ pickType={ECalendarPickType.datePick}
487
+ pickedDate={pickedDateDatePick}
488
+ onDateChange={setPickedDateDatePick}
489
+ />
490
+ </div>
491
+ <div>
492
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>MONTHYEARPICK</div>
493
+ <Calendar
494
+ pickType={ECalendarPickType.monthYearPick}
495
+ pickedDate={pickedDateMonthYearPick}
496
+ onDateChange={setPickedDateMonthYearPick}
497
+ />
498
+ </div>
499
+ </div>
500
+ );
501
+ };
502
+ ```
503
+
@@ -1,8 +1,6 @@
1
1
  ---
2
2
  component: Checkbox
3
3
  category: Inputs
4
- figma-node: ""
5
- figma-file: ""
6
4
  related: [CheckboxXGroup, CheckboxYGroup, CheckboxTree, CheckboxTreeExtended]
7
5
  tokens:
8
6
  - --triplex-next-Checkbox-Background_Default
@@ -26,7 +24,8 @@ version: "1.0"
26
24
  # Checkbox
27
25
 
28
26
  ## Назначение
29
- Нативный чекбокс в обертке `<label>`, который поддерживает визуальные состояния (default/checked/disabled/focus) и режим частичного выбора через `bulk`.
27
+
28
+ Нативный чекбокс в обёртке `<label>`, который поддерживает визуальные состояния (default / checked / disabled / focus) и режим частичного выбора через `bulk`.
30
29
 
31
30
  Используй когда: нужен чекбокс с текстовой подписью (`children`) и стандартным поведением `<input type="checkbox">`.
32
31
  Не используй когда: нужен сложный многошаговый выбор или компонент с нестандартной семантикой (тогда лучше другой control).
@@ -34,93 +33,127 @@ version: "1.0"
34
33
  ---
35
34
 
36
35
  ## Варианты и props
36
+
37
+ ### Обязательные props
38
+
39
+ Обязательных custom-props нет.
40
+
37
41
  ### Опциональные props
42
+
38
43
  | Prop | Тип | По умолчанию | Описание |
39
44
  |---|---|---|---|
40
45
  | `checked` | `boolean` | — | Состояние чекбокса (controlled). Передаётся через стандартные props `<input>`. |
41
46
  | `defaultChecked` | `boolean` | — | Состояние чекбокса (uncontrolled). Передаётся через стандартные props `<input>`. |
42
47
  | `disabled` | `boolean` | `false` | Блокирует взаимодействие и меняет визуальное состояние. |
43
- | `bulk` | `boolean` | `false` | Влияет на отображаемую иконку (используется bulk-иконка), при этом видимость checkmark всё равно определяется состоянием `checked`. |
48
+ | `bulk` | `boolean` | `false` | Влияет на отображаемую иконку (используется bulk-иконка). Видимость checkmark всё равно определяется состоянием `checked`. |
44
49
  | `size` | `EComponentSize` | `EComponentSize.MD` | Размер: `SM` / `MD` / `LG`. |
45
50
  | `children` | `React.ReactNode` | — | Контент лейбла рядом с чекбоксом. Если `children` нет — класс `.nonempty` не применяется. |
46
51
  | `labelAttributes` | `React.LabelHTMLAttributes<HTMLLabelElement>` | — | Дополнительные HTML-атрибуты для корневого `<label>` (например, `className`, `onFocus`). |
47
- | `...inputAttributes` | `Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "size">` | — | Все стандартные атрибуты `<input type="checkbox">` (включая `name`, `onChange`, `aria-label` и т.д.). |
48
-
49
- ---
52
+ | `...inputAttributes` | `Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" \| "size">` | — | Все стандартные атрибуты `<input type="checkbox">` (включая `name`, `onChange`, `aria-label` и т.д.). |
50
53
 
51
- ## Ключевые особенности реализации
52
- ### Ref forwarding
53
- `ref` прокидывается на внутренний `<input type="checkbox">`.
54
+ ### Ограничения использования
54
55
 
55
- ### Иконка
56
- - `bulk=false` — отрисовывается обычная checkmark-иконка.
57
- - `bulk=true` — отрисовывается bulk-иконка.
58
-
59
- ### Структура DOM
60
- Компонент рендерит:
61
- 1. корневой `<label>`
62
- 2. `<input type="checkbox">`
63
- 3. декоративные `<span>`/`svg` для отрисовки фона и галочки
56
+ - DOM-структура фиксирована: корневой `<label>` → `<input type="checkbox">` → декоративные `<span>` / `<svg>` для отрисовки фона и галочки.
57
+ - `ref` прокидывается на внутренний `<input type="checkbox">`.
64
58
 
65
59
  ---
66
60
 
67
- ## Accessibility
68
- Компонент использует нативный `<input type="checkbox">`, поэтому поддерживает стандартную клавиатурную навигацию (Tab + Space) и семантику формы.
61
+ ## Дизайн-токены
69
62
 
70
- Библиотека мультиязычная: текст `aria-label`/`title` не захардкожен в компоненте. При необходимости потребитель передаёт `aria-*` через `...inputAttributes`.
63
+ ```
64
+ --triplex-next-Checkbox-Background_Default
65
+ --triplex-next-Checkbox-BorderColor_Default
66
+ --triplex-next-Checkbox-Checkmark_Fill_Default
67
+ --triplex-next-Checkbox-Background_Hover
68
+ --triplex-next-Checkbox-BorderColor_Hover
69
+ --triplex-next-Checkbox-Background_Checked_Default
70
+ --triplex-next-Checkbox-BorderColor_Checked_Default
71
+ --triplex-next-Checkbox-Background_Disabled
72
+ --triplex-next-Checkbox-BorderColor_Disabled
73
+ --triplex-next-Checkbox-Background_Checked_Disabled
74
+ --triplex-next-Checkbox-BorderColor_Checked_Disabled
75
+ --triplex-next-Checkbox-Checkmark_Fill_Disabled
76
+ --triplex-next-Checkbox-BorderColor_Focus
77
+ --triplex-next-Checkbox-Background_Checked_Hover
78
+ ```
71
79
 
72
80
  ---
73
81
 
74
82
  ## Инварианты
83
+
75
84
  - `forwardRef` на компоненте обязателен и должен указывать на `<input>`.
76
85
  - Корневой DOM-элемент компонента — `<label>`, внутри которого находится `<input>`.
77
86
  - `className` и `size` — публичные части внешнего контрактного API: не менять семантику без согласования.
78
87
 
79
88
  ---
80
89
 
81
- ## Дизайн-токены
82
- Компонент использует CSS-переменные:
83
- `--triplex-next-Checkbox-Background_Default`,
84
- `--triplex-next-Checkbox-BorderColor_Default`,
85
- `--triplex-next-Checkbox-Checkmark_Fill_Default`,
86
- `--triplex-next-Checkbox-Background_Hover`,
87
- `--triplex-next-Checkbox-BorderColor_Hover`,
88
- `--triplex-next-Checkbox-Background_Checked_Default`,
89
- `--triplex-next-Checkbox-BorderColor_Checked_Default`,
90
- `--triplex-next-Checkbox-Background_Disabled`,
91
- `--triplex-next-Checkbox-BorderColor_Disabled`,
92
- `--triplex-next-Checkbox-Background_Checked_Disabled`,
93
- `--triplex-next-Checkbox-BorderColor_Checked_Disabled`,
94
- `--triplex-next-Checkbox-Checkmark_Fill_Disabled`,
95
- `--triplex-next-Checkbox-BorderColor_Focus`,
96
- `--triplex-next-Checkbox-Background_Checked_Hover`.
90
+ ## Accessibility
91
+
92
+ - Компонент использует нативный `<input type="checkbox">`, поэтому поддерживает стандартную клавиатурную навигацию (Tab + Space) и семантику формы.
93
+ - Библиотека мультиязычная: текст `aria-label` / `title` не захардкожен в компоненте. При необходимости потребитель передаёт `aria-*` через `...inputAttributes`.
97
94
 
98
95
  ---
99
96
 
100
97
  ## Связанные компоненты
98
+
101
99
  - `CheckboxXGroup` — группировка чекбоксов по оси X.
102
100
  - `CheckboxYGroup` — группировка чекбоксов по оси Y.
103
- - `CheckboxTree` — декларативное дерево чекбоксов (обертка над `CheckboxTreeExtended`), поддерживает bulk-логику и распространение состояния checked по родителям/детям.
104
- - `CheckboxTreeExtended` — расширенное дерево чекбоксов на базе `CollapsableTree` с Node/Checkbox подкомпонентами (использует нативный `Checkbox` внутри для каждого узла).
101
+ - `CheckboxTree` — декларативное дерево чекбоксов (обёртка над `CheckboxTreeExtended`), поддерживает bulk-логику и распространение состояния checked по родителям/детям.
102
+ - `CheckboxTreeExtended` — расширенное дерево чекбоксов на базе `CollapsibleTreeExtended` с `Node` / `Checkbox` подкомпонентами (использует нативный `Checkbox` внутри для каждого узла).
105
103
 
106
104
  ---
107
105
 
108
106
  ## Stories
109
- `stories/Checkbox/Checkbox.stories.tsx`
107
+
108
+ Основные истории: `stories/Checkbox/Checkbox.stories.tsx`
110
109
  Файлы примеров: `stories/Checkbox/examples/`
111
110
 
112
111
  | Story | Example file | Что демонстрирует |
113
112
  |---|---|---|
114
113
  | `Playground` | `PlaygroundExample.tsx` | Интерактивный контроль основных props |
115
114
  | `Default` | `DefaultExample.tsx` | Минимальное использование |
116
- | `Sizes` | `SizesExample.tsx` | Размеры SM / MD / LG |
117
- | `XGroup` | `XGroupExample.tsx` | Группа по оси X |
118
- | `YGroup` | `YGroupExample.tsx` | Группа по оси Y |
115
+ | `Sizes` | `SizesExample.tsx` | Размеры `SM` / `MD` / `LG` |
119
116
 
120
117
  ---
121
118
 
122
119
  ## История изменений
120
+
123
121
  | Дата | Изменение |
124
122
  |---|---|
125
123
  | 2026-04-16 | Приведение `Checkbox` к AI-ready: соблюдены правила `docs/ai/codestyle.md`, добавлена AI-документация и unit-тест на передачу `className` корневому `label`. |
124
+ | 2026-04-27 | Приведён в соответствие с `docs/ai/template-ai.md`: убрана секция «Ключевые особенности реализации» (содержимое перенесено в `Ограничения использования`), переставлены секции (Accessibility после Инвариантов), добавлена колонка `Example file`. |
125
+
126
+ ---
127
+
128
+ ## Примеры использования
129
+
130
+ ### Default
131
+
132
+ `stories/Checkbox/examples/DefaultExample.tsx`
133
+
134
+ ```tsx
135
+ import React from "react";
136
+ import { Checkbox } from "@sberbusiness/triplex-next";
137
+
138
+ export const DefaultExample = () => <Checkbox>Checkbox label</Checkbox>;
139
+ ```
140
+
141
+ ### Sizes
142
+
143
+ `stories/Checkbox/examples/SizesExample.tsx`
144
+
145
+ ```tsx
146
+ import React from "react";
147
+ import { Checkbox, EComponentSize, Gap } from "@sberbusiness/triplex-next";
148
+
149
+ export const SizesExample = () => (
150
+ <>
151
+ <Checkbox size={EComponentSize.SM}>SM</Checkbox>
152
+ <Gap size={16} />
153
+ <Checkbox size={EComponentSize.MD}>MD</Checkbox>
154
+ <Gap size={16} />
155
+ <Checkbox size={EComponentSize.LG}>LG</Checkbox>
156
+ </>
157
+ );
158
+ ```
126
159
 
@@ -278,3 +278,64 @@ onChange/bulk/checked. **Не упрощать** — CheckboxTreeExtended пол
278
278
  | Дата | Изменение |
279
279
  |---|---|
280
280
  | 2026-04-18 | Создан документ |
281
+
282
+ ---
283
+
284
+ ## Примеры использования
285
+
286
+ ### Default
287
+
288
+ `stories/CheckboxTree/examples/DefaultExample.tsx`
289
+
290
+ ```tsx
291
+ import React, { useState } from "react";
292
+ import { CheckboxTree, ICheckboxTreeCheckboxData } from "@sberbusiness/triplex-next";
293
+
294
+ const SAMPLE: ICheckboxTreeCheckboxData[] = [
295
+ { id: "1", label: "Группа 1", checked: false, children: [{ id: "1-1", label: "Значение 1-1", checked: false }] },
296
+ { id: "2", label: "Группа 2", checked: false },
297
+ ];
298
+
299
+ export const DefaultExample = () => {
300
+ const [checkboxes, setCheckboxes] = useState<ICheckboxTreeCheckboxData[]>(SAMPLE);
301
+ return <CheckboxTree checkboxes={checkboxes} onChange={setCheckboxes} />;
302
+ };
303
+ ```
304
+
305
+ ### Sizes
306
+
307
+ `stories/CheckboxTree/examples/SizesExample.tsx`
308
+
309
+ ```tsx
310
+ import React, { useState } from "react";
311
+ import { CheckboxTree, Col, EComponentSize, ICheckboxTreeCheckboxData, Row } from "@sberbusiness/triplex-next";
312
+
313
+ const createData = (): ICheckboxTreeCheckboxData[] => [
314
+ { id: "1", label: "Группа 1", checked: false, children: [{ id: "1-1", label: "Значение 1-1", checked: false }] },
315
+ { id: "2", label: "Группа 2", checked: false },
316
+ ];
317
+
318
+ export const SizesExample = () => {
319
+ const [sm, setSm] = useState<ICheckboxTreeCheckboxData[]>(createData());
320
+ const [md, setMd] = useState<ICheckboxTreeCheckboxData[]>(createData());
321
+ const [lg, setLg] = useState<ICheckboxTreeCheckboxData[]>(createData());
322
+
323
+ return (
324
+ <Row>
325
+ <Col size={4}>
326
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>SM</div>
327
+ <CheckboxTree checkboxes={sm} onChange={setSm} size={EComponentSize.SM} />
328
+ </Col>
329
+ <Col size={4}>
330
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>MD</div>
331
+ <CheckboxTree checkboxes={md} onChange={setMd} />
332
+ </Col>
333
+ <Col size={4}>
334
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>LG</div>
335
+ <CheckboxTree checkboxes={lg} onChange={setLg} size={EComponentSize.LG} />
336
+ </Col>
337
+ </Row>
338
+ );
339
+ };
340
+ ```
341
+
@@ -319,3 +319,117 @@ margin). Кандидат на токенизацию.
319
319
  | Дата | Изменение |
320
320
  |---|---|
321
321
  | 2026-04-18 | Создан документ |
322
+
323
+ ---
324
+
325
+ ## Примеры использования
326
+
327
+ ### Default
328
+
329
+ `stories/CheckboxTreeExtended/examples/DefaultExample.tsx`
330
+
331
+ ```tsx
332
+ import React from "react";
333
+ import { CheckboxTreeExtended, EComponentSize } from "@sberbusiness/triplex-next";
334
+
335
+ type CheckboxNode = { id: string; label: string; checked: boolean; bulk?: boolean; children?: CheckboxNode[] };
336
+
337
+ const INITIAL: CheckboxNode[] = [
338
+ { id: "1", label: "Группа 1", checked: false, children: [{ id: "1-1", label: "Значение 1-1", checked: false }] },
339
+ { id: "2", label: "Группа 2", checked: false },
340
+ ];
341
+
342
+ export const DefaultExample = ({ size = EComponentSize.MD }: { size?: EComponentSize }) => {
343
+ const [checkboxes, setCheckboxes] = React.useState<CheckboxNode[]>(INITIAL);
344
+
345
+ const onChange = (target: CheckboxNode) => (event: React.ChangeEvent<HTMLInputElement>) => {
346
+ target.checked = event.target.checked;
347
+ setCheckboxes([...checkboxes]);
348
+ };
349
+
350
+ const renderNode = (node: CheckboxNode) => (
351
+ <CheckboxTreeExtended.Node
352
+ id={node.id}
353
+ key={node.id}
354
+ checkbox={(props) => (
355
+ <CheckboxTreeExtended.Checkbox
356
+ {...props}
357
+ onChange={onChange(node)}
358
+ bulk={node.bulk}
359
+ checked={node.checked}
360
+ >
361
+ {node.label}
362
+ </CheckboxTreeExtended.Checkbox>
363
+ )}
364
+ >
365
+ {node.children?.map((child) => renderNode(child))}
366
+ </CheckboxTreeExtended.Node>
367
+ );
368
+
369
+ return <CheckboxTreeExtended size={size}>{checkboxes.map((node) => renderNode(node))}</CheckboxTreeExtended>;
370
+ };
371
+ ```
372
+
373
+ ### Sizes
374
+
375
+ `stories/CheckboxTreeExtended/examples/SizesExample.tsx`
376
+
377
+ ```tsx
378
+ import React from "react";
379
+ import { CheckboxTreeExtended, Col, EComponentSize, Row } from "@sberbusiness/triplex-next";
380
+
381
+ type CheckboxNode = { id: string; label: string; checked: boolean; bulk?: boolean; children?: CheckboxNode[] };
382
+
383
+ const INITIAL: CheckboxNode[] = [
384
+ { id: "1", label: "Группа 1", checked: false, children: [{ id: "1-1", label: "Значение 1-1", checked: false }] },
385
+ { id: "2", label: "Группа 2", checked: false },
386
+ ];
387
+
388
+ const TreeBySize = ({ size = EComponentSize.MD }: { size?: EComponentSize }) => {
389
+ const [checkboxes, setCheckboxes] = React.useState<CheckboxNode[]>(INITIAL);
390
+
391
+ const onChange = (target: CheckboxNode) => (event: React.ChangeEvent<HTMLInputElement>) => {
392
+ target.checked = event.target.checked;
393
+ setCheckboxes([...checkboxes]);
394
+ };
395
+
396
+ const renderNode = (node: CheckboxNode) => (
397
+ <CheckboxTreeExtended.Node
398
+ id={node.id}
399
+ key={node.id}
400
+ checkbox={(props) => (
401
+ <CheckboxTreeExtended.Checkbox
402
+ {...props}
403
+ onChange={onChange(node)}
404
+ bulk={node.bulk}
405
+ checked={node.checked}
406
+ >
407
+ {node.label}
408
+ </CheckboxTreeExtended.Checkbox>
409
+ )}
410
+ >
411
+ {node.children?.map((child) => renderNode(child))}
412
+ </CheckboxTreeExtended.Node>
413
+ );
414
+
415
+ return <CheckboxTreeExtended size={size}>{checkboxes.map((node) => renderNode(node))}</CheckboxTreeExtended>;
416
+ };
417
+
418
+ export const SizesExample = () => (
419
+ <Row>
420
+ <Col size={4}>
421
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>SM</div>
422
+ <TreeBySize size={EComponentSize.SM} />
423
+ </Col>
424
+ <Col size={4}>
425
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>MD</div>
426
+ <TreeBySize size={EComponentSize.MD} />
427
+ </Col>
428
+ <Col size={4}>
429
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>LG</div>
430
+ <TreeBySize size={EComponentSize.LG} />
431
+ </Col>
432
+ </Row>
433
+ );
434
+ ```
435
+
@@ -1,68 +1,172 @@
1
1
  ---
2
2
  component: CheckboxXGroup
3
3
  category: Inputs
4
- figma-node: ""
5
- figma-file: ""
6
4
  related: [Checkbox]
7
5
  tokens: []
8
- stories: stories/Checkbox/Checkbox.stories.tsx
6
+ stories: stories/CheckboxXGroup/CheckboxXGroup.stories.tsx
9
7
  version: "1.0"
10
8
  ---
11
9
 
12
10
  # CheckboxXGroup
13
11
 
14
12
  ## Назначение
15
- Компонент-группа для компоновки чекбоксов с направлением по оси `X`.
16
- Используется как контейнер для нескольких `Checkbox`, когда нужно разложить их в строку с переносами.
13
+
14
+ Компонент-группа для компоновки чекбоксов с направлением по оси `X`. Используется как контейнер для нескольких `Checkbox`, когда нужно разложить их в строку с переносами.
15
+
16
+ Используй когда: несколько связанных чекбоксов нужно разместить в строку.
17
+ Не используй когда: чекбоксы должны идти вертикально — используй `CheckboxYGroup`.
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
  | `indent` | `TIndentSize` | `12` | Отступы/зазоры между чекбоксами в группе. Возможные значения: `12, 16, 20, 24, 28, 32`. |
25
32
  | `children` | `React.ReactNode` | — | Внутри обычно рендерятся `Checkbox`. |
26
33
  | `...divAttributes` | `React.HTMLAttributes<HTMLDivElement>` | — | Все стандартные HTML-атрибуты для корневого элемента. |
27
34
 
28
- ---
35
+ ### Ограничения использования
29
36
 
30
- ## Ключевые особенности реализации
31
- - Корневой элемент: `<div role="group">`.
32
- - Разметка: `inline-flex` и `flex-flow: row wrap`.
33
- - `indent` управляет применением LESS-класса `indent-{n}` и задает отрицательные/положительные маргины для выравнивания сетки.
37
+ - Корневой элемент — `<div role="group">`, разметка построена на `inline-flex` и `flex-flow: row wrap`.
38
+ - `indent` управляет применением LESS-класса `indent-{n}` и задаёт отрицательные/положительные маргины для выравнивания сетки.
34
39
 
35
40
  ---
36
41
 
37
- ## Accessibility
38
- - `role="group"` описывает группу взаимосвязанных контролов.
39
- - Семантика чекбоксов остается нативной на уровне `Checkbox` внутри группы.
42
+ ## Дизайн-токены
43
+
44
+ Компонент не использует собственных CSS-переменных. Все визуальные стили наследуются от `Checkbox`.
40
45
 
41
46
  ---
42
47
 
43
48
  ## Инварианты
49
+
44
50
  - `forwardRef` обязателен и должен указывать на корневой `<div>`.
45
51
  - Корневой DOM-элемент компонента — `<div>`, роль зафиксирована как `role="group"`.
46
52
 
47
53
  ---
48
54
 
55
+ ## Accessibility
56
+
57
+ - `role="group"` описывает группу взаимосвязанных контролов.
58
+ - Семантика чекбоксов остаётся нативной на уровне `Checkbox` внутри группы.
59
+
60
+ ---
61
+
49
62
  ## Связанные компоненты
63
+
50
64
  - `Checkbox` — базовый чекбокс, обычно используется внутри `CheckboxXGroup`.
65
+ - `CheckboxYGroup` — аналогичная группа, но с направлением по оси `Y`.
51
66
 
52
67
  ---
53
68
 
54
69
  ## Stories
55
- `stories/Checkbox/Checkbox.stories.tsx`
56
- Файлы примеров: `stories/Checkbox/examples/`
70
+
71
+ Основные истории: `stories/CheckboxXGroup/CheckboxXGroup.stories.tsx`
72
+ Файлы примеров: `stories/CheckboxXGroup/examples/`
57
73
 
58
74
  | Story | Example file | Что демонстрирует |
59
75
  |---|---|---|
60
- | `XGroup` | `XGroupExample.tsx` | Группа по оси X |
76
+ | `Playground` | `PlaygroundExample.tsx` | Интерактивный контроль `indent` |
77
+ | `Default` | `DefaultExample.tsx` | Группа по оси X |
78
+ | `CheckboxSizes` | `SizesExample.tsx` | Группа чекбоксов разных размеров |
79
+ | `Indents` | `IndentsExample.tsx` | Различные значения отступа |
61
80
 
62
81
  ---
63
82
 
64
83
  ## История изменений
84
+
65
85
  | Дата | Изменение |
66
86
  |---|---|
67
87
  | 2026-04-16 | Приведение `CheckboxXGroup` к AI-ready: добавлен `forwardRef`, типизирован `children`, созданы AI-документ и инварианты. |
88
+ | 2026-04-27 | Приведён в соответствие с `docs/ai/template-ai.md`: убрана секция «Ключевые особенности реализации» (содержимое перенесено в `Ограничения использования`), переставлены секции, добавлена колонка `Example file` и пустой раздел `Дизайн-токены`. |
89
+
90
+ ---
91
+
92
+ ## Примеры использования
93
+
94
+ ### Default
95
+
96
+ `stories/CheckboxXGroup/examples/DefaultExample.tsx`
97
+
98
+ ```tsx
99
+ import React from "react";
100
+ import { Checkbox, CheckboxXGroup } from "@sberbusiness/triplex-next";
101
+
102
+ export const DefaultExample = () => (
103
+ <CheckboxXGroup>
104
+ {[1, 2, 3].map((value) => (
105
+ <Checkbox key={value} name="checkbox-x-group" value={value}>
106
+ Checkbox text
107
+ </Checkbox>
108
+ ))}
109
+ </CheckboxXGroup>
110
+ );
111
+ ```
112
+
113
+ ### CheckboxSizes
114
+
115
+ `stories/CheckboxXGroup/examples/SizesExample.tsx`
116
+
117
+ ```tsx
118
+ import React from "react";
119
+ import { Checkbox, CheckboxXGroup, EComponentSize } from "@sberbusiness/triplex-next";
120
+
121
+ const sizes = [
122
+ { label: "SM", size: EComponentSize.SM },
123
+ { label: "MD", size: EComponentSize.MD },
124
+ { label: "LG", size: EComponentSize.LG },
125
+ ] as const;
126
+
127
+ export const SizesExample = () => (
128
+ <div style={{ display: "flex", flexDirection: "column", gap: "24px" }}>
129
+ {sizes.map(({ label, size }) => (
130
+ <div key={label}>
131
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>{label}</div>
132
+ <CheckboxXGroup>
133
+ {[1, 2, 3].map((value) => (
134
+ <Checkbox key={value} name={`checkbox-x-group-${label}`} value={value} size={size}>
135
+ Checkbox text
136
+ </Checkbox>
137
+ ))}
138
+ </CheckboxXGroup>
139
+ </div>
140
+ ))}
141
+ </div>
142
+ );
143
+ ```
144
+
145
+ ### Indents
146
+
147
+ `stories/CheckboxXGroup/examples/IndentsExample.tsx`
148
+
149
+ ```tsx
150
+ import React from "react";
151
+ import { Checkbox, CheckboxXGroup } from "@sberbusiness/triplex-next";
152
+
153
+ const indents = [12, 16, 20, 24, 28, 32] as const;
154
+
155
+ export const IndentsExample = () => (
156
+ <div style={{ display: "flex", flexDirection: "column", gap: "24px" }}>
157
+ {indents.map((indent) => (
158
+ <div key={indent}>
159
+ <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>{indent}px</div>
160
+ <CheckboxXGroup indent={indent}>
161
+ {[1, 2, 3, 4].map((value) => (
162
+ <Checkbox key={value} name={`checkbox-x-group-${indent}`} value={value}>
163
+ Checkbox text
164
+ </Checkbox>
165
+ ))}
166
+ </CheckboxXGroup>
167
+ </div>
168
+ ))}
169
+ </div>
170
+ );
171
+ ```
68
172