# XWUIGameChapterBanner

A full-screen chapter-reveal overlay that animates a large `Chapter N` label, `title`, and optional `subtitle` into view, then auto-dismisses after a timer. Choose the entrance with the `animStyle` config (`fade`, `slide`, or `cinematic`) and the on-screen time with `duration` (ms); the `chapterNumber`, `title`, and `subtitle` come from data. It is hidden until `show()` is called and fires `chapter-shown` / `chapter-hidden` events, making it ideal for story-beat transitions between levels or acts.

## Basic Usage

Reveals a populated chapter 1 banner ("The Awakening") with the default fade animation and a 4s duration, calling `show()` to fade the overlay in.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Fades in a populated "Chapter 1 - The Awakening" overlay with the default 4s duration.
```

## Cinematic Act

Reveals a dramatic late-game act with the cinematic entrance and a longer on-screen time.

```example
file: examples/CinematicAct.ts
html: examples/BasicUsage.html
title: Cinematic Act
description: A cinematic "Chapter 7 - The Shattered Crown" reveal held on screen for 6s.
```

## Slide Interlude

Slides a brief story interlude card into view between levels using a short duration.

```example
file: examples/SlideInterlude.ts
html: examples/BasicUsage.html
title: Slide Interlude
description: A sliding "Chapter 3 - Interlude: The Long Road" card shown for 3s.
```

```api
```