@sberbusiness/triplex-next-mcp-server 1.40.0-beta → 1.41.0-beta

package/bundle/guides/commits.md

@@ -30,7 +30,8 @@ TRI-21-alert-ai-ready
 **Исключения:**
 - Релизная ветка: `prerelease-X.Y.Z` (например, `prerelease-1.40.0`) — в неё
   собираются фиксы релиза и бамп версии, PR идёт в `main`
-- Перелитие main → release-0: выполняется без отдельной ветки, прямым мержем
+- Перелитие main → release-0: выполняется человеком без отдельной ветки,
+  прямым мержем
 
 Исключение касается только **имени ветки**. Коммиты внутри неё подчиняются
 общему правилу `TRI-XXX`: на релиз заводится задача Linear, её номер идёт
@@ -48,11 +49,18 @@ TRI-21-alert-ai-ready
 
 **Правило:** все фича-ветки создаются от `main`. Изменения попадают в `release-0` через перелитие. Агент не должен создавать ветки от `release-0` и не должен мерджить в неё напрямую.
 
-**Единственное исключение** — skill `release-react17` в рамках выпуска релиза:
-он мержит `main` в `release-0` и пушит напрямую, без PR. Там это компенсируется
-обязательными локальными гейтами (`tsc`, `test-unit`, `build`) и показом diff
-разработчику — `ci.yml` триггерится только на `pull_request` и прямой push
-не проверяет. Вне релиза перелитие остаётся за мейнтейнерами.
+**Перелитие делает человек, не агент.** Мерж `main` → `release-0` идёт
+напрямую, без PR, с разрешением конфликтов React 17-адаптаций — это ручной
+шаг мейнтейнера в конце спринта. Правила разрешения конфликтов и регламент
+подготовки описаны в `.agents/skills/release-react17/SKILL.md` и
+`docs/human/release.md`. Прямой push в `release-0` проверяется CI:
+`ci.yml` триггерится на `push: branches: [release-0]`.
+
+**Единственное исключение для агента** — релизный коммит `release-react17`
+(бамп версии + release notes): он тоже пушится в `release-0` напрямую, без
+PR. Прогон CI на него стартует, но дождаться его нельзя — GitHub Release
+создаётся сразу после push. Поэтому исключение компенсируется обязательными
+локальными гейтами (`tsc`, `test-unit`, `build`).
 
 ---
 

package/bundle/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "triplexVersion": "1.40.0",
-  "generatedAt": "2026-07-31T18:40:47.583Z",
+  "triplexVersion": "1.41.0",
+  "generatedAt": "2026-08-07T11:02:25.745Z",
   "components": [
     {
       "name": "AbstractTree",
@@ -89,7 +89,7 @@
     },
     {
       "name": "Calendar",
-      "path": "src/components/Calendar/Calendar-AI.md",
+      "path": "src/components/Calendar/Calendar-ai.md",
       "file": "components/Calendar.md",
       "ai_ready": true
     },
@@ -150,7 +150,7 @@
     },
     {
       "name": "Chip",
-      "path": "src/components/Chip/Chip-AI.md",
+      "path": "src/components/Chip/Chip-ai.md",
       "file": "components/Chip.md",
       "ai_ready": true
     },
@@ -271,7 +271,7 @@
     },
     {
       "name": "FormField",
-      "path": "src/components/FormField/FormField-AI.md",
+      "path": "src/components/FormField/FormField-ai.md",
       "file": "components/FormField.md",
       "ai_ready": true
     },
@@ -307,7 +307,7 @@
     },
     {
       "name": "IconWrapper",
-      "path": "src/components/IconWrapper/IconWrapper-AI.md",
+      "path": "src/components/IconWrapper/IconWrapper-ai.md",
       "file": "components/IconWrapper.md",
       "ai_ready": true
     },
@@ -325,7 +325,7 @@
     },
     {
       "name": "Island",
-      "path": "src/components/Island/Island-AI.md",
+      "path": "src/components/Island/Island-ai.md",
       "file": "components/Island.md",
       "ai_ready": true
     },
@@ -343,7 +343,7 @@
     },
     {
       "name": "KeyDownListener",
-      "path": "src/components/KeyDownListener/KeyDownListener-AI.md",
+      "path": "src/components/KeyDownListener/KeyDownListener-ai.md",
       "file": "components/KeyDownListener.md",
       "ai_ready": true
     },
@@ -437,9 +437,15 @@
       "file": "components/Loader.md",
       "ai_ready": true
     },
+    {
+      "name": "LoaderMiddle",
+      "path": "src/components/Loader/LoaderMiddle-ai.md",
+      "file": "components/LoaderMiddle.md",
+      "ai_ready": true
+    },
     {
       "name": "LoaderScreen",
-      "path": "src/components/LoaderScreen/LoaderScreen-AI.md",
+      "path": "src/components/LoaderScreen/LoaderScreen-ai.md",
       "file": "components/LoaderScreen.md",
       "ai_ready": true
     },
@@ -704,7 +710,7 @@
     },
     {
       "name": "ThemeProvider",
-      "path": "src/components/ThemeProvider/ThemeProvider-AI.md",
+      "path": "src/components/ThemeProvider/ThemeProvider-ai.md",
       "file": "components/ThemeProvider.md",
       "ai_ready": true
     },
@@ -716,7 +722,7 @@
     },
     {
       "name": "Tooltip",
-      "path": "src/components/Tooltip/Tooltip-AI.md",
+      "path": "src/components/Tooltip/Tooltip-ai.md",
       "file": "components/Tooltip.md",
       "ai_ready": true
     },
@@ -1007,6 +1013,11 @@
       "file": "release-notes/1.41.0.mdx",
       "path": "stories/release-notes/v1/1.41.0.mdx"
     },
+    {
+      "version": "1.42.0",
+      "file": "release-notes/1.42.0.mdx",
+      "path": "stories/release-notes/v1/1.42.0.mdx"
+    },
     {
       "version": "1.5.0",
       "file": "release-notes/1.5.0.mdx",

package/bundle/release-notes/1.41.0.mdx

@@ -4,4 +4,80 @@ import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
 
 <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": "1.40.0-beta",
+  "version": "1.41.0-beta",
   "description": "MCP-сервер для дизайн-системы Triplex. Предоставляет AI-агентам документацию компонентов, дизайн-токены и примеры использования.",
   "author": "СберБизнес",
   "license": "MIT",