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

package/bundle/components/ChipOptions.md

@@ -1,7 +1,7 @@
 ---
 component: ChipOptions
 category: Chips
-related: [Chip, ChipGroup, ChipSort, ChipMultiselect]
+related: [Chip, ChipSort, ChipMultiselect]
 tokens: []
 stories: stories/Chips/ChipOptions.stories.tsx
 version: "1.0"
@@ -176,6 +176,7 @@ version: "1.0"
 | 2026-09-04 | Создан документ (TRI-133, AI-Ready Phase 1) |
 | 2026-09-04 | AI-рефакторинг (TRI-133): JSDoc на интерфейсе, `size` разобран из props явно, иконка опций собрана в один элемент со сменой `paletteIndex`, `typeof children !== "undefined"` → `children !== undefined`, комментарий про `<span />`-заглушку в `postfix`; unit-тесты расширены с 3 до 19 кейсов. Публичный API, DOM и визуал не изменены |
 | 2026-09-08 | Добавлен prop `clearButtonProps` (TRI-133): кнопке сброса можно задать `aria-label`, `disabled` и прочие props `ChipClearButton`; переданные `onClick` / `onKeyDown` вызываются после собственных обработчиков компонента. `Enter` / `Space` на кнопке сброса больше не всплывают до `Chip` — `Space` активирует кнопку, внешний `onKeyDown` чипса не срабатывает заодно со сбросом |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны несимметричные имена (`ChipGroup`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/ChipSort.md

@@ -1,7 +1,7 @@
 ---
 component: ChipSort
 category: Chips
-related: [Chip, ChipSelect, ChipGroup, SelectExtendedField, IconWrapper]
+related: [Chip, ChipSelect, ChipOptions, SelectExtendedField, IconWrapper]
 tokens: []
 stories: stories/Chips/ChipSort.stories.tsx
 version: "1.0"
@@ -178,6 +178,8 @@ JSX, `isEqual` сравнивает деревья элементов. Держ
 - `ChipGroup` — рекомендуемый контейнер: отступы, перенос строк, режим `oneLine`
 - `SelectExtendedField` — база: владеет состоянием открытости, правилами закрытия
   и корневым `<div>`; список рендерится через `SelectExtendedFieldDropdownDefault`
+- `ChipOptions` — тот же приём (иконка в `prefix` + смена палитры по `selected`), но для
+  набора опций и с кнопкой сброса
 - `IconWrapper` — обёртка иконки сортировки, добавляет состояния `active` / `disabled`
 
 ---
@@ -203,6 +205,7 @@ JSX, `isEqual` сравнивает деревья элементов. Держ
 |---|---|
 | 2026-09-04 | Создан документ (TRI-132, AI-Ready Phase 1) |
 | 2026-09-04 | AI-рефакторинг (TRI-132): codestyle-чистка `ChipSort.tsx` (объединены дублирующиеся импорты, пути приведены к `../`, magic-числа палитры иконки вынесены в именованные константы, добавлены JSDoc и комментарии к нетривиальной логике), unit-тесты расширены с 1 до 19 кейсов; публичный API, DOM и визуал не изменены |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны несимметричные имена (`ChipGroup`); добавлены обратные ссылки (`ChipOptions`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/ChipSuggest.md

@@ -133,12 +133,13 @@ version: "1.0"
   переименование файла в папке `Suggest` ломает мобильный режим `ChipSuggest`.
 - Корневой `<div>` всегда получает класс `chipGroupItem` — на нём держатся отступы внутри
   `ChipGroup`.
-- `setForwardedRef` из `ChipSuggest/utils.ts` — внутренний хелпер, из barrel не
-  экспортируется и в публичные `src/utils` не переносится. Это **не** конечное
-  состояние: точно такая же функция уже лежит в `src/components/List/utils.ts`, и та же
-  пятистрочка инлайнится ещё в полутора десятках компонентов (включая `Suggest.tsx`).
-  Консолидация во внутренний shared-модуль — отдельная задача; не плоди третью копию,
-  а при случае сошлись на неё.
+- `setForwardedRef` живёт в `src/helpers/setForwardedRef.ts` — внутренний хелпер,
+  общий для `AmountField`, `ChipSuggest`, `FormField`, `List` и `SliderExtended`.
+  Из barrel не экспортируется и в публичные `src/utils` не переносится. Импортируется
+  относительным путём (`../../../helpers/setForwardedRef`), не через алиас
+  `@sberbusiness/triplex-next/...` — см. `docs/ai/codestyle.md`. Не плоди локальные копии:
+  та же пятистрочка ещё инлайнится в ряде компонентов (включая `Suggest.tsx`) — при
+  случае сошлись на общий модуль.
 
 ---
 

package/bundle/components/CollapsibleTree.md

@@ -1,7 +1,7 @@
 ---
 component: CollapsibleTree
 category: CollapsibleTree
-related: [CollapsibleTreeExtended, CollapsibleTreeNodeHeader, CollapsibleTreeNodeLabel, TreeView, AccordionBase]
+related: [CollapsibleTreeExtended, TreeView, AccordionBase]
 tokens:
   - CollapsibleTree.Header_Background_Hover
   - CollapsibleTree.Header_Shadow_Focus
@@ -122,10 +122,13 @@ CollapsibleTree.Header_Shadow_Focus
 
 ## Инварианты
 
-- **`CollapsibleTree` — FC без `forwardRef`.** Под капотом class-компонент
-  `TreeView`, ref не пробрасывается осмысленно. Тот же инвариант, что у
-  `CollapsibleTreeExtended` и `CollapsibleTreeLeafNode` (тоже проксируют в
-  class-компонент).
+- **`CollapsibleTree` — FC без `forwardRef`.** С 1.47.0 это уже не общий
+  инвариант семейства: `CollapsibleTreeExtended` и `TreeView` под ним `ref`
+  пробрасывают на корневой `<ul role="tree">`, а `CollapsibleTree` его
+  по-прежнему теряет. Прежнее обоснование («под капотом class-компонент
+  `TreeView`») больше не действует — это оставшийся долг, а не решение.
+  Починка — наблюдаемое изменение публичного API, отдельная задача с записью
+  в release notes.
 - **`CollapsibleTreeNodeHeader` — `forwardRef<HTMLButtonElement>`** — ref
   идёт на корневой `<button>`, чтобы потребитель мог управлять фокусом
   заголовка (например, программно фокусировать конкретный узел).
@@ -227,6 +230,8 @@ CollapsibleTree.Header_Shadow_Focus
 | 2026-07-06 | Шеврон открытого узла теперь указывает вверх (`rotate(-90deg)`), а не вниз |
 | 2026-07-06 | Добавлено свойство `disabled` у `ICollapsibleTreeNodeBranch` и поддержка пропа `disabled` в `CollapsibleTreeNodeHeader`. Без новых токенов: шеврон приглушается глобальными классами `hoverable disabled` (icons-next), текст — через `type={EFontType.DISABLED}` у лейбла |
 | 2026-07-14 | Глобальный класс `hoverable` (icons-next) на кнопке заголовка теперь стоит всегда, а не только при `disabled` — для корректной окраски шеврона. Добавлен класс `active` на раскрытый узел с детьми (по паттерну `IconWrapper`/`Button`) |
+| 2026-09-17 | TRI-22: инвариант про отсутствие `forwardRef` переформулирован — `CollapsibleTreeExtended` и `TreeView` под ним теперь пробрасывают `ref` на корневой `<ul>`, поэтому прежнее обоснование не действует, а `CollapsibleTree` остаётся долгом |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны имена без строки в `docs/ai/ROADMAP.md` (`CollapsibleTreeNodeHeader`, `CollapsibleTreeNodeLabel`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---
 

package/bundle/components/CollapsibleTreeExtended.md

@@ -36,7 +36,8 @@ controlled/uncontrolled-состояние) через `CollapsibleTreeExtended.
 
 ### `CollapsibleTreeExtended`
 
-FC-обёртка над `TreeView` без собственных props.
+`forwardRef`-обёртка над `TreeView` без собственных props. `ref` уходит насквозь
+и указывает на корневой `<ul role="tree">`.
 
 | Prop | Тип | По умолчанию | Описание |
 |---|---|---|---|
@@ -112,17 +113,17 @@ FC-обёртка над `TreeView` без собственных props.
 - **`CollapsibleTreeExtended.Node` — class-компонент.** Намеренное решение —
   не переписывать на FC + hooks без согласования. `forwardRef` к нему не
   применяется (классы используют обычный `ref`).
-- **`CollapsibleTreeExtended` — FC без `forwardRef`.** Это тонкая обёртка
-  `props → <TreeView>`, своего рендера нет; `ref` не имеет смысла, потому
-  что под капотом — class-компонент `TreeView` с собственной обработкой
-  фокуса.
+- **`ref` указывает на корневой `<ul role="tree">`.** Компонент — тонкая обёртка
+  `props → <TreeView>` без своего рендера, поэтому `ref` просто уходит насквозь
+  в `TreeView`, который и отдаёт корневой `<ul>`.
 - **Доступ к ноде только через `CollapsibleTreeExtended.Node`** (compound
   pattern). Прямой импорт `CollapsibleTreeExtendedNode` из barrel разрешён,
   но в потребительском коде предпочтительнее `.Node`.
 - **Публичный API** — имена `ICollapsibleTreeExtendedNodeProps`,
   `ICollapsibleTreeExtendedNodeBodyProvideProps`,
   `ICollapsibleTreeExtendedNodeHeaderProvideProps`, `ICollapsibleTreeExtendedProps`,
-  `ICollapsibleTreeExtendedSFC` и сигнатуры `toggle`, `onToggle`,
+  `ICollapsibleTreeExtendedFC` (и deprecated-алиас `ICollapsibleTreeExtendedSFC`)
+  и сигнатуры `toggle`, `onToggle`,
   `renderHeader`, `renderBody` — нельзя менять без breaking. Зависимости:
   `CollapsibleTree`, `CollapsibleTreeBranchNode`, `CollapsibleTreeLeafNode`.
 - **`children: never` на `Node`** — содержимое задаётся только через
@@ -192,6 +193,7 @@ FC-обёртка над `TreeView` без собственных props.
 | 2026-07-06 | В story-примерах шеврон открытого узла теперь указывает вверх (`rotate(-90deg)`), а не вниз — синхронно с `CollapsibleTree` |
 | 2026-07-14 | В story-примерах на кнопку заголовка добавлены глобальные классы icons-next: `hoverable` всегда и `active` при `opened` — цвет иконки раскрытия, синхронно с `CollapsibleTreeNodeHeader` |
 | 2026-08-26 | В `related` добавлен `TreeViewNode` — у узла появился собственный AI.md, и он точный адресат наследования `ICollapsibleTreeExtendedNodeProps` |
+| 2026-09-17 | TRI-22: `CollapsibleTreeExtended` обёрнут `forwardRef` — `ref` отдаёт корневой `<ul>`; тип переименован в `ICollapsibleTreeExtendedFC`, старое имя оставлено deprecated-алиасом |
 
 ---
 

package/bundle/components/ComposedKeyDownListener.md

@@ -1,7 +1,7 @@
 ---
 component: ComposedKeyDownListener
 category: KeyDownListener
-related: [KeyDownListener, TriggerClickOnKeyDownEvent, SelectExtendedField, SliderExtended]
+related: [KeyDownListener, TriggerClickOnKeyDownEvent]
 tokens: []
 stories: stories/ComposedKeyDownListener/ComposedKeyDownListener.stories.tsx
 version: "1.0"
@@ -125,8 +125,8 @@ version: "1.0"
   сравнение по устаревшему `event.keyCode` и константы `EVENT_KEY_CODES`.
 - `TriggerClickOnKeyDownEvent` (`src/components/Triggers/`) — по нажатию клавиши
   вызывает `click` на элементе из `targetRef`.
-- `SelectExtendedField`, `SliderExtendedDot`, `SliderExtendedTrack` — потребители
-  `KeyDownListener` внутри библиотеки.
+- `SelectExtendedField`, `SliderExtended` (`SliderExtendedDot`, `SliderExtendedTrack`) —
+  потребители базового `KeyDownListener` внутри библиотеки, а не композитора.
 
 ---
 
@@ -153,6 +153,7 @@ version: "1.0"
 | Дата | Изменение |
 |---|---|
 | 2026-08-11 | Создан документ (TRI-112). Слушатели рендерятся соседями к `children` вместо вложения — смена длины `keyDownListeners` больше не перемонтирует содержимое (покрыто unit-тестом). Добавлен собственный набор stories по modern pattern; демонстрационная story `Example` перенесена из набора `KeyDownListener`. Публичный API не изменён. |
+| 2026-09-29 | Аудит симметрии `related` (TRI-156): из `related` убраны несимметричные имена (`SelectExtendedField`, `SliderExtended`). Пояснения к убранным именам сохранены прозой в «Связанные компоненты»; публичный API и поведение не затронуты. |
 
 ---