items.rs

   1use crate::{
   2    editor_settings::SeedQuerySetting, persistence::DB, scroll::ScrollAnchor, Anchor, Autoscroll,
   3    Editor, EditorEvent, EditorSettings, ExcerptId, ExcerptRange, MultiBuffer, MultiBufferSnapshot,
   4    NavigationData, ToPoint as _,
   5};
   6use anyhow::{anyhow, Context as _, Result};
   7use collections::HashSet;
   8use futures::future::try_join_all;
   9use gpui::{
  10    point, AnyElement, AppContext, AsyncWindowContext, Context, Entity, EntityId, EventEmitter,
  11    IntoElement, Model, ParentElement, Pixels, SharedString, Styled, Task, View, ViewContext,
  12    VisualContext, WeakView, WindowContext,
  13};
  14use language::{
  15    proto::serialize_anchor as serialize_text_anchor, Bias, Buffer, CharKind, OffsetRangeExt,
  16    Point, SelectionGoal,
  17};
  18use project::repository::GitFileStatus;
  19use project::{search::SearchQuery, FormatTrigger, Item as _, Project, ProjectPath};
  20use rpc::proto::{self, update_view, PeerId};
  21use settings::Settings;
  22use workspace::item::{ItemSettings, TabContentParams};
  23
  24use std::{
  25    borrow::Cow,
  26    cmp::{self, Ordering},
  27    iter,
  28    ops::Range,
  29    path::{Path, PathBuf},
  30    sync::Arc,
  31};
  32use text::{BufferId, Selection};
  33use theme::Theme;
  34use ui::{h_flex, prelude::*, Label};
  35use util::{paths::PathExt, ResultExt, TryFutureExt};
  36use workspace::item::{BreadcrumbText, FollowEvent, FollowableItemHandle};
  37use workspace::{
  38    item::{FollowableItem, Item, ItemEvent, ItemHandle, ProjectItem},
  39    searchable::{Direction, SearchEvent, SearchableItem, SearchableItemHandle},
  40    ItemId, ItemNavHistory, Pane, ToolbarItemLocation, ViewId, Workspace, WorkspaceId,
  41};
  42
  43pub const MAX_TAB_TITLE_LEN: usize = 24;
  44
  45impl FollowableItem for Editor {
  46    fn remote_id(&self) -> Option<ViewId> {
  47        self.remote_id
  48    }
  49
  50    fn from_state_proto(
  51        pane: View<workspace::Pane>,
  52        workspace: View<Workspace>,
  53        remote_id: ViewId,
  54        state: &mut Option<proto::view::Variant>,
  55        cx: &mut WindowContext,
  56    ) -> Option<Task<Result<View<Self>>>> {
  57        let project = workspace.read(cx).project().to_owned();
  58        let Some(proto::view::Variant::Editor(_)) = state else {
  59            return None;
  60        };
  61        let Some(proto::view::Variant::Editor(state)) = state.take() else {
  62            unreachable!()
  63        };
  64
  65        let client = project.read(cx).client();
  66        let replica_id = project.read(cx).replica_id();
  67        let buffer_ids = state
  68            .excerpts
  69            .iter()
  70            .map(|excerpt| excerpt.buffer_id)
  71            .collect::<HashSet<_>>();
  72        let buffers = project.update(cx, |project, cx| {
  73            buffer_ids
  74                .iter()
  75                .map(|id| BufferId::new(*id).map(|id| project.open_buffer_by_id(id, cx)))
  76                .collect::<Result<Vec<_>>>()
  77        });
  78
  79        let pane = pane.downgrade();
  80        Some(cx.spawn(|mut cx| async move {
  81            let mut buffers = futures::future::try_join_all(buffers?)
  82                .await
  83                .debug_assert_ok("leaders don't share views for unshared buffers")?;
  84            let editor = pane.update(&mut cx, |pane, cx| {
  85                let mut editors = pane.items_of_type::<Self>();
  86                editors.find(|editor| {
  87                    let ids_match = editor.remote_id(&client, cx) == Some(remote_id);
  88                    let singleton_buffer_matches = state.singleton
  89                        && buffers.first()
  90                            == editor.read(cx).buffer.read(cx).as_singleton().as_ref();
  91                    ids_match || singleton_buffer_matches
  92                })
  93            })?;
  94
  95            let editor = if let Some(editor) = editor {
  96                editor
  97            } else {
  98                pane.update(&mut cx, |_, cx| {
  99                    let multibuffer = cx.new_model(|cx| {
 100                        let mut multibuffer;
 101                        if state.singleton && buffers.len() == 1 {
 102                            multibuffer = MultiBuffer::singleton(buffers.pop().unwrap(), cx)
 103                        } else {
 104                            multibuffer =
 105                                MultiBuffer::new(replica_id, project.read(cx).capability());
 106                            let mut excerpts = state.excerpts.into_iter().peekable();
 107                            while let Some(excerpt) = excerpts.peek() {
 108                                let Ok(buffer_id) = BufferId::new(excerpt.buffer_id) else {
 109                                    continue;
 110                                };
 111                                let buffer_excerpts = iter::from_fn(|| {
 112                                    let excerpt = excerpts.peek()?;
 113                                    (excerpt.buffer_id == u64::from(buffer_id))
 114                                        .then(|| excerpts.next().unwrap())
 115                                });
 116                                let buffer =
 117                                    buffers.iter().find(|b| b.read(cx).remote_id() == buffer_id);
 118                                if let Some(buffer) = buffer {
 119                                    multibuffer.push_excerpts(
 120                                        buffer.clone(),
 121                                        buffer_excerpts.filter_map(deserialize_excerpt_range),
 122                                        cx,
 123                                    );
 124                                }
 125                            }
 126                        };
 127
 128                        if let Some(title) = &state.title {
 129                            multibuffer = multibuffer.with_title(title.clone())
 130                        }
 131
 132                        multibuffer
 133                    });
 134
 135                    cx.new_view(|cx| {
 136                        let mut editor =
 137                            Editor::for_multibuffer(multibuffer, Some(project.clone()), cx);
 138                        editor.remote_id = Some(remote_id);
 139                        editor
 140                    })
 141                })?
 142            };
 143
 144            update_editor_from_message(
 145                editor.downgrade(),
 146                project,
 147                proto::update_view::Editor {
 148                    selections: state.selections,
 149                    pending_selection: state.pending_selection,
 150                    scroll_top_anchor: state.scroll_top_anchor,
 151                    scroll_x: state.scroll_x,
 152                    scroll_y: state.scroll_y,
 153                    ..Default::default()
 154                },
 155                &mut cx,
 156            )
 157            .await?;
 158
 159            Ok(editor)
 160        }))
 161    }
 162
 163    fn set_leader_peer_id(&mut self, leader_peer_id: Option<PeerId>, cx: &mut ViewContext<Self>) {
 164        self.leader_peer_id = leader_peer_id;
 165        if self.leader_peer_id.is_some() {
 166            self.buffer.update(cx, |buffer, cx| {
 167                buffer.remove_active_selections(cx);
 168            });
 169        } else if self.focus_handle.is_focused(cx) {
 170            self.buffer.update(cx, |buffer, cx| {
 171                buffer.set_active_selections(
 172                    &self.selections.disjoint_anchors(),
 173                    self.selections.line_mode,
 174                    self.cursor_shape,
 175                    cx,
 176                );
 177            });
 178        }
 179        cx.notify();
 180    }
 181
 182    fn to_state_proto(&self, cx: &WindowContext) -> Option<proto::view::Variant> {
 183        let buffer = self.buffer.read(cx);
 184        if buffer
 185            .as_singleton()
 186            .and_then(|buffer| buffer.read(cx).file())
 187            .map_or(false, |file| file.is_private())
 188        {
 189            return None;
 190        }
 191
 192        let scroll_anchor = self.scroll_manager.anchor();
 193        let excerpts = buffer
 194            .read(cx)
 195            .excerpts()
 196            .map(|(id, buffer, range)| proto::Excerpt {
 197                id: id.to_proto(),
 198                buffer_id: buffer.remote_id().into(),
 199                context_start: Some(serialize_text_anchor(&range.context.start)),
 200                context_end: Some(serialize_text_anchor(&range.context.end)),
 201                primary_start: range
 202                    .primary
 203                    .as_ref()
 204                    .map(|range| serialize_text_anchor(&range.start)),
 205                primary_end: range
 206                    .primary
 207                    .as_ref()
 208                    .map(|range| serialize_text_anchor(&range.end)),
 209            })
 210            .collect();
 211
 212        Some(proto::view::Variant::Editor(proto::view::Editor {
 213            singleton: buffer.is_singleton(),
 214            title: (!buffer.is_singleton()).then(|| buffer.title(cx).into()),
 215            excerpts,
 216            scroll_top_anchor: Some(serialize_anchor(&scroll_anchor.anchor)),
 217            scroll_x: scroll_anchor.offset.x,
 218            scroll_y: scroll_anchor.offset.y,
 219            selections: self
 220                .selections
 221                .disjoint_anchors()
 222                .iter()
 223                .map(serialize_selection)
 224                .collect(),
 225            pending_selection: self
 226                .selections
 227                .pending_anchor()
 228                .as_ref()
 229                .map(serialize_selection),
 230        }))
 231    }
 232
 233    fn to_follow_event(event: &EditorEvent) -> Option<workspace::item::FollowEvent> {
 234        match event {
 235            EditorEvent::Edited => Some(FollowEvent::Unfollow),
 236            EditorEvent::SelectionsChanged { local }
 237            | EditorEvent::ScrollPositionChanged { local, .. } => {
 238                if *local {
 239                    Some(FollowEvent::Unfollow)
 240                } else {
 241                    None
 242                }
 243            }
 244            _ => None,
 245        }
 246    }
 247
 248    fn add_event_to_update_proto(
 249        &self,
 250        event: &EditorEvent,
 251        update: &mut Option<proto::update_view::Variant>,
 252        cx: &WindowContext,
 253    ) -> bool {
 254        let update =
 255            update.get_or_insert_with(|| proto::update_view::Variant::Editor(Default::default()));
 256
 257        match update {
 258            proto::update_view::Variant::Editor(update) => match event {
 259                EditorEvent::ExcerptsAdded {
 260                    buffer,
 261                    predecessor,
 262                    excerpts,
 263                } => {
 264                    let buffer_id = buffer.read(cx).remote_id();
 265                    let mut excerpts = excerpts.iter();
 266                    if let Some((id, range)) = excerpts.next() {
 267                        update.inserted_excerpts.push(proto::ExcerptInsertion {
 268                            previous_excerpt_id: Some(predecessor.to_proto()),
 269                            excerpt: serialize_excerpt(buffer_id, id, range),
 270                        });
 271                        update.inserted_excerpts.extend(excerpts.map(|(id, range)| {
 272                            proto::ExcerptInsertion {
 273                                previous_excerpt_id: None,
 274                                excerpt: serialize_excerpt(buffer_id, id, range),
 275                            }
 276                        }))
 277                    }
 278                    true
 279                }
 280                EditorEvent::ExcerptsRemoved { ids } => {
 281                    update
 282                        .deleted_excerpts
 283                        .extend(ids.iter().map(ExcerptId::to_proto));
 284                    true
 285                }
 286                EditorEvent::ScrollPositionChanged { autoscroll, .. } if !autoscroll => {
 287                    let scroll_anchor = self.scroll_manager.anchor();
 288                    update.scroll_top_anchor = Some(serialize_anchor(&scroll_anchor.anchor));
 289                    update.scroll_x = scroll_anchor.offset.x;
 290                    update.scroll_y = scroll_anchor.offset.y;
 291                    true
 292                }
 293                EditorEvent::SelectionsChanged { .. } => {
 294                    update.selections = self
 295                        .selections
 296                        .disjoint_anchors()
 297                        .iter()
 298                        .map(serialize_selection)
 299                        .collect();
 300                    update.pending_selection = self
 301                        .selections
 302                        .pending_anchor()
 303                        .as_ref()
 304                        .map(serialize_selection);
 305                    true
 306                }
 307                _ => false,
 308            },
 309        }
 310    }
 311
 312    fn apply_update_proto(
 313        &mut self,
 314        project: &Model<Project>,
 315        message: update_view::Variant,
 316        cx: &mut ViewContext<Self>,
 317    ) -> Task<Result<()>> {
 318        let update_view::Variant::Editor(message) = message;
 319        let project = project.clone();
 320        cx.spawn(|this, mut cx| async move {
 321            update_editor_from_message(this, project, message, &mut cx).await
 322        })
 323    }
 324
 325    fn is_project_item(&self, _cx: &WindowContext) -> bool {
 326        true
 327    }
 328}
 329
 330async fn update_editor_from_message(
 331    this: WeakView<Editor>,
 332    project: Model<Project>,
 333    message: proto::update_view::Editor,
 334    cx: &mut AsyncWindowContext,
 335) -> Result<()> {
 336    // Open all of the buffers of which excerpts were added to the editor.
 337    let inserted_excerpt_buffer_ids = message
 338        .inserted_excerpts
 339        .iter()
 340        .filter_map(|insertion| Some(insertion.excerpt.as_ref()?.buffer_id))
 341        .collect::<HashSet<_>>();
 342    let inserted_excerpt_buffers = project.update(cx, |project, cx| {
 343        inserted_excerpt_buffer_ids
 344            .into_iter()
 345            .map(|id| BufferId::new(id).map(|id| project.open_buffer_by_id(id, cx)))
 346            .collect::<Result<Vec<_>>>()
 347    })??;
 348    let _inserted_excerpt_buffers = try_join_all(inserted_excerpt_buffers).await?;
 349
 350    // Update the editor's excerpts.
 351    this.update(cx, |editor, cx| {
 352        editor.buffer.update(cx, |multibuffer, cx| {
 353            let mut removed_excerpt_ids = message
 354                .deleted_excerpts
 355                .into_iter()
 356                .map(ExcerptId::from_proto)
 357                .collect::<Vec<_>>();
 358            removed_excerpt_ids.sort_by({
 359                let multibuffer = multibuffer.read(cx);
 360                move |a, b| a.cmp(&b, &multibuffer)
 361            });
 362
 363            let mut insertions = message.inserted_excerpts.into_iter().peekable();
 364            while let Some(insertion) = insertions.next() {
 365                let Some(excerpt) = insertion.excerpt else {
 366                    continue;
 367                };
 368                let Some(previous_excerpt_id) = insertion.previous_excerpt_id else {
 369                    continue;
 370                };
 371                let buffer_id = BufferId::new(excerpt.buffer_id)?;
 372                let Some(buffer) = project.read(cx).buffer_for_id(buffer_id) else {
 373                    continue;
 374                };
 375
 376                let adjacent_excerpts = iter::from_fn(|| {
 377                    let insertion = insertions.peek()?;
 378                    if insertion.previous_excerpt_id.is_none()
 379                        && insertion.excerpt.as_ref()?.buffer_id == u64::from(buffer_id)
 380                    {
 381                        insertions.next()?.excerpt
 382                    } else {
 383                        None
 384                    }
 385                });
 386
 387                multibuffer.insert_excerpts_with_ids_after(
 388                    ExcerptId::from_proto(previous_excerpt_id),
 389                    buffer,
 390                    [excerpt]
 391                        .into_iter()
 392                        .chain(adjacent_excerpts)
 393                        .filter_map(|excerpt| {
 394                            Some((
 395                                ExcerptId::from_proto(excerpt.id),
 396                                deserialize_excerpt_range(excerpt)?,
 397                            ))
 398                        }),
 399                    cx,
 400                );
 401            }
 402
 403            multibuffer.remove_excerpts(removed_excerpt_ids, cx);
 404            Result::<(), anyhow::Error>::Ok(())
 405        })
 406    })??;
 407
 408    // Deserialize the editor state.
 409    let (selections, pending_selection, scroll_top_anchor) = this.update(cx, |editor, cx| {
 410        let buffer = editor.buffer.read(cx).read(cx);
 411        let selections = message
 412            .selections
 413            .into_iter()
 414            .filter_map(|selection| deserialize_selection(&buffer, selection))
 415            .collect::<Vec<_>>();
 416        let pending_selection = message
 417            .pending_selection
 418            .and_then(|selection| deserialize_selection(&buffer, selection));
 419        let scroll_top_anchor = message
 420            .scroll_top_anchor
 421            .and_then(|anchor| deserialize_anchor(&buffer, anchor));
 422        anyhow::Ok((selections, pending_selection, scroll_top_anchor))
 423    })??;
 424
 425    // Wait until the buffer has received all of the operations referenced by
 426    // the editor's new state.
 427    this.update(cx, |editor, cx| {
 428        editor.buffer.update(cx, |buffer, cx| {
 429            buffer.wait_for_anchors(
 430                selections
 431                    .iter()
 432                    .chain(pending_selection.as_ref())
 433                    .flat_map(|selection| [selection.start, selection.end])
 434                    .chain(scroll_top_anchor),
 435                cx,
 436            )
 437        })
 438    })?
 439    .await?;
 440
 441    // Update the editor's state.
 442    this.update(cx, |editor, cx| {
 443        if !selections.is_empty() || pending_selection.is_some() {
 444            editor.set_selections_from_remote(selections, pending_selection, cx);
 445            editor.request_autoscroll_remotely(Autoscroll::newest(), cx);
 446        } else if let Some(scroll_top_anchor) = scroll_top_anchor {
 447            editor.set_scroll_anchor_remote(
 448                ScrollAnchor {
 449                    anchor: scroll_top_anchor,
 450                    offset: point(message.scroll_x, message.scroll_y),
 451                },
 452                cx,
 453            );
 454        }
 455    })?;
 456    Ok(())
 457}
 458
 459fn serialize_excerpt(
 460    buffer_id: BufferId,
 461    id: &ExcerptId,
 462    range: &ExcerptRange<language::Anchor>,
 463) -> Option<proto::Excerpt> {
 464    Some(proto::Excerpt {
 465        id: id.to_proto(),
 466        buffer_id: buffer_id.into(),
 467        context_start: Some(serialize_text_anchor(&range.context.start)),
 468        context_end: Some(serialize_text_anchor(&range.context.end)),
 469        primary_start: range
 470            .primary
 471            .as_ref()
 472            .map(|r| serialize_text_anchor(&r.start)),
 473        primary_end: range
 474            .primary
 475            .as_ref()
 476            .map(|r| serialize_text_anchor(&r.end)),
 477    })
 478}
 479
 480fn serialize_selection(selection: &Selection<Anchor>) -> proto::Selection {
 481    proto::Selection {
 482        id: selection.id as u64,
 483        start: Some(serialize_anchor(&selection.start)),
 484        end: Some(serialize_anchor(&selection.end)),
 485        reversed: selection.reversed,
 486    }
 487}
 488
 489fn serialize_anchor(anchor: &Anchor) -> proto::EditorAnchor {
 490    proto::EditorAnchor {
 491        excerpt_id: anchor.excerpt_id.to_proto(),
 492        anchor: Some(serialize_text_anchor(&anchor.text_anchor)),
 493    }
 494}
 495
 496fn deserialize_excerpt_range(excerpt: proto::Excerpt) -> Option<ExcerptRange<language::Anchor>> {
 497    let context = {
 498        let start = language::proto::deserialize_anchor(excerpt.context_start?)?;
 499        let end = language::proto::deserialize_anchor(excerpt.context_end?)?;
 500        start..end
 501    };
 502    let primary = excerpt
 503        .primary_start
 504        .zip(excerpt.primary_end)
 505        .and_then(|(start, end)| {
 506            let start = language::proto::deserialize_anchor(start)?;
 507            let end = language::proto::deserialize_anchor(end)?;
 508            Some(start..end)
 509        });
 510    Some(ExcerptRange { context, primary })
 511}
 512
 513fn deserialize_selection(
 514    buffer: &MultiBufferSnapshot,
 515    selection: proto::Selection,
 516) -> Option<Selection<Anchor>> {
 517    Some(Selection {
 518        id: selection.id as usize,
 519        start: deserialize_anchor(buffer, selection.start?)?,
 520        end: deserialize_anchor(buffer, selection.end?)?,
 521        reversed: selection.reversed,
 522        goal: SelectionGoal::None,
 523    })
 524}
 525
 526fn deserialize_anchor(buffer: &MultiBufferSnapshot, anchor: proto::EditorAnchor) -> Option<Anchor> {
 527    let excerpt_id = ExcerptId::from_proto(anchor.excerpt_id);
 528    Some(Anchor {
 529        excerpt_id,
 530        text_anchor: language::proto::deserialize_anchor(anchor.anchor?)?,
 531        buffer_id: buffer.buffer_id_for_excerpt(excerpt_id),
 532    })
 533}
 534
 535impl Item for Editor {
 536    type Event = EditorEvent;
 537
 538    fn navigate(&mut self, data: Box<dyn std::any::Any>, cx: &mut ViewContext<Self>) -> bool {
 539        if let Ok(data) = data.downcast::<NavigationData>() {
 540            let newest_selection = self.selections.newest::<Point>(cx);
 541            let buffer = self.buffer.read(cx).read(cx);
 542            let offset = if buffer.can_resolve(&data.cursor_anchor) {
 543                data.cursor_anchor.to_point(&buffer)
 544            } else {
 545                buffer.clip_point(data.cursor_position, Bias::Left)
 546            };
 547
 548            let mut scroll_anchor = data.scroll_anchor;
 549            if !buffer.can_resolve(&scroll_anchor.anchor) {
 550                scroll_anchor.anchor = buffer.anchor_before(
 551                    buffer.clip_point(Point::new(data.scroll_top_row, 0), Bias::Left),
 552                );
 553            }
 554
 555            drop(buffer);
 556
 557            if newest_selection.head() == offset {
 558                false
 559            } else {
 560                let nav_history = self.nav_history.take();
 561                self.set_scroll_anchor(scroll_anchor, cx);
 562                self.change_selections(Some(Autoscroll::fit()), cx, |s| {
 563                    s.select_ranges([offset..offset])
 564                });
 565                self.nav_history = nav_history;
 566                true
 567            }
 568        } else {
 569            false
 570        }
 571    }
 572
 573    fn tab_tooltip_text(&self, cx: &AppContext) -> Option<SharedString> {
 574        let file_path = self
 575            .buffer()
 576            .read(cx)
 577            .as_singleton()?
 578            .read(cx)
 579            .file()
 580            .and_then(|f| f.as_local())?
 581            .abs_path(cx);
 582
 583        let file_path = file_path.compact().to_string_lossy().to_string();
 584
 585        Some(file_path.into())
 586    }
 587
 588    fn telemetry_event_text(&self) -> Option<&'static str> {
 589        None
 590    }
 591
 592    fn tab_description(&self, detail: usize, cx: &AppContext) -> Option<SharedString> {
 593        let path = path_for_buffer(&self.buffer, detail, true, cx)?;
 594        Some(path.to_string_lossy().to_string().into())
 595    }
 596
 597    fn tab_content(&self, params: TabContentParams, cx: &WindowContext) -> AnyElement {
 598        let label_color = if ItemSettings::get_global(cx).git_status {
 599            self.buffer()
 600                .read(cx)
 601                .as_singleton()
 602                .and_then(|buffer| buffer.read(cx).project_path(cx))
 603                .and_then(|path| self.project.as_ref()?.read(cx).entry_for_path(&path, cx))
 604                .map(|entry| {
 605                    entry_git_aware_label_color(entry.git_status, entry.is_ignored, params.selected)
 606                })
 607                .unwrap_or_else(|| entry_label_color(params.selected))
 608        } else {
 609            entry_label_color(params.selected)
 610        };
 611
 612        let description = params.detail.and_then(|detail| {
 613            let path = path_for_buffer(&self.buffer, detail, false, cx)?;
 614            let description = path.to_string_lossy();
 615            let description = description.trim();
 616
 617            if description.is_empty() {
 618                return None;
 619            }
 620
 621            Some(util::truncate_and_trailoff(&description, MAX_TAB_TITLE_LEN))
 622        });
 623
 624        h_flex()
 625            .gap_2()
 626            .child(
 627                Label::new(self.title(cx).to_string())
 628                    .color(label_color)
 629                    .italic(params.preview),
 630            )
 631            .when_some(description, |this, description| {
 632                this.child(
 633                    Label::new(description)
 634                        .size(LabelSize::XSmall)
 635                        .color(Color::Muted),
 636                )
 637            })
 638            .into_any_element()
 639    }
 640
 641    fn for_each_project_item(
 642        &self,
 643        cx: &AppContext,
 644        f: &mut dyn FnMut(EntityId, &dyn project::Item),
 645    ) {
 646        self.buffer
 647            .read(cx)
 648            .for_each_buffer(|buffer| f(buffer.entity_id(), buffer.read(cx)));
 649    }
 650
 651    fn is_singleton(&self, cx: &AppContext) -> bool {
 652        self.buffer.read(cx).is_singleton()
 653    }
 654
 655    fn clone_on_split(
 656        &self,
 657        _workspace_id: WorkspaceId,
 658        cx: &mut ViewContext<Self>,
 659    ) -> Option<View<Editor>>
 660    where
 661        Self: Sized,
 662    {
 663        Some(cx.new_view(|cx| self.clone(cx)))
 664    }
 665
 666    fn set_nav_history(&mut self, history: ItemNavHistory, _: &mut ViewContext<Self>) {
 667        self.nav_history = Some(history);
 668    }
 669
 670    fn deactivated(&mut self, cx: &mut ViewContext<Self>) {
 671        let selection = self.selections.newest_anchor();
 672        self.push_to_nav_history(selection.head(), None, cx);
 673    }
 674
 675    fn workspace_deactivated(&mut self, cx: &mut ViewContext<Self>) {
 676        self.hide_hovered_link(cx);
 677    }
 678
 679    fn is_dirty(&self, cx: &AppContext) -> bool {
 680        self.buffer().read(cx).read(cx).is_dirty()
 681    }
 682
 683    fn has_conflict(&self, cx: &AppContext) -> bool {
 684        self.buffer().read(cx).read(cx).has_conflict()
 685    }
 686
 687    fn can_save(&self, cx: &AppContext) -> bool {
 688        let buffer = &self.buffer().read(cx);
 689        if let Some(buffer) = buffer.as_singleton() {
 690            buffer.read(cx).project_path(cx).is_some()
 691        } else {
 692            true
 693        }
 694    }
 695
 696    fn save(
 697        &mut self,
 698        format: bool,
 699        project: Model<Project>,
 700        cx: &mut ViewContext<Self>,
 701    ) -> Task<Result<()>> {
 702        self.report_editor_event("save", None, cx);
 703        let buffers = self.buffer().clone().read(cx).all_buffers();
 704        cx.spawn(|this, mut cx| async move {
 705            if format {
 706                this.update(&mut cx, |editor, cx| {
 707                    editor.perform_format(project.clone(), FormatTrigger::Save, cx)
 708                })?
 709                .await?;
 710            }
 711
 712            if buffers.len() == 1 {
 713                // Apply full save routine for singleton buffers, to allow to `touch` the file via the editor.
 714                project
 715                    .update(&mut cx, |project, cx| project.save_buffers(buffers, cx))?
 716                    .await?;
 717            } else {
 718                // For multi-buffers, only format and save the buffers with changes.
 719                // For clean buffers, we simulate saving by calling `Buffer::did_save`,
 720                // so that language servers or other downstream listeners of save events get notified.
 721                let (dirty_buffers, clean_buffers) = buffers.into_iter().partition(|buffer| {
 722                    buffer
 723                        .update(&mut cx, |buffer, _| {
 724                            buffer.is_dirty() || buffer.has_conflict()
 725                        })
 726                        .unwrap_or(false)
 727                });
 728
 729                project
 730                    .update(&mut cx, |project, cx| {
 731                        project.save_buffers(dirty_buffers, cx)
 732                    })?
 733                    .await?;
 734                for buffer in clean_buffers {
 735                    buffer
 736                        .update(&mut cx, |buffer, cx| {
 737                            let version = buffer.saved_version().clone();
 738                            let fingerprint = buffer.saved_version_fingerprint();
 739                            let mtime = buffer.saved_mtime();
 740                            buffer.did_save(version, fingerprint, mtime, cx);
 741                        })
 742                        .ok();
 743                }
 744            }
 745
 746            Ok(())
 747        })
 748    }
 749
 750    fn save_as(
 751        &mut self,
 752        project: Model<Project>,
 753        abs_path: PathBuf,
 754        cx: &mut ViewContext<Self>,
 755    ) -> Task<Result<()>> {
 756        let buffer = self
 757            .buffer()
 758            .read(cx)
 759            .as_singleton()
 760            .expect("cannot call save_as on an excerpt list");
 761
 762        let file_extension = abs_path
 763            .extension()
 764            .map(|a| a.to_string_lossy().to_string());
 765        self.report_editor_event("save", file_extension, cx);
 766
 767        project.update(cx, |project, cx| {
 768            project.save_buffer_as(buffer, abs_path, cx)
 769        })
 770    }
 771
 772    fn reload(&mut self, project: Model<Project>, cx: &mut ViewContext<Self>) -> Task<Result<()>> {
 773        let buffer = self.buffer().clone();
 774        let buffers = self.buffer.read(cx).all_buffers();
 775        let reload_buffers =
 776            project.update(cx, |project, cx| project.reload_buffers(buffers, true, cx));
 777        cx.spawn(|this, mut cx| async move {
 778            let transaction = reload_buffers.log_err().await;
 779            this.update(&mut cx, |editor, cx| {
 780                editor.request_autoscroll(Autoscroll::fit(), cx)
 781            })?;
 782            buffer
 783                .update(&mut cx, |buffer, cx| {
 784                    if let Some(transaction) = transaction {
 785                        if !buffer.is_singleton() {
 786                            buffer.push_transaction(&transaction.0, cx);
 787                        }
 788                    }
 789                })
 790                .ok();
 791            Ok(())
 792        })
 793    }
 794
 795    fn as_searchable(&self, handle: &View<Self>) -> Option<Box<dyn SearchableItemHandle>> {
 796        Some(Box::new(handle.clone()))
 797    }
 798
 799    fn pixel_position_of_cursor(&self, _: &AppContext) -> Option<gpui::Point<Pixels>> {
 800        self.pixel_position_of_newest_cursor
 801    }
 802
 803    fn breadcrumb_location(&self) -> ToolbarItemLocation {
 804        if self.show_breadcrumbs {
 805            ToolbarItemLocation::PrimaryLeft
 806        } else {
 807            ToolbarItemLocation::Hidden
 808        }
 809    }
 810
 811    fn breadcrumbs(&self, variant: &Theme, cx: &AppContext) -> Option<Vec<BreadcrumbText>> {
 812        let cursor = self.selections.newest_anchor().head();
 813        let multibuffer = &self.buffer().read(cx);
 814        let (buffer_id, symbols) =
 815            multibuffer.symbols_containing(cursor, Some(&variant.syntax()), cx)?;
 816        let buffer = multibuffer.buffer(buffer_id)?;
 817
 818        let buffer = buffer.read(cx);
 819        let filename = buffer
 820            .snapshot()
 821            .resolve_file_path(
 822                cx,
 823                self.project
 824                    .as_ref()
 825                    .map(|project| project.read(cx).visible_worktrees(cx).count() > 1)
 826                    .unwrap_or_default(),
 827            )
 828            .map(|path| path.to_string_lossy().to_string())
 829            .unwrap_or_else(|| "untitled".to_string());
 830
 831        let mut breadcrumbs = vec![BreadcrumbText {
 832            text: filename,
 833            highlights: None,
 834        }];
 835        breadcrumbs.extend(symbols.into_iter().map(|symbol| BreadcrumbText {
 836            text: symbol.text,
 837            highlights: Some(symbol.highlight_ranges),
 838        }));
 839        Some(breadcrumbs)
 840    }
 841
 842    fn added_to_workspace(&mut self, workspace: &mut Workspace, cx: &mut ViewContext<Self>) {
 843        let workspace_id = workspace.database_id();
 844        let item_id = cx.view().item_id().as_u64() as ItemId;
 845        self.workspace = Some((workspace.weak_handle(), workspace.database_id()));
 846
 847        fn serialize(
 848            buffer: Model<Buffer>,
 849            workspace_id: WorkspaceId,
 850            item_id: ItemId,
 851            cx: &mut AppContext,
 852        ) {
 853            if let Some(file) = buffer.read(cx).file().and_then(|file| file.as_local()) {
 854                let path = file.abs_path(cx);
 855
 856                cx.background_executor()
 857                    .spawn(async move {
 858                        DB.save_path(item_id, workspace_id, path.clone())
 859                            .await
 860                            .log_err()
 861                    })
 862                    .detach();
 863            }
 864        }
 865
 866        if let Some(buffer) = self.buffer().read(cx).as_singleton() {
 867            serialize(buffer.clone(), workspace_id, item_id, cx);
 868
 869            cx.subscribe(&buffer, |this, buffer, event, cx| {
 870                if let Some((_, workspace_id)) = this.workspace.as_ref() {
 871                    if let language::Event::FileHandleChanged = event {
 872                        serialize(
 873                            buffer,
 874                            *workspace_id,
 875                            cx.view().item_id().as_u64() as ItemId,
 876                            cx,
 877                        );
 878                    }
 879                }
 880            })
 881            .detach();
 882        }
 883    }
 884
 885    fn serialized_item_kind() -> Option<&'static str> {
 886        Some("Editor")
 887    }
 888
 889    fn to_item_events(event: &EditorEvent, mut f: impl FnMut(ItemEvent)) {
 890        match event {
 891            EditorEvent::Closed => f(ItemEvent::CloseItem),
 892
 893            EditorEvent::Saved | EditorEvent::TitleChanged => {
 894                f(ItemEvent::UpdateTab);
 895                f(ItemEvent::UpdateBreadcrumbs);
 896            }
 897
 898            EditorEvent::Reparsed => {
 899                f(ItemEvent::UpdateBreadcrumbs);
 900            }
 901
 902            EditorEvent::SelectionsChanged { local } if *local => {
 903                f(ItemEvent::UpdateBreadcrumbs);
 904            }
 905
 906            EditorEvent::DirtyChanged => {
 907                f(ItemEvent::UpdateTab);
 908            }
 909
 910            EditorEvent::BufferEdited => {
 911                f(ItemEvent::Edit);
 912                f(ItemEvent::UpdateBreadcrumbs);
 913            }
 914
 915            EditorEvent::ExcerptsAdded { .. } | EditorEvent::ExcerptsRemoved { .. } => {
 916                f(ItemEvent::Edit);
 917            }
 918
 919            _ => {}
 920        }
 921    }
 922
 923    fn deserialize(
 924        project: Model<Project>,
 925        _workspace: WeakView<Workspace>,
 926        workspace_id: workspace::WorkspaceId,
 927        item_id: ItemId,
 928        cx: &mut ViewContext<Pane>,
 929    ) -> Task<Result<View<Self>>> {
 930        let project_item: Result<_> = project.update(cx, |project, cx| {
 931            // Look up the path with this key associated, create a self with that path
 932            let path = DB
 933                .get_path(item_id, workspace_id)?
 934                .context("No path stored for this editor")?;
 935
 936            let (worktree, path) = project
 937                .find_local_worktree(&path, cx)
 938                .with_context(|| format!("No worktree for path: {path:?}"))?;
 939            let project_path = ProjectPath {
 940                worktree_id: worktree.read(cx).id(),
 941                path: path.into(),
 942            };
 943
 944            Ok(project.open_path(project_path, cx))
 945        });
 946
 947        project_item
 948            .map(|project_item| {
 949                cx.spawn(|pane, mut cx| async move {
 950                    let (_, project_item) = project_item.await?;
 951                    let buffer = project_item
 952                        .downcast::<Buffer>()
 953                        .map_err(|_| anyhow!("Project item at stored path was not a buffer"))?;
 954                    pane.update(&mut cx, |_, cx| {
 955                        cx.new_view(|cx| {
 956                            let mut editor = Editor::for_buffer(buffer, Some(project), cx);
 957
 958                            editor.read_scroll_position_from_db(item_id, workspace_id, cx);
 959                            editor
 960                        })
 961                    })
 962                })
 963            })
 964            .unwrap_or_else(|error| Task::ready(Err(error)))
 965    }
 966}
 967
 968impl ProjectItem for Editor {
 969    type Item = Buffer;
 970
 971    fn for_project_item(
 972        project: Model<Project>,
 973        buffer: Model<Buffer>,
 974        cx: &mut ViewContext<Self>,
 975    ) -> Self {
 976        Self::for_buffer(buffer, Some(project), cx)
 977    }
 978}
 979
 980impl EventEmitter<SearchEvent> for Editor {}
 981
 982pub(crate) enum BufferSearchHighlights {}
 983impl SearchableItem for Editor {
 984    type Match = Range<Anchor>;
 985
 986    fn clear_matches(&mut self, cx: &mut ViewContext<Self>) {
 987        self.clear_background_highlights::<BufferSearchHighlights>(cx);
 988    }
 989
 990    fn update_matches(&mut self, matches: &[Range<Anchor>], cx: &mut ViewContext<Self>) {
 991        self.highlight_background::<BufferSearchHighlights>(
 992            matches,
 993            |theme| theme.search_match_background,
 994            cx,
 995        );
 996    }
 997
 998    fn query_suggestion(&mut self, cx: &mut ViewContext<Self>) -> String {
 999        let setting = EditorSettings::get_global(cx).seed_search_query_from_cursor;
1000        let snapshot = &self.snapshot(cx).buffer_snapshot;
1001        let selection = self.selections.newest::<usize>(cx);
1002
1003        match setting {
1004            SeedQuerySetting::Never => String::new(),
1005            SeedQuerySetting::Selection | SeedQuerySetting::Always if !selection.is_empty() => {
1006                snapshot
1007                    .text_for_range(selection.start..selection.end)
1008                    .collect()
1009            }
1010            SeedQuerySetting::Selection => String::new(),
1011            SeedQuerySetting::Always => {
1012                let (range, kind) = snapshot.surrounding_word(selection.start);
1013                if kind == Some(CharKind::Word) {
1014                    let text: String = snapshot.text_for_range(range).collect();
1015                    if !text.trim().is_empty() {
1016                        return text;
1017                    }
1018                }
1019                String::new()
1020            }
1021        }
1022    }
1023
1024    fn activate_match(
1025        &mut self,
1026        index: usize,
1027        matches: &[Range<Anchor>],
1028        cx: &mut ViewContext<Self>,
1029    ) {
1030        self.unfold_ranges([matches[index].clone()], false, true, cx);
1031        let range = self.range_for_match(&matches[index]);
1032        self.change_selections(Some(Autoscroll::fit()), cx, |s| {
1033            s.select_ranges([range]);
1034        })
1035    }
1036
1037    fn select_matches(&mut self, matches: &[Self::Match], cx: &mut ViewContext<Self>) {
1038        self.unfold_ranges(matches.to_vec(), false, false, cx);
1039        let mut ranges = Vec::new();
1040        for m in matches {
1041            ranges.push(self.range_for_match(&m))
1042        }
1043        self.change_selections(None, cx, |s| s.select_ranges(ranges));
1044    }
1045    fn replace(
1046        &mut self,
1047        identifier: &Self::Match,
1048        query: &SearchQuery,
1049        cx: &mut ViewContext<Self>,
1050    ) {
1051        let text = self.buffer.read(cx);
1052        let text = text.snapshot(cx);
1053        let text = text.text_for_range(identifier.clone()).collect::<Vec<_>>();
1054        let text: Cow<_> = if text.len() == 1 {
1055            text.first().cloned().unwrap().into()
1056        } else {
1057            let joined_chunks = text.join("");
1058            joined_chunks.into()
1059        };
1060
1061        if let Some(replacement) = query.replacement_for(&text) {
1062            self.transact(cx, |this, cx| {
1063                this.edit([(identifier.clone(), Arc::from(&*replacement))], cx);
1064            });
1065        }
1066    }
1067    fn match_index_for_direction(
1068        &mut self,
1069        matches: &[Range<Anchor>],
1070        current_index: usize,
1071        direction: Direction,
1072        count: usize,
1073        cx: &mut ViewContext<Self>,
1074    ) -> usize {
1075        let buffer = self.buffer().read(cx).snapshot(cx);
1076        let current_index_position = if self.selections.disjoint_anchors().len() == 1 {
1077            self.selections.newest_anchor().head()
1078        } else {
1079            matches[current_index].start
1080        };
1081
1082        let mut count = count % matches.len();
1083        if count == 0 {
1084            return current_index;
1085        }
1086        match direction {
1087            Direction::Next => {
1088                if matches[current_index]
1089                    .start
1090                    .cmp(&current_index_position, &buffer)
1091                    .is_gt()
1092                {
1093                    count = count - 1
1094                }
1095
1096                (current_index + count) % matches.len()
1097            }
1098            Direction::Prev => {
1099                if matches[current_index]
1100                    .end
1101                    .cmp(&current_index_position, &buffer)
1102                    .is_lt()
1103                {
1104                    count = count - 1;
1105                }
1106
1107                if current_index >= count {
1108                    current_index - count
1109                } else {
1110                    matches.len() - (count - current_index)
1111                }
1112            }
1113        }
1114    }
1115
1116    fn find_matches(
1117        &mut self,
1118        query: Arc<project::search::SearchQuery>,
1119        cx: &mut ViewContext<Self>,
1120    ) -> Task<Vec<Range<Anchor>>> {
1121        let buffer = self.buffer().read(cx).snapshot(cx);
1122        cx.background_executor().spawn(async move {
1123            let mut ranges = Vec::new();
1124            if let Some((_, _, excerpt_buffer)) = buffer.as_singleton() {
1125                ranges.extend(
1126                    query
1127                        .search(excerpt_buffer, None)
1128                        .await
1129                        .into_iter()
1130                        .map(|range| {
1131                            buffer.anchor_after(range.start)..buffer.anchor_before(range.end)
1132                        }),
1133                );
1134            } else {
1135                for excerpt in buffer.excerpt_boundaries_in_range(0..buffer.len()) {
1136                    let excerpt_range = excerpt.range.context.to_offset(&excerpt.buffer);
1137                    ranges.extend(
1138                        query
1139                            .search(&excerpt.buffer, Some(excerpt_range.clone()))
1140                            .await
1141                            .into_iter()
1142                            .map(|range| {
1143                                let start = excerpt
1144                                    .buffer
1145                                    .anchor_after(excerpt_range.start + range.start);
1146                                let end = excerpt
1147                                    .buffer
1148                                    .anchor_before(excerpt_range.start + range.end);
1149                                buffer.anchor_in_excerpt(excerpt.id, start).unwrap()
1150                                    ..buffer.anchor_in_excerpt(excerpt.id, end).unwrap()
1151                            }),
1152                    );
1153                }
1154            }
1155            ranges
1156        })
1157    }
1158
1159    fn active_match_index(
1160        &mut self,
1161        matches: &[Range<Anchor>],
1162        cx: &mut ViewContext<Self>,
1163    ) -> Option<usize> {
1164        active_match_index(
1165            matches,
1166            &self.selections.newest_anchor().head(),
1167            &self.buffer().read(cx).snapshot(cx),
1168        )
1169    }
1170
1171    fn search_bar_visibility_changed(&mut self, _visible: bool, _cx: &mut ViewContext<Self>) {
1172        self.expect_bounds_change = self.last_bounds;
1173    }
1174}
1175
1176pub fn active_match_index(
1177    ranges: &[Range<Anchor>],
1178    cursor: &Anchor,
1179    buffer: &MultiBufferSnapshot,
1180) -> Option<usize> {
1181    if ranges.is_empty() {
1182        None
1183    } else {
1184        match ranges.binary_search_by(|probe| {
1185            if probe.end.cmp(cursor, buffer).is_lt() {
1186                Ordering::Less
1187            } else if probe.start.cmp(cursor, buffer).is_gt() {
1188                Ordering::Greater
1189            } else {
1190                Ordering::Equal
1191            }
1192        }) {
1193            Ok(i) | Err(i) => Some(cmp::min(i, ranges.len() - 1)),
1194        }
1195    }
1196}
1197
1198pub fn entry_label_color(selected: bool) -> Color {
1199    if selected {
1200        Color::Default
1201    } else {
1202        Color::Muted
1203    }
1204}
1205
1206pub fn entry_git_aware_label_color(
1207    git_status: Option<GitFileStatus>,
1208    ignored: bool,
1209    selected: bool,
1210) -> Color {
1211    if ignored {
1212        Color::Ignored
1213    } else {
1214        match git_status {
1215            Some(GitFileStatus::Added) => Color::Created,
1216            Some(GitFileStatus::Modified) => Color::Modified,
1217            Some(GitFileStatus::Conflict) => Color::Conflict,
1218            None => entry_label_color(selected),
1219        }
1220    }
1221}
1222
1223fn path_for_buffer<'a>(
1224    buffer: &Model<MultiBuffer>,
1225    height: usize,
1226    include_filename: bool,
1227    cx: &'a AppContext,
1228) -> Option<Cow<'a, Path>> {
1229    let file = buffer.read(cx).as_singleton()?.read(cx).file()?;
1230    path_for_file(file.as_ref(), height, include_filename, cx)
1231}
1232
1233fn path_for_file<'a>(
1234    file: &'a dyn language::File,
1235    mut height: usize,
1236    include_filename: bool,
1237    cx: &'a AppContext,
1238) -> Option<Cow<'a, Path>> {
1239    // Ensure we always render at least the filename.
1240    height += 1;
1241
1242    let mut prefix = file.path().as_ref();
1243    while height > 0 {
1244        if let Some(parent) = prefix.parent() {
1245            prefix = parent;
1246            height -= 1;
1247        } else {
1248            break;
1249        }
1250    }
1251
1252    // Here we could have just always used `full_path`, but that is very
1253    // allocation-heavy and so we try to use a `Cow<Path>` if we haven't
1254    // traversed all the way up to the worktree's root.
1255    if height > 0 {
1256        let full_path = file.full_path(cx);
1257        if include_filename {
1258            Some(full_path.into())
1259        } else {
1260            Some(full_path.parent()?.to_path_buf().into())
1261        }
1262    } else {
1263        let mut path = file.path().strip_prefix(prefix).ok()?;
1264        if !include_filename {
1265            path = path.parent()?;
1266        }
1267        Some(path.into())
1268    }
1269}
1270
1271#[cfg(test)]
1272mod tests {
1273    use super::*;
1274    use gpui::AppContext;
1275    use language::TestFile;
1276    use std::path::Path;
1277
1278    #[gpui::test]
1279    fn test_path_for_file(cx: &mut AppContext) {
1280        let file = TestFile {
1281            path: Path::new("").into(),
1282            root_name: String::new(),
1283        };
1284        assert_eq!(path_for_file(&file, 0, false, cx), None);
1285    }
1286}