# XWUITaxSummary

A tax-summary report that pivots `entries` into a jurisdiction (rows) by tax-type (columns) matrix, showing each cell's rate, tax due, and a payable/refund/reconciled badge derived from tax collected. It auto-totals per jurisdiction (Total payable column) and per tax type (footer), with `showRate`/`showCollected`/`density` toggles, and composes `XWUIDisplayMonetary`. Pass per-cell click handlers via `onCellClick()`.

## Basic Usage

A USD summary across three jurisdictions - Federal (21%), State CA (8.84%), and City SF (0.75%) - each on a 480,000 taxable base.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A USD tax summary with Federal, California, and San Francisco rows on a shared 480,000 taxable base.
```

## Multi-State Sales & Use Tax

A US nexus filing where each state row spans both Sales Tax and Use Tax columns with payable badges.

```example
file: examples/MultiStateSalesTax.ts
html: examples/MultiStateSalesTax.html
title: Multi-State Sales & Use Tax
description: Sales and use tax across four states with collected-versus-due reconciliation.
```

## International VAT / GST Registrations

A cross-border VAT matrix across EU, GCC and UK registrations, surfacing a refund position in compact density.

```example
file: examples/InternationalVat.ts
html: examples/InternationalVat.html
title: International VAT / GST Registrations
description: EU, GCC and UK VAT registrations with an over-collection refund badge.
```

```api
```