@sberbusiness/triplex-next-mcp-server 1.50.0-beta → 1.53.1

package/bundle/components/SmartSpot.md

@@ -0,0 +1,259 @@
+---
+component: SmartSpot
+category: SmartSpot
+related: []
+tokens:
+  - SmartSpot.Success_Spot1_Color
+  - SmartSpot.Success_Spot2_Color
+  - SmartSpot.Success_Spot3_Color
+  - SmartSpot.Success_Spot4_Color
+  - SmartSpot.Warning_Spot1_Color
+  - SmartSpot.Warning_Spot2_Color
+  - SmartSpot.Warning_Spot3_Color
+  - SmartSpot.Warning_Spot4_Color
+  - SmartSpot.Error_Spot1_Color
+  - SmartSpot.Error_Spot2_Color
+  - SmartSpot.Error_Spot3_Color
+  - SmartSpot.Error_Spot4_Color
+  - SmartSpot.Waiting_Spot1_Color
+  - SmartSpot.Waiting_Spot2_Color
+  - SmartSpot.Waiting_Spot3_Color
+  - SmartSpot.Waiting_Spot4_Color
+stories: stories/SmartSpot/SmartSpot.stories.tsx
+version: "1.0"
+---
+
+# SmartSpot
+
+## Назначение
+
+Декоративная анимированная подложка статуса. Рисует на прозрачном фоне четыре пятна в цветах статуса; сплошной заливки у компонента нет — фон под пятнами задаёт родитель. Слой пятен размыт гауссом (`filter: blur()`) и медленно двигается по выбранному пресету. Компонент заполняет родителя (`width/height: 100%`, `overflow: hidden`), а `children` выводит поверх подложки.
+
+Используй когда: нужен выразительный фон для экрана или карточки с результатом операции — успех, предупреждение, ошибка, ожидание. Например, итоговый экран платежа или промо-блок со статусом.
+
+Не используй когда:
+
+- Нужен компактный индикатор статуса — возьми `Marker`, `MarkerStatus` или `Badge`.
+- Нужно сообщение, которое читает пользователь, — используй `AlertProcess` или `AlertContext`. SmartSpot ничего не сообщает сам: это только фон.
+- Нужна обычная статичная заливка — задай `background` контейнеру. SmartSpot тратит ресурсы на `filter: blur()` большого радиуса и rAF-анимацию.
+
+---
+
+## Варианты и props
+
+### Обязательные props
+
+| Prop   | Тип              | Описание                                |
+| ------ | ---------------- | --------------------------------------- |
+| `type` | `ESmartSpotType` | Тип: задаёт цвета пятен и их геометрию. |
+
+### Опциональные props
+
+| Prop        | Тип                   | По умолчанию | Описание                                                                                                              |
+| ----------- | --------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------- |
+| `animation` | `ESmartSpotAnimation` | `DRIFT`      | Пресет анимации.                                                                                                      |
+| `blur`      | `number`              | `60`         | Радиус размытия слоя пятен в CSS px, передаётся в `filter: blur()` как есть.                                          |
+| `distance`  | `number`              | `50`         | Радиус эллипса движения по горизонтали, px. Вертикальный радиус — половина горизонтального. Влияет только на `DRIFT`. |
+| `duration`  | `number`              | `6000`       | Длительность одного цикла, мс. Для `NONE` игнорируется.                                                               |
+| `shape`     | `ESmartSpotShape`     | `CIRCLE`     | Форма пятен.                                                                                                          |
+
+Компонент расширяет `React.HTMLAttributes<HTMLDivElement>`: `className`, `style`, `aria-*`, `data-*` и остальные атрибуты уходят на корневой `<div>`. Переданный `style` сливается с inline-переменной размытия.
+
+### Значения enum'ов
+
+- `ESmartSpotType`: `SUCCESS` (`"success"`), `WARNING` (`"warning"`), `ERROR` (`"error"`), `WAITING` (`"waiting"`, системный статус ожидания).
+- `ESmartSpotAnimation`:
+    - `DRIFT` (`"drift"`) — весь слой пятен движется по эллипсу против часовой стрелки;
+    - `BREATHING` (`"breathing"`) — каждое пятно пульсирует масштабом 0.9 → 1.1 → 0.9 за цикл, слой стоит на месте;
+    - `NONE` (`"none"`) — один статичный кадр без `requestAnimationFrame`.
+- `ESmartSpotShape`: `CIRCLE` (`"circle"`), `OVAL` (`"oval"`, высота 60% от диаметра), `SQUARE` (`"square"`), `TRIANGLE` (`"triangle"`, через `clip-path`).
+
+### Ограничения
+
+- **Собственного размера нет.** Размер и скругление задаёт обёртка. Без высоты у родителя подложка схлопнется.
+- **Геометрия пятен фиксирована** в абсолютных px от центра верхней грани (приватный `SPOTS_BY_TYPE` в `consts.ts`). На контейнерах сильно меньше или больше макета (~240px) видимая картинка меняется. Пятна не масштабируются под размер контейнера.
+- **Смена `distance` и `duration` не перезапускает анимацию.** Значения читаются в каждом кадре через `useLatestRef`. Прогресс цикла накапливается, поэтому при смене `duration` движение продолжается с текущей точки. Смена `animation` перезапускает rAF с начала цикла.
+- Кадр пишется напрямую в `style` слоя `.move` (runtime-переменные `--triplex-next-runtime-SmartSpot-Move_X`, `Move_Y`, `Spot_Scale`), ререндеров на каждом кадре нет.
+- `children` оборачиваются в `div.content` (`position: relative`, 100% × 100%) только если значение truthy. Числовой `0` попадёт прямо в корень без обёртки.
+
+---
+
+## Дизайн-токены
+
+Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` → «Как переопределять токены». Значения по умолчанию — `src/components/DesignTokens/components/SmartSpot.ts`.
+
+Группа `SmartSpot`: по токену на каждое пятно каждого типа (`{Type}_Spot{N}_Color`, N = 1…4). Значения ссылаются на core-палитру; в тёмной теме сейчас те же ссылки, что и в светлой — тёмные значения согласуются с дизайнером.
+
+```text
+SmartSpot.Success_Spot1_Color   — ColorSuccess.80
+SmartSpot.Success_Spot2_Color   — ColorSuccess.50
+SmartSpot.Success_Spot3_Color   — ColorBrand.60
+SmartSpot.Success_Spot4_Color   — ColorSuccess.80
+SmartSpot.Warning_Spot1_Color   — ColorWarning.30
+SmartSpot.Warning_Spot2_Color   — ColorWarning.70
+SmartSpot.Warning_Spot3_Color   — ColorWarning.50
+SmartSpot.Warning_Spot4_Color   — ColorWarning.80
+SmartSpot.Error_Spot1_Color     — ColorWarning.30
+SmartSpot.Error_Spot2_Color     — ColorWarning.30
+SmartSpot.Error_Spot3_Color     — ColorWarning.50
+SmartSpot.Error_Spot4_Color     — ColorError.70
+SmartSpot.Waiting_Spot1_Color   — ColorSystem.100
+SmartSpot.Waiting_Spot2_Color   — ColorSystem.60
+SmartSpot.Waiting_Spot3_Color   — ColorSystem.90
+SmartSpot.Waiting_Spot4_Color   — ColorSystem.90
+```
+
+Цвет пятна привязан к его порядковому номеру: `.spot:nth-child(N)` соответствует N-му элементу `SPOTS_BY_TYPE[type]` и токену `{Type}_Spot{N}_Color`.
+
+Runtime-переменные (не токены, выставляются компонентом):
+
+- `--triplex-next-runtime-SmartSpot-Blur_Sigma` — на корне;
+- `Spot_X`, `Spot_Y`, `Spot_Size`, `Spot_Opacity` — на каждом пятне;
+- `Move_X`, `Move_Y`, `Spot_Scale` — на слое `.move`.
+
+---
+
+## Инварианты
+
+- **`forwardRef`** обязателен. `ref` указывает на корневой `<div>`.
+- **Имена публичного API**: `SmartSpot`, `ISmartSpotProps`, props (`type`, `animation`, `blur`, `distance`, `duration`, `shape`), enum'ы `ESmartSpotType`, `ESmartSpotAnimation`, `ESmartSpotShape` и их строковые значения. Значения enum'ов используются как имена CSS-классов (`styles[type]`, `styles[shape]`), поэтому переименование значения ломает стили.
+- **Barrel** `src/components/SmartSpot/index.ts` экспортирует `./SmartSpot` и `./enums`. `consts.ts` и `utils.ts` приватные. Компонент подключён в `src/components/index.ts`.
+- **Дефолты**: `animation = DRIFT`, `blur = 60`, `shape = CIRCLE`. Смена дефолта меняет вид у всех потребителей.
+- **Ровно четыре пятна на тип.** Число пятен и их порядок в `SPOTS_BY_TYPE` связаны с `nth-child`-правилами в LESS. Добавление пятна требует правок в обоих местах и новых токенов в `SmartSpot.ts`.
+- **Фон прозрачный**: корень не задаёт `background`, под пятнами виден родитель.
+- **Слой пятен `aria-hidden="true"`** — проверяется тестом.
+- **`displayName = "SmartSpot"`**.
+- **Visual regression не покрыт.** Анимированные stories исключены из test-runner'а (`testRunner: { skip: true }`): test-runner ждёт стабилизации DOM, а rAF пишет в `style` каждый кадр.
+
+---
+
+## Accessibility
+
+Компонент не интерактивный и декоративный. Слой пятен скрыт от скринридеров через `aria-hidden="true"`. Корень и `children` остаются в дереве доступности. Смысл статуса потребитель передаёт текстом в `children` (заголовок, описание): цвет подложки сам по себе не должен быть единственным носителем информации.
+
+Ограничение: анимация не учитывает `prefers-reduced-motion`. Если это важно, передай `animation={ESmartSpotAnimation.NONE}` по медиа-запросу на стороне потребителя.
+
+---
+
+## Связанные компоненты
+
+Семейства, альтернатив и контрактов по рендеру или типам нет, поэтому `related` пуст. Для компактной индикации статуса используй `Marker`, `MarkerStatus`, `Badge` (см. «Не используй когда»).
+
+---
+
+## Stories
+
+Основные истории: `stories/SmartSpot/SmartSpot.stories.tsx`
+Файлы примеров: `stories/SmartSpot/examples/`
+
+| Story        | Example file     | Что демонстрирует                                     |
+| ------------ | ---------------- | ----------------------------------------------------- |
+| `Playground` | `Playground.tsx` | Интерактивный контроль всех props                     |
+| `Default`    | `Default.tsx`    | Подложка с типом `SUCCESS` и настройками по умолчанию |
+| `Types`      | `Types.tsx`      | Все четыре типа                                       |
+| `Shapes`     | `Shapes.tsx`     | Все четыре формы пятен                                |
+| `Animations` | `Animations.tsx` | Пресеты `DRIFT`, `BREATHING`, `NONE`                  |
+
+---
+
+## История изменений
+
+| Дата       | Изменение                                                                                                                                                                                                                                                                                                            |
+| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 2026-10-23 | Геометрия пятен (`SPOTS_BY_TYPE`) уменьшена вдвое под контейнеры вроде StatusTracker, `blur` по умолчанию снижен с 200 до 60 px, длительность цикла пресетов Drift и Breathing — с 8000 до 6000 мс. Prop `status` переименован в `type`, enum `ESmartSpotStatus` — в `ESmartSpotType`, story `Statuses` — в `Types`. |
+| 2026-10-22 | Цвета пятен вынесены в компонентную группу токенов `SmartSpot` (`{Type}_Spot{N}_Color`), `background` пятна берётся из токена напрямую.                                                                                                                                                                              |
+| 2026-10-22 | Создан документ. Новый компонент (v1.52.0): AI-рефакторинг (`useLatestRef` вместо записи в ref во время рендера, `ref={ref}` вместо callback-ref, защита от отрицательного шага rAF), unit-тесты на компонент и утилиты, stories по modern pattern.                                                                  |
+
+---
+
+## Примеры использования
+
+### Default
+
+`stories/SmartSpot/examples/Default.tsx`
+
+```tsx
+import React from "react";
+import { SmartSpot, ESmartSpotType } from "@sberbusiness/triplex-next";
+
+export const Default = () => (
+    <div style={{ width: 520, height: 300, borderRadius: 16, overflow: "hidden" }}>
+        <SmartSpot type={ESmartSpotType.SUCCESS} />
+    </div>
+);
+```
+
+### Types
+
+`stories/SmartSpot/examples/Types.tsx`
+
+```tsx
+import React from "react";
+import { SmartSpot, ESmartSpotType } from "@sberbusiness/triplex-next";
+
+const TYPES = Object.values(ESmartSpotType);
+
+export const Types = () => (
+    <div style={{ display: "flex", flexWrap: "wrap", gap: 24 }}>
+        {TYPES.map((type) => (
+            <div key={type}>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>{type.toUpperCase()}</div>
+                <div style={{ width: 240, height: 240, borderRadius: 16, overflow: "hidden" }}>
+                    <SmartSpot type={type} />
+                </div>
+            </div>
+        ))}
+    </div>
+);
+```
+
+### Shapes
+
+`stories/SmartSpot/examples/Shapes.tsx`
+
+```tsx
+import React from "react";
+import { SmartSpot, ESmartSpotShape, ESmartSpotType } from "@sberbusiness/triplex-next";
+
+const SHAPES = Object.values(ESmartSpotShape);
+
+export const Shapes = () => (
+    <div style={{ display: "flex", flexWrap: "wrap", gap: 24 }}>
+        {SHAPES.map((shape) => (
+            <div key={shape}>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>{shape.toUpperCase()}</div>
+                <div style={{ width: 240, height: 240, borderRadius: 16, overflow: "hidden" }}>
+                    <SmartSpot type={ESmartSpotType.SUCCESS} shape={shape} />
+                </div>
+            </div>
+        ))}
+    </div>
+);
+```
+
+### Animations
+
+`stories/SmartSpot/examples/Animations.tsx`
+
+```tsx
+import React from "react";
+import { SmartSpot, ESmartSpotAnimation, ESmartSpotType } from "@sberbusiness/triplex-next";
+
+const ANIMATIONS = Object.values(ESmartSpotAnimation);
+
+export const Animations = () => (
+    <div style={{ display: "flex", flexWrap: "wrap", gap: 24 }}>
+        {ANIMATIONS.map((animation) => (
+            <div key={animation}>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>
+                    {animation.toUpperCase()}
+                </div>
+                <div style={{ width: 240, height: 240, borderRadius: 16, overflow: "hidden" }}>
+                    <SmartSpot type={ESmartSpotType.WARNING} animation={animation} />
+                </div>
+            </div>
+        ))}
+    </div>
+);
+```
+

package/bundle/components/Step.md

@@ -169,7 +169,7 @@ Step.Color_Disabled
   `size={ETooltipSize.SM}` и `toggleType="hover"`, а из props потребителя прокидывает
   только выравнивание указателя (`alignTip`) — остальное настроить нельзя. `disableAdaptiveMode`
   не передаётся, поэтому на экранах до `SM_MAX` включительно подсказка открывается
-  в адаптивном (полноэкранном) режиме.
+  в адаптивном режиме — нижней шторкой `Puller`.
 - `Text` — рендерит номер шага (`ETextSize.B1`, `EFontWeightText.SEMIBOLD`). Цвет номера
   задаётся снаружи, селектором `& > span` в стилях `Step`.
 - `IslandAccordion` — потребитель: нумерует секции аккордеона, передавая `Step` номер,
@@ -207,6 +207,7 @@ Story ID участвуют в именах baseline-скриншотов (`step
 | Дата | Изменение |
 |---|---|
 | 2026-09-24 | Создан документ. AI-рефакторинг: `Step` переведён с `React.FC` на `forwardRef` (внешний ref мерджится с внутренним, который уходит в `Tooltip` как `targetRef`), JSDoc на компоненте и дефолтах props, `renderContent()` заменён на вычисляемый один раз элемент, приведён к порядку LESS. Добавлены unit-тесты (`__tests__/Step.test.tsx`), stories созданы по modern pattern (`stories/Step/`). |
