# chirp-ui 0.3.0

URL: /chirp-ui/releases/0.3.0/
Section: releases
Description: Release 0.3.0

---

> For a complete page index, fetch /chirp-ui/llms.txt.

## Install

```bash
pip install chirp-ui==0.3.0
# or
uv add chirp-ui==0.3.0
```

With Chirp:

```bash
pip install "bengal-chirp[ui]"
```

## What's New

- **kida 0.4.0 adoption** --- Native error boundaries (`{% try %}`/`{% fallback %}`), list comprehensions, scoped slots (`let:`), and opt-in partial evaluator. Error boundaries added to `suspense_slot`, `oob_fragment`, `streaming_bubble`, `streaming_block`, and `safe_region`/`fragment_island`.
- **Elevated design layer** --- Display type scale (`prose-6xl`/`prose-7xl` up to 74px), gradient text variants, 5-layer `shadow-deep` token, `divider--dotted` and `divider--fade` patterns, `grain--dot` texture, and `surface--cornered` corner-bracket accents.
- **Provide/consume expansion** --- `surface`/`panel` provide `_surface_variant`, `card` provides `_card_variant`, `accordion` provides `_accordion_name`, `form` gains `density` param, `sidebar`/`navbar` gain `current_path`. Full key registry in `docs/PROVIDE-CONSUME-KEYS.md`.
- **ASCII component maturity** --- 3 new composites (`ascii_card`, `ascii_tabs`, `ascii_modal`), 152 render tests for all 27 ASCII components, a11y improvements.
- **Streaming & SSE maturity** --- Streaming state variants (`thinking`, `error`), 3 provide/consume context keys, role-aware aria-labels, 45 new tests.
- **Behavior layer hardening** --- Wire all 7 orphaned provide/consume keys to natural consumers with 30 contract tests. Error boundary with message display, retry button, and telemetry event.
- **Island system documentation** --- Architecture, foundation API, all 7 built-in primitives, fragment islands, event protocol, and custom primitive authoring guide.
- **Test infrastructure** --- 115 vitest JS tests, 33 new component render tests, 23 Playwright browser tests.

## Fixes

- **Color system gamma bug** --- `_linear_to_srgb` divided instead of multiplied by 12.92. Widened `sanitize_color` to accept modern CSS. Added 80+ color pipeline tests.
- **`contrast_text()` color formats** --- Now handles `rgb()`, `hsl()`, and `oklch()` instead of silently falling back to white.

## Links

- [PyPI](https://pypi.org/project/chirp-ui/)
- [GitHub](https://github.com/lbliii/chirp-ui)