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

package/bundle/components/LightBox.md

@@ -56,7 +56,7 @@ version: "1.0"
 | Prop | Тип | По умолчанию | Описание |
 |---|---|---|---|
 | `size` | `ELightBoxSize` | `MD` | Максимальная ширина контента |
-| `isLoading` | `boolean` | — | Состояние загрузки: деактивирует focus trap; `LightBox.Content` показывает `LoaderScreen` |
+| `isLoading` | `boolean` | — | Состояние загрузки: деактивирует focus trap, добавляет модификатор на корневой элемент (кнопка закрытия поднимается над лоадером контента); `LightBox.Content` показывает `LoaderScreen` |
 | `isSideOverlayOpened` | `boolean` | — | Флаг открытой боковой панели — добавляет модификатор на корневой элемент (блокирует скролл контента) |
 | `isTopOverlayOpened` | `boolean` | — | Флаг открытой верхней панели — аналогичный модификатор |
 | `focusTrapProps` | `IFocusTrapExtendedProps` | — | Переопределение настроек `FocusTrapExtended` |
@@ -126,6 +126,15 @@ version: "1.0"
   последнего (при переключении роутов второй лайтбокс может смонтироваться раньше, чем
   размонтируется первый). Аналогичный счётчик в `LightBoxViewManager` управляет классами
   mount-ноды (`LightBoxMountNodeViewManager`, `LB-*`).
+- **Локальные z-index внутри лайтбокса** (стековый контекст создаёт `.lightBox`): контролы и
+  sticky-шапка/футер `Page` — 100/101, лоадеры `LightBox.Content` и `LightBox.SideOverlay` — 201,
+  `TopOverlay` — 500. `LoaderScreen` приходит с глобальным `@z-index-loader-screen` (10100),
+  поэтому обе обёртки лоадера обязаны переопределять его локальным значением — иначе лоадер
+  перекрывает `TopOverlay`.
+- В состоянии загрузки (`isLoading` и без открытых оверлеев) контейнер контролов поднимается
+  до 202 — иначе лоадер контента перекрывает кнопку закрытия. Поднимать нужно именно контейнер:
+  `.lightBoxControls` — flex-элемент с собственным z-index, то есть создаёт стековый контекст,
+  из которого z-index на самой кнопке уже не выберется.
 - Баррел `index.ts` реэкспортирует `LightBox`, `enums`, `LightBoxSideOverlay` — сохранять.
 - React 17 совместимость (синхронизация в release-0): React 18-only API не использовать.
 
@@ -140,8 +149,8 @@ version: "1.0"
   заголовок с `tabIndex={-1}`).
 - **Клавиатура**: Esc — клик по `Controls.Close`; ArrowLeft / ArrowRight — клик по
   `Controls.Prev` / `Controls.Next` при включённых `clickByArrowLeft` / `clickByArrowRight`.
-  При открытом `SideOverlay` клавиатурные триггеры контролов лайтбокса не активны
-  (рендерится вариант кнопок без триггера).
+  При открытом `SideOverlay` или `TopOverlay` клавиатурные триггеры контролов лайтбокса
+  не активны (рендерится вариант кнопок без триггера). В состоянии загрузки Esc работает.
 - Кнопки `Controls.Close` имеют `data-exclude-modal-focus` — исключаются из начального фокуса
   (у `Prev`/`Next` атрибута нет).
 - `title` у `Controls.Close` по умолчанию «Закрыть» — для других языков потребитель передаёт
@@ -194,6 +203,8 @@ version: "1.0"
 | 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 в состоянии загрузки сохранён рабочим |
 
 ---
 

package/bundle/components/MediaWidth.md

@@ -1,7 +1,7 @@
 ---
 component: MediaWidth
 category: MediaWidth
-related: [MediaMinWidth, MediaMaxWidth, MediaBetweenWidth, useMatchMedia, MobileView]
+related: [MediaMinWidth, MediaMaxWidth, MediaBetweenWidth, useMatchMedia, MobileView, WindowResizeListener]
 tokens: []
 stories: stories/MediaWidth/MediaWidth.stories.tsx
 version: "1.0"
