# XWUIGameEventBanner

A timed in-game event announcement banner that displays an `icon`, `title`, and `description` with an optional MM:SS `countdown` timer and a dismiss button. It pins to the `position` (top/bottom) set in conf_comp, can hide the timer via `showCountdown`, and when the countdown hits zero it fires an `event-expired` event and (unless `autoDismiss` is false) hides itself. Drive it with `show(title, duration)`, `dismiss()`, and `updateData()`; it emits `event-shown`, `event-dismissed`, and `event-expired` CustomEvents. Use it to flag limited-time events, world bosses, or sales with a live timer.

## Basic Usage

Mounts a top-pinned "Double XP Weekend" event with an icon and description, then calls `show()` to start a live 2-minute countdown.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A top "Double XP Weekend" banner with a ⚡ icon and a live 2-minute countdown.
```

## Bottom Raid Timer

Pins a world-boss raid banner to the bottom of the screen with a 5-minute countdown.

```example
file: examples/BottomRaidTimer.ts
html: examples/BasicUsage.html
title: Bottom Raid Timer
description: A bottom-pinned 🐉 world-boss banner counting down 5 minutes for the raid.
```

## No Countdown Alert

Shows a persistent announcement with the countdown row hidden via `showCountdown: false`.

```example
file: examples/NoCountdownAlert.ts
html: examples/BasicUsage.html
title: No Countdown Alert
description: A persistent 📣 maintenance notice with the timer row suppressed.
```

```api
```