Struct PresentationLifecycle

Source

pub struct PresentationLifecycle { /* private fields */ }

Expand description

Pure retained lifecycle model for one logical window.

The logical ID survives suspension and attachment generations. The type owns no native resource and can be cloned for deterministic state inspection.

§Examples

use ailloli_ui_runtime::app::{PresentationGeneration, PresentationLifecycle, PresentationState};
let lifecycle = PresentationLifecycle::new("main");
assert_eq!(lifecycle.logical_window_id().as_str(), "main");
assert_eq!(lifecycle.state(), PresentationState::Declared);
assert_eq!(lifecycle.generation(), PresentationGeneration::INITIAL);

Implementations§

Source §

impl PresentationLifecycle

Provides the operations defined for PresentationLifecycle.

Source

pub fn new(logical_window_id: impl Into<LogicalWindowId>) -> Self

Creates a declared logical window at generation zero.

The ID is stored exactly by [LogicalWindowId]; empty IDs are representable at this layer and host declaration logic owns uniqueness.

§Examples

use ailloli_ui_runtime::app::{PresentationGeneration, PresentationLifecycle, PresentationState};
let lifecycle = PresentationLifecycle::new(String::from("settings"));
assert_eq!(lifecycle.state(), PresentationState::Declared);
assert_eq!(lifecycle.generation(), PresentationGeneration::INITIAL);

Source

pub fn logical_window_id(&self) -> &LogicalWindowId

Borrows the stable logical-window identifier.

§Examples

use ailloli_ui_runtime::app::PresentationLifecycle;
let lifecycle = PresentationLifecycle::new("main");
assert_eq!(lifecycle.logical_window_id().as_str(), "main");

Source

pub const fn state(&self) -> PresentationState

Returns the current lifecycle state.

§Examples

use ailloli_ui_runtime::app::{PresentationLifecycle, PresentationState};
assert_eq!(PresentationLifecycle::new("main").state(), PresentationState::Declared);

Source

pub const fn generation(&self) -> PresentationGeneration

Returns the current native-attachment generation.

§Examples

use ailloli_ui_runtime::app::{PresentationGeneration, PresentationLifecycle};
assert_eq!(PresentationLifecycle::new("main").generation(), PresentationGeneration::INITIAL);

Source

pub fn accepts(&self, generation: PresentationGeneration) -> bool

Returns whether events from generation belong to the ready presentation.

Matching generations are rejected unless state is exactly PresentationState::Ready, preventing stale events during suspension, recreation, or destruction.

§Examples

use ailloli_ui_runtime::app::{PresentationEvent, PresentationGeneration, PresentationLifecycle};
let mut lifecycle = PresentationLifecycle::new("main");
assert!(!lifecycle.accepts(PresentationGeneration::INITIAL));
lifecycle.apply(PresentationEvent::AllowCreation)?;
lifecycle.apply(PresentationEvent::Attached)?;
assert!(lifecycle.accepts(PresentationGeneration::new(1)));

Source

pub fn apply( &mut self, event: PresentationEvent, ) -> Result<PresentationReduction, PresentationTransitionError>

Applies one pure reducer event and commits it only on success.

§Errors

Returns the same errors as reduce_presentation. State and generation remain unchanged when reduction fails.

§Examples

use ailloli_ui_runtime::app::{PresentationEvent, PresentationGeneration, PresentationLifecycle, PresentationState};
let mut lifecycle = PresentationLifecycle::new("main");
lifecycle.apply(PresentationEvent::AllowCreation)?;
let attached = lifecycle.apply(PresentationEvent::Attached)?;
assert_eq!(lifecycle.state(), PresentationState::Ready);
assert_eq!(attached.generation, PresentationGeneration::new(1));