# XWUIGameCameraPresetPicker

An in-engine debug picker that browses 3D-camera `presets` as a card grid, each card showing the preset name, category badge, `qualitative` tags, and numeric `distance`/`fov`/`pitch` values. Use it while tuning camera rigs: the `showCategories` tabs (auto-derived from `categories` or the presets) filter via `filterByCategory()`, clicking a card calls `selectPreset()` and fires `onSelect()`, and the `showPreview` panel echoes the selected preset's details. Configure the grid with the `columns` prop.

## Basic Usage

Mounts the picker with no presets, so it renders just the `All` category tab, an empty grid, and the `Select a preset to see details` preview placeholder.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: An empty camera preset picker showing the All tab and the preview placeholder.
```

## Compact List

A single-column picker with `showPreview` and `showCategories` off, stacking first-person rigs as a tight list fit for a narrow inspector dock.

```example
file: examples/CompactList.ts
html: examples/CompactList.html
title: Compact List
description: A one-column picker with no preview or tabs, presenting FPS camera rigs as a stacked list.
```

## Programmatic Select

Buttons that call `selectPreset()` from outside the grid while an `onSelect()` callback echoes the chosen rig id into a live readout.

```example
file: examples/ProgrammaticSelect.ts
html: examples/ProgrammaticSelect.html
title: Programmatic Select
description: External buttons drive selectPreset() and an onSelect() callback keeps a live readout in sync with the highlight.
```

```api
```