Vocabulary cheatsheet

Every public enum in snora-core, with one-line semantics. Use this as a quick scan when you forget a variant name.

Direction and edges

#![allow(unused)]
fn main() {
pub enum LayoutDirection { Ltr, Rtl }
pub enum Edge            { Start, End }
}

LayoutDirection is the framework-wide reading direction. Edge expresses logical position on the horizontal axis; resolve to physical left/right via Edge::is_left_under(direction).

Toasts

#![allow(unused)]
fn main() {
pub enum ToastIntent {
    Debug,
    Info,
    Success,
    Warning,
    Error,
}

pub enum ToastLifetime {
    Transient(std::time::Duration),
    Persistent,
}

pub enum ToastPosition {
    TopEnd,        // default
    TopStart,
    TopCenter,
    BottomEnd,
    BottomStart,
    BottomCenter,
}
}

ToastIntent maps to theme colors (intent → palette pair). Helpers:

ToastLifetime::DEFAULT — 4-second transient.
ToastLifetime::seconds(n) / ToastLifetime::millis(ms).
ToastPosition::is_top() / is_bottom() — partition helpers.

Sheets

#![allow(unused)]
fn main() {
pub enum SheetEdge {
    Bottom,             // default
    Top,
    Start,              // logical (LTR=left, RTL=right)
    End,                // logical (LTR=right, RTL=left)
}

pub enum SheetSize {
    OneThird,           // default
    Half,
    TwoThirds,
    Ratio(f32),         // clamped 0.0..=1.0
    Pixels(f32),
}
}

SheetSize is interpreted along the axis perpendicular to the edge — height for top/bottom, width for start/end.

Helpers:

SheetSize::DEFAULT, as_ratio(), as_pixels().
SheetEdge::is_vertical() / is_horizontal() — partition helpers.

Icons

#![allow(unused)]
fn main() {
pub enum Icon {
    Text(String),
    #[cfg(feature = "lucide-icons")] Lucide(lucide_icons::Icon),
    #[cfg(feature = "svg-icons")]    Svg(std::path::PathBuf),
}
}

#![allow(unused)]
fn main() {
pub enum MenuAction<MenuId, MenuItemId> {
    MenuPressed(MenuId),
    MenuItemPressed { menu_id: MenuId, menu_item_id: MenuItemId },
}
}

MenuId and MenuItemId are application-defined. snora is generic over both.

Tabs

#![allow(unused)]
fn main() {
pub struct Tab<TabId: Clone + PartialEq> {
    pub id: TabId,
    pub label: String,
    pub icon: Option<Icon>,
}

pub struct TabBar<TabId: Clone + PartialEq> {
    pub tabs: Vec<Tab<TabId>>,
    pub active: TabId,
}

pub enum TabAction<TabId> {
    Pressed(TabId),
}
}

TabId is application-defined (typically a small enum). The widget renders the entry whose id == active with an underline.

Breadcrumbs

#![allow(unused)]
fn main() {
pub struct Crumb<CrumbId: Clone> {
    pub id: CrumbId,
    pub label: String,
    pub is_leaf: bool,
}

pub enum BreadcrumbAction<CrumbId> {
    Pressed(CrumbId),
}
}

Helpers:

Crumb::ancestor(id, label) — clickable ancestor.
Crumb::leaf(id, label) — current (last) entry, plain text.

Defaults at a glance

LayoutDirection::default()  → Ltr
ToastPosition::default()    → TopEnd
ToastLifetime::DEFAULT      → Transient(4 s)
SheetEdge::default()        → Bottom
SheetSize::DEFAULT          → OneThird

Snora