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

package/bundle/components/MobileView.md

@@ -1,11 +1,9 @@
 ---
 component: MobileView
-category: Utilities
-figma-node: ""
-figma-file: ""
-related: [MediaWidth]
+category: MobileView
+related: [MediaWidth, MediaMaxWidth, useMatchMedia, useMobileView]
 tokens: []
-stories: ""
+stories: stories/MobileView/MobileView.stories.tsx
 version: "1.0"
 ---
 
@@ -13,108 +11,234 @@ version: "1.0"
 
 ## Назначение
 
-Удобная обёртка над `MediaWidth maxWidth={SM_MAX}` — рендерит `children`
-на мобиле (< 768px), иначе `fallback`. Фактически **именованный пресет**
-для частого use-case'а mobile-vs-desktop.
+Сервисный headless-компонент адаптивности. Рендерит `children`, когда ширина окна
+браузера соответствует мобильному устройству (`max-width: 767px`), и `fallback` —
+во всех остальных случаях. Собственной разметки не добавляет: в DOM попадает
+ровно тот элемент, который выбран по медиа-запросу.
 
-Используй когда: нужно рендерить разные React-деревья для mobile/desktop.
-Для стилей — CSS `@media` напрямую. Для более гибких границ —
-`MediaWidth`/`MediaMinWidth`/`MediaMaxWidth`.
+Реализован как сокращение над `MediaWidth` с `maxWidth={EScreenWidth.SM_MAX}` —
+вся логика подписки на медиа-запрос живёт в `MediaMaxWidth` → `useMatchMedia`.
 
----
-
-## Файловая структура
+Используй когда: на мобильной ширине нужно отрендерить **другое дерево**
+компонентов, а не просто другие стили — мобильный вариант дропдауна вместо
+десктопного, тултип-модалка вместо всплывающей подсказки, список вместо таблицы.
 
-```text
-src/components/MobileView/
-├── MobileView.tsx    # FC, 3 строки — обёртка над MediaWidth
-└── index.ts          # Barrel
-```
-
-Нет стилей, тестов, stories.
+Не используй когда:
+- Разница между мобильным и десктопом чисто визуальная (отступы, шрифт,
+  раскладка) — это дешевле и надёжнее решается медиа-запросом в
+  `*.module.less`, без перемонтирования поддерева.
+- Нужен не выбор между двумя готовыми элементами, а булево значение для props
+  или условной разметки вокруг — используй хук `useMobileView` (см. ниже).
+- Нужна не мобильная, а произвольная граница ширины — используй `MediaWidth`
+  (`minWidth` / `maxWidth`) напрямую.
 
 ---
 
 ## Варианты и props
 
