# XWUIGameCollectionsViewer

A collection/catalog gallery that organizes the `collections` data (a map of category to items) under a row of category tabs and a grid of `columns` cells (default 4). Each cell reflects an item's `discovered` flag: discovered items show their real icon and name, while hidden ones render as `?` / `???`. When `showCompletion` is on, each tab label appends the percentage of items discovered in that category. Switch the active category by clicking a tab or via `updateData({ activeCategory })`.

## Basic Usage

Shows category-tabbed collection cells with discovered and hidden states.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A collections gallery with category tabs, completion percentages, and discovered vs hidden cells.
```

## Hidden Secrets

A secrets category mid-hunt where most cells are still locked ??? silhouettes.

```example
file: examples/HiddenSecrets.ts
html: examples/HiddenSecrets.html
title: Hidden Secrets
description: A secrets activeCategory with mostly undiscovered cells rendering as ? / ??? and completion percentages on.
```

## Completion Hidden

A wide six-column gallery with the per-tab completion percentages turned off.

```example
file: examples/CompletionHidden.ts
html: examples/CompletionHidden.html
title: Completion Hidden
description: A dense six-column gallery with showCompletion off, so tabs show plain category names without percentages.
```

```api
```