# XWUIGameContextualTip

A control-hint pill that surfaces a contextual prompt such as "Press E to open" with a key badge, optional icon, and `text`, bouncing in on show and auto-fading after `fadeDelay` seconds (set to 0 to keep it pinned). Position it `bottom-center`, `top-center`, or `center`, and toggle the key badge with `showKey`. Drive it with `show(text, keyHint, icon)` and `hide()`; ideal for interaction prompts that appear when the player nears an object.

## Basic Usage

A bottom-center control hint pill with a key badge that bounces in and auto-fades.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A bottom-center control hint pill with a key badge that bounces in and auto-fades.
```

## Interact Prompt

A top-center talk prompt that appears, then is swapped for a different hint via show().

```example
file: examples/InteractPrompt.ts
html: examples/InteractPrompt.html
title: Interact Prompt
description: A top-center talk prompt that appears, then is swapped for a different hint via show().
```

## Auto-Fade Hint

A centered keyless hint with a short fadeDelay that auto-dismisses on its own.

```example
file: examples/AutoFadeHint.ts
html: examples/AutoFadeHint.html
title: Auto-Fade Hint
description: A centered keyless hint with a short fadeDelay that auto-dismisses on its own.
```

## Danger Warning

A center-screen hazard prompt pushed through `show()` with a key hint and warning icon that auto-fades after its delay.

```example
file: examples/DangerWarning.ts
html: examples/DangerWarning.html
title: Danger Warning
description: A centered hazard warning with a key hint and icon, shown via show() and auto-fading after its delay.
```

## Pinned Objective

A persistent top-center objective hint with the key badge hidden and auto-hide disabled.

```example
file: examples/PinnedObjective.ts
html: examples/PinnedObjective.html
title: Pinned Objective
description: A top-center objective hint with no key badge that stays pinned with auto-hide disabled.
```

```api
```