# XWUIChartIcicle

An icicle chart variant backed by `XWUIChart` that renders a hierarchy as nested rectangles whose lengths encode each node's value, a rectangular cousin of the sunburst for reading tree structure and proportions together. Supply a `nodes` tree (each node a `{ name, value }` with optional `children`) rather than flat `series`, then choose a `block` (1-4) and `size` preset.

## Basic Usage

A small tree rooted at "Root" with branch A (split into A1 and A2) alongside leaves B and C, drawn as stacked icicle bars.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A three-branch hierarchy with one nested split rendered as an icicle chart at the md preset.
```

## Repository Disk Usage

A project repository's storage footprint broken down by folder and the heaviest files within each.

```example
file: examples/DiskUsageTree.ts
html: examples/DiskUsageTree.html
title: Repository Disk Usage
description: A codebase's disk usage drilled down from top-level folders into their largest dependencies and build artifacts.
```

## Departmental Budget

An annual operating budget split across divisions and down to individual spending line items.

```example
file: examples/OrgBudgetTree.ts
html: examples/OrgBudgetTree.html
title: Departmental Budget
description: A company operating budget broken down from divisions into department-level line items in thousands of dollars.
```

```api
```