@sberbusiness/triplex-next-mcp-server 1.43.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"
 ---
@@ -49,7 +49,7 @@ ARIA-роли не выставляет.
 | `closable`                    | `boolean`                   | `false`                        | Показывает кнопку закрытия в правом верхнем углу                                                                      |
 | `onClose`                     | `() => void`                | —                              | Вызывается **после** того, как компонент скрыл себя. Аргументов не принимает, отменить закрытие нельзя                |
 | `renderIcon`                  | `React.ReactNode`           | иконка по `type`               | Полностью заменяет иконку по умолчанию                                                                                |
-| `borderRadius`                | `EAlertProcessBorderRadius` | `EAlertProcessBorderRadius.MD` | Скругление углов: `MD` (12px) / `LG` (24px)                                                                           |
+| `borderRadius`                | `EAlertProcessBorderRadius` | `EAlertProcessBorderRadius.MD` | Скругление углов: `MD` (16px) / `LG` (24px)                                                                           |
 | `children`                    | `React.ReactNode`           | —                              | Контент. Типографику задаёт потребитель компонентами `Typography` — сам `AlertProcess` размер и цвет текста не задаёт |
 | `...HTMLDivElementAttributes` | —                           | —                              | Все стандартные атрибуты `<div>`                                                                                      |
 
