chk 1.1.0

The guided, locked-down layer of Pelican UI for consistent, reliable RAMP interfaces.
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

#![doc(html_logo_url = "https://raw.githubusercontent.com/ramp-stack/chk/main/logo.png")]

pub use pelican_ui::{Context, utils::Timestamp, event::{OnEvent, Event}, layout::Offset, theme::{Theme, Color, Icons}, image};

use pelican_ui::interface::navigation::RootInfo as PelicanRootInfo;

pub mod closure;
pub use closure::*;
pub mod flow;
pub use flow::*;
pub mod items;
pub use items::*;
pub mod page;
pub use page::*;

pub struct RootInfo(pub PelicanRootInfo);
impl RootInfo {
    pub fn icon(ctx: &mut Context, theme: &Theme, icon: Icons, label: &str, page: PageType) -> RootInfo {
        RootInfo(PelicanRootInfo::icon(icon, label, page.build(ctx, theme)))
    }

    pub fn avatar(ctx: &mut Context, theme: &Theme, avatar: AvatarContent, label: &str, page: PageType) -> RootInfo {
        RootInfo(PelicanRootInfo::avatar(avatar, label, page.build(ctx, theme)))
    }
}

#[derive(Clone, Copy, Debug)]
pub enum ChkTheme {
    Dark(Color),
    Light(Color),
    Auto(Color),
}

impl ChkTheme {
    pub fn to_pelican(self, assets: &include_dir::Dir<'static>) -> Theme {
        match self {
            ChkTheme::Dark(c) => Theme::dark(assets, c),
            ChkTheme::Light(c) => Theme::light(assets, c),
            ChkTheme::Auto(c) => Theme::from(assets, c)
        }
    }
}

impl Default for ChkTheme { fn default() -> Self {ChkTheme::Dark(Color::from_hex("#ffdd00", 255))} }

pub trait App {
    fn roots(&self, ctx: &mut Context, theme: &Theme) -> Vec<RootInfo>;
    fn theme(&self) -> ChkTheme { ChkTheme::default() }
    fn on_event(&mut self, _ctx: &mut Context, event: Box<dyn Event>) -> Vec<Box<dyn Event>> { vec![event] }
}

#[doc(hidden)]
pub mod __private {
    pub use ramp;
    pub use ramp::prism;
    pub use pelican_ui::theme::Theme;
    pub use pelican_ui::Context;
    pub use pelican_ui::event::Event;
    pub use pelican_ui::interface::{general::Interface, navigation::RootInfo as PelicanRootInfo};
    pub use chk::App;
    pub use chk::ChkTheme;
    pub use chk::RootInfo;
    pub use std::rc::Rc;
    pub use std::cell::RefCell;
}

#[macro_export]
macro_rules! run {
    ($app:expr) => {
        // TODO: Update state with application support directory files.

        use $crate::__private::*;
        ramp::run!(move |ctx: &mut Context, assets: Assets| {
            let app: Rc<RefCell<dyn App>> = Rc::new(RefCell::new(($app)(ctx)));
            let theme: Theme = app.borrow().theme().to_pelican(assets.all());
            let roots: Vec<RootInfo> = app.borrow().roots(ctx, &theme);
            let roots = roots.into_iter().map(|root| root.0).collect::<Vec<PelicanRootInfo>>();
            let app = Rc::clone(&app);
            let on_event = Box::new(move |d: &mut Box<dyn Drawable>, ctx: &mut Context, event: Box<dyn Event>| app.borrow_mut().on_event(ctx, event));
            Interface::new(&theme, roots, on_event)
        });
    }
}

extern crate self as chk;