# XWUIChartRegressionScatter

A regression scatter chart: a fixed-type wrapper around `XWUIChart` that draws each
observation as a point and fits a regression line through the cloud, combining the raw
scatter with the modelled trend in one view. Pass your data as `series` of `{ x, y }`
points plus an optional `block` preset (1-4) and `size` (`sm` / `md` / `lg`);
the shared block config also forwards legend, grid, axis, data-label, and tooltip toggles.
Use it to judge correlation strength and the fit at the same time.

## Basic Usage

A single series of 30 randomly scattered observations with a fitted regression line at the
md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Thirty random points plus a fitted line via the regressionScatter chart type.
```

## Study Hours vs Exam Score

A student-level scatter of weekly study hours against exam score with a positive regression overlay confirming the upward correlation.

```example
file: examples/StudyScore.ts
html: examples/StudyScore.html
title: Study Hours vs Exam Score
description: Study hours against exam scores with a positive-trend regression overlay.
```

## Car Weight vs Fuel Economy

Vehicle curb weight scattered against highway mpg with a downward-sloping fit, shown with hollow points to read the negative correlation.

```example
file: examples/CarWeightMpg.ts
html: examples/CarWeightMpg.html
title: Car Weight vs Fuel Economy
description: Curb weight against highway mpg as a hollow-point scatter with a negative fit.
```

```api
```