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

package/bundle/components/KeyDownListener.md

@@ -117,8 +117,8 @@ version: "1.0"
 - `TriggerClickOnKeyDownEvent` (`src/components/Triggers/`) — по нажатию клавиши
   вызывает `click` на элементе из `targetRef`.
 - `SelectExtendedField` — закрывает выпадающий список по `Esc`.
-- `SliderExtendedDot`, `SliderExtendedTrack` — стрелки для перемещения ползунка,
-  слушатели монтируются только когда элемент в фокусе.
+- `SliderExtended` (`SliderExtendedDot`, `SliderExtendedTrack`) — стрелки для перемещения
+  ползунка, слушатели монтируются только когда элемент в фокусе.
 
 ---
 
@@ -149,6 +149,7 @@ version: "1.0"
 | 2026-08-11 | TRI-112: у `ComposedKeyDownListener` появились собственный `ComposedKeyDownListener-ai.md` и набор stories `stories/ComposedKeyDownListener/`; раздел «Связанные компоненты» сокращён до ссылки, story `Example` (демонстрация композитора) перенесена в новый набор. Ограничение на стабильную длину `keyDownListeners` снято — композитор рендерит слушателей соседями к `children`. Набор stories `KeyDownListener` исключён из скриншот-тестов, story `VisualTests` и baseline удалены — визуального интерфейса у компонента нет. Реализация самого `KeyDownListener` не менялась. |
 | 2026-08-04 | По ревью PR #502: интерфейс props `IComposedKeyDownListenerProps` стал экспортируемым — публичная поверхность пакета расширена аддитивно. `ComposedKeyDownListener` добавлен отдельной строкой в `docs/ai/ROADMAP.md`, собственный AI.md вынесен в отдельную задачу. |
 | 2026-08-04 | Создан документ. AI-рефакторинг (TRI-48): JSDoc на props `IKeyDownListenerProps` и `ComposedKeyDownListener`, ветвление в `handleKeyDown` сведено к одной проверке (снят `eslint-disable`), в `ComposedKeyDownListener` убран `as JSX.Element` и добавлен `displayName`, unit-тесты (16 кейсов на оба компонента), stories по modern pattern. Публичный API не менялся; компонент остаётся class-компонентом, `forwardRef` осознанно отсутствует. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): в «Связанных компонентах» потребители `SliderExtendedDot` / `SliderExtendedTrack` названы через адресата `related` — `SliderExtended`. Публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/LightBox.md

@@ -1,7 +1,7 @@
 ---
 component: LightBox
 category: LightBox
-related: [Page, TopOverlay, Portal, FocusTrapExtended, LoaderScreen, Button, ModalWindow]
+related: [Page, TopOverlay, Portal, LoaderScreen, Button, ModalWindow, Overlay]
 tokens:
   - LightBox.Backdrop_Background
   - LightBox.Content_Background
@@ -101,6 +101,13 @@ LightBox.SideOverlay_Background
 css-переменную `--lightBox-scroll-width`, которую вычитают из ширины оверлеев. Ширины размеров
 (`664/864/1064/1264`) заданы LESS-константами `@lightBox-content-max-width-*`.
 
+Боковые отступы контента лайтбокса (`@lightBoxContentPaddingX`, 80px — место под кнопки
+вперёд/назад, на экранах до 1024px включительно 0) публикуются css-переменной
+`--lightBox-content-padding-x` на `.lightBoxContent`. По ней потомки выравниваются с колонкой
+страницы — так это делает обёртка `TopOverlay`. Переменная объявлена именно на `.lightBoxContent`,
+поэтому вне его поддерева (например в `LightBox.SideOverlay` — он сиблинг `LightBox.Content`,
+а не его потомок) она не видна, и читающие её стили получают фолбэк 0.
+
 ---
 
 ## Инварианты
@@ -166,10 +173,15 @@ css-переменную `--lightBox-scroll-width`, которую вычита
 - `LightBoxControls` + `LightBoxClose` / `LightBoxPrev` / `LightBoxNext` (`LightBoxControls/`) — кнопки управления; стрелки построены на общем внутреннем `LightBoxArrow` (не экспортируется)
 - `LightBoxLeftSidebar` / `LightBoxRightSidebar` (`LightBoxSidebars/`) — сайдбары с автоскрытием содержимого по ширине (общий хук `useLightBoxSidebarVisibility`)
 - `LightBoxSideOverlay` (`LightBoxSideOverlay/`) — выезжающая справа панель с собственным focus trap, лоадером и кнопками закрытия CloseDesktop/CloseMobile
+- `FocusTrapExtended` (`src/components/FocusTrapExtended`) — focus trap окна и боковой панели; настраивается через `focusTrapProps` (`IFocusTrapExtendedProps`). Своего AI.md и строки в `docs/ai/ROADMAP.md` не имеет
 - `LightBoxViewManager` (`LightBoxViewManager/`) — внутренний менеджер позиционирования: следит за границами view-manager-ноды, проставляет breakpoint-классы и CSS-переменные
 - `TopOverlay` (`src/components/TopOverlay`) — верхняя панель, реэкспортируется как `LightBox.TopOverlay`
 - `Page` (`src/components/Page`) — рекомендуемая структура содержимого `LightBox.Content`
 - `ModalWindow` — альтернатива для компактных диалогов