-### `IMobileViewProps`
+### Обязательные props
+
+| Prop | Тип | Описание |
+|---|---|---|
+| `children` | `React.ReactElement \| null` | Элемент для мобильной ширины (`<768px`). `null` — на мобильной ширине не рендерится ничего |
+| `fallback` | `React.ReactElement \| null` | Элемент для остальных ширин. Обязателен: prop без значения по умолчанию, для «ничего» передаётся явный `null` |
+
+Опциональных props нет. `className`, `...rest` и `ref` компонент не принимает —
+у него нет собственного host-элемента.
+
+### Особенности поведения
+
+- Граница — `EScreenWidth.SM_MAX` (`767px`), запрос `(max-width: 767px)`. При
+  ширине ровно `767px` рендерится `children`, при `768px` — `fallback`.
+- **Ветки взаимоисключающие.** При пересечении границы одна ветка размонтируется,
+  вторая монтируется: локальный state, фокус, значения неконтролируемых полей и
+  текущие анимации внутри поддерева теряются. Состояние, которое должно
+  переживать смену ширины, храни выше `MobileView` (или передавай его как props
+  в обе ветки).
+- Значение медиа-запроса читается синхронно на первом рендере (`useMatchMedia`
+  вызывает `window.matchMedia` в инициализаторе `useState`), поэтому «мигания»
+  десктопной ветки на мобильном экране нет.
+- Пересчёт при ресайзе идёт по событию `change` у `MediaQueryList`, а не по
+  `resize` окна — слушатель снимается при размонтировании.
+- **Компонент не SSR-safe:** `window.matchMedia` вызывается на первом рендере.
+  Это поведение унаследовано от `useMatchMedia` и общее для всего семейства
+  `MediaWidth`.
+
+### `useMobileView`
+
+Хук из того же barrel (`src/components/MobileView/useMobileView.ts`). Возвращает
+`boolean` — результат того же медиа-запроса `(max-width: 767px)`. Нужен, когда
+от ширины зависят props или разметка вокруг, а не выбор между двумя готовыми
+элементами: размер кнопки, `block`-режим, наличие иконки. Так его используют
+`DateFieldTarget`, `MonthYearFieldTarget`, `CheckboxTreeExtended`, `IslandWidget`,
+`IslandAccordionItem`, `Tooltip`.
+
+Компонент и хук строят строку запроса независимо (`MediaMaxWidth` — из своего
+prop, хук — из константы `MOBILE_QUERY`), но обе строки собираются из
+`EScreenWidth.SM_MAX` и всегда совпадают. Правя одно, проверь второе.
+
+---
 
-| Prop | Тип | Обязателен | Описание |
-|---|---|---|---|
-| `children` | `ReactElement \| null` | Да | Рендерится при ширине ≤ SM_MAX (767px). |
-| `fallback` | `ReactElement \| null` | Да | Рендерится в остальных случаях (desktop). |
+## Дизайн-токены
 
-Обе props — обязательные. Следует контракту `MediaWidth`.
+Собственных стилей и CSS-переменных нет — компонент не рендерит разметку.
 
 ---
 
-## Ключевые особенности реализации
+## Инварианты
 
-### Брейкпоинт — `EScreenWidth.SM_MAX`
+- **Без `forwardRef` — осознанное исключение** из общего правила библиотеки:
+  компонент не рендерит собственный host-элемент, форвардить `ref` некуда.
+  Не добавлять и не убирать без отдельного решения — это публичный контракт.
+- **Имена и типы props `children`, `fallback`** и интерфейс `IMobileViewProps`
+  (экспортируется из barrel) — публичное API, не менять. `fallback` остаётся
+  обязательным: сделать его опциональным можно только осознанно, это меняет
+  контракт у потребителей.
+- **Сигнатура `useMobileView(): boolean`** и его barrel-экспорт — публичное API.
+  Хук используется внутри библиотеки в шести компонентах.
+- **Граница мобильной ширины — `EScreenWidth.SM_MAX`.** Не хардкодить `767px`
+  и не переводить на `MD_MIN` с `min-width`: значение согласовано с сеткой
+  дизайн-системы и с LESS-переменными брейкпоинтов.
+- **Делегирование в `MediaWidth`** — не инлайнить `useMatchMedia` в
+  `MobileView.tsx`: семейство `MediaWidth` остаётся единственным местом с
+  логикой подписки на медиа-запросы.
+- Реализация остаётся React 17-совместимой (без `useId`,
+  `useSyncExternalStore` и прочих React 18-only API): код синхронизируется
+  в `release-0`.
 
-```tsx
-<MediaWidth maxWidth={EScreenWidth.SM_MAX} fallback={fallback}>
-    {children}
-</MediaWidth>
-```
+---
 
-- `SM_MAX` обычно равен `767px` (проверь в `helpers/breakpoints`).
-- **Фиксированный брейкпоинт** — если нужен другой (например, планшеты), используй `MediaWidth` с явным `maxWidth`, а не оборачивай MobileView.
+## Accessibility
 
