uzor 1.2.0

Core UI engine — geometry, interaction, input state
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

//! InputCoordinator registration helpers for text input widgets.
//!
//! `register` is the one-call entry point a widget owner uses every frame
//! to:
//! - declare the atomic widget (`WidgetKind::Custom` for now — `TextInput`
//!   should be added to `WidgetKind` in a follow-up pass),
//! - tell the coordinator about the field's `TextFieldConfig` so char/key
//!   events get routed correctly while the field is focused.

use crate::app_context::ContextManager;
use crate::docking::panels::DockPanel;
use crate::input::core::coordinator::LayerId;
use crate::input::{InputCoordinator, Sense, WidgetKind};
use crate::layout::{LayoutManager, LayoutNodeId, WidgetNode};
use crate::render::RenderContext;
use crate::types::{Rect, WidgetId, WidgetState};

use super::render::{draw_input, draw_input_cursor, InputResult, InputView};
use super::settings::TextInputSettings;
use super::state::TextFieldStore;

/// Register a text input widget with the coordinator for this frame.
///
/// `id` is the widget's stable identifier (used both for hit-testing and
/// for keying its row in `TextFieldStore`).
pub fn register(
    coord: &mut InputCoordinator,
    id: impl Into<WidgetId>,
    rect: Rect,
    layer: &LayerId,
    _settings: &TextInputSettings,
) {
    let id = id.into();
    let sense = Sense::CLICK.with_focus().with_text();
    coord.register_atomic(id, crate::input::WidgetKind::Custom, rect, sense, layer);
    // Note: coord.register_text_field still expects the canonical
    // `input::text::store::TextFieldConfig`. Until that type is consolidated
    // with `state::TextFieldConfig` (which is a copy), the caller is expected
    // to invoke `register_text_field` directly with the canonical type.
}

/// Level 1 — register a text input with an explicit `InputCoordinator`.
///
/// `state` holds the per-field text/cursor/selection store. Text field state
/// is managed by the caller's `TextFieldStore`; this call registers the hit zone.
pub fn register_input_coordinator_text_input(
    coord: &mut InputCoordinator,
    id: impl Into<WidgetId>,
    rect: Rect,
    layer: &LayerId,
    settings: &TextInputSettings,
    _state: &mut TextFieldStore,
) {
    register(coord, id, rect, layer, settings);
}

/// Level 2 — register a text input via `ContextManager`, pulling `TextFieldStore`
/// from the registry, and draw it using the provided render context.
///
/// `widget_state` is supplied by the caller — the app owns the focus/hover state machine.
/// `view` supplies per-frame text, cursor, selection, and focus state.
/// `settings` supplies visual style and theme.
pub fn register_context_manager_text_input(
    ctx: &mut ContextManager,
    render: &mut dyn RenderContext,
    id: impl Into<WidgetId>,
    rect: Rect,
    layer: &LayerId,
    widget_state: WidgetState,
    view: &InputView<'_>,
    settings: &TextInputSettings,
) -> InputResult {
    let id: WidgetId = id.into();
    let state = ctx.registry.get_or_insert_with(id.clone(), TextFieldStore::default);
    register_input_coordinator_text_input(&mut ctx.input, id, rect, layer, settings, state);
    draw_input(render, rect, widget_state, view, settings)
}

/// Level 3 — register a text input via `LayoutManager`, forwarding to L2.
pub fn register_layout_manager_text_input<P: DockPanel>(
    layout: &mut LayoutManager<P>,
    render: &mut dyn RenderContext,
    parent: LayoutNodeId,
    id: impl Into<WidgetId>,
    rect: Rect,
    widget_state: WidgetState,
    view: &InputView<'_>,
    settings: &TextInputSettings,
) -> InputResult {
    let id: WidgetId = id.into();
    let layer = layout.compute_layer_for(parent);
    let sense = Sense::CLICK.with_focus().with_text();
    layout.tree_mut().add_widget(parent, WidgetNode { id: id.clone(), kind: WidgetKind::Custom, rect, sense });
    let now_ms = layout.frame_time_ms() as u64;
    let result = register_context_manager_text_input(
        layout.ctx_mut(), render, id.clone(), rect, &layer, widget_state, view, settings,
    );
    // Draw blink caret automatically when the field is focused — caller no
    // longer needs to read `text_fields().cursor_visible()` and call
    // `draw_input_cursor` by hand.
    if view.focused
        && layout.ctx().input.text_fields().cursor_visible(now_ms)
    {
        draw_input_cursor(
            render,
            result.cursor_x,
            result.cursor_y,
            result.cursor_height,
            1.5,
            [220, 220, 220, 255],
        );
    }
    result
}