libstp.ui.widgets

UI Widgets - Type-safe widget definitions for dynamic screens.

These dataclasses serialize to JSON and are rendered by Flutter.

Classes

Widget	Base class for all widgets.
Text	Text display widget.
Icon	Material icon widget.
Spacer	Vertical spacing widget.
Divider	Horizontal divider line.
StatusBadge	Colored pill/badge with text (e.g., "LIGHT ON").
StatusIcon	Animated circle with icon inside.
HintBox	Highlighted hint box (e.g., "Press button when ready").
DistanceBadge	Distance value display badge.
ResultsTable	Key-value results table.
Button	Clickable button.
Slider	Slider input for numeric values.
Checkbox	Checkbox toggle.
Dropdown	Dropdown selection.
NumericKeypad	Touch-friendly numeric keypad (0-9, ., backspace).
NumericInput	Large numeric display with optional +/- buttons.
TextInput	Text input field.
SensorValue	Large sensor value display.
SensorGraph	Real-time sensor line graph.
LightBulb	Animated light bulb visualization.
AnimatedRobot	Robot with spinning wheels visualization.
CircularSlider	Circular slider for motor/servo control.
ProgressSpinner	Circular loading spinner.
PulsingArrow	Animated pulsing arrow.
RobotDrivingAnimation	Robot driving on track animation.
MeasuringTape	Animated measuring tape.
CalibrationChart	Static scatter/line chart for calibration data.
Row	Horizontal layout - children side by side.
Column	Vertical layout - children stacked.
Center	Center children vertically and horizontally.
Card	Card container with optional title.
Split	Left-right split layout.
Expanded	Expand child to fill available space.

Module Contents

class libstp.ui.widgets.Widget

Bases: abc.ABC

Base class for all widgets.

to_dict() → dict

Convert to JSON-serializable dict.

class libstp.ui.widgets.Text

Bases: Widget

Text display widget.

text: str

size: str = 'medium'

color: str | None = None

bold: bool = False

muted: bool = False

align: str = 'left'

class libstp.ui.widgets.Icon

Bases: Widget

Material icon widget.

name: str

size: int = 24

color: str | None = None

class libstp.ui.widgets.Spacer

Bases: Widget

Vertical spacing widget.

height: int = 16

class libstp.ui.widgets.Divider

Bases: Widget

Horizontal divider line.

thickness: int = 1

color: str | None = None

class libstp.ui.widgets.StatusBadge

Bases: Widget

Colored pill/badge with text (e.g., “LIGHT ON”).

text: str

color: str = 'grey'

glow: bool = False

class libstp.ui.widgets.StatusIcon

Bases: Widget

Animated circle with icon inside.

icon: str

color: str = 'green'

animated: bool = True

class libstp.ui.widgets.HintBox

Bases: Widget

Highlighted hint box (e.g., “Press button when ready”).

text: str

icon: str = 'touch_app'

style: str = 'normal'

class libstp.ui.widgets.DistanceBadge

Bases: Widget

Distance value display badge.

value: float

unit: str = 'cm'

color: str = 'blue'

class libstp.ui.widgets.ResultsTable

Bases: Widget

Key-value results table.

rows: List[tuple] = []

class libstp.ui.widgets.Button

Bases: Widget

Clickable button.

id: str

label: str

style: str = 'primary'

icon: str | None = None

disabled: bool = False

class libstp.ui.widgets.Slider

Bases: Widget

Slider input for numeric values.

id: str

min: float

max: float

value: float = 0

label: str | None = None

show_value: bool = True

class libstp.ui.widgets.Checkbox

Bases: Widget

Checkbox toggle.

id: str

label: str

value: bool = False

class libstp.ui.widgets.Dropdown

Bases: Widget

Dropdown selection.

id: str

options: List[str] = []

value: str | None = None

label: str | None = None

class libstp.ui.widgets.NumericKeypad

Bases: Widget

Touch-friendly numeric keypad (0-9, ., backspace).

class libstp.ui.widgets.NumericInput

Bases: Widget

Large numeric display with optional +/- buttons.

id: str

value: float = 0

unit: str = ''

min_value: float | None = None

max_value: float | None = None

show_adjust_buttons: bool = True

class libstp.ui.widgets.TextInput

Bases: Widget

Text input field.

id: str

value: str = ''

label: str | None = None

placeholder: str = ''

class libstp.ui.widgets.SensorValue

Bases: Widget

Large sensor value display.

port: int

sensor_type: str = 'analog'

class libstp.ui.widgets.SensorGraph

Bases: Widget

Real-time sensor line graph.

port: int

sensor_type: str = 'analog'

max_points: int = 50

class libstp.ui.widgets.LightBulb

Bases: Widget

Animated light bulb visualization.

is_on: bool = False

class libstp.ui.widgets.AnimatedRobot

Bases: Widget

Robot with spinning wheels visualization.

moving: bool = False

size: int = 120

class libstp.ui.widgets.CircularSlider

Bases: Widget

Circular slider for motor/servo control.

id: str

min: float

max: float

value: float = 0

label: str | None = None

class libstp.ui.widgets.ProgressSpinner

Bases: Widget

Circular loading spinner.

size: int = 24

color: str | None = None

class libstp.ui.widgets.PulsingArrow

Bases: Widget

Animated pulsing arrow.

direction: str = 'right'

class libstp.ui.widgets.RobotDrivingAnimation

Bases: Widget

Robot driving on track animation.

target_distance: float = 30.0

class libstp.ui.widgets.MeasuringTape

Bases: Widget

Animated measuring tape.

distance: float = 30.0

class libstp.ui.widgets.CalibrationChart

Bases: Widget

Static scatter/line chart for calibration data.

Shows collected sample points with horizontal threshold lines.

samples: List[float] = []

thresholds: List[tuple] = []

height: int = 200

class libstp.ui.widgets.Row

Bases: Widget

Horizontal layout - children side by side.

children: List[Widget] = []

align: str = 'center'

spacing: int = 8

class libstp.ui.widgets.Column

Bases: Widget

Vertical layout - children stacked.

children: List[Widget] = []

align: str = 'stretch'

spacing: int = 12

class libstp.ui.widgets.Center

Bases: Widget

Center children vertically and horizontally.

children: List[Widget] = []

class libstp.ui.widgets.Card

Bases: Widget

Card container with optional title.

children: List[Widget] = []

title: str | None = None

padding: int = 16

class libstp.ui.widgets.Split

Bases: Widget

Left-right split layout.

left: List[Widget] = []

right: List[Widget] = []

ratio: tuple = (1, 1)

class libstp.ui.widgets.Expanded

Bases: Widget

Expand child to fill available space.

child: Widget = None

flex: int = 1