Struct PhantomCluster 

pub struct PhantomCluster {
    pub id: String,
    pub anchor: ContentAnchor,
    pub label: String,
    pub scope: PhantomScope,
    pub author: Option<Collaborator>,
    pub created: Option<DateTime<Utc>>,
    pub metadata: HashMap<String, Value>,
    pub phantoms: Vec<Phantom>,
}

A cluster of phantoms attached to a content anchor.

Fields

id: String

Unique identifier for this cluster.

anchor: ContentAnchor

Content anchor where this cluster attaches.

label: String

Display label for the cluster.

scope: PhantomScope

Visibility scope for this cluster.

author: Option<Collaborator>

Author who created this cluster.

created: Option<DateTime<Utc>>

When the cluster was created.

metadata: HashMap<String, Value>

Custom metadata for the cluster.

phantoms: Vec<Phantom>

Phantoms within this cluster.

Implementations

impl PhantomCluster

pub fn new( id: impl Into<String>, anchor: ContentAnchor, label: impl Into<String>, ) -> Self

Create a new phantom cluster.

pub fn with_scope(self, scope: PhantomScope) -> Self

Set the visibility scope.

pub fn with_author(self, author: Collaborator) -> Self

Set the author.

pub fn with_metadata(self, key: impl Into<String>, value: Value) -> Self

Add metadata.

pub fn add_phantom(&mut self, phantom: Phantom)

Add a phantom to this cluster.

pub fn with_phantom(self, phantom: Phantom) -> Self

Add a phantom and return self for chaining.

pub fn find_phantom(&self, id: &str) -> Option<&Phantom>

Find a phantom by ID.

pub fn find_phantom_mut(&mut self, id: &str) -> Option<&mut Phantom>

Find a phantom by ID mutably.

pub fn validate_connections(&self, state: DocumentState) -> Vec<String>

Validate connections within this cluster.

Checks:

• All connection targets exist within this cluster
• No circular references that would cause infinite loops

Returns errors in Frozen/Published states, warnings in Draft/Review.

Trait Implementations

impl Clone for PhantomCluster

fn clone(&self) -> PhantomCluster

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PhantomCluster

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PhantomCluster

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PhantomCluster

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PhantomCluster

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PhantomCluster