Skip to main content

CollaborativeDocument

Struct CollaborativeDocument 

Source
pub struct CollaborativeDocument { /* private fields */ }
Expand description

A collaborative rich text document backed by CRDTs.

This is the main entry point for document editing. All operations are conflict-free and can be merged with remote changes.

Implementations§

Source§

impl CollaborativeDocument

Source

pub fn new(doc_id: &str, replica_id: &str) -> Self

Create a new collaborative document.

§Arguments
  • doc_id - Unique identifier for this document
  • replica_id - Unique identifier for this replica/user
Source

pub fn insert(&mut self, position: usize, text: &str)

Insert text at a position.

§Arguments
  • position - Character index to insert at (0-based)
  • text - Text to insert
Source

pub fn delete(&mut self, position: usize, length: usize)

Delete text at a position.

§Arguments
  • position - Starting character index (0-based)
  • length - Number of characters to delete
Source

pub fn apply_bold(&mut self, start: usize, end: usize)

Apply bold formatting to a range.

§Arguments
  • start - Starting character index (inclusive)
  • end - Ending character index (exclusive)
Source

pub fn apply_italic(&mut self, start: usize, end: usize)

Apply italic formatting to a range.

Source

pub fn apply_underline(&mut self, start: usize, end: usize)

Apply underline formatting to a range.

Source

pub fn apply_strikethrough(&mut self, start: usize, end: usize)

Apply strikethrough formatting to a range.

Source

pub fn apply_code(&mut self, start: usize, end: usize)

Apply inline code formatting to a range.

Apply a link to a range.

§Arguments
  • start - Starting character index (inclusive)
  • end - Ending character index (exclusive)
  • url - The URL to link to
Source

pub fn apply_highlight(&mut self, start: usize, end: usize, color: &str)

Apply a highlight color to a range.

§Arguments
  • start - Starting character index (inclusive)
  • end - Ending character index (exclusive)
  • color - CSS color string (e.g., “#FFEAA7”)
Source

pub fn apply_comment( &mut self, start: usize, end: usize, author: &str, content: &str, )

Apply a comment annotation to a range.

§Arguments
  • start - Starting character index (inclusive)
  • end - Ending character index (exclusive)
  • author - Comment author name/id
  • content - Comment body
Source

pub fn apply_custom_mark( &mut self, start: usize, end: usize, name: &str, value: &str, )

Apply a custom formatting mark to a range.

§Arguments
  • start - Starting character index (inclusive)
  • end - Ending character index (exclusive)
  • name - Custom mark name
  • value - Custom mark value
Source

pub fn get_text(&self) -> String

Get the plain text content (without formatting).

Source

pub fn get_html(&self) -> String

Get the content as HTML with formatting applied.

Source

pub fn len(&self) -> usize

Get the document length in characters.

Source

pub fn is_empty(&self) -> bool

Check if the document is empty.

Source

pub fn version(&self) -> u64

Get the current version number.

This increments with each local operation and can be used to track changes for sync purposes.

Source

pub fn doc_id(&self) -> String

Get the document ID.

Source

pub fn replica_id(&self) -> String

Get the replica ID.

Source

pub fn serialize(&self) -> Result<String, JsValue>

Serialize the document state for sync.

Returns a base64-encoded binary string that can be sent to other replicas. Binary format is more efficient and handles complex key types.

Source

pub fn merge(&mut self, remote_state: &str) -> Result<(), JsValue>

Merge remote state into this document.

This is the core CRDT operation - merging is commutative, associative, and idempotent, so the order of merges doesn’t matter.

§Arguments
  • remote_state - JSON string from another replica’s serialize()
Source

pub fn snapshot(&self) -> Result<JsValue, JsValue>

Create a snapshot of the current state.

This returns a JSON object with full document state.

Source

pub fn restore(snapshot_js: JsValue) -> Result<CollaborativeDocument, JsValue>

Restore from a snapshot.

Trait Implementations§

Source§

impl From<CollaborativeDocument> for JsValue

Source§

fn from(value: CollaborativeDocument) -> Self

Converts to this type from the input type.
Source§

impl FromWasmAbi for CollaborativeDocument

Source§

type Abi = u32

The Wasm ABI type that this converts from when coming back out from the ABI boundary.
Source§

unsafe fn from_abi(js: u32) -> Self

Recover a Self from Self::Abi. Read more
Source§

impl IntoWasmAbi for CollaborativeDocument

Source§

type Abi = u32

The Wasm ABI type that this converts into when crossing the ABI boundary.
Source§

fn into_abi(self) -> u32

Convert self into Self::Abi so that it can be sent across the wasm ABI boundary.
Source§

impl LongRefFromWasmAbi for CollaborativeDocument

Source§

type Abi = u32

Same as RefFromWasmAbi::Abi
Source§

type Anchor = RcRef<CollaborativeDocument>

Same as RefFromWasmAbi::Anchor
Source§

unsafe fn long_ref_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi
Source§

impl OptionFromWasmAbi for CollaborativeDocument

Source§

fn is_none(abi: &Self::Abi) -> bool

Tests whether the argument is a “none” instance. If so it will be deserialized as None, and otherwise it will be passed to FromWasmAbi.
Source§

impl OptionIntoWasmAbi for CollaborativeDocument

Source§

fn none() -> Self::Abi

Returns an ABI instance indicating “none”, which JS will interpret as the None branch of this option. Read more
Source§

impl RefFromWasmAbi for CollaborativeDocument

Source§

type Abi = u32

The Wasm ABI type references to Self are recovered from.
Source§

type Anchor = RcRef<CollaborativeDocument>

The type that holds the reference to Self for the duration of the invocation of the function that has an &Self parameter. This is required to ensure that the lifetimes don’t persist beyond one function call, and so that they remain anonymous.
Source§

unsafe fn ref_from_abi(js: Self::Abi) -> Self::Anchor

Recover a Self::Anchor from Self::Abi. Read more
Source§

impl RefMutFromWasmAbi for CollaborativeDocument

Source§

type Abi = u32

Same as RefFromWasmAbi::Abi
Source§

type Anchor = RcRefMut<CollaborativeDocument>

Same as RefFromWasmAbi::Anchor
Source§

unsafe fn ref_mut_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi
Source§

impl TryFromJsValue for CollaborativeDocument

Source§

fn try_from_js_value(value: JsValue) -> Result<Self, JsValue>

Performs the conversion.
Source§

fn try_from_js_value_ref(value: &JsValue) -> Option<Self>

Performs the conversion.
Source§

impl VectorFromWasmAbi for CollaborativeDocument

Source§

impl VectorIntoWasmAbi for CollaborativeDocument

Source§

impl WasmDescribe for CollaborativeDocument

Source§

impl WasmDescribeVector for CollaborativeDocument

Source§

impl SupportsConstructor for CollaborativeDocument

Source§

impl SupportsInstanceProperty for CollaborativeDocument

Source§

impl SupportsStaticProperty for CollaborativeDocument

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ReturnWasmAbi for T
where T: IntoWasmAbi,

Source§

type Abi = <T as IntoWasmAbi>::Abi

Same as IntoWasmAbi::Abi
Source§

fn return_abi(self) -> <T as ReturnWasmAbi>::Abi

Same as IntoWasmAbi::into_abi, except that it may throw and never return in the case of Err.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V