Install
pip install chirp-ui==0.8.0
# or
uv add chirp-ui==0.8.0
With Chirp:
pip install "bengal-chirp[ui]"
What's New
Framework-neutral library contract
Chirp UI now exposes an importable package contract for host frameworks and static-site generators. Consumers can discover the template root, static asset root, ordered CSS and JavaScript entries, manifest path, and runtime metadata without hardcoding package internals.
Usechirp_ui.get_library_contract() or chirp_ui.LIBRARY_CONTRACTwhen a
host needs to wire Chirp UI into its own asset pipeline.
Chirp theme migration
The packaged Bengalchirp-themenow routes much more of its default output
through Chirp UI-native templates, assets, and content surfaces. The release
adds or rebuilds taxonomy pages, learning pages, shortcodes, autodoc and
OpenAPI reference templates, utility pages, and theme docs around Chirp UI
composition primitives.
This release also removes a large amount of dormant copied theme CSS in favor of the current Chirp UI contracts.
Kida 0.9 adoption and safety checks
The Kida dependency floor is nowkida-templates>=0.9.0. Chirp UI uses Kida's
literal attribute and static analysis APIs for manifest extraction, privacy
linting, and trusted-markup escape audits.
A newuv run poe escape-audittask prints the Kida-backed trusted-markup
inventory for shipped macros.
Upgrade Notes
This is a minor release because it adds public integration metadata and raises the Kida floor.
- Hosts that inspect package internals should move to
chirp_ui.get_library_contract(). - Environments must install
kida-templates>=0.9.0. - Bengal theme consumers should expect the default theme to emit more Chirp UI-native markup and fewer legacy copied CSS surfaces.
Verification
Release prep passed:
uv run poe cimake build