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

package/bundle/components/DatePickerExtended.md

@@ -1,7 +1,7 @@
 ---
 component: DatePickerExtended
 category: Date components
-related: [Calendar, Dropdown, DateField, MonthYearField, ChipDatePicker, ChipMonthYearPicker]
+related: [Calendar, Dropdown, Puller, DateField, MonthYearField, ChipDatePicker, ChipMonthYearPicker]
 tokens: []
 stories: stories/DatePickerExtended/DatePickerExtended.stories.tsx
 version: "1.0"
@@ -11,7 +11,7 @@ version: "1.0"
 
 ## Назначение
 
-Связка «произвольный целевой элемент + выпадающий календарь». Компонент рендерит целевой элемент (render-prop `renderTarget`) и `Calendar` внутри `Dropdown`, хранит состояние открытости календаря и отдаёт его целевому элементу через `DatePickerExtendedContext`. На мобильной ширине экрана вместо десктопного дропдауна открывается полноэкранный `DropdownMobile` с заголовком из `renderDropdownHeaderTarget`.
+Связка «произвольный целевой элемент + выпадающий календарь». Компонент рендерит целевой элемент (render-prop `renderTarget`) и `Calendar` внутри `Dropdown`, хранит состояние открытости календаря и отдаёт его целевому элементу через `DatePickerExtendedContext`. На мобильной ширине экрана вместо десктопного дропдауна открывается нижняя шторка `Puller` с заголовком из `renderDropdownHeaderTarget`.
 
 Используй когда: строишь собственный компонент выбора даты с нестандартным триггером (поле, чип, кнопка) и хочешь переиспользовать готовую механику дропдауна с календарём. Именно так устроены `DateField`, `MonthYearField` и `ChipDatePicker`.
 
@@ -28,7 +28,7 @@ version: "1.0"
 | Prop | Тип | Описание |
 |---|---|---|
 | `renderTarget` | `() => ReactNode` | Рендер целевого элемента. Вызывается внутри `DatePickerExtendedContext.Provider`, поэтому возвращённое дерево может читать и менять открытость календаря через контекст. |
-| `renderDropdownHeaderTarget` | `() => ReactNode` | Рендер целевого элемента в заголовке мобильного дропдауна (`DropdownMobileHeader`). Обычно — `DropdownMobileInput` с текущим значением. |
+| `renderDropdownHeaderTarget` | `() => ReactNode` | Рендер целевого элемента в заголовке мобильного дропдауна (`PullerHeader`). Обычно — `PullerInput` с текущим значением. |
 | `pickedDate` | `string \| Moment \| null` | Выбранная дата (prop `Calendar`). Компонент неуправляемый только в части открытости — выбранную дату хранит потребитель. |
 | `onDateChange` | `(date: Moment) => void` | Вызывается при выборе даты в календаре. Компонент дополнительно закрывает дропдаун. |
 
@@ -94,6 +94,7 @@ version: "1.0"
 
 - `Calendar` — календарная сетка, рендерится внутри дропдауна; её props входят в `IDatePickerExtendedProps`, кроме `adaptiveMode`.
 - `Dropdown` — выпадающее меню; из его props наружу выведен только `alignment`, мобильная версия конфигурируется внутри.
+- `Puller` — мобильная вёрстка дропдауна (`PullerHeader`, `PullerClose`, `PullerBody`); заголовок обычно содержит `PullerInput`.
 - `DateField` — поле ввода даты; передаёт `dropdownTargetRef` и открывает календарь из `DateFieldTarget` через контекст.
 - `MonthYearField` — выбор месяца и года; конфигурирует `pickType={ECalendarPickType.MONTH_YEAR}`.
 - `ChipDatePicker` — чип-фильтр с календарём; открывает дропдаун из `ChipDatePickerTarget` через контекст.
@@ -102,7 +103,7 @@ version: "1.0"
 
 Внутренние части (в barrel не экспортируются, отдельного AI.md не имеют):
 
-- `DatePickerExtendedDropdown` — дропдаун с `FocusTrap` вокруг календаря и мобильной версткой (`DropdownMobileHeader` + `DropdownMobileBody`).
+- `DatePickerExtendedDropdown` — дропдаун с `FocusTrap` вокруг календаря и мобильной версткой (`PullerHeader` + `PullerBody`).
 
 ---
 
@@ -131,6 +132,7 @@ version: "1.0"
 
 | Дата | Изменение |
 |---|---|
+| 2026-10-21 | Переход на `Puller` (TRIPLEX-961): мобильная версия собрана из частей `Puller` (бывший `DropdownMobile*`). |
 | 2026-09-07 | В потребители базы добавлен `ChipMonthYearPicker` (чип-фильтр с `pickType` `MONTH_YEAR`) |
 | 2026-08-24 | `DatePickerExtendedContext` и `IDatePickerExtendedContext` экспортируются из barrel — целевой элемент можно написать снаружи библиотеки. `adaptiveMode` исключён из `IDatePickerExtendedProps` (ломающее изменение, затрагивает также `DateField`, `MonthYearField`, `ChipDatePicker`) |
 | 2026-08-20 | Создан документ. AI-рефакторинг, unit-тесты (`__tests__/DatePickerExtended.test.tsx`), stories по modern pattern. Исправлено: `yesterdayButtonProps` / `tomorrowButtonProps` пробрасываются в `Calendar`, `adaptiveMode` больше не попадает в DOM |
@@ -150,9 +152,9 @@ import {
     Button,
     DatePickerExtended,
     DatePickerExtendedContext,
-    DropdownMobileInput,
     EButtonTheme,
     EComponentSize,
+    PullerInput,
 } from "@sberbusiness/triplex-next";
 
 const DATE_FORMAT = "YYYYMMDD";
