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

package/bundle/components/HeaderPage.md

@@ -2,7 +2,8 @@
 component: HeaderPage
 category: Page
 related: [Page, BodyPage, FooterPage, Header, Island, LightBox]
-tokens: [--triplex-next-HeaderPage-StickyShadow]
+tokens:
+  - HeaderPage.StickyShadow
 stories: stories/Page/HeaderPage/HeaderPage.stories.tsx
 version: "1.0"
 ---
@@ -52,9 +53,12 @@ version: "1.0"
 
 ## Дизайн-токены
 
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/HeaderPage.ts`.
+
 | Токен | Назначение |
 |---|---|
-| `--triplex-next-HeaderPage-StickyShadow` | Тень прилипшего заголовка (когда `sticky` и заголовок коснулся верхней границы, `data-stuck="true"`). |
+| `HeaderPage.StickyShadow` | Тень прилипшего заголовка (когда `sticky` и заголовок коснулся верхней границы, `data-stuck="true"`). |
 
 Внешний вид карточки наследуется от `Island` (`EIslandType.TYPE_1`). Радиус верхних углов при
 прилипании плавно обнуляется через CSS-переменную `--r-top` (управляется хуком

package/bundle/components/ImageGallery.md

@@ -2,21 +2,18 @@
 component: ImageGallery
 category: ImageGallery
 related: [ImageGalleryExtended, MobileView, LightBox]
-tokens: [
-  "--triplex-next-ImageGallery-Accent_Color",
-  "--triplex-next-ImageGallery-Arrow_Background_Default",
-  "--triplex-next-ImageGallery-Arrow_Background_Hover",
-  "--triplex-next-ImageGallery-Arrow_Background_Active",
-  "--triplex-next-ImageGallery-Arrow_Background_Disabled",
-  "--triplex-next-ImageGallery-Arrow_BorderColor_Default",
-  "--triplex-next-ImageGallery-Arrow_BorderColor_Hover",
-  "--triplex-next-ImageGallery-Arrow_BorderColor_Active",
-  "--triplex-next-ImageGallery-Arrow_BorderColor_Disabled",
-  "--triplex-next-ImageGallery-Dot_Background_Default",
-  "--triplex-next-ImageGallery-Dot_Background_Hover",
-  "--triplex-next-ImageGallery-Dot_Background_Active",
-  "--triplex-next-ImageGallery-Thumb_Mask_Background"
-]
+tokens:
+  - ImageGallery.Accent_Color
+  - ImageGallery.Arrow_Background_Default
+  - ImageGallery.Arrow_Background_Hover
+  - ImageGallery.Arrow_Background_Active
+  - ImageGallery.Arrow_BorderColor_Default
+  - ImageGallery.Arrow_BorderColor_Hover
+  - ImageGallery.Arrow_BorderColor_Active
+  - ImageGallery.Dot_Background_Default
+  - ImageGallery.Dot_Background_Hover
+  - ImageGallery.Dot_Background_Active
+  - ImageGallery.Thumb_Mask_Background
 stories: stories/ImageGallery/ImageGallery.stories.tsx
 version: "1.0"
 ---
@@ -88,28 +85,29 @@ controlled-only контейнера `ImageGalleryExtended`. Изображен
 
 ## Дизайн-токены
 
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/ImageGallery.ts`.
+
 Собственных стилей и `.less`-файлов у `ImageGallery` нет — вся отрисовка
 делегируется частям `ImageGalleryExtended`. Перечисленные токены принадлежат
-семейству и используются через эти части (общий префикс
-`--triplex-next-ImageGallery-` намеренно делится обоими семействами).
+семейству и используются через эти части — группа `ImageGallery` намеренно
+делится обоими семействами.
 
