@sberbusiness/triplex-next-mcp-server 1.43.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` |
@@ -128,9 +128,13 @@ version: "1.0"
   mount-ноды (`LightBoxMountNodeViewManager`, `LB-*`).
 - **Локальные z-index внутри лайтбокса** (стековый контекст создаёт `.lightBox`): контролы и
   sticky-шапка/футер `Page` — 100/101, лоадеры `LightBox.Content` и `LightBox.SideOverlay` — 201,
-  `TopOverlay` — 500. `LoaderScreen` приходит с глобальным `@z-index-loader-screen` (10100), поэтому
-  обе обёртки лоадера обязаны переопределять его локальным значением — иначе лоадер перекрывает
-  `TopOverlay`.
+  `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 не использовать.
 
@@ -145,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` по умолчанию «Закрыть» — для других языков потребитель передаёт
@@ -200,6 +204,7 @@ version: "1.0"
 | 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/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]}