Struct Block 

pub struct Block {
    pub id: BlockId,
    pub content: Content,
    pub metadata: BlockMetadata,
    pub edges: Vec<Edge>,
    pub version: Version,
}

A block is the fundamental unit of content in UCM.

Blocks are immutable, content-addressed units identified by deterministic IDs derived from their content. They contain typed content, metadata for search and display, and edges representing relationships to other blocks.

Example

use ucm_core::{Block, Content};

let block = Block::new(Content::text("Hello, UCM!"), Some("intro"));
println!("Block ID: {}", block.id);

Fields

id: BlockId

Unique, content-derived identifier

content: Content

The actual content

metadata: BlockMetadata

Block metadata

edges: Vec<Edge>

Explicit relationships to other blocks

version: Version

Version for optimistic concurrency control

Implementations

impl Block

pub fn new(content: Content, semantic_role: Option<&str>) -> Self

Create a new block with generated ID

pub fn with_id(id: BlockId, content: Content) -> Self

Create a new block with a specific ID (for deserialization or testing)

pub fn root() -> Self

Create a root block

pub fn with_metadata(self, metadata: BlockMetadata) -> Self

Set metadata

pub fn with_label(self, label: impl Into<String>) -> Self

Set label

pub fn with_tag(self, tag: impl Into<String>) -> Self

Add a tag

pub fn with_edge(self, edge: Edge) -> Self

Add an edge

pub fn with_edges(self, edges: impl IntoIterator<Item = Edge>) -> Self

Add multiple edges

pub fn content_type(&self) -> &'static str

Get the content type tag

pub fn is_root(&self) -> bool

Check if the block is a root block

pub fn token_estimate(&self) -> TokenEstimate

Get the estimated token count

pub fn size_bytes(&self) -> usize

Get content size in bytes

pub fn update_content(&mut self, content: Content, semantic_role: Option<&str>)

Update the content and regenerate ID

pub fn add_edge(&mut self, edge: Edge)

Add an edge to this block

pub fn remove_edge(&mut self, target: &BlockId, edge_type: &EdgeType) -> bool

Remove an edge by target and type

pub fn edges_of_type(&self, edge_type: &EdgeType) -> Vec<&Edge>

Get edges of a specific type

pub fn has_tag(&self, tag: &str) -> bool

Check if block has a specific tag

Trait Implementations

impl Clone for Block

fn clone(&self) -> Block

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Block

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Block

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Block

fn eq(&self, other: &Block) -> 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 Block

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 Block