Return the exact authored ranges covering a rendered byte interval. A line or token can cross multiple spans; each result keeps its actual change owner rather than assigning the entire interval to one author.
(&self, output: std::ops::Range<usize>)
| 972 | /// A line or token can cross multiple spans; each result keeps its actual |
| 973 | /// change owner rather than assigning the entire interval to one author. |
| 974 | pub fn authored_ranges(&self, output: std::ops::Range<usize>) -> Result<Vec<VisibleSpan>> { |
| 975 | ensure!( |
| 976 | output.start <= output.end && output.end <= self.content.len(), |
| 977 | "rendered span interval is out of bounds" |
| 978 | ); |
| 979 | if output.is_empty() { |
| 980 | return Ok(Vec::new()); |
| 981 | } |
| 982 | let mut cursor = output.start; |
| 983 | let mut ranges = Vec::new(); |
| 984 | for segment in &self.spans { |
| 985 | ensure!( |
| 986 | segment.output.start <= segment.output.end |
| 987 | && segment.output.end <= self.content.len(), |
| 988 | "invalid visible span output range" |
| 989 | ); |
| 990 | let lo = output.start.max(segment.output.start); |
| 991 | let hi = output.end.min(segment.output.end); |
| 992 | if lo >= hi { |
| 993 | continue; |
| 994 | } |
| 995 | ensure!( |
| 996 | lo == cursor, |
| 997 | "authored spans do not uniquely cover the requested interval" |
| 998 | ); |
| 999 | let offset = segment |
| 1000 | .target_start |
| 1001 | .checked_add((lo - segment.output.start) as u64) |
| 1002 | .context("authored span offset overflow")?; |
| 1003 | let end = offset |
| 1004 | .checked_add((hi - lo) as u64) |
| 1005 | .context("authored span length overflow")?; |
| 1006 | let target_len = segment |
| 1007 | .target |
| 1008 | .end |
| 1009 | .checked_sub(segment.target.start) |
| 1010 | .context("invalid authored span range")?; |
| 1011 | ensure!(end <= target_len, "visible bytes exceed the authored span"); |
| 1012 | ranges.push(VisibleSpan { |
| 1013 | output: lo..hi, |
| 1014 | target: segment.target.clone(), |
| 1015 | target_start: offset, |
| 1016 | }); |
| 1017 | cursor = hi; |
| 1018 | } |
| 1019 | ensure!( |
| 1020 | cursor == output.end, |
| 1021 | "authored spans do not cover the requested interval" |
| 1022 | ); |
| 1023 | Ok(ranges) |
| 1024 | } |
| 1025 | } |
| 1026 | |
| 1027 | impl<'a, T: SpanPatchReadTxn> SpanRenderContext<'a, T> { |