AiHistoryLine

Вертикальная лента шагов AI-диалога — запросы пользователя, ответы агента, вызовы инструментов, чекпоинты

Демо

  • Упрости настройку хранения ссылок: поддержи и существующие репозитории, и первоначальную настройку.
  • b12cb69Добавлены сценарии для существующего репозитория и первой настройки.
    +83/-26

Когда использовать

Вертикальная лента событий: запрос, ответ, группа вызовов, чекпоинт. Содержимое строки передаёт потребитель. Индикатор, степпер, запрос, аккордеон и чекпоинт можно поставить и отдельно от ленты. Карточка группы раскрывается сама. Уже показанную группу раскрывают снаружи через open и onOpenChange. Кольцо в ленте одно: его id задают value или defaultValue. Клик по индикатору с id переключает это кольцо. Запись адреса и прокрутку к строке делает потребитель в onIndicatorClick.

Анатомия

  • AiHistoryLine — список, ul.
  • AiHistoryLine.Item — строка: степпер, индикатор и слот тела.
  • AiHistoryLine.Indicator — колодец 24×24. background={false} убирает подложку у аватара. Кольцо задаёт active, своё состояние выбора компонент не хранит.
  • AiHistoryLine.Stepper — верхний и нижний коннекторы вокруг индикатора. Высоту верхней линии задаёт offset. showLeadingConnector={false} скрывает линию и сохраняет место. Нижняя линия есть при showClosingConnector. В ленте смещение считает строка: центр кружка совпадает с центром первой строки, у первой строки линия не видна.
  • AiHistoryLine.AgentContent — обёртка ответа агента: отступ сверху и расстояние между соседними блоками.
  • AiHistoryLine.Request, AiHistoryLine.Accordion, AiHistoryLine.Checkpoint — карточки. Аккордеон хранит раскрытие внутри себя, а open и onOpenChange передают его наружу.

Установка

pnpm add @cloud-ru/ds-ai-history-line
import { AiHistoryLine } from '@cloud-ru/ds-ai-history-line'

Props

Types

PropsAiHistoryLineProps
PropTypeDefaultRequiredDescription
asElementType—noПолиморфный тег корня. По умолчанию `ul`.
childrenReactNode—noЭлементы ленты.
classNamestring—noДополнительный класс корня.
data-test-idstring—no
defaultValuestring—no`id` индикатора, выбранного при первом рендере.
innerRefany—noRef на корневой элемент.
onIndicatorChange((value: string) => void)—noСообщает `id` выбранного индикатора. Повторный клик по нему передаёт `undefined`.
valuestring—no`id` выбранного индикатора. Вместе с `onIndicatorChange` выбор управляемый.

Types

AiHistoryLineProps

Storybook

Figma