@sberbusiness/triplex-next-mcp-server 1.50.0-beta → 1.53.1

package/README.md

@@ -45,6 +45,7 @@ MCP-сервер для дизайн-системы Triplex. Предостав
 | `get_tokens(component?, group?)`                          | Дизайн-токены: индекс групп, токены компонента или группа целиком — с путями `Группа.Токен` и значениями тем                                                                                     |
 | `list_icons(query?, size?, limit?)`                       | Иконки из `@sberbusiness/icons-next` с фильтрами по подстроке в имени и размеру (защита от галлюцинаций имён)                                                                                    |
 | `get_guidelines`                                          | Гайдлайны кодогенерации на Triplex для ИИ-агентов (правила `TPX-G-NN` из `docs/mcp/guidelines.md` triplex-next)                                                                                  |
+| `get_release_notes(version?)`                             | Release notes указанной версии Triplex в исходном MDX. Без аргументов используется версия bundle.                                                                                                |
 
 Флаг `ai_ready: true` означает, что у компонента есть полноценная AI-документация
 (`*-AI.md` с frontmatter, секциями и примерами). Для остальных компонентов сервер

package/bundle/components/AlertProcess.md

@@ -1,7 +1,7 @@
 ---
 component: AlertProcess
 category: Alert
-related: [AlertContext]
+related: [AlertProcessSpoiler, AlertContext]
 tokens:
   - AlertProcess.Info_Background
   - AlertProcess.Warning_Background
@@ -56,7 +56,8 @@ ARIA-роли не выставляет.
 ### AlertProcess.Spoiler
 
 Раскрывающийся блок внутри `AlertProcess`. **Полностью управляемый** — своего
-состояния не хранит.
+состояния не хранит. Полный контракт, ограничения и примеры —
+[AlertProcessSpoiler-ai.md](./AlertProcessSpoiler-ai.md).
 
 | Prop                          | Тип                       | По умолчанию | Описание                                                             |
 | ----------------------------- | ------------------------- | ------------ | -------------------------------------------------------------------- |
@@ -195,7 +196,8 @@ AlertProcess.Feature_Background  // фон для type=FEATURE
   `role="alert"`, иконка + короткий текст, без фона и кнопок. Не поддерживает
   `EAlertType.FEATURE`.
 - `AlertProcessSpoiler` — субкомпонент, доступный только как
-  `AlertProcess.Spoiler`. Собственного AI.md не имеет, описан здесь.
+  `AlertProcess.Spoiler`. Подробности — в
+  [AlertProcessSpoiler-ai.md](./AlertProcessSpoiler-ai.md).
 - `EAlertType` — общий enum типов семейства. `AlertProcess` использует его целиком.
 - `EAlertProcessBorderRadius` — enum скруглений, экспортируется из barrel.
 - `ALERT_TYPE_TO_CLASS_NAME_MAP` (`AlertTypeUtils.tsx`) — общий с `AlertContext`
