cranpose-foundation 0.1.164

Modifiers, nodes, and foundation elements for Cranpose
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

/// Line limit configuration for text fields.
///
/// Controls whether a text field allows multiple lines of input and how many
/// lines are visible at minimum and maximum.
///
/// # SingleLine
///
/// When `SingleLine` is used:
/// - Newline characters (`\n`) are blocked from input
/// - Pasted text has newlines replaced with spaces
/// - The text field scrolls horizontally if content exceeds width
/// - The Enter key does NOT insert a newline (may trigger submit action)
///
/// # MultiLine
///
/// When `MultiLine` is used:
/// - Newline characters are allowed
/// - The text field scrolls vertically if content exceeds visible lines
/// - `min_lines` controls minimum visible height (default: 1)
/// - `max_lines` controls maximum visible height before scrolling (default: unlimited)
///
/// # Example
///
/// ```
/// use cranpose_foundation::text::TextFieldLineLimits;
///
/// // Single-line text field (like a search box)
/// let single = TextFieldLineLimits::SingleLine;
///
/// // Multi-line with default settings
/// let multi = TextFieldLineLimits::default();
///
/// // Multi-line with 3-5 visible lines
/// let constrained = TextFieldLineLimits::MultiLine {
///     min_lines: 3,
///     max_lines: 5,
/// };
/// ```
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum TextFieldLineLimits {
    /// Single line input - no newlines allowed, horizontal scrolling.
    SingleLine,
    /// Multi-line input with optional line constraints.
    ///
    /// - `min_lines`: Minimum number of visible lines (affects minimum height)
    /// - `max_lines`: Maximum number of visible lines before scrolling
    MultiLine {
        /// Minimum visible lines (default: 1)
        min_lines: usize,
        /// Maximum visible lines before scrolling (default: unlimited)
        max_lines: usize,
    },
}

impl TextFieldLineLimits {
    /// Default multi-line with no constraints (1 line minimum, unlimited maximum).
    pub const DEFAULT: Self = Self::MultiLine {
        min_lines: 1,
        max_lines: usize::MAX,
    };

    /// Returns true if this is single-line mode.
    #[inline]
    pub fn is_single_line(&self) -> bool {
        matches!(self, Self::SingleLine)
    }

    /// Returns true if this is multi-line mode.
    #[inline]
    pub fn is_multi_line(&self) -> bool {
        matches!(self, Self::MultiLine { .. })
    }

    /// Returns the minimum number of lines (1 for SingleLine).
    pub fn min_lines(&self) -> usize {
        match self {
            Self::SingleLine => 1,
            Self::MultiLine { min_lines, .. } => *min_lines,
        }
    }

    /// Returns the maximum number of lines (1 for SingleLine, configured value for MultiLine).
    pub fn max_lines(&self) -> usize {
        match self {
            Self::SingleLine => 1,
            Self::MultiLine { max_lines, .. } => *max_lines,
        }
    }
}

impl Default for TextFieldLineLimits {
    fn default() -> Self {
        Self::DEFAULT
    }
}

/// Filters text for single-line mode by replacing newlines with spaces.
///
/// This is used when:
/// - Pasting text into a SingleLine text field
/// - Programmatically setting text on a SingleLine field
///
/// # Example
///
/// ```
/// use cranpose_foundation::text::filter_for_single_line;
///
/// assert_eq!(filter_for_single_line("hello\nworld"), "hello world");
/// assert_eq!(filter_for_single_line("a\n\nb"), "a  b");
/// ```
pub fn filter_for_single_line(text: &str) -> String {
    text.replace('\n', " ")
}

#[cfg(test)]
#[path = "tests/line_limits_tests.rs"]
mod tests;