@sberbusiness/triplex-next-mcp-server 0.36.0-beta0 → 1.41.0-beta

package/bundle/release-notes/1.38.0.mdx

@@ -0,0 +1,36 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.38.0" />
+
+<Title>v1.38.0</Title>
+
+<Heading>Ломающие изменения</Heading>
+
+**ListTableItem**
+
+- Компонент `ListItemTable` переименован в `ListTableItem`.
+- Типы `IListItemTableProps` / `IListItemTableSelectableProps` переименованы в `IListTableItemProps` / `IListTableItemSelectableProps`.
+
+<Heading>Новые компоненты</Heading>
+
+**ListActionItem**
+
+- Интерактивная обёртка над `ListItem` и `ListItemContent`, которая добавляет элементу списка состояния hover, focused и позволяет передавать `listItemContentProps`.
+
+<Heading>Изменения</Heading>
+
+**Button / ButtonIcon / ButtonDropdown**
+
+- Исправлено вертикальное выравнивание кнопок в inline-контейнерах (например, в `Page.Header.Title.Controls`): icon-only кнопка смещалась относительно соседней текстовой из-за baseline-выравнивания. Кнопкам задан `vertical-align: middle` — кнопки разной высоты центрируются между собой и относительно строки инлайн-текста.
+
+**CollapsibleTree**
+
+- Класс `hoverable` (стили `@sberbusiness/icons-next`) на кнопке заголовка узла теперь установлен всегда, а не только в состоянии `disabled` — корректная окраска шеврона при наведении.
+
+**IslandWidget**
+
+- Начертание шрифта `Title` изменено на `Medium`.
+
+**LightBox**
+
+- Исправлено добавление класса `undefined` на корневой элемент в состоянии `isLoading`.

package/bundle/release-notes/1.39.0.mdx

@@ -0,0 +1,66 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.39.0" />
+
+<Title>v1.39.0</Title>
+
+<Heading>Новые компоненты</Heading>
+
+**Carousel**
+
+- Карусель (бета-версия).
+
+<Heading>Ломающие изменения</Heading>
+
+**Button**
+
+- `ButtonBase` (и `IButtonBaseProps`) убран из barrel-экспорта `components/Button` — это внутренний базовый компонент. При необходимости импорт доступен по прямому пути `@sberbusiness/triplex-next/components/Button/ButtonBase`.
+
+<Heading>Изменения</Heading>
+
+**Button**
+
+- Исправлено: строковое значение `aria-expanded="false"` ошибочно включало визуальное состояние «раскрыто» (класс `expanded` и активное состояние иконки). Раскрытым теперь считается только `true` / `"true"`.
+- `size` стал опциональным со значением по умолчанию `EComponentSize.MD` — типы приведены в соответствие с реализацией.
+- AI-рефакторинг: JSDoc на props и компоненте, unit-тесты расширены с 10 до 27 кейсов. Остальной публичный API не изменён.
+
+**AlertContext**
+
+- AI-рефакторинг: JSDoc на всех props, выбор иконки по умолчанию переведён на маппинг типов. Из стилей удалены избыточные `font-size` / `line-height` — типографику текста задаёт `Text`.
+
+**ButtonDropdown**
+
+- AI-рефакторинг: JSDoc на компоненте, dots- и обычный триггер объединены в один рендер с общей a11y-обвязкой, тема кнопки и палитра каретки выведены через маппинги вместо приведения типа и `switch`, добавлены unit-тесты. Сам рефакторинг поведение и разметку не менял; расширение API и поведенческие исправления — отдельные пункты ниже.
+- Типы триггера и props-интерфейсы вариантов теперь экспортируются: `TButtonDropdownButtonTheme`, `TButtonDropdownTheme`, `IButtonDropdownBaseProps`, `IButtonDotsProps` (расширение API, поведение не изменилось).
+- Исправлено: перехват `Space` на кнопке-триггере не срабатывал (обработчик сравнивал `event.key` с легаси-значениями) — теперь сравнение идёт по `event.code`, пробел явно открывает/закрывает dropdown с корректным `preventDefault`.
+- Исправлено: `label` опции утекал в DOM как невалидный атрибут элемента выпадающего списка (для не-строковых `label` — с warning в консоли React).
+- Новые props `opened` / `setOpened` — типизированный controlled-режим открытости dropdown (ранее `opened` работал только через нетипизированный spread во внутренний `ButtonDropdownExtended`).
+
+**Col**
+
+- Компонент `Col` переведён на использование `forwardRef` (ref ведёт на корневой `div`).
+- AI-рефакторинг: JSDoc на всех props и экспортируемых типах. Публичный API не изменён.
+
+**Page**
+
+- Вертикальные внутренние отступы изменены: 24px (было 32px) для desktop и 8px (было 16px) для мобильных экранов. Горизонтальные отступы не изменились.
+
+**LightBox / LightBoxSideOverlay**
+
+- Удалены избыточные переопределения вертикальных отступов `Page` — отступы теперь задаются только стилями самого `Page` (визуальный результат не изменился).
+
+**LightBox**
+
+- Исправлено: клавиатурные триггеры контролов (`clickByArrowLeft` / `clickByArrowRight` у `Controls.Prev` / `Controls.Next`) не срабатывали на экранах шире 1024px, а Esc у `Controls.Close` — на экранах уже 1024px (триггер ссылался на скрытую кнопку другого режима).
+- Исправлено: при размонтировании лайтбокса в течение 100мс после открытия скролл страницы мог остаться заблокированным (незачищенный таймер возвращал класс `bodyOverflowHidden`). Таймер-фикс заменён счётчиком открытых лайтбоксов, сценарий переключения между лайтбоксами через роутер сохранён.
+- Исправлено: `LightBoxViewManager` не снимал с mount-ноды CSS-классы позиционирования (`LightBoxMountNodeViewManager`, `LB-*`) при размонтировании; классы удаляются при размонтировании последнего лайтбокса.
+- AI-рефакторинг: JSDoc на всех props, общая реализация стрелок Prev/Next, общий хук видимости сайдбаров, unit-тесты. Публичный API не изменён; props-интерфейсы контролов и `SideOverlayLoader` теперь экспортируются.
+
+**Row**
+
+- Добавлен `forwardRef` — ref пробрасывается на корневой `div`.
+- AI-рефакторинг: JSDoc на всех props и контексте, значение `RowContext` мемоизировано (предотвращает перерендеры колонок `Col` через контекст, пока `gridHorizontalGap` не меняется). Публичный API не изменён.
+
+**Typography (Text / Title / Caption / CodeText)**
+
+- AI-рефакторинг: JSDoc на всех props и значениях enum (подсказки в IDE), дублирующаяся логика классов `underline` / `strikethrough` вынесена во внутренний хелпер. Публичный API не изменён.

