# XWUIDashboardDateRangeCompare

A compact period-over-period comparison control for dashboard headers. It shows the primary date range as a chip, lets the user switch how it is compared (previous period, previous year, or a custom range), and renders the resolved comparison range with a computed summary like "vs previous 30 days".

## Basic Usage

A primary range compared against the previous equal-length period, with a change listener.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A primary range compared against the previous equal-length period, with a change listener.
```

## Custom Comparison Range

Switching to a host-supplied custom comparison range and reacting to the "choose range" click.

```example
file: examples/CustomComparison.ts
html: examples/CustomComparison.html
title: Custom Comparison Range
description: Switching to a host-supplied custom comparison range and reacting to the "choose range" click.
```

## API

```api
```