# XWUIViewport3D

3D viewport powered by Three.js. Includes grid, rulers, nav controls, and a simple object-list API for placing primitives.

## Basic Usage

Empty 3D viewport with default chrome.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Empty 3D viewport with default chrome.
```

## With Objects

Cube + sphere + tower placed at startup.

```example
file: examples/WithObjects.ts
html: examples/WithObjects.html
title: With Objects
description: Cube + sphere + tower placed at startup.
```

## City Blocks

Box primitives of varying height form a city massing study from a tilted camera.

```example
file: examples/CityBlocks.ts
html: examples/CityBlocks.html
title: City Blocks
description: A grid of box towers viewed from an angled initial camera.
```

## Solar System

Sphere primitives sized like the sun and planets along the X axis.

```example
file: examples/SolarSystem.ts
html: examples/SolarSystem.html
title: Solar System
description: Sun and inner planets as spheres with the grid hidden.
```

```api
```