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

package/README.md

@@ -38,12 +38,13 @@ MCP-сервер для дизайн-системы Triplex. Предостав
 
 ## Доступные tools
 
-| Tool                                | Описание                                                                                                      |
-| ----------------------------------- | ------------------------------------------------------------------------------------------------------------- |
-| `list_components`                   | Список всех компонентов с кратким описанием и флагом `ai_ready`                                               |
-| `get_component(name)`               | Полная документация компонента: props, токены, примеры, ограничения                                           |
-| `get_tokens(component?)`            | Дизайн-токены — все или для конкретного компонента                                                            |
-| `list_icons(query?, size?, limit?)` | Иконки из `@sberbusiness/icons-next` с фильтрами по подстроке в имени и размеру (защита от галлюцинаций имён) |
+| Tool                                | Описание                                                                                                        |
+| ----------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `list_components`                   | Список всех компонентов с кратким описанием и флагом `ai_ready`                                                 |
+| `get_component(name)`               | Полная документация компонента: props, токены, примеры, ограничения                                             |
+| `get_tokens(component?, group?)`    | Дизайн-токены: индекс групп, токены компонента или группа целиком — с путями `Группа.Токен` и значениями тем    |
+| `list_icons(query?, size?, limit?)` | Иконки из `@sberbusiness/icons-next` с фильтрами по подстроке в имени и размеру (защита от галлюцинаций имён)   |
+| `get_guidelines`                    | Гайдлайны кодогенерации на Triplex для ИИ-агентов (правила `TPX-G-NN` из `docs/mcp/guidelines.md` triplex-next) |
 
 Флаг `ai_ready: true` означает, что у компонента есть полноценная AI-документация
 (`*-AI.md` с frontmatter, секциями и примерами). Для остальных компонентов сервер

package/bundle/components/AlertContext.md

@@ -3,10 +3,10 @@ component: AlertContext
 category: Alert
 related: [AlertProcess]
 tokens:
-    - --triplex-next-AlertContext-Info_Color
-    - --triplex-next-AlertContext-Warning_Color
-    - --triplex-next-AlertContext-Error_Color
-    - --triplex-next-AlertContext-System_Color
+  - AlertContext.Info_Color
+  - AlertContext.Warning_Color
+  - AlertContext.Error_Color
+  - AlertContext.System_Color
 stories: stories/Alerts/AlertContext.stories.tsx
 version: "1.0"
 ---
@@ -61,11 +61,14 @@ version: "1.0"
 
 ## Дизайн-токены
 
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/AlertContext.ts`.
+
 ```text
---triplex-next-AlertContext-Info_Color     // цвет текста для type=INFO
---triplex-next-AlertContext-Warning_Color  // цвет текста для type=WARNING
---triplex-next-AlertContext-Error_Color    // цвет текста для type=ERROR
---triplex-next-AlertContext-System_Color   // цвет текста для type=SYSTEM
+AlertContext.Info_Color     // цвет текста для type=INFO
+AlertContext.Warning_Color  // цвет текста для type=WARNING
+AlertContext.Error_Color    // цвет текста для type=ERROR
+AlertContext.System_Color   // цвет текста для type=SYSTEM
 ```
 
 Значения — в `src/components/DesignTokens/components/AlertContext.ts`. Обрати

package/bundle/components/AlertProcess.md

@@ -3,11 +3,11 @@ component: AlertProcess
 category: Alert
 related: [AlertContext]
 tokens:
-    - --triplex-next-AlertProcess-Info_Background
-    - --triplex-next-AlertProcess-Warning_Background
-    - --triplex-next-AlertProcess-Error_Background
-    - --triplex-next-AlertProcess-System_Background
-    - --triplex-next-AlertProcess-Feature_Background
+  - AlertProcess.Info_Background
+  - AlertProcess.Warning_Background
+  - AlertProcess.Error_Background
+  - AlertProcess.System_Background
+  - AlertProcess.Feature_Background
 stories: stories/Alerts/AlertProcess.stories.tsx
 version: "1.0"
 ---
@@ -69,12 +69,15 @@ ARIA-роли не выставляет.
 
 ## Дизайн-токены
 
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/AlertProcess.ts`.
+
 ```text
---triplex-next-AlertProcess-Info_Background     // фон для type=INFO
---triplex-next-AlertProcess-Warning_Background  // фон для type=WARNING
---triplex-next-AlertProcess-Error_Background    // фон для type=ERROR
---triplex-next-AlertProcess-System_Background   // фон для type=SYSTEM
---triplex-next-AlertProcess-Feature_Background  // фон для type=FEATURE
+AlertProcess.Info_Background     // фон для type=INFO
+AlertProcess.Warning_Background  // фон для type=WARNING
+AlertProcess.Error_Background    // фон для type=ERROR
+AlertProcess.System_Background   // фон для type=SYSTEM
+AlertProcess.Feature_Background  // фон для type=FEATURE
 ```
 
 Значения — в `src/components/DesignTokens/components/AlertProcess.ts`. Компонент

