"""Inline-SVG rendering helpers over the registry (stdlib only). The HM-side twins of Dazzle's ``render/fragment/icon_html.py`` — kept tiny and dependency-free so the gallery builds in the standalone repo. Unknown names: ``lucide_icon_html`` falls back to a ``data-lucide`` span (client hydration); ``lucide_svg_html`` silently uses *fallback* (both arguments are author-chosen constants here, never user input). """ import html as _html from .registry import ICONS _SVG_SHELL = ( '{inner}' ) def _a11y_attrs(label: str | None) -> str: """Decorative by default (``aria-hidden``); *label* exposes an accessible name (``role=img``). HM convention is icon+text everywhere, so the common path stays decorative — *label* is the genuinely icon-only escape hatch.""" if label is None: return ' aria-hidden="true"' return f' role="img" aria-label="{_html.escape(label, quote=True)}"' def lucide_icon_html(name: str, *, cls: str, label: str | None = None) -> str: """Icon *name* inside a ```` wrapper. Decorative by default.""" inner = ICONS.get(name) a11y = _a11y_attrs(label) if inner is not None: return f'{_SVG_SHELL.format(inner=inner)}' return f'' def lucide_svg_html( name: str, *, cls: str, fallback: str = "inbox", label: str | None = None ) -> str: """Bare ```` for a registry name — for slots whose CSS styles the ``svg`` element directly (badge, alert, empty-state icon boxes). Decorative by default; pass *label* to expose an accessible name.""" inner = ICONS.get(name) or ICONS[fallback] cls_attr = f' class="{cls}"' if cls else "" return ( f'{inner}' )