portaki-cli 8.6.0

Portaki module CLI (portaki) — init, build, lint, test, and OCI publish
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

//! Guest booklet surfaces.

use portaki_sdk::prelude::*;
use portaki_sdk::sdui::primitives::{Card, Stack, Text};

use crate::config::ModuleConfig;
use crate::ids::HOME_CARD;

#[portaki_sdk::surface(
    guest,
    id = "home.card",
    path = "{{MODULE_NAME}}",
    label_key = "home.card.title",
    role = GuestRole::Card
)]
pub fn render_guest_home_card(ctx: GuestContext) -> Result<Surface> {
    // Written for the happy path: the SDK shows the guest its own state while the module is
    // off or incomplete, and turns an `Err` into a logged error state.
    let config = ModuleConfig::load(&ctx)?;
    // What the host typed, or the bundled wording — a card the host never configured still
    // reads as a finished card rather than an empty one.
    let body = if config.greeting.is_empty() {
        "i18n:home.card.body".to_string()
    } else {
        config.greeting
    };

    Ok(Surface::new(
        Card::new()
            .title("i18n:home.card.title")
            .child(Stack::new().child(Text::new().text(body))),
    )
    .with_id(HOME_CARD))
}