# XWUIChartConversionFlow

A conversion flow chart (a funnel/Sankey-style flow that traces how users move and drop off across stages from entry to conversion): a fixed-type wrapper around `XWUIChart` that draws weighted bands between stages so the width of each path reflects how much volume carries through versus where it leaks. Pass `nodes` (each `{ name, value }`) and `links` (`{ source, target, value }`) with an empty `series`, plus a `block` preset (1-4) and `size` (`sm` / `md` / `lg`); the shared block config also exposes legend, grid, axis, data-label, and tooltip-formatter toggles. Use it to see at a glance where a multi-step journey concentrates or sheds traffic.

## Basic Usage

A small node-and-link flow (two sources into a hub, splitting to two sinks) rendered by the conversion-flow renderer at the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two sources feed a shared mid stage that fans out to two sinks, with band widths scaled to each link's value.
```

## SaaS Marketing Funnel

Ten thousand paid-ad clicks traced through signup, trial, and paid stages with the drop-off branches split out at each step.

```example
file: examples/MarketingFunnel.ts
html: examples/MarketingFunnel.html
title: SaaS Marketing Funnel
description: A paid-acquisition funnel from ad click to paid conversion, with bounce, abandon, and churn leaks branching off each stage.
```

## Household Energy Sankey

Solar and grid supply feeding a home's daily kWh budget, fanning out to heating, appliances, EV charging, and lighting.

```example
file: examples/HouseholdEnergy.ts
html: examples/HouseholdEnergy.html
title: Household Energy Sankey
description: A daily household energy flow in kWh, from solar and grid sources through the home to each end-use load.
```

```api
```