api/dev.s7a.strata.node/StateObserverNode

StateObserverNode

Retained capability consuming one tree-owned, revisioned snapshot per source.

The runtime shares subscriptions by source identity and commits values before deferred child construction. Reads and callbacks are owner-thread confined; source callbacks never invoke this capability directly. Implementations must invalidate affected phases when committed values change, and must not mutate sources.

Properties

observedSources

abstract val observedSources: List<StateSource<*>>

Ordered caller-owned sources; repeated identities occupy separate value positions but share a subscription.

Functions

commitObservedValues

abstract fun commitObservedValues(values: List<Any?>)

Receives the frame's read-only value list in source declaration order. Values may be null and remain owned by their sources; the runtime never deep-copies them.