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

package/bundle/guides/commits.md

@@ -251,9 +251,46 @@ stories/release-notes/v1/<текущая версия>.mdx
 
 Компоненты внутри секции — в алфавитном порядке.
 
-Не нужно добавлять release notes для:
-- изменений только в stories/тестах/документации
-- рефакторинга без изменения публичного API
+### Главное правило: пиши только то, что стало новым для потребителя
+
+Release notes читает потребитель библиотеки, а не разработчик репозитория.
+Запись отвечает на один вопрос: **что изменилось для того, кто подключает
+компонент**. Всё остальное — лишнее.
+
+**Не попадает в release notes:**
+
+- внутренняя кухня репозитория: количество unit-тестов, созданные `*-ai.md`,
+  обновлённые stories и `ROADMAP.md`, JSDoc, переименования внутренних констант,
+  порядок импортов, чистка LESS;
+- перечисление того, что **не** изменилось: списки прежних props, значений
+  enum'ов, barrel-экспортов, границ диапазонов. Если поведение не изменилось,
+  достаточно сказать это одной фразой — без инвентаризации;
+- обоснования и подробности реализации, интересные только ревьюеру. Им место
+  в описании PR и в `{Component}-ai.md`.
+
+**Рефакторинг без изменений для потребителя — одна короткая строка:**
+
+```mdx
+**ComponentName**
+
+- Проведён AI-рефакторинг.
+```
+
+Если рефакторинг всё же дал потребителю что-то наблюдаемое (например
+`displayName`, видимый в React DevTools) — назови только это:
+
+```mdx
+**MediaWidth**
+
+- Проведён AI-рефакторинг, добавлен `displayName`.
+```
+
+Ориентир по объёму: запись про изменение поведения — 1–3 предложения, запись
+про рефакторинг — одна строка. Если запись разрослась до абзаца, скорее всего
+в неё попала внутренняя кухня — вычеркни её.
+
+Не нужно добавлять release notes для изменений только в stories, тестах или
+документации.
 
 ---
 

package/bundle/guides/context.md

@@ -274,6 +274,32 @@ AI-агента.
 
 ---
 
+## Как заполнять `related` в AI.md
+
+Индекс переходов для агента, а не «похожие компоненты»: только имена, пояснения —
+в разделе «Связанные компоненты». Имя обязано быть адресатом: компонентом из
+таблицы `docs/ai/ROADMAP.md`, у которого AI.md есть или запланирован. Связь с
+обёрткой вне таблицы записывается на её родителя (`IDropdownMobileMaskedInputProps
+extends IFormFieldMaskedInputProps` → `FormField`).
+
+Адресат попадает в `related`, только если подходит под одну из четырёх категорий:
+
+| # | Категория | Критерий | Направление |
+|---|---|---|---|
+| 1 | Семья | Родитель ↔ часть со своим AI.md | обе стороны |
+| 2 | Альтернатива | Решает ту же задачу другим компромиссом — реально спутают (`Island` → `IslandAccordion`). Отвод в другой класс задач («нужен отступ — возьми `Gap`») остаётся прозой в «Не используй когда» | обе стороны |
+| 3 | Контракт по рендеру | Импортирует и рендерит внутри себя (`Island` → `LoaderScreen`) | к зависимости |
+| 4 | Контракт по типам | Наследует чужой интерфейс props, в т.ч. `Pick<>` / `Omit<>` (`IConfirmProps extends IIslandProps` → у `Confirm` пишем `Island`). Наследование от React и от внутренних базовых интерфейсов не считается | от наследника к базе |
+
+Потребители не включаются — ссылка стоит с их стороны; исключение только для
+потребителя, который опирается на хрупкую деталь.
+
+Категории 1 и 2 симметричны, 3 и 4 односторонние. Порядок — семья → альтернативы
+→ контракты, ориентир 2–5 имён. Каждое имя из `related` должно быть объяснено в
+разделе «Связанные компоненты»; обратное не требуется.
+
+---
+
 ## Внешние ресурсы
 
 - Документация для разработчиков и дизайнеров: https://triplex-design.ru/next/ru/Web/Components

package/bundle/guides/stories.md

@@ -332,6 +332,7 @@ import { action } from "storybook/actions";
 **Исключаются при необходимости:**
 
 - Стори, дублирующие отображение другой стори. Если две стори рендерят визуально одно и то же — для теста оставьте одну, вторую исключите через `testRunner: { skip: true }`. Не нужно генерировать идентичные скриншоты.
+- **Компоненты без визуального интерфейса** — `KeyDownListener`, `ComposedKeyDownListener` и подобные обёртки, которые не рендерят собственной разметки (слушатели событий, провайдеры контекста). На скриншот попадает только обвязка примеров, поэтому регрессию компонента такой тест поймать не может, а перегенерации требует от любой правки примера. Набор исключается **целиком**: `testRunner: { skip: true }` ставится в `parameters` у `meta`, отдельные стори параметр не дублируют, стори `VisualTests` не создаётся, файлов в `__screenshots__/` быть не должно. Поведение таких компонентов покрывается unit-тестами.
 
 ### Когда создавать Visual tests
 
@@ -664,6 +665,7 @@ export { default as SizesSource } from "./Sizes?raw";
 
 Скриншот-тесты обязательны для UI-компонентов. Без baseline-файлов в `__screenshots__/` регрессию не поймать.
 
+- [ ] Компонент действительно рендерит собственную разметку. Если нет (слушатель событий, провайдер) — весь набор исключён через `testRunner: { skip: true }` в `meta`, `VisualTests` нет, baseline-файлов нет; остальные пункты этого раздела не применяются
 - [ ] Playground исключён из скриншот-тестов (`testRunner: { skip: true }`)
 - [ ] Нет дублирующих скриншотов — визуально идентичные стори исключены через `testRunner: { skip: true }`
 - [ ] Все ключевые визуальные состояния покрыты (размеры, статусы, заполненные поля, фокус)

package/bundle/guides/template.md

@@ -18,7 +18,7 @@ version: "1.0"
 
 Frontmatter:
 - tokens: список CSS-переменных, которые компонент использует
-- related: список связанных компонентов (строки, имена)
+- related: индекс переходов для агента. Полное правило: docs/ai/CONTEXT.md → «Как заполнять related в AI.md».
 
 Таблица Stories: колонка `Example file` обязательна — её читает сборщик
 mcp-data.json, чтобы инлайнить код примера. См. раздел Stories ниже.

package/bundle/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "triplexVersion": "1.41.0",
-  "generatedAt": "2026-08-07T11:02:25.745Z",
+  "triplexVersion": "1.42.0",
+  "generatedAt": "2026-08-14T12:59:51.290Z",
   "components": [
     {
       "name": "AbstractTree",
@@ -27,9 +27,15 @@
       "file": "components/AlertContext.md",
       "ai_ready": true
     },
+    {
+      "name": "AlertProcess",
+      "path": "src/components/Alert/AlertProcess-ai.md",
+      "file": "components/AlertProcess.md",
+      "ai_ready": true
+    },
     {
       "name": "Amount",
-      "path": "src/components/Amount/Amount-AI.md",
+      "path": "src/components/Amount/Amount-ai.md",
       "file": "components/Amount.md",
       "ai_ready": true
     },
@@ -47,13 +53,13 @@
     },
     {
       "name": "Badge",
-      "path": "src/components/Badge/Badge-AI.md",
+      "path": "src/components/Badge/Badge-ai.md",
       "file": "components/Badge.md",
       "ai_ready": true
     },
     {
       "name": "Body",
-      "path": "src/components/Body/Body-AI.md",
+      "path": "src/components/Body/Body-ai.md",
       "file": "components/Body.md",
       "ai_ready": true
     },
@@ -114,7 +120,7 @@
     },
     {
       "name": "CarouselExtended",
-      "path": "src/components/CarouselExtended/CarouselExtended-AI.md",
+      "path": "src/components/CarouselExtended/CarouselExtended-ai.md",
       "file": "components/CarouselExtended.md",
       "ai_ready": true
     },
@@ -184,6 +190,12 @@
       "file": "components/CollapsibleTreeExtended.md",
       "ai_ready": true
     },
+    {
+      "name": "ComposedKeyDownListener",
+      "path": "src/components/KeyDownListener/ComposedKeyDownListener-ai.md",
+      "file": "components/ComposedKeyDownListener.md",
+      "ai_ready": true
+    },
     {
       "name": "Confirm",
       "path": "src/components/Confirm/Confirm-AI.md",
@@ -449,6 +461,12 @@
       "file": "components/LoaderScreen.md",
       "ai_ready": true
     },
+    {
+      "name": "LoaderSmall",
+      "path": "src/components/Loader/LoaderSmall-ai.md",
+      "file": "components/LoaderSmall.md",
+      "ai_ready": true
+    },
     {
       "name": "Marker",
       "path": "src/components/Marker/Marker-AI.md",
@@ -461,15 +479,21 @@
       "file": "components/MarkerStatus.md",
       "ai_ready": true
     },
+    {
+      "name": "MaskedField",
+      "path": "src/components/TextField/MaskedField-ai.md",
+      "file": "components/MaskedField.md",
+      "ai_ready": true
+    },
     {
       "name": "MediaWidth",
-      "path": "src/components/MediaWidth/MediaWidth-AI.md",
+      "path": "src/components/MediaWidth/MediaWidth-ai.md",
       "file": "components/MediaWidth.md",
       "ai_ready": true
     },
     {
       "name": "MobileView",
-      "path": "src/components/MobileView/MobileView-AI.md",
+      "path": "src/components/MobileView/MobileView-ai.md",
       "file": "components/MobileView.md",
       "ai_ready": true
     },
@@ -560,7 +584,7 @@
     },
     {
       "name": "SelectExtendedField",
-      "path": "src/components/SelectExtendedField/SelectExtendedField-AI.md",
+      "path": "src/components/SelectExtendedField/SelectExtendedField-ai.md",
       "file": "components/SelectExtendedField.md",
       "ai_ready": true
     },
@@ -1013,11 +1037,21 @@
       "file": "release-notes/1.41.0.mdx",
       "path": "stories/release-notes/v1/1.41.0.mdx"
     },
+    {
+      "version": "1.41.1",
+      "file": "release-notes/1.41.1.mdx",
+      "path": "stories/release-notes/v1/1.41.1.mdx"
+    },
     {
       "version": "1.42.0",
       "file": "release-notes/1.42.0.mdx",
       "path": "stories/release-notes/v1/1.42.0.mdx"
     },
