doxa-maps/library/components/WARNING.md

⚠️ 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.
• Only proven, parameterized, reusable components graduate into this library. If a component has hard-coded values, assumptions about one specific map, or hasn't been used by more than one map yet — it is not ready to live here.
• 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.