# XWUIChartFlowMap

A flow-map chart: a fixed-type (`flowMap`) wrapper around `XWUIChart` that draws weighted links
between nodes to show movement or transfer between places, with link magnitude encoding flow volume.
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
migration, trade, traffic, or any origin-to-destination flow where the amount carried matters.

## Basic Usage

A five-node flow (two sources into a shared `Mid`, then out to two sinks) with value-weighted links
at the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A weighted source-to-sink node/link network rendered as a flow map.
```

## Migration Between Cities

Population moves between five U.S. cities, with each link weighted by the number of people relocating.

```example
file: examples/MigrationBetweenCities.ts
html: examples/MigrationBetweenCities.html
title: Migration Between Cities
description: Mover counts between NYC, LA, Chicago, Miami, and Seattle drawn as weighted flows, interactive on hover.
```

## Global Shipping Routes

Container traffic in TEU along the busiest ocean lanes connecting four major ports.

```example
file: examples/GlobalShippingRoutes.ts
html: examples/GlobalShippingRoutes.html
title: Global Shipping Routes
description: TEU volume between Shanghai, Singapore, Rotterdam, and LA encoded as link magnitude, with a port legend.
```

```api
```