uzor 1.5.1

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

//! uzor-panels — Generic docking panel layout engine
//!
//! Provides an N-ary panel tree with tabs, splits, grids, drag-and-drop,
//! separator resize, floating windows, and layout presets.
//!
//! This module is rendering-agnostic: it only handles geometry, hit-testing,
//! and layout computation. Rendering is left to the consumer.

pub mod id;
pub mod rect;
pub mod tree;
pub mod drop_zone;
pub mod drag;
pub mod separator;
pub mod snap_back;
pub mod tabs;
pub mod floating;
pub mod hit_test;
pub mod presets;
pub mod grid;
pub mod layout;
pub mod lib;
pub mod serialize;
// `manager` module dissolved — its impl moved to `uzor::layout::dock_state`
// (`DockState<P>`).  This module now only exports panel-tree primitives.

// Re-exports
pub use id::{LeafId, BranchId, NodeId};
pub use rect::PanelRect;
pub use tree::{PanelTree, PanelStore, Tile, Container, Tabs, Linear, Grid, Shares, LinearDirection, GridLayout};
pub use drop_zone::{DropZone, DropZoneDetector, CompassZone};
pub use drag::{DragDropState, LockState, DragSource, HoverTarget, PanelDragState, DragPayload};
pub use separator::{Separator, SeparatorOrientation, SeparatorState, SeparatorLevel, SeparatorController};
pub use snap_back::SnapBackAnimation;
pub use tabs::{TabBar, TabInfo, TabHit, TabDragController, TabDragState, TabReorderState, TabBarInfo, TabItem};
pub use floating::{FloatingWindow, FloatingWindowId, FloatingDragState};
pub use hit_test::{HitResult, CornerHandle};
pub use presets::{WindowLayout, SplitKind, PANEL_GAP};
pub use grid::{DockingTree, Leaf, Branch, PanelNode};
pub use serialize::{LayoutSnapshot, SerializedNode, SerializedNodeType};

/// Trait for panel types stored in the docking tree.
///
/// Consumers implement this for their domain-specific panel types.
/// The docking engine uses it for tab titles, serialization routing,
/// and minimum size enforcement.
pub trait DockPanel: Clone + Send + Sync {
    /// Title displayed in tab bar
    fn title(&self) -> &str;

    /// Type identifier for serialization routing
    fn type_id(&self) -> &'static str;

    /// Minimum size (width, height) in pixels
    fn min_size(&self) -> (f32, f32) {
        (200.0, 200.0)
    }

    /// Whether this panel can be closed by the user
    fn closable(&self) -> bool {
        true
    }

    /// Fixed height in px this panel wants when docked as a horizontal
    /// strip (an Up/Down split or a top/bottom root split). `Some(h)` →
    /// the engine rewrites the fresh split's proportions so the panel
    /// gets exactly `h` px of the divided space instead of half of it
    /// (thin one-row strips — tickers, status bars — must keep their own
    /// height wherever they dock). `None` (default) → equal split.
    fn preferred_strip_height(&self) -> Option<f32> {
        None
    }
}