@@ -189,7 +191,7 @@ export const Default = () => {
             format={DATE_FORMAT}
             onDateChange={(date) => setValue(date.format(DATE_FORMAT))}
             renderTarget={() => <Target>{displayedValue}</Target>}
-            renderDropdownHeaderTarget={() => <DropdownMobileInput value={displayedValue} readOnly />}
+            renderDropdownHeaderTarget={() => <PullerInput value={displayedValue} readOnly />}
         />
     );
 };
@@ -206,10 +208,10 @@ import {
     Button,
     DatePickerExtended,
     DatePickerExtendedContext,
-    DropdownMobileInput,
     EButtonTheme,
     EComponentSize,
     EDropdownAlignment,
+    PullerInput,
 } from "@sberbusiness/triplex-next";
 
 const DATE_FORMAT = "YYYYMMDD";
@@ -256,7 +258,7 @@ const AlignmentItem = ({ alignment }: IAlignmentItemProps) => {
                 format={DATE_FORMAT}
                 onDateChange={(date) => setValue(date.format(DATE_FORMAT))}
                 renderTarget={() => <Target>{displayedValue}</Target>}
-                renderDropdownHeaderTarget={() => <DropdownMobileInput value={displayedValue} readOnly />}
+                renderDropdownHeaderTarget={() => <PullerInput value={displayedValue} readOnly />}
             />
         </div>
     );
@@ -282,7 +284,7 @@ import {
     Button,
     DatePickerExtended,
     DatePickerExtendedContext,
-    DropdownMobileInput,
+    PullerInput,
     ECalendarPickType,
     EButtonTheme,
     EComponentSize,
@@ -337,7 +339,7 @@ const PickTypeItem = ({ pickType }: IPickTypeItemProps) => {
                 format={DATE_FORMAT}
                 onDateChange={(date) => setValue(date.format(DATE_FORMAT))}
                 renderTarget={() => <Target>{displayedValue}</Target>}
-                renderDropdownHeaderTarget={() => <DropdownMobileInput value={displayedValue} readOnly />}
+                renderDropdownHeaderTarget={() => <PullerInput value={displayedValue} readOnly />}
             />
         </div>
     );
@@ -363,7 +365,7 @@ import {
     Button,
     DatePickerExtended,
     DatePickerExtendedContext,
-    DropdownMobileInput,
+    PullerInput,
     ECalendarDateMarkType,
     EButtonTheme,
     EComponentSize,
@@ -422,7 +424,7 @@ export const WithMarkedAndDisabledDays = () => {
             disabledDays={DISABLED_DAYS}
             onDateChange={(date) => setValue(date.format(DATE_FORMAT))}
             renderTarget={() => <Target>{displayedValue}</Target>}
-            renderDropdownHeaderTarget={() => <DropdownMobileInput value={displayedValue} readOnly />}
+            renderDropdownHeaderTarget={() => <PullerInput value={displayedValue} readOnly />}
         />
     );
 };
@@ -439,9 +441,9 @@ import {
     Button,
     DatePickerExtended,
     DatePickerExtendedContext,
-    DropdownMobileInput,
     EButtonTheme,
     EComponentSize,
+    PullerInput,
 } from "@sberbusiness/triplex-next";
 
 const DATE_FORMAT = "YYYYMMDD";
@@ -483,7 +485,7 @@ export const WithFooterButtons = () => {
             tomorrowButtonProps={{ children: "Завтра" }}
             onDateChange={(date) => setValue(date.format(DATE_FORMAT))}
             renderTarget={() => <Target>{displayedValue}</Target>}
-            renderDropdownHeaderTarget={() => <DropdownMobileInput value={displayedValue} readOnly />}
+            renderDropdownHeaderTarget={() => <PullerInput value={displayedValue} readOnly />}
         />
     );
 };

package/bundle/components/DateRange.md

@@ -38,24 +38,28 @@ version: "1.0"
 
 | Prop | Тип | По умолчанию | Описание |
 |---|---|---|---|
+| `format` | `string` | `dateFormatYYYYMMDD` | Формат дат moment в `value` и в `onChange` пикеров. Передаётся пикерам в render-props вместе с `value` и `onChange`. |
 | `shiftAmount` | `number` | `1` | На сколько единиц `shiftUnit` сдвигаются обе границы за одно нажатие. |
 | `shiftUnit` | `EDateRangeShiftUnit` | `MONTH` | Единица сдвига: `DAY`, `WEEK`, `MONTH`, `QUARTER`, `YEAR`. Значения enum — строки, которые напрямую уходят в `moment`. |
 | `hideNavigation` | `boolean` | `false` | Скрывает обе кнопки сдвига: render-props кнопок не вызываются вовсе. |
 
 ### Формат значения
 
-`TDateRangeValue` — `[start, end]`, обе даты строками в формате `YYYYMMDD` (`dateFormatYYYYMMDD` из `src/consts/DateConst`). Пустая строка означает «дата не выбрана»; допустимо состояние, когда заполнена только одна граница.
+`TDateRangeValue` — `[start, end]`, обе даты строками в формате `format` (по умолчанию `YYYYMMDD` — `dateFormatYYYYMMDD` из `src/consts/DateConst`). Пустая строка означает «дата не выбрана»; допустимо состояние, когда заполнена только одна граница.
+
+Формат задаётся на DateRange и приходит в объект пикера: при spread в `DateField` поле получает тот же `format`. Не задавай `format` полю отдельно: если он стоит в JSX до spread (`<DateField format="DD.MM.YYYY" {...props} />`), его перезапишет формат DateRange; если после — формат поля и диапазона разойдутся.
 
 ### Что получают render-props
 
 | Поле | Кому | Значение |
 |---|---|---|
 | `value` | пикеры | Соответствующая граница диапазона (`start` или `end`). |
