# XWUIChartComparison

A comparison chart: a fixed-type wrapper around `XWUIChart` that places two or more
series side by side so the differences between them are immediately obvious. Pass
`series` of `{ x, y }` data plus a `block` preset (1-4) and `size`
(`sm` / `md` / `lg`); the shared block config also exposes legend, grid,
axis, data-label, and tooltip-formatter toggles. Use it when the point of the chart is
the gap between series, not their individual trends.

## Basic Usage

Two monthly `{ x, y }` series fed to the comparison renderer at the md size preset,
drawn side by side to make the gap between them stand out.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two {x, y} series placed side by side through the comparison type.
```

## Sales Year over Year

This year's monthly sales placed beside last year's to expose the gap each month.

```example
file: examples/SalesYearOverYear.ts
html: examples/SalesYearOverYear.html
title: Sales Year over Year
description: Monthly retail sales for this year against last year, with the year-over-year gap shown side by side.
```

## Budget Plan vs Actual

Planned versus actual project spend per phase, highlighting where the budget overran.

```example
file: examples/BudgetPlanVsActual.ts
html: examples/BudgetPlanVsActual.html
title: Budget Plan vs Actual
description: Planned against actual spend per project phase, with data labels marking the overruns.
```

```api
```