# XWUIGameBossPhaseWidget

A boss-phase progress widget that renders a row of styled indicators showing how far a multi-phase boss fight has advanced - markers before `data.currentPhase` read as completed and the rest as inactive. The marker shape is chosen with `conf_comp.style` (`dot`, `diamond`, or `bar`), and `conf_comp.activeColor` (default `#ff4444`) / `conf_comp.inactiveColor` tint the completed versus remaining indicators; `data.currentPhase` (1-based) and `data.totalPhases` (or the `conf_comp.maxPhases` fallback, default 3) size the row. Use it in a boss health bar or HUD to telegraph phase transitions to the player.

## Basic Usage

Constructs a boss phase widget with `totalPhases` 5 at `currentPhase` 3, rendering five default-red `diamond` indicators with the first two marked completed and the third highlighted as current.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A five-phase diamond row in phase 3, showing current boss-fight progress.
```

## Dot Meter

A four-phase meter in the `dot` style with a custom gold `activeColor`/`inactiveColor` palette, sitting in phase 3.

```example
file: examples/DotMeter.ts
html: examples/DotMeter.html
title: Dot Meter
description: A four-phase dot-style row with a custom gold active and muted inactive palette.
```

## Phase Advance

A `bar`-style widget that starts in phase 1 and walks through all four phases on a timer using `getPhase()` and `setPhase()`.

```example
file: examples/PhaseAdvance.ts
html: examples/PhaseAdvance.html
title: Phase Advance
description: A bar-style row that advances phase 1 through 4 on a timer via setPhase().
```

```api
```