+| 2026-10-21 | Переход на `Puller` (TRIPLEX-961): адаптивный режим `Tooltip` — нижняя шторка `Puller`. |
 
 ---
 

package/bundle/components/Stepper.md

@@ -147,7 +147,7 @@ Stepper.Step_Color_Disabled
 ## Stories
 
 Основные истории: `stories/Stepper/Stepper.stories.tsx`
-Файлы примеров: `stories/Stepper/examples/`
+Файлы примеров: `stories/Stepper/examples/Stepper/`
 
 | Story | Example file | Что демонстрирует |
 |---|---|---|
@@ -158,7 +158,6 @@ Stepper.Step_Color_Disabled
 | `WithIcons` | `WithIcons.tsx` | Все значения `EStepperStepIconType` на шагах |
 | `ManySteps` | `ManySteps.tsx` | Шаги не помещаются в контейнер и прокручиваются |
 | `VisualTests` | `VisualTests.tsx` | Размеры × состояния, отключённый шаг, типы, `:focus-visible` на шаге (через `play`) |
-| `StepperExtendedType` | — | Стори базового `StepperExtended`; живёт в этом файле до отдельной задачи по `StepperExtended` |
 
 ---
 
@@ -169,6 +168,7 @@ Stepper.Step_Color_Disabled
 | 2026-09-24 | Создан документ AI-ready для `Stepper` (TRI-84). |
 | 2026-09-24 | AI-рефакторинг: подводка шага и кнопки прокрутки вынесены в чистые функции и отдельный компонент модульного уровня, величина прокрутки хранится одним числом вместо объекта, ссылки на узлы удалённых шагов больше не удерживаются, JSDoc проставлен на публичных полях `steps` и `size`. Публичный API (имена props, значения enum, barrel-экспорты) и разметка не изменились. Добавлены unit-тесты на состояния шагов, типы, клавиатуру, `forwardedRef`, `...rest` и подводку шага в видимую область; stories переписаны по modern pattern. |
 | 2026-09-25 | Размер по умолчанию изменён с `LG` на `MD` по решению ревью — вместе со `StepperExtended`, чтобы компоненты не разъехались. Изменение наблюдаемое: без явного `size` шаги и кнопки прокрутки становятся меньше, описано в release notes 1.48.0. |
