# XWUICardShuffle

A stacked card deck with a shuffle animation. The front card is large and interactive; rear cards peek above it, smaller and dimmed. Navigate with prev/next arrows, a horizontal swipe, or arrow keys. Click (or Enter/Space) the front card to select it.

Each item can carry a title, LIGHT/DARK-style badge, up to four color swatches, and an inline background/color so theme-preview cards paint correctly even when they are not the live theme.

## Basic Usage

Three theme-preview cards with arrows and loop.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Stacked theme-preview cards with arrows and loop.
```

## Touch / swipe

Arrows hidden - swipe or keyboard only.

```example
file: examples/Touch.ts
html: examples/Touch.html
title: Touch / swipe
description: Swipe or keyboard shuffle; tap front to select.
```

## Showcase

Defaults, bounded mode, external `next()`/`prev()`, and `onSelect`.

```example
file: examples/Showcase.ts
html: examples/Showcase.html
title: Showcase
description: Full tour of XWUICardShuffle modes.
```

```api
```