# XWUIGameWorldMap

Full-screen pannable and zoomable world map. It renders a `mapImageUrl` background with `regions` overlays (each `id`, `name`, `bounds`, `discovered`), labeled `markers` pins, and a `playerPos` indicator, supporting mouse-drag pan and wheel zoom across the configured `zoomLevels` (default `[0.5, 1, 1.5, 2, 3]`). `conf_comp` toggles `showGrid`/`showLegend` and the `interactive` pan/zoom. `panTo(x, y)`, `setZoom(zoom)`, and `addMarker(marker)` drive the view, with `updateData(...)` for bulk refresh.

## Basic Usage

Mounts the pannable, zoomable world map with regions and markers.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts the full-screen world map with pan/zoom, region overlays, marker pins, and a player position indicator.
```

## Interactive Grid

Enables `showGrid: true` with custom `zoomLevels` and `interactive` pan/zoom, then steps in with `setZoom()`.

```example
file: examples/InteractiveGrid.ts
html: examples/InteractiveGrid.html
title: Interactive Grid
description: A grid-overlaid map with a custom zoomLevels ladder, zoomed in via setZoom().
```

## Charted Frontier

Spreads four regions (one undiscovered) with labeled pins, then drops a fresh point of interest via addMarker().

```example
file: examples/ChartedFrontier.ts
html: examples/ChartedFrontier.html
title: Charted Frontier
description: A broad multi-region map that gains a new marker at runtime through addMarker().
```

```api
```