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

package/bundle/components/WindowResizeListener.md

@@ -0,0 +1,249 @@
+---
+component: WindowResizeListener
+category: WindowResizeListener
+related: [MediaWidth]
+tokens: []
+stories: stories/WindowResizeListener/WindowResizeListener.stories.tsx
+version: "1.0"
+---
+
+# WindowResizeListener
+
+## Назначение
+
+Сервисный headless-компонент. Пока смонтирован, слушает событие `resize` на
+`window` и вызывает `onResize`, но не чаще, чем раз в `throttleDelay`
+миллисекунд. Собственной разметки не рендерит: `children` выводятся как есть,
+без обёртки; без `children` не рендерит ничего.
+
+Используй когда: при изменении размеров окна нужно выполнить императивное
+действие — пересчитать размеры/отступы по замеренному DOM, перепозиционировать
+оверлей, сбросить кэш измерений.
+
+Не используй когда:
+- Нужно отрендерить **другое дерево** компонентов на другой ширине — для этого
+  есть `MediaWidth` / `MobileView`, они слушают `MediaQueryList`, а не поток
+  событий `resize`.
+- Нужно булево значение «широкий/узкий экран» для props или условной разметки —
+  используй `useMatchMedia` (`src/components/MediaWidth/useMatchMedia.ts`) или
+  `useMobileView`.
+- Отслеживать нужно размер конкретного элемента, а не окна — окно может не
+  меняться, а элемент — да (открылась панель, изменился контент). Для этого в
+  библиотеке используется `useResizeDetector` из `react-resize-detector`
+  (пример — `LightBoxContent`).
+- Разница чисто визуальная (отступы, шрифт, раскладка) — это дешевле решается
+  медиа-запросом в `*.module.less`, без JS-обработчика на каждое событие.
+
+---
+
+## Варианты и props
+
+### Обязательные props
+
+| Prop | Тип | Описание |
+|---|---|---|
+| `onResize` | `(event: UIEvent) => void` | Вызывается на `resize` окна. Получает нативный `UIEvent` (не React SyntheticEvent). Полезной нагрузки в событии нет — актуальные размеры читаются из `window.innerWidth` / `innerHeight` или замером DOM |
+
+### Опциональные props
+
+| Prop | Тип | По умолчанию | Описание |
+|---|---|---|---|
+| `throttleDelay` | `number` | `100` | Минимальный интервал между вызовами `onResize`, в миллисекундах |
+| `children` | `React.ReactNode` | — | Рендерится как есть. Компонент не оборачивает содержимое и никак на него не влияет — вложение нужно только для читаемости кода |
+
+### Особенности поведения
+
+- Слушатель навешивается в `useEffect`, поэтому `window` не трогается во время
+  рендера — компонент **SSR-safe** (в отличие от семейства `MediaWidth`, которое
+  вызывает `window.matchMedia` на первом рендере).
+- Троттлинг — `throttle` из `lodash-es` с настройками по умолчанию:
+  **leading + trailing**. Первое событие серии обрабатывается синхронно, все
+  последующие внутри окна схлопываются в один отложенный вызов в конце окна.
+  Одиночное событие даёт ровно один вызов; если внутри окна пришли ещё события,
+  в конце окна добавляется trailing-вызов.
+- **Обработчик и задержка входят в зависимости эффекта.** При смене ссылки
+  `onResize` или значения `throttleDelay` слушатель снимается и навешивается
+  заново, а троттлинг начинается с чистого листа (новое leading-окно). Если
+  передать инлайновую стрелку, переподписка будет происходить на **каждый
+  рендер**, и троттлинг фактически перестанет ограничивать частоту вызовов.
+  Оборачивай обработчик в `useCallback` (или храни его вне компонента).
+- При размонтировании слушатель снимается, а отложенный trailing-вызов
+  отменяется через `cancel()` — `removeEventListener` сам по себе его
+  не отменяет, и колбэк сработал бы уже после размонтирования.
+- Компонент не вызывает `preventDefault` / `stopPropagation` (событие `resize`
+  не отменяемо) и не подмешивает в `onResize` собственные данные о размерах.
+- Несколько смонтированных `WindowResizeListener` работают независимо, каждый со
+  своим окном троттлинга.
+
+---
+
+## Дизайн-токены
+
+Собственных стилей и CSS-переменных нет — компонент не рендерит разметку.
+
+---
+
+## Инварианты
+
+- **Без `forwardRef` — осознанное исключение** из общего правила библиотеки:
+  компонент не рендерит собственный host-элемент, форвардить `ref` некуда. Не
+  добавлять и не убирать без отдельного решения.
+- **Имена и типы props `children`, `onResize`, `throttleDelay`** и значение по
+  умолчанию `throttleDelay = 100` — публичное API, не менять. Интерфейс
+  `IWindowResizeListenerProps` экспортируется из barrel — переименование будет
+  breaking change.
+- **`return children ?? null`** — falsy-`children` (`0`, `""`) осознанно
+  рендерятся; `??`, а не `||` (у соседнего `KeyDownListener` обратная
+  договорённость — там `||`). Возврат `null` вместо `undefined` нужен для React
+  17: там компонент, вернувший `undefined`, роняет рендер.
+- **Зависимости эффекта `[onResize, throttleDelay]`** — не «оптимизировать»
+  переносом обработчика в `ref`: сейчас смена обработчика сбрасывает окно
+  троттлинга, и это наблюдаемое поведение у потребителей.
+- **`throttledResize.cancel()` в cleanup** — не удалять: без него отложенный вызов
+  срабатывает после размонтирования (тест `cancels the pending trailing call on
+  unmount`).
+- Реализация остаётся React 17-совместимой (без `useId`,
+  `useSyncExternalStore` и прочих React 18-only API): код синхронизируется
+  в `release-0`.
+
+---
+
+## Accessibility
+
+- Собственной ARIA-семантики нет — компонент прозрачен для accessibility-дерева
+  и не рендерит фокусируемых элементов.
+- `resize` окна возникает и при зуме страницы, и при появлении экранной
+  клавиатуры на мобильных. Обработчик не должен перебрасывать фокус или
+  сбрасывать состояние формы — для пользователя, увеличившего масштаб, это
+  выглядит как потеря контекста.
+
+---
+
+## Связанные компоненты
+
+- `MediaWidth` (`src/components/MediaWidth/`) — альтернатива для декларативного
+  случая: рендерит одну из двух веток по медиа-запросу, а не даёт колбэк на поток
+  событий. Там же `useMatchMedia` (булево значение для условной разметки) и
+  `MobileView` (частный случай мобильной границы). Правило выбора: нужно
+  **что-то посчитать/сделать** на ресайз — `WindowResizeListener`; нужно
+  **что-то показать** на определённой ширине — `MediaWidth`.
+- `KeyDownListener` (`src/components/KeyDownListener/`) — headless-слушатель того
+  же покроя, но для `keydown` на `window`. Похожий контракт по `children` (рендер
+  как есть, без обёртки); отличие — обработка falsy-`children`, см. «Инварианты».
+
+### Потребители внутри библиотеки
+
+- `LightBoxContent` (`src/components/LightBox/LightBoxContent.tsx`) — пересчёт
+  верхнего отступа контента при изменении размеров окна. Обработчик
+  (`updateStyleWithTimeout`) обёрнут в `useCallback`, поэтому переподписки на
+  каждый рендер не происходит. Слушатель размеров самого контента там сделан
+  отдельно, через `useResizeDetector`.
+
+В unit-тестах потребителей компонент удобно мокать целиком — как в
+`src/components/LightBox/__tests__/LightBoxContent.test.tsx`.
+
+---
+
+## Stories
+
+Основные истории: `stories/WindowResizeListener/WindowResizeListener.stories.tsx`
+Файлы примеров: `stories/WindowResizeListener/examples/`
+
+| Story | Example file | Что демонстрирует |
+|---|---|---|
+| `Playground` | `Playground.tsx` | Интерактивный подбор `throttleDelay`, счётчик срабатываний `onResize` и текущая ширина окна |
+| `Default` | `Default.tsx` | Минимальный пример: обработчик в `useCallback` читает `window.innerWidth` / `innerHeight` |
+| `ThrottleDelay` | `ThrottleDelay.tsx` | Два слушателя с разной задержкой (100 мс и 1000 мс) и их счётчики вызовов |
+
+Набор целиком исключён из скриншот-тестов (`testRunner: { skip: true }` в `meta`):
+собственной разметки компонент не рендерит, на скриншот попадала бы только
+обвязка примеров. Baseline-файлов в `__screenshots__/` для этого набора быть не
+должно. Поведение слушателя покрыто unit-тестами.
+
+---
+
+## История изменений
+
+| Дата | Изменение |
+|---|---|
+| 2026-08-18 | Создан документ. AI-рефакторинг (TRI-104): JSDoc на props и компоненте, интерфейс `IWindowResizeListenerProps` стал экспортируемым (аддитивно), `return children ?? null` вместо `return children` (React 17-safe), убрано лишнее опциональное обращение `cancel?.()`, добавлены unit-тесты (10 кейсов: рендер `children`, троттлинг с дефолтной и заданной задержкой, отписка и отмена trailing-вызова при размонтировании, переподписка при смене `onResize` / `throttleDelay`) и набор stories по modern pattern. Публичный API не изменён (имена и типы props, дефолт `throttleDelay = 100`, barrel-экспорты; `forwardRef` по-прежнему осознанно отсутствует). |
+
+---
+
+## Примеры использования
+
+### Default
+
+`stories/WindowResizeListener/examples/Default.tsx`
+
+```tsx
+import React, { useCallback, useState } from "react";
+import { WindowResizeListener } from "@sberbusiness/triplex-next";
+
+const getWindowSize = () =>
+    typeof window === "undefined" ? { width: 0, height: 0 } : { width: window.innerWidth, height: window.innerHeight };
+
+export const Default = () => {
+    // При рендере на сервере window недоступен — стартовое значение берётся только в браузере.
+    const [windowSize, setWindowSize] = useState(getWindowSize);
+
+    // Стабильная ссылка на обработчик: при её смене слушатель переподписывается заново.
+    const handleResize = useCallback(() => {
+        setWindowSize(getWindowSize());
+    }, []);
+
+    return (
+        <WindowResizeListener onResize={handleResize}>
+            <div style={{ display: "flex", flexDirection: "column", gap: "16px", maxWidth: "400px" }}>
+                <div>Измените размер окна браузера, чтобы обновить значения.</div>
+                <div style={{ border: "1px dashed rgb(125, 131, 138)", borderRadius: "4px", padding: "16px" }}>
+                    Размер окна: {windowSize.width} × {windowSize.height}
+                </div>
+            </div>
+        </WindowResizeListener>
+    );
+};
+```
+
+### ThrottleDelay
+
+`stories/WindowResizeListener/examples/ThrottleDelay.tsx`
+
+```tsx
+import React, { useCallback, useState } from "react";
+import { WindowResizeListener } from "@sberbusiness/triplex-next";
+
+interface IResizeCounterProps {
+    throttleDelay: number;
+}
+
+const ResizeCounter = ({ throttleDelay }: IResizeCounterProps) => {
+    const [resizeCount, setResizeCount] = useState(0);
+
+    const handleResize = useCallback(() => {
+        setResizeCount((prevCount) => prevCount + 1);
+    }, []);
+
+    return (
+        <WindowResizeListener onResize={handleResize} throttleDelay={throttleDelay}>
+            <div>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>
+                    throttleDelay: {throttleDelay}ms
+                </div>
+                <div style={{ border: "1px dashed rgb(125, 131, 138)", borderRadius: "4px", padding: "16px" }}>
+                    Срабатываний onResize: {resizeCount}
+                </div>
+            </div>
+        </WindowResizeListener>
+    );
+};
+
+export const ThrottleDelay = () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: "16px", maxWidth: "400px" }}>
+        <div>Измените размер окна браузера — чем больше задержка, тем реже вызывается обработчик.</div>
+        <ResizeCounter throttleDelay={100} />
+        <ResizeCounter throttleDelay={1000} />
+    </div>
+);
+```
+

