# ⚠️ Read before you touch these components

**These are the SHARED, REUSABLE components — every map in `plugin-designs/` depends on them.**

A change here does not affect one map. It ripples to **all** of them. So:

- **Prototyping or experimenting? Don't edit these.** Put your custom, one-off, not-yet-proven component
  inside your own map's folder (`plugin-designs/<your-map>/`), where it can be as messy as you need and
  breaks nothing else.
- **Reusable by default.** If a component could serve more than one map, build it here once, driven by props,
  and land it through the build owner, so other maps adopt it instead of copying it. If it has hard-coded
  values or assumptions about one specific map, it is **not** ready to live here: parameterize it first.
- **A reusable component takes props, not assumptions.** Before you move something in, make it parameterized:
  the map, the legend, the controls, the search bar all take configuration — yours should too.
- **If you must change a shared component, check every map that uses it.** Run `bun run dev` and click through
  the maps before you commit. The whole point of this library is that maps *don't* have to be rewritten —
  don't undo that by breaking the shared pieces.

Rule of thumb: **custom code in your app-profile, reusable code in the library — and things only move from the
first to the second once they've earned it.**