# XWUIGameGarageUI

Vehicle selection and customization garage. It renders a card carousel of `vehicles` (each `id`, `name`, `icon`, a `stats` map, and an `owned` flag), distinguishing owned from locked cards, plus a stats panel and an upgrade option for the `selectedId` vehicle. Toggle the stat bars with `conf_comp.showStats` and the upgrade button with `showUpgrades`. `select(vehicleId)` re-renders with the chosen vehicle and fires `xwui-garage-select`; `upgrade(vehicleId)` fires `xwui-garage-upgrade`.

## Basic Usage

Mounts the garage carousel ready to browse and select vehicles.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts the garage UI with a vehicle card carousel, stats panel, and upgrade option.
```

## Compact Carousel

A stripped-down picker with showStats:false, hiding the stat bars for a pure card-browsing view.

```example
file: examples/CompactCarousel.ts
html: examples/CompactCarousel.html
title: Compact Carousel
description: A vehicle carousel with showStats:false, hiding stat bars while keeping ownership badges.
```

## Upgrade Bay

An owned vehicle selected with showUpgrades:true, exposing its stat bars plus the Upgrade button.

```example
file: examples/UpgradeBay.ts
html: examples/UpgradeBay.html
title: Upgrade Bay
description: An owned vehicle with showUpgrades:true surfacing the Upgrade button alongside stat bars.
```

```api
```