package/bundle/guides/commits.md

@@ -203,6 +203,32 @@ fi
 - Действия в Linear выполняются от сессии разработчика — бот на них
   не распространяется.
 
+### Облачные сессии: подмена токена прокси
+
+В облачных сессиях (routines на claude.ai) запросы к `api.github.com`
+идут **не** с `TRIPLEX_BOT_GH_TOKEN`: egress-прокси подменяет авторизацию
+на токен GitHub App `claude` (user-to-server, identity — аккаунт
+разработчика). Паттерн выше при этом не ломается — просто действующие
+права определяет прокси, а не PAT. Как распознать:
+
+- `gh api user` возвращает аккаунт разработчика, хотя в env лежит токен
+  бота;
+- текст 403 — «Resource not accessible by **integration**» или «not
+  permitted for this session type / through this proxy» (у fine-grained
+  PAT было бы «…by personal access token»).
+
+Что прокси **разрешает** из облака: push в ветки, создание и мерж PR,
+комментарии, чтение Actions, диспатч нерелизных workflow (например,
+`visual-update.yml` — подтверждено прогонами). Что **запрещает** (зонд
+TRI-117, 2026-08-14): создание релизов, диспатч `release.yml`,
+`repository_dispatch`, создание, push и удаление тегов, удаление веток —
+блокируется публикация релизов любым маршрутом. Поэтому публикация релизов из
+облака невозможна — облачный прогон готовит релиз и передаёт публикацию
+человеку (см. `.agents/skills/release-auto/SKILL.md`). Диагностический
+зонд права на диспатч: POST на
+`actions/workflows/release.yml/dispatches` с несуществующим `ref` —
+`422 No ref found` означает «право есть», `403` — «нет».
+
 ---
 
 ## PR-воркфлоу

