display_map.rs

   1mod block_map;
   2mod fold_map;
   3mod tab_map;
   4mod wrap_map;
   5
   6use crate::{Anchor, AnchorRangeExt, MultiBuffer, MultiBufferSnapshot, ToOffset, ToPoint};
   7use block_map::{BlockMap, BlockPoint};
   8use collections::{HashMap, HashSet};
   9use fold_map::FoldMap;
  10use gpui::{
  11    fonts::{FontId, HighlightStyle},
  12    Entity, ModelContext, ModelHandle,
  13};
  14use language::{OffsetUtf16, Point, Subscription as BufferSubscription};
  15use settings::Settings;
  16use std::{any::TypeId, fmt::Debug, num::NonZeroU32, ops::Range, sync::Arc};
  17use sum_tree::{Bias, TreeMap};
  18use tab_map::TabMap;
  19use wrap_map::WrapMap;
  20
  21pub use block_map::{
  22    BlockBufferRows as DisplayBufferRows, BlockChunks as DisplayChunks, BlockContext,
  23    BlockDisposition, BlockId, BlockProperties, BlockStyle, RenderBlock, TransformBlock,
  24};
  25
  26pub trait ToDisplayPoint {
  27    fn to_display_point(&self, map: &DisplaySnapshot) -> DisplayPoint;
  28}
  29
  30type TextHighlights = TreeMap<Option<TypeId>, Arc<(HighlightStyle, Vec<Range<Anchor>>)>>;
  31
  32pub struct DisplayMap {
  33    buffer: ModelHandle<MultiBuffer>,
  34    buffer_subscription: BufferSubscription,
  35    fold_map: FoldMap,
  36    tab_map: TabMap,
  37    wrap_map: ModelHandle<WrapMap>,
  38    block_map: BlockMap,
  39    text_highlights: TextHighlights,
  40    pub clip_at_line_ends: bool,
  41}
  42
  43impl Entity for DisplayMap {
  44    type Event = ();
  45}
  46
  47impl DisplayMap {
  48    pub fn new(
  49        buffer: ModelHandle<MultiBuffer>,
  50        font_id: FontId,
  51        font_size: f32,
  52        wrap_width: Option<f32>,
  53        buffer_header_height: u8,
  54        excerpt_header_height: u8,
  55        cx: &mut ModelContext<Self>,
  56    ) -> Self {
  57        let buffer_subscription = buffer.update(cx, |buffer, _| buffer.subscribe());
  58
  59        let tab_size = Self::tab_size(&buffer, cx);
  60        let (fold_map, snapshot) = FoldMap::new(buffer.read(cx).snapshot(cx));
  61        let (tab_map, snapshot) = TabMap::new(snapshot, tab_size);
  62        let (wrap_map, snapshot) = WrapMap::new(snapshot, font_id, font_size, wrap_width, cx);
  63        let block_map = BlockMap::new(snapshot, buffer_header_height, excerpt_header_height);
  64        cx.observe(&wrap_map, |_, _, cx| cx.notify()).detach();
  65        DisplayMap {
  66            buffer,
  67            buffer_subscription,
  68            fold_map,
  69            tab_map,
  70            wrap_map,
  71            block_map,
  72            text_highlights: Default::default(),
  73            clip_at_line_ends: false,
  74        }
  75    }
  76
  77    pub fn snapshot(&self, cx: &mut ModelContext<Self>) -> DisplaySnapshot {
  78        let buffer_snapshot = self.buffer.read(cx).snapshot(cx);
  79        let edits = self.buffer_subscription.consume().into_inner();
  80        let (folds_snapshot, edits) = self.fold_map.read(buffer_snapshot, edits);
  81
  82        let tab_size = Self::tab_size(&self.buffer, cx);
  83        let (tabs_snapshot, edits) = self.tab_map.sync(folds_snapshot.clone(), edits, tab_size);
  84        let (wraps_snapshot, edits) = self
  85            .wrap_map
  86            .update(cx, |map, cx| map.sync(tabs_snapshot.clone(), edits, cx));
  87        let blocks_snapshot = self.block_map.read(wraps_snapshot.clone(), edits);
  88
  89        DisplaySnapshot {
  90            buffer_snapshot: self.buffer.read(cx).snapshot(cx),
  91            folds_snapshot,
  92            tabs_snapshot,
  93            wraps_snapshot,
  94            blocks_snapshot,
  95            text_highlights: self.text_highlights.clone(),
  96            clip_at_line_ends: self.clip_at_line_ends,
  97        }
  98    }
  99
 100    pub fn set_state(&mut self, other: &DisplaySnapshot, cx: &mut ModelContext<Self>) {
 101        self.fold(
 102            other
 103                .folds_in_range(0..other.buffer_snapshot.len())
 104                .map(|fold| fold.to_offset(&other.buffer_snapshot)),
 105            cx,
 106        );
 107    }
 108
 109    pub fn fold<T: ToOffset>(
 110        &mut self,
 111        ranges: impl IntoIterator<Item = Range<T>>,
 112        cx: &mut ModelContext<Self>,
 113    ) {
 114        let snapshot = self.buffer.read(cx).snapshot(cx);
 115        let edits = self.buffer_subscription.consume().into_inner();
 116        let tab_size = Self::tab_size(&self.buffer, cx);
 117        let (mut fold_map, snapshot, edits) = self.fold_map.write(snapshot, edits);
 118        let (snapshot, edits) = self.tab_map.sync(snapshot, edits, tab_size);
 119        let (snapshot, edits) = self
 120            .wrap_map
 121            .update(cx, |map, cx| map.sync(snapshot, edits, cx));
 122        self.block_map.read(snapshot, edits);
 123        let (snapshot, edits) = fold_map.fold(ranges);
 124        let (snapshot, edits) = self.tab_map.sync(snapshot, edits, tab_size);
 125        let (snapshot, edits) = self
 126            .wrap_map
 127            .update(cx, |map, cx| map.sync(snapshot, edits, cx));
 128        self.block_map.read(snapshot, edits);
 129    }
 130
 131    pub fn unfold<T: ToOffset>(
 132        &mut self,
 133        ranges: impl IntoIterator<Item = Range<T>>,
 134        inclusive: bool,
 135        cx: &mut ModelContext<Self>,
 136    ) {
 137        let snapshot = self.buffer.read(cx).snapshot(cx);
 138        let edits = self.buffer_subscription.consume().into_inner();
 139        let tab_size = Self::tab_size(&self.buffer, cx);
 140        let (mut fold_map, snapshot, edits) = self.fold_map.write(snapshot, edits);
 141        let (snapshot, edits) = self.tab_map.sync(snapshot, edits, tab_size);
 142        let (snapshot, edits) = self
 143            .wrap_map
 144            .update(cx, |map, cx| map.sync(snapshot, edits, cx));
 145        self.block_map.read(snapshot, edits);
 146        let (snapshot, edits) = fold_map.unfold(ranges, inclusive);
 147        let (snapshot, edits) = self.tab_map.sync(snapshot, edits, tab_size);
 148        let (snapshot, edits) = self
 149            .wrap_map
 150            .update(cx, |map, cx| map.sync(snapshot, edits, cx));
 151        self.block_map.read(snapshot, edits);
 152    }
 153
 154    pub fn insert_blocks(
 155        &mut self,
 156        blocks: impl IntoIterator<Item = BlockProperties<Anchor>>,
 157        cx: &mut ModelContext<Self>,
 158    ) -> Vec<BlockId> {
 159        let snapshot = self.buffer.read(cx).snapshot(cx);
 160        let edits = self.buffer_subscription.consume().into_inner();
 161        let tab_size = Self::tab_size(&self.buffer, cx);
 162        let (snapshot, edits) = self.fold_map.read(snapshot, edits);
 163        let (snapshot, edits) = self.tab_map.sync(snapshot, edits, tab_size);
 164        let (snapshot, edits) = self
 165            .wrap_map
 166            .update(cx, |map, cx| map.sync(snapshot, edits, cx));
 167        let mut block_map = self.block_map.write(snapshot, edits);
 168        block_map.insert(blocks)
 169    }
 170
 171    pub fn replace_blocks(&mut self, styles: HashMap<BlockId, RenderBlock>) {
 172        self.block_map.replace(styles);
 173    }
 174
 175    pub fn remove_blocks(&mut self, ids: HashSet<BlockId>, cx: &mut ModelContext<Self>) {
 176        let snapshot = self.buffer.read(cx).snapshot(cx);
 177        let edits = self.buffer_subscription.consume().into_inner();
 178        let tab_size = Self::tab_size(&self.buffer, cx);
 179        let (snapshot, edits) = self.fold_map.read(snapshot, edits);
 180        let (snapshot, edits) = self.tab_map.sync(snapshot, edits, tab_size);
 181        let (snapshot, edits) = self
 182            .wrap_map
 183            .update(cx, |map, cx| map.sync(snapshot, edits, cx));
 184        let mut block_map = self.block_map.write(snapshot, edits);
 185        block_map.remove(ids);
 186    }
 187
 188    pub fn highlight_text(
 189        &mut self,
 190        type_id: TypeId,
 191        ranges: Vec<Range<Anchor>>,
 192        style: HighlightStyle,
 193    ) {
 194        self.text_highlights
 195            .insert(Some(type_id), Arc::new((style, ranges)));
 196    }
 197
 198    pub fn text_highlights(&self, type_id: TypeId) -> Option<(HighlightStyle, &[Range<Anchor>])> {
 199        let highlights = self.text_highlights.get(&Some(type_id))?;
 200        Some((highlights.0, &highlights.1))
 201    }
 202
 203    pub fn clear_text_highlights(
 204        &mut self,
 205        type_id: TypeId,
 206    ) -> Option<Arc<(HighlightStyle, Vec<Range<Anchor>>)>> {
 207        self.text_highlights.remove(&Some(type_id))
 208    }
 209
 210    pub fn set_font(&self, font_id: FontId, font_size: f32, cx: &mut ModelContext<Self>) -> bool {
 211        self.wrap_map
 212            .update(cx, |map, cx| map.set_font(font_id, font_size, cx))
 213    }
 214
 215    pub fn set_wrap_width(&self, width: Option<f32>, cx: &mut ModelContext<Self>) -> bool {
 216        self.wrap_map
 217            .update(cx, |map, cx| map.set_wrap_width(width, cx))
 218    }
 219
 220    fn tab_size(buffer: &ModelHandle<MultiBuffer>, cx: &mut ModelContext<Self>) -> NonZeroU32 {
 221        let language_name = buffer
 222            .read(cx)
 223            .as_singleton()
 224            .and_then(|buffer| buffer.read(cx).language())
 225            .map(|language| language.name());
 226
 227        cx.global::<Settings>().tab_size(language_name.as_deref())
 228    }
 229
 230    #[cfg(test)]
 231    pub fn is_rewrapping(&self, cx: &gpui::AppContext) -> bool {
 232        self.wrap_map.read(cx).is_rewrapping()
 233    }
 234}
 235
 236pub struct DisplaySnapshot {
 237    pub buffer_snapshot: MultiBufferSnapshot,
 238    folds_snapshot: fold_map::FoldSnapshot,
 239    tabs_snapshot: tab_map::TabSnapshot,
 240    wraps_snapshot: wrap_map::WrapSnapshot,
 241    blocks_snapshot: block_map::BlockSnapshot,
 242    text_highlights: TextHighlights,
 243    clip_at_line_ends: bool,
 244}
 245
 246impl DisplaySnapshot {
 247    #[cfg(test)]
 248    pub fn fold_count(&self) -> usize {
 249        self.folds_snapshot.fold_count()
 250    }
 251
 252    pub fn is_empty(&self) -> bool {
 253        self.buffer_snapshot.len() == 0
 254    }
 255
 256    pub fn buffer_rows(&self, start_row: u32) -> DisplayBufferRows {
 257        self.blocks_snapshot.buffer_rows(start_row)
 258    }
 259
 260    pub fn max_buffer_row(&self) -> u32 {
 261        self.buffer_snapshot.max_buffer_row()
 262    }
 263
 264    pub fn prev_line_boundary(&self, mut point: Point) -> (Point, DisplayPoint) {
 265        loop {
 266            let mut fold_point = self.folds_snapshot.to_fold_point(point, Bias::Left);
 267            *fold_point.column_mut() = 0;
 268            point = fold_point.to_buffer_point(&self.folds_snapshot);
 269
 270            let mut display_point = self.point_to_display_point(point, Bias::Left);
 271            *display_point.column_mut() = 0;
 272            let next_point = self.display_point_to_point(display_point, Bias::Left);
 273            if next_point == point {
 274                return (point, display_point);
 275            }
 276            point = next_point;
 277        }
 278    }
 279
 280    pub fn next_line_boundary(&self, mut point: Point) -> (Point, DisplayPoint) {
 281        loop {
 282            let mut fold_point = self.folds_snapshot.to_fold_point(point, Bias::Right);
 283            *fold_point.column_mut() = self.folds_snapshot.line_len(fold_point.row());
 284            point = fold_point.to_buffer_point(&self.folds_snapshot);
 285
 286            let mut display_point = self.point_to_display_point(point, Bias::Right);
 287            *display_point.column_mut() = self.line_len(display_point.row());
 288            let next_point = self.display_point_to_point(display_point, Bias::Right);
 289            if next_point == point {
 290                return (point, display_point);
 291            }
 292            point = next_point;
 293        }
 294    }
 295
 296    pub fn expand_to_line(&self, range: Range<Point>) -> Range<Point> {
 297        let mut new_start = self.prev_line_boundary(range.start).0;
 298        let mut new_end = self.next_line_boundary(range.end).0;
 299
 300        if new_start.row == range.start.row && new_end.row == range.end.row {
 301            if new_end.row < self.buffer_snapshot.max_point().row {
 302                new_end.row += 1;
 303                new_end.column = 0;
 304            } else if new_start.row > 0 {
 305                new_start.row -= 1;
 306                new_start.column = self.buffer_snapshot.line_len(new_start.row);
 307            }
 308        }
 309
 310        new_start..new_end
 311    }
 312
 313    fn point_to_display_point(&self, point: Point, bias: Bias) -> DisplayPoint {
 314        let fold_point = self.folds_snapshot.to_fold_point(point, bias);
 315        let tab_point = self.tabs_snapshot.to_tab_point(fold_point);
 316        let wrap_point = self.wraps_snapshot.tab_point_to_wrap_point(tab_point);
 317        let block_point = self.blocks_snapshot.to_block_point(wrap_point);
 318        DisplayPoint(block_point)
 319    }
 320
 321    fn display_point_to_point(&self, point: DisplayPoint, bias: Bias) -> Point {
 322        let block_point = point.0;
 323        let wrap_point = self.blocks_snapshot.to_wrap_point(block_point);
 324        let tab_point = self.wraps_snapshot.to_tab_point(wrap_point);
 325        let fold_point = self.tabs_snapshot.to_fold_point(tab_point, bias).0;
 326        fold_point.to_buffer_point(&self.folds_snapshot)
 327    }
 328
 329    pub fn max_point(&self) -> DisplayPoint {
 330        DisplayPoint(self.blocks_snapshot.max_point())
 331    }
 332
 333    /// Returns text chunks starting at the given display row until the end of the file
 334    pub fn text_chunks(&self, display_row: u32) -> impl Iterator<Item = &str> {
 335        self.blocks_snapshot
 336            .chunks(display_row..self.max_point().row() + 1, false, None)
 337            .map(|h| h.text)
 338    }
 339
 340    // Returns text chunks starting at the end of the given display row in reverse until the start of the file
 341    pub fn reverse_text_chunks(&self, display_row: u32) -> impl Iterator<Item = &str> {
 342        (0..=display_row).into_iter().rev().flat_map(|row| {
 343            self.blocks_snapshot
 344                .chunks(row..row + 1, false, None)
 345                .map(|h| h.text)
 346                .collect::<Vec<_>>()
 347                .into_iter()
 348                .rev()
 349        })
 350    }
 351
 352    pub fn chunks(&self, display_rows: Range<u32>, language_aware: bool) -> DisplayChunks<'_> {
 353        self.blocks_snapshot
 354            .chunks(display_rows, language_aware, Some(&self.text_highlights))
 355    }
 356
 357    pub fn chars_at(
 358        &self,
 359        mut point: DisplayPoint,
 360    ) -> impl Iterator<Item = (char, DisplayPoint)> + '_ {
 361        point = DisplayPoint(self.blocks_snapshot.clip_point(point.0, Bias::Left));
 362        self.text_chunks(point.row())
 363            .flat_map(str::chars)
 364            .skip_while({
 365                let mut column = 0;
 366                move |char| {
 367                    let at_point = column >= point.column();
 368                    column += char.len_utf8() as u32;
 369                    !at_point
 370                }
 371            })
 372            .map(move |ch| {
 373                let result = (ch, point);
 374                if ch == '\n' {
 375                    *point.row_mut() += 1;
 376                    *point.column_mut() = 0;
 377                } else {
 378                    *point.column_mut() += ch.len_utf8() as u32;
 379                }
 380                result
 381            })
 382    }
 383
 384    pub fn reverse_chars_at(
 385        &self,
 386        mut point: DisplayPoint,
 387    ) -> impl Iterator<Item = (char, DisplayPoint)> + '_ {
 388        point = DisplayPoint(self.blocks_snapshot.clip_point(point.0, Bias::Left));
 389        self.reverse_text_chunks(point.row())
 390            .flat_map(|chunk| chunk.chars().rev())
 391            .skip_while({
 392                let mut column = self.line_len(point.row());
 393                if self.max_point().row() > point.row() {
 394                    column += 1;
 395                }
 396
 397                move |char| {
 398                    let at_point = column <= point.column();
 399                    column = column.saturating_sub(char.len_utf8() as u32);
 400                    !at_point
 401                }
 402            })
 403            .map(move |ch| {
 404                if ch == '\n' {
 405                    *point.row_mut() -= 1;
 406                    *point.column_mut() = self.line_len(point.row());
 407                } else {
 408                    *point.column_mut() = point.column().saturating_sub(ch.len_utf8() as u32);
 409                }
 410                (ch, point)
 411            })
 412    }
 413
 414    pub fn column_to_chars(&self, display_row: u32, target: u32) -> u32 {
 415        let mut count = 0;
 416        let mut column = 0;
 417        for (c, _) in self.chars_at(DisplayPoint::new(display_row, 0)) {
 418            if column >= target {
 419                break;
 420            }
 421            count += 1;
 422            column += c.len_utf8() as u32;
 423        }
 424        count
 425    }
 426
 427    pub fn column_from_chars(&self, display_row: u32, char_count: u32) -> u32 {
 428        let mut column = 0;
 429
 430        for (count, (c, _)) in self.chars_at(DisplayPoint::new(display_row, 0)).enumerate() {
 431            if c == '\n' || count >= char_count as usize {
 432                break;
 433            }
 434            column += c.len_utf8() as u32;
 435        }
 436
 437        column
 438    }
 439
 440    pub fn clip_point(&self, point: DisplayPoint, bias: Bias) -> DisplayPoint {
 441        let mut clipped = self.blocks_snapshot.clip_point(point.0, bias);
 442        if self.clip_at_line_ends {
 443            clipped = self.clip_at_line_end(DisplayPoint(clipped)).0
 444        }
 445        DisplayPoint(clipped)
 446    }
 447
 448    pub fn clip_at_line_end(&self, point: DisplayPoint) -> DisplayPoint {
 449        let mut point = point.0;
 450        if point.column == self.line_len(point.row) {
 451            point.column = point.column.saturating_sub(1);
 452            point = self.blocks_snapshot.clip_point(point, Bias::Left);
 453        }
 454        DisplayPoint(point)
 455    }
 456
 457    pub fn folds_in_range<T>(&self, range: Range<T>) -> impl Iterator<Item = &Range<Anchor>>
 458    where
 459        T: ToOffset,
 460    {
 461        self.folds_snapshot.folds_in_range(range)
 462    }
 463
 464    pub fn blocks_in_range(
 465        &self,
 466        rows: Range<u32>,
 467    ) -> impl Iterator<Item = (u32, &TransformBlock)> {
 468        self.blocks_snapshot.blocks_in_range(rows)
 469    }
 470
 471    pub fn intersects_fold<T: ToOffset>(&self, offset: T) -> bool {
 472        self.folds_snapshot.intersects_fold(offset)
 473    }
 474
 475    pub fn is_line_folded(&self, display_row: u32) -> bool {
 476        let block_point = BlockPoint(Point::new(display_row, 0));
 477        let wrap_point = self.blocks_snapshot.to_wrap_point(block_point);
 478        let tab_point = self.wraps_snapshot.to_tab_point(wrap_point);
 479        self.folds_snapshot.is_line_folded(tab_point.row())
 480    }
 481
 482    pub fn is_block_line(&self, display_row: u32) -> bool {
 483        self.blocks_snapshot.is_block_line(display_row)
 484    }
 485
 486    pub fn soft_wrap_indent(&self, display_row: u32) -> Option<u32> {
 487        let wrap_row = self
 488            .blocks_snapshot
 489            .to_wrap_point(BlockPoint::new(display_row, 0))
 490            .row();
 491        self.wraps_snapshot.soft_wrap_indent(wrap_row)
 492    }
 493
 494    pub fn text(&self) -> String {
 495        self.text_chunks(0).collect()
 496    }
 497
 498    pub fn line(&self, display_row: u32) -> String {
 499        let mut result = String::new();
 500        for chunk in self.text_chunks(display_row) {
 501            if let Some(ix) = chunk.find('\n') {
 502                result.push_str(&chunk[0..ix]);
 503                break;
 504            } else {
 505                result.push_str(chunk);
 506            }
 507        }
 508        result
 509    }
 510
 511    pub fn line_indent(&self, display_row: u32) -> (u32, bool) {
 512        let mut indent = 0;
 513        let mut is_blank = true;
 514        for (c, _) in self.chars_at(DisplayPoint::new(display_row, 0)) {
 515            if c == ' ' {
 516                indent += 1;
 517            } else {
 518                is_blank = c == '\n';
 519                break;
 520            }
 521        }
 522        (indent, is_blank)
 523    }
 524
 525    pub fn line_len(&self, row: u32) -> u32 {
 526        self.blocks_snapshot.line_len(row)
 527    }
 528
 529    pub fn longest_row(&self) -> u32 {
 530        self.blocks_snapshot.longest_row()
 531    }
 532
 533    #[cfg(any(test, feature = "test-support"))]
 534    pub fn highlight_ranges<Tag: ?Sized + 'static>(
 535        &self,
 536    ) -> Option<Arc<(HighlightStyle, Vec<Range<Anchor>>)>> {
 537        let type_id = TypeId::of::<Tag>();
 538        self.text_highlights.get(&Some(type_id)).cloned()
 539    }
 540}
 541
 542#[derive(Copy, Clone, Default, Eq, Ord, PartialOrd, PartialEq)]
 543pub struct DisplayPoint(BlockPoint);
 544
 545impl Debug for DisplayPoint {
 546    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
 547        f.write_fmt(format_args!(
 548            "DisplayPoint({}, {})",
 549            self.row(),
 550            self.column()
 551        ))
 552    }
 553}
 554
 555impl DisplayPoint {
 556    pub fn new(row: u32, column: u32) -> Self {
 557        Self(BlockPoint(Point::new(row, column)))
 558    }
 559
 560    pub fn zero() -> Self {
 561        Self::new(0, 0)
 562    }
 563
 564    pub fn is_zero(&self) -> bool {
 565        self.0.is_zero()
 566    }
 567
 568    pub fn row(self) -> u32 {
 569        self.0.row
 570    }
 571
 572    pub fn column(self) -> u32 {
 573        self.0.column
 574    }
 575
 576    pub fn row_mut(&mut self) -> &mut u32 {
 577        &mut self.0.row
 578    }
 579
 580    pub fn column_mut(&mut self) -> &mut u32 {
 581        &mut self.0.column
 582    }
 583
 584    pub fn to_point(self, map: &DisplaySnapshot) -> Point {
 585        map.display_point_to_point(self, Bias::Left)
 586    }
 587
 588    pub fn to_offset(self, map: &DisplaySnapshot, bias: Bias) -> usize {
 589        let unblocked_point = map.blocks_snapshot.to_wrap_point(self.0);
 590        let unwrapped_point = map.wraps_snapshot.to_tab_point(unblocked_point);
 591        let unexpanded_point = map.tabs_snapshot.to_fold_point(unwrapped_point, bias).0;
 592        unexpanded_point.to_buffer_offset(&map.folds_snapshot)
 593    }
 594}
 595
 596impl ToDisplayPoint for usize {
 597    fn to_display_point(&self, map: &DisplaySnapshot) -> DisplayPoint {
 598        map.point_to_display_point(self.to_point(&map.buffer_snapshot), Bias::Left)
 599    }
 600}
 601
 602impl ToDisplayPoint for OffsetUtf16 {
 603    fn to_display_point(&self, map: &DisplaySnapshot) -> DisplayPoint {
 604        self.to_offset(&map.buffer_snapshot).to_display_point(map)
 605    }
 606}
 607
 608impl ToDisplayPoint for Point {
 609    fn to_display_point(&self, map: &DisplaySnapshot) -> DisplayPoint {
 610        map.point_to_display_point(*self, Bias::Left)
 611    }
 612}
 613
 614impl ToDisplayPoint for Anchor {
 615    fn to_display_point(&self, map: &DisplaySnapshot) -> DisplayPoint {
 616        self.to_point(&map.buffer_snapshot).to_display_point(map)
 617    }
 618}
 619
 620#[cfg(test)]
 621pub mod tests {
 622    use super::*;
 623    use crate::{movement, test::marked_display_snapshot};
 624    use gpui::{color::Color, elements::*, test::observe, MutableAppContext};
 625    use language::{Buffer, Language, LanguageConfig, SelectionGoal};
 626    use rand::{prelude::*, Rng};
 627    use smol::stream::StreamExt;
 628    use std::{env, sync::Arc};
 629    use theme::SyntaxTheme;
 630    use util::test::{marked_text_ranges, sample_text};
 631    use Bias::*;
 632
 633    #[gpui::test(iterations = 100)]
 634    async fn test_random_display_map(cx: &mut gpui::TestAppContext, mut rng: StdRng) {
 635        cx.foreground().set_block_on_ticks(0..=50);
 636        cx.foreground().forbid_parking();
 637        let operations = env::var("OPERATIONS")
 638            .map(|i| i.parse().expect("invalid `OPERATIONS` variable"))
 639            .unwrap_or(10);
 640
 641        let font_cache = cx.font_cache().clone();
 642        let mut tab_size = rng.gen_range(1..=4);
 643        let buffer_start_excerpt_header_height = rng.gen_range(1..=5);
 644        let excerpt_header_height = rng.gen_range(1..=5);
 645        let family_id = font_cache.load_family(&["Helvetica"]).unwrap();
 646        let font_id = font_cache
 647            .select_font(family_id, &Default::default())
 648            .unwrap();
 649        let font_size = 14.0;
 650        let max_wrap_width = 300.0;
 651        let mut wrap_width = if rng.gen_bool(0.1) {
 652            None
 653        } else {
 654            Some(rng.gen_range(0.0..=max_wrap_width))
 655        };
 656
 657        log::info!("tab size: {}", tab_size);
 658        log::info!("wrap width: {:?}", wrap_width);
 659
 660        cx.update(|cx| {
 661            let mut settings = Settings::test(cx);
 662            settings.editor_overrides.tab_size = NonZeroU32::new(tab_size);
 663            cx.set_global(settings)
 664        });
 665
 666        let buffer = cx.update(|cx| {
 667            if rng.gen() {
 668                let len = rng.gen_range(0..10);
 669                let text = util::RandomCharIter::new(&mut rng)
 670                    .take(len)
 671                    .collect::<String>();
 672                MultiBuffer::build_simple(&text, cx)
 673            } else {
 674                MultiBuffer::build_random(&mut rng, cx)
 675            }
 676        });
 677
 678        let map = cx.add_model(|cx| {
 679            DisplayMap::new(
 680                buffer.clone(),
 681                font_id,
 682                font_size,
 683                wrap_width,
 684                buffer_start_excerpt_header_height,
 685                excerpt_header_height,
 686                cx,
 687            )
 688        });
 689        let mut notifications = observe(&map, cx);
 690        let mut fold_count = 0;
 691        let mut blocks = Vec::new();
 692
 693        let snapshot = map.update(cx, |map, cx| map.snapshot(cx));
 694        log::info!("buffer text: {:?}", snapshot.buffer_snapshot.text());
 695        log::info!("fold text: {:?}", snapshot.folds_snapshot.text());
 696        log::info!("tab text: {:?}", snapshot.tabs_snapshot.text());
 697        log::info!("wrap text: {:?}", snapshot.wraps_snapshot.text());
 698        log::info!("block text: {:?}", snapshot.blocks_snapshot.text());
 699        log::info!("display text: {:?}", snapshot.text());
 700
 701        for _i in 0..operations {
 702            match rng.gen_range(0..100) {
 703                0..=19 => {
 704                    wrap_width = if rng.gen_bool(0.2) {
 705                        None
 706                    } else {
 707                        Some(rng.gen_range(0.0..=max_wrap_width))
 708                    };
 709                    log::info!("setting wrap width to {:?}", wrap_width);
 710                    map.update(cx, |map, cx| map.set_wrap_width(wrap_width, cx));
 711                }
 712                20..=29 => {
 713                    let mut tab_sizes = vec![1, 2, 3, 4];
 714                    tab_sizes.remove((tab_size - 1) as usize);
 715                    tab_size = *tab_sizes.choose(&mut rng).unwrap();
 716                    log::info!("setting tab size to {:?}", tab_size);
 717                    cx.update(|cx| {
 718                        let mut settings = Settings::test(cx);
 719                        settings.editor_overrides.tab_size = NonZeroU32::new(tab_size);
 720                        cx.set_global(settings)
 721                    });
 722                }
 723                30..=44 => {
 724                    map.update(cx, |map, cx| {
 725                        if rng.gen() || blocks.is_empty() {
 726                            let buffer = map.snapshot(cx).buffer_snapshot;
 727                            let block_properties = (0..rng.gen_range(1..=1))
 728                                .map(|_| {
 729                                    let position =
 730                                        buffer.anchor_after(buffer.clip_offset(
 731                                            rng.gen_range(0..=buffer.len()),
 732                                            Bias::Left,
 733                                        ));
 734
 735                                    let disposition = if rng.gen() {
 736                                        BlockDisposition::Above
 737                                    } else {
 738                                        BlockDisposition::Below
 739                                    };
 740                                    let height = rng.gen_range(1..5);
 741                                    log::info!(
 742                                        "inserting block {:?} {:?} with height {}",
 743                                        disposition,
 744                                        position.to_point(&buffer),
 745                                        height
 746                                    );
 747                                    BlockProperties {
 748                                        style: BlockStyle::Fixed,
 749                                        position,
 750                                        height,
 751                                        disposition,
 752                                        render: Arc::new(|_| Empty::new().boxed()),
 753                                    }
 754                                })
 755                                .collect::<Vec<_>>();
 756                            blocks.extend(map.insert_blocks(block_properties, cx));
 757                        } else {
 758                            blocks.shuffle(&mut rng);
 759                            let remove_count = rng.gen_range(1..=4.min(blocks.len()));
 760                            let block_ids_to_remove = (0..remove_count)
 761                                .map(|_| blocks.remove(rng.gen_range(0..blocks.len())))
 762                                .collect();
 763                            log::info!("removing block ids {:?}", block_ids_to_remove);
 764                            map.remove_blocks(block_ids_to_remove, cx);
 765                        }
 766                    });
 767                }
 768                45..=79 => {
 769                    let mut ranges = Vec::new();
 770                    for _ in 0..rng.gen_range(1..=3) {
 771                        buffer.read_with(cx, |buffer, cx| {
 772                            let buffer = buffer.read(cx);
 773                            let end = buffer.clip_offset(rng.gen_range(0..=buffer.len()), Right);
 774                            let start = buffer.clip_offset(rng.gen_range(0..=end), Left);
 775                            ranges.push(start..end);
 776                        });
 777                    }
 778
 779                    if rng.gen() && fold_count > 0 {
 780                        log::info!("unfolding ranges: {:?}", ranges);
 781                        map.update(cx, |map, cx| {
 782                            map.unfold(ranges, true, cx);
 783                        });
 784                    } else {
 785                        log::info!("folding ranges: {:?}", ranges);
 786                        map.update(cx, |map, cx| {
 787                            map.fold(ranges, cx);
 788                        });
 789                    }
 790                }
 791                _ => {
 792                    buffer.update(cx, |buffer, cx| buffer.randomly_mutate(&mut rng, 5, cx));
 793                }
 794            }
 795
 796            if map.read_with(cx, |map, cx| map.is_rewrapping(cx)) {
 797                notifications.next().await.unwrap();
 798            }
 799
 800            let snapshot = map.update(cx, |map, cx| map.snapshot(cx));
 801            fold_count = snapshot.fold_count();
 802            log::info!("buffer text: {:?}", snapshot.buffer_snapshot.text());
 803            log::info!("fold text: {:?}", snapshot.folds_snapshot.text());
 804            log::info!("tab text: {:?}", snapshot.tabs_snapshot.text());
 805            log::info!("wrap text: {:?}", snapshot.wraps_snapshot.text());
 806            log::info!("block text: {:?}", snapshot.blocks_snapshot.text());
 807            log::info!("display text: {:?}", snapshot.text());
 808
 809            // Line boundaries
 810            let buffer = &snapshot.buffer_snapshot;
 811            for _ in 0..5 {
 812                let row = rng.gen_range(0..=buffer.max_point().row);
 813                let column = rng.gen_range(0..=buffer.line_len(row));
 814                let point = buffer.clip_point(Point::new(row, column), Left);
 815
 816                let (prev_buffer_bound, prev_display_bound) = snapshot.prev_line_boundary(point);
 817                let (next_buffer_bound, next_display_bound) = snapshot.next_line_boundary(point);
 818
 819                assert!(prev_buffer_bound <= point);
 820                assert!(next_buffer_bound >= point);
 821                assert_eq!(prev_buffer_bound.column, 0);
 822                assert_eq!(prev_display_bound.column(), 0);
 823                if next_buffer_bound < buffer.max_point() {
 824                    assert_eq!(buffer.chars_at(next_buffer_bound).next(), Some('\n'));
 825                }
 826
 827                assert_eq!(
 828                    prev_display_bound,
 829                    prev_buffer_bound.to_display_point(&snapshot),
 830                    "row boundary before {:?}. reported buffer row boundary: {:?}",
 831                    point,
 832                    prev_buffer_bound
 833                );
 834                assert_eq!(
 835                    next_display_bound,
 836                    next_buffer_bound.to_display_point(&snapshot),
 837                    "display row boundary after {:?}. reported buffer row boundary: {:?}",
 838                    point,
 839                    next_buffer_bound
 840                );
 841                assert_eq!(
 842                    prev_buffer_bound,
 843                    prev_display_bound.to_point(&snapshot),
 844                    "row boundary before {:?}. reported display row boundary: {:?}",
 845                    point,
 846                    prev_display_bound
 847                );
 848                assert_eq!(
 849                    next_buffer_bound,
 850                    next_display_bound.to_point(&snapshot),
 851                    "row boundary after {:?}. reported display row boundary: {:?}",
 852                    point,
 853                    next_display_bound
 854                );
 855            }
 856
 857            // Movement
 858            let min_point = snapshot.clip_point(DisplayPoint::new(0, 0), Left);
 859            let max_point = snapshot.clip_point(snapshot.max_point(), Right);
 860            for _ in 0..5 {
 861                let row = rng.gen_range(0..=snapshot.max_point().row());
 862                let column = rng.gen_range(0..=snapshot.line_len(row));
 863                let point = snapshot.clip_point(DisplayPoint::new(row, column), Left);
 864
 865                log::info!("Moving from point {:?}", point);
 866
 867                let moved_right = movement::right(&snapshot, point);
 868                log::info!("Right {:?}", moved_right);
 869                if point < max_point {
 870                    assert!(moved_right > point);
 871                    if point.column() == snapshot.line_len(point.row())
 872                        || snapshot.soft_wrap_indent(point.row()).is_some()
 873                            && point.column() == snapshot.line_len(point.row()) - 1
 874                    {
 875                        assert!(moved_right.row() > point.row());
 876                    }
 877                } else {
 878                    assert_eq!(moved_right, point);
 879                }
 880
 881                let moved_left = movement::left(&snapshot, point);
 882                log::info!("Left {:?}", moved_left);
 883                if point > min_point {
 884                    assert!(moved_left < point);
 885                    if point.column() == 0 {
 886                        assert!(moved_left.row() < point.row());
 887                    }
 888                } else {
 889                    assert_eq!(moved_left, point);
 890                }
 891            }
 892        }
 893    }
 894
 895    #[gpui::test(retries = 5)]
 896    fn test_soft_wraps(cx: &mut MutableAppContext) {
 897        cx.foreground().set_block_on_ticks(usize::MAX..=usize::MAX);
 898        cx.foreground().forbid_parking();
 899
 900        let font_cache = cx.font_cache();
 901
 902        let family_id = font_cache.load_family(&["Helvetica"]).unwrap();
 903        let font_id = font_cache
 904            .select_font(family_id, &Default::default())
 905            .unwrap();
 906        let font_size = 12.0;
 907        let wrap_width = Some(64.);
 908        cx.set_global(Settings::test(cx));
 909
 910        let text = "one two three four five\nsix seven eight";
 911        let buffer = MultiBuffer::build_simple(text, cx);
 912        let map = cx.add_model(|cx| {
 913            DisplayMap::new(buffer.clone(), font_id, font_size, wrap_width, 1, 1, cx)
 914        });
 915
 916        let snapshot = map.update(cx, |map, cx| map.snapshot(cx));
 917        assert_eq!(
 918            snapshot.text_chunks(0).collect::<String>(),
 919            "one two \nthree four \nfive\nsix seven \neight"
 920        );
 921        assert_eq!(
 922            snapshot.clip_point(DisplayPoint::new(0, 8), Bias::Left),
 923            DisplayPoint::new(0, 7)
 924        );
 925        assert_eq!(
 926            snapshot.clip_point(DisplayPoint::new(0, 8), Bias::Right),
 927            DisplayPoint::new(1, 0)
 928        );
 929        assert_eq!(
 930            movement::right(&snapshot, DisplayPoint::new(0, 7)),
 931            DisplayPoint::new(1, 0)
 932        );
 933        assert_eq!(
 934            movement::left(&snapshot, DisplayPoint::new(1, 0)),
 935            DisplayPoint::new(0, 7)
 936        );
 937        assert_eq!(
 938            movement::up(
 939                &snapshot,
 940                DisplayPoint::new(1, 10),
 941                SelectionGoal::None,
 942                false
 943            ),
 944            (DisplayPoint::new(0, 7), SelectionGoal::Column(10))
 945        );
 946        assert_eq!(
 947            movement::down(
 948                &snapshot,
 949                DisplayPoint::new(0, 7),
 950                SelectionGoal::Column(10),
 951                false
 952            ),
 953            (DisplayPoint::new(1, 10), SelectionGoal::Column(10))
 954        );
 955        assert_eq!(
 956            movement::down(
 957                &snapshot,
 958                DisplayPoint::new(1, 10),
 959                SelectionGoal::Column(10),
 960                false
 961            ),
 962            (DisplayPoint::new(2, 4), SelectionGoal::Column(10))
 963        );
 964
 965        let ix = snapshot.buffer_snapshot.text().find("seven").unwrap();
 966        buffer.update(cx, |buffer, cx| {
 967            buffer.edit([(ix..ix, "and ")], None, cx);
 968        });
 969
 970        let snapshot = map.update(cx, |map, cx| map.snapshot(cx));
 971        assert_eq!(
 972            snapshot.text_chunks(1).collect::<String>(),
 973            "three four \nfive\nsix and \nseven eight"
 974        );
 975
 976        // Re-wrap on font size changes
 977        map.update(cx, |map, cx| map.set_font(font_id, font_size + 3., cx));
 978
 979        let snapshot = map.update(cx, |map, cx| map.snapshot(cx));
 980        assert_eq!(
 981            snapshot.text_chunks(1).collect::<String>(),
 982            "three \nfour five\nsix and \nseven \neight"
 983        )
 984    }
 985
 986    #[gpui::test]
 987    fn test_text_chunks(cx: &mut gpui::MutableAppContext) {
 988        cx.set_global(Settings::test(cx));
 989        let text = sample_text(6, 6, 'a');
 990        let buffer = MultiBuffer::build_simple(&text, cx);
 991        let family_id = cx.font_cache().load_family(&["Helvetica"]).unwrap();
 992        let font_id = cx
 993            .font_cache()
 994            .select_font(family_id, &Default::default())
 995            .unwrap();
 996        let font_size = 14.0;
 997        let map =
 998            cx.add_model(|cx| DisplayMap::new(buffer.clone(), font_id, font_size, None, 1, 1, cx));
 999        buffer.update(cx, |buffer, cx| {
1000            buffer.edit(
1001                vec![
1002                    (Point::new(1, 0)..Point::new(1, 0), "\t"),
1003                    (Point::new(1, 1)..Point::new(1, 1), "\t"),
1004                    (Point::new(2, 1)..Point::new(2, 1), "\t"),
1005                ],
1006                None,
1007                cx,
1008            )
1009        });
1010
1011        assert_eq!(
1012            map.update(cx, |map, cx| map.snapshot(cx))
1013                .text_chunks(1)
1014                .collect::<String>()
1015                .lines()
1016                .next(),
1017            Some("    b   bbbbb")
1018        );
1019        assert_eq!(
1020            map.update(cx, |map, cx| map.snapshot(cx))
1021                .text_chunks(2)
1022                .collect::<String>()
1023                .lines()
1024                .next(),
1025            Some("c   ccccc")
1026        );
1027    }
1028
1029    #[gpui::test]
1030    async fn test_chunks(cx: &mut gpui::TestAppContext) {
1031        use unindent::Unindent as _;
1032
1033        let text = r#"
1034            fn outer() {}
1035
1036            mod module {
1037                fn inner() {}
1038            }"#
1039        .unindent();
1040
1041        let theme = SyntaxTheme::new(vec![
1042            ("mod.body".to_string(), Color::red().into()),
1043            ("fn.name".to_string(), Color::blue().into()),
1044        ]);
1045        let language = Arc::new(
1046            Language::new(
1047                LanguageConfig {
1048                    name: "Test".into(),
1049                    path_suffixes: vec![".test".to_string()],
1050                    ..Default::default()
1051                },
1052                Some(tree_sitter_rust::language()),
1053            )
1054            .with_highlights_query(
1055                r#"
1056                (mod_item name: (identifier) body: _ @mod.body)
1057                (function_item name: (identifier) @fn.name)
1058                "#,
1059            )
1060            .unwrap(),
1061        );
1062        language.set_theme(&theme);
1063        cx.update(|cx| {
1064            let mut settings = Settings::test(cx);
1065            settings.editor_defaults.tab_size = Some(2.try_into().unwrap());
1066            cx.set_global(settings);
1067        });
1068
1069        let buffer = cx.add_model(|cx| Buffer::new(0, text, cx).with_language(language, cx));
1070        buffer.condition(cx, |buf, _| !buf.is_parsing()).await;
1071        let buffer = cx.add_model(|cx| MultiBuffer::singleton(buffer, cx));
1072
1073        let font_cache = cx.font_cache();
1074        let family_id = font_cache.load_family(&["Helvetica"]).unwrap();
1075        let font_id = font_cache
1076            .select_font(family_id, &Default::default())
1077            .unwrap();
1078        let font_size = 14.0;
1079
1080        let map = cx.add_model(|cx| DisplayMap::new(buffer, font_id, font_size, None, 1, 1, cx));
1081        assert_eq!(
1082            cx.update(|cx| syntax_chunks(0..5, &map, &theme, cx)),
1083            vec![
1084                ("fn ".to_string(), None),
1085                ("outer".to_string(), Some(Color::blue())),
1086                ("() {}\n\nmod module ".to_string(), None),
1087                ("{\n    fn ".to_string(), Some(Color::red())),
1088                ("inner".to_string(), Some(Color::blue())),
1089                ("() {}\n}".to_string(), Some(Color::red())),
1090            ]
1091        );
1092        assert_eq!(
1093            cx.update(|cx| syntax_chunks(3..5, &map, &theme, cx)),
1094            vec![
1095                ("    fn ".to_string(), Some(Color::red())),
1096                ("inner".to_string(), Some(Color::blue())),
1097                ("() {}\n}".to_string(), Some(Color::red())),
1098            ]
1099        );
1100
1101        map.update(cx, |map, cx| {
1102            map.fold(vec![Point::new(0, 6)..Point::new(3, 2)], cx)
1103        });
1104        assert_eq!(
1105            cx.update(|cx| syntax_chunks(0..2, &map, &theme, cx)),
1106            vec![
1107                ("fn ".to_string(), None),
1108                ("out".to_string(), Some(Color::blue())),
1109                ("…".to_string(), None),
1110                ("  fn ".to_string(), Some(Color::red())),
1111                ("inner".to_string(), Some(Color::blue())),
1112                ("() {}\n}".to_string(), Some(Color::red())),
1113            ]
1114        );
1115    }
1116
1117    #[gpui::test]
1118    async fn test_chunks_with_soft_wrapping(cx: &mut gpui::TestAppContext) {
1119        use unindent::Unindent as _;
1120
1121        cx.foreground().set_block_on_ticks(usize::MAX..=usize::MAX);
1122
1123        let text = r#"
1124            fn outer() {}
1125
1126            mod module {
1127                fn inner() {}
1128            }"#
1129        .unindent();
1130
1131        let theme = SyntaxTheme::new(vec![
1132            ("mod.body".to_string(), Color::red().into()),
1133            ("fn.name".to_string(), Color::blue().into()),
1134        ]);
1135        let language = Arc::new(
1136            Language::new(
1137                LanguageConfig {
1138                    name: "Test".into(),
1139                    path_suffixes: vec![".test".to_string()],
1140                    ..Default::default()
1141                },
1142                Some(tree_sitter_rust::language()),
1143            )
1144            .with_highlights_query(
1145                r#"
1146                (mod_item name: (identifier) body: _ @mod.body)
1147                (function_item name: (identifier) @fn.name)
1148                "#,
1149            )
1150            .unwrap(),
1151        );
1152        language.set_theme(&theme);
1153
1154        cx.update(|cx| cx.set_global(Settings::test(cx)));
1155
1156        let buffer = cx.add_model(|cx| Buffer::new(0, text, cx).with_language(language, cx));
1157        buffer.condition(cx, |buf, _| !buf.is_parsing()).await;
1158        let buffer = cx.add_model(|cx| MultiBuffer::singleton(buffer, cx));
1159
1160        let font_cache = cx.font_cache();
1161
1162        let family_id = font_cache.load_family(&["Courier"]).unwrap();
1163        let font_id = font_cache
1164            .select_font(family_id, &Default::default())
1165            .unwrap();
1166        let font_size = 16.0;
1167
1168        let map =
1169            cx.add_model(|cx| DisplayMap::new(buffer, font_id, font_size, Some(40.0), 1, 1, cx));
1170        assert_eq!(
1171            cx.update(|cx| syntax_chunks(0..5, &map, &theme, cx)),
1172            [
1173                ("fn \n".to_string(), None),
1174                ("oute\nr".to_string(), Some(Color::blue())),
1175                ("() \n{}\n\n".to_string(), None),
1176            ]
1177        );
1178        assert_eq!(
1179            cx.update(|cx| syntax_chunks(3..5, &map, &theme, cx)),
1180            [("{}\n\n".to_string(), None)]
1181        );
1182
1183        map.update(cx, |map, cx| {
1184            map.fold(vec![Point::new(0, 6)..Point::new(3, 2)], cx)
1185        });
1186        assert_eq!(
1187            cx.update(|cx| syntax_chunks(1..4, &map, &theme, cx)),
1188            [
1189                ("out".to_string(), Some(Color::blue())),
1190                ("…\n".to_string(), None),
1191                ("  \nfn ".to_string(), Some(Color::red())),
1192                ("i\n".to_string(), Some(Color::blue()))
1193            ]
1194        );
1195    }
1196
1197    #[gpui::test]
1198    async fn test_chunks_with_text_highlights(cx: &mut gpui::TestAppContext) {
1199        cx.foreground().set_block_on_ticks(usize::MAX..=usize::MAX);
1200
1201        cx.update(|cx| cx.set_global(Settings::test(cx)));
1202        let theme = SyntaxTheme::new(vec![
1203            ("operator".to_string(), Color::red().into()),
1204            ("string".to_string(), Color::green().into()),
1205        ]);
1206        let language = Arc::new(
1207            Language::new(
1208                LanguageConfig {
1209                    name: "Test".into(),
1210                    path_suffixes: vec![".test".to_string()],
1211                    ..Default::default()
1212                },
1213                Some(tree_sitter_rust::language()),
1214            )
1215            .with_highlights_query(
1216                r#"
1217                ":" @operator
1218                (string_literal) @string
1219                "#,
1220            )
1221            .unwrap(),
1222        );
1223        language.set_theme(&theme);
1224
1225        let (text, highlighted_ranges) = marked_text_ranges(r#"constˇ Ā«aĀ»: B = "c Ā«dĀ»""#, false);
1226
1227        let buffer = cx.add_model(|cx| Buffer::new(0, text, cx).with_language(language, cx));
1228        buffer.condition(cx, |buf, _| !buf.is_parsing()).await;
1229
1230        let buffer = cx.add_model(|cx| MultiBuffer::singleton(buffer, cx));
1231        let buffer_snapshot = buffer.read_with(cx, |buffer, cx| buffer.snapshot(cx));
1232
1233        let font_cache = cx.font_cache();
1234        let family_id = font_cache.load_family(&["Courier"]).unwrap();
1235        let font_id = font_cache
1236            .select_font(family_id, &Default::default())
1237            .unwrap();
1238        let font_size = 16.0;
1239        let map = cx.add_model(|cx| DisplayMap::new(buffer, font_id, font_size, None, 1, 1, cx));
1240
1241        enum MyType {}
1242
1243        let style = HighlightStyle {
1244            color: Some(Color::blue()),
1245            ..Default::default()
1246        };
1247
1248        map.update(cx, |map, _cx| {
1249            map.highlight_text(
1250                TypeId::of::<MyType>(),
1251                highlighted_ranges
1252                    .into_iter()
1253                    .map(|range| {
1254                        buffer_snapshot.anchor_before(range.start)
1255                            ..buffer_snapshot.anchor_before(range.end)
1256                    })
1257                    .collect(),
1258                style,
1259            );
1260        });
1261
1262        assert_eq!(
1263            cx.update(|cx| chunks(0..10, &map, &theme, cx)),
1264            [
1265                ("const ".to_string(), None, None),
1266                ("a".to_string(), None, Some(Color::blue())),
1267                (":".to_string(), Some(Color::red()), None),
1268                (" B = ".to_string(), None, None),
1269                ("\"c ".to_string(), Some(Color::green()), None),
1270                ("d".to_string(), Some(Color::green()), Some(Color::blue())),
1271                ("\"".to_string(), Some(Color::green()), None),
1272            ]
1273        );
1274    }
1275
1276    #[gpui::test]
1277    fn test_clip_point(cx: &mut gpui::MutableAppContext) {
1278        cx.set_global(Settings::test(cx));
1279        fn assert(text: &str, shift_right: bool, bias: Bias, cx: &mut gpui::MutableAppContext) {
1280            let (unmarked_snapshot, mut markers) = marked_display_snapshot(text, cx);
1281
1282            match bias {
1283                Bias::Left => {
1284                    if shift_right {
1285                        *markers[1].column_mut() += 1;
1286                    }
1287
1288                    assert_eq!(unmarked_snapshot.clip_point(markers[1], bias), markers[0])
1289                }
1290                Bias::Right => {
1291                    if shift_right {
1292                        *markers[0].column_mut() += 1;
1293                    }
1294
1295                    assert_eq!(unmarked_snapshot.clip_point(markers[0], bias), markers[1])
1296                }
1297            };
1298        }
1299
1300        use Bias::{Left, Right};
1301        assert("ˇˇα", false, Left, cx);
1302        assert("ˇˇα", true, Left, cx);
1303        assert("ˇˇα", false, Right, cx);
1304        assert("ˇαˇ", true, Right, cx);
1305        assert("Ė‡Ė‡āœ‹", false, Left, cx);
1306        assert("Ė‡Ė‡āœ‹", true, Left, cx);
1307        assert("Ė‡Ė‡āœ‹", false, Right, cx);
1308        assert("Ė‡āœ‹Ė‡", true, Right, cx);
1309        assert("Ė‡Ė‡šŸ", false, Left, cx);
1310        assert("Ė‡Ė‡šŸ", true, Left, cx);
1311        assert("Ė‡Ė‡šŸ", false, Right, cx);
1312        assert("Ė‡šŸĖ‡", true, Right, cx);
1313        assert("ˇˇ\t", false, Left, cx);
1314        assert("ˇˇ\t", true, Left, cx);
1315        assert("ˇˇ\t", false, Right, cx);
1316        assert("ˇ\tˇ", true, Right, cx);
1317        assert(" ˇˇ\t", false, Left, cx);
1318        assert(" ˇˇ\t", true, Left, cx);
1319        assert(" ˇˇ\t", false, Right, cx);
1320        assert(" ˇ\tˇ", true, Right, cx);
1321        assert("   ˇˇ\t", false, Left, cx);
1322        assert("   ˇˇ\t", false, Right, cx);
1323    }
1324
1325    #[gpui::test]
1326    fn test_clip_at_line_ends(cx: &mut gpui::MutableAppContext) {
1327        cx.set_global(Settings::test(cx));
1328
1329        fn assert(text: &str, cx: &mut gpui::MutableAppContext) {
1330            let (mut unmarked_snapshot, markers) = marked_display_snapshot(text, cx);
1331            unmarked_snapshot.clip_at_line_ends = true;
1332            assert_eq!(
1333                unmarked_snapshot.clip_point(markers[1], Bias::Left),
1334                markers[0]
1335            );
1336        }
1337
1338        assert("ˇˇ", cx);
1339        assert("ˇaˇ", cx);
1340        assert("aˇbˇ", cx);
1341        assert("aˇαˇ", cx);
1342    }
1343
1344    #[gpui::test]
1345    fn test_tabs_with_multibyte_chars(cx: &mut gpui::MutableAppContext) {
1346        cx.set_global(Settings::test(cx));
1347        let text = "āœ…\t\tα\nβ\t\nšŸ€Ī²\t\tγ";
1348        let buffer = MultiBuffer::build_simple(text, cx);
1349        let font_cache = cx.font_cache();
1350        let family_id = font_cache.load_family(&["Helvetica"]).unwrap();
1351        let font_id = font_cache
1352            .select_font(family_id, &Default::default())
1353            .unwrap();
1354        let font_size = 14.0;
1355
1356        let map =
1357            cx.add_model(|cx| DisplayMap::new(buffer.clone(), font_id, font_size, None, 1, 1, cx));
1358        let map = map.update(cx, |map, cx| map.snapshot(cx));
1359        assert_eq!(map.text(), "āœ…       α\nβ   \nšŸ€Ī²      γ");
1360        assert_eq!(
1361            map.text_chunks(0).collect::<String>(),
1362            "āœ…       α\nβ   \nšŸ€Ī²      γ"
1363        );
1364        assert_eq!(map.text_chunks(1).collect::<String>(), "β   \nšŸ€Ī²      γ");
1365        assert_eq!(map.text_chunks(2).collect::<String>(), "šŸ€Ī²      γ");
1366
1367        let point = Point::new(0, "āœ…\t\t".len() as u32);
1368        let display_point = DisplayPoint::new(0, "āœ…       ".len() as u32);
1369        assert_eq!(point.to_display_point(&map), display_point);
1370        assert_eq!(display_point.to_point(&map), point);
1371
1372        let point = Point::new(1, "β\t".len() as u32);
1373        let display_point = DisplayPoint::new(1, "β   ".len() as u32);
1374        assert_eq!(point.to_display_point(&map), display_point);
1375        assert_eq!(display_point.to_point(&map), point,);
1376
1377        let point = Point::new(2, "šŸ€Ī²\t\t".len() as u32);
1378        let display_point = DisplayPoint::new(2, "šŸ€Ī²      ".len() as u32);
1379        assert_eq!(point.to_display_point(&map), display_point);
1380        assert_eq!(display_point.to_point(&map), point,);
1381
1382        // Display points inside of expanded tabs
1383        assert_eq!(
1384            DisplayPoint::new(0, "āœ…      ".len() as u32).to_point(&map),
1385            Point::new(0, "āœ…\t".len() as u32),
1386        );
1387        assert_eq!(
1388            DisplayPoint::new(0, "āœ… ".len() as u32).to_point(&map),
1389            Point::new(0, "āœ…".len() as u32),
1390        );
1391
1392        // Clipping display points inside of multi-byte characters
1393        assert_eq!(
1394            map.clip_point(DisplayPoint::new(0, "āœ…".len() as u32 - 1), Left),
1395            DisplayPoint::new(0, 0)
1396        );
1397        assert_eq!(
1398            map.clip_point(DisplayPoint::new(0, "āœ…".len() as u32 - 1), Bias::Right),
1399            DisplayPoint::new(0, "āœ…".len() as u32)
1400        );
1401    }
1402
1403    #[gpui::test]
1404    fn test_max_point(cx: &mut gpui::MutableAppContext) {
1405        cx.set_global(Settings::test(cx));
1406        let buffer = MultiBuffer::build_simple("aaa\n\t\tbbb", cx);
1407        let font_cache = cx.font_cache();
1408        let family_id = font_cache.load_family(&["Helvetica"]).unwrap();
1409        let font_id = font_cache
1410            .select_font(family_id, &Default::default())
1411            .unwrap();
1412        let font_size = 14.0;
1413        let map =
1414            cx.add_model(|cx| DisplayMap::new(buffer.clone(), font_id, font_size, None, 1, 1, cx));
1415        assert_eq!(
1416            map.update(cx, |map, cx| map.snapshot(cx)).max_point(),
1417            DisplayPoint::new(1, 11)
1418        )
1419    }
1420
1421    fn syntax_chunks<'a>(
1422        rows: Range<u32>,
1423        map: &ModelHandle<DisplayMap>,
1424        theme: &'a SyntaxTheme,
1425        cx: &mut MutableAppContext,
1426    ) -> Vec<(String, Option<Color>)> {
1427        chunks(rows, map, theme, cx)
1428            .into_iter()
1429            .map(|(text, color, _)| (text, color))
1430            .collect()
1431    }
1432
1433    fn chunks<'a>(
1434        rows: Range<u32>,
1435        map: &ModelHandle<DisplayMap>,
1436        theme: &'a SyntaxTheme,
1437        cx: &mut MutableAppContext,
1438    ) -> Vec<(String, Option<Color>, Option<Color>)> {
1439        let snapshot = map.update(cx, |map, cx| map.snapshot(cx));
1440        let mut chunks: Vec<(String, Option<Color>, Option<Color>)> = Vec::new();
1441        for chunk in snapshot.chunks(rows, true) {
1442            let syntax_color = chunk
1443                .syntax_highlight_id
1444                .and_then(|id| id.style(theme)?.color);
1445            let highlight_color = chunk.highlight_style.and_then(|style| style.color);
1446            if let Some((last_chunk, last_syntax_color, last_highlight_color)) = chunks.last_mut() {
1447                if syntax_color == *last_syntax_color && highlight_color == *last_highlight_color {
1448                    last_chunk.push_str(chunk.text);
1449                    continue;
1450                }
1451            }
1452            chunks.push((chunk.text.to_string(), syntax_color, highlight_color));
1453        }
1454        chunks
1455    }
1456}