# XWUIGameCoverIndicator

A tactical cover-status indicator that draws an SVG shield reflecting the player's protection - a struck-through grey shield for `none` (EXPOSED), a half-filled amber shield for `half` (HALF COVER), and a solid green shield for `full` (FULL COVER) - alongside an optional compass-direction marker. The state is driven by `data.coverLevel` (`none`, `half`, `full`) and `data.direction` (e.g. `'N'`, `'NE'`, `'E'`), while `conf_comp.position` (`bottom-left`, `bottom-right`, or `bottom-center`) and `conf_comp.size` (default 48 px) control placement and icon size. Use it in cover-based shooters or tactical games to show, at a glance, whether and from which side the player is shielded.

## Basic Usage

Constructs a cover indicator with empty data and default config, mounting a 48 px icon positioned `bottom-left` in the default `none` (EXPOSED) state - a struck-through grey shield.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A shield icon showing none, half, or full cover status with optional direction.
```

## Half Cover, Bottom-Right

The amber `half` cover state at a larger size, anchored `bottom-right` with an east-facing direction marker.

```example
file: examples/HalfCover.ts
html: examples/HalfCover.html
title: Half Cover, Bottom-Right
description: A 72 px half-cover shield positioned bottom-right with an E direction marker.
```

## Cover Broken by a Flank

A full-cover shield dropped to the exposed state with a new direction via `setCover()` after construction.

```example
file: examples/DynamicFlank.ts
html: examples/DynamicFlank.html
title: Cover Broken by a Flank
description: A full-cover indicator switched to none with a new direction using setCover().
```

```api
```