Struct BuildContext 

pub struct BuildContext { /* private fields */ }

A scoped build context. Cloning a context keeps the same consumer identity; BuildContext::for_consumer creates a distinct dependency owner.

Implementations

impl BuildContext

pub fn new() -> Self

Creates an empty root context with a fresh dependency consumer.

pub fn for_consumer(consumer: ConsumerId) -> Self

Creates an empty root context for a caller-owned consumer identity.

pub fn for_related_consumer(&self, consumer: ConsumerId) -> Self

Creates another dependency owner that observes the same retained inherited environment and shares this context’s dependency tracker.

pub fn boundary_for_consumer(&self, consumer: ConsumerId) -> Self

Creates an explicit inherited lookup boundary for another consumer. Values above this point are not visible, while dependency invalidation remains in the same retained-tree tracker.

pub const fn consumer_id(&self) -> ConsumerId

Returns the identity used for dependency invalidation.

pub fn child(&self) -> Self

Creates a child environment. Values in the child shadow values in its parent while keeping the same dependency tracker and consumer.

pub fn provide<T: Any>(&self, value: T) -> Self

Creates a child context with one inherited value.

pub fn insert<T: Any>(&self, value: T) -> bool

Inserts or replaces a value in this environment. Existing consumers that watched this type are marked dirty when the value changes.

pub fn set<T: Any + PartialEq>(&self, value: T) -> bool

Replaces a value only when its PartialEq value changed.

pub fn remove<T: Any>(&self) -> bool

Removes a value from this environment.

pub fn contains<T: Any>(&self) -> bool

pub fn revision(&self) -> u64

pub fn read<T: Any + Clone>(&self) -> Option<T>

Reads an inherited value without recording a dependency.

pub fn get<T: Any + Clone>(&self) -> Option<T>

Alias for BuildContext::read.

pub fn read_shared<T: Any>(&self) -> Option<Rc<T>>

Reads an inherited value as shared ownership without recording a dependency.

pub fn depend<T: Any + Clone>(&self) -> Option<T>

Reads a value and records the environment lookup as a dependency.

pub fn depend_shared<T: Any>(&self) -> Option<Rc<T>>

Reads a shared inherited value while recording the dependency without cloning the value itself.

pub fn watch<T: Any + Clone>(&self) -> Option<T>

Alias for BuildContext::depend, matching reactive UI terminology.

pub fn enter(&self) -> ContextGuard

Enters this context as the active build scope. Signal reads made while the guard is alive are associated with this context’s consumer.

pub fn scope(&self) -> ContextGuard

Alias for BuildContext::enter.

pub fn build<R>(&self, callback: impl FnOnce(&BuildContext) -> R) -> R

Clears old dependencies, enters the build scope, and invokes the callback. This is the normal runtime integration point.

pub fn run<R>(&self, callback: impl FnOnce() -> R) -> R

Runs a closure in a fresh dependency collection. Use BuildContext::build when the callback needs the context as an argument.

pub fn with_context<R>(&self, callback: impl FnOnce(&BuildContext) -> R) -> R

Alias for BuildContext::build.

pub fn clear_dependencies(&self)

pub fn dependency_count(&self) -> usize

pub fn is_dirty(&self) -> bool

pub fn take_dirty(&self) -> bool

Takes and clears this consumer’s invalidation bit.

pub fn dependencies(&self) -> DependencySnapshot

Trait Implementations

impl Clone for BuildContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuildContext

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

Formats the value using the given formatter.

impl Default for BuildContext

fn default() -> Self

Returns the “default value” for a type.