yog 0.0.2

yog: a balls-oriented session manager for lernie loops (egui frontend)
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

//! egui widget: the §11 Altitude-2 Inbox tab — the agent's undelivered
//! deposits (`✉n`), explained.
//!
//! A pure function of the [`InboxEntry`] listing (§2.11): each deposit's
//! framing (sender), its asserted facts (`from` / `deposited_at`, plus
//! `epitaph` / `terminal_ref` on a result message), and its body verbatim —
//! or, under the §11 Raw toggle, the deposit file's own bytes. No click, so
//! the whole tab is a headless shape-walk-tested pure render; the Flush =
//! `lernie scan` action is this tab's own Scan button, wired beside it in the
//! shell's `inspector::tabs_and_content` per-tab controls.

use super::{Deposit, InboxEntry};

/// Render the inbox listing, oldest-first. An empty inbox shows a placeholder
/// (the common quiescent case, not an error). `raw` is the §11 Raw toggle:
/// each deposit file's name and its bytes exactly as they sit on disk —
/// envelope included — instead of the parsed view that drops it.
pub fn render(ui: &mut egui::Ui, entries: &[InboxEntry], raw: bool) {
    // §11 tail idiom: the listing is oldest-first, so the newest deposit is the
    // bottom row and the view sits on it — a lone deposit at the bottom edge,
    // a backlog scrolled to it.
    crate::tail::scroll(ui, true, |ui| {
        if entries.is_empty() {
            ui.label("(no deposits)");
            return;
        }
        for entry in entries {
            if raw {
                render_raw(ui, entry);
            } else {
                render_deposit(ui, &entry.deposit);
            }
            ui.separator();
        }
    });
}

/// Verbatim backing bytes under a filename header — the transcript tab's Raw
/// idiom, one wording of it per tab and no second spelling of the layout.
fn render_raw(ui: &mut egui::Ui, entry: &InboxEntry) {
    ui.monospace(&entry.name);
    ui.monospace(String::from_utf8_lossy(&entry.raw).to_string());
}

/// One deposit: a `from · deposited_at` header, the result-message epitaph +
/// terminal ref when present (§2.6), then the body verbatim. Absent fields
/// read as `?` rather than vanishing, so a hand-edited deposit stays legible.
fn render_deposit(ui: &mut egui::Ui, deposit: &Deposit) {
    // Brazen — the same hue as the tree's `✉n` badge, so "pending mail"
    // reads as one signal across altitudes; the wording is the shared
    // [`super::header_line`], one home for all three seats of §5.1 #11.
    ui.label(
        egui::RichText::new(super::header_line(deposit))
            .color(crate::theme::BRAZEN)
            .strong(),
    );
    if let Some(epitaph) = &deposit.epitaph {
        ui.weak(format!("epitaph: {}", epitaph.label()));
    }
    if let Some(terminal) = &deposit.terminal_ref {
        ui.weak(format!("terminal: {terminal}"));
    }
    ui.label(&deposit.body);
}