# XWUIChartLiquid

A liquid percentage gauge backed by `XWUIChart` (via the `@xw3d` 2D layer) whose fill level encodes a single percent value, ideal for showing one figure's progress toward 100%. The fill is read from `series[0].data[0].y` (accepts 0..1 or 0..100); you also pick a `block` (1-4) variant and a `size` preset.

## Basic Usage

A single `Progress` point with `y: 64` fills the gauge to 64%.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A liquid gauge filled to 64% at the md preset.
```

## Reservoir Fill Level

A liquid gauge reporting how full a water reservoir is against its total capacity.

```example
file: examples/ReservoirLevel.ts
html: examples/ReservoirLevel.html
title: Reservoir Fill Level
description: A municipal reservoir gauge sitting at 38% of capacity to flag a developing drought.
```

## Quarterly Sales Goal

A liquid gauge tracking attainment of the quarter's revenue target.

```example
file: examples/SalesGoal.ts
html: examples/SalesGoal.html
title: Quarterly Sales Goal
description: A sales-target gauge filled to 82% to show the quarterly goal is within reach.
```

```api
```