Enum Patch 

pub enum Patch {
    Create {
        id: String,
        element_type: String,
        props: IndexMap<String, Value>,
    },
    SetProp {
        id: String,
        name: String,
        value: Value,
    },
    RemoveProp {
        id: String,
        name: String,
    },
    SetText {
        id: String,
        text: String,
    },
    Insert {
        parent_id: String,
        id: String,
        before_id: Option<String>,
    },
    Move {
        parent_id: String,
        id: String,
        before_id: Option<String>,
    },
    Remove {
        id: String,
    },
}

Platform-agnostic patch operations for updating the UI.

Patches are the wire protocol between the Hypen engine and platform renderers (DOM, Canvas, iOS UIKit, Android Views). Every mutation to the UI tree is expressed as an ordered sequence of Patch values.

Serialization

Patches serialize to JSON with a "type" discriminator and camelCase field names for direct JavaScript consumption:

{"type": "create", "id": "1", "elementType": "Text", "props": {"0": "Hello"}}
{"type": "insert", "parentId": "root", "id": "1", "beforeId": null}

Node IDs

Node IDs are opaque string identifiers (currently compact integers like "1", "42"). Renderers must treat them as opaque — the format may change between versions. The special parent ID "root" refers to the renderer’s root container.

Ordering

Within a single render cycle, patches are ordered such that:

1. Create always precedes Insert for the same node
2. SetProp/SetText follow Create for new nodes
3. Remove is always the last operation for a given node
4. Insert/Move specify position via before_id (None = append)

Variants

Create

Create a new element node with initial properties.

The renderer should allocate a platform-native element and store it by id. The node is not yet visible — a subsequent Insert attaches it.

Fields

id: String

Opaque node identifier

element_type: String

Element type name (e.g. "Text", "Column", "Button")

props: IndexMap<String, Value>

Initial properties. Key "0" is the positional text content.

SetProp

Update a single property on an existing node.

Fields

id: String

name: String

Property name (e.g. "color", "fontSize")

value: Value

New value

RemoveProp

Remove a property from an existing node (revert to default).

Fields

id: String

name: String

Property name to remove

SetText

Set the text content of a node.

Fields

id: String

text: String

New text content

Insert

Insert a node as a child of parent_id.

If before_id is Some, insert before that sibling. If None, append.

Fields

parent_id: String

Parent node ID, or "root" for the root container

id: String

before_id: Option<String>

Insert before this sibling, or null to append

Move

Move an already-inserted node to a new position within its parent.

Fields

parent_id: String

id: String

before_id: Option<String>

Remove

Remove a node from the tree and deallocate it.

Fields

id: String

Implementations

impl Patch

pub fn create( id: NodeId, element_type: String, props: IndexMap<String, Value>, ) -> Self

pub fn set_prop(id: NodeId, name: String, value: Value) -> Self

pub fn remove_prop(id: NodeId, name: String) -> Self

pub fn set_text(id: NodeId, text: String) -> Self

pub fn insert(parent_id: NodeId, id: NodeId, before_id: Option<NodeId>) -> Self

pub fn insert_root(id: NodeId) -> Self

Insert a root node into the “root” container

pub fn move_node( parent_id: NodeId, id: NodeId, before_id: Option<NodeId>, ) -> Self

pub fn remove(id: NodeId) -> Self

Trait Implementations

impl Clone for Patch

fn clone(&self) -> Patch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Patch

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Patch

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Patch

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

where __S: Serializer,

Serialize this value into the given Serde serializer.