package/bundle/components/Badge.md

@@ -3,7 +3,7 @@ component: Badge
 category: Badge
 related: [Marker, Chip, DropdownListItem, DropdownMobileListItem, TabsLineItem, TabsExtendedTabButton, Text, Caption]
 tokens:
-  - --triplex-next-Badge-Background
+  - Badge.Background
 stories: stories/Badge/Badge.stories.tsx
 version: "1.0"
 ---
@@ -77,7 +77,7 @@ version: "1.0"
 
 ### Цвет и текст
 
-- Фон обоих компонентов — единственный токен `--triplex-next-Badge-Background`
+- Фон обоих компонентов — единственный токен `Badge.Background`
   (`ColorWarning.70` в обеих темах). Вариантов/статусов у компонента нет.
 - Цвет и размер текста задаёт потребитель, вкладывая внутрь `Text` / `Caption`
   с нужным `type` (в примерах — `EFontType.PRIMARY_INVERT`). Своей типографики
@@ -90,8 +90,11 @@ version: "1.0"
 
 ## Дизайн-токены
 
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Badge.ts`.
+
 ```text
---triplex-next-Badge-Background
+Badge.Background
 ```
 
 Один токен на всё семейство: фон `Badge` (`styles/Badge.module.less`) и цвет точки

package/bundle/components/Button.md

@@ -3,48 +3,48 @@ component: Button
 category: Buttons
 related: [ButtonIcon, ButtonDropdown, ButtonDropdownExtended]
 tokens:
-  - --triplex-next-Button-General_Background_Default
-  - --triplex-next-Button-General_Color_Default
-  - --triplex-next-Button-General_Background_Hover
-  - --triplex-next-Button-General_Color_Hover
-  - --triplex-next-Button-General_Background_Active
-  - --triplex-next-Button-General_Color_Active
-  - --triplex-next-Button-General_Shadow_Focus
-  - --triplex-next-Button-General_Background_Disabled
-  - --triplex-next-Button-General_Color_Disabled
-  - --triplex-next-Button-Secondary_Background_Default
-  - --triplex-next-Button-Secondary_Color_Default
-  - --triplex-next-Button-Secondary_Background_Hover
-  - --triplex-next-Button-Secondary_Color_Hover
-  - --triplex-next-Button-Secondary_Background_Active
-  - --triplex-next-Button-Secondary_Color_Active
-  - --triplex-next-Button-Secondary_Shadow_Focus
-  - --triplex-next-Button-Secondary_Background_Disabled
-  - --triplex-next-Button-Secondary_Color_Disabled
-  - --triplex-next-Button-SecondaryLight_Background_Default
-  - --triplex-next-Button-SecondaryLight_Color_Default
-  - --triplex-next-Button-SecondaryLight_Background_Hover
-  - --triplex-next-Button-SecondaryLight_Color_Hover
-  - --triplex-next-Button-SecondaryLight_Background_Active
-  - --triplex-next-Button-SecondaryLight_Color_Active
-  - --triplex-next-Button-SecondaryLight_Shadow_Focus
-  - --triplex-next-Button-SecondaryLight_Background_Disabled
-  - --triplex-next-Button-SecondaryLight_Color_Disabled
-  - --triplex-next-Button-Danger_Background_Default
-  - --triplex-next-Button-Danger_Color_Default
-  - --triplex-next-Button-Danger_Background_Hover
-  - --triplex-next-Button-Danger_Color_Hover
-  - --triplex-next-Button-Danger_Background_Active
-  - --triplex-next-Button-Danger_Color_Active
-  - --triplex-next-Button-Danger_Shadow_Focus
-  - --triplex-next-Button-Danger_Background_Disabled
-  - --triplex-next-Button-Danger_Color_Disabled
-  - --triplex-next-Button-Link_Color_Default
-  - --triplex-next-Button-Link_Color_Hover
-  - --triplex-next-Button-Link_Color_Active
-  - --triplex-next-Button-Link_Shadow_Focus
-  - --triplex-next-Button-Link_Color_Disabled
-  - --triplex-next-Button-Icon_Shadow_Focus
+  - Button.General_Background_Default
+  - Button.General_Color_Default
+  - Button.General_Background_Hover
+  - Button.General_Color_Hover
+  - Button.General_Background_Active
+  - Button.General_Color_Active
+  - Button.General_Shadow_Focus
+  - Button.General_Background_Disabled
+  - Button.General_Color_Disabled
+  - Button.Secondary_Background_Default
+  - Button.Secondary_Color_Default
+  - Button.Secondary_Background_Hover
+  - Button.Secondary_Color_Hover
+  - Button.Secondary_Background_Active
+  - Button.Secondary_Color_Active
+  - Button.Secondary_Shadow_Focus
+  - Button.Secondary_Background_Disabled
+  - Button.Secondary_Color_Disabled
+  - Button.SecondaryLight_Background_Default
+  - Button.SecondaryLight_Color_Default
+  - Button.SecondaryLight_Background_Hover
+  - Button.SecondaryLight_Color_Hover
+  - Button.SecondaryLight_Background_Active
+  - Button.SecondaryLight_Color_Active
+  - Button.SecondaryLight_Shadow_Focus
+  - Button.SecondaryLight_Background_Disabled
+  - Button.SecondaryLight_Color_Disabled
+  - Button.Danger_Background_Default
+  - Button.Danger_Color_Default
+  - Button.Danger_Background_Hover
+  - Button.Danger_Color_Hover
+  - Button.Danger_Background_Active
+  - Button.Danger_Color_Active
+  - Button.Danger_Shadow_Focus
+  - Button.Danger_Background_Disabled
+  - Button.Danger_Color_Disabled
+  - Button.Link_Color_Default
+  - Button.Link_Color_Hover
+  - Button.Link_Color_Active
+  - Button.Link_Shadow_Focus
+  - Button.Link_Color_Disabled
+  - Button.Icon_Shadow_Focus
 stories: stories/Buttons/Button.stories.tsx
 version: "1.0"
 ---
@@ -117,7 +117,10 @@ version: "1.0"
 
 ## Дизайн-токены
 
-Паттерн: `--triplex-next-Button-{Theme}_{Property}_{State}`
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Button.ts`.
+
+Паттерн: `Button.{Theme}_{Property}_{State}`
 
 Каждая тема (кроме `LINK`) имеет полный набор:
 - `_Background_Default/Hover/Active/Disabled`