-### `children` на mobile, `fallback` на desktop
+- Собственной ARIA-семантики нет — компонент прозрачен для accessibility-дерева.
+- Невыбранная ветка **не рендерится в DOM**, а не скрывается визуально: скринридер
+  и последовательность табуляции видят только актуальный вариант. Дублирования
+  контента для ассистивных технологий не возникает, но и «десктопная» разметка
+  на мобильном недоступна.
+- Смена ветки при ресайзе удаляет из DOM сфокусированный элемент — фокус
+  переходит на `<body>`. Если это критично (открытый оверлей, форма), верни
+  фокус явно на стороне потребителя.
+- Медиа-запрос завязан на ширину окна, а не на тип ввода: на десктопе с узким
+  окном тоже рендерится мобильная ветка. Не завязывай на `MobileView` наличие
+  touch-специфичных обработчиков как единственного способа взаимодействия.
 
-Контракт отличается от "обычных" компонентов: **`children` — мобильное поведение**, а не базовое. При чтении кода это бывает контринтуитивно. Пример:
+---
 
-```tsx
-<MobileView
-    fallback={<DesktopLayout />}
->
-    <MobileLayout />
-</MobileView>
-```
+## Связанные компоненты
+
+- `MediaWidth` (`src/components/MediaWidth/`) — общий случай: `minWidth` и/или
+  `maxWidth`. `MobileView` — его частный случай для мобильной границы.
+- `MediaMaxWidth`, `MediaMinWidth`, `MediaBetweenWidth` — реализации конкретных
+  диапазонов, к которым `MediaWidth` делегирует рендер.
+- `useMatchMedia` (`src/components/MediaWidth/useMatchMedia.ts`) — хук подписки
+  на произвольный медиа-запрос, основа и компонента, и `useMobileView`.
 
-### Не SSR-safe через `useMatchMedia` (см. MediaWidth-AI)
+### Потребители внутри библиотеки
 
-Поведение наследуется от `MediaWidth`: `window.innerWidth` читается при рендере.
+Компонентом (`MobileView`): `Dropdown`, `Tooltip` (`TooltipBody`, `TooltipLink`),
+`HelpBox`, `DateField`, `SuggestField`, `TabsLine`, `ImageGallery`,
+`ImageGalleryExtendedMain`.
+Хуком (`useMobileView`): `DateFieldTarget`, `MonthYearFieldTarget`,
+`CheckboxTreeExtended`, `IslandWidget`, `IslandAccordionItem`, `Tooltip`.
+
+В unit-тестах потребителей мобильная/десктопная ветка задаётся подменой
+`window.matchMedia` (как в `Dropdown.test.tsx`) либо мокированием самого модуля
+`MobileView` (как в `ImageGallery.test.tsx`, `LightBox.test.tsx`).
 
 ---
 
-## Инварианты
+## Stories
 
-- **Брейкпоинт `SM_MAX`** фиксирован — публичное поведение.
-- **`children` — mobile, `fallback` — desktop** — не менять семантику без миграции потребителей.
-- **Обе prop'ы обязательны** (`ReactElement | null`, не `ReactNode`, не optional).
-- **FC, не forwardRef** — ref не пробрасывается.
+Основные истории: `stories/MobileView/MobileView.stories.tsx`
+Файлы примеров: `stories/MobileView/examples/`
 
----
+Playground у компонента нет: `children` и `fallback` — React-элементы, для
+Controls в них нечего настраивать. Скриншот-тесты снимают обе ветки: на
+viewport `xs` (575px) рендерится мобильный вариант, на `xl` (1200px) —
+`fallback`.
 
-## Accessibility
+| Story | Example file | Что демонстрирует |
+|---|---|---|
+| `Default` | `Default.tsx` | Выбор между `children` и `fallback` по ширине окна |
+| `Example: useMobileView` | `Example.tsx` | Хук вместо компонента: на мобильной ширине кнопки становятся блочными и меняют размер |
 
