# XWUIGameWorldStateOverview

Global world-state dashboard. It lays out a grid of three panels: faction `factions` territories with color-coded bars (`name`, `color`, `territory`), active `events` with live countdown timers (`name`, `type`, `timeLeft` seconds), and an environment panel showing `weather`, `time`, and `season`. `conf_comp` toggles `showFactions`/`showEvents`/`showEnvironment`, sets the grid `columns` (default 3), and enables a `compact` layout. `updateData(...)` refreshes every panel; the component runs its own interval to tick the event countdowns.

## Basic Usage

Mounts the world-state dashboard with factions, events, and environment panels.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts the world state overview dashboard with faction territory bars, event countdowns, and weather/time/season status.
```

## Compact Dashboard

Enables the `compact` layout and narrows to `columns: 2`, tightening all three panels into a denser sidebar view.

```example
file: examples/CompactDashboard.ts
html: examples/CompactDashboard.html
title: Compact Dashboard
description: The world-state dashboard in compact mode squeezed into a two-column grid.
```

## Wartorn Realm

Hides the territories panel with `showFactions: false`, leaving war-heavy event countdowns and the environment panel.

```example
file: examples/WartornRealm.ts
html: examples/WartornRealm.html
title: Wartorn Realm
description: An events-and-environment view with factions off and war/invasion timers running.
```

```api
```