package/bundle/components/ButtonDropdownExtended.md

@@ -61,12 +61,12 @@ version: "1.0"
 
 ## Инварианты
 
-- Компонент объявлен как `IButtonDropdownExtendedComponent extends React.FC<IButtonDropdownExtendedProps>`, `forwardRef` **не используется**: ref на корневой `<div>` не пробрасывается. Добавление `forwardRef` меняет базовый тип экспортируемого интерфейса — это breaking change, требует отдельного решения.
+- `forwardRef` на компоненте — не убирать. Ref идёт на корневой `<div>` (`HTMLDivElement`) и мерджится с внутренним `containerRef` через callback-ref: `containerRef` отвечает за определение «клик внутри триггера», поэтому подменять его форвардом нельзя — нужны оба.
 - Публичные имена `ButtonDropdownExtended`, `IButtonDropdownExtendedProps`, `IButtonDropdownExtendedButtonProvideProps`, `IButtonDropdownExtendedDropdownProvideProps`, `IButtonDropdownExtendedComponent` экспортируются из `src/components/Button/index.ts` — сохранять.
 - Статические свойства `Dropdown` и `DropdownList` — часть публичного API.
 - Фиксация режима управления на монтировании — наблюдаемое поведение, на него опираются потребители. Менять только осознанно.
 - `renderDropdown` обязан применить переданный `className` к выпадающему блоку. Но не считай, что на нём держится раскладка: стили этого класса объявлены вложенным селектором внутри `.buttonDropdownExtended` и при рендере блока в портале (штатный путь через `ButtonDropdownExtended.Dropdown`) не применяются — см. раздел «Дизайн-токены».