-```
---triplex-next-ImageGallery-Accent_Color
-
---triplex-next-ImageGallery-Arrow_Background_Default
---triplex-next-ImageGallery-Arrow_Background_Hover
---triplex-next-ImageGallery-Arrow_Background_Active
---triplex-next-ImageGallery-Arrow_Background_Disabled
---triplex-next-ImageGallery-Arrow_BorderColor_Default
---triplex-next-ImageGallery-Arrow_BorderColor_Hover
---triplex-next-ImageGallery-Arrow_BorderColor_Active
---triplex-next-ImageGallery-Arrow_BorderColor_Disabled
-
---triplex-next-ImageGallery-Dot_Background_Default
---triplex-next-ImageGallery-Dot_Background_Hover
---triplex-next-ImageGallery-Dot_Background_Active
-
---triplex-next-ImageGallery-Thumb_Mask_Background
+```text
+ImageGallery.Accent_Color
+
+ImageGallery.Arrow_Background_Default
+ImageGallery.Arrow_Background_Hover
+ImageGallery.Arrow_Background_Active
+ImageGallery.Arrow_BorderColor_Default
+ImageGallery.Arrow_BorderColor_Hover
+ImageGallery.Arrow_BorderColor_Active
+
+ImageGallery.Dot_Background_Default
+ImageGallery.Dot_Background_Hover
+ImageGallery.Dot_Background_Active
+
+ImageGallery.Thumb_Mask_Background
 ```
 
 Runtime CSS-переменная высоты крупной картинки
@@ -195,6 +193,7 @@ Runtime CSS-переменная высоты крупной картинки
 | Дата | Изменение |
 |---|---|
 | 2026-05-28 | Создан документ |
+| 2026-08-31 | Удалены неиспользуемые токены `Arrow_Background_Disabled` и `Arrow_BorderColor_Disabled`: неактивная стрелка скрывается (`display: none`), красить нечем |
 
 ---
 

package/bundle/components/ImageGalleryExtended.md

@@ -2,21 +2,18 @@
 component: ImageGalleryExtended
 category: ImageGalleryExtended
 related: [ImageGallery, MobileView, LightBox]
-tokens: [
-  "--triplex-next-ImageGallery-Accent_Color",
-  "--triplex-next-ImageGallery-Arrow_Background_Default",
-  "--triplex-next-ImageGallery-Arrow_Background_Hover",
-  "--triplex-next-ImageGallery-Arrow_Background_Active",
-  "--triplex-next-ImageGallery-Arrow_Background_Disabled",
-  "--triplex-next-ImageGallery-Arrow_BorderColor_Default",
-  "--triplex-next-ImageGallery-Arrow_BorderColor_Hover",
-  "--triplex-next-ImageGallery-Arrow_BorderColor_Active",
-  "--triplex-next-ImageGallery-Arrow_BorderColor_Disabled",
-  "--triplex-next-ImageGallery-Dot_Background_Default",
-  "--triplex-next-ImageGallery-Dot_Background_Hover",
-  "--triplex-next-ImageGallery-Dot_Background_Active",
-  "--triplex-next-ImageGallery-Thumb_Mask_Background"
-]
+tokens:
+  - ImageGallery.Accent_Color
+  - ImageGallery.Arrow_Background_Default
+  - ImageGallery.Arrow_Background_Hover
+  - ImageGallery.Arrow_Background_Active
+  - ImageGallery.Arrow_BorderColor_Default
+  - ImageGallery.Arrow_BorderColor_Hover
+  - ImageGallery.Arrow_BorderColor_Active
+  - ImageGallery.Dot_Background_Default
+  - ImageGallery.Dot_Background_Hover
+  - ImageGallery.Dot_Background_Active
+  - ImageGallery.Thumb_Mask_Background
 stories: stories/ImageGalleryExtended/ImageGalleryExtended.stories.tsx
 version: "1.0"
 ---
@@ -123,26 +120,27 @@ child `.Main`, чтобы стрелки позиционировались по
 
 ## Дизайн-токены
 
-Токены используют общий с `ImageGallery` префикс `--triplex-next-ImageGallery-`
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/ImageGallery.ts`.
+
+Токены живут в общей с `ImageGallery` группе `ImageGallery`
 (семейства делят визуальный язык).
 