-| `onChange` | пикеры | Принимает строку `YYYYMMDD`; внутри применяется согласование границ (ниже). |
+| `format` | пикеры | Значение `format` компонента. При spread в `DateField` задаёт полю тот же формат. |
+| `onChange` | пикеры | Принимает строку в формате `format`; внутри применяется согласование границ (ниже). |
 | `children` | кнопки | Иконка направления (`CaretleftStrokeSrvIcon20` / `CaretrightStrokeSrvIcon20`). |
 | `className` | кнопки | Класс кнопки из LESS-модуля; при неполном диапазоне к нему добавляется литерал `disabled` (см. «Инварианты»). |
 | `disabled` | кнопки | `true`, пока заполнены не обе границы. Применить его к DOM-элементу — задача потребителя. |
-| `onClick` | кнопки | Сдвиг диапазона. На неполном диапазоне обработчик выходит, не вызывая `onChange`. |
+| `onClick` | кнопки | Сдвиг диапазона. На неполном диапазоне или при невалидной в `format` границе обработчик выходит, не вызывая `onChange`. |
 
 Объекты сформированы так, чтобы их можно было целиком спредить в `DateField` (пикеры) и `ButtonIcon` (кнопки) — именно так устроены все примеры в stories.
 
@@ -67,14 +71,16 @@ version: "1.0"
 
 - Новая дата «от» больше текущей «до» → `onChange([date, ""])`: дата «до» сбрасывается.
 - Новая дата «до» меньше текущей «от» → `onChange(["", date])`: дата «от» сбрасывается.
+- Равные даты допустимы: диапазон из одного дня сохраняется без сброса.
 - Если новая дата пустая или противоположная граница пустая, проверка порядка не выполняется — значение записывается как есть.
-- Сравнение строковое, без `moment`: формат `YYYYMMDD` лексикографически совпадает с хронологическим порядком. Поэтому формат дат менять нельзя (см. «Инварианты»).
+- Даты сравниваются хронологически через `isDateAfter` в `utils.ts`: обе строго парсятся `moment(value, format, true)`. Сравнение строк не используется — для форматов вроде `DD.MM.YYYY` лексикографический порядок не совпадает с хронологическим.
+- Если хотя бы одна из сравниваемых дат невалидна в `format`, порядок считается корректным и значение записывается как есть.
 
 ### Сдвиг диапазона
 
-- Обе границы сдвигаются на одну и ту же величину (`shiftDateRange` в `utils.ts`, под капотом `moment().add()`). При сдвиге на месяцы, кварталы и годы число месяца клампится по длине целевого месяца, поэтому длина диапазона в днях может измениться: `20240331` минус месяц → `20240229`.
-- Сдвиг доступен только при обеих заполненных границах: иначе кнопкам приходит `disabled: true`, а обработчик дополнительно выходит без `onChange`.
-- Валидность дат перед сдвигом не проверяется: строка не в формате `YYYYMMDD` даст `"Invalid date"` в результате. Близнец `MonthYearRange` в том же месте делает строгий `moment(..., true).isValid()` и выходит без `onChange` — эталон, если поведение решат выровнять.
+- Обе границы сдвигаются на одну и ту же величину (`shiftDateRange` в `utils.ts`, под капотом `moment().add()`); парсинг и результат — в формате `format`. При сдвиге на месяцы, кварталы и годы число месяца клампится по длине целевого месяца, поэтому длина диапазона в днях может измениться: `20240331` минус месяц → `20240229`.
+- Сдвиг доступен только при обеих заполненных границах: иначе кнопкам приходит `disabled: true`.
+- Перед сдвигом обе границы строго парсятся `moment(value, format, true)`. Если хотя бы одна пустая или невалидна (в том числе не совпадает с `format`), `shiftDateRange` возвращает `null` и `onChange` не вызывается. При непустой, но невалидной границе кнопки остаются активными: `disabled` зависит только от пустых границ — так же, как в `MonthYearRange`.
 
 ---
 
@@ -90,9 +96,9 @@ version: "1.0"
 
 - **`forwardRef` обязателен.** `ref` уходит на корневой `<div>` — туда же, куда `className` и остальные html-атрибуты. Убирать `forwardRef` нельзя.
 - **К `className` кнопок при неполном диапазоне подмешивается литерал `disabled`**, а не класс LESS-модуля (класса `.disabled` в модуле нет). Строка уходит наружу, в `className` компонента потребителя, и на неё опираются тесты, поэтому «починка» на `styles.disabled` — изменение наблюдаемого поведения. `MonthYearRange` в том же месте ничего не подмешивает.
-- **Формат дат `YYYYMMDD` зашит в контракт**: на нём держится строковое сравнение границ и парсинг в `moment`. Ни `value`, ни аргумент `onChange` пикера в другом формате работать не будут.
+- **Формат дат задаётся одним `format` на весь компонент**: по нему парсятся границы при согласовании и сдвиге. `value` и аргумент `onChange` пикера должны быть в этом формате; по умолчанию — `YYYYMMDD`, и смена значения по умолчанию — breaking change.
 - Значения `EDateRangeShiftUnit` — это строковые единицы `moment` (`day`, `week`, `month`, `quarter`, `year`); переименование значений ломает и публичный API, и сдвиг.