-- Корневой DOM-элемент — `<div>` с классом `buttonDropdownExtended`; на нём же живёт `containerRef`, по которому определяется «клик внутри триггера».
+- Корневой DOM-элемент — `<div>` с классом `buttonDropdownExtended`; на нём же живут `containerRef` и forwarded ref.
 - Слушатели `keydown` / `mousedown` / `touchstart` вешаются на `document` только пока блок открыт.
 
 ---
@@ -115,6 +115,7 @@ version: "1.0"
 
 | Дата | Изменение |
 |---|---|
+| 2026-08-31 | Компонент переведён с `React.FC` на `Object.assign(forwardRef(...), {...})` — теперь пробрасывает `ref` на корневой `<div>`, форвард мерджится с внутренним `containerRef`. Базовый тип `IButtonDropdownExtendedComponent` изменился с `React.FC` на `React.ForwardRefExoticComponent`; набор props, статики и DOM не изменились. Понадобилось для `TableBasicSettings`, который рендерит `ButtonDropdownExtended` корнем. |
 | 2026-07-29 | Создан документ AI-ready для `ButtonDropdownExtended`. AI-рефакторинг без изменения публичного API: режим управления переведён с ref на `useState` (устранены ошибки `react-hooks/refs`), убраны вырожденный тернарник в `useState` и мёртвые проверки `opened` внутри обработчиков, `setOpened && setOpened(...)` заменён на опциональный вызов, добавлены JSDoc. Добавлены unit-тесты и stories по modern pattern. |
 
 ---

package/bundle/components/ButtonIcon.md

@@ -3,7 +3,7 @@ component: ButtonIcon
 category: Buttons
 related: [Button]
 tokens:
-  - --triplex-next-Button-Icon_Shadow_Focus
+  - Button.Icon_Shadow_Focus
 stories: stories/Buttons/ButtonIcon.stories.tsx
 version: "1.0"
 ---
@@ -46,8 +46,11 @@ version: "1.0"
 
 ## Дизайн-токены
 
-```
---triplex-next-Button-Icon_Shadow_Focus
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Button.ts`.
+
+```text
+Button.Icon_Shadow_Focus
 ```
 
 ---
@@ -65,7 +68,7 @@ version: "1.0"
 
 - Компонент рендерит нативный `<button>`, поэтому базовая keyboard-навигация доступна из коробки.
 - Компонент **не хардкодит** `aria-label` (библиотека мультиязычная). Для иконки без текста потребитель **обязан** передать `aria-label` через `...rest`.
-- Фокусное состояние реализовано через `:focus-visible` и токен `--triplex-next-Button-Icon_Shadow_Focus`.
+- Фокусное состояние реализовано через `:focus-visible` и токен `Button.Icon_Shadow_Focus`.
 
 ---
 

package/bundle/components/Calendar.md

@@ -3,35 +3,35 @@ component: Calendar
 category: Date components
 related: [DatePickerExtended, DateField, DateRange, MonthYearField, MonthYearRange, ChipDatePicker]
 tokens:
