Struct MagnetRef 

pub struct MagnetRef {
    pub id: MagnetId,
    pub item: ItemId,
    pub role: MagnetRole,
    pub payload: Option<Rc<dyn Any>>,
    pub scene_pos: Point,
}

An owned, borrow-free snapshot of one magnet, handed to the accept/reject predicate and carried in a MagnetConnection.

The payload is an Rc clone, so a snapshot can outlive the borrow taken to collect candidates. The predicate inspects these snapshots while a shared (read-only) scene borrow is held — it may read the model but must not mutate it. The on_connect handler, by contrast, runs after every borrow is dropped and may freely mutate the model (add an edge item, reparent, fire an intent).

Fields

id: MagnetId

The magnet’s id.

item: ItemId

The item the magnet is attached to.

role: MagnetRole

The magnet’s advisory direction.

payload: Option<Rc<dyn Any>>

The magnet’s payload, if any (an Rc clone of the stored one).

scene_pos: Point

The magnet’s current position in scene coordinates.

Implementations

impl MagnetRef

pub fn payload_as<P: 'static>(&self) -> Option<&P>

Borrow the payload downcast to P, or None if absent or a different type. The ergonomic way to read a typed payload inside a predicate.

Trait Implementations

impl Clone for MagnetRef

fn clone(&self) -> MagnetRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MagnetRef

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

Formats the value using the given formatter.