# XWUIChartChernoffFaces

A Chernoff faces chart (encodes multivariate data into facial features - eyes, mouth, brows and so on - so viewers lean on face perception to compare many variables at once): a fixed-type wrapper around `XWUIChart` that maps each data point's values onto the features of a face. Pass each group as a `series` of `{ x, y }` values plus a `block` preset (1-4) and `size` (`sm` / `md` / `lg`); the shared block config also exposes legend, grid, axis, data-label, and tooltip-formatter toggles. Use it to make patterns across several variables easier to recognize at a glance.

## Basic Usage

Two monthly `{ x, y }` series, "Series A" and "Series B", encoded as faces at the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A Chernoff faces chart encoding two monthly series as comparable facial features.
```

## Country Socio-Economic Profiles

Six countries rendered as faces encoding their Human Development Index, with a legend and axis labels tying each face to its country.

```example
file: examples/CountryProfiles.ts
html: examples/CountryProfiles.html
title: Country Socio-Economic Profiles
description: A Chernoff faces chart encoding each country's composite HDI score.
```

## Product Feature Scores

Six competing products turned into faces by their overall feature score on the block-2 preset for quick visual comparison.

```example
file: examples/ProductComparison.ts
html: examples/ProductComparison.html
title: Product Feature Scores
description: A Chernoff faces chart encoding an overall feature score per product.
```

```api
```