# AGENTS.md

## Current status

Rebuild initialized.

## Completed steps

None yet.

## Current step

Step 1 - Public API contract and pure core.

## Design decisions

- Package is managed with uv.
- Public import is `import dpg_map as dpgm`.
- Dear PyGui calls are GUI-thread-only.
- Runtime public calls enqueue commands or update logical state.
- Overlay updates must not reset center/zoom.
- The widget uses child_window + measured-size drawlist.
- Tiles use a memory cache and persistent disk cache.
- Tile providers are interchangeable.

## Known issues

None yet.

## Commands used

- Read `STEPS.md`, `FEATURES.md`, and `ARCHITECTURE.md`.
- Created initial package, examples, tests, and agent-log structure.

## Next action

Implement Step 1.