@sberbusiness/triplex-next-mcp-server 1.53.0 → 1.54.0

package/README.md

@@ -45,6 +45,7 @@ MCP-сервер для дизайн-системы Triplex. Предостав
 | `get_tokens(component?, group?)`                          | Дизайн-токены: индекс групп, токены компонента или группа целиком — с путями `Группа.Токен` и значениями тем                                                                                     |
 | `list_icons(query?, size?, limit?)`                       | Иконки из `@sberbusiness/icons-next` с фильтрами по подстроке в имени и размеру (защита от галлюцинаций имён)                                                                                    |
 | `get_guidelines`                                          | Гайдлайны кодогенерации на Triplex для ИИ-агентов (правила `TPX-G-NN` из `docs/mcp/guidelines.md` triplex-next)                                                                                  |
+| `get_release_notes(version?)`                             | Release notes указанной версии Triplex в исходном MDX. Без аргументов используется версия bundle.                                                                                                |
 
 Флаг `ai_ready: true` означает, что у компонента есть полноценная AI-документация
 (`*-AI.md` с frontmatter, секциями и примерами). Для остальных компонентов сервер
@@ -130,6 +131,12 @@ bundle/
 которая тянет `@sberbusiness/icons-next` с jsdelivr и собирает список имён
 экспортов с размерами.
 
+## Публикация MCP-сервера
+
+`sync-bundle.yml` ежедневно проверяет последний стабильный релиз triplex-next,
+синхронизирует bundle и выпускает стабильную версию MCP с тем же номером.
+`release.yml` собирает пакет с тега, публикует его в npm и прикладывает архив к GitHub Release.
+
 ## Лицензия
 
 MIT

package/bundle/components/ChipSelect.md

@@ -49,7 +49,7 @@ version: "1.0"
 | Prop | По умолчанию | Назначение и ограничения |
 |---|---|---|
 | `type` | `EChipType.TYPE_1` | Визуальный тип `TYPE_1` / `TYPE_2` передаётся в `ChipSelectTarget`. |
-| `disabled` | `false` | Убирает target из tab-порядка и блокирует pointer-события стилями `Chip`; ограничения см. в Accessibility. |
+| `disabled` | `false` | Убирает target из tab-порядка, блокирует pointer-события стилями `Chip` и отключает кнопку сброса; ограничения см. в Accessibility. |
 | `onOpen`, `onClose` | — | Уведомления о смене открытости без аргументов. На первом рендере не вызываются. |
 | `closeOnTab` | `false` | Наследуется от `SelectExtendedField` и закрывает список при всплывающем Tab, в том числе из dropdown. Сам target закрывает список по Tab независимо от этого флага. |
 | `className`, HTML-атрибуты | — | Передаются корневому `<div>` `SelectExtendedField`, не вложенному чипсу. |
@@ -63,7 +63,7 @@ version: "1.0"
 
 Унаследованный `dropdownProps` присутствует в типе, но текущая реализация не
 передаёт его в `SelectExtendedFieldDropdownDefault`. Не используй его для настройки
-списка. Не меняй это поведение в рамках документирования без отдельной задачи.
+списка.
 
 ---
 
@@ -114,8 +114,9 @@ version: "1.0"
   `aria-controls` / `aria-activedescendant`. Переданный `aria-label` или
   `aria-labelledby` попадает на корневой `<div>`, не на target: не считай его
   заменой видимого названия чипса.
-- `disabled` задаёт класс и `tabIndex={-1}` на `Chip`. Это не нативный `disabled`:
-  программно отправленные события не защищены проверкой флага в обработчиках.
+- `disabled` задаёт класс и `tabIndex={-1}` на `Chip` и нативный `disabled` на кнопку
+  сброса. Сам target — не нативная кнопка: программно отправленные события
+  не защищены проверкой флага в обработчиках.
   Не используй такое состояние как защиту бизнес-логики.
 - В selected-состоянии вложена нативная `ChipClearButton`; Enter и Space на ней
   не всплывают в обработчик открытия target. Доступное имя кнопки сброса текущая
