# XWUIGameDialogueBox

An RPG dialogue box for NPC conversations that shows a speaker `portrait`, a `speaker` name plate, the line of `text` revealed with a typewriter effect, and a list of `choices` (`{id, text}`) rendered as buttons once typing finishes. Configure `position` (bottom/center/top), `portraitSize`, `typewriterSpeed` (ms per character), and `showNameplate` via conf_comp; drive it at runtime with `showDialogue()`, `skipTypewriter()`, `advance()`, and `onChoice()`. Use it for branching, character-driven conversations in quests and cutscenes.

## Basic Usage

An NPC, Eldra the Sage, greets the player: her line types out and two reply choices appear once typing finishes.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A bottom-anchored dialogue box where Eldra the Sage greets the player and offers two reply choices.
```

## Branching Choices

A center-stage decision with a large portrait and four mutually exclusive replies for a pivotal quest choice.

```example
file: examples/BranchingChoices.ts
html: examples/BasicUsage.html
title: Branching Choices
description: A centered dialogue box where Captain Mira poses a tactical prompt with four branching replies and a large portrait.
```

## Fast Narrator

Nameplate-less narration that types out almost instantly, for cinematic scene-setting prose with no choices.

```example
file: examples/FastNarrator.ts
html: examples/BasicUsage.html
title: Fast Narrator
description: A narration box with no nameplate and a very fast typewriter (typewriterSpeed 8) that snaps scene-setting prose into view.
```

```api
```