# XWUIChartSwarm

A swarm chart: a fixed-type wrapper around `XWUIChart` that plots individual points per category and nudges overlapping ones sideways so none hide each other, revealing the full distribution shape. Supply `{ series }` of `{ x, y }` points plus a `block` preset (1-4) and `size`. Use it when a strip plot would overplot and you want every observation visible as a beeswarm cluster.

## Basic Usage

Two series (Series A and Series B) of six monthly values, Jan through Jun, rendered at medium size as two offset clusters of monthly points, overlapping values nudged sideways so each stays visible.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two monthly series drawn as offset beeswarm clusters with overlapping points nudged apart.
```

## Salary Distribution

Individual salaries plotted per department and nudged into beeswarm clusters, so the wide engineering spread and the tighter support band are both visible without any point hiding another.

```example
file: examples/SalaryDistribution.ts
html: examples/SalaryDistribution.html
title: Salary Distribution
description: Per-employee salaries scattered into filled beeswarm clusters across three departments.
```

## API Response Times

Per-request latency samples for three endpoints scattered as hollow-point clusters, where the long tail on /search and the lone slow outliers stay visible instead of overplotting.

```example
file: examples/ResponseTimes.ts
html: examples/ResponseTimes.html
title: API Response Times
description: Endpoint latency samples drawn as hollow beeswarm clusters that surface tails and outliers.
```

```api
```