# XWUIDashboardComparisonMatrix

A side-by-side comparison table for multiple entities (segments, campaigns, regions, competitors) across multiple metrics. Each metric row highlights whichever entity holds the best value, using each metric's own higher-is-better or lower-is-better rule.

## Basic Usage

Three marketing campaigns compared across four metrics; the best value in each row is highlighted.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Three marketing campaigns compared across four metrics; the best value in each row is highlighted with a bold, accented cell.
```

## Lower Is Better Metric

Mix metrics where the highest value wins with metrics where the lowest value wins.

```example
file: examples/LowerIsBetterMetric.ts
html: examples/LowerIsBetterMetric.html
title: Lower Is Better Metric
description: Regions compared where revenue rewards the highest value but cost-per-acquisition and churn rate reward the lowest, set per metric with higherIsBetter: false.
```

## Interactive Columns

Remove an entity column or ask the host to add one.

```example
file: examples/InteractiveColumns.ts
html: examples/InteractiveColumns.html
title: Interactive Columns
description: Each entity column's "x" removes that column and fires onRemoveEntity(id); the trailing "+" column fires onAddEntity() so the host can open its own entity picker.
```

## API

```api
```