remote/dev.s7a.strata.runtime.remote/RemoteClientStates

RemoteClientStates

class RemoteClientStates : AutoCloseable(source)

Execution-owner-confined presentation-state store bounded by the current decoded screen and its negotiated entry limit. Keys combine a remote identity and a trusted type token; removed identities and terminal screens release their entries. Preparation runs before declaration evaluation, so incoming values never mutate state from a render callback. Editable membership uses the same keys and admission order, contains only current entries, and is cleared before release callbacks. Every current editable entry is polled, including distinct keys sharing a value; membership never caches authoritative values.

Functions

open override fun close()

flushEdits

fun flushEdits(actions: RemoteClientActions)

Flushes current editable values once; nested action allocation never recursively flushes the store.

get

fun <T : Any> get(identity: Long, key: RemoteStateKey<T>): T

Reads a value previously prepared for the same typed identity without creating or mutating it.

prepare

fun <T : Any> prepare(identity: Long, key: RemoteStateKey<T>, create: () -> T, update: (T) -> Unit, release: (T) -> Unit = {})

Creates or updates a typed presentation value from a registered preparation callback. release runs exactly once when the value is retired, including terminal failure cleanup. Creation and update callbacks cannot reenter preparation; closing from either callback invalidates this operation. A fresh factory result returned after close is released instead of admitted; callback failures remain primary.