oxide_core 0.4.0

Rust engine primitives for Oxide (store, snapshot streams, error model, optional persistence).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

use std::sync::OnceLock;

use crate::engine::{CoreResult, OxideError};
use crate::engine::navigation_runtime::NavigationRuntime;

static NAVIGATION: OnceLock<NavigationRuntime> = OnceLock::new();

/// Initializes the global navigation runtime.
///
/// Why: navigation relies on a runtime singleton that can be reached from reducers/effects
/// and from FRB endpoints. Initialization is explicit so applications control startup order.
pub fn init_navigation() -> CoreResult<()> {
    let _ = NAVIGATION.get_or_init(NavigationRuntime::new);
    Ok(())
}

/// Returns the global navigation runtime if initialized.
pub fn navigation_runtime() -> CoreResult<&'static NavigationRuntime> {
    NAVIGATION.get().ok_or_else(|| OxideError::Validation {
        message: "navigation runtime not initialized; call init_navigation() (or init_engine_globals()) first".into(),
    })
}