# XWUIChartCircularHeatmap

A circular heatmap: a fixed-type wrapper around `XWUIChart` that wraps a row/column
grid of values around a ring and shades each cell by magnitude, so cyclical data
(hours, weekdays, months) reads without a hard start-and-end edge. Pass `series` as
one entry per row, each holding `{ x, y }` cells, plus a `block` preset (1-4) and
`size` (`sm` / `md` / `lg`); the shared block config also exposes legend,
grid, axis, and tooltip-formatter toggles. Use it when the categories on one axis
form a closed cycle.

## Basic Usage

A 5-row by 7-column grid of random magnitudes shaded around the ring at the medium
size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A 5x7 matrix of random values rendered as ring-wrapped, magnitude-shaded cells.
```

## Hourly Traffic Ring

Server request rate across a week, with hours wrapped around the ring and a row per weekday.

```example
file: examples/HourlyTraffic.ts
html: examples/HourlyTraffic.html
title: Hourly Traffic Ring
description: Web request rate by hour-of-day around the ring, one row per weekday, with interactive req/s tooltips.
```

## Monthly Rainfall Ring

Average monthly rainfall for three cities, with the twelve months wrapped into a closed ring.

```example
file: examples/MonthlyRainfall.ts
html: examples/MonthlyRainfall.html
title: Monthly Rainfall Ring
description: Average rainfall per month around the ring, one row per city, with millimetre data labels.
```

```api
```
