# XWUIGamePlacementGhost

A build-mode info bar that surfaces the state of the object being placed. It shows a Valid/Invalid status dot (driven by `data.valid`), the `data.objectName`, the `data.position` (POS) and `data.rotation` (ROT, in degrees) fields, and a SNAP ON/OFF badge from `data.snapActive`. Hide the position field with `conf_comp.showGrid: false`. This is the HUD readout for a placement preview; drive it every frame with `updateData({ valid, position, rotation, objectName, snapActive })` to keep validity, coordinates, and snap state current.

## Basic Usage

Displays a placement validity dot with position, rotation, and snap status.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Build-mode info bar showing valid/invalid placement plus position, rotation, and snap state.
```

## Rotate And Snap

Steps the ghost through move, rotate, and snap states with `updateData()`, ending on an invalid placement.

```example
file: examples/RotateAndSnap.ts
html: examples/BasicUsage.html
title: Rotate And Snap
description: Per-frame updateData() calls move, rotate, and snap the piece, then flag it invalid.
```

## Valid vs Invalid

Contrasts an allowed placement against a blocked one that hides the position field.

```example
file: examples/ValidVsInvalid.ts
html: examples/BasicUsage.html
title: Valid vs Invalid
description: Two info bars comparing a valid, snapped placement with a blocked invalid one.
```

```api
```