# XWUIChartButterfly

A comparison chart variant backed by `XWUIChart` that mirrors two series back-to-back around a shared center axis (a tornado/pyramid layout), ideal for contrasting two groups across the same categories. Provide named `series` of `{ x, y }` points and pick a `block` (1-4) and `size` preset.

## Basic Usage

Two named monthly series mirrored as a butterfly chart.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two monthly series drawn back-to-back as a butterfly chart at the md preset.
```

## Population Pyramid

Male and female population (in millions) mirrored across nine age brackets to read the demographic balance at a glance.

```example
file: examples/PopulationPyramid.ts
html: examples/PopulationPyramid.html
title: Population Pyramid
description: Male versus female population mirrored across age brackets with legend and axis labels.
```

## Survey: Agree vs Disagree

Agree and disagree percentages set back-to-back per workplace-policy topic, drawn in block 2 with a percent unit.

```example
file: examples/SurveyAgreement.ts
html: examples/SurveyAgreement.html
title: Survey: Agree vs Disagree
description: Agree versus disagree percentages contrasted across survey topics in block 2.
```

```api
```