-Тот же нюанс, что и `MediaWidth`: разные React-деревья → смена DOM на брейкпоинте. Для стилистических различий предпочитай CSS.
+Пример использования `MobileView` есть и в stories `MediaWidth`
+(`stories/MediaWidth/examples/MobileViewExample.tsx`) — он показывает связь
+частного случая с общим и остаётся в документации `MediaWidth`.
 
 ---
 
-## Дизайн-токены
+## История изменений
 
-Нет.
+| Дата | Изменение |
+|---|---|
+| 2026-08-10 | Создан документ. AI-рефакторинг (TRI-59): `useMobileView.tsx` → `useMobileView.ts` (в файле нет JSX), явный тип возврата у хука, `displayName` у `MobileView`, дополнен JSDoc, добавлены unit-тесты (15 кейсов) и stories по modern pattern. Публичный API не изменён (props, сигнатура хука, barrel-экспорты; `forwardRef` по-прежнему осознанно отсутствует). |
 
 ---
 
-## Связанные компоненты
+## Примеры использования
 
-- `MediaWidth` — общая абстракция (MobileView — её конкретизация).
-- `EScreenWidth.SM_MAX` — из `@sberbusiness/triplex-next/helpers/breakpoints`.
+### Default
 
----
+`stories/MobileView/examples/Default.tsx`
 
-## Stories
+```tsx
+import React from "react";
+import { MobileView } from "@sberbusiness/triplex-next";
+
+export const Default = () => (
+    <MobileView
+        fallback={
+            <div style={{ border: "1px dashed rgb(125, 131, 138)", borderRadius: "4px", padding: "16px" }}>
+                Десктопная версия: ширина окна браузера 768px и больше.
+            </div>
+        }
+    >
+        <div style={{ border: "1px dashed rgb(125, 131, 138)", borderRadius: "4px", padding: "16px" }}>
+            Мобильная версия: ширина окна браузера меньше 768px.
+        </div>
+    </MobileView>
+);
+```
 
-Нет.
+### Example: useMobileView
 
----
+`stories/MobileView/examples/Example.tsx`
 
-## История изменений
+```tsx
+import React from "react";
+import { Button, EButtonTheme, EComponentSize, useMobileView } from "@sberbusiness/triplex-next";
+
+export const Example = () => {
+    const mobile = useMobileView();
+
+    return (
+        <div
+            style={{
+                display: "flex",
+                flexDirection: mobile ? "column" : "row",
+                gap: "8px",
+                maxWidth: "400px",
+            }}
+        >
+            <Button
+                theme={EButtonTheme.GENERAL}
+                size={mobile ? EComponentSize.SM : EComponentSize.MD}
+                block={mobile}
+                onClick={() => {}}
+            >
+                Сохранить
+            </Button>
+            <Button
+                theme={EButtonTheme.SECONDARY}
+                size={mobile ? EComponentSize.SM : EComponentSize.MD}
+                block={mobile}
+                onClick={() => {}}
+            >
+                Отменить
+            </Button>
+        </div>
+    );
+};
+```
 
-| Дата | Изменение |
-|---|---|
-| 2026-04-18 | Создан документ |

package/bundle/components/ModalWindow.md

@@ -101,7 +101,7 @@ version: "1.0"
 
 - **`ModalWindowContent`** — контейнер контента. Оборачивает дочерние секции в `Page` (`triplex-next/Page`). Имеет `isLoading?: boolean` и `loaderScreenProps?: ILoaderScreenMiddleProps` — при `isLoading` поверх контента показывается `LoaderScreen` типа `middle`; кастомизация лоадера (текст, кнопки и др.) передаётся через `loaderScreenProps`. Свой `displayName`. Свои props через интерфейс `IModalWindowContentProps` — экспортируется.
 - **`ModalWindowHeader`** — заголовок. Тривиальная обёртка над `HeaderPage` с фиксированным `type=FIRST` и доп. отступом справа под кнопку закрытия (через less). Экспонирует статическое поле `Title = HeaderPage.Title`. Тип `IModalWindowHeaderProps` (Omit `children`/`type` от `IHeaderPageTypeFirstProps`).
