Edit Session and Tile Rebuild

Managed vector layers keep edits as hot deltas while you work. The map stays live; offline artifacts rebuild when the session closes.

While the session is open

1. Enter edit mode from the toolbar or layer actions.
2. Create, update, or delete features — each save commits a delta.
3. The map shows the PMTiles base plus a hot-delta overlay when a baseline exists.
4. Closing the edit panel (X) hides the panel but keeps the session active. Use Close session on the edit dock to finish.

During the session, Tamaat does not rebuild PMTiles, hexbin, cluster, or selection-index artifacts on every save.

Close the session to rebuild

1. Click Close session (or exit edit mode from the toolbar).
2. Tamaat flags tiles and rollups stale and starts regeneration.
3. Wait for tile / rollup ready signals, then refresh layer metadata if the map still looks stale.

What rebuilds on close

• Compact deltas into a new GeoParquet snapshot
• Selection index
• Hexbin rollup (point layers)
• Cluster rollup (point layers)
• Base PMTiles when features exist

Common errors

• Edits vanished after refresh on a PMTiles layer — confirm pending_delta_count refreshed after save; dual-source rendering depends on current delta metadata.
• Clusters look wrong mid-session — geometry add/move/delete unmounts cluster overlays until session-close rebuild; attribute-only edits may keep sparse overrides.
• Tiles never update — confirm you closed the session, not only the panel.

FAQ

Why not rebuild on every save?
Per-edit rebuilds would block editing and thrash workers. Hot deltas keep the map correct; session close batches the expensive artifacts.

Does panel close end the session?
No. Only Close session / leaving edit mode ends the session and triggers rebuilds.