# XWUIChartBeeswarm

A distribution chart variant backed by `XWUIChart` that scatters one dot per observation and nudges them apart so overlapping points spread into a swarm, revealing density without hiding individual values. Provide a `series` of `{ x, y }` observation points and pick a `block` (1-4) and `size` preset.

## Basic Usage

Thirty randomized observations spread into a beeswarm.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A single series of 30 random observations rendered as a beeswarm at the md preset.
```

## Salary Spread by Department

One dot per employee plotted by salary and grouped into three teams to show each department's pay range.

```example
file: examples/SalaryByDept.ts
html: examples/SalaryByDept.html
title: Salary Spread by Department
description: Per-employee salaries grouped into engineering, sales, and support swarms.
```

## Marathon Finish Times

Runners plotted by finish time and split into age brackets, the distribution shifting slower and wider with age.

```example
file: examples/MarathonTimes.ts
html: examples/MarathonTimes.html
title: Marathon Finish Times
description: Per-runner finish times grouped into three age-bracket swarms.
```

```api
```