# XWUIGameStealthMeter

A visibility/detection meter that pairs an eye icon with a fill bar showing how exposed the player is, transitioning color and label across three `detectionState`s: Hidden, Suspicious, and Detected! The `visibility` data value (0-1) drives the bar width, and the detected state pulses for emphasis. Toggle the eye with `showEyeIcon`, choose `size` and `position`, and push state with `updateData({ visibility, detectionState })`. A natural companion to a stealth game's noise/threat indicators.

## Basic Usage

A stealth visibility meter with an eye icon that shifts between hidden, suspicious, and detected states.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A stealth visibility meter with an eye icon that shifts between hidden, suspicious, and detected states.
```

## Blown Cover

A noise spike drives the meter from hidden to a maxed-out, pulsing detected state.

```example
file: examples/BlownCover.ts
title: Blown Cover
description: updateData() pushes visibility and state to a full, pulsing "Detected!".
```

## Ghost Mode

A minimal, fully-hidden meter with the eye icon turned off.

```example
file: examples/GhostMode.ts
title: Ghost Mode
description: A bare visibility bar (showEyeIcon off) sitting in the fully-hidden state.
```

```api
```