package/bundle/guides/stories.md

@@ -180,7 +180,7 @@ Playground показывает только те props, которые реал
 
 ### Когда не создавать Playground
 
-Если у компонента нет настраиваемых props (только `children` и стандартные HTML-атрибуты), Playground не создаётся — нечего класть в Controls. Типичный случай: контейнер-обёртка вроде `ListItem`, `ListItemControls`, `ChipGroup`.
+Если у компонента нет настраиваемых props (только `children` и стандартные HTML-атрибуты), Playground не создаётся — нечего класть в Controls. Типичный случай: контейнер-обёртка вроде `ListItem`, `ListItemControls`.
 
 В этом случае:
 

package/bundle/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "triplexVersion": "1.42.0",
-  "generatedAt": "2026-08-14T12:59:51.290Z",
+  "triplexVersion": "1.43.0",
+  "generatedAt": "2026-08-21T12:41:11.790Z",
   "components": [
     {
       "name": "AbstractTree",
@@ -138,7 +138,7 @@
     },
     {
       "name": "CheckboxTreeExtended",
-      "path": "src/components/CheckboxTreeExtended/CheckboxTreeExtended-AI.md",
+      "path": "src/components/CheckboxTreeExtended/CheckboxTreeExtended-ai.md",
       "file": "components/CheckboxTreeExtended.md",
       "ai_ready": true
     },
@@ -162,7 +162,7 @@
     },
     {
       "name": "ChipGroup",
-      "path": "src/components/ChipGroup/ChipGroup-AI.md",
+      "path": "src/components/ChipGroup/ChipGroup-ai.md",
       "file": "components/ChipGroup.md",
       "ai_ready": true
     },