-  - --triplex-next-Calendar-Background
-  - --triplex-next-Calendar-View_Header_Color
-  - --triplex-next-Calendar-View_Item_Background_Default
-  - --triplex-next-Calendar-View_Item_Background_Hover
-  - --triplex-next-Calendar-View_Item_Background_Selected_Default
-  - --triplex-next-Calendar-View_Item_Background_Selected_Hover
-  - --triplex-next-Calendar-View_Item_Background_Selected_Muted_Default
-  - --triplex-next-Calendar-View_Item_Background_Selected_Muted_Hover
-  - --triplex-next-Calendar-View_Item_BorderColor_Default
-  - --triplex-next-Calendar-View_Item_BorderColor_Focus
-  - --triplex-next-Calendar-View_Item_Color_Default
-  - --triplex-next-Calendar-View_Item_Color_Disabled
-  - --triplex-next-Calendar-View_Item_Color_Hover
-  - --triplex-next-Calendar-View_Item_Color_Muted
-  - --triplex-next-Calendar-View_Item_Color_Selected
-  - --triplex-next-Calendar-View_Item_Color_Selected_Muted_Default
-  - --triplex-next-Calendar-View_Item_Color_Selected_Muted_Hover
-  - --triplex-next-Calendar-View_Item_Mark_Basic_Background_Default
-  - --triplex-next-Calendar-View_Item_Mark_Basic_Background_Selected_Default
-  - --triplex-next-Calendar-View_Item_Mark_Basic_Background_Selected_Hover
-  - --triplex-next-Calendar-View_Item_Mark_Standard_Background_Default
-  - --triplex-next-Calendar-View_Item_Mark_Standard_Background_Selected_Default
-  - --triplex-next-Calendar-View_Item_Mark_Standard_Background_Selected_Hover
-  - --triplex-next-Calendar-View_Item_Mark_Attention_Background_Default
-  - --triplex-next-Calendar-View_Item_Mark_Attention_Background_Selected_Default
-  - --triplex-next-Calendar-View_Item_Mark_Attention_Background_Selected_Hover
-  - --triplex-next-Calendar-View_Item_Mark_Critical_Background_Default
-  - --triplex-next-Calendar-View_Item_Mark_Critical_Background_Selected_Default
-  - --triplex-next-Calendar-View_Item_Mark_Critical_Background_Selected_Hover
+  - Calendar.Background
+  - Calendar.View_Header_Color
+  - Calendar.View_Item_Background_Default
+  - Calendar.View_Item_Background_Hover
+  - Calendar.View_Item_Background_Selected_Default
+  - Calendar.View_Item_Background_Selected_Hover
+  - Calendar.View_Item_Background_Selected_Muted_Default
+  - Calendar.View_Item_Background_Selected_Muted_Hover
+  - Calendar.View_Item_BorderColor_Default
+  - Calendar.View_Item_BorderColor_Focus
+  - Calendar.View_Item_Color_Default
+  - Calendar.View_Item_Color_Disabled
+  - Calendar.View_Item_Color_Hover
+  - Calendar.View_Item_Color_Muted
+  - Calendar.View_Item_Color_Selected
+  - Calendar.View_Item_Color_Selected_Muted_Default
+  - Calendar.View_Item_Color_Selected_Muted_Hover
+  - Calendar.View_Item_Mark_Basic_Background_Default
+  - Calendar.View_Item_Mark_Basic_Background_Selected_Default
+  - Calendar.View_Item_Mark_Basic_Background_Selected_Hover
+  - Calendar.View_Item_Mark_Standard_Background_Default
+  - Calendar.View_Item_Mark_Standard_Background_Selected_Default
+  - Calendar.View_Item_Mark_Standard_Background_Selected_Hover
+  - Calendar.View_Item_Mark_Attention_Background_Default
+  - Calendar.View_Item_Mark_Attention_Background_Selected_Default
+  - Calendar.View_Item_Mark_Attention_Background_Selected_Hover
+  - Calendar.View_Item_Mark_Critical_Background_Default
+  - Calendar.View_Item_Mark_Critical_Background_Selected_Default
+  - Calendar.View_Item_Mark_Critical_Background_Selected_Hover
 stories: stories/Calendar/Calendar.stories.tsx
 version: "1.0"
 ---
