@sberbusiness/triplex-next-mcp-server 1.44.0-beta → 1.46.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/HelpBox.md

@@ -39,7 +39,7 @@ version: "1.0"
 | `focusTrapProps` | `FocusTrapProps` | — | Свойства `focus-trap-react` для ловушки фокуса |
 | `tooltipAriaAttributes` | `TAriaHTMLAttributes` | — | Aria-атрибуты, пробрасываемые в Tooltip-контейнер |
 | `tooltipDataAttributes` | `TDataHTMLAttributes` | — | Data-атрибуты, пробрасываемые в Tooltip-контейнер |
-| `iconProps` | `ISingleColorIconProps` | — | Свойства иконки вопроса (например, `paletteIndex`) |
+| `iconProps` | `ISingleColorIconProps` | — | Свойства иконки вопроса (например, `paletteIndex`; по умолчанию `paletteIndex` равен `5`) |
 | `tooltipXButtonProps` | `ITooltipXButtonProps` | — | Свойства кнопки закрытия Tooltip (включая `aria-label`) |
 | `className` | `string` | — | CSS-класс, пробрасывается на кнопку-триггер |
 | `...rest` | `React.HTMLAttributes<HTMLButtonElement>` | — | Все стандартные атрибуты `<button>`, включая `aria-label`, пробрасываются на кнопку-триггер |
@@ -65,6 +65,9 @@ version: "1.0"
 - **`tooltipSize` prop** — обязательный, не делать optional.
 - **Barrel export в `index.ts`** — не удалять.
 - **`toggleType="hover"`** — Tooltip реагирует на наведение, не менять без согласования.
+- **Ловушка фокуса не активируется при hover-открытии** — фокус пользователя не должен переезжать в подсказку от одного наведения курсора.
+- **`uniqueId()` из `lodash-es`, а не `React.useId`** — код должен собираться в ветке
+  `release-0` под React 17.
 
 ---
 
@@ -75,6 +78,7 @@ version: "1.0"
 - **`aria-label` кнопки закрытия** — передаётся через `tooltipXButtonProps={{ "aria-label": "Закрыть" }}`. Потребитель **обязан** указать значение на своём языке.
 - Tooltip открывается с `role="dialog"`, `tabIndex={-1}`.
 - FocusTrap удерживает фокус внутри открытого тултипа на desktop. При активации: `initialFocus` — элемент Tooltip (по ID), `clickOutsideDeactivates: true` — клик за пределами закрывает, `preventScroll: true`. Потребитель может расширить настройки через `focusTrapProps.focusTrapOptions`.
+- **Ловушка фокуса не ставится, когда подсказку открыли мышью.** Признак вычисляется в момент открытия (`needFocusTrap`): ловушка нужна, если кнопка-триггер держит фокус (клавиатура) либо курсора над ней нет (программное открытие через `isOpen`). Клик мышью ловушку тоже не ставит — `mouseenter` открывает подсказку раньше клика, и второго `onShow` не происходит. Фокус при этом всё равно переходит на кнопку-триггер: это нативное поведение браузера при клике по `<button>`, к ловушке отношения не имеет.
 - `tooltipAriaAttributes` позволяет добавить aria-атрибуты к контейнеру Tooltip.
 
 ---
@@ -113,6 +117,8 @@ version: "1.0"
 | 2026-04-08 | Создан документ. Добавлен `forwardRef`. |
 | 2026-04-27 | Приведён в соответствие с `docs/ai/template-ai.md`: убраны секции «Файловая структура» и «Ключевые особенности реализации», их содержимое перенесено в `Ограничения использования` и `Accessibility`, переставлены секции, добавлена колонка `Example file`. |
 | 2026-07-08 | Актуализирована колонка `Example file`: имена файлов примеров приведены к фактическим (без постфикса `Example`). |
+| 2026-09-08 | AI-рефакторинг: `useId` заменён на `uniqueId` (совместимость с React 17), callback-`ref` стабилизирован через `useCallback`, убраны `!` и `as`-каст в работе с `ref`, `TooltipMobileHeader` берётся из composition-API `Tooltip.MobileHeader`, `paletteIndex` иконки вынесен в константу. Добавлены unit-тесты (25 кейсов, включая мобильную версию). |
+| 2026-09-10 | Ловушка фокуса больше не активируется при открытии подсказки наведением мыши (`needFocusTrap`): фокус остаётся в элементе, с которым работает пользователь. Добавлены unit-тесты на hover- и клавиатурный сценарии. |
 
 ---
 

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"
 ---
@@ -126,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` и