@@ -608,7 +608,7 @@
     },
     {
       "name": "SliderExtended",
-      "path": "src/components/SliderExtended/SliderExtended-AI.md",
+      "path": "src/components/SliderExtended/SliderExtended-ai.md",
       "file": "components/SliderExtended.md",
       "ai_ready": true
     },
@@ -686,7 +686,7 @@
     },
     {
       "name": "TabsExtended",
-      "path": "src/components/TabsExtended/TabsExtended-AI.md",
+      "path": "src/components/TabsExtended/TabsExtended-ai.md",
       "file": "components/TabsExtended.md",
       "ai_ready": true
     },
@@ -777,10 +777,15 @@
     },
     {
       "name": "UnorderedList",
-      "path": "src/components/UnorderedList",
-      "file": null,
-      "ai_ready": false,
-      "storiesPath": "stories/UnorderedList.stories.tsx"
+      "path": "src/components/UnorderedList/UnorderedList-ai.md",
+      "file": "components/UnorderedList.md",
+      "ai_ready": true
+    },
+    {
+      "name": "UnorderedListExtended",
+      "path": "src/components/UnorderedListExtended/UnorderedListExtended-ai.md",
+      "file": "components/UnorderedListExtended.md",
+      "ai_ready": true
     },
     {
       "name": "UploadZone",
@@ -791,10 +796,9 @@
     },
     {
       "name": "WindowResizeListener",
-      "path": "src/components/WindowResizeListener",
-      "file": null,
-      "ai_ready": false,
-      "storiesPath": null
+      "path": "src/components/WindowResizeListener/WindowResizeListener-ai.md",
+      "file": "components/WindowResizeListener.md",
+      "ai_ready": true
     },
     {
       "name": "ListItemTable",
@@ -1052,6 +1056,11 @@
       "file": "release-notes/1.43.0.mdx",
       "path": "stories/release-notes/v1/1.43.0.mdx"
     },
