mkutils 0.1.144

Utility methods, traits, and types.
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

use crate::{
    rope::{
        chunk::Chunk,
        chunk_extended_grapheme_iter::ChunkExtendedGraphemeIter,
        line::Line,
        rope::Rope,
        text_summary::{LengthExtendedGraphemes, LengthNewlines, TextSummary},
    },
    utils::Utils,
};
use derive_more::Constructor;
use zed_sum_tree::{Bias, Cursor, Dimensions};

pub type NewlineDimensions = Dimensions<LengthNewlines, TextSummary>;
pub type ExtendedGraphemeDimensions = Dimensions<LengthExtendedGraphemes, TextSummary>;
// pub type ByteDimensions = Dimensions<LengthBytes, TextSummary>;

#[derive(Constructor)]
pub struct Atom<'r> {
    pub extended_grapheme: &'r str,
    pub offset: TextSummary,
}

#[derive(Constructor)]
pub struct Atoms<'r> {
    chunk_extended_grapheme_iter: Option<ChunkExtendedGraphemeIter<'r>>,
    chunk_cursor: Cursor<'r, 'static, Chunk, NewlineDimensions>,
    offset: TextSummary,
}

impl<'r> Atoms<'r> {
    const BIAS: Bias = Bias::Left;

    #[must_use]
    pub fn from_rope(rope: &'r Rope, line_index: usize) -> Self {
        let chunk_sum_tree = rope.chunk_sum_tree();
        let mut chunk_cursor = chunk_sum_tree.cursor::<NewlineDimensions>(Rope::CONTEXT);
        let line_index_dim = line_index.convert::<LengthNewlines>();

        chunk_cursor.seek(&line_index_dim, Self::BIAS);

        let Dimensions(_line_index, offset, _unit) = chunk_cursor.start();
        let mut offset = offset.clone();

        'outer: while let Some(chunk) = chunk_cursor.iter_next() {
            let mut chunk_extended_grapheme_iter = chunk.extended_grapheme_iter();

            while offset.length.newlines != line_index {
                if let Some(distance_advanced) = chunk_extended_grapheme_iter.advance_to_start_of_next_line() {
                    offset.saturating_add_assign(&distance_advanced);
                } else {
                    offset.saturating_add_assign(&chunk_extended_grapheme_iter.advance_to_end_of_chunk());

                    continue 'outer;
                }
            }

            return Self::new(chunk_extended_grapheme_iter.some(), chunk_cursor, offset);
        }

        Self::new(None, chunk_cursor, chunk_sum_tree.summary().clone())
    }

    #[must_use]
    pub const fn offset(&self) -> &TextSummary {
        &self.offset
    }

    #[must_use]
    pub fn into_offset(self) -> TextSummary {
        self.offset
    }

    // NOTE: advance's [self.chunk_extended_grapheme_iter] but does not update [self.offset]
    fn set_next_chunk_extended_grapheme_iter(&mut self) {
        let Some(chunk) = self.chunk_cursor.iter_next() else {
            self.chunk_extended_grapheme_iter = None;

            return;
        };

        self.chunk_extended_grapheme_iter = chunk.extended_grapheme_iter().some();
    }

    pub fn advance_within_line(&mut self, mut count: usize) -> Result<TextSummary, TextSummary> {
        let mut total_distance_advanced = TextSummary::ZERO;

        while let Some(chunk_extended_grapheme_iter) = self.chunk_extended_grapheme_iter.ref_mut() {
            match chunk_extended_grapheme_iter.advance_within_line(count) {
                Ok(distance_advanced) => {
                    distance_advanced
                        .saturating_add_assign_to_both(self.offset.ref_mut(), total_distance_advanced.ref_mut());
                    count.saturating_sub_assign(&distance_advanced.length.extended_graphemes);

                    return total_distance_advanced.ok();
                }
                Err(distance_advanced) => {
                    distance_advanced
                        .saturating_add_assign_to_both(self.offset.ref_mut(), total_distance_advanced.ref_mut());
                    count.saturating_sub_assign(&distance_advanced.length.extended_graphemes);
                    self.set_next_chunk_extended_grapheme_iter();
                }
            }
        }

        total_distance_advanced.err()
    }

    pub fn advance_to_start_of_next_line(&mut self) -> Result<TextSummary, TextSummary> {
        let mut total_distance_advanced = TextSummary::ZERO;

        while let Some(chunk_extended_grapheme_iter) = self.chunk_extended_grapheme_iter.ref_mut() {
            if let Some(distance_advanced) = chunk_extended_grapheme_iter.advance_to_start_of_next_line() {
                distance_advanced
                    .saturating_add_assign_to_both(self.offset.ref_mut(), total_distance_advanced.ref_mut());

                return total_distance_advanced.ok();
            }

            chunk_extended_grapheme_iter
                .advance_to_end_of_chunk()
                .saturating_add_assign_to_both(self.offset.ref_mut(), total_distance_advanced.ref_mut());
            self.set_next_chunk_extended_grapheme_iter();
        }

        total_distance_advanced.err()
    }

    pub const fn line<'a>(&'a mut self) -> Line<'r, 'a> {
        Line::new(self)
    }
}

impl<'r> Iterator for Atoms<'r> {
    type Item = Atom<'r>;

    fn next(&mut self) -> Option<Self::Item> {
        while let Some(chunk_extended_grapheme_iter) = self.chunk_extended_grapheme_iter.ref_mut() {
            if let Some(extended_grapheme) = chunk_extended_grapheme_iter.next() {
                let distance_advanced = TextSummary::from_extended_grapheme(extended_grapheme);
                let atom = Atom::new(extended_grapheme, self.offset.clone()).some();

                self.offset.saturating_add_assign(&distance_advanced);

                return atom;
            }

            self.set_next_chunk_extended_grapheme_iter();
        }

        None
    }
}