@sberbusiness/triplex-next-mcp-server 1.43.0-beta → 1.45.0-beta

package/bundle/components/Notification.md

@@ -3,10 +3,10 @@ component: Notification
 category: Feedback
 related: [NotificationGrouped, Button, AlertContext, UnorderedList]
 tokens:
-  - --triplex-next-Notification-Background
-  - --triplex-next-Notification-Color
-  - --triplex-next-Notification-Shadow
-  - --triplex-next-Notification-TimeColor
+  - Notification.Background
+  - Notification.Color
+  - Notification.Shadow
+  - Notification.TimeColor
 stories: stories/Notification/Notification.stories.tsx
 version: "1.0"
 ---
@@ -91,11 +91,14 @@ Notification
 
 ## Дизайн-токены
 
-```
---triplex-next-Notification-Background   (фон уведомления)
---triplex-next-Notification-Color        (цвет текста)
---triplex-next-Notification-Shadow       (тень карточки)
---triplex-next-Notification-TimeColor    (цвет времени)
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Notification.ts`.
+
+```text
+Notification.Background   (фон уведомления)
+Notification.Color        (цвет текста)
+Notification.Shadow       (тень карточки)
+Notification.TimeColor    (цвет времени)
 ```
 
 ---

package/bundle/components/Overlay.md

@@ -2,7 +2,9 @@
 component: Overlay
 category: Overlay
 related: [OverlayBase, OverlayMask, OverlayPanel, LightBox, TopOverlay, ModalWindow, DropdownMobile]
-tokens: [--triplex-next-Overlay-Background, --triplex-next-Overlay-Panel_Background]
+tokens:
+  - Overlay.Background
+  - Overlay.Panel_Background
 stories: stories/Overlay/Overlay.stories.tsx
 version: "1.34.0"
 ---
@@ -45,7 +47,7 @@ off-canvas) над контейнером или страницей.
 |---|---|---|---|
 | `fixed` | `boolean` | `false` | `position: fixed` (на всю страницу) вместо `absolute` (поверх родителя) |
 | `onOpening` | `() => void` | — | Вызывается в начале открытия |
-| `onOpen` | `() => void` | — | Вызывается по завершении анимации открытия |
+| `onOpen` | `() => void` | — | Вызывается по завершении анимации открытия. Если оверлей смонтирован уже с `opened={true}`, анимации нет и колбэк вызывается сразу на маунте |
 | `onClosing` | `() => void` | — | Вызывается в начале закрытия |
 | `onClose` | `() => void` | — | Вызывается по завершении анимации закрытия |
 | `...HTMLDivAttributes` | — | — | Стандартные атрибуты корневого `<div>` (кроме `children`) |
@@ -90,9 +92,12 @@ off-canvas) над контейнером или страницей.
 
 ## Дизайн-токены
 
-```
---triplex-next-Overlay-Background        // фон маски (OverlayMask)
---triplex-next-Overlay-Panel_Background  // фон панели (OverlayPanel)
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Overlay.ts`.
+
+```text
+Overlay.Background        // фон маски (OverlayMask)
+Overlay.Panel_Background  // фон панели (OverlayPanel)
 ```
 
 Box-shadow панели и тайминги transition (`0.3s ease-in-out`) заданы константами в
@@ -134,6 +139,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 +210,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/Page.md

@@ -62,8 +62,8 @@ version: "1.0"
 LESS-переменными в `styles/Page.module.less` (`@page-padding-*`, `@screen-sm-max`). Sticky-стили
 для прилипающих Header/Footer (классы `.headerPageTypeFirst.sticky`, `.footerPageTypeFirst.sticky`)
 применяются при ширине viewport от 992px (`@screen-lg`) и высоте от 801px и
-используют токены соответствующих компонентов (`--triplex-next-HeaderPage-StickyShadow`,
-`--triplex-next-FooterPage-StickyShadow`) — они описаны в AI.md этих компонентов.
+используют токены соответствующих компонентов (`HeaderPage.StickyShadow`,
+`FooterPage.StickyShadow`) — они описаны в AI.md этих компонентов.
 
 ---
 

package/bundle/components/Pagination.md

@@ -15,10 +15,10 @@ related:
   - ButtonBase
   - MasterTable
 tokens:
-  - --triplex-next-Pagination-PageButton_Background_Hover
-  - --triplex-next-Pagination-PageButton_Background_Active
-  - --triplex-next-Pagination-PageButton_Background_Selected
-  - --triplex-next-Pagination-PageButton_BorderColor_Focus
+  - Pagination.PageButton_Background_Hover
+  - Pagination.PageButton_Background_Active
+  - Pagination.PageButton_Background_Selected
+  - Pagination.PageButton_BorderColor_Focus
 stories: stories/Pagination/Pagination.stories.tsx
 version: "1.0"
 ---
