# XWUIChartSankey

A Sankey diagram: a fixed-type wrapper around `XWUIChart` that draws flows between nodes as
proportional ribbons, where each link's width encodes its value, so you can trace how a
quantity splits and merges from sources to sinks. Supply `nodes` (each `{ name, value }`)
and `links` (each `{ source, target, value }`) rather than plain series, plus an optional
`block` preset (1-4) and `size` (`sm` / `md` / `lg`); the shared block config
forwards legend, grid, axis, data-label, and tooltip toggles. Use it for budgets, energy
flows, conversion funnels, and other flow data.

## Basic Usage

Five nodes connected by four weighted links flowing from two sources through a middle stage
into two sinks, at the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A source-to-sink flow defined by nodes and links via the sankey chart type.
```

## Website Traffic Flow

A week of visitors moves from acquisition channels through landing pages into signups or exits.

```example
file: examples/WebsiteTrafficFlow.ts
html: examples/WebsiteTrafficFlow.html
title: Website Traffic Flow
description: Channels to landing pages to conversion or exit via the sankey chart type.
```

## National Energy Flow

Four generation sources pool into a grid that redistributes power across end-use sectors.

```example
file: examples/EnergyFlow.ts
html: examples/EnergyFlow.html
title: National Energy Flow
description: Generation sources through a shared grid into demand sectors via the sankey chart type.
```

```api
```