filters

Clear all registered semantic color names for the current context.

Register semantic color names (e.g. Pokémon types) for `resolve_color`(). Raises ``ValueError`` immediately if any color value fails `sanitize_color`() validation.

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

Return ``white`` or ``#1a1a1a`` for readable text on solid *css_color*. Supports hex, ``rgb()``, ``hsl()``, and ``oklch()`` color formats. Emits `ChirpUIValidationWarning` when the color cannot be parsed (falls back to ``white``).

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 emits `ChirpUIValidationWarning` on fallback (raises ``ValueError`` in strict mode).

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 emits `ChirpUIValidationWarning` on fallback when the block has a registered size list (raises ``ValueError`` in strict mode).

Resolve icon name to glyph; unknown names pass through. Always emits `ChirpUIValidationWarning` for unrecognized names (raises ``ValueError`` in 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. Expects ``errors[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 using `STATUS_WORDS`. Lookup is case-insensitive. Unrecognized words return *default* and emit `ChirpUIValidationWarning`.

Build a dict of hyphenated HTML attributes from keyword arguments. Converts underscores to hyphens in keys: ``hx_post`` becomes ``hx-post``. Pipe through ``html_attrs`` to render: ``{{ build_hx_attrs(...) | html_attrs }}``. Accepts an optional ``hx`` dict whose keys are the short htmx names (e.g. ``{"post": "/save", "target": "#out"}`` → ``hx-post``, ``hx-target``). Individual ``hx_*`` kwargs override keys from the ``hx`` dict. Emits `ChirpUIValidationWarning` for 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``), internal ``href`` 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.