@@ -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` | Сколько соседних страниц показывать вокруг текущей. |
@@ -64,6 +64,8 @@ version: "1.0"
 
 Расширяет `ISelectFieldProps` (без `size`, с обязательным `value`) и добавляет `paginationLabel: React.ReactNode` — текст лейбла перед селектом. Размер селекта зафиксирован как `EComponentSize.SM`. `value`, `options`, `onChange` — управляются потребителем.
 
+Распределение свойств по DOM: `className` идёт на корневой `<div>` (он задаёт раскладку лейбла и селекта), все остальные свойства (`data`-атрибуты, `id`, `aria`-атрибуты, `targetProps`, `dropdownProps`, `mobileTitle`, `placeholder` и прочие свойства `SelectField`) прокидываются в `SelectField`. `mobileTitle` по умолчанию равен `paginationLabel`, `targetProps` мержится с внутренним `fieldLabel: ""`, `aria-labelledby` по умолчанию указывает на лейбл, но переопределяется потребителем.
+
 ### Состояние загрузки внутри `MasterTable`
 
 Собственного prop загрузки у пагинации нет. Внутри `MasterTable` с `loading` элементы пагинации
@@ -87,13 +89,16 @@ version: "1.0"
 
 ## Дизайн-токены
 
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Pagination.ts`.
+
 Собственные токены использует только `PaginationPageButton`:
 
 ```text
---triplex-next-Pagination-PageButton_Background_Hover
---triplex-next-Pagination-PageButton_Background_Active
---triplex-next-Pagination-PageButton_Background_Selected
---triplex-next-Pagination-PageButton_BorderColor_Focus
+Pagination.PageButton_Background_Hover
+Pagination.PageButton_Background_Active
+Pagination.PageButton_Background_Selected
+Pagination.PageButton_BorderColor_Focus
 ```
 
 Остальные части наследуют визуал от переиспользуемых компонентов: кнопки навигации — от `ButtonIcon`, кнопка-страница — от `ButtonBase`, селект — от `SelectField`, текст — от `Typography` (`Text`).
@@ -105,10 +110,11 @@ 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.
+- `PaginationSelect` не должен терять свойства: его публичный тип — свойства `SelectField`, поэтому всё, что не разобрано явно, обязано уходить в `SelectField`. Точечные перечисления props вместо `...rest` здесь уже приводили к молчаливой потере `status`, `targetProps` и `data`-атрибутов.
 - Импорт `MasterTableContext` в частях пагинации — абсолютный (`@sberbusiness/triplex-next/components/Table/MasterTableContext`), как в самом `Table`. Относительный путь сюда не ставить.
 
 ---
@@ -156,7 +162,9 @@ version: "1.0"
 | Дата | Изменение |
 |---|---|
 | 2026-06-22 | Создан документ |
+| 2026-08-26 | `PaginationSelect` прокидывает в `SelectField` все свойства, которые не разбирает сам: `data`-атрибуты, `id`, `aria`-атрибуты, `targetProps`, `dropdownProps`, `mobileTitle` и т.д. Публичный API не изменился. |
 | 2026-08-12 | В состоянии загрузки `MasterTable` элементы пагинации становятся `disabled` — читается из `MasterTableContext.loading`. Публичный API не изменился. Заодно `PaginationSelect` перестал молча терять переданный `status`. |
+| 2026-08-27 | Навигация больше не скрывается при `totalPages <= 1`: отрисовывается одна страница с заблокированными стрелками, высота панели пагинации не схлопывается. Публичный API не изменился. |
 
 ---
 
@@ -270,15 +278,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]}

package/bundle/components/Row.md

@@ -45,7 +45,7 @@ version: "1.0"
 
 ## Дизайн-токены
 
-Компонент не использует CSS-переменных `--triplex-next-*`. Размеры берутся из LESS-переменных сетки в `src/styles/components/grid.less`:
+Компонент не использует дизайн-токенов. Размеры берутся из LESS-переменных сетки в `src/styles/components/grid.less`:
 
 ```less
 @row-bottom-padding: 16px

package/bundle/components/SelectExtendedField.md

@@ -105,9 +105,9 @@ version: "1.0"
 каретки и блокировку указателя в `disabled`. Цвета, фон, границы и тени приходят из
 компонентов, на которых построено поле:
 
-- `FormField` и его части (`FormFieldLabel`, `FormFieldTarget`, `FormFieldPrefix`, `FormFieldPostfix`, `FormFieldClear`) — `--triplex-next-FormField-*`;
-- `Dropdown` и `DropdownList` — `--triplex-next-Dropdown-*`, `--triplex-next-DropdownList-*`;
-- `IconWrapper` вокруг каретки — `--triplex-next-IconWrapper-*`;
+- `FormField` и его части (`FormFieldLabel`, `FormFieldTarget`, `FormFieldPrefix`, `FormFieldPostfix`, `FormFieldClear`) — группа `FormField`;
+- `Dropdown` и `DropdownList` — группы `Dropdown` и `DropdownList`;
+- `IconWrapper` вокруг каретки — группа `IconWrapper`;
 - `LoaderSmall` в состоянии загрузки — токены лоадера.
 
 Если понадобится собственное визуальное состояние поля выбора — токен заводится