fission-core 0.1.0

Core
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
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

use crate::lowering::{LoweringContext, NodeBuilder, wrap_zstack_child};
use crate::ui::traits::Lower;
use crate::ui::{Node, Text, TextContent};
use fission_ir::{LayoutOp, NodeId, Op};
use serde::{Deserialize, Serialize};

/// A widget that renders an overlay layer on top of its content.
///
/// The `content` is drawn first, then `overlay` is drawn on top, filling the
/// same bounds via a [`ZStack`](super::ZStack) internally.
///
/// # Example
///
/// ```rust,ignore
/// Overlay {
///     content: Box::new(main_content),
///     overlay: Box::new(loading_spinner),
///     ..Default::default()
/// }
/// ```
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Overlay {
    /// Explicit node identity.
    pub id: Option<NodeId>,
    /// The primary content (drawn first / underneath).
    pub content: Box<Node>,
    /// The overlay content (drawn second / on top).
    pub overlay: Box<Node>,
}

impl Overlay {
    pub fn into_node(self) -> Node {
        Node::Overlay(self)
    }
}

impl Default for Overlay {
    fn default() -> Self {
        Self {
            id: None,
            content: Box::new(Node::Text(Text {
                content: TextContent::Literal("".into()),
                ..Default::default()
            })),
            overlay: Box::new(Node::Text(Text {
                content: TextContent::Literal("".into()),
                ..Default::default()
            })),
        }
    }
}

impl Lower for Overlay {
    fn lower(&self, cx: &mut LoweringContext) -> NodeId {
        let id = self.id.unwrap_or_else(|| cx.next_node_id());
        
        cx.push_scope(id);

        // Build overlay child in its own scope to avoid ID collisions
        // with the content tree.
        let overlay_scope = cx.next_node_id();
        cx.push_scope(overlay_scope);
        let overlay_child_id = self.overlay.lower(cx);
        cx.pop_scope();
        let mut overlay_fill =
            NodeBuilder::new(cx.next_node_id(), Op::Layout(LayoutOp::AbsoluteFill));
        overlay_fill.add_child(overlay_child_id);
        let overlay_fill_id = overlay_fill.build(cx);

        // Stack container: content first, overlay second.
        let stack_id = cx.next_node_id();
        let content_id = self.content.lower(cx);
        cx.push_scope(stack_id);
        let content_wrapped = wrap_zstack_child(cx, content_id);
        let overlay_wrapped = wrap_zstack_child(cx, overlay_fill_id);
        cx.pop_scope();

        let mut stack = NodeBuilder::new(stack_id, Op::Layout(LayoutOp::ZStack));
        stack.add_child(content_wrapped);
        stack.add_child(overlay_wrapped);
        let stack_id = stack.build(cx);

        // Ensure the stack fills available space so overlay AbsoluteFill can cover
        // the full viewport even when content is small.
        let mut stack_wrapper = NodeBuilder::new(
            cx.next_node_id(),
            Op::Layout(LayoutOp::Box {
                width: None,
                height: None,
                min_width: None,
                max_width: None,
                min_height: None,
                max_height: None,
                padding: [0.0; 4],
                flex_grow: 1.0,
                flex_shrink: 1.0,
                aspect_ratio: None,
            }),
        );
        stack_wrapper.add_child(stack_id);
        let stack_wrapper_id = stack_wrapper.build(cx);

        // Wrap ZStack in a Flex container with flex_grow = 1.0
        // Flex defaults to stretching children, unlike Box which centers.
        let mut root = NodeBuilder::new(
            id, 
            Op::Layout(LayoutOp::Flex {
                direction: fission_ir::FlexDirection::Column,
                wrap: fission_ir::FlexWrap::NoWrap,
                flex_grow: 1.0,
                flex_shrink: 1.0,
                padding: [0.0; 4],
                gap: None,
                align_items: fission_ir::op::AlignItems::Stretch,
                justify_content: fission_ir::op::JustifyContent::Start,
            })
        );
        root.add_child(stack_wrapper_id);
        
        cx.pop_scope();
        
        root.build(cx)
    }
}