# XWUIChartEventTimeline

An event-timeline chart: a fixed-type (`eventTimeline`) wrapper around `XWUIChart` that lays
discrete events out along a time axis so you can read their order, spacing, and grouping at a
glance. Pass `series` of `{ name, data: [{ x, y }] }` where `x` is the time position, plus an
optional `block` preset (1-4) and `size` (`sm` / `md` / `lg`); the shared block config
also exposes legend, grid, axis, and tooltip-formatter toggles. Use it to chart milestones,
incidents, or activity over a period.

## Basic Usage

Two named series of monthly entries placed along a single time axis at the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two monthly series arranged as events along a shared timeline.
```

## Deployment Frequency by Week

Ten weeks of deploy counts along the timeline, with a shaded region marking a change-freeze window
where releases pause.

```example
file: examples/DeploymentFrequency.ts
html: examples/DeploymentFrequency.html
title: Deployment Frequency by Week
description: Weekly deploy counts with a region annotation over the change-freeze weeks.
```

## Incident Count by Month

Monthly incident totals with a critical-severity subseries, plus a horizontal SLA threshold line to
spot breached months.

```example
file: examples/IncidentCount.ts
html: examples/IncidentCount.html
title: Incident Count by Month
description: Monthly incidents and Sev1 counts with an SLA threshold line at 7.
```

```api
```