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

package/bundle/guides/stories.md

@@ -26,6 +26,15 @@ Stories выполняют несколько функций (в порядке
 - Если задача маленькая и story-файл уже legacy, **не рефактори весь файл только ради миграции**. Сохраняй локальный паттерн и обновляй только нужный участок.
 - Не переименовывай существующие story ids/export names без явной необходимости: на них могут опираться e2e и visual tests.
 
+Готовность **Storybook examples** в ROADMAP оценивается по основным
+документационным stories с копируемыми примерами. Дополнительный legacy-файл
+для визуальной регрессии допустим, если основные примеры компонента
+соответствуют modern pattern. Например, у `LightBox` основные примеры находятся
+в `stories/LightBox/LightBox.stories.tsx` и `stories/LightBox/examples/`,
+а `stories/LightBox/LightBoxInitialOpened.stories.tsx` сохраняет legacy pattern
+для скриншот-тестов. Разрешение сохранять legacy pattern при мелкой правке
+само по себе не подтверждает готовность основных примеров.
+
 ---
 
 ## Что обновлять при добавлении нового prop
@@ -96,7 +105,7 @@ stories/
 - **Без постфикса `Example`** — не пиши `DefaultExample.tsx`, `SizesExample.tsx`. Если встретишь старые файлы с этим постфиксом, сохраняй локальный паттерн до миграции, но новые файлы создавай без него.
 - Имя экспорта-функции внутри файла совпадает с именем файла: `export const Default = () => ...`.
 - Source-константа: `{StoryName}Source` — `DefaultSource`, `SizesSource`, `PlaygroundSource`.
-- В story-файле импорт компонента-примера делается через alias, чтобы избежать коллизии со story-экспортом: `Default as DefaultRender`, `Playground as PlaygroundRender`. Source без alias.
+- `examples/index.ts` реэкспортирует пример с суффиксом `Render` (`Default as DefaultRender`), поэтому в story-файле импорт идёт без alias — см. «Файл `examples/index.ts`».
 
 ---
 
@@ -344,11 +353,11 @@ import { action } from "storybook/actions";
 
 ### Параметры Visual tests
 
-Visual tests скрыта из документации и не показывает исходный код — она предназначена только для тестов:
+Visual tests скрыта из документации (`"!autodocs"`) и сайдбара (`"!dev"`) и не показывает код: она нужна только для скриншот-тестов, test-runner её снимает:
 
 ```tsx
 export const VisualTests: Story = {
-    tags: ["!autodocs"],
+    tags: ["!autodocs", "!dev"],
     parameters: {
         controls: { disable: true },
         docs: {
@@ -368,7 +377,7 @@ export const VisualTests: Story = {
 
 ```tsx
 export const VisualTests: Story = {
-    tags: ["!autodocs"],
+    tags: ["!autodocs", "!dev"],
     parameters: {
         controls: { disable: true },
         docs: {
@@ -444,16 +453,20 @@ render: () => (
 
 ## Файл `examples/index.ts`
 
-В modern pattern для каждого примера экспортируются два значения — сам компонент и его исходный код:
+В modern pattern для каждого примера экспортируются два значения — сам компонент под именем `{StoryName}Render` и его исходный код под именем `{StoryName}Source`. Экспорты только явные, без `export *`:
 
 ```ts
-export * from "./Default";
+export { Playground as PlaygroundRender, type IPlaygroundArgs } from "./Playground";
+export { Default as DefaultRender } from "./Default";
 export { default as DefaultSource } from "./Default?raw";
-export * from "./Sizes";
+export { Sizes as SizesRender } from "./Sizes";
 export { default as SizesSource } from "./Sizes?raw";
+export { VisualTests as VisualTestsRender } from "./VisualTests";
 ```
 
-> **Имена.** Файл и экспорт-функция называются как story (`Default.tsx` экспортирует `Default`). Source-константа добавляет суффикс `Source` (`DefaultSource`). Из-за коллизии с именем story-экспорта в `*.stories.tsx` импорт компонента-примера делается через alias — см. ниже.
+> **Имена.** Файл и экспорт-функция называются как story (`Default.tsx` экспортирует `Default`). Суффикс `Render` нужен, потому что имя `Default` в `*.stories.tsx` занято story-экспортом. Типы экспортируются через `type`.
+
+В существующих `index.ts` с `export *` при небольших правках сохраняй локальный паттерн; на явные экспорты переводи при переписывании stories.
 
 ---
 
@@ -462,7 +475,7 @@ export { default as SizesSource } from "./Sizes?raw";
 В modern pattern каждая документационная стори подключает пример и его исходный код через `?raw`:
 
 ```tsx
-import { Default as DefaultRender, DefaultSource } from "./examples";
+import { DefaultRender, DefaultSource } from "./examples";
 
 export const Default: StoryObj<typeof Component> = {
     render: DefaultRender,
@@ -478,7 +491,7 @@ export const Default: StoryObj<typeof Component> = {
 };
 ```
 
-> **Alias обязателен.** Имя экспорта-функции (`Default`) совпадает с именем story-экспорта (`Default: StoryObj`), поэтому в импорте используется `Default as DefaultRender`. Source-константа конфликта не вызывает (`DefaultSource`), её импортируем без alias. То же относится к Playground (`Playground as PlaygroundRender`).
+> Суффикс `Render` добавлен в `examples/index.ts`, поэтому alias при импорте не нужен.
 
 ---
 
@@ -491,13 +504,7 @@ import React, { useState, useCallback } from "react";
 import { Meta, StoryObj } from "@storybook/react";
 import { Title, Description, Primary, Controls, Stories, ArgTypes, Heading } from "@storybook/addon-docs/blocks";
 import { ComponentName, EComponentSize } from "@sberbusiness/triplex-next";
-import {
-    Default as DefaultRender,
-    DefaultSource,
-    Playground as PlaygroundRender,
-    Sizes as SizesRender,
-    SizesSource,
-} from "./examples";
+import { DefaultRender, DefaultSource, PlaygroundRender, SizesRender, SizesSource } from "./examples";
 
 const meta = {
     title: "Components/Group/ComponentName",
@@ -633,9 +640,10 @@ export const Sizes = () => (
 ### `examples/index.ts`
 
 ```ts
-export * from "./Default";
+export { Playground as PlaygroundRender } from "./Playground";
+export { Default as DefaultRender } from "./Default";
 export { default as DefaultSource } from "./Default?raw";
-export * from "./Sizes";
+export { Sizes as SizesRender } from "./Sizes";
 export { default as SizesSource } from "./Sizes?raw";
 ```
 
@@ -653,7 +661,7 @@ export { default as SizesSource } from "./Sizes?raw";
 - [ ] Playground скрыт из autodocs (`tags: ["!autodocs"]`) — если есть
 - [ ] Все документационные стори, кроме Playground, **не** имеют Controls (`controls: { disable: true }`)
 - [ ] Все документационные стори, кроме Playground, показывают пример кода через `source.code`
-- [ ] Все примеры вынесены в `examples/` и реэкспортированы через `index.ts`
+- [ ] Все примеры вынесены в `examples/` и реэкспортированы через `index.ts` явными экспортами
 - [ ] Default — минимальный пример с параметрами по умолчанию
 - [ ] Стори с вариантами (Sizes, Statuses) — каждый вариант подписан рядом с компонентом
 - [ ] Примеры самодостаточны (можно скопировать целиком)
@@ -670,7 +678,7 @@ export { default as SizesSource } from "./Sizes?raw";
 - [ ] Нет дублирующих скриншотов — визуально идентичные стори исключены через `testRunner: { skip: true }`
 - [ ] Все ключевые визуальные состояния покрыты (размеры, статусы, заполненные поля, фокус)
 - [ ] Если основных сторей недостаточно — создана Visual tests с недостающими состояниями
-- [ ] Visual tests скрыта из autodocs (`tags: ["!autodocs"]`) и не показывает код
+- [ ] Visual tests скрыта из autodocs и сайдбара (`tags: ["!autodocs", "!dev"]`) и не показывает код
 - [ ] Если компонент требует взаимодействия (dropdown, tooltip, modal, popover) — реализован `play` в Visual tests
 - [ ] Данные в Visual tests захардкожены (нет `new Date()`, `Math.random()`)
 - [ ] Контейнеры имеют фиксированные размеры для стабильного layout'а

package/bundle/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "triplexVersion": "1.50.0",
-  "generatedAt": "2026-10-09T17:30:26.195Z",
+  "triplexVersion": "1.54.0",
+  "generatedAt": "2026-11-06T17:58:45.272Z",
   "components": [
     {
       "name": "AbstractTree",
@@ -33,6 +33,12 @@
       "file": "components/AlertProcess.md",
       "ai_ready": true
     },
+    {
+      "name": "AlertProcessSpoiler",
+      "path": "src/components/Alert/AlertProcessSpoiler-ai.md",
+      "file": "components/AlertProcessSpoiler.md",
+      "ai_ready": true
+    },
     {
       "name": "Amount",
       "path": "src/components/Amount/Amount-ai.md",
@@ -125,10 +131,9 @@
     },
     {
       "name": "Carousel",
-      "path": "src/components/Carousel",
-      "file": null,
-      "ai_ready": false,
-      "storiesPath": "stories/Carousel/Carousel.stories.tsx"
+      "path": "src/components/Carousel/Carousel-ai.md",
+      "file": "components/Carousel.md",
+      "ai_ready": true
     },
     {
       "name": "CarouselExtended",
@@ -136,6 +141,36 @@
       "file": "components/CarouselExtended.md",
       "ai_ready": true
     },
+    {
+      "name": "CarouselIndicators",
+      "path": "src/components/Carousel/CarouselIndicators-ai.md",
+      "file": "components/CarouselIndicators.md",
+      "ai_ready": true
+    },
+    {
+      "name": "CarouselItem",
+      "path": "src/components/Carousel/CarouselItem-ai.md",
+      "file": "components/CarouselItem.md",
+      "ai_ready": true
+    },
+    {
+      "name": "CarouselNextButton",
+      "path": "src/components/Carousel/CarouselNextButton-ai.md",
+      "file": "components/CarouselNextButton.md",
+      "ai_ready": true
+    },
+    {
+      "name": "CarouselPrevButton",
+      "path": "src/components/Carousel/CarouselPrevButton-ai.md",
+      "file": "components/CarouselPrevButton.md",
+      "ai_ready": true
+    },
+    {
+      "name": "CarouselViewport",
+      "path": "src/components/Carousel/CarouselViewport-ai.md",
+      "file": "components/CarouselViewport.md",
+      "ai_ready": true
+    },
     {
       "name": "Checkbox",
       "path": "src/components/Checkbox/Checkbox-ai.md",
@@ -154,6 +189,18 @@
       "file": "components/CheckboxTreeExtended.md",
       "ai_ready": true
     },
+    {
+      "name": "CheckboxTreeExtendedCheckbox",
+      "path": "src/components/CheckboxTreeExtended/CheckboxTreeExtendedCheckbox-ai.md",
+      "file": "components/CheckboxTreeExtendedCheckbox.md",
+      "ai_ready": true
+    },
+    {
+      "name": "CheckboxTreeExtendedNode",
+      "path": "src/components/CheckboxTreeExtended/CheckboxTreeExtendedNode-ai.md",
+      "file": "components/CheckboxTreeExtendedNode.md",
+      "ai_ready": true
+    },
     {
       "name": "CheckboxXGroup",
       "path": "src/components/Checkbox/CheckboxXGroup-ai.md",
@@ -172,6 +219,18 @@
       "file": "components/Chip.md",
       "ai_ready": true
     },
+    {
+      "name": "ChipDatePicker",
+      "path": "src/components/Chip/ChipDatePicker-ai.md",
+      "file": "components/ChipDatePicker.md",
+      "ai_ready": true
+    },
+    {
+      "name": "ChipDatePickerTarget",
+      "path": "src/components/Chip/ChipDatePickerTarget-ai.md",
+      "file": "components/ChipDatePickerTarget.md",
+      "ai_ready": true
+    },
     {
       "name": "ChipGroup",
       "path": "src/components/ChipGroup/ChipGroup-ai.md",
@@ -184,6 +243,12 @@
       "file": "components/ChipMonthYearPicker.md",
       "ai_ready": true
     },
+    {
+      "name": "ChipMonthYearPickerTarget",
+      "path": "src/components/Chip/ChipMonthYearPickerTarget-ai.md",
+      "file": "components/ChipMonthYearPickerTarget.md",
+      "ai_ready": true
+    },
     {
       "name": "ChipMultiselect",
       "path": "src/components/Chip/ChipMultiselect-ai.md",
@@ -196,6 +261,18 @@
       "file": "components/ChipOptions.md",
       "ai_ready": true
     },
+    {
+      "name": "ChipSelect",
+      "path": "src/components/Chip/ChipSelect-ai.md",
+      "file": "components/ChipSelect.md",
+      "ai_ready": true
+    },
+    {
+      "name": "ChipSelectTarget",
+      "path": "src/components/Chip/ChipSelectTarget-ai.md",
+      "file": "components/ChipSelectTarget.md",
+      "ai_ready": true
+    },
     {
       "name": "ChipSort",
       "path": "src/components/Chip/ChipSort-ai.md",
@@ -208,6 +285,12 @@
       "file": "components/ChipSuggest.md",
       "ai_ready": true
     },
+    {
+      "name": "ChipSuggestTarget",
+      "path": "src/components/Chip/ChipSuggestTarget-ai.md",
+      "file": "components/ChipSuggestTarget.md",
+      "ai_ready": true
+    },
     {
       "name": "CodeText",
       "path": "src/components/Typography/CodeText-ai.md",
@@ -559,10 +642,9 @@
     },
     {
       "name": "MonthYearRange",
-      "path": "src/components/MonthYearRange",
-      "file": null,
-      "ai_ready": false,
-      "storiesPath": "stories/MonthYearRange/MonthYearRange.stories.tsx"
+      "path": "src/components/MonthYearRange/MonthYearRange-ai.md",
+      "file": "components/MonthYearRange.md",
+      "ai_ready": true
     },
     {
       "name": "MultiselectField",
@@ -576,15 +658,21 @@
       "file": "components/Notification.md",
       "ai_ready": true
     },
+    {
+      "name": "NotificationGrouped",
+      "path": "src/components/Notification/NotificationGrouped-ai.md",
+      "file": "components/NotificationGrouped.md",
+      "ai_ready": true
+    },
     {
       "name": "NumberField",
-      "path": "src/components/NumberField/NumberField-AI.md",
+      "path": "src/components/NumberField/NumberField-ai.md",
       "file": "components/NumberField.md",
       "ai_ready": true
     },
     {
       "name": "OrderedList",
-      "path": "src/components/OrderedList/OrderedList-AI.md",
+      "path": "src/components/OrderedList/OrderedList-ai.md",
       "file": "components/OrderedList.md",
       "ai_ready": true
     },
@@ -600,18 +688,36 @@
       "file": "components/Page.md",
       "ai_ready": true
     },
+    {
+      "name": "PageIndicators",
+      "path": "src/components/PageIndicators/PageIndicators-ai.md",
+      "file": "components/PageIndicators.md",
+      "ai_ready": true
+    },
     {
       "name": "Pagination",
       "path": "src/components/Pagination/Pagination-ai.md",
       "file": "components/Pagination.md",
       "ai_ready": true
     },
+    {
+      "name": "PaginationExtended",
+      "path": "src/components/Pagination/PaginationExtended-ai.md",
+      "file": "components/PaginationExtended.md",
+      "ai_ready": true
+    },
     {
       "name": "Portal",
       "path": "src/components/Portal/Portal-ai.md",
       "file": "components/Portal.md",
       "ai_ready": true
     },
+    {
+      "name": "Puller",
+      "path": "src/components/Puller/Puller-ai.md",
+      "file": "components/Puller.md",
+      "ai_ready": true
+    },
     {
       "name": "Radio",
       "path": "src/components/Radio/Radio-ai.md",
@@ -684,9 +790,15 @@
       "file": "components/SmallInput.md",
       "ai_ready": true
     },
+    {
+      "name": "SmartSpot",
+      "path": "src/components/SmartSpot/SmartSpot-ai.md",
+      "file": "components/SmartSpot.md",
+      "ai_ready": true
+    },
     {
       "name": "SMSField",
-      "path": "src/components/SMSField/SMSField-AI.md",
+      "path": "src/components/SMSField/SMSField-ai.md",
       "file": "components/SMSField.md",
       "ai_ready": true
     },
@@ -1189,6 +1301,26 @@
       "file": "release-notes/1.51.0.mdx",
       "path": "stories/release-notes/v1/1.51.0.mdx"
     },
+    {
+      "version": "1.52.0",
+      "file": "release-notes/1.52.0.mdx",
+      "path": "stories/release-notes/v1/1.52.0.mdx"
+    },
+    {
+      "version": "1.53.0",
+      "file": "release-notes/1.53.0.mdx",
+      "path": "stories/release-notes/v1/1.53.0.mdx"
+    },
+    {
+      "version": "1.54.0",
+      "file": "release-notes/1.54.0.mdx",
+      "path": "stories/release-notes/v1/1.54.0.mdx"
+    },
+    {
+      "version": "1.55.0",
+      "file": "release-notes/1.55.0.mdx",
+      "path": "stories/release-notes/v1/1.55.0.mdx"
+    },
     {
       "version": "1.6.0",
       "file": "release-notes/1.6.0.mdx",

package/bundle/release-notes/1.50.0.mdx

@@ -18,6 +18,10 @@ import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
 
 - Добавлены горизонтальные отступы `12px` между соседними `ButtonDropdownExtended`, а также между `ButtonDropdownExtended` и `Button` в обоих порядках.
 
+**PaginationNavigationExtended**
+
+- Проведён AI-рефакторинг.
+
 **Radio**
 
 - Проведён AI-рефакторинг.

package/bundle/release-notes/1.51.0.mdx

@@ -4,4 +4,61 @@ import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
 
 <Title>v1.51.0</Title>
 
+<Heading>Ломающие изменения</Heading>
+
+**Carousel**
+
+- Удалён enum `ECarouselOrientation`: используйте общий `EOrientation`, значения те же.
+- Удалены токены `Carousel.Indicator_*`: индикаторы теперь красятся токенами `PageIndicators.Indicator_*` с теми же именами и значениями. Если вы переопределяли их через `ThemeProvider`, перенесите ключи в группу `PageIndicators`.
+
+**ImageGallery**
+
+- Свойство `showDots` переименовано в `showPageIndicators`, `dotsProps` — в `pageIndicatorsProps`, тип `TImageGalleryDotsProps` — в `TImageGalleryPageIndicatorsProps`.
+
+**ImageGalleryExtended**
+
+- Часть `ImageGalleryExtended.Dots` заменена на `ImageGalleryExtended.PageIndicators`, тип `IImageGalleryExtendedDotsProps` — на `IImageGalleryExtendedPageIndicatorsProps`. Замените `<ImageGalleryExtended.Dots />` на `<ImageGalleryExtended.PageIndicators />`.
+- Изменено: вместо не более 4 тиков — индикатор на каждое изображение, видимо окно из 5. Ряд стал WAI-ARIA `tablist`: активный индикатор помечается `aria-selected="true"` вместо `aria-current`, стрелки, `Home` и `End` переключают изображение. Подписи индикаторов можно задать через `indicatorProps`.
+- Изменено: отступ 16px между частями галереи теперь задаёт только лента миниатюр, индикаторы страниц прилегают к картинке вплотную. Своей разметке между частями задайте отступ самостоятельно.
+- Удалены токены `ImageGallery.Dot_Background_*`: индикаторы красятся токенами `PageIndicators.Indicator_*`.
+
 <Heading>Изменения</Heading>
+
+**EmptyView**
+
+- Проведён AI-рефакторинг.
+
+**EOrientation**
+
+- Добавлен общий enum ориентации `EOrientation` (`HORIZONTAL` / `VERTICAL`), его используют `Carousel` и `PageIndicators`.
+
+**MonthYearRange**
+
+- Проведён AI-рефакторинг.
+
+**NotificationGrouped**
+
+- Проведён AI-рефакторинг.
+
+**NumberField**
+
+- Добавлено: `NumberField` передаёт `ref` на корневой контейнер `FormField` (`HTMLDivElement`) и имеет `displayName="NumberField"`. Тип компонента изменился с `React.FC` на `React.ForwardRefExoticComponent`.
+- Исправлено: каретка не смещается влево, когда при вводе удаляется символ правее неё. Например, при вводе цифры перед ведущим минусом каретка остаётся после введённой цифры.
+
+**OrderedList**
+
+- Изменено: внутренняя CSS-переменная начального номера переименована с `--start-index-tx` в `--triplex-next-runtime-OrderedList-Root_CounterReset` — она видна в inline-стиле корневого элемента.
+- Проведён AI-рефакторинг: других изменений для потребителя нет.
+
+**PageIndicators**
+
+- Добавлен компонент `PageIndicators` — ряд индикаторов страниц с окном из 5 видимых индикаторов и навигацией с клавиатуры. Его используют `Carousel.Indicators` (без изменений для потребителя) и `ImageGalleryExtended.PageIndicators`.
+
+**PaginationExtended**
+
+- Проведён AI-рефакторинг.
+
+**SMSField**
+
+- Проведён AI-рефакторинг. `SMSField` и `SMSField.Submit` принимают `ref`: на корневой `div` и на `button` соответственно. Для ссылки на поле ввода по-прежнему передавайте `ref` в `SMSField.Input`.
+- Исправлено: `onKeyDown` у `SMSField.Input` получал событие с `currentTarget` на обёртке поля, теперь — на `input`.

package/bundle/release-notes/1.52.0.mdx

@@ -0,0 +1,55 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.52.0" />
+
+<Title>v1.52.0</Title>
+
+<Heading>Ломающие изменения</Heading>
+
+**DateRange, MonthYearRange**
+
+- Поля в `renderPickerFrom` / `renderPickerTo` получают `format` диапазона. Если вы задавали `format` полю до spread (`<DateField format="..." {...props} />`), он перезапишется на `YYYYMMDD`: перенесите `format` на `DateRange` / `MonthYearRange`.
+
+<Heading>Изменения</Heading>
+
+**Carousel**
+
+- Исправлено: в режиме `ECarouselScrollMode.PAGE` страницы формировались и центрировались без учёта `viewportPadding`, из-за чего крайний слайд страницы мог обрезаться.
+- Проведён AI-рефакторинг.
+
+**CarouselItem**
+
+- Проведён AI-рефакторинг.
+
+**ChipDatePicker**
+
+- Добавлен файл `ChipDatePicker-ai.md` с AI-документацией компонента.
+
+**ChipDatePickerTarget**
+
+- Добавлен файл `ChipDatePickerTarget-ai.md` с AI-документацией компонента.
+- Проведён AI-рефакторинг.
+
+**ChipMonthYearPickerTarget**
+
+- Добавлен файл `ChipMonthYearPickerTarget-ai.md` с AI-документацией компонента.
+- Проведён AI-рефакторинг.
+
+**ChipSelect**
+
+- Добавлен файл `ChipSelect-ai.md` с AI-документацией компонента.
+
+**DateRange**
+
+- Добавлено свойство `format` — формат дат в `value` и `onChange`, по умолчанию `YYYYMMDD`.
+- Исправлено: с форматом вроде `DD.MM.YYYY` дата «до» ошибочно сбрасывалась — например, при вводе 31.01.2024 в «от» при «до» 01.02.2024. Теперь даты сравниваются хронологически в формате `format`.
+- Исправлено: сдвиг диапазона с невалидной границей передавал в `onChange` неверную дату (например, `"31.01.2024"` превращалась в `"20310220"`). Теперь такой диапазон не сдвигается.
+
+**LightBox**
+
+- Исправлен баг появления второго скролла во время открытия/закрытия SideOverlay и сдвига Lightbox/SideOverlay при открытии SideOverlay и TopOverlay на Windows.
+
+**MonthYearRange**
+
+- Добавлено свойство `format` — формат дат в `value` и `onChange`, по умолчанию `YYYYMMDD`.
+- Исправлено: с форматом вроде `DD.MM.YYYY` противоположная граница ошибочно сбрасывалась. Теперь даты сравниваются хронологически в формате `format`.

package/bundle/release-notes/1.53.0.mdx

@@ -0,0 +1,60 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.53.0" />
+
+<Title>v1.53.0</Title>
+
+<Heading>Новые компоненты</Heading>
+
+**Puller**
+
+- Нижняя шторка для экранов любой ширины, бывший `DropdownMobile`. Из пакета также экспортируется `PullerMaskedInput`.
+- В `Portal` себя не выносит: при прямом использовании оберните в `<Portal container={document.body}>`. В `pullerProps` у `Dropdown` это не нужно.
+- Отличия от `DropdownMobile`:
+    - блокировка скролла страницы не снимается, пока открыта другая шторка;
+    - `PullerListItem` передаёт `id` в DOM-элемент;
+    - лоадер `PullerList` больше не считается вариантом списка: он скрыт от скринридеров, загрузку передаёт `aria-busy`.
+
+**SmartSpot**
+
+- Компонент-анимированная подложка статуса. Состоит из размытых пятна на прозрачном фоне в цветах статуса с пресетами анимации Drift, Breathing и None.
+
+<Heading>Ломающие изменения</Heading>
+
+**ChipSuggest / Dropdown / MultiselectField.Dropdown / SelectExtendedField.Dropdown / Suggest**
+
+- Prop `mobileViewProps` переименован в `pullerProps` (тип `Omit<IPullerProps, "opened" | "setOpened">`), поведение прежнее. Переименование распространяется на props, унаследованные от `IDropdownProps`: `IMultiselectFieldDropdownProps`, `ISelectExtendedFieldDropdownProps`, `ISuggestDropdownProps`, `dropdownProps` у `ChipSuggest`.
+- CSS-класс блокировки скролла на `body` у десктопного меню переименован: `.dropdownDesktopOverflowHidden` → `.dropdownDesktopScrollLock`.
+
+**Puller**
+
+- Компоненты и типы `DropdownMobile*` удалены без алиасов. Замена:
+    - `DropdownMobile` → `Puller`, `DropdownMobileHeader` → `PullerHeader`, `DropdownMobileBody` → `PullerBody`, `DropdownMobileFooter` → `PullerFooter`, `DropdownMobileClose` → `PullerClose`, `DropdownMobileLoader` → `PullerLoader`, `DropdownMobileInput` → `PullerInput`, `DropdownMobileMaskedInput` → `PullerMaskedInput`, `DropdownMobileList` → `PullerList`, `DropdownMobileListItem` → `PullerListItem`;
+    - типы `IDropdownMobile*Props` → `IPuller*Props`, `IDropownMobileLoaderProps` → `IPullerLoaderProps`;
+    - `DropdownMobileInner` — без замены, используйте `Puller`;
+    - `IDropdownMobileHeaderProps` перенесён из `components/Tooltip/types` в `components/Puller/PullerHeader` под именем `IPullerHeaderProps`;
+    - deep-импорты `components/Dropdown/mobile/DropdownMobile*` нужно заменить на `components/Puller/Puller*`.
+- Группы дизайн-токенов `DropdownMobile` и `DropdownMobileList` переименованы в `Puller` и `PullerList`, ключ `DropdownMobile.Content_Background` — в `Puller.Body_Background`.
+- CSS-классы `.dropdownMobile*` переименованы в `.puller*`, кроме `.dropdownMobileContent` → `.pullerBody`, `.dropdownMobileBodyOverflow` → `.pullerScrollLock` и `.controlButtons` → `.pullerHeaderControls`. Модификатор `.closing` удалён.
+
+<Heading>Изменения</Heading>
+
+**CarouselNextButton**
+
+- Проведён AI-рефакторинг.
+
+**CarouselPrevButton**
+
+- Проведён AI-рефакторинг.
+
+**CarouselViewport**
+
+- Проведён AI-рефакторинг.
+- Исправлено: если `Carousel` перерисовывался во время свайпа (например, после изменения размеров), переход выполнялся по состоянию на начало жеста.
+- Исправлено: `onTouchStart` не вызывался, если в событии не было `targetTouches`.
+- Изменено: до выбора направления жеста (первые 5 px) лента не сдвигается и не блокирует прокрутку страницы.
+- Исправлено: касание карусели во время анимации перехода обрывало анимацию, и лента сразу оказывалась в конечной позиции.
+
+**Dropdown**
+
+- Исправлено: закрытие одного из открытых десктопных меню снимало блокировку скролла страницы, хотя другое меню оставалось открытым.

package/bundle/release-notes/1.54.0.mdx

@@ -0,0 +1,45 @@
+import { Meta, Title, Heading } from "@storybook/addon-docs/blocks";
+
+<Meta title="release-notes/v1/1.54.0" />
+
+<Title>v1.54.0</Title>
+
+<Heading>Ломающие изменения</Heading>
+
+**Puller**
+
+- `Puller` сам рендерится через `Portal`, по умолчанию в `document.body`. Что проверить:
+    - обёртку `<Portal container={document.body}>` можно убрать;
+    - если шторка обёрнута в `Portal` с другим контейнером, передайте этот контейнер в новый prop `renderContainer`;
+    - если шторка рендерилась без `Portal`:
+        - внутри элемента с классом темы — передайте этот элемент в `renderContainer`;
+        - нативные проверки вида `parent.contains(event.target)` (например, свой обработчик клика снаружи) считают клик по шторке внешним;
+        - CSS-селекторы, завязанные на родителя (вида `.my-container .pullerWrapper`), к ней не применяются.
+
+<Heading>Изменения</Heading>
+
+**ChipSelect / ChipSelectTarget**
+
+- Проведён AI-рефакторинг `ChipSelectTarget`.
+- Исправлено: при `disabled` и выбранном значении кнопка очистки оставалась доступной с клавиатуры и сбрасывала значение.
+
+**ChipSuggest / ChipSuggestTarget**
+
+- Проведён AI-рефакторинг `ChipSuggestTarget`, добавлен `displayName`.
+- Исправлено: `onKeyDown` (в том числе `ChipSuggest.targetProps.onKeyDown`) вызывался только для Enter / Space, остальные клавиши до обработчика не доходили.
+- Исправлено: при `disabled` и выбранном значении кнопка очистки оставалась доступной с клавиатуры и сбрасывала значение.
+
+**Dropdown / MultiselectField.Dropdown / SelectExtendedField.Dropdown**
+
+- Добавлено: мобильную версию можно отрендерить в свой контейнер через `pullerProps.renderContainer`.
+
+**MultiselectField / SelectExtendedField.Target / SelectField**
+
+- Исправлено: Enter / Space на кнопке очистки, `HelpBox`, кнопках тегов в значении и других фокусируемых элементах внутри поля открывали выпадающий блок вместо нажатия на элемент. `stopPropagation` в `onKeyDown` тегов `MultiselectField` для этого больше не нужен.
+- Исправлено: клик по `HelpBox`, кнопкам тегов в значении и другим фокусируемым элементам внутри поля, а также события из их Tooltip переключали выпадающий блок.
+- Изменено: `ArrowDown` / `ArrowUp` открывают выпадающий блок, только когда фокус на самом поле, а не на вложенном элементе.
+- Изменено: `onClear` получает событие клика (`React.MouseEventHandler<HTMLButtonElement>`).
+
+**Tooltip**
+
+- Рефакторинг `TooltipMobile` без изменений поведения.

package/bundle/release-notes/1.55.0.mdx

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