Struct Route 

pub struct Route<State>
where
    State: 'static,
{ /* 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. One entry in a Router’s route table: a path pattern, a page builder, and optional name, per-route redirect, and nested children. Built fluently — Route::new then .name/.redirect/.child/.children.

Nested children’s patterns compose with this route’s (go_router semantics): a route /users with a child :id matches /users/42, and the matched chain is [/users, /users/:id].

Implementations

impl<State> Route<State>

where State: 'static,

pub fn new( path: impl Into<String>, builder: impl Fn(&BTreeMap<String, String>) -> AnyView<State> + 'static, ) -> Route<State>

A route matching path (a pattern like /users/:id, or a relative child path like :id), rendered by builder.

pub fn name(self, name: impl Into<String>) -> Route<State>

Give this route a name for go_named/ push_named resolution.

pub fn redirect( self, redirect: impl Fn(&Location) -> Option<String> + 'static, ) -> Route<State>

Attach a per-route redirect, consulted (against the resolved location) whenever this route is part of a matched chain.

pub fn child(self, child: Route<State>) -> Route<State>

Add one nested child route (its path composes with this route’s).

pub fn children(self, children: Vec<Route<State>>) -> Route<State>

Replace this route’s child list.