# XWUIChartBudgetLine

A budget-line chart backed by `XWUIChart` (`type: 'budgetLine'`) that tracks budgeted versus actual figures as lines over a time axis. Provide named `series` of `{ x, y }` points and pick a `block` (1-4) and `size` preset (`sm`, `md`, `lg`); legend and grid auto-toggle per block, and line weight, dash style, and arrow markers can be forwarded to the underlying chart.

## Basic Usage

Two named monthly series ("Series A" and "Series B") plotted across Jan-Jun at the md preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two monthly series rendered as a budget-line chart at the md size preset.
```

## Monthly Budget vs Actual

A dashed budget plan line tracked against the actual-spend line so a controller can watch monthly variance.

```example
file: examples/MonthlyBudgetVsActual.ts
html: examples/MonthlyBudgetVsActual.html
title: Monthly Budget vs Actual
description: A dashed budget line versus actual marketing spend over six months.
```

## Cumulative Budget Burndown

The annual capital budget drawn down quarter by quarter - planned straight-line versus committed-to-date.

```example
file: examples/CumulativeBurndown.ts
html: examples/CumulativeBurndown.html
title: Cumulative Budget Burndown
description: Dotted straight-line capex plan against cumulative committed spend with trend arrows.
```

```api
```