-- **`ModalWindowBody`** — тело. Тривиальная обёртка над `Island` с фиксированными `type=TYPE_1` и `size=MD`. Тип `IModalWindowBodyProps extends IIslandProps`.
+- **`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`).
 - **`ModalWindowViewManager`** — невидимый компонент-сенсор. Создаёт DOM-ноду `<div id="modalWindowViewManagerNodeId">` (если её нет в `body`) и рендерит туда через `Portal` resize-сенсор + `<style>`-инжект CSS-переменных `--modalWindow-screen-*` в `:root`. Подключается автоматически из `ModalWindow`; экспортируется отдельно для случая, когда лайаут хочет позиционировать ноду вручную (например, рисовать модалку только в области рабочей зоны без шапки).
@@ -133,6 +133,8 @@ version: "1.0"
 | 2026-05-06 | Возвращён `forwardRef` в `ModalWindowContent` и `ModalWindowViewManager` (обязательный инвариант проекта). Удалён захардкоженный `title="Закрыть"` из `ModalWindowClose` — для мультиязычной библиотеки текст подсказки должен приходить от потребителя. **Breaking:** теперь `title` не подставляется автоматически. |
 | 2026-06-25 | Fix: устранено падение `focus-trap` `"must have at least one container with at least one tabbable node"` при открытии модалки без tabbable-узлов (асинхронный контент/лоадер). Добавлены `fallbackFocus` на dialog-узел и `tabIndex={-1}` на `role="dialog"`. Регрессия проявилась после синхронной активации ловушки в рефакторинге 1.28.0. Добавлен интеграционный тест на реальном `focus-trap`. |
 | 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`. |
 
 ---
 

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/Page.md

@@ -61,6 +61,7 @@ version: "1.0"
 Собственных CSS-переменных дизайн-токенов у `Page` нет. Внешние отступы и брейкпоинты заданы
 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 этих компонентов.
 
@@ -73,7 +74,7 @@ LESS-переменными в `styles/Page.module.less` (`@page-padding-*`, `@s
 - `Page` собран через `Object.assign(forwardRef(...), { Body, Header, Footer })` — статические
   свойства `Header` / `Body` / `Footer` должны сохраняться.
 - Корневые классы `page` и `global-page` на корневом `<div>` — не переименовывать (используются
-  в стилях, в т.ч. в sticky-селекторах `.global-LB-more-media-point-0`).
+  в стилях; sticky-стили частей задаются медиазапросом `min-width: 992px` и `min-height: 801px`).
 - Экспорты `Page`, `IPageProps` идут в barrel `src/components/Page/index.ts` — сохранять.
   Там же реэкспортируются части и их enum'ы (`EHeaderPageType`, `EFooterPageType`, `EBodyPageType`,
   `EBodyPageVerticalMargin`).
@@ -120,6 +121,7 @@ aria-атрибутов. Семантику задаёт потребитель
 
 | Дата | Изменение |
 |---|---|
+| 2026-08-06 | Sticky-позиционирование Header/Footer доступно вне `LightBox` при ширине viewport от 992px и отключено при высоте viewport не больше 800px. |
 | 2026-07-20 | Вертикальные padding изменены: 24px (было 32px) для desktop, 8px (было 16px) для mobile — через `@page-padding-desktop-y` / `@page-padding-mobile-y`. |
 | 2026-06-24 | Создан документ. AI-рефакторинг (JSDoc на компоненте и `IPageProps`), unit-тесты (className-merge, статические части), миграция stories на modern pattern. |
 

package/bundle/components/Pagination.md

@@ -13,6 +13,7 @@ related:
   - SelectField
   - ButtonIcon
   - ButtonBase
+  - MasterTable
 tokens:
   - --triplex-next-Pagination-PageButton_Background_Hover
   - --triplex-next-Pagination-PageButton_Background_Active