+| 2026-10-19 | Примеры перенесены в `stories/Stepper/examples/Stepper/`, отдельно от `StepperExtended`; путь обновлён, удалена устаревшая запись о несуществующей story `StepperExtendedType`. |
 
 ---
 
@@ -176,7 +176,7 @@ Stepper.Step_Color_Disabled
 
 ### Default
 
-`stories/Stepper/examples/Default.tsx`
+`stories/Stepper/examples/Stepper/Default.tsx`
 
 ```tsx
 import React, { useState } from "react";
@@ -210,7 +210,7 @@ export const Default = () => {
 
 ### Sizes
 
-`stories/Stepper/examples/Sizes.tsx`
+`stories/Stepper/examples/Stepper/Sizes.tsx`
 
 ```tsx
 import React, { useState } from "react";
@@ -269,7 +269,7 @@ export const Sizes = () => (
 
 ### Types
 
-`stories/Stepper/examples/Types.tsx`
+`stories/Stepper/examples/Stepper/Types.tsx`
 
 ```tsx
 import React, { useState } from "react";
@@ -334,7 +334,7 @@ export const Types = () => (
 
 ### WithIcons
 
-`stories/Stepper/examples/WithIcons.tsx`
+`stories/Stepper/examples/Stepper/WithIcons.tsx`
 
 ```tsx
 import React, { useState } from "react";
@@ -382,7 +382,7 @@ export const WithIcons = () => {
 
 ### ManySteps
 
-`stories/Stepper/examples/ManySteps.tsx`
+`stories/Stepper/examples/Stepper/ManySteps.tsx`
 
 ```tsx
 import React, { useState } from "react";

package/bundle/components/Suggest.md

@@ -1,7 +1,7 @@
 ---
 component: Suggest
 category: Suggest
-related: [SuggestField, Chip, Dropdown]
+related: [SuggestField, Chip, Puller, Dropdown]
 tokens: []
 stories: stories/Suggest/Suggest.stories.tsx
 version: "1.0"
@@ -145,11 +145,11 @@ Headless-основа выпадающего списка с фильтраци
 - `Chip` — родитель `ChipSuggest`, единственного компонента библиотеки, собранного на
   `Suggest`. `ChipSuggest` опирается не только на barrel, но и на внутренний
   `SuggestMobileDropdownContent`.
-- `Dropdown` — мобильное наполнение Suggest рендерится из его частей
-  (`DropdownMobileHeader`, `DropdownMobileInput`, `DropdownMobileList`, …); в десктопной
-  композиции `Dropdown` обычно и служит выпадающим списком.
-- `SuggestMobileDropdownContent` — внутреннее наполнение полноэкранного мобильного
-  дропдауна: поле ввода, список опций, лоадер и текст при пустом списке. Данные берёт из
+- `Puller` — мобильное наполнение Suggest рендерится из его частей
+  (`PullerHeader`, `PullerInput`, `PullerList`, …).
+- `Dropdown` — в десктопной композиции обычно служит выпадающим списком.
+- `SuggestMobileDropdownContent` — внутреннее наполнение мобильного дропдауна (шторки
+  `Puller`): поле ввода, список опций, лоадер и текст при пустом списке. Данные берёт из
   `SuggestContext`, поэтому рендерится только внутри `Suggest`. Отдельного AI.md не имеет,
   из barrel не экспортируется.
 
@@ -184,6 +184,7 @@ Suggest headless: собственной разметки он не рендер
 | Дата | Изменение |
 |---|---|
 | 2026-09-02 | Создан документ |
+| 2026-10-21 | **Breaking** (TRIPLEX-961): prop `mobileViewProps`, унаследованный `ISuggestDropdownProps` от `Dropdown`, переименован в `pullerProps`. Мобильное наполнение собрано из частей нижней шторки `Puller` (бывший `DropdownMobile*`). |
 
 ---
 

package/bundle/components/SuggestField.md

@@ -1,7 +1,7 @@
 ---
 component: SuggestField
 category: TextFields
-related: [Suggest, SelectField, MultiselectField, SelectExtendedField, TextField, FormField, Dropdown, LoaderSmall]
+related: [Suggest, SelectField, MultiselectField, SelectExtendedField, TextField, FormField, Dropdown, Puller, LoaderSmall]
 tokens: []
 stories: stories/SuggestField/SuggestField.stories.tsx
 version: "1.0"
@@ -17,7 +17,7 @@ version: "1.0"
 возвращает новый `options`.
 
 Адаптивный: на ширине экрана < 768px вместо десктопного поля с выпадающим списком рендерится
-мобильный вариант — поле только для чтения, по фокусу открывающее полноэкранный дропдаун с
+мобильный вариант — поле только для чтения, по фокусу открывающее нижнюю шторку `Puller` с
 собственным полем ввода. Переключение делает `MobileView`, потребителю ничего делать не нужно.
 
 Используй когда: нужно поле с подсказками-опциями — поиск контрагента, счёта, адреса, в том
@@ -101,7 +101,7 @@ version: "1.0"
 
 ### Поведение мобильного варианта
 
-Поле-триггер — `readOnly`, по фокусу открывается полноэкранный `Dropdown` с собственным полем
+Поле-триггер — `readOnly`, по фокусу открывается `Dropdown` в виде шторки `Puller` с собственным полем
 ввода (автофокус). При `tooltipOpen` вместо списка показывается `SuggestFieldMobileDropdownHint`
 с текстом `tooltipHint`. Закрытие дропдауна без выбора опции значение не сбрасывает, даже при
 пустом поле ввода: на закрытии поле ввода дропдауна возвращается к `label` текущего `value`
@@ -205,8 +205,9 @@ version: "1.0"
 - `FormField` — источник `FormFieldInput` (поле ввода и `SuggestField.Input`), `FormFieldClear`
   (кнопка очистки) и статусов `EFormFieldStatus`.
 - `Dropdown` — выпадающий список: `DropdownDesktop` + `DropdownList` + `DropdownListItem` на
-  десктопе, `DropdownMobile*` в полноэкранном мобильном варианте. `ISuggestFieldDesktopDropdownProps`
-  наследует `IDropdownDesktopProps`.
+  десктопе. `ISuggestFieldDesktopDropdownProps` наследует `IDropdownDesktopProps`.
+- `Puller` — нижняя шторка мобильного варианта (`PullerHeader`, `PullerInput`, `PullerList`, …).
+  `ISuggestFieldMobileDropdownProps` наследует `Omit<IPullerProps, "onSelect">`.
 - `LoaderSmall` — индикатор подгрузки подсказок: `SuggestFieldDesktop` и `SuggestFieldMobile`
   показывают его с темой `BRAND`, пока `loading`.
 - `Tooltip` — подсказка `tooltipHint` у десктопного поля. В `related` не вынесен: связь узкая,
@@ -248,6 +249,7 @@ version: "1.0"
 | 2026-09-23 | Создан документ |
 | 2026-09-29 | Аудит симметрии `related` (TRI-156): добавлены обратные ссылки (`MultiselectField`, `SelectExtendedField`) и контракт по рендеру `LoaderSmall`. Публичный API и поведение не затронуты. |
 | 2026-10-02 | Сброс значения только кнопкой очистки на обеих платформах: при `clearInputOnFocus` значение терялось от фокуса без выбора. Blur на десктопе и закрытие дропдауна на мобильном больше не вызывают `onSelect(undefined)`; мобильная кнопка очистки сама зовёт `onSelect(undefined)` и `onFilter("")` (последний — при непустом `label`), как десктопная; на закрытии мобильного дропдауна его поле ввода возвращается к `label`. `SuggestField` отдаёт мобильному варианту все props, как десктопному: на мобильной ширине больше не теряются `className`, `id`, `data-test-id`, `active` и `renderInput`. Обновлены `onSelect`, поведение обеих платформ и «Инварианты» |
+| 2026-10-21 | Переход на `Puller` (TRIPLEX-961): мобильный вариант собран из частей нижней шторки `Puller` (бывший `DropdownMobile*`). |
 
 ---
 
@@ -759,7 +761,7 @@ export const ProductionExample = () => {
     };
 
     const handleClear: React.MouseEventHandler<HTMLButtonElement> = () => {
-        // На мобильном фокус открыл бы полноэкранный дропдаун сразу после очистки.
+        // На мобильном фокус открыл бы мобильный дропдаун сразу после очистки.
         if (!adaptive) {
             inputRef.current?.focus();
         }

package/bundle/components/TableBasic.md

@@ -1773,11 +1773,11 @@ import {
     ChipGroup,
     ChipMultiselect,
     Col,
-    DropdownMobileBody,
-    DropdownMobileClose,
-    DropdownMobileFooter,
-    DropdownMobileHeader,
-    DropdownMobileInput,
+    PullerBody,
+    PullerClose,
+    PullerFooter,
+    PullerHeader,
+    PullerInput,
     EButtonTheme,
     EComponentSize,
     EDropdownAlignment,
@@ -2100,21 +2100,19 @@ export const ExampleProduction = () => {
                     ref={dropdownRef}
                     alignment={EDropdownAlignment.LEFT}
                     focusTrapProps={{ focusTrapOptions: { initialFocus: false } }}
-                    mobileViewProps={{
+                    pullerProps={{
                         children: (
                             <>
-                                <DropdownMobileHeader
-                                    controlButtons={<DropdownMobileClose onClick={() => setOpened(false)} />}
-                                >
-                                    <DropdownMobileInput
+                                <PullerHeader controlButtons={<PullerClose onClick={() => setOpened(false)} />}>
+                                    <PullerInput
                                         autoFocus
                                         placeholder="Поиск по статусу"
                                         value={statusFilter}
                                         onChange={handleStatusFilterChange}
                                     />
-                                </DropdownMobileHeader>
-                                <DropdownMobileBody>{renderStatusDropdownContent()}</DropdownMobileBody>
-                                <DropdownMobileFooter>
+                                </PullerHeader>
+                                <PullerBody>{renderStatusDropdownContent()}</PullerBody>
+                                <PullerFooter>
                                     <Button
                                         theme={EButtonTheme.GENERAL}
                                         size={EComponentSize.SM}
@@ -2129,7 +2127,7 @@ export const ExampleProduction = () => {
                                     >
                                         Сбросить
                                     </Button>
-                                </DropdownMobileFooter>
+                                </PullerFooter>
                             </>
                         ),
                     }}

package/bundle/components/Tooltip.md

@@ -1,7 +1,7 @@
 ---
 component: Tooltip
 category: Tooltip
-related: [HelpBox, Dropdown, Portal, MobileView, ThemeProvider, ButtonIcon]
+related: [HelpBox, Puller, Portal, MobileView, ThemeProvider, ButtonIcon]
 tokens:
   - Tooltip.Background
   - Tooltip.Color
@@ -21,7 +21,7 @@ version: "1.0"
 
 ## Назначение
 
-Всплывающая подсказка, привязанная к целевому элементу. Рендерится через `Portal` — по умолчанию в `document.body`, либо в контейнер из `renderContainer` — и позиционируется относительно `targetRef`. На мобильной ширине экрана (<768px) вместо всплывающей подсказки открывается полноэкранный оверлей снизу на базе `DropdownMobile`.
+Всплывающая подсказка, привязанная к целевому элементу. Рендерится через `Portal` — по умолчанию в `document.body`, либо в контейнер из `renderContainer` — и позиционируется относительно `targetRef`. На мобильной ширине экрана (<768px) вместо всплывающей подсказки открывается нижняя шторка `Puller`.
 
 Используй когда: нужно пояснить элемент интерфейса коротким текстом, при необходимости со ссылкой на подробное описание.
 Не используй когда:
@@ -101,14 +101,14 @@ Tooltip.Link_Mobile_Color_Active
 Tooltip.Link_Mobile_Shadow_Focus
 ```
 
-Мобильная версия дополнительно наследует токены группы `DropdownMobile`, так как построена на его субкомпонентах.
+Мобильная версия дополнительно наследует токены группы `Puller`, так как построена на его субкомпонентах.
 
 ---
 
 ## Инварианты
 
-- Публичный barrel `src/components/Tooltip/index.ts` реэкспортирует `Tooltip`, `enums` и `types` целиком. Компонент используется внутри `HelpBox`, `SMSField.Tooltip` и косвенно (через типы) в `Dropdown`, поэтому удаление любого экспорта ломает библиотеку изнутри.
-- `IDropdownMobileHeaderProps` объявлен **в `src/components/Tooltip/types.ts`**, но используется `DropdownMobileHeader` из семейства `Dropdown`. Переносить тип нельзя без синхронной правки `Dropdown` (и это breaking change для deep-импортов).
+- Публичный barrel `src/components/Tooltip/index.ts` реэкспортирует `Tooltip`, `enums` и `types` целиком. Компонент используется внутри `HelpBox` и `SMSField.Tooltip`, поэтому удаление любого экспорта ломает библиотеку изнутри.
+- `ITooltipMobileHeaderProps` расширяет `IPullerHeaderProps` из `src/components/Puller/PullerHeader.tsx`: props шапки мобильной версии — это props `PullerHeader`.
 - Файл контекста называется `TootlipContext.ts` — опечатка в имени зафиксирована в публикуемых путях подпакета; переименование ломает deep-импорты потребителей.
 - `Tooltip` — `React.FC` со статическими субкомпонентами (`Tooltip.Target` и т.д.). Набор статических свойств — часть публичного API.
 - Разбор `children` по типу элемента (`child.type === TooltipTarget`) означает, что обёртка субкомпонента в собственный компонент-прокси **не сработает** — узел просто не попадёт ни в один слот. Это осознанное ограничение, на нём построен весь состав.
@@ -128,7 +128,7 @@ Tooltip.Link_Mobile_Shadow_Focus
 - Закрытие также срабатывает по `mousedown` вне подсказки и вне целевого элемента.
 - Открытие по наведению: подсказка закрывается не сразу после ухода курсора, а через 500мс — за это время курсор можно довести до самой подсказки (её нода тоже слушает `mouseenter`/`mouseleave`).
 - Фокус компонент не перехватывает и не возвращает: при открытии фокус остаётся на целевом элементе. Поэтому интерактивное содержимое сложнее `Tooltip.Link` в подсказку класть не стоит.
-- Мобильная версия — оверлей `DropdownMobile`; кнопке закрытия `aria-label` задаёт потребитель через props `Tooltip.XButton`. Кнопка там рендерится всегда, поэтому без `Tooltip.XButton` она остаётся без доступного имени — в адаптивном сценарии `Tooltip.XButton` с `aria-label` стоит передавать, даже если на десктопе крестик не нужен.
+- Мобильная версия — оверлей `Puller`; кнопке закрытия `aria-label` задаёт потребитель через props `Tooltip.XButton`. Кнопка там рендерится всегда, поэтому без `Tooltip.XButton` она остаётся без доступного имени — в адаптивном сценарии `Tooltip.XButton` с `aria-label` стоит передавать, даже если на десктопе крестик не нужен.
 
 ---
 
@@ -147,7 +147,7 @@ Tooltip.Link_Mobile_Shadow_Focus
 - `TooltipLink` — ссылка; защита от reverse tabnabbing через `getSafeRel`.
 - `TooltipXButton` — кнопка закрытия десктопной версии (обёртка над `ButtonIcon`).
 - `TooltipMobileHeader` — шапка мобильной версии; кнопку закрытия подставляет сам, наследуя props у `Tooltip.XButton`.
-- `TooltipMobileCloseButton` — кнопка закрытия мобильной версии (обёртка над `DropdownMobileClose`).
+- `TooltipMobileCloseButton` — кнопка закрытия мобильной версии (обёртка над `PullerClose`).
 
 **Десктопная версия (`components/desktop/`):**
 
@@ -161,7 +161,7 @@ Tooltip.Link_Mobile_Shadow_Focus
 - `utils/Positioning.ts` — чистые функции выбора зоны и расчёта координат.
 - `utils/useTooltipTheme.ts` — класс темы на контейнере портала со счётчиком использования.
 - `Portal`, `MobileView` — инфраструктура рендера.
-- `Dropdown` — мобильная версия подсказки построена на его оверлее (`DropdownMobile`, `DropdownMobileClose`).
+- `Puller` — мобильная версия подсказки построена на нём (`Puller`, `PullerBody`, `PullerHeader`, `PullerClose`).
 - `ThemeProvider` — источник темы: `useTooltipTheme` берёт `scopeClassName` через `useToken` и ставит класс на контейнере портала.
 
 **Потребители внутри библиотеки:**
@@ -200,6 +200,7 @@ Tooltip.Link_Mobile_Shadow_Focus
 | 2026-08-03 | Правки по второму ревью PR #496 (документация и stories, кода не касаются): в «Ограничения» добавлено, что `onKeyDown` на десктопе не доходит до корневого элемента подсказки, а в адаптивном режиме доходит; уточнено, что в адаптивном режиме кнопка закрытия рендерится всегда и без `Tooltip.XButton` остаётся без `aria-label`; в `VisualTests` добавлен блок с `alignTip: end` — раньше это значение enum не было покрыто ни примером, ни тестом. |
 | 2026-08-03 | Правки по третьему ревью PR #496. Исправлено: при смене `toggleType` на лету hover-обработчики синхронизируются и на самой подсказке, а не только на целевом элементе (`setTooltipRef` повторно не вызывается, поэтому раньше на ноде подсказки оставались устаревшие слушатели). Тесты: `Tooltip.Link` в десктопном хелпере вынесен в прямые дети `Tooltip` — раньше слот `elements.link` не исполнялся ни в одном десктопном кейсе; добавлены кейсы на ветку `disableAdaptiveMode`. Публичный API не изменён. |
 | 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`DropdownMobile`) и потребитель `SMSField` — `SMSField.Tooltip` рендерит `Tooltip`, ссылка стоит с его стороны. Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
+| 2026-10-21 | **Breaking** (TRIPLEX-961): мобильная версия построена на `Puller` (бывший `DropdownMobile*`). `IDropdownMobileHeaderProps` перенесён из `types.ts` в `Puller/PullerHeader.tsx` как `IPullerHeaderProps` и больше не реэкспортируется из barrel `Tooltip`. |
 
 ---
 

package/bundle/guides/commits.md

@@ -4,7 +4,7 @@
 
 ## Задачи и тикеты
 
-Задачи ведутся в Linear, команда `TRI` (https://linear.app/triplex-next).
+Задачи ведутся в Linear, команда `TRI`.
 Номер задачи `TRI-XXX` — обязательный префикс веток и коммитов: по нему
 GitHub-интеграция Linear линкует PR и двигает статусы задачи
 (ветка → In Progress, PR → In Review, merge → Done).
@@ -12,6 +12,9 @@ GitHub-интеграция Linear линкует PR и двигает стат
 **Legacy:** исторические ветки и коммиты используют префикс `TRIPLEX-XXX`.
 Существующие не переименовываем; всё новое — только `TRI-XXX`.
 
+В файлах проекта задачи Linear упоминаются только по номеру `TRI-XXX`,
+без ссылок на задачи и workspace.
+
 ---
 
 ## Именование веток

package/bundle/guides/context.md

@@ -79,7 +79,7 @@ src/components/Button/
 
 Источник значений: `src/components/DesignTokens/DesignTokensCore.ts` (палитра,
 12 групп) и `src/components/DesignTokens/components/{Group}.ts` (токены
-компонентов, 56 групп). Путь токена — `{Группа}.{Токен}`:
+компонентов, 57 групп). Путь токена — `{Группа}.{Токен}`:
 
 ```text
 ColorBrand.50
@@ -225,12 +225,12 @@ export interface IButtonGeneralProps extends IButtonBaseProps {
 
 ```typescript
 // Деструктурируй из пропсов:
-const { theme, size, newProp, className, ...rest } = props;
+const { theme, size, newProp, className, ...restProps } = props;
 
 // Применяй через clsx:
 <button
     className={clsx(styles.button, styles[size], { [styles.newVariant]: newProp === 'variant' }, className)}
-    {...rest}
+    {...restProps}
 >
 ```
 
@@ -332,7 +332,7 @@ AI-агента.
 1. Компонент экспортируется из barrel `src/components/{Family}/index.ts`
    (внутренние/приватные — нет).
 2. У компонента есть нетривиальный API или поведение: собственные props
-   сверх `className + ref + ...rest`, либо state, контекст, клавиатура,
+   сверх `className + ref + ...restProps`, либо state, контекст, клавиатура,
    callback'и, accessibility-контракт, render-prop, discriminated union.
 
 Тривиальные wrapper'ы (`className + spread + forwardRef` без своей логики)
@@ -354,7 +354,7 @@ AI-агента.
 Индекс переходов для агента, а не «похожие компоненты»: только имена, пояснения —
 в разделе «Связанные компоненты». Имя обязано быть адресатом: компонентом из
 таблицы `docs/ai/ROADMAP.md`, у которого AI.md есть или запланирован. Связь с
-обёрткой вне таблицы записывается на её родителя (`IDropdownMobileMaskedInputProps
+обёрткой вне таблицы записывается на её родителя (`IPullerMaskedInputProps
 extends IFormFieldMaskedInputProps` → `FormField`).
 
 Адресат попадает в `related`, только если подходит под одну из четырёх категорий: