1mod highlight_map;
2mod language;
3#[cfg(test)]
4mod tests;
5
6pub use self::{
7 highlight_map::{HighlightId, HighlightMap},
8 language::{BracketPair, Language, LanguageConfig, LanguageRegistry},
9};
10use anyhow::{anyhow, Result};
11pub use buffer::{Buffer as TextBuffer, *};
12use clock::ReplicaId;
13use futures::FutureExt as _;
14use gpui::{AppContext, Entity, ModelContext, MutableAppContext, Task};
15use lazy_static::lazy_static;
16use lsp::LanguageServer;
17use parking_lot::Mutex;
18use postage::{prelude::Stream, sink::Sink, watch};
19use rpc::proto;
20use similar::{ChangeTag, TextDiff};
21use smol::future::yield_now;
22use std::{
23 any::Any,
24 cell::RefCell,
25 cmp,
26 collections::{BTreeMap, HashMap, HashSet},
27 ffi::OsString,
28 future::Future,
29 iter::{Iterator, Peekable},
30 ops::{Deref, DerefMut, Range},
31 path::{Path, PathBuf},
32 str,
33 sync::Arc,
34 time::{Duration, Instant, SystemTime, UNIX_EPOCH},
35 vec,
36};
37use tree_sitter::{InputEdit, Parser, QueryCursor, Tree};
38use util::{post_inc, TryFutureExt as _};
39
40pub use lsp::DiagnosticSeverity;
41
42thread_local! {
43 static PARSER: RefCell<Parser> = RefCell::new(Parser::new());
44}
45
46lazy_static! {
47 static ref QUERY_CURSORS: Mutex<Vec<QueryCursor>> = Default::default();
48}
49
50// TODO - Make this configurable
51const INDENT_SIZE: u32 = 4;
52
53pub struct Buffer {
54 text: TextBuffer,
55 file: Option<Box<dyn File>>,
56 saved_version: clock::Global,
57 saved_mtime: SystemTime,
58 language: Option<Arc<Language>>,
59 autoindent_requests: Vec<Arc<AutoindentRequest>>,
60 pending_autoindent: Option<Task<()>>,
61 sync_parse_timeout: Duration,
62 syntax_tree: Mutex<Option<SyntaxTree>>,
63 parsing_in_background: bool,
64 parse_count: usize,
65 diagnostics: AnchorRangeMultimap<(DiagnosticSeverity, String)>,
66 diagnostics_update_count: usize,
67 language_server: Option<LanguageServerState>,
68 #[cfg(test)]
69 operations: Vec<Operation>,
70}
71
72pub struct Snapshot {
73 text: buffer::Snapshot,
74 tree: Option<Tree>,
75 diagnostics: AnchorRangeMultimap<(DiagnosticSeverity, String)>,
76 is_parsing: bool,
77 language: Option<Arc<Language>>,
78 query_cursor: QueryCursorHandle,
79}
80
81#[derive(Debug, PartialEq, Eq)]
82pub struct Diagnostic {
83 pub range: Range<Point>,
84 pub severity: DiagnosticSeverity,
85 pub message: String,
86}
87
88struct LanguageServerState {
89 server: Arc<LanguageServer>,
90 latest_snapshot: watch::Sender<Option<LanguageServerSnapshot>>,
91 pending_snapshots: BTreeMap<usize, LanguageServerSnapshot>,
92 next_version: usize,
93 _maintain_server: Task<Option<()>>,
94}
95
96#[derive(Clone)]
97struct LanguageServerSnapshot {
98 buffer_snapshot: buffer::Snapshot,
99 version: usize,
100 path: Arc<Path>,
101}
102
103#[derive(Clone, Debug, Eq, PartialEq)]
104pub enum Event {
105 Edited,
106 Dirtied,
107 Saved,
108 FileHandleChanged,
109 Reloaded,
110 Reparsed,
111 Closed,
112}
113
114pub trait File {
115 fn worktree_id(&self) -> usize;
116
117 fn entry_id(&self) -> Option<usize>;
118
119 fn mtime(&self) -> SystemTime;
120
121 /// Returns the path of this file relative to the worktree's root directory.
122 fn path(&self) -> &Arc<Path>;
123
124 /// Returns the absolute path of this file.
125 fn abs_path(&self, cx: &AppContext) -> Option<PathBuf>;
126
127 /// Returns the path of this file relative to the worktree's parent directory (this means it
128 /// includes the name of the worktree's root folder).
129 fn full_path(&self, cx: &AppContext) -> PathBuf;
130
131 /// Returns the last component of this handle's absolute path. If this handle refers to the root
132 /// of its worktree, then this method will return the name of the worktree itself.
133 fn file_name<'a>(&'a self, cx: &'a AppContext) -> Option<OsString>;
134
135 fn is_deleted(&self) -> bool;
136
137 fn save(
138 &self,
139 buffer_id: u64,
140 text: Rope,
141 version: clock::Global,
142 cx: &mut MutableAppContext,
143 ) -> Task<Result<(clock::Global, SystemTime)>>;
144
145 fn load_local(&self, cx: &AppContext) -> Option<Task<Result<String>>>;
146
147 fn buffer_updated(&self, buffer_id: u64, operation: Operation, cx: &mut MutableAppContext);
148
149 fn buffer_removed(&self, buffer_id: u64, cx: &mut MutableAppContext);
150
151 fn boxed_clone(&self) -> Box<dyn File>;
152
153 fn as_any(&self) -> &dyn Any;
154}
155
156struct QueryCursorHandle(Option<QueryCursor>);
157
158#[derive(Clone)]
159struct SyntaxTree {
160 tree: Tree,
161 version: clock::Global,
162}
163
164#[derive(Clone)]
165struct AutoindentRequest {
166 selection_set_ids: HashSet<SelectionSetId>,
167 before_edit: Snapshot,
168 edited: AnchorSet,
169 inserted: Option<AnchorRangeSet>,
170}
171
172#[derive(Debug)]
173struct IndentSuggestion {
174 basis_row: u32,
175 indent: bool,
176}
177
178struct TextProvider<'a>(&'a Rope);
179
180struct Highlights<'a> {
181 captures: tree_sitter::QueryCaptures<'a, 'a, TextProvider<'a>>,
182 next_capture: Option<(tree_sitter::QueryMatch<'a, 'a>, usize)>,
183 stack: Vec<(usize, HighlightId)>,
184 highlight_map: HighlightMap,
185}
186
187pub struct HighlightedChunks<'a> {
188 range: Range<usize>,
189 chunks: Chunks<'a>,
190 diagnostic_endpoints: Peekable<vec::IntoIter<DiagnosticEndpoint>>,
191 error_depth: usize,
192 warning_depth: usize,
193 information_depth: usize,
194 hint_depth: usize,
195 highlights: Option<Highlights<'a>>,
196}
197
198#[derive(Clone, Copy, Debug, Default)]
199pub struct HighlightedChunk<'a> {
200 pub text: &'a str,
201 pub highlight_id: HighlightId,
202 pub diagnostic: Option<DiagnosticSeverity>,
203}
204
205struct Diff {
206 base_version: clock::Global,
207 new_text: Arc<str>,
208 changes: Vec<(ChangeTag, usize)>,
209}
210
211#[derive(Clone, Copy)]
212struct DiagnosticEndpoint {
213 offset: usize,
214 is_start: bool,
215 severity: DiagnosticSeverity,
216}
217
218impl Buffer {
219 pub fn new<T: Into<Arc<str>>>(
220 replica_id: ReplicaId,
221 base_text: T,
222 cx: &mut ModelContext<Self>,
223 ) -> Self {
224 Self::build(
225 TextBuffer::new(
226 replica_id,
227 cx.model_id() as u64,
228 History::new(base_text.into()),
229 ),
230 None,
231 )
232 }
233
234 pub fn from_file<T: Into<Arc<str>>>(
235 replica_id: ReplicaId,
236 base_text: T,
237 file: Box<dyn File>,
238 cx: &mut ModelContext<Self>,
239 ) -> Self {
240 Self::build(
241 TextBuffer::new(
242 replica_id,
243 cx.model_id() as u64,
244 History::new(base_text.into()),
245 ),
246 Some(file),
247 )
248 }
249
250 pub fn from_proto(
251 replica_id: ReplicaId,
252 message: proto::Buffer,
253 file: Option<Box<dyn File>>,
254 ) -> Result<Self> {
255 Ok(Self::build(
256 TextBuffer::from_proto(replica_id, message)?,
257 file,
258 ))
259 }
260
261 pub fn with_language(
262 mut self,
263 language: Option<Arc<Language>>,
264 language_server: Option<Arc<LanguageServer>>,
265 cx: &mut ModelContext<Self>,
266 ) -> Self {
267 self.set_language(language, language_server, cx);
268 self
269 }
270
271 fn build(buffer: TextBuffer, file: Option<Box<dyn File>>) -> Self {
272 let saved_mtime;
273 if let Some(file) = file.as_ref() {
274 saved_mtime = file.mtime();
275 } else {
276 saved_mtime = UNIX_EPOCH;
277 }
278
279 Self {
280 text: buffer,
281 saved_mtime,
282 saved_version: clock::Global::new(),
283 file,
284 syntax_tree: Mutex::new(None),
285 parsing_in_background: false,
286 parse_count: 0,
287 sync_parse_timeout: Duration::from_millis(1),
288 autoindent_requests: Default::default(),
289 pending_autoindent: Default::default(),
290 language: None,
291 diagnostics: Default::default(),
292 diagnostics_update_count: 0,
293 language_server: None,
294 #[cfg(test)]
295 operations: Default::default(),
296 }
297 }
298
299 pub fn snapshot(&self) -> Snapshot {
300 Snapshot {
301 text: self.text.snapshot(),
302 tree: self.syntax_tree(),
303 diagnostics: self.diagnostics.clone(),
304 is_parsing: self.parsing_in_background,
305 language: self.language.clone(),
306 query_cursor: QueryCursorHandle::new(),
307 }
308 }
309
310 pub fn file(&self) -> Option<&dyn File> {
311 self.file.as_deref()
312 }
313
314 pub fn save(
315 &mut self,
316 cx: &mut ModelContext<Self>,
317 ) -> Result<Task<Result<(clock::Global, SystemTime)>>> {
318 let file = self
319 .file
320 .as_ref()
321 .ok_or_else(|| anyhow!("buffer has no file"))?;
322 let text = self.as_rope().clone();
323 let version = self.version.clone();
324 let save = file.save(self.remote_id(), text, version, cx.as_mut());
325 Ok(cx.spawn(|this, mut cx| async move {
326 let (version, mtime) = save.await?;
327 this.update(&mut cx, |this, cx| {
328 this.did_save(version.clone(), mtime, None, cx);
329 });
330 Ok((version, mtime))
331 }))
332 }
333
334 pub fn set_language(
335 &mut self,
336 language: Option<Arc<Language>>,
337 language_server: Option<Arc<lsp::LanguageServer>>,
338 cx: &mut ModelContext<Self>,
339 ) {
340 self.language = language;
341 self.language_server = if let Some(server) = language_server {
342 let (latest_snapshot_tx, mut latest_snapshot_rx) = watch::channel();
343 Some(LanguageServerState {
344 latest_snapshot: latest_snapshot_tx,
345 pending_snapshots: Default::default(),
346 next_version: 0,
347 server: server.clone(),
348 _maintain_server: cx.background().spawn(
349 async move {
350 let mut prev_snapshot: Option<LanguageServerSnapshot> = None;
351 while let Some(snapshot) = latest_snapshot_rx.recv().await {
352 if let Some(snapshot) = snapshot {
353 let uri = lsp::Url::from_file_path(&snapshot.path).unwrap();
354 if let Some(prev_snapshot) = prev_snapshot {
355 let changes = lsp::DidChangeTextDocumentParams {
356 text_document: lsp::VersionedTextDocumentIdentifier::new(
357 uri,
358 snapshot.version as i32,
359 ),
360 content_changes: snapshot
361 .buffer_snapshot
362 .edits_since(
363 prev_snapshot.buffer_snapshot.version().clone(),
364 )
365 .map(|edit| {
366 // TODO: Use UTF-16 positions.
367 let edit_start = edit.new_lines.start;
368 let edit_end = edit_start + edit.deleted_lines();
369 lsp::TextDocumentContentChangeEvent {
370 range: Some(lsp::Range::new(
371 lsp::Position::new(
372 edit_start.row,
373 edit_start.column,
374 ),
375 lsp::Position::new(
376 edit_end.row,
377 edit_end.column,
378 ),
379 )),
380 range_length: None,
381 text: snapshot
382 .buffer_snapshot
383 .text_for_range(edit.new_bytes)
384 .collect(),
385 }
386 })
387 .collect(),
388 };
389 server
390 .notify::<lsp::notification::DidChangeTextDocument>(changes)
391 .await?;
392 } else {
393 server
394 .notify::<lsp::notification::DidOpenTextDocument>(
395 lsp::DidOpenTextDocumentParams {
396 text_document: lsp::TextDocumentItem::new(
397 uri,
398 Default::default(),
399 snapshot.version as i32,
400 snapshot.buffer_snapshot.text().into(),
401 ),
402 },
403 )
404 .await?;
405 }
406
407 prev_snapshot = Some(snapshot);
408 }
409 }
410 Ok(())
411 }
412 .log_err(),
413 ),
414 })
415 } else {
416 None
417 };
418
419 self.reparse(cx);
420 self.update_language_server(cx);
421 }
422
423 pub fn did_save(
424 &mut self,
425 version: clock::Global,
426 mtime: SystemTime,
427 new_file: Option<Box<dyn File>>,
428 cx: &mut ModelContext<Self>,
429 ) {
430 self.saved_mtime = mtime;
431 self.saved_version = version;
432 if let Some(new_file) = new_file {
433 self.file = Some(new_file);
434 }
435 if let Some(state) = &self.language_server {
436 cx.background()
437 .spawn(
438 state
439 .server
440 .notify::<lsp::notification::DidSaveTextDocument>(
441 lsp::DidSaveTextDocumentParams {
442 text_document: lsp::TextDocumentIdentifier {
443 uri: lsp::Url::from_file_path(
444 self.file.as_ref().unwrap().abs_path(cx).unwrap(),
445 )
446 .unwrap(),
447 },
448 text: None,
449 },
450 ),
451 )
452 .detach()
453 }
454 cx.emit(Event::Saved);
455 }
456
457 pub fn file_updated(
458 &mut self,
459 new_file: Box<dyn File>,
460 cx: &mut ModelContext<Self>,
461 ) -> Option<Task<()>> {
462 let old_file = self.file.as_ref()?;
463 let mut file_changed = false;
464 let mut task = None;
465
466 if new_file.path() != old_file.path() {
467 file_changed = true;
468 }
469
470 if new_file.is_deleted() {
471 if !old_file.is_deleted() {
472 file_changed = true;
473 if !self.is_dirty() {
474 cx.emit(Event::Dirtied);
475 }
476 }
477 } else {
478 let new_mtime = new_file.mtime();
479 if new_mtime != old_file.mtime() {
480 file_changed = true;
481
482 if !self.is_dirty() {
483 task = Some(cx.spawn(|this, mut cx| {
484 async move {
485 let new_text = this.read_with(&cx, |this, cx| {
486 this.file.as_ref().and_then(|file| file.load_local(cx))
487 });
488 if let Some(new_text) = new_text {
489 let new_text = new_text.await?;
490 let diff = this
491 .read_with(&cx, |this, cx| this.diff(new_text.into(), cx))
492 .await;
493 this.update(&mut cx, |this, cx| {
494 if this.apply_diff(diff, cx) {
495 this.saved_version = this.version.clone();
496 this.saved_mtime = new_mtime;
497 cx.emit(Event::Reloaded);
498 }
499 });
500 }
501 Ok(())
502 }
503 .log_err()
504 .map(drop)
505 }));
506 }
507 }
508 }
509
510 if file_changed {
511 cx.emit(Event::FileHandleChanged);
512 }
513 self.file = Some(new_file);
514 task
515 }
516
517 pub fn close(&mut self, cx: &mut ModelContext<Self>) {
518 cx.emit(Event::Closed);
519 }
520
521 pub fn language(&self) -> Option<&Arc<Language>> {
522 self.language.as_ref()
523 }
524
525 pub fn parse_count(&self) -> usize {
526 self.parse_count
527 }
528
529 fn syntax_tree(&self) -> Option<Tree> {
530 if let Some(syntax_tree) = self.syntax_tree.lock().as_mut() {
531 self.interpolate_tree(syntax_tree);
532 Some(syntax_tree.tree.clone())
533 } else {
534 None
535 }
536 }
537
538 #[cfg(any(test, feature = "test-support"))]
539 pub fn is_parsing(&self) -> bool {
540 self.parsing_in_background
541 }
542
543 #[cfg(test)]
544 pub fn set_sync_parse_timeout(&mut self, timeout: Duration) {
545 self.sync_parse_timeout = timeout;
546 }
547
548 fn reparse(&mut self, cx: &mut ModelContext<Self>) -> bool {
549 if self.parsing_in_background {
550 return false;
551 }
552
553 if let Some(language) = self.language.clone() {
554 let old_tree = self.syntax_tree();
555 let text = self.as_rope().clone();
556 let parsed_version = self.version();
557 let parse_task = cx.background().spawn({
558 let language = language.clone();
559 async move { Self::parse_text(&text, old_tree, &language) }
560 });
561
562 match cx
563 .background()
564 .block_with_timeout(self.sync_parse_timeout, parse_task)
565 {
566 Ok(new_tree) => {
567 self.did_finish_parsing(new_tree, parsed_version, cx);
568 return true;
569 }
570 Err(parse_task) => {
571 self.parsing_in_background = true;
572 cx.spawn(move |this, mut cx| async move {
573 let new_tree = parse_task.await;
574 this.update(&mut cx, move |this, cx| {
575 let language_changed =
576 this.language.as_ref().map_or(true, |curr_language| {
577 !Arc::ptr_eq(curr_language, &language)
578 });
579 let parse_again = this.version > parsed_version || language_changed;
580 this.parsing_in_background = false;
581 this.did_finish_parsing(new_tree, parsed_version, cx);
582
583 if parse_again && this.reparse(cx) {
584 return;
585 }
586 });
587 })
588 .detach();
589 }
590 }
591 }
592 false
593 }
594
595 fn parse_text(text: &Rope, old_tree: Option<Tree>, language: &Language) -> Tree {
596 PARSER.with(|parser| {
597 let mut parser = parser.borrow_mut();
598 parser
599 .set_language(language.grammar)
600 .expect("incompatible grammar");
601 let mut chunks = text.chunks_in_range(0..text.len());
602 let tree = parser
603 .parse_with(
604 &mut move |offset, _| {
605 chunks.seek(offset);
606 chunks.next().unwrap_or("").as_bytes()
607 },
608 old_tree.as_ref(),
609 )
610 .unwrap();
611 tree
612 })
613 }
614
615 fn interpolate_tree(&self, tree: &mut SyntaxTree) {
616 let mut delta = 0_isize;
617 for edit in self.edits_since(tree.version.clone()) {
618 let start_offset = (edit.old_bytes.start as isize + delta) as usize;
619 let start_point = self.as_rope().to_point(start_offset);
620 tree.tree.edit(&InputEdit {
621 start_byte: start_offset,
622 old_end_byte: start_offset + edit.deleted_bytes(),
623 new_end_byte: start_offset + edit.inserted_bytes(),
624 start_position: start_point.to_ts_point(),
625 old_end_position: (start_point + edit.deleted_lines()).to_ts_point(),
626 new_end_position: self
627 .as_rope()
628 .to_point(start_offset + edit.inserted_bytes())
629 .to_ts_point(),
630 });
631 delta += edit.inserted_bytes() as isize - edit.deleted_bytes() as isize;
632 }
633 tree.version = self.version();
634 }
635
636 fn did_finish_parsing(
637 &mut self,
638 tree: Tree,
639 version: clock::Global,
640 cx: &mut ModelContext<Self>,
641 ) {
642 self.parse_count += 1;
643 *self.syntax_tree.lock() = Some(SyntaxTree { tree, version });
644 self.request_autoindent(cx);
645 cx.emit(Event::Reparsed);
646 cx.notify();
647 }
648
649 pub fn update_diagnostics(
650 &mut self,
651 version: Option<i32>,
652 mut diagnostics: Vec<lsp::Diagnostic>,
653 cx: &mut ModelContext<Self>,
654 ) -> Result<()> {
655 let version = version.map(|version| version as usize);
656 let content = if let Some(version) = version {
657 let language_server = self.language_server.as_mut().unwrap();
658 let snapshot = language_server
659 .pending_snapshots
660 .get(&version)
661 .ok_or_else(|| anyhow!("missing snapshot"))?;
662 snapshot.buffer_snapshot.content()
663 } else {
664 self.content()
665 };
666
667 let empty_set = HashSet::new();
668 let disk_based_sources = self
669 .language
670 .as_ref()
671 .and_then(|language| language.disk_based_diagnostic_sources())
672 .unwrap_or(&empty_set);
673
674 diagnostics.sort_unstable_by_key(|d| (d.range.start, d.range.end));
675 self.diagnostics = {
676 let mut edits_since_save = content.edits_since(self.saved_version.clone()).peekable();
677 let mut last_edit_old_end = Point::zero();
678 let mut last_edit_new_end = Point::zero();
679
680 content.anchor_range_multimap(
681 Bias::Left,
682 Bias::Right,
683 diagnostics.into_iter().filter_map(|diagnostic| {
684 // TODO: Use UTF-16 positions.
685 let mut start = Point::new(
686 diagnostic.range.start.line,
687 diagnostic.range.start.character,
688 );
689 let mut end =
690 Point::new(diagnostic.range.end.line, diagnostic.range.end.character);
691 let severity = diagnostic.severity.unwrap_or(DiagnosticSeverity::ERROR);
692
693 if diagnostic
694 .source
695 .as_ref()
696 .map_or(false, |source| disk_based_sources.contains(source))
697 {
698 while let Some(edit) = edits_since_save.peek() {
699 if edit.old_lines.end <= start {
700 last_edit_old_end = edit.old_lines.end;
701 last_edit_new_end = edit.new_lines.end;
702 edits_since_save.next();
703 } else if edit.old_lines.start <= end && edit.old_lines.end >= start {
704 return None;
705 } else {
706 break;
707 }
708 }
709
710 start = last_edit_new_end + (start - last_edit_old_end);
711 end = last_edit_new_end + (end - last_edit_old_end);
712 }
713
714 let range =
715 content.clip_point(start, Bias::Left)..content.clip_point(end, Bias::Right);
716 Some((range, (severity, diagnostic.message)))
717 }),
718 )
719 };
720
721 if let Some(version) = version {
722 let language_server = self.language_server.as_mut().unwrap();
723 let versions_to_delete = language_server
724 .pending_snapshots
725 .range(..version)
726 .map(|(v, _)| *v)
727 .collect::<Vec<_>>();
728 for version in versions_to_delete {
729 language_server.pending_snapshots.remove(&version);
730 }
731 }
732
733 self.diagnostics_update_count += 1;
734 cx.notify();
735 Ok(())
736 }
737
738 pub fn diagnostics_in_range<'a, T: ToOffset>(
739 &'a self,
740 range: Range<T>,
741 ) -> impl Iterator<Item = Diagnostic> + 'a {
742 let content = self.content();
743 let range = range.start.to_offset(&content)..range.end.to_offset(&content);
744 self.diagnostics
745 .intersecting_ranges(range, content, true)
746 .map(move |(_, range, (severity, message))| Diagnostic {
747 range,
748 severity: *severity,
749 message: message.clone(),
750 })
751 }
752
753 pub fn diagnostics_update_count(&self) -> usize {
754 self.diagnostics_update_count
755 }
756
757 fn request_autoindent(&mut self, cx: &mut ModelContext<Self>) {
758 if let Some(indent_columns) = self.compute_autoindents() {
759 let indent_columns = cx.background().spawn(indent_columns);
760 match cx
761 .background()
762 .block_with_timeout(Duration::from_micros(500), indent_columns)
763 {
764 Ok(indent_columns) => self.apply_autoindents(indent_columns, cx),
765 Err(indent_columns) => {
766 self.pending_autoindent = Some(cx.spawn(|this, mut cx| async move {
767 let indent_columns = indent_columns.await;
768 this.update(&mut cx, |this, cx| {
769 this.apply_autoindents(indent_columns, cx);
770 });
771 }));
772 }
773 }
774 }
775 }
776
777 fn compute_autoindents(&self) -> Option<impl Future<Output = BTreeMap<u32, u32>>> {
778 let max_rows_between_yields = 100;
779 let snapshot = self.snapshot();
780 if snapshot.language.is_none()
781 || snapshot.tree.is_none()
782 || self.autoindent_requests.is_empty()
783 {
784 return None;
785 }
786
787 let autoindent_requests = self.autoindent_requests.clone();
788 Some(async move {
789 let mut indent_columns = BTreeMap::new();
790 for request in autoindent_requests {
791 let old_to_new_rows = request
792 .edited
793 .to_points(&request.before_edit)
794 .map(|point| point.row)
795 .zip(request.edited.to_points(&snapshot).map(|point| point.row))
796 .collect::<BTreeMap<u32, u32>>();
797
798 let mut old_suggestions = HashMap::<u32, u32>::default();
799 let old_edited_ranges =
800 contiguous_ranges(old_to_new_rows.keys().copied(), max_rows_between_yields);
801 for old_edited_range in old_edited_ranges {
802 let suggestions = request
803 .before_edit
804 .suggest_autoindents(old_edited_range.clone())
805 .into_iter()
806 .flatten();
807 for (old_row, suggestion) in old_edited_range.zip(suggestions) {
808 let indentation_basis = old_to_new_rows
809 .get(&suggestion.basis_row)
810 .and_then(|from_row| old_suggestions.get(from_row).copied())
811 .unwrap_or_else(|| {
812 request
813 .before_edit
814 .indent_column_for_line(suggestion.basis_row)
815 });
816 let delta = if suggestion.indent { INDENT_SIZE } else { 0 };
817 old_suggestions.insert(
818 *old_to_new_rows.get(&old_row).unwrap(),
819 indentation_basis + delta,
820 );
821 }
822 yield_now().await;
823 }
824
825 // At this point, old_suggestions contains the suggested indentation for all edited lines with respect to the state of the
826 // buffer before the edit, but keyed by the row for these lines after the edits were applied.
827 let new_edited_row_ranges =
828 contiguous_ranges(old_to_new_rows.values().copied(), max_rows_between_yields);
829 for new_edited_row_range in new_edited_row_ranges {
830 let suggestions = snapshot
831 .suggest_autoindents(new_edited_row_range.clone())
832 .into_iter()
833 .flatten();
834 for (new_row, suggestion) in new_edited_row_range.zip(suggestions) {
835 let delta = if suggestion.indent { INDENT_SIZE } else { 0 };
836 let new_indentation = indent_columns
837 .get(&suggestion.basis_row)
838 .copied()
839 .unwrap_or_else(|| {
840 snapshot.indent_column_for_line(suggestion.basis_row)
841 })
842 + delta;
843 if old_suggestions
844 .get(&new_row)
845 .map_or(true, |old_indentation| new_indentation != *old_indentation)
846 {
847 indent_columns.insert(new_row, new_indentation);
848 }
849 }
850 yield_now().await;
851 }
852
853 if let Some(inserted) = request.inserted.as_ref() {
854 let inserted_row_ranges = contiguous_ranges(
855 inserted
856 .to_point_ranges(&snapshot)
857 .flat_map(|range| range.start.row..range.end.row + 1),
858 max_rows_between_yields,
859 );
860 for inserted_row_range in inserted_row_ranges {
861 let suggestions = snapshot
862 .suggest_autoindents(inserted_row_range.clone())
863 .into_iter()
864 .flatten();
865 for (row, suggestion) in inserted_row_range.zip(suggestions) {
866 let delta = if suggestion.indent { INDENT_SIZE } else { 0 };
867 let new_indentation = indent_columns
868 .get(&suggestion.basis_row)
869 .copied()
870 .unwrap_or_else(|| {
871 snapshot.indent_column_for_line(suggestion.basis_row)
872 })
873 + delta;
874 indent_columns.insert(row, new_indentation);
875 }
876 yield_now().await;
877 }
878 }
879 }
880 indent_columns
881 })
882 }
883
884 fn apply_autoindents(
885 &mut self,
886 indent_columns: BTreeMap<u32, u32>,
887 cx: &mut ModelContext<Self>,
888 ) {
889 let selection_set_ids = self
890 .autoindent_requests
891 .drain(..)
892 .flat_map(|req| req.selection_set_ids.clone())
893 .collect::<HashSet<_>>();
894
895 self.start_transaction(selection_set_ids.iter().copied())
896 .unwrap();
897 for (row, indent_column) in &indent_columns {
898 self.set_indent_column_for_line(*row, *indent_column, cx);
899 }
900
901 for selection_set_id in &selection_set_ids {
902 if let Ok(set) = self.selection_set(*selection_set_id) {
903 let new_selections = set
904 .selections
905 .iter()
906 .map(|selection| {
907 let start_point = selection.start.to_point(&self.text);
908 if start_point.column == 0 {
909 let end_point = selection.end.to_point(&self.text);
910 let delta = Point::new(
911 0,
912 indent_columns.get(&start_point.row).copied().unwrap_or(0),
913 );
914 if delta.column > 0 {
915 return Selection {
916 id: selection.id,
917 goal: selection.goal,
918 reversed: selection.reversed,
919 start: self
920 .anchor_at(start_point + delta, selection.start.bias),
921 end: self.anchor_at(end_point + delta, selection.end.bias),
922 };
923 }
924 }
925 selection.clone()
926 })
927 .collect::<Arc<[_]>>();
928 self.update_selection_set(*selection_set_id, new_selections, cx)
929 .unwrap();
930 }
931 }
932
933 self.end_transaction(selection_set_ids.iter().copied(), cx)
934 .unwrap();
935 }
936
937 pub fn indent_column_for_line(&self, row: u32) -> u32 {
938 self.content().indent_column_for_line(row)
939 }
940
941 fn set_indent_column_for_line(&mut self, row: u32, column: u32, cx: &mut ModelContext<Self>) {
942 let current_column = self.indent_column_for_line(row);
943 if column > current_column {
944 let offset = Point::new(row, 0).to_offset(&*self);
945 self.edit(
946 [offset..offset],
947 " ".repeat((column - current_column) as usize),
948 cx,
949 );
950 } else if column < current_column {
951 self.edit(
952 [Point::new(row, 0)..Point::new(row, current_column - column)],
953 "",
954 cx,
955 );
956 }
957 }
958
959 pub fn range_for_syntax_ancestor<T: ToOffset>(&self, range: Range<T>) -> Option<Range<usize>> {
960 if let Some(tree) = self.syntax_tree() {
961 let root = tree.root_node();
962 let range = range.start.to_offset(self)..range.end.to_offset(self);
963 let mut node = root.descendant_for_byte_range(range.start, range.end);
964 while node.map_or(false, |n| n.byte_range() == range) {
965 node = node.unwrap().parent();
966 }
967 node.map(|n| n.byte_range())
968 } else {
969 None
970 }
971 }
972
973 pub fn enclosing_bracket_ranges<T: ToOffset>(
974 &self,
975 range: Range<T>,
976 ) -> Option<(Range<usize>, Range<usize>)> {
977 let (lang, tree) = self.language.as_ref().zip(self.syntax_tree())?;
978 let open_capture_ix = lang.brackets_query.capture_index_for_name("open")?;
979 let close_capture_ix = lang.brackets_query.capture_index_for_name("close")?;
980
981 // Find bracket pairs that *inclusively* contain the given range.
982 let range = range.start.to_offset(self).saturating_sub(1)..range.end.to_offset(self) + 1;
983 let mut cursor = QueryCursorHandle::new();
984 let matches = cursor.set_byte_range(range).matches(
985 &lang.brackets_query,
986 tree.root_node(),
987 TextProvider(self.as_rope()),
988 );
989
990 // Get the ranges of the innermost pair of brackets.
991 matches
992 .filter_map(|mat| {
993 let open = mat.nodes_for_capture_index(open_capture_ix).next()?;
994 let close = mat.nodes_for_capture_index(close_capture_ix).next()?;
995 Some((open.byte_range(), close.byte_range()))
996 })
997 .min_by_key(|(open_range, close_range)| close_range.end - open_range.start)
998 }
999
1000 fn diff(&self, new_text: Arc<str>, cx: &AppContext) -> Task<Diff> {
1001 // TODO: it would be nice to not allocate here.
1002 let old_text = self.text();
1003 let base_version = self.version();
1004 cx.background().spawn(async move {
1005 let changes = TextDiff::from_lines(old_text.as_str(), new_text.as_ref())
1006 .iter_all_changes()
1007 .map(|c| (c.tag(), c.value().len()))
1008 .collect::<Vec<_>>();
1009 Diff {
1010 base_version,
1011 new_text,
1012 changes,
1013 }
1014 })
1015 }
1016
1017 fn apply_diff(&mut self, diff: Diff, cx: &mut ModelContext<Self>) -> bool {
1018 if self.version == diff.base_version {
1019 self.start_transaction(None).unwrap();
1020 let mut offset = 0;
1021 for (tag, len) in diff.changes {
1022 let range = offset..(offset + len);
1023 match tag {
1024 ChangeTag::Equal => offset += len,
1025 ChangeTag::Delete => self.edit(Some(range), "", cx),
1026 ChangeTag::Insert => {
1027 self.edit(Some(offset..offset), &diff.new_text[range], cx);
1028 offset += len;
1029 }
1030 }
1031 }
1032 self.end_transaction(None, cx).unwrap();
1033 true
1034 } else {
1035 false
1036 }
1037 }
1038
1039 pub fn is_dirty(&self) -> bool {
1040 self.version > self.saved_version
1041 || self.file.as_ref().map_or(false, |file| file.is_deleted())
1042 }
1043
1044 pub fn has_conflict(&self) -> bool {
1045 self.version > self.saved_version
1046 && self
1047 .file
1048 .as_ref()
1049 .map_or(false, |file| file.mtime() > self.saved_mtime)
1050 }
1051
1052 pub fn start_transaction(
1053 &mut self,
1054 selection_set_ids: impl IntoIterator<Item = SelectionSetId>,
1055 ) -> Result<()> {
1056 self.start_transaction_at(selection_set_ids, Instant::now())
1057 }
1058
1059 fn start_transaction_at(
1060 &mut self,
1061 selection_set_ids: impl IntoIterator<Item = SelectionSetId>,
1062 now: Instant,
1063 ) -> Result<()> {
1064 self.text.start_transaction_at(selection_set_ids, now)
1065 }
1066
1067 pub fn end_transaction(
1068 &mut self,
1069 selection_set_ids: impl IntoIterator<Item = SelectionSetId>,
1070 cx: &mut ModelContext<Self>,
1071 ) -> Result<()> {
1072 self.end_transaction_at(selection_set_ids, Instant::now(), cx)
1073 }
1074
1075 fn end_transaction_at(
1076 &mut self,
1077 selection_set_ids: impl IntoIterator<Item = SelectionSetId>,
1078 now: Instant,
1079 cx: &mut ModelContext<Self>,
1080 ) -> Result<()> {
1081 if let Some(start_version) = self.text.end_transaction_at(selection_set_ids, now) {
1082 let was_dirty = start_version != self.saved_version;
1083 self.did_edit(start_version, was_dirty, cx);
1084 }
1085 Ok(())
1086 }
1087
1088 fn update_language_server(&mut self, cx: &AppContext) {
1089 let language_server = if let Some(language_server) = self.language_server.as_mut() {
1090 language_server
1091 } else {
1092 return;
1093 };
1094 let abs_path = self
1095 .file
1096 .as_ref()
1097 .map_or(Path::new("/").to_path_buf(), |file| {
1098 file.abs_path(cx).unwrap()
1099 });
1100
1101 let version = post_inc(&mut language_server.next_version);
1102 let snapshot = LanguageServerSnapshot {
1103 buffer_snapshot: self.text.snapshot(),
1104 version,
1105 path: Arc::from(abs_path),
1106 };
1107 language_server
1108 .pending_snapshots
1109 .insert(version, snapshot.clone());
1110 let _ = language_server
1111 .latest_snapshot
1112 .blocking_send(Some(snapshot));
1113 }
1114
1115 pub fn edit<I, S, T>(&mut self, ranges_iter: I, new_text: T, cx: &mut ModelContext<Self>)
1116 where
1117 I: IntoIterator<Item = Range<S>>,
1118 S: ToOffset,
1119 T: Into<String>,
1120 {
1121 self.edit_internal(ranges_iter, new_text, false, cx)
1122 }
1123
1124 pub fn edit_with_autoindent<I, S, T>(
1125 &mut self,
1126 ranges_iter: I,
1127 new_text: T,
1128 cx: &mut ModelContext<Self>,
1129 ) where
1130 I: IntoIterator<Item = Range<S>>,
1131 S: ToOffset,
1132 T: Into<String>,
1133 {
1134 self.edit_internal(ranges_iter, new_text, true, cx)
1135 }
1136
1137 pub fn edit_internal<I, S, T>(
1138 &mut self,
1139 ranges_iter: I,
1140 new_text: T,
1141 autoindent: bool,
1142 cx: &mut ModelContext<Self>,
1143 ) where
1144 I: IntoIterator<Item = Range<S>>,
1145 S: ToOffset,
1146 T: Into<String>,
1147 {
1148 let new_text = new_text.into();
1149
1150 // Skip invalid ranges and coalesce contiguous ones.
1151 let mut ranges: Vec<Range<usize>> = Vec::new();
1152 for range in ranges_iter {
1153 let range = range.start.to_offset(&*self)..range.end.to_offset(&*self);
1154 if !new_text.is_empty() || !range.is_empty() {
1155 if let Some(prev_range) = ranges.last_mut() {
1156 if prev_range.end >= range.start {
1157 prev_range.end = cmp::max(prev_range.end, range.end);
1158 } else {
1159 ranges.push(range);
1160 }
1161 } else {
1162 ranges.push(range);
1163 }
1164 }
1165 }
1166 if ranges.is_empty() {
1167 return;
1168 }
1169
1170 self.start_transaction(None).unwrap();
1171 self.pending_autoindent.take();
1172 let autoindent_request = if autoindent && self.language.is_some() {
1173 let before_edit = self.snapshot();
1174 let edited = self.content().anchor_set(ranges.iter().filter_map(|range| {
1175 let start = range.start.to_point(&*self);
1176 if new_text.starts_with('\n') && start.column == self.line_len(start.row) {
1177 None
1178 } else {
1179 Some((range.start, Bias::Left))
1180 }
1181 }));
1182 Some((before_edit, edited))
1183 } else {
1184 None
1185 };
1186
1187 let first_newline_ix = new_text.find('\n');
1188 let new_text_len = new_text.len();
1189
1190 let edit = self.text.edit(ranges.iter().cloned(), new_text);
1191
1192 if let Some((before_edit, edited)) = autoindent_request {
1193 let mut inserted = None;
1194 if let Some(first_newline_ix) = first_newline_ix {
1195 let mut delta = 0isize;
1196 inserted = Some(self.content().anchor_range_set(ranges.iter().map(|range| {
1197 let start = (delta + range.start as isize) as usize + first_newline_ix + 1;
1198 let end = (delta + range.start as isize) as usize + new_text_len;
1199 delta += (range.end as isize - range.start as isize) + new_text_len as isize;
1200 (start, Bias::Left)..(end, Bias::Right)
1201 })));
1202 }
1203
1204 let selection_set_ids = self
1205 .text
1206 .peek_undo_stack()
1207 .unwrap()
1208 .starting_selection_set_ids()
1209 .collect();
1210 self.autoindent_requests.push(Arc::new(AutoindentRequest {
1211 selection_set_ids,
1212 before_edit,
1213 edited,
1214 inserted,
1215 }));
1216 }
1217
1218 self.end_transaction(None, cx).unwrap();
1219 self.send_operation(Operation::Edit(edit), cx);
1220 }
1221
1222 fn did_edit(
1223 &mut self,
1224 old_version: clock::Global,
1225 was_dirty: bool,
1226 cx: &mut ModelContext<Self>,
1227 ) {
1228 if self.edits_since(old_version).next().is_none() {
1229 return;
1230 }
1231
1232 self.reparse(cx);
1233 self.update_language_server(cx);
1234
1235 cx.emit(Event::Edited);
1236 if !was_dirty {
1237 cx.emit(Event::Dirtied);
1238 }
1239 cx.notify();
1240 }
1241
1242 pub fn add_selection_set(
1243 &mut self,
1244 selections: impl Into<Arc<[Selection]>>,
1245 cx: &mut ModelContext<Self>,
1246 ) -> SelectionSetId {
1247 let operation = self.text.add_selection_set(selections);
1248 if let Operation::UpdateSelections { set_id, .. } = &operation {
1249 let set_id = *set_id;
1250 cx.notify();
1251 self.send_operation(operation, cx);
1252 set_id
1253 } else {
1254 unreachable!()
1255 }
1256 }
1257
1258 pub fn update_selection_set(
1259 &mut self,
1260 set_id: SelectionSetId,
1261 selections: impl Into<Arc<[Selection]>>,
1262 cx: &mut ModelContext<Self>,
1263 ) -> Result<()> {
1264 let operation = self.text.update_selection_set(set_id, selections)?;
1265 cx.notify();
1266 self.send_operation(operation, cx);
1267 Ok(())
1268 }
1269
1270 pub fn set_active_selection_set(
1271 &mut self,
1272 set_id: Option<SelectionSetId>,
1273 cx: &mut ModelContext<Self>,
1274 ) -> Result<()> {
1275 let operation = self.text.set_active_selection_set(set_id)?;
1276 self.send_operation(operation, cx);
1277 Ok(())
1278 }
1279
1280 pub fn remove_selection_set(
1281 &mut self,
1282 set_id: SelectionSetId,
1283 cx: &mut ModelContext<Self>,
1284 ) -> Result<()> {
1285 let operation = self.text.remove_selection_set(set_id)?;
1286 cx.notify();
1287 self.send_operation(operation, cx);
1288 Ok(())
1289 }
1290
1291 pub fn apply_ops<I: IntoIterator<Item = Operation>>(
1292 &mut self,
1293 ops: I,
1294 cx: &mut ModelContext<Self>,
1295 ) -> Result<()> {
1296 self.pending_autoindent.take();
1297 let was_dirty = self.is_dirty();
1298 let old_version = self.version.clone();
1299 self.text.apply_ops(ops)?;
1300 self.did_edit(old_version, was_dirty, cx);
1301 Ok(())
1302 }
1303
1304 #[cfg(not(test))]
1305 pub fn send_operation(&mut self, operation: Operation, cx: &mut ModelContext<Self>) {
1306 if let Some(file) = &self.file {
1307 file.buffer_updated(self.remote_id(), operation, cx.as_mut());
1308 }
1309 }
1310
1311 #[cfg(test)]
1312 pub fn send_operation(&mut self, operation: Operation, _: &mut ModelContext<Self>) {
1313 self.operations.push(operation);
1314 }
1315
1316 pub fn remove_peer(&mut self, replica_id: ReplicaId, cx: &mut ModelContext<Self>) {
1317 self.text.remove_peer(replica_id);
1318 cx.notify();
1319 }
1320
1321 pub fn undo(&mut self, cx: &mut ModelContext<Self>) {
1322 let was_dirty = self.is_dirty();
1323 let old_version = self.version.clone();
1324
1325 for operation in self.text.undo() {
1326 self.send_operation(operation, cx);
1327 }
1328
1329 self.did_edit(old_version, was_dirty, cx);
1330 }
1331
1332 pub fn redo(&mut self, cx: &mut ModelContext<Self>) {
1333 let was_dirty = self.is_dirty();
1334 let old_version = self.version.clone();
1335
1336 for operation in self.text.redo() {
1337 self.send_operation(operation, cx);
1338 }
1339
1340 self.did_edit(old_version, was_dirty, cx);
1341 }
1342}
1343
1344#[cfg(any(test, feature = "test-support"))]
1345impl Buffer {
1346 pub fn randomly_edit<T>(&mut self, rng: &mut T, old_range_count: usize)
1347 where
1348 T: rand::Rng,
1349 {
1350 self.text.randomly_edit(rng, old_range_count);
1351 }
1352
1353 pub fn randomly_mutate<T>(&mut self, rng: &mut T)
1354 where
1355 T: rand::Rng,
1356 {
1357 self.text.randomly_mutate(rng);
1358 }
1359}
1360
1361impl Entity for Buffer {
1362 type Event = Event;
1363
1364 fn release(&mut self, cx: &mut gpui::MutableAppContext) {
1365 if let Some(file) = self.file.as_ref() {
1366 file.buffer_removed(self.remote_id(), cx);
1367 }
1368 }
1369}
1370
1371// TODO: Do we need to clone a buffer?
1372impl Clone for Buffer {
1373 fn clone(&self) -> Self {
1374 Self {
1375 text: self.text.clone(),
1376 saved_version: self.saved_version.clone(),
1377 saved_mtime: self.saved_mtime,
1378 file: self.file.as_ref().map(|f| f.boxed_clone()),
1379 language: self.language.clone(),
1380 syntax_tree: Mutex::new(self.syntax_tree.lock().clone()),
1381 parsing_in_background: false,
1382 sync_parse_timeout: self.sync_parse_timeout,
1383 parse_count: self.parse_count,
1384 autoindent_requests: Default::default(),
1385 pending_autoindent: Default::default(),
1386 diagnostics: self.diagnostics.clone(),
1387 diagnostics_update_count: self.diagnostics_update_count,
1388 language_server: None,
1389 #[cfg(test)]
1390 operations: self.operations.clone(),
1391 }
1392 }
1393}
1394
1395impl Deref for Buffer {
1396 type Target = TextBuffer;
1397
1398 fn deref(&self) -> &Self::Target {
1399 &self.text
1400 }
1401}
1402
1403impl<'a> From<&'a Buffer> for Content<'a> {
1404 fn from(buffer: &'a Buffer) -> Self {
1405 Self::from(&buffer.text)
1406 }
1407}
1408
1409impl<'a> From<&'a mut Buffer> for Content<'a> {
1410 fn from(buffer: &'a mut Buffer) -> Self {
1411 Self::from(&buffer.text)
1412 }
1413}
1414
1415impl<'a> From<&'a Snapshot> for Content<'a> {
1416 fn from(snapshot: &'a Snapshot) -> Self {
1417 Self::from(&snapshot.text)
1418 }
1419}
1420
1421impl Snapshot {
1422 fn suggest_autoindents<'a>(
1423 &'a self,
1424 row_range: Range<u32>,
1425 ) -> Option<impl Iterator<Item = IndentSuggestion> + 'a> {
1426 let mut query_cursor = QueryCursorHandle::new();
1427 if let Some((language, tree)) = self.language.as_ref().zip(self.tree.as_ref()) {
1428 let prev_non_blank_row = self.prev_non_blank_row(row_range.start);
1429
1430 // Get the "indentation ranges" that intersect this row range.
1431 let indent_capture_ix = language.indents_query.capture_index_for_name("indent");
1432 let end_capture_ix = language.indents_query.capture_index_for_name("end");
1433 query_cursor.set_point_range(
1434 Point::new(prev_non_blank_row.unwrap_or(row_range.start), 0).to_ts_point()
1435 ..Point::new(row_range.end, 0).to_ts_point(),
1436 );
1437 let mut indentation_ranges = Vec::<(Range<Point>, &'static str)>::new();
1438 for mat in query_cursor.matches(
1439 &language.indents_query,
1440 tree.root_node(),
1441 TextProvider(self.as_rope()),
1442 ) {
1443 let mut node_kind = "";
1444 let mut start: Option<Point> = None;
1445 let mut end: Option<Point> = None;
1446 for capture in mat.captures {
1447 if Some(capture.index) == indent_capture_ix {
1448 node_kind = capture.node.kind();
1449 start.get_or_insert(Point::from_ts_point(capture.node.start_position()));
1450 end.get_or_insert(Point::from_ts_point(capture.node.end_position()));
1451 } else if Some(capture.index) == end_capture_ix {
1452 end = Some(Point::from_ts_point(capture.node.start_position().into()));
1453 }
1454 }
1455
1456 if let Some((start, end)) = start.zip(end) {
1457 if start.row == end.row {
1458 continue;
1459 }
1460
1461 let range = start..end;
1462 match indentation_ranges.binary_search_by_key(&range.start, |r| r.0.start) {
1463 Err(ix) => indentation_ranges.insert(ix, (range, node_kind)),
1464 Ok(ix) => {
1465 let prev_range = &mut indentation_ranges[ix];
1466 prev_range.0.end = prev_range.0.end.max(range.end);
1467 }
1468 }
1469 }
1470 }
1471
1472 let mut prev_row = prev_non_blank_row.unwrap_or(0);
1473 Some(row_range.map(move |row| {
1474 let row_start = Point::new(row, self.indent_column_for_line(row));
1475
1476 let mut indent_from_prev_row = false;
1477 let mut outdent_to_row = u32::MAX;
1478 for (range, _node_kind) in &indentation_ranges {
1479 if range.start.row >= row {
1480 break;
1481 }
1482
1483 if range.start.row == prev_row && range.end > row_start {
1484 indent_from_prev_row = true;
1485 }
1486 if range.end.row >= prev_row && range.end <= row_start {
1487 outdent_to_row = outdent_to_row.min(range.start.row);
1488 }
1489 }
1490
1491 let suggestion = if outdent_to_row == prev_row {
1492 IndentSuggestion {
1493 basis_row: prev_row,
1494 indent: false,
1495 }
1496 } else if indent_from_prev_row {
1497 IndentSuggestion {
1498 basis_row: prev_row,
1499 indent: true,
1500 }
1501 } else if outdent_to_row < prev_row {
1502 IndentSuggestion {
1503 basis_row: outdent_to_row,
1504 indent: false,
1505 }
1506 } else {
1507 IndentSuggestion {
1508 basis_row: prev_row,
1509 indent: false,
1510 }
1511 };
1512
1513 prev_row = row;
1514 suggestion
1515 }))
1516 } else {
1517 None
1518 }
1519 }
1520
1521 fn prev_non_blank_row(&self, mut row: u32) -> Option<u32> {
1522 while row > 0 {
1523 row -= 1;
1524 if !self.is_line_blank(row) {
1525 return Some(row);
1526 }
1527 }
1528 None
1529 }
1530
1531 fn is_line_blank(&self, row: u32) -> bool {
1532 self.text_for_range(Point::new(row, 0)..Point::new(row, self.line_len(row)))
1533 .all(|chunk| chunk.matches(|c: char| !c.is_whitespace()).next().is_none())
1534 }
1535
1536 pub fn highlighted_text_for_range<T: ToOffset>(
1537 &mut self,
1538 range: Range<T>,
1539 ) -> HighlightedChunks {
1540 let range = range.start.to_offset(&*self)..range.end.to_offset(&*self);
1541
1542 let mut diagnostic_endpoints = Vec::<DiagnosticEndpoint>::new();
1543 for (_, range, (severity, _)) in
1544 self.diagnostics
1545 .intersecting_ranges(range.clone(), self.content(), true)
1546 {
1547 diagnostic_endpoints.push(DiagnosticEndpoint {
1548 offset: range.start,
1549 is_start: true,
1550 severity: *severity,
1551 });
1552 diagnostic_endpoints.push(DiagnosticEndpoint {
1553 offset: range.end,
1554 is_start: false,
1555 severity: *severity,
1556 });
1557 }
1558 diagnostic_endpoints.sort_unstable_by_key(|endpoint| (endpoint.offset, !endpoint.is_start));
1559 let diagnostic_endpoints = diagnostic_endpoints.into_iter().peekable();
1560
1561 let chunks = self.text.as_rope().chunks_in_range(range.clone());
1562 let highlights =
1563 if let Some((language, tree)) = self.language.as_ref().zip(self.tree.as_ref()) {
1564 let captures = self.query_cursor.set_byte_range(range.clone()).captures(
1565 &language.highlights_query,
1566 tree.root_node(),
1567 TextProvider(self.text.as_rope()),
1568 );
1569
1570 Some(Highlights {
1571 captures,
1572 next_capture: None,
1573 stack: Default::default(),
1574 highlight_map: language.highlight_map(),
1575 })
1576 } else {
1577 None
1578 };
1579
1580 HighlightedChunks {
1581 range,
1582 chunks,
1583 diagnostic_endpoints,
1584 error_depth: 0,
1585 warning_depth: 0,
1586 information_depth: 0,
1587 hint_depth: 0,
1588 highlights,
1589 }
1590 }
1591}
1592
1593impl Clone for Snapshot {
1594 fn clone(&self) -> Self {
1595 Self {
1596 text: self.text.clone(),
1597 tree: self.tree.clone(),
1598 diagnostics: self.diagnostics.clone(),
1599 is_parsing: self.is_parsing,
1600 language: self.language.clone(),
1601 query_cursor: QueryCursorHandle::new(),
1602 }
1603 }
1604}
1605
1606impl Deref for Snapshot {
1607 type Target = buffer::Snapshot;
1608
1609 fn deref(&self) -> &Self::Target {
1610 &self.text
1611 }
1612}
1613
1614impl<'a> tree_sitter::TextProvider<'a> for TextProvider<'a> {
1615 type I = ByteChunks<'a>;
1616
1617 fn text(&mut self, node: tree_sitter::Node) -> Self::I {
1618 ByteChunks(self.0.chunks_in_range(node.byte_range()))
1619 }
1620}
1621
1622struct ByteChunks<'a>(rope::Chunks<'a>);
1623
1624impl<'a> Iterator for ByteChunks<'a> {
1625 type Item = &'a [u8];
1626
1627 fn next(&mut self) -> Option<Self::Item> {
1628 self.0.next().map(str::as_bytes)
1629 }
1630}
1631
1632impl<'a> HighlightedChunks<'a> {
1633 pub fn seek(&mut self, offset: usize) {
1634 self.range.start = offset;
1635 self.chunks.seek(self.range.start);
1636 if let Some(highlights) = self.highlights.as_mut() {
1637 highlights
1638 .stack
1639 .retain(|(end_offset, _)| *end_offset > offset);
1640 if let Some((mat, capture_ix)) = &highlights.next_capture {
1641 let capture = mat.captures[*capture_ix as usize];
1642 if offset >= capture.node.start_byte() {
1643 let next_capture_end = capture.node.end_byte();
1644 if offset < next_capture_end {
1645 highlights.stack.push((
1646 next_capture_end,
1647 highlights.highlight_map.get(capture.index),
1648 ));
1649 }
1650 highlights.next_capture.take();
1651 }
1652 }
1653 highlights.captures.set_byte_range(self.range.clone());
1654 }
1655 }
1656
1657 pub fn offset(&self) -> usize {
1658 self.range.start
1659 }
1660
1661 fn update_diagnostic_depths(&mut self, endpoint: DiagnosticEndpoint) {
1662 let depth = match endpoint.severity {
1663 DiagnosticSeverity::ERROR => &mut self.error_depth,
1664 DiagnosticSeverity::WARNING => &mut self.warning_depth,
1665 DiagnosticSeverity::INFORMATION => &mut self.information_depth,
1666 DiagnosticSeverity::HINT => &mut self.hint_depth,
1667 _ => return,
1668 };
1669 if endpoint.is_start {
1670 *depth += 1;
1671 } else {
1672 *depth -= 1;
1673 }
1674 }
1675
1676 fn current_diagnostic_severity(&mut self) -> Option<DiagnosticSeverity> {
1677 if self.error_depth > 0 {
1678 Some(DiagnosticSeverity::ERROR)
1679 } else if self.warning_depth > 0 {
1680 Some(DiagnosticSeverity::WARNING)
1681 } else if self.information_depth > 0 {
1682 Some(DiagnosticSeverity::INFORMATION)
1683 } else if self.hint_depth > 0 {
1684 Some(DiagnosticSeverity::HINT)
1685 } else {
1686 None
1687 }
1688 }
1689}
1690
1691impl<'a> Iterator for HighlightedChunks<'a> {
1692 type Item = HighlightedChunk<'a>;
1693
1694 fn next(&mut self) -> Option<Self::Item> {
1695 let mut next_capture_start = usize::MAX;
1696 let mut next_diagnostic_endpoint = usize::MAX;
1697
1698 if let Some(highlights) = self.highlights.as_mut() {
1699 while let Some((parent_capture_end, _)) = highlights.stack.last() {
1700 if *parent_capture_end <= self.range.start {
1701 highlights.stack.pop();
1702 } else {
1703 break;
1704 }
1705 }
1706
1707 if highlights.next_capture.is_none() {
1708 highlights.next_capture = highlights.captures.next();
1709 }
1710
1711 while let Some((mat, capture_ix)) = highlights.next_capture.as_ref() {
1712 let capture = mat.captures[*capture_ix as usize];
1713 if self.range.start < capture.node.start_byte() {
1714 next_capture_start = capture.node.start_byte();
1715 break;
1716 } else {
1717 let highlight_id = highlights.highlight_map.get(capture.index);
1718 highlights
1719 .stack
1720 .push((capture.node.end_byte(), highlight_id));
1721 highlights.next_capture = highlights.captures.next();
1722 }
1723 }
1724 }
1725
1726 while let Some(endpoint) = self.diagnostic_endpoints.peek().copied() {
1727 if endpoint.offset <= self.range.start {
1728 self.update_diagnostic_depths(endpoint);
1729 self.diagnostic_endpoints.next();
1730 } else {
1731 next_diagnostic_endpoint = endpoint.offset;
1732 break;
1733 }
1734 }
1735
1736 if let Some(chunk) = self.chunks.peek() {
1737 let chunk_start = self.range.start;
1738 let mut chunk_end = (self.chunks.offset() + chunk.len())
1739 .min(next_capture_start)
1740 .min(next_diagnostic_endpoint);
1741 let mut highlight_id = HighlightId::default();
1742 if let Some((parent_capture_end, parent_highlight_id)) =
1743 self.highlights.as_ref().and_then(|h| h.stack.last())
1744 {
1745 chunk_end = chunk_end.min(*parent_capture_end);
1746 highlight_id = *parent_highlight_id;
1747 }
1748
1749 let slice =
1750 &chunk[chunk_start - self.chunks.offset()..chunk_end - self.chunks.offset()];
1751 self.range.start = chunk_end;
1752 if self.range.start == self.chunks.offset() + chunk.len() {
1753 self.chunks.next().unwrap();
1754 }
1755
1756 Some(HighlightedChunk {
1757 text: slice,
1758 highlight_id,
1759 diagnostic: self.current_diagnostic_severity(),
1760 })
1761 } else {
1762 None
1763 }
1764 }
1765}
1766
1767impl QueryCursorHandle {
1768 fn new() -> Self {
1769 QueryCursorHandle(Some(
1770 QUERY_CURSORS
1771 .lock()
1772 .pop()
1773 .unwrap_or_else(|| QueryCursor::new()),
1774 ))
1775 }
1776}
1777
1778impl Deref for QueryCursorHandle {
1779 type Target = QueryCursor;
1780
1781 fn deref(&self) -> &Self::Target {
1782 self.0.as_ref().unwrap()
1783 }
1784}
1785
1786impl DerefMut for QueryCursorHandle {
1787 fn deref_mut(&mut self) -> &mut Self::Target {
1788 self.0.as_mut().unwrap()
1789 }
1790}
1791
1792impl Drop for QueryCursorHandle {
1793 fn drop(&mut self) {
1794 let mut cursor = self.0.take().unwrap();
1795 cursor.set_byte_range(0..usize::MAX);
1796 cursor.set_point_range(Point::zero().to_ts_point()..Point::MAX.to_ts_point());
1797 QUERY_CURSORS.lock().push(cursor)
1798 }
1799}
1800
1801trait ToTreeSitterPoint {
1802 fn to_ts_point(self) -> tree_sitter::Point;
1803 fn from_ts_point(point: tree_sitter::Point) -> Self;
1804}
1805
1806impl ToTreeSitterPoint for Point {
1807 fn to_ts_point(self) -> tree_sitter::Point {
1808 tree_sitter::Point::new(self.row as usize, self.column as usize)
1809 }
1810
1811 fn from_ts_point(point: tree_sitter::Point) -> Self {
1812 Point::new(point.row as u32, point.column as u32)
1813 }
1814}
1815
1816fn contiguous_ranges(
1817 values: impl IntoIterator<Item = u32>,
1818 max_len: usize,
1819) -> impl Iterator<Item = Range<u32>> {
1820 let mut values = values.into_iter();
1821 let mut current_range: Option<Range<u32>> = None;
1822 std::iter::from_fn(move || loop {
1823 if let Some(value) = values.next() {
1824 if let Some(range) = &mut current_range {
1825 if value == range.end && range.len() < max_len {
1826 range.end += 1;
1827 continue;
1828 }
1829 }
1830
1831 let prev_range = current_range.clone();
1832 current_range = Some(value..(value + 1));
1833 if prev_range.is_some() {
1834 return prev_range;
1835 }
1836 } else {
1837 return current_range.take();
1838 }
1839 })
1840}