-- Публичный API (`DateRange`, `IDateRangeProps`, `IDateRangeButtonProvideProps`, `IDateRangePickerProvideProps`, `TDateRangeValue`, `EDateRangeShiftUnit`) экспортируется через `src/components/DateRange/index.ts`; `TDateRangeValue` живёт в `types.ts`, остальное — в `DateRange.tsx` и `enums.ts`. `utils.ts` внутренний и в barrel не экспортируется.
+- Публичный API (`DateRange`, `IDateRangeProps`, `IDateRangeButtonProvideProps`, `IDateRangePickerProvideProps`, `TDateRangeValue`, `EDateRangeShiftUnit`) экспортируется через `src/components/DateRange/index.ts`; интерфейсы и `TDateRangeValue` живут в `types.ts`, компонент — в `DateRange.tsx`, enum — в `enums.ts`. `utils.ts` внутренний и в barrel не экспортируется, но `isDateAfter` и `shiftDateRange` импортирует `MonthYearRange` — не переименовывать и не менять сигнатуры без проверки этого потребителя.
 - Отступы завязаны на подстроки `sm` / `md` / `lg` в классе вложенного поля — переименование классов размеров в `FormField`-полях тихо сломает выравнивание.
 - Компонент не хардкодит текст: доступные имена полей и кнопок задаёт потребитель — библиотека мультиязычная.
 - React 17-совместимость (ветка `release-0`): не переводить на `useId` и другие React 18-only API.
@@ -112,7 +118,7 @@ version: "1.0"
 ## Связанные компоненты
 
 - `MonthYearRange` — тот же сценарий для диапазона месяцев: одинаковый набор props и render-props, отличается единицами сдвига (`EMonthYearRangeShiftUnit`).
-- `DateField` — поле, ради которого сделан контракт `IDateRangePickerProvideProps`: объект пикера спредится в `DateField` целиком (`value` + `onChange`).
+- `DateField` — поле, ради которого сделан контракт `IDateRangePickerProvideProps`: объект пикера спредится в `DateField` целиком (`value` + `format` + `onChange`).
 - `ButtonIcon` — кнопка, ради которой сделан контракт `IDateRangeButtonProvideProps`: объект кнопки спредится в `ButtonIcon` целиком (`children` + `className` + `disabled` + `onClick`).
 
 `DatePickerExtended` и `Calendar` в DateRange не используются напрямую — они находятся внутри `DateField`.
@@ -140,6 +146,7 @@ version: "1.0"
 |---|---|
 | 2026-09-18 | Создан документ. Компонент переведён с `React.FC` на `forwardRef`: `ref` уходит на корневой `<div>`, тип стал `React.ForwardRefExoticComponent`. AI-рефакторинг: логика сдвига вынесена в `utils.ts` (`shiftDateRange`), добавлены JSDoc и unit-тесты на хелпер. Остальной публичный API и поведение не изменились |
 | 2026-09-18 | По итогам ревью: обработчики сдвига сведены в один `shiftRange(amount)`; `TDateRangeValue` вынесен в `types.ts` и реэкспортируется из `index.ts` (набор публичных имён не изменился) |
+| 2026-10-15 | Добавлен prop `format` (по умолчанию `YYYYMMDD`), передаётся пикерам в render-props (`IDateRangePickerProvideProps.format`). Границы сравниваются хронологически (`isDateAfter`) вместо сравнения строк. Сдвиг не вызывает `onChange` при невалидной в `format` границе. Интерфейсы props перенесены в `types.ts` |
 
 ---
 

package/bundle/components/Dropdown.md

@@ -1,7 +1,7 @@
 ---
 component: Dropdown
 category: Dropdown
-related: [ButtonDropdown, ButtonDropdownExtended, Portal, MobileView, LoaderSmall]
+related: [ButtonDropdown, ButtonDropdownExtended, Portal, MobileView, Puller, LoaderSmall]
 tokens:
   - Dropdown.Background
   - Dropdown.Shadow
@@ -9,15 +9,6 @@ tokens:
   - DropdownList.Background_Default
   - DropdownList.Background_Active
   - DropdownList.Background_Selected
-  - DropdownMobile.Backdrop
-  - DropdownMobile.Header_Background
-  - DropdownMobile.Content_Background
-  - DropdownMobile.Footer_Background
-  - DropdownMobile.Border_Color
-  - DropdownMobileList.Active_Background
-  - DropdownMobileList.Selected_Background
-  - FormField.Input_Color_Default
-  - FormField.Placeholder_Color
 stories: stories/Dropdown/Dropdown.stories.tsx
 version: "1.0"
 ---
@@ -26,7 +17,7 @@ version: "1.0"
 
 ## Назначение
 
-Выпадающее меню: рендерится через `Portal` в `document.body` и фиксированно позиционируется относительно управляющего элемента (`targetRef`). Содержимое произвольное — список опций, форма фильтра, любой блок. Если задан `mobileViewProps`, на мобильной ширине экрана (<768px) вместо десктопного меню открывается полноэкранная мобильная версия.
+Выпадающее меню: рендерится через `Portal` в `document.body` и фиксированно позиционируется относительно управляющего элемента (`targetRef`). Содержимое произвольное — список опций, форма фильтра, любой блок. Если задан `pullerProps`, на мобильной ширине экрана (<768px) вместо десктопного меню открывается нижняя шторка `Puller`.
 
 Используй когда: нужно показать всплывающий блок, привязанный к элементу-триггеру, и при этом выйти за пределы контейнеров с `overflow: hidden`.
 Не используй когда:
@@ -59,8 +50,8 @@ version: "1.0"
 | `width` | `EDropdownWidth` | `CONTENT` | Расчёт ширины: по содержимому, равна ширине управляющего элемента (`TARGET`) или не уже неё (`MIN_TARGET`) |
 | `onOpen` | `() => void` | — | Вызывается при переходе `opened` в `true`. На первом рендере не вызывается |
 | `onClose` | `() => void` | — | Вызывается при переходе `opened` в `false`. На первом рендере не вызывается |