@@ -92,36 +92,39 @@ version: "1.0"
 
 ## Дизайн-токены
 
-```
---triplex-next-Calendar-Background
---triplex-next-Calendar-View_Header_Color
---triplex-next-Calendar-View_Item_Background_Default
---triplex-next-Calendar-View_Item_Background_Hover
---triplex-next-Calendar-View_Item_Background_Selected_Default
---triplex-next-Calendar-View_Item_Background_Selected_Hover
---triplex-next-Calendar-View_Item_Background_Selected_Muted_Default
---triplex-next-Calendar-View_Item_Background_Selected_Muted_Hover
---triplex-next-Calendar-View_Item_BorderColor_Default
---triplex-next-Calendar-View_Item_BorderColor_Focus
---triplex-next-Calendar-View_Item_Color_Default
---triplex-next-Calendar-View_Item_Color_Disabled
---triplex-next-Calendar-View_Item_Color_Hover
---triplex-next-Calendar-View_Item_Color_Muted
---triplex-next-Calendar-View_Item_Color_Selected
---triplex-next-Calendar-View_Item_Color_Selected_Muted_Default
---triplex-next-Calendar-View_Item_Color_Selected_Muted_Hover
---triplex-next-Calendar-View_Item_Mark_Basic_Background_Default
---triplex-next-Calendar-View_Item_Mark_Basic_Background_Selected_Default
---triplex-next-Calendar-View_Item_Mark_Basic_Background_Selected_Hover
---triplex-next-Calendar-View_Item_Mark_Standard_Background_Default
---triplex-next-Calendar-View_Item_Mark_Standard_Background_Selected_Default
---triplex-next-Calendar-View_Item_Mark_Standard_Background_Selected_Hover
---triplex-next-Calendar-View_Item_Mark_Attention_Background_Default
---triplex-next-Calendar-View_Item_Mark_Attention_Background_Selected_Default
---triplex-next-Calendar-View_Item_Mark_Attention_Background_Selected_Hover
---triplex-next-Calendar-View_Item_Mark_Critical_Background_Default
---triplex-next-Calendar-View_Item_Mark_Critical_Background_Selected_Default
---triplex-next-Calendar-View_Item_Mark_Critical_Background_Selected_Hover
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Calendar.ts`.
+
+```text
+Calendar.Background
+Calendar.View_Header_Color
+Calendar.View_Item_Background_Default
+Calendar.View_Item_Background_Hover
+Calendar.View_Item_Background_Selected_Default
+Calendar.View_Item_Background_Selected_Hover
+Calendar.View_Item_Background_Selected_Muted_Default
+Calendar.View_Item_Background_Selected_Muted_Hover
+Calendar.View_Item_BorderColor_Default
+Calendar.View_Item_BorderColor_Focus
+Calendar.View_Item_Color_Default
+Calendar.View_Item_Color_Disabled
+Calendar.View_Item_Color_Hover
+Calendar.View_Item_Color_Muted
+Calendar.View_Item_Color_Selected
+Calendar.View_Item_Color_Selected_Muted_Default
+Calendar.View_Item_Color_Selected_Muted_Hover
+Calendar.View_Item_Mark_Basic_Background_Default
+Calendar.View_Item_Mark_Basic_Background_Selected_Default
+Calendar.View_Item_Mark_Basic_Background_Selected_Hover
+Calendar.View_Item_Mark_Standard_Background_Default
+Calendar.View_Item_Mark_Standard_Background_Selected_Default
+Calendar.View_Item_Mark_Standard_Background_Selected_Hover
+Calendar.View_Item_Mark_Attention_Background_Default
+Calendar.View_Item_Mark_Attention_Background_Selected_Default
+Calendar.View_Item_Mark_Attention_Background_Selected_Hover
+Calendar.View_Item_Mark_Critical_Background_Default
+Calendar.View_Item_Mark_Critical_Background_Selected_Default
+Calendar.View_Item_Mark_Critical_Background_Selected_Hover
 ```
 
 Кнопки заголовка и футера используют токены `Button` / `ButtonIcon`.

