Enum Widget 

#[repr(C)]
pub enum Widget {
    Text {
        content: String,
        style: TextStyle,
    },
    Image {
        source: String,
        shape: ImageShape,
        ratio: ImageRatio,
    },
    Badge {
        label: String,
        tone: Tone,
    },
    ColorDot {
        color: ProjectColor,
    },
    Divider,
    Spacer {
        size: Spacing,
    },
    Row {
        children: Vec<Widget>,
    },
    Column {
        children: Vec<Widget>,
    },
    Card {
        child: Box<Widget>,
        style: CardStyle,
        on_press: Option<ActionToken>,
    },
    Box {
        children: Vec<Widget>,
        align: BoxAlign,
        scrim: bool,
    },
    Grid {
        children: Vec<Widget>,
    },
    Button {
        label: String,
        style: ButtonStyle,
        on_press: ActionToken,
    },
    IconButton {
        icon: Icon,
        on_press: ActionToken,
    },
    Chip {
        label: String,
        selected: bool,
        on_press: ActionToken,
    },
    TextField {
        id: String,
        placeholder: String,
        value: String,
    },
    Toggle {
        id: String,
        label: String,
        value: bool,
    },
    Checkbox {
        id: String,
        label: String,
        value: bool,
    },
    Slider {
        id: String,
        value: i32,
        max: i32,
    },
    Stepper {
        value: i32,
        on_decrement: ActionToken,
        on_increment: ActionToken,
    },
    Scaffold {
        title: String,
        body: Box<Widget>,
        tabs: Vec<Tab>,
        back: Option<ActionToken>,
        dark_mode: bool,
        route: String,
        depth: u32,
    },
}

The app-agnostic widget tree the shell renders. Fixed across all apps.

Variants

Text

Fields

content: String

style: TextStyle

Image

Fields

source: String

shape: ImageShape

ratio: ImageRatio

Badge

Fields

label: String

tone: Tone

ColorDot

Small non-interactive colored dot — a project/identity hint.

Fields

color: ProjectColor

Divider

Spacer

Fields

size: Spacing

Row

Fields

children: Vec<Widget>

Column

Fields

children: Vec<Widget>

Card

Card; tappable when on_press is set.

Fields

child: Box<Widget>

style: CardStyle

on_press: Option<ActionToken>

Box

Z-stack: children layered back-to-front, positioned by align. With scrim, the first child is a background image, darkened for legibility, and the rest render on top in light content.

Fields

children: Vec<Widget>

align: BoxAlign

scrim: bool

Grid

Fixed 2-column grid; children flow left-to-right, top-to-bottom.

Fields

children: Vec<Widget>

Button

Fields

label: String

style: ButtonStyle

on_press: ActionToken

IconButton

Fields

icon: Icon

on_press: ActionToken

Chip

Fields

label: String

selected: bool

on_press: ActionToken

TextField

Fields

id: String

placeholder: String

value: String

Toggle

Fields

id: String

label: String

value: bool

Checkbox

Fields

id: String

label: String

value: bool

Slider

Continuous 0..=max slider; emits Input { id, Int }.

Fields

id: String

value: i32

max: i32

Stepper

Numeric stepper with −/+ controls carrying their own events.

Fields

value: i32

on_decrement: ActionToken

on_increment: ActionToken

Scaffold

App shell: a top bar (title + optional back), a scrollable body, and bottom-nav tabs. dark_mode is theme-as-data — the shell themes the whole app from it.

route + depth drive navigation: the shell animates the body when route (the current screen’s identity) changes — slide for push/pop (direction from whether depth grew or shrank), crossfade for a lateral move at the same depth — and wires the system back button to back.

Fields

title: String

body: Box<Widget>

tabs: Vec<Tab>

back: Option<ActionToken>

dark_mode: bool

route: String

depth: u32

Trait Implementations

impl Clone for Widget

fn clone(&self) -> Widget

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Widget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Widget

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'ʄ> Facet<'ʄ> for Widget

const SHAPE: &'static Shape

The shape of this type, including: whether it’s a Struct, an Enum, something else?

impl Serialize for Widget

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.