kael_ui 0.2.0

Professional shadcn-inspired UI component library for Kael. 100+ accessible components for building beautiful, performant desktop applications.
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

//! # Utility Extensions and Helper Functions
//!
//! Common extension traits and utility functions that enhance Kael's standard types
//! with convenient methods used throughout the component library.
//! ## Extension Traits
//!
//! - **`AxisExt`**: Convenient methods for checking axis orientation
//! - **`PixelsExt`**: Conversion utilities for Pixels type
//! - **`ScrollHandleOffsetable`**: Trait for scroll handle offset operations
//! - **Color utilities**: Color manipulation and conversion helpers
//! - **Layout helpers**: Common layout calculations and measurements
//!
//! ## Design Decisions
//!
//! - **Minimal Surface Area**: Only essential utilities that are reused across components
//! - **Type Safety**: Extension traits maintain strong typing and prevent errors
//! - **Performance**: Zero-cost abstractions that compile to efficient machine code
//! - **Consistency**: Standardized patterns for common operations
//! - **Discoverability**: Clear naming that makes functionality obvious
//!

use kael::{Pixels, Point, ScrollHandle, Size};

/// Extension trait for Axis
pub trait AxisExt {
    /// Returns true if the axis is horizontal
    #[allow(clippy::wrong_self_convention)]
    fn is_horizontal(self) -> bool;
    /// Returns true if the axis is vertical
    #[allow(clippy::wrong_self_convention)]
    fn is_vertical(self) -> bool;
}

impl AxisExt for kael::Axis {
    fn is_horizontal(self) -> bool {
        self == kael::Axis::Horizontal
    }

    fn is_vertical(self) -> bool {
        self == kael::Axis::Vertical
    }
}

/// Extension trait for converting Pixels to f32 and f64
pub trait PixelsExt {
    /// Convert to f32
    fn as_f32(&self) -> f32;
    /// Convert to f64
    #[allow(clippy::wrong_self_convention)]
    fn as_f64(self) -> f64;
}

impl PixelsExt for Pixels {
    fn as_f32(&self) -> f32 {
        f32::from(*self)
    }

    fn as_f64(self) -> f64 {
        f64::from(self)
    }
}

/// Trait for types that can be used as scroll handles with offset tracking
pub trait ScrollHandleOffsetable {
    /// Get the current scroll offset
    fn offset(&self) -> Point<Pixels>;
    /// Set the scroll offset
    fn set_offset(&self, offset: Point<Pixels>);
    /// Get the full content size
    fn content_size(&self) -> Size<Pixels>;
}

impl ScrollHandleOffsetable for ScrollHandle {
    fn offset(&self) -> Point<Pixels> {
        self.offset()
    }

    fn set_offset(&self, offset: Point<Pixels>) {
        self.set_offset(offset);
    }

    fn content_size(&self) -> Size<Pixels> {
        self.max_offset() + self.bounds().size
    }
}