@@ -63,6 +64,21 @@ version: "1.0"
 
 Расширяет `ISelectFieldProps` (без `size`, с обязательным `value`) и добавляет `paginationLabel: React.ReactNode` — текст лейбла перед селектом. Размер селекта зафиксирован как `EComponentSize.SM`. `value`, `options`, `onChange` — управляются потребителем.
 
+### Состояние загрузки внутри `MasterTable`
+
+Собственного prop загрузки у пагинации нет. Внутри `MasterTable` с `loading` элементы пагинации
+блокируются автоматически: `PaginationNavigationButton` и `PaginationPageButton` получают
+`disabled`, `PaginationSelect` — `status={EFormFieldStatus.DISABLED}`, из-за которого выпадающий
+список не открывается. Читается это из `MasterTableContext` (`loading`), поэтому работает и через
+`Pagination`, и через ручную компоновку на `PaginationExtended`.
+
+Лоадер при этом рисует `TableBasic` — он лежит в собственном `position: relative`-контейнере и
+перекрывает только таблицу. Пагинация в `MasterTable.PaginationPanel` остаётся видимой и читаемой.
+
+Вне `MasterTable` контекст отдаёт `loading: false`, поэтому автономная пагинация ведёт себя
+как раньше: блокировка приходит только из `disabled` на `buttonPrevProps`/`buttonNextProps` и из
+крайних страниц.
+
 ### Subкомпоненты для кастомной компоновки
 
 Для нестандартной раскладки используется `PaginationExtended` напрямую с вложенными `PaginationNavigation` и `PaginationSelect` (см. story `Extended`). Низкоуровневые части (`PaginationNavigationExtended`, `PaginationNavigationExtendedItem`, `PaginationPageButton`, `PaginationPageEllipsis`, `PaginationNavigationButton`) экспортируются для построения полностью кастомной навигации, но обычно используются неявно через `PaginationNavigation`.
@@ -92,6 +108,8 @@ version: "1.0"
 - Навигация рендерится только при `totalPages > 1` — поведение публичное, на него опираются потребители.
 - Логику `PaginationUtils.createPagesArray` / `generatePageRanges` / `generateRange` не менять без перегенерации `__tests__/paginationUtils.test.tsx` — там зафиксированы граничные случаи раскладки.
 - `PAGINATION_ELLIPSIS_VALUE = -1` — sentinel в массиве страниц, на него завязан рендер многоточия.
+- Блокировка по `MasterTableContext.loading` перекрывает `disabled`, пришедший из props: в состоянии загрузки кнопка заблокирована независимо от того, что передал потребитель. Обратное неверно — вне загрузки решает prop.
+- Импорт `MasterTableContext` в частях пагинации — абсолютный (`@sberbusiness/triplex-next/components/Table/MasterTableContext`), как в самом `Table`. Относительный путь сюда не ставить.
 
 ---
 
@@ -114,6 +132,7 @@ version: "1.0"
 - `PaginationPageButton` — кнопка-страница (поверх `ButtonBase`).
 - `PaginationPageEllipsis` — многоточие, заменяющее группу скрытых страниц.
 - `PaginationNavigationButton` — кнопка «Назад»/«Вперёд» (поверх `ButtonIcon`), направление задаётся `EPaginationNavigationIconDirection`.
+- `MasterTable` — таблица, в паре с которой пагинация обычно и используется (`MasterTable.PaginationPanel`). Её `loading` через `MasterTableContext` блокирует элементы пагинации.
 
 ---
 
@@ -137,6 +156,7 @@ version: "1.0"
 | Дата | Изменение |
 |---|---|
 | 2026-06-22 | Создан документ |
+| 2026-08-12 | В состоянии загрузки `MasterTable` элементы пагинации становятся `disabled` — читается из `MasterTableContext.loading`. Публичный API не изменился. Заодно `PaginationSelect` перестал молча терять переданный `status`. |
 
 ---