api/dev.s7a.strata.spi/ComponentRuntime

ComponentRuntime

Privileged platform implementation of profile-backed standard components.

The API module retains only this platform-neutral contract while a runtime adapter resolves profile assets, synchronized bindings, and retained implementation nodes during one dynamically scoped screen evaluation. Every method runs synchronously on the evaluation owner thread and must not retain a callback-lifetime scope. Returned immutable elements and modifier chains own any retained snapshots or bindings; the caller owns those returned descriptions and the retained tree later owns their lifecycle resources. Validation, resolution, and arithmetic failures propagate unchanged without emitting a partial description.

Functions

button

abstract fun button(label: UiText, width: Int, enabled: Boolean, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed pointer button element.

checkbox

abstract fun checkbox(label: UiText, state: CheckboxState, width: Int, enabled: Boolean, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed Checkbox with caller-owned selected state.

containerBackground

abstract fun containerBackground(modifier: Modifier, rows: Int): Modifier

Appends the active profile's generic-container background and sizing behavior.

cycleButton

abstract fun cycleButton(state: CycleButtonState<*>, labels: List<UiText>, width: Int, enabled: Boolean, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed finite-option CycleButton.

image

abstract fun image(source: ImageSource, sourceRegion: IntRect?, size: IntSize?, modifier: Modifier, key: ElementKey<*>?): Element

Creates one nearest-sampled image after resolving source through the active resource manager when necessary.

imageBackground

abstract fun imageBackground(modifier: Modifier, source: ImageSource, scale: ImageScale): Modifier

Appends one nearest-sampled image background resolved from source.

abstract fun imageBackground(modifier: Modifier, source: ImageSource, border: Insets, centerMode: NineSliceCenterMode): Modifier

Appends one nine-slice image background resolved from source.

loadingIndicator

abstract fun loadingIndicator(size: IntSize, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed discrete loading animation.

menuBackground

abstract fun menuBackground(modifier: Modifier): Modifier

Appends the active profile's menu background behavior.

playerHead

abstract fun playerHead(source: PlayerSkinSource, size: Int, showHat: Boolean, loading: Element?, failure: Element?, modifier: Modifier, key: ElementKey<*>?): Element

Creates one player-head element and defers any asynchronous lookup represented by source to node attachment.

progressBar

abstract fun progressBar(progress: Double, size: IntSize, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed determinate progress bar.

retainEvaluator

abstract fun retainEvaluator(): ComponentEvaluator

Captures an owner-thread evaluator for content constructed after this callback-lifetime runtime closes.

scrollArea

abstract fun scrollArea(state: ScrollState, content: Element, scrollRate: Int, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed scroll viewport around exactly one content root.

scrollbar

abstract fun scrollbar(state: ScrollState, modifier: Modifier, key: ElementKey<*>?): Element

Creates one independently placed profile-backed vertical scrollbar.

slider

abstract fun slider(label: UiText, state: SliderState, width: Int, enabled: Boolean, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed horizontal Slider.

slot

abstract fun slot(binding: SlotBinding?, highlightable: Boolean, item: Element?, modifier: Modifier, key: ElementKey<*>?): Element

Creates one ordinary or synchronized profile-backed slot element.

tab

abstract fun tab(label: UiText, selected: Boolean, width: Int, enabled: Boolean, indicator: TabSelectionIndicator, customIndicator: Element?, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed tab element with an optional selected custom indicator root.

text

abstract fun text(text: UiText, style: TextStyle, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed text element.

open fun text(text: UiText, layout: TextLayout, style: TextStyle, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed text element with an explicit line layout.

textArea

open fun textArea(state: TextAreaState, viewport: TextAreaViewport, enabled: Boolean, style: TextStyle, wrap: TextWrap, lineSpacing: Int, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed multiline editor observing caller-owned text and scroll state.

open fun textArea(state: TextAreaState, viewport: TextAreaViewport, appearance: TextInputAppearance, enabled: Boolean, style: TextStyle, wrap: TextWrap, lineSpacing: Int, modifier: Modifier, key: ElementKey<*>?): Element

open fun textArea(state: TextAreaState, viewport: TextAreaViewport, appearance: TextInputAppearance, enabled: Boolean, style: TextStyle, font: ResourceId, wrap: TextWrap, lineSpacing: Int, modifier: Modifier, key: ElementKey<*>?): Element

Creates an editor with an independently resolved frame and editing-decoration appearance. Caller state and font ownership follow the existing editor overload; appearance changes do not reset editing. Default appearance delegates to the legacy overload for compatible third-party runtimes.

open fun textArea(state: TextAreaState, viewport: TextAreaViewport, enabled: Boolean, style: TextStyle, font: ResourceId, wrap: TextWrap, lineSpacing: Int, modifier: Modifier, key: ElementKey<*>?): Element

Creates one multiline editor using an explicitly selected resource-pack font.

textField

abstract fun textField(state: TextFieldState, size: IntSize, enabled: Boolean, style: TextStyle, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed text-field element observing state.

open fun textField(state: TextFieldState, size: IntSize, appearance: TextInputAppearance, enabled: Boolean, style: TextStyle, modifier: Modifier, key: ElementKey<*>?): Element

open fun textField(state: TextFieldState, size: IntSize, appearance: TextInputAppearance, enabled: Boolean, style: TextStyle, font: ResourceId, modifier: Modifier, key: ElementKey<*>?): Element

open fun textField(state: TextFieldState, size: IntSize, enabled: Boolean, style: TextStyle, font: ResourceId, modifier: Modifier, key: ElementKey<*>?): Element

Creates one profile-backed text field with an explicitly selected resource-pack font. The default implementation rejects this capability so existing runtime implementations remain source and binary compatible.

tooltip

abstract fun tooltip(modifier: Modifier, text: UiText, delayMillis: Long): Modifier

Adds one profile-backed delayed tooltip behavior.