Struct Settle 

pub struct Settle { /* private fields */ }

Three-phase model per spec §7, so Plan 2’s renderer and Plan 3’s async swap EXTEND this type instead of rewriting it:

• live — the jittering partial hypothesis (not committed)
• committing — the most recent phrase, shown bright with deterministic-Light, still inside the decode-lag / async-swap window (may be upgraded or take a late STT revision)
• settled — finalized, immutable blocks (never move again)

Implementations

impl Settle

pub fn new() -> Self

pub fn on_partial(&mut self, partial: &str)

A new/revised partial hypothesis for the live edge.

pub fn commit(&mut self, raw: &str, clean: &str)

Endpoint boundary: the live edge becomes the committing block (clean is the deterministic-Light result). Any prior committing block’s window has closed, so it is finalized into settled first.

pub fn finalize(&mut self)

Promote the committing block to settled (its lag/swap window elapsed).

pub fn upgrade_committing(&mut self, clean: &str) -> bool

Plan 3 async LLM swap: replace the committing block’s clean text while still inside its window. No-op (returns false) once finalized — the settled rule wins.

pub fn revise_committing(&mut self, raw: &str, clean: &str) -> bool

Plan 5 second-pass swap: replace BOTH raw and clean of the committing block (a better transcription of the same audio, not a reformat). No-op once finalized — the settled rule wins, exactly like upgrade_committing.

pub fn try_late_revision_settled( &mut self, _index: usize, _new_text: &str, ) -> bool

A late STT revision targeting already-settled text is DROPPED (returns false so the caller can log it to the raw layer).

pub fn settled(&self) -> &[Block]

pub fn committing(&self) -> Option<&Block>

pub fn live(&self) -> &str

pub fn committing_revised(&self) -> bool

True once the committing block has been revised/upgraded (its text is final-quality). Drives the bright-is-final rendering: dim until revised.

Trait Implementations

impl Default for Settle

fn default() -> Settle

Returns the “default value” for a type.