package/bundle/release-notes/1.40.0.mdx

@@ -0,0 +1,27 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.40.0" />
+
+<Title>v1.40.0</Title>
+
+<Heading>Изменения</Heading>
+
+**Dropdown**
+
+- Исправлена автопрокрутка выпадающего списка к активному элементу: контейнер списка больше не пересоздаёт ref на каждом рендере, поэтому при навигации стрелками и при открытии меню с выбранной опцией список прокручивается к ней.
+- Исправлен клавиатурный обработчик пункта списка: выбор активного пункта теперь всегда вызывает актуальный `onSelect` (раньше после перерисовки мог вызываться устаревший обработчик).
+- Исправлено: `Dropdown` вызывает актуальные `onOpen` / `onClose`, если они изменились между рендерами.
+- Исправлено «мигание» `aria-activedescendant` на управляющем элементе при навигации стрелками: очистка активного элемента больше не срабатывает на каждую его смену, а только при закрытии и размонтировании списка. Затрагивает `SelectField`, `ButtonDropdown` и `SuggestField`.
+- AI-рефакторинг: JSDoc на компонентах и props, логика прокрутки списка вынесена во внутренние хелперы, удалено обращение к несуществующему CSS-классу в мобильном списке, добавлены таймеры-очистки в мобильном контейнере, добавлены unit-тесты. Публичный API не изменён (props, значения enum, barrel-экспорты, `forwardRef` — как были).
+
+**List**
+
+- Исправлен цвет фона `ListItemTail` в темной теме.
+
+**Table**
+
+- Исправлено вертикальное положение chipPanelLinks.
+
+**Сборка пакета**
+
+- Исправлено: в 1.39.0 в опубликованный бандл попадал `vitest`, из-за чего импорт практически любого компонента ронял приложение потребителя с ошибкой `Uncaught Error: Vitest failed to access its internal state`.

package/bundle/release-notes/1.41.0.mdx

