core/dev.s7a.strata.runtime.diagnostics/UiRenderMonitor

UiRenderMonitor

interface UiRenderMonitor : AutoCloseable(source)

Owner-thread, opt-in work monitor with at most 4,096 node records per checkpoint interval and no frame history. Existing nodes form a baseline rather than being reported as newly created. Snapshots are copied only on request. All methods reject operation reentry and foreign threads; close is idempotent and terminal host cleanup closes automatically.

Functions

checkpoint

abstract fun checkpoint()

Clears interval counters and retired-node records while preserving live identities.

abstract override fun close()

Releases all recorded references and disconnects monitoring without closing the screen.

findNodes

abstract fun findNodes(key: ElementKey<*>): List<UiRenderNodeId>

Finds current component identities; the same sibling key may match several independent parents.

snapshot

abstract fun snapshot(): UiRenderSnapshot

Copies detached, read-only interval evidence without evaluating or modifying the screen. Terminal failure releases runtime references but leaves a final detached snapshot readable until explicit close.