document.rs 6.3 KB

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