Enum Resolution 

pub enum Resolution<State>
where
    State: 'static,
{
    Matched {
        location: Location,
        params: BTreeMap<String, String>,
        pages: Vec<ResolvedPage<State>>,
    },
    Error {
        location: Location,
    },
}

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 outcome of Router::resolve: either a matched chain of pages (with the final resolved location and merged params) or an error fallback.

Variants

Matched

The location matched a route chain. pages is the chain root→leaf; for a flat route it holds a single page. params is the merged param map (the location’s query merged under the path captures — a capture wins a name collision), location the final (post-redirect) location.

Fields

location: Location

params: BTreeMap<String, String>

pages: Vec<ResolvedPage<State>>

Error

No route matched (or a redirect loop exceeded the limit); the caller falls back to the router’s error_builder.

Fields

location: Location

Implementations

impl<State> Resolution<State>

where State: 'static,

pub fn is_matched(&self) -> bool

Whether this resolution matched a route (vs. the error fallback).

pub fn params(&self) -> BTreeMap<String, String>

The merged params (query under path captures), or an empty map for an error resolution.

pub fn page_count(&self) -> usize

The number of pages in a matched chain (0 for an error resolution).