api/dev.s7a.strata.text/UiText

UiText

sealed interface UiText(source)

Unresolved text retained by the platform-neutral tree.

Runtime adapters resolve values only at their platform boundary. Version 0.1.1 adds WithFont to this sealed hierarchy; exhaustive visitors written for earlier variants need an additional branch. Retaining the older JVM members does not make previously compiled visitors accept the new variant.

Inheritors

Types

Companion

object Companion

Factory methods for retaining text composition.

Concatenated

class Concatenated(parts: List<UiText>) : UiText

A concatenation whose parts remain individually unresolved.

Literal

data class Literal(val value: String) : UiText

A text value that needs no lookup.

Platform

data class Platform(val payload: PlatformText) : UiText

A typed platform payload retained without interpreting its ownership or namespace.

Translated

class Translated(val key: String, arguments: List<UiTextArgument> = emptyList(), val fallback: TranslationFallback = TranslationFallback.UseKey) : UiText

A translation key with typed arguments and a non-null fallback policy.

WithFont

data class WithFont(val text: UiText, val font: ResourceId) : UiText

Text carrying a resource-pack font identifier without resolving or owning the font resource.

Functions

withFont

fun UiText.withFont(font: ResourceId): UiText

Retains this text with a resource-pack font identifier without loading resources or changing its content.