Struct Reveal 

pub struct Reveal { /* private fields */ }

A paced cursor over streamed units — grapheme clusters, rows, blocks — that chases a growing total and settles once even with it.

Unlike the phase-arithmetic shapes, this is an integrator: each advance moves an internal cursor forward, in two regimes. While the backlog exceeds one horizon’s worth of the floor rate it decays exponentially with e-folding time horizon, so a bursty producer accelerates the reveal instead of queueing behind it; the remainder drains linearly at Reveal::MIN_RATE units per second, so the tail types out steadily rather than slowing asymptotically.

Progress per sample is capped at one FRAME of elapsed time, so the cursor follows frames actually observed — like a fixed-cadence interval timer. Stale paint clocks, stalled hosts, idle gaps, and a settled cursor awaiting more content all resume at the frame cadence instead of jumping. <text> consumes this declaratively through the reveal property — see crate::Props::reveal.

Implementations

impl Reveal

pub const MIN_RATE: f32 = 90.0

Floor reveal rate in units per second (3 per 33 ms frame).

pub const fn new() -> Self

A cursor with nothing revealed and the clock disarmed.

pub fn advance( &mut self, now: Duration, total: usize, horizon: Duration, ) -> usize

Advances the cursor toward total at now and returns the whole units revealed. A zero horizon snaps to total; a total below the cursor clamps it down (content shrank in place).

pub const fn reset(&mut self)

Restarts from nothing — the content was replaced, not extended.

pub fn is_settled(&self, total: usize) -> bool

Whether the cursor has caught up with total.

Trait Implementations

impl Clone for Reveal

fn clone(&self) -> Reveal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Reveal

impl Debug for Reveal

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

Formats the value using the given formatter.

impl Default for Reveal

fn default() -> Reveal

Returns the “default value” for a type.