Struct CommitBuilder 

pub struct CommitBuilder {
    label: String,
    ops: Vec<OpCodes>,
}

Accumulates one gesture’s ops into a sealed Commit. Push order is preserved verbatim — an op’s index is its Seq in the total write order, so the builder’s order is the merge-relevant order (and a pasted group’s internal stacking). Sealing consumes the builder, so a commit cannot be extended after the fact, and a gesture that edited nothing seals to None and submits nothing.

Deliberately blind to the document: dropping a non-edit (an update equal to what the document already holds) is the push site’s job — the op emitters can compare against the document, the builder cannot.

Fields

label: String

ops: Vec<OpCodes>

Implementations

impl CommitBuilder

pub fn new(label: impl Into<String>) -> Self

Start a gesture under its semantic label — a command’s stable name where a command triggered the edit, a tool-authored string otherwise.

pub fn push(&mut self, op: OpCodes)

Append one op; its position becomes its Seq.

pub fn extend(&mut self, ops: impl IntoIterator<Item = OpCodes>)

Append a run of ops in order, as Self::push would one by one.

pub fn ops(&self) -> &[OpCodes]

What the gesture has pushed so far, without sealing. The one reader is a gesture that must see its own effect before it finishes — a solver rider folds these onto a scratch prediction, solves against it, and pushes the result here in turn.

pub fn seal(self) -> Option<Commit>

Seal the gesture: None when nothing was pushed, else the commit with the ops exactly as pushed.

Trait Implementations

impl Debug for CommitBuilder

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

Formats the value using the given formatter.