# XWUIChartFlowChart

A flow chart: a graph-family variant (extends `XWUIChartGraphBlockBase`, not the Cartesian
`XWUIChart`) that lays nodes out as a left-to-right tree and connects them with directed links, so
process or pipeline flow reads naturally across the page. Pass `nodes` of `{ name, value }` and
`links` of `{ source, target, value }` (series may be empty) plus an optional `block` preset (1-4)
and `size` (`sm` / `md` / `lg`). Use it for process diagrams, decision flows, or any
directed source-to-sink routing.

## Basic Usage

A five-node flow (two sources into a shared `Mid`, then out to two sinks) laid out left-to-right at
the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A sources-to-sinks node/link graph laid out as a left-to-right flow.
```

## Website Conversion Funnel Flow

Visitors flow from Visit through Signup, Trial, and Paid, with drop-off siphoned into a Churned sink at every stage.

```example
file: examples/ConversionFunnelFlow.ts
html: examples/ConversionFunnelFlow.html
title: Website Conversion Funnel Flow
description: User counts splitting across funnel stages with a shared Churned sink, interactive on hover.
```

## Energy Supply Mix

Generation sources pool into a central Grid that then distributes power across consumption sectors.

```example
file: examples/EnergySupplyMix.ts
html: examples/EnergySupplyMix.html
title: Energy Supply Mix
description: Coal, Gas, Solar, and Wind feeding a grid that supplies residential, industrial, and commercial demand.
```

```api
```