Struct MultiNodeState 

pub struct MultiNodeState { /* private fields */ }

A document’s CRDT merge state split into one independent Yrs state per top-level node — the durable per-node base of #qnodemerge2.

The legacy whole-doc <hash>.yrs blob reconciles every node against one shared base, so a node’s base can never advance independently and unrelated edits share a single Yrs clock. MultiNodeState instead persists one Yrs state per node (each agent:* component plus the interstitial text around them) in document order, serialized into a single structured container file (<hash>.nodes.yrs). Each node therefore carries its own stable base across cycles: a node untouched this cycle re-encodes to byte-identical state while a changed node’s state advances on its own, with no cross-node contention.

Implementations

impl MultiNodeState

pub fn from_text(text: &str) -> Result<Self>

Build a per-node state by segmenting text into top-level nodes and encoding each node’s text as its own independent Yrs state.

pub fn to_text(&self) -> Result<String>

Reconstruct the full document text by concatenating node texts in order.

pub fn encode(&self) -> Vec<u8>

Serialize into the <hash>.nodes.yrs container format: MAGIC(4) | version(1) | node_count(u32 LE) then per node name_len(u32 LE) | name bytes | state_len(u32 LE) | state bytes, where name_len == u32::MAX marks an interstitial node (no name).

pub fn decode(bytes: &[u8]) -> Result<Self>

Decode a <hash>.nodes.yrs container. Returns an error (never a panic) on a missing magic tag or any truncation, so callers can fall back to migration via MultiNodeState::decode_or_migrate.

pub fn decode_or_migrate(bytes: &[u8], fallback_text: &str) -> Self

Decode bytes as a per-node container, migrating older formats:

1. A <hash>.nodes.yrs container decodes directly.
2. Otherwise treat bytes as a legacy whole-doc <hash>.yrs Yrs state, decode it to text, and split into per-node states.
3. If neither works, fall back to fallback_text.

Never panics; logs the migration path it took.

pub fn merge( base: Option<&MultiNodeState>, ours_text: &str, theirs_text: &str, ) -> Result<(String, MultiNodeState)>

Per-node component-scoped three-way merge (#qnodemerge2).

Like merge_by_component but each node reconciles against its own persisted base (carried in base) rather than a slice of one decoded whole-doc base, and the merged result is returned as a fresh MultiNodeState where each node’s base has advanced independently. An unchanged node re-encodes to byte-identical state.

Falls back to the whole-document merge (against base’s projected text) on structural divergence or a component-less document, preserving the same safety net as merge_by_component.

Trait Implementations

impl Clone for MultiNodeState

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MultiNodeState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MultiNodeState

fn default() -> Self

Returns the “default value” for a type.

impl Eq for MultiNodeState

impl PartialEq for MultiNodeState

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MultiNodeState