-| `mobileViewProps` | `Omit<IDropdownMobileProps, "opened" \| "setOpened">` | — | Включает адаптивный режим. `mobileViewProps.children` заменяет `children` в мобильной версии; если не задан, используется `children` |
-| `className` | `string` | — | Дополнительный класс. В десктопной версии — на корневом `<div>` меню, в мобильной — на wrapper'е оверлея |
+| `pullerProps` | `Omit<IPullerProps, "opened" \| "setOpened">` | — | Включает адаптивный режим и целиком спредится в `Puller`. `pullerProps.children` заменяет `children` в мобильной версии; если не задан, используется `children` |
+| `className` | `string` | — | Дополнительный класс корневого `<div>` десктопного меню. В мобильную версию не попадает: там класс задаётся через `pullerProps.className` |
 | `style` | `React.CSSProperties` | — | Мержится **поверх** вычисленного положения, поэтому им можно перебить `top` / `left` / `width` |
 
 ### Список опций — `DropdownList` и `DropdownList.Item`
@@ -88,14 +79,13 @@ version: "1.0"
 - `DropdownList` в качестве `children` принимает только `DropdownList.Item` — остальные узлы рендерятся как есть, но не участвуют в навигации и нумерации.
 - `DropdownList` — не `forwardRef`-компонент: ссылка на контейнер списка передаётся через prop `listRef`.
 - Закрытие по `Escape`, `Tab` и клику вне меню `Dropdown` **не реализует**. Это ответственность потребителя либо `ButtonDropdownExtended`.
-- Мобильная версия строится на `OverlayBase` и имеет собственный набор субкомпонентов (`DropdownMobileHeader`, `DropdownMobileBody`, `DropdownMobileList` и т.д.), которые передаются через `mobileViewProps.children`.
 
 ---
 
 ## Дизайн-токены
 
 Переопределяются через `ThemeProvider` (prop `tokens`) — см. `ThemeProvider-ai.md` →
-«Как переопределять токены». Значения по умолчанию — файлы групп `Dropdown`, `DropdownList`, `DropdownMobile`, `DropdownMobileList` в `src/components/DesignTokens/components/`.
+«Как переопределять токены». Значения по умолчанию — файлы групп `Dropdown`, `DropdownList` в `src/components/DesignTokens/components/`. Токены мобильной версии (группы `Puller`, `PullerList`) описаны в `Puller-ai.md`.
 
 ```text
 Dropdown.Background
@@ -104,44 +94,34 @@ DropdownList.Color
 DropdownList.Background_Default
 DropdownList.Background_Active
 DropdownList.Background_Selected
-DropdownMobile.Backdrop
-DropdownMobile.Header_Background
-DropdownMobile.Content_Background
-DropdownMobile.Footer_Background
-DropdownMobile.Border_Color
-DropdownMobileList.Active_Background
-DropdownMobileList.Selected_Background
 ```
 
-`DropdownMobileInput` дополнительно использует токены поля ввода: `FormField.Input_Color_Default`, `FormField.Placeholder_Color`.
-
 ---
 
 ## Инварианты
 
-- `forwardRef` на `Dropdown`, `DropdownDesktop`, `DropdownListItem` и всех мобильных субкомпонентах — не убирать. Ref `Dropdown` указывает на корневой `<div>` десктопного меню, а в мобильном режиме — на контентный `<div>` (`.dropdownMobile`).
+- `forwardRef` на `Dropdown`, `DropdownDesktop`, `DropdownListItem` — не убирать. Ref `Dropdown` указывает на корневой `<div>` десктопного меню, а в мобильном режиме — на контентный `<div>` `Puller` (`.puller`).
 - Меню в закрытом состоянии не рендерит ничего (`DropdownDesktop` возвращает `null`) — на это опираются потребители, монтирующие `Dropdown` безусловно.
 - Компонент управляемый: не добавлять внутренний state открытости, иначе сломается контракт `opened` / `setOpened`.
-- `Dropdown` рендерится в `document.body` через `Portal`. Смена контейнера портала — breaking change для потребителей, которые ищут меню в DOM.
-- Публичные barrel-экспорты `src/components/Dropdown/index.ts`, `desktop/index.ts`, `mobile/index.ts` должны сохраняться: компонент используется внутри `ButtonDropdown`, `SelectField`, `SelectExtendedField`, `SuggestField`, `MultiselectField`, `TabsLine`, `DatePickerExtended`, `Chip`, `List`.
+- `Dropdown` рендерится в `document.body` через `Portal`. Смена контейнера портала — breaking change для потребителей, которые ищут меню в DOM. Мобильная версия рендерится туда же, если не задан `pullerProps.renderContainer`.
+- Публичные barrel-экспорты `src/components/Dropdown/index.ts`, `desktop/index.ts` должны сохраняться: компонент используется внутри `ButtonDropdown`, `SelectField`, `SelectExtendedField`, `SuggestField`, `MultiselectField`, `TabsLine`, `DatePickerExtended`, `Chip`, `List`.
 - `DropdownList` проставляет дочерним элементам `active`, `size`, `ref`, `onMouseOver` и `onMouseOut` через `cloneElement` — эти props у `DropdownList.Item` нельзя считать «пользовательскими».
-- Пока десктопное меню открыто, на `document.body` висит класс блокировки скролла, а на документе — обработчики `wheel` и `keydown`. Снятие обработчиков в cleanup эффекта обязательно.
+- Пока десктопное меню открыто, на `document.body` висит класс блокировки скролла, а на документе — обработчики `wheel` и `keydown`. Снятие обработчиков в cleanup эффекта обязательно. Класс вешается только через `lockBodyScroll` (`src/utils/scroll/bodyScrollLock.ts`): прямой `classList.remove` снял бы блокировку при другом открытом меню.
 - Числовой формат `keyCodesForSelection` (`number[]`, а не `KeyboardEvent.code`) — часть публичного API.
 - Хелперы из `desktop/utils.ts` внутренние: не экспортировать их через barrel.
