# XWUIGameHUD

A fullscreen overlay container that lays out HUD elements into named screen zones (`topLeft`, `topRight`, `bottomLeft`, `bottomCenter`, `bottomRight`). The root is `pointer-events:none` so gameplay clicks pass through, while each zone re-enables pointer events for its widgets. Toggle individual zones via the `zones` config, set edge `padding`, and either mount children manually with `getZone(key)` or declare `statBlocks` to auto-spawn `XWUIGameStatBar` instances (hp/mp/xp/stamina/bp) fed by the `statValues` data map.

## Basic Usage

A fullscreen HUD overlay with click-through zones for mounting game widgets.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A fullscreen HUD overlay with click-through zones for mounting game widgets.
```

## RPG HUD

HP/MP/XP stat bars auto-mounted via `statBlocks`, plus a minimap panel hand-mounted into the top-right zone with `getZone()`.

```example
file: examples/RPGHud.ts
html: examples/RPGHud.html
title: RPG HUD
description: A dense RPG overlay with HP/MP/XP stat bars and a minimap mounted into the top-right zone.
```

## Minimal FPS HUD

A sparse shooter overlay that disables the top and center zones, keeps a single health bar, and hand-mounts an ammo counter.

```example
file: examples/MinimalHud.ts
html: examples/MinimalHud.html
title: Minimal FPS HUD
description: A bare FPS overlay with most zones disabled, one health bar, and a hand-mounted ammo counter.
```

## Low Health State

An HP stat bar mounted into a zone that takes timed damage via `setValue()`, crossing the `lowThreshold` to trigger the critical low-health pulse.

```example
file: examples/LowHealthState.ts
html: examples/LowHealthState.html
title: Low Health State
description: An HP bar taking timed hits via setValue() that drops below the low threshold and engages the critical pulse.
```

```api
```