# XWUIChartAlluvial

A flow chart backed by `XWUIChart` that shows how quantities move between stages as proportionally-sized ribbons. Supply `nodes` (stage buckets) and `links` (source to target with a `value`) instead of x/y series to trace how volume splits and merges across a pipeline.

## Basic Usage

A source to mid to sink flow where ribbon thickness tracks each link's value.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two sources merging into a mid node and splitting into two sinks, sized by flow value.
```

## Acquisition Funnel Flow

Traffic from three channels merging into sign-ups, then splitting into activated and churned outcomes.

```example
file: examples/AcquisitionFunnel.ts
html: examples/AcquisitionFunnel.html
title: Acquisition Funnel Flow
description: Channels flowing through sign-up into activated vs churned, sized by user volume.
```

## Energy Source-to-Sector Flow

Four generation sources routed through the grid out to industry, residential, and transport demand, sized in TWh.

```example
file: examples/EnergyFlow.ts
html: examples/EnergyFlow.html
title: Energy Source-to-Sector Flow
description: Primary energy sources flowing through the grid into consuming sectors.
```

```api
```