@@ -69,18 +69,21 @@ 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`. Компонент
 задаёт **только фон**: цвет и размер текста — зона ответственности `Typography`
 у потребителя, цвет иконок — `paletteIndex` соответствующей иконки. Скругления
-(12px / 24px) и внутренние отступы (16px) заданы литералами в
+(16px / 24px) и внутренние отступы (16px) заданы литералами в
 `styles/AlertProcess.module.less` — токенов для них нет.
 
 ---
@@ -245,6 +248,7 @@ ARIA-роли не выставляет.
 | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | 2026-08-10 | Создан документ. AI-рефакторинг: `AlertProcessSpoiler` переведён на `forwardRef` и перестал затирать `className` собственными классами; из него убрана ссылка на несуществующий CSS-класс `styles.spoiler`; в `AlertProcess` убрано дублирующее присваивание `AlertProcess.Spoiler`, `renderIcon` приведён к `\|\|` как в `AlertContext`, добавлены JSDoc на props с дефолтами и явный `children`; из LESS удалено мёртвое правило `.alertTypeFeature .themeIcon { padding-top: 0 }`. Unit-тесты разбиты на `AlertProcess.test.tsx`и`AlertProcessSpoiler.test.tsx`и расширены с 11 до 34 кейсов. Stories переведены на modern pattern — файлы примеров без суффикса`Example`. Публичный API не изменён. |
 | 2026-08-11 | По ревью PR #520: из `AlertProcessSpoiler` убрана пустая обёртка-`<div>` — контент и кнопка раскрытия стали соседними элементами, корневым элементом компонента стал элемент контента (он и раньше получал `className` / `ref` / `...rest`). На кнопке раскрытия выставлен `aria-expanded`. Тесты дополнены до 37 кейсов. Публичный API не изменён.                                                                                                                                                                                                                                                                                                                                                     |
+| 2026-08-28 | Скругление варианта `MD` увеличено с 12px до 16px в `styles/AlertProcess.module.less`. |
 
 ---
 

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/BodyPage.md

@@ -35,12 +35,37 @@ version: "1.0"
 
 | Prop | Тип | По умолчанию | Описание |
 |---|---|---|---|
-| `verticalMargin` | `EBodyPageVerticalMargin` | `LARGE` | Вертикальные отступы: `LARGE` = 24px (16px на узких экранах), `SMALL` = 16px (8px на узких). В LightBox используется `SMALL`. |
+| `verticalMargin` | `TBodyPageVerticalMargin` | `LARGE` | Вертикальные отступы: `LARGE` = 24px (16px на узких экранах), `SMALL` = 16px (8px на узких), `NONE` = 0. Одно значение задаёт обе стороны; объект `{top, bottom}` — каждую отдельно, обе стороны указываются явно. В LightBox используется `SMALL`. |
 | `size` | `EComponentSize` | — | Размер острова (Island). **Доступен только для `type=FIRST`**; для `type=SECOND` типизирован как `never`. |
 
+### Тип verticalMargin
+
+```ts
+interface IBodyPageVerticalMarginSides {
+    top: EBodyPageVerticalMargin;
+    bottom: EBodyPageVerticalMargin;
+}
+
+type TBodyPageVerticalMargin = EBodyPageVerticalMargin | IBodyPageVerticalMarginSides;
+```
+
+```tsx
+<Page.Body type={EBodyPageType.FIRST} verticalMargin={EBodyPageVerticalMargin.NONE}>…</Page.Body>
+<Page.Body
+    type={EBodyPageType.FIRST}
+    verticalMargin={{top: EBodyPageVerticalMargin.NONE, bottom: EBodyPageVerticalMargin.LARGE}}
+>…</Page.Body>
+```
+
+`top` и `bottom` в объектной форме обязательны: скрытого дефолта у стороны нет, отступ виден
+прямо в месте вызова. Частичный объект (`{top}`) и пустой (`{}`) — ошибка компиляции.
+
 ### Ограничения по типам
 
 - `size` доступен только при `type=FIRST` (в `SECOND` контент не оборачивается в Island, поэтому `size?: never`).
+- Частичный объект в `verticalMargin` запрещён типом. Если он всё же придёт из нетипизированного кода,
+  сторона без значения не получит класс и даст 0 — дефолт `LARGE` намеренно не подставляется в рантайме,
+  иначе вернулся бы скрытый дефолт стороны.
 
 ---
 
@@ -48,7 +73,8 @@ version: "1.0"
 
 Собственных CSS-переменных нет. Внешний вид карточки наследуется от `Island` (`EIslandType.TYPE_1`).
 Вертикальные отступы заданы фиксированными значениями в `styles/BodyPage.module.less`
-(24/16px и адаптив 16/8px на `@screen-sm-max`).
+односторонними классами `marginTop{Large,Small,None}` / `marginBottom{Large,Small,None}`
+(24/16/0px и адаптив 16/8/0px на `@screen-sm-max`).
 
 ---
 
@@ -59,9 +85,14 @@ version: "1.0"
 - `displayName = "BodyPage"` — не менять.
 - Discriminated union по `type` и значения `EBodyPageType` / `EBodyPageVerticalMargin` — часть
   публичного API, менять нельзя.
-- Экспорты `BodyPage`, `IBodyPageTypeFirstProps`, `IBodyPageTypeSecondProps` идут в barrel
+- Экспорты `BodyPage`, `IBodyPageTypeFirstProps`, `IBodyPageTypeSecondProps`,
+  `IBodyPageVerticalMarginSides`, `TBodyPageVerticalMargin` идут в barrel
   `src/components/Page/index.ts` — сохранять.
 - `verticalMargin` по умолчанию `LARGE` — менять дефолт нельзя без обсуждения.
+- В объектной форме `top` и `bottom` обязательны — не делать их опциональными: дефолт стороны
+  вернул бы скрытое поведение, которого здесь сознательно нет.
+- Скалярная форма `verticalMargin` должна и дальше работать как раньше — это обратная
+  совместимость публичного API.
 
 ---
 
@@ -92,7 +123,7 @@ version: "1.0"
 | `Playground` | `Playground.tsx` | Интерактивный контроль `type` и `verticalMargin` |
 | `Default` | `Default.tsx` | Минимальный пример (FIRST, контент в карточке) |
 | `Types` | `Types.tsx` | Сравнение типов FIRST и SECOND |
-| `VerticalMargins` | `VerticalMargins.tsx` | Отступы LARGE (24px) и SMALL (16px) |
+| `VerticalMargins` | `VerticalMargins.tsx` | Отступы LARGE (24px), SMALL (16px), NONE (0) и асимметричные комбинации |
 | `VisualTests` | `VisualTests.tsx` | Матрица type × verticalMargin для скриншот-регрессии |
 
 ---
@@ -102,6 +133,7 @@ version: "1.0"
 | Дата | Изменение |
 |---|---|
 | 2026-06-18 | Создан документ. AI-рефакторинг (clsx order, JSDoc), unit-тесты, миграция stories на modern pattern. |
+| 2026-08-26 | TRI-121: добавлено `EBodyPageVerticalMargin.NONE`; `verticalMargin` принимает объект `{top, bottom}` (обе стороны обязательны) для независимых отступов сверху и снизу. LESS переразбит на односторонние классы. |
 
 ---
 
@@ -180,6 +212,42 @@ export const VerticalMargins = () => (
                 </Text>
             </Page.Body>
         </div>
+        <div>
+            <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: 700 }}>
+                NONE (0) — собственных отступов нет
+            </div>
+            <Page.Body type={EBodyPageType.FIRST} verticalMargin={EBodyPageVerticalMargin.NONE}>
+                <Text tag="div" size={ETextSize.B2} type={EFontType.PRIMARY}>
+                    Без вертикальных отступов сверху и снизу.
+                </Text>
+            </Page.Body>
+        </div>
+        <div>
+            <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: 700 }}>
+                {"{ top: NONE, bottom: LARGE }"}
+            </div>
+            <Page.Body
+                type={EBodyPageType.FIRST}
+                verticalMargin={{ top: EBodyPageVerticalMargin.NONE, bottom: EBodyPageVerticalMargin.LARGE }}
+            >
+                <Text tag="div" size={ETextSize.B2} type={EFontType.PRIMARY}>
+                    Отступы задаются раздельно: сверху 0, снизу 24px.
+                </Text>
+            </Page.Body>
+        </div>
+        <div>
+            <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: 700 }}>
+                {"{ top: SMALL, bottom: NONE }"}
+            </div>
+            <Page.Body
+                type={EBodyPageType.FIRST}
+                verticalMargin={{ top: EBodyPageVerticalMargin.SMALL, bottom: EBodyPageVerticalMargin.NONE }}
+            >
+                <Text tag="div" size={ETextSize.B2} type={EFontType.PRIMARY}>
+                    Отступы задаются раздельно: сверху 16px, снизу 0.
+                </Text>
+            </Page.Body>
+        </div>
     </div>
 );
 ```

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`.