# XWUIChartDonut

A donut chart variant backed by `XWUIChart` that splits a single total into proportional ring segments, the familiar part-to-whole view with an open center for a label or summary figure. Provide one named `series` whose `{ x, y }` points are the category and its share, then choose a `block` (1-4) and `size` preset.

## Basic Usage

A single "Share" series of five slices (A through E, summing to 100) rendered as a donut.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A five-slice share breakdown rendered as a donut chart at the md preset.
```

## Center Metric

A storage-usage donut whose headline total rides in the title caption, leaving the ring center clean.

```example
file: examples/CenterMetric.ts
html: examples/CenterMetric.html
title: Center Metric
description: Storage split (Documents, Media, Backups, Apps) with the 820 GB of 1 TB total in the title caption.
```

## Category Breakdown

A monthly-budget donut dividing spend across six expense categories.

```example
file: examples/CategoryBreakdown.ts
html: examples/CategoryBreakdown.html
title: Category Breakdown
description: Monthly budget split across Housing, Food, Transport, Utilities, Entertainment, and Savings.
```

## Progress Donut

A single-value completion donut where two slices sum to 100% to read as a progress ring.

```example
file: examples/ProgressDonut.ts
html: examples/ProgressDonut.html
title: Progress Donut
description: A 72% onboarding-progress ring built from Complete and Remaining slices.
```

```api
```