@@ -176,6 +176,11 @@ version: "1.0"
 - `MobileView` (`src/components/MobileView/`) — частный случай `MediaWidth` с
   `maxWidth={EScreenWidth.SM_MAX}`, со своим AI.md. Для мобильной границы
   используется он, а не `MediaWidth` напрямую.
+- `WindowResizeListener` (`src/components/WindowResizeListener/`) — альтернатива
+  для императивного случая: даёт колбэк на поток событий `resize`, а не рендерит
+  ветку по медиа-запросу. Правило выбора: нужно **что-то показать** на
+  определённой ширине — `MediaWidth`; нужно **что-то посчитать/сделать** на
+  ресайз — `WindowResizeListener`.
 
 Разница между `MediaWidth` и тремя реализациями: у `MediaWidth` обе границы
 опциональны и выбор реализации делается за потребителя; у реализаций
@@ -220,6 +225,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` по-прежнему осознанно отсутствует). |
 
 ---

package/bundle/components/Notification.md

@@ -202,7 +202,13 @@ export const Status = () => (
                     <Notification.Body.Content>
                         This message provides context or highlights important information to note.
                     </Notification.Body.Content>
-                    <Notification.Body.List values={Array.from({ length: 3 }, () => "List item text;")} />
+                    <Notification.Body.List
+                        items={[
+                            { key: "1", children: "List item text" },
+                            { key: "2", children: "List item text" },
+                            { key: "3", children: "List item text" },
+                        ]}
+                    />
                 </Notification.Body>
                 <Notification.Close onClick={() => {}} />
             </Notification>
@@ -218,7 +224,13 @@ export const Status = () => (
                     <Notification.Body.Content>
                         This message provides context or highlights important information to note.
                     </Notification.Body.Content>
-                    <Notification.Body.List values={Array.from({ length: 3 }, () => "List item text;")} />
+                    <Notification.Body.List
+                        items={[
+                            { key: "1", children: "List item text" },
+                            { key: "2", children: "List item text" },
+                            { key: "3", children: "List item text" },
+                        ]}
+                    />
                 </Notification.Body>
                 <Notification.Close onClick={() => {}} />
             </Notification>
@@ -234,7 +246,13 @@ export const Status = () => (
                     <Notification.Body.Content>
                         This message provides context or highlights important information to note.
                     </Notification.Body.Content>
-                    <Notification.Body.List values={Array.from({ length: 3 }, () => "List item text;")} />
+                    <Notification.Body.List
+                        items={[
+                            { key: "1", children: "List item text" },
+                            { key: "2", children: "List item text" },
+                            { key: "3", children: "List item text" },
+                        ]}
+                    />
                 </Notification.Body>
                 <Notification.Close onClick={() => {}} />
             </Notification>

package/bundle/components/Overlay.md

@@ -45,7 +45,7 @@ off-canvas) над контейнером или страницей.
 |---|---|---|---|
 | `fixed` | `boolean` | `false` | `position: fixed` (на всю страницу) вместо `absolute` (поверх родителя) |
 | `onOpening` | `() => void` | — | Вызывается в начале открытия |
-| `onOpen` | `() => void` | — | Вызывается по завершении анимации открытия |
+| `onOpen` | `() => void` | — | Вызывается по завершении анимации открытия. Если оверлей смонтирован уже с `opened={true}`, анимации нет и колбэк вызывается сразу на маунте |
 | `onClosing` | `() => void` | — | Вызывается в начале закрытия |
 | `onClose` | `() => void` | — | Вызывается по завершении анимации закрытия |
 | `...HTMLDivAttributes` | — | — | Стандартные атрибуты корневого `<div>` (кроме `children`) |
@@ -134,6 +134,28 @@ unit-тестами (`toHaveBeenCalledTimes(1)`).
 > за переход — прямой вызов из `useLayoutEffect` дублировал эффект-driven вызов.
 > Исправлено: прямые вызовы из layout-эффекта удалены.
 
+### Монтирование сразу с `opened={true}`
+
+Оверлей, смонтированный уже открытым, никакой анимации открытия не проигрывает —
+панель отрисована в конечном положении, `transitionend` не наступит. Поэтому цикл
+открытия считается завершённым сразу: на маунте вызывается `onOpen`, а `onOpening`
+— нет (сообщать о начале анимации нечего). Флаги `opening` / `closing` при этом
+остаются `false`.
+
+Вызов сделан в пассивном `useEffect`, а не в layout-эффекте: к моменту пассивных
+эффектов refs уже проставлены, и потребитель может обратиться к DOM внутри
+`onOpen`. Измерять геометрию в этот момент всё же не стоит — оверлей мог быть
+смонтирован внутри контейнера, который сам ещё выезжает (`TopOverlay` поэтому
+пропускает пересчёт позиции на маунте).
+
+Монтирование с `opened={false}` не вызывает ничего — это нейтральное начальное
+состояние, а не закрытие.
+
+> Ранее (до 2026-08-27) на первом рендере гасились все колбэки: оверлей,
+> смонтированный открытым, не сообщал об этом потребителю. Обёртки, которые
+> в `onOpen` включают ловушку фокуса или считают позицию (`TopOverlay`), в этом
+> случае оставались недоинициализированными.
+
 ---
 
 ## Accessibility
@@ -183,6 +205,7 @@ Visual baseline для `components-overlay--visual-tests` генерируетс
 
 | Дата | Изменение |
 |---|---|
+| 2026-08-27 | `OverlayBase` вызывает `onOpen` при монтировании с `opened={true}` — раньше первый рендер гасил все колбэки, и оверлей, смонтированный открытым, не сообщал об этом потребителю (release notes 1.44.0). |
 | 2026-06-17 | Создан документ. `Overlay` переведён на `forwardRef` (ref → корневой `div`, аддитивно, release notes 1.34.0). Дедуплицирован флаг `closing` (единый источник — `OverlayBase`). Codestyle/JSDoc cleanup в 4 файлах. Добавлены 4 unit-тест-файла. Исправлен двойной вызов `onClosing`/`onOpening` за переход — теперь ровно один раз (закреплено `toHaveBeenCalledTimes(1)`). |
 
 ---

package/bundle/components/Pagination.md

@@ -31,7 +31,7 @@ version: "1.0"
 
 Используй когда: нужно дать пользователю переход по страницам списка/таблицы, при необходимости — с выбором размера страницы.
 
-Не используй когда: данных немного и помещаются на один экран (при `totalPages <= 1` навигация не рендерится); нужна бесконечная прокрутка вместо постраничной.
+Не используй когда: данных немного и они помещаются на один экран (навигация всё равно отрисуется — одной страницей с заблокированными стрелками); нужна бесконечная прокрутка вместо постраничной.
 
 ---
 
@@ -43,7 +43,7 @@ version: "1.0"
 
 | Prop | Тип | Обяз. | Описание |
 |---|---|---|---|
-| `paginationNavigationProps` | `IPaginationNavigationProps` | да | Настройки навигации по страницам. Навигация рендерится только при `totalPages > 1`. |
+| `paginationNavigationProps` | `IPaginationNavigationProps` | да | Настройки навигации по страницам. Навигация рендерится всегда: при `totalPages <= 1` — одна страница с заблокированными стрелками. |
 | `paginationSelectProps` | `IPaginationSelectProps` | нет | Настройки селекта размера страницы. Если не передан — селект не отображается. |
 | `...rest` | `IPaginationExtendedProps` | — | Прокидывается в корневой `<nav>` (className, aria-атрибуты и т.д.). |
 
@@ -52,7 +52,7 @@ version: "1.0"
 | Prop | Тип | По умолчанию | Описание |
 |---|---|---|---|
 | `currentPage` | `number` | — | Номер текущей страницы (нумерация с 1). |
-| `totalPages` | `number` | — | Общее число страниц. |
+| `totalPages` | `number` | — | Общее число страниц. Значения меньше 1 отображаются как одна страница. |
 | `onCurrentPageChange` | `(page: number) => void` | — | Колбэк смены страницы. Вызывается с целевым номером. |
 | `boundaryCount` | `number` | `0` | Сколько страниц всегда показывать в начале и в конце. |
 | `siblingCount` | `number` | `0` | Сколько соседних страниц показывать вокруг текущей. |
@@ -105,7 +105,7 @@ version: "1.0"
 - `forwardRef` на всех компонентах семейства — не убирать. Refs: `Pagination` → `HTMLSpanElement` (фактически прокидывается в корневой `<nav>` через `PaginationExtended`, ref-тип которого `HTMLElement`), `PaginationNavigation`/`PaginationNavigationExtended` → `HTMLUListElement`, `PaginationNavigationExtendedItem` → `HTMLLIElement`, `PaginationSelect` → `HTMLDivElement`, кнопки → `HTMLButtonElement`, ellipsis → `HTMLSpanElement`.
 - Публичный API не менять: имена и обязательность props (`paginationNavigationProps` — обязателен, `paginationSelectProps` — опционален), enum `EPaginationNavigationIconDirection` (`BACK`/`NEXT`), barrel-экспорты из `index.ts`.
 - Корневой DOM-элемент `Pagination`/`PaginationExtended` — `<nav>`; навигация по страницам — семантический список `<ul>/<li>`. Не менять без обсуждения: семантика участвует в accessibility-контракте.
-- Навигация рендерится только при `totalPages > 1` — поведение публичное, на него опираются потребители.
+- Навигация рендерится всегда, включая случай единственной страницы: `PaginationNavigation` приводит `totalPages` к минимуму 1, рисует одну страницу и блокирует обе стрелки. Это держит высоту панели пагинации постоянной независимо от размера страницы — не возвращать условный рендер по `totalPages > 1`.
 - Логику `PaginationUtils.createPagesArray` / `generatePageRanges` / `generateRange` не менять без перегенерации `__tests__/paginationUtils.test.tsx` — там зафиксированы граничные случаи раскладки.
 - `PAGINATION_ELLIPSIS_VALUE = -1` — sentinel в массиве страниц, на него завязан рендер многоточия.
 - Блокировка по `MasterTableContext.loading` перекрывает `disabled`, пришедший из props: в состоянии загрузки кнопка заблокирована независимо от того, что передал потребитель. Обратное неверно — вне загрузки решает prop.
@@ -157,6 +157,7 @@ version: "1.0"
 |---|---|
 | 2026-06-22 | Создан документ |
 | 2026-08-12 | В состоянии загрузки `MasterTable` элементы пагинации становятся `disabled` — читается из `MasterTableContext.loading`. Публичный API не изменился. Заодно `PaginationSelect` перестал молча терять переданный `status`. |
+| 2026-08-27 | Навигация больше не скрывается при `totalPages <= 1`: отрисовывается одна страница с заблокированными стрелками, высота панели пагинации не схлопывается. Публичный API не изменился. |
 
 ---
 
@@ -270,15 +271,13 @@ export const Extended = () => {
 
     return (
         <PaginationExtended>
-            {totalPages > 1 && (
-                <PaginationNavigation
-                    currentPage={page}
-                    totalPages={totalPages}
-                    boundaryCount={1}
-                    siblingCount={1}
-                    onCurrentPageChange={setPage}
-                />
-            )}
+            <PaginationNavigation
+                currentPage={page}
+                totalPages={totalPages}
+                boundaryCount={1}
+                siblingCount={1}
+                onCurrentPageChange={setPage}
+            />
             <PaginationSelect
                 paginationLabel="Показать на странице:"
                 value={selectedOption || options[0]}