# XWUIGameRelationshipPanel

NPC relationship tracker. It lists `relationships` - each with `npcName`, `portrait`, `type`, an affinity `value`/`maxValue`, and a `rank` - rendered as a portrait, name, and affinity bar with a rank badge. Optional `conf_comp.categories` filter the list (e.g. `'ally'`, `'rival'`, `'neutral'`) and `showHistory` reveals relationship history events. Replace the list with `updateData({ relationships })`.

## Basic Usage

Mounts the relationship panel with affinity bars and rank badges.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts the relationship panel listing NPCs with portraits, affinity bars, and rank badges.
```

## Filtered Categories

Restricts the list to friends and rivals with the categories config, dropping every other relationship type.

```example
file: examples/FilteredCategories.ts
html: examples/FilteredCategories.html
title: Filtered Categories
description: A roster filtered by categories ["friend", "rival"], hiding the romance and neutral entries.
```

## Hostile Mix

Spans a beloved ally down to a hostile enemy so the affinity bar runs its full green-to-red color range.

```example
file: examples/HostileMix.ts
html: examples/HostileMix.html
title: Hostile Mix
description: A roster whose values span 92 down to 6, exercising every affinity-bar color from green to red.
```

```api
```