@@ -129,7 +130,7 @@ version: "1.0"
 ## Связанные компоненты
 
 - `Chip` — базовый компонент семейства, стили размеров, типов и выбранного состояния.
-- `ChipSelectTarget` — самостоятельный публичный target с кнопкой сброса, стрелкой
+- [ChipSelectTarget](ChipSelectTarget-ai.md) — самостоятельный публичный target с кнопкой сброса, стрелкой
   и обработкой клавиатуры; рендерится внутри `ChipSelect`.
 - `ChipMultiselect` — альтернатива для нескольких значений и собственного dropdown-контента.
 - `SelectExtendedField` — рендерится внутри, владеет открытостью и корневым ref.
@@ -167,6 +168,7 @@ version: "1.0"
 | 2026-10-19 | Создан документ (TRI-131): описаны управляемый выбор, граница наследуемых props, токены и существующие accessibility-ограничения; собственные props оформлены JSDoc, дополнены unit-тесты контракта. |
 | 2026-10-19 | Удалена ссылка на задачу об ограничении доступности, сохранён номер TRI-139. |
 | 2026-10-21 | Переход на `Puller` (TRIPLEX-961): на мобильной ширине список открывается в нижней шторке `Puller`. |
+| 2026-11-06 | Исправлено (TRI-0): при `disabled` кнопка сброса отключена и недоступна с клавиатуры. |
 
 ---
 

package/bundle/components/ChipSelectTarget.md

