filters

Clear all registered semantic color names for the current context.

Register semantic color names (e.g. Pokémon types) forresolve_color().

RaisesValueErrorimmediately if any color value fails sanitize_color() validation.

Return the color if it matches a safe CSS color pattern, else None.

Returnwhite or #1a1a1afor readable text on solid css_color.

Supports hex,rgb(), hsl(), and oklch()color formats. EmitsChirpUIValidationWarningwhen the color cannot be parsed (falls back towhite).

Resolve a named color from the registry, then validate as a CSS color string.

Build chirpui BEM class string from block, axes, size, and modifiers.

Example::

class="{{ "btn" | bem(variant="primary", size="lg", modifier="loading") }}"
→ "chirpui-btn chirpui-btn--primary chirpui-btn--lg chirpui-btn--loading"

class="{{ "btn" | bem(appearance="outlined", tone="danger") }}"
→ "chirpui-btn chirpui-btn--outlined chirpui-btn--danger"

modifier accepts a single string or a list of strings for additive flags.

Return value if in allowed, else default.

Always emitsChirpUIValidationWarning on fallback (raisesValueErrorin strict mode).

Semantic alias groups (e.g.error / danger) are accepted when the block's allowed tuple includes any member of the same group.

Return value if in VARIANT_REGISTRY for block, else default. When strict, log warning.

Return value if in APPEARANCE_REGISTRY for block, else fallback.

Return value if in TONE_REGISTRY for block, else fallback.

Warn when a deprecated parameter is used and return value unchanged.

Used in templates to signal deprecation while preserving backward compat::

{% set _attrs_raw = attrs_unsafe or (attrs | deprecate_param("attrs", "attrs_unsafe or attrs_map")) %}

Map Python types to ChirpUI CSS variant names for description_item.

Returns: "unset" | "bool" | "number" | "path" | "" (plain string).

Return value if in SIZE_REGISTRY for block, else default.

Always emitsChirpUIValidationWarning on fallback when the block has a registered size list (raisesValueErrorin strict mode).

Resolve icon name to glyph; unknown names pass through.

Always emitsChirpUIValidationWarning for unrecognized names (raisesValueErrorin strict mode).

Extract error messages for a field from a ValidationError-style dict.

Returns empty list if errors is None, not a dict, or field has no errors. Expectserrors[field_name]to be a list or tuple of strings. Non-list values (e.g. nested dicts from DRF/Pydantic) are coerced to [str(val)] with a ChirpUIValidationWarning.

Map a status string to a badge variant usingSTATUS_WORDS.

Lookup is case-insensitive. Unrecognized words return default and emitChirpUIValidationWarning.

Build a dict of hyphenated HTML attributes from keyword arguments.

Converts underscores to hyphens in keys:hx_post becomes hx-post. Pipe throughhtml_attrs to render: {{ build_hx_attrs(...) | html_attrs }}.

Accepts an optionalhxdict whose keys are the short htmx names (e.g.{"post": "/save", "target": "#out"} → hx-post, hx-target). Individualhx_* kwargs override keys from the hxdict.

EmitsChirpUIValidationWarningfor unrecognized htmx attribute names (possible typos). Event handlers (hx-on:*) and non-hx-keys pass through without warning.

Return value if provided, else fallback with a validation warning.

Use in macros where a hardcoded fallback ID would cause collisions if multiple instances appear on the same page::

{% set _id = check_required_id(swap_id, "inline-edit-field", "inline_edit_field") %}

Build a template global for route-aware link attrs.

The default no-op version keeps standalone chirp-ui renderable. When swap_resolver is supplied (for example by Chirp's use_chirp_ui), internalhref values can inherit route-aware hx-target / hx-boost attrs automatically.

Render HTML attrs from mapping or legacy raw string.

Return the Bengal logical asset path for a Chirp UI provider asset.