# XWUIGameRegionBanner

Animated region-name banner shown on area change. It displays `regionName` with a `subtext` line, animating in via `conf_comp.animStyle` (`fade`, `slide`, or `typewriter`) at the chosen `position` (`top`/`center`/`bottom`), then auto-dismisses after `duration` ms (default 3000). The data `active` flag tracks visibility. Trigger it imperatively with `show(regionName, subtext?)` (auto-hides after the duration) and force it away early with `hide()`.

## Basic Usage

Mounts the region banner ready to announce an area on entry.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts the region-name banner that fades, slides, or typewriters in on area change and auto-dismisses.
```

## Typewriter Reveal

Switches the entrance to `animStyle: "typewriter"` at the bottom so the region name types out character by character.

```example
file: examples/TypewriterReveal.ts
html: examples/TypewriterReveal.html
title: Typewriter Reveal
description: A bottom banner that types its region name out one character at a time.
```

## Triggered On Entry

Constructs the banner inactive, then fires it with `show(regionName, subtext)` so it slides in on demand and auto-hides.

```example
file: examples/TriggeredOnEntry.ts
html: examples/TriggeredOnEntry.html
title: Triggered On Entry
description: An initially hidden banner revealed imperatively via show() on a border crossing.
```

```api
```