+    {
+      "version": "1.44.0",
+      "file": "release-notes/1.44.0.mdx",
+      "path": "stories/release-notes/v1/1.44.0.mdx"
+    },
     {
       "version": "1.5.0",
       "file": "release-notes/1.5.0.mdx",

package/bundle/release-notes/1.43.0.mdx

@@ -4,4 +4,91 @@ import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
 
 <Title>v1.43.0</Title>
 
+<Heading>Новые компоненты</Heading>
+
+**UnorderedListExtended**
+
+- Расширенный маркированный список с типизированными элементами, пользовательскими маркерами, составным API и поддержкой `ref`.
+
+<Heading>Ломающие изменения</Heading>
+
+**Notification**
+
+- Body.List: Удалено свойство `values`, теперь элементы списка необходимо передавать через свойство `items`.
+
+**UnorderedList**
+
+- Компонент полностью переведен на data-driven подход и больше не принимает `children`, теперь элементы списка необходимо передавать через свойство `items`.
+
 <Heading>Изменения</Heading>
+
+**Button**
+
+- Исправлен баг, когда короткий текст в кнопке не центрировался.
+- Убраны горизонтальные отступы у `EButtonTheme.LINK`.
+
+**Checkbox**
+
+- Проведён AI-рефакторинг.
+- Исправлен баг, когда на тач-устройствах чекбокс залипал в состоянии ховера после тапа.
+
+**CheckboxTreeExtended**
+
+- Добавлено: экспортируется тип `ICheckboxTreeExtendedNodeProps` — теперь свойства `CheckboxTreeExtended.Node` можно использовать для типизации собственной обёртки узла.
+- Исправлено: `className`, переданный в `CheckboxTreeExtended.Node`, больше не затирает собственный класс узла. Раньше вместе с ним пропадали отступы вложенной ветки — теперь классы объединяются.
+- Проведён AI-рефакторинг, добавлен `displayName` у `CheckboxTreeExtended.Node`. Из разметки заголовка узла пропал глобальный класс `opened` — внешний вид не изменился.
+
+**CheckboxXGroup**
+
+- Проведён AI-рефакторинг.
+
+**CheckboxYGroup**
+
+- Проведён AI-рефакторинг.
+
+**Chip**
+
+- Изменен цвет токена `Chip.Background_Disabled` в темной теме.
+
+**ChipGroup**
+
+- Проведён AI-рефакторинг.
+
+**LightBox**
+
+- Исправлен баг, когда в состоянии `loading` `LightBox.TopOverlay` перекрывался `LoaderScreen`.
+
+**SliderExtended**
+
+- Добавлено: `SliderExtended` и его части (`Dot`, `Mark`, `Marks`, `Rail`, `Track`, `Tooltip`) пробрасывают `ref` на свой корневой элемент — тот же, что получает `className` и `...rest` (у `Tooltip` — обёртка подсказки).
+- Исправлено: `className`, переданный в `SliderExtended` и `SliderExtended.Tooltip`, больше не затирает собственные классы элемента — раньше вместе с пользовательским классом пропадали размер и оформление. Затрагивает также `className` у `Slider` и `SliderRange`: он уходит на корневой элемент `SliderExtended`.
+- Исправлено: `style`, переданный в `SliderExtended.Dot`, `SliderExtended.Track` и `SliderExtended.Mark`, больше не отбрасывается. Внутреннее позиционирование (`left`, `right`) по-прежнему приоритетно.
+- Исправлено: `onClick`, переданный в `SliderExtended.Rail`, больше не отменяет перемещение ползунка по клику на полосу — вызываются оба обработчика.
+- Изменено: слайдер отрисовывается сразу на первом рендере. Раньше шаги вычислялись в layout-эффекте, и первый кадр был пустым.
+- Исправлено: если во время перетаскивания курсор уходил далеко за пределы полосы, ползунок прыгал в её противоположный конец. Теперь он остаётся на крайнем шаге.
+- Исправлено: клик по полосе или по метке, когда ни один `SliderExtended.Dot` не отрисован, больше не выбрасывает исключение.
+- Исправлено: при `min`, равном `max`, позиция ползунка больше не вычисляется как `NaN`.
+- Добавлено: `displayName` у `SliderExtended.Tooltip`.
+- Проведён AI-рефакторинг.
+
+**StatusTracker**
+
+- Минимальная высота изменена для десктоп экранов и добавлена для мобильных экранов.
+
+**TabsExtended**
+
+- Добавлено: `TabsExtended`, `TabsExtended.Content`, `TabsExtended.Content.TabsWrapper` и `TabsExtended.Content.DropdownWrapper` пробрасывают `ref` — раньше они были объявлены как `React.FC`. Ref указывает на тот же элемент, что получает `className` и `...rest`: у `TabsWrapper` это отображаемый контейнер табов, у `DropdownWrapper` — контейнер выпадающего списка.
+- Исправлено: в `dropdownItemsIds` больше не попадают `null`. Дочерний элемент `TabsWrapper` без атрибута таба — например, `TabButton`, положенный напрямую, без `Tab`, — при нехватке ширины уезжал в render-prop `DropdownWrapper` как `null` и в одиночку раскрывал пустой Dropdown.
+- Проведён AI-рефакторинг, добавлен `displayName`.
+
+**UnorderedList**
+
+- Элементы списка теперь поддерживают свойства `TTextProps` для гибкого управления стилями и параметрами текста.
+- Для элементов списка добавлено свойство `marker` для кастомного отображения иконок и произвольных маркеров.
+- Исправлено: маркер элемента центрируется по первой строке текста при любом размере типографики. Раньше вертикальные отступы маркера были рассчитаны на строку 20px (`B2`/`B3`), из-за чего на `B1` маркер смещался на 2px вверх, а на `B4` — на 2px вниз, и элемент `B4` занимал лишние 4px по высоте. Правка сделана в `UnorderedListExtended` и затрагивает оба списка.
+- Проведён AI-рефакторинг. Публичный API и разметка не изменились.
+
+**WindowResizeListener**
+
+- Добавлено: интерфейс `IWindowResizeListenerProps` теперь экспортируется.
+- Проведён AI-рефакторинг.

package/bundle/release-notes/1.44.0.mdx

@@ -0,0 +1,7 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.44.0" />
+
+<Title>v1.44.0</Title>
+
+<Heading>Изменения</Heading>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sberbusiness/triplex-next-mcp-server",
-  "version": "1.42.0-beta",
+  "version": "1.43.0-beta",
   "description": "MCP-сервер для дизайн-системы Triplex. Предоставляет AI-агентам документацию компонентов, дизайн-токены и примеры использования.",
   "author": "СберБизнес",
   "license": "MIT",