document.rs 6.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205
  1. use crate::{
  2. document::{
  3. default::initial_delta,
  4. history::{History, UndoResult},
  5. view::{View, RECORD_THRESHOLD},
  6. },
  7. errors::CollaborateError,
  8. };
  9. use lib_ot::{
  10. core::*,
  11. rich_text::{RichTextAttribute, RichTextDelta},
  12. };
  13. use tokio::sync::mpsc;
  14. pub trait InitialDocumentText {
  15. fn initial_delta() -> RichTextDelta;
  16. }
  17. pub struct PlainDoc();
  18. impl InitialDocumentText for PlainDoc {
  19. fn initial_delta() -> RichTextDelta { RichTextDelta::new() }
  20. }
  21. pub struct NewlineDoc();
  22. impl InitialDocumentText for NewlineDoc {
  23. fn initial_delta() -> RichTextDelta { initial_delta() }
  24. }
  25. pub struct Document {
  26. delta: RichTextDelta,
  27. history: History,
  28. view: View,
  29. last_edit_time: usize,
  30. notify: Option<mpsc::UnboundedSender<()>>,
  31. }
  32. impl Document {
  33. pub fn new<C: InitialDocumentText>() -> Self { Self::from_delta(C::initial_delta()) }
  34. pub fn from_delta(delta: RichTextDelta) -> Self {
  35. Document {
  36. delta,
  37. history: History::new(),
  38. view: View::new(),
  39. last_edit_time: 0,
  40. notify: None,
  41. }
  42. }
  43. pub fn from_json(json: &str) -> Result<Self, CollaborateError> {
  44. let delta = RichTextDelta::from_json(json)?;
  45. Ok(Self::from_delta(delta))
  46. }
  47. pub fn to_json(&self) -> String { self.delta.to_json() }
  48. pub fn to_bytes(&self) -> Vec<u8> { self.delta.clone().to_bytes().to_vec() }
  49. pub fn to_plain_string(&self) -> String { self.delta.apply("").unwrap() }
  50. pub fn delta(&self) -> &RichTextDelta { &self.delta }
  51. pub fn md5(&self) -> String {
  52. // TODO: Optimize the cost of calculating the md5
  53. let bytes = self.to_bytes();
  54. format!("{:x}", md5::compute(bytes))
  55. }
  56. pub fn set_notify(&mut self, notify: mpsc::UnboundedSender<()>) { self.notify = Some(notify); }
  57. pub fn set_delta(&mut self, data: RichTextDelta) {
  58. tracing::trace!("document: {}", data.to_json());
  59. self.delta = data;
  60. match &self.notify {
  61. None => {},
  62. Some(notify) => {
  63. let _ = notify.send(());
  64. },
  65. }
  66. }
  67. pub fn compose_delta(&mut self, delta: RichTextDelta) -> Result<(), CollaborateError> {
  68. tracing::trace!("{} compose {}", &self.delta.to_json(), delta.to_json());
  69. let composed_delta = self.delta.compose(&delta)?;
  70. let mut undo_delta = delta.invert(&self.delta);
  71. let now = chrono::Utc::now().timestamp_millis() as usize;
  72. if now - self.last_edit_time < RECORD_THRESHOLD {
  73. if let Some(last_delta) = self.history.undo() {
  74. tracing::trace!("compose previous change");
  75. tracing::trace!("current = {}", undo_delta);
  76. tracing::trace!("previous = {}", last_delta);
  77. undo_delta = undo_delta.compose(&last_delta)?;
  78. }
  79. } else {
  80. self.last_edit_time = now;
  81. }
  82. if !undo_delta.is_empty() {
  83. tracing::trace!("add history delta: {}", undo_delta);
  84. self.history.record(undo_delta);
  85. }
  86. self.set_delta(composed_delta);
  87. Ok(())
  88. }
  89. pub fn insert<T: ToString>(&mut self, index: usize, data: T) -> Result<RichTextDelta, CollaborateError> {
  90. let text = data.to_string();
  91. let interval = Interval::new(index, index);
  92. let _ = validate_interval(&self.delta, &interval)?;
  93. let delta = self.view.insert(&self.delta, &text, interval)?;
  94. self.compose_delta(delta.clone())?;
  95. Ok(delta)
  96. }
  97. pub fn delete(&mut self, interval: Interval) -> Result<RichTextDelta, CollaborateError> {
  98. let _ = validate_interval(&self.delta, &interval)?;
  99. debug_assert_eq!(interval.is_empty(), false);
  100. let delete = self.view.delete(&self.delta, interval)?;
  101. if !delete.is_empty() {
  102. let _ = self.compose_delta(delete.clone())?;
  103. }
  104. Ok(delete)
  105. }
  106. pub fn format(
  107. &mut self,
  108. interval: Interval,
  109. attribute: RichTextAttribute,
  110. ) -> Result<RichTextDelta, CollaborateError> {
  111. let _ = validate_interval(&self.delta, &interval)?;
  112. tracing::trace!("format {} with {}", interval, attribute);
  113. let format_delta = self.view.format(&self.delta, attribute, interval).unwrap();
  114. self.compose_delta(format_delta.clone())?;
  115. Ok(format_delta)
  116. }
  117. pub fn replace<T: ToString>(&mut self, interval: Interval, data: T) -> Result<RichTextDelta, CollaborateError> {
  118. let _ = validate_interval(&self.delta, &interval)?;
  119. let mut delta = RichTextDelta::default();
  120. let text = data.to_string();
  121. if !text.is_empty() {
  122. delta = self.view.insert(&self.delta, &text, interval)?;
  123. self.compose_delta(delta.clone())?;
  124. }
  125. if !interval.is_empty() {
  126. let delete = self.delete(interval)?;
  127. delta = delta.compose(&delete)?;
  128. }
  129. Ok(delta)
  130. }
  131. pub fn can_undo(&self) -> bool { self.history.can_undo() }
  132. pub fn can_redo(&self) -> bool { self.history.can_redo() }
  133. pub fn undo(&mut self) -> Result<UndoResult, CollaborateError> {
  134. match self.history.undo() {
  135. None => Err(CollaborateError::undo().context("Undo stack is empty")),
  136. Some(undo_delta) => {
  137. let (new_delta, inverted_delta) = self.invert(&undo_delta)?;
  138. self.set_delta(new_delta);
  139. self.history.add_redo(inverted_delta);
  140. Ok(UndoResult { delta: undo_delta })
  141. },
  142. }
  143. }
  144. pub fn redo(&mut self) -> Result<UndoResult, CollaborateError> {
  145. match self.history.redo() {
  146. None => Err(CollaborateError::redo()),
  147. Some(redo_delta) => {
  148. let (new_delta, inverted_delta) = self.invert(&redo_delta)?;
  149. self.set_delta(new_delta);
  150. self.history.add_undo(inverted_delta);
  151. Ok(UndoResult { delta: redo_delta })
  152. },
  153. }
  154. }
  155. pub fn is_empty<C: InitialDocumentText>(&self) -> bool { self.delta == C::initial_delta() }
  156. }
  157. impl Document {
  158. fn invert(&self, delta: &RichTextDelta) -> Result<(RichTextDelta, RichTextDelta), CollaborateError> {
  159. // c = a.compose(b)
  160. // d = b.invert(a)
  161. // a = c.compose(d)
  162. let new_delta = self.delta.compose(delta)?;
  163. let inverted_delta = delta.invert(&self.delta);
  164. Ok((new_delta, inverted_delta))
  165. }
  166. }
  167. fn validate_interval(delta: &RichTextDelta, interval: &Interval) -> Result<(), CollaborateError> {
  168. if delta.utf16_target_len < interval.end {
  169. log::error!("{:?} out of bounds. should 0..{}", interval, delta.utf16_target_len);
  170. return Err(CollaborateError::out_of_bound());
  171. }
  172. Ok(())
  173. }