@@ -0,0 +1,388 @@
+---
+component: ChipSelectTarget
+category: Chips
+related: [ChipSelect, ChipSuggestTarget, Chip, SelectExtendedField]
+tokens: []
+stories: stories/Chips/ChipSelect.stories.tsx
+version: "1.0"
+---
+
+# ChipSelectTarget
+
+## Назначение
+
+Публичный управляющий элемент `ChipSelect`: показывает подпись фильтра,
+стрелку списка либо кнопку очистки и запрашивает изменение открытости.
+Собственного состояния, списка опций и логики выбора у target нет.
+
+Используй когда: нужна своя композиция с чипсом и управляемыми `opened` /
+`setOpened`, например через `SelectExtendedField.renderTarget`.
+Для готового фильтра с опциями и мобильным списком используй `ChipSelect`.
+Для target, связанного с контекстом поиска `Suggest`, нужен `ChipSuggestTarget`.
+
+Публичные импорты:
+
+```tsx
+import { ChipSelectTarget, type IChipSelectTargetProps } from "@sberbusiness/triplex-next";
+```
+
+В отличие от `ChipSuggestTarget`, компонент не требует provider: открытость,
+выбранное состояние и подпись полностью задаёт потребитель.
+
+---
+
+## Варианты и props
+
+`IChipSelectTargetProps` расширяет `IChipProps` и добавляет три обязательных prop.
+Точные типы унаследованных атрибутов описаны в исходнике `Chip`.
+
+### Управление
+
+| Prop | Обязательность / по умолчанию | Назначение и ограничения |
+|---|---|---|
+| `opened` | Обязателен | Текущая открытость списка. Управляет стрелкой и исходным `aria-expanded` |
+| `setOpened` | Обязателен | Получает новое логическое значение: клик переключает его, Enter / Space открывают закрытый список, Tab закрывает открытый |
+| `onClear` | Обязателен | Вызывается без аргументов встроенной кнопкой очистки. Потребитель сбрасывает своё значение, `selected` и подпись |
+| `selected` | `false` | Управляемое оформление выбора. При `true` вместо стрелки появляется очистка |
+| `children` | — | Подпись фильтра или выбранной опции; target не вычисляет и не форматирует её |
+| `onClick` | — | Получает React mouse event после `setOpened(!opened)` |
+| `onKeyDown` | — | Получает все дошедшие до target события клавиатуры после встроенной обработки, кроме Enter / Space на встроенной очистке |
+
+`setOpened` — запрос к потребителю, а не локальный setter компонента. Пока
+потребитель не передаст новый `opened`, ARIA и стрелка сохранят прежнее состояние.
+`onClear` не меняет `selected` и не закрывает список автоматически.
+`preventDefault()` в пользовательском обработчике не отменяет уже сделанный
+запрос изменения открытости.
+
+### Внешний вид и атрибуты
+
+| Prop или группа | По умолчанию | Назначение и ограничения |
+|---|---|---|
+| `size` | `EComponentSize.MD` | SM / MD / LG; передаётся в `Chip`, стрелку и кнопку очистки |
+| `type` | `EChipType.TYPE_1` | Визуальный тип `Chip`: TYPE_1 / TYPE_2 |
+| `disabled` | `false` | Отключает target и встроенную очистку; ограничения — в Accessibility |
+| `prefix` | — | Унаследованный слот перед подписью |
+| `postfix` | Стрелка либо очистка | Переданное значение заменяет автоматический postfix; явно переданный `undefined` тоже заменяет его |
+| `showNotificationIcon` | `false` | Значок `Badge.Dot` через `Chip` |
+| `className`, `style`, `id`, `data-*`, `aria-*`, остальные span-атрибуты | — | Передаются в корневой `<span>`; `className` объединяется с классами `Chip` |
+| `ref` | — | Указывает на корневой `HTMLSpanElement`, не на кнопку очистки или корень селекта |
+
+Spread расположен после `postfix` и `aria-expanded`: потребитель может заменить
+слот или ARIA-атрибут, а также унаследованные `role` / `tabIndex`. Сохраняй их
+согласованность с настоящим состоянием списка. Для слотов действуют правила
+`Chip`: `null` / `false` могут оставить класс отступов без содержимого.
+
+---
+
+## Дизайн-токены
+
+Собственных стилей и токенов у target нет, поэтому `tokens: []`.
+Внешний вид наследуется от `Chip`: см. [Chip-ai.md](Chip-ai.md#дизайн-токены).
+
+---
+
+## Инварианты
+
+- Сохраняются именованные экспорты `ChipSelectTarget` и `IChipSelectTargetProps`
+  через `Chip/ChipSelect/index.ts` и `Chip/index.ts`, имена и типы props.
+- `forwardRef<HTMLSpanElement>` обязателен; корень и ref-target остаются
+  `<span>` `Chip`. `displayName` — `"ChipSelectTarget"`.
+- Открытость управляется только `opened` / `setOpened`; не добавлять локальный
+  state или зависимость от контекста другого селекта.
+- Enter / Space открывают только закрытый список, а не переключают его.
+  Tab закрывает открытый список без отмены стандартного перемещения фокуса.
+- `onClick` вызывается после setter, `onKeyDown` — после встроенной обработки событий, дошедших до target.
+  Очистка вызывает только `onClear()` и останавливает всплытие клика и Enter / Space.
+- `selected` влияет на автоматический postfix, `onClear` не получает DOM-событие.
+- Порядок spread, размеры и типы `Chip`, токены и story IDs сохраняются.
+  Код остаётся совместимым с React 17.
+
+---
+
+## Accessibility
+
+- По умолчанию корень — `<span role="button" tabIndex={0}>`, не combobox.
+  Имя задают `children`, `aria-label` или `aria-labelledby` потребителя.
+- `aria-expanded` отражает `opened`, если не переопределён явно.
+  `aria-controls` и `aria-haspopup` автоматически не создаются.
+- Enter / Space на закрытом target вызывают `preventDefault()` и открывают список.
+  На открытом target они не закрывают список. `Chip` дополнительно отменяет
+  прокрутку страницы на Space. Tab закрывает открытый список, не отменяя Tab.
+- Escape, клики вне списка, навигация по опциям и перенос фокуса принадлежат
+  композиции селекта, а не target. Сам target фокусом не управляет.
+- Встроенная очистка — нативная кнопка: Enter / Space активируют её нативный
+  click и вызывают `onClear`.
+- У встроенной очистки нет доступного имени, отдельного prop для его
+  передачи тоже нет (TRI-139). Для своей именованной очистки доступен `postfix`.
+  Такая кнопка, как и встроенная, должна останавливать всплытие click и keydown
+  Enter / Space: иначе их обработает target, а `preventDefault()` может отменить
+  нативный click кнопки.
+- `disabled` ставит `tabIndex=-1` и CSS `pointer-events: none` на `Chip`
+  и нативный `disabled` на встроенную кнопку очистки. В обработчиках target
+  флаг не проверяется: программно отправленные события не защищены.
+  Не передавай `tabIndex`: он перекрывает `-1`, target снова получит фокус,
+  и Enter / Space откроют список.
+  Пользовательский `postfix` потребитель отключает сам.
+- `selected` сам не задаёт `aria-pressed`. Фокус оформляется через `Chip.Shadow_Focus`.
+
+---
+
+## Связанные компоненты
+
+- [ChipSelect](ChipSelect-ai.md) — готовый родитель: владеет значением через props
+  потребителя, получает открытость от `SelectExtendedField` и рендерит target.
+- [ChipSuggestTarget](ChipSuggestTarget-ai.md) — альтернатива для композиции
+  с `SuggestContext`: читает выбор и открытость из контекста и иначе обрабатывает клавиши.
+- [Chip](Chip-ai.md) — непосредственно рендерится внутри; источник `IChipProps`,
+  span-семантики и всех визуальных состояний.
+- [SelectExtendedField](../SelectExtendedField/SelectExtendedField-ai.md) — предоставляет
+  `opened` / `setOpened` в `renderTarget`.
+- `ChipClearButton` и `ChipDropdownArrow` — автоматические варианты postfix;
+  отдельная кнопка очистки принимает атрибуты `ButtonIcon`, включая `aria-label`.
+
+---
+
+## Stories
+
+Основные истории: `stories/Chips/ChipSelect.stories.tsx`
+Файлы примеров: `stories/Chips/examples/ChipSelect/`
+
+Используются истории родителя: он рендерит этот target.
+Отдельный stories-файл атому не требуется.
+
+| Story | Example file | Что демонстрирует |
+|---|---|---|
+| `Playground` | `PlaygroundExample.tsx` | Тип, размер, подписи и disabled |
+| `Default` | `DefaultExample.tsx` | Подпись, стрелка, выбор и очистка |
+| `Sizes` | `SizesExample.tsx` | SM / MD / LG target |
+| `States` | `StatesExample.tsx` | Selected и disabled |
+| `WithNotificationIcon` | `WithNotificationIconExample.tsx` | Значок у опции списка, не у target; отдельный скриншот-прогон пропущен |
+| `WithCustomDisplayedValue` | `WithCustomDisplayedValueExample.tsx` | Подпись выбранного значения задаёт родитель |
+| `VisualTests` | `VisualTestsExample.tsx` | Выбранные target трёх размеров; play открывает список у unselected target |
+
+У семейства есть Linux/CI baseline на `xs` / `xl` в `__screenshots__/`;
+фокус базового чипса проверяет `VisualTests` в stories `Chip`.
+Контракт target проверяет `src/components/Chip/__tests__/ChipSelectTarget.test.tsx`,
+интеграцию выбора — `ChipSelect.test.tsx`.
+
+---
+
+## История изменений
+
+| Дата | Изменение |
+|---|---|
+| 2026-10-29 | Создан документ. |
+
+---
+
+## Примеры использования
+
+### Default
+
+`stories/Chips/examples/ChipSelect/DefaultExample.tsx`
+
+```tsx
+import React, { useState } from "react";
+import { ChipSelect, EComponentSize, type ISelectFieldOption } from "@sberbusiness/triplex-next";
+
+const demoOptions: ISelectFieldOption[] = [
+    { id: "1", value: "option1", label: "Первая опция" },
+    { id: "2", value: "option2", label: "Вторая опция" },
+    { id: "3", value: "option3", label: "Третья опция" },
+    { id: "4", value: "option4", label: "Четвертая опция" },
+    { id: "5", value: "option5", label: "Пятая опция" },
+    { id: "6", value: "option6", label: "Шестая опция" },
+];
+
+export const DefaultExample = () => {
+    const [selected, setSelected] = useState<ISelectFieldOption | undefined>();
+    return (
+        <ChipSelect
+            label="Select label"
+            size={EComponentSize.MD}
+            options={demoOptions}
+            value={selected}
+            onChange={setSelected}
+            clearSelected={() => setSelected(undefined)}
+        />
+    );
+};
+```
+
+### Sizes
+
+`stories/Chips/examples/ChipSelect/SizesExample.tsx`
+
+```tsx
+import React, { useState } from "react";
+import { ChipSelect, EComponentSize, type ISelectFieldOption } from "@sberbusiness/triplex-next";
+
+const demoOptions: ISelectFieldOption[] = [
+    { id: "1", value: "option1", label: "Первая опция" },
+    { id: "2", value: "option2", label: "Вторая опция" },
+    { id: "3", value: "option3", label: "Третья опция" },
+    { id: "4", value: "option4", label: "Четвертая опция" },
+    { id: "5", value: "option5", label: "Пятая опция" },
+    { id: "6", value: "option6", label: "Шестая опция" },
+];
+
+export const SizesExample = () => {
+    const [selectedSM, setSelectedSM] = useState<ISelectFieldOption | undefined>();
+    const [selectedMD, setSelectedMD] = useState<ISelectFieldOption | undefined>();
+    const [selectedLG, setSelectedLG] = useState<ISelectFieldOption | undefined>();
+
+    return (
+        <div style={{ display: "flex", flexDirection: "column", gap: "24px" }}>
+            <div>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>SM</div>
+                <ChipSelect
+                    options={demoOptions}
+                    value={selectedSM}
+                    onChange={setSelectedSM}
+                    clearSelected={() => setSelectedSM(undefined)}
+                    size={EComponentSize.SM}
+                    label="Select label"
+                />
+            </div>
+            <div>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>MD</div>
+                <ChipSelect
+                    options={demoOptions}
+                    value={selectedMD}
+                    onChange={setSelectedMD}
+                    clearSelected={() => setSelectedMD(undefined)}
+                    size={EComponentSize.MD}
+                    label="Select label"
+                />
+            </div>
+            <div>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>LG</div>
+                <ChipSelect
+                    options={demoOptions}
+                    value={selectedLG}
+                    onChange={setSelectedLG}
+                    clearSelected={() => setSelectedLG(undefined)}
+                    size={EComponentSize.LG}
+                    label="Select label"
+                />
+            </div>
+        </div>
+    );
+};
+```
+
+### States
+
+`stories/Chips/examples/ChipSelect/StatesExample.tsx`
+
+```tsx
+import React, { useState } from "react";
+import { ChipSelect, EComponentSize, type ISelectFieldOption } from "@sberbusiness/triplex-next";
+
+const demoOptions: ISelectFieldOption[] = [
+    { id: "1", value: "option1", label: "Первая опция" },
+    { id: "2", value: "option2", label: "Вторая опция" },
+    { id: "3", value: "option3", label: "Третья опция" },
+    { id: "4", value: "option4", label: "Четвертая опция" },
+    { id: "5", value: "option5", label: "Пятая опция" },
+    { id: "6", value: "option6", label: "Шестая опция" },
+];
+
+export const StatesExample = () => {
+    const [selectedWithValue, setSelectedWithValue] = useState<ISelectFieldOption | undefined>(demoOptions[0]);
+    const [selectedDisabled, setSelectedDisabled] = useState<ISelectFieldOption | undefined>(demoOptions[1]);
+
+    return (
+        <div style={{ display: "flex", flexDirection: "column", gap: "24px" }}>
+            <div style={{ display: "flex", flexDirection: "column", gap: "8px" }}>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>Selected</div>
+                <ChipSelect
+                    label="Select label"
+                    options={demoOptions}
+                    value={selectedWithValue}
+                    onChange={setSelectedWithValue}
+                    clearSelected={() => setSelectedWithValue(undefined)}
+                    size={EComponentSize.MD}
+                />
+            </div>
+            <div style={{ display: "flex", flexDirection: "column", gap: "8px" }}>
+                <div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>Disabled</div>
+                <ChipSelect
+                    label="Select label"
+                    options={demoOptions}
+                    value={selectedDisabled}
+                    onChange={setSelectedDisabled}
+                    clearSelected={() => setSelectedDisabled(undefined)}
+                    disabled
+                    size={EComponentSize.MD}
+                />
+            </div>
+        </div>
+    );
+};
+```
+
+### WithNotificationIcon
+
+`stories/Chips/examples/ChipSelect/WithNotificationIconExample.tsx`
+
+```tsx
+import React, { useState } from "react";
+import { ChipSelect, EComponentSize, type ISelectFieldOption } from "@sberbusiness/triplex-next";
+
+const options: ISelectFieldOption[] = [
+    { id: "1", value: "option1", label: "Первая опция" },
+    { id: "2", value: "option2", label: "Вторая опция", showNotificationIcon: true },
+    { id: "3", value: "option3", label: "Третья опция" },
+    { id: "4", value: "option4", label: "Четвертая опция" },
+];
+
+export const WithNotificationIconExample = () => {
+    const [selected, setSelected] = useState<ISelectFieldOption | undefined>();
+
+    return (
+        <ChipSelect
+            size={EComponentSize.MD}
+            label="Select label"
+            options={options}
+            value={selected}
+            onChange={setSelected}
+            clearSelected={() => setSelected(undefined)}
+        />
+    );
+};
+```
+
+### WithCustomDisplayedValue
+
+`stories/Chips/examples/ChipSelect/WithCustomDisplayedValueExample.tsx`
+
+```tsx
+import React, { useState } from "react";
+import { ChipSelect, EComponentSize, type ISelectFieldOption } from "@sberbusiness/triplex-next";
+
+const demoOptions: ISelectFieldOption[] = [
+    { id: "1", value: "option1", label: "Первая опция" },
+    { id: "2", value: "option2", label: "Вторая опция" },
+    { id: "3", value: "option3", label: "Третья опция" },
+    { id: "4", value: "option4", label: "Четвертая опция" },
+    { id: "5", value: "option5", label: "Пятая опция" },
+    { id: "6", value: "option6", label: "Шестая опция" },
+];
+
+export const WithCustomDisplayedValueExample = () => {
+    const [selected, setSelected] = useState<ISelectFieldOption | undefined>(demoOptions[0]);
+    return (
+        <ChipSelect
+            label="Select label"
+            options={demoOptions}
+            value={selected}
+            onChange={setSelected}
+            clearSelected={() => setSelected(undefined)}
+            displayedValue="Displayed value"
+            size={EComponentSize.MD}
+        />
+    );
+};
+```
+

package/bundle/components/ChipSuggest.md

@@ -1,7 +1,7 @@
 ---
 component: ChipSuggest
 category: Chips
-related: [Chip, ChipSelect, Suggest, Dropdown, FormField]
+related: [ChipSuggestTarget, Chip, ChipSelect, Suggest, Dropdown, FormField]
 tokens: []
 stories: stories/Chips/ChipSuggest.stories.tsx
 version: "1.0"
@@ -57,7 +57,7 @@ version: "1.0"
 |---|---|---|---|
 | `type` | `EChipType` | `EChipType.TYPE_1` (дефолт `Chip`) | Тип чипса. Задавать только здесь: `targetProps.type` не работает — см. «Инварианты» |
 | `displayedValue` | `React.ReactNode` | — | Что показать на чипсе вместо `value.label`. Учитывается только при выбранном `value` |
-| `targetProps` | `IChipSuggestTargetProps<T>` | — | Props target-элемента. Через него передаётся `clearSelected`, а также props `Chip` (`disabled`, `className`, `data-*`, `onClick`, `size`). Два исключения — см. «Инварианты»: `targetProps.type` не применяется никогда, `targetProps.onKeyDown` вызывается только на `Enter`/`Space` |
+| `targetProps` | `IChipSuggestTargetProps<T>` | — | Props target-элемента. Через него передаётся `clearSelected`, а также props `Chip` (`disabled`, `className`, `data-*`, `onClick`, `size`). Исключение — см. «Инварианты»: `targetProps.type` не применяется никогда |
 | `dropdownProps` | `Omit<IChipSuggestDropdownProps<T>, "targetRef">` | — | Props выпадающего списка: props `Dropdown` (`onOpen`, `onClose`, `pullerProps`, …) плюс `focusTrapProps`. `targetRef` проставляет сам `ChipSuggest` |
 
 `className` попадает на корневой `<div>` (рядом с внутренним классом `chipGroupItem`),
@@ -106,23 +106,15 @@ version: "1.0"
 - **Известное ограничение, а не проектное решение:** `type` передаётся target-элементу
   **после** спреда `targetProps`, поэтому `targetProps.type` не применяется никогда — даже
   когда сам `type` не задан (тогда `Chip` уходит в свой дефолт). Тип чипса задавай prop'ом
-  `type` на самом `ChipSuggest`. Починка меняет наблюдаемое поведение, поэтому делается
-  отдельной задачей и с записью в release notes; тестом это поведение намеренно не
-  зафиксировано, чтобы падающий тест не выглядел поломкой контракта при починке.
-  Обрати внимание на асимметрию: `size` передаётся **до** спреда `targetProps`,
-  поэтому `targetProps.size` как раз работает.
-- **Известное ограничение, а не проектное решение:** `ChipSuggestTarget.handleKeyDown`
-  вызывает `targetProps.onKeyDown` только внутри ветки `Enter`/`Space`, поэтому на всех
-  остальных клавишах (стрелки, `Tab`, печатные символы) обработчик потребителя не
-  вызывается. Не рассчитывай на `targetProps.onKeyDown` для навигации по стрелкам.
-  Починка меняет наблюдаемое поведение → отдельная задача с записью в release notes.
+  `type` на самом `ChipSuggest`. При этом `size` передаётся **до** спреда `targetProps`,
+  поэтому `targetProps.size` работает.
 - `prefix` намеренно вырезается из props и не доходит до корневого `<div>`: он приходит
   из `React.HTMLAttributes` как RDFa-атрибут (то есть на `<div>` был бы валиден), но
   `ChipSuggest` его не поддерживает — `ChipSuggestTarget` задаёт только `postfix`.
 - `ChipSuggestDesktopDropdownField` — единственный компонент папки, оставленный
   `React.FC` без `forwardRef`: он не экспортируется из barrel, а очевидного ref-таргета
   у него нет (корень — `FormField`). Осознанное исключение из общего правила
-  `docs/ai/codestyle.md`, а не недосмотр; менять — отдельной задачей.
+  `docs/ai/codestyle.md`.
 - `dropdownProps.targetRef` исключён из типа: ссылку на корневой `<div>` подставляет сам
   `ChipSuggest`, иначе список потеряет привязку к чипсу.
 - `ChipSuggestDropdown` обязан класть ссылку на себя в `dropdownRef` из `SuggestContext` —
@@ -203,9 +195,9 @@ version: "1.0"
   `DropdownList` и `DropdownListItem`.
 - `FormField` — из его частей (`FormFieldLabel`, `FormFieldInput`, `FormFieldPostfix`,
   `FormFieldClear`) собрано поле фильтрации внутри десктопного списка.
-- `ChipSuggestTarget` — сам чипс-триггер. Экспортируется из barrel, но самостоятельного
+- [ChipSuggestTarget](ChipSuggestTarget-ai.md) — сам чипс-триггер. Экспортируется из barrel, но самостоятельного
   применения не имеет: `value` и `dropdownOpen` берёт из `SuggestContext`, поэтому работает
-  только внутри `Suggest`. Отдельного AI.md не имеет.
+  только внутри `Suggest`.
 - `ChipSuggestDropdown` — выпадающий список компонента: `FocusTrap` + поле фильтрации +
   `DropdownList` на десктопе, `SuggestMobileDropdownContent` на мобильной ширине. Из barrel
   не экспортируется (наружу уходит только тип props), отдельного AI.md не имеет.
@@ -243,6 +235,7 @@ version: "1.0"
 |---|---|
 | 2026-09-07 | Создан документ (AI-рефакторинг ChipSuggest, TRI-134) |
 | 2026-10-21 | **Breaking** (TRIPLEX-961): prop `mobileViewProps` в `dropdownProps` переименован в `pullerProps`. |
+| 2026-11-06 | Исправлено (TRI-0): `targetProps.onKeyDown` вызывается для всех клавиш, а не только для `Enter`/`Space`; `targetProps.disabled` отключает встроенную кнопку очистки. |
 
 ---