# dpg-map

`dpg-map` is a Dear PyGui map widget package under rebuild.

The Step 2 logical runtime model is in place:

```python
import dpg_map as dpgm

provider = dpgm.TileProvider(
    name="custom",
    url_template="https://example.com/{z}/{x}/{y}.png",
    attribution="Tiles (c) Example",
)
dpgm.register_provider(provider)

with dpgm.map_widget(tag="map", center=(47.9029, 1.9093), zoom=15):
    dpgm.add_marker("vehicle", lat=47.9029, lon=1.9093)

dpgm.update_marker("vehicle", lat=47.9030, lon=1.9094, map_tag="map")
```

Implemented so far:

- public package exports
- tile provider definitions and registry
- Web Mercator projection helpers
- thread-safe logical map state and map registry
- command queue with coalescing for overlay and view updates
- logical marker, polyline, trajectory, and layer models
- persistent disk cache path, metadata, scanning, and prune planning

Dear PyGui rendering is not implemented yet. The current `map_widget` is a logical
context manager used to register state; Step 3 will add the real child window,
drawlist, sizing, and GUI-thread frame pump.