-```
---triplex-next-ImageGallery-Accent_Color
-
---triplex-next-ImageGallery-Arrow_Background_Default
---triplex-next-ImageGallery-Arrow_Background_Hover
---triplex-next-ImageGallery-Arrow_Background_Active
---triplex-next-ImageGallery-Arrow_Background_Disabled
---triplex-next-ImageGallery-Arrow_BorderColor_Default
---triplex-next-ImageGallery-Arrow_BorderColor_Hover
---triplex-next-ImageGallery-Arrow_BorderColor_Active
---triplex-next-ImageGallery-Arrow_BorderColor_Disabled
-
---triplex-next-ImageGallery-Dot_Background_Default
---triplex-next-ImageGallery-Dot_Background_Hover
---triplex-next-ImageGallery-Dot_Background_Active
-
---triplex-next-ImageGallery-Thumb_Mask_Background
+```text
+ImageGallery.Accent_Color
+
+ImageGallery.Arrow_Background_Default
+ImageGallery.Arrow_Background_Hover
+ImageGallery.Arrow_Background_Active
+ImageGallery.Arrow_BorderColor_Default
+ImageGallery.Arrow_BorderColor_Hover
+ImageGallery.Arrow_BorderColor_Active
+
+ImageGallery.Dot_Background_Default
+ImageGallery.Dot_Background_Hover
+ImageGallery.Dot_Background_Active
+
+ImageGallery.Thumb_Mask_Background
 ```
 
 Runtime CSS-переменные (задаются компонентом через `style`, **не** дизайн-токены,
@@ -172,7 +170,7 @@ Runtime CSS-переменные (задаются компонентом чер
   change при изменении.
 - **Render-функции** `.Nav` и `.Thumbnails` — контракт; форма объекта состояния
   фиксирована.
-- Токены используют префикс `ImageGallery-`, а не `ImageGalleryExtended-` —
+- Токены лежат в группе `ImageGallery`, а не `ImageGalleryExtended` —
   переименование сломает темизацию у потребителей обоих семейств.
 
 ---
@@ -248,6 +246,7 @@ API (экспортируются из barrel ради композиции, н
 | Дата | Изменение |
 |---|---|
 | 2026-05-28 | Создан документ |
+| 2026-08-31 | Удалены неиспользуемые токены `Arrow_Background_Disabled` и `Arrow_BorderColor_Disabled`: неактивная стрелка скрывается (`display: none`), красить нечем |
 
 ---
 

package/bundle/components/Island.md

@@ -3,12 +3,12 @@ component: Island
 category: Layout
 related: [IslandAccordion, IslandWidget, LoaderScreen, ModalWindow]
 tokens:
-  - --triplex-next-Island-Type1_Background
-  - --triplex-next-Island-Type1_Shadow
-  - --triplex-next-Island-Type2_Background
-  - --triplex-next-Island-Type2_Shadow
-  - --triplex-next-Island-Type3_Background
-  - --triplex-next-Island-Type3_Shadow
+  - Island.Type1_Background
+  - Island.Type1_Shadow
+  - Island.Type2_Background
+  - Island.Type2_Shadow
+  - Island.Type3_Background
+  - Island.Type3_Shadow
 stories: stories/Island/Island.stories.tsx
 version: "1.0"
 ---
@@ -49,6 +49,7 @@ version: "1.0"
 | `size` | `EComponentSize` | `EComponentSize.MD` | Скругление, внутренние отступы карточки и отступы между Header / Body / Footer |
 | `loading` | `boolean` | `false` | Показывает `LoaderScreen` поверх контента карточки |
 | `loaderScreenProps` | `ILoaderScreenMiddleProps` | `undefined` | Props лоадера: `description`, `controls`, `className` и остальные атрибуты `<div>`. `type` задаёт Island (`middle`) |
+| `withoutPaddings` | `boolean` | `false` | Убирает внутренние отступы карточки. Скругление и отступы между Header / Body / Footer от `size` сохраняются |
 
 Компонент расширяет `React.HTMLAttributes<HTMLDivElement>` — все стандартные атрибуты `<div>`
 (`className`, `style`, `role`, `aria-*`, `data-*`, обработчики событий) попадают на корневой элемент.
@@ -125,13 +126,16 @@ version: "1.0"
 
 ## Дизайн-токены
 
-```
---triplex-next-Island-Type1_Background
---triplex-next-Island-Type1_Shadow
---triplex-next-Island-Type2_Background
---triplex-next-Island-Type2_Shadow
---triplex-next-Island-Type3_Background
---triplex-next-Island-Type3_Shadow
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/Island.ts`.
+
+```text
+Island.Type1_Background
+Island.Type1_Shadow
+Island.Type2_Background
+Island.Type2_Shadow
+Island.Type3_Background
+Island.Type3_Shadow
 ```
 
 Значения задаются в `src/components/DesignTokens/components/Island.ts`. `Type1_Shadow` и
@@ -238,11 +242,12 @@ Island — неинтерактивный контейнер: не выстав
 
 | Story | Example file | Что демонстрирует |
 |---|---|---|
-| `Playground` | — | Интерактивный контроль `type`, `size`, `loading` и состава (Header / Body / Footer) |
+| `Playground` | — | Интерактивный контроль `type`, `size`, `loading`, `withoutPaddings` и состава (Header / Body / Footer) |
 | `Default` | `DefaultExample.tsx` | Минимальная карточка: Header + Body + Footer |
 | `Types` | `TypesExample.tsx` | Все значения `EIslandType` рядом |
 | `Sizes` | `SizesExample.tsx` | Размеры SM / MD / LG: скругление, паддинги, отступы между частями |
 | `Loading` | `Loading.tsx` | `loading`: `LoaderScreen` поверх контента карточки |
+| `WithoutPaddings` | `WithoutPaddings.tsx` | `withoutPaddings` во всех размерах: внутренние отступы убраны, скругление и отступы между Header / Body / Footer сохраняются |
 
 Файлы примеров с постфиксом `Example` — локальный legacy-паттерн папки; новые примеры называются
 по имени story (`Loading.tsx`).
@@ -253,6 +258,7 @@ Island — неинтерактивный контейнер: не выстав
 
 | Дата | Изменение |
 |---|---|
+| 2026-08-24 | Добавлено свойство `withoutPaddings` — отключает внутренние отступы карточки. Добавлена story `WithoutPaddings`. |
 | 2026-08-11 | Prop состояния загрузки переименован `isLoading` → `loading` — по преобладающей в библиотеке конвенции boolean-props без префикса `is` (`loading` у `Button`, `List`, `Dropdown`, `Suggest`, `Table`). Prop ещё не выпускался, поэтому breaking change нет; `Omit` в `IModalWindowBodyProps` обновлён на `"loading"`. Поведение не изменилось. |
 | 2026-08-06 | `related` приведён к правилу `docs/ai/CONTEXT.md` → «Как заполнять `related` в AI.md»: убраны потребители (`BodyPage`, `HeaderPage`, `FooterPage`, `Confirm`), `ModalWindowBody` заменён родителем `ModalWindow`, добавлен `LoaderScreen`. Раздел «Связанные компоненты» разбит по типам связи. Добавлено состояние загрузки: props `isLoading` и `loaderScreenProps` — при `isLoading` поверх контента карточки рендерится `LoaderScreen` типа `middle`. Подложка наследует скругление карточки, `z-index` понижен до локального. `ModalWindowBody` эти props не наследует (`Omit`) — его тело скроллируется, лоадер там задаётся на `ModalWindowContent`. Добавлены story `Loading` и unit-тесты. Остальной публичный API не изменён. |
 | 2026-08-04 | Создан документ. AI-рефакторинг: JSDoc на props, значениях `EIslandType` и субкомпонентах, `displayName` у `IslandHeader` / `IslandBody` / `IslandFooter`, unit-тесты на все типы и размеры, части острова и `mapTypeToClassName`. Исправлено: `className` в `IslandHeader` и `IslandFooter` больше не затирает базовый класс компонента; побочный отступ в `IslandAccordion` погашен в стилях аккордеона, вид библиотечных компонентов не изменился. Публичный API не изменён. |
@@ -375,3 +381,35 @@ export const Loading = () => (
 );
 ```
 
