# XWUIGameDifficultySelect

A card-based difficulty picker for game setup. Each entry in `data.difficulties` (`{ id, name, description, icon, modifiers }`) renders as a selectable card, and selecting one updates a live stat-modifier preview panel built from its `modifiers` map. Set the initial choice with `data.selectedId`, arrange cards via `conf_comp.layout` (`horizontal` or `vertical`), and hide the preview with `conf_comp.showModifiers: false`. Arrow keys move focus along the layout axis, Enter/Space confirms, and selection fires a `difficultyselect` event; read it with `onSelect` or `getSelected()`.

## Basic Usage

Renders difficulty cards with a modifier preview and emits the chosen difficulty on click or keyboard select.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Card-based difficulty picker with stat-modifier preview and keyboard navigation.
```

## Vertical Compact List

A vertically stacked difficulty list with the modifier preview hidden, suited to a compact sidebar menu.

```example
file: examples/VerticalNoModifiers.ts
html: examples/BasicUsage.html
title: Vertical Compact List
description: A vertically stacked difficulty list with the modifier preview hidden, suited to a compact sidebar menu.
```

## Roguelike Tiers

Four ascension tiers, each with a rich set of run-altering modifiers shown live, plus a Begin Run button that reads the choice via getSelected().

```example
file: examples/RoguelikeTiers.ts
html: examples/BasicUsage.html
title: Roguelike Tiers
description: Four ascension tiers, each with a rich set of run-altering modifiers shown live, plus a Begin Run button that reads the choice via getSelected().
```

```api
```