-- У мобильного списка (`DropdownMobileList`) нет собственного класса-зацепки — в отличие от десктопного `.dropdownDesktopList`. Это осознанно: в `styles/DropdownMobile.module.less` такого класса никогда не было, стилизуются только элементы списка и лоадер. Корневой `<div>` получает только `className` снаружи; не добавлять пустое правило в LESS ради зацепки без задачи.
 - `listRef` у `DropdownList` и `setActiveDescendant` из `DropdownListContext` должны быть стабильными между рендерами (ref из `useRef`, сеттер из `useState`). Нестабильные значения переподписывают клавиатурный обработчик и сбрасывают `aria-activedescendant` на каждый рендер.
 
 ---
 
 ## Accessibility
 
-- `DropdownList` рендерит контейнер с `role="listbox"`, `DropdownList.Item` — `role="option"` и `aria-selected`. Мобильные `DropdownMobileList` / `DropdownMobileListItem` — те же роли.
+- `DropdownList` рендерит контейнер с `role="listbox"`, `DropdownList.Item` — `role="option"` и `aria-selected`. В мобильной версии `PullerList` / `PullerListItem` — те же роли.
 - Клавиатурная навигация по списку: `ArrowDown` / `ArrowUp` перемещают активный элемент по кругу и прокручивают контейнер к нему, `Enter` / `Space` (или клавиши из `keyCodesForSelection`) вызывают `onSelect` активного элемента. Обработчики висят на `document`, пока `dropdownOpened === true`.
 - При открытии активным становится элемент с `selected`, иначе первый; список прокручивается к нему.
 - Пока меню открыто, `DropdownDesktop` гасит клавиши прокрутки страницы (`Space`, `PageUp`, `PageDown`, `Home`, `End`, стрелки), но только если фокус на `document.body`.
 - `aria-activedescendant` компонент сам на триггер **не выставляет**: `DropdownList` публикует id активного элемента через `DropdownListContext.setActiveDescendant`, а связать его с триггером должен потребитель (см. `SelectField`, `ButtonDropdown`). Контекст сбрасывается при закрытии и размонтировании списка.
 - Потребитель отвечает за атрибуты триггера: `aria-haspopup`, `aria-expanded`, `aria-controls`, `aria-activedescendant`.
-- Компонент не хардкодит текстовые строки: `aria-label` для `DropdownMobileClose` и заголовки мобильной версии передаёт потребитель (библиотека мультиязычная).
+- Компонент не хардкодит текстовые строки: `aria-label` для `PullerClose` и заголовки мобильной версии передаёт потребитель (библиотека мультиязычная).
 - **Известное ограничение:** при уходе курсора с элемента списка (`onMouseOut`) подсветка снимается, но `activeDescendant` в контексте не сбрасывается — `aria-activedescendant` на триггере продолжает указывать на последний наведённый пункт до следующей смены активного элемента или закрытия меню. Поведение унаследованное; его исправление меняет наблюдаемый контракт для `SelectField` / `ButtonDropdown` / `SuggestField` и требует отдельного решения.
 - Фокус компонент не перехватывает и не возвращает. Если нужен focus trap, его добавляет потребитель (так делает `MultiselectField.Dropdown`).
 
@@ -153,7 +133,7 @@ DropdownMobileList.Selected_Background
 Это область задачи TRI-35 («Scope: только Dropdown; соседние экспортируемые компоненты
 из `src/components/Dropdown/` — отдельные задачи»), а не вывод по критериям
 `docs/ai/CONTEXT.md` → «Когда создавать `{ComponentName}-ai.md`». По этим критериям
-`DropdownList`, `DropdownListItem`, `DropdownMobile` и `DropdownMobileListItem`
+`DropdownList` и `DropdownListItem`
 заслуживают собственных AI.md и отдельных строк в `docs/ai/ROADMAP.md` — как это
 сделано для семейства `List`. Решение о том, заводить ли их, за владельцем репозитория.
 
@@ -163,17 +143,9 @@ DropdownMobileList.Selected_Background
 - `DropdownList` — контейнер списка с клавиатурной навигацией, `role="listbox"`. Статическое свойство `DropdownList.Item`.
 - `DropdownListItem` — элемент списка, `role="option"`, выбор мышью и клавиатурой.
 
-**Мобильная версия (`src/components/Dropdown/mobile/`):**
+**Мобильная версия:**
 
-- `DropdownMobile` — полноэкранный оверлей снизу на базе `OverlayBase`, блокирует скролл body.
-- `DropdownMobileInner` — внутренняя разметка оверлея: подложка и контент с анимацией открытия/закрытия.
-- `DropdownMobileHeader` — шапка со слотом `controlButtons` (тип `IDropdownMobileHeaderProps` объявлен в `src/components/Tooltip/types.ts`).
-- `DropdownMobileBody` — скроллируемое тело.
-- `DropdownMobileFooter` — футер для кнопок.
-- `DropdownMobileList` / `DropdownMobileListItem` — список и элемент списка мобильной версии.
-- `DropdownMobileClose` — кнопка закрытия (обёртка над `ButtonIcon`).
-- `DropdownMobileLoader` — лоадер для шапки (обёртка над `LoaderSmall`).
-- `DropdownMobileInput` / `DropdownMobileMaskedInput` — поля ввода для шапки (второе — обёртка над `FormFieldMaskedInput` с `presets`).
+- `Puller` (`src/components/Puller/`) — нижняя шторка на базе `OverlayBase`, которую `Dropdown` рендерит в адаптивном режиме вместо десктопного меню. Части шторки описаны в `Puller-ai.md`.
 
 **Общее:**
 
@@ -206,7 +178,7 @@ DropdownMobileList.Selected_Background
 | `Widths` | `Widths.tsx` | `CONTENT` / `TARGET` / `MIN_TARGET` |
 | `Loading` | `Loading.tsx` | Подгрузка опций: элемент с лоадером в конце списка |
 | `WithSelectedOption` | `WithSelectedOption.tsx` | Выбранная опция подсвечена и активна при открытии |