+### WithoutPaddings
+
+`stories/Island/examples/WithoutPaddings.tsx`
+
+```tsx
+import React from "react";
+import { Island, EIslandType, EComponentSize } from "@sberbusiness/triplex-next";
+
+const SIZES = Object.values(EComponentSize);
+
+export const WithoutPaddings = () => (
+    <div
+        style={{
+            display: "grid",
+            gap: 16,
+            gridTemplateColumns: "repeat(auto-fit, minmax(260px, 1fr))",
+        }}
+    >
+        {SIZES.map((size) => (
+            <div key={size}>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>{size.toUpperCase()}</div>
+                <Island type={EIslandType.TYPE_1} size={size} withoutPaddings>
+                    <Island.Header>Header content</Island.Header>
+                    <Island.Body>Body content</Island.Body>
+                    <Island.Footer>Footer content</Island.Footer>
+                </Island>
+            </div>
+        ))}
+    </div>
+);
+```
+

package/bundle/components/LightBox.md

@@ -3,10 +3,9 @@ component: LightBox
 category: LightBox
 related: [Page, TopOverlay, Portal, FocusTrapExtended, LoaderScreen, Button, ModalWindow]
 tokens:
-  - --triplex-next-LightBox-Backdrop_Background
-  - --triplex-next-LightBox-Content_Background
-  - --triplex-next-LightBox-SideOverlay_Background
-  - --triplex-next-scroll-width
+  - LightBox.Backdrop_Background
+  - LightBox.Content_Background
+  - LightBox.SideOverlay_Background
 stories: stories/LightBox/LightBox.stories.tsx
 version: "1.0"
 ---
@@ -56,7 +55,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` |
@@ -88,16 +87,19 @@ version: "1.0"
 
 ## Дизайн-токены
 
-```css
---triplex-next-LightBox-Backdrop_Background
---triplex-next-LightBox-Content_Background
---triplex-next-LightBox-SideOverlay_Background
---triplex-next-scroll-width
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
+«Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/LightBox.ts`.
+
+```text
+LightBox.Backdrop_Background
+LightBox.Content_Background
+LightBox.SideOverlay_Background
 ```
 
-`--triplex-next-scroll-width` — глобальная переменная ширины скроллбара, проставляется утилитой
-`addClassNameWithScrollbarWidth` при открытии лайтбокса. Ширины размеров (`664/864/1064/1264`)
-заданы LESS-константами `@lightBox-content-max-width-*`.
+Ширина скроллбара — не токен: `addClassNameWithScrollbarWidth` вешает на `<html>` класс
+`scroll-{0|15|16|17}`, а `styles/LightBoxScroll.module.less` объявляет по нему локальную
+css-переменную `--lightBox-scroll-width`, которую вычитают из ширины оверлеев. Ширины размеров
+(`664/864/1064/1264`) заданы LESS-константами `@lightBox-content-max-width-*`.
 
 ---
 
@@ -128,9 +130,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 +151,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 +206,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 в состоянии загрузки сохранён рабочим |
 
 ---