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

package/bundle/components/DocumentNumberEdit.md

@@ -1,9 +1,7 @@
 ---
 component: DocumentNumberEdit
-category: Form
-figma-node: ""
-figma-file: ""
-related: [SmallInput, Link, Typography]
+category: TextFields
+related: [SmallInput, Link, Text]
 tokens: []
 stories: stories/DocumentNumberEdit/DocumentNumberEdit.stories.tsx
 version: "1.0"
@@ -13,263 +11,194 @@ version: "1.0"
 
 ## Назначение
 
-Инлайн-виджет "номер документа" в режиме **просмотра** (подпись + текст)
-/ **редактирования** (SmallInput c числовой маской). Используется
-типично в формах создания документов, где номер по умолчанию
-присваивается автоматически, но пользователь может его изменить.
+Инлайн-редактирование номера документа: строка с подписью («Документ № 123456» или текст об
+автоматическом присвоении) и ссылка-переключатель рядом. По клику по ссылке подпись сжимается до
+`numberLabel`, а на её месте появляется `SmallInput` с автофокусом, который принимает только цифры.
+Редактирование завершается по Enter или по потере фокуса. Значение компонент не хранит: он
+контролируемый — `value` и `onChange` ведёт потребитель.
 
-Три состояния:
-1. **Нет значения + не в режиме edit** — текст `emptyNumberLabel` +
-   ссылка `emptyNumberButtonLabel` ("Задать номер").
-2. **Есть значение + не в режиме edit** — текст `{numberLabel} {value}`
-   + ссылка `buttonLabel` ("Изменить").
-3. **В режиме edit** — текст `numberLabel` + SmallInput (цифры, ≤6
-   символов).
+Используй когда: в шапке документа или в плотной вёрстке нужно показать номер и дать его
+поправить на месте, без открытия формы и без модального окна.
 
-Используй когда: форма документа с редактируемым номером и placeholder-логикой.
-Не используй для: произвольного числового поля — бери `SmallInput` или
-`NumberField`.
+Не используй когда:
 
----
-
-## Файловая структура
-
-```text
-src/components/DocumentNumberEdit/
-├── DocumentNumberEdit.tsx                  # FC, НЕ forwardRef
-├── index.ts                                # Barrel
-└── styles/DocumentNumberEdit.module.less   # .label (inline-block + 8px right), .inputEditWrapper (68px)
-```
-
-Особенности:
-- **НЕ `forwardRef`** — FC. Известный AI-ready debt.
-- **Внутренний state `editingMode`** — компонент сам управляет
-  переключением "просмотр ↔ редактирование". Внешнего управления нет.
-- **`value`** — controlled-only (без defaultValue).
-- **Нет `__tests__`** — покрытие через `SmallInput`-тесты косвенно.
-- **Нет `data-tx`** — не ставит атрибут версии.
+- Поле живёт в форме и ему нужны лейбл, статус (error/warning), описание или счётчик — возьми
+  `TextField`.
+- Нужен просто компактный `<input>` без подписи и переключения режимов — возьми `SmallInput`,
+  на котором `DocumentNumberEdit` и построен.
+- Номер длиннее 6 символов или содержит не только цифры (серия, префикс, разделители):
+  `maxLength` ограничен литералами `0…6`, а нецифровые символы компонент вырезает молча.
+- Нужно управлять режимом редактирования снаружи (открыть программно, запретить выход,
+  показать кнопки «Сохранить»/«Отмена»): режим — внутренний state без props и колбэков.
 
 ---
 
 ## Варианты и props
 