@@ -249,6 +251,7 @@ AlertProcess.Feature_Background  // фон для type=FEATURE
 | 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`. |
+| 2026-10-19 | По TRI-160 добавлена связь с отдельной документацией `AlertProcessSpoiler`, проверены существующие примеры и контракт атома |
 
 ---
 

package/bundle/components/AlertProcessSpoiler.md

@@ -0,0 +1,216 @@
+---
+component: AlertProcessSpoiler
+category: Alert
+related: [AlertProcess, ButtonIcon]
+tokens: []
+stories: stories/Alerts/AlertProcess.stories.tsx
+version: "1.0"
+---
+
+# AlertProcessSpoiler
+
+## Назначение
+
+Раскрываемые подробности процессного уведомления. Публично доступен как
+`AlertProcess.Spoiler`: хранение состояния открытия остаётся у потребителя,
+а компонент выводит содержимое и кнопку с кареткой внутри `AlertProcess`.
+
+Используй когда: часть сообщения `AlertProcess` нужно свернуть, оставив
+основной текст уведомления видимым.
+
+Не используй когда: нужен самостоятельный спойлер вне уведомления — для
+этого есть `Spoiler`. Для содержимого выше 1000px текущая анимация не подходит:
+раскрытый блок ограничен `max-height` и обрежет лишнее.
+
+### Публичный путь использования
+
+Импортируй родителя из публичного пакета и обращайся к статическому полю:
+
+```tsx
+import React, { useState } from "react";
+import { AlertProcess, EAlertType, ETextSize, Text } from "@sberbusiness/triplex-next";
+
+export const ProcessDetails = () => {
+    const [open, setOpen] = useState(false);
+
+    return (
+        <AlertProcess type={EAlertType.INFO}>
+            <Text size={ETextSize.B3}>Заявление принято.</Text>
+            <AlertProcess.Spoiler open={open} onOpen={setOpen}>
+                <Text size={ETextSize.B3}>Результат появится после проверки документов.</Text>
+            </AlertProcess.Spoiler>
+        </AlertProcess>
+    );
+};
+```
+
+Именованные экспорты `AlertProcessSpoiler` и `IAlertProcessSpoilerProps` в
+публичном barrel отсутствуют. Для получения типа props через публичный API
+используй `React.ComponentProps<typeof AlertProcess.Spoiler>`.
+
+---
+
+## Варианты и props
+
+Обязательных props нет. `IAlertProcessSpoilerProps` определён в
+`AlertProcess/components/AlertProcessSpoiler.tsx` и наследует атрибуты `<div>`.
+
+| Prop | По умолчанию | Назначение и ограничения |
+|---|---|---|
+| `open` | `undefined` (закрыт) | Управляет раскрытием содержимого и поворотом каретки. Собственного состояния открытия нет |
+| `onOpen` | — | При нажатии кнопки получает следующее значение `!open`. Потребитель должен обновить `open`; без этого вид не меняется |
+| `children` | — | Раскрываемое содержимое. Типографику и цвет текста задаёт потребитель |
+| `className` | — | Объединяется с классами блока содержимого через `clsx` |
+| `ref` | — | Ссылка на `HTMLDivElement` раскрываемого содержимого |
+| Остальные атрибуты `<div>` | — | Передаются блоку содержимого, включая `id`, `aria-*` и обработчики событий. До кнопки раскрытия они не доходят |
+
+Ни `open` без `onOpen`, ни `onOpen` без обновления внешнего состояния не
+делают компонент неконтролируемым. `defaultOpen`, собственных размеров,
+тем и prop для отключения кнопки у него нет.
+
+---
+
+## Дизайн-токены
+
+Собственных дизайн-токенов нет, поэтому `tokens: []`. Правила спойлера в
+`AlertProcess/styles/AlertProcess.module.less` задают высоту, прозрачность,
+позиционирование и поворот каретки без обращения к токенам.
+
+Фон уведомления задаётся токенами родителя `AlertProcess` в зависимости от
+его `type` — см. [AlertProcess-ai.md](./AlertProcess-ai.md). Фокус кнопки
+использует `Button.Icon_Shadow_Focus` через вложенный `ButtonIcon` — см.
+[ButtonIcon-ai.md](../Button/ButtonIcon-ai.md). Цвет каретки определяется
+`paletteIndex={5}` иконки. Оформление текста приходит из `children`.
+
+Переопределение токенов зависимостей через `ThemeProvider` описано в
+[ThemeProvider-ai.md](../ThemeProvider/ThemeProvider-ai.md), раздел
+«Как переопределять токены».
+
+---
+
+## Инварианты
+
+- Публичный путь — `AlertProcess.Spoiler`, назначаемый родителю через
+  `Object.assign`. Отдельного экспорта атома из `Alert/index.ts` нет.
+- `forwardRef<HTMLDivElement, IAlertProcessSpoilerProps>` обязателен;
+  `displayName` — `AlertProcessSpoiler`. Ref указывает на содержимое,
+  а не на кнопку или её обёртку.
+- Рендерятся два соседних `<div>` без общей обёртки: содержимое и блок
+  кнопки. `className` и `...rest` получает только содержимое. Перенос кнопки
+  внутрь него скроет её при сворачивании.
+- Полностью управляемый контракт `open` / `onOpen(!open)` сохраняется.
+  Нажатие кнопки само по себе состояние не меняет.
+- Через приватный `AlertProcessContext` при монтировании вызывается
+  `setHasSpoiler(true)`, при размонтировании — `setHasSpoiler(false)`.
+  Родитель добавляет `withSpoiler` и резервирует `min-height: 40px`
+  под кнопку независимо от `open`. Спойлер может находиться на любой
+  глубине внутри родителя.
+- В одном `AlertProcess` используй один спойлер: контекст хранит булев
+  признак, а не число экземпляров. Размонтирование одного из нескольких
+  сбросит резерв высоты для оставшихся.
+- Стили содержимого зависят от предков `.alertProcess` и
+  `.alertProcessContentBlock`; кнопка позиционируется абсолютно относительно
+  родителя. Самостоятельное использование вне `AlertProcess` не обеспечивает
+  эту раскладку.
+- Классы `expandableContent`, `expandButton`, `expanded` и `withSpoiler`
+  участвуют в контракте DOM и тестах. Раскрытие анимируется за 0.3s через
+  `max-height: 0 → 1000px` и `opacity: 0 → 1`; каретка поворачивается на 180°.
+
+---
+
+## Accessibility
+
+- Кнопка — нативный `<button type="button">` внутри `ButtonIcon`:
+  доступна по `Tab`, активируется клавишами `Enter` / `Space` и мышью.
+  Собственного управления фокусом и клавиатурных обработчиков нет.
+- На кнопке выставляется `aria-expanded={Boolean(open)}`. Атрибут
+  отражает prop, а не факт последнего нажатия.
+- Доступное имя кнопки и `aria-controls` сейчас не задаются. Props спойлера
+  уходят на содержимое: переданный `aria-label` попадёт на блок содержимого, а `id` не
+  создаст связь с кнопкой. Публичного prop для атрибутов кнопки нет.
+- Свёрнутое содержимое остаётся в DOM и скрывается только высотой,
+  прозрачностью и `overflow`. `hidden`, `inert` и `aria-hidden` автоматически
+  не выставляются: содержимое остаётся доступно скринридеру, а вложенные
+  интерактивные элементы могут получать фокус по `Tab` даже при `open=false`.
+- Ни спойлер, ни родитель не добавляют `role="alert"` или live-region.
+  Это текущее ограничение реализации; отдельный контракт доступности
+  потребует изменения компонента.
+
+---
+
+## Связанные компоненты
+
+- [AlertProcess](./AlertProcess-ai.md) — родитель: предоставляет контекст,
+  фон, раскладку и публичное поле `Spoiler`.
+- [ButtonIcon](../Button/ButtonIcon-ai.md) — внутренняя кнопка раскрытия;
+  обеспечивает нативное поведение кнопки и оформление фокуса.
+
+---
+
+## Stories
+
+Основные истории: `stories/Alerts/AlertProcess.stories.tsx`
+Файлы примеров: `stories/Alerts/examples/AlertProcess/`
+
+Используются существующие modern examples родителя. Отдельный stories-файл
+атому не требуется.
+
+| Story | Example file | Что демонстрирует |
+|---|---|---|
+| `WithSpoiler` | `WithSpoiler.tsx` | Публичный `AlertProcess.Spoiler`, внешнее состояние через `useState`, начальное закрытое состояние и переключение |
+| `VisualTests` | `VisualTests.tsx` | Раскрытое состояние с `open={true}` для скриншот-регрессии |
+
+Baseline закрытого и раскрытого состояний уже хранятся в `__screenshots__/`:
+`alerts-alertprocess--with-spoiler--{xs,xl}.png` и
+`alerts-alertprocess--visual-tests--{xs,xl}.png`.
+
+Unit-тесты: `AlertProcess/__tests__/AlertProcessSpoiler.test.tsx` проверяет
+управляемое состояние, аргументы callback, `aria-expanded`, DOM-соседство,
+`className`, атрибуты и ref. `AlertProcess/__tests__/AlertProcess.test.tsx`
+проверяет публичное поле `Spoiler` и резерв высоты при монтировании и
+размонтировании атома. Код и stories уже прошли рефакторинг в задаче TRI-7;
+для TRI-160 повторно проверено соответствие текущему DoD.
+
+---
+
+## История изменений
+
+| Дата | Изменение |
+|---|---|
+| 2026-10-19 | Создан документ по TRI-160. Проверены самостоятельный контракт атома, выполненный рефакторинг, тесты и существующие примеры родителя |
+
+---
+
+## Примеры использования
+
+### WithSpoiler
+
+`stories/Alerts/examples/AlertProcess/WithSpoiler.tsx`
+
+```tsx
+import React, { useState } from "react";
+import { AlertProcess, EAlertType, EFontType, ETextSize, Text } from "@sberbusiness/triplex-next";
+
+export const WithSpoiler = () => {
+    const [expanded, setExpanded] = useState(false);
+
+    return (
+        <div style={{ maxWidth: "750px" }}>
+            <AlertProcess type={EAlertType.INFO}>
+                <Text size={ETextSize.B3} type={EFontType.PRIMARY}>
+                    По вопросам финмониторинга обращайтесь в рабочие дни с 03:00 до 21:00 МСК с мобильного телефона по
+                    номеру 0321, доб. 6. Звонки по России бесплатные.
+                </Text>
+                <AlertProcess.Spoiler open={expanded} onOpen={setExpanded}>
+                    <Text size={ETextSize.B3} type={EFontType.PRIMARY}>
+                        У вас нет прав на подписание и отправку заявления в страховую компанию. Подписывать заявления, а
+                        также заверять документы, имеет право генеральный директор на основании устава, владелец ИП на
+                        основании доверенности.
+                    </Text>
+                </AlertProcess.Spoiler>
+            </AlertProcess>
+        </div>
+    );
+};
+```
+

package/bundle/components/Badge.md

@@ -114,7 +114,7 @@ Badge.Background
 - **`BadgeDot` доступен только как `Badge.Dot`.** Barrel (`src/components/Badge/index.ts`)
   экспортирует `Badge` и типы; отдельного именованного экспорта `BadgeDot` нет — так его
   и импортируют внутренние потребители: `Marker`, `Chip`, `DropdownListItem`,
-  `DropdownMobileListItem`, `TabsLineItem`, `TabsExtendedTabButton`.
+  `PullerListItem`, `TabsLineItem`, `TabsExtendedTabButton`.
   Добавление именованного экспорта — расширение публичного API.
 - **`IBadgeDotProps` — не только props точки.** `Marker` строит из него свой публичный
   интерфейс: `IMarkerProps extends IBadgeDotProps` (`src/components/Marker/Marker.tsx:9`).
@@ -150,7 +150,7 @@ Badge.Background
   — либо продублировать смысл текстом рядом. Если точка декоративна и дублирует
   видимый текст — передай `aria-hidden`.
   **Внутри библиотеки этого пока нет:** `Chip`, `DropdownListItem`,
-  `DropdownMobileListItem`, `TabsLineItem` и `TabsExtendedTabButton` рендерят
+  `PullerListItem`, `TabsLineItem` и `TabsExtendedTabButton` рендерят
   `<Badge.Dot size={...} className={styles.notificationIcon} />` — без `aria-hidden`
   и без роли с именем. Точка там означает «есть новые уведомления», и подписью
   рядом этот смысл не дублируется, то есть для скринридера информация теряется.
@@ -166,7 +166,7 @@ Badge.Background
   цветами; наследует `IBadgeDotProps`.
 - `Chip` (`src/components/Chip/Chip.tsx:108`) — рендерит `Badge.Dot` как значок
   уведомления при `showNotificationIcon`.
-- `DropdownListItem`, `DropdownMobileListItem` — то же самое для пунктов выпадающего
+- `DropdownListItem`, `PullerListItem` — то же самое для пунктов выпадающего
   списка.
 - `TabsLineItem` (`src/components/TabsLine/components/TabsLineItem.tsx:78`),
   `TabsExtendedTabButton` (`src/components/TabsExtended/components/TabsExtendedTabButton.tsx:51`)
@@ -215,6 +215,7 @@ Badge.Background
 |---|---|
 | 2026-08-12 | Создан документ. AI-рефакторинг: JSDoc на всех props `IBadgeProps` / `IBadgeDotProps` / `IBadgeContentProps` с указанием размеров в px, в `IBadgeProps` добавлен явный `children` (тип совпадает с унаследованным из `React.HTMLAttributes`), расширены JSDoc компонентов и внутренних обёрток. Unit-тесты расширены с 12 до 45 кейсов: `Badge.test.tsx` вырос с 12 до 23 кейсов, рядом добавлены `BadgeDot.test.tsx` (7), `BadgeContent.test.tsx` (9) и `BadgeAffixes.test.tsx` (6) — покрыты логика снятия отступов контента, нерендеринг частей с falsy-значением, порядок частей разметки, проброс `...rest` и `ref`. Публичный API, DOM-разметка и визуальное поведение не изменены. |
 | 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`DropdownListItem`, `DropdownMobileListItem`, `TabsLineItem`, `TabsExtendedTabButton`); из `related` убраны несимметричные имена (`Text`, `Caption`) и потребитель `Chip` — он рендерит `Badge.Dot`, ссылка стоит с его стороны. Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
+| 2026-10-21 | Переход на `Puller` (TRIPLEX-961): `DropdownMobileListItem` переименован в `PullerListItem`. |
 
 ---
 

package/bundle/components/ButtonDropdown.md

@@ -1,7 +1,7 @@
 ---
 component: ButtonDropdown
 category: Buttons
-related: [Button, ButtonDropdownExtended, Dropdown]
+related: [Button, ButtonDropdownExtended, Dropdown, Puller]
 tokens: []
 stories: stories/Buttons/ButtonDropdown.stories.tsx
 version: "1.0"
@@ -56,7 +56,7 @@ version: "1.0"
 
 - Для `EButtonDotsTheme` prop `block` запрещён типизацией (`never`).
 - Dots-режим использует иконку `Dotshorizontal*` вместо текстового контента кнопки.
-- Desktop рендерит `DropdownList` с `DropdownList.Item`; mobile через `mobileViewProps` рендерит `DropdownMobileHeader` + `DropdownMobileList`.
+- Desktop рендерит `DropdownList` с `DropdownList.Item`; mobile через `pullerProps` рендерит `PullerHeader` + `PullerList`.
 
 ---
 
@@ -90,7 +90,8 @@ version: "1.0"
 
 - `Button` (`src/components/Button/Button.tsx`) — базовый триггер, на котором построен `ButtonDropdown`.
 - `ButtonDropdownExtended` (`src/components/Button/ButtonDropdownExtended.tsx`) — управляет открытием/закрытием dropdown через render-функции `renderButton` и `renderDropdown`.
-- `Dropdown` (`src/components/Dropdown`) — контейнер и пункты списка для desktop/mobile представления.
+- `Dropdown` (`src/components/Dropdown`) — контейнер и пункты списка для desktop-представления.
+- `Puller` (`src/components/Puller`) — мобильное представление: `PullerHeader`, `PullerClose`, `PullerBody`, `PullerList`, `PullerListItem`.
 
 ---
 
@@ -123,6 +124,7 @@ version: "1.0"
 | 2026-07-28 | AI-рефакторинг: dots- и обычный триггер объединены в один `renderButton` (общая a11y-обвязка), тема кнопки и палитра каретки выведены через мапы вместо `as`-каста и `switch`, удалено обращение к несуществующему CSS-классу `buttonDropdownMenu` (в LESS его не было, в сборке значение было `undefined`). Публичный API и разметка не изменились. Unit-тесты расширены до 32 кейсов. |
 | 2026-07-29 | Правки по ревью PR #482: типы триггера и props-интерфейсы вариантов теперь экспортируются (`TButtonDropdownButtonTheme`, `TButtonDropdownTheme`, `IButtonDropdownBaseProps`, `IButtonDotsProps`) — по конвенции все типы barrel-компонентов публичны; поведение не изменилось. |
 | 2026-07-29 | Отработка находок AI-рефакторинга: починен перехват пробела на триггере (сравнение по `event.code`; `Space` явно переключает dropdown), `label` опции больше не утекает в DOM-атрибут элемента списка, легализован controlled-режим — публичные props `opened` / `setOpened` (ранее `opened` работал только через нетипизированный spread). |
+| 2026-10-21 | Переход на `Puller` (TRIPLEX-961): мобильная версия собрана из частей `Puller` (бывший `DropdownMobile*`). |
 
 ---