ComponentNode
The stateful counterpart of an NodeElement, created once per slot and kept across recompositions.
onAttach runs once, before the owning NodeElement's first update pushes the latest data onto the node's fields. So a listener installed in onAttach is live before the first update lands, and every field it reads needs an initial value that stands until then. onDetach runs when the element leaves the modifier or the node is released or reused, to restore a captured original or remove an installed listener. A reused or deactivated node gets onReset first.
Property nodes come apart in the reverse of the order the modifier declared them last, so a node putting back what it read finds every node declared before it still standing. Subscription nodes are held by position instead, and come apart after the property diff has restored what left the modifier and applied what stands, so what one of them reads as it goes is what the pass leaves behind.
Subclass this to back a custom NodeElement: capture the property's original in a field in onAttach, write the new value in update, and restore it in onDetach. See docs/MODIFIERS.md.
Properties
A scope that runs for as long as this node is attached, on the composition's own coroutine context and frame clock. Created on first access and cancelled once onDetach returns.
Whether this node is attached to a composition.
Component nodes write their own component directly and opt into listener handoff where needed.
Functions
Visits the nodes of the modifier this node is attached in that hold a place in it, in the order the modifier declares them: every ComponentNode of an additive element, and every ParentLayoutNode. This node is among them if it is one of those. Visits nothing while this node is not attached.