# XWUIChartBar

A bar chart block (9 variants) backed by `XWUIChart` that renders each data point as a rectangular bar for comparing discrete categories. Provide named `series` of `{ x, y }` points and select a `block` (1-4) and `size` preset; legend and grid auto-toggle per block unless overridden.

## Basic Usage

Two named monthly series rendered as grouped bars.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two monthly series drawn as a grouped bar chart at the md preset.
```

## Grouped Series

Two named series (2024 vs. 2025) compared per quarter, each given a distinct fill via the per-series `style.fill` so the year-over-year comparison stays legible.

```example
file: examples/GroupedSeries.ts
html: examples/GroupedSeries.html
title: Grouped Series
description: Year-over-year quarters as two color-coded series.
```

## Many Categories

A single series spanning all 12 months with X-axis labels enabled, showing how the bar block handles a wide categorical axis without crowding.

```example
file: examples/ManyCategories.ts
html: examples/ManyCategories.html
title: Many Categories
description: Twelve named monthly category bars in one chart.
```

## Negative Values (Profit & Loss)

Monthly net profit/loss where several months dip below zero; data labels and grid values make the sign and magnitude of every bar explicit.

```example
file: examples/NegativeValues.ts
html: examples/NegativeValues.html
title: Negative Values (Profit & Loss)
description: P&L data swinging above and below the zero baseline.
```

## Single Series, Ranked

One series sorted descending before construction so the bars form a clean ranked, Pareto-style profile.

```example
file: examples/SingleSeriesRanked.ts
html: examples/SingleSeriesRanked.html
title: Single Series, Ranked
description: A single series pre-sorted high-to-low into a ranked profile.
```

```api
```