bcode_hyperchad_ui 0.0.1-alpha.0

Portable HyperChad UI components for Bcode sessions
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
86
87
88
89
90
91
92
93

//! Renderer-neutral presentation routing context.

use bcode_session_models::SessionId;

#[cfg(test)]
pub(crate) mod tests;

/// Semantic application operation rendered through a canonical `HyperChad` route.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum PresentationAction {
    /// Submit a user message.
    SubmitMessage,
    /// Prepare the exact resume selection for explicit confirmation.
    PrepareSubmissionResume,
    /// Confirm and resume one prepared item.
    ResumeSubmission,
    /// Cancel one pending item.
    CancelPendingSubmission,
    /// Cancel the active turn.
    CancelTurn,
    /// Persist the draft for a session.
    UpdateDraft { session_id: SessionId },
    /// Resolve one permission request.
    ResolvePermission,
    /// Resolve an entire permission batch.
    ResolvePermissionBatch,
    /// Move through bounded transcript history.
    MoveHistoryWindow,
    /// Deliver input to an interactive tool.
    ResolveInteraction,
}

/// Supplies opaque application destinations for portable presentation components.
///
/// Components select destinations by semantic operation and never receive browser credentials,
/// backend origins, bind configuration, or transport request state.
pub trait PresentationContext {
    /// Resolve a semantic action to a canonical `HyperChad` route target.
    fn action_target(&self, action: PresentationAction) -> String;

    /// Resolve navigation to a session.
    fn session_target(&self, session_id: SessionId) -> String;

    /// Resolve a guarded resource target for one canonical session artifact reference.
    ///
    /// Renderers that cannot expose artifact bytes should return `None`.
    fn artifact_target(
        &self,
        session_id: SessionId,
        artifact_id: &str,
        reference_key: &str,
    ) -> Option<String>;
}

/// Unguarded canonical application routes for static rendering and renderer-neutral tests.
#[derive(Debug, Default, Clone, Copy)]
pub struct StaticPresentationContext;

impl PresentationContext for StaticPresentationContext {
    fn action_target(&self, action: PresentationAction) -> String {
        match action {
            PresentationAction::SubmitMessage => "/actions/submit-message".to_owned(),
            PresentationAction::PrepareSubmissionResume => {
                "/actions/prepare-submission-resume".to_owned()
            }
            PresentationAction::ResumeSubmission => "/actions/resume-submission".to_owned(),
            PresentationAction::CancelPendingSubmission => {
                "/actions/cancel-pending-submission".to_owned()
            }
            PresentationAction::CancelTurn => "/actions/cancel-turn".to_owned(),
            PresentationAction::UpdateDraft { session_id } => {
                format!("/actions/update-draft/{session_id}")
            }
            PresentationAction::ResolvePermission => "/actions/permission".to_owned(),
            PresentationAction::ResolvePermissionBatch => "/actions/permission-batch".to_owned(),
            PresentationAction::MoveHistoryWindow => "/actions/history-window".to_owned(),
            PresentationAction::ResolveInteraction => "/actions/interaction".to_owned(),
        }
    }

    fn session_target(&self, session_id: SessionId) -> String {
        format!("/session/{session_id}")
    }

    fn artifact_target(
        &self,
        _session_id: SessionId,
        _artifact_id: &str,
        _reference_key: &str,
    ) -> Option<String> {
        None
    }
}