package/bundle/components/Caption.md

@@ -3,28 +3,28 @@ component: Caption
 category: Typography
 related: [Text, Title, CodeText]
 tokens:
-  - --triplex-next-Typography-Primary_Color
-  - --triplex-next-Typography-PrimaryInvert_Color
-  - --triplex-next-Typography-Complementary_Color
-  - --triplex-next-Typography-ComplementaryInvert_Color
-  - --triplex-next-Typography-Secondary_Color
-  - --triplex-next-Typography-SecondaryInvert_Color
-  - --triplex-next-Typography-Tertiary_Color
-  - --triplex-next-Typography-TertiaryInvert_Color
-  - --triplex-next-Typography-Disabled_Color
-  - --triplex-next-Typography-DisabledInvert_Color
-  - --triplex-next-Typography-Brand_Color
-  - --triplex-next-Typography-BrandInvert_Color
-  - --triplex-next-Typography-Info_Color
-  - --triplex-next-Typography-InfoInvert_Color
-  - --triplex-next-Typography-Success_Color
-  - --triplex-next-Typography-SuccessInvert_Color
-  - --triplex-next-Typography-Warning_Color
-  - --triplex-next-Typography-WarningInvert_Color
-  - --triplex-next-Typography-Error_Color
-  - --triplex-next-Typography-ErrorInvert_Color
-  - --triplex-next-Typography-System_Color
-  - --triplex-next-Typography-SystemInvert_Color
+  - Typography.Primary_Color
+  - Typography.PrimaryInvert_Color
+  - Typography.Complementary_Color
+  - Typography.ComplementaryInvert_Color
+  - Typography.Secondary_Color
+  - Typography.SecondaryInvert_Color
+  - Typography.Tertiary_Color
+  - Typography.TertiaryInvert_Color
+  - Typography.Disabled_Color
+  - Typography.DisabledInvert_Color
+  - Typography.Brand_Color
+  - Typography.BrandInvert_Color
+  - Typography.Info_Color
+  - Typography.InfoInvert_Color
+  - Typography.Success_Color
+  - Typography.SuccessInvert_Color
+  - Typography.Warning_Color
+  - Typography.WarningInvert_Color
+  - Typography.Error_Color
+  - Typography.ErrorInvert_Color
+  - Typography.System_Color
+  - Typography.SystemInvert_Color
 stories: stories/Typography/Caption.stories.tsx
 version: "1.0"
 ---
@@ -73,7 +73,10 @@ version: "1.0"
 
 ## Дизайн-токены
 
