import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
import * as TimelineStories from './timeline.stories';

<Meta of={TimelineStories} />

<Title />
<Subtitle>A vertical chronological record of events or activities.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Pre-formatted Timestamps** — Use display-ready strings for the `timestamp` field; the component does not perform date formatting.
> - **Semantic Variants** — Leverage the `variant` prop (`success`, `warning`, `destructive`) to automatically theme the event icons.
> - **Container Sizing** — For long history feeds, wrap the `Timeline` in a `ScrollArea` component to maintain layout stability.