-### `IDocumentNumberEditProps extends ISmallInputProps`
-
-**DocumentNumberEdit-specific:**
-
-| Prop | Тип | Default | Описание |
-|---|---|---|---|
-| `value` | `React.ReactText` (`string \| number`) | — | Текущий номер. Falsy → empty-state. |
-| `numberLabel` | `string` | — (обязателен) | Префикс текста в view-mode ("Документ №"). |
-| `emptyNumberLabel` | `string` | — (обязателен) | Полный текст в empty-state ("Номер документа будет присвоен автоматически"). |
-| `buttonLabel` | `string` | — (обязателен) | Текст ссылки в view-mode ("Изменить"). |
-| `emptyNumberButtonLabel` | `string` | — (обязателен) | Текст ссылки в empty-state ("Задать номер"). |
-| `maxLength` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | `6` | Максимум цифр. Влияет на `placeholder` (`"0"*maxLength`) и `SmallInput.maxLength`. |
-
-**Остальные:** все пропсы `ISmallInputProps` (включая `onChange`,
-`onBlur`, `onKeyDown`, `className`, `...`).
-
-### `labelText` — вычисляемый
-
-```ts
-const labelText = useMemo(() => {
-    if (editingMode) return numberLabel;        // только "Документ №"
-    if (value) return `${numberLabel} ${value}`; // "Документ № 12345"
-    return emptyNumberLabel;                     // "Номер ... будет присвоен автоматически"
-}, [value, numberLabel, emptyNumberLabel, editingMode]);
-```
-
----
-
-## Ключевые особенности реализации
-
-### State `editingMode` — внутренний uncontrolled switch
-
-```ts
-const [editingMode, setEditingMode] = useState(false);
-```
-
-**Включается:** клик по ссылке (`handleButtonClick`, `preventDefault()`).
-**Выключается:** Enter в input (`handleInputKeyDown`) или blur input
-(`handleInputBlur`).
-
-**Нет `controlled` варианта** — потребитель не может извне открыть
-редактирование. Если нужно — оборачивать в свою логику.
-
-### Фильтрация цифр + сохранение позиции курсора
-
-```ts
-const handleInputChange = (event) => {
-    const caret = getCaretPosition(event.target);
-    const value = getFilteredValue(event.target.value);
-    const caretShift = value.length - event.target.value.length;
-
-    event.target.value = value;
-    setCaretPosition(event.target, caret + caretShift);
-
-    onChange?.(event);
-};
-
-const getFilteredValue = (value: string) => {
-    const buffer: string[] = [];
-    for (let i = 0; i < value.length; i++) {
-        if (StringUtils.isDigit(value[i])) buffer.push(value[i]);
-    }
-    return buffer.join("");
-};
-```
-
-**Зачем `caretShift`:** если пользователь вставил "12a3" → фильтр
-вернёт "123", длина уменьшилась на 1. Курсор должен сдвинуться на `-1`
-относительно момента вставки, чтобы остаться на правильном месте.
-Без этого курсор "прыгнет" в конец.
-
-**`StringUtils.isDigit`** — проверка по регулярке (0-9). Не
-поддерживает юникод-цифры, только ASCII.
-
-**Мутация `event.target.value` напрямую** — это анти-паттерн, но
-React принимает это, так как мы работаем с uncontrolled SmallInput
-под капотом (controlled через onChange). Вариант: принять внешний
-onChange(filteredValue), но тогда `value` не обновится моментально
-до ре-рендера.
+`IDocumentNumberEditProps` наследует `ISmallInputProps` (то есть
+`React.InputHTMLAttributes<HTMLInputElement>`), поэтому принимает все атрибуты `<input>`.
 
-### `autoFocus={true}` на SmallInput
+### Обязательные props
 
-При переключении в edit-mode input появляется **с фокусом**. Важно
-для UX — пользователь кликнул "Изменить" и сразу может вводить.
+| Prop | Тип | Описание |
+|---|---|---|
+| `numberLabel` | `string` | Текст перед номером («Документ №»). В режиме просмотра склеивается с `value` через пробел, в режиме редактирования остаётся один |
+| `buttonLabel` | `string` | Текст ссылки-переключателя, когда номер задан («Изменить») |
+| `emptyNumberButtonLabel` | `string` | Текст ссылки-переключателя, когда номера нет («Задать номер») |
+| `emptyNumberLabel` | `string` | Текст вместо подписи с номером, когда номера нет («Номер документа будет присвоен автоматически») |
 
-### Ссылка — `Link` с `href="#"` + preventDefault
+Все четыре текста обязательны и **дефолтов не имеют** — библиотека мультиязычная, строки в неё
+не зашиты. Значения в скобках — примеры из stories, а не значения по умолчанию.
 
-```tsx
-<Link href="#" onClick={handleButtonClick}>
-    {value ? buttonLabel : emptyNumberButtonLabel}
-</Link>
-```
-
-**`href="#"`** — чтобы ссылка была "настоящей" (правильный фокус,
-подчёркивание). `preventDefault` в обработчике клика предотвращает
-прыжок страницы наверх.
-
-**Альтернатива — `<button>`**, но дизайн требует ссылочного вида.
-Компромисс: семантика button + визуал Link.
+### Опциональные props
 
