Struct TransitionState 

pub struct TransitionState {
    pub active: bool,
    pub progress: f64,
    pub is_pop: bool,
    pub interactive: bool,
    pub from_depth: usize,
    pub to_depth: usize,
    pub generation: u32,
}

A snapshot of the navigator’s single in-flight page transition, published by NavigatorWidget and read through NavigatorController::transition.

Plain Copy data — Send + Sync by construction (every field is a primitive), so an app may mirror it into an RwSignal, hand it across provide_context, or read it directly. frust-widgets stays reactive-free: the navigator publishes this into a plain Rc<Cell<TransitionState>>, exactly as it publishes depth; any signal bridging is the facade’s job.

Timing

The full read-timing contract (which pass sees an exact value and which sees a one-frame-stale one) is documented on NavigatorController::transition — read it before choreographing anything against progress.

Fields

active: bool

Whether a page transition is in flight right now.

progress: f64

The RAW driver value, 0.0 → 1.0. A spatial spring genuinely overshoots past 1.0 (see the module docs’ overshoot note) — use clamped for anything driving opacity.

is_pop: bool

true when the transition runs backwards (a pop or an interactive edge-swipe back); false for a push/replace.

interactive: bool

An interactive edge-swipe is holding the progress (the drag pins it between frames rather than a driver advancing it). Cleared when the swipe is released into its settle spring.

from_depth: usize

The page-stack depth the transition is leaving.

to_depth: usize

The page-stack depth the transition is arriving at. Always the navigator’s current pages.len() — a push/pop/replace mutates the stack up front and animates afterwards, so the stack is the destination from the first frame.

generation: u32

Bumped once per transition started. Distinguishes “the same transition, later” from “a new transition at the same progress” — the discriminator a chrome observer needs to reset its own per-transition state. Wraps.

Implementations

impl TransitionState

pub const fn settled(depth: usize, generation: u32) -> TransitionState

The at-rest snapshot for a settled stack of depth pages: nothing in flight, from_depth == to_depth == depth.

progress is 1.0 — “fully arrived”. With from_depth == to_depth the value is degenerate (both endpoints are the same stack), so a reader that ignores active still sees the destination rather than a jump back to the origin.

pub fn clamped(&self) -> f64

progress clamped to [0.0, 1.0] — the value to drive opacity (or any other bounded quantity) with, since a spatial spring’s raw progress overshoots.

Trait Implementations

impl Clone for TransitionState

fn clone(&self) -> TransitionState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TransitionState

impl Debug for TransitionState

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

Formats the value using the given formatter.

impl Default for TransitionState

fn default() -> TransitionState

The at-rest snapshot of an empty stack — what a NavigatorController reads before any navigator attaches to it.

impl PartialEq for TransitionState

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TransitionState