Worldshaper/docs/kb/systems/world-overview.md

# World Overview

## What It Owns

The World Overview is the large-scale chunk map used for navigation, chunk inspection, bookmark placement, and chunk-level operations that would be awkward from the tile canvas alone.

## Core Behaviors

- Navigate directly to a chunk.
- Move chunk content.
- Duplicate chunk tiles.
- Flip and rotate chunk content.
- Delete a chunk and clear its tiles, height data, and placed entities.
- Paint or restore the chunk background tile.
- Create POIs and bookmarks from chunk positions.

## Important UI Surfaces

- World Overview floating window
- Chunk context menu
- Pending chunk-action flow
- Bookmark and POI display

## Important Files

- `src/worldshaperStudio/worldOverviewWindowController.ts`
- `src/worldshaperStudio/dom.ts`
- `server.js`

## Known Behavior Notes

- The chunk context menu is already a rich operations hub, so many requests in this area are extensions to an existing menu rather than requests for a brand-new system.
- Pending move and duplicate actions are stateful; the overview can wait for a second chunk selection before executing.
- The overview also exposes quick background-painting workflows at the chunk level.

## Relationships

- Depends on `Chunk Storage And Streaming` for chunk records and chunk dimensions.
- Depends on `Windows` because the overview lives in its own floating tool window.
- Often intersects with `Layers` and `Tiling` when users want higher-level terrain or chunk painting workflows.

## Triage Hints

Requests about chunk move, duplicate, rotate, delete, POIs, overview navigation, and world-scale map management should begin here.