-### Выход из edit-mode: Enter или blur
-
-```ts
-if (isKey(event.code, "ENTER")) setEditingMode(false);
-// + onBlur → setEditingMode(false)
-```
+| Prop | Тип | По умолчанию | Описание |
+|---|---|---|---|
+| `value` | `React.ReactText` (`string \| number`) | — | Номер документа. Тип сужен относительно `<input>`: `readonly string[]` не принимается |
+| `maxLength` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | `6` | Максимальная длина ввода. Из неё же строится плейсхолдер — маска из нулей той же длины (`6` → `000000`) |
+| `className` | `string` | — | Мерджится через `clsx` на корневой `<div>` |
+| `onChange` | `React.ChangeEventHandler<HTMLInputElement>` | — | Вызывается уже после фильтрации: в `event.target.value` лежат только цифры |
+| `onKeyDown` | `React.KeyboardEventHandler<HTMLInputElement>` | — | Вызывается после внутренней обработки Enter |
+| `onBlur` | `React.FocusEventHandler<HTMLInputElement>` | — | Вызывается после выхода из режима редактирования |
+| `...InputHTMLAttributes` | — | — | Уходят на `SmallInput` через `...rest` — **только в режиме редактирования** |
 
-**Esc не выходит** — это UX-решение. Если нужно — потребитель может
-сам обработать в `onKeyDown` и програмно вызвать blur.
+### Что считается «номер задан»
 
-### Placeholder — `"0".repeat(maxLength)`
+Проверка — на правдивость `value`, а не на `undefined`: при `value={0}`, `value=""` и
+`value={undefined}` компонент одинаково показывает `emptyNumberLabel` и
+`emptyNumberButtonLabel`, а в поле ввода подставляет пустую строку. Числовой ноль как номер
+документа не поддерживается.
 
-`inputPlaceholder = "0".repeat(maxLength)` → "000000" для maxLength=6.
-Визуально показывает сколько символов ожидается. Меняется с maxLength.
+### Фильтрация и курсор
 
-### Ширина input — 68px (hardcoded)
+`onChange` перехватывается: из значения вырезаются все нецифровые символы
+(`StringUtils.isDigit`), отфильтрованное значение записывается прямо в `event.target.value`, а
+курсор сдвигается на разницу длин — чтобы вставка `12ab34` в середину не уводила курсор в конец.
+Потребитель получает уже очищенное значение, и любая своя валидация работает поверх цифр.
 
-```less
-.inputEditWrapper { width: 68px; }
-```
+### Контролируемость
 
-**Hardcoded** и рассчитана под 6 цифр в SmallInput. Если изменить
-`maxLength`, input может не помещать значение — 68px могут быть
-слишком широки или узки. **Потребители с кастомным maxLength ≠ 6
-должны переопределять ширину через className/style на wrapper**
-(но wrapper — внутренний, override невозможен без хака).
+В поле ввода всегда уходит `value || ""`, то есть `<input>` контролируемый. Если потребитель не
+обновляет `value` в `onChange`, ввод визуально не применяется. Остальные props для этого сценария
+(`defaultValue`, `readOnly`) не запрещены, но противоречат схеме контролируемого поля.
 
-**Это известное ограничение**: компонент заточен под 6-значный номер.
+### Режим редактирования
 
-### `inline-block` разметка
+Режим — внутренний `useState`, наружу не выведен: нет ни prop'а, ни колбэка на вход/выход. Вход —
+только клик по ссылке, выход — Enter (по `event.code`) или потеря фокуса. Escape не обрабатывается,
+отката значения нет: всё, что потребитель успел записать в свой state, остаётся. `...rest`
+доходит только до поля ввода, поэтому `disabled` ссылку-переключатель не выключает: вход в режим
+редактирования остаётся доступен, а выйти из него уже нельзя — disabled-поле не получает фокус
+(`autoFocus` становится no-op), поэтому ни `blur`, ни Enter не срабатывают, ссылка в этом режиме
+не рендерится, и номер остаётся скрытым. Передавать `disabled` этому компоненту бессмысленно:
+запрета редактирования он не даёт, а даёт тупиковое состояние.
 
-```less
-.label { display: inline-block; margin-right: 8px; }
-.inputEditWrapper { width: 68px; display: inline-block; }
-```
+---
 
-Label и кнопка/input стоят **в одну строку** (inline-block). Без
-grid/flex. Это требование дизайна — "в одну строку".
+## Дизайн-токены
 
