Layer

class Layer(
    val id: UUID = UUID.randomUUID(), 
    depth: Int, 
    parentComposition: CompositionContext, 
    content: @Composable



 () -> Unit
)

A self-contained UI layer with its own independent LayoutNode tree and Composition.

Layers are used to implement overlapping UI surfaces such as modals, dropdowns, and tooltips. Each layer has its own root node that is measured and rendered separately from the base screen content.

Layers are managed by LayerStackManager. Do not create or dispose Layer instances directly; use LayerStackManager.push or LayerStackManager.modal instead.

Constructors

Layer

constructor(
    id: UUID = UUID.randomUUID(), 
    depth: Int, 
    parentComposition: CompositionContext, 
    content: @Composable



 () -> Unit
)

Properties

composition

val composition: Composition

id

val id: UUID

rootContainerNode

val rootContainerNode: LayoutNode?

The "RootContainer" node under rootNode, if one has been composed.

Re-resolved whenever the cached node has been detached from this layer's tree. This used to be a by lazy, which resolved once and then held that node for the layer's whole life - but recomposition replaces the RootContainer node outright, and a detached node is never measured again, so its geometry freezes. net.kernelpanicsoft.archie.gui.layer.LayerStackManager.screenPos and screenSize fold over exactly this node, and a container screen overwrites its own leftPos/topPos from them every frame - so a stale node pinned the screen origin, and with it the clip rect every vanilla slot is rendered through, to pre-recomposition values. A window resize restarts the composition, which is why resizing stranded it permanently.

The attachment check is O(depth) against the O(tree) LayoutNode.findNode walk, so the common case where nothing changed stays about as cheap as the cached read it replaces.

rootNode

val rootNode: LayoutNode

Functions

dispose

fun dispose()

Disposes the Compose Composition associated with this layer, releasing all remembered state and coroutines.

Called automatically by LayerStackManager.pop and LayerStackManager.popById.

findNode

fun findNode(name: String): LayoutNode?

Finds a descendant of rootNode by name. See LayoutNode.findNode.