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

<Meta of={MapTimelineStories} />

<Title />
<Subtitle>Time ruler bound to the map, with playback.</Subtitle>

<Description />

<Primary />

<Controls />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
>
> - **Pair it with `<Map timeField>` and `<Map timeWindow>`** — the ruler moves the window, the map filters the features. That is what turns plotted points into a space-time reconstruction.
> - **Always pass `formatValue`.** A raw minute count means nothing to the reader.
> - **Keep `playing` in the parent**; the component is fully controlled.
> - Under `prefers-reduced-motion` the control does not auto-advance on its own and says so. The user can still press play — the setting suppresses unrequested movement, not the feature.