Skip to main content

cranpose_ui/modifier/
slices.rs

1use std::fmt;
2use std::rc::Rc;
3
4use cranpose_foundation::{ModifierNodeChain, NodeCapabilities, PointerEvent};
5use cranpose_ui_graphics::{ColorFilter, GraphicsLayer, RenderEffect};
6
7use crate::draw::DrawCommand;
8use crate::modifier::Modifier;
9use crate::modifier_nodes::{
10    BackgroundNode, ClipToBoundsNode, CornerShapeNode, DrawCommandNode, GraphicsLayerNode,
11    PaddingNode,
12};
13use crate::text::{TextLayoutOptions, TextStyle};
14use crate::text_field_modifier_node::TextFieldModifierNode;
15use crate::text_modifier_node::TextModifierNode;
16use cranpose_ui_graphics::EdgeInsets;
17use std::cell::RefCell;
18
19use super::{ModifierChainHandle, Point};
20
21/// Snapshot of modifier node slices that impact draw and pointer subsystems.
22#[derive(Default)]
23pub struct ModifierNodeSlices {
24    draw_commands: Vec<DrawCommand>,
25    pointer_inputs: Vec<Rc<dyn Fn(PointerEvent)>>,
26    click_handlers: Vec<Rc<dyn Fn(Point)>>,
27    clip_to_bounds: bool,
28    text_content: Option<crate::text::AnnotatedString>,
29    text_style: Option<TextStyle>,
30    text_layout_options: Option<TextLayoutOptions>,
31    graphics_layer: Option<GraphicsLayer>,
32    graphics_layer_resolver: Option<Rc<dyn Fn() -> GraphicsLayer>>,
33    chain_guard: Option<Rc<ChainGuard>>,
34}
35
36struct ChainGuard {
37    _handle: ModifierChainHandle,
38}
39
40impl Clone for ModifierNodeSlices {
41    fn clone(&self) -> Self {
42        Self {
43            draw_commands: self.draw_commands.clone(),
44            pointer_inputs: self.pointer_inputs.clone(),
45            click_handlers: self.click_handlers.clone(),
46            clip_to_bounds: self.clip_to_bounds,
47            text_content: self.text_content.clone(),
48            text_style: self.text_style.clone(),
49            text_layout_options: self.text_layout_options,
50            graphics_layer: self.graphics_layer.clone(),
51            graphics_layer_resolver: self.graphics_layer_resolver.clone(),
52            chain_guard: self.chain_guard.clone(),
53        }
54    }
55}
56
57/// Compose two nested graphics layers (`base` outer, `overlay` inner) into one
58/// flattened layer snapshot used by render pipelines.
59///
60/// Composition rules follow how nested transforms/effects behave visually:
61/// - Multiplicative: `alpha`, `scale`, `scale_x`, `scale_y`
62/// - Additive: `rotation_*`, `translation_*`
63/// - Boolean OR: `clip`
64/// - Overlay-wins when explicitly set: camera distance, transform origin,
65///   shadow elevation/colors, shape, compositing strategy, blend mode
66/// - Filters/effects are composed in draw order:
67///   - color filters are multiplied where possible
68///   - render effects chain inner-first then outer (`inner.then(outer)`)
69/// - Backdrop effect keeps the most local explicit backdrop effect because
70///   backdrop sampling cannot be safely flattened as a deterministic chain.
71fn merge_graphics_layers(base: GraphicsLayer, overlay: GraphicsLayer) -> GraphicsLayer {
72    GraphicsLayer {
73        alpha: (base.alpha * overlay.alpha).clamp(0.0, 1.0),
74        scale: base.scale * overlay.scale,
75        scale_x: base.scale_x * overlay.scale_x,
76        scale_y: base.scale_y * overlay.scale_y,
77        rotation_x: base.rotation_x + overlay.rotation_x,
78        rotation_y: base.rotation_y + overlay.rotation_y,
79        rotation_z: base.rotation_z + overlay.rotation_z,
80        camera_distance: overlay.camera_distance,
81        transform_origin: overlay.transform_origin,
82        translation_x: base.translation_x + overlay.translation_x,
83        translation_y: base.translation_y + overlay.translation_y,
84        shadow_elevation: overlay.shadow_elevation,
85        ambient_shadow_color: overlay.ambient_shadow_color,
86        spot_shadow_color: overlay.spot_shadow_color,
87        shape: overlay.shape,
88        clip: base.clip || overlay.clip,
89        compositing_strategy: overlay.compositing_strategy,
90        blend_mode: overlay.blend_mode,
91        color_filter: compose_color_filters(base.color_filter, overlay.color_filter),
92        // Modifiers are traversed outer -> inner. Layer effects therefore compose
93        // inner-first, then outer, matching nested layer rendering semantics.
94        render_effect: compose_render_effects(base.render_effect, overlay.render_effect),
95        // Backdrop effects cannot be represented as a deterministic chain on a
96        // flattened single layer, so keep the most local explicit backdrop.
97        backdrop_effect: overlay.backdrop_effect.or(base.backdrop_effect),
98    }
99}
100
101fn compose_render_effects(
102    outer: Option<RenderEffect>,
103    inner: Option<RenderEffect>,
104) -> Option<RenderEffect> {
105    match (outer, inner) {
106        (None, None) => None,
107        (Some(effect), None) | (None, Some(effect)) => Some(effect),
108        (Some(outer_effect), Some(inner_effect)) => Some(inner_effect.then(outer_effect)),
109    }
110}
111
112fn compose_color_filters(
113    base: Option<ColorFilter>,
114    overlay: Option<ColorFilter>,
115) -> Option<ColorFilter> {
116    match (base, overlay) {
117        (None, None) => None,
118        (Some(filter), None) | (None, Some(filter)) => Some(filter),
119        (Some(filter), Some(next)) => Some(filter.compose(next)),
120    }
121}
122
123impl ModifierNodeSlices {
124    pub fn draw_commands(&self) -> &[DrawCommand] {
125        &self.draw_commands
126    }
127
128    pub fn pointer_inputs(&self) -> &[Rc<dyn Fn(PointerEvent)>] {
129        &self.pointer_inputs
130    }
131
132    pub fn click_handlers(&self) -> &[Rc<dyn Fn(Point)>] {
133        &self.click_handlers
134    }
135
136    pub fn clip_to_bounds(&self) -> bool {
137        self.clip_to_bounds
138    }
139
140    pub fn text_content(&self) -> Option<&str> {
141        self.text_content.as_ref().map(|a| a.text.as_str())
142    }
143
144    pub fn annotated_string(&self) -> Option<crate::text::AnnotatedString> {
145        self.text_content.clone()
146    }
147
148    pub fn text_style(&self) -> Option<&TextStyle> {
149        self.text_style.as_ref()
150    }
151
152    pub fn text_layout_options(&self) -> Option<TextLayoutOptions> {
153        self.text_layout_options
154    }
155
156    pub fn graphics_layer(&self) -> Option<GraphicsLayer> {
157        if let Some(resolve) = &self.graphics_layer_resolver {
158            Some(resolve())
159        } else {
160            self.graphics_layer.clone()
161        }
162    }
163
164    fn push_graphics_layer(
165        &mut self,
166        layer: GraphicsLayer,
167        resolver: Option<Rc<dyn Fn() -> GraphicsLayer>>,
168    ) {
169        let existing_snapshot = self.graphics_layer();
170        let next_snapshot = existing_snapshot
171            .as_ref()
172            .map(|current| merge_graphics_layers(current.clone(), layer.clone()))
173            .unwrap_or_else(|| layer.clone());
174        let existing_resolver = self.graphics_layer_resolver.clone();
175
176        self.graphics_layer = Some(next_snapshot);
177        self.graphics_layer_resolver = match (existing_resolver, resolver) {
178            (None, None) => None,
179            (Some(current_resolver), None) => {
180                let layer = layer.clone();
181                Some(Rc::new(move || {
182                    merge_graphics_layers(current_resolver(), layer.clone())
183                }))
184            }
185            (None, Some(next_resolver)) => {
186                let base = existing_snapshot.unwrap_or_default();
187                Some(Rc::new(move || {
188                    merge_graphics_layers(base.clone(), next_resolver())
189                }))
190            }
191            (Some(current_resolver), Some(next_resolver)) => Some(Rc::new(move || {
192                merge_graphics_layers(current_resolver(), next_resolver())
193            })),
194        };
195    }
196
197    pub fn with_chain_guard(mut self, handle: ModifierChainHandle) -> Self {
198        self.chain_guard = Some(Rc::new(ChainGuard { _handle: handle }));
199        self
200    }
201
202    /// Resets the slice collection for reuse, retaining vector capacity.
203    pub fn clear(&mut self) {
204        self.draw_commands.clear();
205        self.pointer_inputs.clear();
206        self.click_handlers.clear();
207        self.clip_to_bounds = false;
208        self.text_content = None;
209        self.text_style = None;
210        self.text_layout_options = None;
211        self.graphics_layer = None;
212        self.graphics_layer_resolver = None;
213        self.chain_guard = None;
214    }
215}
216
217impl fmt::Debug for ModifierNodeSlices {
218    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
219        f.debug_struct("ModifierNodeSlices")
220            .field("draw_commands", &self.draw_commands.len())
221            .field("pointer_inputs", &self.pointer_inputs.len())
222            .field("click_handlers", &self.click_handlers.len())
223            .field("clip_to_bounds", &self.clip_to_bounds)
224            .field("text_content", &self.text_content)
225            .field("text_style", &self.text_style)
226            .field("text_layout_options", &self.text_layout_options)
227            .field("graphics_layer", &self.graphics_layer)
228            .field(
229                "graphics_layer_resolver",
230                &self.graphics_layer_resolver.is_some(),
231            )
232            .finish()
233    }
234}
235
236/// Collects modifier node slices directly from a reconciled [`ModifierNodeChain`].
237pub fn collect_modifier_slices(chain: &ModifierNodeChain) -> ModifierNodeSlices {
238    let mut slices = ModifierNodeSlices::default();
239    collect_modifier_slices_into(chain, &mut slices);
240    slices
241}
242
243/// Collects modifier node slices into an existing buffer to reuse allocations.
244pub fn collect_modifier_slices_into(chain: &ModifierNodeChain, slices: &mut ModifierNodeSlices) {
245    slices.clear();
246
247    chain.for_each_node_with_capability(NodeCapabilities::POINTER_INPUT, |_ref, node| {
248        let _any = node.as_any();
249
250        // ClickableNode is now handled as a standard PointerInputNode
251        // to support drag cancellation and proper click semantics (Up vs Down)
252
253        // Collect general pointer input handlers (non-clickable)
254        if let Some(handler) = node
255            .as_pointer_input_node()
256            .and_then(|n| n.pointer_input_handler())
257        {
258            slices.pointer_inputs.push(handler);
259        }
260    });
261
262    // Track background and shape to combine them in draw commands
263    let background_color = RefCell::new(None);
264    let background_insert_index = RefCell::new(None::<usize>);
265    let corner_shape = RefCell::new(None);
266
267    chain.for_each_node_with_capability(NodeCapabilities::DRAW, |_ref, node| {
268        let any = node.as_any();
269
270        // Collect background color from BackgroundNode
271        if let Some(bg_node) = any.downcast_ref::<BackgroundNode>() {
272            *background_color.borrow_mut() = Some(bg_node.color());
273            *background_insert_index.borrow_mut() = Some(slices.draw_commands.len());
274            // Note: BackgroundNode can have an optional shape, but we primarily track
275            // shape via CornerShapeNode for flexibility
276            if bg_node.shape().is_some() {
277                *corner_shape.borrow_mut() = bg_node.shape();
278            }
279        }
280
281        // Collect corner shape from CornerShapeNode
282        if let Some(shape_node) = any.downcast_ref::<CornerShapeNode>() {
283            *corner_shape.borrow_mut() = Some(shape_node.shape());
284        }
285
286        // Collect draw commands from DrawCommandNode
287        if let Some(commands) = any.downcast_ref::<DrawCommandNode>() {
288            slices
289                .draw_commands
290                .extend(commands.commands().iter().cloned());
291        }
292
293        // Use create_draw_closure() for nodes with dynamic content (cursor blink, selection)
294        // This defers evaluation to render time, enabling live updates.
295        // Fallback to draw() for nodes with static content.
296        if let Some(draw_node) = node.as_draw_node() {
297            if let Some(closure) = draw_node.create_draw_closure() {
298                // Deferred closure - evaluates at render time
299                slices.draw_commands.push(DrawCommand::Overlay(closure));
300            } else {
301                // Static draw - evaluate now
302                use cranpose_ui_graphics::{DrawScope as _, DrawScopeDefault};
303                let mut scope = DrawScopeDefault::new(crate::modifier::Size {
304                    width: 0.0,
305                    height: 0.0,
306                });
307                draw_node.draw(&mut scope);
308                let primitives = scope.into_primitives();
309                if !primitives.is_empty() {
310                    let draw_cmd = Rc::new(move |_size: crate::modifier::Size| primitives.clone());
311                    slices.draw_commands.push(DrawCommand::Overlay(draw_cmd));
312                }
313            }
314        }
315
316        // Collect graphics layer from GraphicsLayerNode
317        if let Some(layer_node) = any.downcast_ref::<GraphicsLayerNode>() {
318            slices.push_graphics_layer(layer_node.layer(), layer_node.layer_resolver());
319        }
320
321        if any.is::<ClipToBoundsNode>() {
322            slices.clip_to_bounds = true;
323        }
324    });
325
326    // Collect padding from modifier chain for cursor positioning
327    let mut padding = EdgeInsets::default();
328    chain.for_each_node_with_capability(NodeCapabilities::LAYOUT, |_ref, node| {
329        let any = node.as_any();
330        if let Some(padding_node) = any.downcast_ref::<PaddingNode>() {
331            let p = padding_node.padding();
332            padding.left += p.left;
333            padding.top += p.top;
334            padding.right += p.right;
335            padding.bottom += p.bottom;
336        }
337    });
338
339    // Collect text content from TextModifierNode or TextFieldModifierNode (LAYOUT capability)
340    chain.for_each_node_with_capability(NodeCapabilities::LAYOUT, |_ref, node| {
341        let any = node.as_any();
342        if let Some(text_node) = any.downcast_ref::<TextModifierNode>() {
343            // Rightmost text modifier wins
344            slices.text_content = Some(text_node.annotated_string());
345            slices.text_style = Some(text_node.style().clone());
346            slices.text_layout_options = Some(text_node.options());
347        }
348        // Also check for TextFieldModifierNode (editable text fields)
349        if let Some(text_field_node) = any.downcast_ref::<TextFieldModifierNode>() {
350            let text = text_field_node.text();
351            slices.text_content = Some(crate::text::AnnotatedString::from(text));
352            slices.text_layout_options = Some(TextLayoutOptions::default());
353
354            // Update content offsets for cursor positioning in collect_draw_primitives()
355            text_field_node.set_content_offset(padding.left);
356            text_field_node.set_content_y_offset(padding.top);
357
358            // Cursor/selection rendering is now handled via DrawModifierNode::collect_draw_primitives()
359            // in the DRAW capability loop above
360        }
361    });
362
363    // Convert background + shape into a draw command
364    if let Some(color) = background_color.into_inner() {
365        let shape = corner_shape.into_inner();
366
367        let draw_cmd = Rc::new(move |size: crate::modifier::Size| {
368            use crate::modifier::{Brush, Rect};
369            use cranpose_ui_graphics::DrawPrimitive;
370
371            let brush = Brush::solid(color);
372            let rect = Rect {
373                x: 0.0,
374                y: 0.0,
375                width: size.width,
376                height: size.height,
377            };
378
379            if let Some(shape) = shape {
380                let radii = shape.resolve(size.width, size.height);
381                vec![DrawPrimitive::RoundRect { rect, brush, radii }]
382            } else {
383                vec![DrawPrimitive::Rect { rect, brush }]
384            }
385        });
386
387        let insert_index = background_insert_index
388            .into_inner()
389            .unwrap_or(0)
390            .min(slices.draw_commands.len());
391        slices
392            .draw_commands
393            .insert(insert_index, DrawCommand::Behind(draw_cmd));
394    }
395}
396
397/// Collects modifier node slices by instantiating a temporary node chain from a [`Modifier`].
398pub fn collect_slices_from_modifier(modifier: &Modifier) -> ModifierNodeSlices {
399    let mut handle = ModifierChainHandle::new();
400    let _ = handle.update(modifier);
401    collect_modifier_slices(handle.chain()).with_chain_guard(handle)
402}