Struct StateLayout 

pub struct StateLayout { /* private fields */ }

Complete ordered mutable-state geometry owned by one model instance.

Implementations

impl StateLayout

pub fn new(layers: LayerSchedule<LayerCachePolicy>) -> Result<Self, StateError>

Creates and validates a simple ordered layout with one persistent segment named DEFAULT_STATE_SEGMENT_ID.

pub fn segmented( layers: LayerSchedule<LayerCachePolicy>, segments: impl IntoIterator<Item = StateSegmentSpec>, ) -> Result<Self, StateError>

Creates an ordered layout partitioned into named contiguous segments.

Segment declarations are sorted into layer order and must form an exact, non-overlapping partition of every state-bearing layer. Stable segment identity and lifetime therefore participate in layout equality and runtime-state compatibility checks.

pub fn len(&self) -> usize

Returns the number of architecture-global layers represented here.

pub fn logical_metadata_bytes(&self) -> Option<u64>

Logical host storage copied with this complete layout, including nested component shapes and segment names. Allocator capacity/overhead is excluded. None means checked size arithmetic overflowed, never zero storage.

pub fn is_empty(&self) -> bool

Returns whether this layout has no layers.

pub fn layer(&self, layer: usize) -> Option<&LayerCachePolicy>

Returns one layer’s exact state policy.

pub const fn layers(&self) -> &LayerSchedule<LayerCachePolicy>

Borrows the portable ordered layer schedule.

pub fn components(&self, layer: usize) -> Option<&[StateComponentPolicy]>

Returns ordered named semantic components for one layer.

pub fn segments(&self) -> &[StateSegmentSpec]

Returns named state segments in deterministic layer order.

pub fn segment(&self, id: &StateSegmentId) -> Option<&StateSegmentSpec>

Resolves one named state segment.

pub fn segment_for_layer(&self, layer: usize) -> Option<&StateSegmentSpec>

Resolves the unique named segment containing one state layer.

pub fn layer_prefix_offsets(&self) -> Vec<i32>

Expands architecture-declared segment frontiers into layer order.

pub fn slice(&self, layers: Range<usize>) -> Result<Self, StateError>

Selects a contiguous architecture-global range while preserving the intersecting segment identities, lifetimes, and token frontiers.

Trait Implementations

impl Clone for StateLayout

fn clone(&self) -> StateLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateLayout

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

Formats the value using the given formatter.

impl Eq for StateLayout

impl PartialEq for StateLayout

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StateLayout