-| `MobileView` | `MobileView.tsx` | Адаптивный режим: `mobileViewProps` и мобильные субкомпоненты |
+| `MobileView` | `MobileView.tsx` | Адаптивный режим: `pullerProps` и части `Puller` |
 | `VisualTests` | `VisualTests.tsx` | Длинный список со скроллом, значок уведомления, произвольный контент вместо списка |
 
 ---
@@ -220,6 +192,9 @@ DropdownMobileList.Selected_Background
 | 2026-07-31 | Правки по ревью PR #491: эффект `onOpen` / `onClose` в `Dropdown` сравнивает предыдущее значение `opened` вместо флага «смонтирован» — колбэки больше не срабатывают ложно при двойном маунте в React 18 StrictMode (регрессионный тест `__tests__/Dropdown.strictMode.test.tsx`). Документационные stories стартуют закрытыми и раскрываются через `play`. Сброс активного элемента `DropdownList` сделан симметричным: при закрытии подсветка снимается вместе с `activeDescendant`. |
 | 2026-09-28 | Токен `Dropdown.Shadow` ссылается на `Shadow.07` (светлая) и `DarkShadow.07` (тёмная) вместо литералов; в тёмной теме прозрачность 0.25 вместо 0.35. |
 | 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`OverlayBase`) и потребители `SelectField` / `SelectExtendedField` / `SuggestField` / `MultiselectField` / `TabsLine` — по `docs/ai/CONTEXT.md` ссылка стоит с их стороны; добавлен `LoaderSmall` — контракт по рендеру в верную сторону. Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
+| 2026-10-21 | **Breaking** (TRIPLEX-961): мобильная версия выделена в компонент `Puller`, `DropdownMobile*` удалены без алиасов. Prop `mobileViewProps` переименован в `pullerProps`, группы токенов `DropdownMobile` / `DropdownMobileList` — в `Puller` / `PullerList` (ключ `Content_Background` → `Body_Background`). |
+| 2026-10-23 | Исправлено: закрытие одного из открытых `DropdownDesktop` снимало блокировку скролла страницы при другом открытом меню. **Breaking:** класс блокировки на `body` переименован `.dropdownDesktopOverflowHidden` → `.dropdownDesktopScrollLock`. |
+| 2026-10-31 | Мобильная версия рендерится в `pullerProps.renderContainer`, если он задан, иначе в `document.body` (TRIPLEX-961). |
 
 ---
 
@@ -746,16 +721,16 @@ import {
     Button,
     Dropdown,
     DropdownList,
-    DropdownMobileBody,
-    DropdownMobileClose,
-    DropdownMobileFooter,
-    DropdownMobileHeader,
-    DropdownMobileList,
-    DropdownMobileListItem,
     EButtonTheme,
     EComponentSize,
     EDropdownWidth,
     ETextSize,
+    PullerBody,
+    PullerClose,
+    PullerFooter,
+    PullerHeader,
+    PullerList,
+    PullerListItem,
     Text,
 } from "@sberbusiness/triplex-next";
 
