snora-widgets 0.39.1

Optional prefab iced widgets for the Snora GUI framework — header, footer, sidebar, menu, icon.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

//! # snora-widgets
//!
//! Optional prefab `iced::Element` builders for snora's skeleton slots.
//!
//! These widgets are entirely **optional** — the snora engine
//! (`snora::render`) consumes any `iced::Element` in any slot. Use
//! these helpers to get a working app on screen quickly, and replace
//! them with hand-written elements the moment you need to customize
//! beyond what they expose.
//!
//! # Crate boundary
//!
//! This crate exists so that snora's engine (the `snora` crate) can
//! evolve independently of widget visuals. Applications normally do
//! **not** depend on `snora-widgets` directly — `snora` re-exports
//! everything here under the `snora::widget` module when its
//! `widgets` feature is enabled (the default).
//!
//! Direct `snora-widgets` use is supported for two cases:
//!
//! * Engine-only applications that opt out of `snora`'s `widgets`
//!   feature and want to add the widget set back selectively.
//! * Alternative engines built against `snora-core` that want to
//!   reuse the widget visuals.
//!
//! # ABDD
//!
//! Every widget that has start/end asymmetry takes a
//! [`snora_core::LayoutDirection`] argument and mirrors accordingly.

#![warn(missing_docs)]
#![cfg_attr(docsrs, feature(doc_cfg))]

mod crumb;
pub mod direction;
mod footer;
mod header;
mod icon;
mod menu;
mod sidebar;
pub mod style;
mod tab;

/// Prefab design widgets for Snora Design tokens.
///
/// Available when the `design` feature is enabled. Provides the
/// token-styled prefab widgets (`button`, `card`, `notice`, `chip`,
/// `progress`, chrome geometry) — each wraps a plain iced widget and
/// applies [`snora_style`] styling internally. **The iced style
/// bridge itself is [`snora_style`], not this module** — see this
/// module's own doc comment for the full boundary.
#[cfg(feature = "design")]
pub mod design;

pub use crumb::app_breadcrumb;
pub use footer::app_footer;
pub use header::app_header;
pub use icon::{icon_element, icon_element_sized};
pub use menu::render_menu;
pub use sidebar::app_side_bar;
pub use tab::app_tab_bar;

/// Convenience re-export of the Lucide icon constants, available when
/// the `lucide-icons` feature is enabled.
#[cfg(feature = "lucide-icons")]
pub mod lucide {
    pub use lucide_icons::{Icon::*, LUCIDE_FONT_BYTES};
}