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

<Meta of={MapFeatureListStories} />

<Title />
<Subtitle>The map's content as an operable list.</Subtitle>

<Description />

<Primary />

<Controls />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
>
> - **Share one `selectedId`** between `<Map>` and this list, in both directions. Selecting a row highlights the point; selecting the point highlights the row. That two-way link is the whole point of the component.
> - **Never hide the list on small screens.** It is the accessible path to the same data, not a desktop-only extra.
> - **Surface `precisionLabel` whenever positions are centroids.** An approximate location read as an exact one is a factual error, not a cosmetic one.
> - **Do not rebuild it with `<div>` rows.** The listbox role, roving `tabIndex`, arrow-key navigation and Escape-to-clear all come from here.