@@ -793,31 +768,29 @@ export const MobileView = () => {
                 targetRef={targetRef}
                 size={EComponentSize.MD}
                 width={EDropdownWidth.MIN_TARGET}
-                mobileViewProps={{
+                pullerProps={{
                     children: (
                         <>
-                            <DropdownMobileHeader
-                                controlButtons={
-                                    <DropdownMobileClose aria-label="Закрыть" onClick={() => setOpened(false)} />
-                                }
+                            <PullerHeader
+                                controlButtons={<PullerClose aria-label="Закрыть" onClick={() => setOpened(false)} />}
                             >
                                 <Text size={ETextSize.B1}>Заголовок</Text>
-                            </DropdownMobileHeader>
-                            <DropdownMobileBody>
-                                <DropdownMobileList>
+                            </PullerHeader>
+                            <PullerBody>
+                                <PullerList>
                                     {OPTIONS.map((option) => (
-                                        <DropdownMobileListItem
+                                        <PullerListItem
                                             key={option.id}
                                             id={`mobile-${option.id}`}
                                             selected={option.id === selectedId}
                                             onSelect={() => handleSelect(option.id)}
                                         >
                                             {option.label}
-                                        </DropdownMobileListItem>
+                                        </PullerListItem>
                                     ))}
-                                </DropdownMobileList>
-                            </DropdownMobileBody>
-                            <DropdownMobileFooter>
+                                </PullerList>
+                            </PullerBody>
+                            <PullerFooter>
                                 <Button
                                     theme={EButtonTheme.SECONDARY}
                                     size={EComponentSize.MD}
@@ -825,7 +798,7 @@ export const MobileView = () => {
                                 >
                                     Button text
                                 </Button>
-                            </DropdownMobileFooter>
+                            </PullerFooter>
                         </>
                     ),
                 }}

package/bundle/components/EmptyView.md

@@ -26,22 +26,26 @@ version: "1.0"
 
 | Prop | Тип | Описание |
 |---|---|---|
-| `size` | `EEmptyViewSize` | Размер: `SM` / `MD` |
+| `size` | `EEmptyViewSize` | Обязательный размер: `SM` — текст `B3`, `MD` — текст `B2` |
 
 ### Опциональные props
 
 | Prop | Тип | По умолчанию | Описание |
 |---|---|---|---|
-| `icon` | `ReactNode` | — | Иконка (96px для `SM`, 128px для `MD`) |
-| `title` | `ReactNode` | — | Заголовок |
+| `icon` | `ReactNode` | — | Иконка; размер задаёт потребитель (обычно 96px для `SM`, 128px для `MD`) |
+| `title` | `ReactNode` | — | Заголовок `H3` с начертанием `MEDIUM` для обоих размеров |
 | `description` | `ReactNode` | — | Текст описания |
 | `caption` | `ReactNode` | — | Подпись |
-| `buttons` | `ReactNode` | — | Кнопки действий |
+| `buttons` | `ReactNode` | — | Кнопки действий с отступом 16px для `SM` и 24px для `MD` |
+
+`className` объединяется с классами корневого `<div>`. HTML-атрибуты и обработчики
+передаются на тот же элемент; `ref` указывает на него.
 
 ### Ограничения по темам
 
 - Если `title` задан — описание отображается вторичным цветом (Secondary).
 - Если `title` не задан — описание становится основным текстом (Primary).
+- `caption` всегда отображается вторичным цветом; подпись можно передать без описания.
 
 ---
 
@@ -103,6 +107,7 @@ Typography.Secondary_Color  (description с title, caption)
 | 2026-04-09 | Создан компонент и документ. |
 | 2026-04-27 | Приведён в соответствие с `docs/ai/template-ai.md`: добавлена колонка `Example file`, переименована подсекция «Поведение описания» в «Ограничения по темам». |
 | 2026-08-31 | Заголовок всегда рендерится как `Title` с `ETitleSize.H3` и `EFontWeightTitle.MEDIUM`: убран `TITLE_CONFIG`, типографика `title` больше не зависит от `size`. |
+| 2026-10-08 | Проведён AI-рефакторинг: уточнены условия и JSDoc props, дополнены тесты условного рендеринга и точной передачи ref. Уточнены размерная типографика, размер иконки, отступы кнопок и корневые HTML-атрибуты. |
 
 ---
 

package/bundle/components/ExpandAnimation.md

@@ -1,7 +1,7 @@
 ---
 component: ExpandAnimation
 category: ExpandAnimation
-related: [AccordionBase]
+related: []
 tokens: []
 stories: stories/ExpandAnimation/ExpandAnimation.stories.tsx
 version: "1.0"
@@ -24,9 +24,10 @@ version: "1.0"
 раскрытия уже живёт в потребителе (аккордеон, «показать ещё», раскрываемая
 строка таблицы).
 
-Не используй когда: нужен готовый аккордеон с внутренним состоянием, id-связкой
-заголовка и тела и ARIA-атрибутами — для этого есть `AccordionBase` и
-построенные на нём компоненты.
+Не используй когда: нужен готовый аккордеон с внутренним состоянием и
+доступным управлением — используй публичный `IslandAccordion`.
+Для иерархического дерева используй `CollapsibleTree`. Его внутренняя база
+`AccordionBase` не экспортируется.
 
 ---
 
@@ -163,7 +164,8 @@ Tab и не читается скринридером. Во время аним
 - `AccordionBase` (`src/components/AccordionBase`) — слой выше: хранит
   состояние раскрытия (controlled / uncontrolled), генерирует id и
   ARIA-атрибуты для связки header ↔ body, рендерит `ExpandAnimation` внутри.
-  Если нужен аккордеон, а не просто анимация высоты — начинай с него.
+  Это внутренняя реализация; для потребительского кода выбирай публичный
+  компонент, построенный на ней.
 - Потребители внутри библиотеки, чьё поведение зависит от этого компонента:
   `IslandAccordion` (передаёт `transitionProps`, `role="region"`, `id`),
   `IslandWidget` и `IslandWidgetExtraFooter`, `CollapsibleTreeExtended`
@@ -191,6 +193,8 @@ Tab и не читается скринридером. Во время аним
 | Дата | Изменение |
 |---|---|
 | 2026-08-21 | Создан документ. Зафиксированы: карта стилей по фазам анимации, требование хранить её в ref, порядок применения `transitionProps`, контракт `visibility: hidden` в `exited`, отсутствие собственных ARIA-атрибутов и токенов |
+| 2026-10-16 | Внутренний `AccordionBase` исключён из `related` при сверке ROADMAP; рекомендации потребителю направлены на публичные компоненты, описание внутренней зависимости сохранено. |
+| 2026-10-19 | Уточнён выбор готового компонента: `IslandAccordion` для аккордеона, `CollapsibleTree` для иерархического дерева. |
 
 ---
 

package/bundle/components/FormField.md

@@ -63,7 +63,7 @@ version: "1.0"
 - Класс `filled` выставляется, когда вложенный элемент ввода сообщил о наличии значения. Для `FormFieldInput` / `FormFieldTextarea` это включает браузерное автозаполнение (ловится через CSS-анимационные хуки `autofill-applied-hook` / `autofill-cancelled-hook`), для `FormFieldTarget` — наличие `children`.
 - Кнопка `FormFieldClear` показывается стилями только при `filled` и hover/активном состоянии непустого и не заблокированного поля, а также при собственном фокусе (`:focus`) — чтобы кнопка оставалась видимой при клавиатурной навигации.
 - Идентификаторы генерируются субкомпонентами (`uniqueId` из `lodash-es`, не `React.useId` — код должен оставаться совместимым с React 17) и попадают в контекст как `targetId` / `labelId`; на них опирается связка лейбла и поля. `targetId` публикуют только labelable-элементы (`FormFieldInput`, `FormFieldTextarea`, а также `FormFieldMaskedInput` — он рендерит `FormFieldInput` внутри себя через `render`); `FormFieldTarget` его не публикует — см. Accessibility.
-- Вне `FormField` субкомпоненты используют `initialFormFieldContext`, где `filled: true` — это осознанный временный фикс для `DropdownMobileHeader`, а сеттеры являются no-op.
+- Вне `FormField` субкомпоненты используют `initialFormFieldContext`, где `filled: true` — это осознанный временный фикс для `PullerHeader`, а сеттеры являются no-op.
 
 ---