+- `Overlay` (`src/components/Overlay`) — механика оверлея, на которой построен `LightBox.SideOverlay`: `ILightBoxSideOverlayProps` берёт `opened` / `onClose` из `IOverlayBaseProps`, подложку рисует `OverlayMask`
+- `Portal` (`src/components/Portal`) — рендер содержимого в отдельный узел вне текущего DOM-поддерева
+- `LoaderScreen` (`src/components/LoaderScreen`) — экран загрузки боковой панели, настраивается через `loaderScreenProps`
+- `Button` (`src/components/Button`) — на нём построены кнопки управления: `LightBox.Controls` (закрытие и стрелки через общий `LightBoxArrow`) и кнопки закрытия `LightBox.SideOverlay`
 
 ---
 
@@ -202,11 +214,13 @@ css-переменную `--lightBox-scroll-width`, которую вычита
 
 | Дата | Изменение |
 |---|---|
+| 2026-09-21 | Боковые отступы `.lightBoxContent` вынесены в css-переменную `--lightBox-content-padding-x` (константа `@lightBoxContentPaddingX`). Нужна, чтобы `TopOverlay` выравнивался по колонке контента |
 | 2026-07-22 | Создан документ (Phase 1 AI-Ready). В том же изменении — AI-рефакторинг: JSDoc на props, общий `LightBoxArrow` для Prev/Next, хук `useLightBoxSidebarVisibility` для сайдбаров, устранение eslint-подавлений; публичный API не менялся |
 | 2026-07-22 | Добавлен `export` к props-интерфейсам `ILightBoxControlsProps`, `ILightBoxCloseProps`, `ILightBoxPrevProps`, `ILightBoxNextProps`, `ILightBoxSideOverlayLoaderProps` (аддитивно, для консистентности с остальными интерфейсами компонента) |
 | 2026-07-22 | Багфиксы по ревью PR #474: клавиатурные триггеры контролов целятся в видимую кнопку (стрелки не работали на desktop, Esc — на mobile); таймер-хак блокировки скролла заменён счётчиком смонтированных лайтбоксов; `LightBoxViewManager` снимает классы mount-ноды при размонтировании последнего менеджера |
 | 2026-08-17 | Исправлено: `LightBox.TopOverlay` перекрывался лоадером `LightBox.Content`. У `.loadingContentOverlay` теперь локальный z-index (201) — выше sticky-шапки и футера `Page`, но ниже `TopOverlay` (500); раньше `LoaderScreen` шёл с глобальным `@z-index-loader-screen` (10100) |
 | 2026-08-25 | Исправлено: в состоянии загрузки кнопка закрытия была недоступна для клика — её перекрывал лоадер `LightBox.Content`. Восстановлен модификатор `isLoading` на корневом элементе (терялся при переходе на CSS Modules): контролы поднимаются над лоадером, кнопки вперёд/назад скрываются. Esc в состоянии загрузки сохранён рабочим |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`FocusTrapExtended`); добавлены обратные ссылки (`Overlay`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/List.md

@@ -1,7 +1,7 @@
 ---
 component: List
 category: List
-related: [ListSortable, ListItem, ListEmptyState, ListItemLoading, LoaderScreen]
+related: [ListSortable, ListItem, LoaderScreen]
 tokens: []
 stories: stories/List/List.stories.tsx
 version: "1.0"
@@ -75,6 +75,7 @@ version: "1.0"
 |---|---|
 | 2026-04-29 | Создан документ |
 | 2026-06-17 | `List.module.less`: локальный `z-index: @z-index-step` на `.listLoaderScreen` — исправлено перекрытие `LoaderScreen` поверх `LightBox` / `ModalWindow` |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListEmptyState`, `ListItemLoading`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/ListActionItem.md

@@ -1,7 +1,7 @@
 ---
 component: ListActionItem
 category: List
-related: [ListItem, ListItemContent, ListSortableItem]
+related: [ListItem]
 tokens:
   - ListItem.Background_Hover
   - ListItem.BorderColor_Focus
@@ -158,3 +158,4 @@ ListItem.BorderColor_Focus   // цвет focus-обводки (:focus-visible)
 |---|---|
 | 2026-07-17 | Добавлена story `WithActionItems` в `List.stories.tsx` — список из нескольких `ListActionItem`. |
 | 2026-07-16 | Создан компонент `ListActionItem` — самодостаточная интерактивная строка (hover, focus по Tab, `onClick` + Enter/Space). Сам рендерит `ListItem` + `ListItemContent`; интерактивность и весь фон живут на одном `ListItemContent`. Пропсы разделены: собственные — на `<li>`, интерактивные — через `listItemContentProps`. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListItemContent`); из `related` убраны несимметричные имена (`ListSortableItem`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |

package/bundle/components/ListItem.md

@@ -1,7 +1,7 @@
 ---
 component: ListItem
 category: List
-related: [List, ListItemContent, ListActionItem, ListItemSelectable, ListTableItem, ListSortableItem]
+related: [List, ListActionItem, ListItemSelectable, ListTableItem, ListSortableItem]
 tokens:
   - ListItem.Background
   - ListItem.Background_Selected
@@ -73,6 +73,7 @@ ListItem.BorderColor_Focus   // цвет focus-обводки на desktop (List
 - `ListItemLoading` — элемент-спиннер для пагинации (используется как последний элемент).
 - `ListItemControls`, `ListItemControlsButton`, `ListItemControlsButtonDropdown` — кнопки действий, обычно внутри `SwipeableArea.rightSwipeableArea`.
 - `ListItemTailLeft` / `ListItemTailRight` — декоративные хвосты для `SwipeableArea`.
+- `ListSortableItem` — самодостаточный элемент перетаскиваемого списка: тоже рендерит `ListItem` внутри себя, но добавляет target и контролы перетаскивания.
 - `ListTableItem` — комбинированная высокоуровневая обёртка.
 
 ---
@@ -99,6 +100,7 @@ ListItem.BorderColor_Focus   // цвет focus-обводки на desktop (List
 | 2026-04-29 | Создан документ |
 | 2026-05-21 | `ListItemContext` расширен полями `selectable` / `setSelectable`. Исправлен цвет токена `Background_Selected` в тёмной теме (`ColorDarkNeutral.10` → `ColorDarkNeutral.60`). |
 | 2026-07-16 | Добавлен самодостаточный компонент `ListActionItem` (сам рендерит `ListItem` + `ListItemContent`; hover, focus по Tab, `onClick` + Enter/Space). Координация фона через контекст не понадобилась — `ListItemContext` без изменений. Другие компоненты семейства его не используют. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListItemContent`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/ListItemControlsButton.md

@@ -1,7 +1,7 @@
 ---
 component: ListItemControlsButton
 category: List
-related: [ListItemControls, ListItemControlsButtonDropdown, IconWrapper]
+related: [ListItemControlsButtonDropdown, IconWrapper]
 tokens:
   - ListItemControlsButton.Background_Default
   - ListItemControlsButton.Background_Hover
@@ -104,3 +104,4 @@ ListItemControlsButton.Color_Active
 | Дата | Изменение |
 |---|---|
 | 2026-04-29 | Создан документ |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListItemControls`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |

package/bundle/components/ListItemSelectable.md

@@ -1,7 +1,7 @@
 ---
 component: ListItemSelectable
 category: List
-related: [ListItem, ListItemContent, Checkbox]
+related: [ListItem, Checkbox]
 tokens:
   - ListItem.Background
   - ListItem.Background_Selected
@@ -100,3 +100,4 @@ ListItem.Background_Selected // фон, когда selected=true
 |---|---|
 | 2026-04-29 | Создан документ |
 | 2026-05-21 | Добавлен опциональный prop `disabled` (пробрасывается в `Checkbox`). Компонент пишет в `ListItemContext` флаг `selectable = true` при монтировании. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListItemContent`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |

package/bundle/components/ListMaster.md

@@ -628,13 +628,13 @@ export const Default = () => {
                                     controlButtons={
                                         <>
                                             <ListItemControlsButton
-                                                icon={<AttachmentStrokeSrvIcon20 paletteIndex={5} />}
+                                                icon={<AttachmentStrokeSrvIcon20 paletteIndex={0} />}
                                             >
                                                 Скачать
                                             </ListItemControlsButton>
 
                                             <ListItemControlsButtonDropdown
-                                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={5} />}
+                                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={0} />}
                                                 options={itemActions}
                                             >
                                                 Действия

package/bundle/components/ListMasterFooter.md

@@ -1,7 +1,7 @@
 ---
 component: ListMasterFooter
 category: List
-related: [ListMaster, ListMasterFooterDescription, ListMasterFooterControls]
+related: [ListMaster]
 tokens:
   - ListMaster.Footer_Background
   - ListMaster.Footer_Shadow
@@ -81,3 +81,4 @@ ListMaster.Footer_Shadow      // тень сверху
 | Дата | Изменение |
 |---|---|
 | 2026-04-29 | Создан документ. Уточнён JSDoc по дефолтному значению `sticky`. Добавлены unit-тесты. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListMasterFooterDescription`, `ListMasterFooterControls`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |

package/bundle/components/ListMasterHeader.md

@@ -1,7 +1,7 @@
 ---
 component: ListMasterHeader
 category: List
-related: [ListMaster, SelectionControls]
+related: [ListMaster]
 tokens:
   - ListMaster.Header_Background
   - ListMaster.Header_Shadow
@@ -87,3 +87,4 @@ ListMaster.Header_Shadow      // тень снизу
 | Дата | Изменение |
 |---|---|
 | 2026-04-29 | Создан документ. Уточнён JSDoc по `useEffect`-логике компенсации скролла. Добавлены unit-тесты. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`SelectionControls`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |

package/bundle/components/ListSortable.md

@@ -1,7 +1,7 @@
 ---
 component: ListSortable
 category: List
-related: [List, ListSortableItem, ListSortableItemTarget, ListSortableItemControls]
+related: [List, ListSortableItem]
 tokens: []
 stories: stories/List/List.stories.tsx
 version: "1.0"
@@ -86,6 +86,7 @@ callback `onItemsChange`, в который пробрасывает резул
 | Дата | Изменение |
 |---|---|
 | 2026-04-29 | Создан документ |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListSortableItemTarget`, `ListSortableItemControls`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/ListSortableItem.md

@@ -1,7 +1,7 @@
 ---
 component: ListSortableItem
 category: List
-related: [ListSortable, ListSortableItemTarget, ListSortableItemControls, ListItem]
+related: [ListSortable, ListItem]
 tokens:
   - ListItem.Background
   - ListItem.Background_Hover
@@ -111,6 +111,7 @@ ListItem.Shadow_Dragging      // тень во время drag
 | Дата | Изменение |
 |---|---|
 | 2026-04-29 | Создан документ |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListSortableItemTarget`, `ListSortableItemControls`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/ListTableItem.md

@@ -1,7 +1,7 @@
 ---
 component: ListTableItem
 category: List
-related: [ListItem, ListItemSelectable, ListItemControls, ListItemControlsButton, SwipeableArea]
+related: [ListItem, ListItemSelectable, TableBasic, SwipeableArea]
 tokens:
   - ListItem.Background
   - ListItem.Background_Selected
@@ -80,7 +80,9 @@ ListItem.Background_Selected // фон выбранной строки (чере
 - `ListItemSelectable` — добавляется автоматически, если переданы `selected` + `onSelect`.
 - `ListItemControls` — обёртка для `controlButtons`, подключается как `rightSwipeableArea`.
 - `ListItemTailRight` — декоративный «хвост» в правой части (всегда отрисовывается).
+- `ListItemControlsButton` — кнопка действия внутри `ListItemControls`; из таких кнопок собирается `controlButtons`.
 - `SwipeableArea` — внешняя зависимость, обеспечивает swipe-жесты.
+- `TableBasic` — альтернатива для табличного списка: настоящая таблица с колонками, когда строка не карточка со своей вёрсткой, свайпом и контролами.
 
 ---
 
@@ -104,6 +106,7 @@ ListItem.Background_Selected // фон выбранной строки (чере
 |---|---|
 | 2026-04-29 | Создан документ |
 | 2026-07-16 | Компонент переименован `ListItemTable` → `ListTableItem`. Пропсы `IListItemTableProps`/`IListItemTableSelectableProps` → `IListTableItemProps`/`IListTableItemSelectableProps`, CSS-класс `.listItemTable` → `.listTableItem`, файлы `ListTableItem.*`. **Breaking change.** |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListItemControls`) и `ListItemControlsButton` — `ListTableItem` принимает `controlButtons` как `React.ReactNode` и рендерит `ListItemControls`, а саму кнопку не импортирует; добавлены обратные ссылки (`TableBasic`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 
@@ -156,11 +159,11 @@ export const Default = () => {
                     onClickItem={() => {}}
                     controlButtons={
                         <>
-                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={5} />}>
+                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={0} />}>
                                 Скачать
                             </ListItemControlsButton>
                             <ListItemControlsButtonDropdown
-                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={5} />}
+                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={0} />}
                                 options={options}
                             >
                                 Действия
@@ -245,11 +248,11 @@ export const Selectable = () => {
                     onClickItem={() => console.log("Клик по карточке.")}
                     controlButtons={
                         <>
-                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={5} />}>
+                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={0} />}>
                                 Скачать
                             </ListItemControlsButton>
                             <ListItemControlsButtonDropdown
-                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={5} />}
+                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={0} />}
                                 options={options}
                             >
                                 Действия
@@ -354,11 +357,11 @@ export const WithSwipeEmulation = () => {
                     onClickItem={() => console.log("Клик по карточке.")}
                     controlButtons={
                         <>
-                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={5} />}>
+                            <ListItemControlsButton icon={<AttachmentStrokeSrvIcon20 paletteIndex={0} />}>
                                 Скачать
                             </ListItemControlsButton>
                             <ListItemControlsButtonDropdown
-                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={5} />}
+                                icon={<DotshorizontalStrokeSrvIcon20 paletteIndex={0} />}
                                 options={options}
                             >
                                 Действия

package/bundle/components/LoaderMiddle.md

@@ -1,7 +1,7 @@
 ---
 component: LoaderMiddle
 category: Loaders
-related: [LoaderSmall, LoaderScreen, TableBasic]
+related: [Skeleton, LoaderSmall, LoaderScreen, TableBasic]
 tokens:
   - Loader.Middle_Background_Default
   - Loader.Element_Background_Brand
@@ -106,6 +106,9 @@ Loader.Element_Background_Brand
   того же barrel `src/components/Loader/index.ts`.
 - `LoaderScreen` (`src/components/LoaderScreen/LoaderScreen.tsx`) — оверлей-подложка с лоадером по
   центру, подписью и кнопками; при `type="middle"` рендерит `LoaderMiddle` без обёрток.
+- `Skeleton` (`src/components/Skeleton/`) — альтернатива для той же задачи (первая загрузка
+  блока) с другим компромиссом: показывает каркас будущей раскладки, поэтому берётся, когда
+  раскладка известна заранее. `LoaderMiddle` — когда неизвестна.
 - `TableBasic` (`src/components/Table/TableBasic/TableBasic.tsx`) — показывает `LoaderMiddle` в
   футере таблицы при догрузке данных на пустом состоянии.
 
@@ -134,6 +137,7 @@ Loader.Element_Background_Brand
 | Дата | Изменение |
 |---|---|
 | 2026-08-05 | Создан документ. AI-рефакторинг: JSDoc на компоненте, порядок импортов приведён к codestyle, в LESS объединены дублирующиеся базовые стили `.dot` и `.line`, unit-тесты расширены с 1 до 2 кейсов (роль корневого элемента, количество точек и линии). В stories `controls: { disable: true }` перенесён на верхний уровень `parameters` (внутри `docs` не применялся). Публичный API, DOM и визуальное поведение не изменены. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): добавлена обратная ссылка `Skeleton` — `Skeleton-ai.md` называет `LoaderMiddle` альтернативой (категория 2), а такие пары по `docs/ai/CONTEXT.md` симметричны; в TRI-76 связь была проставлена только с одной стороны. Публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/LoaderScreen.md

@@ -1,7 +1,7 @@
 ---
 component: LoaderScreen
 category: Loaders
-related: [LoaderSmall, LoaderMiddle, Gap, Text, ModalWindowContent, LightBoxContent, LightBoxSideOverlay, List, TableBasic, MultiselectField]
+related: [LoaderSmall, LoaderMiddle, Gap, Text, List, TableBasic]
 tokens:
   - LoaderScreen.Small_Backdrop_Default
   - LoaderScreen.Middle_Backdrop_Default
@@ -161,6 +161,11 @@ breaking change для темизации), но опираться на нег
 - `TableBasic` — лоадер поверх тела таблицы.
 - `MultiselectField` — `LoaderScreen type="small"` внутри выпадающего списка.
 
+`MultiselectField` в `related` не входит: обычный контракт по рендеру, ссылка стоит с его
+стороны. `List` и `TableBasic` остаются — они подпадают под исключение «потребитель,
+опирающийся на хрупкую деталь»: оба понижают `z-index` лоадера через вложенный селектор,
+и держится это на специфичности правил `.loaderScreen` (см. «Ограничения раскладки»).
+
 ---
 
 ## Stories
@@ -186,6 +191,7 @@ breaking change для темизации), но опираться на нег
 | Дата | Изменение |
 |---|---|
 | 2026-08-06 | Создан документ. AI-рефакторинг: порядок импортов по `codestyle.md`, JSDoc на компоненте, props и `ILoaderScreenMiddleProps` (включая значение по умолчанию для `size`), подложка вынесена в `TYPE_TO_BACKDROP_CLASS_NAME_MAP`, `className` в `clsx` перенесён в конец. Unit-тесты расширены: все значения `EComponentSize`, игнорирование `size` при `type="middle"`, класс подложки по типу, отсутствие `description` / `controls`, мердж `className`, spread rest-props, `forwardRef`. Публичный API, DOM и стили не изменены. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ModalWindowContent`, `LightBoxContent`, `LightBoxSideOverlay`) и потребитель `MultiselectField` — контракт по рендеру, ссылка стоит с его стороны. `List` и `TableBasic` оставлены: они понижают `z-index` лоадера вложенным селектором и опираются на специфичность правил `.loaderScreen` — исключение «потребитель, опирающийся на хрупкую деталь». Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/LoaderSmall.md

@@ -1,7 +1,7 @@
 ---
 component: LoaderSmall
 category: Loaders
-related: [LoaderMiddle, LoaderScreen, Button, Dropdown, ListItemLoading, SuggestField, SelectExtendedField]
+related: [LoaderMiddle, LoaderScreen, Button]
 tokens:
   - Loader.Element_Background_Brand
   - Loader.Element_Background_Neutral
@@ -128,13 +128,18 @@ Loader: `Element_Background_Brand` использует также `LoaderMiddle
 - `LoaderScreen` (`src/components/LoaderScreen/LoaderScreen.tsx`) — оверлей с лоадером,
   подписью и кнопками; при `type="small"` рендерит `LoaderSmall` с темой `BRAND`.
 - `Button` (`src/components/Button/Button.tsx`) — рендерит `LoaderSmall` **всегда**, а вне
-  состояния `loading` прячет обёртку классом (`Button.tsx:156`), поэтому `role="status"`
-  доступен и у обычной кнопки — не пиши тест вида `queryByRole("status")` → `null`.
+  состояния `loading` прячет обёртку классом (`Button.tsx:156`). Класс задаёт
+  `visibility: hidden` (`Button.module.less:136-138`), то есть в браузере узел выпадает
+  из дерева доступности, но остаётся в DOM. Unit-тесты идут в jsdom, который LESS не
+  применяет, поэтому там `role="status"` находится и у обычной кнопки — не пиши тест
+  вида `queryByRole("status")` → `null`.
   Тему выбирает по теме кнопки (`SECONDARY` / `SECONDARY_LIGHT` → `BRAND`,
   остальные → `NEUTRAL`), размер — по размеру кнопки.
 - `Dropdown` (`DropdownList`, `DropdownMobileList`, `DropdownMobileLoader`), `SuggestField`,
   `ChipSuggest`, `SelectExtendedField`, `ListItemLoading` — показывают `LoaderSmall` с темой
-  `BRAND` во время подгрузки данных.
+  `BRAND` во время подгрузки данных. В `related` не входят: это контракт по рендеру, ссылка
+  стоит с их стороны. `Button` — исключение «потребитель, опирающийся на хрупкую деталь»
+  (см. выше про `role="status"`), поэтому он в `related` остаётся с обеих сторон.
 
 ---
 
@@ -166,6 +171,7 @@ Loader: `Element_Background_Brand` использует также `LoaderMiddle
 | Дата | Изменение |
 |---|---|
 | 2026-08-06 | Создан документ. AI-рефакторинг: JSDoc на компоненте, props и значениях `ELoaderSmallTheme`, документирован неиспользуемый `ELoaderSmallSize`, порядок импортов приведён к codestyle, константы-маппинги переименованы в `THEME_TO_CLASS_NAME_MAP` / `SIZE_TO_CLASS_NAME_MAP`, в стилях объединено дублирующееся объявление анимации точек — сама анимация задана один раз на `.dot`, а у `.dot1` / `.dot2` / `.dot3` осталась только `animation-delay` (правило `.dot1` с нулевой задержкой обязательно: без него класс исчезнет из CSS-модуля и из разметки), unit-тесты расширены с 3 до 6 кейсов. В stories `controls: { disable: true }` перенесён на верхний уровень `parameters` — внутри `docs` он не применялся. Публичный API, DOM и визуальное поведение не изменены. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ListItemLoading`); из `related` убраны потребители `Dropdown`, `SuggestField`, `SelectExtendedField` — ссылка на контракт по рендеру стоит с их стороны; `Button` оставлен как исключение «потребитель, опирающийся на хрупкую деталь». Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/MaskedField.md

@@ -1,7 +1,7 @@
 ---
 component: MaskedField
 category: TextFields
-related: [TextField, FormField, FormFieldMaskedInput, FormGroup, DateField, MonthYearField]
+related: [TextField, FormField, FormGroup, DateField]
 tokens: []
 stories: stories/MaskedField/MaskedField.stories.tsx
 version: "1.0"
@@ -87,6 +87,7 @@ version: "1.0"
 - `TextFieldBase` — базовая раскладка `FormGroup`/`FormField` + слоты `prefix`/`children`/`label`/`postfix` и блок `description`/`counter`.
 - `FormFieldMaskedInput` — сам элемент ввода с маской и статическим свойством `presets` (`masks`, `placeholderMasks`). Используется напрямую, когда нужна нестандартная композиция поля.
 - `FormFieldClear` — кнопка очистки, передаётся в `postfix`.
+- `TextField` — то же поле без маски: отличается только элементом ввода (`FormFieldInput` вместо `FormFieldMaskedInput`).
 - `FormGroup` / `FormField` — контейнеры раскладки поля и описания.
 - `DateField`, `MonthYearField`, `AmountField`, `SuggestField`, `TextareaField` — специализированные поля той же группы `TextFields`.
 
@@ -119,6 +120,7 @@ version: "1.0"
 | 2026-08-11 | Тип `maskedInputProps.ref` исправлен на `React.RefObject<HTMLDivElement>` — соответствует фактическому ref-таргету (правки по ревью PR #515) |
 | 2026-08-12 | Исправления в `FormFieldMaskedInput` по ревью PR #515: убрана мутация prop `value` в `getValue()`, `defaultValue` больше не уходит в `<input>` (предупреждение React о controlled/uncontrolled) и исключён из `IFormFieldMaskedInputProps` |
 | 2026-09-09 | Исправлено: значение с кодом страны раскладывалось по маске телефона со сдвигом и теряло последнюю цифру. Нормализация номера вынесена в `normalizePhoneText` и применяется и к внешнему `value`, и к слою с маской |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`FormFieldMaskedInput`); из `related` убраны несимметричные имена (`MonthYearField`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/MediaWidth.md

@@ -1,7 +1,7 @@
 ---
 component: MediaWidth
 category: MediaWidth
-related: [MediaMinWidth, MediaMaxWidth, MediaBetweenWidth, useMatchMedia, MobileView, WindowResizeListener]
+related: [MobileView, WindowResizeListener]
 tokens: []
 stories: stories/MediaWidth/MediaWidth.stories.tsx
 version: "1.0"
@@ -227,6 +227,7 @@ version: "1.0"
 |---|---|
 | 2026-08-18 | TRI-104: в `related` и «Связанные компоненты» добавлен `WindowResizeListener` — обратная сторона симметричной связи-альтернативы. Код и публичный API не затронуты. |
 | 2026-08-11 | Создан документ. AI-рефакторинг (TRI-58): `displayName` у `MediaWidth`, исправлены опечатки и дополнен JSDoc props и компонента, unit-тесты расширены с 7 до 19 кейсов (проверяются строки медиа-запросов, выбор реализации, `null`-ветки, переподписка и отписка). Публичный API не изменён (props, `IMediaProps`, barrel-экспорты; `forwardRef` по-прежнему осознанно отсутствует). |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`MediaMinWidth`, `MediaMaxWidth`, `MediaBetweenWidth`, `useMatchMedia`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/MobileView.md

@@ -1,7 +1,7 @@
 ---
 component: MobileView
 category: MobileView
-related: [MediaWidth, MediaMaxWidth, useMatchMedia, useMobileView]
+related: [MediaWidth]
 tokens: []
 stories: stories/MobileView/MobileView.stories.tsx
 version: "1.0"
@@ -173,6 +173,7 @@ viewport `xs` (575px) рендерится мобильный вариант, н
 | Дата | Изменение |
 |---|---|
 | 2026-08-10 | Создан документ. AI-рефакторинг (TRI-59): `useMobileView.tsx` → `useMobileView.ts` (в файле нет JSX), явный тип возврата у хука, `displayName` у `MobileView`, дополнен JSDoc, добавлены unit-тесты (15 кейсов) и stories по modern pattern. Публичный API не изменён (props, сигнатура хука, barrel-экспорты; `forwardRef` по-прежнему осознанно отсутствует). |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`MediaMaxWidth`, `useMatchMedia`, `useMobileView`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/ModalWindow.md

@@ -1,7 +1,7 @@
 ---
 component: ModalWindow
 category: ModalWindow
-related: [ModalWindowContent, ModalWindowHeader, ModalWindowBody, ModalWindowFooter, ModalWindowClose, ModalWindowViewManager, Portal, FocusTrap, Page, HeaderPage, FooterPage, Island, LoaderScreen]
+related: [LightBox, Portal, Page, HeaderPage, FooterPage, Island, LoaderScreen]
 tokens:
   - ModalWindow.Backdrop_Background
   - ModalWindow.Background
@@ -107,6 +107,8 @@ ModalWindow.Background
 - **`ModalWindowBody`** — тело. Тривиальная обёртка над `Island` с фиксированными `type=TYPE_1` и `size=MD`. Тип `IModalWindowBodyProps extends Omit<IIslandProps, "loading" | "loaderScreenProps">`. Состояние загрузки у `Island` намеренно отрезано: тело скроллируется (`overflow: auto`), а `LoaderScreen` позиционируется абсолютно и уехал бы вместе с контентом. Загрузку модального окна задавай на `ModalWindowContent`.
 - **`ModalWindowFooter`** — футер. Тривиальная обёртка над `FooterPage` с фиксированным `type=FIRST`. Экспонирует статическое поле `Description = FooterPage.Description`.
 - **`ModalWindowClose`** — кнопка закрытия. Обёртка над `Button` (`theme=SECONDARY`, `size=MD`, иконка `CrossStrokeSrvIcon20`) внутри `TriggerClickOnKeyDownEvent` с `EVENT_KEY_CODES.ESCAPE`. **Текст `title` не имеет дефолта внутри компонента** — библиотека мультиязычная, локализованную подсказку (например, `title="Закрыть"`) передаёт потребитель через props. Тип `IModalWindowCloseProps` (Omit `size`/`theme`/`icon` от `IButtonSecondaryProps`).
+- **`LightBox`** — альтернатива для полноэкранного просмотра: тот же механизм оверлея, но контент занимает весь экран, а не центрированное окно.
+- **`FocusTrapExtended`** (`src/components/FocusTrapExtended`) — focus trap окна: `ModalWindow` рендерит его и настраивает через `focusTrapProps` (`IFocusTrapExtendedProps`). Своего AI.md и строки в `docs/ai/ROADMAP.md` не имеет.
 - **`ModalWindowViewManager`** — невидимый компонент-сенсор. Создаёт DOM-ноду `<div id="modalWindowViewManagerNodeId">` (если её нет в `body`) и рендерит туда через `Portal` resize-сенсор + `<style>`-инжект CSS-переменных `--modalWindow-screen-*` в `:root`. Подключается автоматически из `ModalWindow`; экспортируется отдельно для случая, когда лайаут хочет позиционировать ноду вручную (например, рисовать модалку только в области рабочей зоны без шапки).
 
 ---
@@ -138,6 +140,7 @@ ModalWindow.Background
 | 2026-06-30 | Fix: модалка не отображалась под React 18 `StrictMode`. На искусственном unmount/mount-цикле cleanup в `useEffect` открепляет портальный `mountNode`, а инициализатор `useState` повторно не вызывается — узел оставался вне DOM. Теперь `useEffect` при (повторном) mount возвращает узел в wrapper, если тот откреплён. Wrapper вынесен в `getOrCreateWrapperNode`. Добавлен регрессионный тест на реальном `Portal` (`ModalWindow.strictMode.test.tsx`). |
 | 2026-08-07 | `IModalWindowBodyProps` сузился до `Omit<IIslandProps, "isLoading" \| "loaderScreenProps">`: в `Island` появилось состояние загрузки, но в скроллируемом теле модалки абсолютный `LoaderScreen` уезжает вместе с контентом. Публичный API не изменён — props исключены до их первого релиза; путь для загрузки модального окна прежний, `ModalWindowContent`. |
 | 2026-08-11 | Prop загрузки в `Island` переименован `isLoading` → `loading`, вслед за ним `Omit` в `IModalWindowBodyProps` — теперь `Omit<IIslandProps, "loading" \| "loaderScreenProps">`. Публичный API `ModalWindow` не изменён: у `ModalWindowContent` prop по-прежнему `isLoading`. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`ModalWindowContent`, `ModalWindowHeader`, `ModalWindowBody`, `ModalWindowFooter`, `ModalWindowClose`, `ModalWindowViewManager`, `FocusTrap`); добавлены обратные ссылки (`LightBox`). Пояснения к убранным `ModalWindow*` сохранены прозой в «Связанные компоненты», а `FocusTrap` там заменён на фактически рендерящийся `FocusTrapExtended`; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/MonthYearField.md

@@ -1,7 +1,7 @@
 ---
 component: MonthYearField
 category: Date components
-related: [DatePickerExtended, MonthYearRange, ChipMonthYearPicker, TextField, Calendar]
+related: [MonthYearRange, ChipMonthYearPicker, DateField, DatePickerExtended, TextField, Calendar]
 tokens: []
 stories: stories/MonthYearField/MonthYearField.stories.tsx
 version: "1.0"
@@ -61,7 +61,6 @@ version: "1.0"
 - `forwardRef` на компоненте — не убирать. Ref пробрасывается в `DatePickerExtended` (корневой DOM-элемент — элемент `DatePickerExtended`).
 - Публичный API (`IMonthYearFieldProps`: `value`, `onChange`, `onClear`, `targetProps`, `placeholder` + унаследованные `size`/`status`/`label` и props `DatePickerExtended`) — изменение имён/типов/значений — breaking change.
 - Поле read-only по контракту — не делать его редактируемым без обсуждения (компонент не имеет логики валидации клавиатурного ввода).
-- Отображаемый формат `"MMM YYYY"` зафиксирован в `inputMonthYearFormat`; менять его — визуальный breaking change для потребителей.
 - Sync-эффект в `MonthYearField.tsx` (`useEffect` по `[value, format, limitRange]` с `eslint-disable react-hooks/exhaustive-deps`) — намеренная синхронизация derived-стейта `pickerValues` с внешним `value`. Не переписывать без анализа поведения: сравнение идёт по `inputString`, чтобы не сбрасывать стейт при эквивалентных значениях.
 - Внутренние символы `MonthYearPickerUtils` (`utils.ts`), `MonthYearFieldContext`, `MonthYearFieldTarget` не экспортируются через barrel — это приватные детали реализации.
 
@@ -82,6 +81,8 @@ version: "1.0"
 - `MonthYearRange` — выбор диапазона месяцев; использует `MonthYearField` как поля «от» и «до».
 - `ChipMonthYearPicker` — тот же выбор месяца в виде чипса-фильтра: наследует `IMonthYearFieldProps` и утилиты `MonthYearPickerUtils`, но вместо поля формы рендерит `Chip`.
 - `TextField` — внутреннее поле-триггер.
+- `Calendar` — календарь внутри дропдауна в режиме `MONTH_YEAR`; его props приходят в публичный API через `DatePickerExtended`.
+- `DateField` — альтернатива для выбора полной даты; устроен по той же схеме, но поле редактируемое и с маской.
 - `MonthYearFieldTarget` (внутренний, не в barrel) — рендерит `TextField` с иконкой календаря и кнопкой очистки, обрабатывает клик/клавиатуру для открытия дропдауна. Описан здесь, отдельного AI.md не имеет.
 - `MonthYearFieldContext` (внутренний, не в barrel) — прокидывает `onChange` в target; тривиальный контекст без своей логики.
 - `MonthYearPickerUtils` (`utils.ts`, внутренний) — чистые функции парсинга/валидации даты (`getPickerValues`, `getCalendarDate`, `isAvailableDate`). Покрыты `__tests__/utils.test.tsx`.
@@ -112,6 +113,7 @@ version: "1.0"
 | 2026-06-16 | Создан документ. AI-рефакторинг (JSDoc-фиксы), unit-тесты для `utils.ts`, story `VisualTests` и включение скриншот-тестов |
 | 2026-06-16 | Добавлена story `VisualTestsOpen` — скриншот раскрытого dropdown с календарём (через `play`) |
 | 2026-09-07 | В «Связанные компоненты» добавлен `ChipMonthYearPicker` — чипс-вариант того же выбора месяца |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): добавлены обратные ссылки (`DateField`). Публичный API и поведение не затронуты. |
 
 ---
 
@@ -130,7 +132,7 @@ export const DefaultExample = () => {
 
     return (
         <div style={{ maxWidth: 300 }}>
-            <MonthYearField value={value} placeholder="мм.гггг" label="Label" onChange={setValue} />
+            <MonthYearField value={value} placeholder="Select to proceed" label="Label" onChange={setValue} />
         </div>
     );
 };
@@ -154,7 +156,13 @@ const SizeItem = ({ size }: ISizeItemProps) => {
     return (
         <div style={{ maxWidth: 300 }}>
             <div style={{ marginBottom: 8, fontSize: 16, fontWeight: 700 }}>{size.toUpperCase()}</div>
-            <MonthYearField size={size} value={value} label="Label" placeholder="мм.гггг" onChange={setValue} />
+            <MonthYearField
+                size={size}
+                value={value}
+                label="Label"
+                placeholder="Select to proceed"
+                onChange={setValue}
+            />
         </div>
     );
 };
@@ -188,7 +196,13 @@ const StatusItem = ({ status }: IStatusItemProps) => {
     return (
         <div style={{ maxWidth: 300 }}>
             <div style={{ marginBottom: 8, fontSize: 16, fontWeight: 700 }}>{status.toUpperCase()}</div>
-            <MonthYearField status={status} value={value} label="Label" placeholder="мм.гггг" onChange={setValue} />
+            <MonthYearField
+                status={status}
+                value={value}
+                label="Label"
+                placeholder="Select to proceed"
+                onChange={setValue}
+            />
         </div>
     );
 };

package/bundle/components/Notification.md

@@ -152,6 +152,7 @@ Notification.TimeColor    (цвет времени)
 | Дата | Изменение |
 |---|---|
 | 2026-06-16 | Создан AI-документ. `Notification`, `NotificationGrouped`, `NotificationBody` переведены на `forwardRef` (паттерн `Object.assign`); удалены типы `INotificationSFC`/`INotificationBodySFC`; тип `Notification.Time.time` расширен с `React.ReactText` до `React.ReactNode`. Stories мигрированы на modern pattern. |
+| 2026-09-28 | Токен `Notification.Shadow` ссылается на `Shadow.07` (светлая) и `DarkShadow.07` (тёмная) вместо литералов; в тёмной теме прозрачность 0.25 вместо 0.35. |
 
 ---