Struct SpecCache 

pub struct SpecCache { /* private fields */ }

A persistent dirty-fingerprint cache for WidgetSpec lists.

Owns the per-frame fingerprints across rebuilds so that frame-to-frame changes can be detected even though IcedUiCtx is consumed each frame.

Design note

iced Element values are not Clone, so elements themselves cannot be cached — every frame rebuilds the tree. SpecCache tracks whether a rebuild was triggered by real spec changes, which is useful for diagnostics and future optimisation work (e.g. skipping work upstream of the iced build step).

Example

use std::borrow::Cow;
use oxiui_iced::adapter::{WidgetSpec, SpecCache};

let mut cache = SpecCache::default();
let specs = vec![WidgetSpec::Label(Cow::Borrowed("hello"))];
let changed = cache.sync(&specs);
assert!(changed, "first sync always marks a change");
assert_eq!(cache.rebuild_count(), 1);

let changed2 = cache.sync(&specs);
assert!(!changed2, "identical specs do not trigger a rebuild");
assert_eq!(cache.rebuild_count(), 1);

Implementations

impl SpecCache

pub fn sync(&mut self, specs: &[WidgetSpec]) -> bool

Compare specs against the cached fingerprints.

Returns true if the spec list has changed since the last call (length changed, or any fingerprint differs), and increments rebuild_count by one.

Returns false when the specs are identical to the last call; the rebuild count is not incremented.

pub fn rebuild_count(&self) -> usize

Return the total number of rebuilds recorded since creation.

A “rebuild” is one call to sync that detected a change.

Trait Implementations

impl Clone for SpecCache

fn clone(&self) -> SpecCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpecCache

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

Formats the value using the given formatter.

impl Default for SpecCache

fn default() -> SpecCache

Returns the “default value” for a type.