# XWUIGameCompanionSheet

Full character sheet for a companion or pet: a header with portrait, name, type, and level, an HP bar plus an optional loyalty bar, a stats grid, and an abilities list (icon, name, description, cooldown). Bars auto-clamp to their 0-100% range. Use it for pet/companion/summon detail panels; refresh it with `updateData()`.

## Basic Usage

Mounts the sheet with the loyalty bar and abilities section enabled, ready for companion data.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A companion sheet with portrait header, HP and loyalty bars, stats grid, and abilities list.
```

## Wounded Scout

A heavily injured companion whose low HP and loyalty leave both bars nearly empty, with the abilities section disabled to focus on vitals.

```example
file: examples/WoundedScout.ts
html: examples/WoundedScout.html
title: Wounded Scout
description: A near-death companion showing clamped HP/loyalty bars with showAbilities off.
```

## Heal Over Time

A "Rest & Heal" button that calls `updateData()` to refill the companion's HP and loyalty bars live without rebuilding the sheet.

```example
file: examples/HealOverTime.ts
html: examples/HealOverTime.html
title: Heal Over Time
description: A button that drives updateData() to restore HP and loyalty in place.
```

```api
```