# XWUIChartCosine

A cosine chart: a fixed-type (`type: 'cosine'`) wrapper around `XWUIChart` that draws
each `series` as a smooth cosine-style wave through its `{ x, y }` points. Pass a
`block` preset (1-4) and `size` (`sm` / `md` / `lg`); the shared block
config also exposes legend, grid, axis, 3D, line-style, and data-label toggles. Use
it when you want a wave-shaped line variant without any per-variant wiring.

## Basic Usage

Two monthly series rendered as cosine waves at the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two {x, y} month series drawn as smooth cosine waves via the cosine chart type.
```

## Tidal Cycle

Semidiurnal tide heights for two Channel ports across a day, where the twice-daily rise and fall is a natural cosine.

```example
file: examples/TidalCycle.ts
html: examples/TidalCycle.html
title: Tidal Cycle
description: 24h tide heights for Portsmouth and Dover with metre tooltips and time-of-day axis labels.
```

## AC Waveform

One 20 ms cycle of 50 Hz mains voltage on two phases, the textbook cosine application.

```example
file: examples/ACWaveform.ts
html: examples/ACWaveform.html
title: AC Waveform
description: Two-phase ±325 V mains voltage over a single cycle on a value grid, no point markers.
```

```api
```