# XWUIGameWantedLevel

A wanted-level meter rendering a row of `maxLevel` `star` or `skull` icons (set by `icon`), with the first `level` filled and the rest dimmed. Call `updateData({ level, active, flashing })` to change the rating - newly filled icons get a pop animation, and levels 4-5 add escalation classes plus optional `flashing`.

## Basic Usage

Mounts the wanted meter with five `star` icons at level 3, so the first three stars fill and light up while the rest stay dimmed.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A wanted-level meter mounted with 3 of 5 star icons filled and active.
```

## Five-Star Wanted

A maxed-out `skull` meter at level 5 with `flashing`, plus a button that drops the rating one step at a time via `updateData()`.

```example
file: examples/FiveStarWanted.ts
html: examples/FiveStarWanted.html
title: Five-Star Wanted
description: A maxed-out skull meter at level 5 with flashing, plus a Lay Low button that drops the rating via updateData().
```

## Escalating Heat

A live meter that ramps from level 0 to level 5 on a timer, popping each new star in as the heat climbs.

```example
file: examples/EscalatingHeat.ts
html: examples/EscalatingHeat.html
title: Escalating Heat
description: A live meter that ramps from 0 to 5 stars on a timer, popping each new star in via updateData().
```

```api
```