-### Рендер: всегда label + один из (renderButton / renderInput)
+Собственных токенов у компонента нет: `styles/DocumentNumberEdit.module.less` задаёт только
+раскладку — `display: inline-block` и `margin-right: 8px` на классе `.label` (он навешан и на
+подпись, и на обёртку ссылки, поэтому правка отступа затронет оба элемента),
+`display: inline-block` и `width: 68px` на обёртке поля (под шесть цифр). Самому корневому `<div>` стили ничего не
+выставляют. Цвета и типографика приходят из вложенных компонентов и переопределяются через их
+группы токенов (`ThemeProvider`, prop `tokens` — см. `ThemeProvider-ai.md`):
 
-```tsx
-<div className={styles.documentNumberEdit}>
-    <Text className={styles.label}>{labelText}</Text>
-    {editingMode ? renderInput() : renderButton()}
-</div>
+```text
+SmallInput.Background
+SmallInput.Color
+SmallInput.PlaceholderColor
+SmallInput.Shadow
+Link.Text_Color_Default
+Link.Text_Color_Hover
+Link.Text_Color_Active
+Link.BorderColor_Focus
 ```
 
-**Без анимации перехода** — моментальная замена.
+Подпись и обёртку ссылки рендерит `Text` (`ETextSize.B3`, `EFontType.SECONDARY`): размер и цвет
+подписи — из токенов типографики. Цвет самого текста ссылки задаёт `Link` своими токенами
+(`Link.Text_Color_*` стоят на `.link` и перебивают унаследованный от `Text` цвет), поэтому
+перекрашивать переключатель нужно через группу `Link`, а не через типографику.
 
 ---
 
 ## Инварианты
 
-- **`editingMode` — внутренний state**. Нет controlled-варианта.
-- **`value` — controlled only** (через проп). Нет defaultValue.
-- **`maxLength: 0..6`** — жёсткое ограничение в типе. Расширять только
-  с обновлением `.inputEditWrapper.width` в LESS.
-- **Фильтрация только ASCII-цифр** через `StringUtils.isDigit`.
-- **`caretShift` в `handleInputChange`** — не удалять. Сохраняет
-  позицию курсора при фильтрации.
-- **Ссылка `Link href="#" + preventDefault`** — семантичная кнопка
-  визуально, без button-стилей. Не заменять на button без
-  дизайн-согласования.
-- **Enter и blur выходят из edit-mode**, Esc — нет. Не менять.
-- **Placeholder = "0".repeat(maxLength)** — генерируется из maxLength.
-- **`autoFocus=true`** на SmallInput — обязателен для UX.
-- **`.inputEditWrapper` 68px** — hardcoded под 6 цифр.
-- **НЕТ forwardRef** — известный debt.
-- **НЕТ `data-tx`** — наследованный пропуск.
+- **`forwardRef<HTMLDivElement>`** — не убирать. `ref` указывает на корневой
+  `<div class="documentNumberEdit">`, **не** на поле ввода: поле существует только в режиме
+  редактирования. Доступ к `<input>` по ref не предусмотрен.
+- **Корневой элемент — `<div>`** с двумя детьми: подпись (`Text`) и либо обёртка поля
+  (`div.inputEditWrapper` → `SmallInput`), либо ссылка (`Text` → `Link`). Сам корень — обычный
+  блок и в строку текста не встраивается; в строку выстроены его дети (оба `inline-block`).
+  Смена тега сломает эту вёрстку и ref-контракт (`ref` типизирован как `HTMLDivElement`).
+- **`displayName`** — `"DocumentNumberEdit"`. Не менять.
+- **Имена `DocumentNumberEdit`, `IDocumentNumberEditProps`** и все четыре текстовых props —
+  публичный API, экспортируются из barrel `src/components/DocumentNumberEdit/index.ts`.
+- **Обязательность `buttonLabel`, `emptyNumberButtonLabel`, `emptyNumberLabel`, `numberLabel`** —
+  часть публичного контракта. Сделать их опциональными с дефолтными русскими строками нельзя:
+  это и изменение API, и хардкод языка в мультиязычной библиотеке.
+- **Тип `maxLength` — литеральный union `0…6`**, сужение относительно `number` у `<input>`.
+  Расширение или сужение диапазона — ломающее изменение.
+- **Фильтрация до цифр и перезапись `event.target.value` до вызова `onChange`** — наблюдаемое
+  поведение, на него опираются потребители. Порядок «отфильтровать → выставить курсор →
+  вызвать `onChange`» менять нельзя.
+- **Плейсхолдер выводится из `maxLength`** (`"0".repeat(maxLength)`), отдельного prop'а нет.
+- **`autoFocus` на поле ввода** — обязателен: без него переход в режим редактирования требовал бы
+  второго клика.
+- **Ширина `inputEditWrapper` 68px** рассчитана на шесть цифр шрифтом B3. При меньшем `maxLength`
+  поле не сжимается.
 
 ---
 
 ## Accessibility
 
-- **Link с href="#"** — семантически ссылка, обнаруживается screen
-  reader'ом, фокусируется Tab'ом. Минус — href="#" может быть
-  нежелательным для SEO (не актуально для form-виджетов).
-- **Input** — SmallInput со своими ARIA (`aria-label` если передан
-  через `...rest`).
-- **Transition между view/edit** — визуальный, не объявляется screen
-  reader'у отдельно. Пользователь видит / слышит новую разметку.
-- **Нет live-region** — если input появился асинхронно (а не по
-  клику), screen reader может пропустить. В текущем сценарии это
-  реакция на клик, поэтому не критично.
-- **Placeholder "000000"** — может сбить с толку, если пользователь
-  читает screen reader'ом. Лучше полагаться на `aria-label` через
-  rest.
-
----
-
-## Дизайн-токены
-
-**Нет собственных.** Все стили от `SmallInput`, `Link`, `Typography.Text`.
+- Переключатель режима — `Link` (`<a href="#">` с `preventDefault`), то есть скринридер
+  объявляет его ссылкой, а не кнопкой. Заменить роль снаружи нельзя: props до `Link` не доходят.
+  С клавиатуры ссылка доступна (Tab + Enter), но это остаётся ссылкой-заглушкой.
+- **Доступное имя поля ввода обязан задать потребитель** — `aria-label` или `aria-labelledby`
+  уходят на `SmallInput` через `...rest`. Видимая подпись «Документ №» с полем программно не
+  связана: `<label htmlFor>` компонент не рендерит и `id` не генерирует.
+- Фокус при входе в режим редактирования уходит в поле (`autoFocus`). При выходе по Enter поле
+  размонтируется, и фокус **не возвращается** на ссылку — он оказывается на `<body>`. Если
+  компонент стоит в клавиатурном сценарии, верни фокус сам или ориентируй пользователя на выход
+  по Tab.
+- Escape не обрабатывается: отменить правку клавиатурой нельзя, выход по Escape не предусмотрен.
+- Смена режима ничего не анонсирует: `aria-live` области нет, изменение подписи скринридер сам
+  не озвучит.
+- Компонент не хардкодит текстовые строки: все подписи и любые `aria-*` приходят из props.
 
 ---
 
 ## Связанные компоненты
 
-- `SmallInput` (`src/components/SmallInput`) — input в edit-mode.
-- `Link` (`src/components/Link`) — кнопка-ссылка.
-- `Typography.Text` — label перед номером.
-- `NumberField` — альтернатива для более "обычных" числовых полей
-  (без specific "edit / view" UX).
+- `SmallInput` (`src/components/SmallInput/SmallInput.tsx`) — поле ввода, которое рендерится в
+  режиме редактирования, и источник типа props: `IDocumentNumberEditProps extends ISmallInputProps`.
+  `DocumentNumberEdit` фиксирует у него `value`, `placeholder`, `maxLength`, `autoFocus` и все три
+  обработчика — переопределить их через `...rest` нельзя, они стоят после спреда.
+- `Link` (`src/components/Link/Link.tsx`) — ссылка-переключатель режима. `DocumentNumberEdit`
+  передаёт ей только `href="#"` и свой `onClick`; настроить её из props потребителя нельзя.
+- `Text` (`src/components/Typography/Text.tsx`) — рендерит и подпись, и обёртку ссылки
+  (`tag="div"`, `ETextSize.B3`, `EFontType.SECONDARY`). Типографику компонента менять можно только
+  здесь.
+- `TextField` — альтернатива для полноформатного поля в форме (лейбл, статусы, описание,
+  счётчик), когда инлайн-редактирования недостаточно.
 
 ---
 
 ## Stories
 
-`stories/DocumentNumberEdit/DocumentNumberEdit.stories.tsx`
-Примеры: `stories/DocumentNumberEdit/examples/`
+Основные истории: `stories/DocumentNumberEdit/DocumentNumberEdit.stories.tsx`
+Файлы примеров: `stories/DocumentNumberEdit/examples/`
+
+| Story | Example file | Что демонстрирует |
+|---|---|---|
+| `Playground` | `PlaygroundExample.tsx` | Интерактивный контроль всех четырёх текстов и `maxLength` на контролируемом значении |
+| `Default` | `DefaultExample.tsx` | Минимальное использование: контролируемое значение в state потребителя |
+| `VisualTests` | `VisualTestsExample.tsx` | Скриншот-регрессия: пустой номер и заполненный номер, у первого `play` открывает режим редактирования |
 
-Типовые stories:
-- `Default` — с числом
-- `Empty` — без числа (empty-state UI)
-- `MaxLengths` — разные длины
-- `Playground` — интерактив
+Story ID участвуют в именах baseline-скриншотов (`documentnumberedit--default--xs.png`,
+`documentnumberedit--visual-tests--xl.png`), поэтому переименование story требует перегенерации
+baseline и удаления осиротевших файлов.
 
 ---
 
@@ -277,4 +206,34 @@ grid/flex. Это требование дизайна — "в одну стро
 
 | Дата | Изменение |
 |---|---|
-| 2026-04-18 | Создан документ |
+| 2026-09-29 | Создан документ (TRI-34). AI-рефакторинг: компонент переведён с `React.FC` на `forwardRef` (`ref` идёт на корневой `<div>`), фильтрация цифр вынесена в модульную функцию, `renderInput`/`renderButton` заменены на JSX в `return`, снят лишний `useMemo` с подписи, JSDoc на props перестал обещать несуществующие дефолты. Добавлены unit-тесты (`__tests__/DocumentNumberEdit.test.tsx`). Публичный API не изменён |
+
+---
+
+## Примеры использования
+
+### Default
+
+`stories/DocumentNumberEdit/examples/DefaultExample.tsx`
+
+```tsx
+import React, { useState } from "react";
+import { DocumentNumberEdit } from "@sberbusiness/triplex-next";
+
+export const DefaultExample = () => {
+    const [value, setValue] = useState("");
+    const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => setValue(event.target.value);
+
+    return (
+        <DocumentNumberEdit
+            value={value}
+            buttonLabel="Изменить"
+            emptyNumberButtonLabel="Задать номер"
+            emptyNumberLabel="Номер документа будет присвоен автоматически"
+            numberLabel="Документ №"
+            onChange={handleChange}
+        />
+    );
+};
+```
+

package/bundle/components/Dropdown.md

@@ -1,7 +1,7 @@
 ---
 component: Dropdown
 category: Dropdown
-related: [ButtonDropdown, ButtonDropdownExtended, Portal, MobileView, OverlayBase, SelectField, SelectExtendedField, SuggestField, MultiselectField, TabsLine]
+related: [ButtonDropdown, ButtonDropdownExtended, Portal, MobileView, LoaderSmall]
 tokens:
   - Dropdown.Background
   - Dropdown.Shadow
@@ -181,6 +181,14 @@ DropdownMobileList.Selected_Background
 - `Portal`, `MobileView`, `OverlayBase` — инфраструктура рендера.
 - `ButtonDropdown`, `ButtonDropdownExtended` — готовые кнопки с выпадающим блоком поверх `Dropdown`.
 
+**Потребители внутри библиотеки** (в `related` не входят — по `docs/ai/CONTEXT.md` ссылка
+стоит с их стороны, и она там уже есть):
+
+- `SelectExtendedField` — база полей выбора: владеет состоянием открытости и рендерит `Dropdown`.
+- `SelectField`, `MultiselectField` — поля выбора одного и нескольких значений, построены на `SelectExtendedField`.
+- `SuggestField` — поле с поиском по вводу; собрано на `Dropdown` напрямую, а не на `SelectExtendedField`.
+- `TabsLine` — прячет не поместившиеся вкладки в `Dropdown`.
+
 ---
 
 ## Stories
@@ -210,6 +218,8 @@ DropdownMobileList.Selected_Background
 | 2026-07-31 | Создан документ AI-ready для `Dropdown` (TRI-35). |
 | 2026-07-31 | AI-рефакторинг: `DropdownList` больше не создаёт ref через `React.createRef()` в рендере (из-за этого автопрокрутка к активному элементу не работала), сброс активного элемента при открытии переведён на корректировку state в рендере вместо `setState` в эффекте, прокрутка вынесена в `desktop/utils.ts`, в `DropdownListItem` починен устаревший обработчик клавиатуры, в `Dropdown` актуальные `onOpen` / `onClose` хранятся в ref. Публичный API не изменён. Добавлены unit-тесты (109 кейсов) и stories. |
 | 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 и поведение не затронуты. |
 
 ---