# XWUIChartGeoshapeThematicMap

Shades a set of custom SVG shapes by a data value - the choropleth approach for showing how
a metric varies across places, but for *any* shape set (real administrative geometry or an
illustrative one), not just world countries. Two render paths:

- **Real shapes** - pass `data.regions` as `{ id, name, path, value?, labelX?, labelY? }[]`,
  where `path` is a plain SVG `d` string, plus `data.viewBox`. Renders inline SVG directly:
  one `<path>` per region, filled by `conf_comp.ramp`, with a name/value label and a native
  `<title>` tooltip. xwui bundles one ready-to-use real set - `SAUDI_ARABIA_REGIONS` /
  `SAUDI_ARABIA_VIEWBOX` (Saudi Arabia's 13 admin-1 regions, Natural Earth 10m data) - so
  shading a real country's regions needs no GeoJSON authoring.
- **Abstract chart** - when `data.regions` is absent, `series` of `{ x, y }` data renders
  through the same fixed-type `XWUIChart` wrapper as the other chart blocks (legacy path,
  unchanged).

Choose a `block` (1-4) and `size` preset; `conf_comp.showLabels` / `showValues` toggle the
per-region text, and `conf_comp.unit` formats the value.

## Basic Usage

Two named monthly series (Series A and Series B), each spanning Jan through Jun, supplied as the thematic-map sample data.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two six-month series rendered as a geoshape thematic map at the md preset.
```

## Saudi Arabia Regions

Order volume shaded across Saudi Arabia's 13 real administrative regions, using the bundled
`SAUDI_ARABIA_REGIONS` geometry directly - no GeoJSON authoring, just a value per ISO 3166-2 code.

```example
file: examples/SaudiArabiaRegions.ts
html: examples/SaudiArabiaRegions.html
title: Saudi Arabia Regions
description: 13 real Saudi Arabia regions shaded by order volume, from the bundled geometry.
```

## Unemployment by State

Twelve US states shaded by unemployment rate, the canonical choropleth read of a metric across regions.

```example
file: examples/UnemploymentByState.ts
html: examples/UnemploymentByState.html
title: Unemployment by State
description: US states shaded by unemployment rate with per-region value labels.
```

## Renewable Energy Share

European countries shaded by the share of electricity from renewables, from hydro-rich Norway down to coal-heavy Poland.

```example
file: examples/RenewableShare.ts
html: examples/RenewableShare.html
title: Renewable Energy Share
description: A green-scaled choropleth of renewable electricity share across Europe.
```

```api
```