update

fun update(description: Element)(source)

Reconciles a complete immutable element description.

Validation visits the complete description and runs each element's local validation hook. It rejects duplicate keyed direct siblings before retained state changes. A validation failure leaves the active tree unchanged. Reconciliation reuses compatible nodes, creates detached nodes for additions, and attaches newly installed nodes parent-first. A failure from reconciliation, node creation or update, lifecycle work, or cleanup poisons the tree. The operation rethrows the primary failure after cleanup attempts.

Parameters

description

the proposed root description.

Throws

when a validation hook fails before mutation, or when reconciliation, lifecycle, or cleanup fails after validation. The original throwable is propagated unchanged.

when the operation is called from another execution owner. It is also thrown when the operation re-enters an active operation or the tree is not active.