@@ -0,0 +1,83 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.41.0" />
+
+<Title>v1.41.0</Title>
+
+<Heading>Ломающие изменения</Heading>
+
+**FormField**
+
+- `statusToClassNameMap` больше не экспортируется — ни из `components/FormField`, ни из корня пакета. Маппинг статуса на CSS-класс переименован во внутреннюю константу `STATUS_TO_CLASS_NAME_MAP` и стал деталью реализации компонента. Воспроизвести его на стороне потребителя нельзя: имена классов хешируются при сборке вместе с версией библиотеки (`error` → `error__58eeaf1b`) и меняются от релиза к релизу. Визуальное состояние поля задаётся prop `status` у `FormField` — используйте его; если нужно опереться на состояние в собственных стилях, навешивайте свой класс рядом.
+
+<Heading>Изменения</Heading>
+
+**Calendar**
+
+- Изменён цвет muted/disabled дня/месяца/года в тёмной теме.
+- AI-рефакторинг: JSDoc на props и внутренних компонентах, codestyle-чистка, unit-тесты (Calendar, CalendarViewItem, utils), создан `Calendar-ai.md`. Публичный API не изменён; внутренний `CalendarFooter` теперь применяет объявленные, но ранее игнорировавшиеся `className` и `...rest`.
+- Исправлено: для `pickType={ECalendarPickType.MONTH_YEAR}` внешняя смена `pickedDate` на другой месяц выставляла заголовок в формате «March 1970» вместо «1970» — до следующего перелистывания. Заголовок теперь всегда форматируется по текущему виду отображения.
+- Исправлено: после смены страницы с клавиатуры (`PageUp` / `PageDown`) фокус не возвращался на новую tabbable-ячейку, если она занимала ту же позицию сетки (в видах месяцев и годов — всегда). Фокус восстанавливается только когда он уже находился внутри сетки — программная смена страницы фокус не забирает.
+- Исправлено: выбор первой tabbable-ячейки страницы (когда `pickedDate` вне страницы, а начальные даты отключены) перебирал кандидатов с накоплением шага (0, +1, +3, +6…), а в виде годов прибавлял месяцы вместо лет — tabbable-ячейкой могла стать не первая доступная дата, либо она не назначалась вовсе.
+- Расширение API: поля `dateFrom` / `dateTo` в `IDateLimitRange` стали опциональными — типы приведены к фактическому поведению: незаданная граница берётся из `globalLimitRange`. Внешнему TS-коду, читающему эти поля, может потребоваться проверка на `undefined`.
+- Расширение API: функциональный вариант `dayHtmlAttributes` теперь допускает возврат `data-*` атрибутов (`TTdHTMLAttributesWithData`) — как и объектный вариант. Функции с явной аннотацией возврата старым типом `React.TdHTMLAttributes<…>` нужно перевести на `TTdHTMLAttributesWithData`.
+
+**CardAction, CardStatic**
+
+- В `ECardRoundingSize` добавлено значение `LG` — скругление 24px. Существующие `MD` (16px) и `SM` (8px) не изменились, значение по умолчанию осталось `MD`.
+
+**Chip**
+
+- AI-рефакторинг: JSDoc на props (у `size` и `type` в описании указаны значения по умолчанию) и на внутреннем обработчике клавиатуры, константы-маппинги типа и размера приведены к общему стилю именования, упрощены условия формирования классов, unit-тесты расширены с 5 до 22 кейсов. Публичный API, DOM и визуальное поведение не изменены.
+- `children` явно объявлен в `IChipProps` — тип прежний (раньше приходил из `React.HTMLAttributes`), но у prop появилось описание в подсказках IDE и в таблице props.
+
+**FocusTrapExtended**
+
+- Оптимизировано управление стеком ловушек фокуса во вложенных окнах за счет перевода активного инстанса на контролируемую паузу вместо его деактивации.
+
+**FormField**
+
+- Исправлено: `className`, переданный в `FormFieldDescription` или `FormFieldCounter`, затирал базовый класс компонента вместо того, чтобы дополнять его. Теперь классы объединяются, как у остальных компонентов библиотеки.
+- AI-рефакторинг: документация props и значений `EFormFieldStatus`, внутренние упрощения и расширенные unit-тесты. Охвачены `FormFieldInput`, `FormFieldLabel`, `FormFieldPrefix`, `FormFieldPostfix`, `FormFieldClear`, `FormFieldDescription`, `FormFieldCounter`. Остальной публичный API не изменён.
+
+**IconWrapper**
+
+- AI-рефакторинг: JSDoc на props, расширены unit-тесты. Публичный API и поведение не изменены.
+
+**Island**
+
+- Исправлено: `className`, переданный в `IslandHeader` (`Island.Header`) или `IslandFooter` (`Island.Footer`), затирал базовый класс компонента вместо того, чтобы дополнять его. Теперь классы объединяются, как в `IslandBody` и у остальных компонентов библиотеки. Это влияет на любой код, передающий `className` в эти части: базовый класс остаётся на элементе, поэтому к нему снова применяются отступы `Island` и `position: relative` из стилей части. Последнее меняет containing block — абсолютно спозиционированные потомки внутри такой части теперь позиционируются относительно неё, а не относительно ближайшего внешнего positioned-предка. Компоненты самой библиотеки выглядят как прежде: единственный затронутый — `IslandAccordion`, в его стилях отступ Island погашен явно.
+- AI-рефакторинг: JSDoc на props, значениях `EIslandType` и субкомпонентах, `displayName` у `IslandHeader`, `IslandBody`, `IslandFooter`, добавлены unit-тесты. Публичный API не изменён (props, значения enum, barrel-экспорты, `forwardRef` — как были).
+
+**KeyDownListener**
+
+- AI-рефакторинг: JSDoc на props, обработчик нажатия сведён к одной проверке кода клавиши, в `ComposedKeyDownListener` убрано приведение типа `children` и добавлен `displayName`, добавлены unit-тесты и stories. Существующий публичный API не изменён (props, их типы, class-компонент `KeyDownListener` с публичным методом `handleKeyDown` — как были).
+- Интерфейс props `IComposedKeyDownListenerProps` теперь экспортируется из пакета — можно типизировать собственные обёртки над `ComposedKeyDownListener`.
+- Исправлено: `ComposedKeyDownListener` с пустым `keyDownListeners` и без `children` больше не возвращает `undefined` из рендера — на React 17 это приводило к ошибке «Nothing was returned from render».
+
+**LoaderMiddle**
+
+- AI-рефакторинг: JSDoc на компоненте, порядок импортов приведён к codestyle, в стилях объединены дублирующиеся базовые правила точек и обегающей линии, unit-тесты расширены с 1 до 2 кейсов, создан `LoaderMiddle-ai.md`. В stories `controls: { disable: true }` перенесён на верхний уровень `parameters` — внутри `docs` он не применялся. Публичный API и поведение не изменены (props, DOM-разметка, `role="status"`, токены — как были).
+
+**LoaderScreen**
+
+- AI-рефакторинг: JSDoc на компоненте, props и `ILoaderScreenMiddleProps` (у `size` указано значение по умолчанию), соответствие типа лоадера классу подложки вынесено в константу-маппинг, порядок импортов и позиция `className` в `clsx` приведены к общему стилю, unit-тесты расширены с 6 до 15 кейсов, создан `LoaderScreen-ai.md`. Публичный API, DOM и визуальное поведение не изменены — изменился только порядок классов внутри атрибута `class` корневого элемента (набор классов тот же, на каскад не влияет).
+
+**StatusTracker**
+
+- Добавлены токены `StatusTracker.Background` и `StatusTracker.Draft_Color`.
+- Токен `StatusTracker.Draft_Background` теперь задает цвет подсветки статуса `draft`.
+- Изменены цвета токенов `StatusTracker.Draft_Background`, `StatusTracker.Draft_Color`, `StatusTracker.Rejected_Color` в светлой и темной темах.
+- Минимальная высота изменена для десктоп экранов и удалена для мобильных экранов.
+
+**ThemeProvider**
+
+- AI-рефакторинг: JSDoc на props, значениях `ETriplexNextTheme` и полях контекста темы, ключ тега стилей с css-переменными вынесен в отдельный хелпер (раньше строка собиралась в двух местах), упрощён эффект навешивания `scopeClassName` — убран дублирующий его ref. Добавлены unit-тесты на `ThemeProviderView` и `useToken`. Публичный API, DOM и поведение не изменены.
+
+**Tooltip**
+
+- Исправлено: подсказка, смонтированная сразу открытой (управляемый режим `isOpen`), не закрывалась по действию мышью вне неё — при монтировании навешивался обработчик `click`, а снимался `mousedown`.
+- Исправлено: класс темы больше не снимается с контейнера, если в течение задержки закрытия подсказку открыли снова или контейнер занял другой `Tooltip`.
+- Исправлено: в адаптивном (мобильном) режиме свойства `size` и `alignTip` больше не уходят в DOM — React больше не предупреждает о нераспознанном атрибуте `alignTip`.
+- Исправлено: при размонтировании открытой подсказки с `toggleType="hover"`, а также при смене `toggleType` на лету обработчики наведения снимаются и навешиваются и на саму подсказку, а не только на целевой элемент.
+- AI-рефакторинг: разбор `children` вынесен в чистую функцию и мемоизирован, значение контекста стабилизировано, дедуплицирована разметка `Tooltip.Link`, из расчёта координат убрано двойное приведение типов, в хуке темы вынесен хелпер и добавлен guard при размонтировании, `displayName` внутреннего `TooltipDesktopBase` приведён к имени класса, добавлены JSDoc на props и приватные методы, добавлены unit-тесты. Публичный API не изменён (props, значения enum, barrel-экспорты, `forwardRef` — как были).

package/bundle/release-notes/1.42.0.mdx

@@ -0,0 +1,7 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.42.0" />
+
+<Title>v1.42.0</Title>
+
+<Heading>Изменения</Heading>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sberbusiness/triplex-next-mcp-server",
-  "version": "0.36.0-beta0",
+  "version": "1.41.0-beta",
   "description": "MCP-сервер для дизайн-системы Triplex. Предоставляет AI-агентам документацию компонентов, дизайн-токены и примеры использования.",
   "author": "СберБизнес",
   "license": "MIT",