-Цвета — общие CSS-переменные семейства Typography (см. frontmatter): `--triplex-next-Typography-{Type}_Color` и `--triplex-next-Typography-{Type}Invert_Color`.
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Typography.ts`.
+
+Цвета — общие токены группы `Typography` (см. frontmatter): `Typography.{Type}_Color` и `Typography.{Type}Invert_Color`.
 
 Размеры шрифта и line-height — фиксированные пиксельные значения в `styles/Caption.module.less` (токенов для них нет).
 

package/bundle/components/Checkbox.md

@@ -3,20 +3,20 @@ component: Checkbox
 category: Inputs
 related: [CheckboxXGroup, CheckboxYGroup, CheckboxTree, CheckboxTreeExtended]
 tokens:
-  - --triplex-next-Checkbox-Background_Default
-  - --triplex-next-Checkbox-BorderColor_Default
-  - --triplex-next-Checkbox-Checkmark_Fill_Default
-  - --triplex-next-Checkbox-Background_Hover
-  - --triplex-next-Checkbox-BorderColor_Hover
-  - --triplex-next-Checkbox-Background_Checked_Default
-  - --triplex-next-Checkbox-BorderColor_Checked_Default
-  - --triplex-next-Checkbox-Background_Disabled
-  - --triplex-next-Checkbox-BorderColor_Disabled
-  - --triplex-next-Checkbox-Background_Checked_Disabled
-  - --triplex-next-Checkbox-BorderColor_Checked_Disabled
-  - --triplex-next-Checkbox-Checkmark_Fill_Disabled
-  - --triplex-next-Checkbox-BorderColor_Focus
-  - --triplex-next-Checkbox-Background_Checked_Hover
+  - Checkbox.Background_Default
+  - Checkbox.BorderColor_Default
+  - Checkbox.Checkmark_Fill_Default
+  - Checkbox.Background_Hover
+  - Checkbox.BorderColor_Hover
+  - Checkbox.Background_Checked_Default
+  - Checkbox.BorderColor_Checked_Default
+  - Checkbox.Background_Disabled
+  - Checkbox.BorderColor_Disabled
+  - Checkbox.Background_Checked_Disabled
+  - Checkbox.BorderColor_Checked_Disabled
+  - Checkbox.Checkmark_Fill_Disabled
+  - Checkbox.BorderColor_Focus
+  - Checkbox.Background_Checked_Hover
 stories: stories/Checkbox/Checkbox.stories.tsx
 version: "1.0"
 ---
@@ -62,21 +62,24 @@ version: "1.0"
 
 ## Дизайн-токены
 
-```
---triplex-next-Checkbox-Background_Default
---triplex-next-Checkbox-BorderColor_Default
---triplex-next-Checkbox-Checkmark_Fill_Default
---triplex-next-Checkbox-Background_Hover
---triplex-next-Checkbox-BorderColor_Hover
---triplex-next-Checkbox-Background_Checked_Default
---triplex-next-Checkbox-BorderColor_Checked_Default
---triplex-next-Checkbox-Background_Disabled
---triplex-next-Checkbox-BorderColor_Disabled
---triplex-next-Checkbox-Background_Checked_Disabled
---triplex-next-Checkbox-BorderColor_Checked_Disabled
---triplex-next-Checkbox-Checkmark_Fill_Disabled
---triplex-next-Checkbox-BorderColor_Focus
---triplex-next-Checkbox-Background_Checked_Hover
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Checkbox.ts`.
+
+```text
+Checkbox.Background_Default
+Checkbox.BorderColor_Default
+Checkbox.Checkmark_Fill_Default
+Checkbox.Background_Hover
+Checkbox.BorderColor_Hover
+Checkbox.Background_Checked_Default
+Checkbox.BorderColor_Checked_Default
+Checkbox.Background_Disabled
+Checkbox.BorderColor_Disabled
+Checkbox.Background_Checked_Disabled
+Checkbox.BorderColor_Checked_Disabled
+Checkbox.Checkmark_Fill_Disabled
+Checkbox.BorderColor_Focus
+Checkbox.Background_Checked_Hover
 ```
 
 ---

package/bundle/components/CheckboxTreeExtended.md

@@ -3,7 +3,7 @@ component: CheckboxTreeExtended
 category: Inputs
 related: [CheckboxTree, CollapsibleTreeExtended, Checkbox]
 tokens:
-  - --triplex-next-Checkbox-BorderColor_Focus
+  - Checkbox.BorderColor_Focus
 stories: stories/CheckboxTreeExtended/CheckboxTreeExtended.stories.tsx
 version: "1.0"
 ---
@@ -88,11 +88,15 @@ render-функции узла.
 
 ## Дизайн-токены
 
-Собственных токенов компонент не вводит. Единственная CSS-переменная в стилях —
-у стрелки раскрытия (см. «Инварианты», сейчас не отрисовывается):
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Checkbox.ts`.
 
-```
---triplex-next-Checkbox-BorderColor_Focus
+Собственных токенов компонент не вводит. Единственный токен в стилях — общий
+`Checkbox.BorderColor_Focus`: тот же токен рисует фокус чекбокса, а здесь —
+`:focus-visible` стрелки раскрытия (см. «Инварианты», сейчас не отрисовывается):
+
+```text
+Checkbox.BorderColor_Focus
 ```
 
 Размеры и цвета самих чекбоксов приходят из `Checkbox`, вертикальные отступы