# XWUIGameBuffIndicator

A row (or column) of active status-effect icons, each showing a countdown timer that ticks down once per second and pulses when under 3 seconds remain before fading out on expiry. Buffs and debuffs are distinguished by border color via each entry's `type` field (`buff` / `debuff`), and hovering an icon shows its `name` as a tooltip. Configure `stackDirection`, `maxVisible`, and `showDuration`; drive it at runtime with `addBuff()`, `removeBuff()`, and `getActiveBuffs()`.

## Basic Usage

A horizontal stack of buff/debuff icons with per-icon duration countdowns.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A horizontal stack of buff/debuff icons with per-icon duration countdowns.
```

## Debuff Column

A vertical stack of debuffs, two about to expire and pulsing for warning.

```example
file: examples/DebuffColumn.ts
html: examples/DebuffColumn.html
title: Debuff Column
description: A vertical stack of debuffs, two about to expire and pulsing for warning.
```

## Live Buff Application

A buff row that gains a shield via addBuff() then loses a debuff via removeBuff() at runtime.

```example
file: examples/LiveBuffs.ts
html: examples/LiveBuffs.html
title: Live Buff Application
description: A buff row that gains a shield via addBuff() then loses a debuff via removeBuff() at runtime.
```

```api
```