Struct RouteStack 

pub struct RouteStack { /* private fields */ }

The declarative router vocabulary (a go_router-subset layer), flat-re-exported from frust-widgets so app code never names that crate directly: Router resolves a location against a Route table (built via RouteBuilder) into Resolution/ResolvedPages driving a NavigatorController, with :param/query parsing (Location/PathPattern/RouteParams), per-route/top-level Redirects (loop-guarded at DEFAULT_REDIRECT_LIMIT), and an ErrorBuilder fallback for an unmatched location.

A page builder receives the location’s query merged under its path captures, so /terminal?session=abc reads its own parameter.

RouteNavigator is the seam a screen navigates through: a Send + Sync queue of NavRequest data (paths and names, never closures) that rides provide_context — the Router itself cannot, since it holds Rc page builders. RouterDeepLinks::track drains it every rebuild, so a request queued in an event handler (on any thread — the queue never panics off-thread) applies on the next frame.

shell_route is the nested-navigator binding: its children resolve onto a second NavigatorController the app owns and its own page — the chrome wrapping that inner navigator — stays retained while they do, so navigating between siblings inside the shell never rebuilds the chrome. See its docs for the keep rule and the per-verb table. The page stack as route identities, bottom→top. None at an index means that page was pushed as a bare builder (an overlay/dialog): it carries no location, and it must never retitle route-derived chrome — see the module docs.

Cloned out of NavigatorController::route_stack — a snapshot, not a live handle. See the module docs’ staleness contract for what “authoritative-at-publish” does and does not promise.

Implementations

impl RouteStack

pub fn entries(&self) -> &[Option<Location>]

Every page’s route identity, bottom→top. None at an index is a route-less (overlay/dialog) page — see the module docs.

pub fn depth(&self) -> usize

The stack depth (page count) as of this publish.

pub fn current(&self) -> Option<&Location>

The topmost page’s route identity, None if it has none (an overlay/dialog on top). Chrome that needs to skip a route-less top wants current_route instead.

pub fn current_route(&self) -> Option<&Location>

The topmost page that has a route, skipping any route-less (overlay/dialog) pages above it — the read chrome (an app bar’s title, e.g.) wants, so a transparent overlay never retitles it. None only if no page in the stack carries a route at all.

pub fn generation(&self) -> u64

A monotonically increasing counter, bumped once per actual publish (an unchanged stack across N rebuilds bumps it zero times) — an O(1) change gate for a consumer that only wants to know “did anything happen since I last looked?” without comparing entries itself.

pub fn change(&self) -> NavChange

A diff label for this generation — not a running direction; see NavChange.

Trait Implementations

impl Clone for RouteStack

fn clone(&self) -> RouteStack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RouteStack

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

Formats the value using the given formatter.

impl Default for RouteStack

fn default() -> RouteStack

Returns the “default value” for a type.

impl Eq for RouteStack

impl PartialEq for RouteStack

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RouteStack