# XWUIGameSnapControls

A compact build-placement toolbar combining a snap toggle, snap-size buttons, and rotation controls. The SNAP button toggles `data.snapEnabled`, a row of size buttons (`conf_comp.snapOptions`, default 0.25 / 0.5 / 1 / 2) sets `data.snapSize`, and ↺ / ↻ buttons rotate by `conf_comp.rotateStep` (default 15°, wrapping 0-360) tracking `data.rotation`. Each action dispatches a matching event: `snap-toggle`, `snap-size`, and `rotate` (each detail carrying the new value). Use `toggleSnap()`, `setSnapSize(size)`, `rotate(deg)`, and `updateData({ snapEnabled, snapSize, rotation })` to control it.

## Basic Usage

A toolbar to toggle snap, pick a snap size, and rotate placement in fixed steps.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Snap on/off toggle, snap-size selector, and step-rotate controls emitting snap/rotate events.
```

## Fine Grid

Supplies a custom `snapOptions` ladder for precision building and starts on the fine 0.25 grid step.

```example
file: examples/FineGrid.ts
html: examples/FineGrid.html
title: Fine Grid
description: A precision toolbar with a custom snapOptions ladder starting on the 0.25 step.
```

## Free Placement

Starts with snap turned off and a coarse 45° rotateStep for quick free-form prop dropping.

```example
file: examples/FreePlacement.ts
html: examples/FreePlacement.html
title: Free Placement
description: Snap disabled at start with a coarse 45° rotateStep for free-form placement.
```

```api
```