+    {
+      "version": "1.43.0",
+      "file": "release-notes/1.43.0.mdx",
+      "path": "stories/release-notes/v1/1.43.0.mdx"
+    },
     {
       "version": "1.5.0",
       "file": "release-notes/1.5.0.mdx",

package/bundle/release-notes/1.41.1.mdx

@@ -0,0 +1,18 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.41.1" />
+
+<Title>v1.41.1</Title>
+
+<Heading>Изменения</Heading>
+
+**Page**
+
+- `Page.Header` и `Page.Footer` со свойством `sticky` теперь прилипают и вне `LightBox` при ширине viewport от 992px. При высоте viewport до 800px включительно sticky-позиционирование не применяется.
+
+**SelectExtendedField**
+
+- Исправлено: `onOpen` / `onClose` ложно срабатывали при повторном маунте в React 18 StrictMode — эффект опирался на флаг «смонтирован». Теперь сравнивается предыдущее значение состояния открытости, поэтому колбэки вызываются только на реальную смену состояния и по-прежнему не вызываются на первом рендере.
+- Исправлено: клик по кнопке очистки (`onClear`) в `SelectExtendedFieldTarget` заодно раскрывал выпадающий блок — событие всплывало до обработчика клика по полю. Теперь всплытие останавливается, как это уже сделано в `Chip.Select` и `Chip.DatePicker`. Затрагивает также `SelectField` и `MultiselectField`, использующие тот же `Target`.
+- Исправлено: `SelectExtendedFieldTarget` подмешивал в атрибут `class` литерал `undefined` — в `clsx` попадали ключи `styles.loading`, `styles.placeholder` и `styles.label`, которых нет в LESS-модуле компонента. Стили этих классов никогда не существовали, поэтому визуально ничего не меняется. Затрагивает также `SelectField` и `MultiselectField.Target`, использующие тот же компонент.
+- AI-рефакторинг: JSDoc на всех props и рендер-функциях, константы-маппинги размера приведены к общему стилю именования, коды клавиш открытия вынесены в константу модуля, слушатель `mousedown` на документе навешивается только пока выпадающий блок открыт, callback-ref корневого элемента стабилизирован, в `SelectExtendedFieldTarget` убрана неиспользуемая внутренняя ссылка (ref по-прежнему указывает на элемент значения), в `SelectExtendedFieldDropdownDefault` дедуплицирован список опций десктопной и мобильной версий, у `SelectExtendedFieldDropdown` и `SelectExtendedFieldDropdownDefault` добавлен `displayName`. Unit-тесты разбиты по субкомпонентам и расширены с 42 до 69 кейсов, stories переведены на modern pattern, создан `SelectExtendedField-ai.md`. Публичный API не изменён (props, их типы, barrel-экспорты, `forwardRef` — как были).

package/bundle/release-notes/1.42.0.mdx

@@ -4,4 +4,85 @@ import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
 
 <Title>v1.42.0</Title>
 
+<Heading>Ломающие изменения</Heading>
+
+**FormFieldMaskedInput**
+
+- Prop `defaultValue` исключён из `IFormFieldMaskedInputProps` — поле контролируемое, начальное значение задаётся через `value`. Затрагивает также `MaskedField.maskedInputProps` и `DropdownMobileMaskedInput`.
+
+**MaskedField**
+
+- Тип `maskedInputProps.ref` изменён с `React.RefObject<HTMLInputElement>` на `React.RefObject<HTMLDivElement>` — ref указывает на `<div>`-обёртку поля. Для ссылки на `<input>` используйте `maskedInputProps.forwardedRef`.
+
 <Heading>Изменения</Heading>
+
+**AlertProcess**
+
+- Исправлено: `className`, переданный в `AlertProcess.Spoiler`, больше не затирает собственные классы элемента — раньше вместе с пользовательским классом пропадала анимация раскрытия.
+- Исправлено: `AlertProcess.Spoiler` пробрасывает `ref` — на элемент раскрываемого контента, то есть на тот же элемент, что получает `...rest`.
+- Изменено: из разметки `AlertProcess.Spoiler` убрана пустая обёртка-`<div>`, корневым элементом стал элемент раскрываемого контента. Визуально ничего не изменилось, но код, опиравшийся на лишний уровень вложенности в CSS-селекторах или в поиске по DOM, нужно поправить.
+- Добавлено: на кнопке раскрытия `AlertProcess.Spoiler` выставляется `aria-expanded` — состояние раскрытия доступно скринридерам.
+- Проведён AI-рефакторинг.
+
+**Amount**
+
+- Добавлено: `Amount` пробрасывает `ref` — компонент был объявлен как `React.FC`. Теперь это `forwardRef`, ref указывает на корневой `<span>`, то есть на тот же элемент, что получает `className` и `...rest`. Изменение аддитивное: форма `IAmountProps` не поменялась.
+- Проведён AI-рефакторинг.
+
+**Badge**
+
+- Проведён AI-рефакторинг.
+
+**Body**
+
+- Проведён AI-рефакторинг. Публичный API, разметка и внешний вид не изменились.
+
+**CarouselExtended**
+
+- Проведён AI-рефакторинг. Стабильный колбэк-`ref` больше не вызывается заново (с `null` и снова с узлом) при каждом ре-рендере.
+
+**ComposedKeyDownListener**
+
+- Исправлено: смена набора горячих клавиш перемонтировала содержимое — `children` пересоздавались вместе с DOM-узлами и теряли введённые значения инпутов, фокус и текущие анимации. Теперь структура React-дерева не зависит от длины и порядка `keyDownListeners`, содержимое остаётся смонтированным.
+- Изменился относительный порядок подписок на `window`: слушатели композитора монтируются раньше `children`, а не после них. Если внутри `children` есть собственный глобальный `keydown`-обработчик той же клавиши, `onMatch` сработает раньше него, а не позже — важно для кода, который полагается на этот порядок или на `stopImmediatePropagation`. Итоговый DOM и порядок вызова `onMatch` внутри `keyDownListeners` прежние.
+
+**FormFieldMaskedInput**
+
+- Исправлено: поле перестало писать в консоль предупреждение React «input contains both value and defaultValue props».
+
+**Island**
+
+- Расширение API: свойства `loading` и `loaderScreenProps`. При `loading` поверх контента карточки показывается `LoaderScreen` типа `middle`, настраиваемый через `loaderScreenProps`.
+
+**DateField / MonthYearField**
+
+- Добавлено ограничение по минимальной ширине.
+
+**LoaderSmall**
+
+- Проведён AI-рефакторинг; экспортируемый `ELoaderSmallSize` помечен как legacy — размер задаётся `EComponentSize`.
+
+**MaskedField**
+
+- Проведён AI-рефакторинг. Поведение и разметка не изменились, изменения типов — см. «Ломающие изменения».
+
+**MediaWidth**
+
+- Проведён AI-рефакторинг, добавлен `displayName`.
+
+**FormFieldMaskedInput**
+
+- Исправлен выход подложки-плейсхолдера за границы контейнера при нехватке свободного места.
+
+**MobileView**
+
+- Проведён AI-рефакторинг, добавлен `displayName`.
+
+**Pagination**
+
+- Внутри `MasterTable` в состоянии `loading` элементы пагинации становятся неактивными - кнопки навигации и номера страниц получают `disabled`, селект количества строк не открывается.
+- Исправлена обработка `status` в `PaginationSelect`.
+
+**SuggestField**
+
+- Исправлен баг, при котором свойства `prefix`/`postfix`/`description`/`counter` не прокидывались в адаптивном режиме.

package/bundle/release-notes/1.43.0.mdx

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

package/package.json

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