initial uv project setup

AGENTS.md

@@ -0,0 +1,37 @@
+# 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.

examples/.gitkeep

@@ -0,0 +1 @@
+

pyproject.toml

@@ -27,3 +27,13 @@ dev = [
     "pytest>=9.0.3",
     "ruff>=0.15.14",
 ]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.pyright]
+typeCheckingMode = "basic"

src/dpg_map/api.py

@@ -0,0 +1 @@
+"""Public API wrappers for dpg-map."""

src/dpg_map/cache.py

@@ -0,0 +1 @@
+"""Memory and disk cache helpers."""

src/dpg_map/commands.py

@@ -0,0 +1 @@
+"""Command models for GUI-thread rendering work."""

src/dpg_map/diagnostics.py

@@ -0,0 +1 @@
+"""Diagnostics and debug state helpers."""

src/dpg_map/draw_layers.py

@@ -0,0 +1 @@
+"""Draw layer bookkeeping helpers."""

src/dpg_map/exceptions.py

@@ -0,0 +1 @@
+"""Public exception types."""

src/dpg_map/interaction.py

@@ -0,0 +1 @@
+"""Map interaction state and handlers."""

src/dpg_map/overlays.py

@@ -0,0 +1 @@
+"""Logical overlay models."""

src/dpg_map/projection.py

@@ -0,0 +1 @@
+"""Web Mercator projection helpers."""

src/dpg_map/providers.py

@@ -0,0 +1 @@
+"""Tile provider definitions and registry."""

src/dpg_map/renderer.py

@@ -0,0 +1 @@
+"""GUI-thread renderer implementation."""

src/dpg_map/sizing.py

@@ -0,0 +1 @@
+"""Map sizing measurement helpers."""

src/dpg_map/state.py

@@ -0,0 +1 @@
+"""Thread-safe state models and registries."""

src/dpg_map/tiles.py

@@ -0,0 +1 @@
+"""Tile identity, lifecycle, and worker coordination."""

src/dpg_map/types.py

@@ -0,0 +1 @@
+"""Shared type aliases and small value objects."""

src/dpg_map/widget.py

@@ -0,0 +1 @@
+"""Dear PyGui map widget construction."""

tests/.gitkeep

@@ -0,0 +1 @@
+